feat: Implement dynamic and accessible AZ sidebar

This commit introduces significant enhancements to the `AZSidebarView` to make it dynamic and more accessible. The sidebar now only displays letters corresponding to the available items in the app or contact lists.

Key changes include:

-   **Dynamic Letter Filtering**: A new `setAvailableLetters` method in `AZSidebarView` allows it to dynamically hide letters that are not present in the current data set.
-   **Improved Sizing**: The sidebar's item spacing is now calculated within `onSizeChanged` using the view's actual height, ensuring it renders correctly regardless of screen size.
-   **Accessibility**: When a letter is selected, it is now announced for accessibility services.
-   **Code Refinements**:
    -   Touch event handling has been streamlined into a `handleSelection` method to avoid duplicate code.
    -   The `setSelectedLetter` function now correctly handles the "★" symbol.
    -   Typeface lookups are now more efficient, occurring once per draw cycle.
-   **Integration**: The `AppDrawerFragment` has been updated to call `setAvailableLetters` whenever the app or contact list is populated or updated, keeping the sidebar in sync.

closes #956

Author: CreativeCodeCat

app/src/main/java/com/github/codeworkscreativehub/mlauncher/ui/AppDrawerFragment.kt

@@ -268,11 +268,8 @@ class AppDrawerFragment : BaseFragment() {
             }
         }
 
-
-        when (binding.menuView.displayedChild) {
-            0 -> appAdapter?.let { appsAdapter = it }
-            1 -> contactAdapter?.let { contactsAdapter = it }
-        }
+        appAdapter?.let { appsAdapter = it }
+        contactAdapter?.let { contactsAdapter = it }
 
         val searchTextView = binding.search.findViewById<TextView>(R.id.search_src_text)
 
@@ -587,15 +584,18 @@ class AppDrawerFragment : BaseFragment() {
             when (menuView.displayedChild) {
                 0 -> {
                     setAppViewDetails()
+                    updateAZSidebarForApps(appsAdapter.appsList)
                 }
 
                 1 -> {
                     setContactViewDetails()
+                    updateAZSidebarForContacts(contactsAdapter.contactsList)
                 }
             }
         }
     }
 
+
     private fun setAppViewDetails() {
         binding.apply {
             searchSwitcher.setImageResource(R.drawable.ic_contacts)
@@ -772,13 +772,19 @@ class AppDrawerFragment : BaseFragment() {
             AnimationUtils.loadLayoutAnimation(requireContext(), R.anim.layout_anim_from_bottom)
         binding.appsRecyclerView.layoutAnimation = animation
         appAdapter.setAppList(apps.toMutableList())
+
+        // ✅ ENABLE dynamic AZ letters
+        updateAZSidebarForApps(apps)
     }
 
     private fun populateContactList(contacts: List<ContactListItem>, contactAdapter: ContactDrawerAdapter) {
         val animation =
             AnimationUtils.loadLayoutAnimation(requireContext(), R.anim.layout_anim_from_bottom)
         binding.contactsRecyclerView.layoutAnimation = animation
         contactAdapter.setContactList(contacts.toMutableList())
+
+        // ✅ ENABLE dynamic AZ letters
+        updateAZSidebarForContacts(contacts)
     }
 
     private fun appClickListener(
@@ -863,4 +869,30 @@ class AppDrawerFragment : BaseFragment() {
         // Close the drawer or fragment after selection
         findNavController().popBackStack()
     }
+
+    private fun updateAZSidebarForApps(apps: List<AppListItem>) {
+        val letters = mutableSetOf<String>()
+
+        apps.forEach { item ->
+            when (item.category) {
+                AppCategory.PINNED -> letters.add("★")
+                else -> {
+                    item.label.firstOrNull()
+                        ?.uppercaseChar()
+                        ?.toString()
+                        ?.let { letters.add(it) }
+                }
+            }
+        }
+
+        binding.azSidebar.setAvailableLetters(letters)
+    }
+
+    private fun updateAZSidebarForContacts(contacts: List<ContactListItem>) {
+        val letters = contacts.mapNotNull {
+            it.displayName.firstOrNull()?.uppercaseChar()?.toString()
+        }.toSet()
+
+        binding.azSidebar.setAvailableLetters(letters)
+    }
 }

app/src/main/java/com/github/codeworkscreativehub/mlauncher/ui/components/AZSidebarView.kt

@@ -9,6 +9,7 @@ import android.graphics.Typeface
 import android.util.AttributeSet
 import android.view.MotionEvent
 import android.view.View
+import android.view.accessibility.AccessibilityEvent
 import com.github.codeworkscreativehub.mlauncher.helper.CustomFontView
 import com.github.codeworkscreativehub.mlauncher.helper.FontManager
 import com.github.codeworkscreativehub.mlauncher.helper.sp2px
@@ -20,103 +21,161 @@ class AZSidebarView @JvmOverloads constructor(
 
     var onTouchStart: (() -> Unit)? = null
     var onTouchEnd: (() -> Unit)? = null
+    var onLetterSelected: ((String) -> Unit)? = null
+
+    private val allLetters = listOf('★') + ('A'..'Z')
+    private var letters: List<Char> = allLetters
 
-    private val letters = listOf('★') + ('A'..'Z')
     private val baseTextSizeSp = 20f
     private val selectedTextSizeSp = baseTextSizeSp + 2f
 
     private val paint = Paint(Paint.ANTI_ALIAS_FLAG).apply {
         color = Color.GRAY
-        textSize = sp2px(resources, baseTextSizeSp)
         textAlign = Paint.Align.CENTER
         style = Paint.Style.FILL
+        textSize = sp2px(resources, baseTextSizeSp)
         typeface = FontManager.getTypeface(context)
     }
 
-    var onLetterSelected: ((String) -> Unit)? = null
     private var spacingFactor = 1f
-    private var selectedIndex: Int = -1
+    private var selectedIndex = -1
+    private var itemHeight = 0f
+
+    // Accessibility
+    init {
+        isFocusable = true
+        importantForAccessibility = IMPORTANT_FOR_ACCESSIBILITY_YES
+
+        // 🔗 Register for global font updates
+        FontManager.register(this)
+    }
 
     val topBottomPaddingPx: Float
-        get() = 180 * resources.displayMetrics.density
+        get() = 180f * resources.displayMetrics.density
 
-    init {
-        val displayMetrics = resources.displayMetrics
-        val screenHeight = displayMetrics.heightPixels.toFloat()
-        val density = displayMetrics.density
+    // ✅ FIX: Calculate spacing using ACTUAL view height
+    override fun onSizeChanged(w: Int, h: Int, oldw: Int, oldh: Int) {
+        super.onSizeChanged(w, h, oldw, oldh)
 
-        val topBottomPadding = topBottomPaddingPx
+        val density = resources.displayMetrics.density
         val interLetterSpacing = (letters.size - 1) * density
-        val availableHeight = screenHeight - topBottomPadding - interLetterSpacing
         val baseTextHeight = sp2px(resources, baseTextSizeSp)
 
+        val availableHeight = h - topBottomPaddingPx - interLetterSpacing
         spacingFactor = availableHeight / (letters.size * baseTextHeight)
 
-        // 🔗 Register for global font updates
-        FontManager.register(this)
+        itemHeight = baseTextHeight * spacingFactor
     }
 
     override fun onDraw(canvas: Canvas) {
         super.onDraw(canvas)
 
-        val itemHeight = sp2px(resources, baseTextSizeSp) * spacingFactor
+        if (itemHeight <= 0f) return
+
         val totalHeight = itemHeight * letters.size
         val startY = (height - totalHeight) / 2f
 
-        letters.forEachIndexed { i, letter ->
-            val isSelected = i == selectedIndex
+        // ✅ FIX: Typeface resolved ONCE per draw
+        paint.typeface = FontManager.getTypeface(context)
+
+        letters.forEachIndexed { index, letter ->
+            val isSelected = index == selectedIndex
 
             paint.isFakeBoldText = isSelected
-            paint.textSize = sp2px(resources, if (isSelected) selectedTextSizeSp else baseTextSizeSp)
+            paint.textSize = sp2px(
+                resources,
+                if (isSelected) selectedTextSizeSp else baseTextSizeSp
+            )
             paint.color = if (isSelected) Color.WHITE else Color.GRAY
-            paint.typeface = FontManager.getTypeface(context) // Refresh font if needed
 
             val x = width / 2f
-            val y = startY + itemHeight * i - (paint.descent() + paint.ascent()) / 2
+            val y = startY + itemHeight * index -
+                    (paint.descent() + paint.ascent()) / 2f
 
             canvas.drawText(letter.toString(), x, y, paint)
         }
     }
 
     @SuppressLint("ClickableViewAccessibility")
     override fun onTouchEvent(event: MotionEvent): Boolean {
-        val itemHeight = sp2px(resources, baseTextSizeSp) * spacingFactor
+        if (itemHeight <= 0f) return false
+
         val totalHeight = itemHeight * letters.size
         val startY = (height - totalHeight) / 2f
 
         val relativeY = event.y - startY
-        val index = (relativeY / itemHeight).toInt().coerceIn(0, letters.size - 1)
+        val index = (relativeY / itemHeight)
+            .toInt()
+            .coerceIn(0, letters.size - 1)
 
         when (event.action) {
-            MotionEvent.ACTION_DOWN, MotionEvent.ACTION_MOVE -> {
-                if (index != selectedIndex) {
-                    selectedIndex = index
-                    onLetterSelected?.invoke(letters[index].toString())
-                    invalidate()
-                }
+            MotionEvent.ACTION_DOWN -> {
                 onTouchStart?.invoke()
+                handleSelection(index)
             }
 
-            MotionEvent.ACTION_UP, MotionEvent.ACTION_CANCEL -> {
+            MotionEvent.ACTION_MOVE -> {
+                handleSelection(index)
+            }
+
+            MotionEvent.ACTION_UP,
+            MotionEvent.ACTION_CANCEL -> {
                 onTouchEnd?.invoke()
             }
         }
 
         return true
     }
 
+    private fun handleSelection(index: Int) {
+        if (index == selectedIndex) return
+
+        selectedIndex = index
+        val letter = letters[index].toString()
+
+        onLetterSelected?.invoke(letter)
+
+        // ✅ FIX: Accessibility announcement
+        announceLetterForAccessibility(letter)
+
+        invalidate()
+    }
+
+    // ✅ FIX: Works for ★ and letters
     fun setSelectedLetter(letter: String) {
-        val char = letter.firstOrNull()?.uppercaseChar() ?: return
-        val index = letters.indexOf(char)
-        if (index != -1 && selectedIndex != index) {
+        val index = letters.indexOfFirst { it.toString() == letter }
+        if (index != -1 && index != selectedIndex) {
             selectedIndex = index
             invalidate()
         }
     }
 
+    /**
+     * Update sidebar letters based on available app sections.
+     *
+     * Example input: setOf("★", "A", "C", "D", "M")
+     */
+    fun setAvailableLetters(available: Set<String>) {
+        letters = allLetters.filter { it.toString() in available }
+
+        // Reset selection safely
+        if (selectedIndex >= letters.size) {
+            selectedIndex = -1
+        }
+
+        requestLayout()
+        invalidate()
+    }
+
     /** 🔁 Called by FontManager to update font */
     override fun applyFont(typeface: Typeface?) {
         paint.typeface = typeface
         invalidate()
     }
+
+    private fun announceLetterForAccessibility(text: String) {
+        contentDescription = text
+        sendAccessibilityEvent(AccessibilityEvent.TYPE_VIEW_SELECTED)
+    }
+
 }