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

package/dist/JSONGenerativeUI.client.d.ts

@@ -11,7 +11,7 @@ import { JSONGenerativeUIOptions, PresentTool, PresentToolOptions, PromptUserToo
  * `actions` registry (if provided) is threaded into the render context so
  * interactive components can fire `$action` through `$dispatch`.
  */
-declare class JSONGenerativeUI {
+export declare class JSONGenerativeUI {
   private readonly library;
   private readonly parameters;
   private readonly actions;
@@ -26,5 +26,4 @@ declare class JSONGenerativeUI {
   promptUser(): PromptUserTool;
 }
 //#endregion
-export { JSONGenerativeUI };
 //# sourceMappingURL=JSONGenerativeUI.client.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"JSONGenerativeUI.client.d.ts","names":[],"sources":["../src/JSONGenerativeUI.client.tsx"],"mappings":";;;;;;;;;;;;;cAkCa;mBACM;mBACA;mBACA;EAEL,YAAA,SAAS;;;;;;mBAWJ;EAejB,QAAQ,UAAU,qBAAqB;EASvC,cAAc"}
+{"version":3,"file":"JSONGenerativeUI.client.d.ts","names":[],"sources":["../src/JSONGenerativeUI.client.tsx"],"mappings":";;;;;;;;;;;;;qBAkCa;mBACM;mBACA;mBACA;EAEL,YAAA,SAAS;;;;;;mBAWJ;EAejB,QAAQ,UAAU,qBAAqB;EASvC,cAAc"}

package/dist/JSONGenerativeUI.server.d.ts

@@ -13,12 +13,11 @@ import { JSONGenerativeUIOptions, PresentTool, PresentToolOptions, PromptUserToo
  * `as` casts here because the tool types require a `render` for frontend/human
  * tools; on the server it is structurally absent and never read.
  */
-declare class JSONGenerativeUI {
+export declare class JSONGenerativeUI {
   private readonly parameters;
   constructor(options: JSONGenerativeUIOptions);
   present(options?: PresentToolOptions): PresentTool;
   promptUser(): PromptUserTool;
 }
 //#endregion
-export { JSONGenerativeUI };
 //# sourceMappingURL=JSONGenerativeUI.server.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"JSONGenerativeUI.server.d.ts","names":[],"sources":["../src/JSONGenerativeUI.server.tsx"],"mappings":";;;;;;;;;;;;;;;cAwBa;mBACM;EAEL,YAAA,SAAS;EAIrB,QAAQ,UAAU,qBAAqB;EAIvC,cAAc"}
+{"version":3,"file":"JSONGenerativeUI.server.d.ts","names":[],"sources":["../src/JSONGenerativeUI.server.tsx"],"mappings":";;;;;;;;;;;;;;;qBAwBa;mBACM;EAEL,YAAA,SAAS;EAIrB,QAAQ,UAAU,qBAAqB;EAIvC,cAAc"}

package/dist/JSONGenerativeUI.shared.d.ts

@@ -1,10 +1,10 @@
-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";
+import { JSONSchema7 } from "json-schema";
 //#region src/JSONGenerativeUI.shared.d.ts
 /** Options for {@link JSONGenerativeUI}. */
-type JSONGenerativeUIOptions = {
+export type JSONGenerativeUIOptions = {
   /**
    * The components the model is allowed to render, keyed by the `$type` it
    * selects them with. Author it with `defineGenerativeComponents({ ... })` so a
@@ -20,7 +20,7 @@ type JSONGenerativeUIOptions = {
   actions?: ActionRegistry;
 };
 /** Options for {@link JSONGenerativeUI.present}. */
-type PresentToolOptions = {
+export type PresentToolOptions = {
   /**
    * Set `"standalone"` to render the component on its own surface (outside the
    * chain-of-thought trace), e.g. a full-bleed artifact like a card. Omit it for
@@ -35,17 +35,17 @@ type BackendDefaultMetadata = {
   };
 };
 /** The `present` tool, as the model sees it (no client `render`/`execute`). */
-type PresentTool = ToolDefinition<Record<string, unknown>, Record<string, never>> & BackendDefaultMetadata;
+export type PresentTool = ToolDefinition<Record<string, unknown>, Record<string, never>> & BackendDefaultMetadata;
 /** The `prompt_user` tool, as the model sees it (no client `render`). */
-type PromptUserTool = ToolDefinition<Record<string, unknown>, unknown> & BackendDefaultMetadata;
+export type PromptUserTool = ToolDefinition<Record<string, unknown>, unknown> & BackendDefaultMetadata;
 /** The tool `parameters` schema, built once per instance (see `buildPresentParameters`). */
-type PresentParameters = JSONSchema7;
+export type PresentParameters = JSONSchema7;
 /**
  * The schema-only half of the `present` tool, shared by both builds. The server
  * build returns exactly this; the client build adds `execute` and `render`.
  * Takes the already-built `parameters` so it isn't recomputed per tool.
  */
-declare function presentToolBase(parameters: PresentParameters, options?: PresentToolOptions): {
+export declare function presentToolBase(parameters: PresentParameters, options?: PresentToolOptions): {
   display?: "standalone";
   type: "frontend";
   description: string;
@@ -55,11 +55,10 @@ declare function presentToolBase(parameters: PresentParameters, options?: Presen
  * The schema-only half of the `prompt_user` tool, shared by both builds. The
  * server build returns exactly this; the client build adds `render`.
  */
-declare function promptUserToolBase(parameters: PresentParameters): {
+export declare function promptUserToolBase(parameters: PresentParameters): {
   type: "human";
   description: string;
   parameters: JSONSchema7;
 };
 //#endregion
-export { JSONGenerativeUIOptions, PresentParameters, PresentTool, PresentToolOptions, PromptUserTool, presentToolBase, promptUserToolBase };
 //# sourceMappingURL=JSONGenerativeUI.shared.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"JSONGenerativeUI.shared.d.ts","names":[],"sources":["../src/JSONGenerativeUI.shared.ts"],"mappings":";;;;;;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"}
+{"version":3,"file":"JSONGenerativeUI.shared.d.ts","names":[],"sources":["../src/JSONGenerativeUI.shared.ts"],"mappings":";;;;;;YAMY;;;;;;EAMV,SAAS;;;;;;;EAOT,UAAU;;;YAIA;;;;;;;EAOV;;KAGG;EACH;IACE;;;;YAKQ,cAAc,eACxB,yBACA,yBAEA;;YAGU,iBAAiB,eAAe,oCAC1C;;YAYU,oBAAoB;;;;;;wBAOhB,gBACd,YAAY,mBACZ,UAAU;;;;;;;;;;wBAcI,mBAAmB,YAAY;;;cAAA"}

package/dist/a2ui/convert.d.ts

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

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

@@ -1 +1 @@
-{"version":3,"file":"convert.d.ts","names":[],"sources":["../../src/a2ui/convert.ts"],"mappings":";;;iBAmbgB,uBAAuB,SAAS;EAC9C,MAAM;EACN"}
+{"version":3,"file":"convert.d.ts","names":[],"sources":["../../src/a2ui/convert.ts"],"mappings":";;;wBAscgB,uBAAuB,SAAS;EAC9C,MAAM;EACN"}

package/dist/a2ui/convert.js

@@ -20,6 +20,15 @@ const isPlainObject = (value) => {
 	const prototype = Object.getPrototypeOf(value);
 	return prototype === Object.prototype || prototype === null;
 };
+const setOwnProperty = (target, key, value) => {
+	if (key === "__proto__") Object.defineProperty(target, key, {
+		value,
+		enumerable: true,
+		configurable: true,
+		writable: true
+	});
+	else target[key] = value;
+};
 const isBinding = (value) => isPlainObject(value) && Object.keys(value).length === 1 && typeof value["path"] === "string";
 const isTemplateChildren = (value) => isPlainObject(value) && Object.keys(value).length === 1 && isPlainObject(value["template"]) && Object.keys(value["template"]).length === 2 && typeof value["template"]["componentId"] === "string" && typeof value["template"]["path"] === "string";
 const decodePointer = (path) => {
@@ -54,7 +63,7 @@ const materialize = (value, source) => {
 	const result = {};
 	for (const [key, entry] of Object.entries(value)) {
 		const resolved = materialize(entry, source);
-		if (resolved !== void 0) result[key] = resolved;
+		if (resolved !== void 0) setOwnProperty(result, key, resolved);
 	}
 	return result;
 };
@@ -274,7 +283,7 @@ function convertComponent(componentId, dataSource, context, depth, visited) {
 		for (const [key, value] of Object.entries(node)) {
 			if (key === "id" || key === "component" || key === "children") continue;
 			const resolved = materialize(value, dataSource);
-			if (resolved !== void 0) props[key] = resolved;
+			if (resolved !== void 0) setOwnProperty(props, key, resolved);
 		}
 		const mapped = mappedProps(node, props, dataSource, context);
 		if (!mapped) return null;

package/dist/a2ui/convert.js.map

@@ -1 +1 @@
-{"version":3,"file":"convert.js","names":[],"sources":["../../src/a2ui/convert.ts"],"sourcesContent":["import type { UIElement } from \"../ir\";\nimport {\n  A2UI_SURFACE_ID,\n  type A2uiSurfaceState,\n  type A2uiTemplateChildren,\n} from \"./types\";\n\nconst DEPTH_CAP = 32;\nconst TEMPLATE_ITEM_CAP = 100;\nconst NODE_BUDGET = 5000;\n\nconst SUPPORTED_COMPONENTS = new Set([\n  \"Text\",\n  \"Image\",\n  \"Row\",\n  \"Column\",\n  \"Card\",\n  \"Divider\",\n  \"Button\",\n  \"TextField\",\n  \"CheckBox\",\n]);\n\nconst isRecord = (value: unknown): value is Record<string, unknown> =>\n  typeof value === \"object\" && value !== null && !Array.isArray(value);\n\nconst isPlainObject = (value: unknown): value is Record<string, unknown> => {\n  if (!isRecord(value)) return false;\n  const prototype = Object.getPrototypeOf(value);\n  return prototype === Object.prototype || prototype === null;\n};\n\nconst isBinding = (value: unknown): value is { readonly path: string } =>\n  isPlainObject(value) &&\n  Object.keys(value).length === 1 &&\n  typeof value[\"path\"] === \"string\";\n\nconst isTemplateChildren = (value: unknown): value is A2uiTemplateChildren =>\n  isPlainObject(value) &&\n  Object.keys(value).length === 1 &&\n  isPlainObject(value[\"template\"]) &&\n  Object.keys(value[\"template\"]).length === 2 &&\n  typeof value[\"template\"][\"componentId\"] === \"string\" &&\n  typeof value[\"template\"][\"path\"] === \"string\";\n\nconst decodePointer = (path: string): string[] | undefined => {\n  if (path === \"\" || path === \"/\") return [];\n  if (!path.startsWith(\"/\")) return undefined;\n  return path\n    .slice(1)\n    .split(\"/\")\n    .map((segment) => segment.replaceAll(\"~1\", \"/\").replaceAll(\"~0\", \"~\"));\n};\n\nconst resolvePointer = (source: unknown, path: string): unknown => {\n  const segments = decodePointer(path);\n  if (!segments) return undefined;\n  let current = source;\n  for (const segment of segments) {\n    if (Array.isArray(current)) {\n      if (!/^(0|[1-9]\\d*)$/.test(segment)) return undefined;\n      current = current[Number(segment)];\n      continue;\n    }\n    if (!isRecord(current) || !Object.hasOwn(current, segment)) {\n      return undefined;\n    }\n    current = current[segment];\n  }\n  return current;\n};\n\nconst bindingPath = (value: unknown): string | undefined =>\n  isBinding(value) ? value.path : undefined;\n\nconst lastPointerSegment = (path: string | undefined): string | undefined => {\n  if (!path) return undefined;\n  const segments = decodePointer(path);\n  return segments?.at(-1);\n};\n\nconst materialize = (value: unknown, source: unknown): unknown => {\n  if (isBinding(value)) return resolvePointer(source, value.path);\n  if (Array.isArray(value)) {\n    return value\n      .map((entry) => materialize(entry, source))\n      .filter((entry) => entry !== undefined);\n  }\n  if (!isPlainObject(value)) return value;\n  const result: Record<string, unknown> = {};\n  for (const [key, entry] of Object.entries(value)) {\n    const resolved = materialize(entry, source);\n    if (resolved !== undefined) result[key] = resolved;\n  }\n  return result;\n};\n\nconst firstDefined = (\n  props: Record<string, unknown>,\n  keys: readonly string[],\n): unknown => {\n  for (const key of keys) {\n    if (props[key] !== undefined) return props[key];\n  }\n  return undefined;\n};\n\nconst stringProp = (\n  props: Record<string, unknown>,\n  keys: readonly string[],\n): string | undefined => {\n  const value = firstDefined(props, keys);\n  return typeof value === \"string\" ? value : undefined;\n};\n\nconst sourceSurfaceId = (surface: A2uiSurfaceState): string =>\n  (surface as A2uiSurfaceState & { [A2UI_SURFACE_ID]?: string })[\n    A2UI_SURFACE_ID\n  ] ?? \"\";\n\ntype ConversionContext = {\n  readonly surface: A2uiSurfaceState;\n  readonly surfaceId: string;\n  readonly warnings: string[];\n  emittedNodes: number;\n  depthWarned: boolean;\n  budgetWarned: boolean;\n  templateCapWarned: boolean;\n};\n\nconst reserveNode = (context: ConversionContext): boolean => {\n  if (context.emittedNodes >= NODE_BUDGET) {\n    if (!context.budgetWarned) {\n      context.warnings.push(`A2UI node budget of ${NODE_BUDGET} was reached.`);\n      context.budgetWarned = true;\n    }\n    return false;\n  }\n  context.emittedNodes++;\n  return true;\n};\n\nconst childrenOf = (\n  node: Record<string, unknown>,\n  dataSource: unknown,\n  context: ConversionContext,\n  depth: number,\n  visited: Set<string>,\n): UIElement[] => {\n  const children = node[\"children\"];\n  if (!Array.isArray(children)) return [];\n  const result: UIElement[] = [];\n  for (const childId of children) {\n    if (typeof childId !== \"string\") {\n      context.warnings.push(\n        `Component \"${String(node[\"id\"] ?? \"\")}\" has a malformed child reference.`,\n      );\n      continue;\n    }\n    const child = convertComponent(\n      childId,\n      dataSource,\n      context,\n      depth + 1,\n      visited,\n    );\n    if (child) result.push(child);\n  }\n  return result;\n};\n\nconst mappedAction = (\n  node: Record<string, unknown>,\n  props: Record<string, unknown>,\n  dataSource: unknown,\n  context: ConversionContext,\n): UIElement[\"$action\"] | undefined => {\n  const action = props[\"action\"];\n  const actionName =\n    typeof action === \"string\"\n      ? action\n      : isRecord(action) && typeof action[\"name\"] === \"string\"\n        ? action[\"name\"]\n        : undefined;\n  if (!actionName) return undefined;\n  const rawContext = isRecord(action) ? action[\"context\"] : undefined;\n  const resolvedContext =\n    rawContext === undefined ? undefined : materialize(rawContext, dataSource);\n  return {\n    type: \"a2ui:action\",\n    name: actionName,\n    surfaceId: context.surfaceId,\n    sourceComponentId: typeof node[\"id\"] === \"string\" ? node[\"id\"] : \"\",\n    ...(resolvedContext !== undefined ? { context: resolvedContext } : {}),\n  };\n};\n\nconst mappedProps = (\n  node: Record<string, unknown>,\n  props: Record<string, unknown>,\n  dataSource: unknown,\n  context: ConversionContext,\n): UIElement | undefined => {\n  const component = node[\"component\"];\n\n  if (component === \"Text\") {\n    const text = stringProp(props, [\"text\", \"value\"]);\n    const variant = props[\"variant\"];\n    if (typeof variant === \"string\" && /^h[1-6]$/.test(variant)) {\n      return {\n        $type: \"Header\",\n        ...(text !== undefined ? { text } : {}),\n      };\n    }\n    if (variant === \"caption\") {\n      return {\n        $type: \"Caption\",\n        ...(text !== undefined ? { value: text } : {}),\n      };\n    }\n    return {\n      $type: \"Markdown\",\n      ...(text !== undefined ? { value: text } : {}),\n    };\n  }\n\n  if (component === \"Image\") {\n    const src = stringProp(props, [\"src\", \"url\"]);\n    const alt = stringProp(props, [\"alt\", \"altText\"]);\n    const size = props[\"size\"];\n    const round = props[\"round\"];\n    return {\n      $type: \"Image\",\n      ...(src !== undefined ? { src } : {}),\n      ...(alt !== undefined ? { alt } : {}),\n      ...(typeof size === \"string\" || typeof size === \"number\" ? { size } : {}),\n      ...(typeof round === \"boolean\" ? { round } : {}),\n    };\n  }\n\n  if (component === \"Row\") {\n    const gap = props[\"gap\"];\n    const align = firstDefined(props, [\"align\", \"alignment\"]);\n    const justify = firstDefined(props, [\"justify\", \"distribution\"]);\n    return {\n      $type: \"Row\",\n      ...(typeof gap === \"number\" ? { gap } : {}),\n      ...(typeof align === \"string\" ? { align } : {}),\n      ...(typeof justify === \"string\" ? { justify } : {}),\n    };\n  }\n\n  if (component === \"Column\") {\n    const gap = props[\"gap\"];\n    const align = firstDefined(props, [\"align\", \"alignment\"]);\n    return {\n      $type: \"Col\",\n      ...(typeof gap === \"number\" ? { gap } : {}),\n      ...(typeof align === \"string\" ? { align } : {}),\n    };\n  }\n\n  if (component === \"Card\") {\n    const title = props[\"title\"];\n    const padding = props[\"padding\"];\n    const background = props[\"background\"];\n    return {\n      $type: \"Card\",\n      ...(typeof title === \"string\" ? { title } : {}),\n      ...(typeof padding === \"number\" ? { padding } : {}),\n      ...(typeof background === \"string\" ? { background } : {}),\n    };\n  }\n\n  if (component === \"Divider\") {\n    return {\n      $type: \"Divider\",\n      ...(typeof props[\"flush\"] === \"boolean\" ? { flush: props[\"flush\"] } : {}),\n    };\n  }\n\n  if (component === \"Button\") {\n    const label = stringProp(props, [\"label\", \"text\"]);\n    const buttonStyle = props[\"buttonStyle\"];\n    const block = props[\"block\"];\n    const submit = props[\"submit\"];\n    const action = mappedAction(node, props, dataSource, context);\n    return {\n      $type: \"Button\",\n      ...(label !== undefined ? { label } : {}),\n      ...(typeof buttonStyle === \"string\" ? { buttonStyle } : {}),\n      ...(typeof block === \"boolean\" ? { block } : {}),\n      ...(typeof submit === \"boolean\" ? { submit } : {}),\n      ...(action ? { $action: action } : {}),\n    };\n  }\n\n  const binding = firstDefined(node, [\"text\", \"value\", \"binding\"]);\n  const name = lastPointerSegment(bindingPath(binding));\n  const label = stringProp(props, [\"label\"]);\n\n  if (component === \"TextField\") {\n    const placeholder = stringProp(props, [\"placeholder\"]);\n    const multiline =\n      typeof props[\"multiline\"] === \"boolean\"\n        ? props[\"multiline\"]\n        : props[\"textFieldType\"] === \"longText\"\n          ? true\n          : undefined;\n    return {\n      $type: \"Input\",\n      ...(placeholder !== undefined ? { placeholder } : {}),\n      ...(multiline !== undefined ? { multiline } : {}),\n      ...(label !== undefined ? { label } : {}),\n      ...(name !== undefined ? { name } : {}),\n    };\n  }\n\n  if (component === \"CheckBox\") {\n    const defaultChecked = firstDefined(props, [\"defaultChecked\", \"value\"]);\n    return {\n      $type: \"Checkbox\",\n      ...(label !== undefined ? { label } : {}),\n      ...(name !== undefined ? { name } : {}),\n      ...(typeof defaultChecked === \"boolean\" ? { defaultChecked } : {}),\n    };\n  }\n\n  return undefined;\n};\n\nconst convertTemplate = (\n  node: Record<string, unknown>,\n  templateChildren: A2uiTemplateChildren,\n  dataSource: unknown,\n  context: ConversionContext,\n  depth: number,\n  visited: Set<string>,\n): UIElement | null => {\n  if (!reserveNode(context)) return null;\n  const list = resolvePointer(dataSource, templateChildren.template.path);\n  if (!Array.isArray(list)) {\n    context.warnings.push(\n      `Template on component \"${String(node[\"id\"] ?? \"\")}\" did not resolve to a list.`,\n    );\n    return { $type: \"ListView\", children: [] };\n  }\n  const itemCount = Math.min(list.length, TEMPLATE_ITEM_CAP);\n  if (list.length > TEMPLATE_ITEM_CAP && !context.templateCapWarned) {\n    context.warnings.push(\n      `A2UI template expansion was capped at ${TEMPLATE_ITEM_CAP} items.`,\n    );\n    context.templateCapWarned = true;\n  }\n  const children: UIElement[] = [];\n  for (let index = 0; index < itemCount; index++) {\n    if (!reserveNode(context)) break;\n    const child = convertComponent(\n      templateChildren.template.componentId,\n      list[index],\n      context,\n      depth + 1,\n      visited,\n    );\n    children.push({\n      $type: \"ListViewItem\",\n      ...(child ? { children: child } : {}),\n    });\n  }\n  return { $type: \"ListView\", children };\n};\n\nfunction convertComponent(\n  componentId: string,\n  dataSource: unknown,\n  context: ConversionContext,\n  depth: number,\n  visited: Set<string>,\n): UIElement | null {\n  if (depth >= DEPTH_CAP) {\n    if (!context.depthWarned) {\n      context.warnings.push(`A2UI depth cap of ${DEPTH_CAP} was reached.`);\n      context.depthWarned = true;\n    }\n    return null;\n  }\n  if (visited.has(componentId)) {\n    context.warnings.push(`A2UI component cycle detected at \"${componentId}\".`);\n    return null;\n  }\n  const node = context.surface.components.get(componentId);\n  if (!node) {\n    context.warnings.push(`A2UI component \"${componentId}\" was not found.`);\n    return null;\n  }\n  const component = node[\"component\"];\n\n  visited.add(componentId);\n  try {\n    const templateChildren = node[\"children\"];\n    if (isTemplateChildren(templateChildren)) {\n      return convertTemplate(\n        node,\n        templateChildren,\n        dataSource,\n        context,\n        depth,\n        visited,\n      );\n    }\n    if (typeof component !== \"string\" || !SUPPORTED_COMPONENTS.has(component)) {\n      context.warnings.push(\n        `Unknown A2UI component \"${String(component ?? \"\")}\" was skipped.`,\n      );\n      return null;\n    }\n    if (!reserveNode(context)) return null;\n    const props: Record<string, unknown> = {};\n    for (const [key, value] of Object.entries(node)) {\n      if (key === \"id\" || key === \"component\" || key === \"children\") continue;\n      const resolved = materialize(value, dataSource);\n      if (resolved !== undefined) props[key] = resolved;\n    }\n    const mapped = mappedProps(node, props, dataSource, context);\n    if (!mapped) return null;\n    const children = childrenOf(node, dataSource, context, depth, visited);\n    return {\n      ...mapped,\n      ...(children.length > 0 ? { children } : {}),\n    };\n  } finally {\n    visited.delete(componentId);\n  }\n}\n\nexport function convertSurfaceToUISpec(surface: A2uiSurfaceState): {\n  spec: UIElement | null;\n  warnings: string[];\n} {\n  const warnings: string[] = [];\n  if (!surface.components.has(\"root\")) {\n    return {\n      spec: null,\n      warnings: ['A2UI root component \"root\" was not found.'],\n    };\n  }\n  const context: ConversionContext = {\n    surface,\n    surfaceId: sourceSurfaceId(surface),\n    warnings,\n    emittedNodes: 0,\n    depthWarned: false,\n    budgetWarned: false,\n    templateCapWarned: false,\n  };\n  try {\n    const spec = convertComponent(\n      \"root\",\n      surface.dataModel,\n      context,\n      0,\n      new Set(),\n    );\n    return { spec, warnings };\n  } catch {\n    warnings.push(\"A2UI surface conversion encountered malformed input.\");\n    return { spec: null, warnings };\n  }\n}\n"],"mappings":"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"}
+{"version":3,"file":"convert.js","names":[],"sources":["../../src/a2ui/convert.ts"],"sourcesContent":["import type { UIElement } from \"../ir\";\nimport {\n  A2UI_SURFACE_ID,\n  type A2uiSurfaceState,\n  type A2uiTemplateChildren,\n} from \"./types\";\n\nconst DEPTH_CAP = 32;\nconst TEMPLATE_ITEM_CAP = 100;\nconst NODE_BUDGET = 5000;\n\nconst SUPPORTED_COMPONENTS = new Set([\n  \"Text\",\n  \"Image\",\n  \"Row\",\n  \"Column\",\n  \"Card\",\n  \"Divider\",\n  \"Button\",\n  \"TextField\",\n  \"CheckBox\",\n]);\n\nconst isRecord = (value: unknown): value is Record<string, unknown> =>\n  typeof value === \"object\" && value !== null && !Array.isArray(value);\n\nconst isPlainObject = (value: unknown): value is Record<string, unknown> => {\n  if (!isRecord(value)) return false;\n  const prototype = Object.getPrototypeOf(value);\n  return prototype === Object.prototype || prototype === null;\n};\n\nconst setOwnProperty = (\n  target: Record<string, unknown>,\n  key: string,\n  value: unknown,\n) => {\n  if (key === \"__proto__\") {\n    Object.defineProperty(target, key, {\n      value,\n      enumerable: true,\n      configurable: true,\n      writable: true,\n    });\n  } else {\n    target[key] = value;\n  }\n};\n\nconst isBinding = (value: unknown): value is { readonly path: string } =>\n  isPlainObject(value) &&\n  Object.keys(value).length === 1 &&\n  typeof value[\"path\"] === \"string\";\n\nconst isTemplateChildren = (value: unknown): value is A2uiTemplateChildren =>\n  isPlainObject(value) &&\n  Object.keys(value).length === 1 &&\n  isPlainObject(value[\"template\"]) &&\n  Object.keys(value[\"template\"]).length === 2 &&\n  typeof value[\"template\"][\"componentId\"] === \"string\" &&\n  typeof value[\"template\"][\"path\"] === \"string\";\n\nconst decodePointer = (path: string): string[] | undefined => {\n  if (path === \"\" || path === \"/\") return [];\n  if (!path.startsWith(\"/\")) return undefined;\n  return path\n    .slice(1)\n    .split(\"/\")\n    .map((segment) => segment.replaceAll(\"~1\", \"/\").replaceAll(\"~0\", \"~\"));\n};\n\nconst resolvePointer = (source: unknown, path: string): unknown => {\n  const segments = decodePointer(path);\n  if (!segments) return undefined;\n  let current = source;\n  for (const segment of segments) {\n    if (Array.isArray(current)) {\n      if (!/^(0|[1-9]\\d*)$/.test(segment)) return undefined;\n      current = current[Number(segment)];\n      continue;\n    }\n    if (!isRecord(current) || !Object.hasOwn(current, segment)) {\n      return undefined;\n    }\n    current = current[segment];\n  }\n  return current;\n};\n\nconst bindingPath = (value: unknown): string | undefined =>\n  isBinding(value) ? value.path : undefined;\n\nconst lastPointerSegment = (path: string | undefined): string | undefined => {\n  if (!path) return undefined;\n  const segments = decodePointer(path);\n  return segments?.at(-1);\n};\n\nconst materialize = (value: unknown, source: unknown): unknown => {\n  if (isBinding(value)) return resolvePointer(source, value.path);\n  if (Array.isArray(value)) {\n    return value\n      .map((entry) => materialize(entry, source))\n      .filter((entry) => entry !== undefined);\n  }\n  if (!isPlainObject(value)) return value;\n  const result: Record<string, unknown> = {};\n  for (const [key, entry] of Object.entries(value)) {\n    const resolved = materialize(entry, source);\n    if (resolved !== undefined) {\n      setOwnProperty(result, key, resolved);\n    }\n  }\n  return result;\n};\n\nconst firstDefined = (\n  props: Record<string, unknown>,\n  keys: readonly string[],\n): unknown => {\n  for (const key of keys) {\n    if (props[key] !== undefined) return props[key];\n  }\n  return undefined;\n};\n\nconst stringProp = (\n  props: Record<string, unknown>,\n  keys: readonly string[],\n): string | undefined => {\n  const value = firstDefined(props, keys);\n  return typeof value === \"string\" ? value : undefined;\n};\n\nconst sourceSurfaceId = (surface: A2uiSurfaceState): string =>\n  (surface as A2uiSurfaceState & { [A2UI_SURFACE_ID]?: string })[\n    A2UI_SURFACE_ID\n  ] ?? \"\";\n\ntype ConversionContext = {\n  readonly surface: A2uiSurfaceState;\n  readonly surfaceId: string;\n  readonly warnings: string[];\n  emittedNodes: number;\n  depthWarned: boolean;\n  budgetWarned: boolean;\n  templateCapWarned: boolean;\n};\n\nconst reserveNode = (context: ConversionContext): boolean => {\n  if (context.emittedNodes >= NODE_BUDGET) {\n    if (!context.budgetWarned) {\n      context.warnings.push(`A2UI node budget of ${NODE_BUDGET} was reached.`);\n      context.budgetWarned = true;\n    }\n    return false;\n  }\n  context.emittedNodes++;\n  return true;\n};\n\nconst childrenOf = (\n  node: Record<string, unknown>,\n  dataSource: unknown,\n  context: ConversionContext,\n  depth: number,\n  visited: Set<string>,\n): UIElement[] => {\n  const children = node[\"children\"];\n  if (!Array.isArray(children)) return [];\n  const result: UIElement[] = [];\n  for (const childId of children) {\n    if (typeof childId !== \"string\") {\n      context.warnings.push(\n        `Component \"${String(node[\"id\"] ?? \"\")}\" has a malformed child reference.`,\n      );\n      continue;\n    }\n    const child = convertComponent(\n      childId,\n      dataSource,\n      context,\n      depth + 1,\n      visited,\n    );\n    if (child) result.push(child);\n  }\n  return result;\n};\n\nconst mappedAction = (\n  node: Record<string, unknown>,\n  props: Record<string, unknown>,\n  dataSource: unknown,\n  context: ConversionContext,\n): UIElement[\"$action\"] | undefined => {\n  const action = props[\"action\"];\n  const actionName =\n    typeof action === \"string\"\n      ? action\n      : isRecord(action) && typeof action[\"name\"] === \"string\"\n        ? action[\"name\"]\n        : undefined;\n  if (!actionName) return undefined;\n  const rawContext = isRecord(action) ? action[\"context\"] : undefined;\n  const resolvedContext =\n    rawContext === undefined ? undefined : materialize(rawContext, dataSource);\n  return {\n    type: \"a2ui:action\",\n    name: actionName,\n    surfaceId: context.surfaceId,\n    sourceComponentId: typeof node[\"id\"] === \"string\" ? node[\"id\"] : \"\",\n    ...(resolvedContext !== undefined ? { context: resolvedContext } : {}),\n  };\n};\n\nconst mappedProps = (\n  node: Record<string, unknown>,\n  props: Record<string, unknown>,\n  dataSource: unknown,\n  context: ConversionContext,\n): UIElement | undefined => {\n  const component = node[\"component\"];\n\n  if (component === \"Text\") {\n    const text = stringProp(props, [\"text\", \"value\"]);\n    const variant = props[\"variant\"];\n    if (typeof variant === \"string\" && /^h[1-6]$/.test(variant)) {\n      return {\n        $type: \"Header\",\n        ...(text !== undefined ? { text } : {}),\n      };\n    }\n    if (variant === \"caption\") {\n      return {\n        $type: \"Caption\",\n        ...(text !== undefined ? { value: text } : {}),\n      };\n    }\n    return {\n      $type: \"Markdown\",\n      ...(text !== undefined ? { value: text } : {}),\n    };\n  }\n\n  if (component === \"Image\") {\n    const src = stringProp(props, [\"src\", \"url\"]);\n    const alt = stringProp(props, [\"alt\", \"altText\"]);\n    const size = props[\"size\"];\n    const round = props[\"round\"];\n    return {\n      $type: \"Image\",\n      ...(src !== undefined ? { src } : {}),\n      ...(alt !== undefined ? { alt } : {}),\n      ...(typeof size === \"string\" || typeof size === \"number\" ? { size } : {}),\n      ...(typeof round === \"boolean\" ? { round } : {}),\n    };\n  }\n\n  if (component === \"Row\") {\n    const gap = props[\"gap\"];\n    const align = firstDefined(props, [\"align\", \"alignment\"]);\n    const justify = firstDefined(props, [\"justify\", \"distribution\"]);\n    return {\n      $type: \"Row\",\n      ...(typeof gap === \"number\" ? { gap } : {}),\n      ...(typeof align === \"string\" ? { align } : {}),\n      ...(typeof justify === \"string\" ? { justify } : {}),\n    };\n  }\n\n  if (component === \"Column\") {\n    const gap = props[\"gap\"];\n    const align = firstDefined(props, [\"align\", \"alignment\"]);\n    return {\n      $type: \"Col\",\n      ...(typeof gap === \"number\" ? { gap } : {}),\n      ...(typeof align === \"string\" ? { align } : {}),\n    };\n  }\n\n  if (component === \"Card\") {\n    const title = props[\"title\"];\n    const padding = props[\"padding\"];\n    const background = props[\"background\"];\n    return {\n      $type: \"Card\",\n      ...(typeof title === \"string\" ? { title } : {}),\n      ...(typeof padding === \"number\" ? { padding } : {}),\n      ...(typeof background === \"string\" ? { background } : {}),\n    };\n  }\n\n  if (component === \"Divider\") {\n    return {\n      $type: \"Divider\",\n      ...(typeof props[\"flush\"] === \"boolean\" ? { flush: props[\"flush\"] } : {}),\n    };\n  }\n\n  if (component === \"Button\") {\n    const label = stringProp(props, [\"label\", \"text\"]);\n    const buttonStyle = props[\"buttonStyle\"];\n    const block = props[\"block\"];\n    const submit = props[\"submit\"];\n    const action = mappedAction(node, props, dataSource, context);\n    return {\n      $type: \"Button\",\n      ...(label !== undefined ? { label } : {}),\n      ...(typeof buttonStyle === \"string\" ? { buttonStyle } : {}),\n      ...(typeof block === \"boolean\" ? { block } : {}),\n      ...(typeof submit === \"boolean\" ? { submit } : {}),\n      ...(action ? { $action: action } : {}),\n    };\n  }\n\n  const binding = firstDefined(node, [\"text\", \"value\", \"binding\"]);\n  const name = lastPointerSegment(bindingPath(binding));\n  const label = stringProp(props, [\"label\"]);\n\n  if (component === \"TextField\") {\n    const placeholder = stringProp(props, [\"placeholder\"]);\n    const multiline =\n      typeof props[\"multiline\"] === \"boolean\"\n        ? props[\"multiline\"]\n        : props[\"textFieldType\"] === \"longText\"\n          ? true\n          : undefined;\n    return {\n      $type: \"Input\",\n      ...(placeholder !== undefined ? { placeholder } : {}),\n      ...(multiline !== undefined ? { multiline } : {}),\n      ...(label !== undefined ? { label } : {}),\n      ...(name !== undefined ? { name } : {}),\n    };\n  }\n\n  if (component === \"CheckBox\") {\n    const defaultChecked = firstDefined(props, [\"defaultChecked\", \"value\"]);\n    return {\n      $type: \"Checkbox\",\n      ...(label !== undefined ? { label } : {}),\n      ...(name !== undefined ? { name } : {}),\n      ...(typeof defaultChecked === \"boolean\" ? { defaultChecked } : {}),\n    };\n  }\n\n  return undefined;\n};\n\nconst convertTemplate = (\n  node: Record<string, unknown>,\n  templateChildren: A2uiTemplateChildren,\n  dataSource: unknown,\n  context: ConversionContext,\n  depth: number,\n  visited: Set<string>,\n): UIElement | null => {\n  if (!reserveNode(context)) return null;\n  const list = resolvePointer(dataSource, templateChildren.template.path);\n  if (!Array.isArray(list)) {\n    context.warnings.push(\n      `Template on component \"${String(node[\"id\"] ?? \"\")}\" did not resolve to a list.`,\n    );\n    return { $type: \"ListView\", children: [] };\n  }\n  const itemCount = Math.min(list.length, TEMPLATE_ITEM_CAP);\n  if (list.length > TEMPLATE_ITEM_CAP && !context.templateCapWarned) {\n    context.warnings.push(\n      `A2UI template expansion was capped at ${TEMPLATE_ITEM_CAP} items.`,\n    );\n    context.templateCapWarned = true;\n  }\n  const children: UIElement[] = [];\n  for (let index = 0; index < itemCount; index++) {\n    if (!reserveNode(context)) break;\n    const child = convertComponent(\n      templateChildren.template.componentId,\n      list[index],\n      context,\n      depth + 1,\n      visited,\n    );\n    children.push({\n      $type: \"ListViewItem\",\n      ...(child ? { children: child } : {}),\n    });\n  }\n  return { $type: \"ListView\", children };\n};\n\nfunction convertComponent(\n  componentId: string,\n  dataSource: unknown,\n  context: ConversionContext,\n  depth: number,\n  visited: Set<string>,\n): UIElement | null {\n  if (depth >= DEPTH_CAP) {\n    if (!context.depthWarned) {\n      context.warnings.push(`A2UI depth cap of ${DEPTH_CAP} was reached.`);\n      context.depthWarned = true;\n    }\n    return null;\n  }\n  if (visited.has(componentId)) {\n    context.warnings.push(`A2UI component cycle detected at \"${componentId}\".`);\n    return null;\n  }\n  const node = context.surface.components.get(componentId);\n  if (!node) {\n    context.warnings.push(`A2UI component \"${componentId}\" was not found.`);\n    return null;\n  }\n  const component = node[\"component\"];\n\n  visited.add(componentId);\n  try {\n    const templateChildren = node[\"children\"];\n    if (isTemplateChildren(templateChildren)) {\n      return convertTemplate(\n        node,\n        templateChildren,\n        dataSource,\n        context,\n        depth,\n        visited,\n      );\n    }\n    if (typeof component !== \"string\" || !SUPPORTED_COMPONENTS.has(component)) {\n      context.warnings.push(\n        `Unknown A2UI component \"${String(component ?? \"\")}\" was skipped.`,\n      );\n      return null;\n    }\n    if (!reserveNode(context)) return null;\n    const props: Record<string, unknown> = {};\n    for (const [key, value] of Object.entries(node)) {\n      if (key === \"id\" || key === \"component\" || key === \"children\") continue;\n      const resolved = materialize(value, dataSource);\n      if (resolved !== undefined) setOwnProperty(props, key, resolved);\n    }\n    const mapped = mappedProps(node, props, dataSource, context);\n    if (!mapped) return null;\n    const children = childrenOf(node, dataSource, context, depth, visited);\n    return {\n      ...mapped,\n      ...(children.length > 0 ? { children } : {}),\n    };\n  } finally {\n    visited.delete(componentId);\n  }\n}\n\nexport function convertSurfaceToUISpec(surface: A2uiSurfaceState): {\n  spec: UIElement | null;\n  warnings: string[];\n} {\n  const warnings: string[] = [];\n  if (!surface.components.has(\"root\")) {\n    return {\n      spec: null,\n      warnings: ['A2UI root component \"root\" was not found.'],\n    };\n  }\n  const context: ConversionContext = {\n    surface,\n    surfaceId: sourceSurfaceId(surface),\n    warnings,\n    emittedNodes: 0,\n    depthWarned: false,\n    budgetWarned: false,\n    templateCapWarned: false,\n  };\n  try {\n    const spec = convertComponent(\n      \"root\",\n      surface.dataModel,\n      context,\n      0,\n      new Set(),\n    );\n    return { spec, warnings };\n  } catch {\n    warnings.push(\"A2UI surface conversion encountered malformed input.\");\n    return { spec: null, warnings };\n  }\n}\n"],"mappings":"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"}

package/dist/a2ui/reducer.d.ts

@@ -1,6 +1,5 @@
 import { A2uiOperationResult, A2uiState } from "./types.js";
 //#region src/a2ui/reducer.d.ts
-declare function applyA2uiOperations(state: A2uiState, operations: unknown): A2uiOperationResult;
+export declare function applyA2uiOperations(state: A2uiState, operations: unknown): A2uiOperationResult;
 //#endregion
-export { applyA2uiOperations };
 //# sourceMappingURL=reducer.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"reducer.d.ts","names":[],"sources":["../../src/a2ui/reducer.ts"],"mappings":";;iBA4JgB,oBACd,OAAO,WACP,sBACC"}
+{"version":3,"file":"reducer.d.ts","names":[],"sources":["../../src/a2ui/reducer.ts"],"mappings":";;wBAuNgB,oBACd,OAAO,WACP,sBACC"}

package/dist/a2ui/reducer.js

@@ -6,6 +6,8 @@ const OPERATION_KEYS = /* @__PURE__ */ new Set([
 	"updateDataModel",
 	"deleteSurface"
 ]);
+const MAX_AUTO_VIVIFY_ARRAY_INDEX = 1e4;
+const INVALID_POINTER = Symbol("invalidPointer");
 const isRecord = (value) => typeof value === "object" && value !== null && !Array.isArray(value);
 const isVersion = (value) => value === "v0.9" || value === "v1.0";
 const surfaceIdOf = (payload) => {
@@ -44,7 +46,7 @@ const decodePointer = (path) => {
 	return path.slice(1).split("/").map((segment) => segment.replaceAll("~1", "/").replaceAll("~0", "~"));
 };
 const isArrayIndex = (segment) => segment === "0" || /^[1-9]\d*$/.test(segment);
-const setAtPointer = (model, path, value) => {
+const setAtPointer = (model, path, value, nullDeletes) => {
 	const segments = decodePointer(path);
 	if (!segments) return {
 		ok: false,
@@ -54,24 +56,75 @@ const setAtPointer = (model, path, value) => {
 		ok: true,
 		value
 	};
+	const remove = (current, index) => {
+		const segment = segments[index];
+		const isLast = index === segments.length - 1;
+		if (Array.isArray(current)) {
+			if (segment !== "-" && !isArrayIndex(segment)) return current;
+			const targetIndex = segment === "-" ? current.length : Number(segment);
+			if (isLast) {
+				if (segment === "-" || !Object.prototype.hasOwnProperty.call(current, targetIndex)) return current;
+				const clone = current.slice();
+				delete clone[targetIndex];
+				return clone;
+			}
+			const child = current[targetIndex];
+			if (!Array.isArray(child) && !isRecord(child)) return current;
+			const next = remove(child, index + 1);
+			if (next === child) return current;
+			const clone = current.slice();
+			clone[targetIndex] = next;
+			return clone;
+		}
+		if (!isRecord(current)) return current;
+		if (!Object.prototype.hasOwnProperty.call(current, segment)) return current;
+		if (isLast) {
+			const clone = { ...current };
+			delete clone[segment];
+			return clone;
+		}
+		const child = current[segment];
+		if (!Array.isArray(child) && !isRecord(child)) return current;
+		const next = remove(child, index + 1);
+		if (next === child) return current;
+		return {
+			...current,
+			[segment]: next
+		};
+	};
+	if (nullDeletes && value === null) return {
+		ok: true,
+		value: remove(model, 0)
+	};
 	const update = (current, index) => {
 		const segment = segments[index];
 		const isLast = index === segments.length - 1;
 		if (Array.isArray(current)) {
 			if (segment !== "-" && !isArrayIndex(segment)) return current;
+			const targetIndex = segment === "-" ? current.length : Number(segment);
+			if (segment !== "-" && targetIndex >= current.length && targetIndex > MAX_AUTO_VIVIFY_ARRAY_INDEX) return INVALID_POINTER;
+			const next = isLast ? value : update(current[targetIndex], index + 1);
+			if (next === INVALID_POINTER) return INVALID_POINTER;
 			const clone = current.slice();
-			const targetIndex = segment === "-" ? clone.length : Number(segment);
-			clone[targetIndex] = isLast ? value : update(clone[targetIndex], index + 1);
+			clone[targetIndex] = next;
 			return clone;
 		}
-		const clone = isRecord(current) ? { ...current } : {};
-		const child = clone[segment];
-		clone[segment] = isLast ? value : update(child ?? (isArrayIndex(segments[index + 1] ?? "") || segments[index + 1] === "-" ? [] : {}), index + 1);
-		return clone;
+		const record = isRecord(current) ? current : {};
+		const child = Object.hasOwn(record, segment) ? record[segment] : void 0;
+		const next = isLast ? value : update(child ?? (isArrayIndex(segments[index + 1] ?? "") || segments[index + 1] === "-" ? [] : {}), index + 1);
+		if (next === INVALID_POINTER) return INVALID_POINTER;
+		return {
+			...record,
+			[segment]: next
+		};
 	};
-	return {
+	const result = update(model, 0);
+	return result === INVALID_POINTER ? {
+		ok: false,
+		value: model
+	} : {
 		ok: true,
-		value: update(model, 0)
+		value: result
 	};
 };
 const dataModelValue = (payload) => {
@@ -160,7 +213,7 @@ function applyA2uiOperations(state, operations) {
 			warnings.push(`Operation at index ${index} has a malformed data model path.`);
 			continue;
 		}
-		const result = setAtPointer(surface.dataModel, path, update.value);
+		const result = setAtPointer(surface.dataModel, path, update.value, version === "v1.0");
 		if (!result.ok) {
 			warnings.push(`Operation at index ${index} has an invalid JSON Pointer path.`);
 			continue;

package/dist/a2ui/reducer.js.map

@@ -1 +1 @@
-{"version":3,"file":"reducer.js","names":[],"sources":["../../src/a2ui/reducer.ts"],"sourcesContent":["import {\n  A2UI_SURFACE_ID,\n  type A2uiOperationResult,\n  type A2uiState,\n  type A2uiSurfaceState,\n} from \"./types\";\n\nconst OPERATION_KEYS = new Set([\n  \"createSurface\",\n  \"updateComponents\",\n  \"updateDataModel\",\n  \"deleteSurface\",\n]);\n\nconst isRecord = (value: unknown): value is Record<string, unknown> =>\n  typeof value === \"object\" && value !== null && !Array.isArray(value);\n\nconst isVersion = (value: unknown): value is \"v0.9\" | \"v1.0\" =>\n  value === \"v0.9\" || value === \"v1.0\";\n\nconst surfaceIdOf = (payload: Record<string, unknown>): string | undefined => {\n  const surfaceId = payload[\"surfaceId\"];\n  return typeof surfaceId === \"string\" && surfaceId.length > 0\n    ? surfaceId\n    : undefined;\n};\n\nconst withSurfaceId = (\n  surface: A2uiSurfaceState,\n  surfaceId: string,\n): A2uiSurfaceState => {\n  Object.defineProperty(surface, A2UI_SURFACE_ID, {\n    value: surfaceId,\n    enumerable: false,\n  });\n  return surface;\n};\n\nconst getSurfaceId = (surface: A2uiSurfaceState): string | undefined =>\n  (surface as A2uiSurfaceState & { [A2UI_SURFACE_ID]?: string })[\n    A2UI_SURFACE_ID\n  ];\n\nconst cloneSurface = (\n  surface: A2uiSurfaceState,\n  surfaceId: string,\n): A2uiSurfaceState =>\n  withSurfaceId(\n    {\n      components: new Map(surface.components),\n      dataModel: surface.dataModel,\n    },\n    getSurfaceId(surface) ?? surfaceId,\n  );\n\nconst upsertComponents = (\n  surface: A2uiSurfaceState,\n  components: unknown,\n  warnings: string[],\n  operationIndex: number,\n): void => {\n  if (!Array.isArray(components)) {\n    warnings.push(\n      `Operation at index ${operationIndex} has malformed components.`,\n    );\n    return;\n  }\n\n  for (\n    let componentIndex = 0;\n    componentIndex < components.length;\n    componentIndex++\n  ) {\n    const component = components[componentIndex];\n    if (\n      !isRecord(component) ||\n      typeof component[\"id\"] !== \"string\" ||\n      component[\"id\"].length === 0 ||\n      typeof component[\"component\"] !== \"string\" ||\n      component[\"component\"].length === 0\n    ) {\n      warnings.push(\n        `Component at index ${componentIndex} in operation ${operationIndex} is malformed.`,\n      );\n      continue;\n    }\n    surface.components.set(component[\"id\"], { ...component });\n  }\n};\n\nconst decodePointer = (path: string): string[] | undefined => {\n  if (path === \"\" || path === \"/\") return [];\n  if (!path.startsWith(\"/\")) return undefined;\n  return path\n    .slice(1)\n    .split(\"/\")\n    .map((segment) => segment.replaceAll(\"~1\", \"/\").replaceAll(\"~0\", \"~\"));\n};\n\nconst isArrayIndex = (segment: string): boolean =>\n  segment === \"0\" || /^[1-9]\\d*$/.test(segment);\n\nconst setAtPointer = (\n  model: unknown,\n  path: string,\n  value: unknown,\n): { readonly ok: boolean; readonly value: unknown } => {\n  const segments = decodePointer(path);\n  if (!segments) return { ok: false, value: model };\n  if (segments.length === 0) return { ok: true, value };\n\n  const update = (current: unknown, index: number): unknown => {\n    const segment = segments[index]!;\n    const isLast = index === segments.length - 1;\n\n    if (Array.isArray(current)) {\n      if (segment !== \"-\" && !isArrayIndex(segment)) return current;\n      const clone = current.slice();\n      const targetIndex = segment === \"-\" ? clone.length : Number(segment);\n      clone[targetIndex] = isLast\n        ? value\n        : update(clone[targetIndex], index + 1);\n      return clone;\n    }\n\n    const clone: Record<string, unknown> = isRecord(current)\n      ? { ...current }\n      : {};\n    const child = clone[segment];\n    clone[segment] = isLast\n      ? value\n      : update(\n          child ??\n            (isArrayIndex(segments[index + 1] ?? \"\") ||\n            segments[index + 1] === \"-\"\n              ? []\n              : {}),\n          index + 1,\n        );\n    return clone;\n  };\n\n  return { ok: true, value: update(model, 0) };\n};\n\nconst dataModelValue = (\n  payload: Record<string, unknown>,\n): { readonly found: boolean; readonly value: unknown } => {\n  for (const key of [\"contents\", \"value\", \"data\"] as const) {\n    if (payload[key] !== undefined) {\n      return { found: true, value: payload[key] };\n    }\n  }\n  return { found: false, value: undefined };\n};\n\nexport function applyA2uiOperations(\n  state: A2uiState,\n  operations: unknown,\n): A2uiOperationResult {\n  const nextState = new Map(state);\n  const warnings: string[] = [];\n\n  if (!Array.isArray(operations)) {\n    return {\n      state: nextState,\n      warnings: [\"A2UI operations must be an array.\"],\n    };\n  }\n\n  for (let index = 0; index < operations.length; index++) {\n    try {\n      const entry = operations[index];\n      if (!isRecord(entry)) {\n        warnings.push(`Operation at index ${index} is malformed.`);\n        continue;\n      }\n\n      const version = entry[\"version\"];\n      if (!isVersion(version)) {\n        warnings.push(\n          `Operation at index ${index} has an unsupported version.`,\n        );\n        continue;\n      }\n\n      const operationKeys = Object.keys(entry).filter(\n        (key) => key !== \"version\",\n      );\n      if (operationKeys.length !== 1) {\n        warnings.push(\n          `Operation at index ${index} must contain exactly one operation key.`,\n        );\n        continue;\n      }\n\n      const operationKey = operationKeys[0]!;\n      if (!OPERATION_KEYS.has(operationKey)) {\n        warnings.push(\n          `Unknown A2UI operation \"${operationKey}\" at index ${index}.`,\n        );\n        continue;\n      }\n\n      const payload = entry[operationKey];\n      if (!isRecord(payload)) {\n        warnings.push(`Operation at index ${index} has a malformed payload.`);\n        continue;\n      }\n\n      const surfaceId = surfaceIdOf(payload);\n      if (!surfaceId) {\n        warnings.push(`Operation at index ${index} has no valid surfaceId.`);\n        continue;\n      }\n\n      if (operationKey === \"createSurface\") {\n        const surface = withSurfaceId(\n          {\n            components: new Map(),\n            dataModel:\n              version === \"v1.0\" && payload[\"dataModel\"] !== undefined\n                ? payload[\"dataModel\"]\n                : undefined,\n          },\n          surfaceId,\n        );\n        if (version === \"v1.0\" && payload[\"components\"] !== undefined) {\n          upsertComponents(surface, payload[\"components\"], warnings, index);\n        }\n        nextState.set(surfaceId, surface);\n        continue;\n      }\n\n      if (operationKey === \"deleteSurface\") {\n        nextState.delete(surfaceId);\n        continue;\n      }\n\n      const currentSurface = nextState.get(surfaceId);\n      if (!currentSurface) {\n        warnings.push(\n          `Operation at index ${index} references missing surface \"${surfaceId}\".`,\n        );\n        continue;\n      }\n      const surface = cloneSurface(currentSurface, surfaceId);\n\n      if (operationKey === \"updateComponents\") {\n        upsertComponents(surface, payload[\"components\"], warnings, index);\n        nextState.set(surfaceId, surface);\n        continue;\n      }\n\n      const update = dataModelValue(payload);\n      if (!update.found) {\n        warnings.push(`Operation at index ${index} has no data model value.`);\n        continue;\n      }\n      const path = payload[\"path\"] ?? \"/\";\n      if (typeof path !== \"string\") {\n        warnings.push(\n          `Operation at index ${index} has a malformed data model path.`,\n        );\n        continue;\n      }\n      const result = setAtPointer(surface.dataModel, path, update.value);\n      if (!result.ok) {\n        warnings.push(\n          `Operation at index ${index} has an invalid JSON Pointer path.`,\n        );\n        continue;\n      }\n      surface.dataModel = result.value;\n      nextState.set(surfaceId, surface);\n    } catch {\n      warnings.push(`Operation at index ${index} is malformed.`);\n    }\n  }\n\n  return { state: nextState, warnings };\n}\n"],"mappings":"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"}
+{"version":3,"file":"reducer.js","names":[],"sources":["../../src/a2ui/reducer.ts"],"sourcesContent":["import {\n  A2UI_SURFACE_ID,\n  type A2uiOperationResult,\n  type A2uiState,\n  type A2uiSurfaceState,\n} from \"./types\";\n\nconst OPERATION_KEYS = new Set([\n  \"createSurface\",\n  \"updateComponents\",\n  \"updateDataModel\",\n  \"deleteSurface\",\n]);\n// This defensive ceiling is well above the renderer's displayed-item limit.\nconst MAX_AUTO_VIVIFY_ARRAY_INDEX = 10_000;\nconst INVALID_POINTER = Symbol(\"invalidPointer\");\n\nconst isRecord = (value: unknown): value is Record<string, unknown> =>\n  typeof value === \"object\" && value !== null && !Array.isArray(value);\n\nconst isVersion = (value: unknown): value is \"v0.9\" | \"v1.0\" =>\n  value === \"v0.9\" || value === \"v1.0\";\n\nconst surfaceIdOf = (payload: Record<string, unknown>): string | undefined => {\n  const surfaceId = payload[\"surfaceId\"];\n  return typeof surfaceId === \"string\" && surfaceId.length > 0\n    ? surfaceId\n    : undefined;\n};\n\nconst withSurfaceId = (\n  surface: A2uiSurfaceState,\n  surfaceId: string,\n): A2uiSurfaceState => {\n  Object.defineProperty(surface, A2UI_SURFACE_ID, {\n    value: surfaceId,\n    enumerable: false,\n  });\n  return surface;\n};\n\nconst getSurfaceId = (surface: A2uiSurfaceState): string | undefined =>\n  (surface as A2uiSurfaceState & { [A2UI_SURFACE_ID]?: string })[\n    A2UI_SURFACE_ID\n  ];\n\nconst cloneSurface = (\n  surface: A2uiSurfaceState,\n  surfaceId: string,\n): A2uiSurfaceState =>\n  withSurfaceId(\n    {\n      components: new Map(surface.components),\n      dataModel: surface.dataModel,\n    },\n    getSurfaceId(surface) ?? surfaceId,\n  );\n\nconst upsertComponents = (\n  surface: A2uiSurfaceState,\n  components: unknown,\n  warnings: string[],\n  operationIndex: number,\n): void => {\n  if (!Array.isArray(components)) {\n    warnings.push(\n      `Operation at index ${operationIndex} has malformed components.`,\n    );\n    return;\n  }\n\n  for (\n    let componentIndex = 0;\n    componentIndex < components.length;\n    componentIndex++\n  ) {\n    const component = components[componentIndex];\n    if (\n      !isRecord(component) ||\n      typeof component[\"id\"] !== \"string\" ||\n      component[\"id\"].length === 0 ||\n      typeof component[\"component\"] !== \"string\" ||\n      component[\"component\"].length === 0\n    ) {\n      warnings.push(\n        `Component at index ${componentIndex} in operation ${operationIndex} is malformed.`,\n      );\n      continue;\n    }\n    surface.components.set(component[\"id\"], { ...component });\n  }\n};\n\nconst decodePointer = (path: string): string[] | undefined => {\n  if (path === \"\" || path === \"/\") return [];\n  if (!path.startsWith(\"/\")) return undefined;\n  return path\n    .slice(1)\n    .split(\"/\")\n    .map((segment) => segment.replaceAll(\"~1\", \"/\").replaceAll(\"~0\", \"~\"));\n};\n\nconst isArrayIndex = (segment: string): boolean =>\n  segment === \"0\" || /^[1-9]\\d*$/.test(segment);\n\nconst setAtPointer = (\n  model: unknown,\n  path: string,\n  value: unknown,\n  nullDeletes: boolean,\n): { readonly ok: boolean; readonly value: unknown } => {\n  const segments = decodePointer(path);\n  if (!segments) return { ok: false, value: model };\n  if (segments.length === 0) return { ok: true, value };\n\n  const remove = (current: unknown, index: number): unknown => {\n    const segment = segments[index]!;\n    const isLast = index === segments.length - 1;\n\n    if (Array.isArray(current)) {\n      if (segment !== \"-\" && !isArrayIndex(segment)) return current;\n      const targetIndex = segment === \"-\" ? current.length : Number(segment);\n      if (isLast) {\n        if (\n          segment === \"-\" ||\n          !Object.prototype.hasOwnProperty.call(current, targetIndex)\n        ) {\n          return current;\n        }\n        const clone = current.slice();\n        // Preserve indices referenced by other JSON Pointers.\n        delete clone[targetIndex];\n        return clone;\n      }\n      const child = current[targetIndex];\n      if (!Array.isArray(child) && !isRecord(child)) return current;\n      const next = remove(child, index + 1);\n      if (next === child) return current;\n      const clone = current.slice();\n      clone[targetIndex] = next;\n      return clone;\n    }\n\n    if (!isRecord(current)) return current;\n    if (!Object.prototype.hasOwnProperty.call(current, segment)) return current;\n    if (isLast) {\n      const clone = { ...current };\n      delete clone[segment];\n      return clone;\n    }\n    const child = current[segment];\n    if (!Array.isArray(child) && !isRecord(child)) return current;\n    const next = remove(child, index + 1);\n    if (next === child) return current;\n    return { ...current, [segment]: next };\n  };\n\n  if (nullDeletes && value === null) {\n    return { ok: true, value: remove(model, 0) };\n  }\n\n  const update = (current: unknown, index: number): unknown => {\n    const segment = segments[index]!;\n    const isLast = index === segments.length - 1;\n\n    if (Array.isArray(current)) {\n      if (segment !== \"-\" && !isArrayIndex(segment)) return current;\n      const targetIndex = segment === \"-\" ? current.length : Number(segment);\n      if (\n        segment !== \"-\" &&\n        targetIndex >= current.length &&\n        targetIndex > MAX_AUTO_VIVIFY_ARRAY_INDEX\n      ) {\n        return INVALID_POINTER;\n      }\n      const next = isLast ? value : update(current[targetIndex], index + 1);\n      if (next === INVALID_POINTER) return INVALID_POINTER;\n      const clone = current.slice();\n      clone[targetIndex] = next;\n      return clone;\n    }\n\n    const record: Record<string, unknown> = isRecord(current) ? current : {};\n    const child = Object.hasOwn(record, segment) ? record[segment] : undefined;\n    const next = isLast\n      ? value\n      : update(\n          child ??\n            (isArrayIndex(segments[index + 1] ?? \"\") ||\n            segments[index + 1] === \"-\"\n              ? []\n              : {}),\n          index + 1,\n        );\n    if (next === INVALID_POINTER) return INVALID_POINTER;\n    return { ...record, [segment]: next };\n  };\n\n  const result = update(model, 0);\n  return result === INVALID_POINTER\n    ? { ok: false, value: model }\n    : { ok: true, value: result };\n};\n\nconst dataModelValue = (\n  payload: Record<string, unknown>,\n): { readonly found: boolean; readonly value: unknown } => {\n  for (const key of [\"contents\", \"value\", \"data\"] as const) {\n    if (payload[key] !== undefined) {\n      return { found: true, value: payload[key] };\n    }\n  }\n  return { found: false, value: undefined };\n};\n\nexport function applyA2uiOperations(\n  state: A2uiState,\n  operations: unknown,\n): A2uiOperationResult {\n  const nextState = new Map(state);\n  const warnings: string[] = [];\n\n  if (!Array.isArray(operations)) {\n    return {\n      state: nextState,\n      warnings: [\"A2UI operations must be an array.\"],\n    };\n  }\n\n  for (let index = 0; index < operations.length; index++) {\n    try {\n      const entry = operations[index];\n      if (!isRecord(entry)) {\n        warnings.push(`Operation at index ${index} is malformed.`);\n        continue;\n      }\n\n      const version = entry[\"version\"];\n      if (!isVersion(version)) {\n        warnings.push(\n          `Operation at index ${index} has an unsupported version.`,\n        );\n        continue;\n      }\n\n      const operationKeys = Object.keys(entry).filter(\n        (key) => key !== \"version\",\n      );\n      if (operationKeys.length !== 1) {\n        warnings.push(\n          `Operation at index ${index} must contain exactly one operation key.`,\n        );\n        continue;\n      }\n\n      const operationKey = operationKeys[0]!;\n      if (!OPERATION_KEYS.has(operationKey)) {\n        warnings.push(\n          `Unknown A2UI operation \"${operationKey}\" at index ${index}.`,\n        );\n        continue;\n      }\n\n      const payload = entry[operationKey];\n      if (!isRecord(payload)) {\n        warnings.push(`Operation at index ${index} has a malformed payload.`);\n        continue;\n      }\n\n      const surfaceId = surfaceIdOf(payload);\n      if (!surfaceId) {\n        warnings.push(`Operation at index ${index} has no valid surfaceId.`);\n        continue;\n      }\n\n      if (operationKey === \"createSurface\") {\n        const surface = withSurfaceId(\n          {\n            components: new Map(),\n            dataModel:\n              version === \"v1.0\" && payload[\"dataModel\"] !== undefined\n                ? payload[\"dataModel\"]\n                : undefined,\n          },\n          surfaceId,\n        );\n        if (version === \"v1.0\" && payload[\"components\"] !== undefined) {\n          upsertComponents(surface, payload[\"components\"], warnings, index);\n        }\n        nextState.set(surfaceId, surface);\n        continue;\n      }\n\n      if (operationKey === \"deleteSurface\") {\n        nextState.delete(surfaceId);\n        continue;\n      }\n\n      const currentSurface = nextState.get(surfaceId);\n      if (!currentSurface) {\n        warnings.push(\n          `Operation at index ${index} references missing surface \"${surfaceId}\".`,\n        );\n        continue;\n      }\n      const surface = cloneSurface(currentSurface, surfaceId);\n\n      if (operationKey === \"updateComponents\") {\n        upsertComponents(surface, payload[\"components\"], warnings, index);\n        nextState.set(surfaceId, surface);\n        continue;\n      }\n\n      const update = dataModelValue(payload);\n      if (!update.found) {\n        warnings.push(`Operation at index ${index} has no data model value.`);\n        continue;\n      }\n      const path = payload[\"path\"] ?? \"/\";\n      if (typeof path !== \"string\") {\n        warnings.push(\n          `Operation at index ${index} has a malformed data model path.`,\n        );\n        continue;\n      }\n      const result = setAtPointer(\n        surface.dataModel,\n        path,\n        update.value,\n        version === \"v1.0\",\n      );\n      if (!result.ok) {\n        warnings.push(\n          `Operation at index ${index} has an invalid JSON Pointer path.`,\n        );\n        continue;\n      }\n      surface.dataModel = result.value;\n      nextState.set(surfaceId, surface);\n    } catch {\n      warnings.push(`Operation at index ${index} is malformed.`);\n    }\n  }\n\n  return { state: nextState, warnings };\n}\n"],"mappings":"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"}

package/dist/a2ui/types.d.ts

@@ -1,73 +1,72 @@
 //#region src/a2ui/types.d.ts
-declare const A2UI_SURFACE_ID: unique symbol;
-type A2uiVersion = "v0.9" | "v1.0";
-interface A2uiTemplateChildren {
+export declare const A2UI_SURFACE_ID: unique symbol;
+export type A2uiVersion = "v0.9" | "v1.0";
+export interface A2uiTemplateChildren {
   readonly template: {
     readonly componentId: string;
     readonly path: string;
   };
 }
-interface ComponentNode extends Record<string, unknown> {
+export interface ComponentNode extends Record<string, unknown> {
   readonly id: string;
   readonly component: string;
   readonly children?: readonly string[] | A2uiTemplateChildren;
 }
-interface A2uiCreateSurfaceV09Payload {
+export interface A2uiCreateSurfaceV09Payload {
   readonly surfaceId: string;
   readonly catalogId?: string;
   readonly theme?: unknown;
   readonly attachDataModel?: unknown;
 }
-interface A2uiCreateSurfaceV10Payload {
+export interface A2uiCreateSurfaceV10Payload {
   readonly surfaceId: string;
   readonly surfaceProperties?: unknown;
   readonly sendDataModel?: unknown;
   readonly components?: readonly ComponentNode[];
   readonly dataModel?: unknown;
 }
-interface A2uiUpdateComponentsPayload {
+export interface A2uiUpdateComponentsPayload {
   readonly surfaceId: string;
   readonly components: readonly ComponentNode[];
 }
-interface A2uiUpdateDataModelPayload {
+export interface A2uiUpdateDataModelPayload {
   readonly surfaceId: string;
   readonly path?: string;
   readonly contents?: unknown;
   readonly value?: unknown;
   readonly data?: unknown;
 }
-interface A2uiDeleteSurfacePayload {
+export interface A2uiDeleteSurfacePayload {
   readonly surfaceId: string;
 }
-type A2uiCreateSurfaceOperation = {
+export type A2uiCreateSurfaceOperation = {
   readonly version: "v0.9";
   readonly createSurface: A2uiCreateSurfaceV09Payload;
 } | {
   readonly version: "v1.0";
   readonly createSurface: A2uiCreateSurfaceV10Payload;
 };
-interface A2uiUpdateComponentsOperation {
+export interface A2uiUpdateComponentsOperation {
   readonly version: A2uiVersion;
   readonly updateComponents: A2uiUpdateComponentsPayload;
 }
-interface A2uiUpdateDataModelOperation {
+export interface A2uiUpdateDataModelOperation {
   readonly version: A2uiVersion;
   readonly updateDataModel: A2uiUpdateDataModelPayload;
 }
-interface A2uiDeleteSurfaceOperation {
+export interface A2uiDeleteSurfaceOperation {
   readonly version: A2uiVersion;
   readonly deleteSurface: A2uiDeleteSurfacePayload;
 }
-type A2uiOperation = A2uiCreateSurfaceOperation | A2uiUpdateComponentsOperation | A2uiUpdateDataModelOperation | A2uiDeleteSurfaceOperation;
-type A2uiSurfaceState = {
+export type A2uiOperation = A2uiCreateSurfaceOperation | A2uiUpdateComponentsOperation | A2uiUpdateDataModelOperation | A2uiDeleteSurfaceOperation;
+export type A2uiSurfaceState = {
   components: Map<string, Record<string, unknown>>;
   dataModel: unknown;
 };
-type A2uiState = ReadonlyMap<string, A2uiSurfaceState>;
-interface A2uiOperationResult {
+export type A2uiState = ReadonlyMap<string, A2uiSurfaceState>;
+export interface A2uiOperationResult {
   readonly state: A2uiState;
   readonly warnings: string[];
 }
 //#endregion
-export { A2UI_SURFACE_ID, A2uiCreateSurfaceOperation, A2uiCreateSurfaceV09Payload, A2uiCreateSurfaceV10Payload, A2uiDeleteSurfaceOperation, A2uiDeleteSurfacePayload, A2uiOperation, A2uiOperationResult, A2uiState, A2uiSurfaceState, A2uiTemplateChildren, A2uiUpdateComponentsOperation, A2uiUpdateComponentsPayload, A2uiUpdateDataModelOperation, A2uiUpdateDataModelPayload, A2uiVersion, ComponentNode };
 //# sourceMappingURL=types.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"types.d.ts","names":[],"sources":["../../src/a2ui/types.ts"],"mappings":";cAAa;KAED;UAEK;WACN;aACE;aACA;;;UAII,sBAAsB;WAC5B;WACA;WACA,+BAA+B;;UAGzB;WACN;WACA;WACA;WACA;;UAGM;WACN;WACA;WACA;WACA,sBAAsB;WACtB;;UAGM;WACN;WACA,qBAAqB;;UAGf;WACN;WACA;WACA;WACA;WACA;;UAGM;WACN;;KAGC;WAEG;WACA,eAAe;;WAGf;WACA,eAAe;;UAGb;WACN,SAAS;WACT,kBAAkB;;UAGZ;WACN,SAAS;WACT,iBAAiB;;UAGX;WACN,SAAS;WACT,eAAe;;KAGd,gBACR,6BACA,gCACA,+BACA;KAEQ;EACV,YAAY,YAAY;EACxB;;KAGU,YAAY,oBAAoB;UAE3B;WACN,OAAO;WACP"}
+{"version":3,"file":"types.d.ts","names":[],"sources":["../../src/a2ui/types.ts"],"mappings":";qBAAa;YAED;iBAEK;WACN;aACE;aACA;;;iBAII,sBAAsB;WAC5B;WACA;WACA,+BAA+B;;iBAGzB;WACN;WACA;WACA;WACA;;iBAGM;WACN;WACA;WACA;WACA,sBAAsB;WACtB;;iBAGM;WACN;WACA,qBAAqB;;iBAGf;WACN;WACA;WACA;WACA;WACA;;iBAGM;WACN;;YAGC;WAEG;WACA,eAAe;;WAGf;WACA,eAAe;;iBAGb;WACN,SAAS;WACT,kBAAkB;;iBAGZ;WACN,SAAS;WACT,iBAAiB;;iBAGX;WACN,SAAS;WACT,eAAe;;YAGd,gBACR,6BACA,gCACA,+BACA;YAEQ;EACV,YAAY,YAAY;EACxB;;YAGU,YAAY,oBAAoB;iBAE3B;WACN,OAAO;WACP"}

package/dist/actionRegistry.d.ts

@@ -1,7 +1,7 @@
 import { Action } from "./ir.js";
 //#region src/actionRegistry.d.ts
 /** Context handed to an {@link ActionHandler} when an `$action` fires. */
-type ActionDispatchContext = {
+export type ActionDispatchContext = {
   /**
    * The action payload. For fire-and-forget actions this is the `$action` as the model emitted it. For an interactive component the user's runtime input is merged in under the reserved `$input` key: a single value for a standalone control's dispatch, or an object keyed by each field's `name` for a `Form` or a `Card` with `asForm` set. A model-supplied `value` field is never clobbered.
    */
@@ -14,19 +14,18 @@ type ActionDispatchContext = {
  * 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>;
+export type ActionHandler = (ctx: ActionDispatchContext) => unknown | Promise<unknown>;
 /**
  * The host-provided map from `$action.type` to {@link ActionHandler}. This is the single dispatch target for rendered generative UI: every interactive component fires its `$action` here through the injected `$dispatch` (a submit Button defers to its ancestor form's dispatch instead). The payload's `$input` takes one of two shapes: a single value for a standalone control's dispatch (`Select`, `Input`, `DatePicker`, `Checkbox`, `RadioGroup`), or an object keyed by field `name` for a `Form` or a `Card` with `asForm` set. Construct it with {@link createActionRegistry} and pass it to `JSONGenerativeUI`.
  */
-type ActionRegistry = {
+export type ActionRegistry = {
   dispatch(action: Action): unknown;
   has(type: string): boolean;
 };
-declare function createActionRegistry(handlers: Readonly<Record<string, ActionHandler>>): ActionRegistry;
+export 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;
+export declare const emptyActionRegistry: ActionRegistry;
 //#endregion
-export { ActionDispatchContext, ActionHandler, ActionRegistry, createActionRegistry, emptyActionRegistry };
 //# sourceMappingURL=actionRegistry.d.ts.map

package/dist/actionRegistry.d.ts.map

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

package/dist/buildPresentParameters.d.ts

@@ -1,5 +1,5 @@
-import { JSONSchema7 } from "./node_modules/.pnpm/@types_json-schema@7.0.15/node_modules/@types/json-schema/index.js";
 import { GenerativeUILibrary } from "./types.js";
+import { JSONSchema7 } from "json-schema";
 //#region src/buildPresentParameters.d.ts
 /**
  * Builds the JSON schema for the `present` tool from a {@link GenerativeUILibrary}.
@@ -18,7 +18,6 @@ import { GenerativeUILibrary } from "./types.js";
  * renderer validates nothing here — an unknown `$type` or stray prop is handled
  * at render time — so a looser schema only costs the model a hint, not safety.
  */
-declare function buildPresentParameters(library: GenerativeUILibrary): JSONSchema7;
+export declare function buildPresentParameters(library: GenerativeUILibrary): JSONSchema7;
 //#endregion
-export { buildPresentParameters };
 //# sourceMappingURL=buildPresentParameters.d.ts.map

package/dist/buildPresentParameters.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"buildPresentParameters.d.ts","names":[],"sources":["../src/buildPresentParameters.ts"],"mappings":";;;;;;;;;;;;;;;;;;;;iBAsBgB,uBACd,SAAS,sBACR"}
+{"version":3,"file":"buildPresentParameters.d.ts","names":[],"sources":["../src/buildPresentParameters.ts"],"mappings":";;;;;;;;;;;;;;;;;;;;wBAsBgB,uBACd,SAAS,sBACR"}