@adia-ai/a2ui-corpus 0.4.1 → 0.4.3

package/CHANGELOG.md

@@ -19,6 +19,34 @@ gap registry. Consumed by `@adia-ai/a2ui-retrieval` and
 
 _No pending changes._
 
+## [0.4.3] - 2026-05-11
+
+### Changed
+
+- **`catalog-a2ui_0_9.json` regenerated** to pick up the new `locale` prop on `<input-ui type="number">` from `@adia-ai/web-components@0.4.3`. The yaml `props:` entry drives retrieval signal for locale-aware numeric-input intents.
+- **`chunks/` re-harvested** (181 files touched). New chunk `settings-appearance.json` — multi-instance record covering both `catalog/ui-patterns/app/settings-appearance/` (primary=card-ui, standalone block pattern composing `<theme-panel>`) and `apps/saas/app/settings-page/` (primary=div, Workspace-level Appearance section). Plus a sweep of `captured_at` timestamps + `source:` field updates from the ADR-0026 reorg follow-up. Harvest now produces 180 unique chunks (was 179 in v0.4.2; +1 from the new `settings-appearance` pattern).
+- **Harvester scope fix** — `scripts/build/harvest-chunks.mjs` `SOURCES = ['site/pages', 'apps']` hadn't been updated after ADR-0026 split `apps/` → `apps/` + `playgrounds/` + `catalog/` on 2026-05-10. Every `npm run harvest:chunks` since silently dropped 26 chunks (179 unique → 152 visible) without warning. Fix adds both new sibling directories to SOURCES. (Note: harvest-chunks.mjs lives in the repo's `scripts/build/` tree, not the package; this corpus regen captures the FULL chunk set restored by the fix. Lesson captured as Category E imperative-drift in user-memory entry `feedback_build_script_sources_list_after_rename.md`.)
+
+### Lockstep
+
+9-package coordinated PATCH cut to v0.4.3. Internal `@adia-ai/*` dep ranges stay at `^0.4.0` (patch-cut asymmetry). Rides alongside `@adia-ai/web-components` v0.4.3 (input-ui locale rewrite) and `@adia-ai/a2ui-compose` + `@adia-ai/a2ui-retrieval` v0.4.3 (process.env browser-compat fix). See root [CHANGELOG.md `## [0.4.3]`](../../../CHANGELOG.md).
+
+## [0.4.2] - 2026-05-11
+
+### Changed
+
+- `catalog-a2ui_0_9.json` regenerated to pick up the 5 new `<input-ui type="number">` examples from `@adia-ai/web-components@0.4.2`: `quantity-stepper`, `price-with-currency`, `weight-with-unit`, `percent-bounded`, `temperature-negative`. The yaml `examples[]` entries drive retrieval signal for numeric-input intents (quantity / price / weight / percent / temperature).
+- `catalog-a2ui_0_9_rules.txt` regenerated alongside.
+- `chunks/` — `playground-app-shell.json` re-harvested after the `<theme-panel>` consumer migration (Phase 3 of theme-panel work): embedded HTML now shows `<theme-panel slot="content" parametric presets scheme-toggle></theme-panel>` instead of the ~30-line inline `<div id="theme-panel">` block. Chunk NAME `playground-app-shell` preserved as a stable retrieval identifier per the 2026-05-10 §22 lesson. 27 additional chunk files touched in this window for `source:` field updates following the ADR-0026 reorg (`apps/<X>/` → `playgrounds/<X>/` or `catalog/<X>/`); chunk NAMES unchanged.
+
+### Removed
+
+- `fragments/layout/auth-card-header.json` — fragment retired (was the foundational auth-flow chunk header before migration to `<auth-card-content>` + `<auth-card-header>` chunk-level shape; instance_count had reconciled to 0 in v0.4.1, no longer present in any composition). Now archived at `.brain/archive/2026-Q2/retired-fragments/auth-card-header.md` per the v0.4.1 follow-up.
+
+### Lockstep
+
+9-package coordinated PATCH cut to v0.4.2 (per [`docs/specs/package-architecture.md` § 15](../../../docs/specs/package-architecture.md#15-versioning-policy)). Internal `@adia-ai/*` dep ranges stay at `^0.4.0` (patch-cut asymmetry — `^0.4.0` covers `0.4.x` under semver). Rides alongside `@adia-ai/web-components@0.4.2` (input-ui type=number rewrite) and `@adia-ai/web-modules@0.4.2` (editor-sidebar width mirror). See root [CHANGELOG.md `## [0.4.2]`](../../../CHANGELOG.md) for the cut narrative.
+
 ## [0.4.1] - 2026-05-10
 
 ### Changed

package/README.md

@@ -11,6 +11,14 @@ fixtures. Pure data plus the scripts that maintain it. No runtime.
 > registry, streams, wiring),
 > [`@adia-ai/a2ui-mcp`](../mcp) for the MCP server.
 
+## Install
+
+```bash
+npm install @adia-ai/a2ui-corpus
+```
+
+Pure data — typically consumed transitively by [`@adia-ai/a2ui-compose`](../compose) and [`@adia-ai/a2ui-mcp`](../mcp), which list it as a runtime dependency. Direct installs are useful for offline eval tooling or building bespoke retrieval layers.
+
 ## Dependency direction
 
 ```

package/catalog-a2ui_0_9.json

@@ -7550,7 +7550,7 @@
     },
     "Input": {
       "title": "Input",
-      "description": "Text input field with contenteditable or native input. Supports prefix/suffix icons, label, and form participation.",
+      "description": "Text input field with contenteditable surface. Supports prefix/suffix icons, label, form participation, and a `type=\"number\"` mode that renders [+]/[-] stepper buttons, numeric input filtering, and ARIA spinbutton semantics — no native `<input type=\"number\">` under the hood. Password type uses a native `<input>` (only path that still wraps native, for `-webkit-text-security` disc masking).",
       "type": "object",
       "allOf": [
         {
@@ -7562,7 +7562,7 @@
       ],
       "properties": {
         "type": {
-          "description": "Input type hint. Password type applies disc masking via -webkit-text-security.",
+          "description": "Input type. `password` wraps a native `<input>` for disc masking; `number` renders a contenteditable + stepper buttons (no native input). All other types use plain contenteditable.",
           "type": "string",
           "enum": [
             "text",
@@ -7604,11 +7604,26 @@
           "type": "string",
           "default": ""
         },
+        "locale": {
+          "description": "BCP-47 locale tag for `type=\"number\"`, e.g. `de-DE`, `fr-FR`, `en-IN`. When set, the input accepts both `.` AND the locale's decimal separator (e.g. `,` in de-DE), uses `Intl.NumberFormat` for display, and groups thousands on blur (e.g. en-US `1,234,567.89`, de-DE `1.234.567,89`). On focus, the input reverts to ungrouped form for easy editing. `.value` always stores the ungrouped, locale-decimal form so `Number(#toCanonical(v))` round-trips. Default empty = en-US-equivalent path (no behavior change).",
+          "type": "string",
+          "default": ""
+        },
+        "max": {
+          "description": "Maximum numeric value. Applies when `type=\"number\"`. Clamps + drives aria-valuemax + the [+] button's disabled state.",
+          "type": "number",
+          "default": null
+        },
         "maxlength": {
           "description": "Maximum character length for validation",
           "type": "number",
           "default": null
         },
+        "min": {
+          "description": "Minimum numeric value. Applies when `type=\"number\"`. Clamps + drives aria-valuemin + the [-] button's disabled state.",
+          "type": "number",
+          "default": null
+        },
         "minlength": {
           "description": "Minimum character length for validation",
           "type": "number",
@@ -7629,6 +7644,11 @@
           "type": "string",
           "default": ""
         },
+        "precision": {
+          "description": "Decimal places to display + clamp to, when `type=\"number\"`. Overrides the implicit decimal-count from `step` — e.g. `step=1 precision=2` formats \"10.00\".",
+          "type": "number",
+          "default": null
+        },
         "prefix": {
           "description": "Prefix text or icon rendered before the text surface (e.g., unit label, search icon)",
           "type": "string",
@@ -7644,13 +7664,18 @@
           "type": "boolean",
           "default": false
         },
+        "step": {
+          "description": "Stepper increment for `type=\"number\"`. Drives ↑/↓ ArrowUp/Down + [+]/[-] button magnitude. Also determines decimal-count for value formatting unless `precision` is set.",
+          "type": "number",
+          "default": 1
+        },
         "suffix": {
           "description": "Suffix text rendered after the text surface (e.g., unit like 'kg')",
           "type": "string",
           "default": ""
         },
         "value": {
-          "description": "Current input value, synced with contenteditable text surface",
+          "description": "Current input value, synced with contenteditable text surface. For `type=\"number\"`, this is the formatted numeric string; read `el.valueAsNumber` for the parsed Number.",
           "type": "string",
           "default": ""
         }
@@ -7664,16 +7689,41 @@
         "category": "input",
         "events": {
           "change": {
-            "description": "Fired on blur after the value has changed (bubbles)"
+            "description": "Fired on blur, Enter, or a stepper-button click (bubbles)"
           },
           "input": {
-            "description": "Fired on each keystroke as the user types (bubbles)"
+            "description": "Fired on each keystroke or stepper-button increment (bubbles)"
           },
           "submit": {
-            "description": "Fired when the form is submitted."
+            "description": "Fired when Enter commits the value."
           }
         },
         "examples": [
+          {
+            "description": "Number input with [+]/[-] stepper buttons, min/max bounds, and a quantity label. Use for product quantity, item count, or any bounded integer input.",
+            "a2ui": "[\n  {\"id\": \"root\", \"component\": \"Field\", \"label\": \"Quantity\",\n   \"children\": [\"qty\"]},\n  {\"id\": \"qty\", \"component\": \"Input\", \"type\": \"number\",\n   \"name\": \"quantity\", \"value\": \"1\", \"min\": 0, \"max\": 99, \"step\": 1}\n]",
+            "name": "quantity-stepper"
+          },
+          {
+            "description": "Currency number input with $ prefix, 2-decimal precision, and step 0.01. The stepper buttons increment by one cent.",
+            "a2ui": "[\n  {\"id\": \"root\", \"component\": \"Field\", \"label\": \"Price\",\n   \"children\": [\"price\"]},\n  {\"id\": \"price\", \"component\": \"Input\", \"type\": \"number\",\n   \"name\": \"price\", \"value\": \"9.99\", \"min\": 0, \"step\": 0.01,\n   \"precision\": 2, \"prefix\": \"$\"}\n]",
+            "name": "price-with-currency"
+          },
+          {
+            "description": "Weight number input with a kg suffix and 0.1 step for decigram precision.",
+            "a2ui": "[\n  {\"id\": \"root\", \"component\": \"Field\", \"label\": \"Weight\",\n   \"children\": [\"weight\"]},\n  {\"id\": \"weight\", \"component\": \"Input\", \"type\": \"number\",\n   \"name\": \"weight\", \"value\": \"70\", \"min\": 0, \"max\": 500,\n   \"step\": 0.1, \"suffix\": \"kg\"}\n]",
+            "name": "weight-with-unit"
+          },
+          {
+            "description": "Percent number input bounded 0..100 with a % suffix.",
+            "a2ui": "[\n  {\"id\": \"root\", \"component\": \"Field\", \"label\": \"Discount\",\n   \"children\": [\"pct\"]},\n  {\"id\": \"pct\", \"component\": \"Input\", \"type\": \"number\",\n   \"name\": \"discount\", \"value\": \"25\", \"min\": 0, \"max\": 100,\n   \"step\": 5, \"suffix\": \"%\"}\n]",
+            "name": "percent-bounded"
+          },
+          {
+            "description": "Number input allowing negative values, e.g. temperature offset.",
+            "a2ui": "[\n  {\"id\": \"root\", \"component\": \"Field\", \"label\": \"Temperature offset\",\n   \"children\": [\"temp\"]},\n  {\"id\": \"temp\", \"component\": \"Input\", \"type\": \"number\",\n   \"name\": \"temp\", \"value\": \"0\", \"min\": -100, \"max\": 100,\n   \"step\": 1, \"suffix\": \"°C\"}\n]",
+            "name": "temperature-negative"
+          },
           {
             "description": "Chat interface with message bubbles containing avatar and text pairs, plus an input footer.",
             "a2ui": "[\n  {\n    \"id\": \"root\",\n    \"component\": \"Card\",\n    \"children\": [\n      \"hdr\",\n      \"sec\",\n      \"ftr\"\n    ]\n  },\n  {\n    \"id\": \"hdr\",\n    \"component\": \"Header\",\n    \"children\": [\n      \"title\"\n    ]\n  },\n  {\n    \"id\": \"title\",\n    \"component\": \"Text\",\n    \"slot\": \"heading\",\n    \"textContent\": \"Chat\"\n  },\n  {\n    \"id\": \"sec\",\n    \"component\": \"Section\",\n    \"children\": [\n      \"messages\"\n    ]\n  },\n  {\n    \"id\": \"messages\",\n    \"component\": \"Column\",\n    \"gap\": \"3\",\n    \"children\": [\n      \"msg1\",\n      \"msg2\",\n      \"msg3\",\n      \"msg4\"\n    ]\n  },\n  {\n    \"id\": \"msg1\",\n    \"component\": \"Row\",\n    \"gap\": \"2\",\n    \"children\": [\n      \"a1\",\n      \"t1\"\n    ]\n  },\n  {\n    \"id\": \"a1\",\n    \"component\": \"Avatar\",\n    \"name\": \"User\",\n    \"size\": \"sm\"\n  },\n  {\n    \"id\": \"t1\",\n    \"component\": \"Text\",\n    \"variant\": \"body\",\n    \"textContent\": \"Hello! Can you help me with something?\"\n  },\n  {\n    \"id\": \"msg2\",\n    \"component\": \"Row\",\n    \"gap\": \"2\",\n    \"children\": [\n      \"a2\",\n      \"t2\"\n    ]\n  },\n  {\n    \"id\": \"a2\",\n    \"component\": \"Avatar\",\n    \"name\": \"Assistant\",\n    \"size\": \"sm\"\n  },\n  {\n    \"id\": \"t2\",\n    \"component\": \"Text\",\n    \"variant\": \"body\",\n    \"textContent\": \"Of course! I'd be happy to help. What do you need?\"\n  },\n  {\n    \"id\": \"msg3\",\n    \"component\": \"Row\",\n    \"gap\": \"2\",\n    \"children\": [\n      \"a3\",\n      \"t3\"\n    ]\n  },\n  {\n    \"id\": \"a3\",\n    \"component\": \"Avatar\",\n    \"name\": \"User\",\n    \"size\": \"sm\"\n  },\n  {\n    \"id\": \"t3\",\n    \"component\": \"Text\",\n    \"variant\": \"body\",\n    \"textContent\": \"I need to build a dashboard layout.\"\n  },\n  {\n    \"id\": \"msg4\",\n    \"component\": \"Row\",\n    \"gap\": \"2\",\n    \"children\": [\n      \"a4\",\n      \"t4\"\n    ]\n  },\n  {\n    \"id\": \"a4\",\n    \"component\": \"Avatar\",\n    \"name\": \"Assistant\",\n    \"size\": \"sm\"\n  },\n  {\n    \"id\": \"t4\",\n    \"component\": \"Text\",\n    \"variant\": \"body\",\n    \"textContent\": \"Great choice! Let me suggest some patterns for that.\"\n  },\n  {\n    \"id\": \"ftr\",\n    \"component\": \"Footer\",\n    \"children\": [\n      \"input-row\"\n    ]\n  },\n  {\n    \"id\": \"input-row\",\n    \"component\": \"Row\",\n    \"gap\": \"2\",\n    \"children\": [\n      \"chat-input\",\n      \"send-btn\"\n    ]\n  },\n  {\n    \"id\": \"chat-input\",\n    \"component\": \"Input\",\n    \"placeholder\": \"Type a message...\"\n  },\n  {\n    \"id\": \"send-btn\",\n    \"component\": \"Button\",\n    \"text\": \"Send\",\n    \"icon\": \"send\",\n    \"variant\": \"primary\"\n  }\n]",
@@ -13898,6 +13948,177 @@
         "version": 1
       }
     },
+    "ThemePanel": {
+      "title": "ThemePanel",
+      "description": "Module-tier appearance-preferences control surface. Owns the three knobs\nof the AdiaUI theming contract: [data-theme=<slug>] named themes,\n--a-density / --a-radius-k parametric overrides, and color-scheme\nlight/dark switching, plus optional localStorage persistence behind a\nsmall attribute API.\n\nDrops into any consumer's <popover-ui slot=\"content\"> (the canonical\ncomposition) or directly into a sidebar section. Eight named themes\nship by default; section visibility flips on/off via boolean attributes\n([parametric], [presets], [scheme-toggle]).\n\nPromoted from the duplicated <div id=\"theme-panel\"> block in site/ and\nplaygrounds/admin-shell/ — see docs/specs/theme-panel-module.md.\n",
+      "type": "object",
+      "allOf": [
+        {
+          "$ref": "#/$defs/ComponentCommon"
+        },
+        {
+          "$ref": "#/$defs/CatalogComponentCommon"
+        }
+      ],
+      "properties": {
+        "active-density": {
+          "description": "Reflected — mirrors the current --a-density value on the target\nelement. Stringified number.\n",
+          "type": "string",
+          "default": ""
+        },
+        "active-radius": {
+          "description": "Reflected — mirrors the current --a-radius-k value on the target\nelement. Stringified number.\n",
+          "type": "string",
+          "default": ""
+        },
+        "active-scheme": {
+          "description": "Reflected — the resolved color-scheme (auto collapsed to a\nconcrete value). Either \"light\" or \"dark\".\n",
+          "type": "string",
+          "default": ""
+        },
+        "active-theme": {
+          "description": "Reflected — the currently selected theme slug. Empty string when\nunset (default theme). Read-only externally; use .apply({theme})\nto change.\n",
+          "type": "string",
+          "default": ""
+        },
+        "component": {
+          "const": "ThemePanel"
+        },
+        "parametric": {
+          "description": "Renders the density + radius slider block. Sliders bind to\n--a-density and --a-radius-k on the target element.\n",
+          "type": "boolean",
+          "default": false
+        },
+        "persist": {
+          "description": "Persists selections to localStorage. Defaults to ephemeral so\nplaygrounds and embedded demos do not silently mutate a user's\ndocs-shell preferences.\n",
+          "type": "boolean",
+          "default": false
+        },
+        "presets": {
+          "description": "Renders the compact / reset / spacious preset row. Each preset\napplies a (density, radius) pair; \"default\" also clears the\n[data-theme] attribute.\n",
+          "type": "boolean",
+          "default": false
+        },
+        "scheme": {
+          "description": "Initial color-scheme. \"auto\" follows prefers-color-scheme via a\nmatchMedia listener; user clicks on the scheme toggle promote to\nan explicit light or dark choice.\n",
+          "type": "string",
+          "enum": [
+            "light",
+            "dark",
+            "auto"
+          ],
+          "default": "auto"
+        },
+        "scheme-toggle": {
+          "description": "Renders an integrated light/dark <segmented-ui> at the top of the\npanel. When absent, the panel omits scheme entirely — consumers\ncan still drive scheme via the .apply({scheme}) public method.\n",
+          "type": "boolean",
+          "default": false
+        },
+        "storage-prefix": {
+          "description": "Namespace for localStorage keys when [persist] is set. Four keys\nare written: {prefix}theme, {prefix}scheme, {prefix}density,\n{prefix}radius.\n",
+          "type": "string",
+          "default": "adia-theme-"
+        },
+        "target": {
+          "description": "CSS selector for the element that receives [data-theme] and\n--a-density / --a-radius-k writes. Defaults to :root (the\n<html> element). Scoped targets are useful for preview-pane\ndemos.\n",
+          "type": "string",
+          "default": ":root"
+        },
+        "themes": {
+          "description": "Space-separated list of theme slugs to render as buttons. Author\nmay restrict ([themes=\"default ocean\"]) or extend. Tolerant —\nunknown slugs render a button; clicking applies [data-theme=slug]\nregardless of whether themes.css has a matching block.\n",
+          "type": "string",
+          "default": "default ocean forest sunset lavender rose slate midnight"
+        }
+      },
+      "required": [
+        "component"
+      ],
+      "unevaluatedProperties": false,
+      "x-adiaui": {
+        "anti_patterns": [],
+        "category": "layout",
+        "events": {
+          "theme-change": {
+            "description": "Bubbles when any user-visible state changes (theme click, slider\ninput, preset click, scheme flip, reset). One event per change.\nNo event on auto-rehydrate-from-storage at boot.\n",
+            "detail": {
+              "theme": "string",
+              "density": "number",
+              "radius": "number",
+              "scheme": "string",
+              "source": "string"
+            }
+          }
+        },
+        "examples": [],
+        "keywords": [
+          "theme",
+          "theme-panel",
+          "palette",
+          "density",
+          "radius",
+          "scheme",
+          "dark-mode",
+          "light-mode",
+          "color-scheme",
+          "preferences",
+          "settings",
+          "color",
+          "appearance",
+          "skin"
+        ],
+        "name": "ThemePanel",
+        "related": [
+          "Popover",
+          "Button",
+          "Slider",
+          "Field",
+          "Divider",
+          "Text",
+          "Segmented",
+          "AdminShell"
+        ],
+        "slots": {},
+        "states": [
+          {
+            "description": "Default — panel rendered, awaiting input.",
+            "name": "idle"
+          },
+          {
+            "description": "[persist] is set; selections write to localStorage under\n[storage-prefix].\n",
+            "attribute": "persist",
+            "name": "persisted"
+          },
+          {
+            "description": "[scheme=\"auto\"] and no user override this session; a\nprefers-color-scheme listener reapplies on system flip.\n",
+            "name": "scheme-auto"
+          }
+        ],
+        "synonyms": {
+          "theme": [
+            "palette",
+            "skin",
+            "appearance"
+          ],
+          "density": [
+            "compactness",
+            "spacing-scale"
+          ],
+          "radius": [
+            "corner-roundness",
+            "border-radius"
+          ],
+          "scheme": [
+            "mode",
+            "color-scheme",
+            "dark-mode"
+          ]
+        },
+        "tag": "theme-panel",
+        "tokens": {},
+        "traits": [],
+        "version": 1
+      }
+    },
     "Timeline": {
       "title": "Timeline",
       "description": "Timeline and step wizard. Two modes: timeline (per-item state) and steps (parent-driven).",

package/catalog-a2ui_0_9_rules.txt

@@ -106,3 +106,8 @@
 - simple-shell is the bespoke shell for thin / minimal page surfaces. Use when the page has no nav rail, no chrome bars, no command palette. For full app surfaces use admin-shell; for chat surfaces use chat-shell; for design tools use editor-shell.
 - Compose with <simple-hero> (optional top hero strip) and <simple-content> (main article body). Both are CSS-only structural children — no JS, no state.
 
+## ThemePanel
+- theme-panel is the canonical appearance-preferences popover. Compose inside a <popover-ui slot="content"> in the topbar of a shell (admin, chat, editor, simple) when the page exposes user theming. Avoid hardcoding it as a shell child — placement is the consumer's call.
+- Use [persist] for the docs surface or a real product app; omit [persist] for playgrounds and embedded demos so state stays ephemeral. The default is ephemeral.
+- Add boolean attributes [parametric], [presets], [scheme-toggle] to enable sections; the minimum panel is the theme button grid.
+