@a2ui/web_core 0.8.0 → 0.9.1-alpha.0

package/src/v0_9/rendering/data-context.test.js

@@ -0,0 +1,379 @@
+/*
+ * Copyright 2025 Google LLC
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *      https://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+import assert from 'node:assert';
+import { describe, it, beforeEach } from 'node:test';
+import { signal, computed } from '@preact/signals-core';
+import { z } from 'zod';
+import { DataModel } from '../state/data-model.js';
+import { DataContext } from './data-context.js';
+import { A2uiExpressionError } from '../errors.js';
+const createTestDataContext = (model, path, functionInvoker = () => null, dispatchError = () => { }) => {
+    const mockSurface = {
+        dataModel: model,
+        catalog: { invoker: functionInvoker },
+        dispatchError,
+    };
+    return new DataContext(mockSurface, path);
+};
+describe('DataContext', () => {
+    let model;
+    let context;
+    beforeEach(() => {
+        model = new DataModel({
+            user: {
+                name: 'Alice',
+                address: {
+                    city: 'Wonderland',
+                },
+            },
+            list: ['a', 'b'],
+        });
+        context = createTestDataContext(model, '/user');
+    });
+    it('resolves relative paths', () => {
+        assert.strictEqual(context.resolveDynamicValue({ path: 'name' }), 'Alice');
+    });
+    it('resolves absolute paths', () => {
+        assert.strictEqual(context.resolveDynamicValue({ path: '/list/0' }), 'a');
+    });
+    it('resolves nested paths', () => {
+        assert.strictEqual(context.resolveDynamicValue({ path: 'address/city' }), 'Wonderland');
+    });
+    it('updates data via relative path', () => {
+        context.set('name', 'Bob');
+        assert.strictEqual(model.get('/user/name'), 'Bob');
+    });
+    it('creates nested context', () => {
+        const addressContext = context.nested('address');
+        assert.strictEqual(addressContext.path, '/user/address');
+        assert.strictEqual(addressContext.resolveDynamicValue({ path: 'city' }), 'Wonderland');
+    });
+    it('handles root context', () => {
+        const rootContext = createTestDataContext(model, '/');
+        assert.strictEqual(rootContext.resolveDynamicValue({ path: 'user/name' }), 'Alice');
+    });
+    it('subscribes relative path', () => {
+        let called = false;
+        context.subscribeDynamicValue({ path: 'name' }, val => {
+            assert.strictEqual(val, 'Charlie');
+            called = true;
+        });
+        context.set('name', 'Charlie');
+        assert.strictEqual(called, true, 'Callback was never called');
+    });
+    it('resolves using resolveDynamicValue() method with literals', () => {
+        // Literal
+        assert.strictEqual(context.resolveDynamicValue('literal'), 'literal');
+        // Path
+        assert.strictEqual(context.resolveDynamicValue({ path: 'name' }), 'Alice');
+        // Absolute Path
+        assert.strictEqual(context.resolveDynamicValue({ path: '/list/0' }), 'a');
+    });
+    it('resolves literal arrays', () => {
+        assert.deepStrictEqual(context.resolveDynamicValue(['literal', 'array']), [
+            'literal',
+            'array',
+        ]);
+    });
+    it('subscribes literal arrays as static', () => {
+        let called = false;
+        const sub = context.subscribeDynamicValue(['literal', 'array'], () => {
+            called = true;
+        });
+        assert.deepStrictEqual(sub.value, ['literal', 'array']);
+        // Simulate some generic path update that shouldn't trigger anything for this static sub
+        context.set('name', 'Charlie');
+        assert.strictEqual(called, false);
+    });
+    it('resolves function calls synchronously', () => {
+        const fnInvoker = (name, args) => {
+            if (name === 'add')
+                return args.a + args.b;
+            return null;
+        };
+        const ctx = createTestDataContext(model, '/user', fnInvoker);
+        const result = ctx.resolveDynamicValue({
+            call: 'add',
+            args: { a: 1, b: 2 },
+            returnType: 'any',
+        });
+        assert.strictEqual(result, 3);
+    });
+    it('dispatches generic error on function call without invoker synchronously', () => {
+        let dispatchedError = null;
+        const ctx = createTestDataContext(model, '/user', () => {
+            throw new Error('Function invoker is not configured');
+        }, err => {
+            dispatchedError = err;
+        });
+        const result = ctx.resolveDynamicValue({
+            call: 'add',
+            args: {},
+            returnType: 'any',
+        });
+        assert.strictEqual(result, undefined);
+        assert.ok(dispatchedError);
+        assert.strictEqual(dispatchedError.code, 'EXPRESSION_ERROR');
+    });
+    it('does not resolve arbitrary objects recursively', () => {
+        const obj = {
+            foo: 'bar',
+            nested: { path: 'name' },
+            list: [{ path: 'address/city' }, 'literal'],
+        };
+        const resolved = context.resolveDynamicValue(obj);
+        assert.deepStrictEqual(resolved, obj);
+    });
+    it('subscribes to literal objects as signals without resolution', () => {
+        const obj = { foo: 'bar', nested: { path: 'name' } };
+        const sig = context.resolveSignal(obj);
+        // It should be a literal signal containing the object
+        assert.deepStrictEqual(sig.peek(), obj);
+        // Updating the path should NOT affect it
+        context.set('name', 'Bob');
+        assert.deepStrictEqual(sig.peek(), obj);
+    });
+    it('subscribes to function calls with no args', () => {
+        const fnInvoker = (name) => (name === 'getPi' ? Math.PI : 0);
+        const ctx = createTestDataContext(model, '/', fnInvoker);
+        let called = false;
+        ctx.subscribeDynamicValue({ call: 'getPi', args: {}, returnType: 'any' }, () => {
+            called = true;
+        });
+        assert.strictEqual(called, false);
+    });
+    it('returns undefined on function call without invoker reactively', () => {
+        const ctx = createTestDataContext(model, '/user', () => {
+            throw new Error('Function invoker is not configured');
+        });
+        const sub = ctx.subscribeDynamicValue({ call: 'add', args: {}, returnType: 'any' }, () => { });
+        assert.strictEqual(sub.value, undefined);
+    });
+    it('subscribes to function call returning a signal', () => {
+        const fnInvoker = (name) => {
+            if (name === 'obs')
+                return signal('hello');
+            return null;
+        };
+        const ctx = createTestDataContext(model, '/', fnInvoker);
+        let val;
+        ctx.subscribeDynamicValue({ call: 'obs', args: {}, returnType: 'any' }, v => {
+            val = v;
+        });
+        assert.ok(true); // Verification occurs by absence of crash, and coverage hits the switch
+        assert.equal(val, undefined);
+    });
+    it('subscribes to invalid dynamic value reactively (falls back to literal signal)', () => {
+        const obj = { unknown: 'thing' };
+        const sub = context.subscribeDynamicValue(obj, () => { });
+        assert.deepStrictEqual(sub.value, obj);
+    });
+    it('handles path resolution edge cases', () => {
+        assert.strictEqual(context.nested('').path, '/user');
+        assert.strictEqual(context.nested('.').path, '/user');
+        // Ensure trailing slash removal logic is hit
+        const rootCtx = createTestDataContext(model, '/');
+        assert.strictEqual(rootCtx.nested('test').path, '/test');
+        const trailingCtx = createTestDataContext(model, '/user/');
+        assert.strictEqual(trailingCtx.nested('test').path, '/user/test');
+    });
+    it('subscribes to function call with arguments reactively', () => {
+        const fnInvoker = (name, args) => {
+            if (name === 'greet')
+                return `Hello ${args.name}`;
+            return null;
+        };
+        const ctx = createTestDataContext(model, '/user', fnInvoker);
+        const sub = ctx.subscribeDynamicValue({ call: 'greet', args: { name: { path: 'name' } }, returnType: 'any' }, () => { });
+        assert.strictEqual(sub.value, 'Hello Alice');
+        // Update inner path
+        ctx.set('name', 'Bob');
+        assert.strictEqual(sub.value, 'Hello Bob');
+        sub.unsubscribe();
+    });
+    describe('resolveAction', () => {
+        it('resolves event actions non-recursively', () => {
+            const action = {
+                event: {
+                    name: 'save',
+                    context: {
+                        id: { path: 'name' },
+                        metadata: { nested: { path: 'something' } },
+                    },
+                },
+            };
+            const resolved = context.resolveAction(action);
+            assert.deepStrictEqual(resolved, {
+                event: {
+                    name: 'save',
+                    context: {
+                        id: 'Alice',
+                        metadata: { nested: { path: 'something' } }, // Literal, NOT resolved
+                    },
+                },
+            });
+        });
+        it('resolves functionCall actions', () => {
+            const fnInvoker = (name, args) => {
+                if (name === 'greet')
+                    return `Hello ${args.name}`;
+                return null;
+            };
+            const ctx = createTestDataContext(model, '/user', fnInvoker);
+            const action = {
+                functionCall: {
+                    call: 'greet',
+                    args: { name: { path: 'name' } },
+                },
+            };
+            const resolved = ctx.resolveAction(action);
+            assert.strictEqual(resolved, 'Hello Alice');
+        });
+    });
+    describe('Error Handling', () => {
+        it('translates ZodError into A2uiExpressionError and dispatches error', () => {
+            const invokerWithZodError = () => {
+                throw new z.ZodError([
+                    {
+                        code: 'invalid_type',
+                        expected: 'string',
+                        received: 'number',
+                        path: ['foo'],
+                        message: 'Expected string, received number',
+                    },
+                ]);
+            };
+            let dispatchedError = null;
+            const ctx = createTestDataContext(model, '/', invokerWithZodError, err => {
+                dispatchedError = err;
+            });
+            const result = ctx.resolveDynamicValue({
+                call: 'fail',
+                args: {},
+                returnType: 'any',
+            });
+            assert.strictEqual(result, undefined);
+            assert.ok(dispatchedError);
+            assert.strictEqual(dispatchedError.code, 'EXPRESSION_ERROR');
+            assert.strictEqual(dispatchedError.expression, 'fail');
+        });
+        it('dispatches generic Error as EXPRESSION_ERROR to surface', () => {
+            const invokerWithRegularError = () => {
+                const err = new Error('Generic failure');
+                err.stack = 'Mock stack trace';
+                throw err;
+            };
+            let dispatchedError = null;
+            const ctx = createTestDataContext(model, '/', invokerWithRegularError, err => {
+                dispatchedError = err;
+            });
+            const result = ctx.resolveDynamicValue({
+                call: 'fail',
+                args: {},
+                returnType: 'any',
+            });
+            assert.strictEqual(result, undefined);
+            assert.ok(dispatchedError);
+            assert.strictEqual(dispatchedError.code, 'EXPRESSION_ERROR');
+            assert.strictEqual(dispatchedError.expression, 'fail');
+            assert.strictEqual(dispatchedError.message, 'Generic failure');
+            assert.deepStrictEqual(dispatchedError.details, {
+                stack: 'Mock stack trace',
+            });
+        });
+        it('dispatches A2uiExpressionError to surface', () => {
+            const invokerWithExpressionError = () => {
+                throw new A2uiExpressionError('Custom expr error', 'custom_func');
+            };
+            let dispatchedError = null;
+            const ctx = createTestDataContext(model, '/', invokerWithExpressionError, err => {
+                dispatchedError = err;
+            });
+            const result = ctx.resolveDynamicValue({
+                call: 'fail',
+                args: {},
+                returnType: 'any',
+            });
+            assert.strictEqual(result, undefined);
+            assert.ok(dispatchedError);
+            assert.strictEqual(dispatchedError.code, 'EXPRESSION_ERROR');
+            assert.strictEqual(dispatchedError.expression, 'custom_func');
+        });
+        it('handles errors thrown during reactive argument resolution', () => {
+            const trigger = signal(false);
+            const fnInvoker = (name) => {
+                if (name === 'inner') {
+                    return computed(() => {
+                        if (trigger.value)
+                            throw new A2uiExpressionError('Inner failure', 'inner_func');
+                        return 'ok';
+                    });
+                }
+                return 'outer-result';
+            };
+            let dispatchedError = null;
+            const ctx = createTestDataContext(model, '/', fnInvoker, err => {
+                dispatchedError = err;
+            });
+            const sub = ctx.subscribeDynamicValue({
+                call: 'outer',
+                args: {
+                    arg: { call: 'inner', args: {} },
+                },
+                returnType: 'any',
+            }, () => { });
+            assert.strictEqual(sub.value, 'outer-result');
+            assert.strictEqual(dispatchedError, null);
+            trigger.value = true;
+            // Accessing sub.value or the effect running triggers the catch.
+            assert.strictEqual(sub.value, undefined);
+            assert.ok(dispatchedError);
+            assert.strictEqual(dispatchedError.message, 'Inner failure');
+        });
+        it('handles generic errors thrown during reactive execution', () => {
+            const trigger = signal(false);
+            const fnInvoker = (name) => {
+                if (name === 'inner') {
+                    return computed(() => {
+                        if (trigger.value)
+                            throw new Error('Generic inner failure');
+                        return 'ok';
+                    });
+                }
+                return 'outer-result';
+            };
+            let dispatchedError = null;
+            const ctx = createTestDataContext(model, '/', fnInvoker, err => {
+                dispatchedError = err;
+            });
+            const sub = ctx.subscribeDynamicValue({
+                call: 'outer',
+                args: {
+                    arg: { call: 'inner', args: {} },
+                },
+                returnType: 'any',
+            }, () => { });
+            assert.strictEqual(sub.value, 'outer-result');
+            assert.strictEqual(dispatchedError, null);
+            trigger.value = true;
+            assert.strictEqual(sub.value, undefined);
+            assert.ok(dispatchedError);
+            assert.strictEqual(dispatchedError.code, 'EXPRESSION_ERROR');
+            assert.strictEqual(dispatchedError.message, 'Generic inner failure');
+        });
+    });
+});
+//# sourceMappingURL=data-context.test.js.map

package/src/v0_9/rendering/data-context.test.js.map

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

package/src/v0_9/rendering/generic-binder.d.ts

@@ -0,0 +1,122 @@
+/**
+ * Copyright 2026 Google LLC
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *     http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+import { z } from 'zod';
+import { ComponentContext } from './component-context.js';
+import { Action, ChildList, DataBinding, FunctionCall } from '../schema/common-types.js';
+/**
+ * Represents the intended runtime behavior of a property parsed from its Zod schema.
+ *
+ * - `DYNAMIC`: The property can be bound to the `DataModel` (e.g. `DynamicString`).
+ *    The Binder will automatically subscribe to data changes and emit primitive values.
+ * - `ACTION`: The property represents a user interaction (e.g. `Action`).
+ *    The Binder will resolve deep payload bindings and output a ready-to-call `() => void` closure.
+ * - `STRUCTURAL`: The property dictates the rendering of child components (e.g. `ChildList`).
+ *    The Binder outputs lists of objects containing `{ id, basePath }` for structural layout.
+ * - `CHECKABLE`: Special property for handling validation arrays (e.g. `checks`).
+ *    The Binder will reactively evaluate the rules and inject `isValid` and `validationErrors` booleans into the parent object.
+ * - `STATIC`: A primitive value that requires no reactive subscription or resolution.
+ * - `OBJECT` / `ARRAY`: Recursive traversal nodes for complex nested schemas.
+ */
+export type BehaviorNode = {
+    type: 'DYNAMIC';
+} | {
+    type: 'ACTION';
+} | {
+    type: 'STRUCTURAL';
+} | {
+    type: 'CHECKABLE';
+} | {
+    type: 'STATIC';
+} | {
+    type: 'OBJECT';
+    shape: Record<string, BehaviorNode>;
+} | {
+    type: 'ARRAY';
+    element: BehaviorNode;
+};
+/**
+ * Traverses a Zod schema tree to build a `BehaviorNode` map.
+ *
+ * This allows the Generic Binder to know *how* to handle a piece of raw JSON
+ * data without needing hardcoded logic for every specific component type.
+ * It identifies core A2UI primitives (Dynamic values, Actions, ChildLists) by
+ * inspecting the shape of ZodUnion objects defined in `common-types.ts`.
+ */
+export declare function scrapeSchemaBehavior(schema: z.ZodTypeAny): BehaviorNode;
+type DynamicTypes = DataBinding | FunctionCall;
+type IsDynamic<T> = DataBinding extends NonNullable<T> ? true : false;
+/**
+ * Maps raw Zod inferred types to their resolved runtime equivalents.
+ * For example, an `Action` object becomes a callable `() => void` function.
+ */
+export type ResolveA2uiProp<T> = [NonNullable<T>] extends [Action] ? (() => void) | Extract<T, undefined> : [NonNullable<T>] extends [ChildList] ? any | Extract<T, undefined> : Exclude<T, DynamicTypes> extends never ? any : Exclude<T, DynamicTypes>;
+/**
+ * Automatically generates two-way binding setters for dynamic properties.
+ * If a schema has a `value: DynamicString`, this type generates a `setValue(val: string)` method.
+ */
+export type GenerateSetters<T> = {
+    [K in keyof T as IsDynamic<T[K]> extends true ? `set${Capitalize<string & K>}` : never]-?: (value: Exclude<NonNullable<T[K]>, DynamicTypes>) => void;
+};
+/**
+ * The final output type of the Generic Binder, providing fully resolved, ready-to-use props.
+ * This is what framework-specific adapters (like `createReactComponent`) pass to the developer's view logic.
+ */
+export type ResolveA2uiProps<T> = (T extends object ? {
+    [K in keyof T]: ResolveA2uiProp<T[K]>;
+} : T) & GenerateSetters<T> & {
+    isValid?: boolean;
+    validationErrors?: string[];
+};
+/**
+ * The Generic Binder is a framework-agnostic engine that transforms raw A2UI JSON payload
+ * configurations into a single, cohesive reactive stream of strongly-typed `ResolvedProps`.
+ *
+ * It solves the problem of manual state management: developers do not need to write
+ * boilerplate code to subscribe to data paths, evaluate logic expressions, or tear down
+ * listeners when components unmount.
+ *
+ * Usage Flow:
+ * 1. Takes a `ComponentContext` (the raw JSON config) and a `Zod Schema` (the API definition).
+ * 2. Uses `scrapeSchemaBehavior` to analyze the schema.
+ * 3. Deeply iterates over the raw JSON properties, applying rules based on the scraped behavior.
+ * 4. Subscribes to the `DataContext` for all `DYNAMIC` and `CHECKABLE` paths.
+ * 5. Bundles the final resolved primitives, structural arrays, and executable Actions into `currentProps`.
+ * 6. Exposes a `subscribe()` interface for framework-specific adapters (React, Angular) to listen to state changes.
+ */
+export declare class GenericBinder<T> {
+    private dataListeners;
+    private propsListeners;
+    currentProps: Partial<T>;
+    private compUnsub?;
+    private isConnected;
+    private context;
+    private behaviorTree;
+    constructor(context: ComponentContext, schema: z.ZodTypeAny);
+    private resolveInitialProps;
+    private connect;
+    private rebuildAllBindings;
+    private resolveAndBind;
+    private updateDeepValue;
+    private cloneAndUpdate;
+    dispose(): void;
+    private notify;
+    subscribe(listener: (props: T) => void): {
+        unsubscribe: () => void;
+    };
+    get snapshot(): T;
+}
+export {};
+//# sourceMappingURL=generic-binder.d.ts.map

package/src/v0_9/rendering/generic-binder.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"generic-binder.d.ts","sourceRoot":"","sources":["../../../../src/v0_9/rendering/generic-binder.ts"],"names":[],"mappings":"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"}