@adia-ai/a2ui-corpus 0.5.3 → 0.5.4

package/CHANGELOG.md

@@ -19,6 +19,66 @@ 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)

package/catalog-a2ui_0_9.json

@@ -4118,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",
@@ -6785,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).",

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).