@woosh/meep-engine 2.138.17 → 2.138.19

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 {
     /**

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 {
 

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.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{

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/grid/HeightMap2AOMap.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"HeightMap2AOMap.d.ts","sourceRoot":"","sources":["../../../../../src/engine/ecs/grid/HeightMap2AOMap.js"],"names":[],"mappings":";AA6BA;;;;;;;;;;;;;;;;;;;GAmBG;AACH,qEAPW,SAAS,cACT,OAAO,cACP,OAAO,aAEP,MAAM,GACJ,SAAS,CA6CrB;0BAxFyB,6CAA6C;wBAJiB,OAAO"}
+{"version":3,"file":"HeightMap2AOMap.d.ts","sourceRoot":"","sources":["../../../../../src/engine/ecs/grid/HeightMap2AOMap.js"],"names":[],"mappings":";AA6BA;;;;;;;;;;;;;;;;;;;GAmBG;AACH,qEAPW,SAAS,cACT,OAAO,cACP,OAAO,aAEP,MAAM,GACJ,SAAS,CA8CrB;0BAzFyB,6CAA6C;wBAJiB,OAAO"}

package/src/engine/ecs/grid/HeightMap2AOMap.js

@@ -57,9 +57,10 @@ function heightMap2AOMap(
     const width = resultSize.x;
     const height = resultSize.y;
 
-    // Pre-pass: max-height pyramid for Hi-Z ray traversal
+    // Pre-pass: max-height pyramid for Hi-Z ray traversal.
+    // The pyramid is a DataTexture2DArray; each Hi-Z mip is one layer.
     const pyramid_texture = build_max_height_pyramid(heightMap);
-    const max_mip_level = pyramid_texture.mipmaps.length - 1;
+    const max_mip_level = pyramid_texture.userData.mipCount - 1;
 
     // AO bake
     const shader_ao = AmbientOcclusionShader({ numRays: rayCount });

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 {
     /**

package/src/engine/ecs/transform/Transform.js

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

package/src/engine/graphics/ecs/path/PathDisplaySystem.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"PathDisplaySystem.d.ts","sourceRoot":"","sources":["../../../../../../src/engine/graphics/ecs/path/PathDisplaySystem.js"],"names":[],"mappings":"AAoPA;IACI;;;OAGG;IACH,4BAwCC;IAnCG,mDAGC;IAED,2KAIC;IAED;;;OAGG;IACH,eAAoB;IAEpB;;;OAGG;IACH,iCAAkB;IAElB;;;;OAIG;IACH,wBAAkC;IAElC;;;OAGG;IACH,YAFU,MAAM,CAEc;IAGlC;;;;OAIG;IACH,8BAFW,MAAM,QAQhB;IAED;;;;OAIG;IACH,6BAFW,MAAM,QAIhB;IAED,2CAGC;IAED,4CAGC;IAED,8BA+BC;CACJ;sCA7VqC,8CAA8C;4BAQxD,kBAAkB;iBAL7B,4CAA4C;0BADnC,qCAAqC;4CAJnB,uDAAuD;+BAQpE,8BAA8B;6BAPhC,qCAAqC;8BAMpC,gCAAgC;mBAT3C,0CAA0C"}
+{"version":3,"file":"PathDisplaySystem.d.ts","sourceRoot":"","sources":["../../../../../../src/engine/graphics/ecs/path/PathDisplaySystem.js"],"names":[],"mappings":"AAoPA;IACI;;;OAGG;IACH,4BAwCC;IAnCG,mDAGC;IAED,2KAIC;IAED;;;OAGG;IACH,eAAoB;IAEpB;;;OAGG;IACH,iCAAkB;IAElB;;;;OAIG;IACH,wBAAkC;IAElC;;;OAGG;IACH,YAFU,MAAM,CAEc;IAGlC;;;;OAIG;IACH,8BAFW,MAAM,QAQhB;IAED;;;;OAIG;IACH,6BAFW,MAAM,QAIhB;IAED,2CAGC;IAED,4CAGC;IAED,8BA+BC;CACJ;sCA7VqC,8CAA8C;iBAGnE,4CAA4C;4BAKjC,kBAAkB;0BANpB,qCAAqC;4CAJnB,uDAAuD;+BAQpE,8BAA8B;6BAPhC,qCAAqC;8BAMpC,gCAAgC;mBAT3C,0CAA0C"}

package/src/engine/graphics/impostors/octahedral/ImpostorBaker.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"ImpostorBaker.d.ts","sourceRoot":"","sources":["../../../../../../src/engine/graphics/impostors/octahedral/ImpostorBaker.js"],"names":[],"mappings":";AAqBA;IAEI;;;;OAIG;IACH,kBAAiB;IAEjB;;;OAGG;IACH,iDAEC;IAGD;;;;;;;OAOG;IACH,yEANW,MAAM,EAAE,OAAK,uBAgPvB;IAED;;;;;;;OAOG;IACH,4CANW;QAAC,IAAI,iBAAgB;QAAC,SAAS,EAAC,IAAI,CAAA;KAAC,EAAE,GAIrC,mBAAmB,CAmE/B;CACJ;oCApVmC,0BAA0B;qBAjBnC,WAAW"}
+{"version":3,"file":"ImpostorBaker.d.ts","sourceRoot":"","sources":["../../../../../../src/engine/graphics/impostors/octahedral/ImpostorBaker.js"],"names":[],"mappings":";AAqBA;IAEI;;;;OAIG;IACH,kBAAiB;IAEjB;;;OAGG;IACH,iDAEC;IAGD;;;;;;;OAOG;IACH,yEANW,MAAM,EAAE,OAAK,uBAgPvB;IAED;;;;;;;OAOG;IACH,4CANW;QAAC,IAAI,iBAAgB;QAAC,SAAS,EAAC,IAAI,CAAA;KAAC,EAAE,GAIrC,mBAAmB,CA4E/B;CACJ;oCA7VmC,0BAA0B;qBAjBnC,WAAW"}

package/src/engine/graphics/impostors/octahedral/ImpostorBaker.js

@@ -317,8 +317,17 @@ export class ImpostorBaker {
             console.warn(`To get results at low frame resolutions number of frames should be a divisor of resolution, instead got [frames=${frames}, resolution=${resolution}, resolution/frames=${frame_resolution}]`);
         }
 
+        // POT is preferred for octahedral runtime sampling (mipmap-friendly),
+        // but the voxel impostor pipeline reads the atlas back to CPU and
+        // doesn't sample it at runtime, so a non-POT resolution is fine
+        // there. Demote the old hard error to a warning so callers that
+        // intentionally bake at multiples-of-frames (eg the voxel
+        // baker's budget search) aren't blocked.
         if (!isPowerOfTwo(resolution)) {
-            throw new Error(` 'resolution' must be a power of two, instead was '${resolution}'`);
+            console.warn(`ImpostorBaker: resolution=${resolution} is not a power of two. This is OK for CPU-readback uses (voxel impostor) but may degrade runtime atlas sampling for the octahedral impostor.`);
+        }
+        if (resolution % frames !== 0) {
+            throw new Error(`'resolution' (=${resolution}) must be divisible by 'frames' (=${frames}) so per-frame tiles are integer-sized`);
         }
 
         if (frames < 2) {