@datamoc/mw_games 0.44.2 → 0.45.0

package/dist/three-d/Character3D.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"Character3D.d.ts","sourceRoot":"","sources":["../../src/three-d/Character3D.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,8CAA8C,CAAC;AAKnF,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,wCAAwC,CAAC;AAE3E,OAAO,EAAE,aAAa,EAAE,MAAM,yCAAyC,CAAC;AACxE,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,0BAA0B,CAAC;AAItD,0GAA0G;AAC1G,MAAM,WAAW,kBAAkB;IAClC;;;;OAIG;IACH,OAAO,EAAE,MAAM,CAAC;IAChB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,MAAM,CAAC,EAAE,MAAM,CAAC;CAChB;AAOD;;;;;;;GAOG;AACH,MAAM,MAAM,SAAS,GAAG,CACvB,IAAI,EAAE;IAAE,CAAC,EAAE,MAAM,CAAC;IAAC,CAAC,EAAE,MAAM,CAAA;CAAE,EAC9B,EAAE,EAAE;IAAE,CAAC,EAAE,MAAM,CAAC;IAAC,CAAC,EAAE,MAAM,CAAA;CAAE,KACxB;IAAE,CAAC,EAAE,MAAM,CAAC;IAAC,CAAC,EAAE,MAAM,CAAC;IAAC,OAAO,CAAC,EAAE,OAAO,CAAA;CAAE,CAAC;AAEjD;;;;;;GAMG;AACH,qBAAa,WAAW;IACvB,QAAQ,CAAC,IAAI,EAAE,aAAa,CAAC;IAC7B,OAAO,CAAC,MAAM,CAAwB;IACtC,OAAO,CAAC,KAAK,CAAK;IAClB,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAC,CAAY;IAEvC,OAAO,CAAC,QAAQ,CAAC,UAAU,CAA8B;IACzD,OAAO,CAAC,WAAW,CAA+B;IAElD;;;;OAIG;IACH,YAAY,IAAI,EAAE,aAAa,EAAE,UAAU,GAAE,SAAS,cAAc,EAAO,EAAE,SAAS,CAAC,EAAE,SAAS,EAIjG;IAED,2EAA2E;IAC3E,YAAY,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAElC;IAED;;;;;OAKG;IACH,aAAa,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,UAAO,GAAG,OAAO,CAWhD;IAED,iEAAiE;IACjE,aAAa,IAAI,IAAI,CAGpB;IAED,mEAAmE;IACnE,IAAI,gBAAgB,IAAI,MAAM,GAAG,IAAI,CAEpC;IAED,MAAM,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,IAAI,CAI3D;IAED,MAAM,CAAC,YAAY,EAAE,MAAM,GAAG,OAAO,CAiCpC;IAED,qFAAqF;IACrF,MAAM,CAAC,QAAQ,CAAC,IAAI,EAAE,YAAY,EAAE,UAAU,GAAE,SAAS,cAAc,EAAO,GAAG,WAAW,CAE3F;IAED,MAAM,CAAC,SAAS,CAAC,KAAK,EAAE,KAAK,EAAE,OAAO,EAAE,kBAAkB,GAAG,WAAW,CAcvE;CACD"}

package/dist/three-d/Character3D.js

@@ -1,122 +0,0 @@
-import { StandardMaterial } from '@babylonjs/core/Materials/standardMaterial.js';
-import { Texture } from '@babylonjs/core/Materials/Textures/texture.js';
-import { Vector3 } from '@babylonjs/core/Maths/math.vector.js';
-import { CreatePlane } from '@babylonjs/core/Meshes/Builders/planeBuilder.pure.js';
-import { Mesh } from '@babylonjs/core/Meshes/mesh.js';
-import { TransformNode } from '@babylonjs/core/Meshes/transformNode.js';
-import { resolve } from '../assets/paths.js';
-/** an asset path resolved via `mwg/assets`, or a URI passed through unchanged */
-function resolveSource(source) {
-    return /^(?:data|blob|https?):/i.test(source) ? source : resolve(source);
-}
-/**
- * Moves either a billboard sprite or imported mesh through continuous 3D world space, and -
- * for an imported mesh - plays back whichever animation clips came baked into it.
- * `loadModel3D` already loads a glTF's own `animationGroups` as part of its import result;
- * this is what turns one of them into something a game can actually trigger, the way a walk
- * cycle baked into a mesh needs to be, rather than leaving them loaded but unreachable.
- */
-export class Character3D {
-    /**
-     * @param collideXZ optional, like `rpg.FreeMover` stays unopinionated about collision
-     * until a game wires one in - omitted, `moveTo` interpolates through open space with no
-     * notion of terrain height or collision at all, same as before this existed.
-     */
-    constructor(node, animations = [], collideXZ) {
-        this.target = null;
-        this.speed = 0;
-        this.currentClip = null;
-        this.node = node;
-        this.animations = new Map(animations.map((group) => [group.name, group]));
-        this.collideXZ = collideXZ;
-    }
-    /** true when an animation clip of this name was imported with the model */
-    hasAnimation(name) {
-        return this.animations.has(name);
-    }
-    /**
-     * Plays an imported animation clip by name, stopping whichever one was already playing.
-     * A name the model has no clip for is a no-op, returning `false`, the same
-     * degrade-to-nothing `ActorAnimator`/`GridMover` already use for a missing animation
-     * rather than throwing over what is often just a naming mismatch between assets.
-     */
-    playAnimation(name, loop = true) {
-        const clip = this.animations.get(name);
-        if (!clip)
-            return false;
-        if (this.currentClip === clip) {
-            if (!clip.isPlaying)
-                clip.start(loop);
-            return true;
-        }
-        this.currentClip?.stop();
-        clip.start(loop);
-        this.currentClip = clip;
-        return true;
-    }
-    /** stops whichever imported clip is currently playing, if any */
-    stopAnimation() {
-        this.currentClip?.stop();
-        this.currentClip = null;
-    }
-    /** the name of the clip currently playing, or null when none is */
-    get currentAnimation() {
-        return this.currentClip?.name ?? null;
-    }
-    moveTo(x, y, z, speed) {
-        if (!(speed > 0))
-            throw new Error('3D character speed must be positive');
-        this.target = new Vector3(x, y, z);
-        this.speed = speed;
-    }
-    update(deltaSeconds) {
-        if (!this.target)
-            return false;
-        const distance = Vector3.Distance(this.node.position, this.target);
-        const reachesTarget = distance <= this.speed * deltaSeconds;
-        const rawDirection = this.target.subtract(this.node.position);
-        const intended = reachesTarget
-            ? this.target
-            : this.node.position.add(rawDirection.normalize().scale(this.speed * deltaSeconds));
-        if (!reachesTarget)
-            this.node.rotation.y = Math.atan2(rawDirection.x, rawDirection.z);
-        if (this.collideXZ) {
-            const from = { x: this.node.position.x, z: this.node.position.z };
-            const to = { x: intended.x, z: intended.z };
-            const resolved = this.collideXZ(from, to);
-            this.node.position.set(resolved.x, intended.y, resolved.z);
-            //stopped short of where it meant to go - the target it was walking toward is no
-            //longer reachable along this line, the same "give up on this path" a caller of
-            //rpg.Collision's resolveAabbAgainstTiles already has to decide for itself
-            const blocked = resolved.blocked ?? (resolved.x !== to.x || resolved.z !== to.z);
-            if (blocked) {
-                this.target = null;
-                return false;
-            }
-        }
-        else {
-            this.node.position.copyFrom(intended);
-        }
-        if (reachesTarget) {
-            this.target = null;
-            return false;
-        }
-        return true;
-    }
-    /** @param animations typically `loadModel3D`'s own `animationGroups` result field */
-    static fromMesh(mesh, animations = []) {
-        return new Character3D(mesh, animations);
-    }
-    static billboard(scene, options) {
-        const plane = CreatePlane('billboard-character', { width: options.width ?? 1, height: options.height ?? 1.5 }, scene);
-        plane.billboardMode = Mesh.BILLBOARDMODE_Y;
-        const material = new StandardMaterial('billboard-material', scene);
-        material.diffuseTexture = new Texture(resolveSource(options.texture), scene);
-        material.diffuseTexture.hasAlpha = true;
-        material.useAlphaFromDiffuseTexture = true;
-        material.backFaceCulling = false;
-        plane.material = material;
-        return new Character3D(plane);
-    }
-}
-//# sourceMappingURL=Character3D.js.map

package/dist/three-d/Character3D.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"Character3D.js","sourceRoot":"","sources":["../../src/three-d/Character3D.ts"],"names":[],"mappings":"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"}

package/dist/three-d/Collision3D.d.ts

@@ -1,111 +0,0 @@
-import type { GridCell3D, GridShape3D } from './Grid.ts';
-/**
- * Horizontal collision for `mwg/3d`'s stepped grid terrain (`createTileGrid3D`): a moving
- * capsule/cylinder footprint stopped at the boundary of a raised column instead of clipping
- * through its side, the 3D counterpart to `rpg.Collision`'s 2D tile solidity - and, like that
- * module, this is not a rigid-body physics engine (see item 45's own caution), just the
- * missing primitive behind the bug item 144 was opened from: `Character3D.moveTo`
- * interpolates through open 3D space with no notion of terrain height, collision, or
- * step-up at all, so a path that was not authored to avoid a column's side clips straight
- * through it.
- *
- * A continuous heightmap (`createHeightmapTerrain3D`) is a different technique with its own
- * built-in height query (Babylon's own `GroundMesh.getHeightAtCoordinates`), so it needs
- * nothing from here; this module is specifically for the discrete, per-cell elevation grid
- * `createTileGrid3D` builds columns from, which has no such query at all.
- */
-/**
- * looks up a cell's height by its integer grid coordinate in O(1) rather than scanning `cells` on every query
- *
- * @example
- * ```ts
- * import { buildHeightIndex, heightAt } from '@datamoc/mw_games/3d';
- *
- * const heights = buildHeightIndex([
- * 	{ x: 0, y: 0 },
- * 	{ x: 1, y: 0, height: 2 },
- * ]);
- * console.log(heightAt(heights, 'square', 1.2, 0.1)); // 2
- * ```
- */
-export declare function buildHeightIndex(cells: readonly GridCell3D[]): Map<string, number>;
-/**
- * The integer grid cell nearest world position `(x, z)` - the inverse of `gridPoint3D`.
- * Nearest-cell rounding, not an exact point-in-hexagon test for the hex shape: consistent
- * with `rpg.Collision`'s own choice of simple axis sweeps over a full polygon solver, since
- * every tile a capsule actually stands on is far larger than the rounding error near an edge.
- *
- * @example
- * ```ts
- * import { cellAt } from '@datamoc/mw_games/3d';
- *
- * console.log(cellAt('square', 3.4, 1.6, 2)); // { x: 2, y: 1 }
- * ```
- */
-export declare function cellAt(shape: GridShape3D, x: number, z: number, tileSize?: number): {
-    x: number;
-    y: number;
-};
-/**
- * a cell's own `height` (grid-height units, before `heightStep` scaling), or `null` for a world position with no cell at all - a hole in the grid, blocking just like a wall would
- *
- * @example
- * ```ts
- * import { buildHeightIndex, heightAt } from '@datamoc/mw_games/3d';
- *
- * const heights = buildHeightIndex([{ x: 0, y: 0, height: 1 }]);
- * console.log(heightAt(heights, 'square', 0, 0), heightAt(heights, 'square', 5, 5)); // 1 null
- * ```
- */
-export declare function heightAt(index: ReadonlyMap<string, number>, shape: GridShape3D, x: number, z: number, tileSize?: number): number | null;
-/**
- * Inputs to `resolveCapsuleAgainstGrid`; `tileSize` (default 1) and `shape` must match the grid the heights were built from.
- */
-export interface CapsuleGridMoveOptions {
-    shape: GridShape3D;
-    /** from `buildHeightIndex` */
-    heights: ReadonlyMap<string, number>;
-    tileSize?: number;
-    /** the largest per-cell height difference (grid-height units, not world units) a capsule can step up or down without being blocked; 0 only allows level ground */
-    maxStepUp?: number;
-    /** positions sampled along the (x, z) segment; higher catches a thin column at high travel speed at the cost of more lookups */
-    steps?: number;
-}
-/** Where the move ended: `to` when open, otherwise the last sampled position that was still allowed. */
-export interface CapsuleGridMoveResult {
-    x: number;
-    z: number;
-    /** true when the move was stopped short of `to` by a wall-height step or a hole in the grid */
-    blocked: boolean;
-}
-/**
- * Moves a capsule's footprint from `from` toward `to` in the XZ plane, stopping at the last
- * sampled position still within `maxStepUp` of the cell it started the move standing on,
- * rather than passing straight through a column's side the way an un-collided `Character3D`
- * does. Sampling along the segment, not a swept-shape solver, is what stays shape-agnostic
- * across both `createTileGrid3D` shapes without hex-edge-specific geometry: exactly the
- * `resolveAabbAgainstTiles`-style trade-off `rpg.Collision`'s own doc comment already makes,
- * scaled to a grid that is not always axis-aligned.
- *
- * @example
- * ```ts
- * import { buildHeightIndex, resolveCapsuleAgainstGrid } from '@datamoc/mw_games/3d';
- *
- * const heights = buildHeightIndex([
- * 	{ x: 0, y: 0 },
- * 	{ x: 1, y: 0 },
- * 	{ x: 2, y: 0, height: 3 },
- * ]);
- * //a step of 3 levels is more than the capsule can climb, so it stops on the cell before the column
- * const moved = resolveCapsuleAgainstGrid({ x: 0, z: 0 }, { x: 2, z: 0 }, { shape: 'square', heights, maxStepUp: 1 });
- * console.log(moved.blocked, moved.x < 1.5); // true true
- * ```
- */
-export declare function resolveCapsuleAgainstGrid(from: {
-    x: number;
-    z: number;
-}, to: {
-    x: number;
-    z: number;
-}, options: CapsuleGridMoveOptions): CapsuleGridMoveResult;
-//# sourceMappingURL=Collision3D.d.ts.map

package/dist/three-d/Collision3D.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"Collision3D.d.ts","sourceRoot":"","sources":["../../src/three-d/Collision3D.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,WAAW,EAAE,MAAM,WAAW,CAAC;AAEzD;;;;;;;;;;;;;;GAcG;AAEH;;;;;;;;;;;;;GAaG;AACH,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,SAAS,UAAU,EAAE,GAAG,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,CAIlF;AAMD;;;;;;;;;;;;GAYG;AACH,wBAAgB,MAAM,CAAC,KAAK,EAAE,WAAW,EAAE,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,EAAE,QAAQ,SAAI,GAAG;IAAE,CAAC,EAAE,MAAM,CAAC;IAAC,CAAC,EAAE,MAAM,CAAA;CAAE,CAOvG;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,QAAQ,CACvB,KAAK,EAAE,WAAW,CAAC,MAAM,EAAE,MAAM,CAAC,EAClC,KAAK,EAAE,WAAW,EAClB,CAAC,EAAE,MAAM,EACT,CAAC,EAAE,MAAM,EACT,QAAQ,SAAI,GACV,MAAM,GAAG,IAAI,CAIf;AAED;;GAEG;AACH,MAAM,WAAW,sBAAsB;IACtC,KAAK,EAAE,WAAW,CAAC;IACnB,8BAA8B;IAC9B,OAAO,EAAE,WAAW,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACrC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,kKAAkK;IAClK,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,gIAAgI;IAChI,KAAK,CAAC,EAAE,MAAM,CAAC;CACf;AAED,wGAAwG;AACxG,MAAM,WAAW,qBAAqB;IACrC,CAAC,EAAE,MAAM,CAAC;IACV,CAAC,EAAE,MAAM,CAAC;IACV,+FAA+F;IAC/F,OAAO,EAAE,OAAO,CAAC;CACjB;AAED;;;;;;;;;;;;;;;;;;;;;;GAsBG;AACH,wBAAgB,yBAAyB,CACxC,IAAI,EAAE;IAAE,CAAC,EAAE,MAAM,CAAC;IAAC,CAAC,EAAE,MAAM,CAAA;CAAE,EAC9B,EAAE,EAAE;IAAE,CAAC,EAAE,MAAM,CAAC;IAAC,CAAC,EAAE,MAAM,CAAA;CAAE,EAC5B,OAAO,EAAE,sBAAsB,GAC7B,qBAAqB,CAmBvB"}

package/dist/three-d/Collision3D.js

@@ -1,119 +0,0 @@
-/**
- * Horizontal collision for `mwg/3d`'s stepped grid terrain (`createTileGrid3D`): a moving
- * capsule/cylinder footprint stopped at the boundary of a raised column instead of clipping
- * through its side, the 3D counterpart to `rpg.Collision`'s 2D tile solidity - and, like that
- * module, this is not a rigid-body physics engine (see item 45's own caution), just the
- * missing primitive behind the bug item 144 was opened from: `Character3D.moveTo`
- * interpolates through open 3D space with no notion of terrain height, collision, or
- * step-up at all, so a path that was not authored to avoid a column's side clips straight
- * through it.
- *
- * A continuous heightmap (`createHeightmapTerrain3D`) is a different technique with its own
- * built-in height query (Babylon's own `GroundMesh.getHeightAtCoordinates`), so it needs
- * nothing from here; this module is specifically for the discrete, per-cell elevation grid
- * `createTileGrid3D` builds columns from, which has no such query at all.
- */
-/**
- * looks up a cell's height by its integer grid coordinate in O(1) rather than scanning `cells` on every query
- *
- * @example
- * ```ts
- * import { buildHeightIndex, heightAt } from '@datamoc/mw_games/3d';
- *
- * const heights = buildHeightIndex([
- * 	{ x: 0, y: 0 },
- * 	{ x: 1, y: 0, height: 2 },
- * ]);
- * console.log(heightAt(heights, 'square', 1.2, 0.1)); // 2
- * ```
- */
-export function buildHeightIndex(cells) {
-    const index = new Map();
-    for (const cell of cells)
-        index.set(cellKey(cell.x, cell.y), cell.height ?? 0);
-    return index;
-}
-function cellKey(x, y) {
-    return `${x},${y}`;
-}
-/**
- * The integer grid cell nearest world position `(x, z)` - the inverse of `gridPoint3D`.
- * Nearest-cell rounding, not an exact point-in-hexagon test for the hex shape: consistent
- * with `rpg.Collision`'s own choice of simple axis sweeps over a full polygon solver, since
- * every tile a capsule actually stands on is far larger than the rounding error near an edge.
- *
- * @example
- * ```ts
- * import { cellAt } from '@datamoc/mw_games/3d';
- *
- * console.log(cellAt('square', 3.4, 1.6, 2)); // { x: 2, y: 1 }
- * ```
- */
-export function cellAt(shape, x, z, tileSize = 1) {
-    if (!(tileSize > 0))
-        throw new Error('3D grid collision tileSize must be positive');
-    if (shape === 'square')
-        return { x: Math.round(x / tileSize), y: Math.round(z / tileSize) };
-    const cellX = Math.round(x / (tileSize * 1.5));
-    const cellY = Math.round(z / (Math.sqrt(3) * tileSize) - (cellX & 1) * 0.5);
-    return { x: cellX, y: cellY };
-}
-/**
- * a cell's own `height` (grid-height units, before `heightStep` scaling), or `null` for a world position with no cell at all - a hole in the grid, blocking just like a wall would
- *
- * @example
- * ```ts
- * import { buildHeightIndex, heightAt } from '@datamoc/mw_games/3d';
- *
- * const heights = buildHeightIndex([{ x: 0, y: 0, height: 1 }]);
- * console.log(heightAt(heights, 'square', 0, 0), heightAt(heights, 'square', 5, 5)); // 1 null
- * ```
- */
-export function heightAt(index, shape, x, z, tileSize = 1) {
-    const cell = cellAt(shape, x, z, tileSize);
-    const key = cellKey(cell.x, cell.y);
-    return index.has(key) ? index.get(key) : null;
-}
-/**
- * Moves a capsule's footprint from `from` toward `to` in the XZ plane, stopping at the last
- * sampled position still within `maxStepUp` of the cell it started the move standing on,
- * rather than passing straight through a column's side the way an un-collided `Character3D`
- * does. Sampling along the segment, not a swept-shape solver, is what stays shape-agnostic
- * across both `createTileGrid3D` shapes without hex-edge-specific geometry: exactly the
- * `resolveAabbAgainstTiles`-style trade-off `rpg.Collision`'s own doc comment already makes,
- * scaled to a grid that is not always axis-aligned.
- *
- * @example
- * ```ts
- * import { buildHeightIndex, resolveCapsuleAgainstGrid } from '@datamoc/mw_games/3d';
- *
- * const heights = buildHeightIndex([
- * 	{ x: 0, y: 0 },
- * 	{ x: 1, y: 0 },
- * 	{ x: 2, y: 0, height: 3 },
- * ]);
- * //a step of 3 levels is more than the capsule can climb, so it stops on the cell before the column
- * const moved = resolveCapsuleAgainstGrid({ x: 0, z: 0 }, { x: 2, z: 0 }, { shape: 'square', heights, maxStepUp: 1 });
- * console.log(moved.blocked, moved.x < 1.5); // true true
- * ```
- */
-export function resolveCapsuleAgainstGrid(from, to, options) {
-    const { shape, heights, tileSize = 1, maxStepUp = 0, steps = 8 } = options;
-    if (!(steps > 0))
-        throw new Error('3D grid collision steps must be positive');
-    let currentHeight = heightAt(heights, shape, from.x, from.z, tileSize) ?? 0;
-    let last = { x: from.x, z: from.z };
-    for (let i = 1; i <= steps; i++) {
-        const t = i / steps;
-        const x = from.x + (to.x - from.x) * t;
-        const z = from.z + (to.z - from.z) * t;
-        const height = heightAt(heights, shape, x, z, tileSize);
-        if (height === null || Math.abs(height - currentHeight) > maxStepUp) {
-            return { x: last.x, z: last.z, blocked: true };
-        }
-        last = { x, z };
-        currentHeight = height;
-    }
-    return { x: last.x, z: last.z, blocked: false };
-}
-//# sourceMappingURL=Collision3D.js.map

package/dist/three-d/Collision3D.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"Collision3D.js","sourceRoot":"","sources":["../../src/three-d/Collision3D.ts"],"names":[],"mappings":"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"}

package/dist/three-d/Engine3D.d.ts

@@ -1,25 +0,0 @@
-import { ArcRotateCamera } from '@babylonjs/core/Cameras/arcRotateCamera.js';
-import { Engine } from '@babylonjs/core/Engines/engine.js';
-import { Scene } from '@babylonjs/core/scene.js';
-/** `clearColor` is RGBA in 0 to 1 (alpha 1 when omitted, default a dark blue); `antialias` defaults to true. */
-export interface Engine3DOptions {
-    canvas: HTMLCanvasElement;
-    antialias?: boolean;
-    clearColor?: readonly [number, number, number, number?];
-}
-/** Per-frame callback, run before the scene renders; `deltaSeconds` is the time since the previous frame. */
-export type Frame3D = (deltaSeconds: number) => void;
-/** Owns Babylon's WebGL engine, scene, default camera, lighting, and render loop. */
-export declare class Engine3D {
-    readonly engine: Engine;
-    readonly scene: Scene;
-    readonly camera: ArcRotateCamera;
-    private frame;
-    private readonly resize;
-    constructor(options: Engine3DOptions);
-    start(frame?: Frame3D): void;
-    step(deltaSeconds: number): void;
-    stop(): void;
-    dispose(): void;
-}
-//# sourceMappingURL=Engine3D.d.ts.map

package/dist/three-d/Engine3D.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"Engine3D.d.ts","sourceRoot":"","sources":["../../src/three-d/Engine3D.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,eAAe,EAAE,MAAM,4CAA4C,CAAC;AAC7E,OAAO,EAAE,MAAM,EAAE,MAAM,mCAAmC,CAAC;AAI3D,OAAO,EAAE,KAAK,EAAE,MAAM,0BAA0B,CAAC;AAEjD,gHAAgH;AAChH,MAAM,WAAW,eAAe;IAC/B,MAAM,EAAE,iBAAiB,CAAC;IAC1B,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB,UAAU,CAAC,EAAE,SAAS,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,CAAC,CAAC;CACxD;AAED,6GAA6G;AAC7G,MAAM,MAAM,OAAO,GAAG,CAAC,YAAY,EAAE,MAAM,KAAK,IAAI,CAAC;AAErD,qFAAqF;AACrF,qBAAa,QAAQ;IACpB,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,KAAK,EAAE,KAAK,CAAC;IACtB,QAAQ,CAAC,MAAM,EAAE,eAAe,CAAC;IACjC,OAAO,CAAC,KAAK,CAAwB;IACrC,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAoC;IAE3D,YAAY,OAAO,EAAE,eAAe,EAYnC;IAED,KAAK,CAAC,KAAK,CAAC,EAAE,OAAO,GAAG,IAAI,CAG3B;IAED,IAAI,CAAC,YAAY,EAAE,MAAM,GAAG,IAAI,CAG/B;IAED,IAAI,IAAI,IAAI,CAEX;IAED,OAAO,IAAI,IAAI,CAOd;CACD"}

package/dist/three-d/Engine3D.js

@@ -1,45 +0,0 @@
-import { ArcRotateCamera } from '@babylonjs/core/Cameras/arcRotateCamera.js';
-import { Engine } from '@babylonjs/core/Engines/engine.js';
-import { HemisphericLight } from '@babylonjs/core/Lights/hemisphericLight.js';
-import { Color4 } from '@babylonjs/core/Maths/math.color.js';
-import { Vector3 } from '@babylonjs/core/Maths/math.vector.js';
-import { Scene } from '@babylonjs/core/scene.js';
-/** Owns Babylon's WebGL engine, scene, default camera, lighting, and render loop. */
-export class Engine3D {
-    constructor(options) {
-        this.frame = null;
-        this.resize = () => this.engine.resize();
-        this.engine = new Engine(options.canvas, options.antialias ?? true);
-        this.scene = new Scene(this.engine);
-        const color = options.clearColor ?? [0.04, 0.06, 0.09, 1];
-        this.scene.clearColor = new Color4(color[0], color[1], color[2], color[3] ?? 1);
-        this.camera = new ArcRotateCamera('camera', -Math.PI / 2, Math.PI / 3, 18, Vector3.Zero(), this.scene);
-        this.camera.lowerRadiusLimit = 3;
-        this.camera.upperRadiusLimit = 80;
-        this.camera.attachControl(options.canvas, true);
-        new HemisphericLight('ambient', new Vector3(0.3, 1, 0.2), this.scene).intensity = 0.9;
-        addEventListener('resize', this.resize);
-        globalThis.__MWG_3D__ = this;
-    }
-    start(frame) {
-        this.frame = frame ?? null;
-        this.engine.runRenderLoop(() => this.step(this.engine.getDeltaTime() / 1000));
-    }
-    step(deltaSeconds) {
-        this.frame?.(deltaSeconds);
-        this.scene.render();
-    }
-    stop() {
-        this.engine.stopRenderLoop();
-    }
-    dispose() {
-        this.stop();
-        removeEventListener('resize', this.resize);
-        this.scene.dispose();
-        this.engine.dispose();
-        const globals = globalThis;
-        if (globals.__MWG_3D__ === this)
-            delete globals.__MWG_3D__;
-    }
-}
-//# sourceMappingURL=Engine3D.js.map

package/dist/three-d/Engine3D.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"Engine3D.js","sourceRoot":"","sources":["../../src/three-d/Engine3D.ts"],"names":[],"mappings":"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"}

package/dist/three-d/Grid.d.ts

@@ -1,30 +0,0 @@
-/** `square` cells, or flat-top `hex` cells in odd-q offset coordinates. */
-export type GridShape3D = 'square' | 'hex';
-/**
- * One floor cell: integer grid coordinates and an optional `height` in levels (default 0, negative sinks), scaled by `heightStep`.
- */
-export interface GridCell3D {
-    x: number;
-    y: number;
-    height?: number;
-}
-/** A world-space position; `y` is up. */
-export interface Point3D {
-    x: number;
-    y: number;
-    z: number;
-}
-/**
- * Converts the framework's integer square or odd-q hex coordinate to 3D world space.
- *
- * @example
- * ```ts
- * import { gridPoint3D } from '@datamoc/mw_games/3d';
- *
- * //cell (3, 2), one level up, on a grid of 2-unit tiles with 0.5-unit levels
- * const point = gridPoint3D('square', 3, 2, 2, 1, 0.5);
- * console.log(point); // { x: 6, y: 0.5, z: 4 }
- * ```
- */
-export declare function gridPoint3D(shape: GridShape3D, x: number, y: number, tileSize?: number, height?: number, heightStep?: number): Point3D;
-//# sourceMappingURL=Grid.d.ts.map

package/dist/three-d/Grid.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"Grid.d.ts","sourceRoot":"","sources":["../../src/three-d/Grid.ts"],"names":[],"mappings":"AAAA,2EAA2E;AAC3E,MAAM,MAAM,WAAW,GAAG,QAAQ,GAAG,KAAK,CAAC;AAE3C;;GAEG;AACH,MAAM,WAAW,UAAU;IAC1B,CAAC,EAAE,MAAM,CAAC;IACV,CAAC,EAAE,MAAM,CAAC;IACV,MAAM,CAAC,EAAE,MAAM,CAAC;CAChB;AAED,yCAAyC;AACzC,MAAM,WAAW,OAAO;IACvB,CAAC,EAAE,MAAM,CAAC;IACV,CAAC,EAAE,MAAM,CAAC;IACV,CAAC,EAAE,MAAM,CAAC;CACV;AAED;;;;;;;;;;;GAWG;AACH,wBAAgB,WAAW,CAC1B,KAAK,EAAE,WAAW,EAClB,CAAC,EAAE,MAAM,EACT,CAAC,EAAE,MAAM,EACT,QAAQ,SAAI,EACZ,MAAM,SAAI,EACV,UAAU,SAAI,GACZ,OAAO,CAQT"}

package/dist/three-d/Grid.js

@@ -1,24 +0,0 @@
-/**
- * Converts the framework's integer square or odd-q hex coordinate to 3D world space.
- *
- * @example
- * ```ts
- * import { gridPoint3D } from '@datamoc/mw_games/3d';
- *
- * //cell (3, 2), one level up, on a grid of 2-unit tiles with 0.5-unit levels
- * const point = gridPoint3D('square', 3, 2, 2, 1, 0.5);
- * console.log(point); // { x: 6, y: 0.5, z: 4 }
- * ```
- */
-export function gridPoint3D(shape, x, y, tileSize = 1, height = 0, heightStep = 1) {
-    if (!(tileSize > 0) || !(heightStep > 0))
-        throw new Error('3D grid sizes must be positive');
-    if (shape === 'square')
-        return { x: x * tileSize, y: height * heightStep, z: y * tileSize };
-    return {
-        x: x * tileSize * 1.5,
-        y: height * heightStep,
-        z: (y + (x & 1) * 0.5) * Math.sqrt(3) * tileSize,
-    };
-}
-//# sourceMappingURL=Grid.js.map

package/dist/three-d/Grid.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"Grid.js","sourceRoot":"","sources":["../../src/three-d/Grid.ts"],"names":[],"mappings":"AAmBA;;;;;;;;;;;GAWG;AACH,MAAM,UAAU,WAAW,CAC1B,KAAkB,EAClB,CAAS,EACT,CAAS,EACT,QAAQ,GAAG,CAAC,EACZ,MAAM,GAAG,CAAC,EACV,UAAU,GAAG,CAAC;IAEd,IAAI,CAAC,CAAC,QAAQ,GAAG,CAAC,CAAC,IAAI,CAAC,CAAC,UAAU,GAAG,CAAC,CAAC;QAAE,MAAM,IAAI,KAAK,CAAC,gCAAgC,CAAC,CAAC;IAC5F,IAAI,KAAK,KAAK,QAAQ;QAAE,OAAO,EAAE,CAAC,EAAE,CAAC,GAAG,QAAQ,EAAE,CAAC,EAAE,MAAM,GAAG,UAAU,EAAE,CAAC,EAAE,CAAC,GAAG,QAAQ,EAAE,CAAC;IAC5F,OAAO;QACN,CAAC,EAAE,CAAC,GAAG,QAAQ,GAAG,GAAG;QACrB,CAAC,EAAE,MAAM,GAAG,UAAU;QACtB,CAAC,EAAE,CAAC,CAAC,GAAG,CAAC,CAAC,GAAG,CAAC,CAAC,GAAG,GAAG,CAAC,GAAG,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,GAAG,QAAQ;KAChD,CAAC;AACH,CAAC"}

package/dist/three-d/Heightmap.d.ts

@@ -1,38 +0,0 @@
-import type { GroundMesh } from '@babylonjs/core/Meshes/groundMesh.js';
-import type { Scene } from '@babylonjs/core/scene.js';
-/**
- * Already-decoded pixel bytes, top-left origin, row-major, 4 bytes (RGBA) per pixel - a
- * canvas `getImageData().data` is exactly this shape.
- */
-export interface HeightmapSource {
-    data: Uint8Array;
-    width: number;
-    height: number;
-}
-/**
- * Terrain size and relief. Pixel brightness maps linearly onto `minHeight` to `maxHeight` (0 and 1 when omitted).
- */
-export interface HeightmapTerrain3DOptions {
-    /** world-space size along X; defaults to 10 */
-    width?: number;
-    /** world-space size along Z; defaults to 10 */
-    depth?: number;
-    /** vertices per side; defaults to one per source pixel along the shorter dimension */
-    subdivisions?: number;
-    minHeight?: number;
-    maxHeight?: number;
-}
-/**
- * Builds a continuous mesh displaced by a greyscale heightmap - a different technique from
- * `createTileGrid3D`'s discrete, per-cell elevation columns, for a game wanting rolling
- * ground instead of stepped blocks.
- *
- * Takes already-decoded pixel bytes rather than a URL Babylon would fetch and decode
- * itself, the same shape `parseVox` already takes raw bytes rather than a path: decoding an
- * image is `mwg/assets`'/a game's own job (a loaded texture read back through a canvas, or
- * any other decoder), keeping this module - like every other loader in `mwg/3d` - ignorant
- * of where its bytes came from and safe to call from `file://` without touching the network
- * itself.
- */
-export declare function createHeightmapTerrain3D(scene: Scene, source: HeightmapSource, options?: HeightmapTerrain3DOptions): GroundMesh;
-//# sourceMappingURL=Heightmap.d.ts.map

package/dist/three-d/Heightmap.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"Heightmap.d.ts","sourceRoot":"","sources":["../../src/three-d/Heightmap.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,sCAAsC,CAAC;AACvE,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,0BAA0B,CAAC;AAEtD;;;GAGG;AACH,MAAM,WAAW,eAAe;IAC/B,IAAI,EAAE,UAAU,CAAC;IACjB,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;CACf;AAED;;GAEG;AACH,MAAM,WAAW,yBAAyB;IACzC,+CAA+C;IAC/C,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,+CAA+C;IAC/C,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,sFAAsF;IACtF,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,SAAS,CAAC,EAAE,MAAM,CAAC;CACnB;AAED;;;;;;;;;;;GAWG;AACH,wBAAgB,wBAAwB,CACvC,KAAK,EAAE,KAAK,EACZ,MAAM,EAAE,eAAe,EACvB,OAAO,GAAE,yBAA8B,GACrC,UAAU,CAmBZ"}

package/dist/three-d/Heightmap.js

@@ -1,29 +0,0 @@
-import { CreateGroundFromHeightMap } from '@babylonjs/core/Meshes/Builders/groundBuilder.pure.js';
-/**
- * Builds a continuous mesh displaced by a greyscale heightmap - a different technique from
- * `createTileGrid3D`'s discrete, per-cell elevation columns, for a game wanting rolling
- * ground instead of stepped blocks.
- *
- * Takes already-decoded pixel bytes rather than a URL Babylon would fetch and decode
- * itself, the same shape `parseVox` already takes raw bytes rather than a path: decoding an
- * image is `mwg/assets`'/a game's own job (a loaded texture read back through a canvas, or
- * any other decoder), keeping this module - like every other loader in `mwg/3d` - ignorant
- * of where its bytes came from and safe to call from `file://` without touching the network
- * itself.
- */
-export function createHeightmapTerrain3D(scene, source, options = {}) {
-    if (!(source.width > 0) || !(source.height > 0))
-        throw new Error('heightmap source needs positive dimensions');
-    if (source.data.length < source.width * source.height * 4) {
-        throw new Error('heightmap source data is smaller than width * height * 4 (RGBA)');
-    }
-    return CreateGroundFromHeightMap('heightmap-terrain', { data: source.data, width: source.width, height: source.height }, {
-        width: options.width ?? 10,
-        height: options.depth ?? 10,
-        subdivisions: options.subdivisions ?? Math.max(1, Math.min(source.width, source.height) - 1),
-        minHeight: options.minHeight ?? 0,
-        maxHeight: options.maxHeight ?? 1,
-        updatable: false,
-    }, scene);
-}
-//# sourceMappingURL=Heightmap.js.map

package/dist/three-d/Heightmap.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"Heightmap.js","sourceRoot":"","sources":["../../src/three-d/Heightmap.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,yBAAyB,EAAE,MAAM,uDAAuD,CAAC;AA4BlG;;;;;;;;;;;GAWG;AACH,MAAM,UAAU,wBAAwB,CACvC,KAAY,EACZ,MAAuB,EACvB,OAAO,GAA8B,EAAE;IAEvC,IAAI,CAAC,CAAC,MAAM,CAAC,KAAK,GAAG,CAAC,CAAC,IAAI,CAAC,CAAC,MAAM,CAAC,MAAM,GAAG,CAAC,CAAC;QAAE,MAAM,IAAI,KAAK,CAAC,4CAA4C,CAAC,CAAC;IAC/G,IAAI,MAAM,CAAC,IAAI,CAAC,MAAM,GAAG,MAAM,CAAC,KAAK,GAAG,MAAM,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QAC3D,MAAM,IAAI,KAAK,CAAC,iEAAiE,CAAC,CAAC;IACpF,CAAC;IAED,OAAO,yBAAyB,CAC/B,mBAAmB,EACnB,EAAE,IAAI,EAAE,MAAM,CAAC,IAAI,EAAE,KAAK,EAAE,MAAM,CAAC,KAAK,EAAE,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,EACjE;QACC,KAAK,EAAE,OAAO,CAAC,KAAK,IAAI,EAAE;QAC1B,MAAM,EAAE,OAAO,CAAC,KAAK,IAAI,EAAE;QAC3B,YAAY,EAAE,OAAO,CAAC,YAAY,IAAI,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,IAAI,CAAC,GAAG,CAAC,MAAM,CAAC,KAAK,EAAE,MAAM,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;QAC5F,SAAS,EAAE,OAAO,CAAC,SAAS,IAAI,CAAC;QACjC,SAAS,EAAE,OAAO,CAAC,SAAS,IAAI,CAAC;QACjC,SAAS,EAAE,KAAK;KAChB,EACD,KAAK,CACL,CAAC;AACH,CAAC"}