@datamoc/mw_games 0.43.0 → 0.45.0

package/dist/threads/worker.d.ts

@@ -1,51 +0,0 @@
-/** what the main thread posts to a fresh worker: the task's source and its arguments */
-export interface WorkerRequest {
-    /** the stringified task function, rehydrated in the worker with `new Function` */
-    code: string;
-    args: readonly unknown[];
-}
-/** what the worker posts back: the value, or the failure that stopped it */
-export type WorkerReply = {
-    ok: true;
-    value: unknown;
-} | {
-    ok: false;
-    message: string;
-    stack?: string;
-};
-/**
- * The slice of `node:worker_threads` this module uses, described structurally: `src/`
- * compiles in a browser-only config (the `@example` fence compiler runs with `types: []`),
- * so nothing here may name `process` or a `node:` type directly.
- */
-export interface NodeThreads {
-    parentPort: {
-        on(event: 'message', listener: (request: WorkerRequest) => void): void;
-        postMessage(message: WorkerReply, transfer?: ArrayBuffer[]): void;
-    } | null;
-    Worker: new (code: string, options: {
-        eval: true;
-    }) => {
-        on(event: 'message', listener: (reply: WorkerReply) => void): void;
-        on(event: 'error', listener: (error: unknown) => void): void;
-        on(event: 'messageerror', listener: () => void): void;
-        on(event: 'exit', listener: (code: number) => void): void;
-        postMessage(message: WorkerRequest, transfer?: readonly unknown[]): void;
-        terminate(): Promise<number> | void;
-    };
-}
-/** `node:worker_threads` reached through `globalThis`, so nothing here needs @types/node */
-export declare function nodeThreads(): NodeThreads | undefined;
-/**
- * The worker half of `threads.spawn`: receives one task, runs it, replies, and goes no
- * further (spawn terminates it as soon as the reply settles).
- *
- * **This function must stay self-contained.** `spawn` ships it to a worker with
- * `workerMain.toString()`, so it may not reference imports, module-scope helpers or any
- * outer binding - everything it needs is either a language global or nested inside it.
- * The same body runs in both transports: a classic blob worker in the browser (where the
- * shipped `file://` CSP allows only `worker-src blob:` and `new Function`, per the T161
- * probe) and an eval'd `node:worker_threads` worker in Node, which has no `self`.
- */
-export declare function workerMain(): void;
-//# sourceMappingURL=worker.d.ts.map

package/dist/threads/worker.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"worker.d.ts","sourceRoot":"","sources":["../../src/threads/worker.ts"],"names":[],"mappings":"AAAA,wFAAwF;AACxF,MAAM,WAAW,aAAa;IAC7B,kFAAkF;IAClF,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,SAAS,OAAO,EAAE,CAAC;CACzB;AAED,4EAA4E;AAC5E,MAAM,MAAM,WAAW,GAAG;IAAE,EAAE,EAAE,IAAI,CAAC;IAAC,KAAK,EAAE,OAAO,CAAA;CAAE,GAAG;IAAE,EAAE,EAAE,KAAK,CAAC;IAAC,OAAO,EAAE,MAAM,CAAC;IAAC,KAAK,CAAC,EAAE,MAAM,CAAA;CAAE,CAAC;AAExG;;;;GAIG;AACH,MAAM,WAAW,WAAW;IAC3B,UAAU,EAAE;QACX,EAAE,CAAC,KAAK,EAAE,SAAS,EAAE,QAAQ,EAAE,CAAC,OAAO,EAAE,aAAa,KAAK,IAAI,GAAG,IAAI,CAAC;QACvE,WAAW,CAAC,OAAO,EAAE,WAAW,EAAE,QAAQ,CAAC,EAAE,WAAW,EAAE,GAAG,IAAI,CAAC;KAClE,GAAG,IAAI,CAAC;IACT,MAAM,EAAE,KACP,IAAI,EAAE,MAAM,EACZ,OAAO,EAAE;QAAE,IAAI,EAAE,IAAI,CAAA;KAAE,KACnB;QACJ,EAAE,CAAC,KAAK,EAAE,SAAS,EAAE,QAAQ,EAAE,CAAC,KAAK,EAAE,WAAW,KAAK,IAAI,GAAG,IAAI,CAAC;QACnE,EAAE,CAAC,KAAK,EAAE,OAAO,EAAE,QAAQ,EAAE,CAAC,KAAK,EAAE,OAAO,KAAK,IAAI,GAAG,IAAI,CAAC;QAC7D,EAAE,CAAC,KAAK,EAAE,cAAc,EAAE,QAAQ,EAAE,MAAM,IAAI,GAAG,IAAI,CAAC;QACtD,EAAE,CAAC,KAAK,EAAE,MAAM,EAAE,QAAQ,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,GAAG,IAAI,CAAC;QAC1D,WAAW,CAAC,OAAO,EAAE,aAAa,EAAE,QAAQ,CAAC,EAAE,SAAS,OAAO,EAAE,GAAG,IAAI,CAAC;QACzE,SAAS,IAAI,OAAO,CAAC,MAAM,CAAC,GAAG,IAAI,CAAC;KACpC,CAAC;CACF;AAED,4FAA4F;AAC5F,wBAAgB,WAAW,IAAI,WAAW,GAAG,SAAS,CAMrD;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,UAAU,IAAI,IAAI,CAoEjC"}

package/dist/threads/worker.js

@@ -1,84 +0,0 @@
-/** `node:worker_threads` reached through `globalThis`, so nothing here needs @types/node */
-export function nodeThreads() {
-    return globalThis.process?.getBuiltinModule?.('node:worker_threads');
-}
-/**
- * The worker half of `threads.spawn`: receives one task, runs it, replies, and goes no
- * further (spawn terminates it as soon as the reply settles).
- *
- * **This function must stay self-contained.** `spawn` ships it to a worker with
- * `workerMain.toString()`, so it may not reference imports, module-scope helpers or any
- * outer binding - everything it needs is either a language global or nested inside it.
- * The same body runs in both transports: a classic blob worker in the browser (where the
- * shipped `file://` CSP allows only `worker-src blob:` and `new Function`, per the T161
- * probe) and an eval'd `node:worker_threads` worker in Node, which has no `self`.
- */
-export function workerMain() {
-    //the same chain as nodeThreads(), inlined because workerMain is stringified into the
-    //worker and may not call anything module-scoped; the cast is a type, erased before then
-    const nodePort = globalThis.process?.getBuiltinModule?.('node:worker_threads')?.parentPort ?? null;
-    const scope = globalThis;
-    /** every ArrayBuffer reachable through plain objects and arrays, listed once each */
-    const transferablesOf = (value) => {
-        const out = [];
-        const seen = new Set();
-        const visit = (item) => {
-            if (item === null || typeof item !== 'object')
-                return;
-            if (seen.has(item))
-                return;
-            seen.add(item);
-            if (ArrayBuffer.isView(item)) {
-                //a view transfers its whole buffer; a SharedArrayBuffer cannot transfer, so it
-                //stays a copy (and does not exist in the shipped file:// target at all)
-                const buffer = item.buffer;
-                if (buffer instanceof ArrayBuffer && !out.includes(buffer))
-                    out.push(buffer);
-                return;
-            }
-            if (item instanceof ArrayBuffer) {
-                if (!out.includes(item))
-                    out.push(item);
-                return;
-            }
-            if (Array.isArray(item)) {
-                for (const entry of item)
-                    visit(entry);
-                return;
-            }
-            const prototype = Object.getPrototypeOf(item);
-            if (prototype === Object.prototype || prototype === null) {
-                for (const entry of Object.values(item))
-                    visit(entry);
-            }
-        };
-        visit(value);
-        return out;
-    };
-    const reply = (message, transfer = []) => {
-        if (nodePort)
-            nodePort.postMessage(message, transfer);
-        else
-            scope.postMessage(message, transfer);
-    };
-    const onRequest = async (request) => {
-        try {
-            const task = new Function(`return (${request.code});`)();
-            const value = await task(...request.args);
-            reply({ ok: true, value }, transferablesOf(value));
-        }
-        catch (error) {
-            const failure = error;
-            reply({
-                ok: false,
-                message: String(failure?.message ?? error),
-                stack: typeof failure?.stack === 'string' ? failure.stack : undefined,
-            });
-        }
-    };
-    if (nodePort)
-        nodePort.on('message', (request) => void onRequest(request));
-    else
-        scope.onmessage = (event) => void onRequest(event.data);
-}
-//# sourceMappingURL=worker.js.map

package/dist/threads/worker.js.map

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

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

@@ -1,74 +0,0 @@
-import type { AnimationGroup } from '@babylonjs/core/Animations/animationGroup.js';
-import type { AbstractMesh } from '@babylonjs/core/Meshes/abstractMesh.js';
-import { TransformNode } from '@babylonjs/core/Meshes/transformNode.js';
-import type { Scene } from '@babylonjs/core/scene.js';
-/** Options for `Character3D.billboard`. `width` and `height` are world units (1 and 1.5 when omitted). */
-export interface Billboard3DOptions {
-    /**
-     * An asset path (resolved through `mwg/assets`) or an already-resolved `data:`/`blob:`
-     * URI. A `data:` URI must be base64-encoded (`;base64,...`) - Babylon's texture loader
-     * does not decode a percent-encoded one and fails to load it without an error.
-     */
-    texture: string;
-    width?: number;
-    height?: number;
-}
-/**
- * Clamps one frame's intended horizontal move to wherever collision actually allows - the
- * hook `mwg/3d`'s own grid collision (`resolveCapsuleAgainstGrid`) plugs into. `blocked`,
- * when the resolver reports it (`resolveCapsuleAgainstGrid` always does), tells `update`
- * directly whether the move was cut short, rather than `update` re-deriving the same fact by
- * comparing the resolved position against the intended one through separate floating-point
- * arithmetic - two numbers that are conceptually equal are not guaranteed bit-identical.
- */
-export type CollideXZ = (from: {
-    x: number;
-    z: number;
-}, to: {
-    x: number;
-    z: number;
-}) => {
-    x: number;
-    z: number;
-    blocked?: boolean;
-};
-/**
- * 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 declare class Character3D {
-    readonly node: TransformNode;
-    private target;
-    private speed;
-    private readonly collideXZ?;
-    private readonly animations;
-    private currentClip;
-    /**
-     * @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: TransformNode, animations?: readonly AnimationGroup[], collideXZ?: CollideXZ);
-    /** true when an animation clip of this name was imported with the model */
-    hasAnimation(name: string): boolean;
-    /**
-     * 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: string, loop?: boolean): boolean;
-    /** stops whichever imported clip is currently playing, if any */
-    stopAnimation(): void;
-    /** the name of the clip currently playing, or null when none is */
-    get currentAnimation(): string | null;
-    moveTo(x: number, y: number, z: number, speed: number): void;
-    update(deltaSeconds: number): boolean;
-    /** @param animations typically `loadModel3D`'s own `animationGroups` result field */
-    static fromMesh(mesh: AbstractMesh, animations?: readonly AnimationGroup[]): Character3D;
-    static billboard(scene: Scene, options: Billboard3DOptions): Character3D;
-}
-//# sourceMappingURL=Character3D.d.ts.map

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"}