@defensestation/ysync-go 0.1.0-dev.12.d04ad84

package/dist/client/websocket-yjs-provider.d.ts

@@ -0,0 +1,51 @@
+import { Awareness } from "y-protocols/awareness";
+import * as Y from "yjs";
+import type { YjsProviderIdentity, YjsProviderIdentityListener, YjsProviderStatus, YjsProviderStatusListener } from "./provider-status.js";
+export interface WebSocketYjsProviderOptions {
+    ydoc: Y.Doc;
+    docId: string;
+    url?: string;
+    baseUrl?: string;
+    clientId?: string;
+    user: {
+        name: string;
+        color?: string;
+    };
+    reconnectInitialDelayMs?: number;
+    reconnectMaxDelayMs?: number;
+    awarenessThrottleMs?: number;
+}
+export declare class WebSocketYjsProvider {
+    readonly awareness: Awareness;
+    readonly clientId: string;
+    private readonly options;
+    private socket?;
+    private pending;
+    private reconnectTimer?;
+    private awarenessSendTimer?;
+    private awarenessDirty;
+    private reconnectDelayMs;
+    private destroyed;
+    private currentStatus;
+    private readonly statusListeners;
+    private currentIdentity?;
+    private readonly identityListeners;
+    private readonly yjsUpdateHandler;
+    private readonly awarenessUpdateHandler;
+    constructor(options: WebSocketYjsProviderOptions);
+    get status(): YjsProviderStatus;
+    get identity(): YjsProviderIdentity | undefined;
+    onIdentity(listener: YjsProviderIdentityListener): () => void;
+    private applyIdentity;
+    onStatus(listener: YjsProviderStatusListener): () => void;
+    private setStatus;
+    destroy(): void;
+    private connect;
+    private scheduleReconnect;
+    private send;
+    private sendNow;
+    private scheduleAwarenessSend;
+    private sendLocalAwarenessNow;
+    private applyMessage;
+}
+//# sourceMappingURL=websocket-yjs-provider.d.ts.map

package/dist/client/websocket-yjs-provider.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"websocket-yjs-provider.d.ts","sourceRoot":"","sources":["../../src/client/websocket-yjs-provider.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAA+C,MAAM,uBAAuB,CAAC;AAC/F,OAAO,KAAK,CAAC,MAAM,KAAK,CAAC;AAEzB,OAAO,KAAK,EAAE,mBAAmB,EAAE,2BAA2B,EAAE,iBAAiB,EAAE,yBAAyB,EAAE,MAAM,sBAAsB,CAAC;AAsB3I,MAAM,WAAW,2BAA2B;IAC1C,IAAI,EAAE,CAAC,CAAC,GAAG,CAAC;IACZ,KAAK,EAAE,MAAM,CAAC;IACd,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,IAAI,EAAE;QACJ,IAAI,EAAE,MAAM,CAAC;QACb,KAAK,CAAC,EAAE,MAAM,CAAC;KAChB,CAAC;IACF,uBAAuB,CAAC,EAAE,MAAM,CAAC;IACjC,mBAAmB,CAAC,EAAE,MAAM,CAAC;IAC7B,mBAAmB,CAAC,EAAE,MAAM,CAAC;CAC9B;AAED,qBAAa,oBAAoB;IAC/B,QAAQ,CAAC,SAAS,EAAE,SAAS,CAAC;IAC9B,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAE1B,OAAO,CAAC,QAAQ,CAAC,OAAO,CAMM;IAC9B,OAAO,CAAC,MAAM,CAAC,CAAY;IAC3B,OAAO,CAAC,OAAO,CAA0B;IACzC,OAAO,CAAC,cAAc,CAAC,CAAgC;IACvD,OAAO,CAAC,kBAAkB,CAAC,CAAgC;IAC3D,OAAO,CAAC,cAAc,CAAS;IAC/B,OAAO,CAAC,gBAAgB,CAAS;IACjC,OAAO,CAAC,SAAS,CAAS;IAC1B,OAAO,CAAC,aAAa,CAAmC;IACxD,OAAO,CAAC,QAAQ,CAAC,eAAe,CAAwC;IACxE,OAAO,CAAC,eAAe,CAAC,CAAsB;IAC9C,OAAO,CAAC,QAAQ,CAAC,iBAAiB,CAA0C;IAE5E,OAAO,CAAC,QAAQ,CAAC,gBAAgB,CAU/B;IAKF,OAAO,CAAC,QAAQ,CAAC,sBAAsB,CAUrC;gBAEU,OAAO,EAAE,2BAA2B;IA0BhD,IAAI,MAAM,IAAI,iBAAiB,CAE9B;IAID,IAAI,QAAQ,IAAI,mBAAmB,GAAG,SAAS,CAE9C;IAGD,UAAU,CAAC,QAAQ,EAAE,2BAA2B,GAAG,MAAM,IAAI;IAK7D,OAAO,CAAC,aAAa;IAYrB,QAAQ,CAAC,QAAQ,EAAE,yBAAyB,GAAG,MAAM,IAAI;IAKzD,OAAO,CAAC,SAAS;IAMjB,OAAO;IA2BP,OAAO,CAAC,OAAO;IAyCf,OAAO,CAAC,iBAAiB;IAezB,OAAO,CAAC,IAAI;IAQZ,OAAO,CAAC,OAAO;IAOf,OAAO,CAAC,qBAAqB;IAkB7B,OAAO,CAAC,qBAAqB;IAY7B,OAAO,CAAC,YAAY;CAqBrB"}

package/dist/client/websocket-yjs-provider.js

@@ -0,0 +1,270 @@
+import { Awareness, applyAwarenessUpdate, encodeAwarenessUpdate } from "y-protocols/awareness";
+import * as Y from "yjs";
+import { makeClientId } from "./id.js";
+const REMOTE_ORIGIN = "websocket-remote";
+const DEFAULT_RECONNECT_INITIAL_DELAY_MS = 500;
+const DEFAULT_RECONNECT_MAX_DELAY_MS = 5000;
+const DEFAULT_AWARENESS_THROTTLE_MS = 150;
+export class WebSocketYjsProvider {
+    awareness;
+    clientId;
+    options;
+    socket;
+    pending = [];
+    reconnectTimer;
+    awarenessSendTimer;
+    awarenessDirty = false;
+    reconnectDelayMs;
+    destroyed = false;
+    currentStatus = "connecting";
+    statusListeners = new Set();
+    currentIdentity;
+    identityListeners = new Set();
+    yjsUpdateHandler = (update, origin) => {
+        if (origin === REMOTE_ORIGIN) {
+            return;
+        }
+        this.send({
+            type: "yjs_update",
+            docId: this.options.docId,
+            clientId: this.clientId,
+            update: bytesToBase64(update),
+        });
+    };
+    // Only push changes to the LOCAL awareness state. Remote states arrive from
+    // the server already fanned out; re-broadcasting them would multiply every
+    // cursor move by the number of connected clients.
+    awarenessUpdateHandler = ({ added, updated, removed }) => {
+        const local = this.awareness.clientID;
+        if (!added.includes(local) && !updated.includes(local) && !removed.includes(local)) {
+            return;
+        }
+        this.scheduleAwarenessSend();
+    };
+    constructor(options) {
+        this.options = {
+            ...options,
+            reconnectInitialDelayMs: options.reconnectInitialDelayMs ?? DEFAULT_RECONNECT_INITIAL_DELAY_MS,
+            reconnectMaxDelayMs: options.reconnectMaxDelayMs ?? DEFAULT_RECONNECT_MAX_DELAY_MS,
+            awarenessThrottleMs: options.awarenessThrottleMs ?? DEFAULT_AWARENESS_THROTTLE_MS,
+        };
+        this.clientId = options.clientId ?? makeClientId();
+        this.reconnectDelayMs = this.options.reconnectInitialDelayMs;
+        this.awareness = new Awareness(options.ydoc);
+        this.awareness.setLocalStateField("user", {
+            name: options.user.name,
+            color: options.user.color,
+        });
+        this.options.ydoc.on("update", this.yjsUpdateHandler);
+        // No extra heartbeat timer: y-protocols renews the local awareness state
+        // (bumping its clock) roughly every 15s while idle, which fires this
+        // handler. A fixed-interval resend of the same clock would be ignored by
+        // receivers anyway.
+        this.awareness.on("update", this.awarenessUpdateHandler);
+        this.connect();
+    }
+    get status() {
+        return this.currentStatus;
+    }
+    // Server-assigned presence identity; undefined until the join is
+    // acknowledged.
+    get identity() {
+        return this.currentIdentity;
+    }
+    // Returns an unsubscribe function.
+    onIdentity(listener) {
+        this.identityListeners.add(listener);
+        return () => this.identityListeners.delete(listener);
+    }
+    applyIdentity(name, color) {
+        if (!name && !color)
+            return;
+        const identity = {
+            name: name || this.options.user.name,
+            color: color ?? this.options.user.color,
+        };
+        this.currentIdentity = identity;
+        this.awareness.setLocalStateField("user", { name: identity.name, color: identity.color });
+        for (const listener of this.identityListeners)
+            listener(identity);
+    }
+    // Returns an unsubscribe function.
+    onStatus(listener) {
+        this.statusListeners.add(listener);
+        return () => this.statusListeners.delete(listener);
+    }
+    setStatus(status) {
+        if (this.currentStatus === status)
+            return;
+        this.currentStatus = status;
+        for (const listener of this.statusListeners)
+            listener(status);
+    }
+    destroy() {
+        if (this.destroyed)
+            return;
+        this.options.ydoc.off("update", this.yjsUpdateHandler);
+        this.awareness.off("update", this.awarenessUpdateHandler);
+        // Announce departure while the socket is still usable so peers drop the
+        // cursor immediately instead of after the 30s awareness timeout.
+        this.awareness.setLocalState(null);
+        if (this.socket?.readyState === WebSocket.OPEN) {
+            this.sendNow({
+                type: "awareness_update",
+                docId: this.options.docId,
+                clientId: this.clientId,
+                update: bytesToBase64(encodeAwarenessUpdate(this.awareness, [this.awareness.clientID])),
+            });
+            this.sendNow({ type: "leave", docId: this.options.docId, clientId: this.clientId });
+        }
+        this.destroyed = true;
+        this.setStatus("disconnected");
+        if (this.reconnectTimer) {
+            clearTimeout(this.reconnectTimer);
+        }
+        if (this.awarenessSendTimer) {
+            clearTimeout(this.awarenessSendTimer);
+        }
+        this.socket?.close();
+    }
+    connect() {
+        if (this.destroyed) {
+            return;
+        }
+        this.setStatus("connecting");
+        const socket = new WebSocket(this.options.url ?? websocketURL(this.options.baseUrl));
+        this.socket = socket;
+        socket.addEventListener("open", () => {
+            this.setStatus("connected");
+            this.reconnectDelayMs = this.options.reconnectInitialDelayMs;
+            this.sendNow({
+                type: "join",
+                docId: this.options.docId,
+                clientId: this.clientId,
+                stateVector: bytesToBase64(Y.encodeStateVector(this.options.ydoc)),
+                userName: this.options.user.name,
+                userColor: this.options.user.color,
+            });
+            this.sendLocalAwarenessNow();
+            for (const message of this.pending.splice(0)) {
+                this.sendNow(message);
+            }
+        });
+        socket.addEventListener("message", (event) => {
+            if (typeof event.data !== "string") {
+                return;
+            }
+            this.applyMessage(JSON.parse(event.data));
+        });
+        socket.addEventListener("close", () => {
+            if (this.socket === socket) {
+                this.socket = undefined;
+            }
+            this.setStatus("disconnected");
+            this.scheduleReconnect();
+        });
+        socket.addEventListener("error", () => {
+            socket.close();
+        });
+    }
+    scheduleReconnect() {
+        if (this.destroyed || this.reconnectTimer) {
+            return;
+        }
+        const delay = this.reconnectDelayMs;
+        this.reconnectDelayMs = Math.min(this.reconnectDelayMs * 2, this.options.reconnectMaxDelayMs);
+        this.reconnectTimer = setTimeout(() => {
+            this.reconnectTimer = undefined;
+            this.connect();
+        }, delay);
+    }
+    send(message) {
+        if (this.socket?.readyState === WebSocket.OPEN) {
+            this.sendNow(message);
+            return;
+        }
+        this.pending.push(message);
+    }
+    sendNow(message) {
+        this.socket?.send(JSON.stringify(message));
+    }
+    // Leading + trailing throttle: the first change sends immediately, changes
+    // arriving inside the window (e.g. cursor movement while typing or
+    // selecting) collapse into one trailing send.
+    scheduleAwarenessSend() {
+        if (this.destroyed) {
+            return;
+        }
+        if (this.awarenessSendTimer) {
+            this.awarenessDirty = true;
+            return;
+        }
+        this.sendLocalAwarenessNow();
+        this.awarenessSendTimer = setTimeout(() => {
+            this.awarenessSendTimer = undefined;
+            if (this.awarenessDirty) {
+                this.awarenessDirty = false;
+                this.scheduleAwarenessSend();
+            }
+        }, this.options.awarenessThrottleMs);
+    }
+    sendLocalAwarenessNow() {
+        if (this.destroyed) {
+            return;
+        }
+        this.send({
+            type: "awareness_update",
+            docId: this.options.docId,
+            clientId: this.clientId,
+            update: bytesToBase64(encodeAwarenessUpdate(this.awareness, [this.awareness.clientID])),
+        });
+    }
+    applyMessage(message) {
+        switch (message.type) {
+            case "joined":
+                this.applyIdentity(message.userName, message.userColor);
+                break;
+            case "sync_update":
+            case "yjs_update":
+                if (message.update) {
+                    Y.applyUpdate(this.options.ydoc, base64ToBytes(message.update), REMOTE_ORIGIN);
+                }
+                break;
+            case "awareness_update":
+                if (message.update) {
+                    applyAwarenessUpdate(this.awareness, base64ToBytes(message.update), REMOTE_ORIGIN);
+                }
+                break;
+            case "error":
+                console.error("Yjs WebSocket server error", message.errorCode, message.errorMessage);
+                break;
+        }
+    }
+}
+function websocketURL(baseUrl) {
+    const fallback = typeof window !== "undefined" && window.location?.origin
+        ? window.location.origin
+        : "http://localhost:8080";
+    const url = new URL(baseUrl ?? fallback);
+    url.protocol = url.protocol === "https:" ? "wss:" : "ws:";
+    url.pathname = "/ysync/ws";
+    url.search = "";
+    url.hash = "";
+    return url.toString();
+}
+function bytesToBase64(bytes) {
+    let binary = "";
+    for (let i = 0; i < bytes.length; i += 0x8000) {
+        binary += String.fromCharCode(...bytes.subarray(i, i + 0x8000));
+    }
+    return btoa(binary);
+}
+function base64ToBytes(base64) {
+    const binary = atob(base64);
+    const bytes = new Uint8Array(binary.length);
+    for (let i = 0; i < binary.length; i++) {
+        bytes[i] = binary.charCodeAt(i);
+    }
+    return bytes;
+}
+//# sourceMappingURL=websocket-yjs-provider.js.map

package/dist/client/websocket-yjs-provider.js.map

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

package/dist/compaction/cli.d.ts

@@ -0,0 +1,3 @@
+#!/usr/bin/env node
+export {};
+//# sourceMappingURL=cli.d.ts.map

package/dist/compaction/cli.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cli.d.ts","sourceRoot":"","sources":["../../src/compaction/cli.ts"],"names":[],"mappings":""}

package/dist/compaction/cli.js

@@ -0,0 +1,124 @@
+#!/usr/bin/env node
+// ysync-compact: compaction CLI over the programmatic adapter in
+// compaction.ts, for cron-style schedulers (Kubernetes CronJob, systemd
+// timers). Lambda/Cloud Run users should import `compactDocuments` directly.
+//
+// Usage:
+//   ysync-compact --base-url http://localhost:8080 --docs doc-1,doc-2
+//   ysync-compact --base-url ... --docs -            # doc IDs from stdin, one per line
+//   ysync-compact --base-url ... --docs ... \
+//     [--threshold 200] [--keep 50] \
+//     [--header 'authorization: Bearer ...']... [--user-id compact-sidecar]
+//
+// Exits 0 when every document succeeded, 1 when any document failed, 2 on
+// usage errors. Gate the server's Authz.CanCompact to this job's identity.
+import { compactDocuments } from "./compaction.js";
+async function main() {
+    let args;
+    try {
+        args = parseArgs(process.argv.slice(2));
+    }
+    catch (error) {
+        console.error(String(error instanceof Error ? error.message : error));
+        return 2;
+    }
+    if (!args.baseUrl || !args.docs) {
+        console.error("usage: ysync-compact --base-url URL --docs id1,id2|- [--threshold N] " +
+            "[--keep N] [--header 'name: value']... [--user-id ID]");
+        return 2;
+    }
+    const docIds = args.docs === "-"
+        ? (await readStdin()).split("\n").map((line) => line.trim())
+        : args.docs.split(",").map((docId) => docId.trim());
+    const filtered = docIds.filter((docId) => docId.length > 0);
+    if (filtered.length === 0) {
+        console.error("no document IDs given");
+        return 2;
+    }
+    const headers = { ...args.headers };
+    if (args.userId) {
+        // Demo identity hint; real deployments attach identity via auth
+        // middleware and pass the credential with --header instead.
+        headers["x-user-id"] = args.userId;
+    }
+    const run = await compactDocuments({
+        baseUrl: args.baseUrl,
+        headers,
+        threshold: args.threshold === undefined ? undefined : parseCount("--threshold", args.threshold),
+        keep: args.keep === undefined ? undefined : parseCount("--keep", args.keep),
+    }, filtered);
+    for (const result of run.results) {
+        if (result.compacted) {
+            console.log(`${result.docId}: folded ${result.foldedRecords}/${result.records} records ` +
+                `through sequence ${result.foldedThroughSequence} into a ` +
+                `${result.snapshotBytes}-byte snapshot`);
+        }
+        else {
+            console.log(`${result.docId}: ${result.records} records, nothing to do`);
+        }
+    }
+    for (const failure of run.errors) {
+        console.error(`${failure.docId}: ${String(failure.error)}`);
+    }
+    return run.errors.length > 0 ? 1 : 0;
+}
+function parseArgs(argv) {
+    const args = { headers: {} };
+    for (let i = 0; i < argv.length; i++) {
+        const flag = argv[i];
+        const value = argv[i + 1];
+        if (!flag.startsWith("--") || value === undefined) {
+            throw new Error(`unexpected argument: ${flag}`);
+        }
+        i++;
+        switch (flag) {
+            case "--base-url":
+                args.baseUrl = value;
+                break;
+            case "--docs":
+                args.docs = value;
+                break;
+            case "--threshold":
+                args.threshold = value;
+                break;
+            case "--keep":
+                args.keep = value;
+                break;
+            case "--user-id":
+                args.userId = value;
+                break;
+            case "--header": {
+                const colon = value.indexOf(":");
+                if (colon < 1) {
+                    throw new Error(`--header expects 'name: value', got ${JSON.stringify(value)}`);
+                }
+                args.headers[value.slice(0, colon).trim()] = value.slice(colon + 1).trim();
+                break;
+            }
+            default:
+                throw new Error(`unknown flag: ${flag}`);
+        }
+    }
+    return args;
+}
+function parseCount(flag, value) {
+    const parsed = Number(value);
+    if (!Number.isInteger(parsed) || parsed < 0) {
+        throw new Error(`${flag} expects a non-negative integer, got ${JSON.stringify(value)}`);
+    }
+    return parsed;
+}
+function readStdin() {
+    return new Promise((resolve, reject) => {
+        let data = "";
+        process.stdin.setEncoding("utf8");
+        process.stdin.on("data", (chunk) => (data += chunk));
+        process.stdin.on("end", () => resolve(data));
+        process.stdin.on("error", reject);
+    });
+}
+main().then((code) => process.exit(code), (error) => {
+    console.error(String(error));
+    process.exit(1);
+});
+//# sourceMappingURL=cli.js.map

package/dist/compaction/cli.js.map

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

package/dist/compaction/compaction.d.ts

@@ -0,0 +1,67 @@
+/** How to reach the ysync server and authenticate against it. */
+export interface CompactionClientOptions {
+    /** Server base URL, e.g. "http://localhost:8080". */
+    baseUrl: string;
+    /**
+     * Extra request headers (an authenticated identity that passes
+     * `Authz.CanCompact`). A function is awaited per request, so short-lived
+     * tokens can be refreshed.
+     */
+    headers?: Record<string, string> | (() => Record<string, string> | Promise<Record<string, string>>);
+    /** Override the fetch implementation (tests, custom agents). */
+    fetch?: typeof globalThis.fetch;
+}
+/** When and how much to fold. Zero-config defaults match examples/compact-docs. */
+export interface CompactionPolicy {
+    /**
+     * Compact only when the document has more than this many log records
+     * (snapshot record included). Default 200.
+     */
+    threshold?: number;
+    /**
+     * Newest records to keep individually attributed for change history.
+     * Default 50.
+     */
+    keep?: number;
+}
+export interface CompactDocumentOptions extends CompactionClientOptions, CompactionPolicy {
+}
+export interface CompactDocumentResult {
+    docId: string;
+    /** False when the log was at or below the threshold (nothing folded). */
+    compacted: boolean;
+    /** Log records before compaction. */
+    records: number;
+    /** Records folded into the snapshot (set when compacted). */
+    foldedRecords?: number;
+    /** Sequence the log was folded through (set when compacted). */
+    foldedThroughSequence?: string;
+    /** Encoded snapshot size in bytes (set when compacted). */
+    snapshotBytes?: number;
+}
+export interface CompactionRunResult {
+    results: CompactDocumentResult[];
+    /** Per-document failures; one bad document never aborts the run. */
+    errors: {
+        docId: string;
+        error: unknown;
+    }[];
+    compacted: number;
+    skipped: number;
+}
+/**
+ * Compacts one document if its update log exceeds the policy threshold:
+ * lists the stored log, replays all but the newest `keep` records into a
+ * fresh Y.Doc, encodes the state with `Y.encodeStateAsUpdate`, and calls
+ * `CompactDocument` for the covered sequence. Idempotent — re-running
+ * converges to the same folded log, and updates pushed concurrently are
+ * unaffected (they sort after `compactThroughSequence`).
+ */
+export declare function compactDocument(options: CompactDocumentOptions, docId: string): Promise<CompactDocumentResult>;
+/**
+ * Compacts many documents sequentially (compaction is background work;
+ * predictable server load beats speed here). Per-document failures are
+ * collected in `errors` instead of aborting the run.
+ */
+export declare function compactDocuments(options: CompactDocumentOptions, docIds: Iterable<string>): Promise<CompactionRunResult>;
+//# sourceMappingURL=compaction.d.ts.map

package/dist/compaction/compaction.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"compaction.d.ts","sourceRoot":"","sources":["../../src/compaction/compaction.ts"],"names":[],"mappings":"AAmBA,iEAAiE;AACjE,MAAM,WAAW,uBAAuB;IACtC,qDAAqD;IACrD,OAAO,EAAE,MAAM,CAAC;IAChB;;;;OAIG;IACH,OAAO,CAAC,EACJ,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GACtB,CAAC,MAAM,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,CAAC,CAAC;IACrE,gEAAgE;IAChE,KAAK,CAAC,EAAE,OAAO,UAAU,CAAC,KAAK,CAAC;CACjC;AAED,mFAAmF;AACnF,MAAM,WAAW,gBAAgB;IAC/B;;;OAGG;IACH,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB;;;OAGG;IACH,IAAI,CAAC,EAAE,MAAM,CAAC;CACf;AAED,MAAM,WAAW,sBACf,SAAQ,uBAAuB,EAC7B,gBAAgB;CAAG;AAEvB,MAAM,WAAW,qBAAqB;IACpC,KAAK,EAAE,MAAM,CAAC;IACd,yEAAyE;IACzE,SAAS,EAAE,OAAO,CAAC;IACnB,qCAAqC;IACrC,OAAO,EAAE,MAAM,CAAC;IAChB,6DAA6D;IAC7D,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,gEAAgE;IAChE,qBAAqB,CAAC,EAAE,MAAM,CAAC;IAC/B,2DAA2D;IAC3D,aAAa,CAAC,EAAE,MAAM,CAAC;CACxB;AAED,MAAM,WAAW,mBAAmB;IAClC,OAAO,EAAE,qBAAqB,EAAE,CAAC;IACjC,oEAAoE;IACpE,MAAM,EAAE;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,OAAO,CAAA;KAAE,EAAE,CAAC;IAC5C,SAAS,EAAE,MAAM,CAAC;IAClB,OAAO,EAAE,MAAM,CAAC;CACjB;AAWD;;;;;;;GAOG;AACH,wBAAsB,eAAe,CACnC,OAAO,EAAE,sBAAsB,EAC/B,KAAK,EAAE,MAAM,GACZ,OAAO,CAAC,qBAAqB,CAAC,CAuDhC;AAED;;;;GAIG;AACH,wBAAsB,gBAAgB,CACpC,OAAO,EAAE,sBAAsB,EAC/B,MAAM,EAAE,QAAQ,CAAC,MAAM,CAAC,GACvB,OAAO,CAAC,mBAAmB,CAAC,CAqB9B"}