@adia-ai/a2ui-corpus 0.2.3 → 0.2.5

package/CHANGELOG.md

@@ -9,7 +9,36 @@ gap registry. Consumed by `@adia-ai/a2ui-retrieval` and
 
 ## [Unreleased]
 
-_Nothing yet._
+_No pending changes._
+
+## [0.2.5] - 2026-05-04
+
+**Lockstep cut + catalog regen for `<fields-ui>` primitive.** All 8 published `@adia-ai/*` packages bump 0.2.4 → 0.2.5 per [`docs/specs/package-architecture.md` § 15](../../../docs/specs/package-architecture.md#15-versioning-policy). Patch cut — **no BREAKING changes**.
+
+### Changed
+
+- `version`: `0.2.4` → `0.2.5`.
+- `catalog-a2ui_0_9.json`: 1 new entry covering the new `<fields-ui>` primitive (component class `Fields`, tag `fields-ui`, props `[columns]` + `[inline]`, default slot for `<field-ui>` children + the `rows` span pattern). Catalog: 97 → 98 yamls.
+- Per-element `fields/fields.a2ui.json` written by `scripts/build/components.mjs`.
+
+## [0.2.4] - 2026-05-04
+
+**Lockstep cut + catalog regen for `<demo-toggle-ui>` primitive.** All 8 published `@adia-ai/*` packages bump 0.2.3 → 0.2.4 per [`docs/specs/package-architecture.md` § 15](../../../docs/specs/package-architecture.md#15-versioning-policy). Patch cut — no breaking changes.
+
+### Changed
+
+- `version`: `0.2.3` → `0.2.4`.
+- `catalog-a2ui_0_9.json`: 6 new references (name + slots + events + props + tokens + example) covering the new `<demo-toggle-ui>` primitive added in `web-components@0.2.4`.
+
+### Changed — Catalog regenerated against `web-components` Tier-4 surface
+
+`catalog-a2ui_0_9.json` regenerated to include the new
+`<demo-toggle-ui>` primitive (6 references covering name + slots +
+events + props + tokens + example) authored alongside the trait-
+library lift initiative's Tier 5 work. No other corpus surface
+changed; new traits introduced in `web-components` are picked up via
+the generated `_catalog.json` consumed by
+`@adia-ai/a2ui-retrieval`.
 
 ---
 

package/catalog-a2ui_0_9.json

@@ -4045,6 +4045,148 @@
         "version": 1
       }
     },
+    "DemoToggle": {
+      "title": "DemoToggle",
+      "description": "Side-by-side comparison primitive — header bar with a switch + two child slots (\"on\" / \"off\"); toggling the switch swaps which slot is visible. Used on trait detail pages to show \"with trait\" vs \"without trait\" on the same chrome. data-mode=\"overlay\" stacks the slots on the same coordinates so layout never shifts.",
+      "type": "object",
+      "allOf": [
+        {
+          "$ref": "#/$defs/ComponentCommon"
+        },
+        {
+          "$ref": "#/$defs/CatalogComponentCommon"
+        }
+      ],
+      "properties": {
+        "component": {
+          "const": "DemoToggle"
+        },
+        "initial": {
+          "description": "Initial state when [state] is not set on connect (\"on\" | \"off\").",
+          "type": "string",
+          "enum": [
+            "on",
+            "off"
+          ],
+          "default": "off"
+        },
+        "labelOff": {
+          "description": "Header label rendered when state is \"off\".",
+          "type": "string",
+          "default": "Off"
+        },
+        "labelOn": {
+          "description": "Header label rendered when state is \"on\".",
+          "type": "string",
+          "default": "On"
+        },
+        "state": {
+          "description": "Current toggle state (\"on\" | \"off\"). Reflected as data-state on the host.",
+          "type": "string",
+          "enum": [
+            "",
+            "on",
+            "off"
+          ],
+          "default": ""
+        }
+      },
+      "required": [
+        "component"
+      ],
+      "unevaluatedProperties": false,
+      "x-adiaui": {
+        "anti_patterns": [],
+        "category": "container",
+        "events": {
+          "change": {
+            "description": "Fired when the toggle flips. detail contains { state }."
+          }
+        },
+        "examples": [
+          {
+            "description": "Compare a trait-bearing surface against the bare control on the same chrome.",
+            "a2ui": "[\n  {\n    \"id\": \"root\",\n    \"component\": \"DemoToggle\",\n    \"labelOn\": \"With shimmer-loading\",\n    \"labelOff\": \"Without shimmer-loading\",\n    \"initial\": \"off\",\n    \"children\": [\"off\", \"on\"]\n  },\n  {\n    \"id\": \"off\",\n    \"component\": \"Card\",\n    \"slot\": \"off\",\n    \"children\": [\"off-section\"]\n  },\n  {\n    \"id\": \"off-section\",\n    \"component\": \"Section\",\n    \"children\": [\"off-text\"]\n  },\n  {\n    \"id\": \"off-text\",\n    \"component\": \"Text\",\n    \"textContent\": \"Bare surface — no trait attached.\"\n  },\n  {\n    \"id\": \"on\",\n    \"component\": \"Card\",\n    \"slot\": \"on\",\n    \"children\": [\"on-section\"]\n  },\n  {\n    \"id\": \"on-section\",\n    \"component\": \"Section\",\n    \"children\": [\"on-text\"]\n  },\n  {\n    \"id\": \"on-text\",\n    \"component\": \"Text\",\n    \"textContent\": \"Same surface, with trait attached.\"\n  }\n]",
+            "name": "with-without-trait"
+          }
+        ],
+        "keywords": [
+          "demo",
+          "toggle",
+          "compare",
+          "comparison",
+          "trait",
+          "before-after",
+          "a-b",
+          "switch"
+        ],
+        "name": "UIDemoToggle",
+        "related": [
+          "Switch",
+          "Card"
+        ],
+        "slots": {
+          "bar": {
+            "description": "Internal header bar (auto-stamped). Hosts the embedded switch + label."
+          },
+          "off": {
+            "description": "Surface rendered when state is \"off\" (the \"without trait\" variant)."
+          },
+          "on": {
+            "description": "Surface rendered when state is \"on\" (the \"with trait\" variant)."
+          }
+        },
+        "states": [
+          {
+            "description": "Default, ready for interaction.",
+            "name": "idle"
+          },
+          {
+            "description": "On slot is active; bar leans accent.",
+            "attribute": "data-state",
+            "name": "on"
+          },
+          {
+            "description": "Off slot is active; bar is neutral.",
+            "attribute": "data-state",
+            "name": "off"
+          }
+        ],
+        "synonyms": {
+          "compare": [
+            "demo-toggle",
+            "segmented"
+          ],
+          "switch": [
+            "demo-toggle",
+            "toggle-group"
+          ]
+        },
+        "tag": "demo-toggle-ui",
+        "tokens": {
+          "--demo-toggle-bar-bg": {
+            "description": "Header bar background (accent when state=on)"
+          },
+          "--demo-toggle-bar-fg": {
+            "description": "Header bar foreground"
+          },
+          "--demo-toggle-bg": {
+            "description": "Stage background"
+          },
+          "--demo-toggle-border": {
+            "description": "Border color"
+          },
+          "--demo-toggle-radius": {
+            "description": "Outer border-radius"
+          },
+          "--demo-toggle-stage-padding": {
+            "description": "Inner padding around each slot"
+          }
+        },
+        "traits": [],
+        "version": 1
+      }
+    },
     "DescriptionList": {
       "title": "DescriptionList",
       "description": "Semantic key-value list (dl/dt/dd). Preserves native HTML semantics for screen readers and SSR. Layout supports stacked (default) or inline.",
@@ -4973,6 +5115,110 @@
         "version": 1
       }
     },
+    "Fields": {
+      "title": "Fields",
+      "description": "Container for a group of <field-ui> children, laid out on a shared 6-column grid. Each <field-ui> spans the full row by default; opt into a narrower span via [rows=\"1..6\"]. Setting [inline] on the host propagates the inline mode to every direct <field-ui> child so a whole sub-form can switch label-position without per-field edits. The grid alignment lets siblings on the same row line up cleanly — consistent label columns + consistent control columns — without the wrap-flex jitter of <row-ui wrap>.",
+      "type": "object",
+      "allOf": [
+        {
+          "$ref": "#/$defs/ComponentCommon"
+        },
+        {
+          "$ref": "#/$defs/CatalogComponentCommon"
+        }
+      ],
+      "properties": {
+        "columns": {
+          "description": "Number of grid columns the row uses. Defaults to 6 — common multiples (1/2/3/6) divide cleanly. <field-ui rows=\"N\"> spans `N` of these columns. Override per-instance for tighter 4-column or wider 12-column compositions.",
+          "type": "number",
+          "default": 6
+        },
+        "component": {
+          "const": "Fields"
+        },
+        "inline": {
+          "description": "Propagate the inline layout mode to every direct <field-ui> child. Equivalent to authoring `inline` on each child but drives the whole group from one place. Toggle is reactive — flipping the attribute on the host re-syncs all children.",
+          "type": "boolean",
+          "default": false
+        }
+      },
+      "required": [
+        "component"
+      ],
+      "unevaluatedProperties": false,
+      "x-adiaui": {
+        "anti_patterns": [
+          {
+            "description": "Don't wrap <field-ui> children in <row-ui wrap> when grid alignment is desired. row-ui is flex-wrap, which lets each field size to its content — labels and controls won't share a column with siblings.",
+            "severity": "high"
+          },
+          {
+            "description": "Don't set `inline` on individual <field-ui> children when the whole group should switch — set it on the parent <fields-ui> and let the propagation handle every child.",
+            "severity": "medium"
+          }
+        ],
+        "category": "form",
+        "events": {},
+        "examples": [
+          {
+            "description": "A 3-up stacked field row — Status / Priority / Group — each taking 2 of 6 columns. Equivalent to a Bootstrap \"col-md-4\" pattern (12-col grid, span 4) but with chat-ui's 6-col default.",
+            "a2ui": "[\n  {\n    \"id\": \"root\",\n    \"component\": \"Fields\",\n    \"children\": [\"status\", \"priority\", \"group\"]\n  },\n  { \"id\": \"status\",   \"component\": \"Field\", \"label\": \"Status\",   \"rows\": 2, \"children\": [\"status-sel\"] },\n  { \"id\": \"priority\", \"component\": \"Field\", \"label\": \"Priority\", \"rows\": 2, \"children\": [\"priority-sel\"] },\n  { \"id\": \"group\",    \"component\": \"Field\", \"label\": \"Group\",    \"rows\": 2, \"children\": [\"group-sel\"] },\n  { \"id\": \"status-sel\",   \"component\": \"Select\", \"value\": \"todo\" },\n  { \"id\": \"priority-sel\", \"component\": \"Select\", \"value\": \"0\" },\n  { \"id\": \"group-sel\",    \"component\": \"Select\", \"value\": \"\" }\n]",
+            "name": "three-up-stacked"
+          },
+          {
+            "description": "An inline form — every field renders label-beside-control. Single [inline] on the host drives all children.",
+            "a2ui": "[\n  {\n    \"id\": \"root\",\n    \"component\": \"Fields\",\n    \"inline\": true,\n    \"children\": [\"q\", \"kind\"]\n  },\n  { \"id\": \"q\",    \"component\": \"Field\", \"label\": \"Search\", \"children\": [\"q-input\"] },\n  { \"id\": \"kind\", \"component\": \"Field\", \"label\": \"Kind\",   \"children\": [\"kind-sel\"] },\n  { \"id\": \"q-input\", \"component\": \"Input\", \"type\": \"search\" },\n  { \"id\": \"kind-sel\", \"component\": \"Select\", \"value\": \"all\" }\n]",
+            "name": "inline-search-form"
+          }
+        ],
+        "keywords": [
+          "fields",
+          "form",
+          "grid",
+          "layout",
+          "group"
+        ],
+        "name": "UIFields",
+        "related": [
+          "field",
+          "input",
+          "select",
+          "textarea"
+        ],
+        "slots": {
+          "default": {
+            "description": "<field-ui> children. Non-field children (separators, headings) are placed in the grid too — span them by setting `style=\"grid-column: 1 / -1\"` for full-width content. Nested <fields-ui> works (an outer 6-col grid hosting inner 3-col grids inside a single cell)."
+          }
+        },
+        "states": [
+          {
+            "description": "Default, ready for interaction.",
+            "name": "idle"
+          }
+        ],
+        "synonyms": {
+          "form": [
+            "fields",
+            "group",
+            "layout"
+          ]
+        },
+        "tag": "fields-ui",
+        "tokens": {
+          "--fields-column-gap": {
+            "description": "Override the column-gap independently of row-gap."
+          },
+          "--fields-gap": {
+            "description": "Gap between adjacent fields (row + column)."
+          },
+          "--fields-row-gap": {
+            "description": "Override the row-gap independently of column-gap."
+          }
+        },
+        "traits": [],
+        "version": 1
+      }
+    },
     "Footer": {
       "title": "Footer",
       "description": "Footer — styled by closest container parent (Card / Drawer / Modal / Page / AppShell). Contains actions, pagination, or summary. Typically holds Buttons.",

package/package.json

@@ -1,17 +1,17 @@
 {
   "name": "@adia-ai/a2ui-corpus",
-  "version": "0.2.3",
+  "version": "0.2.5",
   "type": "module",
-  "description": "AdiaUI A2UI training corpus — patterns, fragments, compositions, exemplars, eval fixtures, feedback, gap registry. Consumed by the compose engine's retrieval layer + the MCP pipeline.",
+  "description": "AdiaUI A2UI training corpus \u2014 patterns, fragments, compositions, exemplars, eval fixtures, feedback, gap registry. Consumed by the compose engine's retrieval layer + the MCP pipeline.",
   "exports": {
-    ".":                  "./catalog-a2ui_0_9.json",
-    "./patterns":         "./patterns/_components.json",
-    "./exemplars/*":      "./exemplars/*",
-    "./manifest":         "./manifest.json",
-    "./chunks":           "./chunks/_index.json",
-    "./chunks/*":         "./chunks/*",
-    "./chunk-library":      "./scripts/chunk-library.js",
-    "./chunk-embeddings":   "./chunk-embeddings.json",
+    ".": "./catalog-a2ui_0_9.json",
+    "./patterns": "./patterns/_components.json",
+    "./exemplars/*": "./exemplars/*",
+    "./manifest": "./manifest.json",
+    "./chunks": "./chunks/_index.json",
+    "./chunks/*": "./chunks/*",
+    "./chunk-library": "./scripts/chunk-library.js",
+    "./chunk-embeddings": "./chunk-embeddings.json",
     "./pattern-embeddings": "./pattern-embeddings.json"
   },
   "files": [