Feat: Add Widget Page feature

This commit introduces a new Widget Page feature, allowing users to add, resize, and manage app widgets.

**Core Functionality:**
-   A new fragment `widgetFragment` and its corresponding layout `fragment_widget_container` have been added.
-   `ResizableWidgetWrapper` class has been created to handle widget resizing, dragging, and context menu operations (Resize, Delete, Open, View in Store).
-   Widgets are placed on a grid defined by `GRID_COLUMNS` and `CELL_MARGIN`.
-   Widget state (ID, position, size, cell span) is persisted in a `widgets.json` file using Moshi.

**MainActivity Changes:**
-   Added `widgetPermissionLauncher` to handle widget bind and configuration intents.
-   Introduced `launchWidgetPermission`, `safeCreateWidget`, and `flushPendingWidgets` to manage the widget creation lifecycle, especially when `WidgetFragment` might not be immediately available.

**WidgetFragment Logic:**
-   Initializes `AppWidgetManager` and `AppWidgetHost`.
-   Handles widget addition via a custom picker that groups widgets by app.
-   Manages the lifecycle of widgets: allocation, binding, configuration (if needed), and creation of `ResizableWidgetWrapper`.
-   Provides functionality to reset all widgets.
-   Saves and restores widget configurations to/from `widgets.json`.
-   Includes logic to find empty slots in the grid for new widgets.
-   Overrides `onBackPressed` to handle exiting resize mode for widgets.

**UI and Resources:**
-   New string resources for widget-related actions and titles have been added to `strings.xml`.
-   `fragment_widget_container.xml` defines the `FrameLayout` (`widget_grid`) that hosts the widgets.
-   Resize handles and a grid overlay are displayed when a widget is in resize mode.

Author: CreativeCodeCat

app/src/main/java/com/github/droidworksstudio/mlauncher/MainActivity.kt

@@ -2,6 +2,8 @@ package com.github.droidworksstudio.mlauncher
 
 import android.app.Activity
 import android.app.role.RoleManager
+import android.appwidget.AppWidgetManager
+import android.appwidget.AppWidgetProviderInfo
 import android.content.Context
 import android.content.Intent
 import android.content.pm.ActivityInfo
@@ -21,6 +23,7 @@ import androidx.core.view.WindowCompat
 import androidx.lifecycle.ViewModelProvider
 import androidx.navigation.NavController
 import androidx.navigation.findNavController
+import com.github.droidworksstudio.common.AppLogger
 import com.github.droidworksstudio.common.CrashHandler
 import com.github.droidworksstudio.common.showLongToast
 import com.github.droidworksstudio.mlauncher.data.Constants
@@ -33,6 +36,7 @@ import com.github.droidworksstudio.mlauncher.helper.emptyString
 import com.github.droidworksstudio.mlauncher.helper.ismlauncherDefault
 import com.github.droidworksstudio.mlauncher.helper.utils.AppReloader
 import com.github.droidworksstudio.mlauncher.helper.utils.SystemBarObserver
+import com.github.droidworksstudio.mlauncher.ui.WidgetFragment
 import com.github.droidworksstudio.mlauncher.ui.onboarding.OnboardingActivity
 import com.squareup.moshi.Moshi
 import com.squareup.moshi.Types
@@ -49,6 +53,10 @@ import java.util.concurrent.Executors
 
 class MainActivity : AppCompatActivity() {
 
+    companion object {
+        private const val TAG = "BaseWidgets"
+    }
+
     private lateinit var prefs: Prefs
     private lateinit var migration: Migration
     private lateinit var navController: NavController
@@ -116,9 +124,24 @@ class MainActivity : AppCompatActivity() {
         }
     }
 
+    private lateinit var widgetPermissionLauncher: ActivityResultLauncher<Intent>
+    private var widgetResultCallback: ((Int, Int, Intent?) -> Unit)? = null
+    private val pendingWidgets = mutableListOf<Pair<AppWidgetProviderInfo, Int>>()
+
     override fun onCreate(savedInstanceState: Bundle?) {
         super.onCreate(savedInstanceState)
 
+        widgetPermissionLauncher =
+            registerForActivityResult(ActivityResultContracts.StartActivityForResult()) { result ->
+                AppLogger.v(TAG, "🎬 ActivityResultLauncher invoked. ResultCode=${result.resultCode}, data=${result.data != null}")
+
+                widgetResultCallback?.invoke(
+                    result.resultCode,
+                    result.data?.getIntExtra(AppWidgetManager.EXTRA_APPWIDGET_ID, -1) ?: -1,
+                    result.data
+                )
+            }
+
         // Enables edge-to-edge mode
         WindowCompat.setDecorFitsSystemWindows(window, false)
 
@@ -319,6 +342,40 @@ class MainActivity : AppCompatActivity() {
         lifecycle.addObserver(systemBarObserver)
     }
 
+    /** Called by a Fragment to launch a widget intent */
+    /** Widget permission helper */
+    fun launchWidgetPermission(intent: Intent, callback: (resultCode: Int, appWidgetId: Int, data: Intent?) -> Unit) {
+        widgetResultCallback = callback
+        widgetPermissionLauncher.launch(intent)
+    }
+
+    /** Safely create widget or store pending */
+    fun safeCreateWidget(widgetInfo: AppWidgetProviderInfo, appWidgetId: Int) {
+        val navHostFragment = supportFragmentManager.findFragmentById(R.id.nav_host_fragment)
+        val fragment = navHostFragment?.childFragmentManager?.fragments
+            ?.filterIsInstance<WidgetFragment>()
+            ?.firstOrNull()
+        if (fragment != null && fragment.isAdded) {
+            fragment.createWidgetWrapperSafe(widgetInfo, appWidgetId)
+            AppLogger.i(TAG, "✅ WidgetFragment ready, creating widget wrapper for widgetId=$appWidgetId")
+        } else {
+            pendingWidgets.add(widgetInfo to appWidgetId)
+            AppLogger.w(TAG, "⚠️ WidgetFragment not attached, storing pending widget id=$appWidgetId")
+        }
+    }
+
+    fun flushPendingWidgets() {
+        val navHostFragment = supportFragmentManager.findFragmentById(R.id.nav_host_fragment)
+        val fragment = navHostFragment?.childFragmentManager?.fragments
+            ?.filterIsInstance<WidgetFragment>()
+            ?.firstOrNull()
+        pendingWidgets.forEach { (info, id) ->
+            AppLogger.i(TAG, "➡ Flushing pending widgetId=$fragment")
+            fragment?.createWidgetWrapperSafe(info, id)
+        }
+    }
+
+
     private fun handleFontSelected(uri: Uri?) {
         if (uri == null) return