craftdriver 1.2.0 → 1.4.0

package/dist/lib/electronFuses.js

@@ -0,0 +1,118 @@
+/**
+ * Dependency-free reader for the Electron **fuse wire** — specifically the
+ * `EnableNodeCliInspectArguments` fuse that main-process access
+ * (`browser.electron.executeMain` / `mock` / `mockDialog` / `mainLogs`) needs. When
+ * the main-process inspector can't be reached, this turns the generic "inspector
+ * unreachable" into a precise "the fuse is disabled in this build."
+ *
+ * The wire format is @electron/fuses' own (verified against a real packaged app):
+ * a 32-byte sentinel, then a 1-byte wire version, a 1-byte fuse count, then one
+ * ASCII byte per fuse — `'0'` disabled, `'1'` enabled, `'r'` removed.
+ * `EnableNodeCliInspectArguments` is fuse index 3. On macOS the wire lives in the
+ * **Electron Framework**, not the app executable. We read the bytes directly rather
+ * than take an `@electron/fuses` dependency (craftdriver keeps two runtime deps).
+ *
+ * Best-effort by design: any read/parse problem yields `'unknown'`, so this can only
+ * ever *improve* a diagnostic, never invent or block one.
+ */
+import fs from 'node:fs';
+import path from 'node:path';
+/** @electron/fuses sentinel that precedes the fuse wire in a packaged binary. */
+const SENTINEL = 'dL7pKGdnNz796PbbjQWNKmHXBZaB9tsX';
+const FUSE_DISABLE = 0x30; // '0'
+const FUSE_ENABLE = 0x31; // '1'
+const FUSE_REMOVED = 0x72; // 'r'
+/** Index of EnableNodeCliInspectArguments in the FuseV1 wire. */
+const INSPECT_ARGS_INDEX = 3;
+/**
+ * The binary that actually carries the fuse wire for a given app executable. On
+ * macOS that's the Electron Framework inside the `.app`; elsewhere it's the
+ * executable itself.
+ */
+export function fuseCarrierBinary(appBinaryPath) {
+    const FRAMEWORK = ['Frameworks', 'Electron Framework.framework', 'Electron Framework'];
+    if (appBinaryPath.endsWith('.app')) {
+        return path.join(appBinaryPath, 'Contents', ...FRAMEWORK);
+    }
+    if (appBinaryPath.includes('.app/') || appBinaryPath.includes(`.app${path.sep}`)) {
+        // .../Contents/MacOS/<exe> -> .../Contents/Frameworks/Electron Framework.framework/…
+        return path.resolve(appBinaryPath, '..', '..', ...FRAMEWORK);
+    }
+    return appBinaryPath;
+}
+/**
+ * Read the `EnableNodeCliInspectArguments` fuse straight from the packaged binary.
+ * Returns `'unknown'` for any older/unfused binary or on any read problem.
+ */
+export function readInspectArgumentsFuse(appBinaryPath) {
+    if (!appBinaryPath)
+        return 'unknown';
+    let fd;
+    try {
+        const binary = fuseCarrierBinary(appBinaryPath);
+        if (!fs.existsSync(binary))
+            return 'unknown';
+        fd = fs.openSync(binary, 'r');
+        const sentinelPos = findSentinel(fd);
+        if (sentinelPos === -1)
+            return 'unknown';
+        // After the sentinel: [version][count][fuse0][fuse1]… — read up to our fuse.
+        const wire = Buffer.alloc(2 + INSPECT_ARGS_INDEX + 1);
+        const read = fs.readSync(fd, wire, 0, wire.length, sentinelPos + SENTINEL.length);
+        if (read < wire.length)
+            return 'unknown';
+        const count = wire[1];
+        if (INSPECT_ARGS_INDEX >= count)
+            return 'unknown';
+        switch (wire[2 + INSPECT_ARGS_INDEX]) {
+            case FUSE_ENABLE:
+                return 'enabled';
+            case FUSE_DISABLE:
+                return 'disabled';
+            case FUSE_REMOVED:
+                return 'removed';
+            default:
+                return 'unknown';
+        }
+    }
+    catch {
+        return 'unknown';
+    }
+    finally {
+        if (fd !== undefined) {
+            try {
+                fs.closeSync(fd);
+            }
+            catch {
+                /* ignore */
+            }
+        }
+    }
+}
+/**
+ * Scan a file for the sentinel, returning its byte offset or -1. Chunked with an
+ * overlap so a sentinel split across chunk boundaries is still found (the framework
+ * binary can be hundreds of MB — never buffer the whole thing).
+ */
+function findSentinel(fd) {
+    const needle = Buffer.from(SENTINEL, 'binary');
+    const overlap = needle.length - 1;
+    const CHUNK = 1 << 20; // 1 MiB
+    const buf = Buffer.alloc(CHUNK + overlap);
+    let filePos = 0;
+    let carry = 0; // bytes retained from the previous chunk's tail
+    for (;;) {
+        const read = fs.readSync(fd, buf, carry, CHUNK, filePos);
+        if (read <= 0)
+            return -1;
+        const searchable = carry + read;
+        const idx = buf.subarray(0, searchable).indexOf(needle);
+        if (idx !== -1)
+            return filePos - carry + idx;
+        // Retain the last `overlap` bytes so a boundary-straddling match is caught next round.
+        buf.copy(buf, 0, searchable - overlap, searchable);
+        carry = overlap;
+        filePos += read;
+    }
+}
+//# sourceMappingURL=electronFuses.js.map

package/dist/lib/electronFuses.js.map

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

package/dist/lib/electronMainBridge.d.ts

@@ -0,0 +1,28 @@
+/** A CDP event frame (no `id`), forwarded to a listener instead of being dropped. */
+export type CdpEventListener = (method: string, params: Record<string, unknown>) => void;
+export declare class ElectronMainBridge {
+    #private;
+    constructor(host: string, port: number);
+    get isConnected(): boolean;
+    /**
+     * Register a listener for CDP event frames (those without an `id`, e.g.
+     * `Runtime.consoleAPICalled`). Used by the main-process log capture; set it
+     * before {@link enableRuntime} so the replayed backlog isn't missed.
+     */
+    onEvent(listener: CdpEventListener): void;
+    /**
+     * Enable the CDP `Runtime` domain so the inspector starts (and replays any
+     * buffered) `consoleAPICalled` / `exceptionThrown` events. Idempotent.
+     */
+    enableRuntime(timeoutMs?: number): Promise<void>;
+    /** Fetch the inspector's WebSocket URL and connect to it. */
+    connect(timeoutMs?: number): Promise<void>;
+    /**
+     * Evaluate `fn(electron, ...args)` in the main process and return its (JSON-
+     * serializable) result. `awaitPromise` supports async callbacks. A throw in the
+     * main process becomes {@link ErrorCode.ELECTRON_MAIN_THREW}.
+     */
+    executeMain(fnSource: string, args: unknown[], timeoutMs?: number): Promise<unknown>;
+    close(): Promise<void>;
+}
+//# sourceMappingURL=electronMainBridge.d.ts.map

package/dist/lib/electronMainBridge.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"electronMainBridge.d.ts","sourceRoot":"","sources":["../../src/lib/electronMainBridge.ts"],"names":[],"mappings":"AAwCA,qFAAqF;AACrF,MAAM,MAAM,gBAAgB,GAAG,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,KAAK,IAAI,CAAC;AAEzF,qBAAa,kBAAkB;;gBAYjB,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM;IAKtC,IAAI,WAAW,IAAI,OAAO,CAEzB;IAED;;;;OAIG;IACH,OAAO,CAAC,QAAQ,EAAE,gBAAgB,GAAG,IAAI;IAIzC;;;OAGG;IACG,aAAa,CAAC,SAAS,SAA6B,GAAG,OAAO,CAAC,IAAI,CAAC;IAI1E,6DAA6D;IACvD,OAAO,CAAC,SAAS,SAA6B,GAAG,OAAO,CAAC,IAAI,CAAC;IAqEpE;;;;OAIG;IACG,WAAW,CACf,QAAQ,EAAE,MAAM,EAChB,IAAI,EAAE,OAAO,EAAE,EACf,SAAS,SAA6B,GACrC,OAAO,CAAC,OAAO,CAAC;IA6Bb,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;CA4H7B"}

package/dist/lib/electronMainBridge.js

@@ -0,0 +1,270 @@
+/**
+ * Minimal CDP bridge to an Electron app's **main-process** Node inspector, the
+ * transport behind `browser.electron.executeMain()`. The app is launched with
+ * `--inspect=<host>:<port>` (see Browser.launch's electron path); this connects
+ * to that inspector and evaluates user callbacks in the main process with the
+ * `electron` module injected as the first callback argument.
+ *
+ * Deliberately tiny — no `@electron/fuses` dependency and no full CDP client. If
+ * the inspector isn't reachable (fuse disabled, wrong port), connect() fails with
+ * an actionable {@link ErrorCode.ELECTRON_MAIN_UNAVAILABLE}.
+ */
+import http from 'node:http';
+import { WebSocket } from 'ws';
+import { CraftdriverError, ErrorCode } from './errors.js';
+const DEFAULT_CONNECT_TIMEOUT_MS = 10_000;
+const DEFAULT_EXECUTE_TIMEOUT_MS = 30_000;
+/** Guard against a runaway return value flooding the socket (32 MB). */
+const MAX_PAYLOAD_BYTES = 32 * 1024 * 1024;
+const INSPECTOR_CONNECT_POLL_MS = 100;
+export class ElectronMainBridge {
+    #host;
+    #port;
+    #ws;
+    #nextId = 1;
+    #connected = false;
+    #onEvent;
+    #pending = new Map();
+    constructor(host, port) {
+        this.#host = host;
+        this.#port = port;
+    }
+    get isConnected() {
+        return this.#connected;
+    }
+    /**
+     * Register a listener for CDP event frames (those without an `id`, e.g.
+     * `Runtime.consoleAPICalled`). Used by the main-process log capture; set it
+     * before {@link enableRuntime} so the replayed backlog isn't missed.
+     */
+    onEvent(listener) {
+        this.#onEvent = listener;
+    }
+    /**
+     * Enable the CDP `Runtime` domain so the inspector starts (and replays any
+     * buffered) `consoleAPICalled` / `exceptionThrown` events. Idempotent.
+     */
+    async enableRuntime(timeoutMs = DEFAULT_EXECUTE_TIMEOUT_MS) {
+        await this.#send('Runtime.enable', {}, timeoutMs);
+    }
+    /** Fetch the inspector's WebSocket URL and connect to it. */
+    async connect(timeoutMs = DEFAULT_CONNECT_TIMEOUT_MS) {
+        if (this.#connected)
+            return;
+        const deadline = Date.now() + timeoutMs;
+        let targets;
+        let wsUrl;
+        let lastCause;
+        while (Date.now() < deadline) {
+            try {
+                targets = await this.#httpJson(`http://${this.#host}:${this.#port}/json/list`, Math.max(1, deadline - Date.now()));
+                wsUrl = targets.find((t) => t.webSocketDebuggerUrl)?.webSocketDebuggerUrl;
+                if (wsUrl)
+                    break;
+                lastCause = new Error('inspector exposed no debug target yet');
+            }
+            catch (cause) {
+                lastCause = cause;
+            }
+            await delay(Math.min(INSPECTOR_CONNECT_POLL_MS, Math.max(0, deadline - Date.now())));
+        }
+        if (!wsUrl && !targets) {
+            throw this.#unavailable(`Could not reach the Electron main-process inspector at ${this.#host}:${this.#port}.`, lastCause);
+        }
+        if (!wsUrl) {
+            throw this.#unavailable(`The Electron main-process inspector at ${this.#host}:${this.#port} exposed no debug target.`, lastCause);
+        }
+        const wsTimeoutMs = Math.max(1, deadline - Date.now());
+        await new Promise((resolve, reject) => {
+            const ws = new WebSocket(wsUrl, { maxPayload: MAX_PAYLOAD_BYTES });
+            const timer = setTimeout(() => {
+                ws.terminate();
+                reject(this.#unavailable(`Timed out connecting to the main-process inspector after ${wsTimeoutMs}ms.`));
+            }, wsTimeoutMs);
+            ws.once('open', () => {
+                clearTimeout(timer);
+                this.#ws = ws;
+                this.#connected = true;
+                ws.on('message', (data) => this.#onMessage(data));
+                ws.on('close', () => {
+                    this.#connected = false;
+                    this.#failAllPending(new Error('main-process inspector socket closed'));
+                });
+                ws.on('error', () => {
+                    /* surfaced per-request via reject/close */
+                });
+                resolve();
+            });
+            ws.once('error', (err) => {
+                clearTimeout(timer);
+                reject(this.#unavailable('Failed to open the main-process inspector socket.', err));
+            });
+        });
+    }
+    /**
+     * Evaluate `fn(electron, ...args)` in the main process and return its (JSON-
+     * serializable) result. `awaitPromise` supports async callbacks. A throw in the
+     * main process becomes {@link ErrorCode.ELECTRON_MAIN_THREW}.
+     */
+    async executeMain(fnSource, args, timeoutMs = DEFAULT_EXECUTE_TIMEOUT_MS) {
+        if (!this.#connected)
+            throw this.#unavailable('Main-process bridge is not connected.');
+        // Resolve the electron module inline via the inspector's CommandLineAPI
+        // `require` (needs includeCommandLineAPI) and pass it as the callback's first
+        // arg. Args ride as a JSON literal spread into the call; the caller validates
+        // serializability first (EVAL_BAD_ARG), matching browser.evaluate().
+        const expression = `(${fnSource})(require('electron'), ...${JSON.stringify(args)})`;
+        const res = await this.#send('Runtime.evaluate', {
+            expression,
+            awaitPromise: true, // resolve async callbacks before returning
+            returnByValue: true,
+            includeCommandLineAPI: true, // exposes `require` in the eval
+        }, timeoutMs);
+        if (res.exceptionDetails) {
+            const message = res.exceptionDetails.exception?.description ?? res.exceptionDetails.text ?? 'unknown error';
+            throw new CraftdriverError(ErrorCode.ELECTRON_MAIN_THREW, `electron.executeMain() callback threw in the main process: ${message}`, { detail: { host: this.#host, port: this.#port } });
+        }
+        return deserializeResult(res.result);
+    }
+    async close() {
+        this.#connected = false;
+        this.#failAllPending(new Error('main-process bridge closed'));
+        const ws = this.#ws;
+        this.#ws = undefined;
+        if (!ws)
+            return;
+        await new Promise((resolve) => {
+            ws.once('close', () => resolve());
+            ws.close();
+            // Don't hang teardown on a half-open socket.
+            setTimeout(() => {
+                ws.terminate();
+                resolve();
+            }, 1_000).unref?.();
+        });
+    }
+    #send(method, params, timeoutMs) {
+        return new Promise((resolve, reject) => {
+            const ws = this.#ws;
+            if (!ws) {
+                reject(this.#unavailable('Main-process bridge is not connected.'));
+                return;
+            }
+            const id = this.#nextId++;
+            const timer = setTimeout(() => {
+                this.#pending.delete(id);
+                reject(new CraftdriverError(ErrorCode.ELECTRON_MAIN_UNAVAILABLE, `Main-process command "${method}" timed out after ${timeoutMs}ms.`));
+            }, timeoutMs);
+            this.#pending.set(id, { resolve, reject, timer });
+            ws.send(JSON.stringify({ id, method, params }), (err) => {
+                if (err) {
+                    const p = this.#pending.get(id);
+                    if (p) {
+                        clearTimeout(p.timer);
+                        this.#pending.delete(id);
+                    }
+                    reject(this.#unavailable(`Failed to send "${method}" to the main process.`, err));
+                }
+            });
+        });
+    }
+    #onMessage(data) {
+        let msg;
+        try {
+            msg = JSON.parse(String(data));
+        }
+        catch {
+            return; // ignore non-JSON frames
+        }
+        if (typeof msg.id !== 'number') {
+            // An inspector event (e.g. Runtime.consoleAPICalled), not a command reply.
+            if (msg.method && this.#onEvent)
+                this.#onEvent(msg.method, msg.params ?? {});
+            return;
+        }
+        const pending = this.#pending.get(msg.id);
+        if (!pending)
+            return;
+        clearTimeout(pending.timer);
+        this.#pending.delete(msg.id);
+        if (msg.error) {
+            pending.reject(new CraftdriverError(ErrorCode.ELECTRON_MAIN_UNAVAILABLE, `Main-process inspector error: ${msg.error.message ?? 'unknown'}`));
+        }
+        else {
+            pending.resolve(msg.result ?? {});
+        }
+    }
+    #failAllPending(error) {
+        for (const { reject, timer } of this.#pending.values()) {
+            clearTimeout(timer);
+            reject(error);
+        }
+        this.#pending.clear();
+    }
+    #httpJson(url, timeoutMs) {
+        return new Promise((resolve, reject) => {
+            const req = http.get(url, (res) => {
+                if (res.statusCode !== 200) {
+                    res.resume();
+                    reject(new Error(`inspector /json/list returned HTTP ${res.statusCode ?? 'unknown'}`));
+                    return;
+                }
+                let body = '';
+                res.on('data', (c) => (body += c));
+                res.on('end', () => {
+                    try {
+                        resolve(JSON.parse(body));
+                    }
+                    catch (e) {
+                        reject(e instanceof Error ? e : new Error(String(e)));
+                    }
+                });
+            });
+            req.setTimeout(timeoutMs, () => req.destroy(new Error(`inspector /json/list timed out after ${timeoutMs}ms`)));
+            req.on('error', reject);
+        });
+    }
+    #unavailable(message, cause) {
+        return new CraftdriverError(ErrorCode.ELECTRON_MAIN_UNAVAILABLE, message, {
+            cause,
+            hint: 'Enable main-process access with `electron: { mainProcess: true }`, and ensure the app ' +
+                'build keeps the EnableNodeCliInspectArguments fuse enabled (the default).',
+            detail: { host: this.#host, port: this.#port },
+        });
+    }
+}
+function delay(ms) {
+    return new Promise((resolve) => setTimeout(resolve, ms));
+}
+function deserializeResult(result) {
+    if (!result || result.type === 'undefined')
+        return undefined;
+    if (result.subtype === 'null')
+        return null;
+    if (result.unserializableValue !== undefined) {
+        throw nonSerializableResult(result, result.unserializableValue);
+    }
+    if (result.type === 'string' || result.type === 'boolean')
+        return result.value;
+    if (result.type === 'number') {
+        if (typeof result.value === 'number' && Number.isFinite(result.value))
+            return result.value;
+        throw nonSerializableResult(result);
+    }
+    if (result.type === 'object' && result.value !== undefined)
+        return result.value;
+    throw nonSerializableResult(result);
+}
+function nonSerializableResult(result, detailValue) {
+    const returnedType = result.subtype ?? result.type;
+    const suffix = detailValue ? ` (${detailValue})` : '';
+    return new CraftdriverError(ErrorCode.EVAL_BAD_ARG, `executeMain() returned ${returnedType}${suffix}, which is not JSON-serializable. ` +
+        'Return a primitive, array, or plain object instead.', {
+        detail: {
+            returnedType,
+            description: result.description,
+            unserializableValue: result.unserializableValue,
+        },
+    });
+}
+//# sourceMappingURL=electronMainBridge.js.map

package/dist/lib/electronMainBridge.js.map

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

package/dist/lib/electronMainLogs.d.ts

@@ -0,0 +1,81 @@
+/** Normalized level for a main-process log entry. */
+export type ElectronMainLogLevel = 'log' | 'debug' | 'info' | 'warn' | 'error';
+export interface ElectronMainLog {
+    /** `console` for a `console.*` call; `exception` for an uncaught error the inspector reported. */
+    type: 'console' | 'exception';
+    /** Normalized level. `error` covers `console.error`/`console.assert` and every `exception`. */
+    level: ElectronMainLogLevel;
+    /** Human-readable, space-joined message text (arguments stringified like the console does). */
+    text: string;
+    /** Best-effort deserialized arguments: primitives by value, complex values as their description string. */
+    args: unknown[];
+    /** When the inspector reported the entry. */
+    timestamp: Date;
+    /** Raw CDP console method for `console` entries (`log`, `warning`, `error`, `trace`, …); absent for exceptions. */
+    method?: string;
+    /** Formatted call stack, when the inspector provided one. */
+    stackTrace?: string;
+}
+export type ElectronMainLogHandler = (log: ElectronMainLog) => void;
+/** Shapes of the two CDP Runtime events we ingest (only the fields we read). */
+interface CdpRemoteObject {
+    type: string;
+    subtype?: string;
+    value?: unknown;
+    description?: string;
+}
+interface CdpStackTrace {
+    callFrames?: Array<{
+        functionName?: string;
+        url?: string;
+        lineNumber?: number;
+        columnNumber?: number;
+    }>;
+}
+export interface ConsoleApiCalledParams {
+    type?: string;
+    args?: CdpRemoteObject[];
+    timestamp?: number;
+    stackTrace?: CdpStackTrace;
+}
+export interface ExceptionThrownParams {
+    timestamp?: number;
+    exceptionDetails?: {
+        text?: string;
+        exception?: {
+            description?: string;
+            value?: unknown;
+        };
+        stackTrace?: CdpStackTrace;
+    };
+}
+/**
+ * Buffers and dispatches main-process log entries. Reachable via
+ * `browser.electron.mainLogs`; its public surface mirrors the renderer
+ * {@link LogMonitor} so console monitoring reads the same in both processes.
+ */
+export declare class ElectronMainLogMonitor {
+    #private;
+    /** Feed a CDP `Runtime.consoleAPICalled` event. */
+    ingestConsoleEvent(params: ConsoleApiCalledParams): void;
+    /** Feed a CDP `Runtime.exceptionThrown` event (best-effort in Electron main). */
+    ingestExceptionEvent(params: ExceptionThrownParams): void;
+    /** All captured entries (console + exceptions), oldest first. */
+    getLogs(): ElectronMainLog[];
+    /** Only error-level entries: `console.error`/`console.assert` and every reported exception. */
+    getErrors(): ElectronMainLog[];
+    /** Drop everything captured so far. */
+    clearLogs(): void;
+    /** Subscribe to every entry. Returns an unsubscribe function. */
+    onLog(handler: ElectronMainLogHandler): () => void;
+    /** Subscribe to error-level entries only. Returns an unsubscribe function. */
+    onError(handler: ElectronMainLogHandler): () => void;
+    /** Resolve with the first entry matching `predicate` (checked against already-buffered entries first). */
+    waitForLog(predicate: (log: ElectronMainLog) => boolean, timeout?: number): Promise<ElectronMainLog>;
+    /** Resolve with the first error-level entry matching `predicate` (default: any error). */
+    waitForError(predicate?: (log: ElectronMainLog) => boolean, timeout?: number): Promise<ElectronMainLog>;
+    /** Throw if any error-level entry was captured — a fail-fast assertion for tests. */
+    assertNoErrors(): void;
+}
+export {};
+//# sourceMappingURL=electronMainLogs.d.ts.map

package/dist/lib/electronMainLogs.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"electronMainLogs.d.ts","sourceRoot":"","sources":["../../src/lib/electronMainLogs.ts"],"names":[],"mappings":"AAqBA,qDAAqD;AACrD,MAAM,MAAM,oBAAoB,GAAG,KAAK,GAAG,OAAO,GAAG,MAAM,GAAG,MAAM,GAAG,OAAO,CAAC;AAE/E,MAAM,WAAW,eAAe;IAC9B,kGAAkG;IAClG,IAAI,EAAE,SAAS,GAAG,WAAW,CAAC;IAC9B,+FAA+F;IAC/F,KAAK,EAAE,oBAAoB,CAAC;IAC5B,+FAA+F;IAC/F,IAAI,EAAE,MAAM,CAAC;IACb,2GAA2G;IAC3G,IAAI,EAAE,OAAO,EAAE,CAAC;IAChB,6CAA6C;IAC7C,SAAS,EAAE,IAAI,CAAC;IAChB,mHAAmH;IACnH,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,6DAA6D;IAC7D,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAED,MAAM,MAAM,sBAAsB,GAAG,CAAC,GAAG,EAAE,eAAe,KAAK,IAAI,CAAC;AAEpE,gFAAgF;AAChF,UAAU,eAAe;IAAG,IAAI,EAAE,MAAM,CAAC;IAAC,OAAO,CAAC,EAAE,MAAM,CAAC;IAAC,KAAK,CAAC,EAAE,OAAO,CAAC;IAAC,WAAW,CAAC,EAAE,MAAM,CAAA;CAAE;AACnG,UAAU,aAAa;IACrB,UAAU,CAAC,EAAE,KAAK,CAAC;QAAE,YAAY,CAAC,EAAE,MAAM,CAAC;QAAC,GAAG,CAAC,EAAE,MAAM,CAAC;QAAC,UAAU,CAAC,EAAE,MAAM,CAAC;QAAC,YAAY,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;CACzG;AACD,MAAM,WAAW,sBAAsB;IACrC,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,IAAI,CAAC,EAAE,eAAe,EAAE,CAAC;IACzB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,UAAU,CAAC,EAAE,aAAa,CAAC;CAC5B;AACD,MAAM,WAAW,qBAAqB;IACpC,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,gBAAgB,CAAC,EAAE;QACjB,IAAI,CAAC,EAAE,MAAM,CAAC;QACd,SAAS,CAAC,EAAE;YAAE,WAAW,CAAC,EAAE,MAAM,CAAC;YAAC,KAAK,CAAC,EAAE,OAAO,CAAA;SAAE,CAAC;QACtD,UAAU,CAAC,EAAE,aAAa,CAAC;KAC5B,CAAC;CACH;AA8CD;;;;GAIG;AACH,qBAAa,sBAAsB;;IAKjC,mDAAmD;IACnD,kBAAkB,CAAC,MAAM,EAAE,sBAAsB,GAAG,IAAI;IAaxD,iFAAiF;IACjF,oBAAoB,CAAC,MAAM,EAAE,qBAAqB,GAAG,IAAI;IAazD,iEAAiE;IACjE,OAAO,IAAI,eAAe,EAAE;IAI5B,+FAA+F;IAC/F,SAAS,IAAI,eAAe,EAAE;IAI9B,uCAAuC;IACvC,SAAS,IAAI,IAAI;IAIjB,iEAAiE;IACjE,KAAK,CAAC,OAAO,EAAE,sBAAsB,GAAG,MAAM,IAAI;IAKlD,8EAA8E;IAC9E,OAAO,CAAC,OAAO,EAAE,sBAAsB,GAAG,MAAM,IAAI;IAKpD,0GAA0G;IAC1G,UAAU,CACR,SAAS,EAAE,CAAC,GAAG,EAAE,eAAe,KAAK,OAAO,EAC5C,OAAO,SAAgC,GACtC,OAAO,CAAC,eAAe,CAAC;IAI3B,0FAA0F;IAC1F,YAAY,CACV,SAAS,GAAE,CAAC,GAAG,EAAE,eAAe,KAAK,OAAoB,EACzD,OAAO,SAAgC,GACtC,OAAO,CAAC,eAAe,CAAC;IAI3B,qFAAqF;IACrF,cAAc,IAAI,IAAI;CAoDvB"}