@datamoc/mw_games 0.43.0 → 0.45.0

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

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

@@ -1,49 +0,0 @@
-import '@babylonjs/loaders/glTF/index.js';
-import type { ImportMeshOptions, ISceneLoaderAsyncResult, LoadAssetContainerOptions } from '@babylonjs/core/Loading/sceneLoader.js';
-import type { AssetContainer } from '@babylonjs/core/assetContainer.js';
-import type { Scene } from '@babylonjs/core/scene.js';
-export type ModelSource3D = string | File | ArrayBufferView;
-/**
- * Loads glTF/GLB from an asset path, data/blob/http(s) URI, File, or in-memory byte view. An
- * asset path is resolved through `mwg/assets` first, the same way every other loader in the
- * framework becomes `file://`-safe once assets are compiled to `data:` URIs; a URI that is
- * already resolved is passed through unchanged.
- *
- * For a single copy of a model this is the whole job; for several copies of the *same*
- * model, `loadModelContainer3D` fetches and parses once and instantiates independent copies
- * from it - calling this a second time for the same source imports and parses it again.
- */
-export declare function loadModel3D(source: ModelSource3D, scene: Scene, options?: ImportMeshOptions): Promise<ISceneLoaderAsyncResult>;
-/**
- * Loads a model once per resolved source and caches the in-flight/loaded `AssetContainer`,
- * so a second call for the same source returns the same container instead of importing and
- * parsing it again over the network. A container is not itself scene content - call
- * `container.instantiateModelsToScene()` for each independent copy a game wants to place,
- * which is Babylon's own way to get several unaliased instances of one loaded model without
- * a second fetch; `loadModel3D` imports straight into the scene instead, for the common case
- * of only ever wanting one copy.
- *
- * Only caches when `source` is a string (an asset path or already-resolved URI) - a `File`
- * or in-memory byte view has no stable identity to key a cache on, so those always load
- * fresh, the same way `loadModel3D` never tries to resolve them as a path either.
- *
- * @example
- * ```ts
- * import { loadModelContainer3D, isModelContainerLoaded, releaseModelContainer } from '@datamoc/mw_games/3d/models';
- *
- * declare const scene: import('@babylonjs/core/scene.js').Scene;
- *
- * const container = await loadModelContainer3D('models/tree.glb', scene);
- * const treeA = container.instantiateModelsToScene();
- * const treeB = container.instantiateModelsToScene(); // a second, independent copy - no re-fetch
- *
- * console.log(isModelContainerLoaded('models/tree.glb')); // true
- * releaseModelContainer('models/tree.glb'); // frees the container once every copy is placed
- * ```
- */
-export declare function loadModelContainer3D(source: ModelSource3D, scene: Scene, options?: LoadAssetContainerOptions): Promise<AssetContainer>;
-/** true once `loadModelContainer3D` has resolved for this source and it has not since been `releaseModelContainer`d */
-export declare function isModelContainerLoaded(source: string): boolean;
-/** disposes and forgets a cached container; a source never loaded (or already released) is silently skipped */
-export declare function releaseModelContainer(source: string): Promise<void>;
-//# sourceMappingURL=Models.d.ts.map

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

@@ -1 +0,0 @@
-{"version":3,"file":"Models.d.ts","sourceRoot":"","sources":["../../src/three-d/Models.ts"],"names":[],"mappings":"AAAA,OAAO,kCAAkC,CAAC;AAE1C,OAAO,KAAK,EACX,iBAAiB,EACjB,uBAAuB,EACvB,yBAAyB,EACzB,MAAM,wCAAwC,CAAC;AAChD,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,mCAAmC,CAAC;AACxE,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,0BAA0B,CAAC;AAItD,MAAM,MAAM,aAAa,GAAG,MAAM,GAAG,IAAI,GAAG,eAAe,CAAC;AAM5D;;;;;;;;;GASG;AACH,wBAAgB,WAAW,CAC1B,MAAM,EAAE,aAAa,EACrB,KAAK,EAAE,KAAK,EACZ,OAAO,CAAC,EAAE,iBAAiB,GACzB,OAAO,CAAC,uBAAuB,CAAC,CAElC;AAID;;;;;;;;;;;;;;;;;;;;;;;;;;GA0BG;AACH,wBAAgB,oBAAoB,CACnC,MAAM,EAAE,aAAa,EACrB,KAAK,EAAE,KAAK,EACZ,OAAO,CAAC,EAAE,yBAAyB,GACjC,OAAO,CAAC,cAAc,CAAC,CAYzB;AAED,uHAAuH;AACvH,wBAAgB,sBAAsB,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAG9D;AAED,+GAA+G;AAC/G,wBAAsB,qBAAqB,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAQzE"}

package/dist/three-d/Models.js

@@ -1,77 +0,0 @@
-import '@babylonjs/loaders/glTF/index.js';
-import { ImportMeshAsync, LoadAssetContainerAsync } from '@babylonjs/core/Loading/sceneLoader.js';
-import { resolve } from '../assets/paths.js';
-function resolveSource(source) {
-    return typeof source === 'string' && !/^(?:data|blob|https?):/i.test(source) ? resolve(source) : source;
-}
-/**
- * Loads glTF/GLB from an asset path, data/blob/http(s) URI, File, or in-memory byte view. An
- * asset path is resolved through `mwg/assets` first, the same way every other loader in the
- * framework becomes `file://`-safe once assets are compiled to `data:` URIs; a URI that is
- * already resolved is passed through unchanged.
- *
- * For a single copy of a model this is the whole job; for several copies of the *same*
- * model, `loadModelContainer3D` fetches and parses once and instantiates independent copies
- * from it - calling this a second time for the same source imports and parses it again.
- */
-export function loadModel3D(source, scene, options) {
-    return ImportMeshAsync(resolveSource(source), scene, options);
-}
-const containerCache = new Map();
-/**
- * Loads a model once per resolved source and caches the in-flight/loaded `AssetContainer`,
- * so a second call for the same source returns the same container instead of importing and
- * parsing it again over the network. A container is not itself scene content - call
- * `container.instantiateModelsToScene()` for each independent copy a game wants to place,
- * which is Babylon's own way to get several unaliased instances of one loaded model without
- * a second fetch; `loadModel3D` imports straight into the scene instead, for the common case
- * of only ever wanting one copy.
- *
- * Only caches when `source` is a string (an asset path or already-resolved URI) - a `File`
- * or in-memory byte view has no stable identity to key a cache on, so those always load
- * fresh, the same way `loadModel3D` never tries to resolve them as a path either.
- *
- * @example
- * ```ts
- * import { loadModelContainer3D, isModelContainerLoaded, releaseModelContainer } from '@datamoc/mw_games/3d/models';
- *
- * declare const scene: import('@babylonjs/core/scene.js').Scene;
- *
- * const container = await loadModelContainer3D('models/tree.glb', scene);
- * const treeA = container.instantiateModelsToScene();
- * const treeB = container.instantiateModelsToScene(); // a second, independent copy - no re-fetch
- *
- * console.log(isModelContainerLoaded('models/tree.glb')); // true
- * releaseModelContainer('models/tree.glb'); // frees the container once every copy is placed
- * ```
- */
-export function loadModelContainer3D(source, scene, options) {
-    const resolved = resolveSource(source);
-    if (typeof resolved !== 'string')
-        return LoadAssetContainerAsync(resolved, scene, options);
-    const cached = containerCache.get(resolved);
-    if (cached)
-        return cached;
-    const promise = LoadAssetContainerAsync(resolved, scene, options);
-    containerCache.set(resolved, promise);
-    //a rejected load must not poison the cache - the next call gets a fresh attempt
-    promise.catch(() => containerCache.delete(resolved));
-    return promise;
-}
-/** true once `loadModelContainer3D` has resolved for this source and it has not since been `releaseModelContainer`d */
-export function isModelContainerLoaded(source) {
-    const resolved = resolveSource(source);
-    return typeof resolved === 'string' && containerCache.has(resolved);
-}
-/** disposes and forgets a cached container; a source never loaded (or already released) is silently skipped */
-export async function releaseModelContainer(source) {
-    const resolved = resolveSource(source);
-    if (typeof resolved !== 'string')
-        return;
-    const cached = containerCache.get(resolved);
-    if (!cached)
-        return;
-    containerCache.delete(resolved);
-    (await cached).dispose();
-}
-//# sourceMappingURL=Models.js.map

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

@@ -1 +0,0 @@
-{"version":3,"file":"Models.js","sourceRoot":"","sources":["../../src/three-d/Models.ts"],"names":[],"mappings":"AAAA,OAAO,kCAAkC,CAAC;AAC1C,OAAO,EAAE,eAAe,EAAE,uBAAuB,EAAE,MAAM,wCAAwC,CAAC;AASlG,OAAO,EAAE,OAAO,EAAE,MAAM,oBAAoB,CAAC;AAI7C,SAAS,aAAa,CAAC,MAAqB;IAC3C,OAAO,OAAO,MAAM,KAAK,QAAQ,IAAI,CAAC,yBAAyB,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC;AACzG,CAAC;AAED;;;;;;;;;GASG;AACH,MAAM,UAAU,WAAW,CAC1B,MAAqB,EACrB,KAAY,EACZ,OAA2B;IAE3B,OAAO,eAAe,CAAC,aAAa,CAAC,MAAM,CAAC,EAAE,KAAK,EAAE,OAAO,CAAC,CAAC;AAC/D,CAAC;AAED,MAAM,cAAc,GAAG,IAAI,GAAG,EAAmC,CAAC;AAElE;;;;;;;;;;;;;;;;;;;;;;;;;;GA0BG;AACH,MAAM,UAAU,oBAAoB,CACnC,MAAqB,EACrB,KAAY,EACZ,OAAmC;IAEnC,MAAM,QAAQ,GAAG,aAAa,CAAC,MAAM,CAAC,CAAC;IACvC,IAAI,OAAO,QAAQ,KAAK,QAAQ;QAAE,OAAO,uBAAuB,CAAC,QAAQ,EAAE,KAAK,EAAE,OAAO,CAAC,CAAC;IAE3F,MAAM,MAAM,GAAG,cAAc,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC;IAC5C,IAAI,MAAM;QAAE,OAAO,MAAM,CAAC;IAE1B,MAAM,OAAO,GAAG,uBAAuB,CAAC,QAAQ,EAAE,KAAK,EAAE,OAAO,CAAC,CAAC;IAClE,cAAc,CAAC,GAAG,CAAC,QAAQ,EAAE,OAAO,CAAC,CAAC;IACtC,gFAAgF;IAChF,OAAO,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC,cAAc,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC,CAAC;IACrD,OAAO,OAAO,CAAC;AAChB,CAAC;AAED,uHAAuH;AACvH,MAAM,UAAU,sBAAsB,CAAC,MAAc;IACpD,MAAM,QAAQ,GAAG,aAAa,CAAC,MAAM,CAAC,CAAC;IACvC,OAAO,OAAO,QAAQ,KAAK,QAAQ,IAAI,cAAc,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC;AACrE,CAAC;AAED,+GAA+G;AAC/G,MAAM,CAAC,KAAK,UAAU,qBAAqB,CAAC,MAAc;IACzD,MAAM,QAAQ,GAAG,aAAa,CAAC,MAAM,CAAC,CAAC;IACvC,IAAI,OAAO,QAAQ,KAAK,QAAQ;QAAE,OAAO;IAEzC,MAAM,MAAM,GAAG,cAAc,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC;IAC5C,IAAI,CAAC,MAAM;QAAE,OAAO;IACpB,cAAc,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC;IAChC,CAAC,MAAM,MAAM,CAAC,CAAC,OAAO,EAAE,CAAC;AAC1B,CAAC"}

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

@@ -1,27 +0,0 @@
-import '@babylonjs/core/Meshes/thinInstanceMesh.js';
-import type { Mesh } from '@babylonjs/core/Meshes/mesh.js';
-import type { Scene } from '@babylonjs/core/scene.js';
-import type { GridCell3D, GridShape3D } from './Grid.ts';
-/**
- * `tileSize`, `heightStep` (world units per height level) and `origin` offset default to 1, 1 and the world origin; `tileThickness` is 0.12. Colors are 24-bit RGB.
- */
-export interface TileGrid3DOptions {
-    shape: GridShape3D;
-    tileSize?: number;
-    heightStep?: number;
-    tileThickness?: number;
-    tileColor?: number;
-    columnColor?: number;
-    origin?: readonly [number, number, number];
-}
-/**
- * The built meshes. `columns` is null when no cell is raised or sunken. `dispose` frees the meshes and their materials.
- */
-export interface TileGrid3DMeshes {
-    tiles: Mesh;
-    columns: Mesh | null;
-    dispose(): void;
-}
-/** Builds an instanced square or flat-top hex floor with optional raised columns. */
-export declare function createTileGrid3D(scene: Scene, cells: readonly GridCell3D[], options: TileGrid3DOptions): TileGrid3DMeshes;
-//# sourceMappingURL=TileGrid3D.d.ts.map

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

@@ -1 +0,0 @@
-{"version":3,"file":"TileGrid3D.d.ts","sourceRoot":"","sources":["../../src/three-d/TileGrid3D.ts"],"names":[],"mappings":"AAKA,OAAO,4CAA4C,CAAC;AACpD,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,gCAAgC,CAAC;AAC3D,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,0BAA0B,CAAC;AAEtD,OAAO,KAAK,EAAE,UAAU,EAAE,WAAW,EAAE,MAAM,WAAW,CAAC;AAEzD;;GAEG;AACH,MAAM,WAAW,iBAAiB;IACjC,KAAK,EAAE,WAAW,CAAC;IACnB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,MAAM,CAAC,EAAE,SAAS,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,CAAC;CAC3C;AAED;;GAEG;AACH,MAAM,WAAW,gBAAgB;IAChC,KAAK,EAAE,IAAI,CAAC;IACZ,OAAO,EAAE,IAAI,GAAG,IAAI,CAAC;IACrB,OAAO,IAAI,IAAI,CAAC;CAChB;AAED,qFAAqF;AACrF,wBAAgB,gBAAgB,CAC/B,KAAK,EAAE,KAAK,EACZ,KAAK,EAAE,SAAS,UAAU,EAAE,EAC5B,OAAO,EAAE,iBAAiB,GACxB,gBAAgB,CAyDlB"}

package/dist/three-d/TileGrid3D.js

@@ -1,66 +0,0 @@
-import { StandardMaterial } from '@babylonjs/core/Materials/standardMaterial.js';
-import { Color3 } from '@babylonjs/core/Maths/math.color.js';
-import { Matrix, Quaternion, Vector3 } from '@babylonjs/core/Maths/math.vector.js';
-import { CreateBox } from '@babylonjs/core/Meshes/Builders/boxBuilder.pure.js';
-import { CreateCylinder } from '@babylonjs/core/Meshes/Builders/cylinderBuilder.pure.js';
-import '@babylonjs/core/Meshes/thinInstanceMesh.js';
-import { gridPoint3D } from './Grid.js';
-/** Builds an instanced square or flat-top hex floor with optional raised columns. */
-export function createTileGrid3D(scene, cells, options) {
-    const tileSize = options.tileSize ?? 1;
-    const heightStep = options.heightStep ?? 1;
-    const thickness = options.tileThickness ?? 0.12;
-    if (!(thickness > 0))
-        throw new Error('3D tile thickness must be positive');
-    const origin = options.origin ?? [0, 0, 0];
-    const tiles = options.shape === 'square'
-        ? CreateBox('square-tiles', { width: tileSize * 0.94, height: thickness, depth: tileSize * 0.94 }, scene)
-        : CreateCylinder('hex-tiles', { diameter: tileSize * 1.9, height: thickness, tessellation: 6 }, scene);
-    const tileMaterial = material(scene, 'tile-material', options.tileColor ?? 0x5f8f62);
-    tiles.material = tileMaterial;
-    setMatrices(tiles, cells.map((cell) => {
-        const point = gridPoint3D(options.shape, cell.x, cell.y, tileSize, cell.height ?? 0, heightStep);
-        return Matrix.Translation(point.x + origin[0], point.y + origin[1] - thickness / 2, point.z + origin[2]);
-    }));
-    const raised = cells.filter((cell) => (cell.height ?? 0) !== 0);
-    let columns = null;
-    let columnMaterial = null;
-    if (raised.length) {
-        columns =
-            options.shape === 'square'
-                ? CreateBox('square-columns', { size: 1 }, scene)
-                : CreateCylinder('hex-columns', { diameter: 1.9, height: 1, tessellation: 6 }, scene);
-        columnMaterial = material(scene, 'column-material', options.columnColor ?? 0x3f6048);
-        columns.material = columnMaterial;
-        setMatrices(columns, raised.map((cell) => {
-            const levels = cell.height ?? 0;
-            const point = gridPoint3D(options.shape, cell.x, cell.y, tileSize, 0, heightStep);
-            const height = Math.abs(levels * heightStep);
-            const centerY = origin[1] + (Math.sign(levels) * height) / 2;
-            const horizontal = options.shape === 'square' ? tileSize * 0.94 : tileSize;
-            return Matrix.Compose(new Vector3(horizontal, height, horizontal), Quaternion.Identity(), new Vector3(point.x + origin[0], centerY, point.z + origin[2]));
-        }));
-    }
-    return {
-        tiles,
-        columns,
-        dispose() {
-            tiles.dispose();
-            columns?.dispose();
-            tileMaterial.dispose();
-            columnMaterial?.dispose();
-        },
-    };
-}
-function setMatrices(mesh, matrices) {
-    const data = new Float32Array(matrices.length * 16);
-    for (let index = 0; index < matrices.length; index++)
-        matrices[index].copyToArray(data, index * 16);
-    mesh.thinInstanceSetBuffer('matrix', data, 16, true);
-}
-function material(scene, name, color) {
-    const value = new StandardMaterial(name, scene);
-    value.diffuseColor = new Color3(((color >> 16) & 0xff) / 255, ((color >> 8) & 0xff) / 255, (color & 0xff) / 255);
-    return value;
-}
-//# sourceMappingURL=TileGrid3D.js.map

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

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

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

@@ -1,43 +0,0 @@
-import '@babylonjs/core/Meshes/thinInstanceMesh.js';
-import { TransformNode } from '@babylonjs/core/Meshes/transformNode.js';
-import type { Scene } from '@babylonjs/core/scene.js';
-/** Model extent in voxels along each axis. */
-export interface VoxSize {
-    x: number;
-    y: number;
-    z: number;
-}
-/**
- * One filled cell. `color` is a 1-based index into the model palette; `z` is up in the VOX file (mapped to world Y on build).
- */
-export interface Voxel {
-    x: number;
-    y: number;
-    z: number;
-    color: number;
-}
-/**
- * A parsed VOX model. `palette` holds 256 little-endian RGBA entries (the default grayscale ramp when the file has none).
- */
-export interface VoxModel {
-    size: VoxSize;
-    voxels: readonly Voxel[];
-    palette: Uint32Array;
-}
-/**
- * Reads one MagicaVoxel VOX model, including an optional RGBA palette chunk.
- *
- * @example
- * ```ts
- * import { parseVox } from '@datamoc/mw_games/3d';
- *
- * declare const voxBytes: ArrayBuffer;
- *
- * const model = parseVox(voxBytes);
- * console.log(model.size, model.voxels.length);
- * ```
- */
-export declare function parseVox(data: ArrayBuffer | ArrayBufferView): VoxModel;
-/** Turns parsed voxels into color-batched Babylon thin instances under one transform node. */
-export declare function createVoxModel3D(scene: Scene, model: VoxModel, voxelSize?: number): TransformNode;
-//# sourceMappingURL=Vox.d.ts.map

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

@@ -1 +0,0 @@
-{"version":3,"file":"Vox.d.ts","sourceRoot":"","sources":["../../src/three-d/Vox.ts"],"names":[],"mappings":"AAIA,OAAO,4CAA4C,CAAC;AACpD,OAAO,EAAE,aAAa,EAAE,MAAM,yCAAyC,CAAC;AACxE,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,0BAA0B,CAAC;AAEtD,8CAA8C;AAC9C,MAAM,WAAW,OAAO;IACvB,CAAC,EAAE,MAAM,CAAC;IACV,CAAC,EAAE,MAAM,CAAC;IACV,CAAC,EAAE,MAAM,CAAC;CACV;AACD;;GAEG;AACH,MAAM,WAAW,KAAK;IACrB,CAAC,EAAE,MAAM,CAAC;IACV,CAAC,EAAE,MAAM,CAAC;IACV,CAAC,EAAE,MAAM,CAAC;IACV,KAAK,EAAE,MAAM,CAAC;CACd;AACD;;GAEG;AACH,MAAM,WAAW,QAAQ;IACxB,IAAI,EAAE,OAAO,CAAC;IACd,MAAM,EAAE,SAAS,KAAK,EAAE,CAAC;IACzB,OAAO,EAAE,WAAW,CAAC;CACrB;AAED;;;;;;;;;;;;GAYG;AACH,wBAAgB,QAAQ,CAAC,IAAI,EAAE,WAAW,GAAG,eAAe,GAAG,QAAQ,CAyCtE;AAED,8FAA8F;AAC9F,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,KAAK,EAAE,KAAK,EAAE,QAAQ,EAAE,SAAS,SAAI,GAAG,aAAa,CAgC5F"}

package/dist/three-d/Vox.js

@@ -1,108 +0,0 @@
-import { StandardMaterial } from '@babylonjs/core/Materials/standardMaterial.js';
-import { Color3 } from '@babylonjs/core/Maths/math.color.js';
-import { Matrix } from '@babylonjs/core/Maths/math.vector.js';
-import { CreateBox } from '@babylonjs/core/Meshes/Builders/boxBuilder.pure.js';
-import '@babylonjs/core/Meshes/thinInstanceMesh.js';
-import { TransformNode } from '@babylonjs/core/Meshes/transformNode.js';
-/**
- * Reads one MagicaVoxel VOX model, including an optional RGBA palette chunk.
- *
- * @example
- * ```ts
- * import { parseVox } from '@datamoc/mw_games/3d';
- *
- * declare const voxBytes: ArrayBuffer;
- *
- * const model = parseVox(voxBytes);
- * console.log(model.size, model.voxels.length);
- * ```
- */
-export function parseVox(data) {
-    const bytes = data instanceof ArrayBuffer
-        ? new Uint8Array(data)
-        : new Uint8Array(data.buffer, data.byteOffset, data.byteLength);
-    if (bytes.length < 20 || text(bytes, 0) !== 'VOX ')
-        throw new Error('invalid VOX header');
-    const view = new DataView(bytes.buffer, bytes.byteOffset, bytes.byteLength);
-    let offset = 8;
-    let size = null;
-    let voxels = null;
-    const palette = defaultPalette();
-    while (offset + 12 <= bytes.length) {
-        const id = text(bytes, offset);
-        const contentSize = view.getUint32(offset + 4, true);
-        const childrenSize = view.getUint32(offset + 8, true);
-        const content = offset + 12;
-        const end = content + contentSize;
-        if (end + childrenSize > bytes.length)
-            throw new Error(`truncated VOX ${id} chunk`);
-        if (id === 'SIZE') {
-            if (contentSize < 12)
-                throw new Error('invalid VOX SIZE chunk');
-            size = {
-                x: view.getUint32(content, true),
-                y: view.getUint32(content + 4, true),
-                z: view.getUint32(content + 8, true),
-            };
-        }
-        else if (id === 'XYZI') {
-            const count = view.getUint32(content, true);
-            if (contentSize < 4 + count * 4)
-                throw new Error('invalid VOX XYZI chunk');
-            voxels = Array.from({ length: count }, (_, index) => {
-                const at = content + 4 + index * 4;
-                return { x: bytes[at], y: bytes[at + 1], z: bytes[at + 2], color: bytes[at + 3] };
-            });
-        }
-        else if (id === 'RGBA') {
-            if (contentSize < 1024)
-                throw new Error('invalid VOX RGBA chunk');
-            for (let index = 0; index < 256; index++)
-                palette[index] = view.getUint32(content + index * 4, true);
-        }
-        offset = end;
-    }
-    if (!size || !voxels)
-        throw new Error('VOX file needs SIZE and XYZI chunks');
-    return { size, voxels, palette };
-}
-/** Turns parsed voxels into color-batched Babylon thin instances under one transform node. */
-export function createVoxModel3D(scene, model, voxelSize = 1) {
-    if (!(voxelSize > 0))
-        throw new Error('voxel size must be positive');
-    const root = new TransformNode('vox-model', scene);
-    const groups = new Map();
-    for (const voxel of model.voxels) {
-        const group = groups.get(voxel.color) ?? [];
-        group.push(voxel);
-        groups.set(voxel.color, group);
-    }
-    for (const [color, voxels] of groups) {
-        const box = CreateBox(`voxels-${color}`, { size: voxelSize }, scene);
-        box.parent = root;
-        const rgba = model.palette[Math.max(0, color - 1)];
-        const material = new StandardMaterial(`voxel-${color}`, scene);
-        material.diffuseColor = new Color3((rgba & 0xff) / 255, ((rgba >> 8) & 0xff) / 255, ((rgba >> 16) & 0xff) / 255);
-        material.alpha = ((rgba >>> 24) & 0xff) / 255;
-        box.material = material;
-        const matrices = new Float32Array(voxels.length * 16);
-        for (let index = 0; index < voxels.length; index++) {
-            const voxel = voxels[index];
-            Matrix.Translation(voxel.x * voxelSize, voxel.z * voxelSize, voxel.y * voxelSize).copyToArray(matrices, index * 16);
-        }
-        box.thinInstanceSetBuffer('matrix', matrices, 16, true);
-    }
-    return root;
-}
-function text(bytes, offset) {
-    return String.fromCharCode(...bytes.subarray(offset, offset + 4));
-}
-function defaultPalette() {
-    const palette = new Uint32Array(256);
-    for (let index = 0; index < 256; index++) {
-        const shade = index & 0xff;
-        palette[index] = shade | (shade << 8) | (shade << 16) | 0xff000000;
-    }
-    return palette;
-}
-//# sourceMappingURL=Vox.js.map

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

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

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

@@ -1,15 +0,0 @@
-export { Engine3D } from './Engine3D.ts';
-export type { Engine3DOptions, Frame3D } from './Engine3D.ts';
-export { gridPoint3D } from './Grid.ts';
-export type { GridCell3D, GridShape3D, Point3D } from './Grid.ts';
-export { createTileGrid3D } from './TileGrid3D.ts';
-export type { TileGrid3DMeshes, TileGrid3DOptions } from './TileGrid3D.ts';
-export { Character3D } from './Character3D.ts';
-export type { Billboard3DOptions, CollideXZ } from './Character3D.ts';
-export { parseVox, createVoxModel3D } from './Vox.ts';
-export type { VoxModel, VoxSize, Voxel } from './Vox.ts';
-export { createHeightmapTerrain3D } from './Heightmap.ts';
-export type { HeightmapSource, HeightmapTerrain3DOptions } from './Heightmap.ts';
-export { buildHeightIndex, cellAt, heightAt, resolveCapsuleAgainstGrid } from './Collision3D.ts';
-export type { CapsuleGridMoveOptions, CapsuleGridMoveResult } from './Collision3D.ts';
-//# sourceMappingURL=index.d.ts.map

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

@@ -1 +0,0 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/three-d/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAC;AACzC,YAAY,EAAE,eAAe,EAAE,OAAO,EAAE,MAAM,eAAe,CAAC;AAC9D,OAAO,EAAE,WAAW,EAAE,MAAM,WAAW,CAAC;AACxC,YAAY,EAAE,UAAU,EAAE,WAAW,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAClE,OAAO,EAAE,gBAAgB,EAAE,MAAM,iBAAiB,CAAC;AACnD,YAAY,EAAE,gBAAgB,EAAE,iBAAiB,EAAE,MAAM,iBAAiB,CAAC;AAC3E,OAAO,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAC;AAC/C,YAAY,EAAE,kBAAkB,EAAE,SAAS,EAAE,MAAM,kBAAkB,CAAC;AACtE,OAAO,EAAE,QAAQ,EAAE,gBAAgB,EAAE,MAAM,UAAU,CAAC;AACtD,YAAY,EAAE,QAAQ,EAAE,OAAO,EAAE,KAAK,EAAE,MAAM,UAAU,CAAC;AACzD,OAAO,EAAE,wBAAwB,EAAE,MAAM,gBAAgB,CAAC;AAC1D,YAAY,EAAE,eAAe,EAAE,yBAAyB,EAAE,MAAM,gBAAgB,CAAC;AACjF,OAAO,EAAE,gBAAgB,EAAE,MAAM,EAAE,QAAQ,EAAE,yBAAyB,EAAE,MAAM,kBAAkB,CAAC;AACjG,YAAY,EAAE,sBAAsB,EAAE,qBAAqB,EAAE,MAAM,kBAAkB,CAAC"}