@directivegames/genesys.js 3.1.24

package/dist/src/render/lightmapping/LightmapSerialization.js

@@ -0,0 +1,244 @@
+/**
+ * LightmapSerialization handles the export and import of lightmap data.
+ *
+ * This system enables:
+ * - Exporting baked lightmaps to .lightmap files with separate texture images
+ * - Importing and applying saved lightmaps to scenes
+ * - Mesh-to-atlas mapping for tracking which actors use which parts of the lightmap
+ * - Manual file management for lightmap assets
+ *
+ * File structure:
+ * - scene.lightmap.json (JSON metadata)
+ * - scene.lightmap (high-precision binary lightmap texture)
+ */
+import * as THREE from 'three';
+import { z } from 'zod';
+/**
+ * Schema for validating lightmap file format
+ */
+const lightmapSchema = z.object({
+    version: z.string(),
+    metadata: z.object({
+        exportDate: z.string(),
+        sceneHash: z.string().optional(),
+        bakingOptions: z.object({
+            resolution: z.number(),
+            casts: z.number(),
+            progressiveSamples: z.number(),
+            lightSources: z.array(z.object({
+                position: z.tuple([z.number(), z.number(), z.number()]),
+                size: z.number(),
+                intensity: z.number(),
+                color: z.tuple([z.number(), z.number(), z.number()]),
+            })).optional(),
+            // Legacy fields for backwards compatibility
+            lightSize: z.number().optional(),
+            lightPosition: z.tuple([z.number(), z.number(), z.number()]).optional(),
+            directLightEnabled: z.boolean(),
+            indirectLightEnabled: z.boolean(),
+            ambientLightEnabled: z.boolean(),
+            ambientDistance: z.number(),
+        }),
+    }),
+    lightmap: z.object({
+        textureFile: z.string(),
+        width: z.number(),
+        height: z.number(),
+        format: z.string(),
+        filterMode: z.number(),
+    }),
+    meshMappings: z.record(z.string(), z.object({
+        actorUuid: z.string(),
+        meshIndex: z.number(),
+        uvBounds: z.object({
+            min: z.tuple([z.number(), z.number()]),
+            max: z.tuple([z.number(), z.number()]),
+        }),
+    })),
+    uv2Data: z.record(z.string(), z.array(z.object({
+        meshIndex: z.number(),
+        vertexCount: z.number(),
+        uv2Coordinates: z.array(z.number()), // Flattened UV2 coordinates
+        geometryAttributes: z.object({
+            positionCount: z.number(),
+            normalCount: z.number(),
+            hasUv: z.boolean(),
+        }).optional(), // For validation
+    }))),
+}).strict();
+/**
+ * Validates lightmap data against the schema
+ */
+export function validateLightmapData(data) {
+    const result = lightmapSchema.safeParse(data);
+    if (!result.success) {
+        throw new Error(`Invalid lightmap data: ${result.error.message}`);
+    }
+    return result.data;
+}
+/**
+ * Generates a hash for scene content to detect changes
+ */
+export function generateSceneHash(actors) {
+    const content = actors.map(actor => ({
+        uuid: actor.uuid,
+        position: actor.rootComponent.position.toArray(),
+        rotation: actor.rootComponent.rotation.toArray(),
+        scale: actor.rootComponent.scale.toArray(),
+    }));
+    // Simple hash based on JSON string - could be improved with a proper hash function
+    const jsonString = JSON.stringify(content);
+    let hash = 0;
+    for (let i = 0; i < jsonString.length; i++) {
+        const char = jsonString.charCodeAt(i);
+        hash = ((hash << 5) - hash) + char;
+        hash = hash & hash; // Convert to 32-bit integer
+    }
+    return Math.abs(hash).toString(16);
+}
+/**
+ * Creates mesh mappings by analyzing UV2 coordinates
+ */
+export function createMeshMappings(actors, meshes) {
+    const mappings = new Map();
+    for (const actor of actors) {
+        // Get meshes from this actor
+        const actorMeshes = getMeshesFromActor(actor);
+        actorMeshes.forEach((mesh, actorMeshIndex) => {
+            if (meshes.includes(mesh)) {
+                // Calculate UV bounds from UV2 coordinates
+                const uvBounds = calculateUVBounds(mesh);
+                mappings.set(`${actor.uuid}_${actorMeshIndex}`, {
+                    actorUuid: actor.uuid,
+                    meshIndex: actorMeshIndex, // Use per-actor mesh index, not global
+                    uvBounds: uvBounds,
+                });
+            }
+        });
+    }
+    return mappings;
+}
+/**
+ * Extracts UV2 coordinates from all meshes in the given actors
+ */
+export function extractUV2Data(actors, meshes) {
+    const uv2DataMap = {};
+    for (const actor of actors) {
+        const actorMeshes = getMeshesFromActor(actor);
+        const actorUV2Data = [];
+        actorMeshes.forEach((mesh, meshIndex) => {
+            if (meshes.includes(mesh)) {
+                const uv2Attribute = mesh.geometry.getAttribute('uv2');
+                if (uv2Attribute) {
+                    const geometry = mesh.geometry;
+                    actorUV2Data.push({
+                        meshIndex: meshIndex,
+                        vertexCount: uv2Attribute.count,
+                        uv2Coordinates: Array.from(uv2Attribute.array),
+                        geometryAttributes: {
+                            positionCount: geometry.getAttribute('position')?.count ?? 0,
+                            normalCount: geometry.getAttribute('normal')?.count ?? 0,
+                            hasUv: !!geometry.getAttribute('uv'),
+                        },
+                    });
+                }
+            }
+        });
+        if (actorUV2Data.length > 0) {
+            uv2DataMap[actor.uuid] = actorUV2Data;
+        }
+    }
+    return uv2DataMap;
+}
+/**
+ * Restores UV2 coordinates to meshes in the given actors
+ */
+export function restoreUV2Data(actors, uv2DataMap) {
+    for (const actor of actors) {
+        const actorUV2Data = uv2DataMap[actor.uuid];
+        if (actorUV2Data) {
+            const actorMeshes = getMeshesFromActor(actor);
+            for (const uv2Data of actorUV2Data) {
+                const mesh = actorMeshes[uv2Data.meshIndex];
+                if (mesh) {
+                    // Validate geometry compatibility (optional but recommended)
+                    if (uv2Data.geometryAttributes) {
+                        const currentGeometry = mesh.geometry;
+                        const positionCount = currentGeometry.getAttribute('position')?.count ?? 0;
+                        const normalCount = currentGeometry.getAttribute('normal')?.count ?? 0;
+                        if (positionCount !== uv2Data.geometryAttributes.positionCount ||
+                            normalCount !== uv2Data.geometryAttributes.normalCount) {
+                            console.warn(`UV2 data mismatch for actor ${actor.uuid}, mesh ${uv2Data.meshIndex}:`);
+                            console.warn(`  Expected: position=${uv2Data.geometryAttributes.positionCount}, normal=${uv2Data.geometryAttributes.normalCount}`);
+                            console.warn(`  Current:  position=${positionCount}, normal=${normalCount}`);
+                            console.warn(`  UV2 vertex count: ${uv2Data.vertexCount}`);
+                            console.warn('  This may indicate the geometry was modified during baking.');
+                        }
+                    }
+                    // Restore UV2 coordinates
+                    const uv2Array = new Float32Array(uv2Data.uv2Coordinates);
+                    const uv2Attribute = new THREE.BufferAttribute(uv2Array, 2);
+                    mesh.geometry.setAttribute('uv2', uv2Attribute);
+                }
+                else {
+                    console.warn(`🔍 Mesh not found for actor ${actor.uuid}, mesh index ${uv2Data.meshIndex}`);
+                }
+            }
+        }
+    }
+}
+/**
+ * Helper function to get meshes from an actor
+ * This duplicates logic from LightmapManager for now to avoid circular imports
+ */
+function getMeshesFromActor(actor) {
+    const meshes = [];
+    // Check for GLTFMeshActor
+    if (actor.getMeshComponent) {
+        const meshComponent = actor.getMeshComponent();
+        if (meshComponent) {
+            const model = meshComponent.getModel();
+            if (model) {
+                model.traverse((child) => {
+                    if (child instanceof THREE.Mesh) {
+                        meshes.push(child);
+                    }
+                });
+            }
+        }
+    }
+    // Check if root component is a MeshComponent
+    const rootComponent = actor.rootComponent;
+    if (rootComponent && 'getMesh' in rootComponent) {
+        const mesh = rootComponent.getMesh();
+        if (mesh instanceof THREE.Mesh) {
+            meshes.push(mesh);
+        }
+    }
+    // Apply the same filtering as during baking: only include meshes with materials and visibility
+    return meshes.filter(mesh => mesh.material && mesh.visible);
+}
+/**
+ * Calculates UV bounds for a mesh based on UV2 coordinates
+ */
+function calculateUVBounds(mesh) {
+    const uv2Attribute = mesh.geometry.getAttribute('uv2');
+    if (!uv2Attribute) {
+        return { min: [0, 0], max: [1, 1] }; // Default bounds
+    }
+    let minU = Infinity, minV = Infinity;
+    let maxU = -Infinity, maxV = -Infinity;
+    for (let i = 0; i < uv2Attribute.count; i++) {
+        const u = uv2Attribute.getX(i);
+        const v = uv2Attribute.getY(i);
+        minU = Math.min(minU, u);
+        minV = Math.min(minV, v);
+        maxU = Math.max(maxU, u);
+        maxV = Math.max(maxV, v);
+    }
+    return {
+        min: [minU, minV],
+        max: [maxU, maxV],
+    };
+}
+//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoiTGlnaHRtYXBTZXJpYWxpemF0aW9uLmpzIiwic291cmNlUm9vdCI6IiIsInNvdXJjZXMiOlsiLi4vLi4vLi4vLi4vc3JjL3JlbmRlci9saWdodG1hcHBpbmcvTGlnaHRtYXBTZXJpYWxpemF0aW9uLnRzIl0sIm5hbWVzIjpbXSwibWFwcGluZ3MiOiJBQUFBOzs7Ozs7Ozs7Ozs7R0FZRztBQUVILE9BQU8sS0FBSyxLQUFLLE1BQU0sT0FBTyxDQUFDO0FBQy9CLE9BQU8sRUFBRSxDQUFDLEVBQUUsTUFBTSxLQUFLLENBQUM7QUFLeEI7O0dBRUc7QUFDSCxNQUFNLGNBQWMsR0FBRyxDQUFDLENBQUMsTUFBTSxDQUFDO0lBQzlCLE9BQU8sRUFBRSxDQUFDLENBQUMsTUFBTSxFQUFFO0lBQ25CLFFBQVEsRUFBRSxDQUFDLENBQUMsTUFBTSxDQUFDO1FBQ2pCLFVBQVUsRUFBRSxDQUFDLENBQUMsTUFBTSxFQUFFO1FBQ3RCLFNBQVMsRUFBRSxDQUFDLENBQUMsTUFBTSxFQUFFLENBQUMsUUFBUSxFQUFFO1FBQ2hDLGFBQWEsRUFBRSxDQUFDLENBQUMsTUFBTSxDQUFDO1lBQ3RCLFVBQVUsRUFBRSxDQUFDLENBQUMsTUFBTSxFQUFFO1lBQ3RCLEtBQUssRUFBRSxDQUFDLENBQUMsTUFBTSxFQUFFO1lBQ2pCLGtCQUFrQixFQUFFLENBQUMsQ0FBQyxNQUFNLEVBQUU7WUFDOUIsWUFBWSxFQUFFLENBQUMsQ0FBQyxLQUFLLENBQUMsQ0FBQyxDQUFDLE1BQU0sQ0FBQztnQkFDN0IsUUFBUSxFQUFFLENBQUMsQ0FBQyxLQUFLLENBQUMsQ0FBQyxDQUFDLENBQUMsTUFBTSxFQUFFLEVBQUUsQ0FBQyxDQUFDLE1BQU0sRUFBRSxFQUFFLENBQUMsQ0FBQyxNQUFNLEVBQUUsQ0FBQyxDQUFDO2dCQUN2RCxJQUFJLEVBQUUsQ0FBQyxDQUFDLE1BQU0sRUFBRTtnQkFDaEIsU0FBUyxFQUFFLENBQUMsQ0FBQyxNQUFNLEVBQUU7Z0JBQ3JCLEtBQUssRUFBRSxDQUFDLENBQUMsS0FBSyxDQUFDLENBQUMsQ0FBQyxDQUFDLE1BQU0sRUFBRSxFQUFFLENBQUMsQ0FBQyxNQUFNLEVBQUUsRUFBRSxDQUFDLENBQUMsTUFBTSxFQUFFLENBQUMsQ0FBQzthQUNyRCxDQUFDLENBQUMsQ0FBQyxRQUFRLEVBQUU7WUFDZCw0Q0FBNEM7WUFDNUMsU0FBUyxFQUFFLENBQUMsQ0FBQyxNQUFNLEVBQUUsQ0FBQyxRQUFRLEVBQUU7WUFDaEMsYUFBYSxFQUFFLENBQUMsQ0FBQyxLQUFLLENBQUMsQ0FBQyxDQUFDLENBQUMsTUFBTSxFQUFFLEVBQUUsQ0FBQyxDQUFDLE1BQU0sRUFBRSxFQUFFLENBQUMsQ0FBQyxNQUFNLEVBQUUsQ0FBQyxDQUFDLENBQUMsUUFBUSxFQUFFO1lBQ3ZFLGtCQUFrQixFQUFFLENBQUMsQ0FBQyxPQUFPLEVBQUU7WUFDL0Isb0JBQW9CLEVBQUUsQ0FBQyxDQUFDLE9BQU8sRUFBRTtZQUNqQyxtQkFBbUIsRUFBRSxDQUFDLENBQUMsT0FBTyxFQUFFO1lBQ2hDLGVBQWUsRUFBRSxDQUFDLENBQUMsTUFBTSxFQUFFO1NBQzVCLENBQUM7S0FDSCxDQUFDO0lBQ0YsUUFBUSxFQUFFLENBQUMsQ0FBQyxNQUFNLENBQUM7UUFDakIsV0FBVyxFQUFFLENBQUMsQ0FBQyxNQUFNLEVBQUU7UUFDdkIsS0FBSyxFQUFFLENBQUMsQ0FBQyxNQUFNLEVBQUU7UUFDakIsTUFBTSxFQUFFLENBQUMsQ0FBQyxNQUFNLEVBQUU7UUFDbEIsTUFBTSxFQUFFLENBQUMsQ0FBQyxNQUFNLEVBQUU7UUFDbEIsVUFBVSxFQUFFLENBQUMsQ0FBQyxNQUFNLEVBQUU7S0FDdkIsQ0FBQztJQUNGLFlBQVksRUFBRSxDQUFDLENBQUMsTUFBTSxDQUFDLENBQUMsQ0FBQyxNQUFNLEVBQUUsRUFBRSxDQUFDLENBQUMsTUFBTSxDQUFDO1FBQzFDLFNBQVMsRUFBRSxDQUFDLENBQUMsTUFBTSxFQUFFO1FBQ3JCLFNBQVMsRUFBRSxDQUFDLENBQUMsTUFBTSxFQUFFO1FBQ3JCLFFBQVEsRUFBRSxDQUFDLENBQUMsTUFBTSxDQUFDO1lBQ2pCLEdBQUcsRUFBRSxDQUFDLENBQUMsS0FBSyxDQUFDLENBQUMsQ0FBQyxDQUFDLE1BQU0sRUFBRSxFQUFFLENBQUMsQ0FBQyxNQUFNLEVBQUUsQ0FBQyxDQUFDO1lBQ3RDLEdBQUcsRUFBRSxDQUFDLENBQUMsS0FBSyxDQUFDLENBQUMsQ0FBQyxDQUFDLE1BQU0sRUFBRSxFQUFFLENBQUMsQ0FBQyxNQUFNLEVBQUUsQ0FBQyxDQUFDO1NBQ3ZDLENBQUM7S0FDSCxDQUFDLENBQUM7SUFDSCxPQUFPLEVBQUUsQ0FBQyxDQUFDLE1BQU0sQ0FBQyxDQUFDLENBQUMsTUFBTSxFQUFFLEVBQUUsQ0FBQyxDQUFDLEtBQUssQ0FBQyxDQUFDLENBQUMsTUFBTSxDQUFDO1FBQzdDLFNBQVMsRUFBRSxDQUFDLENBQUMsTUFBTSxFQUFFO1FBQ3JCLFdBQVcsRUFBRSxDQUFDLENBQUMsTUFBTSxFQUFFO1FBQ3ZCLGNBQWMsRUFBRSxDQUFDLENBQUMsS0FBSyxDQUFDLENBQUMsQ0FBQyxNQUFNLEVBQUUsQ0FBQyxFQUFFLDRCQUE0QjtRQUNqRSxrQkFBa0IsRUFBRSxDQUFDLENBQUMsTUFBTSxDQUFDO1lBQzNCLGFBQWEsRUFBRSxDQUFDLENBQUMsTUFBTSxFQUFFO1lBQ3pCLFdBQVcsRUFBRSxDQUFDLENBQUMsTUFBTSxFQUFFO1lBQ3ZCLEtBQUssRUFBRSxDQUFDLENBQUMsT0FBTyxFQUFFO1NBQ25CLENBQUMsQ0FBQyxRQUFRLEVBQUUsRUFBRSxpQkFBaUI7S0FDakMsQ0FBQyxDQUFDLENBQUM7Q0FDTCxDQUFDLENBQUMsTUFBTSxFQUFFLENBQUM7QUE2RFo7O0dBRUc7QUFDSCxNQUFNLFVBQVUsb0JBQW9CLENBQUMsSUFBUztJQUM1QyxNQUFNLE1BQU0sR0FBRyxjQUFjLENBQUMsU0FBUyxDQUFDLElBQUksQ0FBQyxDQUFDO0lBQzlDLElBQUksQ0FBQyxNQUFNLENBQUMsT0FBTyxFQUFFLENBQUM7UUFDcEIsTUFBTSxJQUFJLEtBQUssQ0FBQywwQkFBMEIsTUFBTSxDQUFDLEtBQUssQ0FBQyxPQUFPLEVBQUUsQ0FBQyxDQUFDO0lBQ3BFLENBQUM7SUFDRCxPQUFPLE1BQU0sQ0FBQyxJQUFJLENBQUM7QUFDckIsQ0FBQztBQUVEOztHQUVHO0FBQ0gsTUFBTSxVQUFVLGlCQUFpQixDQUFDLE1BQW9CO0lBQ3BELE1BQU0sT0FBTyxHQUFHLE1BQU0sQ0FBQyxHQUFHLENBQUMsS0FBSyxDQUFDLEVBQUUsQ0FBQyxDQUFDO1FBQ25DLElBQUksRUFBRSxLQUFLLENBQUMsSUFBSTtRQUNoQixRQUFRLEVBQUUsS0FBSyxDQUFDLGFBQWEsQ0FBQyxRQUFRLENBQUMsT0FBTyxFQUFFO1FBQ2hELFFBQVEsRUFBRSxLQUFLLENBQUMsYUFBYSxDQUFDLFFBQVEsQ0FBQyxPQUFPLEVBQUU7UUFDaEQsS0FBSyxFQUFFLEtBQUssQ0FBQyxhQUFhLENBQUMsS0FBSyxDQUFDLE9BQU8sRUFBRTtLQUMzQyxDQUFDLENBQUMsQ0FBQztJQUVKLG1GQUFtRjtJQUNuRixNQUFNLFVBQVUsR0FBRyxJQUFJLENBQUMsU0FBUyxDQUFDLE9BQU8sQ0FBQyxDQUFDO0lBQzNDLElBQUksSUFBSSxHQUFHLENBQUMsQ0FBQztJQUNiLEtBQUssSUFBSSxDQUFDLEdBQUcsQ0FBQyxFQUFFLENBQUMsR0FBRyxVQUFVLENBQUMsTUFBTSxFQUFFLENBQUMsRUFBRSxFQUFFLENBQUM7UUFDM0MsTUFBTSxJQUFJLEdBQUcsVUFBVSxDQUFDLFVBQVUsQ0FBQyxDQUFDLENBQUMsQ0FBQztRQUN0QyxJQUFJLEdBQUcsQ0FBQyxDQUFDLElBQUksSUFBSSxDQUFDLENBQUMsR0FBRyxJQUFJLENBQUMsR0FBRyxJQUFJLENBQUM7UUFDbkMsSUFBSSxHQUFHLElBQUksR0FBRyxJQUFJLENBQUMsQ0FBQyw0QkFBNEI7SUFDbEQsQ0FBQztJQUNELE9BQU8sSUFBSSxDQUFDLEdBQUcsQ0FBQyxJQUFJLENBQUMsQ0FBQyxRQUFRLENBQUMsRUFBRSxDQUFDLENBQUM7QUFDckMsQ0FBQztBQUVEOztHQUVHO0FBQ0gsTUFBTSxVQUFVLGtCQUFrQixDQUFDLE1BQW9CLEVBQUUsTUFBb0I7SUFDM0UsTUFBTSxRQUFRLEdBQUcsSUFBSSxHQUFHLEVBQXVCLENBQUM7SUFFaEQsS0FBSyxNQUFNLEtBQUssSUFBSSxNQUFNLEVBQUUsQ0FBQztRQUMzQiw2QkFBNkI7UUFDN0IsTUFBTSxXQUFXLEdBQUcsa0JBQWtCLENBQUMsS0FBSyxDQUFDLENBQUM7UUFFOUMsV0FBVyxDQUFDLE9BQU8sQ0FBQyxDQUFDLElBQUksRUFBRSxjQUFjLEVBQUUsRUFBRTtZQUMzQyxJQUFJLE1BQU0sQ0FBQyxRQUFRLENBQUMsSUFBSSxDQUFDLEVBQUUsQ0FBQztnQkFDMUIsMkNBQTJDO2dCQUMzQyxNQUFNLFFBQVEsR0FBRyxpQkFBaUIsQ0FBQyxJQUFJLENBQUMsQ0FBQztnQkFFekMsUUFBUSxDQUFDLEdBQUcsQ0FBQyxHQUFHLEtBQUssQ0FBQyxJQUFJLElBQUksY0FBYyxFQUFFLEVBQUU7b0JBQzlDLFNBQVMsRUFBRSxLQUFLLENBQUMsSUFBSTtvQkFDckIsU0FBUyxFQUFFLGNBQWMsRUFBRSx1Q0FBdUM7b0JBQ2xFLFFBQVEsRUFBRSxRQUFRO2lCQUNuQixDQUFDLENBQUM7WUFDTCxDQUFDO1FBQ0gsQ0FBQyxDQUFDLENBQUM7SUFDTCxDQUFDO0lBRUQsT0FBTyxRQUFRLENBQUM7QUFDbEIsQ0FBQztBQUVEOztHQUVHO0FBQ0gsTUFBTSxVQUFVLGNBQWMsQ0FBQyxNQUFvQixFQUFFLE1BQW9CO0lBQ3ZFLE1BQU0sVUFBVSxHQUFlLEVBQUUsQ0FBQztJQUVsQyxLQUFLLE1BQU0sS0FBSyxJQUFJLE1BQU0sRUFBRSxDQUFDO1FBQzNCLE1BQU0sV0FBVyxHQUFHLGtCQUFrQixDQUFDLEtBQUssQ0FBQyxDQUFDO1FBQzlDLE1BQU0sWUFBWSxHQUFrQixFQUFFLENBQUM7UUFFdkMsV0FBVyxDQUFDLE9BQU8sQ0FBQyxDQUFDLElBQUksRUFBRSxTQUFTLEVBQUUsRUFBRTtZQUN0QyxJQUFJLE1BQU0sQ0FBQyxRQUFRLENBQUMsSUFBSSxDQUFDLEVBQUUsQ0FBQztnQkFDMUIsTUFBTSxZQUFZLEdBQUcsSUFBSSxDQUFDLFFBQVEsQ0FBQyxZQUFZLENBQUMsS0FBSyxDQUEwQixDQUFDO2dCQUVoRixJQUFJLFlBQVksRUFBRSxDQUFDO29CQUNqQixNQUFNLFFBQVEsR0FBRyxJQUFJLENBQUMsUUFBUSxDQUFDO29CQUUvQixZQUFZLENBQUMsSUFBSSxDQUFDO3dCQUNoQixTQUFTLEVBQUUsU0FBUzt3QkFDcEIsV0FBVyxFQUFFLFlBQVksQ0FBQyxLQUFLO3dCQUMvQixjQUFjLEVBQUUsS0FBSyxDQUFDLElBQUksQ0FBQyxZQUFZLENBQUMsS0FBSyxDQUFDO3dCQUM5QyxrQkFBa0IsRUFBRTs0QkFDbEIsYUFBYSxFQUFFLFFBQVEsQ0FBQyxZQUFZLENBQUMsVUFBVSxDQUFDLEVBQUUsS0FBSyxJQUFJLENBQUM7NEJBQzVELFdBQVcsRUFBRSxRQUFRLENBQUMsWUFBWSxDQUFDLFFBQVEsQ0FBQyxFQUFFLEtBQUssSUFBSSxDQUFDOzRCQUN4RCxLQUFLLEVBQUUsQ0FBQyxDQUFDLFFBQVEsQ0FBQyxZQUFZLENBQUMsSUFBSSxDQUFDO3lCQUNyQztxQkFDRixDQUFDLENBQUM7Z0JBQ0wsQ0FBQztZQUNILENBQUM7UUFDSCxDQUFDLENBQUMsQ0FBQztRQUVILElBQUksWUFBWSxDQUFDLE1BQU0sR0FBRyxDQUFDLEVBQUUsQ0FBQztZQUM1QixVQUFVLENBQUMsS0FBSyxDQUFDLElBQUksQ0FBQyxHQUFHLFlBQVksQ0FBQztRQUN4QyxDQUFDO0lBQ0gsQ0FBQztJQUVELE9BQU8sVUFBVSxDQUFDO0FBQ3BCLENBQUM7QUFFRDs7R0FFRztBQUNILE1BQU0sVUFBVSxjQUFjLENBQUMsTUFBb0IsRUFBRSxVQUFzQjtJQUN6RSxLQUFLLE1BQU0sS0FBSyxJQUFJLE1BQU0sRUFBRSxDQUFDO1FBQzNCLE1BQU0sWUFBWSxHQUFHLFVBQVUsQ0FBQyxLQUFLLENBQUMsSUFBSSxDQUFDLENBQUM7UUFFNUMsSUFBSSxZQUFZLEVBQUUsQ0FBQztZQUNqQixNQUFNLFdBQVcsR0FBRyxrQkFBa0IsQ0FBQyxLQUFLLENBQUMsQ0FBQztZQUU5QyxLQUFLLE1BQU0sT0FBTyxJQUFJLFlBQVksRUFBRSxDQUFDO2dCQUNuQyxNQUFNLElBQUksR0FBRyxXQUFXLENBQUMsT0FBTyxDQUFDLFNBQVMsQ0FBQyxDQUFDO2dCQUU1QyxJQUFJLElBQUksRUFBRSxDQUFDO29CQUNULDZEQUE2RDtvQkFDN0QsSUFBSSxPQUFPLENBQUMsa0JBQWtCLEVBQUUsQ0FBQzt3QkFDL0IsTUFBTSxlQUFlLEdBQUcsSUFBSSxDQUFDLFFBQVEsQ0FBQzt3QkFDdEMsTUFBTSxhQUFhLEdBQUcsZUFBZSxDQUFDLFlBQVksQ0FBQyxVQUFVLENBQUMsRUFBRSxLQUFLLElBQUksQ0FBQyxDQUFDO3dCQUMzRSxNQUFNLFdBQVcsR0FBRyxlQUFlLENBQUMsWUFBWSxDQUFDLFFBQVEsQ0FBQyxFQUFFLEtBQUssSUFBSSxDQUFDLENBQUM7d0JBRXZFLElBQUksYUFBYSxLQUFLLE9BQU8sQ0FBQyxrQkFBa0IsQ0FBQyxhQUFhOzRCQUMxRCxXQUFXLEtBQUssT0FBTyxDQUFDLGtCQUFrQixDQUFDLFdBQVcsRUFBRSxDQUFDOzRCQUMzRCxPQUFPLENBQUMsSUFBSSxDQUFDLCtCQUErQixLQUFLLENBQUMsSUFBSSxVQUFVLE9BQU8sQ0FBQyxTQUFTLEdBQUcsQ0FBQyxDQUFDOzRCQUN0RixPQUFPLENBQUMsSUFBSSxDQUFDLHdCQUF3QixPQUFPLENBQUMsa0JBQWtCLENBQUMsYUFBYSxZQUFZLE9BQU8sQ0FBQyxrQkFBa0IsQ0FBQyxXQUFXLEVBQUUsQ0FBQyxDQUFDOzRCQUNuSSxPQUFPLENBQUMsSUFBSSxDQUFDLHdCQUF3QixhQUFhLFlBQVksV0FBVyxFQUFFLENBQUMsQ0FBQzs0QkFDN0UsT0FBTyxDQUFDLElBQUksQ0FBQyx1QkFBdUIsT0FBTyxDQUFDLFdBQVcsRUFBRSxDQUFDLENBQUM7NEJBQzNELE9BQU8sQ0FBQyxJQUFJLENBQUMsOERBQThELENBQUMsQ0FBQzt3QkFDL0UsQ0FBQztvQkFDSCxDQUFDO29CQUVELDBCQUEwQjtvQkFDMUIsTUFBTSxRQUFRLEdBQUcsSUFBSSxZQUFZLENBQUMsT0FBTyxDQUFDLGNBQWMsQ0FBQyxDQUFDO29CQUMxRCxNQUFNLFlBQVksR0FBRyxJQUFJLEtBQUssQ0FBQyxlQUFlLENBQUMsUUFBUSxFQUFFLENBQUMsQ0FBQyxDQUFDO29CQUM1RCxJQUFJLENBQUMsUUFBUSxDQUFDLFlBQVksQ0FBQyxLQUFLLEVBQUUsWUFBWSxDQUFDLENBQUM7Z0JBQ2xELENBQUM7cUJBQU0sQ0FBQztvQkFDTixPQUFPLENBQUMsSUFBSSxDQUFDLCtCQUErQixLQUFLLENBQUMsSUFBSSxnQkFBZ0IsT0FBTyxDQUFDLFNBQVMsRUFBRSxDQUFDLENBQUM7Z0JBQzdGLENBQUM7WUFDSCxDQUFDO1FBQ0gsQ0FBQztJQUNILENBQUM7QUFDSCxDQUFDO0FBRUQ7OztHQUdHO0FBQ0gsU0FBUyxrQkFBa0IsQ0FBQyxLQUFpQjtJQUMzQyxNQUFNLE1BQU0sR0FBaUIsRUFBRSxDQUFDO0lBRWhDLDBCQUEwQjtJQUMxQixJQUFLLEtBQWEsQ0FBQyxnQkFBZ0IsRUFBRSxDQUFDO1FBQ3BDLE1BQU0sYUFBYSxHQUFJLEtBQWEsQ0FBQyxnQkFBZ0IsRUFBRSxDQUFDO1FBQ3hELElBQUksYUFBYSxFQUFFLENBQUM7WUFDbEIsTUFBTSxLQUFLLEdBQUcsYUFBYSxDQUFDLFFBQVEsRUFBRSxDQUFDO1lBQ3ZDLElBQUksS0FBSyxFQUFFLENBQUM7Z0JBQ1YsS0FBSyxDQUFDLFFBQVEsQ0FBQyxDQUFDLEtBQXFCLEVBQUUsRUFBRTtvQkFDdkMsSUFBSSxLQUFLLFlBQVksS0FBSyxDQUFDLElBQUksRUFBRSxDQUFDO3dCQUNoQyxNQUFNLENBQUMsSUFBSSxDQUFDLEtBQUssQ0FBQyxDQUFDO29CQUNyQixDQUFDO2dCQUNILENBQUMsQ0FBQyxDQUFDO1lBQ0wsQ0FBQztRQUNILENBQUM7SUFDSCxDQUFDO0lBRUQsNkNBQTZDO0lBQzdDLE1BQU0sYUFBYSxHQUFHLEtBQUssQ0FBQyxhQUFhLENBQUM7SUFDMUMsSUFBSSxhQUFhLElBQUksU0FBUyxJQUFJLGFBQWEsRUFBRSxDQUFDO1FBQ2hELE1BQU0sSUFBSSxHQUFJLGFBQXFCLENBQUMsT0FBTyxFQUFFLENBQUM7UUFDOUMsSUFBSSxJQUFJLFlBQVksS0FBSyxDQUFDLElBQUksRUFBRSxDQUFDO1lBQy9CLE1BQU0sQ0FBQyxJQUFJLENBQUMsSUFBSSxDQUFDLENBQUM7UUFDcEIsQ0FBQztJQUNILENBQUM7SUFFRCwrRkFBK0Y7SUFDL0YsT0FBTyxNQUFNLENBQUMsTUFBTSxDQUFDLElBQUksQ0FBQyxFQUFFLENBQUMsSUFBSSxDQUFDLFFBQVEsSUFBSSxJQUFJLENBQUMsT0FBTyxDQUFDLENBQUM7QUFDOUQsQ0FBQztBQUVEOztHQUVHO0FBQ0gsU0FBUyxpQkFBaUIsQ0FBQyxJQUFnQjtJQUN6QyxNQUFNLFlBQVksR0FBRyxJQUFJLENBQUMsUUFBUSxDQUFDLFlBQVksQ0FBQyxLQUFLLENBQUMsQ0FBQztJQUN2RCxJQUFJLENBQUMsWUFBWSxFQUFFLENBQUM7UUFDbEIsT0FBTyxFQUFFLEdBQUcsRUFBRSxDQUFDLENBQUMsRUFBRSxDQUFDLENBQUMsRUFBRSxHQUFHLEVBQUUsQ0FBQyxDQUFDLEVBQUUsQ0FBQyxDQUFDLEVBQUUsQ0FBQyxDQUFDLGlCQUFpQjtJQUN4RCxDQUFDO0lBRUQsSUFBSSxJQUFJLEdBQUcsUUFBUSxFQUFFLElBQUksR0FBRyxRQUFRLENBQUM7SUFDckMsSUFBSSxJQUFJLEdBQUcsQ0FBQyxRQUFRLEVBQUUsSUFBSSxHQUFHLENBQUMsUUFBUSxDQUFDO0lBRXZDLEtBQUssSUFBSSxDQUFDLEdBQUcsQ0FBQyxFQUFFLENBQUMsR0FBRyxZQUFZLENBQUMsS0FBSyxFQUFFLENBQUMsRUFBRSxFQUFFLENBQUM7UUFDNUMsTUFBTSxDQUFDLEdBQUcsWUFBWSxDQUFDLElBQUksQ0FBQyxDQUFDLENBQUMsQ0FBQztRQUMvQixNQUFNLENBQUMsR0FBRyxZQUFZLENBQUMsSUFBSSxDQUFDLENBQUMsQ0FBQyxDQUFDO1FBRS9CLElBQUksR0FBRyxJQUFJLENBQUMsR0FBRyxDQUFDLElBQUksRUFBRSxDQUFDLENBQUMsQ0FBQztRQUN6QixJQUFJLEdBQUcsSUFBSSxDQUFDLEdBQUcsQ0FBQyxJQUFJLEVBQUUsQ0FBQyxDQUFDLENBQUM7UUFDekIsSUFBSSxHQUFHLElBQUksQ0FBQyxHQUFHLENBQUMsSUFBSSxFQUFFLENBQUMsQ0FBQyxDQUFDO1FBQ3pCLElBQUksR0FBRyxJQUFJLENBQUMsR0FBRyxDQUFDLElBQUksRUFBRSxDQUFDLENBQUMsQ0FBQztJQUMzQixDQUFDO0lBRUQsT0FBTztRQUNMLEdBQUcsRUFBRSxDQUFDLElBQUksRUFBRSxJQUFJLENBQUM7UUFDakIsR0FBRyxFQUFFLENBQUMsSUFBSSxFQUFFLElBQUksQ0FBQztLQUNsQixDQUFDO0FBQ0osQ0FBQyJ9

package/dist/src/render/lightmapping/LightmapSerializer.d.ts

@@ -0,0 +1,94 @@
+/**
+ * LightmapSerializer handles the conversion of lightmap data to and from files.
+ *
+ * This class provides the core export/import functionality:
+ * - Converts runtime lightmap data to serializable format
+ * - Saves lightmap textures as separate image files
+ * - Loads lightmap data and reconstructs textures
+ * - Manages file paths and naming conventions
+ */
+import * as THREE from 'three';
+import { type LightmapExportData, type LightmapImportResult } from './LightmapSerialization.js';
+/**
+ * Options for lightmap export
+ */
+export interface LightmapExportOptions {
+    /** Custom base filename for export (without extension) */
+    baseFileName?: string;
+    /** Whether to include scene hash for change detection */
+    includeSceneHash?: boolean;
+}
+/**
+ * Result of lightmap data export
+ */
+export interface LightmapDataExportResult {
+    /** The lightmap metadata as a JSON string */
+    metadataJson: string;
+    /** The lightmap texture data as binary blob */
+    textureBlob: Blob;
+    /** Suggested filename for the metadata file */
+    metadataFileName: string;
+    /** Suggested filename for the texture file */
+    textureFileName: string;
+}
+/**
+ * Options for lightmap import
+ */
+export interface LightmapImportOptions {
+    /** Whether to validate scene hash against current scene */
+    validateSceneHash?: boolean;
+    /** Callback for progress reporting */
+    onProgress?: (stage: string, progress: number) => void;
+}
+/**
+ * Handles serialization and deserialization of lightmap data
+ */
+export declare class LightmapSerializer {
+    private static readonly LIGHTMAP_VERSION;
+    private static readonly BINARY_FORMAT;
+    /**
+     * Exports lightmap data
+     * @param exportData The lightmap data to export
+     * @param options Export options
+     * @param renderer WebGL renderer for reading render target data
+     * @returns Promise resolving to the lightmap data that can be handled by the caller
+     */
+    static exportLightmapData(exportData: LightmapExportData, options: LightmapExportOptions | undefined, renderer: THREE.WebGLRenderer): Promise<LightmapDataExportResult>;
+    /**
+     * Imports lightmap data from provided file data
+     * @param lightmapJsonData The parsed lightmap metadata JSON
+     * @param textureData The binary texture data as ArrayBuffer
+     * @param options Import options
+     * @returns Promise resolving to lightmap import result
+     */
+    static importLightmap(lightmapJsonData: any, textureData: ArrayBuffer, options?: LightmapImportOptions): Promise<LightmapImportResult>;
+    /**
+     * Checks if a lightmap file exists for the given scene path
+     * Note: This method is deprecated. File existence should be checked at the application level.
+     * @param scenePath Path to the scene file
+     * @returns Promise resolving to false (deprecated functionality)
+     */
+    static lightmapExists(scenePath: string): Promise<boolean>;
+    /**
+     * Gets the lightmap file path for a given scene path
+     * @param scenePath Path to the scene file
+     * @returns Path to the corresponding lightmap file
+     */
+    static getLightmapPath(scenePath: string): string;
+    /**
+     * Imports a texture from a provided ArrayBuffer
+     */
+    private static importTextureFromBuffer;
+    /**
+     * Exports a THREE.js texture as high-precision binary data
+     */
+    private static exportTextureAsBinary;
+    /**
+     * Converts a map of mesh mappings to a serializable format
+     */
+    private static serializeMeshMappings;
+    /**
+     * Converts a serialized mesh mappings object back to a Map
+     */
+    private static deserializeMeshMappings;
+}

package/dist/src/render/lightmapping/LightmapSerializer.js

@@ -0,0 +1,223 @@
+/**
+ * LightmapSerializer handles the conversion of lightmap data to and from files.
+ *
+ * This class provides the core export/import functionality:
+ * - Converts runtime lightmap data to serializable format
+ * - Saves lightmap textures as separate image files
+ * - Loads lightmap data and reconstructs textures
+ * - Manages file paths and naming conventions
+ */
+import * as THREE from 'three';
+import { generateSceneHash, validateLightmapData, } from './LightmapSerialization.js';
+/**
+ * Handles serialization and deserialization of lightmap data
+ */
+export class LightmapSerializer {
+    /**
+     * Exports lightmap data
+     * @param exportData The lightmap data to export
+     * @param options Export options
+     * @param renderer WebGL renderer for reading render target data
+     * @returns Promise resolving to the lightmap data that can be handled by the caller
+     */
+    static async exportLightmapData(exportData, options = {}, renderer) {
+        // Generate file names
+        const baseFileName = options.baseFileName ?? 'lightmap';
+        const lightmapFileName = `${baseFileName}.lightmap.json`;
+        const textureFileName = `${baseFileName}.lightmap`;
+        // Generate scene hash if requested
+        const sceneHash = options.includeSceneHash
+            ? generateSceneHash(exportData.actors)
+            : undefined;
+        // Export texture as high-precision binary data
+        const { textureBlob, width, height } = await this.exportTextureAsBinary(exportData.texture, renderer, exportData.renderTarget);
+        // Create lightmap metadata
+        const lightmapData = {
+            version: this.LIGHTMAP_VERSION,
+            metadata: {
+                exportDate: new Date().toISOString(),
+                sceneHash: sceneHash,
+                bakingOptions: {
+                    resolution: exportData.bakingOptions.resolution,
+                    casts: exportData.bakingOptions.casts,
+                    progressiveSamples: exportData.bakingOptions.progressiveSamples ?? 100,
+                    lightSources: exportData.bakingOptions.lightSources.map(light => ({
+                        position: [light.position.x, light.position.y, light.position.z],
+                        size: light.size,
+                        intensity: light.intensity ?? 1.0,
+                        color: light.color ? [light.color.x, light.color.y, light.color.z] : [1, 1, 1]
+                    })),
+                    directLightEnabled: exportData.bakingOptions.directLightEnabled,
+                    indirectLightEnabled: exportData.bakingOptions.indirectLightEnabled,
+                    ambientLightEnabled: exportData.bakingOptions.ambientLightEnabled,
+                    ambientDistance: exportData.bakingOptions.ambientDistance,
+                },
+            },
+            lightmap: {
+                textureFile: textureFileName,
+                width: width,
+                height: height,
+                format: this.BINARY_FORMAT,
+                filterMode: exportData.bakingOptions.filterMode,
+            },
+            meshMappings: this.serializeMeshMappings(exportData.meshMappings),
+            uv2Data: exportData.uv2Data ?? {},
+        };
+        return {
+            metadataJson: JSON.stringify(lightmapData, null, 2),
+            textureBlob,
+            metadataFileName: lightmapFileName,
+            textureFileName: textureFileName,
+        };
+    }
+    /**
+     * Imports lightmap data from provided file data
+     * @param lightmapJsonData The parsed lightmap metadata JSON
+     * @param textureData The binary texture data as ArrayBuffer
+     * @param options Import options
+     * @returns Promise resolving to lightmap import result
+     */
+    static async importLightmap(lightmapJsonData, textureData, options = {}) {
+        options.onProgress?.('loading', 10);
+        // Validate lightmap metadata
+        const validatedData = validateLightmapData(lightmapJsonData);
+        options.onProgress?.('loading', 30);
+        // Load texture from provided data
+        const texture = await this.importTextureFromBuffer(textureData, validatedData.lightmap);
+        options.onProgress?.('loading', 70);
+        // Deserialize mesh mappings
+        const meshMappings = this.deserializeMeshMappings(validatedData.meshMappings);
+        options.onProgress?.('loading', 90);
+        // Reconstruct baking options
+        const bakingOptions = {
+            resolution: validatedData.metadata.bakingOptions.resolution,
+            casts: validatedData.metadata.bakingOptions.casts,
+            progressiveSamples: validatedData.metadata.bakingOptions.progressiveSamples,
+            lightSources: validatedData.metadata.bakingOptions.lightSources?.map((light) => ({
+                position: new THREE.Vector3(...light.position),
+                size: light.size,
+                intensity: light.intensity,
+                color: new THREE.Vector3(...light.color)
+            })) ?? [{
+                    position: new THREE.Vector3(...validatedData.metadata.bakingOptions.lightPosition ?? [10, 10, 10]),
+                    size: validatedData.metadata.bakingOptions.lightSize ?? 0.5,
+                    intensity: 1.0,
+                    color: new THREE.Vector3(1, 1, 1)
+                }],
+            directLightEnabled: validatedData.metadata.bakingOptions.directLightEnabled,
+            indirectLightEnabled: validatedData.metadata.bakingOptions.indirectLightEnabled,
+            ambientLightEnabled: validatedData.metadata.bakingOptions.ambientLightEnabled,
+            ambientDistance: validatedData.metadata.bakingOptions.ambientDistance,
+            filterMode: validatedData.lightmap.filterMode,
+        };
+        options.onProgress?.('loading', 100);
+        return {
+            texture,
+            bakingOptions,
+            meshMappings,
+            textureFile: validatedData.lightmap.textureFile,
+            uv2Data: validatedData.uv2Data,
+        };
+    }
+    /**
+     * Checks if a lightmap file exists for the given scene path
+     * Note: This method is deprecated. File existence should be checked at the application level.
+     * @param scenePath Path to the scene file
+     * @returns Promise resolving to false (deprecated functionality)
+     */
+    static async lightmapExists(scenePath) {
+        console.warn('LightmapSerializer.lightmapExists() is deprecated. Check file existence at the application level.');
+        return false;
+    }
+    /**
+     * Gets the lightmap file path for a given scene path
+     * @param scenePath Path to the scene file
+     * @returns Path to the corresponding lightmap file
+     */
+    static getLightmapPath(scenePath) {
+        const pathWithoutExt = scenePath.replace(/\.[^.]+$/, '');
+        return `${pathWithoutExt}.lightmap.json`;
+    }
+    /**
+     * Imports a texture from a provided ArrayBuffer
+     */
+    static async importTextureFromBuffer(textureData, lightmapInfo) {
+        // Only binary format is supported
+        if (lightmapInfo.format !== this.BINARY_FORMAT) {
+            throw new Error(`Unsupported lightmap format: ${lightmapInfo.format}. Only '${this.BINARY_FORMAT}' is supported.`);
+        }
+        const float32Array = new Float32Array(textureData);
+        // Validate array size
+        const expectedSize = lightmapInfo.width * lightmapInfo.height * 4; // RGBA
+        if (float32Array.length !== expectedSize) {
+            throw new Error(`Binary texture size mismatch. Expected ${expectedSize} floats, got ${float32Array.length}`);
+        }
+        // Create DataTexture with the loaded data
+        const dataTexture = new THREE.DataTexture(float32Array, lightmapInfo.width, lightmapInfo.height, THREE.RGBAFormat, THREE.FloatType);
+        // Apply stored settings
+        const filterMode = lightmapInfo.filterMode;
+        if (filterMode === THREE.NearestFilter || filterMode === THREE.LinearFilter) {
+            dataTexture.magFilter = filterMode;
+        }
+        dataTexture.minFilter = filterMode;
+        dataTexture.generateMipmaps = lightmapInfo.filterMode >= THREE.NearestMipmapNearestFilter;
+        dataTexture.flipY = false;
+        dataTexture.needsUpdate = true;
+        return dataTexture;
+    }
+    /**
+     * Exports a THREE.js texture as high-precision binary data
+     */
+    static async exportTextureAsBinary(texture, renderer, renderTarget) {
+        // Get texture dimensions
+        const width = texture.image?.width ?? 512;
+        const height = texture.image?.height ?? 512;
+        // Read pixels as Float32Array from render target
+        const pixelBuffer = new Float32Array(width * height * 4); // RGBA
+        // Direct reading from the original render target
+        const originalTarget = renderer.getRenderTarget();
+        renderer.setRenderTarget(renderTarget);
+        renderer.readRenderTargetPixels(renderTarget, 0, 0, width, height, pixelBuffer);
+        renderer.setRenderTarget(originalTarget);
+        // Create blob from Float32Array
+        const blob = new Blob([pixelBuffer.buffer], { type: 'application/octet-stream' });
+        return {
+            textureBlob: blob,
+            width,
+            height,
+        };
+    }
+    /**
+     * Converts a map of mesh mappings to a serializable format
+     */
+    static serializeMeshMappings(meshMappings) {
+        const result = {};
+        for (const [key, value] of meshMappings) {
+            result[key] = value;
+        }
+        return result;
+    }
+    /**
+     * Converts a serialized mesh mappings object back to a Map
+     */
+    static deserializeMeshMappings(serializedMappings) {
+        const result = new Map();
+        for (const [key, value] of Object.entries(serializedMappings)) {
+            result.set(key, value);
+        }
+        return result;
+    }
+}
+Object.defineProperty(LightmapSerializer, "LIGHTMAP_VERSION", {
+    enumerable: true,
+    configurable: true,
+    writable: true,
+    value: '1.0.0'
+});
+Object.defineProperty(LightmapSerializer, "BINARY_FORMAT", {
+    enumerable: true,
+    configurable: true,
+    writable: true,
+    value: 'float32'
+});
+//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoiTGlnaHRtYXBTZXJpYWxpemVyLmpzIiwic291cmNlUm9vdCI6IiIsInNvdXJjZXMiOlsiLi4vLi4vLi4vLi4vc3JjL3JlbmRlci9saWdodG1hcHBpbmcvTGlnaHRtYXBTZXJpYWxpemVyLnRzIl0sIm5hbWVzIjpbXSwibWFwcGluZ3MiOiJBQUFBOzs7Ozs7OztHQVFHO0FBRUgsT0FBTyxLQUFLLEtBQUssTUFBTSxPQUFPLENBQUM7QUFFL0IsT0FBTyxFQUNMLGlCQUFpQixFQUtqQixvQkFBb0IsR0FDckIsTUFBTSw0QkFBNEIsQ0FBQztBQXNDcEM7O0dBRUc7QUFDSCxNQUFNLE9BQU8sa0JBQWtCO0lBSTdCOzs7Ozs7T0FNRztJQUNJLE1BQU0sQ0FBQyxLQUFLLENBQUMsa0JBQWtCLENBQ3BDLFVBQThCLEVBQzlCLFVBQWlDLEVBQUUsRUFDbkMsUUFBNkI7UUFFN0Isc0JBQXNCO1FBQ3RCLE1BQU0sWUFBWSxHQUFHLE9BQU8sQ0FBQyxZQUFZLElBQUksVUFBVSxDQUFDO1FBQ3hELE1BQU0sZ0JBQWdCLEdBQUcsR0FBRyxZQUFZLGdCQUFnQixDQUFDO1FBQ3pELE1BQU0sZUFBZSxHQUFHLEdBQUcsWUFBWSxXQUFXLENBQUM7UUFFbkQsbUNBQW1DO1FBQ25DLE1BQU0sU0FBUyxHQUFHLE9BQU8sQ0FBQyxnQkFBZ0I7WUFDeEMsQ0FBQyxDQUFDLGlCQUFpQixDQUFDLFVBQVUsQ0FBQyxNQUFNLENBQUM7WUFDdEMsQ0FBQyxDQUFDLFNBQVMsQ0FBQztRQUVkLCtDQUErQztRQUMvQyxNQUFNLEVBQUUsV0FBVyxFQUFFLEtBQUssRUFBRSxNQUFNLEVBQUUsR0FBRyxNQUFNLElBQUksQ0FBQyxxQkFBcUIsQ0FBQyxVQUFVLENBQUMsT0FBTyxFQUFFLFFBQVEsRUFBRSxVQUFVLENBQUMsWUFBWSxDQUFDLENBQUM7UUFFL0gsMkJBQTJCO1FBQzNCLE1BQU0sWUFBWSxHQUF1QjtZQUN2QyxPQUFPLEVBQUUsSUFBSSxDQUFDLGdCQUFnQjtZQUM5QixRQUFRLEVBQUU7Z0JBQ1Is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

package/dist/src/render/lightmapping/MultiLightmapperMaterial.d.ts

@@ -0,0 +1,41 @@
+import { ShaderMaterial } from 'three';
+import type { Color, Matrix4, Texture, Vector3 } from 'three';
+import type { MeshBVH } from 'three-mesh-bvh';
+/**
+ * Light data for multi-light lightmapping
+ */
+export interface LightData {
+    position: Vector3;
+    color: Color;
+    intensity: number;
+    size: number;
+    type: number;
+    distance: number;
+    decay: number;
+    angle: number;
+    penumbra: number;
+    direction: Vector3;
+    areaDimensions: [number, number];
+}
+export type MultiLightmapperMaterialOptions = {
+    bvh: MeshBVH;
+    invModelMatrix: Matrix4;
+    positions: Texture;
+    normals: Texture;
+    casts: number;
+    lights: LightData[];
+    maxLights: number;
+    opacity: number;
+    sampleIndex: number;
+    directLightEnabled: boolean;
+    indirectLightEnabled: boolean;
+    ambientLightEnabled: boolean;
+    ambientDistance: number;
+};
+/**
+ * Multi-light lightmapper material supporting DirectionalLight, PointLight, SpotLight, and RectAreaLight.
+ * This is vibe-coded so don't expect it to work or be efficient.
+ */
+export declare class MultiLightmapperMaterial extends ShaderMaterial {
+    constructor(options: MultiLightmapperMaterialOptions);
+}