@a2ui/web_core 0.8.0 → 0.9.0

package/src/v0_9/reactivity/signals.test.js

@@ -0,0 +1,100 @@
+/**
+ * Copyright 2026 Google LLC
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *     http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+import assert from 'node:assert';
+import { describe, it } from 'node:test';
+import { Signal as PSignal, computed as pComputed } from '@preact/signals-core';
+import { signal as aSignal, computed as aComputed, isSignal, } from '@angular/core';
+describe('FrameworkSignal', () => {
+    // Test FrameworkSignal with two sample implemenations that wrap Angular and
+    // Preact signals. Angular and Preact signals are good representitive samples,
+    // because the two common patterns - `()` vs. `.value` - are represented by
+    // Angular and Preact respectively.
+    describe('Angular variation', () => {
+        const AngularSignal = {
+            computed: (fn) => aComputed(fn),
+            isSignal: (val) => isSignal(val),
+            wrap: (val) => aSignal(val),
+            unwrap: (val) => val(),
+            set: (signal, value) => signal.set(value),
+        };
+        it('round trip wraps and unwraps successfully', () => {
+            const val = 'hello';
+            const wrapped = AngularSignal.wrap(val);
+            assert.strictEqual(AngularSignal.unwrap(wrapped), val);
+        });
+        it('handles updates well', () => {
+            const signal = AngularSignal.wrap('first');
+            const computedVal = AngularSignal.computed(() => `prefix ${signal()}`);
+            assert.strictEqual(signal(), 'first');
+            assert.strictEqual(AngularSignal.unwrap(signal), 'first');
+            assert.strictEqual(computedVal(), 'prefix first');
+            assert.strictEqual(AngularSignal.unwrap(computedVal), 'prefix first');
+            AngularSignal.set(signal, 'second');
+            assert.strictEqual(signal(), 'second');
+            assert.strictEqual(AngularSignal.unwrap(signal), 'second');
+            assert.strictEqual(computedVal(), 'prefix second');
+            assert.strictEqual(AngularSignal.unwrap(computedVal), 'prefix second');
+        });
+        describe('.isSignal()', () => {
+            it('validates a signal', () => {
+                const val = 'hello';
+                const wrapped = AngularSignal.wrap(val);
+                assert.ok(AngularSignal.isSignal(wrapped));
+            });
+            it('rejects a non-signal', () => {
+                assert.strictEqual(AngularSignal.isSignal('hello'), false);
+            });
+        });
+    });
+    describe('Preact variation', () => {
+        const PreactSignal = {
+            computed: (fn) => pComputed(fn),
+            isSignal: (val) => val instanceof PSignal,
+            wrap: (val) => new PSignal(val),
+            unwrap: (val) => val.value,
+            set: (signal, value) => (signal.value = value),
+        };
+        it('round trip wraps and unwraps successfully', () => {
+            const val = 'hello';
+            const wrapped = PreactSignal.wrap(val);
+            assert.strictEqual(PreactSignal.unwrap(wrapped), val);
+        });
+        it('handles updates well', () => {
+            const signal = PreactSignal.wrap('first');
+            const computed = PreactSignal.computed(() => `prefix ${signal.value}`);
+            assert.strictEqual(signal.value, 'first');
+            assert.strictEqual(PreactSignal.unwrap(signal), 'first');
+            assert.strictEqual(computed.value, 'prefix first');
+            assert.strictEqual(PreactSignal.unwrap(computed), 'prefix first');
+            PreactSignal.set(signal, 'second');
+            assert.strictEqual(signal.value, 'second');
+            assert.strictEqual(PreactSignal.unwrap(signal), 'second');
+            assert.strictEqual(computed.value, 'prefix second');
+            assert.strictEqual(PreactSignal.unwrap(computed), 'prefix second');
+        });
+        describe('.isSignal()', () => {
+            it('validates a signal', () => {
+                const val = 'hello';
+                const wrapped = PreactSignal.wrap(val);
+                assert.ok(PreactSignal.isSignal(wrapped));
+            });
+            it('rejects a non-signal', () => {
+                assert.strictEqual(PreactSignal.isSignal('hello'), false);
+            });
+        });
+    });
+});
+//# sourceMappingURL=signals.test.js.map

package/src/v0_9/reactivity/signals.test.js.map

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

package/src/v0_9/rendering/component-context.d.ts

@@ -0,0 +1,35 @@
+import { DataContext } from './data-context.js';
+import { ComponentModel } from '../state/component-model.js';
+import type { SurfaceModel } from '../state/surface-model.js';
+import type { SurfaceComponentsModel } from '../state/surface-components-model.js';
+/**
+ * Context provided to components during rendering.
+ * It provides access to the component's model, the data context, and a way to dispatch actions.
+ */
+export declare class ComponentContext {
+    /** The state model for this specific component, providing access to its properties and state. */
+    readonly componentModel: ComponentModel;
+    /**
+     * The data context scoped to this component's position in the visual hierarchy.
+     * Uses the `dataModelBasePath` to resolve relative data paths.
+     */
+    readonly dataContext: DataContext;
+    /** The collection of all component models for the current surface, allowing lookups by ID. */
+    readonly surfaceComponents: SurfaceComponentsModel;
+    /**
+     * Creates a new component context.
+     *
+     * @param surface The surface model the component belongs to.
+     * @param componentId The ID of the component.
+     * @param dataModelBasePath The base path for data model access (default: '/').
+     */
+    constructor(surface: SurfaceModel<any>, componentId: string, dataModelBasePath?: string);
+    private _actionDispatcher;
+    /**
+     * Dispatches an action from the component.
+     *
+     * @param action The action to dispatch.
+     */
+    dispatchAction(action: any): Promise<void>;
+}
+//# sourceMappingURL=component-context.d.ts.map

package/src/v0_9/rendering/component-context.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"component-context.d.ts","sourceRoot":"","sources":["../../../../src/v0_9/rendering/component-context.ts"],"names":[],"mappings":"AAgBA,OAAO,EAAC,WAAW,EAAC,MAAM,mBAAmB,CAAC;AAC9C,OAAO,EAAC,cAAc,EAAC,MAAM,6BAA6B,CAAC;AAC3D,OAAO,KAAK,EAAC,YAAY,EAAC,MAAM,2BAA2B,CAAC;AAC5D,OAAO,KAAK,EAAC,sBAAsB,EAAC,MAAM,sCAAsC,CAAC;AAGjF;;;GAGG;AACH,qBAAa,gBAAgB;IAC3B,iGAAiG;IACjG,QAAQ,CAAC,cAAc,EAAE,cAAc,CAAC;IACxC;;;OAGG;IACH,QAAQ,CAAC,WAAW,EAAE,WAAW,CAAC;IAClC,8FAA8F;IAC9F,QAAQ,CAAC,iBAAiB,EAAE,sBAAsB,CAAC;IAEnD;;;;;;OAMG;gBAED,OAAO,EAAE,YAAY,CAAC,GAAG,CAAC,EAC1B,WAAW,EAAE,MAAM,EACnB,iBAAiB,GAAE,MAAY;IAcjC,OAAO,CAAC,iBAAiB,CAAiC;IAE1D;;;;OAIG;IACH,cAAc,CAAC,MAAM,EAAE,GAAG,GAAG,OAAO,CAAC,IAAI,CAAC;CAG3C"}

package/src/v0_9/rendering/component-context.js

@@ -0,0 +1,49 @@
+/*
+ * 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 { DataContext } from './data-context.js';
+import { A2uiStateError } from '../errors.js';
+/**
+ * Context provided to components during rendering.
+ * It provides access to the component's model, the data context, and a way to dispatch actions.
+ */
+export class ComponentContext {
+    /**
+     * Creates a new component context.
+     *
+     * @param surface The surface model the component belongs to.
+     * @param componentId The ID of the component.
+     * @param dataModelBasePath The base path for data model access (default: '/').
+     */
+    constructor(surface, componentId, dataModelBasePath = '/') {
+        const model = surface.componentsModel.get(componentId);
+        if (!model) {
+            throw new A2uiStateError(`Component not found: ${componentId}`);
+        }
+        this.componentModel = model;
+        this.surfaceComponents = surface.componentsModel;
+        this.dataContext = new DataContext(surface, dataModelBasePath);
+        this._actionDispatcher = action => surface.dispatchAction(action, this.componentModel.id);
+    }
+    /**
+     * Dispatches an action from the component.
+     *
+     * @param action The action to dispatch.
+     */
+    dispatchAction(action) {
+        return this._actionDispatcher(action);
+    }
+}
+//# sourceMappingURL=component-context.js.map

package/src/v0_9/rendering/component-context.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"component-context.js","sourceRoot":"","sources":["../../../../src/v0_9/rendering/component-context.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAEH,OAAO,EAAC,WAAW,EAAC,MAAM,mBAAmB,CAAC;AAI9C,OAAO,EAAC,cAAc,EAAC,MAAM,cAAc,CAAC;AAE5C;;;GAGG;AACH,MAAM,OAAO,gBAAgB;IAW3B;;;;;;OAMG;IACH,YACE,OAA0B,EAC1B,WAAmB,EACnB,oBAA4B,GAAG;QAE/B,MAAM,KAAK,GAAG,OAAO,CAAC,eAAe,CAAC,GAAG,CAAC,WAAW,CAAC,CAAC;QACvD,IAAI,CAAC,KAAK,EAAE,CAAC;YACX,MAAM,IAAI,cAAc,CAAC,wBAAwB,WAAW,EAAE,CAAC,CAAC;QAClE,CAAC;QACD,IAAI,CAAC,cAAc,GAAG,KAAK,CAAC;QAC5B,IAAI,CAAC,iBAAiB,GAAG,OAAO,CAAC,eAAe,CAAC;QAEjD,IAAI,CAAC,WAAW,GAAG,IAAI,WAAW,CAAC,OAAO,EAAE,iBAAiB,CAAC,CAAC;QAC/D,IAAI,CAAC,iBAAiB,GAAG,MAAM,CAAC,EAAE,CAChC,OAAO,CAAC,cAAc,CAAC,MAAM,EAAE,IAAI,CAAC,cAAc,CAAC,EAAE,CAAC,CAAC;IAC3D,CAAC;IAID;;;;OAIG;IACH,cAAc,CAAC,MAAW;QACxB,OAAO,IAAI,CAAC,iBAAiB,CAAC,MAAM,CAAC,CAAC;IACxC,CAAC;CACF"}

package/src/v0_9/rendering/component-context.test.d.ts

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

package/src/v0_9/rendering/component-context.test.d.ts.map

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

package/src/v0_9/rendering/component-context.test.js

@@ -0,0 +1,55 @@
+/*
+ * 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 { describe, it } from 'node:test';
+import * as assert from 'node:assert';
+import { ComponentContext } from './component-context.js';
+import { SurfaceModel } from '../state/surface-model.js';
+import { ComponentModel } from '../state/component-model.js';
+describe('ComponentContext', () => {
+    const mockSurface = new SurfaceModel('surface1', {});
+    const componentId = 'comp1';
+    // Add a component to the surface model for testing
+    const componentModel = new ComponentModel(componentId, 'TestComponent', {});
+    mockSurface.componentsModel.addComponent(componentModel);
+    it('initializes correctly', () => {
+        const context = new ComponentContext(mockSurface, componentId);
+        assert.strictEqual(context.componentModel, componentModel);
+        assert.ok(context.dataContext);
+        assert.strictEqual(context.surfaceComponents, mockSurface.componentsModel);
+    });
+    it('dispatches actions', async () => {
+        const context = new ComponentContext(mockSurface, componentId);
+        let actionDispatched = null;
+        const subscription = mockSurface.onAction.subscribe((action) => {
+            actionDispatched = action;
+        });
+        await context.dispatchAction({ event: { name: 'test', context: { a: 1 } } });
+        assert.strictEqual(actionDispatched.name, 'test');
+        assert.strictEqual(actionDispatched.sourceComponentId, componentId);
+        assert.deepStrictEqual(actionDispatched.context, { a: 1 });
+        subscription.unsubscribe();
+    });
+    it('throws error if component not found', () => {
+        assert.throws(() => {
+            new ComponentContext(mockSurface, 'nonExistentId');
+        }, /Component not found: nonExistentId/);
+    });
+    it('creates data context with correct base path', () => {
+        const context = new ComponentContext(mockSurface, componentId, '/foo/bar');
+        assert.strictEqual(context.dataContext.path, '/foo/bar');
+    });
+});
+//# sourceMappingURL=component-context.test.js.map

package/src/v0_9/rendering/component-context.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"component-context.test.js","sourceRoot":"","sources":["../../../../src/v0_9/rendering/component-context.test.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAEH,OAAO,EAAC,QAAQ,EAAE,EAAE,EAAC,MAAM,WAAW,CAAC;AACvC,OAAO,KAAK,MAAM,MAAM,aAAa,CAAC;AACtC,OAAO,EAAC,gBAAgB,EAAC,MAAM,wBAAwB,CAAC;AACxD,OAAO,EAAC,YAAY,EAAC,MAAM,2BAA2B,CAAC;AACvD,OAAO,EAAC,cAAc,EAAC,MAAM,6BAA6B,CAAC;AAE3D,QAAQ,CAAC,kBAAkB,EAAE,GAAG,EAAE;IAChC,MAAM,WAAW,GAAG,IAAI,YAAY,CAAC,UAAU,EAAE,EAAS,CAAC,CAAC;IAC5D,MAAM,WAAW,GAAG,OAAO,CAAC;IAE5B,mDAAmD;IACnD,MAAM,cAAc,GAAG,IAAI,cAAc,CAAC,WAAW,EAAE,eAAe,EAAE,EAAE,CAAC,CAAC;IAC5E,WAAW,CAAC,eAAe,CAAC,YAAY,CAAC,cAAc,CAAC,CAAC;IAEzD,EAAE,CAAC,uBAAuB,EAAE,GAAG,EAAE;QAC/B,MAAM,OAAO,GAAG,IAAI,gBAAgB,CAAC,WAAW,EAAE,WAAW,CAAC,CAAC;QAC/D,MAAM,CAAC,WAAW,CAAC,OAAO,CAAC,cAAc,EAAE,cAAc,CAAC,CAAC;QAC3D,MAAM,CAAC,EAAE,CAAC,OAAO,CAAC,WAAW,CAAC,CAAC;QAC/B,MAAM,CAAC,WAAW,CAAC,OAAO,CAAC,iBAAiB,EAAE,WAAW,CAAC,eAAe,CAAC,CAAC;IAC7E,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,oBAAoB,EAAE,KAAK,IAAI,EAAE;QAClC,MAAM,OAAO,GAAG,IAAI,gBAAgB,CAAC,WAAW,EAAE,WAAW,CAAC,CAAC;QAC/D,IAAI,gBAAgB,GAAQ,IAAI,CAAC;QAEjC,MAAM,YAAY,GAAG,WAAW,CAAC,QAAQ,CAAC,SAAS,CAAC,CAAC,MAAW,EAAE,EAAE;YAClE,gBAAgB,GAAG,MAAM,CAAC;QAC5B,CAAC,CAAC,CAAC;QAEH,MAAM,OAAO,CAAC,cAAc,CAAC,EAAC,KAAK,EAAE,EAAC,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,EAAC,CAAC,EAAE,CAAC,EAAC,EAAC,EAAC,CAAC,CAAC;QAEvE,MAAM,CAAC,WAAW,CAAC,gBAAgB,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC;QAClD,MAAM,CAAC,WAAW,CAAC,gBAAgB,CAAC,iBAAiB,EAAE,WAAW,CAAC,CAAC;QACpE,MAAM,CAAC,eAAe,CAAC,gBAAgB,CAAC,OAAO,EAAE,EAAC,CAAC,EAAE,CAAC,EAAC,CAAC,CAAC;QACzD,YAAY,CAAC,WAAW,EAAE,CAAC;IAC7B,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,qCAAqC,EAAE,GAAG,EAAE;QAC7C,MAAM,CAAC,MAAM,CAAC,GAAG,EAAE;YACjB,IAAI,gBAAgB,CAAC,WAAW,EAAE,eAAe,CAAC,CAAC;QACrD,CAAC,EAAE,oCAAoC,CAAC,CAAC;IAC3C,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,6CAA6C,EAAE,GAAG,EAAE;QACrD,MAAM,OAAO,GAAG,IAAI,gBAAgB,CAAC,WAAW,EAAE,WAAW,EAAE,UAAU,CAAC,CAAC;QAC3E,MAAM,CAAC,WAAW,CAAC,OAAO,CAAC,WAAW,CAAC,IAAI,EAAE,UAAU,CAAC,CAAC;IAC3D,CAAC,CAAC,CAAC;AACL,CAAC,CAAC,CAAC"}

package/src/v0_9/rendering/data-context.d.ts

@@ -0,0 +1,99 @@
+import { Signal } from '@preact/signals-core';
+import { DataModel, DataSubscription } from '../state/data-model.js';
+import type { DynamicValue, Action } from '../schema/common-types.js';
+import { FunctionInvoker } from '../catalog/function_invoker.js';
+import { SurfaceModel } from '../state/surface-model.js';
+/**
+ * A contextual view of the main DataModel, serving as the unified interface for resolving
+ * DynamicValues (literals, data paths, function calls) within a specific scope.
+ *
+ * Components use `DataContext` instead of interacting with the `DataModel` directly.
+ * It automatically handles resolving relative paths against the component's current scope
+ * and provides tools for evaluating complex, reactive expressions.
+ */
+export declare class DataContext {
+    readonly surface: SurfaceModel<any>;
+    readonly path: string;
+    /** The shared, global DataModel instance for the entire UI surface. */
+    readonly dataModel: DataModel;
+    /** A callback for executing function calls defined in the A2UI component tree. */
+    readonly functionInvoker: FunctionInvoker;
+    /**
+     * Initializes a new DataContext.
+     *
+     * @param surface The surface model this context belongs to.
+     * @param path The absolute path in the DataModel that this context is scoped to (its "current working directory").
+     */
+    constructor(surface: SurfaceModel<any>, path: string);
+    /**
+     * Mutates the underlying DataModel at the specified path.
+     *
+     * This is the primary method for components to push state changes (e.g. user input)
+     * back up to the global model.
+     *
+     * @param path A JSON pointer path. If relative, it is resolved against this context's `path`.
+     * @param value The new value to store in the DataModel.
+     */
+    set(path: string, value: any): void;
+    /**
+     * Synchronously evaluates a `DynamicValue` (a literal, a path binding, or a function call)
+     * into its concrete runtime value.
+     *
+     * **Note:** This method evaluates the value *once* at the current moment in time.
+     * It does not create any reactive subscriptions. If the underlying data changes later,
+     * this result will not automatically update. Use `subscribeDynamicValue` for reactive updates.
+     *
+     * @param value The DynamicValue object from the A2UI JSON payload.
+     * @returns The synchronously resolved value.
+     */
+    resolveDynamicValue<V>(value: DynamicValue): V;
+    /**
+     * Reactively listens to changes in a `DynamicValue`.
+     *
+     * This is the core reactive binding mechanism. Whenever the underlying data changes
+     * (or if a function call's dependencies change), the `onChange` callback will be fired
+     * with the freshly evaluated result.
+     *
+     * @template V The expected type of the resolved value.
+     * @param value The DynamicValue to evaluate and observe.
+     * @param onChange A callback fired whenever the evaluated result changes.
+     * @returns A `DataSubscription` containing the initial synchronously-resolved value, along with an `unsubscribe` method to clean up the listener.
+     */
+    subscribeDynamicValue<V>(value: DynamicValue, onChange: (value: V | undefined) => void): DataSubscription<V>;
+    /**
+     * Returns a Preact Signal representing the reactive dynamic value.
+     *
+     * This method recursively resolves any nested path bindings or function calls into a
+     * single, reactive `Signal`. Any changes to the underlying data or function dependencies
+     * will cause this signal's value to update.
+     *
+     * @param value The DynamicValue to evaluate and observe.
+     * @returns A Preact Signal containing the reactive result of the evaluation.
+     */
+    resolveSignal<V>(value: DynamicValue): Signal<V>;
+    /**
+     * Resolves an action by evaluating its top-level dynamic values.
+     *
+     * For event actions, it resolves each value in the context map.
+     * For function call actions, it evaluates the call.
+     *
+     * This is non-recursive: it only resolves one level deep for the context record,
+     * in accordance with the schema specification that requires values to be single
+     * DynamicValue types and prevents arbitrary nesting.
+     */
+    resolveAction(action: Action): any;
+    private evaluateFunctionReactive;
+    private dispatchExpressionError;
+    /**
+     * Creates a new, child `DataContext` scoped to a deeper path.
+     *
+     * This is used when a component (like a List or a Card) wants to provide a targeted
+     * data scope for its children, so children can use relative paths like `./title`.
+     *
+     * @param relativePath The path relative to the *current* context's path.
+     * @returns A new `DataContext` instance pointing to the resolved absolute path.
+     */
+    nested(relativePath: string): DataContext;
+    private resolvePath;
+}
+//# sourceMappingURL=data-context.d.ts.map

package/src/v0_9/rendering/data-context.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"data-context.d.ts","sourceRoot":"","sources":["../../../../src/v0_9/rendering/data-context.ts"],"names":[],"mappings":"AAgBA,OAAO,EAAmB,MAAM,EAAS,MAAM,sBAAsB,CAAC;AAEtE,OAAO,EAAC,SAAS,EAAE,gBAAgB,EAAC,MAAM,wBAAwB,CAAC;AACnE,OAAO,KAAK,EACV,YAAY,EAGZ,MAAM,EACP,MAAM,2BAA2B,CAAC;AAInC,OAAO,EAAC,eAAe,EAAC,MAAM,gCAAgC,CAAC;AAC/D,OAAO,EAAC,YAAY,EAAC,MAAM,2BAA2B,CAAC;AAEvD;;;;;;;GAOG;AACH,qBAAa,WAAW;IAapB,QAAQ,CAAC,OAAO,EAAE,YAAY,CAAC,GAAG,CAAC;IACnC,QAAQ,CAAC,IAAI,EAAE,MAAM;IAbvB,uEAAuE;IACvE,QAAQ,CAAC,SAAS,EAAE,SAAS,CAAC;IAC9B,kFAAkF;IAClF,QAAQ,CAAC,eAAe,EAAE,eAAe,CAAC;IAE1C;;;;;OAKG;gBAEQ,OAAO,EAAE,YAAY,CAAC,GAAG,CAAC,EAC1B,IAAI,EAAE,MAAM;IAMvB;;;;;;;;OAQG;IACH,GAAG,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,GAAG,GAAG,IAAI;IAKnC;;;;;;;;;;OAUG;IACH,mBAAmB,CAAC,CAAC,EAAE,KAAK,EAAE,YAAY,GAAG,CAAC;IAuC9C;;;;;;;;;;;OAWG;IACH,qBAAqB,CAAC,CAAC,EACrB,KAAK,EAAE,YAAY,EACnB,QAAQ,EAAE,CAAC,KAAK,EAAE,CAAC,GAAG,SAAS,KAAK,IAAI,GACvC,gBAAgB,CAAC,CAAC,CAAC;IA4BtB;;;;;;;;;OASG;IACH,aAAa,CAAC,CAAC,EAAE,KAAK,EAAE,YAAY,GAAG,MAAM,CAAC,CAAC,CAAC;IA8FhD;;;;;;;;;OASG;IACH,aAAa,CAAC,MAAM,EAAE,MAAM,GAAG,GAAG;IAqBlC,OAAO,CAAC,wBAAwB;IAahC,OAAO,CAAC,uBAAuB;IA+B/B;;;;;;;;OAQG;IACH,MAAM,CAAC,YAAY,EAAE,MAAM,GAAG,WAAW;IAKzC,OAAO,CAAC,WAAW;CAgBpB"}