pushwork 2.0.0-preview → 2.0.0-preview.3

package/dist/utils/network-sync.js

@@ -0,0 +1,391 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.waitForBidirectionalSync = waitForBidirectionalSync;
+exports.waitForSync = waitForSync;
+const A = __importStar(require("@automerge/automerge"));
+const output_1 = require("./output");
+const directory_1 = require("./directory");
+const isDebug = !!process.env.DEBUG;
+function debug(...args) {
+    if (isDebug)
+        console.error("[pushwork:sync]", ...args);
+}
+/**
+ * Wait for bidirectional sync to stabilize.
+ * This function waits until document heads stop changing, indicating that
+ * both outgoing and incoming sync has completed.
+ *
+ * @param repo - The Automerge repository
+ * @param rootDirectoryUrl - The root directory URL to start traversal from
+ * @param options - Configuration options
+ */
+async function waitForBidirectionalSync(repo, rootDirectoryUrl, options = {}) {
+    const { timeoutMs = 10000, pollIntervalMs = 100, stableChecksRequired = 3, handles, } = options;
+    if (!rootDirectoryUrl) {
+        return;
+    }
+    const startTime = Date.now();
+    let lastSeenHeads = new Map();
+    let stableCount = 0;
+    let pollCount = 0;
+    let dynamicTimeoutMs = timeoutMs;
+    debug(`waitForBidirectionalSync: starting (timeout=${timeoutMs}ms, stableChecks=${stableChecksRequired}${handles ? `, tracking ${handles.length} handles` : ', full tree scan'})`);
+    while (Date.now() - startTime < dynamicTimeoutMs) {
+        pollCount++;
+        // Get current heads: use provided handles if available, otherwise full tree scan
+        const currentHeads = handles
+            ? getHandleHeads(handles)
+            : await getAllDocumentHeads(repo, rootDirectoryUrl);
+        // After first scan: scale timeout to tree size and reset the clock.
+        // The first scan is just establishing a baseline — its duration
+        // shouldn't count against the stability-wait timeout.
+        if (pollCount === 1) {
+            const scanDuration = Date.now() - startTime;
+            dynamicTimeoutMs = Math.max(timeoutMs, 5000 + currentHeads.size * 50) + scanDuration;
+            debug(`waitForBidirectionalSync: first scan took ${scanDuration}ms, timeout now ${dynamicTimeoutMs}ms for ${currentHeads.size} docs`);
+        }
+        // Check if heads are stable (no changes since last check)
+        const isStable = headsMapEqual(lastSeenHeads, currentHeads);
+        if (isStable) {
+            stableCount++;
+            debug(`waitForBidirectionalSync: stable check ${stableCount}/${stableChecksRequired} (${currentHeads.size} docs, poll #${pollCount})`);
+            if (stableCount >= stableChecksRequired) {
+                const elapsed = Date.now() - startTime;
+                debug(`waitForBidirectionalSync: converged in ${elapsed}ms after ${pollCount} polls (${currentHeads.size} docs)`);
+                output_1.out.taskLine(`Bidirectional sync converged (${currentHeads.size} docs, ${elapsed}ms)`);
+                return; // Converged!
+            }
+        }
+        else {
+            // Find which docs changed
+            if (lastSeenHeads.size > 0) {
+                const changedDocs = [];
+                for (const [url, heads] of currentHeads) {
+                    if (lastSeenHeads.get(url) !== heads) {
+                        changedDocs.push(url);
+                    }
+                }
+                const newDocs = currentHeads.size - lastSeenHeads.size;
+                if (newDocs > 0) {
+                    debug(`waitForBidirectionalSync: ${newDocs} new docs discovered, ${changedDocs.length} docs changed heads (poll #${pollCount})`);
+                }
+                else if (changedDocs.length > 0) {
+                    debug(`waitForBidirectionalSync: ${changedDocs.length} docs changed heads: ${changedDocs.slice(0, 5).join(", ")}${changedDocs.length > 5 ? ` ...and ${changedDocs.length - 5} more` : ""} (poll #${pollCount})`);
+                }
+            }
+            else {
+                debug(`waitForBidirectionalSync: initial scan found ${currentHeads.size} docs (poll #${pollCount})`);
+            }
+            if (stableCount > 0) {
+                debug(`waitForBidirectionalSync: heads changed after ${stableCount} stable checks, resetting`);
+            }
+            stableCount = 0;
+            lastSeenHeads = currentHeads;
+        }
+        await new Promise((r) => setTimeout(r, pollIntervalMs));
+    }
+    // Timeout - but don't throw, just log a warning
+    // The sync may still work, we just couldn't confirm stability
+    const elapsed = Date.now() - startTime;
+    debug(`waitForBidirectionalSync: timed out after ${elapsed}ms (${pollCount} polls, ${lastSeenHeads.size} docs tracked, reached ${stableCount}/${stableChecksRequired} stable checks)`);
+    output_1.out.taskLine(`Bidirectional sync timed out after ${(elapsed / 1000).toFixed(1)}s - document heads were still changing after ${pollCount} checks across ${lastSeenHeads.size} docs (reached ${stableCount}/${stableChecksRequired} stability checks). This may mean another peer is actively editing, or the sync server is slow to relay changes. The sync will continue but some remote changes may not be reflected yet.`, true);
+}
+/**
+ * Get heads from a pre-collected set of handles (cheap, synchronous reads).
+ * Used for post-push stabilization where we already know which documents changed.
+ */
+function getHandleHeads(handles) {
+    const heads = new Map();
+    for (const handle of handles) {
+        heads.set((0, directory_1.getPlainUrl)(handle.url), JSON.stringify(handle.heads()));
+    }
+    return heads;
+}
+/**
+ * Get all document heads in the directory hierarchy.
+ * Returns a map of document URL -> serialized heads.
+ * Uses plain URLs (without heads) to ensure we see current document state.
+ */
+async function getAllDocumentHeads(repo, rootDirectoryUrl) {
+    const heads = new Map();
+    // Pass URL as-is; collectHeadsRecursive will strip heads
+    await collectHeadsRecursive(repo, rootDirectoryUrl, heads);
+    return heads;
+}
+/**
+ * Recursively collect document heads from the directory hierarchy.
+ * Uses getPlainUrl to strip heads and always see the CURRENT state of documents.
+ */
+async function collectHeadsRecursive(repo, directoryUrl, heads) {
+    try {
+        const plainUrl = (0, directory_1.getPlainUrl)(directoryUrl);
+        const handle = await repo.find(plainUrl);
+        const doc = await handle.doc();
+        // Record this directory's heads (use plain URL as key for consistency)
+        heads.set(plainUrl, JSON.stringify(handle.heads()));
+        if (!doc || !doc.docs) {
+            return;
+        }
+        // Process all entries in the directory concurrently
+        await Promise.all(doc.docs.map(async (entry) => {
+            if (entry.type === "folder") {
+                // Recurse into subdirectory (entry.url may have stale heads)
+                await collectHeadsRecursive(repo, entry.url, heads);
+            }
+            else if (entry.type === "file") {
+                // Get file document heads (strip heads from entry.url)
+                try {
+                    const fileUrl = (0, directory_1.getPlainUrl)(entry.url);
+                    const fileHandle = await repo.find(fileUrl);
+                    heads.set(fileUrl, JSON.stringify(fileHandle.heads()));
+                }
+                catch {
+                    // File document may not exist yet
+                }
+            }
+        }));
+    }
+    catch {
+        // Directory may not exist yet
+    }
+}
+/**
+ * Compare two heads maps for equality.
+ */
+function headsMapEqual(a, b) {
+    if (a.size !== b.size) {
+        return false;
+    }
+    for (const [key, value] of a) {
+        if (b.get(key) !== value) {
+            return false;
+        }
+    }
+    return true;
+}
+/** Maximum documents to sync concurrently to avoid flooding the server */
+const SYNC_BATCH_SIZE = 10;
+/**
+ * Wait for a single document handle to sync to the server.
+ * Resolves with the handle on success, rejects with the handle on timeout.
+ */
+function waitForHandleSync(handle, syncServerStorageId, timeoutMs, startTime) {
+    return new Promise((resolve, reject) => {
+        let pollInterval;
+        const cleanup = () => {
+            clearTimeout(timeout);
+            clearInterval(pollInterval);
+            handle.off("remote-heads", onRemoteHeads);
+        };
+        const onConverged = () => {
+            debug(`waitForSync: ${handle.url}... converged in ${Date.now() - startTime}ms`);
+            cleanup();
+            resolve(handle);
+        };
+        const timeout = setTimeout(() => {
+            debug(`waitForSync: ${handle.url}... timed out after ${timeoutMs}ms`);
+            cleanup();
+            reject(handle);
+        }, timeoutMs);
+        const isConverged = () => {
+            const localHeads = handle.heads();
+            const info = handle.getSyncInfo(syncServerStorageId);
+            return A.equals(localHeads, info?.lastHeads);
+        };
+        const onRemoteHeads = ({ storageId, }) => {
+            if (storageId === syncServerStorageId && isConverged()) {
+                onConverged();
+            }
+        };
+        // Initial check
+        if (isConverged()) {
+            cleanup();
+            resolve(handle);
+            return;
+        }
+        // Start polling and event listening
+        pollInterval = setInterval(() => {
+            if (isConverged()) {
+                onConverged();
+            }
+        }, 100);
+        handle.on("remote-heads", onRemoteHeads);
+    });
+}
+/**
+ * Wait for documents to sync to the remote server.
+ * Processes handles in batches to avoid flooding the server.
+ * Returns a result with any failed handles instead of throwing,
+ * so callers can attempt recovery (e.g. recreating documents).
+ */
+async function waitForSync(handlesToWaitOn, syncServerStorageId, timeoutMs = 60000) {
+    const startTime = Date.now();
+    if (handlesToWaitOn.length === 0) {
+        debug("waitForSync: no documents to sync");
+        return { failed: [] };
+    }
+    // When no StorageId is available (Subduction mode), use head-stability
+    // polling. The SubductionSource handles sync internally — we just wait
+    // for each handle's heads to stop changing.
+    if (!syncServerStorageId) {
+        debug(`waitForSync: no storage ID, using head-stability polling for ${handlesToWaitOn.length} documents`);
+        output_1.out.taskLine(`Waiting for ${handlesToWaitOn.length} documents to sync`);
+        return waitForSyncViaHeadStability(handlesToWaitOn, timeoutMs, startTime);
+    }
+    debug(`waitForSync: waiting for ${handlesToWaitOn.length} documents (timeout=${timeoutMs}ms, batchSize=${SYNC_BATCH_SIZE})`);
+    // Separate already-synced from needs-sync
+    const needsSync = [];
+    let alreadySynced = 0;
+    for (const handle of handlesToWaitOn) {
+        const heads = handle.heads();
+        const syncInfo = handle.getSyncInfo(syncServerStorageId);
+        const remoteHeads = syncInfo?.lastHeads;
+        if (A.equals(heads, remoteHeads)) {
+            alreadySynced++;
+            debug(`waitForSync: ${handle.url}... already synced`);
+        }
+        else {
+            debug(`waitForSync: ${handle.url}... needs sync (remoteHeads=${remoteHeads ? 'present' : 'missing'})`);
+            needsSync.push(handle);
+        }
+    }
+    if (needsSync.length > 0) {
+        debug(`waitForSync: ${alreadySynced} already synced, ${needsSync.length} need sync`);
+        output_1.out.taskLine(`Uploading: ${alreadySynced}/${handlesToWaitOn.length} already synced, waiting for ${needsSync.length} more`);
+    }
+    else {
+        debug(`waitForSync: all ${handlesToWaitOn.length} already synced`);
+        return { failed: [] };
+    }
+    // Process in batches to avoid flooding the server
+    const failed = [];
+    let synced = alreadySynced;
+    for (let i = 0; i < needsSync.length; i += SYNC_BATCH_SIZE) {
+        const batch = needsSync.slice(i, i + SYNC_BATCH_SIZE);
+        const batchNum = Math.floor(i / SYNC_BATCH_SIZE) + 1;
+        const totalBatches = Math.ceil(needsSync.length / SYNC_BATCH_SIZE);
+        if (totalBatches > 1) {
+            debug(`waitForSync: batch ${batchNum}/${totalBatches} (${batch.length} docs)`);
+            output_1.out.update(`Uploading batch ${batchNum}/${totalBatches} (${synced}/${handlesToWaitOn.length} done)`);
+        }
+        const results = await Promise.allSettled(batch.map(handle => waitForHandleSync(handle, syncServerStorageId, timeoutMs, startTime)));
+        for (const result of results) {
+            if (result.status === "rejected") {
+                failed.push(result.reason);
+            }
+            else {
+                synced++;
+            }
+        }
+    }
+    const elapsed = Date.now() - startTime;
+    if (failed.length > 0) {
+        debug(`waitForSync: ${failed.length} documents failed after ${elapsed}ms`);
+        output_1.out.taskLine(`Upload: ${synced} synced, ${failed.length} failed after ${(elapsed / 1000).toFixed(1)}s`, true);
+    }
+    else {
+        debug(`waitForSync: all ${handlesToWaitOn.length} documents synced in ${elapsed}ms (${alreadySynced} were already synced)`);
+        output_1.out.taskLine(`All ${handlesToWaitOn.length} documents uploaded to server (${(elapsed / 1000).toFixed(1)}s)`);
+    }
+    return { failed };
+}
+/**
+ * Wait for sync by polling head stability (Subduction mode).
+ * Each handle's heads are polled until they remain unchanged for
+ * several consecutive checks, indicating the SubductionSource has
+ * finished syncing.
+ */
+async function waitForSyncViaHeadStability(handles, timeoutMs, startTime) {
+    const failed = [];
+    let synced = 0;
+    // Process in batches
+    for (let i = 0; i < handles.length; i += SYNC_BATCH_SIZE) {
+        const batch = handles.slice(i, i + SYNC_BATCH_SIZE);
+        const results = await Promise.allSettled(batch.map(handle => waitForHandleHeadStability(handle, timeoutMs, startTime)));
+        for (const result of results) {
+            if (result.status === "rejected") {
+                failed.push(result.reason);
+            }
+            else {
+                synced++;
+            }
+        }
+    }
+    const elapsed = Date.now() - startTime;
+    if (failed.length > 0) {
+        debug(`waitForSync(heads): ${failed.length} documents failed after ${elapsed}ms`);
+        output_1.out.taskLine(`Sync: ${synced} synced, ${failed.length} timed out after ${(elapsed / 1000).toFixed(1)}s`, true);
+    }
+    else {
+        debug(`waitForSync(heads): all ${handles.length} documents synced in ${elapsed}ms`);
+        output_1.out.taskLine(`All ${handles.length} documents synced (${(elapsed / 1000).toFixed(1)}s)`);
+    }
+    return { failed };
+}
+/**
+ * Wait for a single handle's heads to stabilize.
+ * Polls heads at 100ms intervals; resolves after 3 consecutive stable
+ * checks, rejects on timeout.
+ */
+function waitForHandleHeadStability(handle, timeoutMs, startTime) {
+    return new Promise((resolve, reject) => {
+        let lastHeads = JSON.stringify(handle.heads());
+        let stableCount = 0;
+        const stableRequired = 3;
+        const pollInterval = setInterval(() => {
+            const currentHeads = JSON.stringify(handle.heads());
+            if (currentHeads === lastHeads) {
+                stableCount++;
+                if (stableCount >= stableRequired) {
+                    clearInterval(pollInterval);
+                    clearTimeout(timeout);
+                    debug(`waitForSync(heads): ${handle.url}... converged in ${Date.now() - startTime}ms`);
+                    resolve(handle);
+                }
+            }
+            else {
+                stableCount = 0;
+                lastHeads = currentHeads;
+            }
+        }, 100);
+        const timeout = setTimeout(() => {
+            clearInterval(pollInterval);
+            debug(`waitForSync(heads): ${handle.url}... timed out after ${timeoutMs}ms`);
+            reject(handle);
+        }, timeoutMs);
+    });
+}
+//# sourceMappingURL=network-sync.js.map

package/dist/utils/network-sync.js.map

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

package/dist/utils/node-polyfills.d.ts

@@ -0,0 +1,9 @@
+/**
+ * Polyfills for browser APIs required by @automerge/automerge-subduction.
+ * Must be imported before any subduction code.
+ *
+ * The Subduction WASM module uses IndexedDB for key persistence
+ * (via WebCryptoSigner). In Node.js we provide a fake-indexeddb polyfill.
+ */
+import "fake-indexeddb/auto";
+//# sourceMappingURL=node-polyfills.d.ts.map

package/dist/utils/node-polyfills.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"node-polyfills.d.ts","sourceRoot":"","sources":["../../src/utils/node-polyfills.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AACH,OAAO,qBAAqB,CAAC"}

package/dist/utils/node-polyfills.js

@@ -0,0 +1,9 @@
+/**
+ * Polyfills for browser APIs required by @automerge/automerge-subduction.
+ * Must be imported before any subduction code.
+ *
+ * The Subduction WASM module uses IndexedDB for key persistence
+ * (via WebCryptoSigner). In Node.js we provide a fake-indexeddb polyfill.
+ */
+import "fake-indexeddb/auto";
+//# sourceMappingURL=node-polyfills.js.map

package/dist/utils/node-polyfills.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"node-polyfills.js","sourceRoot":"","sources":["../../src/utils/node-polyfills.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AACH,OAAO,qBAAqB,CAAC"}

package/dist/utils/output.d.ts

@@ -0,0 +1,129 @@
+/**
+ * Clean terminal output manager (Singleton)
+ * - Progress stays on one line (spinner updates in place)
+ * - No emojis
+ * - Background colors for section headers
+ * - Minimal output
+ * - Supports scrolling task lines (max-lines)
+ */
+export declare class Output {
+    #private;
+    private static instance;
+    private spinner;
+    private taskStartTime;
+    private taskOriginalMessage;
+    private taskCurrentMessage;
+    private taskLines;
+    private taskMaxLines;
+    private constructor();
+    /**
+     * Get the singleton instance
+     */
+    static getInstance(): Output;
+    /**
+     * Reset the singleton (useful for testing)
+     */
+    static reset(): void;
+    /**
+     * Start a task with spinner - updates in place
+     * Completes any previous task before starting the new one
+     * @param message - The task message
+     * @param maxLines - Maximum number of task lines to show (0 = unlimited, lines scroll)
+     */
+    task(message: string, maxLines?: number): void;
+    /**
+     * Update spinner text (stays on same line)
+     */
+    update(message: string): void;
+    /**
+     * Add a line to the active task (appears below spinner, scrolls if max-lines set)
+     * Lines are dimmed and temporary - they disappear when task completes unless kept
+     * If no task is active, displays as a regular log message
+     */
+    taskLine(message: string, keepOnComplete?: boolean): void;
+    /**
+     * Clear all task lines (useful when you want to reset the scrolling window)
+     */
+    clearTaskLines(): void;
+    /**
+     * Complete task with optional duration display
+     * Defaults to showing the original task message with duration
+     * Task lines marked with keepOnComplete will be preserved, others are cleared
+     */
+    done(message?: string, showTime?: boolean): void;
+    /**
+     * Show an object as a table of key-value pairs
+     * Filters out undefined values and applies optional transforms
+     * Automatically calculates key padding from max key length
+     */
+    obj(obj: Record<string, any>, keyTransform?: (key: string) => string, valueTransform?: (value: any, key: string) => string): void;
+    /**
+     * Display array as bulleted list
+     * Each item shown with dim bullet and white text
+     */
+    arr(items: any[]): void;
+    /**
+     * Show plain message with optional color
+     */
+    log(message: string, color?: "red" | "green" | "yellow" | "blue" | "cyan" | "magenta" | "gray" | "dim"): void;
+    /**
+     * Show success message (green text)
+     */
+    success(message: string): void;
+    /**
+     * Show success block (green background label + optional message)
+     */
+    successBlock(label: string, message?: string): void;
+    /**
+     * Show success message (green text)
+     */
+    spicy(message: string): void;
+    /**
+     * Show success block (green background label + optional message)
+     */
+    spicyBlock(label: string, message?: string): void;
+    /**
+     * Show message with rainbow gradient
+     */
+    rainbow(message: string): void;
+    /**
+     * Show info message (dim text)
+     */
+    info(message: string): void;
+    /**
+     * Show info block (grey background label + optional message)
+     */
+    infoBlock(label: string, message?: string): void;
+    /**
+     * Show error message (red text) - fails spinner if running
+     */
+    error(message: string | Error | unknown): void;
+    /**
+     * Show error block (red background label + optional message) - fails spinner if running
+     */
+    errorBlock(label: string, message?: string): void;
+    /**
+     * Show warning message (yellow text)
+     */
+    warn(message: string): void;
+    /**
+     * Show warning block (yellow background label + optional message)
+     */
+    warnBlock(label: string, message?: string): void;
+    /**
+     * Show detailed error information and exit the program
+     * Use this when an unexpected/unrecoverable error occurs
+     * Shows error message and stack trace, then exits
+     */
+    crash(error: unknown, exitCode?: number): never;
+    /**
+     * Exit with code
+     */
+    exit(code?: number): never;
+}
+/**
+ * Global singleton output instance
+ * Import and use this anywhere in your code
+ */
+export declare const out: Output;
+//# sourceMappingURL=output.d.ts.map

package/dist/utils/output.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"output.d.ts","sourceRoot":"","sources":["../../src/utils/output.ts"],"names":[],"mappings":"AAGA;;;;;;;GAOG;AACH,qBAAa,MAAM;;IACjB,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAuB;IAC9C,OAAO,CAAC,OAAO,CAAoB;IACnC,OAAO,CAAC,aAAa,CAAuB;IAC5C,OAAO,CAAC,mBAAmB,CAAuB;IAClD,OAAO,CAAC,kBAAkB,CAAuB;IACjD,OAAO,CAAC,SAAS,CAAgB;IACjC,OAAO,CAAC,YAAY,CAAa;IAEjC,OAAO;IAEP;;OAEG;IACH,MAAM,CAAC,WAAW,IAAI,MAAM;IAO5B;;OAEG;IACH,MAAM,CAAC,KAAK,IAAI,IAAI;IAQpB;;;;;OAKG;IACH,IAAI,CAAC,OAAO,EAAE,MAAM,EAAE,QAAQ,GAAE,MAAU,GAAG,IAAI;IAcjD;;OAEG;IACH,MAAM,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI;IAO7B;;;;OAIG;IACH,QAAQ,CAAC,OAAO,EAAE,MAAM,EAAE,cAAc,GAAE,OAAe,GAAG,IAAI;IAkBhE;;OAEG;IACH,cAAc,IAAI,IAAI;IAiCtB;;;;OAIG;IACH,IAAI,CAAC,OAAO,CAAC,EAAE,MAAM,EAAE,QAAQ,GAAE,OAAc,GAAG,IAAI;IAuCtD;;;;OAIG;IACH,GAAG,CACD,GAAG,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,EACxB,YAAY,CAAC,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,MAAM,EACtC,cAAc,CAAC,EAAE,CAAC,KAAK,EAAE,GAAG,EAAE,GAAG,EAAE,MAAM,KAAK,MAAM,GACnD,IAAI;IA0BP;;;OAGG;IACH,GAAG,CAAC,KAAK,EAAE,GAAG,EAAE,GAAG,IAAI;IASvB;;OAEG;IACH,GAAG,CACD,OAAO,EAAE,MAAM,EACf,KAAK,CAAC,EACF,KAAK,GACL,OAAO,GACP,QAAQ,GACR,MAAM,GACN,MAAM,GACN,SAAS,GACT,MAAM,GACN,KAAK,GACR,IAAI;IAWP;;OAEG;IACH,OAAO,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI;IAK9B;;OAEG;IACH,YAAY,CAAC,KAAK,EAAE,MAAM,EAAE,OAAO,GAAE,MAAW,GAAG,IAAI;IAOvD;;OAEG;IACH,KAAK,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI;IAK5B;;OAEG;IACH,UAAU,CAAC,KAAK,EAAE,MAAM,EAAE,OAAO,GAAE,MAAW,GAAG,IAAI;IAOrD;;OAEG;IACH,OAAO,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI;IA8B9B;;OAEG;IACH,IAAI,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI;IAK3B;;OAEG;IACH,SAAS,CAAC,KAAK,EAAE,MAAM,EAAE,OAAO,GAAE,MAAW,GAAG,IAAI;IAOpD;;OAEG;IACH,KAAK,CAAC,OAAO,EAAE,MAAM,GAAG,KAAK,GAAG,OAAO,GAAG,IAAI;IAmB9C;;OAEG;IACH,UAAU,CAAC,KAAK,EAAE,MAAM,EAAE,OAAO,GAAE,MAAW,GAAG,IAAI;IAarD;;OAEG;IACH,IAAI,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI;IAK3B;;OAEG;IACH,SAAS,CAAC,KAAK,EAAE,MAAM,EAAE,OAAO,GAAE,MAAW,GAAG,IAAI;IAOpD;;;;OAIG;IACH,KAAK,CAAC,KAAK,EAAE,OAAO,EAAE,QAAQ,GAAE,MAAU,GAAG,KAAK;IAuBlD;;OAEG;IACH,IAAI,CAAC,IAAI,CAAC,EAAE,MAAM,GAAG,KAAK;CAoB3B;AAED;;;GAGG;AACH,eAAO,MAAM,GAAG,QAAuB,CAAC"}