@genome-spy/core 0.67.0 → 0.69.0

package/dist/src/data/collector.d.ts

@@ -19,6 +19,19 @@ export default class Collector extends FlowNode {
      * @returns {() => void}
      */
     observe(listener: (arg0: Collector) => void): () => void;
+    /**
+     * @param {string} domainKey
+     * @param {import("../spec/channel.js").Type} type
+     * @param {import("../types/encoder.js").Accessor} accessor
+     * @returns {import("../utils/domainArray.js").DomainArray}
+     */
+    getDomain(domainKey: string, type: import("../spec/channel.js").Type, accessor: import("../types/encoder.js").Accessor): import("../utils/domainArray.js").DomainArray;
+    /**
+     * @param {string} domainKey
+     * @param {() => void} listener
+     * @returns {() => void}
+     */
+    subscribeDomainChanges(domainKey: string, listener: () => void): () => void;
     /**
      * @returns {Iterable<Datum>}
      */
@@ -38,6 +51,13 @@ export default class Collector extends FlowNode {
      * @param {number} uniqueId
      */
     findDatumByUniqueId(uniqueId: number): import("./flowNode.js").Datum;
+    /**
+     * Uses a lazy index to find a datum by its key fields.
+     *
+     * @param {string[]} keyFields
+     * @param {import("../spec/channel.js").Scalar[]} keyTuple
+     */
+    findDatumByKey(keyFields: string[], keyTuple: import("../spec/channel.js").Scalar[]): import("./flowNode.js").Datum;
     #private;
 }
 import FlowNode from "./flowNode.js";

package/dist/src/data/collector.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"collector.d.ts","sourceRoot":"","sources":["../../../src/data/collector.js"],"names":[],"mappings":"AAUA;;;;;GAKG;AACH;IAuCI;;OAEG;IACH,qBAFW,OAAO,sBAAsB,EAAE,aAAa,EAiBtD;IAZG,qDAA2C;IAE3C,4CAA4C;IAC5C,WADW,GAAG,CAAC,CAAS,IAAS,EAAT,SAAS,KAAE,IAAI,CAAC,CACd;IAG1B,yFAAyF;IACzF,cADW,GAAG,CAAC,OAAO,oBAAoB,EAAE,MAAM,EAAE,+BAAO,CACN;IAmFzD;;;OAGG;IACH,kBAHW,CAAS,IAAS,EAAT,SAAS,KAAE,IAAI,GACtB,MAAM,IAAI,CAOtB;IA+BD;;OAEG;IACH,WAFa,QAAQ,+BAAO,CAqB3B;IAED;;;OAGG;IACH,mBAFW,CAAC,KAAK,+BAAO,KAAK,IAAI,QAUhC;IAED;;OAEG;IACH,uBAMC;IA8CD;;;;OAIG;IACH,8BAFW,MAAM,iCA4BhB;;CACJ;qBAxTyD,eAAe"}
+{"version":3,"file":"collector.d.ts","sourceRoot":"","sources":["../../../src/data/collector.js"],"names":[],"mappings":"AAYA;;;;;GAKG;AACH;IA6CI;;OAEG;IACH,qBAFW,OAAO,sBAAsB,EAAE,aAAa,EAiBtD;IAZG,qDAA2C;IAE3C,4CAA4C;IAC5C,WADW,GAAG,CAAC,CAAS,IAAS,EAAT,SAAS,KAAE,IAAI,CAAC,CACd;IAG1B,yFAAyF;IACzF,cADW,GAAG,CAAC,OAAO,oBAAoB,EAAE,MAAM,EAAE,+BAAO,CACN;IAwFzD;;;OAGG;IACH,kBAHW,CAAS,IAAS,EAAT,SAAS,KAAE,IAAI,GACtB,MAAM,IAAI,CAOtB;IAiCD;;;;;OAKG;IACH,qBALW,MAAM,QACN,OAAO,oBAAoB,EAAE,IAAI,YACjC,OAAO,qBAAqB,EAAE,QAAQ,GACpC,OAAO,yBAAyB,EAAE,WAAW,CAkBzD;IAED;;;;OAIG;IACH,kCAJW,MAAM,YACN,MAAM,IAAI,GACR,MAAM,IAAI,CAItB;IAED;;OAEG;IACH,WAFa,QAAQ,+BAAO,CAqB3B;IAED;;;OAGG;IACH,mBAFW,CAAC,KAAK,+BAAO,KAAK,IAAI,QAUhC;IAED;;OAEG;IACH,uBAMC;IAqDD;;;;OAIG;IACH,8BAFW,MAAM,iCA4BhB;IAED;;;;;OAKG;IACH,0BAHW,MAAM,EAAE,YACR,OAAO,oBAAoB,EAAE,MAAM,EAAE,iCAS/C;;CACJ;qBA9XyD,eAAe"}

package/dist/src/data/collector.js

@@ -7,6 +7,8 @@ import { field } from "../utils/field.js";
 import { asArray } from "../utils/arrayUtils.js";
 import { radixSortIntoLookupArray } from "../utils/radixSort.js";
 import { UNIQUE_ID_KEY } from "./transforms/identifier.js";
+import createDomain from "../utils/domainArray.js";
+import KeyIndex from "./keyIndex.js";
 
 /**
  * Collects (materializes) the data that flows through this node.
@@ -33,6 +35,9 @@ export default class Collector extends FlowNode {
      */
     #uniqueIdIndex = [];
 
+    /** @type {KeyIndex} */
+    #keyIndex = new KeyIndex();
+
     /**
      * Start and end indices of all facets if they are concatenated into a single array.
      * Used together with the uniqueIdIndex for looking up data items by their unique id.
@@ -45,6 +50,9 @@ export default class Collector extends FlowNode {
      */
     #comparator;
 
+    /** @type {DomainCache} */
+    #domainCache = new DomainCache();
+
     get behavior() {
         return BEHAVIOR_COLLECTS;
     }
@@ -76,6 +84,7 @@ export default class Collector extends FlowNode {
     #init() {
         this.#buffer = [];
         this.#uniqueIdIndex = [];
+        this.#keyIndex.invalidate();
 
         this.facetBatches.clear();
         this.facetBatches.set(undefined, this.#buffer);
@@ -97,6 +106,8 @@ export default class Collector extends FlowNode {
      * @param {import("../types/flowBatch.js").FlowBatch} flowBatch
      */
     beginBatch(flowBatch) {
+        this.#keyIndex.invalidate();
+
         if (isFacetBatch(flowBatch)) {
             this.#buffer = [];
             this.facetBatches.set(asArray(flowBatch.facetId), this.#buffer);
@@ -144,6 +155,8 @@ export default class Collector extends FlowNode {
 
         super.complete();
 
+        this.#invalidateDomains();
+
         for (const observer of this.observers) {
             observer(this);
         }
@@ -187,6 +200,41 @@ export default class Collector extends FlowNode {
         for (const child of this.children) {
             child.complete();
         }
+
+        this.#invalidateDomains();
+    }
+
+    /**
+     * @param {string} domainKey
+     * @param {import("../spec/channel.js").Type} type
+     * @param {import("../types/encoder.js").Accessor} accessor
+     * @returns {import("../utils/domainArray.js").DomainArray}
+     */
+    getDomain(domainKey, type, accessor) {
+        return this.#domainCache.getDomain(domainKey, () => {
+            const domain = createDomain(type);
+
+            if (accessor.constant) {
+                domain.extend(accessor({}));
+            } else if (this.completed) {
+                for (const data of this.facetBatches.values()) {
+                    for (let i = 0, n = data.length; i < n; i++) {
+                        domain.extend(accessor(data[i]));
+                    }
+                }
+            }
+
+            return domain;
+        });
+    }
+
+    /**
+     * @param {string} domainKey
+     * @param {() => void} listener
+     * @returns {() => void}
+     */
+    subscribeDomainChanges(domainKey, listener) {
+        return this.#domainCache.subscribe(domainKey, listener);
     }
 
     /**
@@ -246,6 +294,13 @@ export default class Collector extends FlowNode {
         }
     }
 
+    #invalidateDomains() {
+        if (this.#domainCache.hasCachedDomains()) {
+            this.#domainCache.clear();
+        }
+        this.#domainCache.notify();
+    }
+
     /**
      * Builds an index for looking up data items by their unique id.
      * Using a sorted index and binary search for O(log n) complexity.
@@ -314,6 +369,99 @@ export default class Collector extends FlowNode {
             }
         }
     }
+
+    /**
+     * Uses a lazy index to find a datum by its key fields.
+     *
+     * @param {string[]} keyFields
+     * @param {import("../spec/channel.js").Scalar[]} keyTuple
+     */
+    findDatumByKey(keyFields, keyTuple) {
+        this.#checkStatus();
+        return this.#keyIndex.findDatum(
+            keyFields,
+            keyTuple,
+            this.facetBatches.values()
+        );
+    }
+}
+
+/**
+ * Manages cached domains and subscriptions for invalidation.
+ */
+class DomainCache {
+    /** @type {Map<string, import("../utils/domainArray.js").DomainArray>} */
+    #cache = new Map();
+
+    /** @type {Map<string, Set<() => void>>} */
+    #observers = new Map();
+
+    hasCachedDomains() {
+        return this.#cache.size > 0;
+    }
+
+    clear() {
+        this.#cache.clear();
+    }
+
+    /**
+     * @param {string} domainKey
+     * @param {() => import("../utils/domainArray.js").DomainArray} build
+     * @returns {import("../utils/domainArray.js").DomainArray}
+     */
+    getDomain(domainKey, build) {
+        const cached = this.#cache.get(domainKey);
+        if (cached) {
+            return cached;
+        } else {
+            const domain = build();
+            this.#cache.set(domainKey, domain);
+            return domain;
+        }
+    }
+
+    /**
+     * @param {string} domainKey
+     * @param {() => void} listener
+     * @returns {() => void}
+     */
+    subscribe(domainKey, listener) {
+        let listeners = this.#observers.get(domainKey);
+        if (!listeners) {
+            listeners = new Set();
+            this.#observers.set(domainKey, listeners);
+        }
+        listeners.add(listener);
+
+        return () => {
+            const entry = this.#observers.get(domainKey);
+            if (!entry) {
+                return;
+            }
+            entry.delete(listener);
+            if (entry.size === 0) {
+                this.#observers.delete(domainKey);
+            }
+        };
+    }
+
+    notify() {
+        if (this.#observers.size === 0) {
+            return;
+        }
+
+        /** @type {Set<() => void>} */
+        const listeners = new Set();
+        for (const observers of this.#observers.values()) {
+            for (const observer of observers) {
+                listeners.add(observer);
+            }
+        }
+
+        for (const listener of listeners) {
+            listener();
+        }
+    }
 }
 
 /**

package/dist/src/data/dataFlow.d.ts

@@ -2,6 +2,12 @@
  * DataFlow holds data sources and collectors for optimization and initialization.
  */
 export default class DataFlow {
+    /**
+     * Registry for per-view loading status. The host may replace this.
+     *
+     * @type {import("../genomeSpy/loadingStatusRegistry.js").default}
+     */
+    loadingStatusRegistry: import("../genomeSpy/loadingStatusRegistry.js").default;
     get dataSources(): DataSource[];
     get collectors(): import("./collector.js").default[];
     /**

package/dist/src/data/dataFlow.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"dataFlow.d.ts","sourceRoot":"","sources":["../../../src/data/dataFlow.js"],"names":[],"mappings":"AAGA;;GAEG;AACH;IAeI,gCAEC;IAED,qDAEC;IAED;;OAEG;IACH,gCAFW,QAAQ,CAAC,OAAO,yBAAyB,EAAE,OAAO,CAAC,QAI7D;IAED;;OAEG;IACH,0BAFW,OAAO,yBAAyB,EAAE,OAAO,QAInD;IAED;;OAEG;IACH,6BAFW,OAAO,yBAAyB,EAAE,OAAO,QAInD;IAED;;OAEG;IACH,wBAFW,OAAO,gBAAgB,EAAE,OAAO,QAI1C;IAED;;OAEG;IACH,2BAFW,OAAO,gBAAgB,EAAE,OAAO,QAK1C;IAED;;;;OAIG;IACH,gCAFW,OAAO,gBAAgB,EAAE,OAAO,QAiB1C;IAED;;OAEG;IACH,0BAFW,MAAM;;MA2BhB;;CAGJ;uBAtHsB,yBAAyB;wBACxB,0BAA0B"}
+{"version":3,"file":"dataFlow.d.ts","sourceRoot":"","sources":["../../../src/data/dataFlow.js"],"names":[],"mappings":"AAIA;;GAEG;AACH;IAOI;;;;OAIG;IACH,uBAFU,OAAO,uCAAuC,EAAE,OAAO,CAE3C;IAYtB,gCAEC;IAED,qDAEC;IAED;;OAEG;IACH,gCAFW,QAAQ,CAAC,OAAO,yBAAyB,EAAE,OAAO,CAAC,QAI7D;IAED;;OAEG;IACH,0BAFW,OAAO,yBAAyB,EAAE,OAAO,QAInD;IAED;;OAEG;IACH,6BAFW,OAAO,yBAAyB,EAAE,OAAO,QAKnD;IAED;;OAEG;IACH,wBAFW,OAAO,gBAAgB,EAAE,OAAO,QAI1C;IAED;;OAEG;IACH,2BAFW,OAAO,gBAAgB,EAAE,OAAO,QAS1C;IAED;;;;OAIG;IACH,gCAFW,OAAO,gBAAgB,EAAE,OAAO,QAsB1C;IAED;;OAEG;IACH,0BAFW,MAAM;;MA2BhB;;CAGJ;uBAzIsB,yBAAyB;wBACxB,0BAA0B"}

package/dist/src/data/dataFlow.js

@@ -1,3 +1,4 @@
+import LoadingStatusRegistry from "../genomeSpy/loadingStatusRegistry.js";
 import DataSource from "./sources/dataSource.js";
 import NamedSource from "./sources/namedSource.js";
 
@@ -11,12 +12,21 @@ export default class DataFlow {
     /** @type {Set<import("./collector.js").default>} */
     #collectors;
 
+    /**
+     * Registry for per-view loading status. The host may replace this.
+     *
+     * @type {import("../genomeSpy/loadingStatusRegistry.js").default}
+     */
+    loadingStatusRegistry;
+
     constructor() {
         /** @type {Set<import("./sources/dataSource.js").default>} */
         this.#dataSources = new Set();
 
         /** @type {Set<import("./collector.js").default>} */
         this.#collectors = new Set();
+
+        this.loadingStatusRegistry = new LoadingStatusRegistry();
     }
 
     get dataSources() {
@@ -45,6 +55,7 @@ export default class DataFlow {
      * @param {import("./sources/dataSource.js").default} dataSource
      */
     removeDataSource(dataSource) {
+        dataSource.disposeSubtree();
         this.#dataSources.delete(dataSource);
     }
 
@@ -59,6 +70,10 @@ export default class DataFlow {
      * @param {import("./collector.js").default} collector
      */
     removeCollector(collector) {
+        if (collector.parent) {
+            collector.parent.removeChild(collector);
+        }
+        collector.disposeSubtree();
         collector.observers.clear();
         this.#collectors.delete(collector);
     }
@@ -74,13 +89,18 @@ export default class DataFlow {
             parent.removeChild(collector);
         }
 
+        collector.disposeSubtree();
+
         while (parent && parent.children.length === 0) {
             const current = parent;
             parent = current.parent;
             if (parent) {
                 parent.removeChild(current);
+                current.dispose();
             } else if (current instanceof DataSource) {
                 this.removeDataSource(current);
+            } else {
+                current.dispose();
             }
         }
     }

package/dist/src/data/flowInit.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"flowInit.d.ts","sourceRoot":"","sources":["../../../src/data/flowInit.js"],"names":[],"mappings":"AAyDA;;;;;GAKG;AACH,sCAHW,OAAO,iBAAiB,EAAE,OAAO,qBACjC,GAAG,CAAC,OAAO,yBAAyB,EAAE,OAAO,EAAE,OAAO,yBAAyB,EAAE,OAAO,CAAC,QAcnG;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA8CG;AACH,mDAXW,OAAO,iBAAiB,EAAE,OAAO,QACjC,OAAO,eAAe,EAAE,OAAO,eAC/B,CAAC,IAAI,EAAE,OAAO,iBAAiB,EAAE,OAAO,KAAK,OAAO,gCACpD,CAAC,IAAI,EAAE,OAAO,iBAAiB,EAAE,OAAO,KAAK,OAAO,GAClD;IACN,QAAQ,EAAE,OAAO,eAAe,EAAE,OAAO,CAAC;IAC1C,SAAS,EAAE,QAAQ,EAAE,CAAC;IACtB,WAAW,EAAE,GAAG,CAAC,OAAO,yBAAyB,EAAE,OAAO,CAAC,CAAC;IAC5D,gBAAgB,EAAE,OAAO,CAAC,OAAO,kBAAkB,EAAE,OAAO,CAAC,EAAE,CAAA;CAClE,CA4FH;AAED;;;;;;;GAOG;AACH,2DAJW,OAAO,iBAAiB,EAAE,OAAO,GAAG,OAAO,iBAAiB,EAAE,OAAO,EAAE,eACvE,CAAC,IAAI,EAAE,OAAO,iBAAiB,EAAE,OAAO,KAAK,OAAO,GAClD,GAAG,CAAC,OAAO,yBAAyB,EAAE,OAAO,CAAC,CAsB1D;AAED;;;;;;;GAOG;AACH,kEAJW,OAAO,iBAAiB,EAAE,OAAO,eACjC,CAAC,IAAI,EAAE,OAAO,iBAAiB,EAAE,OAAO,KAAK,OAAO,GAClD,GAAG,CAAC,OAAO,yBAAyB,EAAE,OAAO,CAAC,CAe1D;AAED;;;;;;;;;GASG;AACH,iDANW,OAAO,iBAAiB,EAAE,OAAO,gBACjC,GAAG,CAAC,OAAO,yBAAyB,EAAE,OAAO,CAAC,eAC9C,CAAC,IAAI,EAAE,OAAO,iBAAiB,EAAE,OAAO,KAAK,OAAO,gBACpD;IAAE,WAAW,CAAC,EAAE,OAAO,CAAA;CAAE,GACvB,OAAO,CAAC,IAAI,EAAE,CAAC,CAuB3B;qBA5SoB,qBAAqB"}
+{"version":3,"file":"flowInit.d.ts","sourceRoot":"","sources":["../../../src/data/flowInit.js"],"names":[],"mappings":"AAwDA;;;;;GAKG;AACH,sCAHW,OAAO,iBAAiB,EAAE,OAAO,qBACjC,GAAG,CAAC,OAAO,yBAAyB,EAAE,OAAO,EAAE,OAAO,yBAAyB,EAAE,OAAO,CAAC,QAcnG;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA8CG;AACH,mDAXW,OAAO,iBAAiB,EAAE,OAAO,QACjC,OAAO,eAAe,EAAE,OAAO,eAC/B,CAAC,IAAI,EAAE,OAAO,iBAAiB,EAAE,OAAO,KAAK,OAAO,gCACpD,CAAC,IAAI,EAAE,OAAO,iBAAiB,EAAE,OAAO,KAAK,OAAO,GAClD;IACN,QAAQ,EAAE,OAAO,eAAe,EAAE,OAAO,CAAC;IAC1C,SAAS,EAAE,QAAQ,EAAE,CAAC;IACtB,WAAW,EAAE,GAAG,CAAC,OAAO,yBAAyB,EAAE,OAAO,CAAC,CAAC;IAC5D,gBAAgB,EAAE,OAAO,CAAC,OAAO,kBAAkB,EAAE,OAAO,CAAC,EAAE,CAAA;CAClE,CA6FH;AAED;;;;;;;GAOG;AACH,2DAJW,OAAO,iBAAiB,EAAE,OAAO,GAAG,OAAO,iBAAiB,EAAE,OAAO,EAAE,eACvE,CAAC,IAAI,EAAE,OAAO,iBAAiB,EAAE,OAAO,KAAK,OAAO,GAClD,GAAG,CAAC,OAAO,yBAAyB,EAAE,OAAO,CAAC,CAsB1D;AAED;;;;;;;GAOG;AACH,kEAJW,OAAO,iBAAiB,EAAE,OAAO,eACjC,CAAC,IAAI,EAAE,OAAO,iBAAiB,EAAE,OAAO,KAAK,OAAO,GAClD,GAAG,CAAC,OAAO,yBAAyB,EAAE,OAAO,CAAC,CAe1D;AAED;;;;;;;;;GASG;AACH,iDANW,OAAO,iBAAiB,EAAE,OAAO,gBACjC,GAAG,CAAC,OAAO,yBAAyB,EAAE,OAAO,CAAC,eAC9C,CAAC,IAAI,EAAE,OAAO,iBAAiB,EAAE,OAAO,KAAK,OAAO,gBACpD;IAAE,WAAW,CAAC,EAAE,OAAO,CAAA;CAAE,GACvB,OAAO,CAAC,IAAI,EAAE,CAAC,CAsB3B;qBA3SoB,qBAAqB"}

package/dist/src/data/flowInit.js

@@ -2,7 +2,6 @@ import UnitView from "../view/unitView.js";
 import { buildDataFlow } from "../view/flowBuilder.js";
 import { optimizeDataFlow } from "./flowOptimizer.js";
 import { VISIT_SKIP } from "../view/view.js";
-import { reconfigureScaleDomains } from "../scales/scaleResolution.js";
 
 /** @type {WeakMap<import("./sources/dataSource.js").default, Promise<void>>} */
 const inFlightLoads = new WeakMap();
@@ -163,7 +162,7 @@ export function initializeViewSubtree(
 
     // Initialize flow nodes for the sources that belong to this subtree.
     for (const dataSource of dataSources) {
-        dataSource.visit((node) => node.initialize());
+        dataSource.visit((node) => node.initializeOnce());
     }
 
     /** @type {UnitView[]} */
@@ -180,6 +179,7 @@ export function initializeViewSubtree(
         const mark = view.mark;
         // Encoders can be initialized immediately; graphics need a GL context.
         mark.initializeEncoders();
+        view.registerDomainSubscriptions();
         if (canInitializeGraphics) {
             graphicsPromises.push(mark.initializeGraphics().then(() => mark));
         }
@@ -294,7 +294,6 @@ export function loadViewSubtreeData(
             loadDataSourceOnce(dataSource, loadOptions)
         )
     ).then((results) => {
-        reconfigureScaleDomains(subtreeRoot, viewFilter);
         broadcastSubtreeDataReady(subtreeRoot);
         return results;
     });

package/dist/src/data/flowNode.d.ts

@@ -24,7 +24,7 @@ export const BEHAVIOR_MODIFIES: number;
  */
 export const BEHAVIOR_COLLECTS: number;
 /**
- * @typedef {{paramMediator: import("../view/paramMediator.js").default}} ParamMediatorProvider
+ * @typedef {{paramRuntime?: import("../paramRuntime/viewParamRuntime.js").default}} ParamRuntimeProvider
  */
 /**
  * This is heavily inspired by Vega's and Vega-Lite's data flow system.
@@ -34,20 +34,20 @@ export const BEHAVIOR_COLLECTS: number;
  */
 export default class FlowNode {
     /**
-     * @param {ParamMediatorProvider} [paramMediatorProvider]
+     * @param {ParamRuntimeProvider} [paramRuntimeProvider]
      */
-    constructor(paramMediatorProvider?: ParamMediatorProvider);
+    constructor(paramRuntimeProvider?: ParamRuntimeProvider);
     stats: {
         count: number;
         /** @type {Datum} */
         first: Datum;
     };
     /**
-     * An object that provides a paramMediator. (Most likely a View)
+     * An object that provides a paramRuntime. (Most likely a View)
      *
-     * @type {ParamMediatorProvider}
+     * @type {ParamRuntimeProvider}
      */
-    paramMediatorProvider: ParamMediatorProvider;
+    paramRuntimeProvider: ParamRuntimeProvider;
     get behavior(): number;
     /**
      * A human-readable label for the node. Used for debugging and logging.
@@ -61,6 +61,7 @@ export default class FlowNode {
     parent: FlowNode;
     /** True if all data have been processed */
     completed: boolean;
+    get disposed(): boolean;
     /**
      * Resets the node and all its descendants to their initial state, i.e., preparing
      * for a new batch of data.
@@ -69,8 +70,16 @@ export default class FlowNode {
     /**
      * Allows for doing final initialization after the flow structure has been
      * built and optimized. Must be called before any data are to be propagated.
+     * Note: Some transforms call initialize() from reset() to rebuild internal
+     * fast paths per batch. Use initializeOnce() for graph-level init to avoid
+     * double-initialization issues.
      */
     initialize(): void;
+    /**
+     * Calls initialize() once per node instance. Intended for graph-level init
+     * passes that should not rerun when reusing existing branches.
+     */
+    initializeOnce(): void;
     /**
      * @param {Datum} datum
      * @protected
@@ -129,6 +138,20 @@ export default class FlowNode {
      */
     handle(datum: Datum): void;
     complete(): void;
+    /**
+     * Register a disposer to be executed when this node is disposed.
+     *
+     * @param {() => void} disposer
+     */
+    registerDisposer(disposer: () => void): void;
+    /**
+     * Release resources owned by this flow node.
+     */
+    dispose(): void;
+    /**
+     * Dispose this flow node and all descendants in post-order.
+     */
+    disposeSubtree(): void;
     /**
      * Signals that a new batch of data will be propagated.
      *
@@ -136,10 +159,10 @@ export default class FlowNode {
      */
     beginBatch(flowBatch: import("../types/flowBatch.js").FlowBatch): void;
     /**
-     * @returns {import("../view/paramMediator.js").default}
+     * @returns {import("../paramRuntime/viewParamRuntime.js").default}
      * @protected
      */
-    protected get paramMediator(): import("../view/paramMediator.js").default;
+    protected get paramRuntime(): import("../paramRuntime/viewParamRuntime.js").default;
     /**
      * Repropagates the stored data. If this node has no stored data,
      * find the nearest ancestor that has and repropagate from there.
@@ -148,8 +171,8 @@ export default class FlowNode {
     protected repropagate(): void;
     #private;
 }
-export type ParamMediatorProvider = {
-    paramMediator: import("../view/paramMediator.js").default;
+export type ParamRuntimeProvider = {
+    paramRuntime?: import("../paramRuntime/viewParamRuntime.js").default;
 };
 /**
  * This is heavily inspired by Vega's and Vega-Lite's data flow system.

package/dist/src/data/flowNode.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"flowNode.d.ts","sourceRoot":"","sources":["../../../src/data/flowNode.js"],"names":[],"mappings":"AAuUA;;;GAGG;AACH,uCAHW,OAAO,uBAAuB,EAAE,SAAS,GACvC,SAAS,IAAI,OAAO,uBAAuB,EAAE,SAAS,CAIlE;AAED;;;GAGG;AACH,wCAHW,OAAO,uBAAuB,EAAE,SAAS,GACvC,SAAS,IAAI,OAAO,uBAAuB,EAAE,UAAU,CAInE;AAnVD;;;GAGG;AACH,qCAAsC;AAEtC;;;GAGG;AACH,uCAAwC;AAExC;;;GAGG;AACH,uCAAwC;AAExC;;GAEG;AAEH;;;;;GAKG;AACH;IA2BI;;OAEG;IACH,oCAFW,qBAAqB,EAa/B;IAxCD;;QAEI,oBAAoB;eAAT,KAAK;MAElB;IAEF;;;;OAIG;IACH,uBAFU,qBAAqB,CAEF;IAE7B,uBAEC;IAED;;;;OAIG;IACH,aAFa,MAAM,CAIlB;IAQG,yBAAyB;IACzB,UADW,QAAQ,EAAE,CACH;IAElB,uBAAuB;IACvB,QADW,QAAQ,CACI;IAEvB,2CAA2C;IAC3C,mBAAsB;IAG1B;;;OAGG;IACH,cASC;IAED;;;OAGG;IACH,mBAEC;IAgOD;;;OAGG;IACH,4BAHW,KAAK,QAKf;IA7MD;;;OAGG;IACH,kBAFW,QAAQ,QAIlB;IAED;;;OAGG;IACH,gBAFW,QAAQ,QAUlB;IAED;;OAEG;IACH,YAFW,QAAQ,QAQlB;IAED;;OAEG;IACH,6BAFW,QAAQ,QAMlB;IAED;;OAEG;IACH,0BAFW,QAAQ,QAalB;IAED;;;OAGG;IACH,mBAFW,QAAQ,QAWlB;IAED;;OAEG;IACH,eAiBC;IAED,kBAEC;IAED,uBAEC;IAED,sBAEC;IAED;;;;OAIG;IACH,eAFW,CAAC,CAAS,IAAQ,EAAR,QAAQ,KAAE,IAAI,CAAC,GAAG;QAAE,aAAa,CAAC,EAAE,CAAS,IAAQ,EAAR,QAAQ,KAAE,IAAI,CAAA;KAAC,QAchF;IAED;;;OAGG;IACH,wBAHW,MAAM,GACJ,MAAM,CAWlB;IAED;;;OAGG;IACH,cAFW,KAAK,QAKf;IAED,iBAMC;IAED;;;;OAIG;IACH,sBAFW,OAAO,uBAAuB,EAAE,SAAS,QAMnD;IAED;;;OAGG;IACH,+BAHa,OAAO,0BAA0B,EAAE,OAAO,CAYtD;IAED;;;;OAIG;IACH,8BAQC;;CASJ;oCAhTY;IAAC,aAAa,EAAE,OAAO,0BAA0B,EAAE,OAAO,CAAA;CAAC;;;;oBAM3D,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC;;;;mBACnB,KAAK,EAAE"}
+{"version":3,"file":"flowNode.d.ts","sourceRoot":"","sources":["../../../src/data/flowNode.js"],"names":[],"mappings":"AA8YA;;;GAGG;AACH,uCAHW,OAAO,uBAAuB,EAAE,SAAS,GACvC,SAAS,IAAI,OAAO,uBAAuB,EAAE,SAAS,CAIlE;AAED;;;GAGG;AACH,wCAHW,OAAO,uBAAuB,EAAE,SAAS,GACvC,SAAS,IAAI,OAAO,uBAAuB,EAAE,UAAU,CAInE;AA1ZD;;;GAGG;AACH,qCAAsC;AAEtC;;;GAGG;AACH,uCAAwC;AAExC;;;GAGG;AACH,uCAAwC;AAExC;;GAEG;AAEH;;;;;GAKG;AACH;IAoCI;;OAEG;IACH,mCAFW,oBAAoB,EAa9B;IAjDD;;QAEI,oBAAoB;eAAT,KAAK;MAElB;IAWF;;;;OAIG;IACH,sBAFU,oBAAoB,CAEF;IAE5B,uBAEC;IAED;;;;OAIG;IACH,aAFa,MAAM,CAIlB;IAQG,yBAAyB;IACzB,UADW,QAAQ,EAAE,CACH;IAElB,uBAAuB;IACvB,QADW,QAAQ,CACI;IAEvB,2CAA2C;IAC3C,mBAAsB;IAG1B,wBAEC;IAED;;;OAGG;IACH,cASC;IAED;;;;;;OAMG;IACH,mBAEC;IAED;;;OAGG;IACH,uBAMC;IA2QD;;;OAGG;IACH,4BAHW,KAAK,QAKf;IAxPD;;;OAGG;IACH,kBAFW,QAAQ,QAIlB;IAED;;;OAGG;IACH,gBAFW,QAAQ,QAUlB;IAED;;OAEG;IACH,YAFW,QAAQ,QAQlB;IAED;;OAEG;IACH,6BAFW,QAAQ,QAMlB;IAED;;OAEG;IACH,0BAFW,QAAQ,QAalB;IAED;;;OAGG;IACH,mBAFW,QAAQ,QAWlB;IAED;;OAEG;IACH,eAiBC;IAED,kBAEC;IAED,uBAEC;IAED,sBAEC;IAED;;;;OAIG;IACH,eAFW,CAAC,CAAS,IAAQ,EAAR,QAAQ,KAAE,IAAI,CAAC,GAAG;QAAE,aAAa,CAAC,EAAE,CAAS,IAAQ,EAAR,QAAQ,KAAE,IAAI,CAAA;KAAC,QAchF;IAED;;;OAGG;IACH,wBAHW,MAAM,GACJ,MAAM,CAWlB;IAED;;;OAGG;IACH,cAFW,KAAK,QAKf;IAED,iBAMC;IAED;;;;OAIG;IACH,2BAFW,MAAM,IAAI,QAQpB;IAED;;OAEG;IACH,gBAWC;IAED;;OAEG;IACH,uBAOC;IAED;;;;OAIG;IACH,sBAFW,OAAO,uBAAuB,EAAE,SAAS,QAMnD;IAED;;;OAGG;IACH,8BAHa,OAAO,qCAAqC,EAAE,OAAO,CAcjE;IAED;;;;OAIG;IACH,8BAQC;;CASJ;mCAvXY;IAAC,YAAY,CAAC,EAAE,OAAO,qCAAqC,EAAE,OAAO,CAAA;CAAC;;;;oBAMtE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC;;;;mBACnB,KAAK,EAAE"}

package/dist/src/data/flowNode.js

@@ -19,7 +19,7 @@ export const BEHAVIOR_MODIFIES = 1 << 1;
 export const BEHAVIOR_COLLECTS = 1 << 2;
 
 /**
- * @typedef {{paramMediator: import("../view/paramMediator.js").default}} ParamMediatorProvider
+ * @typedef {{paramRuntime?: import("../paramRuntime/viewParamRuntime.js").default}} ParamRuntimeProvider
  */
 
 /**
@@ -35,12 +35,21 @@ export default class FlowNode {
         first: null,
     };
 
+    /** @type {boolean} */
+    #initialized = false;
+
+    /** @type {boolean} */
+    #disposed = false;
+
+    /** @type {(() => void)[]} */
+    #disposers = [];
+
     /**
-     * An object that provides a paramMediator. (Most likely a View)
+     * An object that provides a paramRuntime. (Most likely a View)
      *
-     * @type {ParamMediatorProvider}
+     * @type {ParamRuntimeProvider}
      */
-    paramMediatorProvider = null;
+    paramRuntimeProvider = null;
 
     get behavior() {
         return 0;
@@ -56,10 +65,10 @@ export default class FlowNode {
     }
 
     /**
-     * @param {ParamMediatorProvider} [paramMediatorProvider]
+     * @param {ParamRuntimeProvider} [paramRuntimeProvider]
      */
-    constructor(paramMediatorProvider) {
-        this.paramMediatorProvider = paramMediatorProvider;
+    constructor(paramRuntimeProvider) {
+        this.paramRuntimeProvider = paramRuntimeProvider;
 
         /** @type {FlowNode[]} */
         this.children = [];
@@ -71,6 +80,10 @@ export default class FlowNode {
         this.completed = false;
     }
 
+    get disposed() {
+        return this.#disposed;
+    }
+
     /**
      * Resets the node and all its descendants to their initial state, i.e., preparing
      * for a new batch of data.
@@ -89,11 +102,26 @@ export default class FlowNode {
     /**
      * Allows for doing final initialization after the flow structure has been
      * built and optimized. Must be called before any data are to be propagated.
+     * Note: Some transforms call initialize() from reset() to rebuild internal
+     * fast paths per batch. Use initializeOnce() for graph-level init to avoid
+     * double-initialization issues.
      */
     initialize() {
         // override
     }
 
+    /**
+     * Calls initialize() once per node instance. Intended for graph-level init
+     * passes that should not rerun when reusing existing branches.
+     */
+    initializeOnce() {
+        if (this.#initialized) {
+            return;
+        }
+        this.initialize();
+        this.#initialized = true;
+    }
+
     /**
      * Dynamically updates the propagator method to allow the JavaScript engine
      * to employ optimizations such as inlining.
@@ -275,6 +303,47 @@ export default class FlowNode {
         }
     }
 
+    /**
+     * Register a disposer to be executed when this node is disposed.
+     *
+     * @param {() => void} disposer
+     */
+    registerDisposer(disposer) {
+        if (this.#disposed) {
+            disposer();
+        } else {
+            this.#disposers.push(disposer);
+        }
+    }
+
+    /**
+     * Release resources owned by this flow node.
+     */
+    dispose() {
+        if (this.#disposed) {
+            return;
+        }
+
+        this.#disposed = true;
+
+        for (const disposer of this.#disposers) {
+            disposer();
+        }
+        this.#disposers.length = 0;
+    }
+
+    /**
+     * Dispose this flow node and all descendants in post-order.
+     */
+    disposeSubtree() {
+        /** @type {(function(FlowNode): void) & { afterChildren?: (node: FlowNode) => void }} */
+        const visitor = () => undefined;
+        visitor.afterChildren = (node) => {
+            node.dispose();
+        };
+        this.visit(visitor);
+    }
+
     /**
      * Signals that a new batch of data will be propagated.
      *
@@ -287,18 +356,20 @@ export default class FlowNode {
     }
 
     /**
-     * @returns {import("../view/paramMediator.js").default}
+     * @returns {import("../paramRuntime/viewParamRuntime.js").default}
      * @protected
      */
-    get paramMediator() {
-        if (this.paramMediatorProvider) {
-            return this.paramMediatorProvider.paramMediator;
+    get paramRuntime() {
+        if (this.paramRuntimeProvider) {
+            if (this.paramRuntimeProvider.paramRuntime) {
+                return this.paramRuntimeProvider.paramRuntime;
+            }
         }
 
         if (!this.parent) {
-            throw new Error("Cannot find paramMediator!");
+            throw new Error("Cannot find paramRuntime!");
         }
-        return this.parent.paramMediator;
+        return this.parent.paramRuntime;
     }
 
     /**

package/dist/src/data/flowTestUtils.d.ts

@@ -1,8 +1,8 @@
 /**
  *
- * @returns {import("./flowNode.js").ParamMediatorProvider}
+ * @returns {import("./flowNode.js").ParamRuntimeProvider}
  */
-export function makeParamMediatorProvider(): import("./flowNode.js").ParamMediatorProvider;
+export function makeParamRuntimeProvider(): import("./flowNode.js").ParamRuntimeProvider;
 /**
  *
  * @param {import("./flowNode.js").default} flowNode

package/dist/src/data/flowTestUtils.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"flowTestUtils.d.ts","sourceRoot":"","sources":["../../../src/data/flowTestUtils.js"],"names":[],"mappings":"AAIA;;;GAGG;AACH,6CAFa,OAAO,eAAe,EAAE,qBAAqB,CAMzD;AAED;;;;GAIG;AACH,sCAHW,OAAO,eAAe,EAAE,OAAO,QAC/B,GAAG,EAAE,mCAcf;AAED;;GAEG;AACH;IACI;;;OAGG;IACH,kBAFW,GAAG,EAAE,EAKf;IADG,YAAgB;IAGpB,iBAMC;CACJ;AAED;;GAEG;AACH;IACI;;;OAGG;IACH,eAFW,MAAM,EAWhB;CACJ;qBAvEoB,eAAe"}
+{"version":3,"file":"flowTestUtils.d.ts","sourceRoot":"","sources":["../../../src/data/flowTestUtils.js"],"names":[],"mappings":"AAIA;;;GAGG;AACH,4CAFa,OAAO,eAAe,EAAE,oBAAoB,CAOxD;AAED;;;;GAIG;AACH,sCAHW,OAAO,eAAe,EAAE,OAAO,QAC/B,GAAG,EAAE,mCAcf;AAED;;GAEG;AACH;IACI;;;OAGG;IACH,kBAFW,GAAG,EAAE,EAKf;IADG,YAAgB;IAGpB,iBAMC;CACJ;AAED;;GAEG;AACH;IACI;;;OAGG;IACH,eAFW,MAAM,EAWhB;CACJ;qBAxEoB,eAAe"}