warpo 2.5.0-alpha-2 → 3.0.0

package/dist/heap_analyzer/tests/retainedSize.test.js

@@ -0,0 +1,57 @@
+import assert from "node:assert/strict";
+import { describe, it } from "node:test";
+import { BLOCK_OVERHEAD } from "../src/constants.js";
+import { buildDominatorTree, VIRTUAL_ROOT } from "../src/dominator.js";
+import { computeRetainedSizes } from "../src/retainedSize.js";
+function makeObject(payloadPtr, blockSize) {
+    return {
+        mmInfo: blockSize,
+        rtId: 1,
+        rtSize: blockSize,
+        payloadPtr,
+        gcColor: 0,
+    };
+}
+describe("computeRetainedSizes", () => {
+    it("computes retained sizes for a simple chain", () => {
+        const graph = new Map([
+            [10, [20]],
+            [20, [30]],
+            [30, []],
+        ]);
+        const domTree = buildDominatorTree(graph, new Set([10]));
+        const objects = [makeObject(10, 16), makeObject(20, 24), makeObject(30, 32)];
+        const retained = computeRetainedSizes(objects, domTree);
+        const shallow10 = BLOCK_OVERHEAD + 16;
+        const shallow20 = BLOCK_OVERHEAD + 24;
+        const shallow30 = BLOCK_OVERHEAD + 32;
+        assert.strictEqual(retained.get(30), shallow30);
+        assert.strictEqual(retained.get(20), shallow20 + shallow30);
+        assert.strictEqual(retained.get(10), shallow10 + shallow20 + shallow30);
+    });
+    it("handles a diamond where the join is dominated by the root", () => {
+        const graph = new Map([
+            [10, [20, 30]],
+            [20, [40]],
+            [30, [40]],
+            [40, []],
+        ]);
+        const domTree = buildDominatorTree(graph, new Set([10]));
+        const objects = [makeObject(10, 16), makeObject(20, 16), makeObject(30, 16), makeObject(40, 16)];
+        const retained = computeRetainedSizes(objects, domTree);
+        const shallow = BLOCK_OVERHEAD + 16;
+        assert.strictEqual(domTree.get(10), VIRTUAL_ROOT);
+        assert.strictEqual(domTree.get(20), 10);
+        assert.strictEqual(domTree.get(30), 10);
+        assert.strictEqual(domTree.get(40), 10);
+        assert.strictEqual(retained.get(20), shallow);
+        assert.strictEqual(retained.get(30), shallow);
+        assert.strictEqual(retained.get(40), shallow);
+        assert.strictEqual(retained.get(10), shallow * 4);
+    });
+    it("throws if a dominator-tree node has no matching object header", () => {
+        const domTree = new Map([[10, VIRTUAL_ROOT]]);
+        assert.throws(() => computeRetainedSizes([], domTree), /Missing object header for dominator-tree node 10/);
+    });
+});
+//# sourceMappingURL=retainedSize.test.js.map

package/dist/heap_analyzer/tests/retainedSize.test.js.map

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

package/dist/heap_analyzer/tests/roots.test.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/heap_analyzer/tests/roots.test.js

@@ -0,0 +1,71 @@
+import assert from "node:assert/strict";
+import { before, it } from "node:test";
+import { GC_COLOR_TRANSPARENT } from "../src/constants.js";
+import { parseDumpFile } from "../src/dumpReader.js";
+import { findRoots } from "../src/roots.js";
+import { walkBlocks } from "../src/tlsf.js";
+import { describeIntegration } from "./testHelper.js";
+function loadFixture(ctx) {
+    return parseDumpFile(ctx.loadFixtureDumpBuffer());
+}
+describeIntegration("findRoots", (ctx) => {
+    let dump;
+    let objects;
+    let roots;
+    before(() => {
+        ctx.compileFixture();
+        ctx.generateFixtureDump();
+        dump = loadFixture(ctx);
+        objects = walkBlocks(dump.memory, dump.rtGlobals.heapBase);
+        roots = findRoots(dump.memory, dump.rtGlobals, objects);
+    });
+    it("only reports local roots for the current fixture", () => {
+        const rootTypes = new Set(roots.map((root) => root.rootType));
+        assert.deepStrictEqual([...rootTypes].toSorted((lhs, rhs) => lhs.localeCompare(rhs)), ["local"]);
+    });
+    it("finds at least one shadow-stack root", () => {
+        const localRoots = roots.filter((root) => root.rootType === "local");
+        assert.ok(localRoots.length > 0);
+    });
+    it("all local roots come from the shadow-stack range", () => {
+        for (const root of roots) {
+            if (root.rootType !== "local") {
+                continue;
+            }
+            assert.ok(root.sourceAddress >= dump.rtGlobals.stackPointer);
+            assert.ok(root.sourceAddress < dump.rtGlobals.heapBase);
+        }
+    });
+    it("returns all transparent objects as pinned roots", () => {
+        const pinnedObjectPtrs = new Set(objects.filter((obj) => obj.gcColor === GC_COLOR_TRANSPARENT).map((obj) => obj.payloadPtr));
+        const pinnedRoots = roots.filter((root) => root.rootType === "pinned");
+        assert.strictEqual(pinnedRoots.length, pinnedObjectPtrs.size);
+        for (const root of pinnedRoots) {
+            assert.strictEqual(root.sourceAddress, 0);
+            assert.ok(pinnedObjectPtrs.has(root.objectPtr));
+        }
+    });
+    it("only reports roots that point to valid object payloads", () => {
+        const validPtrs = new Set(objects.map((obj) => obj.payloadPtr));
+        for (const root of roots) {
+            assert.ok(validPtrs.has(root.objectPtr));
+        }
+    });
+    it("does not attempt GC global-root detection yet", () => {
+        assert.strictEqual(roots.some((root) => root.rootType === "global"), false);
+    });
+});
+it("reports transparent-color objects as pinned roots", () => {
+    const memory = new DataView(new ArrayBuffer(64));
+    const objects = [
+        { mmInfo: 24, rtId: 1, rtSize: 8, payloadPtr: 16, gcColor: 0 },
+        { mmInfo: 24, rtId: 2, rtSize: 8, payloadPtr: 32, gcColor: GC_COLOR_TRANSPARENT },
+    ];
+    memory.setUint32(0, 16, true);
+    const roots = findRoots(memory, { dataEnd: 0, stackPointer: 0, heapBase: 4 }, objects);
+    const pinnedRoots = roots.filter((root) => root.rootType === "pinned");
+    const localRoots = roots.filter((root) => root.rootType === "local");
+    assert.deepStrictEqual(localRoots, [{ objectPtr: 16, className: "", rootType: "local", sourceAddress: 0 }]);
+    assert.deepStrictEqual(pinnedRoots, [{ objectPtr: 32, className: "", rootType: "pinned", sourceAddress: 0 }]);
+});
+//# sourceMappingURL=roots.test.js.map

package/dist/heap_analyzer/tests/roots.test.js.map

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

package/dist/heap_analyzer/tests/snapshot.test.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/heap_analyzer/tests/snapshot.test.js

@@ -0,0 +1,102 @@
+import assert from "node:assert/strict";
+import { before, it } from "node:test";
+import { parseDumpFile } from "../src/dumpReader.js";
+import { analyzeHeap } from "../src/snapshot.js";
+import { CLASS_PREFIX, describeIntegration } from "./testHelper.js";
+function loadFixture(ctx) {
+    return parseDumpFile(ctx.loadFixtureDumpBuffer());
+}
+describeIntegration("analyzeHeap", (ctx) => {
+    let dump;
+    let snapshot;
+    let objectCounts;
+    before(() => {
+        ctx.compileFixture();
+        ctx.generateFixtureDump();
+        dump = loadFixture(ctx);
+        snapshot = analyzeHeap(dump.memory, dump.rtGlobals, ctx.loadFixtureWasm());
+        objectCounts = new Map();
+        for (const obj of snapshot.objects) {
+            objectCounts.set(obj.className, (objectCounts.get(obj.className) ?? 0) + 1);
+        }
+    });
+    it("matches the fixture's live-object and root counts", () => {
+        assert.strictEqual(snapshot.objectCount, 89);
+        assert.strictEqual(snapshot.objects.length, 89);
+        assert.strictEqual(snapshot.roots.length, 23);
+    });
+    it("reports only local roots for the current fixture", () => {
+        const rootTypeCounts = {};
+        for (const root of snapshot.roots) {
+            rootTypeCounts[root.rootType] = (rootTypeCounts[root.rootType] ?? 0) + 1;
+        }
+        assert.deepStrictEqual(rootTypeCounts, { local: 23 });
+    });
+    it("propagates local rootType to all live objects", () => {
+        const objectRootTypeCounts = {};
+        for (const obj of snapshot.objects) {
+            objectRootTypeCounts[obj.rootType] = (objectRootTypeCounts[obj.rootType] ?? 0) + 1;
+        }
+        assert.deepStrictEqual(objectRootTypeCounts, { local: 89 });
+    });
+    it("matches expected class counts for key fixture types", () => {
+        assert.strictEqual(objectCounts.get(`${CLASS_PREFIX}TreeNode`), 31);
+        assert.strictEqual(objectCounts.get("~lib/arraybuffer/ArrayBuffer"), 18);
+        assert.strictEqual(objectCounts.get(`${CLASS_PREFIX}Item`), 10);
+        assert.strictEqual(objectCounts.get(`${CLASS_PREFIX}Vector2`), 6);
+        assert.strictEqual(objectCounts.get(`${CLASS_PREFIX}ListNode`), 5);
+        assert.strictEqual(objectCounts.get(`${CLASS_PREFIX}NPC`), 3);
+        assert.strictEqual(objectCounts.get(`${CLASS_PREFIX}Player`), 2);
+        assert.strictEqual(objectCounts.get("~lib/string/String"), 1);
+    });
+    it("keeps summary sorted by retained size and matches key summary rows", () => {
+        for (let index = 1; index < snapshot.summary.length; index++) {
+            assert.ok(snapshot.summary[index - 1].totalRetainedSize >= snapshot.summary[index].totalRetainedSize);
+        }
+        assert.deepStrictEqual(snapshot.summary[0], {
+            className: `${CLASS_PREFIX}TreeNode`,
+            classId: snapshot.summary[0].classId,
+            count: 31,
+            totalShallowSize: 992,
+            totalRetainedSize: 4128,
+        });
+        const players = snapshot.summary.find((entry) => entry.className === `${CLASS_PREFIX}Player`);
+        const npc = snapshot.summary.find((entry) => entry.className === `${CLASS_PREFIX}NPC`);
+        const strings = snapshot.summary.find((entry) => entry.className === "~lib/string/String");
+        assert.deepStrictEqual(players && {
+            count: players.count,
+            shallow: players.totalShallowSize,
+            retained: players.totalRetainedSize,
+        }, { count: 2, shallow: 96, retained: 544 });
+        assert.deepStrictEqual(npc && {
+            count: npc.count,
+            shallow: npc.totalShallowSize,
+            retained: npc.totalRetainedSize,
+        }, { count: 3, shallow: 144, retained: 240 });
+        assert.deepStrictEqual(strings && {
+            count: strings.count,
+            shallow: strings.totalShallowSize,
+            retained: strings.totalRetainedSize,
+        }, { count: 1, shallow: 304, retained: 304 });
+    });
+    it("computes totals consistent with the object and summary rows", () => {
+        const totalLiveSize = snapshot.objects.reduce((sum, obj) => sum + obj.shallowSize, 0);
+        const totalCount = snapshot.summary.reduce((sum, entry) => sum + entry.count, 0);
+        const totalShallowSize = snapshot.summary.reduce((sum, entry) => sum + entry.totalShallowSize, 0);
+        assert.strictEqual(snapshot.totalLiveSize, totalLiveSize);
+        assert.strictEqual(totalCount, snapshot.objects.length);
+        assert.strictEqual(totalShallowSize, snapshot.totalLiveSize);
+        assert.ok(snapshot.totalHeapSize >= snapshot.totalLiveSize);
+        assert.strictEqual(snapshot.totalFreeSize, snapshot.totalHeapSize - snapshot.totalLiveSize);
+        assert.ok(snapshot.totalFreeSize >= 0);
+    });
+    it("enriches every root with a resolved class name present in the object set", () => {
+        const objectAddresses = new Set(snapshot.objects.map((obj) => obj.address));
+        assert.ok(snapshot.roots.length > 0);
+        for (const root of snapshot.roots) {
+            assert.notStrictEqual(root.className, "");
+            assert.ok(objectAddresses.has(root.objectPtr));
+        }
+    });
+});
+//# sourceMappingURL=snapshot.test.js.map

package/dist/heap_analyzer/tests/snapshot.test.js.map

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

package/dist/heap_analyzer/tests/testHelper.d.ts

@@ -0,0 +1,18 @@
+export declare const PROJECT_ROOT: string;
+export declare const WARPO_ASC: string;
+export declare const FIXTURE_SRC: string;
+export declare const CLASS_PREFIX = "tools/heap_analyzer/tests/fixture/dwarfFixture/";
+export declare const canRunIntegration: boolean;
+export interface FixtureContext {
+    compileFixture(): void;
+    loadFixtureWasm(): Uint8Array;
+    generateFixtureDump(): void;
+    loadFixtureDumpBuffer(): ArrayBuffer;
+}
+/**
+ * Always registers the test suite. If warpo_asc is missing, the suite
+ * fails immediately instead of being silently skipped.
+ *
+ * Each suite gets its own build directory to allow parallel execution.
+ */
+export declare function describeIntegration(name: string, fn: (ctx: FixtureContext) => void): void;

package/dist/heap_analyzer/tests/testHelper.js

@@ -0,0 +1,68 @@
+import { execFileSync } from "node:child_process";
+import { existsSync, mkdirSync, readFileSync, rmSync } from "node:fs";
+import { dirname, resolve } from "node:path";
+import { fileURLToPath } from "node:url";
+import { platform } from "node:os";
+import { before, after, describe } from "node:test";
+import { executeFixture } from "./wasmExecutor.js";
+const TESTS_DIR = dirname(fileURLToPath(import.meta.url));
+export const PROJECT_ROOT = resolve(TESTS_DIR, "../../..");
+const WARPO_ASC_NAME = platform() === "win32" ? "warpo_asc.exe" : "warpo_asc";
+export const WARPO_ASC = resolve(PROJECT_ROOT, "build/warpo", WARPO_ASC_NAME);
+export const FIXTURE_SRC = resolve(TESTS_DIR, "fixture/dwarfFixture.ts");
+export const CLASS_PREFIX = "tools/heap_analyzer/tests/fixture/dwarfFixture/";
+export const canRunIntegration = existsSync(WARPO_ASC);
+// The fixture wasm hardcodes the dump output path as
+// "./tools/heap_analyzer/tests/fixture/build/example.dump" (relative to PROJECT_ROOT).
+// All suites share this path because the dump content is deterministic.
+const SHARED_DUMP_PATH = resolve(TESTS_DIR, "fixture/build/example.dump");
+function createFixtureContext(suiteName) {
+    const buildDir = resolve(TESTS_DIR, `fixture/build-${suiteName}`);
+    const wasmPath = resolve(buildDir, "dwarfFixture.wasm");
+    function ensureBuildDir() {
+        if (!existsSync(buildDir)) {
+            mkdirSync(buildDir, { recursive: true });
+        }
+    }
+    return {
+        compileFixture() {
+            ensureBuildDir();
+            execFileSync(WARPO_ASC, [FIXTURE_SRC, "-o", wasmPath, "--debug", "--exportRuntime"], {
+                cwd: PROJECT_ROOT,
+                stdio: "pipe",
+            });
+        },
+        loadFixtureWasm() {
+            return new Uint8Array(readFileSync(wasmPath));
+        },
+        generateFixtureDump() {
+            executeFixture(wasmPath, PROJECT_ROOT);
+        },
+        loadFixtureDumpBuffer() {
+            const buf = readFileSync(SHARED_DUMP_PATH);
+            return buf.buffer.slice(buf.byteOffset, buf.byteOffset + buf.byteLength);
+        },
+    };
+}
+/**
+ * Always registers the test suite. If warpo_asc is missing, the suite
+ * fails immediately instead of being silently skipped.
+ *
+ * Each suite gets its own build directory to allow parallel execution.
+ */
+export function describeIntegration(name, fn) {
+    const buildDir = resolve(TESTS_DIR, `fixture/build-${name}`);
+    const ctx = createFixtureContext(name);
+    describe(name, () => {
+        before(() => {
+            if (!canRunIntegration) {
+                throw new Error(`Integration test "${name}" requires warpo_asc at ${WARPO_ASC}. ` + `Please build with: npm run build:cpp`);
+            }
+        });
+        after(() => {
+            rmSync(buildDir, { recursive: true, force: true });
+        });
+        fn(ctx);
+    });
+}
+//# sourceMappingURL=testHelper.js.map

package/dist/heap_analyzer/tests/testHelper.js.map

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

package/dist/heap_analyzer/tests/tlsf.test.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/heap_analyzer/tests/tlsf.test.js

@@ -0,0 +1,98 @@
+import assert from "node:assert/strict";
+import { before, it } from "node:test";
+import { parseDumpFile } from "../src/dumpReader.js";
+import { walkBlocks } from "../src/tlsf.js";
+import { FREE, TAGS_MASK, TOTAL_OVERHEAD, BLOCK_OVERHEAD, AL_MASK, ROOT_SIZE, COLOR_MASK } from "../src/constants.js";
+import { describeIntegration } from "./testHelper.js";
+function loadFixture(ctx) {
+    return parseDumpFile(ctx.loadFixtureDumpBuffer());
+}
+describeIntegration("walkBlocks", (ctx) => {
+    let dump;
+    let blocks;
+    before(() => {
+        ctx.compileFixture();
+        ctx.generateFixtureDump();
+        dump = loadFixture(ctx);
+        blocks = walkBlocks(dump.memory, dump.rtGlobals.heapBase);
+    });
+    it("returns 110 used blocks from the fixture", () => {
+        assert.strictEqual(blocks.length, 110);
+    });
+    it("all returned blocks are used (not free)", () => {
+        for (const b of blocks) {
+            assert.strictEqual(b.mmInfo & FREE, 0);
+        }
+    });
+    it("all blocks have positive size", () => {
+        for (const b of blocks) {
+            assert.ok((b.mmInfo & ~TAGS_MASK) > 0);
+        }
+    });
+    it("payloadPtr increases monotonically", () => {
+        for (let i = 1; i < blocks.length; i++) {
+            assert.ok(blocks[i].payloadPtr > blocks[i - 1].payloadPtr);
+        }
+    });
+    it("all payloadPtrs are within memory bounds", () => {
+        for (const b of blocks) {
+            assert.ok(b.payloadPtr < dump.memory.byteLength);
+        }
+    });
+    it("gcColor is in range [0, 3]", () => {
+        for (const b of blocks) {
+            assert.ok(b.gcColor >= 0);
+            assert.ok(b.gcColor <= COLOR_MASK);
+        }
+    });
+    it("first block payloadPtr matches computed firstBlock + TOTAL_OVERHEAD", () => {
+        const heapBase = dump.rtGlobals.heapBase;
+        const tlsfRoot = (heapBase + AL_MASK) & ~AL_MASK;
+        const firstBlock = ((tlsfRoot + ROOT_SIZE + BLOCK_OVERHEAD + AL_MASK) & ~AL_MASK) - BLOCK_OVERHEAD;
+        assert.strictEqual(blocks[0].payloadPtr, firstBlock + TOTAL_OVERHEAD);
+    });
+});
+describeIntegration("object header parsing", (ctx) => {
+    let blocks;
+    before(() => {
+        ctx.compileFixture();
+        ctx.generateFixtureDump();
+        const dump = loadFixture(ctx);
+        blocks = walkBlocks(dump.memory, dump.rtGlobals.heapBase);
+    });
+    it("contains expected rtId values", () => {
+        const rtIds = new Set(blocks.map((b) => b.rtId));
+        assert.ok(rtIds.has(1));
+        assert.ok(rtIds.has(2));
+        assert.ok(rtIds.has(13));
+    });
+    it("rtId distribution matches fixture", () => {
+        const counts = {};
+        for (const b of blocks) {
+            counts[b.rtId] = (counts[b.rtId] || 0) + 1;
+        }
+        assert.strictEqual(counts[1], 29);
+        assert.strictEqual(counts[2], 4);
+        assert.strictEqual(counts[13], 31);
+    });
+    it("block at index 4 has rtId 14, rtSize 12, blockSize 28", () => {
+        assert.strictEqual(blocks[4].rtId, 14);
+        assert.strictEqual(blocks[4].rtSize, 12);
+        assert.strictEqual(blocks[4].mmInfo & ~TAGS_MASK, 28);
+    });
+    it("blocks with rtId 2 have non-zero rtSize", () => {
+        const strings = blocks.filter((b) => b.rtId === 2);
+        assert.strictEqual(strings.length, 4);
+        for (const s of strings) {
+            assert.ok(s.rtSize > 0);
+        }
+    });
+    it("blocks with rtId 10 all have rtSize 8", () => {
+        const items = blocks.filter((b) => b.rtId === 10);
+        assert.strictEqual(items.length, 13);
+        for (const item of items) {
+            assert.strictEqual(item.rtSize, 8);
+        }
+    });
+});
+//# sourceMappingURL=tlsf.test.js.map

package/dist/heap_analyzer/tests/tlsf.test.js.map

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

package/dist/heap_analyzer/tests/wasmExecutor.d.ts

@@ -0,0 +1,9 @@
+/**
+ * Instantiate a compiled wasm fixture and run its `_start` entry point.
+ * The injected `MemoryDump.dumpMemoryRegion` import writes a dump
+ * file whose path is decoded (UTF-8) from linear memory.
+ *
+ * The fixture may abort after the dump is written (e.g. debug assertions);
+ * such aborts are silently ignored.
+ */
+export declare function executeFixture(wasmPath: string, projectRoot: string): void;

package/dist/heap_analyzer/tests/wasmExecutor.js

@@ -0,0 +1,49 @@
+import { mkdirSync, readFileSync, writeFileSync } from "node:fs";
+import { dirname, resolve } from "node:path";
+const DUMP_MAGIC = new Uint8Array([0x41, 0x53, 0x48, 0x44]); // "A S H D"
+const DUMP_VERSION = 1;
+const HEADER_SIZE = 24;
+function writeDump(exports, outputPath) {
+    const raw = new Uint8Array(exports.memory.buffer);
+    const dump = new Uint8Array(HEADER_SIZE + raw.byteLength);
+    const view = new DataView(dump.buffer);
+    dump.set(DUMP_MAGIC, 0);
+    view.setUint32(4, DUMP_VERSION, true);
+    view.setUint32(8, Number(exports.__data_end.value), true);
+    view.setUint32(12, Number(exports.__heap_base.value), true);
+    view.setUint32(16, Number(exports.__stack_pointer.value), true);
+    dump.set(raw, HEADER_SIZE);
+    mkdirSync(dirname(outputPath), { recursive: true });
+    writeFileSync(outputPath, dump);
+}
+/**
+ * Instantiate a compiled wasm fixture and run its `_start` entry point.
+ * The injected `MemoryDump.dumpMemoryRegion` import writes a dump
+ * file whose path is decoded (UTF-8) from linear memory.
+ *
+ * The fixture may abort after the dump is written (e.g. debug assertions);
+ * such aborts are silently ignored.
+ */
+export function executeFixture(wasmPath, projectRoot) {
+    const wasmBytes = readFileSync(wasmPath);
+    // eslint-disable-next-line prefer-const
+    let exports;
+    const imports = {
+        env: {
+            abort(message, fileName, line, column) {
+                throw new Error(`abort at ${line}:${column} (msg=${message}, file=${fileName})`);
+            },
+        },
+        MemoryDump: {
+            dumpMemoryRegion(offset, size) {
+                const guestPath = Buffer.from(exports.memory.buffer, offset, size).toString("utf8");
+                writeDump(exports, resolve(projectRoot, guestPath));
+            },
+        },
+    };
+    const mod = new WebAssembly.Module(wasmBytes);
+    const instance = new WebAssembly.Instance(mod, imports);
+    exports = instance.exports;
+    exports._start();
+}
+//# sourceMappingURL=wasmExecutor.js.map

package/dist/heap_analyzer/tests/wasmExecutor.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"wasmExecutor.js","sourceRoot":"","sources":["../../../tools/heap_analyzer/tests/wasmExecutor.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,YAAY,EAAE,aAAa,EAAE,MAAM,SAAS,CAAC;AACjE,OAAO,EAAE,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAE7C,MAAM,UAAU,GAAG,IAAI,UAAU,CAAC,CAAC,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,CAAC,CAAC,CAAC,CAAC,YAAY;AACzE,MAAM,YAAY,GAAG,CAAC,CAAC;AACvB,MAAM,WAAW,GAAG,EAAE,CAAC;AAUvB,SAAS,SAAS,CAAC,OAAmB,EAAE,UAAkB;IACxD,MAAM,GAAG,GAAG,IAAI,UAAU,CAAC,OAAO,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC;IAClD,MAAM,IAAI,GAAG,IAAI,UAAU,CAAC,WAAW,GAAG,GAAG,CAAC,UAAU,CAAC,CAAC;IAC1D,MAAM,IAAI,GAAG,IAAI,QAAQ,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;IAEvC,IAAI,CAAC,GAAG,CAAC,UAAU,EAAE,CAAC,CAAC,CAAC;IACxB,IAAI,CAAC,SAAS,CAAC,CAAC,EAAE,YAAY,EAAE,IAAI,CAAC,CAAC;IACtC,IAAI,CAAC,SAAS,CAAC,CAAC,EAAE,MAAM,CAAC,OAAO,CAAC,UAAU,CAAC,KAAK,CAAC,EAAE,IAAI,CAAC,CAAC;IAC1D,IAAI,CAAC,SAAS,CAAC,EAAE,EAAE,MAAM,CAAC,OAAO,CAAC,WAAW,CAAC,KAAK,CAAC,EAAE,IAAI,CAAC,CAAC;IAC5D,IAAI,CAAC,SAAS,CAAC,EAAE,EAAE,MAAM,CAAC,OAAO,CAAC,eAAe,CAAC,KAAK,CAAC,EAAE,IAAI,CAAC,CAAC;IAChE,IAAI,CAAC,GAAG,CAAC,GAAG,EAAE,WAAW,CAAC,CAAC;IAE3B,SAAS,CAAC,OAAO,CAAC,UAAU,CAAC,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;IACpD,aAAa,CAAC,UAAU,EAAE,IAAI,CAAC,CAAC;AAClC,CAAC;AAED;;;;;;;GAOG;AACH,MAAM,UAAU,cAAc,CAAC,QAAgB,EAAE,WAAmB;IAClE,MAAM,SAAS,GAAG,YAAY,CAAC,QAAQ,CAAC,CAAC;IAEzC,wCAAwC;IACxC,IAAI,OAAmB,CAAC;IAExB,MAAM,OAAO,GAAwB;QACnC,GAAG,EAAE;YACH,KAAK,CAAC,OAAe,EAAE,QAAgB,EAAE,IAAY,EAAE,MAAc;gBACnE,MAAM,IAAI,KAAK,CAAC,YAAY,IAAI,IAAI,MAAM,SAAS,OAAO,UAAU,QAAQ,GAAG,CAAC,CAAC;YACnF,CAAC;SACF;QACD,UAAU,EAAE;YACV,gBAAgB,CAAC,MAAc,EAAE,IAAY;gBAC3C,MAAM,SAAS,GAAG,MAAM,CAAC,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,EAAE,IAAI,CAAC,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC;gBACpF,SAAS,CAAC,OAAO,EAAE,OAAO,CAAC,WAAW,EAAE,SAAS,CAAC,CAAC,CAAC;YACtD,CAAC;SACF;KACF,CAAC;IAEF,MAAM,GAAG,GAAG,IAAI,WAAW,CAAC,MAAM,CAAC,SAAS,CAAC,CAAC;IAC9C,MAAM,QAAQ,GAAG,IAAI,WAAW,CAAC,QAAQ,CAAC,GAAG,EAAE,OAAO,CAAC,CAAC;IACxD,OAAO,GAAG,QAAQ,CAAC,OAAqB,CAAC;IAEzC,OAAO,CAAC,MAAM,EAAE,CAAC;AACnB,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "warpo",
-  "version": "2.5.0-alpha-2",
+  "version": "3.0.0",
   "description": "next generation AssemblyScript compiler with optimizations",
   "type": "module",
   "bin": {
@@ -9,7 +9,8 @@
   "scripts": {
     "update": "cmake -S . -B build && cmake --build build --parallel --target warpo_binaryen_enums_gen && ./build/bin/warpo_binaryen_enums_gen",
     "build:ts": "tsc -p tools/tsconfig.json",
-    "build:cpp": "cmake -S . -B build && cmake --build build --parallel",
+    "build:parser:ts": "node assemblyscript/scripts/build-parser.js",
+    "build:cpp": "cmake -S . -B build && cmake --build build --parallel 4",
     "build": "npm run build:ts && npm run build:cpp",
     "test:as:ut": "node dist/warpo.js test",
     "test:cpp:ut": "cd build && ctest --output-on-failure",
@@ -20,6 +21,7 @@
     "test:debug_symbol": "cross-env-shell ./build/tests/dwarf/TestDebugSymbol",
     "test:debug_symbol:update": "cross-env-shell build/tests/dwarf/TestDebugSymbol --update-fixtures",
     "test:debug_server": "node --import tsx --test tools/debug_server/tests/**/*.test.ts",
+    "test:heap_analyzer": "cd tools/heap_analyzer && npm test",
     "test:driver": "node tests/driver/index.mjs",
     "test": "npm run test:as:ut && npm run test:cpp:ut && npm run test:as:snapshot && npm run test:opt:snapshot && npm run test:driver && npm run test:debug_symbol",
     "test:all": "npm run test && npm run test:bootstrap:debug && npm run test:bootstrap:release",
@@ -28,7 +30,7 @@
     "docs:build": "vitepress build docs",
     "prettier": "prettier --check .",
     "prettier:fix": "prettier --write .",
-    "lint": "npx eslint --config tools/debug_server/eslint.config.mjs tools/debug_server/ && npx eslint --config debugger/eslint.config.mjs debugger/src/",
+    "lint": "npx eslint --config ./eslint.config.mjs tools/debug_server/ tools/heap_analyzer/ debugger/src/",
     "cspell": "cspell ."
   },
   "license": "Apache-2.0",
@@ -44,6 +46,7 @@
   },
   "files": [
     "asconfig.schema.json",
+    "assemblyscript/build-parser/**/*",
     "assemblyscript/std/assembly/index.d.ts",
     "create",
     "dist",
@@ -51,7 +54,6 @@
     "types"
   ],
   "devDependencies": {
-    "@assemblyscript/loader": "^0.28.9",
     "@eslint/js": "^9.0.0",
     "@types/fs-extra": "^11.0.4",
     "@types/node": "^22.15.21",
@@ -63,6 +65,7 @@
     "cross-env": "^10.1.0",
     "cspell": "^9.3.0",
     "diff": "^8.0.0",
+    "esbuild": "^0.27.0",
     "eslint": "^9.0.0",
     "eslint-import-resolver-typescript": "^4.4.4",
     "eslint-plugin-import": "^2.32.0",
@@ -80,6 +83,7 @@
     "vitepress": "^2.0.0-alpha.15"
   },
   "dependencies": {
+    "@assemblyscript/loader": "^0.28.9",
     "@vscode/debugadapter": "^1.68.0",
     "@vscode/debugprotocol": "^1.68.0",
     "chalk": "^5.6.2",
@@ -87,6 +91,7 @@
     "fs-extra": "^11.3.3",
     "glob": "^13.0.0",
     "ignore": "^7.0.5",
-    "source-map": "^0.7.6"
+    "source-map": "^0.7.6",
+    "wasmparser": "^5.11.1"
   }
 }

package/types/std/index.d.ts

@@ -1521,10 +1521,6 @@ declare namespace f64x2 {
   export function relaxed_max(a: v128, b: v128): v128;
 }
 
-declare namespace ffi {
-  function set_ffi_closure_env(value: i32): void;
-}
-
 declare abstract class i31 {
   /** Creates a new 31-bit integer reference from the specified integer value. */
   static new(value: i32): ref_i31;

package/types/warpo/index.d.ts

@@ -1,5 +1,13 @@
 /// <reference path="../std/index.d.ts" />
 
+declare module "warpo/ffi" {
+  namespace ffi {
+    function set_ffi_closure_env(value: i32): void;
+    function multi_return_to_tuple<T>(value: MultiReturn<T>): T;
+    class MultiReturn<T> {}
+  }
+}
+
 declare module "rt/index" {
   // allocate new object with size and rtid
   function __new(size: usize, id: u32): usize;