@cheatron/nthread 1.0.0

package/dist/memory/alloc-options.d.ts

@@ -0,0 +1,23 @@
+import type * as Native from '@cheatron/native';
+/** Options for ProxyThread.alloc(). */
+export interface AllocOptions {
+    /**
+     * Fill byte applied after allocation.
+     * - `undefined` → no explicit fill
+     * - `0`         → zero fill (uses `calloc` for raw malloc fallback; explicit memset for heap)
+     * - `N`         → fill entire block with `N & 0xff`
+     */
+    fill?: number;
+    /**
+     * Allocate from the romem-tracked readonly zone of the heap.
+     * Default: `false` (readwrite zone). Ignored when falling back to raw malloc.
+     */
+    readonly?: boolean;
+    /**
+     * If provided, realloc mode: resize this existing allocation to `size` bytes.
+     * - Heap-backed: allocate new block → copy old data → free old block.
+     * - malloc-backed (or unknown): delegates to `msvcrt!realloc`.
+     */
+    address?: Native.NativePointer;
+}
+//# sourceMappingURL=alloc-options.d.ts.map

package/dist/memory/alloc-options.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"alloc-options.d.ts","sourceRoot":"","sources":["../../src/memory/alloc-options.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,KAAK,MAAM,MAAM,kBAAkB,CAAC;AAEhD,uCAAuC;AACvC,MAAM,WAAW,YAAY;IAC3B;;;;;OAKG;IACH,IAAI,CAAC,EAAE,MAAM,CAAC;IAEd;;;OAGG;IACH,QAAQ,CAAC,EAAE,OAAO,CAAC;IAEnB;;;;OAIG;IACH,OAAO,CAAC,EAAE,MAAM,CAAC,aAAa,CAAC;CAChC"}

package/dist/memory/alloc-options.js

@@ -0,0 +1 @@
+//# sourceMappingURL=alloc-options.js.map

package/dist/memory/alloc-options.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"alloc-options.js","sourceRoot":"","sources":["../../src/memory/alloc-options.ts"],"names":[],"mappings":""}

package/dist/memory/heap.d.ts

@@ -0,0 +1,147 @@
+import * as Native from '@cheatron/native';
+import type { ProxyThread } from '../thread/proxy-thread.js';
+import { type ReadOnlyMemory } from './romem.js';
+/** Default total heap size (bytes) */
+export declare const DEFAULT_HEAP_SIZE = 16384;
+/** Result of a heap allocation — pointer into the pre-allocated region */
+export interface HeapAlloc {
+    /** Remote address in the target process */
+    readonly remote: Native.NativePointer;
+    /** Size of this allocation */
+    readonly size: number;
+}
+/**
+ * A lightweight allocator that pre-allocates a single contiguous block
+ * in the target process and carves out sub-allocations from it.
+ *
+ * The block is split into two zones:
+ * - **Readonly zone** (first half): registered as romem — writes automatically
+ *   skip unchanged bytes via snapshot diffing.
+ * - **ReadWrite zone** (second half): standard memory — no snapshot tracking.
+ *
+ * Supports `free()` — freed blocks are returned to a per-zone free list
+ * with automatic coalescing of adjacent blocks. New allocations check the
+ * free list first (first-fit), then fall back to bumping.
+ *
+ * ```
+ * ┌──────────────────────────────────────────┐
+ * │  base                                    │
+ * │  ├── readonly zone (roSize bytes)        │
+ * │  │   ├── alloc 1                         │
+ * │  │   ├── [freed → free list]             │
+ * │  │   ├── alloc 3                         │
+ * │  │   └── ... (bump / reuse →)            │
+ * │  ├── readwrite zone (rwSize bytes)       │
+ * │  │   ├── alloc 1                         │
+ * │  │   ├── [freed → free list]             │
+ * │  │   └── ... (bump / reuse →)            │
+ * └──────────────────────────────────────────┘
+ * ```
+ */
+export declare class Heap {
+    /** Base remote address of the entire heap block */
+    readonly base: Native.NativePointer;
+    /** Total size of the heap */
+    readonly totalSize: number;
+    /** Size of the readonly zone */
+    readonly roSize: number;
+    /** Size of the readwrite zone */
+    readonly rwSize: number;
+    /** The romem handle for the readonly zone */
+    readonly romem: ReadOnlyMemory;
+    /** Current bump offset within the readonly zone */
+    private roOffset;
+    /** Current bump offset within the readwrite zone */
+    private rwOffset;
+    /** Free list for the readonly zone (sorted by offset) */
+    private roFreeList;
+    /** Free list for the readwrite zone (sorted by offset) */
+    private rwFreeList;
+    private constructor();
+    /**
+     * Creates a new Heap by allocating a single contiguous block in the target
+     * process via `calloc`. The block is zero-initialized.
+     *
+     * @param proxy The proxy thread to execute calloc on.
+     * @param totalSize Total heap size in bytes (default: 16384).
+     * @param roSize Size of the readonly zone (default: half of totalSize).
+     * @returns A ready-to-use Heap instance.
+     */
+    static create(proxy: ProxyThread, totalSize?: number, roSize?: number): Promise<Heap>;
+    /** Remote address where the readwrite zone starts */
+    get rwBase(): Native.NativePointer;
+    /** Remaining bytes in the readonly zone (bump area only, excludes free list) */
+    get roRemaining(): number;
+    /** Remaining bytes in the readwrite zone (bump area only, excludes free list) */
+    get rwRemaining(): number;
+    /**
+     * Total available bytes in the readonly zone (bump + free list).
+     */
+    get roAvailable(): number;
+    /**
+     * Total available bytes in the readwrite zone (bump + free list).
+     */
+    get rwAvailable(): number;
+    /**
+     * First-fit search on a free list. Returns the index of the matching block,
+     * or -1 if none found.
+     */
+    private static findFreeBlock;
+    /**
+     * Allocates from a free list block. If the block is larger than needed,
+     * the remainder is kept in the free list.
+     */
+    private static splitFreeBlock;
+    /**
+     * Inserts a freed block into the free list (sorted by offset)
+     * and merges with adjacent blocks.
+     */
+    private static insertAndCoalesce;
+    /**
+     * Allocates from the readonly zone.
+     * Checks the free list first (first-fit), then falls back to bumping.
+     *
+     * The returned pointer is inside the romem-registered region —
+     * writes to it will benefit from snapshot-based skip optimization.
+     *
+     * @param size Number of bytes to allocate.
+     * @returns HeapAlloc with the remote pointer and size.
+     * @throws If the readonly zone doesn't have enough space.
+     */
+    allocReadonly(size: number): HeapAlloc;
+    /**
+     * Allocates from the readwrite zone.
+     * Checks the free list first (first-fit), then falls back to bumping.
+     *
+     * Standard memory — no romem tracking.
+     *
+     * @param size Number of bytes to allocate.
+     * @returns HeapAlloc with the remote pointer and size.
+     * @throws If the readwrite zone doesn't have enough space.
+     */
+    alloc(size: number): HeapAlloc;
+    /**
+     * Frees a previously allocated block, returning it to the appropriate
+     * zone's free list. Adjacent free blocks are automatically coalesced.
+     *
+     * Does NOT zero the remote memory. The romem snapshot for readonly
+     * allocations remains unchanged (will be updated on next write).
+     *
+     * @param alloc The HeapAlloc returned by alloc() or allocReadonly().
+     * @throws If the allocation doesn't belong to this heap.
+     */
+    free(alloc: HeapAlloc): void;
+    /**
+     * Resets both zones — clears free lists and bump pointers.
+     * Does NOT zero out the remote memory — call memset separately if needed.
+     * The romem snapshot (local buffer) is also reset to all zeroes.
+     */
+    reset(): void;
+    /**
+     * Frees the entire heap block in the target process and unregisters the romem.
+     *
+     * @param proxy The proxy thread to execute free on.
+     */
+    destroy(proxy: ProxyThread): Promise<void>;
+}
+//# sourceMappingURL=heap.d.ts.map

package/dist/memory/heap.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"heap.d.ts","sourceRoot":"","sources":["../../src/memory/heap.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,MAAM,MAAM,kBAAkB,CAAC;AAC3C,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,2BAA2B,CAAC;AAC7D,OAAO,EAGL,KAAK,cAAc,EACpB,MAAM,YAAY,CAAC;AAGpB,sCAAsC;AACtC,eAAO,MAAM,iBAAiB,QAAQ,CAAC;AAEvC,0EAA0E;AAC1E,MAAM,WAAW,SAAS;IACxB,2CAA2C;IAC3C,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC,aAAa,CAAC;IACtC,8BAA8B;IAC9B,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;CACvB;AAUD;;;;;;;;;;;;;;;;;;;;;;;;;;;GA2BG;AACH,qBAAa,IAAI;IACf,mDAAmD;IACnD,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC,aAAa,CAAC;IACpC,6BAA6B;IAC7B,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,gCAAgC;IAChC,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,iCAAiC;IACjC,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IAExB,6CAA6C;IAC7C,QAAQ,CAAC,KAAK,EAAE,cAAc,CAAC;IAE/B,mDAAmD;IACnD,OAAO,CAAC,QAAQ,CAAK;IACrB,oDAAoD;IACpD,OAAO,CAAC,QAAQ,CAAK;IAErB,yDAAyD;IACzD,OAAO,CAAC,UAAU,CAAmB;IACrC,0DAA0D;IAC1D,OAAO,CAAC,UAAU,CAAmB;IAErC,OAAO;IAcP;;;;;;;;OAQG;WACU,MAAM,CACjB,KAAK,EAAE,WAAW,EAClB,SAAS,GAAE,MAA0B,EACrC,MAAM,CAAC,EAAE,MAAM,GACd,OAAO,CAAC,IAAI,CAAC;IAuBhB,qDAAqD;IACrD,IAAI,MAAM,IAAI,MAAM,CAAC,aAAa,CAEjC;IAED,gFAAgF;IAChF,IAAI,WAAW,IAAI,MAAM,CAExB;IAED,iFAAiF;IACjF,IAAI,WAAW,IAAI,MAAM,CAExB;IAED;;OAEG;IACH,IAAI,WAAW,IAAI,MAAM,CAIxB;IAED;;OAEG;IACH,IAAI,WAAW,IAAI,MAAM,CAIxB;IAED;;;OAGG;IACH,OAAO,CAAC,MAAM,CAAC,aAAa;IAO5B;;;OAGG;IACH,OAAO,CAAC,MAAM,CAAC,cAAc;IAmB7B;;;OAGG;IACH,OAAO,CAAC,MAAM,CAAC,iBAAiB;IAqChC;;;;;;;;;;OAUG;IACH,aAAa,CAAC,IAAI,EAAE,MAAM,GAAG,SAAS;IA2BtC;;;;;;;;;OASG;IACH,KAAK,CAAC,IAAI,EAAE,MAAM,GAAG,SAAS;IAyB9B;;;;;;;;;OASG;IACH,IAAI,CAAC,KAAK,EAAE,SAAS,GAAG,IAAI;IAqB5B;;;;OAIG;IACH,KAAK,IAAI,IAAI;IAQb;;;;OAIG;IACG,OAAO,CAAC,KAAK,EAAE,WAAW,GAAG,OAAO,CAAC,IAAI,CAAC;CAIjD"}

package/dist/memory/heap.js

@@ -0,0 +1,276 @@
+import * as Native from '@cheatron/native';
+import { registerReadOnlyMemory, unregisterReadOnlyMemory, } from './romem.js';
+import { crt } from '../crt.js';
+/** Default total heap size (bytes) */
+export const DEFAULT_HEAP_SIZE = 16384;
+/**
+ * A lightweight allocator that pre-allocates a single contiguous block
+ * in the target process and carves out sub-allocations from it.
+ *
+ * The block is split into two zones:
+ * - **Readonly zone** (first half): registered as romem — writes automatically
+ *   skip unchanged bytes via snapshot diffing.
+ * - **ReadWrite zone** (second half): standard memory — no snapshot tracking.
+ *
+ * Supports `free()` — freed blocks are returned to a per-zone free list
+ * with automatic coalescing of adjacent blocks. New allocations check the
+ * free list first (first-fit), then fall back to bumping.
+ *
+ * ```
+ * ┌──────────────────────────────────────────┐
+ * │  base                                    │
+ * │  ├── readonly zone (roSize bytes)        │
+ * │  │   ├── alloc 1                         │
+ * │  │   ├── [freed → free list]             │
+ * │  │   ├── alloc 3                         │
+ * │  │   └── ... (bump / reuse →)            │
+ * │  ├── readwrite zone (rwSize bytes)       │
+ * │  │   ├── alloc 1                         │
+ * │  │   ├── [freed → free list]             │
+ * │  │   └── ... (bump / reuse →)            │
+ * └──────────────────────────────────────────┘
+ * ```
+ */
+export class Heap {
+    /** Base remote address of the entire heap block */
+    base;
+    /** Total size of the heap */
+    totalSize;
+    /** Size of the readonly zone */
+    roSize;
+    /** Size of the readwrite zone */
+    rwSize;
+    /** The romem handle for the readonly zone */
+    romem;
+    /** Current bump offset within the readonly zone */
+    roOffset = 0;
+    /** Current bump offset within the readwrite zone */
+    rwOffset = 0;
+    /** Free list for the readonly zone (sorted by offset) */
+    roFreeList = [];
+    /** Free list for the readwrite zone (sorted by offset) */
+    rwFreeList = [];
+    constructor(base, totalSize, roSize, rwSize, romem) {
+        this.base = base;
+        this.totalSize = totalSize;
+        this.roSize = roSize;
+        this.rwSize = rwSize;
+        this.romem = romem;
+    }
+    /**
+     * Creates a new Heap by allocating a single contiguous block in the target
+     * process via `calloc`. The block is zero-initialized.
+     *
+     * @param proxy The proxy thread to execute calloc on.
+     * @param totalSize Total heap size in bytes (default: 16384).
+     * @param roSize Size of the readonly zone (default: half of totalSize).
+     * @returns A ready-to-use Heap instance.
+     */
+    static async create(proxy, totalSize = DEFAULT_HEAP_SIZE, roSize) {
+        const actualRoSize = roSize ?? Math.floor(totalSize / 2);
+        const rwSize = totalSize - actualRoSize;
+        if (actualRoSize < 0 || rwSize < 0) {
+            throw new Error(`Invalid heap sizes: roSize=${actualRoSize}, rwSize=${rwSize}`);
+        }
+        const base = await proxy.call(crt.calloc, 1, totalSize);
+        if (base.address === 0n) {
+            throw new Error(`calloc(1, ${totalSize}) returned NULL`);
+        }
+        // Register the readonly zone as romem for snapshot-based write optimization
+        const roRemote = base;
+        const roLocal = Buffer.alloc(actualRoSize); // zero-filled — matches calloc
+        const romem = registerReadOnlyMemory(roRemote, roLocal);
+        return new Heap(base, totalSize, actualRoSize, rwSize, romem);
+    }
+    /** Remote address where the readwrite zone starts */
+    get rwBase() {
+        return new Native.NativePointer(this.base.address + BigInt(this.roSize));
+    }
+    /** Remaining bytes in the readonly zone (bump area only, excludes free list) */
+    get roRemaining() {
+        return this.roSize - this.roOffset;
+    }
+    /** Remaining bytes in the readwrite zone (bump area only, excludes free list) */
+    get rwRemaining() {
+        return this.rwSize - this.rwOffset;
+    }
+    /**
+     * Total available bytes in the readonly zone (bump + free list).
+     */
+    get roAvailable() {
+        return (this.roRemaining + this.roFreeList.reduce((sum, b) => sum + b.size, 0));
+    }
+    /**
+     * Total available bytes in the readwrite zone (bump + free list).
+     */
+    get rwAvailable() {
+        return (this.rwRemaining + this.rwFreeList.reduce((sum, b) => sum + b.size, 0));
+    }
+    /**
+     * First-fit search on a free list. Returns the index of the matching block,
+     * or -1 if none found.
+     */
+    static findFreeBlock(freeList, size) {
+        for (let i = 0; i < freeList.length; i++) {
+            if (freeList[i].size >= size)
+                return i;
+        }
+        return -1;
+    }
+    /**
+     * Allocates from a free list block. If the block is larger than needed,
+     * the remainder is kept in the free list.
+     */
+    static splitFreeBlock(freeList, index, size) {
+        const block = freeList[index];
+        const offset = block.offset;
+        const remainder = block.size - size;
+        if (remainder > 0) {
+            block.offset += size;
+            block.size = remainder;
+        }
+        else {
+            freeList.splice(index, 1);
+        }
+        return offset;
+    }
+    /**
+     * Inserts a freed block into the free list (sorted by offset)
+     * and merges with adjacent blocks.
+     */
+    static insertAndCoalesce(freeList, offset, size) {
+        // Find insertion point (keep sorted by offset)
+        let insertIdx = 0;
+        while (insertIdx < freeList.length &&
+            freeList[insertIdx].offset < offset) {
+            insertIdx++;
+        }
+        freeList.splice(insertIdx, 0, { offset, size });
+        // Merge with next block
+        if (insertIdx + 1 < freeList.length) {
+            const curr = freeList[insertIdx];
+            const next = freeList[insertIdx + 1];
+            if (curr.offset + curr.size === next.offset) {
+                curr.size += next.size;
+                freeList.splice(insertIdx + 1, 1);
+            }
+        }
+        // Merge with previous block
+        if (insertIdx > 0) {
+            const prev = freeList[insertIdx - 1];
+            const curr = freeList[insertIdx];
+            if (prev.offset + prev.size === curr.offset) {
+                prev.size += curr.size;
+                freeList.splice(insertIdx, 1);
+            }
+        }
+    }
+    /**
+     * Allocates from the readonly zone.
+     * Checks the free list first (first-fit), then falls back to bumping.
+     *
+     * The returned pointer is inside the romem-registered region —
+     * writes to it will benefit from snapshot-based skip optimization.
+     *
+     * @param size Number of bytes to allocate.
+     * @returns HeapAlloc with the remote pointer and size.
+     * @throws If the readonly zone doesn't have enough space.
+     */
+    allocReadonly(size) {
+        if (size <= 0)
+            throw new Error(`Invalid alloc size: ${size}`);
+        // Try free list first
+        const freeIdx = Heap.findFreeBlock(this.roFreeList, size);
+        if (freeIdx !== -1) {
+            const offset = Heap.splitFreeBlock(this.roFreeList, freeIdx, size);
+            const remote = new Native.NativePointer(this.base.address + BigInt(offset));
+            return { remote, size };
+        }
+        // Bump allocate
+        if (this.roOffset + size > this.roSize) {
+            throw new Error(`Readonly zone exhausted: requested ${size}, available ${this.roAvailable}`);
+        }
+        const remote = new Native.NativePointer(this.base.address + BigInt(this.roOffset));
+        this.roOffset += size;
+        return { remote, size };
+    }
+    /**
+     * Allocates from the readwrite zone.
+     * Checks the free list first (first-fit), then falls back to bumping.
+     *
+     * Standard memory — no romem tracking.
+     *
+     * @param size Number of bytes to allocate.
+     * @returns HeapAlloc with the remote pointer and size.
+     * @throws If the readwrite zone doesn't have enough space.
+     */
+    alloc(size) {
+        if (size <= 0)
+            throw new Error(`Invalid alloc size: ${size}`);
+        // Try free list first
+        const freeIdx = Heap.findFreeBlock(this.rwFreeList, size);
+        if (freeIdx !== -1) {
+            const offset = Heap.splitFreeBlock(this.rwFreeList, freeIdx, size);
+            const remote = new Native.NativePointer(this.base.address + BigInt(this.roSize) + BigInt(offset));
+            return { remote, size };
+        }
+        // Bump allocate
+        if (this.rwOffset + size > this.rwSize) {
+            throw new Error(`ReadWrite zone exhausted: requested ${size}, available ${this.rwAvailable}`);
+        }
+        const remote = this.base.add(BigInt(this.roSize) + BigInt(this.rwOffset));
+        this.rwOffset += size;
+        return { remote, size };
+    }
+    /**
+     * Frees a previously allocated block, returning it to the appropriate
+     * zone's free list. Adjacent free blocks are automatically coalesced.
+     *
+     * Does NOT zero the remote memory. The romem snapshot for readonly
+     * allocations remains unchanged (will be updated on next write).
+     *
+     * @param alloc The HeapAlloc returned by alloc() or allocReadonly().
+     * @throws If the allocation doesn't belong to this heap.
+     */
+    free(alloc) {
+        const addr = alloc.remote.address;
+        const baseAddr = this.base.address;
+        const roEnd = baseAddr + BigInt(this.roSize);
+        const rwEnd = roEnd + BigInt(this.rwSize);
+        if (addr >= baseAddr && addr < roEnd) {
+            // Readonly zone
+            const offset = Number(addr - baseAddr);
+            Heap.insertAndCoalesce(this.roFreeList, offset, alloc.size);
+        }
+        else if (addr >= roEnd && addr < rwEnd) {
+            // ReadWrite zone — offset relative to rw zone start
+            const offset = Number(addr - roEnd);
+            Heap.insertAndCoalesce(this.rwFreeList, offset, alloc.size);
+        }
+        else {
+            throw new Error(`Address 0x${addr.toString(16)} does not belong to this heap`);
+        }
+    }
+    /**
+     * Resets both zones — clears free lists and bump pointers.
+     * Does NOT zero out the remote memory — call memset separately if needed.
+     * The romem snapshot (local buffer) is also reset to all zeroes.
+     */
+    reset() {
+        this.roOffset = 0;
+        this.rwOffset = 0;
+        this.roFreeList.length = 0;
+        this.rwFreeList.length = 0;
+        this.romem.local.fill(0);
+    }
+    /**
+     * Frees the entire heap block in the target process and unregisters the romem.
+     *
+     * @param proxy The proxy thread to execute free on.
+     */
+    async destroy(proxy) {
+        unregisterReadOnlyMemory(this.romem);
+        await proxy.call(crt.free, this.base);
+    }
+}
+//# sourceMappingURL=heap.js.map

package/dist/memory/heap.js.map

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

package/dist/memory/romem.d.ts

@@ -0,0 +1,69 @@
+import * as Native from '@cheatron/native';
+import type { ProxyThread } from '../thread/proxy-thread.js';
+/**
+ * A read-only memory region allocated in the target process.
+ * Stores both the remote pointer and a local Buffer copy.
+ * Since we are the ones who wrote it, we always know the exact contents —
+ * this lets writeMemory skip unchanged bytes automatically.
+ */
+export interface ReadOnlyMemory {
+    /** Remote address in the target process (allocated via calloc) */
+    readonly remote: Native.NativePointer;
+    /** Local copy of the data — always mirrors what is on the remote side */
+    readonly local: Buffer;
+}
+/**
+ * Allocates a zero-initialized read-only memory region in the target process
+ * via hijacked `calloc(1, size)` and registers it for write-optimization.
+ *
+ * @param proxy The proxy thread to execute calloc on.
+ * @param size  Total byte size to allocate.
+ * @returns A ReadOnlyMemory handle.
+ */
+export declare function createReadOnlyMemory(proxy: ProxyThread, size: number): Promise<ReadOnlyMemory>;
+/**
+ * Registers an existing pointer + buffer pair as a read-only memory region.
+ * Use this when the memory was allocated through other means but you still
+ * want writeMemory to benefit from the snapshot optimization.
+ *
+ * @param remote Address in the target process.
+ * @param local  Buffer that mirrors the remote contents exactly.
+ */
+export declare function registerReadOnlyMemory(remote: Native.NativePointer, local: Buffer): ReadOnlyMemory;
+/**
+ * Removes a read-only memory region from the registry.
+ * Does NOT free the remote allocation — call `free` separately if needed.
+ */
+export declare function unregisterReadOnlyMemory(romem: ReadOnlyMemory): boolean;
+/**
+ * Checks whether a write range [destAddr, destAddr + writeLen) overlaps
+ * with any registered read-only region.
+ *
+ * Returns the overlapping region, or undefined if no overlap.
+ */
+export declare function findOverlappingRegion(destAddr: bigint, writeLen: number): ReadOnlyMemory | undefined;
+/**
+ * Extracts the local snapshot bytes for the overlapping portion of a write.
+ *
+ * Given a write to [destAddr, destAddr + writeLen) that overlaps with `romem`,
+ * returns the Buffer slice from romem.local that corresponds to the overlap region,
+ * along with the overlap boundaries relative to the write.
+ */
+export declare function getOverlapInfo(destAddr: bigint, writeLen: number, romem: ReadOnlyMemory): {
+    /** Offset within the write buffer where the overlap begins */
+    writeOffset: number;
+    /** Length of the overlapping region */
+    overlapLen: number;
+    /** The snapshot bytes from romem.local for the overlapping range */
+    snapshot: Buffer;
+};
+/**
+ * Updates the local snapshot of a read-only region after a successful write.
+ * Call this after writeMemorySafeBuffer completes to keep the snapshot current.
+ *
+ * @param romem    The read-only memory region.
+ * @param source   The data that was written.
+ * @param destAddr The remote address that was written to.
+ */
+export declare function updateSnapshot(romem: ReadOnlyMemory, source: Buffer, destAddr: bigint): void;
+//# sourceMappingURL=romem.d.ts.map

package/dist/memory/romem.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"romem.d.ts","sourceRoot":"","sources":["../../src/memory/romem.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,MAAM,MAAM,kBAAkB,CAAC;AAC3C,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,2BAA2B,CAAC;AAG7D;;;;;GAKG;AACH,MAAM,WAAW,cAAc;IAC7B,kEAAkE;IAClE,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC,aAAa,CAAC;IACtC,yEAAyE;IACzE,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;CACxB;AAKD;;;;;;;GAOG;AACH,wBAAsB,oBAAoB,CACxC,KAAK,EAAE,WAAW,EAClB,IAAI,EAAE,MAAM,GACX,OAAO,CAAC,cAAc,CAAC,CAUzB;AAED;;;;;;;GAOG;AACH,wBAAgB,sBAAsB,CACpC,MAAM,EAAE,MAAM,CAAC,aAAa,EAC5B,KAAK,EAAE,MAAM,GACZ,cAAc,CAIhB;AAED;;;GAGG;AACH,wBAAgB,wBAAwB,CAAC,KAAK,EAAE,cAAc,GAAG,OAAO,CAKvE;AAED;;;;;GAKG;AACH,wBAAgB,qBAAqB,CACnC,QAAQ,EAAE,MAAM,EAChB,QAAQ,EAAE,MAAM,GACf,cAAc,GAAG,SAAS,CAW5B;AAED;;;;;;GAMG;AACH,wBAAgB,cAAc,CAC5B,QAAQ,EAAE,MAAM,EAChB,QAAQ,EAAE,MAAM,EAChB,KAAK,EAAE,cAAc,GACpB;IACD,8DAA8D;IAC9D,WAAW,EAAE,MAAM,CAAC;IACpB,uCAAuC;IACvC,UAAU,EAAE,MAAM,CAAC;IACnB,oEAAoE;IACpE,QAAQ,EAAE,MAAM,CAAC;CAClB,CAiBA;AAED;;;;;;;GAOG;AACH,wBAAgB,cAAc,CAC5B,KAAK,EAAE,cAAc,EACrB,MAAM,EAAE,MAAM,EACd,QAAQ,EAAE,MAAM,GACf,IAAI,CAeN"}

package/dist/memory/romem.js

@@ -0,0 +1,108 @@
+import * as Native from '@cheatron/native';
+import { crt } from '../crt.js';
+/** Internal storage for all registered read-only regions */
+const regions = [];
+/**
+ * Allocates a zero-initialized read-only memory region in the target process
+ * via hijacked `calloc(1, size)` and registers it for write-optimization.
+ *
+ * @param proxy The proxy thread to execute calloc on.
+ * @param size  Total byte size to allocate.
+ * @returns A ReadOnlyMemory handle.
+ */
+export async function createReadOnlyMemory(proxy, size) {
+    const ptr = await proxy.call(crt.calloc, 1, size);
+    if (ptr.address === 0n) {
+        throw new Error(`calloc(1, ${size}) returned NULL`);
+    }
+    const local = Buffer.alloc(size); // zero-filled — matches calloc
+    const romem = { remote: ptr, local };
+    regions.push(romem);
+    return romem;
+}
+/**
+ * Registers an existing pointer + buffer pair as a read-only memory region.
+ * Use this when the memory was allocated through other means but you still
+ * want writeMemory to benefit from the snapshot optimization.
+ *
+ * @param remote Address in the target process.
+ * @param local  Buffer that mirrors the remote contents exactly.
+ */
+export function registerReadOnlyMemory(remote, local) {
+    const romem = { remote, local };
+    regions.push(romem);
+    return romem;
+}
+/**
+ * Removes a read-only memory region from the registry.
+ * Does NOT free the remote allocation — call `free` separately if needed.
+ */
+export function unregisterReadOnlyMemory(romem) {
+    const idx = regions.indexOf(romem);
+    if (idx === -1)
+        return false;
+    regions.splice(idx, 1);
+    return true;
+}
+/**
+ * Checks whether a write range [destAddr, destAddr + writeLen) overlaps
+ * with any registered read-only region.
+ *
+ * Returns the overlapping region, or undefined if no overlap.
+ */
+export function findOverlappingRegion(destAddr, writeLen) {
+    const writeEnd = destAddr + BigInt(writeLen);
+    for (const r of regions) {
+        const rStart = r.remote.address;
+        const rEnd = rStart + BigInt(r.local.length);
+        // overlap: !(writeEnd <= rStart || destAddr >= rEnd)
+        if (writeEnd > rStart && destAddr < rEnd) {
+            return r;
+        }
+    }
+    return undefined;
+}
+/**
+ * Extracts the local snapshot bytes for the overlapping portion of a write.
+ *
+ * Given a write to [destAddr, destAddr + writeLen) that overlaps with `romem`,
+ * returns the Buffer slice from romem.local that corresponds to the overlap region,
+ * along with the overlap boundaries relative to the write.
+ */
+export function getOverlapInfo(destAddr, writeLen, romem) {
+    const writeEnd = destAddr + BigInt(writeLen);
+    const rStart = romem.remote.address;
+    const rEnd = rStart + BigInt(romem.local.length);
+    const overlapStart = destAddr > rStart ? destAddr : rStart;
+    const overlapEnd = writeEnd < rEnd ? writeEnd : rEnd;
+    const overlapLen = Number(overlapEnd - overlapStart);
+    // Offset within the write buffer
+    const writeOffset = Number(overlapStart - destAddr);
+    // Offset within romem.local
+    const romemOffset = Number(overlapStart - rStart);
+    const snapshot = romem.local.subarray(romemOffset, romemOffset + overlapLen);
+    return { writeOffset, overlapLen, snapshot };
+}
+/**
+ * Updates the local snapshot of a read-only region after a successful write.
+ * Call this after writeMemorySafeBuffer completes to keep the snapshot current.
+ *
+ * @param romem    The read-only memory region.
+ * @param source   The data that was written.
+ * @param destAddr The remote address that was written to.
+ */
+export function updateSnapshot(romem, source, destAddr) {
+    const rStart = romem.remote.address;
+    const writeStart = destAddr;
+    const writeEnd = writeStart + BigInt(source.length);
+    const rEnd = rStart + BigInt(romem.local.length);
+    const overlapStart = writeStart > rStart ? writeStart : rStart;
+    const overlapEnd = writeEnd < rEnd ? writeEnd : rEnd;
+    if (overlapEnd <= overlapStart)
+        return;
+    const srcOffset = Number(overlapStart - writeStart);
+    const dstOffset = Number(overlapStart - rStart);
+    const len = Number(overlapEnd - overlapStart);
+    source.copy(romem.local, dstOffset, srcOffset, srcOffset + len);
+}
+//# sourceMappingURL=romem.js.map

package/dist/memory/romem.js.map

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