@a2ui/web_core 0.8.0

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

@@ -0,0 +1,204 @@
+import assert from 'node:assert';
+import { describe, it, beforeEach } from 'node:test';
+import { DataModel } from './data-model.js';
+describe('DataModel', () => {
+    let model;
+    beforeEach(() => {
+        model = new DataModel({
+            user: {
+                name: 'Alice',
+                settings: {
+                    theme: 'dark'
+                }
+            },
+            items: ['a', 'b', 'c']
+        });
+    });
+    // --- Basic Retrieval ---
+    it('retrieves root data', () => {
+        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');
+        assert.strictEqual(model.get('/user/settings/theme'), 'dark');
+    });
+    it('retrieves array items', () => {
+        assert.strictEqual(model.get('/items/0'), 'a');
+        assert.strictEqual(model.get('/items/1'), 'b');
+    });
+    it('returns undefined for non-existent paths', () => {
+        assert.strictEqual(model.get('/user/age'), undefined);
+        assert.strictEqual(model.get('/unknown/path'), undefined);
+    });
+    // --- Updates ---
+    it('sets value at existing path', () => {
+        model.set('/user/name', 'Bob');
+        assert.strictEqual(model.get('/user/name'), 'Bob');
+    });
+    it('sets value at new path', () => {
+        model.set('/user/age', 30);
+        assert.strictEqual(model.get('/user/age'), 30);
+    });
+    it('creates intermediate objects', () => {
+        model.set('/a/b/c', 'foo');
+        assert.strictEqual(model.get('/a/b/c'), 'foo');
+        assert.notStrictEqual(model.get('/a/b'), undefined);
+    });
+    it('removes keys when value is undefined', () => {
+        model.set('/user/name', undefined);
+        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');
+        assert.strictEqual(model.get('/list/0'), 'hello');
+        assert.ok(Array.isArray(model.get('/list')));
+    });
+    it('List: append and get', () => {
+        model.set('/list/0', 'hello');
+        model.set('/list/1', 'world');
+        assert.strictEqual(model.get('/list/0'), 'hello');
+        assert.strictEqual(model.get('/list/1'), 'world');
+        assert.strictEqual(model.get('/list').length, 2);
+    });
+    it('List: update existing index', () => {
+        model.set('/items/1', 'updated');
+        assert.strictEqual(model.get('/items/1'), 'updated');
+    });
+    it('Nested structures are created automatically', () => {
+        // Should create nested map and list: { a: { b: [ { c: 123 } ] } }
+        model.set('/a/b/0/c', 123);
+        assert.strictEqual(model.get('/a/b/0/c'), 123);
+        assert.ok(Array.isArray(model.get('/a/b')));
+        assert.ok(!Array.isArray(model.get('/a/b/0')));
+        // Should create nested maps
+        model.set('/x/y/z', 'hello');
+        assert.strictEqual(model.get('/x/y/z'), 'hello');
+        // Should create nested lists
+        model.set('/nestedList/0/0', 'inner');
+        assert.strictEqual(model.get('/nestedList/0/0'), 'inner');
+        assert.ok(Array.isArray(model.get('/nestedList')));
+        assert.ok(Array.isArray(model.get('/nestedList/0')));
+    });
+    // --- Subscriptions ---
+    it('returns a subscription object', () => {
+        model.set('/a', 1);
+        const sub = model.subscribe('/a', (val) => updatedValue = val);
+        assert.strictEqual(sub.value, 1);
+        let updatedValue;
+        model.set('/a', 2);
+        assert.strictEqual(sub.value, 2);
+        assert.strictEqual(updatedValue, 2);
+        sub.unsubscribe();
+        // Verify listener removed
+        model.set('/a', 3);
+        assert.strictEqual(updatedValue, 2);
+    });
+    it('notifies subscribers on exact match', () => {
+        let called = false;
+        const sub = model.subscribe('/user/name', (val) => {
+            assert.strictEqual(val, 'Charlie');
+            called = true;
+        });
+        model.set('/user/name', 'Charlie');
+        assert.strictEqual(called, true, 'Callback was never called');
+    });
+    it('notifies ancestor subscribers (Container Semantics)', () => {
+        let called = false;
+        const sub = model.subscribe('/user', (val) => {
+            assert.strictEqual(val.name, 'Dave');
+            called = true;
+        });
+        model.set('/user/name', 'Dave');
+        assert.strictEqual(called, true, 'Callback was never called');
+    });
+    it('notifies descendant subscribers', () => {
+        let called = false;
+        const sub = model.subscribe('/user/settings/theme', (val) => {
+            assert.strictEqual(val, 'light');
+            called = true;
+        });
+        // We update the parent object
+        model.set('/user/settings', { theme: 'light' });
+        assert.strictEqual(called, true, 'Callback was never called');
+    });
+    it('notifies root subscriber', () => {
+        let called = false;
+        const sub = model.subscribe('/', (val) => {
+            assert.strictEqual(val.newProp, 'test');
+            called = true;
+        });
+        model.set('/newProp', 'test');
+        assert.strictEqual(called, true, 'Callback was never called');
+    });
+    it('notifies parent when child updates', () => {
+        model.set('/parent', { child: 'initial' });
+        let parentValue;
+        const sub = 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.dispose();
+        model.set('/foo', 'bar');
+        assert.strictEqual(count, 0);
+    });
+    it('supports multiple subscribers to the same path', () => {
+        let callCount1 = 0;
+        let callCount2 = 0;
+        const sub1 = model.subscribe('/user/name', () => callCount1++);
+        const sub2 = model.subscribe('/user/name', () => callCount2++);
+        model.set('/user/name', 'Eve');
+        assert.strictEqual(callCount1, 1);
+        assert.strictEqual(callCount2, 1);
+        assert.strictEqual(sub1.value, 'Eve');
+        assert.strictEqual(sub2.value, 'Eve');
+    });
+    it('allows unsubscribing individual listeners', () => {
+        let callCount1 = 0;
+        let callCount2 = 0;
+        const sub1 = model.subscribe('/user/name', () => callCount1++);
+        const sub2 = model.subscribe('/user/name', () => callCount2++);
+        sub1.unsubscribe();
+        model.set('/user/name', 'Frank');
+        assert.strictEqual(callCount1, 0); // sub1 was unsubscribed
+        assert.strictEqual(callCount2, 1); // sub2 still active
+        assert.strictEqual(sub2.value, 'Frank');
+    });
+    it('handles subscription to non-existent path', () => {
+        let val;
+        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');
+        assert.strictEqual(val, 'exists now');
+    });
+    it('handles updates to undefined', () => {
+        model.set('/foo', 'bar');
+        let val = 'initial';
+        const sub = model.subscribe('/foo', (v) => val = v);
+        model.set('/foo', undefined);
+        assert.strictEqual(sub.value, undefined);
+        assert.strictEqual(val, undefined);
+    });
+    it('throws when trying to set nested property through a primitive', () => {
+        model.set('/user/name', 'not an object');
+        assert.strictEqual(model.get('/user/name'), 'not an object');
+        assert.throws(() => {
+            model.set('/user/name/first', 'Alice');
+        }, /Cannot set path/);
+    });
+    it('throws when using non-numeric segment on an array', () => {
+        assert.throws(() => {
+            model.set('/items/foo', 'bar');
+        }, /Cannot use non-numeric segment/);
+    });
+});
+//# sourceMappingURL=data-model.test.js.map

package/dist/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/dist/src/v0_9/state/surface-components-model.d.ts

@@ -0,0 +1,19 @@
+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>;
+    get(id: string): ComponentModel | undefined;
+    addComponent(component: ComponentModel): void;
+    removeComponent(id: string): void;
+    dispose(): void;
+}
+//# sourceMappingURL=surface-components-model.d.ts.map

package/dist/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":"AAAA,OAAO,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AACtD,OAAO,EAAgB,WAAW,EAAE,MAAM,qBAAqB,CAAC;AAEhE;;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,GAAG,CAAC,EAAE,EAAE,MAAM,GAAG,cAAc,GAAG,SAAS;IAI3C,YAAY,CAAC,SAAS,EAAE,cAAc,GAAG,IAAI;IAS7C,eAAe,CAAC,EAAE,EAAE,MAAM,GAAG,IAAI;IASjC,OAAO,IAAI,IAAI;CAQhB"}

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

@@ -0,0 +1,42 @@
+import { EventEmitter } from '../common/events.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;
+    }
+    get(id) {
+        return this.components.get(id);
+    }
+    addComponent(component) {
+        if (this.components.has(component.id)) {
+            throw new Error(`Component with id '${component.id}' already exists.`);
+        }
+        this.components.set(component.id, component);
+        this._onCreated.emit(component);
+    }
+    removeComponent(id) {
+        const component = this.components.get(id);
+        if (component) {
+            this.components.delete(id);
+            component.dispose();
+            this._onDeleted.emit(id);
+        }
+    }
+    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/dist/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":"AACA,OAAO,EAAE,YAAY,EAAe,MAAM,qBAAqB,CAAC;AAEhE;;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;IAgC5D,CAAC;IA9BC,GAAG,CAAC,EAAU;QACZ,OAAO,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;IACjC,CAAC;IAED,YAAY,CAAC,SAAyB;QACpC,IAAI,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC,SAAS,CAAC,EAAE,CAAC,EAAE,CAAC;YACtC,MAAM,IAAI,KAAK,CAAC,sBAAsB,SAAS,CAAC,EAAE,mBAAmB,CAAC,CAAC;QACzE,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,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,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/v0_9/state/surface-components-model.test.d.ts

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

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

@@ -0,0 +1 @@
+{"version":3,"file":"surface-components-model.test.d.ts","sourceRoot":"","sources":["../../../../src/v0_9/state/surface-components-model.test.ts"],"names":[],"mappings":""}

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

@@ -0,0 +1,49 @@
+import assert from 'node:assert';
+import { describe, it, beforeEach } from 'node:test';
+import { SurfaceComponentsModel } from './surface-components-model.js';
+import { ComponentModel } from './component-model.js';
+describe('SurfaceComponentsModel', () => {
+    let model;
+    beforeEach(() => {
+        model = new SurfaceComponentsModel();
+    });
+    it('starts empty', () => {
+        assert.strictEqual(model.get('any'), undefined);
+    });
+    it('adds a new component', () => {
+        const c1 = new ComponentModel('c1', 'Button', { label: 'Click' });
+        model.addComponent(c1);
+        const retrieved = model.get('c1');
+        assert.ok(retrieved);
+        assert.strictEqual(retrieved?.id, 'c1');
+        assert.strictEqual(retrieved?.type, 'Button');
+        assert.strictEqual(retrieved?.properties.label, 'Click');
+    });
+    it('updates an existing component', () => {
+        const c1 = new ComponentModel('c1', 'Button', { label: 'Initial' });
+        model.addComponent(c1);
+        // Track update on component itself
+        let updateCount = 0;
+        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) => {
+            createdComponent = c;
+        });
+        model.addComponent(new ComponentModel('c1', 'Button', {}));
+        assert.ok(createdComponent);
+        assert.strictEqual(createdComponent?.id, 'c1');
+    });
+    it('throws when adding duplicate component', () => {
+        const c1 = new ComponentModel('c1', 'Button', {});
+        model.addComponent(c1);
+        assert.throws(() => {
+            model.addComponent(new ComponentModel('c1', 'Button', {}));
+        }, /already exists/);
+    });
+});
+//# sourceMappingURL=surface-components-model.test.js.map

package/dist/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/v0_9/state/surface-group-model.d.ts

@@ -0,0 +1,25 @@
+import { SurfaceModel } from './surface-model.js';
+import { ComponentApi } from '../catalog/types.js';
+import { EventSource } from '../common/events.js';
+/**
+ * The root state model for the A2UI system.
+ * Manages the collection of active surfaces.
+ */
+export declare class SurfaceGroupModel<T extends ComponentApi> {
+    private surfaces;
+    private surfaceUnsubscribers;
+    private readonly _onSurfaceCreated;
+    private readonly _onSurfaceDeleted;
+    private readonly _onAction;
+    /** Fires when a new surface is added. */
+    readonly onSurfaceCreated: EventSource<SurfaceModel<T>>;
+    /** 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>;
+    addSurface(surface: SurfaceModel<T>): void;
+    deleteSurface(id: string): void;
+    getSurface(id: string): SurfaceModel<T> | undefined;
+    dispose(): void;
+}
+//# sourceMappingURL=surface-group-model.d.ts.map

package/dist/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":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAClD,OAAO,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAC;AACnD,OAAO,EAAgB,WAAW,EAAgB,MAAM,qBAAqB,CAAC;AAE9E;;;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,CAA2B;IAErD,yCAAyC;IACzC,QAAQ,CAAC,gBAAgB,EAAE,WAAW,CAAC,YAAY,CAAC,CAAC,CAAC,CAAC,CAA0B;IACjF,uCAAuC;IACvC,QAAQ,CAAC,gBAAgB,EAAE,WAAW,CAAC,MAAM,CAAC,CAA0B;IACxE,wEAAwE;IACxE,QAAQ,CAAC,QAAQ,EAAE,WAAW,CAAC,GAAG,CAAC,CAAkB;IAErD,UAAU,CAAC,OAAO,EAAE,YAAY,CAAC,CAAC,CAAC,GAAG,IAAI;IAe1C,aAAa,CAAC,EAAE,EAAE,MAAM,GAAG,IAAI;IAe/B,UAAU,CAAC,EAAE,EAAE,MAAM,GAAG,YAAY,CAAC,CAAC,CAAC,GAAG,SAAS;IAInD,OAAO,IAAI,IAAI;CAQhB"}

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

@@ -0,0 +1,56 @@
+import { EventEmitter } from '../common/events.js';
+/**
+ * The root state model for the A2UI system.
+ * Manages the collection of active surfaces.
+ */
+export class SurfaceGroupModel {
+    constructor() {
+        this.surfaces = new Map();
+        this.surfaceUnsubscribers = new Map();
+        this._onSurfaceCreated = new EventEmitter();
+        this._onSurfaceDeleted = new EventEmitter();
+        this._onAction = new EventEmitter();
+        /** Fires when a new surface is added. */
+        this.onSurfaceCreated = this._onSurfaceCreated;
+        /** Fires when a surface is removed. */
+        this.onSurfaceDeleted = this._onSurfaceDeleted;
+        /** Fires when an action is dispatched from ANY surface in the group. */
+        this.onAction = this._onAction;
+    }
+    addSurface(surface) {
+        if (this.surfaces.has(surface.id)) {
+            console.warn(`Surface ${surface.id} already exists. Ignoring.`);
+            return;
+        }
+        this.surfaces.set(surface.id, surface);
+        // Subscribe to surface actions and propagate
+        const sub = surface.onAction.subscribe((action) => this._onAction.emit(action));
+        this.surfaceUnsubscribers.set(surface.id, sub);
+        this._onSurfaceCreated.emit(surface);
+    }
+    deleteSurface(id) {
+        const surface = this.surfaces.get(id);
+        if (surface) {
+            const sub = this.surfaceUnsubscribers.get(id);
+            if (sub) {
+                sub.unsubscribe();
+                this.surfaceUnsubscribers.delete(id);
+            }
+            this.surfaces.delete(id);
+            surface.dispose();
+            this._onSurfaceDeleted.emit(id);
+        }
+    }
+    getSurface(id) {
+        return this.surfaces.get(id);
+    }
+    dispose() {
+        for (const id of Array.from(this.surfaces.keys())) {
+            this.deleteSurface(id);
+        }
+        this._onSurfaceCreated.dispose();
+        this._onSurfaceDeleted.dispose();
+        this._onAction.dispose();
+    }
+}
+//# sourceMappingURL=surface-group-model.js.map

package/dist/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":"AAEA,OAAO,EAAE,YAAY,EAA6B,MAAM,qBAAqB,CAAC;AAE9E;;;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,EAAO,CAAC;QAErD,yCAAyC;QAChC,qBAAgB,GAAiC,IAAI,CAAC,iBAAiB,CAAC;QACjF,uCAAuC;QAC9B,qBAAgB,GAAwB,IAAI,CAAC,iBAAiB,CAAC;QACxE,wEAAwE;QAC/D,aAAQ,GAAqB,IAAI,CAAC,SAAS,CAAC;IA4CvD,CAAC;IA1CC,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,CAAC,MAAM,EAAE,EAAE,CAAC,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC;QAChF,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,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,UAAU,CAAC,EAAU;QACnB,OAAO,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;IAC/B,CAAC;IAED,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/v0_9/state/surface-group-model.test.d.ts

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

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

@@ -0,0 +1 @@
+{"version":3,"file":"surface-group-model.test.d.ts","sourceRoot":"","sources":["../../../../src/v0_9/state/surface-group-model.test.ts"],"names":[],"mappings":""}

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

@@ -0,0 +1,67 @@
+import assert from 'node:assert';
+import { describe, it, beforeEach } from 'node:test';
+import { SurfaceGroupModel } from './surface-group-model.js';
+import { Catalog } from '../catalog/types.js';
+import { SurfaceModel } from './surface-model.js';
+describe('SurfaceGroupModel', () => {
+    let model;
+    let catalog;
+    beforeEach(() => {
+        model = new SurfaceGroupModel();
+        catalog = new Catalog('test-catalog', []);
+    });
+    it('adds surface', () => {
+        const surface = new SurfaceModel('s1', catalog, {});
+        model.addSurface(surface);
+        assert.ok(model.getSurface('s1'));
+        assert.strictEqual(model.getSurface('s1'), surface);
+    });
+    it('ignores duplicate surface addition', () => {
+        const s1 = new SurfaceModel('s1', catalog, {});
+        const s2 = new SurfaceModel('s1', catalog, {}); // Same ID
+        model.addSurface(s1);
+        model.addSurface(s2);
+        assert.strictEqual(model.getSurface('s1'), s1); // Should still be the first one
+    });
+    it('deletes surface', () => {
+        const surface = new SurfaceModel('s1', catalog, {});
+        model.addSurface(surface);
+        assert.ok(model.getSurface('s1'));
+        model.deleteSurface('s1');
+        assert.strictEqual(model.getSurface('s1'), undefined);
+    });
+    it('notifies lifecycle listeners', () => {
+        let created;
+        let deletedId;
+        model.onSurfaceCreated.subscribe((s) => { created = s; });
+        model.onSurfaceDeleted.subscribe((id) => { deletedId = id; });
+        const surface = new SurfaceModel('s1', catalog, {});
+        model.addSurface(surface);
+        assert.ok(created);
+        assert.strictEqual(created?.id, 's1');
+        model.deleteSurface('s1');
+        assert.strictEqual(deletedId, 's1');
+    });
+    it('propagates actions from surfaces', async () => {
+        let receivedAction;
+        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' });
+    });
+    it('stops propagating actions after deletion', async () => {
+        let callCount = 0;
+        model.onAction.subscribe(() => {
+            callCount++;
+        });
+        const surface = new SurfaceModel('s1', catalog, {});
+        model.addSurface(surface);
+        model.deleteSurface('s1');
+        await surface.dispatchAction({ type: 'test' });
+        assert.strictEqual(callCount, 0);
+    });
+});
+//# sourceMappingURL=surface-group-model.test.js.map

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

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

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

@@ -0,0 +1,23 @@
+import { DataModel } from './data-model.js';
+import { Catalog, ComponentApi } from '../catalog/types.js';
+import { SurfaceComponentsModel } from './surface-components-model.js';
+import { EventSource } from '../common/events.js';
+export type ActionListener = (action: any) => void | Promise<void>;
+/**
+ * The state model for a single surface.
+ * @template T The concrete type of the ComponentApi.
+ */
+export declare class SurfaceModel<T extends ComponentApi> {
+    readonly id: string;
+    readonly catalog: Catalog<T>;
+    readonly theme: any;
+    readonly dataModel: DataModel;
+    readonly componentsModel: SurfaceComponentsModel;
+    private readonly _onAction;
+    /** Fires whenever an action is dispatched from this surface. */
+    readonly onAction: EventSource<any>;
+    constructor(id: string, catalog: Catalog<T>, theme?: any);
+    dispatchAction(action: any): Promise<void>;
+    dispose(): void;
+}
+//# sourceMappingURL=surface-model.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"surface-model.d.ts","sourceRoot":"","sources":["../../../../src/v0_9/state/surface-model.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC;AAC5C,OAAO,EAAE,OAAO,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAC;AAC5D,OAAO,EAAE,sBAAsB,EAAE,MAAM,+BAA+B,CAAC;AACvE,OAAO,EAAgB,WAAW,EAAE,MAAM,qBAAqB,CAAC;AAEhE,MAAM,MAAM,cAAc,GAAG,CAAC,MAAM,EAAE,GAAG,KAAK,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;AAEnE;;;GAGG;AACH,qBAAa,YAAY,CAAC,CAAC,SAAS,YAAY;IAU5C,QAAQ,CAAC,EAAE,EAAE,MAAM;IACnB,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC,CAAC;IAC5B,QAAQ,CAAC,KAAK,EAAE,GAAG;IAXrB,QAAQ,CAAC,SAAS,EAAE,SAAS,CAAC;IAC9B,QAAQ,CAAC,eAAe,EAAE,sBAAsB,CAAC;IAEjD,OAAO,CAAC,QAAQ,CAAC,SAAS,CAA2B;IAErD,gEAAgE;IAChE,QAAQ,CAAC,QAAQ,EAAE,WAAW,CAAC,GAAG,CAAC,CAAkB;gBAG1C,EAAE,EAAE,MAAM,EACV,OAAO,EAAE,OAAO,CAAC,CAAC,CAAC,EACnB,KAAK,GAAE,GAAQ;IAMpB,cAAc,CAAC,MAAM,EAAE,GAAG,GAAG,OAAO,CAAC,IAAI,CAAC;IAIhD,OAAO,IAAI,IAAI;CAKhB"}

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

@@ -0,0 +1,28 @@
+import { DataModel } from './data-model.js';
+import { SurfaceComponentsModel } from './surface-components-model.js';
+import { EventEmitter } from '../common/events.js';
+/**
+ * The state model for a single surface.
+ * @template T The concrete type of the ComponentApi.
+ */
+export class SurfaceModel {
+    constructor(id, catalog, theme = {}) {
+        this.id = id;
+        this.catalog = catalog;
+        this.theme = theme;
+        this._onAction = new EventEmitter();
+        /** Fires whenever an action is dispatched from this surface. */
+        this.onAction = this._onAction;
+        this.dataModel = new DataModel({});
+        this.componentsModel = new SurfaceComponentsModel();
+    }
+    async dispatchAction(action) {
+        await this._onAction.emit(action);
+    }
+    dispose() {
+        this.dataModel.dispose();
+        this.componentsModel.dispose();
+        this._onAction.dispose();
+    }
+}
+//# sourceMappingURL=surface-model.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"surface-model.js","sourceRoot":"","sources":["../../../../src/v0_9/state/surface-model.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC;AAE5C,OAAO,EAAE,sBAAsB,EAAE,MAAM,+BAA+B,CAAC;AACvE,OAAO,EAAE,YAAY,EAAe,MAAM,qBAAqB,CAAC;AAIhE;;;GAGG;AACH,MAAM,OAAO,YAAY;IASvB,YACW,EAAU,EACV,OAAmB,EACnB,QAAa,EAAE;QAFf,OAAE,GAAF,EAAE,CAAQ;QACV,YAAO,GAAP,OAAO,CAAY;QACnB,UAAK,GAAL,KAAK,CAAU;QART,cAAS,GAAG,IAAI,YAAY,EAAO,CAAC;QAErD,gEAAgE;QACvD,aAAQ,GAAqB,IAAI,CAAC,SAAS,CAAC;QAOnD,IAAI,CAAC,SAAS,GAAG,IAAI,SAAS,CAAC,EAAE,CAAC,CAAC;QACnC,IAAI,CAAC,eAAe,GAAG,IAAI,sBAAsB,EAAE,CAAC;IACtD,CAAC;IAED,KAAK,CAAC,cAAc,CAAC,MAAW;QAC9B,MAAM,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;IACpC,CAAC;IAED,OAAO;QACL,IAAI,CAAC,SAAS,CAAC,OAAO,EAAE,CAAC;QACzB,IAAI,CAAC,eAAe,CAAC,OAAO,EAAE,CAAC;QAC/B,IAAI,CAAC,SAAS,CAAC,OAAO,EAAE,CAAC;IAC3B,CAAC;CACF"}

package/dist/src/v0_9/state/surface-model.test.d.ts

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

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

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