@copilotkit/a2ui-renderer 1.55.0-next.9 → 1.55.0

package/dist/react-renderer/a2ui-react/index.cjs

@@ -0,0 +1,22 @@
+const require_A2uiSurface = require('./A2uiSurface.cjs');
+const require_adapter = require('./adapter.cjs');
+const require_Text = require('./catalog/basic/components/Text.cjs');
+const require_Image = require('./catalog/basic/components/Image.cjs');
+const require_Icon = require('./catalog/basic/components/Icon.cjs');
+const require_Video = require('./catalog/basic/components/Video.cjs');
+const require_AudioPlayer = require('./catalog/basic/components/AudioPlayer.cjs');
+const require_Row = require('./catalog/basic/components/Row.cjs');
+const require_Column = require('./catalog/basic/components/Column.cjs');
+const require_List = require('./catalog/basic/components/List.cjs');
+const require_Card = require('./catalog/basic/components/Card.cjs');
+const require_Tabs = require('./catalog/basic/components/Tabs.cjs');
+const require_Divider = require('./catalog/basic/components/Divider.cjs');
+const require_Modal = require('./catalog/basic/components/Modal.cjs');
+const require_Button = require('./catalog/basic/components/Button.cjs');
+const require_TextField = require('./catalog/basic/components/TextField.cjs');
+const require_CheckBox = require('./catalog/basic/components/CheckBox.cjs');
+const require_ChoicePicker = require('./catalog/basic/components/ChoicePicker.cjs');
+const require_Slider = require('./catalog/basic/components/Slider.cjs');
+const require_DateTimeInput = require('./catalog/basic/components/DateTimeInput.cjs');
+const require_index = require('./catalog/basic/index.cjs');
+require('./catalog/minimal/index.cjs');

package/dist/react-renderer/a2ui-react/index.d.cts

@@ -0,0 +1,4 @@
+import { ReactA2uiComponentProps, ReactComponentImplementation, createReactComponent } from "./adapter.cjs";
+import "./A2uiSurface.cjs";
+import { basicCatalog } from "./catalog/basic/index.cjs";
+import "./catalog/minimal/index.cjs";

package/dist/react-renderer/a2ui-react/index.d.mts

@@ -0,0 +1,4 @@
+import { ReactA2uiComponentProps, ReactComponentImplementation, createReactComponent } from "./adapter.mjs";
+import "./A2uiSurface.mjs";
+import { basicCatalog } from "./catalog/basic/index.mjs";
+import "./catalog/minimal/index.mjs";

package/dist/react-renderer/a2ui-react/index.mjs

@@ -0,0 +1,24 @@
+import { A2uiSurface, DeferredChild } from "./A2uiSurface.mjs";
+import { createReactComponent } from "./adapter.mjs";
+import { Text } from "./catalog/basic/components/Text.mjs";
+import { Image } from "./catalog/basic/components/Image.mjs";
+import { Icon } from "./catalog/basic/components/Icon.mjs";
+import { Video } from "./catalog/basic/components/Video.mjs";
+import { AudioPlayer } from "./catalog/basic/components/AudioPlayer.mjs";
+import { Row } from "./catalog/basic/components/Row.mjs";
+import { Column } from "./catalog/basic/components/Column.mjs";
+import { List } from "./catalog/basic/components/List.mjs";
+import { Card } from "./catalog/basic/components/Card.mjs";
+import { Tabs } from "./catalog/basic/components/Tabs.mjs";
+import { Divider } from "./catalog/basic/components/Divider.mjs";
+import { Modal } from "./catalog/basic/components/Modal.mjs";
+import { Button } from "./catalog/basic/components/Button.mjs";
+import { TextField } from "./catalog/basic/components/TextField.mjs";
+import { CheckBox } from "./catalog/basic/components/CheckBox.mjs";
+import { ChoicePicker } from "./catalog/basic/components/ChoicePicker.mjs";
+import { Slider } from "./catalog/basic/components/Slider.mjs";
+import { DateTimeInput } from "./catalog/basic/components/DateTimeInput.mjs";
+import { basicCatalog } from "./catalog/basic/index.mjs";
+import "./catalog/minimal/index.mjs";
+
+export {  };

package/dist/react-renderer/catalog-utils.cjs

@@ -0,0 +1,84 @@
+const require_runtime = require('../_virtual/_rolldown/runtime.cjs');
+const require_index = require('./a2ui-react/catalog/basic/index.cjs');
+require('./a2ui-react/index.cjs');
+let zod_to_json_schema = require("zod-to-json-schema");
+
+//#region src/react-renderer/catalog-utils.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 props when creating A2UI operations.";
+/**
+* Check whether a catalog is a superset of the basic catalog
+* (i.e., it contains all basic components by name).
+*/
+function extendsBasicCatalog(catalog) {
+	for (const name of require_index.basicCatalog.components.keys()) if (!catalog.components.has(name)) return false;
+	return true;
+}
+/**
+* Return the names of components in a catalog that are not in the basic catalog.
+*/
+function getCustomComponentNames(catalog) {
+	const custom = [];
+	for (const name of catalog.components.keys()) if (!require_index.basicCatalog.components.has(name)) custom.push(name);
+	return custom;
+}
+/**
+* Build a context string describing the available A2UI catalog and custom components.
+* Custom components (those not in the basic catalog) are described using their
+* JSON Schema representation, matching the canonical A2UI catalog format.
+*/
+function buildCatalogContextValue(catalog) {
+	const resolved = catalog ?? require_index.basicCatalog;
+	const lines = [];
+	lines.push("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 comp = resolved.components.get(name);
+		if (!comp) continue;
+		const jsonSchema = (0, zod_to_json_schema.zodToJsonSchema)(comp.schema);
+		lines.push(`  - ${name}:`);
+		lines.push(`    ${JSON.stringify(jsonSchema, null, 2).split("\n").join("\n    ")}`);
+	}
+	return lines.join("\n");
+}
+/**
+* Extract component schemas from a catalog in the same format used by
+* the A2UI middleware (`A2UIComponentSchema[]`). Each component's Zod
+* schema is converted to JSON Schema via zod-to-json-schema.
+*
+* When sent via `useAgentContext` with `A2UI_SCHEMA_CONTEXT_DESCRIPTION`,
+* the middleware can optionally overwrite it with a server-side schema.
+*/
+function extractCatalogComponentSchemas(catalog) {
+	const resolved = catalog ?? require_index.basicCatalog;
+	const schemas = [];
+	for (const [name, comp] of resolved.components) schemas.push({
+		name,
+		props: (0, zod_to_json_schema.zodToJsonSchema)(comp.schema, { target: "openApi3" })
+	});
+	return schemas;
+}
+
+//#endregion
+exports.A2UI_SCHEMA_CONTEXT_DESCRIPTION = A2UI_SCHEMA_CONTEXT_DESCRIPTION;
+exports.buildCatalogContextValue = buildCatalogContextValue;
+exports.extendsBasicCatalog = extendsBasicCatalog;
+exports.extractCatalogComponentSchemas = extractCatalogComponentSchemas;
+exports.getCustomComponentNames = getCustomComponentNames;
+//# sourceMappingURL=catalog-utils.cjs.map

package/dist/react-renderer/catalog-utils.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"catalog-utils.cjs","names":["basicCatalog"],"sources":["../../src/react-renderer/catalog-utils.ts"],"sourcesContent":["import { basicCatalog } from \"./a2ui-react\";\nimport type { ComponentApi, Catalog } from \"@a2ui/web_core/v0_9\";\nimport { zodToJsonSchema } from \"zod-to-json-schema\";\n\nconst BASIC_CATALOG_ID =\n  \"https://a2ui.org/specification/v0_9/basic_catalog.json\";\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 props when creating A2UI operations.\";\n\n/**\n * Check whether a catalog is a superset of the basic catalog\n * (i.e., it contains all basic components by name).\n */\nexport function extendsBasicCatalog(catalog: Catalog<ComponentApi>): 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\n/**\n * Return the names of components in a catalog that are not in the basic catalog.\n */\nexport function getCustomComponentNames(\n  catalog: Catalog<ComponentApi>,\n): 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\n/**\n * Build a context string describing the available A2UI catalog and custom components.\n * Custom components (those not in the basic catalog) are described using their\n * JSON Schema representation, matching the canonical A2UI catalog format.\n */\nexport function buildCatalogContextValue(\n  catalog?: Catalog<ComponentApi>,\n): string {\n  const resolved = catalog ?? basicCatalog;\n  const lines: string[] = [];\n  lines.push(\"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 comp = resolved.components.get(name);\n    if (!comp) continue;\n    const jsonSchema = zodToJsonSchema(comp.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\n/**\n * Extract component schemas from a catalog in the same format used by\n * the A2UI middleware (`A2UIComponentSchema[]`). Each component's Zod\n * schema is converted to JSON Schema via zod-to-json-schema.\n *\n * When sent via `useAgentContext` with `A2UI_SCHEMA_CONTEXT_DESCRIPTION`,\n * the middleware can optionally overwrite it with a server-side schema.\n */\nexport function extractCatalogComponentSchemas(\n  catalog?: Catalog<ComponentApi>,\n): Array<{ name: string; props: Record<string, unknown> }> {\n  const resolved = catalog ?? basicCatalog;\n  const schemas: Array<{ name: string; props: Record<string, unknown> }> = [];\n\n  for (const [name, comp] of resolved.components) {\n    schemas.push({\n      name,\n      props: zodToJsonSchema(comp.schema, { target: \"openApi3\" }) as Record<\n        string,\n        unknown\n      >,\n    });\n  }\n\n  return schemas;\n}\n"],"mappings":";;;;;;AAIA,MAAM,mBACJ;;;;;;AAOF,MAAa,kCACX;;;;;AAMF,SAAgB,oBAAoB,SAAyC;AAC3E,MAAK,MAAM,QAAQA,2BAAa,WAAW,MAAM,CAC/C,KAAI,CAAC,QAAQ,WAAW,IAAI,KAAK,CAC/B,QAAO;AAGX,QAAO;;;;;AAMT,SAAgB,wBACd,SACU;CACV,MAAM,SAAmB,EAAE;AAC3B,MAAK,MAAM,QAAQ,QAAQ,WAAW,MAAM,CAC1C,KAAI,CAACA,2BAAa,WAAW,IAAI,KAAK,CACpC,QAAO,KAAK,KAAK;AAGrB,QAAO;;;;;;;AAQT,SAAgB,yBACd,SACQ;CACR,MAAM,WAAW,WAAWA;CAC5B,MAAM,QAAkB,EAAE;AAC1B,OAAM,KAAK,0BAA0B;AAErC,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,OAAO,SAAS,WAAW,IAAI,KAAK;AAC1C,MAAI,CAAC,KAAM;EACX,MAAM,qDAA6B,KAAK,OAAO;AAC/C,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;;;;;;;;;;AAWzB,SAAgB,+BACd,SACyD;CACzD,MAAM,WAAW,WAAWA;CAC5B,MAAM,UAAmE,EAAE;AAE3E,MAAK,MAAM,CAAC,MAAM,SAAS,SAAS,WAClC,SAAQ,KAAK;EACX;EACA,+CAAuB,KAAK,QAAQ,EAAE,QAAQ,YAAY,CAAC;EAI5D,CAAC;AAGJ,QAAO"}

package/dist/react-renderer/catalog-utils.d.cts

@@ -0,0 +1,39 @@
+import { Catalog, ComponentApi } from "@a2ui/web_core/v0_9";
+
+//#region src/react-renderer/catalog-utils.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 props when creating A2UI operations.";
+/**
+ * Check whether a catalog is a superset of the basic catalog
+ * (i.e., it contains all basic components by name).
+ */
+declare function extendsBasicCatalog(catalog: Catalog<ComponentApi>): boolean;
+/**
+ * Return the names of components in a catalog that are not in the basic catalog.
+ */
+declare function getCustomComponentNames(catalog: Catalog<ComponentApi>): string[];
+/**
+ * Build a context string describing the available A2UI catalog and custom components.
+ * Custom components (those not in the basic catalog) are described using their
+ * JSON Schema representation, matching the canonical A2UI catalog format.
+ */
+declare function buildCatalogContextValue(catalog?: Catalog<ComponentApi>): string;
+/**
+ * Extract component schemas from a catalog in the same format used by
+ * the A2UI middleware (`A2UIComponentSchema[]`). Each component's Zod
+ * schema is converted to JSON Schema via zod-to-json-schema.
+ *
+ * When sent via `useAgentContext` with `A2UI_SCHEMA_CONTEXT_DESCRIPTION`,
+ * the middleware can optionally overwrite it with a server-side schema.
+ */
+declare function extractCatalogComponentSchemas(catalog?: Catalog<ComponentApi>): Array<{
+  name: string;
+  props: Record<string, unknown>;
+}>;
+//#endregion
+export { A2UI_SCHEMA_CONTEXT_DESCRIPTION, buildCatalogContextValue, extendsBasicCatalog, extractCatalogComponentSchemas, getCustomComponentNames };
+//# sourceMappingURL=catalog-utils.d.cts.map

package/dist/react-renderer/catalog-utils.d.cts.map

@@ -0,0 +1 @@
+{"version":3,"file":"catalog-utils.d.cts","names":[],"sources":["../../src/react-renderer/catalog-utils.ts"],"mappings":";;;;;AAYA;;;cAAa,+BAAA;;AAOb;;;iBAAgB,mBAAA,CAAoB,OAAA,EAAS,OAAA,CAAQ,YAAA;;;;iBAYrC,uBAAA,CACd,OAAA,EAAS,OAAA,CAAQ,YAAA;;AADnB;;;;iBAiBgB,wBAAA,CACd,OAAA,GAAU,OAAA,CAAQ,YAAA;;;;;AADpB;;;;iBA8CgB,8BAAA,CACd,OAAA,GAAU,OAAA,CAAQ,YAAA,IACjB,KAAA;EAAQ,IAAA;EAAc,KAAA,EAAO,MAAA;AAAA"}

package/dist/react-renderer/catalog-utils.d.mts

@@ -0,0 +1,39 @@
+import { Catalog, ComponentApi } from "@a2ui/web_core/v0_9";
+
+//#region src/react-renderer/catalog-utils.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 props when creating A2UI operations.";
+/**
+ * Check whether a catalog is a superset of the basic catalog
+ * (i.e., it contains all basic components by name).
+ */
+declare function extendsBasicCatalog(catalog: Catalog<ComponentApi>): boolean;
+/**
+ * Return the names of components in a catalog that are not in the basic catalog.
+ */
+declare function getCustomComponentNames(catalog: Catalog<ComponentApi>): string[];
+/**
+ * Build a context string describing the available A2UI catalog and custom components.
+ * Custom components (those not in the basic catalog) are described using their
+ * JSON Schema representation, matching the canonical A2UI catalog format.
+ */
+declare function buildCatalogContextValue(catalog?: Catalog<ComponentApi>): string;
+/**
+ * Extract component schemas from a catalog in the same format used by
+ * the A2UI middleware (`A2UIComponentSchema[]`). Each component's Zod
+ * schema is converted to JSON Schema via zod-to-json-schema.
+ *
+ * When sent via `useAgentContext` with `A2UI_SCHEMA_CONTEXT_DESCRIPTION`,
+ * the middleware can optionally overwrite it with a server-side schema.
+ */
+declare function extractCatalogComponentSchemas(catalog?: Catalog<ComponentApi>): Array<{
+  name: string;
+  props: Record<string, unknown>;
+}>;
+//#endregion
+export { A2UI_SCHEMA_CONTEXT_DESCRIPTION, buildCatalogContextValue, extendsBasicCatalog, extractCatalogComponentSchemas, getCustomComponentNames };
+//# sourceMappingURL=catalog-utils.d.mts.map

package/dist/react-renderer/catalog-utils.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"catalog-utils.d.mts","names":[],"sources":["../../src/react-renderer/catalog-utils.ts"],"mappings":";;;;;AAYA;;;cAAa,+BAAA;;AAOb;;;iBAAgB,mBAAA,CAAoB,OAAA,EAAS,OAAA,CAAQ,YAAA;;;;iBAYrC,uBAAA,CACd,OAAA,EAAS,OAAA,CAAQ,YAAA;;AADnB;;;;iBAiBgB,wBAAA,CACd,OAAA,GAAU,OAAA,CAAQ,YAAA;;;;;AADpB;;;;iBA8CgB,8BAAA,CACd,OAAA,GAAU,OAAA,CAAQ,YAAA,IACjB,KAAA;EAAQ,IAAA;EAAc,KAAA,EAAO,MAAA;AAAA"}

package/dist/react-renderer/catalog-utils.mjs

@@ -0,0 +1,79 @@
+import { basicCatalog } from "./a2ui-react/catalog/basic/index.mjs";
+import "./a2ui-react/index.mjs";
+import { zodToJsonSchema } from "zod-to-json-schema";
+
+//#region src/react-renderer/catalog-utils.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 props when creating A2UI operations.";
+/**
+* Check whether a catalog is a superset of the basic catalog
+* (i.e., it contains all basic components by name).
+*/
+function extendsBasicCatalog(catalog) {
+	for (const name of basicCatalog.components.keys()) if (!catalog.components.has(name)) return false;
+	return true;
+}
+/**
+* Return the names of components in a catalog that are not in the basic catalog.
+*/
+function getCustomComponentNames(catalog) {
+	const custom = [];
+	for (const name of catalog.components.keys()) if (!basicCatalog.components.has(name)) custom.push(name);
+	return custom;
+}
+/**
+* Build a context string describing the available A2UI catalog and custom components.
+* Custom components (those not in the basic catalog) are described using their
+* JSON Schema representation, matching the canonical A2UI catalog format.
+*/
+function buildCatalogContextValue(catalog) {
+	const resolved = catalog ?? basicCatalog;
+	const lines = [];
+	lines.push("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 comp = resolved.components.get(name);
+		if (!comp) continue;
+		const jsonSchema = zodToJsonSchema(comp.schema);
+		lines.push(`  - ${name}:`);
+		lines.push(`    ${JSON.stringify(jsonSchema, null, 2).split("\n").join("\n    ")}`);
+	}
+	return lines.join("\n");
+}
+/**
+* Extract component schemas from a catalog in the same format used by
+* the A2UI middleware (`A2UIComponentSchema[]`). Each component's Zod
+* schema is converted to JSON Schema via zod-to-json-schema.
+*
+* When sent via `useAgentContext` with `A2UI_SCHEMA_CONTEXT_DESCRIPTION`,
+* the middleware can optionally overwrite it with a server-side schema.
+*/
+function extractCatalogComponentSchemas(catalog) {
+	const resolved = catalog ?? basicCatalog;
+	const schemas = [];
+	for (const [name, comp] of resolved.components) schemas.push({
+		name,
+		props: zodToJsonSchema(comp.schema, { target: "openApi3" })
+	});
+	return schemas;
+}
+
+//#endregion
+export { A2UI_SCHEMA_CONTEXT_DESCRIPTION, buildCatalogContextValue, extendsBasicCatalog, extractCatalogComponentSchemas, getCustomComponentNames };
+//# sourceMappingURL=catalog-utils.mjs.map

package/dist/react-renderer/catalog-utils.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"catalog-utils.mjs","names":[],"sources":["../../src/react-renderer/catalog-utils.ts"],"sourcesContent":["import { basicCatalog } from \"./a2ui-react\";\nimport type { ComponentApi, Catalog } from \"@a2ui/web_core/v0_9\";\nimport { zodToJsonSchema } from \"zod-to-json-schema\";\n\nconst BASIC_CATALOG_ID =\n  \"https://a2ui.org/specification/v0_9/basic_catalog.json\";\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 props when creating A2UI operations.\";\n\n/**\n * Check whether a catalog is a superset of the basic catalog\n * (i.e., it contains all basic components by name).\n */\nexport function extendsBasicCatalog(catalog: Catalog<ComponentApi>): 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\n/**\n * Return the names of components in a catalog that are not in the basic catalog.\n */\nexport function getCustomComponentNames(\n  catalog: Catalog<ComponentApi>,\n): 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\n/**\n * Build a context string describing the available A2UI catalog and custom components.\n * Custom components (those not in the basic catalog) are described using their\n * JSON Schema representation, matching the canonical A2UI catalog format.\n */\nexport function buildCatalogContextValue(\n  catalog?: Catalog<ComponentApi>,\n): string {\n  const resolved = catalog ?? basicCatalog;\n  const lines: string[] = [];\n  lines.push(\"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 comp = resolved.components.get(name);\n    if (!comp) continue;\n    const jsonSchema = zodToJsonSchema(comp.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\n/**\n * Extract component schemas from a catalog in the same format used by\n * the A2UI middleware (`A2UIComponentSchema[]`). Each component's Zod\n * schema is converted to JSON Schema via zod-to-json-schema.\n *\n * When sent via `useAgentContext` with `A2UI_SCHEMA_CONTEXT_DESCRIPTION`,\n * the middleware can optionally overwrite it with a server-side schema.\n */\nexport function extractCatalogComponentSchemas(\n  catalog?: Catalog<ComponentApi>,\n): Array<{ name: string; props: Record<string, unknown> }> {\n  const resolved = catalog ?? basicCatalog;\n  const schemas: Array<{ name: string; props: Record<string, unknown> }> = [];\n\n  for (const [name, comp] of resolved.components) {\n    schemas.push({\n      name,\n      props: zodToJsonSchema(comp.schema, { target: \"openApi3\" }) as Record<\n        string,\n        unknown\n      >,\n    });\n  }\n\n  return schemas;\n}\n"],"mappings":";;;;;AAIA,MAAM,mBACJ;;;;;;AAOF,MAAa,kCACX;;;;;AAMF,SAAgB,oBAAoB,SAAyC;AAC3E,MAAK,MAAM,QAAQ,aAAa,WAAW,MAAM,CAC/C,KAAI,CAAC,QAAQ,WAAW,IAAI,KAAK,CAC/B,QAAO;AAGX,QAAO;;;;;AAMT,SAAgB,wBACd,SACU;CACV,MAAM,SAAmB,EAAE;AAC3B,MAAK,MAAM,QAAQ,QAAQ,WAAW,MAAM,CAC1C,KAAI,CAAC,aAAa,WAAW,IAAI,KAAK,CACpC,QAAO,KAAK,KAAK;AAGrB,QAAO;;;;;;;AAQT,SAAgB,yBACd,SACQ;CACR,MAAM,WAAW,WAAW;CAC5B,MAAM,QAAkB,EAAE;AAC1B,OAAM,KAAK,0BAA0B;AAErC,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,OAAO,SAAS,WAAW,IAAI,KAAK;AAC1C,MAAI,CAAC,KAAM;EACX,MAAM,aAAa,gBAAgB,KAAK,OAAO;AAC/C,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;;;;;;;;;;AAWzB,SAAgB,+BACd,SACyD;CACzD,MAAM,WAAW,WAAW;CAC5B,MAAM,UAAmE,EAAE;AAE3E,MAAK,MAAM,CAAC,MAAM,SAAS,SAAS,WAClC,SAAQ,KAAK;EACX;EACA,OAAO,gBAAgB,KAAK,QAAQ,EAAE,QAAQ,YAAY,CAAC;EAI5D,CAAC;AAGJ,QAAO"}

package/dist/react-renderer/core/A2UIProvider.cjs

@@ -1,85 +1,78 @@
 const require_runtime = require('../../_virtual/_rolldown/runtime.cjs');
+const require_index = require('../a2ui-react/catalog/basic/index.cjs');
+require('../a2ui-react/index.cjs');
 const require_ThemeContext = require('../theme/ThemeContext.cjs');
 let react = require("react");
-let _a2ui_lit_0_8 = require("@a2ui/lit/0.8");
+let _a2ui_web_core_v0_9 = require("@a2ui/web_core/v0_9");
 let react_jsx_runtime = require("react/jsx-runtime");
 
 //#region src/react-renderer/core/A2UIProvider.tsx
 /**
 * Context for stable actions (never changes reference, prevents re-renders).
-* Components that only need to dispatch actions or read data won't re-render.
 */
 const A2UIActionsContext = (0, react.createContext)(null);
 /**
 * Context for reactive state (changes trigger re-renders).
-* Only components that need to react to state changes subscribe to this.
 */
 const A2UIStateContext = (0, react.createContext)(null);
 /**
-* Provider component that sets up the A2UI context for descendant components.
-*
-* This provider uses a two-context architecture for performance:
+* Provider component that sets up the A2UI v0.9 context for descendant components.
+* Uses a two-context architecture for performance:
 * - A2UIActionsContext: Stable actions that never change (no re-renders)
 * - A2UIStateContext: Reactive state that triggers re-renders when needed
-*
-* @example
-* ```tsx
-* function App() {
-*   const handleAction = async (message) => {
-*     const response = await fetch('/api/a2ui', {
-*       method: 'POST',
-*       body: JSON.stringify(message)
-*     });
-*     const newMessages = await response.json();
-*   };
-*
-*   return (
-*     <A2UIProvider onAction={handleAction}>
-*       <A2UIRenderer surfaceId="main" />
-*     </A2UIProvider>
-*   );
-* }
-* ```
 */
-function A2UIProvider({ onAction, theme, children }) {
+function A2UIProvider({ onAction, theme, catalog, children }) {
+	const onActionRef = (0, react.useRef)(onAction ?? null);
+	onActionRef.current = onAction ?? null;
 	const processorRef = (0, react.useRef)(null);
-	if (!processorRef.current) processorRef.current = _a2ui_lit_0_8.Data.createSignalA2uiMessageProcessor();
+	if (!processorRef.current) processorRef.current = new _a2ui_web_core_v0_9.MessageProcessor([catalog ?? require_index.basicCatalog], (action) => {
+		if (onActionRef.current) {
+			const message = { userAction: {
+				name: action?.name ?? "unknown",
+				surfaceId: action?.surfaceId ?? "default",
+				sourceComponentId: action?.sourceComponentId,
+				context: action?.context,
+				timestamp: action?.timestamp ?? (/* @__PURE__ */ new Date()).toISOString()
+			} };
+			onActionRef.current(message);
+		}
+	});
 	const processor = processorRef.current;
 	const [version, setVersion] = (0, react.useState)(0);
-	const onActionRef = (0, react.useRef)(onAction ?? null);
-	onActionRef.current = onAction ?? null;
+	const [error, setError] = (0, react.useState)(null);
 	const actionsRef = (0, react.useRef)(null);
 	if (!actionsRef.current) actionsRef.current = {
 		processMessages: (messages) => {
-			processor.processMessages(messages);
-			setVersion((v) => v + 1);
-		},
-		setData: (node, path, value, surfaceId) => {
-			processor.setData(node, path, value, surfaceId);
+			try {
+				processor.processMessages(messages);
+			} catch (err) {
+				console.warn("[A2UI] processMessages error:", err);
+				setError(err instanceof Error ? err.message : String(err));
+				return;
+			}
+			setError(null);
 			setVersion((v) => v + 1);
 		},
 		dispatch: (message) => {
 			if (onActionRef.current) onActionRef.current(message);
 		},
-		clearSurfaces: () => {
-			processor.clearSurfaces();
-			setVersion((v) => v + 1);
-		},
 		getSurface: (surfaceId) => {
-			return processor.getSurfaces().get(surfaceId);
-		},
-		getSurfaces: () => {
-			return processor.getSurfaces();
+			return processor.model.getSurface(surfaceId);
 		},
-		getData: (node, path, surfaceId) => {
-			return processor.getData(node, path, surfaceId);
-		},
-		resolvePath: (path, dataContextPath) => {
-			return processor.resolvePath(path, dataContextPath);
+		clearSurfaces: () => {
+			const surfaces = processor.model.surfacesMap;
+			for (const [id] of surfaces) processor.processMessages([{
+				version: "v0.9",
+				deleteSurface: { surfaceId: id }
+			}]);
+			setVersion((v) => v + 1);
 		}
 	};
 	const actions = actionsRef.current;
-	const stateValue = (0, react.useMemo)(() => ({ version }), [version]);
+	const stateValue = (0, react.useMemo)(() => ({
+		version,
+		error
+	}), [version, error]);
 	return /* @__PURE__ */ (0, react_jsx_runtime.jsx)(A2UIActionsContext.Provider, {
 		value: actions,
 		children: /* @__PURE__ */ (0, react_jsx_runtime.jsx)(A2UIStateContext.Provider, {
@@ -93,10 +86,6 @@ function A2UIProvider({ onAction, theme, children }) {
 }
 /**
 * Hook to access stable A2UI actions (won't cause re-renders).
-* Use this when you only need to dispatch actions or read data.
-*
-* @returns Stable actions object
-* @throws If used outside of an A2UIProvider
 */
 function useA2UIActions() {
 	const actions = (0, react.useContext)(A2UIActionsContext);
@@ -105,10 +94,6 @@ function useA2UIActions() {
 }
 /**
 * Hook to subscribe to A2UI state changes.
-* Components using this will re-render when state changes.
-*
-* @returns Current version number
-* @throws If used outside of an A2UIProvider
 */
 function useA2UIState() {
 	const state = (0, react.useContext)(A2UIStateContext);
@@ -117,33 +102,25 @@ function useA2UIState() {
 }
 /**
 * Hook to access the full A2UI context (actions + state).
-* Components using this will re-render when state changes.
-*
-* @returns The A2UI context value
-* @throws If used outside of an A2UIProvider
 */
 function useA2UIContext() {
 	const actions = useA2UIActions();
 	const state = useA2UIState();
 	return (0, react.useMemo)(() => ({
 		...actions,
-		processor: null,
 		version: state.version,
 		onAction: null
 	}), [actions, state.version]);
 }
-/**
-* @deprecated Use useA2UIContext instead. This alias exists for backward compatibility only.
-*/
+/** @deprecated Use useA2UIContext instead. */
 const useA2UIStore = useA2UIContext;
 /**
-* @deprecated This selector pattern does not provide performance benefits with React Context.
-* Components will re-render on any context change regardless of what you select.
-* Use useA2UIContext() or useA2UI() directly instead.
-*
-* @param selector - Function to select a slice of state
-* @returns The selected state
+* Hook to access the current A2UI error state.
 */
+function useA2UIError() {
+	return (0, react.useContext)(A2UIStateContext)?.error ?? null;
+}
+/** @deprecated Use useA2UIContext() or useA2UI() directly instead. */
 function useA2UIStoreSelector(selector) {
 	return selector(useA2UIContext());
 }
@@ -152,6 +129,7 @@ function useA2UIStoreSelector(selector) {
 exports.A2UIProvider = A2UIProvider;
 exports.useA2UIActions = useA2UIActions;
 exports.useA2UIContext = useA2UIContext;
+exports.useA2UIError = useA2UIError;
 exports.useA2UIState = useA2UIState;
 exports.useA2UIStore = useA2UIStore;
 exports.useA2UIStoreSelector = useA2UIStoreSelector;

package/dist/react-renderer/core/A2UIProvider.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"A2UIProvider.cjs","names":["Data","ThemeProvider"],"sources":["../../../src/react-renderer/core/A2UIProvider.tsx"],"sourcesContent":["import {\n  createContext,\n  useContext,\n  useRef,\n  useState,\n  useMemo,\n  type ReactNode,\n} from \"react\";\nimport { Data, type Types } from \"@a2ui/lit/0.8\";\nimport type { A2UIContextValue, A2UIActions } from \"./store\";\nimport { ThemeProvider } from \"../theme/ThemeContext\";\nimport type { OnActionCallback } from \"../types\";\n\n/**\n * Context for stable actions (never changes reference, prevents re-renders).\n * Components that only need to dispatch actions or read data won't re-render.\n */\nconst A2UIActionsContext = createContext<A2UIActions | null>(null);\n\n/**\n * Context for reactive state (changes trigger re-renders).\n * Only components that need to react to state changes subscribe to this.\n */\nconst A2UIStateContext = createContext<{ version: number } | null>(null);\n\n/**\n * Props for the A2UIProvider component.\n */\nexport interface A2UIProviderProps {\n  /** Callback invoked when a user action is dispatched (button click, etc.) */\n  onAction?: OnActionCallback;\n  /** Theme configuration. Falls back to default theme if not provided. */\n  theme?: Types.Theme;\n  /** Child components */\n  children: ReactNode;\n}\n\n/**\n * Provider component that sets up the A2UI context for descendant components.\n *\n * This provider uses a two-context architecture for performance:\n * - A2UIActionsContext: Stable actions that never change (no re-renders)\n * - A2UIStateContext: Reactive state that triggers re-renders when needed\n *\n * @example\n * ```tsx\n * function App() {\n *   const handleAction = async (message) => {\n *     const response = await fetch('/api/a2ui', {\n *       method: 'POST',\n *       body: JSON.stringify(message)\n *     });\n *     const newMessages = await response.json();\n *   };\n *\n *   return (\n *     <A2UIProvider onAction={handleAction}>\n *       <A2UIRenderer surfaceId=\"main\" />\n *     </A2UIProvider>\n *   );\n * }\n * ```\n */\nexport function A2UIProvider({ onAction, theme, children }: A2UIProviderProps) {\n  // Create message processor only once using ref\n  const processorRef = useRef<Types.MessageProcessor | null>(null);\n  if (!processorRef.current) {\n    processorRef.current = Data.createSignalA2uiMessageProcessor();\n  }\n  const processor = processorRef.current;\n\n  // Version counter for triggering re-renders\n  const [version, setVersion] = useState(0);\n\n  // Store onAction in a ref so callbacks always have the latest value\n  const onActionRef = useRef<OnActionCallback | null>(onAction ?? null);\n  onActionRef.current = onAction ?? null;\n\n  // Create stable actions object once - stored in ref, never changes\n  const actionsRef = useRef<A2UIActions | null>(null);\n  if (!actionsRef.current) {\n    actionsRef.current = {\n      processMessages: (messages: Types.ServerToClientMessage[]) => {\n        processor.processMessages(messages);\n        setVersion((v) => v + 1);\n      },\n\n      setData: (\n        node: Types.AnyComponentNode | null,\n        path: string,\n        value: Types.DataValue,\n        surfaceId: string,\n      ) => {\n        processor.setData(node, path, value, surfaceId);\n        setVersion((v) => v + 1);\n      },\n\n      dispatch: (message: Types.A2UIClientEventMessage) => {\n        if (onActionRef.current) {\n          onActionRef.current(message);\n        }\n      },\n\n      clearSurfaces: () => {\n        processor.clearSurfaces();\n        setVersion((v) => v + 1);\n      },\n\n      getSurface: (surfaceId: string) => {\n        return processor.getSurfaces().get(surfaceId);\n      },\n\n      getSurfaces: () => {\n        return processor.getSurfaces();\n      },\n\n      getData: (\n        node: Types.AnyComponentNode,\n        path: string,\n        surfaceId: string,\n      ) => {\n        return processor.getData(node, path, surfaceId);\n      },\n\n      resolvePath: (path: string, dataContextPath?: string) => {\n        return processor.resolvePath(path, dataContextPath);\n      },\n    };\n  }\n  const actions = actionsRef.current;\n\n  // State context value - only changes when version changes\n  const stateValue = useMemo(() => ({ version }), [version]);\n\n  return (\n    <A2UIActionsContext.Provider value={actions}>\n      <A2UIStateContext.Provider value={stateValue}>\n        <ThemeProvider theme={theme}>{children}</ThemeProvider>\n      </A2UIStateContext.Provider>\n    </A2UIActionsContext.Provider>\n  );\n}\n\n/**\n * Hook to access stable A2UI actions (won't cause re-renders).\n * Use this when you only need to dispatch actions or read data.\n *\n * @returns Stable actions object\n * @throws If used outside of an A2UIProvider\n */\nexport function useA2UIActions(): A2UIActions {\n  const actions = useContext(A2UIActionsContext);\n  if (!actions) {\n    throw new Error(\"useA2UIActions must be used within an A2UIProvider\");\n  }\n  return actions;\n}\n\n/**\n * Hook to subscribe to A2UI state changes.\n * Components using this will re-render when state changes.\n *\n * @returns Current version number\n * @throws If used outside of an A2UIProvider\n */\nexport function useA2UIState(): { version: number } {\n  const state = useContext(A2UIStateContext);\n  if (!state) {\n    throw new Error(\"useA2UIState must be used within an A2UIProvider\");\n  }\n  return state;\n}\n\n/**\n * Hook to access the full A2UI context (actions + state).\n * Components using this will re-render when state changes.\n *\n * @returns The A2UI context value\n * @throws If used outside of an A2UIProvider\n */\nexport function useA2UIContext(): A2UIContextValue {\n  const actions = useA2UIActions();\n  const state = useA2UIState();\n\n  // Memoize combined value - only changes when state changes\n  // Actions are stable, so this only re-creates when version changes\n  return useMemo(\n    () => ({\n      ...actions,\n      processor: null as unknown as Types.MessageProcessor, // Not exposed directly\n      version: state.version,\n      onAction: null, // Use dispatch instead\n    }),\n    [actions, state.version],\n  );\n}\n\n/**\n * @deprecated Use useA2UIContext instead. This alias exists for backward compatibility only.\n */\nexport const useA2UIStore = useA2UIContext;\n\n/**\n * @deprecated This selector pattern does not provide performance benefits with React Context.\n * Components will re-render on any context change regardless of what you select.\n * Use useA2UIContext() or useA2UI() directly instead.\n *\n * @param selector - Function to select a slice of state\n * @returns The selected state\n */\nexport function useA2UIStoreSelector<T>(\n  selector: (state: A2UIContextValue) => T,\n): T {\n  const context = useA2UIContext();\n  return selector(context);\n}\n"],"mappings":";;;;;;;;;;;AAiBA,MAAM,8CAAuD,KAAK;;;;;AAMlE,MAAM,4CAA6D,KAAK;;;;;;;;;;;;;;;;;;;;;;;;;;;AAwCxE,SAAgB,aAAa,EAAE,UAAU,OAAO,YAA+B;CAE7E,MAAM,iCAAqD,KAAK;AAChE,KAAI,CAAC,aAAa,QAChB,cAAa,UAAUA,mBAAK,kCAAkC;CAEhE,MAAM,YAAY,aAAa;CAG/B,MAAM,CAAC,SAAS,kCAAuB,EAAE;CAGzC,MAAM,gCAA8C,YAAY,KAAK;AACrE,aAAY,UAAU,YAAY;CAGlC,MAAM,+BAAwC,KAAK;AACnD,KAAI,CAAC,WAAW,QACd,YAAW,UAAU;EACnB,kBAAkB,aAA4C;AAC5D,aAAU,gBAAgB,SAAS;AACnC,eAAY,MAAM,IAAI,EAAE;;EAG1B,UACE,MACA,MACA,OACA,cACG;AACH,aAAU,QAAQ,MAAM,MAAM,OAAO,UAAU;AAC/C,eAAY,MAAM,IAAI,EAAE;;EAG1B,WAAW,YAA0C;AACnD,OAAI,YAAY,QACd,aAAY,QAAQ,QAAQ;;EAIhC,qBAAqB;AACnB,aAAU,eAAe;AACzB,eAAY,MAAM,IAAI,EAAE;;EAG1B,aAAa,cAAsB;AACjC,UAAO,UAAU,aAAa,CAAC,IAAI,UAAU;;EAG/C,mBAAmB;AACjB,UAAO,UAAU,aAAa;;EAGhC,UACE,MACA,MACA,cACG;AACH,UAAO,UAAU,QAAQ,MAAM,MAAM,UAAU;;EAGjD,cAAc,MAAc,oBAA6B;AACvD,UAAO,UAAU,YAAY,MAAM,gBAAgB;;EAEtD;CAEH,MAAM,UAAU,WAAW;CAG3B,MAAM,uCAA4B,EAAE,SAAS,GAAG,CAAC,QAAQ,CAAC;AAE1D,QACE,2CAAC,mBAAmB;EAAS,OAAO;YAClC,2CAAC,iBAAiB;GAAS,OAAO;aAChC,2CAACC;IAAqB;IAAQ;KAAyB;IAC7B;GACA;;;;;;;;;AAWlC,SAAgB,iBAA8B;CAC5C,MAAM,gCAAqB,mBAAmB;AAC9C,KAAI,CAAC,QACH,OAAM,IAAI,MAAM,qDAAqD;AAEvE,QAAO;;;;;;;;;AAUT,SAAgB,eAAoC;CAClD,MAAM,8BAAmB,iBAAiB;AAC1C,KAAI,CAAC,MACH,OAAM,IAAI,MAAM,mDAAmD;AAErE,QAAO;;;;;;;;;AAUT,SAAgB,iBAAmC;CACjD,MAAM,UAAU,gBAAgB;CAChC,MAAM,QAAQ,cAAc;AAI5B,kCACS;EACL,GAAG;EACH,WAAW;EACX,SAAS,MAAM;EACf,UAAU;EACX,GACD,CAAC,SAAS,MAAM,QAAQ,CACzB;;;;;AAMH,MAAa,eAAe;;;;;;;;;AAU5B,SAAgB,qBACd,UACG;AAEH,QAAO,SADS,gBAAgB,CACR"}
+{"version":3,"file":"A2UIProvider.cjs","names":["MessageProcessor","basicCatalog","ThemeProvider"],"sources":["../../../src/react-renderer/core/A2UIProvider.tsx"],"sourcesContent":["import {\n  createContext,\n  useContext,\n  useRef,\n  useState,\n  useMemo,\n  type ReactNode,\n} from \"react\";\nimport { MessageProcessor } from \"@a2ui/web_core/v0_9\";\nimport { basicCatalog } from \"../a2ui-react\";\nimport type { A2UIContextValue, A2UIActions } from \"./store\";\nimport { ThemeProvider } from \"../theme/ThemeContext\";\nimport type { OnActionCallback } from \"../types\";\nimport type { A2UIClientEventMessage, Theme } from \"../../a2ui-types\";\n\n/**\n * Context for stable actions (never changes reference, prevents re-renders).\n */\nconst A2UIActionsContext = createContext<A2UIActions | null>(null);\n\n/**\n * Context for reactive state (changes trigger re-renders).\n */\nconst A2UIStateContext = createContext<{\n  version: number;\n  error: string | null;\n} | null>(null);\n\n/**\n * Props for the A2UIProvider component.\n */\nexport interface A2UIProviderProps {\n  /** Callback invoked when a user action is dispatched (button click, etc.) */\n  onAction?: OnActionCallback;\n  /** Theme configuration */\n  theme?: Theme;\n  /** Optional component catalog to use instead of the default basicCatalog */\n  catalog?: any;\n  /** Child components */\n  children: ReactNode;\n}\n\n/**\n * Provider component that sets up the A2UI v0.9 context for descendant components.\n * Uses a two-context architecture for performance:\n * - A2UIActionsContext: Stable actions that never change (no re-renders)\n * - A2UIStateContext: Reactive state that triggers re-renders when needed\n */\nexport function A2UIProvider({\n  onAction,\n  theme,\n  catalog,\n  children,\n}: A2UIProviderProps) {\n  // Store onAction in a ref so callbacks always have the latest value\n  const onActionRef = useRef<OnActionCallback | null>(onAction ?? null);\n  onActionRef.current = onAction ?? null;\n\n  // Create v0.9 MessageProcessor only once using ref\n  const processorRef = useRef<MessageProcessor<any> | null>(null);\n  if (!processorRef.current) {\n    processorRef.current = new MessageProcessor(\n      [catalog ?? basicCatalog],\n      // Action handler: convert v0.9 Action to A2UIClientEventMessage format\n      (action: any) => {\n        if (onActionRef.current) {\n          const message: A2UIClientEventMessage = {\n            userAction: {\n              name: action?.name ?? \"unknown\",\n              surfaceId: action?.surfaceId ?? \"default\",\n              sourceComponentId: action?.sourceComponentId,\n              context: action?.context,\n              timestamp: action?.timestamp ?? new Date().toISOString(),\n            },\n          };\n          onActionRef.current(message);\n        }\n      },\n    );\n  }\n  const processor = processorRef.current;\n\n  // Version counter for triggering re-renders\n  const [version, setVersion] = useState(0);\n\n  // Error state for graceful error handling\n  const [error, setError] = useState<string | null>(null);\n\n  // Create stable actions object once - stored in ref, never changes\n  const actionsRef = useRef<A2UIActions | null>(null);\n  if (!actionsRef.current) {\n    actionsRef.current = {\n      processMessages: (messages: Array<Record<string, unknown>>) => {\n        try {\n          processor.processMessages(messages as any[]);\n        } catch (err) {\n          console.warn(\"[A2UI] processMessages error:\", err);\n          setError(err instanceof Error ? err.message : String(err));\n          return;\n        }\n        setError(null);\n        setVersion((v) => v + 1);\n      },\n\n      dispatch: (message: any) => {\n        if (onActionRef.current) {\n          onActionRef.current(message);\n        }\n      },\n\n      getSurface: (surfaceId: string) => {\n        return processor.model.getSurface(surfaceId);\n      },\n\n      clearSurfaces: () => {\n        // Process a deleteSurface for all known surfaces\n        const surfaces = processor.model.surfacesMap;\n        for (const [id] of surfaces) {\n          processor.processMessages([\n            { version: \"v0.9\", deleteSurface: { surfaceId: id } } as any,\n          ]);\n        }\n        setVersion((v) => v + 1);\n      },\n    };\n  }\n  const actions = actionsRef.current;\n\n  // State context value - changes when version or error changes\n  const stateValue = useMemo(() => ({ version, error }), [version, error]);\n\n  return (\n    <A2UIActionsContext.Provider value={actions}>\n      <A2UIStateContext.Provider value={stateValue}>\n        <ThemeProvider theme={theme}>{children}</ThemeProvider>\n      </A2UIStateContext.Provider>\n    </A2UIActionsContext.Provider>\n  );\n}\n\n/**\n * Hook to access stable A2UI actions (won't cause re-renders).\n */\nexport function useA2UIActions(): A2UIActions {\n  const actions = useContext(A2UIActionsContext);\n  if (!actions) {\n    throw new Error(\"useA2UIActions must be used within an A2UIProvider\");\n  }\n  return actions;\n}\n\n/**\n * Hook to subscribe to A2UI state changes.\n */\nexport function useA2UIState(): { version: number } {\n  const state = useContext(A2UIStateContext);\n  if (!state) {\n    throw new Error(\"useA2UIState must be used within an A2UIProvider\");\n  }\n  return state;\n}\n\n/**\n * Hook to access the full A2UI context (actions + state).\n */\nexport function useA2UIContext(): A2UIContextValue {\n  const actions = useA2UIActions();\n  const state = useA2UIState();\n\n  return useMemo(\n    () => ({\n      ...actions,\n      version: state.version,\n      onAction: null,\n    }),\n    [actions, state.version],\n  );\n}\n\n/** @deprecated Use useA2UIContext instead. */\nexport const useA2UIStore = useA2UIContext;\n\n/**\n * Hook to access the current A2UI error state.\n */\nexport function useA2UIError(): string | null {\n  const state = useContext(A2UIStateContext);\n  return state?.error ?? null;\n}\n\n/** @deprecated Use useA2UIContext() or useA2UI() directly instead. */\nexport function useA2UIStoreSelector<T>(\n  selector: (state: A2UIContextValue) => T,\n): T {\n  const context = useA2UIContext();\n  return selector(context);\n}\n"],"mappings":";;;;;;;;;;;;AAkBA,MAAM,8CAAuD,KAAK;;;;AAKlE,MAAM,4CAGI,KAAK;;;;;;;AAsBf,SAAgB,aAAa,EAC3B,UACA,OACA,SACA,YACoB;CAEpB,MAAM,gCAA8C,YAAY,KAAK;AACrE,aAAY,UAAU,YAAY;CAGlC,MAAM,iCAAoD,KAAK;AAC/D,KAAI,CAAC,aAAa,QAChB,cAAa,UAAU,IAAIA,qCACzB,CAAC,WAAWC,2BAAa,GAExB,WAAgB;AACf,MAAI,YAAY,SAAS;GACvB,MAAM,UAAkC,EACtC,YAAY;IACV,MAAM,QAAQ,QAAQ;IACtB,WAAW,QAAQ,aAAa;IAChC,mBAAmB,QAAQ;IAC3B,SAAS,QAAQ;IACjB,WAAW,QAAQ,8BAAa,IAAI,MAAM,EAAC,aAAa;IACzD,EACF;AACD,eAAY,QAAQ,QAAQ;;GAGjC;CAEH,MAAM,YAAY,aAAa;CAG/B,MAAM,CAAC,SAAS,kCAAuB,EAAE;CAGzC,MAAM,CAAC,OAAO,gCAAoC,KAAK;CAGvD,MAAM,+BAAwC,KAAK;AACnD,KAAI,CAAC,WAAW,QACd,YAAW,UAAU;EACnB,kBAAkB,aAA6C;AAC7D,OAAI;AACF,cAAU,gBAAgB,SAAkB;YACrC,KAAK;AACZ,YAAQ,KAAK,iCAAiC,IAAI;AAClD,aAAS,eAAe,QAAQ,IAAI,UAAU,OAAO,IAAI,CAAC;AAC1D;;AAEF,YAAS,KAAK;AACd,eAAY,MAAM,IAAI,EAAE;;EAG1B,WAAW,YAAiB;AAC1B,OAAI,YAAY,QACd,aAAY,QAAQ,QAAQ;;EAIhC,aAAa,cAAsB;AACjC,UAAO,UAAU,MAAM,WAAW,UAAU;;EAG9C,qBAAqB;GAEnB,MAAM,WAAW,UAAU,MAAM;AACjC,QAAK,MAAM,CAAC,OAAO,SACjB,WAAU,gBAAgB,CACxB;IAAE,SAAS;IAAQ,eAAe,EAAE,WAAW,IAAI;IAAE,CACtD,CAAC;AAEJ,eAAY,MAAM,IAAI,EAAE;;EAE3B;CAEH,MAAM,UAAU,WAAW;CAG3B,MAAM,uCAA4B;EAAE;EAAS;EAAO,GAAG,CAAC,SAAS,MAAM,CAAC;AAExE,QACE,2CAAC,mBAAmB;EAAS,OAAO;YAClC,2CAAC,iBAAiB;GAAS,OAAO;aAChC,2CAACC;IAAqB;IAAQ;KAAyB;IAC7B;GACA;;;;;AAOlC,SAAgB,iBAA8B;CAC5C,MAAM,gCAAqB,mBAAmB;AAC9C,KAAI,CAAC,QACH,OAAM,IAAI,MAAM,qDAAqD;AAEvE,QAAO;;;;;AAMT,SAAgB,eAAoC;CAClD,MAAM,8BAAmB,iBAAiB;AAC1C,KAAI,CAAC,MACH,OAAM,IAAI,MAAM,mDAAmD;AAErE,QAAO;;;;;AAMT,SAAgB,iBAAmC;CACjD,MAAM,UAAU,gBAAgB;CAChC,MAAM,QAAQ,cAAc;AAE5B,kCACS;EACL,GAAG;EACH,SAAS,MAAM;EACf,UAAU;EACX,GACD,CAAC,SAAS,MAAM,QAAQ,CACzB;;;AAIH,MAAa,eAAe;;;;AAK5B,SAAgB,eAA8B;AAE5C,8BADyB,iBAAiB,EAC5B,SAAS;;;AAIzB,SAAgB,qBACd,UACG;AAEH,QAAO,SADS,gBAAgB,CACR"}