@adia-ai/web-components 0.0.27 → 0.0.29

package/components/swatch/swatch.js

@@ -0,0 +1,121 @@
+/**
+ * <swatch-ui> — color / style sample primitive.
+ *
+ * A small inline tile representing one visual sample — a chart series's
+ * legend marker, a design-token step in a color or spacing scale, a
+ * theme-preview pill. Replaces docs-only `<span data-swatch>` usage and
+ * the per-shape CSS that used to live inside chart-legend-ui.
+ *
+ * Usage:
+ *   <swatch-ui shape="dot" color="var(--a-data-0)" label="Revenue"></swatch-ui>
+ *   <swatch-ui shape="block" size="lg" color="var(--a-neutral-50)" label="50"></swatch-ui>
+ *   <swatch-ui shape="line" color="#0ea5e9">Forecast</swatch-ui>
+ *
+ * Attributes:
+ *   shape  — block | dot | square | line | dashed (default square)
+ *   size   — sm | md | lg (default md). lg is the 40px-tall token-scale block.
+ *   color  — any CSS color (or var() ref). Sets --swatch-color internally.
+ *   label  — optional text label rendered beside / below the swatch
+ *
+ * Slots:
+ *   default — rich label content; takes precedence over [label] attr
+ *
+ * Stamping is light-DOM with two children:
+ *   <span data-tile></span>     — the colored shape
+ *   <span data-label></span>    — the label text (omitted when no label/slot)
+ */
+
+import { AdiaElement } from '../../core/element.js';
+
+const SHAPES = new Set(['block', 'dot', 'square', 'line', 'dashed']);
+const SIZES = new Set(['sm', 'md', 'lg']);
+
+class AdiaSwatch extends AdiaElement {
+  static properties = {
+    shape: { type: String, default: 'square', reflect: true },
+    size:  { type: String, default: 'md',     reflect: true },
+    color: { type: String, default: '',       reflect: true },
+    label: { type: String, default: '',       reflect: true },
+  };
+
+  static template = () => null;
+
+  #tileEl = null;
+  #labelEl = null;
+  #stamped = false;
+
+  connected() {
+    this.#stamp();
+  }
+
+  render() {
+    this.#stamp();
+    this.#sync();
+  }
+
+  #stamp() {
+    if (this.#stamped) return;
+    // Capture pre-existing default-slot content so consumer-authored
+    // children (e.g. <swatch-ui>Forecast</swatch-ui>) survive stamping.
+    const slotted = Array.from(this.childNodes).filter(n =>
+      !(n.nodeType === 1 && (n.dataset?.tile !== undefined || n.dataset?.label !== undefined))
+    );
+    this.innerHTML = '';
+
+    this.#tileEl = document.createElement('span');
+    this.#tileEl.setAttribute('data-tile', '');
+    this.#tileEl.setAttribute('aria-hidden', 'true');
+    this.appendChild(this.#tileEl);
+
+    this.#labelEl = document.createElement('span');
+    this.#labelEl.setAttribute('data-label', '');
+    if (slotted.length) {
+      for (const n of slotted) this.#labelEl.appendChild(n);
+    }
+    this.appendChild(this.#labelEl);
+
+    this.#stamped = true;
+  }
+
+  #sync() {
+    if (!this.#tileEl || !this.#labelEl) return;
+
+    // Normalize enum values; fall back silently when a consumer sets a typo.
+    const shape = SHAPES.has(this.shape) ? this.shape : 'square';
+    const size  = SIZES.has(this.size)   ? this.size  : 'md';
+    if (shape !== this.shape) this.setAttribute('shape', shape);
+    if (size  !== this.size)  this.setAttribute('size', size);
+
+    // Color: only write the inline custom property when [color] is set
+    // explicitly; otherwise leave whatever the consumer wrote via
+    // style="--swatch-color: …" alone.
+    if (this.color) {
+      this.style.setProperty('--swatch-color', this.color);
+    }
+
+    // Label: prefer slotted content (already in #labelEl from #stamp);
+    // when label-attr is set and the slot is empty, write the attribute.
+    if (!this.#labelEl.firstChild && this.label) {
+      this.#labelEl.textContent = this.label;
+    } else if (this.#labelEl.firstChild?.nodeType === 3 && this.label) {
+      // Pure-text node from a previous label-attr render — keep it
+      // synced to the current attr value.
+      this.#labelEl.textContent = this.label;
+    }
+
+    // Hide the label box when there's no content. Empty-but-stamped span
+    // would otherwise eat the layout gap.
+    const hasLabel = this.#labelEl.textContent.trim().length > 0
+      || (this.#labelEl.firstElementChild != null);
+    this.#labelEl.toggleAttribute('hidden', !hasLabel);
+  }
+
+  disconnected() {
+    this.#tileEl = null;
+    this.#labelEl = null;
+    this.#stamped = false;
+  }
+}
+
+customElements.define('swatch-ui', AdiaSwatch);
+export { AdiaSwatch };

package/components/swatch/swatch.yaml

@@ -0,0 +1,101 @@
+$schema: ../../../../scripts/schemas/component.yaml.schema.json
+name: AdiaSwatch
+tag: swatch-ui
+component: Swatch
+category: display
+version: 1
+description: |
+  Color/style swatch primitive — a small inline tile representing a single
+  visual sample. Renders as block, dot, square, line, or dashed depending on
+  shape; pairs with an optional label slot or attribute. Composed by chart-
+  legend-ui's per-row swatch and consumed directly by the token-colors /
+  spacing demo pages.
+props:
+  shape:
+    description: Visual shape — block (filled tile), dot (small circle), square (small filled square), line (solid hairline), dashed (dashed hairline).
+    type: string
+    default: square
+    reflect: true
+    enum:
+      - block
+      - dot
+      - square
+      - line
+      - dashed
+  size:
+    description: Size preset — sm / md / lg. Drives the swatch's intrinsic dimensions; lg is reserved for the token-scale demo (40 px tall).
+    type: string
+    default: md
+    reflect: true
+    enum:
+      - sm
+      - md
+      - lg
+  color:
+    description: Swatch color. Accepts any CSS color value or var() reference. Sets the internal --swatch-color custom property; consumers can also set --swatch-color via inline style.
+    type: string
+    default: ""
+    reflect: true
+  label:
+    description: Optional label rendered next to (or below, for shape="block") the swatch. Use the default slot for richer content.
+    type: string
+    default: ""
+    reflect: true
+events: {}
+slots:
+  default:
+    description: Optional rich label content. When present, replaces the [label] attribute's text.
+states:
+  - name: idle
+    description: Default, ready for display.
+traits: []
+tokens:
+  --swatch-color:
+    description: Resolved color of the swatch fill / line. Wins over the [color] attr if set inline.
+a2ui:
+  rules: []
+anti_patterns: []
+examples:
+  - name: basic-swatch
+    description: A single dot swatch with text label, e.g. as a chart-legend row.
+    a2ui: >-
+      [
+        {
+          "id": "root",
+          "component": "Swatch",
+          "shape": "dot",
+          "color": "var(--a-data-0)",
+          "label": "Revenue"
+        }
+      ]
+  - name: token-block
+    description: Block swatch for a token-scale step.
+    a2ui: >-
+      [
+        {
+          "id": "root",
+          "component": "Swatch",
+          "shape": "block",
+          "size": "lg",
+          "color": "var(--a-neutral-50)",
+          "label": "50"
+        }
+      ]
+keywords:
+  - swatch
+  - color
+  - chip
+  - sample
+  - palette
+  - legend
+  - step
+  - token
+synonyms:
+  color-chip:
+    - swatch
+    - chip
+  color-sample:
+    - swatch
+related:
+  - chart-legend-ui
+  - tag-ui

package/components/timeline/timeline.css

@@ -347,7 +347,11 @@ agent-reasoning-ui timeline-ui:not([orientation="horizontal"]),
   :scope > [data-timeline-toggle] {
     position: absolute;
     inset-inline-end: 0;
-    top: calc((1.4em - 1em) / 2);
+    /* Place the chevron's icon-center on row 1's optical center.
+       The button has --a-space-0-5 vertical padding, so the icon
+       sits that much lower inside the box; we subtract that so the
+       icon (not the box) lines up with the time-slot text center. */
+    top: calc((1.4em - 1em) / 2 - var(--a-space-0-5));
     background: none;
     border: none;
     padding: var(--a-space-0-5) var(--timeline-item-toggle-px);

package/components/toast/toast.js

@@ -1,39 +1,32 @@
 /**
- * <toast-ui> — Notification popup wired through a shared top-layer
- * messaging channel.
+ * <toast-ui> — Thin facade over `<feed-ui>` / `AdiaFeed.post()`.
  *
- * All toasts — declarative AND imperative — route through one
- * lazily-mounted `[data-toast-container][data-toast-position]` per
- * position. Per-position singletons; consumers can post from anywhere
- * without holding a reference to the toast component:
+ * Phase 4 of `docs/specs/feed-channel.md` (SPEC-FEED-CHANNEL-001) —
+ * toast-ui no longer owns its own per-position container. Both
+ * declarative `<toast-ui>` and imperative `AdiaToast.show()` paths
+ * route through `AdiaFeed`. The element exists for back-compat:
+ * authoring `<toast-ui text="…">` still produces a feed item.
  *
- *     // Imperative API
+ *     // Imperative API (delegates to AdiaFeed.post)
  *     AdiaToast.show({ text: 'Saved!', variant: 'success' });
  *
- *     // Global event channel — same shape, dispatched on `window`.
- *     // Any code (other components, integration scripts) can post
- *     // without importing AdiaToast.
+ *     // Global event channel — same shape, same delegation.
  *     window.dispatchEvent(new CustomEvent('toast', {
  *       detail: { text: 'Saved!', variant: 'success' }
  *     }));
  *
- *     // Declarative — auto-routes to the per-position container on
- *     // connect. No need to author <toast-ui> inside the container.
+ *     // Declarative — auto-posts and removes self on connect.
  *     <toast-ui text="Saved!" variant="success"></toast-ui>
  *
- * Events:
- *   close — fired after the toast finishes its exit animation
+ * The legacy `[data-toast-container]` per-position-Map plumbing was
+ * retired in this migration; the lane infrastructure now lives in
+ * `<feed-ui>` (see ../feed/feed.js).
  */
 
 import { AdiaElement, html } from '../../core/element.js';
+import { AdiaFeed } from '../feed/feed.js';
 
 class AdiaToast extends AdiaElement {
-  #timer = null;
-  #removing = false;
-  #closeTimer = null;
-  #openRaf = null;
-  #routed = false;
-
   static properties = {
     text:     { type: String,  default: '', reflect: true },
     variant:  { type: String,  default: 'info', reflect: true },
@@ -41,178 +34,55 @@ class AdiaToast extends AdiaElement {
     position: { type: String,  default: 'bottom-right', reflect: true },
   };
 
-  static parts = {
-    message: '<div slot="message"></div>',
-    close:   '<button-ui slot="close" icon="x" variant="ghost" size="sm" aria-label="Dismiss"></button-ui>',
-  };
-
   static template = () => html``;
 
-  #onPress = (e) => {
-    if (e.target.closest('[slot="close"]')) this.dismiss();
-  };
-
   connected() {
-    this.addEventListener('press', this.#onPress);
-
-    // Route declarative <toast-ui> instances into the shared per-position
-    // container so authored toasts share the same lane as imperatively-
-    // posted ones (no overlap, consistent stacking). Skipped if we're
-    // already inside a container (re-entrant connect after reparent).
-    if (!this.#routed && !this.parentElement?.matches?.('[data-toast-container]')) {
-      this.#routed = true;
-      const container = AdiaToast.#getContainer(this.position || 'bottom-right');
-      if (this.parentElement !== container) container.appendChild(this);
-    }
-  }
-
-  #getDuration() {
-    const raw = getComputedStyle(this).getPropertyValue('--toast-duration').trim();
-    return parseFloat(raw) || 200;
-  }
-
-  render() {
-    const message = this.ensure('message');
-    message.textContent = this.text;
-
-    const close = this.ensure('close');
-    if (close.parentElement !== this) this.appendChild(close);
-
-    this.setAttribute('role', 'status');
-    this.setAttribute('aria-live', 'polite');
-
-    // Schedule auto-open animation
-    if (!this.hasAttribute('data-open') && !this.#removing) {
-      this.#openRaf = requestAnimationFrame(() => {
-        this.#openRaf = null;
-        this.setAttribute('data-open', '');
-      });
-    }
-
-    // Schedule auto-dismiss
-    this.#scheduleAutoDismiss();
-  }
-
-  #scheduleAutoDismiss() {
-    if (this.#timer) clearTimeout(this.#timer);
-    if (this.duration > 0) {
-      this.#timer = setTimeout(() => this.dismiss(), this.duration);
-    }
-  }
-
-  dismiss() {
-    if (this.#removing) return;
-    this.#removing = true;
-    if (this.#timer) { clearTimeout(this.#timer); this.#timer = null; }
-
-    this.removeAttribute('data-open');
-    this.setAttribute('data-closing', '');
-
-    this.#closeTimer = setTimeout(() => {
-      this.#closeTimer = null;
-      this.removeAttribute('data-closing');
-      const container = this.parentElement;
-      this.dispatchEvent(new Event('close', { bubbles: true }));
-      this.remove();
-      /* If the lane is now empty, hide its popover and remove the
-         container — keeps document.body free of leaked containers. */
-      if (container?.matches?.('[data-toast-container]')) {
-        AdiaToast.#releaseContainerIfEmpty(container);
-      }
-    }, this.#getDuration());
-  }
-
-  disconnected() {
-    this.removeEventListener('press', this.#onPress);
-    if (this.#timer) { clearTimeout(this.#timer); this.#timer = null; }
-    if (this.#closeTimer) { clearTimeout(this.#closeTimer); this.#closeTimer = null; }
-    if (this.#openRaf != null) { cancelAnimationFrame(this.#openRaf); this.#openRaf = null; }
+    /* Declarative path: post into AdiaFeed and remove self. The
+       element is fire-and-forget — its only job is to forward the
+       authored attributes to the feed, then dissolve. Re-entrant
+       guard keeps this safe under HMR / dev-mode re-attachment. */
+    if (this.__routedToFeed) return;
+    this.__routedToFeed = true;
+    AdiaFeed.post({
+      text:     this.text,
+      variant:  this.variant === 'error' ? 'danger' : this.variant,
+      duration: this.duration,
+      position: this.position,
+    });
+    /* Schedule removal so the calling code can read the attributes
+       if it inspected this element on the same microtask. */
+    queueMicrotask(() => { try { this.remove(); } catch { /* noop */ } });
   }
 
   /**
-   * Static convenience — creates a toast, appends to body, auto-removes.
+   * Static facade — delegates to AdiaFeed.post(). Kept for back-compat
+   * with consumer code shaped like `customElements.get('toast-ui').show(...)`
+   * or `AdiaToast.show(...)`. New code should call AdiaFeed.post()
+   * directly.
+   *
    * @param {Object} opts
    * @param {string} opts.text
-   * @param {string} [opts.variant='info']
+   * @param {string} [opts.variant='info']  — `error` aliases to `danger`.
    * @param {number} [opts.duration=4000]
    * @param {string} [opts.position='bottom-right']
-   * @returns {AdiaToast}
-   */
-  static #containers = new Map();
-
-  /**
-   * Get (or lazily create) the per-position lane. Each lane is a manual
-   * Popover-API container — `[popover="manual"]` puts it in the browser's
-   * top-layer, above ALL page content with no z-index wars, and the
-   * native popover stack lets multiple lanes coexist (e.g. one toast in
-   * top-right + another in bottom-center) without collision.
-   *
-   * `popover="manual"` (not `auto`) — toasts must NOT light-dismiss on
-   * outside click; they auto-fade by their own duration timer.
-   *
-   * Falls back gracefully if the Popover API is unsupported (Safari < 17 /
-   * Firefox < 125): the lane still renders as a `position: fixed` div via
-   * the CSS `[data-toast-container]` rules. Browser baseline (Chromium
-   * 125+, Safari 18.0+, Firefox 129+) all support `[popover]`.
+   * @returns {{id:string|null, dismiss:function, update:function}}  FeedHandle.
    */
-  static #getContainer(position) {
-    let el = AdiaToast.#containers.get(position);
-    if (el && el.isConnected) return el;
-    el = document.createElement('div');
-    el.setAttribute('data-toast-container', position);
-    /* `manual` = no light-dismiss; container stays open until we
-       explicitly hidePopover() it when its last toast leaves. */
-    if ('popover' in HTMLElement.prototype) {
-      el.setAttribute('popover', 'manual');
-    }
-    document.body.appendChild(el);
-    /* Show the popover so the lane lifts into the top-layer. Wrapped in
-       try/catch because some test rigs (happy-dom) don't ship the API. */
-    try { el.showPopover?.(); } catch { /* graceful fallback to fixed */ }
-    AdiaToast.#containers.set(position, el);
-    return el;
+  static show(opts = {}) {
+    const { text, variant = 'info', duration = 4000, position = 'bottom-right' } = opts;
+    return AdiaFeed.post({
+      text,
+      variant: variant === 'error' ? 'danger' : variant,
+      duration,
+      position,
+    });
   }
-
-  /**
-   * Tear down the per-position lane when its last toast has been
-   * dismissed. Keeps `document.body` clean — addresses the audit's L-B4
-   * "container leak" finding (toasts permanently leaving DIVs in body).
-   */
-  static #releaseContainerIfEmpty(container) {
-    if (!container) return;
-    if (container.children.length > 0) return;
-    try { container.hidePopover?.(); } catch { /* noop */ }
-    container.remove();
-    /* Clear from the singleton map so the next post() rebuilds. */
-    for (const [pos, el] of AdiaToast.#containers) {
-      if (el === container) AdiaToast.#containers.delete(pos);
-    }
-  }
-
-  static show({ text, variant = 'info', duration = 4000, position = 'bottom-right' } = {}) {
-    /* `error` is a documented alias of `danger` (Phase 6 variant table). */
-    if (variant === 'error') variant = 'danger';
-    const container = AdiaToast.#getContainer(position);
-    const toast = document.createElement('toast-ui');
-    toast.text = text;
-    toast.variant = variant;
-    toast.duration = duration;
-    toast.position = position;
-    container.appendChild(toast);
-    return toast;
-  }
-
 }
 
-/* Install the global 'toast' CustomEvent listener once, at module load,
-   so any code can post into the channel without importing AdiaToast
-   directly:
-
-     window.dispatchEvent(new CustomEvent('toast', {
-       detail: { text: 'Saved!', variant: 'success' }
-     }));
-
-   Idempotent — guarded by a window flag so HMR / re-imports are safe. */
+/* Idempotent install of the global 'toast' CustomEvent listener.
+   Same shape as the historical channel — code that posts via
+   `window.dispatchEvent(new CustomEvent('toast', {detail:{…}}))`
+   keeps working. The listener delegates to AdiaToast.show(), which
+   delegates to AdiaFeed.post(). */
 if (typeof window !== 'undefined' && !window.__adiaToastListenerInstalled) {
   window.__adiaToastListenerInstalled = true;
   window.addEventListener('toast', (e) => {

package/components/tooltip/tooltip.css

@@ -140,7 +140,7 @@
   width: var(--tooltip-indicator-size);
   height: var(--tooltip-indicator-size);
   border-radius: 50%;
-  background: var(--tooltip-indicator-color, var(--chart-0));
+  background: var(--tooltip-indicator-color, var(--a-data-0));
   flex-shrink: 0;
 }
 
@@ -148,14 +148,14 @@
   display: inline-block;
   width: calc(var(--tooltip-indicator-size) * 1.6);
   height: 2px;
-  background: var(--tooltip-indicator-color, var(--chart-0));
+  background: var(--tooltip-indicator-color, var(--a-data-0));
   flex-shrink: 0;
 }
 
 .tooltip-popup[data-follows="pointer"][data-indicator="dashed"] [data-indicator] {
   display: inline-block;
   width: calc(var(--tooltip-indicator-size) * 1.6);
-  border-top: 2px dashed var(--tooltip-indicator-color, var(--chart-0));
+  border-top: 2px dashed var(--tooltip-indicator-color, var(--a-data-0));
   flex-shrink: 0;
 }
 

package/core/provider.js

@@ -236,6 +236,7 @@ export class AdiaRouter extends AdiaProvider {
     }
 
     this.innerHTML = html;
+    this.scrollTo(0, 0);
     (this.closest('section') || this.parentElement)?.scrollTo(0, 0);
 
     if (route.title) document.title = route.title;

package/index.css

@@ -7,8 +7,9 @@
  * + typography — via the colors tree) → component styles → global
  * resets.
  *
- * Pattern CSS (adia-chat, adia-editor, app-shell, etc.) is NOT
- * bundled here — each page links its own patterns explicitly.
+ * Composite-element CSS (adia-chat, adia-editor, app-shell, etc.)
+ * lives in the sibling `@adia-ai/web-modules` package as of 0.0.29
+ * (see ADR-0012). Each page links its own cluster CSS explicitly.
  * Opinionated theme overrides live in `./styles/themes.css`; link
  * them separately when you want the 8 named themes.
  *

package/index.js

@@ -2,17 +2,25 @@
  * @adia-ai/web-components — main entry.
  *
  *   import '@adia-ai/web-components';
- *   import { AdiaButton, AdiaAppShell } from '@adia-ai/web-components';
+ *   import { AdiaButton } from '@adia-ai/web-components';
  *
- * Loading this file registers every component + pattern custom
- * element (side effect of each module's `customElements.define(...)`
- * call). Pair with `@adia-ai/web-components/css` (the all-in-one
- * stylesheet) or link tokens/components/resets individually.
+ * Loading this file registers every primitive (side effect of each
+ * module's `customElements.define(...)` call). Pair with
+ * `@adia-ai/web-components/css` (the all-in-one stylesheet) or link
+ * tokens/components/resets individually.
  *
  * If you only want a subset, use the subpath imports:
  *   import '@adia-ai/web-components/components/button';
- *   import { AdiaAppShell } from '@adia-ai/web-components/patterns';
+ *
+ * Composite elements (app-shell, app-nav, adia-chat, adia-editor,
+ * gen-ui, a2ui-root) shipped here as `patterns/` until 0.0.28 — they
+ * now live in `@adia-ai/web-modules` (see ADR-0012).
+ *
+ *   import '@adia-ai/web-modules';            // every cluster
+ *   import '@adia-ai/web-modules/shell';      // app-shell, app-nav*, section-nav*
+ *   import '@adia-ai/web-modules/chat';       // adia-chat
+ *   import '@adia-ai/web-modules/editor';     // adia-editor
+ *   import '@adia-ai/web-modules/runtime';    // gen-ui, a2ui-root
  */
 
 export * from './components/index.js';
-export * from './patterns/index.js';

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@adia-ai/web-components",
-  "version": "0.0.27",
+  "version": "0.0.29",
   "description": "AdiaUI web components — vanilla custom elements. A2UI runtime (renderer, registry, streams, wiring) lives in @adia-ai/a2ui-utils.",
   "type": "module",
   "exports": {
@@ -11,8 +11,6 @@
     "./core/*":       "./core/*.js",
     "./components":   "./components/index.js",
     "./components/*": "./components/*/*.js",
-    "./patterns":     "./patterns/index.js",
-    "./patterns/*":   "./patterns/*/*.js",
     "./styles/*":     "./styles/*",
     "./traits":       "./traits/index.js",
     "./traits/*":     "./traits/*.js",
@@ -23,7 +21,6 @@
     "components/",
     "styles/",
     "traits/",
-    "patterns/",
     "a2ui/",
     "index.js",
     "index.css"
@@ -32,7 +29,6 @@
     "*.css",
     "./index.js",
     "./components/**/*.js",
-    "./patterns/**/*.js",
     "./core/provider.js"
   ],
   "dependencies": {

package/styles/components.css

@@ -50,6 +50,7 @@
 @import "../components/alert/alert.css";
 @import "../components/kbd/kbd.css";
 @import "../components/tag/tag.css";
+@import "../components/swatch/swatch.css";
 @import "../components/col/col.css";
 @import "../components/field/field.css";
 @import "../components/row/row.css";