@soederpop/luca 0.1.2 → 0.2.1

package/dist/servers/socket.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"socket.d.ts","sourceRoot":"","sources":["../../src/servers/socket.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAA;AAEvB,OAAO,EAAE,KAAK,YAAY,EAAE,MAAM,EAAE,KAAK,WAAW,EAAE,MAAM,cAAc,CAAC;AAC3E,OAAO,EAAE,eAAe,IAAI,UAAU,EAAE,MAAM,IAAI,CAAA;AAClD,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,yBAAyB,CAAA;AAE7D,OAAO,QAAQ,WAAW,CAAC;IACzB,UAAU,gBAAgB;QACxB,SAAS,EAAE,OAAO,eAAe,CAAA;KAClC;CACF;AAED,eAAO,MAAM,yBAAyB;;;;;;iBAEpC,CAAA;AACF,MAAM,MAAM,mBAAmB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,yBAAyB,CAAC,CAAA;AAE3E,eAAO,MAAM,wBAAwB;;;;iBAGC,CAAA;AAEtC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAkCG;AACH,qBAAa,eAAe,CAAC,CAAC,SAAS,WAAW,GAAG,WAAW,EAAE,CAAC,SAAS,mBAAmB,GAAG,mBAAmB,CAAE,SAAQ,MAAM,CAAC,CAAC,EAAC,CAAC,CAAC;IACtI,OAAgB,QAAQ,EAAG,mBAAmB,CAAS;IACvD,OAAgB,WAAW;;;;;sBAAoB;IAC/C,OAAgB,aAAa;;;;;;sBAA4B;IACzD,OAAgB,YAAY;;;;sBAA2B;IAIvD,IAAI,CAAC,EAAE,UAAU,CAAA;IAEjB,IAAI,GAAG,IAAI,UAAU,CAQpB;IAED,WAAW,EAAG,GAAG,CAAC,GAAG,CAAC,CAAY;IAClC,QAAQ,mCAAoC;IAEtC,SAAS,CAAC,OAAO,EAAE,GAAG,GAAG,OAAO,CAAC,IAAI,CAAC;IAQtC,IAAI,CAAC,EAAE,EAAE,GAAG,EAAE,OAAO,EAAE,GAAG,GAAG,OAAO,CAAC,IAAI,CAAC;IAKhD;;;;;;;;;;;;;;;;;;OAkBG;IACG,GAAG,CAAC,CAAC,GAAG,GAAG,EAAE,EAAE,EAAE,GAAG,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,GAAG,EAAE,OAAO,SAAQ,GAAG,OAAO,CAAC,CAAC,CAAC;IAclF,8GAA8G;IAC9G,YAAY,CAAC,OAAO,EAAE,GAAG,GAAG,OAAO;IAiBnC,+DAA+D;IAC/D,iBAAiB,CAAC,MAAM,EAAE,MAAM;IAQhC;;;;;;OAMG;IACY,KAAK,CAAC,OAAO,CAAC,EAAE,YAAY,GAAG,OAAO,CAAC,IAAI,CAAC;IAmD5C,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC;IAwCpC,yGAAyG;IACzG,IAAa,IAAI,IAAI,MAAM,CAE1B;CACJ;AAED,eAAe,eAAe,CAAA"}

package/dist/state.d.ts

@@ -0,0 +1,24 @@
+export type StateChangeType = 'add' | 'update' | 'delete';
+export type StateChangeCallback<K extends keyof any, V> = (changeType: StateChangeType, key: K, value?: V) => void;
+export type SetStateValue<T extends object> = Partial<T> | ((current: T, state: State<T>) => Partial<T>);
+export declare class State<T extends object = any> {
+    private state;
+    private observers;
+    private _version;
+    constructor(options?: {
+        initialState: Partial<T>;
+    });
+    get version(): number;
+    observe(callback: StateChangeCallback<keyof T, T[keyof T]>): () => void;
+    keys(): string[];
+    get<K extends keyof T>(key: K): T[K] | undefined;
+    set<K extends keyof T>(key: K, value: T[K]): this;
+    delete<K extends keyof T>(key: K): this;
+    has<K extends keyof T>(key: K): boolean;
+    get current(): T;
+    clear(): void;
+    entries(): [keyof T, T[keyof T]][];
+    values(): T[keyof T][];
+    setState(value: SetStateValue<T>): void;
+}
+//# sourceMappingURL=state.d.ts.map

package/dist/state.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"state.d.ts","sourceRoot":"","sources":["../src/state.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,eAAe,GAAG,KAAK,GAAG,QAAQ,GAAG,QAAQ,CAAC;AAC1D,MAAM,MAAM,mBAAmB,CAAC,CAAC,SAAS,MAAM,GAAG,EAAE,CAAC,IAAI,CAAC,UAAU,EAAE,eAAe,EAAE,GAAG,EAAE,CAAC,EAAE,KAAK,CAAC,EAAE,CAAC,KAAK,IAAI,CAAC;AACnH,MAAM,MAAM,aAAa,CAAC,CAAC,SAAS,MAAM,IAAI,OAAO,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,OAAO,EAAE,CAAC,EAAE,KAAK,EAAE,KAAK,CAAC,CAAC,CAAC,KAAK,OAAO,CAAC,CAAC,CAAC,CAAC,CAAC;AAEzG,qBAAa,KAAK,CAAC,CAAC,SAAS,MAAM,GAAG,GAAG;IACrC,OAAO,CAAC,KAAK,CAAa;IAC1B,OAAO,CAAC,SAAS,CAA6C;IAC9D,OAAO,CAAC,QAAQ,CAAI;gBAER,OAAO,CAAC,EAAE;QAAE,YAAY,EAAE,OAAO,CAAC,CAAC,CAAC,CAAA;KAAC;IAWjD,IAAI,OAAO,WAEV;IAED,OAAO,CAAC,QAAQ,EAAE,mBAAmB,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,GAAG,MAAM,IAAI;IAWvE,IAAI,IAAK,MAAM,EAAE;IAIjB,GAAG,CAAC,CAAC,SAAS,MAAM,CAAC,EAAE,GAAG,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,SAAS;IAIhD,GAAG,CAAC,CAAC,SAAS,MAAM,CAAC,EAAE,GAAG,EAAE,CAAC,EAAE,KAAK,EAAE,CAAC,CAAC,CAAC,CAAC,GAAG,IAAI;IAYjD,MAAM,CAAC,CAAC,SAAS,MAAM,CAAC,EAAE,GAAG,EAAE,CAAC,GAAG,IAAI;IAWvC,GAAG,CAAC,CAAC,SAAS,MAAM,CAAC,EAAE,GAAG,EAAE,CAAC,GAAG,OAAO;IAIvC,IAAI,OAAO,IAAI,CAAC,CAEf;IAED,KAAK,IAAI,IAAI;IASb,OAAO,IAAK,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE;IAInC,MAAM,IAAK,CAAC,CAAC,MAAM,CAAC,CAAC,EAAE;IAIvB,QAAQ,CAAC,KAAK,EAAE,aAAa,CAAC,CAAC,CAAC,GAAG,IAAI;CAS1C"}

package/dist/web/clients/socket.d.ts

@@ -0,0 +1,37 @@
+import Websocket from 'isomorphic-ws';
+import { WebSocketClient, type WebSocketClientState, type WebSocketClientOptions } from '../../clients/websocket';
+/**
+ * Web-specific WebSocket client implementation using isomorphic-ws.
+ * Extends the base WebSocketClient with platform-specific transport and
+ * an envelope format that wraps sent data with a unique ID. Inherits
+ * ask/reply semantics from the base WebSocketClient — protocol messages
+ * (those with `requestId` or `replyTo`) bypass the envelope wrapper to
+ * maintain compatibility with the Luca WebSocket server's ask/reply flow.
+ */
+export declare class SocketClient<T extends WebSocketClientState = WebSocketClientState, K extends WebSocketClientOptions = WebSocketClientOptions> extends WebSocketClient<T, K> {
+    ws: Websocket | WebSocket;
+    static shortcut: "clients.websocket";
+    static eventsSchema: import("zod").ZodObject<{
+        stateChange: import("zod").ZodTuple<[import("zod").ZodAny], null>;
+        failure: import("zod").ZodTuple<[import("zod").ZodAny], null>;
+        message: import("zod").ZodTuple<[import("zod").ZodAny], null>;
+        open: import("zod").ZodTuple<[], null>;
+        close: import("zod").ZodTuple<[import("zod").ZodOptional<import("zod").ZodNumber>, import("zod").ZodOptional<import("zod").ZodString>], null>;
+        error: import("zod").ZodTuple<[import("zod").ZodAny], null>;
+        reconnecting: import("zod").ZodTuple<[import("zod").ZodNumber], null>;
+    }, import("zod/v4/core").$strip>;
+    /**
+     * Send data over the WebSocket with an ID envelope.
+     * Wraps the payload in { id, data } before JSON serialization.
+     * Messages with a `requestId` or `replyTo` are sent as-is to
+     * preserve the ask/reply protocol.
+     */
+    send(data: any): Promise<void>;
+    /**
+     * Establish a WebSocket connection using isomorphic-ws.
+     * Bridges raw WebSocket events to the Helper event bus and tracks connection state.
+     */
+    connect(): Promise<this>;
+}
+export default SocketClient;
+//# sourceMappingURL=socket.d.ts.map

package/dist/web/clients/socket.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"socket.d.ts","sourceRoot":"","sources":["../../../src/web/clients/socket.ts"],"names":[],"mappings":"AAAA,OAAO,SAAS,MAAM,eAAe,CAAA;AAErC,OAAO,EAAE,eAAe,EAAE,KAAK,oBAAoB,EAAE,KAAK,sBAAsB,EAAE,MAAM,yBAAyB,CAAA;AAGjH;;;;;;;GAOG;AACH,qBAAa,YAAY,CAAC,CAAC,SAAS,oBAAoB,GAAG,oBAAoB,EAAE,CAAC,SAAS,sBAAsB,GAAG,sBAAsB,CAAE,SAAQ,eAAe,CAAC,CAAC,EAAC,CAAC,CAAC;IAE9J,EAAE,EAAE,SAAS,GAAG,SAAS,CAAA;IAEjC,OAAgB,QAAQ,EAAG,mBAAmB,CAAS;IACvD,OAAgB,YAAY;;;;;;;;qCAA8B;IAI1D;;;;;OAKG;IACY,IAAI,CAAC,IAAI,EAAE,GAAG;IAoB7B;;;OAGG;IACY,OAAO;CA4CvB;AAED,eAAe,YAAY,CAAA"}

package/dist/web/container.d.ts

@@ -0,0 +1,55 @@
+export * from '../container.js';
+import { Container } from '../container.js';
+import { Client } from '../client.js';
+import { RestClient } from '../clients/rest.js';
+import { SocketClient } from './clients/socket.js';
+import type { AvailableFeatures } from '../feature.js';
+import type { ContainerState } from '../container.js';
+import type { ClientsInterface } from '../client.js';
+import type { AssetLoader } from './features/asset-loader.js';
+import type { VoiceRecognition } from './features/voice-recognition.js';
+import type { Speech } from './features/speech.js';
+import type { Network } from './features/network.js';
+import type { WebVault } from './features/vault.js';
+import type { VM } from './features/vm.js';
+import type { Esbuild } from './features/esbuild.js';
+import type { Helpers } from './features/helpers.js';
+import type { ContainerLink } from './features/container-link.js';
+export { Client, RestClient, SocketClient };
+export interface WebFeatures extends AvailableFeatures {
+    assetLoader: typeof AssetLoader;
+    voice: typeof VoiceRecognition;
+    speech: typeof Speech;
+    vault: typeof WebVault;
+    vm: typeof VM;
+    esbuild: typeof Esbuild;
+    helpers: typeof Helpers;
+    containerLink: typeof ContainerLink;
+}
+export interface WebContainer extends ClientsInterface {
+    assetLoader?: AssetLoader;
+    voice?: VoiceRecognition;
+    speech?: Speech;
+    network?: Network;
+    vault?: WebVault;
+    helpers?: Helpers;
+    containerLink?: ContainerLink;
+}
+export interface WebContainerState extends ContainerState {
+}
+/**
+ * Browser-specific container that extends the base Container with web client support
+ * and browser-specific features like speech, voice recognition, and asset loading.
+ */
+export declare class WebContainer<Features extends WebFeatures = WebFeatures, K extends WebContainerState = WebContainerState> extends Container<Features, K> {
+    /** Returns the base Client class for creating custom clients. */
+    get Client(): typeof Client;
+    /** Returns the SocketClient class for WebSocket connections. */
+    get SocketClient(): typeof SocketClient;
+    /** Returns the RestClient class for HTTP REST API connections. */
+    get RestClient(): typeof RestClient;
+    useHelpers: any[];
+    constructor(options?: any);
+}
+export declare const helperCache: Map<any, any>;
+//# sourceMappingURL=container.d.ts.map

package/dist/web/container.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"container.d.ts","sourceRoot":"","sources":["../../src/web/container.ts"],"names":[],"mappings":"AAAA,cAAc,iBAAiB,CAAA;AAC/B,OAAO,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAA;AAC3C,OAAO,EAAE,MAAM,EAAE,MAAM,cAAc,CAAA;AACrC,OAAO,EAAE,UAAU,EAAE,MAAM,oBAAoB,CAAA;AAC/C,OAAO,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAA;AAClD,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,eAAe,CAAA;AACtD,OAAO,KAAK,EAAE,cAAc,EAAiB,MAAM,iBAAiB,CAAA;AACpE,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,cAAc,CAAA;AACpD,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,4BAA4B,CAAA;AAC7D,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,iCAAiC,CAAA;AACvE,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,sBAAsB,CAAA;AAClD,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,uBAAuB,CAAA;AACpD,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,qBAAqB,CAAA;AACnD,OAAO,KAAK,EAAE,EAAE,EAAE,MAAM,kBAAkB,CAAA;AAC1C,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,uBAAuB,CAAA;AACpD,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,uBAAuB,CAAA;AACpD,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,8BAA8B,CAAA;AAIjE,OAAO,EAAE,MAAM,EAAE,UAAU,EAAE,YAAY,EAAE,CAAA;AAE3C,MAAM,WAAW,WAAY,SAAQ,iBAAiB;IACpD,WAAW,EAAE,OAAO,WAAW,CAAA;IAC/B,KAAK,EAAE,OAAO,gBAAgB,CAAA;IAC9B,MAAM,EAAE,OAAO,MAAM,CAAA;IACrB,KAAK,EAAE,OAAO,QAAQ,CAAA;IACtB,EAAE,EAAE,OAAO,EAAE,CAAC;IACd,OAAO,EAAE,OAAO,OAAO,CAAA;IACvB,OAAO,EAAE,OAAO,OAAO,CAAA;IACvB,aAAa,EAAE,OAAO,aAAa,CAAA;CACpC;AAED,MAAM,WAAW,YAAa,SAAQ,gBAAgB;IACpD,WAAW,CAAC,EAAE,WAAW,CAAA;IACzB,KAAK,CAAC,EAAE,gBAAgB,CAAA;IACxB,MAAM,CAAC,EAAE,MAAM,CAAA;IACf,OAAO,CAAC,EAAE,OAAO,CAAA;IACjB,KAAK,CAAC,EAAE,QAAQ,CAAA;IAChB,OAAO,CAAC,EAAE,OAAO,CAAA;IACjB,aAAa,CAAC,EAAE,aAAa,CAAA;CAC9B;AAED,MAAM,WAAW,iBAAkB,SAAQ,cAAc;CAAI;AAE7D;;;GAGG;AACH,qBAAa,YAAY,CAAC,QAAQ,SAAS,WAAW,GAAG,WAAW,EAAE,CAAC,SAAS,iBAAiB,GAAG,iBAAiB,CAAE,SAAQ,SAAS,CAAC,QAAQ,EAAE,CAAC,CAAC;IACnJ,iEAAiE;IACjE,IAAI,MAAM,kBAET;IAED,gEAAgE;IAChE,IAAI,YAAY,wBAEf;IAED,kEAAkE;IAClE,IAAI,UAAU,sBAEb;IAED,UAAU,EAAE,GAAG,EAAE,CAA2B;gBAEhC,OAAO,GAAE,GAAQ;CAK9B;AAED,eAAO,MAAM,WAAW,eAAY,CAAA"}

package/dist/web/extension.d.ts

@@ -0,0 +1,4 @@
+import type { Container } from '../container';
+import { type ClientsInterface } from '../client.js';
+export declare function attach<K extends Container & ClientsInterface>(container: K, options?: any): Container & ClientsInterface;
+//# sourceMappingURL=extension.d.ts.map

package/dist/web/extension.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"extension.d.ts","sourceRoot":"","sources":["../../src/web/extension.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,cAAc,CAAA;AAE7C,OAAO,EAAU,KAAK,gBAAgB,EAAE,MAAM,cAAc,CAAA;AAY5D,wBAAgB,MAAM,CAAC,CAAC,SAAS,SAAS,GAAG,gBAAgB,EAAE,SAAS,EAAE,CAAC,EAAE,OAAO,CAAC,EAAE,GAAG,GAAI,SAAS,GAAG,gBAAgB,CAezH"}

package/dist/web/feature.d.ts

@@ -0,0 +1,8 @@
+import type { WebContainer } from './container.js';
+import { type FeatureOptions, type FeatureState, type AvailableFeatures, features, Feature as UniversalFeature } from '../feature.js';
+export { features };
+export type { AvailableFeatures, FeatureState, FeatureOptions };
+export declare class Feature<T extends FeatureState = FeatureState, K extends FeatureOptions = FeatureOptions> extends UniversalFeature<T, K> {
+    get container(): WebContainer;
+}
+//# sourceMappingURL=feature.d.ts.map

package/dist/web/feature.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"feature.d.ts","sourceRoot":"","sources":["../../src/web/feature.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAA;AAClD,OAAO,EAAE,KAAK,cAAc,EAAE,KAAK,YAAY,EAAE,KAAK,iBAAiB,EAAE,QAAQ,EAAE,OAAO,IAAI,gBAAgB,EAAE,MAAM,eAAe,CAAA;AAErI,OAAO,EAAE,QAAQ,EAAE,CAAA;AAEnB,YAAY,EAAE,iBAAiB,EAAE,YAAY,EAAE,cAAc,EAAE,CAAA;AAE/D,qBAAa,OAAO,CAAC,CAAC,SAAS,YAAY,GAAG,YAAY,EAAE,CAAC,SAAS,cAAc,GAAG,cAAc,CAAE,SAAQ,gBAAgB,CAAC,CAAC,EAAE,CAAC,CAAC;IACjI,IAAa,SAAS,IAAK,YAAY,CAEtC;CACJ"}

package/dist/web/features/asset-loader.d.ts

@@ -0,0 +1,35 @@
+import { Feature } from "../feature.js";
+/**
+ * Injects scripts and stylesheets into the page at runtime.
+ *
+ * Provides helpers for loading external libraries from unpkg.com,
+ * injecting arbitrary script/link tags, and managing load state.
+ * Used by other web features (e.g. Esbuild) to pull in dependencies on demand.
+ *
+ * @extends Feature
+ *
+ * @example
+ * ```typescript
+ * const loader = container.feature('assetLoader')
+ * await loader.loadScript('https://unpkg.com/lodash')
+ * await AssetLoader.loadStylesheet('https://unpkg.com/normalize.css')
+ * ```
+ */
+export declare class AssetLoader extends Feature {
+    static stateSchema: import("zod").ZodObject<{
+        enabled: import("zod").ZodDefault<import("zod").ZodBoolean>;
+    }, import("zod/v4/core").$loose>;
+    static optionsSchema: import("zod").ZodObject<{
+        name: import("zod").ZodOptional<import("zod").ZodString>;
+        _cacheKey: import("zod").ZodOptional<import("zod").ZodString>;
+        cached: import("zod").ZodOptional<import("zod").ZodBoolean>;
+        enable: import("zod").ZodOptional<import("zod").ZodBoolean>;
+    }, import("zod/v4/core").$strip>;
+    static shortcut: "features.assetLoader";
+    static loadStylesheet(href: string): Promise<unknown>;
+    removeStylesheet(href: string): void;
+    loadScript(url: string): Promise<void>;
+    unpkg(packageName: string, globalName: string): Promise<any>;
+}
+export default AssetLoader;
+//# sourceMappingURL=asset-loader.d.ts.map

package/dist/web/features/asset-loader.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"asset-loader.d.ts","sourceRoot":"","sources":["../../../src/web/features/asset-loader.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,OAAO,EAAE,MAAM,eAAe,CAAC;AAExC;;;;;;;;;;;;;;;GAeG;AACH,qBAAa,WAAY,SAAQ,OAAO;IACtC,OAAgB,WAAW;;qCAAqB;IAChD,OAAgB,aAAa;;;;;qCAAuB;IACpD,OAAgB,QAAQ,EAAG,sBAAsB,CAAS;IAI1D,MAAM,CAAC,cAAc,CAAC,IAAI,EAAE,MAAM;IAYlC,gBAAgB,CAAC,IAAI,EAAC,MAAM;IAQtB,UAAU,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAkBtC,KAAK,CAAC,WAAW,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,GAAG,CAAC;CAKnE;AAED,eAAe,WAAW,CAAC"}

package/dist/web/features/container-link.d.ts

@@ -0,0 +1,167 @@
+import { z } from 'zod';
+import { Feature } from '../feature.js';
+export declare const MessageTypes: {
+    readonly register: "register";
+    readonly registered: "registered";
+    readonly eval: "eval";
+    readonly evalResult: "evalResult";
+    readonly event: "event";
+    readonly ping: "ping";
+    readonly pong: "pong";
+    readonly disconnect: "disconnect";
+    readonly error: "error";
+};
+export type MessageType = typeof MessageTypes[keyof typeof MessageTypes];
+export interface LinkMessage<T = any> {
+    type: MessageType;
+    id: string;
+    timestamp: number;
+    token?: string;
+    data?: T;
+}
+export interface RegisterData {
+    uuid: string;
+    url?: string;
+    capabilities?: string[];
+    meta?: Record<string, any>;
+}
+export interface RegisteredData {
+    token: string;
+    hostId: string;
+}
+export interface EvalData {
+    code: string;
+    context?: Record<string, any>;
+    requestId: string;
+    timeout?: number;
+}
+export interface EvalResultData {
+    requestId: string;
+    result?: any;
+    error?: string;
+}
+export interface EventData {
+    eventName: string;
+    data?: any;
+}
+export declare const ContainerLinkStateSchema: z.ZodObject<{
+    enabled: z.ZodDefault<z.ZodBoolean>;
+    connected: z.ZodDefault<z.ZodBoolean>;
+    token: z.ZodOptional<z.ZodString>;
+    hostId: z.ZodOptional<z.ZodString>;
+    reconnectAttempts: z.ZodDefault<z.ZodNumber>;
+}, z.core.$loose>;
+export type ContainerLinkState = z.infer<typeof ContainerLinkStateSchema>;
+export declare const ContainerLinkOptionsSchema: z.ZodObject<{
+    name: z.ZodOptional<z.ZodString>;
+    _cacheKey: z.ZodOptional<z.ZodString>;
+    cached: z.ZodOptional<z.ZodBoolean>;
+    enable: z.ZodOptional<z.ZodBoolean>;
+    hostUrl: z.ZodOptional<z.ZodString>;
+    meta: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodAny>>;
+    capabilities: z.ZodOptional<z.ZodArray<z.ZodString>>;
+    reconnect: z.ZodDefault<z.ZodBoolean>;
+    reconnectInterval: z.ZodDefault<z.ZodNumber>;
+    maxReconnectAttempts: z.ZodDefault<z.ZodNumber>;
+}, z.core.$strip>;
+export type ContainerLinkOptions = z.infer<typeof ContainerLinkOptionsSchema>;
+export declare const ContainerLinkEventsSchema: z.ZodObject<{
+    stateChange: z.ZodTuple<[z.ZodAny], null>;
+    enabled: z.ZodTuple<[], null>;
+    connected: z.ZodTuple<[z.ZodString], null>;
+    disconnected: z.ZodTuple<[z.ZodOptional<z.ZodString>], null>;
+    evalRequest: z.ZodTuple<[z.ZodString, z.ZodString], null>;
+    reconnecting: z.ZodTuple<[z.ZodNumber], null>;
+}, z.core.$strip>;
+/**
+ * ContainerLink (Web-side) — WebSocket client that connects to a node host.
+ *
+ * Connects to a ContainerLink host over WebSocket. The host can evaluate code
+ * in this container, and the web side can emit structured events to the host.
+ * The web side can NEVER eval code in the host — trust is strictly one-way.
+ *
+ * @example
+ * ```typescript
+ * const link = container.feature('containerLink', {
+ *   enable: true,
+ *   hostUrl: 'ws://localhost:8089',
+ * })
+ * await link.connect()
+ *
+ * // Send events to the host
+ * link.emitToHost('click', { x: 100, y: 200 })
+ *
+ * // Listen for eval requests before they execute
+ * link.on('evalRequest', (code, requestId) => {
+ *   console.log('Host is evaluating:', code)
+ * })
+ * ```
+ */
+export declare class ContainerLink extends Feature<ContainerLinkState, ContainerLinkOptions> {
+    static shortcut: "features.containerLink";
+    static stateSchema: z.ZodObject<{
+        enabled: z.ZodDefault<z.ZodBoolean>;
+        connected: z.ZodDefault<z.ZodBoolean>;
+        token: z.ZodOptional<z.ZodString>;
+        hostId: z.ZodOptional<z.ZodString>;
+        reconnectAttempts: z.ZodDefault<z.ZodNumber>;
+    }, z.core.$loose>;
+    static optionsSchema: z.ZodObject<{
+        name: z.ZodOptional<z.ZodString>;
+        _cacheKey: z.ZodOptional<z.ZodString>;
+        cached: z.ZodOptional<z.ZodBoolean>;
+        enable: z.ZodOptional<z.ZodBoolean>;
+        hostUrl: z.ZodOptional<z.ZodString>;
+        meta: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodAny>>;
+        capabilities: z.ZodOptional<z.ZodArray<z.ZodString>>;
+        reconnect: z.ZodDefault<z.ZodBoolean>;
+        reconnectInterval: z.ZodDefault<z.ZodNumber>;
+        maxReconnectAttempts: z.ZodDefault<z.ZodNumber>;
+    }, z.core.$strip>;
+    static eventsSchema: z.ZodObject<{
+        stateChange: z.ZodTuple<[z.ZodAny], null>;
+        enabled: z.ZodTuple<[], null>;
+        connected: z.ZodTuple<[z.ZodString], null>;
+        disconnected: z.ZodTuple<[z.ZodOptional<z.ZodString>], null>;
+        evalRequest: z.ZodTuple<[z.ZodString, z.ZodString], null>;
+        reconnecting: z.ZodTuple<[z.ZodNumber], null>;
+    }, z.core.$strip>;
+    private _ws?;
+    private _reconnectTimer?;
+    get initialState(): ContainerLinkState;
+    /** Whether currently connected to the host. */
+    get isConnected(): boolean;
+    /** The auth token received from the host. */
+    get token(): string | undefined;
+    /** The host container's UUID. */
+    get hostId(): string | undefined;
+    /**
+     * Connect to the host WebSocket server and perform registration.
+     *
+     * @param hostUrl - Override the configured host URL
+     * @returns Promise that resolves when registered
+     */
+    connect(hostUrl?: string): Promise<this>;
+    /**
+     * Disconnect from the host.
+     *
+     * @param reason - Optional reason string
+     */
+    disconnect(reason?: string): void;
+    /**
+     * Send a structured event to the host container.
+     *
+     * @param eventName - Name of the event
+     * @param data - Optional event data
+     */
+    emitToHost(eventName: string, data?: any): void;
+    private handleMessage;
+    private handleEval;
+    private respondToPing;
+    private maybeReconnect;
+    /** Create a link protocol message with a unique ID. */
+    private createMessage;
+    private clearReconnectTimer;
+}
+export default ContainerLink;
+//# sourceMappingURL=container-link.d.ts.map

package/dist/web/features/container-link.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"container-link.d.ts","sourceRoot":"","sources":["../../../src/web/features/container-link.ts"],"names":[],"mappings":"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"}

package/dist/web/features/esbuild.d.ts

@@ -0,0 +1,51 @@
+import { z } from 'zod';
+import { Feature, type FeatureState } from "../feature.js";
+import type * as esbuild from 'esbuild-wasm';
+export declare const EsbuildWebOptionsSchema: z.ZodObject<{
+    name: z.ZodOptional<z.ZodString>;
+    _cacheKey: z.ZodOptional<z.ZodString>;
+    cached: z.ZodOptional<z.ZodBoolean>;
+    enable: z.ZodOptional<z.ZodBoolean>;
+    transformOptions: z.ZodOptional<z.ZodAny>;
+    tsconfig: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>;
+export type EsbuildWebOptions = z.infer<typeof EsbuildWebOptionsSchema>;
+/**
+ * Browser-side TypeScript/ESM compilation feature using esbuild-wasm.
+ *
+ * Loads esbuild's WebAssembly build via the AssetLoader, then provides
+ * `compile()` and `transform()` methods that work entirely in the browser.
+ * Useful for live playgrounds, in-browser REPLs, and client-side bundling.
+ *
+ * @extends Feature
+ *
+ * @example
+ * ```typescript
+ * const esbuild = container.feature('esbuild')
+ * await esbuild.start()
+ * const result = await esbuild.compile('const x: number = 1')
+ * console.log(result.code)
+ * ```
+ */
+export declare class Esbuild extends Feature<FeatureState, EsbuildWebOptions> {
+    static stateSchema: z.ZodObject<{
+        enabled: z.ZodDefault<z.ZodBoolean>;
+    }, z.core.$loose>;
+    static optionsSchema: z.ZodObject<{
+        name: z.ZodOptional<z.ZodString>;
+        _cacheKey: z.ZodOptional<z.ZodString>;
+        cached: z.ZodOptional<z.ZodBoolean>;
+        enable: z.ZodOptional<z.ZodBoolean>;
+        transformOptions: z.ZodOptional<z.ZodAny>;
+        tsconfig: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>;
+    static shortcut: "features.esbuild";
+    /** Returns the assetLoader feature for loading external libraries from unpkg. */
+    get assetLoader(): import("./asset-loader.js").AssetLoader;
+    compiler: typeof esbuild;
+    compile(code: string, options?: esbuild.TransformOptions): Promise<any>;
+    clearCache(): this;
+    start(): Promise<this>;
+}
+export default Esbuild;
+//# sourceMappingURL=esbuild.d.ts.map

package/dist/web/features/esbuild.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"esbuild.d.ts","sourceRoot":"","sources":["../../../src/web/features/esbuild.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAA;AAEvB,OAAO,EAAE,OAAO,EAAE,KAAK,YAAY,EAAE,MAAM,eAAe,CAAC;AAC3D,OAAO,KAAK,KAAK,OAAO,MAAM,cAAc,CAAC;AAE7C,eAAO,MAAM,uBAAuB;;;;;;;iBAGlC,CAAA;AAEF,MAAM,MAAM,iBAAiB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,uBAAuB,CAAC,CAAA;AAEvE;;;;;;;;;;;;;;;;GAgBG;AACH,qBAAa,OAAQ,SAAQ,OAAO,CAAC,YAAY,EAAE,iBAAiB,CAAC;IACnE,OAAgB,WAAW;;sBAAqB;IAChD,OAAgB,aAAa;;;;;;;sBAA0B;IACvD,OAAgB,QAAQ,EAAG,kBAAkB,CAAS;IAItD,iFAAiF;IACjF,IAAI,WAAW,4CAEd;IAED,QAAQ,EAAG,OAAO,OAAO,CAAA;IAEnB,OAAO,CAAC,IAAI,EAAC,MAAM,EAAE,OAAO,CAAC,EAAE,OAAO,CAAC,gBAAgB;IAyB7D,UAAU;IAKJ,KAAK;CAeZ;AAED,eAAe,OAAO,CAAC"}

package/dist/web/features/helpers.d.ts

@@ -0,0 +1,140 @@
+import { z } from 'zod';
+import { Feature } from '../feature.js';
+export declare const HelpersStateSchema: z.ZodObject<{
+    enabled: z.ZodDefault<z.ZodBoolean>;
+    discovered: z.ZodDefault<z.ZodRecord<z.ZodString, z.ZodBoolean>>;
+    registered: z.ZodDefault<z.ZodArray<z.ZodString>>;
+    manifestLoaded: z.ZodDefault<z.ZodBoolean>;
+}, z.core.$loose>;
+export type HelpersState = z.infer<typeof HelpersStateSchema>;
+export declare const HelpersOptionsSchema: z.ZodObject<{
+    name: z.ZodOptional<z.ZodString>;
+    _cacheKey: z.ZodOptional<z.ZodString>;
+    cached: z.ZodOptional<z.ZodBoolean>;
+    enable: z.ZodOptional<z.ZodBoolean>;
+    manifestURL: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>;
+export type HelpersOptions = z.infer<typeof HelpersOptionsSchema>;
+export declare const HelpersEventsSchema: z.ZodObject<{
+    stateChange: z.ZodTuple<[z.ZodAny], null>;
+    enabled: z.ZodTuple<[], null>;
+    discovered: z.ZodTuple<[z.ZodString, z.ZodArray<z.ZodString>], null>;
+    registered: z.ZodTuple<[z.ZodString, z.ZodString], null>;
+    manifestLoaded: z.ZodTuple<[z.ZodAny], null>;
+    manifestError: z.ZodTuple<[z.ZodAny], null>;
+}, z.core.$strip>;
+type RegistryType = 'features' | 'clients';
+/**
+ * The Helpers feature discovers and loads project-level helpers from a JSON manifest
+ * served over HTTP. Scripts are injected via AssetLoader and self-register into
+ * the container's registries.
+ *
+ * This is the web equivalent of the node Helpers feature, which scans the filesystem.
+ * Instead of filesystem scanning, this feature fetches a manifest from a well-known URL
+ * and uses AssetLoader.loadScript() to inject each helper's script tag.
+ *
+ * @example
+ * ```typescript
+ * const helpers = container.feature('helpers', { enable: true })
+ *
+ * // Discover all helper types from the manifest
+ * await helpers.discoverAll()
+ *
+ * // Discover a specific type
+ * await helpers.discover('features')
+ *
+ * // Unified view of all available helpers
+ * console.log(helpers.available)
+ * ```
+ */
+export declare class Helpers extends Feature<HelpersState, HelpersOptions> {
+    static shortcut: "features.helpers";
+    static description: string;
+    static stateSchema: z.ZodObject<{
+        enabled: z.ZodDefault<z.ZodBoolean>;
+        discovered: z.ZodDefault<z.ZodRecord<z.ZodString, z.ZodBoolean>>;
+        registered: z.ZodDefault<z.ZodArray<z.ZodString>>;
+        manifestLoaded: z.ZodDefault<z.ZodBoolean>;
+    }, z.core.$loose>;
+    static optionsSchema: z.ZodObject<{
+        name: z.ZodOptional<z.ZodString>;
+        _cacheKey: z.ZodOptional<z.ZodString>;
+        cached: z.ZodOptional<z.ZodBoolean>;
+        enable: z.ZodOptional<z.ZodBoolean>;
+        manifestURL: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>;
+    static eventsSchema: z.ZodObject<{
+        stateChange: z.ZodTuple<[z.ZodAny], null>;
+        enabled: z.ZodTuple<[], null>;
+        discovered: z.ZodTuple<[z.ZodString, z.ZodArray<z.ZodString>], null>;
+        registered: z.ZodTuple<[z.ZodString, z.ZodString], null>;
+        manifestLoaded: z.ZodTuple<[z.ZodAny], null>;
+        manifestError: z.ZodTuple<[z.ZodAny], null>;
+    }, z.core.$strip>;
+    private _manifest;
+    private get registryMap();
+    /** The URL to fetch the helpers manifest from. */
+    get manifestURL(): string;
+    /**
+     * Set a new manifest URL. Invalidates any cached manifest.
+     *
+     * @param url - The new URL to fetch the manifest from
+     */
+    setManifestURL(url: string): void;
+    /**
+     * Returns a unified view of all available helpers across all registries.
+     * Each key is a registry type, each value is the list of helper names in that registry.
+     */
+    get available(): Record<string, string[]>;
+    /**
+     * Fetch and cache the manifest JSON. Returns cached version on subsequent calls
+     * unless invalidated by setManifestURL().
+     */
+    private fetchManifest;
+    /**
+     * Get the AssetLoader instance from the container.
+     */
+    private get assetLoader();
+    /**
+     * Discover and register helpers of the given type from the manifest.
+     *
+     * Fetches the manifest, then for each entry of the requested type,
+     * loads the script via AssetLoader and checks what got newly registered.
+     *
+     * @param type - Which type of helpers to discover ('features' or 'clients')
+     * @returns Names of helpers that were discovered and registered
+     */
+    discover(type: RegistryType): Promise<string[]>;
+    /**
+     * Discover all helper types from the manifest.
+     *
+     * @returns Map of registry type to discovered helper names
+     */
+    discoverAll(): Promise<Record<string, string[]>>;
+    /**
+     * Convenience method to discover only features.
+     */
+    discoverFeatures(): Promise<string[]>;
+    /**
+     * Convenience method to discover only clients.
+     */
+    discoverClients(): Promise<string[]>;
+    /**
+     * Look up a helper class by type and name.
+     *
+     * @param type - The registry type
+     * @param name - The helper name within that registry
+     * @returns The helper constructor
+     */
+    lookup(type: RegistryType, name: string): any;
+    /**
+     * Get the introspection description for a specific helper.
+     *
+     * @param type - The registry type
+     * @param name - The helper name
+     * @returns Markdown description of the helper's interface
+     */
+    describe(type: RegistryType, name: string): string;
+}
+export default Helpers;
+//# sourceMappingURL=helpers.d.ts.map

package/dist/web/features/helpers.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"helpers.d.ts","sourceRoot":"","sources":["../../../src/web/features/helpers.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAA;AAEvB,OAAO,EAAE,OAAO,EAAE,MAAM,eAAe,CAAA;AAKvC,eAAO,MAAM,kBAAkB;;;;;iBAI7B,CAAA;AAEF,MAAM,MAAM,YAAY,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,kBAAkB,CAAC,CAAA;AAE7D,eAAO,MAAM,oBAAoB;;;;;;iBAE/B,CAAA;AAEF,MAAM,MAAM,cAAc,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,oBAAoB,CAAC,CAAA;AAEjE,eAAO,MAAM,mBAAmB;;;;;;;iBAe9B,CAAA;AAEF,KAAK,YAAY,GAAG,UAAU,GAAG,SAAS,CAAA;AAa1C;;;;;;;;;;;;;;;;;;;;;;GAsBG;AACH,qBAAa,OAAQ,SAAQ,OAAO,CAAC,YAAY,EAAE,cAAc,CAAC;IAChE,OAAgB,QAAQ,EAAG,kBAAkB,CAAS;IACtD,OAAgB,WAAW,SAA4F;IACvH,OAAgB,WAAW;;;;;sBAAqB;IAChD,OAAgB,aAAa;;;;;;sBAAuB;IACpD,OAAgB,YAAY;;;;;;;sBAAsB;IAIlD,OAAO,CAAC,SAAS,CAAwB;IAEzC,OAAO,KAAK,WAAW,GAKtB;IAED,kDAAkD;IAClD,IAAI,WAAW,IAAI,MAAM,CAExB;IAED;;;;OAIG;IACH,cAAc,CAAC,GAAG,EAAE,MAAM;IAM1B;;;OAGG;IACH,IAAI,SAAS,IAAI,MAAM,CAAC,MAAM,EAAE,MAAM,EAAE,CAAC,CAMxC;IAED;;;OAGG;YACW,aAAa;IAyB3B;;OAEG;IACH,OAAO,KAAK,WAAW,GAEtB;IAED;;;;;;;;OAQG;IACG,QAAQ,CAAC,IAAI,EAAE,YAAY,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC;IAiDrD;;;;OAIG;IACG,WAAW,IAAI,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,EAAE,CAAC,CAAC;IAUtD;;OAEG;IACG,gBAAgB,IAAI,OAAO,CAAC,MAAM,EAAE,CAAC;IAI3C;;OAEG;IACG,eAAe,IAAI,OAAO,CAAC,MAAM,EAAE,CAAC;IAI1C;;;;;;OAMG;IACH,MAAM,CAAC,IAAI,EAAE,YAAY,EAAE,IAAI,EAAE,MAAM,GAAG,GAAG;IAK7C;;;;;;OAMG;IACH,QAAQ,CAAC,IAAI,EAAE,YAAY,EAAE,IAAI,EAAE,MAAM,GAAG,MAAM;CAInD;AAED,eAAe,OAAO,CAAA"}

package/dist/web/features/network.d.ts

@@ -0,0 +1,69 @@
+import { z } from 'zod';
+import { Feature } from "../feature.js";
+import type { ContainerContext } from "../container.js";
+export declare const NetworkStateSchema: z.ZodObject<{
+    enabled: z.ZodDefault<z.ZodBoolean>;
+    offline: z.ZodBoolean;
+}, z.core.$loose>;
+export declare const NetworkOptionsSchema: z.ZodObject<{
+    name: z.ZodOptional<z.ZodString>;
+    _cacheKey: z.ZodOptional<z.ZodString>;
+    cached: z.ZodOptional<z.ZodBoolean>;
+    enable: z.ZodOptional<z.ZodBoolean>;
+}, z.core.$strip>;
+export declare const NetworkEventsSchema: z.ZodObject<{
+    stateChange: z.ZodTuple<[z.ZodAny], null>;
+    enabled: z.ZodTuple<[], null>;
+    online: z.ZodTuple<[], null>;
+    offline: z.ZodTuple<[], null>;
+}, z.core.$strip>;
+export type NetworkState = z.infer<typeof NetworkStateSchema>;
+export type NetworkOptions = z.infer<typeof NetworkOptionsSchema>;
+/**
+ * Tracks browser online/offline connectivity state.
+ *
+ * Listens for the browser's `online` and `offline` events and keeps the
+ * feature state in sync. Other features can observe the `offline` state
+ * value or listen for change events to react to connectivity changes.
+ *
+ * @extends Feature
+ *
+ * @example
+ * ```typescript
+ * const network = container.feature('network')
+ * console.log(network.state.get('offline')) // false when online
+ *
+ * network.on('stateChanged', ({ offline }) => {
+ *   console.log(offline ? 'Went offline' : 'Back online')
+ * })
+ * ```
+ */
+export declare class Network<T extends NetworkState = NetworkState, K extends NetworkOptions = NetworkOptions> extends Feature<T, K> {
+    static stateSchema: z.ZodObject<{
+        enabled: z.ZodDefault<z.ZodBoolean>;
+        offline: z.ZodBoolean;
+    }, z.core.$loose>;
+    static optionsSchema: z.ZodObject<{
+        name: z.ZodOptional<z.ZodString>;
+        _cacheKey: z.ZodOptional<z.ZodString>;
+        cached: z.ZodOptional<z.ZodBoolean>;
+        enable: z.ZodOptional<z.ZodBoolean>;
+    }, z.core.$strip>;
+    static eventsSchema: z.ZodObject<{
+        stateChange: z.ZodTuple<[z.ZodAny], null>;
+        enabled: z.ZodTuple<[], null>;
+        online: z.ZodTuple<[], null>;
+        offline: z.ZodTuple<[], null>;
+    }, z.core.$strip>;
+    static shortcut: "features.network";
+    constructor(options: K, context: ContainerContext);
+    /** Whether the browser is currently offline. */
+    get isOffline(): boolean;
+    /** Whether the browser is currently online. */
+    get isOnline(): boolean;
+    private handleConnectionChange;
+    start(): this;
+    disable(): this;
+}
+export default Network;
+//# sourceMappingURL=network.d.ts.map

package/dist/web/features/network.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"network.d.ts","sourceRoot":"","sources":["../../../src/web/features/network.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAA;AAEvB,OAAO,EAAE,OAAO,EAAE,MAAM,eAAe,CAAC;AACxC,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,iBAAiB,CAAC;AAExD,eAAO,MAAM,kBAAkB;;;iBAE7B,CAAA;AAEF,eAAO,MAAM,oBAAoB;;;;;iBAAkC,CAAA;AAEnE,eAAO,MAAM,mBAAmB;;;;;iBAGH,CAAA;AAE7B,MAAM,MAAM,YAAY,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,kBAAkB,CAAC,CAAA;AAC7D,MAAM,MAAM,cAAc,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,oBAAoB,CAAC,CAAA;AAEjE;;;;;;;;;;;;;;;;;;GAkBG;AACH,qBAAa,OAAO,CAClB,CAAC,SAAS,YAAY,GAAG,YAAY,EACrC,CAAC,SAAS,cAAc,GAAG,cAAc,CACzC,SAAQ,OAAO,CAAC,CAAC,EAAE,CAAC,CAAC;IACrB,OAAgB,WAAW;;;sBAAqB;IAChD,OAAgB,aAAa;;;;;sBAAuB;IACpD,OAAgB,YAAY;;;;;sBAAsB;IAClD,OAAgB,QAAQ,EAAG,kBAAkB,CAAS;gBAI1C,OAAO,EAAE,CAAC,EAAE,OAAO,EAAE,gBAAgB;IAKjD,gDAAgD;IAChD,IAAI,SAAS,YAEZ;IAED,+CAA+C;IAC/C,IAAI,QAAQ,YAEX;IAED,OAAO,CAAC,sBAAsB,CAI5B;IAEF,KAAK;IAML,OAAO;CAKR;AAED,eAAe,OAAO,CAAA"}