@a2ui/web_core 0.8.0 → 0.9.0

package/src/v0_9/rendering/generic-binder.js

@@ -0,0 +1,315 @@
+/**
+ * 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.
+ */
+/**
+ * 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 function scrapeSchemaBehavior(schema) {
+    return getFieldBehavior(schema);
+}
+function getFieldBehavior(type, propertyName) {
+    let current = type;
+    // Unwrap optionals/nullables/defaults
+    while (current._def.typeName === 'ZodOptional' ||
+        current._def.typeName === 'ZodNullable' ||
+        current._def.typeName === 'ZodDefault') {
+        current = current._def.innerType;
+    }
+    if (propertyName === 'checks') {
+        return { type: 'CHECKABLE' };
+    }
+    // Structural matching for A2UI primitives using typeName to avoid dual-module instanceof issues
+    if (current._def.typeName === 'ZodUnion') {
+        const options = current._def.options;
+        // ActionSchema is a union containing { event: ... }
+        const isAction = options.some(o => o._def.typeName === 'ZodObject' && o._def.shape().event);
+        if (isAction)
+            return { type: 'ACTION' };
+        // Dynamic strings/values are unions containing DataBindingSchema { path: ... } but NOT { componentId: ... }
+        const isDynamic = options.some(o => o._def.typeName === 'ZodObject' &&
+            o._def.shape().path &&
+            !o._def.shape().componentId);
+        if (isDynamic)
+            return { type: 'DYNAMIC' };
+        // ChildList is a union containing an array and an object with { componentId, path }
+        const isChildList = options.some(o => o._def.typeName === 'ZodObject' &&
+            o._def.shape().componentId &&
+            o._def.shape().path);
+        if (isChildList)
+            return { type: 'STRUCTURAL' };
+    }
+    else if (current._def.typeName === 'ZodString') {
+        // ComponentId falls back to STATIC since we can't perfectly identify it, which is fine because STATIC returns strings as-is.
+    }
+    // Recursive array scraping
+    if (current._def.typeName === 'ZodArray') {
+        return {
+            type: 'ARRAY',
+            element: getFieldBehavior(current._def.type),
+        };
+    }
+    // Recursive object scraping
+    if (current._def.typeName === 'ZodObject') {
+        const shape = {};
+        const objShape = current._def.shape();
+        for (const [key, value] of Object.entries(objShape)) {
+            shape[key] = getFieldBehavior(value, key);
+        }
+        return { type: 'OBJECT', shape };
+    }
+    // Fallback
+    return { type: 'STATIC' };
+}
+/**
+ * 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 class GenericBinder {
+    constructor(context, schema) {
+        this.dataListeners = [];
+        this.propsListeners = [];
+        this.currentProps = {};
+        this.isConnected = false;
+        this.context = context;
+        this.behaviorTree = scrapeSchemaBehavior(schema);
+        if (this.behaviorTree.type !== 'OBJECT') {
+            this.behaviorTree = { type: 'OBJECT', shape: {} };
+        }
+        this.resolveInitialProps();
+    }
+    resolveInitialProps() {
+        const props = this.context.componentModel.properties;
+        const resolved = this.resolveAndBind(props, this.behaviorTree, [], true);
+        this.currentProps = { ...this.currentProps, ...resolved };
+    }
+    connect() {
+        if (this.isConnected)
+            return;
+        this.isConnected = true;
+        const sub = this.context.componentModel.onUpdated.subscribe(() => {
+            this.rebuildAllBindings();
+        });
+        this.compUnsub = () => sub.unsubscribe();
+        this.rebuildAllBindings();
+    }
+    rebuildAllBindings() {
+        this.dataListeners.forEach(l => l());
+        this.dataListeners = [];
+        const props = this.context.componentModel.properties;
+        const resolved = this.resolveAndBind(props, this.behaviorTree, [], false);
+        this.currentProps = { ...this.currentProps, ...resolved };
+        this.notify();
+    }
+    resolveAndBind(value, behavior, path, isSync) {
+        if (value === undefined || value === null)
+            return value;
+        switch (behavior.type) {
+            case 'DYNAMIC': {
+                const bound = this.context.dataContext.subscribeDynamicValue(value, newVal => {
+                    this.updateDeepValue(path, newVal);
+                    this.notify();
+                });
+                if (!isSync) {
+                    this.dataListeners.push(() => bound.unsubscribe());
+                }
+                else {
+                    bound.unsubscribe();
+                }
+                return bound.value;
+            }
+            case 'ACTION': {
+                return () => {
+                    const resolveDeepSync = (val) => {
+                        if (typeof val !== 'object' || val === null)
+                            return val;
+                        if ('path' in val || 'call' in val)
+                            return this.context.dataContext.resolveDynamicValue(val);
+                        if (Array.isArray(val))
+                            return val.map(resolveDeepSync);
+                        const res = {};
+                        for (const [k, v] of Object.entries(val))
+                            res[k] = resolveDeepSync(v);
+                        return res;
+                    };
+                    this.context.dispatchAction(resolveDeepSync(value));
+                };
+            }
+            case 'STRUCTURAL': {
+                if (value &&
+                    typeof value === 'object' &&
+                    value.path &&
+                    value.componentId) {
+                    const bound = this.context.dataContext.subscribeDynamicValue({ path: value.path }, newVal => {
+                        const arr = Array.isArray(newVal) ? newVal : [];
+                        const listContext = this.context.dataContext.nested(value.path);
+                        const resolvedChildren = arr.map((_, i) => ({
+                            id: value.componentId,
+                            basePath: listContext.nested(String(i)).path,
+                        }));
+                        this.updateDeepValue(path, resolvedChildren);
+                        this.notify();
+                    });
+                    if (!isSync) {
+                        this.dataListeners.push(() => bound.unsubscribe());
+                    }
+                    else {
+                        bound.unsubscribe();
+                    }
+                    const currentArr = Array.isArray(bound.value) ? bound.value : [];
+                    const listContext = this.context.dataContext.nested(value.path);
+                    return currentArr.map((_, i) => ({
+                        id: value.componentId,
+                        basePath: listContext.nested(String(i)).path,
+                    }));
+                }
+                return value;
+            }
+            case 'CHECKABLE': {
+                const rules = Array.isArray(value) ? value : [];
+                const ruleResults = rules.map(() => ({ valid: true, message: '' }));
+                const parentPath = path.slice(0, -1);
+                const updateValidationState = () => {
+                    const errors = ruleResults.filter(r => !r.valid).map(r => r.message);
+                    this.updateDeepValue([...parentPath, 'isValid'], errors.length === 0);
+                    this.updateDeepValue([...parentPath, 'validationErrors'], errors);
+                    this.notify();
+                };
+                rules.forEach((rule, index) => {
+                    const condition = rule.condition || rule; // Support both {condition, message} and direct logic expr if message is missing
+                    const message = rule.message || 'Validation failed';
+                    ruleResults[index].message = message;
+                    const bound = this.context.dataContext.subscribeDynamicValue(condition, newVal => {
+                        ruleResults[index].valid = !!newVal;
+                        updateValidationState();
+                    });
+                    if (!isSync) {
+                        this.dataListeners.push(() => bound.unsubscribe());
+                    }
+                    else {
+                        bound.unsubscribe();
+                    }
+                    ruleResults[index].valid = !!bound.value;
+                });
+                // Set initial state
+                const initialErrors = ruleResults
+                    .filter(r => !r.valid)
+                    .map(r => r.message);
+                this.updateDeepValue([...parentPath, 'isValid'], initialErrors.length === 0);
+                this.updateDeepValue([...parentPath, 'validationErrors'], initialErrors);
+                return value; // The 'checks' property itself remains as the original rules array
+            }
+            case 'STATIC':
+                return value;
+            case 'ARRAY': {
+                if (!Array.isArray(value))
+                    return value;
+                return value.map((item, index) => this.resolveAndBind(item, behavior.element, [...path, index.toString()], isSync));
+            }
+            case 'OBJECT': {
+                if (typeof value !== 'object')
+                    return value;
+                const result = {};
+                // 1. Resolve all provided properties
+                for (const [k, v] of Object.entries(value)) {
+                    const childBehavior = behavior.shape[k] || { type: 'STATIC' };
+                    result[k] = this.resolveAndBind(v, childBehavior, [...path, k], isSync);
+                }
+                // 2. Ensure all dynamic setters exist, even if the property wasn't provided in the payload
+                for (const [k, childBehavior] of Object.entries(behavior.shape)) {
+                    if (childBehavior.type === 'DYNAMIC') {
+                        const setterName = `set${k.charAt(0).toUpperCase() + k.slice(1)}`;
+                        const rawPropValue = value[k];
+                        result[setterName] = (newValue) => {
+                            if (rawPropValue &&
+                                typeof rawPropValue === 'object' &&
+                                'path' in rawPropValue) {
+                                this.context.dataContext.set(rawPropValue.path, newValue);
+                            }
+                        };
+                    }
+                }
+                return result;
+            }
+        }
+    }
+    updateDeepValue(path, newValue) {
+        this.currentProps = this.cloneAndUpdate(this.currentProps, path, newValue);
+    }
+    cloneAndUpdate(obj, path, newValue) {
+        if (path.length === 0)
+            return newValue;
+        const [key, ...rest] = path;
+        if (Array.isArray(obj)) {
+            const newArr = [...obj];
+            newArr[Number(key)] = this.cloneAndUpdate(newArr[Number(key)], rest, newValue);
+            return newArr;
+        }
+        else {
+            return {
+                ...(obj || {}),
+                [key]: this.cloneAndUpdate((obj || {})[key], rest, newValue),
+            };
+        }
+    }
+    dispose() {
+        if (!this.isConnected)
+            return;
+        this.isConnected = false;
+        this.dataListeners.forEach(l => l());
+        this.dataListeners = [];
+        if (this.compUnsub) {
+            this.compUnsub();
+            this.compUnsub = undefined;
+        }
+    }
+    notify() {
+        this.propsListeners.forEach(l => l(this.currentProps));
+    }
+    subscribe(listener) {
+        if (this.propsListeners.length === 0) {
+            this.connect();
+        }
+        this.propsListeners.push(listener);
+        return {
+            unsubscribe: () => {
+                this.propsListeners = this.propsListeners.filter(l => l !== listener);
+                if (this.propsListeners.length === 0) {
+                    this.dispose();
+                }
+            },
+        };
+    }
+    get snapshot() {
+        return this.currentProps;
+    }
+}
+//# sourceMappingURL=generic-binder.js.map

package/src/v0_9/rendering/generic-binder.js.map

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

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

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=generic-binder.test.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"generic-binder.test.d.ts","sourceRoot":"","sources":["../../../../src/v0_9/rendering/generic-binder.test.ts"],"names":[],"mappings":""}

package/src/v0_9/rendering/generic-binder.test.js

@@ -0,0 +1,166 @@
+/*
+ * 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
+ *
+ *      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 } from 'node:test';
+import { z } from 'zod';
+import { GenericBinder } from './generic-binder.js';
+import { ComponentContext } from './component-context.js';
+import { SurfaceModel } from '../state/surface-model.js';
+import { Catalog } from '../catalog/types.js';
+import { ComponentModel } from '../state/component-model.js';
+import { CommonSchemas } from '../schema/common-types.js';
+describe('GenericBinder Checkable Trait', () => {
+    const mockCatalog = new Catalog('test', [], []);
+    function setupSurfaceAndMocks() {
+        const surface = new SurfaceModel('s1', mockCatalog);
+        // Mock required and min_length functions
+        surface.catalog.functions = new Map([
+            [
+                'required',
+                {
+                    execute: (args) => !!args.value,
+                    schema: z.object({ value: z.any() }),
+                },
+            ],
+            [
+                'min_length',
+                {
+                    execute: (args) => typeof args.value === 'string' && args.value.length >= args.min,
+                    schema: z.object({ value: z.any(), min: z.number() }),
+                },
+            ],
+        ]);
+        surface.catalog.invoker = (name, args) => {
+            const fn = surface.catalog.functions.get(name);
+            return fn.execute(args);
+        };
+        const schema = z.object({
+            value: CommonSchemas.DynamicString,
+            checks: CommonSchemas.Checkable.shape.checks,
+        });
+        return { surface, schema };
+    }
+    it('should resolve checkable validation state reactively', async () => {
+        const { surface, schema } = setupSurfaceAndMocks();
+        surface.dataModel.set('/val', '');
+        const compModel = new ComponentModel('c1', 'Test', {
+            value: { path: '/val' },
+            checks: [
+                {
+                    condition: {
+                        call: 'required',
+                        args: { value: { path: '/val' } },
+                    },
+                    message: 'Value is required',
+                },
+            ],
+        });
+        surface.componentsModel.addComponent(compModel);
+        const context = new ComponentContext(surface, 'c1');
+        const binder = new GenericBinder(context, schema);
+        binder.subscribe(() => { });
+        // Initial state: should be invalid
+        assert.strictEqual(binder.snapshot.isValid, false);
+        assert.deepStrictEqual(binder.snapshot.validationErrors, [
+            'Value is required',
+        ]);
+        // Update data: should become valid
+        surface.dataModel.set('/val', 'hello');
+        await new Promise(resolve => setTimeout(resolve, 0));
+        assert.strictEqual(binder.snapshot.isValid, true);
+        assert.deepStrictEqual(binder.snapshot.validationErrors, []);
+    });
+    it('should aggregate multiple validation rules correctly', async () => {
+        const { surface, schema } = setupSurfaceAndMocks();
+        surface.dataModel.set('/val', '');
+        const compModel = new ComponentModel('c2', 'Test', {
+            value: { path: '/val' },
+            checks: [
+                {
+                    condition: {
+                        call: 'required',
+                        args: { value: { path: '/val' } },
+                    },
+                    message: 'Cannot be empty',
+                },
+                {
+                    condition: {
+                        call: 'min_length',
+                        args: { value: { path: '/val' }, min: 3 },
+                    },
+                    message: 'Must be at least 3 characters',
+                },
+            ],
+        });
+        surface.componentsModel.addComponent(compModel);
+        const context = new ComponentContext(surface, 'c2');
+        const binder = new GenericBinder(context, schema);
+        binder.subscribe(() => { });
+        // Both rules fail initially
+        assert.strictEqual(binder.snapshot.isValid, false);
+        assert.deepStrictEqual(binder.snapshot.validationErrors, [
+            'Cannot be empty',
+            'Must be at least 3 characters',
+        ]);
+        // Update data to satisfy first rule but fail second
+        surface.dataModel.set('/val', 'hi');
+        await new Promise(resolve => setTimeout(resolve, 0));
+        assert.strictEqual(binder.snapshot.isValid, false);
+        assert.deepStrictEqual(binder.snapshot.validationErrors, [
+            'Must be at least 3 characters',
+        ]);
+        // Update data to satisfy all rules
+        surface.dataModel.set('/val', 'hello');
+        await new Promise(resolve => setTimeout(resolve, 0));
+        assert.strictEqual(binder.snapshot.isValid, true);
+        assert.deepStrictEqual(binder.snapshot.validationErrors, []);
+    });
+    it('should provide a default message if rule.message is missing', async () => {
+        const { surface, schema } = setupSurfaceAndMocks();
+        surface.dataModel.set('/val', '');
+        const compModel = new ComponentModel('c3', 'Test', {
+            value: { path: '/val' },
+            checks: [
+                {
+                    condition: {
+                        call: 'required',
+                        args: { value: { path: '/val' } },
+                    },
+                },
+            ],
+        });
+        surface.componentsModel.addComponent(compModel);
+        const context = new ComponentContext(surface, 'c3');
+        const binder = new GenericBinder(context, schema);
+        assert.strictEqual(binder.snapshot.isValid, false);
+        assert.deepStrictEqual(binder.snapshot.validationErrors, [
+            'Validation failed',
+        ]);
+    });
+    it('should default to valid if checks array is empty or undefined', async () => {
+        const { surface, schema } = setupSurfaceAndMocks();
+        const compModel = new ComponentModel('c4', 'Test', {
+            value: 'static',
+            checks: [], // Empty checks
+        });
+        surface.componentsModel.addComponent(compModel);
+        const context = new ComponentContext(surface, 'c4');
+        const binder = new GenericBinder(context, schema);
+        assert.strictEqual(binder.snapshot.isValid, true);
+        assert.deepStrictEqual(binder.snapshot.validationErrors, []);
+    });
+});
+//# sourceMappingURL=generic-binder.test.js.map

package/src/v0_9/rendering/generic-binder.test.js.map

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

package/src/v0_9/schema/client-capabilities.d.ts

@@ -0,0 +1,34 @@
+/**
+ * Represents a JSON Schema definition.
+ * Typed as Record<string, any> to allow standard JSON schema properties
+ * without importing heavy schema types.
+ */
+export type JsonSchema = Record<string, any>;
+/**
+ * Describes a function's interface within an inline catalog.
+ */
+export interface FunctionDefinition {
+    name: string;
+    description?: string;
+    parameters: JsonSchema;
+    returnType: 'string' | 'number' | 'boolean' | 'array' | 'object' | 'any' | 'void';
+}
+/**
+ * Defines a catalog inline for the a2uiClientCapabilities object.
+ */
+export interface InlineCatalog {
+    catalogId: string;
+    components?: Record<string, JsonSchema>;
+    functions?: FunctionDefinition[];
+    theme?: Record<string, JsonSchema>;
+}
+/**
+ * The capabilities structure sent from the client to the server as part of transport metadata.
+ */
+export interface A2uiClientCapabilities {
+    'v0.9': {
+        supportedCatalogIds: string[];
+        inlineCatalogs?: InlineCatalog[];
+    };
+}
+//# sourceMappingURL=client-capabilities.d.ts.map

package/src/v0_9/schema/client-capabilities.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"client-capabilities.d.ts","sourceRoot":"","sources":["../../../../src/v0_9/schema/client-capabilities.ts"],"names":[],"mappings":"AAgBA;;;;GAIG;AACH,MAAM,MAAM,UAAU,GAAG,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;AAE7C;;GAEG;AACH,MAAM,WAAW,kBAAkB;IACjC,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,UAAU,EAAE,UAAU,CAAC;IACvB,UAAU,EACN,QAAQ,GACR,QAAQ,GACR,SAAS,GACT,OAAO,GACP,QAAQ,GACR,KAAK,GACL,MAAM,CAAC;CACZ;AAED;;GAEG;AACH,MAAM,WAAW,aAAa;IAC5B,SAAS,EAAE,MAAM,CAAC;IAClB,UAAU,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,UAAU,CAAC,CAAC;IACxC,SAAS,CAAC,EAAE,kBAAkB,EAAE,CAAC;IACjC,KAAK,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,UAAU,CAAC,CAAC;CACpC;AAED;;GAEG;AACH,MAAM,WAAW,sBAAsB;IACrC,MAAM,EAAE;QACN,mBAAmB,EAAE,MAAM,EAAE,CAAC;QAC9B,cAAc,CAAC,EAAE,aAAa,EAAE,CAAC;KAClC,CAAC;CACH"}

package/src/v0_9/schema/client-capabilities.js

@@ -0,0 +1,17 @@
+/*
+ * 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
+ *
+ *      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.
+ */
+export {};
+//# sourceMappingURL=client-capabilities.js.map

package/src/v0_9/schema/client-capabilities.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"client-capabilities.js","sourceRoot":"","sources":["../../../../src/v0_9/schema/client-capabilities.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG"}