warpo 3.0.0 → 3.1.0

package/dist/heap_analyzer/src/index.d.ts

@@ -0,0 +1,7 @@
+import type { HeapComparison, HeapSnapshot } from "./types.js";
+export declare function analyzeDump(dumpBuffer: ArrayBuffer, wasmBinary: Uint8Array | ArrayBuffer): HeapSnapshot;
+export declare function compareDumps(beforeDumpBuffer: ArrayBuffer, afterDumpBuffer: ArrayBuffer, wasmBinary: Uint8Array | ArrayBuffer): HeapComparison;
+export { analyzeHeap } from "./snapshot.js";
+export { compareSnapshots } from "./comparison.js";
+export { parseDumpFile } from "./dumpReader.js";
+export type { BuiltinContainerKind, ClassField, ClassLayout, ComparisonInstance, ComparisonInstanceChangeKind, ConstructorComparisonEntry, ConstructorEntry, ConstructorInstance, DumpedMemory, EntryLayout, GlobalRoot, HeapComparison, HeapObject, HeapSnapshot, ObjectHeader, RootInfo, RootType, RuntimeGlobalValues, } from "./types.js";

package/dist/heap_analyzer/src/index.js

@@ -0,0 +1,16 @@
+// Copyright (C) 2026 wasm-ecosystem
+// SPDX-License-Identifier: Apache-2.0
+import { compareSnapshots } from "./comparison.js";
+import { parseDumpFile } from "./dumpReader.js";
+import { analyzeHeap } from "./snapshot.js";
+export function analyzeDump(dumpBuffer, wasmBinary) {
+    const dumpedMemory = parseDumpFile(dumpBuffer);
+    return analyzeHeap(dumpedMemory.memory, dumpedMemory.rtGlobals, wasmBinary);
+}
+export function compareDumps(beforeDumpBuffer, afterDumpBuffer, wasmBinary) {
+    return compareSnapshots(analyzeDump(beforeDumpBuffer, wasmBinary), analyzeDump(afterDumpBuffer, wasmBinary));
+}
+export { analyzeHeap } from "./snapshot.js";
+export { compareSnapshots } from "./comparison.js";
+export { parseDumpFile } from "./dumpReader.js";
+//# sourceMappingURL=index.js.map

package/dist/heap_analyzer/src/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../tools/heap_analyzer/src/index.ts"],"names":[],"mappings":"AAAA,oCAAoC;AACpC,sCAAsC;AAEtC,OAAO,EAAE,gBAAgB,EAAE,MAAM,iBAAiB,CAAC;AACnD,OAAO,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAC;AAChD,OAAO,EAAE,WAAW,EAAE,MAAM,eAAe,CAAC;AAG5C,MAAM,UAAU,WAAW,CAAC,UAAuB,EAAE,UAAoC;IACvF,MAAM,YAAY,GAAG,aAAa,CAAC,UAAU,CAAC,CAAC;IAC/C,OAAO,WAAW,CAAC,YAAY,CAAC,MAAM,EAAE,YAAY,CAAC,SAAS,EAAE,UAAU,CAAC,CAAC;AAC9E,CAAC;AAED,MAAM,UAAU,YAAY,CAC1B,gBAA6B,EAC7B,eAA4B,EAC5B,UAAoC;IAEpC,OAAO,gBAAgB,CAAC,WAAW,CAAC,gBAAgB,EAAE,UAAU,CAAC,EAAE,WAAW,CAAC,eAAe,EAAE,UAAU,CAAC,CAAC,CAAC;AAC/G,CAAC;AAED,OAAO,EAAE,WAAW,EAAE,MAAM,eAAe,CAAC;AAC5C,OAAO,EAAE,gBAAgB,EAAE,MAAM,iBAAiB,CAAC;AACnD,OAAO,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAC"}

package/dist/heap_analyzer/src/referenceScanner.d.ts

@@ -1,11 +1,11 @@
-import type { ObjectHeader } from "./types.js";
-import type { ClassResolver } from "./classResolver.js";
+import { type ObjectHeader } from "./types.js";
+import type { DebugInfoResolver } from "./debugInfoResolver.js";
 /**
  * Scan object payloads to build a precise reference graph using debug info.
  *
  * @param memory Header-stripped DataView (wasm addr 0 = offset 0)
  * @param objects Parsed object headers from parseAllObjects
- * @param classResolver ClassResolver built from debug info
+ * @param debugInfoResolver DebugInfoResolver built from debug info
  * @returns Adjacency list: payloadPtr → array of referenced payloadPtrs
  */
-export declare function scanReferences(memory: DataView, objects: ObjectHeader[], classResolver: ClassResolver): Map<number, number[]>;
+export declare function scanReferences(memory: DataView, objects: ObjectHeader[], debugInfoResolver: DebugInfoResolver): Map<number, number[]>;

package/dist/heap_analyzer/src/referenceScanner.js

@@ -1,5 +1,6 @@
 // Copyright (C) 2026 wasm-ecosystem
 // SPDX-License-Identifier: Apache-2.0
+import { BuiltinContainerKind, getReferenceFields, isPointerfree, } from "./types.js";
 function readValidPtr(memory, addr, validPtrs) {
     if (addr + 4 > memory.byteLength) {
         return null;
@@ -10,8 +11,8 @@ function readValidPtr(memory, addr, validPtrs) {
     }
     return ptr;
 }
-function scanReferenceFields(memory, obj, classResolver, validPtrs, edges) {
-    for (const field of classResolver.getReferenceFields(obj.rtId)) {
+function scanReferenceFields(memory, obj, classLayout, validPtrs, edges) {
+    for (const field of getReferenceFields(classLayout)) {
         if (field.offset + field.size > obj.rtSize) {
             // Skip fields that don't fit within the object's size (could be a broken dumped memory or stale debug info)
             continue;
@@ -100,22 +101,48 @@ function scanSmallTupleElements(memory, obj, validPtrs, edges) {
         }
     }
 }
-function scanContainerElements(memory, obj, classLayout, validPtrs, edges) {
-    const name = classLayout.name;
-    if (name.startsWith("~lib/array/Array<")) {
-        scanArrayElements(memory, obj, validPtrs, edges);
+function scanFunctionEnv(memory, obj, classLayout, validPtrs, edges) {
+    const envField = classLayout.fields.find((field) => field.name === "_env");
+    if (!envField || envField.offset + envField.size > obj.rtSize) {
         return;
     }
-    if (name.startsWith("~lib/staticarray/StaticArray<")) {
-        scanStaticArrayElements(memory, obj, validPtrs, edges);
-        return;
-    }
-    if (name === "~lib/tuple/SmallTuple") {
-        scanSmallTupleElements(memory, obj, validPtrs, edges);
-        return;
+    const ptr = readValidPtr(memory, obj.payloadPtr + envField.offset, validPtrs);
+    if (ptr !== null) {
+        edges.push(ptr);
     }
-    if (classLayout.entryLayout) {
-        scanSetMapEntries(memory, obj, classLayout.entryLayout, validPtrs, edges);
+}
+function scanBuiltinContainer(memory, obj, classLayout, validPtrs, edges) {
+    scanReferenceFields(memory, obj, classLayout, validPtrs, edges);
+    switch (classLayout.builtinKind) {
+        case BuiltinContainerKind.Array: {
+            if (classLayout.templateTypeIsReference === true) {
+                scanArrayElements(memory, obj, validPtrs, edges);
+            }
+            return;
+        }
+        case BuiltinContainerKind.StaticArray: {
+            if (classLayout.templateTypeIsReference === true) {
+                scanStaticArrayElements(memory, obj, validPtrs, edges);
+            }
+            return;
+        }
+        case BuiltinContainerKind.SmallTuple: {
+            scanSmallTupleElements(memory, obj, validPtrs, edges);
+            return;
+        }
+        case BuiltinContainerKind.Function: {
+            scanFunctionEnv(memory, obj, classLayout, validPtrs, edges);
+            return;
+        }
+        case BuiltinContainerKind.MapOrSet: {
+            if (classLayout.entryLayout) {
+                scanSetMapEntries(memory, obj, classLayout.entryLayout, validPtrs, edges);
+            }
+            return;
+        }
+        default: {
+            return;
+        }
     }
 }
 /**
@@ -123,18 +150,22 @@ function scanContainerElements(memory, obj, classLayout, validPtrs, edges) {
  *
  * @param memory Header-stripped DataView (wasm addr 0 = offset 0)
  * @param objects Parsed object headers from parseAllObjects
- * @param classResolver ClassResolver built from debug info
+ * @param debugInfoResolver DebugInfoResolver built from debug info
  * @returns Adjacency list: payloadPtr → array of referenced payloadPtrs
  */
-export function scanReferences(memory, objects, classResolver) {
+export function scanReferences(memory, objects, debugInfoResolver) {
     const validPtrs = new Set(objects.map((o) => o.payloadPtr));
     const graph = new Map();
     for (const obj of objects) {
         const edges = [];
-        const classLayout = classResolver.getClassDef(obj.rtId);
-        if (classLayout && !classResolver.isPointerfree(obj.rtId)) {
-            scanReferenceFields(memory, obj, classResolver, validPtrs, edges);
-            scanContainerElements(memory, obj, classLayout, validPtrs, edges);
+        const classLayout = debugInfoResolver.getClassDef(obj.rtId);
+        if (classLayout) {
+            if (classLayout.builtinKind !== undefined) {
+                scanBuiltinContainer(memory, obj, classLayout, validPtrs, edges);
+            }
+            else if (!isPointerfree(classLayout)) {
+                scanReferenceFields(memory, obj, classLayout, validPtrs, edges);
+            }
         }
         graph.set(obj.payloadPtr, edges);
     }

package/dist/heap_analyzer/src/referenceScanner.js.map

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

package/dist/heap_analyzer/src/roots.d.ts

@@ -1,13 +1,10 @@
-import type { ObjectHeader, RootInfo, RuntimeGlobals } from "./types.js";
+import type { GlobalRoot, ObjectHeader, RootInfo, RuntimeGlobalValues } from "./types.js";
 /**
  * Identify GC roots that can be recovered reliably from the current dump model.
  *
  * Currently supported:
+ * - GC globals identified from DWARF + wasm global metadata
  * - shadow stack roots
  * - pinned objects (transparent GC color)
- *
- * Precise GC global-root detection is intentionally not implemented yet.
- * Scanning arbitrary words in the static region would misclassify incidental
- * pointer-like bytes from static strings or static arrays as semantic globals.
  */
-export declare function findRoots(memory: DataView, rtGlobals: RuntimeGlobals, objects: ObjectHeader[]): RootInfo[];
+export declare function findRoots(memory: DataView, rtGlobals: RuntimeGlobalValues, objects: ObjectHeader[], globalRoots?: GlobalRoot[]): RootInfo[];

package/dist/heap_analyzer/src/roots.js

@@ -5,16 +5,23 @@ import { GC_COLOR_TRANSPARENT } from "./constants.js";
  * Identify GC roots that can be recovered reliably from the current dump model.
  *
  * Currently supported:
+ * - GC globals identified from DWARF + wasm global metadata
  * - shadow stack roots
  * - pinned objects (transparent GC color)
- *
- * Precise GC global-root detection is intentionally not implemented yet.
- * Scanning arbitrary words in the static region would misclassify incidental
- * pointer-like bytes from static strings or static arrays as semantic globals.
  */
-export function findRoots(memory, rtGlobals, objects) {
+export function findRoots(memory, rtGlobals, objects, globalRoots = []) {
     const validPtrs = new Set(objects.map((obj) => obj.payloadPtr));
     const roots = [];
+    for (const globalRoot of globalRoots) {
+        if (globalRoot.value !== 0 && validPtrs.has(globalRoot.value)) {
+            roots.push({
+                objectPtr: globalRoot.value,
+                className: "",
+                rootType: "global",
+                sourceAddress: globalRoot.globalIndex,
+            });
+        }
+    }
     // Shadow stack in incremental runtime contains managed object pointers.
     for (let addr = rtGlobals.stackPointer; addr < rtGlobals.heapBase; addr += 4) {
         if (addr + 4 > memory.byteLength) {

package/dist/heap_analyzer/src/roots.js.map

@@ -1 +1 @@
-{"version":3,"file":"roots.js","sourceRoot":"","sources":["../../../tools/heap_analyzer/src/roots.ts"],"names":[],"mappings":"AAAA,oCAAoC;AACpC,sCAAsC;AAEtC,OAAO,EAAE,oBAAoB,EAAE,MAAM,gBAAgB,CAAC;AAGtD;;;;;;;;;;GAUG;AACH,MAAM,UAAU,SAAS,CAAC,MAAgB,EAAE,SAAyB,EAAE,OAAuB;IAC5F,MAAM,SAAS,GAAG,IAAI,GAAG,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,GAAG,CAAC,UAAU,CAAC,CAAC,CAAC;IAChE,MAAM,KAAK,GAAe,EAAE,CAAC;IAE7B,wEAAwE;IACxE,KAAK,IAAI,IAAI,GAAG,SAAS,CAAC,YAAY,EAAE,IAAI,GAAG,SAAS,CAAC,QAAQ,EAAE,IAAI,IAAI,CAAC,EAAE,CAAC;QAC7E,IAAI,IAAI,GAAG,CAAC,GAAG,MAAM,CAAC,UAAU,EAAE,CAAC;YACjC,MAAM;QACR,CAAC;QAED,MAAM,GAAG,GAAG,MAAM,CAAC,SAAS,CAAC,IAAI,EAAE,IAAI,CAAC,CAAC;QACzC,IAAI,GAAG,KAAK,CAAC,IAAI,SAAS,CAAC,GAAG,CAAC,GAAG,CAAC,EAAE,CAAC;YACpC,KAAK,CAAC,IAAI,CAAC;gBACT,SAAS,EAAE,GAAG;gBACd,SAAS,EAAE,EAAE;gBACb,QAAQ,EAAE,OAAO;gBACjB,aAAa,EAAE,IAAI;aACpB,CAAC,CAAC;QACL,CAAC;IACH,CAAC;IAED,KAAK,MAAM,GAAG,IAAI,OAAO,EAAE,CAAC;QAC1B,IAAI,GAAG,CAAC,OAAO,KAAK,oBAAoB,EAAE,CAAC;YACzC,KAAK,CAAC,IAAI,CAAC;gBACT,SAAS,EAAE,GAAG,CAAC,UAAU;gBACzB,SAAS,EAAE,EAAE;gBACb,QAAQ,EAAE,QAAQ;gBAClB,aAAa,EAAE,CAAC;aACjB,CAAC,CAAC;QACL,CAAC;IACH,CAAC;IAED,OAAO,KAAK,CAAC;AACf,CAAC"}
+{"version":3,"file":"roots.js","sourceRoot":"","sources":["../../../tools/heap_analyzer/src/roots.ts"],"names":[],"mappings":"AAAA,oCAAoC;AACpC,sCAAsC;AAEtC,OAAO,EAAE,oBAAoB,EAAE,MAAM,gBAAgB,CAAC;AAGtD;;;;;;;GAOG;AACH,MAAM,UAAU,SAAS,CACvB,MAAgB,EAChB,SAA8B,EAC9B,OAAuB,EACvB,cAA4B,EAAE;IAE9B,MAAM,SAAS,GAAG,IAAI,GAAG,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,GAAG,CAAC,UAAU,CAAC,CAAC,CAAC;IAChE,MAAM,KAAK,GAAe,EAAE,CAAC;IAE7B,KAAK,MAAM,UAAU,IAAI,WAAW,EAAE,CAAC;QACrC,IAAI,UAAU,CAAC,KAAK,KAAK,CAAC,IAAI,SAAS,CAAC,GAAG,CAAC,UAAU,CAAC,KAAK,CAAC,EAAE,CAAC;YAC9D,KAAK,CAAC,IAAI,CAAC;gBACT,SAAS,EAAE,UAAU,CAAC,KAAK;gBAC3B,SAAS,EAAE,EAAE;gBACb,QAAQ,EAAE,QAAQ;gBAClB,aAAa,EAAE,UAAU,CAAC,WAAW;aACtC,CAAC,CAAC;QACL,CAAC;IACH,CAAC;IAED,wEAAwE;IACxE,KAAK,IAAI,IAAI,GAAG,SAAS,CAAC,YAAY,EAAE,IAAI,GAAG,SAAS,CAAC,QAAQ,EAAE,IAAI,IAAI,CAAC,EAAE,CAAC;QAC7E,IAAI,IAAI,GAAG,CAAC,GAAG,MAAM,CAAC,UAAU,EAAE,CAAC;YACjC,MAAM;QACR,CAAC;QAED,MAAM,GAAG,GAAG,MAAM,CAAC,SAAS,CAAC,IAAI,EAAE,IAAI,CAAC,CAAC;QACzC,IAAI,GAAG,KAAK,CAAC,IAAI,SAAS,CAAC,GAAG,CAAC,GAAG,CAAC,EAAE,CAAC;YACpC,KAAK,CAAC,IAAI,CAAC;gBACT,SAAS,EAAE,GAAG;gBACd,SAAS,EAAE,EAAE;gBACb,QAAQ,EAAE,OAAO;gBACjB,aAAa,EAAE,IAAI;aACpB,CAAC,CAAC;QACL,CAAC;IACH,CAAC;IAED,KAAK,MAAM,GAAG,IAAI,OAAO,EAAE,CAAC;QAC1B,IAAI,GAAG,CAAC,OAAO,KAAK,oBAAoB,EAAE,CAAC;YACzC,KAAK,CAAC,IAAI,CAAC;gBACT,SAAS,EAAE,GAAG,CAAC,UAAU;gBACzB,SAAS,EAAE,EAAE;gBACb,QAAQ,EAAE,QAAQ;gBAClB,aAAa,EAAE,CAAC;aACjB,CAAC,CAAC;QACL,CAAC;IACH,CAAC;IAED,OAAO,KAAK,CAAC;AACf,CAAC"}

package/dist/heap_analyzer/src/snapshot.d.ts

@@ -1,2 +1,2 @@
-import type { HeapSnapshot, RuntimeGlobals } from "./types.js";
-export declare function analyzeHeap(memory: DataView, rtGlobals: RuntimeGlobals, wasmBinary: Uint8Array | ArrayBuffer): HeapSnapshot;
+import type { HeapSnapshot, RuntimeGlobalValues } from "./types.js";
+export declare function analyzeHeap(memory: DataView, rtGlobals: RuntimeGlobalValues, wasmBinary: Uint8Array | ArrayBuffer): HeapSnapshot;

package/dist/heap_analyzer/src/snapshot.js

@@ -1,28 +1,21 @@
 // Copyright (C) 2026 wasm-ecosystem
 // SPDX-License-Identifier: Apache-2.0
 import { AL_MASK, BLOCK_OVERHEAD, ROOT_SIZE } from "./constants.js";
-import { ClassResolver } from "./classResolver.js";
+import { DebugInfoResolver } from "./debugInfoResolver.js";
 import { buildDominatorTree } from "./dominator.js";
 import { computeRetainedSizes, shallowSize } from "./retainedSize.js";
 import { findRoots } from "./roots.js";
 import { scanReferences } from "./referenceScanner.js";
 import { walkBlocks } from "./tlsf.js";
-function getAssignedRootType(rootTypes, payloadPtr) {
-    const rootType = rootTypes.get(payloadPtr);
-    if (!rootType) {
-        throw new Error(`Missing root type for live object ${payloadPtr}`);
-    }
-    return rootType;
-}
 export function analyzeHeap(memory, rtGlobals, wasmBinary) {
-    // Resolve DWARF-derived class layouts once up front for the entire pipeline.
-    const classResolver = ClassResolver.fromWasm(wasmBinary);
+    // Resolve DWARF-derived class and global metadata once up front for the entire pipeline.
+    const debugInfoResolver = DebugInfoResolver.fromWasm(wasmBinary);
     // Step 1: Enumerate all allocated heap objects from TLSF blocks.
     const objects = walkBlocks(memory, rtGlobals.heapBase);
     // Step 2: Build the full object reference graph.
-    const graph = scanReferences(memory, objects, classResolver);
-    // Step 3: Discover currently supported roots: shadow stack and pinned objects.
-    const roots = findRoots(memory, rtGlobals, objects);
+    const graph = scanReferences(memory, objects, debugInfoResolver);
+    // Step 3: Discover current roots from globals, shadow stack, and pinned objects.
+    const roots = findRoots(memory, rtGlobals, objects, debugInfoResolver.getGlobalRoots(rtGlobals.mutableI32GlobalValues));
     // Step 4: Traverse from roots to determine the live object set.
     const liveSet = markLive(roots, graph);
     // Step 5: Restrict both the object list and the graph to live nodes only.
@@ -33,40 +26,21 @@ export function analyzeHeap(memory, rtGlobals, wasmBinary) {
     const dominatorTree = buildDominatorTree(liveGraph, rootPtrs);
     // Step 7: Aggregate retained sizes bottom-up on the dominator tree.
     const retainedSizes = computeRetainedSizes(liveObjects, dominatorTree);
-    // Step 8: Propagate root categories across the live graph.
-    const rootTypes = classifyRootTypes(roots, liveGraph);
-    const objectRtIds = new Map(objects.map((obj) => [obj.payloadPtr, obj.rtId]));
-    // Step 9: Materialize per-object results.
+    // Step 8: Materialize per-object results for constructor aggregation.
     const heapObjects = liveObjects.map((obj) => ({
         address: obj.payloadPtr,
         classId: obj.rtId,
-        className: classResolver.getClassName(obj.rtId),
+        className: debugInfoResolver.getClassName(obj.rtId),
         shallowSize: shallowSize(obj),
         retainedSize: retainedSizes.get(obj.payloadPtr) ?? shallowSize(obj),
-        rootType: getAssignedRootType(rootTypes, obj.payloadPtr),
     }));
-    // Step 10: Enrich root records with resolved class names.
-    const rootsWithClassName = roots.map((root) => {
-        const className = classResolver.getClassName(objectRtIds.get(root.objectPtr) ?? -1);
-        return {
-            objectPtr: root.objectPtr,
-            className,
-            rootType: root.rootType,
-            sourceAddress: root.sourceAddress,
-        };
-    });
-    // Step 11: Compute top-level totals and the class summary view.
+    // Step 9: Compute top-level totals and constructor view.
     const totalLiveSize = heapObjects.reduce((sum, obj) => sum + obj.shallowSize, 0);
     const totalHeapSize = memory.byteLength - computeFirstBlock(rtGlobals.heapBase);
-    const totalFreeSize = Math.max(0, totalHeapSize - totalLiveSize);
     return {
-        objects: heapObjects,
-        summary: buildSummary(heapObjects),
-        roots: rootsWithClassName,
+        constructors: buildConstructors(heapObjects),
         totalHeapSize,
         totalLiveSize,
-        totalFreeSize,
-        objectCount: heapObjects.length,
     };
 }
 function markLive(roots, graph) {
@@ -96,71 +70,45 @@ function buildLiveGraph(liveSet, graph) {
     }
     return liveGraph;
 }
-function classifyRootTypes(roots, graph) {
-    // Root-type propagation is priority-based: global > local > pinned.
-    const result = new Map();
-    const localRoots = new Set();
-    const pinnedRoots = new Set();
-    const globalRoots = new Set();
-    for (const root of roots) {
-        switch (root.rootType) {
-            case "global": {
-                globalRoots.add(root.objectPtr);
-                break;
-            }
-            case "local": {
-                localRoots.add(root.objectPtr);
-                break;
-            }
-            case "pinned": {
-                pinnedRoots.add(root.objectPtr);
-                break;
-            }
-        }
-    }
-    bfsAssignRootType(pinnedRoots, graph, result, "pinned");
-    bfsAssignRootType(localRoots, graph, result, "local");
-    bfsAssignRootType(globalRoots, graph, result, "global");
-    return result;
-}
-function bfsAssignRootType(startPtrs, graph, result, rootType) {
-    // Walk one root category at a time and stamp every reachable node with that category.
-    const visited = new Set();
-    const workList = Array.from(startPtrs);
-    for (let index = 0; index < workList.length; index++) {
-        const ptr = workList[index];
-        if (visited.has(ptr)) {
-            continue;
-        }
-        visited.add(ptr);
-        result.set(ptr, rootType);
-        for (const child of graph.get(ptr) ?? []) {
-            if (!visited.has(child)) {
-                workList.push(child);
-            }
-        }
-    }
-}
-function buildSummary(objects) {
-    // Summary is grouped by class name and sorted like a heap-summary view.
-    const summaryByClass = new Map();
+function buildConstructors(objects) {
+    const constructorsByClass = new Map();
     for (const obj of objects) {
-        let entry = summaryByClass.get(obj.className);
+        let entry = constructorsByClass.get(obj.className);
         if (!entry) {
             entry = {
                 className: obj.className,
-                classId: obj.classId,
                 count: 0,
                 totalShallowSize: 0,
                 totalRetainedSize: 0,
+                instances: [],
             };
-            summaryByClass.set(obj.className, entry);
+            constructorsByClass.set(obj.className, entry);
         }
         entry.count++;
         entry.totalShallowSize += obj.shallowSize;
         entry.totalRetainedSize += obj.retainedSize;
+        entry.instances.push({
+            address: obj.address,
+            shallowSize: obj.shallowSize,
+            retainedSize: obj.retainedSize,
+        });
     }
-    return [...summaryByClass.values()].toSorted((lhs, rhs) => rhs.totalRetainedSize - lhs.totalRetainedSize);
+    return Array.from(constructorsByClass.values(), (entry) => ({
+        className: entry.className,
+        count: entry.count,
+        totalShallowSize: entry.totalShallowSize,
+        totalRetainedSize: entry.totalRetainedSize,
+        instances: sortConstructorInstances(entry.instances),
+    })).toSorted(sortConstructors);
+}
+function sortConstructors(lhs, rhs) {
+    return (rhs.totalRetainedSize - lhs.totalRetainedSize ||
+        rhs.totalShallowSize - lhs.totalShallowSize ||
+        rhs.count - lhs.count ||
+        lhs.className.localeCompare(rhs.className));
+}
+function sortConstructorInstances(instances) {
+    return instances.toSorted((lhs, rhs) => rhs.retainedSize - lhs.retainedSize || rhs.shallowSize - lhs.shallowSize || lhs.address - rhs.address);
 }
 function computeFirstBlock(heapBase) {
     // Match the AssemblyScript runtime's TLSF root and first-block alignment rules.

package/dist/heap_analyzer/src/snapshot.js.map

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

package/dist/heap_analyzer/src/types.d.ts

@@ -5,13 +5,22 @@ export interface ObjectHeader {
     payloadPtr: number;
     gcColor: number;
 }
-export interface RuntimeGlobals {
+/** Runtime-captured values for the globals tracked in the dump header. */
+export interface RuntimeGlobalValues {
     dataEnd: number;
     heapBase: number;
     stackPointer: number;
+    /** Serialized values of mutable i32 wasm globals in module order. */
+    mutableI32GlobalValues: number[];
+}
+export interface GlobalRoot {
+    name: string;
+    className: string;
+    globalIndex: number;
+    value: number;
 }
 export interface DumpedMemory {
-    rtGlobals: RuntimeGlobals;
+    rtGlobals: RuntimeGlobalValues;
     memory: DataView;
 }
 export interface ClassField {
@@ -20,6 +29,13 @@ export interface ClassField {
     size: number;
     isReference: boolean;
 }
+export declare enum BuiltinContainerKind {
+    Array = 0,
+    StaticArray = 1,
+    MapOrSet = 2,
+    SmallTuple = 3,
+    Function = 4
+}
 /** Layout of a single entry in a Set or Map's entries ArrayBuffer. */
 export interface EntryLayout {
     /** Total byte size of one entry (stride). */
@@ -31,12 +47,16 @@ export interface ClassLayout {
     rtid: number;
     name: string;
     base: string | null;
+    byteSize: number;
     fields: ClassField[];
+    builtinKind?: BuiltinContainerKind;
     templateType?: string;
-    elementIsReference?: boolean;
+    templateTypeIsReference?: boolean;
     /** For Set/Map: describes the layout of entries inside the backing ArrayBuffer. */
     entryLayout?: EntryLayout;
 }
+export declare function isPointerfree(classLayout: ClassLayout): boolean;
+export declare function getReferenceFields(classLayout: ClassLayout): ClassField[];
 export type RootType = "global" | "local" | "pinned";
 export interface RootInfo {
     objectPtr: number;
@@ -50,21 +70,44 @@ export interface HeapObject {
     className: string;
     shallowSize: number;
     retainedSize: number;
-    rootType: RootType;
 }
-export interface SnapshotSummaryEntry {
+export interface ConstructorInstance {
+    address: number;
+    shallowSize: number;
+    retainedSize: number;
+}
+export interface ConstructorEntry {
     className: string;
-    classId: number;
     count: number;
     totalShallowSize: number;
     totalRetainedSize: number;
+    instances: ConstructorInstance[];
+}
+export type ComparisonInstanceChangeKind = "new" | "delete";
+export interface ComparisonInstance extends ConstructorInstance {
+    changeKind: ComparisonInstanceChangeKind;
+}
+export interface ConstructorComparisonEntry {
+    className: string;
+    newCount: number;
+    deletedCount: number;
+    countDelta: number;
+    allocatedSize: number;
+    freedSize: number;
+    sizeDelta: number;
+    instances: ComparisonInstance[];
 }
 export interface HeapSnapshot {
-    objects: HeapObject[];
-    summary: SnapshotSummaryEntry[];
-    roots: RootInfo[];
+    constructors: ConstructorEntry[];
     totalHeapSize: number;
     totalLiveSize: number;
-    totalFreeSize: number;
-    objectCount: number;
+}
+export interface HeapComparison {
+    beforeTotalHeapSize: number;
+    afterTotalHeapSize: number;
+    totalHeapSizeDelta: number;
+    beforeTotalLiveSize: number;
+    afterTotalLiveSize: number;
+    totalLiveSizeDelta: number;
+    constructors: ConstructorComparisonEntry[];
 }

package/dist/heap_analyzer/src/types.js

@@ -1,4 +1,25 @@
 // Copyright (C) 2026 wasm-ecosystem
 // SPDX-License-Identifier: Apache-2.0
-export {};
+export var BuiltinContainerKind;
+(function (BuiltinContainerKind) {
+    BuiltinContainerKind[BuiltinContainerKind["Array"] = 0] = "Array";
+    BuiltinContainerKind[BuiltinContainerKind["StaticArray"] = 1] = "StaticArray";
+    BuiltinContainerKind[BuiltinContainerKind["MapOrSet"] = 2] = "MapOrSet";
+    BuiltinContainerKind[BuiltinContainerKind["SmallTuple"] = 3] = "SmallTuple";
+    BuiltinContainerKind[BuiltinContainerKind["Function"] = 4] = "Function";
+})(BuiltinContainerKind || (BuiltinContainerKind = {}));
+export function isPointerfree(classLayout) {
+    if (classLayout.templateTypeIsReference === true) {
+        return false;
+    }
+    for (const field of classLayout.fields) {
+        if (field.isReference) {
+            return false;
+        }
+    }
+    return true;
+}
+export function getReferenceFields(classLayout) {
+    return classLayout.fields.filter((field) => field.isReference);
+}
 //# sourceMappingURL=types.js.map

package/dist/heap_analyzer/src/types.js.map

@@ -1 +1 @@
-{"version":3,"file":"types.js","sourceRoot":"","sources":["../../../tools/heap_analyzer/src/types.ts"],"names":[],"mappings":"AAAA,oCAAoC;AACpC,sCAAsC"}
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../../tools/heap_analyzer/src/types.ts"],"names":[],"mappings":"AAAA,oCAAoC;AACpC,sCAAsC;AAsCtC,MAAM,CAAN,IAAY,oBAMX;AAND,WAAY,oBAAoB;IAC9B,iEAAK,CAAA;IACL,6EAAW,CAAA;IACX,uEAAQ,CAAA;IACR,2EAAU,CAAA;IACV,uEAAQ,CAAA;AACV,CAAC,EANW,oBAAoB,KAApB,oBAAoB,QAM/B;AAuBD,MAAM,UAAU,aAAa,CAAC,WAAwB;IACpD,IAAI,WAAW,CAAC,uBAAuB,KAAK,IAAI,EAAE,CAAC;QACjD,OAAO,KAAK,CAAC;IACf,CAAC;IAED,KAAK,MAAM,KAAK,IAAI,WAAW,CAAC,MAAM,EAAE,CAAC;QACvC,IAAI,KAAK,CAAC,WAAW,EAAE,CAAC;YACtB,OAAO,KAAK,CAAC;QACf,CAAC;IACH,CAAC;IAED,OAAO,IAAI,CAAC;AACd,CAAC;AAED,MAAM,UAAU,kBAAkB,CAAC,WAAwB;IACzD,OAAO,WAAW,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,WAAW,CAAC,CAAC;AACjE,CAAC"}

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

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