@copilotkit/a2ui-renderer 1.60.2 → 1.61.1

package/dist/web-components/catalog/minimal/text.mjs

@@ -0,0 +1,38 @@
+import { createLitComponent } from "../../adapter.mjs";
+import { html } from "lit";
+import { CommonSchemas } from "@a2ui/web_core/v0_9";
+import { z } from "zod";
+
+//#region src/web-components/catalog/minimal/text.ts
+const TextSchema = z.object({
+	text: CommonSchemas.DynamicString,
+	variant: z.enum([
+		"h1",
+		"h2",
+		"h3",
+		"h4",
+		"h5",
+		"caption",
+		"body"
+	]).optional()
+});
+const TextApiDef = {
+	name: "Text",
+	schema: TextSchema
+};
+const Text = createLitComponent(TextApiDef, ({ props }) => {
+	const text = props.text ?? "";
+	switch (props.variant) {
+		case "h1": return html`<h1>${text}</h1>`;
+		case "h2": return html`<h2>${text}</h2>`;
+		case "h3": return html`<h3>${text}</h3>`;
+		case "h4": return html`<h4>${text}</h4>`;
+		case "h5": return html`<h5>${text}</h5>`;
+		case "caption": return html`<small>${text}</small>`;
+		default: return html`<span>${text}</span>`;
+	}
+});
+
+//#endregion
+export { Text, TextApiDef, TextSchema };
+//# sourceMappingURL=text.mjs.map

package/dist/web-components/catalog/minimal/text.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"text.mjs","names":[],"sources":["../../../../src/web-components/catalog/minimal/text.ts"],"sourcesContent":["import { html } from \"lit\";\nimport { CommonSchemas } from \"@a2ui/web_core/v0_9\";\nimport { z } from \"zod\";\nimport { createLitComponent } from \"../../adapter\";\n\nexport const TextSchema = z.object({\n  text: CommonSchemas.DynamicString,\n  variant: z.enum([\"h1\", \"h2\", \"h3\", \"h4\", \"h5\", \"caption\", \"body\"]).optional(),\n});\n\nexport const TextApiDef = {\n  name: \"Text\",\n  schema: TextSchema,\n};\n\nexport const Text = createLitComponent(TextApiDef, ({ props }) => {\n  const text = props.text ?? \"\";\n  switch (props.variant) {\n    case \"h1\":\n      return html`<h1>${text}</h1>`;\n    case \"h2\":\n      return html`<h2>${text}</h2>`;\n    case \"h3\":\n      return html`<h3>${text}</h3>`;\n    case \"h4\":\n      return html`<h4>${text}</h4>`;\n    case \"h5\":\n      return html`<h5>${text}</h5>`;\n    case \"caption\":\n      return html`<small>${text}</small>`;\n    case \"body\":\n    default:\n      return html`<span>${text}</span>`;\n  }\n});\n"],"mappings":";;;;;;AAKA,MAAa,aAAa,EAAE,OAAO;CACjC,MAAM,cAAc;CACpB,SAAS,EAAE,KAAK;EAAC;EAAM;EAAM;EAAM;EAAM;EAAM;EAAW;EAAO,CAAC,CAAC,UAAU;CAC9E,CAAC;AAEF,MAAa,aAAa;CACxB,MAAM;CACN,QAAQ;CACT;AAED,MAAa,OAAO,mBAAmB,aAAa,EAAE,YAAY;CAChE,MAAM,OAAO,MAAM,QAAQ;AAC3B,SAAQ,MAAM,SAAd;EACE,KAAK,KACH,QAAO,IAAI,OAAO,KAAK;EACzB,KAAK,KACH,QAAO,IAAI,OAAO,KAAK;EACzB,KAAK,KACH,QAAO,IAAI,OAAO,KAAK;EACzB,KAAK,KACH,QAAO,IAAI,OAAO,KAAK;EACzB,KAAK,KACH,QAAO,IAAI,OAAO,KAAK;EACzB,KAAK,UACH,QAAO,IAAI,UAAU,KAAK;EAE5B,QACE,QAAO,IAAI,SAAS,KAAK;;EAE7B"}

package/dist/web-components/catalog/minimal/utils.cjs

@@ -0,0 +1,26 @@
+
+//#region src/web-components/catalog/minimal/utils.ts
+const mapJustify = (justify) => {
+	switch (justify) {
+		case "center": return "center";
+		case "end": return "flex-end";
+		case "spaceAround": return "space-around";
+		case "spaceBetween": return "space-between";
+		case "spaceEvenly": return "space-evenly";
+		case "stretch": return "stretch";
+		default: return "flex-start";
+	}
+};
+const mapAlign = (align) => {
+	switch (align) {
+		case "start": return "flex-start";
+		case "center": return "center";
+		case "end": return "flex-end";
+		default: return "stretch";
+	}
+};
+
+//#endregion
+exports.mapAlign = mapAlign;
+exports.mapJustify = mapJustify;
+//# sourceMappingURL=utils.cjs.map

package/dist/web-components/catalog/minimal/utils.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"utils.cjs","names":[],"sources":["../../../../src/web-components/catalog/minimal/utils.ts"],"sourcesContent":["export const mapJustify = (justify?: string): string => {\n  switch (justify) {\n    case \"center\":\n      return \"center\";\n    case \"end\":\n      return \"flex-end\";\n    case \"spaceAround\":\n      return \"space-around\";\n    case \"spaceBetween\":\n      return \"space-between\";\n    case \"spaceEvenly\":\n      return \"space-evenly\";\n    case \"stretch\":\n      return \"stretch\";\n    case \"start\":\n    default:\n      return \"flex-start\";\n  }\n};\n\nexport const mapAlign = (align?: string): string => {\n  switch (align) {\n    case \"start\":\n      return \"flex-start\";\n    case \"center\":\n      return \"center\";\n    case \"end\":\n      return \"flex-end\";\n    case \"stretch\":\n    default:\n      return \"stretch\";\n  }\n};\n"],"mappings":";;AAAA,MAAa,cAAc,YAA6B;AACtD,SAAQ,SAAR;EACE,KAAK,SACH,QAAO;EACT,KAAK,MACH,QAAO;EACT,KAAK,cACH,QAAO;EACT,KAAK,eACH,QAAO;EACT,KAAK,cACH,QAAO;EACT,KAAK,UACH,QAAO;EAET,QACE,QAAO;;;AAIb,MAAa,YAAY,UAA2B;AAClD,SAAQ,OAAR;EACE,KAAK,QACH,QAAO;EACT,KAAK,SACH,QAAO;EACT,KAAK,MACH,QAAO;EAET,QACE,QAAO"}

package/dist/web-components/catalog/minimal/utils.mjs

@@ -0,0 +1,24 @@
+//#region src/web-components/catalog/minimal/utils.ts
+const mapJustify = (justify) => {
+	switch (justify) {
+		case "center": return "center";
+		case "end": return "flex-end";
+		case "spaceAround": return "space-around";
+		case "spaceBetween": return "space-between";
+		case "spaceEvenly": return "space-evenly";
+		case "stretch": return "stretch";
+		default: return "flex-start";
+	}
+};
+const mapAlign = (align) => {
+	switch (align) {
+		case "start": return "flex-start";
+		case "center": return "center";
+		case "end": return "flex-end";
+		default: return "stretch";
+	}
+};
+
+//#endregion
+export { mapAlign, mapJustify };
+//# sourceMappingURL=utils.mjs.map

package/dist/web-components/catalog/minimal/utils.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"utils.mjs","names":[],"sources":["../../../../src/web-components/catalog/minimal/utils.ts"],"sourcesContent":["export const mapJustify = (justify?: string): string => {\n  switch (justify) {\n    case \"center\":\n      return \"center\";\n    case \"end\":\n      return \"flex-end\";\n    case \"spaceAround\":\n      return \"space-around\";\n    case \"spaceBetween\":\n      return \"space-between\";\n    case \"spaceEvenly\":\n      return \"space-evenly\";\n    case \"stretch\":\n      return \"stretch\";\n    case \"start\":\n    default:\n      return \"flex-start\";\n  }\n};\n\nexport const mapAlign = (align?: string): string => {\n  switch (align) {\n    case \"start\":\n      return \"flex-start\";\n    case \"center\":\n      return \"center\";\n    case \"end\":\n      return \"flex-end\";\n    case \"stretch\":\n    default:\n      return \"stretch\";\n  }\n};\n"],"mappings":";AAAA,MAAa,cAAc,YAA6B;AACtD,SAAQ,SAAR;EACE,KAAK,SACH,QAAO;EACT,KAAK,MACH,QAAO;EACT,KAAK,cACH,QAAO;EACT,KAAK,eACH,QAAO;EACT,KAAK,cACH,QAAO;EACT,KAAK,UACH,QAAO;EAET,QACE,QAAO;;;AAIb,MAAa,YAAY,UAA2B;AAClD,SAAQ,OAAR;EACE,KAAK,QACH,QAAO;EACT,KAAK,SACH,QAAO;EACT,KAAK,MACH,QAAO;EAET,QACE,QAAO"}

package/dist/web-components/create-catalog.cjs

@@ -0,0 +1,143 @@
+const require_adapter = require('./adapter.cjs');
+const require_index = require('./catalog/basic/index.cjs');
+let _a2ui_web_core_v0_9 = require("@a2ui/web_core/v0_9");
+let zod_to_json_schema = require("zod-to-json-schema");
+
+//#region src/web-components/create-catalog.ts
+const BASIC_CATALOG_ID = "https://a2ui.org/specification/v0_9/basic_catalog.json";
+/**
+* Context description used to identify the A2UI component schema in RunAgentInput.context.
+* Must match the constant in @ag-ui/a2ui-middleware so the middleware can overwrite
+* a frontend-provided schema with a server-side one.
+*/
+const A2UI_SCHEMA_CONTEXT_DESCRIPTION = "A2UI Component Schema — available components for generating UI surfaces. Use these component names and properties when creating A2UI operations.";
+function createCatalog(definitions, renderers, options) {
+	const catalogId = options?.catalogId ?? "copilotkit://custom-catalog";
+	const customComponents = [];
+	for (const [name, def] of Object.entries(definitions)) {
+		const api = {
+			name,
+			schema: def.props
+		};
+		const renderer = renderers[name];
+		if (renderer === void 0) throw new Error(`Missing renderer for component "${name}"`);
+		customComponents.push(require_adapter.createLitComponent(api, ({ props, buildChild, context }) => renderer({
+			props,
+			children: buildChild,
+			dispatch: (action) => context.dispatchAction(action)
+		})));
+	}
+	return new _a2ui_web_core_v0_9.Catalog(catalogId, options?.includeBasicCatalog === true ? [...Array.from(require_index.basicCatalog.components.values()), ...customComponents] : customComponents, options?.includeBasicCatalog === true ? Array.from(require_index.basicCatalog.functions.values()) : []);
+}
+function extractSchema(definitions) {
+	return Object.entries(definitions).map(([name, def]) => ({
+		name,
+		description: def.description,
+		props: zodSchemaToSimpleObject(def.props)
+	}));
+}
+function zodSchemaToSimpleObject(schema) {
+	const shape = schema.shape;
+	const properties = {};
+	for (const [key, value] of Object.entries(shape)) {
+		const zodValue = value;
+		properties[key] = {
+			type: zodValue._def?.typeName ?? "unknown",
+			...zodValue.description ? { description: zodValue.description } : {}
+		};
+	}
+	return {
+		type: "object",
+		properties
+	};
+}
+function createA2UICatalog(components, options) {
+	const definitions = {};
+	const renderers = {};
+	for (const [name, def] of Object.entries(components)) {
+		definitions[name] = {
+			props: def.props,
+			description: def.description
+		};
+		renderers[name] = def.render;
+	}
+	return createCatalog(definitions, renderers, options);
+}
+function extractA2UISchema(components) {
+	const definitions = {};
+	for (const [name, def] of Object.entries(components)) definitions[name] = {
+		props: def.props,
+		description: def.description
+	};
+	return extractSchema(definitions);
+}
+function isCatalogContextValue(value) {
+	return typeof value === "object" && value !== null && "id" in value && typeof value.id === "string" && "components" in value && value.components instanceof Map;
+}
+function resolveCatalog(catalog) {
+	return isCatalogContextValue(catalog) ? catalog : require_index.basicCatalog;
+}
+function toJsonSchema(schema, options) {
+	return (0, zod_to_json_schema.zodToJsonSchema)(schema, options);
+}
+function extendsBasicCatalog(catalog) {
+	for (const name of require_index.basicCatalog.components.keys()) if (!catalog.components.has(name)) return false;
+	return true;
+}
+function getCustomComponentNames(catalog) {
+	const custom = [];
+	for (const name of catalog.components.keys()) if (!require_index.basicCatalog.components.has(name)) custom.push(name);
+	return custom;
+}
+function buildCatalogContextValue(catalog) {
+	const resolved = resolveCatalog(catalog);
+	const lines = ["Available A2UI catalog:"];
+	if (resolved.id === BASIC_CATALOG_ID) {
+		lines.push(`- ${resolved.id} (basic catalog)`);
+		return lines.join("\n");
+	}
+	const isSuperset = extendsBasicCatalog(resolved);
+	const customNames = getCustomComponentNames(resolved);
+	lines.push(`- ${resolved.id}`);
+	if (isSuperset) lines.push("  Extends the basic catalog with all standard components plus:");
+	else {
+		lines.push("  Custom catalog (does NOT include all basic components).");
+		lines.push("  Custom components:");
+	}
+	for (const name of customNames) {
+		const component = resolved.components.get(name);
+		if (!component) continue;
+		const jsonSchema = toJsonSchema(component.schema);
+		lines.push(`  - ${name}:`);
+		lines.push(`    ${JSON.stringify(jsonSchema, null, 2).split("\n").join("\n    ")}`);
+	}
+	return lines.join("\n");
+}
+function extractCatalogComponentSchemas(catalog) {
+	const resolved = resolveCatalog(catalog);
+	const components = {};
+	for (const [name, comp] of resolved.components) {
+		const zodSchema = toJsonSchema(comp.schema, { target: "jsonSchema2019-09" });
+		components[name] = { allOf: [{ $ref: "common_types.json#/$defs/ComponentCommon" }, {
+			properties: {
+				component: { const: name },
+				...zodSchema.properties
+			},
+			required: ["component", ...zodSchema.required ?? []]
+		}] };
+	}
+	return {
+		catalogId: resolved.id,
+		components
+	};
+}
+
+//#endregion
+exports.A2UI_SCHEMA_CONTEXT_DESCRIPTION = A2UI_SCHEMA_CONTEXT_DESCRIPTION;
+exports.buildCatalogContextValue = buildCatalogContextValue;
+exports.createA2UICatalog = createA2UICatalog;
+exports.createCatalog = createCatalog;
+exports.extractA2UISchema = extractA2UISchema;
+exports.extractCatalogComponentSchemas = extractCatalogComponentSchemas;
+exports.extractSchema = extractSchema;
+//# sourceMappingURL=create-catalog.cjs.map

package/dist/web-components/create-catalog.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"create-catalog.cjs","names":["createLitComponent","Catalog","basicCatalog"],"sources":["../../src/web-components/create-catalog.ts"],"sourcesContent":["import type { z } from \"zod\";\nimport type { ZodObject, ZodRawShape, ZodTypeAny } from \"zod\";\nimport { Catalog } from \"@a2ui/web_core/v0_9\";\nimport type { ComponentApi } from \"@a2ui/web_core/v0_9\";\nimport { zodToJsonSchema } from \"zod-to-json-schema\";\nimport { basicCatalog } from \"./catalog/basic\";\nimport { createLitComponent } from \"./adapter\";\nimport type {\n  CatalogComponentDefinition,\n  CatalogDefinitions,\n  CatalogRenderers,\n  ComponentRenderer,\n  LitComponentImplementation,\n  RendererProps,\n} from \"./types\";\n\nconst BASIC_CATALOG_ID =\n  \"https://a2ui.org/specification/v0_9/basic_catalog.json\";\n\ntype CatalogContextComponent = {\n  schema: unknown;\n};\n\ntype CatalogContextValue = {\n  id: string;\n  components: ReadonlyMap<string, CatalogContextComponent>;\n};\n\n/**\n * Context description used to identify the A2UI component schema in RunAgentInput.context.\n * Must match the constant in @ag-ui/a2ui-middleware so the middleware can overwrite\n * a frontend-provided schema with a server-side one.\n */\nexport const A2UI_SCHEMA_CONTEXT_DESCRIPTION =\n  \"A2UI Component Schema — available components for generating UI surfaces. Use these component names and properties when creating A2UI operations.\";\n\nexport type {\n  CatalogComponentDefinition,\n  CatalogDefinitions,\n  CatalogRenderers,\n  ComponentRenderer,\n  RendererProps,\n} from \"./types\";\n\nexport function createCatalog<D extends CatalogDefinitions>(\n  definitions: D,\n  renderers: CatalogRenderers<D>,\n  options?: {\n    catalogId?: string;\n    includeBasicCatalog?: boolean;\n  },\n): Catalog<LitComponentImplementation> {\n  const catalogId = options?.catalogId ?? \"copilotkit://custom-catalog\";\n  const customComponents: LitComponentImplementation[] = [];\n\n  for (const [name, def] of Object.entries(definitions)) {\n    const api: ComponentApi = {\n      name,\n      schema: def.props,\n    };\n    const renderer = (renderers as Record<string, ComponentRenderer<any>>)[\n      name\n    ];\n    if (renderer === undefined) {\n      throw new Error(`Missing renderer for component \"${name}\"`);\n    }\n    customComponents.push(\n      createLitComponent(api, ({ props, buildChild, context }) =>\n        renderer({\n          props,\n          children: buildChild,\n          dispatch: (action: unknown) => context.dispatchAction(action),\n        }),\n      ),\n    );\n  }\n\n  const components =\n    options?.includeBasicCatalog === true\n      ? [...Array.from(basicCatalog.components.values()), ...customComponents]\n      : customComponents;\n  const functions =\n    options?.includeBasicCatalog === true\n      ? Array.from(basicCatalog.functions.values())\n      : [];\n\n  return new Catalog<LitComponentImplementation>(\n    catalogId,\n    components,\n    functions,\n  );\n}\n\nexport function extractSchema(definitions: CatalogDefinitions): Array<{\n  name: string;\n  description?: string;\n  props?: Record<string, unknown>;\n}> {\n  return Object.entries(definitions).map(([name, def]) => ({\n    name,\n    description: def.description,\n    props: zodSchemaToSimpleObject(def.props),\n  }));\n}\n\nfunction zodSchemaToSimpleObject(\n  schema: ZodObject<any>,\n): Record<string, unknown> {\n  const shape = schema.shape;\n  const properties: Record<string, { type: string; description?: string }> = {};\n  for (const [key, value] of Object.entries(shape)) {\n    const zodValue = value as any;\n    properties[key] = {\n      type: zodValue._def?.typeName ?? \"unknown\",\n      ...(zodValue.description ? { description: zodValue.description } : {}),\n    };\n  }\n  return { type: \"object\", properties };\n}\n\nexport interface A2UIComponentDefinition<T extends ZodRawShape = ZodRawShape> {\n  props: ZodObject<T>;\n  description?: string;\n  render: (props: RendererProps<z.infer<ZodObject<T>>>) => unknown;\n}\n\nexport type A2UIComponentMap = Record<string, A2UIComponentDefinition<any>>;\n\nexport function createA2UICatalog(\n  components: A2UIComponentMap,\n  options?: {\n    catalogId?: string;\n    includeBasicCatalog?: boolean;\n  },\n): Catalog<LitComponentImplementation> {\n  const definitions: CatalogDefinitions = {};\n  const renderers: Record<string, ComponentRenderer<any>> = {};\n\n  for (const [name, def] of Object.entries(components)) {\n    definitions[name] = { props: def.props, description: def.description };\n    renderers[name] = def.render as ComponentRenderer<any>;\n  }\n\n  return createCatalog(definitions, renderers as any, options);\n}\n\nexport function extractA2UISchema(components: A2UIComponentMap): Array<{\n  name: string;\n  description?: string;\n  props?: Record<string, unknown>;\n}> {\n  const definitions: CatalogDefinitions = {};\n  for (const [name, def] of Object.entries(components)) {\n    definitions[name] = { props: def.props, description: def.description };\n  }\n  return extractSchema(definitions);\n}\n\nfunction isCatalogContextValue(value: unknown): value is CatalogContextValue {\n  return (\n    typeof value === \"object\" &&\n    value !== null &&\n    \"id\" in value &&\n    typeof value.id === \"string\" &&\n    \"components\" in value &&\n    value.components instanceof Map\n  );\n}\n\nfunction resolveCatalog(catalog?: unknown): CatalogContextValue {\n  return isCatalogContextValue(catalog) ? catalog : basicCatalog;\n}\n\nfunction toJsonSchema(\n  schema: unknown,\n  options?: Parameters<typeof zodToJsonSchema>[1],\n): ReturnType<typeof zodToJsonSchema> {\n  return zodToJsonSchema(schema as ZodTypeAny, options);\n}\n\nfunction extendsBasicCatalog(catalog: CatalogContextValue): boolean {\n  for (const name of basicCatalog.components.keys()) {\n    if (!catalog.components.has(name)) {\n      return false;\n    }\n  }\n  return true;\n}\n\nfunction getCustomComponentNames(catalog: CatalogContextValue): string[] {\n  const custom: string[] = [];\n  for (const name of catalog.components.keys()) {\n    if (!basicCatalog.components.has(name)) {\n      custom.push(name);\n    }\n  }\n  return custom;\n}\n\nexport function buildCatalogContextValue(catalog?: unknown): string {\n  const resolved = resolveCatalog(catalog);\n  const lines: string[] = [\"Available A2UI catalog:\"];\n\n  if (resolved.id === BASIC_CATALOG_ID) {\n    lines.push(`- ${resolved.id} (basic catalog)`);\n    return lines.join(\"\\n\");\n  }\n\n  const isSuperset = extendsBasicCatalog(resolved);\n  const customNames = getCustomComponentNames(resolved);\n\n  lines.push(`- ${resolved.id}`);\n  if (isSuperset) {\n    lines.push(\n      \"  Extends the basic catalog with all standard components plus:\",\n    );\n  } else {\n    lines.push(\"  Custom catalog (does NOT include all basic components).\");\n    lines.push(\"  Custom components:\");\n  }\n\n  for (const name of customNames) {\n    const component = resolved.components.get(name);\n    if (!component) continue;\n    const jsonSchema = toJsonSchema(component.schema);\n    lines.push(`  - ${name}:`);\n    lines.push(\n      `    ${JSON.stringify(jsonSchema, null, 2).split(\"\\n\").join(\"\\n    \")}`,\n    );\n  }\n\n  return lines.join(\"\\n\");\n}\n\nexport interface InlineCatalogSchema {\n  catalogId: string;\n  components: Record<string, Record<string, unknown>>;\n}\n\nexport function extractCatalogComponentSchemas(\n  catalog?: unknown,\n): InlineCatalogSchema {\n  const resolved = resolveCatalog(catalog);\n  const components: Record<string, Record<string, unknown>> = {};\n  for (const [name, comp] of resolved.components) {\n    const zodSchema = toJsonSchema(comp.schema, {\n      target: \"jsonSchema2019-09\",\n    }) as { properties?: Record<string, unknown>; required?: string[] };\n    components[name] = {\n      allOf: [\n        { $ref: \"common_types.json#/$defs/ComponentCommon\" },\n        {\n          properties: {\n            component: { const: name },\n            ...zodSchema.properties,\n          },\n          required: [\"component\", ...(zodSchema.required ?? [])],\n        },\n      ],\n    };\n  }\n  return { catalogId: resolved.id, components };\n}\n"],"mappings":";;;;;;AAgBA,MAAM,mBACJ;;;;;;AAgBF,MAAa,kCACX;AAUF,SAAgB,cACd,aACA,WACA,SAIqC;CACrC,MAAM,YAAY,SAAS,aAAa;CACxC,MAAM,mBAAiD,EAAE;AAEzD,MAAK,MAAM,CAAC,MAAM,QAAQ,OAAO,QAAQ,YAAY,EAAE;EACrD,MAAM,MAAoB;GACxB;GACA,QAAQ,IAAI;GACb;EACD,MAAM,WAAY,UAChB;AAEF,MAAI,aAAa,OACf,OAAM,IAAI,MAAM,mCAAmC,KAAK,GAAG;AAE7D,mBAAiB,KACfA,mCAAmB,MAAM,EAAE,OAAO,YAAY,cAC5C,SAAS;GACP;GACA,UAAU;GACV,WAAW,WAAoB,QAAQ,eAAe,OAAO;GAC9D,CAAC,CACH,CACF;;AAYH,QAAO,IAAIC,4BACT,WATA,SAAS,wBAAwB,OAC7B,CAAC,GAAG,MAAM,KAAKC,2BAAa,WAAW,QAAQ,CAAC,EAAE,GAAG,iBAAiB,GACtE,kBAEJ,SAAS,wBAAwB,OAC7B,MAAM,KAAKA,2BAAa,UAAU,QAAQ,CAAC,GAC3C,EAAE,CAMP;;AAGH,SAAgB,cAAc,aAI3B;AACD,QAAO,OAAO,QAAQ,YAAY,CAAC,KAAK,CAAC,MAAM,UAAU;EACvD;EACA,aAAa,IAAI;EACjB,OAAO,wBAAwB,IAAI,MAAM;EAC1C,EAAE;;AAGL,SAAS,wBACP,QACyB;CACzB,MAAM,QAAQ,OAAO;CACrB,MAAM,aAAqE,EAAE;AAC7E,MAAK,MAAM,CAAC,KAAK,UAAU,OAAO,QAAQ,MAAM,EAAE;EAChD,MAAM,WAAW;AACjB,aAAW,OAAO;GAChB,MAAM,SAAS,MAAM,YAAY;GACjC,GAAI,SAAS,cAAc,EAAE,aAAa,SAAS,aAAa,GAAG,EAAE;GACtE;;AAEH,QAAO;EAAE,MAAM;EAAU;EAAY;;AAWvC,SAAgB,kBACd,YACA,SAIqC;CACrC,MAAM,cAAkC,EAAE;CAC1C,MAAM,YAAoD,EAAE;AAE5D,MAAK,MAAM,CAAC,MAAM,QAAQ,OAAO,QAAQ,WAAW,EAAE;AACpD,cAAY,QAAQ;GAAE,OAAO,IAAI;GAAO,aAAa,IAAI;GAAa;AACtE,YAAU,QAAQ,IAAI;;AAGxB,QAAO,cAAc,aAAa,WAAkB,QAAQ;;AAG9D,SAAgB,kBAAkB,YAI/B;CACD,MAAM,cAAkC,EAAE;AAC1C,MAAK,MAAM,CAAC,MAAM,QAAQ,OAAO,QAAQ,WAAW,CAClD,aAAY,QAAQ;EAAE,OAAO,IAAI;EAAO,aAAa,IAAI;EAAa;AAExE,QAAO,cAAc,YAAY;;AAGnC,SAAS,sBAAsB,OAA8C;AAC3E,QACE,OAAO,UAAU,YACjB,UAAU,QACV,QAAQ,SACR,OAAO,MAAM,OAAO,YACpB,gBAAgB,SAChB,MAAM,sBAAsB;;AAIhC,SAAS,eAAe,SAAwC;AAC9D,QAAO,sBAAsB,QAAQ,GAAG,UAAUA;;AAGpD,SAAS,aACP,QACA,SACoC;AACpC,gDAAuB,QAAsB,QAAQ;;AAGvD,SAAS,oBAAoB,SAAuC;AAClE,MAAK,MAAM,QAAQA,2BAAa,WAAW,MAAM,CAC/C,KAAI,CAAC,QAAQ,WAAW,IAAI,KAAK,CAC/B,QAAO;AAGX,QAAO;;AAGT,SAAS,wBAAwB,SAAwC;CACvE,MAAM,SAAmB,EAAE;AAC3B,MAAK,MAAM,QAAQ,QAAQ,WAAW,MAAM,CAC1C,KAAI,CAACA,2BAAa,WAAW,IAAI,KAAK,CACpC,QAAO,KAAK,KAAK;AAGrB,QAAO;;AAGT,SAAgB,yBAAyB,SAA2B;CAClE,MAAM,WAAW,eAAe,QAAQ;CACxC,MAAM,QAAkB,CAAC,0BAA0B;AAEnD,KAAI,SAAS,OAAO,kBAAkB;AACpC,QAAM,KAAK,KAAK,SAAS,GAAG,kBAAkB;AAC9C,SAAO,MAAM,KAAK,KAAK;;CAGzB,MAAM,aAAa,oBAAoB,SAAS;CAChD,MAAM,cAAc,wBAAwB,SAAS;AAErD,OAAM,KAAK,KAAK,SAAS,KAAK;AAC9B,KAAI,WACF,OAAM,KACJ,iEACD;MACI;AACL,QAAM,KAAK,4DAA4D;AACvE,QAAM,KAAK,uBAAuB;;AAGpC,MAAK,MAAM,QAAQ,aAAa;EAC9B,MAAM,YAAY,SAAS,WAAW,IAAI,KAAK;AAC/C,MAAI,CAAC,UAAW;EAChB,MAAM,aAAa,aAAa,UAAU,OAAO;AACjD,QAAM,KAAK,OAAO,KAAK,GAAG;AAC1B,QAAM,KACJ,OAAO,KAAK,UAAU,YAAY,MAAM,EAAE,CAAC,MAAM,KAAK,CAAC,KAAK,SAAS,GACtE;;AAGH,QAAO,MAAM,KAAK,KAAK;;AAQzB,SAAgB,+BACd,SACqB;CACrB,MAAM,WAAW,eAAe,QAAQ;CACxC,MAAM,aAAsD,EAAE;AAC9D,MAAK,MAAM,CAAC,MAAM,SAAS,SAAS,YAAY;EAC9C,MAAM,YAAY,aAAa,KAAK,QAAQ,EAC1C,QAAQ,qBACT,CAAC;AACF,aAAW,QAAQ,EACjB,OAAO,CACL,EAAE,MAAM,4CAA4C,EACpD;GACE,YAAY;IACV,WAAW,EAAE,OAAO,MAAM;IAC1B,GAAG,UAAU;IACd;GACD,UAAU,CAAC,aAAa,GAAI,UAAU,YAAY,EAAE,CAAE;GACvD,CACF,EACF;;AAEH,QAAO;EAAE,WAAW,SAAS;EAAI;EAAY"}

package/dist/web-components/create-catalog.d.cts

@@ -0,0 +1,44 @@
+import { CatalogComponentDefinition, CatalogDefinitions, CatalogRenderers, ComponentRenderer, LitComponentImplementation, RendererProps } from "./types.cjs";
+import { Catalog } from "@a2ui/web_core/v0_9";
+import { ZodObject, ZodRawShape, z } from "zod";
+
+//#region src/web-components/create-catalog.d.ts
+/**
+ * Context description used to identify the A2UI component schema in RunAgentInput.context.
+ * Must match the constant in @ag-ui/a2ui-middleware so the middleware can overwrite
+ * a frontend-provided schema with a server-side one.
+ */
+declare const A2UI_SCHEMA_CONTEXT_DESCRIPTION = "A2UI Component Schema \u2014 available components for generating UI surfaces. Use these component names and properties when creating A2UI operations.";
+declare function createCatalog<D extends CatalogDefinitions>(definitions: D, renderers: CatalogRenderers<D>, options?: {
+  catalogId?: string;
+  includeBasicCatalog?: boolean;
+}): Catalog<LitComponentImplementation>;
+declare function extractSchema(definitions: CatalogDefinitions): Array<{
+  name: string;
+  description?: string;
+  props?: Record<string, unknown>;
+}>;
+interface A2UIComponentDefinition<T extends ZodRawShape = ZodRawShape> {
+  props: ZodObject<T>;
+  description?: string;
+  render: (props: RendererProps<z.infer<ZodObject<T>>>) => unknown;
+}
+type A2UIComponentMap = Record<string, A2UIComponentDefinition<any>>;
+declare function createA2UICatalog(components: A2UIComponentMap, options?: {
+  catalogId?: string;
+  includeBasicCatalog?: boolean;
+}): Catalog<LitComponentImplementation>;
+declare function extractA2UISchema(components: A2UIComponentMap): Array<{
+  name: string;
+  description?: string;
+  props?: Record<string, unknown>;
+}>;
+declare function buildCatalogContextValue(catalog?: unknown): string;
+interface InlineCatalogSchema {
+  catalogId: string;
+  components: Record<string, Record<string, unknown>>;
+}
+declare function extractCatalogComponentSchemas(catalog?: unknown): InlineCatalogSchema;
+//#endregion
+export { A2UIComponentDefinition, A2UIComponentMap, A2UI_SCHEMA_CONTEXT_DESCRIPTION, buildCatalogContextValue, createA2UICatalog, createCatalog, extractA2UISchema, extractCatalogComponentSchemas, extractSchema };
+//# sourceMappingURL=create-catalog.d.cts.map

package/dist/web-components/create-catalog.d.cts.map

@@ -0,0 +1 @@
+{"version":3,"file":"create-catalog.d.cts","names":[],"sources":["../../src/web-components/create-catalog.ts"],"mappings":";;;;;;AAiCA;;;;cAAa,+BAAA;AAAA,iBAWG,aAAA,WAAwB,kBAAA,CAAA,CACtC,WAAA,EAAa,CAAA,EACb,SAAA,EAAW,gBAAA,CAAiB,CAAA,GAC5B,OAAA;EACE,SAAA;EACA,mBAAA;AAAA,IAED,OAAA,CAAQ,0BAAA;AAAA,iBA0CK,aAAA,CAAc,WAAA,EAAa,kBAAA,GAAqB,KAAA;EAC9D,IAAA;EACA,WAAA;EACA,KAAA,GAAQ,MAAA;AAAA;AAAA,UAwBO,uBAAA,WAAkC,WAAA,GAAc,WAAA;EAC/D,KAAA,EAAO,SAAA,CAAU,CAAA;EACjB,WAAA;EACA,MAAA,GAAS,KAAA,EAAO,aAAA,CAAc,CAAA,CAAE,KAAA,CAAM,SAAA,CAAU,CAAA;AAAA;AAAA,KAGtC,gBAAA,GAAmB,MAAA,SAAe,uBAAA;AAAA,iBAE9B,iBAAA,CACd,UAAA,EAAY,gBAAA,EACZ,OAAA;EACE,SAAA;EACA,mBAAA;AAAA,IAED,OAAA,CAAQ,0BAAA;AAAA,iBAYK,iBAAA,CAAkB,UAAA,EAAY,gBAAA,GAAmB,KAAA;EAC/D,IAAA;EACA,WAAA;EACA,KAAA,GAAQ,MAAA;AAAA;AAAA,iBAkDM,wBAAA,CAAyB,OAAA;AAAA,UAmCxB,mBAAA;EACf,SAAA;EACA,UAAA,EAAY,MAAA,SAAe,MAAA;AAAA;AAAA,iBAGb,8BAAA,CACd,OAAA,aACC,mBAAA"}

package/dist/web-components/create-catalog.d.mts

@@ -0,0 +1,44 @@
+import { CatalogComponentDefinition, CatalogDefinitions, CatalogRenderers, ComponentRenderer, LitComponentImplementation, RendererProps } from "./types.mjs";
+import { Catalog } from "@a2ui/web_core/v0_9";
+import { ZodObject, ZodRawShape, z } from "zod";
+
+//#region src/web-components/create-catalog.d.ts
+/**
+ * Context description used to identify the A2UI component schema in RunAgentInput.context.
+ * Must match the constant in @ag-ui/a2ui-middleware so the middleware can overwrite
+ * a frontend-provided schema with a server-side one.
+ */
+declare const A2UI_SCHEMA_CONTEXT_DESCRIPTION = "A2UI Component Schema \u2014 available components for generating UI surfaces. Use these component names and properties when creating A2UI operations.";
+declare function createCatalog<D extends CatalogDefinitions>(definitions: D, renderers: CatalogRenderers<D>, options?: {
+  catalogId?: string;
+  includeBasicCatalog?: boolean;
+}): Catalog<LitComponentImplementation>;
+declare function extractSchema(definitions: CatalogDefinitions): Array<{
+  name: string;
+  description?: string;
+  props?: Record<string, unknown>;
+}>;
+interface A2UIComponentDefinition<T extends ZodRawShape = ZodRawShape> {
+  props: ZodObject<T>;
+  description?: string;
+  render: (props: RendererProps<z.infer<ZodObject<T>>>) => unknown;
+}
+type A2UIComponentMap = Record<string, A2UIComponentDefinition<any>>;
+declare function createA2UICatalog(components: A2UIComponentMap, options?: {
+  catalogId?: string;
+  includeBasicCatalog?: boolean;
+}): Catalog<LitComponentImplementation>;
+declare function extractA2UISchema(components: A2UIComponentMap): Array<{
+  name: string;
+  description?: string;
+  props?: Record<string, unknown>;
+}>;
+declare function buildCatalogContextValue(catalog?: unknown): string;
+interface InlineCatalogSchema {
+  catalogId: string;
+  components: Record<string, Record<string, unknown>>;
+}
+declare function extractCatalogComponentSchemas(catalog?: unknown): InlineCatalogSchema;
+//#endregion
+export { A2UIComponentDefinition, A2UIComponentMap, A2UI_SCHEMA_CONTEXT_DESCRIPTION, buildCatalogContextValue, createA2UICatalog, createCatalog, extractA2UISchema, extractCatalogComponentSchemas, extractSchema };
+//# sourceMappingURL=create-catalog.d.mts.map

package/dist/web-components/create-catalog.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"create-catalog.d.mts","names":[],"sources":["../../src/web-components/create-catalog.ts"],"mappings":";;;;;;AAiCA;;;;cAAa,+BAAA;AAAA,iBAWG,aAAA,WAAwB,kBAAA,CAAA,CACtC,WAAA,EAAa,CAAA,EACb,SAAA,EAAW,gBAAA,CAAiB,CAAA,GAC5B,OAAA;EACE,SAAA;EACA,mBAAA;AAAA,IAED,OAAA,CAAQ,0BAAA;AAAA,iBA0CK,aAAA,CAAc,WAAA,EAAa,kBAAA,GAAqB,KAAA;EAC9D,IAAA;EACA,WAAA;EACA,KAAA,GAAQ,MAAA;AAAA;AAAA,UAwBO,uBAAA,WAAkC,WAAA,GAAc,WAAA;EAC/D,KAAA,EAAO,SAAA,CAAU,CAAA;EACjB,WAAA;EACA,MAAA,GAAS,KAAA,EAAO,aAAA,CAAc,CAAA,CAAE,KAAA,CAAM,SAAA,CAAU,CAAA;AAAA;AAAA,KAGtC,gBAAA,GAAmB,MAAA,SAAe,uBAAA;AAAA,iBAE9B,iBAAA,CACd,UAAA,EAAY,gBAAA,EACZ,OAAA;EACE,SAAA;EACA,mBAAA;AAAA,IAED,OAAA,CAAQ,0BAAA;AAAA,iBAYK,iBAAA,CAAkB,UAAA,EAAY,gBAAA,GAAmB,KAAA;EAC/D,IAAA;EACA,WAAA;EACA,KAAA,GAAQ,MAAA;AAAA;AAAA,iBAkDM,wBAAA,CAAyB,OAAA;AAAA,UAmCxB,mBAAA;EACf,SAAA;EACA,UAAA,EAAY,MAAA,SAAe,MAAA;AAAA;AAAA,iBAGb,8BAAA,CACd,OAAA,aACC,mBAAA"}

package/dist/web-components/create-catalog.mjs

@@ -0,0 +1,137 @@
+import { createLitComponent } from "./adapter.mjs";
+import { basicCatalog } from "./catalog/basic/index.mjs";
+import { Catalog } from "@a2ui/web_core/v0_9";
+import { zodToJsonSchema } from "zod-to-json-schema";
+
+//#region src/web-components/create-catalog.ts
+const BASIC_CATALOG_ID = "https://a2ui.org/specification/v0_9/basic_catalog.json";
+/**
+* Context description used to identify the A2UI component schema in RunAgentInput.context.
+* Must match the constant in @ag-ui/a2ui-middleware so the middleware can overwrite
+* a frontend-provided schema with a server-side one.
+*/
+const A2UI_SCHEMA_CONTEXT_DESCRIPTION = "A2UI Component Schema — available components for generating UI surfaces. Use these component names and properties when creating A2UI operations.";
+function createCatalog(definitions, renderers, options) {
+	const catalogId = options?.catalogId ?? "copilotkit://custom-catalog";
+	const customComponents = [];
+	for (const [name, def] of Object.entries(definitions)) {
+		const api = {
+			name,
+			schema: def.props
+		};
+		const renderer = renderers[name];
+		if (renderer === void 0) throw new Error(`Missing renderer for component "${name}"`);
+		customComponents.push(createLitComponent(api, ({ props, buildChild, context }) => renderer({
+			props,
+			children: buildChild,
+			dispatch: (action) => context.dispatchAction(action)
+		})));
+	}
+	return new Catalog(catalogId, options?.includeBasicCatalog === true ? [...Array.from(basicCatalog.components.values()), ...customComponents] : customComponents, options?.includeBasicCatalog === true ? Array.from(basicCatalog.functions.values()) : []);
+}
+function extractSchema(definitions) {
+	return Object.entries(definitions).map(([name, def]) => ({
+		name,
+		description: def.description,
+		props: zodSchemaToSimpleObject(def.props)
+	}));
+}
+function zodSchemaToSimpleObject(schema) {
+	const shape = schema.shape;
+	const properties = {};
+	for (const [key, value] of Object.entries(shape)) {
+		const zodValue = value;
+		properties[key] = {
+			type: zodValue._def?.typeName ?? "unknown",
+			...zodValue.description ? { description: zodValue.description } : {}
+		};
+	}
+	return {
+		type: "object",
+		properties
+	};
+}
+function createA2UICatalog(components, options) {
+	const definitions = {};
+	const renderers = {};
+	for (const [name, def] of Object.entries(components)) {
+		definitions[name] = {
+			props: def.props,
+			description: def.description
+		};
+		renderers[name] = def.render;
+	}
+	return createCatalog(definitions, renderers, options);
+}
+function extractA2UISchema(components) {
+	const definitions = {};
+	for (const [name, def] of Object.entries(components)) definitions[name] = {
+		props: def.props,
+		description: def.description
+	};
+	return extractSchema(definitions);
+}
+function isCatalogContextValue(value) {
+	return typeof value === "object" && value !== null && "id" in value && typeof value.id === "string" && "components" in value && value.components instanceof Map;
+}
+function resolveCatalog(catalog) {
+	return isCatalogContextValue(catalog) ? catalog : basicCatalog;
+}
+function toJsonSchema(schema, options) {
+	return zodToJsonSchema(schema, options);
+}
+function extendsBasicCatalog(catalog) {
+	for (const name of basicCatalog.components.keys()) if (!catalog.components.has(name)) return false;
+	return true;
+}
+function getCustomComponentNames(catalog) {
+	const custom = [];
+	for (const name of catalog.components.keys()) if (!basicCatalog.components.has(name)) custom.push(name);
+	return custom;
+}
+function buildCatalogContextValue(catalog) {
+	const resolved = resolveCatalog(catalog);
+	const lines = ["Available A2UI catalog:"];
+	if (resolved.id === BASIC_CATALOG_ID) {
+		lines.push(`- ${resolved.id} (basic catalog)`);
+		return lines.join("\n");
+	}
+	const isSuperset = extendsBasicCatalog(resolved);
+	const customNames = getCustomComponentNames(resolved);
+	lines.push(`- ${resolved.id}`);
+	if (isSuperset) lines.push("  Extends the basic catalog with all standard components plus:");
+	else {
+		lines.push("  Custom catalog (does NOT include all basic components).");
+		lines.push("  Custom components:");
+	}
+	for (const name of customNames) {
+		const component = resolved.components.get(name);
+		if (!component) continue;
+		const jsonSchema = toJsonSchema(component.schema);
+		lines.push(`  - ${name}:`);
+		lines.push(`    ${JSON.stringify(jsonSchema, null, 2).split("\n").join("\n    ")}`);
+	}
+	return lines.join("\n");
+}
+function extractCatalogComponentSchemas(catalog) {
+	const resolved = resolveCatalog(catalog);
+	const components = {};
+	for (const [name, comp] of resolved.components) {
+		const zodSchema = toJsonSchema(comp.schema, { target: "jsonSchema2019-09" });
+		components[name] = { allOf: [{ $ref: "common_types.json#/$defs/ComponentCommon" }, {
+			properties: {
+				component: { const: name },
+				...zodSchema.properties
+			},
+			required: ["component", ...zodSchema.required ?? []]
+		}] };
+	}
+	return {
+		catalogId: resolved.id,
+		components
+	};
+}
+
+//#endregion
+export { A2UI_SCHEMA_CONTEXT_DESCRIPTION, buildCatalogContextValue, createA2UICatalog, createCatalog, extractA2UISchema, extractCatalogComponentSchemas, extractSchema };
+//# sourceMappingURL=create-catalog.mjs.map

package/dist/web-components/create-catalog.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"create-catalog.mjs","names":[],"sources":["../../src/web-components/create-catalog.ts"],"sourcesContent":["import type { z } from \"zod\";\nimport type { ZodObject, ZodRawShape, ZodTypeAny } from \"zod\";\nimport { Catalog } from \"@a2ui/web_core/v0_9\";\nimport type { ComponentApi } from \"@a2ui/web_core/v0_9\";\nimport { zodToJsonSchema } from \"zod-to-json-schema\";\nimport { basicCatalog } from \"./catalog/basic\";\nimport { createLitComponent } from \"./adapter\";\nimport type {\n  CatalogComponentDefinition,\n  CatalogDefinitions,\n  CatalogRenderers,\n  ComponentRenderer,\n  LitComponentImplementation,\n  RendererProps,\n} from \"./types\";\n\nconst BASIC_CATALOG_ID =\n  \"https://a2ui.org/specification/v0_9/basic_catalog.json\";\n\ntype CatalogContextComponent = {\n  schema: unknown;\n};\n\ntype CatalogContextValue = {\n  id: string;\n  components: ReadonlyMap<string, CatalogContextComponent>;\n};\n\n/**\n * Context description used to identify the A2UI component schema in RunAgentInput.context.\n * Must match the constant in @ag-ui/a2ui-middleware so the middleware can overwrite\n * a frontend-provided schema with a server-side one.\n */\nexport const A2UI_SCHEMA_CONTEXT_DESCRIPTION =\n  \"A2UI Component Schema — available components for generating UI surfaces. Use these component names and properties when creating A2UI operations.\";\n\nexport type {\n  CatalogComponentDefinition,\n  CatalogDefinitions,\n  CatalogRenderers,\n  ComponentRenderer,\n  RendererProps,\n} from \"./types\";\n\nexport function createCatalog<D extends CatalogDefinitions>(\n  definitions: D,\n  renderers: CatalogRenderers<D>,\n  options?: {\n    catalogId?: string;\n    includeBasicCatalog?: boolean;\n  },\n): Catalog<LitComponentImplementation> {\n  const catalogId = options?.catalogId ?? \"copilotkit://custom-catalog\";\n  const customComponents: LitComponentImplementation[] = [];\n\n  for (const [name, def] of Object.entries(definitions)) {\n    const api: ComponentApi = {\n      name,\n      schema: def.props,\n    };\n    const renderer = (renderers as Record<string, ComponentRenderer<any>>)[\n      name\n    ];\n    if (renderer === undefined) {\n      throw new Error(`Missing renderer for component \"${name}\"`);\n    }\n    customComponents.push(\n      createLitComponent(api, ({ props, buildChild, context }) =>\n        renderer({\n          props,\n          children: buildChild,\n          dispatch: (action: unknown) => context.dispatchAction(action),\n        }),\n      ),\n    );\n  }\n\n  const components =\n    options?.includeBasicCatalog === true\n      ? [...Array.from(basicCatalog.components.values()), ...customComponents]\n      : customComponents;\n  const functions =\n    options?.includeBasicCatalog === true\n      ? Array.from(basicCatalog.functions.values())\n      : [];\n\n  return new Catalog<LitComponentImplementation>(\n    catalogId,\n    components,\n    functions,\n  );\n}\n\nexport function extractSchema(definitions: CatalogDefinitions): Array<{\n  name: string;\n  description?: string;\n  props?: Record<string, unknown>;\n}> {\n  return Object.entries(definitions).map(([name, def]) => ({\n    name,\n    description: def.description,\n    props: zodSchemaToSimpleObject(def.props),\n  }));\n}\n\nfunction zodSchemaToSimpleObject(\n  schema: ZodObject<any>,\n): Record<string, unknown> {\n  const shape = schema.shape;\n  const properties: Record<string, { type: string; description?: string }> = {};\n  for (const [key, value] of Object.entries(shape)) {\n    const zodValue = value as any;\n    properties[key] = {\n      type: zodValue._def?.typeName ?? \"unknown\",\n      ...(zodValue.description ? { description: zodValue.description } : {}),\n    };\n  }\n  return { type: \"object\", properties };\n}\n\nexport interface A2UIComponentDefinition<T extends ZodRawShape = ZodRawShape> {\n  props: ZodObject<T>;\n  description?: string;\n  render: (props: RendererProps<z.infer<ZodObject<T>>>) => unknown;\n}\n\nexport type A2UIComponentMap = Record<string, A2UIComponentDefinition<any>>;\n\nexport function createA2UICatalog(\n  components: A2UIComponentMap,\n  options?: {\n    catalogId?: string;\n    includeBasicCatalog?: boolean;\n  },\n): Catalog<LitComponentImplementation> {\n  const definitions: CatalogDefinitions = {};\n  const renderers: Record<string, ComponentRenderer<any>> = {};\n\n  for (const [name, def] of Object.entries(components)) {\n    definitions[name] = { props: def.props, description: def.description };\n    renderers[name] = def.render as ComponentRenderer<any>;\n  }\n\n  return createCatalog(definitions, renderers as any, options);\n}\n\nexport function extractA2UISchema(components: A2UIComponentMap): Array<{\n  name: string;\n  description?: string;\n  props?: Record<string, unknown>;\n}> {\n  const definitions: CatalogDefinitions = {};\n  for (const [name, def] of Object.entries(components)) {\n    definitions[name] = { props: def.props, description: def.description };\n  }\n  return extractSchema(definitions);\n}\n\nfunction isCatalogContextValue(value: unknown): value is CatalogContextValue {\n  return (\n    typeof value === \"object\" &&\n    value !== null &&\n    \"id\" in value &&\n    typeof value.id === \"string\" &&\n    \"components\" in value &&\n    value.components instanceof Map\n  );\n}\n\nfunction resolveCatalog(catalog?: unknown): CatalogContextValue {\n  return isCatalogContextValue(catalog) ? catalog : basicCatalog;\n}\n\nfunction toJsonSchema(\n  schema: unknown,\n  options?: Parameters<typeof zodToJsonSchema>[1],\n): ReturnType<typeof zodToJsonSchema> {\n  return zodToJsonSchema(schema as ZodTypeAny, options);\n}\n\nfunction extendsBasicCatalog(catalog: CatalogContextValue): boolean {\n  for (const name of basicCatalog.components.keys()) {\n    if (!catalog.components.has(name)) {\n      return false;\n    }\n  }\n  return true;\n}\n\nfunction getCustomComponentNames(catalog: CatalogContextValue): string[] {\n  const custom: string[] = [];\n  for (const name of catalog.components.keys()) {\n    if (!basicCatalog.components.has(name)) {\n      custom.push(name);\n    }\n  }\n  return custom;\n}\n\nexport function buildCatalogContextValue(catalog?: unknown): string {\n  const resolved = resolveCatalog(catalog);\n  const lines: string[] = [\"Available A2UI catalog:\"];\n\n  if (resolved.id === BASIC_CATALOG_ID) {\n    lines.push(`- ${resolved.id} (basic catalog)`);\n    return lines.join(\"\\n\");\n  }\n\n  const isSuperset = extendsBasicCatalog(resolved);\n  const customNames = getCustomComponentNames(resolved);\n\n  lines.push(`- ${resolved.id}`);\n  if (isSuperset) {\n    lines.push(\n      \"  Extends the basic catalog with all standard components plus:\",\n    );\n  } else {\n    lines.push(\"  Custom catalog (does NOT include all basic components).\");\n    lines.push(\"  Custom components:\");\n  }\n\n  for (const name of customNames) {\n    const component = resolved.components.get(name);\n    if (!component) continue;\n    const jsonSchema = toJsonSchema(component.schema);\n    lines.push(`  - ${name}:`);\n    lines.push(\n      `    ${JSON.stringify(jsonSchema, null, 2).split(\"\\n\").join(\"\\n    \")}`,\n    );\n  }\n\n  return lines.join(\"\\n\");\n}\n\nexport interface InlineCatalogSchema {\n  catalogId: string;\n  components: Record<string, Record<string, unknown>>;\n}\n\nexport function extractCatalogComponentSchemas(\n  catalog?: unknown,\n): InlineCatalogSchema {\n  const resolved = resolveCatalog(catalog);\n  const components: Record<string, Record<string, unknown>> = {};\n  for (const [name, comp] of resolved.components) {\n    const zodSchema = toJsonSchema(comp.schema, {\n      target: \"jsonSchema2019-09\",\n    }) as { properties?: Record<string, unknown>; required?: string[] };\n    components[name] = {\n      allOf: [\n        { $ref: \"common_types.json#/$defs/ComponentCommon\" },\n        {\n          properties: {\n            component: { const: name },\n            ...zodSchema.properties,\n          },\n          required: [\"component\", ...(zodSchema.required ?? [])],\n        },\n      ],\n    };\n  }\n  return { catalogId: resolved.id, components };\n}\n"],"mappings":"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"}

package/dist/web-components/define.cjs

@@ -0,0 +1,24 @@
+Object.defineProperty(exports, Symbol.toStringTag, { value: 'Module' });
+const require_bound_component = require('./bound-component.cjs');
+const require_node = require('./node.cjs');
+const require_surface = require('./surface.cjs');
+
+//#region src/web-components/define.ts
+const CPK_A2UI_SURFACE_TAG = "cpk-a2ui-surface";
+const CPK_A2UI_NODE_TAG = "cpk-a2ui-node";
+const CPK_A2UI_BOUND_COMPONENT_TAG = "cpk-a2ui-bound-component";
+function defineA2UIWebComponents() {
+	if (!customElements.get(CPK_A2UI_BOUND_COMPONENT_TAG)) customElements.define(CPK_A2UI_BOUND_COMPONENT_TAG, require_bound_component.CpkA2uiBoundComponent);
+	if (!customElements.get(CPK_A2UI_NODE_TAG)) customElements.define(CPK_A2UI_NODE_TAG, require_node.CpkA2uiNode);
+	if (!customElements.get(CPK_A2UI_SURFACE_TAG)) customElements.define(CPK_A2UI_SURFACE_TAG, require_surface.CpkA2uiSurface);
+}
+
+//#endregion
+exports.CPK_A2UI_BOUND_COMPONENT_TAG = CPK_A2UI_BOUND_COMPONENT_TAG;
+exports.CPK_A2UI_NODE_TAG = CPK_A2UI_NODE_TAG;
+exports.CPK_A2UI_SURFACE_TAG = CPK_A2UI_SURFACE_TAG;
+exports.CpkA2uiBoundComponent = require_bound_component.CpkA2uiBoundComponent;
+exports.CpkA2uiNode = require_node.CpkA2uiNode;
+exports.CpkA2uiSurface = require_surface.CpkA2uiSurface;
+exports.defineA2UIWebComponents = defineA2UIWebComponents;
+//# sourceMappingURL=define.cjs.map

package/dist/web-components/define.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"define.cjs","names":["CpkA2uiBoundComponent","CpkA2uiNode","CpkA2uiSurface"],"sources":["../../src/web-components/define.ts"],"sourcesContent":["import { CpkA2uiBoundComponent } from \"./bound-component\";\nimport { CpkA2uiNode } from \"./node\";\nimport { CpkA2uiSurface } from \"./surface\";\n\nexport const CPK_A2UI_SURFACE_TAG = \"cpk-a2ui-surface\";\nexport const CPK_A2UI_NODE_TAG = \"cpk-a2ui-node\";\nexport const CPK_A2UI_BOUND_COMPONENT_TAG = \"cpk-a2ui-bound-component\";\n\nexport function defineA2UIWebComponents(): void {\n  if (!customElements.get(CPK_A2UI_BOUND_COMPONENT_TAG)) {\n    customElements.define(CPK_A2UI_BOUND_COMPONENT_TAG, CpkA2uiBoundComponent);\n  }\n  if (!customElements.get(CPK_A2UI_NODE_TAG)) {\n    customElements.define(CPK_A2UI_NODE_TAG, CpkA2uiNode);\n  }\n  if (!customElements.get(CPK_A2UI_SURFACE_TAG)) {\n    customElements.define(CPK_A2UI_SURFACE_TAG, CpkA2uiSurface);\n  }\n}\n\nexport { CpkA2uiSurface, CpkA2uiNode, CpkA2uiBoundComponent };\n\ndeclare global {\n  interface HTMLElementTagNameMap {\n    \"cpk-a2ui-surface\": CpkA2uiSurface;\n    \"cpk-a2ui-node\": CpkA2uiNode;\n    \"cpk-a2ui-bound-component\": CpkA2uiBoundComponent;\n  }\n}\n"],"mappings":";;;;;;AAIA,MAAa,uBAAuB;AACpC,MAAa,oBAAoB;AACjC,MAAa,+BAA+B;AAE5C,SAAgB,0BAAgC;AAC9C,KAAI,CAAC,eAAe,IAAI,6BAA6B,CACnD,gBAAe,OAAO,8BAA8BA,8CAAsB;AAE5E,KAAI,CAAC,eAAe,IAAI,kBAAkB,CACxC,gBAAe,OAAO,mBAAmBC,yBAAY;AAEvD,KAAI,CAAC,eAAe,IAAI,qBAAqB,CAC3C,gBAAe,OAAO,sBAAsBC,+BAAe"}

package/dist/web-components/define.d.cts

@@ -0,0 +1,19 @@
+import { CpkA2uiBoundComponent } from "./bound-component.cjs";
+import { CpkA2uiNode } from "./node.cjs";
+import { CpkA2uiSurface } from "./surface.cjs";
+
+//#region src/web-components/define.d.ts
+declare const CPK_A2UI_SURFACE_TAG = "cpk-a2ui-surface";
+declare const CPK_A2UI_NODE_TAG = "cpk-a2ui-node";
+declare const CPK_A2UI_BOUND_COMPONENT_TAG = "cpk-a2ui-bound-component";
+declare function defineA2UIWebComponents(): void;
+declare global {
+  interface HTMLElementTagNameMap {
+    "cpk-a2ui-surface": CpkA2uiSurface;
+    "cpk-a2ui-node": CpkA2uiNode;
+    "cpk-a2ui-bound-component": CpkA2uiBoundComponent;
+  }
+} //# sourceMappingURL=define.d.ts.map
+//#endregion
+export { CPK_A2UI_BOUND_COMPONENT_TAG, CPK_A2UI_NODE_TAG, CPK_A2UI_SURFACE_TAG, CpkA2uiBoundComponent, CpkA2uiNode, CpkA2uiSurface, defineA2UIWebComponents };
+//# sourceMappingURL=define.d.cts.map

package/dist/web-components/define.d.cts.map

@@ -0,0 +1 @@
+{"version":3,"file":"define.d.cts","names":[],"sources":["../../src/web-components/define.ts"],"mappings":";;;;;cAIa,oBAAA;AAAA,cACA,iBAAA;AAAA,cACA,4BAAA;AAAA,iBAEG,uBAAA,CAAA;AAAA,QAcR,MAAA;EAAA,UACI,qBAAA;IACR,kBAAA,EAAoB,cAAA;IACpB,eAAA,EAAiB,WAAA;IACjB,0BAAA,EAA4B,qBAAA;EAAA;AAAA"}

package/dist/web-components/define.d.mts

@@ -0,0 +1,19 @@
+import { CpkA2uiBoundComponent } from "./bound-component.mjs";
+import { CpkA2uiNode } from "./node.mjs";
+import { CpkA2uiSurface } from "./surface.mjs";
+
+//#region src/web-components/define.d.ts
+declare const CPK_A2UI_SURFACE_TAG = "cpk-a2ui-surface";
+declare const CPK_A2UI_NODE_TAG = "cpk-a2ui-node";
+declare const CPK_A2UI_BOUND_COMPONENT_TAG = "cpk-a2ui-bound-component";
+declare function defineA2UIWebComponents(): void;
+declare global {
+  interface HTMLElementTagNameMap {
+    "cpk-a2ui-surface": CpkA2uiSurface;
+    "cpk-a2ui-node": CpkA2uiNode;
+    "cpk-a2ui-bound-component": CpkA2uiBoundComponent;
+  }
+} //# sourceMappingURL=define.d.ts.map
+//#endregion
+export { CPK_A2UI_BOUND_COMPONENT_TAG, CPK_A2UI_NODE_TAG, CPK_A2UI_SURFACE_TAG, CpkA2uiBoundComponent, CpkA2uiNode, CpkA2uiSurface, defineA2UIWebComponents };
+//# sourceMappingURL=define.d.mts.map

package/dist/web-components/define.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"define.d.mts","names":[],"sources":["../../src/web-components/define.ts"],"mappings":";;;;;cAIa,oBAAA;AAAA,cACA,iBAAA;AAAA,cACA,4BAAA;AAAA,iBAEG,uBAAA,CAAA;AAAA,QAcR,MAAA;EAAA,UACI,qBAAA;IACR,kBAAA,EAAoB,cAAA;IACpB,eAAA,EAAiB,WAAA;IACjB,0BAAA,EAA4B,qBAAA;EAAA;AAAA"}

package/dist/web-components/define.mjs

@@ -0,0 +1,17 @@
+import { CpkA2uiBoundComponent } from "./bound-component.mjs";
+import { CpkA2uiNode } from "./node.mjs";
+import { CpkA2uiSurface } from "./surface.mjs";
+
+//#region src/web-components/define.ts
+const CPK_A2UI_SURFACE_TAG = "cpk-a2ui-surface";
+const CPK_A2UI_NODE_TAG = "cpk-a2ui-node";
+const CPK_A2UI_BOUND_COMPONENT_TAG = "cpk-a2ui-bound-component";
+function defineA2UIWebComponents() {
+	if (!customElements.get(CPK_A2UI_BOUND_COMPONENT_TAG)) customElements.define(CPK_A2UI_BOUND_COMPONENT_TAG, CpkA2uiBoundComponent);
+	if (!customElements.get(CPK_A2UI_NODE_TAG)) customElements.define(CPK_A2UI_NODE_TAG, CpkA2uiNode);
+	if (!customElements.get(CPK_A2UI_SURFACE_TAG)) customElements.define(CPK_A2UI_SURFACE_TAG, CpkA2uiSurface);
+}
+
+//#endregion
+export { CPK_A2UI_BOUND_COMPONENT_TAG, CPK_A2UI_NODE_TAG, CPK_A2UI_SURFACE_TAG, CpkA2uiBoundComponent, CpkA2uiNode, CpkA2uiSurface, defineA2UIWebComponents };
+//# sourceMappingURL=define.mjs.map