@assistant-ui/react-generative-ui 0.0.18 → 0.0.20

package/dist/buildPresentParameters.d.ts

@@ -1,6 +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";
-//#region src/buildPresentParameters.d.ts
+import type { JSONSchema7 } from "json-schema";
+import type { GenerativeUILibrary } from "./types.js";
 /**
  * Builds the JSON schema for the `present` tool from a {@link GenerativeUILibrary}.
  *
@@ -18,7 +17,5 @@ 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;
-//#endregion
-export { buildPresentParameters };
+export declare function buildPresentParameters(library: GenerativeUILibrary): JSONSchema7;
 //# 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","sourceRoot":"","sources":["../src/buildPresentParameters.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,WAAW,EAAyB,MAAM,aAAa,CAAC;AAEtE,OAAO,KAAK,EAAE,mBAAmB,EAAE,mBAAgB;AAGnD;;;;;;;;;;;;;;;;GAgBG;AACH,wBAAgB,sBAAsB,CACpC,OAAO,EAAE,mBAAmB,GAC3B,WAAW,CA+Fb"}

package/dist/buildPresentParameters.js

@@ -1,4 +1,5 @@
 import { TYPE_KEY } from "./constants.js";
+import { scopeSchema } from "./scopeSchema.js";
 import { toJSONSchema } from "assistant-stream";
 //#region src/buildPresentParameters.ts
 /**
@@ -22,15 +23,25 @@ function buildPresentParameters(library) {
 	const names = Object.keys(library);
 	const props = /* @__PURE__ */ new Map();
 	const propOwners = /* @__PURE__ */ new Map();
-	for (const name of names) {
-		const propsSchema = toJSONSchema(library[name].properties);
+	const componentSchemas = {};
+	for (const [index, name] of names.entries()) {
+		const definition = `component${index}`;
+		const { schema: propsSchema, referenced } = scopeSchema(toJSONSchema(library[name].properties), `#/$defs/${definition}`);
 		if (propsSchema.type !== "object") throw new Error(`[@assistant-ui/react-generative-ui] Component "${name}": \`properties\` must be an object schema (e.g. \`z.object({ ... })\`).`);
+		let merged = false;
 		for (const [key, schema] of Object.entries(propsSchema.properties ?? {})) {
 			if (key.startsWith("$") || key === "children") continue;
 			if (key === "__proto__") continue;
-			if (!props.has(key)) props.set(key, schema);
+			if (!props.has(key)) {
+				props.set(key, schema);
+				merged = true;
+			}
 			propOwners.set(key, [...propOwners.get(key) ?? [], name]);
 		}
+		if (referenced && merged) {
+			const { $schema: _, $id: _id, ...embedded } = propsSchema;
+			componentSchemas[definition] = embedded;
+		}
 	}
 	if (process.env["NODE_ENV"] !== "production") for (const [key, owners] of propOwners) {
 		if (owners.length < 2) continue;
@@ -69,7 +80,8 @@ function buildPresentParameters(library) {
 		...node,
 		$defs: {
 			node,
-			children
+			children,
+			...componentSchemas
 		}
 	};
 }

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, $key?, ...props }` where `$type` selects\n * a component, the optional `$key` pins a stable identity for list items that\n * may reorder, and the rest are its props. The schema is a flat object: `$type`\n * is an enum of the component names, every component's props are merged into\n * one optional bag, and `children` recurses via `$defs` so the tree can nest.\n *\n * It is intentionally flat rather than a per-`$type` discriminated union. Tool /\n * function-call schemas (OpenAI and others) require the top-level parameters to\n * be a plain object and reject a top-level `oneOf`/`anyOf`/`enum`. So props can't\n * be refined per `$type` at the root; the model is guided instead by `$type`'s\n * description (which lists each component) and each prop's own description. The\n * renderer validates nothing here — an unknown `$type` or stray prop is handled\n * at render time — so a looser schema only costs the model a hint, not safety.\n */\nexport function buildPresentParameters(\n  library: GenerativeUILibrary,\n): JSONSchema7 {\n  const names = Object.keys(library);\n\n  // Merge every component's props into one optional bag. `$`-prefixed keys and\n  // `children` are framework-reserved (see ir.ts), so drop any author-declared\n  // copies. On a name clash the first component's schema wins — props are an\n  // advisory hint here, not a strict per-component contract.\n  const props = new Map<string, JSONSchema7Definition>();\n  const propOwners = new Map<string, string[]>();\n  for (const name of names) {\n    const propsSchema = toJSONSchema(library[name]!.properties);\n    if (propsSchema.type !== \"object\") {\n      throw new Error(\n        `[@assistant-ui/react-generative-ui] Component \"${name}\": ` +\n          \"`properties` must be an object schema (e.g. `z.object({ ... })`).\",\n      );\n    }\n    for (const [key, schema] of Object.entries(propsSchema.properties ?? {})) {\n      if (key.startsWith(\"$\") || key === \"children\") continue;\n      // secure-json-parse rejects the whole tool-argument payload on this key,\n      // so advertising it would cost the model the node rather than one prop.\n      if (key === \"__proto__\") continue;\n      if (!props.has(key)) {\n        props.set(key, schema);\n      }\n      propOwners.set(key, [...(propOwners.get(key) ?? []), name]);\n    }\n  }\n\n  if (process.env[\"NODE_ENV\"] !== \"production\") {\n    for (const [key, owners] of propOwners) {\n      if (owners.length < 2) continue;\n      // eslint-disable-next-line no-console\n      console.warn(\n        `[@assistant-ui/react-generative-ui] Prop \"${key}\" is declared by ` +\n          `${formatComponentList(owners)}; keeping \"${owners[0]}\"'s schema. ` +\n          \"Rename or align the prop type to avoid an ambiguous schema.\",\n      );\n    }\n  }\n\n  // Carry each component's description on the `$type` enum, since there are no\n  // per-branch schemas to hang them on anymore.\n  const typeDescription =\n    names.length > 0\n      ? `The component to render. ${names\n          .map((name) => `\"${name}\": ${library[name]!.description}`)\n          .join(\"; \")}`\n      : \"The component to render.\";\n\n  const node: JSONSchema7 = {\n    type: \"object\",\n    properties: {\n      [TYPE_KEY]: { type: \"string\", enum: names, description: typeDescription },\n      $key: {\n        description:\n          \"Stable identity for this UI node. Use it for list items that may reorder.\",\n        anyOf: [{ type: \"string\" }, { type: \"number\" }],\n      },\n      ...Object.fromEntries(props),\n      children: { $ref: \"#/$defs/children\" },\n    },\n    required: [TYPE_KEY],\n  };\n\n  const children: JSONSchema7 = {\n    description: \"Nested generative UI rendered inside this component.\",\n    anyOf: [\n      { type: \"string\" },\n      { $ref: \"#/$defs/node\" },\n      {\n        type: \"array\",\n        items: { anyOf: [{ type: \"string\" }, { $ref: \"#/$defs/node\" }] },\n      },\n    ],\n  };\n\n  return {\n    ...node,\n    $defs: { node, children },\n  };\n}\n\nfunction formatComponentList(names: string[]) {\n  if (names.length <= 2) return names.map((name) => `\"${name}\"`).join(\" and \");\n\n  return `${names\n    .slice(0, -1)\n    .map((name) => `\"${name}\"`)\n    .join(\", \")}, and \"${names[names.length - 1]}\"`;\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;;AAsBA,SAAgB,uBACd,SACa;CACb,MAAM,QAAQ,OAAO,KAAK,OAAO;CAMjC,MAAM,wBAAQ,IAAI,IAAmC;CACrD,MAAM,6BAAa,IAAI,IAAsB;CAC7C,KAAK,MAAM,QAAQ,OAAO;EACxB,MAAM,cAAc,aAAa,QAAQ,KAAK,CAAE,UAAU;EAC1D,IAAI,YAAY,SAAS,UACvB,MAAM,IAAI,MACR,kDAAkD,KAAK,yEAEzD;EAEF,KAAK,MAAM,CAAC,KAAK,WAAW,OAAO,QAAQ,YAAY,cAAc,CAAC,CAAC,GAAG;GACxE,IAAI,IAAI,WAAW,GAAG,KAAK,QAAQ,YAAY;GAG/C,IAAI,QAAQ,aAAa;GACzB,IAAI,CAAC,MAAM,IAAI,GAAG,GAChB,MAAM,IAAI,KAAK,MAAM;GAEvB,WAAW,IAAI,KAAK,CAAC,GAAI,WAAW,IAAI,GAAG,KAAK,CAAC,GAAI,IAAI,CAAC;EAC5D;CACF;CAEA,IAAI,QAAQ,IAAI,gBAAgB,cAC9B,KAAK,MAAM,CAAC,KAAK,WAAW,YAAY;EACtC,IAAI,OAAO,SAAS,GAAG;EAEvB,QAAQ,KACN,6CAA6C,IAAI,mBAC5C,oBAAoB,MAAM,EAAE,aAAa,OAAO,GAAG,wEAE1D;CACF;CAKF,MAAM,kBACJ,MAAM,SAAS,IACX,4BAA4B,MACzB,KAAK,SAAS,IAAI,KAAK,KAAK,QAAQ,KAAK,CAAE,aAAa,CAAC,CACzD,KAAK,IAAI,MACZ;CAEN,MAAM,OAAoB;EACxB,MAAM;EACN,YAAY;IACT,WAAW;IAAE,MAAM;IAAU,MAAM;IAAO,aAAa;GAAgB;GACxE,MAAM;IACJ,aACE;IACF,OAAO,CAAC,EAAE,MAAM,SAAS,GAAG,EAAE,MAAM,SAAS,CAAC;GAChD;GACA,GAAG,OAAO,YAAY,KAAK;GAC3B,UAAU,EAAE,MAAM,mBAAmB;EACvC;EACA,UAAU,CAAC,QAAQ;CACrB;CAEA,MAAM,WAAwB;EAC5B,aAAa;EACb,OAAO;GACL,EAAE,MAAM,SAAS;GACjB,EAAE,MAAM,eAAe;GACvB;IACE,MAAM;IACN,OAAO,EAAE,OAAO,CAAC,EAAE,MAAM,SAAS,GAAG,EAAE,MAAM,eAAe,CAAC,EAAE;GACjE;EACF;CACF;CAEA,OAAO;EACL,GAAG;EACH,OAAO;GAAE;GAAM;EAAS;CAC1B;AACF;AAEA,SAAS,oBAAoB,OAAiB;CAC5C,IAAI,MAAM,UAAU,GAAG,OAAO,MAAM,KAAK,SAAS,IAAI,KAAK,EAAE,CAAC,CAAC,KAAK,OAAO;CAE3E,OAAO,GAAG,MACP,MAAM,GAAG,EAAE,CAAC,CACZ,KAAK,SAAS,IAAI,KAAK,EAAE,CAAC,CAC1B,KAAK,IAAI,EAAE,SAAS,MAAM,MAAM,SAAS,GAAG;AACjD"}
+{"version":3,"file":"buildPresentParameters.js","names":[],"sources":["../src/buildPresentParameters.ts"],"sourcesContent":["import { toJSONSchema } from \"assistant-stream\";\nimport type { JSONSchema7, JSONSchema7Definition } from \"json-schema\";\nimport { TYPE_KEY } from \"./constants\";\nimport type { GenerativeUILibrary } from \"./types\";\nimport { scopeSchema } from \"./scopeSchema\";\n\n/**\n * Builds the JSON schema for the `present` tool from a {@link GenerativeUILibrary}.\n *\n * The model produces a node `{ $type, $key?, ...props }` where `$type` selects\n * a component, the optional `$key` pins a stable identity for list items that\n * may reorder, and the rest are its props. The schema is a flat object: `$type`\n * is an enum of the component names, every component's props are merged into\n * one optional bag, and `children` recurses via `$defs` so the tree can nest.\n *\n * It is intentionally flat rather than a per-`$type` discriminated union. Tool /\n * function-call schemas (OpenAI and others) require the top-level parameters to\n * be a plain object and reject a top-level `oneOf`/`anyOf`/`enum`. So props can't\n * be refined per `$type` at the root; the model is guided instead by `$type`'s\n * description (which lists each component) and each prop's own description. The\n * renderer validates nothing here — an unknown `$type` or stray prop is handled\n * at render time — so a looser schema only costs the model a hint, not safety.\n */\nexport function buildPresentParameters(\n  library: GenerativeUILibrary,\n): JSONSchema7 {\n  const names = Object.keys(library);\n\n  // Merge every component's props into one optional bag. `$`-prefixed keys and\n  // `children` are framework-reserved (see ir.ts), so drop any author-declared\n  // copies. On a name clash the first component's schema wins — props are an\n  // advisory hint here, not a strict per-component contract.\n  const props = new Map<string, JSONSchema7Definition>();\n  const propOwners = new Map<string, string[]>();\n  const componentSchemas: Record<string, JSONSchema7> = {};\n  for (const [index, name] of names.entries()) {\n    const definition = `component${index}`;\n    const { schema: propsSchema, referenced } = scopeSchema(\n      toJSONSchema(library[name]!.properties),\n      `#/$defs/${definition}`,\n    );\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    let merged = false;\n    for (const [key, schema] of Object.entries(propsSchema.properties ?? {})) {\n      if (key.startsWith(\"$\") || key === \"children\") continue;\n      // secure-json-parse rejects the whole tool-argument payload on this key,\n      // so advertising it would cost the model the node rather than one prop.\n      if (key === \"__proto__\") continue;\n      if (!props.has(key)) {\n        props.set(key, schema);\n        merged = true;\n      }\n      propOwners.set(key, [...(propOwners.get(key) ?? []), name]);\n    }\n    if (referenced && merged) {\n      // `$schema` is only valid at a schema-resource root, and an embedded\n      // `$id` would both collide across components and re-base the pointers\n      // scopeSchema just rewrote to be document-root relative.\n      const { $schema: _, $id: _id, ...embedded } = propsSchema;\n      componentSchemas[definition] = embedded;\n    }\n  }\n\n  if (process.env[\"NODE_ENV\"] !== \"production\") {\n    for (const [key, owners] of propOwners) {\n      if (owners.length < 2) continue;\n      // eslint-disable-next-line no-console\n      console.warn(\n        `[@assistant-ui/react-generative-ui] Prop \"${key}\" is declared by ` +\n          `${formatComponentList(owners)}; keeping \"${owners[0]}\"'s schema. ` +\n          \"Rename or align the prop type to avoid an ambiguous schema.\",\n      );\n    }\n  }\n\n  // Carry each component's description on the `$type` enum, since there are no\n  // per-branch schemas to hang them on anymore.\n  const typeDescription =\n    names.length > 0\n      ? `The component to render. ${names\n          .map((name) => `\"${name}\": ${library[name]!.description}`)\n          .join(\"; \")}`\n      : \"The component to render.\";\n\n  const node: JSONSchema7 = {\n    type: \"object\",\n    properties: {\n      [TYPE_KEY]: { type: \"string\", enum: names, description: typeDescription },\n      $key: {\n        description:\n          \"Stable identity for this UI node. Use it for list items that may reorder.\",\n        anyOf: [{ type: \"string\" }, { type: \"number\" }],\n      },\n      ...Object.fromEntries(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, ...componentSchemas },\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":";;;;;;;;;;;;;;;;;;;;;AAuBA,SAAgB,uBACd,SACa;CACb,MAAM,QAAQ,OAAO,KAAK,OAAO;CAMjC,MAAM,wBAAQ,IAAI,IAAmC;CACrD,MAAM,6BAAa,IAAI,IAAsB;CAC7C,MAAM,mBAAgD,CAAC;CACvD,KAAK,MAAM,CAAC,OAAO,SAAS,MAAM,QAAQ,GAAG;EAC3C,MAAM,aAAa,YAAY;EAC/B,MAAM,EAAE,QAAQ,aAAa,eAAe,YAC1C,aAAa,QAAQ,KAAK,CAAE,UAAU,GACtC,WAAW,YACb;EACA,IAAI,YAAY,SAAS,UACvB,MAAM,IAAI,MACR,kDAAkD,KAAK,yEAEzD;EAEF,IAAI,SAAS;EACb,KAAK,MAAM,CAAC,KAAK,WAAW,OAAO,QAAQ,YAAY,cAAc,CAAC,CAAC,GAAG;GACxE,IAAI,IAAI,WAAW,GAAG,KAAK,QAAQ,YAAY;GAG/C,IAAI,QAAQ,aAAa;GACzB,IAAI,CAAC,MAAM,IAAI,GAAG,GAAG;IACnB,MAAM,IAAI,KAAK,MAAM;IACrB,SAAS;GACX;GACA,WAAW,IAAI,KAAK,CAAC,GAAI,WAAW,IAAI,GAAG,KAAK,CAAC,GAAI,IAAI,CAAC;EAC5D;EACA,IAAI,cAAc,QAAQ;GAIxB,MAAM,EAAE,SAAS,GAAG,KAAK,KAAK,GAAG,aAAa;GAC9C,iBAAiB,cAAc;EACjC;CACF;CAEA,IAAI,QAAQ,IAAI,gBAAgB,cAC9B,KAAK,MAAM,CAAC,KAAK,WAAW,YAAY;EACtC,IAAI,OAAO,SAAS,GAAG;EAEvB,QAAQ,KACN,6CAA6C,IAAI,mBAC5C,oBAAoB,MAAM,EAAE,aAAa,OAAO,GAAG,wEAE1D;CACF;CAKF,MAAM,kBACJ,MAAM,SAAS,IACX,4BAA4B,MACzB,KAAK,SAAS,IAAI,KAAK,KAAK,QAAQ,KAAK,CAAE,aAAa,CAAC,CACzD,KAAK,IAAI,MACZ;CAEN,MAAM,OAAoB;EACxB,MAAM;EACN,YAAY;IACT,WAAW;IAAE,MAAM;IAAU,MAAM;IAAO,aAAa;GAAgB;GACxE,MAAM;IACJ,aACE;IACF,OAAO,CAAC,EAAE,MAAM,SAAS,GAAG,EAAE,MAAM,SAAS,CAAC;GAChD;GACA,GAAG,OAAO,YAAY,KAAK;GAC3B,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;GAAU,GAAG;EAAiB;CAC/C;AACF;AAEA,SAAS,oBAAoB,OAAiB;CAC5C,IAAI,MAAM,UAAU,GAAG,OAAO,MAAM,KAAK,SAAS,IAAI,KAAK,EAAE,CAAC,CAAC,KAAK,OAAO;CAE3E,OAAO,GAAG,MACP,MAAM,GAAG,EAAE,CAAC,CACZ,KAAK,SAAS,IAAI,KAAK,EAAE,CAAC,CAC1B,KAAK,IAAI,EAAE,SAAS,MAAM,MAAM,SAAS,GAAG;AACjD"}

package/dist/constants.d.ts

@@ -1,4 +1,3 @@
-//#region src/constants.d.ts
 /**
  * The wire key naming the component to render.
  *
@@ -8,7 +7,6 @@
  * colliding with the discriminator. It mirrors the `$type` discriminator
  * convention used by JSON polymorphism elsewhere.
  */
-declare const TYPE_KEY = "$type";
-//#endregion
-export { TYPE_KEY };
+export declare const TYPE_KEY = "$type";
+export declare const GENERATED_NAME_ATTR = "data-aui-generated-name";
 //# sourceMappingURL=constants.d.ts.map

package/dist/constants.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"constants.d.ts","names":[],"sources":["../src/constants.ts"],"mappings":";;;;;;;;;;cASa"}
+{"version":3,"file":"constants.d.ts","sourceRoot":"","sources":["../src/constants.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AACH,eAAO,MAAM,QAAQ,UAAU,CAAC;AAEhC,eAAO,MAAM,mBAAmB,4BAA4B,CAAC"}

package/dist/constants.js

@@ -9,7 +9,8 @@
 * convention used by JSON polymorphism elsewhere.
 */
 const TYPE_KEY = "$type";
+const GENERATED_NAME_ATTR = "data-aui-generated-name";
 //#endregion
-export { TYPE_KEY };
+export { GENERATED_NAME_ATTR, TYPE_KEY };
 
 //# sourceMappingURL=constants.js.map

package/dist/constants.js.map

@@ -1 +1 @@
-{"version":3,"file":"constants.js","names":[],"sources":["../src/constants.ts"],"sourcesContent":["/**\n * The wire key naming the component to render.\n *\n * The model emits nodes as flat objects `{ [TYPE_KEY]: name, ...props }`. We\n * use `$type` rather than `type` so a component's own `type` prop (e.g. a\n * button's `type=\"submit\"`) flows through as an ordinary prop without\n * colliding with the discriminator. It mirrors the `$type` discriminator\n * convention used by JSON polymorphism elsewhere.\n */\nexport const TYPE_KEY = \"$type\";\n"],"mappings":";;;;;;;;;;AASA,MAAa,WAAW"}
+{"version":3,"file":"constants.js","names":[],"sources":["../src/constants.ts"],"sourcesContent":["/**\n * The wire key naming the component to render.\n *\n * The model emits nodes as flat objects `{ [TYPE_KEY]: name, ...props }`. We\n * use `$type` rather than `type` so a component's own `type` prop (e.g. a\n * button's `type=\"submit\"`) flows through as an ordinary prop without\n * colliding with the discriminator. It mirrors the `$type` discriminator\n * convention used by JSON polymorphism elsewhere.\n */\nexport const TYPE_KEY = \"$type\";\n\nexport const GENERATED_NAME_ATTR = \"data-aui-generated-name\";\n"],"mappings":";;;;;;;;;;AASA,MAAa,WAAW;AAExB,MAAa,sBAAsB"}

package/dist/convert/boundSpec.d.ts

@@ -1,13 +1,12 @@
-//#region src/convert/boundSpec.d.ts
 /** The maximum traversal depth, counted in visited values, not tree levels. */
-declare const MAX_TRAVERSAL_DEPTH = 64;
+export declare const MAX_TRAVERSAL_DEPTH = 64;
 /**
  * The element-nesting ceiling a caller observes. `boundNode` visits an element
  * and its `children` array separately, so one level of nesting spends two of
  * {@link MAX_TRAVERSAL_DEPTH}; it runs before the conversion walk and is never
  * the looser of the two. A root array costs one more level than a root object.
  */
-declare const MAX_ELEMENT_DEPTH: number;
+export declare const MAX_ELEMENT_DEPTH: number;
 /**
  * The maximum number of entries kept at any single level (root, or a
  * `children` array at any depth) of the raw spec, before it ever reaches
@@ -15,7 +14,7 @@ declare const MAX_ELEMENT_DEPTH: number;
  * can never be made to walk further than this regardless of what the array
  * claims about itself.
  */
-declare const CHILDREN_CAP = 200;
+export declare const CHILDREN_CAP = 200;
 /**
  * The total number of nodes {@link boundSpec} will visit across one walk,
  * regardless of how many times a shared reference recurs. Bounds the
@@ -23,10 +22,10 @@ declare const CHILDREN_CAP = 200;
  * otherwise force even though each individual array stays within
  * {@link CHILDREN_CAP}.
  */
-declare const NODE_BUDGET = 5000;
-type ClampReason = "children" | "budget" | "cycle" | "depth";
+export declare const NODE_BUDGET = 5000;
+export type ClampReason = "children" | "budget" | "cycle" | "depth";
 /** Renders the warning detail a protocol reports for one {@link ClampReason}. */
-declare function clampReasonDetail(reason: ClampReason): string;
+export declare function clampReasonDetail(reason: ClampReason): string;
 /**
  * Produces a bounded plain copy of a raw generative-ui spec before it
  * reaches `normalizeSpec`, whose own traversal of the root array or any
@@ -45,7 +44,5 @@ declare function clampReasonDetail(reason: ClampReason): string;
  * {@link NODE_BUDGET} nodes, so shared references cannot multiply work
  * exponentially, and a node that is its own ancestor is cut to `null`.
  */
-declare function boundSpec(spec: unknown, onClamp: (reason: ClampReason) => void): unknown;
-//#endregion
-export { CHILDREN_CAP, ClampReason, MAX_ELEMENT_DEPTH, MAX_TRAVERSAL_DEPTH, NODE_BUDGET, boundSpec, clampReasonDetail };
+export declare function boundSpec(spec: unknown, onClamp: (reason: ClampReason) => void): unknown;
 //# sourceMappingURL=boundSpec.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"boundSpec.d.ts","names":[],"sources":["../../src/convert/boundSpec.ts"],"mappings":";;cAGa;;;;;;;cAQA;;;;;;;;cASA;;;;;;;;cASA;KAED;;iBAGI,kBAAkB,QAAQ;;;;;;;;;;;;;;;;;;;iBAwF1B,UACd,eACA,UAAU,QAAQ"}
+{"version":3,"file":"boundSpec.d.ts","sourceRoot":"","sources":["../../src/convert/boundSpec.ts"],"names":[],"mappings":"AAEA,+EAA+E;AAC/E,eAAO,MAAM,mBAAmB,KAAK,CAAC;AAEtC;;;;;GAKG;AACH,eAAO,MAAM,iBAAiB,QAA0B,CAAC;AAEzD;;;;;;GAMG;AACH,eAAO,MAAM,YAAY,MAAM,CAAC;AAEhC;;;;;;GAMG;AACH,eAAO,MAAM,WAAW,OAAO,CAAC;AAEhC,MAAM,MAAM,WAAW,GAAG,UAAU,GAAG,QAAQ,GAAG,OAAO,GAAG,OAAO,CAAC;AAEpE,iFAAiF;AACjF,wBAAgB,iBAAiB,CAAC,MAAM,EAAE,WAAW,GAAG,MAAM,CAS7D;AA6DD;;;;;;;;;;;;;;;;;GAiBG;AACH,wBAAgB,SAAS,CACvB,IAAI,EAAE,OAAO,EACb,OAAO,EAAE,CAAC,MAAM,EAAE,WAAW,KAAK,IAAI,GACrC,OAAO,CAQT"}

package/dist/convert/copyBounded.d.ts

@@ -1,4 +1,3 @@
-//#region src/convert/copyBounded.d.ts
 /**
  * Copies at most `cap` entries out of `value` by index.
  *
@@ -19,10 +18,8 @@
  * that same normalized figure, so a `length` whose `valueOf` answers differently
  * on a second conversion cannot separate the warning from the bound.
  */
-declare const copyBounded: <T>(value: readonly T[], cap: number) => {
-  readonly items: T[];
-  readonly truncated: boolean;
+export declare const copyBounded: <T>(value: readonly T[], cap: number) => {
+    readonly items: T[];
+    readonly truncated: boolean;
 };
-//#endregion
-export { copyBounded };
 //# sourceMappingURL=copyBounded.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"copyBounded.d.ts","names":[],"sources":["../../src/convert/copyBounded.ts"],"mappings":";;;;;;;;;;;;;;;;;;;;;cAoBa,cAAe,GAC1B,gBAAgB,KAChB;WACY,OAAO;WAAc"}
+{"version":3,"file":"copyBounded.d.ts","sourceRoot":"","sources":["../../src/convert/copyBounded.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;GAmBG;AACH,eAAO,MAAM,WAAW,GAAI,CAAC,EAC3B,OAAO,SAAS,CAAC,EAAE,EACnB,KAAK,MAAM,KACV;IAAE,QAAQ,CAAC,KAAK,EAAE,CAAC,EAAE,CAAC;IAAC,QAAQ,CAAC,SAAS,EAAE,OAAO,CAAA;CAcpD,CAAC"}

package/dist/convert/isElement.d.ts

@@ -1,6 +1,3 @@
-import { NormalizedUIElement, NormalizedUINode } from "../ir.js";
-//#region src/convert/isElement.d.ts
-declare const isElement: (node: NormalizedUINode) => node is NormalizedUIElement;
-//#endregion
-export { isElement };
+import type { NormalizedUIElement, NormalizedUINode } from "../ir.js";
+export declare const isElement: (node: NormalizedUINode) => node is NormalizedUIElement;
 //# sourceMappingURL=isElement.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"isElement.d.ts","names":[],"sources":["../../src/convert/isElement.ts"],"mappings":";;cAEa,YACX,MAAM,qBACL,QAAQ"}
+{"version":3,"file":"isElement.d.ts","sourceRoot":"","sources":["../../src/convert/isElement.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,mBAAmB,EAAE,gBAAgB,EAAE,iBAAc;AAEnE,eAAO,MAAM,SAAS,GACpB,MAAM,gBAAgB,KACrB,IAAI,IAAI,mBACwD,CAAC"}

package/dist/convert/takeRun.d.ts

@@ -1,9 +1,6 @@
-import { NormalizedUIElement, NormalizedUINode } from "../ir.js";
-//#region src/convert/takeRun.d.ts
-declare function takeRun(nodes: readonly (NormalizedUINode | undefined)[], index: number, matches: (element: NormalizedUIElement) => boolean): {
-  run: NormalizedUIElement[];
-  next: number;
+import type { NormalizedUIElement, NormalizedUINode } from "../ir.js";
+export declare function takeRun(nodes: readonly (NormalizedUINode | undefined)[], index: number, matches: (element: NormalizedUIElement) => boolean): {
+    run: NormalizedUIElement[];
+    next: number;
 };
-//#endregion
-export { takeRun };
 //# sourceMappingURL=takeRun.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"takeRun.d.ts","names":[],"sources":["../../src/convert/takeRun.ts"],"mappings":";;iBAGgB,QACd,iBAAiB,iCACjB,eACA,UAAU,SAAS;EAChB,KAAK;EAAuB"}
+{"version":3,"file":"takeRun.d.ts","sourceRoot":"","sources":["../../src/convert/takeRun.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,mBAAmB,EAAE,gBAAgB,EAAE,iBAAc;AAGnE,wBAAgB,OAAO,CACrB,KAAK,EAAE,SAAS,CAAC,gBAAgB,GAAG,SAAS,CAAC,EAAE,EAChD,KAAK,EAAE,MAAM,EACb,OAAO,EAAE,CAAC,OAAO,EAAE,mBAAmB,KAAK,OAAO,GACjD;IAAE,GAAG,EAAE,mBAAmB,EAAE,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE,CAW9C"}

package/dist/defineGenerativeComponents.d.ts

@@ -1,5 +1,4 @@
-import { GenerativeUILibrary } from "./types.js";
-//#region src/defineGenerativeComponents.d.ts
+import type { GenerativeUILibrary } from "./types.js";
 /**
  * Authoring helper for a `"use generative"` generative-UI library — the set of
  * components the model may render. Each component colocates its `properties`
@@ -26,7 +25,5 @@ import { GenerativeUILibrary } from "./types.js";
  * is missing, or it was used outside a `"use generative"` file), so it throws
  * rather than shipping client `render` code to the server.
  */
-declare function defineGenerativeComponents(_library: GenerativeUILibrary): GenerativeUILibrary;
-//#endregion
-export { defineGenerativeComponents };
+export declare function defineGenerativeComponents(_library: GenerativeUILibrary): GenerativeUILibrary;
 //# sourceMappingURL=defineGenerativeComponents.d.ts.map

package/dist/defineGenerativeComponents.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"defineGenerativeComponents.d.ts","names":[],"sources":["../src/defineGenerativeComponents.ts"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;iBA4BgB,2BACd,UAAU,sBACT"}
+{"version":3,"file":"defineGenerativeComponents.d.ts","sourceRoot":"","sources":["../src/defineGenerativeComponents.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,mBAAmB,EAAE,mBAAgB;AAEnD;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;AACH,wBAAgB,0BAA0B,CACxC,QAAQ,EAAE,mBAAmB,GAC5B,mBAAmB,CAOrB"}

package/dist/generativeUIToJSX.d.ts

@@ -1,10 +1,9 @@
-//#region src/generativeUIToJSX.d.ts
 /** Options for {@link generativeUIToJSX}. */
-interface GenerativeUIToJSXOptions {
-  /** Escape string children so the output is safe to paste back into a JSX file. Defaults to `false`. */
-  escape?: boolean;
-  /** Pretty-print nested element trees with two-space indentation. Defaults to `false`. */
-  pretty?: boolean;
+export interface GenerativeUIToJSXOptions {
+    /** Escape string children so the output is safe to paste back into a JSX file. Defaults to `false`. */
+    escape?: boolean;
+    /** Pretty-print nested element trees with two-space indentation. Defaults to `false`. */
+    pretty?: boolean;
 }
 /**
  * Serializes a generative-UI node to a JSX-like string for display: the "view source" of a model-produced tree. The wire form `{ $type: "Weather", id: "x" }` becomes `<Weather id="x" />`, and nested `children` render between tags: `<Card title="Hi"><Text>hello</Text></Card>`. A model-provided `$key` becomes the JSX `key` attribute.
@@ -15,7 +14,5 @@ interface GenerativeUIToJSXOptions {
  *
  * Pass `{ pretty: true }` to pretty-print nested element trees with two-space indentation, while pure text children stay on one line.
  */
-declare function generativeUIToJSX(node: unknown, options?: GenerativeUIToJSXOptions): string;
-//#endregion
-export { GenerativeUIToJSXOptions, generativeUIToJSX };
+export declare function generativeUIToJSX(node: unknown, options?: GenerativeUIToJSXOptions): string;
 //# sourceMappingURL=generativeUIToJSX.d.ts.map

package/dist/generativeUIToJSX.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"generativeUIToJSX.d.ts","names":[],"sources":["../src/generativeUIToJSX.ts"],"mappings":";;UAGiB;;EAEf;;EAEA;;;;;;;;;;;iBAYc,kBACd,eACA,UAAU"}
+{"version":3,"file":"generativeUIToJSX.d.ts","sourceRoot":"","sources":["../src/generativeUIToJSX.ts"],"names":[],"mappings":"AAEA,6CAA6C;AAC7C,MAAM,WAAW,wBAAwB;IACvC,uGAAuG;IACvG,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,yFAAyF;IACzF,MAAM,CAAC,EAAE,OAAO,CAAC;CAClB;AAED;;;;;;;;GAQG;AACH,wBAAgB,iBAAiB,CAC/B,IAAI,EAAE,OAAO,EACb,OAAO,CAAC,EAAE,wBAAwB,GACjC,MAAM,CAER"}

package/dist/index.d.ts

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

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,gBAAgB,EAAE,qCAAkC;AAC7D,kCAA+B"}

package/dist/index.server.d.ts

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

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.server.d.ts","sourceRoot":"","sources":["../src/index.server.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,gBAAgB,EAAE,qCAAkC;AAC7D,kCAA+B"}

package/dist/index.shared.d.ts

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

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.shared.d.ts","sourceRoot":"","sources":["../src/index.shared.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,kBAAkB,EAAE,gCAA6B;AAC1D,OAAO,EAAE,iBAAiB,EAAE,+BAA4B;AACxD,YAAY,EAAE,wBAAwB,EAAE,+BAA4B;AACpE,OAAO,EAAE,sBAAsB,EAAE,oCAAiC;AAClE,OAAO,EAAE,0BAA0B,EAAE,wCAAqC;AAC1E,OAAO,EAAE,QAAQ,EAAE,uBAAoB;AACvC,OAAO,EAAE,eAAe,EAAE,aAAa,EAAE,gBAAa;AACtD,OAAO,EACL,UAAU,EACV,iBAAiB,EACjB,OAAO,EACP,MAAM,EACN,MAAM,EACN,SAAS,EACT,aAAa,EACb,WAAW,EACX,UAAU,GACX,gBAAa;AACd,OAAO,EAAE,0BAA0B,EAAE,8BAAqB;AAC1D,OAAO,EAAE,oBAAoB,EAAE,mBAAmB,EAAE,4BAAyB;AAC7E,YAAY,EACV,aAAa,EACb,cAAc,EACd,qBAAqB,GACtB,4BAAyB;AAC1B,YAAY,EACV,uBAAuB,EACvB,WAAW,EACX,kBAAkB,EAClB,cAAc,GACf,qCAAkC;AACnC,YAAY,EACV,mBAAmB,EACnB,qBAAqB,EACrB,mBAAmB,EACnB,iBAAiB,EACjB,gBAAgB,EAChB,kBAAkB,EAClB,yBAAyB,EACzB,kBAAkB,EAClB,oBAAoB,GACrB,mBAAgB;AACjB,YAAY,EACV,MAAM,EACN,SAAS,EACT,UAAU,EACV,mBAAmB,EACnB,MAAM,EACN,MAAM,EACN,gBAAgB,EAChB,mBAAmB,EACnB,QAAQ,EACR,SAAS,EACT,MAAM,EACN,KAAK,EACL,KAAK,EACL,OAAO,EACP,WAAW,EACX,SAAS,EACT,QAAQ,GACT,gBAAa"}

package/dist/ir.d.ts

@@ -1,4 +1,3 @@
-//#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
@@ -15,32 +14,32 @@
  * - `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"];
+export declare const TEXT_SIZES: readonly ["sm", "md", "lg", "xl", "2xl", "3xl"];
+export type TextSize = (typeof TEXT_SIZES)[number];
+export declare const IMAGE_SIZE_TOKENS: readonly ["sm", "md", "lg"];
+export type ImageSize = (typeof IMAGE_SIZE_TOKENS)[number] | number;
+export declare const WEIGHTS: readonly ["normal", "medium", "semibold", "bold"];
+export type Weight = (typeof WEIGHTS)[number];
+export declare const COLORS: readonly ["emphasis", "secondary", "alpha-70", "white", "white-70", "white-50"];
+export type Color = (typeof COLORS)[number];
+export declare const ALIGNS: readonly ["start", "center", "end"];
+export type Align = (typeof ALIGNS)[number];
+export declare const JUSTIFIES: readonly ["start", "center", "end", "between"];
+export type Justify = (typeof JUSTIFIES)[number];
+export declare const BUTTON_STYLES: readonly ["primary", "secondary", "outline", "ghost", "danger"];
+export type ButtonStyle = (typeof BUTTON_STYLES)[number];
+export declare const ALERT_TONES: readonly ["info", "success", "warning", "danger"];
 /** A severity level, from informational to destructive. */
-type AlertTone = (typeof ALERT_TONES)[number];
-declare const ICON_NAMES: readonly ["sun", "moon", "cloud", "rain", "snow", "wind", "play", "pause", "check", "x", "star", "heart", "arrow-right", "arrow-up-right", "chevron-right", "calendar", "clock", "map-pin", "plane", "truck", "credit-card", "user", "search", "bell"];
+export type AlertTone = (typeof ALERT_TONES)[number];
+export declare const ICON_NAMES: readonly ["sun", "moon", "cloud", "rain", "snow", "wind", "play", "pause", "check", "x", "star", "heart", "arrow-right", "arrow-up-right", "chevron-right", "calendar", "clock", "map-pin", "plane", "truck", "credit-card", "user", "search", "bell"];
 /** A name from the built-in icon set; the closed enum lets the model see exactly which icons exist. */
-type IconName = (typeof ICON_NAMES)[number];
+export type IconName = (typeof ICON_NAMES)[number];
 /**
  * Behavior payload carried by an interactive node. `type` is resolved by the host's action registry, not the renderer; keeping behavior as data keeps the tree serializable, so the same node renders on web while converters may bind the type to a native action id on other platforms.
  */
-interface Action {
-  readonly type: string;
-  readonly [payload: string]: unknown;
+export interface Action {
+    readonly type: string;
+    readonly [payload: string]: unknown;
 }
 /**
  * Anything renderable as generative UI, as the model emits it. The renderer
@@ -48,30 +47,30 @@ interface Action {
  * 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[];
+export type UINode = string | number | UIElement | LegacyComponentNode;
+export 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;
+export 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;
+export interface LegacyComponentNode {
+    readonly component: string;
+    readonly props?: Record<string, unknown>;
+    readonly children?: UIChildren;
+    readonly key?: string;
 }
-type UISpec = UINode | readonly UINode[];
+export 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
@@ -80,14 +79,14 @@ type UISpec = UINode | readonly UINode[];
  * `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;
+export 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;
+export 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
@@ -102,14 +101,12 @@ type NormalizedUINode = string | number | readonly NormalizedUINode[] | Normaliz
  * 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;
+export 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[];
+export declare function normalizeSpec(spec: UISpec): {
+    readonly root: NormalizedUINode | readonly NormalizedUINode[];
 };
-//#endregion
-export { ALERT_TONES, ALIGNS, Action, AlertTone, Align, BUTTON_STYLES, ButtonStyle, COLORS, Color, ICON_NAMES, IMAGE_SIZE_TOKENS, IconName, ImageSize, JUSTIFIES, Justify, LegacyComponentNode, NormalizedUIElement, NormalizedUINode, TEXT_SIZES, TextSize, UIChildren, UIElement, UINode, UISpec, WEIGHTS, Weight, normalizeSpec, normalizeUINode };
 //# sourceMappingURL=ir.d.ts.map

package/dist/ir.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"ir.d.ts","names":[],"sources":["../src/ir.ts"],"mappings":";;;;;;;;;;;;;;;;;cAmBa;KACD,mBAAmB;cAElB;KACD,oBAAoB;cAEnB;KACD,iBAAiB;cAEhB;KAQD,gBAAgB;cAEf;KACD,gBAAgB;cAEf;KACD,kBAAkB;cAEjB;KAOD,sBAAsB;cAErB;;KAED,oBAAoB;cAEnB;;KA2BD,mBAAmB;;;;UAKd;WACN;YACC;;;;;;;;KASA,2BAA2B,YAAY;KAEvC,aAAa,kBAAkB;;;;UAK1B;WACN;WACA;WACA,WAAW;WACX,UAAU;YACT;;;;;;;UAQK;WACN;WACA,QAAQ;WACR,WAAW;WACX;;KAGC,SAAS,kBAAkB;;;;;;;;;UAUtB;WACN;WACA,OAAO,SAAS;WAChB,WAAW;WACX;WACA,SAAS;;KAGR,8CAGC,qBACT;;;;;;;;;;;;;;;iBA6CY,gBACd,eACA,6CACA,iBACC;;;;;iBAuEa,cAAc,MAAM;WACzB,MAAM,4BAA4B"}
+{"version":3,"file":"ir.d.ts","sourceRoot":"","sources":["../src/ir.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AAIH,eAAO,MAAM,UAAU,iDAAkD,CAAC;AAC1E,MAAM,MAAM,QAAQ,GAAG,CAAC,OAAO,UAAU,CAAC,CAAC,MAAM,CAAC,CAAC;AAEnD,eAAO,MAAM,iBAAiB,6BAA8B,CAAC;AAC7D,MAAM,MAAM,SAAS,GAAG,CAAC,OAAO,iBAAiB,CAAC,CAAC,MAAM,CAAC,GAAG,MAAM,CAAC;AAEpE,eAAO,MAAM,OAAO,mDAAoD,CAAC;AACzE,MAAM,MAAM,MAAM,GAAG,CAAC,OAAO,OAAO,CAAC,CAAC,MAAM,CAAC,CAAC;AAE9C,eAAO,MAAM,MAAM,iFAOT,CAAC;AACX,MAAM,MAAM,KAAK,GAAG,CAAC,OAAO,MAAM,CAAC,CAAC,MAAM,CAAC,CAAC;AAE5C,eAAO,MAAM,MAAM,qCAAsC,CAAC;AAC1D,MAAM,MAAM,KAAK,GAAG,CAAC,OAAO,MAAM,CAAC,CAAC,MAAM,CAAC,CAAC;AAE5C,eAAO,MAAM,SAAS,gDAAiD,CAAC;AACxE,MAAM,MAAM,OAAO,GAAG,CAAC,OAAO,SAAS,CAAC,CAAC,MAAM,CAAC,CAAC;AAEjD,eAAO,MAAM,aAAa,iEAMhB,CAAC;AACX,MAAM,MAAM,WAAW,GAAG,CAAC,OAAO,aAAa,CAAC,CAAC,MAAM,CAAC,CAAC;AAEzD,eAAO,MAAM,WAAW,mDAAoD,CAAC;AAC7E,2DAA2D;AAC3D,MAAM,MAAM,SAAS,GAAG,CAAC,OAAO,WAAW,CAAC,CAAC,MAAM,CAAC,CAAC;AAErD,eAAO,MAAM,UAAU,wPAyBb,CAAC;AACX,uGAAuG;AACvG,MAAM,MAAM,QAAQ,GAAG,CAAC,OAAO,UAAU,CAAC,CAAC,MAAM,CAAC,CAAC;AAEnD;;GAEG;AACH,MAAM,WAAW,MAAM;IACrB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,EAAE,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC;CACrC;AAED;;;;;GAKG;AACH,MAAM,MAAM,MAAM,GAAG,MAAM,GAAG,MAAM,GAAG,SAAS,GAAG,mBAAmB,CAAC;AAEvE,MAAM,MAAM,UAAU,GAAG,MAAM,GAAG,SAAS,MAAM,EAAE,CAAC;AAEpD;;wEAEwE;AACxE,MAAM,WAAW,SAAS;IACxB,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,GAAG,MAAM,CAAC;IAChC,QAAQ,CAAC,QAAQ,CAAC,EAAE,UAAU,CAAC;IAC/B,QAAQ,CAAC,OAAO,CAAC,EAAE,MAAM,CAAC;IAC1B,QAAQ,EAAE,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC;CAClC;AAED;;;;GAIG;AACH,MAAM,WAAW,mBAAmB;IAClC,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACzC,QAAQ,CAAC,QAAQ,CAAC,EAAE,UAAU,CAAC;IAC/B,QAAQ,CAAC,GAAG,CAAC,EAAE,MAAM,CAAC;CACvB;AAED,MAAM,MAAM,MAAM,GAAG,MAAM,GAAG,SAAS,MAAM,EAAE,CAAC;AAEhD;;;;;;;GAOG;AACH,MAAM,WAAW,mBAAmB;IAClC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,KAAK,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAAC;IAClD,QAAQ,CAAC,QAAQ,CAAC,EAAE,gBAAgB,GAAG,SAAS,CAAC;IACjD,QAAQ,CAAC,GAAG,CAAC,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAAC;IAC3C,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;CACtC;AAED,MAAM,MAAM,gBAAgB,GACxB,MAAM,GACN,MAAM,GACN,SAAS,gBAAgB,EAAE,GAC3B,mBAAmB,GACnB,IAAI,CAAC;AA8BT;;;;;;;;;;;;;GAaG;AACH,wBAAgB,eAAe,CAC7B,IAAI,EAAE,OAAO,EACb,WAAW,CAAC,EAAE,SAAS,MAAM,EAAE,GAAG,SAAS,EAC3C,KAAK,SAAI,GACR,gBAAgB,CA2ClB;AAwBD;;;GAGG;AACH,wBAAgB,aAAa,CAAC,IAAI,EAAE,MAAM,GAAG;IAC3C,QAAQ,CAAC,IAAI,EAAE,gBAAgB,GAAG,SAAS,gBAAgB,EAAE,CAAC;CAC/D,CAOA"}

package/dist/renderGenerativeUI.d.ts

@@ -1,6 +1,5 @@
-import { GenerativeUILibrary, GenerativeUIRenderContext } from "./types.js";
-import { ReactNode } from "react";
-//#region src/renderGenerativeUI.d.ts
+import { type ReactNode } from "react";
+import type { GenerativeUILibrary, GenerativeUIRenderContext } from "./types.js";
 /**
  * Renders a generative-ui tree against a {@link GenerativeUILibrary}.
  *
@@ -11,7 +10,5 @@ import { ReactNode } from "react";
  * `render(props, context)`, with `children` rendered recursively so components
  * can nest.
  */
-declare function renderGenerativeUI(node: unknown, library: GenerativeUILibrary, context?: GenerativeUIRenderContext): ReactNode;
-//#endregion
-export { renderGenerativeUI };
+export declare function renderGenerativeUI(node: unknown, library: GenerativeUILibrary, context?: GenerativeUIRenderContext): ReactNode;
 //# sourceMappingURL=renderGenerativeUI.d.ts.map

package/dist/renderGenerativeUI.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"renderGenerativeUI.d.ts","names":[],"sources":["../src/renderGenerativeUI.tsx"],"mappings":";;;;;;;;;;;;;iBAwBgB,mBACd,eACA,SAAS,qBACT,UAAS,4BACR"}
+{"version":3,"file":"renderGenerativeUI.d.ts","sourceRoot":"","sources":["../src/renderGenerativeUI.tsx"],"names":[],"mappings":"AACA,OAAO,EAAY,KAAK,SAAS,EAAE,MAAM,OAAO,CAAC;AAMjD,OAAO,KAAK,EAAE,mBAAmB,EAAE,yBAAyB,EAAE,mBAAgB;AAO9E;;;;;;;;;GASG;AACH,wBAAgB,kBAAkB,CAChC,IAAI,EAAE,OAAO,EACb,OAAO,EAAE,mBAAmB,EAC5B,OAAO,GAAE,yBAA2C,GACnD,SAAS,CAOX"}

package/dist/scopeSchema.d.ts

@@ -0,0 +1,6 @@
+import type { JSONSchema7 } from "json-schema";
+export declare function scopeSchema(schema: JSONSchema7, path: string): {
+    schema: JSONSchema7;
+    referenced: boolean;
+};
+//# sourceMappingURL=scopeSchema.d.ts.map

package/dist/scopeSchema.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"scopeSchema.d.ts","sourceRoot":"","sources":["../src/scopeSchema.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAyB,MAAM,aAAa,CAAC;AAYtE,wBAAgB,WAAW,CAAC,MAAM,EAAE,WAAW,EAAE,IAAI,EAAE,MAAM;;;EA0D5D"}