@needle-tools/engine 4.4.0-beta.3 → 4.4.0-beta.5

package/lib/engine-components/AxesHelper.d.ts

@@ -1,32 +1,32 @@
-import { Behaviour } from "./Component.js";
-/**
- * Component that visualizes the axes of an object in the scene.
- * Renders colored lines representing the X (red), Y (green) and Z (blue) axes.
- * @category Helpers
- * @group Components
- */
-export declare class AxesHelper extends Behaviour {
-    /**
-     * The length of each axis line in scene units.
-     */
-    length: number;
-    /**
-     * Whether the axes should be occluded by objects in the scene.
-     * When set to false, axes will always appear on top regardless of their depth.
-     */
-    depthTest: boolean;
-    /**
-     * When true, this helper will only be visible if the debug flag `?gizmos` is enabled.
-     */
-    isGizmo: boolean;
-    private _axes;
-    /**
-     * Creates and adds the axes visualization to the scene when the component is enabled.
-     * If marked as a gizmo, it will only be shown when gizmos are enabled in the global parameters.
-     */
-    onEnable(): void;
-    /**
-     * Removes the axes visualization from the scene when the component is disabled.
-     */
-    onDisable(): void;
-}
+import { Behaviour } from "./Component.js";
+/**
+ * Component that visualizes the axes of an object in the scene.
+ * Renders colored lines representing the X (red), Y (green) and Z (blue) axes.
+ * @category Helpers
+ * @group Components
+ */
+export declare class AxesHelper extends Behaviour {
+    /**
+     * The length of each axis line in scene units.
+     */
+    length: number;
+    /**
+     * Whether the axes should be occluded by objects in the scene.
+     * When set to false, axes will always appear on top regardless of their depth.
+     */
+    depthTest: boolean;
+    /**
+     * When true, this helper will only be visible if the debug flag `?gizmos` is enabled.
+     */
+    isGizmo: boolean;
+    private _axes;
+    /**
+     * Creates and adds the axes visualization to the scene when the component is enabled.
+     * If marked as a gizmo, it will only be shown when gizmos are enabled in the global parameters.
+     */
+    onEnable(): void;
+    /**
+     * Removes the axes visualization from the scene when the component is disabled.
+     */
+    onDisable(): void;
+}

package/lib/engine-components/AxesHelper.js

@@ -1,68 +1,68 @@
-var __decorate = (this && this.__decorate) || function (decorators, target, key, desc) {
-    var c = arguments.length, r = c < 3 ? target : desc === null ? desc = Object.getOwnPropertyDescriptor(target, key) : desc, d;
-    if (typeof Reflect === "object" && typeof Reflect.decorate === "function") r = Reflect.decorate(decorators, target, key, desc);
-    else for (var i = decorators.length - 1; i >= 0; i--) if (d = decorators[i]) r = (c < 3 ? d(r) : c > 3 ? d(target, key, r) : d(target, key)) || r;
-    return c > 3 && r && Object.defineProperty(target, key, r), r;
-};
-import { AxesHelper as _AxesHelper } from "three";
-import * as params from "../engine/engine_default_parameters.js";
-import { serializable } from "../engine/engine_serialization_decorator.js";
-import { Behaviour } from "./Component.js";
-/**
- * Component that visualizes the axes of an object in the scene.
- * Renders colored lines representing the X (red), Y (green) and Z (blue) axes.
- * @category Helpers
- * @group Components
- */
-export class AxesHelper extends Behaviour {
-    /**
-     * The length of each axis line in scene units.
-     */
-    length = 1;
-    /**
-     * Whether the axes should be occluded by objects in the scene.
-     * When set to false, axes will always appear on top regardless of their depth.
-     */
-    depthTest = true;
-    /**
-     * When true, this helper will only be visible if the debug flag `?gizmos` is enabled.
-     */
-    isGizmo = false;
-    _axes = null;
-    /**
-     * Creates and adds the axes visualization to the scene when the component is enabled.
-     * If marked as a gizmo, it will only be shown when gizmos are enabled in the global parameters.
-     */
-    onEnable() {
-        if (this.isGizmo && !params.showGizmos)
-            return;
-        if (!this._axes)
-            this._axes = new _AxesHelper(this.length);
-        this._axes.layers.disableAll();
-        this._axes.layers.set(this.layer);
-        this.gameObject.add(this._axes);
-        const mat = this._axes.material;
-        if (mat) {
-            if (mat.depthTest !== undefined)
-                mat.depthTest = this.depthTest;
-        }
-    }
-    /**
-     * Removes the axes visualization from the scene when the component is disabled.
-     */
-    onDisable() {
-        if (!this._axes)
-            return;
-        this.gameObject.remove(this._axes);
-    }
-}
-__decorate([
-    serializable()
-], AxesHelper.prototype, "length", void 0);
-__decorate([
-    serializable()
-], AxesHelper.prototype, "depthTest", void 0);
-__decorate([
-    serializable()
-], AxesHelper.prototype, "isGizmo", void 0);
+var __decorate = (this && this.__decorate) || function (decorators, target, key, desc) {
+    var c = arguments.length, r = c < 3 ? target : desc === null ? desc = Object.getOwnPropertyDescriptor(target, key) : desc, d;
+    if (typeof Reflect === "object" && typeof Reflect.decorate === "function") r = Reflect.decorate(decorators, target, key, desc);
+    else for (var i = decorators.length - 1; i >= 0; i--) if (d = decorators[i]) r = (c < 3 ? d(r) : c > 3 ? d(target, key, r) : d(target, key)) || r;
+    return c > 3 && r && Object.defineProperty(target, key, r), r;
+};
+import { AxesHelper as _AxesHelper } from "three";
+import * as params from "../engine/engine_default_parameters.js";
+import { serializable } from "../engine/engine_serialization_decorator.js";
+import { Behaviour } from "./Component.js";
+/**
+ * Component that visualizes the axes of an object in the scene.
+ * Renders colored lines representing the X (red), Y (green) and Z (blue) axes.
+ * @category Helpers
+ * @group Components
+ */
+export class AxesHelper extends Behaviour {
+    /**
+     * The length of each axis line in scene units.
+     */
+    length = 1;
+    /**
+     * Whether the axes should be occluded by objects in the scene.
+     * When set to false, axes will always appear on top regardless of their depth.
+     */
+    depthTest = true;
+    /**
+     * When true, this helper will only be visible if the debug flag `?gizmos` is enabled.
+     */
+    isGizmo = false;
+    _axes = null;
+    /**
+     * Creates and adds the axes visualization to the scene when the component is enabled.
+     * If marked as a gizmo, it will only be shown when gizmos are enabled in the global parameters.
+     */
+    onEnable() {
+        if (this.isGizmo && !params.showGizmos)
+            return;
+        if (!this._axes)
+            this._axes = new _AxesHelper(this.length);
+        this._axes.layers.disableAll();
+        this._axes.layers.set(this.layer);
+        this.gameObject.add(this._axes);
+        const mat = this._axes.material;
+        if (mat) {
+            if (mat.depthTest !== undefined)
+                mat.depthTest = this.depthTest;
+        }
+    }
+    /**
+     * Removes the axes visualization from the scene when the component is disabled.
+     */
+    onDisable() {
+        if (!this._axes)
+            return;
+        this.gameObject.remove(this._axes);
+    }
+}
+__decorate([
+    serializable()
+], AxesHelper.prototype, "length", void 0);
+__decorate([
+    serializable()
+], AxesHelper.prototype, "depthTest", void 0);
+__decorate([
+    serializable()
+], AxesHelper.prototype, "isGizmo", void 0);
 //# sourceMappingURL=AxesHelper.js.map

package/lib/engine-components/BasicIKConstraint.d.ts

@@ -1,9 +1,9 @@
-import { Behaviour } from "./Component.js";
-export declare class BasicIKConstraint extends Behaviour {
-    private from;
-    private to;
-    private hint;
-    private desiredDistance;
-    onEnable(): void;
-    update(): void;
-}
+import { Behaviour } from "./Component.js";
+export declare class BasicIKConstraint extends Behaviour {
+    private from;
+    private to;
+    private hint;
+    private desiredDistance;
+    onEnable(): void;
+    update(): void;
+}

package/lib/engine-components/BasicIKConstraint.js

@@ -1,44 +1,44 @@
-import { Vector3 } from "three";
-import * as utils from "./../engine/engine_three_utils.js";
-import { Behaviour } from "./Component.js";
-export class BasicIKConstraint extends Behaviour {
-    from;
-    to;
-    hint;
-    desiredDistance = 1;
-    onEnable() {
-        // console.log(this);
-    }
-    update() {
-        if (!this.from || !this.to || !this.hint)
-            return;
-        // console.log(this);
-        // find center
-        const toPos = utils.getWorldPosition(this.to).clone();
-        const fromPos = utils.getWorldPosition(this.from).clone();
-        const dist = toPos.distanceTo(fromPos);
-        const dir0 = toPos.clone();
-        dir0.sub(fromPos);
-        const center = fromPos.clone();
-        center.add(toPos);
-        center.multiplyScalar(0.5);
-        // find direction we should offset in
-        const hintDir = utils.getWorldPosition(this.hint).clone();
-        hintDir.sub(center);
-        const offsetDir = new Vector3();
-        offsetDir.crossVectors(hintDir, dir0);
-        offsetDir.crossVectors(dir0, offsetDir);
-        offsetDir.normalize();
-        const halfDist = dist * 0.5;
-        const stretchDistance = Math.max(this.desiredDistance, halfDist);
-        const offsetLength = Math.sqrt(stretchDistance * stretchDistance - halfDist * halfDist);
-        const resultPos = offsetDir.clone();
-        resultPos.multiplyScalar(offsetLength);
-        resultPos.add(center);
-        utils.setWorldPosition(this.gameObject, resultPos);
-        const lookPos = center.clone();
-        lookPos.sub(offsetDir);
-        this.gameObject.lookAt(lookPos);
-    }
-}
+import { Vector3 } from "three";
+import * as utils from "./../engine/engine_three_utils.js";
+import { Behaviour } from "./Component.js";
+export class BasicIKConstraint extends Behaviour {
+    from;
+    to;
+    hint;
+    desiredDistance = 1;
+    onEnable() {
+        // console.log(this);
+    }
+    update() {
+        if (!this.from || !this.to || !this.hint)
+            return;
+        // console.log(this);
+        // find center
+        const toPos = utils.getWorldPosition(this.to).clone();
+        const fromPos = utils.getWorldPosition(this.from).clone();
+        const dist = toPos.distanceTo(fromPos);
+        const dir0 = toPos.clone();
+        dir0.sub(fromPos);
+        const center = fromPos.clone();
+        center.add(toPos);
+        center.multiplyScalar(0.5);
+        // find direction we should offset in
+        const hintDir = utils.getWorldPosition(this.hint).clone();
+        hintDir.sub(center);
+        const offsetDir = new Vector3();
+        offsetDir.crossVectors(hintDir, dir0);
+        offsetDir.crossVectors(dir0, offsetDir);
+        offsetDir.normalize();
+        const halfDist = dist * 0.5;
+        const stretchDistance = Math.max(this.desiredDistance, halfDist);
+        const offsetLength = Math.sqrt(stretchDistance * stretchDistance - halfDist * halfDist);
+        const resultPos = offsetDir.clone();
+        resultPos.multiplyScalar(offsetLength);
+        resultPos.add(center);
+        utils.setWorldPosition(this.gameObject, resultPos);
+        const lookPos = center.clone();
+        lookPos.sub(offsetDir);
+        this.gameObject.lookAt(lookPos);
+    }
+}
 //# sourceMappingURL=BasicIKConstraint.js.map

package/lib/engine-components/BoxCollider.d.ts

@@ -1,2 +1,2 @@
-import { BoxCollider } from "./Collider.js";
-export default BoxCollider;
+import { BoxCollider } from "./Collider.js";
+export default BoxCollider;

package/lib/engine-components/BoxCollider.js

@@ -1,3 +1,3 @@
-import { BoxCollider } from "./Collider.js";
-export default BoxCollider;
+import { BoxCollider } from "./Collider.js";
+export default BoxCollider;
 //# sourceMappingURL=BoxCollider.js.map

package/lib/engine-components/BoxHelperComponent.d.ts

@@ -1,47 +1,47 @@
-import { Box3, type ColorRepresentation, Object3D } from "three";
-import { Behaviour } from "./Component.js";
-/**
- * A component that creates a bounding box around an object and provides intersection testing functionality.
- *
- * Debug mode can be enabled with the URL parameter `?debugboxhelper`, which will visualize intersection tests.
- * Helper visualization can be enabled with the URL parameter `?gizmos`.
- *
- * @category Helpers
- * @group Components
- */
-export declare class BoxHelperComponent extends Behaviour {
-    /** The bounding box for this component */
-    private box;
-    private static testBox;
-    private _lastMatrixUpdateFrame;
-    private static _position;
-    private static _size;
-    private static _emptyObjectSize;
-    /**
-     * Tests if an object intersects with this helper's bounding box
-     * @param obj The object to test for intersection
-     * @returns True if objects intersect, false if not, undefined if the provided object is invalid
-     */
-    isInBox(obj: Object3D): boolean | undefined;
-    /**
-     * Tests if this helper's bounding box intersects with another box
-     * @param box The {@link Box3} to test for intersection
-     * @returns True if boxes intersect, false otherwise
-     */
-    intersects(box: Box3): boolean;
-    /**
-     * Updates the helper's bounding box based on the gameObject's position and scale
-     * @param force Whether to force an update regardless of frame count
-     * @returns The updated {@link Box3}
-     */
-    updateBox(force?: boolean): Box3;
-    private _helper;
-    private _color;
-    awake(): void;
-    /**
-     * Creates and displays a visual wireframe representation of this box helper
-     * @param col Optional color for the wireframe. If not provided, uses default color
-     * @param force If true, shows the helper even if gizmos are disabled
-     */
-    showHelper(col?: ColorRepresentation | null, force?: boolean): void;
-}
+import { Box3, type ColorRepresentation, Object3D } from "three";
+import { Behaviour } from "./Component.js";
+/**
+ * A component that creates a bounding box around an object and provides intersection testing functionality.
+ *
+ * Debug mode can be enabled with the URL parameter `?debugboxhelper`, which will visualize intersection tests.
+ * Helper visualization can be enabled with the URL parameter `?gizmos`.
+ *
+ * @category Helpers
+ * @group Components
+ */
+export declare class BoxHelperComponent extends Behaviour {
+    /** The bounding box for this component */
+    private box;
+    private static testBox;
+    private _lastMatrixUpdateFrame;
+    private static _position;
+    private static _size;
+    private static _emptyObjectSize;
+    /**
+     * Tests if an object intersects with this helper's bounding box
+     * @param obj The object to test for intersection
+     * @returns True if objects intersect, false if not, undefined if the provided object is invalid
+     */
+    isInBox(obj: Object3D): boolean | undefined;
+    /**
+     * Tests if this helper's bounding box intersects with another box
+     * @param box The {@link Box3} to test for intersection
+     * @returns True if boxes intersect, false otherwise
+     */
+    intersects(box: Box3): boolean;
+    /**
+     * Updates the helper's bounding box based on the gameObject's position and scale
+     * @param force Whether to force an update regardless of frame count
+     * @returns The updated {@link Box3}
+     */
+    updateBox(force?: boolean): Box3;
+    private _helper;
+    private _color;
+    awake(): void;
+    /**
+     * Creates and displays a visual wireframe representation of this box helper
+     * @param col Optional color for the wireframe. If not provided, uses default color
+     * @param force If true, shows the helper even if gizmos are disabled
+     */
+    showHelper(col?: ColorRepresentation | null, force?: boolean): void;
+}

package/lib/engine-components/BoxHelperComponent.js

@@ -1,103 +1,103 @@
-import { Box3, Vector3 } from "three";
-import { CreateWireCube, Gizmos } from "../engine/engine_gizmos.js";
-import { getBoundingBox, getWorldPosition, getWorldScale } from "../engine/engine_three_utils.js";
-import { getParam } from "../engine/engine_utils.js";
-import { Behaviour } from "./Component.js";
-const gizmos = getParam("gizmos");
-const debug = getParam("debugboxhelper");
-/**
- * A component that creates a bounding box around an object and provides intersection testing functionality.
- *
- * Debug mode can be enabled with the URL parameter `?debugboxhelper`, which will visualize intersection tests.
- * Helper visualization can be enabled with the URL parameter `?gizmos`.
- *
- * @category Helpers
- * @group Components
- */
-export class BoxHelperComponent extends Behaviour {
-    /** The bounding box for this component */
-    box = null;
-    static testBox = new Box3();
-    _lastMatrixUpdateFrame = -1;
-    static _position = new Vector3();
-    static _size = new Vector3(.01, .01, .01);
-    static _emptyObjectSize = new Vector3(.01, .01, .01);
-    /**
-     * Tests if an object intersects with this helper's bounding box
-     * @param obj The object to test for intersection
-     * @returns True if objects intersect, false if not, undefined if the provided object is invalid
-     */
-    isInBox(obj) {
-        if (!obj)
-            return undefined;
-        if (!this.box) {
-            this.box = new Box3();
-        }
-        getBoundingBox([obj], undefined, undefined, BoxHelperComponent.testBox);
-        if (BoxHelperComponent.testBox.isEmpty()) {
-            const wp = getWorldPosition(obj, BoxHelperComponent._position);
-            BoxHelperComponent.testBox.setFromCenterAndSize(wp, BoxHelperComponent._emptyObjectSize);
-        }
-        this.updateBox();
-        const intersects = this.box?.intersectsBox(BoxHelperComponent.testBox);
-        if (intersects) {
-            if (debug)
-                Gizmos.DrawWireBox3(BoxHelperComponent.testBox, 0xff0000, 5);
-        }
-        return intersects;
-    }
-    /**
-     * Tests if this helper's bounding box intersects with another box
-     * @param box The {@link Box3} to test for intersection
-     * @returns True if boxes intersect, false otherwise
-     */
-    intersects(box) {
-        if (!box)
-            return false;
-        return this.updateBox(false).intersectsBox(box);
-    }
-    /**
-     * Updates the helper's bounding box based on the gameObject's position and scale
-     * @param force Whether to force an update regardless of frame count
-     * @returns The updated {@link Box3}
-     */
-    updateBox(force = false) {
-        if (!this.box) {
-            this.box = new Box3();
-        }
-        if (force || this.context.time.frameCount != this._lastMatrixUpdateFrame) {
-            const firstUpdate = this._lastMatrixUpdateFrame < 0;
-            this._lastMatrixUpdateFrame = this.context.time.frameCount;
-            const updateParents = firstUpdate; // updating parents seems to cause falsely calculated positions sometimes?
-            const wp = getWorldPosition(this.gameObject, BoxHelperComponent._position, updateParents);
-            const size = getWorldScale(this.gameObject, BoxHelperComponent._size);
-            this.box.setFromCenterAndSize(wp, size);
-        }
-        return this.box;
-    }
-    _helper = null;
-    _color = null;
-    awake() {
-        this._helper = null;
-        this._color = null;
-        this.box = null;
-    }
-    /**
-     * Creates and displays a visual wireframe representation of this box helper
-     * @param col Optional color for the wireframe. If not provided, uses default color
-     * @param force If true, shows the helper even if gizmos are disabled
-     */
-    showHelper(col = null, force = false) {
-        if (!gizmos && !force)
-            return;
-        if (this._helper) {
-            if (col)
-                this._color?.set(col);
-            this.gameObject.add(this._helper);
-            return;
-        }
-        this._helper = CreateWireCube(col);
-        this.gameObject.add(this._helper);
-    }
-}
+import { Box3, Vector3 } from "three";
+import { CreateWireCube, Gizmos } from "../engine/engine_gizmos.js";
+import { getBoundingBox, getWorldPosition, getWorldScale } from "../engine/engine_three_utils.js";
+import { getParam } from "../engine/engine_utils.js";
+import { Behaviour } from "./Component.js";
+const gizmos = getParam("gizmos");
+const debug = getParam("debugboxhelper");
+/**
+ * A component that creates a bounding box around an object and provides intersection testing functionality.
+ *
+ * Debug mode can be enabled with the URL parameter `?debugboxhelper`, which will visualize intersection tests.
+ * Helper visualization can be enabled with the URL parameter `?gizmos`.
+ *
+ * @category Helpers
+ * @group Components
+ */
+export class BoxHelperComponent extends Behaviour {
+    /** The bounding box for this component */
+    box = null;
+    static testBox = new Box3();
+    _lastMatrixUpdateFrame = -1;
+    static _position = new Vector3();
+    static _size = new Vector3(.01, .01, .01);
+    static _emptyObjectSize = new Vector3(.01, .01, .01);
+    /**
+     * Tests if an object intersects with this helper's bounding box
+     * @param obj The object to test for intersection
+     * @returns True if objects intersect, false if not, undefined if the provided object is invalid
+     */
+    isInBox(obj) {
+        if (!obj)
+            return undefined;
+        if (!this.box) {
+            this.box = new Box3();
+        }
+        getBoundingBox([obj], undefined, undefined, BoxHelperComponent.testBox);
+        if (BoxHelperComponent.testBox.isEmpty()) {
+            const wp = getWorldPosition(obj, BoxHelperComponent._position);
+            BoxHelperComponent.testBox.setFromCenterAndSize(wp, BoxHelperComponent._emptyObjectSize);
+        }
+        this.updateBox();
+        const intersects = this.box?.intersectsBox(BoxHelperComponent.testBox);
+        if (intersects) {
+            if (debug)
+                Gizmos.DrawWireBox3(BoxHelperComponent.testBox, 0xff0000, 5);
+        }
+        return intersects;
+    }
+    /**
+     * Tests if this helper's bounding box intersects with another box
+     * @param box The {@link Box3} to test for intersection
+     * @returns True if boxes intersect, false otherwise
+     */
+    intersects(box) {
+        if (!box)
+            return false;
+        return this.updateBox(false).intersectsBox(box);
+    }
+    /**
+     * Updates the helper's bounding box based on the gameObject's position and scale
+     * @param force Whether to force an update regardless of frame count
+     * @returns The updated {@link Box3}
+     */
+    updateBox(force = false) {
+        if (!this.box) {
+            this.box = new Box3();
+        }
+        if (force || this.context.time.frameCount != this._lastMatrixUpdateFrame) {
+            const firstUpdate = this._lastMatrixUpdateFrame < 0;
+            this._lastMatrixUpdateFrame = this.context.time.frameCount;
+            const updateParents = firstUpdate; // updating parents seems to cause falsely calculated positions sometimes?
+            const wp = getWorldPosition(this.gameObject, BoxHelperComponent._position, updateParents);
+            const size = getWorldScale(this.gameObject, BoxHelperComponent._size);
+            this.box.setFromCenterAndSize(wp, size);
+        }
+        return this.box;
+    }
+    _helper = null;
+    _color = null;
+    awake() {
+        this._helper = null;
+        this._color = null;
+        this.box = null;
+    }
+    /**
+     * Creates and displays a visual wireframe representation of this box helper
+     * @param col Optional color for the wireframe. If not provided, uses default color
+     * @param force If true, shows the helper even if gizmos are disabled
+     */
+    showHelper(col = null, force = false) {
+        if (!gizmos && !force)
+            return;
+        if (this._helper) {
+            if (col)
+                this._color?.set(col);
+            this.gameObject.add(this._helper);
+            return;
+        }
+        this._helper = CreateWireCube(col);
+        this.gameObject.add(this._helper);
+    }
+}
 //# sourceMappingURL=BoxHelperComponent.js.map