@mmerterden/multi-agent-pipeline 11.2.0 → 11.3.1

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

@@ -1,183 +0,0 @@
-# ACCESSIBILITY INTEGRATION
-
-SwiftUI accessibility implementation guide. **Minimalism first, then correctness** — decide *whether* to annotate before deciding *what*. The key-type names below (`LocalizedAccessibilityStringKey`, `UITestingIdentifierKey`) are the project's generated a11y/testing-id key types; a project without them uses runtime strings.
-
----
-
-## Core principle — accessibility is for vision-impaired users
-
-Every annotation must pass one test:
-
-> **"Does a vision-impaired person need this information to navigate or use the app?"** YES → add it. NO → don't; it's noise.
-
-Visual state (colors, gradients, tier badges) is information sighted users consume *visually*. A colored "Success"/"Elite"/"Classic" indicator with visible text is just the text; the color is decorative, not actionable. Do **not** generate a per-enum-variant a11y key for state the user already knows.
-
-## How VoiceOver already works (don't duplicate it)
-
-VoiceOver reads the **accessibility tree**, which SwiftUI builds automatically:
-- `Text("Hello")` is already read — `.accessibilityLabel("Hello")` / `.accessibilityAddTraits(.isStaticText)` are redundant.
-- `Button("Save"){}` already reads "Save, Button" — label + trait are redundant.
-- `Image(decorative:)` is already hidden.
-- `.accessibilityElement(children: .combine)` merges an `HStack`/`VStack`'s child text into one stop — you do NOT then add `.accessibilityLabel`.
-- `.accessibilityLabel` **overrides** (replaces child text), it does not supplement — harmful when the child text was already correct.
-
-**The question for EVERY modifier: "what breaks if I remove this?"** If nothing breaks, the modifier should not exist.
-
-## Decision hierarchy (apply in order, STOP as soon as resolved)
-
-1. **Does it need ANY a11y work?** SwiftUI reads it correctly as-is → add NOTHING.
-2. **Decorative elements?** → `.accessibilityHidden(true)` on those only.
-3. **Group children?** → `.accessibilityElement(children: .combine)` — then STOP.
-4. **Combined text wrong/missing?** → ONLY then add `.accessibilityLabel`.
-5. **Interactive state VoiceOver can't infer** (custom toggle, not SwiftUI `Toggle`) → `.accessibilityValue`.
-6. **A trait SwiftUI can't infer** (custom tappable, not `Button`) → `.accessibilityAddTraits`.
-7. **Last resort** → author a localized a11y key.
-
-Most components stop at step 2 or 3. Reaching step 4+ requires a written justification.
-
-## State-necessity decision tree (per variant/boolean)
-
-1. **Interactive?** (Toggle/Checkbox/Selection/Switch) → YES: generate state value keys. NO → 2.
-2. **Visible text already communicates the state?** → YES: skip (redundant). NO → 3.
-3. **Non-interactive display component?** (Badge/Tag/Chip/Status/Label) → YES: skip state keys; use `.accessibilityElement(children: .combine)` only, no `.accessibilityLabel`. NO → 4.
-4. **Trivially derivable from an enum at runtime?** → YES: use `state.localized`, skip the separate key. NO: author a key.
-
-**Worked example — a non-interactive `LabelBadge` (Success | Warning | Error | …):** not interactive → visible text communicates intent → it's a display component ⇒ do NOT generate `LabelBadge.SuccessState` etc. Combine children; the badge text is read naturally.
-
-## Anti-patterns (never)
-
-| Anti-pattern | Why wrong |
-|---|---|
-| `.isButton` on a `Button` / `.isStaticText` on a `Text` | SwiftUI already provides it |
-| `.accessibilityRemoveTraits(.isButton)` with no Button | removing a trait that was never there |
-| `.accessibilityLabel` duplicating visible text | overrides SwiftUI's correct reading with a string you now maintain |
-| `.accessibilityLabel("\(text), \(state)")` on a non-interactive badge | the state name is a color cue, not information |
-| A separate key per enum variant | key bloat for trivially translatable names |
-| `.accessibilityHint` when the label is self-explanatory ("Close") | VoiceOver already prepends "double tap to" |
-| Modifiers "just in case" | every modifier is cost with no value |
-
----
-
-## 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

@@ -1,64 +0,0 @@
-# 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()
-```