@adia-ai/web-modules 0.6.20 → 0.6.22

package/CHANGELOG.md

@@ -1,5 +1,33 @@
 # Changelog — @adia-ai/web-modules
 
+## [0.6.22] — 2026-05-22
+
+### Changed — `admin-topbar` and `admin-statusbar` use fixed `--a-space-3` padding instead of content inset
+
+- **Topbar and statusbar inline padding changed from `0 var(--page-content-inset)` to `0 var(--a-space-3)` (12px).** The bars are navigation chrome, not page content — using the 40px content inset was excessively wide and inconsistent with other shell-tier chrome. The sidebar override (`admin-sidebar > :is(admin-topbar, admin-statusbar)`) still applies `--page-sidebar-px` for the sidebar context. Files: `css/admin-shell.bespoke.css`.
+
+### Changed — content inset breakpoints added for `admin-page-header` and `admin-page-body`
+
+- **Two new `@container page-content` breakpoints tighten the page gutter on narrow viewports.** At `≤ 768px` inline padding becomes `--a-space-8` (32px); at `≤ 480px` it becomes `--a-space-6` (24px), replacing the previous single breakpoint that used `--a-space-4` (16px). Both `padding-inline` and `padding-block` are covered for `admin-page-body > section`. File: `css/admin-shell.templates.css`.
+
+### Documentation — yaml SoT completeness sweep across `chat/`, `editor/`, `runtime/`, `simple/` clusters
+
+- **§404–§409 + Arc A–E yaml SoT campaign** touched composite-element yamls under `packages/web-modules/chat/`, `packages/web-modules/editor/`, `packages/web-modules/runtime/`, and `packages/web-modules/simple/`. Arc A populated 31 `a2ui.rules` for shell-composition-relevant primitives; Arc B expanded 27 short descriptions to 3-sentence canonical prose; Arcs C+D completed 87 yamls and lifted zettel coverage 5% → 49%; Arc E backfilled keywords/synonyms/related on 67 yamls; §408 groomed thin-rule primitives + fixed a catalog-renderer bug; §409 added regression gates + a fork-4 module-tier groom. Side-effects: `chat-composer`, `chat-empty`, `chat-header`, `chat-shell`, `chat-sidebar`, `chat-status`, `chat-thread`, `editor-canvas-empty`, `editor-canvas`, `editor-shell`, `editor-sidebar`, and the `runtime/` + `simple/` cluster regenerated `.a2ui.json` + `.d.ts` sidecars from the updated yaml.
+
+## [0.6.21] — 2026-05-21
+
+### Changed — `<admin-entity-item>` row insets aligned to shared select / nav-item-ui row convention
+
+- **`--entity-item-gap`: `--a-space-2` → `--a-space-1`** (matches `--select-trigger-gap` + `--nav-item-row-gap`) and **NEW `--entity-item-px: --a-ui-px` token** with `padding: 0 var(--entity-item-px)` on the host rule (matches `--select-px` + `--nav-item-row-px`). Identity rows now read as the same shared row vocabulary used inside `<select-ui>` triggers and `<nav-item-ui>` rows — visibly tighter gap between icon / label / badge, plus consistent inline padding. Both tunable: a consumer who finds the inset double-pads inside a particular parent context can set `--entity-item-px: 0` on a per-use basis. Files: `css/admin-shell.entity-item.css`.
+
+### Fixed — `admin-shell` no longer emits a spurious slot-contract `console.warn`
+
+- **The one-shot `console.warn` for `<admin-topbar>` / `<admin-statusbar>` missing `slot="header"` / `slot="footer"` (shipped in 0.6.20, FEEDBACK-37) is reverted — it was a false positive.** `<admin-content>` and `<admin-sidebar>` are CSS-only light-DOM elements with no shadow root, so a `slot=` attribute is inert (no projection), and no CSS selector targets `[slot="header"]` / `[slot="footer"]` for them — the topbar/statusbar are positioned purely by tag + DOM order (`admin-content > admin-topbar { … }`). The bars render identically with or without the slot; the warn fired on correct markup with a message that was factually wrong ("renders in the default body slot"). FEEDBACK-37's premise — that the slot is load-bearing — did not hold. Removed: `admin-shell.js` `#checkSlotContracts()` + the `MUST carry slot` `a2ui.rules` in `admin-topbar.yaml` / `admin-statusbar.yaml`.
+
+### Fixed — page-header title row no longer stacks under the `?chunks` dev overlay
+
+- **The `<admin-page-header>` title row (`h1` left, actions right) used a `:first-child` selector that broke when the `?chunks=1` dev overlay was active.** `site/dev-chunks.js` prepends a `<span data-chunk-marker>` into every `[data-chunk]` element; on a page-header `<header data-chunk="…">` that span displaced the title `<div>` from `:first-child`, so the flex-row rule (`display: flex; justify-content: space-between`) stopped matching — the title and the action buttons stacked vertically instead of sharing a row. The selector is now `div:first-of-type`, which a prepended non-`<div>` sibling cannot displace. Production (overlay off) was unaffected; this fixes the chunks-on dev view. Files: `css/admin-shell.templates.css`.
+
 ## [0.6.20] — 2026-05-21
 
 ### Added — `<admin-entity-item>` shell identity-row primitive (FEEDBACK-38)

package/chat/chat-composer/chat-composer.a2ui.json

@@ -2,7 +2,7 @@
   "$schema": "https://json-schema.org/draft/2020-12/schema",
   "$id": "https://adiaui.dev/a2ui/v0_9/components/ChatComposer.json",
   "title": "ChatComposer",
-  "description": "Module-tier chat composer wrapper — replaces legacy <chat-input-ui\ndata-chat-input> direct child of <chat-shell> per ADR-0023.\nForwards submit events as 'composer-submit', propagates [disabled]\nto the inner input, provides slot vocabulary for future composer\nsurfaces (file attach, autocomplete, model picker).\n\nSits inside <chat-shell> as the input region (typically inside or\nalongside the footer). Authors place an inner <chat-input-ui>\n(or input-ui / textarea-ui) as the primary input.\n\nBackwards compat — <chat-shell> still recognizes the legacy\n<chat-input-ui data-chat-input> shape via :is() selector. New\ncode should prefer <chat-composer>.\n",
+  "description": "Module-tier chat composer wrapper — replaces legacy <chat-input-ui\ndata-chat-input> direct child of <chat-shell> per ADR-0023.\nForwards submit events as 'composer-submit', propagates [disabled]\nto the inner input, provides slot vocabulary for future composer\nsurfaces (file attach, autocomplete, model picker).\n\nSits inside <chat-shell> as the input region (typically inside or\nalongside the footer). Authors place an inner <chat-input-ui>\n(or input-ui / textarea-ui) as the primary input.\n",
   "type": "object",
   "allOf": [
     {

package/chat/chat-composer/chat-composer.d.ts

@@ -9,10 +9,6 @@ Sits inside <chat-shell> as the input region (typically inside or
 alongside the footer). Authors place an inner <chat-input-ui>
 (or input-ui / textarea-ui) as the primary input.
 
-Backwards compat — <chat-shell> still recognizes the legacy
-<chat-input-ui data-chat-input> shape via :is() selector. New
-code should prefer <chat-composer>.
-
  *
  * @see https://ui-kit.exe.xyz/site/components/chat-composer
  *

package/chat/chat-composer/chat-composer.yaml

@@ -16,10 +16,6 @@ description: |
   alongside the footer). Authors place an inner <chat-input-ui>
   (or input-ui / textarea-ui) as the primary input.
 
-  Backwards compat — <chat-shell> still recognizes the legacy
-  <chat-input-ui data-chat-input> shape via :is() selector. New
-  code should prefer <chat-composer>.
-
 props:
   disabled:
     description: |
@@ -72,6 +68,10 @@ a2ui:
       The host listens for 'composer-submit' on the composer (not on
       the inner input). The event detail mirrors the inner submit
       event so existing handlers Just Work.
+    - rule: 'Default slot holds a single <chat-input-ui> child; trailing/attach/leading slots host action buttons (send, attach, model picker).'
+      reason: 'Slot contract — single input + action clusters.'
+    - rule: 'For non-chat input surfaces (forms, prompts, search) use <chat-input-ui> directly without the composer wrapper.'
+      reason: 'Chat-cluster vs standalone usage.'
 
 keywords:
   - chat-composer

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. Both shapes still work via\nbackwards compat; new code should prefer <chat-empty>.\n",
+  "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",
   "type": "object",
   "allOf": [
     {

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

@@ -13,8 +13,8 @@ description: |
   thread loses [empty] and CSS hides this stub.
 
   Replaces the legacy <empty-state-ui data-chat-empty> child of the
-  messages container per ADR-0023. Both shapes still work via
-  backwards compat; new code should prefer <chat-empty>.
+  messages container per ADR-0023. The legacy shape was retired in
+  v0.4.0 per ADR-0024 and is no longer recognized.
 
 props: {}
 
@@ -42,6 +42,10 @@ 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: '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.'
 
 keywords:
   - chat-empty

package/chat/chat-header/chat-header.a2ui.json

@@ -2,7 +2,7 @@
   "$schema": "https://json-schema.org/draft/2020-12/schema",
   "$id": "https://adiaui.dev/a2ui/v0_9/components/ChatHeader.json",
   "title": "ChatHeader",
-  "description": "Module-tier chat header chrome bar. CSS-only — no behavior, no JS.\nSits at the top of <chat-shell> or inside a <chat-sidebar>. Holds\nthe chat name, status indicator, and action clusters via slot\nvocabulary.\n\nReplaces the legacy <header> with [data-chat-name] / [data-chat-status]\ndata-attribute children. Both shapes still work per ADR-0023 backwards\ncompat; new code should prefer <chat-header> with <chat-status> as\na slotted child.\n",
+  "description": "Module-tier chat header chrome bar. CSS-only — no behavior, no JS.\nSits at the top of <chat-shell> or inside a <chat-sidebar>. Holds\nthe chat name, status indicator, and action clusters via slot\nvocabulary.\n\nReplaces the legacy <header> with [data-chat-name] / [data-chat-status]\ndata-attribute children per ADR-0023. The legacy shape was retired\nin v0.4.0 per ADR-0024 and is no longer recognized; new code uses\n<chat-header> with <chat-status> as a slotted child.\n",
   "type": "object",
   "allOf": [
     {

package/chat/chat-header/chat-header.yaml

@@ -12,9 +12,9 @@ description: |
   vocabulary.
 
   Replaces the legacy <header> with [data-chat-name] / [data-chat-status]
-  data-attribute children. Both shapes still work per ADR-0023 backwards
-  compat; new code should prefer <chat-header> with <chat-status> as
-  a slotted child.
+  data-attribute children per ADR-0023. The legacy shape was retired
+  in v0.4.0 per ADR-0024 and is no longer recognized; new code uses
+  <chat-header> with <chat-status> as a slotted child.
 
 props: {}
 
@@ -51,6 +51,10 @@ a2ui:
       chat-header replaces the legacy <header> chrome bar inside
       <chat-shell>. Use named slots for canonical clusters; ad-hoc
       content goes in the default slot.
+    - rule: 'Slots: [slot="name"] for chat title, [slot="status"] for streaming/connection indicator (<chat-status>), [slot="action"] for action buttons.'
+      reason: 'Slot contract.'
+    - rule: 'For admin-shell-style chrome bars inside chat-shell, use <admin-topbar> instead — chat-header is for in-chat metadata only.'
+      reason: 'Chat-metadata vs shell-chrome distinction.'
 
 keywords:
   - chat-header

package/chat/chat-shell/chat-shell.a2ui.json

@@ -2,7 +2,7 @@
   "$schema": "https://json-schema.org/draft/2020-12/schema",
   "$id": "https://adiaui.dev/a2ui/v0_9/components/ChatShell.json",
   "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",
+  "description": "Behavior-only chat orchestrator (LLM-streaming module). Canonical\nauthoring shape uses cluster-namespaced bespoke children —\n<chat-thread> as the message scroll surface (containing <chat-empty>\nas the empty-state slot), <chat-composer> wrapping the input\nprimitive, and optional <chat-header> / <chat-sidebar> / <chat-status>\nchrome. The shell wires LLM streaming, markdown rendering, code-block\nupgrades, and the proxy-url integration path; each bespoke child owns\nits own [streaming] / [empty] / [disabled] state-as-attribute\nsemantics per ADR-0023.\n\nLegacy data-attribute shapes (<section data-chat-messages>,\n<chat-input-ui data-chat-input>, <empty-state-ui data-chat-empty>,\n<header data-chat-name>) were RETIRED in v0.4.0 per ADR-0024 and\nare no longer recognized. Consumers must use the bespoke vocabulary.\n",
   "type": "object",
   "allOf": [
     {
@@ -32,7 +32,7 @@
       "default": ""
     },
     "streaming": {
-      "description": "Active streaming indicator; toggled while a response is being received.",
+      "description": "Active streaming indicator; toggled while a response is being received. Propagated to <chat-thread>[streaming] and <chat-composer>[disabled].",
       "type": "boolean",
       "default": false
     },
@@ -94,7 +94,7 @@
         }
       },
       "submit": {
-        "description": "Fired on user message submit (before LLM call begins).",
+        "description": "Fired on user message submit (before LLM call begins). Forwarded from <chat-composer>'s composer-submit event.",
         "detail": {
           "model": "string",
           "text": "string"
@@ -114,16 +114,23 @@
       "llm",
       "streaming",
       "conversation",
-      "agent"
+      "agent",
+      "assistant"
     ],
     "name": "ChatShell",
     "related": [
+      "ChatThread",
+      "ChatComposer",
+      "ChatEmpty",
+      "ChatHeader",
+      "ChatSidebar",
+      "ChatStatus",
       "ChatInput",
       "Code"
     ],
     "slots": {
       "default": {
-        "description": "Author provides the structural DOM. Expected markers — [data-chat-messages] (message list), [data-chat-input] (input surface), [data-chat-empty] (empty state), [data-chat-status] (streaming indicator)."
+        "description": "Bespoke children compose here in document order — typically <chat-thread> (with optional <chat-empty> inside) for the message surface, then <chat-composer> wrapping a <chat-input-ui submit-on-enter> for the input. Optional <chat-header>, <chat-sidebar slot=\"leading|trailing\">, <chat-status>."
       }
     },
     "states": [
@@ -132,7 +139,7 @@
         "name": "idle"
       },
       {
-        "description": "An LLM request is in-flight; [data-chat-status] visible.",
+        "description": "An LLM request is in-flight; child <chat-thread>[streaming] + <chat-composer>[disabled] propagate from this attribute.",
         "attribute": "streaming",
         "name": "streaming"
       }
@@ -141,7 +148,9 @@
       "chat": [
         "conversation",
         "messages",
-        "thread"
+        "thread",
+        "assistant",
+        "agent"
       ]
     },
     "tag": "chat-shell",

package/chat/chat-shell/chat-shell.d.ts

@@ -1,9 +1,18 @@
 /**
- * `<chat-shell-ui>` — Behavior-only chat orchestrator (LLM-streaming module). Author supplies the
-DOM structure via [data-chat-messages], [data-chat-input], [data-chat-empty],
-[data-chat-status] elements; chat-shell wires message streaming, markdown
-rendering, code-block upgrades, and an LLM integration path via proxy-url
-(or via external submit).
+ * `<chat-shell-ui>` — Behavior-only chat orchestrator (LLM-streaming module). Canonical
+authoring shape uses cluster-namespaced bespoke children —
+<chat-thread> as the message scroll surface (containing <chat-empty>
+as the empty-state slot), <chat-composer> wrapping the input
+primitive, and optional <chat-header> / <chat-sidebar> / <chat-status>
+chrome. The shell wires LLM streaming, markdown rendering, code-block
+upgrades, and the proxy-url integration path; each bespoke child owns
+its own [streaming] / [empty] / [disabled] state-as-attribute
+semantics per ADR-0023.
+
+Legacy data-attribute shapes (<section data-chat-messages>,
+<chat-input-ui data-chat-input>, <empty-state-ui data-chat-empty>,
+<header data-chat-name>) were RETIRED in v0.4.0 per ADR-0024 and
+are no longer recognized. Consumers must use the bespoke vocabulary.
 
  *
  * @see https://ui-kit.exe.xyz/site/components/chat-shell
@@ -63,7 +72,7 @@ export class ChatShell extends UIElement {
   provider: string;
   /** API proxy endpoint for LLM calls; enables self-contained chat without external wiring. */
   proxyUrl: string;
-  /** Active streaming indicator; toggled while a response is being received. */
+  /** Active streaming indicator; toggled while a response is being received. Propagated to <chat-thread>[streaming] and <chat-composer>[disabled]. */
   streaming: boolean;
   /** System prompt prepended to conversations. */
   system: string;

package/chat/chat-shell/chat-shell.yaml

@@ -5,22 +5,32 @@ component: ChatShell
 category: container
 version: 1
 description: |
-  Behavior-only chat orchestrator (LLM-streaming module). Author supplies the
-  DOM structure via [data-chat-messages], [data-chat-input], [data-chat-empty],
-  [data-chat-status] elements; chat-shell wires message streaming, markdown
-  rendering, code-block upgrades, and an LLM integration path via proxy-url
-  (or via external submit).
+  Behavior-only chat orchestrator (LLM-streaming module). Canonical
+  authoring shape uses cluster-namespaced bespoke children —
+  <chat-thread> as the message scroll surface (containing <chat-empty>
+  as the empty-state slot), <chat-composer> wrapping the input
+  primitive, and optional <chat-header> / <chat-sidebar> / <chat-status>
+  chrome. The shell wires LLM streaming, markdown rendering, code-block
+  upgrades, and the proxy-url integration path; each bespoke child owns
+  its own [streaming] / [empty] / [disabled] state-as-attribute
+  semantics per ADR-0023.
+
+  Legacy data-attribute shapes (<section data-chat-messages>,
+  <chat-input-ui data-chat-input>, <empty-state-ui data-chat-empty>,
+  <header data-chat-name>) were RETIRED in v0.4.0 per ADR-0024 and
+  are no longer recognized. Consumers must use the bespoke vocabulary.
 
 # Per ADR-0027 — primitives that programmatically create other primitives
 # do NOT auto-import them. Consumer (or demo shell) must explicitly import.
 composes:
   - code-ui
+
 props:
   streaming:
     type: boolean
     default: false
     reflect: true
-    description: Active streaming indicator; toggled while a response is being received.
+    description: Active streaming indicator; toggled while a response is being received. Propagated to <chat-thread>[streaming] and <chat-composer>[disabled].
 
   provider:
     type: string
@@ -55,7 +65,7 @@ props:
 
 events:
   submit:
-    description: Fired on user message submit (before LLM call begins).
+    description: Fired on user message submit (before LLM call begins). Forwarded from <chat-composer>'s composer-submit event.
     detail:
       text: string
       model: string
@@ -99,25 +109,55 @@ events:
 slots:
   default:
     description: >-
-      Author provides the structural DOM. Expected markers —
-      [data-chat-messages] (message list), [data-chat-input] (input surface),
-      [data-chat-empty] (empty state), [data-chat-status] (streaming indicator).
+      Bespoke children compose here in document order — typically
+      <chat-thread> (with optional <chat-empty> inside) for the message
+      surface, then <chat-composer> wrapping a <chat-input-ui
+      submit-on-enter> for the input. Optional <chat-header>,
+      <chat-sidebar slot="leading|trailing">, <chat-status>.
 
 states:
   - name: idle
     description: No active request.
   - name: streaming
     attribute: streaming
-    description: An LLM request is in-flight; [data-chat-status] visible.
+    description: An LLM request is in-flight; child <chat-thread>[streaming] + <chat-composer>[disabled] propagate from this attribute.
 
 traits: []
 
 a2ui:
   rules:
-    - chat-shell is a behavior wrapper; don't nest col-ui/row-ui inside it directly —
-      author the structural DOM using [data-chat-*] markers instead.
+    - >-
+      chat-shell takes bespoke chat-* children only. The canonical
+      composition is <chat-thread> (with optional first-child
+      <chat-empty>) followed by <chat-composer> wrapping a
+      <chat-input-ui submit-on-enter>. Add <chat-header> /
+      <chat-sidebar> / <chat-status> as needed.
+    - >-
+      Don't nest col-ui / row-ui or generic layout primitives directly
+      inside chat-shell — the shell's CSS reads child tag selectors to
+      lay them out. Generic layout goes inside the bespoke children.
+    - >-
+      The shell listens for 'composer-submit' on <chat-composer> (not
+      on the inner input). Streaming state is reflected on this host
+      and propagates to <chat-thread>[streaming] + <chat-composer>[disabled]
+      automatically — don't toggle child attributes manually.
+    - >-
+      Legacy data-attribute shapes were retired in v0.4.0 per ADR-0024.
+      Do not author <section data-chat-messages>, <chat-input-ui
+      data-chat-input>, <empty-state-ui data-chat-empty>, or <header
+      data-chat-name> inside chat-shell.
+
+keywords: [chat-shell, chat, llm, streaming, conversation, agent, assistant]
 
-keywords: [chat-shell, chat, llm, streaming, conversation, agent]
 synonyms:
-  chat: [conversation, messages, thread]
-related: [ChatInput, Code]
+  chat: [conversation, messages, thread, assistant, agent]
+
+related:
+  - ChatThread
+  - ChatComposer
+  - ChatEmpty
+  - ChatHeader
+  - ChatSidebar
+  - ChatStatus
+  - ChatInput
+  - Code

package/chat/chat-sidebar/chat-sidebar.yaml

@@ -117,6 +117,10 @@ a2ui:
       For chrome bars inside the sidebar, prefer <admin-topbar
       slot="header"> and <admin-statusbar slot="footer"> over raw
       <header-ui> / <footer-ui> when authoring shell-tier markup.
+    - rule: 'Use cluster-distinct localStorage key (adia-chat-sidebar-*) to avoid collisions with admin (adia-sidebar-*) and editor (adia-editor-sidebar-*) sidebars.'
+      reason: 'Per-cluster persistence isolation.'
+    - rule: 'For chat-list / conversation-switcher content, host <nav-ui> + <nav-item-ui> children in the default slot.'
+      reason: 'Common composition pattern.'
 
 keywords:
   - chat-sidebar

package/chat/chat-status/chat-status.yaml

@@ -36,6 +36,10 @@ a2ui:
       chat-status replaces legacy <span data-chat-status> for the
       streaming/connection indicator. Place inside <chat-header
       slot="status">.
+    - rule: 'CSS-only — content is innerHTML (typically a short status word like ''connected'' or ''streaming'' or an icon).'
+      reason: 'Decorative primitive.'
+    - rule: 'Use [data-state="streaming|connected|disconnected|..."] for token-driven coloring; the CSS reads the state attribute for tinting.'
+      reason: 'State-driven styling knob.'
 
 keywords:
   - chat-status

package/chat/chat-thread/chat-thread.a2ui.json

@@ -2,7 +2,7 @@
   "$schema": "https://json-schema.org/draft/2020-12/schema",
   "$id": "https://adiaui.dev/a2ui/v0_9/components/ChatThread.json",
   "title": "ChatThread",
-  "description": "Module-tier chat message thread container — replaces legacy\n<section data-chat-messages> per ADR-0023. Owns scroll-to-bottom\non new message (with user-scroll-up suspension), [streaming] and\n[empty] reflected attributes, and a stable target for the host's\nmessage rendering pipeline.\n\nSits inside <chat-shell> as the central scroll surface. Authors\ncompose <chat-empty> as an optional first child for the empty\nstate; message children are appended dynamically by the host.\n\nBackwards compat — <chat-shell> still recognizes the legacy\n<section data-chat-messages> shape via :is() selector. New code\nshould prefer <chat-thread>.\n",
+  "description": "Module-tier chat message thread container — replaces legacy\n<section data-chat-messages> per ADR-0023. Owns scroll-to-bottom\non new message (with user-scroll-up suspension), [streaming] and\n[empty] reflected attributes, and a stable target for the host's\nmessage rendering pipeline.\n\nSits inside <chat-shell> as the central scroll surface. Authors compose <chat-empty> as an optional first child for the empty state; message children are appended dynamically by the host.\n",
   "type": "object",
   "allOf": [
     {

package/chat/chat-thread/chat-thread.d.ts

@@ -5,13 +5,7 @@ on new message (with user-scroll-up suspension), [streaming] and
 [empty] reflected attributes, and a stable target for the host's
 message rendering pipeline.
 
-Sits inside <chat-shell> as the central scroll surface. Authors
-compose <chat-empty> as an optional first child for the empty
-state; message children are appended dynamically by the host.
-
-Backwards compat — <chat-shell> still recognizes the legacy
-<section data-chat-messages> shape via :is() selector. New code
-should prefer <chat-thread>.
+Sits inside <chat-shell> as the central scroll surface. Authors compose <chat-empty> as an optional first child for the empty state; message children are appended dynamically by the host.
 
  *
  * @see https://ui-kit.exe.xyz/site/components/chat-thread

package/chat/chat-thread/chat-thread.yaml

@@ -16,18 +16,9 @@ description: 'Module-tier chat message thread container — replaces legacy
 
 
   Sits inside <chat-shell> as the central scroll surface. Authors
-
   compose <chat-empty> as an optional first child for the empty
-
   state; message children are appended dynamically by the host.
 
-
-  Backwards compat — <chat-shell> still recognizes the legacy
-
-  <section data-chat-messages> shape via :is() selector. New code
-
-  should prefer <chat-thread>.
-
   '
 props:
   streaming:
@@ -71,6 +62,10 @@ a2ui:
     scroll surface; the host appends dynamic message divs as children.
   - Place <chat-empty> as an optional first child for the empty state; the [empty] reflected attribute drives its visibility
     via CSS (no JS toggling).
+  - rule: 'Different from primitive <chat-thread-ui>: chat-thread (no -ui suffix) is the module-tier shell-aware version with scroll-on-new-message + load-more + empty-state coordination.'
+    reason: 'Primitive vs cluster-child sibling distinction.'
+  - rule: 'Hosts message blocks (typically agent/user message rows) as default-slot children; <chat-empty> goes as first child for the empty state.'
+    reason: 'Composition contract.'
 keywords:
 - chat-thread
 - message-list

package/editor/editor-canvas/editor-canvas.a2ui.json

@@ -2,7 +2,7 @@
   "$schema": "https://json-schema.org/draft/2020-12/schema",
   "$id": "https://adiaui.dev/a2ui/v0_9/components/EditorCanvas.json",
   "title": "EditorCanvas",
-  "description": "Module-tier editor canvas surface — replaces legacy <div data-canvas>\ninside <editor-shell> per ADR-0023. Owns scroll/zoom container\nsemantics, [empty] and [focused] reflected attributes, and a stable\ntarget for the host's content rendering pipeline.\n\nSits as the central content region inside <editor-shell>, between\nthe optional <editor-sidebar slot=\"leading\"> and <editor-sidebar\nslot=\"trailing\">. Authors compose <editor-canvas-empty> as an\noptional first child for the empty state; canvas content children\n(artboards, document body, etc.) are appended either statically or\ndynamically by the host.\n\nBackwards compat — <editor-shell> still recognizes the legacy\n<div data-canvas> shape via :is() selector. New code should prefer\n<editor-canvas>.\n",
+  "description": "Module-tier editor canvas surface — replaces legacy <div data-canvas>\ninside <editor-shell> per ADR-0023. Owns scroll/zoom container\nsemantics, [empty] and [focused] reflected attributes, and a stable\ntarget for the host's content rendering pipeline.\n\nSits as the central content region inside <editor-shell>, between\nthe optional <editor-sidebar slot=\"leading\"> and <editor-sidebar\nslot=\"trailing\">. Authors compose <editor-canvas-empty> as an\noptional first child for the empty state; canvas content children\n(artboards, document body, etc.) are appended either statically or\ndynamically by the host.\n",
   "type": "object",
   "allOf": [
     {

package/editor/editor-canvas/editor-canvas.d.ts

@@ -11,10 +11,6 @@ optional first child for the empty state; canvas content children
 (artboards, document body, etc.) are appended either statically or
 dynamically by the host.
 
-Backwards compat — <editor-shell> still recognizes the legacy
-<div data-canvas> shape via :is() selector. New code should prefer
-<editor-canvas>.
-
  *
  * @see https://ui-kit.exe.xyz/site/components/editor-canvas
  *

package/editor/editor-canvas/editor-canvas.yaml

@@ -18,10 +18,6 @@ description: |
   (artboards, document body, etc.) are appended either statically or
   dynamically by the host.
 
-  Backwards compat — <editor-shell> still recognizes the legacy
-  <div data-canvas> shape via :is() selector. New code should prefer
-  <editor-canvas>.
-
 props:
   empty:
     description: |

package/editor/editor-canvas-empty/editor-canvas-empty.yaml

@@ -39,6 +39,10 @@ a2ui:
       editor-canvas-empty is the bespoke empty-state slot for
       <editor-canvas>. Place as the first child of <editor-canvas>;
       visibility is automatic via the [empty] reflected attribute.
+    - rule: 'CSS-only — no JS module needed in shell HTML imports.'
+      reason: 'CSS-only primitive.'
+    - rule: 'For non-editor canvas empty states (raw <canvas-ui>) use <empty-state-ui> instead; editor-canvas-empty is editor-cluster-namespaced.'
+      reason: 'Cluster vs primitive distinction.'
 
 keywords:
   - editor-canvas-empty

package/editor/editor-shell/editor-shell.a2ui.json

@@ -2,7 +2,7 @@
   "$schema": "https://json-schema.org/draft/2020-12/schema",
   "$id": "https://adiaui.dev/a2ui/v0_9/components/EditorShell.json",
   "title": "EditorShell",
-  "description": "Behavior-only editor shell module for design-tool layouts. Author\nprovides the structural DOM — header (topbar), [data-editor-body] with\npane-ui children ([data-left], [data-right]), [data-canvas] for the\ncentral surface, and a footer (statusbar). editor-shell wires\nselect-ui[data-options] for JSON-parsed option lists.\n",
+  "description": "Behavior-only editor shell for design-tool / code-editor / canvas\nlayouts. Canonical authoring shape uses cluster-namespaced bespoke\nchildren — <editor-toolbar> at the top, <editor-sidebar\nslot=\"leading|trailing\"> rails wrapping <pane-ui resizable>,\n<editor-canvas> as the central work surface (optionally containing\n<editor-canvas-toolbar> + <editor-canvas-empty>), and\n<editor-statusbar> at the bottom. The shell coordinates the family,\npropagates [focus-mode] to children's [full-screen] / [focused],\nand lets each child own its own state-as-attribute semantics per\nADR-0023.\n\nLegacy data-attribute shapes (<header>, <div data-editor-body>,\n<pane-ui data-left|data-right>, <div data-canvas>, <footer>,\n<span data-spacer>) were RETIRED in v0.4.0 per ADR-0024 and are no\nlonger recognized. Consumers must use the bespoke vocabulary.\n",
   "type": "object",
   "allOf": [
     {
@@ -15,6 +15,11 @@
   "properties": {
     "component": {
       "const": "EditorShell"
+    },
+    "focusMode": {
+      "description": "Reflected — when set, the shell enters distraction-free mode and\npropagates a matching [full-screen] / [focused] state to its\nbespoke children (editor-toolbar gains [full-screen], editor-canvas\ngains [focused]). Typically toggled by a [data-toolbar-action]\nbutton inside <editor-toolbar>.\n",
+      "type": "boolean",
+      "default": false
     }
   },
   "required": [
@@ -31,41 +36,47 @@
       "editor-shell",
       "editor",
       "design-tool",
-      "canvas-shell"
+      "code-editor",
+      "canvas-shell",
+      "workspace-shell",
+      "editing-surface"
     ],
     "name": "EditorShell",
     "related": [
+      "EditorToolbar",
+      "EditorCanvas",
+      "EditorCanvasToolbar",
+      "EditorCanvasEmpty",
+      "EditorSidebar",
+      "EditorStatusbar",
       "Pane",
-      "Select",
-      "Toolbar"
+      "AdminShell",
+      "ChatShell"
     ],
     "slots": {
-      "description": {
-        "description": "Secondary metadata inside <header> or <footer> — document name, artboard size, zoom level, etc. Muted color, --a-ui-sm size."
-      },
       "default": {
-        "description": "Author provides header, [data-editor-body] wrapping pane-ui[data-left], [data-canvas], pane-ui[data-right], and an optional footer."
-      },
-      "action": {
-        "description": "Trailing control cluster inside <header> or <footer>. The first [slot=\"action\"] child pushes itself (and siblings) to the end of the bar; subsequent [slot=\"action\"] siblings flow with gap."
-      },
-      "action-leading": {
-        "description": "Leading (inline-start) control cluster inside <header> or <footer>. Pairs with [slot=\"action\"] to produce a dual-cluster bar with space-between alignment (e.g. Back ↔ Cancel/Next, Discard ↔ Publish). Replaces the legacy <span data-spacer> hack."
-      },
-      "heading": {
-        "description": "Primary label inside <header> or <footer>. Rendered with --editor-title-weight + the strong foreground token."
-      },
-      "icon": {
-        "description": "Leading glyph inside <header> or <footer> — status dot, app icon, zoom badge, etc. Muted color, size-aware."
+        "description": "Bespoke children compose here in document order — <editor-toolbar>, <editor-sidebar slot=\"leading\">, <editor-canvas>, <editor-sidebar slot=\"trailing\">, <editor-statusbar>. The shell's grid layout reads child tag selectors to place them; no slot= attribute is needed on the children themselves except for the leading / trailing sidebar discriminator."
       }
     },
     "states": [
       {
-        "description": "Default.",
+        "description": "Default editing mode.",
         "name": "idle"
+      },
+      {
+        "description": "Distraction-free mode active; chrome children dim or hide per their own [full-screen] / [focused] rules.",
+        "attribute": "focus-mode",
+        "name": "focus-mode"
       }
     ],
-    "synonyms": {},
+    "synonyms": {
+      "editor-shell": [
+        "design-tool-shell",
+        "code-editor-shell",
+        "workspace-shell",
+        "canvas-shell"
+      ]
+    },
     "tag": "editor-shell",
     "tokens": {},
     "traits": [],