@woosh/meep-engine 2.156.0 → 2.157.0

package/src/core/math/physics/mie/ri_ammonium_sulfate.js

@@ -1,6 +1,4 @@
-import {
-    ParameterLookupTable
-} from "../../../../engine/graphics/particles/particular/engine/parameter/ParameterLookupTable.js";
+import { ParameterLookupTable } from "../../lookup/ParameterLookupTable.js";
 
 /**
  * Ammonium sulfate aerosol ("(NH4)2SO4") complex refractive index m = n + i k, wavelength in nm.

package/src/core/math/physics/mie/ri_brine.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"ri_brine.d.ts","sourceRoot":"","sources":["../../../../../../src/core/math/physics/mie/ri_brine.js"],"names":[],"mappings":"AAyIA;;;;GAIG;AACH,iCAHW,MAAM,EAAE,iBACR,MAAM,QAIhB"}
+{"version":3,"file":"ri_brine.d.ts","sourceRoot":"","sources":["../../../../../../src/core/math/physics/mie/ri_brine.js"],"names":[],"mappings":"AAuIA;;;;GAIG;AACH,iCAHW,MAAM,EAAE,iBACR,MAAM,QAIhB"}

package/src/core/math/physics/mie/ri_brine.js

@@ -1,6 +1,4 @@
-import {
-    ParameterLookupTable
-} from "../../../../engine/graphics/particles/particular/engine/parameter/ParameterLookupTable.js";
+import { ParameterLookupTable } from "../../lookup/ParameterLookupTable.js";
 
 /**
  * Sea-salt aerosol (deliquesced brine) complex refractive index m = n + i k, wavelength in nm.

package/src/core/math/physics/mie/ri_dust.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"ri_dust.d.ts","sourceRoot":"","sources":["../../../../../../src/core/math/physics/mie/ri_dust.js"],"names":[],"mappings":"AAiJA;;;;GAIG;AACH,gCAHW,MAAM,EAAE,iBACR,MAAM,QAIhB"}
+{"version":3,"file":"ri_dust.d.ts","sourceRoot":"","sources":["../../../../../../src/core/math/physics/mie/ri_dust.js"],"names":[],"mappings":"AA+IA;;;;GAIG;AACH,gCAHW,MAAM,EAAE,iBACR,MAAM,QAIhB"}

package/src/core/math/physics/mie/ri_dust.js

@@ -1,6 +1,4 @@
-import {
-    ParameterLookupTable
-} from "../../../../engine/graphics/particles/particular/engine/parameter/ParameterLookupTable.js";
+import { ParameterLookupTable } from "../../lookup/ParameterLookupTable.js";
 
 /**
  * Complex refractive index of mineral dust (silicate-rich, e.g., Saharan): n + i k, wavelength in nm.

package/src/core/math/physics/mie/ri_pollen.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"ri_pollen.d.ts","sourceRoot":"","sources":["../../../../../../src/core/math/physics/mie/ri_pollen.js"],"names":[],"mappings":"AA0IA;;;;GAIG;AACH,kCAHW,MAAM,EAAE,iBACR,MAAM,QAIhB"}
+{"version":3,"file":"ri_pollen.d.ts","sourceRoot":"","sources":["../../../../../../src/core/math/physics/mie/ri_pollen.js"],"names":[],"mappings":"AAwIA;;;;GAIG;AACH,kCAHW,MAAM,EAAE,iBACR,MAAM,QAIhB"}

package/src/core/math/physics/mie/ri_pollen.js

@@ -1,6 +1,4 @@
-import {
-    ParameterLookupTable
-} from "../../../../engine/graphics/particles/particular/engine/parameter/ParameterLookupTable.js";
+import { ParameterLookupTable } from "../../lookup/ParameterLookupTable.js";
 
 /**
  * Complex refractive index of pollen (sporopollenin-rich organic shell): n + i k, wavelength in nm.

package/src/core/math/physics/mie/ri_smoke.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"ri_smoke.d.ts","sourceRoot":"","sources":["../../../../../../src/core/math/physics/mie/ri_smoke.js"],"names":[],"mappings":"AA+IA;;;;GAIG;AACH,iCAHW,MAAM,EAAE,iBACR,MAAM,QAIhB"}
+{"version":3,"file":"ri_smoke.d.ts","sourceRoot":"","sources":["../../../../../../src/core/math/physics/mie/ri_smoke.js"],"names":[],"mappings":"AA6IA;;;;GAIG;AACH,iCAHW,MAAM,EAAE,iBACR,MAAM,QAIhB"}

package/src/core/math/physics/mie/ri_smoke.js

@@ -1,6 +1,4 @@
-import {
-    ParameterLookupTable
-} from "../../../../engine/graphics/particles/particular/engine/parameter/ParameterLookupTable.js";
+import { ParameterLookupTable } from "../../lookup/ParameterLookupTable.js";
 
 /**
  * 🔥 SMOKE (Brown Carbon / Organic aerosol): complex refractive index m = n + i k, wavelength in nm.

package/src/core/math/physics/mie/ri_soot.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"ri_soot.d.ts","sourceRoot":"","sources":["../../../../../../src/core/math/physics/mie/ri_soot.js"],"names":[],"mappings":"AA4IA;;;;GAIG;AACH,gCAHW,MAAM,EAAE,iBACR,MAAM,QAIhB"}
+{"version":3,"file":"ri_soot.d.ts","sourceRoot":"","sources":["../../../../../../src/core/math/physics/mie/ri_soot.js"],"names":[],"mappings":"AA0IA;;;;GAIG;AACH,gCAHW,MAAM,EAAE,iBACR,MAAM,QAIhB"}

package/src/core/math/physics/mie/ri_soot.js

@@ -1,6 +1,4 @@
-import {
-    ParameterLookupTable
-} from "../../../../engine/graphics/particles/particular/engine/parameter/ParameterLookupTable.js";
+import { ParameterLookupTable } from "../../lookup/ParameterLookupTable.js";
 
 /**
  * Complex refractive index of soot (black carbon): n + i k, wavelength in nm.

package/src/core/math/physics/mie/ri_water.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"ri_water.d.ts","sourceRoot":"","sources":["../../../../../../src/core/math/physics/mie/ri_water.js"],"names":[],"mappings":"AA4IA;;;;GAIG;AACH,iCAHW,MAAM,EAAE,iBACR,MAAM,QAIhB"}
+{"version":3,"file":"ri_water.d.ts","sourceRoot":"","sources":["../../../../../../src/core/math/physics/mie/ri_water.js"],"names":[],"mappings":"AA0IA;;;;GAIG;AACH,iCAHW,MAAM,EAAE,iBACR,MAAM,QAIhB"}

package/src/core/math/physics/mie/ri_water.js

@@ -1,6 +1,4 @@
-import {
-    ParameterLookupTable
-} from "../../../../engine/graphics/particles/particular/engine/parameter/ParameterLookupTable.js";
+import { ParameterLookupTable } from "../../lookup/ParameterLookupTable.js";
 
 /**
  * Refractive index of pure liquid water (n + i k), wavelength in nm.

package/src/core/math/random/random_pick_weighted_index.d.ts

@@ -0,0 +1,10 @@
+/**
+ * Pick an index at random, weighted by a cumulative (prefix-sum) weight array.
+ *
+ * @param {function():number} random RNG returning values in [0, 1)
+ * @param {number[]} cumulativeWeights cumulativeWeights[i] = sum of weights of entries 0..i; non-decreasing
+ * @param {number} count number of valid entries in the array
+ * @returns {number} picked index, or -1 when the total weight is not positive (the RNG is not consumed)
+ */
+export function random_pick_weighted_index(random: () => number, cumulativeWeights: number[], count: number): number;
+//# sourceMappingURL=random_pick_weighted_index.d.ts.map

package/src/core/math/random/random_pick_weighted_index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"random_pick_weighted_index.d.ts","sourceRoot":"","sources":["../../../../../src/core/math/random/random_pick_weighted_index.js"],"names":[],"mappings":"AAGA;;;;;;;GAOG;AACH,yDALsB,MAAM,qBACjB,MAAM,EAAE,SACR,MAAM,GACJ,MAAM,CAgBlB"}

package/src/core/math/random/random_pick_weighted_index.js

@@ -0,0 +1,26 @@
+import { binarySearchHighIndex } from "../../collection/array/binarySearchHighIndex.js";
+import { number_compare_ascending } from "../../primitives/numbers/number_compare_ascending.js";
+
+/**
+ * Pick an index at random, weighted by a cumulative (prefix-sum) weight array.
+ *
+ * @param {function():number} random RNG returning values in [0, 1)
+ * @param {number[]} cumulativeWeights cumulativeWeights[i] = sum of weights of entries 0..i; non-decreasing
+ * @param {number} count number of valid entries in the array
+ * @returns {number} picked index, or -1 when the total weight is not positive (the RNG is not consumed)
+ */
+export function random_pick_weighted_index(random, cumulativeWeights, count) {
+    if (count <= 0) {
+        return -1;
+    }
+
+    const totalWeight = cumulativeWeights[count - 1];
+
+    if (totalWeight <= 0) {
+        return -1;
+    }
+
+    const targetWeight = random() * totalWeight;
+
+    return binarySearchHighIndex(cumulativeWeights, targetWeight, number_compare_ascending, 0, count - 1);
+}

package/src/core/model/node-graph/NodeGraph.d.ts

@@ -210,6 +210,15 @@ export class NodeGraph {
      * @throws if any node or port are not found
      */
     createConnection(sourceNode: number, sourcePort: number, targetNode: number, targetPort: number): number;
+    /**
+     * Add an existing connection object to the graph. Counterpart of {@link #addNode}.
+     * Useful for re-attaching a previously deleted connection while preserving its identity,
+     * such as during UNDO/REDO.
+     * NOTE: both endpoint nodes must already be part of the graph
+     * @param {Connection} connection
+     * @returns {number} ID of the connection
+     */
+    addConnection(connection: Connection): number;
     /**
      *
      * @param {number} id

package/src/core/model/node-graph/NodeGraph.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"NodeGraph.d.ts","sourceRoot":"","sources":["../../../../../src/core/model/node-graph/NodeGraph.js"],"names":[],"mappings":"AASA;;;;;;;;GAQG;AACH;IAEI;;;;OAIG;IACH,uBAAmB;IAEnB;;;;;OAKG;IACH,6BAAyB;IAEzB;;;;;OAKG;IACH,4BAA0B;IAE1B;;;;;OAKG;IACH,kCAAgC;IAQhC;;;;;OAKG;IACH,+BAEC;IAED;;OAEG;IACH;QACI;;;WAGG;;QAGH;;;WAGG;;QAGH;;;WAGG;;QAGH;;;WAGG;;MAEL;IAEF;;OAEG;IACH,cAQC;IAED;;;OAGG;IACH,YAFW,SAAS,QAYnB;IAED;;;OAGG;IACH,SAFa,SAAS,CAQrB;IAED;;;;;;OAMG;IACH,aAHW,SAAS,GACP;QAAC,WAAW,EAAC,UAAU,EAAE,CAAC;QAAC,KAAK,EAAC,YAAY,EAAE,CAAA;KAAC,CAe5D;IAED;;;;;;;;OAQG;IACH,sCAJW,YAAY,EAAE,GAEZ;QAAC,WAAW,EAAC,UAAU,EAAE,CAAC;QAAC,KAAK,EAAC,YAAY,EAAE,CAAA;KAAC,CAmF5D;IAED;;;;OAIG;IACH,8BAHoB,YAAY,+BAK/B;IAED;;;;OAIG;IACH,oCAHoB,UAAU,+BAK7B;IAED;;;;OAIG;IACH,YAFY,YAAY,EAAE,CAIzB;IAED;;;;OAIG;IACH,kBAFY,UAAU,EAAE,CAIvB;IAED;;;;OAIG;IACH,cAHW,YAAY,GACV,OAAO,CAgBnB;IAED;;;;OAIG;IACH,qDAFa,YAAY,EAAE,CAsB1B;IAED;;;;OAIG;IACH,0DAFa,YAAY,EAAE,CAqB1B;IAED;;;;OAIG;IACH,YAHW,MAAM,GACJ,YAAY,GAAC,SAAS,CAkBlC;IAED;;;;;OAKG;IACH,gBAJW,MAAM,GACJ,YAAY,CAWxB;IAED;;;;OAIG;IACH,kBAHW,MAAM,GACJ,UAAU,GAAC,SAAS,CAgBhC;IAED;;;;;OAKG;IACH,+BAJW,MAAM,WACN,MAAM,GACJ,4BAA0B,SAAS,CAY/C;IAED;;;;OAIG;IACH,mCAFa,MAAM,CAclB;IAED;;;OAGG;IACH,cAFW,YAAY,QAkBtB;IAED;;;;OAIG;IACH,eAHW,MAAM,GACJ,OAAO,CA8BnB;IAED;;;;;;;;OAQG;IACH,uCANW,MAAM,cACN,MAAM,cACN,MAAM,cACN,MAAM,GACJ,MAAM,CAqClB;IAED;;;;;;;;OAQG;IACH,6BAPW,MAAM,cACN,MAAM,cACN,MAAM,cACN,MAAM,GACJ,MAAM,CAuDlB;IAED;;;;OAIG;IACH,qBAHW,MAAM,GACJ,OAAO,CAyBnB;IAED;;;;;OAKG;IACH,iCAJW,MAAM,UACN,MAAM,EAAE,GACN,MAAM,CAyBlB;IAED,mBAEC;IAGL;;;;;;;;OAQG;IACH,sBAFU,OAAO,CAEc;;CAX9B;6BA1qB4B,wBAAwB;2BAD1B,iBAAiB"}
+{"version":3,"file":"NodeGraph.d.ts","sourceRoot":"","sources":["../../../../../src/core/model/node-graph/NodeGraph.js"],"names":[],"mappings":"AASA;;;;;;;;GAQG;AACH;IAEI;;;;OAIG;IACH,uBAAmB;IAEnB;;;;;OAKG;IACH,6BAAyB;IAEzB;;;;;OAKG;IACH,4BAA0B;IAE1B;;;;;OAKG;IACH,kCAAgC;IAQhC;;;;;OAKG;IACH,+BAEC;IAED;;OAEG;IACH;QACI;;;WAGG;;QAGH;;;WAGG;;QAGH;;;WAGG;;QAGH;;;WAGG;;MAEL;IAEF;;OAEG;IACH,cAQC;IAED;;;OAGG;IACH,YAFW,SAAS,QAYnB;IAED;;;OAGG;IACH,SAFa,SAAS,CAQrB;IAED;;;;;;OAMG;IACH,aAHW,SAAS,GACP;QAAC,WAAW,EAAC,UAAU,EAAE,CAAC;QAAC,KAAK,EAAC,YAAY,EAAE,CAAA;KAAC,CAe5D;IAED;;;;;;;;OAQG;IACH,sCAJW,YAAY,EAAE,GAEZ;QAAC,WAAW,EAAC,UAAU,EAAE,CAAC;QAAC,KAAK,EAAC,YAAY,EAAE,CAAA;KAAC,CAmF5D;IAED;;;;OAIG;IACH,8BAHoB,YAAY,+BAK/B;IAED;;;;OAIG;IACH,oCAHoB,UAAU,+BAK7B;IAED;;;;OAIG;IACH,YAFY,YAAY,EAAE,CAIzB;IAED;;;;OAIG;IACH,kBAFY,UAAU,EAAE,CAIvB;IAED;;;;OAIG;IACH,cAHW,YAAY,GACV,OAAO,CAgBnB;IAED;;;;OAIG;IACH,qDAFa,YAAY,EAAE,CAsB1B;IAED;;;;OAIG;IACH,0DAFa,YAAY,EAAE,CAqB1B;IAED;;;;OAIG;IACH,YAHW,MAAM,GACJ,YAAY,GAAC,SAAS,CAkBlC;IAED;;;;;OAKG;IACH,gBAJW,MAAM,GACJ,YAAY,CAWxB;IAED;;;;OAIG;IACH,kBAHW,MAAM,GACJ,UAAU,GAAC,SAAS,CAgBhC;IAED;;;;;OAKG;IACH,+BAJW,MAAM,WACN,MAAM,GACJ,4BAA0B,SAAS,CAY/C;IAED;;;;OAIG;IACH,mCAFa,MAAM,CAclB;IAED;;;OAGG;IACH,cAFW,YAAY,QAkBtB;IAED;;;;OAIG;IACH,eAHW,MAAM,GACJ,OAAO,CA8BnB;IAED;;;;;;;;OAQG;IACH,uCANW,MAAM,cACN,MAAM,cACN,MAAM,cACN,MAAM,GACJ,MAAM,CAqClB;IAED;;;;;;;;OAQG;IACH,6BAPW,MAAM,cACN,MAAM,cACN,MAAM,cACN,MAAM,GACJ,MAAM,CAuDlB;IAED;;;;;;;OAOG;IACH,0BAHW,UAAU,GACR,MAAM,CA2BlB;IAED;;;;OAIG;IACH,qBAHW,MAAM,GACJ,OAAO,CA4BnB;IAED;;;;;OAKG;IACH,iCAJW,MAAM,UACN,MAAM,EAAE,GACN,MAAM,CAyBlB;IAED,mBAEC;IAGL;;;;;;;;OAQG;IACH,sBAFU,OAAO,CAEc;;CAX9B;6BAhtB4B,wBAAwB;2BAD1B,iBAAiB"}

package/src/core/model/node-graph/NodeGraph.js

@@ -622,6 +622,41 @@ export class NodeGraph {
         return id;
     }
 
+    /**
+     * Add an existing connection object to the graph. Counterpart of {@link #addNode}.
+     * Useful for re-attaching a previously deleted connection while preserving its identity,
+     * such as during UNDO/REDO.
+     * NOTE: both endpoint nodes must already be part of the graph
+     * @param {Connection} connection
+     * @returns {number} ID of the connection
+     */
+    addConnection(connection) {
+        assert.defined(connection, 'connection');
+        assert.notNull(connection, 'connection');
+
+        const id_obtained = this.__idpConnections.getSpecific(connection.id);
+
+        if (id_obtained === false) {
+            throw new Error(`Connection with id '${connection.id}' already exists`);
+        }
+
+        const sourceEndpoint = connection.source;
+        const targetEndpoint = connection.target;
+
+        this.connections.add(connection);
+
+        // add connection links to the nodes
+        sourceEndpoint.instance.connections.addUnique(connection);
+        targetEndpoint.instance.connections.addUnique(connection);
+
+        array_push_if_unique(sourceEndpoint.connections, connection);
+        array_push_if_unique(targetEndpoint.connections, connection);
+
+        this.#version++;
+
+        return connection.id;
+    }
+
     /**
      *
      * @param {number} id
@@ -647,6 +682,9 @@ export class NodeGraph {
         array_remove_first(sourceEndpoint.connections, connection);
         array_remove_first(targetEndpoint.connections, connection);
 
+        //release id, mirroring deleteNode
+        this.__idpConnections.release(id);
+
         this.#version++;
 
         return true;

package/src/core/model/node-graph/visual/NodeGraphVisualData.d.ts

@@ -37,12 +37,35 @@ export class NodeGraphVisualData {
      * @param {NodeVisualData} node
      */
     addNode(id: number, node: NodeVisualData): void;
+    /**
+     * Remove visual data of a node.
+     * Node IDs are pooled and may be re-used; visual data of a deleted node must not
+     * survive to be picked up by an unrelated future node.
+     * @param {number} id
+     * @returns {boolean} true if removed, false if no data existed
+     */
+    removeNode(id: number): boolean;
     /**
      *
      * @param {number} id
      * @returns {NodeVisualData|undefined}
      */
     getNode(id: number): NodeVisualData | undefined;
+    /**
+     * Ensure visual data exists for a node instance, generating it from the registry when missing
+     * @param {NodeInstance} node
+     * @param {NodeDescriptionVisualRegistry} registry
+     * @returns {NodeVisualData}
+     * @throws when the node's description has no visual data in the registry
+     */
+    ensureNode(node: NodeInstance, registry: NodeDescriptionVisualRegistry): NodeVisualData;
+    /**
+     * Ensure visual data exists for every node of the graph.
+     * Makes {@link #layout} and serialization independent of any view having been built.
+     * @param {NodeGraph} graph
+     * @param {NodeDescriptionVisualRegistry} registry
+     */
+    ensure(graph: NodeGraph, registry: NodeDescriptionVisualRegistry): void;
     toJSON(): {
         nodes: {};
         dataColors: {};

package/src/core/model/node-graph/visual/NodeGraphVisualData.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"NodeGraphVisualData.d.ts","sourceRoot":"","sources":["../../../../../../src/core/model/node-graph/visual/NodeGraphVisualData.js"],"names":[],"mappings":"AASA;IAEI;;;OAGG;IACH,OAFU,IAAI,MAAM,EAAE,cAAc,CAAC,CAEnB;IAElB;;;OAGG;IACH,YAFU,IAAI,MAAM,EAAE,KAAK,CAAC,CAEL;IAEvB;;;OAGG;IACH,wCAgBC;IAED;;;OAGG;IACH,+BAwHC;IAED;;;;OAIG;IACH,iBAHW,MAAM,SACN,KAAK,QAMf;IAED;;;;OAIG;IACH,iBAHW,MAAM,GACJ,KAAK,CAIjB;IAED;;;;OAIG;IACH,YAHW,MAAM,QACN,cAAc,QAIxB;IAED;;;;OAIG;IACH,YAHW,MAAM,GACJ,cAAc,GAAC,SAAS,CAIpC;IAED;;;MAiBC;IAED,0BA0BC;CACJ;+BAxP8B,qBAAqB;sBAL9B,yBAAyB"}
+{"version":3,"file":"NodeGraphVisualData.d.ts","sourceRoot":"","sources":["../../../../../../src/core/model/node-graph/visual/NodeGraphVisualData.js"],"names":[],"mappings":"AASA;IAEI;;;OAGG;IACH,OAFU,IAAI,MAAM,EAAE,cAAc,CAAC,CAEnB;IAElB;;;OAGG;IACH,YAFU,IAAI,MAAM,EAAE,KAAK,CAAC,CAEL;IAEvB;;;OAGG;IACH,wCAgBC;IAED;;;OAGG;IACH,+BAwHC;IAED;;;;OAIG;IACH,iBAHW,MAAM,SACN,KAAK,QAMf;IAED;;;;OAIG;IACH,iBAHW,MAAM,GACJ,KAAK,CAIjB;IAED;;;;OAIG;IACH,YAHW,MAAM,QACN,cAAc,QAIxB;IAED;;;;;;OAMG;IACH,eAHW,MAAM,GACJ,OAAO,CAInB;IAED;;;;OAIG;IACH,YAHW,MAAM,GACJ,cAAc,GAAC,SAAS,CAIpC;IAED;;;;;;OAMG;IACH,yEAHa,cAAc,CAyB1B;IAED;;;;;OAKG;IACH,wEAIC;IAED;;;MAiBC;IAED,0BA0BC;CACJ;+BA9S8B,qBAAqB;sBAL9B,yBAAyB"}

package/src/core/model/node-graph/visual/NodeGraphVisualData.js

@@ -198,6 +198,17 @@ export class NodeGraphVisualData {
         this.nodes.set(id, node);
     }
 
+    /**
+     * Remove visual data of a node.
+     * Node IDs are pooled and may be re-used; visual data of a deleted node must not
+     * survive to be picked up by an unrelated future node.
+     * @param {number} id
+     * @returns {boolean} true if removed, false if no data existed
+     */
+    removeNode(id) {
+        return this.nodes.delete(id);
+    }
+
     /**
      *
      * @param {number} id
@@ -207,6 +218,49 @@ export class NodeGraphVisualData {
         return this.nodes.get(id);
     }
 
+    /**
+     * Ensure visual data exists for a node instance, generating it from the registry when missing
+     * @param {NodeInstance} node
+     * @param {NodeDescriptionVisualRegistry} registry
+     * @returns {NodeVisualData}
+     * @throws when the node's description has no visual data in the registry
+     */
+    ensureNode(node, registry) {
+        const existing = this.nodes.get(node.id);
+
+        if (existing !== undefined) {
+            return existing;
+        }
+
+        const description = node.description;
+
+        const prototype = registry.get(description.id);
+
+        if (prototype === undefined) {
+            throw new Error(`Node (name='${description.name}', id=${description.id}) not found in registry`);
+        }
+
+        const visual = prototype.clone();
+
+        visual.id = node.id;
+
+        this.nodes.set(node.id, visual);
+
+        return visual;
+    }
+
+    /**
+     * Ensure visual data exists for every node of the graph.
+     * Makes {@link #layout} and serialization independent of any view having been built.
+     * @param {NodeGraph} graph
+     * @param {NodeDescriptionVisualRegistry} registry
+     */
+    ensure(graph, registry) {
+        graph.traverseNodes(node => {
+            this.ensureNode(node, registry);
+        });
+    }
+
     toJSON() {
         const nodes = {};
 

package/src/core/path/convertPathToURL.d.ts

@@ -0,0 +1,9 @@
+/**
+ * Given a path, which may be a local path, produce a fully qualified URL
+ * @example '/path' -> 'http://example.com/path'
+ * @example 'some/local/path' -> 'http://example.com/current_path/some/local/path'
+ * @param {string} path
+ * @return {string}
+ */
+export function convertPathToURL(path: string): string;
+//# sourceMappingURL=convertPathToURL.d.ts.map

package/src/core/path/convertPathToURL.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"convertPathToURL.d.ts","sourceRoot":"","sources":["../../../../src/core/path/convertPathToURL.js"],"names":[],"mappings":"AAuFA;;;;;;GAMG;AACH,uCAHW,MAAM,GACL,MAAM,CAcjB"}

package/src/core/path/convertPathToURL.js

@@ -0,0 +1,107 @@
+import { assert } from "../assert.js";
+
+const rx_url_schema = /[a-zA-Z0-9_\-]+\:\/\//;
+
+/**
+ *
+ * @param {string} path
+ * @return {boolean}
+ */
+function isGlobalPath(path) {
+    //search for URL schema at the start of the path
+    return path.search(rx_url_schema) === 0;
+}
+
+// *** Environment setup code ***
+const ENVIRONMENT_IS_WEB = typeof window === 'object';
+const ENVIRONMENT_IS_NODE = typeof process === 'object' && !ENVIRONMENT_IS_WEB;
+const ENVIRONMENT_IS_WORKER = typeof importScripts === 'function';
+const ENVIRONMENT_IS_SHELL = !ENVIRONMENT_IS_WEB && !ENVIRONMENT_IS_NODE && !ENVIRONMENT_IS_WORKER;
+
+/**
+ *
+ * @param {string} path
+ * @return {string}
+ */
+function localPathToGlobal(path) {
+    /**
+     * @type {Window|DedicatedWorkerGlobalScope}
+     */
+    let scope;
+
+    if (ENVIRONMENT_IS_WEB) {
+        scope = window;
+    } else if (ENVIRONMENT_IS_WORKER) {
+        scope = self;
+    } else if (ENVIRONMENT_IS_NODE) {
+
+        let normalized_path = `${process.cwd()}/`.replace(/\\/g, '/');
+
+        // remove multiple sequential slashes
+        normalized_path = normalized_path.replace(/\/+/g, '/');
+
+        if (normalized_path[0] !== '/') {
+            // Windows drive letter must be prefixed with a slash.
+            normalized_path = `/${normalized_path}`;
+        }
+
+        scope = {
+            location: {
+                pathname: normalized_path,
+                host: '',
+                protocol: 'file:'
+            }
+        };
+    } else {
+        throw new Error('Unknown environment');
+    }
+
+    const location = scope.location;
+    const pathname = location.pathname;
+
+    let directoryPath;
+
+    /*
+    path name contains file name also, there are two options here, "a/b" or "a/b/" second is a directory
+    we need to extract directory to load relative path
+    */
+
+    if (pathname.endsWith('/')) {
+        //path is to a directory, strip last slash
+        directoryPath = pathname.substring(0, pathname.length - 1);
+    } else {
+        //path is to a file
+        const i = pathname.lastIndexOf('/');
+
+        if (i === -1) {
+            //root level file
+            directoryPath = ""
+        } else {
+            directoryPath = pathname.substring(0, i);
+        }
+    }
+
+    const urlBase = location.protocol + "//" + location.host + directoryPath + "/";
+    return urlBase + path;
+}
+
+/**
+ * Given a path, which may be a local path, produce a fully qualified URL
+ * @example '/path' -> 'http://example.com/path'
+ * @example 'some/local/path' -> 'http://example.com/current_path/some/local/path'
+ * @param {string} path
+ * @return {string}
+ */
+export function convertPathToURL(path) {
+    assert.isString(path, 'path');
+
+    const is_global = isGlobalPath(path);
+
+    let result = path;
+
+    if (!is_global) {
+        result = localPathToGlobal(path);
+    }
+
+    return result;
+}

package/src/core/process/worker/WorkerBuilder.js

@@ -1,5 +1,5 @@
-import { convertPathToURL } from "../../../engine/network/convertPathToURL.js";
 import { codeToURL } from "../../codegen/codeToURL.js";
+import { convertPathToURL } from "../../path/convertPathToURL.js";
 import LineBuilder from "../../codegen/LineBuilder.js";
 import WorkerProxy from "./WorkerProxy.js";
 

package/src/core/process/worker/extractTransferables.js

@@ -1,5 +1,5 @@
-import { isImageBitmap } from "../../../engine/graphics/texture/isImageBitmap.js";
 import { array_push_if_unique } from "../../collection/array/array_push_if_unique.js";
+import { isImageBitmap } from "../../dom/isImageBitmap.js";
 
 /**
  *

package/src/engine/animation/curve/draw/build_tangent_editor.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"build_tangent_editor.d.ts","sourceRoot":"","sources":["../../../../../../src/engine/animation/curve/draw/build_tangent_editor.js"],"names":[],"mappings":"AA8DA;;;;;;;;;;;;GAYG;AACH,wKAXW,wBAAwB,aA2NlC;sBA3RqB,wCAAwC"}
+{"version":3,"file":"build_tangent_editor.d.ts","sourceRoot":"","sources":["../../../../../../src/engine/animation/curve/draw/build_tangent_editor.js"],"names":[],"mappings":"AAgEA;;;;;;;;;;;;GAYG;AACH,wKAXW,wBAAwB,aAgOlC;sBAlSqB,wCAAwC"}

package/src/engine/animation/curve/draw/build_tangent_editor.js

@@ -1,5 +1,7 @@
 import EmptyView from "../../../../view/elements/EmptyView.js";
 import {DraggableAspect} from "../../../ui/DraggableAspect.js";
+import {readPositionFromMouseEvent} from "../../../input/devices/PointerDevice.js";
+import Vector2 from "../../../../core/geom/Vector2.js";
 import ObservedValue from "../../../../core/model/ObservedValue.js";
 import {Keyframe} from "../Keyframe.js";
 import Vector1 from "../../../../core/geom/Vector1.js";
@@ -114,9 +116,14 @@ export function build_tangent_editor({
         const markerElement = marker.el;
         const keyframeValueStart = new Keyframe(),
               keyframeValueEnd = new Keyframe();
+        const cursorCanvasPosition = new Vector2();
+
         const rotatable = new DraggableAspect({
             el: markerElement,
-            drag(cursorCanvasPosition){
+            drag(position, origin, delta, event){
+                // tangent math lives in the graph canvas frame, not the frame of the handle marker
+                readPositionFromMouseEvent(cursorCanvasPosition, event, ctx.canvas);
+
                 const keyframeCanvasPosition = position_curve_to_canvas(size, frame, margin, keyframe.time, keyframe.value);
 
                 updateTangentValues(keyframeCanvasPosition, cursorCanvasPosition, keyframe, enableTangentAlignment, activeHandler.get().x);

package/src/engine/animation/curve/editor/createKeyframeDraggableAspect.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"createKeyframeDraggableAspect.d.ts","sourceRoot":"","sources":["../../../../../../src/engine/animation/curve/editor/createKeyframeDraggableAspect.js"],"names":[],"mappings":"AAQA;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,sTAFa,eAAe,CA0F3B;gCApH6B,gCAAgC"}
+{"version":3,"file":"createKeyframeDraggableAspect.d.ts","sourceRoot":"","sources":["../../../../../../src/engine/animation/curve/editor/createKeyframeDraggableAspect.js"],"names":[],"mappings":"AASA;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,sTAFa,eAAe,CA+F3B;gCA1H6B,gCAAgC"}

package/src/engine/animation/curve/editor/createKeyframeDraggableAspect.js

@@ -1,5 +1,6 @@
 import {AnimationCurve} from "../AnimationCurve.js";
 import {DraggableAspect} from "../../../ui/DraggableAspect.js";
+import {readPositionFromMouseEvent} from "../../../input/devices/PointerDevice.js";
 import {position_canvas_to_curve} from "../draw/position_canvas_to_curve.js";
 import Vector2 from "../../../../core/geom/Vector2.js";
 import {updateKeyframePosition} from "./updateKeyframePosition.js";
@@ -52,15 +53,20 @@ export function createKeyframeDraggableAspect({
         curveEndValue: new AnimationCurve(),
     }
 
+    const canvasPosition = new Vector2();
+
     return new DraggableAspect({
         el: markerElement,
-        drag(position) {
+        drag(position, origin, delta, event) {
+            // marker positions are meaningless here, the curve math lives in the graph canvas frame
+            readPositionFromMouseEvent(canvasPosition, event, graph.el);
+
             const moveKeyframeToCoord = position_canvas_to_curve(
                 graph.size,
                 frame,
                 margin,
-                position.x,
-                position.y
+                canvasPosition.x,
+                canvasPosition.y
             );
 
             if (isMovingOutOfBounds(moveKeyframeToCoord, keyframe, validEditableBounds, selectedKeyframes)) {
@@ -80,8 +86,8 @@ export function createKeyframeDraggableAspect({
 
             keyCoordinateDisplay.updateText(`${number_pretty_print(moveKeyframeToCoord.x)}, ${number_pretty_print(moveKeyframeToCoord.y)}`);
             keyCoordinateDisplay.position.set(
-                position.x,
-                position.y - 24
+                canvasPosition.x,
+                canvasPosition.y - 24
             );
 
             fnUpdateMarkerPosition();

package/src/engine/asset/Asset.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"Asset.d.ts","sourceRoot":"","sources":["../../../../src/engine/asset/Asset.js"],"names":[],"mappings":"AAAA;;;GAGG;AACH;IACI;;;;;OAKG;IACH,4CAHW,MAAM,EA4BhB;IAvBG;;;OAGG;IACH,mBAAsB;IAEtB;;;OAGG;IACH,UAFU,MAAM,CAEQ;IAExB;;;OAGG;IACH,cAFU,uBAAuB,CAEX;IAEtB;;;OAGG;IACH,8BAAuB;IAG3B;;;;OAIG;IACH,2BAFa,OAAO,CAOnB;IAED,YAEC;IAED;;;OAGG;IACH,UAFa,CAAC,CAIb;CACJ"}
+{"version":3,"file":"Asset.d.ts","sourceRoot":"","sources":["../../../../src/engine/asset/Asset.js"],"names":[],"mappings":"AAAA;;;GAGG;AACH;IACI;;;;;OAKG;IACH,4CAHW,MAAM,EA6BhB;IAxBG;;;OAGG;IACH,mBAAsB;IAEtB;;;OAGG;IACH,UAFU,MAAM,CAEQ;IAExB;;;;OAIG;IACH,cAFU,uBAAuB,CAEX;IAEtB;;;OAGG;IACH,8BAAuB;IAG3B;;;;OAIG;IACH,2BAFa,OAAO,CAgBnB;IAED,YAEC;IAED;;;OAGG;IACH,UAFa,CAAC,CAIb;CACJ"}

package/src/engine/asset/Asset.js

@@ -24,7 +24,8 @@ export class Asset {
         this.byteSize = byteSize;
 
         /**
-         *
+         * Descriptions of assets this asset depends on.
+         * Populated by the {@link AssetManager} from nested requests made by the loader during the load.
          * @type {Array<AssetDescription>}
          */
         this.dependencies = [];
@@ -42,14 +43,23 @@ export class Asset {
      * @returns {boolean}
      */
     equals(other) {
-        return this === other
-            || this.description === other.description
-            || this.description.equals(other.description)
-            ;
+        if (this === other) {
+            return true;
+        }
+
+        const a = this.description;
+        const b = other.description;
+
+        if (a === null || b === null) {
+            // without descriptions only identity can establish equality
+            return false;
+        }
+
+        return a === b || a.equals(b);
     }
 
     hash() {
-        return this.description.hash();
+        return this.description === null ? 0 : this.description.hash();
     }
 
     /**