@adia-ai/a2ui-corpus 0.4.0 → 0.4.2

package/CHANGELOG.md

@@ -19,6 +19,34 @@ gap registry. Consumed by `@adia-ai/a2ui-retrieval` and
 
 _No pending changes._
 
+## [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
+
+- **Fragment metrics reconciled** — 28 fragments updated to match computed values from `npm run audit:fragments`. 45 files modified (28 JSON + 17 YAML; 11 JSON have no YAML sibling). `audit:fragments` now reports 0 drift.
+- **Special note: auth-card-header** instance_count reconciled from 23 → 0 (fragment no longer used by any composition). Pending decision on whether to deprecate or re-introduce.
+- Catalog regenerated to include 3 new simple-cluster yamls (121 total).
+
+### Added
+
+- `docs/reports/chunk-reconcile-triage-2026-05-10.md` — triage doc documenting that all current `audit:chunk-reconcile` findings (9 fingerprint collisions + 19 near-duplicates + 10 cross-source) are intentional outcomes of the onb/reg alignment work + foundational shared chunks.
+
 ## [0.4.0] - 2026-05-10
 
 ### Ride-along (no corpus changes)

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,21 @@
           "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 +7639,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 +7659,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 +7684,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]",
@@ -11291,6 +11336,230 @@
         "version": 1
       }
     },
+    "SimpleContent": {
+      "title": "SimpleContent",
+      "description": "Module-tier article-body container. CSS-only — no JS, no state.\nSits inside <simple-shell> as the main content surface with\ntoken-correct vertical rhythm and prose-friendly max-width.\n\nCompanion to <simple-hero> (optional top strip) per ADR-0023\nbespoke shell-tier children.\n",
+      "type": "object",
+      "allOf": [
+        {
+          "$ref": "#/$defs/ComponentCommon"
+        },
+        {
+          "$ref": "#/$defs/CatalogComponentCommon"
+        }
+      ],
+      "properties": {
+        "component": {
+          "const": "SimpleContent"
+        }
+      },
+      "required": [
+        "component"
+      ],
+      "unevaluatedProperties": false,
+      "x-adiaui": {
+        "anti_patterns": [],
+        "category": "shells",
+        "events": {},
+        "examples": [],
+        "keywords": [
+          "simple-content",
+          "article",
+          "body",
+          "prose",
+          "main-content",
+          "landing-body",
+          "marketing-body"
+        ],
+        "name": "SimpleContent",
+        "related": [
+          "SimpleShell",
+          "SimpleHero"
+        ],
+        "slots": {
+          "default": {
+            "description": "Article body content — prose, code blocks, illustrations. Authors compose freely; <simple-content> provides only the container with sensible defaults (vertical rhythm, max-width, typography token application)."
+          }
+        },
+        "states": [
+          {
+            "description": "Default, visible.",
+            "name": "idle"
+          }
+        ],
+        "synonyms": {
+          "simple-content": [
+            "page-content",
+            "article-body",
+            "prose-container",
+            "main-body"
+          ]
+        },
+        "tag": "simple-content",
+        "tokens": {},
+        "traits": [],
+        "version": 1
+      }
+    },
+    "SimpleHero": {
+      "title": "SimpleHero",
+      "description": "Module-tier hero strip for the top of marketing / landing / error\npages. CSS-only — no JS, no state. Three named slots (heading, lede,\nactions) carry the canonical hero composition.\n\nSits inside <simple-shell> above <simple-content>. Companion to\n<simple-content> per ADR-0023 bespoke shell-tier children.\n",
+      "type": "object",
+      "allOf": [
+        {
+          "$ref": "#/$defs/ComponentCommon"
+        },
+        {
+          "$ref": "#/$defs/CatalogComponentCommon"
+        }
+      ],
+      "properties": {
+        "component": {
+          "const": "SimpleHero"
+        }
+      },
+      "required": [
+        "component"
+      ],
+      "unevaluatedProperties": false,
+      "x-adiaui": {
+        "anti_patterns": [],
+        "category": "shells",
+        "events": {},
+        "examples": [],
+        "keywords": [
+          "simple-hero",
+          "hero",
+          "splash",
+          "landing-hero",
+          "marketing-hero",
+          "intro",
+          "page-title"
+        ],
+        "name": "SimpleHero",
+        "related": [
+          "SimpleShell",
+          "SimpleContent"
+        ],
+        "slots": {
+          "default": {
+            "description": "Optional inline content if the named slots are insufficient."
+          },
+          "actions": {
+            "description": "Action row (button-ui, link-ui) for primary CTAs."
+          },
+          "heading": {
+            "description": "Large display heading (h1) — the page title."
+          },
+          "lede": {
+            "description": "Lead paragraph below heading — short summary or CTA tagline."
+          }
+        },
+        "states": [
+          {
+            "description": "Default, visible.",
+            "name": "idle"
+          }
+        ],
+        "synonyms": {
+          "simple-hero": [
+            "page-hero",
+            "splash-hero",
+            "landing-hero",
+            "intro-strip"
+          ]
+        },
+        "tag": "simple-hero",
+        "tokens": {},
+        "traits": [],
+        "version": 1
+      }
+    },
+    "SimpleShell": {
+      "title": "SimpleShell",
+      "description": "Module-tier minimal shell for marketing / landing / error pages.\nBehavior-only orchestrator with two reflected attributes — [centered]\nfor vertical centering, [full-bleed] for dropping the max-width\nconstraint.\n\nThe 4th cluster in the bespoke shell family per ADR-0023, designed\ndeliberately small (1 host + 2 CSS-only children) to demonstrate\nthe pattern works without ceremony for thin clusters.\n\nUse cases: marketing splashes, error pages (404 / 500 / maintenance),\nthank-you pages, single-card flows (sign-in, password reset).\n",
+      "type": "object",
+      "allOf": [
+        {
+          "$ref": "#/$defs/ComponentCommon"
+        },
+        {
+          "$ref": "#/$defs/CatalogComponentCommon"
+        }
+      ],
+      "properties": {
+        "centered": {
+          "description": "Reflected — vertically centers content in viewport.",
+          "type": "boolean",
+          "default": false
+        },
+        "component": {
+          "const": "SimpleShell"
+        },
+        "full-bleed": {
+          "description": "Reflected — drops the default max-width so content fills full viewport.",
+          "type": "boolean",
+          "default": false
+        }
+      },
+      "required": [
+        "component"
+      ],
+      "unevaluatedProperties": false,
+      "x-adiaui": {
+        "anti_patterns": [],
+        "category": "shells",
+        "events": {},
+        "examples": [],
+        "keywords": [
+          "simple-shell",
+          "landing",
+          "marketing",
+          "error-page",
+          "splash",
+          "confirmation",
+          "minimal-shell"
+        ],
+        "name": "SimpleShell",
+        "related": [
+          "SimpleHero",
+          "SimpleContent",
+          "AdminShell"
+        ],
+        "slots": {
+          "default": {
+            "description": "Bespoke children (<simple-hero>, <simple-content>) compose here. The author owns layout order."
+          }
+        },
+        "states": [
+          {
+            "description": "Default layout — top-aligned, max-width container.",
+            "name": "idle"
+          },
+          {
+            "description": "When [centered] is set — vertically centers the content stack.",
+            "name": "centered"
+          },
+          {
+            "description": "When [full-bleed] is set — drops max-width so content fills the viewport.",
+            "name": "full-bleed"
+          }
+        ],
+        "synonyms": {
+          "simple-shell": [
+            "marketing-shell",
+            "landing-shell",
+            "minimal-shell",
+            "splash-shell",
+            "error-shell"
+          ]
+        },
+        "tag": "simple-shell",
+        "tokens": {},
+        "traits": [],
+        "version": 1
+      }
+    },
     "Skeleton": {
       "title": "Skeleton",
       "description": "Placeholder shimmer for loading states. Purely presentational.",
@@ -13674,6 +13943,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

@@ -96,3 +96,18 @@
 ## AdminTopbar
 - admin-topbar replaces <header-ui> at shell-tier — use it for chrome bars inside admin-shell, admin-content, admin-sidebar. Use <header-ui> for primitive containers (Card / Drawer / Modal).
 
+## SimpleContent
+- simple-content is the article surface inside simple-shell. Use for primary page body. Sibling to <simple-hero> (optional).
+
+## SimpleHero
+- simple-hero is the optional top strip inside simple-shell. Use for marketing splashes, error-page reassurance text, or single- flow page intros. Always followed by <simple-content> for body.
+
+## SimpleShell
+- 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.
+