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

package/dist/JSONGenerativeUI.client.d.ts

@@ -8,11 +8,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":";;;;;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"}

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.shared.d.ts

@@ -1,4 +1,5 @@
 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";
 
@@ -11,6 +12,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,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"}

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,41 @@
+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.
+   */
+  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 `$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`.
+ */
+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,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"}

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\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"}

package/dist/buildPresentParameters.js

@@ -20,15 +20,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 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",
@@ -62,6 +67,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, ...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"}

package/dist/index.d.ts

@@ -1,9 +1,12 @@
-import { GenerativeUIComponent, GenerativeUIElement, GenerativeUILibrary, GenerativeUINode, GenerativeUIProps, GenerativeUIRenderContext, GenerativeUIStatus } from "./types.js";
+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 { 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 { 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";
+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 };

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, 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, 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,12 @@
+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 { 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 { 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 };

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, 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 };

package/dist/index.shared.d.ts

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

package/dist/index.shared.js

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

package/dist/ir.d.ts

@@ -0,0 +1,115 @@
+//#region src/ir.d.ts
+/**
+ * The generative-ui intermediate representation: a model-emitted, cross-platform
+ * UI tree. React-free, so converters and non-web runtimes consume it without
+ * pulling React. The flat `$type` shape is the canonical form; the legacy
+ * `component` shape is accepted as a backward-compatible alias.
+ *
+ * Reserved keys are partitioned off from component props so the component prop
+ * namespace stays fully free:
+ *
+ * - `$`-prefixed keys are framework-reserved (`$type`, `$key`, `$action`,
+ *   `$status`). Components never declare `$`-prefixed props, so a component
+ *   can use `type`, `status`, `variant`, etc. as ordinary props without
+ *   colliding with the framework.
+ * - `children` is additionally reserved (the JSX convention).
+ * - every other key is an inline prop passed straight to the component.
+ */
+declare const TEXT_SIZES: readonly ["sm", "md", "lg", "xl", "2xl", "3xl"];
+type TextSize = (typeof TEXT_SIZES)[number];
+declare const IMAGE_SIZE_TOKENS: readonly ["sm", "md", "lg"];
+type ImageSize = (typeof IMAGE_SIZE_TOKENS)[number] | number;
+declare const WEIGHTS: readonly ["normal", "medium", "semibold", "bold"];
+type Weight = (typeof WEIGHTS)[number];
+declare const COLORS: readonly ["emphasis", "secondary", "alpha-70", "white", "white-70", "white-50"];
+type Color = (typeof COLORS)[number];
+declare const ALIGNS: readonly ["start", "center", "end"];
+type Align = (typeof ALIGNS)[number];
+declare const JUSTIFIES: readonly ["start", "center", "end", "between"];
+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. */
+type AlertTone = (typeof ALERT_TONES)[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.
+ */
+interface Action {
+  readonly type: string;
+  readonly [payload: string]: unknown;
+}
+/**
+ * Anything renderable as generative UI, as the model emits it. The renderer
+ * also accepts `number`, `boolean`, `null`, `undefined`, and arrays at the
+ * input boundary (numbers render as text, falsy/boolean as nothing, arrays as
+ * lists); {@link normalizeUINode} accepts that full range.
+ */
+type UINode = string | number | UIElement | LegacyComponentNode;
+type UIChildren = UINode | readonly UINode[];
+/** The flat node shape: inline props keep the tree compact and natural for a
+ * model to emit, instead of a nested `{ type, props }` bag. Reserved keys are
+ * stripped before props reach the component (see the module header). */
+interface UIElement {
+  readonly $type: string;
+  readonly $key?: string | number;
+  readonly children?: UIChildren;
+  readonly $action?: Action;
+  readonly [prop: string]: unknown;
+}
+/**
+ * The legacy node shape: a `component` name plus a nested `props` bag. Kept
+ * for backward compatibility. New code authors the flat {@link UIElement}
+ * shape instead.
+ */
+interface LegacyComponentNode {
+  readonly component: string;
+  readonly props?: Record<string, unknown>;
+  readonly children?: UIChildren;
+  readonly key?: string;
+}
+type UISpec = UINode | readonly UINode[];
+/**
+ * A node normalized to a single canonical shape: a `type` string, an inline
+ * `props` bag, recursive `children`, an optional `key`, and an optional
+ * `action`. Renderers and platform converters consume this form, so they never
+ * branch on whether the model emitted the flat `$type` shape or the legacy
+ * `component` shape, and they never see the reserved `$`-prefixed keys leak
+ * into component props.
+ */
+interface NormalizedUIElement {
+  readonly type: string;
+  readonly props: Readonly<Record<string, unknown>>;
+  readonly children?: NormalizedUINode | undefined;
+  readonly key?: string | number | undefined;
+  readonly action?: Action | undefined;
+}
+type NormalizedUINode = string | number | readonly NormalizedUINode[] | NormalizedUIElement | null;
+/**
+ * Normalizes a generative-ui input to {@link NormalizedUINode}. The flat
+ * `$type` shape and the legacy `component` shape both map to the same canonical
+ * element, with reserved keys (`$type`, `$key`, `$action`, `children`) stripped
+ * from the prop bag. A node that carries neither a `$type` nor a `component`
+ * string is not renderable and resolves to `null` rather than throwing, so a
+ * partially-streamed or malformed node degrades to "render nothing".
+ *
+ * `partialPath` carries streaming state from the tool-args parse meta: a node
+ * whose `$type` is still mid-arrival is held back (resolves to `null`) until it
+ * completes, and the path is threaded into `children` so a nested streaming
+ * node is held back while completed siblings render. Omit it for a
+ * non-streaming (converter) normalize.
+ */
+declare function normalizeUINode(node: unknown, partialPath?: readonly string[] | undefined, depth?: number): NormalizedUINode;
+/**
+ * Normalizes the root of a {@link UISpec}, preserving whether the root was a
+ * single node or a list.
+ */
+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 };
+//# sourceMappingURL=ir.d.ts.map

package/dist/ir.d.ts.map

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