@lynx-js/genui 0.0.1-rc.0

package/a2ui/dist/react/A2UIRenderer.js

@@ -0,0 +1,161 @@
+import { jsx as _jsx, jsxs as _jsxs, Fragment as _Fragment } 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 { memo, useEffect, useMemo, useSyncExternalStore } from '@lynx-js/react';
+import { useA2UIContext } from './useA2UIContext.js';
+import { useAction } from './useAction.js';
+import { useCatalog } from './useCatalog.js';
+import { splitUnsupportedProps, useResolvedProps } from './useDataBinding.js';
+const noop = () => {
+    /* no-op subscribe disposer */
+};
+const noopSubscribe = () => noop;
+const emptySnapshot = {
+    status: 'pending',
+    value: undefined,
+    error: undefined,
+};
+const returnEmptySnapshot = () => emptySnapshot;
+const warnedTags = new Set();
+function DefaultLoading(props) {
+    const content = `loading ${props.id}...`;
+    return (_jsx("view", { style: {
+            width: '100%',
+            minHeight: '20px',
+            padding: '10px',
+            border: '1px solid var(--a2ui-color-border)',
+            borderRadius: '4px',
+            backgroundColor: 'var(--a2ui-color-surface-muted)',
+            color: 'var(--a2ui-color-text-muted)',
+        }, children: _jsx("text", { style: { color: 'inherit' }, children: content }) }));
+}
+function DefaultUnsupportedNotice(props) {
+    return (_jsx("view", { style: {
+            width: '100%',
+            minHeight: '20px',
+            marginBottom: '8px',
+            padding: '6px',
+            borderRadius: '6px',
+            border: '1px dashed var(--a2ui-color-border)',
+            backgroundColor: 'var(--a2ui-color-surface-muted)',
+            color: 'var(--a2ui-color-text-muted)',
+        }, children: _jsxs("text", { style: { color: 'inherit', fontSize: '10px', lineHeight: '12px' }, children: ["Unsupported ", props.kind, " in ", props.id] }) }));
+}
+function buildNodeRecursive(component, surface, catalog, renderUnsupported, props, setValue, sendAction) {
+    const tag = component.component;
+    const Component = catalog.get(tag);
+    const renderUnsupportedNotice = (info) => {
+        if (typeof renderUnsupported === 'function') {
+            return renderUnsupported(info);
+        }
+        return _jsx(DefaultUnsupportedNotice, { ...info });
+    };
+    if (!Component) {
+        return renderUnsupportedNotice({
+            id: component.id ?? '',
+            tag,
+            kind: 'component',
+        });
+    }
+    const { unsupportedFields, displayProps } = splitUnsupportedProps(props);
+    return (_jsxs(_Fragment, { children: [unsupportedFields.length > 0
+                ? (renderUnsupportedNotice({
+                    id: component.id ?? '',
+                    tag,
+                    kind: 'syntax',
+                    fields: unsupportedFields,
+                }))
+                : null, _jsx(Component, { ...displayProps, id: component.id ?? '', surface: surface, setValue: setValue, sendAction: (a) => {
+                    void sendAction?.(a);
+                }, dataContextPath: component.dataContextPath }, component.id)] }));
+}
+function A2UIRendererImpl(props) {
+    const { resource, renderUnsupported, wrapSurface, renderFallback, renderError, className: surfaceClassName = 'surface-root', } = props;
+    // Eagerly read context so the renderer fails clearly outside <A2UIProvider>.
+    useCatalog();
+    const snapshot = useSyncExternalStore(resource.subscribe, resource.getSnapshot, resource.getSnapshot);
+    const data = snapshot.value;
+    const status = snapshot.status;
+    const error = snapshot.error;
+    if (status === 'pending' && data === undefined) {
+        // Use a ternary instead of `??` so consumers can return `null` from
+        // the override callback to suppress the built-in placeholder.
+        return renderFallback
+            ? renderFallback()
+            : _jsx(DefaultLoading, { id: resource.id });
+    }
+    if (status === 'error') {
+        return renderError
+            ? renderError(error)
+            : _jsxs("text", { children: ["Error: ", String(error)] });
+    }
+    if (!data)
+        return null;
+    const dataObj = data;
+    const type = dataObj['type'];
+    const surfaceId = dataObj['surfaceId'];
+    const surface = dataObj['surface'];
+    const component = dataObj['component'];
+    if (type === 'beginRendering') {
+        const id = surface.rootComponentId;
+        const childResource = surface.resources.get(id);
+        if (!childResource)
+            return null;
+        const childProps = { resource: childResource };
+        if (wrapSurface)
+            childProps.wrapSurface = wrapSurface;
+        if (renderFallback)
+            childProps.renderFallback = renderFallback;
+        if (renderError)
+            childProps.renderError = renderError;
+        if (renderUnsupported)
+            childProps.renderUnsupported = renderUnsupported;
+        const inner = (_jsx("view", { id: `surface-${surfaceId}`, className: surfaceClassName, children: _jsx(A2UIRenderer, { ...childProps }) }));
+        return wrapSurface ? wrapSurface(inner, { surfaceId }) : inner;
+    }
+    if (type === 'surfaceUpdate' && component) {
+        return (_jsx(NodeRenderer, { component: component, surface: surface, renderUnsupported: renderUnsupported }));
+    }
+    if (type === 'deleteSurface') {
+        return null;
+    }
+    return null;
+}
+export const A2UIRenderer = memo(A2UIRendererImpl);
+function NodeRendererImpl(props) {
+    const { component: initialComponent, surface, renderUnsupported, } = props;
+    const { catalog: activeCatalog, processor } = useA2UIContext();
+    const catalog = useCatalog();
+    const resource = surface.resources.get(initialComponent.id);
+    const latest = useSyncExternalStore(resource ? resource.subscribe : noopSubscribe, resource ? resource.getSnapshot : returnEmptySnapshot, resource ? resource.getSnapshot : returnEmptySnapshot);
+    const component = latest.value?.component
+        ?? initialComponent;
+    const effectiveComponent = initialComponent.dataContextPath !== undefined
+        && component.dataContextPath !== initialComponent.dataContextPath
+        ? { ...component, dataContextPath: initialComponent.dataContextPath }
+        : component;
+    useEffect(() => {
+        const tag = effectiveComponent.component;
+        if (!catalog.has(tag) && !warnedTags.has(tag)) {
+            warnedTags.add(tag);
+            console.warn(`[a2ui] Component "${tag}" is not in the active catalog.`);
+        }
+    }, [effectiveComponent.component, catalog]);
+    const [resolvedProps, setValue] = useResolvedProps(effectiveComponent, surface, effectiveComponent.dataContextPath, processor, activeCatalog.functions);
+    const actionProps = useMemo(() => ({
+        id: effectiveComponent.id,
+        surfaceId: surface.surfaceId,
+        dataContext: effectiveComponent.dataContextPath,
+    }), [
+        effectiveComponent.id,
+        surface.surfaceId,
+        effectiveComponent.dataContextPath,
+    ]);
+    const { sendAction } = useAction(actionProps);
+    return (buildNodeRecursive(effectiveComponent, surface, catalog, renderUnsupported, resolvedProps, setValue, (a) => {
+        void sendAction(a);
+    }));
+}
+export const NodeRenderer = NodeRendererImpl;
+//# sourceMappingURL=A2UIRenderer.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"A2UIRenderer.js","sourceRoot":"","sources":["../../src/react/A2UIRenderer.tsx"],"names":[],"mappings":";AAAA,wDAAwD;AACxD,yEAAyE;AACzE,0DAA0D;AAC1D,OAAO,EAAE,IAAI,EAAE,SAAS,EAAE,OAAO,EAAE,oBAAoB,EAAE,MAAM,gBAAgB,CAAC;AAGhF,OAAO,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAC;AACrD,OAAO,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAC;AAC3C,OAAO,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAC;AAC7C,OAAO,EAAE,qBAAqB,EAAE,gBAAgB,EAAE,MAAM,qBAAqB,CAAC;AAG9E,MAAM,IAAI,GAAG,GAAG,EAAE;IAChB,8BAA8B;AAChC,CAAC,CAAC;AACF,MAAM,aAAa,GAAG,GAAe,EAAE,CAAC,IAAI,CAAC;AAC7C,MAAM,aAAa,GAAG;IACpB,MAAM,EAAE,SAAkB;IAC1B,KAAK,EAAE,SAAS;IAChB,KAAK,EAAE,SAAS;CACjB,CAAC;AACF,MAAM,mBAAmB,GAAG,GAAG,EAAE,CAAC,aAAa,CAAC;AAChD,MAAM,UAAU,GAAG,IAAI,GAAG,EAAU,CAAC;AASrC,SAAS,cAAc,CAAC,KAAqB;IAC3C,MAAM,OAAO,GAAG,WAAW,KAAK,CAAC,EAAE,KAAK,CAAC;IACzC,OAAO,CACL,eACE,KAAK,EAAE;YACL,KAAK,EAAE,MAAM;YACb,SAAS,EAAE,MAAM;YACjB,OAAO,EAAE,MAAM;YACf,MAAM,EAAE,oCAAoC;YAC5C,YAAY,EAAE,KAAK;YACnB,eAAe,EAAE,iCAAiC;YAClD,KAAK,EAAE,8BAA8B;SACtC,YAED,eAAM,KAAK,EAAE,EAAE,KAAK,EAAE,SAAS,EAAE,YAAG,OAAO,GAAQ,GAC9C,CACR,CAAC;AACJ,CAAC;AAED,SAAS,wBAAwB,CAAC,KAAsB;IACtD,OAAO,CACL,eACE,KAAK,EAAE;YACL,KAAK,EAAE,MAAM;YACb,SAAS,EAAE,MAAM;YACjB,YAAY,EAAE,KAAK;YACnB,OAAO,EAAE,KAAK;YACd,YAAY,EAAE,KAAK;YACnB,MAAM,EAAE,qCAAqC;YAC7C,eAAe,EAAE,iCAAiC;YAClD,KAAK,EAAE,8BAA8B;SACtC,YAED,gBAAM,KAAK,EAAE,EAAE,KAAK,EAAE,SAAS,EAAE,QAAQ,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,EAAE,6BACxD,KAAK,CAAC,IAAI,UAAM,KAAK,CAAC,EAAE,IAChC,GACF,CACR,CAAC;AACJ,CAAC;AAED,SAAS,kBAAkB,CACzB,SAA4B,EAC5B,OAAgB,EAChB,OAA2E,EAC3E,iBAEa,EACb,KAA+B,EAC/B,QAAgD,EAChD,UAAsD;IAEtD,MAAM,GAAG,GAAG,SAAS,CAAC,SAAS,CAAC;IAChC,MAAM,SAAS,GAAG,OAAO,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;IACnC,MAAM,uBAAuB,GAAG,CAAC,IAAqB,EAAE,EAAE;QACxD,IAAI,OAAO,iBAAiB,KAAK,UAAU,EAAE,CAAC;YAC5C,OAAO,iBAAiB,CAAC,IAAI,CAAC,CAAC;QACjC,CAAC;QACD,OAAO,KAAC,wBAAwB,OAAK,IAAI,GAAI,CAAC;IAChD,CAAC,CAAC;IACF,IAAI,CAAC,SAAS,EAAE,CAAC;QACf,OAAO,uBAAuB,CAAC;YAC7B,EAAE,EAAE,SAAS,CAAC,EAAE,IAAI,EAAE;YACtB,GAAG;YACH,IAAI,EAAE,WAAW;SAClB,CAAC,CAAC;IACL,CAAC;IACD,MAAM,EAAE,iBAAiB,EAAE,YAAY,EAAE,GAAG,qBAAqB,CAAC,KAAK,CAAC,CAAC;IACzE,OAAO,CACL,8BACG,iBAAiB,CAAC,MAAM,GAAG,CAAC;gBAC3B,CAAC,CAAC,CACA,uBAAuB,CAAC;oBACtB,EAAE,EAAE,SAAS,CAAC,EAAE,IAAI,EAAE;oBACtB,GAAG;oBACH,IAAI,EAAE,QAAQ;oBACd,MAAM,EAAE,iBAAiB;iBAC1B,CAAC,CACH;gBACD,CAAC,CAAC,IAAI,EACR,KAAC,SAAS,OAOH,YAAY,EAEjB,EAAE,EAAE,SAAS,CAAC,EAAE,IAAI,EAAE,EACtB,OAAO,EAAE,OAAO,EAChB,QAAQ,EAAE,QAAQ,EAClB,UAAU,EAAE,CAAC,CAA0B,EAAE,EAAE;oBACzC,KAAK,UAAU,EAAE,CAAC,CAAC,CAAC,CAAC;gBACvB,CAAC,EACD,eAAe,EAAE,SAAS,CAAC,eAAe,IAdrC,SAAS,CAAC,EAAE,CAejB,IACD,CACJ,CAAC;AACJ,CAAC;AAqBD,SAAS,gBAAgB,CACvB,KAAwB;IAExB,MAAM,EACJ,QAAQ,EACR,iBAAiB,EACjB,WAAW,EACX,cAAc,EACd,WAAW,EACX,SAAS,EAAE,gBAAgB,GAAG,cAAc,GAC7C,GAAG,KAAK,CAAC;IACV,6EAA6E;IAC7E,UAAU,EAAE,CAAC;IAEb,MAAM,QAAQ,GAAG,oBAAoB,CACnC,QAAQ,CAAC,SAAS,EAClB,QAAQ,CAAC,WAAW,EACpB,QAAQ,CAAC,WAAW,CACrB,CAAC;IACF,MAAM,IAAI,GAAG,QAAQ,CAAC,KAAK,CAAC;IAC5B,MAAM,MAAM,GAAG,QAAQ,CAAC,MAAM,CAAC;IAC/B,MAAM,KAAK,GAAG,QAAQ,CAAC,KAAK,CAAC;IAE7B,IAAI,MAAM,KAAK,SAAS,IAAI,IAAI,KAAK,SAAS,EAAE,CAAC;QAC/C,oEAAoE;QACpE,8DAA8D;QAC9D,OAAO,cAAc;YACnB,CAAC,CAAC,cAAc,EAAE;YAClB,CAAC,CAAC,KAAC,cAAc,IAAC,EAAE,EAAE,QAAQ,CAAC,EAAE,GAAI,CAAC;IAC1C,CAAC;IAED,IAAI,MAAM,KAAK,OAAO,EAAE,CAAC;QACvB,OAAO,WAAW;YAChB,CAAC,CAAC,WAAW,CAAC,KAAK,CAAC;YACpB,CAAC,CAAC,sCAAc,MAAM,CAAC,KAAK,CAAC,IAAQ,CAAC;IAC1C,CAAC;IAED,IAAI,CAAC,IAAI;QAAE,OAAO,IAAI,CAAC;IAEvB,MAAM,OAAO,GAAG,IAA0C,CAAC;IAC3D,MAAM,IAAI,GAAG,OAAO,CAAC,MAAM,CAAW,CAAC;IACvC,MAAM,SAAS,GAAG,OAAO,CAAC,WAAW,CAAW,CAAC;IACjD,MAAM,OAAO,GAAG,OAAO,CAAC,SAAS,CAAY,CAAC;IAC9C,MAAM,SAAS,GAAG,OAAO,CAAC,WAAW,CAAkC,CAAC;IAExE,IAAI,IAAI,KAAK,gBAAgB,EAAE,CAAC;QAC9B,MAAM,EAAE,GAAG,OAAO,CAAC,eAAgB,CAAC;QACpC,MAAM,aAAa,GAAG,OAAO,CAAC,SAAS,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;QAChD,IAAI,CAAC,aAAa;YAAE,OAAO,IAAI,CAAC;QAChC,MAAM,UAAU,GAAsB,EAAE,QAAQ,EAAE,aAAa,EAAE,CAAC;QAClE,IAAI,WAAW;YAAE,UAAU,CAAC,WAAW,GAAG,WAAW,CAAC;QACtD,IAAI,cAAc;YAAE,UAAU,CAAC,cAAc,GAAG,cAAc,CAAC;QAC/D,IAAI,WAAW;YAAE,UAAU,CAAC,WAAW,GAAG,WAAW,CAAC;QACtD,IAAI,iBAAiB;YAAE,UAAU,CAAC,iBAAiB,GAAG,iBAAiB,CAAC;QAExE,MAAM,KAAK,GAAG,CACZ,eAAM,EAAE,EAAE,WAAW,SAAS,EAAE,EAAE,SAAS,EAAE,gBAAgB,YAC3D,KAAC,YAAY,OAAK,UAAU,GAAI,GAC3B,CACR,CAAC;QACF,OAAO,WAAW,CAAC,CAAC,CAAC,WAAW,CAAC,KAAK,EAAE,EAAE,SAAS,EAAE,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC;IACjE,CAAC;IAED,IAAI,IAAI,KAAK,eAAe,IAAI,SAAS,EAAE,CAAC;QAC1C,OAAO,CACL,KAAC,YAAY,IACX,SAAS,EAAE,SAAS,EACpB,OAAO,EAAE,OAAO,EAChB,iBAAiB,EAAE,iBAAiB,GACpC,CACH,CAAC;IACJ,CAAC;IAED,IAAI,IAAI,KAAK,eAAe,EAAE,CAAC;QAC7B,OAAO,IAAI,CAAC;IACd,CAAC;IAED,OAAO,IAAI,CAAC;AACd,CAAC;AAED,MAAM,CAAC,MAAM,YAAY,GAAG,IAAI,CAAC,gBAAgB,CAAC,CAAC;AAEnD,SAAS,gBAAgB,CACvB,KAMC;IAED,MAAM,EACJ,SAAS,EAAE,gBAAgB,EAC3B,OAAO,EACP,iBAAiB,GAClB,GAAG,KAAK,CAAC;IACV,MAAM,EAAE,OAAO,EAAE,aAAa,EAAE,SAAS,EAAE,GAAG,cAAc,EAAE,CAAC;IAC/D,MAAM,OAAO,GAAG,UAAU,EAAE,CAAC;IAE7B,MAAM,QAAQ,GAAG,OAAO,CAAC,SAAS,CAAC,GAAG,CAAC,gBAAgB,CAAC,EAAG,CAAC,CAAC;IAE7D,MAAM,MAAM,GAAG,oBAAoB,CACjC,QAAQ,CAAC,CAAC,CAAC,QAAQ,CAAC,SAAS,CAAC,CAAC,CAAC,aAAa,EAC7C,QAAQ,CAAC,CAAC,CAAC,QAAQ,CAAC,WAAW,CAAC,CAAC,CAAC,mBAAmB,EACrD,QAAQ,CAAC,CAAC,CAAC,QAAQ,CAAC,WAAW,CAAC,CAAC,CAAC,mBAAmB,CACtD,CAAC;IAEF,MAAM,SAAS,GACZ,MAAM,CAAC,KAAuD,EAAE,SAAS;WACrE,gBAAgB,CAAC;IACxB,MAAM,kBAAkB,GAAG,gBAAgB,CAAC,eAAe,KAAK,SAAS;WAClE,SAAS,CAAC,eAAe,KAAK,gBAAgB,CAAC,eAAe;QACnE,CAAC,CAAC,EAAE,GAAG,SAAS,EAAE,eAAe,EAAE,gBAAgB,CAAC,eAAe,EAAE;QACrE,CAAC,CAAC,SAAS,CAAC;IAEd,SAAS,CAAC,GAAG,EAAE;QACb,MAAM,GAAG,GAAG,kBAAkB,CAAC,SAAS,CAAC;QACzC,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,GAAG,CAAC,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC,GAAG,CAAC,EAAE,CAAC;YAC9C,UAAU,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;YACpB,OAAO,CAAC,IAAI,CAAC,qBAAqB,GAAG,iCAAiC,CAAC,CAAC;QAC1E,CAAC;IACH,CAAC,EAAE,CAAC,kBAAkB,CAAC,SAAS,EAAE,OAAO,CAAC,CAAC,CAAC;IAE5C,MAAM,CAAC,aAAa,EAAE,QAAQ,CAAC,GAAG,gBAAgB,CAChD,kBAAkB,EAClB,OAAO,EACP,kBAAkB,CAAC,eAAe,EAClC,SAAS,EACT,aAAa,CAAC,SAAS,CACxB,CAAC;IAEF,MAAM,WAAW,GAAG,OAAO,CACzB,GAAG,EAAE,CAAC,CAAC;QACL,EAAE,EAAE,kBAAkB,CAAC,EAAG;QAC1B,SAAS,EAAE,OAAO,CAAC,SAAS;QAC5B,WAAW,EAAE,kBAAkB,CAAC,eAAe;KAChD,CAAC,EACF;QACE,kBAAkB,CAAC,EAAE;QACrB,OAAO,CAAC,SAAS;QACjB,kBAAkB,CAAC,eAAe;KACnC,CACF,CAAC;IACF,MAAM,EAAE,UAAU,EAAE,GAAG,SAAS,CAAC,WAAW,CAAC,CAAC;IAE9C,OAAO,CACL,kBAAkB,CAChB,kBAAkB,EAClB,OAAO,EACP,OAGC,EACD,iBAAiB,EACjB,aAAa,EACb,QAAQ,EACR,CAAC,CAA0B,EAAE,EAAE;QAC7B,KAAK,UAAU,CAAC,CAAgD,CAAC,CAAC;IACpE,CAAC,CACF,CACF,CAAC;AACJ,CAAC;AAED,MAAM,CAAC,MAAM,YAAY,GAAG,gBAAgB,CAAC"}

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

@@ -0,0 +1,10 @@
+import { createContext } from '@lynx-js/react';
+import type { FormController } from '../store/FormController.js';
+export type { CheckFailure, CheckOutcome, FormController, } from '../store/FormController.js';
+export { createFormController } from '../store/FormController.js';
+/**
+ * React context exposing the nearest enclosing form controller, if any.
+ * Inputs use it to broadcast their check outcomes; Buttons use it to read
+ * `isValid` and disable themselves until every input passes.
+ */
+export declare const FormContext: ReturnType<typeof createContext<FormController | null>>;

package/a2ui/dist/react/FormContext.js

@@ -0,0 +1,12 @@
+// 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 } from '@lynx-js/react';
+export { createFormController } from '../store/FormController.js';
+/**
+ * React context exposing the nearest enclosing form controller, if any.
+ * Inputs use it to broadcast their check outcomes; Buttons use it to read
+ * `isValid` and disable themselves until every input passes.
+ */
+export const FormContext = createContext(null);
+//# sourceMappingURL=FormContext.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"FormContext.js","sourceRoot":"","sources":["../../src/react/FormContext.ts"],"names":[],"mappings":"AAAA,wDAAwD;AACxD,yEAAyE;AACzE,0DAA0D;AAC1D,OAAO,EAAE,aAAa,EAAE,MAAM,gBAAgB,CAAC;AAS/C,OAAO,EAAE,oBAAoB,EAAE,MAAM,4BAA4B,CAAC;AAElE;;;;GAIG;AACH,MAAM,CAAC,MAAM,WAAW,GAEpB,aAAa,CAAwB,IAAI,CAAC,CAAC"}

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

@@ -0,0 +1,8 @@
+export { A2UI } from './A2UI.js';
+export type { A2UIProps } from './A2UI.js';
+export { NodeRenderer } from './A2UIRenderer.js';
+export { useAction } from './useAction.js';
+export type { ActionProps } from './useAction.js';
+export { useDataBinding, useResolvedProps } from './useDataBinding.js';
+export { useChecks } from './useChecks.js';
+export type { CheckLike } from './useChecks.js';

package/a2ui/dist/react/index.js

@@ -0,0 +1,23 @@
+// 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.
+//
+// Public React surface. `<A2UI>` is the all-in-one component for
+// developers without protocol knowledge. The hooks + `NodeRenderer` are
+// the contract that custom catalog components plug into.
+//
+// `A2UIProvider`, `A2UIRenderer`, `A2UIContext`, `useA2UIContext`, and
+// `useCatalog` are intentionally NOT exported — they're internal details
+// of how `<A2UI>` mounts itself. Custom components don't need them.
+//
+// `FormContext` and `FormController` are also internal. `useChecks` reads
+// from `FormContext` so a follow-up PR can introduce a `<Form>` component
+// that aggregates input validity — exporting the context now would
+// pre-commit the package to a Provider-based API before there's a real
+// consumer to validate it.
+export { A2UI } from './A2UI.js';
+export { NodeRenderer } from './A2UIRenderer.js';
+export { useAction } from './useAction.js';
+export { useDataBinding, useResolvedProps } from './useDataBinding.js';
+export { useChecks } from './useChecks.js';
+//# sourceMappingURL=index.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/react/index.ts"],"names":[],"mappings":"AAAA,wDAAwD;AACxD,yEAAyE;AACzE,0DAA0D;AAC1D,EAAE;AACF,iEAAiE;AACjE,wEAAwE;AACxE,yDAAyD;AACzD,EAAE;AACF,uEAAuE;AACvE,yEAAyE;AACzE,oEAAoE;AACpE,EAAE;AACF,0EAA0E;AAC1E,0EAA0E;AAC1E,mEAAmE;AACnE,uEAAuE;AACvE,2BAA2B;AAC3B,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AAEjC,OAAO,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AACjD,OAAO,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAC;AAE3C,OAAO,EAAE,cAAc,EAAE,gBAAgB,EAAE,MAAM,qBAAqB,CAAC;AACvE,OAAO,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAC"}

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

@@ -0,0 +1,7 @@
+import type { A2UIInternalContext } from './A2UIProvider.js';
+/**
+ * Internal helper used by catalog-component hooks (`useAction`, the
+ * renderer, …) to reach the `<A2UI>`-owned context. NOT exported from
+ * the package.
+ */
+export declare function useA2UIContext(): A2UIInternalContext;

package/a2ui/dist/react/useA2UIContext.js

@@ -0,0 +1,19 @@
+// 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 { useContext } from '@lynx-js/react';
+import { A2UIContext } from './A2UIProvider.js';
+/**
+ * Internal helper used by catalog-component hooks (`useAction`, the
+ * renderer, …) to reach the `<A2UI>`-owned context. NOT exported from
+ * the package.
+ */
+export function useA2UIContext() {
+    const ctx = useContext(A2UIContext);
+    if (!ctx) {
+        throw new Error('[a2ui] Catalog-component hooks must be used inside a tree rendered '
+            + 'by `<A2UI>`.');
+    }
+    return ctx;
+}
+//# sourceMappingURL=useA2UIContext.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"useA2UIContext.js","sourceRoot":"","sources":["../../src/react/useA2UIContext.ts"],"names":[],"mappings":"AAAA,wDAAwD;AACxD,yEAAyE;AACzE,0DAA0D;AAC1D,OAAO,EAAE,UAAU,EAAE,MAAM,gBAAgB,CAAC;AAE5C,OAAO,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAGhD;;;;GAIG;AACH,MAAM,UAAU,cAAc;IAC5B,MAAM,GAAG,GAAG,UAAU,CAAC,WAAW,CAAC,CAAC;IACpC,IAAI,CAAC,GAAG,EAAE,CAAC;QACT,MAAM,IAAI,KAAK,CACb,qEAAqE;cACjE,cAAc,CACnB,CAAC;IACJ,CAAC;IACD,OAAO,GAAG,CAAC;AACb,CAAC"}

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

@@ -0,0 +1,9 @@
+import type * as v0_9 from '@a2ui/web_core/v0_9';
+export interface ActionProps {
+    id: string;
+    surfaceId: string;
+    dataContext?: string | undefined;
+}
+export declare function useAction(props: ActionProps): {
+    sendAction: (action: v0_9.Action) => Promise<unknown>;
+};

package/a2ui/dist/react/useAction.js

@@ -0,0 +1,38 @@
+import { useCallback } from '@lynx-js/react';
+import { useA2UIContext } from './useA2UIContext.js';
+import { executeFunctionCall, resolveDynamicValue, } from '../store/resolveFunctionCall.js';
+export function useAction(props) {
+    const { id, surfaceId, dataContext } = props;
+    const { catalog, processor } = useA2UIContext();
+    const sendAction = useCallback((action) => {
+        if ('functionCall' in action && action.functionCall) {
+            return Promise.resolve(executeFunctionCall(processor, action.functionCall, surfaceId, dataContext, { functions: catalog.functions }));
+        }
+        let name = 'unknownAction';
+        let context = {};
+        if ('event' in action && action.event) {
+            name = action.event.name;
+            const ctx = action.event.context;
+            if (ctx) {
+                const resolvedContext = {};
+                for (const [key, value] of Object.entries(ctx)) {
+                    resolvedContext[key] = resolveDynamicValue(processor, value, surfaceId, dataContext, { functions: catalog.functions });
+                }
+                context = resolvedContext;
+            }
+        }
+        const userAction = {
+            name,
+            surfaceId,
+            sourceComponentId: id,
+            timestamp: new Date().toISOString(),
+            context,
+        };
+        // Dispatch through the processor — `<A2UI>` listens via
+        // `processor.onEvent` and forwards the action to its `onAction`
+        // prop, which the developer wires to their agent.
+        return processor.dispatch({ userAction });
+    }, [id, surfaceId, dataContext, processor, catalog.functions]);
+    return { sendAction };
+}
+//# sourceMappingURL=useAction.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"useAction.js","sourceRoot":"","sources":["../../src/react/useAction.ts"],"names":[],"mappings":"AAKA,OAAO,EAAE,WAAW,EAAE,MAAM,gBAAgB,CAAC;AAE7C,OAAO,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAC;AACrD,OAAO,EACL,mBAAmB,EACnB,mBAAmB,GACpB,MAAM,iCAAiC,CAAC;AASzC,MAAM,UAAU,SAAS,CACvB,KAAkB;IAElB,MAAM,EAAE,EAAE,EAAE,SAAS,EAAE,WAAW,EAAE,GAAG,KAAK,CAAC;IAC7C,MAAM,EAAE,OAAO,EAAE,SAAS,EAAE,GAAG,cAAc,EAAE,CAAC;IAEhD,MAAM,UAAU,GAAG,WAAW,CAC5B,CAAC,MAAmB,EAAE,EAAE;QACtB,IAAI,cAAc,IAAI,MAAM,IAAI,MAAM,CAAC,YAAY,EAAE,CAAC;YACpD,OAAO,OAAO,CAAC,OAAO,CAAC,mBAAmB,CACxC,SAAS,EACT,MAAM,CAAC,YAAY,EACnB,SAAS,EACT,WAAW,EACX,EAAE,SAAS,EAAE,OAAO,CAAC,SAAS,EAAE,CACjC,CAAC,CAAC;QACL,CAAC;QAED,IAAI,IAAI,GAAG,eAAe,CAAC;QAC3B,IAAI,OAAO,GAA4B,EAAE,CAAC;QAE1C,IAAI,OAAO,IAAI,MAAM,IAAI,MAAM,CAAC,KAAK,EAAE,CAAC;YACtC,IAAI,GAAG,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC;YACzB,MAAM,GAAG,GAAG,MAAM,CAAC,KAAK,CAAC,OAA8C,CAAC;YACxE,IAAI,GAAG,EAAE,CAAC;gBACR,MAAM,eAAe,GAA4B,EAAE,CAAC;gBACpD,KAAK,MAAM,CAAC,GAAG,EAAE,KAAK,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,GAAG,CAAC,EAAE,CAAC;oBAC/C,eAAe,CAAC,GAAG,CAAC,GAAG,mBAAmB,CACxC,SAAS,EACT,KAAK,EACL,SAAS,EACT,WAAW,EACX,EAAE,SAAS,EAAE,OAAO,CAAC,SAAS,EAAE,CACjC,CAAC;gBACJ,CAAC;gBACD,OAAO,GAAG,eAAe,CAAC;YAC5B,CAAC;QACH,CAAC;QAED,MAAM,UAAU,GAAsB;YACpC,IAAI;YACJ,SAAS;YACT,iBAAiB,EAAE,EAAE;YACrB,SAAS,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE;YACnC,OAAO;SACR,CAAC;QAEF,wDAAwD;QACxD,gEAAgE;QAChE,kDAAkD;QAClD,OAAO,SAAS,CAAC,QAAQ,CAAC,EAAE,UAAU,EAAE,CAAC,CAAC;IAC5C,CAAC,EACD,CAAC,EAAE,EAAE,SAAS,EAAE,WAAW,EAAE,SAAS,EAAE,OAAO,CAAC,SAAS,CAAC,CAC3D,CAAC;IAEF,OAAO,EAAE,UAAU,EAAE,CAAC;AACxB,CAAC"}

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

@@ -0,0 +1,7 @@
+import type { CatalogComponent } from '../catalog/defineCatalog.js';
+/**
+ * Internal hook — returns the resolved name → component map. Used by the
+ * renderer and exposed for advanced custom components that want to peek
+ * at the active catalog.
+ */
+export declare function useCatalog(): ReadonlyMap<string, CatalogComponent>;

package/a2ui/dist/react/useCatalog.js

@@ -0,0 +1,13 @@
+// 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 { useA2UIContext } from './useA2UIContext.js';
+/**
+ * Internal hook — returns the resolved name → component map. Used by the
+ * renderer and exposed for advanced custom components that want to peek
+ * at the active catalog.
+ */
+export function useCatalog() {
+    return useA2UIContext().catalogMap;
+}
+//# sourceMappingURL=useCatalog.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"useCatalog.js","sourceRoot":"","sources":["../../src/react/useCatalog.ts"],"names":[],"mappings":"AAAA,wDAAwD;AACxD,yEAAyE;AACzE,0DAA0D;AAC1D,OAAO,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAC;AAGrD;;;;GAIG;AACH,MAAM,UAAU,UAAU;IACxB,OAAO,cAAc,EAAE,CAAC,UAAU,CAAC;AACrC,CAAC"}

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

@@ -0,0 +1,27 @@
+import type { CheckOutcome } from '../store/FormController.js';
+import type { Surface } from '../store/types.js';
+/**
+ * A v0.9 `CheckRule` is `{ condition, message }` where `condition` is a
+ * boolean, a `DataBinding`, or a `FunctionCall`. We accept the loose
+ * `unknown` shape so component props don't have to import the v0_9
+ * types just to pass them through.
+ */
+export interface CheckLike {
+    condition: unknown;
+    message: string;
+}
+/**
+ * Evaluate an input component's `checks` array reactively. Returns the
+ * current outcome plus the first failure message (handy for inline error
+ * rendering). When an enclosing `<FormContext.Provider>` exists, the input
+ * is also registered with it so Buttons in the same form can react to
+ * `isValid`.
+ */
+export declare function useChecks(options: {
+    checks: CheckLike[] | undefined;
+    componentId: string;
+    surface: Surface | undefined;
+    dataContextPath?: string | undefined;
+}): CheckOutcome & {
+    firstFailureMessage: string | undefined;
+};

package/a2ui/dist/react/useChecks.js

@@ -0,0 +1,76 @@
+// 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 { effect } from '@preact/signals';
+import { useContext, useEffect, useState } from '@lynx-js/react';
+import { FormContext } from './FormContext.js';
+import { useA2UIContext } from './useA2UIContext.js';
+import { executeFunctionCall, isDataBinding, isFunctionCall, resolveDynamicValue, } from '../store/resolveFunctionCall.js';
+function evaluateCondition(processor, condition, surfaceId, dataContextPath, functions) {
+    if (typeof condition === 'boolean')
+        return condition;
+    if (isFunctionCall(condition)) {
+        const result = executeFunctionCall(processor, condition, surfaceId, dataContextPath, { functions });
+        return Boolean(result);
+    }
+    if (isDataBinding(condition)) {
+        return Boolean(resolveDynamicValue(processor, condition, surfaceId, dataContextPath));
+    }
+    // Unknown shape — treat as passing rather than blocking the user.
+    return true;
+}
+function evaluateChecks(processor, checks, surface, dataContextPath, functions) {
+    if (!surface || !Array.isArray(checks) || checks.length === 0) {
+        return { ok: true, failures: [] };
+    }
+    const failures = [];
+    for (const rule of checks) {
+        const ok = evaluateCondition(processor, rule.condition, surface.surfaceId, dataContextPath, functions);
+        if (!ok) {
+            failures.push({
+                call: isFunctionCall(rule.condition)
+                    ? rule.condition.call
+                    : 'condition',
+                message: rule.message,
+            });
+        }
+    }
+    return { ok: failures.length === 0, failures };
+}
+/**
+ * Evaluate an input component's `checks` array reactively. Returns the
+ * current outcome plus the first failure message (handy for inline error
+ * rendering). When an enclosing `<FormContext.Provider>` exists, the input
+ * is also registered with it so Buttons in the same form can react to
+ * `isValid`.
+ */
+export function useChecks(options) {
+    const { checks, componentId, surface, dataContextPath } = options;
+    const { catalog, processor } = useA2UIContext();
+    const form = useContext(FormContext);
+    const [outcome, setOutcome] = useState(() => evaluateChecks(processor, checks, surface, dataContextPath, catalog.functions));
+    useEffect(() => {
+        if (!surface) {
+            setOutcome({ ok: true, failures: [] });
+            return;
+        }
+        const dispose = effect(() => {
+            const next = evaluateChecks(processor, checks, surface, dataContextPath, catalog.functions);
+            setOutcome(next);
+        });
+        return dispose;
+    }, [processor, checks, surface, dataContextPath, catalog.functions]);
+    useEffect(() => {
+        // Skip registration when no componentId is available — otherwise every
+        // unnamed input collides under the same '' key in the form controller.
+        if (!form || !componentId)
+            return;
+        return form.setOutcome(componentId, outcome);
+    }, [form, componentId, outcome]);
+    return {
+        ok: outcome.ok,
+        failures: outcome.failures,
+        firstFailureMessage: outcome.failures[0]?.message,
+    };
+}
+//# sourceMappingURL=useChecks.js.map

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

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

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

@@ -0,0 +1,10 @@
+import type { CatalogFunctionEntry } from '../catalog/defineCatalog.js';
+import type { MessageProcessor } from '../store/MessageProcessor.js';
+import type { Surface } from '../store/types.js';
+export declare function useDataBinding<T = unknown>(dynamicValue: unknown, surface: Surface | undefined, dataContextPath?: string, fallbackValue?: T): [T | undefined, (newValue: T) => void, string | undefined];
+export declare function splitUnsupportedProps(properties: Record<string, unknown> | undefined): {
+    unsupportedFields: string[];
+    displayProps: Record<string, unknown> | undefined;
+};
+export declare function resolveProperties(properties: Record<string, unknown>, surface: Surface | undefined, dataContextPath?: string, processor?: MessageProcessor, functions?: readonly CatalogFunctionEntry[]): Record<string, unknown>;
+export declare function useResolvedProps(properties: Record<string, unknown>, surface: Surface | undefined, dataContextPath?: string, processor?: MessageProcessor, functions?: readonly CatalogFunctionEntry[]): readonly [Record<string, unknown>, (key: string, value: unknown) => void];