@adia-ai/adia-ui-factory 0.8.45 → 0.8.47

package/.claude-plugin/plugin.json

@@ -1,6 +1,6 @@
 {
   "name": "adia-ui-kit-factory",
-  "version": "0.8.45",
+  "version": "0.8.47",
   "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": {
     "adia-gen-ui": {
       "command": "npx",
-      "args": ["-y", "@adia-ai/mcp@0.8.45", "gen-ui"]
+      "args": ["-y", "@adia-ai/mcp@0.8.47", "gen-ui"]
     }
   }
 }

package/CHANGELOG.md

@@ -1,5 +1,18 @@
 # Changelog — adia-ui-kit-factory
 
+## [0.8.47] — 2026-08-22
+
+### Maintenance
+- **Lockstep version bump only.** No source changes in this package; bumped to maintain the lockstep version coherence enforced by `scripts/release/check-lockstep.mjs`. Substantive v0.8.47 work shipped in table-toolbar size/chrome fixes, anchor popover reuse guard, token-layer light-dark cleanup (gh#1852), side-by-side docs demos. See `packages/web-components/CHANGELOG.md#0847--2026-08-22` for details.
+- **`.claude-plugin/plugin.json` version bump** — moves in lockstep with package.json (the `/plugin update` cache key).
+
+## [0.8.46] — 2026-08-22
+
+
+### Maintenance
+- **`.claude-plugin/plugin.json` version bump** — moves in lockstep with package.json (the `/plugin update` cache key).
+- **`skills/` touched in this release window** (3 file(s), e.g. `references/annotations.yaml`) — carried by the entries above.
+
 ## [0.8.45] — 2026-08-20
 
 ### Changed

package/README.md

@@ -98,7 +98,7 @@ surface-qa-agent) · `component-model.md` · the `references/contracts/` twins.
 
 ## MCP
 
-`adia-gen-ui` server pinned: `@adia-ai/mcp@0.8.45` (tool SoT:
+`adia-gen-ui` server pinned: `@adia-ai/mcp@0.8.47` (tool SoT:
 `packages/gen-ui/mcp/TOOLS.md` — the `gen-ui` section; stability rule in
 `references/contracts/`; pin lives in `.mcp.json` — `check:plugin-count-claims`
 guards this README copy against it). The server is `adia-mcp gen-ui`,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@adia-ai/adia-ui-factory",
-  "version": "0.8.45",
+  "version": "0.8.47",
   "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/pattern-catalog/references/annotations.yaml

@@ -158,6 +158,19 @@
     - sparkline
     - metric tile
     - graph
+/packages/web-components/patterns/new-enrollments/new-enrollments.examples.html:
+  category: data-viz
+  intent: A "New enrollments" dashboard card recreated across four chart-type variants (stacked-bar, area, sparkline, radial-bar) sharing one header grammar, composing the Charts 2.0 foundations (chip labels, today-marker, provisional state, legend band).
+  keywords:
+    - new enrollments
+    - dashboard card
+    - stacked bar
+    - area chart
+    - sparkline
+    - radial bar
+    - provisional state
+    - today marker
+    - legend band
 /site/pages/patterns/charts.html:
   category: data-viz
   intent: Full live-demo reference for Charts 2.0 — all 18 chart-ui types, the ADR-0074 ratio grammar (auto-snap + explicit pin), chart-legend-ui's ratio-responsive row/grid/list layouts, the chart-in-card full-bleed pattern, and every ratified chart-ui attribute.
@@ -451,6 +464,16 @@
     - guided setup
     - progress
     - steps
+/packages/web-components/patterns/table-in-card/table-in-card.examples.html:
+  category: data-table
+  intent: The full table structural system in a card — header title/action, a title-less toolbar row, a bleed table, and a footer with a range label + pager — reach for it for any card-framed data grid that needs a pager.
+  keywords:
+    - data grid
+    - pagination
+    - table footer
+    - table toolbar
+    - status dot
+    - kebab actions
 /apps/overview.examples.html:
   category: app-overview
   intent: Index page cataloguing full-page AdiaUI example compositions — reach for it as a docs gallery landing that lists the available demo screens.

package/skills/pattern-catalog/references/pattern-index.md

@@ -4,7 +4,7 @@
 
 # Pre-assembled patterns & templates index
 
-169 reusable assembled surfaces: 48 patterns (composed component arrangements) and 121 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 gen-ui-wiring's runtime-generated pattern).
+171 reusable assembled surfaces: 50 patterns (composed component arrangements) and 121 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 gen-ui-wiring's runtime-generated pattern).
 
 ## Patterns
 
@@ -59,21 +59,29 @@
   - keywords: facet, chips, refine, narrow, segment, query
   - components: `action-item-ui` `tag-ui` `button-ui` `segment-ui` `card-ui` `row-ui` `action-list-ui` `code-ui` `popover-ui` `search-ui` `segmented-ui` `table-ui` `text-ui` `toolbar-ui`
   - source: `/packages/web-components/patterns/filter-bar/filter-bar.examples.html` · demo: `/packages/web-components/patterns/filter-bar/filter-bar.html` · docs: `/site/patterns/filter-bar`
+- **Table in Card** (Patterns) — The full table structural system in a card — header title/action, a title-less toolbar row, a bleed table, and a footer with a range label + pager — reach for it for any card-framed data grid that needs a pager.
+  - keywords: data grid, pagination, table footer, table toolbar, status dot, kebab actions
+  - components: `card-ui` `table-footer-ui` `table-toolbar-ui` `table-ui` `button-ui` `code-ui`
+  - source: `/packages/web-components/patterns/table-in-card/table-in-card.examples.html` · demo: `/packages/web-components/patterns/table-in-card/table-in-card.html` · docs: `/site/patterns/table-in-card`
 
 ### data-viz
 
 - **Chart in Card** (Patterns) — Embeds a chart inside a card so it reads as a dashboard tile — sparkline tile, full framed chart, or chart-plus-headline-stat.
   - keywords: dashboard tile, kpi tile, sparkline, metric tile, graph
-  - components: `card-ui` `chart-ui` `text-ui` `stat-ui` `chart-legend-ui` `segment-ui` `button-ui` `code-ui` `col-ui` `grid-ui` `segmented-ui`
+  - components: `card-ui` `chart-ui` `text-ui` `chart-legend-ui` `stat-ui` `segment-ui` `button-ui` `code-ui` `col-ui` `grid-ui` `segmented-ui`
   - source: `/packages/web-components/patterns/chart-in-card/chart-in-card.examples.html` · demo: `/packages/web-components/patterns/chart-in-card/chart-in-card.html` · docs: `/site/patterns/chart-in-card`
 - **Charts** (Patterns) — Full live-demo reference for Charts 2.0 — all 18 chart-ui types, the ADR-0074 ratio grammar (auto-snap + explicit pin), chart-legend-ui's ratio-responsive row/grid/list layouts, the chart-in-card full-bleed pattern, and every ratified chart-ui attribute.
   - keywords: chart types, ratio grammar, chart legend, full bleed, ADR-0074, data visualization
-  - components: `segment-ui` `chart-ui` `card-ui` `text-ui` `segmented-ui` `code-ui` `chart-legend-ui` `alert-ui` `grid-ui`
+  - components: `segment-ui` `chart-ui` `card-ui` `text-ui` `segmented-ui` `chart-legend-ui` `code-ui` `button-ui` `grid-ui` `row-ui` `select-ui` `alert-ui`
   - source: `/site/pages/patterns/charts.html` · docs: `/site/patterns/charts`
 - **Conversion Funnel** (Patterns) — Multi-step drop-off funnel built from labeled progress rows — reach for onboarding, checkout, activation, or paywall sequences.
   - keywords: drop-off, activation, checkout steps, sign-up flow, progress rows
   - components: `text-ui` `progress-ui` `col-ui` `badge-ui` `card-ui` `row-ui` `segment-ui` `button-ui` `segmented-ui`
   - source: `/packages/web-components/patterns/conversion-funnel/conversion-funnel.examples.html` · demo: `/packages/web-components/patterns/conversion-funnel/conversion-funnel.html` · docs: `/site/patterns/conversion-funnel`
+- **New Enrollments** (Patterns) — A "New enrollments" dashboard card recreated across four chart-type variants (stacked-bar, area, sparkline, radial-bar) sharing one header grammar, composing the Charts 2.0 foundations (chip labels, today-marker, provisional state, legend band).
+  - keywords: new enrollments, dashboard card, stacked bar, area chart, sparkline, radial bar, provisional state, today marker, legend band
+  - components: `button-ui` `card-ui` `chart-ui` `row-ui` `select-ui` `chart-legend-ui`
+  - source: `/packages/web-components/patterns/new-enrollments/new-enrollments.examples.html` · demo: `/packages/web-components/patterns/new-enrollments/new-enrollments.html` · docs: `/site/patterns/new-enrollments`
 - **Retention Cohort** (Patterns) — Retention cohort heatmap rendered as a table with color-bucketed badge cells — reach for it for retention/decay reporting.
   - keywords: heatmap, churn, decay, weekly buckets, engagement grid
   - components: `card-ui` `badge-ui` `table-ui` `text-ui` `stat-ui` `code-ui` `grid-ui` `row-ui`

package/skills/table-composition/references/base-table.md

@@ -176,8 +176,22 @@ they're documented alongside the real `sortFn`.
   it doesn't reduce total DOM churn across pages). For genuinely huge collections (1,000+ rows —
   chat threads, feeds, log streams), reach for `list-window-ui` instead, a different primitive
   that windows to only the visible slice; it is not table-shaped (no columns/header/sort), so it
-  fits a single-column list read, not a multi-column grid. Wire `[paginate]` with `[search]` and
-  the `page` event for server-driven pagination.
+  fits a single-column list read, not a multi-column grid. **Server-driven pagination (gh#1754,
+  ADR-0082)** — set `paginate="N"` (page size) TOGETHER with `range-total="M"` (the server's total
+  row count across all pages): `[paginate]` becomes purely presentational (no local slicing —
+  `.data` IS the current server page and renders whole, after any local search/sort/filter), the
+  internal pager's page count derives from `range-total`, and the existing `page` event (0-based)
+  becomes the fetch trigger — listen for it, fetch that server page, write the rows back to
+  `.data` (the page position holds; no reset) — **except** when a NEW `range-total` shrinks the
+  page count below the current page: `table-ui` clamps the RENDERED page to the last valid page
+  in that case (a render-time display clamp, never a `page` event dispatch — REQ-D-005), so a
+  consumer must not assume every server response preserves an out-of-range page. `range-total` is presence-gated: absent means
+  client mode (today's behavior); an explicit `range-total="0"` is server-confirmed empty, not
+  "not yet known." A bound `table-footer-ui` is optional chrome in this shape (it derives its own
+  range label from the table's `range-total` with zero footer attributes) — or omit the footer
+  entirely and let the table's own internal pager work server-side alone, the ticket's literal
+  headline case. See table.yaml's `[range-total]` prop doc and
+  `docs/ops/adr/adr-0082-table-ui-server-range-total.md` for the full contract.
 
 ## table-toolbar-ui — the companion search/filter/sort/columns bar