@datamoc/mw_games 0.1.2 → 0.2.1

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

@@ -0,0 +1 @@
+{"version":3,"file":"Models.d.ts","sourceRoot":"","sources":["../../src/three-d/Models.ts"],"names":[],"mappings":"AAAA,OAAO,kCAAkC,CAAC;AAE1C,OAAO,KAAK,EAAE,iBAAiB,EAAE,uBAAuB,EAAE,MAAM,wCAAwC,CAAC;AACzG,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,0BAA0B,CAAC;AAItD,MAAM,MAAM,aAAa,GAAG,MAAM,GAAG,IAAI,GAAG,eAAe,CAAC;AAE5D;;;;;GAKG;AACH,wBAAgB,WAAW,CAAC,MAAM,EAAE,aAAa,EAAE,KAAK,EAAE,KAAK,EAAE,OAAO,CAAC,EAAE,iBAAiB,GAAG,OAAO,CAAC,uBAAuB,CAAC,CAG9H"}

package/dist/three-d/Models.js

@@ -0,0 +1,14 @@
+import '@babylonjs/loaders/glTF/index.js';
+import { ImportMeshAsync } from '@babylonjs/core/Loading/sceneLoader.js';
+import { resolve } from '../assets/index.js';
+/**
+ * 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.
+ */
+export function loadModel3D(source, scene, options) {
+    const resolved = typeof source === 'string' && !/^(?:data|blob|https?):/i.test(source) ? resolve(source) : source;
+    return ImportMeshAsync(resolved, scene, options);
+}
+//# sourceMappingURL=Models.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"Models.js","sourceRoot":"","sources":["../../src/three-d/Models.ts"],"names":[],"mappings":"AAAA,OAAO,kCAAkC,CAAC;AAC1C,OAAO,EAAE,eAAe,EAAE,MAAM,wCAAwC,CAAC;AAIzE,OAAO,EAAE,OAAO,EAAE,MAAM,oBAAoB,CAAC;AAI7C;;;;;GAKG;AACH,MAAM,UAAU,WAAW,CAAC,MAAqB,EAAE,KAAY,EAAE,OAA2B;IAC3F,MAAM,QAAQ,GAAG,OAAO,MAAM,KAAK,QAAQ,IAAI,CAAC,yBAAyB,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC;IAClH,OAAO,eAAe,CAAC,QAAQ,EAAE,KAAK,EAAE,OAAO,CAAC,CAAC;AAClD,CAAC"}

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

@@ -0,0 +1,21 @@
+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';
+export interface TileGrid3DOptions {
+    shape: GridShape3D;
+    tileSize?: number;
+    heightStep?: number;
+    tileThickness?: number;
+    tileColor?: number;
+    columnColor?: number;
+    origin?: readonly [number, number, number];
+}
+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

@@ -0,0 +1 @@
+{"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,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,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,CAAC,KAAK,EAAE,KAAK,EAAE,KAAK,EAAE,SAAS,UAAU,EAAE,EAAE,OAAO,EAAE,iBAAiB,GAAG,gBAAgB,CAiDzH"}

package/dist/three-d/TileGrid3D.js

@@ -0,0 +1,65 @@
+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

@@ -0,0 +1 @@
+{"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

@@ -0,0 +1,24 @@
+import '@babylonjs/core/Meshes/thinInstanceMesh.js';
+import { TransformNode } from '@babylonjs/core/Meshes/transformNode.js';
+import type { Scene } from '@babylonjs/core/scene.js';
+export interface VoxSize {
+    x: number;
+    y: number;
+    z: number;
+}
+export interface Voxel {
+    x: number;
+    y: number;
+    z: number;
+    color: number;
+}
+export interface VoxModel {
+    size: VoxSize;
+    voxels: readonly Voxel[];
+    palette: Uint32Array;
+}
+/** Reads one MagicaVoxel VOX model, including an optional RGBA palette chunk. */
+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

@@ -0,0 +1 @@
+{"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,MAAM,WAAW,OAAO;IAAG,CAAC,EAAE,MAAM,CAAC;IAAC,CAAC,EAAE,MAAM,CAAC;IAAC,CAAC,EAAE,MAAM,CAAC;CAAE;AAC7D,MAAM,WAAW,KAAK;IAAG,CAAC,EAAE,MAAM,CAAC;IAAC,CAAC,EAAE,MAAM,CAAC;IAAC,CAAC,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,MAAM,CAAC;CAAE;AAC1E,MAAM,WAAW,QAAQ;IAAG,IAAI,EAAE,OAAO,CAAC;IAAC,MAAM,EAAE,SAAS,KAAK,EAAE,CAAC;IAAC,OAAO,EAAE,WAAW,CAAC;CAAE;AAE5F,iFAAiF;AACjF,wBAAgB,QAAQ,CAAC,IAAI,EAAE,WAAW,GAAG,eAAe,GAAG,QAAQ,CAoCtE;AAED,8FAA8F;AAC9F,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,KAAK,EAAE,KAAK,EAAE,QAAQ,EAAE,SAAS,SAAI,GAAG,aAAa,CA0B5F"}

package/dist/three-d/Vox.js

@@ -0,0 +1,93 @@
+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. */
+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

@@ -0,0 +1 @@
+{"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

@@ -0,0 +1,13 @@
+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 } 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';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"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,MAAM,kBAAkB,CAAC;AAC3D,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"}

package/dist/three-d/index.js

@@ -0,0 +1,7 @@
+export { Engine3D } from './Engine3D.js';
+export { gridPoint3D } from './Grid.js';
+export { createTileGrid3D } from './TileGrid3D.js';
+export { Character3D } from './Character3D.js';
+export { parseVox, createVoxModel3D } from './Vox.js';
+export { createHeightmapTerrain3D } from './Heightmap.js';
+//# sourceMappingURL=index.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/three-d/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAC;AAEzC,OAAO,EAAE,WAAW,EAAE,MAAM,WAAW,CAAC;AAExC,OAAO,EAAE,gBAAgB,EAAE,MAAM,iBAAiB,CAAC;AAEnD,OAAO,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAC;AAE/C,OAAO,EAAE,QAAQ,EAAE,gBAAgB,EAAE,MAAM,UAAU,CAAC;AAEtD,OAAO,EAAE,wBAAwB,EAAE,MAAM,gBAAgB,CAAC"}

package/dist/ui/Bar.d.ts

@@ -0,0 +1,49 @@
+import { Container, type Texture } from 'pixi.js';
+export interface BarOptions {
+    width: number;
+    height: number;
+    /** the filled colour; defaults to the theme's highlight colour. Tints `fillTexture` too, when both are given */
+    color?: number;
+    /** starting value, read the same way `setValue` is; defaults to full */
+    value?: number;
+    max?: number;
+    /** the fill's own art, stretched to the filled width; a plain colour rect (the default) when omitted */
+    fillTexture?: Texture;
+    /** the track's own art; a plain colour rect (the theme's panel fill) when omitted */
+    backgroundTexture?: Texture;
+    /**
+     * Rounds the filled width up to the next whole pixel instead of a fractional one, so a
+     * sliver of value (1 hp of 300, say) never rounds down to nothing. Off by default, since
+     * it very slightly overstates the fraction at low values - a game where that sliver
+     * matters more than the precision opts in.
+     */
+    roundUpToPixel?: boolean;
+}
+/**
+ * A filled proportion of a track - a health, mana or experience bar.
+ *
+ * Closer to a small, focused primitive than a general-purpose progress-bar widget: it draws
+ * a background track and a foreground fill sized to `value / max`, and nothing else. Colour
+ * follows the theme the way `Label` does, unless a game gives one of its own.
+ */
+export declare class Bar extends Container {
+    private track;
+    private fill;
+    private width_;
+    private height_;
+    private readonly explicitColor;
+    private color;
+    private fraction;
+    private readonly fillTexture?;
+    private readonly backgroundTexture?;
+    private readonly roundUpToPixel;
+    private readonly themeListener;
+    constructor(options: BarOptions);
+    /** the current fill, 0 to 1 */
+    get value(): number;
+    setValue(value: number, max?: number): void;
+    resize(width: number, height: number): void;
+    private draw;
+    destroy(options?: Parameters<Container['destroy']>[0]): void;
+}
+//# sourceMappingURL=Bar.d.ts.map

package/dist/ui/Bar.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Bar.d.ts","sourceRoot":"","sources":["../../src/ui/Bar.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAY,KAAK,OAAO,EAAE,MAAM,SAAS,CAAC;AAG5D,MAAM,WAAW,UAAU;IAC1B,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;IAEf,gHAAgH;IAChH,KAAK,CAAC,EAAE,MAAM,CAAC;IAEf,wEAAwE;IACxE,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,GAAG,CAAC,EAAE,MAAM,CAAC;IAEb,wGAAwG;IACxG,WAAW,CAAC,EAAE,OAAO,CAAC;IAEtB,qFAAqF;IACrF,iBAAiB,CAAC,EAAE,OAAO,CAAC;IAE5B;;;;;OAKG;IACH,cAAc,CAAC,EAAE,OAAO,CAAC;CACzB;AAED;;;;;;GAMG;AACH,qBAAa,GAAI,SAAQ,SAAS;IACjC,OAAO,CAAC,KAAK,CAAkB;IAC/B,OAAO,CAAC,IAAI,CAAkB;IAE9B,OAAO,CAAC,MAAM,CAAS;IACvB,OAAO,CAAC,OAAO,CAAS;IACxB,OAAO,CAAC,QAAQ,CAAC,aAAa,CAAU;IACxC,OAAO,CAAC,KAAK,CAAS;IACtB,OAAO,CAAC,QAAQ,CAAS;IACzB,OAAO,CAAC,QAAQ,CAAC,WAAW,CAAC,CAAU;IACvC,OAAO,CAAC,QAAQ,CAAC,iBAAiB,CAAC,CAAU;IAC7C,OAAO,CAAC,QAAQ,CAAC,cAAc,CAAU;IAEzC,OAAO,CAAC,QAAQ,CAAC,aAAa,CAAqB;IAEnD,YAAY,OAAO,EAAE,UAAU,EAiB9B;IAED,+BAA+B;IAC/B,IAAI,KAAK,IAAI,MAAM,CAElB;IAED,QAAQ,CAAC,KAAK,EAAE,MAAM,EAAE,GAAG,SAAI,GAAG,IAAI,CAGrC;IAED,MAAM,CAAC,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,IAAI,CAI1C;IAED,OAAO,CAAC,IAAI;IAwBH,OAAO,CAAC,OAAO,CAAC,EAAE,UAAU,CAAC,SAAS,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC,CAAC,GAAG,IAAI,CAGpE;CACD"}

package/dist/ui/Bar.js

@@ -0,0 +1,70 @@
+import { Container, Graphics } from 'pixi.js';
+import { theme, themeChanged } from './theme.js';
+/**
+ * A filled proportion of a track - a health, mana or experience bar.
+ *
+ * Closer to a small, focused primitive than a general-purpose progress-bar widget: it draws
+ * a background track and a foreground fill sized to `value / max`, and nothing else. Colour
+ * follows the theme the way `Label` does, unless a game gives one of its own.
+ */
+export class Bar extends Container {
+    constructor(options) {
+        super();
+        this.track = new Graphics();
+        this.fill = new Graphics();
+        this.themeListener = () => this.draw();
+        this.width_ = options.width;
+        this.height_ = options.height;
+        this.explicitColor = options.color !== undefined;
+        this.color = options.color ?? theme().color.textHighlight;
+        this.fraction = clamp((options.value ?? 1) / (options.max ?? 1));
+        this.fillTexture = options.fillTexture;
+        this.backgroundTexture = options.backgroundTexture;
+        this.roundUpToPixel = options.roundUpToPixel ?? false;
+        this.addChild(this.track);
+        this.addChild(this.fill);
+        this.draw();
+        themeChanged.add(this.themeListener);
+    }
+    /** the current fill, 0 to 1 */
+    get value() {
+        return this.fraction;
+    }
+    setValue(value, max = 1) {
+        this.fraction = clamp(max > 0 ? value / max : 0);
+        this.draw();
+    }
+    resize(width, height) {
+        this.width_ = width;
+        this.height_ = height;
+        this.draw();
+    }
+    draw() {
+        const t = theme();
+        if (!this.explicitColor)
+            this.color = t.color.textHighlight;
+        this.track.clear().rect(0, 0, this.width_, this.height_);
+        this.track.fill(this.backgroundTexture ? { texture: this.backgroundTexture } : { color: t.color.panelFill });
+        this.fill.clear();
+        if (this.fraction > 0) {
+            const rawWidth = this.width_ * this.fraction;
+            const width = this.roundUpToPixel ? Math.ceil(rawWidth) : rawWidth;
+            this.fill.rect(0, 0, width, this.height_);
+            //an explicit colour tints art the same way it recolours a flat fill; an
+            //untinted texture is left to its own colours when none was given
+            this.fill.fill(this.fillTexture
+                ? this.explicitColor
+                    ? { texture: this.fillTexture, color: this.color }
+                    : { texture: this.fillTexture }
+                : { color: this.color });
+        }
+    }
+    destroy(options) {
+        themeChanged.remove(this.themeListener);
+        super.destroy(options);
+    }
+}
+function clamp(fraction) {
+    return Math.max(0, Math.min(1, fraction));
+}
+//# sourceMappingURL=Bar.js.map

package/dist/ui/Bar.js.map

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

package/dist/ui/BitmapLabel.d.ts

@@ -0,0 +1,42 @@
+import { BitmapText } from 'pixi.js';
+import type { TextStyleOptions } from 'pixi.js';
+import { type Theme } from './theme.ts';
+export interface BitmapLabelOptions {
+    text?: string;
+    color?: number;
+    size?: number;
+    /** wraps at this width in pixels; omit for a single unwrapped line */
+    wrapWidth?: number;
+    align?: 'left' | 'center' | 'right';
+    bold?: boolean;
+}
+/**
+ * A piece of text baked into a glyph-atlas texture instead of rasterised fresh on every
+ * change, the way `Label` (a thin wrapper over Pixi's `Text`) does. `Label`'s own doc
+ * comment already names the cost this exists to avoid: "wasteful for something updated
+ * every frame". A live HUD counter, a scrolling log, or a fixed pixel font a pixel-art game
+ * wants for all its UI copy are what this is for; a game whose text rarely changes has no
+ * reason to prefer it over `Label`.
+ *
+ * Pixi generates and caches the underlying bitmap font itself the first time a given
+ * family/size/colour/weight combination is used (see `BitmapText`'s "Dynamic Bitmap Fonts"
+ * behaviour) - nothing here downloads or ships a font file, keeping this the same
+ * generated-not-borrowed shape as every other asset in this project.
+ */
+export declare class BitmapLabel extends BitmapText {
+    private readonly opts;
+    private readonly themeListener;
+    constructor(options?: BitmapLabelOptions | string);
+    /** avoids the atlas relookup when the text has not actually changed */
+    setText(value: string): void;
+    /**
+     * Reapplies whichever style fields were never given an explicit option, so an explicit
+     * `color`/`size` a game passed in survives a theme change untouched while anything left
+     * to the theme's own defaults picks up the new one - the same rule `Label.restyle` follows.
+     */
+    private restyle;
+    destroy(options?: Parameters<BitmapText['destroy']>[0]): void;
+}
+/** the pure style-mapping `BitmapLabel` builds its underlying `BitmapText` style from, exported for testing without constructing a `BitmapText` (which needs a real DOM `document`, unlike `Text`) */
+export declare function bitmapLabelStyle(opts: BitmapLabelOptions, t: Theme): TextStyleOptions;
+//# sourceMappingURL=BitmapLabel.d.ts.map

package/dist/ui/BitmapLabel.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"BitmapLabel.d.ts","sourceRoot":"","sources":["../../src/ui/BitmapLabel.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,SAAS,CAAC;AACrC,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,SAAS,CAAC;AAChD,OAAO,EAAuB,KAAK,KAAK,EAAE,MAAM,YAAY,CAAC;AAE7D,MAAM,WAAW,kBAAkB;IAClC,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,sEAAsE;IACtE,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,KAAK,CAAC,EAAE,MAAM,GAAG,QAAQ,GAAG,OAAO,CAAC;IACpC,IAAI,CAAC,EAAE,OAAO,CAAC;CACf;AAED;;;;;;;;;;;;GAYG;AACH,qBAAa,WAAY,SAAQ,UAAU;IAC1C,OAAO,CAAC,QAAQ,CAAC,IAAI,CAAqB;IAC1C,OAAO,CAAC,QAAQ,CAAC,aAAa,CAAiC;IAE/D,YAAY,OAAO,GAAE,kBAAkB,GAAG,MAAW,EAWpD;IAED,uEAAuE;IACvE,OAAO,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI,CAE3B;IAED;;;;OAIG;IACH,OAAO,CAAC,OAAO;IAIN,OAAO,CAAC,OAAO,CAAC,EAAE,UAAU,CAAC,UAAU,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC,CAAC,GAAG,IAAI,CAGrE;CACD;AAED,sMAAsM;AACtM,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,kBAAkB,EAAE,CAAC,EAAE,KAAK,GAAG,gBAAgB,CAWrF"}

package/dist/ui/BitmapLabel.js

@@ -0,0 +1,59 @@
+import { BitmapText } from 'pixi.js';
+import { theme, themeChanged } from './theme.js';
+/**
+ * A piece of text baked into a glyph-atlas texture instead of rasterised fresh on every
+ * change, the way `Label` (a thin wrapper over Pixi's `Text`) does. `Label`'s own doc
+ * comment already names the cost this exists to avoid: "wasteful for something updated
+ * every frame". A live HUD counter, a scrolling log, or a fixed pixel font a pixel-art game
+ * wants for all its UI copy are what this is for; a game whose text rarely changes has no
+ * reason to prefer it over `Label`.
+ *
+ * Pixi generates and caches the underlying bitmap font itself the first time a given
+ * family/size/colour/weight combination is used (see `BitmapText`'s "Dynamic Bitmap Fonts"
+ * behaviour) - nothing here downloads or ships a font file, keeping this the same
+ * generated-not-borrowed shape as every other asset in this project.
+ */
+export class BitmapLabel extends BitmapText {
+    constructor(options = {}) {
+        const opts = typeof options === 'string' ? { text: options } : options;
+        const t = theme();
+        super({
+            text: opts.text ?? '',
+            style: bitmapLabelStyle(opts, t),
+        });
+        this.themeListener = (t) => this.restyle(t);
+        this.opts = opts;
+        themeChanged.add(this.themeListener);
+    }
+    /** avoids the atlas relookup when the text has not actually changed */
+    setText(value) {
+        if (this.text !== value)
+            this.text = value;
+    }
+    /**
+     * Reapplies whichever style fields were never given an explicit option, so an explicit
+     * `color`/`size` a game passed in survives a theme change untouched while anything left
+     * to the theme's own defaults picks up the new one - the same rule `Label.restyle` follows.
+     */
+    restyle(t) {
+        this.style = bitmapLabelStyle(this.opts, t);
+    }
+    destroy(options) {
+        themeChanged.remove(this.themeListener);
+        super.destroy(options);
+    }
+}
+/** the pure style-mapping `BitmapLabel` builds its underlying `BitmapText` style from, exported for testing without constructing a `BitmapText` (which needs a real DOM `document`, unlike `Text`) */
+export function bitmapLabelStyle(opts, t) {
+    return {
+        fontFamily: t.font.family,
+        fontSize: opts.size ?? t.font.size,
+        fontWeight: opts.bold ? 'bold' : 'normal',
+        fill: opts.color ?? t.color.text,
+        align: opts.align ?? (t.direction === 'rtl' ? 'right' : 'left'),
+        wordWrap: opts.wrapWidth !== undefined,
+        wordWrapWidth: opts.wrapWidth ?? 0,
+        breakWords: true,
+    };
+}
+//# sourceMappingURL=BitmapLabel.js.map

package/dist/ui/BitmapLabel.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"BitmapLabel.js","sourceRoot":"","sources":["../../src/ui/BitmapLabel.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,SAAS,CAAC;AAErC,OAAO,EAAE,KAAK,EAAE,YAAY,EAAc,MAAM,YAAY,CAAC;AAY7D;;;;;;;;;;;;GAYG;AACH,MAAM,OAAO,WAAY,SAAQ,UAAU;IAI1C,YAAY,OAAO,GAAgC,EAAE;QACpD,MAAM,IAAI,GAAG,OAAO,OAAO,KAAK,QAAQ,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE,OAAO,EAAE,CAAC,CAAC,CAAC,OAAO,CAAC;QACvE,MAAM,CAAC,GAAG,KAAK,EAAE,CAAC;QAElB,KAAK,CAAC;YACL,IAAI,EAAE,IAAI,CAAC,IAAI,IAAI,EAAE;YACrB,KAAK,EAAE,gBAAgB,CAAC,IAAI,EAAE,CAAC,CAAC;SAChC,CAAC,CAAC;QATa,kBAAa,GAAG,CAAC,CAAQ,EAAE,EAAE,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC;QAW9D,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC;QACjB,YAAY,CAAC,GAAG,CAAC,IAAI,CAAC,aAAa,CAAC,CAAC;IACtC,CAAC;IAED,uEAAuE;IACvE,OAAO,CAAC,KAAa;QACpB,IAAI,IAAI,CAAC,IAAI,KAAK,KAAK;YAAE,IAAI,CAAC,IAAI,GAAG,KAAK,CAAC;IAC5C,CAAC;IAED;;;;OAIG;IACK,OAAO,CAAC,CAAQ;QACvB,IAAI,CAAC,KAAK,GAAG,gBAAgB,CAAC,IAAI,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC;IAC7C,CAAC;IAEQ,OAAO,CAAC,OAA8C;QAC9D,YAAY,CAAC,MAAM,CAAC,IAAI,CAAC,aAAa,CAAC,CAAC;QACxC,KAAK,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC;IACxB,CAAC;CACD;AAED,sMAAsM;AACtM,MAAM,UAAU,gBAAgB,CAAC,IAAwB,EAAE,CAAQ;IAClE,OAAO;QACN,UAAU,EAAE,CAAC,CAAC,IAAI,CAAC,MAAM;QACzB,QAAQ,EAAE,IAAI,CAAC,IAAI,IAAI,CAAC,CAAC,IAAI,CAAC,IAAI;QAClC,UAAU,EAAE,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,QAAQ;QACzC,IAAI,EAAE,IAAI,CAAC,KAAK,IAAI,CAAC,CAAC,KAAK,CAAC,IAAI;QAChC,KAAK,EAAE,IAAI,CAAC,KAAK,IAAI,CAAC,CAAC,CAAC,SAAS,KAAK,KAAK,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC;QAC/D,QAAQ,EAAE,IAAI,CAAC,SAAS,KAAK,SAAS;QACtC,aAAa,EAAE,IAAI,CAAC,SAAS,IAAI,CAAC;QAClC,UAAU,EAAE,IAAI;KAChB,CAAC;AACH,CAAC"}

package/dist/ui/Button.d.ts

@@ -0,0 +1,52 @@
+import { Container } from 'pixi.js';
+import { Signal } from '../core/Signal.ts';
+export interface ButtonOptions {
+    width: number;
+    height: number;
+    /** the button's caption; omit for an icon-only button, the shape a title screen's
+     * rankings/badges/settings buttons usually take */
+    text?: string;
+    /** drawn to one side of the text, or centred alone if `text` is omitted */
+    icon?: Container;
+    disabled?: boolean;
+    onClick?: () => void;
+}
+/**
+ * A clickable region with idle/hover/pressed/disabled states, a label, an icon, or both.
+ *
+ * Draws over the same `NinePatch`/theme machinery `Window` already draws its chrome from -
+ * a panel texture if the theme has one, a flat rounded rectangle otherwise - so a button
+ * looks like it belongs to the same interface without a game supplying separate art for it.
+ *
+ * `icon` alone (no `text`) is the icon-only button a title screen commonly reaches for -
+ * rankings, badges, settings - where a caption would only repeat what the icon already says.
+ */
+export declare class Button extends Container {
+    readonly onClick: Signal<void>;
+    private background;
+    private labelText;
+    private icon;
+    private width_;
+    private height_;
+    private state;
+    private disabled_;
+    private readonly themeListener;
+    constructor(options: ButtonOptions);
+    /** live-resize the button, for a caller whose own layout reflows on window resize rather
+     * than rebuilding buttons from scratch (`Window`'s own constructor-only sizing is fine
+     * for a fixed dialog; a title screen's responsive row of buttons is not) */
+    resize(width: number, height: number): void;
+    setText(text: string | undefined): void;
+    get disabled(): boolean;
+    setDisabled(disabled: boolean): void;
+    private setState;
+    /**
+     * Icon-only centres the icon; icon-plus-text sits the icon to the reading-start side
+     * (left in ltr, right in rtl) with the label following it, both vertically centred -
+     * the same icon-then-text arrangement `ListView`'s own rows already use.
+     */
+    private layoutContent;
+    private draw;
+    destroy(options?: Parameters<Container['destroy']>[0]): void;
+}
+//# sourceMappingURL=Button.d.ts.map

package/dist/ui/Button.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Button.d.ts","sourceRoot":"","sources":["../../src/ui/Button.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAY,MAAM,SAAS,CAAC;AAC9C,OAAO,EAAE,MAAM,EAAE,MAAM,mBAAmB,CAAC;AAK3C,MAAM,WAAW,aAAa;IAC7B,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;IAEf;uDACmD;IACnD,IAAI,CAAC,EAAE,MAAM,CAAC;IAEd,2EAA2E;IAC3E,IAAI,CAAC,EAAE,SAAS,CAAC;IAEjB,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,OAAO,CAAC,EAAE,MAAM,IAAI,CAAC;CACrB;AAID;;;;;;;;;GASG;AACH,qBAAa,MAAO,SAAQ,SAAS;IACpC,QAAQ,CAAC,OAAO,eAAsB;IAEtC,OAAO,CAAC,UAAU,CAAuB;IACzC,OAAO,CAAC,SAAS,CAAe;IAChC,OAAO,CAAC,IAAI,CAAmB;IAE/B,OAAO,CAAC,MAAM,CAAS;IACvB,OAAO,CAAC,OAAO,CAAS;IACxB,OAAO,CAAC,KAAK,CAAuB;IACpC,OAAO,CAAC,SAAS,CAAU;IAE3B,OAAO,CAAC,QAAQ,CAAC,aAAa,CAAqB;IAEnD,YAAY,OAAO,EAAE,aAAa,EAgCjC;IAED;;gFAE4E;IAC5E,MAAM,CAAC,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,IAAI,CAI1C;IAED,OAAO,CAAC,IAAI,EAAE,MAAM,GAAG,SAAS,GAAG,IAAI,CAWtC;IAED,IAAI,QAAQ,IAAI,OAAO,CAEtB;IAED,WAAW,CAAC,QAAQ,EAAE,OAAO,GAAG,IAAI,CAGnC;IAED,OAAO,CAAC,QAAQ;IAQhB;;;;OAIG;IACH,OAAO,CAAC,aAAa;IA4BrB,OAAO,CAAC,IAAI;IA+BH,OAAO,CAAC,OAAO,CAAC,EAAE,UAAU,CAAC,SAAS,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC,CAAC,GAAG,IAAI,CAGpE;CACD"}