@bingine/cemem 0.0.0-stage → 0.1.0

package/dist/cjs/win/process.js

@@ -0,0 +1,475 @@
+"use strict";
+/**
+ * 进程与内存访问层 —— 后端无关的门面。
+ *
+ * 本文件不再直接调用 Win32 API，而是委托给 `MemoryBackend`：
+ *   - `SelfBackend`      → 自研引擎（默认，本进程内直接调用 Win32）
+ *   - `NativeCeBackend`  → 原生 CE 兼容层（连接 ceserver 的 TCP 协议）
+ *
+ * 因此 `Process` 的用法在两种后端下完全一致：
+ * ```ts
+ * const p = Process.open(pid);                       // 默认自研后端
+ * const p2 = Process.open(pid, { backend: native }); // 走原生 CE
+ * ```
+ *
+ * 性能提示：CE 扫描时把整段内存拷进缓冲区再本地比较，本移植沿用同一思路，
+ * 因此后端只需要提供一个"按块读内存"的原语即可，比较逻辑全在上层。
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.DEFAULT_PROCESS_ACCESS = exports.MEM_PRIVATE = exports.MEM_MAPPED = exports.MEM_IMAGE = exports.MEM_COMMIT = exports.PAGE_GUARD = exports.MAX_ADDRESS = exports.Process = exports.ProcessOpenError = exports.isExecutable = exports.isWritable = exports.isReadable = void 0;
+exports.getDefaultBackend = getDefaultBackend;
+exports.setDefaultBackend = setDefaultBackend;
+exports.listProcesses = listProcesses;
+exports.findProcessesByName = findProcessesByName;
+exports.listProcessesAsync = listProcessesAsync;
+exports.findProcessesByNameAsync = findProcessesByNameAsync;
+exports.enumerateRegions = enumerateRegions;
+exports.selectScannableRegions = selectScannableRegions;
+exports.openProcessAsync = openProcessAsync;
+exports.openProcessByNameAsync = openProcessByNameAsync;
+exports.regionTypeName = regionTypeName;
+const types_1 = require("../types");
+Object.defineProperty(exports, "DEFAULT_PROCESS_ACCESS", { enumerable: true, get: function () { return types_1.DEFAULT_PROCESS_ACCESS; } });
+Object.defineProperty(exports, "MEM_COMMIT", { enumerable: true, get: function () { return types_1.MEM_COMMIT; } });
+Object.defineProperty(exports, "MEM_IMAGE", { enumerable: true, get: function () { return types_1.MEM_IMAGE; } });
+Object.defineProperty(exports, "MEM_MAPPED", { enumerable: true, get: function () { return types_1.MEM_MAPPED; } });
+Object.defineProperty(exports, "MEM_PRIVATE", { enumerable: true, get: function () { return types_1.MEM_PRIVATE; } });
+Object.defineProperty(exports, "PAGE_GUARD", { enumerable: true, get: function () { return types_1.PAGE_GUARD; } });
+const self_backend_1 = require("../backend/self-backend");
+var self_backend_2 = require("../backend/self-backend");
+Object.defineProperty(exports, "isReadable", { enumerable: true, get: function () { return self_backend_2.isReadable; } });
+Object.defineProperty(exports, "isWritable", { enumerable: true, get: function () { return self_backend_2.isWritable; } });
+Object.defineProperty(exports, "isExecutable", { enumerable: true, get: function () { return self_backend_2.isExecutable; } });
+/* ------------------------------------------------------------------ *
+ * 后端解析
+ * ------------------------------------------------------------------ */
+let defaultBackend = null;
+/** 取进程内共享的默认后端（自研引擎）。 */
+function getDefaultBackend() {
+    if (!defaultBackend)
+        defaultBackend = new self_backend_1.SelfBackend();
+    return defaultBackend;
+}
+/** 替换默认后端（例如全局切到原生 CE）。传入 null 恢复自研后端。 */
+function setDefaultBackend(backend) {
+    defaultBackend = backend;
+}
+function resolveBackend(options) {
+    if (options?.backend)
+        return options.backend;
+    if (options?.access !== undefined) {
+        return new self_backend_1.SelfBackend({ access: options.access });
+    }
+    return getDefaultBackend();
+}
+/**
+ * 断言后端是同步的，并把返回值收窄为 T。
+ *
+ * 用途：`Process` 的同步方法（`readMemory` 等）只能用于同步后端。
+ * 若换成了 `NativeCeBackend`（socket，异步），同步方法无法工作 ——
+ * 这时要给出**明确、可操作**的错误，而不是让调用方拿到一个 Promise 当 Buffer 用。
+ */
+function syncResult(backend, value, operation) {
+    if (backend.capabilities.sync)
+        return value;
+    throw new Error(`后端 "${backend.name}" 是异步的，不能使用同步方法 ${operation}()。` +
+        `请改用异步变体（例如 readMemoryAsync()）并 await，` +
+        `或改用同步后端 SelfBackend。`);
+}
+/** 枚举全部进程（使用默认后端；同步后端专用，异步后端请用 listProcessesAsync） */
+function listProcesses(backend) {
+    const b = backend ?? getDefaultBackend();
+    const out = syncResult(b, b.listProcesses(), 'listProcesses').map((p) => ({
+        pid: p.pid,
+        name: p.name,
+        parentPid: p.parentPid,
+        threadCount: p.threadCount,
+    }));
+    // 标记同名进程，便于 CLI 提示用户选择
+    const counts = new Map();
+    for (const p of out) {
+        const k = p.name.toLowerCase();
+        counts.set(k, (counts.get(k) ?? 0) + 1);
+    }
+    for (const p of out) {
+        if ((counts.get(p.name.toLowerCase()) ?? 0) > 1)
+            p.duplicateName = true;
+    }
+    return out;
+}
+/** 按名字查进程（不区分大小写，包含匹配） */
+function findProcessesByName(name, backend) {
+    const needle = name.toLowerCase();
+    return listProcesses(backend).filter((p) => p.name.toLowerCase() === needle || p.name.toLowerCase().includes(needle));
+}
+/* ------------------------------------------------------------------ *
+ * 异步变体（原生 CE 后端必须用这些）
+ * ------------------------------------------------------------------ */
+/** 枚举全部进程（异步；对同步与异步后端都可用） */
+async function listProcessesAsync(backend) {
+    const b = backend ?? getDefaultBackend();
+    const out = (await b.listProcesses()).map((p) => ({
+        pid: p.pid,
+        name: p.name,
+        parentPid: p.parentPid,
+        threadCount: p.threadCount,
+    }));
+    const counts = new Map();
+    for (const p of out) {
+        const k = p.name.toLowerCase();
+        counts.set(k, (counts.get(k) ?? 0) + 1);
+    }
+    for (const p of out) {
+        if ((counts.get(p.name.toLowerCase()) ?? 0) > 1)
+            p.duplicateName = true;
+    }
+    return out;
+}
+/** 按名字查进程（异步） */
+async function findProcessesByNameAsync(name, backend) {
+    const needle = name.toLowerCase();
+    return (await listProcessesAsync(backend)).filter((p) => p.name.toLowerCase() === needle || p.name.toLowerCase().includes(needle));
+}
+/** 把后端区域转成对外暴露的 MemoryRegion */
+function toMemoryRegion(r) {
+    return {
+        baseAddress: r.baseAddress,
+        memorySize: r.regionSize,
+        committed: r.state === types_1.MEM_COMMIT,
+        protect: r.protect,
+        type: r.type,
+    };
+}
+/**
+ * 枚举进程内存区域。
+ *
+ * 只接受 `Process` 实例（早期版本接受裸 Win32 句柄，那样无法支持原生 CE 后端，
+ * 因此移除；请用 `process.regions()`）。
+ */
+function enumerateRegions(process, options = {}) {
+    if (!(process instanceof Process)) {
+        throw new TypeError('enumerateRegions 需要传入 Process 实例（裸 Win32 句柄已不再支持，请用 process.regions()）');
+    }
+    return process.regions(options);
+}
+/** 选出"可扫描"的内存区域（对齐 CE 首次扫描的默认行为） */
+function selectScannableRegions(process, filter = {}) {
+    return process.scannableRegions(filter);
+}
+/* ------------------------------------------------------------------ *
+ * Process
+ * ------------------------------------------------------------------ */
+/** 打开进程失败时抛出的错误，带 pid 与 Win32 错误码（若后端提供）。 */
+class ProcessOpenError extends Error {
+    pid;
+    win32Code;
+    constructor(pid, win32Code, message) {
+        super(message ?? `无法打开进程 ${pid}：Win32 错误 ${win32Code}`);
+        this.pid = pid;
+        this.win32Code = win32Code;
+        this.name = 'ProcessOpenError';
+    }
+}
+exports.ProcessOpenError = ProcessOpenError;
+/**
+ * 一个已打开的目标进程。
+ *
+ * 生命周期：
+ * ```ts
+ * const p = Process.open(pid);
+ * try { ... } finally { p.close(); }
+ * ```
+ * 也支持 `using`（Symbol.dispose）。
+ */
+class Process {
+    pid;
+    name;
+    backend;
+    handle;
+    closed = false;
+    constructor(pid, name, backend, handle) {
+        this.pid = pid;
+        this.name = name;
+        this.backend = backend;
+        this.handle = handle;
+    }
+    /** 按 pid 打开进程（同步后端专用；异步后端请用 openProcessAsync） */
+    static open(pid, options) {
+        const backend = resolveBackend(options);
+        let handle;
+        try {
+            handle = syncResult(backend, backend.openProcess(pid), 'openProcess');
+        }
+        catch (e) {
+            const err = e;
+            if (err.name === 'ProcessOpenError' || err.win32Code !== undefined) {
+                throw new ProcessOpenError(pid, err.win32Code ?? 0, err.message);
+            }
+            throw e;
+        }
+        const info = syncResult(backend, backend.listProcesses(), 'listProcesses').find((p) => p.pid === pid);
+        return new Process(pid, info?.name ?? `<pid ${pid}>`, backend, handle);
+    }
+    /** 按进程名打开；同名多进程时选第一个 */
+    static openByName(name, options) {
+        const backend = resolveBackend(options);
+        const matches = findProcessesByName(name, backend);
+        if (matches.length === 0)
+            throw new Error(`找不到进程：${name}`);
+        return Process.open(matches[0].pid, options);
+    }
+    /** 按进程名打开全部同名进程 */
+    static openByNameAll(name, options) {
+        const backend = resolveBackend(options);
+        return findProcessesByName(name, backend).map((p) => Process.open(p.pid, options));
+    }
+    /**
+     * 由"已打开的后端句柄"构造 Process —— 供异步打开路径使用。
+     * 一般业务代码请用 `Process.open` / `openProcessAsync`。
+     */
+    static fromHandle(pid, name, backend, handle) {
+        return new Process(pid, name, backend, handle);
+    }
+    get isOpen() {
+        return !this.closed;
+    }
+    /** 所属后端名称 */
+    get backendName() {
+        return this.backend.name;
+    }
+    /**
+     * 底层后端句柄 —— 供需要直接调用后端的扩展代码使用
+     * （例如 Lua 桥要把句柄转成整数传给脚本）。
+     * 一般业务代码应优先使用 Process 的高层方法。
+     */
+    get backendHandle() {
+        this.assertOpen();
+        return this.handle;
+    }
+    assertOpen() {
+        if (this.closed)
+            throw new Error(`进程 ${this.pid} 的句柄已关闭`);
+    }
+    /** 是否为 WOW64（32 位）进程 */
+    isWow64() {
+        this.assertOpen();
+        return syncResult(this.backend, this.backend.isWow64(this.handle), 'isWow64');
+    }
+    /** 列出全部内存区域 */
+    regions(options) {
+        this.assertOpen();
+        const list = syncResult(this.backend, this.backend.queryRegions(this.handle, {
+            includeFree: options?.includeFree ?? true,
+            maxAddress: options?.maxAddress,
+        }), 'regions');
+        return list.map(toMemoryRegion);
+    }
+    /** 列出可扫描区域 */
+    scannableRegions(filter) {
+        this.assertOpen();
+        const raw = syncResult(this.backend, this.backend.queryRegions(this.handle, filter ?? {}), 'scannableRegions');
+        return raw.map(toMemoryRegion);
+    }
+    /**
+     * 读取内存。整块读取失败时由后端做二分回退。
+     * @returns 实际读到的数据（长度可能小于请求）
+     */
+    readMemory(address, size) {
+        this.assertOpen();
+        return syncResult(this.backend, this.backend.readProcessMemory(this.handle, address, size), 'readMemory');
+    }
+    /** 读取失败时抛错的严格版本 */
+    readMemoryExact(address, size) {
+        const buf = this.readMemory(address, size);
+        if (buf.length !== size) {
+            throw new Error(`读取进程 ${this.pid} 内存失败：地址 0x${address.toString(16)}，请求 ${size} 字节，实得 ${buf.length} 字节`);
+        }
+        return buf;
+    }
+    /**
+     * 写入内存。默认在写只读页前临时改保护（与 CE 的 writeprocessmemory 行为一致）。
+     * @returns 实际写入字节数
+     */
+    writeMemory(address, data, fixProtection = true) {
+        this.assertOpen();
+        return syncResult(this.backend, this.backend.writeProcessMemory(this.handle, address, data, fixProtection), 'writeMemory');
+    }
+    /** 在目标进程内分配内存 */
+    allocate(size, protect = 0x04, address = 0n) {
+        this.assertOpen();
+        return syncResult(this.backend, this.backend.allocate(this.handle, size, protect, address), 'allocate');
+    }
+    /** 释放由 allocate 分配的内存 */
+    free(address) {
+        this.assertOpen();
+        syncResult(this.backend, this.backend.free(this.handle, address), 'free');
+    }
+    /** 修改内存保护属性，返回旧保护值 */
+    protect(address, size, newProtect) {
+        this.assertOpen();
+        return syncResult(this.backend, this.backend.changeProtection(this.handle, address, size, newProtect), 'protect');
+    }
+    /** 列出进程模块 */
+    modules() {
+        this.assertOpen();
+        return syncResult(this.backend, this.backend.queryModules(this.handle), 'modules').map((m) => ({
+            name: m.name,
+            path: m.path,
+            baseAddress: m.baseAddress,
+            size: m.size,
+        }));
+    }
+    /** 列出线程 id */
+    threadIds() {
+        this.assertOpen();
+        return syncResult(this.backend, this.backend.queryThreads(this.handle), 'threadIds');
+    }
+    /**
+     * 挂起进程全部线程，返回可传给 resume() 的令牌。
+     * 仅自研后端支持（原生 CE 后端会抛错）。
+     */
+    suspend() {
+        this.assertOpen();
+        const b = this.backend;
+        if (typeof b.suspendAllThreads !== 'function') {
+            throw new Error(`后端 "${this.backend.name}" 不支持挂起线程（ceserver 的线程接口未实现）`);
+        }
+        return b.suspendAllThreads(this.handle);
+    }
+    /** 恢复之前挂起的线程 */
+    resume(token) {
+        const b = this.backend;
+        if (typeof b.resumeThreads !== 'function') {
+            throw new Error(`后端 "${this.backend.name}" 不支持恢复线程`);
+        }
+        b.resumeThreads(token);
+    }
+    /** 关闭句柄。可重复调用。 */
+    close() {
+        if (this.closed)
+            return;
+        this.closed = true;
+        void this.backend.closeProcess(this.handle);
+    }
+    /** 支持 `using` 语义 */
+    [Symbol.dispose]() {
+        this.close();
+    }
+    /* ---------------------------------------------------------------- *
+     * 异步变体
+     *
+     * 存在的理由：`NativeCeBackend`（原生 CE / ceserver）本质是 socket 通信，
+     * 只能是异步的；而 `SelfBackend` 是同步的。
+     * 下面这些 `*Async` 方法**对两种后端都可用** ——
+     * 同步后端会直接返回（`await` 一个非 Promise 值原样返回），
+     * 因此调用方可以统一写 `await`，无需分支判断。
+     * ---------------------------------------------------------------- */
+    /** 异步关闭句柄 */
+    async closeAsync() {
+        if (this.closed)
+            return;
+        this.closed = true;
+        await this.backend.closeProcess(this.handle);
+    }
+    /** 异步枚举全部内存区域 */
+    async regionsAsync(options) {
+        this.assertOpen();
+        const list = await this.backend.queryRegions(this.handle, {
+            includeFree: options?.includeFree ?? true,
+            maxAddress: options?.maxAddress,
+        });
+        return list.map(toMemoryRegion);
+    }
+    /** 异步枚举可扫描区域 */
+    async scannableRegionsAsync(filter) {
+        this.assertOpen();
+        const raw = await this.backend.queryRegions(this.handle, filter ?? {});
+        return raw.map(toMemoryRegion);
+    }
+    /** 异步读取内存 */
+    async readMemoryAsync(address, size) {
+        this.assertOpen();
+        return syncResult(this.backend, this.backend.readProcessMemory(this.handle, address, size), 'readMemory');
+    }
+    /** 异步读取内存（不足则抛错） */
+    async readMemoryExactAsync(address, size) {
+        const buf = await this.readMemoryAsync(address, size);
+        if (buf.length !== size) {
+            throw new Error(`读取进程 ${this.pid} 内存失败：地址 0x${address.toString(16)}，请求 ${size} 字节，实得 ${buf.length} 字节`);
+        }
+        return buf;
+    }
+    /** 异步写入内存 */
+    async writeMemoryAsync(address, data, fixProtection = true) {
+        this.assertOpen();
+        return syncResult(this.backend, this.backend.writeProcessMemory(this.handle, address, data, fixProtection), 'writeMemory');
+    }
+    /** 异步枚举模块 */
+    async modulesAsync() {
+        this.assertOpen();
+        const mods = await this.backend.queryModules(this.handle);
+        return mods.map((m) => ({
+            name: m.name,
+            path: m.path,
+            baseAddress: m.baseAddress,
+            size: m.size,
+        }));
+    }
+    /** 异步枚举线程 id */
+    async threadIdsAsync() {
+        this.assertOpen();
+        return syncResult(this.backend, this.backend.queryThreads(this.handle), 'threadIds');
+    }
+    /** 异步分配内存 */
+    async allocateAsync(size, protect = 0x04, address = 0n) {
+        this.assertOpen();
+        return syncResult(this.backend, this.backend.allocate(this.handle, size, protect, address), 'allocate');
+    }
+    /** 异步修改内存保护 */
+    async protectAsync(address, size, newProtect) {
+        this.assertOpen();
+        return syncResult(this.backend, this.backend.changeProtection(this.handle, address, size, newProtect), 'protect');
+    }
+    /** 异步判断是否 WOW64 */
+    async isWow64Async() {
+        this.assertOpen();
+        return syncResult(this.backend, this.backend.isWow64(this.handle), 'isWow64');
+    }
+}
+exports.Process = Process;
+/** 打开进程的异步变体（原生 CE 后端下必须用它）。 */
+async function openProcessAsync(pid, options) {
+    const backend = resolveBackend(options);
+    const handle = await backend.openProcess(pid);
+    const infos = await backend.listProcesses();
+    const info = infos.find((p) => p.pid === pid);
+    return Process.fromHandle(pid, info?.name ?? `<pid ${pid}>`, backend, handle);
+}
+/** 按名字打开进程（异步变体）。 */
+async function openProcessByNameAsync(name, options) {
+    const backend = resolveBackend(options);
+    const all = (await backend.listProcesses()).map((p) => ({
+        pid: p.pid,
+        name: p.name,
+        parentPid: p.parentPid,
+        threadCount: p.threadCount,
+    }));
+    const needle = name.toLowerCase();
+    const matches = all.filter((p) => p.name.toLowerCase() === needle || p.name.toLowerCase().includes(needle));
+    if (matches.length === 0)
+        throw new Error(`找不到进程：${name}`);
+    return openProcessAsync(matches[0].pid, options);
+}
+/** 展示用：区域类型的可读名字 */
+function regionTypeName(type) {
+    if (type === types_1.MEM_IMAGE)
+        return 'MEM_IMAGE';
+    if (type === types_1.MEM_MAPPED)
+        return 'MEM_MAPPED';
+    if (type === types_1.MEM_PRIVATE)
+        return 'MEM_PRIVATE';
+    return 'MEM_FREE';
+}
+/** 默认最大用户态地址（供上层限制扫描范围） */
+exports.MAX_ADDRESS = types_1.MAX_USER_ADDRESS_64;
+//# sourceMappingURL=process.js.map

package/dist/cjs/win/process.js.map

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

package/dist/cjs/win/scan-worker.js

@@ -0,0 +1,84 @@
+"use strict";
+/**
+ * 扫描 worker —— 在独立线程中读取目标进程内存、执行比较，并把结果写入共享内存。
+ *
+ * 对应 CE 的 TScanner（TThread 子类）：CE 每条扫描线程负责一段内存，
+ * 通过临界区/信号量把结果写回主线程的地址缓冲区。
+ * 这里用 SharedArrayBuffer + Atomics 达到同样目的。
+ *
+ * 共享内存之所以必须共享：扫描 API 是同步的（对齐 CE 的阻塞语义），
+ * 主线程用 Atomics.wait 等待，此时无法处理 worker 的 postMessage。
+ *
+ * 容量约束：V8 对单个 SharedArrayBuffer 有约 1.5GB 上限，
+ * 因此每个 worker 批次使用**独立的、容量受控的**共享段，
+ * 而不是一个大段。详见 shared-layout.ts 的 createBatchLayout。
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+const node_worker_threads_1 = require("node:worker_threads");
+const process_1 = require("./process");
+const matcher_1 = require("../scanner/matcher");
+const shared_layout_1 = require("../scanner/shared-layout");
+let proc = null;
+let currentPid = -1;
+function ensureProcess(pid) {
+    if (proc && currentPid === pid && proc.isOpen)
+        return proc;
+    proc?.close();
+    proc = process_1.Process.open(pid);
+    currentPid = pid;
+    return proc;
+}
+const port = node_worker_threads_1.parentPort;
+if (!port) {
+    throw new Error('scan-worker 必须在 worker_threads 中运行');
+}
+port.on('message', (msg) => {
+    if (msg.type !== 'scan')
+        return;
+    const layout = (0, shared_layout_1.createBatchLayout)(msg.layoutParams.jobCount, msg.layoutParams.slotCapacity, msg.layoutParams.arenaCapacity, msg.shared);
+    let p = null;
+    let failed = 0;
+    try {
+        p = ensureProcess(msg.pid);
+    }
+    catch {
+        p = null;
+    }
+    const cc = (0, matcher_1.compileConfig)(msg.config);
+    for (let i = 0; i < msg.jobs.length; i++) {
+        const job = msg.jobs[i];
+        if (!p) {
+            (0, shared_layout_1.writeSlot)(layout, i, []);
+            (0, shared_layout_1.markHandled)(layout, i);
+            (0, shared_layout_1.markDone)(layout, true);
+            failed++;
+            continue;
+        }
+        try {
+            const buf = p.readMemory(BigInt(job.address), job.size);
+            if (buf.length === 0) {
+                (0, shared_layout_1.writeSlot)(layout, i, []);
+                (0, shared_layout_1.markHandled)(layout, i);
+                (0, shared_layout_1.markDone)(layout, false);
+                continue;
+            }
+            const offsets = [];
+            (0, matcher_1.scanBlock)(cc, buf, null, offsets, undefined);
+            (0, shared_layout_1.writeSlot)(layout, i, offsets);
+            if (msg.keepSnapshot && offsets.length > 0) {
+                (0, shared_layout_1.writeSnapshot)(layout, i, buf);
+            }
+            (0, shared_layout_1.markHandled)(layout, i);
+            (0, shared_layout_1.markDone)(layout, false);
+        }
+        catch {
+            (0, shared_layout_1.writeSlot)(layout, i, []);
+            (0, shared_layout_1.markHandled)(layout, i);
+            (0, shared_layout_1.markDone)(layout, true);
+            failed++;
+        }
+    }
+    port.postMessage({ type: 'batchDone', failed });
+});
+port.postMessage({ type: 'ready' });
+//# sourceMappingURL=scan-worker.js.map

package/dist/cjs/win/scan-worker.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"scan-worker.js","sourceRoot":"","sources":["../../../src/win/scan-worker.ts"],"names":[],"mappings":";AAAA;;;;;;;;;;;;;GAaG;;AAEH,6DAAiD;AACjD,uCAAoC;AACpC,gDAA8D;AAC9D,4DAOkC;AAyClC,IAAI,IAAI,GAAmB,IAAI,CAAC;AAChC,IAAI,UAAU,GAAG,CAAC,CAAC,CAAC;AAEpB,SAAS,aAAa,CAAC,GAAW;IAChC,IAAI,IAAI,IAAI,UAAU,KAAK,GAAG,IAAI,IAAI,CAAC,MAAM;QAAE,OAAO,IAAI,CAAC;IAC3D,IAAI,EAAE,KAAK,EAAE,CAAC;IACd,IAAI,GAAG,iBAAO,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;IACzB,UAAU,GAAG,GAAG,CAAC;IACjB,OAAO,IAAI,CAAC;AACd,CAAC;AAED,MAAM,IAAI,GAAG,gCAAU,CAAC;AACxB,IAAI,CAAC,IAAI,EAAE,CAAC;IACV,MAAM,IAAI,KAAK,CAAC,oCAAoC,CAAC,CAAC;AACxD,CAAC;AAED,IAAI,CAAC,EAAE,CAAC,SAAS,EAAE,CAAC,GAAsB,EAAE,EAAE;IAC5C,IAAI,GAAG,CAAC,IAAI,KAAK,MAAM;QAAE,OAAO;IAEhC,MAAM,MAAM,GAAiB,IAAA,iCAAiB,EAC5C,GAAG,CAAC,YAAY,CAAC,QAAQ,EACzB,GAAG,CAAC,YAAY,CAAC,YAAY,EAC7B,GAAG,CAAC,YAAY,CAAC,aAAa,EAC9B,GAAG,CAAC,MAAM,CACX,CAAC;IAEF,IAAI,CAAC,GAAmB,IAAI,CAAC;IAC7B,IAAI,MAAM,GAAG,CAAC,CAAC;IACf,IAAI,CAAC;QACH,CAAC,GAAG,aAAa,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;IAC7B,CAAC;IAAC,MAAM,CAAC;QACP,CAAC,GAAG,IAAI,CAAC;IACX,CAAC;IAED,MAAM,EAAE,GAAG,IAAA,uBAAa,EAAC,GAAG,CAAC,MAAM,CAAC,CAAC;IAErC,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,GAAG,CAAC,IAAI,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC;QACzC,MAAM,GAAG,GAAG,GAAG,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;QACxB,IAAI,CAAC,CAAC,EAAE,CAAC;YACP,IAAA,yBAAS,EAAC,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC;YACzB,IAAA,2BAAW,EAAC,MAAM,EAAE,CAAC,CAAC,CAAC;YACvB,IAAA,wBAAQ,EAAC,MAAM,EAAE,IAAI,CAAC,CAAC;YACvB,MAAM,EAAE,CAAC;YACT,SAAS;QACX,CAAC;QACD,IAAI,CAAC;YACH,MAAM,GAAG,GAAG,CAAC,CAAC,UAAU,CAAC,MAAM,CAAC,GAAG,CAAC,OAAO,CAAC,EAAE,GAAG,CAAC,IAAI,CAAC,CAAC;YACxD,IAAI,GAAG,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;gBACrB,IAAA,yBAAS,EAAC,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC;gBACzB,IAAA,2BAAW,EAAC,MAAM,EAAE,CAAC,CAAC,CAAC;gBACvB,IAAA,wBAAQ,EAAC,MAAM,EAAE,KAAK,CAAC,CAAC;gBACxB,SAAS;YACX,CAAC;YAED,MAAM,OAAO,GAAa,EAAE,CAAC;YAC7B,IAAA,mBAAS,EAAC,EAAE,EAAE,GAAG,EAAE,IAAI,EAAE,OAAO,EAAE,SAAS,CAAC,CAAC;YAC7C,IAAA,yBAAS,EAAC,MAAM,EAAE,CAAC,EAAE,OAAO,CAAC,CAAC;YAE9B,IAAI,GAAG,CAAC,YAAY,IAAI,OAAO,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;gBAC3C,IAAA,6BAAa,EAAC,MAAM,EAAE,CAAC,EAAE,GAAG,CAAC,CAAC;YAChC,CAAC;YACD,IAAA,2BAAW,EAAC,MAAM,EAAE,CAAC,CAAC,CAAC;YACvB,IAAA,wBAAQ,EAAC,MAAM,EAAE,KAAK,CAAC,CAAC;QAC1B,CAAC;QAAC,MAAM,CAAC;YACP,IAAA,yBAAS,EAAC,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC;YACzB,IAAA,2BAAW,EAAC,MAAM,EAAE,CAAC,CAAC,CAAC;YACvB,IAAA,wBAAQ,EAAC,MAAM,EAAE,IAAI,CAAC,CAAC;YACvB,MAAM,EAAE,CAAC;QACX,CAAC;IACH,CAAC;IAED,IAAI,CAAC,WAAW,CAAC,EAAE,IAAI,EAAE,WAAW,EAAE,MAAM,EAA2B,CAAC,CAAC;AAC3E,CAAC,CAAC,CAAC;AAEH,IAAI,CAAC,WAAW,CAAC,EAAE,IAAI,EAAE,OAAO,EAAE,CAAC,CAAC"}