@adia-ai/a2ui-corpus 0.6.17 → 0.6.19

package/CHANGELOG.md

@@ -1,5 +1,21 @@
 # Changelog — @adia-ai/a2ui-corpus
 
+## [0.6.19] — 2026-05-21
+
+### Fixed
+- **Corpus drift remediation — `verify:corpus` 22 findings → 0.** Freshened the stale corpus chunks: ~235 JSON files under `chunks/` re-harvested/reconciled so every chunk matches its current primitive composition, and `catalog-a2ui_0_9.json` regenerated. Companion `chunk-reconcile` triage cleared 38 collisions (all confirmed legitimate). Brings the A2UI training corpus back in sync with the v0.6.18→v0.6.19 primitive-schema state.
+
+### Note
+- The headline v0.6.19 work — claims-ui-v4 inbound feedback batch (FEEDBACK-22…33: `drawer-ui`, `chart-ui`, `segmented-ui`, `UIElement` lifecycle, exports-map `types` conditions) — shipped in `@adia-ai/web-components` + `@adia-ai/web-modules`. See `packages/web-components/CHANGELOG.md#0619--2026-05-21`.
+
+## [0.6.18] — 2026-05-21
+
+### Changed
+- **`catalog-a2ui_0_9.json` + `catalog-a2ui_0_9_rules.txt` regenerated.** Re-emitted to reflect the `button-ui` (FB-15 `anti_patterns` entry) and `toggle-scheme-ui` (FB-13 / FB-14) yaml-schema changes shipped in `@adia-ai/web-components` v0.6.18 — keeps the A2UI component catalog in sync with the primitive schemas.
+
+### Note
+- The headline v0.6.18 work shipped in `@adia-ai/web-components` — `stat-ui` + `table-ui` `loading` props (FB-12 P2) and `text-ui` `size` / `color` / `weight` / `text-align` overlay attributes (FB-10). See `packages/web-components/CHANGELOG.md#0618--2026-05-21` for details.
+
 ## [0.6.17] — 2026-05-21
 
 ### Maintenance

package/catalog-a2ui_0_9.json

@@ -3007,7 +3007,14 @@
       ],
       "unevaluatedProperties": false,
       "x-adiaui": {
-        "anti_patterns": [],
+        "anti_patterns": [
+          {
+            "description": "Beginning text= with a symbol that icon= already renders. icon=\"plus\" paints a Phosphor \"+\" glyph; text=\"+ New Item\" then renders the literal \"+\" too, so the symbol appears twice ([+ icon] [+ New Item]).",
+            "right": "<button-ui text=\"New Claim\" icon=\"plus\" variant=\"primary\"></button-ui>\n",
+            "rule": "Do not repeat the icon's glyph in text=. The icon provides the symbol; text= carries only the words. Applies to plus / minus / x / check / arrow icons.",
+            "wrong": "<button-ui text=\"+ New Claim\" icon=\"plus\" variant=\"primary\"></button-ui>\n"
+          }
+        ],
         "category": "action",
         "composes": [
           "icon-ui"
@@ -3626,6 +3633,11 @@
         "component": {
           "const": "Chart"
         },
+        "data": {
+          "description": "JS property (set programmatically — `el.data = [...]`). An array of plain objects; each object's keys are named by the `x` and `y` attributes — e.g. `<chart-ui x=\"month\" y=\"revenue\">` consumes `[{month:'Jan', revenue:3200}, {month:'Feb', revenue:4100}]`. The Chart.js `{labels, datasets}` envelope is NOT chart-ui's API — passing it (or any non-array value) renders an empty chart. May also be supplied declaratively as a JSON-array `data=\"[…]\"` attribute, hydrated once at connect. Custom accessor on the element class, not a reflected attribute.",
+          "type": "array",
+          "default": []
+        },
         "format": {
           "description": "Number-format mode applied to axis labels + value overlays + donut total + gauge value + treemap value + funnel value + internal tooltip. `abbr` is the legacy 1.2K / 3M format; `decimal` fixes 2 decimals; `currency` prefixes via `--chart-currency-prefix` token (default \"$\"); `percent` multiplies × 100 and adds a % suffix.",
           "type": "string",
@@ -6350,7 +6362,14 @@
       ],
       "unevaluatedProperties": false,
       "x-adiaui": {
-        "anti_patterns": [],
+        "anti_patterns": [
+          {
+            "description": "Replacing a drawer's children wholesale — `drawer.innerHTML = '…'` — wipes the internal <dialog> part UIDrawer stamps and tracks. render() re-stamps and re-binds the dialog defensively (FEEDBACK-30), but the authored header/section/footer skeleton is still destroyed on every mutation, and any consumer-held reference to a former child is stale.",
+            "right": "<drawer-ui><header>Title</header><section id=\"body\"></section></drawer-ui>\n<!-- mutate a stable inner element, never the component host -->\ndocument.getElementById('body').innerHTML = renderFields(claim);\n",
+            "rule": "Never set .innerHTML on a UIElement component host. Keep <header>/<section>/<footer> as persistent children and mutate the content of a plain inner element instead.",
+            "wrong": "drawer.innerHTML = `<header>${title}</header><section>${body}</section>`;\n"
+          }
+        ],
         "category": "container",
         "composes": [],
         "events": {
@@ -6368,6 +6387,9 @@
                 ]
               }
             }
+          },
+          "opened": {
+            "description": "Fired after the drawer finishes its open transition — scheduled `--drawer-duration` ms after `showModal()` + `[data-open]`. Lets Playwright (and any consumer code waiting for the drawer to be fully open and interactive) listen for an event instead of guessing with a fixed timeout. Cancelled if the drawer closes before the open transition completes, so a rapid close→open never fires a stale `opened`. Added per FEEDBACK-27."
           }
         },
         "examples": [
@@ -12775,7 +12797,7 @@
     },
     "Segmented": {
       "title": "Segmented",
-      "description": "<segmented-ui value=\"tab1\">",
+      "description": "Single-select toggle group with an animated sliding indicator. Children must be segment-ui elements.",
       "type": "object",
       "allOf": [
         {
@@ -12810,8 +12832,8 @@
         },
         "examples": [
           {
-            "description": "Basic Segmented usage",
-            "a2ui": "[\n  {\n    \"id\": \"root\",\n    \"component\": \"Card\",\n    \"children\": [\n      \"sec\"\n    ]\n  },\n  {\n    \"id\": \"sec\",\n    \"component\": \"Section\",\n    \"children\": [\n      \"comp\"\n    ]\n  },\n  {\n    \"id\": \"comp\",\n    \"component\": \"Segmented\",\n    \"value\": \"\"\n  }\n]",
+            "description": "Segmented control with three segment-ui children for view switching.",
+            "a2ui": "[\n  {\n    \"id\": \"root\",\n    \"component\": \"Card\",\n    \"children\": [\n      \"sec\"\n    ]\n  },\n  {\n    \"id\": \"sec\",\n    \"component\": \"Section\",\n    \"children\": [\n      \"comp\"\n    ]\n  },\n  {\n    \"id\": \"comp\",\n    \"component\": \"Segmented\",\n    \"value\": \"daily\",\n    \"children\": [\n      \"s1\",\n      \"s2\",\n      \"s3\"\n    ]\n  },\n  {\n    \"id\": \"s1\",\n    \"component\": \"Segment\",\n    \"value\": \"daily\",\n    \"text\": \"Daily\"\n  },\n  {\n    \"id\": \"s2\",\n    \"component\": \"Segment\",\n    \"value\": \"weekly\",\n    \"text\": \"Weekly\"\n  },\n  {\n    \"id\": \"s3\",\n    \"component\": \"Segment\",\n    \"value\": \"monthly\",\n    \"text\": \"Monthly\"\n  }\n]",
             "name": "basic-segmented"
           }
         ],
@@ -12827,7 +12849,14 @@
         ],
         "name": "UISegmented",
         "related": [],
-        "slots": {},
+        "slots": {
+          "default": {
+            "description": "Child segment-ui elements that form the toggle group. Children MUST be segment-ui — bare segment tags render text but are silently ignored for the sliding indicator and role/aria-checked state."
+          },
+          "indicator": {
+            "description": "Auto-created sliding indicator element prepended on first render."
+          }
+        },
         "states": [
           {
             "description": "Default, ready for interaction.",
@@ -13710,6 +13739,11 @@
           "type": "string",
           "default": ""
         },
+        "loading": {
+          "description": "Renders skeleton-ui shimmer placeholders in place of the value and change slots while data is fetching. Sets aria-busy=\"true\" on the host. Label and icon are preserved (they're static metadata, not fetched data). Toggle back to false when data arrives.",
+          "type": "boolean",
+          "default": false
+        },
         "trend": {
           "description": "Trend direction or narrative subtitle. Canonical values color the change badge (up=success, down=danger, neutral/flat=muted); any other string renders as caption-style text under the primary value.",
           "type": "string",
@@ -13729,7 +13763,8 @@
         "anti_patterns": [],
         "category": "display",
         "composes": [
-          "icon-ui"
+          "icon-ui",
+          "skeleton-ui"
         ],
         "events": {},
         "examples": [
@@ -14916,7 +14951,7 @@
           "default": false
         },
         "loading": {
-          "description": "Shows a loading overlay and skeleton rows. Sets aria-busy=\"true\". Data updates are deferred until loading is set back to false.",
+          "description": "Renders N ghost skeleton rows in place of the body data (count derived from `paginate` if set, else 5). Header + columns stay intact so the table layout is preserved while data fetches. Sets aria-busy=\"true\" on the host. Data updates are deferred until loading is set back to false.",
           "type": "boolean",
           "default": false
         },
@@ -14963,6 +14998,7 @@
           "icon-ui",
           "progress-ui",
           "pagination-ui",
+          "skeleton-ui",
           "badge-ui"
         ],
         "events": {
@@ -15980,6 +16016,20 @@
         }
       ],
       "properties": {
+        "color": {
+          "description": "Override the variant's color token. Permissive: unknown values are no-ops (variant color wins). Added v0.6.18 (FB-10).",
+          "type": "string",
+          "enum": [
+            "default",
+            "subtle",
+            "strong",
+            "accent",
+            "danger",
+            "success",
+            "warning"
+          ],
+          "default": ""
+        },
         "component": {
           "const": "Text"
         },
@@ -15988,11 +16038,32 @@
           "type": "number",
           "default": 0
         },
+        "size": {
+          "description": "Override the variant's font-size on the body ladder. Maps to --a-body-sm / --a-body-md / --a-body-lg. Permissive: unknown values are no-ops (variant size wins). Added v0.6.18 (FB-10).",
+          "type": "string",
+          "enum": [
+            "sm",
+            "md",
+            "lg"
+          ],
+          "default": ""
+        },
         "strong": {
           "description": "When true, applies stronger emphasis (heavier weight + accent color). Styled via :scope[strong] in text.css. Use instead of variant=heading when you want a single emphasized word inline in body copy.",
           "type": "boolean",
           "default": false
         },
+        "text-align": {
+          "description": "Override text alignment. Note: text-ui defaults to display:inline, so this only takes effect when text-ui is block-like (wrapping or parent display:block/grid). Added v0.6.18 (FB-10).",
+          "type": "string",
+          "enum": [
+            "start",
+            "center",
+            "end",
+            "justify"
+          ],
+          "default": ""
+        },
         "textContent": {
           "description": "Display text content. The main payload field for Text components extracted from HTML.",
           "$ref": "#/$defs/DynamicString"
@@ -16034,6 +16105,17 @@
             "section": "Inline form-group / navlist heading (visual rank H4). Small-cap. Use for form group labels, nav list headings.",
             "subsection": "Sub-landmark within a section (visual rank H3). 14px / semibold. Use for card titles within a section."
           }
+        },
+        "weight": {
+          "description": "Override the variant's font-weight. Maps to --a-weight / --a-weight-medium / --a-weight-semibold / --a-weight-bold. Permissive: unknown values are no-ops (variant weight wins). Added v0.6.18 (FB-10).",
+          "type": "string",
+          "enum": [
+            "regular",
+            "medium",
+            "semibold",
+            "bold"
+          ],
+          "default": ""
         }
       },
       "required": [
@@ -16095,9 +16177,24 @@
         }
       ],
       "properties": {
+        "required": {
+          "description": "Marks the field as required for form validation. Sets aria-required. Inherited from UIFormElement.",
+          "type": "boolean",
+          "default": false
+        },
         "component": {
           "const": "Textarea"
         },
+        "disabled": {
+          "description": "Disables interaction, removes contenteditable, and dims the control. Inherited from UIFormElement.",
+          "type": "boolean",
+          "default": false
+        },
+        "error": {
+          "description": "Validation error message. Set by constraint validation or manually via setInvalid(). Inherited from UIFormElement.",
+          "type": "string",
+          "default": ""
+        },
         "hint": {
           "description": "Help text displayed below the textarea. Hidden when error is set.",
           "type": "string",
@@ -16118,6 +16215,11 @@
           "type": "string",
           "default": ""
         },
+        "readonly": {
+          "description": "Prevents editing while keeping the surface focusable. Sets contenteditable=false. Inherited from UIFormElement.",
+          "type": "boolean",
+          "default": false
+        },
         "resize": {
           "description": "Resize behavior of the textarea.",
           "type": "string",
@@ -16138,6 +16240,11 @@
           "description": "§220 (v0.5.9, FEEDBACK-14 §3). Trailing-debounce on the `input`\nevent in milliseconds. When > 0, value mutates immediately + the UI\nstays responsive, but `input` dispatch is collapsed so only the\nfinal value in the throttle window emits. Useful for expensive\n`input`-driven computation (autosave preview, server-side\nautocomplete, large-doc reflow). `change` fires unthrottled on blur\n/ Enter; any pending `input` flushes before `change` so consumers\nsee input→input→…→input→change ordering. Default 0 preserves\nsynchronous emission.",
           "type": "number",
           "default": 0
+        },
+        "value": {
+          "description": "Current textarea value, synced with the contenteditable text surface. Inherited from UIFormElement.",
+          "type": "string",
+          "default": ""
         }
       },
       "required": [

package/catalog-a2ui_0_9_rules.txt

@@ -39,6 +39,9 @@
 ## Switch
 - Self-labeling widget — use the [label] attribute directly; do NOT wrap in <field-ui>. The widget renders its own label inline via CSS attr() pattern. For settings rows (label-left, switch-right), put the descriptive text in switch-ui's own [label] attribute; do not introduce a field-ui wrapper. For descriptive helper text below the switch, use <text-ui variant='caption'> as a sibling — not field-ui's hint slot.
 
+## ToggleScheme
+- Place toggle-scheme-ui in the shell topbar's trailing action cluster — slot="action" inside <admin-topbar slot="header"> of <admin-content>. It is a persistent, app-wide preference control; never put it in a sidebar footer / <admin-statusbar>, which hosts user-account items only.
+
 ## ChatComposer
 - chat-composer is the bespoke replacement for legacy <chat-input-ui data-chat-input> inside <chat-shell>. Place an inner <chat-input-ui submit-on-enter> as the primary input.
 - The host listens for 'composer-submit' on the composer (not on the inner input). The event detail mirrors the inner submit event so existing handlers Just Work.