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

package/dist/react-renderer/core/A2UIRenderer.d.mts

@@ -1,4 +1,3 @@
-import { ComponentRegistry } from "../registry/ComponentRegistry.mjs";
 import * as react from "react";
 import { ReactNode } from "react";
 
@@ -12,27 +11,14 @@ interface A2UIRendererProps {
   fallback?: ReactNode;
   /** Loading fallback for lazy-loaded components */
   loadingFallback?: ReactNode;
-  /** Optional custom component registry */
-  registry?: ComponentRegistry;
+  /** @deprecated - No longer needed in v0.9, components come from catalog */
+  registry?: any;
 }
 /**
- * A2UIRenderer - renders an A2UI surface.
+ * A2UIRenderer - renders an A2UI surface using the v0.9 renderer.
  *
- * This is the main entry point for rendering A2UI content in your React app.
- * It reads the surface state from the A2UI store and renders the component tree.
- *
- * Memoized to prevent unnecessary re-renders when props haven't changed.
- *
- * @example
- * ```tsx
- * function App() {
- *   return (
- *     <A2UIProvider onAction={handleAction}>
- *       <A2UIRenderer surfaceId="main" />
- *     </A2UIProvider>
- *   );
- * }
- * ```
+ * Uses A2uiSurface from a2ui-react which handles all component
+ * rendering internally via the catalog system.
  */
 declare const A2UIRenderer: react.NamedExoticComponent<A2UIRendererProps>;
 //#endregion

package/dist/react-renderer/core/A2UIRenderer.d.mts.map

@@ -1 +1 @@
-{"version":3,"file":"A2UIRenderer.d.mts","names":[],"sources":["../../../src/react-renderer/core/A2UIRenderer.tsx"],"mappings":";;;;;UAeiB,iBAAA;;EAEf,SAAA;EAFe;EAIf,SAAA;;EAEA,QAAA,GAAW,SAAA;EAEO;EAAlB,eAAA,GAAkB,SAAA;EAEU;EAA5B,QAAA,GAAW,iBAAA;AAAA;;;;;;;;;;AAsBb;;;;;;;;;;cAAa,YAAA,EAAY,KAAA,CAAA,oBAAA,CAAA,iBAAA"}
+{"version":3,"file":"A2UIRenderer.d.mts","names":[],"sources":["../../../src/react-renderer/core/A2UIRenderer.tsx"],"mappings":";;;;UAciB,iBAAA;;EAEf,SAAA;EAFe;EAIf,SAAA;;EAEA,QAAA,GAAW,SAAA;EAJX;EAMA,eAAA,GAAkB,SAAA;EAFlB;EAIA,QAAA;AAAA;;;;;AASF;;cAAa,YAAA,EAAY,KAAA,CAAA,oBAAA,CAAA,iBAAA"}

package/dist/react-renderer/core/A2UIRenderer.mjs

@@ -1,7 +1,8 @@
+import { A2uiSurface } from "../a2ui-react/A2uiSurface.mjs";
+import "../a2ui-react/index.mjs";
 import { useA2UI } from "../hooks/useA2UI.mjs";
-import ComponentNode from "./ComponentNode.mjs";
 import { cn } from "../lib/utils.mjs";
-import { Suspense, memo, useMemo } from "react";
+import { Suspense, memo } from "react";
 import { Fragment, jsx } from "react/jsx-runtime";
 
 //#region src/react-renderer/core/A2UIRenderer.tsx
@@ -17,72 +18,23 @@ const DefaultLoadingFallback = memo(function DefaultLoadingFallback() {
 	});
 });
 /**
-* A2UIRenderer - renders an A2UI surface.
+* A2UIRenderer - renders an A2UI surface using the v0.9 renderer.
 *
-* This is the main entry point for rendering A2UI content in your React app.
-* It reads the surface state from the A2UI store and renders the component tree.
-*
-* Memoized to prevent unnecessary re-renders when props haven't changed.
-*
-* @example
-* ```tsx
-* function App() {
-*   return (
-*     <A2UIProvider onAction={handleAction}>
-*       <A2UIRenderer surfaceId="main" />
-*     </A2UIProvider>
-*   );
-* }
-* ```
+* Uses A2uiSurface from a2ui-react which handles all component
+* rendering internally via the catalog system.
 */
-const A2UIRenderer = memo(function A2UIRenderer({ surfaceId, className, fallback = null, loadingFallback, registry }) {
+const A2UIRenderer = memo(function A2UIRenderer({ surfaceId, className, fallback = null, loadingFallback }) {
 	const { getSurface, version } = useA2UI();
 	const surface = getSurface(surfaceId);
-	const surfaceStyles = useMemo(() => {
-		if (!surface?.styles) return {};
-		const styles = {};
-		for (const [key, value] of Object.entries(surface.styles)) switch (key) {
-			case "primaryColor":
-				styles["--p-100"] = "#ffffff";
-				styles["--p-99"] = `color-mix(in srgb, ${value} 2%, white 98%)`;
-				styles["--p-98"] = `color-mix(in srgb, ${value} 4%, white 96%)`;
-				styles["--p-95"] = `color-mix(in srgb, ${value} 10%, white 90%)`;
-				styles["--p-90"] = `color-mix(in srgb, ${value} 20%, white 80%)`;
-				styles["--p-80"] = `color-mix(in srgb, ${value} 40%, white 60%)`;
-				styles["--p-70"] = `color-mix(in srgb, ${value} 60%, white 40%)`;
-				styles["--p-60"] = `color-mix(in srgb, ${value} 80%, white 20%)`;
-				styles["--p-50"] = String(value);
-				styles["--p-40"] = `color-mix(in srgb, ${value} 80%, black 20%)`;
-				styles["--p-35"] = `color-mix(in srgb, ${value} 70%, black 30%)`;
-				styles["--p-30"] = `color-mix(in srgb, ${value} 60%, black 40%)`;
-				styles["--p-25"] = `color-mix(in srgb, ${value} 50%, black 50%)`;
-				styles["--p-20"] = `color-mix(in srgb, ${value} 40%, black 60%)`;
-				styles["--p-15"] = `color-mix(in srgb, ${value} 30%, black 70%)`;
-				styles["--p-10"] = `color-mix(in srgb, ${value} 20%, black 80%)`;
-				styles["--p-5"] = `color-mix(in srgb, ${value} 10%, black 90%)`;
-				styles["--p-0"] = "#000000";
-				break;
-			case "font":
-				styles["--font-family"] = String(value);
-				styles["--font-family-flex"] = String(value);
-				break;
-		}
-		return styles;
-	}, [surface?.styles]);
-	if (!surface || !surface.componentTree) return /* @__PURE__ */ jsx(Fragment, { children: fallback });
+	if (!surface) return /* @__PURE__ */ jsx(Fragment, { children: fallback });
 	const actualLoadingFallback = loadingFallback ?? /* @__PURE__ */ jsx(DefaultLoadingFallback, {});
 	return /* @__PURE__ */ jsx("div", {
 		className: cn("a2ui-surface", className),
-		style: surfaceStyles,
 		"data-surface-id": surfaceId,
 		"data-version": version,
 		children: /* @__PURE__ */ jsx(Suspense, {
 			fallback: actualLoadingFallback,
-			children: /* @__PURE__ */ jsx(ComponentNode, {
-				node: surface.componentTree,
-				surfaceId,
-				registry
-			})
+			children: /* @__PURE__ */ jsx(A2uiSurface, { surface })
 		})
 	});
 });

package/dist/react-renderer/core/A2UIRenderer.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"A2UIRenderer.mjs","names":[],"sources":["../../../src/react-renderer/core/A2UIRenderer.tsx"],"sourcesContent":["import { Suspense, useMemo, memo, type ReactNode } from \"react\";\nimport { useA2UI } from \"../hooks/useA2UI\";\nimport { ComponentNode } from \"./ComponentNode\";\nimport { type ComponentRegistry } from \"../registry/ComponentRegistry\";\nimport { cn } from \"../lib/utils\";\n\n/** Default loading fallback - memoized to prevent recreation */\nconst DefaultLoadingFallback = memo(function DefaultLoadingFallback() {\n  return (\n    <div className=\"a2ui-loading\" style={{ padding: \"16px\", opacity: 0.5 }}>\n      Loading...\n    </div>\n  );\n});\n\nexport interface A2UIRendererProps {\n  /** The surface ID to render */\n  surfaceId: string;\n  /** Additional CSS classes for the surface container */\n  className?: string;\n  /** Fallback content when surface is not yet available */\n  fallback?: ReactNode;\n  /** Loading fallback for lazy-loaded components */\n  loadingFallback?: ReactNode;\n  /** Optional custom component registry */\n  registry?: ComponentRegistry;\n}\n\n/**\n * A2UIRenderer - renders an A2UI surface.\n *\n * This is the main entry point for rendering A2UI content in your React app.\n * It reads the surface state from the A2UI store and renders the component tree.\n *\n * Memoized to prevent unnecessary re-renders when props haven't changed.\n *\n * @example\n * ```tsx\n * function App() {\n *   return (\n *     <A2UIProvider onAction={handleAction}>\n *       <A2UIRenderer surfaceId=\"main\" />\n *     </A2UIProvider>\n *   );\n * }\n * ```\n */\nexport const A2UIRenderer = memo(function A2UIRenderer({\n  surfaceId,\n  className,\n  fallback = null,\n  loadingFallback,\n  registry,\n}: A2UIRendererProps) {\n  const { getSurface, version } = useA2UI();\n\n  // Get surface - this will re-render when version changes\n  const surface = getSurface(surfaceId);\n\n  // Memoize surface styles to prevent object recreation\n  // Matches Lit renderer's transformation logic in surface.ts\n  const surfaceStyles = useMemo<React.CSSProperties>(() => {\n    if (!surface?.styles) return {};\n\n    const styles: React.CSSProperties & Record<string, string> = {};\n\n    for (const [key, value] of Object.entries(surface.styles)) {\n      switch (key) {\n        // Generate a color palette from the primary color.\n        // Values range from 0-100 where 0=black, 100=white, 50=primary color.\n        // Uses color-mix to create intermediate values.\n        case \"primaryColor\": {\n          styles[\"--p-100\"] = \"#ffffff\";\n          styles[\"--p-99\"] = `color-mix(in srgb, ${value} 2%, white 98%)`;\n          styles[\"--p-98\"] = `color-mix(in srgb, ${value} 4%, white 96%)`;\n          styles[\"--p-95\"] = `color-mix(in srgb, ${value} 10%, white 90%)`;\n          styles[\"--p-90\"] = `color-mix(in srgb, ${value} 20%, white 80%)`;\n          styles[\"--p-80\"] = `color-mix(in srgb, ${value} 40%, white 60%)`;\n          styles[\"--p-70\"] = `color-mix(in srgb, ${value} 60%, white 40%)`;\n          styles[\"--p-60\"] = `color-mix(in srgb, ${value} 80%, white 20%)`;\n          styles[\"--p-50\"] = String(value);\n          styles[\"--p-40\"] = `color-mix(in srgb, ${value} 80%, black 20%)`;\n          styles[\"--p-35\"] = `color-mix(in srgb, ${value} 70%, black 30%)`;\n          styles[\"--p-30\"] = `color-mix(in srgb, ${value} 60%, black 40%)`;\n          styles[\"--p-25\"] = `color-mix(in srgb, ${value} 50%, black 50%)`;\n          styles[\"--p-20\"] = `color-mix(in srgb, ${value} 40%, black 60%)`;\n          styles[\"--p-15\"] = `color-mix(in srgb, ${value} 30%, black 70%)`;\n          styles[\"--p-10\"] = `color-mix(in srgb, ${value} 20%, black 80%)`;\n          styles[\"--p-5\"] = `color-mix(in srgb, ${value} 10%, black 90%)`;\n          styles[\"--p-0\"] = \"#000000\";\n          break;\n        }\n\n        case \"font\": {\n          styles[\"--font-family\"] = String(value);\n          styles[\"--font-family-flex\"] = String(value);\n          break;\n        }\n      }\n    }\n    return styles;\n  }, [surface?.styles]);\n\n  // No surface yet\n  if (!surface || !surface.componentTree) {\n    return <>{fallback}</>;\n  }\n\n  // Use provided fallback or default memoized component\n  const actualLoadingFallback = loadingFallback ?? <DefaultLoadingFallback />;\n\n  return (\n    <div\n      className={cn(\"a2ui-surface\", className)}\n      style={surfaceStyles}\n      data-surface-id={surfaceId}\n      data-version={version}\n    >\n      <Suspense fallback={actualLoadingFallback}>\n        <ComponentNode\n          node={surface.componentTree}\n          surfaceId={surfaceId}\n          registry={registry}\n        />\n      </Suspense>\n    </div>\n  );\n});\n\nexport default A2UIRenderer;\n"],"mappings":";;;;;;;;AAOA,MAAM,yBAAyB,KAAK,SAAS,yBAAyB;AACpE,QACE,oBAAC;EAAI,WAAU;EAAe,OAAO;GAAE,SAAS;GAAQ,SAAS;GAAK;YAAE;GAElE;EAER;;;;;;;;;;;;;;;;;;;;AAkCF,MAAa,eAAe,KAAK,SAAS,aAAa,EACrD,WACA,WACA,WAAW,MACX,iBACA,YACoB;CACpB,MAAM,EAAE,YAAY,YAAY,SAAS;CAGzC,MAAM,UAAU,WAAW,UAAU;CAIrC,MAAM,gBAAgB,cAAmC;AACvD,MAAI,CAAC,SAAS,OAAQ,QAAO,EAAE;EAE/B,MAAM,SAAuD,EAAE;AAE/D,OAAK,MAAM,CAAC,KAAK,UAAU,OAAO,QAAQ,QAAQ,OAAO,CACvD,SAAQ,KAAR;GAIE,KAAK;AACH,WAAO,aAAa;AACpB,WAAO,YAAY,sBAAsB,MAAM;AAC/C,WAAO,YAAY,sBAAsB,MAAM;AAC/C,WAAO,YAAY,sBAAsB,MAAM;AAC/C,WAAO,YAAY,sBAAsB,MAAM;AAC/C,WAAO,YAAY,sBAAsB,MAAM;AAC/C,WAAO,YAAY,sBAAsB,MAAM;AAC/C,WAAO,YAAY,sBAAsB,MAAM;AAC/C,WAAO,YAAY,OAAO,MAAM;AAChC,WAAO,YAAY,sBAAsB,MAAM;AAC/C,WAAO,YAAY,sBAAsB,MAAM;AAC/C,WAAO,YAAY,sBAAsB,MAAM;AAC/C,WAAO,YAAY,sBAAsB,MAAM;AAC/C,WAAO,YAAY,sBAAsB,MAAM;AAC/C,WAAO,YAAY,sBAAsB,MAAM;AAC/C,WAAO,YAAY,sBAAsB,MAAM;AAC/C,WAAO,WAAW,sBAAsB,MAAM;AAC9C,WAAO,WAAW;AAClB;GAGF,KAAK;AACH,WAAO,mBAAmB,OAAO,MAAM;AACvC,WAAO,wBAAwB,OAAO,MAAM;AAC5C;;AAIN,SAAO;IACN,CAAC,SAAS,OAAO,CAAC;AAGrB,KAAI,CAAC,WAAW,CAAC,QAAQ,cACvB,QAAO,0CAAG,WAAY;CAIxB,MAAM,wBAAwB,mBAAmB,oBAAC,2BAAyB;AAE3E,QACE,oBAAC;EACC,WAAW,GAAG,gBAAgB,UAAU;EACxC,OAAO;EACP,mBAAiB;EACjB,gBAAc;YAEd,oBAAC;GAAS,UAAU;aAClB,oBAAC;IACC,MAAM,QAAQ;IACH;IACD;KACV;IACO;GACP;EAER"}
+{"version":3,"file":"A2UIRenderer.mjs","names":[],"sources":["../../../src/react-renderer/core/A2UIRenderer.tsx"],"sourcesContent":["import { Suspense, memo, type ReactNode } from \"react\";\nimport { useA2UI } from \"../hooks/useA2UI\";\nimport { A2uiSurface } from \"../a2ui-react\";\nimport { cn } from \"../lib/utils\";\n\n/** Default loading fallback - memoized to prevent recreation */\nconst DefaultLoadingFallback = memo(function DefaultLoadingFallback() {\n  return (\n    <div className=\"a2ui-loading\" style={{ padding: \"16px\", opacity: 0.5 }}>\n      Loading...\n    </div>\n  );\n});\n\nexport interface A2UIRendererProps {\n  /** The surface ID to render */\n  surfaceId: string;\n  /** Additional CSS classes for the surface container */\n  className?: string;\n  /** Fallback content when surface is not yet available */\n  fallback?: ReactNode;\n  /** Loading fallback for lazy-loaded components */\n  loadingFallback?: ReactNode;\n  /** @deprecated - No longer needed in v0.9, components come from catalog */\n  registry?: any;\n}\n\n/**\n * A2UIRenderer - renders an A2UI surface using the v0.9 renderer.\n *\n * Uses A2uiSurface from a2ui-react which handles all component\n * rendering internally via the catalog system.\n */\nexport const A2UIRenderer = memo(function A2UIRenderer({\n  surfaceId,\n  className,\n  fallback = null,\n  loadingFallback,\n}: A2UIRendererProps) {\n  const { getSurface, version } = useA2UI();\n\n  // Get v0.9 SurfaceModel - this will re-render when version changes\n  const surface = getSurface(surfaceId);\n\n  // No surface yet\n  if (!surface) {\n    return <>{fallback}</>;\n  }\n\n  // Use provided fallback or default memoized component\n  const actualLoadingFallback = loadingFallback ?? <DefaultLoadingFallback />;\n\n  return (\n    <div\n      className={cn(\"a2ui-surface\", className)}\n      data-surface-id={surfaceId}\n      data-version={version}\n    >\n      <Suspense fallback={actualLoadingFallback}>\n        <A2uiSurface surface={surface} />\n      </Suspense>\n    </div>\n  );\n});\n\nexport default A2UIRenderer;\n"],"mappings":";;;;;;;;;AAMA,MAAM,yBAAyB,KAAK,SAAS,yBAAyB;AACpE,QACE,oBAAC;EAAI,WAAU;EAAe,OAAO;GAAE,SAAS;GAAQ,SAAS;GAAK;YAAE;GAElE;EAER;;;;;;;AAqBF,MAAa,eAAe,KAAK,SAAS,aAAa,EACrD,WACA,WACA,WAAW,MACX,mBACoB;CACpB,MAAM,EAAE,YAAY,YAAY,SAAS;CAGzC,MAAM,UAAU,WAAW,UAAU;AAGrC,KAAI,CAAC,QACH,QAAO,0CAAG,WAAY;CAIxB,MAAM,wBAAwB,mBAAmB,oBAAC,2BAAyB;AAE3E,QACE,oBAAC;EACC,WAAW,GAAG,gBAAgB,UAAU;EACxC,mBAAiB;EACjB,gBAAc;YAEd,oBAAC;GAAS,UAAU;aAClB,oBAAC,eAAqB,UAAW;IACxB;GACP;EAER"}

package/dist/react-renderer/core/store.d.cts

@@ -1,5 +1,4 @@
 import { OnActionCallback } from "../types.cjs";
-import { Types } from "@a2ui/lit/0.8";
 
 //#region src/react-renderer/core/store.d.ts
 /**
@@ -7,30 +6,20 @@ import { Types } from "@a2ui/lit/0.8";
  * These are stored in a ref and exposed via A2UIActionsContext.
  */
 interface A2UIActions {
-  /** Process incoming server messages */
-  processMessages: (messages: Types.ServerToClientMessage[]) => void;
-  /** Update data in the data model (for two-way binding) */
-  setData: (node: Types.AnyComponentNode | null, path: string, value: Types.DataValue, surfaceId: string) => void;
+  /** Process incoming v0.9 A2UI messages */
+  processMessages: (messages: Array<Record<string, unknown>>) => void;
   /** Dispatch a user action to the server */
-  dispatch: (message: Types.A2UIClientEventMessage) => void;
-  /** Clear all surfaces */
+  dispatch: (message: any) => void;
+  /** Get a surface model by ID */
+  getSurface: (surfaceId: string) => any | undefined;
+  /** Clear all surfaces (creates a new processor) */
   clearSurfaces: () => void;
-  /** Get a surface by ID */
-  getSurface: (surfaceId: string) => Types.Surface | undefined;
-  /** Get all surfaces */
-  getSurfaces: () => ReadonlyMap<string, Types.Surface>;
-  /** Get data from the data model */
-  getData: (node: Types.AnyComponentNode, path: string, surfaceId: string) => Types.DataValue | null;
-  /** Resolve a relative path to an absolute path */
-  resolvePath: (path: string, dataContextPath?: string) => string;
 }
 /**
  * The shape of the A2UI context value.
  * Combines stable actions with reactive state.
  */
 interface A2UIContextValue extends A2UIActions {
-  /** The underlying message processor from @a2ui/lit */
-  processor: Types.MessageProcessor;
   /** Version counter for triggering React re-renders */
   version: number;
   /** Callback for dispatching actions to the server */

package/dist/react-renderer/core/store.d.cts.map

@@ -1 +1 @@
-{"version":3,"file":"store.d.cts","names":[],"sources":["../../../src/react-renderer/core/store.ts"],"mappings":";;;;;;AAOA;;UAAiB,WAAA;EAEa;EAA5B,eAAA,GAAkB,QAAA,EAAU,KAAA,CAAM,qBAAA;EAMzB;EAHT,OAAA,GACE,IAAA,EAAM,KAAA,CAAM,gBAAA,SACZ,IAAA,UACA,KAAA,EAAO,KAAA,CAAM,SAAA,EACb,SAAA;EAUiC;EANnC,QAAA,GAAW,OAAA,EAAS,KAAA,CAAM,sBAAA;EASP;EANnB,aAAA;EAaK;EAVL,UAAA,GAAa,SAAA,aAAsB,KAAA,CAAM,OAAA;EAUrB;EAPpB,WAAA,QAAmB,WAAA,SAAoB,KAAA,CAAM,OAAA;EApBjB;EAuB5B,OAAA,GACE,IAAA,EAAM,KAAA,CAAM,gBAAA,EACZ,IAAA,UACA,SAAA,aACG,KAAA,CAAM,SAAA;EA3BO;EA8BlB,WAAA,GAAc,IAAA,UAAc,eAAA;AAAA;;;;;UAOb,gBAAA,SAAyB,WAAA;EA/BtC;EAiCF,SAAA,EAAW,KAAA,CAAM,gBAAA;EA5BjB;EA+BA,OAAA;EA/B0B;EAkC1B,QAAA,EAAU,gBAAA;AAAA"}
+{"version":3,"file":"store.d.cts","names":[],"sources":["../../../src/react-renderer/core/store.ts"],"mappings":";;;;;AAMA;;UAAiB,WAAA;EAEkB;EAAjC,eAAA,GAAkB,QAAA,EAAU,KAAA,CAAM,MAAA;EAAN;EAG5B,QAAA,GAAW,OAAA;EAHO;EAMlB,UAAA,GAAa,SAAA;EAHF;EAMX,aAAA;AAAA;;;;AAOF;UAAiB,gBAAA,SAAyB,WAAA;;EAExC,OAAA;EAFwC;EAKxC,QAAA,EAAU,gBAAA;AAAA"}

package/dist/react-renderer/core/store.d.mts

@@ -1,5 +1,4 @@
 import { OnActionCallback } from "../types.mjs";
-import { Types } from "@a2ui/lit/0.8";
 
 //#region src/react-renderer/core/store.d.ts
 /**
@@ -7,30 +6,20 @@ import { Types } from "@a2ui/lit/0.8";
  * These are stored in a ref and exposed via A2UIActionsContext.
  */
 interface A2UIActions {
-  /** Process incoming server messages */
-  processMessages: (messages: Types.ServerToClientMessage[]) => void;
-  /** Update data in the data model (for two-way binding) */
-  setData: (node: Types.AnyComponentNode | null, path: string, value: Types.DataValue, surfaceId: string) => void;
+  /** Process incoming v0.9 A2UI messages */
+  processMessages: (messages: Array<Record<string, unknown>>) => void;
   /** Dispatch a user action to the server */
-  dispatch: (message: Types.A2UIClientEventMessage) => void;
-  /** Clear all surfaces */
+  dispatch: (message: any) => void;
+  /** Get a surface model by ID */
+  getSurface: (surfaceId: string) => any | undefined;
+  /** Clear all surfaces (creates a new processor) */
   clearSurfaces: () => void;
-  /** Get a surface by ID */
-  getSurface: (surfaceId: string) => Types.Surface | undefined;
-  /** Get all surfaces */
-  getSurfaces: () => ReadonlyMap<string, Types.Surface>;
-  /** Get data from the data model */
-  getData: (node: Types.AnyComponentNode, path: string, surfaceId: string) => Types.DataValue | null;
-  /** Resolve a relative path to an absolute path */
-  resolvePath: (path: string, dataContextPath?: string) => string;
 }
 /**
  * The shape of the A2UI context value.
  * Combines stable actions with reactive state.
  */
 interface A2UIContextValue extends A2UIActions {
-  /** The underlying message processor from @a2ui/lit */
-  processor: Types.MessageProcessor;
   /** Version counter for triggering React re-renders */
   version: number;
   /** Callback for dispatching actions to the server */

package/dist/react-renderer/core/store.d.mts.map

@@ -1 +1 @@
-{"version":3,"file":"store.d.mts","names":[],"sources":["../../../src/react-renderer/core/store.ts"],"mappings":";;;;;;AAOA;;UAAiB,WAAA;EAEa;EAA5B,eAAA,GAAkB,QAAA,EAAU,KAAA,CAAM,qBAAA;EAMzB;EAHT,OAAA,GACE,IAAA,EAAM,KAAA,CAAM,gBAAA,SACZ,IAAA,UACA,KAAA,EAAO,KAAA,CAAM,SAAA,EACb,SAAA;EAUiC;EANnC,QAAA,GAAW,OAAA,EAAS,KAAA,CAAM,sBAAA;EASP;EANnB,aAAA;EAaK;EAVL,UAAA,GAAa,SAAA,aAAsB,KAAA,CAAM,OAAA;EAUrB;EAPpB,WAAA,QAAmB,WAAA,SAAoB,KAAA,CAAM,OAAA;EApBjB;EAuB5B,OAAA,GACE,IAAA,EAAM,KAAA,CAAM,gBAAA,EACZ,IAAA,UACA,SAAA,aACG,KAAA,CAAM,SAAA;EA3BO;EA8BlB,WAAA,GAAc,IAAA,UAAc,eAAA;AAAA;;;;;UAOb,gBAAA,SAAyB,WAAA;EA/BtC;EAiCF,SAAA,EAAW,KAAA,CAAM,gBAAA;EA5BjB;EA+BA,OAAA;EA/B0B;EAkC1B,QAAA,EAAU,gBAAA;AAAA"}
+{"version":3,"file":"store.d.mts","names":[],"sources":["../../../src/react-renderer/core/store.ts"],"mappings":";;;;;AAMA;;UAAiB,WAAA;EAEkB;EAAjC,eAAA,GAAkB,QAAA,EAAU,KAAA,CAAM,MAAA;EAAN;EAG5B,QAAA,GAAW,OAAA;EAHO;EAMlB,UAAA,GAAa,SAAA;EAHF;EAMX,aAAA;AAAA;;;;AAOF;UAAiB,gBAAA,SAAyB,WAAA;;EAExC,OAAA;EAFwC;EAKxC,QAAA,EAAU,gBAAA;AAAA"}

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

@@ -0,0 +1,115 @@
+const require_runtime = require('../_virtual/_rolldown/runtime.cjs');
+const require_adapter = require('./a2ui-react/adapter.cjs');
+const require_index = require('./a2ui-react/catalog/basic/index.cjs');
+require('./a2ui-react/index.cjs');
+let _a2ui_web_core_v0_9 = require("@a2ui/web_core/v0_9");
+let react_jsx_runtime = require("react/jsx-runtime");
+
+//#region src/react-renderer/create-catalog.tsx
+/**
+* Create an A2UI catalog from definitions and renderers.
+*
+* Definitions are platform-agnostic (Zod schemas + descriptions).
+* Renderers are platform-specific (React components).
+* TypeScript enforces that renderers match definitions exactly.
+*
+* @example
+* ```tsx
+* // schema.ts (platform-agnostic)
+* export const demoCatalogDefinitions = {
+*   Card: {
+*     description: "A card container",
+*     props: z.object({ title: z.string(), child: z.string().optional() }),
+*   },
+* } satisfies CatalogDefinitions;
+*
+* // catalog.tsx (React renderers)
+* export const demoCatalog = createCatalog(demoCatalogDefinitions, {
+*   Card: ({ props, children }) => (
+*     <div>{props.title}{props.child && children(props.child)}</div>
+*   ),
+* });
+* ```
+*/
+function createCatalog(definitions, renderers, options) {
+	const catalogId = options?.catalogId ?? "copilotkit://custom-catalog";
+	const includeBasic = options?.includeBasicCatalog === true;
+	const customComponents = [];
+	for (const [name, def] of Object.entries(definitions)) {
+		const api = {
+			name,
+			schema: def.props
+		};
+		const renderer = renderers[name];
+		const wrapped = require_adapter.createReactComponent(api, ({ props, buildChild, context }) => {
+			const Render = renderer;
+			const dispatch = (action) => context.dispatchAction(action);
+			return /* @__PURE__ */ (0, react_jsx_runtime.jsx)(Render, {
+				props,
+				children: buildChild,
+				dispatch
+			});
+		});
+		customComponents.push(wrapped);
+	}
+	return new _a2ui_web_core_v0_9.Catalog(catalogId, includeBasic ? [...Array.from(require_index.basicCatalog.components.values()), ...customComponents] : customComponents, includeBasic ? Array.from(require_index.basicCatalog.functions.values()) : []);
+}
+/**
+* Extract a JSON-serializable schema from catalog definitions.
+* Suitable for passing to the runtime's `a2ui.schema` config.
+*/
+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
+	};
+}
+/**
+* @deprecated Use `createCatalog(definitions, renderers)` instead.
+*/
+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);
+}
+/**
+* @deprecated Use `extractSchema(definitions)` instead.
+*/
+function extractA2UISchema(components) {
+	const definitions = {};
+	for (const [name, def] of Object.entries(components)) definitions[name] = {
+		props: def.props,
+		description: def.description
+	};
+	return extractSchema(definitions);
+}
+
+//#endregion
+exports.createA2UICatalog = createA2UICatalog;
+exports.createCatalog = createCatalog;
+exports.extractA2UISchema = extractA2UISchema;
+exports.extractSchema = extractSchema;
+//# sourceMappingURL=create-catalog.cjs.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"create-catalog.cjs","names":["createReactComponent","Catalog","basicCatalog"],"sources":["../../src/react-renderer/create-catalog.tsx"],"sourcesContent":["import { z, type ZodObject, type ZodRawShape } from \"zod\";\nimport { Catalog } from \"@a2ui/web_core/v0_9\";\nimport { BASIC_FUNCTIONS } from \"@a2ui/web_core/v0_9/basic_catalog\";\nimport { basicCatalog, createReactComponent } from \"./a2ui-react\";\nimport type { ReactComponentImplementation } from \"./a2ui-react\";\nimport type { ComponentApi } from \"@a2ui/web_core/v0_9\";\n\n// ─── Catalog Definitions (platform-agnostic) ─────────────────────────\n\n/**\n * A single component definition — Zod props schema + optional description.\n * Platform-agnostic: no React or rendering details.\n */\nexport interface CatalogComponentDefinition<\n  T extends ZodRawShape = ZodRawShape,\n> {\n  /** Zod schema for component props */\n  props: ZodObject<T>;\n  /** Description for the AI agent */\n  description?: string;\n}\n\n/**\n * A record mapping component names to their definitions.\n * This is the platform-agnostic \"contract\" that agents use.\n */\nexport type CatalogDefinitions = Record<\n  string,\n  CatalogComponentDefinition<any>\n>;\n\n/**\n * Infer the props type for a specific component in the definitions.\n */\nexport type PropsOf<D extends CatalogDefinitions, K extends keyof D> = z.infer<\n  D[K][\"props\"]\n>;\n\n// ─── Catalog Renderers (platform-specific) ───────────────────────────\n\n/**\n * Props passed to a renderer function.\n */\nexport interface RendererProps<T = Record<string, unknown>> {\n  /** Resolved prop values from the A2UI data model */\n  props: T;\n  /** Render a child component by ID */\n  children: (id: string) => React.ReactNode;\n  /** Dispatch an A2UI action from this component (e.g., on button click) */\n  dispatch?: (action: any) => void;\n}\n\n/**\n * A renderer function for a component.\n */\nexport type ComponentRenderer<T = Record<string, unknown>> = React.FC<\n  RendererProps<T>\n>;\n\n/**\n * A record mapping component names to React renderer functions.\n * Type-checked against the catalog definitions.\n */\nexport type CatalogRenderers<D extends CatalogDefinitions> = {\n  [K in keyof D]: ComponentRenderer<z.infer<D[K][\"props\"]>>;\n};\n\n// ─── Create Catalog ──────────────────────────────────────────────────\n\n/**\n * Create an A2UI catalog from definitions and renderers.\n *\n * Definitions are platform-agnostic (Zod schemas + descriptions).\n * Renderers are platform-specific (React components).\n * TypeScript enforces that renderers match definitions exactly.\n *\n * @example\n * ```tsx\n * // schema.ts (platform-agnostic)\n * export const demoCatalogDefinitions = {\n *   Card: {\n *     description: \"A card container\",\n *     props: z.object({ title: z.string(), child: z.string().optional() }),\n *   },\n * } satisfies CatalogDefinitions;\n *\n * // catalog.tsx (React renderers)\n * export const demoCatalog = createCatalog(demoCatalogDefinitions, {\n *   Card: ({ props, children }) => (\n *     <div>{props.title}{props.child && children(props.child)}</div>\n *   ),\n * });\n * ```\n */\nexport function createCatalog<D extends CatalogDefinitions>(\n  definitions: D,\n  renderers: CatalogRenderers<D>,\n  options?: {\n    /** Catalog ID. Defaults to a generated URI. */\n    catalogId?: string;\n    /** If true, merge the built-in basic catalog components (Text, Button, Row, etc.) into this catalog. Default: false */\n    includeBasicCatalog?: boolean;\n  },\n): Catalog<ReactComponentImplementation> {\n  const catalogId = options?.catalogId ?? \"copilotkit://custom-catalog\";\n  const includeBasic = options?.includeBasicCatalog === true;\n\n  const customComponents: ReactComponentImplementation[] = [];\n\n  for (const [name, def] of Object.entries(definitions)) {\n    const api: ComponentApi = {\n      name,\n      schema: def.props,\n    };\n\n    const renderer = (renderers as Record<string, ComponentRenderer<any>>)[\n      name\n    ];\n    const wrapped = createReactComponent(\n      api,\n      ({ props, buildChild, context }) => {\n        const Render = renderer;\n        const dispatch = (action: any) => context.dispatchAction(action);\n        return (\n          <Render props={props} children={buildChild} dispatch={dispatch} />\n        );\n      },\n    );\n\n    customComponents.push(wrapped);\n  }\n\n  const allComponents = includeBasic\n    ? [...Array.from(basicCatalog.components.values()), ...customComponents]\n    : customComponents;\n\n  const functions = includeBasic\n    ? Array.from(basicCatalog.functions.values())\n    : [];\n\n  return new Catalog<ReactComponentImplementation>(\n    catalogId,\n    allComponents,\n    functions,\n  );\n}\n\n// ─── Extract Schema (for runtime) ────────────────────────────────────\n\n/**\n * Extract a JSON-serializable schema from catalog definitions.\n * Suitable for passing to the runtime's `a2ui.schema` config.\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\n// ─── Backward Compatibility ──────────────────────────────────────────\n\n// Old API — definitions + renderers combined in one object\nexport interface A2UIComponentDefinition<T extends ZodRawShape = ZodRawShape> {\n  props: ZodObject<T>;\n  description?: string;\n  render: React.FC<RendererProps<z.infer<ZodObject<T>>>>;\n}\n\nexport type A2UIComponentMap = Record<string, A2UIComponentDefinition<any>>;\n\n/**\n * @deprecated Use `createCatalog(definitions, renderers)` instead.\n */\nexport function createA2UICatalog(\n  components: A2UIComponentMap,\n  options?: {\n    catalogId?: string;\n    includeBasicCatalog?: boolean;\n  },\n): Catalog<ReactComponentImplementation> {\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;\n  }\n\n  return createCatalog(definitions, renderers as any, options);\n}\n\n/**\n * @deprecated Use `extractSchema(definitions)` instead.\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"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AA8FA,SAAgB,cACd,aACA,WACA,SAMuC;CACvC,MAAM,YAAY,SAAS,aAAa;CACxC,MAAM,eAAe,SAAS,wBAAwB;CAEtD,MAAM,mBAAmD,EAAE;AAE3D,MAAK,MAAM,CAAC,MAAM,QAAQ,OAAO,QAAQ,YAAY,EAAE;EACrD,MAAM,MAAoB;GACxB;GACA,QAAQ,IAAI;GACb;EAED,MAAM,WAAY,UAChB;EAEF,MAAM,UAAUA,qCACd,MACC,EAAE,OAAO,YAAY,cAAc;GAClC,MAAM,SAAS;GACf,MAAM,YAAY,WAAgB,QAAQ,eAAe,OAAO;AAChE,UACE,2CAAC;IAAc;IAAO,UAAU;IAAsB;KAAY;IAGvE;AAED,mBAAiB,KAAK,QAAQ;;AAWhC,QAAO,IAAIC,4BACT,WAToB,eAClB,CAAC,GAAG,MAAM,KAAKC,2BAAa,WAAW,QAAQ,CAAC,EAAE,GAAG,iBAAiB,GACtE,kBAEc,eACd,MAAM,KAAKA,2BAAa,UAAU,QAAQ,CAAC,GAC3C,EAAE,CAML;;;;;;AASH,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;;;;;AAiBvC,SAAgB,kBACd,YACA,SAIuC;CACvC,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;;;;;AAM9D,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"}

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

@@ -0,0 +1,107 @@
+import { ReactComponentImplementation } from "./a2ui-react/adapter.cjs";
+import "./a2ui-react/index.cjs";
+import { Catalog } from "@a2ui/web_core/v0_9";
+import { ZodObject, ZodRawShape, z } from "zod";
+
+//#region src/react-renderer/create-catalog.d.ts
+/**
+ * A single component definition — Zod props schema + optional description.
+ * Platform-agnostic: no React or rendering details.
+ */
+interface CatalogComponentDefinition<T extends ZodRawShape = ZodRawShape> {
+  /** Zod schema for component props */
+  props: ZodObject<T>;
+  /** Description for the AI agent */
+  description?: string;
+}
+/**
+ * A record mapping component names to their definitions.
+ * This is the platform-agnostic "contract" that agents use.
+ */
+type CatalogDefinitions = Record<string, CatalogComponentDefinition<any>>;
+/**
+ * Infer the props type for a specific component in the definitions.
+ */
+type PropsOf<D extends CatalogDefinitions, K extends keyof D> = z.infer<D[K]["props"]>;
+/**
+ * Props passed to a renderer function.
+ */
+interface RendererProps<T = Record<string, unknown>> {
+  /** Resolved prop values from the A2UI data model */
+  props: T;
+  /** Render a child component by ID */
+  children: (id: string) => React.ReactNode;
+  /** Dispatch an A2UI action from this component (e.g., on button click) */
+  dispatch?: (action: any) => void;
+}
+/**
+ * A renderer function for a component.
+ */
+type ComponentRenderer<T = Record<string, unknown>> = React.FC<RendererProps<T>>;
+/**
+ * A record mapping component names to React renderer functions.
+ * Type-checked against the catalog definitions.
+ */
+type CatalogRenderers<D extends CatalogDefinitions> = { [K in keyof D]: ComponentRenderer<z.infer<D[K]["props"]>> };
+/**
+ * Create an A2UI catalog from definitions and renderers.
+ *
+ * Definitions are platform-agnostic (Zod schemas + descriptions).
+ * Renderers are platform-specific (React components).
+ * TypeScript enforces that renderers match definitions exactly.
+ *
+ * @example
+ * ```tsx
+ * // schema.ts (platform-agnostic)
+ * export const demoCatalogDefinitions = {
+ *   Card: {
+ *     description: "A card container",
+ *     props: z.object({ title: z.string(), child: z.string().optional() }),
+ *   },
+ * } satisfies CatalogDefinitions;
+ *
+ * // catalog.tsx (React renderers)
+ * export const demoCatalog = createCatalog(demoCatalogDefinitions, {
+ *   Card: ({ props, children }) => (
+ *     <div>{props.title}{props.child && children(props.child)}</div>
+ *   ),
+ * });
+ * ```
+ */
+declare function createCatalog<D extends CatalogDefinitions>(definitions: D, renderers: CatalogRenderers<D>, options?: {
+  /** Catalog ID. Defaults to a generated URI. */catalogId?: string; /** If true, merge the built-in basic catalog components (Text, Button, Row, etc.) into this catalog. Default: false */
+  includeBasicCatalog?: boolean;
+}): Catalog<ReactComponentImplementation>;
+/**
+ * Extract a JSON-serializable schema from catalog definitions.
+ * Suitable for passing to the runtime's `a2ui.schema` config.
+ */
+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: React.FC<RendererProps<z.infer<ZodObject<T>>>>;
+}
+type A2UIComponentMap = Record<string, A2UIComponentDefinition<any>>;
+/**
+ * @deprecated Use `createCatalog(definitions, renderers)` instead.
+ */
+declare function createA2UICatalog(components: A2UIComponentMap, options?: {
+  catalogId?: string;
+  includeBasicCatalog?: boolean;
+}): Catalog<ReactComponentImplementation>;
+/**
+ * @deprecated Use `extractSchema(definitions)` instead.
+ */
+declare function extractA2UISchema(components: A2UIComponentMap): Array<{
+  name: string;
+  description?: string;
+  props?: Record<string, unknown>;
+}>;
+//#endregion
+export { A2UIComponentDefinition, A2UIComponentMap, CatalogComponentDefinition, CatalogDefinitions, CatalogRenderers, ComponentRenderer, PropsOf, RendererProps, createA2UICatalog, createCatalog, extractA2UISchema, extractSchema };
+//# sourceMappingURL=create-catalog.d.cts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"create-catalog.d.cts","names":[],"sources":["../../src/react-renderer/create-catalog.tsx"],"mappings":";;;;;;;;;AAaA;UAAiB,0BAAA,WACL,WAAA,GAAc,WAAA;EADiB;EAIzC,KAAA,EAAO,SAAA,CAAU,CAAA;EAHO;EAKxB,WAAA;AAAA;;;;;KAOU,kBAAA,GAAqB,MAAA,SAE/B,0BAAA;;;;KAMU,OAAA,WAAkB,kBAAA,kBAAoC,CAAA,IAAK,CAAA,CAAE,KAAA,CACvE,CAAA,CAAE,CAAA;;;AATJ;UAiBiB,aAAA,KAAkB,MAAA;;EAEjC,KAAA,EAAO,CAAA;EAjBmB;EAmB1B,QAAA,GAAW,EAAA,aAAe,KAAA,CAAM,SAAA;EAbf;EAejB,QAAA,IAAY,MAAA;AAAA;;;;KAMF,iBAAA,KAAsB,MAAA,qBAA2B,KAAA,CAAM,EAAA,CACjE,aAAA,CAAc,CAAA;;;;;KAOJ,gBAAA,WAA2B,kBAAA,kBACzB,CAAA,GAAI,iBAAA,CAAkB,CAAA,CAAE,KAAA,CAAM,CAAA,CAAE,CAAA;;;;;;AArB9C;;;;;;;;;;;;;;;;;;;;iBAmDgB,aAAA,WAAwB,kBAAA,CAAA,CACtC,WAAA,EAAa,CAAA,EACb,SAAA,EAAW,gBAAA,CAAiB,CAAA,GAC5B,OAAA;EA1C2B,+CA4CzB,SAAA,WA5C8B;EA8C9B,mBAAA;AAAA,IAED,OAAA,CAAQ,4BAAA;;;;;iBAkDK,aAAA,CAAc,WAAA,EAAa,kBAAA,GAAqB,KAAA;EAC9D,IAAA;EACA,WAAA;EACA,KAAA,GAAQ,MAAA;AAAA;AAAA,UA2BO,uBAAA,WAAkC,WAAA,GAAc,WAAA;EAC/D,KAAA,EAAO,SAAA,CAAU,CAAA;EACjB,WAAA;EACA,MAAA,EAAQ,KAAA,CAAM,EAAA,CAAG,aAAA,CAAc,CAAA,CAAE,KAAA,CAAM,SAAA,CAAU,CAAA;AAAA;AAAA,KAGvC,gBAAA,GAAmB,MAAA,SAAe,uBAAA;;;;iBAK9B,iBAAA,CACd,UAAA,EAAY,gBAAA,EACZ,OAAA;EACE,SAAA;EACA,mBAAA;AAAA,IAED,OAAA,CAAQ,4BAAA;;;;iBAeK,iBAAA,CAAkB,UAAA,EAAY,gBAAA,GAAmB,KAAA;EAC/D,IAAA;EACA,WAAA;EACA,KAAA,GAAQ,MAAA;AAAA"}

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

@@ -0,0 +1,107 @@
+import { ReactComponentImplementation } from "./a2ui-react/adapter.mjs";
+import "./a2ui-react/index.mjs";
+import { Catalog } from "@a2ui/web_core/v0_9";
+import { ZodObject, ZodRawShape, z } from "zod";
+
+//#region src/react-renderer/create-catalog.d.ts
+/**
+ * A single component definition — Zod props schema + optional description.
+ * Platform-agnostic: no React or rendering details.
+ */
+interface CatalogComponentDefinition<T extends ZodRawShape = ZodRawShape> {
+  /** Zod schema for component props */
+  props: ZodObject<T>;
+  /** Description for the AI agent */
+  description?: string;
+}
+/**
+ * A record mapping component names to their definitions.
+ * This is the platform-agnostic "contract" that agents use.
+ */
+type CatalogDefinitions = Record<string, CatalogComponentDefinition<any>>;
+/**
+ * Infer the props type for a specific component in the definitions.
+ */
+type PropsOf<D extends CatalogDefinitions, K extends keyof D> = z.infer<D[K]["props"]>;
+/**
+ * Props passed to a renderer function.
+ */
+interface RendererProps<T = Record<string, unknown>> {
+  /** Resolved prop values from the A2UI data model */
+  props: T;
+  /** Render a child component by ID */
+  children: (id: string) => React.ReactNode;
+  /** Dispatch an A2UI action from this component (e.g., on button click) */
+  dispatch?: (action: any) => void;
+}
+/**
+ * A renderer function for a component.
+ */
+type ComponentRenderer<T = Record<string, unknown>> = React.FC<RendererProps<T>>;
+/**
+ * A record mapping component names to React renderer functions.
+ * Type-checked against the catalog definitions.
+ */
+type CatalogRenderers<D extends CatalogDefinitions> = { [K in keyof D]: ComponentRenderer<z.infer<D[K]["props"]>> };
+/**
+ * Create an A2UI catalog from definitions and renderers.
+ *
+ * Definitions are platform-agnostic (Zod schemas + descriptions).
+ * Renderers are platform-specific (React components).
+ * TypeScript enforces that renderers match definitions exactly.
+ *
+ * @example
+ * ```tsx
+ * // schema.ts (platform-agnostic)
+ * export const demoCatalogDefinitions = {
+ *   Card: {
+ *     description: "A card container",
+ *     props: z.object({ title: z.string(), child: z.string().optional() }),
+ *   },
+ * } satisfies CatalogDefinitions;
+ *
+ * // catalog.tsx (React renderers)
+ * export const demoCatalog = createCatalog(demoCatalogDefinitions, {
+ *   Card: ({ props, children }) => (
+ *     <div>{props.title}{props.child && children(props.child)}</div>
+ *   ),
+ * });
+ * ```
+ */
+declare function createCatalog<D extends CatalogDefinitions>(definitions: D, renderers: CatalogRenderers<D>, options?: {
+  /** Catalog ID. Defaults to a generated URI. */catalogId?: string; /** If true, merge the built-in basic catalog components (Text, Button, Row, etc.) into this catalog. Default: false */
+  includeBasicCatalog?: boolean;
+}): Catalog<ReactComponentImplementation>;
+/**
+ * Extract a JSON-serializable schema from catalog definitions.
+ * Suitable for passing to the runtime's `a2ui.schema` config.
+ */
+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: React.FC<RendererProps<z.infer<ZodObject<T>>>>;
+}
+type A2UIComponentMap = Record<string, A2UIComponentDefinition<any>>;
+/**
+ * @deprecated Use `createCatalog(definitions, renderers)` instead.
+ */
+declare function createA2UICatalog(components: A2UIComponentMap, options?: {
+  catalogId?: string;
+  includeBasicCatalog?: boolean;
+}): Catalog<ReactComponentImplementation>;
+/**
+ * @deprecated Use `extractSchema(definitions)` instead.
+ */
+declare function extractA2UISchema(components: A2UIComponentMap): Array<{
+  name: string;
+  description?: string;
+  props?: Record<string, unknown>;
+}>;
+//#endregion
+export { A2UIComponentDefinition, A2UIComponentMap, CatalogComponentDefinition, CatalogDefinitions, CatalogRenderers, ComponentRenderer, PropsOf, RendererProps, createA2UICatalog, createCatalog, extractA2UISchema, extractSchema };
+//# sourceMappingURL=create-catalog.d.mts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"create-catalog.d.mts","names":[],"sources":["../../src/react-renderer/create-catalog.tsx"],"mappings":";;;;;;;;;AAaA;UAAiB,0BAAA,WACL,WAAA,GAAc,WAAA;EADiB;EAIzC,KAAA,EAAO,SAAA,CAAU,CAAA;EAHO;EAKxB,WAAA;AAAA;;;;;KAOU,kBAAA,GAAqB,MAAA,SAE/B,0BAAA;;;;KAMU,OAAA,WAAkB,kBAAA,kBAAoC,CAAA,IAAK,CAAA,CAAE,KAAA,CACvE,CAAA,CAAE,CAAA;;;AATJ;UAiBiB,aAAA,KAAkB,MAAA;;EAEjC,KAAA,EAAO,CAAA;EAjBmB;EAmB1B,QAAA,GAAW,EAAA,aAAe,KAAA,CAAM,SAAA;EAbf;EAejB,QAAA,IAAY,MAAA;AAAA;;;;KAMF,iBAAA,KAAsB,MAAA,qBAA2B,KAAA,CAAM,EAAA,CACjE,aAAA,CAAc,CAAA;;;;;KAOJ,gBAAA,WAA2B,kBAAA,kBACzB,CAAA,GAAI,iBAAA,CAAkB,CAAA,CAAE,KAAA,CAAM,CAAA,CAAE,CAAA;;;;;;AArB9C;;;;;;;;;;;;;;;;;;;;iBAmDgB,aAAA,WAAwB,kBAAA,CAAA,CACtC,WAAA,EAAa,CAAA,EACb,SAAA,EAAW,gBAAA,CAAiB,CAAA,GAC5B,OAAA;EA1C2B,+CA4CzB,SAAA,WA5C8B;EA8C9B,mBAAA;AAAA,IAED,OAAA,CAAQ,4BAAA;;;;;iBAkDK,aAAA,CAAc,WAAA,EAAa,kBAAA,GAAqB,KAAA;EAC9D,IAAA;EACA,WAAA;EACA,KAAA,GAAQ,MAAA;AAAA;AAAA,UA2BO,uBAAA,WAAkC,WAAA,GAAc,WAAA;EAC/D,KAAA,EAAO,SAAA,CAAU,CAAA;EACjB,WAAA;EACA,MAAA,EAAQ,KAAA,CAAM,EAAA,CAAG,aAAA,CAAc,CAAA,CAAE,KAAA,CAAM,SAAA,CAAU,CAAA;AAAA;AAAA,KAGvC,gBAAA,GAAmB,MAAA,SAAe,uBAAA;;;;iBAK9B,iBAAA,CACd,UAAA,EAAY,gBAAA,EACZ,OAAA;EACE,SAAA;EACA,mBAAA;AAAA,IAED,OAAA,CAAQ,4BAAA;;;;iBAeK,iBAAA,CAAkB,UAAA,EAAY,gBAAA,GAAmB,KAAA;EAC/D,IAAA;EACA,WAAA;EACA,KAAA,GAAQ,MAAA;AAAA"}