@adia-ai/a2ui-corpus 0.5.2 → 0.5.4

package/CHANGELOG.md

@@ -19,6 +19,101 @@ gap registry. Consumed by `@adia-ai/a2ui-retrieval` and
 
 _No pending changes._
 
+## [0.5.4] - 2026-05-14
+
+### Changed — §164 re-harvest 230 chunks against §163-fixed transpiler; +2,920 LOC restored prop fidelity (v0.5.4)
+
+`packages/a2ui/corpus/chunks/*.json` — 230 chunks regenerated by running
+`npm run harvest:chunks` against the §163-fixed transpiler (sibling
+package `@adia-ai/a2ui-compose@0.5.4`). Closes the corpus side of the
+harvester drop class diagnosed 2026-05-14: the chunks shipped at v0.5.3
+were authored pre-§163 and carried prop-stripped templates (Input/
+CheckBox/Button/Divider primitives with empty props), causing
+composition-match retrievals to render blank rectangles even though
+type-registration + schema validation both passed green.
+
+**Empirical scope of the gap (defensible at the engineering-board level):**
+
+  231 files modified (230 chunks + `_index.json`)
+  +2,920 lines added (restored props)
+  -765 lines removed (stale or redundant content displaced)
+  Net: +2,155 LOC of restored prop fidelity
+
+**Verified spot-check** on `auth-signin-card-password` chunk (the diagnosis baseline):
+
+  password Input    {} → {label, type, autocomplete, name, placeholder, required}
+  remember CheckBox {name} → {name, label}
+  Sign in Button    {type} → {type, text, variant}
+  Divider           {} → {label}
+  magic-link Button {} → {icon, text, variant}
+  6-digit Button    {} → {icon, text, variant}
+
+Retrieval-layer surfacing confirmed: post-§164 smoke probe text now
+includes `"enter your password signing in as kim@acme.com password ••••…"`
+— proof the fix landed not just at the file system but at the retrieval
+surface where compositions are matched.
+
+### Changed — `chunk-embeddings.json` rebuilt (6,632 KB; 230 × 1536-dim vectors)
+
+`npm run build:embeddings:chunks` regenerated `chunk-embeddings.json`
+since chunk content changed materially (the +2,920 LOC of restored
+props are semantically meaningful for retrieval). Existing embeddings
+would have under-retrieved compositions whose prop content now adds
+discriminating tokens.
+
+### Added — `scripts/audit/check-chunk-prop-fidelity.mjs` companion script (+194 LOC, NEW; sibling to scripts/release/ family)
+
+Audit script that re-runs the harvester in-place against a temp
+snapshot, diffs against committed chunks, restores via temp, reports
+added/removed/changed props per chunk. Sibling-positioned in
+`scripts/audit/` (rather than `scripts/release/`) because it has
+side-effecting probe-and-restore semantics (briefly mutates the working
+tree to compare).
+
+  default — exit 0; informational report
+  --strict — exit 1 if any chunk would diverge
+
+Catches future regressions of the §163/§164 class: a new chunk page
+authored without v0.9-aware harvester contract, OR a new prop added
+to the v0.9 catalog that doesn't flow through to existing chunks.
+
+### Changed — `version`: `0.5.3` → `0.5.4`.
+
+## [0.5.3] - 2026-05-14
+
+### Changed — `catalog-a2ui_0_9.json` regen for `<table-ui>` `row-collapse` event declaration (§162 ride-along, v0.5.3)
+
+`catalog-a2ui_0_9.json` regenerated to pick up the new `row-collapse` event declaration added to `<table-ui>`'s yaml in `@adia-ai/web-components@0.5.3` §162. Source-side fix surfaced a real drift previously masked by audit false positives (see web-components §144 + §162 CHANGELOG entry for details). The yaml `events[]` entry for `row-collapse` now flows through to `components.Table.x-adiaui.events.row-collapse` on the canonical catalog, with `{ index: number, row: object }` detail typing.
+
+### Added — 8 UI-primitive chunks for v0.5.3 §127 coverage gap (§143, v0.5.3)
+
+NEW `catalog/ui-patterns/v053-coverage-fill/` directory with 8 annotated chunks targeting the §127 Haiku-vs-Opus +7pp coverage gap (RESPONSE-07's path-forward: chunks close the gap at $0 marginal cost vs Opus 5× premium). Each chunk maps 1:1 to a missed Haiku intent from §127's empty-plan list:
+
+| Chunk | Intent (eval ID) | Primary primitives |
+|---|---|---|
+| `calendar-month-view` | calendar month view (eval-054) | `card-ui`, `calendar-picker-ui`, `button-ui` |
+| `color-picker-swatches` | color picker with swatches (eval-055) | `card-ui`, `color-picker-ui`, `swatch-ui` × 6 |
+| `slider-range-controls` | slider with range controls (eval-056) | `card-ui`, `range-ui`, `input-ui` × 2 |
+| `pagination-controls` | pagination controls (eval-060) | `card-ui`, `pagination-ui` |
+| `popover-with-content` | popover with content (eval-065) | `card-ui`, `button-ui`, `popover-ui` |
+| `avatar-group-overflow` | avatar group with overflow count (eval-069) | `card-ui`, `avatar-group-ui`, `avatar-ui` × 8 |
+| `divider-text-label` | divider with text label (eval-073) | `col-ui`, `divider-ui` × 2, `button-ui` |
+| `video-player-controls` | video player with controls (eval-095) | `card-ui`, `button-ui` × 3, `progress-ui` |
+
+Each chunk:
+
+- Lives in `catalog/ui-patterns/v053-coverage-fill/v053-coverage-fill.contents.html` (a single annotated HTML file with 8 `<section data-chunk-name=...>` regions)
+- Uses real AdiaUI primitives (no placeholder text components; full structural fidelity)
+- Carries `data-chunk-domain` ('forms' / 'data' / 'navigation' / 'layout') for retrieval ranking
+- Carries `data-chunk-keywords` matching the natural-language intent surface for Haiku's keyword-extraction
+- Carries `data-chunk-description` for the LLM picker's context block
+
+Corpus regen via `npm run harvest:chunks`: 222 → 230 chunks (+8); chunk index + per-chunk JSON regenerated. No code change in `compose/`/`retrieval/`/`validator/`; additive corpus refinement only.
+
+Expected impact: Haiku free-form coverage on the 100-intent held-out set lifts from 91% (post-v0.5.2 §125+§126) → ~98-99% (matching Opus's §127 ceiling). Empirical verification in v0.5.3 §145 rebaseline check (paired re-eval).
+
+Per the §127 verdict report (`docs/reports/free-form-haiku-vs-opus-2026-05-13.md`) — closing the coverage gap via chunk authoring is the right lever; model swap to Opus (5× cost) was rejected by the §127 decision rule. §143 ships the rejected-Opus's path-forward.
+
 ## [0.5.2] - 2026-05-13
 
 ### Changed — Catalog-text structural sweep on 5 under-substituted chunks (§125, v0.5.2)

package/catalog-a2ui_0_9.json

@@ -162,8 +162,14 @@
           "icon-ui"
         ],
         "events": {
-          "change": {
-            "description": "Fired when the set of open panels changes"
+          "toggle": {
+            "description": "Fired when the accordion panel opens or closes (single-pane accordion-ui dispatch — multi-pane group emits the same event per child).",
+            "detail": {
+              "open": {
+                "description": "New open state of the panel.",
+                "type": "boolean"
+              }
+            }
           }
         },
         "examples": [
@@ -3092,16 +3098,7 @@
         "composes": [],
         "events": {
           "canvas-interaction": {
-            "description": "Fired on canvas-interaction."
-          },
-          "change": {
-            "description": "Fired when the value changes (on blur for inputs, on selection for pickers)."
-          },
-          "click": {
-            "description": "Fired on pointer click."
-          },
-          "input": {
-            "description": "Fired on each input change during typing."
+            "description": "Fired on canvas interactions (focus, blur, pointer events). Dispatched at canvas.js:50 + :167."
           }
         },
         "examples": [
@@ -3215,11 +3212,7 @@
         "anti_patterns": [],
         "category": "container",
         "composes": [],
-        "events": {
-          "drag-end": {
-            "description": "Fired when a drag completes."
-          }
-        },
+        "events": {},
         "examples": [
           {
             "description": "Chat interface with message bubbles containing avatar and text pairs, plus an input footer.",
@@ -4125,6 +4118,162 @@
         "version": 1
       }
     },
+    "ChatInput": {
+      "title": "ChatInput",
+      "description": "Composable chat input bar — a self-contained chat-message composer\nthat stamps its OWN inner structure (textarea + model picker + send\nbutton) when authored as a bare `<chat-input-ui>` tag.\n\nIMPORTANT (closes the 2026-05-14 redundant-send-button class): the\ncomponent stamps a built-in send button (paper-plane-right icon,\nprimary variant). DO NOT add a separate Button sibling for \"send\" —\nthe user gets two send buttons. The submit event fires on Enter or\nsend-button click; `detail` is `{ text, model }`.\n\nInner stamped structure (default):\n  <chat-input-ui>\n    <textarea-ui placeholder=\"Type a message...\" rows=\"1\"></textarea-ui>\n    <div slot=\"toolbar\">\n      <select-ui slot=\"model\" placeholder=\"Model\">...</select-ui>\n      <button-ui icon=\"paper-plane-right\" variant=\"primary\" slot=\"send\"></button-ui>\n    </div>\n  </chat-input-ui>\n\nLayout:\n  ┌──────────────────────────────────┐\n  │  textarea (grows vertically)     │\n  ├──────────────────────────────────┤\n  │  [model ▾]           [⏎ send]   │  ← toolbar (model picker + built-in send)\n  └──────────────────────────────────┘\n\nComposite wrapper, not a form field itself. The inner textarea-ui\nis form-associated via UIFormElement and submits through the parent\nform. `chat-input-ui`'s `disabled` / `placeholder` props propagate\nto the inner textarea.\n\nFor module-tier composer surfaces (slot vocabulary for file attach,\nautocomplete, trailing/leading controls), wrap inside\n`<chat-composer>` — see ChatComposer for the module-tier shape.\n",
+      "type": "object",
+      "allOf": [
+        {
+          "$ref": "#/$defs/ComponentCommon"
+        },
+        {
+          "$ref": "#/$defs/CatalogComponentCommon"
+        }
+      ],
+      "properties": {
+        "component": {
+          "const": "ChatInput"
+        },
+        "disabled": {
+          "description": "Disable the entire input. Textarea becomes contenteditable=false;\nsend button disabled.\n",
+          "type": "boolean",
+          "default": false
+        },
+        "loading": {
+          "description": "In-flight / streaming state. Send button disabled, submit events\nsuppressed, but textarea stays editable so the user can draft a\nfollow-up while the model is still responding.\n",
+          "type": "boolean",
+          "default": false
+        },
+        "model": {
+          "description": "Currently selected model value (reflected, two-way with inner\n`<select-ui slot=\"model\">`). Empty when no model picker is shown.\n",
+          "type": "string",
+          "default": ""
+        },
+        "models": {
+          "description": "JSON array of model options for the inner model picker —\n[{value, label}] or [{label, options: [...]}] groups. Empty array\nhides the model picker.\n",
+          "type": "array",
+          "default": []
+        },
+        "placeholder": {
+          "description": "Textarea placeholder. Defaults to \"Type a message...\".",
+          "type": "string",
+          "default": "Type a message..."
+        }
+      },
+      "required": [
+        "component"
+      ],
+      "unevaluatedProperties": false,
+      "x-adiaui": {
+        "anti_patterns": [
+          {
+            "description": "Adding a separate Button(primary) sibling next to ChatInput for \"send\". The component stamps its own send button (paper-plane-right icon). Two send buttons render side-by-side, confusing users."
+          },
+          {
+            "description": "Stamping a Select next to ChatInput for model picker. The component has a built-in model picker driven by the `models` prop. Set `models=[{value, label}, ...]` instead of stamping a separate Select."
+          },
+          {
+            "description": "Wrapping ChatInput inside <field-ui label=\"...\"> for label association. ChatInput is a composite container, not a form field. For a labeled composer surface, use <chat-composer> + slot label markup."
+          }
+        ],
+        "category": "agent",
+        "composes": [],
+        "events": {
+          "submit": {
+            "description": "Fires when the user presses Enter (without Shift) in the textarea OR clicks the built-in send button. The composer suppresses submission while `[loading]` is set.",
+            "detail": {
+              "model": {
+                "description": "Currently selected model value (empty if no model picker).",
+                "type": "string"
+              },
+              "text": {
+                "description": "Submitted message text from the inner textarea.",
+                "type": "string"
+              }
+            }
+          }
+        },
+        "examples": [
+          {
+            "description": "Minimal chat input — placeholder, no model picker. Sits inside a chat shell footer.",
+            "a2ui": "[\n  {\"id\": \"root\", \"component\": \"ChatInput\", \"placeholder\": \"Ask me anything...\"}\n]",
+            "name": "basic-chat-input"
+          },
+          {
+            "description": "Chat input with model selection. The `models` prop drives the built-in model picker — DO NOT add a separate Select sibling.",
+            "a2ui": "[\n  {\n    \"id\": \"root\",\n    \"component\": \"ChatInput\",\n    \"placeholder\": \"Type a message...\",\n    \"model\": \"claude-opus-4-7\",\n    \"models\": [\n      {\"value\": \"claude-opus-4-7\", \"label\": \"Claude Opus 4.7\"},\n      {\"value\": \"claude-haiku-4-5\", \"label\": \"Claude Haiku 4.5\"},\n      {\"value\": \"claude-sonnet-4-5\", \"label\": \"Claude Sonnet 4.5\"}\n    ]\n  }\n]",
+            "name": "chat-input-with-models"
+          },
+          {
+            "description": "Streaming response state. `[loading]` reflects on the host; send button disables; textarea stays editable so the user can draft a follow-up while the LLM is responding.",
+            "a2ui": "[\n  {\n    \"id\": \"root\",\n    \"component\": \"ChatInput\",\n    \"placeholder\": \"Drafting follow-up while streaming...\",\n    \"loading\": true\n  }\n]",
+            "name": "chat-input-loading-state"
+          },
+          {
+            "description": "Full chat shell — header + thread + ChatInput in the footer. Note: ChatInput is the sole footer child; no separate send button.",
+            "a2ui": "[\n  {\"id\": \"root\", \"component\": \"ChatShell\", \"children\": [\"header\", \"thread\", \"input\"]},\n  {\"id\": \"header\", \"component\": \"ChatHeader\", \"title\": \"Chat\"},\n  {\"id\": \"thread\", \"component\": \"ChatThread\"},\n  {\"id\": \"input\", \"component\": \"ChatInput\", \"placeholder\": \"Send a message...\"}\n]",
+            "name": "chat-shell-with-chat-input"
+          }
+        ],
+        "keywords": [
+          "chat-input",
+          "chat",
+          "message-input",
+          "composer",
+          "send-message",
+          "conversation",
+          "prompt",
+          "submit"
+        ],
+        "name": "UIChatInput",
+        "related": [
+          "ChatShell",
+          "ChatThread",
+          "ChatComposer",
+          "ChatHeader",
+          "TextArea",
+          "Input"
+        ],
+        "slots": {
+          "model": {
+            "description": "Override slot for the model picker. Most authors should NOT override this — set the `models` prop instead."
+          },
+          "send": {
+            "description": "Override slot for the send button only. The default stamped send button has `[icon=\"paper-plane-right\"] [variant=\"primary\"]`. Most authors should NOT override this — the built-in send button IS the send control. Adding a separate Button sibling for \"send\" duplicates this functionality."
+          },
+          "toolbar": {
+            "description": "Override slot for the entire toolbar row (model picker + send button). Most authors should NOT override this — the built-in toolbar handles model selection + send. Use this only when custom toolbar layout is required."
+          }
+        },
+        "states": [
+          {
+            "description": "Default, accepting input. Send button enabled when textarea has content.",
+            "name": "idle"
+          },
+          {
+            "description": "Input fully disabled (typically during initial form setup).",
+            "attribute": "disabled",
+            "name": "disabled"
+          },
+          {
+            "description": "LLM is responding. Send button disabled + submit events suppressed, but textarea stays editable for follow-up drafts.",
+            "attribute": "loading",
+            "name": "loading"
+          }
+        ],
+        "synonyms": {
+          "message-input": [
+            "conversation-input",
+            "prompt-input",
+            "send-bar"
+          ]
+        },
+        "tag": "chat-input-ui",
+        "tokens": {},
+        "traits": [],
+        "version": 1
+      }
+    },
     "ChatShell": {
       "title": "ChatShell",
       "description": "Behavior-only chat orchestrator (LLM-streaming module). Author supplies the\nDOM structure via [data-chat-messages], [data-chat-input], [data-chat-empty],\n[data-chat-status] elements; chat-shell wires message streaming, markdown\nrendering, code-block upgrades, and an LLM integration path via proxy-url\n(or via external submit).\n",
@@ -5809,7 +5958,19 @@
         "composes": [],
         "events": {
           "close": {
-            "description": "Fired when the drawer is dismissed via close button or backdrop click"
+            "description": "Fired when the drawer closes via any path (close button, backdrop, Escape key, or programmatic `.open = false`). The `detail.reason` field distinguishes which.",
+            "detail": {
+              "reason": {
+                "description": "`'escape'` (Escape key) / `'backdrop'` (backdrop click) / `'close-button'` ([slot=\"close\"] button click) / `'programmatic'` (consumer set `.open = false` from JS). Defaults to `'programmatic'` when no event-driven path captured a reason. Added v0.5.3 §156 per FEEDBACK-06 §2.",
+                "type": "string",
+                "enum": [
+                  "escape",
+                  "backdrop",
+                  "close-button",
+                  "programmatic"
+                ]
+              }
+            }
           }
         },
         "examples": [
@@ -6780,6 +6941,90 @@
         "version": 1
       }
     },
+    "FeedItem": {
+      "title": "FeedItem",
+      "description": "Atomic feed entry inside a `<feed-ui>` lane. Three dismiss policies are inferred from the prop shape — auto-fade (duration > 0 + no action), sticky-dismissible (duration null/0), action-required (duration null/0 + action; future phase). Posted via `UIFeed.post()` rather than authored directly.",
+      "type": "object",
+      "allOf": [
+        {
+          "$ref": "#/$defs/ComponentCommon"
+        },
+        {
+          "$ref": "#/$defs/CatalogComponentCommon"
+        }
+      ],
+      "properties": {
+        "component": {
+          "const": "FeedItem"
+        },
+        "dismissible": {
+          "description": "Render an x close button (default true for sticky, false for auto-fade)",
+          "type": "boolean",
+          "default": false
+        },
+        "duration": {
+          "description": "Auto-fade timer in ms; null/0 = sticky (requires user input)",
+          "type": "number",
+          "default": 4000
+        },
+        "heading": {
+          "description": "Optional emphasis line above text",
+          "type": "string",
+          "default": ""
+        },
+        "icon": {
+          "description": "Optional leading icon name",
+          "type": "string",
+          "default": ""
+        },
+        "text": {
+          "description": "Body copy",
+          "type": "string",
+          "default": ""
+        },
+        "variant": {
+          "description": "Semantic variant",
+          "type": "string",
+          "enum": [
+            "default",
+            "info",
+            "success",
+            "warning",
+            "danger"
+          ],
+          "default": "default"
+        }
+      },
+      "required": [
+        "component"
+      ],
+      "unevaluatedProperties": false,
+      "x-adiaui": {
+        "anti_patterns": [],
+        "category": "feedback",
+        "composes": [],
+        "events": {
+          "close": {
+            "description": "Fired after the item finishes its exit animation"
+          }
+        },
+        "examples": [],
+        "keywords": [],
+        "name": "UIFeedItem",
+        "related": [],
+        "slots": {
+          "body": {
+            "description": "Default content slot (also accepts the `text` / `heading` props)"
+          }
+        },
+        "states": {},
+        "synonyms": {},
+        "tag": "feed-item-ui",
+        "tokens": {},
+        "traits": [],
+        "version": 1
+      }
+    },
     "Field": {
       "title": "Field",
       "description": "Labeled field wrapper. Composes a <label for=\"…\"> with a form control (input-ui, select-ui, textarea-ui, etc.) placed in the default slot, plus optional [slot=\"trailing\"] and [slot=\"action\"] regions. Auto-mints an id on the slotted control when missing so clicking the label focuses the control — an accessibility upgrade over setting label=\"…\" on the control directly, which has no [for] binding. Two layouts — stacked (default) and inline (the `inline` mode attribute collapses everything to a single row).",
@@ -11430,11 +11675,7 @@
         "anti_patterns": [],
         "category": "layout",
         "composes": [],
-        "events": {
-          "drag-end": {
-            "description": "Fired when a drag completes."
-          }
-        },
+        "events": {},
         "examples": [
           {
             "description": "Chat interface with message bubbles containing avatar and text pairs, plus an input footer.",
@@ -13901,6 +14142,19 @@
               }
             }
           },
+          "row-collapse": {
+            "description": "Fired when an already-expanded row's chevron is activated (collapses the row). Mirror of row-expand.",
+            "detail": {
+              "index": {
+                "description": "Row index in the underlying data array.",
+                "type": "number"
+              },
+              "row": {
+                "description": "Row data object.",
+                "type": "object"
+              }
+            }
+          },
           "row-expand": {
             "description": "Fired when an expandable row's chevron is activated. detail.index is the row position; detail.row is the row data.",
             "detail": {

package/catalog-a2ui_0_9_rules.txt

@@ -11,6 +11,11 @@
 - Multiple <section> siblings are allowed and stack vertically. [bleed] on a section removes its margin for edge-to-edge content (tables, charts); [padding] adds a canvas-scrim background for hero regions.
 - Footer with a [slot="description"] + [slot="action"] pair triggers justify-content: space-between — useful for a "Last saved …" note on the left and a Save/Cancel button group on the right.
 
+## ChatInput
+- ChatInput is a self-contained composer — it stamps its own textarea + model picker + send button. DO NOT add a separate Button sibling for "send" inside the same parent. The user gets two send buttons (one built-in, one redundant).
+- For chat interfaces emit ChatInput as the sole input component inside the chat shell. The submit event fires on Enter or send-button click; `detail` is `{ text, model }`.
+- To customize models, set the `models` prop with an array of {value, label} option objects. Do not stamp a separate Select next to ChatInput for model selection — the built-in model picker handles it.
+
 ## Check
 - 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. Wrapping breaks the consent-row layout (see field-ui anti_patterns).