@stacks/clarinet-sdk 3.23.2 → 3.24.1

package/dist/esm/node/src/syncDebugSimnet.js

@@ -0,0 +1,177 @@
+/**
+ * Synchronous simnet proxy that routes all calls to a `clarinet dap` debug server
+ * via a SharedArrayBuffer + Atomics.wait worker (see syncDebugSocket.ts).
+ *
+ * When CLARINET_DEBUG_PORT is set, initSimnet() returns one of these instead of
+ * the WASM simnet. The API surface is identical, so existing tests run unchanged
+ * while breakpoints in .clar files fire in VSCode (or any DAP-capable editor).
+ */
+import { Cl } from "@stacks/transactions";
+import { syncSend } from "./syncDebugSocket.js";
+import { parseEvents, parseCosts, } from "../../common/src/sdkProxyHelpers.js";
+function parseTxResult(r) {
+    if (!r.result) {
+        throw new Error(r.error ?? "transaction failed with no result");
+    }
+    return {
+        result: Cl.deserialize(r.result),
+        events: parseEvents(r.events),
+        costs: parseCosts(r.costs),
+        performance: undefined,
+    };
+}
+/** Call syncSend and throw if the server responded with an error. */
+function send(request) {
+    const raw = syncSend(request);
+    const resp = JSON.parse(raw);
+    if (resp.error)
+        throw new Error(resp.error);
+    return resp.result ?? {};
+}
+/** Serialize a ClarityValue to a Clarity syntax string for use in snippets. */
+function argString(v) {
+    return Cl.stringify(v);
+}
+/**
+ * Create a synchronous debug simnet proxy connected to the debug server at the
+ * given port. The caller must have already called `connectSyncSocket(port)`.
+ *
+ * `deployer` is fetched immediately (synchronously) from the server.
+ */
+export function createSyncDebugSimnet() {
+    // Fetch deployer and accounts at construction time (sync, server is connected).
+    const initData = send({ method: "getAccounts" });
+    const accountsRecord = initData.accounts ?? {};
+    const deployer = accountsRecord["deployer"] ?? "";
+    return {
+        deployer,
+        get blockHeight() {
+            const resp = send({ method: "getBlockHeight" });
+            return resp.blockHeight;
+        },
+        get burnBlockHeight() {
+            const resp = send({ method: "getBurnBlockHeight" });
+            return resp.burnBlockHeight;
+        },
+        get stacksBlockHeight() {
+            const resp = send({ method: "getBlockHeight" });
+            return resp.blockHeight;
+        },
+        getAccounts() {
+            return new Map(Object.entries(accountsRecord));
+        },
+        mineEmptyBlock(count = 1) {
+            const resp = send({ method: "mineEmptyBlock", count });
+            return resp.blockHeight;
+        },
+        mineEmptyStacksBlock() {
+            const resp = send({ method: "mineEmptyBlock", count: 1 });
+            return resp.blockHeight;
+        },
+        setCurrentTestName(_name) {
+            // No-op in debug mode: coverage tracking is not supported.
+        },
+        collectReport(_includeBootContracts, _bootContractsPath) {
+            // Debug mode does not support coverage/cost reports.
+            throw new Error("collectReport: coverage and cost reports are not supported in debug mode");
+        },
+        runSnippet(snippet) {
+            const resp = send({ method: "execute", snippet });
+            return Cl.stringify(Cl.deserialize(resp.result));
+        },
+        mineBlock(txs) {
+            const serialized = txs.map((tx) => {
+                if (tx.callPublicFn) {
+                    return {
+                        type: "callPublicFn",
+                        contract: tx.callPublicFn.contract,
+                        function: tx.callPublicFn.method,
+                        args: tx.callPublicFn.args.map(argString),
+                        sender: tx.callPublicFn.sender,
+                    };
+                }
+                if (tx.callPrivateFn) {
+                    return {
+                        type: "callPrivateFn",
+                        contract: tx.callPrivateFn.contract,
+                        function: tx.callPrivateFn.method,
+                        args: tx.callPrivateFn.args.map(argString),
+                        sender: tx.callPrivateFn.sender,
+                    };
+                }
+                if (tx.deployContract) {
+                    return {
+                        type: "deployContract",
+                        name: tx.deployContract.name,
+                        content: tx.deployContract.content,
+                        sender: tx.deployContract.sender,
+                    };
+                }
+                if (tx.transferSTX) {
+                    return {
+                        type: "transferSTX",
+                        amount: tx.transferSTX.amount,
+                        recipient: tx.transferSTX.recipient,
+                        sender: tx.transferSTX.sender,
+                    };
+                }
+                return { type: "unknown" };
+            });
+            const resp = send({ method: "mineBlock", txs: serialized });
+            return (resp.results ?? []).map(parseTxResult);
+        },
+        callPublicFn(contract, method, args, sender) {
+            const resp = send({
+                method: "callPublicFn",
+                contract,
+                function: method,
+                args: args.map(argString),
+                sender,
+            });
+            return parseTxResult(resp);
+        },
+        callReadOnlyFn(contract, method, args, sender) {
+            const resp = send({
+                method: "callReadOnlyFn",
+                contract,
+                function: method,
+                args: args.map(argString),
+                sender,
+            });
+            return parseTxResult(resp);
+        },
+        callPrivateFn(contract, method, args, sender) {
+            const resp = send({
+                method: "callPrivateFn",
+                contract,
+                function: method,
+                args: args.map(argString),
+                sender,
+            });
+            return parseTxResult(resp);
+        },
+        execute(snippet) {
+            const resp = send({ method: "execute", snippet });
+            return parseTxResult(resp);
+        },
+        getAssetsMap() {
+            const resp = send({ method: "getAssetsMap" });
+            const outer = new Map();
+            for (const [asset, holders] of Object.entries(resp.assetsMap ?? {})) {
+                const inner = new Map();
+                for (const [addr, bal] of Object.entries(holders)) {
+                    inner.set(addr, BigInt(bal));
+                }
+                outer.set(asset, inner);
+            }
+            return outer;
+        },
+        getLastContractCallTrace() {
+            return undefined;
+        },
+        async initSession(cwd, manifestPath, options) {
+            send({ method: "initSession", cwd, manifestPath, options });
+        },
+    };
+}
+//# sourceMappingURL=syncDebugSimnet.js.map

package/dist/esm/node/src/syncDebugSimnet.js.map

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

package/dist/esm/node/src/syncDebugSocket.d.ts

@@ -0,0 +1,12 @@
+/**
+ * Spawn the worker and wait for its TCP socket to connect.
+ * Must be called (and awaited) before any `syncSend` call.
+ */
+export declare function connectSyncSocket(port: number): Promise<void>;
+/**
+ * Send a JSON request to the debug server synchronously (blocks via Atomics.wait).
+ * Returns the raw JSON response string.
+ */
+export declare function syncSend(request: Record<string, unknown>): string;
+/** Terminate the worker and release the socket. */
+export declare function closeSyncSocket(): void;

package/dist/esm/node/src/syncDebugSocket.js

@@ -0,0 +1,276 @@
+/**
+ * Synchronous TCP socket client using Worker threads + SharedArrayBuffer +
+ * Atomics.wait. Allows the test runner's main thread to make blocking calls to
+ * the `clarinet dap` SDK server without async/await, so the existing synchronous
+ * Simnet API surface can be fulfilled by a remote debug session.
+ *
+ * Architecture (mirrors the sync_http.cjs pattern in clarinet-sdk-wasm):
+ *   - Main thread writes a JSON request into the SAB, signals the worker, then
+ *     blocks on Atomics.wait until the worker flips the signal back.
+ *   - Worker thread holds a persistent TCP socket to the debug server. On each
+ *     wakeup it reads the request, writes it to the socket, reads the newline-
+ *     delimited JSON response, writes it back into the SAB and signals done.
+ */
+import { Worker } from "node:worker_threads";
+// SAB layout (all offsets in bytes, interpreted as Int32 unless noted):
+//   0  signal       0 = idle (response ready), 1 = request pending
+//   4  request_len  byte length of the request in the data area
+//   8  response_len byte length of response (negative = error message length)
+//  12  liveness     counter bumped by worker timer; main polls for liveness
+//  64+ data area    request bytes followed by response bytes (or error message)
+const HEADER_BYTES = 64;
+const OFFSET_SIGNAL = 0; // Int32 index 0
+const OFFSET_REQ_LEN = 1; // Int32 index 1
+const OFFSET_RESP_LEN = 2; // Int32 index 2
+const OFFSET_LIVENESS = 3; // Int32 index 3
+const SIGNAL_IDLE = 0;
+const SIGNAL_PENDING = 1;
+const LIVENESS_INTERVAL_MS = 250;
+const WORKER_HEARTBEAT_MS = 1000;
+const MAX_STALE_HEARTBEATS = 15;
+const DEFAULT_SAB_SIZE = 4 * 1024 * 1024; // 4 MB
+// ---------------------------------------------------------------------------
+// Worker implementation – serialized and spawned with eval:true so this file
+// stays self-contained. No TypeScript types inside: they get stripped by tsc
+// and the string is valid JS. All data comes through workerData.
+// ---------------------------------------------------------------------------
+function debugSocketWorkerMain() {
+    /* eslint-disable */
+    const { workerData, parentPort } = require("node:worker_threads");
+    const net = require("node:net");
+    const { sab, port, headerBytes, signalIdle, signalPending, livenessIntervalMs, offsetSignal, offsetReqLen, offsetRespLen, offsetLiveness, } = workerData;
+    const dataCapacity = sab.byteLength - headerBytes;
+    const signal = new Int32Array(sab, 0, 1);
+    const header = new Int32Array(sab, 0, headerBytes / 4);
+    const data = new Uint8Array(sab, headerBytes, dataCapacity);
+    const encoder = new TextEncoder();
+    const decoder = new TextDecoder();
+    // eslint-disable-next-line @typescript-eslint/no-explicit-any
+    let pendingResolve = null;
+    // eslint-disable-next-line @typescript-eslint/no-explicit-any
+    let pendingReject = null;
+    let recvBuf = "";
+    const socket = net.createConnection({ port, host: "127.0.0.1" });
+    // eslint-disable-next-line @typescript-eslint/no-explicit-any
+    socket.on("data", (chunk) => {
+        recvBuf += chunk.toString("utf8");
+        const lines = recvBuf.split("\n");
+        recvBuf = lines.pop() ?? "";
+        for (const line of lines) {
+            const trimmed = line.trim();
+            if (trimmed && pendingResolve) {
+                const res = pendingResolve;
+                pendingResolve = null;
+                pendingReject = null;
+                res(trimmed);
+                break;
+            }
+        }
+    });
+    // eslint-disable-next-line @typescript-eslint/no-explicit-any
+    socket.on("error", (err) => {
+        if (pendingReject) {
+            const rej = pendingReject;
+            pendingResolve = null;
+            pendingReject = null;
+            rej(err);
+        }
+    });
+    // eslint-disable-next-line @typescript-eslint/no-explicit-any
+    function writeResponse(jsonStr) {
+        const bytes = encoder.encode(jsonStr);
+        if (bytes.length > dataCapacity) {
+            const msg = encoder.encode("response too large: " + bytes.length);
+            data.set(msg);
+            Atomics.store(header, offsetRespLen, -msg.length);
+        }
+        else {
+            data.set(bytes);
+            Atomics.store(header, offsetRespLen, bytes.length);
+        }
+        Atomics.store(signal, offsetSignal, signalIdle);
+        Atomics.notify(signal, offsetSignal, 1);
+    }
+    // eslint-disable-next-line @typescript-eslint/no-explicit-any
+    function writeError(msg) {
+        const bytes = encoder.encode(String(msg));
+        const truncated = bytes.subarray(0, Math.min(bytes.length, dataCapacity));
+        data.set(truncated);
+        Atomics.store(header, offsetRespLen, -truncated.length);
+        Atomics.store(signal, offsetSignal, signalIdle);
+        Atomics.notify(signal, offsetSignal, 1);
+    }
+    // Liveness beacon so the main thread can detect a dead worker.
+    setInterval(() => {
+        Atomics.add(header, offsetLiveness, 1);
+    }, livenessIntervalMs).unref();
+    process.on("unhandledRejection", (err) => writeError("unhandledRejection: " + err));
+    process.on("uncaughtException", (err) => writeError("uncaughtException: " + err));
+    (async () => {
+        // Wait for socket to connect before signalling ready.
+        await new Promise((resolve, reject) => {
+            socket.once("connect", resolve);
+            socket.once("error", reject);
+        });
+        parentPort.postMessage("ready");
+        for (;;) {
+            // Block until the main thread signals a pending request.
+            while (Atomics.load(signal, offsetSignal) !== signalPending) {
+                Atomics.wait(signal, offsetSignal, signalIdle);
+            }
+            // Yield to let queued microtasks (e.g. orphaned rejections) drain first.
+            await new Promise((r) => setImmediate(r));
+            const reqLen = Atomics.load(header, offsetReqLen);
+            const requestStr = decoder.decode(data.subarray(0, reqLen));
+            try {
+                const responseStr = await new Promise((resolve, reject) => {
+                    const timer = setTimeout(() => {
+                        pendingResolve = null;
+                        pendingReject = null;
+                        reject(new Error("debug server request timed out"));
+                    }, 30_000);
+                    // eslint-disable-next-line @typescript-eslint/no-explicit-any
+                    pendingResolve = (result) => {
+                        clearTimeout(timer);
+                        resolve(result);
+                    };
+                    // eslint-disable-next-line @typescript-eslint/no-explicit-any
+                    pendingReject = (err) => {
+                        clearTimeout(timer);
+                        reject(err);
+                    };
+                    socket.write(requestStr + "\n");
+                });
+                writeResponse(responseStr);
+                // eslint-disable-next-line @typescript-eslint/no-explicit-any
+            }
+            catch (e) {
+                writeError(e && e.message ? e.message : String(e));
+            }
+        }
+        // eslint-disable-next-line @typescript-eslint/no-explicit-any
+    })().catch((err) => {
+        // Connection failed during startup; signal main thread.
+        writeError("worker startup failed: " + (err && err.message ? err.message : String(err)));
+        process.exit(1);
+    });
+    /* eslint-enable */
+}
+const WORKER_SOURCE = `(${debugSocketWorkerMain.toString()})()`;
+let state = null;
+const encoder = new TextEncoder();
+const decoder = new TextDecoder();
+const DATA_CAPACITY = DEFAULT_SAB_SIZE - HEADER_BYTES;
+/**
+ * Spawn the worker and wait for its TCP socket to connect.
+ * Must be called (and awaited) before any `syncSend` call.
+ */
+export async function connectSyncSocket(port) {
+    if (state && !state.dead)
+        return;
+    const sab = new SharedArrayBuffer(DEFAULT_SAB_SIZE);
+    const signal = new Int32Array(sab, 0, 1);
+    const header = new Int32Array(sab, 0, HEADER_BYTES / 4);
+    const data = new Uint8Array(sab, HEADER_BYTES, DATA_CAPACITY);
+    const worker = new Worker(WORKER_SOURCE, {
+        eval: true,
+        workerData: {
+            sab,
+            port,
+            headerBytes: HEADER_BYTES,
+            signalIdle: SIGNAL_IDLE,
+            signalPending: SIGNAL_PENDING,
+            livenessIntervalMs: LIVENESS_INTERVAL_MS,
+            offsetSignal: OFFSET_SIGNAL,
+            offsetReqLen: OFFSET_REQ_LEN,
+            offsetRespLen: OFFSET_RESP_LEN,
+            offsetLiveness: OFFSET_LIVENESS,
+        },
+    });
+    worker.unref();
+    const s = { worker, header, signal, data, dead: false, cause: null };
+    worker.on("error", (err) => {
+        s.dead = true;
+        s.cause = err instanceof Error ? err : new Error(String(err));
+    });
+    worker.on("exit", (code) => {
+        s.dead = true;
+        if (!s.cause && code !== 0)
+            s.cause = new Error(`debug socket worker exited with code ${code}`);
+    });
+    state = s;
+    // Wait for the worker to signal "ready" (TCP socket connected).
+    await new Promise((resolve, reject) => {
+        const timeout = setTimeout(() => reject(new Error("debug socket worker did not become ready within 15 s")), 15_000);
+        worker.once("message", (msg) => {
+            clearTimeout(timeout);
+            if (msg === "ready")
+                resolve();
+            else
+                reject(new Error(`unexpected worker message: ${msg}`));
+        });
+        worker.once("error", (err) => {
+            clearTimeout(timeout);
+            reject(err);
+        });
+    });
+}
+/**
+ * Send a JSON request to the debug server synchronously (blocks via Atomics.wait).
+ * Returns the raw JSON response string.
+ */
+export function syncSend(request) {
+    if (!state || state.dead) {
+        throw new Error("debug socket not connected" + (state?.cause ? `: ${state.cause.message}` : ""));
+    }
+    const reqBytes = encoder.encode(JSON.stringify(request));
+    if (reqBytes.length > DATA_CAPACITY) {
+        throw new Error(`debug request too large: ${reqBytes.length} bytes`);
+    }
+    state.data.set(reqBytes);
+    Atomics.store(state.header, OFFSET_REQ_LEN, reqBytes.length);
+    Atomics.store(state.signal, OFFSET_SIGNAL, SIGNAL_PENDING);
+    Atomics.notify(state.signal, OFFSET_SIGNAL, 1);
+    // Block until the worker finishes, with liveness heartbeating.
+    let lastBeat = Atomics.load(state.header, OFFSET_LIVENESS);
+    let stale = 0;
+    for (;;) {
+        const r = Atomics.wait(state.signal, OFFSET_SIGNAL, SIGNAL_PENDING, WORKER_HEARTBEAT_MS);
+        if (r === "not-equal" || r === "ok")
+            break;
+        const beat = Atomics.load(state.header, OFFSET_LIVENESS);
+        if (beat !== lastBeat) {
+            lastBeat = beat;
+            stale = 0;
+            continue;
+        }
+        stale++;
+        if (stale >= MAX_STALE_HEARTBEATS) {
+            state.dead = true;
+            if (!state.cause) {
+                state.cause = new Error(`debug socket worker unresponsive for ${stale * WORKER_HEARTBEAT_MS} ms`);
+            }
+            break;
+        }
+    }
+    if (state.dead) {
+        throw new Error("debug socket worker died during request: " + (state.cause?.message ?? "unknown"));
+    }
+    const respLen = Atomics.load(state.header, OFFSET_RESP_LEN);
+    if (respLen < 0) {
+        throw new Error(decoder.decode(state.data.subarray(0, -respLen)));
+    }
+    return decoder.decode(state.data.subarray(0, respLen));
+}
+/** Terminate the worker and release the socket. */
+export function closeSyncSocket() {
+    const w = state?.worker;
+    state = null;
+    try {
+        w?.terminate();
+    }
+    catch {
+        // ignore
+    }
+}
+//# sourceMappingURL=syncDebugSocket.js.map

package/dist/esm/node/src/syncDebugSocket.js.map

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

package/dist/esm/node/src/vfs.d.ts

@@ -1,3 +1,3 @@
-export declare function vfs(action: string, data: unknown): Promise<boolean> | Promise<string> | Promise<{
+export declare function vfs(action: string, data: unknown): Promise<void> | Promise<string> | Promise<{
     [k: string]: string;
-}> | Promise<void>;
+}> | Promise<boolean>;

package/dist/esm/node/src/vitest/index.d.ts

@@ -1,31 +1,31 @@
-export declare function getClarinetVitestsArgv(): {
+export declare function getClarinetVitestsArgv(): Promise<{
     [x: string]: unknown;
-    "manifest-path": string;
-    manifestPath: string;
-    "init-before-each": boolean;
-    initBeforeEach: boolean;
-    coverage: boolean;
+    $0: string;
+    _: (string | number)[];
     costs: boolean;
-    "coverage-filename": string;
-    coverageFilename: string;
     "costs-filename": string;
     costsFilename: string;
-    _: (string | number)[];
-    $0: string;
-} | Promise<{
-    [x: string]: unknown;
-    "manifest-path": string;
-    manifestPath: string;
-    "init-before-each": boolean;
-    initBeforeEach: boolean;
     coverage: boolean;
-    costs: boolean;
     "coverage-filename": string;
     coverageFilename: string;
+    "init-before-each": boolean;
+    initBeforeEach: boolean;
+    "manifest-path": string;
+    manifestPath: string;
+}> | {
+    [x: string]: unknown;
+    $0: string;
+    _: (string | number)[];
+    costs: boolean;
     "costs-filename": string;
     costsFilename: string;
-    _: (string | number)[];
-    $0: string;
-}>;
+    coverage: boolean;
+    "coverage-filename": string;
+    coverageFilename: string;
+    "init-before-each": boolean;
+    initBeforeEach: boolean;
+    "manifest-path": string;
+    manifestPath: string;
+};
 export declare const vitestHelpersPath: string;
 export declare const vitestSetupFilePath: string;

package/dist/esm/node/src/vitest/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../../src/vitest/index.ts"],"names":[],"mappings":"AAAA,OAAO,IAAI,MAAM,WAAW,CAAC;AAC7B,OAAO,GAAG,MAAM,UAAU,CAAC;AAE3B,OAAO,KAAK,MAAM,OAAO,CAAC;AAC1B,OAAO,EAAE,OAAO,EAAE,MAAM,eAAe,CAAC;AAExC,MAAM,UAAU,sBAAsB;IACpC,MAAM,IAAI,GAAG,OAAO,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC;IACnC,MAAM,QAAQ,GAAG,KAAK,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC;IAElC,aAAa;IACb,OAAO,KAAK,CAAC,QAAQ,CAAC,CAAC,CAAC;SACrB,MAAM,CAAC,eAAe,EAAE;QACvB,KAAK,EAAE,UAAU;QACjB,IAAI,EAAE,QAAQ;QACd,OAAO,EAAE,iBAAiB;KAC3B,CAAC;SACD,MAAM,CAAC,kBAAkB,EAAE;QAC1B,WAAW,EAAE,kDAAkD;QAC/D,IAAI,EAAE,SAAS;QACf,OAAO,EAAE,IAAI;KACd,CAAC;SACD,MAAM,CAAC,UAAU,EAAE;QAClB,KAAK,EAAE,KAAK;QACZ,IAAI,EAAE,SAAS;QACf,OAAO,EAAE,KAAK;KACf,CAAC;SACD,MAAM,CAAC,OAAO,EAAE;QACf,KAAK,EAAE,MAAM;QACb,IAAI,EAAE,SAAS;QACf,OAAO,EAAE,KAAK;KACf,CAAC;SACD,MAAM,CAAC,mBAAmB,EAAE;QAC3B,KAAK,EAAE,UAAU;QACjB,IAAI,EAAE,QAAQ;QACd,OAAO,EAAE,WAAW;KACrB,CAAC;SACD,MAAM,CAAC,gBAAgB,EAAE;QACxB,KAAK,EAAE,YAAY;QACnB,IAAI,EAAE,QAAQ;QACd,OAAO,EAAE,oBAAoB;KAC9B,CAAC,CAAC,IAAI,CAAC;AACZ,CAAC;AAED,0DAA0D;AAC1D,MAAM,MAAM,GAAG,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,aAAa,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC;AAEhE,iEAAiE;AACjE,MAAM,CAAC,MAAM,iBAAiB,GAAG,IAAI,CAAC,IAAI,CAAC,MAAM,EAAE,oCAAoC,CAAC,CAAC;AACzF,MAAM,CAAC,MAAM,mBAAmB,GAAG,IAAI,CAAC,IAAI,CAAC,iBAAiB,EAAE,iBAAiB,CAAC,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../../src/vitest/index.ts"],"names":[],"mappings":"AAAA,OAAO,IAAI,MAAM,WAAW,CAAC;AAC7B,OAAO,GAAG,MAAM,UAAU,CAAC;AAE3B,OAAO,KAAK,MAAM,OAAO,CAAC;AAC1B,OAAO,EAAE,OAAO,EAAE,MAAM,eAAe,CAAC;AAExC,MAAM,UAAU,sBAAsB;IACpC,MAAM,IAAI,GAAG,OAAO,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC;IACnC,MAAM,QAAQ,GAAG,KAAK,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC;IAElC,aAAa;IACb,OAAO,KAAK,CAAC,QAAQ,CAAC,CAAC,CAAC;SACrB,MAAM,CAAC,eAAe,EAAE;QACvB,KAAK,EAAE,UAAU;QACjB,IAAI,EAAE,QAAQ;QACd,OAAO,EAAE,iBAAiB;KAC3B,CAAC;SACD,MAAM,CAAC,kBAAkB,EAAE;QAC1B,WAAW,EAAE,kDAAkD;QAC/D,IAAI,EAAE,SAAS;QACf,OAAO,EAAE,IAAI;KACd,CAAC;SACD,MAAM,CAAC,UAAU,EAAE;QAClB,KAAK,EAAE,KAAK;QACZ,IAAI,EAAE,SAAS;QACf,OAAO,EAAE,KAAK;KACf,CAAC;SACD,MAAM,CAAC,OAAO,EAAE;QACf,KAAK,EAAE,MAAM;QACb,IAAI,EAAE,SAAS;QACf,OAAO,EAAE,KAAK;KACf,CAAC;SACD,MAAM,CAAC,mBAAmB,EAAE;QAC3B,KAAK,EAAE,UAAU;QACjB,IAAI,EAAE,QAAQ;QACd,OAAO,EAAE,WAAW;KACrB,CAAC;SACD,MAAM,CAAC,gBAAgB,EAAE;QACxB,KAAK,EAAE,YAAY;QACnB,IAAI,EAAE,QAAQ;QACd,OAAO,EAAE,oBAAoB;KAC9B,CAAC,CAAC,IAAI,CAAC;AACZ,CAAC;AAED,0DAA0D;AAC1D,MAAM,MAAM,GAAG,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,aAAa,CAAC,OAAO,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC;AAEhE,iEAAiE;AACjE,MAAM,CAAC,MAAM,iBAAiB,GAAG,IAAI,CAAC,IAAI,CAAC,MAAM,EAAE,oCAAoC,CAAC,CAAC;AACzF,MAAM,CAAC,MAAM,mBAAmB,GAAG,IAAI,CAAC,IAAI,CAAC,iBAAiB,EAAE,iBAAiB,CAAC,CAAC"}