@memlab/core 1.1.22 → 1.1.24

package/dist/__tests__/lib/TestUtils.d.ts

@@ -0,0 +1,13 @@
+/**
+ * Copyright (c) Meta Platforms, Inc. and affiliates.
+ *
+ * This source code is licensed under the MIT license found in the
+ * LICENSE file in the root directory of this source tree.
+ *
+ * @format
+ * @oncall web_perf_infra
+ */
+import { IHeapSnapshot } from '../../lib/Types';
+/** @internal */
+export declare function getFullHeapFromFile(file: string): Promise<IHeapSnapshot>;
+//# sourceMappingURL=TestUtils.d.ts.map

package/dist/__tests__/lib/TestUtils.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"TestUtils.d.ts","sourceRoot":"","sources":["../../../src/__tests__/lib/TestUtils.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAGH,OAAO,EAAa,aAAa,EAAW,MAAM,iBAAiB,CAAC;AAEpE,gBAAgB;AAChB,wBAAsB,mBAAmB,CACvC,IAAI,EAAE,MAAM,GACX,OAAO,CAAC,aAAa,CAAC,CAExB"}

package/dist/__tests__/lib/TestUtils.js

@@ -0,0 +1,39 @@
+"use strict";
+/**
+ * Copyright (c) Meta Platforms, Inc. and affiliates.
+ *
+ * This source code is licensed under the MIT license found in the
+ * LICENSE file in the root directory of this source tree.
+ *
+ * @format
+ * @oncall web_perf_infra
+ */
+var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, generator) {
+    function adopt(value) { return value instanceof P ? value : new P(function (resolve) { resolve(value); }); }
+    return new (P || (P = Promise))(function (resolve, reject) {
+        function fulfilled(value) { try { step(generator.next(value)); } catch (e) { reject(e); } }
+        function rejected(value) { try { step(generator["throw"](value)); } catch (e) { reject(e); } }
+        function step(result) { result.done ? resolve(result.value) : adopt(result.value).then(fulfilled, rejected); }
+        step((generator = generator.apply(thisArg, _arguments || [])).next());
+    });
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.getFullHeapFromFile = void 0;
+const __1 = require("../..");
+/** @internal */
+function getFullHeapFromFile(file) {
+    return __awaiter(this, void 0, void 0, function* () {
+        return yield loadProcessedSnapshot({ file });
+    });
+}
+exports.getFullHeapFromFile = getFullHeapFromFile;
+function loadProcessedSnapshot(options = {}) {
+    return __awaiter(this, void 0, void 0, function* () {
+        const opt = { buildNodeIdIndex: true, verbose: true };
+        const file = options.file || __1.utils.getSnapshotFilePathWithTabType(/.*/);
+        const snapshot = yield __1.utils.getSnapshotFromFile(file, opt);
+        __1.analysis.preparePathFinder(snapshot);
+        __1.info.flush();
+        return snapshot;
+    });
+}

package/dist/__tests__/parser/HeapParser.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"HeapParser.test.d.ts","sourceRoot":"","sources":["../../../src/__tests__/parser/HeapParser.test.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG"}

package/dist/__tests__/parser/NodeHeap.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"NodeHeap.test.d.ts","sourceRoot":"","sources":["../../../src/__tests__/parser/NodeHeap.test.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG"}

package/dist/__tests__/parser/StringNode.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"StringNode.test.d.ts","sourceRoot":"","sources":["../../../src/__tests__/parser/StringNode.test.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG"}

package/dist/__tests__/parser/traverse/HeapNodeTraverse.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"HeapNodeTraverse.test.d.ts","sourceRoot":"","sources":["../../../../src/__tests__/parser/traverse/HeapNodeTraverse.test.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,KAAK,EAAC,QAAQ,EAA2B,MAAM,oBAAoB,CAAC;AAI3E,OAAO,CAAC,MAAM,CAAC;IACb,UAAU,MAAM;QACd,QAAQ,EAAE,QAAQ,CAAC;KACpB;CACF"}

package/dist/__tests__/utils/utils.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"utils.test.d.ts","sourceRoot":"","sources":["../../../src/__tests__/utils/utils.test.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG"}

package/dist/index.d.ts

@@ -50,6 +50,8 @@ export { default as NormalizedTrace } from './trace-cluster/TraceBucket';
 /** @internal */
 export { default as EvaluationMetric } from './trace-cluster/EvalutationMetric';
 /** @internal */
+export { RunMetaInfoManager } from './lib/RunInfoUtils';
+/** @internal */
 export * from './lib/PackageInfoLoader';
 /** @internal */
 export { default as SequentialClustering } from './trace-cluster/SequentialClustering';

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAKH,cAAc,aAAa,CAAC;AAC5B,cAAc,gBAAgB,CAAC;AAE/B,gBAAgB;AAChB,wBAAsB,eAAe,IAAI,OAAO,CAAC,IAAI,CAAC,CAErD;AACD,gBAAgB;AAChB,OAAO,EAAC,OAAO,IAAI,MAAM,EAAC,MAAM,cAAc,CAAC;AAC/C,gBAAgB;AAChB,cAAc,2BAA2B,CAAC;AAC1C,gBAAgB;AAChB,cAAc,cAAc,CAAC;AAC7B,gBAAgB;AAChB,OAAO,EAAC,OAAO,IAAI,IAAI,EAAC,MAAM,eAAe,CAAC;AAC9C,gBAAgB;AAChB,OAAO,EAAC,OAAO,IAAI,UAAU,EAAC,MAAM,kBAAkB,CAAC;AACvD,gBAAgB;AAChB,OAAO,EAAC,OAAO,IAAI,KAAK,EAAC,MAAM,aAAa,CAAC;AAC7C,gBAAgB;AAChB,OAAO,EAAC,OAAO,IAAI,WAAW,EAAC,MAAM,mBAAmB,CAAC;AACzD,gBAAgB;AAChB,OAAO,EAAC,OAAO,IAAI,YAAY,EAAC,MAAM,oBAAoB,CAAC;AAC3D,gBAAgB;AAChB,cAAc,mBAAmB,CAAC;AAClC,gBAAgB;AAChB,OAAO,EAAC,OAAO,IAAI,UAAU,EAAC,MAAM,kBAAkB,CAAC;AACvD,gBAAgB;AAChB,OAAO,EAAC,OAAO,IAAI,WAAW,EAAC,MAAM,mBAAmB,CAAC;AACzD,gBAAgB;AAChB,OAAO,EAAC,OAAO,IAAI,QAAQ,EAAC,MAAM,oBAAoB,CAAC;AACvD,gBAAgB;AAChB,OAAO,EAAC,OAAO,IAAI,QAAQ,EAAC,MAAM,gBAAgB,CAAC;AACnD,gBAAgB;AAChB,OAAO,EAAC,OAAO,IAAI,cAAc,EAAC,MAAM,6BAA6B,CAAC;AACtE,gBAAgB;AAChB,OAAO,EAAC,OAAO,IAAI,KAAK,EAAC,MAAM,sBAAsB,CAAC;AACtD,gBAAgB;AAChB,OAAO,EAAC,OAAO,IAAI,cAAc,EAAC,MAAM,sBAAsB,CAAC;AAC/D,gBAAgB;AAChB,OAAO,EAAC,OAAO,IAAI,iBAAiB,EAAC,MAAM,4BAA4B,CAAC;AACxE,gBAAgB;AAChB,OAAO,EAAC,OAAO,IAAI,eAAe,EAAC,MAAM,6BAA6B,CAAC;AACvE,gBAAgB;AAChB,OAAO,EAAC,OAAO,IAAI,gBAAgB,EAAC,MAAM,mCAAmC,CAAC;AAC9E,gBAAgB;AAChB,OAAO,EAAC,kBAAkB,EAAC,MAAM,oBAAoB,CAAC;AACtD,gBAAgB;AAChB,cAAc,yBAAyB,CAAC;AACxC,gBAAgB;AAChB,OAAO,EAAC,OAAO,IAAI,oBAAoB,EAAC,MAAM,sCAAsC,CAAC;AACrF,gBAAgB;AAChB,OAAO,EAAC,OAAO,IAAI,2BAA2B,EAAC,MAAM,6CAA6C,CAAC;AACnG,gBAAgB;AAChB,OAAO,EAAC,OAAO,IAAI,WAAW,EAAC,MAAM,qBAAqB,CAAC;AAC3D,gBAAgB;AAChB,cAAc,8BAA8B,CAAC"}

package/dist/index.js

@@ -35,7 +35,7 @@ var __importDefault = (this && this.__importDefault) || function (mod) {
     return (mod && mod.__esModule) ? mod : { "default": mod };
 };
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.TraceFinder = exports.MultiIterationSeqClustering = exports.SequentialClustering = exports.EvaluationMetric = exports.NormalizedTrace = exports.leakClusterLogger = exports.ProcessManager = exports.modes = exports.memoryBarChart = exports.constant = exports.analysis = exports.browserInfo = exports.serializer = exports.runInfoUtils = exports.fileManager = exports.utils = exports.BaseOption = exports.info = exports.config = exports.registerPackage = void 0;
+exports.TraceFinder = exports.MultiIterationSeqClustering = exports.SequentialClustering = exports.RunMetaInfoManager = exports.EvaluationMetric = exports.NormalizedTrace = exports.leakClusterLogger = exports.ProcessManager = exports.modes = exports.memoryBarChart = exports.constant = exports.analysis = exports.browserInfo = exports.serializer = exports.runInfoUtils = exports.fileManager = exports.utils = exports.BaseOption = exports.info = exports.config = exports.registerPackage = void 0;
 const path_1 = __importDefault(require("path"));
 const PackageInfoLoader_1 = require("./lib/PackageInfoLoader");
 __exportStar(require("./lib/Types"), exports);
@@ -102,6 +102,9 @@ Object.defineProperty(exports, "NormalizedTrace", { enumerable: true, get: funct
 var EvalutationMetric_1 = require("./trace-cluster/EvalutationMetric");
 Object.defineProperty(exports, "EvaluationMetric", { enumerable: true, get: function () { return __importDefault(EvalutationMetric_1).default; } });
 /** @internal */
+var RunInfoUtils_2 = require("./lib/RunInfoUtils");
+Object.defineProperty(exports, "RunMetaInfoManager", { enumerable: true, get: function () { return RunInfoUtils_2.RunMetaInfoManager; } });
+/** @internal */
 __exportStar(require("./lib/PackageInfoLoader"), exports);
 /** @internal */
 var SequentialClustering_1 = require("./trace-cluster/SequentialClustering");

package/dist/lib/BaseOption.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"BaseOption.d.ts","sourceRoot":"","sources":["../../src/lib/BaseOption.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,KAAK,EAAC,UAAU,EAAC,MAAM,UAAU,CAAC;AACzC,OAAO,KAAK,EAAC,SAAS,EAAC,MAAM,SAAS,CAAC;AAGvC,OAAO,EAAC,YAAY,EAAC,MAAM,UAAU,CAAC;AAEtC,uBAAe,MAAM;IACnB,OAAO,CAAC,YAAY,CAAQ;IAG5B,aAAa,IAAI,MAAM;IAMvB,iBAAiB,IAAI,MAAM,GAAG,IAAI;cAKlB,KAAK,CAEnB,OAAO,EAAE,YAAY,EAErB,KAAK,EAAE,UAAU,GAChB,OAAO,CAAC,SAAS,GAAG,IAAI,CAAC;IAMtB,GAAG,CAAC,MAAM,EAAE,YAAY,EAAE,IAAI,EAAE,UAAU,GAAG,OAAO,CAAC,SAAS,GAAG,IAAI,CAAC;IAgB5E,QAAQ,IAAI,UAAU;IAKtB,QAAQ,IAAI,UAAU;IAKtB,UAAU,IAAI,OAAO;CAGtB;AAED,MAAM,CAAC,OAAO,OAAO,UAAW,SAAQ,MAAM;IAE5C,aAAa,IAAI,MAAM;IAMvB,iBAAiB,IAAI,MAAM,GAAG,IAAI;IAMlC,gBAAgB,IAAI,MAAM,EAAE;IAK5B,cAAc,IAAI,MAAM;cAMR,KAAK,CAEnB,OAAO,EAAE,YAAY,EAErB,KAAK,EAAE,UAAU,GAChB,OAAO,CAAC,SAAS,GAAG,IAAI,CAAC;CAI7B"}

package/dist/lib/BrowserInfo.d.ts

@@ -9,7 +9,7 @@
  */
 import type { ConsoleMessage, Dialog, LaunchOptions, Page } from 'puppeteer';
 import type { IBrowserInfo } from './Types';
-declare type Options = {
+type Options = {
     color?: boolean;
 };
 declare class BrowserInfo {

package/dist/lib/BrowserInfo.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"BrowserInfo.d.ts","sourceRoot":"","sources":["../../src/lib/BrowserInfo.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,KAAK,EAAC,cAAc,EAAE,MAAM,EAAE,aAAa,EAAE,IAAI,EAAC,MAAM,WAAW,CAAC;AAC3E,OAAO,KAAK,EAAC,YAAY,EAAC,MAAM,SAAS,CAAC;AAC1C,KAAK,OAAO,GAAG;IAAC,KAAK,CAAC,EAAE,OAAO,CAAA;CAAC,CAAC;AAQjC,cAAM,WAAW;IACf,eAAe,EAAE,MAAM,CAAC;IACxB,gBAAgB,EAAE,aAAa,CAAC;IAChC,gBAAgB,EAAE,MAAM,EAAE,CAAC;;IAQ3B,KAAK;IAIL,iBAAiB,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI;IAIxC,kBAAkB,CAAC,eAAe,EAAE,aAAa,GAAG,IAAI;IAIxD,IAAI,CAAC,WAAW,EAAE,YAAY,GAAG,IAAI;IAMrC,oBAAoB,CAClB,OAAO,EAAE,cAAc,EACvB,OAAO,GAAE,OAAY,GACpB,MAAM,EAAE;IAqBX,mBAAmB,CAAC,MAAM,EAAE,MAAM,EAAE,OAAO,GAAE,OAAY,GAAG,MAAM;IASlE,SAAS,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI;IAI/B,uBAAuB,IAAI,MAAM;IAIjC,IAAI,IAAI,IAAI;IAOZ,iBAAiB,CAAC,IAAI,EAAE,IAAI,GAAG,IAAI;CA8BpC;;AAED,wBAAiC"}

package/dist/lib/Config.d.ts

@@ -34,7 +34,7 @@ interface Device {
         isLandscape: boolean;
     };
 }
-declare type ConfigOption = {
+type ConfigOption = {
     workDir?: string;
 };
 /** @internal */
@@ -114,7 +114,7 @@ export declare class MemLabConfig {
     qes: QuickExperiment[];
     isOndemand: boolean;
     useExternalSnapshot: boolean;
-    externalRunMetaFile: string;
+    externalRunMetaTemplateFile: string;
     externalSnapshotVisitOrderFile: string;
     externalSnapshotDir: Nullable<string>;
     externalSnapshotFilePaths: string[];

package/dist/lib/Config.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Config.d.ts","sourceRoot":"","sources":["../../src/lib/Config.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,KAAK,EAAC,aAAa,EAAE,UAAU,EAAC,MAAM,WAAW,CAAC;AACzD,OAAO,KAAK,EACV,WAAW,EACX,QAAQ,EACR,UAAU,EACV,gBAAgB,EAChB,YAAY,EACZ,SAAS,EACT,WAAW,EACX,QAAQ,EACR,QAAQ,EACR,eAAe,EACf,WAAW,EACX,YAAY,EACb,MAAM,SAAS,CAAC;AASjB,UAAU,4BAA4B;IACpC,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,IAAI,CAAC,EAAE,MAAM,EAAE,CAAC;CACjB;AAED,UAAU,qBAAqB;IAC7B,iBAAiB,CAAC,EAAE,OAAO,CAAC;IAC5B,eAAe,CAAC,EAAE,QAAQ,GAAG,IAAI,CAAC;IAClC,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,YAAY,CAAC,EAAE,WAAW,CAAC;CAC5B;AAED,UAAU,MAAM;IACd,IAAI,EAAE,MAAM,CAAC;IACb,SAAS,EAAE,MAAM,CAAC;IAClB,QAAQ,EAAE;QACR,KAAK,EAAE,MAAM,CAAC;QACd,MAAM,EAAE,MAAM,CAAC;QACf,iBAAiB,EAAE,MAAM,CAAC;QAC1B,QAAQ,EAAE,OAAO,CAAC;QAClB,QAAQ,EAAE,OAAO,CAAC;QAClB,WAAW,EAAE,OAAO,CAAC;KACtB,CAAC;CACH;AAED,KAAK,YAAY,GAAG;IAClB,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB,CAAC;AAkBF,gBAAgB;AAChB,oBAAY,eAAe;IACzB,OAAO,IAAI;IACX,iBAAiB,IAAI;CACtB;AAED,gBAAgB;AAChB,oBAAY,aAAa;IACvB,IAAI,IAAI;IACR,KAAK,IAAI;CACV;AAED,gBAAgB;AAChB,qBAAa,YAAY;IACvB,oBAAoB,EAAE,OAAO,CAAC;IAC9B,uBAAuB,EAAE,OAAO,CAAC;IACjC,WAAW,EAAE,MAAM,EAAE,CAAC;IACtB,WAAW,EAAE,MAAM,EAAE,CAAC;IACtB,UAAU,EAAE,OAAO,CAAC;IACpB,SAAS,EAAE,QAAQ,CAAC,SAAS,CAAC,CAAC;IAC/B,iBAAiB,EAAE,OAAO,CAAC;IAC3B,mBAAmB,EAAE,OAAO,CAAC;IAC7B,QAAQ,EAAE,MAAM,CAAC;IAEjB,uBAAuB,EAAE,OAAO,CAAC;IACjC,eAAe,EAAE,OAAO,CAAC;IACzB,OAAO,EAAE,OAAO,CAAC;IACjB,QAAQ,EAAE,MAAM,CAAC;IACjB,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,MAAM,CAAC;IAClB,YAAY,EAAE,MAAM,CAAC;IACrB,gBAAgB,EAAE,MAAM,CAAC;IACzB,IAAI,EAAE,OAAO,CAAC;IACd,mBAAmB,EAAE,OAAO,CAAC;IAC7B,OAAO,EAAE,OAAO,CAAC;IAEjB,OAAO,EAAE,MAAM,CAAC;IAChB,UAAU,EAAE,MAAM,CAAC;IACnB,WAAW,EAAE,MAAM,CAAC;IACpB,WAAW,EAAE,MAAM,CAAC;IACpB,UAAU,EAAE,MAAM,CAAC;IACnB,YAAY,EAAE,MAAM,CAAC;IACrB,YAAY,EAAE,MAAM,CAAC;IACrB,WAAW,EAAE,MAAM,CAAC;IACpB,oBAAoB,EAAE,MAAM,CAAC;IAC7B,iBAAiB,EAAE,MAAM,CAAC;IAC1B,mBAAmB,EAAE,MAAM,CAAC;IAC5B,kBAAkB,EAAE,MAAM,CAAC;IAC3B,gBAAgB,EAAE,MAAM,CAAC;IACzB,YAAY,EAAE,MAAM,CAAC;IACrB,aAAa,EAAE,MAAM,CAAC;IACtB,aAAa,EAAE,MAAM,CAAC;IACtB,YAAY,EAAE,MAAM,CAAC;IACrB,gBAAgB,EAAE,MAAM,CAAC;IACzB,YAAY,EAAE,MAAM,CAAC;IACrB,iBAAiB,EAAE,MAAM,CAAC;IAC1B,cAAc,EAAE,MAAM,CAAC;IACvB,iBAAiB,EAAE,MAAM,CAAC;IAC1B,gBAAgB,EAAE,MAAM,CAAC;IACzB,kBAAkB,EAAE,MAAM,CAAC;IAC3B,eAAe,EAAE,MAAM,CAAC;IACxB,aAAa,EAAE,MAAM,CAAC;IACtB,kBAAkB,EAAE,MAAM,CAAC;IAC3B,oBAAoB,EAAE,MAAM,CAAC;IAC7B,mBAAmB,EAAE,MAAM,CAAC;IAC5B,qBAAqB,EAAE,MAAM,CAAC;IAC9B,uBAAuB,EAAE,MAAM,CAAC;IAChC,qBAAqB,EAAE,MAAM,CAAC;IAC9B,kBAAkB,EAAE,MAAM,CAAC;IAC3B,sBAAsB,EAAE,MAAM,CAAC;IAC/B,mBAAmB,EAAE,QAAQ,CAAC,MAAM,CAAC,CAAC;IACtC,eAAe,EAAE,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAErC,UAAU,EAAE,QAAQ,CAAC,WAAW,CAAC,CAAC;IAClC,eAAe,EAAE,aAAa,GAC5B,4BAA4B,GAC5B,qBAAqB,CAAC;IACxB,mBAAmB,EAAE,OAAO,CAAC;IAC7B,aAAa,EAAE,QAAQ,CAAC,MAAM,CAAC,CAAC;IAChC,WAAW,EAAE,GAAG,CAAC,MAAM,CAAC,CAAC;IACzB,YAAY,EAAE,GAAG,CAAC,MAAM,CAAC,CAAC;IAC1B,GAAG,EAAE,eAAe,EAAE,CAAC;IACvB,UAAU,EAAE,OAAO,CAAC;IACpB,mBAAmB,EAAE,OAAO,CAAC;IAC7B,2BAA2B,EAAE,MAAM,CAAC;IACpC,8BAA8B,EAAE,MAAM,CAAC;IACvC,mBAAmB,EAAE,QAAQ,CAAC,MAAM,CAAC,CAAC;IACtC,yBAAyB,EAAE,MAAM,EAAE,CAAC;IACpC,WAAW,EAAE,YAAY,CAAC;IAC1B,cAAc,EAAE,OAAO,CAAC;IACxB,YAAY,EAAE,OAAO,CAAC;IACtB,uBAAuB,EAAE,OAAO,CAAC;IACjC,UAAU,EAAE,OAAO,CAAC;IACpB,YAAY,EAAE,OAAO,CAAC;IACtB,cAAc,EAAE,OAAO,CAAC;IACxB,UAAU,EAAE,OAAO,CAAC;IACpB,YAAY,EAAE,OAAO,CAAC;IACtB,MAAM,EAAE,OAAO,CAAC;IAChB,gBAAgB,EAAE,OAAO,CAAC;IAC1B,MAAM,EAAE,OAAO,CAAC;IAChB,gBAAgB,EAAE,OAAO,CAAC;IAC1B,aAAa,EAAE,OAAO,CAAC;IACvB,YAAY,EAAE,MAAM,CAAC;IACrB,wBAAwB,EAAE,MAAM,CAAC;IACjC,sBAAsB,EAAE,MAAM,CAAC;IAC/B,oBAAoB,EAAE,MAAM,CAAC;IAC7B,oBAAoB,EAAE,MAAM,CAAC;IAC7B,oBAAoB,EAAE,MAAM,CAAC;IAC7B,4BAA4B,EAAE,MAAM,CAAC;IACrC,WAAW,EAAE,MAAM,CAAC;IACpB,YAAY,EAAE,MAAM,CAAC;IACrB,aAAa,EAAE,OAAO,CAAC;IACvB,YAAY,EAAE,MAAM,CAAC;IACrB,qBAAqB,EAAE,MAAM,CAAC;IAC9B,oBAAoB,EAAE,MAAM,CAAC;IAC7B,sBAAsB,EAAE,MAAM,CAAC;IAC/B,qBAAqB,EAAE,MAAM,CAAC;IAC9B,sBAAsB,EAAE,MAAM,CAAC;IAC/B,WAAW,EAAE,MAAM,CAAC;IACpB,iBAAiB,EAAE,MAAM,CAAC;IAC1B,kBAAkB,EAAE,MAAM,CAAC;IAC3B,kBAAkB,EAAE,MAAM,CAAC;IAC3B,eAAe,EAAE,MAAM,CAAC;IACxB,+BAA+B,EAAE,MAAM,CAAC;IACxC,gBAAgB,EAAE,MAAM,CAAC;IACzB,gCAAgC,EAAE,OAAO,CAAC;IAC1C,eAAe,EAAE,OAAO,CAAC;IACzB,gBAAgB,EAAE,OAAO,CAAC;IAC1B,mBAAmB,EAAE,OAAO,CAAC;IAC7B,kBAAkB,EAAE,UAAU,EAAE,CAAC;IACjC,0BAA0B,EAAE,OAAO,CAAC;IACpC,oBAAoB,EAAE,MAAM,CAAC;IAC7B,OAAO,EAAE,OAAO,CAAC;IACjB,gBAAgB,EAAE,QAAQ,CAAC,MAAM,CAAC,CAAC;IACnC,YAAY,EAAE,OAAO,CAAC;IACtB,cAAc,EAAE,MAAM,CAAC;IACvB,mBAAmB,EAAE,MAAM,CAAC;IAC5B,kBAAkB,EAAE,GAAG,CAAC,MAAM,CAAC,CAAC;IAChC,yBAAyB,EAAE,OAAO,CAAC;IACnC,kBAAkB,EAAE,OAAO,CAAC;IAC5B,iBAAiB,EAAE,GAAG,CAAC,MAAM,CAAC,CAAC;IAC/B,iBAAiB,EAAE,GAAG,CAAC,MAAM,CAAC,CAAC;IAC/B,gBAAgB,EAAE,GAAG,CAAC,MAAM,CAAC,CAAC;IAC9B,gBAAgB,EAAE,GAAG,CAAC,MAAM,CAAC,CAAC;IAC9B,gBAAgB,EAAE,MAAM,CAAC;IACzB,2BAA2B,EAAE,GAAG,CAAC,MAAM,CAAC,CAAC;IACzC,0BAA0B,EAAE,GAAG,CAAC,MAAM,CAAC,CAAC;IACxC,mBAAmB,EAAE,MAAM,CAAC;IAC5B,oBAAoB,EAAE,GAAG,CAAC,MAAM,GAAG,MAAM,CAAC,CAAC;IAC3C,oBAAoB,EAAE,GAAG,CAAC,MAAM,CAAC,CAAC;IAClC,oBAAoB,EAAE,OAAO,CAAC;IAC9B,iBAAiB,EAAE,MAAM,CAAC;IAC1B,mBAAmB,EAAE,eAAe,CAAC;IACrC,4BAA4B,EAAE,MAAM,CAAC;IACrC,kBAAkB,CAAC,EAAE,QAAQ,CAAC,WAAW,CAAC,CAAC;IAC3C,WAAW,EAAE,MAAM,CAAC;IACpB,WAAW,EAAE,OAAO,CAAC;IACrB,mCAAmC,EAAE,OAAO,CAAC;IAC7C,uBAAuB,EAAE,OAAO,CAAC;IACjC,aAAa,EAAE,aAAa,CAAC;IAC7B,eAAe,EAAE,QAAQ,CAAC,gBAAgB,CAAC,CAAC;IAC5C,WAAW,EAAE,YAAY,EAAE,CAAC;IAC5B,cAAc,EAAE,OAAO,CAAC;IACxB,8BAA8B,EAAE,MAAM,CAAC;IACvC,OAAO,EAAE,MAAM,CAAC;IAChB,sBAAsB,EAAE,OAAO,CAAC;IAChC,6BAA6B,EAAE,OAAO,CAAC;IACvC,uBAAuB,EAAE,MAAM,CAAC;IAChC,+BAA+B,EAAE,MAAM,CAAC;IACxC,gCAAgC,EAAE,MAAM,CAAC;IACzC,2BAA2B,EAAE,OAAO,CAAC;IACrC,YAAY,EAAE,OAAO,CAAC;IACtB,eAAe,EAAE,OAAO,CAAC;IACzB,qBAAqB,EAAE,OAAO,CAAC;IAC/B,iBAAiB,EAAE,QAAQ,CAAC,MAAM,CAAC,CAAC;IACpC,WAAW,EAAE,OAAO,CAAC;IACrB,uBAAuB,EAAE,MAAM,CAAC;IAChC,iBAAiB,EAAE,QAAQ,CAAC,MAAM,CAAC,CAAC;gBAExB,OAAO,GAAE,YAAiB;IAOtC,OAAO,CAAC,mBAAmB;IAyH3B,OAAO,CAAC,IAAI;IAiLZ,mCAAmC,CAEjC,IAAI,EAAE,MAAM,EAEZ,YAAY,EAAE,MAAM,GACnB,MAAM,EAAE;IAIX,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAsB;WAE/B,WAAW,IAAI,YAAY;WAa3B,2BAA2B,IAAI,YAAY;IAMzD,OAAO,CAAC,WAAW;IAcnB,SAAS,CAAC,GAAG,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,GAAG,IAAI;IAKzC,IAAI,QAAQ,CAAC,QAAQ,EAAE,QAAQ,CAAC,SAAS,CAAC,EAiBzC;IAED,IAAI,QAAQ,IAAI,QAAQ,CAAC,SAAS,CAAC,CAElC;IAED,IAAI,SAAS,CAAC,MAAM,EAAE,OAAO,EAE5B;IACD,IAAI,SAAS,IAAI,OAAO,CAEvB;IAED,IAAI,OAAO,CAAC,CAAC,EAAE,MAAM,EAcpB;IAED,IAAI,OAAO,IAAI,MAAM,CAEpB;IAED,IAAI,gBAAgB,CAAC,SAAS,EAAE,OAAO,EAOtC;IAED,IAAI,gBAAgB,IAAI,OAAO,CAE9B;IAED,IAAI,kBAAkB,CAAC,OAAO,EAAE,OAAO,EAgBtC;IAED,IAAI,kBAAkB,IAAI,OAAO,CAEhC;IAED,IAAI,iBAAiB,IAAI,MAAM,CAE9B;IAKD,IAAI,wBAAwB,CAAC,UAAU,EAAE,UAAU,EAIlD;IAED,IAAI,wBAAwB,IAAI,UAAU,CAEzC;IAED,IAAI,mBAAmB,CAAC,YAAY,EAAE,OAAO,EAS5C;IACD,IAAI,mBAAmB,IAAI,OAAO,CAEjC;IAED,SAAS,CACP,UAAU,EAAE,MAAM,EAClB,OAAO,GAAE;QAAC,cAAc,CAAC,EAAE,OAAO,CAAA;KAAM,GACvC,IAAI;IA2BP,UAAU,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,IAAI;IAI5C,OAAO,CAAC,aAAa;IAMrB,OAAO,CAAC,QAAQ;IAMhB,UAAU,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI;IAMjC,WAAW,IAAI,IAAI;CAWpB;AAED,gBAAgB;AAChB,QAAA,MAAM,MAAM,cAA6B,CAAC;AAE1C,gBAAgB;AAChB,eAAe,MAAM,CAAC"}

package/dist/lib/Config.js

@@ -321,7 +321,10 @@ class MemLabConfig {
         // node names excluded from the trace finding
         this.nodeNameBlockList = new Set(['system / PropertyCell']);
         // edge names excluded from the trace finding
-        this.edgeNameBlockList = new Set(['feedback_cell']);
+        this.edgeNameBlockList = new Set([
+            'feedback_cell',
+            'part of key -> value pair in ephemeron table',
+        ]);
         // node names less preferable in trace finding
         this.nodeNameGreyList = new Set([
             'InternalNode',

package/dist/lib/Console.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Console.d.ts","sourceRoot":"","sources":["../../src/lib/Console.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAIH,OAAc,EAAC,KAAK,EAAC,MAAM,OAAO,CAAC;AAKnC,OAAO,KAAK,EAAC,YAAY,EAAC,MAAM,UAAU,CAAC;AAC3C,OAAO,EAAC,QAAQ,EAAqB,MAAM,SAAS,CAAC;AA4ErD,UAAU,mBAAmB;IAC3B,GAAG,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,MAAM,CAAC;IAC7B,IAAI,EAAE,KAAK,CAAC;IACZ,GAAG,EAAE,KAAK,CAAC;IACX,GAAG,EAAE,KAAK,CAAC;IACX,OAAO,EAAE,KAAK,CAAC;IACf,KAAK,EAAE,KAAK,CAAC;IACb,OAAO,EAAE,KAAK,CAAC;CAChB;AAED,cAAM,aAAa;IACjB,OAAO,CAAC,MAAM,CAAoC;IAClD,OAAO,CAAC,QAAQ,CAAW;IAC3B,OAAO,CAAC,GAAG,CAAgB;IAC3B,OAAO,CAAC,UAAU,CAA0B;IAC5C,OAAO,CAAC,MAAM,CAQZ;IAEF,OAAO,CAAC,MAAM,CAAC,SAAS,CAAgB;IAExC,SAAS;WAQK,WAAW,IAAI,aAAa;IAsB1C,OAAO,CAAC,KAAK;IAOb,OAAO,CAAC,IAAI;IAIZ,OAAO,CAAC,cAAc;IAKtB,OAAO,CAAC,UAAU;IASlB,OAAO,CAAC,MAAM;IAcd,OAAO,CAAC,QAAQ;IAgChB,OAAO,CAAC,OAAO;IAWf,OAAO,CAAC,yBAAyB;IAKjC,OAAO,CAAC,qBAAqB;IA6B7B,OAAO,CAAC,gBAAgB;IAkBxB,OAAO,CAAC,eAAe;IAOvB,OAAO,CAAC,qBAAqB;IAW7B,OAAO,CAAC,QAAQ;IAUT,eAAe,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI;IAKtC,iBAAiB,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI;IAKxC,YAAY,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI;IAahC,UAAU,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI;IAc9B,SAAS,CAAC,MAAM,EAAE,YAAY,GAAG,IAAI;IAIrC,KAAK,CAAC,GAAG,IAAI,EAAE,QAAQ,EAAE,GAAG,IAAI;IAiBhC,KAAK,IAAI,IAAI;IAOb,QAAQ,CAAC,GAAG,EAAE,MAAM,GAAG,IAAI;IAQ3B,SAAS,CAAC,GAAG,EAAE,MAAM,GAAG,IAAI;IAQ5B,QAAQ,CAAC,GAAG,EAAE,MAAM,GAAG,IAAI;IAQ3B,QAAQ,CAAC,GAAG,EAAE,MAAM,GAAG,IAAI;IAQ3B,OAAO,CAAC,GAAG,EAAE,MAAM,GAAG,IAAI;IAS1B,aAAa,CAAC,GAAG,EAAE,MAAM,GAAG,IAAI;IAMhC,KAAK,CAAC,GAAG,EAAE,MAAM,GAAG,IAAI;IAKxB,OAAO,CAAC,GAAG,EAAE,MAAM,GAAG,IAAI;IAK1B,QAAQ,IAAI,IAAI;IAQhB,SAAS,CACd,GAAG,EAAE,MAAM,EACX,OAAO,GAAE;QAAC,KAAK,CAAC,EAAE,MAAM,mBAAmB,CAAA;KAAM,GAChD,IAAI;IAcA,cAAc,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;IAc9C,QAAQ,CACb,GAAG,EAAE,MAAM,EACX,KAAK,EAAE,MAAM,EACb,OAAO,GAAE;QAAC,OAAO,CAAC,EAAE,MAAM,CAAA;KAAM,GAC/B,IAAI;IAqBA,KAAK,IAAI,IAAI;CAGrB;;AAED,wBAA2C"}

package/dist/lib/Constant.d.ts

@@ -20,7 +20,7 @@ declare const constants: {
     namePrefixForScenarioFromFile: string;
     unset: string;
 };
-export declare type Constants = typeof constants;
+export type Constants = typeof constants;
 declare const _default: {
     isFB: boolean;
     isFRL: boolean;

package/dist/lib/Constant.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Constant.d.ts","sourceRoot":"","sources":["../../src/lib/Constant.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAIH,QAAA,MAAM,SAAS;;;;;;;;;;;;CAwCd,CAAC;AAOF,MAAM,MAAM,SAAS,GAAG,OAAO,SAAS,CAAC;;;;;;;;;;;;;;AACzC,wBAA8E"}

package/dist/lib/FileManager.d.ts

@@ -8,7 +8,7 @@
  * @oncall web_perf_infra
  */
 import type { MemLabConfig } from './Config';
-import type { AnyValue, FileOption } from './Types';
+import type { AnyValue, E2EStepInfo, FileOption } from './Types';
 /** @internal */
 export declare function joinAndProcessDir(options: FileOption, ...args: AnyValue[]): string;
 /** @internal */
@@ -78,6 +78,11 @@ export declare class FileManager {
     isWithinInternalDirectory(filePath: string): boolean;
     createDefaultVisitOrderMetaFile(options?: FileOption): void;
     createDefaultVisitOrderMetaFileWithSingleSnapshot(options: FileOption | undefined, snapshotFile: string): void;
+    /**
+     * create visit order data structure based on specified
+     * baseline, target, and final heap snapshots
+     */
+    createVisitOrderWithSnapshots(baselineSnapshot: string, targetSnapshot: string, finalSnapshot: string): E2EStepInfo[];
     initDirs(config: MemLabConfig, options?: FileOption): void;
 }
 declare const _default: FileManager;

package/dist/lib/FileManager.d.ts.map

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

package/dist/lib/FileManager.js

@@ -377,6 +377,29 @@ class FileManager {
         // save the snapshot meta file
         fs_extra_1.default.writeFileSync(snapshotSeqMetaFile, JSON.stringify(visitOrder, null, 2), 'UTF-8');
     }
+    /**
+     * create visit order data structure based on specified
+     * baseline, target, and final heap snapshots
+     */
+    createVisitOrderWithSnapshots(baselineSnapshot, targetSnapshot, finalSnapshot) {
+        const snapshotTemplateFile = this.getSnapshotSequenceExternalTemplateFile();
+        const visitOrder = JSON.parse(fs_extra_1.default.readFileSync(snapshotTemplateFile, 'UTF-8'));
+        // fill in snapshot file name for each entry with snapshot: true
+        visitOrder.forEach(step => {
+            switch (step.name) {
+                case 'baseline':
+                    step.snapshotFile = baselineSnapshot;
+                    break;
+                case 'target':
+                    step.snapshotFile = targetSnapshot;
+                    break;
+                case 'final':
+                    step.snapshotFile = finalSnapshot;
+                    break;
+            }
+        });
+        return visitOrder;
+    }
     initDirs(config, options = FileManager.defaultFileOption) {
         // cache the last processed memlab config instance
         // the instance should be a singleton
@@ -427,7 +450,7 @@ class FileManager {
         config.heapAnalysisLogDir = joinAndProcessDir(options, this.getHeapAnalysisLogDir(options));
         config.metricsOutDir = joinAndProcessDir(options, loggerOutDir, 'metrics');
         config.reportScreenshotFile = path_1.default.join(outDir, 'report.png');
-        config.externalRunMetaFile = this.getRunMetaExternalTemplateFile();
+        config.externalRunMetaTemplateFile = this.getRunMetaExternalTemplateFile();
         config.externalSnapshotVisitOrderFile =
             this.getSnapshotSequenceExternalTemplateFile();
         joinAndProcessDir(options, this.getUniqueTraceClusterDir(options));

package/dist/lib/HeapAnalyzer.d.ts

@@ -9,14 +9,14 @@
  */
 import type { E2EStepInfo, HeapNodeIdSet, IHeapSnapshot, IMemoryAnalystSnapshotDiff, IOveralHeapInfo, LeakTracePathItem, Optional, IOveralLeakInfo, TraceCluster, ISerializedInfo, DiffLeakOptions } from './Types';
 import TraceFinder from '../paths/TraceFinder';
-declare type DiffSnapshotsOptions = {
+type DiffSnapshotsOptions = {
     loadAllSnapshots?: boolean;
     workDir?: string;
 };
-declare type WorkDirOptions = {
+type WorkDirOptions = {
     workDir?: string;
 };
-declare type GetTraceOptions = {
+type GetTraceOptions = {
     workDir?: string;
     printConsoleOnly?: boolean;
 };

package/dist/lib/HeapAnalyzer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"HeapAnalyzer.d.ts","sourceRoot":"","sources":["../../src/lib/HeapAnalyzer.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAIH,OAAO,KAAK,EACV,WAAW,EACX,aAAa,EACb,aAAa,EACb,0BAA0B,EAE1B,eAAe,EACf,iBAAiB,EAEjB,QAAQ,EACR,eAAe,EACf,YAAY,EACZ,eAAe,EACf,eAAe,EAChB,MAAM,SAAS,CAAC;AAWjB,OAAO,WAAW,MAAM,sBAAsB,CAAC;AAO/C,KAAK,oBAAoB,GAAG;IAC1B,gBAAgB,CAAC,EAAE,OAAO,CAAC;IAC3B,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB,CAAC;AAEF,KAAK,cAAc,GAAG;IACpB,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB,CAAC;AAEF,KAAK,eAAe,GAAG;IACrB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,gBAAgB,CAAC,EAAE,OAAO,CAAC;CAC5B,CAAC;AAEF,cAAM,aAAa;IACX,SAAS,IAAI,OAAO,CAAC,eAAe,EAAE,CAAC;IAMvC,iBAAiB,CACrB,OAAO,EAAE,eAAe,GACvB,OAAO,CAAC,eAAe,EAAE,CAAC;IA0BvB,oBAAoB,CACxB,OAAO,EAAE,eAAe,GACvB,OAAO,CAAC,eAAe,EAAE,CAAC;IAiFvB,iBAAiB,IAAI,OAAO,CAAC,eAAe,EAAE,CAAC;IAgB/C,KAAK,CAAC,OAAO,GAAE;QAAC,IAAI,CAAC,EAAE,MAAM,CAAA;KAAM;IAuCzC,0BAA0B,CACxB,SAAS,EAAE,WAAW,EAAE,EACxB,GAAG,EAAE,WAAW,GACf,OAAO;IAUJ,aAAa,CACjB,OAAO,GAAE,oBAAyB,GACjC,OAAO,CAAC,0BAA0B,CAAC;IAwGtC,iBAAiB,CAAC,QAAQ,EAAE,aAAa,GAAG,WAAW;IAiBvD,OAAO,CAAC,0BAA0B;IAalC,OAAO,CAAC,wBAAwB;IA6ChC,OAAO,CAAC,mBAAmB;IAmBpB,kBAAkB,CACvB,QAAQ,EAAE,aAAa,EACvB,OAAO,GAAE;QAAC,KAAK,CAAC,EAAE,OAAO,CAAA;KAAM,GAC9B,QAAQ,CAAC,eAAe,CAAC;IAyC5B,kBAAkB,CAChB,aAAa,EAAE,aAAa,EAC5B,QAAQ,EAAE,aAAa,GACtB,QAAQ,CAAC,eAAe,CAAC;IA4BrB,aAAa,CAAC,QAAQ,EAAE,eAAe,GAAG,IAAI;IAWrD,OAAO,CAAC,oBAAoB;IAkB5B,OAAO,CAAC,mBAAmB;IAkB3B,eAAe,CACb,aAAa,EAAE,aAAa,EAC5B,QAAQ,EAAE,aAAa,EACvB,OAAO,GAAE,cAAmB,GAC3B,iBAAiB,EAAE;IAuDhB,cAAc,CAClB,aAAa,EAAE,aAAa,EAC5B,QAAQ,EAAE,aAAa,EACvB,OAAO,GAAE,cAAmB,GAC3B,OAAO,CAAC,iBAAiB,EAAE,CAAC;IA6B/B;;;;;;OAMG;IACH,kBAAkB,CAChB,SAAS,EAAE,aAAa,EACxB,QAAQ,EAAE,aAAa,GACtB,YAAY,EAAE;IAqCX,sBAAsB,CAC1B,QAAQ,EAAE,YAAY,EAAE,EACxB,OAAO,GAAE;QAAC,aAAa,CAAC,EAAE,OAAO,CAAA;KAAM;IAqBzC,gBAAgB,CACd,WAAW,EAAE,aAAa,EAC1B,QAAQ,EAAE,aAAa,EACvB,kBAAkB,EAAE,KAAK,CAAC,aAAa,CAAC,EACxC,EAAE,EAAE,MAAM,EACV,cAAc,EAAE,MAAM,EACtB,WAAW,EAAE,MAAM,EACnB,OAAO,GAAE,eAAoB;CA2ChC;;AAED,wBAAmC"}

package/dist/lib/HeapAnalyzer.js

@@ -49,13 +49,13 @@ class MemoryAnalyst {
             const controlSnapshotDirs = options.controlWorkDirs.map(controlWorkDir => FileManager_1.default.getCurDataDir({
                 workDir: controlWorkDir,
             }));
-            const treatmentSnapshotDir = FileManager_1.default.getCurDataDir({
-                workDir: options.treatmentWorkDir,
-            });
+            const treatmentSnapshotDirs = options.treatmentWorkDirs.map(treatmentWorkDir => FileManager_1.default.getCurDataDir({
+                workDir: treatmentWorkDir,
+            }));
             // check control working dir
             controlSnapshotDirs.forEach(controlSnapshotDir => Utils_1.default.checkSnapshots({ snapshotDir: controlSnapshotDir }));
             // check treatment working dir
-            Utils_1.default.checkSnapshots({ snapshotDir: treatmentSnapshotDir });
+            treatmentSnapshotDirs.forEach(treatmentSnapshotDir => Utils_1.default.checkSnapshots({ snapshotDir: treatmentSnapshotDir }));
             // display control and treatment memory
             MemoryBarChart_1.default.plotMemoryBarChart(options);
             return this.diffMemoryLeakTraces(options);
@@ -76,17 +76,26 @@ class MemoryAnalyst {
                 leakPathsFromControlRuns.push(this.filterLeakPaths(snapshotDiff.leakedHeapNodeIdSet, snapshotDiff.snapshot, { workDir: controlWorkDir }));
                 controlSnapshots.push(snapshotDiff.snapshot);
             }
-            // diff snapshots and get treatment raw paths
-            const snapshotDiff = yield this.diffSnapshots({
-                loadAllSnapshots: true,
-                workDir: options.treatmentWorkDir,
-            });
-            const treatmentLeakPaths = this.filterLeakPaths(snapshotDiff.leakedHeapNodeIdSet, snapshotDiff.snapshot, { workDir: options.treatmentWorkDir });
-            const treatmentSnapshot = snapshotDiff.snapshot;
+            // diff snapshots from treatment dirs and get treatment raw paths array
+            const treatmentSnapshots = [];
+            const leakPathsFromTreatmentRuns = [];
+            let firstTreatmentSnapshotDiff = null;
+            for (const treatmentWorkDir of options.treatmentWorkDirs) {
+                const snapshotDiff = yield this.diffSnapshots({
+                    loadAllSnapshots: true,
+                    workDir: treatmentWorkDir,
+                });
+                if (firstTreatmentSnapshotDiff == null) {
+                    firstTreatmentSnapshotDiff = snapshotDiff;
+                }
+                leakPathsFromTreatmentRuns.push(this.filterLeakPaths(snapshotDiff.leakedHeapNodeIdSet, snapshotDiff.snapshot, { workDir: treatmentWorkDir }));
+                treatmentSnapshots.push(snapshotDiff.snapshot);
+            }
             const controlPathCounts = JSON.stringify(leakPathsFromControlRuns.map(leakPaths => leakPaths.length));
+            const treatmentPathCounts = JSON.stringify(leakPathsFromTreatmentRuns.map(leakPaths => leakPaths.length));
             Console_1.default.topLevel(`${controlPathCounts} traces from control group`);
-            Console_1.default.topLevel(`${treatmentLeakPaths.length} traces from treatment group`);
-            const result = TraceBucket_1.default.clusterControlTreatmentPaths(leakPathsFromControlRuns, controlSnapshots, treatmentLeakPaths, treatmentSnapshot, Utils_1.default.aggregateDominatorMetrics, {
+            Console_1.default.topLevel(`${treatmentPathCounts} traces from treatment group`);
+            const result = TraceBucket_1.default.clusterControlTreatmentPaths(leakPathsFromControlRuns, controlSnapshots, leakPathsFromTreatmentRuns, treatmentSnapshots, Utils_1.default.aggregateDominatorMetrics, {
                 strategy: Config_1.default.isMLClustering
                     ? new MLTraceSimilarityStrategy_1.default()
                     : undefined,
@@ -95,7 +104,10 @@ class MemoryAnalyst {
             yield this.serializeClusterUpdate(result.treatmentOnlyClusters);
             // serialize JSON file with detailed leak trace information
             const treatmentOnlyPaths = result.treatmentOnlyClusters.map(c => c.path);
-            return LeakTraceDetailsLogger_1.default.logTraces(snapshotDiff.leakedHeapNodeIdSet, snapshotDiff.snapshot, snapshotDiff.listOfLeakedHeapNodeIdSet, treatmentOnlyPaths, Config_1.default.traceJsonOutDir);
+            if (firstTreatmentSnapshotDiff == null) {
+                throw Utils_1.default.haltOrThrow('treatemnt snapshot diff result not found');
+            }
+            return LeakTraceDetailsLogger_1.default.logTraces(firstTreatmentSnapshotDiff.leakedHeapNodeIdSet, firstTreatmentSnapshotDiff.snapshot, firstTreatmentSnapshotDiff.listOfLeakedHeapNodeIdSet, treatmentOnlyPaths, Config_1.default.traceJsonOutDir);
         });
     }
     // find all unique pattern of leaks

package/dist/lib/HeapParser.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"HeapParser.d.ts","sourceRoot":"","sources":["../../src/lib/HeapParser.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAIH,OAAO,KAAK,EAEV,aAAa,EAGd,MAAM,SAAS,CAAC;AAyCjB,iBAAe,kBAAkB,CAC/B,IAAI,EAAE,MAAM,EAEZ,QAAQ,KAAK,GACZ,OAAO,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC,CAatB;AA+CD,iBAAe,KAAK,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,KAAK,GAAG,OAAO,CAAC,aAAa,CAAC,CAKvE;;;;;AAED,wBAGE"}

package/dist/lib/InternalValueSetter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"InternalValueSetter.d.ts","sourceRoot":"","sources":["../../src/lib/InternalValueSetter.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAKH,gBAAgB;AAChB,8BAAsB,mBAAmB,CAAC,CAAC;IAEzC,MAAM,CAAC,OAAO,EAAE,CAAC,GAAG,CAAC;CAGtB;AAED,gBAAgB;AAChB,wBAAgB,gBAAgB,CAAC,CAAC,EAChC,KAAK,EAAE,CAAC,EACR,cAAc,EAAE,MAAM,EACtB,kBAAkB,EAAE,MAAM,GACzB,CAAC,CAmBH"}

package/dist/lib/NodeHeap.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"NodeHeap.d.ts","sourceRoot":"","sources":["../../src/lib/NodeHeap.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,KAAK,EAAC,aAAa,EAAC,MAAM,SAAS,CAAC;AAS3C;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAsCG;AACH,wBAAgB,SAAS,CAAC,CAAC,SAAS,MAAM,EAAE,CAAC,EAAE,CAAC,EAAE,GAAG,EAAE,MAAM,GAAG,CAAC,CAGhE;AAED;;;;;;;;;;;;;;;;;;;GAmBG;AACH,wBAAgB,oBAAoB,IAAI,MAAM,CAW7C;AAED;;;;;;;;;;;;;;;;;;;;;;GAsBG;AACH,wBAAsB,mBAAmB,IAAI,OAAO,CAAC,aAAa,CAAC,CASlE;AAED;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,wBAAsB,mBAAmB,IAAI,OAAO,CAAC,aAAa,CAAC,CASlE"}

package/dist/lib/PackageInfoLoader.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"PackageInfoLoader.d.ts","sourceRoot":"","sources":["../../src/lib/PackageInfoLoader.ts"],"names":[],"mappings":"AAeA,gBAAgB;AAChB,qBAAa,iBAAiB;IAC5B,OAAO,CAAC,MAAM,CAAC,kBAAkB,CAA0B;mBAEtC,QAAQ;WA0BT,eAAe,CAAC,gBAAgB,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;CAO7E"}

package/dist/lib/ProcessManager.d.ts

@@ -8,7 +8,7 @@
  * @oncall web_perf_infra
  */
 import type { Command, Optional } from './Types';
-declare type Options = {
+type Options = {
     msg?: string;
     processLimit?: number;
 };

package/dist/lib/ProcessManager.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ProcessManager.d.ts","sourceRoot":"","sources":["../../src/lib/ProcessManager.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,KAAK,EAAC,OAAO,EAAE,QAAQ,EAAC,MAAM,SAAS,CAAC;AAM/C,KAAK,OAAO,GAAG;IACb,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,YAAY,CAAC,EAAE,MAAM,CAAC;CACvB,CAAC;AAIF,cAAM,cAAc;IAClB,OAAO,CAAC,SAAS,CAAyB;IAC1C,OAAO,CAAC,KAAK,CAAK;IAGX,KAAK,CACV,WAAW,EAAE,MAAM,QAAQ,CAAC,OAAO,CAAC,EACpC,OAAO,GAAE,OAAY,GACpB,IAAI;IAeP,OAAO,CAAC,IAAI;IAMZ,OAAO,CAAC,cAAc;IAItB,OAAO,CAAC,WAAW;IAInB,OAAO,CAAC,YAAY;CAmBrB;AAED,eAAe,cAAc,CAAC"}

package/dist/lib/RunInfoUtils.d.ts

@@ -11,6 +11,7 @@ import type { Nullable, Optional, RunMetaInfo } from './Types';
 export declare class RunMetaInfoManager {
     getRunMetaFilePath(options?: {
         workDir?: Optional<string>;
+        readonly?: Optional<boolean>;
     }): string;
     saveRunMetaInfo(runMetaInfo: RunMetaInfo, options?: {
         workDir?: Optional<string>;

package/dist/lib/RunInfoUtils.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"RunInfoUtils.d.ts","sourceRoot":"","sources":["../../src/lib/RunInfoUtils.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AACH,OAAO,KAAK,EAAC,QAAQ,EAAE,QAAQ,EAAE,WAAW,EAAC,MAAM,SAAS,CAAC;AAU7D,qBAAa,kBAAkB;IAC7B,kBAAkB,CAAC,OAAO,CAAC,EAAE;QAC3B,OAAO,CAAC,EAAE,QAAQ,CAAC,MAAM,CAAC,CAAC;QAC3B,QAAQ,CAAC,EAAE,QAAQ,CAAC,OAAO,CAAC,CAAC;KAC9B,GAAG,MAAM;IAeV,eAAe,CACb,WAAW,EAAE,WAAW,EACxB,OAAO,CAAC,EAAE;QAAC,OAAO,CAAC,EAAE,QAAQ,CAAC,MAAM,CAAC,CAAC;QAAC,YAAY,CAAC,EAAE,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;KAAC,GACzE,MAAM;IAiBT,OAAO,CAAC,uBAAuB;IAS/B,eAAe,CAAC,OAAO,CAAC,EAAE;QACxB,QAAQ,CAAC,EAAE,QAAQ,CAAC,MAAM,CAAC,CAAC;QAC5B,OAAO,CAAC,EAAE,QAAQ,CAAC,MAAM,CAAC,CAAC;KAC5B,GAAG,WAAW;IAaf,yBAAyB,CAAC,OAAO,CAAC,EAAE;QAClC,QAAQ,CAAC,EAAE,QAAQ,CAAC,MAAM,CAAC,CAAC;QAC5B,OAAO,CAAC,EAAE,QAAQ,CAAC,MAAM,CAAC,CAAC;KAC5B,GAAG,QAAQ,CAAC,WAAW,CAAC;IAWzB,2BAA2B,IAAI,WAAW;IAO1C,oBAAoB,CAClB,OAAO,GAAE;QAAC,OAAO,CAAC,EAAE,QAAQ,CAAC,MAAM,CAAC,CAAC;QAAC,UAAU,CAAC,EAAE,OAAO,CAAA;KAAM,GAC/D,IAAI;CAiBR;AAED,QAAA,MAAM,YAAY;;CAAiD,CAAC;AAGpE,gBAAgB;AAChB,eAAe,YAAY,CAAC"}

package/dist/lib/RunInfoUtils.js

@@ -16,8 +16,10 @@ class RunMetaInfoManager {
         if ((options === null || options === void 0 ? void 0 : options.workDir) != null) {
             return FileManager_1.default.getRunMetaFile({ workDir: options.workDir });
         }
-        if (Config_1.default.useExternalSnapshot) {
-            return Config_1.default.externalRunMetaFile;
+        if ((options === null || options === void 0 ? void 0 : options.readonly) && Config_1.default.useExternalSnapshot) {
+            // only returns the template file if the
+            // run meta file is used for readonly purpose
+            return Config_1.default.externalRunMetaTemplateFile;
         }
         if (Config_1.default.runMetaFile != null) {
             return Config_1.default.runMetaFile;
@@ -40,7 +42,8 @@ class RunMetaInfoManager {
         return runMetaInfo;
     }
     loadRunMetaInfo(options) {
-        const file = (options === null || options === void 0 ? void 0 : options.metaFile) || this.getRunMetaFilePath(options);
+        const file = (options === null || options === void 0 ? void 0 : options.metaFile) ||
+            this.getRunMetaFilePath(Object.assign({ readonly: true }, options));
         try {
             return this.loadRunMetaInfoFromFile(file);
         }
@@ -49,7 +52,8 @@ class RunMetaInfoManager {
         }
     }
     loadRunMetaInfoSilentFail(options) {
-        const file = (options === null || options === void 0 ? void 0 : options.metaFile) || this.getRunMetaFilePath(options);
+        const file = (options === null || options === void 0 ? void 0 : options.metaFile) ||
+            this.getRunMetaFilePath(Object.assign({ readonly: true }, options));
         try {
             return this.loadRunMetaInfoFromFile(file);
         }

package/dist/lib/SerializationHelper.d.ts

@@ -0,0 +1,18 @@
+/**
+ * Copyright (c) Meta Platforms, Inc. and affiliates.
+ *
+ * This source code is licensed under the MIT license found in the
+ * LICENSE file in the root directory of this source tree.
+ *
+ * @format
+ * @oncall web_perf_infra
+ */
+import type { IHeapNode, IHeapSnapshot, ISerializationHelper, ISerializedInfo, JSONifyArgs, JSONifyOptions, Nullable } from './Types';
+export declare class SerializationHelper implements ISerializationHelper {
+    protected snapshot: Nullable<IHeapSnapshot>;
+    setSnapshot(snapshot: IHeapSnapshot): void;
+    createOrMergeWrapper(info: ISerializedInfo, _node: IHeapNode, _args: JSONifyArgs, _options: JSONifyOptions): ISerializedInfo;
+}
+declare const _default: typeof SerializationHelper;
+export default _default;
+//# sourceMappingURL=SerializationHelper.d.ts.map

package/dist/lib/SerializationHelper.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"SerializationHelper.d.ts","sourceRoot":"","sources":["../../src/lib/SerializationHelper.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,KAAK,EACV,SAAS,EACT,aAAa,EACb,oBAAoB,EACpB,eAAe,EACf,WAAW,EACX,cAAc,EACd,QAAQ,EACT,MAAM,SAAS,CAAC;AAKjB,qBAAa,mBAAoB,YAAW,oBAAoB;IAC9D,SAAS,CAAC,QAAQ,EAAE,QAAQ,CAAC,aAAa,CAAC,CAAQ;IAEnD,WAAW,CAAC,QAAQ,EAAE,aAAa,GAAG,IAAI;IAI1C,oBAAoB,CAClB,IAAI,EAAE,eAAe,EAErB,KAAK,EAAE,SAAS,EAEhB,KAAK,EAAE,WAAW,EAElB,QAAQ,EAAE,cAAc,GACvB,eAAe;CAGnB;;AAED,wBAIE"}

package/dist/lib/SerializationHelper.js

@@ -0,0 +1,36 @@
+"use strict";
+/**
+ * Copyright (c) Meta Platforms, Inc. and affiliates.
+ *
+ * This source code is licensed under the MIT license found in the
+ * LICENSE file in the root directory of this source tree.
+ *
+ * @format
+ * @oncall web_perf_infra
+ */
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.SerializationHelper = void 0;
+const InternalValueSetter_1 = require("./InternalValueSetter");
+const Constant_1 = __importDefault(require("./Constant"));
+class SerializationHelper {
+    constructor() {
+        this.snapshot = null;
+    }
+    setSnapshot(snapshot) {
+        this.snapshot = snapshot;
+    }
+    createOrMergeWrapper(info, 
+    // eslint-disable-next-line @typescript-eslint/no-unused-vars
+    _node, 
+    // eslint-disable-next-line @typescript-eslint/no-unused-vars
+    _args, 
+    // eslint-disable-next-line @typescript-eslint/no-unused-vars
+    _options) {
+        return info;
+    }
+}
+exports.SerializationHelper = SerializationHelper;
+exports.default = (0, InternalValueSetter_1.setInternalValue)(SerializationHelper, __filename, Constant_1.default.internalDir);

package/dist/lib/Serializer.d.ts

@@ -7,13 +7,9 @@
  * @format
  * @oncall web_perf_infra
  */
-import { E2EStepInfo, HeapNodeIdSet, IHeapEdge, IHeapNode, IHeapSnapshot, ISerializedInfo, LeakTracePathItem, Nullable } from './Types';
-declare type JSONifyArgs = {
-    leakedIdSet?: Set<number>;
-    nodeIdsInSnapshots?: Array<Set<number>>;
-};
-declare function JSONifyPath(path: LeakTracePathItem, _snapshot: IHeapSnapshot, args: JSONifyArgs): Nullable<ISerializedInfo>;
-declare type SummarizeOptions = {
+import { E2EStepInfo, HeapNodeIdSet, IHeapEdge, IHeapNode, IHeapSnapshot, ISerializedInfo, JSONifyArgs, LeakTracePathItem, Nullable } from './Types';
+declare function JSONifyPath(path: LeakTracePathItem, snapshot: IHeapSnapshot, args: JSONifyArgs): Nullable<ISerializedInfo>;
+type SummarizeOptions = {
     compact?: boolean;
     color?: boolean;
     progress?: number;
@@ -22,7 +18,7 @@ declare type SummarizeOptions = {
     excludeKeySet?: HeapNodeIdSet;
 };
 declare function summarizeNodeShape(node: IHeapNode, options?: SummarizeOptions): string;
-declare type UnboundedObjectInfo = {
+type UnboundedObjectInfo = {
     id: number;
     name: string;
     node: IHeapNode;

package/dist/lib/Serializer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Serializer.d.ts","sourceRoot":"","sources":["../../src/lib/Serializer.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAQH,OAAO,EACL,WAAW,EACX,aAAa,EACb,SAAS,EACT,SAAS,EACT,aAAa,EACb,eAAe,EACf,WAAW,EAEX,iBAAiB,EACjB,QAAQ,EAET,MAAM,SAAS,CAAC;AAycjB,iBAAS,WAAW,CAClB,IAAI,EAAE,iBAAiB,EACvB,QAAQ,EAAE,aAAa,EACvB,IAAI,EAAE,WAAW,GAChB,QAAQ,CAAC,eAAe,CAAC,CA6C3B;AA+ID,KAAK,gBAAgB,GAAG;IACtB,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,aAAa,CAAC,EAAE,aAAa,CAAC;CAC/B,CAAC;AA6BF,iBAAS,kBAAkB,CACzB,IAAI,EAAE,SAAS,EACf,OAAO,GAAE,gBAAqB,GAC7B,MAAM,CASR;AAED,KAAK,mBAAmB,GAAG;IACzB,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,SAAS,CAAC;IAChB,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,EAAE,CAAC;IAClB,sBAAsB,CAAC,EAAE,CAAC,CAAC,EAAE,MAAM,KAAK,MAAM,CAAC;CAChD,CAAC;AAEF,iBAAS,yBAAyB,CAChC,gBAAgB,EAAE,mBAAmB,EAAE,EACvC,OAAO,GAAE,gBAAqB,GAC7B,MAAM,CAgBR;AAED,iBAAS,8BAA8B,CACrC,gBAAgB,EAAE,mBAAmB,EAAE,GACtC,MAAM,CAMR;AAiBD,iBAAS,kBAAkB,CACzB,SAAS,EAAE,WAAW,EAAE,EACxB,OAAO,GAAE,gBAAqB,GAC7B,MAAM,CAuBR;AAED,iBAAS,iBAAiB,CAAC,IAAI,EAAE,SAAS,EAAE,OAAO,EAAE,gBAAgB,GAAG,MAAM,CAI7E;AAoBD,iBAAS,iBAAiB,CACxB,IAAI,EAAE,SAAS,EACf,OAAO,GAAE,gBAAqB,GAC7B,MAAM,CAeR;AAkBD,iBAAS,aAAa,CACpB,OAAO,EAAE,iBAAiB,EAC1B,aAAa,EAAE,GAAG,CAAC,MAAM,CAAC,EAC1B,QAAQ,EAAE,aAAa,EACvB,OAAO,GAAE,gBAAqB,GAC7B,MAAM,CA2ER;;;;;;;;;;;AAED,wBASE"}

package/dist/lib/Serializer.js

@@ -18,6 +18,7 @@ const Config_1 = __importDefault(require("./Config"));
 const Utils_1 = __importDefault(require("./Utils"));
 const Console_1 = __importDefault(require("./Console"));
 const TraceFinder_1 = __importDefault(require("../paths/TraceFinder"));
+const SerializationHelper_1 = __importDefault(require("./SerializationHelper"));
 const REGEXP_NAME_CLEANUP = /[[]\(\)]/g;
 const EMPTY_JSONIFY_OPTIONS = {
     fiberNodeReturnTrace: {},
@@ -374,7 +375,12 @@ function JSONifyNode(node, args, options) {
     if (node.dominatorNode) {
         info['dominator id (extra)'] = `@${node.dominatorNode.id}`;
     }
-    return info;
+    // use serialization helper to wrap around
+    // the JSON node with additional tagging information
+    const { serializationHelper } = options;
+    return serializationHelper
+        ? serializationHelper.createOrMergeWrapper(info, node, args, options)
+        : info;
 }
 function JSONifyTabsOrder() {
     const file = Utils_1.default.getSnapshotSequenceFilePath();
@@ -383,7 +389,7 @@ function JSONifyTabsOrder() {
 function shouldHighlight(node) {
     return Utils_1.default.isDetachedDOMNode(node) || Utils_1.default.isDetachedFiberNode(node);
 }
-function JSONifyPath(path, _snapshot, args) {
+function JSONifyPath(path, snapshot, args) {
     if (!path.node) {
         return null;
     }
@@ -393,6 +399,9 @@ function JSONifyPath(path, _snapshot, args) {
     ret['$tabsOrder:' + JSONifyTabsOrder()] = '';
     ret[`${idx++}: ${getNodeNameInJSON(path.node, args)}`] = JSONifyNode(path.node, args, Object.assign(Object.assign({}, EMPTY_JSONIFY_OPTIONS), { processedNodeId: new Set() }));
     let pathItem = path;
+    // initialize serialization helper
+    const serializationHelper = new SerializationHelper_1.default();
+    serializationHelper.setSnapshot(snapshot);
     while (pathItem === null || pathItem === void 0 ? void 0 : pathItem.edge) {
         const edge = pathItem.edge;
         const nextNode = edge.toNode;
@@ -401,7 +410,7 @@ function JSONifyPath(path, _snapshot, args) {
             nextNode.highlight = true;
         }
         const edgeRetainSize = pathItem.edgeRetainSize;
-        ret[`${idx++}: ${getEdgeNameInJSON(edge, edgeRetainSize)}${getNodeNameInJSON(nextNode, args)}`] = JSONifyNode(nextNode, args, Object.assign(Object.assign({}, EMPTY_JSONIFY_OPTIONS), { processedNodeId: new Set() }));
+        ret[`${idx++}: ${getEdgeNameInJSON(edge, edgeRetainSize)}${getNodeNameInJSON(nextNode, args)}`] = JSONifyNode(nextNode, args, Object.assign(Object.assign({}, EMPTY_JSONIFY_OPTIONS), { processedNodeId: new Set(), serializationHelper }));
         pathItem = pathItem.next;
     }
     return ret;

package/dist/lib/StringLoader.d.ts

@@ -9,12 +9,12 @@
  * @oncall web_perf_infra
  */
 /// <reference types="node" />
-declare type ReadFileOptions = {
+type ReadFileOptions = {
     startSignature?: string;
     endSignature?: string;
     inclusive?: boolean;
 };
-declare type NodeFSError = NodeJS.ErrnoException | null;
+type NodeFSError = NodeJS.ErrnoException | null;
 declare class StringLoader {
     processErrorIfNotNull(err: NodeFSError): void;
     readFile(file: string, options?: ReadFileOptions): Promise<string>;

package/dist/lib/StringLoader.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"StringLoader.d.ts","sourceRoot":"","sources":["../../src/lib/StringLoader.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;;AAYH,KAAK,eAAe,GAAG;IACrB,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,SAAS,CAAC,EAAE,OAAO,CAAC;CACrB,CAAC;AAEF,KAAK,WAAW,GAAG,MAAM,CAAC,cAAc,GAAG,IAAI,CAAC;AAIhD,cAAM,YAAY;IAChB,qBAAqB,CAAC,GAAG,EAAE,WAAW,GAAG,IAAI;IAY7C,QAAQ,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,GAAE,eAAoB,GAAG,OAAO,CAAC,MAAM,CAAC;IAkFtE,4BAA4B,CAC1B,IAAI,EAAE,MAAM,EACZ,cAAc,EAAE,MAAM,EAAE,GACvB,OAAO,CAAC,MAAM,CAAC;IA8FlB,4BAA4B,CAC1B,IAAI,EAAE,MAAM,EACZ,KAAK,EAAE,MAAM,GACZ,OAAO,CAAC,WAAW,CAAC;CAmHxB;;AAED,wBAAkC"}