@adia-ai/web-components 0.6.43 → 0.6.44

package/CHANGELOG.md

@@ -1,5 +1,15 @@
 # Changelog — @adia-ai/web-components
 
+## [0.6.44] — 2026-05-28
+
+### Fixed — `<canvas-ui>` no longer hard-requires `@adia-ai/web-modules` at build time (FEEDBACK-81)
+
+- **`components/canvas/canvas.js`** — the A2UI renderer `<a2ui-root>` (which lives in `@adia-ai/web-modules`) was a top-level *static* import. Because `@adia-ai/web-components` declares no dependency on `@adia-ai/web-modules`, the default barrel `import '@adia-ai/web-components'` (which registers `<canvas-ui>`) failed to build for primitives-only consumers who omitted `web-modules` — a hard Vite/rolldown `UNRESOLVED_IMPORT … web-modules/runtime/a2ui-root`. The import is now lazy + guarded: `#ensureRenderer()` runs a `/* @vite-ignore */` dynamic import on `connected()`, and a missing `web-modules` degrades to a one-time console warning instead of breaking the build. Consumers that have `web-modules` keep the prior synchronous render path (fast-path when `<a2ui-root>` is already defined); `process` / `processAll` / `reset` / version-restore buffer until the renderer is ready, preserving call order. The primitives barrel is now self-contained.
+
+### Maintenance
+
+- **`dist/web-components.min.js` + `dist/icons-manifest.js`** — bundle rebuild reflecting the `components/canvas/canvas.js` decouple above.
+
 ## [0.6.43] — 2026-05-27
 
 ### Added — `<list-ui>` `[contained]` prop declared in yaml

package/components/canvas/canvas.js

@@ -1,5 +1,9 @@
 import { UIElement } from '../../core/element.js';
-import '../../../web-modules/runtime/a2ui-root/a2ui-root.js';
+// NOTE: the A2UI renderer (<a2ui-root>) lives in @adia-ai/web-modules and is
+// loaded lazily + guarded inside #ensureRenderer() (kicked off from connected()).
+// It is deliberately NOT a static import: @adia-ai/web-components declares no
+// dependency on @adia-ai/web-modules, so a static cross-package import hard-fails
+// the build for primitives-only consumers who never use <canvas-ui> (FEEDBACK-81).
 
 /**
  * <canvas-ui> — A2UI rendering surface.
@@ -25,6 +29,10 @@ export class UICanvas extends UIElement {
   #historyIndex = -1;
   static MAX_HISTORY = 10;
 
+  // FB-81: lazy/guarded <a2ui-root> loader state.
+  #rendererReady = null;                 // Promise<boolean> | null
+  static #warnedMissingRenderer = false;
+
   #onKeydown = (e) => {
     if (e.target.closest('input, textarea, [contenteditable]')) return;
     if (!this.contains(document.activeElement) && document.activeElement !== document.body) return;
@@ -66,6 +74,8 @@ export class UICanvas extends UIElement {
     this.addEventListener('input', this.#onInput);
     // Forward a2ui-retry from wired error cards so consumers can retry generation
     this.addEventListener('a2ui-retry', this.#onRetry);
+    // Kick off the lazy renderer load now that a canvas is in the DOM.
+    this.#ensureRenderer();
   }
 
   disconnected() {
@@ -79,6 +89,53 @@ export class UICanvas extends UIElement {
     this.#bound = false;
   }
 
+  /**
+   * Lazily load the A2UI renderer (<a2ui-root>) from @adia-ai/web-modules.
+   * Resolves true once the element is defined, false if web-modules is not
+   * installed (primitives-only consumers). Idempotent — the import runs once.
+   * Guarded so a missing sibling package degrades to a one-time warning
+   * instead of a hard build/runtime failure (FEEDBACK-81).
+   */
+  #ensureRenderer() {
+    if (this.#rendererReady) return this.#rendererReady;
+    if (customElements.get('a2ui-root')) {
+      this.#rendererReady = Promise.resolve(true);
+      return this.#rendererReady;
+    }
+    this.#rendererReady = import(/* @vite-ignore */ '../../../web-modules/runtime/a2ui-root/a2ui-root.js')
+      .then(() => customElements.whenDefined('a2ui-root'))
+      .then(() => true)
+      .catch((err) => {
+        if (!UICanvas.#warnedMissingRenderer) {
+          UICanvas.#warnedMissingRenderer = true;
+          console.warn(
+            '[canvas-ui] A2UI renderer <a2ui-root> could not be loaded — install ' +
+            '@adia-ai/web-modules to render generated UI in <canvas-ui>. Apps that ' +
+            'use only primitives (and never <canvas-ui>) can ignore this.',
+            err,
+          );
+        }
+        return false;
+      });
+    return this.#rendererReady;
+  }
+
+  /**
+   * Run `fn(rootEl)` against the <a2ui-root> once it is available. Synchronous
+   * fast-path when the renderer is already upgraded (preserves prior timing for
+   * consumers that have @adia-ai/web-modules); otherwise defers until the lazy
+   * import resolves, preserving call order. No-op when web-modules is absent.
+   */
+  #whenRoot(fn) {
+    if (this.#rootEl && typeof this.#rootEl.process === 'function') {
+      fn(this.#rootEl);
+      return;
+    }
+    this.#ensureRenderer().then((ok) => {
+      if (ok && this.#rootEl && typeof this.#rootEl.process === 'function') fn(this.#rootEl);
+    });
+  }
+
   render() {
     if (this.#bound) return;
     this.#bound = true;
@@ -104,18 +161,19 @@ export class UICanvas extends UIElement {
 
   /** Process a single A2UI message. */
   process(message) {
-    this.#rootEl?.process(message);
+    this.#whenRoot((root) => root.process(message));
   }
 
   /** Process an array of A2UI messages. */
   processAll(messages) {
-    if (!this.#rootEl) return;
-    for (const msg of messages) this.#rootEl.process(msg);
+    this.#whenRoot((root) => {
+      for (const msg of messages) root.process(msg);
+    });
   }
 
   /** Reset the canvas. */
   reset() {
-    this.#rootEl?.reset();
+    this.#whenRoot((root) => root.reset());
   }
 
   /** Return formatted innerHTML of the a2ui-root. */
@@ -155,10 +213,12 @@ export class UICanvas extends UIElement {
 
   #restoreVersion() {
     const messages = this.#history[this.#historyIndex];
-    this.#rootEl?.reset();
-    if (messages) {
-      for (const msg of messages) this.#rootEl?.process(msg);
-    }
+    this.#whenRoot((root) => {
+      root.reset();
+      if (messages) {
+        for (const msg of messages) root.process(msg);
+      }
+    });
   }
 
   // ── Private ──