mage-engine 3.25.1 → 3.25.3

package/.claude/worktrees/fix-onstart-error-handling/.github/workflows/test.yml

@@ -0,0 +1,29 @@
+name: Tests
+
+on:
+  pull_request:
+    branches: [master, main]
+  push:
+    branches: [master, main]
+
+jobs:
+  test:
+    runs-on: ubuntu-latest
+
+    steps:
+      - uses: actions/checkout@v4
+
+      - name: Use Node.js 20
+        uses: actions/setup-node@v4
+        with:
+          node-version: 20
+          cache: npm
+
+      - name: Install dependencies
+        run: npm ci
+
+      - name: Lint
+        run: npm run lint
+
+      - name: Run tests
+        run: npm test

package/.claude/worktrees/fix-onstart-error-handling/.nvmrc

@@ -0,0 +1 @@
+14.19.3

package/.claude/worktrees/fix-onstart-error-handling/.prettierrc.js

@@ -0,0 +1,20 @@
+"use strict";
+
+module.exports = {
+  printWidth: 100,
+  trailingComma: "all",
+  arrowParens: "avoid",
+  semi: true,
+  tabWidth: 4,
+
+  overrides: [
+    {
+      files: ["*.md"],
+      options: { printWidth: 120 },
+    },
+    {
+      files: [".toolsharerc"],
+      options: { parser: "yaml" },
+    },
+  ],
+};

package/.claude/worktrees/fix-onstart-error-handling/LICENSE

@@ -0,0 +1,35 @@
+Copyright (c) 2015 - 2018 by Marco Stagni and contributors.
+
+Some rights reserved.
+
+Redistribution and use in source and binary forms, with or without
+modification, are permitted provided that the following conditions are
+met:
+
+    * Redistributions of source code must retain the above copyright
+      notice, this list of conditions and the following disclaimer.
+
+    * Redistributions in binary form must reproduce the above
+      copyright notice, this list of conditions and the following
+      disclaimer in the documentation and/or other materials provided
+      with the distribution.
+
+    * The names of the contributors may not be used to endorse or
+      promote products derived from this software without specific
+      prior written permission.
+
+THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS
+"AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT
+LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR
+A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT
+OWNER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL,
+SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT
+LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE,
+DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY
+THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT
+(INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE
+OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
+
+
+Mage contains third party software in the 'app/vendor' directory: each
+file/module in this directory is distributed under its original license.

package/.claude/worktrees/fix-onstart-error-handling/README.md

@@ -0,0 +1,56 @@
+# Mage
+
+![npm](https://img.shields.io/npm/v/mage-engine?color=%232ecc71)
+![npm](https://img.shields.io/npm/dy/mage-engine?color=%23e67e22)
+![npm bundle size](https://img.shields.io/bundlephobia/min/mage-engine)
+![GitHub repo size](https://img.shields.io/github/repo-size/MageStudio/Mage)
+![Discord](https://badgen.net/discord/members/NR5ZDGFG5j)
+
+---
+
+Mage is a game engine built on top of THREEJS. It features all you need to create fully interactive 3D application that can be distributed via web, desktop or mobile.
+
+[Documentation](https://www.mage.studio/docs)
+
+## Development
+The engine is under heavy development. The best way to stay up to date with changes, new features and bug fixes is to [join the Discord server](https://discord.gg/NR5ZDGFG5j).
+
+---
+
+## Licence
+
+Copyright (c) 2015 - 2018 by Marco Stagni and contributors.
+
+Some rights reserved.
+
+Redistribution and use in source and binary forms, with or without
+modification, are permitted provided that the following conditions are
+met:
+
+    * Redistributions of source code must retain the above copyright
+      notice, this list of conditions and the following disclaimer.
+
+    * Redistributions in binary form must reproduce the above
+      copyright notice, this list of conditions and the following
+      disclaimer in the documentation and/or other materials provided
+      with the distribution.
+
+    * The names of the contributors may not be used to endorse or
+      promote products derived from this software without specific
+      prior written permission.
+
+THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS
+"AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT
+LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR
+A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT
+OWNER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL,
+SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT
+LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE,
+DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY
+THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT
+(INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE
+OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
+
+
+Mage contains third party software in the 'app/vendor' directory: each
+file/module in this directory is distributed under its original license.

package/.claude/worktrees/fix-onstart-error-handling/__mocks__/three.js

@@ -0,0 +1,178 @@
+// Lightweight mock of THREE.js for unit tests.
+// Only stubs the APIs actually used by src/lib/ modules.
+// Grow this file incrementally as more tests need additional THREE APIs.
+
+class Vector3 {
+    constructor(x = 0, y = 0, z = 0) {
+        this.x = x;
+        this.y = y;
+        this.z = z;
+    }
+    set(x, y, z) { this.x = x; this.y = y; this.z = z; return this; }
+    clone() { return new Vector3(this.x, this.y, this.z); }
+    add(v) { this.x += v.x; this.y += v.y; this.z += v.z; return this; }
+    sub(v) { this.x -= v.x; this.y -= v.y; this.z -= v.z; return this; }
+    normalize() {
+        const len = Math.sqrt(this.x * this.x + this.y * this.y + this.z * this.z);
+        if (len > 0) { this.x /= len; this.y /= len; this.z /= len; }
+        return this;
+    }
+    multiplyScalar(s) { this.x *= s; this.y *= s; this.z *= s; return this; }
+    lerp(v, t) {
+        this.x += (v.x - this.x) * t;
+        this.y += (v.y - this.y) * t;
+        this.z += (v.z - this.z) * t;
+        return this;
+    }
+}
+
+class Vector2 {
+    constructor(x = 0, y = 0) {
+        this.x = x;
+        this.y = y;
+    }
+}
+
+const MathUtils = {
+    lerp: (x, y, t) => x + (y - x) * t,
+};
+
+class Color {
+    constructor(color) {
+        this.value = color;
+    }
+}
+
+class AnimationMixer {
+    constructor() {
+        this.time = 0;
+    }
+    clipAction() {
+        return {
+            reset: function() { return this; },
+            setLoop: function() { return this; },
+            setEffectiveTimeScale: function() { return this; },
+            setEffectiveWeight: function() { return this; },
+            play: function() {},
+            stop: function() {},
+            fadeIn: function() { return this; },
+            fadeOut: function() { return this; },
+            isRunning: function() { return false; },
+            time: 0,
+        };
+    }
+    stopAllAction() {}
+    addEventListener() {}
+    update() {}
+}
+
+class AnimationClip {
+    static findByName(clips, name) {
+        return clips.find(c => c.name === name);
+    }
+}
+
+class EventDispatcher {
+    constructor() {
+        this._listeners = {};
+    }
+    addEventListener(type, listener) {
+        if (!this._listeners[type]) this._listeners[type] = [];
+        this._listeners[type].push(listener);
+    }
+    removeEventListener(type, listener) {
+        if (this._listeners[type]) {
+            this._listeners[type] = this._listeners[type].filter(l => l !== listener);
+        }
+    }
+    dispatchEvent(event) {
+        if (this._listeners[event.type]) {
+            this._listeners[event.type].forEach(l => l(event));
+        }
+    }
+}
+
+class Quaternion {
+    constructor(x = 0, y = 0, z = 0, w = 1) {
+        this.x = x; this.y = y; this.z = z; this.w = w;
+    }
+    identity() { this.x = 0; this.y = 0; this.z = 0; this.w = 1; return this; }
+    copy(q) { this.x = q.x; this.y = q.y; this.z = q.z; this.w = q.w; return this; }
+    clone() { return new Quaternion(this.x, this.y, this.z, this.w); }
+}
+
+class Euler {
+    constructor(x = 0, y = 0, z = 0, order = "XYZ") {
+        this.x = x; this.y = y; this.z = z; this.order = order;
+    }
+}
+
+class Matrix4 {
+    constructor() {
+        this.elements = [1,0,0,0, 0,1,0,0, 0,0,1,0, 0,0,0,1];
+    }
+    identity() { this.elements = [1,0,0,0, 0,1,0,0, 0,0,1,0, 0,0,0,1]; return this; }
+    getInverse() { return this; }
+    multiplyMatrices() { return this; }
+    setFromMatrixScale() { return this; }
+}
+
+// Material stubs
+class MeshBasicMaterial { constructor(opts) { Object.assign(this, opts); } }
+class MeshLambertMaterial { constructor(opts) { Object.assign(this, opts); } }
+class MeshPhongMaterial { constructor(opts) { Object.assign(this, opts); } }
+class MeshDepthMaterial { constructor(opts) { Object.assign(this, opts); } }
+class MeshStandardMaterial { constructor(opts) { Object.assign(this, opts); } }
+class MeshToonMaterial { constructor(opts) { Object.assign(this, opts); } }
+
+// Encoding constants
+const LinearEncoding = 3000;
+const sRGBEncoding = 3001;
+const GammaEncoding = 3007;
+const RGBEEncoding = 3002;
+const RGBM7Encoding = 3004;
+const RGBM16Encoding = 3005;
+const RGBDEncoding = 3006;
+const BasicDepthPacking = 3200;
+const RGBADepthPacking = 3201;
+
+// Side constants
+const FrontSide = 0;
+const BackSide = 1;
+const DoubleSide = 2;
+
+const LoopRepeat = 2201;
+const LoopOnce = 2200;
+
+module.exports = {
+    Vector3,
+    Vector2,
+    Quaternion,
+    Euler,
+    Matrix4,
+    MathUtils,
+    Color,
+    AnimationMixer,
+    AnimationClip,
+    EventDispatcher,
+    MeshBasicMaterial,
+    MeshLambertMaterial,
+    MeshPhongMaterial,
+    MeshDepthMaterial,
+    MeshStandardMaterial,
+    MeshToonMaterial,
+    LinearEncoding,
+    sRGBEncoding,
+    GammaEncoding,
+    RGBEEncoding,
+    RGBM7Encoding,
+    RGBM16Encoding,
+    RGBDEncoding,
+    BasicDepthPacking,
+    RGBADepthPacking,
+    FrontSide,
+    BackSide,
+    DoubleSide,
+    LoopRepeat,
+    LoopOnce,
+};