ugly-app 0.1.233 → 0.1.234

package/dist/cli/version.d.ts

@@ -1,2 +1,2 @@
-export declare const CLI_VERSION = "0.1.233";
+export declare const CLI_VERSION = "0.1.234";
 //# sourceMappingURL=version.d.ts.map

package/dist/cli/version.js

@@ -1,3 +1,3 @@
 // Auto-generated by prebuild — do not edit manually
-export const CLI_VERSION = "0.1.233";
+export const CLI_VERSION = "0.1.234";
 //# sourceMappingURL=version.js.map

package/dist/collab/client/CollabProvider.d.ts

@@ -0,0 +1,36 @@
+import * as Y from 'yjs';
+/**
+ * Transport interface for sending collab messages over a WebSocket.
+ * The consuming app wires this to its own socket implementation.
+ */
+export interface CollabTransport {
+    /** RPC — sends a message and waits for a response. */
+    send(type: string, data: object): Promise<unknown>;
+    /** Fire-and-forget — sends a message with no response expected. */
+    emit(type: string, data: object): void;
+}
+type PeerIdsCallback = (peerIds: string[]) => void;
+export declare class CollabClient {
+    readonly ydoc: Y.Doc;
+    readonly docId: string;
+    private connected;
+    private destroyed;
+    private pendingUpdates;
+    private onPeersChange;
+    private transport;
+    private updateHandler;
+    private awarenessHandler;
+    private peersHandler;
+    private reconnectHandler;
+    constructor(docId: string, transport: CollabTransport | null);
+    setTransport(transport: CollabTransport | null): void;
+    setPeersCallback(cb: PeerIdsCallback): void;
+    connect(): Promise<void>;
+    private handleLocalUpdate;
+    private sendUpdate;
+    disconnect(): void;
+    destroy(): void;
+    isConnected(): boolean;
+}
+export {};
+//# sourceMappingURL=CollabProvider.d.ts.map

package/dist/collab/client/CollabProvider.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"CollabProvider.d.ts","sourceRoot":"","sources":["../../../src/collab/client/CollabProvider.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,CAAC,MAAM,KAAK,CAAC;AAUzB;;;GAGG;AACH,MAAM,WAAW,eAAe;IAC9B,sDAAsD;IACtD,IAAI,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;IACnD,mEAAmE;IACnE,IAAI,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,IAAI,CAAC;CACxC;AAED,KAAK,eAAe,GAAG,CAAC,OAAO,EAAE,MAAM,EAAE,KAAK,IAAI,CAAC;AAEnD,qBAAa,YAAY;IACvB,QAAQ,CAAC,IAAI,EAAE,CAAC,CAAC,GAAG,CAAC;IACrB,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,OAAO,CAAC,SAAS,CAAS;IAC1B,OAAO,CAAC,SAAS,CAAS;IAC1B,OAAO,CAAC,cAAc,CAAoB;IAC1C,OAAO,CAAC,aAAa,CAAgC;IACrD,OAAO,CAAC,SAAS,CAAyB;IAG1C,OAAO,CAAC,aAAa,CAA+C;IACpE,OAAO,CAAC,gBAAgB,CAA+C;IACvE,OAAO,CAAC,YAAY,CAA+C;IACnE,OAAO,CAAC,gBAAgB,CAA+C;gBAE3D,KAAK,EAAE,MAAM,EAAE,SAAS,EAAE,eAAe,GAAG,IAAI;IAoD5D,YAAY,CAAC,SAAS,EAAE,eAAe,GAAG,IAAI,GAAG,IAAI;IAIrD,gBAAgB,CAAC,EAAE,EAAE,eAAe,GAAG,IAAI;IAIrC,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC;IAmC9B,OAAO,CAAC,iBAAiB;IAazB,OAAO,CAAC,UAAU;IAQlB,UAAU,IAAI,IAAI;IAQlB,OAAO,IAAI,IAAI;IAqBf,WAAW,IAAI,OAAO;CAGvB"}

package/dist/collab/client/CollabProvider.js

@@ -0,0 +1,152 @@
+import * as Y from 'yjs';
+import { base64Decode, base64Encode } from './collabUtils.js';
+export class CollabClient {
+    ydoc;
+    docId;
+    connected = false;
+    destroyed = false;
+    pendingUpdates = [];
+    onPeersChange = null;
+    transport;
+    // Event listener cleanup references
+    updateHandler = null;
+    awarenessHandler = null;
+    peersHandler = null;
+    reconnectHandler = null;
+    constructor(docId, transport) {
+        this.docId = docId;
+        this.transport = transport;
+        this.ydoc = new Y.Doc();
+        // Listen for local Yjs updates
+        this.ydoc.on('update', (update, origin) => {
+            if (origin === 'remote')
+                return;
+            this.handleLocalUpdate(update);
+        });
+        // Listen for remote events from WebSocket (dispatched as CustomEvents on window)
+        this.updateHandler = (event) => {
+            const msg = event.detail;
+            if (msg.docId !== this.docId)
+                return;
+            try {
+                const update = base64Decode(msg.update);
+                Y.applyUpdate(this.ydoc, update, 'remote');
+            }
+            catch (error) {
+                console.error('[Collab] Failed to apply remote update', error);
+            }
+        };
+        this.awarenessHandler = (event) => {
+            const msg = event.detail;
+            if (msg.docId !== this.docId)
+                return;
+            // Awareness is handled at a higher level if needed
+        };
+        this.peersHandler = (event) => {
+            const msg = event.detail;
+            if (msg.docId !== this.docId)
+                return;
+            this.onPeersChange?.(msg.peerIds);
+        };
+        this.reconnectHandler = (event) => {
+            const detail = event.detail;
+            if (detail.state === 'connected' && detail.wasReconnect) {
+                this.connected = false;
+                void this.connect();
+            }
+        };
+        window.addEventListener('collab:update', this.updateHandler);
+        window.addEventListener('collab:awareness', this.awarenessHandler);
+        window.addEventListener('collab:peers', this.peersHandler);
+        window.addEventListener('ws-connection-state', this.reconnectHandler);
+    }
+    setTransport(transport) {
+        this.transport = transport;
+    }
+    setPeersCallback(cb) {
+        this.onPeersChange = cb;
+    }
+    async connect() {
+        if (this.destroyed || this.connected || !this.transport)
+            return;
+        try {
+            const stateVector = Y.encodeStateVector(this.ydoc);
+            const input = {
+                docId: this.docId,
+                stateVector: base64Encode(stateVector),
+            };
+            const response = (await this.transport.send('collab:join', input));
+            if (this.destroyed)
+                return;
+            if (response.update) {
+                const update = base64Decode(response.update);
+                Y.applyUpdate(this.ydoc, update, 'remote');
+            }
+            this.connected = true;
+            if (response.peerIds) {
+                this.onPeersChange?.(response.peerIds);
+            }
+            // Flush pending updates
+            for (const update of this.pendingUpdates) {
+                this.sendUpdate(update);
+            }
+            this.pendingUpdates = [];
+        }
+        catch (error) {
+            console.error('[Collab] Failed to join', error);
+        }
+    }
+    handleLocalUpdate(update) {
+        if (this.destroyed)
+            return;
+        if (this.connected) {
+            this.sendUpdate(update);
+        }
+        else {
+            this.pendingUpdates.push(update);
+            if (this.pendingUpdates.length > 1000) {
+                const merged = Y.mergeUpdatesV2(this.pendingUpdates);
+                this.pendingUpdates = [merged];
+            }
+        }
+    }
+    sendUpdate(update) {
+        if (!this.transport)
+            return;
+        this.transport.emit('collab:update', {
+            docId: this.docId,
+            update: base64Encode(update),
+        });
+    }
+    disconnect() {
+        if (!this.connected)
+            return;
+        if (this.transport) {
+            this.transport.emit('collab:leave', { docId: this.docId });
+        }
+        this.connected = false;
+    }
+    destroy() {
+        if (this.destroyed)
+            return;
+        this.destroyed = true;
+        this.disconnect();
+        if (this.updateHandler) {
+            window.removeEventListener('collab:update', this.updateHandler);
+        }
+        if (this.awarenessHandler) {
+            window.removeEventListener('collab:awareness', this.awarenessHandler);
+        }
+        if (this.peersHandler) {
+            window.removeEventListener('collab:peers', this.peersHandler);
+        }
+        if (this.reconnectHandler) {
+            window.removeEventListener('ws-connection-state', this.reconnectHandler);
+        }
+        this.ydoc.destroy();
+    }
+    isConnected() {
+        return this.connected;
+    }
+}
+//# sourceMappingURL=CollabProvider.js.map

package/dist/collab/client/CollabProvider.js.map

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

package/dist/collab/client/collabUtils.d.ts

@@ -0,0 +1,3 @@
+export declare function base64Encode(data: Uint8Array): string;
+export declare function base64Decode(base64: string): Uint8Array;
+//# sourceMappingURL=collabUtils.d.ts.map

package/dist/collab/client/collabUtils.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"collabUtils.d.ts","sourceRoot":"","sources":["../../../src/collab/client/collabUtils.ts"],"names":[],"mappings":"AAEA,wBAAgB,YAAY,CAAC,IAAI,EAAE,UAAU,GAAG,MAAM,CAMrD;AAED,wBAAgB,YAAY,CAAC,MAAM,EAAE,MAAM,GAAG,UAAU,CAOvD"}

package/dist/collab/client/collabUtils.js

@@ -0,0 +1,17 @@
+// Base64 encode/decode for Yjs binary data (browser-safe)
+export function base64Encode(data) {
+    let binary = '';
+    for (let i = 0; i < data.length; i++) {
+        binary += String.fromCharCode(data[i]);
+    }
+    return btoa(binary);
+}
+export function base64Decode(base64) {
+    const binary = atob(base64);
+    const data = new Uint8Array(binary.length);
+    for (let i = 0; i < binary.length; i++) {
+        data[i] = binary.charCodeAt(i);
+    }
+    return data;
+}
+//# sourceMappingURL=collabUtils.js.map

package/dist/collab/client/collabUtils.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"collabUtils.js","sourceRoot":"","sources":["../../../src/collab/client/collabUtils.ts"],"names":[],"mappings":"AAAA,0DAA0D;AAE1D,MAAM,UAAU,YAAY,CAAC,IAAgB;IAC3C,IAAI,MAAM,GAAG,EAAE,CAAC;IAChB,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,IAAI,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC;QACrC,MAAM,IAAI,MAAM,CAAC,YAAY,CAAC,IAAI,CAAC,CAAC,CAAE,CAAC,CAAC;IAC1C,CAAC;IACD,OAAO,IAAI,CAAC,MAAM,CAAC,CAAC;AACtB,CAAC;AAED,MAAM,UAAU,YAAY,CAAC,MAAc;IACzC,MAAM,MAAM,GAAG,IAAI,CAAC,MAAM,CAAC,CAAC;IAC5B,MAAM,IAAI,GAAG,IAAI,UAAU,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC;IAC3C,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,MAAM,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC;QACvC,IAAI,CAAC,CAAC,CAAC,GAAG,MAAM,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC;IACjC,CAAC;IACD,OAAO,IAAI,CAAC;AACd,CAAC"}

package/dist/collab/client/index.d.ts

@@ -0,0 +1,5 @@
+export { CollabClient, type CollabTransport } from './CollabProvider.js';
+export { useCollab, type UseCollabOptions, type UseCollabResult } from './useCollab.js';
+export { base64Encode, base64Decode } from './collabUtils.js';
+export type { CollabJoinInput, CollabSyncOutput, CollabUpdateMessage, CollabAwarenessMessage, CollabLeaveInput, CollabPeersMessage, CollabDocState, } from '../shared/CollabTypes.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/collab/client/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/collab/client/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,KAAK,eAAe,EAAE,MAAM,qBAAqB,CAAC;AACzE,OAAO,EAAE,SAAS,EAAE,KAAK,gBAAgB,EAAE,KAAK,eAAe,EAAE,MAAM,gBAAgB,CAAC;AACxF,OAAO,EAAE,YAAY,EAAE,YAAY,EAAE,MAAM,kBAAkB,CAAC;AAC9D,YAAY,EACV,eAAe,EACf,gBAAgB,EAChB,mBAAmB,EACnB,sBAAsB,EACtB,gBAAgB,EAChB,kBAAkB,EAClB,cAAc,GACf,MAAM,0BAA0B,CAAC"}

package/dist/collab/client/index.js

@@ -0,0 +1,4 @@
+export { CollabClient } from './CollabProvider.js';
+export { useCollab } from './useCollab.js';
+export { base64Encode, base64Decode } from './collabUtils.js';
+//# sourceMappingURL=index.js.map

package/dist/collab/client/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/collab/client/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAwB,MAAM,qBAAqB,CAAC;AACzE,OAAO,EAAE,SAAS,EAA+C,MAAM,gBAAgB,CAAC;AACxF,OAAO,EAAE,YAAY,EAAE,YAAY,EAAE,MAAM,kBAAkB,CAAC"}

package/dist/collab/client/useCollab.d.ts

@@ -0,0 +1,14 @@
+import { CollabClient, type CollabTransport } from './CollabProvider.js';
+export interface UseCollabOptions {
+    docId: string;
+    enabled: boolean;
+    transport: CollabTransport | null;
+}
+export interface UseCollabResult {
+    provider: CollabClient | null;
+    ydoc: CollabClient['ydoc'] | null;
+    peerIds: string[];
+    connected: boolean;
+}
+export declare function useCollab(options: UseCollabOptions): UseCollabResult;
+//# sourceMappingURL=useCollab.d.ts.map

package/dist/collab/client/useCollab.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useCollab.d.ts","sourceRoot":"","sources":["../../../src/collab/client/useCollab.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,YAAY,EAAE,KAAK,eAAe,EAAE,MAAM,qBAAqB,CAAC;AAEzE,MAAM,WAAW,gBAAgB;IAC/B,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,EAAE,OAAO,CAAC;IACjB,SAAS,EAAE,eAAe,GAAG,IAAI,CAAC;CACnC;AAED,MAAM,WAAW,eAAe;IAC9B,QAAQ,EAAE,YAAY,GAAG,IAAI,CAAC;IAC9B,IAAI,EAAE,YAAY,CAAC,MAAM,CAAC,GAAG,IAAI,CAAC;IAClC,OAAO,EAAE,MAAM,EAAE,CAAC;IAClB,SAAS,EAAE,OAAO,CAAC;CACpB;AAED,wBAAgB,SAAS,CAAC,OAAO,EAAE,gBAAgB,GAAG,eAAe,CAuCpE"}

package/dist/collab/client/useCollab.js

@@ -0,0 +1,38 @@
+import { useEffect, useRef, useState } from 'react';
+import { CollabClient } from './CollabProvider.js';
+export function useCollab(options) {
+    const { docId, enabled, transport } = options;
+    const [provider, setProvider] = useState(null);
+    const [peerIds, setPeerIds] = useState([]);
+    const [connected, setConnected] = useState(false);
+    const providerRef = useRef(null);
+    useEffect(() => {
+        if (!enabled || !docId)
+            return;
+        const client = new CollabClient(docId, transport);
+        providerRef.current = client;
+        client.setPeersCallback((newPeerIds) => {
+            setPeerIds(newPeerIds);
+        });
+        void client.connect().then(() => {
+            if (client.isConnected()) {
+                setProvider(client);
+                setConnected(true);
+            }
+        });
+        return () => {
+            client.destroy();
+            providerRef.current = null;
+            setProvider(null);
+            setPeerIds([]);
+            setConnected(false);
+        };
+    }, [docId, enabled, transport]);
+    return {
+        provider,
+        ydoc: provider?.ydoc ?? null,
+        peerIds,
+        connected,
+    };
+}
+//# sourceMappingURL=useCollab.js.map

package/dist/collab/client/useCollab.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"useCollab.js","sourceRoot":"","sources":["../../../src/collab/client/useCollab.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,OAAO,CAAC;AACpD,OAAO,EAAE,YAAY,EAAwB,MAAM,qBAAqB,CAAC;AAezE,MAAM,UAAU,SAAS,CAAC,OAAyB;IACjD,MAAM,EAAE,KAAK,EAAE,OAAO,EAAE,SAAS,EAAE,GAAG,OAAO,CAAC;IAC9C,MAAM,CAAC,QAAQ,EAAE,WAAW,CAAC,GAAG,QAAQ,CAAsB,IAAI,CAAC,CAAC;IACpE,MAAM,CAAC,OAAO,EAAE,UAAU,CAAC,GAAG,QAAQ,CAAW,EAAE,CAAC,CAAC;IACrD,MAAM,CAAC,SAAS,EAAE,YAAY,CAAC,GAAG,QAAQ,CAAC,KAAK,CAAC,CAAC;IAClD,MAAM,WAAW,GAAG,MAAM,CAAsB,IAAI,CAAC,CAAC;IAEtD,SAAS,CAAC,GAAG,EAAE;QACb,IAAI,CAAC,OAAO,IAAI,CAAC,KAAK;YAAE,OAAO;QAE/B,MAAM,MAAM,GAAG,IAAI,YAAY,CAAC,KAAK,EAAE,SAAS,CAAC,CAAC;QAClD,WAAW,CAAC,OAAO,GAAG,MAAM,CAAC;QAE7B,MAAM,CAAC,gBAAgB,CAAC,CAAC,UAAU,EAAE,EAAE;YACrC,UAAU,CAAC,UAAU,CAAC,CAAC;QACzB,CAAC,CAAC,CAAC;QAEH,KAAK,MAAM,CAAC,OAAO,EAAE,CAAC,IAAI,CAAC,GAAG,EAAE;YAC9B,IAAI,MAAM,CAAC,WAAW,EAAE,EAAE,CAAC;gBACzB,WAAW,CAAC,MAAM,CAAC,CAAC;gBACpB,YAAY,CAAC,IAAI,CAAC,CAAC;YACrB,CAAC;QACH,CAAC,CAAC,CAAC;QAEH,OAAO,GAAG,EAAE;YACV,MAAM,CAAC,OAAO,EAAE,CAAC;YACjB,WAAW,CAAC,OAAO,GAAG,IAAI,CAAC;YAC3B,WAAW,CAAC,IAAI,CAAC,CAAC;YAClB,UAAU,CAAC,EAAE,CAAC,CAAC;YACf,YAAY,CAAC,KAAK,CAAC,CAAC;QACtB,CAAC,CAAC;IACJ,CAAC,EAAE,CAAC,KAAK,EAAE,OAAO,EAAE,SAAS,CAAC,CAAC,CAAC;IAEhC,OAAO;QACL,QAAQ;QACR,IAAI,EAAE,QAAQ,EAAE,IAAI,IAAI,IAAI;QAC5B,OAAO;QACP,SAAS;KACV,CAAC;AACJ,CAAC"}

package/dist/collab/server/CollabServer.d.ts

@@ -0,0 +1,64 @@
+import type WebSocket from 'ws';
+import * as Y from 'yjs';
+import type { CollabDocState } from '../shared/CollabTypes.js';
+export interface CollabConfig {
+    /**
+     * Load the current Yjs state for a document.
+     * Return the base64-encoded yjsState string, or null if no state exists.
+     */
+    loadState(docId: string): Promise<string | null>;
+    /**
+     * Persist the Yjs state for a document.
+     * Called with the full base64-encoded state and a serialized content string
+     * (if a serialize callback is provided).
+     */
+    saveState(docId: string, collabState: CollabDocState, serialized: string | null): Promise<void>;
+    /**
+     * Optional: Initialize a Yjs doc from existing content when no collab state
+     * exists yet. Called with an empty Y.Doc — the implementation should populate it.
+     */
+    initializeDoc?(ydoc: Y.Doc, docId: string): Promise<void>;
+    /**
+     * Optional: Serialize a Yjs doc to a string for persistence alongside the
+     * binary Yjs state. Useful for maintaining a searchable/readable representation.
+     */
+    serialize?(ydoc: Y.Doc): string;
+    /**
+     * Optional: Called when an error occurs. Defaults to console.error.
+     */
+    onError?(message: string, error: unknown, context?: Record<string, unknown>): void;
+    /** Debounce interval for persistence in ms. Default: 3000 */
+    persistDebounceMs?: number;
+    /** Max wait before forced persistence in ms. Default: 30000 */
+    persistMaxWaitMs?: number;
+    /** Idle timeout before unloading a document in ms. Default: 300000 (5 min) */
+    idleCleanupMs?: number;
+}
+/**
+ * Manages collaborative editing for multiple documents using Yjs CRDTs.
+ * Cross-server sync via NATS, debounced persistence, idle cleanup.
+ */
+export declare class CollabServer {
+    private readonly config;
+    private readonly activeDocuments;
+    private readonly socketDocs;
+    constructor(config: CollabConfig);
+    private logError;
+    private loadDocument;
+    private unloadDocument;
+    private schedulePersist;
+    private persistDocument;
+    private broadcastToLocalPeers;
+    private broadcastPeerList;
+    join(ws: WebSocket, docId: string, userId: string, stateVector: string, messageId: string | undefined): Promise<void>;
+    handleUpdate(docId: string, userId: string, update: string): void;
+    handleAwareness(docId: string, userId: string, states: string): void;
+    leave(ws: WebSocket, docId: string, userId: string): void;
+    cleanupSocket(ws: WebSocket, userId: string): void;
+    /**
+     * Returns a socket message handler suitable for use with
+     * `configurator.addSocketMessageHandler()`.
+     */
+    createSocketHandler(): (ws: WebSocket, userId: string, msg: unknown) => boolean;
+}
+//# sourceMappingURL=CollabServer.d.ts.map

package/dist/collab/server/CollabServer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"CollabServer.d.ts","sourceRoot":"","sources":["../../../src/collab/server/CollabServer.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,SAAS,MAAM,IAAI,CAAC;AAChC,OAAO,KAAK,CAAC,MAAM,KAAK,CAAC;AAIzB,OAAO,KAAK,EAEV,cAAc,EAIf,MAAM,0BAA0B,CAAC;AAIlC,MAAM,WAAW,YAAY;IAC3B;;;OAGG;IACH,SAAS,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAAC;IAEjD;;;;OAIG;IACH,SAAS,CACP,KAAK,EAAE,MAAM,EACb,WAAW,EAAE,cAAc,EAC3B,UAAU,EAAE,MAAM,GAAG,IAAI,GACxB,OAAO,CAAC,IAAI,CAAC,CAAC;IAEjB;;;OAGG;IACH,aAAa,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC,GAAG,EAAE,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAE1D;;;OAGG;IACH,SAAS,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC,GAAG,GAAG,MAAM,CAAC;IAEhC;;OAEG;IACH,OAAO,CAAC,CAAC,OAAO,EAAE,MAAM,EAAE,KAAK,EAAE,OAAO,EAAE,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI,CAAC;IAEnF,6DAA6D;IAC7D,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAC3B,+DAA+D;IAC/D,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,8EAA8E;IAC9E,aAAa,CAAC,EAAE,MAAM,CAAC;CACxB;AAwDD;;;GAGG;AACH,qBAAa,YAAY;IACvB,OAAO,CAAC,QAAQ,CAAC,MAAM,CAGR;IAEf,OAAO,CAAC,QAAQ,CAAC,eAAe,CAAqC;IACrE,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAqC;gBAEpD,MAAM,EAAE,YAAY;IAShC,OAAO,CAAC,QAAQ;YAUF,YAAY;YA6GZ,cAAc;IAoB5B,OAAO,CAAC,eAAe;YAeT,eAAe;IA0C7B,OAAO,CAAC,qBAAqB;IAc7B,OAAO,CAAC,iBAAiB;IAQnB,IAAI,CACR,EAAE,EAAE,SAAS,EACb,KAAK,EAAE,MAAM,EACb,MAAM,EAAE,MAAM,EACd,WAAW,EAAE,MAAM,EACnB,SAAS,EAAE,MAAM,GAAG,SAAS,GAC5B,OAAO,CAAC,IAAI,CAAC;IA2ChB,YAAY,CAAC,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,IAAI;IAyBjE,eAAe,CAAC,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,IAAI;IAgBpE,KAAK,CAAC,EAAE,EAAE,SAAS,EAAE,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,IAAI;IAoCzD,aAAa,CAAC,EAAE,EAAE,SAAS,EAAE,MAAM,EAAE,MAAM,GAAG,IAAI;IAUlD;;;OAGG;IACH,mBAAmB,IAAI,CAAC,EAAE,EAAE,SAAS,EAAE,MAAM,EAAE,MAAM,EAAE,GAAG,EAAE,OAAO,KAAK,OAAO;CAoChF"}