@assistant-ui/react-generative-ui 0.0.19 → 0.0.21

package/dist/JSONGenerativeUI.client.d.ts

@@ -1,5 +1,4 @@
-import { JSONGenerativeUIOptions, PresentTool, PresentToolOptions, PromptUserTool } from "./JSONGenerativeUI.shared.js";
-//#region src/JSONGenerativeUI.client.d.ts
+import { type JSONGenerativeUIOptions, type PresentTool, type PresentToolOptions, type PromptUserTool } from "./JSONGenerativeUI.shared.js";
 /**
  * Client build of {@link JSONGenerativeUI}, resolved through the package's
  * `default` export condition (browser and SSR).
@@ -12,18 +11,18 @@ import { JSONGenerativeUIOptions, PresentTool, PresentToolOptions, PromptUserToo
  * interactive components can fire `$action` through `$dispatch`.
  */
 export declare class JSONGenerativeUI {
-  private readonly library;
-  private readonly parameters;
-  private readonly actions;
-  constructor(options: JSONGenerativeUIOptions);
-  /**
-   * The surface a `present` call paints into. It owns the vertical rhythm
-   * between top-level blocks, which the host's message container does not
-   * provide, and stays out of the way while it has nothing to show.
-   */
-  private readonly render;
-  present(options?: PresentToolOptions): PresentTool;
-  promptUser(): PromptUserTool;
+    private readonly library;
+    private readonly parameters;
+    private readonly actions;
+    private readonly completedPromptToolCallIds;
+    constructor(options: JSONGenerativeUIOptions);
+    /**
+     * The surface a `present` call paints into. It owns the vertical rhythm
+     * between top-level blocks, which the host's message container does not
+     * provide, and stays out of the way while it has nothing to show.
+     */
+    private readonly render;
+    present(options?: PresentToolOptions): PresentTool;
+    promptUser(): PromptUserTool;
 }
-//#endregion
 //# sourceMappingURL=JSONGenerativeUI.client.d.ts.map

package/dist/JSONGenerativeUI.client.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"JSONGenerativeUI.client.d.ts","names":[],"sources":["../src/JSONGenerativeUI.client.tsx"],"mappings":";;;;;;;;;;;;;qBAkCa;mBACM;mBACA;mBACA;EAEL,YAAA,SAAS;;;;;;mBAWJ;EAejB,QAAQ,UAAU,qBAAqB;EASvC,cAAc"}
+{"version":3,"file":"JSONGenerativeUI.client.d.ts","sourceRoot":"","sources":["../src/JSONGenerativeUI.client.tsx"],"names":[],"mappings":"AAGA,OAAO,EAGL,KAAK,uBAAuB,EAE5B,KAAK,WAAW,EAChB,KAAK,kBAAkB,EACvB,KAAK,cAAc,EACpB,qCAAkC;AAanC;;;;;;;;;;GAUG;AACH,qBAAa,gBAAgB;IAC3B,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAsB;IAC9C,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAoB;IAC/C,OAAO,CAAC,QAAQ,CAAC,OAAO,CAA6B;IACrD,OAAO,CAAC,QAAQ,CAAC,0BAA0B,CAAqB;gBAEpD,OAAO,EAAE,uBAAuB;IAM5C;;;;OAIG;IACH,OAAO,CAAC,QAAQ,CAAC,MAAM,CAqDrB;IAEF,OAAO,CAAC,OAAO,CAAC,EAAE,kBAAkB,GAAG,WAAW;IASlD,UAAU,IAAI,cAAc;CAO7B"}

package/dist/JSONGenerativeUI.client.js

@@ -25,6 +25,7 @@ var JSONGenerativeUI = class {
 	library;
 	parameters;
 	actions;
+	completedPromptToolCallIds = /* @__PURE__ */ new Set();
 	constructor(options) {
 		this.library = options.library;
 		this.parameters = buildPresentParameters(options.library);
@@ -35,13 +36,32 @@ var JSONGenerativeUI = class {
 	* between top-level blocks, which the host's message container does not
 	* provide, and stays out of the way while it has nothing to show.
 	*/
-	render = ({ args, status }) => /* @__PURE__ */ jsx("div", {
-		"data-aui": "root",
-		children: renderGenerativeUI(args, this.library, {
-			status: uiStatus(status),
-			...this.actions ? { dispatch: this.actions.dispatch } : {}
-		})
-	});
+	render = ({ args, status, addResult, result, toolCallId, unstable_recordInteraction }, completesPrompt = false) => {
+		const actions = this.actions;
+		const dispatch = actions ? (action) => {
+			if (unstable_recordInteraction) try {
+				unstable_recordInteraction({
+					type: "action",
+					payload: action
+				}).catch(() => {});
+			} catch {}
+			const actionResult = actions.dispatch(action);
+			if (completesPrompt && actionResult !== void 0 && result === void 0) Promise.resolve(actionResult).then((response) => {
+				if (response !== void 0 && !this.completedPromptToolCallIds.has(toolCallId)) {
+					this.completedPromptToolCallIds.add(toolCallId);
+					addResult(response);
+				}
+			}).catch(() => {});
+			return actionResult;
+		} : void 0;
+		return /* @__PURE__ */ jsx("div", {
+			"data-aui": "root",
+			children: renderGenerativeUI(args, this.library, {
+				status: uiStatus(status),
+				...dispatch ? { dispatch } : {}
+			})
+		});
+	};
 	present(options) {
 		return {
 			...presentToolBase(this.parameters, options),
@@ -54,7 +74,7 @@ var JSONGenerativeUI = class {
 		return {
 			...promptUserToolBase(this.parameters),
 			unstable_backendDefault: { parameters: true },
-			render: this.render
+			render: (props) => this.render(props, true)
 		};
 	}
 };

package/dist/JSONGenerativeUI.client.js.map

@@ -1 +1 @@
-{"version":3,"file":"JSONGenerativeUI.client.js","names":[],"sources":["../src/JSONGenerativeUI.client.tsx"],"sourcesContent":["import type { ReactNode } from \"react\";\nimport { buildPresentParameters } from \"./buildPresentParameters\";\nimport {\n  presentToolBase,\n  promptUserToolBase,\n  type JSONGenerativeUIOptions,\n  type PresentParameters,\n  type PresentTool,\n  type PresentToolOptions,\n  type PromptUserTool,\n} from \"./JSONGenerativeUI.shared\";\nimport { type ActionRegistry } from \"./actionRegistry\";\nimport { renderGenerativeUI } from \"./renderGenerativeUI\";\nimport type { GenerativeUILibrary, GenerativeUIStatus } from \"./types\";\n\n/** Maps a tool-call part status to the generative-UI streaming status. Only a\n * `complete` call has fully-arrived args; `running` and `incomplete`\n * (aborted/errored, so args may be partial) both render as `\"streaming\"` so a\n * non-streaming component is never handed partial props. */\nfunction uiStatus(status: { type: string }): GenerativeUIStatus {\n  return status.type === \"complete\" ? \"done\" : \"streaming\";\n}\n\n/**\n * Client build of {@link JSONGenerativeUI}, resolved through the package's\n * `default` export condition (browser and SSR).\n *\n * `present` is a frontend tool that renders the model's `{ $type, ...props }`\n * tree against the library and resolves immediately. `prompt_user` is a\n * human-in-the-loop tool: the model pauses and the rendered UI supplies the\n * result. Both draw the tree the same way, so they share one `render`. The\n * `actions` registry (if provided) is threaded into the render context so\n * interactive components can fire `$action` through `$dispatch`.\n */\nexport class JSONGenerativeUI {\n  private readonly library: GenerativeUILibrary;\n  private readonly parameters: PresentParameters;\n  private readonly actions: ActionRegistry | undefined;\n\n  constructor(options: JSONGenerativeUIOptions) {\n    this.library = options.library;\n    this.parameters = buildPresentParameters(options.library);\n    this.actions = options.actions;\n  }\n\n  /**\n   * The surface a `present` call paints into. It owns the vertical rhythm\n   * between top-level blocks, which the host's message container does not\n   * provide, and stays out of the way while it has nothing to show.\n   */\n  private readonly render = ({\n    args,\n    status,\n  }: {\n    args: unknown;\n    status: { type: string };\n  }): ReactNode => (\n    <div data-aui=\"root\">\n      {renderGenerativeUI(args, this.library, {\n        status: uiStatus(status),\n        ...(this.actions ? { dispatch: this.actions.dispatch } : {}),\n      })}\n    </div>\n  );\n\n  present(options?: PresentToolOptions): PresentTool {\n    return {\n      ...presentToolBase(this.parameters, options),\n      unstable_backendDefault: { parameters: true },\n      execute: async () => ({}),\n      render: this.render,\n    };\n  }\n\n  promptUser(): PromptUserTool {\n    return {\n      ...promptUserToolBase(this.parameters),\n      unstable_backendDefault: { parameters: true },\n      render: this.render,\n    };\n  }\n}\n"],"mappings":";;;;;;;;;AAmBA,SAAS,SAAS,QAA8C;CAC9D,OAAO,OAAO,SAAS,aAAa,SAAS;AAC/C;;;;;;;;;;;;AAaA,IAAa,mBAAb,MAA8B;CAC5B;CACA;CACA;CAEA,YAAY,SAAkC;EAC5C,KAAK,UAAU,QAAQ;EACvB,KAAK,aAAa,uBAAuB,QAAQ,OAAO;EACxD,KAAK,UAAU,QAAQ;CACzB;;;;;;CAOA,UAA2B,EACzB,MACA,aAKA,oBAAC,OAAD;EAAK,YAAS;EACX,UAAA,mBAAmB,MAAM,KAAK,SAAS;GACtC,QAAQ,SAAS,MAAM;GACvB,GAAI,KAAK,UAAU,EAAE,UAAU,KAAK,QAAQ,SAAS,IAAI,CAAC;EAC5D,CAAC;CACE,CAAA;CAGP,QAAQ,SAA2C;EACjD,OAAO;GACL,GAAG,gBAAgB,KAAK,YAAY,OAAO;GAC3C,yBAAyB,EAAE,YAAY,KAAK;GAC5C,SAAS,aAAa,CAAC;GACvB,QAAQ,KAAK;EACf;CACF;CAEA,aAA6B;EAC3B,OAAO;GACL,GAAG,mBAAmB,KAAK,UAAU;GACrC,yBAAyB,EAAE,YAAY,KAAK;GAC5C,QAAQ,KAAK;EACf;CACF;AACF"}
+{"version":3,"file":"JSONGenerativeUI.client.js","names":[],"sources":["../src/JSONGenerativeUI.client.tsx"],"sourcesContent":["import type { ToolCallMessagePartProps } from \"@assistant-ui/react\";\nimport type { ReactNode } from \"react\";\nimport { buildPresentParameters } from \"./buildPresentParameters\";\nimport {\n  presentToolBase,\n  promptUserToolBase,\n  type JSONGenerativeUIOptions,\n  type PresentParameters,\n  type PresentTool,\n  type PresentToolOptions,\n  type PromptUserTool,\n} from \"./JSONGenerativeUI.shared\";\nimport { type ActionRegistry } from \"./actionRegistry\";\nimport { renderGenerativeUI } from \"./renderGenerativeUI\";\nimport type { GenerativeUILibrary, GenerativeUIStatus } from \"./types\";\n\n/** Maps a tool-call part status to the generative-UI streaming status. Only a\n * `complete` call has fully-arrived args; `running` and `incomplete`\n * (aborted/errored, so args may be partial) both render as `\"streaming\"` so a\n * non-streaming component is never handed partial props. */\nfunction uiStatus(status: { type: string }): GenerativeUIStatus {\n  return status.type === \"complete\" ? \"done\" : \"streaming\";\n}\n\n/**\n * Client build of {@link JSONGenerativeUI}, resolved through the package's\n * `default` export condition (browser and SSR).\n *\n * `present` is a frontend tool that renders the model's `{ $type, ...props }`\n * tree against the library and resolves immediately. `prompt_user` is a\n * human-in-the-loop tool: the model pauses and the rendered UI supplies the\n * result. Both draw the tree the same way, so they share one `render`. The\n * `actions` registry (if provided) is threaded into the render context so\n * interactive components can fire `$action` through `$dispatch`.\n */\nexport class JSONGenerativeUI {\n  private readonly library: GenerativeUILibrary;\n  private readonly parameters: PresentParameters;\n  private readonly actions: ActionRegistry | undefined;\n  private readonly completedPromptToolCallIds = new Set<string>();\n\n  constructor(options: JSONGenerativeUIOptions) {\n    this.library = options.library;\n    this.parameters = buildPresentParameters(options.library);\n    this.actions = options.actions;\n  }\n\n  /**\n   * The surface a `present` call paints into. It owns the vertical rhythm\n   * between top-level blocks, which the host's message container does not\n   * provide, and stays out of the way while it has nothing to show.\n   */\n  private readonly render = (\n    {\n      args,\n      status,\n      addResult,\n      result,\n      toolCallId,\n      unstable_recordInteraction,\n    }: ToolCallMessagePartProps<Record<string, unknown>, any>,\n    completesPrompt = false,\n  ): ReactNode => {\n    const actions = this.actions;\n    const dispatch = actions\n      ? (action: Parameters<ActionRegistry[\"dispatch\"]>[0]) => {\n          if (unstable_recordInteraction) {\n            try {\n              void unstable_recordInteraction({\n                type: \"action\",\n                payload: action,\n              }).catch(() => {});\n            } catch {}\n          }\n\n          const actionResult = actions.dispatch(action);\n          if (\n            completesPrompt &&\n            actionResult !== undefined &&\n            result === undefined\n          ) {\n            void Promise.resolve(actionResult)\n              .then((response) => {\n                if (\n                  response !== undefined &&\n                  !this.completedPromptToolCallIds.has(toolCallId)\n                ) {\n                  this.completedPromptToolCallIds.add(toolCallId);\n                  addResult(response);\n                }\n              })\n              .catch(() => {});\n          }\n          return actionResult;\n        }\n      : undefined;\n\n    return (\n      <div data-aui=\"root\">\n        {renderGenerativeUI(args, this.library, {\n          status: uiStatus(status),\n          ...(dispatch ? { dispatch } : {}),\n        })}\n      </div>\n    );\n  };\n\n  present(options?: PresentToolOptions): PresentTool {\n    return {\n      ...presentToolBase(this.parameters, options),\n      unstable_backendDefault: { parameters: true },\n      execute: async () => ({}),\n      render: this.render,\n    };\n  }\n\n  promptUser(): PromptUserTool {\n    return {\n      ...promptUserToolBase(this.parameters),\n      unstable_backendDefault: { parameters: true },\n      render: (props) => this.render(props, true),\n    };\n  }\n}\n"],"mappings":";;;;;;;;;AAoBA,SAAS,SAAS,QAA8C;CAC9D,OAAO,OAAO,SAAS,aAAa,SAAS;AAC/C;;;;;;;;;;;;AAaA,IAAa,mBAAb,MAA8B;CAC5B;CACA;CACA;CACA,6CAA8C,IAAI,IAAY;CAE9D,YAAY,SAAkC;EAC5C,KAAK,UAAU,QAAQ;EACvB,KAAK,aAAa,uBAAuB,QAAQ,OAAO;EACxD,KAAK,UAAU,QAAQ;CACzB;;;;;;CAOA,UACE,EACE,MACA,QACA,WACA,QACA,YACA,8BAEF,kBAAkB,UACJ;EACd,MAAM,UAAU,KAAK;EACrB,MAAM,WAAW,WACZ,WAAsD;GACrD,IAAI,4BACF,IAAI;IACF,2BAAgC;KAC9B,MAAM;KACN,SAAS;IACX,CAAC,CAAC,CAAC,YAAY,CAAC,CAAC;GACnB,QAAQ,CAAC;GAGX,MAAM,eAAe,QAAQ,SAAS,MAAM;GAC5C,IACE,mBACA,iBAAiB,KAAA,KACjB,WAAW,KAAA,GAEX,QAAa,QAAQ,YAAY,CAAC,CAC/B,MAAM,aAAa;IAClB,IACE,aAAa,KAAA,KACb,CAAC,KAAK,2BAA2B,IAAI,UAAU,GAC/C;KACA,KAAK,2BAA2B,IAAI,UAAU;KAC9C,UAAU,QAAQ;IACpB;GACF,CAAC,CAAC,CACD,YAAY,CAAC,CAAC;GAEnB,OAAO;EACT,IACA,KAAA;EAEJ,OACE,oBAAC,OAAD;GAAK,YAAS;GACX,UAAA,mBAAmB,MAAM,KAAK,SAAS;IACtC,QAAQ,SAAS,MAAM;IACvB,GAAI,WAAW,EAAE,SAAS,IAAI,CAAC;GACjC,CAAC;EACE,CAAA;CAET;CAEA,QAAQ,SAA2C;EACjD,OAAO;GACL,GAAG,gBAAgB,KAAK,YAAY,OAAO;GAC3C,yBAAyB,EAAE,YAAY,KAAK;GAC5C,SAAS,aAAa,CAAC;GACvB,QAAQ,KAAK;EACf;CACF;CAEA,aAA6B;EAC3B,OAAO;GACL,GAAG,mBAAmB,KAAK,UAAU;GACrC,yBAAyB,EAAE,YAAY,KAAK;GAC5C,SAAS,UAAU,KAAK,OAAO,OAAO,IAAI;EAC5C;CACF;AACF"}

package/dist/JSONGenerativeUI.server.d.ts

@@ -1,5 +1,4 @@
-import { JSONGenerativeUIOptions, PresentTool, PresentToolOptions, PromptUserTool } from "./JSONGenerativeUI.shared.js";
-//#region src/JSONGenerativeUI.server.d.ts
+import { type JSONGenerativeUIOptions, type PresentTool, type PresentToolOptions, type PromptUserTool } from "./JSONGenerativeUI.shared.js";
 /**
  * Server build of {@link JSONGenerativeUI}, resolved through the package's
  * `react-server` export condition.
@@ -14,10 +13,9 @@ import { JSONGenerativeUIOptions, PresentTool, PresentToolOptions, PromptUserToo
  * tools; on the server it is structurally absent and never read.
  */
 export declare class JSONGenerativeUI {
-  private readonly parameters;
-  constructor(options: JSONGenerativeUIOptions);
-  present(options?: PresentToolOptions): PresentTool;
-  promptUser(): PromptUserTool;
+    private readonly parameters;
+    constructor(options: JSONGenerativeUIOptions);
+    present(options?: PresentToolOptions): PresentTool;
+    promptUser(): PromptUserTool;
 }
-//#endregion
 //# sourceMappingURL=JSONGenerativeUI.server.d.ts.map

package/dist/JSONGenerativeUI.server.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"JSONGenerativeUI.server.d.ts","names":[],"sources":["../src/JSONGenerativeUI.server.tsx"],"mappings":";;;;;;;;;;;;;;;qBAwBa;mBACM;EAEL,YAAA,SAAS;EAIrB,QAAQ,UAAU,qBAAqB;EAIvC,cAAc"}
+{"version":3,"file":"JSONGenerativeUI.server.d.ts","sourceRoot":"","sources":["../src/JSONGenerativeUI.server.tsx"],"names":[],"mappings":"AACA,OAAO,EAGL,KAAK,uBAAuB,EAE5B,KAAK,WAAW,EAChB,KAAK,kBAAkB,EACvB,KAAK,cAAc,EACpB,qCAAkC;AAEnC;;;;;;;;;;;;GAYG;AACH,qBAAa,gBAAgB;IAC3B,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAoB;gBAEnC,OAAO,EAAE,uBAAuB;IAI5C,OAAO,CAAC,OAAO,CAAC,EAAE,kBAAkB,GAAG,WAAW;IAIlD,UAAU,IAAI,cAAc;CAG7B"}

package/dist/JSONGenerativeUI.shared.d.ts

@@ -1,38 +1,37 @@
-import { ActionRegistry } from "./actionRegistry.js";
-import { GenerativeUILibrary } from "./types.js";
-import { ToolDefinition } from "@assistant-ui/react";
-import { JSONSchema7 } from "json-schema";
-//#region src/JSONGenerativeUI.shared.d.ts
+import type { ToolDefinition } from "@assistant-ui/react";
+import type { JSONSchema7 } from "json-schema";
+import type { ActionRegistry } from "./actionRegistry.js";
+import type { GenerativeUILibrary } from "./types.js";
 /** Options for {@link JSONGenerativeUI}. */
 export type JSONGenerativeUIOptions = {
-  /**
-   * The components the model is allowed to render, keyed by the `$type` it
-   * selects them with. Author it with `defineGenerativeComponents({ ... })` so a
-   * `"use generative"` build can split each `render` from its `properties`.
-   */
-  library: GenerativeUILibrary;
-  /**
-   * Host-provided map from `$action.type` to its handler. Interactive
-   * components (`Button`/`Select`/`Input`/`DatePicker`) call `$dispatch($action)`
-   * on their event, which resolves through this registry. Omit it for a
-   * read-only render where model-emitted actions degrade to a no-op.
-   */
-  actions?: ActionRegistry;
+    /**
+     * The components the model is allowed to render, keyed by the `$type` it
+     * selects them with. Author it with `defineGenerativeComponents({ ... })` so a
+     * `"use generative"` build can split each `render` from its `properties`.
+     */
+    library: GenerativeUILibrary;
+    /**
+     * Host-provided map from `$action.type` to its handler. Interactive
+     * components (`Button`/`Select`/`Input`/`DatePicker`) call `$dispatch($action)`
+     * on their event, which resolves through this registry. Omit it for a
+     * read-only render where model-emitted actions degrade to a no-op.
+     */
+    actions?: ActionRegistry;
 };
 /** Options for {@link JSONGenerativeUI.present}. */
 export type PresentToolOptions = {
-  /**
-   * Set `"standalone"` to render the component on its own surface (outside the
-   * chain-of-thought trace), e.g. a full-bleed artifact like a card. Omit it for
-   * the default inline rendering — there is no `"inline"` value because that is
-   * already the default.
-   */
-  display?: "standalone";
+    /**
+     * Set `"standalone"` to render the component on its own surface (outside the
+     * chain-of-thought trace), e.g. a full-bleed artifact like a card. Omit it for
+     * the default inline rendering — there is no `"inline"` value because that is
+     * already the default.
+     */
+    display?: "standalone";
 };
 type BackendDefaultMetadata = {
-  unstable_backendDefault?: {
-    parameters?: boolean;
-  };
+    unstable_backendDefault?: {
+        parameters?: boolean;
+    };
 };
 /** The `present` tool, as the model sees it (no client `render`/`execute`). */
 export type PresentTool = ToolDefinition<Record<string, unknown>, Record<string, never>> & BackendDefaultMetadata;
@@ -46,19 +45,19 @@ export type PresentParameters = JSONSchema7;
  * Takes the already-built `parameters` so it isn't recomputed per tool.
  */
 export declare function presentToolBase(parameters: PresentParameters, options?: PresentToolOptions): {
-  display?: "standalone";
-  type: "frontend";
-  description: string;
-  parameters: JSONSchema7;
+    display?: "standalone";
+    type: "frontend";
+    description: string;
+    parameters: JSONSchema7;
 };
 /**
  * The schema-only half of the `prompt_user` tool, shared by both builds. The
  * server build returns exactly this; the client build adds `render`.
  */
 export declare function promptUserToolBase(parameters: PresentParameters): {
-  type: "human";
-  description: string;
-  parameters: JSONSchema7;
+    type: "human";
+    description: string;
+    parameters: JSONSchema7;
 };
-//#endregion
+export {};
 //# sourceMappingURL=JSONGenerativeUI.shared.d.ts.map

package/dist/JSONGenerativeUI.shared.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"JSONGenerativeUI.shared.d.ts","names":[],"sources":["../src/JSONGenerativeUI.shared.ts"],"mappings":";;;;;;YAMY;;;;;;EAMV,SAAS;;;;;;;EAOT,UAAU;;;YAIA;;;;;;;EAOV;;KAGG;EACH;IACE;;;;YAKQ,cAAc,eACxB,yBACA,yBAEA;;YAGU,iBAAiB,eAAe,oCAC1C;;YAYU,oBAAoB;;;;;;wBAOhB,gBACd,YAAY,mBACZ,UAAU;;;;;;;;;;wBAcI,mBAAmB,YAAY;;;cAAA"}
+{"version":3,"file":"JSONGenerativeUI.shared.d.ts","sourceRoot":"","sources":["../src/JSONGenerativeUI.shared.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAC;AAC1D,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAC/C,OAAO,KAAK,EAAE,cAAc,EAAE,4BAAyB;AACvD,OAAO,KAAK,EAAE,mBAAmB,EAAE,mBAAgB;AAEnD,4CAA4C;AAC5C,MAAM,MAAM,uBAAuB,GAAG;IACpC;;;;OAIG;IACH,OAAO,EAAE,mBAAmB,CAAC;IAC7B;;;;;OAKG;IACH,OAAO,CAAC,EAAE,cAAc,CAAC;CAC1B,CAAC;AAEF,oDAAoD;AACpD,MAAM,MAAM,kBAAkB,GAAG;IAC/B;;;;;OAKG;IACH,OAAO,CAAC,EAAE,YAAY,CAAC;CACxB,CAAC;AAEF,KAAK,sBAAsB,GAAG;IAC5B,uBAAuB,CAAC,EAAE;QACxB,UAAU,CAAC,EAAE,OAAO,CAAC;KACtB,CAAC;CACH,CAAC;AAEF,+EAA+E;AAC/E,MAAM,MAAM,WAAW,GAAG,cAAc,CACtC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EACvB,MAAM,CAAC,MAAM,EAAE,KAAK,CAAC,CACtB,GACC,sBAAsB,CAAC;AAEzB,yEAAyE;AACzE,MAAM,MAAM,cAAc,GAAG,cAAc,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,OAAO,CAAC,GAC3E,sBAAsB,CAAC;AAWzB,4FAA4F;AAC5F,MAAM,MAAM,iBAAiB,GAAG,WAAW,CAAC;AAE5C;;;;GAIG;AACH,wBAAgB,eAAe,CAC7B,UAAU,EAAE,iBAAiB,EAC7B,OAAO,CAAC,EAAE,kBAAkB;;;;;EAQ7B;AAED;;;GAGG;AACH,wBAAgB,kBAAkB,CAAC,UAAU,EAAE,iBAAiB;;;;EAM/D"}

package/dist/a2ui/convert.d.ts

@@ -1,9 +1,9 @@
-import { UIElement } from "../ir.js";
-import { A2uiSurfaceState } from "./types.js";
-//#region src/a2ui/convert.d.ts
-export declare function convertSurfaceToUISpec(surface: A2uiSurfaceState): {
-  spec: UIElement | null;
-  warnings: string[];
+import { type UIElement } from "../ir.js";
+import { type A2uiSurfaceState } from "./types.js";
+export declare function convertSurfaceToUISpec(surface: A2uiSurfaceState, options?: {
+    readonly keepUnknownComponents?: boolean;
+}): {
+    spec: UIElement | null;
+    warnings: string[];
 };
-//#endregion
 //# sourceMappingURL=convert.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"convert.d.ts","names":[],"sources":["../../src/a2ui/convert.ts"],"mappings":";;;wBAscgB,uBAAuB,SAAS;EAC9C,MAAM;EACN"}
+{"version":3,"file":"convert.d.ts","sourceRoot":"","sources":["../../src/a2ui/convert.ts"],"names":[],"mappings":"AAAA,OAAO,EAAc,KAAK,SAAS,EAAE,iBAAc;AACnD,OAAO,EAEL,KAAK,gBAAgB,EAEtB,mBAAgB;AAynBjB,wBAAgB,sBAAsB,CACpC,OAAO,EAAE,gBAAgB,EACzB,OAAO,GAAE;IAAE,QAAQ,CAAC,qBAAqB,CAAC,EAAE,OAAO,CAAA;CAAO,GACzD;IACD,IAAI,EAAE,SAAS,GAAG,IAAI,CAAC;IACvB,QAAQ,EAAE,MAAM,EAAE,CAAC;CACpB,CA+BA"}

package/dist/a2ui/convert.js

@@ -1,3 +1,4 @@
+import { ICON_NAMES } from "../ir.js";
 import { A2UI_SURFACE_ID } from "./types.js";
 //#region src/a2ui/convert.ts
 const DEPTH_CAP = 32;
@@ -6,13 +7,23 @@ const NODE_BUDGET = 5e3;
 const SUPPORTED_COMPONENTS = /* @__PURE__ */ new Set([
 	"Text",
 	"Image",
+	"Icon",
 	"Row",
 	"Column",
+	"List",
 	"Card",
 	"Divider",
 	"Button",
 	"TextField",
-	"CheckBox"
+	"CheckBox",
+	"ChoicePicker",
+	"DateTimeInput"
+]);
+const ICON_NAME_SET = new Set(ICON_NAMES);
+const ICON_SIZE_SET = /* @__PURE__ */ new Set([
+	"sm",
+	"md",
+	"lg"
 ]);
 const isRecord = (value) => typeof value === "object" && value !== null && !Array.isArray(value);
 const isPlainObject = (value) => {
@@ -86,11 +97,17 @@ const reserveNode = (context) => {
 	context.emittedNodes++;
 	return true;
 };
-const childrenOf = (node, dataSource, context, depth, visited) => {
+const childReferences = (node) => {
 	const children = node["children"];
-	if (!Array.isArray(children)) return [];
+	const references = Array.isArray(children) ? [...children] : [];
+	if (node["child"] !== void 0) references.push(node["child"]);
+	if (node["component"] === "Modal") references.push(node["trigger"], node["content"]);
+	if (node["component"] === "Tabs" && Array.isArray(node["tabs"])) for (const tab of node["tabs"]) references.push(isRecord(tab) ? tab["child"] : void 0);
+	return references;
+};
+const childrenOf = (node, dataSource, context, depth, visited) => {
 	const result = [];
-	for (const childId of children) {
+	for (const childId of childReferences(node)) {
 		if (typeof childId !== "string") {
 			context.warnings.push(`Component "${String(node["id"] ?? "")}" has a malformed child reference.`);
 			continue;
@@ -100,21 +117,38 @@ const childrenOf = (node, dataSource, context, depth, visited) => {
 	}
 	return result;
 };
-const mappedAction = (node, props, dataSource, context) => {
+const textLabel = (node, children, context) => {
+	const references = childReferences(node);
+	const [reference] = references;
+	const [child] = children;
+	if (references.length !== 1 || children.length !== 1 || typeof reference !== "string" || !child || context.surface.components.get(reference)?.["component"] !== "Text") return;
+	const text = child.$type === "Header" ? child["text"] : child["value"];
+	return typeof text === "string" ? text : void 0;
+};
+const mappedAction = (node, props, context) => {
 	const action = props["action"];
-	const actionName = typeof action === "string" ? action : isRecord(action) && typeof action["name"] === "string" ? action["name"] : void 0;
+	const event = isRecord(action) && isRecord(action["event"]) ? action["event"] : action;
+	const actionName = typeof event === "string" ? event : isRecord(event) && typeof event["name"] === "string" ? event["name"] : void 0;
 	if (!actionName) return void 0;
-	const rawContext = isRecord(action) ? action["context"] : void 0;
-	const resolvedContext = rawContext === void 0 ? void 0 : materialize(rawContext, dataSource);
+	const actionContext = isRecord(event) ? event["context"] : void 0;
 	return {
 		type: "a2ui:action",
 		name: actionName,
 		surfaceId: context.surfaceId,
 		sourceComponentId: typeof node["id"] === "string" ? node["id"] : "",
-		...resolvedContext !== void 0 ? { context: resolvedContext } : {}
+		...actionContext !== void 0 ? { context: actionContext } : {}
 	};
 };
-const mappedProps = (node, props, dataSource, context) => {
+const choiceOptions = (value) => {
+	if (!Array.isArray(value)) return [];
+	const options = [];
+	for (const option of value) if (isRecord(option) && typeof option["label"] === "string" && typeof option["value"] === "string") options.push({
+		label: option["label"],
+		value: option["value"]
+	});
+	return options;
+};
+const mappedProps = (node, props, context) => {
 	const component = node["component"];
 	if (component === "Text") {
 		const text = stringProp(props, ["text", "value"]);
@@ -134,7 +168,11 @@ const mappedProps = (node, props, dataSource, context) => {
 	}
 	if (component === "Image") {
 		const src = stringProp(props, ["src", "url"]);
-		const alt = stringProp(props, ["alt", "altText"]);
+		const alt = stringProp(props, [
+			"alt",
+			"altText",
+			"description"
+		]);
 		const size = props["size"];
 		const round = props["round"];
 		return {
@@ -145,6 +183,16 @@ const mappedProps = (node, props, dataSource, context) => {
 			...typeof round === "boolean" ? { round } : {}
 		};
 	}
+	if (component === "Icon") {
+		const name = stringProp(props, ["name"]);
+		if (!name || !ICON_NAME_SET.has(name)) return void 0;
+		const size = props["size"];
+		return {
+			$type: "Icon",
+			name,
+			...typeof size === "string" && ICON_SIZE_SET.has(size) ? { size } : {}
+		};
+	}
 	if (component === "Row") {
 		const gap = props["gap"];
 		const align = firstDefined(props, ["align", "alignment"]);
@@ -165,6 +213,15 @@ const mappedProps = (node, props, dataSource, context) => {
 			...typeof align === "string" ? { align } : {}
 		};
 	}
+	if (component === "List") {
+		const direction = props["direction"];
+		const align = props["align"];
+		if (direction === "horizontal") return {
+			$type: "Row",
+			...typeof align === "string" ? { align } : {}
+		};
+		return { $type: "ListView" };
+	}
 	if (component === "Card") {
 		const title = props["title"];
 		const padding = props["padding"];
@@ -185,7 +242,7 @@ const mappedProps = (node, props, dataSource, context) => {
 		const buttonStyle = props["buttonStyle"];
 		const block = props["block"];
 		const submit = props["submit"];
-		const action = mappedAction(node, props, dataSource, context);
+		const action = mappedAction(node, props, context);
 		return {
 			$type: "Button",
 			...label !== void 0 ? { label } : {},
@@ -222,14 +279,49 @@ const mappedProps = (node, props, dataSource, context) => {
 			...typeof defaultChecked === "boolean" ? { defaultChecked } : {}
 		};
 	}
+	if (component === "ChoicePicker") {
+		const options = choiceOptions(props["options"]);
+		const value = props["value"];
+		const defaultValue = typeof value === "string" ? value : Array.isArray(value) && typeof value[0] === "string" ? value[0] : void 0;
+		if (props["variant"] === "radio" || props["variant"] === "single" || props["variant"] === "singleSelection" || props["displayStyle"] === "radio" || props["variant"] === "mutuallyExclusive" && props["displayStyle"] !== "chips") return {
+			$type: "RadioGroup",
+			options,
+			...label !== void 0 ? { label } : {},
+			...name !== void 0 ? { name } : {},
+			...defaultValue !== void 0 ? { defaultValue } : {}
+		};
+		const placeholder = stringProp(props, ["placeholder"]);
+		return {
+			$type: "Select",
+			options,
+			...placeholder !== void 0 ? { placeholder } : {},
+			...label !== void 0 ? { label } : {},
+			...name !== void 0 ? { name } : {}
+		};
+	}
+	if (component === "DateTimeInput") {
+		const value = stringProp(props, ["value"]);
+		const min = stringProp(props, ["min"]);
+		const max = stringProp(props, ["max"]);
+		return {
+			$type: "DatePicker",
+			...value !== void 0 ? { value } : {},
+			...min !== void 0 ? { min } : {},
+			...max !== void 0 ? { max } : {},
+			...label !== void 0 ? { label } : {},
+			...name !== void 0 ? { name } : {}
+		};
+	}
 };
-const convertTemplate = (node, templateChildren, dataSource, context, depth, visited) => {
+const convertTemplate = (node, templateChildren, dataSource, context, depth, visited, retained, mappedContainer) => {
 	if (!reserveNode(context)) return null;
+	const horizontalList = node["component"] === "List" && materialize(node["direction"], dataSource) === "horizontal";
+	const container = mappedContainer ?? retained ?? { $type: horizontalList ? "Row" : "ListView" };
 	const list = resolvePointer(dataSource, templateChildren.template.path);
 	if (!Array.isArray(list)) {
 		context.warnings.push(`Template on component "${String(node["id"] ?? "")}" did not resolve to a list.`);
 		return {
-			$type: "ListView",
+			...container,
 			children: []
 		};
 	}
@@ -240,15 +332,17 @@ const convertTemplate = (node, templateChildren, dataSource, context, depth, vis
 	}
 	const children = [];
 	for (let index = 0; index < itemCount; index++) {
-		if (!reserveNode(context)) break;
+		if (!retained && !horizontalList && !reserveNode(context)) break;
 		const child = convertComponent(templateChildren.template.componentId, list[index], context, depth + 1, visited);
-		children.push({
+		if (retained || horizontalList) {
+			if (child) children.push(child);
+		} else children.push({
 			$type: "ListViewItem",
 			...child ? { children: child } : {}
 		});
 	}
 	return {
-		$type: "ListView",
+		...container,
 		children
 	};
 };
@@ -272,31 +366,56 @@ function convertComponent(componentId, dataSource, context, depth, visited) {
 	const component = node["component"];
 	visited.add(componentId);
 	try {
-		const templateChildren = node["children"];
-		if (isTemplateChildren(templateChildren)) return convertTemplate(node, templateChildren, dataSource, context, depth, visited);
-		if (typeof component !== "string" || !SUPPORTED_COMPONENTS.has(component)) {
+		if (typeof component !== "string") {
 			context.warnings.push(`Unknown A2UI component "${String(component ?? "")}" was skipped.`);
 			return null;
 		}
-		if (!reserveNode(context)) return null;
+		const templateChildren = node["children"];
+		const hasTemplate = isTemplateChildren(templateChildren);
+		if (!SUPPORTED_COMPONENTS.has(component) && !context.keepUnknownComponents && !hasTemplate) {
+			context.warnings.push(`Unknown A2UI component "${component}" was skipped.`);
+			return null;
+		}
 		const props = {};
 		for (const [key, value] of Object.entries(node)) {
-			if (key === "id" || key === "component" || key === "children") continue;
+			if (key === "id" || key === "component" || key === "children" || key === "child") continue;
 			const resolved = materialize(value, dataSource);
 			if (resolved !== void 0) setOwnProperty(props, key, resolved);
 		}
-		const mapped = mappedProps(node, props, dataSource, context);
-		if (!mapped) return null;
+		const mapped = mappedProps(node, props, context);
+		if (!mapped && SUPPORTED_COMPONENTS.has(component)) {
+			context.warnings.push(`A2UI component "${component}" could not be mapped and was skipped.`);
+			return null;
+		}
+		const retained = !mapped && context.keepUnknownComponents ? {
+			$type: component,
+			...Object.fromEntries(Object.entries(props).filter(([key]) => !key.startsWith("$")))
+		} : void 0;
+		if (hasTemplate) return convertTemplate(node, templateChildren, dataSource, context, depth, visited, retained, component === "List" ? mapped : void 0);
+		if (!reserveNode(context)) return null;
+		const converted = mapped ?? retained;
+		if (!converted) return null;
 		const children = childrenOf(node, dataSource, context, depth, visited);
+		if (mapped?.$type === "Button" && mapped["label"] === void 0) {
+			const label = textLabel(node, children, context);
+			if (label !== void 0) return {
+				...mapped,
+				label
+			};
+		}
+		const listChildren = component === "List" && mapped?.$type === "ListView" ? children.map((child) => ({
+			$type: "ListViewItem",
+			children: child
+		})) : children;
 		return {
-			...mapped,
-			...children.length > 0 ? { children } : {}
+			...converted,
+			...listChildren.length > 0 ? { children: listChildren } : {}
 		};
 	} finally {
 		visited.delete(componentId);
 	}
 }
-function convertSurfaceToUISpec(surface) {
+function convertSurfaceToUISpec(surface, options = {}) {
 	const warnings = [];
 	if (!surface.components.has("root")) return {
 		spec: null,
@@ -309,7 +428,8 @@ function convertSurfaceToUISpec(surface) {
 		emittedNodes: 0,
 		depthWarned: false,
 		budgetWarned: false,
-		templateCapWarned: false
+		templateCapWarned: false,
+		keepUnknownComponents: options.keepUnknownComponents === true
 	};
 	try {
 		return {