@woosh/meep-engine 2.91.7 → 2.92.0

package/package.json

@@ -5,7 +5,7 @@
   "description": "Fully featured ECS game engine written in JavaScript",
   "type": "module",
   "author": "Alexander Goldring",
-  "version": "2.91.7",
+  "version": "2.92.0",
   "main": "build/meep.module.js",
   "module": "build/meep.module.js",
   "exports": {

package/src/core/math/euclidean_modulo.d.ts

@@ -0,0 +1,9 @@
+/**
+ * compute euclidian modulo of n % m
+ * https://en.wikipedia.org/wiki/Modulo_operation
+ * @param {number} x
+ * @param {number} m divisor
+ * @returns {number}
+ */
+export function euclidean_modulo(x: number, m: number): number;
+//# sourceMappingURL=euclidean_modulo.d.ts.map

package/src/core/math/euclidean_modulo.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"euclidean_modulo.d.ts","sourceRoot":"","sources":["../../../../src/core/math/euclidean_modulo.js"],"names":[],"mappings":"AAAA;;;;;;GAMG;AACH,oCAJW,MAAM,KACN,MAAM,GACJ,MAAM,CAMlB"}

package/src/core/math/euclidean_modulo.js

@@ -0,0 +1,12 @@
+/**
+ * compute euclidian modulo of n % m
+ * https://en.wikipedia.org/wiki/Modulo_operation
+ * @param {number} x
+ * @param {number} m divisor
+ * @returns {number}
+ */
+export function euclidean_modulo(x, m) {
+
+    return ((x % m) + m) % m;
+
+}

package/src/core/math/newton_solver_1d.js

@@ -10,7 +10,7 @@ export function newton_solver_1d(
     f,
     xStart,
     max_steps = 1000,
-    eps = 0.00000001
+    eps = 1e-7
 ) {
     let x = xStart, fx;
 

package/src/core/math/pingpong.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"pingpong.d.ts","sourceRoot":"","sources":["../../../../src/core/math/pingpong.js"],"names":[],"mappings":"AAQA;;;;;GAKG;AACH,4BAJW,MAAM,WACN,MAAM,GACL,MAAM,CAIjB"}
+{"version":3,"file":"pingpong.d.ts","sourceRoot":"","sources":["../../../../src/core/math/pingpong.js"],"names":[],"mappings":"AAEA;;;;;GAKG;AACH,4BAJW,MAAM,WACN,MAAM,GACL,MAAM,CAIjB"}

package/src/core/math/pingpong.js

@@ -1,10 +1,4 @@
-// compute euclidian modulo of m % n
-// https://en.wikipedia.org/wiki/Modulo_operation
-function euclideanModulo(n, m) {
-
-    return ((n % m) + m) % m;
-
-}
+import { euclidean_modulo } from "./euclidean_modulo.js";
 
 /**
  *
@@ -13,5 +7,5 @@ function euclideanModulo(n, m) {
  * @return {number}
  */
 export function pingpong(x, length = 1) {
-    return length - Math.abs(euclideanModulo(x, length * 2) - length);
+    return length - Math.abs(euclidean_modulo(x, length * 2) - length);
 }

package/src/core/math/separation1D.d.ts

@@ -1,10 +1,10 @@
 /**
  * Returns a number representing overlap distance between two 1D line segments.
  * Positive number indicates overlap, negative number indicates that segments do not overlap; 0 indicates that segments are touching.
- * @param {Number} a0
- * @param {Number} a1
- * @param {Number} b0
- * @param {Number} b1
+ * @param {number} a0
+ * @param {number} a1
+ * @param {number} b0
+ * @param {number} b1
  * @returns {number}
  */
 export function separation1D(a0: number, a1: number, b0: number, b1: number): number;

package/src/core/math/separation1D.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"separation1D.d.ts","sourceRoot":"","sources":["../../../../src/core/math/separation1D.js"],"names":[],"mappings":"AAIA;;;;;;;;GAQG;AACH,8EAFa,MAAM,CASlB"}
+{"version":3,"file":"separation1D.d.ts","sourceRoot":"","sources":["../../../../src/core/math/separation1D.js"],"names":[],"mappings":"AAIA;;;;;;;;GAQG;AACH,iCANW,MAAM,MACN,MAAM,MACN,MAAM,MACN,MAAM,GACJ,MAAM,CASlB"}

package/src/core/math/separation1D.js

@@ -1,14 +1,14 @@
 import { assert } from "../assert.js";
-import { min2 } from "./min2.js";
 import { max2 } from "./max2.js";
+import { min2 } from "./min2.js";
 
 /**
  * Returns a number representing overlap distance between two 1D line segments.
  * Positive number indicates overlap, negative number indicates that segments do not overlap; 0 indicates that segments are touching.
- * @param {Number} a0
- * @param {Number} a1
- * @param {Number} b0
- * @param {Number} b1
+ * @param {number} a0
+ * @param {number} a1
+ * @param {number} b0
+ * @param {number} b1
  * @returns {number}
  */
 export function separation1D(a0, a1, b0, b1) {

package/src/core/math/smoothStep.d.ts

@@ -1,9 +1,11 @@
 /**
  * Adapted from OpenGL spec
  * smoothstep performs smooth Hermite interpolation between 0 and 1 when edge0 < x < edge1. This is useful in cases where a threshold function with a smooth transition is desired.
+ * @see https://en.wikipedia.org/wiki/Smoothstep
  * @param {number} edge0
  * @param {number} edge1
  * @param {number} x
+ * @returns {number}
  */
 export function smoothStep(edge0: number, edge1: number, x: number): number;
 //# sourceMappingURL=smoothStep.d.ts.map

package/src/core/math/smoothStep.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"smoothStep.d.ts","sourceRoot":"","sources":["../../../../src/core/math/smoothStep.js"],"names":[],"mappings":"AAEA;;;;;;GAMG;AACH,kCAJW,MAAM,SACN,MAAM,KACN,MAAM,UAShB"}
+{"version":3,"file":"smoothStep.d.ts","sourceRoot":"","sources":["../../../../src/core/math/smoothStep.js"],"names":[],"mappings":"AAEA;;;;;;;;GAQG;AACH,kCALW,MAAM,SACN,MAAM,KACN,MAAM,GACJ,MAAM,CASlB"}

package/src/core/math/smoothStep.js

@@ -3,9 +3,11 @@ import { clamp01 } from "./clamp01.js";
 /**
  * Adapted from OpenGL spec
  * smoothstep performs smooth Hermite interpolation between 0 and 1 when edge0 < x < edge1. This is useful in cases where a threshold function with a smooth transition is desired.
+ * @see https://en.wikipedia.org/wiki/Smoothstep
  * @param {number} edge0
  * @param {number} edge1
  * @param {number} x
+ * @returns {number}
  */
 export function smoothStep(edge0, edge1, x) {
 

package/src/core/math/smootherStep.d.ts

@@ -0,0 +1,11 @@
+/**
+ * Ken Perlin's suggested improvement on `smoothStep` function
+ * has gentler entry and exit slope
+ * @see https://en.wikipedia.org/wiki/Smoothstep
+ * @param {number} edge0
+ * @param {number} edge1
+ * @param {number} x
+ * @returns {number}
+ */
+export function smootherStep(edge0: number, edge1: number, x: number): number;
+//# sourceMappingURL=smootherStep.d.ts.map

package/src/core/math/smootherStep.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"smootherStep.d.ts","sourceRoot":"","sources":["../../../../src/core/math/smootherStep.js"],"names":[],"mappings":"AAEA;;;;;;;;GAQG;AACH,oCALW,MAAM,SACN,MAAM,KACN,MAAM,GACJ,MAAM,CASlB"}

package/src/core/math/smootherStep.js

@@ -0,0 +1,19 @@
+import { clamp01 } from "./clamp01.js";
+
+/**
+ * Ken Perlin's suggested improvement on `smoothStep` function
+ * has gentler entry and exit slope
+ * @see https://en.wikipedia.org/wiki/Smoothstep
+ * @param {number} edge0
+ * @param {number} edge1
+ * @param {number} x
+ * @returns {number}
+ */
+export function smootherStep(edge0, edge1, x) {
+    // Scale, and clamp x to 0..1 range
+    const span = edge1 - edge0;
+
+    const t = clamp01((x - edge0) / span);
+
+    return t * t * t * (t * (6.0 * t - 15.0) + 10.0);
+}

package/src/core/math/smootherStep.spec.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=smootherStep.spec.d.ts.map

package/src/core/math/smootherStep.spec.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"smootherStep.spec.d.ts","sourceRoot":"","sources":["../../../../src/core/math/smootherStep.spec.js"],"names":[],"mappings":""}

package/src/core/math/smootherStep.spec.js

@@ -0,0 +1,16 @@
+import { smootherStep } from "./smootherStep.js";
+
+test("basics", () => {
+    expect(smootherStep(0, 1, 1)).toEqual(1);
+    expect(smootherStep(1, 2, 2)).toEqual(1);
+
+    expect(smootherStep(0, 1, 0)).toEqual(0);
+    expect(smootherStep(1, 2, 1)).toEqual(0);
+
+    expect(smootherStep(0, 1, 0.5)).toBeCloseTo(0.5);
+});
+
+test("clamping", () => {
+    expect(smootherStep(1, 2, 0)).toEqual(0);
+    expect(smootherStep(1, 2, 3)).toEqual(1);
+});

package/src/engine/animation/curve/EntityNodeAnimationClip.d.ts

@@ -0,0 +1,4 @@
+export class EntityNodeAnimationClip {
+    name: string
+    duration: number
+}

package/src/engine/animation/curve/EntityNodeAnimationClip.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"EntityNodeAnimationClip.d.ts","sourceRoot":"","sources":["../../../../../src/engine/animation/curve/EntityNodeAnimationClip.js"],"names":[],"mappings":"AAAA;IACI,aAAS;IACT;;;OAGG;IACH,QAFU,sBAAsB,CAErB;IACX,iBAAY;IAEZ,yBAMC;CACJ"}

package/src/engine/animation/curve/EntityNodeAnimationClip.js

@@ -0,0 +1,17 @@
+export class EntityNodeAnimationClip {
+    name = ""
+    /**
+     *
+     * @type {AnimatedValueBinding[]}
+     */
+    tracks = []
+    duration = 0
+
+    writeAt(time) {
+        for (let i = 0; i < this.tracks.length; i++) {
+            const track = this.tracks[i];
+
+            track.writeAt(time);
+        }
+    }
+}

package/src/engine/animation/curve/ecd_bind_animation_curve.d.ts

@@ -4,15 +4,5 @@
  * @param {AnimationClip} clip
  */
 export function convert_three_clip(node: EntityNode, clip: AnimationClip): EntityNodeAnimationClip;
-export class EntityNodeAnimationClip {
-    name: string;
-    /**
-     *
-     * @type {AnimatedValueBinding[]}
-     */
-    tracks: AnimatedValueBinding[];
-    duration: number;
-    writeAt(time: any): void;
-}
-import { AnimatedValueBinding } from "../../graphics/ecs/mesh-v2/aggregate/animation/AnimatedValueBinding.js";
+import { EntityNodeAnimationClip } from "./EntityNodeAnimationClip.js";
 //# sourceMappingURL=ecd_bind_animation_curve.d.ts.map

package/src/engine/animation/curve/ecd_bind_animation_curve.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"ecd_bind_animation_curve.d.ts","sourceRoot":"","sources":["../../../../../src/engine/animation/curve/ecd_bind_animation_curve.js"],"names":[],"mappings":"AAySA;;;;GAIG;AACH,mGAaC;AApCD;IACI,aAAS;IACT;;;OAGG;IACH,QAFU,oBAAoB,EAAE,CAErB;IACX,iBAAY;IAEZ,yBAMC;CACJ;qCAtSoC,wEAAwE"}
+{"version":3,"file":"ecd_bind_animation_curve.d.ts","sourceRoot":"","sources":["../../../../../src/engine/animation/curve/ecd_bind_animation_curve.js"],"names":[],"mappings":"AAwRA;;;;GAIG;AACH,mGAaC;wCApSuC,8BAA8B"}

package/src/engine/animation/curve/ecd_bind_animation_curve.js

@@ -4,6 +4,7 @@ import { BoundQuaternionWriter } from "../../graphics/ecs/mesh-v2/aggregate/anim
 import { BoundValueWriter } from "../../graphics/ecs/mesh-v2/aggregate/animation/BoundValueWriter.js";
 import { BoundVector3Writer } from "../../graphics/ecs/mesh-v2/aggregate/animation/BoundVector3Writer.js";
 import { AnimationCurve } from "./AnimationCurve.js";
+import { EntityNodeAnimationClip } from "./EntityNodeAnimationClip.js";
 import { Keyframe } from "./Keyframe.js";
 
 /**
@@ -277,24 +278,6 @@ function convert_three_track(track, node) {
     return AnimatedValueBinding.from(writer, curves);
 }
 
-export class EntityNodeAnimationClip {
-    name = ""
-    /**
-     *
-     * @type {AnimatedValueBinding[]}
-     */
-    tracks = []
-    duration = 0
-
-    writeAt(time) {
-        for (let i = 0; i < this.tracks.length; i++) {
-            const track = this.tracks[i];
-
-            track.writeAt(time);
-        }
-    }
-}
-
 /**
  * Three.js clip to internal representation
  * @param {EntityNode} node

package/src/engine/graphics/ecs/mesh-v2/aggregate/SGAnimationPlayback.d.ts

@@ -0,0 +1,5 @@
+export class SGAnimationPlayback {
+    clip_name: string
+    time: number
+    loop: boolean
+}

package/src/engine/graphics/ecs/mesh-v2/aggregate/SGAnimationPlayback.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"SGAnimationPlayback.d.ts","sourceRoot":"","sources":["../../../../../../../src/engine/graphics/ecs/mesh-v2/aggregate/SGAnimationPlayback.js"],"names":[],"mappings":"AAAA;IACI,kBAAc;IACd,aAAQ;IACR,cAAY;CACf"}

package/src/engine/graphics/ecs/mesh-v2/aggregate/SGAnimationPlayback.js

@@ -0,0 +1,5 @@
+export class SGAnimationPlayback {
+    clip_name = ""
+    time = 0
+    loop = false
+}

package/src/engine/graphics/ecs/mesh-v2/aggregate/SGMeshAnimationController.d.ts

@@ -1,44 +1,12 @@
-export class SGMeshAnimationController {
-    /**
-     *
-     * @type {AnimationPlayback[]}
-     */
-    active: AnimationPlayback[];
-    /**
-     *
-     * @type {EntityNodeAnimationClip[]}
-     */
-    bound: EntityNodeAnimationClip[];
-    /**
-     *
-     * @param {string} name
-     * @return {EntityNodeAnimationClip|undefined}
-     */
-    getBoundByName(name: string): EntityNodeAnimationClip | undefined;
-    /**
-     *
-     * @param {string} name
-     * @return {AnimationPlayback|undefined}
-     */
-    getActiveByName(name: string): AnimationPlayback | undefined;
-    /**
-     *
-     * @param {string} name
-     * @param {boolean} loop
-     * @param {number} time_offset
-     * @returns {AnimationPlayback}
-     */
-    start(name: string, loop?: boolean, time_offset?: number): AnimationPlayback;
-    /**
-     *
-     * @param {AnimationPlayback} playback
-     * @return {boolean}
-     */
-    stop(playback: AnimationPlayback): boolean;
-}
-export class AnimationPlayback {
-    clip_name: string;
-    time: number;
-    loop: boolean;
-}
-//# sourceMappingURL=SGMeshAnimationController.d.ts.map
+import {EntityNodeAnimationClip} from "../../../../animation/curve/EntityNodeAnimationClip";
+import {SGAnimationPlayback} from "./SGAnimationPlayback";
+
+export class SGMeshAnimationController {
+    readonly bound: EntityNodeAnimationClip[]
+
+    start(name: string, loop?: boolean, time_offset?: number): SGAnimationPlayback
+
+    stop(playback: SGAnimationPlayback): boolean
+
+    getActiveByName(name: string): SGAnimationPlayback | undefined
+}

package/src/engine/graphics/ecs/mesh-v2/aggregate/SGMeshAnimationController.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"SGMeshAnimationController.d.ts","sourceRoot":"","sources":["../../../../../../../src/engine/graphics/ecs/mesh-v2/aggregate/SGMeshAnimationController.js"],"names":[],"mappings":"AAGA;IACI;;;OAGG;IACH,QAFU,iBAAiB,EAAE,CAElB;IAEX;;;OAGG;IACH,OAFU,yBAAyB,CAEzB;IAEV;;;;OAIG;IACH,qBAHW,MAAM,GACL,0BAAwB,SAAS,CAM5C;IAED;;;;OAIG;IACH,sBAHW,MAAM,GACL,iBAAiB,GAAC,SAAS,CAMtC;IAGD;;;;;;OAMG;IACH,YALW,MAAM,SACN,OAAO,gBACP,MAAM,GACJ,iBAAiB,CAgB7B;IAED;;;;OAIG;IACH,eAHW,iBAAiB,GAChB,OAAO,CAQlB;CACJ;AAED;IACI,kBAAc;IACd,aAAQ;IACR,cAAY;CACf"}
+{"version":3,"file":"SGMeshAnimationController.d.ts","sourceRoot":"","sources":["../../../../../../../src/engine/graphics/ecs/mesh-v2/aggregate/SGMeshAnimationController.js"],"names":[],"mappings":"AAIA;IACI;;;OAGG;IACH,QAFU,mBAAmB,EAAE,CAEpB;IAEX;;;OAGG;IACH,OAFU,yBAAyB,CAEzB;IAEV;;;;OAIG;IACH,qBAHW,MAAM,GACL,0BAAwB,SAAS,CAM5C;IAED;;;;OAIG;IACH,sBAHW,MAAM,GACL,mBAAmB,GAAC,SAAS,CAMxC;IAGD;;;;;;OAMG;IACH,YALW,MAAM,SACN,OAAO,gBACP,MAAM,GACJ,mBAAmB,CAgB/B;IAED;;;;OAIG;IACH,eAHW,mBAAmB,GAClB,OAAO,CAQlB;CACJ;oCAzEmC,0BAA0B"}

package/src/engine/graphics/ecs/mesh-v2/aggregate/SGMeshAnimationController.js

@@ -1,10 +1,11 @@
 import { assert } from "../../../../../core/assert.js";
 import { array_remove_first } from "../../../../../core/collection/array/array_remove_first.js";
+import { SGAnimationPlayback } from "./SGAnimationPlayback.js";
 
 export class SGMeshAnimationController {
     /**
      *
-     * @type {AnimationPlayback[]}
+     * @type {SGAnimationPlayback[]}
      */
     active = []
 
@@ -28,7 +29,7 @@ export class SGMeshAnimationController {
     /**
      *
      * @param {string} name
-     * @return {AnimationPlayback|undefined}
+     * @return {SGAnimationPlayback|undefined}
      */
     getActiveByName(name) {
         assert.isString(name, 'name');
@@ -42,14 +43,14 @@ export class SGMeshAnimationController {
      * @param {string} name
      * @param {boolean} loop
      * @param {number} time_offset
-     * @returns {AnimationPlayback}
+     * @returns {SGAnimationPlayback}
      */
     start(name, loop = false, time_offset = 0) {
         assert.isString(name, 'name');
         assert.isBoolean(loop, 'loop');
         assert.isNumber(time_offset, 'time_offset');
 
-        const playback = new AnimationPlayback();
+        const playback = new SGAnimationPlayback();
 
         playback.clip_name = name;
         playback.loop = loop;
@@ -62,7 +63,7 @@ export class SGMeshAnimationController {
 
     /**
      *
-     * @param {AnimationPlayback} playback
+     * @param {SGAnimationPlayback} playback
      * @return {boolean}
      */
     stop(playback) {
@@ -74,8 +75,3 @@ export class SGMeshAnimationController {
     }
 }
 
-export class AnimationPlayback {
-    clip_name = ""
-    time = 0
-    loop = false
-}

package/src/engine/graphics/ecs/mesh-v2/aggregate/SGMeshAnimationControllerSystem.d.ts

@@ -1,24 +1,8 @@
-export class SGMeshAnimationControllerSystem extends System<any, any, any, any, any> {
-    /**
-     *
-     * @param {Engine} engine
-     */
-    constructor(engine: Engine);
-    engine: Engine;
-    dependencies: (typeof SGMesh | typeof SGMeshAnimationController)[];
-    components_used: (ResourceAccessSpecification<typeof SGMesh> | ResourceAccessSpecification<typeof SGMeshAnimationController>)[];
-    /**
-     *
-     * @param {SGMeshAnimationController} anim
-     * @param {SGMesh} mesh
-     * @param {number} entity
-     */
-    link(anim: SGMeshAnimationController, mesh: SGMesh, entity: number): Promise<void>;
-    update(td: any): void;
-    #private;
-}
-import { System } from "../../../../ecs/System.js";
-import { SGMesh } from "./SGMesh.js";
-import { SGMeshAnimationController } from "./SGMeshAnimationController.js";
-import { ResourceAccessSpecification } from "../../../../../core/model/ResourceAccessSpecification.js";
-//# sourceMappingURL=SGMeshAnimationControllerSystem.d.ts.map
+import {System} from "../../../../ecs/System";
+import Engine from "../../../../Engine";
+import {SGMesh} from "./SGMesh";
+import {SGMeshAnimationController} from "./SGMeshAnimationController";
+
+export class SGMeshAnimationControllerSystem extends System<SGMeshAnimationController,SGMesh>{
+    constructor(engine:Engine)
+}