@mmerterden/multi-agent-pipeline 8.6.0

package/pipeline/skills/figma-ios/figma-to-component/reference/accessibility.md

@@ -0,0 +1,129 @@
+# ACCESSIBILITY INTEGRATION
+
+SwiftUI accessibility implementation guide.
+
+---
+
+## Imports
+
+```swift
+import UIComponentUtilities   // View extensions
+import AccessibilityStringKeys // LocalizedAccessibilityStringKey
+import UITestingIdentifiers    // UITestingIdentifierKey
+```
+
+---
+
+## Key Types
+
+| Type | Purpose | Source |
+|------|---------|--------|
+| `LocalizedAccessibilityStringKey` | Labels, hints, values (localized) | AccessibilityStringKeys |
+| `UITestingIdentifierKey` | Identifiers (not localized) | UITestingIdentifiers |
+
+---
+
+## Modifiers
+
+| Modifier | Use Case | Key Type |
+|----------|----------|----------|
+| `.accessibilityLabel(_:)` | Screen reader text | `LocalizedAccessibilityStringKey` |
+| `.accessibilityHint(_:)` | Action description | `LocalizedAccessibilityStringKey` |
+| `.accessibilityValue(_:)` | Current state | `LocalizedAccessibilityStringKey` |
+| `.accessibilityIdentifier(_:)` | UI testing only | `UITestingIdentifierKey` |
+| `.accessibilityAddTraits(_:)` | Element behavior | `AccessibilityTraits` |
+| `.accessibilityRemoveTraits(_:)` | Override default | `AccessibilityTraits` |
+| `.accessibilityHidden(_:)` | Hide decorative | `Bool` |
+
+---
+
+## Traits
+
+| Trait | When to Use |
+|-------|-------------|
+| `.isButton` | Tappable action |
+| `.isLink` | Navigation to external/new screen |
+| `.isHeader` | Section header |
+| `.isImage` | Meaningful image |
+| `.isSelected` | Current selection state |
+| `.isStaticText` | Non-interactive text |
+| `.updatesFrequently` | Live data (timers, scores) |
+
+---
+
+## Patterns
+
+```swift
+// Interactive Button
+Button(action: onTap) { Image(systemName: "xmark") }
+    .accessibilityLabel(.Button.close)
+    .accessibilityHint(.Button.closeHint)
+    .accessibilityIdentifier(UITestingIdentifierKey.Dialog.closeButton)
+
+// Meaningful Image
+Image("flightIcon").accessibilityLabel(.Flight.directFlight)
+
+// Decorative Image
+Image("decorativeLine").accessibilityHidden(true)
+
+// Toggle/Selection
+Toggle(isOn: $isSelected) { ... }
+    .accessibilityLabel(.Seat.premium)
+    .accessibilityValue(isSelected ? .State.selected : .State.notSelected)
+    .accessibilityAddTraits(isSelected ? .isSelected : [])
+
+// List Item (dynamic index)
+.accessibilityIdentifier(UITestingIdentifierKey.List.item.with(index))
+
+// Grouped Content
+VStack { Text(title); Text(subtitle) }
+    .accessibilityElement(children: .combine)
+```
+
+---
+
+## Rules
+
+| Rule | Implementation |
+|------|----------------|
+| No redundant info | Don't repeat visible text in label |
+| No "button" in label | Trait handles it |
+| No "tap to" in hint | VoiceOver adds "double tap to" |
+| Localize labels/hints/values | Use `LocalizedAccessibilityStringKey` |
+| Use typed identifiers | Use `UITestingIdentifierKey` |
+| Group related content | `.accessibilityElement(children: .combine)` |
+| Hide decorative | `.accessibilityHidden(true)` |
+
+---
+
+## Identifier Context
+
+`.accessibilityIdentifier` supports cascading context via `UIIdentifierContext`.
+This helps accessibility automation distinguish identical component instances.
+
+```swift
+// Parent sets context
+ContentView()
+    .identifierContext(.BookingSummary.screen)
+
+// Child component's .accessibilityIdentifier(.TurkishButton.button)
+// → "bookingsummary_screen_turkishbutton_button"
+```
+
+VoiceOver labels (`.accessibilityLabel`) do NOT cascade — use SwiftUI's
+built-in grouping (`.accessibilityElement(children: .combine)`).
+
+---
+
+## Checklist
+
+```
+[ ] Labels use LocalizedAccessibilityStringKey
+[ ] Identifiers use UITestingIdentifierKey
+[ ] Buttons have hints (if action unclear)
+[ ] Images: meaningful=label, decorative=hidden
+[ ] Selection states have .isSelected trait
+[ ] Headers have .isHeader trait
+[ ] Related content grouped
+[ ] Dynamic values use .accessibilityValue
+```

package/pipeline/skills/figma-ios/figma-to-component/reference/analytics-events.md

@@ -0,0 +1,64 @@
+# UI ANALYTICS EVENTS REFERENCE
+
+SOURCE: `Packages/{project.slug}-common/iOS/Sources/AnalyticsEvents/Generated/UI/`
+
+---
+
+## Event Index
+
+| Category | Event | Firebase Name | Required Params |
+|----------|-------|---------------|-----------------|
+| Interaction | `UIInteractionButtonTapped` | `button_tapped` | buttonId, buttonType(.primary/.secondary/.tertiary/.text/.icon), screenName |
+| Interaction | `UIInteractionCardTapped` | `select_content` | cardId, screenName |
+| Interaction | `UIInteractionLinkTapped` | `link_tapped` | linkId, linkType(.internal/.external/.deeplink/.phone/.email), screenName |
+| Interaction | `UIInteractionToggleChanged` | `toggle_changed` | toggleId, newValue, previousValue, screenName |
+| Interaction | `UIInteractionLoginButtonTapped` | `login_button_tapped` | buttonId, loginMethod(.email/.social/.biometric/.sso), screenName |
+| Form | `UIFormFormSubmitted` | `form_submitted` | formId, screenName |
+| Form | `UIFormFormValidationError` | `form_validation_error` | formId, screenName |
+| Form | `UIFormTextFieldFocused` | `text_field_focused` | fieldId, fieldType(.text/.email/.password/.phone/.number/.date), screenName |
+| Navigation | `UINavigationTabChanged` | `tab_changed` | tabId, tabIndex |
+| Navigation | `UINavigationModalPresented` | `modal_presented` | modalId, presentationType(.sheet/.fullScreen/.popover/.alert) |
+| Navigation | `UINavigationModalDismissed` | `modal_dismissed` | modalId, dismissalType(.swipe/.button/.tap_outside/.programmatic) |
+| Navigation | `UINavigationDeepLinkOpened` | `deep_link_opened` | path, url |
+| Screen | `UIScreenViewed` | `screen_view` | screenClass, screenName |
+| Screen | `UIScreenExited` | `screen_exited` | screenClass, screenName |
+| Search | `UISearchSearchPerformed` | `search` | searchId, searchTerm, searchType(.text/.voice/.suggestion/.filter), screenName |
+| Search | `UISearchSearchResultTapped` | `select_content` | position, resultId, searchId, screenName |
+| Visibility | `UIVisibilityElementImpression` | `element_impression` | elementId, elementType(.banner/.card/.promotion/.advertisement), screenName |
+| Visibility | `UIVisibilityScrollReachedEnd` | `scroll_reached_end` | contentId, contentType(.list/.feed/.page/.article/.carousel), screenName |
+| Visibility | `UIVisibilityPullToRefreshTriggered` | `pull_to_refresh_triggered` | contentId, screenName |
+| Error | `UIErrorErrorDisplayed` | `error_displayed` | errorId, errorType(.network/.validation/.authentication/.server/.unknown), displayType(.alert/.banner/.toast/.inline/.fullScreen), screenName |
+
+---
+
+## SwiftUI View Modifiers
+
+Available in `UIComponentUtilities/Analytics/`:
+
+| Modifier | Event |
+|----------|-------|
+| `.analyticsScreen(_:)` | UIScreenViewed/Exited |
+| `.analyticsButton(id:label:type:)` | UIInteractionButtonTapped |
+| `.analyticsCard(id:title:type:position:)` | UIInteractionCardTapped |
+| `.analyticsLink(id:text:destination:type:)` | UIInteractionLinkTapped |
+| `.analyticsToggle(id:label:isOn:)` | UIInteractionToggleChanged |
+| `.analyticsTabChanged(id:selectedIndex:label:)` | UINavigationTabChanged |
+| `.analyticsImpression(id:type:name:position:)` | UIVisibilityElementImpression |
+| `.analyticsModal(id:name:type:)` | UINavigationModalPresented/Dismissed |
+| `.analyticsError(id:type:code:message:displayType:)` | UIErrorErrorDisplayed |
+
+---
+
+## Direct Event Usage
+
+```swift
+import AnalyticsEvents
+
+UIInteractionButtonTapped(
+    buttonId: "submit_button",
+    buttonLabel: "Submit",
+    buttonType: .primary,
+    componentPath: nil,
+    screenName: "Checkout"
+).track()
+```