@a2ui/web_core 0.8.0 → 0.9.1-alpha.0

package/{dist/src → src}/v0_9/state/data-model.test.js

@@ -1,3 +1,18 @@
+/*
+ * 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 { DataModel } from './data-model.js';
@@ -8,15 +23,23 @@ describe('DataModel', () => {
             user: {
                 name: 'Alice',
                 settings: {
-                    theme: 'dark'
-                }
+                    theme: 'dark',
+                },
             },
-            items: ['a', 'b', 'c']
+            items: ['a', 'b', 'c'],
         });
     });
+    // --- Initialization ---
+    it('initializes with empty data if not provided', () => {
+        const emptyModel = new DataModel();
+        assert.deepStrictEqual(emptyModel.get('/'), {});
+    });
     // --- Basic Retrieval ---
     it('retrieves root data', () => {
-        assert.deepStrictEqual(model.get('/'), { user: { name: 'Alice', settings: { theme: 'dark' } }, items: ['a', 'b', 'c'] });
+        assert.deepStrictEqual(model.get('/'), {
+            user: { name: 'Alice', settings: { theme: 'dark' } },
+            items: ['a', 'b', 'c'],
+        });
     });
     it('retrieves nested path', () => {
         assert.strictEqual(model.get('/user/name'), 'Alice');
@@ -30,6 +53,10 @@ describe('DataModel', () => {
         assert.strictEqual(model.get('/user/age'), undefined);
         assert.strictEqual(model.get('/unknown/path'), undefined);
     });
+    it('returns undefined when traversing through undefined/null segments', () => {
+        model.set('/nullable', null);
+        assert.strictEqual(model.get('/nullable/deep/path'), undefined);
+    });
     // --- Updates ---
     it('sets value at existing path', () => {
         model.set('/user/name', 'Bob');
@@ -49,10 +76,6 @@ describe('DataModel', () => {
         assert.strictEqual(model.get('/user/name'), undefined);
         assert.strictEqual(Object.keys(model.get('/user')).includes('name'), false);
     });
-    it('replaces root object on root update', () => {
-        model.set('/', { newRoot: true });
-        assert.deepStrictEqual(model.get('/'), { newRoot: true });
-    });
     // --- Array / List Handling (Flutter Parity) ---
     it('List: set and get', () => {
         model.set('/list/0', 'hello');
@@ -88,7 +111,7 @@ describe('DataModel', () => {
     // --- Subscriptions ---
     it('returns a subscription object', () => {
         model.set('/a', 1);
-        const sub = model.subscribe('/a', (val) => updatedValue = val);
+        const sub = model.subscribe('/a', val => (updatedValue = val));
         assert.strictEqual(sub.value, 1);
         let updatedValue;
         model.set('/a', 2);
@@ -101,7 +124,7 @@ describe('DataModel', () => {
     });
     it('notifies subscribers on exact match', () => {
         let called = false;
-        const sub = model.subscribe('/user/name', (val) => {
+        model.subscribe('/user/name', val => {
             assert.strictEqual(val, 'Charlie');
             called = true;
         });
@@ -110,7 +133,7 @@ describe('DataModel', () => {
     });
     it('notifies ancestor subscribers (Container Semantics)', () => {
         let called = false;
-        const sub = model.subscribe('/user', (val) => {
+        model.subscribe('/user', (val) => {
             assert.strictEqual(val.name, 'Dave');
             called = true;
         });
@@ -119,7 +142,7 @@ describe('DataModel', () => {
     });
     it('notifies descendant subscribers', () => {
         let called = false;
-        const sub = model.subscribe('/user/settings/theme', (val) => {
+        model.subscribe('/user/settings/theme', val => {
             assert.strictEqual(val, 'light');
             called = true;
         });
@@ -129,7 +152,7 @@ describe('DataModel', () => {
     });
     it('notifies root subscriber', () => {
         let called = false;
-        const sub = model.subscribe('/', (val) => {
+        model.subscribe('/', (val) => {
             assert.strictEqual(val.newProp, 'test');
             called = true;
         });
@@ -139,13 +162,13 @@ describe('DataModel', () => {
     it('notifies parent when child updates', () => {
         model.set('/parent', { child: 'initial' });
         let parentValue;
-        const sub = model.subscribe('/parent', (val) => parentValue = val);
+        model.subscribe('/parent', val => (parentValue = val));
         model.set('/parent/child', 'updated');
         assert.deepStrictEqual(parentValue, { child: 'updated' });
     });
     it('stops notifying after dispose', () => {
         let count = 0;
-        const sub = model.subscribe('/', () => count++);
+        model.subscribe('/', () => count++);
         model.dispose();
         model.set('/foo', 'bar');
         assert.strictEqual(count, 0);
@@ -171,10 +194,13 @@ describe('DataModel', () => {
         assert.strictEqual(callCount1, 0); // sub1 was unsubscribed
         assert.strictEqual(callCount2, 1); // sub2 still active
         assert.strictEqual(sub2.value, 'Frank');
+        sub2.unsubscribe(); // Should clear the internal map set
+        model.set('/user/name', 'Grace');
+        assert.strictEqual(callCount2, 1); // still 1
     });
     it('handles subscription to non-existent path', () => {
         let val;
-        const sub = model.subscribe('/non/existent', (v) => val = v);
+        const sub = model.subscribe('/non/existent', v => (val = v));
         assert.strictEqual(sub.value, undefined);
         model.set('/non/existent', 'exists now');
         assert.strictEqual(sub.value, 'exists now');
@@ -183,7 +209,7 @@ describe('DataModel', () => {
     it('handles updates to undefined', () => {
         model.set('/foo', 'bar');
         let val = 'initial';
-        const sub = model.subscribe('/foo', (v) => val = v);
+        const sub = model.subscribe('/foo', v => (val = v));
         model.set('/foo', undefined);
         assert.strictEqual(sub.value, undefined);
         assert.strictEqual(val, undefined);
@@ -200,5 +226,39 @@ describe('DataModel', () => {
             model.set('/items/foo', 'bar');
         }, /Cannot use non-numeric segment/);
     });
+    it('throws when using non-numeric segment on an array (intermediate)', () => {
+        model.set('/', { items: [1, 2, 3] });
+        assert.throws(() => {
+            model.set('/items/foo/bar', 'value');
+        }, /Cannot use non-numeric segment 'foo' on an array/);
+    });
+    it('normalizes trailing slashes', () => {
+        let callCount = 0;
+        model.subscribe('/foo', () => callCount++);
+        model.set('/foo/', 'bar'); // Trailing slash
+        assert.strictEqual(model.get('/foo/'), 'bar');
+        assert.strictEqual(callCount, 1);
+    });
+    it('replaces root object on root update', () => {
+        let callCount = 0;
+        model.subscribe('/', () => callCount++);
+        // Just add another sub on a generic path to ensure notifyAllSubscribers loop hits multiple items
+        model.subscribe('/unrelated', () => { });
+        model.set('/', { newRoot: 'foo' });
+        assert.deepStrictEqual(model.get(''), { newRoot: 'foo' });
+        assert.strictEqual(callCount, 1);
+    });
+    it('throws when path is null or undefined', () => {
+        assert.throws(() => model.get(null), /Path cannot be null or undefined/);
+        assert.throws(() => model.get(undefined), /Path cannot be null or undefined/);
+        assert.throws(() => model.set(null, 'value'), /Path cannot be null or undefined/);
+        assert.throws(() => model.set(undefined, 'value'), /Path cannot be null or undefined/);
+    });
+    it('calculates descendants against root path', () => {
+        // This explicitly hits an internal method branch where parentPath === "/"
+        const isDescendant = model.isDescendant.bind(model);
+        assert.strictEqual(isDescendant('/user', '/'), true);
+        assert.strictEqual(isDescendant('/', '/'), false);
+    });
 });
 //# sourceMappingURL=data-model.test.js.map

package/src/v0_9/state/data-model.test.js.map

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

package/src/v0_9/state/surface-components-model.d.ts

@@ -0,0 +1,45 @@
+import { ComponentModel } from './component-model.js';
+import { EventSource } from '../common/events.js';
+/**
+ * Manages the collection of components for a specific surface.
+ */
+export declare class SurfaceComponentsModel {
+    private components;
+    private readonly _onCreated;
+    private readonly _onDeleted;
+    /** Fires when a new component is added to the model. */
+    readonly onCreated: EventSource<ComponentModel>;
+    /** Fires when a component is removed, providing the ID of the deleted component. */
+    readonly onDeleted: EventSource<string>;
+    /**
+     * Retrieves a component by its ID.
+     *
+     *
+     * @param id The ID of the component to retrieve.
+     * @returns The component model, or undefined if not found.
+     */
+    get(id: string): ComponentModel | undefined;
+    /**
+     * Returns an iterator over the components in the model.
+     */
+    get entries(): IterableIterator<[string, ComponentModel]>;
+    /**
+     * Adds a component to the model.
+     * Throws an error if a component with the same ID already exists.
+     *
+     * @param component The component to add.
+     */
+    addComponent(component: ComponentModel): void;
+    /**
+     * Removes a component from the model by its ID.
+     * Disposes of the component upon removal.
+     *
+     * @param id The ID of the component to remove.
+     */
+    removeComponent(id: string): void;
+    /**
+     * Disposes of the model and all its components.
+     */
+    dispose(): void;
+}
+//# sourceMappingURL=surface-components-model.d.ts.map

package/src/v0_9/state/surface-components-model.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"surface-components-model.d.ts","sourceRoot":"","sources":["../../../../src/v0_9/state/surface-components-model.ts"],"names":[],"mappings":"AAgBA,OAAO,EAAC,cAAc,EAAC,MAAM,sBAAsB,CAAC;AACpD,OAAO,EAAe,WAAW,EAAC,MAAM,qBAAqB,CAAC;AAG9D;;GAEG;AACH,qBAAa,sBAAsB;IACjC,OAAO,CAAC,UAAU,CAA0C;IAE5D,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAsC;IACjE,OAAO,CAAC,QAAQ,CAAC,UAAU,CAA8B;IAEzD,wDAAwD;IACxD,QAAQ,CAAC,SAAS,EAAE,WAAW,CAAC,cAAc,CAAC,CAAmB;IAClE,oFAAoF;IACpF,QAAQ,CAAC,SAAS,EAAE,WAAW,CAAC,MAAM,CAAC,CAAmB;IAE1D;;;;;;OAMG;IACH,GAAG,CAAC,EAAE,EAAE,MAAM,GAAG,cAAc,GAAG,SAAS;IAI3C;;OAEG;IACH,IAAI,OAAO,IAAI,gBAAgB,CAAC,CAAC,MAAM,EAAE,cAAc,CAAC,CAAC,CAExD;IAED;;;;;OAKG;IACH,YAAY,CAAC,SAAS,EAAE,cAAc,GAAG,IAAI;IAW7C;;;;;OAKG;IACH,eAAe,CAAC,EAAE,EAAE,MAAM,GAAG,IAAI;IASjC;;OAEG;IACH,OAAO,IAAI,IAAI;CAQhB"}

package/src/v0_9/state/surface-components-model.js

@@ -0,0 +1,86 @@
+/*
+ * 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 { EventEmitter } from '../common/events.js';
+import { A2uiStateError } from '../errors.js';
+/**
+ * Manages the collection of components for a specific surface.
+ */
+export class SurfaceComponentsModel {
+    constructor() {
+        this.components = new Map();
+        this._onCreated = new EventEmitter();
+        this._onDeleted = new EventEmitter();
+        /** Fires when a new component is added to the model. */
+        this.onCreated = this._onCreated;
+        /** Fires when a component is removed, providing the ID of the deleted component. */
+        this.onDeleted = this._onDeleted;
+    }
+    /**
+     * Retrieves a component by its ID.
+     *
+     *
+     * @param id The ID of the component to retrieve.
+     * @returns The component model, or undefined if not found.
+     */
+    get(id) {
+        return this.components.get(id);
+    }
+    /**
+     * Returns an iterator over the components in the model.
+     */
+    get entries() {
+        return this.components.entries();
+    }
+    /**
+     * Adds a component to the model.
+     * Throws an error if a component with the same ID already exists.
+     *
+     * @param component The component to add.
+     */
+    addComponent(component) {
+        if (this.components.has(component.id)) {
+            throw new A2uiStateError(`Component with id '${component.id}' already exists.`);
+        }
+        this.components.set(component.id, component);
+        this._onCreated.emit(component);
+    }
+    /**
+     * Removes a component from the model by its ID.
+     * Disposes of the component upon removal.
+     *
+     * @param id The ID of the component to remove.
+     */
+    removeComponent(id) {
+        const component = this.components.get(id);
+        if (component) {
+            this.components.delete(id);
+            component.dispose();
+            this._onDeleted.emit(id);
+        }
+    }
+    /**
+     * Disposes of the model and all its components.
+     */
+    dispose() {
+        for (const component of this.components.values()) {
+            component.dispose();
+        }
+        this.components.clear();
+        this._onCreated.dispose();
+        this._onDeleted.dispose();
+    }
+}
+//# sourceMappingURL=surface-components-model.js.map

package/src/v0_9/state/surface-components-model.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"surface-components-model.js","sourceRoot":"","sources":["../../../../src/v0_9/state/surface-components-model.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAGH,OAAO,EAAC,YAAY,EAAc,MAAM,qBAAqB,CAAC;AAC9D,OAAO,EAAC,cAAc,EAAC,MAAM,cAAc,CAAC;AAE5C;;GAEG;AACH,MAAM,OAAO,sBAAsB;IAAnC;QACU,eAAU,GAAgC,IAAI,GAAG,EAAE,CAAC;QAE3C,eAAU,GAAG,IAAI,YAAY,EAAkB,CAAC;QAChD,eAAU,GAAG,IAAI,YAAY,EAAU,CAAC;QAEzD,wDAAwD;QAC/C,cAAS,GAAgC,IAAI,CAAC,UAAU,CAAC;QAClE,oFAAoF;QAC3E,cAAS,GAAwB,IAAI,CAAC,UAAU,CAAC;IA+D5D,CAAC;IA7DC;;;;;;OAMG;IACH,GAAG,CAAC,EAAU;QACZ,OAAO,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;IACjC,CAAC;IAED;;OAEG;IACH,IAAI,OAAO;QACT,OAAO,IAAI,CAAC,UAAU,CAAC,OAAO,EAAE,CAAC;IACnC,CAAC;IAED;;;;;OAKG;IACH,YAAY,CAAC,SAAyB;QACpC,IAAI,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC,SAAS,CAAC,EAAE,CAAC,EAAE,CAAC;YACtC,MAAM,IAAI,cAAc,CACtB,sBAAsB,SAAS,CAAC,EAAE,mBAAmB,CACtD,CAAC;QACJ,CAAC;QAED,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC,SAAS,CAAC,EAAE,EAAE,SAAS,CAAC,CAAC;QAC7C,IAAI,CAAC,UAAU,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC;IAClC,CAAC;IAED;;;;;OAKG;IACH,eAAe,CAAC,EAAU;QACxB,MAAM,SAAS,GAAG,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;QAC1C,IAAI,SAAS,EAAE,CAAC;YACd,IAAI,CAAC,UAAU,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC;YAC3B,SAAS,CAAC,OAAO,EAAE,CAAC;YACpB,IAAI,CAAC,UAAU,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;QAC3B,CAAC;IACH,CAAC;IAED;;OAEG;IACH,OAAO;QACL,KAAK,MAAM,SAAS,IAAI,IAAI,CAAC,UAAU,CAAC,MAAM,EAAE,EAAE,CAAC;YACjD,SAAS,CAAC,OAAO,EAAE,CAAC;QACtB,CAAC;QACD,IAAI,CAAC,UAAU,CAAC,KAAK,EAAE,CAAC;QACxB,IAAI,CAAC,UAAU,CAAC,OAAO,EAAE,CAAC;QAC1B,IAAI,CAAC,UAAU,CAAC,OAAO,EAAE,CAAC;IAC5B,CAAC;CACF"}

package/{dist/src → src}/v0_9/state/surface-components-model.test.js

@@ -1,3 +1,18 @@
+/*
+ * 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 { SurfaceComponentsModel } from './surface-components-model.js';
@@ -24,14 +39,16 @@ describe('SurfaceComponentsModel', () => {
         model.addComponent(c1);
         // Track update on component itself
         let updateCount = 0;
-        c1.onUpdated.subscribe(() => { updateCount++; });
+        c1.onUpdated.subscribe(() => {
+            updateCount++;
+        });
         c1.properties = { label: 'Updated' };
         assert.strictEqual(c1.properties.label, 'Updated');
         assert.strictEqual(updateCount, 1);
     });
     it('notifies on component creation', () => {
         let createdComponent;
-        model.onCreated.subscribe((c) => {
+        model.onCreated.subscribe(c => {
             createdComponent = c;
         });
         model.addComponent(new ComponentModel('c1', 'Button', {}));
@@ -45,5 +62,30 @@ describe('SurfaceComponentsModel', () => {
             model.addComponent(new ComponentModel('c1', 'Button', {}));
         }, /already exists/);
     });
+    it('returns entries iterator', () => {
+        const c1 = new ComponentModel('c1', 'Button', {});
+        const c2 = new ComponentModel('c2', 'Text', {});
+        model.addComponent(c1);
+        model.addComponent(c2);
+        const entries = Array.from(model.entries);
+        assert.strictEqual(entries.length, 2);
+        assert.deepStrictEqual(entries[0], ['c1', c1]);
+        assert.deepStrictEqual(entries[1], ['c2', c2]);
+    });
+    it('disposes components during model dispose', () => {
+        const c1 = new ComponentModel('c1', 'Button', {});
+        model.addComponent(c1);
+        let childDisposed = false;
+        c1.dispose = () => {
+            childDisposed = true;
+        };
+        model.dispose();
+        assert.strictEqual(childDisposed, true);
+        assert.strictEqual(model.components.size, 0);
+    });
+    it('safely attempts to remove non-existent component', () => {
+        // Should not throw
+        model.removeComponent('does-not-exist');
+    });
 });
 //# sourceMappingURL=surface-components-model.test.js.map

package/src/v0_9/state/surface-components-model.test.js.map

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

package/{dist/src → src}/v0_9/state/surface-group-model.d.ts

@@ -1,6 +1,7 @@
 import { SurfaceModel } from './surface-model.js';
 import { ComponentApi } from '../catalog/types.js';
 import { EventSource } from '../common/events.js';
+import { A2uiClientAction } from '../schema/client-to-server.js';
 /**
  * The root state model for the A2UI system.
  * Manages the collection of active surfaces.
@@ -16,10 +17,36 @@ export declare class SurfaceGroupModel<T extends ComponentApi> {
     /** Fires when a surface is removed. */
     readonly onSurfaceDeleted: EventSource<string>;
     /** Fires when an action is dispatched from ANY surface in the group. */
-    readonly onAction: EventSource<any>;
+    readonly onAction: EventSource<A2uiClientAction>;
+    /**
+     * Adds a surface to the group.
+     * Ignores if a surface with the same ID already exists.
+     *
+     * @param surface The surface model to add.
+     */
     addSurface(surface: SurfaceModel<T>): void;
+    /**
+     * Removes a surface from the group by its ID.
+     * Disposes of the surface upon removal.
+     *
+     * @param id The ID of the surface to remove.
+     */
     deleteSurface(id: string): void;
+    /**
+     * Retrieves a surface by its ID.
+     *
+     *
+     * @param id The ID of the surface to retrieve.
+     * @returns The surface model, or undefined if not found.
+     */
     getSurface(id: string): SurfaceModel<T> | undefined;
+    /**
+     * Returns a readonly map of all active surfaces.
+     */
+    get surfacesMap(): ReadonlyMap<string, SurfaceModel<T>>;
+    /**
+     * Disposes of the group and all its surfaces.
+     */
     dispose(): void;
 }
 //# sourceMappingURL=surface-group-model.d.ts.map

package/src/v0_9/state/surface-group-model.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"surface-group-model.d.ts","sourceRoot":"","sources":["../../../../src/v0_9/state/surface-group-model.ts"],"names":[],"mappings":"AAgBA,OAAO,EAAC,YAAY,EAAC,MAAM,oBAAoB,CAAC;AAChD,OAAO,EAAC,YAAY,EAAC,MAAM,qBAAqB,CAAC;AACjD,OAAO,EAAe,WAAW,EAAe,MAAM,qBAAqB,CAAC;AAC5E,OAAO,EAAC,gBAAgB,EAAC,MAAM,+BAA+B,CAAC;AAE/D;;;GAGG;AACH,qBAAa,iBAAiB,CAAC,CAAC,SAAS,YAAY;IACnD,OAAO,CAAC,QAAQ,CAA2C;IAC3D,OAAO,CAAC,oBAAoB,CAAwC;IAEpE,OAAO,CAAC,QAAQ,CAAC,iBAAiB,CAAuC;IACzE,OAAO,CAAC,QAAQ,CAAC,iBAAiB,CAA8B;IAChE,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAwC;IAElE,yCAAyC;IACzC,QAAQ,CAAC,gBAAgB,EAAE,WAAW,CAAC,YAAY,CAAC,CAAC,CAAC,CAAC,CAC9B;IACzB,uCAAuC;IACvC,QAAQ,CAAC,gBAAgB,EAAE,WAAW,CAAC,MAAM,CAAC,CAA0B;IACxE,wEAAwE;IACxE,QAAQ,CAAC,QAAQ,EAAE,WAAW,CAAC,gBAAgB,CAAC,CAAkB;IAElE;;;;;OAKG;IACH,UAAU,CAAC,OAAO,EAAE,YAAY,CAAC,CAAC,CAAC,GAAG,IAAI;IAiB1C;;;;;OAKG;IACH,aAAa,CAAC,EAAE,EAAE,MAAM,GAAG,IAAI;IAe/B;;;;;;OAMG;IACH,UAAU,CAAC,EAAE,EAAE,MAAM,GAAG,YAAY,CAAC,CAAC,CAAC,GAAG,SAAS;IAInD;;OAEG;IACH,IAAI,WAAW,IAAI,WAAW,CAAC,MAAM,EAAE,YAAY,CAAC,CAAC,CAAC,CAAC,CAEtD;IAED;;OAEG;IACH,OAAO,IAAI,IAAI;CAQhB"}

package/{dist/src → src}/v0_9/state/surface-group-model.js

@@ -1,3 +1,18 @@
+/*
+ * 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 { EventEmitter } from '../common/events.js';
 /**
  * The root state model for the A2UI system.
@@ -17,6 +32,12 @@ export class SurfaceGroupModel {
         /** Fires when an action is dispatched from ANY surface in the group. */
         this.onAction = this._onAction;
     }
+    /**
+     * Adds a surface to the group.
+     * Ignores if a surface with the same ID already exists.
+     *
+     * @param surface The surface model to add.
+     */
     addSurface(surface) {
         if (this.surfaces.has(surface.id)) {
             console.warn(`Surface ${surface.id} already exists. Ignoring.`);
@@ -24,10 +45,16 @@ export class SurfaceGroupModel {
         }
         this.surfaces.set(surface.id, surface);
         // Subscribe to surface actions and propagate
-        const sub = surface.onAction.subscribe((action) => this._onAction.emit(action));
+        const sub = surface.onAction.subscribe(action => this._onAction.emit(action));
         this.surfaceUnsubscribers.set(surface.id, sub);
         this._onSurfaceCreated.emit(surface);
     }
+    /**
+     * Removes a surface from the group by its ID.
+     * Disposes of the surface upon removal.
+     *
+     * @param id The ID of the surface to remove.
+     */
     deleteSurface(id) {
         const surface = this.surfaces.get(id);
         if (surface) {
@@ -41,9 +68,25 @@ export class SurfaceGroupModel {
             this._onSurfaceDeleted.emit(id);
         }
     }
+    /**
+     * Retrieves a surface by its ID.
+     *
+     *
+     * @param id The ID of the surface to retrieve.
+     * @returns The surface model, or undefined if not found.
+     */
     getSurface(id) {
         return this.surfaces.get(id);
     }
+    /**
+     * Returns a readonly map of all active surfaces.
+     */
+    get surfacesMap() {
+        return this.surfaces;
+    }
+    /**
+     * Disposes of the group and all its surfaces.
+     */
     dispose() {
         for (const id of Array.from(this.surfaces.keys())) {
             this.deleteSurface(id);

package/src/v0_9/state/surface-group-model.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"surface-group-model.js","sourceRoot":"","sources":["../../../../src/v0_9/state/surface-group-model.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAIH,OAAO,EAAC,YAAY,EAA4B,MAAM,qBAAqB,CAAC;AAG5E;;;GAGG;AACH,MAAM,OAAO,iBAAiB;IAA9B;QACU,aAAQ,GAAiC,IAAI,GAAG,EAAE,CAAC;QACnD,yBAAoB,GAA8B,IAAI,GAAG,EAAE,CAAC;QAEnD,sBAAiB,GAAG,IAAI,YAAY,EAAmB,CAAC;QACxD,sBAAiB,GAAG,IAAI,YAAY,EAAU,CAAC;QAC/C,cAAS,GAAG,IAAI,YAAY,EAAoB,CAAC;QAElE,yCAAyC;QAChC,qBAAgB,GACvB,IAAI,CAAC,iBAAiB,CAAC;QACzB,uCAAuC;QAC9B,qBAAgB,GAAwB,IAAI,CAAC,iBAAiB,CAAC;QACxE,wEAAwE;QAC/D,aAAQ,GAAkC,IAAI,CAAC,SAAS,CAAC;IA2EpE,CAAC;IAzEC;;;;;OAKG;IACH,UAAU,CAAC,OAAwB;QACjC,IAAI,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,OAAO,CAAC,EAAE,CAAC,EAAE,CAAC;YAClC,OAAO,CAAC,IAAI,CAAC,WAAW,OAAO,CAAC,EAAE,4BAA4B,CAAC,CAAC;YAChE,OAAO;QACT,CAAC;QAED,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,OAAO,CAAC,EAAE,EAAE,OAAO,CAAC,CAAC;QAEvC,6CAA6C;QAC7C,MAAM,GAAG,GAAG,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAC,MAAM,CAAC,EAAE,CAC9C,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,MAAM,CAAC,CAC5B,CAAC;QACF,IAAI,CAAC,oBAAoB,CAAC,GAAG,CAAC,OAAO,CAAC,EAAE,EAAE,GAAG,CAAC,CAAC;QAE/C,IAAI,CAAC,iBAAiB,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;IACvC,CAAC;IAED;;;;;OAKG;IACH,aAAa,CAAC,EAAU;QACtB,MAAM,OAAO,GAAG,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;QACtC,IAAI,OAAO,EAAE,CAAC;YACZ,MAAM,GAAG,GAAG,IAAI,CAAC,oBAAoB,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;YAC9C,IAAI,GAAG,EAAE,CAAC;gBACR,GAAG,CAAC,WAAW,EAAE,CAAC;gBAClB,IAAI,CAAC,oBAAoB,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC;YACvC,CAAC;YAED,IAAI,CAAC,QAAQ,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC;YACzB,OAAO,CAAC,OAAO,EAAE,CAAC;YAClB,IAAI,CAAC,iBAAiB,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;QAClC,CAAC;IACH,CAAC;IAED;;;;;;OAMG;IACH,UAAU,CAAC,EAAU;QACnB,OAAO,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;IAC/B,CAAC;IAED;;OAEG;IACH,IAAI,WAAW;QACb,OAAO,IAAI,CAAC,QAAQ,CAAC;IACvB,CAAC;IAED;;OAEG;IACH,OAAO;QACL,KAAK,MAAM,EAAE,IAAI,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,QAAQ,CAAC,IAAI,EAAE,CAAC,EAAE,CAAC;YAClD,IAAI,CAAC,aAAa,CAAC,EAAE,CAAC,CAAC;QACzB,CAAC;QACD,IAAI,CAAC,iBAAiB,CAAC,OAAO,EAAE,CAAC;QACjC,IAAI,CAAC,iBAAiB,CAAC,OAAO,EAAE,CAAC;QACjC,IAAI,CAAC,SAAS,CAAC,OAAO,EAAE,CAAC;IAC3B,CAAC;CACF"}

package/{dist/src → src}/v0_9/state/surface-group-model.test.js

@@ -1,3 +1,18 @@
+/*
+ * 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 { SurfaceGroupModel } from './surface-group-model.js';
@@ -33,8 +48,12 @@ describe('SurfaceGroupModel', () => {
     it('notifies lifecycle listeners', () => {
         let created;
         let deletedId;
-        model.onSurfaceCreated.subscribe((s) => { created = s; });
-        model.onSurfaceDeleted.subscribe((id) => { deletedId = id; });
+        model.onSurfaceCreated.subscribe(s => {
+            created = s;
+        });
+        model.onSurfaceDeleted.subscribe(id => {
+            deletedId = id;
+        });
         const surface = new SurfaceModel('s1', catalog, {});
         model.addSurface(surface);
         assert.ok(created);
@@ -44,13 +63,15 @@ describe('SurfaceGroupModel', () => {
     });
     it('propagates actions from surfaces', async () => {
         let receivedAction;
-        model.onAction.subscribe((action) => {
+        model.onAction.subscribe(action => {
             receivedAction = action;
         });
         const surface = new SurfaceModel('s1', catalog, {});
         model.addSurface(surface);
-        await surface.dispatchAction({ type: 'test' });
-        assert.deepStrictEqual(receivedAction, { type: 'test' });
+        await surface.dispatchAction({ event: { name: 'test' } }, 'c1');
+        assert.strictEqual(receivedAction.name, 'test');
+        assert.strictEqual(receivedAction.surfaceId, 's1');
+        assert.strictEqual(receivedAction.sourceComponentId, 'c1');
     });
     it('stops propagating actions after deletion', async () => {
         let callCount = 0;
@@ -60,8 +81,28 @@ describe('SurfaceGroupModel', () => {
         const surface = new SurfaceModel('s1', catalog, {});
         model.addSurface(surface);
         model.deleteSurface('s1');
-        await surface.dispatchAction({ type: 'test' });
+        await surface.dispatchAction({ event: { name: 'test' } }, 'c1');
         assert.strictEqual(callCount, 0);
     });
+    it('exposes surfacesMap', () => {
+        const surface = new SurfaceModel('s1', catalog, {});
+        model.addSurface(surface);
+        const map = model.surfacesMap;
+        assert.strictEqual(map.size, 1);
+        assert.strictEqual(map.get('s1'), surface);
+    });
+    it('disposes correctly', () => {
+        const s1 = new SurfaceModel('s1', catalog, {});
+        const s2 = new SurfaceModel('s2', catalog, {});
+        model.addSurface(s1);
+        model.addSurface(s2);
+        let deletedCount = 0;
+        model.onSurfaceDeleted.subscribe(() => {
+            deletedCount++;
+        });
+        model.dispose();
+        assert.strictEqual(deletedCount, 2);
+        assert.strictEqual(model.surfacesMap.size, 0);
+    });
 });
 //# sourceMappingURL=surface-group-model.test.js.map