android-ai-skills 1.2.0 → 1.4.0

package/CHANGELOG.md

@@ -1,3 +1,17 @@
+# [1.4.0](https://github.com/noloman/Android-AI-skills/compare/v1.3.0...v1.4.0) (2026-02-12)
+
+
+### Features
+
+* add 10 more cross-cutting skills (billing, Firebase, DI, networking, storage, auth, media, CI/CD, maps, ML) ([bb2990e](https://github.com/noloman/Android-AI-skills/commit/bb2990ebd9929d0c725c99c9cfcc94c88593b702))
+
+# [1.3.0](https://github.com/noloman/Android-AI-skills/compare/v1.2.0...v1.3.0) (2026-02-12)
+
+
+### Features
+
+* add 8 cross-cutting Android platform skills ([821a0d3](https://github.com/noloman/Android-AI-skills/commit/821a0d34bb2f193ea395a990411f2ef0d9c2c23a))
+
 # [1.2.0](https://github.com/noloman/Android-AI-skills/compare/v1.1.0...v1.2.0) (2026-02-12)
 
 

package/README.md

@@ -47,6 +47,24 @@ These AI skills:
 - Prevent architecture drift
 - Protect performance budgets
 - Keep KMP boundaries clean
+- Harden **security** (secrets, storage, network, components)
+- Ensure **Play Store compliance** (Data Safety, permissions, target SDK)
+- Enforce **accessibility** (WCAG AA contrast, touch targets, TalkBack)
+- Optimize **performance** (startup, memory, battery, app size)
+- Maintain **test quality** (test pyramid, Compose testing, screenshot tests)
+- Standardize **build infrastructure** (version catalogs, convention plugins, modularization)
+- Govern **background work** (WorkManager, foreground services, notifications)
+- Guide **navigation** (type-safe routes, deep links, App Links)
+- Enforce **Play Billing** (subscriptions, server verification, purchase lifecycle)
+- Integrate **Firebase** (Auth, Firestore, Crashlytics, FCM, Remote Config)
+- Standardize **dependency injection** (Hilt scoping, multi-module DI, testing)
+- Govern **networking** (Retrofit, OkHttp, Ktor, caching, error handling)
+- Manage **local storage** (Room, DataStore, offline-first, encryption)
+- Secure **authentication** (Credential Manager, biometrics, token management)
+- Handle **media** (Media3, CameraX, image loading, audio focus)
+- Automate **CI/CD** (GitHub Actions, Fastlane, signing, Play Store deployment)
+- Guide **maps & location** (FusedLocationProvider, geofencing, permissions)
+- Enable **on-device ML** (ML Kit, TFLite, Gemini Nano, model management)
 - Scale from indie to enterprise
 - Adapt automatically (Enterprise Mode auto-detection)
 
@@ -76,6 +94,96 @@ flowchart LR
     D --- L
     E --- L
     L --> M[Structured Concurrency & Flow]
+
+    N[android-security-best-practices]
+    C --- N
+    D --- N
+    E --- N
+
+    O[android-performance-best-practices]
+    C --- O
+    D --- O
+    E --- O
+
+    P[play-store-readiness]
+    C --- P
+    D --- P
+    E --- P
+
+    Q[android-testing-best-practices]
+    C --- Q
+    D --- Q
+    E --- Q
+
+    R[android-accessibility-best-practices]
+    C --- R
+    D --- R
+    E --- R
+
+    S[android-build-infra]
+    C --- S
+    D --- S
+    E --- S
+
+    T[android-background-work]
+    C --- T
+    D --- T
+    E --- T
+
+    U[android-navigation-best-practices]
+    C --- U
+    D --- U
+    E --- U
+
+    V[play-billing-best-practices]
+    C --- V
+    D --- V
+    E --- V
+
+    W[firebase-best-practices]
+    C --- W
+    D --- W
+    E --- W
+
+    X[android-dependency-injection]
+    C --- X
+    D --- X
+    E --- X
+
+    Y[android-networking]
+    C --- Y
+    D --- Y
+    E --- Y
+
+    Z[android-local-storage]
+    C --- Z
+    D --- Z
+    E --- Z
+
+    AA[android-auth-identity]
+    C --- AA
+    D --- AA
+    E --- AA
+
+    AB[android-media]
+    C --- AB
+    D --- AB
+    E --- AB
+
+    AC[android-ci-cd]
+    C --- AC
+    D --- AC
+    E --- AC
+
+    AD[android-maps-location]
+    C --- AD
+    D --- AD
+    E --- AD
+
+    AE[android-ml-ondevice]
+    C --- AE
+    D --- AE
+    E --- AE
 ```
 
 ---
@@ -139,6 +247,263 @@ Cross-cutting skill that always activates alongside the project-type-specific sk
 
 ---
 
+### 5. android-security-best-practices
+
+Cross-cutting skill — secrets management, secure storage, network security, component hardening.
+
+**Enforces:**
+- No hardcoded secrets in source code
+- EncryptedSharedPreferences / Android Keystore for sensitive data
+- HTTPS enforcement with Network Security Config
+- exported="false" by default on all components
+- PendingIntent.FLAG_IMMUTABLE, WebView file access disabled
+- R8 enabled for release builds
+- No sensitive data in logs
+
+---
+
+### 6. android-performance-best-practices
+
+Cross-cutting skill — startup optimization, memory management, battery, app size.
+
+**Enforces:**
+- TTID < 2s, TTFD < 4s
+- No heavy init on main thread during onCreate()
+- App Startup library, Baseline Profiles
+- No static Activity/Context references
+- StrictMode in debug builds
+- R8 + resource shrinking for release
+- WebP assets, Doze-aware networking
+
+---
+
+### 7. play-store-readiness
+
+Cross-cutting skill — Data Safety, permissions, target SDK, signing, release process.
+
+**Enforces:**
+- Data Safety section matches actual SDK behavior
+- Runtime permissions at point of use with rationale
+- Annual target SDK compliance
+- Play App Signing with separate upload key
+- AAB format, staged rollout (5-10%)
+- Crash-free rate target >= 99%
+- No debuggable release builds
+
+---
+
+### 8. android-testing-best-practices
+
+Cross-cutting skill — Compose UI testing, screenshot tests, Room migrations, CI strategy.
+
+**Enforces:**
+- Test pyramid (unit > integration > E2E)
+- Compose testing APIs for Compose UI (not Espresso)
+- Fakes over mocks
+- Room schema export + migration tests
+- Descriptive test names, no Thread.sleep()
+- Deterministic tests, flaky test quarantine
+- TestDispatcher + runTest for coroutines
+
+---
+
+### 9. android-accessibility-best-practices
+
+Cross-cutting skill — content descriptions, TalkBack, touch targets, contrast, semantics.
+
+**Enforces:**
+- contentDescription on all interactive non-text elements
+- 48dp minimum touch targets
+- WCAG AA contrast (4.5:1 normal, 3:1 large text)
+- No color-only information
+- Logical TalkBack reading order
+- Correct semantics on custom composables
+- sp (not dp) for text sizes
+
+---
+
+### 10. android-build-infra
+
+Cross-cutting skill — version catalogs, convention plugins, modularization, build variants.
+
+**Enforces:**
+- Gradle version catalogs (libs.versions.toml) for all dependencies
+- Convention plugins for shared build config
+- Feature modularization (feature-api/feature-impl)
+- Dependencies flow inward, no feature-to-feature deps
+- implementation scope by default
+- Build variants for debug/release/staging
+
+---
+
+### 11. android-background-work
+
+Cross-cutting skill — WorkManager, foreground services, notifications, scheduling.
+
+**Enforces:**
+- WorkManager for deferrable persistent work
+- Foreground service types declared (API 34+)
+- Notification channels (API 26+)
+- Never hold WakeLocks indefinitely
+- Exact alarms only for user-visible scheduling
+- POST_NOTIFICATIONS permission (API 33+)
+
+---
+
+### 12. android-navigation-best-practices
+
+Cross-cutting skill — type-safe routes, deep links, App Links, navigation patterns.
+
+**Enforces:**
+- Type-safe navigation (data class/object routes)
+- App Links verified with Digital Asset Links
+- Deep link fallbacks for non-installed users
+- No heavy logic in navigation callbacks
+- Standard launch mode with Navigation
+- Deep link parameter validation
+
+---
+
+### 13. play-billing-best-practices
+
+Cross-cutting skill — in-app purchases, subscriptions, server verification, testing.
+
+**Enforces:**
+- Server-side purchase verification — never trust client
+- Acknowledge all purchases within 3 days
+- Consume consumable purchases after delivery
+- Handle all BillingResponseCode values
+- Test with license testers on real devices
+- Handle pending purchases for slow payment methods
+
+---
+
+### 14. firebase-best-practices
+
+Cross-cutting skill — Auth, Firestore, Crashlytics, Remote Config, FCM, Analytics.
+
+**Enforces:**
+- Firebase BoM for consistent versions
+- Firestore security rules before production
+- No PII in Crashlytics logs
+- Respect user consent before Analytics collection
+- Handle FCM token rotation
+- Rate-limit Remote Config fetches
+
+---
+
+### 15. android-dependency-injection
+
+Cross-cutting skill — Hilt/Dagger setup, scoping, multi-module DI, testing.
+
+**Enforces:**
+- Hilt as default DI framework
+- Correct scoping (@Singleton, @ViewModelScoped)
+- Never inject Activity context into singletons
+- Constructor injection over field injection
+- @Binds for interface-to-implementation mapping
+- Focused modules per feature boundary
+
+---
+
+### 16. android-networking
+
+Cross-cutting skill — Retrofit, OkHttp, Ktor, caching, error handling, resilience.
+
+**Enforces:**
+- Suspend functions for all API calls
+- Explicit error handling for all HTTP codes
+- OkHttp interceptors for cross-cutting concerns
+- No request/response body logging in production
+- Token refresh in Authenticator
+- kotlinx.serialization or Moshi (not Gson)
+
+---
+
+### 17. android-local-storage
+
+Cross-cutting skill — Room, DataStore, offline-first architecture, caching, encryption.
+
+**Enforces:**
+- Room for relational data, DataStore for key-value
+- Export Room schemas and test all migrations
+- No database operations on main thread
+- Database as single source of truth
+- No sensitive data in unencrypted storage
+- Transactions for multi-table writes
+
+---
+
+### 18. android-auth-identity
+
+Cross-cutting skill — Credential Manager, biometrics, token management, session security.
+
+**Enforces:**
+- Credential Manager API for sign-in flows
+- Tokens in EncryptedSharedPreferences or Keystore
+- Transparent token refresh
+- BiometricPrompt (not FingerprintManager)
+- BIOMETRIC_STRONG for sensitive operations
+- Clear all credentials on logout
+
+---
+
+### 19. android-media
+
+Cross-cutting skill — Media3/ExoPlayer, CameraX, image loading, audio focus, PiP.
+
+**Enforces:**
+- Media3 for playback (not legacy ExoPlayer)
+- CameraX for camera (not Camera2 directly)
+- Coil or Glide for image loading
+- Audio focus management before playback
+- MediaSession for background playback
+- Lifecycle-aware resource release
+
+---
+
+### 20. android-ci-cd
+
+Cross-cutting skill — GitHub Actions, Fastlane, signing, Play Store deployment, build optimization.
+
+**Enforces:**
+- Never store signing keys in repository
+- Unit tests on every PR
+- Release AAB built in CI
+- Pin CI action versions to SHA hashes
+- Gradle build cache and configuration cache
+- Separate CI stages (lint → test → build → deploy)
+
+---
+
+### 21. android-maps-location
+
+Cross-cutting skill — Google Maps SDK, FusedLocationProvider, geofencing, permissions.
+
+**Enforces:**
+- FusedLocationProviderClient (not LocationManager)
+- Request only needed location accuracy
+- Remove location updates when not needed
+- Protect API keys with app restrictions
+- Foreground service for background location
+- Handle approximate vs precise location (API 31+)
+
+---
+
+### 22. android-ml-ondevice
+
+Cross-cutting skill — ML Kit, TensorFlow Lite, Gemini Nano, model management.
+
+**Enforces:**
+- ML Kit for common vision/NLP tasks
+- Run inference off main thread
+- Play Services-based models to reduce APK size
+- Validate model input/output shapes
+- Graceful fallback when models unavailable
+- Quantize models for size and performance
+
+---
+
 ## Enterprise Mode (Auto-Detection)
 
 Enterprise Mode activates automatically if the repository contains:
@@ -249,27 +614,99 @@ npx android-ai-skills@latest init --force
 Running `init` with defaults creates:
 
 ```
-AGENTS.md                                    # Codex
-CLAUDE.md                                    # Claude Code
-.github/copilot-instructions.md              # GitHub Copilot
-.cursor/rules/compose-best-practices.mdc     # Cursor (per skill)
+AGENTS.md                                            # Codex
+CLAUDE.md                                            # Claude Code
+.github/copilot-instructions.md                      # GitHub Copilot
+.cursor/rules/compose-best-practices.mdc             # Cursor (per skill)
 .cursor/rules/kmp-architecture-best-practices.mdc
 .cursor/rules/compose-multiplatform-best-practices.mdc
 .cursor/rules/kotlin-coroutines-best-practices.mdc
-.windsurfrules                               # Windsurf
-.clinerules/compose-best-practices.md        # Cline (per skill)
+.cursor/rules/android-security-best-practices.mdc
+.cursor/rules/android-performance-best-practices.mdc
+.cursor/rules/play-store-readiness.mdc
+.cursor/rules/android-testing-best-practices.mdc
+.cursor/rules/android-accessibility-best-practices.mdc
+.cursor/rules/android-build-infra.mdc
+.cursor/rules/android-background-work.mdc
+.cursor/rules/android-navigation-best-practices.mdc
+.cursor/rules/play-billing-best-practices.mdc
+.cursor/rules/firebase-best-practices.mdc
+.cursor/rules/android-dependency-injection.mdc
+.cursor/rules/android-networking.mdc
+.cursor/rules/android-local-storage.mdc
+.cursor/rules/android-auth-identity.mdc
+.cursor/rules/android-media.mdc
+.cursor/rules/android-ci-cd.mdc
+.cursor/rules/android-maps-location.mdc
+.cursor/rules/android-ml-ondevice.mdc
+.windsurfrules                                       # Windsurf
+.clinerules/compose-best-practices.md                # Cline (per skill)
 .clinerules/kmp-architecture-best-practices.md
 .clinerules/compose-multiplatform-best-practices.md
 .clinerules/kotlin-coroutines-best-practices.md
-.aiassistant/rules/compose-best-practices.md # JetBrains AI (per skill)
+.clinerules/android-security-best-practices.md
+.clinerules/android-performance-best-practices.md
+.clinerules/play-store-readiness.md
+.clinerules/android-testing-best-practices.md
+.clinerules/android-accessibility-best-practices.md
+.clinerules/android-build-infra.md
+.clinerules/android-background-work.md
+.clinerules/android-navigation-best-practices.md
+.clinerules/play-billing-best-practices.md
+.clinerules/firebase-best-practices.md
+.clinerules/android-dependency-injection.md
+.clinerules/android-networking.md
+.clinerules/android-local-storage.md
+.clinerules/android-auth-identity.md
+.clinerules/android-media.md
+.clinerules/android-ci-cd.md
+.clinerules/android-maps-location.md
+.clinerules/android-ml-ondevice.md
+.aiassistant/rules/compose-best-practices.md         # JetBrains AI (per skill)
 .aiassistant/rules/kmp-architecture-best-practices.md
 .aiassistant/rules/compose-multiplatform-best-practices.md
 .aiassistant/rules/kotlin-coroutines-best-practices.md
-.amazonq/rules/compose-best-practices.md     # Amazon Q (per skill)
+.aiassistant/rules/android-security-best-practices.md
+.aiassistant/rules/android-performance-best-practices.md
+.aiassistant/rules/play-store-readiness.md
+.aiassistant/rules/android-testing-best-practices.md
+.aiassistant/rules/android-accessibility-best-practices.md
+.aiassistant/rules/android-build-infra.md
+.aiassistant/rules/android-background-work.md
+.aiassistant/rules/android-navigation-best-practices.md
+.aiassistant/rules/play-billing-best-practices.md
+.aiassistant/rules/firebase-best-practices.md
+.aiassistant/rules/android-dependency-injection.md
+.aiassistant/rules/android-networking.md
+.aiassistant/rules/android-local-storage.md
+.aiassistant/rules/android-auth-identity.md
+.aiassistant/rules/android-media.md
+.aiassistant/rules/android-ci-cd.md
+.aiassistant/rules/android-maps-location.md
+.aiassistant/rules/android-ml-ondevice.md
+.amazonq/rules/compose-best-practices.md             # Amazon Q (per skill)
 .amazonq/rules/kmp-architecture-best-practices.md
 .amazonq/rules/compose-multiplatform-best-practices.md
 .amazonq/rules/kotlin-coroutines-best-practices.md
-CONVENTIONS.md                               # Aider
+.amazonq/rules/android-security-best-practices.md
+.amazonq/rules/android-performance-best-practices.md
+.amazonq/rules/play-store-readiness.md
+.amazonq/rules/android-testing-best-practices.md
+.amazonq/rules/android-accessibility-best-practices.md
+.amazonq/rules/android-build-infra.md
+.amazonq/rules/android-background-work.md
+.amazonq/rules/android-navigation-best-practices.md
+.amazonq/rules/play-billing-best-practices.md
+.amazonq/rules/firebase-best-practices.md
+.amazonq/rules/android-dependency-injection.md
+.amazonq/rules/android-networking.md
+.amazonq/rules/android-local-storage.md
+.amazonq/rules/android-auth-identity.md
+.amazonq/rules/android-media.md
+.amazonq/rules/android-ci-cd.md
+.amazonq/rules/android-maps-location.md
+.amazonq/rules/android-ml-ondevice.md
+CONVENTIONS.md                                       # Aider
 .aider.conf.yml
 ```
 
@@ -342,6 +779,24 @@ compose-best-practices/
 kmp-architecture-best-practices/
 compose-multiplatform-best-practices/
 kotlin-coroutines-best-practices/
+android-security-best-practices/
+android-performance-best-practices/
+play-store-readiness/
+android-testing-best-practices/
+android-accessibility-best-practices/
+android-build-infra/
+android-background-work/
+android-navigation-best-practices/
+play-billing-best-practices/
+firebase-best-practices/
+android-dependency-injection/
+android-networking/
+android-local-storage/
+android-auth-identity/
+android-media/
+android-ci-cd/
+android-maps-location/
+android-ml-ondevice/
 README.md
 ```
 

package/android-accessibility-best-practices/SKILL.md

@@ -0,0 +1,36 @@
+
+---
+name: android-accessibility-best-practices
+description: Android accessibility — content descriptions, TalkBack, touch targets, contrast, Compose semantics.
+---
+
+# Android Accessibility Best Practices
+
+Cross-cutting skill — always activates alongside the project-type-specific skill.
+
+## Hard Rules
+- Provide contentDescription on all interactive non-text elements.
+- Set contentDescription = null on purely decorative images.
+- Minimum touch target size: 48dp × 48dp.
+- Meet WCAG AA contrast ratios: 4.5:1 for normal text, 3:1 for large text.
+- Never convey information by color alone — add icons, patterns, or labels.
+- Ensure logical TalkBack reading order matches visual layout.
+- Apply correct semantics (Role, stateDescription) on custom composables.
+- Time-based content must be pausable or extendable.
+- All form fields must have associated labels.
+- Use sp (not dp) for text sizes to respect user font scaling.
+
+## Core Patterns
+- Use Modifier.semantics {} to expose custom component meaning.
+- Use mergeDescendants to group related elements for TalkBack.
+- Test with TalkBack enabled on a real device.
+- Run Accessibility Scanner for automated checks.
+- Support dynamic font sizes — test at maximum font scale.
+- Verify dark theme meets contrast requirements separately.
+
+## References
+- references/content_descriptions.md
+- references/talkback_navigation.md
+- references/touch_targets.md
+- references/color_contrast.md
+- references/compose_semantics.md

package/android-accessibility-best-practices/references/color_contrast.md

@@ -0,0 +1,30 @@
+# Color & Contrast
+
+## WCAG AA Requirements
+- Normal text (< 18sp or < 14sp bold): contrast ratio ≥ 4.5:1.
+- Large text (≥ 18sp or ≥ 14sp bold): contrast ratio ≥ 3:1.
+- Non-text elements (icons, borders, form fields): contrast ratio ≥ 3:1.
+- WCAG AAA (optional, stricter): 7:1 for normal text, 4.5:1 for large text.
+
+## Exceptions
+- Disabled/inactive elements: no contrast requirement (but consider usability).
+- Logos and decorative elements: no contrast requirement.
+- Text within images: same contrast requirements as regular text.
+
+## Color Independence
+- Never use color alone to convey information (e.g., red=error, green=success).
+- Add icons, patterns, underlines, or labels alongside color indicators.
+- Error states: use error icon + red color + descriptive text.
+- Charts/graphs: use patterns, labels, or shapes in addition to color.
+
+## Dark Theme
+- Verify contrast ratios for both light and dark themes separately.
+- Dark theme surfaces use lighter text — ensure sufficient contrast.
+- Surface color hierarchy matters: surface, surfaceVariant, surfaceContainer.
+- Test dynamic theming (Material You) — user-generated colors may fail contrast.
+
+## Tools
+- Accessibility Scanner (Android): scans visible UI for contrast issues.
+- WebAIM Contrast Checker: manual ratio calculation.
+- Colour Contrast Analyser (desktop): eyedropper-based tool.
+- Android Studio Layout Inspector: check rendered colors.

package/android-accessibility-best-practices/references/compose_semantics.md

@@ -0,0 +1,48 @@
+# Compose Semantics
+
+## Modifier.semantics
+- Use Modifier.semantics { } to add accessibility information to composables.
+- mergeDescendants = true: combines child semantics into a single TalkBack announcement.
+- clearAndSetSemantics { }: removes all child semantics and sets custom ones.
+
+## Roles
+- Role.Button: announces as "button" (double-tap to activate).
+- Role.Checkbox, Role.Switch, Role.RadioButton: announces toggle state.
+- Role.Tab: announces as "tab" with position.
+- Role.Image: announces as "image".
+- Set via: Modifier.semantics { role = Role.Button }.
+
+## State Description
+- stateDescription: announces the current state (e.g., "Selected", "Expanded", "50%").
+- toggleableState: ToggleableState.On, Off, Indeterminate.
+- selected: Boolean for selectable items.
+- Use for custom components that have states TalkBack should announce.
+
+## Headings & Structure
+- heading(): marks element as a heading for navigation.
+- Modifier.semantics { heading() } — TalkBack users can jump between headings.
+- Use for screen titles, section headers, group labels.
+
+## Content & Actions
+- contentDescription: text read by TalkBack.
+- customActions: list of CustomAccessibilityAction for contextual actions.
+- onClick(label = "action description") { }: labeled click action.
+- disabled(): marks element as non-interactive.
+- error("message"): announces error state.
+
+## Password & Input
+- password(): hides text from TalkBack, announces "password".
+- editableText: programmatic text for text fields.
+- textSelectionRange: cursor position information.
+- imeAction: announces expected keyboard action.
+
+## Live Regions
+- liveRegion = LiveRegionMode.Polite: announce changes when idle.
+- liveRegion = LiveRegionMode.Assertive: announce changes immediately.
+- Use for: toast messages, loading states, live counters, error banners.
+
+## Testing Semantics
+- Use ComposeTestRule.onNodeWithText().assertHasClickAction().
+- assert(SemanticsMatcher.keyIsDefined(SemanticsProperties.Heading)).
+- printToLog() to dump the semantic tree for debugging.
+- Verify role, state, and content description in tests.

package/android-accessibility-best-practices/references/content_descriptions.md

@@ -0,0 +1,32 @@
+# Content Descriptions
+
+## Required Elements
+- All interactive non-text elements: IconButton, Image (clickable), FAB, custom icons.
+- Compose: Image(contentDescription = "description") or Icon(contentDescription = "description").
+- View system: android:contentDescription or setContentDescription().
+
+## Decorative Elements
+- Set contentDescription = null on decorative images (Compose).
+- View system: android:importantForAccessibility="no".
+- Decorative = adds no information beyond what's already visible as text.
+
+## Writing Descriptions
+- Describe the action, not the appearance: "Delete item" not "Red trash can icon".
+- Keep it concise: 2–5 words is ideal.
+- Avoid "button" or "image" — TalkBack announces the role automatically.
+- Match the language of the UI locale.
+
+## Dynamic Descriptions
+- Update contentDescription when state changes (e.g., "Play" → "Pause").
+- Use stateDescription for toggle states (e.g., "Selected", "Expanded").
+- Compose: Modifier.semantics { stateDescription = "Expanded" }.
+
+## Icon + Text Combinations
+- If an icon is next to text that describes it, set icon contentDescription = null.
+- TalkBack reads both — redundant descriptions cause confusion.
+- Use mergeDescendants to group icon and text into one TalkBack announcement.
+
+## Live Regions
+- Use Modifier.semantics { liveRegion = LiveRegionMode.Polite } for dynamic updates.
+- Polite: announces when TalkBack is idle. Assertive: interrupts immediately.
+- Use for: snackbars, loading indicators, real-time counters.