@adia-ai/adia-ui-factory 0.8.23 → 0.8.25

package/.claude-plugin/plugin.json

@@ -1,6 +1,6 @@
 {
   "name": "adia-ui-kit-factory",
-  "version": "0.8.23",
+  "version": "0.8.25",
   "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.23"]
+      "args": ["-y", "@adia-ai/a2ui-mcp@0.8.25"]
     }
   }
 }

package/CHANGELOG.md

@@ -1,5 +1,19 @@
 # Changelog — adia-ui-kit-factory
 
+## [0.8.25] — 2026-07-31
+
+### 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.25 work shipped in theme-panel scoped-target [parametric] density/radius fix (gh#570) + System scheme option; anchor-bar-ui; stat-ui band chart layout; chart-ui dots/series-emphasis. See `packages/web-components/CHANGELOG.md#0825--2026-07-31` 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** (2 file(s), e.g. `references/annotations.yaml`) — carried by the entries above.
+
+## [0.8.24] — 2026-07-30
+
+### 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.24 work shipped in requiredIcons drift cleared across 16 components + checker comment handling (gh#550), worktree bootstrap workspace-link hardening + retrieval corpus-pin fix (gh#554), list-item two-line icon centering (gh#558), card footer bottom-pinning (gh#559). See `packages/web-components/CHANGELOG.md#0824--2026-07-30` 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** (2 file(s), e.g. `references/annotations.yaml`) — carried by the entries above.
+
 ## [0.8.23] — 2026-07-30
 
 ### Changed

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@adia-ai/adia-ui-factory",
-  "version": "0.8.23",
+  "version": "0.8.25",
   "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

@@ -58,6 +58,16 @@
     - subnav
     - right rail
     - context pane
+/site/pages/patterns/appearance-settings.html:
+  category: tokens-theming
+  intent: The theme/density/radius/color-scheme settings row — theme-panel for the quick path, hand-rolled primitives with persisted (not computed-style) state for a page-fitted path.
+  keywords:
+    - appearance settings
+    - theme panel
+    - density slider
+    - radius slider
+    - color scheme
+    - persisted state
 /packages/web-components/patterns/app-nav/app-nav.examples.html:
   category: navigation
   intent: Sidebar navigation tree — grouped collapsible items, dividers, section labels, badges, and popover flyouts when collapsed.
@@ -1023,11 +1033,11 @@
   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":
+"/catalog/ui-patterns/app/editor-code-pane/editor-code-pane.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":
+"/catalog/ui-patterns/app/editor-preview-pane/editor-preview-pane.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"]
@@ -1075,7 +1085,7 @@
   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":
+"/catalog/ui-patterns/app/payment-method-form/payment-method-form.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"]
@@ -1123,31 +1133,31 @@
   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":
+"/catalog/ui-patterns/v050-agent-blocks/v050-agent-blocks.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":
+"/catalog/ui-patterns/v050-content-blocks/v050-content-blocks.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":
+"/catalog/ui-patterns/v050-data-blocks/v050-data-blocks.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":
+"/catalog/ui-patterns/v050-form-blocks/v050-form-blocks.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":
+"/catalog/ui-patterns/v050-marketing-blocks/v050-marketing-blocks.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":
+"/catalog/ui-patterns/v050-mode-c-blocks/v050-mode-c-blocks.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":
+"/catalog/ui-patterns/v050-nav-blocks/v050-nav-blocks.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"]

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

@@ -4,7 +4,7 @@
 
 # Pre-assembled patterns & templates index
 
-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).
+149 reusable assembled surfaces: 46 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
 
@@ -49,7 +49,7 @@
   - source: `/packages/web-components/patterns/audit-log/audit-log.examples.html` · demo: `/packages/web-components/patterns/audit-log/audit-log.html` · docs: `/site/patterns/audit-log`
 - **Bulk Action Toolbar** (Patterns) — Contextual action bar that swaps the table toolbar when rows are selected — reach for it for batch archive/delete/export on a grid.
   - keywords: multi-select, batch, selection, archive, contextual, delete
-  - components: `button-ui` `toolbar-group-ui` `code-ui` `tag-ui` `card-ui` `divider-ui` `table-toolbar-ui` `table-ui` `text-ui` `toolbar-ui`
+  - components: `button-ui` `toolbar-group-ui` `tag-ui` `code-ui` `divider-ui` `card-ui` `table-toolbar-ui` `table-ui` `text-ui` `toolbar-ui` `anchor-bar-ui`
   - source: `/packages/web-components/patterns/bulk-action-toolbar/bulk-action-toolbar.examples.html` · demo: `/packages/web-components/patterns/bulk-action-toolbar/bulk-action-toolbar.html` · docs: `/site/patterns/bulk-action-toolbar`
 - **Data Tables — Inline Edit & Tree** (Patterns) — Spreadsheet-style inline-edit grid and hierarchical tree table — reach for it for bulk row correction or recursively nested data.
   - keywords: spreadsheet, editable cells, hierarchy, expand collapse, nested rows, grid
@@ -209,6 +209,10 @@
 
 ### tokens-theming
 
+- **Appearance Settings** (Patterns) — The theme/density/radius/color-scheme settings row — theme-panel for the quick path, hand-rolled primitives with persisted (not computed-style) state for a page-fitted path.
+  - keywords: appearance settings, theme panel, density slider, radius slider, color scheme, persisted state
+  - components: `code-ui` `alert-ui` `segment-ui` `slider-ui` `button-ui` `card-ui` `col-ui` `divider-ui` `field-ui` `row-ui` `segmented-ui`
+  - source: `/site/pages/patterns/appearance-settings.html` · docs: `/site/patterns/appearance-settings`
 - **Component Tokens** (Patterns) — The component CSS recipe — @scope isolation, --component-prop tokens, :where(:scope) defaults. Doc-hub, not a surface — read it, don't copy its components list.
   - keywords: css scope, custom properties, theming, style isolation, overridable
   - components: `code-ui`
@@ -256,11 +260,11 @@
 - **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`
+  - source: `/catalog/ui-patterns/v050-agent-blocks/v050-agent-blocks.contents.html` · demo: `/catalog/ui-patterns/v050-agent-blocks/v050-agent-blocks.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`
+  - source: `/catalog/ui-patterns/v050-mode-c-blocks/v050-mode-c-blocks.contents.html` · demo: `/catalog/ui-patterns/v050-mode-c-blocks/v050-mode-c-blocks.html` · docs: `/site/examples/patterns/v050-mode-c-blocks`
 
 ### app-overview
 
@@ -422,7 +426,7 @@
 - **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`
+  - source: `/catalog/ui-patterns/v050-data-blocks/v050-data-blocks.contents.html` · demo: `/catalog/ui-patterns/v050-data-blocks/v050-data-blocks.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`
@@ -449,7 +453,7 @@
 - **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`
+  - source: `/catalog/ui-patterns/v050-form-blocks/v050-form-blocks.contents.html` · demo: `/catalog/ui-patterns/v050-form-blocks/v050-form-blocks.html` · docs: `/site/examples/patterns/v050-form-blocks`
 
 ### marketing
 
@@ -468,7 +472,7 @@
 - **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`
+  - source: `/catalog/ui-patterns/v050-marketing-blocks/v050-marketing-blocks.contents.html` · demo: `/catalog/ui-patterns/v050-marketing-blocks/v050-marketing-blocks.html` · docs: `/site/examples/patterns/v050-marketing-blocks`
 
 ### navigation
 
@@ -479,7 +483,7 @@
 - **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`
+  - source: `/catalog/ui-patterns/v050-nav-blocks/v050-nav-blocks.contents.html` · demo: `/catalog/ui-patterns/v050-nav-blocks/v050-nav-blocks.html` · docs: `/site/examples/patterns/v050-nav-blocks`
 
 ### onboarding-flow
 
@@ -541,7 +545,7 @@
 - **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`
+  - source: `/catalog/ui-patterns/v050-content-blocks/v050-content-blocks.contents.html` · demo: `/catalog/ui-patterns/v050-content-blocks/v050-content-blocks.html` · docs: `/site/examples/patterns/v050-content-blocks`
 
 ### registration-flow
 
@@ -668,11 +672,11 @@
 - **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`
+  - source: `/catalog/ui-patterns/app/editor-code-pane/editor-code-pane.contents.html` · demo: `/catalog/ui-patterns/app/editor-code-pane/editor-code-pane.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`
+  - source: `/catalog/ui-patterns/app/editor-preview-pane/editor-preview-pane.contents.html` · demo: `/catalog/ui-patterns/app/editor-preview-pane/editor-preview-pane.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`
@@ -680,7 +684,7 @@
 - **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`
+  - source: `/catalog/ui-patterns/app/payment-method-form/payment-method-form.contents.html` · demo: `/catalog/ui-patterns/app/payment-method-form/payment-method-form.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`