@woosh/meep-engine 2.44.5 → 2.44.6

package/core/model/node-graph/Connection.d.ts

@@ -5,4 +5,8 @@ export class Connection {
 
     readonly source: NodeInstancePortReference
     readonly target: NodeInstancePortReference
+
+    setSource(endpoint: NodeInstancePortReference): void
+
+    setTarget(endpoint: NodeInstancePortReference): void
 }

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

@@ -83,6 +83,8 @@ export class NodeGraph {
      * @returns {NodeInstance|undefined}
      */
     getNode(id) {
+        assert.isNonNegativeInteger(id, 'id');
+
         const nodes = this.nodes;
         const n = nodes.length;
 
@@ -98,6 +100,21 @@ export class NodeGraph {
         return undefined;
     }
 
+    /**
+     * Same as getNode but throw exception when node doesn't exist
+     * @param {number} id
+     * @returns {NodeInstance}
+     */
+    getNodeSafe(id) {
+        const result = this.getNode(id);
+
+        if (result === undefined) {
+            throw new Error(`Node ${id} not found`);
+        }
+
+        return result;
+    }
+
     /**
      *
      * @param {number} id
@@ -209,6 +226,37 @@ export class NodeGraph {
         return true;
     }
 
+    /**
+     * Same as {@link #createConnection}, but ports are identified by their named instead
+     * @param {number} sourceNode
+     * @param {string} sourcePort
+     * @param {number} targetNode
+     * @param {string} targetPort
+     * @returns {number} connection ID
+     */
+    createConnectionByPortName(
+        sourceNode, sourcePort,
+        targetNode, targetPort) {
+        const source_node_instance = this.getNodeSafe(sourceNode);
+        const target_node_instance = this.getNodeSafe(targetNode);
+
+        const source_port_object = source_node_instance.description.getPortByName(sourcePort);
+        const target_port_object = target_node_instance.description.getPortByName(targetPort);
+
+        if (source_port_object === undefined) {
+            throw new Error(`Source port '${sourcePort}' not found`);
+        }
+
+        if (target_port_object === undefined) {
+            throw new Error(`Target port '${targetPort}' not found`);
+        }
+
+        return this.createConnection(
+            sourceNode, source_port_object.id,
+            targetNode, target_port_object.id,
+        );
+    }
+
     /**
      *
      * @param {number} sourceNode

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

@@ -175,6 +175,8 @@ export class NodeInstance {
      * @returns {NodeInstancePortReference|undefined}
      */
     getEndpoint(port) {
+        assert.isNonNegativeInteger(port, 'port');
+
         const endpoints = this.endpoints;
 
         for (const endpoint of endpoints) {

package/package.json

@@ -5,7 +5,7 @@
   "productName": "Meep",
   "description": "production-ready JavaScript game engine based on Entity Component System Architecture",
   "author": "Alexander Goldring",
-  "version": "2.44.5",
+  "version": "2.44.6",
   "dependencies": {
     "gl-matrix": "3.4.3",
     "fast-levenshtein": "2.0.6",