@assistant-ui/react-generative-ui 0.0.6 → 0.0.8

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
 /**
  * Client build of {@link JSONGenerativeUI}, resolved through the package's
@@ -8,11 +7,14 @@ import { JSONGenerativeUIOptions, PresentTool, PresentToolOptions, PromptUserToo
  * `present` is a frontend tool that renders the model's `{ $type, ...props }`
  * tree against the library and resolves immediately. `prompt_user` is a
  * human-in-the-loop tool: the model pauses and the rendered UI supplies the
- * result. Both draw the tree the same way, so they share one `render`.
+ * result. Both draw the tree the same way, so they share one `render`. The
+ * `actions` registry (if provided) is threaded into the render context so
+ * interactive components can fire `$action` through `$dispatch`.
  */
 declare class JSONGenerativeUI {
   private readonly library;
   private readonly parameters;
+  private readonly actions;
   constructor(options: JSONGenerativeUIOptions);
   private readonly render;
   present(options?: PresentToolOptions): PresentTool;

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

@@ -1 +1 @@
-{"version":3,"file":"JSONGenerativeUI.client.d.ts","names":[],"sources":["../src/JSONGenerativeUI.client.tsx"],"mappings":";;;;;AA+BA;;;;;;;cAAa,gBAAA;EAAA,iBACM,OAAA;EAAA,iBACA,UAAA;cAEL,OAAA,EAAS,uBAAA;EAAA,iBAKJ,MAAA;EASjB,OAAA,CAAQ,OAAA,GAAU,kBAAA,GAAqB,WAAA;EASvC,UAAA,IAAc,cAAA;AAAA"}
+{"version":3,"file":"JSONGenerativeUI.client.d.ts","names":[],"sources":["../src/JSONGenerativeUI.client.tsx"],"mappings":";;;;;;;;;;;;;cAkCa;mBACM;mBACA;mBACA;cAEL,SAAS;mBAMJ;EAYjB,QAAQ,UAAU,qBAAqB;EASvC,cAAc"}

package/dist/JSONGenerativeUI.client.js

@@ -16,16 +16,23 @@ function uiStatus(status) {
 * `present` is a frontend tool that renders the model's `{ $type, ...props }`
 * tree against the library and resolves immediately. `prompt_user` is a
 * human-in-the-loop tool: the model pauses and the rendered UI supplies the
-* result. Both draw the tree the same way, so they share one `render`.
+* result. Both draw the tree the same way, so they share one `render`. The
+* `actions` registry (if provided) is threaded into the render context so
+* interactive components can fire `$action` through `$dispatch`.
 */
 var JSONGenerativeUI = class {
 	library;
 	parameters;
+	actions;
 	constructor(options) {
 		this.library = options.library;
 		this.parameters = buildPresentParameters(options.library);
+		this.actions = options.actions;
 	}
-	render = ({ args, status }) => renderGenerativeUI(args, this.library, { status: uiStatus(status) });
+	render = ({ args, status }) => renderGenerativeUI(args, this.library, {
+		status: uiStatus(status),
+		...this.actions ? { dispatch: this.actions.dispatch } : {}
+	});
 	present(options) {
 		return {
 			...presentToolBase(this.parameters, options),

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 { 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`.\n */\nexport class JSONGenerativeUI {\n  private readonly library: GenerativeUILibrary;\n  private readonly parameters: PresentParameters;\n\n  constructor(options: JSONGenerativeUIOptions) {\n    this.library = options.library;\n    this.parameters = buildPresentParameters(options.library);\n  }\n\n  private readonly render = ({\n    args,\n    status,\n  }: {\n    args: unknown;\n    status: { type: string };\n  }): ReactNode =>\n    renderGenerativeUI(args, this.library, { status: uiStatus(status) });\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":";;;;;;;;AAkBA,SAAS,SAAS,QAA8C;CAC9D,OAAO,OAAO,SAAS,aAAa,SAAS;AAC/C;;;;;;;;;;AAWA,IAAa,mBAAb,MAA8B;CAC5B;CACA;CAEA,YAAY,SAAkC;EAC5C,KAAK,UAAU,QAAQ;EACvB,KAAK,aAAa,uBAAuB,QAAQ,OAAO;CAC1D;CAEA,UAA2B,EACzB,MACA,aAKA,mBAAmB,MAAM,KAAK,SAAS,EAAE,QAAQ,SAAS,MAAM,EAAE,CAAC;CAErE,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 { 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  private readonly render = ({\n    args,\n    status,\n  }: {\n    args: unknown;\n    status: { type: string };\n  }): ReactNode =>\n    renderGenerativeUI(args, this.library, {\n      status: uiStatus(status),\n      ...(this.actions ? { dispatch: this.actions.dispatch } : {}),\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;CAEA,UAA2B,EACzB,MACA,aAKA,mBAAmB,MAAM,KAAK,SAAS;EACrC,QAAQ,SAAS,MAAM;EACvB,GAAI,KAAK,UAAU,EAAE,UAAU,KAAK,QAAQ,SAAS,IAAI,CAAC;CAC5D,CAAC;CAEH,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"}

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
 /**
  * Server build of {@link JSONGenerativeUI}, resolved through the package's

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

@@ -1 +1 @@
-{"version":3,"file":"JSONGenerativeUI.server.d.ts","names":[],"sources":["../src/JSONGenerativeUI.server.tsx"],"mappings":";;;;;AAwBA;;;;;;;;;;;cAAa,gBAAA;EAAA,iBACM,UAAA;cAEL,OAAA,EAAS,uBAAA;EAIrB,OAAA,CAAQ,OAAA,GAAU,kBAAA,GAAqB,WAAA;EAIvC,UAAA,IAAc,cAAA;AAAA"}
+{"version":3,"file":"JSONGenerativeUI.server.d.ts","names":[],"sources":["../src/JSONGenerativeUI.server.tsx"],"mappings":";;;;;;;;;;;;;;;cAwBa;mBACM;cAEL,SAAS;EAIrB,QAAQ,UAAU,qBAAqB;EAIvC,cAAc"}

package/dist/JSONGenerativeUI.shared.d.ts

@@ -1,7 +1,7 @@
 import { JSONSchema7 } from "./node_modules/.pnpm/@types_json-schema@7.0.15/node_modules/@types/json-schema/index.js";
+import { ActionRegistry } from "./actionRegistry.js";
 import { GenerativeUILibrary } from "./types.js";
 import { ToolDefinition } from "@assistant-ui/react";
-
 //#region src/JSONGenerativeUI.shared.d.ts
 /** Options for {@link JSONGenerativeUI}. */
 type JSONGenerativeUIOptions = {
@@ -11,6 +11,13 @@ type JSONGenerativeUIOptions = {
    * `"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}. */
 type PresentToolOptions = {

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

@@ -1 +1 @@
-{"version":3,"file":"JSONGenerativeUI.shared.d.ts","names":[],"sources":["../src/JSONGenerativeUI.shared.ts"],"mappings":";;;;;;KAKY,uBAAA;EAAA;;;;AAMkB;EAA5B,OAAA,EAAS,mBAAmB;AAAA;;KAIlB,kBAAA;EAOH;AACP;;;;AAIY;EALZ,OAAO;AAAA;AAAA,KAGJ,sBAAA;EACH,uBAAA;IACE,UAAU;EAAA;AAAA;;KAKF,WAAA,GAAc,cAAA,CACxB,MAAA,mBACA,MAAA,mBAEA,sBAAA;;KAGU,cAAA,GAAiB,cAAA,CAAe,MAAA,8BAC1C,sBAAA;;KAYU,iBAAA,GAAoB,WAAW;;AAhBnB;AAGxB;;;iBAoBgB,eAAA,CACd,UAAA,EAAY,iBAAA,EACZ,OAAA,GAAU,kBAAA;;;;;;;;;AArBY;iBAmCR,kBAAA,CAAmB,UAAA,EAAY,iBAAA;;;cAAA,WAAA;AAAA"}
+{"version":3,"file":"JSONGenerativeUI.shared.d.ts","names":[],"sources":["../src/JSONGenerativeUI.shared.ts"],"mappings":";;;;;;KAMY;;;;;;EAMV,SAAS;;;;;;;EAOT,UAAU;;;KAIA;;;;;;;EAOV;;KAGG;EACH;IACE;;;;KAKQ,cAAc,eACxB,yBACA,yBAEA;;KAGU,iBAAiB,eAAe,oCAC1C;;KAYU,oBAAoB;;;;;;iBAOhB,gBACd,YAAY,mBACZ,UAAU;;;;;;;;;;iBAcI,mBAAmB,YAAY;;;cAAA"}

package/dist/JSONGenerativeUI.shared.js.map

@@ -1 +1 @@
-{"version":3,"file":"JSONGenerativeUI.shared.js","names":[],"sources":["../src/JSONGenerativeUI.shared.ts"],"sourcesContent":["import type { ToolDefinition } from \"@assistant-ui/react\";\nimport type { JSONSchema7 } from \"json-schema\";\nimport type { GenerativeUILibrary } from \"./types\";\n\n/** Options for {@link JSONGenerativeUI}. */\nexport type JSONGenerativeUIOptions = {\n  /**\n   * The components the model is allowed to render, keyed by the `$type` it\n   * selects them with. Author it with `defineGenerativeComponents({ ... })` so a\n   * `\"use generative\"` build can split each `render` from its `properties`.\n   */\n  library: GenerativeUILibrary;\n};\n\n/** Options for {@link JSONGenerativeUI.present}. */\nexport type PresentToolOptions = {\n  /**\n   * Set `\"standalone\"` to render the component on its own surface (outside the\n   * chain-of-thought trace), e.g. a full-bleed artifact like a card. Omit it for\n   * the default inline rendering — there is no `\"inline\"` value because that is\n   * already the default.\n   */\n  display?: \"standalone\";\n};\n\ntype BackendDefaultMetadata = {\n  unstable_backendDefault?: {\n    parameters?: boolean;\n  };\n};\n\n/** The `present` tool, as the model sees it (no client `render`/`execute`). */\nexport type PresentTool = ToolDefinition<\n  Record<string, unknown>,\n  Record<string, never>\n> &\n  BackendDefaultMetadata;\n\n/** The `prompt_user` tool, as the model sees it (no client `render`). */\nexport type PromptUserTool = ToolDefinition<Record<string, unknown>, unknown> &\n  BackendDefaultMetadata;\n\nconst PRESENT_DESCRIPTION =\n  \"Present a UI component to the user. Select a component with `$type` and \" +\n  \"provide its props inline; nest components with `children`.\";\n\nconst PROMPT_USER_DESCRIPTION =\n  \"Present a UI component to the user and wait for their response. Select a \" +\n  \"component with `$type` and provide its props inline; nest components with \" +\n  \"`children`. The user interacts with it and the result is returned to you.\";\n\n/** The tool `parameters` schema, built once per instance (see `buildPresentParameters`). */\nexport type PresentParameters = JSONSchema7;\n\n/**\n * The schema-only half of the `present` tool, shared by both builds. The server\n * build returns exactly this; the client build adds `execute` and `render`.\n * Takes the already-built `parameters` so it isn't recomputed per tool.\n */\nexport function presentToolBase(\n  parameters: PresentParameters,\n  options?: PresentToolOptions,\n) {\n  return {\n    type: \"frontend\" as const,\n    description: PRESENT_DESCRIPTION,\n    parameters,\n    ...(options?.display !== undefined ? { display: options.display } : {}),\n  };\n}\n\n/**\n * The schema-only half of the `prompt_user` tool, shared by both builds. The\n * server build returns exactly this; the client build adds `render`.\n */\nexport function promptUserToolBase(parameters: PresentParameters) {\n  return {\n    type: \"human\" as const,\n    description: PROMPT_USER_DESCRIPTION,\n    parameters,\n  };\n}\n"],"mappings":";AA0CA,MAAM,sBACJ;AAGF,MAAM,0BACJ;;;;;;AAYF,SAAgB,gBACd,YACA,SACA;CACA,OAAO;EACL,MAAM;EACN,aAAa;EACb;EACA,GAAI,SAAS,YAAY,KAAA,IAAY,EAAE,SAAS,QAAQ,QAAQ,IAAI,CAAC;CACvE;AACF;;;;;AAMA,SAAgB,mBAAmB,YAA+B;CAChE,OAAO;EACL,MAAM;EACN,aAAa;EACb;CACF;AACF"}
+{"version":3,"file":"JSONGenerativeUI.shared.js","names":[],"sources":["../src/JSONGenerativeUI.shared.ts"],"sourcesContent":["import type { ToolDefinition } from \"@assistant-ui/react\";\nimport type { JSONSchema7 } from \"json-schema\";\nimport type { ActionRegistry } from \"./actionRegistry\";\nimport type { GenerativeUILibrary } from \"./types\";\n\n/** Options for {@link JSONGenerativeUI}. */\nexport type JSONGenerativeUIOptions = {\n  /**\n   * The components the model is allowed to render, keyed by the `$type` it\n   * selects them with. Author it with `defineGenerativeComponents({ ... })` so a\n   * `\"use generative\"` build can split each `render` from its `properties`.\n   */\n  library: GenerativeUILibrary;\n  /**\n   * Host-provided map from `$action.type` to its handler. Interactive\n   * components (`Button`/`Select`/`Input`/`DatePicker`) call `$dispatch($action)`\n   * on their event, which resolves through this registry. Omit it for a\n   * read-only render where model-emitted actions degrade to a no-op.\n   */\n  actions?: ActionRegistry;\n};\n\n/** Options for {@link JSONGenerativeUI.present}. */\nexport type PresentToolOptions = {\n  /**\n   * Set `\"standalone\"` to render the component on its own surface (outside the\n   * chain-of-thought trace), e.g. a full-bleed artifact like a card. Omit it for\n   * the default inline rendering — there is no `\"inline\"` value because that is\n   * already the default.\n   */\n  display?: \"standalone\";\n};\n\ntype BackendDefaultMetadata = {\n  unstable_backendDefault?: {\n    parameters?: boolean;\n  };\n};\n\n/** The `present` tool, as the model sees it (no client `render`/`execute`). */\nexport type PresentTool = ToolDefinition<\n  Record<string, unknown>,\n  Record<string, never>\n> &\n  BackendDefaultMetadata;\n\n/** The `prompt_user` tool, as the model sees it (no client `render`). */\nexport type PromptUserTool = ToolDefinition<Record<string, unknown>, unknown> &\n  BackendDefaultMetadata;\n\nconst PRESENT_DESCRIPTION =\n  \"Present a UI component to the user. Select a component with `$type` and \" +\n  \"provide its props inline; nest components with `children`.\";\n\nconst PROMPT_USER_DESCRIPTION =\n  \"Present a UI component to the user and wait for their response. Select a \" +\n  \"component with `$type` and provide its props inline; nest components with \" +\n  \"`children`. The user interacts with it and the result is returned to you.\";\n\n/** The tool `parameters` schema, built once per instance (see `buildPresentParameters`). */\nexport type PresentParameters = JSONSchema7;\n\n/**\n * The schema-only half of the `present` tool, shared by both builds. The server\n * build returns exactly this; the client build adds `execute` and `render`.\n * Takes the already-built `parameters` so it isn't recomputed per tool.\n */\nexport function presentToolBase(\n  parameters: PresentParameters,\n  options?: PresentToolOptions,\n) {\n  return {\n    type: \"frontend\" as const,\n    description: PRESENT_DESCRIPTION,\n    parameters,\n    ...(options?.display !== undefined ? { display: options.display } : {}),\n  };\n}\n\n/**\n * The schema-only half of the `prompt_user` tool, shared by both builds. The\n * server build returns exactly this; the client build adds `render`.\n */\nexport function promptUserToolBase(parameters: PresentParameters) {\n  return {\n    type: \"human\" as const,\n    description: PROMPT_USER_DESCRIPTION,\n    parameters,\n  };\n}\n"],"mappings":";AAkDA,MAAM,sBACJ;AAGF,MAAM,0BACJ;;;;;;AAYF,SAAgB,gBACd,YACA,SACA;CACA,OAAO;EACL,MAAM;EACN,aAAa;EACb;EACA,GAAI,SAAS,YAAY,KAAA,IAAY,EAAE,SAAS,QAAQ,QAAQ,IAAI,CAAC;CACvE;AACF;;;;;AAMA,SAAgB,mBAAmB,YAA+B;CAChE,OAAO;EACL,MAAM;EACN,aAAa;EACb;CACF;AACF"}

package/dist/actionRegistry.d.ts

@@ -0,0 +1,32 @@
+import { Action } from "./ir.js";
+//#region src/actionRegistry.d.ts
+/** Context handed to an {@link ActionHandler} when an `$action` fires. */
+type ActionDispatchContext = {
+  /**
+   * The action payload. For fire-and-forget actions this is the `$action` as the model emitted it. For an interactive component the user's runtime input is merged in under the reserved `$input` key: a single value for a standalone control's dispatch, or an object keyed by each field's `name` for a `Form` or a `Card` with `asForm` set. A model-supplied `value` field is never clobbered.
+   */
+  readonly payload: Action;
+};
+/**
+ * Resolves a single `$action.type`. Fire-and-forget actions return `void` or a
+ * promise that resolves to it; human-in-the-loop actions return a value the
+ * runtime uses to resume the run (see IR doc Open question #2 — the resume
+ * value is left as `unknown` and documented per-action). The return value is
+ * handed back to `dispatch`'s caller as `unknown`.
+ */
+type ActionHandler = (ctx: ActionDispatchContext) => unknown | Promise<unknown>;
+/**
+ * The host-provided map from `$action.type` to {@link ActionHandler}. This is the single dispatch target for rendered generative UI: every interactive component fires its `$action` here through the injected `$dispatch` (a submit Button defers to its ancestor form's dispatch instead). The payload's `$input` takes one of two shapes: a single value for a standalone control's dispatch (`Select`, `Input`, `DatePicker`, `Checkbox`, `RadioGroup`), or an object keyed by field `name` for a `Form` or a `Card` with `asForm` set. Construct it with {@link createActionRegistry} and pass it to `JSONGenerativeUI`.
+ */
+type ActionRegistry = {
+  dispatch(action: Action): unknown;
+  has(type: string): boolean;
+};
+declare function createActionRegistry(handlers: Readonly<Record<string, ActionHandler>>): ActionRegistry;
+/** A no-op registry used when no handlers are provided. Dispatch resolves to
+ * `undefined` and logs a warning in dev for unknown types, so a model-emitted
+ * action with no handler degrades to "does nothing" rather than throwing. */
+declare const emptyActionRegistry: ActionRegistry;
+//#endregion
+export { ActionDispatchContext, ActionHandler, ActionRegistry, createActionRegistry, emptyActionRegistry };
+//# sourceMappingURL=actionRegistry.d.ts.map

package/dist/actionRegistry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"actionRegistry.d.ts","names":[],"sources":["../src/actionRegistry.ts"],"mappings":";;;KAGY;;;;WAID,SAAS;;;;;;;;;KAUR,iBACV,KAAK,oCACQ;;;;KAKH;EACV,SAAS,QAAQ;EACjB,IAAI;;iBAGU,qBACd,UAAU,SAAS,eAAe,kBACjC;;;;cA0CU,qBAAqB"}

package/dist/actionRegistry.js

@@ -0,0 +1,41 @@
+//#region src/actionRegistry.ts
+function createActionRegistry(handlers) {
+	const map = new Map(Object.entries(handlers));
+	return {
+		dispatch(action) {
+			if (typeof action?.type !== "string") {
+				if (process.env["NODE_ENV"] !== "production") console.warn(`[@assistant-ui/react-generative-ui] Skipping malformed action; \`\$action.type\` must be a string. Received ${formatReceivedType(action?.type)}. Update the emitted \`\$action\` payload.`);
+				return;
+			}
+			const handler = map.get(action.type);
+			if (!handler) {
+				if (process.env["NODE_ENV"] !== "production") {
+					const actionTypes = [...map.keys()];
+					console.warn(`[@assistant-ui/react-generative-ui] Action "${action.type}" has no registered handler. ${formatRegisteredActions(actionTypes)} Register it with createActionRegistry(...) or update the emitted \`\$action.type\`.`);
+				}
+				return;
+			}
+			return handler({ payload: action });
+		},
+		has(type) {
+			return map.has(type);
+		}
+	};
+}
+/** A no-op registry used when no handlers are provided. Dispatch resolves to
+* `undefined` and logs a warning in dev for unknown types, so a model-emitted
+* action with no handler degrades to "does nothing" rather than throwing. */
+const emptyActionRegistry = createActionRegistry({});
+function formatRegisteredActions(actionTypes) {
+	if (actionTypes.length === 0) return "No actions are registered.";
+	return `Registered actions: ${actionTypes.map((type) => `"${type}"`).join(", ")}.`;
+}
+function formatReceivedType(value) {
+	if (value === null) return "null";
+	if (Array.isArray(value)) return "array";
+	return typeof value;
+}
+//#endregion
+export { createActionRegistry, emptyActionRegistry };
+
+//# sourceMappingURL=actionRegistry.js.map

package/dist/actionRegistry.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"actionRegistry.js","names":[],"sources":["../src/actionRegistry.ts"],"sourcesContent":["import type { Action } from \"./ir\";\n\n/** Context handed to an {@link ActionHandler} when an `$action` fires. */\nexport type ActionDispatchContext = {\n  /**\n   * The action payload. For fire-and-forget actions this is the `$action` as the model emitted it. For an interactive component the user's runtime input is merged in under the reserved `$input` key: a single value for a standalone control's dispatch, or an object keyed by each field's `name` for a `Form` or a `Card` with `asForm` set. A model-supplied `value` field is never clobbered.\n   */\n  readonly payload: Action;\n};\n\n/**\n * Resolves a single `$action.type`. Fire-and-forget actions return `void` or a\n * promise that resolves to it; human-in-the-loop actions return a value the\n * runtime uses to resume the run (see IR doc Open question #2 — the resume\n * value is left as `unknown` and documented per-action). The return value is\n * handed back to `dispatch`'s caller as `unknown`.\n */\nexport type ActionHandler = (\n  ctx: ActionDispatchContext,\n) => unknown | Promise<unknown>;\n\n/**\n * The host-provided map from `$action.type` to {@link ActionHandler}. This is the single dispatch target for rendered generative UI: every interactive component fires its `$action` here through the injected `$dispatch` (a submit Button defers to its ancestor form's dispatch instead). The payload's `$input` takes one of two shapes: a single value for a standalone control's dispatch (`Select`, `Input`, `DatePicker`, `Checkbox`, `RadioGroup`), or an object keyed by field `name` for a `Form` or a `Card` with `asForm` set. Construct it with {@link createActionRegistry} and pass it to `JSONGenerativeUI`.\n */\nexport type ActionRegistry = {\n  dispatch(action: Action): unknown;\n  has(type: string): boolean;\n};\n\nexport function createActionRegistry(\n  handlers: Readonly<Record<string, ActionHandler>>,\n): ActionRegistry {\n  const map = new Map(Object.entries(handlers));\n  return {\n    dispatch(action) {\n      if (typeof action?.type !== \"string\") {\n        if (process.env[\"NODE_ENV\"] !== \"production\") {\n          // eslint-disable-next-line no-console\n          console.warn(\n            \"[@assistant-ui/react-generative-ui] Skipping malformed action; \" +\n              \"`$action.type` must be a string. \" +\n              `Received ${formatReceivedType(action?.type)}. Update the emitted ` +\n              \"`$action` payload.\",\n          );\n        }\n        return undefined;\n      }\n\n      const handler = map.get(action.type);\n      if (!handler) {\n        if (process.env[\"NODE_ENV\"] !== \"production\") {\n          const actionTypes = [...map.keys()];\n          // eslint-disable-next-line no-console\n          console.warn(\n            `[@assistant-ui/react-generative-ui] Action \"${action.type}\" has ` +\n              `no registered handler. ${formatRegisteredActions(actionTypes)} ` +\n              \"Register it with createActionRegistry(...) or update the emitted \" +\n              \"`$action.type`.\",\n          );\n        }\n        return undefined;\n      }\n      return handler({ payload: action });\n    },\n    has(type) {\n      return map.has(type);\n    },\n  };\n}\n\n/** A no-op registry used when no handlers are provided. Dispatch resolves to\n * `undefined` and logs a warning in dev for unknown types, so a model-emitted\n * action with no handler degrades to \"does nothing\" rather than throwing. */\nexport const emptyActionRegistry: ActionRegistry = createActionRegistry({});\n\nfunction formatRegisteredActions(actionTypes: string[]) {\n  if (actionTypes.length === 0) return \"No actions are registered.\";\n\n  return `Registered actions: ${actionTypes\n    .map((type) => `\"${type}\"`)\n    .join(\", \")}.`;\n}\n\nfunction formatReceivedType(value: unknown) {\n  if (value === null) return \"null\";\n  if (Array.isArray(value)) return \"array\";\n  return typeof value;\n}\n"],"mappings":";AA6BA,SAAgB,qBACd,UACgB;CAChB,MAAM,MAAM,IAAI,IAAI,OAAO,QAAQ,QAAQ,CAAC;CAC5C,OAAO;EACL,SAAS,QAAQ;GACf,IAAI,OAAO,QAAQ,SAAS,UAAU;IACpC,IAAI,QAAQ,IAAI,gBAAgB,cAE9B,QAAQ,KACN,+GAEc,mBAAmB,QAAQ,IAAI,EAAE,2CAEjD;IAEF;GACF;GAEA,MAAM,UAAU,IAAI,IAAI,OAAO,IAAI;GACnC,IAAI,CAAC,SAAS;IACZ,IAAI,QAAQ,IAAI,gBAAgB,cAAc;KAC5C,MAAM,cAAc,CAAC,GAAG,IAAI,KAAK,CAAC;KAElC,QAAQ,KACN,+CAA+C,OAAO,KAAK,+BAC/B,wBAAwB,WAAW,EAAE,qFAGnE;IACF;IACA;GACF;GACA,OAAO,QAAQ,EAAE,SAAS,OAAO,CAAC;EACpC;EACA,IAAI,MAAM;GACR,OAAO,IAAI,IAAI,IAAI;EACrB;CACF;AACF;;;;AAKA,MAAa,sBAAsC,qBAAqB,CAAC,CAAC;AAE1E,SAAS,wBAAwB,aAAuB;CACtD,IAAI,YAAY,WAAW,GAAG,OAAO;CAErC,OAAO,uBAAuB,YAC3B,KAAK,SAAS,IAAI,KAAK,EAAE,CAAC,CAC1B,KAAK,IAAI,EAAE;AAChB;AAEA,SAAS,mBAAmB,OAAgB;CAC1C,IAAI,UAAU,MAAM,OAAO;CAC3B,IAAI,MAAM,QAAQ,KAAK,GAAG,OAAO;CACjC,OAAO,OAAO;AAChB"}

package/dist/buildPresentParameters.d.ts

@@ -1,14 +1,14 @@
 import { JSONSchema7 } from "./node_modules/.pnpm/@types_json-schema@7.0.15/node_modules/@types/json-schema/index.js";
 import { GenerativeUILibrary } from "./types.js";
-
 //#region src/buildPresentParameters.d.ts
 /**
  * Builds the JSON schema for the `present` tool from a {@link GenerativeUILibrary}.
  *
- * The model produces a node `{ $type, ...props }` where `$type` selects a
- * component and the rest are its props. The schema is a flat object: `$type` is
- * an enum of the component names, every component's props are merged into one
- * optional bag, and `children` recurses via `$defs` so the tree can nest.
+ * The model produces a node `{ $type, $key?, ...props }` where `$type` selects
+ * a component, the optional `$key` pins a stable identity for list items that
+ * may reorder, and the rest are its props. The schema is a flat object: `$type`
+ * is an enum of the component names, every component's props are merged into
+ * one optional bag, and `children` recurses via `$defs` so the tree can nest.
  *
  * It is intentionally flat rather than a per-`$type` discriminated union. Tool /
  * function-call schemas (OpenAI and others) require the top-level parameters to

package/dist/buildPresentParameters.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"buildPresentParameters.d.ts","names":[],"sources":["../src/buildPresentParameters.ts"],"mappings":";;;;;;AAqBA;;;;;;;;AAEc;;;;;;iBAFE,sBAAA,CACd,OAAA,EAAS,mBAAA,GACR,WAAW"}
+{"version":3,"file":"buildPresentParameters.d.ts","names":[],"sources":["../src/buildPresentParameters.ts"],"mappings":";;;;;;;;;;;;;;;;;;;;iBAsBgB,uBACd,SAAS,sBACR"}

package/dist/buildPresentParameters.js

@@ -4,10 +4,11 @@ import { toJSONSchema } from "assistant-stream";
 /**
 * Builds the JSON schema for the `present` tool from a {@link GenerativeUILibrary}.
 *
-* The model produces a node `{ $type, ...props }` where `$type` selects a
-* component and the rest are its props. The schema is a flat object: `$type` is
-* an enum of the component names, every component's props are merged into one
-* optional bag, and `children` recurses via `$defs` so the tree can nest.
+* The model produces a node `{ $type, $key?, ...props }` where `$type` selects
+* a component, the optional `$key` pins a stable identity for list items that
+* may reorder, and the rest are its props. The schema is a flat object: `$type`
+* is an enum of the component names, every component's props are merged into
+* one optional bag, and `children` recurses via `$defs` so the tree can nest.
 *
 * It is intentionally flat rather than a per-`$type` discriminated union. Tool /
 * function-call schemas (OpenAI and others) require the top-level parameters to
@@ -20,15 +21,20 @@ import { toJSONSchema } from "assistant-stream";
 function buildPresentParameters(library) {
 	const names = Object.keys(library);
 	const props = {};
+	const propOwners = /* @__PURE__ */ new Map();
 	for (const name of names) {
 		const propsSchema = toJSONSchema(library[name].properties);
 		if (propsSchema.type !== "object") throw new Error(`[@assistant-ui/react-generative-ui] Component "${name}": \`properties\` must be an object schema (e.g. \`z.object({ ... })\`).`);
 		for (const [key, schema] of Object.entries(propsSchema.properties ?? {})) {
-			if (key === "$type" || key === "children") continue;
+			if (key.startsWith("$") || key === "children") continue;
 			if (!(key in props)) props[key] = schema;
-			else if (process.env["NODE_ENV"] !== "production") console.warn(`[@assistant-ui/react-generative-ui] Prop "${key}" is declared by more than one component; the first component's schema is kept and the rest are ignored. Rename or align the type to avoid an ambiguous schema.`);
+			propOwners.set(key, [...propOwners.get(key) ?? [], name]);
 		}
 	}
+	if (process.env["NODE_ENV"] !== "production") for (const [key, owners] of propOwners) {
+		if (owners.length < 2) continue;
+		console.warn(`[@assistant-ui/react-generative-ui] Prop "${key}" is declared by ${formatComponentList(owners)}; keeping "${owners[0]}"'s schema. Rename or align the prop type to avoid an ambiguous schema.`);
+	}
 	const typeDescription = names.length > 0 ? `The component to render. ${names.map((name) => `"${name}": ${library[name].description}`).join("; ")}` : "The component to render.";
 	const node = {
 		type: "object",
@@ -38,6 +44,10 @@ function buildPresentParameters(library) {
 				enum: names,
 				description: typeDescription
 			},
+			$key: {
+				description: "Stable identity for this UI node. Use it for list items that may reorder.",
+				anyOf: [{ type: "string" }, { type: "number" }]
+			},
 			...props,
 			children: { $ref: "#/$defs/children" }
 		},
@@ -62,6 +72,10 @@ function buildPresentParameters(library) {
 		}
 	};
 }
+function formatComponentList(names) {
+	if (names.length <= 2) return names.map((name) => `"${name}"`).join(" and ");
+	return `${names.slice(0, -1).map((name) => `"${name}"`).join(", ")}, and "${names[names.length - 1]}"`;
+}
 //#endregion
 export { buildPresentParameters };
 

package/dist/buildPresentParameters.js.map

@@ -1 +1 @@
-{"version":3,"file":"buildPresentParameters.js","names":[],"sources":["../src/buildPresentParameters.ts"],"sourcesContent":["import { toJSONSchema } from \"assistant-stream\";\nimport type { JSONSchema7, JSONSchema7Definition } from \"json-schema\";\nimport { TYPE_KEY } from \"./constants\";\nimport type { GenerativeUILibrary } from \"./types\";\n\n/**\n * Builds the JSON schema for the `present` tool from a {@link GenerativeUILibrary}.\n *\n * The model produces a node `{ $type, ...props }` where `$type` selects a\n * component and the rest are its props. The schema is a flat object: `$type` is\n * an enum of the component names, every component's props are merged into one\n * optional bag, and `children` recurses via `$defs` so the tree can nest.\n *\n * It is intentionally flat rather than a per-`$type` discriminated union. Tool /\n * function-call schemas (OpenAI and others) require the top-level parameters to\n * be a plain object and reject a top-level `oneOf`/`anyOf`/`enum`. So props can't\n * be refined per `$type` at the root; the model is guided instead by `$type`'s\n * description (which lists each component) and each prop's own description. The\n * renderer validates nothing here — an unknown `$type` or stray prop is handled\n * at render time — so a looser schema only costs the model a hint, not safety.\n */\nexport function buildPresentParameters(\n  library: GenerativeUILibrary,\n): JSONSchema7 {\n  const names = Object.keys(library);\n\n  // Merge every component's props into one optional bag. `$type`/`children` are\n  // framework-reserved, so drop any author-declared copies. On a name clash the\n  // first component's schema wins — props are an advisory hint here, not a\n  // strict per-component contract.\n  const props: Record<string, JSONSchema7Definition> = {};\n  for (const name of names) {\n    const propsSchema = toJSONSchema(library[name]!.properties);\n    if (propsSchema.type !== \"object\") {\n      throw new Error(\n        `[@assistant-ui/react-generative-ui] Component \"${name}\": ` +\n          \"`properties` must be an object schema (e.g. `z.object({ ... })`).\",\n      );\n    }\n    for (const [key, schema] of Object.entries(propsSchema.properties ?? {})) {\n      if (key === TYPE_KEY || key === \"children\") continue;\n      if (!(key in props)) {\n        props[key] = schema;\n      } else if (process.env[\"NODE_ENV\"] !== \"production\") {\n        // eslint-disable-next-line no-console\n        console.warn(\n          `[@assistant-ui/react-generative-ui] Prop \"${key}\" is declared by more ` +\n            \"than one component; the first component's schema is kept and the rest \" +\n            \"are ignored. Rename or align the type to avoid an ambiguous schema.\",\n        );\n      }\n    }\n  }\n\n  // Carry each component's description on the `$type` enum, since there are no\n  // per-branch schemas to hang them on anymore.\n  const typeDescription =\n    names.length > 0\n      ? `The component to render. ${names\n          .map((name) => `\"${name}\": ${library[name]!.description}`)\n          .join(\"; \")}`\n      : \"The component to render.\";\n\n  const node: JSONSchema7 = {\n    type: \"object\",\n    properties: {\n      [TYPE_KEY]: { type: \"string\", enum: names, description: typeDescription },\n      ...props,\n      children: { $ref: \"#/$defs/children\" },\n    },\n    required: [TYPE_KEY],\n  };\n\n  const children: JSONSchema7 = {\n    description: \"Nested generative UI rendered inside this component.\",\n    anyOf: [\n      { type: \"string\" },\n      { $ref: \"#/$defs/node\" },\n      {\n        type: \"array\",\n        items: { anyOf: [{ type: \"string\" }, { $ref: \"#/$defs/node\" }] },\n      },\n    ],\n  };\n\n  return {\n    ...node,\n    $defs: { node, children },\n  };\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;AAqBA,SAAgB,uBACd,SACa;CACb,MAAM,QAAQ,OAAO,KAAK,OAAO;CAMjC,MAAM,QAA+C,CAAC;CACtD,KAAK,MAAM,QAAQ,OAAO;EACxB,MAAM,cAAc,aAAa,QAAQ,KAAK,CAAE,UAAU;EAC1D,IAAI,YAAY,SAAS,UACvB,MAAM,IAAI,MACR,kDAAkD,KAAK,yEAEzD;EAEF,KAAK,MAAM,CAAC,KAAK,WAAW,OAAO,QAAQ,YAAY,cAAc,CAAC,CAAC,GAAG;GACxE,IAAI,QAAA,WAAoB,QAAQ,YAAY;GAC5C,IAAI,EAAE,OAAO,QACX,MAAM,OAAO;QACR,IAAI,QAAQ,IAAI,gBAAgB,cAErC,QAAQ,KACN,6CAA6C,IAAI,gKAGnD;EAEJ;CACF;CAIA,MAAM,kBACJ,MAAM,SAAS,IACX,4BAA4B,MACzB,KAAK,SAAS,IAAI,KAAK,KAAK,QAAQ,KAAK,CAAE,aAAa,CAAC,CACzD,KAAK,IAAI,MACZ;CAEN,MAAM,OAAoB;EACxB,MAAM;EACN,YAAY;IACT,WAAW;IAAE,MAAM;IAAU,MAAM;IAAO,aAAa;GAAgB;GACxE,GAAG;GACH,UAAU,EAAE,MAAM,mBAAmB;EACvC;EACA,UAAU,CAAC,QAAQ;CACrB;CAEA,MAAM,WAAwB;EAC5B,aAAa;EACb,OAAO;GACL,EAAE,MAAM,SAAS;GACjB,EAAE,MAAM,eAAe;GACvB;IACE,MAAM;IACN,OAAO,EAAE,OAAO,CAAC,EAAE,MAAM,SAAS,GAAG,EAAE,MAAM,eAAe,CAAC,EAAE;GACjE;EACF;CACF;CAEA,OAAO;EACL,GAAG;EACH,OAAO;GAAE;GAAM;EAAS;CAC1B;AACF"}
+{"version":3,"file":"buildPresentParameters.js","names":[],"sources":["../src/buildPresentParameters.ts"],"sourcesContent":["import { toJSONSchema } from \"assistant-stream\";\nimport type { JSONSchema7, JSONSchema7Definition } from \"json-schema\";\nimport { TYPE_KEY } from \"./constants\";\nimport type { GenerativeUILibrary } from \"./types\";\n\n/**\n * Builds the JSON schema for the `present` tool from a {@link GenerativeUILibrary}.\n *\n * The model produces a node `{ $type, $key?, ...props }` where `$type` selects\n * a component, the optional `$key` pins a stable identity for list items that\n * may reorder, and the rest are its props. The schema is a flat object: `$type`\n * is an enum of the component names, every component's props are merged into\n * one optional bag, and `children` recurses via `$defs` so the tree can nest.\n *\n * It is intentionally flat rather than a per-`$type` discriminated union. Tool /\n * function-call schemas (OpenAI and others) require the top-level parameters to\n * be a plain object and reject a top-level `oneOf`/`anyOf`/`enum`. So props can't\n * be refined per `$type` at the root; the model is guided instead by `$type`'s\n * description (which lists each component) and each prop's own description. The\n * renderer validates nothing here — an unknown `$type` or stray prop is handled\n * at render time — so a looser schema only costs the model a hint, not safety.\n */\nexport function buildPresentParameters(\n  library: GenerativeUILibrary,\n): JSONSchema7 {\n  const names = Object.keys(library);\n\n  // Merge every component's props into one optional bag. `$`-prefixed keys and\n  // `children` are framework-reserved (see ir.ts), so drop any author-declared\n  // copies. On a name clash the first component's schema wins — props are an\n  // advisory hint here, not a strict per-component contract.\n  const props: Record<string, JSONSchema7Definition> = {};\n  const propOwners = new Map<string, string[]>();\n  for (const name of names) {\n    const propsSchema = toJSONSchema(library[name]!.properties);\n    if (propsSchema.type !== \"object\") {\n      throw new Error(\n        `[@assistant-ui/react-generative-ui] Component \"${name}\": ` +\n          \"`properties` must be an object schema (e.g. `z.object({ ... })`).\",\n      );\n    }\n    for (const [key, schema] of Object.entries(propsSchema.properties ?? {})) {\n      if (key.startsWith(\"$\") || key === \"children\") continue;\n      if (!(key in props)) {\n        props[key] = schema;\n      }\n      propOwners.set(key, [...(propOwners.get(key) ?? []), name]);\n    }\n  }\n\n  if (process.env[\"NODE_ENV\"] !== \"production\") {\n    for (const [key, owners] of propOwners) {\n      if (owners.length < 2) continue;\n      // eslint-disable-next-line no-console\n      console.warn(\n        `[@assistant-ui/react-generative-ui] Prop \"${key}\" is declared by ` +\n          `${formatComponentList(owners)}; keeping \"${owners[0]}\"'s schema. ` +\n          \"Rename or align the prop type to avoid an ambiguous schema.\",\n      );\n    }\n  }\n\n  // Carry each component's description on the `$type` enum, since there are no\n  // per-branch schemas to hang them on anymore.\n  const typeDescription =\n    names.length > 0\n      ? `The component to render. ${names\n          .map((name) => `\"${name}\": ${library[name]!.description}`)\n          .join(\"; \")}`\n      : \"The component to render.\";\n\n  const node: JSONSchema7 = {\n    type: \"object\",\n    properties: {\n      [TYPE_KEY]: { type: \"string\", enum: names, description: typeDescription },\n      $key: {\n        description:\n          \"Stable identity for this UI node. Use it for list items that may reorder.\",\n        anyOf: [{ type: \"string\" }, { type: \"number\" }],\n      },\n      ...props,\n      children: { $ref: \"#/$defs/children\" },\n    },\n    required: [TYPE_KEY],\n  };\n\n  const children: JSONSchema7 = {\n    description: \"Nested generative UI rendered inside this component.\",\n    anyOf: [\n      { type: \"string\" },\n      { $ref: \"#/$defs/node\" },\n      {\n        type: \"array\",\n        items: { anyOf: [{ type: \"string\" }, { $ref: \"#/$defs/node\" }] },\n      },\n    ],\n  };\n\n  return {\n    ...node,\n    $defs: { node, children },\n  };\n}\n\nfunction formatComponentList(names: string[]) {\n  if (names.length <= 2) return names.map((name) => `\"${name}\"`).join(\" and \");\n\n  return `${names\n    .slice(0, -1)\n    .map((name) => `\"${name}\"`)\n    .join(\", \")}, and \"${names[names.length - 1]}\"`;\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;;AAsBA,SAAgB,uBACd,SACa;CACb,MAAM,QAAQ,OAAO,KAAK,OAAO;CAMjC,MAAM,QAA+C,CAAC;CACtD,MAAM,6BAAa,IAAI,IAAsB;CAC7C,KAAK,MAAM,QAAQ,OAAO;EACxB,MAAM,cAAc,aAAa,QAAQ,KAAK,CAAE,UAAU;EAC1D,IAAI,YAAY,SAAS,UACvB,MAAM,IAAI,MACR,kDAAkD,KAAK,yEAEzD;EAEF,KAAK,MAAM,CAAC,KAAK,WAAW,OAAO,QAAQ,YAAY,cAAc,CAAC,CAAC,GAAG;GACxE,IAAI,IAAI,WAAW,GAAG,KAAK,QAAQ,YAAY;GAC/C,IAAI,EAAE,OAAO,QACX,MAAM,OAAO;GAEf,WAAW,IAAI,KAAK,CAAC,GAAI,WAAW,IAAI,GAAG,KAAK,CAAC,GAAI,IAAI,CAAC;EAC5D;CACF;CAEA,IAAI,QAAQ,IAAI,gBAAgB,cAC9B,KAAK,MAAM,CAAC,KAAK,WAAW,YAAY;EACtC,IAAI,OAAO,SAAS,GAAG;EAEvB,QAAQ,KACN,6CAA6C,IAAI,mBAC5C,oBAAoB,MAAM,EAAE,aAAa,OAAO,GAAG,wEAE1D;CACF;CAKF,MAAM,kBACJ,MAAM,SAAS,IACX,4BAA4B,MACzB,KAAK,SAAS,IAAI,KAAK,KAAK,QAAQ,KAAK,CAAE,aAAa,CAAC,CACzD,KAAK,IAAI,MACZ;CAEN,MAAM,OAAoB;EACxB,MAAM;EACN,YAAY;IACT,WAAW;IAAE,MAAM;IAAU,MAAM;IAAO,aAAa;GAAgB;GACxE,MAAM;IACJ,aACE;IACF,OAAO,CAAC,EAAE,MAAM,SAAS,GAAG,EAAE,MAAM,SAAS,CAAC;GAChD;GACA,GAAG;GACH,UAAU,EAAE,MAAM,mBAAmB;EACvC;EACA,UAAU,CAAC,QAAQ;CACrB;CAEA,MAAM,WAAwB;EAC5B,aAAa;EACb,OAAO;GACL,EAAE,MAAM,SAAS;GACjB,EAAE,MAAM,eAAe;GACvB;IACE,MAAM;IACN,OAAO,EAAE,OAAO,CAAC,EAAE,MAAM,SAAS,GAAG,EAAE,MAAM,eAAe,CAAC,EAAE;GACjE;EACF;CACF;CAEA,OAAO;EACL,GAAG;EACH,OAAO;GAAE;GAAM;EAAS;CAC1B;AACF;AAEA,SAAS,oBAAoB,OAAiB;CAC5C,IAAI,MAAM,UAAU,GAAG,OAAO,MAAM,KAAK,SAAS,IAAI,KAAK,EAAE,CAAC,CAAC,KAAK,OAAO;CAE3E,OAAO,GAAG,MACP,MAAM,GAAG,EAAE,CAAC,CACZ,KAAK,SAAS,IAAI,KAAK,EAAE,CAAC,CAC1B,KAAK,IAAI,EAAE,SAAS,MAAM,MAAM,SAAS,GAAG;AACjD"}

package/dist/constants.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"constants.d.ts","names":[],"sources":["../src/constants.ts"],"mappings":";;AASA;;;;AAAqB;;;;cAAR,QAAA"}
+{"version":3,"file":"constants.d.ts","names":[],"sources":["../src/constants.ts"],"mappings":";;;;;;;;;;cASa"}

package/dist/defineGenerativeComponents.d.ts

@@ -1,5 +1,4 @@
 import { GenerativeUILibrary } from "./types.js";
-
 //#region src/defineGenerativeComponents.d.ts
 /**
  * Authoring helper for a `"use generative"` generative-UI library — the set of

package/dist/defineGenerativeComponents.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"defineGenerativeComponents.d.ts","names":[],"sources":["../src/defineGenerativeComponents.ts"],"mappings":";;;;;AA4BA;;;;;;;;AAEsB;;;;;;;;;;;;;;;;iBAFN,0BAAA,CACd,QAAA,EAAU,mBAAA,GACT,mBAAmB"}
+{"version":3,"file":"defineGenerativeComponents.d.ts","names":[],"sources":["../src/defineGenerativeComponents.ts"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;iBA4BgB,2BACd,UAAU,sBACT"}

package/dist/generativeUIToJSX.d.ts

@@ -1,16 +1,21 @@
 //#region src/generativeUIToJSX.d.ts
+/** Options for {@link generativeUIToJSX}. */
+interface GenerativeUIToJSXOptions {
+  /** Escape string children so the output is safe to paste back into a JSX file. Defaults to `false`. */
+  escape?: boolean;
+  /** Pretty-print nested element trees with two-space indentation. Defaults to `false`. */
+  pretty?: boolean;
+}
 /**
- * Serializes a generative-UI node to a JSX-like string for display — the
- * "view source" of a model-produced tree. The wire form
- * `{ $type: "Weather", id: "x" }` becomes `<Weather id="x" />`, and nested
- * `children` render between tags: `<Card title="Hi"><Text>hello</Text></Card>`.
+ * Serializes a generative-UI node to a JSX-like string for display: the "view source" of a model-produced tree. The wire form `{ $type: "Weather", id: "x" }` becomes `<Weather id="x" />`, and nested `children` render between tags: `<Card title="Hi"><Text>hello</Text></Card>`. A model-provided `$key` becomes the JSX `key` attribute.
  *
- * It is a faithful textual rendering, not a parser: text children are emitted
- * verbatim (not HTML/JSX-escaped), so the result is meant to be shown, not
- * re-parsed. Returns `""` for nodes that aren't renderable (no `$type` yet,
- * `null`, booleans).
+ * By default this is a faithful textual rendering, not a parser: text children are emitted verbatim (not HTML/JSX-escaped), so the result is meant to be shown, not re-parsed. Returns `""` for nodes that aren't renderable (no `$type` yet, `null`, booleans).
+ *
+ * Pass `{ escape: true }` to make the output safe to paste back into JSX: any string child containing `<`, `>`, `&`, `{`, or `}` is emitted as a JSON-stringified expression (`{JSON.stringify(child)}`) instead of verbatim, while a string child with none of those characters still renders verbatim.
+ *
+ * Pass `{ pretty: true }` to pretty-print nested element trees with two-space indentation, while pure text children stay on one line.
  */
-declare function generativeUIToJSX(node: unknown): string;
+declare function generativeUIToJSX(node: unknown, options?: GenerativeUIToJSXOptions): string;
 //#endregion
-export { generativeUIToJSX };
+export { GenerativeUIToJSXOptions, generativeUIToJSX };
 //# sourceMappingURL=generativeUIToJSX.d.ts.map

package/dist/generativeUIToJSX.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"generativeUIToJSX.d.ts","names":[],"sources":["../src/generativeUIToJSX.ts"],"mappings":";;AAaA;;;;AAA+C;;;;;;iBAA/B,iBAAA,CAAkB,IAAa"}
+{"version":3,"file":"generativeUIToJSX.d.ts","names":[],"sources":["../src/generativeUIToJSX.ts"],"mappings":";;UAGiB;;EAEf;;EAEA;;;;;;;;;;;iBAYc,kBACd,eACA,UAAU"}

package/dist/generativeUIToJSX.js

@@ -1,18 +1,16 @@
 import { TYPE_KEY } from "./constants.js";
 //#region src/generativeUIToJSX.ts
 /**
-* Serializes a generative-UI node to a JSX-like string for display — the
-* "view source" of a model-produced tree. The wire form
-* `{ $type: "Weather", id: "x" }` becomes `<Weather id="x" />`, and nested
-* `children` render between tags: `<Card title="Hi"><Text>hello</Text></Card>`.
+* Serializes a generative-UI node to a JSX-like string for display: the "view source" of a model-produced tree. The wire form `{ $type: "Weather", id: "x" }` becomes `<Weather id="x" />`, and nested `children` render between tags: `<Card title="Hi"><Text>hello</Text></Card>`. A model-provided `$key` becomes the JSX `key` attribute.
 *
-* It is a faithful textual rendering, not a parser: text children are emitted
-* verbatim (not HTML/JSX-escaped), so the result is meant to be shown, not
-* re-parsed. Returns `""` for nodes that aren't renderable (no `$type` yet,
-* `null`, booleans).
+* By default this is a faithful textual rendering, not a parser: text children are emitted verbatim (not HTML/JSX-escaped), so the result is meant to be shown, not re-parsed. Returns `""` for nodes that aren't renderable (no `$type` yet, `null`, booleans).
+*
+* Pass `{ escape: true }` to make the output safe to paste back into JSX: any string child containing `<`, `>`, `&`, `{`, or `}` is emitted as a JSON-stringified expression (`{JSON.stringify(child)}`) instead of verbatim, while a string child with none of those characters still renders verbatim.
+*
+* Pass `{ pretty: true }` to pretty-print nested element trees with two-space indentation, while pure text children stay on one line.
 */
-function generativeUIToJSX(node) {
-	return toJSX(node, 0);
+function generativeUIToJSX(node, options) {
+	return toJSX(node, 0, options?.escape ?? false, options?.pretty ?? false, 0);
 }
 /**
 * The deepest tree we serialize. Input is model-produced, so a runaway/
@@ -20,18 +18,50 @@ function generativeUIToJSX(node) {
 * this depth (far beyond any real UI) we stop. Mirrors the renderer's bound.
 */
 const MAX_DEPTH = 64;
-function toJSX(node, depth) {
+/** Characters that would break JSX if emitted verbatim inside a text child. */
+const UNSAFE_CHILD_CHARS = /[<>&{}]/;
+function toJSX(node, depth, escape, pretty, indent) {
 	if (depth > MAX_DEPTH) return "";
 	if (node == null || typeof node === "boolean") return "";
-	if (typeof node === "string") return node;
+	if (typeof node === "string") return formatChildText(node, escape);
 	if (typeof node === "number") return String(node);
-	if (Array.isArray(node)) return node.map((child) => toJSX(child, depth + 1)).join("");
+	if (Array.isArray(node)) {
+		if (pretty) return collectBlockLines(node, depth, escape, indent).join("\n");
+		return node.map((child) => toJSX(child, depth + 1, escape, false, 0)).join("");
+	}
 	if (typeof node !== "object") return "";
-	const { [TYPE_KEY]: type, children, ...props } = node;
+	const { [TYPE_KEY]: type, $key, children, ...props } = node;
 	if (typeof type !== "string") return "";
-	const attrs = Object.entries(props).map(([key, value]) => formatAttr(key, value)).join("");
-	const inner = children === void 0 ? "" : toJSX(children, depth + 1);
-	return inner === "" ? `<${type}${attrs} />` : `<${type}${attrs}>${inner}</${type}>`;
+	const attrs = formatAttr("key", $key) + Object.entries(props).map(([key, value]) => formatAttr(key, value)).join("");
+	if (!pretty) {
+		const inner = children === void 0 ? "" : toJSX(children, depth + 1, escape, false, 0);
+		return inner === "" ? `<${type}${attrs} />` : `<${type}${attrs}>${inner}</${type}>`;
+	}
+	const pad = "  ".repeat(indent);
+	if (children === void 0 || !hasElementChild(children)) {
+		const inner = children === void 0 ? "" : toJSX(children, depth + 1, escape, false, 0);
+		return inner === "" ? `${pad}<${type}${attrs} />` : `${pad}<${type}${attrs}>${inner}</${type}>`;
+	}
+	const lines = collectBlockLines(children, depth + 1, escape, indent + 1);
+	if (lines.length === 0) return `${pad}<${type}${attrs} />`;
+	return `${pad}<${type}${attrs}>\n${lines.join("\n")}\n${pad}</${type}>`;
+}
+function hasElementChild(node, depth = 0) {
+	if (depth > MAX_DEPTH) return false;
+	if (Array.isArray(node)) return node.some((child) => hasElementChild(child, depth + 1));
+	return node != null && typeof node === "object" && typeof node["$type"] === "string";
+}
+function collectBlockLines(node, depth, escape, indent) {
+	if (depth > MAX_DEPTH) return [];
+	if (node == null || typeof node === "boolean") return [];
+	if (Array.isArray(node)) return node.flatMap((child) => collectBlockLines(child, depth + 1, escape, indent));
+	if (typeof node === "string") return [`${"  ".repeat(indent)}${formatChildText(node, escape)}`];
+	if (typeof node === "number") return [`${"  ".repeat(indent)}${String(node)}`];
+	const rendered = toJSX(node, depth, escape, true, indent);
+	return rendered === "" ? [] : [rendered];
+}
+function formatChildText(value, escape) {
+	return escape && UNSAFE_CHILD_CHARS.test(value) ? `{${JSON.stringify(value)}}` : value;
 }
 /** Formats one prop as a JSX attribute (`id="x"`, `count={3}`, `open`, …). */
 function formatAttr(key, value) {

package/dist/generativeUIToJSX.js.map

@@ -1 +1 @@
-{"version":3,"file":"generativeUIToJSX.js","names":[],"sources":["../src/generativeUIToJSX.ts"],"sourcesContent":["import { TYPE_KEY } from \"./constants\";\n\n/**\n * Serializes a generative-UI node to a JSX-like string for display — the\n * \"view source\" of a model-produced tree. The wire form\n * `{ $type: \"Weather\", id: \"x\" }` becomes `<Weather id=\"x\" />`, and nested\n * `children` render between tags: `<Card title=\"Hi\"><Text>hello</Text></Card>`.\n *\n * It is a faithful textual rendering, not a parser: text children are emitted\n * verbatim (not HTML/JSX-escaped), so the result is meant to be shown, not\n * re-parsed. Returns `\"\"` for nodes that aren't renderable (no `$type` yet,\n * `null`, booleans).\n */\nexport function generativeUIToJSX(node: unknown): string {\n  return toJSX(node, 0);\n}\n\n/**\n * The deepest tree we serialize. Input is model-produced, so a runaway/\n * adversarial response could nest arbitrarily deep and overflow the stack — past\n * this depth (far beyond any real UI) we stop. Mirrors the renderer's bound.\n */\nconst MAX_DEPTH = 64;\n\nfunction toJSX(node: unknown, depth: number): string {\n  if (depth > MAX_DEPTH) return \"\";\n  if (node == null || typeof node === \"boolean\") return \"\";\n  if (typeof node === \"string\") return node;\n  if (typeof node === \"number\") return String(node);\n  if (Array.isArray(node))\n    return node.map((child) => toJSX(child, depth + 1)).join(\"\");\n  if (typeof node !== \"object\") return \"\";\n\n  const {\n    [TYPE_KEY]: type,\n    children,\n    ...props\n  } = node as Record<string, unknown>;\n  if (typeof type !== \"string\") return \"\";\n\n  const attrs = Object.entries(props)\n    .map(([key, value]) => formatAttr(key, value))\n    .join(\"\");\n  const inner = children === undefined ? \"\" : toJSX(children, depth + 1);\n\n  return inner === \"\"\n    ? `<${type}${attrs} />`\n    : `<${type}${attrs}>${inner}</${type}>`;\n}\n\n/** Formats one prop as a JSX attribute (`id=\"x\"`, `count={3}`, `open`, …). */\nfunction formatAttr(key: string, value: unknown): string {\n  if (value === undefined) return \"\";\n  if (value === true) return ` ${key}`;\n  if (typeof value === \"string\") {\n    // Plain double-quoted form when safe; expression form when a quote or\n    // newline would break the attribute.\n    return /[\"\\n]/.test(value)\n      ? ` ${key}={${JSON.stringify(value)}}`\n      : ` ${key}=\"${value}\"`;\n  }\n  return ` ${key}={${JSON.stringify(value)}}`;\n}\n"],"mappings":";;;;;;;;;;;;;AAaA,SAAgB,kBAAkB,MAAuB;CACvD,OAAO,MAAM,MAAM,CAAC;AACtB;;;;;;AAOA,MAAM,YAAY;AAElB,SAAS,MAAM,MAAe,OAAuB;CACnD,IAAI,QAAQ,WAAW,OAAO;CAC9B,IAAI,QAAQ,QAAQ,OAAO,SAAS,WAAW,OAAO;CACtD,IAAI,OAAO,SAAS,UAAU,OAAO;CACrC,IAAI,OAAO,SAAS,UAAU,OAAO,OAAO,IAAI;CAChD,IAAI,MAAM,QAAQ,IAAI,GACpB,OAAO,KAAK,KAAK,UAAU,MAAM,OAAO,QAAQ,CAAC,CAAC,CAAC,CAAC,KAAK,EAAE;CAC7D,IAAI,OAAO,SAAS,UAAU,OAAO;CAErC,MAAM,GACH,WAAW,MACZ,UACA,GAAG,UACD;CACJ,IAAI,OAAO,SAAS,UAAU,OAAO;CAErC,MAAM,QAAQ,OAAO,QAAQ,KAAK,CAAC,CAChC,KAAK,CAAC,KAAK,WAAW,WAAW,KAAK,KAAK,CAAC,CAAC,CAC7C,KAAK,EAAE;CACV,MAAM,QAAQ,aAAa,KAAA,IAAY,KAAK,MAAM,UAAU,QAAQ,CAAC;CAErE,OAAO,UAAU,KACb,IAAI,OAAO,MAAM,OACjB,IAAI,OAAO,MAAM,GAAG,MAAM,IAAI,KAAK;AACzC;;AAGA,SAAS,WAAW,KAAa,OAAwB;CACvD,IAAI,UAAU,KAAA,GAAW,OAAO;CAChC,IAAI,UAAU,MAAM,OAAO,IAAI;CAC/B,IAAI,OAAO,UAAU,UAGnB,OAAO,QAAQ,KAAK,KAAK,IACrB,IAAI,IAAI,IAAI,KAAK,UAAU,KAAK,EAAE,KAClC,IAAI,IAAI,IAAI,MAAM;CAExB,OAAO,IAAI,IAAI,IAAI,KAAK,UAAU,KAAK,EAAE;AAC3C"}
+{"version":3,"file":"generativeUIToJSX.js","names":[],"sources":["../src/generativeUIToJSX.ts"],"sourcesContent":["import { TYPE_KEY } from \"./constants\";\n\n/** Options for {@link generativeUIToJSX}. */\nexport interface GenerativeUIToJSXOptions {\n  /** Escape string children so the output is safe to paste back into a JSX file. Defaults to `false`. */\n  escape?: boolean;\n  /** Pretty-print nested element trees with two-space indentation. Defaults to `false`. */\n  pretty?: boolean;\n}\n\n/**\n * Serializes a generative-UI node to a JSX-like string for display: the \"view source\" of a model-produced tree. The wire form `{ $type: \"Weather\", id: \"x\" }` becomes `<Weather id=\"x\" />`, and nested `children` render between tags: `<Card title=\"Hi\"><Text>hello</Text></Card>`. A model-provided `$key` becomes the JSX `key` attribute.\n *\n * By default this is a faithful textual rendering, not a parser: text children are emitted verbatim (not HTML/JSX-escaped), so the result is meant to be shown, not re-parsed. Returns `\"\"` for nodes that aren't renderable (no `$type` yet, `null`, booleans).\n *\n * Pass `{ escape: true }` to make the output safe to paste back into JSX: any string child containing `<`, `>`, `&`, `{`, or `}` is emitted as a JSON-stringified expression (`{JSON.stringify(child)}`) instead of verbatim, while a string child with none of those characters still renders verbatim.\n *\n * Pass `{ pretty: true }` to pretty-print nested element trees with two-space indentation, while pure text children stay on one line.\n */\nexport function generativeUIToJSX(\n  node: unknown,\n  options?: GenerativeUIToJSXOptions,\n): string {\n  return toJSX(node, 0, options?.escape ?? false, options?.pretty ?? false, 0);\n}\n\n/**\n * The deepest tree we serialize. Input is model-produced, so a runaway/\n * adversarial response could nest arbitrarily deep and overflow the stack — past\n * this depth (far beyond any real UI) we stop. Mirrors the renderer's bound.\n */\nconst MAX_DEPTH = 64;\n\n/** Characters that would break JSX if emitted verbatim inside a text child. */\nconst UNSAFE_CHILD_CHARS = /[<>&{}]/;\n\nfunction toJSX(\n  node: unknown,\n  depth: number,\n  escape: boolean,\n  pretty: boolean,\n  indent: number,\n): string {\n  if (depth > MAX_DEPTH) return \"\";\n  if (node == null || typeof node === \"boolean\") return \"\";\n  if (typeof node === \"string\") return formatChildText(node, escape);\n  if (typeof node === \"number\") return String(node);\n  if (Array.isArray(node)) {\n    if (pretty) {\n      return collectBlockLines(node, depth, escape, indent).join(\"\\n\");\n    }\n    return node\n      .map((child) => toJSX(child, depth + 1, escape, false, 0))\n      .join(\"\");\n  }\n  if (typeof node !== \"object\") return \"\";\n\n  const {\n    [TYPE_KEY]: type,\n    $key,\n    children,\n    ...props\n  } = node as Record<string, unknown>;\n  if (typeof type !== \"string\") return \"\";\n\n  const attrs =\n    formatAttr(\"key\", $key) +\n    Object.entries(props)\n      .map(([key, value]) => formatAttr(key, value))\n      .join(\"\");\n\n  if (!pretty) {\n    const inner =\n      children === undefined\n        ? \"\"\n        : toJSX(children, depth + 1, escape, false, 0);\n\n    return inner === \"\"\n      ? `<${type}${attrs} />`\n      : `<${type}${attrs}>${inner}</${type}>`;\n  }\n\n  const pad = \"  \".repeat(indent);\n\n  if (children === undefined || !hasElementChild(children)) {\n    const inner =\n      children === undefined\n        ? \"\"\n        : toJSX(children, depth + 1, escape, false, 0);\n    return inner === \"\"\n      ? `${pad}<${type}${attrs} />`\n      : `${pad}<${type}${attrs}>${inner}</${type}>`;\n  }\n\n  const lines = collectBlockLines(children, depth + 1, escape, indent + 1);\n  if (lines.length === 0) {\n    return `${pad}<${type}${attrs} />`;\n  }\n  return `${pad}<${type}${attrs}>\\n${lines.join(\"\\n\")}\\n${pad}</${type}>`;\n}\n\nfunction hasElementChild(node: unknown, depth = 0): boolean {\n  if (depth > MAX_DEPTH) return false;\n  if (Array.isArray(node))\n    return node.some((child) => hasElementChild(child, depth + 1));\n  return (\n    node != null &&\n    typeof node === \"object\" &&\n    typeof (node as Record<string, unknown>)[TYPE_KEY] === \"string\"\n  );\n}\n\nfunction collectBlockLines(\n  node: unknown,\n  depth: number,\n  escape: boolean,\n  indent: number,\n): string[] {\n  if (depth > MAX_DEPTH) return [];\n  if (node == null || typeof node === \"boolean\") return [];\n  if (Array.isArray(node)) {\n    return node.flatMap((child) =>\n      collectBlockLines(child, depth + 1, escape, indent),\n    );\n  }\n  if (typeof node === \"string\") {\n    return [`${\"  \".repeat(indent)}${formatChildText(node, escape)}`];\n  }\n  if (typeof node === \"number\") {\n    return [`${\"  \".repeat(indent)}${String(node)}`];\n  }\n  const rendered = toJSX(node, depth, escape, true, indent);\n  return rendered === \"\" ? [] : [rendered];\n}\n\nfunction formatChildText(value: string, escape: boolean): string {\n  return escape && UNSAFE_CHILD_CHARS.test(value)\n    ? `{${JSON.stringify(value)}}`\n    : value;\n}\n\n/** Formats one prop as a JSX attribute (`id=\"x\"`, `count={3}`, `open`, …). */\nfunction formatAttr(key: string, value: unknown): string {\n  if (value === undefined) return \"\";\n  if (value === true) return ` ${key}`;\n  if (typeof value === \"string\") {\n    // Plain double-quoted form when safe; expression form when a quote or\n    // newline would break the attribute.\n    return /[\"\\n]/.test(value)\n      ? ` ${key}={${JSON.stringify(value)}}`\n      : ` ${key}=\"${value}\"`;\n  }\n  return ` ${key}={${JSON.stringify(value)}}`;\n}\n"],"mappings":";;;;;;;;;;;AAmBA,SAAgB,kBACd,MACA,SACQ;CACR,OAAO,MAAM,MAAM,GAAG,SAAS,UAAU,OAAO,SAAS,UAAU,OAAO,CAAC;AAC7E;;;;;;AAOA,MAAM,YAAY;;AAGlB,MAAM,qBAAqB;AAE3B,SAAS,MACP,MACA,OACA,QACA,QACA,QACQ;CACR,IAAI,QAAQ,WAAW,OAAO;CAC9B,IAAI,QAAQ,QAAQ,OAAO,SAAS,WAAW,OAAO;CACtD,IAAI,OAAO,SAAS,UAAU,OAAO,gBAAgB,MAAM,MAAM;CACjE,IAAI,OAAO,SAAS,UAAU,OAAO,OAAO,IAAI;CAChD,IAAI,MAAM,QAAQ,IAAI,GAAG;EACvB,IAAI,QACF,OAAO,kBAAkB,MAAM,OAAO,QAAQ,MAAM,CAAC,CAAC,KAAK,IAAI;EAEjE,OAAO,KACJ,KAAK,UAAU,MAAM,OAAO,QAAQ,GAAG,QAAQ,OAAO,CAAC,CAAC,CAAC,CACzD,KAAK,EAAE;CACZ;CACA,IAAI,OAAO,SAAS,UAAU,OAAO;CAErC,MAAM,GACH,WAAW,MACZ,MACA,UACA,GAAG,UACD;CACJ,IAAI,OAAO,SAAS,UAAU,OAAO;CAErC,MAAM,QACJ,WAAW,OAAO,IAAI,IACtB,OAAO,QAAQ,KAAK,CAAC,CAClB,KAAK,CAAC,KAAK,WAAW,WAAW,KAAK,KAAK,CAAC,CAAC,CAC7C,KAAK,EAAE;CAEZ,IAAI,CAAC,QAAQ;EACX,MAAM,QACJ,aAAa,KAAA,IACT,KACA,MAAM,UAAU,QAAQ,GAAG,QAAQ,OAAO,CAAC;EAEjD,OAAO,UAAU,KACb,IAAI,OAAO,MAAM,OACjB,IAAI,OAAO,MAAM,GAAG,MAAM,IAAI,KAAK;CACzC;CAEA,MAAM,MAAM,KAAK,OAAO,MAAM;CAE9B,IAAI,aAAa,KAAA,KAAa,CAAC,gBAAgB,QAAQ,GAAG;EACxD,MAAM,QACJ,aAAa,KAAA,IACT,KACA,MAAM,UAAU,QAAQ,GAAG,QAAQ,OAAO,CAAC;EACjD,OAAO,UAAU,KACb,GAAG,IAAI,GAAG,OAAO,MAAM,OACvB,GAAG,IAAI,GAAG,OAAO,MAAM,GAAG,MAAM,IAAI,KAAK;CAC/C;CAEA,MAAM,QAAQ,kBAAkB,UAAU,QAAQ,GAAG,QAAQ,SAAS,CAAC;CACvE,IAAI,MAAM,WAAW,GACnB,OAAO,GAAG,IAAI,GAAG,OAAO,MAAM;CAEhC,OAAO,GAAG,IAAI,GAAG,OAAO,MAAM,KAAK,MAAM,KAAK,IAAI,EAAE,IAAI,IAAI,IAAI,KAAK;AACvE;AAEA,SAAS,gBAAgB,MAAe,QAAQ,GAAY;CAC1D,IAAI,QAAQ,WAAW,OAAO;CAC9B,IAAI,MAAM,QAAQ,IAAI,GACpB,OAAO,KAAK,MAAM,UAAU,gBAAgB,OAAO,QAAQ,CAAC,CAAC;CAC/D,OACE,QAAQ,QACR,OAAO,SAAS,YAChB,OAAQ,KAAA,aAA+C;AAE3D;AAEA,SAAS,kBACP,MACA,OACA,QACA,QACU;CACV,IAAI,QAAQ,WAAW,OAAO,CAAC;CAC/B,IAAI,QAAQ,QAAQ,OAAO,SAAS,WAAW,OAAO,CAAC;CACvD,IAAI,MAAM,QAAQ,IAAI,GACpB,OAAO,KAAK,SAAS,UACnB,kBAAkB,OAAO,QAAQ,GAAG,QAAQ,MAAM,CACpD;CAEF,IAAI,OAAO,SAAS,UAClB,OAAO,CAAC,GAAG,KAAK,OAAO,MAAM,IAAI,gBAAgB,MAAM,MAAM,GAAG;CAElE,IAAI,OAAO,SAAS,UAClB,OAAO,CAAC,GAAG,KAAK,OAAO,MAAM,IAAI,OAAO,IAAI,GAAG;CAEjD,MAAM,WAAW,MAAM,MAAM,OAAO,QAAQ,MAAM,MAAM;CACxD,OAAO,aAAa,KAAK,CAAC,IAAI,CAAC,QAAQ;AACzC;AAEA,SAAS,gBAAgB,OAAe,QAAyB;CAC/D,OAAO,UAAU,mBAAmB,KAAK,KAAK,IAC1C,IAAI,KAAK,UAAU,KAAK,EAAE,KAC1B;AACN;;AAGA,SAAS,WAAW,KAAa,OAAwB;CACvD,IAAI,UAAU,KAAA,GAAW,OAAO;CAChC,IAAI,UAAU,MAAM,OAAO,IAAI;CAC/B,IAAI,OAAO,UAAU,UAGnB,OAAO,QAAQ,KAAK,KAAK,IACrB,IAAI,IAAI,IAAI,KAAK,UAAU,KAAK,EAAE,KAClC,IAAI,IAAI,IAAI,MAAM;CAExB,OAAO,IAAI,IAAI,IAAI,KAAK,UAAU,KAAK,EAAE;AAC3C"}

package/dist/index.d.ts

@@ -1,9 +1,13 @@
-import { GenerativeUIComponent, GenerativeUIElement, GenerativeUILibrary, GenerativeUINode, GenerativeUIProps, GenerativeUIRenderContext, GenerativeUIStatus } from "./types.js";
+import { ALERT_TONES, ALIGNS, Action, AlertTone, Align, BUTTON_STYLES, ButtonStyle, COLORS, Color, ICON_NAMES, IMAGE_SIZE_TOKENS, IconName, ImageSize, JUSTIFIES, Justify, LegacyComponentNode, NormalizedUIElement, NormalizedUINode, TEXT_SIZES, TextSize, UIChildren, UIElement, UINode, UISpec, WEIGHTS, Weight, normalizeSpec, normalizeUINode } from "./ir.js";
+import { ActionDispatchContext, ActionHandler, ActionRegistry, createActionRegistry, emptyActionRegistry } from "./actionRegistry.js";
+import { GenerativeUIAction, GenerativeUIComponent, GenerativeUIDispatch, GenerativeUIElement, GenerativeUILibrary, GenerativeUINode, GenerativeUIProps, GenerativeUIRenderContext, GenerativeUIStatus } from "./types.js";
 import { JSONGenerativeUIOptions, PresentTool, PresentToolOptions, PromptUserTool } from "./JSONGenerativeUI.shared.js";
+import { JSONGenerativeUI } from "./JSONGenerativeUI.client.js";
 import { buildPresentParameters } from "./buildPresentParameters.js";
 import { TYPE_KEY } from "./constants.js";
 import { defineGenerativeComponents } from "./defineGenerativeComponents.js";
-import { generativeUIToJSX } from "./generativeUIToJSX.js";
+import { GenerativeUIToJSXOptions, generativeUIToJSX } from "./generativeUIToJSX.js";
 import { renderGenerativeUI } from "./renderGenerativeUI.js";
-import { JSONGenerativeUI } from "@assistant-ui/react-generative-ui/internal-json";
-export { type GenerativeUIComponent, type GenerativeUIElement, type GenerativeUILibrary, type GenerativeUINode, type GenerativeUIProps, type GenerativeUIRenderContext, type GenerativeUIStatus, JSONGenerativeUI, type JSONGenerativeUIOptions, type PresentTool, type PresentToolOptions, type PromptUserTool, TYPE_KEY, buildPresentParameters, defineGenerativeComponents, generativeUIToJSX, renderGenerativeUI };
+import { defaultGenerativeUILibrary } from "./vocabulary/index.js";
+import "./index.shared.js";
+export { ALERT_TONES, ALIGNS, type Action, type ActionDispatchContext, type ActionHandler, type ActionRegistry, type AlertTone, type Align, BUTTON_STYLES, type ButtonStyle, COLORS, type Color, type GenerativeUIAction, type GenerativeUIComponent, type GenerativeUIDispatch, type GenerativeUIElement, type GenerativeUILibrary, type GenerativeUINode, type GenerativeUIProps, type GenerativeUIRenderContext, type GenerativeUIStatus, type GenerativeUIToJSXOptions, ICON_NAMES, IMAGE_SIZE_TOKENS, type IconName, type ImageSize, JSONGenerativeUI, type JSONGenerativeUIOptions, JUSTIFIES, type Justify, type LegacyComponentNode, type NormalizedUIElement, type NormalizedUINode, type PresentTool, type PresentToolOptions, type PromptUserTool, TEXT_SIZES, TYPE_KEY, type TextSize, type UIChildren, type UIElement, type UINode, type UISpec, WEIGHTS, type Weight, buildPresentParameters, createActionRegistry, defaultGenerativeUILibrary, defineGenerativeComponents, emptyActionRegistry, generativeUIToJSX, normalizeSpec, normalizeUINode, renderGenerativeUI };

package/dist/index.js

@@ -1,7 +1,10 @@
 import { TYPE_KEY } from "./constants.js";
 import { buildPresentParameters } from "./buildPresentParameters.js";
+import { ALERT_TONES, ALIGNS, BUTTON_STYLES, COLORS, ICON_NAMES, IMAGE_SIZE_TOKENS, JUSTIFIES, TEXT_SIZES, WEIGHTS, normalizeSpec, normalizeUINode } from "./ir.js";
 import { renderGenerativeUI } from "./renderGenerativeUI.js";
+import { JSONGenerativeUI } from "./JSONGenerativeUI.client.js";
+import { createActionRegistry, emptyActionRegistry } from "./actionRegistry.js";
 import { defineGenerativeComponents } from "./defineGenerativeComponents.js";
 import { generativeUIToJSX } from "./generativeUIToJSX.js";
-import { JSONGenerativeUI } from "@assistant-ui/react-generative-ui/internal-json";
-export { JSONGenerativeUI, TYPE_KEY, buildPresentParameters, defineGenerativeComponents, generativeUIToJSX, renderGenerativeUI };
+import { defaultGenerativeUILibrary } from "./vocabulary/index.js";
+export { ALERT_TONES, ALIGNS, BUTTON_STYLES, COLORS, ICON_NAMES, IMAGE_SIZE_TOKENS, JSONGenerativeUI, JUSTIFIES, TEXT_SIZES, TYPE_KEY, WEIGHTS, buildPresentParameters, createActionRegistry, defaultGenerativeUILibrary, defineGenerativeComponents, emptyActionRegistry, generativeUIToJSX, normalizeSpec, normalizeUINode, renderGenerativeUI };

package/dist/index.server.d.ts

@@ -0,0 +1,13 @@
+import { ALERT_TONES, ALIGNS, Action, AlertTone, Align, BUTTON_STYLES, ButtonStyle, COLORS, Color, ICON_NAMES, IMAGE_SIZE_TOKENS, IconName, ImageSize, JUSTIFIES, Justify, LegacyComponentNode, NormalizedUIElement, NormalizedUINode, TEXT_SIZES, TextSize, UIChildren, UIElement, UINode, UISpec, WEIGHTS, Weight, normalizeSpec, normalizeUINode } from "./ir.js";
+import { ActionDispatchContext, ActionHandler, ActionRegistry, createActionRegistry, emptyActionRegistry } from "./actionRegistry.js";
+import { GenerativeUIAction, GenerativeUIComponent, GenerativeUIDispatch, GenerativeUIElement, GenerativeUILibrary, GenerativeUINode, GenerativeUIProps, GenerativeUIRenderContext, GenerativeUIStatus } from "./types.js";
+import { JSONGenerativeUIOptions, PresentTool, PresentToolOptions, PromptUserTool } from "./JSONGenerativeUI.shared.js";
+import { JSONGenerativeUI } from "./JSONGenerativeUI.server.js";
+import { buildPresentParameters } from "./buildPresentParameters.js";
+import { TYPE_KEY } from "./constants.js";
+import { defineGenerativeComponents } from "./defineGenerativeComponents.js";
+import { GenerativeUIToJSXOptions, generativeUIToJSX } from "./generativeUIToJSX.js";
+import { renderGenerativeUI } from "./renderGenerativeUI.js";
+import { defaultGenerativeUILibrary } from "./vocabulary/index.js";
+import "./index.shared.js";
+export { ALERT_TONES, ALIGNS, type Action, type ActionDispatchContext, type ActionHandler, type ActionRegistry, type AlertTone, type Align, BUTTON_STYLES, type ButtonStyle, COLORS, type Color, type GenerativeUIAction, type GenerativeUIComponent, type GenerativeUIDispatch, type GenerativeUIElement, type GenerativeUILibrary, type GenerativeUINode, type GenerativeUIProps, type GenerativeUIRenderContext, type GenerativeUIStatus, type GenerativeUIToJSXOptions, ICON_NAMES, IMAGE_SIZE_TOKENS, type IconName, type ImageSize, JSONGenerativeUI, type JSONGenerativeUIOptions, JUSTIFIES, type Justify, type LegacyComponentNode, type NormalizedUIElement, type NormalizedUINode, type PresentTool, type PresentToolOptions, type PromptUserTool, TEXT_SIZES, TYPE_KEY, type TextSize, type UIChildren, type UIElement, type UINode, type UISpec, WEIGHTS, type Weight, buildPresentParameters, createActionRegistry, defaultGenerativeUILibrary, defineGenerativeComponents, emptyActionRegistry, generativeUIToJSX, normalizeSpec, normalizeUINode, renderGenerativeUI };

package/dist/index.server.js

@@ -0,0 +1,10 @@
+import { TYPE_KEY } from "./constants.js";
+import { buildPresentParameters } from "./buildPresentParameters.js";
+import { ALERT_TONES, ALIGNS, BUTTON_STYLES, COLORS, ICON_NAMES, IMAGE_SIZE_TOKENS, JUSTIFIES, TEXT_SIZES, WEIGHTS, normalizeSpec, normalizeUINode } from "./ir.js";
+import { renderGenerativeUI } from "./renderGenerativeUI.js";
+import { JSONGenerativeUI } from "./JSONGenerativeUI.server.js";
+import { createActionRegistry, emptyActionRegistry } from "./actionRegistry.js";
+import { defineGenerativeComponents } from "./defineGenerativeComponents.js";
+import { generativeUIToJSX } from "./generativeUIToJSX.js";
+import { defaultGenerativeUILibrary } from "./vocabulary/index.js";
+export { ALERT_TONES, ALIGNS, BUTTON_STYLES, COLORS, ICON_NAMES, IMAGE_SIZE_TOKENS, JSONGenerativeUI, JUSTIFIES, TEXT_SIZES, TYPE_KEY, WEIGHTS, buildPresentParameters, createActionRegistry, defaultGenerativeUILibrary, defineGenerativeComponents, emptyActionRegistry, generativeUIToJSX, normalizeSpec, normalizeUINode, renderGenerativeUI };