onehook-api-client 1.0.18 → 1.0.20

package/telemetry/telemetry-catalog.json

@@ -0,0 +1,4137 @@
+{
+  "version": "1.3.0",
+  "screens": {
+    "NAV": {
+      "viewable": false,
+      "description": "Global navigation chrome (tab bar / sidebar / top bar)."
+    },
+    "LANDING": {
+      "viewable": true,
+      "description": "Signed-out marketing/landing screen."
+    },
+    "LOGIN": {
+      "viewable": true,
+      "description": "Sign-in (phone/email OTP, password, social, passkey)."
+    },
+    "REDEEM_INVITE": {
+      "viewable": true,
+      "description": "Invite redemption + account creation."
+    },
+    "ONBOARDING": {
+      "viewable": true,
+      "description": "First-run profile wizard."
+    },
+    "DISCOVER": {
+      "viewable": true,
+      "description": "Discovery deck of candidate profiles."
+    },
+    "LIKE_COMPOSER": {
+      "viewable": true,
+      "description": "Comment-to-like / rose composer sheet."
+    },
+    "LIKES_YOU": {
+      "viewable": true,
+      "description": "Received likes (\"Likes You\")."
+    },
+    "CHAT": {
+      "viewable": true,
+      "description": "Conversation surface (match list/switcher + thread)."
+    },
+    "CHAT_SETTINGS": {
+      "viewable": true,
+      "description": "Per-user chat privacy settings."
+    },
+    "NOTIFICATIONS": {
+      "viewable": true,
+      "description": "In-app notification center."
+    },
+    "PROFILE": {
+      "viewable": true,
+      "description": "The user's own profile hub."
+    },
+    "PROFILE_EDIT": {
+      "viewable": true,
+      "description": "Editing photos, prompts, voice and details."
+    },
+    "PROFILE_PREVIEW": {
+      "viewable": true,
+      "description": "Preview of the own profile as others see it."
+    },
+    "PREFERENCES": {
+      "viewable": true,
+      "description": "Matching / discovery preferences."
+    },
+    "SETTINGS": {
+      "viewable": true,
+      "description": "Account, security, appearance and danger-zone settings."
+    },
+    "PAYWALL": {
+      "viewable": true,
+      "description": "Membership comparison / upgrade."
+    },
+    "LIVENESS": {
+      "viewable": true,
+      "description": "Identity (liveness) verification."
+    },
+    "PHOTO_VIEWER": {
+      "viewable": true,
+      "description": "Full-screen photo viewer."
+    },
+    "SEARCH": {
+      "viewable": true,
+      "description": "Search / explore people."
+    },
+    "CREATE": {
+      "viewable": true,
+      "description": "Create menu (shortcuts to add a photo / prompt / voice note)."
+    },
+    "SHARED": {
+      "viewable": false,
+      "description": "Shared components hosted by many screens (alerts, toasts, phone field, voice recorder). Pair with `context` = host screen."
+    }
+  },
+  "tabs": [
+    "DISCOVER",
+    "LIKES_YOU",
+    "CHAT",
+    "PROFILE"
+  ],
+  "enums": {
+    "Platform": {
+      "description": "Client platform (from the X-OneHook-Platform header).",
+      "values": [
+        "web",
+        "ios",
+        "android"
+      ]
+    },
+    "Screen": {
+      "description": "Any product surface (incl. non-viewable chrome).",
+      "values": [
+        "NAV",
+        "LANDING",
+        "LOGIN",
+        "REDEEM_INVITE",
+        "ONBOARDING",
+        "DISCOVER",
+        "LIKE_COMPOSER",
+        "LIKES_YOU",
+        "CHAT",
+        "CHAT_SETTINGS",
+        "NOTIFICATIONS",
+        "PROFILE",
+        "PROFILE_EDIT",
+        "PROFILE_PREVIEW",
+        "PREFERENCES",
+        "SETTINGS",
+        "PAYWALL",
+        "LIVENESS",
+        "PHOTO_VIEWER",
+        "SEARCH",
+        "CREATE",
+        "SHARED"
+      ],
+      "aliases": {
+        "DISCOVERY": "DISCOVER",
+        "MATCHES": "CHAT",
+        "LIKES": "LIKES_YOU"
+      }
+    },
+    "ViewableScreen": {
+      "description": "A surface that can be the subject of screen_view, or the `context` of another signal.",
+      "values": [
+        "LANDING",
+        "LOGIN",
+        "REDEEM_INVITE",
+        "ONBOARDING",
+        "DISCOVER",
+        "LIKE_COMPOSER",
+        "LIKES_YOU",
+        "CHAT",
+        "CHAT_SETTINGS",
+        "NOTIFICATIONS",
+        "PROFILE",
+        "PROFILE_EDIT",
+        "PROFILE_PREVIEW",
+        "PREFERENCES",
+        "SETTINGS",
+        "PAYWALL",
+        "LIVENESS",
+        "PHOTO_VIEWER",
+        "SEARCH",
+        "CREATE"
+      ],
+      "aliases": {
+        "DISCOVERY": "DISCOVER",
+        "MATCHES": "CHAT",
+        "LIKES": "LIKES_YOU"
+      }
+    },
+    "TabScreen": {
+      "description": "Main-shell tabs.",
+      "values": [
+        "DISCOVER",
+        "LIKES_YOU",
+        "CHAT",
+        "PROFILE"
+      ],
+      "aliases": {
+        "DISCOVERY": "DISCOVER",
+        "MATCHES": "CHAT",
+        "LIKES": "LIKES_YOU"
+      }
+    },
+    "UiAction": {
+      "description": "The standard verbs for a UI interaction. Every platform uses these and only these.",
+      "values": [
+        "tap",
+        "long_press",
+        "submit",
+        "toggle",
+        "select",
+        "dismiss"
+      ],
+      "aliases": {
+        "click": "tap",
+        "press": "tap",
+        "touch_up_inside": "tap",
+        "longpress": "long_press"
+      }
+    },
+    "UiElementKind": {
+      "description": "Kind of control (informational; drives the default action).",
+      "values": [
+        "button",
+        "tab",
+        "toggle",
+        "link",
+        "list_item",
+        "menu_item",
+        "dialog_button",
+        "gesture",
+        "segmented"
+      ]
+    },
+    "SwipeDirection": {
+      "description": "Discovery decision direction: left = pass, right = like, up = rose/super.",
+      "values": [
+        "left",
+        "right",
+        "up"
+      ],
+      "aliases": {
+        "pass": "left",
+        "like": "right",
+        "rose": "up",
+        "super": "up"
+      }
+    },
+    "MediaType": {
+      "description": "Media element type.",
+      "values": [
+        "image",
+        "video",
+        "voice"
+      ],
+      "aliases": {
+        "photo": "image",
+        "audio": "voice"
+      }
+    },
+    "ProfileSection": {
+      "description": "Profile sections a viewer can dwell on.",
+      "values": [
+        "PHOTOS",
+        "BIO",
+        "INTERESTS",
+        "PROMPTS",
+        "VOICE"
+      ],
+      "aliases": {
+        "ABOUT": "BIO"
+      }
+    },
+    "LikeTargetType": {
+      "description": "Profile element a comment-to-like targets.",
+      "values": [
+        "PHOTO",
+        "VIDEO",
+        "VOICE",
+        "PROMPT",
+        "INTEREST",
+        "BIO"
+      ]
+    },
+    "SafetyAction": {
+      "description": "Safety UI intents (the action itself is server-authoritative).",
+      "values": [
+        "unmatch",
+        "block",
+        "report"
+      ]
+    },
+    "CardVariant": {
+      "description": "Which discovery card design produced the signal (segment metrics by design).",
+      "values": [
+        "interleaved",
+        "swipe",
+        "feed"
+      ]
+    },
+    "NotificationType": {
+      "description": "Kind of notification that was opened.",
+      "values": [
+        "new_match",
+        "new_like",
+        "new_message",
+        "reengagement",
+        "other"
+      ],
+      "aliases": {
+        "MUTUAL_MATCH": "new_match",
+        "PROFILE_LIKED": "new_like",
+        "SOMETHING_NEW": "reengagement",
+        "unknown": "other"
+      }
+    },
+    "NotificationChannel": {
+      "description": "Delivery channel of an opened notification.",
+      "values": [
+        "push",
+        "in_app"
+      ]
+    },
+    "HookedStateAction": {
+      "description": "Reaction to the \"one connection at a time\" (hooked) overlay.",
+      "values": [
+        "shown",
+        "go_to_chat",
+        "dismiss"
+      ]
+    }
+  },
+  "uiElements": {
+    "nav.tab_select": {
+      "screen": "NAV",
+      "kind": "tab",
+      "description": "Switch main tab. value = destination tab screen.",
+      "actions": [
+        "select"
+      ],
+      "values": [
+        "DISCOVER",
+        "LIKES_YOU",
+        "CHAT",
+        "PROFILE"
+      ],
+      "platforms": [
+        "web",
+        "ios",
+        "android"
+      ],
+      "deprecated": null
+    },
+    "nav.search_open": {
+      "screen": "NAV",
+      "kind": "button",
+      "description": "Open search / explore.",
+      "actions": [
+        "tap",
+        "dismiss"
+      ],
+      "values": null,
+      "platforms": [
+        "web"
+      ],
+      "deprecated": null
+    },
+    "nav.menu_open": {
+      "screen": "NAV",
+      "kind": "button",
+      "description": "Open the \"more\" / hamburger menu.",
+      "actions": [
+        "tap",
+        "dismiss"
+      ],
+      "values": null,
+      "platforms": [
+        "web"
+      ],
+      "deprecated": null
+    },
+    "nav.back": {
+      "screen": "NAV",
+      "kind": "button",
+      "description": "In-app back navigation (top bar back arrow).",
+      "actions": [
+        "tap"
+      ],
+      "values": null,
+      "platforms": [
+        "web"
+      ],
+      "deprecated": null
+    },
+    "nav.home_logo": {
+      "screen": "NAV",
+      "kind": "link",
+      "description": "Tap the in-app wordmark / logo (go home).",
+      "actions": [
+        "tap"
+      ],
+      "values": null,
+      "platforms": [
+        "web"
+      ],
+      "deprecated": null
+    },
+    "nav.hooked_go_to_chat": {
+      "screen": "NAV",
+      "kind": "button",
+      "description": "Hooked (one connection at a time) overlay: go to the conversation.",
+      "actions": [
+        "tap"
+      ],
+      "values": null,
+      "platforms": [
+        "web",
+        "ios"
+      ],
+      "deprecated": null
+    },
+    "nav.hooked_dismiss": {
+      "screen": "NAV",
+      "kind": "button",
+      "description": "Hooked overlay: dismiss / keep browsing.",
+      "actions": [
+        "tap",
+        "dismiss"
+      ],
+      "values": null,
+      "platforms": [
+        "ios"
+      ],
+      "deprecated": null
+    },
+    "landing.get_started": {
+      "screen": "LANDING",
+      "kind": "button",
+      "description": "Get started (start invite redemption / sign-up).",
+      "actions": [
+        "tap"
+      ],
+      "values": null,
+      "platforms": [
+        "web",
+        "ios",
+        "android"
+      ],
+      "deprecated": null
+    },
+    "landing.login": {
+      "screen": "LANDING",
+      "kind": "button",
+      "description": "Go to sign-in.",
+      "actions": [
+        "tap"
+      ],
+      "values": null,
+      "platforms": [
+        "web",
+        "ios",
+        "android"
+      ],
+      "deprecated": null
+    },
+    "landing.policy_link": {
+      "screen": "LANDING",
+      "kind": "link",
+      "description": "Open terms / privacy / cookie policy.",
+      "actions": [
+        "tap"
+      ],
+      "values": null,
+      "platforms": [
+        "web",
+        "ios",
+        "android"
+      ],
+      "deprecated": null
+    },
+    "landing.home_link": {
+      "screen": "LANDING",
+      "kind": "link",
+      "description": "Signed-out site header wordmark / close (back to the landing page).",
+      "actions": [
+        "tap"
+      ],
+      "values": null,
+      "platforms": [
+        "web"
+      ],
+      "deprecated": null
+    },
+    "landing.open_in_app": {
+      "screen": "LANDING",
+      "kind": "link",
+      "description": "Open in app / app-store link.",
+      "actions": [
+        "tap"
+      ],
+      "values": null,
+      "platforms": [
+        "web"
+      ],
+      "deprecated": null
+    },
+    "landing.nav_link": {
+      "screen": "LANDING",
+      "kind": "link",
+      "description": "Marketing navigation link. value = destination.",
+      "actions": [
+        "tap"
+      ],
+      "values": [
+        "philosophy",
+        "how_it_works",
+        "pricing",
+        "contact",
+        "careers",
+        "science"
+      ],
+      "platforms": [
+        "web"
+      ],
+      "deprecated": null
+    },
+    "landing.social_link": {
+      "screen": "LANDING",
+      "kind": "link",
+      "description": "Social channel link. value = network.",
+      "actions": [
+        "tap"
+      ],
+      "values": [
+        "instagram",
+        "facebook",
+        "x",
+        "youtube",
+        "linkedin",
+        "tiktok",
+        "threads",
+        "other"
+      ],
+      "platforms": [
+        "web",
+        "ios"
+      ],
+      "deprecated": null
+    },
+    "landing.mobile_menu_toggle": {
+      "screen": "LANDING",
+      "kind": "toggle",
+      "description": "Open/close the marketing mobile nav. value = new state.",
+      "actions": [
+        "toggle"
+      ],
+      "values": [
+        "open",
+        "closed"
+      ],
+      "platforms": [
+        "web"
+      ],
+      "deprecated": null
+    },
+    "landing.section_nav": {
+      "screen": "LANDING",
+      "kind": "link",
+      "description": "Jump to an in-page landing section. value = section.",
+      "actions": [
+        "tap"
+      ],
+      "values": [
+        "philosophy",
+        "features",
+        "under_the_hood",
+        "get_app"
+      ],
+      "platforms": [
+        "web"
+      ],
+      "deprecated": null
+    },
+    "landing.email_link": {
+      "screen": "LANDING",
+      "kind": "link",
+      "description": "Mailto link on a public page. value = mailbox.",
+      "actions": [
+        "tap"
+      ],
+      "values": [
+        "privacy",
+        "security",
+        "support",
+        "legal",
+        "careers",
+        "other"
+      ],
+      "platforms": [
+        "web"
+      ],
+      "deprecated": null
+    },
+    "landing.pricing_period_select": {
+      "screen": "LANDING",
+      "kind": "segmented",
+      "description": "Public pricing page: choose billing period.",
+      "actions": [
+        "select",
+        "tap"
+      ],
+      "values": null,
+      "platforms": [
+        "web"
+      ],
+      "deprecated": null
+    },
+    "landing.careers_apply": {
+      "screen": "LANDING",
+      "kind": "button",
+      "description": "Careers: apply (optionally for a role; targetId = role id).",
+      "actions": [
+        "tap"
+      ],
+      "values": null,
+      "platforms": [
+        "web"
+      ],
+      "deprecated": null
+    },
+    "landing.demo_interact": {
+      "screen": "LANDING",
+      "kind": "button",
+      "description": "Interact with a public-page demo / explainer. value = demo control.",
+      "actions": [
+        "tap"
+      ],
+      "values": [
+        "opener_shuffle",
+        "relationship_mode",
+        "how_it_works_prev",
+        "how_it_works_next",
+        "how_it_works_step",
+        "mascot_video",
+        "mascot",
+        "science_chapter",
+        "science_signal_kind",
+        "science_signal_send",
+        "science_tab",
+        "science_swipe",
+        "science_erasure"
+      ],
+      "platforms": [
+        "web"
+      ],
+      "deprecated": null
+    },
+    "landing.chatbot_widget": {
+      "screen": "LANDING",
+      "kind": "button",
+      "description": "Public chatbot widget. value = control.",
+      "actions": [
+        "tap"
+      ],
+      "values": [
+        "open",
+        "close",
+        "fullscreen",
+        "start",
+        "send"
+      ],
+      "platforms": [
+        "web"
+      ],
+      "deprecated": null
+    },
+    "landing.notice_retry": {
+      "screen": "LANDING",
+      "kind": "button",
+      "description": "\"Finish in app\" notice: retry.",
+      "actions": [
+        "tap"
+      ],
+      "values": null,
+      "platforms": [
+        "web"
+      ],
+      "deprecated": null
+    },
+    "login.submit": {
+      "screen": "LOGIN",
+      "kind": "button",
+      "description": "Primary action. value = step performed.",
+      "actions": [
+        "submit"
+      ],
+      "values": [
+        "request_otp",
+        "verify_otp",
+        "password",
+        "reset_password"
+      ],
+      "platforms": [
+        "web",
+        "ios",
+        "android"
+      ],
+      "deprecated": null
+    },
+    "login.google": {
+      "screen": "LOGIN",
+      "kind": "button",
+      "description": "Continue with Google.",
+      "actions": [
+        "tap"
+      ],
+      "values": null,
+      "platforms": [
+        "web",
+        "ios",
+        "android"
+      ],
+      "deprecated": null
+    },
+    "login.apple": {
+      "screen": "LOGIN",
+      "kind": "button",
+      "description": "Continue with Apple.",
+      "actions": [
+        "tap"
+      ],
+      "values": null,
+      "platforms": [
+        "web",
+        "ios"
+      ],
+      "deprecated": null
+    },
+    "login.passkey": {
+      "screen": "LOGIN",
+      "kind": "button",
+      "description": "Sign in with a passkey.",
+      "actions": [
+        "tap"
+      ],
+      "values": null,
+      "platforms": [
+        "ios"
+      ],
+      "deprecated": null
+    },
+    "login.identifier_mode": {
+      "screen": "LOGIN",
+      "kind": "toggle",
+      "description": "Switch phone/email identifier. value = new mode.",
+      "actions": [
+        "toggle"
+      ],
+      "values": [
+        "phone",
+        "email"
+      ],
+      "platforms": [
+        "web",
+        "ios",
+        "android"
+      ],
+      "deprecated": null
+    },
+    "login.password_mode": {
+      "screen": "LOGIN",
+      "kind": "toggle",
+      "description": "Switch password/OTP. value = new mode.",
+      "actions": [
+        "toggle"
+      ],
+      "values": [
+        "password",
+        "otp"
+      ],
+      "platforms": [
+        "web",
+        "ios",
+        "android"
+      ],
+      "deprecated": null
+    },
+    "login.forgot_password": {
+      "screen": "LOGIN",
+      "kind": "link",
+      "description": "Forgot password.",
+      "actions": [
+        "tap"
+      ],
+      "values": null,
+      "platforms": [
+        "web",
+        "ios",
+        "android"
+      ],
+      "deprecated": null
+    },
+    "login.resend_code": {
+      "screen": "LOGIN",
+      "kind": "link",
+      "description": "Resend the one-time code.",
+      "actions": [
+        "tap"
+      ],
+      "values": null,
+      "platforms": [
+        "web",
+        "ios"
+      ],
+      "deprecated": null
+    },
+    "login.redeem_invite": {
+      "screen": "LOGIN",
+      "kind": "link",
+      "description": "I have an invite (go to redemption).",
+      "actions": [
+        "tap"
+      ],
+      "values": null,
+      "platforms": [
+        "web",
+        "ios"
+      ],
+      "deprecated": null
+    },
+    "login.close": {
+      "screen": "LOGIN",
+      "kind": "button",
+      "description": "Close / back out of sign-in.",
+      "actions": [
+        "tap"
+      ],
+      "values": null,
+      "platforms": [
+        "web",
+        "ios",
+        "android"
+      ],
+      "deprecated": null
+    },
+    "login.passkey_setup": {
+      "screen": "LOGIN",
+      "kind": "button",
+      "description": "Post-sign-in account setup step. value = step action.",
+      "actions": [
+        "tap"
+      ],
+      "values": [
+        "email_submit",
+        "code_submit",
+        "change_email",
+        "skip_to_passkey",
+        "passkey_create",
+        "skip_to_app"
+      ],
+      "platforms": [
+        "web"
+      ],
+      "deprecated": null
+    },
+    "redeem_invite.submit": {
+      "screen": "REDEEM_INVITE",
+      "kind": "button",
+      "description": "Primary step action. value = step performed.",
+      "actions": [
+        "submit"
+      ],
+      "values": [
+        "validate_invite",
+        "send_otp",
+        "create_account",
+        "verify_sign_in_otp"
+      ],
+      "platforms": [
+        "web",
+        "ios",
+        "android"
+      ],
+      "deprecated": null
+    },
+    "redeem_invite.back": {
+      "screen": "REDEEM_INVITE",
+      "kind": "button",
+      "description": "Previous step.",
+      "actions": [
+        "tap"
+      ],
+      "values": null,
+      "platforms": [
+        "web",
+        "android"
+      ],
+      "deprecated": null
+    },
+    "redeem_invite.login": {
+      "screen": "REDEEM_INVITE",
+      "kind": "link",
+      "description": "I already have an account (go to sign-in).",
+      "actions": [
+        "tap"
+      ],
+      "values": null,
+      "platforms": [
+        "web",
+        "ios",
+        "android"
+      ],
+      "deprecated": null
+    },
+    "redeem_invite.close": {
+      "screen": "REDEEM_INVITE",
+      "kind": "button",
+      "description": "Close the redemption flow.",
+      "actions": [
+        "tap"
+      ],
+      "values": null,
+      "platforms": [
+        "ios",
+        "android"
+      ],
+      "deprecated": null
+    },
+    "redeem_invite.resend_code": {
+      "screen": "REDEEM_INVITE",
+      "kind": "link",
+      "description": "Resend the one-time code during redemption.",
+      "actions": [
+        "tap"
+      ],
+      "values": null,
+      "platforms": [
+        "web",
+        "ios"
+      ],
+      "deprecated": null
+    },
+    "onboarding.next": {
+      "screen": "ONBOARDING",
+      "kind": "button",
+      "description": "Advance the wizard. value = step being completed.",
+      "actions": [
+        "submit"
+      ],
+      "values": [
+        "basics",
+        "photos",
+        "media",
+        "prompts",
+        "details"
+      ],
+      "platforms": [
+        "web",
+        "ios"
+      ],
+      "deprecated": null
+    },
+    "onboarding.back": {
+      "screen": "ONBOARDING",
+      "kind": "button",
+      "description": "Previous wizard step.",
+      "actions": [
+        "tap"
+      ],
+      "values": null,
+      "platforms": [
+        "web",
+        "ios"
+      ],
+      "deprecated": null
+    },
+    "onboarding.finish": {
+      "screen": "ONBOARDING",
+      "kind": "button",
+      "description": "Complete onboarding.",
+      "actions": [
+        "submit"
+      ],
+      "values": null,
+      "platforms": [
+        "web",
+        "ios",
+        "android"
+      ],
+      "deprecated": null
+    },
+    "onboarding.skip_sign_out": {
+      "screen": "ONBOARDING",
+      "kind": "button",
+      "description": "Skip onboarding and sign out.",
+      "actions": [
+        "tap"
+      ],
+      "values": null,
+      "platforms": [
+        "web",
+        "ios",
+        "android"
+      ],
+      "deprecated": null
+    },
+    "onboarding.skip_sign_out_confirm": {
+      "screen": "ONBOARDING",
+      "kind": "dialog_button",
+      "description": "Confirm skipping onboarding and signing out.",
+      "actions": [
+        "submit",
+        "dismiss"
+      ],
+      "values": null,
+      "platforms": [
+        "ios",
+        "android"
+      ],
+      "deprecated": null
+    },
+    "onboarding.photo_add": {
+      "screen": "ONBOARDING",
+      "kind": "button",
+      "description": "Add a photo.",
+      "actions": [
+        "tap"
+      ],
+      "values": null,
+      "platforms": [
+        "web",
+        "ios"
+      ],
+      "deprecated": null
+    },
+    "onboarding.photo_remove": {
+      "screen": "ONBOARDING",
+      "kind": "button",
+      "description": "Remove a photo.",
+      "actions": [
+        "tap"
+      ],
+      "values": null,
+      "platforms": [
+        "web",
+        "ios"
+      ],
+      "deprecated": null
+    },
+    "onboarding.photo_remove_confirm": {
+      "screen": "ONBOARDING",
+      "kind": "dialog_button",
+      "description": "Confirm removing a photo.",
+      "actions": [
+        "submit",
+        "dismiss"
+      ],
+      "values": null,
+      "platforms": [
+        "web"
+      ],
+      "deprecated": null
+    },
+    "onboarding.prompt_add": {
+      "screen": "ONBOARDING",
+      "kind": "button",
+      "description": "Add a written prompt.",
+      "actions": [
+        "tap"
+      ],
+      "values": null,
+      "platforms": [
+        "web",
+        "ios"
+      ],
+      "deprecated": null
+    },
+    "onboarding.prompt_remove": {
+      "screen": "ONBOARDING",
+      "kind": "button",
+      "description": "Remove a written prompt.",
+      "actions": [
+        "tap"
+      ],
+      "values": null,
+      "platforms": [
+        "web",
+        "ios"
+      ],
+      "deprecated": null
+    },
+    "onboarding.voice_add": {
+      "screen": "ONBOARDING",
+      "kind": "button",
+      "description": "Record / upload a voice prompt.",
+      "actions": [
+        "tap"
+      ],
+      "values": null,
+      "platforms": [
+        "web",
+        "ios"
+      ],
+      "deprecated": null
+    },
+    "onboarding.voice_remove": {
+      "screen": "ONBOARDING",
+      "kind": "button",
+      "description": "Remove the voice prompt.",
+      "actions": [
+        "tap"
+      ],
+      "values": null,
+      "platforms": [
+        "web",
+        "ios"
+      ],
+      "deprecated": null
+    },
+    "onboarding.choice_select": {
+      "screen": "ONBOARDING",
+      "kind": "segmented",
+      "description": "Pick an option (gender, interests, etc.).",
+      "actions": [
+        "select",
+        "tap"
+      ],
+      "values": null,
+      "platforms": [
+        "web",
+        "ios",
+        "android"
+      ],
+      "deprecated": null
+    },
+    "discover.pass_button": {
+      "screen": "DISCOVER",
+      "kind": "button",
+      "description": "Pass on the current candidate.",
+      "actions": [
+        "tap"
+      ],
+      "values": null,
+      "platforms": [
+        "web",
+        "ios",
+        "android"
+      ],
+      "deprecated": null
+    },
+    "discover.like_button": {
+      "screen": "DISCOVER",
+      "kind": "button",
+      "description": "Like the current candidate (no comment).",
+      "actions": [
+        "tap"
+      ],
+      "values": null,
+      "platforms": [
+        "android"
+      ],
+      "deprecated": null
+    },
+    "discover.rose_button": {
+      "screen": "DISCOVER",
+      "kind": "button",
+      "description": "Send a rose / super-like.",
+      "actions": [
+        "tap"
+      ],
+      "values": null,
+      "platforms": [
+        "web",
+        "ios",
+        "android"
+      ],
+      "deprecated": null
+    },
+    "discover.undo_button": {
+      "screen": "DISCOVER",
+      "kind": "button",
+      "description": "Undo the last decision.",
+      "actions": [
+        "tap"
+      ],
+      "values": null,
+      "platforms": [
+        "ios"
+      ],
+      "deprecated": null
+    },
+    "discover.element_like": {
+      "screen": "DISCOVER",
+      "kind": "button",
+      "description": "Like a specific profile element (opens composer). value = target type.",
+      "actions": [
+        "tap"
+      ],
+      "values": [
+        "PHOTO",
+        "VIDEO",
+        "VOICE",
+        "PROMPT",
+        "INTEREST",
+        "BIO"
+      ],
+      "platforms": [
+        "web",
+        "ios"
+      ],
+      "deprecated": null
+    },
+    "discover.photo_open": {
+      "screen": "DISCOVER",
+      "kind": "gesture",
+      "description": "Open a candidate's photo full screen.",
+      "actions": [
+        "tap"
+      ],
+      "values": null,
+      "platforms": [
+        "web",
+        "ios",
+        "android"
+      ],
+      "deprecated": null
+    },
+    "discover.voice_play": {
+      "screen": "DISCOVER",
+      "kind": "toggle",
+      "description": "Play/pause the voice prompt. value = new state.",
+      "actions": [
+        "toggle"
+      ],
+      "values": [
+        "play",
+        "pause"
+      ],
+      "platforms": [
+        "web",
+        "ios"
+      ],
+      "deprecated": null
+    },
+    "discover.preferences_open": {
+      "screen": "DISCOVER",
+      "kind": "button",
+      "description": "Open discovery preferences.",
+      "actions": [
+        "tap",
+        "dismiss"
+      ],
+      "values": null,
+      "platforms": [
+        "ios"
+      ],
+      "deprecated": null
+    },
+    "discover.likes_you_open": {
+      "screen": "DISCOVER",
+      "kind": "button",
+      "description": "Open Likes You.",
+      "actions": [
+        "tap",
+        "dismiss"
+      ],
+      "values": null,
+      "platforms": [
+        "ios",
+        "android"
+      ],
+      "deprecated": null
+    },
+    "discover.add_hook_open": {
+      "screen": "DISCOVER",
+      "kind": "button",
+      "description": "Add a connection by username / invite.",
+      "actions": [
+        "tap",
+        "dismiss"
+      ],
+      "values": null,
+      "platforms": [
+        "ios"
+      ],
+      "deprecated": null
+    },
+    "discover.retry": {
+      "screen": "DISCOVER",
+      "kind": "button",
+      "description": "Retry loading the deck.",
+      "actions": [
+        "tap"
+      ],
+      "values": null,
+      "platforms": [
+        "web",
+        "ios",
+        "android"
+      ],
+      "deprecated": null
+    },
+    "discover.add_hook_submit": {
+      "screen": "DISCOVER",
+      "kind": "button",
+      "description": "Submit an add-by-username / invite connection request.",
+      "actions": [
+        "submit"
+      ],
+      "values": null,
+      "platforms": [
+        "web",
+        "ios"
+      ],
+      "deprecated": null
+    },
+    "discover.upgrade_open": {
+      "screen": "DISCOVER",
+      "kind": "button",
+      "description": "Upgrade prompt shown in discovery (e.g. undo upsell \"See plans\").",
+      "actions": [
+        "tap",
+        "dismiss"
+      ],
+      "values": null,
+      "platforms": [
+        "ios"
+      ],
+      "deprecated": null
+    },
+    "like_composer.send": {
+      "screen": "LIKE_COMPOSER",
+      "kind": "button",
+      "description": "Send the like with a comment.",
+      "actions": [
+        "submit"
+      ],
+      "values": null,
+      "platforms": [
+        "web",
+        "ios",
+        "android"
+      ],
+      "deprecated": null
+    },
+    "like_composer.send_without_comment": {
+      "screen": "LIKE_COMPOSER",
+      "kind": "button",
+      "description": "Send the like without a comment.",
+      "actions": [
+        "submit"
+      ],
+      "values": null,
+      "platforms": [
+        "ios"
+      ],
+      "deprecated": null
+    },
+    "like_composer.cancel": {
+      "screen": "LIKE_COMPOSER",
+      "kind": "button",
+      "description": "Close the composer without sending.",
+      "actions": [
+        "tap",
+        "dismiss"
+      ],
+      "values": null,
+      "platforms": [
+        "web",
+        "ios",
+        "android"
+      ],
+      "deprecated": null
+    },
+    "like_composer.upgrade": {
+      "screen": "LIKE_COMPOSER",
+      "kind": "button",
+      "description": "Upgrade prompt shown inside the composer.",
+      "actions": [
+        "tap",
+        "dismiss"
+      ],
+      "values": null,
+      "platforms": [
+        "ios"
+      ],
+      "deprecated": null
+    },
+    "likes_you.profile_open": {
+      "screen": "LIKES_YOU",
+      "kind": "list_item",
+      "description": "Open a liker profile. index = row, targetId = liker.",
+      "actions": [
+        "tap"
+      ],
+      "values": null,
+      "platforms": [
+        "web",
+        "ios",
+        "android"
+      ],
+      "deprecated": null
+    },
+    "likes_you.liked_item_open": {
+      "screen": "LIKES_YOU",
+      "kind": "gesture",
+      "description": "Open the element of your profile they liked.",
+      "actions": [
+        "tap"
+      ],
+      "values": null,
+      "platforms": [
+        "web"
+      ],
+      "deprecated": null
+    },
+    "likes_you.refresh": {
+      "screen": "LIKES_YOU",
+      "kind": "button",
+      "description": "Refresh the list.",
+      "actions": [
+        "tap"
+      ],
+      "values": null,
+      "platforms": [
+        "web",
+        "android"
+      ],
+      "deprecated": null
+    },
+    "likes_you.retry": {
+      "screen": "LIKES_YOU",
+      "kind": "button",
+      "description": "Retry after a load error.",
+      "actions": [
+        "tap"
+      ],
+      "values": null,
+      "platforms": [
+        "web",
+        "ios",
+        "android"
+      ],
+      "deprecated": null
+    },
+    "likes_you.close": {
+      "screen": "LIKES_YOU",
+      "kind": "button",
+      "description": "Close / back out of Likes You (when presented modally).",
+      "actions": [
+        "tap",
+        "dismiss"
+      ],
+      "values": null,
+      "platforms": [
+        "ios",
+        "android"
+      ],
+      "deprecated": null
+    },
+    "chat.send_button": {
+      "screen": "CHAT",
+      "kind": "button",
+      "description": "Send a message.",
+      "actions": [
+        "submit"
+      ],
+      "values": null,
+      "platforms": [
+        "web",
+        "ios",
+        "android"
+      ],
+      "deprecated": null
+    },
+    "chat.attach_button": {
+      "screen": "CHAT",
+      "kind": "button",
+      "description": "Open the attachment chooser.",
+      "actions": [
+        "tap",
+        "dismiss"
+      ],
+      "values": null,
+      "platforms": [
+        "web",
+        "ios",
+        "android"
+      ],
+      "deprecated": null
+    },
+    "chat.attach_option": {
+      "screen": "CHAT",
+      "kind": "menu_item",
+      "description": "Pick an attachment source. value = source.",
+      "actions": [
+        "tap"
+      ],
+      "values": [
+        "photo_video",
+        "camera",
+        "file",
+        "voice"
+      ],
+      "platforms": [
+        "web",
+        "ios",
+        "android"
+      ],
+      "deprecated": null
+    },
+    "chat.capture_option": {
+      "screen": "CHAT",
+      "kind": "menu_item",
+      "description": "Camera capture kind. value = kind.",
+      "actions": [
+        "tap"
+      ],
+      "values": [
+        "photo",
+        "video"
+      ],
+      "platforms": [
+        "android"
+      ],
+      "deprecated": null
+    },
+    "chat.voice_record_start": {
+      "screen": "CHAT",
+      "kind": "button",
+      "description": "Start recording a voice note.",
+      "actions": [
+        "tap",
+        "long_press"
+      ],
+      "values": null,
+      "platforms": [
+        "web",
+        "ios",
+        "android"
+      ],
+      "deprecated": null
+    },
+    "chat.voice_record_stop": {
+      "screen": "CHAT",
+      "kind": "button",
+      "description": "Stop recording.",
+      "actions": [
+        "tap"
+      ],
+      "values": null,
+      "platforms": [
+        "ios",
+        "android"
+      ],
+      "deprecated": null
+    },
+    "chat.voice_record_cancel": {
+      "screen": "CHAT",
+      "kind": "button",
+      "description": "Discard the recording.",
+      "actions": [
+        "tap"
+      ],
+      "values": null,
+      "platforms": [
+        "web",
+        "ios",
+        "android"
+      ],
+      "deprecated": null
+    },
+    "chat.voice_send": {
+      "screen": "CHAT",
+      "kind": "button",
+      "description": "Send the recorded voice note.",
+      "actions": [
+        "submit"
+      ],
+      "values": null,
+      "platforms": [
+        "web",
+        "ios"
+      ],
+      "deprecated": null
+    },
+    "chat.conversation_switch": {
+      "screen": "CHAT",
+      "kind": "list_item",
+      "description": "Switch to another conversation. index = position.",
+      "actions": [
+        "tap"
+      ],
+      "values": null,
+      "platforms": [
+        "web",
+        "ios",
+        "android"
+      ],
+      "deprecated": null
+    },
+    "chat.conversation_sort": {
+      "screen": "CHAT",
+      "kind": "menu_item",
+      "description": "Change conversation ordering.",
+      "actions": [
+        "tap"
+      ],
+      "values": null,
+      "platforms": [
+        "web",
+        "ios"
+      ],
+      "deprecated": null
+    },
+    "chat.conversation_sort_open": {
+      "screen": "CHAT",
+      "kind": "button",
+      "description": "Open the conversation-ordering menu.",
+      "actions": [
+        "tap",
+        "dismiss"
+      ],
+      "values": null,
+      "platforms": [
+        "web",
+        "ios"
+      ],
+      "deprecated": null
+    },
+    "chat.conversation_switcher_open": {
+      "screen": "CHAT",
+      "kind": "button",
+      "description": "Open the conversation switcher / picker.",
+      "actions": [
+        "tap",
+        "dismiss"
+      ],
+      "values": null,
+      "platforms": [
+        "web",
+        "ios"
+      ],
+      "deprecated": null
+    },
+    "chat.profile_open": {
+      "screen": "CHAT",
+      "kind": "button",
+      "description": "Open the peer's profile (avatar / name).",
+      "actions": [
+        "tap",
+        "dismiss"
+      ],
+      "values": null,
+      "platforms": [
+        "web",
+        "ios",
+        "android"
+      ],
+      "deprecated": null
+    },
+    "chat.safety_menu_open": {
+      "screen": "CHAT",
+      "kind": "button",
+      "description": "Open the safety / options menu.",
+      "actions": [
+        "tap",
+        "dismiss"
+      ],
+      "values": null,
+      "platforms": [
+        "web",
+        "ios",
+        "android"
+      ],
+      "deprecated": null
+    },
+    "chat.unmatch": {
+      "screen": "CHAT",
+      "kind": "menu_item",
+      "description": "Unmatch (opens confirmation).",
+      "actions": [
+        "tap"
+      ],
+      "values": null,
+      "platforms": [
+        "ios",
+        "android"
+      ],
+      "deprecated": null
+    },
+    "chat.report_spam": {
+      "screen": "CHAT",
+      "kind": "menu_item",
+      "description": "Report as spam.",
+      "actions": [
+        "tap"
+      ],
+      "values": null,
+      "platforms": [
+        "web",
+        "ios",
+        "android"
+      ],
+      "deprecated": null
+    },
+    "chat.report_block": {
+      "screen": "CHAT",
+      "kind": "menu_item",
+      "description": "Report and block.",
+      "actions": [
+        "tap"
+      ],
+      "values": null,
+      "platforms": [
+        "web",
+        "ios",
+        "android"
+      ],
+      "deprecated": null
+    },
+    "chat.block_confirm": {
+      "screen": "CHAT",
+      "kind": "dialog_button",
+      "description": "Confirm block.",
+      "actions": [
+        "tap",
+        "dismiss"
+      ],
+      "values": null,
+      "platforms": [
+        "web",
+        "ios",
+        "android"
+      ],
+      "deprecated": null
+    },
+    "chat.settings_open": {
+      "screen": "CHAT",
+      "kind": "button",
+      "description": "Open chat settings.",
+      "actions": [
+        "tap",
+        "dismiss"
+      ],
+      "values": null,
+      "platforms": [
+        "web",
+        "ios"
+      ],
+      "deprecated": null
+    },
+    "chat.wallpaper_open": {
+      "screen": "CHAT",
+      "kind": "menu_item",
+      "description": "Change chat wallpaper.",
+      "actions": [
+        "tap",
+        "dismiss"
+      ],
+      "values": null,
+      "platforms": [
+        "web"
+      ],
+      "deprecated": null
+    },
+    "chat.add_hook_open": {
+      "screen": "CHAT",
+      "kind": "button",
+      "description": "Add another connection.",
+      "actions": [
+        "tap",
+        "dismiss"
+      ],
+      "values": null,
+      "platforms": [
+        "web",
+        "ios"
+      ],
+      "deprecated": null
+    },
+    "chat.privacy_toggle": {
+      "screen": "CHAT",
+      "kind": "toggle",
+      "description": "Hide/reveal the conversation (eye). value = new state.",
+      "actions": [
+        "toggle"
+      ],
+      "values": [
+        "hidden",
+        "visible"
+      ],
+      "platforms": [],
+      "deprecated": "Never shipped on any platform (per-conversation hide was not built); kept so the id is never reused."
+    },
+    "chat.call": {
+      "screen": "CHAT",
+      "kind": "button",
+      "description": "Start a voice call.",
+      "actions": [
+        "tap"
+      ],
+      "values": null,
+      "platforms": [
+        "ios"
+      ],
+      "deprecated": null
+    },
+    "chat.video_call": {
+      "screen": "CHAT",
+      "kind": "button",
+      "description": "Start a video call.",
+      "actions": [
+        "tap"
+      ],
+      "values": null,
+      "platforms": [
+        "ios"
+      ],
+      "deprecated": null
+    },
+    "chat.media_open": {
+      "screen": "CHAT",
+      "kind": "gesture",
+      "description": "Reveal / open an image or video attachment.",
+      "actions": [
+        "tap"
+      ],
+      "values": null,
+      "platforms": [
+        "web",
+        "ios",
+        "android"
+      ],
+      "deprecated": null
+    },
+    "chat.audio_play": {
+      "screen": "CHAT",
+      "kind": "toggle",
+      "description": "Play/pause a voice note. value = new state.",
+      "actions": [
+        "toggle"
+      ],
+      "values": [
+        "play",
+        "pause"
+      ],
+      "platforms": [
+        "web",
+        "ios",
+        "android"
+      ],
+      "deprecated": null
+    },
+    "chat.file_open": {
+      "screen": "CHAT",
+      "kind": "list_item",
+      "description": "Open a file attachment.",
+      "actions": [
+        "tap"
+      ],
+      "values": null,
+      "platforms": [
+        "web",
+        "ios",
+        "android"
+      ],
+      "deprecated": null
+    },
+    "chat.message_delete": {
+      "screen": "CHAT",
+      "kind": "dialog_button",
+      "description": "Delete a message.",
+      "actions": [
+        "tap",
+        "dismiss"
+      ],
+      "values": null,
+      "platforms": [
+        "ios",
+        "android"
+      ],
+      "deprecated": null
+    },
+    "chat.message_menu_open": {
+      "screen": "CHAT",
+      "kind": "gesture",
+      "description": "Open the per-message actions (long-press).",
+      "actions": [
+        "long_press",
+        "dismiss"
+      ],
+      "values": null,
+      "platforms": [
+        "ios",
+        "android"
+      ],
+      "deprecated": null
+    },
+    "chat.report_reason_select": {
+      "screen": "CHAT",
+      "kind": "menu_item",
+      "description": "Pick a report reason.",
+      "actions": [
+        "tap"
+      ],
+      "values": null,
+      "platforms": [
+        "web",
+        "ios",
+        "android"
+      ],
+      "deprecated": null
+    },
+    "chat.sensitive_reveal_confirm": {
+      "screen": "CHAT",
+      "kind": "dialog_button",
+      "description": "Confirm revealing sensitive media.",
+      "actions": [
+        "submit",
+        "dismiss"
+      ],
+      "values": null,
+      "platforms": [
+        "web",
+        "ios"
+      ],
+      "deprecated": null
+    },
+    "chat.attachment_retry": {
+      "screen": "CHAT",
+      "kind": "button",
+      "description": "Retry an attachment transfer. value = direction.",
+      "actions": [
+        "tap"
+      ],
+      "values": [
+        "upload",
+        "download"
+      ],
+      "platforms": [
+        "web",
+        "ios",
+        "android"
+      ],
+      "deprecated": null
+    },
+    "chat.history_recover": {
+      "screen": "CHAT",
+      "kind": "button",
+      "description": "Recover earlier message history.",
+      "actions": [
+        "tap",
+        "dismiss"
+      ],
+      "values": null,
+      "platforms": [
+        "web",
+        "ios",
+        "android"
+      ],
+      "deprecated": null
+    },
+    "chat.mr_onehook_open": {
+      "screen": "CHAT",
+      "kind": "button",
+      "description": "Open Mr OneHook (AI).",
+      "actions": [
+        "tap"
+      ],
+      "values": null,
+      "platforms": [
+        "web",
+        "android"
+      ],
+      "deprecated": null
+    },
+    "chat.mr_onehook_close": {
+      "screen": "CHAT",
+      "kind": "button",
+      "description": "Leave Mr OneHook.",
+      "actions": [
+        "tap"
+      ],
+      "values": null,
+      "platforms": [
+        "android"
+      ],
+      "deprecated": null
+    },
+    "chat.retry": {
+      "screen": "CHAT",
+      "kind": "button",
+      "description": "Retry loading chat.",
+      "actions": [
+        "tap"
+      ],
+      "values": null,
+      "platforms": [
+        "web",
+        "android"
+      ],
+      "deprecated": null
+    },
+    "chat.unmatch_confirm": {
+      "screen": "CHAT",
+      "kind": "dialog_button",
+      "description": "Confirm unmatch / unhook from the confirmation dialog.",
+      "actions": [
+        "submit",
+        "dismiss"
+      ],
+      "values": null,
+      "platforms": [
+        "ios",
+        "android"
+      ],
+      "deprecated": null
+    },
+    "chat.profile_close": {
+      "screen": "CHAT",
+      "kind": "button",
+      "description": "Close the peer's profile sheet / panel.",
+      "actions": [
+        "tap",
+        "dismiss"
+      ],
+      "values": null,
+      "platforms": [
+        "ios",
+        "android"
+      ],
+      "deprecated": null
+    },
+    "chat.mr_onehook_context_share": {
+      "screen": "CHAT",
+      "kind": "dialog_button",
+      "description": "Confirm sharing local conversation excerpts with Mr OneHook.",
+      "actions": [
+        "submit",
+        "dismiss"
+      ],
+      "values": null,
+      "platforms": [
+        "web",
+        "ios",
+        "android"
+      ],
+      "deprecated": null
+    },
+    "chat.mr_onehook_scope_open": {
+      "screen": "CHAT",
+      "kind": "button",
+      "description": "Open the Mr OneHook scope picker.",
+      "actions": [
+        "tap",
+        "dismiss"
+      ],
+      "values": null,
+      "platforms": [
+        "web"
+      ],
+      "deprecated": null
+    },
+    "chat.mr_onehook_scope_select": {
+      "screen": "CHAT",
+      "kind": "menu_item",
+      "description": "Choose what Mr OneHook may use (product only / a match).",
+      "actions": [
+        "tap"
+      ],
+      "values": null,
+      "platforms": [
+        "web"
+      ],
+      "deprecated": null
+    },
+    "chat.intro_tour_open": {
+      "screen": "CHAT",
+      "kind": "button",
+      "description": "Start the chat intro tour from the in-chat invitation.",
+      "actions": [
+        "tap"
+      ],
+      "values": null,
+      "platforms": [
+        "ios"
+      ],
+      "deprecated": null
+    },
+    "chat.intro_dismiss": {
+      "screen": "CHAT",
+      "kind": "button",
+      "description": "Dismiss the chat intro invitation / stories.",
+      "actions": [
+        "tap",
+        "dismiss"
+      ],
+      "values": null,
+      "platforms": [
+        "ios"
+      ],
+      "deprecated": null
+    },
+    "chat.intro_get_started": {
+      "screen": "CHAT",
+      "kind": "button",
+      "description": "Final chat-intro CTA (go to Discover).",
+      "actions": [
+        "tap"
+      ],
+      "values": null,
+      "platforms": [
+        "ios"
+      ],
+      "deprecated": null
+    },
+    "chat.history_recover_method": {
+      "screen": "CHAT",
+      "kind": "menu_item",
+      "description": "Pick how to recover message history. value = method.",
+      "actions": [
+        "tap",
+        "dismiss"
+      ],
+      "values": [
+        "device",
+        "qr_scan",
+        "qr_import",
+        "passkey"
+      ],
+      "platforms": [
+        "web",
+        "ios",
+        "android"
+      ],
+      "deprecated": null
+    },
+    "chat.history_recover_step": {
+      "screen": "CHAT",
+      "kind": "menu_item",
+      "description": "Step inside the history-recovery flow. value = step.",
+      "actions": [
+        "tap"
+      ],
+      "values": [
+        "retry",
+        "qr_retry",
+        "done",
+        "reset_open",
+        "cancel"
+      ],
+      "platforms": [
+        "web",
+        "ios",
+        "android"
+      ],
+      "deprecated": null
+    },
+    "chat.history_reset_confirm": {
+      "screen": "CHAT",
+      "kind": "dialog_button",
+      "description": "Confirm the last-resort history reset.",
+      "actions": [
+        "submit",
+        "dismiss"
+      ],
+      "values": null,
+      "platforms": [
+        "web"
+      ],
+      "deprecated": null
+    },
+    "chat_settings.last_seen_select": {
+      "screen": "CHAT_SETTINGS",
+      "kind": "segmented",
+      "description": "Choose last-seen visibility.",
+      "actions": [
+        "select",
+        "tap"
+      ],
+      "values": null,
+      "platforms": [
+        "web",
+        "ios"
+      ],
+      "deprecated": null
+    },
+    "chat_settings.disappearing_select": {
+      "screen": "CHAT_SETTINGS",
+      "kind": "segmented",
+      "description": "Choose disappearing-message timer.",
+      "actions": [
+        "select",
+        "tap"
+      ],
+      "values": null,
+      "platforms": [
+        "web",
+        "ios"
+      ],
+      "deprecated": null
+    },
+    "chat_settings.notification_toggle": {
+      "screen": "CHAT_SETTINGS",
+      "kind": "toggle",
+      "description": "Toggle a notification setting. value = new state, targetId = setting key.",
+      "actions": [
+        "toggle"
+      ],
+      "values": [
+        "on",
+        "off"
+      ],
+      "platforms": [
+        "web",
+        "ios"
+      ],
+      "deprecated": null
+    },
+    "chat_settings.privacy_toggle": {
+      "screen": "CHAT_SETTINGS",
+      "kind": "toggle",
+      "description": "Toggle a privacy setting (read receipts, typing, ...). value = new state, targetId = setting key.",
+      "actions": [
+        "toggle"
+      ],
+      "values": [
+        "on",
+        "off"
+      ],
+      "platforms": [
+        "web",
+        "ios"
+      ],
+      "deprecated": null
+    },
+    "chat_settings.font_size_select": {
+      "screen": "CHAT_SETTINGS",
+      "kind": "segmented",
+      "description": "Choose chat font size.",
+      "actions": [
+        "select",
+        "tap"
+      ],
+      "values": null,
+      "platforms": [
+        "ios"
+      ],
+      "deprecated": null
+    },
+    "chat_settings.wallpaper_select": {
+      "screen": "CHAT_SETTINGS",
+      "kind": "segmented",
+      "description": "Choose a chat wallpaper.",
+      "actions": [
+        "select",
+        "tap"
+      ],
+      "values": null,
+      "platforms": [
+        "web",
+        "ios"
+      ],
+      "deprecated": null
+    },
+    "chat_settings.export_chat": {
+      "screen": "CHAT_SETTINGS",
+      "kind": "button",
+      "description": "Export a transcript. tap = open export; select = conversation chosen (targetId = match).",
+      "actions": [
+        "tap",
+        "select",
+        "dismiss"
+      ],
+      "values": null,
+      "platforms": [
+        "ios"
+      ],
+      "deprecated": null
+    },
+    "chat_settings.clear_cache": {
+      "screen": "CHAT_SETTINGS",
+      "kind": "button",
+      "description": "Clear device-local chat media cache.",
+      "actions": [
+        "tap"
+      ],
+      "values": null,
+      "platforms": [
+        "ios"
+      ],
+      "deprecated": null
+    },
+    "notifications.item_open": {
+      "screen": "NOTIFICATIONS",
+      "kind": "list_item",
+      "description": "Open a notification.",
+      "actions": [
+        "tap"
+      ],
+      "values": null,
+      "platforms": [
+        "ios"
+      ],
+      "deprecated": null
+    },
+    "notifications.item_dismiss": {
+      "screen": "NOTIFICATIONS",
+      "kind": "gesture",
+      "description": "Dismiss a notification.",
+      "actions": [
+        "dismiss"
+      ],
+      "values": null,
+      "platforms": [
+        "ios"
+      ],
+      "deprecated": null
+    },
+    "profile.edit_open": {
+      "screen": "PROFILE",
+      "kind": "button",
+      "description": "Open the profile editor.",
+      "actions": [
+        "tap",
+        "dismiss"
+      ],
+      "values": null,
+      "platforms": [
+        "ios",
+        "android"
+      ],
+      "deprecated": null
+    },
+    "profile.preview_open": {
+      "screen": "PROFILE",
+      "kind": "button",
+      "description": "Preview own profile.",
+      "actions": [
+        "tap",
+        "dismiss"
+      ],
+      "values": null,
+      "platforms": [
+        "web",
+        "ios"
+      ],
+      "deprecated": null
+    },
+    "profile.preferences_open": {
+      "screen": "PROFILE",
+      "kind": "button",
+      "description": "Open matching preferences.",
+      "actions": [
+        "tap"
+      ],
+      "values": null,
+      "platforms": [
+        "ios",
+        "android"
+      ],
+      "deprecated": null
+    },
+    "profile.settings_open": {
+      "screen": "PROFILE",
+      "kind": "button",
+      "description": "Open account settings.",
+      "actions": [
+        "tap"
+      ],
+      "values": null,
+      "platforms": [
+        "web"
+      ],
+      "deprecated": null
+    },
+    "profile.chat_settings_open": {
+      "screen": "PROFILE",
+      "kind": "button",
+      "description": "Open chat settings.",
+      "actions": [
+        "tap",
+        "dismiss"
+      ],
+      "values": null,
+      "platforms": [
+        "ios"
+      ],
+      "deprecated": null
+    },
+    "profile.chat_tour_open": {
+      "screen": "PROFILE",
+      "kind": "button",
+      "description": "Replay the chat intro tour.",
+      "actions": [
+        "tap"
+      ],
+      "values": null,
+      "platforms": [
+        "ios"
+      ],
+      "deprecated": null
+    },
+    "profile.photo_open": {
+      "screen": "PROFILE",
+      "kind": "gesture",
+      "description": "Open own photo full screen (with stats).",
+      "actions": [
+        "tap"
+      ],
+      "values": null,
+      "platforms": [
+        "web",
+        "ios",
+        "android"
+      ],
+      "deprecated": null
+    },
+    "profile.verify_identity": {
+      "screen": "PROFILE",
+      "kind": "button",
+      "description": "Start identity verification.",
+      "actions": [
+        "tap"
+      ],
+      "values": null,
+      "platforms": [
+        "ios",
+        "android"
+      ],
+      "deprecated": null
+    },
+    "profile.share_invite": {
+      "screen": "PROFILE",
+      "kind": "button",
+      "description": "Generate / share an invite.",
+      "actions": [
+        "tap",
+        "dismiss"
+      ],
+      "values": null,
+      "platforms": [
+        "ios",
+        "android"
+      ],
+      "deprecated": null
+    },
+    "profile.invite_code_copy": {
+      "screen": "PROFILE",
+      "kind": "button",
+      "description": "Copy a generated invite code.",
+      "actions": [
+        "tap"
+      ],
+      "values": null,
+      "platforms": [
+        "ios"
+      ],
+      "deprecated": null
+    },
+    "profile.invite_code_share": {
+      "screen": "PROFILE",
+      "kind": "button",
+      "description": "Share a generated invite code (system share sheet).",
+      "actions": [
+        "tap"
+      ],
+      "values": null,
+      "platforms": [
+        "ios"
+      ],
+      "deprecated": null
+    },
+    "profile.upgrade_open": {
+      "screen": "PROFILE",
+      "kind": "button",
+      "description": "Open membership upgrade.",
+      "actions": [
+        "tap",
+        "dismiss"
+      ],
+      "values": null,
+      "platforms": [
+        "web",
+        "ios",
+        "android"
+      ],
+      "deprecated": null
+    },
+    "profile.unhook": {
+      "screen": "PROFILE",
+      "kind": "button",
+      "description": "Release the current connection (opens confirmation).",
+      "actions": [
+        "tap"
+      ],
+      "values": null,
+      "platforms": [
+        "android"
+      ],
+      "deprecated": null
+    },
+    "profile.unhook_confirm": {
+      "screen": "PROFILE",
+      "kind": "dialog_button",
+      "description": "Confirm releasing the connection.",
+      "actions": [
+        "tap",
+        "dismiss"
+      ],
+      "values": null,
+      "platforms": [
+        "android"
+      ],
+      "deprecated": null
+    },
+    "profile.tab_select": {
+      "screen": "PROFILE",
+      "kind": "segmented",
+      "description": "Switch profile sub-section.",
+      "actions": [
+        "select",
+        "tap"
+      ],
+      "values": null,
+      "platforms": [
+        "ios"
+      ],
+      "deprecated": null
+    },
+    "profile.retry": {
+      "screen": "PROFILE",
+      "kind": "button",
+      "description": "Retry loading the profile.",
+      "actions": [
+        "tap"
+      ],
+      "values": null,
+      "platforms": [
+        "web",
+        "ios",
+        "android"
+      ],
+      "deprecated": null
+    },
+    "profile.voice_play": {
+      "screen": "PROFILE",
+      "kind": "toggle",
+      "description": "Play/pause own voice prompt. value = new state.",
+      "actions": [
+        "toggle"
+      ],
+      "values": [
+        "play",
+        "pause"
+      ],
+      "platforms": [
+        "web"
+      ],
+      "deprecated": null
+    },
+    "profile_edit.save": {
+      "screen": "PROFILE_EDIT",
+      "kind": "button",
+      "description": "Save profile changes.",
+      "actions": [
+        "submit"
+      ],
+      "values": null,
+      "platforms": [
+        "web",
+        "ios",
+        "android"
+      ],
+      "deprecated": null
+    },
+    "profile_edit.preview": {
+      "screen": "PROFILE_EDIT",
+      "kind": "button",
+      "description": "Preview while editing.",
+      "actions": [
+        "tap"
+      ],
+      "values": null,
+      "platforms": [
+        "ios"
+      ],
+      "deprecated": null
+    },
+    "profile_edit.photo_add": {
+      "screen": "PROFILE_EDIT",
+      "kind": "button",
+      "description": "Add a photo / video.",
+      "actions": [
+        "tap"
+      ],
+      "values": null,
+      "platforms": [
+        "web",
+        "ios",
+        "android"
+      ],
+      "deprecated": null
+    },
+    "profile_edit.photo_remove": {
+      "screen": "PROFILE_EDIT",
+      "kind": "button",
+      "description": "Remove a photo.",
+      "actions": [
+        "tap"
+      ],
+      "values": null,
+      "platforms": [
+        "web",
+        "ios"
+      ],
+      "deprecated": null
+    },
+    "profile_edit.photo_remove_confirm": {
+      "screen": "PROFILE_EDIT",
+      "kind": "dialog_button",
+      "description": "Confirm removing a photo.",
+      "actions": [
+        "submit",
+        "dismiss"
+      ],
+      "values": null,
+      "platforms": [
+        "ios"
+      ],
+      "deprecated": null
+    },
+    "profile_edit.photo_set_primary": {
+      "screen": "PROFILE_EDIT",
+      "kind": "button",
+      "description": "Make a photo primary.",
+      "actions": [
+        "tap"
+      ],
+      "values": null,
+      "platforms": [
+        "web",
+        "ios"
+      ],
+      "deprecated": null
+    },
+    "profile_edit.photo_adjust": {
+      "screen": "PROFILE_EDIT",
+      "kind": "button",
+      "description": "Adjust / crop a photo.",
+      "actions": [
+        "tap"
+      ],
+      "values": null,
+      "platforms": [
+        "ios"
+      ],
+      "deprecated": null
+    },
+    "profile_edit.photo_reorder": {
+      "screen": "PROFILE_EDIT",
+      "kind": "gesture",
+      "description": "Reorder photos.",
+      "actions": [
+        "long_press"
+      ],
+      "values": null,
+      "platforms": [
+        "ios"
+      ],
+      "deprecated": null
+    },
+    "profile_edit.prompt_add": {
+      "screen": "PROFILE_EDIT",
+      "kind": "button",
+      "description": "Add a prompt.",
+      "actions": [
+        "tap"
+      ],
+      "values": null,
+      "platforms": [
+        "web",
+        "ios"
+      ],
+      "deprecated": null
+    },
+    "profile_edit.prompt_remove": {
+      "screen": "PROFILE_EDIT",
+      "kind": "button",
+      "description": "Remove a prompt.",
+      "actions": [
+        "tap"
+      ],
+      "values": null,
+      "platforms": [
+        "web",
+        "ios"
+      ],
+      "deprecated": null
+    },
+    "profile_edit.voice_add": {
+      "screen": "PROFILE_EDIT",
+      "kind": "button",
+      "description": "Record / add a voice prompt.",
+      "actions": [
+        "tap"
+      ],
+      "values": null,
+      "platforms": [
+        "web",
+        "ios"
+      ],
+      "deprecated": null
+    },
+    "profile_edit.voice_remove": {
+      "screen": "PROFILE_EDIT",
+      "kind": "button",
+      "description": "Remove the voice prompt.",
+      "actions": [
+        "tap"
+      ],
+      "values": null,
+      "platforms": [
+        "web",
+        "ios"
+      ],
+      "deprecated": null
+    },
+    "profile_edit.choice_select": {
+      "screen": "PROFILE_EDIT",
+      "kind": "segmented",
+      "description": "Pick an option while editing (gender, interested in, interests, ...).",
+      "actions": [
+        "select",
+        "tap"
+      ],
+      "values": null,
+      "platforms": [
+        "web",
+        "ios"
+      ],
+      "deprecated": null
+    },
+    "preferences.save": {
+      "screen": "PREFERENCES",
+      "kind": "button",
+      "description": "Save matching preferences.",
+      "actions": [
+        "submit"
+      ],
+      "values": null,
+      "platforms": [
+        "ios",
+        "android"
+      ],
+      "deprecated": null
+    },
+    "preferences.upgrade_open": {
+      "screen": "PREFERENCES",
+      "kind": "button",
+      "description": "Upgrade prompt for a locked (premium) filter.",
+      "actions": [
+        "tap",
+        "dismiss"
+      ],
+      "values": null,
+      "platforms": [
+        "ios"
+      ],
+      "deprecated": null
+    },
+    "preferences.locked_filter_tap": {
+      "screen": "PREFERENCES",
+      "kind": "button",
+      "description": "Tap a locked (premium) filter.",
+      "actions": [
+        "tap"
+      ],
+      "values": null,
+      "platforms": [
+        "ios"
+      ],
+      "deprecated": null
+    },
+    "settings.email_manage": {
+      "screen": "SETTINGS",
+      "kind": "button",
+      "description": "Add / verify / change email.",
+      "actions": [
+        "tap",
+        "dismiss"
+      ],
+      "values": null,
+      "platforms": [
+        "web",
+        "ios",
+        "android"
+      ],
+      "deprecated": null
+    },
+    "settings.phone_update": {
+      "screen": "SETTINGS",
+      "kind": "button",
+      "description": "Change phone number.",
+      "actions": [
+        "tap",
+        "dismiss"
+      ],
+      "values": null,
+      "platforms": [
+        "ios",
+        "android"
+      ],
+      "deprecated": null
+    },
+    "settings.google_link": {
+      "screen": "SETTINGS",
+      "kind": "toggle",
+      "description": "Link/unlink Google. value = new state.",
+      "actions": [
+        "toggle"
+      ],
+      "values": [
+        "link",
+        "unlink"
+      ],
+      "platforms": [
+        "web",
+        "ios",
+        "android"
+      ],
+      "deprecated": null
+    },
+    "settings.apple_link": {
+      "screen": "SETTINGS",
+      "kind": "toggle",
+      "description": "Link/unlink Apple. value = new state.",
+      "actions": [
+        "toggle"
+      ],
+      "values": [
+        "link",
+        "unlink"
+      ],
+      "platforms": [
+        "web",
+        "ios"
+      ],
+      "deprecated": null
+    },
+    "settings.passkey_add": {
+      "screen": "SETTINGS",
+      "kind": "button",
+      "description": "Enrol a passkey.",
+      "actions": [
+        "tap",
+        "dismiss"
+      ],
+      "values": null,
+      "platforms": [
+        "web",
+        "ios"
+      ],
+      "deprecated": null
+    },
+    "settings.password_set": {
+      "screen": "SETTINGS",
+      "kind": "button",
+      "description": "Set / change password.",
+      "actions": [
+        "tap",
+        "dismiss"
+      ],
+      "values": null,
+      "platforms": [
+        "web",
+        "ios"
+      ],
+      "deprecated": null
+    },
+    "settings.recovery_setup": {
+      "screen": "SETTINGS",
+      "kind": "button",
+      "description": "Set up message-history recovery.",
+      "actions": [
+        "tap",
+        "dismiss"
+      ],
+      "values": null,
+      "platforms": [
+        "web",
+        "ios",
+        "android"
+      ],
+      "deprecated": null
+    },
+    "settings.device_revoke": {
+      "screen": "SETTINGS",
+      "kind": "button",
+      "description": "Remove a linked device.",
+      "actions": [
+        "tap"
+      ],
+      "values": null,
+      "platforms": [
+        "web",
+        "ios",
+        "android"
+      ],
+      "deprecated": null
+    },
+    "settings.device_revoke_confirm": {
+      "screen": "SETTINGS",
+      "kind": "dialog_button",
+      "description": "Confirm removing a linked device.",
+      "actions": [
+        "submit",
+        "dismiss"
+      ],
+      "values": null,
+      "platforms": [
+        "ios",
+        "android"
+      ],
+      "deprecated": null
+    },
+    "settings.safety_open": {
+      "screen": "SETTINGS",
+      "kind": "button",
+      "description": "Open safety centre / blocked users.",
+      "actions": [
+        "tap",
+        "dismiss"
+      ],
+      "values": null,
+      "platforms": [
+        "ios"
+      ],
+      "deprecated": null
+    },
+    "settings.theme_select": {
+      "screen": "SETTINGS",
+      "kind": "segmented",
+      "description": "Change appearance. value = theme.",
+      "actions": [
+        "select",
+        "tap"
+      ],
+      "values": [
+        "light",
+        "dark",
+        "system"
+      ],
+      "platforms": [
+        "web",
+        "ios",
+        "android"
+      ],
+      "deprecated": null
+    },
+    "settings.theme_open": {
+      "screen": "SETTINGS",
+      "kind": "button",
+      "description": "Open the appearance chooser.",
+      "actions": [
+        "tap",
+        "dismiss"
+      ],
+      "values": null,
+      "platforms": [
+        "web",
+        "ios",
+        "android"
+      ],
+      "deprecated": null
+    },
+    "settings.sign_out": {
+      "screen": "SETTINGS",
+      "kind": "button",
+      "description": "Sign out.",
+      "actions": [
+        "tap"
+      ],
+      "values": null,
+      "platforms": [
+        "web",
+        "ios",
+        "android"
+      ],
+      "deprecated": null
+    },
+    "settings.sign_out_confirm": {
+      "screen": "SETTINGS",
+      "kind": "dialog_button",
+      "description": "Confirm signing out.",
+      "actions": [
+        "submit",
+        "dismiss"
+      ],
+      "values": null,
+      "platforms": [
+        "ios"
+      ],
+      "deprecated": null
+    },
+    "settings.delete_account_open": {
+      "screen": "SETTINGS",
+      "kind": "button",
+      "description": "Start account deletion.",
+      "actions": [
+        "tap"
+      ],
+      "values": null,
+      "platforms": [
+        "web",
+        "ios",
+        "android"
+      ],
+      "deprecated": null
+    },
+    "settings.delete_account_confirm": {
+      "screen": "SETTINGS",
+      "kind": "dialog_button",
+      "description": "Confirm account deletion.",
+      "actions": [
+        "submit",
+        "dismiss"
+      ],
+      "values": null,
+      "platforms": [
+        "web",
+        "ios",
+        "android"
+      ],
+      "deprecated": null
+    },
+    "settings.unblock_user": {
+      "screen": "SETTINGS",
+      "kind": "button",
+      "description": "Unblock a previously blocked user.",
+      "actions": [
+        "tap"
+      ],
+      "values": null,
+      "platforms": [
+        "ios"
+      ],
+      "deprecated": null
+    },
+    "settings.unblock_confirm": {
+      "screen": "SETTINGS",
+      "kind": "dialog_button",
+      "description": "Confirm unblocking a user.",
+      "actions": [
+        "submit",
+        "dismiss"
+      ],
+      "values": null,
+      "platforms": [
+        "ios"
+      ],
+      "deprecated": null
+    },
+    "settings.verify_code_submit": {
+      "screen": "SETTINGS",
+      "kind": "button",
+      "description": "Submit a verification code for a contact change. value = channel.",
+      "actions": [
+        "submit",
+        "dismiss"
+      ],
+      "values": [
+        "email",
+        "phone"
+      ],
+      "platforms": [
+        "ios",
+        "android"
+      ],
+      "deprecated": null
+    },
+    "settings.password_set_confirm": {
+      "screen": "SETTINGS",
+      "kind": "dialog_button",
+      "description": "Confirm going to sign-in to set a password.",
+      "actions": [
+        "submit",
+        "dismiss"
+      ],
+      "values": null,
+      "platforms": [
+        "ios"
+      ],
+      "deprecated": null
+    },
+    "settings.help_link": {
+      "screen": "SETTINGS",
+      "kind": "link",
+      "description": "Open a help / support / legal page from settings. value = destination.",
+      "actions": [
+        "tap"
+      ],
+      "values": [
+        "help_center",
+        "faq",
+        "contact",
+        "safety",
+        "privacy",
+        "terms",
+        "other"
+      ],
+      "platforms": [
+        "ios"
+      ],
+      "deprecated": null
+    },
+    "settings.recovery_approve": {
+      "screen": "SETTINGS",
+      "kind": "dialog_button",
+      "description": "Approve a history-recovery request from another device.",
+      "actions": [
+        "submit",
+        "dismiss"
+      ],
+      "values": null,
+      "platforms": [
+        "web",
+        "ios"
+      ],
+      "deprecated": null
+    },
+    "settings.recovery_qr_save": {
+      "screen": "SETTINGS",
+      "kind": "button",
+      "description": "Save the recovery QR code.",
+      "actions": [
+        "tap"
+      ],
+      "values": null,
+      "platforms": [
+        "web",
+        "ios",
+        "android"
+      ],
+      "deprecated": null
+    },
+    "settings.recovery_qr_share": {
+      "screen": "SETTINGS",
+      "kind": "button",
+      "description": "Share the recovery QR code.",
+      "actions": [
+        "tap"
+      ],
+      "values": null,
+      "platforms": [
+        "ios",
+        "android"
+      ],
+      "deprecated": null
+    },
+    "paywall.purchase": {
+      "screen": "PAYWALL",
+      "kind": "button",
+      "description": "Choose / buy a membership tier.",
+      "actions": [
+        "tap"
+      ],
+      "values": null,
+      "platforms": [
+        "ios"
+      ],
+      "deprecated": null
+    },
+    "paywall.restore": {
+      "screen": "PAYWALL",
+      "kind": "button",
+      "description": "Refresh / sync / restore membership.",
+      "actions": [
+        "tap"
+      ],
+      "values": null,
+      "platforms": [
+        "ios",
+        "android"
+      ],
+      "deprecated": null
+    },
+    "paywall.features_expand": {
+      "screen": "PAYWALL",
+      "kind": "button",
+      "description": "Show all features in the membership comparison.",
+      "actions": [
+        "tap"
+      ],
+      "values": null,
+      "platforms": [
+        "ios"
+      ],
+      "deprecated": null
+    },
+    "photo_viewer.close": {
+      "screen": "PHOTO_VIEWER",
+      "kind": "button",
+      "description": "Close the full-screen photo viewer.",
+      "actions": [
+        "tap",
+        "dismiss"
+      ],
+      "values": null,
+      "platforms": [
+        "web",
+        "ios",
+        "android"
+      ],
+      "deprecated": null
+    },
+    "photo_viewer.previous": {
+      "screen": "PHOTO_VIEWER",
+      "kind": "button",
+      "description": "Previous photo (explicit control, not a swipe).",
+      "actions": [
+        "tap"
+      ],
+      "values": null,
+      "platforms": [
+        "web"
+      ],
+      "deprecated": null
+    },
+    "photo_viewer.next": {
+      "screen": "PHOTO_VIEWER",
+      "kind": "button",
+      "description": "Next photo (explicit control, not a swipe).",
+      "actions": [
+        "tap"
+      ],
+      "values": null,
+      "platforms": [
+        "web"
+      ],
+      "deprecated": null
+    },
+    "search.close": {
+      "screen": "SEARCH",
+      "kind": "button",
+      "description": "Close search.",
+      "actions": [
+        "tap",
+        "dismiss"
+      ],
+      "values": null,
+      "platforms": [
+        "web"
+      ],
+      "deprecated": null
+    },
+    "search.query_clear": {
+      "screen": "SEARCH",
+      "kind": "button",
+      "description": "Clear the search query.",
+      "actions": [
+        "tap"
+      ],
+      "values": null,
+      "platforms": [
+        "web"
+      ],
+      "deprecated": null
+    },
+    "search.filter_select": {
+      "screen": "SEARCH",
+      "kind": "segmented",
+      "description": "Choose a search filter.",
+      "actions": [
+        "select",
+        "tap"
+      ],
+      "values": null,
+      "platforms": [
+        "web"
+      ],
+      "deprecated": null
+    },
+    "search.result_open": {
+      "screen": "SEARCH",
+      "kind": "list_item",
+      "description": "Open a search result. index = row, targetId = user.",
+      "actions": [
+        "tap"
+      ],
+      "values": null,
+      "platforms": [
+        "web"
+      ],
+      "deprecated": null
+    },
+    "create.close": {
+      "screen": "CREATE",
+      "kind": "button",
+      "description": "Close the create menu.",
+      "actions": [
+        "tap",
+        "dismiss"
+      ],
+      "values": null,
+      "platforms": [
+        "web"
+      ],
+      "deprecated": null
+    },
+    "create.option_select": {
+      "screen": "CREATE",
+      "kind": "menu_item",
+      "description": "Pick what to create. value = kind.",
+      "actions": [
+        "tap"
+      ],
+      "values": [
+        "photo",
+        "prompt",
+        "voice"
+      ],
+      "platforms": [
+        "web"
+      ],
+      "deprecated": null
+    },
+    "shared.alert_dismiss": {
+      "screen": "SHARED",
+      "kind": "dialog_button",
+      "description": "Acknowledge / close an informational, error or success alert or toast.",
+      "actions": [
+        "tap",
+        "dismiss"
+      ],
+      "values": null,
+      "platforms": [
+        "web",
+        "ios",
+        "android"
+      ],
+      "deprecated": null
+    },
+    "shared.error_recover": {
+      "screen": "SHARED",
+      "kind": "button",
+      "description": "Crash / error screen recovery. value = choice.",
+      "actions": [
+        "tap"
+      ],
+      "values": [
+        "retry",
+        "home"
+      ],
+      "platforms": [
+        "web"
+      ],
+      "deprecated": null
+    },
+    "shared.country_code_open": {
+      "screen": "SHARED",
+      "kind": "button",
+      "description": "Open the phone dial-code picker.",
+      "actions": [
+        "tap",
+        "dismiss"
+      ],
+      "values": null,
+      "platforms": [
+        "web",
+        "ios",
+        "android"
+      ],
+      "deprecated": null
+    },
+    "shared.country_code_select": {
+      "screen": "SHARED",
+      "kind": "segmented",
+      "description": "Choose a phone dial code.",
+      "actions": [
+        "select",
+        "tap"
+      ],
+      "values": null,
+      "platforms": [
+        "web",
+        "ios",
+        "android"
+      ],
+      "deprecated": null
+    },
+    "shared.voice_recorder": {
+      "screen": "SHARED",
+      "kind": "button",
+      "description": "Voice recorder / preview control. value = control.",
+      "actions": [
+        "tap"
+      ],
+      "values": [
+        "record",
+        "stop",
+        "play",
+        "pause",
+        "save",
+        "discard",
+        "cancel",
+        "open_settings"
+      ],
+      "platforms": [
+        "web",
+        "ios"
+      ],
+      "deprecated": null
+    },
+    "shared.prompt_preset_select": {
+      "screen": "SHARED",
+      "kind": "segmented",
+      "description": "Choose a prompt question from the presets.",
+      "actions": [
+        "select",
+        "tap"
+      ],
+      "values": null,
+      "platforms": [
+        "web",
+        "ios"
+      ],
+      "deprecated": null
+    },
+    "liveness.begin": {
+      "screen": "LIVENESS",
+      "kind": "button",
+      "description": "Begin the liveness check.",
+      "actions": [
+        "tap"
+      ],
+      "values": null,
+      "platforms": [
+        "web",
+        "ios",
+        "android"
+      ],
+      "deprecated": null
+    },
+    "liveness.dismiss": {
+      "screen": "LIVENESS",
+      "kind": "button",
+      "description": "Not now / back.",
+      "actions": [
+        "tap",
+        "dismiss"
+      ],
+      "values": null,
+      "platforms": [
+        "ios",
+        "android"
+      ],
+      "deprecated": null
+    },
+    "liveness.retry": {
+      "screen": "LIVENESS",
+      "kind": "button",
+      "description": "Try again after an error.",
+      "actions": [
+        "tap"
+      ],
+      "values": null,
+      "platforms": [
+        "web",
+        "ios",
+        "android"
+      ],
+      "deprecated": null
+    },
+    "liveness.open_settings": {
+      "screen": "LIVENESS",
+      "kind": "button",
+      "description": "Open system settings (camera permission).",
+      "actions": [
+        "tap"
+      ],
+      "values": null,
+      "platforms": [
+        "ios",
+        "android"
+      ],
+      "deprecated": null
+    },
+    "liveness.close": {
+      "screen": "LIVENESS",
+      "kind": "button",
+      "description": "Close the flow / back to profile.",
+      "actions": [
+        "tap"
+      ],
+      "values": null,
+      "platforms": [
+        "android"
+      ],
+      "deprecated": null
+    }
+  },
+  "platformGaps": {
+    "web": {
+      "chat.call": "Not built on Web: no in-app voice calling.",
+      "chat.capture_option": "No in-app camera capture on Web; attachments use the OS file picker.",
+      "chat.intro_dismiss": "Not built on Web: there is no in-chat intro tour / stories invitation.",
+      "chat.intro_get_started": "Not built on Web: there is no in-chat intro tour / stories invitation.",
+      "chat.intro_tour_open": "Not built on Web: there is no in-chat intro tour / stories invitation.",
+      "chat.message_delete": "Not built on Web: messages cannot be deleted from the Web chat.",
+      "chat.message_menu_open": "Web chat has no per-message long-press/context menu; there is no delete (chat.message_delete is gapped) or reaction menu to open.",
+      "chat.mr_onehook_close": "Web leaves Mr OneHook via the standard conversation back navigation (nav.back); there is no distinct leave-AI button.",
+      "chat.profile_close": "Web toggles the peer profile panel with a single control (chat.profile_open); there is no separate close button.",
+      "chat.unmatch": "Web ends a connection through Report & block (chat.report_block); the shipped chat has no neutral unmatch control (the standalone MatchesView unmatch UI is not mounted).",
+      "chat.unmatch_confirm": "No neutral unmatch flow in the shipped Web chat; ending a connection goes through Report & block (chat.block_confirm).",
+      "chat.video_call": "Not built on Web: no in-app video calling.",
+      "chat.voice_record_stop": "Web combines stop and send into one control (chat.voice_send); there is no separate stop.",
+      "chat_settings.clear_cache": "No clear-cache control in the Web chat settings sheet; the browser manages its own storage.",
+      "chat_settings.export_chat": "Not built on Web: no chat-export control in the settings sheet.",
+      "chat_settings.font_size_select": "Not built on Web: no chat font-size control in the settings sheet.",
+      "discover.add_hook_open": "Add-a-connection lives in Chat on Web (chat.add_hook_open), not in discovery.",
+      "discover.like_button": "Web likes via the comment composer (discover.element_like); there is no bare like button.",
+      "discover.likes_you_open": "Likes You is a main navigation tab on Web (nav.tab_select), not a discovery button.",
+      "discover.preferences_open": "Match preferences are edited in the profile editor on Web; discovery has no preferences button.",
+      "discover.undo_button": "Web discovery has no undo; acting on a card removes it and cannot be reversed.",
+      "discover.upgrade_open": "No discovery upgrade upsell on Web.",
+      "like_composer.send_without_comment": "The Web like composer requires a comment to send; there is no send-without-comment action.",
+      "like_composer.upgrade": "No upgrade upsell inside the Web like composer.",
+      "likes_you.close": "Likes You is a full navigation tab on Web, not a modal with a close control.",
+      "liveness.close": "Web liveness is an embedded profile card; there is no close/back-to-profile control.",
+      "liveness.dismiss": "No not-now/dismiss control in the Web liveness card.",
+      "liveness.open_settings": "Web cannot open OS settings for camera permission.",
+      "login.passkey": "Web sign-in offers Google/Apple/OTP/password; passkeys are enrolled in settings, not as a sign-in button.",
+      "nav.hooked_dismiss": "The Web hooked overlay is a hard guard with only a go-to-chat action; it cannot be dismissed.",
+      "notifications.item_dismiss": "No in-app notification center on Web.",
+      "notifications.item_open": "No in-app notification center on Web.",
+      "onboarding.skip_sign_out_confirm": "Skip-for-now signs the user out immediately on Web; there is no confirmation dialog.",
+      "paywall.features_expand": "No in-app paywall on Web; the upgrade links to the marketing pricing page.",
+      "paywall.purchase": "No in-app paywall/purchase on Web; the upgrade links to the marketing pricing page.",
+      "paywall.restore": "No in-app membership restore on Web.",
+      "preferences.locked_filter_tap": "No premium-locked match filters on Web; the profile shows a single Upgrade button (profile.upgrade_open).",
+      "preferences.save": "Match preferences are saved inline via the profile editor (profile_edit.save); the standalone PreferencesPanel is not mounted.",
+      "preferences.upgrade_open": "No premium-locked filter upsell in Web preferences.",
+      "profile.chat_settings_open": "Web opens chat settings from the chat shield menu (chat.settings_open), not from the profile.",
+      "profile.chat_tour_open": "Not built on Web: no replay-chat-intro control in the profile.",
+      "profile.edit_open": "The Web profile is edited inline; there is no separate editor-open control.",
+      "profile.invite_code_copy": "No invite-code copy control in the Web profile.",
+      "profile.invite_code_share": "No invite-code share control in the Web profile.",
+      "profile.preferences_open": "Match preferences are edited inline in the Web profile editor; there is no separate open control.",
+      "profile.share_invite": "No share-invite control in the Web profile.",
+      "profile.tab_select": "The Web profile is a single scrolling page; it has no sub-section tabs.",
+      "profile.unhook": "Connection release lives in Chat on Web (chat.unmatch).",
+      "profile.unhook_confirm": "Connection release is confirmed in Chat on Web (chat.unmatch_confirm).",
+      "profile.verify_identity": "Identity verification is embedded in the Web profile; the start control is liveness.begin.",
+      "profile_edit.photo_adjust": "No crop/adjust control in the Web photo editor.",
+      "profile_edit.photo_remove_confirm": "Profile photo removal is immediate on Web; there is no confirmation dialog.",
+      "profile_edit.photo_reorder": "No drag-reorder gesture in the Web photo grid; the primary photo is set explicitly.",
+      "profile_edit.preview": "Web previews via profile.preview_open; there is no separate editor-preview control.",
+      "redeem_invite.close": "The Web redeem flow closes via the site-header home link, not a dedicated close button.",
+      "settings.device_revoke_confirm": "Device revoke is immediate on Web; there is no confirmation dialog.",
+      "settings.help_link": "No help-centre link in Web settings.",
+      "settings.password_set_confirm": "Setting a password on Web signs the user out to use Forgot Password; there is no confirmation dialog.",
+      "settings.phone_update": "No phone-number change control in Web settings.",
+      "settings.recovery_qr_share": "Web offers Save QR (download); there is no native share action.",
+      "settings.safety_open": "No safety-centre / blocked-users screen in Web settings.",
+      "settings.sign_out_confirm": "Sign out is immediate on Web; there is no confirmation dialog.",
+      "settings.unblock_confirm": "No blocked-users management on Web (settings.unblock_user is gapped), so there is no unblock confirmation.",
+      "settings.unblock_user": "No blocked-users management in Web settings.",
+      "settings.verify_code_submit": "Web verifies a new email inline via settings.email_manage; there is no separate verify-code control, and phone updates are not offered (settings.phone_update is gapped)."
+    },
+    "ios": {
+      "chat.capture_option": "iOS captures via the system UIImagePickerController camera; photo vs video is chosen in the system camera UI, not an app control.",
+      "chat.history_reset_confirm": "iOS message-history recovery has no last-resort reset flow; recovery is via a source device + QR (chat.history_recover / chat.history_recover_method / chat.history_recover_step), so there is no reset to confirm.",
+      "chat.mr_onehook_close": "No explicit leave-Mr-OneHook control on iOS; the user switches away via the conversation switcher (chat.conversation_switch).",
+      "chat.mr_onehook_open": "Mr OneHook is entered by selecting its row in the conversation switcher (tracked as chat.conversation_switch); there is no dedicated open control.",
+      "chat.mr_onehook_scope_open": "iOS Mr OneHook sharing is a single Share & Ask confirmation (chat.mr_onehook_context_share) that previews the exact bounded excerpts; there is no product-only/match scope picker, so there is no scope-picker opener to tap.",
+      "chat.mr_onehook_scope_select": "iOS Mr OneHook sharing is a single Share & Ask confirmation (chat.mr_onehook_context_share); there is no product-only/match scope picker.",
+      "chat.retry": "The chat thread has no load-retry control on iOS; transient failures reload automatically from the live subscription.",
+      "chat.wallpaper_open": "iOS changes chat wallpaper via the chat settings picker (chat_settings.wallpaper_select); there is no in-thread wallpaper menu.",
+      "create.close": "iOS has no global create menu; a photo/prompt/voice is added directly inside the profile editor and onboarding (profile_edit.* / onboarding.*), so there is no create surface to close.",
+      "create.option_select": "iOS has no global create menu; adding a photo/prompt/voice is done directly in the profile editor and onboarding (profile_edit.photo_add / prompt_add / voice_add, onboarding.photo_add / prompt_add / voice_add), not via a create shortcut.",
+      "discover.like_button": "iOS likes are per element (discover.element_like); the iOS card has no whole-candidate like button or right-swipe.",
+      "landing.careers_apply": "Careers / apply lives only on the public marketing website; the iOS landing screen is just the hero + Get started / Login.",
+      "landing.chatbot_widget": "The public marketing chatbot widget is web-only; iOS has no signed-out chatbot (Mr OneHook is an in-chat member feature).",
+      "landing.demo_interact": "The signed-out interactive marketing demos / explainers exist only on the web landing site.",
+      "landing.email_link": "Mailto links on public pages are web-only; the iOS landing screen exposes no support/legal mailboxes.",
+      "landing.home_link": "The signed-out site-header wordmark is web-only; iOS launches straight into the native app shell.",
+      "landing.mobile_menu_toggle": "The marketing mobile nav drawer is web-only; the iOS landing screen has no site navigation to open or close.",
+      "landing.nav_link": "Marketing navigation links exist only on the web landing site.",
+      "landing.notice_retry": "The \"finish in app\" notice is a web hand-off prompt; iOS is the app, so there is no such notice to retry.",
+      "landing.open_in_app": "iOS is the app; there is no open-in-app / app-store smart-banner link.",
+      "landing.pricing_period_select": "The public pricing page (and its billing-period chooser) is web-only; iOS surfaces membership only in the in-app paywall.",
+      "landing.section_nav": "In-page landing section jumps belong to the scrollable web marketing site; the iOS landing screen is a single hero.",
+      "likes_you.liked_item_open": "iOS opens the liker's full profile; it does not deep-link to the specific liked profile element.",
+      "likes_you.refresh": "The Likes You list refreshes automatically from its live subscription; there is no manual pull-to-refresh control.",
+      "liveness.close": "iOS liveness uses liveness.dismiss (Not now / back); the hosted flow has no separate close control.",
+      "login.passkey_setup": "iOS has no post-sign-in account-setup wizard; passkeys are enrolled from Settings (settings.passkey_add) and passkey sign-in uses login.passkey.",
+      "nav.back": "Back navigation is the system UINavigationController back button, not an app-owned control.",
+      "nav.home_logo": "iOS has no tappable in-app wordmark / logo home control.",
+      "nav.menu_open": "iOS navigates via the bottom tab bar; there is no hamburger / more menu.",
+      "nav.search_open": "iOS has no global search / explore entry point.",
+      "onboarding.photo_remove_confirm": "During onboarding nothing is saved yet, so removing a pending photo is immediate with no confirmation dialog (onboarding.photo_remove); the confirm exists only in the profile editor (profile_edit.photo_remove_confirm).",
+      "photo_viewer.next": "The iOS photo viewer navigates by swipe; there is no explicit next-photo button.",
+      "photo_viewer.previous": "The iOS photo viewer navigates by swipe; there is no explicit previous-photo button.",
+      "profile.settings_open": "iOS presents settings inside the profile tab's segmented control; there is no separate settings entry point.",
+      "profile.unhook": "On iOS, releasing a connection happens from the chat thread (chat.unmatch / chat.unmatch_confirm), not from the user's own profile hub.",
+      "profile.unhook_confirm": "On iOS, the unhook confirmation is the chat-thread dialog (chat.unmatch_confirm); the profile hub has no unhook flow.",
+      "profile.voice_play": "The iOS profile hub does not play the user's own voice prompt; playback lives in the profile editor's voice section.",
+      "redeem_invite.back": "iOS redemption has no separate back control; the flow uses redeem_invite.close.",
+      "search.close": "iOS has no search / explore surface (see nav.search_open).",
+      "search.filter_select": "iOS has no search / explore surface (see nav.search_open).",
+      "search.query_clear": "iOS has no search / explore surface (see nav.search_open).",
+      "search.result_open": "iOS has no search / explore surface (see nav.search_open).",
+      "shared.error_recover": "iOS surfaces load errors per-screen via the OHStateView retry control (discover.retry / likes_you.retry / profile.retry); there is no global crash/error screen offering retry|home choices."
+    },
+    "android": {
+      "chat.add_hook_open": "Not built on Android: no add-another-connection entry inside chat.",
+      "chat.call": "Not built on Android: no in-app voice calling.",
+      "chat.conversation_sort": "Not built on Android: the conversation list has no sort control.",
+      "chat.conversation_sort_open": "Not built on Android: the conversation list has no sort control/menu to open.",
+      "chat.conversation_switcher_open": "Not built on Android: conversations are cycled with a next button, with no switcher/picker.",
+      "chat.history_reset_confirm": "Not built on Android: recovery is device/QR/passkey based with no last-resort history-reset flow.",
+      "chat.intro_dismiss": "Not built on Android: there is no in-chat intro tour/stories to dismiss.",
+      "chat.intro_get_started": "Not built on Android: there is no in-chat intro tour final CTA.",
+      "chat.intro_tour_open": "Not built on Android: there is no in-chat intro tour invitation.",
+      "chat.mr_onehook_scope_open": "Not built on Android: Mr OneHook auto-scopes to the open match (shown as a status label), with no scope picker to open.",
+      "chat.mr_onehook_scope_select": "Not built on Android: Mr OneHook auto-scopes to the open match, with no scope picker.",
+      "chat.sensitive_reveal_confirm": "Not built on Android: peer media is blanket-blurred with single-tap reveal (tracked as chat.media_open); there is no reveal confirmation dialog.",
+      "chat.settings_open": "Not built on Android: no per-conversation chat settings screen.",
+      "chat.video_call": "Not built on Android: no in-app video calling.",
+      "chat.voice_send": "Not built on Android: a recorded voice note is sent automatically on stop, with no separate send button.",
+      "chat.wallpaper_open": "Not built on Android: no change-chat-wallpaper option.",
+      "chat_settings.clear_cache": "Not built on Android: no per-user chat settings screen, so no clear-media-cache control.",
+      "chat_settings.disappearing_select": "Not built on Android: no per-user chat settings screen.",
+      "chat_settings.export_chat": "Not built on Android: no per-user chat settings screen.",
+      "chat_settings.font_size_select": "Not built on Android: no per-user chat settings screen.",
+      "chat_settings.last_seen_select": "Not built on Android: no per-user chat settings screen.",
+      "chat_settings.notification_toggle": "Not built on Android: no per-user chat settings screen.",
+      "chat_settings.privacy_toggle": "Not built on Android: no per-user chat settings screen.",
+      "chat_settings.wallpaper_select": "Not built on Android: no per-user chat settings screen.",
+      "create.close": "Not built on Android: no create menu (add photo/prompt/voice shortcuts), so nothing to close.",
+      "create.option_select": "Not built on Android: no create menu (shortcuts to add a photo/prompt/voice).",
+      "discover.add_hook_open": "Not built on Android: no add-by-username/invite entry in discovery.",
+      "discover.add_hook_submit": "Not built on Android: no add-by-username/invite flow in discovery.",
+      "discover.element_like": "Not built on Android: the swipe-only deck has no per-element (comment-to-like) affordance.",
+      "discover.preferences_open": "Not built on Android: discovery preferences are opened from Profile, not the deck header.",
+      "discover.undo_button": "Not built on Android: no undo-last-decision control in the deck.",
+      "discover.upgrade_open": "Not built on Android: no in-deck upgrade/upsell prompt.",
+      "discover.voice_play": "Not built on Android: discovery cards render no voice-prompt player.",
+      "landing.careers_apply": "Web-only: careers/apply lives on the public marketing site, not the native landing.",
+      "landing.chatbot_widget": "Web-only: the public chatbot widget is a marketing-site feature, absent in the app.",
+      "landing.demo_interact": "Web-only: interactive public-page demos/explainers are not part of the native landing.",
+      "landing.email_link": "Web-only: mailto links live on public marketing pages, not the native landing.",
+      "landing.home_link": "Web-only: signed-out site header wordmark; the native landing has no site header.",
+      "landing.mobile_menu_toggle": "Web-only: the marketing mobile nav menu does not exist in the native app.",
+      "landing.nav_link": "Web-only: marketing navigation links do not exist in the native app.",
+      "landing.notice_retry": "Web-only: the \"finish in app\" notice is a web handoff prompt, absent in the app.",
+      "landing.open_in_app": "Web-only: open-in-app/app-store links are not shown inside the app.",
+      "landing.pricing_period_select": "Web-only: the public pricing page billing-period chooser is not in the native app.",
+      "landing.section_nav": "Web-only: in-page landing section jump links do not exist in the native app.",
+      "landing.social_link": "Not built on Android: the native landing shows no social-channel links.",
+      "like_composer.send_without_comment": "Not built on Android: a rose requires a note, so there is no send-without-comment path.",
+      "like_composer.upgrade": "Not built on Android: no upgrade prompt inside the like composer.",
+      "likes_you.liked_item_open": "Not built on Android: a liker row opens the full profile; the liked element is not separately tappable.",
+      "login.apple": "Not built on Android: Sign in with Apple is not offered.",
+      "login.passkey": "Not built on Android: passkey sign-in is not offered on the login screen.",
+      "login.passkey_setup": "Not built on Android: no post-sign-in account/passkey setup step (passkeys are not offered).",
+      "login.redeem_invite": "Not built on Android: the login screen has no invite link; redemption is launched from the landing screen.",
+      "login.resend_code": "Not built on Android: the login OTP step has no resend-code link.",
+      "nav.back": "Platform-provided: back navigation uses the system back gesture/button, not an in-app top-bar arrow.",
+      "nav.home_logo": "Not built on Android: the main shell shows no tappable wordmark/logo.",
+      "nav.hooked_dismiss": "Not built on Android: a mutual match shows a transient toast, not a dismissible hooked overlay.",
+      "nav.hooked_go_to_chat": "Not built on Android: a mutual match shows a transient toast, not an interactive hooked overlay with a go-to-chat button.",
+      "nav.menu_open": "Not built on Android: navigation uses a bottom tab bar, with no hamburger/more menu.",
+      "nav.search_open": "Not built on Android: there is no global search/explore entry.",
+      "notifications.item_dismiss": "Not built on Android: no in-app notification center; system notifications are dismissed by the OS.",
+      "notifications.item_open": "Not built on Android: no in-app notification center; push opens are reported via notification_opened.",
+      "onboarding.back": "Not built on Android: onboarding is a single page, with no per-step back control.",
+      "onboarding.next": "Not built on Android: onboarding is a single page completed at once, with no per-step next.",
+      "onboarding.photo_add": "Not built on Android: onboarding collects no photos (added later in profile editing).",
+      "onboarding.photo_remove": "Not built on Android: onboarding collects no photos.",
+      "onboarding.photo_remove_confirm": "Not built on Android: onboarding collects no photos, so there is no photo-remove confirmation.",
+      "onboarding.prompt_add": "Not built on Android: onboarding collects no written prompts.",
+      "onboarding.prompt_remove": "Not built on Android: onboarding collects no written prompts.",
+      "onboarding.voice_add": "Not built on Android: onboarding collects no voice prompt.",
+      "onboarding.voice_remove": "Not built on Android: onboarding collects no voice prompt.",
+      "paywall.features_expand": "Not built on Android: the membership screen has no expandable feature comparison.",
+      "paywall.purchase": "Not built on Android: membership is reconciled from billing (restore), with no in-app purchase/tier picker.",
+      "photo_viewer.next": "Not built on Android: the photo viewer shows a single photo with no next control.",
+      "photo_viewer.previous": "Not built on Android: the photo viewer shows a single photo with no previous control.",
+      "preferences.locked_filter_tap": "Not built on Android: preferences have no locked/premium filters to tap.",
+      "preferences.upgrade_open": "Not built on Android: preferences have no locked/premium filter upsell.",
+      "profile.chat_settings_open": "Not built on Android: no chat-settings entry on the profile.",
+      "profile.chat_tour_open": "Not built on Android: no replay-chat-intro entry (the chat intro tour is not built).",
+      "profile.invite_code_copy": "Not built on Android: invites are generated and shared in one step via the system share sheet (profile.share_invite); no generated-code screen with a copy control.",
+      "profile.invite_code_share": "Not built on Android: profile.share_invite launches the system share sheet directly; there is no separate share-generated-code control.",
+      "profile.preview_open": "Not built on Android: no preview-my-profile-as-others-see-it entry.",
+      "profile.settings_open": "Web-only: Android shows settings inline on the profile, with no separate settings entry button.",
+      "profile.tab_select": "Not built on Android: the profile is a single scrolling screen with no sub-section tabs.",
+      "profile.voice_play": "Not built on Android: the profile shows no own-voice-prompt player.",
+      "profile_edit.choice_select": "Not built on Android: profile editing uses free-text fields, not segmented choice chips.",
+      "profile_edit.photo_adjust": "Not built on Android: no in-app photo crop/adjust control.",
+      "profile_edit.photo_remove": "Not built on Android: profile editing cannot remove individual photos.",
+      "profile_edit.photo_remove_confirm": "Not built on Android: profile editing cannot remove individual photos, so there is no confirmation.",
+      "profile_edit.photo_reorder": "Not built on Android: photos cannot be drag-reordered.",
+      "profile_edit.photo_set_primary": "Not built on Android: no make-a-photo-primary control.",
+      "profile_edit.preview": "Not built on Android: no preview-while-editing control.",
+      "profile_edit.prompt_add": "Not built on Android: profile editing has no written-prompt management.",
+      "profile_edit.prompt_remove": "Not built on Android: profile editing has no written-prompt management.",
+      "profile_edit.voice_add": "Not built on Android: profile editing has no voice-prompt recording.",
+      "profile_edit.voice_remove": "Not built on Android: profile editing has no voice-prompt management.",
+      "redeem_invite.resend_code": "Not built on Android: the redemption OTP step has no resend-code control.",
+      "search.close": "Not built on Android: there is no search/explore surface.",
+      "search.filter_select": "Not built on Android: there is no search/explore surface.",
+      "search.query_clear": "Not built on Android: there is no search/explore surface.",
+      "search.result_open": "Not built on Android: there is no search/explore surface.",
+      "settings.apple_link": "Not built on Android: linking/unlinking Apple is not offered.",
+      "settings.help_link": "Not built on Android: settings/profile show no help/support/legal links (policy links live on the landing screen).",
+      "settings.passkey_add": "Not built on Android: passkey enrolment is not offered in settings.",
+      "settings.password_set": "Not built on Android: setting/changing a password is only available via the login reset flow.",
+      "settings.password_set_confirm": "Not built on Android: setting a password is only via the login reset flow, with no go-to-sign-in confirmation dialog.",
+      "settings.recovery_approve": "Platform-provided: a history-recovery request is approved via the system BiometricPrompt, not an in-app dialog button.",
+      "settings.safety_open": "Not built on Android: no safety-centre/blocked-users entry in settings.",
+      "settings.sign_out_confirm": "Not built on Android: sign out is immediate with no confirmation dialog.",
+      "settings.unblock_confirm": "Not built on Android: no unblock control (there is no in-app blocked-users list), so no confirmation.",
+      "settings.unblock_user": "Not built on Android: no unblock control (there is no in-app blocked-users list).",
+      "shared.error_recover": "Not built on Android: no global crash/error recovery screen; load errors use screen-specific retries (discover.retry, chat.retry, profile.retry).",
+      "shared.prompt_preset_select": "Not built on Android: profile/onboarding prompts are not built, so there is no prompt-preset chooser.",
+      "shared.voice_recorder": "Not built on Android: the only recorder is the chat voice note (chat.voice_record_*); no profile/shared voice-prompt recorder."
+    }
+  },
+  "exemptCategories": {
+    "duplicate": "The same press is already emitted by another site (wrapper / forwarder / dispatcher / emitted in the callee).",
+    "backdrop": "Click-away backdrop or modal container that only closes a surface or stops propagation (not a control).",
+    "gesture": "Non-press gesture: keyboard dismiss, pinch/double-tap zoom, paging, hold-to-pause, scroll.",
+    "continuous": "Continuous value stream (slider drag, text input); the committed value is tracked elsewhere.",
+    "disabled": "Never interactive (permanently disabled / decorative)."
+  },
+  "signals": {
+    "screen_view": {
+      "description": "A screen was shown.",
+      "attributes": {
+        "screen": {
+          "type": "string",
+          "enum": "ViewableScreen",
+          "required": true,
+          "description": "Canonical screen.",
+          "invalidReason": "bad_screen",
+          "missingReason": "missing_screen"
+        }
+      }
+    },
+    "ui_interaction": {
+      "description": "A registered UI element was interacted with. The standard way to track every click.",
+      "attributes": {
+        "elementId": {
+          "type": "string",
+          "enum": "UiElement",
+          "required": true,
+          "description": "Registered UI element id.",
+          "invalidReason": "unknown_element"
+        },
+        "action": {
+          "type": "string",
+          "enum": "UiAction",
+          "description": "Standard verb (defaults to the element's first action)."
+        },
+        "value": {
+          "type": "string",
+          "maxLength": 64,
+          "description": "Element-specific value from its declared value set."
+        },
+        "index": {
+          "type": "number",
+          "description": "Position in a list / gallery.",
+          "min": 0
+        },
+        "targetId": {
+          "type": "string",
+          "description": "Opaque id of the entity acted on (user / match / media).",
+          "required": false,
+          "maxLength": 256
+        },
+        "screen": {
+          "type": "string",
+          "enum": "Screen",
+          "description": "SERVER-STAMPED from the element's home screen; clients need not send it."
+        },
+        "context": {
+          "type": "string",
+          "enum": "ViewableScreen",
+          "dropInvalid": true,
+          "description": "Host screen. Recommended for SHARED elements (and any element presented away from its home screen)."
+        }
+      }
+    },
+    "card_impression": {
+      "description": "A discovery card was shown.",
+      "attributes": {
+        "candidateId": {
+          "type": "string",
+          "description": "Opaque candidate user id.",
+          "required": false,
+          "maxLength": 100
+        },
+        "index": {
+          "type": "number",
+          "description": "Deck position.",
+          "min": 0
+        },
+        "dwellMs": {
+          "type": "number",
+          "description": "Milliseconds on screen.",
+          "min": 0,
+          "max": 3600000,
+          "invalidReason": "dwell_out_of_range"
+        }
+      }
+    },
+    "card_swipe_ui": {
+      "description": "A discovery decision UI action.",
+      "attributes": {
+        "direction": {
+          "type": "string",
+          "enum": "SwipeDirection",
+          "description": "left = pass, right = like, up = rose.",
+          "invalidReason": "bad_swipe_direction"
+        },
+        "candidateId": {
+          "type": "string",
+          "description": "Opaque candidate user id.",
+          "required": false,
+          "maxLength": 100
+        }
+      }
+    },
+    "prompt_view": {
+      "description": "A written prompt was viewed.",
+      "attributes": {
+        "promptId": {
+          "type": "string",
+          "description": "Opaque prompt id.",
+          "required": true,
+          "maxLength": 256
+        },
+        "viewedUserId": {
+          "type": "string",
+          "description": "Opaque id of the profile being viewed.",
+          "required": false,
+          "maxLength": 256
+        },
+        "cardVariant": {
+          "type": "string",
+          "enum": "CardVariant",
+          "dropInvalid": true,
+          "description": "Discovery card design."
+        }
+      }
+    },
+    "media_view": {
+      "description": "A photo / video / voice element was viewed.",
+      "attributes": {
+        "mediaId": {
+          "type": "string",
+          "description": "Opaque media key.",
+          "required": true,
+          "maxLength": 512
+        },
+        "mediaType": {
+          "type": "string",
+          "enum": "MediaType",
+          "required": true,
+          "description": "Media type."
+        },
+        "dwellMs": {
+          "type": "number",
+          "description": "Milliseconds on screen.",
+          "min": 0,
+          "max": 3600000,
+          "invalidReason": "dwell_out_of_range"
+        },
+        "index": {
+          "type": "number",
+          "description": "Gallery position.",
+          "min": 0
+        },
+        "viewedUserId": {
+          "type": "string",
+          "description": "Opaque id of the profile being viewed.",
+          "required": false,
+          "maxLength": 256
+        },
+        "context": {
+          "type": "string",
+          "enum": "ViewableScreen",
+          "dropInvalid": true,
+          "description": "Screen the signal happened on."
+        },
+        "cardVariant": {
+          "type": "string",
+          "enum": "CardVariant",
+          "dropInvalid": true,
+          "description": "Discovery card design."
+        },
+        "playedToCompletion": {
+          "type": "boolean",
+          "description": "A voice/video clip played to the end."
+        }
+      }
+    },
+    "media_fullscreen_open": {
+      "description": "A photo was opened full screen.",
+      "attributes": {
+        "mediaId": {
+          "type": "string",
+          "description": "Opaque media key.",
+          "required": true,
+          "maxLength": 512
+        },
+        "mediaType": {
+          "type": "string",
+          "enum": "MediaType",
+          "required": true,
+          "description": "Media type (image)."
+        },
+        "index": {
+          "type": "number",
+          "description": "Gallery position.",
+          "min": 0
+        },
+        "viewedUserId": {
+          "type": "string",
+          "description": "Opaque id of the profile being viewed.",
+          "required": false,
+          "maxLength": 256
+        },
+        "context": {
+          "type": "string",
+          "enum": "ViewableScreen",
+          "dropInvalid": true,
+          "description": "Screen the signal happened on."
+        }
+      }
+    },
+    "section_view": {
+      "description": "A profile section was viewed.",
+      "attributes": {
+        "sectionId": {
+          "type": "string",
+          "enum": "ProfileSection",
+          "required": true,
+          "description": "Profile section."
+        },
+        "viewedUserId": {
+          "type": "string",
+          "description": "Opaque id of the profile being viewed.",
+          "required": false,
+          "maxLength": 256
+        },
+        "dwellMs": {
+          "type": "number",
+          "description": "Milliseconds on screen.",
+          "min": 0,
+          "max": 3600000,
+          "invalidReason": "dwell_out_of_range"
+        },
+        "context": {
+          "type": "string",
+          "enum": "ViewableScreen",
+          "dropInvalid": true,
+          "description": "Screen the signal happened on."
+        },
+        "cardVariant": {
+          "type": "string",
+          "enum": "CardVariant",
+          "dropInvalid": true,
+          "description": "Discovery card design."
+        }
+      }
+    },
+    "notification_opened": {
+      "description": "A notification was opened.",
+      "attributes": {
+        "notifType": {
+          "type": "string",
+          "enum": "NotificationType",
+          "required": true,
+          "description": "Notification kind."
+        },
+        "matchId": {
+          "type": "string",
+          "description": "Opaque match id.",
+          "required": false,
+          "maxLength": 256
+        },
+        "openLatencyMs": {
+          "type": "number",
+          "description": "Delivery-to-open latency.",
+          "min": 0
+        },
+        "channel": {
+          "type": "string",
+          "enum": "NotificationChannel",
+          "dropInvalid": true,
+          "description": "push | in_app."
+        }
+      }
+    },
+    "session_heartbeat": {
+      "description": "Periodic foreground heartbeat.",
+      "attributes": {}
+    },
+    "like_composer_open": {
+      "description": "The comment-to-like composer was opened.",
+      "attributes": {
+        "likeTargetType": {
+          "type": "string",
+          "enum": "LikeTargetType",
+          "description": "Targeted element type."
+        },
+        "likeTargetRef": {
+          "type": "string",
+          "description": "Opaque element ref (never text).",
+          "required": false,
+          "maxLength": 256
+        }
+      }
+    },
+    "like_comment_abandoned": {
+      "description": "The like composer was closed without sending.",
+      "attributes": {
+        "likeTargetType": {
+          "type": "string",
+          "enum": "LikeTargetType",
+          "description": "Targeted element type."
+        },
+        "composeDurationMs": {
+          "type": "number",
+          "description": "Milliseconds the composer was open.",
+          "min": 0,
+          "max": 3600000,
+          "invalidReason": "compose_duration_out_of_range"
+        },
+        "hadDraft": {
+          "type": "boolean",
+          "description": "Whether any text had been entered."
+        }
+      }
+    },
+    "conversation_opened": {
+      "description": "A match's conversation was opened (metadata only).",
+      "attributes": {
+        "matchId": {
+          "type": "string",
+          "description": "Opaque match id.",
+          "required": true,
+          "maxLength": 256
+        },
+        "unreadCount": {
+          "type": "number",
+          "description": "Unread messages at open.",
+          "min": 0
+        },
+        "msSinceLastMessage": {
+          "type": "number",
+          "description": "Ms since the last message.",
+          "min": 0
+        }
+      }
+    },
+    "compose_abandoned": {
+      "description": "The message composer was left without sending.",
+      "attributes": {
+        "matchId": {
+          "type": "string",
+          "description": "Opaque match id.",
+          "required": true,
+          "maxLength": 256
+        },
+        "composeDurationMs": {
+          "type": "number",
+          "description": "Milliseconds the composer was open.",
+          "min": 0,
+          "max": 3600000,
+          "invalidReason": "compose_duration_out_of_range"
+        },
+        "hadDraft": {
+          "type": "boolean",
+          "description": "Whether any text had been entered."
+        }
+      }
+    },
+    "profile_revisit": {
+      "description": "A candidate's / match's profile was re-opened.",
+      "attributes": {
+        "viewedUserId": {
+          "type": "string",
+          "description": "Opaque profile id.",
+          "required": true,
+          "maxLength": 256
+        },
+        "context": {
+          "type": "string",
+          "enum": "ViewableScreen",
+          "dropInvalid": true,
+          "description": "Screen the signal happened on."
+        }
+      }
+    },
+    "hooked_state_view": {
+      "description": "Reaction to the hooked (one connection at a time) overlay.",
+      "attributes": {
+        "action": {
+          "type": "string",
+          "enum": "HookedStateAction",
+          "dropInvalid": true,
+          "description": "Reaction.",
+          "invalidReason": "bad_action"
+        }
+      }
+    },
+    "likes_you_view": {
+      "description": "Engagement with Likes You.",
+      "attributes": {
+        "count": {
+          "type": "number",
+          "description": "Likes shown.",
+          "min": 0
+        },
+        "index": {
+          "type": "number",
+          "description": "Position engaged with.",
+          "min": 0
+        }
+      }
+    },
+    "safety_ui_open": {
+      "description": "Unmatch / block / report UI opened (intent only).",
+      "attributes": {
+        "action": {
+          "type": "string",
+          "enum": "SafetyAction",
+          "required": true,
+          "description": "Safety intent.",
+          "missingReason": "bad_safety_action",
+          "invalidReason": "bad_safety_action"
+        },
+        "abandoned": {
+          "type": "boolean",
+          "description": "Closed without completing."
+        }
+      }
+    }
+  },
+  "hash": "25955dd2f9856888"
+}