android-sdd 1.0.0

package/skills/System Integration/share-intent/SKILL.md

@@ -0,0 +1,182 @@
+---
+name: share-intent
+description: >
+  Sharing content from Android apps using Intent and ShareSheet.
+  Load this skill when sharing text, URLs, images, or files with other
+  apps, customizing the share sheet, receiving shared content,
+  or implementing the Android Sharesheet API.
+---
+
+# Share Intent
+
+## Overview
+Android's share system lets apps send and receive content through `Intent.ACTION_SEND`. The system displays a share sheet with compatible apps. Modern apps use the `ShareCompat` API or `rememberLauncherForActivityResult` in Compose for a cleaner integration.
+
+---
+
+## Core Principles
+
+- Use `ShareCompat.IntentBuilder` — not raw `Intent` — for outgoing shares
+- Always use `FileProvider` for sharing files — direct `file://` URIs are blocked on Android 7+
+- Handle incoming share intents in `onNewIntent` as well as `onCreate`
+- Validate incoming share content — treat it as untrusted input
+- Use `ChooserIntent` to customize the share sheet title
+
+---
+
+## Sharing Text and URLs
+
+```kotlin
+// ✅ Share plain text or URL
+fun shareText(context: Context, text: String, title: String = "Share via") {
+    val intent = ShareCompat.IntentBuilder(context)
+        .setType("text/plain")
+        .setText(text)
+        .setChooserTitle(title)
+        .createChooserIntent()
+
+    context.startActivity(intent)
+}
+
+// ✅ Share URL with subject
+fun shareUrl(context: Context, url: String, subject: String) {
+    val intent = ShareCompat.IntentBuilder(context)
+        .setType("text/plain")
+        .setText(url)
+        .setSubject(subject)
+        .setChooserTitle("Share link via")
+        .createChooserIntent()
+
+    context.startActivity(intent)
+}
+```
+
+---
+
+## Sharing Images
+
+```kotlin
+// ✅ Share image via FileProvider
+fun shareImage(context: Context, imageFile: File) {
+    val uri = FileProvider.getUriForFile(
+        context,
+        "${context.packageName}.fileprovider",
+        imageFile
+    )
+
+    val intent = ShareCompat.IntentBuilder(context)
+        .setType("image/jpeg")
+        .setStream(uri)
+        .setChooserTitle("Share image via")
+        .createChooserIntent()
+        .addFlags(Intent.FLAG_GRANT_READ_URI_PERMISSION)
+
+    context.startActivity(intent)
+}
+```
+
+---
+
+## FileProvider Setup
+
+```xml
+<!-- AndroidManifest.xml -->
+<provider
+    android:name="androidx.core.content.FileProvider"
+    android:authorities="${applicationId}.fileprovider"
+    android:exported="false"
+    android:grantUriPermissions="true">
+    <meta-data
+        android:name="android.support.FILE_PROVIDER_PATHS"
+        android:resource="@xml/file_paths" />
+</provider>
+```
+
+```xml
+<!-- res/xml/file_paths.xml -->
+<paths>
+    <cache-path name="cache" path="." />
+    <files-path name="files" path="." />
+    <external-cache-path name="external_cache" path="." />
+</paths>
+```
+
+---
+
+## Sharing in Compose
+
+```kotlin
+// ✅ Share from Compose
+@Composable
+fun ShareButton(text: String) {
+    val context = LocalContext.current
+
+    Button(onClick = {
+        shareText(context, text)
+    }) {
+        Icon(Icons.Default.Share, contentDescription = null)
+        Spacer(Modifier.width(8.dp))
+        Text("Share")
+    }
+}
+```
+
+---
+
+## Receiving Shared Content
+
+```kotlin
+// ✅ Handle incoming share in Activity
+class MainActivity : ComponentActivity() {
+
+    override fun onCreate(savedInstanceState: Bundle?) {
+        super.onCreate(savedInstanceState)
+        handleIncomingShare(intent)
+        setContent { AppContent() }
+    }
+
+    override fun onNewIntent(intent: Intent) {
+        super.onNewIntent(intent)
+        handleIncomingShare(intent)
+    }
+
+    private fun handleIncomingShare(intent: Intent?) {
+        if (intent?.action != Intent.ACTION_SEND) return
+
+        when {
+            intent.type == "text/plain" -> {
+                val text = intent.getStringExtra(Intent.EXTRA_TEXT) ?: return
+                // handle text
+            }
+            intent.type?.startsWith("image/") == true -> {
+                val uri = intent.getParcelableExtra<Uri>(Intent.EXTRA_STREAM) ?: return
+                // handle image URI
+            }
+        }
+    }
+}
+
+// Register in manifest to receive shares
+// <intent-filter>
+//     <action android:name="android.intent.action.SEND" />
+//     <category android:name="android.intent.category.DEFAULT" />
+//     <data android:mimeType="text/plain" />
+//     <data android:mimeType="image/*" />
+// </intent-filter>
+```
+
+---
+
+## Anti-Patterns
+
+- Using `file://` URI directly in share intent — blocked on Android 7+ (FileUriExposedException)
+- Not granting `FLAG_GRANT_READ_URI_PERMISSION` for FileProvider URIs — receiving app can't read
+- Not validating incoming shared content — treat as untrusted
+- Using `startActivity` without a chooser for text sharing — opens default app silently
+
+---
+
+## Related Skills
+- `filesystem` — writing files to share via FileProvider
+- `manifest` — intent filter for receiving shares
+- `deep-link` — handling incoming intents

package/skills/Testing/Compose Testing/SKILL.md

@@ -0,0 +1,296 @@
+---
+name: compose-testing
+description: >
+  Jetpack Compose UI testing APIs and patterns.
+  Load this skill when using ComposeTestRule, finding nodes by semantics,
+  testing animations, asserting accessibility properties, verifying
+  recomposition behavior, or debugging failing Compose tests.
+---
+
+# Compose Testing
+
+## Overview
+Compose Testing uses a semantic tree — a parallel representation of the UI — to find and interact with composables. Unlike Espresso's view hierarchy, Compose tests work through `SemanticsNode`s which expose accessibility properties. Tests are deterministic because `ComposeTestRule` controls the clock.
+
+---
+
+## Core Principles
+
+- Tests interact through the **semantic tree** — not the visual layout
+- **`testTag`** is the most reliable locator — use for non-text UI elements
+- **`contentDescription`** serves double duty — accessibility and testability
+- `ComposeTestRule` **controls the clock** — animations and async are deterministic
+- Compose tests are **synchronous by default** — the rule awaits idle state after each action
+
+---
+
+## Test Rule Setup
+
+```kotlin
+// ✅ For isolated composable tests (no Activity needed)
+@get:Rule
+val composeRule = createComposeRule()
+
+// ✅ For full Activity/NavHost tests
+@get:Rule
+val composeRule = createAndroidComposeRule<MainActivity>()
+
+// ✅ For Hilt + Activity tests
+@HiltAndroidTest
+class MyScreenTest {
+    @get:Rule(order = 0) val hiltRule = HiltAndroidRule(this)
+    @get:Rule(order = 1) val composeRule = createAndroidComposeRule<MainActivity>()
+}
+```
+
+---
+
+## Semantic Matchers Reference
+
+```kotlin
+// ── Text ──────────────────────────────────────────────────────────────────
+hasText("Submit")                          // exact match
+hasText("ubmit", substring = true)         // substring
+hasText("submit", ignoreCase = true)       // case-insensitive
+
+// ── Tags ──────────────────────────────────────────────────────────────────
+hasTestTag("my_button")
+
+// ── Accessibility ─────────────────────────────────────────────────────────
+hasContentDescription("Back")
+hasContentDescription("icon", substring = true)
+
+// ── Role / Type ───────────────────────────────────────────────────────────
+isDialog()
+isPopup()
+isFocused()
+isEnabled()
+isNotEnabled()
+hasClickAction()
+hasScrollAction()
+isSelected()
+isToggleable()
+isOn()
+isOff()
+
+// ── Hierarchy ─────────────────────────────────────────────────────────────
+hasParent(hasTestTag("card"))
+hasAnyChild(hasText("Ali"))
+hasAnySibling(hasText("Submit"))
+
+// ── Combining ─────────────────────────────────────────────────────────────
+hasText("Ali") and isEnabled()
+hasText("Ali") or hasTestTag("ali_node")
+```
+
+---
+
+## Finding Nodes
+
+```kotlin
+// Single node — throws if 0 or 2+ found
+composeRule.onNodeWithText("Submit")
+composeRule.onNodeWithTag("loading_indicator")
+composeRule.onNodeWithContentDescription("Close")
+composeRule.onNode(hasText("Ali") and isEnabled())
+
+// Multiple nodes
+composeRule.onAllNodesWithText("Item")
+composeRule.onAllNodesWithTag("list_item")
+composeRule.onAllNodes(hasClickAction())
+
+// Indexed access
+composeRule.onAllNodesWithTag("list_item")[0]
+composeRule.onAllNodesWithTag("list_item").onFirst()
+composeRule.onAllNodesWithTag("list_item").onLast()
+```
+
+---
+
+## Actions
+
+```kotlin
+val node = composeRule.onNodeWithTag("my_button")
+
+// Click
+node.performClick()
+node.performLongClick()
+node.performDoubleClick()
+
+// Text input
+node.performTextInput("Hello")
+node.performTextClearance()
+node.performTextReplacement("New text")
+
+// Scroll
+node.performScrollTo()                     // scroll this node into view
+node.performScrollToIndex(10)              // scroll LazyList to index
+node.performScrollToKey("item_key")        // scroll LazyList to keyed item
+node.performScrollToNode(hasText("Target"))
+
+// Gestures
+node.performTouchInput { swipeLeft() }
+node.performTouchInput { swipeUp() }
+node.performTouchInput { click(center) }
+
+// IME
+node.performImeAction()
+```
+
+---
+
+## Assertions
+
+```kotlin
+val node = composeRule.onNodeWithTag("result_text")
+
+// Existence
+node.assertExists()
+node.assertDoesNotExist()
+
+// Visibility
+node.assertIsDisplayed()
+node.assertIsNotDisplayed()
+
+// State
+node.assertIsEnabled()
+node.assertIsNotEnabled()
+node.assertIsFocused()
+node.assertIsSelected()
+node.assertIsOn()
+node.assertIsOff()
+
+// Content
+node.assertTextEquals("Exact text")
+node.assertTextContains("partial")
+node.assertContentDescriptionEquals("desc")
+node.assertHasClickAction()
+
+// Count
+composeRule.onAllNodesWithTag("item").assertCountEquals(3)
+```
+
+---
+
+## Testing State Changes
+
+```kotlin
+// ✅ Test that UI updates when state changes
+@Test
+fun showsErrorAfterFailedLoad() {
+    var state: UserListUiState by mutableStateOf(UserListUiState.Loading)
+
+    composeRule.setContent {
+        AppTheme {
+            UserListContent(state = state, onUserClick = {})
+        }
+    }
+
+    // Initial loading state
+    composeRule.onNodeWithTag("loading_indicator").assertIsDisplayed()
+
+    // Update state
+    state = UserListUiState.Error("Network failed")
+
+    // Verify UI updated
+    composeRule.onNodeWithText("Network failed").assertIsDisplayed()
+    composeRule.onNodeWithTag("loading_indicator").assertDoesNotExist()
+}
+```
+
+---
+
+## Clock Control and Animations
+
+```kotlin
+// ✅ Disable auto-advance for manual clock control
+composeRule.mainClock.autoAdvance = false
+
+// Advance by specific duration
+composeRule.mainClock.advanceTimeBy(300L)
+
+// Advance until idle
+composeRule.mainClock.advanceTimeUntilIdle()
+
+// ✅ Test animated visibility
+@Test
+fun animatedContentAppearsAfterDelay() {
+    var visible by mutableStateOf(false)
+
+    composeRule.setContent {
+        AnimatedVisibility(visible = visible) {
+            Text("Hello", modifier = Modifier.testTag("animated_text"))
+        }
+    }
+
+    composeRule.onNodeWithTag("animated_text").assertDoesNotExist()
+
+    visible = true
+    composeRule.mainClock.advanceTimeBy(500L)
+
+    composeRule.onNodeWithTag("animated_text").assertIsDisplayed()
+}
+```
+
+---
+
+## Debugging Failing Tests
+
+```kotlin
+// ✅ Print semantic tree to understand what's available
+composeRule.onRoot().printToLog("TEST_TAG")
+
+// ✅ Print subtree
+composeRule.onNodeWithTag("user_card").printToLog("CARD_TREE")
+
+// Output shows full semantic tree:
+// Node #1 at (0.0, 0.0, 411.4, 72.7)px
+//  |-Node #2 at (16.0, 12.0, 395.4, 60.7)px
+//      Text = "Ali Rezaei"
+//      Actions = [OnClick, GetTextLayoutResult]
+```
+
+---
+
+## waitUntil
+
+```kotlin
+// ✅ Wait for async UI change (max timeout)
+composeRule.waitUntil(timeoutMillis = 5_000) {
+    composeRule
+        .onAllNodesWithTag("user_item")
+        .fetchSemanticsNodes()
+        .isNotEmpty()
+}
+
+// ✅ Wait for node to appear
+composeRule.waitUntilAtLeastOneExists(
+    hasTestTag("user_item"),
+    timeoutMillis = 5_000
+)
+
+// ✅ Wait for node to disappear
+composeRule.waitUntilDoesNotExist(
+    hasTestTag("loading_indicator"),
+    timeoutMillis = 5_000
+)
+```
+
+---
+
+## Anti-Patterns
+
+- Using `Thread.sleep()` for async waits — use `waitUntil` or let the test rule handle idle
+- Locating nodes by position index in UI — fragile; use `testTag` or content
+- Not wrapping test content in `AppTheme` — may fail if theme-dependent assertions are used
+- Asserting on implementation-level composable names — use semantic properties instead
+- `autoAdvance = false` without remembering to advance — test hangs indefinitely
+
+---
+
+## Related Skills
+- `ui-testing` — full screen UI tests with Activity
+- `compose` — Compose fundamentals including `testTag` placement
+- `snapshot-testing` — screenshot-based regression testing
+- `espresso` — View-based UI testing
+- `accessibility` — semantic properties used in both testing and accessibility