@adia-ai/a2ui-corpus 0.6.19 → 0.6.21

package/CHANGELOG.md

@@ -1,5 +1,21 @@
 # Changelog — @adia-ai/a2ui-corpus
 
+## [0.6.21] — 2026-05-21
+
+### Changed
+- **`catalog-a2ui_0_9.json` + `catalog-a2ui_0_9_rules.txt` regenerated.** Re-emitted to reflect the v0.6.21 yaml-schema changes — the FEEDBACK-37 retraction in `admin-topbar.yaml` / `admin-statusbar.yaml` (the slot-contract diagnostic was misdiagnosed and removed) plus the `table-ui` wrap-default schema clarification (§403). Keeps the A2UI component catalog in sync.
+
+### Note
+- The headline v0.6.21 work shipped in `@adia-ai/web-components` + `@adia-ai/web-modules`. See `packages/web-modules/CHANGELOG.md#0621--2026-05-21`.
+
+## [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

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": {
@@ -13033,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": ""
         },
@@ -14923,7 +15002,7 @@
       ],
       "properties": {
         "columns": {
-          "description": "Column definitions. Array of {key, label, type?, width?, minWidth?, maxWidth?, flex?, sortable?, resizable?, filterable?, pinned?, hidden?, accessor?, format?, render?, sortFn?, filterType?, meta?}. Alternative to declarative <col-def> children.",
+          "description": "Column definitions. Array of {key, label, type?, width?, minWidth?, maxWidth?, flex?, sortable?, resizable?, filterable?, pinned?, hidden?, wrap?, accessor?, format?, render?, sortFn?, filterType?, meta?}. Alternative to declarative <col-def> children.",
           "type": "array",
           "default": []
         },
@@ -14984,6 +15063,11 @@
           "description": "Alternate row background colors for visual scanning.",
           "type": "boolean",
           "default": false
+        },
+        "wrap": {
+          "description": "Allow body-cell content to wrap onto multiple lines. Default is single-line with ellipsis truncation (matches the row convention shared by <select-ui> + <nav-item-ui>); long unbreakable strings clip gracefully rather than rewrapping the row. With [wrap], row height auto-grows to fit wrapped content. For surgical opt-in on a single column, set [data-wrap] on the cell / col-def instead.",
+          "type": "boolean",
+          "default": false
         }
       },
       "required": [
@@ -15053,6 +15137,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": {
@@ -15092,11 +15189,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": {

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,11 @@
 
 ## 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).
+- 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).
+- 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).

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@adia-ai/a2ui-corpus",
-  "version": "0.6.19",
+  "version": "0.6.21",
   "type": "module",
   "description": "AdiaUI A2UI training corpus \u2014 canonical v0.9 catalog + chunks + eval fixtures + feedback + gap registry. Consumed by the compose engine's retrieval layer + the MCP pipeline.",
   "exports": {