@lynx-js/genui 0.0.1-rc.0

package/a2ui/dist/catalog/index.js

@@ -0,0 +1,26 @@
+// Copyright 2026 The Lynx Authors. All rights reserved.
+// Licensed under the Apache License Version 2.0 that can be found in the
+// LICENSE file in the root directory of this source tree.
+export { defineCatalog, defineFunction, mergeCatalogs, resolveCatalog, serializeCatalog, } from './defineCatalog.js';
+// Per-component re-exports so consumers can pick exactly what they need.
+// Each is an independently tree-shakeable ESM re-export — pulling `Text`
+// does not drag `Button` into the bundle.
+export { Button } from './Button/index.js';
+export { Card } from './Card/index.js';
+export { CheckBox } from './CheckBox/index.js';
+export { LineChart } from './LineChart/index.js';
+export { PieChart } from './PieChart/index.js';
+export { Column } from './Column/index.js';
+export { Divider } from './Divider/index.js';
+export { Icon } from './Icon/index.js';
+export { Image } from './Image/index.js';
+export { List } from './List/index.js';
+export { Modal } from './Modal/index.js';
+export { RadioGroup } from './RadioGroup/index.js';
+export { Row } from './Row/index.js';
+export { Slider } from './Slider/index.js';
+export { Tabs } from './Tabs/index.js';
+export { Text } from './Text/index.js';
+export { TextField } from './TextField/index.js';
+export { DEFAULT_CHART_COLORS, escapeXml, formatValue } from './utils/chart.js';
+//# sourceMappingURL=index.js.map

package/a2ui/dist/catalog/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/catalog/index.ts"],"names":[],"mappings":"AAAA,wDAAwD;AACxD,yEAAyE;AACzE,0DAA0D;AAC1D,OAAO,EACL,aAAa,EACb,cAAc,EACd,aAAa,EACb,cAAc,EACd,gBAAgB,GACjB,MAAM,oBAAoB,CAAC;AAc5B,yEAAyE;AACzE,yEAAyE;AACzE,0CAA0C;AAC1C,OAAO,EAAE,MAAM,EAAE,MAAM,mBAAmB,CAAC;AAC3C,OAAO,EAAE,IAAI,EAAE,MAAM,iBAAiB,CAAC;AACvC,OAAO,EAAE,QAAQ,EAAE,MAAM,qBAAqB,CAAC;AAC/C,OAAO,EAAE,SAAS,EAAE,MAAM,sBAAsB,CAAC;AACjD,OAAO,EAAE,QAAQ,EAAE,MAAM,qBAAqB,CAAC;AAC/C,OAAO,EAAE,MAAM,EAAE,MAAM,mBAAmB,CAAC;AAC3C,OAAO,EAAE,OAAO,EAAE,MAAM,oBAAoB,CAAC;AAC7C,OAAO,EAAE,IAAI,EAAE,MAAM,iBAAiB,CAAC;AACvC,OAAO,EAAE,KAAK,EAAE,MAAM,kBAAkB,CAAC;AACzC,OAAO,EAAE,IAAI,EAAE,MAAM,iBAAiB,CAAC;AACvC,OAAO,EAAE,KAAK,EAAE,MAAM,kBAAkB,CAAC;AACzC,OAAO,EAAE,UAAU,EAAE,MAAM,uBAAuB,CAAC;AACnD,OAAO,EAAE,GAAG,EAAE,MAAM,gBAAgB,CAAC;AACrC,OAAO,EAAE,MAAM,EAAE,MAAM,mBAAmB,CAAC;AAC3C,OAAO,EAAE,IAAI,EAAE,MAAM,iBAAiB,CAAC;AACvC,OAAO,EAAE,IAAI,EAAE,MAAM,iBAAiB,CAAC;AACvC,OAAO,EAAE,SAAS,EAAE,MAAM,sBAAsB,CAAC;AACjD,OAAO,EAAE,oBAAoB,EAAE,SAAS,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAC"}

package/a2ui/dist/catalog/utils/chart.d.ts

@@ -0,0 +1,3 @@
+export declare const DEFAULT_CHART_COLORS: readonly ["#0057d9", "#0a8f8f", "#8a5cf6", "#d92d20", "#2d6a4f", "#b26a00"];
+export declare function escapeXml(value: string): string;
+export declare function formatValue(value: number): string;

package/a2ui/dist/catalog/utils/chart.js

@@ -0,0 +1,28 @@
+// Copyright 2026 The Lynx Authors. All rights reserved.
+// Licensed under the Apache License Version 2.0 that can be found in the
+// LICENSE file in the root directory of this source tree.
+export const DEFAULT_CHART_COLORS = [
+    '#0057d9',
+    '#0a8f8f',
+    '#8a5cf6',
+    '#d92d20',
+    '#2d6a4f',
+    '#b26a00',
+];
+export function escapeXml(value) {
+    return value
+        .replace(/&/g, '&')
+        .replace(/</g, '&lt;')
+        .replace(/>/g, '&gt;')
+        .replace(/"/g, '&quot;')
+        .replace(/'/g, '&apos;');
+}
+export function formatValue(value) {
+    if (!Number.isFinite(value))
+        return '0';
+    const rounded = Math.abs(value) >= 1000
+        ? Math.round(value)
+        : Number(value.toFixed(1));
+    return String(rounded);
+}
+//# sourceMappingURL=chart.js.map

package/a2ui/dist/catalog/utils/chart.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"chart.js","sourceRoot":"","sources":["../../../src/catalog/utils/chart.ts"],"names":[],"mappings":"AAAA,wDAAwD;AACxD,yEAAyE;AACzE,0DAA0D;AAE1D,MAAM,CAAC,MAAM,oBAAoB,GAAG;IAClC,SAAS;IACT,SAAS;IACT,SAAS;IACT,SAAS;IACT,SAAS;IACT,SAAS;CACD,CAAC;AAEX,MAAM,UAAU,SAAS,CAAC,KAAa;IACrC,OAAO,KAAK;SACT,OAAO,CAAC,IAAI,EAAE,OAAO,CAAC;SACtB,OAAO,CAAC,IAAI,EAAE,MAAM,CAAC;SACrB,OAAO,CAAC,IAAI,EAAE,MAAM,CAAC;SACrB,OAAO,CAAC,IAAI,EAAE,QAAQ,CAAC;SACvB,OAAO,CAAC,IAAI,EAAE,QAAQ,CAAC,CAAC;AAC7B,CAAC;AAED,MAAM,UAAU,WAAW,CAAC,KAAa;IACvC,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,KAAK,CAAC;QAAE,OAAO,GAAG,CAAC;IACxC,MAAM,OAAO,GAAG,IAAI,CAAC,GAAG,CAAC,KAAK,CAAC,IAAI,IAAI;QACrC,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC;QACnB,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,CAAC;IAC7B,OAAO,MAAM,CAAC,OAAO,CAAC,CAAC;AACzB,CAAC"}

package/a2ui/dist/functions/index.d.ts

@@ -0,0 +1,19 @@
+import type { CatalogFunctionEntry } from '../catalog/defineCatalog.js';
+/**
+ * The A2UI 0.9 basic-catalog function implementations packaged as
+ * `CatalogFunctionEntry`s, ready to spread into `<A2UI catalogs={[...]}>`.
+ * The impls themselves come from `@a2ui/web_core` so we stay aligned with
+ * the upstream spec for free.
+ *
+ * @example
+ *   <A2UI catalogs={[Text, Button, ...basicFunctions]} ... />
+ */
+export declare const basicFunctions: readonly CatalogFunctionEntry[];
+/**
+ * Manual escape hatch for consumers who build their own renderer and don't
+ * go through `defineCatalog`. Registers every adapted basic-catalog impl
+ * into the shared `functionRegistry`. Calling more than once is harmless —
+ * later registrations override earlier ones, which is the intended override
+ * path.
+ */
+export declare function registerBasicFunctions(): void;

package/a2ui/dist/functions/index.js

@@ -0,0 +1,87 @@
+// Copyright 2026 The Lynx Authors. All rights reserved.
+// Licensed under the Apache License Version 2.0 that can be found in the
+// LICENSE file in the root directory of this source tree.
+import { Catalog as A2UICoreCatalog, MessageProcessor as A2UICoreMessageProcessor, isSignal, } from '@a2ui/web_core/v0_9';
+import { BASIC_FUNCTIONS } from '@a2ui/web_core/v0_9/basic_catalog';
+import { defineFunction } from '../catalog/defineCatalog.js';
+import { functionRegistry } from '../store/FunctionRegistry.js';
+const BASIC_CATALOG_ID = 'https://a2ui.org/specification/v0_9/basic_catalog.json';
+function createUpstreamContext(context) {
+    return {
+        resolveDynamicValue(value) {
+            return context?.resolveDynamicValue(value);
+        },
+        resolveSignal(value) {
+            return context?.resolveSignal(value);
+        },
+        set(path, value) {
+            context?.set(path, value);
+        },
+        path: context?.dataContextPath ?? '/',
+    };
+}
+/**
+ * Adapt an upstream `FunctionImplementation` (zod-typed args, returns a
+ * raw value OR a Preact Signal, takes a `DataContext`) into the simpler
+ * `(args) => unknown` shape the renderer's `executeFunctionCall` expects.
+ */
+function adaptUpstreamImpl(impl) {
+    return (args, context) => {
+        const safeArgs = impl.schema.parse(args);
+        const result = impl.execute(safeArgs, createUpstreamContext(context));
+        if (isSignal(result))
+            return result.value;
+        return result;
+    };
+}
+const adaptedBasicFunctionImpls = BASIC_FUNCTIONS.map(fn => ({
+    name: fn.name,
+    impl: adaptUpstreamImpl(fn),
+}));
+function createBasicFunctionManifests() {
+    const upstreamCatalog = new A2UICoreCatalog(BASIC_CATALOG_ID, [], BASIC_FUNCTIONS);
+    const processor = new A2UICoreMessageProcessor([upstreamCatalog]);
+    const inlineCatalog = processor.getClientCapabilities({
+        includeInlineCatalogs: true,
+    })['v0.9'].inlineCatalogs?.[0];
+    const definitions = inlineCatalog?.functions ?? [];
+    return new Map(definitions.map(definition => {
+        const typedDefinition = definition;
+        return [
+            typedDefinition.name,
+            { [typedDefinition.name]: typedDefinition },
+        ];
+    }));
+}
+const basicFunctionManifests = createBasicFunctionManifests();
+/**
+ * The A2UI 0.9 basic-catalog function implementations packaged as
+ * `CatalogFunctionEntry`s, ready to spread into `<A2UI catalogs={[...]}>`.
+ * The impls themselves come from `@a2ui/web_core` so we stay aligned with
+ * the upstream spec for free.
+ *
+ * @example
+ *   <A2UI catalogs={[Text, Button, ...basicFunctions]} ... />
+ */
+export const basicFunctions = adaptedBasicFunctionImpls
+    .map(({ name, impl }) => {
+    Object.defineProperty(impl, 'name', { value: name });
+    return defineFunction(impl, basicFunctionManifests.get(name));
+});
+/**
+ * Manual escape hatch for consumers who build their own renderer and don't
+ * go through `defineCatalog`. Registers every adapted basic-catalog impl
+ * into the shared `functionRegistry`. Calling more than once is harmless —
+ * later registrations override earlier ones, which is the intended override
+ * path.
+ */
+export function registerBasicFunctions() {
+    for (const entry of adaptedBasicFunctionImpls) {
+        const definition = basicFunctionManifests.get(entry.name)?.[entry.name];
+        functionRegistry.register({
+            ...entry,
+            ...(definition ? { definition } : {}),
+        });
+    }
+}
+//# sourceMappingURL=index.js.map

package/a2ui/dist/functions/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/functions/index.ts"],"names":[],"mappings":"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"}

package/a2ui/dist/index.d.ts

@@ -0,0 +1,11 @@
+export { A2UI, NodeRenderer, useAction, useChecks, useDataBinding, useResolvedProps, } from './react/index.js';
+export type { A2UIProps, ActionProps, CheckLike } from './react/index.js';
+export { createMessageStore, MessageProcessor } from './store/index.js';
+export type { A2UIClientEventMessage, ComponentInstance, GenericComponentProps, MessageStore, MessageStoreOptions, Resource, ResourceInfo, ServerToClientMessage, Surface, SurfaceId, UserActionPayload, } from './store/index.js';
+export { createFallbackMessagesFromPlainText, createTextCardMessages, normalizePayloadToMessages, prepareMessagesForProcessing, } from './store/index.js';
+export { executeFunctionCall, functionRegistry, FunctionRegistry, resolveDynamicValue, } from './store/index.js';
+export type { FunctionCallContext, FunctionEntry, FunctionImpl, ResolveFunctionOptions, } from './store/index.js';
+export { defineCatalog, defineFunction, mergeCatalogs, resolveCatalog, serializeCatalog, } from './catalog/index.js';
+export type { Catalog, CatalogComponent, CatalogFunctionDefinition, CatalogFunctionEntry, CatalogInput, CatalogManifest, CatalogSchema, FunctionManifest, ResolvedCatalogEntry, SerializedCatalog, } from './catalog/index.js';
+export { Button, Card, CheckBox, Column, Divider, Image, LineChart, PieChart, List, Modal, RadioGroup, Row, Slider, Tabs, Text, TextField, Icon, } from './catalog/index.js';
+export { basicFunctions, registerBasicFunctions } from './functions/index.js';

package/a2ui/dist/index.js

@@ -0,0 +1,35 @@
+// Copyright 2026 The Lynx Authors. All rights reserved.
+// Licensed under the Apache License Version 2.0 that can be found in the
+// LICENSE file in the root directory of this source tree.
+// React surface — `<A2UI>` is the all-in-one entry point. The hooks +
+// `NodeRenderer` are the contract for custom catalog components.
+export { A2UI, NodeRenderer, useAction, useChecks, useDataBinding, useResolvedProps, } from './react/index.js';
+// Store — a pure raw-message buffer. The developer's IO module pushes
+// protocol messages into it; `<A2UI>` subscribes and processes them.
+// `MessageProcessor` is exposed for protocol-aware consumers who want to
+// build their own renderer instead of using `<A2UI>`.
+export { createMessageStore, MessageProcessor } from './store/index.js';
+// Helpers for IO that returns free-form text instead of structured
+// protocol messages.
+export { createFallbackMessagesFromPlainText, createTextCardMessages, normalizePayloadToMessages, prepareMessagesForProcessing, } from './store/index.js';
+// Function registry primitives. Consumers building a custom renderer reach
+// the impls through these; `<A2UI>` consumers usually just spread
+// `basicFunctions` into `catalogs`.
+export { executeFunctionCall, functionRegistry, FunctionRegistry, resolveDynamicValue, } from './store/index.js';
+// Catalog — declarative composition.
+export { defineCatalog, defineFunction, mergeCatalogs, resolveCatalog, serializeCatalog, } from './catalog/index.js';
+// Built-in components — re-exported individually so apps can pick exactly
+// what they need:
+//
+//   import { Text, Button } from '@lynx-js/genui/a2ui';
+//   <A2UI catalogs={[Text, Button]} ... />
+//
+// There is intentionally no all-in-one aggregate — see
+// `packages/genui/a2ui/src/catalog/README.md`.
+export { Button, Card, CheckBox, Column, Divider, Image, LineChart, PieChart, List, Modal, RadioGroup, Row, Slider, Tabs, Text, TextField, Icon, } from './catalog/index.js';
+// A2UI 0.9 basic-catalog functions — registered + announced when spread
+// into `<A2UI catalogs={[..., ...basicFunctions]}>`. Impls come from
+// `@a2ui/web_core` (the upstream basic-catalog package), so the wire
+// contract stays aligned with the spec for free.
+export { basicFunctions, registerBasicFunctions } from './functions/index.js';
+//# sourceMappingURL=index.js.map

package/a2ui/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,wDAAwD;AACxD,yEAAyE;AACzE,0DAA0D;AAE1D,sEAAsE;AACtE,iEAAiE;AACjE,OAAO,EACL,IAAI,EACJ,YAAY,EACZ,SAAS,EACT,SAAS,EACT,cAAc,EACd,gBAAgB,GACjB,MAAM,kBAAkB,CAAC;AAG1B,sEAAsE;AACtE,qEAAqE;AACrE,yEAAyE;AACzE,sDAAsD;AACtD,OAAO,EAAE,kBAAkB,EAAE,gBAAgB,EAAE,MAAM,kBAAkB,CAAC;AAcxE,mEAAmE;AACnE,qBAAqB;AACrB,OAAO,EACL,mCAAmC,EACnC,sBAAsB,EACtB,0BAA0B,EAC1B,4BAA4B,GAC7B,MAAM,kBAAkB,CAAC;AAC1B,2EAA2E;AAC3E,kEAAkE;AAClE,oCAAoC;AACpC,OAAO,EACL,mBAAmB,EACnB,gBAAgB,EAChB,gBAAgB,EAChB,mBAAmB,GACpB,MAAM,kBAAkB,CAAC;AAQ1B,qCAAqC;AACrC,OAAO,EACL,aAAa,EACb,cAAc,EACd,aAAa,EACb,cAAc,EACd,gBAAgB,GACjB,MAAM,oBAAoB,CAAC;AAc5B,0EAA0E;AAC1E,kBAAkB;AAClB,EAAE;AACF,wDAAwD;AACxD,2CAA2C;AAC3C,EAAE;AACF,uDAAuD;AACvD,+CAA+C;AAC/C,OAAO,EACL,MAAM,EACN,IAAI,EACJ,QAAQ,EACR,MAAM,EACN,OAAO,EACP,KAAK,EACL,SAAS,EACT,QAAQ,EACR,IAAI,EACJ,KAAK,EACL,UAAU,EACV,GAAG,EACH,MAAM,EACN,IAAI,EACJ,IAAI,EACJ,SAAS,EACT,IAAI,GACL,MAAM,oBAAoB,CAAC;AAE5B,wEAAwE;AACxE,qEAAqE;AACrE,qEAAqE;AACrE,iDAAiD;AACjD,OAAO,EAAE,cAAc,EAAE,sBAAsB,EAAE,MAAM,sBAAsB,CAAC"}

package/a2ui/dist/react/A2UI.d.ts

@@ -0,0 +1,77 @@
+import type { ReactNode } from '@lynx-js/react';
+import type { UnsupportedInfo } from './A2UIRenderer.js';
+import type { CatalogInput } from '../catalog/defineCatalog.js';
+import type { MessageStore } from '../store/MessageStore.js';
+import type { UserActionPayload } from '../store/types.js';
+export interface A2UIProps {
+    /**
+     * The raw-message buffer the developer pushes protocol messages into.
+     * `<A2UI>` subscribes via `useSyncExternalStore` and processes new
+     * messages incrementally.
+     *
+     * The internal `MessageProcessor` (surfaces, signals, resources) is
+     * created once per mount and is **not reset** if `messageStore` is
+     * later replaced with a different instance. Pass a `key` prop derived
+     * from the store's identity if you want a fresh session, e.g.
+     * `<A2UI key={turnId} messageStore={turnStore} ... />`.
+     */
+    messageStore: MessageStore;
+    /**
+     * Components the renderer is allowed to instantiate. Each item is either
+     * a bare component (name read from `displayName ?? name`) or a tuple
+     * `[component, manifest]` where the manifest is the JSON the extractor
+     * emits at `dist/catalog/<Name>/catalog.json`.
+     */
+    catalogs: readonly CatalogInput[];
+    /**
+     * Called when a user action fires inside the rendered tree (button
+     * tap, etc.). Forward to your agent and push the response messages
+     * back into the same `messageStore` to update the UI. Fire-and-forget;
+     * the renderer never awaits this.
+     */
+    onAction?: (action: UserActionPayload) => void;
+    /**
+     * Optional class name applied to the top-level `surface-${surfaceId}`
+     * view for the active surface. Use this when theme switching is
+     * expressed as surface-level classes.
+     */
+    className?: string;
+    /**
+     * Wrap each top-level surface so consumers can apply an outer theme
+     * shell, wrapper className, or additional styles.
+     */
+    wrapSurface?: (children: ReactNode, ctx: {
+        surfaceId: string;
+    }) => ReactNode;
+    /** Render before the first `beginRendering` arrives from the buffer. */
+    renderEmpty?: () => ReactNode;
+    /** Render while the active resource is pending. */
+    renderFallback?: () => ReactNode;
+    /** Render when the active resource fails. */
+    renderError?: (err: unknown) => ReactNode;
+    /** Render when unsupported data syntax or an unsupported component is encountered. */
+    renderUnsupported?: (info: UnsupportedInfo) => ReactNode;
+}
+/**
+ * The all-in-one A2UI component. Owns a `MessageProcessor` internally,
+ * processes raw messages from the buffer on each render, and renders
+ * the most recent `beginRendering` surface tree.
+ *
+ * @example
+ * const store = createMessageStore();
+ *
+ * // Developer's IO module pushes raw messages into the store.
+ * async function streamFromAgent(input: string) {
+ *   for await (const msg of myAgent.stream(input)) store.push(msg);
+ * }
+ *
+ * <A2UI
+ *   messageStore={store}
+ *   catalogs={[Text, Button, [Card, cardManifest]]}
+ *   onAction={(action) => { void streamFromAgent(serializeAction(action)); }}
+ *   wrapSurface={(c) => <view className='luna-light'>{c}</view>}
+ * />
+ */
+declare function A2UIImpl(props: A2UIProps): import('@lynx-js/react').ReactNode;
+export declare const A2UI: import("react").MemoExoticComponent<typeof A2UIImpl>;
+export {};

package/a2ui/dist/react/A2UI.js

@@ -0,0 +1,159 @@
+import { jsx as _jsx } from "@lynx-js/react/jsx-runtime";
+// Copyright 2026 The Lynx Authors. All rights reserved.
+// Licensed under the Apache License Version 2.0 that can be found in the
+// LICENSE file in the root directory of this source tree.
+import * as v0_9 from '@a2ui/web_core/v0_9';
+import { memo, useEffect, useMemo, useReducer, useRef, useSyncExternalStore, } from '@lynx-js/react';
+import { A2UIProvider } from './A2UIProvider.js';
+import { A2UIRenderer } from './A2UIRenderer.js';
+import { defineCatalog } from '../catalog/defineCatalog.js';
+import { MessageProcessor } from '../store/MessageProcessor.js';
+import { createResource } from '../store/Resource.js';
+// Mark v0_9 used so the namespace import doesn't get pruned. Kept around so
+// future enhancements (typed protocol message guards) don't need a fresh
+// import diff.
+void v0_9;
+/**
+ * The all-in-one A2UI component. Owns a `MessageProcessor` internally,
+ * processes raw messages from the buffer on each render, and renders
+ * the most recent `beginRendering` surface tree.
+ *
+ * @example
+ * const store = createMessageStore();
+ *
+ * // Developer's IO module pushes raw messages into the store.
+ * async function streamFromAgent(input: string) {
+ *   for await (const msg of myAgent.stream(input)) store.push(msg);
+ * }
+ *
+ * <A2UI
+ *   messageStore={store}
+ *   catalogs={[Text, Button, [Card, cardManifest]]}
+ *   onAction={(action) => { void streamFromAgent(serializeAction(action)); }}
+ *   wrapSurface={(c) => <view className='luna-light'>{c}</view>}
+ * />
+ */
+function A2UIImpl(props) {
+    const { messageStore, catalogs, onAction, wrapSurface, renderEmpty, renderFallback, renderError, renderUnsupported, className, } = props;
+    // Keep the latest onAction in a ref so the once-mounted processor.onEvent
+    // listener always calls the up-to-date prop without re-binding.
+    const onActionRef = useRef(onAction);
+    useEffect(() => {
+        onActionRef.current = onAction;
+    }, [onAction]);
+    // Per-instance session. Created once; mutated as messages arrive.
+    const sessionRef = useRef(null);
+    sessionRef.current ??= {
+        processor: new MessageProcessor(),
+        resources: new Map(),
+        activeMessageId: null,
+        processedCount: 0,
+    };
+    const session = sessionRef.current;
+    // Counter used to force a re-render whenever the processor emits an
+    // update (new beginRendering, surfaceUpdate that mutated the active
+    // surface, deleteSurface). The processor's per-resource `onUpdate`
+    // already handles fine-grained updates inside the active surface;
+    // this is just for the activeResource pointer + first paint.
+    const [, forceUpdate] = useReducer((n) => n + 1, 0);
+    // Subscribe to the developer's raw buffer.
+    const messages = useSyncExternalStore(messageStore.subscribe, messageStore.getSnapshot, messageStore.getSnapshot);
+    // One-time wiring of processor → resource bookkeeping + onAction
+    // dispatch. The processor instance itself is stable across renders.
+    useEffect(() => {
+        const proc = session.processor;
+        const offUpdate = proc.onUpdate((data) => {
+            const { type, surfaceId, messageId } = data;
+            const surface = proc.getOrCreateSurface(surfaceId);
+            if (type === 'beginRendering') {
+                let resource = session.resources.get(messageId);
+                if (!resource) {
+                    resource = createResource(messageId);
+                    session.resources.set(messageId, resource);
+                }
+                resource.complete({ type: 'beginRendering', surfaceId, surface });
+                session.activeMessageId = messageId;
+                forceUpdate();
+            }
+            else if (type === 'surfaceUpdate') {
+                const updates = data.updates ?? [];
+                for (const update of updates) {
+                    if (!update.id)
+                        continue;
+                    const r = surface.resources.get(update.id);
+                    r?.complete({
+                        type: 'surfaceUpdate',
+                        surfaceId,
+                        surface,
+                        component: update,
+                    });
+                }
+            }
+            else if (type === 'deleteSurface') {
+                const targetId = data.targetId
+                    ?? surface.rootComponentId;
+                if (targetId && surface.resources.has(targetId)) {
+                    surface.resources.get(targetId).complete({
+                        type: 'deleteSurface',
+                        surfaceId,
+                        surface,
+                    });
+                }
+                forceUpdate();
+            }
+        });
+        const offEvent = proc.onEvent(({ message, resolve }) => {
+            // Empty resolve — there is no "response" channel from the renderer
+            // back into the protocol. Responses arrive via the buffer.
+            resolve([]);
+            if (typeof message === 'object' && message !== null
+                && 'userAction' in message
+                && message.userAction) {
+                const action = message.userAction;
+                try {
+                    onActionRef.current?.(action);
+                }
+                catch (e) {
+                    console.error('[a2ui] onAction handler threw:', e);
+                }
+            }
+        });
+        return () => {
+            offUpdate();
+            offEvent();
+        };
+    }, [session]);
+    // Process any new messages in the buffer.
+    useEffect(() => {
+        if (messages.length === session.processedCount)
+            return;
+        const slice = messages.slice(session.processedCount);
+        session.processedCount = messages.length;
+        if (slice.length > 0) {
+            session.processor.processMessages(slice);
+        }
+    }, [messages, session]);
+    const catalog = useMemo(() => defineCatalog(catalogs), [catalogs]);
+    const activeResource = session.activeMessageId
+        ? (session.resources.get(session.activeMessageId) ?? null)
+        : null;
+    if (!activeResource) {
+        return renderEmpty?.() ?? null;
+    }
+    const rendererProps = {
+        resource: activeResource,
+    };
+    if (className !== undefined)
+        rendererProps.className = className;
+    if (wrapSurface)
+        rendererProps.wrapSurface = wrapSurface;
+    if (renderFallback)
+        rendererProps.renderFallback = renderFallback;
+    if (renderError)
+        rendererProps.renderError = renderError;
+    if (renderUnsupported)
+        rendererProps.renderUnsupported = renderUnsupported;
+    return (_jsx(A2UIProvider, { processor: session.processor, catalog: catalog, children: _jsx(A2UIRenderer, { ...rendererProps }) }));
+}
+export const A2UI = memo(A2UIImpl);
+//# sourceMappingURL=A2UI.js.map

package/a2ui/dist/react/A2UI.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"A2UI.js","sourceRoot":"","sources":["../../src/react/A2UI.tsx"],"names":[],"mappings":"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"}

package/a2ui/dist/react/A2UIProvider.d.ts

@@ -0,0 +1,25 @@
+import type { ReactNode } from '@lynx-js/react';
+import type { Catalog, CatalogComponent } from '../catalog/defineCatalog.js';
+import type { MessageProcessor } from '../store/MessageProcessor.js';
+/**
+ * The context value `<A2UI>` provides to its catalog-component subtree.
+ * Internal — neither the context nor the provider is part of the public
+ * API. Catalog components reach this value via `useAction`,
+ * `useDataBinding`, etc.
+ */
+export interface A2UIInternalContext {
+    processor: MessageProcessor;
+    catalog: Catalog;
+    catalogMap: ReadonlyMap<string, CatalogComponent>;
+}
+export declare const A2UIContext: import("react").Context<A2UIInternalContext | null>;
+interface ProviderProps {
+    processor: MessageProcessor;
+    catalog: Catalog;
+    children: ReactNode;
+}
+/**
+ * Internal provider mounted by `<A2UI>`. Not exported from the package.
+ */
+export declare function A2UIProvider(props: ProviderProps): import('@lynx-js/react').ReactNode;
+export {};

package/a2ui/dist/react/A2UIProvider.js

@@ -0,0 +1,20 @@
+import { jsx as _jsx } from "@lynx-js/react/jsx-runtime";
+// Copyright 2026 The Lynx Authors. All rights reserved.
+// Licensed under the Apache License Version 2.0 that can be found in the
+// LICENSE file in the root directory of this source tree.
+import { createContext, useMemo } from '@lynx-js/react';
+import { resolveCatalog } from '../catalog/defineCatalog.js';
+export const A2UIContext = createContext(null);
+/**
+ * Internal provider mounted by `<A2UI>`. Not exported from the package.
+ */
+export function A2UIProvider(props) {
+    const { processor, catalog, children } = props;
+    const value = useMemo(() => ({
+        processor,
+        catalog,
+        catalogMap: resolveCatalog(catalog),
+    }), [processor, catalog]);
+    return _jsx(A2UIContext.Provider, { value: value, children: children });
+}
+//# sourceMappingURL=A2UIProvider.js.map

package/a2ui/dist/react/A2UIProvider.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"A2UIProvider.js","sourceRoot":"","sources":["../../src/react/A2UIProvider.tsx"],"names":[],"mappings":";AAAA,wDAAwD;AACxD,yEAAyE;AACzE,0DAA0D;AAC1D,OAAO,EAAE,aAAa,EAAE,OAAO,EAAE,MAAM,gBAAgB,CAAC;AAIxD,OAAO,EAAE,cAAc,EAAE,MAAM,6BAA6B,CAAC;AAe7D,MAAM,CAAC,MAAM,WAAW,GAAG,aAAa,CAA6B,IAAI,CAAC,CAAC;AAQ3E;;GAEG;AACH,MAAM,UAAU,YAAY,CAC1B,KAAoB;IAEpB,MAAM,EAAE,SAAS,EAAE,OAAO,EAAE,QAAQ,EAAE,GAAG,KAAK,CAAC;IAC/C,MAAM,KAAK,GAAG,OAAO,CACnB,GAAG,EAAE,CAAC,CAAC;QACL,SAAS;QACT,OAAO;QACP,UAAU,EAAE,cAAc,CAAC,OAAO,CAAC;KACpC,CAAC,EACF,CAAC,SAAS,EAAE,OAAO,CAAC,CACrB,CAAC;IACF,OAAO,KAAC,WAAW,CAAC,QAAQ,IAAC,KAAK,EAAE,KAAK,YAAG,QAAQ,GAAwB,CAAC;AAC/E,CAAC"}

package/a2ui/dist/react/A2UIRenderer.d.ts

@@ -0,0 +1,34 @@
+import type { ReactNode } from '@lynx-js/react';
+import type { ComponentInstance, Resource, Surface } from '../store/types.js';
+export interface UnsupportedInfo {
+    id: string;
+    tag: string;
+    kind: 'component' | 'syntax';
+    fields?: string[];
+}
+export interface A2UIRendererProps {
+    resource: Resource;
+    /** Optional class name applied to the top-level surface view. */
+    className?: string;
+    renderFallback?: () => ReactNode;
+    renderError?: (e: unknown) => ReactNode;
+    renderUnsupported?: (info: UnsupportedInfo) => ReactNode;
+    /**
+     * Wrap each top-level surface so consumers can apply an outer theme
+     * shell, wrapper className, or additional styles. The default does not
+     * wrap — that is intentional, the renderer is headless. Lynx-themed
+     * shells can use this together with `className` on the surface root.
+     */
+    wrapSurface?: (children: ReactNode, ctx: {
+        surfaceId: string;
+    }) => ReactNode;
+}
+declare function A2UIRendererImpl(props: A2UIRendererProps): import('@lynx-js/react').ReactNode;
+export declare const A2UIRenderer: import("react").MemoExoticComponent<typeof A2UIRendererImpl>;
+declare function NodeRendererImpl(props: {
+    component: ComponentInstance;
+    surface: Surface;
+    renderUnsupported?: ((info: UnsupportedInfo) => ReactNode) | undefined;
+}): import('@lynx-js/react').ReactNode;
+export declare const NodeRenderer: typeof NodeRendererImpl;
+export {};