feat: Add placeholder for empty widget screen and improve widget management

This commit introduces a placeholder text view that is displayed when no widgets are added to the widget screen.
It also includes several improvements to widget management:
- The active dialog is now dismissed when a widget is being dragged.
- The empty placeholder is added to the widget grid after resetting all widgets.
- The empty placeholder visibility is updated when widgets are added or removed.
- Logging has been added for better debugging and monitoring of widget states and actions.

A new string resource `widgets_not_added` has been added for the placeholder text.
The `WidgetFragment` now initializes and manages the `emptyPlaceholder` TextView.
The `ResizableWidgetWrapper` now dismisses any active dialog during a drag operation.

Author: CreativeCodeCat

app/src/main/java/com/github/droidworksstudio/mlauncher/ui/WidgetFragment.kt

@@ -50,6 +50,7 @@ data class AppWidgetGroup(
 class WidgetFragment : BaseFragment() {
 
     private lateinit var widgetGrid: FrameLayout
+    private lateinit var emptyPlaceholder: TextView
     lateinit var appWidgetManager: AppWidgetManager
     lateinit var appWidgetHost: AppWidgetHost
     private val widgetWrappers = mutableListOf<ResizableWidgetWrapper>()
@@ -81,26 +82,44 @@ class WidgetFragment : BaseFragment() {
         super.onViewCreated(view, savedInstanceState)
 
         requireActivity().onBackPressedDispatcher.addCallback(viewLifecycleOwner) {
-            // Check if any widget is in resize mode
             val resizeWidget = widgetWrappers.firstOrNull { it.isResizeMode }
-
             if (resizeWidget != null) {
-                // Disable resize mode instead of going back
+                AppLogger.i(TAG, "🔄 Exiting resize mode for widgetId=${resizeWidget.hostView.appWidgetId}")
                 resizeWidget.isResizeMode = false
                 resizeWidget.setHandlesVisible(false)
                 resizeWidget.reloadParentFragment()
             } else {
-                // No widget in resize mode, proceed with normal back
                 isEnabled = false
                 requireActivity().onBackPressed()
             }
         }
 
         widgetGrid = view.findViewById(R.id.widget_grid)
+        AppLogger.i(TAG, "🟢 Widget grid initialized")
+        // Create placeholder programmatically
+        AppLogger.i(TAG, "🟢 Creating empty placeholder for widgets")
+        emptyPlaceholder = TextView(requireContext()).apply {
+            text = context.getString(R.string.widgets_not_added)
+            textSize = 16f
+            setTextColor(resources.getColor(android.R.color.darker_gray, null))
+            gravity = Gravity.CENTER
+            visibility = View.GONE
+        }
+        AppLogger.i(TAG, "🟢 Empty placeholder TextView created")
+
+        widgetGrid.addView(
+            emptyPlaceholder, FrameLayout.LayoutParams(
+                FrameLayout.LayoutParams.WRAP_CONTENT,
+                FrameLayout.LayoutParams.WRAP_CONTENT,
+                Gravity.CENTER
+            )
+        )
+        AppLogger.i(TAG, "🟢 Empty placeholder added to widgetGrid")
 
         appWidgetManager = AppWidgetManager.getInstance(requireContext())
         appWidgetHost = AppWidgetHost(requireContext(), APP_WIDGET_HOST_ID)
         appWidgetHost.startListening()
+        AppLogger.i(TAG, "🟢 AppWidgetHost started listening")
 
         widgetGrid.setOnLongClickListener {
             showGridMenu()
@@ -110,21 +129,21 @@ class WidgetFragment : BaseFragment() {
         restoreWidgets()
 
         AppLogger.i(TAG, "🟢 WidgetFragment onViewCreated, view is ready")
-
-        // Notify MainActivity to flush pending widgets
         (activity as? MainActivity)?.flushPendingWidgets()
     }
 
     override fun onResume() {
         super.onResume()
         restoreWidgets()
+        AppLogger.i(TAG, "🔄 WidgetFragment onResume, widgets restored")
     }
 
     /** Grid menu for adding/resetting widgets */
     private fun showGridMenu() {
         activeGridDialog?.dismiss()
         val bottomSheetDialog = LockedBottomSheetDialog(requireContext())
         activeGridDialog = bottomSheetDialog
+        AppLogger.d(TAG, "🎛️ Showing widget grid menu")
 
         val container = LinearLayout(requireContext()).apply {
             orientation = LinearLayout.VERTICAL
@@ -149,16 +168,19 @@ class WidgetFragment : BaseFragment() {
     }
 
     private fun resetAllWidgets() {
+        AppLogger.w(TAG, "🧹 Resetting all widgets")
         widgetWrappers.forEach { wrapper ->
+            AppLogger.d(TAG, "❌ Deleting widgetId=${wrapper.hostView.appWidgetId}")
             appWidgetHost.deleteAppWidgetId(wrapper.hostView.appWidgetId)
         }
         widgetWrappers.clear()
         widgetGrid.removeAllViews()
+        widgetGrid.addView(emptyPlaceholder)
         saveWidgets()
-        AppLogger.i(TAG, "🧹 Reset all widgets, cleared grid")
+        updateEmptyPlaceholder(widgetWrappers)
+        AppLogger.i(TAG, "🧹 All widgets cleared and placeholder shown")
     }
 
-    /** Shows the system widget picker */
     private fun showCustomWidgetPicker() {
         val widgets = appWidgetManager.installedProviders
         val pm = requireContext().packageManager
@@ -174,6 +196,8 @@ class WidgetFragment : BaseFragment() {
             AppWidgetGroup(appName, appIcon, widgetList.toMutableList())
         }.sortedBy { it.appName.lowercase() }
 
+        AppLogger.d(TAG, "🧩 Showing custom widget picker with ${grouped.size} apps")
+
         val container = LinearLayout(requireContext()).apply { orientation = LinearLayout.VERTICAL; setPadding(16, 16, 16, 16) }
         val scrollView = ScrollView(requireContext()).apply { addView(container) }
 
@@ -212,6 +236,7 @@ class WidgetFragment : BaseFragment() {
                     textSize = 14f
                     setPadding(32, 12, 12, 12)
                     setOnClickListener {
+                        AppLogger.i(TAG, "➕ Selected widget ${widgetInfo.label} to add")
                         addWidget(widgetInfo)
                         bottomSheetDialog.dismiss()
                     }
@@ -234,7 +259,6 @@ class WidgetFragment : BaseFragment() {
         }
     }
 
-    /** Add a widget and handle permissions/configure activities */
     private fun addWidget(widgetInfo: AppWidgetProviderInfo) {
         lastWidgetInfo = widgetInfo
         val widgetId = appWidgetHost.allocateAppWidgetId()
@@ -266,8 +290,7 @@ class WidgetFragment : BaseFragment() {
 
         if (!bound) return
 
-        // 🔽 Map widget’s min size to grid span
-        val parentFrame = requireActivity().findViewById<ViewGroup>(R.id.widget_grid) // adjust ID
+        val parentFrame = requireActivity().findViewById<ViewGroup>(R.id.widget_grid)
         val gridWidth = parentFrame.width
         val cellSize = (gridWidth - (CELL_MARGIN * (GRID_COLUMNS - 1))) / GRID_COLUMNS
 
@@ -276,25 +299,20 @@ class WidgetFragment : BaseFragment() {
 
         AppLogger.d(TAG, "📐 Widget ${widgetInfo.provider} requires ${spanX}x$spanY cells")
 
-        // 🔍 Get current occupancy
         val occupied = getOccupiedGrid()
         val maxRows = occupied.size.coerceAtLeast(1)
 
-        // 🔍 Find first free block that fits
         var foundRow = -1
         var foundCol = -1
 
-        outer@ for (row in 0 until maxRows + 10) { // allow new rows
+        outer@ for (row in 0 until maxRows + 10) {
             for (col in 0 until GRID_COLUMNS) {
                 var fits = true
                 for (dy in 0 until spanY) {
                     for (dx in 0 until spanX) {
                         val r = row + dy
                         val c = col + dx
-                        if (c >= GRID_COLUMNS) {
-                            fits = false; break
-                        }
-                        if (r < occupied.size && occupied[r][c]) {
+                        if (c >= GRID_COLUMNS || (r < occupied.size && occupied[r][c])) {
                             fits = false; break
                         }
                     }
@@ -314,11 +332,7 @@ class WidgetFragment : BaseFragment() {
         }
 
         AppLogger.i(TAG, "📦 Placing widget ${widgetInfo.provider} at row=$foundRow col=$foundCol span=${spanX}x$spanY")
-
-        // Save placement (so it’s included in JSON next time)
         saveWidgetPlacement(widgetId, foundRow, foundCol, spanX, spanY, parentFrame)
-
-        // Create widget instance
         maybeConfigureOrCreate(widgetInfo, widgetId)
     }
 
@@ -486,6 +500,7 @@ class WidgetFragment : BaseFragment() {
 
         addWrapperToGrid(wrapper)
         AppLogger.i(TAG, "✅ Wrapper created for widgetId=$appWidgetId")
+        updateEmptyPlaceholder(widgetWrappers)
         saveWidgets()
     }
 
@@ -698,6 +713,22 @@ class WidgetFragment : BaseFragment() {
         AppLogger.i(TAG, "📐 Grid Snapshot:\n$snapshot")
     }
 
+    private fun updateEmptyPlaceholder(wrappers: List<ResizableWidgetWrapper>) {
+        val wasVisible = emptyPlaceholder.isVisible
+        val shouldBeVisible = wrappers.isEmpty()
+
+        emptyPlaceholder.isVisible = shouldBeVisible
+
+        if (shouldBeVisible && !wasVisible) {
+            AppLogger.i(TAG, "🟨 No widgets present, showing placeholder")
+        } else if (!shouldBeVisible && wasVisible) {
+            AppLogger.i(TAG, "🟩 Widgets present, hiding placeholder")
+        } else {
+            AppLogger.v(TAG, "🔄 Placeholder visibility unchanged: ${emptyPlaceholder.isVisible}")
+        }
+    }
+
+
     override fun onAttach(context: Context) {
         super.onAttach(context)
         AppLogger.i(TAG, "🔗 WidgetFragment onAttach called, context=$context")

app/src/main/java/com/github/droidworksstudio/mlauncher/ui/widgets/ResizableWidgetWrapper.kt

@@ -282,6 +282,7 @@ class ResizableWidgetWrapper(
                         lastY = event.rawY
 
                         updateGhostPosition()
+                        activeDialog?.dismiss()
                     }
 
                     MotionEvent.ACTION_UP, MotionEvent.ACTION_CANCEL -> {

app/src/main/res/values/strings.xml

@@ -408,6 +408,7 @@
     <string name="widgets_select_widget">Select a Widget</string>
     <string name="widgets_add_widget">Add a Widget</string>
     <string name="widgets_reset_widget">Reset all Widgets</string>
+    <string name="widgets_not_added">No widgets added yet. Long press to add one.</string>
 
     <!-- Private Spaces Strings -->
     <string name="alert_requires_android_v">This functionality requires Android 15 or later.</string>