@assistant-ui/react-generative-ui 0.0.7 → 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

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

@@ -1 +1 @@
-{"version":3,"file":"JSONGenerativeUI.client.d.ts","names":[],"sources":["../src/JSONGenerativeUI.client.tsx"],"mappings":";;;;;AAkCA;;;;;;;;;cAAa,gBAAA;EAAA,iBACM,OAAA;EAAA,iBACA,UAAA;EAAA,iBACA,OAAA;cAEL,OAAA,EAAS,uBAAA;EAAA,iBAMJ,MAAA;EAYjB,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.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

@@ -2,7 +2,6 @@ import { JSONSchema7 } from "./node_modules/.pnpm/@types_json-schema@7.0.15/node
 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 = {

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

@@ -1 +1 @@
-{"version":3,"file":"JSONGenerativeUI.shared.d.ts","names":[],"sources":["../src/JSONGenerativeUI.shared.ts"],"mappings":";;;;;;;KAMY,uBAAA;EAAA;;;;;EAMV,OAAA,EAAS,mBAAA;EAOT;;;AAAwB;AAI1B;;EAJE,OAAA,GAAU,cAAc;AAAA;AAWjB;AAAA,KAPG,kBAAA;EAUe;;;AAEb;AAKd;;EAVE,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;AAb3C;;;;;AAAA,iBAoBgB,eAAA,CACd,UAAA,EAAY,iBAAA,EACZ,OAAA,GAAU,kBAAA;;;;;;;AArBY;AAYxB;;iBAuBgB,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/actionRegistry.d.ts

@@ -1,14 +1,9 @@
 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 interactive components (`Select`/`Input`/
-   * `DatePicker`) the user's runtime input is merged in under the reserved
-   * `$input` key, so the handler sees both the model payload and what the user
-   * did; a model-supplied `value` field is never clobbered.
+   * 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;
 };
@@ -21,11 +16,7 @@ type ActionDispatchContext = {
  */
 type ActionHandler = (ctx: ActionDispatchContext) => unknown | Promise<unknown>;
 /**
- * The host-provided map from `$action.type` to {@link ActionHandler}. This is
- * the single dispatch target for `$action` on web, shared by the model
- * `present` renderer, the synthetic `present` produced from A2A/A2UI, and the
- * decoded `block_actions` from Slack. Construct it with
- * {@link createActionRegistry} and pass it to `JSONGenerativeUI`.
+ * 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;

package/dist/actionRegistry.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"actionRegistry.d.ts","names":[],"sources":["../src/actionRegistry.ts"],"mappings":";;;;KAGY,qBAAA;EAAA;;;;AAQc;AAU1B;;EAlBY,SAQD,OAAA,EAAS,MAAM;AAAA;;;;;AAYJ;AAStB;;KAXY,aAAA,IACV,GAAA,EAAK,qBAAA,eACQ,OAAO;;;;;;;;KASV,cAAA;EACV,QAAA,CAAS,MAAA,EAAQ,MAAM;EACvB,GAAA,CAAI,IAAA;AAAA;AAAA,iBAGU,oBAAA,CACd,QAAA,EAAU,QAAA,CAAS,MAAA,SAAe,aAAA,KACjC,cAAA;;;;cA0CU,mBAAA,EAAqB,cAAyC"}
+{"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.map

@@ -1 +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\n   * the model emitted it. For interactive components (`Select`/`Input`/\n   * `DatePicker`) the user's runtime input is merged in under the reserved\n   * `$input` key, so the handler sees both the model payload and what the user\n   * did; 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\n * the single dispatch target for `$action` on web, shared by the model\n * `present` renderer, the synthetic `present` produced from A2A/A2UI, and the\n * decoded `block_actions` from Slack. Construct it with\n * {@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":";AAqCA,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"}
+{"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
@@ -25,7 +26,7 @@ function buildPresentParameters(library) {
 		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;
 			propOwners.set(key, [...propOwners.get(key) ?? [], name]);
 		}
@@ -43,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" }
 		},

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  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 === TYPE_KEY || 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      ...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":";;;;;;;;;;;;;;;;;;;AAqBA,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,QAAA,WAAoB,QAAQ,YAAY;GAC5C,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,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"}
+{"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,4 +1,4 @@
-import { ALERT_TONES, ALIGNS, Action, AlertTone, Align, BUTTON_STYLES, ButtonStyle, COLORS, Color, IMAGE_SIZE_TOKENS, ImageSize, JUSTIFIES, Justify, LegacyComponentNode, NormalizedUIElement, NormalizedUINode, TEXT_SIZES, TextSize, UIChildren, UIElement, UINode, UISpec, WEIGHTS, Weight, normalizeSpec, normalizeUINode } from "./ir.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";
@@ -6,7 +6,8 @@ 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 { defaultGenerativeUILibrary } from "./vocabulary/index.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, IMAGE_SIZE_TOKENS, 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 };
+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,10 +1,10 @@
 import { TYPE_KEY } from "./constants.js";
 import { buildPresentParameters } from "./buildPresentParameters.js";
-import { ALERT_TONES, ALIGNS, BUTTON_STYLES, COLORS, IMAGE_SIZE_TOKENS, JUSTIFIES, TEXT_SIZES, WEIGHTS, normalizeSpec, normalizeUINode } from "./ir.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 { defaultGenerativeUILibrary } from "./vocabulary/index.js";
-export { ALERT_TONES, ALIGNS, BUTTON_STYLES, COLORS, IMAGE_SIZE_TOKENS, JSONGenerativeUI, JUSTIFIES, TEXT_SIZES, TYPE_KEY, WEIGHTS, buildPresentParameters, createActionRegistry, defaultGenerativeUILibrary, defineGenerativeComponents, emptyActionRegistry, generativeUIToJSX, normalizeSpec, normalizeUINode, renderGenerativeUI };
+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

@@ -1,4 +1,4 @@
-import { ALERT_TONES, ALIGNS, Action, AlertTone, Align, BUTTON_STYLES, ButtonStyle, COLORS, Color, IMAGE_SIZE_TOKENS, ImageSize, JUSTIFIES, Justify, LegacyComponentNode, NormalizedUIElement, NormalizedUINode, TEXT_SIZES, TextSize, UIChildren, UIElement, UINode, UISpec, WEIGHTS, Weight, normalizeSpec, normalizeUINode } from "./ir.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";
@@ -6,7 +6,8 @@ import { JSONGenerativeUI } from "./JSONGenerativeUI.server.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 { defaultGenerativeUILibrary } from "./vocabulary/index.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, IMAGE_SIZE_TOKENS, 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 };
+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

@@ -1,10 +1,10 @@
 import { TYPE_KEY } from "./constants.js";
 import { buildPresentParameters } from "./buildPresentParameters.js";
-import { ALERT_TONES, ALIGNS, BUTTON_STYLES, COLORS, IMAGE_SIZE_TOKENS, JUSTIFIES, TEXT_SIZES, WEIGHTS, normalizeSpec, normalizeUINode } from "./ir.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, IMAGE_SIZE_TOKENS, JSONGenerativeUI, JUSTIFIES, TEXT_SIZES, TYPE_KEY, WEIGHTS, buildPresentParameters, createActionRegistry, defaultGenerativeUILibrary, defineGenerativeComponents, emptyActionRegistry, generativeUIToJSX, normalizeSpec, normalizeUINode, renderGenerativeUI };
+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.shared.d.ts

@@ -1,11 +1,11 @@
-import { ALERT_TONES, ALIGNS, Action, AlertTone, Align, BUTTON_STYLES, ButtonStyle, COLORS, Color, IMAGE_SIZE_TOKENS, ImageSize, JUSTIFIES, Justify, LegacyComponentNode, NormalizedUIElement, NormalizedUINode, TEXT_SIZES, TextSize, UIChildren, UIElement, UINode, UISpec, WEIGHTS, Weight, normalizeSpec, normalizeUINode } from "./ir.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 { 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 { defaultGenerativeUILibrary } from "./vocabulary/index.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, IMAGE_SIZE_TOKENS, type ImageSize, 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 };
+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, 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.shared.js

@@ -1,9 +1,9 @@
 import { TYPE_KEY } from "./constants.js";
 import { buildPresentParameters } from "./buildPresentParameters.js";
-import { ALERT_TONES, ALIGNS, BUTTON_STYLES, COLORS, IMAGE_SIZE_TOKENS, JUSTIFIES, TEXT_SIZES, WEIGHTS, normalizeSpec, normalizeUINode } from "./ir.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 { 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, IMAGE_SIZE_TOKENS, JUSTIFIES, TEXT_SIZES, TYPE_KEY, WEIGHTS, buildPresentParameters, createActionRegistry, defaultGenerativeUILibrary, defineGenerativeComponents, emptyActionRegistry, generativeUIToJSX, normalizeSpec, normalizeUINode, renderGenerativeUI };
+export { ALERT_TONES, ALIGNS, BUTTON_STYLES, COLORS, ICON_NAMES, IMAGE_SIZE_TOKENS, JUSTIFIES, TEXT_SIZES, TYPE_KEY, WEIGHTS, buildPresentParameters, createActionRegistry, defaultGenerativeUILibrary, defineGenerativeComponents, emptyActionRegistry, generativeUIToJSX, normalizeSpec, normalizeUINode, renderGenerativeUI };

package/dist/ir.d.ts

@@ -30,13 +30,13 @@ type Justify = (typeof JUSTIFIES)[number];
 declare const BUTTON_STYLES: readonly ["primary", "secondary", "outline", "ghost", "danger"];
 type ButtonStyle = (typeof BUTTON_STYLES)[number];
 declare const ALERT_TONES: readonly ["info", "success", "warning", "danger"];
-/** Maps to ChatKit `alert` severity levels. */
+/** A severity level, from informational to destructive. */
 type AlertTone = (typeof ALERT_TONES)[number];
+declare const ICON_NAMES: readonly ["sun", "moon", "cloud", "rain", "snow", "wind", "play", "pause", "check", "x", "star", "heart", "arrow-right", "arrow-up-right", "chevron-right", "calendar", "clock", "map-pin", "plane", "truck", "credit-card", "user", "search", "bell"];
+/** A name from the built-in icon set; the closed enum lets the model see exactly which icons exist. */
+type IconName = (typeof ICON_NAMES)[number];
 /**
- * Behavior payload carried by an interactive node. `type` is resolved by the
- * host's action registry, not the renderer; keeping behavior as data keeps the
- * tree serializable so the same node renders on web and converts to a native
- * action id on Slack.
+ * Behavior payload carried by an interactive node. `type` is resolved by the host's action registry, not the renderer; keeping behavior as data keeps the tree serializable, so the same node renders on web while converters may bind the type to a native action id on other platforms.
  */
 interface Action {
   readonly type: string;
@@ -111,5 +111,5 @@ declare function normalizeSpec(spec: UISpec): {
   readonly root: NormalizedUINode | readonly NormalizedUINode[];
 };
 //#endregion
-export { ALERT_TONES, ALIGNS, Action, AlertTone, Align, BUTTON_STYLES, ButtonStyle, COLORS, Color, IMAGE_SIZE_TOKENS, ImageSize, JUSTIFIES, Justify, LegacyComponentNode, NormalizedUIElement, NormalizedUINode, TEXT_SIZES, TextSize, UIChildren, UIElement, UINode, UISpec, WEIGHTS, Weight, normalizeSpec, normalizeUINode };
+export { 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 };
 //# sourceMappingURL=ir.d.ts.map

package/dist/ir.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"ir.d.ts","names":[],"sources":["../src/ir.ts"],"mappings":";;AAmBA;;;;AAAyE;AACzE;;;;AAAyC;AAEzC;;;;AAA4D;cAH/C,UAAA;AAAA,KACD,QAAA,WAAmB,UAAU;AAAA,cAE5B,iBAAA;AAAA,KACD,SAAA,WAAoB,iBAAiB;AAAA,cAEpC,OAAA;AAAA,KACD,MAAA,WAAiB,OAAO;AAAA,cAEvB,MAAA;AAAA,KAQD,KAAA,WAAgB,MAAM;AAAA,cAErB,MAAA;AAAA,KACD,KAAA,WAAgB,MAAM;AAAA,cAErB,SAAA;AAAA,KACD,OAAA,WAAkB,SAAS;AAAA,cAE1B,aAAA;AAAA,KAOD,WAAA,WAAsB,aAAa;AAAA,cAElC,WAAA;AAzBb;AAAA,KA2BY,SAAA,WAAoB,WAAW;;;AApBjC;AACV;;;UA2BiB,MAAA;EAAA,SACN,IAAA;EAAA,UACC,OAAe;AAAA;;;AA3B8B;AACzD;;;KAmCY,MAAA,qBAA2B,SAAA,GAAY,mBAAmB;AAAA,KAE1D,UAAA,GAAa,MAAA,YAAkB,MAAM;AAnCjD;;;AAAA,UAwCiB,SAAA;EAAA,SACN,KAAA;EAAA,SACA,IAAA;EAAA,SACA,QAAA,GAAW,UAAA;EAAA,SACX,OAAA,GAAU,MAAM;EAAA,UACf,IAAA;AAAA;AA1CZ;;;;AAMU;AANV,UAkDiB,mBAAA;EAAA,SACN,SAAA;EAAA,SACA,KAAA,GAAQ,MAAA;EAAA,SACR,QAAA,GAAW,UAAU;EAAA,SACrB,GAAA;AAAA;AAAA,KAGC,MAAA,GAAS,MAAA,YAAkB,MAAM;;;AAhD+B;AAE5E;;;;AAA2C;UAwD1B,mBAAA;EAAA,SACN,IAAA;EAAA,SACA,KAAA,EAAO,QAAA,CAAS,MAAA;EAAA,SAChB,QAAA,GAAW,gBAAA;EAAA,SACX,GAAA;EAAA,SACA,MAAA,GAAS,MAAA;AAAA;AAAA,KAGR,gBAAA,8BAGC,gBAAA,KACT,mBAAmB;;AAjD+C;AAEtE;;;;AAAiD;AAKjD;;;;;;;iBAuFgB,eAAA,CACd,IAAA,WACA,WAAA,kCACA,KAAA,YACC,gBAAgB;;;;;iBAuEH,aAAA,CAAc,IAAA,EAAM,MAAA;EAAA,SACzB,IAAA,EAAM,gBAAA,YAA4B,gBAAA;AAAA"}
+{"version":3,"file":"ir.d.ts","names":[],"sources":["../src/ir.ts"],"mappings":";;;;;;;;;;;;;;;;;cAmBa;KACD,mBAAmB;cAElB;KACD,oBAAoB;cAEnB;KACD,iBAAiB;cAEhB;KAQD,gBAAgB;cAEf;KACD,gBAAgB;cAEf;KACD,kBAAkB;cAEjB;KAOD,sBAAsB;cAErB;;KAED,oBAAoB;cAEnB;;KA2BD,mBAAmB;;;;UAKd;WACN;YACC;;;;;;;;KASA,2BAA2B,YAAY;KAEvC,aAAa,kBAAkB;;;;UAK1B;WACN;WACA;WACA,WAAW;WACX,UAAU;YACT;;;;;;;UAQK;WACN;WACA,QAAQ;WACR,WAAW;WACX;;KAGC,SAAS,kBAAkB;;;;;;;;;UAUtB;WACN;WACA,OAAO,SAAS;WAChB,WAAW;WACX;WACA,SAAS;;KAGR,8CAGC,qBACT;;;;;;;;;;;;;;;iBA6CY,gBACd,eACA,6CACA,iBACC;;;;;iBAuEa,cAAc,MAAM;WACzB,MAAM,4BAA4B"}

package/dist/ir.js

@@ -67,6 +67,32 @@ const ALERT_TONES = [
 	"warning",
 	"danger"
 ];
+const ICON_NAMES = [
+	"sun",
+	"moon",
+	"cloud",
+	"rain",
+	"snow",
+	"wind",
+	"play",
+	"pause",
+	"check",
+	"x",
+	"star",
+	"heart",
+	"arrow-right",
+	"arrow-up-right",
+	"chevron-right",
+	"calendar",
+	"clock",
+	"map-pin",
+	"plane",
+	"truck",
+	"credit-card",
+	"user",
+	"search",
+	"bell"
+];
 const isRecord = (value) => typeof value === "object" && value !== null && !Array.isArray(value);
 const isLegacyNode = (node) => typeof node["component"] === "string";
 const isTypeNode = (node) => typeof node[TYPE_KEY] === "string";
@@ -144,6 +170,6 @@ function normalizeSpec(spec) {
 	return { root: normalizeUINode(spec) };
 }
 //#endregion
-export { ALERT_TONES, ALIGNS, BUTTON_STYLES, COLORS, IMAGE_SIZE_TOKENS, JUSTIFIES, TEXT_SIZES, WEIGHTS, normalizeSpec, normalizeUINode };
+export { ALERT_TONES, ALIGNS, BUTTON_STYLES, COLORS, ICON_NAMES, IMAGE_SIZE_TOKENS, JUSTIFIES, TEXT_SIZES, WEIGHTS, normalizeSpec, normalizeUINode };
 
 //# sourceMappingURL=ir.js.map