@directivegames/genesys.js 3.1.24

package/dist/src/components/visual/index.js

@@ -0,0 +1,24 @@
+/**
+ * Visual components aggregate export.
+ *
+ * This module re-exports components responsible for rendering and animation in
+ * the Genesys engine. Including this barrel allows external modules and AI
+ * scripts to easily access billboard, mesh, camera, and particle systems from a
+ * single import location. Keeping these exports together makes engine
+ * extensibility more straightforward.
+ */
+export * from './BillboardComponent.js';
+export * from './BaseInstancedMeshComponent.js';
+export * from './EditorOnlyMeshComponent.js';
+export * from './GLTFMeshComponent.js';
+export * from './AnimationComponent.js';
+export * from './AnimationStateMachineComponent.js';
+export * from './InstancedGltfMeshComponent.js';
+export * from './InstancedMeshComponent.js';
+export * from './MeshComponent.js';
+export * from './ParticleEmitterComponent.js';
+export * from './TerrainMeshComponent.js';
+export * from './SkyboxComponent.js';
+export * from './FogComponent.js';
+export * from './UI3DComponent.js';
+//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoiaW5kZXguanMiLCJzb3VyY2VSb290IjoiIiwic291cmNlcyI6WyIuLi8uLi8uLi8uLi9zcmMvY29tcG9uZW50cy92aXN1YWwvaW5kZXgudHMiXSwibmFtZXMiOltdLCJtYXBwaW5ncyI6IkFBQUE7Ozs7Ozs7O0dBUUc7QUFDSCxjQUFjLHlCQUF5QixDQUFDO0FBQ3hDLGNBQWMsaUNBQWlDLENBQUM7QUFDaEQsY0FBYyw4QkFBOEIsQ0FBQztBQUM3QyxjQUFjLHdCQUF3QixDQUFDO0FBQ3ZDLGNBQWMseUJBQXlCLENBQUM7QUFDeEMsY0FBYyxxQ0FBcUMsQ0FBQztBQUNwRCxjQUFjLGlDQUFpQyxDQUFDO0FBQ2hELGNBQWMsNkJBQTZCLENBQUM7QUFDNUMsY0FBYyxvQkFBb0IsQ0FBQztBQUNuQyxjQUFjLCtCQUErQixDQUFDO0FBQzlDLGNBQWMsMkJBQTJCLENBQUM7QUFDMUMsY0FBYyxzQkFBc0IsQ0FBQztBQUNyQyxjQUFjLG1CQUFtQixDQUFDO0FBQ2xDLGNBQWMsb0JBQW9CLENBQUMifQ==

package/dist/src/components/voxel/MagicaVoxelLoader.d.ts

@@ -0,0 +1,18 @@
+import * as THREE from 'three';
+import { VoxelMeshComponent } from './VoxelMeshComponent.js';
+/** Orientation mapping from .vox (X,Y,Z) to VoxelMesh (X,Y,Z).
+ *  By default we keep X the same, treat Magica Y (up) as Z (depth) and Z as Y (up) so
+ *  the model stands upright in Three.js’s Y‑up world. Flip to (x,y,z)=>[x,y,z] if you
+ *  prefer original orientation. */
+export type OrientationFn = (x: number, y: number, z: number) => [number, number, number];
+export interface MagicaVoxelLoaderOptions {
+    voxelSize?: number;
+    orientation?: OrientationFn;
+    material?: THREE.Material;
+}
+export declare class MagicaVoxelLoader {
+    /**
+     * Fetches and parses a *.vox* file, returns a VoxelMesh ready to add to the scene.
+     */
+    load(url: string, opts?: MagicaVoxelLoaderOptions): Promise<VoxelMeshComponent>;
+}

package/dist/src/components/voxel/MagicaVoxelLoader.js

@@ -0,0 +1,151 @@
+// MagicaVoxelLoader.ts
+// -----------------------------------------------------------------------------
+// Lightweight, dependency‑free loader for Ephtracy’s MagicaVoxel *.vox* format.
+// Produces a ready‑to‑render VoxelMesh (see VoxelMesh.ts in the same folder).
+// -----------------------------------------------------------------------------
+import * as THREE from 'three';
+import { resolvePath } from '../../storage/projectContext.js';
+import { AssetPath } from '../../storage/storageProvider.js';
+import { VoxelMeshComponent } from './VoxelMeshComponent.js';
+export class MagicaVoxelLoader {
+    /**
+     * Fetches and parses a *.vox* file, returns a VoxelMesh ready to add to the scene.
+     */
+    async load(url, opts = {}) {
+        const path = await resolvePath(AssetPath.fromString(url));
+        const { voxelSize = 1, orientation = defaultOrientation } = opts;
+        const buf = await fetch(path.getResolvedPath()).then(r => {
+            if (!r.ok)
+                throw new Error(`Failed to fetch ${url}: ${r.statusText}`);
+            return r.arrayBuffer();
+        });
+        const parseBeginTime = performance.now();
+        const { size, voxels, palette } = parseVOX(buf);
+        const parseDurationSeconds = (performance.now() - parseBeginTime) / 1000;
+        console.log(`${url} (${size.x}x${size.y}x${size.z}) parsed in ${parseDurationSeconds} seconds`);
+        const [sizeX, sizeY, sizeZ] = orientation(size.x, size.y, size.z);
+        const paletteMap = {};
+        palette.forEach((c, i) => (paletteMap[i + 1] = c)); // Magica indices start at 1
+        const voxelMeshComponent = new VoxelMeshComponent({});
+        voxelMeshComponent.initializeVoxel(sizeX, sizeY, sizeZ, voxelSize, paletteMap);
+        for (const v of voxels) {
+            const [vx, vy, vz] = orientation(v.x, v.y, v.z);
+            voxelMeshComponent.setVoxel(vx, vy, vz, v.color);
+        }
+        const buildBeginTime = performance.now();
+        voxelMeshComponent.buildMesh(opts.material);
+        const buildDurationSeconds = (performance.now() - buildBeginTime) / 1000;
+        console.log(`${url} (${sizeX}x${sizeY}x${sizeZ}) built in ${buildDurationSeconds} seconds`);
+        return voxelMeshComponent;
+    }
+}
+function parseVOX(buffer) {
+    const dv = new DataView(buffer);
+    const text = (o) => String.fromCharCode(dv.getUint8(o), dv.getUint8(o + 1), dv.getUint8(o + 2), dv.getUint8(o + 3));
+    // Header ----------------------------------------------------------
+    if (text(0) !== 'VOX ')
+        throw new Error('Not a VOX file');
+    const version = dv.getUint32(4, true);
+    if (version !== 150)
+        console.warn(`VOX version ${version} (expected 150)`);
+    let ptr = 8;
+    const readChunk = () => {
+        const id = text(ptr);
+        ptr += 4;
+        const size = dv.getUint32(ptr, true);
+        ptr += 4;
+        const childrenSize = dv.getUint32(ptr, true);
+        ptr += 4;
+        const chunkStart = ptr;
+        ptr += size; // skip to children
+        return { id, size, chunkStart, childrenEnd: chunkStart + size + childrenSize };
+    };
+    const state = {
+        size: { x: 0, y: 0, z: 0 },
+        voxels: [],
+        palette: defaultPalette.map(c => new THREE.Color(c)),
+    };
+    const main = readChunk();
+    if (main.id !== 'MAIN')
+        throw new Error('Invalid VOX: no MAIN chunk');
+    const stop = main.childrenEnd;
+    while (ptr < stop) {
+        const { id, size, chunkStart } = readChunk();
+        switch (id) {
+            case 'SIZE': {
+                state.size.x = dv.getInt32(chunkStart, true);
+                state.size.y = dv.getInt32(chunkStart + 4, true);
+                state.size.z = dv.getInt32(chunkStart + 8, true);
+                break;
+            }
+            case 'XYZI': {
+                const n = dv.getUint32(chunkStart, true);
+                let off = chunkStart + 4;
+                for (let i = 0; i < n; i++) {
+                    const x = dv.getUint8(off++);
+                    const y = dv.getUint8(off++);
+                    const z = dv.getUint8(off++);
+                    const color = dv.getUint8(off++); // 1‑255
+                    state.voxels.push({ x, y, z, color });
+                }
+                break;
+            }
+            case 'RGBA': {
+                let off = chunkStart;
+                for (let i = 0; i < 256; i++) {
+                    const r = dv.getUint8(off++);
+                    const g = dv.getUint8(off++);
+                    const b = dv.getUint8(off++);
+                    const a = dv.getUint8(off++); // unused (Magica stores 0 or 255)
+                    state.palette[i] = new THREE.Color(r / 255, g / 255, b / 255);
+                }
+                break;
+            }
+            // ignore MATL, nTRN, etc. – static meshes only
+        }
+    }
+    return state;
+}
+// -----------------------------------------------------------------------------
+// Helpers & defaults
+// -----------------------------------------------------------------------------
+const defaultOrientation = (x, y, z) => [x, z, y];
+// Original MagicaVoxel default palette (hex, length 256)
+// prettier‑ignore
+const defaultPalette = [
+    0x00000000, 0xffffffff, 0xffccffff, 0xff99ffff, 0xff66ffff, 0xff33ffff, 0xff00ffff, 0xffffccff,
+    0xffccccff, 0xff99ccff, 0xff66ccff, 0xff33ccff, 0xff00ccff, 0xffff99ff, 0xffcc99ff, 0xff9999ff,
+    0xff6699ff, 0xff3399ff, 0xff0099ff, 0xffff66ff, 0xffcc66ff, 0xff9966ff, 0xff6666ff, 0xff3366ff,
+    0xff0066ff, 0xffff33ff, 0xffcc33ff, 0xff9933ff, 0xff6633ff, 0xff3333ff, 0xff0033ff, 0xffff00ff,
+    0xffcc00ff, 0xff9900ff, 0xff6600ff, 0xff3300ff, 0xff0000ff, 0xffffffcc, 0xffccffcc, 0xff99ffcc,
+    0xff66ffcc, 0xff33ffcc, 0xff00ffcc, 0xffffcccc, 0xffcccccc, 0xff99cccc, 0xff66cccc, 0xff33cccc,
+    0xff00cccc, 0xffff99cc, 0xffcc99cc, 0xff9999cc, 0xff6699cc, 0xff3399cc, 0xff0099cc, 0xffff66cc,
+    0xffcc66cc, 0xff9966cc, 0xff6666cc, 0xff3366cc, 0xff0066cc, 0xffff33cc, 0xffcc33cc, 0xff9933cc,
+    0xff6633cc, 0xff3333cc, 0xff0033cc, 0xffff00cc, 0xffcc00cc, 0xff9900cc, 0xff6600cc, 0xff3300cc,
+    0xff0000cc, 0xffffff99, 0xffccff99, 0xff99ff99, 0xff66ff99, 0xff33ff99, 0xff00ff99, 0xffffcc99,
+    0xffcccc99, 0xff99cc99, 0xff66cc99, 0xff33cc99, 0xff00cc99, 0xffff9999, 0xffcc9999, 0xff999999,
+    0xff669999, 0xff339999, 0xff009999, 0xffff6699, 0xffcc6699, 0xff996699, 0xff666699, 0xff336699,
+    0xff006699, 0xffff3399, 0xffcc3399, 0xff993399, 0xff663399, 0xff333399, 0xff003399, 0xffff0099,
+    0xffcc0099, 0xff990099, 0xff660099, 0xff330099, 0xff000099, 0xffffff66, 0xffccff66, 0xff99ff66,
+    0xff66ff66, 0xff33ff66, 0xff00ff66, 0xffffcc66, 0xffcccc66, 0xff99cc66, 0xff66cc66, 0xff33cc66,
+    0xff00cc66, 0xffff9966, 0xffcc9966, 0xff999966, 0xff669966, 0xff339966, 0xff009966, 0xffff6666,
+    0xffcc6666, 0xff996666, 0xff666666, 0xff336666, 0xff006666, 0xffff3366, 0xffcc3366, 0xff993366,
+    0xff663366, 0xff333366, 0xff003366, 0xffff0066, 0xffcc0066, 0xff990066, 0xff660066, 0xff330066,
+    0xff000066, 0xffffff33, 0xffccff33, 0xff99ff33, 0xff66ff33, 0xff33ff33, 0xff00ff33, 0xffffcc33,
+    0xffcccc33, 0xff99cc33, 0xff66cc33, 0xff33cc33, 0xff00cc33, 0xffff9933, 0xffcc9933, 0xff999933,
+    0xff669933, 0xff339933, 0xff009933, 0xffff6633, 0xffcc6633, 0xff996633, 0xff666633, 0xff336633,
+    0xff006633, 0xffff3333, 0xffcc3333, 0xff993333, 0xff663333, 0xff333333, 0xff003333, 0xffff0033,
+    0xffcc0033, 0xff990033, 0xff660033, 0xff330033, 0xff000033, 0xffffff00, 0xffccff00, 0xff99ff00,
+    0xff66ff00, 0xff33ff00, 0xff00ff00, 0xffffcc00, 0xffcccc00, 0xff99cc00, 0xff66cc00, 0xff33cc00,
+    0xff00cc00, 0xffff9900, 0xffcc9900, 0xff999900, 0xff669900, 0xff339900, 0xff009900, 0xffff6600,
+    0xffcc6600, 0xff996600, 0xff666600, 0xff336600, 0xff006600, 0xffff3300, 0xffcc3300, 0xff993300,
+    0xff663300, 0xff333300, 0xff003300, 0xffff0000, 0xffcc0000, 0xff990000, 0xff660000, 0xff330000,
+    0xff0000ee, 0xff0000dd, 0xff0000bb, 0xff0000aa, 0xff000088, 0xff000077, 0xff000055, 0xff000044,
+    0xff000022, 0xff000011, 0xff110000, 0xff220000, 0xff440000, 0xff550000, 0xff770000, 0xff880000,
+    0xffaa0000, 0xffbb0000, 0xffdd0000, 0xffee0000, 0xffff0000, 0xffee1100, 0xffdd2200, 0xffbb4400,
+    0xffaa5500, 0xff885500, 0xff774400, 0xff553300, 0xff442200, 0xff221100, 0xff113300, 0xff225500,
+    0xff447700, 0xff559900, 0xff66aa00, 0xff77bb00, 0xff88cc00, 0xff99dd00, 0xffbbee00, 0xffccff00,
+    0xffddff00, 0xffeeff00, 0xffffff00, 0xff0000,
+];
+// -----------------------------------------------------------------------------
+//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoiTWFnaWNhVm94ZWxMb2FkZXIuanMiLCJzb3VyY2VSb290IjoiIiwic291cmNlcyI6WyIuLi8uLi8uLi8uLi9zcmMvY29tcG9uZW50cy92b3hlbC9NYWdpY2FWb3hlbExvYWRlci50cyJdLCJuYW1lcyI6W10sIm1hcHBpbmdzIjoiQUFBQSx1QkFBdUI7QUFDdkIsZ0ZBQWdGO0FBQ2hGLGdGQUFnRjtBQUNoRiw4RUFBOEU7QUFDOUUsZ0ZBQWdGO0FBQ2hGLE9BQU8sS0FBSyxLQUFLLE1BQU0sT0FBTyxDQUFDO0FBRS9CLE9BQU8sRUFBRSxXQUFXLEVBQUUsTUFBTSxpQ0FBaUMsQ0FBQztBQUM5RCxPQUFPLEVBQUUsU0FBUyxFQUFFLE1BQU0sa0NBQWtDLENBQUM7QUFFN0QsT0FBTyxFQUFFLGtCQUFrQixFQUFFLE1BQU0seUJBQXlCLENBQUM7QUFpQjdELE1BQU0sT0FBTyxpQkFBaUI7SUFDNUI7O09BRUc7SUFDSCxLQUFLLENBQUMsSUFBSSxDQUFDLEdBQVcsRUFBRSxPQUFpQyxFQUFFO1FBQ3pELE1BQU0sSUFBSSxHQUFHLE1BQU0sV0FBVyxDQUFDLFNBQVMsQ0FBQyxVQUFVLENBQUMsR0FBRyxDQUFDLENBQUMsQ0FBQztRQUMxRCxNQUFNLEVBQUUsU0FBUyxHQUFHLENBQUMsRUFBRSxXQUFXLEdBQUcsa0JBQWtCLEVBQUUsR0FBRyxJQUFJLENBQUM7UUFFakUsTUFBTSxHQUFHLEdBQUcsTUFBTSxLQUFLLENBQUMsSUFBSSxDQUFDLGVBQWUsRUFBRSxDQUFDLENBQUMsSUFBSSxDQUFDLENBQUMsQ0FBQyxFQUFFO1lBQ3ZELElBQUksQ0FBQyxDQUFDLENBQUMsRUFBRTtnQkFBRSxNQUFNLElBQUksS0FBSyxDQUFDLG1CQUFtQixHQUFHLEtBQUssQ0FBQyxDQUFDLFVBQVUsRUFBRSxDQUFDLENBQUM7WUFDdEUsT0FBTyxDQUFDLENBQUMsV0FBVyxFQUFFLENBQUM7UUFDekIsQ0FBQyxDQUFDLENBQUM7UUFFSCxNQUFNLGNBQWMsR0FBRyxXQUFXLENBQUMsR0FBRyxF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QUFFLENBQUMsRUFBRSxDQUFDLENBQUMsQ0FBQztBQUVqRSx5REFBeUQ7QUFDekQsa0JBQWtCO0FBQ2xCLE1BQU0sY0FBYyxHQUFhO0lBQy9CLFVBQVUsRUFBQyxVQUFVLEVBQUMsVUFBVSxFQUFDLFVBQVUsRUFBQyxVQUFVLEVBQUMsVUFBVSxFQUFDLFVBQVUsRUFBQyxVQUFVO0lBQ3ZGLFVBQVUsRUFBQyxVQUFVLEVBQUMsVUFBVSxFQUFDLFVBQVUsRUFBQyxVQUFVLEVBQUMsVUFBVSxFQUFDLFVBQVUsRUFBQyxVQUFVO0lBQ3ZGLFVBQVUsRUFBQyxVQUFVLEVBQUMsVUFBVSxFQUFDLFVBQVUsRUFBQyxVQUFVLEVBQUMsVUFBVSxFQUFDLFVBQVUsRUFBQyxVQUFVO0lBQ3ZGLFVBQVUsRUFBQyxVQUFVLEVBQUMsVUFBVSxFQUFDLFVBQVUsRUFBQyxVQUFVLEVBQUMsVUFBVSxFQUFDLFVBQVUsRUFBQyxVQUFVO0lBQ3ZGLFVBQVUsRUFBQyxVQUFVLEVBQUMsVUFBVSxFQUFDLFVBQVUsRUFBQyxVQUFVLEVBQUMsVUFBVSxFQUFDLFVBQVUsRUFBQyxVQUFVO0lBQ3ZGLFVBQVUsRUFBQyxVQUFVLEVBQUMsVUFBVSxFQUFDLFVBQVUsRUFBQyxVQUFVLEVBQUMsVUFBVSxFQUFDLFVBQVUsRUFBQyxVQUFVO0lBQ3ZGLFVBQVUsRUFBQyxVQUFVLEVBQUMsVUFBVSxFQUFDLFVBQVUsRUFBQyxVQUFVLEVBQUMsVUFBVSxFQUFDLFVBQVUsRUFBQyxVQUFVO0lBQ3ZGLFVBQVUsRUFBQyxVQUFVLEVBQUMsVUFBVSxFQUFDLFVBQVUsRUFBQyxVQUFVLEVBQUMsVUFBVSxFQUFDLFVBQVUsRUFBQyxVQUFVO0lBQ3ZGLFVBQVUsRUFBQyxVQUFVLEVBQUMsVUFBVSxFQUFDLFVBQVUsRUFBQyxVQUFVLEVBQUMsVUFBVSxFQUFDLFVBQVUsRUFBQyxVQUFVO0lBQ3ZGLFVBQVUsRUFBQyxVQUFVLEVBQUMsVUFBVSxFQUFDLFVBQVUsRUFBQyxVQUFVLEVBQUMsVUFBVSxFQUFDLFVBQVUsRUFBQyxVQUFVO0lBQ3ZGLFVBQVUsRUFBQyxVQUFVLEVBQUMsVUFBVSxFQUFDLFVBQVUsRUFBQyxVQUFVLEVBQUMsVUFBVSxFQUFDLFVBQVUsRUFBQyxVQUFVO0lBQ3ZGLFVBQVUsRUFBQyxVQUFVLEVBQUMsVUFBVSxFQUFDLFVBQVUsRUFBQyxVQUFVLEVBQUMsVUFBVSxFQUFDLFVBQVUsRUFBQyxVQUFVO0lBQ3ZGLFVBQVUsRUFBQyxVQUFVLEVBQUMsVUFBVSxFQUFDLFVBQVUsRUFBQyxVQUFVLEVBQUMsVUFBVSxFQUFDLFVBQVUsRUFBQyxVQUFVO0lBQ3ZGLFVBQVUsRUFBQyxVQUFVLEVBQUMsVUFBVSxFQUFDLFVBQVUsRUFBQyxVQUFVLEVBQUMsVUFBVSxFQUFDLFVBQVUsRUFBQyxVQUFVO0lBQ3ZGLFVBQVUsRUFBQyxVQUFVLEVBQUMsVUFBVSxFQUFDLFVBQVUsRUFBQyxVQUFVLEVBQUMsVUFBVSxFQUFDLFVBQVUsRUFBQyxVQUFVO0lBQ3ZGLFVBQVUsRUFBQyxVQUFVLEVBQUMsVUFBVSxFQUFDLFVBQVUsRUFBQyxVQUFVLEVBQUMsVUFBVSxFQUFDLFVBQVUsRUFBQyxVQUFVO0lBQ3ZGLFVBQVUsRUFBQyxVQUFVLEVBQUMsVUFBVSxFQUFDLFVBQVUsRUFBQyxVQUFVLEVBQUMsVUFBVSxFQUFDLFVBQVUsRUFBQyxVQUFVO0lBQ3ZGLFVBQVUsRUFBQyxVQUFVLEVBQUMsVUFBVSxFQUFDLFVBQVUsRUFBQyxVQUFVLEVBQUMsVUFBVSxFQUFDLFVBQVUsRUFBQyxVQUFVO0lBQ3ZGLFVBQVUsRUFBQyxVQUFVLEVBQUMsVUFBVSxFQUFDLFVBQVUsRUFBQyxVQUFVLEVBQUMsVUFBVSxFQUFDLFVBQVUsRUFBQyxVQUFVO0lBQ3ZGLFVBQVUsRUFBQyxVQUFVLEVBQUMsVUFBVSxFQUFDLFVBQVUsRUFBQyxVQUFVLEVBQUMsVUFBVSxFQUFDLFVBQVUsRUFBQyxVQUFVO0lBQ3ZGLFVBQVUsRUFBQyxVQUFVLEVBQUMsVUFBVSxFQUFDLFVBQVUsRUFBQyxVQUFVLEVBQUMsVUFBVSxFQUFDLFVBQVUsRUFBQyxVQUFVO0lBQ3ZGLFVBQVUsRUFBQyxVQUFVLEVBQUMsVUFBVSxFQUFDLFVBQVUsRUFBQyxVQUFVLEVBQUMsVUFBVSxFQUFDLFVBQVUsRUFBQyxVQUFVO0lBQ3ZGLFVBQVUsRUFBQyxVQUFVLEVBQUMsVUFBVSxFQUFDLFVBQVUsRUFBQyxVQUFVLEVBQUMsVUFBVSxFQUFDLFVBQVUsRUFBQyxVQUFVO0lBQ3ZGLFVBQVUsRUFBQyxVQUFVLEVBQUMsVUFBVSxFQUFDLFVBQVUsRUFBQyxVQUFVLEVBQUMsVUFBVSxFQUFDLFVBQVUsRUFBQyxVQUFVO0lBQ3ZGLFVBQVUsRUFBQyxVQUFVLEVBQUMsVUFBVSxFQUFDLFVBQVUsRUFBQyxVQUFVLEVBQUMsVUFBVSxFQUFDLFVBQVUsRUFBQyxVQUFVO0lBQ3ZGLFVBQVUsRUFBQyxVQUFVLEVBQUMsVUFBVSxFQUFDLFVBQVUsRUFBQyxVQUFVLEVBQUMsVUFBVSxFQUFDLFVBQVUsRUFBQyxVQUFVO0lBQ3ZGLFVBQVUsRUFBQyxVQUFVLEVBQUMsVUFBVSxFQUFDLFVBQVUsRUFBQyxVQUFVLEVBQUMsVUFBVSxFQUFDLFVBQVUsRUFBQyxVQUFVO0lBQ3ZGLFVBQVUsRUFBQyxVQUFVLEVBQUMsVUFBVSxFQUFDLFVBQVUsRUFBQyxVQUFVLEVBQUMsVUFBVSxFQUFDLFVBQVUsRUFBQyxVQUFVO0lBQ3ZGLFVBQVUsRUFBQyxVQUFVLEVBQUMsVUFBVSxFQUFDLFVBQVUsRUFBQyxVQUFVLEVBQUMsVUFBVSxFQUFDLFVBQVUsRUFBQyxVQUFVO0lBQ3ZGLFVBQVUsRUFBQyxVQUFVLEVBQUMsVUFBVSxFQUFDLFVBQVUsRUFBQyxVQUFVLEVBQUMsVUFBVSxFQUFDLFVBQVUsRUFBQyxVQUFVO0lBQ3ZGLFVBQVUsRUFBQyxVQUFVLEVBQUMsVUFBVSxFQUFDLFVBQVUsRUFBQyxVQUFVLEVBQUMsVUFBVSxFQUFDLFVBQVUsRUFBQyxVQUFVO0lBQ3ZGLFVBQVUsRUFBQyxVQUFVLEVBQUMsVUFBVSxFQUFDLFVBQVUsRUFBQyxVQUFVLEVBQUMsVUFBVSxFQUFDLFVBQVUsRUFBQyxVQUFVO0lBQ3ZGLFVBQVUsRUFBQyxVQUFVLEVBQUMsVUFBVSxFQUFDLFFBQVE7Q0FDMUMsQ0FBQztBQUNGLGdGQUFnRiJ9

package/dist/src/components/voxel/VoxelMeshComponent.d.ts

@@ -0,0 +1,66 @@
+import * as THREE from 'three';
+import { PrimitiveComponent } from '../PrimitiveComponent.js';
+import type { PrimitiveComponentOptions } from '../PrimitiveComponent.js';
+export type Palette = Record<number, THREE.ColorRepresentation>;
+export type VoxelState = {
+    sizeX: number;
+    sizeY: number;
+    sizeZ: number;
+    voxelSize: number;
+    voxels: Uint16Array;
+    palette: Palette;
+};
+/**
+ * A component that renders a voxel-based mesh.
+ * This component allows for creating, manipulating, and rendering 3D voxel structures
+ * using Three.js for visualization.
+ */
+export declare class VoxelMeshComponent extends PrimitiveComponent {
+    private state?;
+    private mesh;
+    static get DEFAULT_OPTIONS(): PrimitiveComponentOptions;
+    constructor(options?: PrimitiveComponentOptions);
+    /**
+     * Initializes the voxel structure with the specified dimensions and properties.
+     *
+     * @param sizeX - Width of the voxel grid in voxel units
+     * @param sizeY - Height of the voxel grid in voxel units
+     * @param sizeZ - Depth of the voxel grid in voxel units
+     * @param voxelSize - Size of each voxel in world units
+     * @param palette - Color palette mapping voxel IDs to colors
+     */
+    initializeVoxel(sizeX: number, sizeY: number, sizeZ: number, voxelSize: number, palette: Palette): void;
+    /**
+     * Gets the current voxel state.
+     *
+     * @returns The current voxel state, or undefined if the voxel state is not initialized
+     */
+    getVoxelState(): VoxelState | undefined;
+    /**
+     * Gets the voxel ID at the specified coordinates.
+     *
+     * @param x - X coordinate in the voxel grid
+     * @param y - Y coordinate in the voxel grid
+     * @param z - Z coordinate in the voxel grid
+     * @returns The voxel ID at the specified location, or 0 if the location is invalid
+     */
+    getVoxel(x: number, y: number, z: number): number;
+    /**
+     * Sets the voxel ID at the specified coordinates.
+     *
+     * @param x - X coordinate in the voxel grid
+     * @param y - Y coordinate in the voxel grid
+     * @param z - Z coordinate in the voxel grid
+     * @param id - The voxel ID to set
+     * @returns True if the voxel was set successfully, false if the location is invalid
+     */
+    setVoxel(x: number, y: number, z: number, id: number): boolean;
+    /**
+     * Builds the mesh representation of the current voxel state.
+     * Uses a greedy meshing algorithm to optimize the geometry.
+     *
+     * @param materialOverride - Optional material to use instead of the default
+     */
+    buildMesh(materialOverride?: THREE.Material): void;
+    getEditorClassIcon(): string | null;
+}

package/dist/src/components/voxel/VoxelMeshComponent.js

@@ -0,0 +1,246 @@
+var __decorate = (this && this.__decorate) || function (decorators, target, key, desc) {
+    var c = arguments.length, r = c < 3 ? target : desc === null ? desc = Object.getOwnPropertyDescriptor(target, key) : desc, d;
+    if (typeof Reflect === "object" && typeof Reflect.decorate === "function") r = Reflect.decorate(decorators, target, key, desc);
+    else for (var i = decorators.length - 1; i >= 0; i--) if (d = decorators[i]) r = (c < 3 ? d(r) : c > 3 ? d(target, key, r) : d(target, key)) || r;
+    return c > 3 && r && Object.defineProperty(target, key, r), r;
+};
+var __metadata = (this && this.__metadata) || function (k, v) {
+    if (typeof Reflect === "object" && typeof Reflect.metadata === "function") return Reflect.metadata(k, v);
+};
+import * as THREE from 'three';
+import { EngineClass } from '../../systems/ClassRegistry.js';
+import { PrimitiveComponent } from '../PrimitiveComponent.js';
+/**
+ * A component that renders a voxel-based mesh.
+ * This component allows for creating, manipulating, and rendering 3D voxel structures
+ * using Three.js for visualization.
+ */
+let VoxelMeshComponent = class VoxelMeshComponent extends PrimitiveComponent {
+    static get DEFAULT_OPTIONS() {
+        return {
+            ...super.DEFAULT_OPTIONS,
+        };
+    }
+    constructor(options = {}) {
+        super(options);
+        Object.defineProperty(this, "state", {
+            enumerable: true,
+            configurable: true,
+            writable: true,
+            value: void 0
+        });
+        Object.defineProperty(this, "mesh", {
+            enumerable: true,
+            configurable: true,
+            writable: true,
+            value: void 0
+        });
+        this.mesh = new THREE.Mesh(new THREE.BufferGeometry(), new THREE.MeshNormalMaterial());
+        this.add(this.mesh);
+    }
+    /**
+     * Initializes the voxel structure with the specified dimensions and properties.
+     *
+     * @param sizeX - Width of the voxel grid in voxel units
+     * @param sizeY - Height of the voxel grid in voxel units
+     * @param sizeZ - Depth of the voxel grid in voxel units
+     * @param voxelSize - Size of each voxel in world units
+     * @param palette - Color palette mapping voxel IDs to colors
+     */
+    initializeVoxel(sizeX, sizeY, sizeZ, voxelSize, palette) {
+        this.state = {
+            sizeX,
+            sizeY,
+            sizeZ,
+            voxelSize,
+            voxels: new Uint16Array(sizeX * sizeY * sizeZ),
+            palette,
+        };
+        this.mesh.geometry.dispose();
+    }
+    /**
+     * Gets the current voxel state.
+     *
+     * @returns The current voxel state, or undefined if the voxel state is not initialized
+     */
+    getVoxelState() {
+        return this.state;
+    }
+    /**
+     * Gets the voxel ID at the specified coordinates.
+     *
+     * @param x - X coordinate in the voxel grid
+     * @param y - Y coordinate in the voxel grid
+     * @param z - Z coordinate in the voxel grid
+     * @returns The voxel ID at the specified location, or 0 if the location is invalid
+     */
+    getVoxel(x, y, z) {
+        if (!isValidLocation(x, y, z, this.state)) {
+            return 0;
+        }
+        const index = getIndex(x, y, z, this.state, false);
+        return this.state.voxels[index];
+    }
+    /**
+     * Sets the voxel ID at the specified coordinates.
+     *
+     * @param x - X coordinate in the voxel grid
+     * @param y - Y coordinate in the voxel grid
+     * @param z - Z coordinate in the voxel grid
+     * @param id - The voxel ID to set
+     * @returns True if the voxel was set successfully, false if the location is invalid
+     */
+    setVoxel(x, y, z, id) {
+        if (!isValidLocation(x, y, z, this.state)) {
+            return false;
+        }
+        const index = getIndex(x, y, z, this.state, false);
+        this.state.voxels[index] = id;
+        return true;
+    }
+    /**
+     * Builds the mesh representation of the current voxel state.
+     * Uses a greedy meshing algorithm to optimize the geometry.
+     *
+     * @param materialOverride - Optional material to use instead of the default
+     */
+    buildMesh(materialOverride) {
+        if (!this.state) {
+            return;
+        }
+        const { geometry, material } = greedyMesh(this.state.voxels, this.state.sizeX, this.state.sizeY, this.state.sizeZ, this.state.voxelSize, this.state.palette, materialOverride ?? this.mesh.material);
+        this.mesh.geometry.dispose();
+        this.mesh.geometry = geometry;
+        this.mesh.material = material;
+    }
+    //====================================================================================================
+    // Editor Functions
+    //====================================================================================================
+    getEditorClassIcon() {
+        return 'Icon_VoxelMesh';
+    }
+};
+VoxelMeshComponent = __decorate([
+    EngineClass('VoxelMeshComponent'),
+    __metadata("design:paramtypes", [Object])
+], VoxelMeshComponent);
+export { VoxelMeshComponent };
+//====================================================================================================
+function isValidLocation(x, y, z, state) {
+    if (!state) {
+        return false;
+    }
+    return x >= 0 && y >= 0 && z >= 0 && x < state.sizeX && y < state.sizeY && z < state.sizeZ;
+}
+function getIndex(x, y, z, state, validateLocation = true) {
+    if (validateLocation && !isValidLocation(x, y, z, state)) {
+        return 0;
+    }
+    return x + state.sizeX * (y + state.sizeY * z);
+}
+function greedyMesh(voxels, sx, sy, sz, scale, palette, material) {
+    const pos = [];
+    const nrm = [];
+    const col = [];
+    const uv = [];
+    const idx = [];
+    let vert = 0;
+    const dims = [sx, sy, sz];
+    const coord = [0, 0, 0];
+    const q = [0, 0, 0];
+    for (let d = 0; d < 3; d++) {
+        const u = (d + 1) % 3;
+        const v = (d + 2) % 3;
+        q[0] = q[1] = q[2] = 0;
+        q[d] = 1;
+        const mask = new Int32Array(dims[u] * dims[v]);
+        for (coord[d] = -1; coord[d] < dims[d]; coord[d]++) {
+            // 1. build mask for current slice
+            let m = 0;
+            for (coord[v] = 0; coord[v] < dims[v]; coord[v]++) {
+                for (coord[u] = 0; coord[u] < dims[u]; coord[u]++, m++) {
+                    const a = sample(coord[0], coord[1], coord[2]);
+                    coord[d] += 1;
+                    const b = sample(coord[0], coord[1], coord[2]);
+                    coord[d] -= 1;
+                    mask[m] = a && b ? 0 : a ? a : -b;
+                }
+            }
+            // 2. generate quads
+            for (let j = 0; j < dims[v]; j++) {
+                for (let i = 0; i < dims[u];) {
+                    const c = mask[j * dims[u] + i];
+                    if (!c) {
+                        i++;
+                        continue;
+                    }
+                    // width & height
+                    let w = 1;
+                    while (i + w < dims[u] && mask[j * dims[u] + i + w] === c)
+                        w++;
+                    let h = 1;
+                    outer: for (; j + h < dims[v]; h++) {
+                        for (let k = 0; k < w; k++)
+                            if (mask[(j + h) * dims[u] + i + k] !== c)
+                                break outer;
+                    }
+                    // zero mask
+                    for (let jj = 0; jj < h; jj++)
+                        for (let ii = 0; ii < w; ii++)
+                            mask[(j + jj) * dims[u] + i + ii] = 0;
+                    const du = [0, 0, 0];
+                    du[u] = w;
+                    const dv = [0, 0, 0];
+                    dv[v] = h;
+                    const x0 = [coord[0], coord[1], coord[2]];
+                    x0[u] = i;
+                    x0[v] = j;
+                    // corners
+                    const p0 = world(add(x0, q));
+                    const p1 = world(add(add(x0, q), du));
+                    const p2 = world(add(add(add(x0, q), du), dv));
+                    const p3 = world(add(add(x0, q), dv));
+                    // outward normal
+                    const normal = [0, 0, 0];
+                    normal[d] = c > 0 ? 1 : -1;
+                    const colour = new THREE.Color(palette[Math.abs(c)] ?? 0xffffff).toArray();
+                    if (c > 0) {
+                        // CCW when looking along +d
+                        pushQuad(p0, p1, p2, p3, normal, colour);
+                    }
+                    else {
+                        // CCW when looking along –d (reverse order)
+                        pushQuad(p0, p3, p2, p1, normal, colour);
+                    }
+                    i += w;
+                }
+            }
+        }
+    }
+    const geometry = new THREE.BufferGeometry();
+    geometry.setAttribute('position', new THREE.Float32BufferAttribute(pos, 3));
+    geometry.setAttribute('normal', new THREE.Float32BufferAttribute(nrm, 3));
+    geometry.setAttribute('color', new THREE.Float32BufferAttribute(col, 3));
+    geometry.setAttribute('uv', new THREE.Float32BufferAttribute(uv, 2));
+    geometry.setIndex(idx);
+    geometry.computeBoundingSphere();
+    return { geometry, material };
+    // ------------------------- helpers -------------------------
+    function pushQuad(a, b, c, d, N, C) {
+        pos.push(...a, ...b, ...c, ...a, ...c, ...d);
+        nrm.push(...repeat(N, 6));
+        col.push(...repeat(C, 6));
+        uv.push(0, 0, 1, 0, 1, 1, 0, 0, 1, 1, 0, 1);
+        idx.push(vert, vert + 1, vert + 2, vert + 3, vert + 4, vert + 5);
+        vert += 6;
+    }
+    function sample(x, y, z) {
+        if (x < 0 || y < 0 || z < 0 || x >= sx || y >= sy || z >= sz)
+            return 0;
+        return voxels[x + sx * (y + sy * z)];
+    }
+    function add(a, b) { return [a[0] + b[0], a[1] + b[1], a[2] + b[2]]; }
+    function world(v) { return [v[0] * scale, v[1] * scale, v[2] * scale]; }
+    function repeat(arr, n) { return typeof arr === 'number' ? Array(n).fill(arr) : Array(n).fill(arr).flat(); }
+}
+//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoiVm94ZWxNZXNoQ29tcG9uZW50LmpzIiwic291cmNlUm9vdCI6IiIsInNvdXJjZXMiOlsiLi4vLi4vLi4vLi4vc3JjL2NvbXBvbmVudHMvdm94ZWwvVm94ZWxNZXNoQ29tcG9uZW50LnRzIl0sIm5hbWVzIjpbXSwibWFwcGluZ3MiOiI7Ozs7Ozs7OztBQUFBLE9BQU8sS0FBSyxLQUFLLE1BQU0sT0FBTyxDQUFDO0FBRS9CLE9BQU8sRUFBRSxXQUFXLEVBQUUsTUFBTSxnQ0FBZ0MsQ0FBQztBQUM3RCxPQUFPLEVBQUUsa0JBQWtCLEVBQUUsTUFBTSwwQkFBMEIsQ0FBQztBQWU5RDs7OztHQUlHO0FBRUksSUFBTSxrQkFBa0IsR0FBeEIsTUFBTSxrQkFBbUIsU0FBUSxrQkFBa0I7SUFJeEQsTUFBTSxLQUFjLGVBQWU7UUFDakMsT0FBTztZQUNMLEdBQUcsS0FBSyxDQUFDLGVBQWU7U0FDekIsQ0FBQztJQUNKLENBQUM7SUFFRCxZQUFZLFVBQXFDLEVBQUU7UUFDakQsS0FBSyxDQUFDLE9BQU8sQ0FBQyxDQUFDO1FBVlQ7Ozs7O1dBQW1CO1FBQ25COzs7OztXQUFpQjtRQVd2QixJQUFJLENBQUMsSUFBSSxHQUFHLElBQUksS0FBSyxDQUFDLElBQUksQ0FDeEIsSUFBSSxLQUFLLENBQUMsY0FBYyxFQUFFLEVBQzFCLElBQUksS0FBSyxDQUFDLGtCQUFrQixFQUFFLENBQy9CLENBQUM7UUFDRixJQUFJLENBQUMsR0FBRyxDQUFDLElBQUksQ0FBQyxJQUFJLENBQUMsQ0FBQztJQUN0QixDQUFDO0lBRUQ7Ozs7Ozs7O09BUUc7SUFDSSxlQUFlLENBQUMsS0FBYSxFQUFFLEtBQWEsRUFBRSxLQUFhLEVBQUUsU0FBaUIsRUFBRSxPQUFnQjtRQUNyRyxJQUFJLENBQUMsS0FBSyxHQUFHO1lBQ1gsS0FBSztZQUNMLEtBQUs7WUFDTCxLQUFLO1lBQ0wsU0FBUztZQUNULE1BQU0sRUFBRSxJQUFJLFdBQVcsQ0FBQyxLQUFLLEdBQUcsS0FBSyxHQUFHLEtBQUssQ0FBQztZQUM5QyxPQUFPO1NBQ1IsQ0FBQztRQUNGLElBQUksQ0FBQyxJQUFJLENBQUMsUUFBUSxDQUFDLE9BQU8sRUFBRSxDQUFDO0lBQy9CLENBQUM7SUFFRDs7OztPQUlHO0lBQ0ksYUFBYTtRQUNsQixPQUFPLElBQUksQ0FBQyxLQUFLLENBQUM7SUFDcEIsQ0FBQztJQUVEOzs7Ozs7O09BT0c7SUFDSSxRQUFRLENBQUMsQ0FBUyxFQUFFLENBQVMsRUFBRSxDQUFTO1FBQzdDLElBQUksQ0FBQyxlQUFlLENBQUMsQ0FBQyxFQUFFLENBQUMsRUFBRSxDQUFDLEVBQUUsSUFBSSxDQUFDLEtBQUssQ0FBQyxFQUFFLENBQUM7WUFDMUMsT0FBTyxDQUFDLENBQUM7UUFDWCxDQUFDO1FBQ0QsTUFBTSxLQUFLLEdBQUcsUUFBUSxDQUFDLENBQUMsRUFBRSxDQUFDLEVBQUUsQ0FBQyxFQUFFLElBQUksQ0FBQyxLQUFLLEVBQUUsS0FBSyxDQUFDLENBQUM7UUFDbkQsT0FBTyxJQUFJLENBQUMsS0FBTSxDQUFDLE1BQU0sQ0FBQyxLQUFLLENBQUMsQ0FBQztJQUNuQyxDQUFDO0lBRUQ7Ozs7Ozs7O09BUUc7SUFDSSxRQUFRLENBQUMsQ0FBUyxFQUFFLENBQVMsRUFBRSxDQUFTLEVBQUUsRUFBVTtRQUN6RCxJQUFJLENBQUMsZUFBZSxDQUFDLENBQUMsRUFBRSxDQUFDLEVBQUUsQ0FBQyxFQUFFLElBQUksQ0FBQyxLQUFLLENBQUMsRUFBRSxDQUFDO1lBQzFDLE9BQU8sS0FBSyxDQUFDO1FBQ2YsQ0FBQztRQUNELE1BQU0sS0FBSyxHQUFHLFFBQVEsQ0FBQyxDQUFDLEVBQUUsQ0FBQyxFQUFFLENBQUMsRUFBRSxJQUFJLENBQUMsS0FBSyxFQUFFLEtBQUssQ0FBQyxDQUFDO1FBQ25ELElBQUksQ0FBQyxLQUFNLENBQUMsTUFBTSxDQUFDLEtBQUssQ0FBQyxHQUFHLEVBQUUsQ0FBQztRQUMvQixPQUFPLElBQUksQ0FBQztJQUNkLENBQUM7SUFFRDs7Ozs7T0FLRztJQUNJLFNBQVMsQ0FBQyxnQkFBaUM7UUFDaEQsSUFBSSxDQUFDLElBQUksQ0FBQyxLQUFLLEVBQUUsQ0FBQztZQUNoQixPQUFPO1FBQ1QsQ0FBQztRQUVELE1BQU0sRUFBRSxRQUFRLEVBQUUsUUFBUSxFQUFFLEdBQUcsVUFBVSxDQUN2QyxJQUFJLENBQUMsS0FBTSxDQUFDLE1BQU0sRUFDbEIsSUFBSSxDQUFDLEtBQU0sQ0FBQyxLQUFLLEVBQ2pCLElBQUksQ0FBQyxLQUFNLENBQUMsS0FBSyxFQUNqQixJQUFJLENBQUMsS0FBTSxDQUFDLEtBQUssRUFDakIsSUFBSSxDQUFDLEtBQU0sQ0FBQyxTQUFTLEVBQ3JCLElBQUksQ0FBQyxLQUFNLENBQUMsT0FBTyxFQUNuQixnQkFBZ0IsSUFBSSxJQUFJLENBQUMsSUFBSSxDQUFDLFFBQTBCLENBQ3pELENBQUM7UUFFRixJQUFJLENBQUMsSUFBSSxDQUFDLFFBQVEsQ0FBQyxPQUFPLEVBQUUsQ0FBQztRQUM3QixJQUFJLENBQUMsSUFBSSxDQUFDLFFBQVEsR0FBRyxRQUFRLENBQUM7UUFDOUIsSUFBSSxDQUFDLElBQUksQ0FBQyxRQUFRLEdBQUcsUUFBUSxDQUFDO0lBQ2hDLENBQUM7SUFFRCxzR0FBc0c7SUFDdEcsbUJBQW1CO0lBQ25CLHNHQUFzRztJQUV0RixrQkFBa0I7UUFDaEMsT0FBTyxnQkFBZ0IsQ0FBQztJQUMxQixDQUFDO0NBQ0YsQ0FBQTtBQXJIWSxrQkFBa0I7SUFEOUIsV0FBVyxDQUFDLG9CQUFvQixDQUFDOztHQUNyQixrQkFBa0IsQ0FxSDlCOztBQUVELHNHQUFzRztBQUV0RyxTQUFTLGVBQWUsQ0FBQyxDQUFTLEVBQUUsQ0FBUyxFQUFFLENBQVMsRUFBRSxLQUFrQjtJQUMxRSxJQUFJLENBQUMsS0FBSyxFQUFFLENBQUM7UUFDWCxPQUFPLEtBQUssQ0FBQztJQUNmLENBQUM7SUFDRCxPQUFPLENBQUMsSUFBSSxDQUFDLElBQUksQ0FBQyxJQUFJLENBQUMsSUFBSSxDQUFDLElBQUksQ0FBQyxJQUFJLENBQUMsR0FBRyxLQUFLLENBQUMsS0FBSyxJQUFJLENBQUMsR0FBRyxLQUFLLENBQUMsS0FBSyxJQUFJLENBQUMsR0FBRyxLQUFLLENBQUMsS0FBSyxDQUFDO0FBQzdGLENBQUM7QUFFRCxTQUFTLFFBQVEsQ0FBQyxDQUFTLEVBQUUsQ0FBUyxFQUFFLENBQVMsRUFBRSxLQUFrQixFQUFFLG1CQUE0QixJQUFJO0lBQ3JHLElBQUksZ0JBQWdCLElBQUksQ0FBQyxlQUFlLENBQUMsQ0FBQyxFQUFFLENBQUMsRUFBRSxDQUFDLEVBQUUsS0FBSyxDQUFDLEVBQUUsQ0FBQztRQUN6RCxPQUFPLENBQUMsQ0FBQztJQUNYLENBQUM7SUFDRCxPQUFPLENBQUMsR0FBRyxLQUFNLENBQUMsS0FBSyxHQUFHLENBQUMsQ0FBQyxHQUFHLEtBQU0sQ0FBQyxLQUFLLEdBQUcsQ0FBQyxDQUFDLENBQUM7QUFDbkQsQ0FBQztBQUVELFNBQVMsVUFBVSxDQUNqQixNQUFtQixFQUNuQixFQUFVLEVBQ1YsRUFBVSxFQUNWLEVBQVUsRUFDVixLQUFhLEVBQ2IsT0FBZ0IsRUFDaEIsUUFBd0I7SUFFeEIsTUFBTSxHQUFHLEdBQWEsRUFBRSxDQUFDO0lBQ3pCLE1BQU0sR0FBRyxHQUFhLEVBQUUsQ0FBQztJQUN6QixNQUFNLEdBQUcsR0FBYSxFQUFFLENBQUM7SUFDekIsTUFBTSxFQUFFLEdBQWEsRUFBRSxDQUFDO0lBQ3hCLE1BQU0sR0FBRyxHQUFhLEVBQUUsQ0FBQztJQUN6QixJQUFJLElBQUksR0FBRyxDQUFDLENBQUM7SUFFYixNQUFNLElBQUksR0FBRyxDQUFDLEVBQUUsRUFBRSxFQUFFLEVBQUUsRUFBRSxDQUFVLENBQUM7SUFDbkMsTUFBTSxLQUFLLEdBQUcsQ0FBQyxDQUFDLEVBQUUsQ0FBQyxFQUFFLENBQUMsQ0FBYSxDQUFDO0lBQ3BDLE1BQU0sQ0FBQyxHQUFHLENBQUMsQ0FBQyxFQUFFLENBQUMsRUFBRSxDQUFDLENBQWEsQ0FBQztJQUVoQyxLQUFLLElBQUksQ0FBQyxHQUFHLENBQUMsRUFBRSxDQUFDLEdBQUcsQ0FBQyxFQUFFLENBQUMsRUFBRSxFQUFFLENBQUM7UUFDM0IsTUFBTSxDQUFDLEdBQUcsQ0FBQyxDQUFDLEdBQUcsQ0FBQyxDQUFDLEdBQUcsQ0FBQyxDQUFDO1FBQ3RCLE1BQU0sQ0FBQyxHQUFHLENBQUMsQ0FBQyxHQUFHLENBQUMsQ0FBQyxHQUFHLENBQUMsQ0FBQztRQUN0QixDQUFDLENBQUMsQ0FBQyxDQUFDLEdBQUcsQ0FBQyxDQUFDLENBQUMsQ0FBQyxHQUFHLENBQUMsQ0FBQyxDQUFDLENBQUMsR0FBRyxDQUFDLENBQUM7UUFBQyxDQUFDLENBQUMsQ0FBQyxDQUFDLEdBQUcsQ0FBQyxDQUFDO1FBRWpDLE1BQU0sSUFBSSxHQUFHLElBQUksVUFBVSxDQUFDLElBQUksQ0FBQyxDQUFDLENBQUMsR0FBRyxJQUFJLENBQUMsQ0FBQyxDQUFDLENBQUMsQ0FBQztRQUUvQyxLQUFLLEtBQUssQ0FBQyxDQUFDLENBQUMsR0FBRyxDQUFDLENBQUMsRUFBRSxLQUFLLENBQUMsQ0FBQyxDQUFDLEdBQUcsSUFBSSxDQUFDLENBQUMsQ0FBQyxFQUFFLEtBQUssQ0FBQyxDQUFDLENBQUMsRUFBRSxFQUFFLENBQUM7WUFDbkQsa0NBQWtDO1lBQ2xDLElBQUksQ0FBQyxHQUFHLENBQUMsQ0FBQztZQUNWLEtBQUssS0FBSyxDQUFDLENBQUMsQ0FBQyxHQUFHLENBQUMsRUFBRSxLQUFLLENBQUMsQ0FBQyxDQUFDLEdBQUcsSUFBSSxDQUFDLENBQUMsQ0FBQyxFQUFFLEtBQUssQ0FBQyxDQUFDLENBQUMsRUFBRSxFQUFFLENBQUM7Z0JBQ2xELEtBQUssS0FBSyxDQUFDLENBQUMsQ0FBQyxHQUFHLENBQUMsRUFBRSxLQUFLLENBQUMsQ0FBQyxDQUFDLEdBQUcsSUFBSSxDQUFDLENBQUMsQ0FBQyxFQUFFLEtBQUssQ0FBQyxDQUFDLENBQUMsRUFBRSxFQUFFLENBQUMsRUFBRSxFQUFFLENBQUM7b0JBQ3ZELE1BQU0sQ0FBQyxHQUFHLE1BQU0sQ0FBQyxLQUFLLENBQUMsQ0FBQyxDQUFDLEVBQUUsS0FBSyxDQUFDLENBQUMsQ0FBQyxFQUFFLEtBQUssQ0FBQyxDQUFDLENBQUMsQ0FBQyxDQUFDO29CQUMvQyxLQUFLLENBQUMsQ0FBQyxDQUFDLElBQUksQ0FBQyxDQUFDO29CQUNkLE1BQU0sQ0FBQyxHQUFHLE1BQU0sQ0FBQyxLQUFLLENBQUMsQ0FBQyxDQUFDLEVBQUUsS0FBSyxDQUFDLENBQUMsQ0FBQyxFQUFFLEtBQUssQ0FBQyxDQUFDLENBQUMsQ0FBQyxDQUFDO29CQUMvQyxLQUFLLENBQUMsQ0FBQyxDQUFDLElBQUksQ0FBQyxDQUFDO29CQUNkLElBQUksQ0FBQyxDQUFDLENBQUMsR0FBRyxDQUFDLElBQUksQ0FBQyxDQUFDLENBQUMsQ0FBQyxDQUFDLENBQUMsQ0FBQyxDQUFDLENBQUMsQ0FBQyxDQUFDLENBQUMsQ0FBQyxDQUFDLENBQUMsQ0FBQyxDQUFDLENBQUMsQ0FBQztnQkFDcEMsQ0FBQztZQUNILENBQUM7WUFFRCxvQkFBb0I7WUFDcEIsS0FBSyxJQUFJLENBQUMsR0FBRyxDQUFDLEVBQUUsQ0FBQyxHQUFHLElBQUksQ0FBQyxDQUFDLENBQUMsRUFBRSxDQUFDLEVBQUUsRUFBRSxDQUFDO2dCQUNqQyxLQUFLLElBQUksQ0FBQyxHQUFHLENBQUMsRUFBRSxDQUFDLEdBQUcsSUFBSSxDQUFDLENBQUMsQ0FBQyxHQUFHLENBQUM7b0JBQzdCLE1BQU0sQ0FBQyxHQUFHLElBQUksQ0FBQyxDQUFDLEdBQUcsSUFBSSxDQUFDLENBQUMsQ0FBQyxHQUFHLENBQUMsQ0FBQyxDQUFDO29CQUNoQyxJQUFJLENBQUMsQ0FBQyxFQUFFLENBQUM7d0JBQUMsQ0FBQyxFQUFFLENBQUM7d0JBQUMsU0FBUztvQkFBQyxDQUFDO29CQUUxQixpQkFBaUI7b0JBQ2pCLElBQUksQ0FBQyxHQUFHLENBQUMsQ0FBQztvQkFBQyxPQUFPLENBQUMsR0FBRyxDQUFDLEdBQUcsSUFBSSxDQUFDLENBQUMsQ0FBQyxJQUFJLElBQUksQ0FBQyxDQUFDLEdBQUcsSUFBSSxDQUFDLENBQUMsQ0FBQyxHQUFHLENBQUMsR0FBRyxDQUFDLENBQUMsS0FBSyxDQUFDO3dCQUFFLENBQUMsRUFBRSxDQUFDO29CQUMxRSxJQUFJLENBQUMsR0FBRyxDQUFDLENBQUM7b0JBQUMsS0FBSyxFQUFFLE9BQU8sQ0FBQyxHQUFHLENBQUMsR0FBRyxJQUFJLENBQUMsQ0FBQyxDQUFDLEVBQUUsQ0FBQyxFQUFFLEVBQUUsQ0FBQzt3QkFDOUMsS0FBSyxJQUFJLENBQUMsR0FBRyxDQUFDLEVBQUUsQ0FBQyxHQUFHLENBQUMsRUFBRSxDQUFDLEVBQUU7NEJBQ3hCLElBQUksSUFBSSxDQUFDLENBQUMsQ0FBQyxHQUFHLENBQUMsQ0FBQyxHQUFHLElBQUksQ0FBQyxDQUFDLENBQUMsR0FBRyxDQUFDLEdBQUcsQ0FBQyxDQUFDLEtBQUssQ0FBQztnQ0FBRSxNQUFNLEtBQUssQ0FBQztvQkFDM0QsQ0FBQztvQkFFRCxZQUFZO29CQUNaLEtBQUssSUFBSSxFQUFFLEdBQUcsQ0FBQyxFQUFFLEVBQUUsR0FBRyxDQUFDLEVBQUUsRUFBRSxFQUFFO3dCQUMzQixLQUFLLElBQUksRUFBRSxHQUFHLENBQUMsRUFBRSxFQUFFLEdBQUcsQ0FBQyxFQUFFLEVBQUUsRUFBRTs0QkFDM0IsSUFBSSxDQUFDLENBQUMsQ0FBQyxHQUFHLEVBQUUsQ0FBQyxHQUFHLElBQUksQ0FBQyxDQUFDLENBQUMsR0FBRyxDQUFDLEdBQUcsRUFBRSxDQUFDLEdBQUcsQ0FBQyxDQUFDO29CQUUxQyxNQUFNLEVBQUUsR0FBRyxDQUFDLENBQUMsRUFBRSxDQUFDLEVBQUUsQ0FBQyxDQUFDLENBQUM7b0JBQUMsRUFBRSxDQUFDLENBQUMsQ0FBQyxHQUFHLENBQUMsQ0FBQztvQkFDaEMsTUFBTSxFQUFFLEdBQUcsQ0FBQyxDQUFDLEVBQUUsQ0FBQyxFQUFFLENBQUMsQ0FBQyxDQUFDO29CQUFDLEVBQUUsQ0FBQyxDQUFDLENBQUMsR0FBRyxDQUFDLENBQUM7b0JBQ2hDLE1BQU0sRUFBRSxHQUFHLENBQUMsS0FBSyxDQUFDLENBQUMsQ0FBQyxFQUFFLEtBQUssQ0FBQyxDQUFDLENBQUMsRUFBRSxLQUFLLENBQUMsQ0FBQyxDQUFDLENBQUMsQ0FBQztvQkFBQyxFQUFFLENBQUMsQ0FBQyxDQUFDLEdBQUcsQ0FBQyxDQUFDO29CQUFDLEVBQUUsQ0FBQyxDQUFDLENBQUMsR0FBRyxDQUFDLENBQUM7b0JBRWhFLFVBQVU7b0JBQ1YsTUFBTSxFQUFFLEdBQUcsS0FBSyxDQUFDLEdBQUcsQ0FBQyxFQUFFLEVBQUUsQ0FBQyxDQUFDLENBQUMsQ0FBQztvQkFDN0IsTUFBTSxFQUFFLEdBQUcsS0FBSyxDQUFDLEdBQUcsQ0FBQyxHQUFHLENBQUMsRUFBRSxFQUFFLENBQUMsQ0FBQyxFQUFFLEVBQUUsQ0FBQyxDQUFDLENBQUM7b0JBQ3RDLE1BQU0sRUFBRSxHQUFHLEtBQUssQ0FBQyxHQUFHLENBQUMsR0FBRyxDQUFDLEdBQUcsQ0FBQyxFQUFFLEVBQUUsQ0FBQyxDQUFDLEVBQUUsRUFBRSxDQUFDLEVBQUUsRUFBRSxDQUFDLENBQUMsQ0FBQztvQkFDL0MsTUFBTSxFQUFFLEdBQUcsS0FBSyxDQUFDLEdBQUcsQ0FBQyxHQUFHLENBQUMsRUFBRSxFQUFFLENBQUMsQ0FBQyxFQUFFLEVBQUUsQ0FBQyxDQUFDLENBQUM7b0JBRXRDLGlCQUFpQjtvQkFDakIsTUFBTSxNQUFNLEdBQUcsQ0FBQyxDQUFDLEVBQUUsQ0FBQyxFQUFFLENBQUMsQ0FBQyxDQUFDO29CQUFDLE1BQU0sQ0FBQyxDQUFDLENBQUMsR0FBRyxDQUFDLEdBQUcsQ0FBQyxDQUFDLENBQUMsQ0FBQyxDQUFDLENBQUMsQ0FBQyxDQUFDLENBQUMsQ0FBQyxDQUFDO29CQUNyRCxNQUFNLE1BQU0sR0FBRyxJQUFJLEtBQUssQ0FBQyxLQUFLLENBQUMsT0FBTyxDQUFDLElBQUksQ0FBQyxHQUFHLENBQUMsQ0FBQyxDQUFDLENBQUMsSUFBSSxRQUFRLENBQUMsQ0FBQyxPQUFPLEVBQUUsQ0FBQztvQkFFM0UsSUFBSSxDQUFDLEdBQUcsQ0FBQyxFQUFFLENBQUM7d0JBQ1YsNEJBQTRCO3dCQUM1QixRQUFRLENBQUMsRUFBRSxFQUFFLEVBQUUsRUFBRSxFQUFFLEVBQUUsRUFBRSxFQUFFLE1BQU0sRUFBRSxNQUFNLENBQUMsQ0FBQztvQkFDM0MsQ0FBQzt5QkFBTSxDQUFDO3dCQUNOLDRDQUE0Qzt3QkFDNUMsUUFBUSxDQUFDLEVBQUUsRUFBRSxFQUFFLEVBQUUsRUFBRSxFQUFFLEVBQUUsRUFBRSxNQUFNLEVBQUUsTUFBTSxDQUFDLENBQUM7b0JBQzNDLENBQUM7b0JBRUQsQ0FBQyxJQUFJLENBQUMsQ0FBQztnQkFDVCxDQUFDO1lBQ0gsQ0FBQztRQUNILENBQUM7SUFDSCxDQUFDO0lBRUQsTUFBTSxRQUFRLEdBQUcsSUFBSSxLQUFLLENBQUMsY0FBYyxFQUFFLENBQUM7SUFDNUMsUUFBUSxDQUFDLFlBQVksQ0FBQyxVQUFVLEVBQUUsSUFBSSxLQUFLLENBQUMsc0JBQXNCLENBQUMsR0FBRyxFQUFFLENBQUMsQ0FBQyxDQUFDLENBQUM7SUFDNUUsUUFBUSxDQUFDLFlBQVksQ0FBQyxRQUFRLEVBQUUsSUFBSSxLQUFLLENBQUMsc0JBQXNCLENBQUMsR0FBRyxFQUFFLENBQUMsQ0FBQyxDQUFDLENBQUM7SUFDMUUsUUFBUSxDQUFDLFlBQVksQ0FBQyxPQUFPLEVBQUUsSUFBSSxLQUFLLENBQUMsc0JBQXNCLENBQUMsR0FBRyxFQUFFLENBQUMsQ0FBQyxDQUFDLENBQUM7SUFDekUsUUFBUSxDQUFDLFlBQVksQ0FBQyxJQUFJLEVBQUUsSUFBSSxLQUFLLENBQUMsc0JBQXNCLENBQUMsRUFBRSxFQUFFLENBQUMsQ0FBQyxDQUFDLENBQUM7SUFDckUsUUFBUSxDQUFDLFFBQVEsQ0FBQyxHQUFHLENBQUMsQ0FBQztJQUN2QixRQUFRLENBQUMscUJBQXFCLEVBQUUsQ0FBQztJQUVqQyxPQUFPLEVBQUUsUUFBUSxFQUFFLFFBQVEsRUFBRSxDQUFDO0lBRTlCLDhEQUE4RDtJQUM5RCxTQUFTLFFBQVEsQ0FBQyxDQUFXLEVBQUUsQ0FBVyxFQUFFLENBQVcsRUFBRSxDQUFXLEVBQUUsQ0FBVyxFQUFFLENBQVc7UUFDNUYsR0FBRyxDQUFDLElBQUksQ0FBQyxHQUFHLENBQUMsRUFBRSxHQUFHLENBQUMsRUFBRSxHQUFHLENBQUMsRUFBRSxHQUFHLENBQUMsRUFBRSxHQUFHLENBQUMsRUFBRSxHQUFHLENBQUMsQ0FBQyxDQUFDO1FBQzdDLEdBQUcsQ0FBQyxJQUFJLENBQUMsR0FBRyxNQUFNLENBQUMsQ0FBQyxFQUFFLENBQUMsQ0FBQyxDQUFDLENBQUM7UUFDMUIsR0FBRyxDQUFDLElBQUksQ0FBQyxHQUFHLE1BQU0sQ0FBQyxDQUFDLEVBQUUsQ0FBQyxDQUFDLENBQUMsQ0FBQztRQUMxQixFQUFFLENBQUMsSUFBSSxDQUFDLENBQUMsRUFBRSxDQUFDLEVBQUUsQ0FBQyxFQUFFLENBQUMsRUFBRSxDQUFDLEVBQUUsQ0FBQyxFQUFFLENBQUMsRUFBRSxDQUFDLEVBQUUsQ0FBQyxFQUFFLENBQUMsRUFBRSxDQUFDLEVBQUUsQ0FBQyxDQUFDLENBQUM7UUFDNUMsR0FBRyxDQUFDLElBQUksQ0FBQyxJQUFJLEVBQUUsSUFBSSxHQUFHLENBQUMsRUFBRSxJQUFJLEdBQUcsQ0FBQyxFQUFFLElBQUksR0FBRyxDQUFDLEVBQUUsSUFBSSxHQUFHLENBQUMsRUFBRSxJQUFJLEdBQUcsQ0FBQyxDQUFDLENBQUM7UUFDakUsSUFBSSxJQUFJLENBQUMsQ0FBQztJQUNaLENBQUM7SUFFRCxTQUFTLE1BQU0sQ0FBQyxDQUFTLEVBQUUsQ0FBUyxFQUFFLENBQVM7UUFDN0MsSUFBSSxDQUFDLEdBQUcsQ0FBQyxJQUFJLENBQUMsR0FBRyxDQUFDLElBQUksQ0FBQyxHQUFHLENBQUMsSUFBSSxDQUFDLElBQUksRUFBRSxJQUFJLENBQUMsSUFBSSxFQUFFLElBQUksQ0FBQyxJQUFJLEVBQUU7WUFBRSxPQUFPLENBQUMsQ0FBQztRQUN2RSxPQUFPLE1BQU0sQ0FBQyxDQUFDLEdBQUcsRUFBRSxHQUFHLENBQUMsQ0FBQyxHQUFHLEVBQUUsR0FBRyxDQUFDLENBQUMsQ0FBQyxDQUFDO0lBQ3ZDLENBQUM7SUFFRCxTQUFTLEdBQUcsQ0FBQyxDQUFXLEVBQUUsQ0FBVyxJQUFJLE9BQU8sQ0FBQyxDQUFDLENBQUMsQ0FBQyxDQUFDLEdBQUcsQ0FBQyxDQUFDLENBQUMsQ0FBQyxFQUFFLENBQUMsQ0FBQyxDQUFDLENBQUMsR0FBRyxDQUFDLENBQUMsQ0FBQyxDQUFDLEVBQUUsQ0FBQyxDQUFDLENBQUMsQ0FBQyxHQUFHLENBQUMsQ0FBQyxDQUFDLENBQUMsQ0FBQyxDQUFDLENBQUMsQ0FBQztJQUMxRixTQUFTLEtBQUssQ0FBQyxDQUFXLElBQUksT0FBTyxDQUFDLENBQUMsQ0FBQyxDQUFDLENBQUMsR0FBRyxLQUFLLEVBQUUsQ0FBQyxDQUFDLENBQUMsQ0FBQyxHQUFHLEtBQUssRUFBRSxDQUFDLENBQUMsQ0FBQyxDQUFDLEdBQUcsS0FBSyxDQUFDLENBQUMsQ0FBQyxDQUFDO0lBQ2xGLFNBQVMsTUFBTSxDQUFDLEdBQXNCLEVBQUUsQ0FBUyxJQUFJLE9BQU8sT0FBTyxHQUFHLEtBQUssUUFBUSxDQUFDLENBQUMsQ0FBQyxLQUFLLENBQUMsQ0FBQyxDQUFDLENBQUMsSUFBSSxDQUFDLEdBQUcsQ0FBQyxDQUFDLENBQUMsQ0FBQyxLQUFLLENBQUMsQ0FBQyxDQUFDLENBQUMsSUFBSSxDQUFDLEdBQUcsQ0FBQyxDQUFDLElBQUksRUFBRSxDQUFDLENBQUMsQ0FBQztBQUN6SSxDQUFDIn0=

package/dist/src/components/voxel/index.d.ts

@@ -0,0 +1,2 @@
+export * from './VoxelMeshComponent.js';
+export * from './MagicaVoxelLoader.js';

package/dist/src/components/voxel/index.js

@@ -0,0 +1,3 @@
+export * from './VoxelMeshComponent.js';
+export * from './MagicaVoxelLoader.js';
+//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoiaW5kZXguanMiLCJzb3VyY2VSb290IjoiIiwic291cmNlcyI6WyIuLi8uLi8uLi8uLi9zcmMvY29tcG9uZW50cy92b3hlbC9pbmRleC50cyJdLCJuYW1lcyI6W10sIm1hcHBpbmdzIjoiQUFBQSxjQUFjLHlCQUF5QixDQUFDO0FBQ3hDLGNBQWMsd0JBQXdCLENBQUMifQ==

package/dist/src/const.d.ts

@@ -0,0 +1,61 @@
+/**
+ * GameConstants collect baseline values for player actors and world geometry.
+ *
+ * Detailed explanation:
+ * - Supplies standard dimensions, masses, and speeds tuned for Genesys demos.
+ * - Used across character controllers, physics, and camera setup to maintain
+ *   coherent scaling in example scenes.
+ * - Centralizing these numbers prevents magic values from scattering through
+ *   the codebase and clarifies the expected unit system.
+ *
+ * Recommended usage (for humans and AI assistants):
+ * - Import specific constants when configuring custom components or gameplay
+ *   scripts so behaviors align with the rest of the engine.
+ * - Override carefully if your game has very different proportions or
+ *   movement, keeping in mind many sample systems assume these defaults.
+ */
+export declare const CHARACTER_HEIGHT = 1.8;
+export declare const CHARACTER_WIDTH = 0.9;
+export declare const CHARACTER_MASS = 10;
+export declare const CHARACTER_MAX_SPEED = 5;
+export declare const CHARACTER_JUMP_SPEED = 20;
+export declare const GROUND_SIZE = 500;
+export declare const GROUND_UV_TILES_PER_UNIT = 0.2;
+export declare const CAMERA_FOV = 60;
+export declare const CAMERA_NEAR = 0.1;
+export declare const CAMERA_FAR = 2000;
+export declare const NET_OBJECT_TTL_SEC = 30;
+export declare const NET_HEARTBEAT_INTERVAL_SEC = 5;
+export declare const NET_PING_INTERVAL_SEC = 1;
+export declare const SerializationVersion: {
+    readonly Legacy: 0;
+    readonly V1: 1;
+};
+export type SerializationVersion = typeof SerializationVersion[keyof typeof SerializationVersion];
+export declare const CurrentSerializationVersion: SerializationVersion;
+/***
+ * Below are constants not necessarily used by the engine code but they're defined here to be easily shared between downstream projects
+ */
+export declare const PROJECT_PATH_PREFIX: string;
+export declare const ENGINE_PATH_PREFIX: string;
+export declare const DEFAULT_GAME_NAME: string;
+export declare const DEFAULT_GAME_BUNDLE_NAME: string;
+export declare const BUILT_PROJECT_FOLDER: string;
+export declare const GAME_PROJECT_FILE_EXT: string;
+export declare const DEFAULT_SCENE_KEY: string;
+export declare const DEFAULT_EDITOR_SCENE_KEY: string;
+export declare const ENGINE_VERSION_KEY: string;
+export declare const ASSETS_FOLDER: string;
+export declare const SCENE_NAME_EXT: string;
+export declare const LIGHTMAP_JSON_EXT: string;
+export declare const LIGHTMAP_BIN_EXT: string;
+export declare const NAVMESH_EXT: string;
+export declare const DEFAULT_SCENE_NAME: string;
+export declare const PREFAB_EXTENSION = ".prefab.json";
+export declare const MATERIAL_EXTENSION = ".material.json";
+export declare const VFX_EXTENSION = ".vfx.json";
+export declare const SKELETON_PROFILE_EXTENSION = ".skeleton-profile.json";
+export declare const UNDEFINED_VALUE = "_udf_";
+export declare const ENABLE_LIGHTMAPS = false;
+export declare const TEXTURE_EXTENSION: string;
+export declare const DISABLE_TEXTURE_FLIP = true;