@bingine/cemem 0.0.0-stage → 0.1.1

package/dist/types/backend/native-ce-backend.d.ts

@@ -0,0 +1,213 @@
+/**
+ * 原生 CE 后端 —— 作为客户端连接 Cheat Engine 官方的 `ceserver`。
+ *
+ * 协议来源：`Cheat Engine/ceserver/ceserver.h`（命令号与结构体定义）+
+ *           `ceserver.c` 的 `DispatchCommand` 分支（收发顺序与字段宽度）。
+ *
+ * 线上格式（全部小端）：每个请求 = 1 字节命令号 + 该命令的输入负载；
+ * 每条命令使用一个独立连接。
+ *
+ * ## 为什么这个后端是异步的
+ *
+ * 它必须走 socket，而 socket 本质异步。
+ * 曾经尝试把它包装成同步接口，两条路都**实测失败**：
+ *
+ *   1. 主线程里 `Promise + Atomics.wait` → 阻塞把事件循环卡死，
+ *      socket 回调永不执行（`_probe/atomics-wait-io.js` 可复现）；
+ *   2. 把 socket 挪到 worker 线程、主线程仍 `Atomics.wait` → **同样死锁**，
+ *      因为 worker 线程被 `Atomics.wait` 阻塞后，它自己的事件循环也停了，
+ *      socket 回调一样不会跑（`_probe/mini-repro.js` 可复现）。
+ *
+ * 结论：`Atomics.wait` 与 socket I/O 无法在任何同一线程内共存。
+ * 因此本后端**诚实地暴露为异步 API**（方法返回 Promise），
+ * 而不是用子进程或忙轮询去伪造同步 —— 那只会把复杂度推移到别处。
+ *
+ * ## 与 SelfBackend 的一致性
+ *
+ * 方法名、参数、返回类型语义与 `SelfBackend` 完全一致，区别只有一个 `await`：
+ * ```ts
+ * const buf = proc.readMemory(addr, 16);                 // 自研后端：同步
+ * const buf = await proc.readMemoryAsync(addr, 16);      // 原生 CE：异步
+ * ```
+ * （`Process` 上的 `*Async` 变体对两种后端都可用。）
+ *
+ * ## 已对齐的命令
+ *   GETVERSION(0)、GETARCHITECTURE(21)、OPENPROCESS(3)、CLOSEHANDLE(7)、
+ *   CREATETOOLHELP32SNAPSHOT(4)、PROCESS32FIRST(5)、PROCESS32NEXT(6)、
+ *   VIRTUALQUERYEX(8)、READPROCESSMEMORY(9)、WRITEPROCESSMEMORY(10)、
+ *   MODULE32FIRST(22)、MODULE32NEXT(23)、ALLOC(26)、FREE(27)、
+ *   CHANGEMEMORYPROTECTION(36)
+ *
+ * ## 未实现（调用会抛错，不假装支持）
+ *   线程枚举（CMD_CREATETOOLHELP32SNAPSHOTEX 响应布局随版本变化）、
+ *   调试器相关命令、速度修改、管道、符号文件加载。
+ */
+import { BackendCapabilities, BackendModuleInfo, BackendProcessHandle, BackendProcessInfo, BackendRegion, BackendRegionFilter, MemoryBackend } from './types';
+export declare const CESERVER_CMD: {
+    readonly GETVERSION: 0;
+    readonly CLOSECONNECTION: 1;
+    readonly TERMINATESERVER: 2;
+    readonly OPENPROCESS: 3;
+    readonly CREATETOOLHELP32SNAPSHOT: 4;
+    readonly PROCESS32FIRST: 5;
+    readonly PROCESS32NEXT: 6;
+    readonly CLOSEHANDLE: 7;
+    readonly VIRTUALQUERYEX: 8;
+    readonly READPROCESSMEMORY: 9;
+    readonly WRITEPROCESSMEMORY: 10;
+    readonly STARTDEBUG: 11;
+    readonly STOPDEBUG: 12;
+    readonly WAITFORDEBUGEVENT: 13;
+    readonly CONTINUEFROMDEBUGEVENT: 14;
+    readonly SETBREAKPOINT: 15;
+    readonly REMOVEBREAKPOINT: 16;
+    readonly SUSPENDTHREAD: 17;
+    readonly RESUMETHREAD: 18;
+    readonly GETTHREADCONTEXT: 19;
+    readonly SETTHREADCONTEXT: 20;
+    readonly GETARCHITECTURE: 21;
+    readonly MODULE32FIRST: 22;
+    readonly MODULE32NEXT: 23;
+    readonly GETSYMBOLLISTFROMFILE: 24;
+    readonly LOADEXTENSION: 25;
+    readonly ALLOC: 26;
+    readonly FREE: 27;
+    readonly CREATETHREAD: 28;
+    readonly LOADMODULE: 29;
+    readonly SPEEDHACK_SETSPEED: 30;
+    readonly VIRTUALQUERYEXFULL: 31;
+    readonly GETREGIONINFO: 32;
+    readonly GETABI: 33;
+    readonly SET_CONNECTION_NAME: 34;
+    readonly CREATETOOLHELP32SNAPSHOTEX: 35;
+    readonly CHANGEMEMORYPROTECTION: 36;
+    readonly GETOPTIONS: 37;
+    readonly GETOPTIONVALUE: 38;
+    readonly SETOPTIONVALUE: 39;
+    readonly PTRACE_MMAP: 40;
+    readonly OPENNAMEDPIPE: 41;
+    readonly PIPEREAD: 42;
+    readonly PIPEWRITE: 43;
+    readonly GETCESERVERPATH: 44;
+    readonly ISANDROID: 45;
+    readonly LOADMODULEEX: 46;
+    readonly SETCURRENTPATH: 47;
+    readonly GETCURRENTPATH: 48;
+    readonly ENUMFILES: 49;
+    readonly GETFILEPERMISSIONS: 50;
+    readonly SETFILEPERMISSIONS: 51;
+    readonly GETFILE: 52;
+    readonly PUTFILE: 53;
+    readonly CREATEDIR: 54;
+    readonly DELETEFILE: 55;
+    readonly AOBSCAN: 200;
+    readonly COMMANDLIST2: 255;
+};
+/** CE 官方 ceserver 的默认端口（ceserver.c 的 PORT 默认值） */
+export declare const CESERVER_DEFAULT_PORT = 52736;
+/** 累积式小端写入器 */
+export declare class CeWriter {
+    private parts;
+    u8(v: number): this;
+    i32(v: number): this;
+    u32(v: number): this;
+    i64(v: bigint): this;
+    u64(v: bigint): this;
+    bytes(b: Buffer): this;
+    build(): Buffer;
+}
+/** 顺序小端读取器 */
+export declare class CeReader {
+    private readonly buf;
+    private pos;
+    constructor(buf: Buffer);
+    get remaining(): number;
+    u8(): number;
+    i32(): number;
+    u32(): number;
+    i64(): bigint;
+    u64(): bigint;
+    bytes(n: number): Buffer;
+    skip(n: number): void;
+}
+export interface NativeCeBackendOptions {
+    /** ceserver 主机，默认 127.0.0.1 */
+    host?: string;
+    /** ceserver 端口，默认 52736 */
+    port?: number;
+    /** 单次命令超时（毫秒），默认 15000 */
+    timeoutMs?: number;
+}
+/**
+ * 原生 CE 后端（通过 ceserver 的 TCP 协议）。
+ *
+ * 所有方法都是**异步**的（返回 Promise），因为 socket 本质异步 —— 原因见文件头注释。
+ *
+ * ```ts
+ * const backend = new NativeCeBackend({ host: '127.0.0.1', port: 52736 });
+ * const h = await backend.openProcess(pid);
+ * const buf = await backend.readProcessMemory(h, addr, 64);
+ * await backend.dispose();
+ * ```
+ */
+export declare class NativeCeBackend implements MemoryBackend {
+    readonly name = "native-ce";
+    readonly capabilities: BackendCapabilities;
+    readonly host: string;
+    readonly port: number;
+    readonly timeoutMs: number;
+    private readonly conn;
+    private disposed;
+    /** handle id -> ceserver 侧 HANDLE */
+    private nextHandleId;
+    private readonly handles;
+    private version;
+    constructor(options?: NativeCeBackendOptions);
+    /** 后端描述，用于日志 */
+    describe(): string;
+    /**
+     * 读取 ceserver 版本字符串（CMD_GETVERSION，结果缓存）。
+     *
+     * 响应布局：`{ int32 version; uint8 stringsize; char versionstring[stringsize]; }`
+     * 分两轮读（先读 5 字节头拿长度，再读全）—— 因为 ceserver 每条命令一个连接，
+     * 无法在一条连接上续读。
+     */
+    getVersion(): Promise<string>;
+    listProcesses(): Promise<BackendProcessInfo[]>;
+    openProcess(pid: number): Promise<BackendProcessHandle>;
+    closeProcess(handle: BackendProcessHandle): Promise<void>;
+    private closeServerHandle;
+    private serverHandle;
+    queryRegions(handle: BackendProcessHandle, filter?: BackendRegionFilter): Promise<BackendRegion[]>;
+    readProcessMemory(handle: BackendProcessHandle, address: bigint, size: number): Promise<Buffer>;
+    writeProcessMemory(handle: BackendProcessHandle, address: bigint, data: Buffer, fixProtection?: boolean): Promise<number>;
+    queryModules(handle: BackendProcessHandle): Promise<BackendModuleInfo[]>;
+    allocate(handle: BackendProcessHandle, size: number, protect?: number, preferred?: bigint): Promise<bigint>;
+    free(handle: BackendProcessHandle, address: bigint): Promise<void>;
+    changeProtection(handle: BackendProcessHandle, address: bigint, size: number, newProtect: number): Promise<number>;
+    queryThreads(): number[];
+    isWow64(): boolean;
+    /** 发送一帧、读回 expectedBytes 字节 */
+    private exchange;
+    /** 释放后端资源 */
+    dispose(): Promise<void>;
+}
+/**
+ * ceserver 的 TCP 通道。
+ *
+ * 每条命令使用一个独立连接：服务端 `DispatchCommand` 处理完一条命令即关闭，
+ * 而且"每条命令一个连接"能让"先读计数、再读数据"这类两步读取天然成立
+ * （两边各自重新发一次命令即可）。
+ */
+export declare class CeServerConnection {
+    readonly host: string;
+    readonly port: number;
+    readonly timeoutMs: number;
+    constructor(host: string, port: number, timeoutMs?: number);
+    /** 发送一帧并读回 expectedBytes 字节 */
+    exchange(label: string, frame: Buffer, expectedBytes: number): Promise<Buffer>;
+    private connect;
+    private write;
+    private readExactly;
+}
+//# sourceMappingURL=native-ce-backend.d.ts.map

package/dist/types/backend/native-ce-backend.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"native-ce-backend.d.ts","sourceRoot":"","sources":["../../../src/backend/native-ce-backend.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA2CG;AAGH,OAAO,EACL,mBAAmB,EACnB,iBAAiB,EACjB,oBAAoB,EACpB,kBAAkB,EAClB,aAAa,EACb,mBAAmB,EACnB,aAAa,EACd,MAAM,SAAS,CAAC;AAQjB,eAAO,MAAM,YAAY;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CA2Df,CAAC;AAKX,kDAAkD;AAClD,eAAO,MAAM,qBAAqB,QAAQ,CAAC;AAM3C,eAAe;AACf,qBAAa,QAAQ;IACnB,OAAO,CAAC,KAAK,CAAgB;IAE7B,EAAE,CAAC,CAAC,EAAE,MAAM,GAAG,IAAI;IAMnB,GAAG,CAAC,CAAC,EAAE,MAAM,GAAG,IAAI;IAMpB,GAAG,CAAC,CAAC,EAAE,MAAM,GAAG,IAAI;IAMpB,GAAG,CAAC,CAAC,EAAE,MAAM,GAAG,IAAI;IAMpB,GAAG,CAAC,CAAC,EAAE,MAAM,GAAG,IAAI;IAMpB,KAAK,CAAC,CAAC,EAAE,MAAM,GAAG,IAAI;IAItB,KAAK,IAAI,MAAM;CAGhB;AAED,cAAc;AACd,qBAAa,QAAQ;IAEP,OAAO,CAAC,QAAQ,CAAC,GAAG;IADhC,OAAO,CAAC,GAAG,CAAK;gBACa,GAAG,EAAE,MAAM;IAExC,IAAI,SAAS,IAAI,MAAM,CAEtB;IACD,EAAE,IAAI,MAAM;IAKZ,GAAG,IAAI,MAAM;IAKb,GAAG,IAAI,MAAM;IAKb,GAAG,IAAI,MAAM;IAKb,GAAG,IAAI,MAAM;IAKb,KAAK,CAAC,CAAC,EAAE,MAAM,GAAG,MAAM;IAKxB,IAAI,CAAC,CAAC,EAAE,MAAM,GAAG,IAAI;CAGtB;AAMD,MAAM,WAAW,sBAAsB;IACrC,+BAA+B;IAC/B,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,2BAA2B;IAC3B,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,0BAA0B;IAC1B,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED;;;;;;;;;;;GAWG;AACH,qBAAa,eAAgB,YAAW,aAAa;IACnD,QAAQ,CAAC,IAAI,eAAe;IAE5B,QAAQ,CAAC,YAAY,EAAE,mBAAmB,CAYxC;IAEF,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAE3B,OAAO,CAAC,QAAQ,CAAC,IAAI,CAAqB;IAC1C,OAAO,CAAC,QAAQ,CAAS;IAEzB,qCAAqC;IACrC,OAAO,CAAC,YAAY,CAAK;IACzB,OAAO,CAAC,QAAQ,CAAC,OAAO,CAA6B;IAErD,OAAO,CAAC,OAAO,CAAuB;gBAE1B,OAAO,GAAE,sBAA2B;IAOhD,gBAAgB;IAChB,QAAQ,IAAI,MAAM;IAQlB;;;;;;OAMG;IACG,UAAU,IAAI,OAAO,CAAC,MAAM,CAAC;IA6B7B,aAAa,IAAI,OAAO,CAAC,kBAAkB,EAAE,CAAC;IAmD9C,WAAW,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,oBAAoB,CAAC;IAmBvD,YAAY,CAAC,MAAM,EAAE,oBAAoB,GAAG,OAAO,CAAC,IAAI,CAAC;YAOjD,iBAAiB;IAY/B,OAAO,CAAC,YAAY;IAUd,YAAY,CAChB,MAAM,EAAE,oBAAoB,EAC5B,MAAM,GAAE,mBAAwB,GAC/B,OAAO,CAAC,aAAa,EAAE,CAAC;IA8CrB,iBAAiB,CACrB,MAAM,EAAE,oBAAoB,EAC5B,OAAO,EAAE,MAAM,EACf,IAAI,EAAE,MAAM,GACX,OAAO,CAAC,MAAM,CAAC;IAuBZ,kBAAkB,CACtB,MAAM,EAAE,oBAAoB,EAC5B,OAAO,EAAE,MAAM,EACf,IAAI,EAAE,MAAM,EACZ,aAAa,UAAO,GACnB,OAAO,CAAC,MAAM,CAAC;IAmCZ,YAAY,CAAC,MAAM,EAAE,oBAAoB,GAAG,OAAO,CAAC,iBAAiB,EAAE,CAAC;IAsDxE,QAAQ,CACZ,MAAM,EAAE,oBAAoB,EAC5B,IAAI,EAAE,MAAM,EACZ,OAAO,SAAO,EACd,SAAS,SAAK,GACb,OAAO,CAAC,MAAM,CAAC;IAeZ,IAAI,CAAC,MAAM,EAAE,oBAAoB,EAAE,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAYlE,gBAAgB,CACpB,MAAM,EAAE,oBAAoB,EAC5B,OAAO,EAAE,MAAM,EACf,IAAI,EAAE,MAAM,EACZ,UAAU,EAAE,MAAM,GACjB,OAAO,CAAC,MAAM,CAAC;IAsBlB,YAAY,IAAI,MAAM,EAAE;IAQxB,OAAO,IAAI,OAAO;IAKlB,+BAA+B;IAC/B,OAAO,CAAC,QAAQ;IAIhB,aAAa;IACP,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC;CAO/B;AAMD;;;;;;GAMG;AACH,qBAAa,kBAAkB;IAE3B,QAAQ,CAAC,IAAI,EAAE,MAAM;IACrB,QAAQ,CAAC,IAAI,EAAE,MAAM;IACrB,QAAQ,CAAC,SAAS;gBAFT,IAAI,EAAE,MAAM,EACZ,IAAI,EAAE,MAAM,EACZ,SAAS,SAAQ;IAG5B,+BAA+B;IACzB,QAAQ,CAAC,KAAK,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,aAAa,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;IAWpF,OAAO,CAAC,OAAO;IAwBf,OAAO,CAAC,KAAK;IAMb,OAAO,CAAC,WAAW;CAuDpB"}

package/dist/types/backend/self-backend.d.ts

@@ -0,0 +1,64 @@
+/**
+ * 自研后端 —— 在本进程内直接通过 Win32 API 操作目标进程。
+ *
+ * 这是默认后端，也是本移植的"自实现 CE"引擎本体：
+ * 对应 Cheat Engine 在**没有内核驱动时**走的那套用户态路径
+ * （`NewKernelHandler.pas` 的 `ReadProcessMemory`/`VirtualQueryEx` 分支）。
+ *
+ * 优点：无外部依赖，开箱即用，兼容性最强。
+ * 局限：受 Windows 进程保护约束（受保护进程 / 反作弊 / PPL 进程读不到），
+ *       也没有内核驱动那种绕过 ObRegisterCallbacks 的能力 —— 那需要 ring-0，
+ *       Node 里不存在实现路径，见 PORT-SCOPE.md。
+ */
+import { BackendCapabilities, BackendModuleInfo, BackendProcessHandle, BackendProcessInfo, BackendRegion, BackendRegionFilter, BackendUnsupportedError, MemoryBackend } from './types';
+/** 判断保护属性是否可读 */
+export declare function isReadable(protect: number): boolean;
+/** 判断保护属性是否可写 */
+export declare function isWritable(protect: number): boolean;
+/** 判断保护属性是否可执行 */
+export declare function isExecutable(protect: number): boolean;
+/** 按过滤条件筛出可扫描区域（与后端无关的纯函数，供两个后端共用） */
+export declare function filterScanRegions(regions: BackendRegion[], filter?: BackendRegionFilter): BackendRegion[];
+export interface SelfBackendOptions {
+    /** 打开进程时请求的访问权限，默认 DEFAULT_PROCESS_ACCESS */
+    access?: number;
+}
+/**
+ * 自研后端（默认）。
+ *
+ * ```ts
+ * const backend = new SelfBackend();
+ * const h = backend.openProcess(pid);
+ * const buf = backend.readProcessMemory(h, addr, 64);
+ * ```
+ */
+export declare class SelfBackend implements MemoryBackend {
+    readonly name = "self";
+    readonly capabilities: BackendCapabilities;
+    private readonly access;
+    private nextHandleId;
+    private readonly handles;
+    private disposed;
+    constructor(options?: SelfBackendOptions);
+    listProcesses(): BackendProcessInfo[];
+    openProcess(pid: number): BackendProcessHandle;
+    closeProcess(handle: BackendProcessHandle): void;
+    private raw;
+    private assertNotDisposed;
+    queryRegions(handle: BackendProcessHandle, filter?: BackendRegionFilter): BackendRegion[];
+    readProcessMemory(handle: BackendProcessHandle, address: bigint, size: number): Buffer;
+    writeProcessMemory(handle: BackendProcessHandle, address: bigint, data: Buffer, fixProtection?: boolean): number;
+    queryModules(handle: BackendProcessHandle): BackendModuleInfo[];
+    queryThreads(handle: BackendProcessHandle): number[];
+    allocate(handle: BackendProcessHandle, size: number, protect?: number, preferred?: bigint): bigint;
+    free(handle: BackendProcessHandle, address: bigint): void;
+    changeProtection(handle: BackendProcessHandle, address: bigint, size: number, newProtect: number): number;
+    isWow64(handle: BackendProcessHandle): boolean;
+    /** 挂起目标进程全部线程，返回可恢复的线程句柄 */
+    suspendAllThreads(handle: BackendProcessHandle): bigint[];
+    /** 恢复之前挂起的线程并关闭句柄 */
+    resumeThreads(handles: bigint[]): void;
+    dispose(): void;
+}
+export { BackendUnsupportedError };
+//# sourceMappingURL=self-backend.d.ts.map

package/dist/types/backend/self-backend.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"self-backend.d.ts","sourceRoot":"","sources":["../../../src/backend/self-backend.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAWH,OAAO,EACL,mBAAmB,EACnB,iBAAiB,EACjB,oBAAoB,EACpB,kBAAkB,EAClB,aAAa,EACb,mBAAmB,EACnB,uBAAuB,EACvB,aAAa,EACd,MAAM,SAAS,CAAC;AA6DjB,iBAAiB;AACjB,wBAAgB,UAAU,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAanD;AAED,iBAAiB;AACjB,wBAAgB,UAAU,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAInD;AAED,kBAAkB;AAClB,wBAAgB,YAAY,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAGrD;AAED,sCAAsC;AACtC,wBAAgB,iBAAiB,CAC/B,OAAO,EAAE,aAAa,EAAE,EACxB,MAAM,GAAE,mBAAwB,GAC/B,aAAa,EAAE,CAgBjB;AAMD,MAAM,WAAW,kBAAkB;IACjC,6CAA6C;IAC7C,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED;;;;;;;;GAQG;AACH,qBAAa,WAAY,YAAW,aAAa;IAC/C,QAAQ,CAAC,IAAI,UAAU;IAEvB,QAAQ,CAAC,YAAY,EAAE,mBAAmB,CAYxC;IAEF,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAS;IAChC,OAAO,CAAC,YAAY,CAAK;IACzB,OAAO,CAAC,QAAQ,CAAC,OAAO,CAA6B;IACrD,OAAO,CAAC,QAAQ,CAAS;gBAEb,OAAO,GAAE,kBAAuB;IAM5C,aAAa,IAAI,kBAAkB,EAAE;IA0BrC,WAAW,CAAC,GAAG,EAAE,MAAM,GAAG,oBAAoB;IAgB9C,YAAY,CAAC,MAAM,EAAE,oBAAoB,GAAG,IAAI;IAOhD,OAAO,CAAC,GAAG;IAMX,OAAO,CAAC,iBAAiB;IAMzB,YAAY,CAAC,MAAM,EAAE,oBAAoB,EAAE,MAAM,GAAE,mBAAwB,GAAG,aAAa,EAAE;IAyC7F,iBAAiB,CAAC,MAAM,EAAE,oBAAoB,EAAE,OAAO,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,MAAM;IA6BtF,kBAAkB,CAChB,MAAM,EAAE,oBAAoB,EAC5B,OAAO,EAAE,MAAM,EACf,IAAI,EAAE,MAAM,EACZ,aAAa,UAAO,GACnB,MAAM;IA6CT,YAAY,CAAC,MAAM,EAAE,oBAAoB,GAAG,iBAAiB,EAAE;IA2B/D,YAAY,CAAC,MAAM,EAAE,oBAAoB,GAAG,MAAM,EAAE;IAqBpD,QAAQ,CACN,MAAM,EAAE,oBAAoB,EAC5B,IAAI,EAAE,MAAM,EACZ,OAAO,SAAO,EACd,SAAS,SAAK,GACb,MAAM;IAaT,IAAI,CAAC,MAAM,EAAE,oBAAoB,EAAE,OAAO,EAAE,MAAM,GAAG,IAAI;IAOzD,gBAAgB,CACd,MAAM,EAAE,oBAAoB,EAC5B,OAAO,EAAE,MAAM,EACf,IAAI,EAAE,MAAM,EACZ,UAAU,EAAE,MAAM,GACjB,MAAM;IAaT,OAAO,CAAC,MAAM,EAAE,oBAAoB,GAAG,OAAO;IAS9C,4BAA4B;IAC5B,iBAAiB,CAAC,MAAM,EAAE,oBAAoB,GAAG,MAAM,EAAE;IAazD,qBAAqB;IACrB,aAAa,CAAC,OAAO,EAAE,MAAM,EAAE,GAAG,IAAI;IAOtC,OAAO,IAAI,IAAI;CAMhB;AAED,OAAO,EAAE,uBAAuB,EAAE,CAAC"}

package/dist/types/backend/types.d.ts

@@ -0,0 +1,176 @@
+/**
+ * 内存后端抽象 —— 让上层 API 与"用哪个引擎"解耦。
+ *
+ * 本移植提供三种可切换的调用方式：
+ *
+ *  1. `SelfBackend`（默认，自研引擎）
+ *     直接通过 Win32 API（koffi 绑定）在本进程内读写目标进程内存。
+ *     没有外部依赖，兼容性最强，扫描逻辑由本移植的 matcher 实现。
+ *
+ *  2. `NativeCeBackend`（原生 CE 兼容层）
+ *     作为客户端连接 Cheat Engine 官方的 `ceserver`（CE 源码里
+ *     `Cheat Engine/ceserver/` 那套服务端程序），走 CE 自己的 TCP 协议。
+ *     好处是可以复用原生 CE 的能力（它跑在目标机器上、可能带驱动），
+ *     代价是需要一个正在运行的 ceserver。
+ *
+ *  3. `DbkBackend`（DBK 内核驱动，见 `dbk-backend.ts` 与 docs/backend-dbk.md）
+ *     通过 CE 自己的 DBK64 驱动 ioctl 读写，**同步**。
+ *     这是读**受保护进程**（PPL/反作弊/以更高权限运行）的唯一途径 ——
+ *     用户态连句柄都打不开。
+ *     前提：驱动已加载（加载需要管理员权限，插件侧用 `ce_kernel` 工具装）。
+ *     能力边界：`changeProtection`/`free` 仍是用户态实现（CE 驱动的
+ *     `MAKEWRITABLE` 在 x64 上是空的），对受保护进程会失败；
+ *     且其驱动侧结构布局尚未在真机上验证。
+ *
+ * 上层的扫描会话、地址表、.CT 读写、地址表达式都对三者一视同仁：
+ * 它们只依赖本文件定义的 `MemoryBackend` 接口。
+ *
+ * DBK64 内核驱动接口（`DBK32functions.pas` 里的 `Dbk*` 系列 ioctl）
+ * 由 `DbkBackend` 实现（见上文第 3 条），协议细节与已知限制见
+ * `docs/backend-dbk.md`。
+ */
+/**
+ * 一个值或它的 Promise。
+ *
+ * 之所以引入它：内存后端有两种性质完全不同的实现 ——
+ *   - `SelfBackend` / `DbkBackend`：**同步**（本进程内调 Win32 API / 发驱动 ioctl），直接返回值；
+ *   - `NativeCeBackend`：socket 通信，**本质异步**。
+ *
+ * 这里**不**试图把异步"伪装"成同步：实测证明 `Atomics.wait` 会卡死所在线程的
+ * 事件循环（无论 socket 放在哪个线程都不行，最小复现见 `_probe/mini-repro.js`），
+ * 因此同步调用原生 CE 是不可实现的。诚实的设计是让接口允许返回 Promise。
+ *
+ * 约定：
+ *   - 同步后端（`capabilities.sync === true`）**必须**直接返回值，不能返回 Promise；
+ *   - 异步后端返回 Promise，调用方需要 `await`；
+ *   - 使用 `await` 对两种情况都安全（`await` 一个非 Promise 值原样返回）。
+ */
+export type MaybePromise<T> = T | Promise<T>;
+/** 一个进程的内存句柄（不透明） */
+export interface BackendProcessHandle {
+    /** 后端内部使用的句柄标识 */
+    readonly id: number;
+    /** 目标进程 id */
+    readonly pid: number;
+}
+/** 内存区域信息（与 Win32 MEMORY_BASIC_INFORMATION 对齐） */
+export interface BackendRegion {
+    baseAddress: bigint;
+    regionSize: bigint;
+    /** MEM_COMMIT / MEM_RESERVE / MEM_FREE */
+    state: number;
+    /** 保护属性（PAGE_*） */
+    protect: number;
+    /** MEM_IMAGE / MEM_MAPPED / MEM_PRIVATE */
+    type: number;
+}
+/** 进程信息 */
+export interface BackendProcessInfo {
+    pid: number;
+    name: string;
+    parentPid: number;
+    threadCount: number;
+}
+/** 模块信息 */
+export interface BackendModuleInfo {
+    name: string;
+    path: string;
+    baseAddress: bigint;
+    size: number;
+}
+/** 内存区域过滤条件 */
+export interface BackendRegionFilter {
+    includeFree?: boolean;
+    maxAddress?: bigint;
+    writableOnly?: boolean;
+    executableOnly?: boolean;
+    includeImage?: boolean;
+    includeMapped?: boolean;
+    includePrivate?: boolean;
+    includeGuard?: boolean;
+}
+/** 后端能力声明，供上层做能力检查与降级 */
+export interface BackendCapabilities {
+    /**
+     * 所有操作是否**同步**完成（直接返回值，而非 Promise）。
+     * `true` 的后端必须同步返回；`false` 的后端返回 Promise，调用方需 await。
+     */
+    sync: boolean;
+    /** 能否枚举进程 */
+    enumerateProcesses: boolean;
+    /** 能否枚举内存区域 */
+    queryRegions: boolean;
+    /** 能否枚举模块 */
+    queryModules: boolean;
+    /** 能否枚举线程 */
+    queryThreads: boolean;
+    /** 能否挂起/恢复线程 */
+    suspendThreads: boolean;
+    /** 能否在目标内分配内存 */
+    allocateMemory: boolean;
+    /** 能否修改内存保护属性 */
+    changeProtection: boolean;
+    /** 是否在目标机器本地运行 */
+    local: boolean;
+    /** 是否需要外部服务端 */
+    requiresServer: boolean;
+}
+/**
+ * 内存后端接口。
+ *
+ * ## 同步与异步
+ * 方法返回 `MaybePromise<T>`：同步后端（`capabilities.sync === true`）直接返回值，
+ * 异步后端返回 Promise。调用方一律可以 `await`，对两种后端都正确。
+ *
+ * ## 约定
+ *   - 所有地址用 `bigint`（64 位语义），后端负责按目标进程位数处理；
+ *   - 读内存失败（部分或全部）不抛错，返回实际读到的字节（长度可能小于请求）；
+ *   - 写内存/分配/改保护失败必须抛错（这些操作静默失败会写坏目标）；
+ *   - 句柄用 `BackendProcessHandle` 封装，关闭后所有操作应抛错。
+ */
+export interface MemoryBackend {
+    /** 后端名称，用于日志与错误信息 */
+    readonly name: string;
+    /** 能力声明 */
+    readonly capabilities: BackendCapabilities;
+    /** 枚举进程。不支持时抛错（调用前应检查 capabilities） */
+    listProcesses(): MaybePromise<BackendProcessInfo[]>;
+    /** 打开进程，返回句柄 */
+    openProcess(pid: number): MaybePromise<BackendProcessHandle>;
+    /** 关闭句柄 */
+    closeProcess(handle: BackendProcessHandle): MaybePromise<void>;
+    /** 枚举内存区域 */
+    queryRegions(handle: BackendProcessHandle, filter?: BackendRegionFilter): MaybePromise<BackendRegion[]>;
+    /**
+     * 读取内存。失败时返回空 Buffer 或比请求更短的 Buffer，不抛错。
+     * @param address 起始地址
+     * @param size 请求字节数
+     */
+    readProcessMemory(handle: BackendProcessHandle, address: bigint, size: number): MaybePromise<Buffer>;
+    /**
+     * 写入内存。返回实际写入字节数；失败抛错。
+     * @param fixProtection 是否在写入前临时放开只读保护（本地后端支持）
+     */
+    writeProcessMemory(handle: BackendProcessHandle, address: bigint, data: Buffer, fixProtection?: boolean): MaybePromise<number>;
+    /** 枚举模块。不支持时抛出明确错误 */
+    queryModules(handle: BackendProcessHandle): MaybePromise<BackendModuleInfo[]>;
+    /** 枚举线程 id。不支持时抛出明确错误 */
+    queryThreads(handle: BackendProcessHandle): MaybePromise<number[]>;
+    /** 在目标进程内分配内存，返回地址。不支持时抛出明确错误 */
+    allocate(handle: BackendProcessHandle, size: number, protect?: number, preferred?: bigint): MaybePromise<bigint>;
+    /** 释放内存 */
+    free(handle: BackendProcessHandle, address: bigint): MaybePromise<void>;
+    /** 修改内存保护，返回旧保护值 */
+    changeProtection(handle: BackendProcessHandle, address: bigint, size: number, newProtect: number): MaybePromise<number>;
+    /** 目标是否为 32 位（WOW64）。不确定时返回 false */
+    isWow64(handle: BackendProcessHandle): MaybePromise<boolean>;
+    /** 释放后端自身资源（不关闭已打开的进程句柄） */
+    dispose?(): MaybePromise<void>;
+}
+/** 后端不支持某能力时抛出的错误 */
+export declare class BackendUnsupportedError extends Error {
+    readonly backend: string;
+    readonly operation: string;
+    constructor(backend: string, operation: string, detail?: string);
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/types/backend/types.d.ts.map

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

package/dist/types/cheattable/ct-format.d.ts

@@ -0,0 +1,100 @@
+/**
+ * Cheat Table (.CT) 读写 —— 对齐 Cheat Engine 的 XML 表格式。
+ *
+ * 元素与属性名严格对齐 `MemoryRecordUnit.pas` / `addresslist.pas` 的写出逻辑：
+ *
+ * ```xml
+ * <?xml version="1.0" encoding="utf-8"?>
+ * <CheatTable CheatEngineTableVersion="46">
+ *   <CheatEntries>
+ *     <CheatEntry>
+ *       <ID>1</ID>
+ *       <Description>"生命值"</Description>
+ *       <VariableType>4 Bytes</VariableType>
+ *       <Address>"game.exe"+0012AB34</Address>
+ *       <Offsets><Offset>10</Offset><Offset>8</Offset></Offsets>
+ *       <LastState Value="1000" RealAddress="7FF6..."/>
+ *       <ShowAsHex>1</ShowAsHex>
+ *       <Color>FF0000</Color>
+ *       <CheatEntries> ... 子条目 ... </CheatEntries>
+ *     </CheatEntry>
+ *   </CheatEntries>
+ * </CheatTable>
+ * ```
+ *
+ * 关键映射（来自 CEFuncProc.VariableTypeToString / StringToVariableType）：
+ *   Byte→'Byte'、Word→'2 Bytes'、DWord→'4 Bytes'、QWord→'8 Bytes'、
+ *   Single→'Float'、Double→'Double'、String→'String'、UnicodeString→'Unicode String'、
+ *   ByteArray→'Array of byte'、Binary→'Binary'、All→'All'、Pointer→'Pointer'、
+ *   AutoAssembler→'Auto Assembler Script'、Custom→'Custom'
+ *
+ * 关于 XML 解析：这里用自写的轻量解析器而不是 DOMParser，
+ * 目的是**保留原始元素顺序与未知元素**，从而做到"读进来再写出去不丢信息"
+ * （CE 表里存在大量本移植不关心的元素，例如 Hotkeys、Color、DropDownList）。
+ * 未知元素统一收进 MemoryRecordData.extra，写回时原样附着。
+ */
+import { AddressList, MemoryRecord, MemoryRecordData } from '../addresslist/memory-record';
+import { VariableType } from '../types';
+/** 变量类型 → CE 表里的字符串 */
+export declare function variableTypeToString(type: VariableType): string;
+/** CE 表里的字符串 → 变量类型（未知时按 CE 一样回落到 Byte） */
+export declare function stringToVariableType(s: string): VariableType;
+interface XmlElement {
+    kind: 'element';
+    name: string;
+    attributes: Record<string, string>;
+    children: XmlNode[];
+    /** 直接文本内容（拼接所有文本子节点，已 trim） */
+    text: string;
+}
+interface XmlText {
+    kind: 'text';
+    value: string;
+}
+type XmlNode = XmlElement | XmlText;
+/** 解析 XML 为元素树（保留顺序与未知元素）。 */
+export declare function parseXml(source: string): XmlElement;
+export interface ParsedCheatTable {
+    version: number;
+    comment: string;
+    records: MemoryRecordData[];
+    /** 用户自定义符号（<UserdefinedSymbols>） */
+    symbols: Array<{
+        name: string;
+        address: string;
+    }>;
+    /** 原始根元素属性，便于往返保留 */
+    rootAttributes: Record<string, string>;
+}
+/**
+ * 解析 .CT 内容为地址表数据。
+ */
+export declare function parseCheatTable(xml: string): ParsedCheatTable;
+export interface WriteCheatTableOptions {
+    /** CheatEngineTableVersion 属性值，默认 46（CE 6.x/7.x 常见值） */
+    version?: number;
+    /** 表注释 */
+    comment?: string;
+    /** 是否写入 <LastState>（默认写入当前值，便于 CE 打开时直接显示） */
+    includeLastState?: boolean;
+    /** 用户自定义符号 */
+    symbols?: Array<{
+        name: string;
+        address: string;
+    }>;
+}
+/**
+ * 把地址表序列化为 .CT 内容。
+ *
+ * @param list 地址表；若为纯数据数组也可直接传
+ */
+export declare function writeCheatTable(list: AddressList | MemoryRecord[] | MemoryRecordData[], options?: WriteCheatTableOptions): string;
+/** 从 .CT 文本构建 AddressList（不改动传入的 XML） */
+export declare function loadCheatTable(xml: string, process?: Parameters<typeof AddressList.prototype.attachProcess>[0]): {
+    list: AddressList;
+    parsed: ParsedCheatTable;
+};
+/** 把地址表写回 .CT 文本 */
+export declare function saveCheatTable(list: AddressList, options?: WriteCheatTableOptions): string;
+export {};
+//# sourceMappingURL=ct-format.d.ts.map

package/dist/types/cheattable/ct-format.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ct-format.d.ts","sourceRoot":"","sources":["../../../src/cheattable/ct-format.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAkCG;AAEH,OAAO,EACL,WAAW,EACX,YAAY,EACZ,gBAAgB,EACjB,MAAM,8BAA8B,CAAC;AACtC,OAAO,EAAE,YAAY,EAAE,MAAM,UAAU,CAAC;AA4CxC,uBAAuB;AACvB,wBAAgB,oBAAoB,CAAC,IAAI,EAAE,YAAY,GAAG,MAAM,CAE/D;AAED,2CAA2C;AAC3C,wBAAgB,oBAAoB,CAAC,CAAC,EAAE,MAAM,GAAG,YAAY,CAG5D;AAMD,UAAU,UAAU;IAClB,IAAI,EAAE,SAAS,CAAC;IAChB,IAAI,EAAE,MAAM,CAAC;IACb,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACnC,QAAQ,EAAE,OAAO,EAAE,CAAC;IACpB,+BAA+B;IAC/B,IAAI,EAAE,MAAM,CAAC;CACd;AAED,UAAU,OAAO;IACf,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,MAAM,CAAC;CACf;AAED,KAAK,OAAO,GAAG,UAAU,GAAG,OAAO,CAAC;AAEpC,8BAA8B;AAC9B,wBAAgB,QAAQ,CAAC,MAAM,EAAE,MAAM,GAAG,UAAU,CAqGnD;AA8CD,MAAM,WAAW,gBAAgB;IAC/B,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,EAAE,gBAAgB,EAAE,CAAC;IAC5B,oCAAoC;IACpC,OAAO,EAAE,KAAK,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IAClD,qBAAqB;IACrB,cAAc,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CACxC;AAED;;GAEG;AACH,wBAAgB,eAAe,CAAC,GAAG,EAAE,MAAM,GAAG,gBAAgB,CA+B7D;AAiID,MAAM,WAAW,sBAAsB;IACrC,wDAAwD;IACxD,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,UAAU;IACV,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,8CAA8C;IAC9C,gBAAgB,CAAC,EAAE,OAAO,CAAC;IAC3B,cAAc;IACd,OAAO,CAAC,EAAE,KAAK,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;CACpD;AA0BD;;;;GAIG;AACH,wBAAgB,eAAe,CAC7B,IAAI,EAAE,WAAW,GAAG,YAAY,EAAE,GAAG,gBAAgB,EAAE,EACvD,OAAO,GAAE,sBAA2B,GACnC,MAAM,CAwCR;AAyED,yCAAyC;AACzC,wBAAgB,cAAc,CAC5B,GAAG,EAAE,MAAM,EACX,OAAO,CAAC,EAAE,UAAU,CAAC,OAAO,WAAW,CAAC,SAAS,CAAC,aAAa,CAAC,CAAC,CAAC,CAAC,GAClE;IAAE,IAAI,EAAE,WAAW,CAAC;IAAC,MAAM,EAAE,gBAAgB,CAAA;CAAE,CAQjD;AAED,oBAAoB;AACpB,wBAAgB,cAAc,CAC5B,IAAI,EAAE,WAAW,EACjB,OAAO,GAAE,sBAA2B,GACnC,MAAM,CAWR"}

package/dist/types/index.d.ts

@@ -0,0 +1,54 @@
+/**
+ * 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 语义需要独立移植）
+ */
+export { VariableType, ScanOption, RoundingType, ScanType, PointerType, FastScanMethod, VARIABLE_TYPE_NAMES, VARIABLE_TYPE_SIZES, SCAN_OPTION_NAMES, MEM_COMMIT, MEM_RESERVE, MEM_FREE, MEM_PRIVATE, MEM_MAPPED, MEM_IMAGE, PAGE_NOACCESS, PAGE_READONLY, PAGE_READWRITE, PAGE_WRITECOPY, PAGE_EXECUTE, PAGE_EXECUTE_READ, PAGE_EXECUTE_READWRITE, PAGE_EXECUTE_WRITECOPY, PAGE_GUARD, PROCESS_VM_READ, PROCESS_VM_WRITE, PROCESS_VM_OPERATION, PROCESS_QUERY_INFORMATION, DEFAULT_PROCESS_ACCESS, } from './types';
+export type { ScanConfig, ScanResult, ScanProgressCallback, MemoryRegion, GroupElement, PointerTypes, AccessRights, } from './types';
+export { roundTo, parseIntegerLiteral, parseFloatLiteral, decimalsOf, parseAob, parseBinaryPattern, buildFloatCompareParams, singleMatches, doubleMatches, aobMatchesAt, aobHasNibbleWildcard, } from './value-codec';
+export type { ParsedNumber, FloatCompareParams, PatternByte, BinaryPattern } from './value-codec';
+export type { MemoryBackend, BackendCapabilities, BackendProcessHandle, BackendProcessInfo, BackendRegion, BackendRegionFilter, BackendModuleInfo, } from './backend/types';
+export { BackendUnsupportedError } from './backend/types';
+export { SelfBackend, filterScanRegions } from './backend/self-backend';
+export type { SelfBackendOptions } from './backend/self-backend';
+export { NativeCeBackend, CeServerConnection, CeWriter, CeReader, CESERVER_CMD, CESERVER_DEFAULT_PORT, } from './backend/native-ce-backend';
+export type { NativeCeBackendOptions } from './backend/native-ce-backend';
+export { DbkBackend, DbkDeviceError, DBK_IOCTL, DBK_READ_INPUT_SIZE, DBK_WRITE_INPUT_SIZE, DBK_WRITE_BUFFER_SIZE, DBK_MAX_WRITE_PAYLOAD, DBK_MAX_READ_CHUNK, DBK_ALLOC_INPUT_SIZE, DEFAULT_DBK_SERVICE_NAME, packReadInput, packWriteBuffer, packAllocInput, readAllocResult, resolveDevicePath, readServiceNameFromDriverDat, } from './backend/dbk-backend';
+export type { DbkBackendOptions } from './backend/dbk-backend';
+export { Process, ProcessOpenError, listProcesses, findProcessesByName, enumerateRegions, selectScannableRegions, isReadable, isWritable, isExecutable, getDefaultBackend, setDefaultBackend, regionTypeName, openProcessAsync, openProcessByNameAsync, listProcessesAsync, findProcessesByNameAsync, } from './win/process';
+export type { ProcessInfo, ProcessModule, RegionFilter, OpenProcessOptions } from './win/process';
+export { win32ErrorMessage } from './win/winapi';
+export { ScanSession } from './scanner/scanner';
+export type { ScanSessionOptions, ScanStats, Chunk } from './scanner/scanner';
+export { compileConfig, scanBlock, optionNeedsOldValue } from './scanner/matcher';
+export type { CompiledConfig } from './scanner/matcher';
+export { PointerScanner, formatPointerPath, applyPointerPath } from './scanner/pointer-scan';
+export type { PointerPath, PointerScanOptions, PointerScanStats } from './scanner/pointer-scan';
+export { compileExpression, evaluateExpression, resolveAddress, CompiledAddress, ExpressionError } from './addr/expression';
+export type { EvalContext, ExprNode } from './addr/expression';
+export { AddressList, MemoryRecord, addScanResults, buildRecordsFromScan } from './addresslist/memory-record';
+export type { MemoryRecordData, RecordEvaluation } from './addresslist/memory-record';
+export { parseCheatTable, writeCheatTable, loadCheatTable, saveCheatTable, variableTypeToString, stringToVariableType, } from './cheattable/ct-format';
+export type { ParsedCheatTable, WriteCheatTableOptions } from './cheattable/ct-format';
+export { LuaEngine, LuaScriptError, LuaError, LuaMarshal } from './lua/bridge';
+export type { LuaValue, LuaEngineOptions } from './lua/types';
+export type { ApiFunction } from './lua/api';
+export { ensureAsmBackend, isAsmBackendReady, resetAsmBackendForTests, isArchitectureSupported, architectureInfo, normalizeArchitecture, archFromBitness, disassembleRaw, assembleRaw, instructionNameOf, backendVersions, toSafeNumberAddress, AsmBackendError, } from './asm/backend';
+export type { AsmArchitecture, AsmEndianness, ArchitectureInfo, RawInstruction, RawAssembleResult, DisassembleRawOptions, AssembleRawOptions, } from './asm/backend';
+export { disassemble, disassembleOne, disassembleAt, formatDisassembled, splitDisassembledString, formatBytes, branchTarget, instructionText, DisasmValueType, } from './asm/disassembler';
+export type { DisassembledInstruction, DisassembleOptions } from './asm/disassembler';
+export { assemble, assembleLines, assembleToBytes, AssemblerError } from './asm/assembler';
+export type { AssembleOptions, AssembleResult, AssembledLine, } from './asm/assembler';
+export { AutoAssembler, AutoAssemblerError, autoAssemble } from './asm/autoassembler';
+export type { AutoAssemblerOptions, AutoAssembleResult, AutoAssemblerEntry, AutoAssemblerAllocation, AutoAssemblerLineInfo, AutoAssemblerPhase, AobScanRecord, RestoreMode, SourceLine, AsmLine, } from './asm/autoassembler';
+export { parseCeInteger, splitDirectiveArguments, encodeDataDirective, encodeNop, encodeAlign, parsePseudoDirective, patternToDbArguments, bytesToDbArguments, } from './asm/autoassembler-directives';
+export type { DataDirectiveKind, PseudoDirectiveKind, ParsedPseudoDirective, } from './asm/autoassembler-directives';
+//# sourceMappingURL=index.d.ts.map

package/dist/types/index.d.ts.map

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