@woosh/meep-engine 2.78.0 → 2.79.0

package/src/engine/ecs/ik/TwoBoneInverseKinematicsSolver.js

@@ -1,7 +1,7 @@
 import { assert } from "../../../core/assert.js";
 import { SurfacePoint3 } from "../../../core/geom/3d/SurfacePoint3.js";
 import Quaternion from "../../../core/geom/Quaternion.js";
-import { v3_computeOffsetVector } from "../../../core/geom/vec3/v3_computeOffsetVector.js";
+import { v3_displace_in_direction } from "../../../core/geom/vec3/v3_displace_in_direction.js";
 import { v3_dot } from "../../../core/geom/vec3/v3_dot.js";
 import { v3_length } from "../../../core/geom/vec3/v3_length.js";
 import Vector3 from "../../../core/geom/Vector3.js";
@@ -255,7 +255,7 @@ export class TwoBoneInverseKinematicsSolver extends IKSolver {
 
         const targetOffsetDistance = constraint.offset * limbLength;
 
-        v3_computeOffsetVector(
+        v3_displace_in_direction(
             targetPosition,
             targetOffsetDistance,
             contactPosition.x, contactPosition.y, contactPosition.z,

package/src/engine/ecs/transform-attachment/TransformAttachment.js

@@ -1,5 +1,5 @@
-import { Transform } from "../transform/Transform.js";
 import { assert } from "../../../core/assert.js";
+import { Transform } from "../transform/Transform.js";
 
 export const TransformAttachmentFlags = {
     /**
@@ -15,6 +15,7 @@ export class TransformAttachment {
 
     /**
      * transform relative to the attachment target
+     * Think of it as "local transform"
      * @type {Transform}
      */
     transform = new Transform();

package/src/engine/ecs/transform-attachment/TransformAttachmentSystem.js

@@ -1,7 +1,9 @@
+import { min2 } from "../../../core/math/min2.js";
+import { ResourceAccessKind } from "../../../core/model/ResourceAccessKind.js";
+import { ResourceAccessSpecification } from "../../../core/model/ResourceAccessSpecification.js";
 import { System } from "../System.js";
-import { TransformAttachment, TransformAttachmentFlags } from "./TransformAttachment.js";
 import { Transform } from "../transform/Transform.js";
-import { min2 } from "../../../core/math/min2.js";
+import { TransformAttachment, TransformAttachmentFlags } from "./TransformAttachment.js";
 
 /**
  * @readonly
@@ -47,7 +49,10 @@ class UpdateContext {
     }
 
     update() {
-        this.transform.multiplyTransforms(this.parent_transform, this.attachment.transform);
+        this.transform.multiplyTransforms(
+            this.parent_transform,
+            this.attachment.transform
+        );
     }
 
     /**
@@ -70,51 +75,51 @@ class UpdateContext {
     link() {
         const t_parent = this.parent_transform;
 
-        t_parent.position.onChanged.add(this.update, this);
-        t_parent.rotation.onChanged.add(this.update, this);
-        t_parent.scale.onChanged.add(this.update, this);
+        t_parent.subscribe(this.update, this);
 
         const t_attachment = this.attachment.transform;
-        t_attachment.position.onChanged.add(this.update,this);
-        t_attachment.rotation.onChanged.add(this.update,this);
-        t_attachment.scale.onChanged.add(this.update,this);
+
+        t_attachment.subscribe(this.update, this);
     }
 
     unlink() {
         const transform = this.parent_transform;
 
-        transform.position.onChanged.remove(this.update, this);
-        transform.rotation.onChanged.remove(this.update, this);
-        transform.scale.onChanged.remove(this.update, this);
+        transform.unsubscribe(this.update, this);
 
         const t_attachment = this.attachment.transform;
-        t_attachment.position.onChanged.remove(this.update,this);
-        t_attachment.rotation.onChanged.remove(this.update,this);
-        t_attachment.scale.onChanged.remove(this.update,this);
+
+        t_attachment.unsubscribe(this.update, this);
     }
 }
 
 export class TransformAttachmentSystem extends System {
+
+    /**
+     *
+     * @type {UpdateContext[]}
+     * @private
+     */
+    __contexts = [];
+
+    /**
+     *
+     * @type {UpdateContext[]}
+     * @private
+     */
+    __queue = [];
+    __queue_size = 0;
+    __queue_cursor = 0;
+
     constructor() {
         super();
 
         this.dependencies = [TransformAttachment, Transform];
 
-        /**
-         *
-         * @type {UpdateContext[]}
-         * @private
-         */
-        this.__contexts = [];
-
-        /**
-         *
-         * @type {UpdateContext[]}
-         * @private
-         */
-        this.__queue = [];
-        this.__queue_size = 0;
-        this.__queue_cursor = 0;
+        this.components_used = [
+            ResourceAccessSpecification.from(TransformAttachment, ResourceAccessKind.Read),
+            ResourceAccessSpecification.from(Transform, ResourceAccessKind.Read | ResourceAccessKind.Write),
+        ];
     }
 
     /**
@@ -142,6 +147,12 @@ export class TransformAttachmentSystem extends System {
         this.__queue[this.__queue_size++] = ctx;
     }
 
+    /**
+     *
+     * @param {number} entity
+     * @returns {boolean}
+     * @private
+     */
     __dequeue_entity(entity) {
         for (let i = 0; i < this.__queue_size; i++) {
             const ctx = this.__queue[i];
@@ -170,9 +181,7 @@ export class TransformAttachmentSystem extends System {
         ctx.entity = entity;
 
 
-        const ecd = this.entityManager.dataset;
-
-        ctx.ecd = ecd;
+        ctx.ecd = this.entityManager.dataset;
 
         if (ctx.bind_parent()) {
             this.__finalize_link(ctx);
@@ -207,12 +216,14 @@ export class TransformAttachmentSystem extends System {
 
     update(timeDelta) {
         const step_count = min2(this.__queue_size, QUEUE_ITERATION_COUNT);
+
         for (let i = 0; i < step_count; i++) {
             const index = this.__queue_cursor % this.__queue_size;
 
             const ctx = this.__queue[index];
 
             if (ctx.bind_parent()) {
+                // parent obtained
                 this.__finalize_link(ctx);
 
                 this.__queue.splice(index, 1);
@@ -222,5 +233,6 @@ export class TransformAttachmentSystem extends System {
                 this.__queue_cursor++;
             }
         }
+
     }
 }

package/src/core/graph/EdgeDirection.js

@@ -1,11 +0,0 @@
-/**
- *
- * @enum {number}
- */
-const EdgeDirection = {
-    Out: 0,
-    In: 1
-};
-
-
-export default EdgeDirection;

package/src/core/primitives/strings/prefixTree/PrefixTree.js

@@ -1,225 +0,0 @@
-import { PrefixTreeLeaf } from "./PrefixTreeLeaf.js";
-import { PrefixTreeNode } from "./PrefixTreeNode.js";
-
-export class PrefixTree extends PrefixTreeNode {
-    constructor() {
-        super();
-
-        /**
-         *
-         * @type {string}
-         */
-        this.character = "";
-
-        /**
-         *
-         * @type {PrefixTreeNode[]}
-         */
-        this.children = [];
-    }
-
-    /**
-     *
-     * @param {PrefixTreeNode} node
-     */
-    addChild(node) {
-        node.depth = this.depth + 1;
-        node.parent = this;
-
-        this.children.push(node);
-    }
-
-    /**
-     *
-     * @param {string} character
-     * @return {PrefixTree|undefined}
-     */
-    findChildByCharacter(character) {
-        const n = this.children.length;
-
-        for (let i = 0; i < n; i++) {
-            const child = this.children[i];
-
-            if (!child.isPrefixTree) {
-                continue;
-            }
-
-            if (child.character === character) {
-                return child;
-            }
-        }
-    }
-
-    /**
-     *
-     * @param {string} word
-     * @returns {PrefixTreeLeaf|undefined}
-     */
-    findLeafByWord(word) {
-
-        const n = this.children.length;
-
-        for (let i = 0; i < n; i++) {
-            const child = this.children[i];
-
-            if (!child.isPrefixTreeLeaf) {
-                continue;
-            }
-
-            if (child.word === word) {
-                return child;
-            }
-        }
-    }
-
-    /**
-     *
-     * @param {string[]} result
-     */
-    collectValues(result) {
-        const children = this.children;
-        const n = children.length;
-
-        for (let i = 0; i < n; i++) {
-            const node = children[i];
-
-            if (node.isPrefixTree) {
-                node.collectValue(result);
-            } else {
-                const values = node.values;
-                const valueCount = values.length;
-
-                for (let j = 0; j < valueCount; j++) {
-                    const value = values[j];
-
-                    result.push(value);
-                }
-            }
-        }
-    }
-
-    /**
-     *
-     * @param {string[]} result
-     * @param {string} prefix
-     */
-    findValuesByPrefix(result, prefix) {
-        const l = prefix.length;
-
-        let n = this;
-
-        for (let i = 0; i < l; i++) {
-
-            const character = prefix.charAt(i);
-            n = n.findChildByCharacter(character)
-
-            if (n === undefined) {
-                return;
-            }
-        }
-
-
-    }
-
-    /**
-     *
-     * @param {string} text
-     * @param {RegExp} splitExpression
-     * @param {boolean} stripSpecial
-     * @param {boolean} stripPunctuation
-     * @param {boolean} forceLowerCase
-     * @param {*} value
-     */
-    insertText({ text, splitExpression = /\s/, stripSpecial = true, stripPunctuation = true, forceLowerCase = true, value }) {
-        const strings = text.split(splitExpression);
-
-        const words = [];
-
-        const n = strings.length;
-
-        let i;
-
-        for (i = 0; i < n; i++) {
-            const input = strings[i];
-
-            let output = input;
-
-            if (stripSpecial) {
-                output = output.replace(/[\n\t\r]/g, '');
-            }
-
-            if (stripPunctuation) {
-                output = output.replace(/[\,\.\!\?\-\+\[\]\(\)\=\"\']/g, '');
-            }
-
-            if (forceLowerCase) {
-                output = output.toLocaleLowerCase();
-            }
-
-            if (output.length === 0) {
-                continue;
-            }
-
-            if (words.indexOf(output) !== -1) {
-                //skip, already recorded
-                continue;
-            }
-
-            words.push(output);
-        }
-
-        const wordCount = words.length;
-
-        for (i = 0; i < wordCount; i++) {
-
-            const word = words[i];
-
-            this.insertWord(word, value);
-        }
-    }
-
-    /**
-     *
-     * @param {string} word
-     * @param {*} value
-     */
-    insertWord(word, value) {
-        const n = word.length;
-
-        if (n <= this.depth) {
-            //last letter
-            let leaf = this.findLeafByWord(word);
-
-            if (leaf === undefined) {
-                leaf = new PrefixTreeLeaf();
-
-                leaf.word = word;
-
-                this.addChild(leaf);
-            }
-
-            leaf.values.push(value);
-
-        } else {
-
-            const char = word.charAt(this.depth);
-
-            let child = this.findChildByCharacter(char);
-
-            if (child === undefined) {
-                child = new PrefixTree();
-                child.character = char;
-
-                this.addChild(child);
-            }
-
-            child.insertWord(word, value);
-        }
-    }
-}
-
-/**
- * @readonly
- * @type {boolean}
- */
-PrefixTree.prototype.isPrefixTree = true;

package/src/core/primitives/strings/prefixTree/PrefixTree.spec.js

@@ -1,39 +0,0 @@
-import { PrefixTree } from "./PrefixTree.js";
-
-test('inset one letter', () => {
-    const t = new PrefixTree();
-
-    t.insertWord('a');
-
-    const child = t.findChildByCharacter('a');
-
-    expect(child.character).toBe('a');
-    expect(child.children[0].word).toBe('a');
-    expect(child.children[0].values.length).toBe(1);
-});
-
-test('insert one letter twice', () => {
-
-    const t = new PrefixTree();
-
-    t.insertWord('a');
-    t.insertWord('a');
-
-    const child = t.findChildByCharacter('a');
-
-    expect(child.character).toBe('a');
-    expect(child.children[0].word).toBe('a');
-    expect(child.children[0].values.length).toBe(2);
-});
-
-
-test('complex', () => {
-
-    const t = new PrefixTree();
-
-    "cat sat on a mat. Horse smoked a camel. Bear snored, slithered and slobbered".split(/\s/).forEach(word => {
-        t.insertWord(word);
-    });
-
-    console.log("");
-});

package/src/core/primitives/strings/prefixTree/PrefixTreeLeaf.js

@@ -1,25 +0,0 @@
-import { PrefixTreeNode } from "./PrefixTreeNode.js";
-
-export class PrefixTreeLeaf extends PrefixTreeNode {
-    constructor() {
-        super();
-
-        /**
-         * Values associated with the word
-         * @type {Array}
-         */
-        this.values = [];
-
-        /**
-         * Actual word
-         * @type {string}
-         */
-        this.word = "";
-    }
-}
-
-/**
- * @readonly
- * @type {boolean}
- */
-PrefixTreeLeaf.prototype.isPrefixTreeLeaf = true;

package/src/core/primitives/strings/prefixTree/PrefixTreeNode.js

@@ -1,16 +0,0 @@
-export class PrefixTreeNode {
-    constructor() {
-
-        /**
-         *
-         * @type {number}
-         */
-        this.depth = 0;
-
-        /**
-         *
-         * @type {PrefixTree|null}
-         */
-        this.parent = null;
-    }
-}