@woosh/meep-engine 2.60.1 → 2.62.0

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
+}

package/src/core/process/WatchDog.js

@@ -1,96 +1,97 @@
-/**
- *
- * @param {function} action
- * @param {*} [actionContext]
- * @constructor
- */
-function WatchDog(action, actionContext) {
-    /**
-     *
-     * @type {Function}
-     */
-    this.action = action;
+export class WatchDog {
 
-    /**
-     *
-     * @type {*}
-     */
-    this.actionContext = actionContext;
+    timeoutId = -1;
 
-    this.timeoutId = -1;
+    timeout = 0;
 
-    this.timeout = 0;
+    __timeLastKicked = 0;
 
-    this.__timeLastKicked = 0;
+    /**
+     *
+     * @param {function} action
+     * @param {*} [actionContext]
+     * @constructor
+     */
+    constructor(action, actionContext) {
+        /**
+         *
+         * @type {Function}
+         */
+        this.action = action;
+
+        /**
+         *
+         * @type {*}
+         */
+        this.actionContext = actionContext;
+    }
 
-    this.bark = () => {
-        //
-        console.warn('WatchDog.bark');
+    bark() {
+            //
+            console.warn('WatchDog.bark');
 
-        this.action.call(this.actionContext);
-        //
-        this.timeoutId = -1;
-    };
-}
+            this.action.call(this.actionContext);
+            //
+            this.timeoutId = -1;
+        }
 
-WatchDog.prototype.start = function () {
-    //console.warn(`WatchDog.start`);
+    start() {
+        //console.warn(`WatchDog.start`);
 
-    if (this.isActive()) {
-        //do nothing
-    } else {
-        this.timeoutId = setTimeout(this.bark, this.timeout);
-        this.__timeLastKicked = Date.now();
+        if (this.isActive()) {
+            //do nothing
+        } else {
+            this.timeoutId = setTimeout(this.bark, this.timeout);
+            this.__timeLastKicked = Date.now();
+        }
     }
-};
 
-WatchDog.prototype.stop = function () {
-    //console.warn(`WatchDog.stop`);
+    stop() {
+        //console.warn(`WatchDog.stop`);
 
-    if (this.isActive()) {
-        clearTimeout(this.timeoutId);
-        this.timeoutId = -1;
-    } else {
-        //do nothing, no active timeout
+        if (this.isActive()) {
+            clearTimeout(this.timeoutId);
+            this.timeoutId = -1;
+        } else {
+            //do nothing, no active timeout
+        }
     }
-};
 
-/**
- *
- * @returns {boolean}
- */
-WatchDog.prototype.isActive = function () {
-    return this.timeoutId !== -1;
-};
+    /**
+     *
+     * @returns {boolean}
+     */
+    isActive() {
+        return this.timeoutId !== -1;
+    }
 
-/**
- *
- */
-WatchDog.prototype.kick = function () {
-    // const timeLastKicked = this.__timeLastKicked;
+    /**
+     *
+     */
+    kick() {
+        // const timeLastKicked = this.__timeLastKicked;
 
-    this.__timeLastKicked = Date.now();
+        this.__timeLastKicked = Date.now();
 
-    // const delta = timeNow - timeLastKicked;
+        // const delta = timeNow - timeLastKicked;
 
-    //TODO: remember callstack
+        //TODO: remember callstack
 
-    // console.warn(`WatchDog.kick. ${delta}ms since last`);
+        // console.warn(`WatchDog.kick. ${delta}ms since last`);
 
-    if (this.isActive()) {
-        clearTimeout(this.timeoutId);
-        this.timeoutId = setTimeout(this.bark, this.timeout);
-    } else {
-        throw new Error(`WatchDog is not active`);
+        if (this.isActive()) {
+            clearTimeout(this.timeoutId);
+            this.timeoutId = setTimeout(this.bark, this.timeout);
+        } else {
+            throw new Error(`WatchDog is not active`);
+        }
     }
-};
 
-/**
- *
- * @param {number} delay in milliseconds
- */
-WatchDog.prototype.setTimeout = function (delay) {
-    this.timeout = delay;
-};
-
-export { WatchDog };
+    /**
+     *
+     * @param {number} delay in milliseconds
+     */
+    setTimeout(delay) {
+        this.timeout = delay;
+    }
+}

package/src/core/process/action/AsynchronousAction.js

@@ -1,29 +1,31 @@
 import Signal from "../../events/signal/Signal.js";
-import { IllegalStateException } from "../../fsm/exceptions/IllegalStateException.js";
+import {IllegalStateException} from "../../fsm/exceptions/IllegalStateException.js";
 import TaskState from "../task/TaskState.js";
 
 export class AsynchronousAction {
-    constructor() {
-
-        this.on = {
-            finished: new Signal(),
-            failed: new Signal(),
-            cancelled: new Signal()
-        };
-
-        /**
-         * @protected
-         * @type {TaskState|number}
-         */
-        this.status = TaskState.INITIAL;
-
-        /**
-         *
-         * @type {*}
-         * @private
-         */
-        this.__failureReason = null;
-    }
+
+    /**
+     * @readonly
+     */
+    on = {
+        finished: new Signal(),
+        failed: new Signal(),
+        cancelled: new Signal()
+    };
+
+    /**
+     * @protected
+     * @type {TaskState|number}
+     */
+    status = TaskState.INITIAL;
+
+    /**
+     *
+     * @type {*}
+     * @private
+     */
+    __failureReason = null;
+
 
     isRunning() {
         return this.status === TaskState.RUNNING;

package/src/core/process/executor/profile/Profile.js

@@ -1,28 +1,38 @@
 export class Profile {
-    constructor() {
-        /**
-         *
-         * @type {TraceEvent[]}
-         */
-        this.traceEvents = [];
-        /**
-         * If provided displayTimeUnit is a string that specifies in which unit timestamps should be displayed. This supports values of “ms” or “ns”. By default this is value is “ms”
-         * @type {string}
-         */
-        this.displayTimeUnit = "ms";
-        /**
-         * If provided systemTraceEvents is a string of Linux ftrace data or Windows ETW trace data. This data must start with # tracer: and adhere to the Linux ftrace format or adhere to Windows ETW format.
-         * @type {string}
-         */
-        this.systemTraceEvents = "SystemTraceData";
-        this.otherData = { version: "Meep Profile v1.0" };
-        /**
-         * If provided, the stackFrames field is a dictionary of stack frames, their ids, and their parents that allows compact representation of stack traces throughout the rest of the trace file. It is optional but sometimes very useful in shrinking file sizes.
-         * @type {Object}
-         */
-        this.stackFrames = {};
-        this.samples = [];
-    }
+
+    /**
+     *
+     * @type {TraceEvent[]}
+     */
+    traceEvents = [];
+    /**
+     * If provided displayTimeUnit is a string that specifies in which unit timestamps should be displayed. This supports values of “ms” or “ns”. By default this is value is “ms”
+     * @type {string}
+     */
+    displayTimeUnit = "ms";
+    /**
+     * If provided systemTraceEvents is a string of Linux ftrace data or Windows ETW trace data. This data must start with # tracer: and adhere to the Linux ftrace format or adhere to Windows ETW format.
+     * @type {string}
+     */
+    systemTraceEvents = "SystemTraceData";
+
+    /**
+     *
+     * @type {{version: string}}
+     */
+    otherData = {version: "Meep Profile v1.0"};
+
+    /**
+     * If provided, the stackFrames field is a dictionary of stack frames, their ids, and their parents that allows compact representation of stack traces throughout the rest of the trace file. It is optional but sometimes very useful in shrinking file sizes.
+     * @type {Object}
+     */
+    stackFrames = {};
+
+    /**
+     *
+     * @type {[]}
+     */
+    samples = [];
 
     toJSON() {
         return {

package/src/core/process/executor/profile/TraceEvent.js

@@ -1,85 +1,85 @@
+/*
+ Event type              |   Event phases
+ =====================================================
+ Duration Events         |   B (begin), E (end)
+ -----------------------------------------------------
+ Complete Events         |   X
+ -----------------------------------------------------
+ Instant Events          |   i
+                         |   Deprecated: I
+ -----------------------------------------------------
+ Counter Events          |   C
+ -----------------------------------------------------
+ Async Events            |   b (nestable start), n (nestable instant), e (nestable end)
+                         |   Deprecated: S (start), T (step into), p (step past), F (end)
+ -----------------------------------------------------
+ Flow Events             |   s (start), t (step), f (end)
+ -----------------------------------------------------
+ Sample Events           |   P
+ -----------------------------------------------------
+ Object Events           |  N (created), O (snapshot), D (destroyed)
+ -----------------------------------------------------
+ Metadata Events         |  M
+ -----------------------------------------------------
+ Memory Dump Events      |  V (global), v (process)
+ -----------------------------------------------------
+ Mark Events             |  R
+ -----------------------------------------------------
+ Clock Sync Events       |  c
+ -----------------------------------------------------
+ Context Events          |  (, )
+ */
+
 export class TraceEvent {
-    constructor() {
-        /**
-         * The name of the event, as displayed in Trace Viewer
-         * @type {string}
-         */
-        this.name = "";
 
-        /**
-         * The event categories. This is a comma separated list of categories for the event. The categories can be used to hide events in the Trace Viewer UI.
-         * @type {string|undefined}
-         */
-        this.cat = undefined;
+    /**
+     * The name of the event, as displayed in Trace Viewer
+     * @type {string}
+     */
+    name = "";
+
+    /**
+     * The event categories. This is a comma separated list of categories for the event. The categories can be used to hide events in the Trace Viewer UI.
+     * @type {string|undefined}
+     */
+    cat = undefined;
 
-        /*
-         Event type              |   Event phases
-         =====================================================
-         Duration Events         |   B (begin), E (end)
-         -----------------------------------------------------
-         Complete Events         |   X
-         -----------------------------------------------------
-         Instant Events          |   i
-                                 |   Deprecated: I
-         -----------------------------------------------------
-         Counter Events          |   C
-         -----------------------------------------------------
-         Async Events            |   b (nestable start), n (nestable instant), e (nestable end)
-                                 |   Deprecated: S (start), T (step into), p (step past), F (end)
-         -----------------------------------------------------
-         Flow Events             |   s (start), t (step), f (end)
-         -----------------------------------------------------
-         Sample Events           |   P
-         -----------------------------------------------------
-         Object Events           |  N (created), O (snapshot), D (destroyed)
-         -----------------------------------------------------
-         Metadata Events         |  M
-         -----------------------------------------------------
-         Memory Dump Events      |  V (global), v (process)
-         -----------------------------------------------------
-         Mark Events             |  R
-         -----------------------------------------------------
-         Clock Sync Events       |  c
-         -----------------------------------------------------
-         Context Events          |  (, )
-         */
 
-        /**
-         * The event type. This is a single character which changes depending on the type of event being output.
-         * The valid values are listed in the table above. We will discuss each phase type below.
-         *
-         * @type {string}
-         */
-        this.ph = "";
+    /**
+     * The event type. This is a single character which changes depending on the type of event being output.
+     * The valid values are listed in the table above. We will discuss each phase type below.
+     *
+     * @type {string}
+     */
+    ph = "";
 
-        /**
-         * The tracing clock timestamp of the event. The timestamps are provided at microsecond granularity.
-         * @type {number}
-         */
-        this.ts = 0;
+    /**
+     * The tracing clock timestamp of the event. The timestamps are provided at microsecond granularity.
+     * @type {number}
+     */
+    ts = 0;
 
-        /**
-         * Optional. The thread clock timestamp of the event. The timestamps are provided at microsecond granularity.
-         * @type {string|undefined}
-         */
-        this.tts = undefined;
+    /**
+     * Optional. The thread clock timestamp of the event. The timestamps are provided at microsecond granularity.
+     * @type {string|undefined}
+     */
+    tts = undefined;
 
-        /**
-         * The process ID for the process that output this event.
-         * @type {number}
-         */
-        this.pid = 0;
+    /**
+     * The process ID for the process that output this event.
+     * @type {number}
+     */
+    pid = 0;
 
-        /**
-         * The thread ID for the thread that output this event.
-         * @type {number}
-         */
-        this.tid = 0;
+    /**
+     * The thread ID for the thread that output this event.
+     * @type {number}
+     */
+    tid = 0;
 
-        /**
-         *  Any arguments provided for the event. Some of the event types have required argument fields, otherwise, you can put any information you wish in here. The arguments are displayed in Trace Viewer when you view an event in the analysis section.
-         * @type {Object}
-         */
-        this.args = {};
-    }
+    /**
+     *  Any arguments provided for the event. Some of the event types have required argument fields, otherwise, you can put any information you wish in here. The arguments are displayed in Trace Viewer when you view an event in the analysis section.
+     * @type {Object}
+     */
+    args = {};
 }