@meimu/mutracer 0.0.0-stage → 0.1.0

package/lib/renderer/sceneChangeDetector.js

@@ -0,0 +1,232 @@
+import { openPbrSchema } from '../scene/openPbrSchema.js';
+import { materialParametersEqual, materialTexturesChanged } from './materialComparison.generated.js';
+export { materialParametersEqual } from './materialComparison.generated.js';
+import InstancedMesh from '../scene/InstancedMesh.js';
+import { materialTextureKeys } from '../scene/OpenPBRMaterial.js';
+import Texture from '../scene/Texture.js';
+/** Small scalar/identity snapshots for lights, backgrounds and texture metadata. */
+export function snapshotFields(object) {
+    const values = [object];
+    for (const key of Object.keys(object)) {
+        const value = object[key];
+        values.push(key);
+        if (value instanceof Texture)
+            values.push(...snapshotTexture(value));
+        else if (Array.isArray(value) || ArrayBuffer.isView(value)) {
+            values.push(...Array.from(value));
+        }
+        else
+            values.push(value);
+    }
+    return values;
+}
+function snapshotTexture(texture) {
+    return texture ? [texture, texture.version, texture.image, texture.flipY,
+        texture.uvScale, texture.uvOffset, texture.uvChannel] : [undefined];
+}
+export function snapshotsEqual(a, b) {
+    return a.length === b.length && a.every((v, i) => Object.is(v, b[i]));
+}
+function backgroundSnapshot(background) {
+    if (background instanceof Texture)
+        return snapshotTexture(background);
+    if (Array.isArray(background))
+        return [background, ...background];
+    return background ? snapshotFields(background) : [undefined];
+}
+function captureMaterialTextures(material, out) {
+    let i = 0;
+    for (const key of materialTextureKeys) {
+        const texture = material[key];
+        if (typeof texture === 'number')
+            continue;
+        if (!texture) {
+            out[i++] = undefined;
+            continue;
+        }
+        out[i++] = texture;
+        out[i++] = texture.version;
+        out[i++] = texture.image;
+        out[i++] = texture.flipY;
+        out[i++] = texture.uvScale;
+        out[i++] = texture.uvOffset;
+        out[i++] = texture.uvChannel;
+    }
+    out.length = i;
+}
+// Texture references and metadata have their own snapshot.
+const parameterKeys = openPbrSchema.filter(field => field.type !== 'texture').map(field => field.key);
+export function snapshotMaterialParameters(material, previous) {
+    return parameterKeys.map((key, index) => {
+        const value = material[key];
+        if (Array.isArray(value) || ArrayBuffer.isView(value)) {
+            const array = value, prior = previous?.[index];
+            if (Array.isArray(prior) && prior.length === array.length) {
+                let equal = true;
+                for (let i = 0; i < array.length; i++)
+                    if (!Object.is(array[i], prior[i])) {
+                        equal = false;
+                        break;
+                    }
+                if (equal)
+                    return prior;
+            }
+            return Array.from(array);
+        }
+        return value;
+    });
+}
+const geometryAttributes = ['position', 'normal', 'tangent', 'uv', 'uv1', 'color', 'indices', 'materialIndex'];
+function captureGeometryStorage(geometry, out) {
+    let i = 0;
+    for (const key of geometryAttributes) {
+        const attribute = geometry[key];
+        out[i++] = attribute?.array;
+        out[i++] = attribute?.array.length;
+        out[i++] = attribute?.itemSize;
+    }
+}
+function geometryStorageMatches(geometry, storage) {
+    let i = 0;
+    for (const key of geometryAttributes) {
+        const attribute = geometry[key];
+        if (storage[i++] !== attribute?.array || storage[i++] !== attribute?.array.length || storage[i++] !== attribute?.itemSize)
+            return false;
+    }
+    return true;
+}
+/** Detects edits without accepting them until the pipeline has received the scene. */
+export class SceneChangeDetector {
+    _snapshot;
+    _pending;
+    _spare;
+    _seen = new Set();
+    detect(scene) {
+        const old = this._snapshot;
+        let full = !old || old.meshList !== scene.meshes || old.meshes.length !== scene.meshes.length;
+        const transforms = [];
+        const colors = [];
+        const geometries = new Set();
+        const materials = [];
+        const seen = this._seen;
+        seen.clear();
+        for (let i = 0; i < scene.meshes.length; i++) {
+            const mesh = scene.meshes[i];
+            const prev = old?.meshes[i];
+            let instanceChanged = false;
+            if (mesh instanceof InstancedMesh) {
+                mesh.validate();
+                if (prev?.instanceCount !== mesh.count)
+                    full = true;
+                if (prev?.mesh === mesh && (prev.colorVersion !== mesh.colorsVersion || prev.instanceColors !== mesh.colors))
+                    colors.push(mesh);
+                if (prev?.mesh === mesh && (prev.instanceVersion !== mesh.transformsVersion || prev.instanceTransforms !== mesh.transforms)) {
+                    transforms.push(mesh);
+                    instanceChanged = true;
+                }
+            }
+            if (!prev || prev.mesh !== mesh || prev.geometry !== mesh.geometry ||
+                prev.dynamic !== mesh.geometry.dynamic || !geometryStorageMatches(mesh.geometry, prev.storage) || prev.materials.length !== mesh.materials.length ||
+                prev.materials.some((m, k) => m !== mesh.materials[k]))
+                full = true;
+            if (prev?.geometry === mesh.geometry && prev.version !== mesh.geometry.version)
+                geometries.add(mesh.geometry);
+            if (prev?.mesh === mesh) {
+                for (let k = 0; k < 16; k++) {
+                    if (!Object.is(mesh.transform[k], old.matrices[i * 16 + k])) {
+                        if (!instanceChanged)
+                            transforms.push(mesh);
+                        break;
+                    }
+                }
+            }
+            for (const material of mesh.materials) {
+                if (seen.has(material))
+                    continue;
+                seen.add(material);
+                const prior = old?.materials.get(material);
+                if (!prior || !materialParametersEqual(material, prior.values) ||
+                    materialTexturesChanged(material, prior.textures))
+                    materials.push(material);
+            }
+        }
+        const lights = scene.lights.map(snapshotFields);
+        const background = backgroundSnapshot(scene.background);
+        const changes = {
+            meshes: full ? 'full' : transforms.length || colors.length || materials.length || geometries.size ? 'incremental' : 'none',
+            transforms, colors, materials, geometries: [...geometries],
+            lights: !old || old.lightList !== scene.lights || lights.length !== old.lights.length ||
+                lights.some((light, i) => !snapshotsEqual(light, old.lights[i])),
+            background: !old || !snapshotsEqual(background, old.background)
+        };
+        if (changes.meshes !== 'none' || changes.lights || changes.background) {
+            // Write into the other buffer: detect never mutates committed state.
+            // Repeated detects without commit overwrite the same pending buffer.
+            let next = this._spare;
+            if (!next || next.meshList !== scene.meshes || next.meshes.length !== scene.meshes.length) {
+                next = { meshList: scene.meshes, meshes: [], matrices: new Float64Array(scene.meshes.length * 16),
+                    materials: new Map(), lightList: scene.lights, lights: [], background: [] };
+                this._spare = next;
+            }
+            scene.meshes.forEach((mesh, i) => {
+                let item = next.meshes[i];
+                if (!item) {
+                    item = { mesh, geometry: mesh.geometry, version: mesh.geometry.version, dynamic: mesh.geometry.dynamic, storage: [],
+                        materials: [] };
+                    next.meshes[i] = item;
+                }
+                item.mesh = mesh;
+                item.geometry = mesh.geometry;
+                item.version = mesh.geometry.version;
+                item.instanceVersion = mesh instanceof InstancedMesh ? mesh.transformsVersion : undefined;
+                item.colorVersion = mesh instanceof InstancedMesh ? mesh.colorsVersion : undefined;
+                item.instanceColors = mesh instanceof InstancedMesh ? mesh.colors : undefined;
+                item.instanceCount = mesh instanceof InstancedMesh ? mesh.count : undefined;
+                item.instanceTransforms = mesh instanceof InstancedMesh ? mesh.transforms : undefined;
+                item.dynamic = mesh.geometry.dynamic;
+                captureGeometryStorage(mesh.geometry, item.storage);
+                item.materials.length = mesh.materials.length;
+                for (let k = 0; k < mesh.materials.length; k++)
+                    item.materials[k] = mesh.materials[k];
+                next.matrices.set(mesh.transform, i * 16);
+            });
+            for (const material of next.materials.keys())
+                if (!seen.has(material))
+                    next.materials.delete(material);
+            const changedMaterials = new Set(materials);
+            for (const material of seen) {
+                const previous = old?.materials.get(material);
+                if (previous && !changedMaterials.has(material)) {
+                    next.materials.set(material, previous);
+                }
+                else {
+                    // Never overwrite a shared committed entry. The other buffer's
+                    // retired entry can reuse its texture storage; parameter arrays and
+                    // their reused vector snapshots remain immutable after capture.
+                    let item = next.materials.get(material);
+                    if (!item || item === previous)
+                        item = { values: [], textures: [] };
+                    item.values = snapshotMaterialParameters(material, previous?.values);
+                    captureMaterialTextures(material, item.textures);
+                    next.materials.set(material, item);
+                }
+            }
+            next.lightList = scene.lights;
+            next.lights = lights;
+            next.background = background;
+            this._pending = next;
+        }
+        else
+            this._pending = old;
+        return changes;
+    }
+    commit() {
+        if (this._pending && this._pending !== this._snapshot) {
+            this._spare = this._snapshot;
+            this._snapshot = this._pending;
+        }
+        this._pending = undefined;
+    }
+    reset() { this._snapshot = this._pending = this._spare = undefined; this._seen.clear(); }
+}
+//# sourceMappingURL=sceneChangeDetector.js.map

package/lib/renderer/sceneChangeDetector.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"sceneChangeDetector.js","sourceRoot":"","sources":["../../src/renderer/sceneChangeDetector.ts"],"names":[],"mappings":"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","sourcesContent":["import { openPbrSchema } from '../scene/openPbrSchema.js';\nimport { materialParametersEqual, materialTexturesChanged } from './materialComparison.generated.js';\nexport { materialParametersEqual } from './materialComparison.generated.js';\nimport Mesh from '../scene/Mesh.js';\nimport InstancedMesh from '../scene/InstancedMesh.js';\nimport Geometry from '../scene/Geometry.js';\nimport OpenPBRMaterial, { materialTextureKeys } from '../scene/OpenPBRMaterial.js';\nimport Texture from '../scene/Texture.js';\nimport { Scene, SceneBackground } from '../scene/Scene.js';\n\nexport interface SceneChanges {\n  meshes: 'none' | 'incremental' | 'full';\n  transforms: Mesh[];\n  colors: InstancedMesh[];\n  geometries: Geometry[];\n  materials: OpenPBRMaterial[];\n  lights: boolean;\n  background: boolean;\n}\n\n/** Small scalar/identity snapshots for lights, backgrounds and texture metadata. */\nexport function snapshotFields(object: object): unknown[] {\n  const values: unknown[] = [object];\n  for (const key of Object.keys(object)) {\n    const value = (object as Record<string, unknown>)[key];\n    values.push(key);\n    if (value instanceof Texture) values.push(...snapshotTexture(value));\n    else if (Array.isArray(value) || ArrayBuffer.isView(value)) {\n      values.push(...Array.from(value as ArrayLike<number>));\n    } else values.push(value);\n  }\n  return values;\n}\n\nfunction snapshotTexture(texture: Texture | undefined): unknown[] {\n  return texture ? [texture, texture.version, texture.image, texture.flipY,\n    texture.uvScale, texture.uvOffset, texture.uvChannel] : [undefined];\n}\n\nexport function snapshotsEqual(a: readonly unknown[], b: readonly unknown[]) {\n  return a.length === b.length && a.every((v, i) => Object.is(v, b[i]));\n}\n\nfunction backgroundSnapshot(background: SceneBackground | undefined) {\n  if (background instanceof Texture) return snapshotTexture(background);\n  if (Array.isArray(background)) return [background, ...background];\n  return background ? snapshotFields(background) : [undefined];\n}\n\nfunction captureMaterialTextures(material: OpenPBRMaterial, out: unknown[]) {\n  let i = 0;\n  for (const key of materialTextureKeys) {\n    const texture = material[key];\n    if (typeof texture === 'number') continue;\n    if (!texture) { out[i++] = undefined; continue; }\n    out[i++] = texture; out[i++] = texture.version; out[i++] = texture.image;\n    out[i++] = texture.flipY; out[i++] = texture.uvScale; out[i++] = texture.uvOffset;\n    out[i++] = texture.uvChannel;\n  }\n  out.length = i;\n}\n\n// Texture references and metadata have their own snapshot.\nconst parameterKeys = openPbrSchema.filter(field => field.type !== 'texture').map(field => field.key);\n\nexport function snapshotMaterialParameters(material: OpenPBRMaterial, previous?: readonly unknown[]) {\n  return parameterKeys.map((key, index) => {\n    const value = material[key];\n    if (Array.isArray(value) || ArrayBuffer.isView(value)) {\n      const array = value as ArrayLike<number>, prior = previous?.[index];\n      if (Array.isArray(prior) && prior.length === array.length) {\n        let equal = true;\n        for (let i = 0; i < array.length; i++) if (!Object.is(array[i], prior[i])) { equal = false; break; }\n        if (equal) return prior;\n      }\n      return Array.from(array);\n    }\n    return value;\n  });\n}\n\nconst geometryAttributes = ['position', 'normal', 'tangent', 'uv', 'uv1', 'color', 'indices', 'materialIndex'] as const;\nfunction captureGeometryStorage(geometry: Geometry, out: unknown[]) {\n  let i = 0;\n  for (const key of geometryAttributes) {\n    const attribute = geometry[key];\n    out[i++] = attribute?.array; out[i++] = attribute?.array.length; out[i++] = attribute?.itemSize;\n  }\n}\nfunction geometryStorageMatches(geometry: Geometry, storage: unknown[]) {\n  let i = 0;\n  for (const key of geometryAttributes) {\n    const attribute = geometry[key];\n    if (storage[i++] !== attribute?.array || storage[i++] !== attribute?.array.length || storage[i++] !== attribute?.itemSize) return false;\n  }\n  return true;\n}\n\ninterface MeshSnapshot {\n  mesh: Mesh;\n  geometry: Mesh['geometry'];\n  version: number;\n  instanceVersion?: number;\n  instanceCount?: number;\n  instanceTransforms?: Float32Array;\n  instanceColors?: Float32Array;\n  colorVersion?: number;\n  dynamic: boolean;\n  storage: unknown[];\n  materials: OpenPBRMaterial[];\n}\ninterface Snapshot {\n  meshList: Mesh[];\n  meshes: MeshSnapshot[];\n  matrices: Float64Array;\n  materials: Map<OpenPBRMaterial, { values: readonly unknown[]; textures: unknown[] }>;\n  lightList: Scene['lights'];\n  lights: unknown[][];\n  background: unknown[];\n}\n\n/** Detects edits without accepting them until the pipeline has received the scene. */\nexport class SceneChangeDetector {\n  private _snapshot?: Snapshot;\n  private _pending?: Snapshot;\n  private _spare?: Snapshot;\n  private _seen = new Set<OpenPBRMaterial>();\n  detect(scene: Scene): SceneChanges {\n    const old = this._snapshot;\n    let full = !old || old.meshList !== scene.meshes || old.meshes.length !== scene.meshes.length;\n    const transforms: Mesh[] = [];\n    const colors: InstancedMesh[] = [];\n    const geometries = new Set<Geometry>();\n    const materials: OpenPBRMaterial[] = [];\n    const seen = this._seen;\n    seen.clear();\n    for (let i = 0; i < scene.meshes.length; i++) {\n      const mesh = scene.meshes[i];\n      const prev = old?.meshes[i];\n      let instanceChanged = false;\n      if (mesh instanceof InstancedMesh) {\n        mesh.validate();\n        if (prev?.instanceCount !== mesh.count) full = true;\n        if (prev?.mesh === mesh && (prev.colorVersion !== mesh.colorsVersion || prev.instanceColors !== mesh.colors)) colors.push(mesh);\n        if (prev?.mesh === mesh && (prev.instanceVersion !== mesh.transformsVersion || prev.instanceTransforms !== mesh.transforms)) {\n          transforms.push(mesh); instanceChanged = true;\n        }\n      }\n      if (!prev || prev.mesh !== mesh || prev.geometry !== mesh.geometry ||\n        prev.dynamic !== mesh.geometry.dynamic || !geometryStorageMatches(mesh.geometry, prev.storage) || prev.materials.length !== mesh.materials.length ||\n        prev.materials.some((m, k) => m !== mesh.materials[k])) full = true;\n      if (prev?.geometry === mesh.geometry && prev.version !== mesh.geometry.version) geometries.add(mesh.geometry);\n      if (prev?.mesh === mesh) {\n        for (let k = 0; k < 16; k++) {\n          if (!Object.is(mesh.transform[k], old!.matrices[i * 16 + k])) {\n            if (!instanceChanged) transforms.push(mesh);\n            break;\n          }\n        }\n      }\n      for (const material of mesh.materials) {\n        if (seen.has(material)) continue;\n        seen.add(material);\n        const prior = old?.materials.get(material);\n        if (!prior || !materialParametersEqual(material, prior.values) ||\n          materialTexturesChanged(material, prior.textures)) materials.push(material);\n      }\n    }\n    const lights = scene.lights.map(snapshotFields);\n    const background = backgroundSnapshot(scene.background);\n    const changes: SceneChanges = {\n      meshes: full ? 'full' : transforms.length || colors.length || materials.length || geometries.size ? 'incremental' : 'none',\n      transforms, colors, materials, geometries: [...geometries],\n      lights: !old || old.lightList !== scene.lights || lights.length !== old.lights.length ||\n        lights.some((light, i) => !snapshotsEqual(light, old.lights[i])),\n      background: !old || !snapshotsEqual(background, old.background)\n    };\n    if (changes.meshes !== 'none' || changes.lights || changes.background) {\n      // Write into the other buffer: detect never mutates committed state.\n      // Repeated detects without commit overwrite the same pending buffer.\n      let next = this._spare;\n      if (!next || next.meshList !== scene.meshes || next.meshes.length !== scene.meshes.length) {\n        next = { meshList: scene.meshes, meshes: [], matrices: new Float64Array(scene.meshes.length * 16),\n          materials: new Map(), lightList: scene.lights, lights: [], background: [] };\n        this._spare = next;\n      }\n      scene.meshes.forEach((mesh, i) => {\n        let item = next!.meshes[i];\n        if (!item) {\n          item = { mesh, geometry: mesh.geometry, version: mesh.geometry.version, dynamic: mesh.geometry.dynamic, storage: [],\n            materials: [] };\n          next!.meshes[i] = item;\n        }\n        item.mesh = mesh; item.geometry = mesh.geometry; item.version = mesh.geometry.version;\n        item.instanceVersion = mesh instanceof InstancedMesh ? mesh.transformsVersion : undefined;\n        item.colorVersion = mesh instanceof InstancedMesh ? mesh.colorsVersion : undefined;\n        item.instanceColors = mesh instanceof InstancedMesh ? mesh.colors : undefined;\n        item.instanceCount = mesh instanceof InstancedMesh ? mesh.count : undefined;\n        item.instanceTransforms = mesh instanceof InstancedMesh ? mesh.transforms : undefined;\n        item.dynamic = mesh.geometry.dynamic; captureGeometryStorage(mesh.geometry, item.storage);\n        item.materials.length = mesh.materials.length;\n        for (let k = 0; k < mesh.materials.length; k++) item.materials[k] = mesh.materials[k];\n        next!.matrices.set(mesh.transform, i * 16);\n      });\n      for (const material of next.materials.keys()) if (!seen.has(material)) next.materials.delete(material);\n      const changedMaterials = new Set(materials);\n      for (const material of seen) {\n        const previous = old?.materials.get(material);\n        if (previous && !changedMaterials.has(material)) {\n          next.materials.set(material, previous);\n        } else {\n          // Never overwrite a shared committed entry. The other buffer's\n          // retired entry can reuse its texture storage; parameter arrays and\n          // their reused vector snapshots remain immutable after capture.\n          let item = next.materials.get(material);\n          if (!item || item === previous) item = { values: [], textures: [] };\n          item.values = snapshotMaterialParameters(material, previous?.values);\n          captureMaterialTextures(material, item.textures);\n          next.materials.set(material, item);\n        }\n      }\n      next.lightList = scene.lights; next.lights = lights; next.background = background;\n      this._pending = next;\n    } else this._pending = old;\n    return changes;\n  }\n\n  commit() {\n    if (this._pending && this._pending !== this._snapshot) {\n      this._spare = this._snapshot;\n      this._snapshot = this._pending;\n    }\n    this._pending = undefined;\n  }\n  reset() { this._snapshot = this._pending = this._spare = undefined; this._seen.clear(); }\n}\n"]}

package/lib/renderer/sceneLightChanges.d.ts

@@ -0,0 +1,14 @@
+import { SceneLight } from '../scene/Scene.js';
+import { EnvironmentMapSource } from './envMapDistribution.js';
+/** Synthesized environment data is retained across analytic-light edits. */
+export declare class SceneEnvironmentCache {
+    private _snapshot;
+    private _image?;
+    update(lights: readonly SceneLight[]): EnvironmentMapSource | undefined;
+}
+/** Captures values before callers mutate a RectLight or its Texture in place. */
+export declare class RectLightTextureTracker {
+    private _snapshot;
+    private _hadTexture;
+    update(lights: readonly SceneLight[]): boolean;
+}

package/lib/renderer/sceneLightChanges.js

@@ -0,0 +1,34 @@
+import { snapshotFields, snapshotsEqual } from './sceneChangeDetector.js';
+import { generateEnvMapFromSceneComponents } from './envMapCreation.js';
+/** Synthesized environment data is retained across analytic-light edits. */
+export class SceneEnvironmentCache {
+    _snapshot = [];
+    _image;
+    update(lights) {
+        const ambient = lights.filter(light => light.type === 'AmbientLight');
+        const environment = lights.filter(light => light.type === 'EnvironmentLight');
+        const next = [...ambient, ...environment].map(snapshotFields);
+        if (next.length !== this._snapshot.length ||
+            next.some((value, i) => !snapshotsEqual(value, this._snapshot[i]))) {
+            this._image = next.length ? generateEnvMapFromSceneComponents(ambient, environment) : undefined;
+            this._snapshot = next;
+        }
+        return this._image;
+    }
+}
+/** Captures values before callers mutate a RectLight or its Texture in place. */
+export class RectLightTextureTracker {
+    _snapshot = [];
+    _hadTexture = false;
+    update(lights) {
+        const textures = lights.map(light => light.type === 'RectLight' ? light.texture : undefined);
+        const next = textures.flatMap(texture => texture ? [texture, texture.version, texture.image,
+            texture.flipY, ...texture.uvScale, ...texture.uvOffset, texture.uvChannel] : [undefined]);
+        const hasTexture = textures.some((texture) => !!texture);
+        const changed = (this._hadTexture || hasTexture) && !snapshotsEqual(next, this._snapshot);
+        this._snapshot = next;
+        this._hadTexture = hasTexture;
+        return changed;
+    }
+}
+//# sourceMappingURL=sceneLightChanges.js.map

package/lib/renderer/sceneLightChanges.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"sceneLightChanges.js","sourceRoot":"","sources":["../../src/renderer/sceneLightChanges.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,cAAc,EAAE,cAAc,EAAE,MAAM,0BAA0B,CAAC;AAC1E,OAAO,EAAE,iCAAiC,EAAE,MAAM,qBAAqB,CAAC;AAIxE,4EAA4E;AAC5E,MAAM,OAAO,qBAAqB;IACxB,SAAS,GAAgB,EAAE,CAAC;IAC5B,MAAM,CAAwB;IACtC,MAAM,CAAC,MAA6B;QAClC,MAAM,OAAO,GAAG,MAAM,CAAC,MAAM,CAAC,KAAK,CAAC,EAAE,CAAC,KAAK,CAAC,IAAI,KAAK,cAAc,CAAC,CAAC;QACtE,MAAM,WAAW,GAAG,MAAM,CAAC,MAAM,CAAC,KAAK,CAAC,EAAE,CAAC,KAAK,CAAC,IAAI,KAAK,kBAAkB,CAAC,CAAC;QAC9E,MAAM,IAAI,GAAG,CAAC,GAAG,OAAO,EAAE,GAAG,WAAW,CAAC,CAAC,GAAG,CAAC,cAAc,CAAC,CAAC;QAC9D,IAAI,IAAI,CAAC,MAAM,KAAK,IAAI,CAAC,SAAS,CAAC,MAAM;YACvC,IAAI,CAAC,IAAI,CAAC,CAAC,KAAK,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,cAAc,CAAC,KAAK,EAAE,IAAI,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;YACrE,IAAI,CAAC,MAAM,GAAG,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC,iCAAiC,CAAC,OAAO,EAAE,WAAW,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC;YAChG,IAAI,CAAC,SAAS,GAAG,IAAI,CAAC;QACxB,CAAC;QACD,OAAO,IAAI,CAAC,MAAM,CAAC;IACrB,CAAC;CACF;AAED,iFAAiF;AACjF,MAAM,OAAO,uBAAuB;IAC1B,SAAS,GAAc,EAAE,CAAC;IAC1B,WAAW,GAAG,KAAK,CAAC;IAC5B,MAAM,CAAC,MAA6B;QAClC,MAAM,QAAQ,GAAG,MAAM,CAAC,GAAG,CAAC,KAAK,CAAC,EAAE,CAAC,KAAK,CAAC,IAAI,KAAK,WAAW,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC;QAC7F,MAAM,IAAI,GAAG,QAAQ,CAAC,OAAO,CAAC,OAAO,CAAC,EAAE,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,OAAO,EAAE,OAAO,CAAC,OAAO,EAAE,OAAO,CAAC,KAAK;YACzF,OAAO,CAAC,KAAK,EAAE,GAAG,OAAO,CAAC,OAAO,EAAE,GAAG,OAAO,CAAC,QAAQ,EAAE,OAAO,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC;QAC5F,MAAM,UAAU,GAAG,QAAQ,CAAC,IAAI,CAAC,CAAC,OAAO,EAAsB,EAAE,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC;QAC7E,MAAM,OAAO,GAAG,CAAC,IAAI,CAAC,WAAW,IAAI,UAAU,CAAC,IAAI,CAAC,cAAc,CAAC,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,CAAC;QAC1F,IAAI,CAAC,SAAS,GAAG,IAAI,CAAC;QACtB,IAAI,CAAC,WAAW,GAAG,UAAU,CAAC;QAC9B,OAAO,OAAO,CAAC;IACjB,CAAC;CACF","sourcesContent":["import { SceneLight } from '../scene/Scene.js';\nimport { snapshotFields, snapshotsEqual } from './sceneChangeDetector.js';\nimport { generateEnvMapFromSceneComponents } from './envMapCreation.js';\nimport { EnvironmentMapSource } from './envMapDistribution.js';\nimport Texture from '../scene/Texture.js';\n\n/** Synthesized environment data is retained across analytic-light edits. */\nexport class SceneEnvironmentCache {\n  private _snapshot: unknown[][] = [];\n  private _image?: EnvironmentMapSource;\n  update(lights: readonly SceneLight[]) {\n    const ambient = lights.filter(light => light.type === 'AmbientLight');\n    const environment = lights.filter(light => light.type === 'EnvironmentLight');\n    const next = [...ambient, ...environment].map(snapshotFields);\n    if (next.length !== this._snapshot.length ||\n      next.some((value, i) => !snapshotsEqual(value, this._snapshot[i]))) {\n      this._image = next.length ? generateEnvMapFromSceneComponents(ambient, environment) : undefined;\n      this._snapshot = next;\n    }\n    return this._image;\n  }\n}\n\n/** Captures values before callers mutate a RectLight or its Texture in place. */\nexport class RectLightTextureTracker {\n  private _snapshot: unknown[] = [];\n  private _hadTexture = false;\n  update(lights: readonly SceneLight[]) {\n    const textures = lights.map(light => light.type === 'RectLight' ? light.texture : undefined);\n    const next = textures.flatMap(texture => texture ? [texture, texture.version, texture.image,\n      texture.flipY, ...texture.uvScale, ...texture.uvOffset, texture.uvChannel] : [undefined]);\n    const hasTexture = textures.some((texture): texture is Texture => !!texture);\n    const changed = (this._hadTexture || hasTexture) && !snapshotsEqual(next, this._snapshot);\n    this._snapshot = next;\n    this._hadTexture = hasTexture;\n    return changed;\n  }\n}\n"]}

package/lib/renderer/scratchSampling.d.ts

@@ -0,0 +1,3 @@
+/** Generate sampling wrappers; shader callers always use these explicit names. */
+export declare function scratchWGSLFunctions(textures: readonly string[], samplers: readonly string[], scratch?: boolean): string;
+export declare function scratchGLSLFunctions(textures: readonly string[], scratch?: boolean): string;

package/lib/renderer/scratchSampling.js

@@ -0,0 +1,39 @@
+/** Generate sampling wrappers; shader callers always use these explicit names. */
+export function scratchWGSLFunctions(textures, samplers, scratch = false) {
+    return textures.map((name, index) => /* wgsl */ `
+fn ${name}Region() -> vec2u {
+return ${scratch ? `imageRegions[${index}].xy` : `textureDimensions(${name})`};
+}
+fn load_${name}(fM: vec2i, level: i32) -> vec4f {
+${scratch ? `if (any(fM < vec2i(0)) || any(fM >= vec2i(${name}Region()))) { return vec4f(0.0); }` : ''}
+return textureLoad(${name}, fM, level);
+}
+${samplers.map(sampler => /* wgsl */ `
+fn sample_${name}_${sampler}(fD: vec2f) -> vec4f {
+${scratch ? /* wgsl */ `
+let jT = textureDimensions(${name});
+if (all(jT == ${name}Region())) { return textureSampleLevel(${name}, ${sampler}, fD, 0.0); }
+let fM = clamp(fD * vec2f(${name}Region()), vec2f(0.5), vec2f(${name}Region()) - vec2f(0.5));
+return textureSampleLevel(${name}, ${sampler}, fM / vec2f(jT), 0.0);`
+        : `return textureSample(${name}, ${sampler}, fD);`}
+}`).join('')}`).join('');
+}
+export function scratchGLSLFunctions(textures, scratch = false) {
+    return textures.map(name => /* glsl */ `
+ivec2 ${name}Region() {
+return ${scratch ? `${name}RegionSize` : `textureSize(${name}, 0)`};
+}
+vec4 load_${name}(ivec2 fM, int level) {
+${scratch ? `if (any(lessThan(fM, ivec2(0))) || any(greaterThanEqual(fM, ${name}Region()))) return vec4(0.0);` : ''}
+return texelFetch(${name}, fM, level);
+}
+vec4 sample_${name}(vec2 fD) {
+${scratch ? /* glsl */ `
+ivec2 jT = textureSize(${name}, 0);
+if (all(equal(jT, ${name}Region()))) return texture(${name}, fD);
+vec2 fM = clamp(fD * vec2(${name}Region()), vec2(0.5), vec2(${name}Region()) - vec2(0.5));
+return texture(${name}, fM / vec2(jT));`
+        : `return texture(${name}, fD);`}
+}`).join('');
+}
+//# sourceMappingURL=scratchSampling.js.map

package/lib/renderer/scratchSampling.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"scratchSampling.js","sourceRoot":"","sources":["../../src/renderer/scratchSampling.ts"],"names":[],"mappings":"AAAA,kFAAkF;AAClF,MAAM,UAAU,oBAAoB,CAClC,QAA2B,EAC3B,QAA2B,EAC3B,OAAO,GAAG,KAAK;IAEf,OAAO,QAAQ,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,KAAK,EAAE,EAAE,CAAC,UAAU,CAAC;KAC7C,IAAI;SACE,OAAO,CAAC,CAAC,CAAC,gBAAgB,KAAK,MAAM,CAAC,CAAC,CAAC,qBAAqB,IAAI,GAAG;;UAErE,IAAI;EACV,OAAO,CAAC,CAAC,CAAC,6CAAmD,IAAI,oCAAoC,CAAC,CAAC,CAAC,EAAE;qBACvF,IAAI;;EAEzB,QAAQ,CAAC,GAAG,CAAC,OAAO,CAAC,EAAE,CAAC,UAAU,CAAC;YACzB,IAAI,IAAI,OAAO;EACvB,OAAO,CAAC,CAAC,CAAC,UAAU,CAAC;6BACgB,IAAI;gBACjB,IAAI,0CAA0C,IAAI,KAAK,OAAO;4BACtD,IAAI,gCAAgC,IAAI;4BAC9C,IAAI,KAAK,OAAO,yBAAsC;QAClF,CAAC,CAAC,wBAAwB,IAAI,KAAK,OAAO,QAAW;EACrD,CAAC,CAAC,IAAI,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;AACzB,CAAC;AAED,MAAM,UAAU,oBAAoB,CAAC,QAA2B,EAAE,OAAO,GAAG,KAAK;IAC/E,OAAO,QAAQ,CAAC,GAAG,CAAC,IAAI,CAAC,EAAE,CAAC,UAAU,CAAC;QACjC,IAAI;SACD,OAAO,CAAC,CAAC,CAAC,GAAG,IAAI,YAAY,CAAC,CAAC,CAAC,eAAe,IAAI,MAAM;;YAExD,IAAI;EACZ,OAAO,CAAC,CAAC,CAAC,+DAAqE,IAAI,+BAA+B,CAAC,CAAC,CAAC,EAAE;oBACrG,IAAI;;cAEZ,IAAI;EACd,OAAO,CAAC,CAAC,CAAC,UAAU,CAAC;yBACY,IAAI;oBACT,IAAI,8BAA8B,IAAI;4BAClC,IAAI,8BAA8B,IAAI;iBACvD,IAAI,mBAAgC;QACrD,CAAC,CAAC,kBAAkB,IAAI,QAAW;EACnC,CAAC,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;AACb,CAAC","sourcesContent":["/** Generate sampling wrappers; shader callers always use these explicit names. */\nexport function scratchWGSLFunctions(\n  textures: readonly string[],\n  samplers: readonly string[],\n  scratch = false\n) {\n  return textures.map((name, index) => /* wgsl */ `\nfn ${name}Region() -> vec2u {\n  return ${scratch ? `imageRegions[${index}].xy` : `textureDimensions(${name})`};\n}\nfn load_${name}(pixel: vec2i, level: i32) -> vec4f {\n  ${scratch ? `if (any(pixel < vec2i(0)) || any(pixel >= vec2i(${name}Region()))) { return vec4f(0.0); }` : ''}\n  return textureLoad(${name}, pixel, level);\n}\n${samplers.map(sampler => /* wgsl */ `\nfn sample_${name}_${sampler}(coord: vec2f) -> vec4f {\n  ${scratch ? /* wgsl */ `\n  let physicalSize = textureDimensions(${name});\n  if (all(physicalSize == ${name}Region())) { return textureSampleLevel(${name}, ${sampler}, coord, 0.0); }\n  let pixel = clamp(coord * vec2f(${name}Region()), vec2f(0.5), vec2f(${name}Region()) - vec2f(0.5));\n  return textureSampleLevel(${name}, ${sampler}, pixel / vec2f(physicalSize), 0.0);`\n  : `return textureSample(${name}, ${sampler}, coord);`}\n}`).join('')}`).join('');\n}\n\nexport function scratchGLSLFunctions(textures: readonly string[], scratch = false) {\n  return textures.map(name => /* glsl */ `\nivec2 ${name}Region() {\n  return ${scratch ? `${name}RegionSize` : `textureSize(${name}, 0)`};\n}\nvec4 load_${name}(ivec2 pixel, int level) {\n  ${scratch ? `if (any(lessThan(pixel, ivec2(0))) || any(greaterThanEqual(pixel, ${name}Region()))) return vec4(0.0);` : ''}\n  return texelFetch(${name}, pixel, level);\n}\nvec4 sample_${name}(vec2 coord) {\n  ${scratch ? /* glsl */ `\n  ivec2 physicalSize = textureSize(${name}, 0);\n  if (all(equal(physicalSize, ${name}Region()))) return texture(${name}, coord);\n  vec2 pixel = clamp(coord * vec2(${name}Region()), vec2(0.5), vec2(${name}Region()) - vec2(0.5));\n  return texture(${name}, pixel / vec2(physicalSize));`\n  : `return texture(${name}, coord);`}\n}`).join('');\n}\n"]}

package/lib/renderer/shader.d.ts

@@ -0,0 +1,37 @@
+export type ShaderDefineValue = string | number | boolean | null;
+export interface ShaderUniform<T = unknown> {
+    type: string;
+    value?: T;
+    len?: string | number;
+    array?: boolean;
+}
+export interface ShaderMixin {
+    defines: Record<string, ShaderDefineValue>;
+    uniforms: Record<string, ShaderUniform>;
+    main: string;
+    functions?: Array<(name?: string) => string>;
+}
+export declare function glsl(strings: TemplateStringsArray, ...values: unknown[]): string;
+export declare function createShaderMixin(options: Partial<ShaderMixin> | string): ShaderMixin;
+export declare class Shader {
+    static uniform<T>(type: string, value?: T): ShaderUniform<T>;
+    static arrayUniform<T>(type: string, len: string | number, value?: T): ShaderUniform<T>;
+}
+export interface FragmentShaderOptions {
+    name?: string;
+    outputs?: string[];
+    defines?: Record<string, ShaderDefineValue>;
+    uniforms?: Record<string, ShaderUniform>;
+    includes?: ShaderMixin[];
+    main: string;
+}
+export declare class FragmentShader<TDefines extends Record<string, ShaderDefineValue> = Record<string, ShaderDefineValue>, TUniforms extends Record<string, ShaderUniform> = Record<string, ShaderUniform>> {
+    readonly name: string;
+    readonly outputs: string[];
+    readonly defines: TDefines;
+    readonly uniforms: TUniforms;
+    readonly functions: Array<(name?: string) => string>;
+    readonly main: string;
+    parallelCompile: boolean;
+    constructor(options: FragmentShaderOptions);
+}

package/lib/renderer/shader.js

@@ -0,0 +1,41 @@
+export function glsl(strings, ...values) {
+    return strings.reduce((result, part, index) => result + (index ? String(values[index - 1] ?? '') : '') + part, '');
+}
+export function createShaderMixin(options) {
+    if (typeof options === 'string') {
+        options = { main: options };
+    }
+    return {
+        defines: options.defines || {},
+        uniforms: options.uniforms || {},
+        main: options.main || '',
+        functions: options.functions || []
+    };
+}
+export class Shader {
+    static uniform(type, value) {
+        return { type, value };
+    }
+    static arrayUniform(type, len, value) {
+        return { type, len, value, array: true };
+    }
+}
+export class FragmentShader {
+    name;
+    outputs;
+    defines;
+    uniforms;
+    functions;
+    main;
+    parallelCompile = false;
+    constructor(options) {
+        const includes = options.includes || [];
+        this.name = options.name || '';
+        this.outputs = options.outputs || ['color'];
+        this.defines = Object.assign({}, ...includes.map((item) => item.defines), options.defines || {});
+        this.uniforms = Object.assign({}, ...includes.map((item) => item.uniforms), options.uniforms || {});
+        this.functions = includes.flatMap((item) => item.functions || []);
+        this.main = options.main;
+    }
+}
+//# sourceMappingURL=shader.js.map

package/lib/renderer/shader.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"shader.js","sourceRoot":"","sources":["../../src/renderer/shader.ts"],"names":[],"mappings":"AAgBA,MAAM,UAAU,IAAI,CAAC,OAA6B,EAAE,GAAG,MAAiB;IACtE,OAAO,OAAO,CAAC,MAAM,CACnB,CAAC,MAAM,EAAE,IAAI,EAAE,KAAK,EAAE,EAAE,CACtB,MAAM,GAAG,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,CAAC,MAAM,CAAC,KAAK,GAAG,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,GAAG,IAAI,EAChE,EAAE,CACH,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,iBAAiB,CAC/B,OAAsC;IAEtC,IAAI,OAAO,OAAO,KAAK,QAAQ,EAAE,CAAC;QAChC,OAAO,GAAG,EAAE,IAAI,EAAE,OAAO,EAAE,CAAC;IAC9B,CAAC;IACD,OAAO;QACL,OAAO,EAAE,OAAO,CAAC,OAAO,IAAI,EAAE;QAC9B,QAAQ,EAAE,OAAO,CAAC,QAAQ,IAAI,EAAE;QAChC,IAAI,EAAE,OAAO,CAAC,IAAI,IAAI,EAAE;QACxB,SAAS,EAAE,OAAO,CAAC,SAAS,IAAI,EAAE;KACnC,CAAC;AACJ,CAAC;AAED,MAAM,OAAO,MAAM;IACjB,MAAM,CAAC,OAAO,CAAI,IAAY,EAAE,KAAS;QACvC,OAAO,EAAE,IAAI,EAAE,KAAK,EAAE,CAAC;IACzB,CAAC;IAED,MAAM,CAAC,YAAY,CACjB,IAAY,EACZ,GAAoB,EACpB,KAAS;QAET,OAAO,EAAE,IAAI,EAAE,GAAG,EAAE,KAAK,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC;IAC3C,CAAC;CACF;AAWD,MAAM,OAAO,cAAc;IAUhB,IAAI,CAAS;IACb,OAAO,CAAW;IAClB,OAAO,CAAW;IAClB,QAAQ,CAAY;IACpB,SAAS,CAAmC;IAC5C,IAAI,CAAS;IACtB,eAAe,GAAG,KAAK,CAAC;IAExB,YAAY,OAA8B;QACxC,MAAM,QAAQ,GAAG,OAAO,CAAC,QAAQ,IAAI,EAAE,CAAC;QACxC,IAAI,CAAC,IAAI,GAAG,OAAO,CAAC,IAAI,IAAI,EAAE,CAAC;QAC/B,IAAI,CAAC,OAAO,GAAG,OAAO,CAAC,OAAO,IAAI,CAAC,OAAO,CAAC,CAAC;QAC5C,IAAI,CAAC,OAAO,GAAG,MAAM,CAAC,MAAM,CAC1B,EAAE,EACF,GAAG,QAAQ,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,OAAO,CAAC,EACvC,OAAO,CAAC,OAAO,IAAI,EAAE,CACV,CAAC;QACd,IAAI,CAAC,QAAQ,GAAG,MAAM,CAAC,MAAM,CAC3B,EAAE,EACF,GAAG,QAAQ,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,QAAQ,CAAC,EACxC,OAAO,CAAC,QAAQ,IAAI,EAAE,CACV,CAAC;QACf,IAAI,CAAC,SAAS,GAAG,QAAQ,CAAC,OAAO,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,SAAS,IAAI,EAAE,CAAC,CAAC;QAClE,IAAI,CAAC,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC;IAC3B,CAAC;CACF","sourcesContent":["export type ShaderDefineValue = string | number | boolean | null;\n\nexport interface ShaderUniform<T = unknown> {\n  type: string;\n  value?: T;\n  len?: string | number;\n  array?: boolean;\n}\n\nexport interface ShaderMixin {\n  defines: Record<string, ShaderDefineValue>;\n  uniforms: Record<string, ShaderUniform>;\n  main: string;\n  functions?: Array<(name?: string) => string>;\n}\n\nexport function glsl(strings: TemplateStringsArray, ...values: unknown[]) {\n  return strings.reduce(\n    (result, part, index) =>\n      result + (index ? String(values[index - 1] ?? '') : '') + part,\n    ''\n  );\n}\n\nexport function createShaderMixin(\n  options: Partial<ShaderMixin> | string\n): ShaderMixin {\n  if (typeof options === 'string') {\n    options = { main: options };\n  }\n  return {\n    defines: options.defines || {},\n    uniforms: options.uniforms || {},\n    main: options.main || '',\n    functions: options.functions || []\n  };\n}\n\nexport class Shader {\n  static uniform<T>(type: string, value?: T): ShaderUniform<T> {\n    return { type, value };\n  }\n\n  static arrayUniform<T>(\n    type: string,\n    len: string | number,\n    value?: T\n  ): ShaderUniform<T> {\n    return { type, len, value, array: true };\n  }\n}\n\nexport interface FragmentShaderOptions {\n  name?: string;\n  outputs?: string[];\n  defines?: Record<string, ShaderDefineValue>;\n  uniforms?: Record<string, ShaderUniform>;\n  includes?: ShaderMixin[];\n  main: string;\n}\n\nexport class FragmentShader<\n  TDefines extends Record<string, ShaderDefineValue> = Record<\n    string,\n    ShaderDefineValue\n  >,\n  TUniforms extends Record<string, ShaderUniform> = Record<\n    string,\n    ShaderUniform\n  >\n> {\n  readonly name: string;\n  readonly outputs: string[];\n  readonly defines: TDefines;\n  readonly uniforms: TUniforms;\n  readonly functions: Array<(name?: string) => string>;\n  readonly main: string;\n  parallelCompile = false;\n\n  constructor(options: FragmentShaderOptions) {\n    const includes = options.includes || [];\n    this.name = options.name || '';\n    this.outputs = options.outputs || ['color'];\n    this.defines = Object.assign(\n      {},\n      ...includes.map((item) => item.defines),\n      options.defines || {}\n    ) as TDefines;\n    this.uniforms = Object.assign(\n      {},\n      ...includes.map((item) => item.uniforms),\n      options.uniforms || {}\n    ) as TUniforms;\n    this.functions = includes.flatMap((item) => item.functions || []);\n    this.main = options.main;\n  }\n}\n"]}

package/lib/renderer/staticBvhPreparation.d.ts

@@ -0,0 +1,24 @@
+import { type BvhBuildConfig } from './geometryBvh.js';
+import type Mesh from '../scene/Mesh.js';
+import type { TinyBvhLayout } from '../tinybvh/TinyBvhBuilder.js';
+import { BvhWorkerPool } from './bvhWorkerClient.js';
+export interface StaticBvhPreparationOptions {
+    config?: BvhBuildConfig;
+    builder: 'builtin' | 'tinybvh';
+    layout: TinyBvhLayout;
+    spatialSplits: boolean;
+    useWorker: boolean;
+    workerPool?: BvhWorkerPool;
+    isCancelled?: () => boolean;
+    rebuild: boolean;
+    onProgress?: (progress: number) => void;
+}
+export interface StaticBvhPreparationResult {
+    geometryCount: number;
+    bvhTimeMs: number;
+    failedMeshes: Mesh[];
+    workerUnavailable: boolean;
+    tinyBvhUnavailable: boolean;
+}
+/** Build static BLASes once per target geometry, preserving old BVHs until writeback. */
+export declare function prepareStaticBvhs(meshes: readonly Mesh[], options: StaticBvhPreparationOptions): Promise<StaticBvhPreparationResult>;

package/lib/renderer/staticBvhPreparation.js

@@ -0,0 +1,116 @@
+import { setGeometryBvh } from './geometryBvh.js';
+import { buildBLAS } from './bvhAccel.js';
+import { buildBvhInWorker, BvhWorkerPool, BvhWorkerUnavailableError, BvhWorkerDisposedError } from './bvhWorkerClient.js';
+import { captureMeshBlasSnapshot, getMeshBlasInput, getPreparedMeshGeometry, meshNeedsStaticBvh, meshBlasSnapshotIsCurrent } from './prepareMeshBVH.js';
+/** Build static BLASes once per target geometry, preserving old BVHs until writeback. */
+export async function prepareStaticBvhs(meshes, options) {
+    const result = {
+        geometryCount: 0, bvhTimeMs: 0, failedMeshes: [],
+        workerUnavailable: false, tinyBvhUnavailable: false
+    };
+    const jobs = new Map();
+    for (const mesh of meshes) {
+        if (!mesh.geometry.position?.array.length || mesh.geometry.dynamic)
+            continue;
+        const target = getPreparedMeshGeometry(mesh);
+        if (jobs.has(target) || (!meshNeedsStaticBvh(mesh, options.config ?? options) && !options.rebuild))
+            continue;
+        try {
+            jobs.set(target, { mesh, snapshot: captureMeshBlasSnapshot(mesh, target) });
+        }
+        catch {
+            result.failedMeshes.push(mesh);
+        }
+    }
+    const pool = options.useWorker ? options.workerPool ?? new BvhWorkerPool(1) : undefined;
+    async function build(input, builder, useWorker) {
+        const { geometry, displacementScale, trianglesDisplacement } = input;
+        let bvh;
+        if (useWorker) {
+            bvh = await buildBvhInWorker(geometry, displacementScale, trianglesDisplacement, builder, builder === 'tinybvh' ? options.layout : 'bvh2', options.spatialSplits, pool);
+        }
+        else if (builder === 'tinybvh') {
+            const { buildTinyBvh } = await import('../tinybvh/TinyBvhBuilder.js');
+            bvh = await buildTinyBvh(geometry, displacementScale, trianglesDisplacement, options.layout, options.spatialSplits);
+        }
+        else {
+            const start = performance.now();
+            bvh = { ...buildBLAS(geometry, displacementScale, trianglesDisplacement),
+                bvhTimeMs: performance.now() - start };
+        }
+        if (builder === 'tinybvh' && (bvh.builder !== 'tinybvh' || !bvh.buffer.byteLength)) {
+            throw new Error('TinyBVH did not build every scene geometry.');
+        }
+        result.bvhTimeMs += bvh.bvhTimeMs ?? 0;
+        return bvh;
+    }
+    async function buildWithFallback(input) {
+        let builder = options.builder;
+        let useWorker = options.useWorker && !result.workerUnavailable;
+        for (;;) {
+            if (options.isCancelled?.())
+                throw new BvhWorkerDisposedError();
+            try {
+                return await build(input, builder, useWorker);
+            }
+            catch (error) {
+                if (error instanceof BvhWorkerDisposedError)
+                    throw error;
+                if (error instanceof BvhWorkerUnavailableError && useWorker) {
+                    result.workerUnavailable = true;
+                    useWorker = false;
+                }
+                else if (builder === 'tinybvh') {
+                    result.tinyBvhUnavailable = true;
+                    builder = 'builtin';
+                    useWorker = options.useWorker && !result.workerUnavailable;
+                }
+                else {
+                    throw error;
+                }
+            }
+        }
+    }
+    let completed = 0;
+    // Large BLASes start first to reduce the tail. Only active lanes prepare
+    // attributes/displacement inputs and submit geometry to Workers.
+    const pending = [...jobs].sort(([a], [b]) => (b.indices?.array.length ?? 0) - (a.indices?.array.length ?? 0));
+    let next = 0;
+    async function runLane() {
+        while (next < pending.length && !options.isCancelled?.()) {
+            const [target, { mesh, snapshot }] = pending[next++];
+            try {
+                if (!meshBlasSnapshotIsCurrent(mesh, target, snapshot))
+                    continue;
+                const input = getMeshBlasInput(mesh);
+                const bvh = await buildWithFallback(input);
+                if (!options.isCancelled?.() && meshBlasSnapshotIsCurrent(mesh, target, snapshot)) {
+                    setGeometryBvh(target, bvh, options.config ?? options);
+                    result.geometryCount++;
+                }
+            }
+            catch (error) {
+                if (!(error instanceof BvhWorkerDisposedError))
+                    result.failedMeshes.push(mesh);
+            }
+            finally {
+                if (!options.isCancelled?.()) {
+                    // A loading-screen callback must not stop a lane and strand jobs.
+                    try {
+                        options.onProgress?.(++completed / jobs.size);
+                    }
+                    catch { /* Keep building. */ }
+                }
+            }
+        }
+    }
+    try {
+        await Promise.allSettled(Array.from({ length: Math.min(pool?.size ?? 1, jobs.size) }, runLane));
+    }
+    finally {
+        if (!options.workerPool)
+            pool?.dispose();
+    }
+    return result;
+}
+//# sourceMappingURL=staticBvhPreparation.js.map