@bingine/cemem 0.0.0-stage → 0.1.1

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (138) hide show
  1. package/PORT-SCOPE.md +169 -0
  2. package/README.md +451 -2
  3. package/dist/cjs/addr/expression.js +650 -0
  4. package/dist/cjs/addr/expression.js.map +1 -0
  5. package/dist/cjs/addresslist/memory-record.js +612 -0
  6. package/dist/cjs/addresslist/memory-record.js.map +1 -0
  7. package/dist/cjs/asm/assembler.js +354 -0
  8. package/dist/cjs/asm/assembler.js.map +1 -0
  9. package/dist/cjs/asm/autoassembler-directives.js +362 -0
  10. package/dist/cjs/asm/autoassembler-directives.js.map +1 -0
  11. package/dist/cjs/asm/autoassembler.js +2163 -0
  12. package/dist/cjs/asm/autoassembler.js.map +1 -0
  13. package/dist/cjs/asm/backend.js +394 -0
  14. package/dist/cjs/asm/backend.js.map +1 -0
  15. package/dist/cjs/asm/disassembler.js +715 -0
  16. package/dist/cjs/asm/disassembler.js.map +1 -0
  17. package/dist/cjs/backend/dbk-backend.js +683 -0
  18. package/dist/cjs/backend/dbk-backend.js.map +1 -0
  19. package/dist/cjs/backend/native-ce-backend.js +667 -0
  20. package/dist/cjs/backend/native-ce-backend.js.map +1 -0
  21. package/dist/cjs/backend/self-backend.js +449 -0
  22. package/dist/cjs/backend/self-backend.js.map +1 -0
  23. package/dist/cjs/backend/types.js +48 -0
  24. package/dist/cjs/backend/types.js.map +1 -0
  25. package/dist/cjs/cheattable/ct-format.js +533 -0
  26. package/dist/cjs/cheattable/ct-format.js.map +1 -0
  27. package/dist/cjs/index.js +219 -0
  28. package/dist/cjs/index.js.map +1 -0
  29. package/dist/cjs/lua/aa.js +230 -0
  30. package/dist/cjs/lua/aa.js.map +1 -0
  31. package/dist/cjs/lua/addressing.js +118 -0
  32. package/dist/cjs/lua/addressing.js.map +1 -0
  33. package/dist/cjs/lua/api.js +736 -0
  34. package/dist/cjs/lua/api.js.map +1 -0
  35. package/dist/cjs/lua/asm.js +220 -0
  36. package/dist/cjs/lua/asm.js.map +1 -0
  37. package/dist/cjs/lua/bridge.js +526 -0
  38. package/dist/cjs/lua/bridge.js.map +1 -0
  39. package/dist/cjs/lua/marshal.js +562 -0
  40. package/dist/cjs/lua/marshal.js.map +1 -0
  41. package/dist/cjs/lua/memory.js +213 -0
  42. package/dist/cjs/lua/memory.js.map +1 -0
  43. package/dist/cjs/lua/objects.js +1070 -0
  44. package/dist/cjs/lua/objects.js.map +1 -0
  45. package/dist/cjs/lua/scan.js +543 -0
  46. package/dist/cjs/lua/scan.js.map +1 -0
  47. package/dist/cjs/lua/types.js +103 -0
  48. package/dist/cjs/lua/types.js.map +1 -0
  49. package/dist/cjs/scanner/matcher.js +781 -0
  50. package/dist/cjs/scanner/matcher.js.map +1 -0
  51. package/dist/cjs/scanner/pointer-scan.js +546 -0
  52. package/dist/cjs/scanner/pointer-scan.js.map +1 -0
  53. package/dist/cjs/scanner/scanner.js +513 -0
  54. package/dist/cjs/scanner/scanner.js.map +1 -0
  55. package/dist/cjs/scanner/shared-layout.js +207 -0
  56. package/dist/cjs/scanner/shared-layout.js.map +1 -0
  57. package/dist/cjs/types.js +190 -0
  58. package/dist/cjs/types.js.map +1 -0
  59. package/dist/cjs/value-codec.js +515 -0
  60. package/dist/cjs/value-codec.js.map +1 -0
  61. package/dist/cjs/win/process.js +475 -0
  62. package/dist/cjs/win/process.js.map +1 -0
  63. package/dist/cjs/win/scan-worker.js +84 -0
  64. package/dist/cjs/win/scan-worker.js.map +1 -0
  65. package/dist/cjs/win/winapi.js +403 -0
  66. package/dist/cjs/win/winapi.js.map +1 -0
  67. package/dist/types/addr/expression.d.ts +98 -0
  68. package/dist/types/addr/expression.d.ts.map +1 -0
  69. package/dist/types/addresslist/memory-record.d.ts +218 -0
  70. package/dist/types/addresslist/memory-record.d.ts.map +1 -0
  71. package/dist/types/asm/assembler.d.ts +106 -0
  72. package/dist/types/asm/assembler.d.ts.map +1 -0
  73. package/dist/types/asm/autoassembler-directives.d.ts +118 -0
  74. package/dist/types/asm/autoassembler-directives.d.ts.map +1 -0
  75. package/dist/types/asm/autoassembler.d.ts +434 -0
  76. package/dist/types/asm/autoassembler.d.ts.map +1 -0
  77. package/dist/types/asm/backend.d.ts +167 -0
  78. package/dist/types/asm/backend.d.ts.map +1 -0
  79. package/dist/types/asm/disassembler.d.ts +194 -0
  80. package/dist/types/asm/disassembler.d.ts.map +1 -0
  81. package/dist/types/backend/dbk-backend.d.ts +353 -0
  82. package/dist/types/backend/dbk-backend.d.ts.map +1 -0
  83. package/dist/types/backend/native-ce-backend.d.ts +213 -0
  84. package/dist/types/backend/native-ce-backend.d.ts.map +1 -0
  85. package/dist/types/backend/self-backend.d.ts +64 -0
  86. package/dist/types/backend/self-backend.d.ts.map +1 -0
  87. package/dist/types/backend/types.d.ts +176 -0
  88. package/dist/types/backend/types.d.ts.map +1 -0
  89. package/dist/types/cheattable/ct-format.d.ts +100 -0
  90. package/dist/types/cheattable/ct-format.d.ts.map +1 -0
  91. package/dist/types/index.d.ts +54 -0
  92. package/dist/types/index.d.ts.map +1 -0
  93. package/dist/types/lua/aa.d.ts +107 -0
  94. package/dist/types/lua/aa.d.ts.map +1 -0
  95. package/dist/types/lua/addressing.d.ts +41 -0
  96. package/dist/types/lua/addressing.d.ts.map +1 -0
  97. package/dist/types/lua/api.d.ts +46 -0
  98. package/dist/types/lua/api.d.ts.map +1 -0
  99. package/dist/types/lua/asm.d.ts +42 -0
  100. package/dist/types/lua/asm.d.ts.map +1 -0
  101. package/dist/types/lua/bridge.d.ts +129 -0
  102. package/dist/types/lua/bridge.d.ts.map +1 -0
  103. package/dist/types/lua/marshal.d.ts +244 -0
  104. package/dist/types/lua/marshal.d.ts.map +1 -0
  105. package/dist/types/lua/memory.d.ts +61 -0
  106. package/dist/types/lua/memory.d.ts.map +1 -0
  107. package/dist/types/lua/objects.d.ts +210 -0
  108. package/dist/types/lua/objects.d.ts.map +1 -0
  109. package/dist/types/lua/scan.d.ts +106 -0
  110. package/dist/types/lua/scan.d.ts.map +1 -0
  111. package/dist/types/lua/types.d.ts +146 -0
  112. package/dist/types/lua/types.d.ts.map +1 -0
  113. package/dist/types/scanner/matcher.d.ts +122 -0
  114. package/dist/types/scanner/matcher.d.ts.map +1 -0
  115. package/dist/types/scanner/pointer-scan.d.ts +187 -0
  116. package/dist/types/scanner/pointer-scan.d.ts.map +1 -0
  117. package/dist/types/scanner/scanner.d.ts +150 -0
  118. package/dist/types/scanner/scanner.d.ts.map +1 -0
  119. package/dist/types/scanner/shared-layout.d.ts +96 -0
  120. package/dist/types/scanner/shared-layout.d.ts.map +1 -0
  121. package/dist/types/types.d.ts +239 -0
  122. package/dist/types/types.d.ts.map +1 -0
  123. package/dist/types/value-codec.d.ts +134 -0
  124. package/dist/types/value-codec.d.ts.map +1 -0
  125. package/dist/types/win/process.d.ts +190 -0
  126. package/dist/types/win/process.d.ts.map +1 -0
  127. package/dist/types/win/scan-worker.d.ts +51 -0
  128. package/dist/types/win/scan-worker.d.ts.map +1 -0
  129. package/dist/types/win/winapi.d.ts +144 -0
  130. package/dist/types/win/winapi.d.ts.map +1 -0
  131. package/docs/assembler.md +371 -0
  132. package/docs/autoassembler.md +423 -0
  133. package/docs/backend-dbk.md +305 -0
  134. package/docs/backends.md +273 -0
  135. package/docs/evidence/atomics-wait-io.js +20 -0
  136. package/docs/evidence/mini-repro.js +98 -0
  137. package/docs/lua-api.md +718 -0
  138. package/package.json +60 -4
@@ -0,0 +1,526 @@
1
+ "use strict";
2
+ /**
3
+ * Lua 脚本桥 —— Cheat Engine Lua API 的 Node 版子集。
4
+ *
5
+ * 依赖选型:**wasmoon**(真实 Lua 5.4 的 WASM 构建)。
6
+ * 理由:CE 用的就是 Lua 5.3/5.4,wasmoon 提供的是 Lua 5.4,
7
+ * 整数语义(64 位 integer + float)、`string.format("%d")`、协程、goto 等
8
+ * 都与 CE 一致;fengari 是纯 JS 的 Lua 5.1,没有整数子类型
9
+ * (所有数字都是 double),地址精度会对不上。
10
+ *
11
+ * 但 wasmoon 的高层 JS↔Lua 函数桥不能直接用:
12
+ * 实测 `global.set('f', f)` 之后,Lua 的 integer 会被转成 JS number
13
+ * (9007199254740993 → 9007199254740992,丢精度),而且 JS 返回 bigint 会抛
14
+ * "The type 'bigint' is not supported by Lua"。
15
+ * 所以本桥绕过它,直接用 Lua C API 注册 C 闭包:
16
+ * - 入参:lua_tointegerx 返回 BigInt(原始精度)
17
+ * - 出参:lua_pushinteger 接受 BigInt
18
+ *
19
+ * 用法:
20
+ * ```ts
21
+ * const lua = new LuaEngine({ onOutput: (t) => console.log(t) });
22
+ * await lua.createState();
23
+ * lua.attachProcess(Process.open(pid)); // 或者脚本里 openProcess(pid)
24
+ * const value = await lua.doString('return readInteger(getAddress("0x7ff00000"))');
25
+ * await lua.dispose();
26
+ * ```
27
+ */
28
+ Object.defineProperty(exports, "__esModule", { value: true });
29
+ exports.LuaError = exports.LuaMarshal = exports.LuaEngine = exports.LuaScriptError = void 0;
30
+ const wasmoon_1 = require("wasmoon");
31
+ const node_path_1 = require("node:path");
32
+ const node_fs_1 = require("node:fs");
33
+ const matcher_1 = require("../scanner/matcher");
34
+ const scanner_1 = require("../scanner/scanner");
35
+ const backend_1 = require("../asm/backend");
36
+ const marshal_1 = require("./marshal");
37
+ const objects_1 = require("./objects");
38
+ const api_1 = require("./api");
39
+ const types_1 = require("./types");
40
+ /** Lua 脚本执行失败(语法错误 / 运行时错误)。 */
41
+ class LuaScriptError extends Error {
42
+ luaMessage;
43
+ constructor(message, luaMessage) {
44
+ super(message);
45
+ this.luaMessage = luaMessage;
46
+ this.name = 'LuaScriptError';
47
+ }
48
+ }
49
+ exports.LuaScriptError = LuaScriptError;
50
+ exports.LuaError = LuaScriptError;
51
+ class LuaEngine {
52
+ /** 输出历史(print / showMessage) */
53
+ outputLines = [];
54
+ /** 符号表 */
55
+ symbols = new types_1.SymbolTable();
56
+ options;
57
+ factory = null;
58
+ wasm = null;
59
+ raw = null;
60
+ statePointer = 0;
61
+ marshal = null;
62
+ objects = null;
63
+ api = null;
64
+ proc = null;
65
+ chunkRefs = new Set();
66
+ functionPointers = [];
67
+ messageHandlerPointer = 0;
68
+ moduleCache = null;
69
+ session = null;
70
+ apiRegistered = false;
71
+ disposed = false;
72
+ /** 扫描能力外观(转发给 src/scanner,不重复实现算法)。 */
73
+ scanner = {
74
+ compile: (config) => (0, matcher_1.compileConfig)(config),
75
+ scanBlock: (cc, buf, prev, out) => (0, matcher_1.scanBlock)(cc, buf, prev, out),
76
+ createSession: (proc, options) => new scanner_1.ScanSession(proc, options),
77
+ };
78
+ constructor(options = {}) {
79
+ this.options = {
80
+ process: options.process,
81
+ onOutput: options.onOutput,
82
+ captureOutput: options.captureOutput !== false,
83
+ maxSleepMs: options.maxSleepMs ?? 60000,
84
+ moduleCacheMs: options.moduleCacheMs ?? 2000,
85
+ };
86
+ if (options.process)
87
+ this.proc = options.process;
88
+ }
89
+ /* ---------------------------------------------------------------- *
90
+ * 状态管理
91
+ * ---------------------------------------------------------------- */
92
+ get isReady() {
93
+ return this.raw !== null && !this.disposed;
94
+ }
95
+ get maxSleepMs() {
96
+ return this.options.maxSleepMs;
97
+ }
98
+ /** 主 Lua state(仅在 createState 之后可用)。 */
99
+ get luaState() {
100
+ return this.statePointer;
101
+ }
102
+ /** 创建(或重建)Lua 状态并注册 API。 */
103
+ async createState() {
104
+ if (this.disposed)
105
+ throw new Error('LuaEngine 已销毁,不能再次 createState');
106
+ if (this.raw) {
107
+ this.registerApiNow();
108
+ return this;
109
+ }
110
+ const factory = new wasmoon_1.LuaFactory();
111
+ const engine = (await factory.createEngine({ openStandardLibs: true }));
112
+ this.factory = factory;
113
+ this.wasm = engine;
114
+ this.raw = engine.cmodule;
115
+ this.statePointer = engine.global.address;
116
+ // 说明:曾尝试在这里"主动探测 longjmp 哨兵值",但 wasmoon 并未把
117
+ // emscripten 的 `_emscripten_throw_longjmp` 暴露出来(cmodule 上无该符号),
118
+ // 因此改为在 marshal.ts 里做保守判定。详见那段注释。
119
+ this.objects = new objects_1.LuaObjectBridge(this.raw);
120
+ (0, objects_1.registerBuiltinClasses)(this.objects);
121
+ this.marshal = new marshal_1.LuaMarshal(this.raw, this.statePointer, this.objects);
122
+ this.api = (0, api_1.createApi)(this);
123
+ this.registerApiNow();
124
+ // 预热汇编/反汇编后端(WASM 需要异步装载)。
125
+ //
126
+ // 为什么必须在这里等:`assemble` / `disassemble` 这些 API 是**同步**的
127
+ // (Lua 的 C 闭包不能 await),而后端的加载是异步的。若不在建 state 时
128
+ // 预热,脚本里第一次调 `assemble` 就会撞上「后端尚未初始化」。
129
+ //
130
+ // 失败不致命:只是汇编/反汇编不可用,其余 API(读写内存、扫描等)照常工作,
131
+ // 调用者仍可稍后手动 `await ensureAsmBackend()` 重试。
132
+ try {
133
+ await (0, backend_1.ensureAsmBackend)();
134
+ }
135
+ catch {
136
+ /* 保留错误:真正调用汇编 API 时会给出可读提示 */
137
+ }
138
+ return this;
139
+ }
140
+ /**
141
+ * 注册 CE Lua API。
142
+ *
143
+ * 如果还没 createState,会记下请求并在 createState 时自动注册 ——
144
+ * 也就是说 `new LuaEngine(); engine.registerApi(); await engine.createState();` 也能工作。
145
+ */
146
+ registerApi() {
147
+ if (!this.raw)
148
+ return; // createState 时会自动注册
149
+ this.registerApiNow();
150
+ }
151
+ /** 已注册的 API 函数名(按字典序)。 */
152
+ apiFunctionNames() {
153
+ return this.api ? Object.keys(this.api.functions).sort() : [];
154
+ }
155
+ /** 直接以 JS 参数调用某个 API(不需要写 Lua 代码,便于测试与集成)。 */
156
+ invoke(name, ...args) {
157
+ if (!this.api || !this.raw || !this.objects) {
158
+ throw new Error('请先 await createState()');
159
+ }
160
+ const fn = this.api.functions[name];
161
+ if (!fn)
162
+ throw new Error(`未知的 API 函数:${name}`);
163
+ // 用 SafeMarshal:raise() 直接抛 JS 异常,不触发 Lua 的 lua_error(否则会 panic)
164
+ const safe = new SafeMarshal(this.raw, this.statePointer, this.objects);
165
+ const result = fn(args, safe);
166
+ if (result === undefined)
167
+ return undefined;
168
+ if (Array.isArray(result))
169
+ return result;
170
+ return result;
171
+ }
172
+ /* ---------------------------------------------------------------- *
173
+ * 脚本执行
174
+ * ---------------------------------------------------------------- */
175
+ /** 编译一段 Lua 代码,返回可复用的函数句柄。 */
176
+ async loadString(code, chunkName = 'lua-bridge') {
177
+ await this.ensureState();
178
+ const raw = this.raw;
179
+ const base = raw.lua_gettop(this.statePointer);
180
+ this.compileChunk(code, chunkName);
181
+ const ref = raw.luaL_ref(this.statePointer, marshal_1.LUA_REGISTRYINDEX);
182
+ if (raw.lua_gettop(this.statePointer) !== base) {
183
+ raw.lua_settop(this.statePointer, base);
184
+ }
185
+ this.chunkRefs.add(ref);
186
+ return ref;
187
+ }
188
+ /** 从文件加载 Lua 脚本(对应 CE 的 doFile)。 */
189
+ async loadFile(path) {
190
+ const code = (0, node_fs_1.readFileSync)(path, 'utf8');
191
+ return this.loadString(code, path);
192
+ }
193
+ /** 执行 Lua 代码,返回**第一个**返回值(无返回值时返回 undefined)。 */
194
+ async doString(code) {
195
+ const values = await this.doStringAll(code);
196
+ return values.length > 0 ? values[0] : undefined;
197
+ }
198
+ /** 执行 Lua 代码,返回全部返回值。 */
199
+ async doStringAll(code) {
200
+ await this.ensureState();
201
+ return this.protectedCall(() => this.compileChunk(code, 'lua-bridge'), []);
202
+ }
203
+ /** 执行 Lua 文件,返回第一个返回值。 */
204
+ async doFile(path) {
205
+ const values = await this.doStringAll((0, node_fs_1.readFileSync)(path, 'utf8'));
206
+ return values.length > 0 ? values[0] : undefined;
207
+ }
208
+ /** 调用 Lua 全局函数或 loadString 得到的句柄,返回第一个返回值。 */
209
+ async callFunction(nameOrHandle, ...args) {
210
+ const values = await this.callFunctionAll(nameOrHandle, ...args);
211
+ return values.length > 0 ? values[0] : undefined;
212
+ }
213
+ /** 调用 Lua 函数,返回全部返回值。 */
214
+ async callFunctionAll(nameOrHandle, ...args) {
215
+ await this.ensureState();
216
+ const raw = this.raw;
217
+ const setup = () => {
218
+ if (typeof nameOrHandle === 'number') {
219
+ raw.lua_rawgeti(this.statePointer, marshal_1.LUA_REGISTRYINDEX, BigInt(nameOrHandle));
220
+ return;
221
+ }
222
+ const type = raw.lua_getglobal(this.statePointer, nameOrHandle);
223
+ // LUA_TFUNCTION = 6
224
+ if (type !== 6) {
225
+ raw.lua_pop(this.statePointer, 1);
226
+ throw new LuaScriptError(`全局名字 ${nameOrHandle} 不是函数(类型码 ${type})`, `not a function`);
227
+ }
228
+ };
229
+ return this.protectedCall(setup, args);
230
+ }
231
+ /* ---------------------------------------------------------------- *
232
+ * ApiContext 实现
233
+ * ---------------------------------------------------------------- */
234
+ currentProcess() {
235
+ return this.proc;
236
+ }
237
+ requireProcess() {
238
+ if (!this.proc)
239
+ throw new Error('尚未打开目标进程,请先调用 openProcess(...) 或 attachProcess(proc)');
240
+ return this.proc;
241
+ }
242
+ processId() {
243
+ return this.proc ? this.proc.pid : 0;
244
+ }
245
+ /** 绑定(或解绑)目标进程;旧进程句柄会被关闭,扫描会话与模块缓存会失效。 */
246
+ attachProcess(proc) {
247
+ if (this.proc && this.proc !== proc) {
248
+ try {
249
+ this.proc.close();
250
+ }
251
+ catch {
252
+ /* 忽略 */
253
+ }
254
+ }
255
+ const changed = this.proc !== proc;
256
+ this.proc = proc;
257
+ this.moduleCache = null;
258
+ this.dropDefaultScanSession();
259
+ // 换进程后 Auto Assembler 的 alloc 记录与还原历史对新进程没有意义
260
+ // (旧进程的内存已消失),因此丢弃重建。
261
+ if (changed && this.api)
262
+ this.api.autoAssembler.invalidate();
263
+ }
264
+ listModules() {
265
+ const proc = this.proc;
266
+ if (!proc)
267
+ return [];
268
+ const now = Date.now();
269
+ if (this.moduleCache && now - this.moduleCache.time < this.options.moduleCacheMs) {
270
+ return this.moduleCache.modules;
271
+ }
272
+ const modules = proc.modules();
273
+ this.moduleCache = { time: now, modules };
274
+ return modules;
275
+ }
276
+ /** 按名字找模块:大小写不敏感,支持全路径、带/不带扩展名。 */
277
+ findModule(name) {
278
+ const needle = name.trim().toLowerCase();
279
+ if (needle === '')
280
+ return null;
281
+ const modules = this.listModules();
282
+ const fileOf = (p) => (0, node_path_1.basename)(p).toLowerCase();
283
+ const stripExt = (s) => s.replace(/\.[a-z0-9]+$/, '');
284
+ return (modules.find((m) => fileOf(m.name) === needle) ??
285
+ modules.find((m) => m.path.toLowerCase() === needle) ??
286
+ modules.find((m) => fileOf(m.path) === needle) ??
287
+ modules.find((m) => stripExt(fileOf(m.name)) === stripExt(needle)) ??
288
+ modules.find((m) => stripExt(fileOf(m.path)) === stripExt(needle)) ??
289
+ modules.find((m) => fileOf(m.name).includes(needle)) ??
290
+ null);
291
+ }
292
+ output(text, kind) {
293
+ if (this.options.captureOutput)
294
+ this.outputLines.push(text);
295
+ if (this.options.onOutput) {
296
+ this.options.onOutput(text, kind);
297
+ return;
298
+ }
299
+ process.stdout.write(text + '\n');
300
+ }
301
+ /** 当前捕获到的输出历史(print / showMessage)。 */
302
+ get capturedOutput() {
303
+ return this.outputLines;
304
+ }
305
+ clearOutput() {
306
+ this.outputLines.length = 0;
307
+ }
308
+ defaultScanSession() {
309
+ if (!this.proc) {
310
+ throw new Error('尚未打开目标进程,请先调用 openProcess(...)');
311
+ }
312
+ if (!this.session) {
313
+ this.session = new objects_1.LuaScanSession(this.proc, this.scanner);
314
+ }
315
+ return this.session;
316
+ }
317
+ dropDefaultScanSession() {
318
+ if (this.session) {
319
+ try {
320
+ this.session.destroy();
321
+ }
322
+ catch {
323
+ /* 忽略 */
324
+ }
325
+ this.session = null;
326
+ }
327
+ }
328
+ /* ---------------------------------------------------------------- *
329
+ * 销毁
330
+ * ---------------------------------------------------------------- */
331
+ /** 释放 Lua 状态、注册的 C 函数与本引擎打开的进程句柄。 */
332
+ async dispose(options = {}) {
333
+ if (this.disposed)
334
+ return;
335
+ this.disposed = true;
336
+ const raw = this.raw;
337
+ if (raw) {
338
+ for (const ref of this.chunkRefs) {
339
+ try {
340
+ raw.luaL_unref(this.statePointer, marshal_1.LUA_REGISTRYINDEX, ref);
341
+ }
342
+ catch {
343
+ /* 忽略 */
344
+ }
345
+ }
346
+ this.chunkRefs.clear();
347
+ raw.lua_settop(this.statePointer, 0);
348
+ }
349
+ this.objects?.dispose();
350
+ for (const ptr of this.functionPointers) {
351
+ try {
352
+ raw?.module.removeFunction(ptr);
353
+ }
354
+ catch {
355
+ /* 忽略 */
356
+ }
357
+ }
358
+ this.functionPointers.length = 0;
359
+ if (raw && this.messageHandlerPointer) {
360
+ try {
361
+ raw.module.removeFunction(this.messageHandlerPointer);
362
+ }
363
+ catch {
364
+ /* 忽略 */
365
+ }
366
+ this.messageHandlerPointer = 0;
367
+ }
368
+ this.dropDefaultScanSession();
369
+ try {
370
+ this.wasm?.global.close();
371
+ }
372
+ catch {
373
+ /* 忽略 */
374
+ }
375
+ if (options.closeProcess !== false && this.proc) {
376
+ try {
377
+ this.proc.close();
378
+ }
379
+ catch {
380
+ /* 忽略 */
381
+ }
382
+ this.proc = null;
383
+ }
384
+ this.raw = null;
385
+ this.wasm = null;
386
+ this.factory = null;
387
+ this.marshal = null;
388
+ this.api = null;
389
+ this.apiRegistered = false;
390
+ }
391
+ /* ---------------------------------------------------------------- *
392
+ * 内部实现
393
+ * ---------------------------------------------------------------- */
394
+ async ensureState() {
395
+ if (this.raw)
396
+ return;
397
+ if (this.disposed)
398
+ throw new Error('LuaEngine 已销毁');
399
+ await this.createState();
400
+ }
401
+ /** 注册全部 API 为 Lua 全局函数(用原始 C 闭包,保住 int64 精度)。 */
402
+ registerApiNow() {
403
+ const raw = this.raw;
404
+ const marshal = this.marshal;
405
+ const api = this.api;
406
+ if (!raw || !marshal || !api || this.apiRegistered)
407
+ return;
408
+ // 错误消息处理器:pcall 出错时补上 Lua 侧的调用栈
409
+ this.messageHandlerPointer = raw.module.addFunction((state) => this.messageHandler(state), 'ii');
410
+ for (const [name, fn] of Object.entries(api.functions)) {
411
+ const pointer = raw.module.addFunction((state) => this.invokeApi(name, fn, state), 'ii');
412
+ this.functionPointers.push(pointer);
413
+ marshal.pushClosure(pointer, []);
414
+ raw.lua_setglobal(this.statePointer, name);
415
+ }
416
+ this.apiRegistered = true;
417
+ }
418
+ /** API 闭包的统一入口:把 Lua 栈上的参数解码成 JS 值,再把结果编码回 Lua。 */
419
+ invokeApi(name, fn, state) {
420
+ const base = this.marshal;
421
+ const m = base.withState(state);
422
+ try {
423
+ const argc = m.top();
424
+ const args = [];
425
+ for (let i = 1; i <= argc; i++)
426
+ args.push(m.read(i));
427
+ const result = fn(args, m);
428
+ return m.pushResult(result);
429
+ }
430
+ catch (e) {
431
+ if ((0, marshal_1.isLuaLongjmp)(e))
432
+ throw e; // lua_error 的 longjmp 哨兵必须原样抛出
433
+ m.raise(`${name}: ${(0, marshal_1.describeError)(e)}`);
434
+ return 0;
435
+ }
436
+ }
437
+ /** pcall 的错误消息处理器(errfunc):补 traceback。 */
438
+ messageHandler(state) {
439
+ const raw = this.raw;
440
+ raw.luaL_tolstring(state, 1, null); // 把任意错误对象转成字符串压栈
441
+ const message = raw.lua_tolstring(state, -1, null);
442
+ raw.lua_pop(state, 1);
443
+ raw.luaL_traceback(state, state, message, 1);
444
+ return 1;
445
+ }
446
+ /** 把一段代码编译成函数压栈;出错抛 LuaScriptError。 */
447
+ compileChunk(code, chunkName) {
448
+ const raw = this.raw;
449
+ const base = raw.lua_gettop(this.statePointer);
450
+ const bytes = Buffer.byteLength(code, 'utf8');
451
+ const pointer = raw.module._malloc(bytes + 1);
452
+ try {
453
+ raw.module.stringToUTF8(code, pointer, bytes + 1);
454
+ const status = raw.luaL_loadbufferx(this.statePointer, pointer, bytes, chunkName, null);
455
+ if (status !== marshal_1.LUA_OK) {
456
+ const message = raw.lua_tolstring(this.statePointer, -1, null) ?? '未知的编译错误';
457
+ raw.lua_settop(this.statePointer, base);
458
+ throw new LuaScriptError(`Lua 语法错误:${message}`, message);
459
+ }
460
+ }
461
+ finally {
462
+ raw.module._free(pointer);
463
+ }
464
+ }
465
+ /**
466
+ * 受保护地调用栈上的函数。
467
+ *
468
+ * 栈布局:base+1 = 错误处理器,base+2 = 被调函数,随后是参数。
469
+ * setup 负责压入函数(编译好的 chunk / 全局函数 / 注册表句柄)。
470
+ */
471
+ protectedCall(setup, args) {
472
+ const raw = this.raw;
473
+ const marshal = this.marshal;
474
+ const L = this.statePointer;
475
+ const base = raw.lua_gettop(L);
476
+ try {
477
+ setup();
478
+ }
479
+ catch (e) {
480
+ raw.lua_settop(L, base);
481
+ throw e;
482
+ }
483
+ if (raw.lua_gettop(L) !== base + 1) {
484
+ raw.lua_settop(L, base);
485
+ throw new Error('内部错误:setup 必须压入恰好一个函数');
486
+ }
487
+ raw.lua_pushcclosure(L, this.messageHandlerPointer, 0); // base+2
488
+ raw.lua_rotate(L, base + 1, 1); // 交换 → [错误处理器, 函数]
489
+ for (const a of args)
490
+ marshal.push(a);
491
+ const status = raw.lua_pcallk(L, args.length, marshal_1.LUA_MULTRET, base + 1, 0, null);
492
+ if (status !== marshal_1.LUA_OK) {
493
+ let message = '未知的 Lua 错误';
494
+ try {
495
+ message = raw.lua_tolstring(L, -1, null) ?? message;
496
+ }
497
+ catch {
498
+ /* 忽略 */
499
+ }
500
+ raw.lua_settop(L, base);
501
+ throw new LuaScriptError(`Lua 运行时错误:${message}`, message);
502
+ }
503
+ const count = raw.lua_gettop(L) - (base + 1);
504
+ const values = [];
505
+ for (let i = 0; i < count; i++) {
506
+ values.push(marshal.read(base + 2 + i));
507
+ }
508
+ raw.lua_settop(L, base);
509
+ return values;
510
+ }
511
+ }
512
+ exports.LuaEngine = LuaEngine;
513
+ /**
514
+ * 只能在 Lua 之外使用的 Marshal:`raise` 直接抛 JS 异常。
515
+ *
516
+ * 直接调用 lua_error 在 pcall 之外会导致 Lua panic(进程 abort),
517
+ * 因此 engine.invoke() 用这个子类。
518
+ */
519
+ class SafeMarshal extends marshal_1.LuaMarshal {
520
+ raise(message) {
521
+ throw new Error(message);
522
+ }
523
+ }
524
+ var marshal_2 = require("./marshal");
525
+ Object.defineProperty(exports, "LuaMarshal", { enumerable: true, get: function () { return marshal_2.LuaMarshal; } });
526
+ //# sourceMappingURL=bridge.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"bridge.js","sourceRoot":"","sources":["../../../src/lua/bridge.ts"],"names":[],"mappings":"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"}