@maxhealth.tech/prefab 0.3.18 → 0.3.19

package/CHANGELOG.md

@@ -6,6 +6,26 @@ All notable changes to this project will be documented in this file.
 
 <!-- Add new entries directly below. Keep this line: it makes a release merge conflict rather than file them under a published version. -->
 
+## [0.3.19] — 2026-11-01
+
+### Fixed
+
+- **`registerViewerResource` allows every origin the viewer loads from.** Script origins went into the CSP `resourceDomains`, but `stylesheets` and a custom `cdnBase` did not, so a host enforcing the CSP blocked the extra stylesheets and, with `cdnBase`, the renderer itself.
+- **`Subscribe`'s `onError` runs when the host refuses the push subscription.** A rejected or timed-out `resources/subscribe` was dropped as an unhandled rejection and the view waited forever. `onError` now runs and the same `Subscribe` can be dispatched again. `McpTransport.subscribe` and `Bridge.subscribe` take an optional `onError` for this.
+- **`popState` resolves a template `index`** the way `setState` resolves its `value`, so `pop(items, '{{ $index }}')` inside a `ForEach` removes that row instead of nothing.
+- **`humanizeKey` gives camelCase keys the same sentence-case label as snake_case**: `firstName` is now `First name` (was `First Name`), and acronyms stay whole (`userID` is `User ID`, was `User I D`). Elicitation schema titles from `formSchema` used a separate Title Case copy and now share it, so they match the `autoForm` labels.
+- **The `date`, `time` and `datetime` pipes leave a value that is not a date unchanged** instead of rendering `Invalid Date`.
+- **A `DataTable` with `rowKey` and `selected` renders `null` rows** instead of throwing.
+- **The bridge ignores foreign `postMessage` traffic without a `type`** (strings, browser-extension messages) instead of throwing in its message listener.
+- **Host themes keep only values the renderer can apply**: an unknown `theme` color scheme and non-string CSS variables are dropped, and `availableDisplayModes` is filtered to known modes.
+- **`PdfViewer` reads `page`, `height` and numeric `zoom` given as numeric strings**, and falls back to its defaults for anything else instead of writing an invalid height.
+- **Docs that promised more than the code does**: `PdfViewer` has no text layer and no zoom control in its toolbar, and `signal(..., { urlSync })` is stored for app code but not synced to the address bar by the renderer.
+
+### Internal
+
+- Renderer components, the bridge handshake, `validateWireFormat` and the pipe implementations narrow wire values with `src/core/guards.ts` instead of `as` casts.
+- Long explanatory comments across `src/mcp`, `src/a2ui`, `src/core` and `src/rx` are cut to one or two lines.
+
 ## [0.3.18] — 2026-10-29
 
 ### Fixed

package/dist/a2ui/browser.js

@@ -52,7 +52,6 @@ const PrefabA2UI = {
 export default PrefabA2UI;
 export { emit, envelope };
 if (typeof window !== 'undefined') {
-    ;
-    window.PrefabA2UI = PrefabA2UI;
+    Object.assign(window, { PrefabA2UI });
 }
 //# sourceMappingURL=browser.js.map

package/dist/a2ui/browser.js.map

@@ -1 +1 @@
-{"version":3,"file":"browser.js","sourceRoot":"","sources":["../../src/a2ui/browser.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;GAkBG;AAEH,OAAO,EAAE,QAAQ,EAA6C,MAAM,WAAW,CAAA;AAC/E,OAAO,EAAE,WAAW,EAAE,MAAM,cAAc,CAAA;AAC1C,OAAO,EAAE,OAAO,EAAE,MAAM,oBAAoB,CAAA;AAE5C,OAAO,EACL,kBAAkB,EAClB,SAAS,EACT,WAAW,EACX,YAAY,GAGb,MAAM,YAAY,CAAA;AAEnB;;;;;;GAMG;AACH,SAAS,IAAI,CAAC,IAAa,EAAE,OAAyB;IACpD,IAAI,IAAI,IAAI,IAAI,IAAI,OAAO,IAAI,KAAK,QAAQ,IAAI,CAAC,CAAC,MAAM,IAAI,IAAI,CAAC,EAAE,CAAC;QAClE,MAAM,IAAI,SAAS,CAAC,2DAA2D,CAAC,CAAA;IAClF,CAAC;IACD,OAAO,QAAQ,CAAC,IAAwB,EAAE,OAAO,CAAC,CAAA;AACpD,CAAC;AAED,gFAAgF;AAChF,SAAS,QAAQ,CAAC,QAAuB;IACvC,OAAO,EAAE,QAAQ,EAAE,CAAA;AACrB,CAAC;AAED,MAAM,UAAU,GAAG;IACjB,IAAI;IACJ,QAAQ;IACR,mEAAmE;IACnE,WAAW;IACX,OAAO;IACP,YAAY;IACZ,kBAAkB;IAClB,SAAS;IACT,WAAW;CACZ,CAAA;AAED,eAAe,UAAU,CAAA;AACzB,OAAO,EAAE,IAAI,EAAE,QAAQ,EAAE,CAAA;AAEzB,IAAI,OAAO,MAAM,KAAK,WAAW,EAAE,CAAC;IAClC,CAAC;IAAC,MAA6C,CAAC,UAAU,GAAG,UAAU,CAAA;AACzE,CAAC"}
+{"version":3,"file":"browser.js","sourceRoot":"","sources":["../../src/a2ui/browser.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;GAkBG;AAEH,OAAO,EAAE,QAAQ,EAA6C,MAAM,WAAW,CAAA;AAC/E,OAAO,EAAE,WAAW,EAAE,MAAM,cAAc,CAAA;AAC1C,OAAO,EAAE,OAAO,EAAE,MAAM,oBAAoB,CAAA;AAE5C,OAAO,EACL,kBAAkB,EAClB,SAAS,EACT,WAAW,EACX,YAAY,GAGb,MAAM,YAAY,CAAA;AAEnB;;;;;;GAMG;AACH,SAAS,IAAI,CAAC,IAAa,EAAE,OAAyB;IACpD,IAAI,IAAI,IAAI,IAAI,IAAI,OAAO,IAAI,KAAK,QAAQ,IAAI,CAAC,CAAC,MAAM,IAAI,IAAI,CAAC,EAAE,CAAC;QAClE,MAAM,IAAI,SAAS,CAAC,2DAA2D,CAAC,CAAA;IAClF,CAAC;IACD,OAAO,QAAQ,CAAC,IAAwB,EAAE,OAAO,CAAC,CAAA;AACpD,CAAC;AAED,gFAAgF;AAChF,SAAS,QAAQ,CAAC,QAAuB;IACvC,OAAO,EAAE,QAAQ,EAAE,CAAA;AACrB,CAAC;AAED,MAAM,UAAU,GAAG;IACjB,IAAI;IACJ,QAAQ;IACR,mEAAmE;IACnE,WAAW;IACX,OAAO;IACP,YAAY;IACZ,kBAAkB;IAClB,SAAS;IACT,WAAW;CACZ,CAAA;AAED,eAAe,UAAU,CAAA;AACzB,OAAO,EAAE,IAAI,EAAE,QAAQ,EAAE,CAAA;AAEzB,IAAI,OAAO,MAAM,KAAK,WAAW,EAAE,CAAC;IAClC,MAAM,CAAC,MAAM,CAAC,MAAM,EAAE,EAAE,UAAU,EAAE,CAAC,CAAA;AACvC,CAAC"}

package/dist/a2ui/expr.d.ts

@@ -1,44 +1,11 @@
 /**
- * `{{ }}` template → A2UI data binding.
- *
- * `$prefab` interpolates arbitrary expressions client-side. A2UI binds values
- * through JSON Pointers and, for text that mixes literals with values, through
- * the `formatString` catalog function. Between them those cover more than a
- * plain-path conversion would suggest:
- *
- *   - `{{ user.name }}`        → `{ path: '/user/name' }`
- *   - `Hi {{ name }}!`         → `{ call: 'formatString', args: { value: 'Hi ${/name}!' } }`
- *   - `{{ p | currency:'EUR' }}` → `{ call: 'formatCurrency', args: { … } }`
- *   - `{{ count + 1 }}`        → nothing; A2UI has no expression language
- *
- * What does not survive is arithmetic, conditionals, and the pipes that
- * transform data rather than format it (see `./pipes.ts`). Those are reported as
- * `expression` diagnostics rather than emitted as a binding that would render an
- * empty string in someone's renderer.
- *
- * ## Scopes
- *
- * A binding is resolved against a {@link BindScope}, which is how names local to
- * a region become pointers. Inside a list template A2UI resolves relative paths
- * against the current item, so prefab's `$item` maps to the empty prefix; inside
- * an inlined definition, a `Use`'s overrides map to wherever the emitter seeded
- * them. Without this, a name that means something local would silently bind to
- * the root of the data model and read whatever happened to be there.
+ * `{{ }}` templates as A2UI values: `{{ user.name }}` → `{ path: '/user/name' }`, `Hi {{ name }}!` → `formatString`,
+ * `{{ p | currency }}` → `formatCurrency`. Arithmetic, conditionals and data pipes (also inside mixed text) are unbindable.
  */
 import type { A2uiDataBinding, A2uiDynamicString, A2uiFunctionCall } from './types.js';
-/**
- * Names local to a region, mapped to the pointer they resolve to.
- *
- * An empty-string value means "relative to the current template item", which is
- * how A2UI addresses fields inside a list template.
- */
+/** Names local to a region (`$item`, a `Use`'s overrides) mapped to their pointer; `''` means relative to the current list item. */
 export type BindScope = Record<string, string>;
-/**
- * Escape one JSON Pointer reference token (RFC 6901 §3).
- *
- * `~` must be escaped before `/`, otherwise the `~1` produced for a slash gets
- * re-escaped into `~01` on the second pass.
- */
+/** Escape one JSON Pointer token (RFC 6901): `~` before `/`, or the `~1` for a slash becomes `~01`. */
 export declare function escapePointerToken(token: string): string;
 /** Build a JSON Pointer from already-split path segments. */
 export declare function toJsonPointer(segments: string[]): string;
@@ -54,11 +21,7 @@ export type BindingResult =
     kind: 'binding';
     value: A2uiDataBinding;
 }
-/**
- * A value produced by a catalog function: interpolated text, or a pipe that
- * maps onto one of A2UI's formatters. `note` carries anything the mapping
- * cost, for the caller to report.
- */
+/** Interpolated text or a formatting pipe as a catalog function; `note` is what the mapping cost. */
  | {
     kind: 'format';
     value: A2uiFunctionCall;
@@ -74,18 +37,8 @@ export type BindingResult =
     kind: 'unbindable';
     expression: string;
 };
-/**
- * Convert a prefab string value into an A2UI dynamic value.
- *
- * A whole-string template over a plain path becomes a binding, one over a
- * formatting pipe becomes a catalog-function call, mixed text becomes a
- * `formatString` call, a string with no template passes through, and anything
- * else is unbindable.
- */
+/** A prefab string as an A2UI dynamic value: binding, catalog-function call, `formatString`, literal, or unbindable. */
 export declare function toBinding(value: string, scope?: BindScope): BindingResult;
-/**
- * Resolve a value to an `A2uiDynamicString`, or `undefined` when it cannot be
- * expressed. Callers pair this with a diagnostic when it returns `undefined`.
- */
+/** A value as an `A2uiDynamicString`, or `undefined` (which callers report as a diagnostic). */
 export declare function dynamicString(value: string | undefined, scope?: BindScope): A2uiDynamicString | undefined;
 //# sourceMappingURL=expr.d.ts.map

package/dist/a2ui/expr.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"expr.d.ts","sourceRoot":"","sources":["../../src/a2ui/expr.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;GA0BG;AAGH,OAAO,KAAK,EAAE,eAAe,EAAE,iBAAiB,EAAoB,gBAAgB,EAAE,MAAM,YAAY,CAAA;AAgBxG;;;;;GAKG;AACH,MAAM,MAAM,SAAS,GAAG,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;AAK9C;;;;;GAKG;AACH,wBAAgB,kBAAkB,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAExD;AAED,6DAA6D;AAC7D,wBAAgB,aAAa,CAAC,QAAQ,EAAE,MAAM,EAAE,GAAG,MAAM,CAExD;AA0CD,6EAA6E;AAC7E,MAAM,MAAM,aAAa;AACvB,wCAAwC;AACtC;IAAE,IAAI,EAAE,SAAS,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAE;AACpC,8DAA8D;GAC5D;IAAE,IAAI,EAAE,SAAS,CAAC;IAAC,KAAK,EAAE,eAAe,CAAA;CAAE;AAC7C;;;;GAIG;GACD;IAAE,IAAI,EAAE,QAAQ,CAAC;IAAC,KAAK,EAAE,gBAAgB,CAAC;IAAC,IAAI,CAAC,EAAE,MAAM,CAAA;CAAE;AAC5D,+DAA+D;GAC7D;IAAE,IAAI,EAAE,OAAO,CAAC;IAAC,KAAK,EAAE,gBAAgB,CAAA;CAAE;AAC5C,iFAAiF;GAC/E;IAAE,IAAI,EAAE,YAAY,CAAC;IAAC,UAAU,EAAE,MAAM,CAAA;CAAE,CAAA;AA8D9C;;;;;;;GAOG;AACH,wBAAgB,SAAS,CAAC,KAAK,EAAE,MAAM,EAAE,KAAK,GAAE,SAAc,GAAG,aAAa,CAgC7E;AAED;;;GAGG;AACH,wBAAgB,aAAa,CAAC,KAAK,EAAE,MAAM,GAAG,SAAS,EAAE,KAAK,GAAE,SAAc,GAAG,iBAAiB,GAAG,SAAS,CAU7G"}
+{"version":3,"file":"expr.d.ts","sourceRoot":"","sources":["../../src/a2ui/expr.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAGH,OAAO,KAAK,EAAE,eAAe,EAAE,iBAAiB,EAAoB,gBAAgB,EAAE,MAAM,YAAY,CAAA;AAWxG,oIAAoI;AACpI,MAAM,MAAM,SAAS,GAAG,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;AAK9C,uGAAuG;AACvG,wBAAgB,kBAAkB,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAExD;AAED,6DAA6D;AAC7D,wBAAgB,aAAa,CAAC,QAAQ,EAAE,MAAM,EAAE,GAAG,MAAM,CAExD;AA4BD,6EAA6E;AAC7E,MAAM,MAAM,aAAa;AACvB,wCAAwC;AACtC;IAAE,IAAI,EAAE,SAAS,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAE;AACpC,8DAA8D;GAC5D;IAAE,IAAI,EAAE,SAAS,CAAC;IAAC,KAAK,EAAE,eAAe,CAAA;CAAE;AAC7C,qGAAqG;GACnG;IAAE,IAAI,EAAE,QAAQ,CAAC;IAAC,KAAK,EAAE,gBAAgB,CAAC;IAAC,IAAI,CAAC,EAAE,MAAM,CAAA;CAAE;AAC5D,+DAA+D;GAC7D;IAAE,IAAI,EAAE,OAAO,CAAC;IAAC,KAAK,EAAE,gBAAgB,CAAA;CAAE;AAC5C,iFAAiF;GAC/E;IAAE,IAAI,EAAE,YAAY,CAAC;IAAC,UAAU,EAAE,MAAM,CAAA;CAAE,CAAA;AA+C9C,wHAAwH;AACxH,wBAAgB,SAAS,CAAC,KAAK,EAAE,MAAM,EAAE,KAAK,GAAE,SAAc,GAAG,aAAa,CA2B7E;AAED,gGAAgG;AAChG,wBAAgB,aAAa,CAAC,KAAK,EAAE,MAAM,GAAG,SAAS,EAAE,KAAK,GAAE,SAAc,GAAG,iBAAiB,GAAG,SAAS,CAU7G"}

package/dist/a2ui/expr.js

@@ -1,50 +1,17 @@
 /**
- * `{{ }}` template → A2UI data binding.
- *
- * `$prefab` interpolates arbitrary expressions client-side. A2UI binds values
- * through JSON Pointers and, for text that mixes literals with values, through
- * the `formatString` catalog function. Between them those cover more than a
- * plain-path conversion would suggest:
- *
- *   - `{{ user.name }}`        → `{ path: '/user/name' }`
- *   - `Hi {{ name }}!`         → `{ call: 'formatString', args: { value: 'Hi ${/name}!' } }`
- *   - `{{ p | currency:'EUR' }}` → `{ call: 'formatCurrency', args: { … } }`
- *   - `{{ count + 1 }}`        → nothing; A2UI has no expression language
- *
- * What does not survive is arithmetic, conditionals, and the pipes that
- * transform data rather than format it (see `./pipes.ts`). Those are reported as
- * `expression` diagnostics rather than emitted as a binding that would render an
- * empty string in someone's renderer.
- *
- * ## Scopes
- *
- * A binding is resolved against a {@link BindScope}, which is how names local to
- * a region become pointers. Inside a list template A2UI resolves relative paths
- * against the current item, so prefab's `$item` maps to the empty prefix; inside
- * an inlined definition, a `Use`'s overrides map to wherever the emitter seeded
- * them. Without this, a name that means something local would silently bind to
- * the root of the data model and read whatever happened to be there.
+ * `{{ }}` templates as A2UI values: `{{ user.name }}` → `{ path: '/user/name' }`, `Hi {{ name }}!` → `formatString`,
+ * `{{ p | currency }}` → `formatCurrency`. Arithmetic, conditionals and data pipes (also inside mixed text) are unbindable.
  */
 import { parsePipe, pipeCall } from './pipes.js';
 /** Matches a string that is exactly one `{{ … }}` template and nothing else. */
 const SOLE_TEMPLATE = /^\s*\{\{\s*(.+?)\s*\}\}\s*$/s;
 /** Matches every `{{ … }}` occurrence, for interpolating mixed text. */
 const EVERY_TEMPLATE = /\{\{\s*(.+?)\s*\}\}/g;
-/**
- * A plain member path: `user.name`, `items.0.label`, `count`, `$item.title`.
- *
- * Deliberately narrow. Anything outside this shape (operators, pipes, calls,
- * ternaries, string literals) has no A2UI equivalent.
- */
+/** A plain member path (`user.name`, `items.0.label`, `$item.title`); anything richer has no A2UI equivalent. */
 const PLAIN_PATH = /^\$?[A-Za-z_][\w$]*(?:\.(?:[A-Za-z_$][\w$]*|\d+))*$/;
 /** prefab's loop index. A2UI exposes the same thing as a system function. */
 const LOOP_INDEX = '$index';
-/**
- * Escape one JSON Pointer reference token (RFC 6901 §3).
- *
- * `~` must be escaped before `/`, otherwise the `~1` produced for a slash gets
- * re-escaped into `~01` on the second pass.
- */
+/** Escape one JSON Pointer token (RFC 6901): `~` before `/`, or the `~1` for a slash becomes `~01`. */
 export function escapePointerToken(token) {
     return token.replace(/~/g, '~0').replace(/\//g, '~1');
 }
@@ -52,58 +19,34 @@ export function escapePointerToken(token) {
 export function toJsonPointer(segments) {
     return '/' + segments.map(escapePointerToken).join('/');
 }
-/**
- * prefab state expressions address state keys directly (`count`), but actions
- * and docs also spell the same key as `state.count`. Both mean the root of the
- * data model, so the prefix is stripped before the pointer is built.
- */
+/** `state.count` and `count` both address the data-model root. */
 function stripStatePrefix(path) {
     return path.startsWith('state.') ? path.slice('state.'.length) : path;
 }
-/**
- * Resolve a member path to a JSON Pointer under `scope`.
- *
- * A leading segment named in the scope is replaced by its prefix; everything
- * else resolves from the data-model root.
- */
+/** A member path as a JSON Pointer: a leading scoped name takes its prefix, anything else resolves from the root. */
 function pathToPointer(expr, scope) {
     if (!PLAIN_PATH.test(expr))
         return undefined;
     const segments = stripStatePrefix(expr).split('.');
     const head = segments[0];
-    // `hasOwn` rather than a truthiness check: '' is a meaningful prefix, meaning
-    // "relative to the current template item".
     const prefix = Object.hasOwn(scope, head) ? scope[head] : undefined;
     if (prefix === undefined) {
-        // A `$`-prefixed name is a runtime binding prefab supplies ($event, $error,
-        // $result). Outside a scope that defines it, there is nothing to point at.
+        // $event, $error, $result: runtime-only names with nothing to point at.
         if (head.startsWith('$'))
             return undefined;
         return toJsonPointer(segments);
     }
     const rest = segments.slice(1);
     if (prefix === '') {
-        // Relative to the current template item. `{{ $item }}` alone has no field to
-        // address, so it cannot become a pointer.
         return rest.length === 0 ? undefined : rest.map(escapePointerToken).join('/');
     }
     return rest.length === 0 ? prefix : `${prefix}/${rest.map(escapePointerToken).join('/')}`;
 }
-/**
- * Escape a literal segment for a `formatString` template.
- *
- * `${` is the interpolation opener, so a literal one has to be escaped or the
- * renderer reads the surrounding text as an expression.
- */
+/** Escape a literal `${` so `formatString` does not read it as an interpolation. */
 function escapeFormatLiteral(text) {
     return text.replace(/\$\{/g, '\\${');
 }
-/**
- * Convert mixed literal and template text into a `formatString` call.
- *
- * @returns `undefined` when any embedded expression is richer than a path, in
- *   which case the whole string is unbindable rather than partly interpolated.
- */
+/** Mixed text as a `formatString` call, or `undefined` when any embedded expression is richer than a path. */
 function toFormatString(value, scope) {
     let failed;
     let interpolated = '';
@@ -124,12 +67,7 @@ function toFormatString(value, scope) {
     interpolated += escapeFormatLiteral(value.slice(cursor));
     return { call: 'formatString', args: { value: interpolated } };
 }
-/**
- * Resolve a piped expression to a catalog-function call.
- *
- * The base must itself be a plain path or a literal, since A2UI function
- * arguments take a value rather than an expression to evaluate.
- */
+/** A piped expression as a catalog-function call; its base must be a plain path or a number literal. */
 function toPipeCall(expr, scope) {
     const pipe = parsePipe(expr);
     if (pipe == null)
@@ -145,20 +83,10 @@ function toPipeCall(expr, scope) {
         return undefined;
     return { kind: 'format', value: mapped.call, ...(mapped.note != null && { note: mapped.note }) };
 }
-/**
- * Convert a prefab string value into an A2UI dynamic value.
- *
- * A whole-string template over a plain path becomes a binding, one over a
- * formatting pipe becomes a catalog-function call, mixed text becomes a
- * `formatString` call, a string with no template passes through, and anything
- * else is unbindable.
- */
+/** A prefab string as an A2UI dynamic value: binding, catalog-function call, `formatString`, literal, or unbindable. */
 export function toBinding(value, scope = {}) {
     const sole = SOLE_TEMPLATE.exec(value);
-    // The capture is lazy but still spans `}} … {{`, so `{{ a }} of {{ b }}`
-    // matches as one template whose body is `a }} of {{ b`. Rejecting a capture
-    // that contains delimiters sends those strings down the interpolation path,
-    // which is where they belong.
+    // The lazy capture still spans `{{ a }} of {{ b }}`; such strings belong to the interpolation path.
     const isSole = sole != null && !sole[1].includes('{{') && !sole[1].includes('}}');
     if (isSole) {
         const expr = sole[1].trim();
@@ -168,8 +96,6 @@ export function toBinding(value, scope = {}) {
         const pointer = pathToPointer(expr, scope);
         if (pointer != null)
             return { kind: 'binding', value: { path: pointer } };
-        // A pipe is not part of A2UI's expression language, but the common
-        // formatting ones exist in its catalog as functions.
         const piped = toPipeCall(expr, scope);
         if (piped != null)
             return piped;
@@ -182,10 +108,7 @@ export function toBinding(value, scope = {}) {
         return { kind: 'format', value: format };
     return { kind: 'unbindable', expression: value };
 }
-/**
- * Resolve a value to an `A2uiDynamicString`, or `undefined` when it cannot be
- * expressed. Callers pair this with a diagnostic when it returns `undefined`.
- */
+/** A value as an `A2uiDynamicString`, or `undefined` (which callers report as a diagnostic). */
 export function dynamicString(value, scope = {}) {
     if (value == null)
         return undefined;

package/dist/a2ui/expr.js.map

@@ -1 +1 @@
-{"version":3,"file":"expr.js","sourceRoot":"","sources":["../../src/a2ui/expr.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"expr.js","sourceRoot":"","sources":["../../src/a2ui/expr.ts"],"names":[],"mappings":"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"}

package/dist/a2ui/icons.d.ts

@@ -1,30 +1,8 @@
 /**
- * prefab icon name → A2UI Basic catalog icon.
- *
- * The one place where the two catalogs disagree on *values* rather than on
- * component shape. prefab's `Icon(name)` takes any string, because its renderer
- * resolves Lucide names at runtime and new icons cost nothing. A2UI's
- * `Icon.name` is a closed enum of 59 names, so an unrecognised value does not
- * render as a fallback glyph — it makes the whole component fail validation.
- *
- * Passing the name through unchecked therefore emits an invalid surface for
- * every icon outside those 59, which is most of them. Instead the name is
- * normalised, matched against the enum, and dropped with a diagnostic when
- * nothing fits, so an unmappable icon costs a glyph rather than the payload.
- */
-/**
- * The A2UI Basic catalog's `Icon.name` enum, v1.0.
- *
- * Duplicated as a literal because prefab ships zero runtime dependencies and
- * cannot read the catalog JSON at emit time. `test/a2ui-icons.test.ts` asserts
- * this matches the vendored catalog exactly, so it cannot drift silently.
+ * The A2UI Basic catalog's closed `Icon.name` enum (v1.0); an unknown name fails the whole component's validation.
+ * `test/a2ui-icons.test.ts` keeps this literal equal to the vendored catalog.
  */
 export declare const A2UI_ICONS: readonly string[];
-/**
- * Resolve a prefab icon name to an A2UI one.
- *
- * @returns the catalog name, or `undefined` when nothing in the enum means the
- *   same thing. Callers drop the icon and record a diagnostic.
- */
+/** A prefab icon name as an A2UI one, or `undefined` (callers drop the icon with a diagnostic). */
 export declare function a2uiIconName(name: string): string | undefined;
 //# sourceMappingURL=icons.d.ts.map

package/dist/a2ui/icons.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"icons.d.ts","sourceRoot":"","sources":["../../src/a2ui/icons.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAEH;;;;;;GAMG;AACH,eAAO,MAAM,UAAU,EAAE,SAAS,MAAM,EAUvC,CAAA;AAiDD;;;;;GAKG;AACH,wBAAgB,YAAY,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAG7D"}
+{"version":3,"file":"icons.d.ts","sourceRoot":"","sources":["../../src/a2ui/icons.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,eAAO,MAAM,UAAU,EAAE,SAAS,MAAM,EAUvC,CAAA;AA0CD,mGAAmG;AACnG,wBAAgB,YAAY,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAG7D"}

package/dist/a2ui/icons.js

@@ -1,23 +1,6 @@
 /**
- * prefab icon name → A2UI Basic catalog icon.
- *
- * The one place where the two catalogs disagree on *values* rather than on
- * component shape. prefab's `Icon(name)` takes any string, because its renderer
- * resolves Lucide names at runtime and new icons cost nothing. A2UI's
- * `Icon.name` is a closed enum of 59 names, so an unrecognised value does not
- * render as a fallback glyph — it makes the whole component fail validation.
- *
- * Passing the name through unchecked therefore emits an invalid surface for
- * every icon outside those 59, which is most of them. Instead the name is
- * normalised, matched against the enum, and dropped with a diagnostic when
- * nothing fits, so an unmappable icon costs a glyph rather than the payload.
- */
-/**
- * The A2UI Basic catalog's `Icon.name` enum, v1.0.
- *
- * Duplicated as a literal because prefab ships zero runtime dependencies and
- * cannot read the catalog JSON at emit time. `test/a2ui-icons.test.ts` asserts
- * this matches the vendored catalog exactly, so it cannot drift silently.
+ * The A2UI Basic catalog's closed `Icon.name` enum (v1.0); an unknown name fails the whole component's validation.
+ * `test/a2ui-icons.test.ts` keeps this literal equal to the vendored catalog.
  */
 export const A2UI_ICONS = [
     'accountCircle', 'add', 'arrowBack', 'arrowForward', 'attachFile', 'calendarToday',
@@ -32,14 +15,7 @@ export const A2UI_ICONS = [
 ];
 /** Lookup by normalised form, so `Arrow-Back`, `arrow_back` and `ArrowBack` all hit. */
 const BY_NORMALISED = new Map(A2UI_ICONS.map(name => [normalise(name), name]));
-/**
- * Names that differ between the two vocabularies rather than merely in case.
- *
- * prefab follows Lucide, A2UI follows Material. Where the concept exists in both
- * under different words, the alias keeps the icon; where it does not, the entry
- * is absent and the icon is dropped rather than mapped to something that means
- * something else. Keys are normalised, so one entry covers every spelling.
- */
+/** Lucide names whose Material counterpart is spelled differently, keyed by normalised name. */
 const ALIASES = {
     // Status and feedback
     alertcircle: 'error', alerttriangle: 'warning', alertoctagon: 'error',
@@ -74,12 +50,7 @@ const ALIASES = {
 function normalise(name) {
     return name.replace(/[\s._-]/g, '').toLowerCase();
 }
-/**
- * Resolve a prefab icon name to an A2UI one.
- *
- * @returns the catalog name, or `undefined` when nothing in the enum means the
- *   same thing. Callers drop the icon and record a diagnostic.
- */
+/** A prefab icon name as an A2UI one, or `undefined` (callers drop the icon with a diagnostic). */
 export function a2uiIconName(name) {
     const key = normalise(name);
     return BY_NORMALISED.get(key) ?? ALIASES[key];

package/dist/a2ui/icons.js.map

@@ -1 +1 @@
-{"version":3,"file":"icons.js","sourceRoot":"","sources":["../../src/a2ui/icons.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"icons.js","sourceRoot":"","sources":["../../src/a2ui/icons.ts"],"names":[],"mappings":"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"}

package/dist/a2ui/types.d.ts

@@ -1,25 +1,6 @@
 /**
- * A2UI v1.0 wire types.
- *
- * A2UI (`a2ui.org`) is the declarative agent-to-UI protocol: the agent streams
- * JSON describing a component tree plus a data model, and the renderer maps the
- * abstract component names onto its own widgets. prefab emits it as a second
- * output target alongside the `$prefab` wire format.
- *
- * Two structural differences drive the whole emitter:
- *
- *   1. **Flat, not nested.** A2UI components live in an adjacency list — every
- *      component carries an `id`, and parents reference children by id rather
- *      than embedding them. `$prefab` nests `children` directly.
- *   2. **Bound, not interpolated.** A2UI reads dynamic values through JSON
- *      Pointer `{ path }` bindings into the data model. `$prefab` interpolates
- *      `{{ expr }}` templates, which is strictly more expressive, so only the
- *      plain-path subset survives the crossing (see `./expr.ts`).
- *
- * Mirrors `specification/v1_0/json/agent_to_renderer.json` and
- * `catalogs/basic/catalog.json` from a2ui-project/a2ui (Apache-2.0). Only the
- * agent-to-renderer direction is modelled: prefab produces UI, it does not
- * consume renderer events.
+ * A2UI v1.0 agent-to-renderer wire types (a2ui-project/a2ui, Apache-2.0): a flat, id-linked component list whose
+ * values bind through JSON Pointers, where `$prefab` nests children and interpolates `{{ }}`.
  */
 /** Protocol version stamped on every emitted message. */
 export declare const A2UI_VERSION = "v1.0";
@@ -35,13 +16,7 @@ export declare const A2UI_ROOT_ID = "root";
 export interface A2uiDataBinding {
     path: string;
 }
-/**
- * A call to a catalog function, used for formatting and validation.
- *
- * The function name lives under `call`, and the object IS the call — it is not
- * wrapped in a `functionCall` key. That wrapper appears only where a function
- * stands in for an {@link A2uiAction}.
- */
+/** A catalog function call, unwrapped; the `functionCall` wrapper exists only inside an {@link A2uiAction}. */
 export interface A2uiFunctionCall {
     call: string;
     catalogId?: string;
@@ -70,13 +45,7 @@ export interface A2uiAccessibility {
     description?: A2uiDynamicString;
     live?: 'off' | 'polite' | 'assertive';
 }
-/**
- * One entry in a surface's adjacency list.
- *
- * The index signature carries catalog-specific props (`text`, `url`, `options`,
- * …) that vary per component, which is how the catalog stays open to component
- * sets beyond Basic without a type per component.
- */
+/** One entry in a surface's component list; catalog-specific props ride the index signature. */
 export interface A2uiComponentProps {
     component: string;
     catalogId?: string;
@@ -86,12 +55,7 @@ export interface A2uiComponentProps {
     };
     [prop: string]: unknown;
 }
-/**
- * Split from {@link A2uiComponentProps} by extension rather than by
- * `Omit<A2uiComponent, 'id'>`. `Omit` resolves `keyof` to `string | number`
- * on a type carrying an index signature, which erases every named property, so
- * the omitted form would no longer be known to supply `component`.
- */
+/** Extends {@link A2uiComponentProps} because `Omit` over an index signature erases the named properties. */
 export interface A2uiComponent extends A2uiComponentProps {
     id: string;
 }
@@ -125,14 +89,7 @@ export interface A2uiUpdateDataModel {
 export interface A2uiDeleteSurface {
     surfaceId: string;
 }
-/**
- * One agent-to-renderer message.
- *
- * A type alias rather than an interface so it keeps an implicit index
- * signature: these land in `structuredContent`, which the MCP SDK types as
- * `{ [x: string]: unknown }`, and TypeScript grants that signature to object
- * aliases but never to interfaces. Same reasoning as `src/mcp/types.ts`.
- */
+/** One agent-to-renderer message; a type alias so it fits `structuredContent` (see `src/mcp/types.ts`). */
 export type A2uiMessage = {
     version: string;
     createSurface: A2uiCreateSurface;
@@ -146,11 +103,7 @@ export type A2uiMessage = {
     version: string;
     deleteSurface: A2uiDeleteSurface;
 };
-/**
- * The list-wrapper envelope, for transports that need a top-level JSON object
- * rather than a bare array. This is what prefab writes into an MCP resource or
- * an embedded resource, per `agent_to_renderer_list_wrapper.json`.
- */
+/** The `{ messages }` envelope prefab writes into MCP resources, per `agent_to_renderer_list_wrapper.json`. */
 export type A2uiMessageList = {
     messages: A2uiMessage[];
 };

package/dist/a2ui/types.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/a2ui/types.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/a2ui/types.ts"],"names":[],"mappings":"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"}

package/dist/a2ui/types.js

@@ -1,25 +1,6 @@
 /**
- * A2UI v1.0 wire types.
- *
- * A2UI (`a2ui.org`) is the declarative agent-to-UI protocol: the agent streams
- * JSON describing a component tree plus a data model, and the renderer maps the
- * abstract component names onto its own widgets. prefab emits it as a second
- * output target alongside the `$prefab` wire format.
- *
- * Two structural differences drive the whole emitter:
- *
- *   1. **Flat, not nested.** A2UI components live in an adjacency list — every
- *      component carries an `id`, and parents reference children by id rather
- *      than embedding them. `$prefab` nests `children` directly.
- *   2. **Bound, not interpolated.** A2UI reads dynamic values through JSON
- *      Pointer `{ path }` bindings into the data model. `$prefab` interpolates
- *      `{{ expr }}` templates, which is strictly more expressive, so only the
- *      plain-path subset survives the crossing (see `./expr.ts`).
- *
- * Mirrors `specification/v1_0/json/agent_to_renderer.json` and
- * `catalogs/basic/catalog.json` from a2ui-project/a2ui (Apache-2.0). Only the
- * agent-to-renderer direction is modelled: prefab produces UI, it does not
- * consume renderer events.
+ * A2UI v1.0 agent-to-renderer wire types (a2ui-project/a2ui, Apache-2.0): a flat, id-linked component list whose
+ * values bind through JSON Pointers, where `$prefab` nests children and interpolates `{{ }}`.
  */
 // ── Constants ────────────────────────────────────────────────────────────────
 /** Protocol version stamped on every emitted message. */

package/dist/a2ui/types.js.map

@@ -1 +1 @@
-{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/a2ui/types.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;GAsBG;AAEH,gFAAgF;AAEhF,yDAAyD;AACzD,MAAM,CAAC,MAAM,YAAY,GAAG,MAAM,CAAA;AAElC,gFAAgF;AAChF,MAAM,CAAC,MAAM,kBAAkB,GAAG,iEAAiE,CAAA;AAEnG,sDAAsD;AACtD,MAAM,CAAC,MAAM,SAAS,GAAG,uBAAuB,CAAA;AAEhD,qDAAqD;AACrD,MAAM,CAAC,MAAM,WAAW,GAAG,SAAS,CAAA;AAEpC,gEAAgE;AAChE,MAAM,CAAC,MAAM,YAAY,GAAG,MAAM,CAAA"}
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/a2ui/types.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,gFAAgF;AAEhF,yDAAyD;AACzD,MAAM,CAAC,MAAM,YAAY,GAAG,MAAM,CAAA;AAElC,gFAAgF;AAChF,MAAM,CAAC,MAAM,kBAAkB,GAAG,iEAAiE,CAAA;AAEnG,sDAAsD;AACtD,MAAM,CAAC,MAAM,SAAS,GAAG,uBAAuB,CAAA;AAEhD,qDAAqD;AACrD,MAAM,CAAC,MAAM,WAAW,GAAG,SAAS,CAAA;AAEpC,gEAAgE;AAChE,MAAM,CAAC,MAAM,YAAY,GAAG,MAAM,CAAA"}