@adia-ai/web-components 0.6.10 → 0.6.12

package/CHANGELOG.md

@@ -1,5 +1,15 @@
 # Changelog — @adia-ai/web-components
 
+## [0.6.12] — 2026-05-20
+
+### Maintenance
+- **Lockstep version bump + examples-doc cleanup.** Bumped to maintain the 9-package version coherence enforced by `scripts/release/check-lockstep.mjs`. The only file change in this package: `patterns/admin-shell/admin-shell.examples.html` — removed a stale `data-content-root` row from the data-attribute hooks reference table (ADR-0032 retired that legacy hook). No runtime `.js` / `.css` changes. Substantive v0.6.12 work shipped in `@adia-ai/web-modules` — admin-shell legacy CSS bridges retired per ADR-0032 (continuation of ADR-0023 + ADR-0024). See `packages/web-modules/CHANGELOG.md#0612--2026-05-20` for the breaking-change details + migration path.
+
+## [0.6.11] — 2026-05-20
+
+### Fixed
+- **`<canvas-ui>` — `.d.ts` hand-authored with full runtime API (claims-ui-v2 inbound FB-02 finding 2, P2).** Pre-fix: `canvas.d.ts` was 27-line codegen output declaring only `theme: string` + the `canvas-interaction` event listener — all 8 imperative runtime methods (`process`, `processAll`, `reset`, `pushVersion`, `back`, `forward`, `historyLength`, `historyIndex`) plus `getHTML()` were absent, forcing TS consumers to write `(canvas as any).processAll(...)`. The yaml/a2ui.json sidecar can only express declarative props per ADR-0027; codegen correctly skips imperative methods, but no compensating hand-authored layer existed. **Fix**: replaced `canvas.d.ts` with 63-line hand-authored declaration covering the full public API surface (each method documented with JSDoc matching the JS contract). Added `'canvas'` to the `HAND_AUTHORED_DTS` skip-set in `scripts/build/dts-codegen.mjs` with referencing comment so the next codegen run preserves the hand-authored file. Consumers post-upgrade can drop `(canvas as any).processAll(...)` casts entirely. Closes claims-ui-v2 inbound FEEDBACK-02 finding 2.
+
 ## [0.6.10] — 2026-05-21
 
 ### Added

package/components/canvas/canvas.d.ts

@@ -3,11 +3,16 @@
  *
  * @see https://ui-kit.exe.xyz/site/components/canvas
  *
- * 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.
+ * Hand-authored .d.ts (not codegen output). The yaml/a2ui.json sidecars
+ * describe declarative component props; canvas-ui's primary public API is
+ * a set of imperative runtime methods (`process`, `processAll`, `reset`,
+ * `pushVersion`, `back`, `forward`) which cannot be expressed in the yaml
+ * shape. Per ADR-0027, dts-codegen skips imperative methods — this file
+ * carries them by hand so TypeScript consumers don't need `(canvas as any)`
+ * casts. Keep this file in sync with `canvas.js` whenever the public API
+ * surface changes.
+ *
+ * Closes FB-02 finding 2 (claims-ui-v2 2026-05-20 cold-start).
  */
 
 import { UIElement } from '../../core/element.js';
@@ -18,6 +23,36 @@ export class UICanvas extends UIElement {
   /** Component property: theme. */
   theme: string;
 
+  /** Process a single A2UI message and apply it to the current surface. */
+  process(message: unknown): void;
+
+  /** Process an array of A2UI messages in order. */
+  processAll(messages: unknown[]): void;
+
+  /** Clear the canvas surface — discards all components. */
+  reset(): void;
+
+  /** Return the formatted innerHTML of the internal `<a2ui-root>`. */
+  getHTML(): string;
+
+  /**
+   * Save the given messages to the history stack (enables back/forward
+   * navigation). Truncates forward history if not at the newest version.
+   */
+  pushVersion(messages: unknown[]): void;
+
+  /** Navigate to the previous history version. Returns false if at oldest. */
+  back(): boolean;
+
+  /** Navigate to the next history version. Returns false if at newest. */
+  forward(): boolean;
+
+  /** Number of saved versions in the history stack. */
+  readonly historyLength: number;
+
+  /** Current position in the history stack (0-based). */
+  readonly historyIndex: number;
+
   addEventListener<K extends keyof HTMLElementEventMap>(
     type: K,
     listener: (this: UICanvas, ev: HTMLElementEventMap[K]) => unknown,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@adia-ai/web-components",
-  "version": "0.6.10",
+  "version": "0.6.12",
   "description": "AdiaUI web components \u2014 vanilla custom elements. A2UI runtime (renderer, registry, streams, wiring) lives in @adia-ai/a2ui-runtime.",
   "type": "module",
   "types": "./index.d.ts",