@adia-ai/a2ui-corpus 0.6.18 → 0.6.20

package/CHANGELOG.md

@@ -1,5 +1,21 @@
 # Changelog — @adia-ai/a2ui-corpus
 
+## [0.6.20] — 2026-05-21
+
+### Changed
+- **`catalog-a2ui_0_9.json` + `catalog-a2ui_0_9_rules.txt` regenerated.** Re-emitted to reflect the v0.6.20 primitive-schema changes: the new `<admin-entity-item>` shell primitive (FEEDBACK-38), the `<admin-topbar>` / `<admin-statusbar>` yaml additions (FEEDBACK-37), and the `table-ui` / `select-ui` schema clarifications (FEEDBACK-34/35/36). Keeps the A2UI component catalog in sync with the primitive schemas.
+
+### Note
+- The headline v0.6.20 work shipped in `@adia-ai/web-components` + `@adia-ai/web-modules` — the claims-ui-v5 inbound feedback batch (FEEDBACK-34…39). See `packages/web-modules/CHANGELOG.md#0620--2026-05-21`.
+
+## [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

package/catalog-a2ui_0_9.json

@@ -643,6 +643,83 @@
         "version": 1
       }
     },
+    "AdminEntityItem": {
+      "title": "AdminEntityItem",
+      "description": "Module-tier shell identity row. CSS-only — no behavior, no JS.\nA composable icon + label + badge unit: a leading icon (or avatar),\na truncating label, and an optional trailing badge that travel\ntogether as one slottable element.\n\nUse it wherever a shell surface shows an entity identity — workspace\nidentity in an <admin-topbar slot=\"header\">, user identity in an\n<admin-statusbar>, the leading item of a breadcrumb, a flyout header,\nor a user row. Inside a collapsible <admin-sidebar> the label and\nbadge hide when the rail collapses; the icon survives — so the same\nmarkup works expanded and collapsed without authoring two shapes.\n\nGeometry mirrors <select-ui>'s trigger row: [slot=\"icon\"] is fixed\n(like [slot=\"leading\"]), [slot=\"label\"] flexes + truncates (like\n[slot=\"display\"]), [slot=\"badge\"] is fixed trailing (like\n[slot=\"caret\"]).\n",
+      "type": "object",
+      "allOf": [
+        {
+          "$ref": "#/$defs/ComponentCommon"
+        },
+        {
+          "$ref": "#/$defs/CatalogComponentCommon"
+        }
+      ],
+      "properties": {
+        "component": {
+          "const": "AdminEntityItem"
+        }
+      },
+      "required": [
+        "component"
+      ],
+      "unevaluatedProperties": false,
+      "x-adiaui": {
+        "anti_patterns": [],
+        "category": "layout",
+        "composes": [],
+        "events": {},
+        "examples": [],
+        "keywords": [
+          "admin-entity-item",
+          "entity-item",
+          "identity-row",
+          "workspace-identity",
+          "user-identity",
+          "icon-label-badge"
+        ],
+        "name": "AdminEntityItem",
+        "related": [
+          "AdminTopbar",
+          "AdminStatusbar",
+          "AdminSidebar",
+          "Select",
+          "Badge",
+          "Icon"
+        ],
+        "slots": {
+          "default": {
+            "description": "Default content — unslotted children flow inline. Prefer the named slots for the canonical icon + label + badge composition."
+          },
+          "badge": {
+            "description": "Optional trailing chip — environment (staging / beta) or role badge. Fixed width. Hidden when a collapsible sidebar collapses."
+          },
+          "icon": {
+            "description": "Leading visual — an <icon-ui> glyph or an <img> avatar (img is given a circular crop). Fixed width; survives sidebar collapse."
+          },
+          "label": {
+            "description": "Primary text. Flexes to fill the remaining width and truncates with an ellipsis. Hidden when a collapsible sidebar collapses."
+          }
+        },
+        "states": [
+          {
+            "description": "Default, the only state.",
+            "name": "idle"
+          }
+        ],
+        "synonyms": {
+          "entity-item": [
+            "identity-row",
+            "entity-row",
+            "identity-item"
+          ]
+        },
+        "tag": "admin-entity-item",
+        "tokens": {},
+        "traits": [],
+        "version": 1
+      }
+    },
     "AdminPage": {
       "title": "AdminPage",
       "description": "Module-tier page wrapper. CSS-only — no behavior, no JS. Provides\nthe page-content-root container query (named `page-content`) so\ndescendants can adapt to available content width (sidebars expanded\nvs collapsed) instead of viewport width. Stamps the sticky-band\nlayout: <admin-page-header> + <admin-page-body> + optional footer.\n\nReplaces the legacy <article data-content-root> shape per ADR-0023.\n",
@@ -1075,6 +1152,7 @@
           "AdminShell",
           "AdminContent",
           "AdminTopbar",
+          "AdminEntityItem",
           "Footer"
         ],
         "slots": {
@@ -1156,6 +1234,7 @@
           "AdminContent",
           "AdminSidebar",
           "AdminStatusbar",
+          "AdminEntityItem",
           "Header"
         ],
         "slots": {
@@ -3633,6 +3712,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",
@@ -6357,7 +6441,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": {
@@ -6375,6 +6466,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": [
@@ -12782,7 +12876,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": [
         {
@@ -12817,8 +12911,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"
           }
         ],
@@ -12834,7 +12928,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.",
@@ -13011,7 +13112,7 @@
           "default": "md"
         },
         "value": {
-          "description": "Currently selected option value",
+          "description": "Currently selected option value. With declarative <option> children, a child carrying the native `selected` attribute sets the initial value when this attribute is absent (native <select> parity).",
           "type": "string",
           "default": ""
         },
@@ -15031,6 +15132,19 @@
               }
             }
           },
+          "row-click": {
+            "description": "Fired once when any cell in a data row is clicked — the row-level companion to cell-click. Use it for master-detail / open-flyout wiring.",
+            "detail": {
+              "dataIndex": {
+                "description": "Row index in the underlying data array.",
+                "type": "number"
+              },
+              "row": {
+                "description": "Row data object.",
+                "type": "object"
+              }
+            }
+          },
           "row-collapse": {
             "description": "Fired when an already-expanded row's chevron is activated (collapses the row). Mirror of row-expand.",
             "detail": {
@@ -15070,11 +15184,11 @@
             "description": "Fired when sort state changes via header click.",
             "detail": {
               "dir": {
-                "description": "Sort direction — \"asc\" / \"desc\" / null (cleared).",
+                "description": "Sort direction — \"asc\" / \"desc\" / null (cleared). The detail field is `dir` (not `direction`).",
                 "type": "string"
               },
               "key": {
-                "description": "Column key being sorted.",
+                "description": "Column key being sorted — the detail field is `key` (not `column`).",
                 "type": "string"
               },
               "sortState": {
@@ -16155,9 +16269,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",
@@ -16178,6 +16307,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",
@@ -16198,6 +16332,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

@@ -103,6 +103,10 @@
 ## AdminContent
 - admin-content is the bespoke replacement for raw <main> inside admin-shell. CSS-only; the shell's css/main.css selectors target both shapes via :is(main, admin-content).
 
+## AdminEntityItem
+- admin-entity-item is the canonical icon + label + badge identity row for shell surfaces. Slot it whole into [slot="heading"] of an <admin-topbar> / <admin-statusbar> so the icon + label + badge collapse together inside a collapsible <admin-sidebar>. Do NOT re-implement it with a bare <span> or an ad-hoc flex <div> — those have no shared collapse boundary.
+- For an INTERACTIVE workspace switcher use <select-ui variant="ghost"> instead — admin-entity-item is read-only identity display.
+
 ## AdminPageBody
 - admin-page-body is the centered body band of <admin-page>. Wraps an inner <section-ui> for centered reading-column rhythm; can host full-bleed content directly to opt out.
 
@@ -124,9 +128,13 @@
 
 ## AdminStatusbar
 - admin-statusbar replaces <footer-ui> at shell-tier. Same slot vocabulary as <admin-topbar>; visual treatment differs (the shell css applies a top-border instead of bottom).
+- When placed inside <admin-sidebar> or <admin-content>, admin-statusbar MUST carry slot="footer". Without it the statusbar lands in the default body slot instead of the chrome footer band. Canonical: <admin-statusbar slot="footer">…</admin-statusbar>. admin-shell logs a one-shot console.warn when the slot is missing.
+- For a user-identity row (avatar + name + role badge), slot a single <admin-entity-item slot="heading"> rather than separate slot="icon" + slot="heading" children — the wrapper collapses the name + badge together inside a collapsible <admin-sidebar>, keeping the avatar.
 
 ## 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).
+- When placed inside <admin-sidebar> or <admin-content>, admin-topbar MUST carry slot="header". Without it the topbar lands in the default body slot and renders below the content instead of as the chrome header band. Canonical: <admin-topbar slot="header">…</admin-topbar>. admin-shell logs a one-shot console.warn when the slot is missing.
+- For an icon + label (+ optional badge) identity row — workspace or product identity — slot a single <admin-entity-item slot="heading"> rather than separate slot="icon" + slot="heading" children. The wrapper keeps the icon and label as one unit so they truncate and collapse together inside a collapsible <admin-sidebar>.
 
 ## SimpleContent
 - simple-content is the article surface inside simple-shell. Use for primary page body. Sibling to <simple-hero> (optional).