@maxhealth.tech/prefab 0.3.9 → 0.3.10

package/dist/a2ui/table.d.ts

@@ -0,0 +1,31 @@
+/**
+ * Table mappers — the one place a prefab component gains structure on the way
+ * out rather than losing it.
+ *
+ * The A2UI Basic catalog has no table component, so a table becomes a `Column`
+ * of `Row`s. For `DataTable` that would be a poor trade, because prefab's table
+ * is data-driven and flattening it would inline every row as its own component
+ * and lose the binding. A2UI's own answer is the child template: a `Column`
+ * whose `children` is `{ path, componentId }` instantiates one copy of the
+ * template component per item in a data-model list, and paths inside the
+ * template resolve relative to the current item. That maps onto `DataTable`
+ * exactly — one `Row` template, one `Text` per column bound to the column key —
+ * so the emitted surface stays as small and as reactive as the prefab original.
+ *
+ * The pattern follows `catalogs/basic/examples/18_track-list.json` in the A2UI
+ * specification, which is the normative example for templated lists.
+ */
+import type { ComponentJSON } from '../core/component.js';
+import type { A2uiProps, EmitContext } from './catalog.js';
+/** prefab table parts that only exist inside a `Table` and never map on their own. */
+export declare const TABLE_PART_TYPES: readonly ["TableHead", "TableBody", "TableFooter", "TableRow", "TableCell", "TableHeader", "ExpandableRow"];
+/**
+ * `DataTable` → a header `Row` plus a templated `Column`.
+ *
+ * A column key containing a `.` addresses a nested field on the row. Relative
+ * paths inside a template are JSON Pointers too, so the dots become slashes.
+ */
+export declare function mapDataTable(node: ComponentJSON, ctx: EmitContext): A2uiProps | undefined;
+/** `Table` → a `Column` of `Row`s, one per `TableRow`. */
+export declare function mapTable(node: ComponentJSON, ctx: EmitContext): A2uiProps | undefined;
+//# sourceMappingURL=table.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"table.d.ts","sourceRoot":"","sources":["../../src/a2ui/table.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AAEH,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAA;AACzD,OAAO,KAAK,EAAE,SAAS,EAAE,WAAW,EAAE,MAAM,cAAc,CAAA;AAG1D,sFAAsF;AACtF,eAAO,MAAM,gBAAgB,6GAEnB,CAAA;AAyCV;;;;;GAKG;AACH,wBAAgB,YAAY,CAAC,IAAI,EAAE,aAAa,EAAE,GAAG,EAAE,WAAW,GAAG,SAAS,GAAG,SAAS,CAkCzF;AAyCD,0DAA0D;AAC1D,wBAAgB,QAAQ,CAAC,IAAI,EAAE,aAAa,EAAE,GAAG,EAAE,WAAW,GAAG,SAAS,GAAG,SAAS,CAkBrF"}

package/dist/a2ui/table.js

@@ -0,0 +1,155 @@
+/**
+ * Table mappers — the one place a prefab component gains structure on the way
+ * out rather than losing it.
+ *
+ * The A2UI Basic catalog has no table component, so a table becomes a `Column`
+ * of `Row`s. For `DataTable` that would be a poor trade, because prefab's table
+ * is data-driven and flattening it would inline every row as its own component
+ * and lose the binding. A2UI's own answer is the child template: a `Column`
+ * whose `children` is `{ path, componentId }` instantiates one copy of the
+ * template component per item in a data-model list, and paths inside the
+ * template resolve relative to the current item. That maps onto `DataTable`
+ * exactly — one `Row` template, one `Text` per column bound to the column key —
+ * so the emitted surface stays as small and as reactive as the prefab original.
+ *
+ * The pattern follows `catalogs/basic/examples/18_track-list.json` in the A2UI
+ * specification, which is the normative example for templated lists.
+ */
+import { dynamicString, toBinding } from './expr.js';
+/** prefab table parts that only exist inside a `Table` and never map on their own. */
+export const TABLE_PART_TYPES = [
+    'TableHead', 'TableBody', 'TableFooter', 'TableRow', 'TableCell', 'TableHeader', 'ExpandableRow',
+];
+/** Read a `DataTable`'s serialized column definitions defensively. */
+function columnDefs(node) {
+    if (!Array.isArray(node.columns))
+        return [];
+    const defs = [];
+    for (const raw of node.columns) {
+        if (raw == null || typeof raw !== 'object')
+            continue;
+        const col = raw;
+        const key = typeof col.accessor === 'string' ? col.accessor : typeof col.key === 'string' ? col.key : undefined;
+        if (key == null)
+            continue;
+        defs.push({ key, header: typeof col.header === 'string' ? col.header : key });
+    }
+    return defs;
+}
+/**
+ * Resolve where the row list lives in the data model.
+ *
+ * `rows` is either a `{{ }}` expression already pointing at surface state, or a
+ * literal array, which is seeded into the data model under a generated key so
+ * the template has something to iterate.
+ */
+function rowsPointer(node, ctx) {
+    const rows = node.rows;
+    if (typeof rows === 'string') {
+        const bound = toBinding(rows);
+        if (bound.kind === 'binding')
+            return bound.value.path;
+        ctx.note('expression', 'DataTable', `rows expression "${rows}" is not a plain path; the table has no data source`);
+        return undefined;
+    }
+    if (Array.isArray(rows))
+        return ctx.bindData('rows', rows);
+    ctx.note('unsupported', 'DataTable', 'no rows to render');
+    return undefined;
+}
+/**
+ * `DataTable` → a header `Row` plus a templated `Column`.
+ *
+ * A column key containing a `.` addresses a nested field on the row. Relative
+ * paths inside a template are JSON Pointers too, so the dots become slashes.
+ */
+export function mapDataTable(node, ctx) {
+    const columns = columnDefs(node);
+    if (columns.length === 0) {
+        ctx.note('unsupported', 'DataTable', 'no usable column definitions');
+        return undefined;
+    }
+    const path = rowsPointer(node, ctx);
+    if (path == null)
+        return undefined;
+    const headerRow = ctx.push({
+        component: 'Row',
+        children: columns.map(c => ctx.push({ component: 'Text', text: c.header, variant: 'caption' })),
+        align: 'center',
+    });
+    const template = ctx.push({
+        component: 'Row',
+        children: columns.map(c => ctx.push({
+            component: 'Text',
+            // Relative pointer: no leading slash, so it resolves against the current row.
+            text: { path: c.key.split('.').join('/') },
+        })),
+        align: 'center',
+    });
+    // A2UI's templated-children form: one instance of `template` per item at `path`.
+    const list = ctx.push({ component: 'Column', children: { path, componentId: template } });
+    if (node.search === true || node.paginated === true) {
+        ctx.note('degraded', 'DataTable', 'search and pagination dropped; A2UI Basic has no table controls');
+    }
+    return { component: 'Column', children: [headerRow, list] };
+}
+// ── Static Table ─────────────────────────────────────────────────────────────
+/** Collect the `TableRow` nodes nested under a `Table`'s section wrappers. */
+function tableRows(node) {
+    const rows = [];
+    const visit = (n) => {
+        if (n.type === 'TableRow' || n.type === 'ExpandableRow') {
+            rows.push(n);
+            return;
+        }
+        if (Array.isArray(n.children))
+            for (const c of n.children)
+                visit(c);
+    };
+    if (Array.isArray(node.children))
+        for (const c of node.children)
+            visit(c);
+    return rows;
+}
+/**
+ * Emit one table cell.
+ *
+ * A cell holding components delegates to them; a cell holding only text becomes
+ * a `Text`, with header cells marked as captions so the header row still reads
+ * as a header after the table structure is gone.
+ */
+function cell(node, ctx) {
+    const isHeader = node.type === 'TableHeader';
+    if (Array.isArray(node.children) && node.children.length > 0) {
+        return ctx.single(node.children);
+    }
+    const raw = node.content ?? node.text ?? node.label;
+    if (typeof raw !== 'string' && typeof raw !== 'number' && typeof raw !== 'boolean')
+        return undefined;
+    const content = String(raw);
+    const text = dynamicString(content);
+    if (text == null) {
+        ctx.note('expression', node.type, `cell expression "${content}" has no A2UI equivalent`);
+        return undefined;
+    }
+    return ctx.push({ component: 'Text', text, ...(isHeader && { variant: 'caption' }) });
+}
+/** `Table` → a `Column` of `Row`s, one per `TableRow`. */
+export function mapTable(node, ctx) {
+    const rows = tableRows(node);
+    const emitted = [];
+    for (const row of rows) {
+        const cells = Array.isArray(row.children) ? row.children : [];
+        const ids = cells.map(c => cell(c, ctx)).filter((id) => id != null);
+        if (ids.length === 0)
+            continue;
+        emitted.push(ctx.push({ component: 'Row', children: ids, align: 'center' }));
+    }
+    if (emitted.length === 0) {
+        ctx.note('unsupported', 'Table', 'no rows with renderable cells');
+        return undefined;
+    }
+    ctx.note('degraded', 'Table', 'rendered as a Column of Rows; column widths do not align');
+    return { component: 'Column', children: emitted };
+}
+//# sourceMappingURL=table.js.map

package/dist/a2ui/table.js.map

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

package/dist/a2ui/types.d.ts

@@ -0,0 +1,174 @@
+/**
+ * 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.
+ */
+/** Protocol version stamped on every emitted message. */
+export declare const A2UI_VERSION = "v1.0";
+/** Canonical id of the A2UI Basic catalog, the component set prefab targets. */
+export declare const A2UI_BASIC_CATALOG = "https://a2ui.org/specification/v1_0/catalogs/basic/catalog.json";
+/** MIME type identifying an A2UI payload over MCP. */
+export declare const A2UI_MIME = "application/a2ui+json";
+/** URI scheme for A2UI resources served over MCP. */
+export declare const A2UI_SCHEME = "a2ui://";
+/** The reserved root component id every surface starts from. */
+export declare const A2UI_ROOT_ID = "root";
+/** A JSON Pointer binding into the surface data model. */
+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}.
+ */
+export interface A2uiFunctionCall {
+    call: string;
+    catalogId?: string;
+    args?: Record<string, A2uiDynamicValue>;
+}
+export type A2uiDynamicString = string | A2uiDataBinding | A2uiFunctionCall;
+export type A2uiDynamicNumber = number | A2uiDataBinding | A2uiFunctionCall;
+export type A2uiDynamicBoolean = boolean | A2uiDataBinding | A2uiFunctionCall;
+export type A2uiDynamicValue = string | number | boolean | null | A2uiDataBinding | A2uiFunctionCall;
+/** Dispatches a named event back to the agent. */
+export interface A2uiEventAction {
+    event: {
+        name: string;
+        userMessage?: A2uiDynamicString;
+        context?: Record<string, A2uiDynamicValue>;
+    };
+}
+/** Runs a renderer-side catalog function without involving the agent. */
+export interface A2uiFunctionAction {
+    functionCall: A2uiFunctionCall;
+}
+export type A2uiAction = A2uiEventAction | A2uiFunctionAction;
+/** Accessibility attributes carried on any component. */
+export interface A2uiAccessibility {
+    label?: A2uiDynamicString;
+    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.
+ */
+export interface A2uiComponentProps {
+    component: string;
+    catalogId?: string;
+    accessibility?: A2uiAccessibility;
+    metadata?: {
+        extensions?: Record<string, unknown>;
+    };
+    [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`.
+ */
+export interface A2uiComponent extends A2uiComponentProps {
+    id: string;
+}
+/** A template that instantiates one component per item in a data-model list. */
+export interface A2uiChildTemplate {
+    componentId: string;
+    path: string;
+}
+export type A2uiChildList = string[] | A2uiChildTemplate;
+export interface A2uiCreateSurface {
+    surfaceId: string;
+    catalogId?: string;
+    sendDataModel?: boolean;
+    components?: A2uiComponent[];
+    dataModel?: Record<string, unknown>;
+    metadata?: {
+        extensions?: Record<string, unknown>;
+    };
+}
+export interface A2uiUpdateComponents {
+    surfaceId: string;
+    components: A2uiComponent[];
+}
+export interface A2uiUpdateDataModel {
+    surfaceId: string;
+    /** Where in the data model to write. Omitted or `/` means the whole model. */
+    path?: string;
+    /** The data to write. An explicit `null` deletes whatever sits at `path`. */
+    value: unknown;
+}
+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`.
+ */
+export type A2uiMessage = {
+    version: string;
+    createSurface: A2uiCreateSurface;
+} | {
+    version: string;
+    updateComponents: A2uiUpdateComponents;
+} | {
+    version: string;
+    updateDataModel: A2uiUpdateDataModel;
+} | {
+    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`.
+ */
+export type A2uiMessageList = {
+    messages: A2uiMessage[];
+};
+/** Why a prefab node could not cross into A2UI unchanged. */
+export type A2uiDiagnosticKind = 
+/** No Basic-catalog component covers this type; it was rendered as something simpler. */
+'degraded'
+/** No sensible degradation exists; the node was dropped. */
+ | 'unsupported'
+/** A `{{ }}` expression was richer than a JSON Pointer; the binding was dropped. */
+ | 'expression'
+/** A prefab action has no agent-side event equivalent. */
+ | 'action';
+export interface A2uiDiagnostic {
+    kind: A2uiDiagnosticKind;
+    /** The prefab component type or action name the diagnostic is about. */
+    subject: string;
+    /** What the emitter did instead. */
+    detail: string;
+}
+//# sourceMappingURL=types.d.ts.map

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

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

package/dist/a2ui/types.js

@@ -0,0 +1,35 @@
+/**
+ * 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.
+ */
+// ── Constants ────────────────────────────────────────────────────────────────
+/** Protocol version stamped on every emitted message. */
+export const A2UI_VERSION = 'v1.0';
+/** Canonical id of the A2UI Basic catalog, the component set prefab targets. */
+export const A2UI_BASIC_CATALOG = 'https://a2ui.org/specification/v1_0/catalogs/basic/catalog.json';
+/** MIME type identifying an A2UI payload over MCP. */
+export const A2UI_MIME = 'application/a2ui+json';
+/** URI scheme for A2UI resources served over MCP. */
+export const A2UI_SCHEME = 'a2ui://';
+/** The reserved root component id every surface starts from. */
+export const A2UI_ROOT_ID = 'root';
+//# sourceMappingURL=types.js.map

package/dist/a2ui/types.js.map

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

package/dist/a2ui.min.js

@@ -0,0 +1 @@
+(()=>{var{defineProperty:A,getOwnPropertyNames:z,getOwnPropertyDescriptor:Y}=Object,X=Object.prototype.hasOwnProperty;function Z(e){return this[e]}var Q=(e)=>{var n=(D??=new WeakMap).get(e),t;if(n)return n;if(n=A({},"__esModule",{value:!0}),e&&typeof e==="object"||typeof e==="function"){for(var r of z(e))if(!X.call(n,r))A(n,r,{get:Z.bind(e,r),enumerable:!(t=Y(e,r))||t.enumerable})}return D.set(e,n),n},D;var ee=(e)=>e;function ne(e,n){this[e]=ee.bind(null,n)}var te=(e,n)=>{for(var t in n)A(e,t,{get:n[t],enumerable:!0,configurable:!0,set:ne.bind(n,t)})};var De={};te(De,{default:()=>Ie,emit:()=>G,envelope:()=>K});var I={silent:0,error:1,warn:2,info:3,debug:4},re="warn";function y(e){let n=e?`[prefab:${e}]`:"[prefab]",t=(r,i,o)=>{if(I[r]>I[re])return;console[r](`${n} ${i}`,...o)};return{error:(r,...i)=>t("error",r,i),warn:(r,...i)=>t("warn",r,i),info:(r,...i)=>t("info",r,i),debug:(r,...i)=>t("debug",r,i)}}var Me=y();var ie=/^\s*\{\{\s*(.+?)\s*\}\}\s*$/s,oe=/^[A-Za-z_$][\w$]*(?:\.(?:[A-Za-z_$][\w$]*|\d+))*$/;function b(e){return e.replace(/~/g,"~0").replace(/\//g,"~1")}function ae(e){return"/"+e.map(b).join("/")}function se(e){return e.startsWith("state.")?e.slice(6):e}function d(e){let n=ie.exec(e);if(n==null){if(e.includes("{{"))return{kind:"unbindable",expression:e};return{kind:"literal",value:e}}let t=se(n[1].trim());if(!oe.test(t))return{kind:"unbindable",expression:n[1].trim()};return{kind:"binding",value:{path:ae(t.split("."))}}}function c(e){if(e==null)return;let n=d(e);if(n.kind==="literal")return n.value;if(n.kind==="binding")return n.value;return}var ue=["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"],le=new Map(ue.map((e)=>[O(e),e])),ce={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",arrowleft:"arrowBack",arrowright:"arrowForward",chevronleft:"arrowBack",chevronright:"arrowForward",x:"close",plus:"add",trash:"delete",trash2:"delete",ellipsisvertical:"moreVert",ellipsis:"moreHoriz",morehorizontal:"moreHoriz",morevertical:"moreVert",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"};function O(e){return e.replace(/[\s._-]/g,"").toLowerCase()}function M(e){let n=O(e);return le.get(n)??ce[n]}var R=["TableHead","TableBody","TableFooter","TableRow","TableCell","TableHeader","ExpandableRow"];function de(e){if(!Array.isArray(e.columns))return[];let n=[];for(let t of e.columns){if(t==null||typeof t!=="object")continue;let r=t,i=typeof r.accessor==="string"?r.accessor:typeof r.key==="string"?r.key:void 0;if(i==null)continue;n.push({key:i,header:typeof r.header==="string"?r.header:i})}return n}function pe(e,n){let t=e.rows;if(typeof t==="string"){let r=d(t);if(r.kind==="binding")return r.value.path;n.note("expression","DataTable",`rows expression "${t}" is not a plain path; the table has no data source`);return}if(Array.isArray(t))return n.bindData("rows",t);n.note("unsupported","DataTable","no rows to render");return}function E(e,n){let t=de(e);if(t.length===0){n.note("unsupported","DataTable","no usable column definitions");return}let r=pe(e,n);if(r==null)return;let i=n.push({component:"Row",children:t.map((l)=>n.push({component:"Text",text:l.header,variant:"caption"})),align:"center"}),o=n.push({component:"Row",children:t.map((l)=>n.push({component:"Text",text:{path:l.key.split(".").join("/")}})),align:"center"}),u=n.push({component:"Column",children:{path:r,componentId:o}});if(e.search===!0||e.paginated===!0)n.note("degraded","DataTable","search and pagination dropped; A2UI Basic has no table controls");return{component:"Column",children:[i,u]}}function fe(e){let n=[],t=(r)=>{if(r.type==="TableRow"||r.type==="ExpandableRow"){n.push(r);return}if(Array.isArray(r.children))for(let i of r.children)t(i)};if(Array.isArray(e.children))for(let r of e.children)t(r);return n}function ge(e,n){let t=e.type==="TableHeader";if(Array.isArray(e.children)&&e.children.length>0)return n.single(e.children);let r=e.content??e.text??e.label;if(typeof r!=="string"&&typeof r!=="number"&&typeof r!=="boolean")return;let i=String(r),o=c(i);if(o==null){n.note("expression",e.type,`cell expression "${i}" has no A2UI equivalent`);return}return n.push({component:"Text",text:o,...t&&{variant:"caption"}})}function P(e,n){let t=fe(e),r=[];for(let i of t){let u=(Array.isArray(i.children)?i.children:[]).map((l)=>ge(l,n)).filter((l)=>l!=null);if(u.length===0)continue;r.push(n.push({component:"Row",children:u,align:"center"}))}if(r.length===0){n.note("unsupported","Table","no rows with renderable cells");return}return n.note("degraded","Table","rendered as a Column of Rows; column widths do not align"),{component:"Column",children:r}}function a(e,...n){for(let t of n){let r=e[t];if(typeof r==="string"||typeof r==="number"||typeof r==="boolean")return String(r)}return}function s(e,n,t){let r=a(e,...t?.keys??["content","text","label","title"]);if(r==null){n.note("unsupported",e.type,"no text content to render");return}let i=d(r);if(i.kind==="unbindable")n.note("expression",e.type,`"${i.expression}" is richer than a JSON Pointer; the text was left as written`);let o=t?.prefix??"",u=t?.suffix??"";if(i.kind==="binding"){if(o!==""||u!=="")n.note("degraded",e.type,"Markdown emphasis dropped: the text is a data binding");return{component:"Text",text:i.value,...t?.variant!=null&&{variant:t.variant}}}let l=i.kind==="literal"?i.value:r;return{component:"Text",text:`${o}${l}${u}`,...t?.variant!=null&&{variant:t.variant}}}var me={start:"start",end:"end",center:"center",between:"spaceBetween",around:"spaceAround",evenly:"spaceEvenly",spaceBetween:"spaceBetween",spaceAround:"spaceAround",spaceEvenly:"spaceEvenly"},he={start:"start",end:"end",center:"center",stretch:"stretch",baseline:"baseline"};function g(e){return(n,t)=>{let r=t.children(n.children);if(r.length===0){t.note("unsupported",n.type,`${e} requires at least one child and none survived`);return}let i=typeof n.justify==="string"?me[n.justify]:void 0,o=typeof n.align==="string"?he[n.align]:void 0;return{component:e,children:r,...i!=null&&{justify:i},...o!=null&&{align:o}}}}var Ae=["Div","Container","Stack","Grid","GridItem","Page","Pages","Dashboard","DashboardItem","MasterDetail","Detail","Form","Fieldset","CardContent","CardHeader","CardFooter","Accordion","Carousel","SelectGroup","ComboboxGroup","Section","Article","Aside","Header","Footer","Nav","Span"],ye=["ButtonGroup","Toolbar","Inline"],be={H1:"# ",H2:"## ",H3:"### ",H4:"#### ",H5:"##### ",H6:"###### "},B={Heading:(e,n)=>{let t=typeof e.level==="number"?Math.min(6,Math.max(1,e.level)):1;return s(e,n,{prefix:`${"#".repeat(t)} `})},Text:(e,n)=>s(e,n),P:(e,n)=>s(e,n),Lead:(e,n)=>s(e,n),Large:(e,n)=>s(e,n),Small:(e,n)=>s(e,n,{variant:"caption"}),Muted:(e,n)=>s(e,n,{variant:"caption"}),Label:(e,n)=>s(e,n,{variant:"caption"}),TableCaption:(e,n)=>s(e,n,{variant:"caption"}),BlockQuote:(e,n)=>s(e,n,{prefix:"> "}),Code:(e,n)=>s(e,n,{prefix:"`",suffix:"`"}),Kbd:(e,n)=>s(e,n,{prefix:"`",suffix:"`"}),Markdown:(e,n)=>s(e,n),Badge:(e,n)=>s(e,n,{keys:["label","content"],variant:"caption"}),AlertTitle:(e,n)=>s(e,n,{prefix:"**",suffix:"**"}),AlertDescription:(e,n)=>s(e,n)};for(let[e,n]of Object.entries(be))B[e]=(t,r)=>s(t,r,{prefix:n});function v(e){return(n,t)=>{let r=c(a(n,"src","url"));if(r==null){t.note("unsupported",n.type,"no resolvable source URL");return}let i=e==="Video"?void 0:c(a(n,"alt","description")),o=e==="Video"?c(a(n,"poster","posterUrl")):void 0;return{component:e,url:r,...i!=null&&{description:i},...o!=null&&{posterUrl:o}}}}var ve={text:"shortText",email:"shortText",url:"shortText",tel:"shortText",search:"shortText",password:"obscured",number:"number"};function f(e){let n=typeof e.name==="string"?e.name:void 0;if(n==null)return;let t=d(`{{ ${n} }}`);return t.kind==="binding"?t.value:void 0}function Ce(e,n){let t=Array.isArray(e.children)?e.children:[],r=[];for(let i of t){let o=a(i,"value");if(o==null){n.note("degraded",e.type,`dropped a ${i.type} child that carries no option value`);continue}r.push({label:a(i,"label")??o,value:o})}return r}function C(e,n,t){if(a(e,"label","name")==null)n.note("degraded",e.type,"no label available for the DateTimeInput");return{component:"DateTimeInput",value:f(e)??"",...t}}function x(e){return(n,t)=>{let r=c(a(n,"label","name"));if(r==null){t.note("unsupported",n.type,"ChoicePicker requires a label and none could be derived");return}let i=Ce(n,t);if(i.length===0){t.note("unsupported",n.type,"no options to choose from");return}let o=f(n);return{component:"ChoicePicker",label:r,variant:e,options:i,...o!=null&&{value:o}}}}function N(e,n,t){let r=c(a(e,"label","name"));if(r==null){n.note("unsupported",e.type,"TextField requires a label and none could be derived");return}let i=f(e),o=c(a(e,"placeholder"));return{component:"TextField",label:r,variant:t,...i!=null&&{value:i},...o!=null&&{placeholder:o}}}var w={Input:(e,n)=>{let t=typeof e.inputType==="string"?e.inputType:"text",r=ve[t];if(r==null)n.note("degraded",e.type,`inputType "${t}" has no A2UI variant; used shortText`);return N(e,n,r??"shortText")},Textarea:(e,n)=>N(e,n,"longText"),Checkbox:(e,n)=>{let t=c(a(e,"label","name"));if(t==null){n.note("unsupported",e.type,"CheckBox requires a label and none could be derived");return}return{component:"CheckBox",label:t,value:f(e)??!1}},Slider:(e,n)=>{let t=typeof e.max==="number"?e.max:void 0;if(t==null){n.note("unsupported",e.type,"Slider requires a max and prefab left it open");return}let r=c(a(e,"label","name")),i=typeof e.min==="number"?e.min:void 0,o=typeof e.step==="number"?e.step:void 0,u=o!=null&&o>0?Math.max(1,Math.round((t-(i??0))/o)):void 0;return{component:"Slider",max:t,value:f(e)??i??0,...r!=null&&{label:r},...i!=null&&{min:i},...u!=null&&{steps:u}}},Button:(e,n)=>{let t=a(e,"label","content")??"Button",r=n.action(e.onClick,"Button")??(e.submit===!0?{event:{name:"submit"}}:void 0);if(r==null){n.note("unsupported",e.type,"Button requires an action and none could be derived");return}let i=n.push({component:"Text",text:c(t)??t}),o=e.variant==="link"||e.variant==="ghost"?"borderless":e.variant==="default"?"primary":"default";return{component:"Button",child:i,action:r,variant:o}},Link:(e,n)=>{let t=a(e,"href","url");if(t==null){n.note("unsupported",e.type,"no href to open");return}let r=a(e,"content","label")??t;return{component:"Button",child:n.push({component:"Text",text:c(r)??r}),variant:"borderless",action:{functionCall:{call:"openUrl",args:{url:t}}}}},DatePicker:(e,n)=>C(e,n,{enableDate:!0}),TimePicker:(e,n)=>C(e,n,{enableTime:!0}),DateTimePicker:(e,n)=>C(e,n,{enableDate:!0,enableTime:!0}),Select:x("mutuallyExclusive"),RadioGroup:x("mutuallyExclusive"),Combobox:x("mutuallyExclusive")};w.Switch=w.Checkbox;var xe={Card:(e,n)=>{let t=n.single(e.children);if(t==null){n.note("unsupported","Card","Card requires a child and it had none");return}return{component:"Card",child:t}},Alert:(e,n)=>{let t=n.single(e.children);if(t==null){n.note("unsupported","Alert","no alert body to render");return}let r=typeof e.variant==="string"?e.variant:"default";return n.note("degraded","Alert",`variant "${r}" rendered as a plain Card`),{component:"Card",child:t}},Separator:()=>({component:"Divider"}),Divider:()=>({component:"Divider"}),Icon:(e,n)=>{let t=a(e,"name","icon");if(t==null){n.note("unsupported","Icon","no icon name");return}let r=M(t);if(r==null){n.note("unsupported","Icon",`"${t}" has no equivalent in the A2UI icon set`);return}if(r!==t)n.note("degraded","Icon",`"${t}" mapped to the A2UI icon "${r}"`);return{component:"Icon",name:r}},Metric:(e,n)=>{let t=[],r=a(e,"label","title");if(r!=null)t.push(n.push({component:"Text",text:c(r)??r,variant:"caption"}));let i=a(e,"value");if(i!=null)t.push(n.push({component:"Text",text:c(i)??i}));if(t.length===0){n.note("unsupported","Metric","neither a label nor a value to render");return}return n.note("degraded","Metric","rendered as a Column of Text; trend and delta styling dropped"),{component:"Column",children:t}},Tabs:(e,n)=>{let t=Array.isArray(e.children)?e.children:[],r=[];for(let i of t){let o=n.single(i.children);if(o==null)continue;r.push({title:a(i,"title")??"Tab",child:o})}if(r.length===0){n.note("unsupported","Tabs","no tab had renderable content");return}return{component:"Tabs",tabs:r}},Dialog:(e,n)=>{let t=n.single(e.children);if(t==null){n.note("unsupported","Dialog","no dialog body to render");return}let r=e.trigger,i=r!=null?n.child(r):n.push({component:"Text",text:a(e,"title")??"Open"});if(i==null){n.note("unsupported","Dialog","Modal requires a trigger and none could be emitted");return}return{component:"Modal",trigger:i,content:t}},AccordionItem:(e,n)=>{let t=[],r=a(e,"title");if(r!=null)t.push(n.push({component:"Text",text:r,variant:"caption"}));if(t.push(...n.children(e.children)),t.length===0){n.note("unsupported","AccordionItem","nothing to render");return}return n.note("degraded","AccordionItem","rendered expanded; A2UI Basic has no disclosure component"),{component:"Column",children:t}}},m={Column:g("Column"),Row:g("Row"),...B,...w,...xe,Image:v("Image"),Video:v("Video"),Audio:v("AudioPlayer"),Table:P,DataTable:E};for(let e of Ae)m[e]??=g("Column");for(let e of ye)m[e]??=g("Row");var we=new Set(["Tab","SelectOption","ComboboxOption","Radio","Option",...R]),ke={LineChart:"charts",BarChart:"charts",AreaChart:"charts",PieChart:"charts",ScatterChart:"charts",RadarChart:"charts",RadialChart:"charts",Histogram:"charts",Sparkline:"charts",Svg:"inline vector graphics",Mermaid:"diagrams",Embed:"embedded frames",DropZone:"file uploads",Ring:"progress rings",Loader:"loading indicators",Progress:"progress bars"};function L(e){return m[e]}function U(e){return we.has(e)}function _(){return Object.keys(m).sort()}function F(e,n){let t=ke[e.type];if(t!=null){n.note("unsupported",e.type,`${t} are outside the A2UI Basic catalog`);return}if(Array.isArray(e.children)&&e.children.length>0){let r=n.children(e.children);if(r.length>0)return n.note("degraded",e.type,"no Basic-catalog equivalent; flattened to a Column"),{component:"Column",children:r}}if(a(e,"content","text","label","title")!=null)return n.note("degraded",e.type,"no Basic-catalog equivalent; rendered as Text"),s(e,n);n.note("unsupported",e.type,"no Basic-catalog equivalent and nothing to render");return}var p="v1.0",h="https://a2ui.org/specification/v1_0/catalogs/basic/catalog.json",J="application/a2ui+json",j="a2ui://",k="root";var Te=y("a2ui");function Se(e){let n=e.children;if(e.type==="Div"&&typeof e.cssClass==="string"&&e.cssClass.startsWith("pf-app-root")&&Array.isArray(n)&&n.length===1)return n[0];return e}class H{warn;components=new Map;dataModel={};used=new Set([k]);diagnostics=[];counter=0;constructor(e){this.warn=e}note(e,n,t){if(this.diagnostics.push({kind:e,subject:n,detail:t}),this.warn)Te.warn(`${e}: ${n} — ${t}`)}allocate(e){let n=typeof e?.id==="string"&&e.id.length>0?e.id:void 0;if(n!=null&&!this.used.has(n))return this.used.add(n),n;let t;do this.counter+=1,t=`c${this.counter}`;while(this.used.has(t));return this.used.add(t),t}push(e){let n=this.allocate();return this.components.set(n,{id:n,...e}),n}bindData(e,n){let t=e,r=0;while(t in this.dataModel)r+=1,t=`${e}${r}`;return this.dataModel[t]=n,`/${b(t)}`}child(e){return this.emit(e,!1)}children(e){if(!Array.isArray(e))return[];let n=[];for(let t of e){if(t==null||typeof t!=="object")continue;let r=this.emit(t,!1);if(r!=null)n.push(r)}return n}single(e){let n=this.children(e);if(n.length===0)return;if(n.length===1)return n[0];return this.push({component:"Column",children:n})}action(e,n){if(e==null)return;if(Array.isArray(e)){if(e.length===0)return;if(e.length>1)this.note("action",n,`${e.length} actions were bound; A2UI carries one, so the rest were dropped`);return this.action(e[0],n)}if(typeof e!=="object")return;let t=e,r=typeof t.action==="string"?t.action:void 0;if(r==null)return;switch(r){case"toolCall":{let i=typeof t.tool==="string"?t.tool:void 0;if(i==null)return;let o=this.eventContext(t.arguments,n);return{event:{name:i,...o!=null&&{context:o}}}}case"sendMessage":return{event:{name:"sendMessage",context:{message:typeof t.message==="string"?t.message:""}}};case"openLink":{let i=typeof t.url==="string"?t.url:typeof t.href==="string"?t.href:void 0;if(i==null)return;return{functionCall:{call:"openUrl",args:{url:i}}}}default:{this.note("action",n,`"${r}" has no renderer-side equivalent; emitted as an agent event`);let{action:i,...o}=t,u=this.eventContext(o,n);return{event:{name:r,...u!=null&&{context:u}}}}}}eventContext(e,n){if(e==null||typeof e!=="object"||Array.isArray(e))return;let t={};for(let[r,i]of Object.entries(e)){if(typeof i==="number"||typeof i==="boolean"||i===null){t[r]=i;continue}if(typeof i!=="string"){this.note("action",n,`argument "${r}" is not a scalar and was dropped from the event context`);continue}let o=d(i);if(o.kind==="unbindable"){this.note("action",n,`argument "${r}" uses "${o.expression}", which A2UI cannot bind; it was dropped`);continue}t[r]=o.kind==="binding"?o.value:o.value}return Object.keys(t).length>0?t:void 0}emit(e,n){if(typeof e.type!=="string")return;if(U(e.type)){this.note("unsupported",e.type,"only meaningful inside its parent; emitted standalone it has no meaning");return}let t=n?k:this.allocate(e);this.components.set(t,void 0);let i=(L(e.type)??F)(e,this);if(i==null){if(this.components.delete(t),!n)this.used.delete(t);return}return this.components.set(t,{id:t,...i}),t}finish(e,n){let t=n.surfaceId??"prefab";if(this.emit(Se(e.view),!0)==null)this.note("unsupported","view","nothing in the view could be expressed in A2UI; the surface is empty");let i=[];for(let S of this.components.values())if(S!=null)i.push(S);let o={...this.dataModel,...e.state??{}},u=Object.keys(o).length>0,l=[],T=n.catalogId??h;if(n.stream===!0){if(l.push({version:p,createSurface:{surfaceId:t,catalogId:T,...n.sendDataModel===!0&&{sendDataModel:!0}}}),i.length>0)l.push({version:p,updateComponents:{surfaceId:t,components:i}});if(u)l.push({version:p,updateDataModel:{surfaceId:t,value:o}})}else l.push({version:p,createSurface:{surfaceId:t,catalogId:T,...n.sendDataModel===!0&&{sendDataModel:!0},...i.length>0&&{components:i},...u&&{dataModel:o}}});return{messages:l,diagnostics:this.diagnostics}}}function V(e,n){let t=n??{};return new H(t.warn===!0).finish(e,t)}var q="0.3.10";function G(e,n){if(e==null||typeof e!=="object"||!("view"in e))throw TypeError('PrefabA2UI.emit: expected a $prefab payload with a "view"');return V(e,n)}function K(e){return{messages:e}}var W={emit:G,envelope:K,mappedTypes:_,VERSION:q,A2UI_VERSION:p,A2UI_BASIC_CATALOG:h,A2UI_MIME:J,A2UI_SCHEME:j},Ie=W;if(typeof window<"u")window.PrefabA2UI=W;})();

package/dist/app.d.ts

@@ -9,6 +9,7 @@ import type { ComponentJSON } from './core/component.js';
 import type { Action, ActionJSON } from './actions/types.js';
 import type { PipeFn } from './rx/pipes.js';
 import { VERSION, PROTOCOL_VERSION } from './core/version.js';
+import type { A2uiEmitOptions, A2uiEmitResult } from './a2ui/emit.js';
 export { VERSION, PROTOCOL_VERSION };
 export interface Theme {
     light?: Record<string, string>;
@@ -104,6 +105,22 @@ export declare class PrefabApp {
      * This is what gets sent over MCP or stored as a resource.
      */
     toJSON(): PrefabWireFormat;
+    /**
+     * Serialize to A2UI messages — the second wire format this tree can speak.
+     *
+     * `toJSON()` targets prefab's own renderer; this targets the A2UI renderers,
+     * which draw native widgets from a flat component list rather than running
+     * prefab's renderer in an iframe. The catalogs are not the same size, so the
+     * result carries `diagnostics` describing every component that had to
+     * degrade, and callers that care should read it.
+     *
+     * @example
+     * ```ts
+     * const { messages, diagnostics } = app.toA2UI()
+     * if (diagnostics.some(d => d.kind === 'unsupported')) rethinkTheView()
+     * ```
+     */
+    toA2UI(options?: A2uiEmitOptions): A2uiEmitResult;
     /**
      * Serialize as a ready-to-return MCP tool result.
      *

package/dist/app.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"app.d.ts","sourceRoot":"","sources":["../src/app.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"app.d.ts","sourceRoot":"","sources":["../src/app.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,KAAK,SAAS,EAAE,MAAM,qBAAqB,CAAA;AACpD,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAA;AACxD,OAAO,KAAK,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,oBAAoB,CAAA;AAE5D,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,eAAe,CAAA;AAG3C,OAAO,EAAE,OAAO,EAAE,gBAAgB,EAAE,MAAM,mBAAmB,CAAA;AAE7D,OAAO,KAAK,EAAE,eAAe,EAAE,cAAc,EAAE,MAAM,gBAAgB,CAAA;AAKrE,OAAO,EAAE,OAAO,EAAE,gBAAgB,EAAE,CAAA;AAIpC,MAAM,WAAW,KAAK;IACpB,KAAK,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;IAC9B,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;CAC9B;AAED,0EAA0E;AAC1E,MAAM,MAAM,SAAS,GAAG,OAAO,GAAG,MAAM,CAAA;AAIxC,2EAA2E;AAC3E,MAAM,WAAW,WAAW;IAC1B,iFAAiF;IACjF,eAAe,CAAC,EAAE,MAAM,CAAA;IACxB,uCAAuC;IACvC,SAAS,CAAC,EAAE,MAAM,CAAA;IAClB,8DAA8D;IAC9D,SAAS,CAAC,EAAE,MAAM,CAAA;CACnB;AAID;;;;;;;;;;;;;;;;GAgBG;AAEH,MAAM,MAAM,gBAAgB,GAAG;IAC7B,OAAO,EAAE;QAAE,OAAO,EAAE,MAAM,CAAA;KAAE,CAAA;IAC5B,IAAI,EAAE,aAAa,CAAA;IACnB,KAAK,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;IAC/B,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,aAAa,CAAC,CAAA;IACpC,WAAW,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,UAAU,GAAG,UAAU,EAAE,CAAC,CAAA;IACvD,OAAO,CAAC,EAAE,UAAU,GAAG,UAAU,EAAE,CAAA;IACnC,2FAA2F;IAC3F,GAAG,CAAC,EAAE,MAAM,EAAE,CAAA;IACd,4EAA4E;IAC5E,WAAW,CAAC,EAAE,MAAM,EAAE,CAAA;IACtB,wEAAwE;IACxE,IAAI,CAAC,EAAE,SAAS,CAAA;IAChB,mEAAmE;IACnE,KAAK,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;IAC9B,yCAAyC;IACzC,MAAM,CAAC,EAAE,WAAW,CAAA;CACrB,CAAA;AAID,MAAM,WAAW,gBAAgB;IAC/B,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,IAAI,EAAE,SAAS,CAAA;IACf,KAAK,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;IAC/B,KAAK,CAAC,EAAE,KAAK,CAAA;IACb,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,SAAS,CAAC,CAAA;IAChC,gFAAgF;IAChF,GAAG,CAAC,EAAE,MAAM,EAAE,CAAA;IACd,6DAA6D;IAC7D,WAAW,CAAC,EAAE,MAAM,EAAE,CAAA;IACtB,OAAO,CAAC,EAAE,MAAM,EAAE,CAAA;IAClB,yDAAyD;IACzD,IAAI,CAAC,EAAE,SAAS,CAAA;IAChB,OAAO,CAAC,EAAE,MAAM,GAAG,MAAM,EAAE,CAAA;IAC3B,WAAW,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,EAAE,CAAC,CAAA;IAC/C,QAAQ,CAAC,EAAE,MAAM,CAAA;IACjB,+FAA+F;IAC/F,KAAK,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;IAC9B,yCAAyC;IACzC,MAAM,CAAC,EAAE,WAAW,CAAA;CACrB;AAED,qBAAa,SAAS;IACpB,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAA;IACtB,QAAQ,CAAC,IAAI,EAAE,SAAS,CAAA;IACxB,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;IACxC,QAAQ,CAAC,KAAK,CAAC,EAAE,KAAK,CAAA;IACtB,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,SAAS,CAAC,CAAA;IACzC,QAAQ,CAAC,GAAG,CAAC,EAAE,MAAM,EAAE,CAAA;IACvB,QAAQ,CAAC,WAAW,CAAC,EAAE,MAAM,EAAE,CAAA;IAC/B,QAAQ,CAAC,OAAO,CAAC,EAAE,MAAM,EAAE,CAAA;IAC3B,QAAQ,CAAC,IAAI,CAAC,EAAE,SAAS,CAAA;IACzB,QAAQ,CAAC,OAAO,CAAC,EAAE,MAAM,GAAG,MAAM,EAAE,CAAA;IACpC,QAAQ,CAAC,WAAW,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,EAAE,CAAC,CAAA;IACxD,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,CAAA;IAC1B,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;IACvC,QAAQ,CAAC,MAAM,CAAC,EAAE,WAAW,CAAA;gBAEjB,IAAI,EAAE,gBAAgB;IAwBlC;;;OAGG;IACH,MAAM,IAAI,gBAAgB;IA4D1B;;;;;;;;;;;;;;OAcG;IACH,MAAM,CAAC,OAAO,CAAC,EAAE,eAAe,GAAG,cAAc;IAIjD;;;;;;;;;;OAUG;IACH,WAAW,IAAI;QAAE,OAAO,EAAE;YAAE,IAAI,EAAE,MAAM,CAAC;YAAC,IAAI,EAAE,MAAM,CAAA;SAAE,EAAE,CAAC;QAAC,iBAAiB,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;KAAE;IAQxG;;;;;;;OAOG;IACH,MAAM,CAAC,IAAI,CAAC,EAAE;QAAE,UAAU,CAAC,EAAE,MAAM,CAAC;QAAC,MAAM,CAAC,EAAE,OAAO,CAAC;QAAC,aAAa,CAAC,EAAE,OAAO,CAAA;KAAE,GAAG,MAAM;CA6D1F"}

package/dist/app.js

@@ -9,6 +9,7 @@ import { drainAutoState } from './rx/state-collector.js';
 import { compileThemeCss } from './core/theme-css.js';
 import { escapeHtml } from './core/escape.js';
 import { VERSION, PROTOCOL_VERSION } from './core/version.js';
+import { emitA2UI } from './a2ui/emit.js';
 // Version constants live in ./core/version.ts (single source of truth, updated
 // at release time). Re-exported so existing `from './app.js'` imports and the
 // package's public API keep working.
@@ -109,6 +110,24 @@ export class PrefabApp {
             wire.layout = this.layout;
         return wire;
     }
+    /**
+     * Serialize to A2UI messages — the second wire format this tree can speak.
+     *
+     * `toJSON()` targets prefab's own renderer; this targets the A2UI renderers,
+     * which draw native widgets from a flat component list rather than running
+     * prefab's renderer in an iframe. The catalogs are not the same size, so the
+     * result carries `diagnostics` describing every component that had to
+     * degrade, and callers that care should read it.
+     *
+     * @example
+     * ```ts
+     * const { messages, diagnostics } = app.toA2UI()
+     * if (diagnostics.some(d => d.kind === 'unsupported')) rethinkTheView()
+     * ```
+     */
+    toA2UI(options) {
+        return emitA2UI(this.toJSON(), options);
+    }
     /**
      * Serialize as a ready-to-return MCP tool result.
      *

package/dist/app.js.map

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

package/dist/auto/form.d.ts

@@ -5,6 +5,19 @@
  */
 import { type ContainerComponent } from '../core/component.js';
 import type { Action } from '../actions/types.js';
+/** One choice offered by a field carrying {@link AutoFormField.options}. */
+export interface AutoFormOption {
+    value: string;
+    label?: string;
+}
+/**
+ * One field in an auto-generated form.
+ *
+ * The same definition drives both delivery paths: {@link autoForm} renders it as
+ * prefab components, and `formSchema` in `src/mcp/input-required.ts` derives the
+ * restricted elicitation JSON Schema from it for hosts with no UI surface. Keep
+ * anything added here expressible in both.
+ */
 export interface AutoFormField {
     /** Field name (used as the key in submitted data). */
     name: string;
@@ -16,6 +29,18 @@ export interface AutoFormField {
     placeholder?: string;
     /** Whether the field is required. */
     required?: boolean;
+    /** Longer help text. Becomes the schema `description` on the elicitation path. */
+    description?: string;
+    /** Fixed set of choices. Renders as a Select and becomes an enum on the wire. */
+    options?: AutoFormOption[];
+    /** Allow several choices. Only meaningful alongside `options`. */
+    multiple?: boolean;
+    /** Inclusive lower bound for a numeric field, or minimum length for a string. */
+    min?: number;
+    /** Inclusive upper bound for a numeric field, or maximum length for a string. */
+    max?: number;
+    /** Pre-filled value. */
+    default?: string | number | boolean | string[];
 }
 export interface AutoFormOptions {
     /** Form heading. */