@a2ui/web_core 0.8.0

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

@@ -0,0 +1,39 @@
+import assert from 'node:assert';
+import { describe, it, beforeEach } from 'node:test';
+import { SurfaceModel } from './surface-model.js';
+import { Catalog } from '../catalog/types.js';
+import { ComponentModel } from './component-model.js';
+import { ComponentContext } from '../rendering/component-context.js';
+describe('SurfaceModel', () => {
+    let surface;
+    let catalog;
+    let actions = [];
+    beforeEach(() => {
+        actions = [];
+        catalog = new Catalog('test-catalog', []);
+        surface = new SurfaceModel('surface-1', catalog, {});
+        surface.onAction.subscribe(async (action) => {
+            actions.push(action);
+        });
+    });
+    it('initializes with empty data model', () => {
+        assert.deepStrictEqual(surface.dataModel.get('/'), {});
+    });
+    it('exposes components model', () => {
+        surface.componentsModel.addComponent(new ComponentModel('c1', 'Button', {}));
+        assert.ok(surface.componentsModel.get('c1'));
+    });
+    it('dispatches actions', async () => {
+        await surface.dispatchAction({ type: 'click' });
+        assert.strictEqual(actions.length, 1);
+        assert.strictEqual(actions[0].type, 'click');
+    });
+    it('creates a component context', () => {
+        surface.componentsModel.addComponent(new ComponentModel('root', 'Box', {}));
+        const ctx = new ComponentContext(surface, 'root', '/mydata');
+        assert.ok(ctx);
+        assert.strictEqual(ctx.componentModel.id, 'root');
+        assert.strictEqual(ctx.dataContext.path, '/mydata');
+    });
+});
+//# sourceMappingURL=surface-model.test.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"surface-model.test.js","sourceRoot":"","sources":["../../../../src/v0_9/state/surface-model.test.ts"],"names":[],"mappings":"AAAA,OAAO,MAAM,MAAM,aAAa,CAAC;AACjC,OAAO,EAAQ,QAAQ,EAAE,EAAE,EAAE,UAAU,EAAQ,MAAM,WAAW,CAAC;AACjE,OAAO,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAClD,OAAO,EAAE,OAAO,EAAgB,MAAM,qBAAqB,CAAC;AAC5D,OAAO,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AACtD,OAAO,EAAE,gBAAgB,EAAE,MAAM,mCAAmC,CAAC;AAErE,QAAQ,CAAC,cAAc,EAAE,GAAG,EAAE;IAC5B,IAAI,OAAmC,CAAC;IACxC,IAAI,OAA8B,CAAC;IACnC,IAAI,OAAO,GAAU,EAAE,CAAC;IAExB,UAAU,CAAC,GAAG,EAAE;QACd,OAAO,GAAG,EAAE,CAAC;QACb,OAAO,GAAG,IAAI,OAAO,CAAC,cAAc,EAAE,EAAE,CAAC,CAAC;QAC1C,OAAO,GAAG,IAAI,YAAY,CAAe,WAAW,EAAE,OAAO,EAAE,EAAE,CAAC,CAAC;QACnE,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAC,KAAK,EAAE,MAAM,EAAE,EAAE;YAC1C,OAAO,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;QACvB,CAAC,CAAC,CAAC;IACL,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,mCAAmC,EAAE,GAAG,EAAE;QAC3C,MAAM,CAAC,eAAe,CAAC,OAAO,CAAC,SAAS,CAAC,GAAG,CAAC,GAAG,CAAC,EAAE,EAAE,CAAC,CAAC;IACzD,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,0BAA0B,EAAE,GAAG,EAAE;QAClC,OAAO,CAAC,eAAe,CAAC,YAAY,CAAC,IAAI,cAAc,CAAC,IAAI,EAAE,QAAQ,EAAE,EAAE,CAAC,CAAC,CAAC;QAC7E,MAAM,CAAC,EAAE,CAAC,OAAO,CAAC,eAAe,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC,CAAC;IAC/C,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,oBAAoB,EAAE,KAAK,IAAI,EAAE;QAClC,MAAM,OAAO,CAAC,cAAc,CAAC,EAAE,IAAI,EAAE,OAAO,EAAE,CAAC,CAAC;QAChD,MAAM,CAAC,WAAW,CAAC,OAAO,CAAC,MAAM,EAAE,CAAC,CAAC,CAAC;QACtC,MAAM,CAAC,WAAW,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,IAAI,EAAE,OAAO,CAAC,CAAC;IAC/C,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,6BAA6B,EAAE,GAAG,EAAE;QACrC,OAAO,CAAC,eAAe,CAAC,YAAY,CAAC,IAAI,cAAc,CAAC,MAAM,EAAE,KAAK,EAAE,EAAE,CAAC,CAAC,CAAC;QAC5E,MAAM,GAAG,GAAG,IAAI,gBAAgB,CAAC,OAAO,EAAE,MAAM,EAAE,SAAS,CAAC,CAAC;QAC7D,MAAM,CAAC,EAAE,CAAC,GAAG,CAAC,CAAC;QACf,MAAM,CAAC,WAAW,CAAC,GAAG,CAAC,cAAc,CAAC,EAAE,EAAE,MAAM,CAAC,CAAC;QAClD,MAAM,CAAC,WAAW,CAAC,GAAG,CAAC,WAAW,CAAC,IAAI,EAAE,SAAS,CAAC,CAAC;IACtD,CAAC,CAAC,CAAC;AACL,CAAC,CAAC,CAAC"}

package/dist/src/v0_9/test/test-utils.d.ts

@@ -0,0 +1,8 @@
+import { ComponentContext } from '../rendering/component-context.js';
+import { SurfaceModel } from '../state/surface-model.js';
+import { ComponentApi } from '../catalog/types.js';
+export declare class TestSurfaceModel extends SurfaceModel<ComponentApi> {
+    constructor(actionHandler?: any);
+}
+export declare function createTestContext(properties: any, actionHandler?: any): ComponentContext;
+//# sourceMappingURL=test-utils.d.ts.map

package/dist/src/v0_9/test/test-utils.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"test-utils.d.ts","sourceRoot":"","sources":["../../../../src/v0_9/test/test-utils.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,gBAAgB,EAAE,MAAM,mCAAmC,CAAC;AACrE,OAAO,EAAE,YAAY,EAAE,MAAM,2BAA2B,CAAC;AACzD,OAAO,EAAW,YAAY,EAAE,MAAM,qBAAqB,CAAC;AAG5D,qBAAa,gBAAiB,SAAQ,YAAY,CAAC,YAAY,CAAC;gBAClD,aAAa,GAAE,GAAqB;CAIjD;AAED,wBAAgB,iBAAiB,CAAC,UAAU,EAAE,GAAG,EAAE,aAAa,GAAE,GAAqB,oBAQtF"}

package/dist/src/v0_9/test/test-utils.js

@@ -0,0 +1,18 @@
+import { ComponentContext } from '../rendering/component-context.js';
+import { SurfaceModel } from '../state/surface-model.js';
+import { Catalog } from '../catalog/types.js';
+import { ComponentModel } from '../state/component-model.js';
+export class TestSurfaceModel extends SurfaceModel {
+    constructor(actionHandler = async () => { }) {
+        super('test', new Catalog('test-catalog', []), {});
+        this.onAction.subscribe(actionHandler);
+    }
+}
+export function createTestContext(properties, actionHandler = async () => { }) {
+    const surface = new TestSurfaceModel(actionHandler);
+    const component = new ComponentModel('test-id', 'TestComponent', properties);
+    surface.componentsModel.addComponent(component);
+    const context = new ComponentContext(surface, 'test-id', '/');
+    return context;
+}
+//# sourceMappingURL=test-utils.js.map

package/dist/src/v0_9/test/test-utils.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"test-utils.js","sourceRoot":"","sources":["../../../../src/v0_9/test/test-utils.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,gBAAgB,EAAE,MAAM,mCAAmC,CAAC;AACrE,OAAO,EAAE,YAAY,EAAE,MAAM,2BAA2B,CAAC;AACzD,OAAO,EAAE,OAAO,EAAgB,MAAM,qBAAqB,CAAC;AAC5D,OAAO,EAAE,cAAc,EAAE,MAAM,6BAA6B,CAAC;AAE7D,MAAM,OAAO,gBAAiB,SAAQ,YAA0B;IAC9D,YAAY,gBAAqB,KAAK,IAAI,EAAE,GAAG,CAAC;QAC9C,KAAK,CAAC,MAAM,EAAE,IAAI,OAAO,CAAC,cAAc,EAAE,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC;QACnD,IAAI,CAAC,QAAQ,CAAC,SAAS,CAAC,aAAa,CAAC,CAAC;IACzC,CAAC;CACF;AAED,MAAM,UAAU,iBAAiB,CAAC,UAAe,EAAE,gBAAqB,KAAK,IAAI,EAAE,GAAG,CAAC;IACrF,MAAM,OAAO,GAAG,IAAI,gBAAgB,CAAC,aAAa,CAAC,CAAC;IACpD,MAAM,SAAS,GAAG,IAAI,cAAc,CAAC,SAAS,EAAE,eAAe,EAAE,UAAU,CAAC,CAAC;IAC7E,OAAO,CAAC,eAAe,CAAC,YAAY,CAAC,SAAS,CAAC,CAAC;IAEhD,MAAM,OAAO,GAAG,IAAI,gBAAgB,CAAC,OAAO,EAAE,SAAS,EAAE,GAAG,CAAC,CAAC;IAE9D,OAAO,OAAO,CAAC;AACjB,CAAC"}

package/package.json

@@ -0,0 +1,94 @@
+{
+  "name": "@a2ui/web_core",
+  "version": "0.8.0",
+  "description": "A2UI Core Library",
+  "main": "./dist/src/v0_8/index.js",
+  "types": "./dist/src/v0_8/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/src/v0_8/index.d.ts",
+      "default": "./dist/src/v0_8/index.js"
+    },
+    "./v0_9": {
+      "types": "./dist/src/v0_9/index.d.ts",
+      "default": "./dist/src/v0_9/index.js"
+    },
+    "./types/*": {
+      "types": "./dist/src/v0_8/types/*.d.ts",
+      "default": "./dist/src/v0_8/types/*.js"
+    },
+    "./data/*": {
+      "types": "./dist/src/v0_8/data/*.d.ts",
+      "default": "./dist/src/v0_8/data/*.js"
+    },
+    "./styles/*": {
+      "types": "./dist/src/v0_8/styles/*.d.ts",
+      "default": "./dist/src/v0_8/styles/*.js"
+    },
+    "./schemas/*": {
+      "default": "./dist/src/v0_8/schemas/*"
+    }
+  },
+  "type": "module",
+  "sideEffects": false,
+  "files": [
+    "dist",
+    "src"
+  ],
+  "scripts": {
+    "prepack": "npm run build",
+    "build": "wireit",
+    "build:tsc": "wireit",
+    "test": "wireit"
+  },
+  "wireit": {
+    "copy-spec": {
+      "command": "node scripts/copy-spec.js",
+      "files": [
+        "../../specification/v0_8/json/*.json",
+        "scripts/copy-spec.js"
+      ],
+      "output": [
+        "src/v0_8/schemas/*.json"
+      ]
+    },
+    "build": {
+      "dependencies": [
+        "build:tsc"
+      ]
+    },
+    "build:tsc": {
+      "command": "tsc -b --pretty",
+      "dependencies": [
+        "copy-spec"
+      ],
+      "files": [
+        "src/**/*.ts",
+        "src/**/*.json",
+        "tsconfig.json"
+      ],
+      "output": [
+        "dist/",
+        "!dist/**/*.min.js{,.map}"
+      ],
+      "clean": "if-file-deleted"
+    },
+    "test": {
+      "command": "node --test dist/**/*.test.js",
+      "dependencies": [
+        "build"
+      ]
+    }
+  },
+  "author": "Google",
+  "license": "Apache-2.0",
+  "devDependencies": {
+    "@types/node": "^24.10.1",
+    "typescript": "^5.8.3",
+    "wireit": "^0.15.0-pre.2"
+  },
+  "dependencies": {
+    "zod": "^3.25.76",
+    "zod-to-json-schema": "^3.25.1"
+  }
+}

package/src/v0_8/data/guards.ts

@@ -0,0 +1,236 @@
+/*
+ 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 { BooleanValue, NumberValue, StringValue } from "../types/primitives";
+import {
+  AnyComponentNode,
+  ComponentArrayReference,
+  ResolvedAudioPlayer,
+  ResolvedButton,
+  ResolvedCard,
+  ResolvedCheckbox,
+  ResolvedColumn,
+  ResolvedDateTimeInput,
+  ResolvedDivider,
+  ResolvedIcon,
+  ResolvedImage,
+  ResolvedList,
+  ResolvedModal,
+  ResolvedMultipleChoice,
+  ResolvedRow,
+  ResolvedSlider,
+  ResolvedTabItem,
+  ResolvedTabs,
+  ResolvedText,
+  ResolvedTextField,
+  ResolvedVideo,
+  ValueMap,
+} from "../types/types";
+
+export function isValueMap(value: unknown): value is ValueMap {
+  return isObject(value) && "key" in value;
+}
+
+export function isPath(key: string, value: unknown): value is string {
+  return key === "path" && typeof value === "string";
+}
+
+export function isObject(value: unknown): value is Record<string, unknown> {
+  return typeof value === "object" && value !== null && !Array.isArray(value);
+}
+
+export function isComponentArrayReference(
+  value: unknown
+): value is ComponentArrayReference {
+  if (!isObject(value)) return false;
+  return "explicitList" in value || "template" in value;
+}
+
+function isStringValue(value: unknown): value is StringValue {
+  return (
+    isObject(value) &&
+    ("path" in value ||
+      ("literal" in value && typeof value.literal === "string") ||
+      "literalString" in value)
+  );
+}
+
+function isNumberValue(value: unknown): value is NumberValue {
+  return (
+    isObject(value) &&
+    ("path" in value ||
+      ("literal" in value && typeof value.literal === "number") ||
+      "literalNumber" in value)
+  );
+}
+
+function isBooleanValue(value: unknown): value is BooleanValue {
+  return (
+    isObject(value) &&
+    ("path" in value ||
+      ("literal" in value && typeof value.literal === "boolean") ||
+      "literalBoolean" in value)
+  );
+}
+
+function isAnyComponentNode(value: unknown): value is AnyComponentNode {
+  if (!isObject(value)) return false;
+  const hasBaseKeys = "id" in value && "type" in value && "properties" in value;
+  if (!hasBaseKeys) return false;
+
+  return true;
+}
+
+export function isResolvedAudioPlayer(
+  props: unknown
+): props is ResolvedAudioPlayer {
+  return isObject(props) && "url" in props && isStringValue(props.url);
+}
+
+export function isResolvedButton(props: unknown): props is ResolvedButton {
+  return (
+    isObject(props) &&
+    "child" in props &&
+    isAnyComponentNode(props.child) &&
+    "action" in props
+  );
+}
+
+export function isResolvedCard(props: unknown): props is ResolvedCard {
+  if (!isObject(props)) return false;
+  if (!("child" in props)) {
+    if (!("children" in props)) {
+      return false;
+    } else {
+      return (
+        Array.isArray(props.children) &&
+        props.children.every(isAnyComponentNode)
+      );
+    }
+  }
+
+  return isAnyComponentNode(props.child);
+}
+
+export function isResolvedCheckbox(props: unknown): props is ResolvedCheckbox {
+  return (
+    isObject(props) &&
+    "label" in props &&
+    isStringValue(props.label) &&
+    "value" in props &&
+    isBooleanValue(props.value)
+  );
+}
+
+export function isResolvedColumn(props: unknown): props is ResolvedColumn {
+  return (
+    isObject(props) &&
+    "children" in props &&
+    Array.isArray(props.children) &&
+    props.children.every(isAnyComponentNode)
+  );
+}
+
+export function isResolvedDateTimeInput(
+  props: unknown
+): props is ResolvedDateTimeInput {
+  return isObject(props) && "value" in props && isStringValue(props.value);
+}
+
+export function isResolvedDivider(props: unknown): props is ResolvedDivider {
+  // Dividers can have all optional properties, so just checking if
+  // it's an object is enough.
+  return isObject(props);
+}
+
+export function isResolvedImage(props: unknown): props is ResolvedImage {
+  return isObject(props) && "url" in props && isStringValue(props.url);
+}
+
+export function isResolvedIcon(props: unknown): props is ResolvedIcon {
+  return isObject(props) && "name" in props && isStringValue(props.name);
+}
+
+export function isResolvedList(props: unknown): props is ResolvedList {
+  return (
+    isObject(props) &&
+    "children" in props &&
+    Array.isArray(props.children) &&
+    props.children.every(isAnyComponentNode)
+  );
+}
+
+export function isResolvedModal(props: unknown): props is ResolvedModal {
+  return (
+    isObject(props) &&
+    "entryPointChild" in props &&
+    isAnyComponentNode(props.entryPointChild) &&
+    "contentChild" in props &&
+    isAnyComponentNode(props.contentChild)
+  );
+}
+
+export function isResolvedMultipleChoice(
+  props: unknown
+): props is ResolvedMultipleChoice {
+  return isObject(props) && "selections" in props;
+}
+
+export function isResolvedRow(props: unknown): props is ResolvedRow {
+  return (
+    isObject(props) &&
+    "children" in props &&
+    Array.isArray(props.children) &&
+    props.children.every(isAnyComponentNode)
+  );
+}
+
+export function isResolvedSlider(props: unknown): props is ResolvedSlider {
+  return isObject(props) && "value" in props && isNumberValue(props.value);
+}
+
+function isResolvedTabItem(item: unknown): item is ResolvedTabItem {
+  return (
+    isObject(item) &&
+    "title" in item &&
+    isStringValue(item.title) &&
+    "child" in item &&
+    isAnyComponentNode(item.child)
+  );
+}
+
+export function isResolvedTabs(props: unknown): props is ResolvedTabs {
+  return (
+    isObject(props) &&
+    "tabItems" in props &&
+    Array.isArray(props.tabItems) &&
+    props.tabItems.every(isResolvedTabItem)
+  );
+}
+
+export function isResolvedText(props: unknown): props is ResolvedText {
+  return isObject(props) && "text" in props && isStringValue(props.text);
+}
+
+export function isResolvedTextField(
+  props: unknown
+): props is ResolvedTextField {
+  return isObject(props) && "label" in props && isStringValue(props.label);
+}
+
+export function isResolvedVideo(props: unknown): props is ResolvedVideo {
+  return isObject(props) && "url" in props && isStringValue(props.url);
+}