@adia-ai/web-modules 0.8.30 → 0.8.31

package/CHANGELOG.md

@@ -1,11 +1,20 @@
 # Changelog — @adia-ai/web-modules
 
+## [0.8.31] — 2026-08-07
+
+### Fixed
+- **`chat-empty` is now registered** (gh#655). It had every sidecar (yaml/a2ui.json/examples) but no `defineIfFree('chat-empty', …)` anywhere — the tag never upgraded, so `customElements.whenDefined('chat-empty')` never resolved for any consumer awaiting it (light-DOM children still rendered; CSS tag-selectors still painted it, since neither cares about upgrade status — but the element itself stayed undefined). Added `chat-empty.js` with a minimal `UIElement` subclass (no reactive props, matching its CSS-only visibility contract) registered the way the sibling JS-bearing chat-cluster modules are (`chat-sidebar`, `chat-thread`, `chat-composer`); wired into `chat/index.js`'s barrel export.
+
+### Maintenance
+- **`dist/` bundles rebuilt** in this cut's window (1 file(s)) — regenerated from the source changes described above, not independent edits.
+
 ## [0.8.30] — 2026-08-07
 
 ### Added
 - **`chatShell.setStreamedText(text)`** — replaces the streaming assistant message's text outright, the counterpart to `appendChunk` for a producer that revises what it already streamed.
 
 ### Fixed
+- **`chat-composer` stops the inner `submit` event at its re-dispatch boundary (gh#676).** The re-emitted `composer-submit` was riding alongside the raw `submit` bubbling in from `chat-input-ui` unstopped — a host could receive both. `stopPropagation()` on the inner event before re-dispatching as `composer-submit` closes the second path.
 - **A rewritten or withheld turn now leaves the screen agreeing with the transcript (gh#665).** `wireAgentEvents` treated every `text` event as an append, so an `@adia-ai/agent` output guardrail's re-snapshot (`{ text: '', snapshot: <rewritten> }`) appended nothing and the ORIGINAL text stayed on screen while the session recorded the rewrite — a redaction that redacted nothing visible. An empty delta is now a replace from `snapshot` (an empty snapshot clears the bubble), which is safe for any text event since the snapshot is always the authoritative text.
 
 ### Maintenance

package/chat/chat-composer/chat-composer.js

@@ -49,6 +49,12 @@ class ChatComposer extends UIElement {
     this.#inputEl = this.querySelector('chat-input-ui') || this.querySelector('input-ui') || this.querySelector('textarea-ui');
 
     this.#onSubmit = (e) => {
+      // Stop the inner 'submit' event at this re-dispatch boundary too —
+      // this component re-emits it as 'composer-submit' below, so letting
+      // the raw 'submit' keep bubbling past chat-composer would let a
+      // host that (also) listens for raw 'submit' receive a duplicate
+      // (gh#676).
+      e.stopPropagation();
       // Re-emit as 'composer-submit' so host listens to one event
       // regardless of which inner input it is
       this.dispatchEvent(new CustomEvent('composer-submit', {

package/chat/chat-empty/chat-empty.a2ui.json

@@ -2,7 +2,7 @@
   "$schema": "https://json-schema.org/draft/2020-12/schema",
   "$id": "https://adiaui.dev/a2ui/v0_9/components/ChatEmpty.json",
   "title": "ChatEmpty",
-  "description": "Module-tier chat empty state. CSS-only — no behavior, no JS. Sits\nas the first child of <chat-thread> as the empty state placeholder.\nVisibility is driven by <chat-thread>'s [empty] reflected attribute\nvia CSS (no JS toggling needed) — when messages arrive, the parent\nthread loses [empty] and CSS hides this stub.\n\nReplaces the legacy <empty-state-ui data-chat-empty> child of the\nmessages container per ADR-0023. The legacy shape was retired in\nv0.4.0 per ADR-0024 and is no longer recognized.\n",
+  "description": "Module-tier chat empty state. No reactive props — visibility is\ndriven by <chat-thread>'s [empty] reflected attribute via CSS (no\nJS toggling needed); when messages arrive, the parent thread loses\n[empty] and CSS hides this stub. Registered (defineIfFree) so the\ntag upgrades and resolves customElements.whenDefined('chat-empty')\n(gh#655) — sits as the first child of <chat-thread> as the empty\nstate placeholder.\n\nReplaces the legacy <empty-state-ui data-chat-empty> child of the\nmessages container per ADR-0023. The legacy shape was retired in\nv0.4.0 per ADR-0024 and is no longer recognized.\n",
   "type": "object",
   "allOf": [
     {

package/chat/chat-empty/chat-empty.d.ts

@@ -0,0 +1,27 @@
+/**
+ * `<chat-empty>` — Module-tier chat empty state. No reactive props — visibility is
+driven by <chat-thread>'s [empty] reflected attribute via CSS (no
+JS toggling needed); when messages arrive, the parent thread loses
+[empty] and CSS hides this stub. Registered (defineIfFree) so the
+tag upgrades and resolves customElements.whenDefined('chat-empty')
+(gh#655) — sits as the first child of <chat-thread> as the empty
+state placeholder.
+
+Replaces the legacy <empty-state-ui data-chat-empty> child of the
+messages container per ADR-0023. The legacy shape was retired in
+v0.4.0 per ADR-0024 and is no longer recognized.
+
+ *
+ * @see https://ui-kit.exe.xyz/site/components/chat-empty
+ *
+ * Type declarations generated by scripts/build/dts-codegen.mjs from
+ * the component's `.a2ui.json` sidecar(s). Edit the source `.yaml`,
+ * run `npm run build:components`, then `npm run codegen:dts` to
+ * regenerate; or hand-author this file fully if rich event types are
+ * needed beyond what the yaml `events:` block can express.
+ */
+
+import { UIElement } from '../../../web-components/core/element.js';
+
+export class ChatEmpty extends UIElement {
+}

package/chat/chat-empty/chat-empty.js

@@ -0,0 +1,34 @@
+/**
+ * <chat-empty>
+ *   <empty-state-ui icon="chat-circle" heading="Hello!" description="Ask me anything."></empty-state-ui>
+ * </chat-empty>
+ *
+ * Module-tier chat empty state — the bespoke replacement for legacy
+ * `<empty-state-ui data-chat-empty>` per ADR-0023. Sits as the first
+ * child of <chat-thread>; visibility is driven entirely by CSS off
+ * <chat-thread>'s [empty] reflected attribute (see
+ * chat-shell/css/chat-shell.bespoke.css) — no JS toggling needed.
+ *
+ * Registered (gh#655) even though the element carries no reactive
+ * state: an unregistered custom element never resolves
+ * `customElements.whenDefined('chat-empty')` and never matches
+ * `:defined` — a host or test that waits on either hangs/mismatches
+ * forever, even though CSS tag-selectors keep painting it either way.
+ * Matches the sibling JS-bearing chat-cluster modules' own-file
+ * registration shape (chat-sidebar, chat-thread, chat-composer);
+ * chat-header/chat-status stay genuinely unregistered CSS-only markup
+ * wrappers — chat-empty is the one with a live tag reference in
+ * consumer surfaces (patient-visit), so it gets the class.
+ */
+
+import { defineIfFree } from '../../../web-components/core/register.js';
+import { UIElement } from '../../../web-components/core/element.js';
+
+class ChatEmpty extends UIElement {
+  static properties = {};
+
+  static template = () => null;
+}
+
+defineIfFree('chat-empty', ChatEmpty);
+export { ChatEmpty };

package/chat/chat-empty/chat-empty.yaml

@@ -7,11 +7,13 @@ component: ChatEmpty
 category: feedback
 version: 1
 description: |
-  Module-tier chat empty state. CSS-only — no behavior, no JS. Sits
-  as the first child of <chat-thread> as the empty state placeholder.
-  Visibility is driven by <chat-thread>'s [empty] reflected attribute
-  via CSS (no JS toggling needed) — when messages arrive, the parent
-  thread loses [empty] and CSS hides this stub.
+  Module-tier chat empty state. No reactive props — visibility is
+  driven by <chat-thread>'s [empty] reflected attribute via CSS (no
+  JS toggling needed); when messages arrive, the parent thread loses
+  [empty] and CSS hides this stub. Registered (defineIfFree) so the
+  tag upgrades and resolves customElements.whenDefined('chat-empty')
+  (gh#655) — sits as the first child of <chat-thread> as the empty
+  state placeholder.
 
   Replaces the legacy <empty-state-ui data-chat-empty> child of the
   messages container per ADR-0023. The legacy shape was retired in
@@ -43,8 +45,8 @@ a2ui:
       <empty-state-ui data-chat-empty>. Place as the first child of
       <chat-thread>; visibility is automatic via the [empty]
       reflected attribute.
-    - rule: 'CSS-only — no JS module needed in shell HTML imports.'
-      reason: 'CSS-only primitive.'
+    - rule: 'No reactive props — visibility is CSS-driven off the parent [empty] attribute, not a JS toggle.'
+      reason: 'State contract.'
     - rule: 'For non-chat empty states (lists, tables, canvas) use <empty-state-ui> primitive instead; chat-empty is chat-cluster-namespaced.'
       reason: 'Cluster vs primitive distinction.'
 

package/chat/index.js

@@ -2,4 +2,5 @@ export { ChatShell } from './chat-shell/chat-shell.js';
 export { ChatThread } from './chat-thread/chat-thread.js';
 export { ChatComposer } from './chat-composer/chat-composer.js';
 export { ChatSidebar } from './chat-sidebar/chat-sidebar.js';
+export { ChatEmpty } from './chat-empty/chat-empty.js';
 export { createSurfaceRegistry, wireAgentEvents, PROGRESS_LABELS } from './chat-surfaces/chat-surfaces.js';