@a2ui/web_core 0.8.0 → 0.9.0

package/src/v0_9/state/component-model.test.ts

@@ -1,50 +0,0 @@
-import assert from 'node:assert';
-import { describe, it, beforeEach } from 'node:test';
-import { ComponentModel } from './component-model.js';
-
-describe('ComponentModel', () => {
-  let component: ComponentModel;
-
-  beforeEach(() => {
-    component = new ComponentModel('c1', 'Button', { label: 'Click Me' });
-  });
-
-  it('initializes properties', () => {
-    assert.strictEqual(component.id, 'c1');
-    assert.strictEqual(component.type, 'Button');
-    assert.strictEqual(component.properties.label, 'Click Me');
-  });
-
-  it('updates properties', () => {
-    component.properties = { label: 'Clicked' };
-    assert.strictEqual(component.properties.label, 'Clicked');
-  });
-
-  it('notifies listeners on update', () => {
-    let updatedComponent: ComponentModel | undefined;
-    
-    component.onUpdated.subscribe((c: ComponentModel) => {
-      updatedComponent = c;
-    });
-    
-    component.properties = { label: 'New' };
-    
-    assert.strictEqual(updatedComponent, component);
-    assert.strictEqual(updatedComponent?.properties.label, 'New');
-  });
-
-  it('unsubscribes listeners', () => {
-    let callCount = 0;
-    
-    const sub = component.onUpdated.subscribe(() => {
-      callCount++;
-    });
-    
-    component.properties = { label: '1' };
-    assert.strictEqual(callCount, 1);
-    
-    sub.unsubscribe();
-    component.properties = { label: '2' };
-    assert.strictEqual(callCount, 1);
-  });
-});

package/src/v0_9/state/component-model.ts

@@ -1,32 +0,0 @@
-import { EventEmitter, EventSource } from '../common/events.js';
-
-export class ComponentModel {
-  private _properties: Record<string, any>;
-  private readonly _onUpdated = new EventEmitter<ComponentModel>();
-  
-  /** 
-   * Fires whenever the component's properties are updated.
-   */
-  readonly onUpdated: EventSource<ComponentModel> = this._onUpdated;
-
-  constructor(
-    readonly id: string,
-    readonly type: string,
-    initialProperties: Record<string, any>
-  ) {
-    this._properties = initialProperties;
-  }
-
-  get properties(): Record<string, any> {
-    return this._properties;
-  }
-
-  set properties(newProperties: Record<string, any>) {
-    this._properties = newProperties;
-    this._onUpdated.emit(this);
-  }
-
-  dispose(): void {
-    this._onUpdated.dispose();
-  }
-}

package/src/v0_9/state/data-model.test.ts

@@ -1,257 +0,0 @@
-import assert from 'node:assert';
-import { test, describe, it, beforeEach } from 'node:test';
-import { DataModel } from './data-model.js';
-
-describe('DataModel', () => {
-  let model: DataModel;
-
-  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<number>('/a', (val) => updatedValue = val);
-    assert.strictEqual(sub.value, 1);
-
-    let updatedValue: number | undefined;
-    
-
-    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: any) => {
-      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: any) => {
-      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: any;
-    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: any;
-    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: any = '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/);
-  });
-});

package/src/v0_9/state/data-model.ts

@@ -1,239 +0,0 @@
-/*
- 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 { Subscription as BaseSubscription } from '../common/events.js';
-
-/**
- * Represents a reactive connection to a specific path in the data model.
- */
-export interface DataSubscription<T> extends BaseSubscription {
-  /**
-   * The current value at the subscribed path.
-   */
-  readonly value: T | undefined;
-}
-
-class SubscriptionImpl<T> implements DataSubscription<T> {
-  private _value: T | undefined;
-  private readonly _unsubscribe: () => void;
-  public onChange: (value: T | undefined) => void;
-
-  constructor(initialValue: T | undefined, onChange: (value: T | undefined) => void, unsubscribe: () => void) {
-    this._value = initialValue;
-    this.onChange = onChange;
-    this._unsubscribe = unsubscribe;
-  }
-
-  get value(): T | undefined {
-    return this._value;
-  }
-
-  setValue(value: T | undefined): void {
-    this._value = value;
-    this.onChange(value);
-  }
-
-  unsubscribe(): void {
-    this._unsubscribe();
-  }
-}
-
-function isNumeric(value: string): boolean {
-  return /^\d+$/.test(value);
-}
-
-/**
- * A standalone, observable data store representing the client-side state.
- * It handles JSON Pointer path resolution and subscription management.
- */
-export class DataModel {
-  private data: Record<string, unknown> = {};
-  private readonly subscriptions: Map<string, Set<SubscriptionImpl<any>>> = new Map();
-
-  constructor(initialData: Record<string, unknown> = {}) {
-    this.data = initialData;
-  }
-
-  /**
-   * Updates the model at the specific path and notifies all relevant subscribers.
-   * If path is '/' or empty, replaces the entire root.
-   *
-   * Note on `undefined` values:
-   * - For objects: Setting a property to `undefined` removes the key from the object.
-   * - For arrays: Setting an index to `undefined` sets that index to `undefined` but preserves the array length (sparse array).
-   */
-  set(path: string, value: any): this {
-    if (path === null || path === undefined) {
-      throw new Error("Path cannot be null or undefined.");
-    }
-    if (path === '/' || path === '') {
-      this.data = value;
-      this.notifyAllSubscribers();
-      return this;
-    }
-
-    const segments = this.parsePath(path);
-    const lastSegment = segments.pop()!;
-
-    let current: any = this.data;
-    for (let i = 0; i < segments.length; i++) {
-      const segment = segments[i];
-
-      if (Array.isArray(current) && !isNumeric(segment)) {
-        throw new Error(`Cannot use non-numeric segment '${segment}' on an array in path '${path}'.`);
-      }
-
-      // If we encounter a primitive where a container is expected, we cannot proceed.
-      // We allow undefined/null to be overwritten by a new container.
-      if (current[segment] !== undefined && current[segment] !== null && typeof current[segment] !== 'object') {
-        throw new Error(`Cannot set path '${path}': segment '${segment}' is a primitive value.`);
-      }
-
-      if (current[segment] === undefined || current[segment] === null) {
-        const nextSegment = (i < segments.length - 1) ? segments[i + 1] : lastSegment;
-        current[segment] = isNumeric(nextSegment) ? [] : {};
-      }
-      current = current[segment];
-    }
-
-    if (Array.isArray(current) && !isNumeric(lastSegment)) {
-      throw new Error(`Cannot use non-numeric segment '${lastSegment}' on an array in path '${path}'.`);
-    }
-
-    if (value === undefined) {
-      if (Array.isArray(current)) {
-        current[parseInt(lastSegment, 10)] = undefined;
-      } else {
-        delete current[lastSegment];
-      }
-    } else {
-      current[lastSegment] = value;
-    }
-
-    this.notifySubscribers(path);
-    return this;
-  }
-
-  /**
-   * Retrieves data at a specific path.
-   */
-  get(path: string): any {
-    if (path === null || path === undefined) {
-      throw new Error("Path cannot be null or undefined.");
-    }
-    if (path === '/' || path === '') {
-      return this.data;
-    }
-
-    const segments = this.parsePath(path);
-    let current: any = this.data;
-    for (const segment of segments) {
-      if (current === undefined || current === null) {
-        return undefined;
-      }
-      current = current[segment];
-    }
-    return current;
-  }
-
-  /**
-   * Subscribes to changes at a specific path. Returns a Subscription object.
-   */
-  subscribe<T>(path: string, onChange: (value: T | undefined) => void): DataSubscription<T> {
-    const normalizedPath = this.normalizePath(path);
-    const initialValue = this.get(normalizedPath);
-
-    const subscription = new SubscriptionImpl<T>(
-      initialValue,
-      onChange,
-      () => {
-        const set = this.subscriptions.get(normalizedPath);
-        if (set) {
-          set.delete(subscription);
-          if (set.size === 0) {
-            this.subscriptions.delete(normalizedPath);
-          }
-        }
-      }
-    );
-
-    if (!this.subscriptions.has(normalizedPath)) {
-      this.subscriptions.set(normalizedPath, new Set());
-    }
-    this.subscriptions.get(normalizedPath)!.add(subscription);
-
-    return subscription;
-  }
-
-  /**
-   * Clears all internal subscriptions.
-   */
-  dispose(): void {
-    this.subscriptions.clear();
-  }
-
-  private normalizePath(path: string): string {
-    if (path.length > 1 && path.endsWith('/')) {
-      return path.slice(0, -1);
-    }
-    return path || '/';
-  }
-
-  private parsePath(path: string): string[] {
-    return path.split('/').filter(p => p.length > 0);
-  }
-
-  private notifySubscribers(path: string): void {
-    const normalizedPath = this.normalizePath(path);
-    this.notify(normalizedPath);
-
-    // Notify Ancestors
-    let parentPath = normalizedPath;
-    while (parentPath !== '/' && parentPath !== '') {
-      parentPath = parentPath.substring(0, parentPath.lastIndexOf('/')) || '/';
-      this.notify(parentPath);
-    }
-
-    // Notify Descendants
-    for (const subPath of this.subscriptions.keys()) {
-      if (this.isDescendant(subPath, normalizedPath)) {
-        this.notify(subPath);
-      }
-    }
-  }
-
-  private notify(path: string): void {
-    const set = this.subscriptions.get(path);
-    if (!set) {
-      return;
-    }
-    const value = this.get(path);
-    set.forEach(sub => sub.setValue(value));
-  }
-
-  private notifyAllSubscribers(): void {
-    for (const path of this.subscriptions.keys()) {
-      this.notify(path);
-    }
-  }
-
-  private isDescendant(childPath: string, parentPath: string): boolean {
-    if (parentPath === '/' || parentPath === '') {
-      return childPath !== '/';
-    }
-    return childPath.startsWith(parentPath + '/');
-  }
-}

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

@@ -1,59 +0,0 @@
-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: SurfaceComponentsModel;
-
-  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: ComponentModel | undefined;
-    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/);
-  });
-});

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

@@ -1,48 +0,0 @@
-import { ComponentModel } from './component-model.js';
-import { EventEmitter, EventSource } from '../common/events.js';
-
-/**
- * Manages the collection of components for a specific surface.
- */
-export class SurfaceComponentsModel {
-  private components: Map<string, ComponentModel> = new Map();
-  
-  private readonly _onCreated = new EventEmitter<ComponentModel>();
-  private readonly _onDeleted = new EventEmitter<string>();
-
-  /** Fires when a new component is added to the model. */
-  readonly onCreated: EventSource<ComponentModel> = this._onCreated;
-  /** Fires when a component is removed, providing the ID of the deleted component. */
-  readonly onDeleted: EventSource<string> = this._onDeleted;
-
-  get(id: string): ComponentModel | undefined {
-    return this.components.get(id);
-  }
-
-  addComponent(component: ComponentModel): void {
-    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: string): void {
-    const component = this.components.get(id);
-    if (component) {
-      this.components.delete(id);
-      component.dispose();
-      this._onDeleted.emit(id);
-    }
-  }
-
-  dispose(): void {
-    for (const component of this.components.values()) {
-      component.dispose();
-    }
-    this.components.clear();
-    this._onCreated.dispose();
-    this._onDeleted.dispose();
-  }
-}