@adia-ai/adia-ui-factory 0.8.20 → 0.8.22

package/.claude-plugin/plugin.json

@@ -1,6 +1,6 @@
 {
   "name": "adia-factory",
-  "version": "0.8.20",
+  "version": "0.8.22",
   "description": "Author and verify apps built ON the adia-ui (@adia-ai) light-DOM web-component framework \u2014 orient, scaffold, compose, wire, verify, and migrate across SPA and SSR rendering modes. Wires the a2ui MCP for catalog retrieval, UI generation, and validation.",
   "author": {
     "name": "Kim",

package/.mcp.json

@@ -2,7 +2,7 @@
   "mcpServers": {
     "a2ui": {
       "command": "npx",
-      "args": ["-y", "@adia-ai/a2ui-mcp@0.8.20"]
+      "args": ["-y", "@adia-ai/a2ui-mcp@0.8.22"]
     }
   }
 }

package/CHANGELOG.md

@@ -1,5 +1,18 @@
 # Changelog — adia-factory
 
+## [0.8.22] — 2026-07-29
+
+### Maintenance
+- **Lockstep version bump only.** No source changes in this package; bumped to maintain the 11-package version coherence enforced by `scripts/release/check-lockstep.mjs`. Substantive v0.8.22 work shipped in select-ui aria-selected action-row fix, combobox radio indicator, form-popover summary hardening, resumable release Step 10. See `packages/web-components/CHANGELOG.md#0822--2026-07-29` for details.
+- **`.claude-plugin/plugin.json` version bump** — moves in lockstep with package.json (the `/plugin update` cache key).
+
+## [0.8.21] — 2026-07-28
+
+### Maintenance
+- **Lockstep version bump only.** No source changes in this package; bumped to maintain the 11-package version coherence enforced by `scripts/release/check-lockstep.mjs`. Substantive v0.8.21 work shipped in card/table/select/form-popover fixes from adia-v2 adoption + three drift gates (gh#473, gh#425, gh#435). See `packages/web-components/CHANGELOG.md#0821--2026-07-28` for details.
+- **`.claude-plugin/plugin.json` version bump** — moves in lockstep with package.json (the `/plugin update` cache key).
+- **`skills/` touched in this release window** (1 file(s), e.g. `references/pattern-index.md`) — carried by the entries above.
+
 ## [0.8.20] — 2026-07-28
 
 ### Maintenance

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@adia-ai/adia-ui-factory",
-  "version": "0.8.20",
+  "version": "0.8.22",
   "description": "Author and verify apps built ON the adia-ui (@adia-ai) light-DOM web-component framework \u2014 orient, scaffold, compose, wire, verify, and migrate across SPA and SSR rendering modes. Wires the a2ui MCP for catalog retrieval, UI generation, and validation.",
   "keywords": [
     "adia-ui",

package/skills/adia-patterns/references/pattern-index.md

@@ -113,7 +113,7 @@
   - source: `/packages/web-components/patterns/overview/overview.examples.html` · demo: `/packages/web-components/patterns/overview/overview.html` · docs: `/site/patterns/overview`
 - **Admin Sidebar** (Patterns) — The admin left rail — workspace + user switchers over a nav tree, with grouped, divided, sub-nav, and sign-in variants.
   - keywords: side rail, workspace switcher, account menu, left nav, rail
-  - components: `nav-item-ui` `admin-shell` `admin-sidebar` `admin-entity-item` `admin-topbar` `nav-ui` `section-ui` `admin-statusbar` `code-ui` `nav-group-ui` `select-ui` `tag-ui`
+  - components: `nav-item-ui` `admin-shell` `admin-sidebar` `adia-mark-ui` `admin-entity-item` `admin-topbar` `nav-ui` `section-ui` `admin-statusbar` `code-ui` `nav-group-ui` `select-ui`
   - source: `/site/pages/patterns/admin-sidebar.html` · docs: `/site/patterns/admin-sidebar`
 - **App Nav** (Patterns) — Sidebar navigation tree — grouped collapsible items, dividers, section labels, badges, and popover flyouts when collapsed.
   - keywords: menu tree, side rail, groups, flyout, collapsible menu
@@ -272,11 +272,11 @@
 
 - **Sign In** (Authentication) — Email-entry sign-in card with social/SSO provider buttons — reach for it as the first login step before a password or one-time code is asked.
   - keywords: login, authenticate, credentials, social-login, email-entry
-  - components: `button-ui` `col-ui` `text-ui` `card-ui` `divider-ui` `image-ui` `input-ui`
+  - components: `button-ui` `col-ui` `text-ui` `adia-mark-ui` `card-ui` `divider-ui` `input-ui`
   - source: `/apps/user-flow/app/auth/sign-in/sign-in.contents.html` · demo: `/apps/user-flow/app/auth/sign-in/sign-in.html` · docs: `/site/examples/auth/sign-in`
 - **Password** (Authentication) — Password-entry sign-in step for a known email — reach for it after the email step to collect the password, with magic-link/OTP fallbacks.
   - keywords: login, credentials, signin, passphrase, remember-me
-  - components: `col-ui` `button-ui` `text-ui` `card-ui` `check-ui` `divider-ui` `image-ui` `input-ui` `row-ui`
+  - components: `col-ui` `button-ui` `text-ui` `adia-mark-ui` `card-ui` `check-ui` `divider-ui` `input-ui` `row-ui`
   - source: `/apps/user-flow/app/auth/sign-in/password/password.contents.html` · demo: `/apps/user-flow/app/auth/sign-in/password/password.html` · docs: `/site/examples/auth/sign-in/password`
 - **Magic Link Sent** (Authentication) — Passwordless check-your-email confirmation after a sign-in link is emailed — reach for it to confirm a one-time login link was sent.
   - keywords: passwordless, check-email, confirmation, resend, inbox
@@ -284,55 +284,55 @@
   - source: `/apps/user-flow/app/auth/sign-in/magic-link/sent/sent.contents.html` · demo: `/apps/user-flow/app/auth/sign-in/magic-link/sent/sent.html` · docs: `/site/examples/auth/sign-in/magic-link/sent`
 - **OTP Verify** (Authentication) — 6-digit one-time-code entry for passwordless sign-in or 2nd factor — reach for it when the user types a code sent by email or SMS.
   - keywords: passcode, one-time-code, 2fa, sms-code, totp
-  - components: `text-ui` `col-ui` `card-ui` `image-ui` `otp-input-ui`
+  - components: `text-ui` `col-ui` `adia-mark-ui` `card-ui` `otp-input-ui`
   - source: `/apps/user-flow/app/auth/sign-in/otp/verify/verify.contents.html` · demo: `/apps/user-flow/app/auth/sign-in/otp/verify/verify.html` · docs: `/site/examples/auth/sign-in/otp/verify`
 - **MFA** (Authentication) — Two-factor challenge after the password succeeds — reach for it to collect the authenticator TOTP code as a second factor during sign-in.
   - keywords: two-factor, 2fa, authenticator, totp, second-factor
-  - components: `col-ui` `text-ui` `button-ui` `card-ui` `divider-ui` `image-ui` `otp-input-ui`
+  - components: `col-ui` `text-ui` `button-ui` `adia-mark-ui` `card-ui` `divider-ui` `otp-input-ui`
   - source: `/apps/user-flow/app/auth/sign-in/mfa/mfa.contents.html` · demo: `/apps/user-flow/app/auth/sign-in/mfa/mfa.html` · docs: `/site/examples/auth/sign-in/mfa`
 - **MFA Recovery** (Authentication) — Backup-code entry when the authenticator is unavailable — reach for it as the 2FA fallback to sign in with a saved recovery code.
   - keywords: backup-code, 2fa-fallback, lost-device, authenticator, security-key
-  - components: `col-ui` `text-ui` `alert-ui` `button-ui` `card-ui` `image-ui` `input-ui`
+  - components: `col-ui` `text-ui` `adia-mark-ui` `alert-ui` `button-ui` `card-ui` `input-ui`
   - source: `/apps/user-flow/app/auth/sign-in/mfa/recovery/recovery.contents.html` · demo: `/apps/user-flow/app/auth/sign-in/mfa/recovery/recovery.html` · docs: `/site/examples/auth/sign-in/mfa/recovery`
 - **Sign Up** (Authentication) — New-account registration card: email plus social provider buttons — reach for it as the first step to create an account.
   - keywords: register, create-account, registration, oauth, social-login
-  - components: `col-ui` `button-ui` `text-ui` `card-ui` `divider-ui` `image-ui` `input-ui`
+  - components: `col-ui` `button-ui` `text-ui` `adia-mark-ui` `card-ui` `divider-ui` `input-ui`
   - source: `/apps/user-flow/app/auth/sign-up/sign-up.contents.html` · demo: `/apps/user-flow/app/auth/sign-up/sign-up.html` · docs: `/site/examples/auth/sign-up`
 - **Verify** (Authentication) — Sign-up email verification — enter the 6-digit code sent to activate a new account, right after registering.
   - keywords: confirm-email, activation, otp, code-entry, six-digit
-  - components: `col-ui` `text-ui` `alert-ui` `card-ui` `image-ui` `otp-input-ui`
+  - components: `col-ui` `text-ui` `adia-mark-ui` `alert-ui` `card-ui` `otp-input-ui`
   - source: `/apps/user-flow/app/auth/sign-up/verify/verify.contents.html` · demo: `/apps/user-flow/app/auth/sign-up/verify/verify.html` · docs: `/site/examples/auth/sign-up/verify`
 - **MFA Setup** (Authentication) — Two-factor enrollment — scan the authenticator QR and confirm a TOTP code to enable 2FA during sign-up or from settings.
   - keywords: two-factor, 2fa, enrollment, qr-code, totp
-  - components: `col-ui` `text-ui` `alert-ui` `button-ui` `card-ui` `icon-ui` `image-ui` `otp-input-ui`
+  - components: `col-ui` `text-ui` `adia-mark-ui` `alert-ui` `button-ui` `card-ui` `icon-ui` `otp-input-ui`
   - source: `/apps/user-flow/app/auth/sign-up/mfa-setup/mfa-setup.contents.html` · demo: `/apps/user-flow/app/auth/sign-up/mfa-setup/mfa-setup.html` · docs: `/site/examples/auth/sign-up/mfa-setup`
 - **SSO Only** (Authentication) — SSO-required notice when password sign-up is disabled for a domain — reach for it to route enterprise users to their identity provider.
   - keywords: single-sign-on, enterprise, saml, identity-provider, okta
-  - components: `col-ui` `button-ui` `text-ui` `alert-ui` `card-ui` `image-ui`
+  - components: `col-ui` `button-ui` `text-ui` `adia-mark-ui` `alert-ui` `card-ui`
   - source: `/apps/user-flow/app/auth/sign-up/sso-only/sso-only.contents.html` · demo: `/apps/user-flow/app/auth/sign-up/sso-only/sso-only.html` · docs: `/site/examples/auth/sign-up/sso-only`
 - **Forgot Password** (Authentication) — Password-recovery start: enter your email to receive a reset link — reach for it as the first step of the forgot-password flow.
   - keywords: reset, recovery, request-link, account-recovery, email-entry
-  - components: `col-ui` `text-ui` `button-ui` `card-ui` `image-ui` `input-ui`
+  - components: `col-ui` `text-ui` `adia-mark-ui` `button-ui` `card-ui` `input-ui`
   - source: `/apps/user-flow/app/auth/forgot-password/forgot-password.contents.html` · demo: `/apps/user-flow/app/auth/forgot-password/forgot-password.html` · docs: `/site/examples/auth/forgot-password`
 - **Reset Link Sent** (Authentication) — Confirmation that a password-reset email went out — reach for it after the forgot-password step to say check your inbox.
   - keywords: check-email, recovery, confirmation, inbox, resend
-  - components: `col-ui` `text-ui` `alert-ui` `button-ui` `card-ui` `image-ui`
+  - components: `col-ui` `text-ui` `adia-mark-ui` `alert-ui` `button-ui` `card-ui`
   - source: `/apps/user-flow/app/auth/forgot-password/sent/sent.contents.html` · demo: `/apps/user-flow/app/auth/forgot-password/sent/sent.html` · docs: `/site/examples/auth/forgot-password/sent`
 - **Reset Password** (Authentication) — New-password form with confirm field, reached via the reset link — the final step where the user chooses a new password.
   - keywords: change-credentials, confirm, recovery, strength, choose-new
-  - components: `col-ui` `input-ui` `text-ui` `button-ui` `card-ui` `image-ui`
+  - components: `col-ui` `input-ui` `text-ui` `adia-mark-ui` `button-ui` `card-ui`
   - source: `/apps/user-flow/app/auth/reset-password/reset-password.contents.html` · demo: `/apps/user-flow/app/auth/reset-password/reset-password.html` · docs: `/site/examples/auth/reset-password`
 - **Account Locked** (Authentication) — Locked-out notice after too many failed sign-ins — reach for it to explain the lockout and offer reset/backup-code/support options.
   - keywords: lockout, failed-attempts, blocked, rate-limit, security
-  - components: `button-ui` `col-ui` `alert-ui` `card-ui` `image-ui` `text-ui`
+  - components: `button-ui` `col-ui` `adia-mark-ui` `alert-ui` `card-ui` `text-ui`
   - source: `/apps/user-flow/app/auth/account-locked/account-locked.contents.html` · demo: `/apps/user-flow/app/auth/account-locked/account-locked.html` · docs: `/site/examples/auth/account-locked`
 - **Link Expired** (Authentication) — Expired or used magic/reset link notice with a re-send email form — reach for it when a one-time link is no longer valid.
   - keywords: invalid, stale, resend, one-time, request-new
-  - components: `col-ui` `alert-ui` `button-ui` `card-ui` `image-ui` `input-ui` `text-ui`
+  - components: `col-ui` `adia-mark-ui` `alert-ui` `button-ui` `card-ui` `input-ui` `text-ui`
   - source: `/apps/user-flow/app/auth/link-expired/link-expired.contents.html` · demo: `/apps/user-flow/app/auth/link-expired/link-expired.html` · docs: `/site/examples/auth/link-expired`
 - **Accept Invite** (Authentication) — Team-invite landing with inviter, workspace, and accept/decline — reach for it when a user opens an invitation to join a workspace.
   - keywords: team, workspace, join, membership, decline
-  - components: `text-ui` `col-ui` `button-ui` `card-ui` `avatar-ui` `image-ui` `row-ui`
+  - components: `text-ui` `col-ui` `button-ui` `card-ui` `adia-mark-ui` `avatar-ui` `row-ui`
   - source: `/apps/user-flow/app/auth/accept-invite/accept-invite.contents.html` · demo: `/apps/user-flow/app/auth/accept-invite/accept-invite.html` · docs: `/site/examples/auth/accept-invite`
 - **OAuth Callback** (Authentication) — OAuth/SSO interstitial loading state while the provider redirect completes — reach for it to hold the user during the sign-in handoff.
   - keywords: loading, redirect, sso, interstitial, provider
@@ -340,23 +340,23 @@
   - source: `/apps/user-flow/app/auth/oauth/callback/callback.contents.html` · demo: `/apps/user-flow/app/auth/oauth/callback/callback.html` · docs: `/site/examples/auth/oauth/callback`
 - **Email Change** (Authentication) — Confirm-new-email step for an address change — reach for it to have the user approve switching their sign-in email to a new address.
   - keywords: update-address, confirm, new-address, verify, security
-  - components: `col-ui` `text-ui` `button-ui` `card-ui` `image-ui`
+  - components: `col-ui` `text-ui` `adia-mark-ui` `button-ui` `card-ui`
   - source: `/apps/user-flow/app/auth/email-change/verify/verify.contents.html` · demo: `/apps/user-flow/app/auth/email-change/verify/verify.html` · docs: `/site/examples/auth/email-change/verify`
 - **Sign Out** (Authentication) — Signed-out confirmation after a session ends — reach for it as the post-logout landing offering sign-back-in or switch-account.
   - keywords: logout, session-end, goodbye, log-off, post-logout
-  - components: `col-ui` `button-ui` `text-ui` `card-ui` `image-ui`
+  - components: `col-ui` `button-ui` `text-ui` `adia-mark-ui` `card-ui`
   - source: `/apps/user-flow/app/auth/sign-out/sign-out.contents.html` · demo: `/apps/user-flow/app/auth/sign-out/sign-out.html` · docs: `/site/examples/auth/sign-out`
 - **Session Expired** (Authentication) — Session-timeout notice after inactivity with a sign-back-in prompt — reach for it to re-authenticate a user whose session lapsed.
   - keywords: timeout, inactivity, re-login, re-authenticate, idle
-  - components: `col-ui` `button-ui` `alert-ui` `card-ui` `image-ui` `text-ui`
+  - components: `col-ui` `button-ui` `adia-mark-ui` `alert-ui` `card-ui` `text-ui`
   - source: `/apps/user-flow/app/auth/session-expired/session-expired.contents.html` · demo: `/apps/user-flow/app/auth/session-expired/session-expired.html` · docs: `/site/examples/auth/session-expired`
 - **Forbidden** (Authentication) — 403 access-denied page when an account lacks permission — reach for it for a no-access state offering switch-account or request-access.
   - keywords: 403, access-denied, permission, no-access, unauthorized
-  - components: `button-ui` `col-ui` `alert-ui` `card-ui` `image-ui` `text-ui`
+  - components: `button-ui` `col-ui` `adia-mark-ui` `alert-ui` `card-ui` `text-ui`
   - source: `/apps/user-flow/app/auth/forbidden/forbidden.contents.html` · demo: `/apps/user-flow/app/auth/forbidden/forbidden.html` · docs: `/site/examples/auth/forbidden`
 - **Account Deleted** (Authentication) — Account-deletion confirmation with an undo window — reach for it after deletion to show the recovery deadline and recover-account action.
   - keywords: removal, closed, undo, recover, grace-period
-  - components: `col-ui` `button-ui` `alert-ui` `card-ui` `image-ui` `text-ui`
+  - components: `col-ui` `button-ui` `adia-mark-ui` `alert-ui` `card-ui` `text-ui`
   - source: `/apps/user-flow/app/auth/account-deleted/account-deleted.contents.html` · demo: `/apps/user-flow/app/auth/account-deleted/account-deleted.html` · docs: `/site/examples/auth/account-deleted`
 
 ### dashboard
@@ -485,27 +485,27 @@
 
 - **Profile** (Authentication) — First-run profile setup: collect full name and display name/handle — reach for it after account creation to personalize a new account.
   - keywords: onboarding, display-name, avatar, personalize, first-run
-  - components: `col-ui` `input-ui` `text-ui` `button-ui` `card-ui` `image-ui`
+  - components: `col-ui` `input-ui` `text-ui` `adia-mark-ui` `button-ui` `card-ui`
   - source: `/apps/user-flow/app/auth/sign-up/profile/profile.contents.html` · demo: `/apps/user-flow/app/auth/sign-up/profile/profile.html` · docs: `/site/examples/auth/sign-up/profile`
 - **Welcome** (Onboarding) — Welcome splash greeting the new user with a start CTA; reach for it as the opening screen of a product onboarding flow.
   - keywords: intro, greeting, start, splash, get-started
-  - components: `text-ui` `icon-ui` `button-ui` `image-ui` `step-progress-ui`
+  - components: `text-ui` `icon-ui` `adia-mark-ui` `button-ui` `step-progress-ui`
   - source: `/apps/user-flow/app/onboarding/welcome/welcome.contents.html` · demo: `/apps/user-flow/app/onboarding/welcome/welcome.html` · docs: `/site/examples/onboarding/welcome`
 - **Mode** (Onboarding) — 'How will you use it' onboarding step — pick a usage mode/persona via cards; reach for it as the mode/persona-selection step of onboarding.
   - keywords: usage, persona, workflow, choice, path
-  - components: `option-card-ui` `text-ui` `button-ui` `image-ui` `step-progress-ui`
+  - components: `option-card-ui` `text-ui` `adia-mark-ui` `button-ui` `step-progress-ui`
   - source: `/apps/user-flow/app/onboarding/mode/mode.contents.html` · demo: `/apps/user-flow/app/onboarding/mode/mode.html` · docs: `/site/examples/onboarding/mode`
 - **Connect Source** (Onboarding) — 'Connect your first source' onboarding step — link an initial data source; reach for it as the first-connection step of product onboarding.
   - keywords: integration, link, data, provider, first
-  - components: `option-card-ui` `text-ui` `alert-ui` `button-ui` `image-ui` `step-progress-ui`
+  - components: `option-card-ui` `text-ui` `adia-mark-ui` `alert-ui` `button-ui` `step-progress-ui`
   - source: `/apps/user-flow/app/onboarding/connect-source/connect-source.contents.html` · demo: `/apps/user-flow/app/onboarding/connect-source/connect-source.html` · docs: `/site/examples/onboarding/connect-source`
 - **Import Data** (Onboarding) — 'Bring your data' onboarding step — upload or import records after connecting a source; reach for it as the data-import step of onboarding.
   - keywords: upload, migrate, csv, records, load
-  - components: `option-card-ui` `text-ui` `button-ui` `image-ui` `step-progress-ui`
+  - components: `option-card-ui` `text-ui` `adia-mark-ui` `button-ui` `step-progress-ui`
   - source: `/apps/user-flow/app/onboarding/import-data/import-data.contents.html` · demo: `/apps/user-flow/app/onboarding/import-data/import-data.html` · docs: `/site/examples/onboarding/import-data`
 - **First Action** (Onboarding) — 'Your first dashboard' onboarding step — guides one core action; reach for it as the activation/aha-moment step of product onboarding.
   - keywords: activation, aha, guide, task, milestone
-  - components: `text-ui` `button-ui` `field-ui` `image-ui` `input-ui` `step-progress-ui`
+  - components: `text-ui` `button-ui` `adia-mark-ui` `field-ui` `input-ui` `step-progress-ui`
   - source: `/apps/user-flow/app/onboarding/first-action/first-action.contents.html` · demo: `/apps/user-flow/app/onboarding/first-action/first-action.html` · docs: `/site/examples/onboarding/first-action`
 - **Review** (Onboarding) — 'Review your setup' onboarding step — summary of choices before finishing; reach for it as the pre-completion review step of onboarding.
   - keywords: summary, confirm, recap, verify, overview
@@ -513,19 +513,19 @@
   - source: `/apps/user-flow/app/onboarding/review/review.contents.html` · demo: `/apps/user-flow/app/onboarding/review/review.html` · docs: `/site/examples/onboarding/review`
 - **Notifications** (Onboarding) — Notification-preferences onboarding step — toggles for email and push channels; reach for it as the alert opt-in step of product onboarding.
   - keywords: preferences, alerts, email, push, opt-in
-  - components: `option-card-ui` `text-ui` `button-ui` `col-ui` `image-ui` `step-progress-ui`
+  - components: `option-card-ui` `text-ui` `adia-mark-ui` `button-ui` `col-ui` `step-progress-ui`
   - source: `/apps/user-flow/app/onboarding/notification-prefs/notification-prefs.contents.html` · demo: `/apps/user-flow/app/onboarding/notification-prefs/notification-prefs.html` · docs: `/site/examples/onboarding/notification-prefs`
 - **Mobile App** (Onboarding) — 'Get the mobile app' onboarding step — QR and app-store links to install the companion app; reach for it as the mobile-install promo step.
   - keywords: download, ios, android, qr, install
-  - components: `text-ui` `button-ui` `field-ui` `icon-ui` `image-ui` `input-ui` `step-progress-ui`
+  - components: `text-ui` `button-ui` `adia-mark-ui` `field-ui` `icon-ui` `input-ui` `step-progress-ui`
   - source: `/apps/user-flow/app/onboarding/mobile-app/mobile-app.contents.html` · demo: `/apps/user-flow/app/onboarding/mobile-app/mobile-app.html` · docs: `/site/examples/onboarding/mobile-app`
 - **Browser Extension** (Onboarding) — 'Browser extension' onboarding step — prompts installing the browser add-on; reach for it as the extension-install promo step of onboarding.
   - keywords: chrome, addon, plugin, install, toolbar
-  - components: `text-ui` `icon-ui` `button-ui` `kbd-ui` `image-ui` `step-progress-ui`
+  - components: `text-ui` `icon-ui` `button-ui` `kbd-ui` `adia-mark-ui` `step-progress-ui`
   - source: `/apps/user-flow/app/onboarding/browser-extension/browser-extension.contents.html` · demo: `/apps/user-flow/app/onboarding/browser-extension/browser-extension.html` · docs: `/site/examples/onboarding/browser-extension`
 - **Complete** (Onboarding) — 'All set' final onboarding screen — completion card launching the user into the product; reach for it as the terminal screen of onboarding.
   - keywords: done, finished, all-set, ready, launch
-  - components: `timeline-item-ui` `kbd-ui` `text-ui` `alert-ui` `button-ui` `image-ui` `step-progress-ui` `timeline-ui`
+  - components: `timeline-item-ui` `kbd-ui` `text-ui` `adia-mark-ui` `alert-ui` `button-ui` `step-progress-ui` `timeline-ui`
   - source: `/apps/user-flow/app/onboarding/complete/complete.contents.html` · demo: `/apps/user-flow/app/onboarding/complete/complete.html` · docs: `/site/examples/onboarding/complete`
 
 ### overlays
@@ -547,63 +547,63 @@
 
 - **Workspace** (Registration) — Name-your-workspace signup step — one name field with step progress; reach for it as the workspace-creation step of a registration wizard.
   - keywords: signup, organization, create, tenant, name
-  - components: `field-ui` `input-ui` `text-ui` `button-ui` `image-ui` `step-progress-ui`
+  - components: `field-ui` `input-ui` `text-ui` `adia-mark-ui` `button-ui` `step-progress-ui`
   - source: `/apps/user-flow/app/registration/workspace/workspace.contents.html` · demo: `/apps/user-flow/app/registration/workspace/workspace.html` · docs: `/site/examples/registration/workspace`
 - **Profile** (Registration) — Tell-us-about-you signup step — avatar upload plus name fields; reach for it as the personal-details step of a registration wizard.
   - keywords: signup, avatar, name, personal, about-you
-  - components: `field-ui` `text-ui` `input-ui` `avatar-ui` `button-ui` `col-ui` `image-ui` `row-ui` `step-progress-ui` `upload-ui`
+  - components: `field-ui` `text-ui` `input-ui` `adia-mark-ui` `avatar-ui` `button-ui` `col-ui` `row-ui` `step-progress-ui` `upload-ui`
   - source: `/apps/user-flow/app/registration/profile/profile.contents.html` · demo: `/apps/user-flow/app/registration/profile/profile.html` · docs: `/site/examples/registration/profile`
 - **Use case** (Registration) — 'What brings you here?' signup step — option-card picker plus free-text; reach for it as the goal/intent-selection step of a signup wizard.
   - keywords: purpose, goal, intent, reason, segmentation
-  - components: `option-card-ui` `text-ui` `button-ui` `col-ui` `image-ui` `step-progress-ui` `textarea-ui`
+  - components: `option-card-ui` `text-ui` `adia-mark-ui` `button-ui` `col-ui` `step-progress-ui` `textarea-ui`
   - source: `/apps/user-flow/app/registration/use-case/use-case.contents.html` · demo: `/apps/user-flow/app/registration/use-case/use-case.html` · docs: `/site/examples/registration/use-case`
 - **Team size** (Registration) — Team-size picker signup step — segmented control plus headcount select; reach for it as the company-size segmentation step of signup.
   - keywords: headcount, company, employees, seats, scale
-  - components: `avatar-ui` `segment-ui` `field-ui` `button-ui` `image-ui` `row-ui` `segmented-ui` `select-ui` `step-progress-ui` `text-ui`
+  - components: `avatar-ui` `segment-ui` `field-ui` `adia-mark-ui` `button-ui` `row-ui` `segmented-ui` `select-ui` `step-progress-ui` `text-ui`
   - source: `/apps/user-flow/app/registration/team-size/team-size.contents.html` · demo: `/apps/user-flow/app/registration/team-size/team-size.html` · docs: `/site/examples/registration/team-size`
 - **Invite** (Registration) — Invite-teammates signup step — email input, role select, pending-invite cards; reach for it as the seat-invitation step of signup.
   - keywords: teammates, email, seats, colleagues, members
-  - components: `field-ui` `button-ui` `input-ui` `select-ui` `text-ui` `alert-ui` `avatar-ui` `card-ui` `image-ui` `step-progress-ui`
+  - components: `field-ui` `button-ui` `input-ui` `select-ui` `text-ui` `adia-mark-ui` `alert-ui` `avatar-ui` `card-ui` `step-progress-ui`
   - source: `/apps/user-flow/app/registration/invite/invite.contents.html` · demo: `/apps/user-flow/app/registration/invite/invite.html` · docs: `/site/examples/registration/invite`
 - **Integrations** (Registration) — 'Connect your stack' signup step — grid of toggleable integration cards; reach for it as the optional tool-connection step during signup.
   - keywords: connect, apps, stack, tools, services
-  - components: `text-ui` `card-ui` `icon-ui` `switch-ui` `button-ui` `grid-ui` `image-ui` `step-progress-ui`
+  - components: `text-ui` `card-ui` `icon-ui` `switch-ui` `adia-mark-ui` `button-ui` `grid-ui` `step-progress-ui`
   - source: `/apps/user-flow/app/registration/integrations/integrations.contents.html` · demo: `/apps/user-flow/app/registration/integrations/integrations.html` · docs: `/site/examples/registration/integrations`
 - **Import** (Registration) — 'Bring your data' signup step — source select plus file upload with format tags; reach for it as the data-import step during registration.
   - keywords: data, upload, migrate, csv, source
-  - components: `tag-ui` `button-ui` `field-ui` `text-ui` `alert-ui` `col-ui` `image-ui` `row-ui` `select-ui` `step-progress-ui` `upload-ui`
+  - components: `tag-ui` `button-ui` `field-ui` `text-ui` `adia-mark-ui` `alert-ui` `col-ui` `row-ui` `select-ui` `step-progress-ui` `upload-ui`
   - source: `/apps/user-flow/app/registration/import/import.contents.html` · demo: `/apps/user-flow/app/registration/import/import.html` · docs: `/site/examples/registration/import`
 - **Plan** (Registration) — Choose-a-plan signup step — option-card pricing tiers with badges; reach for it as the plan-selection step of a signup or upgrade wizard.
   - keywords: pricing, tier, subscription, package, select
-  - components: `text-ui` `row-ui` `col-ui` `option-card-ui` `badge-ui` `icon-ui` `button-ui` `image-ui` `step-progress-ui` `textarea-ui`
+  - components: `text-ui` `row-ui` `col-ui` `option-card-ui` `badge-ui` `icon-ui` `adia-mark-ui` `button-ui` `step-progress-ui` `textarea-ui`
   - source: `/apps/user-flow/app/registration/plan/plan.contents.html` · demo: `/apps/user-flow/app/registration/plan/plan.html` · docs: `/site/examples/registration/plan`
 - **Billing** (Registration) — Billing-details signup step — card and payment fields with step progress; reach for it as the payment-capture step of registration checkout.
   - keywords: payment, card, credit-card, checkout, pay
-  - components: `input-ui` `field-ui` `row-ui` `text-ui` `icon-ui` `button-ui` `col-ui` `divider-ui` `image-ui` `select-ui` `step-progress-ui`
+  - components: `input-ui` `field-ui` `row-ui` `text-ui` `icon-ui` `adia-mark-ui` `button-ui` `col-ui` `divider-ui` `select-ui` `step-progress-ui`
   - source: `/apps/user-flow/app/registration/billing/billing.contents.html` · demo: `/apps/user-flow/app/registration/billing/billing.html` · docs: `/site/examples/registration/billing`
 - **Confirmation** (Registration) — 'You're all set' signup confirmation — success card summarizing the new account; reach for it as a completion screen of a signup wizard.
   - keywords: success, done, complete, welcome, finished
-  - components: `text-ui` `button-ui` `avatar-ui` `card-ui` `col-ui` `icon-ui` `image-ui` `row-ui` `step-progress-ui`
+  - components: `text-ui` `button-ui` `avatar-ui` `card-ui` `adia-mark-ui` `col-ui` `icon-ui` `row-ui` `step-progress-ui`
   - source: `/apps/user-flow/app/registration/confirmation/confirmation.contents.html` · demo: `/apps/user-flow/app/registration/confirmation/confirmation.html` · docs: `/site/examples/registration/confirmation`
 - **Legal** (Registration) — Legal & tax-details signup step — entity fields, country select, consent checks; reach for it as the compliance step of a signup wizard.
   - keywords: tax, terms, consent, compliance, vat
-  - components: `field-ui` `input-ui` `select-ui` `text-ui` `button-ui` `check-ui` `image-ui` `step-progress-ui`
+  - components: `field-ui` `input-ui` `select-ui` `text-ui` `adia-mark-ui` `button-ui` `check-ui` `step-progress-ui`
   - source: `/apps/user-flow/app/registration/legal/legal.contents.html` · demo: `/apps/user-flow/app/registration/legal/legal.html` · docs: `/site/examples/registration/legal`
 - **Address** (Registration) — Business-address signup step — street/city/country fields; reach for it as the address-capture step of registration or checkout.
   - keywords: location, street, city, country, mailing
-  - components: `field-ui` `input-ui` `text-ui` `row-ui` `select-ui` `check-ui` `alert-ui` `button-ui` `divider-ui` `image-ui` `step-progress-ui` `textarea-ui`
+  - components: `field-ui` `input-ui` `text-ui` `row-ui` `select-ui` `check-ui` `adia-mark-ui` `alert-ui` `button-ui` `divider-ui` `step-progress-ui` `textarea-ui`
   - source: `/apps/user-flow/app/registration/address/address.contents.html` · demo: `/apps/user-flow/app/registration/address/address.html` · docs: `/site/examples/registration/address`
 - **Brand scrape** (Registration) — 'Pull your brand' signup step — URL input that fetches logo/colors into preview cards; reach for it as the auto-brand-import step of signup.
   - keywords: logo, colors, website, url, theme
-  - components: `text-ui` `button-ui` `row-ui` `avatar-ui` `badge-ui` `card-ui` `icon-ui` `check-ui` `col-ui` `field-ui` `image-ui` `input-ui`
+  - components: `text-ui` `button-ui` `row-ui` `avatar-ui` `badge-ui` `card-ui` `icon-ui` `adia-mark-ui` `check-ui` `col-ui` `field-ui` `input-ui`
   - source: `/apps/user-flow/app/registration/brand-scrape/brand-scrape.contents.html` · demo: `/apps/user-flow/app/registration/brand-scrape/brand-scrape.html` · docs: `/site/examples/registration/brand-scrape`
 - **Support** (Registration) — Customer-support setup signup step — configure help channels and contacts; reach for it as an optional support-setup step of registration.
   - keywords: help, contact, channels, desk, service
-  - components: `text-ui` `card-ui` `icon-ui` `switch-ui` `field-ui` `segment-ui` `input-ui` `alert-ui` `button-ui` `check-ui` `col-ui` `divider-ui`
+  - components: `text-ui` `card-ui` `icon-ui` `switch-ui` `field-ui` `segment-ui` `input-ui` `adia-mark-ui` `alert-ui` `button-ui` `check-ui` `col-ui`
   - source: `/apps/user-flow/app/registration/support/support.contents.html` · demo: `/apps/user-flow/app/registration/support/support.html` · docs: `/site/examples/registration/support`
 - **Departments** (Registration) — 'Set up your departments' signup step — add and name org departments; reach for it as the org-structure step of a multi-team registration.
   - keywords: teams, org, divisions, groups, units
-  - components: `check-ui` `text-ui` `button-ui` `row-ui` `tag-ui` `alert-ui` `col-ui` `divider-ui` `field-ui` `grid-ui` `image-ui` `input-ui`
+  - components: `check-ui` `text-ui` `button-ui` `row-ui` `tag-ui` `adia-mark-ui` `alert-ui` `col-ui` `divider-ui` `field-ui` `grid-ui` `input-ui`
   - source: `/apps/user-flow/app/registration/departments/departments.contents.html` · demo: `/apps/user-flow/app/registration/departments/departments.html` · docs: `/site/examples/registration/departments`
 - **Org review** (Registration) — 'Review your org chart' signup step — org-structure summary before finishing; reach for it as the org-confirmation step of registration.
   - keywords: organization, chart, structure, summary, hierarchy
@@ -611,11 +611,11 @@
   - source: `/apps/user-flow/app/registration/org-review/org-review.contents.html` · demo: `/apps/user-flow/app/registration/org-review/org-review.html` · docs: `/site/examples/registration/org-review`
 - **Personal** (Registration) — 'Round out your profile' signup step — extra personal-detail fields; reach for it as a profile-completion step of a registration wizard.
   - keywords: profile, details, bio, about, complete
-  - components: `field-ui` `input-ui` `text-ui` `segment-ui` `select-ui` `divider-ui` `button-ui` `check-ui` `col-ui` `image-ui` `segmented-ui` `step-progress-ui`
+  - components: `field-ui` `input-ui` `text-ui` `segment-ui` `select-ui` `divider-ui` `adia-mark-ui` `button-ui` `check-ui` `col-ui` `segmented-ui` `step-progress-ui`
   - source: `/apps/user-flow/app/registration/personal/personal.contents.html` · demo: `/apps/user-flow/app/registration/personal/personal.html` · docs: `/site/examples/registration/personal`
 - **Done** (Registration) — 'You're fully set up' final registration screen — completion card with next-action CTA; reach for it as a signup flow's terminal screen.
   - keywords: complete, finished, success, ready, all-set
-  - components: `card-ui` `text-ui` `stat-ui` `button-ui` `avatar-ui` `col-ui` `divider-ui` `icon-ui` `image-ui` `step-progress-ui`
+  - components: `card-ui` `text-ui` `stat-ui` `button-ui` `avatar-ui` `adia-mark-ui` `col-ui` `divider-ui` `icon-ui` `step-progress-ui`
   - source: `/apps/user-flow/app/registration/done/done.contents.html` · demo: `/apps/user-flow/app/registration/done/done.html` · docs: `/site/examples/registration/done`
 
 ### settings-page
@@ -645,15 +645,15 @@
 
 - **404 — Not Found** (System) — 404 not-found error page — centered card with a message and a back-home CTA; reach for it as the missing-page or broken-link error surface.
   - keywords: error, missing, broken-link, lost, dead-end
-  - components: `col-ui` `button-ui` `text-ui` `alert-ui` `card-ui` `image-ui`
+  - components: `col-ui` `button-ui` `text-ui` `adia-mark-ui` `alert-ui` `card-ui`
   - source: `/apps/errors/app/404/404.contents.html` · demo: `/apps/errors/app/404/404.html` · docs: `/site/examples/errors/404`
 - **500 — Server Error** (System) — 500 server-error page — centered card explaining an internal failure with a retry CTA; reach for it as the generic server-fault surface.
   - keywords: crash, failure, fault, retry, internal
-  - components: `button-ui` `col-ui` `text-ui` `alert-ui` `card-ui` `image-ui`
+  - components: `button-ui` `col-ui` `text-ui` `adia-mark-ui` `alert-ui` `card-ui`
   - source: `/apps/errors/app/500/500.contents.html` · demo: `/apps/errors/app/500/500.html` · docs: `/site/examples/errors/500`
 - **Maintenance** (System) — Down-for-maintenance page — centered card announcing planned downtime with an ETA; reach for it as the scheduled-outage holding surface.
   - keywords: downtime, outage, offline, scheduled, unavailable
-  - components: `col-ui` `button-ui` `text-ui` `alert-ui` `card-ui` `image-ui`
+  - components: `col-ui` `button-ui` `text-ui` `adia-mark-ui` `alert-ui` `card-ui`
   - source: `/apps/errors/app/maintenance/maintenance.contents.html` · demo: `/apps/errors/app/maintenance/maintenance.html` · docs: `/site/examples/errors/maintenance`
 
 ### trait-composition