@woosh/meep-engine 3.0.0 → 3.0.2

package/src/shade/renderer/postprocess/gtao/generate_magic_square_noise.d.ts

@@ -1,5 +1,9 @@
 /**
- * Taken from THREE.js GTAO implementation, not very good for what it's intended for
+ * Taken from three's GTAO implementation (`examples/jsm/shaders/GTAOShader.js`), not very good
+ * for what it is intended for.
+ *
+ * Derived from three.js (https://github.com/mrdoob/three.js), Copyright (c) 2010-2024 three.js authors, MIT licence.
+ *
  * @param {number} size
  * @returns {ShadeTexture}
  */

package/src/shade/renderer/postprocess/gtao/generate_magic_square_noise.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"generate_magic_square_noise.d.ts","sourceRoot":"","sources":["../../../../../../src/shade/renderer/postprocess/gtao/generate_magic_square_noise.js"],"names":[],"mappings":"AAOA;;;;GAIG;AACH,gDAHW,MAAM,GACJ,YAAY,CAmCxB;6BA3C4B,+BAA+B"}
+{"version":3,"file":"generate_magic_square_noise.d.ts","sourceRoot":"","sources":["../../../../../../src/shade/renderer/postprocess/gtao/generate_magic_square_noise.js"],"names":[],"mappings":"AAOA;;;;;;;;GAQG;AACH,gDAHW,MAAM,GACJ,YAAY,CAmCxB;6BA/C4B,+BAA+B"}

package/src/shade/renderer/postprocess/gtao/generate_magic_square_noise.js

@@ -1,47 +1,51 @@
-import Vector3 from "../../../../core/geom/Vector3.js";
-import { Sampler2D } from "../../../../engine/graphics/texture/sampler/Sampler2D.js";
-import { ShadeTexture } from "../../texture/ShadeTexture.js";
-import { ShadeImage } from "../../texture/source/ShadeImage.js";
-import { TextureWrapType } from "../../texture/TextureWrapType.js";
-import { generateMagicSquare } from "./generate_magic_square.js";
-
-/**
- * Taken from THREE.js GTAO implementation, not very good for what it's intended for
- * @param {number} size
- * @returns {ShadeTexture}
- */
-export function generateMagicSquareNoise(size = 5) {
-
-    const noiseSize = Math.floor(size) % 2 === 0 ? Math.floor(size) + 1 : Math.floor(size);
-    const magicSquare = generateMagicSquare(noiseSize);
-    const noiseSquareSize = magicSquare.length;
-    const data = new Uint8Array(noiseSquareSize * 4);
-
-    for (let inx = 0; inx < noiseSquareSize; ++inx) {
-
-        const iAng = magicSquare[inx];
-        const angle = (2 * Math.PI * iAng) / noiseSquareSize;
-        const randomVec = new Vector3(
-            Math.cos(angle),
-            Math.sin(angle),
-            0
-        );
-
-        randomVec.normalize();
-
-        data[inx * 4] = (randomVec.x * 0.5 + 0.5) * 255;
-        data[inx * 4 + 1] = (randomVec.y * 0.5 + 0.5) * 255;
-        data[inx * 4 + 2] = 127;
-        data[inx * 4 + 3] = 255;
-
-    }
-
-    const texture = ShadeTexture.from(ShadeImage.fromSampler2D(new Sampler2D(data, 4, noiseSize, noiseSize)));
-
-    texture.wrapS = TextureWrapType.Repeat;
-    texture.wrapT = TextureWrapType.Repeat;
-
-    return texture;
-
-}
-
+import Vector3 from "../../../../core/geom/Vector3.js";
+import { Sampler2D } from "../../../../engine/graphics/texture/sampler/Sampler2D.js";
+import { ShadeTexture } from "../../texture/ShadeTexture.js";
+import { ShadeImage } from "../../texture/source/ShadeImage.js";
+import { TextureWrapType } from "../../texture/TextureWrapType.js";
+import { generateMagicSquare } from "./generate_magic_square.js";
+
+/**
+ * Taken from three's GTAO implementation (`examples/jsm/shaders/GTAOShader.js`), not very good
+ * for what it is intended for.
+ *
+ * Derived from three.js (https://github.com/mrdoob/three.js), Copyright (c) 2010-2024 three.js authors, MIT licence.
+ *
+ * @param {number} size
+ * @returns {ShadeTexture}
+ */
+export function generateMagicSquareNoise(size = 5) {
+
+    const noiseSize = Math.floor(size) % 2 === 0 ? Math.floor(size) + 1 : Math.floor(size);
+    const magicSquare = generateMagicSquare(noiseSize);
+    const noiseSquareSize = magicSquare.length;
+    const data = new Uint8Array(noiseSquareSize * 4);
+
+    for (let inx = 0; inx < noiseSquareSize; ++inx) {
+
+        const iAng = magicSquare[inx];
+        const angle = (2 * Math.PI * iAng) / noiseSquareSize;
+        const randomVec = new Vector3(
+            Math.cos(angle),
+            Math.sin(angle),
+            0
+        );
+
+        randomVec.normalize();
+
+        data[inx * 4] = (randomVec.x * 0.5 + 0.5) * 255;
+        data[inx * 4 + 1] = (randomVec.y * 0.5 + 0.5) * 255;
+        data[inx * 4 + 2] = 127;
+        data[inx * 4 + 3] = 255;
+
+    }
+
+    const texture = ShadeTexture.from(ShadeImage.fromSampler2D(new Sampler2D(data, 4, noiseSize, noiseSize)));
+
+    texture.wrapS = TextureWrapType.Repeat;
+    texture.wrapT = TextureWrapType.Repeat;
+
+    return texture;
+
+}
+

package/src/shade/renderer/postprocess/nss/NSS.d.ts

@@ -49,7 +49,7 @@ export class NSS {
      * @returns {number}
      */
     static recommended_jitter_sequence_size(upscale_ratio: number): number;
-    static "__#124@#preprocess_tensor_descriptor"(render_w: any, render_h: any): TextureResourceDescriptor;
+    static "__#126@#preprocess_tensor_descriptor"(render_w: any, render_h: any): TextureResourceDescriptor;
     /**
      * @param {GraphicsContext} graphics
      */

package/src/shade/renderer/shader/chunk/texture/chunk_texture_filter_fxaa_lite.d.ts

@@ -5,6 +5,8 @@
  * `chunk_texture_filter_fxaa_quality`.
  *
  * Adapted from an early three.js port (mrdoob/three.js@d7d25d3 examples/jsm/shaders/FXAAShader.js).
+ *
+ * Derived from three.js (https://github.com/mrdoob/three.js), Copyright (c) 2010-2024 three.js authors, MIT licence.
  * @type {CodeChunk}
  */
 export const chunk_texture_filter_fxaa_lite: CodeChunk;

package/src/shade/renderer/shader/chunk/texture/chunk_texture_filter_fxaa_lite.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"chunk_texture_filter_fxaa_lite.d.ts","sourceRoot":"","sources":["../../../../../../../src/shade/renderer/shader/chunk/texture/chunk_texture_filter_fxaa_lite.js"],"names":[],"mappings":"AAGA;;;;;;;;GAQG;AACH,6CAFU,SAAS,CAqNjB;0BA/NwB,6BAA6B"}
+{"version":3,"file":"chunk_texture_filter_fxaa_lite.d.ts","sourceRoot":"","sources":["../../../../../../../src/shade/renderer/shader/chunk/texture/chunk_texture_filter_fxaa_lite.js"],"names":[],"mappings":"AAGA;;;;;;;;;;GAUG;AACH,6CAFU,SAAS,CAqNjB;0BAjOwB,6BAA6B"}

package/src/shade/renderer/shader/chunk/texture/chunk_texture_filter_fxaa_lite.js

@@ -1,224 +1,226 @@
-import { CodeChunk } from "../../compiler/CodeChunk.js";
-import { chunk_rgba_luminance_contrast } from "../color/chunk_rgba_luminance_contrast.js";
-
-/**
- * FXAA-inspired 5-tap variant — substantially simplified relative to
- * canonical NVIDIA FXAA 3.11 (no 9-tap detection, no subpixel AA, linear
- * step pattern, integer-pixel search). For higher quality use
- * `chunk_texture_filter_fxaa_quality`.
- *
- * Adapted from an early three.js port (mrdoob/three.js@d7d25d3 examples/jsm/shaders/FXAAShader.js).
- * @type {CodeChunk}
- */
-export const chunk_texture_filter_fxaa_lite = CodeChunk.from(
-    //language=WGSL
-    `
-fn texture_filter_fxaa_lite(
-    posM:vec2<u32>,
-    tex:texture_2d<f32>
-) -> vec4<f32> {
-    
-    // how far to search for edges
-    const NUM_SAMPLES = 5;
-    
-    const fxaaQualityEdgeThreshold = 0.2; // [0,1] contrast needed, otherwise early discard
-    const fxaaQualityinvEdgeThreshold = 1.0 / fxaaQualityEdgeThreshold;
-
-    let rgbaM = textureLoad(tex, posM, 0);
-    var rgbaS = textureLoad(tex, posM + vec2( 0u, 1u ), 0);
-    let rgbaE = textureLoad(tex, posM + vec2( 1u, 0u ), 0);
-    var rgbaN = textureLoad(tex, posM - vec2( 0u, 1u ), 0);
-    let rgbaW = textureLoad(tex, posM - vec2( 1u, 0u ), 0);
-    // . S .
-    // W M E
-    // . N .
-
-    let contrastN = rgba_luminance_contrast( rgbaM, rgbaN );
-    let contrastS = rgba_luminance_contrast( rgbaM, rgbaS );
-    let contrastE = rgba_luminance_contrast( rgbaM, rgbaE );
-    let contrastW = rgba_luminance_contrast( rgbaM, rgbaW );
-    
-    let earlyExit = max( max( max(
-            contrastN,
-            contrastS ),
-            contrastE ),
-            contrastW )
-            < fxaaQualityEdgeThreshold;
-            
-    // . 0 .
-    // 0 0 0
-    // . 0 .
-
-    if(earlyExit){
-        return rgbaM;
-    }
-
-
-    var relativeVContrast = ( contrastN + contrastS ) - ( contrastE + contrastW );
-    relativeVContrast *= fxaaQualityinvEdgeThreshold;
-
-    var horzSpan = relativeVContrast > 0.;
-    // . 1 .
-    // 0 0 0
-    // . 1 .
-
-    // 45 deg edge detection and corners of objects, aka V/H contrast is too similar
-    if( abs( relativeVContrast ) < .3 ) {
-        // locate the edge
-        var dirToEdge:vec2<i32>;
-        
-        if(contrastE > contrastW){
-            dirToEdge.x = 1;
-        }else{
-            dirToEdge.x = -1;
-        }
-        
-        if(contrastS > contrastN){
-            dirToEdge.y = 1;
-        }else{
-            dirToEdge.y = -1;
-        }
-        
-        // . 2 .      . 1 .
-        // 1 0 2  ~=  0 0 1
-        // . 1 .      . 0 .
-
-        // tap 2 pixels and see which ones are "outside" the edge, to
-        // determine if the edge is vertical or horizontal
-
-        let rgbaAlongH = textureLoad(tex, vec2i(posM) + vec2( dirToEdge.x, -dirToEdge.y ), 0);
-        let matchAlongH = rgba_luminance_contrast( rgbaM, rgbaAlongH );
-        // . 1 .
-        // 0 0 1
-        // . 0 H
-
-        let rgbaAlongV = textureLoad(tex, vec2i(posM) + vec2( -dirToEdge.x, dirToEdge.y ), 0);
-        let matchAlongV = rgba_luminance_contrast( rgbaM, rgbaAlongV );
-        // V 1 .
-        // 0 0 1
-        // . 0 .
-
-        relativeVContrast = matchAlongV - matchAlongH;
-        relativeVContrast *= fxaaQualityinvEdgeThreshold;
-
-        if( abs( relativeVContrast ) < .3 ) { // 45 deg edge
-            // 1 1 .
-            // 0 0 1
-            // . 0 1
-
-            // do a simple blur
-            return mix(
-                rgbaM,
-                (rgbaN + rgbaS + rgbaE + rgbaW) * .25,
-                .4
-            );
-        }
-
-        horzSpan = relativeVContrast > 0.;
-    }
-
-    if(!horzSpan) {
-        rgbaN = rgbaW;
-        rgbaS = rgbaE;
-    }
-    
-    // . 0 .      1
-    // 1 0 1  ->  0
-    // . 0 .      1
-
-    let pairN = rgba_luminance_contrast( rgbaM, rgbaN ) > rgba_luminance_contrast( rgbaM, rgbaS );
-    if(!pairN) {
-        rgbaN = rgbaS;
-    }
-
-    var offNP:vec2<u32>;
-    
-    if(!horzSpan){
-        offNP.x = 0;
-        offNP.y = 1;
-    }else{
-        offNP.x = 1;
-        offNP.y = 0;
-    }
-    
-    var doneN = false;
-    var doneP = false;
-
-    var nDist = 0u;
-    var pDist = 0u;
-
-    var posN = posM;
-    var posP = posM;
-
-    var iterationsUsedN = 0u;
-    var iterationsUsedP = 0u;
-    
-    for( var i = 0u; i < NUM_SAMPLES; i++ ) {
-
-        let increment = (i + 1);
-
-        if(!doneN) {
-            nDist += increment;
-            posN = posM + offNP * nDist;
-            
-            let rgbaEndN = textureLoad(tex, posN.xy, 0);
-            
-            doneN = rgba_luminance_contrast( rgbaEndN, rgbaM ) > rgba_luminance_contrast( rgbaEndN, rgbaN );
-            iterationsUsedN = i;
-        }
-
-        if(!doneP) {
-            pDist += increment;
-            posP = posM - offNP * pDist;
-            
-            let rgbaEndP = textureLoad(tex, posP.xy, 0);
-            
-            doneP = rgba_luminance_contrast( rgbaEndP, rgbaM ) > rgba_luminance_contrast( rgbaEndP, rgbaN );
-            iterationsUsedP = i;
-        }
-
-        if(doneN || doneP) {
-            break;
-        }
-    }
-
-
-    if ( !doneP && !doneN ) {
-        // failed to find end of edge
-        return rgbaM;
-    } 
-
-    var distN:f32;
-    if(doneN){
-        distN = f32( iterationsUsedN ) / f32( NUM_SAMPLES - 1 );
-    }else{
-        distN = 1.0;
-    }
-    
-    var distP:f32;
-    if(doneP){
-        distP = f32( iterationsUsedP ) / f32( NUM_SAMPLES - 1 );
-    }else{
-        distP = 1.0;
-    }
-
-    var dist:f32 = min(distN, distP);
-     
-
-    // hacky way of reduces blurriness of mostly diagonal edges
-    // but reduces AA quality
-    dist = pow(dist, .5);
-
-    dist = 1. - dist;
-
-    return mix(
-        rgbaM,
-        rgbaN,
-        dist * .5
-    );
-}
-`,
-    [
-        chunk_rgba_luminance_contrast
-    ]
+import { CodeChunk } from "../../compiler/CodeChunk.js";
+import { chunk_rgba_luminance_contrast } from "../color/chunk_rgba_luminance_contrast.js";
+
+/**
+ * FXAA-inspired 5-tap variant — substantially simplified relative to
+ * canonical NVIDIA FXAA 3.11 (no 9-tap detection, no subpixel AA, linear
+ * step pattern, integer-pixel search). For higher quality use
+ * `chunk_texture_filter_fxaa_quality`.
+ *
+ * Adapted from an early three.js port (mrdoob/three.js@d7d25d3 examples/jsm/shaders/FXAAShader.js).
+ *
+ * Derived from three.js (https://github.com/mrdoob/three.js), Copyright (c) 2010-2024 three.js authors, MIT licence.
+ * @type {CodeChunk}
+ */
+export const chunk_texture_filter_fxaa_lite = CodeChunk.from(
+    //language=WGSL
+    `
+fn texture_filter_fxaa_lite(
+    posM:vec2<u32>,
+    tex:texture_2d<f32>
+) -> vec4<f32> {
+    
+    // how far to search for edges
+    const NUM_SAMPLES = 5;
+    
+    const fxaaQualityEdgeThreshold = 0.2; // [0,1] contrast needed, otherwise early discard
+    const fxaaQualityinvEdgeThreshold = 1.0 / fxaaQualityEdgeThreshold;
+
+    let rgbaM = textureLoad(tex, posM, 0);
+    var rgbaS = textureLoad(tex, posM + vec2( 0u, 1u ), 0);
+    let rgbaE = textureLoad(tex, posM + vec2( 1u, 0u ), 0);
+    var rgbaN = textureLoad(tex, posM - vec2( 0u, 1u ), 0);
+    let rgbaW = textureLoad(tex, posM - vec2( 1u, 0u ), 0);
+    // . S .
+    // W M E
+    // . N .
+
+    let contrastN = rgba_luminance_contrast( rgbaM, rgbaN );
+    let contrastS = rgba_luminance_contrast( rgbaM, rgbaS );
+    let contrastE = rgba_luminance_contrast( rgbaM, rgbaE );
+    let contrastW = rgba_luminance_contrast( rgbaM, rgbaW );
+    
+    let earlyExit = max( max( max(
+            contrastN,
+            contrastS ),
+            contrastE ),
+            contrastW )
+            < fxaaQualityEdgeThreshold;
+            
+    // . 0 .
+    // 0 0 0
+    // . 0 .
+
+    if(earlyExit){
+        return rgbaM;
+    }
+
+
+    var relativeVContrast = ( contrastN + contrastS ) - ( contrastE + contrastW );
+    relativeVContrast *= fxaaQualityinvEdgeThreshold;
+
+    var horzSpan = relativeVContrast > 0.;
+    // . 1 .
+    // 0 0 0
+    // . 1 .
+
+    // 45 deg edge detection and corners of objects, aka V/H contrast is too similar
+    if( abs( relativeVContrast ) < .3 ) {
+        // locate the edge
+        var dirToEdge:vec2<i32>;
+        
+        if(contrastE > contrastW){
+            dirToEdge.x = 1;
+        }else{
+            dirToEdge.x = -1;
+        }
+        
+        if(contrastS > contrastN){
+            dirToEdge.y = 1;
+        }else{
+            dirToEdge.y = -1;
+        }
+        
+        // . 2 .      . 1 .
+        // 1 0 2  ~=  0 0 1
+        // . 1 .      . 0 .
+
+        // tap 2 pixels and see which ones are "outside" the edge, to
+        // determine if the edge is vertical or horizontal
+
+        let rgbaAlongH = textureLoad(tex, vec2i(posM) + vec2( dirToEdge.x, -dirToEdge.y ), 0);
+        let matchAlongH = rgba_luminance_contrast( rgbaM, rgbaAlongH );
+        // . 1 .
+        // 0 0 1
+        // . 0 H
+
+        let rgbaAlongV = textureLoad(tex, vec2i(posM) + vec2( -dirToEdge.x, dirToEdge.y ), 0);
+        let matchAlongV = rgba_luminance_contrast( rgbaM, rgbaAlongV );
+        // V 1 .
+        // 0 0 1
+        // . 0 .
+
+        relativeVContrast = matchAlongV - matchAlongH;
+        relativeVContrast *= fxaaQualityinvEdgeThreshold;
+
+        if( abs( relativeVContrast ) < .3 ) { // 45 deg edge
+            // 1 1 .
+            // 0 0 1
+            // . 0 1
+
+            // do a simple blur
+            return mix(
+                rgbaM,
+                (rgbaN + rgbaS + rgbaE + rgbaW) * .25,
+                .4
+            );
+        }
+
+        horzSpan = relativeVContrast > 0.;
+    }
+
+    if(!horzSpan) {
+        rgbaN = rgbaW;
+        rgbaS = rgbaE;
+    }
+    
+    // . 0 .      1
+    // 1 0 1  ->  0
+    // . 0 .      1
+
+    let pairN = rgba_luminance_contrast( rgbaM, rgbaN ) > rgba_luminance_contrast( rgbaM, rgbaS );
+    if(!pairN) {
+        rgbaN = rgbaS;
+    }
+
+    var offNP:vec2<u32>;
+    
+    if(!horzSpan){
+        offNP.x = 0;
+        offNP.y = 1;
+    }else{
+        offNP.x = 1;
+        offNP.y = 0;
+    }
+    
+    var doneN = false;
+    var doneP = false;
+
+    var nDist = 0u;
+    var pDist = 0u;
+
+    var posN = posM;
+    var posP = posM;
+
+    var iterationsUsedN = 0u;
+    var iterationsUsedP = 0u;
+    
+    for( var i = 0u; i < NUM_SAMPLES; i++ ) {
+
+        let increment = (i + 1);
+
+        if(!doneN) {
+            nDist += increment;
+            posN = posM + offNP * nDist;
+            
+            let rgbaEndN = textureLoad(tex, posN.xy, 0);
+            
+            doneN = rgba_luminance_contrast( rgbaEndN, rgbaM ) > rgba_luminance_contrast( rgbaEndN, rgbaN );
+            iterationsUsedN = i;
+        }
+
+        if(!doneP) {
+            pDist += increment;
+            posP = posM - offNP * pDist;
+            
+            let rgbaEndP = textureLoad(tex, posP.xy, 0);
+            
+            doneP = rgba_luminance_contrast( rgbaEndP, rgbaM ) > rgba_luminance_contrast( rgbaEndP, rgbaN );
+            iterationsUsedP = i;
+        }
+
+        if(doneN || doneP) {
+            break;
+        }
+    }
+
+
+    if ( !doneP && !doneN ) {
+        // failed to find end of edge
+        return rgbaM;
+    } 
+
+    var distN:f32;
+    if(doneN){
+        distN = f32( iterationsUsedN ) / f32( NUM_SAMPLES - 1 );
+    }else{
+        distN = 1.0;
+    }
+    
+    var distP:f32;
+    if(doneP){
+        distP = f32( iterationsUsedP ) / f32( NUM_SAMPLES - 1 );
+    }else{
+        distP = 1.0;
+    }
+
+    var dist:f32 = min(distN, distP);
+     
+
+    // hacky way of reduces blurriness of mostly diagonal edges
+    // but reduces AA quality
+    dist = pow(dist, .5);
+
+    dist = 1. - dist;
+
+    return mix(
+        rgbaM,
+        rgbaN,
+        dist * .5
+    );
+}
+`,
+    [
+        chunk_rgba_luminance_contrast
+    ]
 );

package/src/shade/renderer/shadow/map/DirectionalLightShadowmap.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"DirectionalLightShadowmap.d.ts","sourceRoot":"","sources":["../../../../../../src/shade/renderer/shadow/map/DirectionalLightShadowmap.js"],"names":[],"mappings":"AAkGA;IACI;;;OAGG;IACH,cAFU,MAAM,CAEC;IAEjB;;;OAGG;IACH,cAFU,MAAM,CAEC;IAEjB,qBAAuD;IAEvD,+CA2PC;IAED,qBAYC;CAEJ;0BAjWyB,gBAAgB"}
+{"version":3,"file":"DirectionalLightShadowmap.d.ts","sourceRoot":"","sources":["../../../../../../src/shade/renderer/shadow/map/DirectionalLightShadowmap.js"],"names":[],"mappings":"AAkGA;IACI;;;OAGG;IACH,cAFU,MAAM,CAEC;IAEjB;;;OAGG;IACH,cAFU,MAAM,CAEC;IAEjB,qBAAuD;IAEvD,+CA+PC;IAED,qBAYC;CAEJ;0BArWyB,gBAAgB"}

package/src/shade/renderer/shadow/map/DirectionalLightShadowmap.js

@@ -14,6 +14,7 @@ import { frustum_slice } from "../../../../core/geom/3d/frustum/frustum_slice.js
 import { compose_matrix4_array } from "../../../../core/geom/3d/mat4/compose_matrix4_array.js";
 import { m4_invert } from "../../../../core/geom/3d/mat4/m4_invert.js";
 import { m4_multiply } from "../../../../core/geom/3d/mat4/m4_multiply.js";
+import { m4_orthographic_off_center_z0 } from "../../../../core/geom/3d/mat4/m4_orthographic_off_center_z0.js";
 import Quaternion from "../../../../core/geom/Quaternion.js";
 import { v3_array_centroid } from "../../../../core/geom/vec3/v3_array_centroid.js";
 import Vector3 from "../../../../core/geom/Vector3.js";
@@ -22,7 +23,6 @@ import { inverseLerp } from "../../../../core/math/inverseLerp.js";
 import {
     quaternion_invert_orientation
 } from "../../../../engine/graphics/ecs/camera/quaternion_invert_orientation.js";
-import { mat4 } from "gl-matrix";
 import { SHADOWMAP_CSM_CASCADE_BLEND_FRACTION } from "./csm/SHADOWMAP_CSM_CASCADE_BLEND_FRACTION.js";
 import { SHADOWMAP_CSM_CASCADE_COUNT } from "./csm/SHADOWMAP_CSM_CASCADE_COUNT.js";
 import { Shadowmap } from "./Shadowmap.js";
@@ -271,8 +271,12 @@ export class DirectionalLightShadowmap extends Shadowmap {
 
                 const shadow_proj = new Float32Array(16);
 
-                // the z range here is irrelevant: planes 4/5 are relaxed by the query
-                mat4.orthoZO(
+                // The z range here is irrelevant: planes 4/5 are relaxed by the query, which
+                // keeps their normals and recomputes only their offsets. This projection looks
+                // down +z where the light's view space looks down -z, which swaps those two
+                // planes over — and the loop below reads both and takes the nearer, so the swap
+                // does not reach the result.
+                m4_orthographic_off_center_z0(
                     shadow_proj,
                     extents.x0, extents.x1,
                     extents.y0, extents.y1,

package/src/view/minimap/dom/MinimapCameraView.d.ts

@@ -23,8 +23,8 @@ export class MinimapCameraView extends View {
     camera: Camera;
     /**
      * **The frame is traced with the renderer's own ray, not the camera component's.**
-     * `Camera.projectRay` goes through `camera.object`, a three.js camera that only the legacy
-     * `CameraSystem` builds — under Shade it is never built, so every update warned and drew
+     * `Camera.projectRay` went through a three camera object that only the legacy camera
+     * system built — under Shade it was never built, so every update warned and drew
      * nothing. `viewportProjectionRay` is the one picking primitive both engines answer with the
      * same meaning, and it reports the camera that actually drew.
      *