@openuidev/a2ui 0.3.0

package/dist/react.mjs

@@ -0,0 +1,94 @@
+import { i as toJsonObject, n as dataModelToOpenUIState } from "./json-pointer-DCdSrMT3.mjs";
+import { BuiltinActionType } from "@openuidev/lang-core";
+import { Renderer } from "@openuidev/react-lang";
+import { useCallback, useMemo, useSyncExternalStore } from "react";
+import { jsx } from "react/jsx-runtime";
+//#region src/Renderer.tsx
+function collectFormStateKeys(result) {
+	const keys = /* @__PURE__ */ new Set();
+	const seen = /* @__PURE__ */ new WeakSet();
+	const visit = (value) => {
+		if (Array.isArray(value)) {
+			for (const item of value) visit(item);
+			return;
+		}
+		if (!value || typeof value !== "object" || seen.has(value)) return;
+		seen.add(value);
+		const object = value;
+		if (object.type === "element" && object.typeName === "Form") {
+			const props = object.props;
+			if (typeof props?.name === "string") keys.add(props.name);
+		}
+		for (const child of Object.values(object)) visit(child);
+	};
+	visit(result?.root);
+	return [...keys];
+}
+function A2UIRenderer({ client, surfaceId, library, mapAction, onAction, onOpenUrl, onStateUpdate, onParseResult, onError, isStreaming = false, formStateKeys, toolProvider, queryLoader }) {
+	const subscribe = useCallback((notify) => client.subscribe(notify), [client]);
+	const getSnapshot = useCallback(() => client.getSurface(surfaceId), [client, surfaceId]);
+	const surface = useSyncExternalStore(subscribe, getSnapshot, getSnapshot);
+	const initialState = useMemo(() => {
+		if (!surface) return void 0;
+		const keys = new Set([...collectFormStateKeys(surface.parseResult), ...formStateKeys ?? []]);
+		return dataModelToOpenUIState(surface.dataModel, keys);
+	}, [formStateKeys, surface]);
+	const agentToolProvider = useMemo(() => ({ async callTool({ name, arguments: args }) {
+		return {
+			content: [],
+			structuredContent: await client.callAgentFunction({
+				surfaceId,
+				call: name,
+				args: toJsonObject(args)
+			})
+		};
+	} }), [client, surfaceId]);
+	const handleAction = useCallback((event) => {
+		const current = client.getSurface(surfaceId);
+		if (!current) return;
+		if (event.type === BuiltinActionType.OpenUrl) {
+			const url = event.params?.url;
+			if (typeof url === "string") {
+				if (onOpenUrl) onOpenUrl(url, event, current);
+				else if (typeof window !== "undefined") window.open(url, "_blank", "noopener,noreferrer");
+			}
+			onAction?.(event, current);
+			return;
+		}
+		const options = mapAction?.(event, current) ?? {};
+		client.dispatchOpenUIAction(surfaceId, event, options);
+		onAction?.(event, current);
+	}, [
+		client,
+		mapAction,
+		onAction,
+		onOpenUrl,
+		surfaceId
+	]);
+	const handleStateUpdate = useCallback((state) => {
+		if (!client.updateSurfaceFromOpenUIState(surfaceId, state)) return;
+		const current = client.getSurface(surfaceId);
+		if (current) onStateUpdate?.(state, current);
+	}, [
+		client,
+		onStateUpdate,
+		surfaceId
+	]);
+	if (!surface) return null;
+	return /* @__PURE__ */ jsx(Renderer, {
+		response: surface.source,
+		library,
+		initialState,
+		isStreaming,
+		onAction: handleAction,
+		onStateUpdate: handleStateUpdate,
+		onParseResult,
+		onError,
+		toolProvider: toolProvider ?? agentToolProvider,
+		queryLoader
+	});
+}
+//#endregion
+export { A2UIRenderer };
+
+//# sourceMappingURL=react.mjs.map

package/dist/react.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"react.mjs","names":["OpenUIRenderer"],"sources":["../src/Renderer.tsx"],"sourcesContent":["import {\n  BuiltinActionType,\n  type ActionEvent,\n  type OpenUIError,\n  type ParseResult,\n} from \"@openuidev/lang-core\";\nimport {\n  Renderer as OpenUIRenderer,\n  type Library,\n  type RendererProps as OpenUIRendererProps,\n} from \"@openuidev/react-lang\";\nimport { useCallback, useMemo, useSyncExternalStore } from \"react\";\nimport type { A2UIClient } from \"./client\";\nimport { dataModelToOpenUIState, toJsonObject } from \"./json-pointer\";\nimport type { MapOpenUIAction, OpenUIActionOptions, SurfaceSnapshot } from \"./types\";\n\nexport interface A2UIRendererProps {\n  client: A2UIClient;\n  surfaceId: string;\n  library: Library;\n  mapAction?: MapOpenUIAction;\n  onAction?: (event: ActionEvent, surface: SurfaceSnapshot) => void;\n  /** Handles OpenUI @OpenUrl locally. Defaults to window.open in browsers. */\n  onOpenUrl?: (url: string, event: ActionEvent, surface: SurfaceSnapshot) => void;\n  onStateUpdate?: (state: Record<string, unknown>, surface: SurfaceSnapshot) => void;\n  onParseResult?: (result: ParseResult | null) => void;\n  onError?: (errors: OpenUIError[]) => void;\n  /** Whether the surrounding A2UI transport is still delivering this agent turn. */\n  isStreaming?: boolean;\n  /** Additional top-level data-model keys that should hydrate form namespaces. */\n  formStateKeys?: readonly string[];\n  toolProvider?: OpenUIRendererProps[\"toolProvider\"];\n  queryLoader?: OpenUIRendererProps[\"queryLoader\"];\n}\n\nfunction collectFormStateKeys(result: ParseResult | null): string[] {\n  const keys = new Set<string>();\n  const seen = new WeakSet<object>();\n  const visit = (value: unknown): void => {\n    if (Array.isArray(value)) {\n      for (const item of value) visit(item);\n      return;\n    }\n    if (!value || typeof value !== \"object\" || seen.has(value)) return;\n    seen.add(value);\n    const object = value as Record<string, unknown>;\n    if (object.type === \"element\" && object.typeName === \"Form\") {\n      const props = object.props as Record<string, unknown> | undefined;\n      if (typeof props?.name === \"string\") keys.add(props.name);\n    }\n    for (const child of Object.values(object)) visit(child);\n  };\n  visit(result?.root);\n  return [...keys];\n}\n\nexport function A2UIRenderer({\n  client,\n  surfaceId,\n  library,\n  mapAction,\n  onAction,\n  onOpenUrl,\n  onStateUpdate,\n  onParseResult,\n  onError,\n  isStreaming = false,\n  formStateKeys,\n  toolProvider,\n  queryLoader,\n}: A2UIRendererProps) {\n  const subscribe = useCallback((notify: () => void) => client.subscribe(notify), [client]);\n  const getSnapshot = useCallback(() => client.getSurface(surfaceId), [client, surfaceId]);\n  const surface = useSyncExternalStore(subscribe, getSnapshot, getSnapshot);\n  const initialState = useMemo(() => {\n    if (!surface) return undefined;\n    const keys = new Set([...collectFormStateKeys(surface.parseResult), ...(formStateKeys ?? [])]);\n    return dataModelToOpenUIState(surface.dataModel, keys);\n  }, [formStateKeys, surface]);\n  const agentToolProvider = useMemo<NonNullable<OpenUIRendererProps[\"toolProvider\"]>>(\n    () => ({\n      async callTool({\n        name,\n        arguments: args,\n      }: {\n        name: string;\n        arguments?: Record<string, unknown>;\n      }) {\n        const value = await client.callAgentFunction({\n          surfaceId,\n          call: name,\n          args: toJsonObject(args),\n        });\n        return { content: [], structuredContent: value };\n      },\n    }),\n    [client, surfaceId],\n  );\n\n  const handleAction = useCallback(\n    (event: ActionEvent) => {\n      const current = client.getSurface(surfaceId);\n      if (!current) return;\n      if (event.type === BuiltinActionType.OpenUrl) {\n        const url = event.params?.url;\n        if (typeof url === \"string\") {\n          if (onOpenUrl) onOpenUrl(url, event, current);\n          else if (typeof window !== \"undefined\") window.open(url, \"_blank\", \"noopener,noreferrer\");\n        }\n        onAction?.(event, current);\n        return;\n      }\n      const options: OpenUIActionOptions = mapAction?.(event, current) ?? {};\n      client.dispatchOpenUIAction(surfaceId, event, options);\n      onAction?.(event, current);\n    },\n    [client, mapAction, onAction, onOpenUrl, surfaceId],\n  );\n\n  const handleStateUpdate = useCallback(\n    (state: Record<string, unknown>) => {\n      if (!client.updateSurfaceFromOpenUIState(surfaceId, state)) return;\n      const current = client.getSurface(surfaceId);\n      if (current) onStateUpdate?.(state, current);\n    },\n    [client, onStateUpdate, surfaceId],\n  );\n\n  if (!surface) return null;\n\n  return (\n    <OpenUIRenderer\n      response={surface.source}\n      library={library}\n      initialState={initialState}\n      isStreaming={isStreaming}\n      onAction={handleAction}\n      onStateUpdate={handleStateUpdate}\n      onParseResult={onParseResult}\n      onError={onError}\n      toolProvider={toolProvider ?? agentToolProvider}\n      queryLoader={queryLoader}\n    />\n  );\n}\n"],"mappings":";;;;;;AAmCA,SAAS,qBAAqB,QAAsC;CAClE,MAAM,uBAAO,IAAI,KAAa;CAC9B,MAAM,uBAAO,IAAI,SAAiB;CAClC,MAAM,SAAS,UAAyB;AACtC,MAAI,MAAM,QAAQ,MAAM,EAAE;AACxB,QAAK,MAAM,QAAQ,MAAO,OAAM,KAAK;AACrC;;AAEF,MAAI,CAAC,SAAS,OAAO,UAAU,YAAY,KAAK,IAAI,MAAM,CAAE;AAC5D,OAAK,IAAI,MAAM;EACf,MAAM,SAAS;AACf,MAAI,OAAO,SAAS,aAAa,OAAO,aAAa,QAAQ;GAC3D,MAAM,QAAQ,OAAO;AACrB,OAAI,OAAO,OAAO,SAAS,SAAU,MAAK,IAAI,MAAM,KAAK;;AAE3D,OAAK,MAAM,SAAS,OAAO,OAAO,OAAO,CAAE,OAAM,MAAM;;AAEzD,OAAM,QAAQ,KAAK;AACnB,QAAO,CAAC,GAAG,KAAK;;AAGlB,SAAgB,aAAa,EAC3B,QACA,WACA,SACA,WACA,UACA,WACA,eACA,eACA,SACA,cAAc,OACd,eACA,cACA,eACoB;CACpB,MAAM,YAAY,aAAa,WAAuB,OAAO,UAAU,OAAO,EAAE,CAAC,OAAO,CAAC;CACzF,MAAM,cAAc,kBAAkB,OAAO,WAAW,UAAU,EAAE,CAAC,QAAQ,UAAU,CAAC;CACxF,MAAM,UAAU,qBAAqB,WAAW,aAAa,YAAY;CACzE,MAAM,eAAe,cAAc;AACjC,MAAI,CAAC,QAAS,QAAO,KAAA;EACrB,MAAM,OAAO,IAAI,IAAI,CAAC,GAAG,qBAAqB,QAAQ,YAAY,EAAE,GAAI,iBAAiB,EAAE,CAAE,CAAC;AAC9F,SAAO,uBAAuB,QAAQ,WAAW,KAAK;IACrD,CAAC,eAAe,QAAQ,CAAC;CAC5B,MAAM,oBAAoB,eACjB,EACL,MAAM,SAAS,EACb,MACA,WAAW,QAIV;AAMD,SAAO;GAAE,SAAS,EAAE;GAAE,mBAAmB,MALrB,OAAO,kBAAkB;IAC3C;IACA,MAAM;IACN,MAAM,aAAa,KAAK;IACzB,CAAC;GAC8C;IAEnD,GACD,CAAC,QAAQ,UAAU,CACpB;CAED,MAAM,eAAe,aAClB,UAAuB;EACtB,MAAM,UAAU,OAAO,WAAW,UAAU;AAC5C,MAAI,CAAC,QAAS;AACd,MAAI,MAAM,SAAS,kBAAkB,SAAS;GAC5C,MAAM,MAAM,MAAM,QAAQ;AAC1B,OAAI,OAAO,QAAQ;QACb,UAAW,WAAU,KAAK,OAAO,QAAQ;aACpC,OAAO,WAAW,YAAa,QAAO,KAAK,KAAK,UAAU,sBAAsB;;AAE3F,cAAW,OAAO,QAAQ;AAC1B;;EAEF,MAAM,UAA+B,YAAY,OAAO,QAAQ,IAAI,EAAE;AACtE,SAAO,qBAAqB,WAAW,OAAO,QAAQ;AACtD,aAAW,OAAO,QAAQ;IAE5B;EAAC;EAAQ;EAAW;EAAU;EAAW;EAAU,CACpD;CAED,MAAM,oBAAoB,aACvB,UAAmC;AAClC,MAAI,CAAC,OAAO,6BAA6B,WAAW,MAAM,CAAE;EAC5D,MAAM,UAAU,OAAO,WAAW,UAAU;AAC5C,MAAI,QAAS,iBAAgB,OAAO,QAAQ;IAE9C;EAAC;EAAQ;EAAe;EAAU,CACnC;AAED,KAAI,CAAC,QAAS,QAAO;AAErB,QACE,oBAACA,UAAD;EACE,UAAU,QAAQ;EACT;EACK;EACD;EACb,UAAU;EACV,eAAe;EACA;EACN;EACT,cAAc,gBAAgB;EACjB;EACb,CAAA"}

package/package.json

@@ -0,0 +1,93 @@
+{
+  "name": "@openuidev/a2ui",
+  "version": "0.3.0",
+  "description": "A2UI v1.0 protocol support with OpenUI Lang component updates and React rendering",
+  "license": "MIT",
+  "type": "module",
+  "main": "dist/index.cjs",
+  "module": "dist/index.mjs",
+  "types": "dist/index.d.cts",
+  "sideEffects": false,
+  "files": [
+    "dist",
+    "README.md"
+  ],
+  "exports": {
+    ".": {
+      "import": {
+        "types": "./dist/index.d.mts",
+        "default": "./dist/index.mjs"
+      },
+      "require": {
+        "types": "./dist/index.d.cts",
+        "default": "./dist/index.cjs"
+      }
+    },
+    "./react": {
+      "import": {
+        "types": "./dist/react.d.mts",
+        "default": "./dist/react.mjs"
+      },
+      "require": {
+        "types": "./dist/react.d.cts",
+        "default": "./dist/react.cjs"
+      }
+    }
+  },
+  "keywords": [
+    "a2ui",
+    "openui",
+    "openui-lang",
+    "generative-ui",
+    "renderer",
+    "protocol"
+  ],
+  "homepage": "https://openui.com",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/thesysdev/openui.git",
+    "directory": "packages/a2ui"
+  },
+  "bugs": {
+    "url": "https://github.com/thesysdev/openui/issues"
+  },
+  "author": "engineering@thesys.dev",
+  "dependencies": {
+    "@openuidev/lang-core": "^0.3.0"
+  },
+  "peerDependencies": {
+    "@openuidev/react-lang": ">=0.3.0 <0.4.0",
+    "react": "^18.3.1 || ^19.0.0",
+    "zod": "^3.25.0 || ^4.0.0"
+  },
+  "peerDependenciesMeta": {
+    "@openuidev/react-lang": {
+      "optional": true
+    },
+    "react": {
+      "optional": true
+    }
+  },
+  "devDependencies": {
+    "@types/react": ">=19.0.0",
+    "@types/react-dom": ">=19.0.0",
+    "jsdom": "^26.1.0",
+    "react": "^18.3.1 || ^19.0.0",
+    "react-dom": "^18.0.0 || ^19.0.0",
+    "vitest": "^4.0.18",
+    "@openuidev/react-lang": "^0.3.0"
+  },
+  "scripts": {
+    "test": "vitest run",
+    "build": "tsdown",
+    "watch": "tsdown --watch",
+    "typecheck": "tsc --noEmit",
+    "lint:check": "eslint ./src",
+    "lint:fix": "eslint ./src --fix",
+    "format:fix": "prettier --write ./src README.md",
+    "format:check": "prettier --check ./src README.md",
+    "check:publint": "publint",
+    "check:attw": "attw --pack . --ignore-rules=no-resolution",
+    "ci": "pnpm run lint:check && pnpm run format:check"
+  }
+}