@bingine/cemem 0.0.0-stage → 0.1.0

package/dist/cjs/scanner/shared-layout.js

@@ -0,0 +1,207 @@
+"use strict";
+/**
+ * 并行扫描的共享内存布局。
+ *
+ * 为什么需要共享内存：扫描 API 是同步的（对齐 CE 的 firstScan/nextScan 阻塞语义），
+ * 而 Node 主线程在同步函数里无法 await worker 的 postMessage。
+ * 因此主线程把结果区/快照区放在 SharedArrayBuffer 里，用 Atomics.wait 阻塞等待。
+ *
+ * 容量约束（重要）：
+ *   V8 对单个 SharedArrayBuffer 约 1.5GB 上限（实测 1610612736 字节即抛
+ *   RangeError）。因此**每个 worker 批次一个独立的、容量受控的共享段**，
+ *   而不是"N 块 × 4MB"组成的单个大段。
+ *
+ * 布局（按 8 字节对齐）：
+ *   [0] control：Int32Array(CONTROL_INTS)
+ *        [0] 待处理块数   [1] 已完成块数   [2] 失败块数   [3] 快照区水位
+ *   [1] slots：每块一个槽（2 个头 + slotCapacity 个偏移）
+ *        slots[i*SLOT_STRIDE + 0] = 命中数
+ *        slots[i*SLOT_STRIDE + 1] = 是否截断
+ *        slots[i*SLOT_STRIDE + 2 ..] = 命中偏移
+ *   [2] markers：每块 4 字节；-1 表示未保留快照，否则为 arena 内偏移
+ *   [3] handled：每块 4 字节；1 表示该块已被 worker 处理（用于检测 worker 启动失败）
+ *   [4] arena：快照数据区
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.SAB_MAX_BYTES = exports.CTRL_ARENA_USED = exports.CTRL_FAILED = exports.CTRL_DONE = exports.CTRL_PENDING = exports.CONTROL_INTS = exports.DEFAULT_SLOT_CAPACITY = void 0;
+exports.createBatchLayout = createBatchLayout;
+exports.resetShared = resetShared;
+exports.writeSlot = writeSlot;
+exports.readSlot = readSlot;
+exports.writeSnapshot = writeSnapshot;
+exports.readSnapshot = readSnapshot;
+exports.markDone = markDone;
+exports.markHandled = markHandled;
+exports.waitAll = waitAll;
+exports.createWorkerRequestLayout = createWorkerRequestLayout;
+exports.createWorkerReplyLayout = createWorkerReplyLayout;
+/** 默认每块结果槽可容纳的偏移数（64KB / 4B） */
+exports.DEFAULT_SLOT_CAPACITY = 16 * 1024;
+/** control 区 Int32 数量 */
+exports.CONTROL_INTS = 8;
+exports.CTRL_PENDING = 0;
+exports.CTRL_DONE = 1;
+exports.CTRL_FAILED = 2;
+exports.CTRL_ARENA_USED = 3;
+/** V8 对 SharedArrayBuffer 的实际上限（留出安全余量） */
+exports.SAB_MAX_BYTES = 1_000_000_000;
+/**
+ * 构建一个批次用的共享布局。
+ *
+ * @param jobCount      本批次的块数
+ * @param slotCapacity  每块的偏移容量
+ * @param arenaCapacity 快照区容量（字节）
+ * @param existing      已存在的共享内存（worker 侧重建视图时传入）；
+ *                      省略则新建一块。
+ */
+function createBatchLayout(jobCount, slotCapacity, arenaCapacity, existing) {
+    const slotStride = 2 + slotCapacity;
+    const slotsInts = jobCount * slotStride;
+    const markersBytes = align8(jobCount * 4);
+    const handledBytes = align8(jobCount * 4);
+    const controlBytes = exports.CONTROL_INTS * 4;
+    const slotsBytes = slotsInts * 4;
+    const baseBytes = controlBytes + slotsBytes + markersBytes + handledBytes;
+    let buffer;
+    let arena;
+    if (existing) {
+        buffer = existing;
+        arena = Math.max(0, existing.byteLength - baseBytes);
+    }
+    else {
+        // 容量保护：确保单个 SAB 不超过 V8 上限
+        arena = Math.max(0, Math.min(arenaCapacity, exports.SAB_MAX_BYTES - baseBytes));
+        buffer = new SharedArrayBuffer(baseBytes + arena);
+    }
+    const control = new Int32Array(buffer, 0, exports.CONTROL_INTS);
+    const slots = new Int32Array(buffer, controlBytes, slotsInts);
+    const markers = new Int32Array(buffer, controlBytes + slotsBytes, jobCount);
+    const handled = new Int32Array(buffer, controlBytes + slotsBytes + markersBytes, jobCount);
+    const arenaView = new Uint8Array(buffer, baseBytes, arena);
+    const layout = {
+        buffer,
+        slots,
+        markers,
+        handled,
+        arena: arenaView,
+        control,
+        slotStride,
+        slotCapacity,
+        jobCount,
+        arenaCapacity: arena,
+    };
+    if (!existing)
+        resetShared(layout);
+    return layout;
+}
+function align8(n) {
+    return (n + 7) & ~7;
+}
+/** 重置共享区状态。 */
+function resetShared(layout) {
+    Atomics.store(layout.control, exports.CTRL_PENDING, layout.jobCount);
+    Atomics.store(layout.control, exports.CTRL_DONE, 0);
+    Atomics.store(layout.control, exports.CTRL_FAILED, 0);
+    Atomics.store(layout.control, exports.CTRL_ARENA_USED, 0);
+    for (let i = 0; i < layout.jobCount; i++) {
+        const b = i * layout.slotStride;
+        Atomics.store(layout.slots, b, 0);
+        Atomics.store(layout.slots, b + 1, 0);
+        layout.markers[i] = -1;
+        Atomics.store(layout.handled, i, 0);
+    }
+}
+/** worker 侧：写入某块的命中偏移列表。 */
+function writeSlot(layout, index, offsets) {
+    const base = index * layout.slotStride;
+    const n = Math.min(offsets.length, layout.slotCapacity);
+    const truncated = offsets.length > layout.slotCapacity ? 1 : 0;
+    // 先写数据与头，最后原子写命中数，保证主线程看到 cnt 时数据已就绪
+    for (let i = 0; i < n; i++)
+        layout.slots[base + 2 + i] = offsets[i];
+    Atomics.store(layout.slots, base + 1, truncated);
+    Atomics.store(layout.slots, base, n);
+}
+/** 主线程侧：读取某块的命中偏移。 */
+function readSlot(layout, index) {
+    const base = index * layout.slotStride;
+    const n = Atomics.load(layout.slots, base);
+    const truncated = Atomics.load(layout.slots, base + 1) === 1;
+    const offsets = new Array(n);
+    for (let i = 0; i < n; i++)
+        offsets[i] = layout.slots[base + 2 + i];
+    return { offsets, truncated };
+}
+/**
+ * worker 侧：在快照竞技场中为某块抢占空间并写入。
+ * 空间不足时放弃保留（next scan 会退化为"无旧值可用"）。
+ */
+function writeSnapshot(layout, index, data) {
+    if (data.length > layout.arenaCapacity) {
+        layout.markers[index] = -1;
+        return false;
+    }
+    const prev = Atomics.add(layout.control, exports.CTRL_ARENA_USED, data.length);
+    if (prev + data.length > layout.arenaCapacity) {
+        Atomics.sub(layout.control, exports.CTRL_ARENA_USED, data.length);
+        layout.markers[index] = -1;
+        return false;
+    }
+    layout.arena.set(data, prev);
+    // 用 Atomics.store 发布，确保主线程看到偏移时数据已写入
+    Atomics.store(layout.markers, index, prev);
+    return true;
+}
+/** 主线程侧：读取某块的快照。 */
+function readSnapshot(layout, index, size) {
+    const off = Atomics.load(layout.markers, index);
+    if (off < 0)
+        return null;
+    if (off + size > layout.arenaCapacity)
+        return null;
+    const copy = Buffer.allocUnsafe(size);
+    copy.set(layout.arena.subarray(off, off + size));
+    return copy;
+}
+/** worker 侧：标记本块已完成。 */
+function markDone(layout, failed) {
+    if (failed)
+        Atomics.add(layout.control, exports.CTRL_FAILED, 1);
+    Atomics.add(layout.control, exports.CTRL_DONE, 1);
+    Atomics.notify(layout.control, exports.CTRL_DONE);
+}
+/** worker 侧：标记本块已被处理（无论成功与否）。 */
+function markHandled(layout, index) {
+    Atomics.store(layout.handled, index, 1);
+}
+/** 主线程侧：同步等待本批次所有块完成。 */
+function waitAll(layout, timeoutMs = 0) {
+    let waited = 0;
+    for (;;) {
+        const done = Atomics.load(layout.control, exports.CTRL_DONE);
+        const pending = Atomics.load(layout.control, exports.CTRL_PENDING);
+        if (done >= pending)
+            return true;
+        const r = Atomics.wait(layout.control, exports.CTRL_DONE, done, 1000);
+        if (r === 'timed-out') {
+            waited += 1000;
+            if (timeoutMs > 0 && waited >= timeoutMs)
+                return false;
+        }
+    }
+}
+/** 创建请求/响应区（主线程侧） */
+function createWorkerRequestLayout(ctrlInts, capacity) {
+    const buffer = new SharedArrayBuffer(ctrlInts * 4 + capacity);
+    return {
+        buffer,
+        ctrl: new Int32Array(buffer, 0, ctrlInts),
+        data: new Uint8Array(buffer, ctrlInts * 4, capacity),
+        capacity,
+    };
+}
+/** 创建响应区（主线程侧）。与请求区布局相同，单独成函数便于两端语义对称。 */
+function createWorkerReplyLayout(ctrlInts, capacity) {
+    return createWorkerRequestLayout(ctrlInts, capacity);
+}
+//# sourceMappingURL=shared-layout.js.map

package/dist/cjs/scanner/shared-layout.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"shared-layout.js","sourceRoot":"","sources":["../../../src/scanner/shared-layout.ts"],"names":[],"mappings":";AAAA;;;;;;;;;;;;;;;;;;;;;;GAsBG;;;AA6CH,8CA+CC;AAOD,kCAYC;AAGD,8BAQC;AAGD,4BAUC;AAMD,sCAeC;AAGD,oCAOC;AAGD,4BAIC;AAGD,kCAEC;AAGD,0BAYC;AAoBD,8DAQC;AAGD,0DAEC;AAhOD,gCAAgC;AACnB,QAAA,qBAAqB,GAAG,EAAE,GAAG,IAAI,CAAC;AAE/C,yBAAyB;AACZ,QAAA,YAAY,GAAG,CAAC,CAAC;AAEjB,QAAA,YAAY,GAAG,CAAC,CAAC;AACjB,QAAA,SAAS,GAAG,CAAC,CAAC;AACd,QAAA,WAAW,GAAG,CAAC,CAAC;AAChB,QAAA,eAAe,GAAG,CAAC,CAAC;AAEjC,2CAA2C;AAC9B,QAAA,aAAa,GAAG,aAAa,CAAC;AAsB3C;;;;;;;;GAQG;AACH,SAAgB,iBAAiB,CAC/B,QAAgB,EAChB,YAAoB,EACpB,aAAqB,EACrB,QAA4B;IAE5B,MAAM,UAAU,GAAG,CAAC,GAAG,YAAY,CAAC;IACpC,MAAM,SAAS,GAAG,QAAQ,GAAG,UAAU,CAAC;IACxC,MAAM,YAAY,GAAG,MAAM,CAAC,QAAQ,GAAG,CAAC,CAAC,CAAC;IAC1C,MAAM,YAAY,GAAG,MAAM,CAAC,QAAQ,GAAG,CAAC,CAAC,CAAC;IAE1C,MAAM,YAAY,GAAG,oBAAY,GAAG,CAAC,CAAC;IACtC,MAAM,UAAU,GAAG,SAAS,GAAG,CAAC,CAAC;IACjC,MAAM,SAAS,GAAG,YAAY,GAAG,UAAU,GAAG,YAAY,GAAG,YAAY,CAAC;IAE1E,IAAI,MAAyB,CAAC;IAC9B,IAAI,KAAa,CAAC;IAElB,IAAI,QAAQ,EAAE,CAAC;QACb,MAAM,GAAG,QAAQ,CAAC;QAClB,KAAK,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,QAAQ,CAAC,UAAU,GAAG,SAAS,CAAC,CAAC;IACvD,CAAC;SAAM,CAAC;QACN,0BAA0B;QAC1B,KAAK,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,IAAI,CAAC,GAAG,CAAC,aAAa,EAAE,qBAAa,GAAG,SAAS,CAAC,CAAC,CAAC;QACxE,MAAM,GAAG,IAAI,iBAAiB,CAAC,SAAS,GAAG,KAAK,CAAC,CAAC;IACpD,CAAC;IAED,MAAM,OAAO,GAAG,IAAI,UAAU,CAAC,MAAM,EAAE,CAAC,EAAE,oBAAY,CAAC,CAAC;IACxD,MAAM,KAAK,GAAG,IAAI,UAAU,CAAC,MAAM,EAAE,YAAY,EAAE,SAAS,CAAC,CAAC;IAC9D,MAAM,OAAO,GAAG,IAAI,UAAU,CAAC,MAAM,EAAE,YAAY,GAAG,UAAU,EAAE,QAAQ,CAAC,CAAC;IAC5E,MAAM,OAAO,GAAG,IAAI,UAAU,CAAC,MAAM,EAAE,YAAY,GAAG,UAAU,GAAG,YAAY,EAAE,QAAQ,CAAC,CAAC;IAC3F,MAAM,SAAS,GAAG,IAAI,UAAU,CAAC,MAAM,EAAE,SAAS,EAAE,KAAK,CAAC,CAAC;IAE3D,MAAM,MAAM,GAAiB;QAC3B,MAAM;QACN,KAAK;QACL,OAAO;QACP,OAAO;QACP,KAAK,EAAE,SAAS;QAChB,OAAO;QACP,UAAU;QACV,YAAY;QACZ,QAAQ;QACR,aAAa,EAAE,KAAK;KACrB,CAAC;IACF,IAAI,CAAC,QAAQ;QAAE,WAAW,CAAC,MAAM,CAAC,CAAC;IACnC,OAAO,MAAM,CAAC;AAChB,CAAC;AAED,SAAS,MAAM,CAAC,CAAS;IACvB,OAAO,CAAC,CAAC,GAAG,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC;AACtB,CAAC;AAED,eAAe;AACf,SAAgB,WAAW,CAAC,MAAoB;IAC9C,OAAO,CAAC,KAAK,CAAC,MAAM,CAAC,OAAO,EAAE,oBAAY,EAAE,MAAM,CAAC,QAAQ,CAAC,CAAC;IAC7D,OAAO,CAAC,KAAK,CAAC,MAAM,CAAC,OAAO,EAAE,iBAAS,EAAE,CAAC,CAAC,CAAC;IAC5C,OAAO,CAAC,KAAK,CAAC,MAAM,CAAC,OAAO,EAAE,mBAAW,EAAE,CAAC,CAAC,CAAC;IAC9C,OAAO,CAAC,KAAK,CAAC,MAAM,CAAC,OAAO,EAAE,uBAAe,EAAE,CAAC,CAAC,CAAC;IAClD,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,MAAM,CAAC,QAAQ,EAAE,CAAC,EAAE,EAAE,CAAC;QACzC,MAAM,CAAC,GAAG,CAAC,GAAG,MAAM,CAAC,UAAU,CAAC;QAChC,OAAO,CAAC,KAAK,CAAC,MAAM,CAAC,KAAK,EAAE,CAAC,EAAE,CAAC,CAAC,CAAC;QAClC,OAAO,CAAC,KAAK,CAAC,MAAM,CAAC,KAAK,EAAE,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC,CAAC;QACtC,MAAM,CAAC,OAAO,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC;QACvB,OAAO,CAAC,KAAK,CAAC,MAAM,CAAC,OAAO,EAAE,CAAC,EAAE,CAAC,CAAC,CAAC;IACtC,CAAC;AACH,CAAC;AAED,4BAA4B;AAC5B,SAAgB,SAAS,CAAC,MAAoB,EAAE,KAAa,EAAE,OAAiB;IAC9E,MAAM,IAAI,GAAG,KAAK,GAAG,MAAM,CAAC,UAAU,CAAC;IACvC,MAAM,CAAC,GAAG,IAAI,CAAC,GAAG,CAAC,OAAO,CAAC,MAAM,EAAE,MAAM,CAAC,YAAY,CAAC,CAAC;IACxD,MAAM,SAAS,GAAG,OAAO,CAAC,MAAM,GAAG,MAAM,CAAC,YAAY,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;IAC/D,qCAAqC;IACrC,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,CAAC,EAAE,CAAC,EAAE;QAAE,MAAM,CAAC,KAAK,CAAC,IAAI,GAAG,CAAC,GAAG,CAAC,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC,CAAC;IACpE,OAAO,CAAC,KAAK,CAAC,MAAM,CAAC,KAAK,EAAE,IAAI,GAAG,CAAC,EAAE,SAAS,CAAC,CAAC;IACjD,OAAO,CAAC,KAAK,CAAC,MAAM,CAAC,KAAK,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC;AACvC,CAAC;AAED,sBAAsB;AACtB,SAAgB,QAAQ,CACtB,MAAoB,EACpB,KAAa;IAEb,MAAM,IAAI,GAAG,KAAK,GAAG,MAAM,CAAC,UAAU,CAAC;IACvC,MAAM,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC,MAAM,CAAC,KAAK,EAAE,IAAI,CAAC,CAAC;IAC3C,MAAM,SAAS,GAAG,OAAO,CAAC,IAAI,CAAC,MAAM,CAAC,KAAK,EAAE,IAAI,GAAG,CAAC,CAAC,KAAK,CAAC,CAAC;IAC7D,MAAM,OAAO,GAAG,IAAI,KAAK,CAAS,CAAC,CAAC,CAAC;IACrC,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,CAAC,EAAE,CAAC,EAAE;QAAE,OAAO,CAAC,CAAC,CAAC,GAAG,MAAM,CAAC,KAAK,CAAC,IAAI,GAAG,CAAC,GAAG,CAAC,CAAC,CAAC;IACpE,OAAO,EAAE,OAAO,EAAE,SAAS,EAAE,CAAC;AAChC,CAAC;AAED;;;GAGG;AACH,SAAgB,aAAa,CAAC,MAAoB,EAAE,KAAa,EAAE,IAAY;IAC7E,IAAI,IAAI,CAAC,MAAM,GAAG,MAAM,CAAC,aAAa,EAAE,CAAC;QACvC,MAAM,CAAC,OAAO,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC;QAC3B,OAAO,KAAK,CAAC;IACf,CAAC;IACD,MAAM,IAAI,GAAG,OAAO,CAAC,GAAG,CAAC,MAAM,CAAC,OAAO,EAAE,uBAAe,EAAE,IAAI,CAAC,MAAM,CAAC,CAAC;IACvE,IAAI,IAAI,GAAG,IAAI,CAAC,MAAM,GAAG,MAAM,CAAC,aAAa,EAAE,CAAC;QAC9C,OAAO,CAAC,GAAG,CAAC,MAAM,CAAC,OAAO,EAAE,uBAAe,EAAE,IAAI,CAAC,MAAM,CAAC,CAAC;QAC1D,MAAM,CAAC,OAAO,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC;QAC3B,OAAO,KAAK,CAAC;IACf,CAAC;IACD,MAAM,CAAC,KAAK,CAAC,GAAG,CAAC,IAAI,EAAE,IAAI,CAAC,CAAC;IAC7B,qCAAqC;IACrC,OAAO,CAAC,KAAK,CAAC,MAAM,CAAC,OAAO,EAAE,KAAK,EAAE,IAAI,CAAC,CAAC;IAC3C,OAAO,IAAI,CAAC;AACd,CAAC;AAED,oBAAoB;AACpB,SAAgB,YAAY,CAAC,MAAoB,EAAE,KAAa,EAAE,IAAY;IAC5E,MAAM,GAAG,GAAG,OAAO,CAAC,IAAI,CAAC,MAAM,CAAC,OAAO,EAAE,KAAK,CAAC,CAAC;IAChD,IAAI,GAAG,GAAG,CAAC;QAAE,OAAO,IAAI,CAAC;IACzB,IAAI,GAAG,GAAG,IAAI,GAAG,MAAM,CAAC,aAAa;QAAE,OAAO,IAAI,CAAC;IACnD,MAAM,IAAI,GAAG,MAAM,CAAC,WAAW,CAAC,IAAI,CAAC,CAAC;IACtC,IAAI,CAAC,GAAG,CAAC,MAAM,CAAC,KAAK,CAAC,QAAQ,CAAC,GAAG,EAAE,GAAG,GAAG,IAAI,CAAC,CAAC,CAAC;IACjD,OAAO,IAAI,CAAC;AACd,CAAC;AAED,wBAAwB;AACxB,SAAgB,QAAQ,CAAC,MAAoB,EAAE,MAAe;IAC5D,IAAI,MAAM;QAAE,OAAO,CAAC,GAAG,CAAC,MAAM,CAAC,OAAO,EAAE,mBAAW,EAAE,CAAC,CAAC,CAAC;IACxD,OAAO,CAAC,GAAG,CAAC,MAAM,CAAC,OAAO,EAAE,iBAAS,EAAE,CAAC,CAAC,CAAC;IAC1C,OAAO,CAAC,MAAM,CAAC,MAAM,CAAC,OAAO,EAAE,iBAAS,CAAC,CAAC;AAC5C,CAAC;AAED,iCAAiC;AACjC,SAAgB,WAAW,CAAC,MAAoB,EAAE,KAAa;IAC7D,OAAO,CAAC,KAAK,CAAC,MAAM,CAAC,OAAO,EAAE,KAAK,EAAE,CAAC,CAAC,CAAC;AAC1C,CAAC;AAED,yBAAyB;AACzB,SAAgB,OAAO,CAAC,MAAoB,EAAE,SAAS,GAAG,CAAC;IACzD,IAAI,MAAM,GAAG,CAAC,CAAC;IACf,SAAS,CAAC;QACR,MAAM,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,MAAM,CAAC,OAAO,EAAE,iBAAS,CAAC,CAAC;QACrD,MAAM,OAAO,GAAG,OAAO,CAAC,IAAI,CAAC,MAAM,CAAC,OAAO,EAAE,oBAAY,CAAC,CAAC;QAC3D,IAAI,IAAI,IAAI,OAAO;YAAE,OAAO,IAAI,CAAC;QACjC,MAAM,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC,MAAM,CAAC,OAAO,EAAE,iBAAS,EAAE,IAAI,EAAE,IAAI,CAAC,CAAC;QAC9D,IAAI,CAAC,KAAK,WAAW,EAAE,CAAC;YACtB,MAAM,IAAI,IAAI,CAAC;YACf,IAAI,SAAS,GAAG,CAAC,IAAI,MAAM,IAAI,SAAS;gBAAE,OAAO,KAAK,CAAC;QACzD,CAAC;IACH,CAAC;AACH,CAAC;AAmBD,qBAAqB;AACrB,SAAgB,yBAAyB,CAAC,QAAgB,EAAE,QAAgB;IAC1E,MAAM,MAAM,GAAG,IAAI,iBAAiB,CAAC,QAAQ,GAAG,CAAC,GAAG,QAAQ,CAAC,CAAC;IAC9D,OAAO;QACL,MAAM;QACN,IAAI,EAAE,IAAI,UAAU,CAAC,MAAM,EAAE,CAAC,EAAE,QAAQ,CAAC;QACzC,IAAI,EAAE,IAAI,UAAU,CAAC,MAAM,EAAE,QAAQ,GAAG,CAAC,EAAE,QAAQ,CAAC;QACpD,QAAQ;KACT,CAAC;AACJ,CAAC;AAED,0CAA0C;AAC1C,SAAgB,uBAAuB,CAAC,QAAgB,EAAE,QAAgB;IACxE,OAAO,yBAAyB,CAAC,QAAQ,EAAE,QAAQ,CAAC,CAAC;AACvD,CAAC"}

package/dist/cjs/types.js

@@ -0,0 +1,190 @@
+"use strict";
+/**
+ * 核心类型定义 —— 与 Cheat Engine 源码严格对齐。
+ *
+ * 对齐依据（`Cheat Engine/memscan.pas`）：
+ *   type TScanType=(stNewScan=0, stFirstScan=1, stNextScan=2);
+ *   type TRoundingType=(rtRounded=0,rtExtremerounded=1,rtTruncated=2);
+ *   type TVariableType=(vtByte=0, vtWord=1, vtDword=2, vtQword=3, vtSingle=4, vtDouble=5,
+ *      vtString=6, vtUnicodeString=7, vtByteArray=8, vtBinary=9, vtAll=10,
+ *      vtAutoAssembler=11, vtPointer=12, vtCustom=13, vtGrouped=14, vtByteArrays=15,
+ *      vtCodePageString=16);
+ *   type TPointerType=(ptStatic, ptDynamic, ptExecutable);
+ *   type TScanOption=(soUnknownValue, soExactValue, soValueBetween, soBiggerThan,
+ *      soSmallerThan, soIncreasedValue, soIncreasedValueBy, soDecreasedValue,
+ *      soDecreasedValueBy, soChanged, soUnchanged, soIncreasedValueByPercentage,
+ *      soDecreasedValueByPercentage, soValueBetweenPercentage);
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.MAX_USER_ADDRESS_64 = exports.DEFAULT_PROCESS_ACCESS = exports.PROCESS_SUSPEND_RESUME = exports.PROCESS_QUERY_LIMITED_INFORMATION = exports.PROCESS_QUERY_INFORMATION = exports.PROCESS_VM_WRITE = exports.PROCESS_VM_READ = exports.PROCESS_VM_OPERATION = exports.PROCESS_CREATE_THREAD = exports.PROCESS_TERMINATE = exports.PAGE_WRITECOMBINE = exports.PAGE_NOCACHE = exports.PAGE_GUARD = exports.PAGE_EXECUTE_WRITECOPY = exports.PAGE_EXECUTE_READWRITE = exports.PAGE_EXECUTE_READ = exports.PAGE_EXECUTE = exports.PAGE_WRITECOPY = exports.PAGE_READWRITE = exports.PAGE_READONLY = exports.PAGE_NOACCESS = exports.MEM_IMAGE = exports.MEM_MAPPED = exports.MEM_PRIVATE = exports.MEM_FREE = exports.MEM_RESERVE = exports.MEM_COMMIT = exports.FastScanMethod = exports.PointerType = exports.ScanType = exports.RoundingType = exports.SCAN_OPTION_NAMES = exports.ScanOption = exports.VARIABLE_TYPE_SIZES = exports.VARIABLE_TYPE_NAMES = exports.VariableType = void 0;
+exports.allPointerTypes = allPointerTypes;
+/** CE 的 TVariableType，枚举值与源码一一对应。 */
+var VariableType;
+(function (VariableType) {
+    VariableType[VariableType["Byte"] = 0] = "Byte";
+    VariableType[VariableType["Word"] = 1] = "Word";
+    VariableType[VariableType["DWord"] = 2] = "DWord";
+    VariableType[VariableType["QWord"] = 3] = "QWord";
+    VariableType[VariableType["Single"] = 4] = "Single";
+    VariableType[VariableType["Double"] = 5] = "Double";
+    VariableType[VariableType["String"] = 6] = "String";
+    VariableType[VariableType["UnicodeString"] = 7] = "UnicodeString";
+    VariableType[VariableType["ByteArray"] = 8] = "ByteArray";
+    VariableType[VariableType["Binary"] = 9] = "Binary";
+    VariableType[VariableType["All"] = 10] = "All";
+    VariableType[VariableType["AutoAssembler"] = 11] = "AutoAssembler";
+    VariableType[VariableType["Pointer"] = 12] = "Pointer";
+    VariableType[VariableType["Custom"] = 13] = "Custom";
+    VariableType[VariableType["Grouped"] = 14] = "Grouped";
+    VariableType[VariableType["ByteArrays"] = 15] = "ByteArrays";
+    VariableType[VariableType["CodePageString"] = 16] = "CodePageString";
+})(VariableType || (exports.VariableType = VariableType = {}));
+/** 类型名（用于命令行/日志） */
+exports.VARIABLE_TYPE_NAMES = {
+    [VariableType.Byte]: 'byte',
+    [VariableType.Word]: 'word',
+    [VariableType.DWord]: 'dword',
+    [VariableType.QWord]: 'qword',
+    [VariableType.Single]: 'float',
+    [VariableType.Double]: 'double',
+    [VariableType.String]: 'string',
+    [VariableType.UnicodeString]: 'unicode',
+    [VariableType.ByteArray]: 'aob',
+    [VariableType.Binary]: 'binary',
+    [VariableType.All]: 'all',
+    [VariableType.AutoAssembler]: 'autoassembler',
+    [VariableType.Pointer]: 'pointer',
+    [VariableType.Custom]: 'custom',
+    [VariableType.Grouped]: 'grouped',
+    [VariableType.ByteArrays]: 'aobs',
+    [VariableType.CodePageString]: 'codepagestring',
+};
+/** 每种类型占用的字节宽度；变长/特殊类型为 0（由使用者显式给长度）。 */
+exports.VARIABLE_TYPE_SIZES = {
+    [VariableType.Byte]: 1,
+    [VariableType.Word]: 2,
+    [VariableType.DWord]: 4,
+    [VariableType.QWord]: 8,
+    [VariableType.Single]: 4,
+    [VariableType.Double]: 8,
+    [VariableType.String]: 0,
+    [VariableType.UnicodeString]: 0,
+    [VariableType.ByteArray]: 0,
+    [VariableType.Binary]: 0,
+    [VariableType.All]: 0,
+    [VariableType.AutoAssembler]: 0,
+    [VariableType.Pointer]: 8,
+    [VariableType.Custom]: 0,
+    [VariableType.Grouped]: 0,
+    [VariableType.ByteArrays]: 0,
+    [VariableType.CodePageString]: 0,
+};
+/** CE 的 TScanOption */
+var ScanOption;
+(function (ScanOption) {
+    ScanOption[ScanOption["UnknownValue"] = 0] = "UnknownValue";
+    ScanOption[ScanOption["ExactValue"] = 1] = "ExactValue";
+    ScanOption[ScanOption["ValueBetween"] = 2] = "ValueBetween";
+    ScanOption[ScanOption["BiggerThan"] = 3] = "BiggerThan";
+    ScanOption[ScanOption["SmallerThan"] = 4] = "SmallerThan";
+    ScanOption[ScanOption["IncreasedValue"] = 5] = "IncreasedValue";
+    ScanOption[ScanOption["IncreasedValueBy"] = 6] = "IncreasedValueBy";
+    ScanOption[ScanOption["DecreasedValue"] = 7] = "DecreasedValue";
+    ScanOption[ScanOption["DecreasedValueBy"] = 8] = "DecreasedValueBy";
+    ScanOption[ScanOption["Changed"] = 9] = "Changed";
+    ScanOption[ScanOption["Unchanged"] = 10] = "Unchanged";
+    ScanOption[ScanOption["IncreasedValueByPercentage"] = 11] = "IncreasedValueByPercentage";
+    ScanOption[ScanOption["DecreasedValueByPercentage"] = 12] = "DecreasedValueByPercentage";
+    ScanOption[ScanOption["ValueBetweenPercentage"] = 13] = "ValueBetweenPercentage";
+})(ScanOption || (exports.ScanOption = ScanOption = {}));
+exports.SCAN_OPTION_NAMES = {
+    [ScanOption.UnknownValue]: '未知初始值',
+    [ScanOption.ExactValue]: '精确数值',
+    [ScanOption.ValueBetween]: '数值介于',
+    [ScanOption.BiggerThan]: '大于',
+    [ScanOption.SmallerThan]: '小于',
+    [ScanOption.IncreasedValue]: '增加了',
+    [ScanOption.IncreasedValueBy]: '增加指定数值',
+    [ScanOption.DecreasedValue]: '减少了',
+    [ScanOption.DecreasedValueBy]: '减少指定数值',
+    [ScanOption.Changed]: '变动了',
+    [ScanOption.Unchanged]: '未变动',
+    [ScanOption.IncreasedValueByPercentage]: '增加百分比',
+    [ScanOption.DecreasedValueByPercentage]: '减少百分比',
+    [ScanOption.ValueBetweenPercentage]: '数值介于百分比',
+};
+/** CE 的 TRoundingType：浮点比较策略 */
+var RoundingType;
+(function (RoundingType) {
+    /** rtRounded=0 —— 四舍五入到小数位数后严格相等 */
+    RoundingType[RoundingType["Rounded"] = 0] = "Rounded";
+    /** rtExtremerounded=1 —— 落在 [value-eps, value+eps] 区间 */
+    RoundingType[RoundingType["ExtremeRounded"] = 1] = "ExtremeRounded";
+    /** rtTruncated=2 —— [value, value+step) 左闭右开 */
+    RoundingType[RoundingType["Truncated"] = 2] = "Truncated";
+})(RoundingType || (exports.RoundingType = RoundingType = {}));
+/** CE 的 TScanType */
+var ScanType;
+(function (ScanType) {
+    ScanType[ScanType["NewScan"] = 0] = "NewScan";
+    ScanType[ScanType["FirstScan"] = 1] = "FirstScan";
+    ScanType[ScanType["NextScan"] = 2] = "NextScan";
+})(ScanType || (exports.ScanType = ScanType = {}));
+/** CE 的 TPointerType */
+var PointerType;
+(function (PointerType) {
+    PointerType[PointerType["Static"] = 0] = "Static";
+    PointerType[PointerType["Dynamic"] = 1] = "Dynamic";
+    PointerType[PointerType["Executable"] = 2] = "Executable";
+})(PointerType || (exports.PointerType = PointerType = {}));
+/** CE 的 TFastScanMethod */
+var FastScanMethod;
+(function (FastScanMethod) {
+    FastScanMethod[FastScanMethod["NotAligned"] = 0] = "NotAligned";
+    FastScanMethod[FastScanMethod["Aligned"] = 1] = "Aligned";
+    FastScanMethod[FastScanMethod["LastDigits"] = 2] = "LastDigits";
+})(FastScanMethod || (exports.FastScanMethod = FastScanMethod = {}));
+/** 创建"全部指针类型"的便捷值，对齐 CE 默认。 */
+function allPointerTypes() {
+    return { static: true, dynamic: true, executable: true };
+}
+/** 内存保护常量 */
+exports.MEM_COMMIT = 0x1000;
+exports.MEM_RESERVE = 0x2000;
+exports.MEM_FREE = 0x10000;
+exports.MEM_PRIVATE = 0x20000;
+exports.MEM_MAPPED = 0x40000;
+exports.MEM_IMAGE = 0x1000000;
+exports.PAGE_NOACCESS = 0x01;
+exports.PAGE_READONLY = 0x02;
+exports.PAGE_READWRITE = 0x04;
+exports.PAGE_WRITECOPY = 0x08;
+exports.PAGE_EXECUTE = 0x10;
+exports.PAGE_EXECUTE_READ = 0x20;
+exports.PAGE_EXECUTE_READWRITE = 0x40;
+exports.PAGE_EXECUTE_WRITECOPY = 0x80;
+exports.PAGE_GUARD = 0x100;
+exports.PAGE_NOCACHE = 0x200;
+exports.PAGE_WRITECOMBINE = 0x400;
+/** 进程访问权限常量 */
+exports.PROCESS_TERMINATE = 0x0001;
+exports.PROCESS_CREATE_THREAD = 0x0002;
+exports.PROCESS_VM_OPERATION = 0x0008;
+exports.PROCESS_VM_READ = 0x0010;
+exports.PROCESS_VM_WRITE = 0x0020;
+exports.PROCESS_QUERY_INFORMATION = 0x0400;
+exports.PROCESS_QUERY_LIMITED_INFORMATION = 0x1000;
+exports.PROCESS_SUSPEND_RESUME = 0x0800;
+/**
+ * 打开进程所需的最小权限组合。
+ * 对齐 CE 的 ProcessHandler：读写 + 查询 + 分配/保护内存。
+ */
+exports.DEFAULT_PROCESS_ACCESS = exports.PROCESS_QUERY_INFORMATION |
+    exports.PROCESS_VM_READ |
+    exports.PROCESS_VM_WRITE |
+    exports.PROCESS_VM_OPERATION |
+    exports.PROCESS_CREATE_THREAD |
+    exports.PROCESS_SUSPEND_RESUME;
+/** 64 位用户态最高地址（不含），用于 VirtualQueryEx 遍历上界。 */
+exports.MAX_USER_ADDRESS_64 = 0x7fffffffffffn;
+//# sourceMappingURL=types.js.map

package/dist/cjs/types.js.map

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