@bingine/cemem 0.0.0-stage → 0.1.0

package/dist/cjs/index.js

@@ -0,0 +1,219 @@
+"use strict";
+/**
+ * node-cheat-engine —— Cheat Engine 核心引擎的 Node.js 移植版。
+ *
+ * 公共 API 入口。设计目标：用 Node 复刻 CE 在**用户态**能做的核心能力：
+ * 跨进程内存读写、全类型内存扫描（对齐 memscan.pas 的比较语义）、
+ * 指针扫描、地址表与 .CT 读写、地址表达式解析、脚本桥。
+ *
+ * 明确不在范围内（Node 中不存在实现路径，详见 PORT-SCOPE.md）：
+ *   - dbk32/DBKKernel 内核驱动：ring-0 物理内存读写、绕过进程保护
+ *   - dbvm/DBVM UEFI：VT-x/AMD-V hypervisor、硬件断点与隐身
+ *   - LCL/VCL 图形界面（.lfm 窗体）
+ *   - x86/x64 反汇编与汇编器（原样保留 AutoAssembler 语义需要独立移植）
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.DbkBackend = exports.CESERVER_DEFAULT_PORT = exports.CESERVER_CMD = exports.CeReader = exports.CeWriter = exports.CeServerConnection = exports.NativeCeBackend = exports.filterScanRegions = exports.SelfBackend = exports.BackendUnsupportedError = exports.aobHasNibbleWildcard = exports.aobMatchesAt = exports.doubleMatches = exports.singleMatches = exports.buildFloatCompareParams = exports.parseBinaryPattern = exports.parseAob = exports.decimalsOf = exports.parseFloatLiteral = exports.parseIntegerLiteral = exports.roundTo = exports.DEFAULT_PROCESS_ACCESS = exports.PROCESS_QUERY_INFORMATION = exports.PROCESS_VM_OPERATION = exports.PROCESS_VM_WRITE = exports.PROCESS_VM_READ = 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.SCAN_OPTION_NAMES = exports.VARIABLE_TYPE_SIZES = exports.VARIABLE_TYPE_NAMES = exports.FastScanMethod = exports.PointerType = exports.ScanType = exports.RoundingType = exports.ScanOption = exports.VariableType = void 0;
+exports.writeCheatTable = exports.parseCheatTable = exports.buildRecordsFromScan = exports.addScanResults = exports.MemoryRecord = exports.AddressList = exports.ExpressionError = exports.CompiledAddress = exports.resolveAddress = exports.evaluateExpression = exports.compileExpression = exports.applyPointerPath = exports.formatPointerPath = exports.PointerScanner = exports.optionNeedsOldValue = exports.scanBlock = exports.compileConfig = exports.ScanSession = exports.win32ErrorMessage = exports.findProcessesByNameAsync = exports.listProcessesAsync = exports.openProcessByNameAsync = exports.openProcessAsync = exports.regionTypeName = exports.setDefaultBackend = exports.getDefaultBackend = exports.isExecutable = exports.isWritable = exports.isReadable = exports.selectScannableRegions = exports.enumerateRegions = exports.findProcessesByName = exports.listProcesses = exports.ProcessOpenError = exports.Process = exports.readServiceNameFromDriverDat = exports.resolveDevicePath = exports.readAllocResult = exports.packAllocInput = exports.packWriteBuffer = exports.packReadInput = exports.DEFAULT_DBK_SERVICE_NAME = exports.DBK_ALLOC_INPUT_SIZE = exports.DBK_MAX_READ_CHUNK = exports.DBK_MAX_WRITE_PAYLOAD = exports.DBK_WRITE_BUFFER_SIZE = exports.DBK_WRITE_INPUT_SIZE = exports.DBK_READ_INPUT_SIZE = exports.DBK_IOCTL = exports.DbkDeviceError = void 0;
+exports.bytesToDbArguments = exports.patternToDbArguments = exports.parsePseudoDirective = exports.encodeAlign = exports.encodeNop = exports.encodeDataDirective = exports.splitDirectiveArguments = exports.parseCeInteger = exports.autoAssemble = exports.AutoAssemblerError = exports.AutoAssembler = exports.AssemblerError = exports.assembleToBytes = exports.assembleLines = exports.assemble = exports.DisasmValueType = exports.instructionText = exports.branchTarget = exports.formatBytes = exports.splitDisassembledString = exports.formatDisassembled = exports.disassembleAt = exports.disassembleOne = exports.disassemble = exports.AsmBackendError = exports.toSafeNumberAddress = exports.backendVersions = exports.instructionNameOf = exports.assembleRaw = exports.disassembleRaw = exports.archFromBitness = exports.normalizeArchitecture = exports.architectureInfo = exports.isArchitectureSupported = exports.resetAsmBackendForTests = exports.isAsmBackendReady = exports.ensureAsmBackend = exports.LuaMarshal = exports.LuaError = exports.LuaScriptError = exports.LuaEngine = exports.stringToVariableType = exports.variableTypeToString = exports.saveCheatTable = exports.loadCheatTable = void 0;
+var types_1 = require("./types");
+Object.defineProperty(exports, "VariableType", { enumerable: true, get: function () { return types_1.VariableType; } });
+Object.defineProperty(exports, "ScanOption", { enumerable: true, get: function () { return types_1.ScanOption; } });
+Object.defineProperty(exports, "RoundingType", { enumerable: true, get: function () { return types_1.RoundingType; } });
+Object.defineProperty(exports, "ScanType", { enumerable: true, get: function () { return types_1.ScanType; } });
+Object.defineProperty(exports, "PointerType", { enumerable: true, get: function () { return types_1.PointerType; } });
+Object.defineProperty(exports, "FastScanMethod", { enumerable: true, get: function () { return types_1.FastScanMethod; } });
+Object.defineProperty(exports, "VARIABLE_TYPE_NAMES", { enumerable: true, get: function () { return types_1.VARIABLE_TYPE_NAMES; } });
+Object.defineProperty(exports, "VARIABLE_TYPE_SIZES", { enumerable: true, get: function () { return types_1.VARIABLE_TYPE_SIZES; } });
+Object.defineProperty(exports, "SCAN_OPTION_NAMES", { enumerable: true, get: function () { return types_1.SCAN_OPTION_NAMES; } });
+Object.defineProperty(exports, "MEM_COMMIT", { enumerable: true, get: function () { return types_1.MEM_COMMIT; } });
+Object.defineProperty(exports, "MEM_RESERVE", { enumerable: true, get: function () { return types_1.MEM_RESERVE; } });
+Object.defineProperty(exports, "MEM_FREE", { enumerable: true, get: function () { return types_1.MEM_FREE; } });
+Object.defineProperty(exports, "MEM_PRIVATE", { enumerable: true, get: function () { return types_1.MEM_PRIVATE; } });
+Object.defineProperty(exports, "MEM_MAPPED", { enumerable: true, get: function () { return types_1.MEM_MAPPED; } });
+Object.defineProperty(exports, "MEM_IMAGE", { enumerable: true, get: function () { return types_1.MEM_IMAGE; } });
+Object.defineProperty(exports, "PAGE_NOACCESS", { enumerable: true, get: function () { return types_1.PAGE_NOACCESS; } });
+Object.defineProperty(exports, "PAGE_READONLY", { enumerable: true, get: function () { return types_1.PAGE_READONLY; } });
+Object.defineProperty(exports, "PAGE_READWRITE", { enumerable: true, get: function () { return types_1.PAGE_READWRITE; } });
+Object.defineProperty(exports, "PAGE_WRITECOPY", { enumerable: true, get: function () { return types_1.PAGE_WRITECOPY; } });
+Object.defineProperty(exports, "PAGE_EXECUTE", { enumerable: true, get: function () { return types_1.PAGE_EXECUTE; } });
+Object.defineProperty(exports, "PAGE_EXECUTE_READ", { enumerable: true, get: function () { return types_1.PAGE_EXECUTE_READ; } });
+Object.defineProperty(exports, "PAGE_EXECUTE_READWRITE", { enumerable: true, get: function () { return types_1.PAGE_EXECUTE_READWRITE; } });
+Object.defineProperty(exports, "PAGE_EXECUTE_WRITECOPY", { enumerable: true, get: function () { return types_1.PAGE_EXECUTE_WRITECOPY; } });
+Object.defineProperty(exports, "PAGE_GUARD", { enumerable: true, get: function () { return types_1.PAGE_GUARD; } });
+Object.defineProperty(exports, "PROCESS_VM_READ", { enumerable: true, get: function () { return types_1.PROCESS_VM_READ; } });
+Object.defineProperty(exports, "PROCESS_VM_WRITE", { enumerable: true, get: function () { return types_1.PROCESS_VM_WRITE; } });
+Object.defineProperty(exports, "PROCESS_VM_OPERATION", { enumerable: true, get: function () { return types_1.PROCESS_VM_OPERATION; } });
+Object.defineProperty(exports, "PROCESS_QUERY_INFORMATION", { enumerable: true, get: function () { return types_1.PROCESS_QUERY_INFORMATION; } });
+Object.defineProperty(exports, "DEFAULT_PROCESS_ACCESS", { enumerable: true, get: function () { return types_1.DEFAULT_PROCESS_ACCESS; } });
+/* —— 值编解码 —— */
+var value_codec_1 = require("./value-codec");
+Object.defineProperty(exports, "roundTo", { enumerable: true, get: function () { return value_codec_1.roundTo; } });
+Object.defineProperty(exports, "parseIntegerLiteral", { enumerable: true, get: function () { return value_codec_1.parseIntegerLiteral; } });
+Object.defineProperty(exports, "parseFloatLiteral", { enumerable: true, get: function () { return value_codec_1.parseFloatLiteral; } });
+Object.defineProperty(exports, "decimalsOf", { enumerable: true, get: function () { return value_codec_1.decimalsOf; } });
+Object.defineProperty(exports, "parseAob", { enumerable: true, get: function () { return value_codec_1.parseAob; } });
+Object.defineProperty(exports, "parseBinaryPattern", { enumerable: true, get: function () { return value_codec_1.parseBinaryPattern; } });
+Object.defineProperty(exports, "buildFloatCompareParams", { enumerable: true, get: function () { return value_codec_1.buildFloatCompareParams; } });
+Object.defineProperty(exports, "singleMatches", { enumerable: true, get: function () { return value_codec_1.singleMatches; } });
+Object.defineProperty(exports, "doubleMatches", { enumerable: true, get: function () { return value_codec_1.doubleMatches; } });
+Object.defineProperty(exports, "aobMatchesAt", { enumerable: true, get: function () { return value_codec_1.aobMatchesAt; } });
+Object.defineProperty(exports, "aobHasNibbleWildcard", { enumerable: true, get: function () { return value_codec_1.aobHasNibbleWildcard; } });
+var types_2 = require("./backend/types");
+Object.defineProperty(exports, "BackendUnsupportedError", { enumerable: true, get: function () { return types_2.BackendUnsupportedError; } });
+var self_backend_1 = require("./backend/self-backend");
+Object.defineProperty(exports, "SelfBackend", { enumerable: true, get: function () { return self_backend_1.SelfBackend; } });
+Object.defineProperty(exports, "filterScanRegions", { enumerable: true, get: function () { return self_backend_1.filterScanRegions; } });
+var native_ce_backend_1 = require("./backend/native-ce-backend");
+Object.defineProperty(exports, "NativeCeBackend", { enumerable: true, get: function () { return native_ce_backend_1.NativeCeBackend; } });
+Object.defineProperty(exports, "CeServerConnection", { enumerable: true, get: function () { return native_ce_backend_1.CeServerConnection; } });
+Object.defineProperty(exports, "CeWriter", { enumerable: true, get: function () { return native_ce_backend_1.CeWriter; } });
+Object.defineProperty(exports, "CeReader", { enumerable: true, get: function () { return native_ce_backend_1.CeReader; } });
+Object.defineProperty(exports, "CESERVER_CMD", { enumerable: true, get: function () { return native_ce_backend_1.CESERVER_CMD; } });
+Object.defineProperty(exports, "CESERVER_DEFAULT_PORT", { enumerable: true, get: function () { return native_ce_backend_1.CESERVER_DEFAULT_PORT; } });
+/* —— DBK 内核驱动后端 ——
+ *
+ * 通过 CE 自己的 DBK 驱动 ioctl 读写受保护进程内存。**需要驱动已加载**
+ * （加载需要管理员权限，见 `ce_kernel`）。
+ *
+ * ⚠️ 能力边界：ioctl 码与输入结构是按 CE 源码逐行实现的，但
+ * **结构布局未经真机验证**（本机无法加载驱动来试），详见
+ * `docs/backend-dbk.md` 的"未验证部分"。
+ */
+var dbk_backend_1 = require("./backend/dbk-backend");
+Object.defineProperty(exports, "DbkBackend", { enumerable: true, get: function () { return dbk_backend_1.DbkBackend; } });
+Object.defineProperty(exports, "DbkDeviceError", { enumerable: true, get: function () { return dbk_backend_1.DbkDeviceError; } });
+Object.defineProperty(exports, "DBK_IOCTL", { enumerable: true, get: function () { return dbk_backend_1.DBK_IOCTL; } });
+Object.defineProperty(exports, "DBK_READ_INPUT_SIZE", { enumerable: true, get: function () { return dbk_backend_1.DBK_READ_INPUT_SIZE; } });
+Object.defineProperty(exports, "DBK_WRITE_INPUT_SIZE", { enumerable: true, get: function () { return dbk_backend_1.DBK_WRITE_INPUT_SIZE; } });
+Object.defineProperty(exports, "DBK_WRITE_BUFFER_SIZE", { enumerable: true, get: function () { return dbk_backend_1.DBK_WRITE_BUFFER_SIZE; } });
+Object.defineProperty(exports, "DBK_MAX_WRITE_PAYLOAD", { enumerable: true, get: function () { return dbk_backend_1.DBK_MAX_WRITE_PAYLOAD; } });
+Object.defineProperty(exports, "DBK_MAX_READ_CHUNK", { enumerable: true, get: function () { return dbk_backend_1.DBK_MAX_READ_CHUNK; } });
+Object.defineProperty(exports, "DBK_ALLOC_INPUT_SIZE", { enumerable: true, get: function () { return dbk_backend_1.DBK_ALLOC_INPUT_SIZE; } });
+Object.defineProperty(exports, "DEFAULT_DBK_SERVICE_NAME", { enumerable: true, get: function () { return dbk_backend_1.DEFAULT_DBK_SERVICE_NAME; } });
+Object.defineProperty(exports, "packReadInput", { enumerable: true, get: function () { return dbk_backend_1.packReadInput; } });
+Object.defineProperty(exports, "packWriteBuffer", { enumerable: true, get: function () { return dbk_backend_1.packWriteBuffer; } });
+Object.defineProperty(exports, "packAllocInput", { enumerable: true, get: function () { return dbk_backend_1.packAllocInput; } });
+Object.defineProperty(exports, "readAllocResult", { enumerable: true, get: function () { return dbk_backend_1.readAllocResult; } });
+Object.defineProperty(exports, "resolveDevicePath", { enumerable: true, get: function () { return dbk_backend_1.resolveDevicePath; } });
+Object.defineProperty(exports, "readServiceNameFromDriverDat", { enumerable: true, get: function () { return dbk_backend_1.readServiceNameFromDriverDat; } });
+/* —— 进程与内存 —— */
+var process_1 = require("./win/process");
+Object.defineProperty(exports, "Process", { enumerable: true, get: function () { return process_1.Process; } });
+Object.defineProperty(exports, "ProcessOpenError", { enumerable: true, get: function () { return process_1.ProcessOpenError; } });
+Object.defineProperty(exports, "listProcesses", { enumerable: true, get: function () { return process_1.listProcesses; } });
+Object.defineProperty(exports, "findProcessesByName", { enumerable: true, get: function () { return process_1.findProcessesByName; } });
+Object.defineProperty(exports, "enumerateRegions", { enumerable: true, get: function () { return process_1.enumerateRegions; } });
+Object.defineProperty(exports, "selectScannableRegions", { enumerable: true, get: function () { return process_1.selectScannableRegions; } });
+Object.defineProperty(exports, "isReadable", { enumerable: true, get: function () { return process_1.isReadable; } });
+Object.defineProperty(exports, "isWritable", { enumerable: true, get: function () { return process_1.isWritable; } });
+Object.defineProperty(exports, "isExecutable", { enumerable: true, get: function () { return process_1.isExecutable; } });
+Object.defineProperty(exports, "getDefaultBackend", { enumerable: true, get: function () { return process_1.getDefaultBackend; } });
+Object.defineProperty(exports, "setDefaultBackend", { enumerable: true, get: function () { return process_1.setDefaultBackend; } });
+Object.defineProperty(exports, "regionTypeName", { enumerable: true, get: function () { return process_1.regionTypeName; } });
+Object.defineProperty(exports, "openProcessAsync", { enumerable: true, get: function () { return process_1.openProcessAsync; } });
+Object.defineProperty(exports, "openProcessByNameAsync", { enumerable: true, get: function () { return process_1.openProcessByNameAsync; } });
+Object.defineProperty(exports, "listProcessesAsync", { enumerable: true, get: function () { return process_1.listProcessesAsync; } });
+Object.defineProperty(exports, "findProcessesByNameAsync", { enumerable: true, get: function () { return process_1.findProcessesByNameAsync; } });
+var winapi_1 = require("./win/winapi");
+Object.defineProperty(exports, "win32ErrorMessage", { enumerable: true, get: function () { return winapi_1.win32ErrorMessage; } });
+/* —— 扫描 —— */
+var scanner_1 = require("./scanner/scanner");
+Object.defineProperty(exports, "ScanSession", { enumerable: true, get: function () { return scanner_1.ScanSession; } });
+var matcher_1 = require("./scanner/matcher");
+Object.defineProperty(exports, "compileConfig", { enumerable: true, get: function () { return matcher_1.compileConfig; } });
+Object.defineProperty(exports, "scanBlock", { enumerable: true, get: function () { return matcher_1.scanBlock; } });
+Object.defineProperty(exports, "optionNeedsOldValue", { enumerable: true, get: function () { return matcher_1.optionNeedsOldValue; } });
+var pointer_scan_1 = require("./scanner/pointer-scan");
+Object.defineProperty(exports, "PointerScanner", { enumerable: true, get: function () { return pointer_scan_1.PointerScanner; } });
+Object.defineProperty(exports, "formatPointerPath", { enumerable: true, get: function () { return pointer_scan_1.formatPointerPath; } });
+Object.defineProperty(exports, "applyPointerPath", { enumerable: true, get: function () { return pointer_scan_1.applyPointerPath; } });
+/* —— 地址表达式 —— */
+var expression_1 = require("./addr/expression");
+Object.defineProperty(exports, "compileExpression", { enumerable: true, get: function () { return expression_1.compileExpression; } });
+Object.defineProperty(exports, "evaluateExpression", { enumerable: true, get: function () { return expression_1.evaluateExpression; } });
+Object.defineProperty(exports, "resolveAddress", { enumerable: true, get: function () { return expression_1.resolveAddress; } });
+Object.defineProperty(exports, "CompiledAddress", { enumerable: true, get: function () { return expression_1.CompiledAddress; } });
+Object.defineProperty(exports, "ExpressionError", { enumerable: true, get: function () { return expression_1.ExpressionError; } });
+/* —— 地址表 —— */
+var memory_record_1 = require("./addresslist/memory-record");
+Object.defineProperty(exports, "AddressList", { enumerable: true, get: function () { return memory_record_1.AddressList; } });
+Object.defineProperty(exports, "MemoryRecord", { enumerable: true, get: function () { return memory_record_1.MemoryRecord; } });
+Object.defineProperty(exports, "addScanResults", { enumerable: true, get: function () { return memory_record_1.addScanResults; } });
+Object.defineProperty(exports, "buildRecordsFromScan", { enumerable: true, get: function () { return memory_record_1.buildRecordsFromScan; } });
+/* —— Cheat Table 读写 —— */
+var ct_format_1 = require("./cheattable/ct-format");
+Object.defineProperty(exports, "parseCheatTable", { enumerable: true, get: function () { return ct_format_1.parseCheatTable; } });
+Object.defineProperty(exports, "writeCheatTable", { enumerable: true, get: function () { return ct_format_1.writeCheatTable; } });
+Object.defineProperty(exports, "loadCheatTable", { enumerable: true, get: function () { return ct_format_1.loadCheatTable; } });
+Object.defineProperty(exports, "saveCheatTable", { enumerable: true, get: function () { return ct_format_1.saveCheatTable; } });
+Object.defineProperty(exports, "variableTypeToString", { enumerable: true, get: function () { return ct_format_1.variableTypeToString; } });
+Object.defineProperty(exports, "stringToVariableType", { enumerable: true, get: function () { return ct_format_1.stringToVariableType; } });
+/* —— Lua 脚本桥 ——
+ *
+ * 61 个 CE Lua API 函数的实现，详见 docs/lua-api.md。
+ * 需要 wasmoon（Lua 5.4，靠整数子类型保证 int64 地址不丢精度）。
+ */
+var bridge_1 = require("./lua/bridge");
+Object.defineProperty(exports, "LuaEngine", { enumerable: true, get: function () { return bridge_1.LuaEngine; } });
+Object.defineProperty(exports, "LuaScriptError", { enumerable: true, get: function () { return bridge_1.LuaScriptError; } });
+Object.defineProperty(exports, "LuaError", { enumerable: true, get: function () { return bridge_1.LuaError; } });
+Object.defineProperty(exports, "LuaMarshal", { enumerable: true, get: function () { return bridge_1.LuaMarshal; } });
+/* —— 反汇编 / 汇编 ——
+ *
+ * 后端是 capstone-wasm（反汇编）与 keystone-wasm（汇编）：
+ * Cheat Engine 自己也是调 binutils 的 objdump/as，自带 Pascal 实现只是回退路径。
+ * **使用前必须 await ensureAsmBackend()**（WASM 异步初始化）。
+ * 详见 docs/assembler.md。
+ */
+var backend_1 = require("./asm/backend");
+Object.defineProperty(exports, "ensureAsmBackend", { enumerable: true, get: function () { return backend_1.ensureAsmBackend; } });
+Object.defineProperty(exports, "isAsmBackendReady", { enumerable: true, get: function () { return backend_1.isAsmBackendReady; } });
+Object.defineProperty(exports, "resetAsmBackendForTests", { enumerable: true, get: function () { return backend_1.resetAsmBackendForTests; } });
+Object.defineProperty(exports, "isArchitectureSupported", { enumerable: true, get: function () { return backend_1.isArchitectureSupported; } });
+Object.defineProperty(exports, "architectureInfo", { enumerable: true, get: function () { return backend_1.architectureInfo; } });
+Object.defineProperty(exports, "normalizeArchitecture", { enumerable: true, get: function () { return backend_1.normalizeArchitecture; } });
+Object.defineProperty(exports, "archFromBitness", { enumerable: true, get: function () { return backend_1.archFromBitness; } });
+Object.defineProperty(exports, "disassembleRaw", { enumerable: true, get: function () { return backend_1.disassembleRaw; } });
+Object.defineProperty(exports, "assembleRaw", { enumerable: true, get: function () { return backend_1.assembleRaw; } });
+Object.defineProperty(exports, "instructionNameOf", { enumerable: true, get: function () { return backend_1.instructionNameOf; } });
+Object.defineProperty(exports, "backendVersions", { enumerable: true, get: function () { return backend_1.backendVersions; } });
+Object.defineProperty(exports, "toSafeNumberAddress", { enumerable: true, get: function () { return backend_1.toSafeNumberAddress; } });
+Object.defineProperty(exports, "AsmBackendError", { enumerable: true, get: function () { return backend_1.AsmBackendError; } });
+var disassembler_1 = require("./asm/disassembler");
+Object.defineProperty(exports, "disassemble", { enumerable: true, get: function () { return disassembler_1.disassemble; } });
+Object.defineProperty(exports, "disassembleOne", { enumerable: true, get: function () { return disassembler_1.disassembleOne; } });
+Object.defineProperty(exports, "disassembleAt", { enumerable: true, get: function () { return disassembler_1.disassembleAt; } });
+Object.defineProperty(exports, "formatDisassembled", { enumerable: true, get: function () { return disassembler_1.formatDisassembled; } });
+Object.defineProperty(exports, "splitDisassembledString", { enumerable: true, get: function () { return disassembler_1.splitDisassembledString; } });
+Object.defineProperty(exports, "formatBytes", { enumerable: true, get: function () { return disassembler_1.formatBytes; } });
+Object.defineProperty(exports, "branchTarget", { enumerable: true, get: function () { return disassembler_1.branchTarget; } });
+Object.defineProperty(exports, "instructionText", { enumerable: true, get: function () { return disassembler_1.instructionText; } });
+Object.defineProperty(exports, "DisasmValueType", { enumerable: true, get: function () { return disassembler_1.DisasmValueType; } });
+var assembler_1 = require("./asm/assembler");
+Object.defineProperty(exports, "assemble", { enumerable: true, get: function () { return assembler_1.assemble; } });
+Object.defineProperty(exports, "assembleLines", { enumerable: true, get: function () { return assembler_1.assembleLines; } });
+Object.defineProperty(exports, "assembleToBytes", { enumerable: true, get: function () { return assembler_1.assembleToBytes; } });
+Object.defineProperty(exports, "AssemblerError", { enumerable: true, get: function () { return assembler_1.AssemblerError; } });
+/* —— Auto Assembler（CE 脚本） ——
+ *
+ * 支持 [ENABLE]/[DISABLE]、alloc/dealloc/realloc/globalalloc、label/define、
+ * registersymbol、aobscan(+module/region/unique)、createthread、include、
+ * db/dw/dd/dq、nop/align、readmem/loadbinary。详见 docs/autoassembler.md。
+ *
+ * 核心机制：ENABLE 写入前逐字节记录原字节，DISABLE 精确还原（空 [DISABLE] 也能还原）。
+ */
+var autoassembler_1 = require("./asm/autoassembler");
+Object.defineProperty(exports, "AutoAssembler", { enumerable: true, get: function () { return autoassembler_1.AutoAssembler; } });
+Object.defineProperty(exports, "AutoAssemblerError", { enumerable: true, get: function () { return autoassembler_1.AutoAssemblerError; } });
+Object.defineProperty(exports, "autoAssemble", { enumerable: true, get: function () { return autoassembler_1.autoAssemble; } });
+var autoassembler_directives_1 = require("./asm/autoassembler-directives");
+Object.defineProperty(exports, "parseCeInteger", { enumerable: true, get: function () { return autoassembler_directives_1.parseCeInteger; } });
+Object.defineProperty(exports, "splitDirectiveArguments", { enumerable: true, get: function () { return autoassembler_directives_1.splitDirectiveArguments; } });
+Object.defineProperty(exports, "encodeDataDirective", { enumerable: true, get: function () { return autoassembler_directives_1.encodeDataDirective; } });
+Object.defineProperty(exports, "encodeNop", { enumerable: true, get: function () { return autoassembler_directives_1.encodeNop; } });
+Object.defineProperty(exports, "encodeAlign", { enumerable: true, get: function () { return autoassembler_directives_1.encodeAlign; } });
+Object.defineProperty(exports, "parsePseudoDirective", { enumerable: true, get: function () { return autoassembler_directives_1.parsePseudoDirective; } });
+Object.defineProperty(exports, "patternToDbArguments", { enumerable: true, get: function () { return autoassembler_directives_1.patternToDbArguments; } });
+Object.defineProperty(exports, "bytesToDbArguments", { enumerable: true, get: function () { return autoassembler_directives_1.bytesToDbArguments; } });
+//# sourceMappingURL=index.js.map

package/dist/cjs/index.js.map

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

package/dist/cjs/lua/aa.js

@@ -0,0 +1,230 @@
+"use strict";
+/**
+ * Lua 的 Auto Assembler 绑定。
+ *
+ * 把引擎层的 `AutoAssembler`（见 `../asm/autoassembler.ts`）包成 CE 的 Lua 全局函数：
+ *
+ * | Lua 函数 | 对应 CE | 返回 |
+ * | --- | --- | --- |
+ * | `autoAssemble(script [, enable])` | `autoAssemble` | 成功 `true`，失败 `false`（原因进 sink） |
+ * | `autoAssembleCheck(script [, enable])` | `autoAssembleCheck` | 同上，但不写目标进程 |
+ * | `autoAssembleError()` | —（本移植扩展） | 最近一次 AA 错误文本，无错误返回 `nil` |
+ *
+ * ## 符号双向流通（只使用引擎的公开 API 实现）
+ *
+ * - **AA → Lua**：每次执行后，把 `AutoAssembleResult.symbols` 快照灌回 Lua 的
+ *   `SymbolTable`，因此脚本里 `alloc`/`label`/`aobscan`/`registersymbol`
+ *   产生的名字对 Lua 的 `getAddress()` 立即可见（与 CE 一致）。
+ * - **Lua → AA**：执行前把 Lua 符号表里已有的名字**做文本替换**成
+ *   `0x...` 字面量。之所以用替换而不是注入符号表：`AutoAssembler` 的
+ *   `symbols` 是只读快照、构造器也不接受初值，
+ *   而子串替换与 `assembler.ts` 的 `symbols` 选项语义一致、结果可预测。
+ *
+ * ## 与 CE 的差异（有意为之）
+ *
+ * 1. **不抛 Lua 错误，返回布尔值**。CE 的 `autoAssemble` 失败时会弹窗；
+ *    本移植遵循 Lua 惯用法返回 `false`，原因用 `autoAssembleError()` 取，
+ *    避免脚本因弹窗中断。
+ * 2. **`createthread` 只校验不执行**（Node 没有 `CreateRemoteThread`）。
+ *    脚本不会因此失败，但也不会真的建线程；错误文本里会写明。
+ * 3. **`[ENABLE]`/`[DISABLE]` 必须成对**：还原记录按**脚本原文**分桶
+ *    （等价 CE 每条 memoryrecord 一份 `TDisableInfo`），
+ *    因此多个脚本各自独立开关互不影响。
+ * 4. **换目标进程会重建 AA 实例**：旧的 alloc 记录对新进程没有意义
+ *    （那块内存已随旧进程消失）。CE 在换进程时同样会清表。
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.LuaAutoAssembler = void 0;
+exports.formatAutoAssemblerError = formatAutoAssemblerError;
+exports.createAutoAssemblerApi = createAutoAssemblerApi;
+const autoassembler_1 = require("../asm/autoassembler");
+const marshal_1 = require("./marshal");
+/**
+ * Lua 的 Auto Assembler 绑定对象。
+ *
+ * 生命期与 LuaEngine 一致：持有一个 `AutoAssembler` 实例，
+ * 这样多次 `autoAssemble` 调用之间共享 alloc 记录与还原历史
+ * （`[ENABLE]` 之后才能 `[DISABLE]`）。
+ */
+class LuaAutoAssembler {
+    ctx;
+    assembler = null;
+    lastError = null;
+    /** 最近一次同步进 Lua 符号表的条目（诊断用） */
+    synced = new Map();
+    /** 缓存的进程引用：换了目标进程要重建 assembler */
+    boundProcess = null;
+    constructor(ctx) {
+        this.ctx = ctx;
+    }
+    /** 按当前进程取（必要时重建）引擎实例 */
+    engine() {
+        const proc = this.ctx.currentProcess();
+        if (!this.assembler || this.boundProcess !== proc) {
+            this.assembler = new autoassembler_1.AutoAssembler({
+                ...(proc ? { process: proc } : {}),
+            });
+            this.boundProcess = proc;
+        }
+        return this.assembler;
+    }
+    /** 目标进程被关闭/更换时调用，丢弃旧状态 */
+    invalidate() {
+        this.assembler = null;
+        this.boundProcess = null;
+        this.synced = new Map();
+    }
+    /** 最近一次 AA 错误（无错误返回 null） */
+    getLastError() {
+        return this.lastError;
+    }
+    /** 最近一次同步进 Lua 符号表的条目 */
+    getSyncedSymbols() {
+        return this.synced;
+    }
+    /** 执行 `autoAssemble`（真正写目标进程） */
+    run(script, enable) {
+        return this.execute(script, enable, false);
+    }
+    /** 执行 `autoAssembleCheck`（只检查语法与编码，不写目标进程） */
+    check(script, enable) {
+        return this.execute(script, enable, true);
+    }
+    execute(script, enable, syntaxCheckOnly) {
+        this.lastError = null;
+        if (typeof script !== 'string' || script.trim() === '') {
+            this.lastError = 'autoAssemble: 脚本不能为空';
+            return false;
+        }
+        try {
+            const prepared = this.injectLuaSymbols(script);
+            const result = this.engine().autoAssemble(prepared, {
+                enable,
+                syntaxCheckOnly,
+            });
+            // AA → Lua：把本次的符号快照同步过去，让 getAddress() 立即可见
+            this.ctx.symbols.mergeFrom(result.symbols);
+            this.synced = new Map(result.symbols);
+            // createthread 只校验不执行 —— 明确告知
+            if (result.createThreads.length > 0) {
+                this.lastError =
+                    `注意：createthread 仅做参数校验，未创建远程线程（Node 无 CreateRemoteThread）。` +
+                        `地址：${result.createThreads.map((a) => '0x' + a.toString(16)).join(', ')}`;
+            }
+            return true;
+        }
+        catch (e) {
+            this.lastError = formatAutoAssemblerError(e);
+            return false;
+        }
+    }
+    /**
+     * 把 Lua 符号表里已有的名字替换成 `0x...` 字面量。
+     *
+     * 边界：
+     *   - 只替换**独立标识符**（两侧非标识符字符），避免误伤 `0xAB` 这类字面量与寄存器名；
+     *   - 跳过 AA 自己的指令关键字行（`alloc(`/`label(`/`define(`/`registersymbol(`/
+     *     `aobscan*`），否则 `alloc(newmem,256)` 里的 `newmem` 会被替换成地址，
+     *     而那一行的语义是"声明名字"而不是"引用地址"。
+     */
+    injectLuaSymbols(script) {
+        const symbols = this.ctx.symbols.snapshot();
+        if (symbols.size === 0)
+            return script;
+        // 名字长的优先，避免 label 先于 label2 被匹配
+        const names = [...symbols.keys()].sort((a, b) => b.length - a.length);
+        const shouldSkip = (line) => {
+            const t = line.trim().toLowerCase();
+            return (/^(alloc|dealloc|realloc|globalalloc|label|define|registersymbol|unregistersymbol)\s*\(/.test(t) ||
+                /^aobscan(module|region|unique)?\s*\(/.test(t) ||
+                /^(kalloc|sharedalloc|createthread|include|loadbinary|readmem)\s*\(/.test(t));
+        };
+        return script
+            .split(/\r?\n/)
+            .map((line) => {
+            if (shouldSkip(line))
+                return line;
+            let out = line;
+            for (const name of names) {
+                const addr = symbols.get(name);
+                const re = new RegExp(`(?<![\\w.$?@])${escapeRegExp(name)}(?![\\w.$?@])`, 'gi');
+                if (re.test(out))
+                    out = out.replace(re, '0x' + addr.toString(16));
+            }
+            return out;
+        })
+            .join('\n');
+    }
+}
+exports.LuaAutoAssembler = LuaAutoAssembler;
+function escapeRegExp(s) {
+    return s.replace(/[.*+?^${}()|[\]\\]/g, '\\$&');
+}
+/** 把 AutoAssemblerError 转成带行号的可读文本 */
+function formatAutoAssemblerError(e) {
+    if (e instanceof autoassembler_1.AutoAssemblerError) {
+        const line = e.lineNumber !== undefined ? `第 ${e.lineNumber} 行` : '';
+        const phase = e.phase ? `[${e.phase}]` : '';
+        const at = line || phase ? `（${[phase, line].filter(Boolean).join(' ')}）` : '';
+        return `Auto Assembler 失败${at}：${e.message}`;
+    }
+    if (e instanceof Error)
+        return `Auto Assembler 失败：${e.message}`;
+    return `Auto Assembler 失败：${(0, marshal_1.describeError)(e)}`;
+}
+/**
+ * 构造要注册进 Lua 的函数表。
+ *
+ * 单独成函数（而不是塞进 api.ts）是为了让 Lua 的 AA 绑定与引擎层保持清晰边界，
+ * 也便于单测。
+ */
+function createAutoAssemblerApi(ctx, errorSink) {
+    const instance = new LuaAutoAssembler(ctx);
+    /** 把最近错误写进 sink，便于 Lua 侧统一读取 */
+    const report = () => {
+        const msg = instance.getLastError();
+        if (msg)
+            errorSink.set(msg);
+        else
+            errorSink.clear();
+    };
+    const functions = {
+        /**
+         * `autoAssemble(script [, enable]) -> boolean`
+         *
+         * CE 里失败会弹窗；本移植返回 `false` 并把原因写进错误 sink，
+         * 用 `autoAssembleError()` 取详情。
+         */
+        autoAssemble(args, m) {
+            const script = m.argToString(args, 1, 'autoAssemble');
+            const enable = args[1] === undefined ? true : m.argToBoolean(args, 2, true);
+            const ok = instance.run(script, enable);
+            report();
+            return ok;
+        },
+        /**
+         * `autoAssembleCheck(script [, enable]) -> boolean`
+         *
+         * 只解析与编码，不分配内存、不写目标进程，用于"能不能用"的预检。
+         */
+        autoAssembleCheck(args, m) {
+            const script = m.argToString(args, 1, 'autoAssembleCheck');
+            const enable = args[1] === undefined ? true : m.argToBoolean(args, 2, true);
+            const ok = instance.check(script, enable);
+            report();
+            return ok;
+        },
+        /**
+         * `autoAssembleError() -> string | nil`
+         *
+         * 本移植扩展：取最近一次 AA 失败的详情（含行号）。
+         * CE 用弹窗报告，脚本里拿不到文本，因此这里额外提供。
+         */
+        autoAssembleError() {
+            const msg = instance.getLastError();
+            return msg === null || msg === '' ? null : msg;
+        },
+    };
+    return { functions, instance };
+}
+//# sourceMappingURL=aa.js.map

package/dist/cjs/lua/aa.js.map

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

package/dist/cjs/lua/addressing.js

@@ -0,0 +1,118 @@
+"use strict";
+/**
+ * 地址表达式解析（CE 的 getAddress / getAddressFromName 的简化实现）。
+ *
+ * 支持的写法（与 CE Lua 脚本里常见的写法对齐）：
+ *   1234 / 0012AB00     十六进制（CE 的地址表达式里裸数字按十六进制解释）
+ *   0x7FF6A000 / $7FF6A000
+ *   kernel32.dll        模块基址（大小写不敏感，可省略 .dll）
+ *   kernel32.dll+1A2B   模块基址 + 偏移
+ *   mySymbol+40         已注册符号 + 偏移
+ *   a+b-c               多个项按 +/- 连接
+ *
+ * 注意：只有**字符串**里的裸数字按十六进制解释；
+ * `getAddress(4096)` 传 Lua 数字时原样返回 4096。
+ *
+ * 不支持：括号、乘法/除法、指针解引用（CE 里靠 `[[addr]+4]` 这类写法，本移植未实现）。
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.AddressResolver = void 0;
+class AddressResolver {
+    deps;
+    constructor(deps) {
+        this.deps = deps;
+    }
+    /**
+     * 解析地址。number/bigint 直接返回；字符串走表达式解析。
+     * 解析失败抛 Error（中文信息），由调用方决定是抛 Lua 错误还是返回 nil。
+     */
+    resolve(value) {
+        if (typeof value === 'bigint')
+            return value;
+        if (typeof value === 'number') {
+            if (!Number.isFinite(value) || !Number.isInteger(value)) {
+                throw new Error(`地址必须是整数，收到 ${value}`);
+            }
+            return BigInt(value);
+        }
+        if (typeof value === 'string')
+            return this.parseExpression(value);
+        throw new Error(`地址必须是整数或字符串，收到 ${value === null ? 'nil' : typeof value}`);
+    }
+    /** 失败返回 null（对应 getAddressSafe 的语义）。 */
+    tryResolve(value) {
+        try {
+            return this.resolve(value);
+        }
+        catch {
+            return null;
+        }
+    }
+    /** 解析字符串表达式。 */
+    parseExpression(expr) {
+        const source = expr.trim();
+        if (source === '')
+            throw new Error('地址表达式为空');
+        const terms = this.splitTerms(source);
+        if (terms.length === 0)
+            throw new Error(`地址表达式无法解析："${expr}"`);
+        let total = 0n;
+        for (const term of terms) {
+            const v = this.parseTerm(term.text, source);
+            total += term.sign === 1 ? v : -v;
+        }
+        return total;
+    }
+    /** 按 +/- 切分表达式（不考虑括号）。 */
+    splitTerms(source) {
+        const terms = [];
+        let sign = 1;
+        let buffer = '';
+        const flush = () => {
+            const text = buffer.trim();
+            if (text !== '')
+                terms.push({ sign, text });
+            buffer = '';
+        };
+        for (const ch of source) {
+            if (ch === '+' || ch === '-') {
+                flush();
+                sign = ch === '+' ? 1 : -1;
+            }
+            else if (ch === ' ' || ch === '\t') {
+                // 允许空格分隔，但不作为运算符
+                if (buffer !== '')
+                    buffer += ch;
+            }
+            else {
+                buffer += ch;
+            }
+        }
+        flush();
+        return terms;
+    }
+    /** 解析单项：字面量、模块名或符号。 */
+    parseTerm(raw, source) {
+        const text = raw.trim();
+        if (text === '')
+            throw new Error(`地址表达式 "${source}" 中有空项`);
+        if (/^\$[0-9a-fA-F]+$/.test(text))
+            return BigInt('0x' + text.slice(1));
+        if (/^0x[0-9a-fA-F]+$/i.test(text))
+            return BigInt(text);
+        if (/^[0-9a-fA-F]+$/.test(text)) {
+            // CE 的地址表达式里裸数字一律按十六进制解释
+            // （`kernel32.dll+1000` 是基址 +0x1000，AOBScan 输出的 8 位串也是十六进制）
+            return BigInt('0x' + text);
+        }
+        const symbol = this.deps.symbols.get(text) ?? this.deps.symbols.getCaseInsensitive(text);
+        if (symbol !== undefined)
+            return symbol;
+        const mod = this.deps.findModule(text);
+        if (mod)
+            return mod.baseAddress;
+        throw new Error(`无法解析地址表达式 "${source}" 中的 "${text}"：既不是数字，也不是已注册符号或模块名`);
+    }
+}
+exports.AddressResolver = AddressResolver;
+//# sourceMappingURL=addressing.js.map

package/dist/cjs/lua/addressing.js.map

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