@lynx-js/genui 0.0.1-rc.0

package/a2ui/dist/react/useDataBinding.js

@@ -0,0 +1,175 @@
+// 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 { useCallback, useMemo, useRef, useSyncExternalStore, } from '@lynx-js/react';
+import { isFunctionCall, resolveDynamicValue, } from '../store/resolveFunctionCall.js';
+const noop = () => {
+    /* no-op subscribe disposer */
+};
+const noopSubscribe = () => noop;
+const UNSUPPORTED_PROP = Symbol('a2ui.unsupported');
+function subscribeToSignal(signal) {
+    if (!signal)
+        return noopSubscribe;
+    return (cb) => effect(() => {
+        void signal.value;
+        cb();
+    });
+}
+export function useDataBinding(dynamicValue, surface, dataContextPath, fallbackValue) {
+    let path;
+    let initialValue;
+    if (typeof dynamicValue === 'string'
+        || typeof dynamicValue === 'number'
+        || typeof dynamicValue === 'boolean') {
+        // Preserve primitive type. A static `false` must stay falsy and
+        // numeric props must stay numeric — stringifying breaks consumers that
+        // expect `boolean | number` (e.g., `if (props.disabled)`).
+        initialValue = dynamicValue;
+    }
+    else if (dynamicValue
+        && typeof dynamicValue === 'object'
+        && 'path' in dynamicValue) {
+        path = dynamicValue['path'];
+    }
+    if (path && !path.startsWith('/')) {
+        if (dataContextPath) {
+            path = `${dataContextPath}/${path}`;
+        }
+        else {
+            path = `/${path}`;
+        }
+    }
+    const signal = surface?.store && path
+        ? surface.store.getSignal(path, typeof initialValue === 'string' ? initialValue : undefined)
+        : undefined;
+    const subscribe = useMemo(() => subscribeToSignal(signal), [signal]);
+    const getSnapshot = useCallback(() => signal?.value, [signal]);
+    const signalValue = useSyncExternalStore(subscribe, getSnapshot, getSnapshot);
+    const currentValue = path
+        ? (signalValue ?? initialValue ?? fallbackValue)
+        : (initialValue ?? fallbackValue);
+    const setValue = useCallback((newValue) => {
+        if (path && surface?.store) {
+            surface.store.update(path, newValue);
+        }
+    }, [path, surface]);
+    return [currentValue, setValue, path];
+}
+function isDataBinding(prop) {
+    return Boolean(prop
+        && typeof prop === 'object'
+        && 'path' in prop
+        && !('componentId' in prop));
+}
+function isCallExpression(prop) {
+    return Boolean(prop
+        && typeof prop === 'object'
+        && 'call' in prop
+        && 'args' in prop
+        && 'returnType' in prop);
+}
+export function splitUnsupportedProps(properties) {
+    const unsupportedFields = [];
+    if (!properties) {
+        return { unsupportedFields, displayProps: properties };
+    }
+    const nextProps = {};
+    let changed = false;
+    for (const [key, value] of Object.entries(properties)) {
+        if (value === UNSUPPORTED_PROP) {
+            unsupportedFields.push(key);
+            changed = true;
+            continue;
+        }
+        nextProps[key] = value;
+    }
+    return {
+        unsupportedFields,
+        displayProps: changed ? nextProps : properties,
+    };
+}
+export function resolveProperties(properties, surface, dataContextPath, processor, functions) {
+    if (!properties)
+        return properties;
+    const result = {};
+    for (const key in properties) {
+        const prop = properties[key];
+        if (isFunctionCall(prop) && surface && processor) {
+            result[key] = resolveDynamicValue(processor, prop, surface.surfaceId, dataContextPath, { functions });
+        }
+        else if (isDataBinding(prop)) {
+            let path = prop['path'];
+            if (path && typeof path === 'string' && !path.startsWith('/')) {
+                path = dataContextPath ? `${dataContextPath}/${path}` : `/${path}`;
+            }
+            if (path && surface?.store) {
+                const signal = surface.store.getSignal(path);
+                result[key] = signal.value;
+            }
+            else {
+                result[key] = undefined;
+            }
+        }
+        else if (isCallExpression(prop)) {
+            result[key] = UNSUPPORTED_PROP;
+        }
+        else if (typeof prop === 'string'
+            || typeof prop === 'number'
+            || typeof prop === 'boolean') {
+            result[key] = prop;
+        }
+        else {
+            result[key] = prop;
+        }
+    }
+    return result;
+}
+function shallowEqual(a, b) {
+    if (a === b)
+        return true;
+    const keysA = Object.keys(a);
+    const keysB = Object.keys(b);
+    if (keysA.length !== keysB.length)
+        return false;
+    for (const k of keysA) {
+        if (a[k] !== b[k])
+            return false;
+    }
+    return true;
+}
+export function useResolvedProps(properties, surface, dataContextPath, processor, functions) {
+    const cacheRef = useRef(null);
+    const computeSnapshot = useCallback(() => {
+        const next = resolveProperties(properties, surface, dataContextPath, processor, functions);
+        if (cacheRef.current && shallowEqual(cacheRef.current, next)) {
+            return cacheRef.current;
+        }
+        cacheRef.current = next;
+        return next;
+    }, [properties, surface, dataContextPath, processor, functions]);
+    const subscribe = useCallback((cb) => {
+        if (!surface?.store)
+            return noop;
+        return effect(() => {
+            resolveProperties(properties, surface, dataContextPath, processor, functions);
+            cb();
+        });
+    }, [properties, surface, dataContextPath, processor, functions]);
+    const resolved = useSyncExternalStore(subscribe, computeSnapshot, computeSnapshot);
+    const setValue = useCallback((key, value) => {
+        const prop = properties?.[key];
+        if (isDataBinding(prop)) {
+            let path = prop['path'];
+            if (path && surface?.store) {
+                if (!path.startsWith('/')) {
+                    path = dataContextPath ? `${dataContextPath}/${path}` : `/${path}`;
+                }
+                surface.store.update(path, value);
+            }
+        }
+    }, [properties, surface, dataContextPath]);
+    return [resolved, setValue];
+}
+//# sourceMappingURL=useDataBinding.js.map

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

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

package/a2ui/dist/store/FormController.d.ts

@@ -0,0 +1,23 @@
+import type { Signal } from '@preact/signals';
+export interface CheckFailure {
+    /** Name of the function call that returned a falsy condition. */
+    call: string;
+    /** Operator-friendly message attached to the failing check. */
+    message: string;
+}
+export interface CheckOutcome {
+    ok: boolean;
+    failures: CheckFailure[];
+}
+export interface FormController {
+    /** Reactive view of whether every registered input currently passes. */
+    isValid: Signal<boolean>;
+    /** Per-input outcomes, keyed by component id. */
+    outcomes: ReadonlyMap<string, Signal<CheckOutcome>>;
+    /**
+     * Register or update an input's outcome. The returned `dispose` removes
+     * the input from the form when it unmounts.
+     */
+    setOutcome(componentId: string, outcome: CheckOutcome): () => void;
+}
+export declare function createFormController(): FormController;

package/a2ui/dist/store/FormController.js

@@ -0,0 +1,40 @@
+// 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 { computed, signal } from '@preact/signals';
+export function createFormController() {
+    const inputs = new Map();
+    // Tick on add/remove so the membership change is itself a reactive
+    // dependency of `isValid` (per-outcome value changes are already reactive
+    // because we read `entry.value` inside the computed).
+    const membership = signal(0);
+    const isValid = computed(() => {
+        void membership.value;
+        for (const outcome of inputs.values()) {
+            if (!outcome.value.ok)
+                return false;
+        }
+        return true;
+    });
+    return {
+        isValid,
+        outcomes: inputs,
+        setOutcome(componentId, outcome) {
+            let entry = inputs.get(componentId);
+            if (entry) {
+                entry.value = outcome;
+            }
+            else {
+                entry = signal(outcome);
+                inputs.set(componentId, entry);
+                membership.value++;
+            }
+            return () => {
+                if (inputs.delete(componentId)) {
+                    membership.value++;
+                }
+            };
+        },
+    };
+}
+//# sourceMappingURL=FormController.js.map

package/a2ui/dist/store/FormController.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"FormController.js","sourceRoot":"","sources":["../../src/store/FormController.ts"],"names":[],"mappings":"AAAA,wDAAwD;AACxD,yEAAyE;AACzE,0DAA0D;AAC1D,OAAO,EAAE,QAAQ,EAAE,MAAM,EAAE,MAAM,iBAAiB,CAAC;AA2BnD,MAAM,UAAU,oBAAoB;IAClC,MAAM,MAAM,GAAG,IAAI,GAAG,EAAgC,CAAC;IACvD,mEAAmE;IACnE,0EAA0E;IAC1E,sDAAsD;IACtD,MAAM,UAAU,GAAG,MAAM,CAAC,CAAC,CAAC,CAAC;IAC7B,MAAM,OAAO,GAAG,QAAQ,CAAC,GAAG,EAAE;QAC5B,KAAK,UAAU,CAAC,KAAK,CAAC;QACtB,KAAK,MAAM,OAAO,IAAI,MAAM,CAAC,MAAM,EAAE,EAAE,CAAC;YACtC,IAAI,CAAC,OAAO,CAAC,KAAK,CAAC,EAAE;gBAAE,OAAO,KAAK,CAAC;QACtC,CAAC;QACD,OAAO,IAAI,CAAC;IACd,CAAC,CAAC,CAAC;IACH,OAAO;QACL,OAAO;QACP,QAAQ,EAAE,MAA8D;QACxE,UAAU,CAAC,WAAW,EAAE,OAAO;YAC7B,IAAI,KAAK,GAAG,MAAM,CAAC,GAAG,CAAC,WAAW,CAAC,CAAC;YACpC,IAAI,KAAK,EAAE,CAAC;gBACV,KAAK,CAAC,KAAK,GAAG,OAAO,CAAC;YACxB,CAAC;iBAAM,CAAC;gBACN,KAAK,GAAG,MAAM,CAAC,OAAO,CAAC,CAAC;gBACxB,MAAM,CAAC,GAAG,CAAC,WAAW,EAAE,KAAK,CAAC,CAAC;gBAC/B,UAAU,CAAC,KAAK,EAAE,CAAC;YACrB,CAAC;YACD,OAAO,GAAG,EAAE;gBACV,IAAI,MAAM,CAAC,MAAM,CAAC,WAAW,CAAC,EAAE,CAAC;oBAC/B,UAAU,CAAC,KAAK,EAAE,CAAC;gBACrB,CAAC;YACH,CAAC,CAAC;QACJ,CAAC;KACF,CAAC;AACJ,CAAC"}

package/a2ui/dist/store/FunctionRegistry.d.ts

@@ -0,0 +1,47 @@
+import type { Signal } from '@preact/signals';
+import type { MessageProcessor } from './MessageProcessor.js';
+/**
+ * Runtime context passed to client-side function implementations. It mirrors
+ * the small DataContext subset used by upstream A2UI basic functions while
+ * staying tied to this renderer's `MessageProcessor` + `SignalStore`.
+ */
+export interface FunctionCallContext {
+    processor: MessageProcessor;
+    surfaceId: string;
+    dataContextPath?: string | undefined;
+    resolveDynamicValue(value: unknown): unknown;
+    resolveSignal(value: unknown): Signal<unknown>;
+    set(path: string, value: unknown): void;
+}
+/**
+ * Function implementations live on the client; the agent only references
+ * functions by name. The registry is the bridge from the wire-level
+ * `FunctionCall.call` string to the actual code that runs locally.
+ */
+export type FunctionImpl = (args: Record<string, unknown>, context?: FunctionCallContext) => unknown;
+/**
+ * Structured definition announced to the agent during catalog handshake.
+ * Kept here (in store/) so callers in both `catalog/` and `react/` can
+ * share the same shape without importing across the layering boundary.
+ */
+export interface FunctionDefinition {
+    name: string;
+    description?: string;
+    parameters: Record<string, unknown>;
+    returnType: 'string' | 'number' | 'boolean' | 'array' | 'object' | 'any' | 'void';
+}
+export interface FunctionEntry {
+    name: string;
+    /** Optional function definition announced to the agent as part of the handshake. */
+    definition?: FunctionDefinition | undefined;
+    impl: FunctionImpl;
+}
+export declare class FunctionRegistry {
+    private readonly entries;
+    register(entry: FunctionEntry): void;
+    unregister(name: string): void;
+    has(name: string): boolean;
+    resolve(name: string): FunctionImpl | undefined;
+    list(): FunctionEntry[];
+}
+export declare const functionRegistry: FunctionRegistry;

package/a2ui/dist/store/FunctionRegistry.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.
+export class FunctionRegistry {
+    entries = new Map();
+    register(entry) {
+        this.entries.set(entry.name, entry);
+    }
+    unregister(name) {
+        this.entries.delete(name);
+    }
+    has(name) {
+        return this.entries.has(name);
+    }
+    resolve(name) {
+        return this.entries.get(name)?.impl;
+    }
+    list() {
+        return Array.from(this.entries.values());
+    }
+}
+export const functionRegistry = new FunctionRegistry();
+//# sourceMappingURL=FunctionRegistry.js.map

package/a2ui/dist/store/FunctionRegistry.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"FunctionRegistry.js","sourceRoot":"","sources":["../../src/store/FunctionRegistry.ts"],"names":[],"mappings":"AAAA,wDAAwD;AACxD,yEAAyE;AACzE,0DAA0D;AAwD1D,MAAM,OAAO,gBAAgB;IACV,OAAO,GAAG,IAAI,GAAG,EAAyB,CAAC;IAE5D,QAAQ,CAAC,KAAoB;QAC3B,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,IAAI,EAAE,KAAK,CAAC,CAAC;IACtC,CAAC;IAED,UAAU,CAAC,IAAY;QACrB,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC;IAC5B,CAAC;IAED,GAAG,CAAC,IAAY;QACd,OAAO,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;IAChC,CAAC;IAED,OAAO,CAAC,IAAY;QAClB,OAAO,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC,EAAE,IAAI,CAAC;IACtC,CAAC;IAED,IAAI;QACF,OAAO,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,OAAO,CAAC,MAAM,EAAE,CAAC,CAAC;IAC3C,CAAC;CACF;AAED,MAAM,CAAC,MAAM,gBAAgB,GAAqB,IAAI,gBAAgB,EAAE,CAAC"}

package/a2ui/dist/store/MessageProcessor.d.ts

@@ -0,0 +1,28 @@
+import type { ServerToClientMessage, Surface } from './types.js';
+export interface A2UIEvent {
+    message: Record<string, unknown>;
+    resolve: (response: unknown) => void;
+}
+export declare class MessageProcessor {
+    surfaces: Map<string, Surface>;
+    private eventListeners;
+    private updateListeners;
+    constructor();
+    onUpdate(callback: (data: Record<string, unknown>) => void): () => void;
+    private emitUpdate;
+    dispatch(message: Record<string, unknown>): Promise<unknown>;
+    onEvent(callback: (event: A2UIEvent) => void): () => void;
+    getSurfaces(): ReadonlyMap<string, Surface>;
+    clearSurfaces(): void;
+    getOrCreateSurface(surfaceId: string): Surface;
+    /**
+     * Resolve a JSON Pointer taking into account the current data context.
+     *
+     * - Absolute paths (starting with '/') are returned as-is.
+     * - Relative paths are resolved against the provided dataContextPath.
+     */
+    resolvePath(path: string, dataContextPath?: string): string;
+    private cloneComponentTree;
+    private flattenValue;
+    processMessages(messages: ServerToClientMessage[]): void;
+}