@adia-ai/a2ui-corpus 0.2.4 → 0.3.0

package/CHANGELOG.md

@@ -11,6 +11,32 @@ gap registry. Consumed by `@adia-ai/a2ui-retrieval` and
 
 _No pending changes._
 
+## [0.3.0] - 2026-05-05
+
+**9-package lockstep cut.** All 9 published `@adia-ai/*` packages bump 0.2.5 → 0.3.0 per [`docs/specs/package-architecture.md` § 15](../../../docs/specs/package-architecture.md#15-versioning-policy). Internal `@adia-ai/*` dep ranges bump `^0.2.0` → `^0.3.0`.
+
+The lockstep policy expanded from 8 to 9 packages with this cut — `@adia-ai/llm` joins as a 9th member, and `@adia-ai/a2ui-utils` was renamed to `@adia-ai/a2ui-runtime`. Both are BREAKING for npm consumers (acceptable under pre-1.0 semver).
+
+This package itself ships **no source changes** in v0.3.0. The cut bumps version + the internal dep range only.
+
+### Changed
+
+- `version`: `0.2.5` → `0.3.0`.
+
+### No source changes
+
+`a2ui-corpus` source is byte-identical to `0.2.5`. The cut bumps version only — corpus has no `@adia-ai/*` dependencies so no dep-range updates either.
+
+## [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.

package/README.md

@@ -7,7 +7,7 @@ fixtures. Pure data plus the scripts that maintain it. No runtime.
 > The pipeline reads this package; this package never reads the pipeline.
 > See [`@adia-ai/a2ui-compose`](../compose) for engine code,
 > [`@adia-ai/web-components`](../../web-components) for UI atoms,
-> [`@adia-ai/a2ui-utils`](../utils) for the A2UI runtime (renderer,
+> [`@adia-ai/a2ui-runtime`](../runtime) for the A2UI runtime (renderer,
 > registry, streams, wiring),
 > [`@adia-ai/a2ui-mcp`](../mcp) for the MCP server.
 

package/catalog-a2ui_0_9.json

@@ -5115,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.4",
+  "version": "0.3.0",
   "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": [