@woosh/meep-engine 3.42.0 → 3.43.0

package/package.json

@@ -1,96 +1,91 @@
-{
-  "name": "@woosh/meep-engine",
-  "license": "SEE LICENSE IN LICENSE",
-  "productName": "Meep",
-  "homepage": "https://meep.company-named.com/",
-  "description": "Advanced 3D game engine",
-  "type": "module",
-  "author": "Alexander Goldring",
-  "version": "3.42.0",
-  "exports": {
-    "./build/*": "./build/*",
-    "./src/*": "./src/*",
-    "./editor/*": "./editor/*",
-    "./samples/*": "./samples/*",
-    "./*.md": "./*.md",
-    "./package.json": "./package.json"
-  },
-  "sideEffects": [
-    "**/*.css",
-    "**/*.scss"
-  ],
-  "scripts": {
-    "test:ci": "node scripts/check-types.mjs && vitest run --coverage --reporter=default --reporter=junit --outputFile=junit.xml",
-    "build-module": "rollup -c rollup.config.js",
-    "publish-npm": "npm publish",
-    "generate-types": "tsc --project tsconfig.types.json",
-    "check-types": "node scripts/check-types.mjs",
-    "test": "vitest run",
-    "test:extended": "vitest run --mode extended",
-    "test:all": "vitest run --mode all",
-    "dev": "vite"
-  },
-  "browserslist": [
-    "last 2 chrome version",
-    "last 2 firefox version",
-    "last 2 safari version"
-  ],
-  "files": [
-    "build",
-    "src",
-    "editor",
-    "samples",
-    "package.json",
-    "README.md",
-    "!src/**/*.spec.js",
-    "!samples/**/*.spec.js",
-    "!editor/**/*.spec.js",
-    "!src/**/__fixtures__/**",
-    "!src/shade/renderer/texture/noise/stbn/images/**"
-  ],
-  "dependencies": {
-    "opentype.js": "1.3.4",
-    "robust-predicates": "3.0.3"
-  },
-  "peerDependencies": {
-    "dat.gui": ">=0.7.0"
-  },
-  "devDependencies": {
-    "@rollup/plugin-commonjs": "29.0.3",
-    "@rollup/plugin-node-resolve": "16.0.3",
-    "@rollup/plugin-strip": "3.0.4",
-    "@rollup/plugin-terser": "1.0.0",
-    "@vitest/coverage-v8": "^5.0.0",
-    "@webgpu/types": "0.1.72",
-    "jsdom": "^30.0.1",
-    "rollup": "4.63.1",
-    "typescript": "5.4.5",
-    "vite": "^8.2.2",
-    "vitest": "^5.0.0",
-    "web-tree-sitter": "^0.27.0"
-  },
-  "keywords": [
-    "game-engine",
-    "gamedev",
-    "ecs",
-    "entity-component-system",
-    "data-oriented",
-    "zero-allocation",
-    "modular",
-    "tree-shaking",
-    "3d",
-    "webgpu",
-    "webaudio",
-    "particles",
-    "bvh",
-    "behavior-tree",
-    "inverse-kinematics",
-    "fabrik",
-    "clustered-lighting",
-    "color-management",
-    "typescript"
-  ],
-  "engines": {
-    "node": ">=24"
-  }
-}
+{
+  "name": "@woosh/meep-engine",
+  "license": "SEE LICENSE IN LICENSE",
+  "productName": "Meep",
+  "homepage": "https://meep.company-named.com/",
+  "description": "Advanced 3D game engine",
+  "type": "module",
+  "author": "Alexander Goldring",
+  "version": "3.43.0",
+  "exports": {
+    "./build/*": "./build/*",
+    "./src/*": "./src/*",
+    "./editor/*": "./editor/*",
+    "./samples/*": "./samples/*",
+    "./*.md": "./*.md",
+    "./package.json": "./package.json"
+  },
+  "sideEffects": [
+    "**/*.css",
+    "**/*.scss"
+  ],
+  "scripts": {
+    "test:ci": "node scripts/check-types.mjs && vitest run --coverage --reporter=default --reporter=junit --outputFile=junit.xml",
+    "build-module": "rollup -c rollup.config.js",
+    "publish-npm": "npm publish",
+    "generate-types": "tsc --project tsconfig.types.json",
+    "check-types": "node scripts/check-types.mjs",
+    "test": "vitest run",
+    "test:extended": "vitest run --mode extended",
+    "test:all": "vitest run --mode all",
+    "dev": "vite"
+  },
+  "browserslist": [
+    "last 2 chrome version",
+    "last 2 firefox version",
+    "last 2 safari version"
+  ],
+  "files": [
+    "build",
+    "src",
+    "editor",
+    "samples",
+    "package.json",
+    "README.md"
+  ],
+  "dependencies": {
+    "opentype.js": "1.3.4",
+    "robust-predicates": "3.0.3"
+  },
+  "peerDependencies": {
+    "dat.gui": ">=0.7.0"
+  },
+  "devDependencies": {
+    "@rollup/plugin-commonjs": "29.0.3",
+    "@rollup/plugin-node-resolve": "16.0.3",
+    "@rollup/plugin-strip": "3.0.4",
+    "@rollup/plugin-terser": "1.0.0",
+    "@vitest/coverage-v8": "^5.0.0",
+    "@webgpu/types": "0.1.72",
+    "jsdom": "^30.0.1",
+    "rollup": "4.63.1",
+    "typescript": "5.4.5",
+    "vite": "^8.2.2",
+    "vitest": "^5.0.0",
+    "web-tree-sitter": "^0.27.0"
+  },
+  "keywords": [
+    "game-engine",
+    "gamedev",
+    "ecs",
+    "entity-component-system",
+    "data-oriented",
+    "zero-allocation",
+    "modular",
+    "tree-shaking",
+    "3d",
+    "webgpu",
+    "webaudio",
+    "particles",
+    "bvh",
+    "behavior-tree",
+    "inverse-kinematics",
+    "fabrik",
+    "clustered-lighting",
+    "color-management",
+    "typescript"
+  ],
+  "engines": {
+    "node": ">=24"
+  }
+}

package/src/engine/physics/fluid/ecs/FluidObstacleSystem.d.ts

@@ -66,11 +66,11 @@ export class FluidObstacleSystem extends System<any> {
     /**
      * @param {FluidComponent} fluid
      */
-    static "__#429@#refresh_masks"(fluid: FluidComponent): void;
+    static "__#430@#refresh_masks"(fluid: FluidComponent): void;
     /**
      * @param {FluidComponent} fluid
      */
-    static "__#429@#clear_field"(fluid: FluidComponent): void;
+    static "__#430@#clear_field"(fluid: FluidComponent): void;
     /**
      * Mark every cell of `fluid` whose centre lies within `inflation` of the
      * posed shape as solid. Iteration is clipped to the shape's world AABB
@@ -82,7 +82,7 @@ export class FluidObstacleSystem extends System<any> {
      * @param {number} inflation       world-units SDF threshold
      * @param {Float64Array} point     length-3 scratch
      */
-    static "__#429@#voxelize"(fluid: FluidComponent, posed: PosedShape3D, aabb: Float64Array, inflation: number, point: Float64Array): void;
+    static "__#430@#voxelize"(fluid: FluidComponent, posed: PosedShape3D, aabb: Float64Array, inflation: number, point: Float64Array): void;
     /**
      * Write the obstacle's translation velocity onto every face of every cell
      * it voxelized — the moving-wall boundary condition. Runs AFTER the mask
@@ -102,7 +102,7 @@ export class FluidObstacleSystem extends System<any> {
      * @param {number} wvy
      * @param {number} wvz
      */
-    static "__#429@#stamp_wall_velocity"(fluid: FluidComponent, posed: PosedShape3D, aabb: Float64Array, inflation: number, point: Float64Array, wvx: number, wvy: number, wvz: number): void;
+    static "__#430@#stamp_wall_velocity"(fluid: FluidComponent, posed: PosedShape3D, aabb: Float64Array, inflation: number, point: Float64Array, wvx: number, wvy: number, wvz: number): void;
     constructor();
     dependencies: (typeof FluidObstacle)[];
     components_used: (ResourceAccessSpecification<typeof Transform64> | ResourceAccessSpecification<typeof RigidBody> | ResourceAccessSpecification<typeof Collider> | ResourceAccessSpecification<typeof FluidComponent> | ResourceAccessSpecification<typeof FluidObstacle>)[];

package/src/shade/playground/vgeo_runtime/README.md

@@ -46,10 +46,11 @@ and drawn, and its sub-pixel jitter does not move the cut: the τ table below is
 and off. The environment is not awaited — `test_assets/` is gitignored, so a checkout without it
 gets the sun alone and still draws every triangle the cut selected.
 
-**Not the GPU sky, and that is worth writing down.** `renderer/atmosphere/GPUSky.js` and
-`view/GPUViewSkyContext.js` would be the natural source for this and are **not reachable**: nothing
-in the engine constructs either, `GPUSceneContext` has no `sky` for `GPUViewSkyContext.update` to
-ask for, and `Renderer` does not mention the atmosphere at all. Reviving it is not a playground's
+**Not the GPU sky, and that is worth writing down.** `view/GPUViewSkyContext.js` would be the
+natural source for this and is **not reachable**: nothing in the engine constructs it, and `Renderer`
+does not mention the atmosphere. (`GPUSceneContext.sky` is real now -- the scene's `GPUSky`, whose
+transmittance and multiple-scattering LUTs the volumetrics read -- but those are look-up tables, not
+the convolved environment this would need.) Reviving the sky as a light source is not a playground's
 change — the sky produces an already-convolved GPU texture with `SPHERE_PROBE_MIPMAP_LEVELS` mips,
 while `GPULightCollection` builds its environment privately from a CPU `ShadeTexture` and convolves
 a full mip chain itself, so the two do not meet without a new way to hand that class a GPU-side

package/src/shade/renderer/Renderer.d.ts.map

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

package/src/shade/renderer/Renderer.js

@@ -2514,11 +2514,12 @@ export class Renderer {
             resolution: view_ctx.resolution,
         });
 
-        // Build the view's volumetric fog LUTs (participating media -> per-froxel lighting ->
-        // ray-marched integration). Needs the light clusters and shadow atlas. Built every frame so
-        // the transparency (OIT) pass always has a valid LUT to sample — an empty scene integrates
-        // to a no-op (transmittance 1, in-scatter 0). The opaque composite below is still skipped
-        // when the scene has no fog.
+        // The view's volumetrics: the fog every surface is seen through (participating media ->
+        // per-froxel lighting -> ray-marched integration), and the froxel irradiance lit particles
+        // are lit by. Both need the light clusters and shadow atlas. A scene with no volumes records
+        // no fog and hands the transparency pass a constant LUT that reads as none (transmittance 1,
+        // in-scatter 0); the irradiance is built only when something reads it. The opaque composite
+        // below is skipped on the same fact.
         const has_volumetrics = view_ctx.scene.volumetrics.source.volumes.length > 0;
 
         const volumetrics = view_ctx.volumetrics.graph_update({

package/src/shade/renderer/atmosphere/GPUSky.d.ts

@@ -1,3 +1,6 @@
+/**
+ * @typedef {import("../GraphicsContext.js").GraphicsContext} GraphicsContext
+ */
 export class GPUSky {
     /**
      *
@@ -14,6 +17,14 @@ export class GPUSky {
      * @returns {GPUTextureContext}
      */
     get lut_multiple_scattering(): GPUTextureContext;
+    /**
+     * Whether the LUTs still hold nothing a reader could use: true until the first {@link update}.
+     * What reads {@link lut_transmittance} or {@link lut_multiple_scattering} has to see this false,
+     * as a texture nobody wrote reads as zero rather than failing.
+     *
+     * @returns {boolean}
+     */
+    get needs_update(): boolean;
     destroy(): void;
     debug(): void;
     /**
@@ -22,5 +33,6 @@ export class GPUSky {
     update(): void;
     #private;
 }
+export type GraphicsContext = import("../GraphicsContext.js").GraphicsContext;
 import { GPUTextureContext } from "../texture/GPUTextureContext.js";
 //# sourceMappingURL=GPUSky.d.ts.map

package/src/shade/renderer/atmosphere/GPUSky.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"GPUSky.d.ts","sourceRoot":"","sources":["../../../../../src/shade/renderer/atmosphere/GPUSky.js"],"names":[],"mappings":"AAUA;IAuCI;;;OAGG;IACH,uCAmBC;IAlDD;;;OAGG;IACH,2CAEC;IAOD;;;OAGG;IACH,iDAEC;IAiCD,gBAGC;IAED,cAYC;IAED;;OAEG;IACH,eAiDC;;CAEJ;kCA7IiC,iCAAiC"}
+{"version":3,"file":"GPUSky.d.ts","sourceRoot":"","sources":["../../../../../src/shade/renderer/atmosphere/GPUSky.js"],"names":[],"mappings":"AAUA;;GAEG;AAEH;IAkDI;;;OAGG;IACH,sBAFW,eAAe,EAqBzB;IA7DD;;;OAGG;IACH,2CAEC;IAOD;;;OAGG;IACH,iDAEC;IAQD;;;;;;OAMG;IACH,4BAEC;IA2BD,gBAGC;IAED,cAYC;IAED;;OAEG;IACH,eAiDC;;CAEJ;8BAvJY,OAAO,uBAAuB,EAAE,eAAe;kCAL1B,iCAAiC"}

package/src/shade/renderer/atmosphere/GPUSky.js

@@ -1,148 +1,163 @@
-import { FrameGraph } from "../../../engine/graphics/render/frame_graph/FrameGraph.js";
-import { TextureResourceDescriptor } from "../../device/graph/TextureResourceDescriptor.js";
-import { ShadeGPUCommandContext } from "../../device/ShadeGPUCommandContext.js";
-import { graph_compute_pass } from "../shader/graph/compute/graph_compute_pass.js";
-import { graph_image_pass } from "../shader/graph/graph_image_pass.js";
-import { debug_draw_texture } from "../texture/debug_draw_texture.js";
-import { GPUTextureContext } from "../texture/GPUTextureContext.js";
-import { shader_multiscatter_lut } from "./shader_multiscatter_lut.js";
-import { shader_transmittance_lut } from "./shader_transmittance_lut.js";
-
-export class GPUSky {
-
-    /**
-     * @type {GraphicsContext}
-     */
-    #graphics;
-
-    /**
-     * @type {GPUTextureContext}
-     */
-    #lut_transmittance;
-
-    /**
-     *
-     * @returns {GPUTextureContext}
-     */
-    get lut_transmittance() {
-        return this.#lut_transmittance;
-    }
-
-    /**
-     * @type {GPUTextureContext}
-     */
-    #lut_multiple_scattering;
-
-    /**
-     *
-     * @returns {GPUTextureContext}
-     */
-    get lut_multiple_scattering() {
-        return this.#lut_multiple_scattering;
-    }
-
-    /**
-     *
-     * @type {boolean}
-     */
-    #needs_update = true;
-
-    /**
-     *
-     * @param {GraphicsContext} graphics
-     */
-    constructor(graphics) {
-        this.#graphics = graphics;
-
-        const device = graphics.device;
-
-        this.#lut_transmittance = new GPUTextureContext(device);
-        this.#lut_transmittance.descriptor.label = "Sky / Transmittance LUT";
-        this.#lut_transmittance.descriptor.format = "rgba16float";
-        this.#lut_transmittance.descriptor.usage = GPUTextureUsage.RENDER_ATTACHMENT | GPUTextureUsage.TEXTURE_BINDING | GPUTextureUsage.COPY_SRC;
-        this.#lut_transmittance.resize(256, 64);
-
-        this.#lut_multiple_scattering = new GPUTextureContext(device);
-        this.#lut_multiple_scattering.descriptor.label = "Sky / Multiple Scattering LUT";
-        this.#lut_multiple_scattering.descriptor.format = "rgba16float";
-        // written by a compute shader, so STORAGE_BINDING rather than RENDER_ATTACHMENT
-        this.#lut_multiple_scattering.descriptor.usage = GPUTextureUsage.STORAGE_BINDING | GPUTextureUsage.TEXTURE_BINDING | GPUTextureUsage.COPY_SRC;
-        this.#lut_multiple_scattering.resize(32, 32);
-
-
-    }
-
-    destroy() {
-        this.#lut_transmittance.destroy();
-        this.#lut_multiple_scattering.destroy();
-    }
-
-    debug() {
-
-
-        let y = 50;
-        debug_draw_texture({ texture: this.#lut_transmittance, x: 50, y: y });
-
-        y += this.#lut_transmittance.size[1] + 50;
-
-        debug_draw_texture({ texture: this.#lut_multiple_scattering, x: 50, y: y });
-
-        y += this.#lut_multiple_scattering.size[1] + 50;
-
-    }
-
-    /**
-     *
-     */
-    update() {
-        if (!this.#needs_update) {
-            return;
-        }
-
-        const graph = new FrameGraph("sky update");
-
-        const command_ctx = ShadeGPUCommandContext.create(
-            this.#graphics,
-            "Renderer/main"
-        );
-
-        const gr_transmittance = graph.import_resource("transmittance", TextureResourceDescriptor.fromTexture(this.#lut_transmittance.gpu_texture), this.#lut_transmittance);
-        const gr_multiscatter = graph.import_resource("multiscatter", TextureResourceDescriptor.fromTexture(this.#lut_multiple_scattering.gpu_texture), this.#lut_multiple_scattering);
-
-        // the handle the write produced, not the one imported: binding the pre-write version below
-        // is a superseded read, which is exactly what `validate()` rejects
-        const [gr_transmittance_written] = graph_image_pass({
-            graph,
-            shader: shader_transmittance_lut,
-            inputs: {
-                settings: {
-                    steps: 40,
-                    // read off the texture rather than restated, so the two cannot disagree
-                    resolution: [this.#lut_transmittance.width, this.#lut_transmittance.height],
-                }
-            },
-            output: [gr_transmittance]
-        });
-
-
-        graph_compute_pass({
-            graph,
-            shader: shader_multiscatter_lut,
-            // one workgroup per LUT texel, counted off the texture being written so the
-            // dispatch cannot cover a different area than the shader stores into
-            group_count: [this.#lut_multiple_scattering.width, this.#lut_multiple_scattering.height, 1],
-            bindings: {
-                tSkyLutTransmittance: gr_transmittance_written,
-                tSkyLutMultiscatterOut: gr_multiscatter
-            }
-        });
-
-        command_ctx.encodeGraph(graph);
-
-        command_ctx.finish();
-
-
-        this.#needs_update = false;
-    }
-
+import { FrameGraph } from "../../../engine/graphics/render/frame_graph/FrameGraph.js";
+import { TextureResourceDescriptor } from "../../device/graph/TextureResourceDescriptor.js";
+import { ShadeGPUCommandContext } from "../../device/ShadeGPUCommandContext.js";
+import { graph_compute_pass } from "../shader/graph/compute/graph_compute_pass.js";
+import { graph_image_pass } from "../shader/graph/graph_image_pass.js";
+import { debug_draw_texture } from "../texture/debug_draw_texture.js";
+import { GPUTextureContext } from "../texture/GPUTextureContext.js";
+import { shader_multiscatter_lut } from "./shader_multiscatter_lut.js";
+import { shader_transmittance_lut } from "./shader_transmittance_lut.js";
+
+/**
+ * @typedef {import("../GraphicsContext.js").GraphicsContext} GraphicsContext
+ */
+
+export class GPUSky {
+
+    /**
+     * @type {GraphicsContext}
+     */
+    #graphics;
+
+    /**
+     * @type {GPUTextureContext}
+     */
+    #lut_transmittance;
+
+    /**
+     *
+     * @returns {GPUTextureContext}
+     */
+    get lut_transmittance() {
+        return this.#lut_transmittance;
+    }
+
+    /**
+     * @type {GPUTextureContext}
+     */
+    #lut_multiple_scattering;
+
+    /**
+     *
+     * @returns {GPUTextureContext}
+     */
+    get lut_multiple_scattering() {
+        return this.#lut_multiple_scattering;
+    }
+
+    /**
+     *
+     * @type {boolean}
+     */
+    #needs_update = true;
+
+    /**
+     * Whether the LUTs still hold nothing a reader could use: true until the first {@link update}.
+     * What reads {@link lut_transmittance} or {@link lut_multiple_scattering} has to see this false,
+     * as a texture nobody wrote reads as zero rather than failing.
+     *
+     * @returns {boolean}
+     */
+    get needs_update() {
+        return this.#needs_update;
+    }
+
+    /**
+     *
+     * @param {GraphicsContext} graphics
+     */
+    constructor(graphics) {
+        this.#graphics = graphics;
+
+        const device = graphics.device;
+
+        this.#lut_transmittance = new GPUTextureContext(device);
+        this.#lut_transmittance.descriptor.label = "Sky / Transmittance LUT";
+        this.#lut_transmittance.descriptor.format = "rgba16float";
+        this.#lut_transmittance.descriptor.usage = GPUTextureUsage.RENDER_ATTACHMENT | GPUTextureUsage.TEXTURE_BINDING | GPUTextureUsage.COPY_SRC;
+        this.#lut_transmittance.resize(256, 64);
+
+        this.#lut_multiple_scattering = new GPUTextureContext(device);
+        this.#lut_multiple_scattering.descriptor.label = "Sky / Multiple Scattering LUT";
+        this.#lut_multiple_scattering.descriptor.format = "rgba16float";
+        // written by a compute shader, so STORAGE_BINDING rather than RENDER_ATTACHMENT
+        this.#lut_multiple_scattering.descriptor.usage = GPUTextureUsage.STORAGE_BINDING | GPUTextureUsage.TEXTURE_BINDING | GPUTextureUsage.COPY_SRC;
+        this.#lut_multiple_scattering.resize(32, 32);
+
+
+    }
+
+    destroy() {
+        this.#lut_transmittance.destroy();
+        this.#lut_multiple_scattering.destroy();
+    }
+
+    debug() {
+
+
+        let y = 50;
+        debug_draw_texture({ texture: this.#lut_transmittance, x: 50, y: y });
+
+        y += this.#lut_transmittance.size[1] + 50;
+
+        debug_draw_texture({ texture: this.#lut_multiple_scattering, x: 50, y: y });
+
+        y += this.#lut_multiple_scattering.size[1] + 50;
+
+    }
+
+    /**
+     *
+     */
+    update() {
+        if (!this.#needs_update) {
+            return;
+        }
+
+        const graph = new FrameGraph("sky update");
+
+        const command_ctx = ShadeGPUCommandContext.create(
+            this.#graphics,
+            "Renderer/main"
+        );
+
+        const gr_transmittance = graph.import_resource("transmittance", TextureResourceDescriptor.fromTexture(this.#lut_transmittance.gpu_texture), this.#lut_transmittance);
+        const gr_multiscatter = graph.import_resource("multiscatter", TextureResourceDescriptor.fromTexture(this.#lut_multiple_scattering.gpu_texture), this.#lut_multiple_scattering);
+
+        // the handle the write produced, not the one imported: binding the pre-write version below
+        // is a superseded read, which is exactly what `validate()` rejects
+        const [gr_transmittance_written] = graph_image_pass({
+            graph,
+            shader: shader_transmittance_lut,
+            inputs: {
+                settings: {
+                    steps: 40,
+                    // read off the texture rather than restated, so the two cannot disagree
+                    resolution: [this.#lut_transmittance.width, this.#lut_transmittance.height],
+                }
+            },
+            output: [gr_transmittance]
+        });
+
+
+        graph_compute_pass({
+            graph,
+            shader: shader_multiscatter_lut,
+            // one workgroup per LUT texel, counted off the texture being written so the
+            // dispatch cannot cover a different area than the shader stores into
+            group_count: [this.#lut_multiple_scattering.width, this.#lut_multiple_scattering.height, 1],
+            bindings: {
+                tSkyLutTransmittance: gr_transmittance_written,
+                tSkyLutMultiscatterOut: gr_multiscatter
+            }
+        });
+
+        command_ctx.encodeGraph(graph);
+
+        command_ctx.finish();
+
+
+        this.#needs_update = false;
+    }
+
 }

package/src/shade/renderer/lightmap/bake/shader_lightmap_denoise_sh.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"shader_lightmap_denoise_sh.d.ts","sourceRoot":"","sources":["../../../../../../src/shade/renderer/lightmap/bake/shader_lightmap_denoise_sh.js"],"names":[],"mappings":"AA2BA;;;GAGG;AACH,2CAFU,SAAS,CAkCjB;AAyHF,qDAOE;0BAvLwB,oCAAoC;4BAClC,6BAA6B"}
+{"version":3,"file":"shader_lightmap_denoise_sh.d.ts","sourceRoot":"","sources":["../../../../../../src/shade/renderer/lightmap/bake/shader_lightmap_denoise_sh.js"],"names":[],"mappings":"AA2BA;;;GAGG;AACH,2CAFU,SAAS,CAyCjB;AAyHF,qDAOE;0BA9LwB,oCAAoC;4BAClC,6BAA6B"}