@woosh/meep-engine 2.138.18 → 2.138.20

package/src/engine/control/first-person/prototype_first_person_controller.js

@@ -0,0 +1,314 @@
+import { BoxGeometry, MeshStandardMaterial } from "three";
+import Vector2 from "../../../core/geom/Vector2.js";
+import Vector3 from "../../../core/geom/Vector3.js";
+import { SerializationMetadata } from "../../ecs/components/SerializationMetadata.js";
+import { Tag } from "../../ecs/components/Tag.js";
+import Entity from "../../ecs/Entity.js";
+import { Transform } from "../../ecs/transform/Transform.js";
+import { EngineHarness } from "../../EngineHarness.js";
+import { CameraSystem } from "../../graphics/ecs/camera/CameraSystem.js";
+import { ShadedGeometry } from "../../graphics/ecs/mesh-v2/ShadedGeometry.js";
+import { ShadedGeometryFlags } from "../../graphics/ecs/mesh-v2/ShadedGeometryFlags.js";
+import { ShadedGeometrySystem } from "../../graphics/ecs/mesh-v2/ShadedGeometrySystem.js";
+import InputController from "../../input/ecs/components/InputController.js";
+import InputControllerSystem from "../../input/ecs/systems/InputControllerSystem.js";
+import { FirstPersonPlayerController } from "./FirstPersonPlayerController.js";
+import { FirstPersonPlayerControllerSystem } from "./FirstPersonPlayerControllerSystem.js";
+
+/**
+ * Prototype harness for {@link FirstPersonPlayerController}.
+ *
+ * Controls:
+ *   - Click to capture mouse (pointer lock); ESC to release
+ *   - WASD       — move
+ *   - Mouse      — look
+ *   - Space      — jump (tap; holding does not auto-repeat)
+ *   - Shift      — sprint (hold while moving forward)
+ *   - C          — crouch (hold)
+ *
+ * Scene: a flat ground at y=0 with a handful of coloured cubes for spatial
+ * reference, lit by the harness's default sun.
+ */
+
+const eh = new EngineHarness();
+
+async function main(engine) {
+    const em = engine.entityManager;
+    const ecd = engine.entityManager.dataset;
+
+    // -- Systems ---------------------------------------------------------
+    EngineHarness.addFpsCounter(engine);
+
+    await EngineHarness.buildLights({
+        engine,
+        sunIntensity: 1.0,
+        ambientIntensity: 0.25,
+    });
+
+    if (em.getSystem(CameraSystem) === null) {
+        await em.addSystem(new CameraSystem(engine.graphics));
+    }
+    if (em.getSystem(InputControllerSystem) === null) {
+        await em.addSystem(new InputControllerSystem(engine.devices));
+    }
+    if (em.getSystem(ShadedGeometrySystem) === null) {
+        await em.addSystem(new ShadedGeometrySystem(engine));
+    }
+
+    const fpsSystem = new FirstPersonPlayerControllerSystem();
+    fpsSystem.useBuiltInFlatGround = true;
+    fpsSystem.groundY = 0;
+    await em.addSystem(fpsSystem);
+
+    if (!ecd.isComponentTypeRegistered(Tag)) {
+        ecd.registerComponentType(Tag);
+    }
+    if (!ecd.isComponentTypeRegistered(SerializationMetadata)) {
+        ecd.registerComponentType(SerializationMetadata);
+    }
+
+    // -- World -----------------------------------------------------------
+    await EngineHarness.buildTerrain({
+        engine,
+        size: new Vector2(200, 200),
+        resolution: 8,
+        enableWater: false,
+        diffuse0: "data/textures/materials/terrain_township_set/512/Grass_3.png",
+    });
+
+    addReferenceMarkers(ecd);
+
+    // -- Player ----------------------------------------------------------
+    const player = buildPlayerEntity(ecd);
+
+    // -- Inputs ----------------------------------------------------------
+    buildInputBindings(ecd, player);
+
+    setupPointerLock(engine);
+
+    logHelp();
+}
+
+/**
+ * @param {EntityComponentDataset} ecd
+ * @returns {{entity:number, controller:FirstPersonPlayerController}}
+ */
+function buildPlayerEntity(ecd) {
+    const transform = new Transform();
+    // Spawn standing on the ground (body origin sits at the feet)
+    transform.position.set(100, 0, 100);
+
+    const controller = new FirstPersonPlayerController();
+    // Most tuning lives at config defaults; mass-tweak example shown for
+    // documentation. Comment out for the default soldier feel.
+    // controller.config.body.mass = 120;
+    // controller.config.bob.verticalAmpAtWalk = 0.08;
+
+    const eb = new Entity()
+        .add(transform)
+        .add(controller)
+        .add(Tag.fromJSON(["Player"]))
+        .add(SerializationMetadata.Transient);
+
+    eb.build(ecd);
+
+    return { entity: eb.id, controller };
+}
+
+/**
+ * Wire keyboard + mouse to the controller's intent surface. Uses the same
+ * `InputController` plumbing as the orbital-camera controller, so the
+ * standard `InputControllerSystem` does the device subscription bookkeeping.
+ *
+ * @param {EntityComponentDataset} ecd
+ * @param {{entity:number, controller:FirstPersonPlayerController}} player
+ */
+function buildInputBindings(ecd, player) {
+    const ic = new InputController();
+    const intent = player.controller.intent;
+
+    // Mouse sensitivity — radians of view rotation per pixel of mouse delta.
+    // ~1200px sweep = one full 360° turn. Comparable to Source-engine
+    // "sensitivity 2" at 800 DPI; calmer than typical web demos.
+    const SENSITIVITY = (Math.PI * 2) / 1200;
+
+    // -- WASD movement --------------------------------------------------
+    // Keep a small "held" mirror so we can recompute intent.move whenever
+    // any of the four keys change. We can't read intent.move directly
+    // because both keys can be pressed simultaneously.
+    const held = { w: false, a: false, s: false, d: false };
+
+    function recomputeMove() {
+        let mx = 0, my = 0;
+        if (held.d) mx += 1;
+        if (held.a) mx -= 1;
+        if (held.w) my += 1;
+        if (held.s) my -= 1;
+        intent.move.set(mx, my);
+    }
+
+    function bindMoveKey(key, prop) {
+        ic.bind(`keyboard/keys/${key}/down`, () => { held[prop] = true; recomputeMove(); });
+        ic.bind(`keyboard/keys/${key}/up`, () => { held[prop] = false; recomputeMove(); });
+    }
+    bindMoveKey("w", "w");
+    bindMoveKey("a", "a");
+    bindMoveKey("s", "s");
+    bindMoveKey("d", "d");
+
+    // -- Jump (hold-state; the system does the edge detection) -----------
+    ic.bind("keyboard/keys/space/down", () => { intent.jump = true; });
+    ic.bind("keyboard/keys/space/up", () => { intent.jump = false; });
+
+    // -- Sprint ----------------------------------------------------------
+    ic.bind("keyboard/keys/shift/down", () => { intent.sprint = true; });
+    ic.bind("keyboard/keys/shift/up", () => { intent.sprint = false; });
+
+    // -- Crouch ----------------------------------------------------------
+    ic.bind("keyboard/keys/c/down", () => { intent.crouch = true; });
+    ic.bind("keyboard/keys/c/up", () => { intent.crouch = false; });
+
+    // -- Mouse look ------------------------------------------------------
+    // Only accumulate look delta while the pointer is captured — otherwise
+    // moving the cursor over the page would steer the camera, which is
+    // jarring before the user has "claimed" the input surface.
+    ic.bind("pointer/on/move", (position, event, delta) => {
+        if (document.pointerLockElement === null) return;
+        intent.look._add(delta.x * SENSITIVITY, delta.y * SENSITIVITY);
+    });
+
+    // When the InputController unlinks (e.g. system shutdown), zero
+    // everything so a held key doesn't get stuck.
+    ic.on.unlinked.add(() => {
+        intent.move.set(0, 0);
+        intent.look.set(0, 0);
+        intent.jump = false;
+        intent.crouch = false;
+        intent.sprint = false;
+    });
+
+    new Entity()
+        .add(ic)
+        .add(Tag.fromJSON(["FirstPersonInputBindings"]))
+        .add(SerializationMetadata.Transient)
+        .build(ecd);
+}
+
+/**
+ * Click to capture; ESC (or other browser-default) to release.
+ * @param {Engine} engine
+ */
+function setupPointerLock(engine) {
+    const el = engine.graphics.domElement;
+
+    // The harness wires the engine into the page body via viewStack; the
+    // canvas is the actual pointer-lock target. Listen on the viewStack
+    // element so clicks anywhere inside the canvas trigger the request.
+    const captureEl = engine.viewStack.el;
+
+    captureEl.addEventListener("click", () => {
+        if (document.pointerLockElement !== el && el.requestPointerLock) {
+            el.requestPointerLock();
+        }
+    });
+
+    // Suppress the right-click context menu so the canvas stays usable.
+    captureEl.addEventListener("contextmenu", (e) => e.preventDefault());
+}
+
+/**
+ * Spawn a handful of marker entities around the player so motion is
+ * visually obvious. All markers go through the standard ECS pipeline
+ * (Transform + ShadedGeometry) — same path as gameplay geometry — so
+ * shadows and lighting work correctly.
+ *
+ * @param {EntityComponentDataset} ecd
+ */
+function addReferenceMarkers(ecd) {
+    const SPAWN_X = 100, SPAWN_Z = 100;
+
+    // Share one unit-cube geometry across the ring cubes — cheap and lets
+    // the renderer's instancing path kick in if it wants.
+    const unitCubeGeom = new BoxGeometry(1, 1, 1);
+    const palette = [0xff5555, 0x55ff55, 0x5577ff, 0xffaa44, 0xaa55ff, 0x44ddee, 0xff66cc, 0x66ffcc];
+
+    // Ring of coloured cubes at radius 6 — circle-strafe targets.
+    const RING_N = 8;
+    for (let i = 0; i < RING_N; i++) {
+        const a = (i / RING_N) * Math.PI * 2;
+        spawnMarker({
+            ecd,
+            geometry: unitCubeGeom,
+            color: palette[i % palette.length],
+            roughness: 0.8,
+            position: new Vector3(SPAWN_X + Math.cos(a) * 6, 0.5, SPAWN_Z + Math.sin(a) * 6),
+        });
+    }
+
+    // Tall pillars further out — for parallax depth-perception while
+    // testing bob and breath at distance.
+    const pillarGeom = new BoxGeometry(1, 6, 1);
+    const PILLAR_N = 6;
+    for (let i = 0; i < PILLAR_N; i++) {
+        const a = (i / PILLAR_N) * Math.PI * 2 + 0.3;
+        const r = 22;
+        spawnMarker({
+            ecd,
+            geometry: pillarGeom,
+            color: 0x888888,
+            roughness: 0.9,
+            position: new Vector3(SPAWN_X + Math.cos(a) * r, 3, SPAWN_Z + Math.sin(a) * r),
+        });
+    }
+
+    // A low platform next to spawn — easy hop target, plus a chance to see
+    // the landing dip when stepping back down.
+    spawnMarker({
+        ecd,
+        geometry: new BoxGeometry(2, 0.4, 2),
+        color: 0xddddee,
+        roughness: 0.7,
+        position: new Vector3(SPAWN_X + 3, 0.2, SPAWN_Z),
+    });
+}
+
+/**
+ * @param {object} p
+ * @param {EntityComponentDataset} p.ecd
+ * @param {THREE.BufferGeometry} p.geometry
+ * @param {number} p.color  Hex color, e.g. 0xff5555
+ * @param {number} [p.roughness]
+ * @param {Vector3} p.position
+ */
+function spawnMarker({ ecd, geometry, color, roughness = 0.8, position }) {
+    const material = new MeshStandardMaterial({ color, roughness });
+    const sg = ShadedGeometry.from(geometry, material);
+    sg.setFlag(ShadedGeometryFlags.CastShadow);
+    sg.setFlag(ShadedGeometryFlags.ReceiveShadow);
+    sg.setFlag(ShadedGeometryFlags.Visible);
+
+    const transform = new Transform();
+    transform.position.copy(position);
+
+    new Entity()
+        .add(transform)
+        .add(sg)
+        .add(Tag.fromJSON(["ReferenceMarker"]))
+        .add(SerializationMetadata.Transient)
+        .build(ecd);
+}
+
+function logHelp() {
+    /* eslint-disable no-console */
+    console.log("%cFirstPersonPlayerController prototype",
+        "color:#88ddff;font-weight:bold;font-size:14px");
+    console.log("Click the canvas to capture mouse. ESC to release.");
+    console.log("WASD = move | Mouse = look | Space = jump | Shift = sprint | C = crouch");
+}
+
+async function init() {
+    await eh.initialize();
+    await main(eh.engine);
+}
+
+init();

package/src/engine/ecs/Entity.js

@@ -40,7 +40,7 @@ const DEFAULT_FLAGS =
  *
  * @see {@link EntityComponentDataset}
  * @author Alex Goldring
- * @copyright Company Named Limited (c) 2025
+ * @copyright Company Named Limited (c) 2026
  */
 export class Entity {
 

package/src/engine/ecs/EntityComponentDataset.js

@@ -140,7 +140,7 @@ const scratch_args = [];
  *
  * @see https://en.wikipedia.org/wiki/Entity_component_system
  * @author Alex Goldring
- * @copyright Company Named Limited (c) 2025
+ * @copyright Company Named Limited (c) 2026
  */
 export class EntityComponentDataset {
 

package/src/engine/ecs/EntityManager.d.ts

@@ -34,7 +34,7 @@ export namespace EntityManagerState {
  *      em.detachDataset();
  *
  * @author Alex Goldring
- * @copyright Company Named Limited (c) 2025
+ * @copyright Company Named Limited (c) 2026
  */
 export class EntityManager {
     /**
@@ -157,9 +157,9 @@ export class EntityManager {
     getComponentClassByName<T_2>(className: string): null | Class<T_2>;
     /**
      * Advance simulation forward by a specified amount of time
-     * @param {number} timeDelta in seconds
+     * @param {number} time_delta_seconds in seconds
      */
-    simulate(timeDelta: number): void;
+    simulate(time_delta_seconds: number): void;
     /**
      * If the {@link EntityManager} is already started, the system will be started automatically before being added
      * @param {System} system

package/src/engine/ecs/EntityManager.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"EntityManager.d.ts","sourceRoot":"","sources":["../../../../src/engine/ecs/EntityManager.js"],"names":[],"mappings":"iCAgBU,MAAM;;;;;;;;;AAiBhB;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA4BG;AACH;IAEI;;;;OAIG;IACH,kBAFU,iCAAQ,CAEL;IAEb;;;;;;OAMG;IACH,uCAA2B;IAE3B;;;;;OAKG;IACH,iCAA4B;IAE5B;;OAEG;IACH;;;QAGI;;WAEG;qBADO,uCAAc;;MAI1B;IAEF;;;OAGG;IACH,OAFU,kBAAkB,CAEO;IAEnC;;;;;;OAMG;IACH,gDAA2C;IAE3C;;;;;;;;;OASG;IACH,qBAFU,MAAM,CAEqB;IAErC;;;;;OAKG;IACH,wCAFU,MAAM,CAE4B;IAE5C;;;;OAIG;IACH,SAFU,sBAAsB,CAEjB;IAEf;;;;;OAKG;IACH,uCAAsC;IAEtC;;;OAGG;IACH,6BAmFC;IAED;;;OAGG;IACH,uBAFa,OAAO,CAuBnB;IAED;;;;;OAKG;IACH,uBAJW,sBAAsB,QA4ChC;IAGD;;;OAGG;IACH,sBA2BC;IAED;;;;OAIG;IACH,qCAFa,OAAO,CAInB;IAED;;;;OAIG;IACH,6CAgBC;IAED;;;;;OAKG;IACH,wCAHW,MAAM,GACJ,IAAI,aAAS,CAiBzB;IAGD;;;OAGG;IACH,oBAFW,MAAM,QAoEhB;IAED;;;;;OAKG;IACH,iEA6DC;IAED;;;;OAIG;IACH,uDAFa,QAAQ,OAAO,CAAC,CA2C5B;IAED;;;;;OAKG;IACH,mBAmCC;IAED;;;;;OAKG;IACH,oBAqFC;IAED;;;;;OAKG;IACH,kEAyEC;IAED;;;;OAIG;IACH,mCAFa,wCAAgB,CA0B5B;IAED;;;;OAIG;IACH,8DAFa,wCAAgB,CA0B5B;IAED;;;;;OAKG;IACH,mEAoFC;IAGL;;OAEG;IACH,yBA5rBe,sBAAsB,UA4rBA;IACrC;;OAEG;IACH,0BAAqC;CATpC;uBA17BmC,aAAa;mBAR9B,oCAAoC;uCAMhB,6BAA6B"}
+{"version":3,"file":"EntityManager.d.ts","sourceRoot":"","sources":["../../../../src/engine/ecs/EntityManager.js"],"names":[],"mappings":"iCAgBU,MAAM;;;;;;;;;AAiBhB;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA4BG;AACH;IAEI;;;;OAIG;IACH,kBAFU,iCAAQ,CAEL;IAEb;;;;;;OAMG;IACH,uCAA2B;IAE3B;;;;;OAKG;IACH,iCAA4B;IAE5B;;OAEG;IACH;;;QAGI;;WAEG;qBADO,uCAAc;;MAI1B;IAEF;;;OAGG;IACH,OAFU,kBAAkB,CAEO;IAEnC;;;;;;OAMG;IACH,gDAA2C;IAE3C;;;;;;;;;OASG;IACH,qBAFU,MAAM,CAEqB;IAErC;;;;;OAKG;IACH,wCAFU,MAAM,CAE4B;IAE5C;;;;OAIG;IACH,SAFU,sBAAsB,CAEjB;IAEf;;;;;OAKG;IACH,uCAAsC;IAEtC;;;OAGG;IACH,6BAmFC;IAED;;;OAGG;IACH,uBAFa,OAAO,CAuBnB;IAED;;;;;OAKG;IACH,uBAJW,sBAAsB,QA4ChC;IAGD;;;OAGG;IACH,sBA2BC;IAED;;;;OAIG;IACH,qCAFa,OAAO,CAInB;IAED;;;;OAIG;IACH,6CAgBC;IAED;;;;;OAKG;IACH,wCAHW,MAAM,GACJ,IAAI,aAAS,CAiBzB;IAGD;;;OAGG;IACH,6BAFW,MAAM,QAyEhB;IAED;;;;;OAKG;IACH,iEA6DC;IAED;;;;OAIG;IACH,uDAFa,QAAQ,OAAO,CAAC,CA2C5B;IAED;;;;;OAKG;IACH,mBAmCC;IAED;;;;;OAKG;IACH,oBAqFC;IAED;;;;;OAKG;IACH,kEAyEC;IAED;;;;OAIG;IACH,mCAFa,wCAAgB,CA0B5B;IAED;;;;OAIG;IACH,8DAFa,wCAAgB,CA0B5B;IAED;;;;;OAKG;IACH,mEAoFC;IAGL;;OAEG;IACH,yBAjsBe,sBAAsB,UAisBA;IACrC;;OAEG;IACH,0BAAqC;CATpC;uBA/7BmC,aAAa;mBAR9B,oCAAoC;uCAMhB,6BAA6B"}

package/src/engine/ecs/EntityManager.js

@@ -58,7 +58,7 @@ const DEFAULT_SYSTEM_STARTUP_TIMEOUT_CHECK = 5;
  *      em.detachDataset();
  *
  * @author Alex Goldring
- * @copyright Company Named Limited (c) 2025
+ * @copyright Company Named Limited (c) 2026
  */
 export class EntityManager {
 
@@ -405,13 +405,18 @@ export class EntityManager {
 
     /**
      * Advance simulation forward by a specified amount of time
-     * @param {number} timeDelta in seconds
+     * @param {number} time_delta_seconds in seconds
      */
-    simulate(timeDelta) {
-        assert.isNumber(timeDelta, 'timeDelta');
-        assert.notNaN(timeDelta, 'timeDelta');
-        assert.greaterThanOrEqual(timeDelta, 0, 'timeDelta must be >= 0');
-        assert.isFinite(timeDelta, 'timeDelta');
+    simulate(time_delta_seconds) {
+        assert.isNumber(time_delta_seconds, 'timeDelta');
+        assert.notNaN(time_delta_seconds, 'timeDelta');
+        assert.greaterThanOrEqual(time_delta_seconds, 0, 'time_delta_seconds must be >= 0');
+        assert.isFinite(time_delta_seconds, 'timeDelta');
+
+        if (this.dataset === null) {
+            // dataset is not attached
+            return;
+        }
 
         if (this.__execution_order_needs_update) {
             this.updateExecutionOrder();
@@ -437,7 +442,7 @@ export class EntityManager {
 
             // Perform fixed-step update
             if (system.fixedUpdate !== noop) {
-                let accumulated_time = accumulatedTime.get(system) + timeDelta;
+                let accumulated_time = accumulatedTime.get(system) + time_delta_seconds;
 
                 const t0 = performance.now();
 
@@ -465,7 +470,7 @@ export class EntityManager {
             if (system.update !== noop) {
 
                 try {
-                    system.update(timeDelta);
+                    system.update(time_delta_seconds);
                 } catch (e) {
                     console.error(`Failed during update of system '${computeSystemName(system)}': `, e);
                 }

package/src/engine/ecs/EntityObserver.js

@@ -7,7 +7,7 @@ import { BitSet } from "../../core/binary/BitSet.js";
  * see {@link EntityComponentDataset.addObserver}/{@link EntityComponentDataset.removeObserver}.
  *
  * @author Alex Goldring
- * @copyright Company Named Limited (c) 2025
+ * @copyright Company Named Limited (c) 2026
  */
 export class EntityObserver {
     /**

package/src/engine/ecs/EntityReference.d.ts

@@ -16,7 +16,7 @@
  *
  * @see {@link EntityComponentDataset}
  * @author Alex Goldring
- * @copyright Company Named Limited (c) 2025
+ * @copyright Company Named Limited (c) 2026
  */
 export class EntityReference {
     /**

package/src/engine/ecs/EntityReference.js

@@ -18,7 +18,7 @@ import { assert } from "../../core/assert.js";
  *
  * @see {@link EntityComponentDataset}
  * @author Alex Goldring
- * @copyright Company Named Limited (c) 2025
+ * @copyright Company Named Limited (c) 2026
  */
 export class EntityReference {
 

package/src/engine/ecs/System.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"System.d.ts","sourceRoot":"","sources":["../../../../src/engine/ecs/System.js"],"names":[],"mappings":"AAMA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA6BG;AACH;IAEI;;;;;OAKG;IACH,uCAAqB;IAErB;;;;OAIG;IACH,oBAA+C;IAE/C;;;;;;;OAOG;IACH,6BAAkB;IAElB;;;;;;;;;;OAUG;IACH,0BAFU,6BAA6B,CAElB;IAGrB;;OAEG;IACH,mCAcC;IAED;;;;;OAKG;IACH,oCAFY,MAAM,CA8BjB;IAED;;;;;;OAMG;IACH,uCAHa,QAAQ,IAAI,CAAC,CAKzB;IAED;;;;;;;OAOG;IACH,wCAHa,QAAQ,IAAI,CAAC,CAKzB;IAGD;;;;OAIG;IACH,wCAEC;IAED;;;;OAIG;IACH,0CAEC;IAED;;;;;;;;;;OAUG;IACH,6DAEC;IAED;;;;;;;;;;OAUG;IACH,6DAEC;IAIL;;;OAGG;IACH,mBAFU,OAAO,CAEQ;IAEzB;;;;OAIG;IACH,yBAA4B;IAG5B;;;;;;OAMG;IACH,oBAAuB;CAvBtB;0BA2BS,MAAM;;;;;;;;qBArOK,6BAA6B"}
+{"version":3,"file":"System.d.ts","sourceRoot":"","sources":["../../../../src/engine/ecs/System.js"],"names":[],"mappings":"AAMA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA6BG;AACH;IAEI;;;;;OAKG;IACH,uCAAqB;IAErB;;;;OAIG;IACH,oBAA+C;IAE/C;;;;;;;OAOG;IACH,6BAAkB;IAElB;;;;;;;;;;OAUG;IACH,0BAFU,6BAA6B,CAElB;IAGrB;;OAEG;IACH,mCAcC;IAED;;;;;OAKG;IACH,oCAFY,MAAM,CA8BjB;IAED;;;;;;OAMG;IACH,uCAHa,QAAQ,IAAI,CAAC,CAKzB;IAED;;;;;;;OAOG;IACH,wCAHa,QAAQ,IAAI,CAAC,CAKzB;IAGD;;;;OAIG;IACH,wCAEC;IAED;;;;OAIG;IACH,0CAEC;IAED;;;;;;;;;;OAUG;IACH,6DAEC;IAED;;;;;;;;;;OAUG;IACH,6DAEC;IAIL;;;OAGG;IACH,mBAFU,OAAO,CAEQ;IAEzB;;;;OAIG;IACH,2CAFsC,MAAM,CAEhB;IAG5B;;;;;;OAMG;IACH,sCAFsC,MAAM,CAErB;CAvBtB;0BA2BS,MAAM"}

package/src/engine/ecs/System.js

@@ -13,7 +13,7 @@ import { ResourceAccessKind } from "../../core/model/ResourceAccessKind.js";
  * @template C
  *
  * @author Alex Goldring
- * @copyright Company Named Limited (c) 2025
+ * @copyright Company Named Limited (c) 2026
  *
  * @example
  *   class FallDamageSystem{
@@ -213,7 +213,7 @@ System.prototype.isSystem = true;
 /**
  * Fixed update function, every step happens with the same exact time increment
  * useful for systems that must have a fixed time step to be predictable and stable, such as physics
- * @param {number} timeDelta in seconds, will always be the same value, controlled via {@link EntityManager.fixedUpdateStepSize}
+ * @type {function(time_delta_seconds:number)} time delta will always be the same value, controlled via {@link EntityManager.fixedUpdateStepSize}
  */
 System.prototype.fixedUpdate = noop; // by assigning NO-OP we enable a simple check, whether running the update would be useful
 
@@ -223,7 +223,7 @@ System.prototype.fixedUpdate = noop; // by assigning NO-OP we enable a simple ch
  * Note that this time step can vary depending on system conditions and hardware we are running on.
  * It is generally safe to assume that this update will happen once per frame, but it is not guaranteed.
  * Also, note that when the application window/tab is suspended, the next update step can have a very large value.
- * @param {number} timeDelta in seconds
+ * @type {function(time_delta_seconds:number)}
  */
 System.prototype.update = noop; // by assigning NO-OP we enable a simple check, whether running the update would be useful
 

package/src/engine/ecs/attachment/AttachmentSystem.d.ts

@@ -1,7 +1,7 @@
 export class AttachmentSystem extends System<any, any, any, any, any> {
     constructor();
     dependencies: (typeof Transform | typeof Attachment)[];
-    components_used: (ResourceAccessSpecification<typeof AttachmentSockets> | ResourceAccessSpecification<typeof Mesh> | ResourceAccessSpecification<typeof Transform>)[];
+    components_used: (ResourceAccessSpecification<typeof Transform> | ResourceAccessSpecification<typeof AttachmentSockets> | ResourceAccessSpecification<typeof Mesh>)[];
     /**
      *
      * @type {number[]}
@@ -55,7 +55,7 @@ export class AttachmentSystem extends System<any, any, any, any, any> {
 import { System } from "../System.js";
 import { Transform } from "../transform/Transform.js";
 import { Attachment } from "./Attachment.js";
-import { AttachmentSockets } from "../sockets/AttachmentSockets.js";
 import { ResourceAccessSpecification } from "../../../core/model/ResourceAccessSpecification.js";
+import { AttachmentSockets } from "../sockets/AttachmentSockets.js";
 import Mesh from "../../graphics/ecs/mesh/Mesh.js";
 //# sourceMappingURL=AttachmentSystem.d.ts.map

package/src/engine/ecs/attachment/AttachmentSystem.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"AttachmentSystem.d.ts","sourceRoot":"","sources":["../../../../../src/engine/ecs/attachment/AttachmentSystem.js"],"names":[],"mappings":"AAWA;IARuC,cAAmB;IAUtD,uDAAuC;IAEvC,sKAIE;IAEF;;;OAGG;IACH,SAFU,MAAM,EAAE,CAEL;IAEb;;;OAGG;IACH,UAFU,IAAI,MAAM,oBAAmB,CAElB;IAErB;;;OAGG;IACH,oBAFU,IAAI,MAAM,EAAE,mBAAmB,CAAC,CAEX;IAG/B;;;;OAIG;IACH,kBAHW,MAAM,GACJ,OAAO,CAInB;IAED;;;OAGG;IACH,aAFW,MAAM,QAUhB;IAED;;;;OAIG;IACH,+BAHW,MAAM,GACJ,MAAM,CAwBlB;IAGD;;;;;OAKG;IACH,iBAJW,UAAU,aACV,SAAS,UACT,MAAM,QAKhB;IAED,uBA6IC;IAED;;;;;OAKG;IACH,mBAJW,UAAU,aACV,SAAS,UACT,MAAM,QAqChB;IAED,oBAUC;IAED,6BAaC;CACJ;uBA5TsB,cAAc;0BAEX,2BAA2B;2BAD1B,iBAAiB;kCAEV,iCAAiC;4CAKvB,oDAAoD;iBAH/E,iCAAiC"}
+{"version":3,"file":"AttachmentSystem.d.ts","sourceRoot":"","sources":["../../../../../src/engine/ecs/attachment/AttachmentSystem.js"],"names":[],"mappings":"AAWA;IARuC,cAAmB;IAUtD,uDAAuC;IAEvC,sKAIE;IAEF;;;OAGG;IACH,SAFU,MAAM,EAAE,CAEL;IAEb;;;OAGG;IACH,UAFU,IAAI,MAAM,oBAAmB,CAElB;IAErB;;;OAGG;IACH,oBAFU,IAAI,MAAM,EAAE,mBAAmB,CAAC,CAEX;IAG/B;;;;OAIG;IACH,kBAHW,MAAM,GACJ,OAAO,CAInB;IAED;;;OAGG;IACH,aAFW,MAAM,QAUhB;IAED;;;;OAIG;IACH,+BAHW,MAAM,GACJ,MAAM,CAwBlB;IAGD;;;;;OAKG;IACH,iBAJW,UAAU,aACV,SAAS,UACT,MAAM,QAKhB;IAED,uBA6IC;IAED;;;;;OAKG;IACH,mBAJW,UAAU,aACV,SAAS,UACT,MAAM,QAqChB;IAED,oBAUC;IAED,6BAaC;CACJ;uBA5TsB,cAAc;0BAEX,2BAA2B;2BAD1B,iBAAiB;4CAOA,oDAAoD;kCAL9D,iCAAiC;iBAElD,iCAAiC"}

package/src/engine/ecs/guid/UUID.d.ts

@@ -17,7 +17,7 @@
  *  id_a.equals(id_b); // false
  *
  * @author Alex Goldring
- * @copyright Company Named Limited (c) 2025
+ * @copyright Company Named Limited (c) 2026
  */
 export class UUID {
     /**

package/src/engine/ecs/guid/UUID.js

@@ -42,7 +42,7 @@ let _clock_seq = ((randomUint8(random) << 8) | randomUint8(random)) & 0x3fff;
  *  id_a.equals(id_b); // false
  *
  * @author Alex Goldring
- * @copyright Company Named Limited (c) 2025
+ * @copyright Company Named Limited (c) 2026
  */
 export class UUID {
     #data = new Uint8Array(16);

package/src/engine/ecs/name/Name.d.ts

@@ -8,7 +8,7 @@
  *  name.getValue() // "Jane"
  *
  * @author Alex Goldring
- * @copyright Company Named Limited (c) 2025
+ * @copyright Company Named Limited (c) 2026
  */
 export class Name extends ObservedString {
     /**

package/src/engine/ecs/name/Name.js

@@ -10,7 +10,7 @@ import ObservedString from "../../../core/model/ObservedString.js";
  *  name.getValue() // "Jane"
  *
  * @author Alex Goldring
- * @copyright Company Named Limited (c) 2025
+ * @copyright Company Named Limited (c) 2026
  */
 export class Name extends ObservedString {
     /**

package/src/engine/ecs/parent/ParentEntity.js

@@ -2,7 +2,7 @@
  * Component representing logical attachment to another entity, when the parent disappears - so does the child
  *
  * @author Alex Goldring
- * @copyright Company Named Limited (c) 2025
+ * @copyright Company Named Limited (c) 2026
  */
 export class ParentEntity {
     /**

package/src/engine/ecs/storage/BinaryBufferDeSerializer.d.ts

@@ -16,7 +16,7 @@ export default BinaryBufferDeSerializer;
  *
  * @template CTX
  * @author Alex Goldring
- * @copyright Company Named Limited (c) 2025
+ * @copyright Company Named Limited (c) 2026
  */
 declare class BinaryBufferDeSerializer<CTX> {
     /**

package/src/engine/ecs/storage/BinaryBufferDeSerializer.js

@@ -23,7 +23,7 @@ import { BinaryObjectSerializationAdapter } from "./binary/object/BinaryObjectSe
  *
  * @template CTX
  * @author Alex Goldring
- * @copyright Company Named Limited (c) 2025
+ * @copyright Company Named Limited (c) 2026
  */
 class BinaryBufferDeSerializer {
     /**

package/src/engine/ecs/storage/BinaryBufferSerializer.d.ts

@@ -17,7 +17,7 @@ export default BinaryBufferSerializer;
  *
  * @template CTX
  * @author Alex Goldring
- * @copyright Company Named Limited (c) 2025
+ * @copyright Company Named Limited (c) 2026
  */
 declare class BinaryBufferSerializer<CTX> {
     /**

package/src/engine/ecs/storage/BinaryBufferSerializer.js

@@ -67,7 +67,7 @@ function isEntityTransient(entity, dataset, smComponentIndex, componentInstance)
  *
  * @template CTX
  * @author Alex Goldring
- * @copyright Company Named Limited (c) 2025
+ * @copyright Company Named Limited (c) 2026
  */
 class BinaryBufferSerializer {
     /**

package/src/engine/ecs/storage/binary/BinaryClassSerializationAdapter.js

@@ -27,7 +27,7 @@
  *      }
  *
  * @author Alex Goldring
- * @copyright Company Named Limited (c) 2025
+ * @copyright Company Named Limited (c) 2026
  */
 export class BinaryClassSerializationAdapter {
 

package/src/engine/ecs/storage/binary/BinarySerializationRegistry.d.ts

@@ -2,7 +2,7 @@
  * Contains serializers for various data types as well as data upgraders which enable support for serialization format changes
  *
  * @author Alex Goldring
- * @copyright Company Named Limited (c) 2025
+ * @copyright Company Named Limited (c) 2026
  */
 export class BinarySerializationRegistry {
     /**

package/src/engine/ecs/storage/binary/BinarySerializationRegistry.js

@@ -5,7 +5,7 @@ import { Graph } from "../../../../core/graph/v2/Graph.js";
  * Contains serializers for various data types as well as data upgraders which enable support for serialization format changes
  *
  * @author Alex Goldring
- * @copyright Company Named Limited (c) 2025
+ * @copyright Company Named Limited (c) 2026
  */
 export class BinarySerializationRegistry {
 

package/src/engine/ecs/storage/binary/collection/BinaryCollectionDeSerializer.d.ts

@@ -1,7 +1,7 @@
 /**
  *
  * @author Alex Goldring
- * @copyright Company Named Limited (c) 2025
+ * @copyright Company Named Limited (c) 2026
  */
 export class BinaryCollectionDeSerializer {
     /**

package/src/engine/ecs/storage/binary/collection/BinaryCollectionDeSerializer.js

@@ -19,7 +19,7 @@ const State = {
 /**
  *
  * @author Alex Goldring
- * @copyright Company Named Limited (c) 2025
+ * @copyright Company Named Limited (c) 2026
  */
 export class BinaryCollectionDeSerializer {
 

package/src/engine/ecs/transform/Transform.d.ts

@@ -8,7 +8,7 @@
  *  t.position.set(1,2,3);
  *
  * @author Alex Goldring
- * @copyright Company Named Limited (c) 2025
+ * @copyright Company Named Limited (c) 2026
  */
 export class Transform {
     /**