@adia-ai/adia-ui-factory 0.8.16 → 0.8.18

package/.claude-plugin/plugin.json

@@ -1,6 +1,6 @@
 {
   "name": "adia-factory",
-  "version": "0.8.16",
+  "version": "0.8.18",
   "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.16"]
+      "args": ["-y", "@adia-ai/a2ui-mcp@0.8.18"]
     }
   }
 }

package/CHANGELOG.md

@@ -1,5 +1,18 @@
 # Changelog — adia-factory
 
+## [0.8.18] — 2026-07-27
+
+### 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.18 work shipped in form-popover-ui rename + 9-test surface + first passing rendered-dom probe (harness repaired for all composites). See `packages/web-modules/CHANGELOG.md#0818--2026-07-27` for details.
+- **`.claude-plugin/plugin.json` version bump** — moves in lockstep with package.json (the `/plugin update` cache key).
+
+## [0.8.17] — 2026-07-27
+
+### 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.17 work shipped in one selection language (radios + tonal + container tier) · form-popover module · check:demo-routes sweep. See `packages/web-components/CHANGELOG.md#0817--2026-07-27` 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** (4 file(s), e.g. `references/annotations.yaml`) — carried by the entries above.
+
 ## [0.8.16] — 2026-07-26
 
 ### Maintenance

package/README.md

@@ -93,6 +93,6 @@ path assumptions — ADR-0040 bare-repo posture).
 
 ---
 
-v0.8.6 — versions move with the `@adia-ai` lockstep (`npm run check:lockstep`);
+Versioned with the `@adia-ai` lockstep (`npm run check:lockstep`) — see `CHANGELOG.md` for the current version;
 content merged between cuts is invisible to the installed plugin cache until
 the next lockstep bump or a manual sync.

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@adia-ai/adia-ui-factory",
-  "version": "0.8.16",
+  "version": "0.8.18",
   "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/annotations.yaml

@@ -989,3 +989,169 @@
     - offline
     - scheduled
     - unavailable
+
+# ── catalog/ui-patterns (Pattern Library section, added 2026-07-27) ──
+"/catalog/ui-patterns/app/agent-activity-feed/agent-activity-feed.html":
+  category: agent-ops
+  intent: "Real-time agent activity feed with timestamped action stream, status pills, and relative-time markers \u2014 functions as a changelog feed showing a versioned history of agent actions, "
+  keywords: ["changelog", "feed", "activity", "timeline", "version", "release", "update", "history", "what's", "new"]
+"/catalog/ui-patterns/app/agent-reasoning-collapsed/agent-reasoning-collapsed.html":
+  category: agent-ops
+  intent: "Collapsible agent reasoning panel showing thought process + tool calls + interim results."
+  keywords: ["agent", "reasoning", "thinking", "thought-process", "tool-calls", "trace", "transparency", "interpretability"]
+"/catalog/ui-patterns/app/api-key-table/api-key-table.html":
+  category: data-table
+  intent: "API keys management table with key name, prefix, created date, last used, and revoke button."
+  keywords: ["api", "key", "management", "table", "generate", "revoke", "token", "secret", "credential", "access"]
+"/catalog/ui-patterns/app/card-grid-images/card-grid-images.html":
+  category: overlays
+  intent: "Image gallery grid with lightbox overlay \u2014 responsive 3-column grid of image cards with cover photo, title, and description."
+  keywords: ["image", "gallery", "grid", "lightbox", "overlay", "card-grid", "image-ui", "media", "photo", "gallery-grid"]
+"/catalog/ui-patterns/app/chat-streaming-surface/chat-streaming-surface.html":
+  category: agent-ops
+  intent: "Chat conversation surface with user + assistant message bubbles + typing indicator + input row."
+  keywords: ["chat", "streaming", "messages", "bubbles", "conversation", "assistant", "user", "typing", "indicator", "input"]
+"/catalog/ui-patterns/app/command-palette/command-palette.html":
+  category: navigation
+  intent: "Command palette with search input, recent commands, and keyboard shortcut hints."
+  keywords: ["command", "palette", "search", "input", "recent", "commands", "keyboard", "shortcut", "hints", "cmdk"]
+"/catalog/ui-patterns/app/conversion-funnel-6step/conversion-funnel-6step.html":
+  category: data-viz
+  intent: "Conversion funnel with 6 stages, stage labels, counts, and drop-off conversion percentages."
+  keywords: ["funnel", "conversion", "analytics", "stages", "metrics", "drop-off", "rate", "marketing"]
+"/catalog/ui-patterns/app/destructive-confirm-modal/destructive-confirm-modal.html":
+  category: overlays
+  intent: "Destructive-action modal dialog with a confirmation form \u2014 resource-name input field, cancel and delete action buttons, warning icon, and irreversible-action prose."
+  keywords: ["modal", "dialog", "form", "confirm", "modal-ui", "button-ui", "destructive", "confirm", "input", "action"]
+"/catalog/ui-patterns/app/editor-code-pane/editor-code-pane.contents.html":
+  category: workflow
+  intent: "Code editor pane with file-tabs header, line-numbered code surface, and status bar footer."
+  keywords: ["editor", "code", "pane", "tabs", "ide", "line-numbers", "syntax-highlighting", "monaco", "codemirror"]
+"/catalog/ui-patterns/app/editor-preview-pane/editor-preview-pane.contents.html":
+  category: workflow
+  intent: "Preview pane rendering the editor's output with toolbar (refresh, viewport, share) and live content area."
+  keywords: ["preview", "render", "editor", "pane", "output", "live-preview", "iframe", "split-pane", "split", "pane"]
+"/catalog/ui-patterns/app/email-inbox-list/email-inbox-list.html":
+  category: data-viz
+  intent: "Email inbox list \u2014 scrollable list of email rows with sender avatar, subject, preview snippet, timestamp, and unread badge indicator. List-item-ui rows with dividers."
+  keywords: ["email", "inbox", "list", "message", "unread", "sender", "subject", "preview", "timestamp", "avatar"]
+"/catalog/ui-patterns/app/feature-grid-icons/feature-grid-icons.html":
+  category: marketing
+  intent: "Feature grid with 6 cells each containing an icon, bold title, and one-line description. Marketing feature showcase layout."
+  keywords: ["feature", "grid", "icons", "icon-ui", "grid", "marketing", "features", "highlights", "benefits", "showcase"]
+"/catalog/ui-patterns/app/filter-popover-form/filter-popover-form.html":
+  category: forms-input
+  intent: "Form fragment in a popover \u2014 checkbox group, radio pair, and a name input behind a summary trigger button. The primitive composition behind form-popover; use when a filter or quick"
+  keywords: ["filter", "popover", "form", "checkbox", "radio", "input", "anchored", "panel", "options", "select-options"]
+"/catalog/ui-patterns/app/import-mapping/import-mapping.html":
+  category: data-viz
+  intent: "Multi-step CSV/file import flow \u2014 upload, field mapping (source columns \u2194 target fields), preview, import. Shows the field-mapping step prominently since it's the part most often m"
+  keywords: ["import", "csv", "upload", "mapping", "fields", "columns", "bulk", "data", "migration"]
+"/catalog/ui-patterns/app/invoice-line-items/invoice-line-items.html":
+  category: data-viz
+  intent: "Invoice table with line items, quantities, unit prices, and total row. Card with invoice header, item rows, subtotal, tax, and total due."
+  keywords: ["invoice", "table", "line", "items", "quantities", "totals", "billing", "amount", "price", "quantity"]
+"/catalog/ui-patterns/app/kanban-board-3col/kanban-board-3col.html":
+  category: workflow
+  intent: "Kanban board with todo, in progress, and done columns. Task cards with title, assignee avatar, priority badge, and label tag."
+  keywords: ["kanban", "board", "todo", "in-progress", "done", "columns", "tasks", "project-management", "cards", "assignee"]
+"/catalog/ui-patterns/app/loading-skeleton-placeholder/loading-skeleton-placeholder.html":
+  category: agent-ops
+  intent: "Loading skeleton placeholder \u2014 animated skeleton-ui elements showing content placeholders while data loads. Avatar + text line skeletons in a list layout."
+  keywords: ["loading", "skeleton", "placeholder", "skeleton-ui", "loading", "state", "shimmer", "pulse", "animation", "content"]
+"/catalog/ui-patterns/app/marketing-hero-cta/marketing-hero-cta.html":
+  category: marketing
+  intent: "Marketing hero section with centered heading, supporting lede, and two CTA buttons (primary + outline)."
+  keywords: ["hero", "cta", "marketing", "landing-page", "heading", "lede", "call-to-action", "buttons"]
+"/catalog/ui-patterns/app/newsletter-subscription/newsletter-subscription.html":
+  category: forms-input
+  intent: "Newsletter subscription form \u2014 email input with subscribe button. Compact signup card with headline, email input-ui, subscribe button, and a privacy reassurance note."
+  keywords: ["newsletter", "subscription", "form", "email", "subscribe", "signup", "subscribe-button", "input-ui", "email-input", "form"]
+"/catalog/ui-patterns/app/onboarding-checklist/onboarding-checklist.html":
+  category: forms-input
+  intent: "User onboarding checklist \u2014 step-by-step setup checklist for new users. Tracks completion of profile, team invite, integration, workflow, and tour steps."
+  keywords: ["onboarding", "checklist", "user", "setup", "steps", "progress", "todo", "complete", "activate", "setup-checklist"]
+"/catalog/ui-patterns/app/order-tracking-timeline/order-tracking-timeline.html":
+  category: data-viz
+  intent: "Order tracking timeline \u2014 5-step order progress from placed to delivered using timeline-ui + timeline-item-ui. Each step shows status (completed/active/pending) with label and time"
+  keywords: ["order", "tracking", "timeline", "step", "progress", "shipped", "delivered", "status", "timeline-ui", "timeline-item-ui"]
+"/catalog/ui-patterns/app/payment-method-form/payment-method-form.contents.html":
+  category: workflow
+  intent: "Payment method form \u2014 credit card number, expiry, CVC, billing address fields with save/cancel actions. Inline card form (drawer-less variant for gallery + inline-form contexts)."
+  keywords: ["payment", "method", "credit", "card", "billing", "form", "update", "save", "cvc", "cvv"]
+"/catalog/ui-patterns/app/permission-matrix-table/permission-matrix-table.html":
+  category: data-table
+  intent: "Permission matrix with roles as columns and resources as rows with checkboxes. Color-coded role badges with checkbox state per permission."
+  keywords: ["permission", "matrix", "roles", "columns", "resources", "rows", "checkboxes", "access", "control", "viewer"]
+"/catalog/ui-patterns/app/product-card-buy/product-card-buy.html":
+  category: data-viz
+  intent: "Product card with image, price, and buy button \u2014 card showing product photo, name, price, brief description, and add-to-cart + save actions. E-commerce product listing pattern."
+  keywords: ["app", "store", "listing", "product-listing", "card", "app-store", "product", "card", "image", "price"]
+"/catalog/ui-patterns/app/settings-appearance/settings-appearance.html":
+  category: workflow
+  intent: "Appearance settings section \u2014 theme picker, density + radius sliders, color-scheme toggle."
+  keywords: ["settings", "appearance", "theme", "density", "radius", "color-scheme", "dark-mode", "preferences", "ui-controls"]
+"/catalog/ui-patterns/app/settings-notifications/settings-notifications.html":
+  category: workflow
+  intent: "Notification preferences panel with per-channel enable/disable toggles for email and push \u2014 weekly digest, mentions, product updates, direct messages, and team alerts."
+  keywords: ["notification", "preferences", "notification-preferences", "panel", "settings", "per-channel", "email", "push", "sms", "channel"]
+"/catalog/ui-patterns/app/social-media-post-card/social-media-post-card.html":
+  category: data-viz
+  intent: "Social media post card \u2014 feed item with avatar, user name, handle, timestamp, post text, optional photo, and engagement actions (likes, comments, share)."
+  keywords: ["social", "media", "post", "card", "feed", "avatar", "user", "name", "timestamp", "like"]
+"/catalog/ui-patterns/app/sortable-search-table/sortable-search-table.html":
+  category: data-viz
+  intent: "Data table with sortable columns, search filter, and pagination \u2014 table-ui with col-def children declaring Name, Email, Status (badge), and date columns. Full interactive data tabl"
+  keywords: ["data", "table", "sortable", "columns", "search", "pagination", "table-ui", "col-def", "sortable", "search"]
+"/catalog/ui-patterns/app/survey-rating-form/survey-rating-form.html":
+  category: forms-input
+  intent: "Survey form with star rating scales \u2014 three rating-ui questions (overall satisfaction, ease of use, likelihood to recommend) plus a textarea for open feedback."
+  keywords: ["survey", "form", "rating", "scale", "star", "rating-ui", "satisfaction", "score", "feedback", "question"]
+"/catalog/ui-patterns/app/testimonials-avatar-cards/testimonials-avatar-cards.html":
+  category: marketing
+  intent: "Testimonials with avatar cards \u2014 three customer testimonials in a grid, each with an avatar, name, role, and quote. Social proof pattern for marketing pages."
+  keywords: ["testimonials", "testimonial", "avatar", "cards", "quote", "review", "social", "proof", "customer", "feedback"]
+"/catalog/ui-patterns/app/tooltip-hover/tooltip-hover.html":
+  category: workflow
+  intent: "Tooltip on hover \u2014 icon buttons with tooltip-ui showing contextual hints on mouse-over. Pattern for toolbar icons with hover tooltips."
+  keywords: ["tooltip", "hover", "tooltip-ui", "mouse-over", "hover-hint", "popover", "label", "hint", "trigger", "button-ui"]
+"/catalog/ui-patterns/app/user-profile-card/user-profile-card.html":
+  category: data-viz
+  intent: "User profile card with avatar, name, role, and action buttons (message, view profile)."
+  keywords: ["profile", "card", "user", "avatar", "name", "role", "action", "buttons", "team-member", "display"]
+"/catalog/ui-patterns/app/users-table-badge/users-table-badge.html":
+  category: data-viz
+  intent: "Users table showing role and status columns populated with badge-ui variants \u2014 accent for Admin, info for Editor, muted for Viewer, success/warning/muted for Online/Away/Offline st"
+  keywords: ["badge", "variant", "accent", "info", "success", "warning", "danger", "muted", "badge-ui", "status"]
+"/catalog/ui-patterns/v050-agent-blocks/v050-agent-blocks.contents.html":
+  category: agent-ops
+  intent: "AI assistant message bubble with streaming text indicator + assistant avatar + cited sources strip."
+  keywords: ["ai", "streaming", "response", "message", "bubble", "assistant", "chat", "llm", "typing", "tokens"]
+"/catalog/ui-patterns/v050-content-blocks/v050-content-blocks.contents.html":
+  category: overlays
+  intent: "Masonry image gallery \u2014 variable-height tiles in a column-flow grid with hover overlays."
+  keywords: ["masonry", "gallery", "images", "photos", "grid", "variable-height", "pinterest", "tiles", "overlays", "lightbox"]
+"/catalog/ui-patterns/v050-data-blocks/v050-data-blocks.contents.html":
+  category: data-viz
+  intent: "Real-time metrics dashboard with live counter cards, streaming line chart, error-rate progress, and last-updated timestamp."
+  keywords: ["real-time", "metrics", "live", "dashboard", "streaming", "counters", "charts", "websocket", "telemetry", "monitoring"]
+"/catalog/ui-patterns/v050-form-blocks/v050-form-blocks.contents.html":
+  category: forms-input
+  intent: "File upload form with drag and drop zone and file list. Upload-ui with browse fallback, file-type hints, and max-size note."
+  keywords: ["file", "upload", "drag-and-drop", "dnd", "browse", "attachments", "form-input", "drop", "zone", "file-list"]
+"/catalog/ui-patterns/v050-marketing-blocks/v050-marketing-blocks.contents.html":
+  category: marketing
+  intent: "Two-column hero \u2014 left side heading + lede + CTA buttons; right side product image or media."
+  keywords: ["hero", "split-hero", "two-column", "landing-page", "heading", "lede", "media", "product-image", "cta"]
+"/catalog/ui-patterns/v050-mode-c-blocks/v050-mode-c-blocks.contents.html":
+  category: agent-ops
+  intent: "Empty state with illustration, bold headline, description, and primary call-to-action button \u2014 shown when a list/view has no content yet."
+  keywords: ["empty", "state", "illustration", "bold", "headline", "description", "primary", "call-to-action", "button", "no-results"]
+"/catalog/ui-patterns/v050-nav-blocks/v050-nav-blocks.contents.html":
+  category: navigation
+  intent: "Breadcrumb navigation trail using link-ui and icon-ui separators to show the hierarchical path to the current page, enabling users to navigate back up the hierarchy."
+  keywords: ["breadcrumb", "navigation", "path", "hierarchy", "link", "separator", "breadcrumb-ui", "trail", "link-ui", "icon-ui"]
+"/catalog/ui-patterns/v053-coverage-fill/v053-coverage-fill.html":
+  category: data-viz
+  intent: "Inline month-view calendar grid with weekday headers, day cells, and month navigation. Built on calendar-grid-ui (substrate primitive); calendar-picker-ui adds a popover trigger fo"
+  keywords: ["calendar", "date", "picker", "month", "navigation", "calendar-grid-ui", "month-view", "weekday", "day", "grid"]

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

@@ -4,7 +4,7 @@
 
 # Pre-assembled patterns & templates index
 
-107 reusable assembled surfaces: 45 patterns (composed component arrangements) and 62 template screens (full pages/flows). Search this file by category, keyword, or component tag BEFORE composing a surface from primitives. `source:` is the copyable markup; `docs:` is the live docs-site route (Gen-UI Feed is excluded — it demos adia-genui's runtime-generated pattern).
+148 reusable assembled surfaces: 45 patterns (composed component arrangements) and 103 template screens (full pages/flows). Search this file by category, keyword, or component tag BEFORE composing a surface from primitives. `source:` is the copyable markup; `docs:` is the live docs-site route (Gen-UI Feed is excluded — it demos adia-genui's runtime-generated pattern).
 
 ## Patterns
 
@@ -235,6 +235,33 @@
 
 ## Templates
 
+### agent-ops
+
+- **Agent Activity Feed** (Pattern Library) — Real-time agent activity feed with timestamped action stream, status pills, and relative-time markers — functions as a changelog feed showing a versioned history of agent actions, 
+  - keywords: changelog, feed, activity, timeline, version, release, update, history, what's, new
+  - components: `agent-artifact-ui` `agent-reasoning-ui` `agent-trace-ui` `card-ui` `col-ui`
+  - source: `/catalog/ui-patterns/app/agent-activity-feed/agent-activity-feed.contents.html` · demo: `/catalog/ui-patterns/app/agent-activity-feed/agent-activity-feed.html` · docs: `/site/examples/patterns/agent-activity-feed`
+- **Agent Reasoning Collapsed** (Pattern Library) — Collapsible agent reasoning panel showing thought process + tool calls + interim results.
+  - keywords: agent, reasoning, thinking, thought-process, tool-calls, trace, transparency, interpretability
+  - components: `agent-reasoning-ui` `card-ui`
+  - source: `/catalog/ui-patterns/app/agent-reasoning-collapsed/agent-reasoning-collapsed.contents.html` · demo: `/catalog/ui-patterns/app/agent-reasoning-collapsed/agent-reasoning-collapsed.html` · docs: `/site/examples/patterns/agent-reasoning-collapsed`
+- **Chat Streaming Surface** (Pattern Library) — Chat conversation surface with user + assistant message bubbles + typing indicator + input row.
+  - keywords: chat, streaming, messages, bubbles, conversation, assistant, user, typing, indicator, input
+  - components: `card-ui` `chat-input-ui` `chat-thread-ui`
+  - source: `/catalog/ui-patterns/app/chat-streaming-surface/chat-streaming-surface.contents.html` · demo: `/catalog/ui-patterns/app/chat-streaming-surface/chat-streaming-surface.html` · docs: `/site/examples/patterns/chat-streaming-surface`
+- **Loading Skeleton Placeholder** (Pattern Library) — Loading skeleton placeholder — animated skeleton-ui elements showing content placeholders while data loads. Avatar + text line skeletons in a list layout.
+  - keywords: loading, skeleton, placeholder, skeleton-ui, loading, state, shimmer, pulse, animation, content
+  - components: `skeleton-ui` `col-ui` `row-ui` `list-item-ui` `card-ui` `list-ui`
+  - source: `/catalog/ui-patterns/app/loading-skeleton-placeholder/loading-skeleton-placeholder.contents.html` · demo: `/catalog/ui-patterns/app/loading-skeleton-placeholder/loading-skeleton-placeholder.html` · docs: `/site/examples/patterns/loading-skeleton-placeholder`
+- **V050 Agent Blocks** (Pattern Library) — AI assistant message bubble with streaming text indicator + assistant avatar + cited sources strip.
+  - keywords: ai, streaming, response, message, bubble, assistant, chat, llm, typing, tokens
+  - components: `text-ui` `col-ui` `tag-ui` `button-ui` `row-ui` `card-ui` `code-ui` `avatar-ui` `icon-ui` `search-ui`
+  - source: `/catalog/ui-patterns/v050-agent-blocks/v050-agent-blocks.contents.html` · docs: `/site/examples/patterns/v050-agent-blocks`
+- **V050 Mode C Blocks** (Pattern Library) — Empty state with illustration, bold headline, description, and primary call-to-action button — shown when a list/view has no content yet.
+  - keywords: empty, state, illustration, bold, headline, description, primary, call-to-action, button, no-results
+  - components: `text-ui` `row-ui` `button-ui` `col-ui` `card-ui` `icon-ui` `kbd-ui` `alert-ui` `field-ui` `tab-ui` `input-ui` `separator-ui`
+  - source: `/catalog/ui-patterns/v050-mode-c-blocks/v050-mode-c-blocks.contents.html` · docs: `/site/examples/patterns/v050-mode-c-blocks`
+
 ### app-overview
 
 - **Overview** (Overview) — Index page cataloguing full-page AdiaUI example compositions — reach for it as a docs gallery landing that lists the available demo screens.
@@ -339,6 +366,121 @@
   - components: `text-ui` `row-ui` `col-ui` `card-ui` `button-ui` `list-item-ui` `badge-ui` `avatar-ui` `field-ui` `grid-ui` `icon-ui` `stat-ui`
   - source: `/apps/saas/app/admin-dashboard/admin-dashboard.contents.html` · demo: `/apps/saas/app/admin-dashboard/admin-dashboard.html` · docs: `/site/examples/admin-dashboard`
 
+### data-table
+
+- **Api Key Table** (Pattern Library) — API keys management table with key name, prefix, created date, last used, and revoke button.
+  - keywords: api, key, management, table, generate, revoke, token, secret, credential, access
+  - components: `col-def` `button-ui` `card-ui` `table-ui`
+  - source: `/catalog/ui-patterns/app/api-key-table/api-key-table.contents.html` · demo: `/catalog/ui-patterns/app/api-key-table/api-key-table.html` · docs: `/site/examples/patterns/api-key-table`
+- **Permission Matrix Table** (Pattern Library) — Permission matrix with roles as columns and resources as rows with checkboxes. Color-coded role badges with checkbox state per permission.
+  - keywords: permission, matrix, roles, columns, resources, rows, checkboxes, access, control, viewer
+  - components: `col-ui` `check-ui` `grid-ui` `text-ui` `badge-ui` `card-ui` `divider-ui`
+  - source: `/catalog/ui-patterns/app/permission-matrix-table/permission-matrix-table.contents.html` · demo: `/catalog/ui-patterns/app/permission-matrix-table/permission-matrix-table.html` · docs: `/site/examples/patterns/permission-matrix-table`
+
+### data-viz
+
+- **Conversion Funnel 6step** (Pattern Library) — Conversion funnel with 6 stages, stage labels, counts, and drop-off conversion percentages.
+  - keywords: funnel, conversion, analytics, stages, metrics, drop-off, rate, marketing
+  - components: `progress-row-ui` `text-ui` `col-ui` `card-ui` `row-ui`
+  - source: `/catalog/ui-patterns/app/conversion-funnel-6step/conversion-funnel-6step.contents.html` · demo: `/catalog/ui-patterns/app/conversion-funnel-6step/conversion-funnel-6step.html` · docs: `/site/examples/patterns/conversion-funnel-6step`
+- **Email Inbox List** (Pattern Library) — Email inbox list — scrollable list of email rows with sender avatar, subject, preview snippet, timestamp, and unread badge indicator. List-item-ui rows with dividers.
+  - keywords: email, inbox, list, message, unread, sender, subject, preview, timestamp, avatar
+  - components: `text-ui` `row-ui` `col-ui` `avatar-ui` `list-item-ui` `badge-ui` `button-ui` `card-ui` `list-ui`
+  - source: `/catalog/ui-patterns/app/email-inbox-list/email-inbox-list.contents.html` · demo: `/catalog/ui-patterns/app/email-inbox-list/email-inbox-list.html` · docs: `/site/examples/patterns/email-inbox-list`
+- **Import Mapping** (Pattern Library) — Multi-step CSV/file import flow — upload, field mapping (source columns ↔ target fields), preview, import. Shows the field-mapping step prominently since it's the part most often m
+  - keywords: import, csv, upload, mapping, fields, columns, bulk, data, migration
+  - components: `text-ui` `col-ui` `icon-ui` `grid-ui` `list-item-ui` `select-ui` `button-ui` `avatar-ui` `card-ui` `row-ui` `alert-ui` `badge-ui`
+  - source: `/catalog/ui-patterns/app/import-mapping/import-mapping.contents.html` · demo: `/catalog/ui-patterns/app/import-mapping/import-mapping.html` · docs: `/site/examples/patterns/import-mapping`
+- **Invoice Line Items** (Pattern Library) — Invoice table with line items, quantities, unit prices, and total row. Card with invoice header, item rows, subtotal, tax, and total due.
+  - keywords: invoice, table, line, items, quantities, totals, billing, amount, price, quantity
+  - components: `text-ui` `col-ui` `row-ui` `divider-ui` `badge-ui` `card-ui` `grid-ui`
+  - source: `/catalog/ui-patterns/app/invoice-line-items/invoice-line-items.contents.html` · demo: `/catalog/ui-patterns/app/invoice-line-items/invoice-line-items.html` · docs: `/site/examples/patterns/invoice-line-items`
+- **Order Tracking Timeline** (Pattern Library) — Order tracking timeline — 5-step order progress from placed to delivered using timeline-ui + timeline-item-ui. Each step shows status (completed/active/pending) with label and time
+  - keywords: order, tracking, timeline, step, progress, shipped, delivered, status, timeline-ui, timeline-item-ui
+  - components: `timeline-item-ui` `card-ui` `timeline-ui`
+  - source: `/catalog/ui-patterns/app/order-tracking-timeline/order-tracking-timeline.contents.html` · demo: `/catalog/ui-patterns/app/order-tracking-timeline/order-tracking-timeline.html` · docs: `/site/examples/patterns/order-tracking-timeline`
+- **Product Card Buy** (Pattern Library) — Product card with image, price, and buy button — card showing product photo, name, price, brief description, and add-to-cart + save actions. E-commerce product listing pattern.
+  - keywords: app, store, listing, product-listing, card, app-store, product, card, image, price
+  - components: `text-ui` `row-ui` `badge-ui` `button-ui` `col-ui` `card-ui` `image-ui` `rating-ui`
+  - source: `/catalog/ui-patterns/app/product-card-buy/product-card-buy.contents.html` · demo: `/catalog/ui-patterns/app/product-card-buy/product-card-buy.html` · docs: `/site/examples/patterns/product-card-buy`
+- **Social Media Post Card** (Pattern Library) — Social media post card — feed item with avatar, user name, handle, timestamp, post text, optional photo, and engagement actions (likes, comments, share).
+  - keywords: social, media, post, card, feed, avatar, user, name, timestamp, like
+  - components: `text-ui` `button-ui` `avatar-ui` `card-ui` `col-ui` `image-ui` `row-ui`
+  - source: `/catalog/ui-patterns/app/social-media-post-card/social-media-post-card.contents.html` · demo: `/catalog/ui-patterns/app/social-media-post-card/social-media-post-card.html` · docs: `/site/examples/patterns/social-media-post-card`
+- **Sortable Search Table** (Pattern Library) — Data table with sortable columns, search filter, and pagination — table-ui with col-def children declaring Name, Email, Status (badge), and date columns. Full interactive data tabl
+  - keywords: data, table, sortable, columns, search, pagination, table-ui, col-def, sortable, search
+  - components: `col-def` `button-ui` `card-ui` `table-ui` `text-ui`
+  - source: `/catalog/ui-patterns/app/sortable-search-table/sortable-search-table.contents.html` · demo: `/catalog/ui-patterns/app/sortable-search-table/sortable-search-table.html` · docs: `/site/examples/patterns/sortable-search-table`
+- **User Profile Card** (Pattern Library) — User profile card with avatar, name, role, and action buttons (message, view profile).
+  - keywords: profile, card, user, avatar, name, role, action, buttons, team-member, display
+  - components: `row-ui` `icon-ui` `badge-ui` `button-ui` `text-ui` `avatar-ui` `card-ui` `col-ui`
+  - source: `/catalog/ui-patterns/app/user-profile-card/user-profile-card.contents.html` · demo: `/catalog/ui-patterns/app/user-profile-card/user-profile-card.html` · docs: `/site/examples/patterns/user-profile-card`
+- **Users Table Badge** (Pattern Library) — Users table showing role and status columns populated with badge-ui variants — accent for Admin, info for Editor, muted for Viewer, success/warning/muted for Online/Away/Offline st
+  - keywords: badge, variant, accent, info, success, warning, danger, muted, badge-ui, status
+  - components: `badge-ui` `text-ui` `avatar-ui` `row-ui` `card-ui` `table-ui`
+  - source: `/catalog/ui-patterns/app/users-table-badge/users-table-badge.contents.html` · demo: `/catalog/ui-patterns/app/users-table-badge/users-table-badge.html` · docs: `/site/examples/patterns/users-table-badge`
+- **V050 Data Blocks** (Pattern Library) — Real-time metrics dashboard with live counter cards, streaming line chart, error-rate progress, and last-updated timestamp.
+  - keywords: real-time, metrics, live, dashboard, streaming, counters, charts, websocket, telemetry, monitoring
+  - components: `text-ui` `row-ui` `col-ui` `card-ui` `button-ui` `badge-ui` `avatar-ui` `icon-ui` `progress-ui` `chart-ui` `description-list-ui` `grid-ui`
+  - source: `/catalog/ui-patterns/v050-data-blocks/v050-data-blocks.contents.html` · docs: `/site/examples/patterns/v050-data-blocks`
+- **V053 Coverage Fill** (Pattern Library) — Inline month-view calendar grid with weekday headers, day cells, and month navigation. Built on calendar-grid-ui (substrate primitive); calendar-picker-ui adds a popover trigger fo
+  - keywords: calendar, date, picker, month, navigation, calendar-grid-ui, month-view, weekday, day, grid
+  - components: `text-ui` `card-ui` `avatar-ui` `button-ui` `col-ui` `row-ui` `swatch-ui` `stat-ui` `empty-state-ui` `field-ui` `divider-ui` `input-ui`
+  - source: `/catalog/ui-patterns/v053-coverage-fill/v053-coverage-fill.contents.html` · demo: `/catalog/ui-patterns/v053-coverage-fill/v053-coverage-fill.html` · docs: `/site/examples/patterns/v053-coverage-fill`
+
+### forms-input
+
+- **Filter Popover Form** (Pattern Library) — Form fragment in a popover — checkbox group, radio pair, and a name input behind a summary trigger button. The primitive composition behind form-popover; use when a filter or quick
+  - keywords: filter, popover, form, checkbox, radio, input, anchored, panel, options, select-options
+  - components: `check-ui` `divider-ui` `radio-ui` `button-ui` `col-ui` `input-ui` `popover-ui` `text-ui`
+  - source: `/catalog/ui-patterns/app/filter-popover-form/filter-popover-form.contents.html` · demo: `/catalog/ui-patterns/app/filter-popover-form/filter-popover-form.html` · docs: `/site/examples/patterns/filter-popover-form`
+- **Newsletter Subscription** (Pattern Library) — Newsletter subscription form — email input with subscribe button. Compact signup card with headline, email input-ui, subscribe button, and a privacy reassurance note.
+  - keywords: newsletter, subscription, form, email, subscribe, signup, subscribe-button, input-ui, email-input, form
+  - components: `text-ui` `row-ui` `col-ui` `icon-ui` `button-ui` `card-ui` `input-ui`
+  - source: `/catalog/ui-patterns/app/newsletter-subscription/newsletter-subscription.contents.html` · demo: `/catalog/ui-patterns/app/newsletter-subscription/newsletter-subscription.html` · docs: `/site/examples/patterns/newsletter-subscription`
+- **Onboarding Checklist** (Pattern Library) — User onboarding checklist — step-by-step setup checklist for new users. Tracks completion of profile, team invite, integration, workflow, and tour steps.
+  - keywords: onboarding, checklist, user, setup, steps, progress, todo, complete, activate, setup-checklist
+  - components: `text-ui` `button-ui` `check-ui` `list-item-ui` `card-ui` `list-ui` `progress-ui`
+  - source: `/catalog/ui-patterns/app/onboarding-checklist/onboarding-checklist.contents.html` · demo: `/catalog/ui-patterns/app/onboarding-checklist/onboarding-checklist.html` · docs: `/site/examples/patterns/onboarding-checklist`
+- **Survey Rating Form** (Pattern Library) — Survey form with star rating scales — three rating-ui questions (overall satisfaction, ease of use, likelihood to recommend) plus a textarea for open feedback.
+  - keywords: survey, form, rating, scale, star, rating-ui, satisfaction, score, feedback, question
+  - components: `field-ui` `rating-ui` `button-ui` `card-ui` `col-ui` `row-ui` `textarea-ui`
+  - source: `/catalog/ui-patterns/app/survey-rating-form/survey-rating-form.contents.html` · demo: `/catalog/ui-patterns/app/survey-rating-form/survey-rating-form.html` · docs: `/site/examples/patterns/survey-rating-form`
+- **V050 Form Blocks** (Pattern Library) — File upload form with drag and drop zone and file list. Upload-ui with browse fallback, file-type hints, and max-size note.
+  - keywords: file, upload, drag-and-drop, dnd, browse, attachments, form-input, drop, zone, file-list
+  - components: `field-ui` `button-ui` `col-ui` `input-ui` `row-ui` `text-ui` `card-ui` `tag-ui` `radio-ui` `calendar-picker-ui` `check-ui` `grid-ui`
+  - source: `/catalog/ui-patterns/v050-form-blocks/v050-form-blocks.contents.html` · docs: `/site/examples/patterns/v050-form-blocks`
+
+### marketing
+
+- **Feature Grid Icons** (Pattern Library) — Feature grid with 6 cells each containing an icon, bold title, and one-line description. Marketing feature showcase layout.
+  - keywords: feature, grid, icons, icon-ui, grid, marketing, features, highlights, benefits, showcase
+  - components: `col-ui` `text-ui` `icon-ui` `grid-ui`
+  - source: `/catalog/ui-patterns/app/feature-grid-icons/feature-grid-icons.contents.html` · demo: `/catalog/ui-patterns/app/feature-grid-icons/feature-grid-icons.html` · docs: `/site/examples/patterns/feature-grid-icons`
+- **Marketing Hero Cta** (Pattern Library) — Marketing hero section with centered heading, supporting lede, and two CTA buttons (primary + outline).
+  - keywords: hero, cta, marketing, landing-page, heading, lede, call-to-action, buttons
+  - components: `button-ui` `col-ui` `text-ui` `row-ui`
+  - source: `/catalog/ui-patterns/app/marketing-hero-cta/marketing-hero-cta.contents.html` · demo: `/catalog/ui-patterns/app/marketing-hero-cta/marketing-hero-cta.html` · docs: `/site/examples/patterns/marketing-hero-cta`
+- **Testimonials Avatar Cards** (Pattern Library) — Testimonials with avatar cards — three customer testimonials in a grid, each with an avatar, name, role, and quote. Social proof pattern for marketing pages.
+  - keywords: testimonials, testimonial, avatar, cards, quote, review, social, proof, customer, feedback
+  - components: `text-ui` `col-ui` `avatar-ui` `card-ui` `rating-ui` `grid-ui`
+  - source: `/catalog/ui-patterns/app/testimonials-avatar-cards/testimonials-avatar-cards.contents.html` · demo: `/catalog/ui-patterns/app/testimonials-avatar-cards/testimonials-avatar-cards.html` · docs: `/site/examples/patterns/testimonials-avatar-cards`
+- **V050 Marketing Blocks** (Pattern Library) — Two-column hero — left side heading + lede + CTA buttons; right side product image or media.
+  - keywords: hero, split-hero, two-column, landing-page, heading, lede, media, product-image, cta
+  - components: `text-ui` `col-ui` `link-ui` `row-ui` `accordion-item-ui` `card-ui` `grid-ui` `avatar-ui` `button-ui` `icon-ui` `accordion-ui` `divider-ui`
+  - source: `/catalog/ui-patterns/v050-marketing-blocks/v050-marketing-blocks.contents.html` · docs: `/site/examples/patterns/v050-marketing-blocks`
+
+### navigation
+
+- **Command Palette** (Pattern Library) — Command palette with search input, recent commands, and keyboard shortcut hints.
+  - keywords: command, palette, search, input, recent, commands, keyboard, shortcut, hints, cmdk
+  - components: `text-ui` `badge-ui` `icon-ui` `row-ui` `col-ui` `card-ui` `divider-ui` `input-ui`
+  - source: `/catalog/ui-patterns/app/command-palette/command-palette.contents.html` · demo: `/catalog/ui-patterns/app/command-palette/command-palette.html` · docs: `/site/examples/patterns/command-palette`
+- **V050 Nav Blocks** (Pattern Library) — Breadcrumb navigation trail using link-ui and icon-ui separators to show the hierarchical path to the current page, enabling users to navigate back up the hierarchy.
+  - keywords: breadcrumb, navigation, path, hierarchy, link, separator, breadcrumb-ui, trail, link-ui, icon-ui
+  - components: `button-ui` `col-ui` `icon-ui` `link-ui` `row-ui` `text-ui` `separator-ui` `admin-sidebar`
+  - source: `/catalog/ui-patterns/v050-nav-blocks/v050-nav-blocks.contents.html` · docs: `/site/examples/patterns/v050-nav-blocks`
+
 ### onboarding-flow
 
 - **Profile** (Authentication) — First-run profile setup: collect full name and display name/handle — reach for it after account creation to personalize a new account.
@@ -386,6 +528,21 @@
   - components: `timeline-item-ui` `kbd-ui` `text-ui` `alert-ui` `button-ui` `image-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
+
+- **Card Grid Images** (Pattern Library) — Image gallery grid with lightbox overlay — responsive 3-column grid of image cards with cover photo, title, and description.
+  - keywords: image, gallery, grid, lightbox, overlay, card-grid, image-ui, media, photo, gallery-grid
+  - components: `text-ui` `card-ui` `chart-ui` `col-ui` `grid-ui`
+  - source: `/catalog/ui-patterns/app/card-grid-images/card-grid-images.contents.html` · demo: `/catalog/ui-patterns/app/card-grid-images/card-grid-images.html` · docs: `/site/examples/patterns/card-grid-images`
+- **Destructive Confirm Modal** (Pattern Library) — Destructive-action modal dialog with a confirmation form — resource-name input field, cancel and delete action buttons, warning icon, and irreversible-action prose.
+  - keywords: modal, dialog, form, confirm, modal-ui, button-ui, destructive, confirm, input, action
+  - components: `button-ui` `text-ui` `avatar-ui` `col-ui` `field-ui` `input-ui` `modal-ui` `row-ui`
+  - source: `/catalog/ui-patterns/app/destructive-confirm-modal/destructive-confirm-modal.contents.html` · demo: `/catalog/ui-patterns/app/destructive-confirm-modal/destructive-confirm-modal.html` · docs: `/site/examples/patterns/destructive-confirm-modal`
+- **V050 Content Blocks** (Pattern Library) — Masonry image gallery — variable-height tiles in a column-flow grid with hover overlays.
+  - keywords: masonry, gallery, images, photos, grid, variable-height, pinterest, tiles, overlays, lightbox
+  - components: `text-ui` `card-ui` `col-ui` `row-ui` `progress-ui` `avatar-ui` `badge-ui` `grid-ui` `avatar-group-ui` `blockquote-ui` `description-list-ui` `rating-ui`
+  - source: `/catalog/ui-patterns/v050-content-blocks/v050-content-blocks.contents.html` · docs: `/site/examples/patterns/v050-content-blocks`
+
 ### registration-flow
 
 - **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.
@@ -505,3 +662,34 @@
   - keywords: place-order, payment, celebration, animation, ecommerce
   - components: `list-item-ui` `text-ui` `field-ui` `switch-ui` `col-ui` `row-ui` `button-ui` `input-ui` `list-ui` `stat-ui` `card-ui` `code-ui`
   - source: `/playgrounds/composed-flow/app/composed-flow.contents.html` · demo: `/playgrounds/composed-flow/app/composed-flow.html` · docs: `/site/examples/composed-flow`
+
+### workflow
+
+- **Editor Code Pane** (Pattern Library) — Code editor pane with file-tabs header, line-numbered code surface, and status bar footer.
+  - keywords: editor, code, pane, tabs, ide, line-numbers, syntax-highlighting, monaco, codemirror
+  - components: `button-ui` `row-ui` `textarea-ui`
+  - source: `/catalog/ui-patterns/app/editor-code-pane/editor-code-pane.contents.html` · docs: `/site/examples/patterns/editor-code-pane`
+- **Editor Preview Pane** (Pattern Library) — Preview pane rendering the editor's output with toolbar (refresh, viewport, share) and live content area.
+  - keywords: preview, render, editor, pane, output, live-preview, iframe, split-pane, split, pane
+  - components: `text-ui`
+  - source: `/catalog/ui-patterns/app/editor-preview-pane/editor-preview-pane.contents.html` · docs: `/site/examples/patterns/editor-preview-pane`
+- **Kanban Board 3col** (Pattern Library) — Kanban board with todo, in progress, and done columns. Task cards with title, assignee avatar, priority badge, and label tag.
+  - keywords: kanban, board, todo, in-progress, done, columns, tasks, project-management, cards, assignee
+  - components: `text-ui` `row-ui` `badge-ui` `card-ui` `col-ui` `avatar-ui` `tag-ui` `grid-ui`
+  - source: `/catalog/ui-patterns/app/kanban-board-3col/kanban-board-3col.contents.html` · demo: `/catalog/ui-patterns/app/kanban-board-3col/kanban-board-3col.html` · docs: `/site/examples/patterns/kanban-board-3col`
+- **Payment Method Form** (Pattern Library) — Payment method form — credit card number, expiry, CVC, billing address fields with save/cancel actions. Inline card form (drawer-less variant for gallery + inline-form contexts).
+  - keywords: payment, method, credit, card, billing, form, update, save, cvc, cvv
+  - components: `field-ui` `input-ui` `button-ui` `grid-ui` `row-ui` `alert-ui` `avatar-ui` `card-ui` `col-ui` `divider-ui` `select-ui` `text-ui`
+  - source: `/catalog/ui-patterns/app/payment-method-form/payment-method-form.contents.html` · docs: `/site/examples/patterns/payment-method-form`
+- **Settings Appearance** (Pattern Library) — Appearance settings section — theme picker, density + radius sliders, color-scheme toggle.
+  - keywords: settings, appearance, theme, density, radius, color-scheme, dark-mode, preferences, ui-controls
+  - components: `card-ui` `theme-panel`
+  - source: `/catalog/ui-patterns/app/settings-appearance/settings-appearance.contents.html` · demo: `/catalog/ui-patterns/app/settings-appearance/settings-appearance.html` · docs: `/site/examples/patterns/settings-appearance`
+- **Settings Notifications** (Pattern Library) — Notification preferences panel with per-channel enable/disable toggles for email and push — weekly digest, mentions, product updates, direct messages, and team alerts.
+  - keywords: notification, preferences, notification-preferences, panel, settings, per-channel, email, push, sms, channel
+  - components: `text-ui` `row-ui` `switch-ui` `col-ui` `card-ui` `divider-ui`
+  - source: `/catalog/ui-patterns/app/settings-notifications/settings-notifications.contents.html` · demo: `/catalog/ui-patterns/app/settings-notifications/settings-notifications.html` · docs: `/site/examples/patterns/settings-notifications`
+- **Tooltip Hover** (Pattern Library) — Tooltip on hover — icon buttons with tooltip-ui showing contextual hints on mouse-over. Pattern for toolbar icons with hover tooltips.
+  - keywords: tooltip, hover, tooltip-ui, mouse-over, hover-hint, popover, label, hint, trigger, button-ui
+  - components: `button-ui` `row-ui`
+  - source: `/catalog/ui-patterns/app/tooltip-hover/tooltip-hover.contents.html` · demo: `/catalog/ui-patterns/app/tooltip-hover/tooltip-hover.html` · docs: `/site/examples/patterns/tooltip-hover`

package/skills/adia-tokens/references/a-alias-layer.md

@@ -16,7 +16,7 @@ The `--a-*` semantic layer is a thin alias layer reading FROM the `--md-sys-colo
 | `--a-canvas-muted` | `var(--md-sys-color-neutral-surface-dimmer)` |
 | `--a-canvas-hover` | `var(--md-sys-color-neutral-hover)` |
 | `--a-canvas-active` | `var(--md-sys-color-neutral-active)` |
-| `--a-canvas-selected` | `var(--md-sys-color-neutral-container-active)` |
+| `--a-canvas-selected` | `var(--md-sys-color-neutral-container)` |
 | `--a-canvas-text-strong` | `var(--md-sys-color-neutral-on-surface)` |
 | `--a-canvas-text` | `var(--md-sys-color-neutral-on-surface)` |
 | `--a-canvas-text-subtle` | `var(--md-sys-color-neutral-on-surface-variant)` |
@@ -38,7 +38,7 @@ The `--a-*` semantic layer is a thin alias layer reading FROM the `--md-sys-colo
 | `--a-bg-strong` | `var(--md-sys-color-neutral-surface-high)` |
 | `--a-bg-hover` | `var(--md-sys-color-neutral-hover)` |
 | `--a-bg-active` | `var(--md-sys-color-neutral-active)` |
-| `--a-bg-selected` | `var(--md-sys-color-neutral-container-active)` |
+| `--a-bg-selected` | `var(--md-sys-color-neutral-container)` |
 | `--a-bg-disabled` | `var(--md-sys-color-neutral-container-disabled)` |
 | `--a-bg-invalid` | `var(--a-danger-muted)` |
 | `--a-fg` | `var(--md-sys-color-neutral-on-surface)` |

package/skills/adia-tokens/references/role-roster.md

@@ -6,7 +6,7 @@
 
 # Role roster — the `--md-sys-color-*` semantic layer
 
-**Palettes (8):** neutral (53) · primary (53) · secondary (53) · tertiary (53) · info (53) · success (53) · warning (53) · danger (53) — every palette carries the full roster.
+**Palettes (8):** neutral (54) · primary (54) · secondary (54) · tertiary (54) · info (54) · success (54) · warning (54) · danger (54) — every palette carries the full roster.
 
 Grammar: `--md-sys-color-{palette}{suffix}`. Chrome palette = `neutral`; brand accent = `primary`; `secondary`/`tertiary` support; `info/success/warning/danger` carry MEANING only. Consume via `var()` — never a raw `-050…-950` stop, never a hex.
 
@@ -16,6 +16,7 @@ Grammar: `--md-sys-color-{palette}{suffix}`. Chrome palette = `neutral`; brand a
 | accent variants | `-dim` `-bright` `-low` `-high` | Tonal variants of the accent for de/emphasis without leaving the palette |
 | accent states | `-hover` `-active` `-disabled` | The solid accent fill's baked states — never synthesize with opacity/color-mix |
 | on-accent | `-on-{p}` `-on-{p}-variant` `-on-{p}-hover` `-on-{p}-active` `-on-{p}-disabled` | Ink on the palette's own solid fill (the accent). FIXED LIGHT in both schemes by design — never "fix" with dark text or auto-contrast |
+| UNCLASSIFIED | `-on-{p}-container` | ⚠ suffix not in the doctrine table — classify it |
 | on-surface | `-on-surface` `-on-surface-variant` `-on-surface-hover` `-on-surface-active` `-on-surface-disabled` | Text/icon ink on the SAME palette's surfaces/containers/background — the pairing law's ink side, with baked states |
 | placeholder | `-placeholder` | Form placeholder ink |
 | outline | `-outline` `-outline-variant` `-outline-hover` `-outline-active` `-outline-disabled` | Borders/dividers/rings, with a softer -variant and baked states |
@@ -24,3 +25,5 @@ Grammar: `--md-sys-color-{palette}{suffix}`. Chrome palette = `neutral`; brand a
 | background | `-background` | The palette's page-level backdrop |
 | surface ladder | `-surface` `-surface-dimmest` `-surface-dimmer` `-surface-dim` `-surface-bright` `-surface-brighter` `-surface-brightest` `-surface-lowest` `-surface-lower` `-surface-low` `-surface-high` `-surface-higher` `-surface-highest` | Elevation IS this ladder (dim↔bright, low↔high) — raise/recess with surfaces, never with opacity or ad-hoc shadows |
 | scrim | `-scrim-weakest` `-scrim-weaker` `-scrim-weak` `-scrim` `-scrim-strong` `-scrim-stronger` `-scrim-strongest` | Scrim ladder — 7-step overlay dims for layering under sheets/dialogs/toasts |
+
+⚠ **Unclassified roles (doctrine table needs updating):** --md-sys-color-neutral-on-neutral-container