@needle-tools/engine 4.7.2-alpha → 4.7.2-next.0e4e068

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

@@ -1,54 +1,54 @@
-import type { INetworkingWebsocketUrlProvider } from "../engine/engine_networking.js";
-import { Behaviour } from "./Component.js";
-/**
- * Provides configuration to the built-in networking system.
- * This component supplies websocket URLs for establishing connections.
- * It implements the {@link INetworkingWebsocketUrlProvider} interface.
- *
- * @category Networking
- * @group Components
- */
-export declare class Networking extends Behaviour implements INetworkingWebsocketUrlProvider {
-    /**
-     * The websocket URL to connect to for networking functionality.
-     * Can be a complete URL or a relative path that will be resolved against the current origin.
-     */
-    url: string | null;
-    /**
-     * Name of the URL parameter that can override the websocket connection URL.
-     * When set, the URL will be overridden by the parameter value from the browser URL.
-     * For example, with `urlParameterName="ws"`, adding `?ws=ws://localhost:8080` to the browser URL will override the connection URL.
-     */
-    urlParameterName: string | null;
-    /**
-     * Alternative URL to use when running on a local network.
-     * This is particularly useful for development, when the server is running on the same machine as the client.
-     */
-    localhost: string | null;
-    /** @internal */
-    awake(): void;
-    /**
-     * Determines the websocket URL to use for networking connections.
-     * Processes the configured URL, applying localhost fallbacks when appropriate and
-     * handling URL parameter overrides if specified.
-     * @returns The formatted websocket URL string or null if no valid URL could be determined
-     * @internal
-     */
-    getWebsocketUrl(): string | null;
-    /**
-     * Processes a URL string applying various transformations based on network environment.
-     * Handles relative paths and localhost fallbacks for local network environments.
-     * @param url The original URL to process
-     * @param localhostFallback Alternative URL to use when on a local network
-     * @returns The processed URL string or null/undefined if input was invalid
-     */
-    static GetUrl(url: string | null | undefined, localhostFallback?: string | null): string | null | undefined;
-    /**
-     * Determines if the current connection is on a local network.
-     * Useful for applying different networking configurations in local development environments.
-     * This is the same as calling {@link isLocalNetwork}.
-     * @param hostname Optional hostname to check instead of the current window location
-     * @returns True if the connection is on a local network, false otherwise
-     */
-    static IsLocalNetwork(hostname?: string): boolean;
-}
+import type { INetworkingWebsocketUrlProvider } from "../engine/engine_networking.js";
+import { Behaviour } from "./Component.js";
+/**
+ * Provides configuration to the built-in networking system.
+ * This component supplies websocket URLs for establishing connections.
+ * It implements the {@link INetworkingWebsocketUrlProvider} interface.
+ *
+ * @category Networking
+ * @group Components
+ */
+export declare class Networking extends Behaviour implements INetworkingWebsocketUrlProvider {
+    /**
+     * The websocket URL to connect to for networking functionality.
+     * Can be a complete URL or a relative path that will be resolved against the current origin.
+     */
+    url: string | null;
+    /**
+     * Name of the URL parameter that can override the websocket connection URL.
+     * When set, the URL will be overridden by the parameter value from the browser URL.
+     * For example, with `urlParameterName="ws"`, adding `?ws=ws://localhost:8080` to the browser URL will override the connection URL.
+     */
+    urlParameterName: string | null;
+    /**
+     * Alternative URL to use when running on a local network.
+     * This is particularly useful for development, when the server is running on the same machine as the client.
+     */
+    localhost: string | null;
+    /** @internal */
+    awake(): void;
+    /**
+     * Determines the websocket URL to use for networking connections.
+     * Processes the configured URL, applying localhost fallbacks when appropriate and
+     * handling URL parameter overrides if specified.
+     * @returns The formatted websocket URL string or null if no valid URL could be determined
+     * @internal
+     */
+    getWebsocketUrl(): string | null;
+    /**
+     * Processes a URL string applying various transformations based on network environment.
+     * Handles relative paths and localhost fallbacks for local network environments.
+     * @param url The original URL to process
+     * @param localhostFallback Alternative URL to use when on a local network
+     * @returns The processed URL string or null/undefined if input was invalid
+     */
+    static GetUrl(url: string | null | undefined, localhostFallback?: string | null): string | null | undefined;
+    /**
+     * Determines if the current connection is on a local network.
+     * Useful for applying different networking configurations in local development environments.
+     * This is the same as calling {@link isLocalNetwork}.
+     * @param hostname Optional hostname to check instead of the current window location
+     * @returns True if the connection is on a local network, false otherwise
+     */
+    static IsLocalNetwork(hostname?: string): boolean;
+}

package/lib/engine-components/Networking.js

@@ -1,113 +1,113 @@
-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 { isLocalNetwork } from "../engine/engine_networking_utils.js";
-import { serializable } from "../engine/engine_serialization.js";
-import { getParam } from "../engine/engine_utils.js";
-import { Behaviour } from "./Component.js";
-const debug = getParam("debugnet");
-/**
- * Provides configuration to the built-in networking system.
- * This component supplies websocket URLs for establishing connections.
- * It implements the {@link INetworkingWebsocketUrlProvider} interface.
- *
- * @category Networking
- * @group Components
- */
-export class Networking extends Behaviour {
-    /**
-     * The websocket URL to connect to for networking functionality.
-     * Can be a complete URL or a relative path that will be resolved against the current origin.
-     */
-    url = null;
-    /**
-     * Name of the URL parameter that can override the websocket connection URL.
-     * When set, the URL will be overridden by the parameter value from the browser URL.
-     * For example, with `urlParameterName="ws"`, adding `?ws=ws://localhost:8080` to the browser URL will override the connection URL.
-     */
-    urlParameterName = null;
-    /**
-     * Alternative URL to use when running on a local network.
-     * This is particularly useful for development, when the server is running on the same machine as the client.
-     */
-    localhost = null;
-    /** @internal */
-    awake() {
-        if (debug)
-            console.log(this);
-        this.context.connection.registerProvider(this);
-    }
-    /**
-     * Determines the websocket URL to use for networking connections.
-     * Processes the configured URL, applying localhost fallbacks when appropriate and
-     * handling URL parameter overrides if specified.
-     * @returns The formatted websocket URL string or null if no valid URL could be determined
-     * @internal
-     */
-    getWebsocketUrl() {
-        let socketurl = this.url ? Networking.GetUrl(this.url, this.localhost) : null;
-        if (this.urlParameterName) {
-            const res = getParam(this.urlParameterName);
-            if (res && typeof res === "string") {
-                socketurl = res;
-            }
-        }
-        if (!socketurl)
-            return null;
-        // regex https://regex101.com/r/JQ5WqB/1
-        const regex = new RegExp("(((https?)|(?<socket_prefix>wss?)):\/\/)?(www\.)?(?<url>.+)", "gm");
-        const match = regex.exec(socketurl);
-        if (!match?.groups)
-            return null;
-        // if the url has a ws or wss prefix already assume the whole url is in the correct format
-        const socketPrefix = match?.groups["socket_prefix"];
-        if (socketPrefix)
-            return socketurl;
-        // otherwise add the ws prefix
-        return "wss://" + match?.groups["url"];
-    }
-    /**
-     * Processes a URL string applying various transformations based on network environment.
-     * Handles relative paths and localhost fallbacks for local network environments.
-     * @param url The original URL to process
-     * @param localhostFallback Alternative URL to use when on a local network
-     * @returns The processed URL string or null/undefined if input was invalid
-     */
-    static GetUrl(url, localhostFallback) {
-        let result = url;
-        const useLocalHostUrl = Networking.IsLocalNetwork() && localhostFallback;
-        if (useLocalHostUrl) {
-            result = localhostFallback;
-        }
-        if (url?.startsWith("/")) {
-            const base = useLocalHostUrl ? result : window.location.origin;
-            if (base?.endsWith("/") && url.startsWith("/"))
-                url = url.substring(1);
-            result = base + url;
-        }
-        return result;
-    }
-    /**
-     * Determines if the current connection is on a local network.
-     * Useful for applying different networking configurations in local development environments.
-     * This is the same as calling {@link isLocalNetwork}.
-     * @param hostname Optional hostname to check instead of the current window location
-     * @returns True if the connection is on a local network, false otherwise
-     */
-    static IsLocalNetwork(hostname = window.location.hostname) {
-        return isLocalNetwork(hostname);
-    }
-}
-__decorate([
-    serializable()
-], Networking.prototype, "url", void 0);
-__decorate([
-    serializable()
-], Networking.prototype, "urlParameterName", void 0);
-__decorate([
-    serializable()
-], Networking.prototype, "localhost", 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 { isLocalNetwork } from "../engine/engine_networking_utils.js";
+import { serializable } from "../engine/engine_serialization.js";
+import { getParam } from "../engine/engine_utils.js";
+import { Behaviour } from "./Component.js";
+const debug = getParam("debugnet");
+/**
+ * Provides configuration to the built-in networking system.
+ * This component supplies websocket URLs for establishing connections.
+ * It implements the {@link INetworkingWebsocketUrlProvider} interface.
+ *
+ * @category Networking
+ * @group Components
+ */
+export class Networking extends Behaviour {
+    /**
+     * The websocket URL to connect to for networking functionality.
+     * Can be a complete URL or a relative path that will be resolved against the current origin.
+     */
+    url = null;
+    /**
+     * Name of the URL parameter that can override the websocket connection URL.
+     * When set, the URL will be overridden by the parameter value from the browser URL.
+     * For example, with `urlParameterName="ws"`, adding `?ws=ws://localhost:8080` to the browser URL will override the connection URL.
+     */
+    urlParameterName = null;
+    /**
+     * Alternative URL to use when running on a local network.
+     * This is particularly useful for development, when the server is running on the same machine as the client.
+     */
+    localhost = null;
+    /** @internal */
+    awake() {
+        if (debug)
+            console.log(this);
+        this.context.connection.registerProvider(this);
+    }
+    /**
+     * Determines the websocket URL to use for networking connections.
+     * Processes the configured URL, applying localhost fallbacks when appropriate and
+     * handling URL parameter overrides if specified.
+     * @returns The formatted websocket URL string or null if no valid URL could be determined
+     * @internal
+     */
+    getWebsocketUrl() {
+        let socketurl = this.url ? Networking.GetUrl(this.url, this.localhost) : null;
+        if (this.urlParameterName) {
+            const res = getParam(this.urlParameterName);
+            if (res && typeof res === "string") {
+                socketurl = res;
+            }
+        }
+        if (!socketurl)
+            return null;
+        // regex https://regex101.com/r/JQ5WqB/1
+        const regex = new RegExp("(((https?)|(?<socket_prefix>wss?)):\/\/)?(www\.)?(?<url>.+)", "gm");
+        const match = regex.exec(socketurl);
+        if (!match?.groups)
+            return null;
+        // if the url has a ws or wss prefix already assume the whole url is in the correct format
+        const socketPrefix = match?.groups["socket_prefix"];
+        if (socketPrefix)
+            return socketurl;
+        // otherwise add the ws prefix
+        return "wss://" + match?.groups["url"];
+    }
+    /**
+     * Processes a URL string applying various transformations based on network environment.
+     * Handles relative paths and localhost fallbacks for local network environments.
+     * @param url The original URL to process
+     * @param localhostFallback Alternative URL to use when on a local network
+     * @returns The processed URL string or null/undefined if input was invalid
+     */
+    static GetUrl(url, localhostFallback) {
+        let result = url;
+        const useLocalHostUrl = Networking.IsLocalNetwork() && localhostFallback;
+        if (useLocalHostUrl) {
+            result = localhostFallback;
+        }
+        if (url?.startsWith("/")) {
+            const base = useLocalHostUrl ? result : window.location.origin;
+            if (base?.endsWith("/") && url.startsWith("/"))
+                url = url.substring(1);
+            result = base + url;
+        }
+        return result;
+    }
+    /**
+     * Determines if the current connection is on a local network.
+     * Useful for applying different networking configurations in local development environments.
+     * This is the same as calling {@link isLocalNetwork}.
+     * @param hostname Optional hostname to check instead of the current window location
+     * @returns True if the connection is on a local network, false otherwise
+     */
+    static IsLocalNetwork(hostname = window.location.hostname) {
+        return isLocalNetwork(hostname);
+    }
+}
+__decorate([
+    serializable()
+], Networking.prototype, "url", void 0);
+__decorate([
+    serializable()
+], Networking.prototype, "urlParameterName", void 0);
+__decorate([
+    serializable()
+], Networking.prototype, "localhost", void 0);
 //# sourceMappingURL=Networking.js.map

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

@@ -1,14 +1,14 @@
-import { Behaviour } from "./Component.js";
-export declare class OffsetConstraint extends Behaviour {
-    private referenceSpace;
-    private from;
-    private affectPosition;
-    private affectRotation;
-    private alignLookDirection;
-    private levelLookDirection;
-    private levelPosition;
-    private positionOffset;
-    private rotationOffset;
-    private offset;
-    update(): void;
-}
+import { Behaviour } from "./Component.js";
+export declare class OffsetConstraint extends Behaviour {
+    private referenceSpace;
+    private from;
+    private affectPosition;
+    private affectRotation;
+    private alignLookDirection;
+    private levelLookDirection;
+    private levelPosition;
+    private positionOffset;
+    private rotationOffset;
+    private offset;
+    update(): void;
+}

package/lib/engine-components/OffsetConstraint.js

@@ -1,66 +1,66 @@
-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 { Euler, Plane, Quaternion, Vector3 } from "three";
-import { serializable } from "../engine/engine_serialization_decorator.js";
-import * as utils from "./../engine/engine_three_utils.js";
-import { Behaviour, GameObject } from "./Component.js";
-export class OffsetConstraint extends Behaviour {
-    referenceSpace;
-    from;
-    affectPosition = false;
-    affectRotation = false;
-    alignLookDirection = false;
-    levelLookDirection = false;
-    levelPosition = false;
-    positionOffset = new Vector3(0, 0, 0);
-    rotationOffset = new Vector3(0, 0, 0);
-    offset = new Vector3(0, 0, 0);
-    update() {
-        if (!this.from)
-            return;
-        var pos = utils.getWorldPosition(this.from);
-        var rot = utils.getWorldQuaternion(this.from);
-        this.offset.copy(this.positionOffset);
-        const l = this.offset.length();
-        if (this.referenceSpace)
-            this.offset.transformDirection(this.referenceSpace.matrixWorld).multiplyScalar(l);
-        pos.add(this.offset);
-        if (this.levelPosition && this.referenceSpace) {
-            const plane = new Plane(this.gameObject.up, 0);
-            const refSpacePoint = utils.getWorldPosition(this.referenceSpace);
-            plane.setFromNormalAndCoplanarPoint(this.gameObject.up, refSpacePoint);
-            const v2 = new Vector3(0, 0, 0);
-            plane.projectPoint(pos, v2);
-            pos.copy(v2);
-        }
-        if (this.affectPosition)
-            utils.setWorldPosition(this.gameObject, pos);
-        const euler = new Euler(this.rotationOffset.x, this.rotationOffset.y, this.rotationOffset.z);
-        const quat = new Quaternion().setFromEuler(euler);
-        if (this.affectRotation)
-            utils.setWorldQuaternion(this.gameObject, rot.multiply(quat));
-        const lookDirection = new Vector3();
-        this.from.getWorldDirection(lookDirection).multiplyScalar(50);
-        if (this.levelLookDirection)
-            lookDirection.y = 0;
-        if (this.alignLookDirection)
-            this.gameObject.lookAt(lookDirection);
-    }
-}
-__decorate([
-    serializable(GameObject)
-], OffsetConstraint.prototype, "referenceSpace", void 0);
-__decorate([
-    serializable(GameObject)
-], OffsetConstraint.prototype, "from", void 0);
-__decorate([
-    serializable(Vector3)
-], OffsetConstraint.prototype, "positionOffset", void 0);
-__decorate([
-    serializable(Vector3)
-], OffsetConstraint.prototype, "rotationOffset", 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 { Euler, Plane, Quaternion, Vector3 } from "three";
+import { serializable } from "../engine/engine_serialization_decorator.js";
+import * as utils from "./../engine/engine_three_utils.js";
+import { Behaviour, GameObject } from "./Component.js";
+export class OffsetConstraint extends Behaviour {
+    referenceSpace;
+    from;
+    affectPosition = false;
+    affectRotation = false;
+    alignLookDirection = false;
+    levelLookDirection = false;
+    levelPosition = false;
+    positionOffset = new Vector3(0, 0, 0);
+    rotationOffset = new Vector3(0, 0, 0);
+    offset = new Vector3(0, 0, 0);
+    update() {
+        if (!this.from)
+            return;
+        var pos = utils.getWorldPosition(this.from);
+        var rot = utils.getWorldQuaternion(this.from);
+        this.offset.copy(this.positionOffset);
+        const l = this.offset.length();
+        if (this.referenceSpace)
+            this.offset.transformDirection(this.referenceSpace.matrixWorld).multiplyScalar(l);
+        pos.add(this.offset);
+        if (this.levelPosition && this.referenceSpace) {
+            const plane = new Plane(this.gameObject.up, 0);
+            const refSpacePoint = utils.getWorldPosition(this.referenceSpace);
+            plane.setFromNormalAndCoplanarPoint(this.gameObject.up, refSpacePoint);
+            const v2 = new Vector3(0, 0, 0);
+            plane.projectPoint(pos, v2);
+            pos.copy(v2);
+        }
+        if (this.affectPosition)
+            utils.setWorldPosition(this.gameObject, pos);
+        const euler = new Euler(this.rotationOffset.x, this.rotationOffset.y, this.rotationOffset.z);
+        const quat = new Quaternion().setFromEuler(euler);
+        if (this.affectRotation)
+            utils.setWorldQuaternion(this.gameObject, rot.multiply(quat));
+        const lookDirection = new Vector3();
+        this.from.getWorldDirection(lookDirection).multiplyScalar(50);
+        if (this.levelLookDirection)
+            lookDirection.y = 0;
+        if (this.alignLookDirection)
+            this.gameObject.lookAt(lookDirection);
+    }
+}
+__decorate([
+    serializable(GameObject)
+], OffsetConstraint.prototype, "referenceSpace", void 0);
+__decorate([
+    serializable(GameObject)
+], OffsetConstraint.prototype, "from", void 0);
+__decorate([
+    serializable(Vector3)
+], OffsetConstraint.prototype, "positionOffset", void 0);
+__decorate([
+    serializable(Vector3)
+], OffsetConstraint.prototype, "rotationOffset", void 0);
 //# sourceMappingURL=OffsetConstraint.js.map