@ifc-lite/renderer 5.0.0 → 6.0.1

package/dist/shaders/depth-reconstruct.wgsl.js

@@ -10,14 +10,19 @@
  * camera projection (see `depthReconstructParams`).
  */
 /**
- * Declares `depthTex` at `@group(0) @binding(binding)` and `loadDepth(ip)`,
+ * Declares `depthTex` at `@group(group) @binding(binding)` and `loadDepth(ip)`,
  * which clamps the coordinate to the texture and reads sample 0 when the
  * attachment is multisampled.
+ *
+ * `group` must match the index of the bind-group layout that carries the
+ * depth texture in the caller's pipeline layout. The full-screen passes (AO,
+ * edges) own group 0; the selection mask draws mesh geometry, so group 0 is
+ * the mesh uniform and the depth texture sits in group 1 (#5390).
  */
-export function depthTextureWgsl(binding, multisampled) {
+export function depthTextureWgsl(binding, multisampled, group = 0) {
     const type = multisampled ? 'texture_depth_multisampled_2d' : 'texture_depth_2d';
     return `
-        @group(0) @binding(${binding}) var depthTex: ${type};
+        @group(${group}) @binding(${binding}) var depthTex: ${type};
 
         fn loadDepth(ip: vec2<i32>) -> f32 {
           let dims = vec2<i32>(textureDimensions(depthTex));

package/dist/shaders/depth-reconstruct.wgsl.js.map

@@ -1 +1 @@
-{"version":3,"file":"depth-reconstruct.wgsl.js","sourceRoot":"","sources":["../../src/shaders/depth-reconstruct.wgsl.ts"],"names":[],"mappings":"AAAA;;+DAE+D;AAE/D;;;;;;;GAOG;AAEH;;;;GAIG;AACH,MAAM,UAAU,gBAAgB,CAAC,OAAe,EAAE,YAAqB;IACrE,MAAM,IAAI,GAAG,YAAY,CAAC,CAAC,CAAC,+BAA+B,CAAC,CAAC,CAAC,kBAAkB,CAAC;IACjF,OAAO;6BACoB,OAAO,mBAAmB,IAAI;;;;;;CAM1D,CAAC;AACF,CAAC;AAED,MAAM,CAAC,MAAM,oBAAoB,GAAG;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAwCnC,CAAC"}
+{"version":3,"file":"depth-reconstruct.wgsl.js","sourceRoot":"","sources":["../../src/shaders/depth-reconstruct.wgsl.ts"],"names":[],"mappings":"AAAA;;+DAE+D;AAE/D;;;;;;;GAOG;AAEH;;;;;;;;;GASG;AACH,MAAM,UAAU,gBAAgB,CAAC,OAAe,EAAE,YAAqB,EAAE,KAAK,GAAG,CAAC;IAChF,MAAM,IAAI,GAAG,YAAY,CAAC,CAAC,CAAC,+BAA+B,CAAC,CAAC,CAAC,kBAAkB,CAAC;IACjF,OAAO;iBACQ,KAAK,cAAc,OAAO,mBAAmB,IAAI;;;;;;CAMjE,CAAC;AACF,CAAC;AAED,MAAM,CAAC,MAAM,oBAAoB,GAAG;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAwCnC,CAAC"}

package/dist/shaders/edges.wgsl.d.ts

@@ -1,2 +1,20 @@
 export declare function edgeShaderSource(multisampled: boolean): string;
+/**
+ * Selection/hover outline composite (#5390): outlines the mask the
+ * selection-mask pass wrote (`selection-mask-pass.ts`), sharing this
+ * module's fullscreen-triangle vertex stage with the geometry edge pass
+ * above (DRY, per the #5385/#5390 design note) even though the two run as
+ * separate draws with different blend states (this one is a normal
+ * alpha-over composite; the geometry pass above is darken-only).
+ *
+ * Coverage is a ring around the mask boundary: the distance to the nearest
+ * mask pixel that differs from this one, searched within
+ * `OUTLINE_SEARCH_RADIUS`, mapped through `outlineCoverage`
+ * (`outline-params.ts`): full within `OUTLINE_WIDTH_PX` of the boundary on
+ * either side, fading over the next pixel. (Averaging 4 neighbour taps
+ * instead gives a straight edge only 1/4 coverage, a 1 px line too faint to
+ * see.) No depth/normal reconstruction needed: a mask boundary is
+ * unambiguous on its own.
+ */
+export declare function outlineFragmentSource(): string;
 //# sourceMappingURL=edges.wgsl.d.ts.map

package/dist/shaders/edges.wgsl.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"edges.wgsl.d.ts","sourceRoot":"","sources":["../../src/shaders/edges.wgsl.ts"],"names":[],"mappings":"AA0BA,wBAAgB,gBAAgB,CAAC,YAAY,EAAE,OAAO,GAAG,MAAM,CAqI9D"}
+{"version":3,"file":"edges.wgsl.d.ts","sourceRoot":"","sources":["../../src/shaders/edges.wgsl.ts"],"names":[],"mappings":"AA2BA,wBAAgB,gBAAgB,CAAC,YAAY,EAAE,OAAO,GAAG,MAAM,CAqI9D;AAED;;;;;;;;;;;;;;;;GAgBG;AACH,wBAAgB,qBAAqB,IAAI,MAAM,CAgF9C"}

package/dist/shaders/edges.wgsl.js

@@ -21,6 +21,7 @@
  * this generalises it to all three cues and both new tests).
  */
 import { EDGE_CREASE_COS, EDGE_MAX_DARKEN, EDGE_SILHOUETTE_REL_THRESHOLD } from '../edge-params.js';
+import { OUTLINE_SEARCH_RADIUS, OUTLINE_WIDTH_PX, SELECTION_HIDDEN_ALPHA } from '../outline-params.js';
 import { depthReconstructWgsl, depthTextureWgsl } from './depth-reconstruct.wgsl.js';
 export function edgeShaderSource(multisampled) {
     // Multisampled and non-multisampled `textureLoad` share this call shape:
@@ -155,4 +156,102 @@ export function edgeShaderSource(multisampled) {
         }
 `;
 }
+/**
+ * Selection/hover outline composite (#5390): outlines the mask the
+ * selection-mask pass wrote (`selection-mask-pass.ts`), sharing this
+ * module's fullscreen-triangle vertex stage with the geometry edge pass
+ * above (DRY, per the #5385/#5390 design note) even though the two run as
+ * separate draws with different blend states (this one is a normal
+ * alpha-over composite; the geometry pass above is darken-only).
+ *
+ * Coverage is a ring around the mask boundary: the distance to the nearest
+ * mask pixel that differs from this one, searched within
+ * `OUTLINE_SEARCH_RADIUS`, mapped through `outlineCoverage`
+ * (`outline-params.ts`): full within `OUTLINE_WIDTH_PX` of the boundary on
+ * either side, fading over the next pixel. (Averaging 4 neighbour taps
+ * instead gives a straight edge only 1/4 coverage, a 1 px line too faint to
+ * see.) No depth/normal reconstruction needed: a mask boundary is
+ * unambiguous on its own.
+ */
+export function outlineFragmentSource() {
+    return `
+        struct OutlineParams {
+          viewport: vec4<f32>,       // width, height, unused, unused
+          selectionColor: vec4<f32>, // rgb, visible alpha
+          hoverColor: vec4<f32>,     // rgb, visible alpha
+        }
+
+        @group(0) @binding(0) var maskVisible: texture_2d<f32>;
+        @group(0) @binding(1) var maskAll: texture_2d<f32>;
+        @group(0) @binding(2) var<uniform> params: OutlineParams;
+
+        const SELECTION_HIDDEN_ALPHA: f32 = ${SELECTION_HIDDEN_ALPHA.toFixed(3)};
+
+        struct VsOut {
+          @builtin(position) pos: vec4<f32>,
+        }
+
+        @vertex
+        fn vs_fullscreen(@builtin(vertex_index) v: u32) -> VsOut {
+          var p = array<vec2<f32>, 3>(
+            vec2<f32>(-1.0, -3.0),
+            vec2<f32>(-1.0,  1.0),
+            vec2<f32>( 3.0,  1.0)
+          );
+          var o: VsOut;
+          o.pos = vec4<f32>(p[v], 0.0, 1.0);
+          return o;
+        }
+
+        fn loadClamped(tex: texture_2d<f32>, ip: vec2<i32>, dims: vec2<i32>) -> vec4<f32> {
+          return textureLoad(tex, clamp(ip, vec2<i32>(0), dims - 1), 0);
+        }
+
+        const OUTLINE_SEARCH_RADIUS: i32 = ${OUTLINE_SEARCH_RADIUS};
+        const OUTLINE_WIDTH_PX: f32 = ${OUTLINE_WIDTH_PX.toFixed(3)};
+
+        // Ring coverage astride the mask boundary (outline-params.ts's
+        // outlineCoverage): distance to the nearest pixel whose channel
+        // differs from this one, full within OUTLINE_WIDTH_PX, 0 one pixel on.
+        fn boundaryCoverage(tex: texture_2d<f32>, channel: u32, p: vec2<i32>, dims: vec2<i32>) -> f32 {
+          let center = loadClamped(tex, p, dims)[channel] > 0.5;
+          var nearest = 1e4;
+          for (var dy = -OUTLINE_SEARCH_RADIUS; dy <= OUTLINE_SEARCH_RADIUS; dy = dy + 1) {
+            for (var dx = -OUTLINE_SEARCH_RADIUS; dx <= OUTLINE_SEARCH_RADIUS; dx = dx + 1) {
+              if ((loadClamped(tex, p + vec2<i32>(dx, dy), dims)[channel] > 0.5) != center) {
+                nearest = min(nearest, length(vec2<f32>(f32(dx), f32(dy))));
+              }
+            }
+          }
+          return clamp(OUTLINE_WIDTH_PX + 0.5 - nearest, 0.0, 1.0);
+        }
+
+        @fragment
+        fn fs_outline(@builtin(position) fragPos: vec4<f32>) -> @location(0) vec4<f32> {
+          let dims = vec2<i32>(params.viewport.xy);
+          let p = vec2<i32>(fragPos.xy);
+
+          let visibleCoverage = boundaryCoverage(maskVisible, 0u, p, dims);
+          let allCoverage = boundaryCoverage(maskAll, 0u, p, dims);
+          let hoverCoverage = boundaryCoverage(maskVisible, 1u, p, dims);
+
+          // The "hidden" ring is the silhouette of the unoccluded shape
+          // (maskAll) wherever this pixel is not itself part of the visible
+          // selection — so it does not double up with the solid ring.
+          let centerVisible = loadClamped(maskVisible, p, dims).r;
+          let hiddenCoverage = allCoverage * (1.0 - centerVisible);
+
+          let selectionAlpha = clamp(
+            max(visibleCoverage * params.selectionColor.a, hiddenCoverage * SELECTION_HIDDEN_ALPHA),
+            0.0, 1.0,
+          );
+          if (selectionAlpha > 0.001) {
+            return vec4<f32>(params.selectionColor.rgb * selectionAlpha, selectionAlpha);
+          }
+
+          let hoverAlpha = clamp(hoverCoverage * params.hoverColor.a, 0.0, 1.0);
+          return vec4<f32>(params.hoverColor.rgb * hoverAlpha, hoverAlpha);
+        }
+`;
+}
 //# sourceMappingURL=edges.wgsl.js.map

package/dist/shaders/edges.wgsl.js.map

@@ -1 +1 @@
-{"version":3,"file":"edges.wgsl.js","sourceRoot":"","sources":["../../src/shaders/edges.wgsl.ts"],"names":[],"mappings":"AAAA;;+DAE+D;AAE/D;;;;;;;;;;;;;;;;;;GAkBG;AACH,OAAO,EAAE,eAAe,EAAE,eAAe,EAAE,6BAA6B,EAAE,MAAM,mBAAmB,CAAC;AACpG,OAAO,EAAE,oBAAoB,EAAE,gBAAgB,EAAE,MAAM,6BAA6B,CAAC;AAErF,MAAM,UAAU,gBAAgB,CAAC,YAAqB;IACpD,yEAAyE;IACzE,yEAAyE;IACzE,yEAAyE;IACzE,wBAAwB;IACxB,MAAM,SAAS,GAAG,YAAY;QAC5B,CAAC,CAAC,gEAAgE;QAClE,CAAC,CAAC,mDAAmD,CAAC;IAExD,OAAO;;;;;;;;UAQC,gBAAgB,CAAC,CAAC,EAAE,YAAY,CAAC;UACjC,SAAS;;;UAGT,oBAAoB;;uCAES,eAAe,CAAC,OAAO,CAAC,CAAC,CAAC;2CACtB,6BAA6B,CAAC,OAAO,CAAC,CAAC,CAAC;uCAC5C,eAAe,CAAC,OAAO,CAAC,CAAC,CAAC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CA2GhE,CAAC;AACF,CAAC"}
+{"version":3,"file":"edges.wgsl.js","sourceRoot":"","sources":["../../src/shaders/edges.wgsl.ts"],"names":[],"mappings":"AAAA;;+DAE+D;AAE/D;;;;;;;;;;;;;;;;;;GAkBG;AACH,OAAO,EAAE,eAAe,EAAE,eAAe,EAAE,6BAA6B,EAAE,MAAM,mBAAmB,CAAC;AACpG,OAAO,EAAE,qBAAqB,EAAE,gBAAgB,EAAE,sBAAsB,EAAE,MAAM,sBAAsB,CAAC;AACvG,OAAO,EAAE,oBAAoB,EAAE,gBAAgB,EAAE,MAAM,6BAA6B,CAAC;AAErF,MAAM,UAAU,gBAAgB,CAAC,YAAqB;IACpD,yEAAyE;IACzE,yEAAyE;IACzE,yEAAyE;IACzE,wBAAwB;IACxB,MAAM,SAAS,GAAG,YAAY;QAC5B,CAAC,CAAC,gEAAgE;QAClE,CAAC,CAAC,mDAAmD,CAAC;IAExD,OAAO;;;;;;;;UAQC,gBAAgB,CAAC,CAAC,EAAE,YAAY,CAAC;UACjC,SAAS;;;UAGT,oBAAoB;;uCAES,eAAe,CAAC,OAAO,CAAC,CAAC,CAAC;2CACtB,6BAA6B,CAAC,OAAO,CAAC,CAAC,CAAC;uCAC5C,eAAe,CAAC,OAAO,CAAC,CAAC,CAAC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CA2GhE,CAAC;AACF,CAAC;AAED;;;;;;;;;;;;;;;;GAgBG;AACH,MAAM,UAAU,qBAAqB;IACnC,OAAO;;;;;;;;;;;8CAWqC,sBAAsB,CAAC,OAAO,CAAC,CAAC,CAAC;;;;;;;;;;;;;;;;;;;;;;6CAsBlC,qBAAqB;wCAC1B,gBAAgB,CAAC,OAAO,CAAC,CAAC,CAAC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CA4ClE,CAAC;AACF,CAAC"}

package/dist/shaders/entity-color-table.wgsl.d.ts

@@ -0,0 +1,2 @@
+export declare const entityColorTableWgsl = "\n        @binding(5) @group(1) var<storage, read> entityColorTable: array<u32>;\n        const ENTITY_COLOR_EMPTY: u32 = 4294967295u;\n        const ENTITY_COLOR_HEADER: u32 = 4u;\n        const OVERRIDE_PAINT: u32 = 1u;\n        const OVERRIDE_EMPHASIZE: u32 = 2u;\n\n        fn entityColorSlotHash(key: u32) -> u32 {\n          var h = key;\n          h = h ^ (h >> 16u);\n          h = h * 0x85ebca6bu;\n          h = h ^ (h >> 13u);\n          h = h * 0xc2b2ae35u;\n          h = h ^ (h >> 16u);\n          return h;\n        }\n\n        // Full scene id behind a 24-bit lane, given the draw's smallest id.\n        fn resolveLaneEntityId(anchor: u32, lane: u32) -> u32 {\n          return anchor + ((lane - anchor) & 0x00FFFFFFu);\n        }\n\n        // The override colour for this fragment's entity; alpha < 0 = none.\n        fn entityOverrideColor(lane: u32) -> vec4<f32> {\n          let none = vec4<f32>(0.0, 0.0, 0.0, -1.0);\n          if ((uniforms.overrideParams.y & OVERRIDE_PAINT) == 0u || entityColorTable[2] == 0u) {\n            return none;\n          }\n          let capacity = entityColorTable[0];\n          let maxProbe = entityColorTable[1];\n          let colorBase = entityColorTable[3];\n          let id = resolveLaneEntityId(uniforms.overrideParams.x, lane);\n          let mask = capacity - 1u;\n          var slot = entityColorSlotHash(id) & mask;\n          for (var i = 0u; i <= maxProbe && i < capacity; i = i + 1u) {\n            let key = entityColorTable[ENTITY_COLOR_HEADER + slot];\n            if (key == id) {\n              let c = colorBase + slot * 4u;\n              return vec4<f32>(\n                bitcast<f32>(entityColorTable[c]),\n                bitcast<f32>(entityColorTable[c + 1u]),\n                bitcast<f32>(entityColorTable[c + 2u]),\n                bitcast<f32>(entityColorTable[c + 3u])\n              );\n            }\n            if (key == ENTITY_COLOR_EMPTY) {\n              break;\n            }\n            slot = (slot + 1u) & mask;\n          }\n          return none;\n        }\n\n        // Composite an override over the fragment's own encoded colour exactly\n        // as the retired equal-depth overlay pass blended it (src-alpha over\n        // the base draw): the override albedo lit by the same irradiance, no\n        // specular, the same roll-off and edge darkening, mixed by its alpha.\n        // Emphasized overrides are unlit, faintly faceted and opaque (#1277).\n        fn paintEntityOverride(base: vec4<f32>, ov: vec4<f32>, irradiance: vec3<f32>, N: vec3<f32>) -> vec4<f32> {\n          let albedo = srgbToLinear(ov.rgb);\n          var lit = albedo * irradiance;\n          var a = ov.a;\n          if ((uniforms.overrideParams.y & OVERRIDE_EMPHASIZE) != 0u) {\n            lit = albedo * (0.85 + 0.15 * abs(dot(N, normalize(vec3<f32>(0.3, 1.0, 0.2)))));\n            a = 1.0;\n          }\n          let encoded = linearToSrgb(clamp(neutralCompress(lit), vec3<f32>(0.0), vec3<f32>(1.0)));\n          return vec4<f32>(mix(base.rgb, encoded, a), a + (1.0 - a) * base.a);\n        }\n";
+//# sourceMappingURL=entity-color-table.wgsl.d.ts.map

package/dist/shaders/entity-color-table.wgsl.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"entity-color-table.wgsl.d.ts","sourceRoot":"","sources":["../../src/shaders/entity-color-table.wgsl.ts"],"names":[],"mappings":"AAgBA,eAAO,MAAM,oBAAoB,mhGAqEhC,CAAC"}

package/dist/shaders/entity-color-table.wgsl.js

@@ -0,0 +1,85 @@
+/* This Source Code Form is subject to the terms of the Mozilla Public
+ * License, v. 2.0. If a copy of the MPL was not distributed with this
+ * file, You can obtain one at https://mozilla.org/MPL/2.0/. */
+/**
+ * WGSL half of the per-entity colour table (#6076; layout, anchor rule and
+ * memory bound in `entity-color-table.ts`, whose `lookupEntityColor` and
+ * `resolveLaneEntityId` are the CPU mirrors of the functions below).
+ *
+ * Inlined into main.wgsl.ts after the Uniforms struct and the colour-transfer
+ * helpers, so it reads `uniforms.overrideParams` and reuses `srgbToLinear`,
+ * `neutralCompress` and `linearToSrgb`. The table sits at group(1) binding 5,
+ * beside the lighting environment, because it is scene-global.
+ */
+import { ENTITY_COLOR_EMPTY_KEY, ENTITY_COLOR_HEADER_WORDS, OVERRIDE_PARAM_EMPHASIZE, OVERRIDE_PARAM_PAINT } from '../entity-color-table.js';
+export const entityColorTableWgsl = `
+        @binding(5) @group(1) var<storage, read> entityColorTable: array<u32>;
+        const ENTITY_COLOR_EMPTY: u32 = ${ENTITY_COLOR_EMPTY_KEY}u;
+        const ENTITY_COLOR_HEADER: u32 = ${ENTITY_COLOR_HEADER_WORDS}u;
+        const OVERRIDE_PAINT: u32 = ${OVERRIDE_PARAM_PAINT}u;
+        const OVERRIDE_EMPHASIZE: u32 = ${OVERRIDE_PARAM_EMPHASIZE}u;
+
+        fn entityColorSlotHash(key: u32) -> u32 {
+          var h = key;
+          h = h ^ (h >> 16u);
+          h = h * 0x85ebca6bu;
+          h = h ^ (h >> 13u);
+          h = h * 0xc2b2ae35u;
+          h = h ^ (h >> 16u);
+          return h;
+        }
+
+        // Full scene id behind a 24-bit lane, given the draw's smallest id.
+        fn resolveLaneEntityId(anchor: u32, lane: u32) -> u32 {
+          return anchor + ((lane - anchor) & 0x00FFFFFFu);
+        }
+
+        // The override colour for this fragment's entity; alpha < 0 = none.
+        fn entityOverrideColor(lane: u32) -> vec4<f32> {
+          let none = vec4<f32>(0.0, 0.0, 0.0, -1.0);
+          if ((uniforms.overrideParams.y & OVERRIDE_PAINT) == 0u || entityColorTable[2] == 0u) {
+            return none;
+          }
+          let capacity = entityColorTable[0];
+          let maxProbe = entityColorTable[1];
+          let colorBase = entityColorTable[3];
+          let id = resolveLaneEntityId(uniforms.overrideParams.x, lane);
+          let mask = capacity - 1u;
+          var slot = entityColorSlotHash(id) & mask;
+          for (var i = 0u; i <= maxProbe && i < capacity; i = i + 1u) {
+            let key = entityColorTable[ENTITY_COLOR_HEADER + slot];
+            if (key == id) {
+              let c = colorBase + slot * 4u;
+              return vec4<f32>(
+                bitcast<f32>(entityColorTable[c]),
+                bitcast<f32>(entityColorTable[c + 1u]),
+                bitcast<f32>(entityColorTable[c + 2u]),
+                bitcast<f32>(entityColorTable[c + 3u])
+              );
+            }
+            if (key == ENTITY_COLOR_EMPTY) {
+              break;
+            }
+            slot = (slot + 1u) & mask;
+          }
+          return none;
+        }
+
+        // Composite an override over the fragment's own encoded colour exactly
+        // as the retired equal-depth overlay pass blended it (src-alpha over
+        // the base draw): the override albedo lit by the same irradiance, no
+        // specular, the same roll-off and edge darkening, mixed by its alpha.
+        // Emphasized overrides are unlit, faintly faceted and opaque (#1277).
+        fn paintEntityOverride(base: vec4<f32>, ov: vec4<f32>, irradiance: vec3<f32>, N: vec3<f32>) -> vec4<f32> {
+          let albedo = srgbToLinear(ov.rgb);
+          var lit = albedo * irradiance;
+          var a = ov.a;
+          if ((uniforms.overrideParams.y & OVERRIDE_EMPHASIZE) != 0u) {
+            lit = albedo * (0.85 + 0.15 * abs(dot(N, normalize(vec3<f32>(0.3, 1.0, 0.2)))));
+            a = 1.0;
+          }
+          let encoded = linearToSrgb(clamp(neutralCompress(lit), vec3<f32>(0.0), vec3<f32>(1.0)));
+          return vec4<f32>(mix(base.rgb, encoded, a), a + (1.0 - a) * base.a);
+        }
+`;
+//# sourceMappingURL=entity-color-table.wgsl.js.map

package/dist/shaders/entity-color-table.wgsl.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"entity-color-table.wgsl.js","sourceRoot":"","sources":["../../src/shaders/entity-color-table.wgsl.ts"],"names":[],"mappings":"AAAA;;+DAE+D;AAE/D;;;;;;;;;GASG;AACH,OAAO,EAAE,sBAAsB,EAAE,yBAAyB,EAAE,wBAAwB,EAAE,oBAAoB,EAAE,MAAM,0BAA0B,CAAC;AAE7I,MAAM,CAAC,MAAM,oBAAoB,GAAG;;0CAEM,sBAAsB;2CACrB,yBAAyB;sCAC9B,oBAAoB;0CAChB,wBAAwB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAgEjE,CAAC"}

package/dist/shaders/main.wgsl.d.ts

@@ -1,2 +1,2 @@
-export declare const mainShaderSource = "\n        struct Uniforms {\n          viewProj: mat4x4<f32>,\n          model: mat4x4<f32>,\n          baseColor: vec4<f32>,\n          metallicRoughness: vec2<f32>, // x = metallic, y = roughness (mesh-material.ts)\n          transmission: vec2<f32>,      // x = 1: authored translucent, drawn as glass; y = pad\n          sectionPlane: vec4<f32>,      // xyz = plane normal, w = plane distance\n          flags: vec4<u32>,             // x = isSelected, y = section/clip bits, z = edgeEnabled, w = edgeIntensityMilli\n          clipBoxMin: vec4<f32>,        // xyz = clip-box min corner (world), w = pad\n          clipBoxMax: vec4<f32>,        // xyz = clip-box max corner (world), w = pad\n          quantParams: vec4<f32>, // local min xyz, lattice step w\n          rteViewProj: mat4x4<f32>, // appended frame; bit 16 selects it\n          drawableDeltaHigh: vec4<f32>,\n          drawableDeltaLow: vec4<f32>,\n          rteCameraHigh: vec4<f32>,\n          rteCameraLow: vec4<f32>,\n        }\n        @binding(0) @group(0) var<uniform> uniforms: Uniforms;\n        const RTE_DRAWABLE_FLAG: u32 = 65536u;\n        \nstruct RteFrameUniform {\n  // Camera translation is intentionally absent. This projects positions\n  // returned by rteWorldPosition, which are already relative to the eye.\n  viewProj: mat4x4<f32>,\n}\n\nstruct RteDrawableUniform {\n  // CPU computes (drawable origin - camera origin) in f64 and splits it.\n  // This data must be refreshed whenever the RTE camera frame changes.\n  drawableDeltaHigh: vec4<f32>,\n  drawableDeltaLow: vec4<f32>,\n}\n\nfn rteWorldPosition(\n  local: vec3<f32>,\n  drawable: RteDrawableUniform,\n) -> vec4<f32> {\n  // Do not subtract a camera origin here: this delta was formed in CPU f64.\n  let highDelta = drawable.drawableDeltaHigh.xyz;\n  let lowDelta = drawable.drawableDeltaLow.xyz;\n  // A drawable template can span kilometres. Keep local with high first;\n  // The local-plus-(high-plus-low) association is not equivalent in f32.\n  return vec4<f32>((local + highDelta) + lowDelta, 1.0);\n}\n\n        \n        fn rtePosition(local: vec3<f32>) -> vec4<f32> {\n          let linear = (uniforms.model * vec4<f32>(local, 0.0)).xyz;\n          return rteWorldPosition(linear, RteDrawableUniform(\n            uniforms.drawableDeltaHigh,\n            uniforms.drawableDeltaLow,\n          ));\n        }\n        fn rteInstancePosition(local: vec3<f32>, anchorHigh: vec3<f32>, anchorLow: vec3<f32>) -> vec4<f32> {\n          return rteWorldPosition(local, RteDrawableUniform(\n            vec4<f32>(anchorHigh, 0.0),\n            vec4<f32>(anchorLow, 0.0),\n          ));\n        }\n        // Shared group(1) lighting; packing matches packEnvironmentUniforms().\n        struct Environment {\n          sunDirection: vec3<f32>,      // unit vector TOWARD the sun\n          sunIntensity: f32,\n          sunColor: vec3<f32>,\n          ambientIntensity: f32,\n          skyColor: vec3<f32>,          // hemisphere-ambient sky tint\n          exposure: f32,\n          groundColor: vec3<f32>,       // hemisphere-ambient ground tint\n          fillIntensity: f32,\n          rimIntensity: f32,\n          sunSoftness: f32,\n          _pad1: f32,\n          _pad2: f32,\n        }\n        @binding(0) @group(1) var<uniform> env: Environment;\n        // Selection highlight tint (#5484), set by Renderer.setOverlayTheme via\n        // updateSelectionColor \u2014 written only on theme change, never per frame.\n        // TRUE LINEAR-LIGHT RGB: re-lit by lightTerm below exactly like the WGSL\n        // constant it replaces, then ACES-tonemapped + gamma-encoded on output.\n        @binding(4) @group(1) var<uniform> selectionColor: vec4<f32>;\n        const IRRADIANCE_CALIBRATION: f32 = 1.82;\n        const TRANSLUCENT_OPACITY_SCALE: f32 = 0.7;\n        \n        fn srgbToLinear(c: vec3<f32>) -> vec3<f32> {\n          let lo = c / 12.92;\n          let hi = pow((max(c, vec3<f32>(0.0)) + 0.055) / 1.055, vec3<f32>(2.4));\n          return select(hi, lo, c <= vec3<f32>(0.04045));\n        }\n\n        fn linearToSrgb(c: vec3<f32>) -> vec3<f32> {\n          let lo = c * 12.92;\n          let hi = 1.055 * pow(max(c, vec3<f32>(0.0)), vec3<f32>(1.0 / 2.4)) - 0.055;\n          return select(hi, lo, c <= vec3<f32>(0.0031308));\n        }\n\n        fn neutralCompress(cIn: vec3<f32>) -> vec3<f32> {\n          let startCompression = 0.76;\n          let desaturation = 0.15;\n          let c = max(cIn, vec3<f32>(0.0));\n          let peak = max(c.r, max(c.g, c.b));\n          if (peak < startCompression) { return c; }\n          let d = 1.0 - startCompression;\n          let newPeak = 1.0 - d * d / (peak + d - startCompression);\n          let g = 1.0 - 1.0 / (desaturation * (peak - newPeak) + 1.0);\n          return mix(c * (newPeak / peak), vec3<f32>(newPeak), g);\n        }\n\n        \n        const MIN_SPECULAR_ROUGHNESS: f32 = 0.045;\n        const DIELECTRIC_F0: f32 = 0.04;\n        const PI: f32 = 3.14159265;\n\n        fn fresnelSchlick(cosTheta: f32, F0: vec3<f32>) -> vec3<f32> {\n          return F0 + (1.0 - F0) * pow(clamp(1.0 - cosTheta, 0.0, 1.0), 5.0);\n        }\n\n        fn distributionGGX(NdotH: f32, roughness: f32) -> f32 {\n          let a = roughness * roughness;\n          let a2 = a * a;\n          let NdotH2 = NdotH * NdotH;\n          let denomBase = (NdotH2 * (a2 - 1.0) + 1.0);\n          return a2 / max(PI * denomBase * denomBase, 0.0000001);\n        }\n\n        fn geometrySchlickGGX(NdotV: f32, roughness: f32) -> f32 {\n          let r = (roughness + 1.0);\n          let k = (r * r) / 8.0;\n          return NdotV / max(NdotV * (1.0 - k) + k, 0.0000001);\n        }\n\n        fn geometrySmith(NdotV: f32, NdotL: f32, roughness: f32) -> f32 {\n          return geometrySchlickGGX(NdotL, roughness) * geometrySchlickGGX(NdotV, roughness);\n        }\n\n        // Split-sum environment BRDF, analytic fit (Karis 2014).\n        fn envBrdfApprox(F0: vec3<f32>, roughness: f32, NdotV: f32) -> vec3<f32> {\n          let r = roughness * vec4<f32>(-1.0, -0.0275, -0.572, 0.022) + vec4<f32>(1.0, 0.0425, 1.04, -0.04);\n          let a004 = min(r.x * r.x, exp2(-9.28 * NdotV)) * r.x + r.y;\n          let ab = vec2<f32>(-1.04, 1.04) * a004 + r.zw;\n          return F0 * ab.x + ab.y;\n        }\n\n        struct SurfaceSpecular {\n          // Reflected light, in lightTerm units (unexposed, uncalibrated).\n          light: vec3<f32>,\n          // Directional albedo of the specular lobe for this view.\n          reflectance: vec3<f32>,\n        }\n\n        // N and V are unit vectors; V points from the surface to the eye.\n        // sunLight is the sun's diffuse-equivalent intensity: sunColor *\n        // sunIntensity * sunShadow, exactly what scales the diffuse sun term.\n        fn surfaceSpecular(\n          N: vec3<f32>,\n          V: vec3<f32>,\n          albedo: vec3<f32>,\n          metallic: f32,\n          roughnessIn: f32,\n          sunLight: vec3<f32>,\n        ) -> SurfaceSpecular {\n          var out: SurfaceSpecular;\n          let NdotV = dot(N, V);\n          // A face turned away from the eye is its back side: nothing it\n          // reflects can reach the eye, and its diffuse keeps full weight.\n          if (NdotV <= 0.0) {\n            out.light = vec3<f32>(0.0);\n            out.reflectance = vec3<f32>(0.0);\n            return out;\n          }\n          let roughness = clamp(roughnessIn, MIN_SPECULAR_ROUGHNESS, 1.0);\n          let F0 = mix(vec3<f32>(DIELECTRIC_F0), albedo, metallic);\n\n          let L = env.sunDirection;\n          let rawNdotL = dot(N, L);\n          let NdotL = max(rawNdotL, 0.0);\n          // A face the sun is behind (rawNdotL <= 0) contributes nothing to\n          // the direct lobe anyway (NdotL clamps it to 0 below), but V + L\n          // can be exactly zero there \u2014 the sun exactly opposite the eye\n          // reflection, e.g. N = V = (0,-1,0), sun = (0,1,0), both satisfy\n          // NdotV > 0 above. normalize(vec3(0)) is NaN in WGSL, and NaN * 0\n          // is NaN, not 0, so it would poison sun and everything summed with\n          // it instead of being multiplied away. Skip the half-vector\n          // entirely in that case rather than relying on the NdotL factor.\n          var sun = vec3<f32>(0.0);\n          if (rawNdotL > 0.0) {\n            let H = normalize(V + L);\n            let D = distributionGGX(max(dot(N, H), 0.0), roughness);\n            let G = geometrySmith(NdotV, NdotL, roughness);\n            let F = fresnelSchlick(max(dot(V, H), 0.0), F0);\n            // BRDF * NdotL * (pi * intensity); the NdotL cancels the BRDF's.\n            sun = F * (D * G * PI / (4.0 * NdotV)) * sunLight;\n          }\n\n          // The hemisphere ambient, looked up along the reflection. A rough\n          // lobe gathers from around the normal, so lean the lookup toward N.\n          let R = reflect(-V, N);\n          let Rd = normalize(mix(R, N, roughness * roughness));\n          let sky = mix(env.groundColor, env.skyColor, Rd.y * 0.5 + 0.5) * env.ambientIntensity;\n          let reflectance = envBrdfApprox(F0, roughness, NdotV);\n\n          out.light = sun + sky * reflectance;\n          out.reflectance = reflectance;\n          return out;\n        }\n\n\n        \n        @binding(1) @group(1) var shadowMap: texture_depth_2d;\n        @binding(2) @group(1) var shadowCmp: sampler_comparison;\n        struct Shadow { lightViewProj: mat4x4<f32>, params: vec4<f32>, params2: vec4<f32>, }\n        @binding(3) @group(1) var<uniform> shadowU: Shadow;\n        const SHADOW_POISSON = array<vec2<f32>, 12>(\n          vec2<f32>(-0.326, -0.406), vec2<f32>(-0.840, -0.074), vec2<f32>(-0.696,  0.457),\n          vec2<f32>(-0.203,  0.621), vec2<f32>( 0.962, -0.195), vec2<f32>( 0.473, -0.480),\n          vec2<f32>( 0.519,  0.767), vec2<f32>( 0.185, -0.893), vec2<f32>( 0.507,  0.064),\n          vec2<f32>( 0.896,  0.412), vec2<f32>(-0.322, -0.933), vec2<f32>(-0.792, -0.598),\n        );\n        fn sunShadowFactor(eyePos: vec3<f32>, N: vec3<f32>, fragCoord: vec2<f32>) -> f32 {\n          if (shadowU.params.y < 0.5) { return 1.0; }\n          let L = normalize(env.sunDirection);\n          let Ns = N * select(-1.0, 1.0, dot(N, L) >= 0.0);\n          let biased = eyePos + Ns * shadowU.params.z;\n          let clip = shadowU.lightViewProj * vec4<f32>(biased, 1.0);\n          let ndc = clip.xyz / clip.w;\n          let uv = vec2<f32>(ndc.x * 0.5 + 0.5, ndc.y * -0.5 + 0.5);\n          let inBounds = uv.x >= 0.0 && uv.x <= 1.0 && uv.y >= 0.0 && uv.y <= 1.0 && ndc.z > 0.0;\n          if (!inBounds) { return 1.0; }\n          let NdotL = max(dot(Ns, L), 0.0);\n          let slope = clamp(sqrt(max(1.0 - NdotL * NdotL, 0.0)) / max(NdotL, 0.1), 1.0, 12.0);\n          let refDepth = ndc.z + shadowU.params2.x * slope * (1.0 + shadowU.params.w);\n          let radius = shadowU.params.x * shadowU.params.w;\n          let ign = fract(52.9829189 * fract(dot(fragCoord, vec2<f32>(0.06711056, 0.00583715))));\n          let ang = ign * 6.2831853;\n          let cr = cos(ang); let sr = sin(ang); var sum = 0.0;\n          for (var i = 0; i < 12; i = i + 1) {\n            let p = SHADOW_POISSON[i];\n            let off = vec2<f32>(p.x * cr - p.y * sr, p.x * sr + p.y * cr) * radius;\n            sum = sum + textureSampleCompareLevel(shadowMap, shadowCmp, uv + off, refDepth);\n          }\n          return mix(1.0, sum / 12.0, smoothstep(0.0, 0.3, NdotL));\n        }\n\n        struct VertexInput {\n          @location(0) position: vec3<f32>,\n          @location(1) normal: vec3<f32>,\n          @location(2) entityId: u32,\n        }\n\n        struct VertexOutput {\n          @builtin(position) position: vec4<f32>,\n          @location(0) worldPos: vec3<f32>,\n          @location(1) normal: vec3<f32>,\n          @location(2) @interpolate(flat) entityId: u32,\n          @location(3) viewPos: vec3<f32>,  // For edge detection\n          // Per-draw albedo carried from the vertex stage so the fragment shader\n          // is shared by the flat path (vs_main writes uniforms.baseColor \u2014 the\n          // per-batch / overlay-override colour) AND the instanced path\n          // (vs_instanced writes the per-occurrence colour from the instance\n          // buffer). For the flat path this is identical to reading\n          // uniforms.baseColor directly (the value is constant across the draw).\n          @location(4) color: vec4<f32>,\n          // Per-occurrence selection flag for the instanced path (bit 0 = selected).\n          // vs_main writes 0 (the flat path selects via uniforms.flags.x instead);\n          // vs_instanced writes the per-instance flag from the instance buffer, so a\n          // single selected occurrence highlights without re-drawing.\n          @location(5) @interpolate(flat) instSelected: u32,\n          // Camera-relative position for fragment operations that compare\n          // geometry to section/crop boundaries or take derivatives. This is\n          // intentionally separate from worldPos: shadow maps still consume\n          // their established world-space light matrix until their depth pass\n          // is migrated as one transaction.\n          @location(6) eyePos: vec3<f32>,\n        }\n\n        // Per-instance vertex-buffer inputs (slot 1, stepMode 'instance') used by\n        // vs_instanced. The mat4 arrives as four COLUMN vec4s (WGSL mat4x4 is\n        // column-major), matching composeInstanceMatrix's column-major output +\n        // the pipeline's slot-1 attribute offsets (0/16/32/48).\n        //\n        // Location namespaces: vertex-INPUT @location (this struct + VertexInput)\n        // and inter-stage @location (VertexOutput) are INDEPENDENT in WGSL, so\n        // InstanceInput.m1 @location(4) does NOT collide with VertexOutput.color\n        // @location(4) \u2014 exactly as VertexInput.entityId and VertexOutput.entityId\n        // already BOTH use @location(2). Within the INPUT namespace the per-vertex\n        // inputs (0..2) and per-instance inputs (3..8) stay distinct.\n        struct InstanceInput {\n          @location(3) m0: vec4<f32>,\n          @location(4) m1: vec4<f32>,\n          @location(5) m2: vec4<f32>,\n          @location(6) m3: vec4<f32>,\n          @location(7) instEntityId: u32,\n          @location(8) instColor: vec4<f32>,\n          @location(9) instSelected: u32,\n          @location(10) anchorHigh: vec4<f32>,\n          @location(11) anchorLow: vec4<f32>,\n        }\n\n        // 12-byte quantized vertex (issue #1682 phase 6): uint16x4 (lattice\n        // position xyz + packed octahedral normal in w as (u8x << 8 | u8y))\n        // followed by the u32 entityId lane. Dequantization is BIT-EXACT for\n        // the 2^-10 lattice: quantMin and q*step are both (integer)\u00B72^-10,\n        // so coincident points across batches stay coincident (the shared-\n        // origin z-fight guarantee survives quantization).\n        struct QuantizedVertexInput {\n          @location(0) q: vec4<u32>,     // uint16x4: x, y, z, packedOct\n          @location(2) entityId: u32,\n        }\n\n        fn octDecodeN(packed: u32) -> vec3<f32> {\n          let ox = (f32((packed >> 8u) & 255u) / 255.0) * 2.0 - 1.0;\n          let oy = (f32(packed & 255u) / 255.0) * 2.0 - 1.0;\n          var n = vec3<f32>(ox, oy, 1.0 - abs(ox) - abs(oy));\n          if (n.z < 0.0) {\n            let tx = (1.0 - abs(oy)) * select(-1.0, 1.0, ox >= 0.0);\n            let ty = (1.0 - abs(ox)) * select(-1.0, 1.0, oy >= 0.0);\n            n = vec3<f32>(tx, ty, n.z);\n          }\n          return normalize(n);\n        }\n\n        // Shared flat-path vertex shading \u2014 vs_main and vs_main_quantized\n        // differ ONLY in how position/normal are sourced.\n        fn shadeFlatVertex(localPos: vec3<f32>, localNormal: vec3<f32>, entityId: u32) -> VertexOutput {\n          var output: VertexOutput;\n          let worldPos = uniforms.model * vec4<f32>(localPos, 1.0);\n          let eyePos = rtePosition(localPos).xyz;\n          let rte = (uniforms.flags.x & RTE_DRAWABLE_FLAG) != 0u;\n          output.position = select(uniforms.viewProj * worldPos, uniforms.rteViewProj * vec4<f32>(eyePos, 1.0), rte);\n          // Anti z-fighting depth nudge \u2014 see vs_main's comment.\n          let colorSalt = (entityId >> 24u) * 2654435761u;\n          let zHash = (((entityId & 0x00FFFFFFu) ^ colorSalt) * 2654435761u) & 255u;\n          output.position.z *= 1.0 + f32(zHash) * 1e-6;\n          output.worldPos = worldPos.xyz;\n          output.normal = normalize((uniforms.model * vec4<f32>(localNormal, 0.0)).xyz);\n          output.entityId = entityId;\n          output.color = uniforms.baseColor;\n          output.instSelected = 0u;\n          output.eyePos = eyePos;\n          output.viewPos = select((uniforms.viewProj * worldPos).xyz, (uniforms.rteViewProj * vec4<f32>(eyePos, 1.0)).xyz, rte);\n          return output;\n        }\n\n        @vertex\n        fn vs_main_quantized(input: QuantizedVertexInput) -> VertexOutput {\n          let p = uniforms.quantParams.xyz\n            + vec3<f32>(f32(input.q.x), f32(input.q.y), f32(input.q.z)) * uniforms.quantParams.w;\n          return shadeFlatVertex(p, octDecodeN(input.q.w), input.entityId);\n        }\n\n        @vertex\n        fn vs_main(input: VertexInput, @builtin(instance_index) instanceIndex: u32) -> VertexOutput {\n          var output: VertexOutput;\n          let worldPos = uniforms.model * vec4<f32>(input.position, 1.0);\n          let eyePos = rtePosition(input.position).xyz;\n          let rte = (uniforms.flags.x & RTE_DRAWABLE_FLAG) != 0u;\n          output.position = select(uniforms.viewProj * worldPos, uniforms.rteViewProj * vec4<f32>(eyePos, 1.0), rte);\n          // Anti z-fighting: deterministic depth nudge.\n          // Knuth multiplicative hash spreads sequential IDs across 0-255 so\n          // coplanar faces from different entities always get distinct depths.\n          // Material-layer walls slice into one closed solid per layer, all\n          // sharing the PARENT wall's expressId, so adjacent layers' coincident\n          // interface caps would get the same entity nudge and z-fight into a\n          // flickering comb (\"see inside the wall\"). To separate them we fold in\n          // an 8-bit MATERIAL-COLOUR salt that mergeGeometry/interleaveTextured\n          // baked into the HIGH 8 bits of the entityId lane (low 24 = picking id,\n          // masked off by encodeId24). Crucially the salt comes from the mesh's\n          // OWN colour, NOT the per-draw baseColor uniform \u2014 so the base opaque\n          // pass and the lens/IDS/compare/4D OVERLAY pass (which redraws the same\n          // geometry with a DIFFERENT draw colour) compute the SAME nudge, and\n          // the overlay pipeline's depthCompare:'equal' matches instead of\n          // rejecting every fragment. At 1e-6 per step the max world-space offset\n          // is <3mm at 10m \u2014 invisible.\n          let colorSalt = (input.entityId >> 24u) * 2654435761u;\n          let zHash = (((input.entityId & 0x00FFFFFFu) ^ colorSalt) * 2654435761u) & 255u;\n          output.position.z *= 1.0 + f32(zHash) * 1e-6;\n          output.worldPos = worldPos.xyz;\n          output.normal = normalize((uniforms.model * vec4<f32>(input.normal, 0.0)).xyz);\n          output.entityId = input.entityId;\n          output.color = uniforms.baseColor;\n          output.instSelected = 0u;  // flat path selects via uniforms.flags.x\n          output.eyePos = eyePos;\n          // Store view-space position for edge detection\n          output.viewPos = select((uniforms.viewProj * worldPos).xyz, (uniforms.rteViewProj * vec4<f32>(eyePos, 1.0)).xyz, rte);\n          return output;\n        }\n\n        // Instanced vertex entry \u2014 one template's geometry drawn once per\n        // occurrence. The per-instance mat4 already folds SWAP * rel_k * T(origin)\n        // (composed CPU-side, see instanced-render.ts), so it maps the template's\n        // LOCAL vertex straight to WebGL Y-up world space \u2014 no uniforms.model.\n        // rel_k and SWAP are rigid (no scale), so the same matrix transforms\n        // normals. entityId + colour come per-occurrence from the instance buffer.\n        @vertex\n        fn vs_instanced(input: VertexInput, inst: InstanceInput) -> VertexOutput {\n          var output: VertexOutput;\n          let instMat = mat4x4<f32>(inst.m0, inst.m1, inst.m2, inst.m3);\n          let worldPos = instMat * vec4<f32>(input.position, 1.0);\n          let linearLocal = (instMat * vec4<f32>(input.position, 0.0)).xyz;\n          let eyePos = rteInstancePosition(linearLocal, inst.anchorHigh.xyz, inst.anchorLow.xyz).xyz;\n          output.position = uniforms.rteViewProj * vec4<f32>(eyePos, 1.0);\n          // Same per-entity depth nudge as vs_main. No colour salt here: the\n          // instanced path has no base-vs-overlay coincident redraw (yet), so the\n          // raw picking id is enough to separate coplanar entities.\n          let zHash = ((inst.instEntityId & 0x00FFFFFFu) * 2654435761u) & 255u;\n          output.position.z *= 1.0 + f32(zHash) * 1e-6;\n          output.worldPos = worldPos.xyz;\n          output.normal = normalize((instMat * vec4<f32>(input.normal, 0.0)).xyz);\n          output.entityId = inst.instEntityId;\n          output.color = inst.instColor;\n          output.instSelected = inst.instSelected;\n          output.eyePos = eyePos;\n          output.viewPos = (uniforms.rteViewProj * vec4<f32>(eyePos, 1.0)).xyz;\n          return output;\n        }\n\n        fn encodeId24(id: u32) -> vec4<f32> {\n          let r = f32((id >> 16u) & 255u) / 255.0;\n          let g = f32((id >> 8u) & 255u) / 255.0;\n          let b = f32(id & 255u) / 255.0;\n          return vec4<f32>(r, g, b, 1.0);\n        }\n\n        struct FragmentOutput {\n          @location(0) color: vec4<f32>,\n          @location(1) objectIdEncoded: vec4<f32>,\n        }\n\n        @fragment\n        fn fs_main(input: VertexOutput) -> FragmentOutput {\n          // The flat/quantized/textured mesh paths submit this in one\n          // camera-relative frame. Do all camera-local fragment arithmetic in\n          // that frame; otherwise the RTE vertex precision is thrown away at\n          // section/crop/derivative ingress. Instanced geometry is not yet\n          // anchored, so its worldPos remains the authoritative input.\n          let fragmentPos = select(input.worldPos, input.eyePos, (uniforms.flags.x & RTE_DRAWABLE_FLAG) != 0u);\n          // Per-instance hide/isolate: bit 1 of the instance flags lane marks a hidden\n          // occurrence. Discard it so it neither draws nor writes depth (and the pick\n          // pass applies the same discard, so it isn't pickable). vs_main writes\n          // instSelected=0u for flat geometry, so this never affects the flat path.\n          if ((input.instSelected & 2u) != 0u) {\n            discard;\n          }\n          // Per-instance opacity routing (instanced passes only \u2014 flags.x bit 2). The\n          // opaque instanced pass draws fully-opaque (or selected) occurrences; the\n          // transparent instanced sub-pass (bit 3, alpha-blended) draws the rest. Discard\n          // the occurrences belonging to the OTHER pass so each is drawn exactly once.\n          // Lens-ghost / x-ray / compare write a low per-instance alpha into input.color.a.\n          if ((uniforms.flags.x & 4u) != 0u) {\n            let occOpaque = input.color.a >= 0.99 || (input.instSelected & 1u) != 0u;\n            let transparentPass = (uniforms.flags.x & 8u) != 0u;\n            if (transparentPass) {\n              if (occOpaque) { discard; }\n            } else {\n              if (!occOpaque) { discard; }\n            }\n          }\n          // Section plane clipping - discard fragments ABOVE the plane.\n          // flags.y packs two bits: bit 0 = enabled, bit 1 = flipped.\n          let sectionEnabled = (uniforms.flags.y & 1u) == 1u;\n          if (sectionEnabled) {\n            let planeNormal = uniforms.sectionPlane.xyz;\n            let planeDistance = uniforms.sectionPlane.w;\n            let flipped = (uniforms.flags.y & 2u) == 2u;\n            let side = select(1.0, -1.0, flipped);\n            let distToPlane = (dot(fragmentPos, planeNormal) - planeDistance) * side;\n            if (distToPlane > 0.0) {\n              discard;\n            }\n          }\n          // Clip box (section / crop box): discard fragments OUTSIDE the AABB.\n          // flags.y bit 2 = clip-box enabled.\n          if ((uniforms.flags.y & 4u) != 0u) {\n            let p = fragmentPos;\n            if (any(p < uniforms.clipBoxMin.xyz) || any(p > uniforms.clipBoxMax.xyz)) {\n              discard;\n            }\n          }\n\n          // Compute normal via derivative-based flat shading.\n          //\n          // Industry-standard solution for BIM/CAD viewers \u2014 what\n          // Three.js (material.flatShading = true), Autodesk Forge,\n          // Speckle, and xeokit all do for opaque surfaces. Rationale:\n          //\n          //   * BIM geometry is overwhelmingly flat surfaces (walls,\n          //     slabs, roofs, beams), and CSG operations (opening\n          //     subtraction, layer slicing) emit those surfaces as\n          //     dense strips of coplanar triangles. Per-vertex normal\n          //     averaging gives a SLIGHTLY-different normal at each\n          //     vertex due to f32 noise from boolean output; the\n          //     boundary between strips then reads as a visible darker/\n          //     brighter scar line \u2014 the horizontal striations on\n          //     walls, stripes on roofs, visible triangulation reports\n          //     across every CSG kernel we have tried (legacy BSP,\n          //     Manifold).\n          //   * cross(dpdx, dpdy) of world position evaluates to the\n          //     EXACT face normal in the fragment shader. Every\n          //     fragment on a flat face \u2014 across an arbitrarily-fine\n          //     triangulation \u2014 gets the IDENTICAL normal, so coplanar\n          //     splits become invisible by construction. No CPU-side\n          //     welding, smooth-grouping, or coplanar-face merging\n          //     fixes the symptom as cleanly.\n          //\n          // Trade-off: genuinely curved surfaces (cylinder tessellations,\n          // BSpline approximations) shade with visible facets. For BIM\n          // that's acceptable \u2014 curved surfaces are < 5 % of typical\n          // model triangle count and the faceting matches CAD-tool\n          // (Revit, ArchiCAD) on-screen behaviour at default quality.\n          //\n          // We still fall back to the vertex normal when derivatives\n          // are unavailable (extreme polygon degeneracy where dpdx /\n          // dpdy collapse to zero \u2014 practically never on real geometry).\n          let faceN = cross(dpdx(fragmentPos), dpdy(fragmentPos));\n          let fLen2 = dot(faceN, faceN);\n          var N: vec3<f32>;\n          if (fLen2 > 1e-10) {\n            N = faceN * inverseSqrt(fLen2);\n          } else {\n            // Degenerate derivative \u2014 fall back to the vertex normal\n            // if it's populated, else +Y.\n            N = input.normal;\n            let nLen2 = dot(N, N);\n            if (nLen2 > 1e-6) {\n              N = N * inverseSqrt(nLen2);\n            } else {\n              N = vec3<f32>(0.0, 1.0, 0.0);\n            }\n          }\n\n          // Stabilize the SIGN of the derivative face normal with the vertex\n          // normal. The screen-space cross product gives the exact face\n          // normal DIRECTION for coplanar strips (the scar-line fix), but at\n          // grazing angles its SIGN becomes numerically unstable per quad \u2014\n          // hemisphere/rim lighting then band-flips across large regions of\n          // flat walls/slabs (diagonal lighter/darker bands). The interpolated\n          // vertex normal is quad-noise-free, so use it only to orient N.\n          // Guard: skip when the vertex normal is missing or nearly\n          // perpendicular to the face normal (unreliable witness).\n          let vN = input.normal;\n          let alignDot = dot(N, vN);\n          if (alignDot * alignDot > 0.03 * dot(vN, vN)) {\n            N = N * sign(alignDot);\n          }\n\n          // Lighting environment \u2014 sun/hemisphere/exposure come from the\n          // global env uniform. The fill follows the sun (it bounces in from\n          // the opposite side); the rim stays fixed in world space as a\n          // stylistic shaping light.\n          let sunLight = env.sunDirection;\n          // Horizontal mirror of the sun, lifted slightly. An overhead sun\n          // leaves (0, 0.25, 0), which normalizes to straight up.\n          let fillLight = normalize(vec3<f32>(-sunLight.x, 0.25, -sunLight.z));\n          let rimLight = normalize(vec3<f32>(0.0, 0.2, -1.0));  // Rim light for edge definition\n\n          // Hemisphere ambient. This, not the sun, keeps faces turned away\n          // from the sun readable (I-beam webs and flange undersides, #5382).\n          let hemisphereFactor = N.y * 0.5 + 0.5;\n          let ambient = mix(env.groundColor, env.skyColor, hemisphereFactor) * env.ambientIntensity;\n\n          // One-sided sun, so a building has a lit side and a shaded side.\n          // sunSoftness is the diffuse wrap (env uniform): 0 = crisp\n          // terminator (hard shadows), larger = softer wrap-around (overcast).\n          let NdotL = dot(N, sunLight);\n          let wrap = env.sunSoftness;\n          let diffuseSun = max((NdotL + wrap) / (1.0 + wrap), 0.0) * env.sunIntensity;\n\n          // Fill light, one-sided like the sun.\n          let NdotFill = max(dot(N, fillLight), 0.0);\n          let diffuseFill = NdotFill * env.fillIntensity;\n\n          // Rim light for edge definition\n          let NdotRim = max(dot(N, rimLight), 0.0);\n          let rim = pow(NdotRim, 4.0) * env.rimIntensity;\n\n          // The authored colour is display-referred sRGB; light it in linear.\n          // (textured.wgsl.ts anchors on the first line to multiply in the texel.)\n          var baseColor = input.color.rgb;\n          baseColor = srgbToLinear(baseColor);\n\n          // Combine all lighting. Only the DIRECT sun term is occluded by cast\n          // shadows (#2670); ambient/fill/rim are indirect and stay unshadowed.\n          // Exposure scales the light, so the selection shade below and every\n          // later stage see one exposed irradiance.\n          let sunShadow = sunShadowFactor(input.eyePos, N, input.position.xy);\n          let lightTerm = ambient + env.sunColor * (diffuseSun * sunShadow) + vec3<f32>(diffuseFill + rim);\n          let irradiance = lightTerm * (env.exposure * IRRADIANCE_CALIBRATION);\n          var color = baseColor * irradiance;\n\n          // flags.x is a bitfield:\n          //   bit 0 (value 1) = isSelected  \u2192 selection-highlight + force opaque\n          //   bit 1 (value 2) = isOverlay   \u2192 color-override pass; preserve\n          //                                    baseColor.a (overlay pipeline has\n          //                                    src-alpha blending) AND skip the\n          //                                    specular term, so an override\n          //                                    paints its colour, lit, and a\n          //                                    low-alpha ghost tint does not\n          //                                    pick up glass reflections.\n          // Selected via the per-draw flag (flat path) OR the per-occurrence flag\n          // (instanced path \u2014 vs_instanced reads it from the instance buffer).\n          let isSelected = ((uniforms.flags.x & 1u) == 1u) || ((input.instSelected & 1u) == 1u);\n          let isOverlay = (uniforms.flags.x & 2u) == 2u;\n\n          // Selection highlight \u2014 a blue albedo RE-LIT by the scene lighting.\n          //\n          // We override the material albedo with selection-blue and re-light\n          // it with the SAME lightTerm used for unselected surfaces, then\n          // skip the view-dependent (specular) term below. Two requirements\n          // are in tension and this satisfies both:\n          //\n          //   * No base-material bleed-through. The old fresnel-glow mix left\n          //     ~80 % of the lit object colour visible at face centres (the\n          //     green-site / red-roof wash-out). Here the base colour never\n          //     enters the result \u2014 only lightTerm (geometry/light, colour-\n          //     independent) modulates the constant blue albedo.\n          //   * Facet/crease structure must survive. A single FLAT colour\n          //     (the previous fix) collapsed every face to the same blue, so\n          //     internal edges \u2014 which read as the per-face shading STEP, not\n          //     just the faint screen-space edge line \u2014 disappeared on\n          //     selection. Re-lighting keeps that per-face brightness step, so\n          //     creases read on the highlight exactly as they do unselected.\n          //\n          // The luminance of the exposed irradiance is used as a multiplicative\n          // gain (which preserves the per-face brightness RATIOS, so creases\n          // read as strongly as on the unselected surface). The calibration\n          // puts a sunlit face at 1.0, i.e. full selection-blue, and the\n          // floor/ceiling clamp keeps shadowed faces only dimmed and bright\n          // scenes from washing out.\n          if (isSelected) {\n            let shadeLum = dot(irradiance, vec3<f32>(0.299, 0.587, 0.114));\n            let shade = clamp(shadeLum, 0.45, 1.2);\n            // selectionColor is already linear-light (set by Renderer.setOverlayTheme\n            // from the app theme, #5484) \u2014 no srgbToLinear here, unlike the constant\n            // it replaces.\n            color = selectionColor.rgb * shade;\n          }\n\n          // flags.x bit 5 (value 32) = EMPHASIZE overlay: render the colour\n          // override FULLY UNLIT and saturated (no lighting attenuation, no\n          // wash-to-white) so the focused clash pair reads as a solid, vivid,\n          // distinct colour that pops against the lit model \u2014 like a clash tool.\n          // A faint normal-based shade keeps the silhouette from going flat. (#1277)\n          let emphasizedOverlay = isOverlay && (uniforms.flags.x & 32u) != 0u;\n          if (emphasizedOverlay) {\n            let facet = 0.85 + 0.15 * abs(dot(N, normalize(vec3<f32>(0.3, 1.0, 0.2))));\n            color = baseColor * facet;\n          }\n\n          // Force alpha to 1.0 for selected objects so the highlight is fully\n          // opaque (the selection pipeline has no alpha blending). Emphasized\n          // clash overlay paints a SOLID vivid fill (force opaque) so it isn't\n          // blended down to a pale tint against the geometry beneath.\n          var finalAlpha = select(input.color.a, 1.0, isSelected || emphasizedOverlay);\n\n          // Specular (#5386; specular.wgsl.ts), after the diffuse above. Not\n          // on the selection highlight (it would wash the blue out) nor on a\n          // colour-override overlay. The sun lobe is scaled exactly like the\n          // diffuse sun term, and both terms like irradiance, so a preset's\n          // highlights and its diffuse light move together.\n          if (!isSelected && !isOverlay) {\n            // Glass is an authored translucent material (mesh-material.ts\n            // also gives it its smooth roughness). An X-Ray or compare fade\n            // only lowers the alpha and stays a fade. Instanced occurrences\n            // are never authored translucent: prepareInstancedRender routes\n            // those to the flat path, so the per-pass lane is ignored there.\n            let instancedPass = (uniforms.flags.x & 4u) != 0u;\n            let translucent = finalAlpha < 0.99;\n            let glass = translucent && uniforms.transmission.x > 0.5 && !instancedPass;\n            let metallic = clamp(uniforms.metallicRoughness.x, 0.0, 1.0);\n            let spec = surfaceSpecular(\n              N,\n              normalize(-input.eyePos),\n              baseColor,\n              metallic,\n              uniforms.metallicRoughness.y,\n              env.sunColor * (env.sunIntensity * sunShadow),\n            );\n            // What the lobe reflects is not there to diffuse; a metal has no\n            // diffuse at all.\n            let diffuse = color * (1.0 - spec.reflectance) * (1.0 - metallic);\n            let reflected = spec.light * (env.exposure * IRRADIANCE_CALIBRATION);\n            if (translucent) {\n              finalAlpha = finalAlpha * TRANSLUCENT_OPACITY_SCALE;\n            }\n            if (glass) {\n              // The transparent pipelines blend straight alpha:\n              // out = c * a + behind * (1 - a). A pane passes what is behind\n              // it except what its body absorbs and its surface reflects, and\n              // its reflection is not dimmed by the body's opacity, so solve\n              // for (c, a). The reflectance rising at grazing angles is what\n              // makes glass more opaque there; a bright sun glint raises the\n              // alpha further so it is not clipped to the body's opacity.\n              let body = finalAlpha;\n              let reflectance = dot(spec.reflectance, vec3<f32>(0.299, 0.587, 0.114));\n              let premultiplied = diffuse * body + reflected;\n              let peak = max(premultiplied.r, max(premultiplied.g, premultiplied.b));\n              finalAlpha = clamp(max(body + reflectance * (1.0 - body), peak), 0.0, 1.0);\n              color = premultiplied / max(finalAlpha, 0.0001);\n            } else {\n              color = diffuse + reflected;\n            }\n          }\n\n          // Hue-preserving highlight roll-off (color-transfer.wgsl.ts). No\n          // contrast curve and no saturation boost: an authored colour lit at\n          // unit irradiance leaves here unchanged unless it is brighter than\n          // the roll-off threshold.\n          color = neutralCompress(color);\n\n          // Subtle edge enhancement using screen-space derivatives.\n          //\n          // Use the SHADED normal (face normal from dpdx/dpdy above)\n          // for the normal-gradient term, not the interpolated vertex\n          // normal \u2014 otherwise we get spurious dark stripes on flat\n          // surfaces whose vertex normals carry numerical noise from\n          // CSG output (the visible scar-line symptom would just\n          // resurface here even after the lit-normal fix). With the\n          // face normal, coplanar adjacent triangles agree exactly \u2192\n          // zero normal gradient \u2192 no false edge; only the genuine\n          // creases between perpendicular faces produce a real\n          // gradient and get the intended outline.\n          let depthGradient = length(vec2<f32>(\n            dpdx(input.viewPos.z),\n            dpdy(input.viewPos.z)\n          ));\n          let normalGradient = length(vec2<f32>(\n            length(dpdx(N)),\n            length(dpdy(N))\n          ));\n\n          if (uniforms.flags.z == 1u) {\n            // Threshold filters subtle normal discontinuities at internal\n            // triangle edges between coplanar entities in the same batch.\n            let edgeFactor = smoothstep(0.02, 0.12, depthGradient * 10.0 + normalGradient * 5.0);\n            let edgeIntensity = f32(uniforms.flags.w) / 1000.0;\n            let edgeDarkenStrength = clamp(0.25 * edgeIntensity, 0.0, 0.85);\n            let edgeDarken = mix(1.0, 1.0 - edgeDarkenStrength, edgeFactor);\n            color *= edgeDarken;\n          }\n\n          color = linearToSrgb(clamp(color, vec3<f32>(0.0), vec3<f32>(1.0)));\n\n          var out: FragmentOutput;\n          out.color = vec4<f32>(color, finalAlpha);\n          out.objectIdEncoded = encodeId24(input.entityId);\n          return out;\n        }\n      ";
+export declare const mainShaderSource = "\n        \n        struct Uniforms {\n          viewProj: mat4x4<f32>,\n          model: mat4x4<f32>,\n          baseColor: vec4<f32>,\n          metallicRoughness: vec2<f32>, // x = metallic, y = roughness (mesh-material.ts)\n          transmission: vec2<f32>,      // x = 1: authored translucent, drawn as glass; y = pad\n          sectionPlane: vec4<f32>,      // xyz = plane normal, w = plane distance\n          flags: vec4<u32>,             // x = isSelected, y = section/clip bits; z, w unused (0) since #5746 dropped the derivative edges\n          clipBoxMin: vec4<f32>,        // xyz = clip-box min corner (world), w = pad\n          clipBoxMax: vec4<f32>,        // xyz = clip-box max corner (world), w = pad\n          quantParams: vec4<f32>, // local min xyz, lattice step w\n          rteViewProj: mat4x4<f32>, // appended frame; bit 16 selects it\n          drawableDeltaHigh: vec4<f32>,\n          drawableDeltaLow: vec4<f32>,\n          rteCameraHigh: vec4<f32>,\n          rteCameraLow: vec4<f32>,\n          overrideParams: vec4<u32>, // x = draw's id anchor, y = OVERRIDE_* bits (entity-color-table.ts, #6076)\n        }\n        @binding(0) @group(0) var<uniform> uniforms: Uniforms;\n        const RTE_DRAWABLE_FLAG: u32 = 65536u;\n\n        // The fragment position the section/crop tests run in: camera-relative\n        // for RTE drawables (the packer writes plane and box in that frame),\n        // world space otherwise.\n        fn clipSpacePos(worldPos: vec3<f32>, eyePos: vec3<f32>) -> vec3<f32> {\n          return select(worldPos, eyePos, (uniforms.flags.x & RTE_DRAWABLE_FLAG) != 0u);\n        }\n\n        // True when p is cut away: ABOVE the section plane (flags.y bit 0 =\n        // enabled, bit 1 = flipped) or OUTSIDE the clip box (bit 2).\n        fn sectionClipped(p: vec3<f32>) -> bool {\n          if ((uniforms.flags.y & 1u) == 1u) {\n            let side = select(1.0, -1.0, (uniforms.flags.y & 2u) == 2u);\n            if ((dot(p, uniforms.sectionPlane.xyz) - uniforms.sectionPlane.w) * side > 0.0) { return true; }\n          }\n          if ((uniforms.flags.y & 4u) != 0u) {\n            if (any(p < uniforms.clipBoxMin.xyz) || any(p > uniforms.clipBoxMax.xyz)) { return true; }\n          }\n          return false;\n        }\n\n        \nstruct RteFrameUniform {\n  // Camera translation is intentionally absent. This projects positions\n  // returned by rteWorldPosition, which are already relative to the eye.\n  viewProj: mat4x4<f32>,\n}\n\nstruct RteDrawableUniform {\n  // CPU computes (drawable origin - camera origin) in f64 and splits it.\n  // This data must be refreshed whenever the RTE camera frame changes.\n  drawableDeltaHigh: vec4<f32>,\n  drawableDeltaLow: vec4<f32>,\n}\n\nfn rteWorldPosition(\n  local: vec3<f32>,\n  drawable: RteDrawableUniform,\n) -> vec4<f32> {\n  // Do not subtract a camera origin here: this delta was formed in CPU f64.\n  let highDelta = drawable.drawableDeltaHigh.xyz;\n  let lowDelta = drawable.drawableDeltaLow.xyz;\n  // A drawable template can span kilometres. Keep local with high first;\n  // The local-plus-(high-plus-low) association is not equivalent in f32.\n  return vec4<f32>((local + highDelta) + lowDelta, 1.0);\n}\n\n        \n        fn rtePosition(local: vec3<f32>) -> vec4<f32> {\n          let linear = (uniforms.model * vec4<f32>(local, 0.0)).xyz;\n          return rteWorldPosition(linear, RteDrawableUniform(\n            uniforms.drawableDeltaHigh,\n            uniforms.drawableDeltaLow,\n          ));\n        }\n        fn rteInstancePosition(local: vec3<f32>, anchorHigh: vec3<f32>, anchorLow: vec3<f32>) -> vec4<f32> {\n          return rteWorldPosition(local, RteDrawableUniform(\n            vec4<f32>(anchorHigh, 0.0),\n            vec4<f32>(anchorLow, 0.0),\n          ));\n        }\n        // Shared group(1) lighting; packing matches packEnvironmentUniforms().\n        struct Environment {\n          sunDirection: vec3<f32>,      // unit vector TOWARD the sun\n          sunIntensity: f32,\n          sunColor: vec3<f32>,\n          ambientIntensity: f32,\n          skyColor: vec3<f32>,          // hemisphere-ambient sky tint\n          exposure: f32,\n          groundColor: vec3<f32>,       // hemisphere-ambient ground tint\n          fillIntensity: f32,\n          rimIntensity: f32,\n          sunSoftness: f32,\n          _pad1: f32,\n          _pad2: f32,\n        }\n        @binding(0) @group(1) var<uniform> env: Environment;\n        // Selection highlight tint (#5484), set by Renderer.setOverlayTheme via\n        // updateSelectionColor \u2014 written only on theme change, never per frame.\n        // TRUE LINEAR-LIGHT RGB: re-lit by lightTerm below exactly like the WGSL\n        // constant it replaces, then ACES-tonemapped + gamma-encoded on output.\n        @binding(4) @group(1) var<uniform> selectionColor: vec4<f32>;\n        const IRRADIANCE_CALIBRATION: f32 = 1.82;\n        const TRANSLUCENT_OPACITY_SCALE: f32 = 0.7;\n        \n        fn srgbToLinear(c: vec3<f32>) -> vec3<f32> {\n          let lo = c / 12.92;\n          let hi = pow((max(c, vec3<f32>(0.0)) + 0.055) / 1.055, vec3<f32>(2.4));\n          return select(hi, lo, c <= vec3<f32>(0.04045));\n        }\n\n        fn linearToSrgb(c: vec3<f32>) -> vec3<f32> {\n          let lo = c * 12.92;\n          let hi = 1.055 * pow(max(c, vec3<f32>(0.0)), vec3<f32>(1.0 / 2.4)) - 0.055;\n          return select(hi, lo, c <= vec3<f32>(0.0031308));\n        }\n\n        fn neutralCompress(cIn: vec3<f32>) -> vec3<f32> {\n          let startCompression = 0.76;\n          let desaturation = 0.15;\n          let c = max(cIn, vec3<f32>(0.0));\n          let peak = max(c.r, max(c.g, c.b));\n          if (peak < startCompression) { return c; }\n          let d = 1.0 - startCompression;\n          let newPeak = 1.0 - d * d / (peak + d - startCompression);\n          let g = 1.0 - 1.0 / (desaturation * (peak - newPeak) + 1.0);\n          return mix(c * (newPeak / peak), vec3<f32>(newPeak), g);\n        }\n\n        \n        const MIN_SPECULAR_ROUGHNESS: f32 = 0.045;\n        const DIELECTRIC_F0: f32 = 0.04;\n        const PI: f32 = 3.14159265;\n\n        fn fresnelSchlick(cosTheta: f32, F0: vec3<f32>) -> vec3<f32> {\n          return F0 + (1.0 - F0) * pow(clamp(1.0 - cosTheta, 0.0, 1.0), 5.0);\n        }\n\n        fn distributionGGX(NdotH: f32, roughness: f32) -> f32 {\n          let a = roughness * roughness;\n          let a2 = a * a;\n          let NdotH2 = NdotH * NdotH;\n          let denomBase = (NdotH2 * (a2 - 1.0) + 1.0);\n          return a2 / max(PI * denomBase * denomBase, 0.0000001);\n        }\n\n        fn geometrySchlickGGX(NdotV: f32, roughness: f32) -> f32 {\n          let r = (roughness + 1.0);\n          let k = (r * r) / 8.0;\n          return NdotV / max(NdotV * (1.0 - k) + k, 0.0000001);\n        }\n\n        fn geometrySmith(NdotV: f32, NdotL: f32, roughness: f32) -> f32 {\n          return geometrySchlickGGX(NdotL, roughness) * geometrySchlickGGX(NdotV, roughness);\n        }\n\n        // Split-sum environment BRDF, analytic fit (Karis 2014).\n        fn envBrdfApprox(F0: vec3<f32>, roughness: f32, NdotV: f32) -> vec3<f32> {\n          let r = roughness * vec4<f32>(-1.0, -0.0275, -0.572, 0.022) + vec4<f32>(1.0, 0.0425, 1.04, -0.04);\n          let a004 = min(r.x * r.x, exp2(-9.28 * NdotV)) * r.x + r.y;\n          let ab = vec2<f32>(-1.04, 1.04) * a004 + r.zw;\n          return F0 * ab.x + ab.y;\n        }\n\n        struct SurfaceSpecular {\n          // Reflected light, in lightTerm units (unexposed, uncalibrated).\n          light: vec3<f32>,\n          // Directional albedo of the specular lobe for this view.\n          reflectance: vec3<f32>,\n        }\n\n        // N and V are unit vectors; V points from the surface to the eye.\n        // sunLight is the sun's diffuse-equivalent intensity: sunColor *\n        // sunIntensity * sunShadow, exactly what scales the diffuse sun term.\n        fn surfaceSpecular(\n          N: vec3<f32>,\n          V: vec3<f32>,\n          albedo: vec3<f32>,\n          metallic: f32,\n          roughnessIn: f32,\n          sunLight: vec3<f32>,\n        ) -> SurfaceSpecular {\n          var out: SurfaceSpecular;\n          let NdotV = dot(N, V);\n          // A face turned away from the eye is its back side: nothing it\n          // reflects can reach the eye, and its diffuse keeps full weight.\n          if (NdotV <= 0.0) {\n            out.light = vec3<f32>(0.0);\n            out.reflectance = vec3<f32>(0.0);\n            return out;\n          }\n          let roughness = clamp(roughnessIn, MIN_SPECULAR_ROUGHNESS, 1.0);\n          let F0 = mix(vec3<f32>(DIELECTRIC_F0), albedo, metallic);\n\n          let L = env.sunDirection;\n          let rawNdotL = dot(N, L);\n          let NdotL = max(rawNdotL, 0.0);\n          // A face the sun is behind (rawNdotL <= 0) contributes nothing to\n          // the direct lobe anyway (NdotL clamps it to 0 below), but V + L\n          // can be exactly zero there \u2014 the sun exactly opposite the eye\n          // reflection, e.g. N = V = (0,-1,0), sun = (0,1,0), both satisfy\n          // NdotV > 0 above. normalize(vec3(0)) is NaN in WGSL, and NaN * 0\n          // is NaN, not 0, so it would poison sun and everything summed with\n          // it instead of being multiplied away. Skip the half-vector\n          // entirely in that case rather than relying on the NdotL factor.\n          var sun = vec3<f32>(0.0);\n          if (rawNdotL > 0.0) {\n            let H = normalize(V + L);\n            let D = distributionGGX(max(dot(N, H), 0.0), roughness);\n            let G = geometrySmith(NdotV, NdotL, roughness);\n            let F = fresnelSchlick(max(dot(V, H), 0.0), F0);\n            // BRDF * NdotL * (pi * intensity); the NdotL cancels the BRDF's.\n            sun = F * (D * G * PI / (4.0 * NdotV)) * sunLight;\n          }\n\n          // The hemisphere ambient, looked up along the reflection. A rough\n          // lobe gathers from around the normal, so lean the lookup toward N.\n          let R = reflect(-V, N);\n          let Rd = normalize(mix(R, N, roughness * roughness));\n          let sky = mix(env.groundColor, env.skyColor, Rd.y * 0.5 + 0.5) * env.ambientIntensity;\n          let reflectance = envBrdfApprox(F0, roughness, NdotV);\n\n          out.light = sun + sky * reflectance;\n          out.reflectance = reflectance;\n          return out;\n        }\n\n        \n        @binding(5) @group(1) var<storage, read> entityColorTable: array<u32>;\n        const ENTITY_COLOR_EMPTY: u32 = 4294967295u;\n        const ENTITY_COLOR_HEADER: u32 = 4u;\n        const OVERRIDE_PAINT: u32 = 1u;\n        const OVERRIDE_EMPHASIZE: u32 = 2u;\n\n        fn entityColorSlotHash(key: u32) -> u32 {\n          var h = key;\n          h = h ^ (h >> 16u);\n          h = h * 0x85ebca6bu;\n          h = h ^ (h >> 13u);\n          h = h * 0xc2b2ae35u;\n          h = h ^ (h >> 16u);\n          return h;\n        }\n\n        // Full scene id behind a 24-bit lane, given the draw's smallest id.\n        fn resolveLaneEntityId(anchor: u32, lane: u32) -> u32 {\n          return anchor + ((lane - anchor) & 0x00FFFFFFu);\n        }\n\n        // The override colour for this fragment's entity; alpha < 0 = none.\n        fn entityOverrideColor(lane: u32) -> vec4<f32> {\n          let none = vec4<f32>(0.0, 0.0, 0.0, -1.0);\n          if ((uniforms.overrideParams.y & OVERRIDE_PAINT) == 0u || entityColorTable[2] == 0u) {\n            return none;\n          }\n          let capacity = entityColorTable[0];\n          let maxProbe = entityColorTable[1];\n          let colorBase = entityColorTable[3];\n          let id = resolveLaneEntityId(uniforms.overrideParams.x, lane);\n          let mask = capacity - 1u;\n          var slot = entityColorSlotHash(id) & mask;\n          for (var i = 0u; i <= maxProbe && i < capacity; i = i + 1u) {\n            let key = entityColorTable[ENTITY_COLOR_HEADER + slot];\n            if (key == id) {\n              let c = colorBase + slot * 4u;\n              return vec4<f32>(\n                bitcast<f32>(entityColorTable[c]),\n                bitcast<f32>(entityColorTable[c + 1u]),\n                bitcast<f32>(entityColorTable[c + 2u]),\n                bitcast<f32>(entityColorTable[c + 3u])\n              );\n            }\n            if (key == ENTITY_COLOR_EMPTY) {\n              break;\n            }\n            slot = (slot + 1u) & mask;\n          }\n          return none;\n        }\n\n        // Composite an override over the fragment's own encoded colour exactly\n        // as the retired equal-depth overlay pass blended it (src-alpha over\n        // the base draw): the override albedo lit by the same irradiance, no\n        // specular, the same roll-off and edge darkening, mixed by its alpha.\n        // Emphasized overrides are unlit, faintly faceted and opaque (#1277).\n        fn paintEntityOverride(base: vec4<f32>, ov: vec4<f32>, irradiance: vec3<f32>, N: vec3<f32>) -> vec4<f32> {\n          let albedo = srgbToLinear(ov.rgb);\n          var lit = albedo * irradiance;\n          var a = ov.a;\n          if ((uniforms.overrideParams.y & OVERRIDE_EMPHASIZE) != 0u) {\n            lit = albedo * (0.85 + 0.15 * abs(dot(N, normalize(vec3<f32>(0.3, 1.0, 0.2)))));\n            a = 1.0;\n          }\n          let encoded = linearToSrgb(clamp(neutralCompress(lit), vec3<f32>(0.0), vec3<f32>(1.0)));\n          return vec4<f32>(mix(base.rgb, encoded, a), a + (1.0 - a) * base.a);\n        }\n\n\n        \n        @binding(1) @group(1) var shadowMap: texture_depth_2d;\n        @binding(2) @group(1) var shadowCmp: sampler_comparison;\n        struct Shadow { lightViewProj: mat4x4<f32>, params: vec4<f32>, params2: vec4<f32>, }\n        @binding(3) @group(1) var<uniform> shadowU: Shadow;\n        const SHADOW_POISSON = array<vec2<f32>, 12>(\n          vec2<f32>(-0.326, -0.406), vec2<f32>(-0.840, -0.074), vec2<f32>(-0.696,  0.457),\n          vec2<f32>(-0.203,  0.621), vec2<f32>( 0.962, -0.195), vec2<f32>( 0.473, -0.480),\n          vec2<f32>( 0.519,  0.767), vec2<f32>( 0.185, -0.893), vec2<f32>( 0.507,  0.064),\n          vec2<f32>( 0.896,  0.412), vec2<f32>(-0.322, -0.933), vec2<f32>(-0.792, -0.598),\n        );\n        fn sunShadowFactor(eyePos: vec3<f32>, N: vec3<f32>, fragCoord: vec2<f32>) -> f32 {\n          if (shadowU.params.y < 0.5) { return 1.0; }\n          let L = normalize(env.sunDirection);\n          let Ns = N * select(-1.0, 1.0, dot(N, L) >= 0.0);\n          let biased = eyePos + Ns * shadowU.params.z;\n          let clip = shadowU.lightViewProj * vec4<f32>(biased, 1.0);\n          let ndc = clip.xyz / clip.w;\n          let uv = vec2<f32>(ndc.x * 0.5 + 0.5, ndc.y * -0.5 + 0.5);\n          let inBounds = uv.x >= 0.0 && uv.x <= 1.0 && uv.y >= 0.0 && uv.y <= 1.0 && ndc.z > 0.0;\n          if (!inBounds) { return 1.0; }\n          let NdotL = max(dot(Ns, L), 0.0);\n          let slope = clamp(sqrt(max(1.0 - NdotL * NdotL, 0.0)) / max(NdotL, 0.1), 1.0, 12.0);\n          let refDepth = ndc.z + shadowU.params2.x * slope * (1.0 + shadowU.params.w);\n          let radius = shadowU.params.x * shadowU.params.w;\n          let ign = fract(52.9829189 * fract(dot(fragCoord, vec2<f32>(0.06711056, 0.00583715))));\n          let ang = ign * 6.2831853;\n          let cr = cos(ang); let sr = sin(ang); var sum = 0.0;\n          for (var i = 0; i < 12; i = i + 1) {\n            let p = SHADOW_POISSON[i];\n            let off = vec2<f32>(p.x * cr - p.y * sr, p.x * sr + p.y * cr) * radius;\n            sum = sum + textureSampleCompareLevel(shadowMap, shadowCmp, uv + off, refDepth);\n          }\n          return mix(1.0, sum / 12.0, smoothstep(0.0, 0.3, NdotL));\n        }\n\n        struct VertexInput {\n          @location(0) position: vec3<f32>,\n          @location(1) normal: vec3<f32>,\n          @location(2) entityId: u32,\n        }\n\n        struct VertexOutput {\n          @builtin(position) position: vec4<f32>,\n          @location(0) worldPos: vec3<f32>,\n          @location(1) normal: vec3<f32>,\n          @location(2) @interpolate(flat) entityId: u32,\n          // Per-draw albedo carried from the vertex stage so the fragment shader\n          // is shared by the flat path (vs_main writes uniforms.baseColor \u2014 the\n          // per-batch colour) AND the instanced path\n          // (vs_instanced writes the per-occurrence colour from the instance\n          // buffer). For the flat path this is identical to reading\n          // uniforms.baseColor directly (the value is constant across the draw).\n          @location(4) color: vec4<f32>,\n          // Per-occurrence selection flag for the instanced path (bit 0 = selected).\n          // vs_main writes 0 (the flat path selects via uniforms.flags.x instead);\n          // vs_instanced writes the per-instance flag from the instance buffer, so a\n          // single selected occurrence highlights without re-drawing.\n          @location(5) @interpolate(flat) instSelected: u32,\n          // Camera-relative position for fragment operations that compare\n          // geometry to section/crop boundaries or take derivatives. This is\n          // intentionally separate from worldPos: shadow maps still consume\n          // their established world-space light matrix until their depth pass\n          // is migrated as one transaction.\n          @location(6) eyePos: vec3<f32>,\n        }\n\n        // Per-instance vertex-buffer inputs (slot 1, stepMode 'instance') used by\n        // vs_instanced. The mat4 arrives as four COLUMN vec4s (WGSL mat4x4 is\n        // column-major), matching composeInstanceMatrix's column-major output +\n        // the pipeline's slot-1 attribute offsets (0/16/32/48).\n        //\n        // Location namespaces: vertex-INPUT @location (this struct + VertexInput)\n        // and inter-stage @location (VertexOutput) are INDEPENDENT in WGSL, so\n        // InstanceInput.m1 @location(4) does NOT collide with VertexOutput.color\n        // @location(4) \u2014 exactly as VertexInput.entityId and VertexOutput.entityId\n        // already BOTH use @location(2). Within the INPUT namespace the per-vertex\n        // inputs (0..2) and per-instance inputs (3..8) stay distinct.\n        struct InstanceInput {\n          @location(3) m0: vec4<f32>,\n          @location(4) m1: vec4<f32>,\n          @location(5) m2: vec4<f32>,\n          @location(6) m3: vec4<f32>,\n          @location(7) instEntityId: u32,\n          @location(8) instColor: vec4<f32>,\n          @location(9) instSelected: u32,\n          @location(10) anchorHigh: vec4<f32>,\n          @location(11) anchorLow: vec4<f32>,\n        }\n\n        // 12-byte quantized vertex (issue #1682 phase 6): uint16x4 (lattice\n        // position xyz + packed octahedral normal in w as (u8x << 8 | u8y))\n        // followed by the u32 entityId lane. Dequantization is BIT-EXACT for\n        // the 2^-10 lattice: quantMin and q*step are both (integer)\u00B72^-10,\n        // so coincident points across batches stay coincident (the shared-\n        // origin z-fight guarantee survives quantization).\n        struct QuantizedVertexInput {\n          @location(0) q: vec4<u32>,     // uint16x4: x, y, z, packedOct\n          @location(2) entityId: u32,\n        }\n\n        fn octDecodeN(packed: u32) -> vec3<f32> {\n          let ox = (f32((packed >> 8u) & 255u) / 255.0) * 2.0 - 1.0;\n          let oy = (f32(packed & 255u) / 255.0) * 2.0 - 1.0;\n          var n = vec3<f32>(ox, oy, 1.0 - abs(ox) - abs(oy));\n          if (n.z < 0.0) {\n            let tx = (1.0 - abs(oy)) * select(-1.0, 1.0, ox >= 0.0);\n            let ty = (1.0 - abs(ox)) * select(-1.0, 1.0, oy >= 0.0);\n            n = vec3<f32>(tx, ty, n.z);\n          }\n          return normalize(n);\n        }\n\n        // Shared flat-path vertex shading \u2014 vs_main and vs_main_quantized\n        // differ ONLY in how position/normal are sourced.\n        fn shadeFlatVertex(localPos: vec3<f32>, localNormal: vec3<f32>, entityId: u32) -> VertexOutput {\n          var output: VertexOutput;\n          let worldPos = uniforms.model * vec4<f32>(localPos, 1.0);\n          let eyePos = rtePosition(localPos).xyz;\n          let rte = (uniforms.flags.x & RTE_DRAWABLE_FLAG) != 0u;\n          output.position = select(uniforms.viewProj * worldPos, uniforms.rteViewProj * vec4<f32>(eyePos, 1.0), rte);\n          // Anti z-fighting depth nudge \u2014 see vs_main's comment.\n          let colorSalt = (entityId >> 24u) * 2654435761u;\n          let zHash = (((entityId & 0x00FFFFFFu) ^ colorSalt) * 2654435761u) & 255u;\n          output.position.z *= 1.0 + f32(zHash) * 1e-6;\n          output.worldPos = worldPos.xyz;\n          output.normal = normalize((uniforms.model * vec4<f32>(localNormal, 0.0)).xyz);\n          output.entityId = entityId;\n          output.color = uniforms.baseColor;\n          output.instSelected = 0u;\n          output.eyePos = eyePos;\n          return output;\n        }\n\n        @vertex\n        fn vs_main_quantized(input: QuantizedVertexInput) -> VertexOutput {\n          let p = uniforms.quantParams.xyz\n            + vec3<f32>(f32(input.q.x), f32(input.q.y), f32(input.q.z)) * uniforms.quantParams.w;\n          return shadeFlatVertex(p, octDecodeN(input.q.w), input.entityId);\n        }\n\n        @vertex\n        fn vs_main(input: VertexInput, @builtin(instance_index) instanceIndex: u32) -> VertexOutput {\n          var output: VertexOutput;\n          let worldPos = uniforms.model * vec4<f32>(input.position, 1.0);\n          let eyePos = rtePosition(input.position).xyz;\n          let rte = (uniforms.flags.x & RTE_DRAWABLE_FLAG) != 0u;\n          output.position = select(uniforms.viewProj * worldPos, uniforms.rteViewProj * vec4<f32>(eyePos, 1.0), rte);\n          // Anti z-fighting: deterministic depth nudge.\n          // Knuth multiplicative hash spreads sequential IDs across 0-255 so\n          // coplanar faces from different entities always get distinct depths.\n          // Material-layer walls slice into one closed solid per layer, all\n          // sharing the PARENT wall's expressId, so adjacent layers' coincident\n          // interface caps would get the same entity nudge and z-fight into a\n          // flickering comb (\"see inside the wall\"). To separate them we fold in\n          // an 8-bit MATERIAL-COLOUR salt that mergeGeometry/interleaveTextured\n          // baked into the HIGH 8 bits of the entityId lane (low 24 = picking id,\n          // masked off by encodeId24). Crucially the salt comes from the mesh's\n          // OWN colour, NOT the per-draw baseColor uniform \u2014 so every redraw of\n          // the same geometry with a different draw colour (the selection\n          // highlight's greater-equal pass) computes the SAME nudge as its\n          // batch. At 1e-6 per step the max world-space offset is <3mm at 10m.\n          let colorSalt = (input.entityId >> 24u) * 2654435761u;\n          let zHash = (((input.entityId & 0x00FFFFFFu) ^ colorSalt) * 2654435761u) & 255u;\n          output.position.z *= 1.0 + f32(zHash) * 1e-6;\n          output.worldPos = worldPos.xyz;\n          output.normal = normalize((uniforms.model * vec4<f32>(input.normal, 0.0)).xyz);\n          output.entityId = input.entityId;\n          output.color = uniforms.baseColor;\n          output.instSelected = 0u;  // flat path selects via uniforms.flags.x\n          output.eyePos = eyePos;\n          return output;\n        }\n\n        // Instanced vertex entry \u2014 one template's geometry drawn once per\n        // occurrence. The per-instance mat4 already folds SWAP * rel_k * T(origin)\n        // (composed CPU-side, see instanced-render.ts), so it maps the template's\n        // LOCAL vertex straight to WebGL Y-up world space \u2014 no uniforms.model.\n        // rel_k and SWAP are rigid (no scale), so the same matrix transforms\n        // normals. entityId + colour come per-occurrence from the instance buffer.\n        @vertex\n        fn vs_instanced(input: VertexInput, inst: InstanceInput) -> VertexOutput {\n          var output: VertexOutput;\n          let instMat = mat4x4<f32>(inst.m0, inst.m1, inst.m2, inst.m3);\n          let worldPos = instMat * vec4<f32>(input.position, 1.0);\n          let linearLocal = (instMat * vec4<f32>(input.position, 0.0)).xyz;\n          let eyePos = rteInstancePosition(linearLocal, inst.anchorHigh.xyz, inst.anchorLow.xyz).xyz;\n          output.position = uniforms.rteViewProj * vec4<f32>(eyePos, 1.0);\n          // Same per-entity depth nudge as vs_main. No colour salt here: the\n          // instanced path never redraws an occurrence with a second draw\n          // colour, so the raw picking id is enough to separate coplanar entities.\n          let zHash = ((inst.instEntityId & 0x00FFFFFFu) * 2654435761u) & 255u;\n          output.position.z *= 1.0 + f32(zHash) * 1e-6;\n          output.worldPos = worldPos.xyz;\n          output.normal = normalize((instMat * vec4<f32>(input.normal, 0.0)).xyz);\n          output.entityId = inst.instEntityId;\n          output.color = inst.instColor;\n          output.instSelected = inst.instSelected;\n          output.eyePos = eyePos;\n          return output;\n        }\n\n        fn encodeId24(id: u32) -> vec4<f32> {\n          let r = f32((id >> 16u) & 255u) / 255.0;\n          let g = f32((id >> 8u) & 255u) / 255.0;\n          let b = f32(id & 255u) / 255.0;\n          return vec4<f32>(r, g, b, 1.0);\n        }\n\n        struct FragmentOutput {\n          @location(0) color: vec4<f32>,\n          @location(1) objectIdEncoded: vec4<f32>,\n        }\n\n        @fragment\n        fn fs_main(input: VertexOutput) -> FragmentOutput {\n          // The flat/quantized/textured mesh paths submit this in one\n          // camera-relative frame. Do all camera-local fragment arithmetic in\n          // that frame; otherwise the RTE vertex precision is thrown away at\n          // section/crop/derivative ingress. Instanced geometry is not yet\n          // anchored, so its worldPos remains the authoritative input.\n          let fragmentPos = clipSpacePos(input.worldPos, input.eyePos);\n          // Per-instance hide/isolate: bit 1 of the instance flags lane marks a hidden\n          // occurrence. Discard it so it neither draws nor writes depth (and the pick\n          // pass applies the same discard, so it isn't pickable). vs_main writes\n          // instSelected=0u for flat geometry, so this never affects the flat path.\n          if ((input.instSelected & 2u) != 0u) {\n            discard;\n          }\n          // Per-instance opacity routing (instanced passes only \u2014 flags.x bit 2). The\n          // opaque instanced pass draws fully-opaque (or selected) occurrences; the\n          // transparent instanced sub-pass (bit 3, alpha-blended) draws the rest. Discard\n          // the occurrences belonging to the OTHER pass so each is drawn exactly once.\n          // Lens-ghost / x-ray / compare write a low per-instance alpha into input.color.a.\n          if ((uniforms.flags.x & 4u) != 0u) {\n            let occOpaque = input.color.a >= 0.99 || (input.instSelected & 1u) != 0u;\n            let transparentPass = (uniforms.flags.x & 8u) != 0u;\n            if (transparentPass) {\n              if (occOpaque) { discard; }\n            } else {\n              if (!occOpaque) { discard; }\n            }\n          }\n          // Section plane / clip box (mesh-uniforms.wgsl.ts, shared with the\n          // selection mask so an outline is cut where its surface is).\n          if (sectionClipped(fragmentPos)) { discard; }\n\n          // Compute normal via derivative-based flat shading.\n          //\n          // Industry-standard solution for BIM/CAD viewers \u2014 what\n          // Three.js (material.flatShading = true), Autodesk Forge,\n          // Speckle, and xeokit all do for opaque surfaces. Rationale:\n          //\n          //   * BIM geometry is overwhelmingly flat surfaces (walls,\n          //     slabs, roofs, beams), and CSG operations (opening\n          //     subtraction, layer slicing) emit those surfaces as\n          //     dense strips of coplanar triangles. Per-vertex normal\n          //     averaging gives a SLIGHTLY-different normal at each\n          //     vertex due to f32 noise from boolean output; the\n          //     boundary between strips then reads as a visible darker/\n          //     brighter scar line \u2014 the horizontal striations on\n          //     walls, stripes on roofs, visible triangulation reports\n          //     across every CSG kernel we have tried (legacy BSP,\n          //     Manifold).\n          //   * cross(dpdx, dpdy) of world position evaluates to the\n          //     EXACT face normal in the fragment shader. Every\n          //     fragment on a flat face \u2014 across an arbitrarily-fine\n          //     triangulation \u2014 gets the IDENTICAL normal, so coplanar\n          //     splits become invisible by construction. No CPU-side\n          //     welding, smooth-grouping, or coplanar-face merging\n          //     fixes the symptom as cleanly.\n          //\n          // Trade-off: genuinely curved surfaces (cylinder tessellations,\n          // BSpline approximations) shade with visible facets. For BIM\n          // that's acceptable \u2014 curved surfaces are < 5 % of typical\n          // model triangle count and the faceting matches CAD-tool\n          // (Revit, ArchiCAD) on-screen behaviour at default quality.\n          //\n          // We still fall back to the vertex normal when derivatives\n          // are unavailable (extreme polygon degeneracy where dpdx /\n          // dpdy collapse to zero \u2014 practically never on real geometry).\n          let faceN = cross(dpdx(fragmentPos), dpdy(fragmentPos));\n          let fLen2 = dot(faceN, faceN);\n          var N: vec3<f32>;\n          if (fLen2 > 1e-10) {\n            N = faceN * inverseSqrt(fLen2);\n          } else {\n            // Degenerate derivative \u2014 fall back to the vertex normal\n            // if it's populated, else +Y.\n            N = input.normal;\n            let nLen2 = dot(N, N);\n            if (nLen2 > 1e-6) {\n              N = N * inverseSqrt(nLen2);\n            } else {\n              N = vec3<f32>(0.0, 1.0, 0.0);\n            }\n          }\n\n          // Stabilize the SIGN of the derivative face normal with the vertex\n          // normal. The screen-space cross product gives the exact face\n          // normal DIRECTION for coplanar strips (the scar-line fix), but at\n          // grazing angles its SIGN becomes numerically unstable per quad \u2014\n          // hemisphere/rim lighting then band-flips across large regions of\n          // flat walls/slabs (diagonal lighter/darker bands). The interpolated\n          // vertex normal is quad-noise-free, so use it only to orient N.\n          // Guard: skip when the vertex normal is missing or nearly\n          // perpendicular to the face normal (unreliable witness).\n          let vN = input.normal;\n          let alignDot = dot(N, vN);\n          if (alignDot * alignDot > 0.03 * dot(vN, vN)) {\n            N = N * sign(alignDot);\n          }\n\n          // Lighting environment \u2014 sun/hemisphere/exposure come from the\n          // global env uniform. The fill follows the sun (it bounces in from\n          // the opposite side); the rim stays fixed in world space as a\n          // stylistic shaping light.\n          let sunLight = env.sunDirection;\n          // Horizontal mirror of the sun, lifted slightly. An overhead sun\n          // leaves (0, 0.25, 0), which normalizes to straight up.\n          let fillLight = normalize(vec3<f32>(-sunLight.x, 0.25, -sunLight.z));\n          let rimLight = normalize(vec3<f32>(0.0, 0.2, -1.0));  // Rim light for edge definition\n\n          // Hemisphere ambient. This, not the sun, keeps faces turned away\n          // from the sun readable (I-beam webs and flange undersides, #5382).\n          let hemisphereFactor = N.y * 0.5 + 0.5;\n          let ambient = mix(env.groundColor, env.skyColor, hemisphereFactor) * env.ambientIntensity;\n\n          // One-sided sun, so a building has a lit side and a shaded side.\n          // sunSoftness is the diffuse wrap (env uniform): 0 = crisp\n          // terminator (hard shadows), larger = softer wrap-around (overcast).\n          let NdotL = dot(N, sunLight);\n          let wrap = env.sunSoftness;\n          let diffuseSun = max((NdotL + wrap) / (1.0 + wrap), 0.0) * env.sunIntensity;\n\n          // Fill light, one-sided like the sun.\n          let NdotFill = max(dot(N, fillLight), 0.0);\n          let diffuseFill = NdotFill * env.fillIntensity;\n\n          // Rim light for edge definition\n          let NdotRim = max(dot(N, rimLight), 0.0);\n          let rim = pow(NdotRim, 4.0) * env.rimIntensity;\n\n          // The authored colour is display-referred sRGB; light it in linear.\n          // (textured.wgsl.ts anchors on the first line to multiply in the texel.)\n          var baseColor = input.color.rgb;\n          baseColor = srgbToLinear(baseColor);\n\n          // Combine all lighting. Only the DIRECT sun term is occluded by cast\n          // shadows (#2670); ambient/fill/rim are indirect and stay unshadowed.\n          // Exposure scales the light, so the selection shade below and every\n          // later stage see one exposed irradiance.\n          let sunShadow = sunShadowFactor(input.eyePos, N, input.position.xy);\n          let lightTerm = ambient + env.sunColor * (diffuseSun * sunShadow) + vec3<f32>(diffuseFill + rim);\n          let irradiance = lightTerm * (env.exposure * IRRADIANCE_CALIBRATION);\n          var color = baseColor * irradiance;\n\n          // flags.x bit 0 (value 1) = isSelected \u2192 selection highlight, forced opaque.\n          // bit 1 (value 2) = isOverlay \u2192 legacy overlay pipeline callers;\n          // preserve alpha and skip specular for their blended draw.\n          // Selected via the per-draw flag (flat path) OR the per-occurrence flag\n          // (instanced path \u2014 vs_instanced reads it from the instance buffer).\n          let isSelected = ((uniforms.flags.x & 1u) == 1u) || ((input.instSelected & 1u) == 1u);\n          let isOverlay = (uniforms.flags.x & 2u) == 2u;\n\n          // Selection highlight \u2014 a blue albedo RE-LIT by the scene lighting.\n          //\n          // We override the material albedo with selection-blue and re-light\n          // it with the SAME lightTerm used for unselected surfaces, then\n          // skip the view-dependent (specular) term below. Two requirements\n          // are in tension and this satisfies both:\n          //\n          //   * No base-material bleed-through. The old fresnel-glow mix left\n          //     ~80 % of the lit object colour visible at face centres (the\n          //     green-site / red-roof wash-out). Here the base colour never\n          //     enters the result \u2014 only lightTerm (geometry/light, colour-\n          //     independent) modulates the constant blue albedo.\n          //   * Facet/crease structure must survive. A single FLAT colour\n          //     (the previous fix) collapsed every face to the same blue, so\n          //     internal edges \u2014 which read as the per-face shading STEP, not\n          //     just the faint screen-space edge line \u2014 disappeared on\n          //     selection. Re-lighting keeps that per-face brightness step, so\n          //     creases read on the highlight exactly as they do unselected.\n          //\n          // The luminance of the exposed irradiance is used as a multiplicative\n          // gain (which preserves the per-face brightness RATIOS, so creases\n          // read as strongly as on the unselected surface). The calibration\n          // puts a sunlit face at 1.0, i.e. full selection-blue, and the\n          // floor/ceiling clamp keeps shadowed faces only dimmed and bright\n          // scenes from washing out.\n          if (isSelected) {\n            let shadeLum = dot(irradiance, vec3<f32>(0.299, 0.587, 0.114));\n            let shade = clamp(shadeLum, 0.45, 1.2);\n            // selectionColor is already linear-light (set by Renderer.setOverlayTheme\n            // from the app theme, #5484) \u2014 no srgbToLinear here, unlike the constant\n            // it replaces.\n            color = selectionColor.rgb * shade;\n          }\n\n          // Public getOverlayPipeline() callers can still use the emphasized\n          // overlay bit even though internal colour overrides now use a table.\n          let emphasizedOverlay = isOverlay && (uniforms.flags.x & 32u) != 0u;\n          if (emphasizedOverlay) {\n            let facet = 0.85 + 0.15 * abs(dot(N, normalize(vec3<f32>(0.3, 1.0, 0.2))));\n            color = baseColor * facet;\n          }\n\n          // Selected objects and emphasized overlays draw fully opaque.\n          var finalAlpha = select(input.color.a, 1.0, isSelected || emphasizedOverlay);\n\n          // Specular (#5386; specular.wgsl.ts), after the diffuse above. Not\n          // on the selection highlight or legacy overlay (it would wash out\n          // their colours); a table override is composited without it below. The\n          // sun lobe is scaled exactly like the diffuse sun term, and both\n          // terms like irradiance, so a preset's highlights and diffuse move together.\n          if (!isSelected && !isOverlay) {\n            // Glass is an authored translucent material (mesh-material.ts\n            // also gives it its smooth roughness). An X-Ray or compare fade\n            // only lowers the alpha and stays a fade. Instanced occurrences\n            // are never authored translucent: prepareInstancedRender routes\n            // those to the flat path, so the per-pass lane is ignored there.\n            let instancedPass = (uniforms.flags.x & 4u) != 0u;\n            let translucent = finalAlpha < 0.99;\n            let glass = translucent && uniforms.transmission.x > 0.5 && !instancedPass;\n            // #5984: an instanced occurrence's own authored finish rides its\n            // flags lane (instanced-render.ts packInstanceFinish); the pass's\n            // uniform row is the shared default.\n            var metallicRoughness = vec2<f32>(uniforms.metallicRoughness.x, uniforms.metallicRoughness.y);\n            if (instancedPass && (input.instSelected & 4u) != 0u) {\n              metallicRoughness.x = f32((input.instSelected >> 16u) & 255u) / 255.0;\n            }\n            if (instancedPass && (input.instSelected & 8u) != 0u) {\n              metallicRoughness.y = f32((input.instSelected >> 24u) & 255u) / 255.0;\n            }\n            let metallic = clamp(metallicRoughness.x, 0.0, 1.0);\n            let spec = surfaceSpecular(\n              N,\n              normalize(-input.eyePos),\n              baseColor,\n              metallic,\n              metallicRoughness.y,\n              env.sunColor * (env.sunIntensity * sunShadow),\n            );\n            // What the lobe reflects is not there to diffuse; a metal has no\n            // diffuse at all.\n            let diffuse = color * (1.0 - spec.reflectance) * (1.0 - metallic);\n            let reflected = spec.light * (env.exposure * IRRADIANCE_CALIBRATION);\n            if (translucent) {\n              finalAlpha = finalAlpha * TRANSLUCENT_OPACITY_SCALE;\n            }\n            if (glass) {\n              // The transparent pipelines blend straight alpha:\n              // out = c * a + behind * (1 - a). A pane passes what is behind\n              // it except what its body absorbs and its surface reflects, and\n              // its reflection is not dimmed by the body's opacity, so solve\n              // for (c, a). The reflectance rising at grazing angles is what\n              // makes glass more opaque there; a bright sun glint raises the\n              // alpha further so it is not clipped to the body's opacity.\n              let body = finalAlpha;\n              let reflectance = dot(spec.reflectance, vec3<f32>(0.299, 0.587, 0.114));\n              let premultiplied = diffuse * body + reflected;\n              let peak = max(premultiplied.r, max(premultiplied.g, premultiplied.b));\n              finalAlpha = clamp(max(body + reflectance * (1.0 - body), peak), 0.0, 1.0);\n              color = premultiplied / max(finalAlpha, 0.0001);\n            } else {\n              color = diffuse + reflected;\n            }\n          }\n\n          // Hue-preserving highlight roll-off (color-transfer.wgsl.ts). No\n          // contrast curve and no saturation boost: an authored colour lit at\n          // unit irradiance leaves here unchanged unless it is brighter than\n          // the roll-off threshold.\n          color = neutralCompress(color);\n\n          color = linearToSrgb(clamp(color, vec3<f32>(0.0), vec3<f32>(1.0)));\n\n          var out: FragmentOutput;\n          out.color = vec4<f32>(color, finalAlpha);\n          // Colour override from the per-entity table (#6076): only draws the\n          // renderer marks (overrideParams.y), i.e. depth-writing opaque ones.\n          let entityOverride = entityOverrideColor(input.entityId);\n          if (entityOverride.a >= 0.0 && !isSelected) {\n            out.color = paintEntityOverride(out.color, entityOverride, irradiance, N);\n          }\n          out.objectIdEncoded = encodeId24(input.entityId);\n          return out;\n        }\n      ";
 //# sourceMappingURL=main.wgsl.d.ts.map

package/dist/shaders/main.wgsl.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"main.wgsl.d.ts","sourceRoot":"","sources":["../../src/shaders/main.wgsl.ts"],"names":[],"mappings":"AA0CA,eAAO,MAAM,gBAAgB,04uCA0iBtB,CAAC"}
+{"version":3,"file":"main.wgsl.d.ts","sourceRoot":"","sources":["../../src/shaders/main.wgsl.ts"],"names":[],"mappings":"AA2CA,eAAO,MAAM,gBAAgB,4sxCAqetB,CAAC"}