@woosh/meep-engine 2.60.0 → 2.61.0

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

@@ -1,69 +1,68 @@
-import { assert } from "../../assert.js";
+import {assert} from "../../assert.js";
+import {array_push_if_unique} from "../../collection/array/array_push_if_unique.js";
+import {array_remove_first} from "../../collection/array/array_remove_first.js";
 import List from "../../collection/list/List.js";
 import IdPool from "../../IdPool.js";
-import { Connection } from "./Connection.js";
-import { NodeInstance } from "./node/NodeInstance.js";
-import { array_push_if_unique } from "../../collection/array/array_push_if_unique.js";
-import { array_remove_first } from "../../collection/array/array_remove_first.js";
-import { PortDirection } from "./node/PortDirection.js";
+import {Connection} from "./Connection.js";
+import {NodeInstance} from "./node/NodeInstance.js";
+import {PortDirection} from "./node/PortDirection.js";
 
 export class NodeGraph {
-    constructor() {
-        /**
-         * @private
-         * @type {List<NodeInstance>}
-         */
-        this.nodes = new List();
 
+    /**
+     * @private
+     * @type {List<NodeInstance>}
+     */
+    nodes = new List();
+
+    /**
+     * @private
+     * @type {List<Connection>}
+     */
+    connections = new List();
+
+    /**
+     *
+     * @type {IdPool}
+     * @private
+     */
+    __idpNodes = new IdPool();
+
+    /**
+     *
+     * @type {IdPool}
+     * @private
+     */
+    __idpConnections = new IdPool();
+
+    /**
+     * @readonly
+     */
+    on = {
         /**
-         * @private
-         * @type {List<Connection>}
+         * @readonly
+         * @type {Signal<NodeInstance,number>}
          */
-        this.connections = new List();
+        nodeAdded: this.nodes.on.added,
 
         /**
-         *
-         * @type {IdPool}
-         * @private
+         * @readonly
+         * @type {Signal<NodeInstance,number>}
          */
-        this.__idpNodes = new IdPool();
+        nodeRemoved: this.nodes.on.removed,
 
         /**
-         *
-         * @type {IdPool}
-         * @private
+         * @readonly
+         * @type {Signal<Connection,number>}
          */
-        this.__idpConnections = new IdPool();
+        connectionAdded: this.connections.on.added,
 
         /**
          * @readonly
+         * @type {Signal<Connection,number>}
          */
-        this.on = {
-            /**
-             * @readonly
-             * @type {Signal<NodeInstance,number>}
-             */
-            nodeAdded: this.nodes.on.added,
-
-            /**
-             * @readonly
-             * @type {Signal<NodeInstance,number>}
-             */
-            nodeRemoved: this.nodes.on.removed,
-
-            /**
-             * @readonly
-             * @type {Signal<Connection,number>}
-             */
-            connectionAdded: this.connections.on.added,
-
-            /**
-             * @readonly
-             * @type {Signal<Connection,number>}
-             */
-            connectionRemoved: this.connections.on.removed
-        };
-    }
+        connectionRemoved: this.connections.on.removed
+    };
 
     /**
      * Clear out all data from the graph
@@ -132,7 +131,7 @@ export class NodeGraph {
      * @param {Connection[]} [connections]
      * @returns {{connections:Connection[], nodes:NodeInstance[]}} local created instances
      */
-    mergeFragment({ nodes, connections = [] }) {
+    mergeFragment({nodes, connections = []}) {
 
         const previous_node_count = this.nodes.length;
         const previous_connection_count = this.connections.length;

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

@@ -1,11 +1,11 @@
-import { assert } from "../../../assert.js";
-import { NodeParameterDataType } from "./parameter/NodeParameterDataType.js";
-import { NodeParameterDescription } from "./parameter/NodeParameterDescription.js";
-import { Port } from "./Port.js";
-import { PortDirection } from "./PortDirection.js";
+import {assert} from "../../../assert.js";
+import {isArrayEqual} from "../../../collection/array/isArrayEqual.js";
 import Signal from "../../../events/signal/Signal.js";
-import { invokeObjectToJSON } from "../../object/invokeObjectToJSON.js";
-import { isArrayEqual } from "../../../collection/array/isArrayEqual.js";
+import {invokeObjectToJSON} from "../../object/invokeObjectToJSON.js";
+import {NodeParameterDataType} from "./parameter/NodeParameterDataType.js";
+import {NodeParameterDescription} from "./parameter/NodeParameterDescription.js";
+import {Port} from "./Port.js";
+import {PortDirection} from "./PortDirection.js";
 
 
 /**
@@ -39,50 +39,48 @@ function pickNewSetId(things) {
 let node_id_counter = 0;
 
 export class NodeDescription {
-    constructor() {
-        /**
-         * Useful human-readable label
-         * @type {string}
-         */
-        this.name = "";
+    /**
+     * Useful human-readable label
+     * @type {string}
+     */
+    name = "";
 
-        /**
-         * A unique identifier in the scope of a single registry
-         * If two nodes belong to the same registry - they must have different IDs
-         * By default an auto-incrementing ID is assigned, as this ID is assigned at the time of object construction - it may be subject to race conditions
-         * In case nodes are loaded or constructed in async manner - consider using your own ID assignment scheme
-         * @type {number}
-         */
-        this.id = node_id_counter++;
+    /**
+     * A unique identifier in the scope of a single registry
+     * If two nodes belong to the same registry - they must have different IDs
+     * By default an auto-incrementing ID is assigned, as this ID is assigned at the time of object construction - it may be subject to race conditions
+     * In case nodes are loaded or constructed in async manner - consider using your own ID assignment scheme
+     * @type {number}
+     */
+    id = node_id_counter++;
 
-        /**
-         * @protected
-         * @type {Port[]}
-         */
-        this.ports = [];
+    /**
+     * @protected
+     * @type {Port[]}
+     */
+    ports = [];
+
+    /**
+     *
+     * @type {NodeParameterDescription[]}
+     */
+    parameters = [];
 
+    /**
+     * @readonly
+     */
+    on = {
         /**
-         *
-         * @type {NodeParameterDescription[]}
+         * @readonly
+         * @type {Signal<Port>}
          */
-        this.parameters = [];
-
+        portAdded: new Signal(),
         /**
          * @readonly
+         * @type {Signal<Port>}
          */
-        this.on = {
-            /**
-             * @readonly
-             * @type {Signal<Port>}
-             */
-            portAdded: new Signal(),
-            /**
-             * @readonly
-             * @type {Signal<Port>}
-             */
-            portRemoved: new Signal()
-        };
-    }
+        portRemoved: new Signal()
+    };
 
     /**
      * Perform additional processing on the node instance
@@ -382,7 +380,7 @@ export class NodeDescription {
      * @param name
      * @param {NodeRegistry} registry
      */
-    fromJSON({ ports, id, name }, registry) {
+    fromJSON({ports, id, name}, registry) {
         this.id = id;
         this.name = name;
         this.ports = ports.map(p => Port.fromJSON(p, registry));

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

@@ -1,10 +1,10 @@
-import { assert } from "../../../assert.js";
+import {assert} from "../../../assert.js";
+import {isArrayEqual} from "../../../collection/array/isArrayEqual.js";
 import List from "../../../collection/list/List.js";
-import { NodeInstancePortReference } from "./NodeInstancePortReference.js";
-import { PortDirection } from "./PortDirection.js";
-import { isArrayEqual } from "../../../collection/array/isArrayEqual.js";
-import { objectDeepEquals } from "../../object/objectDeepEquals.js";
 import Signal from "../../../events/signal/Signal.js";
+import {objectDeepEquals} from "../../object/objectDeepEquals.js";
+import {NodeInstancePortReference} from "./NodeInstancePortReference.js";
+import {PortDirection} from "./PortDirection.js";
 
 /**
  *
@@ -13,73 +13,72 @@ import Signal from "../../../events/signal/Signal.js";
 let id_counter = 0;
 
 export class NodeInstance {
-    constructor() {
-        /**
-         *
-         * @type {number}
-         */
-        this.id = id_counter++;
 
-        /**
-         *
-         * @type {NodeDescription}
-         */
-        this.description = null;
+    /**
+     *
+     * @type {number}
+     */
+    id = id_counter++;
 
-        /**
-         *
-         * @type {NodeInstancePortReference[]}
-         */
-        this.endpoints = [];
+    /**
+     *
+     * @type {NodeDescription}
+     */
+    description = null;
 
-        /**
-         * Internal instance data
-         * @type {Object}
-         */
-        this.parameters = {};
+    /**
+     *
+     * @type {NodeInstancePortReference[]}
+     */
+    endpoints = [];
 
-        /**
-         * @transient
-         * @type {Array}
-         */
-        this.outputsValues = [];
+    /**
+     * Internal instance data
+     * @type {Object}
+     */
+    parameters = {};
+
+    /**
+     * @transient
+     * @type {Array}
+     */
+    outputsValues = [];
 
+    /**
+     *
+     * @type {List<Connection>}
+     */
+    connections = new List();
+
+    /**
+     * Extra ports that are present just on this instance, these exist in addition to ports from the description
+     * IDs of these ports must not collide with IDs of ports on the description
+     * TODO implement functionality
+     * @protected
+     * @type {Port[]}
+     */
+    dynamicPorts = [];
+
+    /**
+     * @readonly
+     */
+    on = {
         /**
-         *
-         * @type {List<Connection>}
+         * @readonly
+         * @type {Signal<string, *, *>}
          */
-        this.connections = new List();
-
+        parameterChanged: new Signal(),
         /**
-         * Extra ports that are present just on this instance, these exist in addition to ports from the description
-         * IDs of these ports must not collide with IDs of ports on the description
-         * TODO implement functionality
-         * @protected
-         * @type {Port[]}
+         * @readonly
+         * @type {Signal<string, *>}
          */
-        this.dynamicPorts = [];
-
+        parameterAdded: new Signal(),
         /**
          * @readonly
+         * @type {Signal<string, *>}
          */
-        this.on = {
-            /**
-             * @readonly
-             * @type {Signal<string, *, *>}
-             */
-            parameterChanged: new Signal(),
-            /**
-             * @readonly
-             * @type {Signal<string, *>}
-             */
-            parameterAdded: new Signal(),
-            /**
-             * @readonly
-             * @type {Signal<string, *>}
-             */
-            parameterRemoved: new Signal(),
-        };
-    }
+        parameterRemoved: new Signal(),
+    };
 
     /**
      *

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

@@ -1,5 +1,5 @@
-import { assert } from "../../../assert.js";
-import { computeHashIntegerArray } from "../../../collection/array/computeHashIntegerArray.js";
+import {assert} from "../../../assert.js";
+import {computeHashIntegerArray} from "../../../collection/array/computeHashIntegerArray.js";
 
 /**
  *
@@ -12,33 +12,31 @@ let id_counter = 0;
  */
 export class NodeInstancePortReference {
 
-    constructor() {
-        /**
-         * @readonly
-         * @type {number}
-         */
-        this.id = id_counter++;
-
-        /**
-         * @readonly
-         * @type {NodeInstance}
-         */
-        this.instance = null;
-
-        /**
-         * @readonly
-         * @type {Port}
-         */
-        this.port = null;
-
-        /**
-         * Attached connections
-         * NOTE: Maintained by NodeGraph, do not modify
-         * @readonly
-         * @type {Connection[]}
-         */
-        this.connections = [];
-    }
+    /**
+     * @readonly
+     * @type {number}
+     */
+    id = id_counter++;
+
+    /**
+     * @readonly
+     * @type {NodeInstance}
+     */
+    instance = null;
+
+    /**
+     * @readonly
+     * @type {Port}
+     */
+    port = null;
+
+    /**
+     * Attached connections
+     * NOTE: Maintained by NodeGraph, do not modify
+     * @readonly
+     * @type {Connection[]}
+     */
+    connections = [];
 
     /**
      * Outgoing connections

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

@@ -1,8 +1,8 @@
-import { assert } from "../../../assert.js";
-import { BitSet } from "../../../binary/BitSet.js";
-import { DataType } from "../DataType.js";
-import { NodeDescription } from "./NodeDescription.js";
-import { Port } from "./Port.js";
+import {assert} from "../../../assert.js";
+import {BitSet} from "../../../binary/BitSet.js";
+import {DataType} from "../DataType.js";
+import {NodeDescription} from "./NodeDescription.js";
+import {Port} from "./Port.js";
 
 /**
  *
@@ -14,19 +14,17 @@ function getPortType(port) {
 }
 
 export class NodeRegistry {
-    constructor() {
-        /**
-         * ID -> Node mapping
-         * @type {Map<number, NodeDescription>}
-         */
-        this.nodes = new Map();
-
-        /**
-         * ID -> DataType mapping
-         * @type {Map<number, DataType>}
-         */
-        this.types = new Map();
-    }
+    /**
+     * ID -> Node mapping
+     * @type {Map<number, NodeDescription>}
+     */
+    nodes = new Map();
+
+    /**
+     * ID -> DataType mapping
+     * @type {Map<number, DataType>}
+     */
+    types = new Map();
 
     /**
      * @returns {NodeDescription[]}

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

@@ -1,9 +1,9 @@
-import { computeStringHash } from "../../../primitives/strings/computeStringHash.js";
-import { PortDirection } from "./PortDirection.js";
-import { computeHashIntegerArray } from "../../../collection/array/computeHashIntegerArray.js";
-import { objectKeyByValue } from "../../object/objectKeyByValue.js";
-import { DataType } from "../DataType.js";
-import { assert } from "../../../assert.js";
+import {assert} from "../../../assert.js";
+import {computeHashIntegerArray} from "../../../collection/array/computeHashIntegerArray.js";
+import {computeStringHash} from "../../../primitives/strings/computeStringHash.js";
+import {objectKeyByValue} from "../../object/objectKeyByValue.js";
+import {DataType} from "../DataType.js";
+import {PortDirection} from "./PortDirection.js";
 
 /**
  * @type {number}
@@ -11,37 +11,35 @@ import { assert } from "../../../assert.js";
 let id_counter = 0;
 
 export class Port {
-    constructor() {
-        /**
-         *
-         * @type {String}
-         */
-        this.name = "";
-
-        /**
-         * ID uniquely identifies object within some context. Ids are assumed to be immutable
-         * @type {number}
-         */
-        this.id = id_counter++;
-
-        /**
-         *
-         * @type {PortDirection|number}
-         */
-        this.direction = PortDirection.Unspecified;
-
-        /**
-         *
-         * @type {DataType}
-         */
-        this.dataType = null;
-
-        /**
-         * Unspecified user data
-         * @type {*}
-         */
-        this.metadata = {};
-    }
+    /**
+     * Human-readable label
+     * @type {String}
+     */
+    name = "";
+
+    /**
+     * ID uniquely identifies object within some context. Ids are assumed to be immutable
+     * @type {number}
+     */
+    id = id_counter++;
+
+    /**
+     *
+     * @type {PortDirection|number}
+     */
+    direction = PortDirection.Unspecified;
+
+    /**
+     *
+     * @type {DataType}
+     */
+    dataType = null;
+
+    /**
+     * Unstructured user data
+     * @type {object}
+     */
+    metadata = {};
 
     hash() {
         const dataType = this.dataType;

package/src/core/model/node-graph/node/parameter/NodeParameterDescription.js

@@ -1,18 +1,32 @@
-import { noop } from "../../../../function/Functions.js";
-import { NodeParameterDataType } from "./NodeParameterDataType.js";
+import {noop} from "../../../../function/Functions.js";
+import {NodeParameterDataType} from "./NodeParameterDataType.js";
 
 export class NodeParameterDescription {
-    constructor() {
-        this.name = "";
-        this.id = 0;
-        this.type = NodeParameterDataType.Number;
-
-        /**
-         *
-         * @type {string|number|boolean}
-         */
-        this.defaultValue = undefined;
-    }
+
+    /**
+     * Human-readable label
+     * @type {string}
+     */
+    name = "";
+
+    /**
+     * Unique integer identifier
+     * @type {number}
+     */
+    id = 0;
+
+    /**
+     *
+     * @type {NodeParameterDataType|number}
+     */
+    type = NodeParameterDataType.Number;
+
+    /**
+     *
+     * @type {string|number|boolean}
+     */
+    defaultValue = undefined;
+
 
     /**
      *

package/src/core/path/computePathDirectory.spec.js

@@ -0,0 +1,8 @@
+import {computePathDirectory} from "./computePathDirectory.js";
+
+test("basics", () => {
+    expect(computePathDirectory('')).toBe("");
+    expect(computePathDirectory('/')).toBe("");
+    expect(computePathDirectory('/hello')).toBe("");
+    expect(computePathDirectory('/hello/world')).toBe("/hello");
+});

package/src/core/process/BaseProcess.d.ts

@@ -0,0 +1,5 @@
+export class BaseProcess {
+    startup(): void
+
+    shutdown(): void
+}