Release v0.9.9 Beta

Author: Gengar

.gitignore

@@ -56,6 +56,7 @@ app.*.map.json
 /android/gradlew.bat
 /android/**/GeneratedPluginRegistrant.java
 /android/.cxx/
+android/app/.settings/
 
 # Signing
 *.jks

CHANGELOG.md

@@ -6,6 +6,30 @@ The format is based on [Keep a Changelog](https://keepachangelog.com/).
 
 ---
 
+## [0.9.9] Beta — 2026-02-25
+
+### Added
+- **Custom Shelves** — create personal game collections with manual curation, filter rules (by system, region, language), or hybrid mode; supports reordering, renaming, and per-shelf sort modes
+- **Device Info Service** — adaptive memory tiering (low/standard/high RAM) that auto-tunes image cache sizes, grid cache extents, and cover preload pools for low-end handhelds
+- **Shelf Picker Dialog** — quick-add games to shelves from library and game detail screens
+- **System Selector Overlay** — filter library view by system with visual system badges
+
+### Improved
+- **Settings screen refactored** — split into Preferences, System, and About tabs with extracted `DeviceInfoCard` widget (1048→604 lines)
+- **Download overlay refactored** — extracted 7 widgets to `lib/widgets/download/` (DownloadItemCard, CoverThumbnail, PulsingDot, LowSpaceWarning, StatusLabel, DownloadProgressBar, DownloadActionButton) (1477→793 lines)
+- **Shelf edit screen refactored** — extracted GameListOverlay, TextInputDialog to shared library widgets (1108→631 lines)
+- **RomM onboarding refactored** — extracted RommConnectView, RommSelectView, RommFolderView, RommActionButton (1405→122 lines); state classes moved to `onboarding_state.dart` (1713→1362 lines)
+- **Library screen refactored** — extracted ReorderableCardWrapper, LibraryEntry to dedicated widgets (1490→1386 lines)
+- **Dependency pinning** — all 16 remaining caret-range dependencies pinned to exact resolved versions for reproducible builds
+
+### Internal
+- New models: `CustomShelf`, `ShelfFilterRule` with JSON serialization
+- New providers: `CustomShelvesNotifier` / `customShelvesProvider` for shelf CRUD
+- `DeviceInfoService` with `MemoryTier` classification
+- ~20 new test files covering download queue manager, unified game service, library sync, thumbnail service, custom shelves, database service, config storage, image cache, storage service, and widget tests
+
+---
+
 ## [0.9.8] Beta — 2026-02-23
 
 ### Added

README.md

@@ -22,7 +22,7 @@ A premium, console-native game manager for Android. Built for handhelds, perfect
 </p>
 
 <p align="center">
-  <img src="https://img.shields.io/badge/version-0.9.8_Beta-blue?style=flat-square" alt="Version" />
+  <img src="https://img.shields.io/badge/version-0.9.9_Beta-blue?style=flat-square" alt="Version" />
   <img src="https://img.shields.io/badge/license-MIT-green?style=flat-square" alt="License" />
   <img src="https://img.shields.io/badge/platform-Android-brightgreen?style=flat-square" alt="Platform" />
   <img src="https://img.shields.io/github/stars/averageconsumer/R-Shop?style=flat-square&color=yellow" alt="Stars" />

android/app/.settings/org.eclipse.buildship.core.prefs

@@ -7,15 +7,23 @@ import android.os.StatFs
 import android.util.Log
 import android.view.KeyEvent
 import io.flutter.embedding.android.FlutterActivity
+import io.flutter.plugin.common.EventChannel
 import io.flutter.plugin.common.MethodChannel
 import java.io.*
+import java.util.concurrent.Executors
 import java.util.zip.ZipInputStream
 
 class MainActivity : FlutterActivity() {
     private val CHANNEL = "com.retro.rshop/zip"
     private val STORAGE_CHANNEL = "com.retro.rshop/storage"
+    private val PROGRESS_CHANNEL = "com.retro.rshop/zip_progress"
     private val TAG = "MainActivity"
 
+    private val extractorPool = Executors.newFixedThreadPool(2)
+    private val mainHandler = Handler(Looper.getMainLooper())
+
+    private var progressSink: EventChannel.EventSink? = null
+
     override fun onCreate(savedInstanceState: Bundle?) {
         super.onCreate(savedInstanceState)
         Log.d(TAG, "MainActivity onCreate")
@@ -24,29 +32,40 @@ class MainActivity : FlutterActivity() {
     override fun configureFlutterEngine(flutterEngine: io.flutter.embedding.engine.FlutterEngine) {
         super.configureFlutterEngine(flutterEngine)
 
+        EventChannel(flutterEngine.dartExecutor.binaryMessenger, PROGRESS_CHANNEL).setStreamHandler(
+            object : EventChannel.StreamHandler {
+                override fun onListen(arguments: Any?, events: EventChannel.EventSink?) {
+                    progressSink = events
+                }
+                override fun onCancel(arguments: Any?) {
+                    progressSink = null
+                }
+            }
+        )
+
         MethodChannel(flutterEngine.dartExecutor.binaryMessenger, CHANNEL).setMethodCallHandler { call, result ->
             when (call.method) {
                 "extractZip" -> {
                     val zipPath = call.argument<String>("zipPath")
                     val targetPath = call.argument<String>("targetPath")
-                    
+
                     if (zipPath == null || targetPath == null) {
                         result.error("INVALID_ARGS", "zipPath and targetPath required", null)
                         return@setMethodCallHandler
                     }
 
-                    Thread {
+                    extractorPool.execute {
                         try {
                             val extractedFiles = extractZip(zipPath, targetPath)
-                            Handler(Looper.getMainLooper()).post {
+                            mainHandler.post {
                                 result.success(extractedFiles)
                             }
                         } catch (e: Exception) {
-                            Handler(Looper.getMainLooper()).post {
+                            mainHandler.post {
                                 result.error("EXTRACT_ERROR", e.message, null)
                             }
                         }
-                    }.start()
+                    }
                 }
                 else -> result.notImplemented()
             }
@@ -69,11 +88,35 @@ class MainActivity : FlutterActivity() {
                         result.error("STAT_ERROR", e.message, null)
                     }
                 }
+                "getDeviceMemory" -> {
+                    try {
+                        val am = getSystemService(android.content.Context.ACTIVITY_SERVICE) as android.app.ActivityManager
+                        val memInfo = android.app.ActivityManager.MemoryInfo()
+                        am.getMemoryInfo(memInfo)
+                        result.success(mapOf("totalBytes" to memInfo.totalMem))
+                    } catch (e: Exception) {
+                        result.error("MEMORY_ERROR", e.message, null)
+                    }
+                }
                 else -> result.notImplemented()
             }
         }
     }
 
+    override fun onDestroy() {
+        extractorPool.shutdown()
+        super.onDestroy()
+    }
+
+    private fun sendProgress(extractedBytes: Long, totalBytes: Long) {
+        val sink = progressSink ?: return
+        if (totalBytes <= 0) return
+        val percent = (extractedBytes.toDouble() / totalBytes * 100).toInt().coerceIn(0, 100)
+        mainHandler.post {
+            sink.success(mapOf("extracted" to extractedBytes, "total" to totalBytes, "percent" to percent))
+        }
+    }
+
     private fun extractZip(zipPath: String, targetPath: String): List<String> {
         val extractedFiles = mutableListOf<String>()
         val buffer = ByteArray(8192)
@@ -97,6 +140,7 @@ class MainActivity : FlutterActivity() {
             var entry = zis.nextEntry
 
             val canonicalTarget = File(targetPath).canonicalPath
+            var lastReportedPercent = -1
 
             while (entry != null) {
                 val file = File(targetPath, entry.name)
@@ -112,21 +156,30 @@ class MainActivity : FlutterActivity() {
                     file.mkdirs()
                 } else {
                     file.parentFile?.mkdirs()
-                    
+
                     FileOutputStream(file).use { fos ->
                         var len: Int
                         while (zis.read(buffer).also { len = it } > 0) {
                             fos.write(buffer, 0, len)
                             extractedBytes += len
                         }
                     }
-                    
+
                     extractedFiles.add(entry.name)
+
+                    // Report progress (throttle: only on percent change)
+                    if (totalBytes > 0) {
+                        val currentPercent = (extractedBytes.toDouble() / totalBytes * 100).toInt()
+                        if (currentPercent != lastReportedPercent) {
+                            lastReportedPercent = currentPercent
+                            sendProgress(extractedBytes, totalBytes)
+                        }
+                    }
                 }
-                
+
                 entry = zis.nextEntry
             }
-            
+
             zis.close()
         }
 

android/app/src/main/kotlin/com/example/r_shop/MainActivity.kt

@@ -139,7 +139,8 @@ class FocusSyncManager {
 
     final gridWidth = MediaQuery.of(context).size.width - 48;
     final itemWidth = (gridWidth - (crossAxisCount - 1) * 16) / crossAxisCount;
-    final itemHeight = itemWidth / getGridRatio();
+    final ratio = getGridRatio();
+    final itemHeight = ratio > 0 ? (itemWidth / ratio) : itemWidth;
     final rowHeight = itemHeight + 16;
 
     final centerOffset =