@maxhealth.tech/prefab 0.3.9 → 0.3.10

package/dist/a2ui/emit.js

@@ -0,0 +1,269 @@
+/**
+ * `$prefab` → A2UI emitter.
+ *
+ * Walks the nested `$prefab` component tree and produces A2UI's flat adjacency
+ * list, plus the surface data model. Three invariants drive the implementation:
+ *
+ *   - **The root is named `root`.** A2UI requires exactly that id on the entry
+ *     component, so it is reserved before traversal begins rather than renamed
+ *     afterwards.
+ *   - **Ids are allocated before children are emitted.** A mapper calls back
+ *     into the context to emit its children, so the parent's slot is reserved
+ *     first and filled in once the mapper returns. Nodes that turn out to be
+ *     unmappable release their slot, which is why the components map is keyed
+ *     by id rather than being a positional array.
+ *   - **Emission is deterministic.** Ids are drawn from a counter in traversal
+ *     order, so the same tree always produces byte-identical output and can be
+ *     asserted on in tests and cached by hosts.
+ */
+import { createLogger } from '../core/logger.js';
+import { escapePointerToken, toBinding } from './expr.js';
+import { fallbackMapper, isConsumedByParent, mapperFor } from './catalog.js';
+import { A2UI_BASIC_CATALOG, A2UI_ROOT_ID, A2UI_VERSION, } from './types.js';
+const log = createLogger('a2ui');
+/**
+ * The wrapper `toJSON()` puts around every view. It carries a CSS class and
+ * nothing else, so it is unwrapped rather than emitted as a pointless Column.
+ */
+function unwrapAppRoot(view) {
+    const children = view.children;
+    if (view.type === 'Div'
+        && typeof view.cssClass === 'string'
+        && view.cssClass.startsWith('pf-app-root')
+        && Array.isArray(children)
+        && children.length === 1) {
+        return children[0];
+    }
+    return view;
+}
+class Emitter {
+    warn;
+    /** Insertion-ordered; `undefined` marks a reserved slot that was released. */
+    components = new Map();
+    dataModel = {};
+    used = new Set([A2UI_ROOT_ID]);
+    diagnostics = [];
+    counter = 0;
+    constructor(warn) {
+        this.warn = warn;
+    }
+    note(kind, subject, detail) {
+        this.diagnostics.push({ kind, subject, detail });
+        if (this.warn)
+            log.warn(`${kind}: ${subject} — ${detail}`);
+    }
+    /** Allocate an id, honouring an author-supplied one when it is still free. */
+    allocate(node) {
+        const preferred = typeof node?.id === 'string' && node.id.length > 0 ? node.id : undefined;
+        if (preferred != null && !this.used.has(preferred)) {
+            this.used.add(preferred);
+            return preferred;
+        }
+        let id;
+        do {
+            this.counter += 1;
+            id = `c${this.counter}`;
+        } while (this.used.has(id));
+        this.used.add(id);
+        return id;
+    }
+    push(props) {
+        const id = this.allocate();
+        this.components.set(id, { id, ...props });
+        return id;
+    }
+    bindData(key, value) {
+        let name = key;
+        let n = 0;
+        while (name in this.dataModel) {
+            n += 1;
+            name = `${key}${n}`;
+        }
+        this.dataModel[name] = value;
+        return `/${escapePointerToken(name)}`;
+    }
+    child(node) {
+        return this.emit(node, false);
+    }
+    children(nodes) {
+        if (!Array.isArray(nodes))
+            return [];
+        const ids = [];
+        for (const node of nodes) {
+            if (node == null || typeof node !== 'object')
+                continue;
+            const id = this.emit(node, false);
+            if (id != null)
+                ids.push(id);
+        }
+        return ids;
+    }
+    single(nodes) {
+        const ids = this.children(nodes);
+        if (ids.length === 0)
+            return undefined;
+        if (ids.length === 1)
+            return ids[0];
+        // A2UI's single-child slots take one id, so several children need a wrapper.
+        return this.push({ component: 'Column', children: ids });
+    }
+    action(value, subject) {
+        if (value == null)
+            return undefined;
+        if (Array.isArray(value)) {
+            if (value.length === 0)
+                return undefined;
+            if (value.length > 1) {
+                this.note('action', subject, `${value.length} actions were bound; A2UI carries one, so the rest were dropped`);
+            }
+            return this.action(value[0], subject);
+        }
+        if (typeof value !== 'object')
+            return undefined;
+        const json = value;
+        const kind = typeof json.action === 'string' ? json.action : undefined;
+        if (kind == null)
+            return undefined;
+        switch (kind) {
+            case 'toolCall': {
+                const tool = typeof json.tool === 'string' ? json.tool : undefined;
+                if (tool == null)
+                    return undefined;
+                const context = this.eventContext(json.arguments, subject);
+                return { event: { name: tool, ...(context != null && { context }) } };
+            }
+            case 'sendMessage': {
+                const message = typeof json.message === 'string' ? json.message : '';
+                return { event: { name: 'sendMessage', context: { message } } };
+            }
+            case 'openLink': {
+                const url = typeof json.url === 'string' ? json.url : typeof json.href === 'string' ? json.href : undefined;
+                if (url == null)
+                    return undefined;
+                return { functionCall: { call: 'openUrl', args: { url } } };
+            }
+            default: {
+                // Everything else mutates renderer state, which the Basic catalog has no
+                // function for. Reporting the intent to the agent keeps the control
+                // interactive instead of dropping it for want of an action.
+                this.note('action', subject, `"${kind}" has no renderer-side equivalent; emitted as an agent event`);
+                const { action: _kind, ...rest } = json;
+                const context = this.eventContext(rest, subject);
+                return { event: { name: kind, ...(context != null && { context }) } };
+            }
+        }
+    }
+    /**
+     * Convert a prefab action's argument bag into an A2UI event context.
+     *
+     * Values go through the same `{{ }}` conversion as component props, so a
+     * `CallTool('search', { arguments: { q: '{{ query }}' } })` sends the bound
+     * value rather than shipping the uninterpolated template to the agent.
+     */
+    eventContext(value, subject) {
+        if (value == null || typeof value !== 'object' || Array.isArray(value))
+            return undefined;
+        const context = {};
+        for (const [key, raw] of Object.entries(value)) {
+            if (typeof raw === 'number' || typeof raw === 'boolean' || raw === null) {
+                context[key] = raw;
+                continue;
+            }
+            if (typeof raw !== 'string') {
+                this.note('action', subject, `argument "${key}" is not a scalar and was dropped from the event context`);
+                continue;
+            }
+            const bound = toBinding(raw);
+            if (bound.kind === 'unbindable') {
+                this.note('action', subject, `argument "${key}" uses "${bound.expression}", which A2UI cannot bind; it was dropped`);
+                continue;
+            }
+            context[key] = bound.kind === 'binding' ? bound.value : bound.value;
+        }
+        return Object.keys(context).length > 0 ? context : undefined;
+    }
+    /** Emit one subtree. Returns the allocated id, or `undefined` if it was dropped. */
+    emit(node, isRoot) {
+        if (typeof node.type !== 'string')
+            return undefined;
+        if (isConsumedByParent(node.type)) {
+            this.note('unsupported', node.type, 'only meaningful inside its parent; emitted standalone it has no meaning');
+            return undefined;
+        }
+        const id = isRoot ? A2UI_ROOT_ID : this.allocate(node);
+        // Reserve the slot before the mapper runs, so children emitted during
+        // mapping cannot claim this id.
+        this.components.set(id, undefined);
+        const mapper = mapperFor(node.type) ?? fallbackMapper;
+        const props = mapper(node, this);
+        if (props == null) {
+            this.components.delete(id);
+            if (!isRoot)
+                this.used.delete(id);
+            return undefined;
+        }
+        this.components.set(id, { id, ...props });
+        return id;
+    }
+    finish(wire, options) {
+        const surfaceId = options.surfaceId ?? 'prefab';
+        const rootId = this.emit(unwrapAppRoot(wire.view), true);
+        if (rootId == null) {
+            this.note('unsupported', 'view', 'nothing in the view could be expressed in A2UI; the surface is empty');
+        }
+        const components = [];
+        for (const c of this.components.values())
+            if (c != null)
+                components.push(c);
+        // prefab state and any literals seeded during mapping share one data model.
+        // State wins on a collision, since seeded keys are generated and state keys
+        // are author-chosen.
+        const dataModel = { ...this.dataModel, ...(wire.state ?? {}) };
+        const hasData = Object.keys(dataModel).length > 0;
+        const messages = [];
+        const catalogId = options.catalogId ?? A2UI_BASIC_CATALOG;
+        if (options.stream === true) {
+            messages.push({
+                version: A2UI_VERSION,
+                createSurface: {
+                    surfaceId,
+                    catalogId,
+                    ...(options.sendDataModel === true && { sendDataModel: true }),
+                },
+            });
+            if (components.length > 0) {
+                messages.push({ version: A2UI_VERSION, updateComponents: { surfaceId, components } });
+            }
+            if (hasData) {
+                messages.push({ version: A2UI_VERSION, updateDataModel: { surfaceId, value: dataModel } });
+            }
+        }
+        else {
+            messages.push({
+                version: A2UI_VERSION,
+                createSurface: {
+                    surfaceId,
+                    catalogId,
+                    ...(options.sendDataModel === true && { sendDataModel: true }),
+                    ...(components.length > 0 && { components }),
+                    ...(hasData && { dataModel }),
+                },
+            });
+        }
+        return { messages, diagnostics: this.diagnostics };
+    }
+}
+/**
+ * Translate a `$prefab` wire payload into A2UI messages.
+ *
+ * @example
+ * ```ts
+ * const { messages, diagnostics } = emitA2UI(app.toJSON())
+ * if (diagnostics.length > 0) console.warn(diagnostics)
+ * ```
+ */
+export function emitA2UI(wire, options) {
+    const opts = options ?? {};
+    return new Emitter(opts.warn === true).finish(wire, opts);
+}
+//# sourceMappingURL=emit.js.map

package/dist/a2ui/emit.js.map

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

package/dist/a2ui/expr.d.ts

@@ -0,0 +1,58 @@
+/**
+ * `{{ }}` template → A2UI data binding.
+ *
+ * `$prefab` interpolates arbitrary expressions client-side — `{{ count + 1 }}`,
+ * `{{ price | currency:'USD' }}`, `{{ active ? 'Yes' : 'No' }}`. A2UI binds
+ * values through JSON Pointer paths into the data model and has no expression
+ * language, so only the plain-path subset crosses over: `{{ user.name }}`
+ * becomes `{ path: '/user/name' }`, and anything with an operator, pipe or
+ * conditional does not survive.
+ *
+ * Rather than silently emitting a broken binding, richer expressions are
+ * reported back to the caller as an `expression` diagnostic and the property is
+ * dropped, so the failure shows up at emit time instead of as an empty widget
+ * in someone's renderer.
+ */
+import type { A2uiDataBinding, A2uiDynamicString } from './types.js';
+/**
+ * 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.
+ */
+export declare function escapePointerToken(token: string): string;
+/** Build a JSON Pointer from already-split path segments. */
+export declare function toJsonPointer(segments: string[]): string;
+/** The outcome of converting one prefab value into an A2UI dynamic value. */
+export type BindingResult = 
+/** A literal with no template in it. */
+{
+    kind: 'literal';
+    value: string;
+}
+/** A `{{ path }}` that mapped cleanly onto a JSON Pointer. */
+ | {
+    kind: 'binding';
+    value: A2uiDataBinding;
+}
+/** A template too rich for A2UI. `expression` is the source, for diagnostics. */
+ | {
+    kind: 'unbindable';
+    expression: string;
+};
+/**
+ * Convert a prefab string value into an A2UI dynamic value.
+ *
+ * Whole-string templates over a plain member path become bindings; strings with
+ * no template at all pass through as literals; everything else is unbindable.
+ * Mixed text such as `Hello {{ name }}` is unbindable too — A2UI has no string
+ * interpolation, and `formatString` would need an argument list this function
+ * has no way to name.
+ */
+export declare function toBinding(value: string): BindingResult;
+/**
+ * Resolve a value to an `A2uiDynamicString`, or `undefined` when it cannot be
+ * expressed. Callers pair this with a diagnostic when it returns `undefined`.
+ */
+export declare function dynamicString(value: string | undefined): A2uiDynamicString | undefined;
+//# sourceMappingURL=expr.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"expr.d.ts","sourceRoot":"","sources":["../../src/a2ui/expr.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAEH,OAAO,KAAK,EAAE,eAAe,EAAE,iBAAiB,EAAE,MAAM,YAAY,CAAA;AAapE;;;;;GAKG;AACH,wBAAgB,kBAAkB,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAExD;AAED,6DAA6D;AAC7D,wBAAgB,aAAa,CAAC,QAAQ,EAAE,MAAM,EAAE,GAAG,MAAM,CAExD;AAWD,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,iFAAiF;GAC/E;IAAE,IAAI,EAAE,YAAY,CAAC;IAAC,UAAU,EAAE,MAAM,CAAA;CAAE,CAAA;AAE9C;;;;;;;;GAQG;AACH,wBAAgB,SAAS,CAAC,KAAK,EAAE,MAAM,GAAG,aAAa,CAWtD;AAED;;;GAGG;AACH,wBAAgB,aAAa,CAAC,KAAK,EAAE,MAAM,GAAG,SAAS,GAAG,iBAAiB,GAAG,SAAS,CAMtF"}

package/dist/a2ui/expr.js

@@ -0,0 +1,81 @@
+/**
+ * `{{ }}` template → A2UI data binding.
+ *
+ * `$prefab` interpolates arbitrary expressions client-side — `{{ count + 1 }}`,
+ * `{{ price | currency:'USD' }}`, `{{ active ? 'Yes' : 'No' }}`. A2UI binds
+ * values through JSON Pointer paths into the data model and has no expression
+ * language, so only the plain-path subset crosses over: `{{ user.name }}`
+ * becomes `{ path: '/user/name' }`, and anything with an operator, pipe or
+ * conditional does not survive.
+ *
+ * Rather than silently emitting a broken binding, richer expressions are
+ * reported back to the caller as an `expression` diagnostic and the property is
+ * dropped, so the failure shows up at emit time instead of as an empty widget
+ * in someone's renderer.
+ */
+/** Matches a string that is exactly one `{{ … }}` template and nothing else. */
+const SOLE_TEMPLATE = /^\s*\{\{\s*(.+?)\s*\}\}\s*$/s;
+/**
+ * A plain member path: `user.name`, `items.0.label`, `count`.
+ *
+ * Deliberately narrow. Anything outside this shape (operators, pipes, calls,
+ * ternaries, string literals) has no A2UI equivalent.
+ */
+const PLAIN_PATH = /^[A-Za-z_$][\w$]*(?:\.(?:[A-Za-z_$][\w$]*|\d+))*$/;
+/**
+ * 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.
+ */
+export function escapePointerToken(token) {
+    return token.replace(/~/g, '~0').replace(/\//g, '~1');
+}
+/** Build a JSON Pointer from already-split path segments. */
+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.
+ */
+function stripStatePrefix(path) {
+    return path.startsWith('state.') ? path.slice('state.'.length) : path;
+}
+/**
+ * Convert a prefab string value into an A2UI dynamic value.
+ *
+ * Whole-string templates over a plain member path become bindings; strings with
+ * no template at all pass through as literals; everything else is unbindable.
+ * Mixed text such as `Hello {{ name }}` is unbindable too — A2UI has no string
+ * interpolation, and `formatString` would need an argument list this function
+ * has no way to name.
+ */
+export function toBinding(value) {
+    const sole = SOLE_TEMPLATE.exec(value);
+    if (sole == null) {
+        if (value.includes('{{'))
+            return { kind: 'unbindable', expression: value };
+        return { kind: 'literal', value };
+    }
+    const expr = stripStatePrefix(sole[1].trim());
+    if (!PLAIN_PATH.test(expr))
+        return { kind: 'unbindable', expression: sole[1].trim() };
+    return { kind: 'binding', value: { path: toJsonPointer(expr.split('.')) } };
+}
+/**
+ * Resolve a value to an `A2uiDynamicString`, or `undefined` when it cannot be
+ * expressed. Callers pair this with a diagnostic when it returns `undefined`.
+ */
+export function dynamicString(value) {
+    if (value == null)
+        return undefined;
+    const r = toBinding(value);
+    if (r.kind === 'literal')
+        return r.value;
+    if (r.kind === 'binding')
+        return r.value;
+    return undefined;
+}
+//# sourceMappingURL=expr.js.map

package/dist/a2ui/expr.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"expr.js","sourceRoot":"","sources":["../../src/a2ui/expr.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAIH,gFAAgF;AAChF,MAAM,aAAa,GAAG,8BAA8B,CAAA;AAEpD;;;;;GAKG;AACH,MAAM,UAAU,GAAG,mDAAmD,CAAA;AAEtE;;;;;GAKG;AACH,MAAM,UAAU,kBAAkB,CAAC,KAAa;IAC9C,OAAO,KAAK,CAAC,OAAO,CAAC,IAAI,EAAE,IAAI,CAAC,CAAC,OAAO,CAAC,KAAK,EAAE,IAAI,CAAC,CAAA;AACvD,CAAC;AAED,6DAA6D;AAC7D,MAAM,UAAU,aAAa,CAAC,QAAkB;IAC9C,OAAO,GAAG,GAAG,QAAQ,CAAC,GAAG,CAAC,kBAAkB,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,CAAA;AACzD,CAAC;AAED;;;;GAIG;AACH,SAAS,gBAAgB,CAAC,IAAY;IACpC,OAAO,IAAI,CAAC,UAAU,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,IAAI,CAAA;AACvE,CAAC;AAWD;;;;;;;;GAQG;AACH,MAAM,UAAU,SAAS,CAAC,KAAa;IACrC,MAAM,IAAI,GAAG,aAAa,CAAC,IAAI,CAAC,KAAK,CAAC,CAAA;IACtC,IAAI,IAAI,IAAI,IAAI,EAAE,CAAC;QACjB,IAAI,KAAK,CAAC,QAAQ,CAAC,IAAI,CAAC;YAAE,OAAO,EAAE,IAAI,EAAE,YAAY,EAAE,UAAU,EAAE,KAAK,EAAE,CAAA;QAC1E,OAAO,EAAE,IAAI,EAAE,SAAS,EAAE,KAAK,EAAE,CAAA;IACnC,CAAC;IAED,MAAM,IAAI,GAAG,gBAAgB,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC,CAAA;IAC7C,IAAI,CAAC,UAAU,CAAC,IAAI,CAAC,IAAI,CAAC;QAAE,OAAO,EAAE,IAAI,EAAE,YAAY,EAAE,UAAU,EAAE,IAAI,CAAC,CAAC,CAAC,CAAC,IAAI,EAAE,EAAE,CAAA;IAErF,OAAO,EAAE,IAAI,EAAE,SAAS,EAAE,KAAK,EAAE,EAAE,IAAI,EAAE,aAAa,CAAC,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,EAAE,EAAE,CAAA;AAC7E,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,aAAa,CAAC,KAAyB;IACrD,IAAI,KAAK,IAAI,IAAI;QAAE,OAAO,SAAS,CAAA;IACnC,MAAM,CAAC,GAAG,SAAS,CAAC,KAAK,CAAC,CAAA;IAC1B,IAAI,CAAC,CAAC,IAAI,KAAK,SAAS;QAAE,OAAO,CAAC,CAAC,KAAK,CAAA;IACxC,IAAI,CAAC,CAAC,IAAI,KAAK,SAAS;QAAE,OAAO,CAAC,CAAC,KAAK,CAAA;IACxC,OAAO,SAAS,CAAA;AAClB,CAAC"}

package/dist/a2ui/icons.d.ts

@@ -0,0 +1,30 @@
+/**
+ * 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.
+ */
+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.
+ */
+export declare function a2uiIconName(name: string): string | undefined;
+//# sourceMappingURL=icons.d.ts.map

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

@@ -0,0 +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"}

package/dist/a2ui/icons.js

@@ -0,0 +1,87 @@
+/**
+ * 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.
+ */
+export const A2UI_ICONS = [
+    'accountCircle', 'add', 'arrowBack', 'arrowForward', 'attachFile', 'calendarToday',
+    'call', 'camera', 'check', 'close', 'delete', 'download', 'edit', 'event', 'error',
+    'fastForward', 'favorite', 'favoriteOff', 'folder', 'help', 'home', 'info',
+    'locationOn', 'lock', 'lockOpen', 'mail', 'menu', 'moreVert', 'moreHoriz',
+    'notificationsOff', 'notifications', 'pause', 'payment', 'person', 'phone', 'photo',
+    'play', 'print', 'refresh', 'rewind', 'search', 'send', 'settings', 'share',
+    'shoppingCart', 'skipNext', 'skipPrevious', 'star', 'starHalf', 'starOff', 'stop',
+    'upload', 'visibility', 'visibilityOff', 'volumeDown', 'volumeMute', 'volumeOff',
+    'volumeUp', 'warning',
+];
+/** 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.
+ */
+const ALIASES = {
+    // Status and feedback
+    alertcircle: 'error', alerttriangle: 'warning', alertoctagon: 'error',
+    xcircle: 'error', circlex: 'error', circlealert: 'error',
+    checkcircle: 'check', circlecheck: 'check', checkcircle2: 'check',
+    infocircle: 'info', circleinfo: 'info', helpcircle: 'help', circlehelp: 'help',
+    bell: 'notifications', belloff: 'notificationsOff',
+    // Navigation
+    arrowleft: 'arrowBack', arrowright: 'arrowForward',
+    chevronleft: 'arrowBack', chevronright: 'arrowForward',
+    x: 'close', plus: 'add', trash: 'delete', trash2: 'delete',
+    ellipsisvertical: 'moreVert', ellipsis: 'moreHoriz', morehorizontal: 'moreHoriz',
+    morevertical: 'moreVert',
+    // Objects and actions
+    pencil: 'edit', pen: 'edit', squarepen: 'edit',
+    user: 'person', usercircle: 'accountCircle', circleuser: 'accountCircle',
+    eye: 'visibility', eyeoff: 'visibilityOff',
+    mappin: 'locationOn', map: 'locationOn',
+    image: 'photo', images: 'photo', file: 'folder', files: 'folder',
+    calendar: 'calendarToday', calendardays: 'calendarToday', clock: 'event',
+    creditcard: 'payment', cart: 'shoppingCart', shoppingbag: 'shoppingCart',
+    phonecall: 'call', mailopen: 'mail', inbox: 'mail',
+    cog: 'settings', gear: 'settings', sliders: 'settings',
+    rotatecw: 'refresh', rotateccw: 'refresh', refreshcw: 'refresh',
+    heart: 'favorite', heartoff: 'favoriteOff',
+    volume: 'volumeUp', volume1: 'volumeDown', volume2: 'volumeUp', volumex: 'volumeOff',
+    skipforward: 'skipNext', skipback: 'skipPrevious',
+    paperclip: 'attachFile', link: 'share', share2: 'share',
+    magnifyingglass: 'search', searchicon: 'search',
+};
+/** Case-insensitive, separator-insensitive key for matching either vocabulary. */
+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.
+ */
+export function a2uiIconName(name) {
+    const key = normalise(name);
+    return BY_NORMALISED.get(key) ?? ALIASES[key];
+}
+//# sourceMappingURL=icons.js.map

package/dist/a2ui/icons.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"icons.js","sourceRoot":"","sources":["../../src/a2ui/icons.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAEH;;;;;;GAMG;AACH,MAAM,CAAC,MAAM,UAAU,GAAsB;IAC3C,eAAe,EAAE,KAAK,EAAE,WAAW,EAAE,cAAc,EAAE,YAAY,EAAE,eAAe;IAClF,MAAM,EAAE,QAAQ,EAAE,OAAO,EAAE,OAAO,EAAE,QAAQ,EAAE,UAAU,EAAE,MAAM,EAAE,OAAO,EAAE,OAAO;IAClF,aAAa,EAAE,UAAU,EAAE,aAAa,EAAE,QAAQ,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM;IAC1E,YAAY,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,EAAE,MAAM,EAAE,UAAU,EAAE,WAAW;IACzE,kBAAkB,EAAE,eAAe,EAAE,OAAO,EAAE,SAAS,EAAE,QAAQ,EAAE,OAAO,EAAE,OAAO;IACnF,MAAM,EAAE,OAAO,EAAE,SAAS,EAAE,QAAQ,EAAE,QAAQ,EAAE,MAAM,EAAE,UAAU,EAAE,OAAO;IAC3E,cAAc,EAAE,UAAU,EAAE,cAAc,EAAE,MAAM,EAAE,UAAU,EAAE,SAAS,EAAE,MAAM;IACjF,QAAQ,EAAE,YAAY,EAAE,eAAe,EAAE,YAAY,EAAE,YAAY,EAAE,WAAW;IAChF,UAAU,EAAE,SAAS;CACtB,CAAA;AAED,wFAAwF;AACxF,MAAM,aAAa,GAAG,IAAI,GAAG,CAAC,UAAU,CAAC,GAAG,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC,SAAS,CAAC,IAAI,CAAC,EAAE,IAAI,CAAC,CAAC,CAAC,CAAA;AAE9E;;;;;;;GAOG;AACH,MAAM,OAAO,GAA2B;IACtC,sBAAsB;IACtB,WAAW,EAAE,OAAO,EAAE,aAAa,EAAE,SAAS,EAAE,YAAY,EAAE,OAAO;IACrE,OAAO,EAAE,OAAO,EAAE,OAAO,EAAE,OAAO,EAAE,WAAW,EAAE,OAAO;IACxD,WAAW,EAAE,OAAO,EAAE,WAAW,EAAE,OAAO,EAAE,YAAY,EAAE,OAAO;IACjE,UAAU,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM;IAC9E,IAAI,EAAE,eAAe,EAAE,OAAO,EAAE,kBAAkB;IAClD,aAAa;IACb,SAAS,EAAE,WAAW,EAAE,UAAU,EAAE,cAAc;IAClD,WAAW,EAAE,WAAW,EAAE,YAAY,EAAE,cAAc;IACtD,CAAC,EAAE,OAAO,EAAE,IAAI,EAAE,KAAK,EAAE,KAAK,EAAE,QAAQ,EAAE,MAAM,EAAE,QAAQ;IAC1D,gBAAgB,EAAE,UAAU,EAAE,QAAQ,EAAE,WAAW,EAAE,cAAc,EAAE,WAAW;IAChF,YAAY,EAAE,UAAU;IACxB,sBAAsB;IACtB,MAAM,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM;IAC9C,IAAI,EAAE,QAAQ,EAAE,UAAU,EAAE,eAAe,EAAE,UAAU,EAAE,eAAe;IACxE,GAAG,EAAE,YAAY,EAAE,MAAM,EAAE,eAAe;IAC1C,MAAM,EAAE,YAAY,EAAE,GAAG,EAAE,YAAY;IACvC,KAAK,EAAE,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,IAAI,EAAE,QAAQ,EAAE,KAAK,EAAE,QAAQ;IAChE,QAAQ,EAAE,eAAe,EAAE,YAAY,EAAE,eAAe,EAAE,KAAK,EAAE,OAAO;IACxE,UAAU,EAAE,SAAS,EAAE,IAAI,EAAE,cAAc,EAAE,WAAW,EAAE,cAAc;IACxE,SAAS,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM;IAClD,GAAG,EAAE,UAAU,EAAE,IAAI,EAAE,UAAU,EAAE,OAAO,EAAE,UAAU;IACtD,QAAQ,EAAE,SAAS,EAAE,SAAS,EAAE,SAAS,EAAE,SAAS,EAAE,SAAS;IAC/D,KAAK,EAAE,UAAU,EAAE,QAAQ,EAAE,aAAa;IAC1C,MAAM,EAAE,UAAU,EAAE,OAAO,EAAE,YAAY,EAAE,OAAO,EAAE,UAAU,EAAE,OAAO,EAAE,WAAW;IACpF,WAAW,EAAE,UAAU,EAAE,QAAQ,EAAE,cAAc;IACjD,SAAS,EAAE,YAAY,EAAE,IAAI,EAAE,OAAO,EAAE,MAAM,EAAE,OAAO;IACvD,eAAe,EAAE,QAAQ,EAAE,UAAU,EAAE,QAAQ;CAChD,CAAA;AAED,kFAAkF;AAClF,SAAS,SAAS,CAAC,IAAY;IAC7B,OAAO,IAAI,CAAC,OAAO,CAAC,UAAU,EAAE,EAAE,CAAC,CAAC,WAAW,EAAE,CAAA;AACnD,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,YAAY,CAAC,IAAY;IACvC,MAAM,GAAG,GAAG,SAAS,CAAC,IAAI,CAAC,CAAA;IAC3B,OAAO,aAAa,CAAC,GAAG,CAAC,GAAG,CAAC,IAAI,OAAO,CAAC,GAAG,CAAC,CAAA;AAC/C,CAAC"}

package/dist/a2ui/index.d.ts

@@ -0,0 +1,27 @@
+/**
+ * A2UI emitter — the second output target alongside the `$prefab` wire format.
+ *
+ * `$prefab` payloads render through prefab's own renderer, in an MCP Apps
+ * iframe or any web app. A2UI payloads render natively in the A2UI renderers
+ * (React, Angular, Lit, Flutter, Swift, Compose) with no iframe involved. Both
+ * come from the same server-side component tree.
+ *
+ * @example
+ * ```ts
+ * import { Column, H1, autoTable } from '@maxhealth.tech/prefab'
+ * import { PrefabApp } from '@maxhealth.tech/prefab'
+ *
+ * const app = new PrefabApp({ view: Column({ children: [H1('Users'), autoTable(rows)] }) })
+ * const { messages, diagnostics } = app.toA2UI()
+ * ```
+ */
+export { emitA2UI } from './emit.js';
+export type { A2uiEmitOptions, A2uiEmitResult } from './emit.js';
+export { mappedTypes } from './catalog.js';
+export { a2uiIconName, A2UI_ICONS } from './icons.js';
+export type { A2uiProps, EmitContext, Mapper } from './catalog.js';
+export { toBinding, toJsonPointer, escapePointerToken, dynamicString } from './expr.js';
+export type { BindingResult } from './expr.js';
+export { A2UI_VERSION, A2UI_BASIC_CATALOG, A2UI_MIME, A2UI_SCHEME, A2UI_ROOT_ID, } from './types.js';
+export type { A2uiAccessibility, A2uiAction, A2uiChildList, A2uiChildTemplate, A2uiComponent, A2uiCreateSurface, A2uiDataBinding, A2uiDeleteSurface, A2uiDiagnostic, A2uiDiagnosticKind, A2uiDynamicBoolean, A2uiDynamicNumber, A2uiDynamicString, A2uiDynamicValue, A2uiEventAction, A2uiFunctionAction, A2uiFunctionCall, A2uiMessage, A2uiMessageList, A2uiUpdateComponents, A2uiUpdateDataModel, } from './types.js';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/a2ui/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AAEH,OAAO,EAAE,QAAQ,EAAE,MAAM,WAAW,CAAA;AACpC,YAAY,EAAE,eAAe,EAAE,cAAc,EAAE,MAAM,WAAW,CAAA;AAEhE,OAAO,EAAE,WAAW,EAAE,MAAM,cAAc,CAAA;AAC1C,OAAO,EAAE,YAAY,EAAE,UAAU,EAAE,MAAM,YAAY,CAAA;AACrD,YAAY,EAAE,SAAS,EAAE,WAAW,EAAE,MAAM,EAAE,MAAM,cAAc,CAAA;AAElE,OAAO,EAAE,SAAS,EAAE,aAAa,EAAE,kBAAkB,EAAE,aAAa,EAAE,MAAM,WAAW,CAAA;AACvF,YAAY,EAAE,aAAa,EAAE,MAAM,WAAW,CAAA;AAE9C,OAAO,EACL,YAAY,EACZ,kBAAkB,EAClB,SAAS,EACT,WAAW,EACX,YAAY,GACb,MAAM,YAAY,CAAA;AACnB,YAAY,EACV,iBAAiB,EACjB,UAAU,EACV,aAAa,EACb,iBAAiB,EACjB,aAAa,EACb,iBAAiB,EACjB,eAAe,EACf,iBAAiB,EACjB,cAAc,EACd,kBAAkB,EAClB,kBAAkB,EAClB,iBAAiB,EACjB,iBAAiB,EACjB,gBAAgB,EAChB,eAAe,EACf,kBAAkB,EAClB,gBAAgB,EAChB,WAAW,EACX,eAAe,EACf,oBAAoB,EACpB,mBAAmB,GACpB,MAAM,YAAY,CAAA"}

package/dist/a2ui/index.js

@@ -0,0 +1,23 @@
+/**
+ * A2UI emitter — the second output target alongside the `$prefab` wire format.
+ *
+ * `$prefab` payloads render through prefab's own renderer, in an MCP Apps
+ * iframe or any web app. A2UI payloads render natively in the A2UI renderers
+ * (React, Angular, Lit, Flutter, Swift, Compose) with no iframe involved. Both
+ * come from the same server-side component tree.
+ *
+ * @example
+ * ```ts
+ * import { Column, H1, autoTable } from '@maxhealth.tech/prefab'
+ * import { PrefabApp } from '@maxhealth.tech/prefab'
+ *
+ * const app = new PrefabApp({ view: Column({ children: [H1('Users'), autoTable(rows)] }) })
+ * const { messages, diagnostics } = app.toA2UI()
+ * ```
+ */
+export { emitA2UI } from './emit.js';
+export { mappedTypes } from './catalog.js';
+export { a2uiIconName, A2UI_ICONS } from './icons.js';
+export { toBinding, toJsonPointer, escapePointerToken, dynamicString } from './expr.js';
+export { A2UI_VERSION, A2UI_BASIC_CATALOG, A2UI_MIME, A2UI_SCHEME, A2UI_ROOT_ID, } from './types.js';
+//# sourceMappingURL=index.js.map

package/dist/a2ui/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/a2ui/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AAEH,OAAO,EAAE,QAAQ,EAAE,MAAM,WAAW,CAAA;AAGpC,OAAO,EAAE,WAAW,EAAE,MAAM,cAAc,CAAA;AAC1C,OAAO,EAAE,YAAY,EAAE,UAAU,EAAE,MAAM,YAAY,CAAA;AAGrD,OAAO,EAAE,SAAS,EAAE,aAAa,EAAE,kBAAkB,EAAE,aAAa,EAAE,MAAM,WAAW,CAAA;AAGvF,OAAO,EACL,YAAY,EACZ,kBAAkB,EAClB,SAAS,EACT,WAAW,EACX,YAAY,GACb,MAAM,YAAY,CAAA"}