@ifc-lite/renderer 3.2.0 → 5.0.0

package/dist/shaders/specular.wgsl.js

@@ -0,0 +1,134 @@
+/* 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/. */
+/**
+ * Specular reflection for the geometry fragment stage (#5386).
+ *
+ * Two terms, both in the units of `fs_main`'s `lightTerm`, so the caller
+ * scales them by the same exposure and `IRRADIANCE_CALIBRATION` as the
+ * diffuse light and every preset stays consistent:
+ *
+ *  - the sun: a Cook-Torrance lobe (GGX distribution, Smith-Schlick
+ *    visibility, Schlick Fresnel). `fs_main` lights a Lambertian albedo as
+ *    `albedo * intensity`, i.e. the sun's irradiance is `pi * intensity`, so
+ *    the lobe is scaled by the same `pi` and a white dielectric reflects no
+ *    more than physics allows next to its diffuse.
+ *  - the environment: the same two-colour hemisphere that lights the diffuse
+ *    ambient, read along the reflection vector and weighted by the
+ *    split-sum environment BRDF (Karis's analytic fit, "Physically Based
+ *    Shading on Mobile", 2014). The fit already accounts for the lobe's
+ *    shadowing, so a rough surface picks up almost nothing at grazing angles
+ *    while a smooth one (glass) turns into a mirror there.
+ *
+ * `reflectance` is that directional albedo of the specular lobe. The caller
+ * takes it off the diffuse (`1 - reflectance`), so a highlight never adds
+ * energy on top of a full diffuse, and glass uses it as the light it no
+ * longer transmits.
+ *
+ * Reads the `env` lighting uniform, like `sunShadowFactor`.
+ */
+/**
+ * Smallest roughness the lobe is evaluated at. Below this the GGX peak is a
+ * sub-pixel spike that flickers from frame to frame. The value is Filament's
+ * `MIN_PERCEPTUAL_ROUGHNESS` for 32-bit floats.
+ */
+export const MIN_SPECULAR_ROUGHNESS = 0.045;
+export const specularWgsl = `
+        const MIN_SPECULAR_ROUGHNESS: f32 = ${MIN_SPECULAR_ROUGHNESS};
+        const DIELECTRIC_F0: f32 = 0.04;
+        const PI: f32 = 3.14159265;
+
+        fn fresnelSchlick(cosTheta: f32, F0: vec3<f32>) -> vec3<f32> {
+          return F0 + (1.0 - F0) * pow(clamp(1.0 - cosTheta, 0.0, 1.0), 5.0);
+        }
+
+        fn distributionGGX(NdotH: f32, roughness: f32) -> f32 {
+          let a = roughness * roughness;
+          let a2 = a * a;
+          let NdotH2 = NdotH * NdotH;
+          let denomBase = (NdotH2 * (a2 - 1.0) + 1.0);
+          return a2 / max(PI * denomBase * denomBase, 0.0000001);
+        }
+
+        fn geometrySchlickGGX(NdotV: f32, roughness: f32) -> f32 {
+          let r = (roughness + 1.0);
+          let k = (r * r) / 8.0;
+          return NdotV / max(NdotV * (1.0 - k) + k, 0.0000001);
+        }
+
+        fn geometrySmith(NdotV: f32, NdotL: f32, roughness: f32) -> f32 {
+          return geometrySchlickGGX(NdotL, roughness) * geometrySchlickGGX(NdotV, roughness);
+        }
+
+        // Split-sum environment BRDF, analytic fit (Karis 2014).
+        fn envBrdfApprox(F0: vec3<f32>, roughness: f32, NdotV: f32) -> vec3<f32> {
+          let r = roughness * vec4<f32>(-1.0, -0.0275, -0.572, 0.022) + vec4<f32>(1.0, 0.0425, 1.04, -0.04);
+          let a004 = min(r.x * r.x, exp2(-9.28 * NdotV)) * r.x + r.y;
+          let ab = vec2<f32>(-1.04, 1.04) * a004 + r.zw;
+          return F0 * ab.x + ab.y;
+        }
+
+        struct SurfaceSpecular {
+          // Reflected light, in lightTerm units (unexposed, uncalibrated).
+          light: vec3<f32>,
+          // Directional albedo of the specular lobe for this view.
+          reflectance: vec3<f32>,
+        }
+
+        // N and V are unit vectors; V points from the surface to the eye.
+        // sunLight is the sun's diffuse-equivalent intensity: sunColor *
+        // sunIntensity * sunShadow, exactly what scales the diffuse sun term.
+        fn surfaceSpecular(
+          N: vec3<f32>,
+          V: vec3<f32>,
+          albedo: vec3<f32>,
+          metallic: f32,
+          roughnessIn: f32,
+          sunLight: vec3<f32>,
+        ) -> SurfaceSpecular {
+          var out: SurfaceSpecular;
+          let NdotV = dot(N, V);
+          // A face turned away from the eye is its back side: nothing it
+          // reflects can reach the eye, and its diffuse keeps full weight.
+          if (NdotV <= 0.0) {
+            out.light = vec3<f32>(0.0);
+            out.reflectance = vec3<f32>(0.0);
+            return out;
+          }
+          let roughness = clamp(roughnessIn, MIN_SPECULAR_ROUGHNESS, 1.0);
+          let F0 = mix(vec3<f32>(DIELECTRIC_F0), albedo, metallic);
+
+          let L = env.sunDirection;
+          let rawNdotL = dot(N, L);
+          let NdotL = max(rawNdotL, 0.0);
+          // A face the sun is behind (rawNdotL <= 0) contributes nothing to
+          // the direct lobe anyway (NdotL clamps it to 0 below), but V + L
+          // can be exactly zero there — the sun exactly opposite the eye
+          // reflection, e.g. N = V = (0,-1,0), sun = (0,1,0), both satisfy
+          // NdotV > 0 above. normalize(vec3(0)) is NaN in WGSL, and NaN * 0
+          // is NaN, not 0, so it would poison sun and everything summed with
+          // it instead of being multiplied away. Skip the half-vector
+          // entirely in that case rather than relying on the NdotL factor.
+          var sun = vec3<f32>(0.0);
+          if (rawNdotL > 0.0) {
+            let H = normalize(V + L);
+            let D = distributionGGX(max(dot(N, H), 0.0), roughness);
+            let G = geometrySmith(NdotV, NdotL, roughness);
+            let F = fresnelSchlick(max(dot(V, H), 0.0), F0);
+            // BRDF * NdotL * (pi * intensity); the NdotL cancels the BRDF's.
+            sun = F * (D * G * PI / (4.0 * NdotV)) * sunLight;
+          }
+
+          // The hemisphere ambient, looked up along the reflection. A rough
+          // lobe gathers from around the normal, so lean the lookup toward N.
+          let R = reflect(-V, N);
+          let Rd = normalize(mix(R, N, roughness * roughness));
+          let sky = mix(env.groundColor, env.skyColor, Rd.y * 0.5 + 0.5) * env.ambientIntensity;
+          let reflectance = envBrdfApprox(F0, roughness, NdotV);
+
+          out.light = sun + sky * reflectance;
+          out.reflectance = reflectance;
+          return out;
+        }
+`;
+//# sourceMappingURL=specular.wgsl.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"specular.wgsl.js","sourceRoot":"","sources":["../../src/shaders/specular.wgsl.ts"],"names":[],"mappings":"AAAA;;+DAE+D;AAE/D;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;AAEH;;;;GAIG;AACH,MAAM,CAAC,MAAM,sBAAsB,GAAG,KAAK,CAAC;AAE5C,MAAM,CAAC,MAAM,YAAY,GAAG;8CACkB,sBAAsB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAgGnE,CAAC"}

package/dist/shaders/symbolic-overlay.wgsl.d.ts

@@ -1,10 +1,3 @@
-/**
- * WGSL shaders for the IfcAnnotation overlay (fills + text labels).
- *
- * Two pipelines share this file because they ride the same camera uniform
- * layout and write into the same RGBA-blended pass. Splitting per-pipeline
- * would mean two near-identical vertex inputs and duplicate camera structs.
- */
-export declare const SYMBOLIC_FILL_WGSL = "\nstruct Camera {\n  viewProj: mat4x4<f32>,\n};\n\n@group(0) @binding(0) var<uniform> camera: Camera;\n\nstruct VsIn {\n  @location(0) position: vec3<f32>,\n  @location(1) color:    vec4<f32>,\n};\n\nstruct VsOut {\n  @builtin(position) clipPos: vec4<f32>,\n  @location(0)        color:  vec4<f32>,\n};\n\n@vertex\nfn vs_main(in: VsIn) -> VsOut {\n  var out: VsOut;\n  out.clipPos = camera.viewProj * vec4<f32>(in.position, 1.0);\n  out.color   = in.color;\n  return out;\n}\n\n@fragment\nfn fs_main(in: VsOut) -> @location(0) vec4<f32> {\n  // Premultiply alpha so the standard \"src * 1 + dst * (1-src.a)\" blend\n  // produces the correct composite on top of the existing scene.\n  return vec4<f32>(in.color.rgb * in.color.a, in.color.a);\n}\n";
-export declare const SYMBOLIC_TEXT_WGSL = "\nstruct Camera {\n  viewProj: mat4x4<f32>,\n  // x = viewport width in physical pixels, y = viewport height\n  // z = target glyph cap-height in screen pixels, w = padding\n  viewportAndTarget: vec4<f32>,\n  // Screen-aligned camera basis (world space). xyz = direction, w = padding.\n  // Used by billboarded glyphs (grid tags) so they always face the camera \u2014\n  // critical for top-down/ground views where world-up upAxis collapses to\n  // zero screen extent and the tag becomes invisible.\n  cameraRight: vec4<f32>,\n  cameraUp:    vec4<f32>,\n};\n\n@group(0) @binding(0) var<uniform> camera: Camera;\n@group(0) @binding(1) var atlasTex: texture_2d<f32>;\n@group(0) @binding(2) var atlasSamp: sampler;\n\n// Per-vertex (corner of the glyph quad).\nstruct VsIn {\n  // Bit-packed corner index 0..3. The vertex buffer is just [0u, 1u, 2u, 3u].\n  @location(0) corner: u32,\n};\n\n// Per-instance attributes \u2014 one record per glyph.\nstruct InstIn {\n  // World-space origin of the glyph (bottom-left, after alignment + rotation).\n  @location(1) origin: vec3<f32>,\n  // Right axis in world space \u2014 encodes both glyph width and baseline rotation.\n  @location(2) rightAxis: vec3<f32>,\n  // Up axis in world space \u2014 encodes glyph height and baseline rotation.\n  @location(3) upAxis: vec3<f32>,\n  // Atlas UV bounds: (u0, v0, u1, v1).\n  @location(4) uvBounds: vec4<f32>,\n  // Glyph tint (sRGB straight-alpha).\n  @location(5) color: vec4<f32>,\n  // Shared text-label anchor (every glyph in the same label uses the same\n  // anchor). Lets the shader compute one screen-space scale per label and\n  // apply it uniformly to every glyph offset so row spacing stays in sync.\n  @location(6) anchor: vec3<f32>,\n  // Authored cap height in world units. Same value for every glyph in the\n  // label; used to convert \"target pixels\" into a scale factor.\n  @location(7) capHeight: f32,\n  // Billboard flag (1.0 = use camera-aligned axes, 0.0 = use authored\n  // rightAxis/upAxis). Only the grid-tag emission path sets this to 1.0.\n  @location(8) billboard: f32,\n  // Per-glyph baseline-relative offset + size in WORLD units. Only used\n  // when billboard=1 (the authored origin bakes the offset along the\n  // floor-plane basis, which is the wrong direction for camera-aligned\n  // text). For non-billboard glyphs these are written too but the shader\n  // picks the authored path. World units = atlas-pixel * wScale.\n  //   .xy = (offsetX, offsetY) from anchor to glyph BL\n  //   .zw = (width, height) of the glyph quad\n  @location(9) glyphOffsetSize: vec4<f32>,\n  // Per-instance target cap height in screen pixels. 0 = fall back to\n  // the renderer global default (viewportAndTarget.z). Grid bubble\n  // glyphs override with a larger value so the bubble stays proportional\n  // to the tag at every zoom level.\n  @location(10) targetPxOverride: f32,\n};\n\nstruct VsOut {\n  @builtin(position) clipPos: vec4<f32>,\n  @location(0) uv:    vec2<f32>,\n  @location(1) color: vec4<f32>,\n};\n\n@vertex\nfn vs_main(in: VsIn, inst: InstIn) -> VsOut {\n  // Map corner index to (u, v) in [0, 1] \u2014 the four quad corners.\n  //   0 = bottom-left, 1 = bottom-right, 2 = top-left, 3 = top-right.\n  let u = f32((in.corner & 1u));      // 0,1,0,1\n  let v = f32((in.corner >> 1u) & 1u); // 0,0,1,1\n\n  // \u2500\u2500 Screen-space text scaling (projection-agnostic) \u2500\u2500\n  // For non-billboard glyphs measure world-Y \u2192 screen pixels (matches the\n  // authored upAxis convention). For billboard glyphs measure cameraUp \u2192\n  // screen pixels \u2014 that axis ALWAYS spans the full viewport height\n  // regardless of view angle, so screen-space scaling stays correct in\n  // top-down / ground / oblique views.\n  let isBillboard = inst.billboard > 0.5;\n  let scaleProbeAxis = select(vec3<f32>(0.0, 1.0, 0.0), camera.cameraUp.xyz, isBillboard);\n  let aClip = camera.viewProj * vec4<f32>(inst.anchor, 1.0);\n  let bClip = camera.viewProj * vec4<f32>(inst.anchor + scaleProbeAxis, 1.0);\n  let aNdc = aClip.xy / max(abs(aClip.w), 1e-4);\n  let bNdc = bClip.xy / max(abs(bClip.w), 1e-4);\n  let unitYPx = length(bNdc - aNdc) * camera.viewportAndTarget.y * 0.5;\n\n  let safeCap = max(inst.capHeight, 1e-4);\n  let currentPx = safeCap * unitYPx;\n  // Per-instance target overrides the uniform default (used by grid bubble\n  // glyphs to render at a larger on-screen size than the inscribed tag).\n  let targetPx = select(camera.viewportAndTarget.z, inst.targetPxOverride, inst.targetPxOverride > 0.0);\n  // Clamp to (0.02, 1.0]: never grow text beyond authored size; never\n  // shrink below ~2%.\n  let scale = clamp(\n    targetPx / max(currentPx, 1e-2),\n    0.02,\n    1.0,\n  );\n\n  // \u2500\u2500 Position the glyph quad in world space \u2500\u2500\n  // Non-billboard: authored axes (text lies in the floor plane of its\n  // annotation \u2014 IFC convention). Billboard: camera-aligned axes (text\n  // always faces the camera \u2014 grid-tag convention).\n  let authoredLocalOffset = inst.origin - inst.anchor;\n  let authoredWorldPos =\n      inst.anchor\n    + authoredLocalOffset * scale\n    + inst.rightAxis * scale * u\n    + inst.upAxis    * scale * v;\n\n  // Billboard: rebuild the quad in screen-aligned camera basis. glyphOffsetSize\n  // carries the same 2D atlas-pixel layout the upload computed, just in\n  // world units \u2014 re-project onto (cameraRight, cameraUp) so it tracks the\n  // viewer's eye in every orientation.\n  let bbOffsetX = inst.glyphOffsetSize.x;\n  let bbOffsetY = inst.glyphOffsetSize.y;\n  let bbWidth   = inst.glyphOffsetSize.z;\n  let bbHeight  = inst.glyphOffsetSize.w;\n  let billboardWorldPos =\n      inst.anchor\n    + (camera.cameraRight.xyz * bbOffsetX + camera.cameraUp.xyz * bbOffsetY) * scale\n    + (camera.cameraRight.xyz * bbWidth   * u\n     + camera.cameraUp.xyz    * bbHeight  * v) * scale;\n\n  let worldPos = select(authoredWorldPos, billboardWorldPos, isBillboard);\n\n  // UV: lerp atlas bounds. Note v inverted (atlas top is v=0).\n  let uMix = mix(inst.uvBounds.x, inst.uvBounds.z, u);\n  let vMix = mix(inst.uvBounds.w, inst.uvBounds.y, v);\n\n  var out: VsOut;\n  let clip = camera.viewProj * vec4<f32>(worldPos, 1.0);\n  // Reverse-Z decal nudge for text coplanar with model faces (issue #812\n  // follow-up: \"30\", \"1.49\" etc. flickering against the terrain). The\n  // pipeline-level depthBiasSlopeScale collapses to ~0 for billboard\n  // glyphs \u2014 the quad faces the camera, so depth slope across the quad\n  // is zero \u2014 leaving only a tiny -4 constant that MSAA jitter beats.\n  // Adding a small positive multiple of clip.w raises NDC z by a\n  // constant after the w-divide, which under reverse-Z reads as\n  // \"slightly closer\" \u2014 same trick the line pipeline uses.\n  out.clipPos = vec4<f32>(clip.x, clip.y, clip.z + 5e-5 * clip.w, clip.w);\n  out.uv      = vec2<f32>(uMix, vMix);\n  out.color   = inst.color;\n  return out;\n}\n\n@fragment\nfn fs_main(in: VsOut) -> @location(0) vec4<f32> {\n  let atlas = textureSample(atlasTex, atlasSamp, in.uv);\n  // The atlas was rasterised with white glyphs on a transparent background,\n  // so atlas.r is the coverage and atlas.a is the alpha. Multiply by the\n  // per-glyph tint and premultiply for the standard composite.\n  let alpha = atlas.a * in.color.a;\n  return vec4<f32>(in.color.rgb * alpha, alpha);\n}\n";
+export declare const SYMBOLIC_FILL_WGSL = "\nstruct Camera {\n  viewProj: mat4x4<f32>,\n  rteViewProj: mat4x4<f32>,\n  originHigh: vec4<f32>,\n  originLow: vec4<f32>,\n};\n\n@group(0) @binding(0) var<uniform> camera: Camera;\n\nstruct VsIn {\n  @location(0) position: vec3<f32>,\n  @location(1) color:    vec4<f32>,\n};\n\nstruct VsOut {\n  @builtin(position) clipPos: vec4<f32>,\n  @location(0)        color:  vec4<f32>,\n};\n\n@vertex\nfn vs_main(in: VsIn) -> VsOut {\n  var out: VsOut;\n  let global = camera.viewProj * vec4<f32>(in.position, 1.0);\n  let relative = (in.position + camera.originHigh.xyz) + camera.originLow.xyz;\n  out.clipPos = select(global, camera.rteViewProj * vec4<f32>(relative, 1.0), camera.originHigh.w == 1.0);\n  out.color   = in.color;\n  return out;\n}\n\n@fragment\nfn fs_main(in: VsOut) -> @location(0) vec4<f32> {\n  // Premultiply alpha so the standard \"src * 1 + dst * (1-src.a)\" blend\n  // produces the correct composite on top of the existing scene.\n  return vec4<f32>(in.color.rgb * in.color.a, in.color.a);\n}\n";
+export declare const SYMBOLIC_TEXT_WGSL = "\nstruct Camera {\n  viewProj: mat4x4<f32>,\n  // Legacy labels keep using viewProj. Anchored labels select this\n  // translation-free eye-relative matrix per instance.\n  rteViewProj: mat4x4<f32>,\n  // x = viewport width in physical pixels, y = viewport height\n  // z = target glyph cap-height in screen pixels, w = padding\n  viewportAndTarget: vec4<f32>,\n  // Screen-aligned camera basis (world space). xyz = direction, w = padding.\n  // Used by billboarded glyphs (grid tags) so they always face the camera \u2014\n  // critical for top-down/ground views where world-up upAxis collapses to\n  // zero screen extent and the tag becomes invisible.\n  cameraRight: vec4<f32>,\n  cameraUp:    vec4<f32>,\n  // Retained for the 208-byte symbolic-text uniform ABI. RTE text now packs\n  // its drawable-minus-camera delta on the CPU rather than subtracting these\n  // independently rounded absolute values in WGSL.\n  cameraHigh: vec4<f32>,\n  cameraLow:  vec4<f32>,\n};\n\n@group(0) @binding(0) var<uniform> camera: Camera;\n@group(0) @binding(1) var atlasTex: texture_2d<f32>;\n@group(0) @binding(2) var atlasSamp: sampler;\n\n// Per-vertex (corner of the glyph quad).\nstruct VsIn {\n  // Bit-packed corner index 0..3. The vertex buffer is just [0u, 1u, 2u, 3u].\n  @location(0) corner: u32,\n};\n\n// Per-instance attributes \u2014 one record per glyph.\nstruct InstIn {\n  // World-space origin of the glyph (bottom-left, after alignment + rotation).\n  @location(1) origin: vec3<f32>,\n  // Right axis in world space \u2014 encodes both glyph width and baseline rotation.\n  @location(2) rightAxis: vec3<f32>,\n  // Up axis in world space \u2014 encodes glyph height and baseline rotation.\n  @location(3) upAxis: vec3<f32>,\n  // Atlas UV bounds: (u0, v0, u1, v1).\n  @location(4) uvBounds: vec4<f32>,\n  // Glyph tint (sRGB straight-alpha).\n  @location(5) color: vec4<f32>,\n  // Shared text-label anchor (every glyph in the same label uses the same\n  // anchor). Lets the shader compute one screen-space scale per label and\n  // apply it uniformly to every glyph offset so row spacing stays in sync.\n  @location(6) anchor: vec3<f32>,\n  // Authored cap height in world units. Same value for every glyph in the\n  // label; used to convert \"target pixels\" into a scale factor.\n  @location(7) capHeight: f32,\n  // Billboard flag (1.0 = use camera-aligned axes, 0.0 = use authored\n  // rightAxis/upAxis). Only the grid-tag emission path sets this to 1.0.\n  @location(8) billboard: f32,\n  // Per-glyph baseline-relative offset + size in WORLD units. Only used\n  // when billboard=1 (the authored origin bakes the offset along the\n  // floor-plane basis, which is the wrong direction for camera-aligned\n  // text). For non-billboard glyphs these are written too but the shader\n  // picks the authored path. World units = atlas-pixel * wScale.\n  //   .xy = (offsetX, offsetY) from anchor to glyph BL\n  //   .zw = (width, height) of the glyph quad\n  @location(9) glyphOffsetSize: vec4<f32>,\n  // Per-instance target cap height in screen pixels. 0 = fall back to\n  // the renderer global default (viewportAndTarget.z). Grid bubble\n  // glyphs override with a larger value so the bubble stays proportional\n  // to the tag at every zoom level.\n  @location(10) targetPxOverride: f32,\n  // CPU-packed drawable-minus-camera delta. deltaHigh.w == 1 selects the\n  // RTE route; deltaLow.w marks an anchor-local static glyph origin for the\n  // legacy projection path too.\n  @location(11) deltaHigh: vec4<f32>,\n  @location(12) deltaLow: vec4<f32>,\n};\n\nstruct VsOut {\n  @builtin(position) clipPos: vec4<f32>,\n  @location(0) uv:    vec2<f32>,\n  @location(1) color: vec4<f32>,\n};\n\nfn rteClipPosition(\n  local: vec3<f32>, high: vec3<f32>, low: vec3<f32>, viewProj: mat4x4<f32>,\n) -> vec4<f32> {\n  // Do not first reconstruct a million-metre f32 position: that addition can\n  // discard centimetre local lanes before projection. Transform high and the\n  // combined local/low term independently, then combine in clip space where projection has\n  // reduced or cancelled the coordinate scale. A final raw f32 eye vector\n  // still cannot represent a sub-ULP residual at the \u00B11,000,000 m boundary.\n  return viewProj * vec4<f32>(high, 1.0) + viewProj * vec4<f32>(local + low, 0.0);\n}\n\n@vertex\nfn vs_main(in: VsIn, inst: InstIn) -> VsOut {\n  // Map corner index to (u, v) in [0, 1] \u2014 the four quad corners.\n  //   0 = bottom-left, 1 = bottom-right, 2 = top-left, 3 = top-right.\n  let u = f32((in.corner & 1u));      // 0,1,0,1\n  let v = f32((in.corner >> 1u) & 1u); // 0,0,1,1\n\n  // \u2500\u2500 Screen-space text scaling (projection-agnostic) \u2500\u2500\n  // For non-billboard glyphs measure world-Y \u2192 screen pixels (matches the\n  // authored upAxis convention). For billboard glyphs measure cameraUp \u2192\n  // screen pixels \u2014 that axis ALWAYS spans the full viewport height\n  // regardless of view angle, so screen-space scaling stays correct in\n  // top-down / ground / oblique views.\n  let isBillboard = inst.billboard > 0.5;\n  let isRte = inst.deltaHigh.w == 1.0;\n  let hasLocalOrigin = inst.deltaLow.w == 1.0;\n  // The f64 CPU path has already formed the drawable-camera delta. Project\n  // split terms independently so projection can retain low residuals.\n  let scaleProbeAxis = select(vec3<f32>(0.0, 1.0, 0.0), camera.cameraUp.xyz, isBillboard);\n  let aClip = select(\n    camera.viewProj * vec4<f32>(inst.anchor, 1.0),\n    rteClipPosition(vec3<f32>(0.0), inst.deltaHigh.xyz, inst.deltaLow.xyz, camera.rteViewProj),\n    isRte,\n  );\n  let bClip = select(\n    camera.viewProj * vec4<f32>(inst.anchor + scaleProbeAxis, 1.0),\n    rteClipPosition(scaleProbeAxis, inst.deltaHigh.xyz, inst.deltaLow.xyz, camera.rteViewProj),\n    isRte,\n  );\n  let aNdc = aClip.xy / max(abs(aClip.w), 1e-4);\n  let bNdc = bClip.xy / max(abs(bClip.w), 1e-4);\n  let unitYPx = length(bNdc - aNdc) * camera.viewportAndTarget.y * 0.5;\n\n  let safeCap = max(inst.capHeight, 1e-4);\n  let currentPx = safeCap * unitYPx;\n  // Per-instance target overrides the uniform default (used by grid bubble\n  // glyphs to render at a larger on-screen size than the inscribed tag).\n  let targetPx = select(camera.viewportAndTarget.z, inst.targetPxOverride, inst.targetPxOverride > 0.0);\n  // Clamp to (0.02, 1.0]: never grow text beyond authored size; never\n  // shrink below ~2%.\n  let scale = clamp(\n    targetPx / max(currentPx, 1e-2),\n    0.02,\n    1.0,\n  );\n\n  // \u2500\u2500 Position the glyph quad in world space \u2500\u2500\n  // Non-billboard: authored axes (text lies in the floor plane of its\n  // annotation \u2014 IFC convention). Billboard: camera-aligned axes (text\n  // always faces the camera \u2014 grid-tag convention).\n  // Anchored producers retain a small glyph-local origin; legacy producers\n  // retain the original absolute origin and derive its local offset here.\n  let authoredLocalOffset = select(inst.origin - inst.anchor, inst.origin, hasLocalOrigin);\n  let authoredLocalPos =\n      authoredLocalOffset * scale\n    + inst.rightAxis * scale * u\n    + inst.upAxis    * scale * v;\n\n  // Billboard: rebuild the quad in screen-aligned camera basis. glyphOffsetSize\n  // carries the same 2D atlas-pixel layout the upload computed, just in\n  // world units \u2014 re-project onto (cameraRight, cameraUp) so it tracks the\n  // viewer's eye in every orientation.\n  let bbOffsetX = inst.glyphOffsetSize.x;\n  let bbOffsetY = inst.glyphOffsetSize.y;\n  let bbWidth   = inst.glyphOffsetSize.z;\n  let bbHeight  = inst.glyphOffsetSize.w;\n  let billboardLocalPos =\n      (camera.cameraRight.xyz * bbOffsetX + camera.cameraUp.xyz * bbOffsetY) * scale\n    + (camera.cameraRight.xyz * bbWidth   * u\n     + camera.cameraUp.xyz    * bbHeight  * v) * scale;\n\n  let glyphLocalPos = select(authoredLocalPos, billboardLocalPos, isBillboard);\n  let worldPos = inst.anchor + glyphLocalPos;\n\n  // UV: lerp atlas bounds. Note v inverted (atlas top is v=0).\n  let uMix = mix(inst.uvBounds.x, inst.uvBounds.z, u);\n  let vMix = mix(inst.uvBounds.w, inst.uvBounds.y, v);\n\n  var out: VsOut;\n  let clip = select(\n    camera.viewProj * vec4<f32>(worldPos, 1.0),\n    rteClipPosition(glyphLocalPos, inst.deltaHigh.xyz, inst.deltaLow.xyz, camera.rteViewProj),\n    isRte,\n  );\n  // Reverse-Z decal nudge for text coplanar with model faces (issue #812\n  // follow-up: \"30\", \"1.49\" etc. flickering against the terrain). The\n  // pipeline-level depthBiasSlopeScale collapses to ~0 for billboard\n  // glyphs \u2014 the quad faces the camera, so depth slope across the quad\n  // is zero \u2014 leaving only a tiny -4 constant that MSAA jitter beats.\n  // Adding a small positive multiple of clip.w raises NDC z by a\n  // constant after the w-divide, which under reverse-Z reads as\n  // \"slightly closer\" \u2014 same trick the line pipeline uses.\n  out.clipPos = vec4<f32>(clip.x, clip.y, clip.z + 5e-5 * clip.w, clip.w);\n  out.uv      = vec2<f32>(uMix, vMix);\n  out.color   = inst.color;\n  return out;\n}\n\n// Halo (#5388): labels sit over model geometry as often as over the empty\n// backdrop, so no single ink is legible on both. Every glyph gets a thin\n// contrasting outline: the glyph coverage dilated by HALO_TEXELS, drawn under\n// the glyph in black (light text) or white (dark text). The quad and its UVs\n// were widened by the same margin on upload, and the atlas packs glyphs far\n// enough apart that the taps never reach a neighbour.\nconst HALO_TEXELS: f32 = 6.0;\nconst HALO_OPACITY: f32 = 0.8;\nconst HALO_DIRS = array<vec2<f32>, 8>(\n  vec2<f32>(1.0, 0.0), vec2<f32>(-1.0, 0.0), vec2<f32>(0.0, 1.0), vec2<f32>(0.0, -1.0),\n  vec2<f32>(0.7071, 0.7071), vec2<f32>(-0.7071, 0.7071), vec2<f32>(0.7071, -0.7071), vec2<f32>(-0.7071, -0.7071),\n);\n\n@fragment\nfn fs_main(in: VsOut) -> @location(0) vec4<f32> {\n  // The atlas was rasterised with white glyphs on a transparent background,\n  // so atlas.a is the coverage.\n  let coverage = textureSample(atlasTex, atlasSamp, in.uv).a;\n  let texel = 1.0 / vec2<f32>(textureDimensions(atlasTex));\n  var dilated = coverage;\n  // Two rings (full and half radius) so thin strokes and counters fill in.\n  for (var i = 0u; i < 8u; i = i + 1u) {\n    let d = HALO_DIRS[i] * texel * HALO_TEXELS;\n    dilated = max(dilated, textureSample(atlasTex, atlasSamp, in.uv + d).a);\n    dilated = max(dilated, textureSample(atlasTex, atlasSamp, in.uv + d * 0.5).a);\n  }\n  let luminance = dot(in.color.rgb, vec3<f32>(0.2126, 0.7152, 0.0722));\n  let haloRgb = select(vec3<f32>(1.0), vec3<f32>(0.0), luminance > 0.5);\n  // Glyph over halo, premultiplied for the standard composite.\n  let glyphA = coverage * in.color.a;\n  let haloA = dilated * HALO_OPACITY * in.color.a * (1.0 - glyphA);\n  return vec4<f32>(in.color.rgb * glyphA + haloRgb * haloA, glyphA + haloA);\n}\n";
 //# sourceMappingURL=symbolic-overlay.wgsl.d.ts.map

package/dist/shaders/symbolic-overlay.wgsl.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"symbolic-overlay.wgsl.d.ts","sourceRoot":"","sources":["../../src/shaders/symbolic-overlay.wgsl.ts"],"names":[],"mappings":"AAIA;;;;;;GAMG;AAEH,eAAO,MAAM,kBAAkB,+uBA+B9B,CAAC;AAEF,eAAO,MAAM,kBAAkB,mwOA6J9B,CAAC"}
+{"version":3,"file":"symbolic-overlay.wgsl.d.ts","sourceRoot":"","sources":["../../src/shaders/symbolic-overlay.wgsl.ts"],"names":[],"mappings":"AAcA,eAAO,MAAM,kBAAkB,0/BAoC9B,CAAC;AAEF,eAAO,MAAM,kBAAkB,yrVA8N9B,CAAC"}

package/dist/shaders/symbolic-overlay.wgsl.js

@@ -8,9 +8,13 @@
  * layout and write into the same RGBA-blended pass. Splitting per-pipeline
  * would mean two near-identical vertex inputs and duplicate camera structs.
  */
+import { GLYPH_HALO_PX } from '../symbolic-text-atlas.js';
 export const SYMBOLIC_FILL_WGSL = /* wgsl */ `
 struct Camera {
   viewProj: mat4x4<f32>,
+  rteViewProj: mat4x4<f32>,
+  originHigh: vec4<f32>,
+  originLow: vec4<f32>,
 };
 
 @group(0) @binding(0) var<uniform> camera: Camera;
@@ -28,7 +32,9 @@ struct VsOut {
 @vertex
 fn vs_main(in: VsIn) -> VsOut {
   var out: VsOut;
-  out.clipPos = camera.viewProj * vec4<f32>(in.position, 1.0);
+  let global = camera.viewProj * vec4<f32>(in.position, 1.0);
+  let relative = (in.position + camera.originHigh.xyz) + camera.originLow.xyz;
+  out.clipPos = select(global, camera.rteViewProj * vec4<f32>(relative, 1.0), camera.originHigh.w == 1.0);
   out.color   = in.color;
   return out;
 }
@@ -43,6 +49,9 @@ fn fs_main(in: VsOut) -> @location(0) vec4<f32> {
 export const SYMBOLIC_TEXT_WGSL = /* wgsl */ `
 struct Camera {
   viewProj: mat4x4<f32>,
+  // Legacy labels keep using viewProj. Anchored labels select this
+  // translation-free eye-relative matrix per instance.
+  rteViewProj: mat4x4<f32>,
   // x = viewport width in physical pixels, y = viewport height
   // z = target glyph cap-height in screen pixels, w = padding
   viewportAndTarget: vec4<f32>,
@@ -52,6 +61,11 @@ struct Camera {
   // zero screen extent and the tag becomes invisible.
   cameraRight: vec4<f32>,
   cameraUp:    vec4<f32>,
+  // Retained for the 208-byte symbolic-text uniform ABI. RTE text now packs
+  // its drawable-minus-camera delta on the CPU rather than subtracting these
+  // independently rounded absolute values in WGSL.
+  cameraHigh: vec4<f32>,
+  cameraLow:  vec4<f32>,
 };
 
 @group(0) @binding(0) var<uniform> camera: Camera;
@@ -99,6 +113,11 @@ struct InstIn {
   // glyphs override with a larger value so the bubble stays proportional
   // to the tag at every zoom level.
   @location(10) targetPxOverride: f32,
+  // CPU-packed drawable-minus-camera delta. deltaHigh.w == 1 selects the
+  // RTE route; deltaLow.w marks an anchor-local static glyph origin for the
+  // legacy projection path too.
+  @location(11) deltaHigh: vec4<f32>,
+  @location(12) deltaLow: vec4<f32>,
 };
 
 struct VsOut {
@@ -107,6 +126,17 @@ struct VsOut {
   @location(1) color: vec4<f32>,
 };
 
+fn rteClipPosition(
+  local: vec3<f32>, high: vec3<f32>, low: vec3<f32>, viewProj: mat4x4<f32>,
+) -> vec4<f32> {
+  // Do not first reconstruct a million-metre f32 position: that addition can
+  // discard centimetre local lanes before projection. Transform high and the
+  // combined local/low term independently, then combine in clip space where projection has
+  // reduced or cancelled the coordinate scale. A final raw f32 eye vector
+  // still cannot represent a sub-ULP residual at the ±1,000,000 m boundary.
+  return viewProj * vec4<f32>(high, 1.0) + viewProj * vec4<f32>(local + low, 0.0);
+}
+
 @vertex
 fn vs_main(in: VsIn, inst: InstIn) -> VsOut {
   // Map corner index to (u, v) in [0, 1] — the four quad corners.
@@ -121,9 +151,21 @@ fn vs_main(in: VsIn, inst: InstIn) -> VsOut {
   // regardless of view angle, so screen-space scaling stays correct in
   // top-down / ground / oblique views.
   let isBillboard = inst.billboard > 0.5;
+  let isRte = inst.deltaHigh.w == 1.0;
+  let hasLocalOrigin = inst.deltaLow.w == 1.0;
+  // The f64 CPU path has already formed the drawable-camera delta. Project
+  // split terms independently so projection can retain low residuals.
   let scaleProbeAxis = select(vec3<f32>(0.0, 1.0, 0.0), camera.cameraUp.xyz, isBillboard);
-  let aClip = camera.viewProj * vec4<f32>(inst.anchor, 1.0);
-  let bClip = camera.viewProj * vec4<f32>(inst.anchor + scaleProbeAxis, 1.0);
+  let aClip = select(
+    camera.viewProj * vec4<f32>(inst.anchor, 1.0),
+    rteClipPosition(vec3<f32>(0.0), inst.deltaHigh.xyz, inst.deltaLow.xyz, camera.rteViewProj),
+    isRte,
+  );
+  let bClip = select(
+    camera.viewProj * vec4<f32>(inst.anchor + scaleProbeAxis, 1.0),
+    rteClipPosition(scaleProbeAxis, inst.deltaHigh.xyz, inst.deltaLow.xyz, camera.rteViewProj),
+    isRte,
+  );
   let aNdc = aClip.xy / max(abs(aClip.w), 1e-4);
   let bNdc = bClip.xy / max(abs(bClip.w), 1e-4);
   let unitYPx = length(bNdc - aNdc) * camera.viewportAndTarget.y * 0.5;
@@ -145,10 +187,11 @@ fn vs_main(in: VsIn, inst: InstIn) -> VsOut {
   // Non-billboard: authored axes (text lies in the floor plane of its
   // annotation — IFC convention). Billboard: camera-aligned axes (text
   // always faces the camera — grid-tag convention).
-  let authoredLocalOffset = inst.origin - inst.anchor;
-  let authoredWorldPos =
-      inst.anchor
-    + authoredLocalOffset * scale
+  // Anchored producers retain a small glyph-local origin; legacy producers
+  // retain the original absolute origin and derive its local offset here.
+  let authoredLocalOffset = select(inst.origin - inst.anchor, inst.origin, hasLocalOrigin);
+  let authoredLocalPos =
+      authoredLocalOffset * scale
     + inst.rightAxis * scale * u
     + inst.upAxis    * scale * v;
 
@@ -160,20 +203,24 @@ fn vs_main(in: VsIn, inst: InstIn) -> VsOut {
   let bbOffsetY = inst.glyphOffsetSize.y;
   let bbWidth   = inst.glyphOffsetSize.z;
   let bbHeight  = inst.glyphOffsetSize.w;
-  let billboardWorldPos =
-      inst.anchor
-    + (camera.cameraRight.xyz * bbOffsetX + camera.cameraUp.xyz * bbOffsetY) * scale
+  let billboardLocalPos =
+      (camera.cameraRight.xyz * bbOffsetX + camera.cameraUp.xyz * bbOffsetY) * scale
     + (camera.cameraRight.xyz * bbWidth   * u
      + camera.cameraUp.xyz    * bbHeight  * v) * scale;
 
-  let worldPos = select(authoredWorldPos, billboardWorldPos, isBillboard);
+  let glyphLocalPos = select(authoredLocalPos, billboardLocalPos, isBillboard);
+  let worldPos = inst.anchor + glyphLocalPos;
 
   // UV: lerp atlas bounds. Note v inverted (atlas top is v=0).
   let uMix = mix(inst.uvBounds.x, inst.uvBounds.z, u);
   let vMix = mix(inst.uvBounds.w, inst.uvBounds.y, v);
 
   var out: VsOut;
-  let clip = camera.viewProj * vec4<f32>(worldPos, 1.0);
+  let clip = select(
+    camera.viewProj * vec4<f32>(worldPos, 1.0),
+    rteClipPosition(glyphLocalPos, inst.deltaHigh.xyz, inst.deltaLow.xyz, camera.rteViewProj),
+    isRte,
+  );
   // Reverse-Z decal nudge for text coplanar with model faces (issue #812
   // follow-up: "30", "1.49" etc. flickering against the terrain). The
   // pipeline-level depthBiasSlopeScale collapses to ~0 for billboard
@@ -188,14 +235,38 @@ fn vs_main(in: VsIn, inst: InstIn) -> VsOut {
   return out;
 }
 
+// Halo (#5388): labels sit over model geometry as often as over the empty
+// backdrop, so no single ink is legible on both. Every glyph gets a thin
+// contrasting outline: the glyph coverage dilated by HALO_TEXELS, drawn under
+// the glyph in black (light text) or white (dark text). The quad and its UVs
+// were widened by the same margin on upload, and the atlas packs glyphs far
+// enough apart that the taps never reach a neighbour.
+const HALO_TEXELS: f32 = ${GLYPH_HALO_PX}.0;
+const HALO_OPACITY: f32 = 0.8;
+const HALO_DIRS = array<vec2<f32>, 8>(
+  vec2<f32>(1.0, 0.0), vec2<f32>(-1.0, 0.0), vec2<f32>(0.0, 1.0), vec2<f32>(0.0, -1.0),
+  vec2<f32>(0.7071, 0.7071), vec2<f32>(-0.7071, 0.7071), vec2<f32>(0.7071, -0.7071), vec2<f32>(-0.7071, -0.7071),
+);
+
 @fragment
 fn fs_main(in: VsOut) -> @location(0) vec4<f32> {
-  let atlas = textureSample(atlasTex, atlasSamp, in.uv);
   // The atlas was rasterised with white glyphs on a transparent background,
-  // so atlas.r is the coverage and atlas.a is the alpha. Multiply by the
-  // per-glyph tint and premultiply for the standard composite.
-  let alpha = atlas.a * in.color.a;
-  return vec4<f32>(in.color.rgb * alpha, alpha);
+  // so atlas.a is the coverage.
+  let coverage = textureSample(atlasTex, atlasSamp, in.uv).a;
+  let texel = 1.0 / vec2<f32>(textureDimensions(atlasTex));
+  var dilated = coverage;
+  // Two rings (full and half radius) so thin strokes and counters fill in.
+  for (var i = 0u; i < 8u; i = i + 1u) {
+    let d = HALO_DIRS[i] * texel * HALO_TEXELS;
+    dilated = max(dilated, textureSample(atlasTex, atlasSamp, in.uv + d).a);
+    dilated = max(dilated, textureSample(atlasTex, atlasSamp, in.uv + d * 0.5).a);
+  }
+  let luminance = dot(in.color.rgb, vec3<f32>(0.2126, 0.7152, 0.0722));
+  let haloRgb = select(vec3<f32>(1.0), vec3<f32>(0.0), luminance > 0.5);
+  // Glyph over halo, premultiplied for the standard composite.
+  let glyphA = coverage * in.color.a;
+  let haloA = dilated * HALO_OPACITY * in.color.a * (1.0 - glyphA);
+  return vec4<f32>(in.color.rgb * glyphA + haloRgb * haloA, glyphA + haloA);
 }
 `;
 //# sourceMappingURL=symbolic-overlay.wgsl.js.map

package/dist/shaders/symbolic-overlay.wgsl.js.map

@@ -1 +1 @@
-{"version":3,"file":"symbolic-overlay.wgsl.js","sourceRoot":"","sources":["../../src/shaders/symbolic-overlay.wgsl.ts"],"names":[],"mappings":"AAAA;;+DAE+D;AAE/D;;;;;;GAMG;AAEH,MAAM,CAAC,MAAM,kBAAkB,GAAG,UAAU,CAAC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CA+B5C,CAAC;AAEF,MAAM,CAAC,MAAM,kBAAkB,GAAG,UAAU,CAAC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CA6J5C,CAAC"}
+{"version":3,"file":"symbolic-overlay.wgsl.js","sourceRoot":"","sources":["../../src/shaders/symbolic-overlay.wgsl.ts"],"names":[],"mappings":"AAAA;;+DAE+D;AAE/D;;;;;;GAMG;AAEH,OAAO,EAAE,aAAa,EAAE,MAAM,2BAA2B,CAAC;AAE1D,MAAM,CAAC,MAAM,kBAAkB,GAAG,UAAU,CAAC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAoC5C,CAAC;AAEF,MAAM,CAAC,MAAM,kBAAkB,GAAG,UAAU,CAAC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;2BAmMlB,aAAa;;;;;;;;;;;;;;;;;;;;;;;;;;;CA2BvC,CAAC"}

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

@@ -1 +1 @@
-{"version":3,"file":"textured.wgsl.d.ts","sourceRoot":"","sources":["../../src/shaders/textured.wgsl.ts"],"names":[],"mappings":"AAuGA,eAAO,MAAM,oBAAoB,QAAyB,CAAC"}
+{"version":3,"file":"textured.wgsl.d.ts","sourceRoot":"","sources":["../../src/shaders/textured.wgsl.ts"],"names":[],"mappings":"AAyGA,eAAO,MAAM,oBAAoB,QAAyB,CAAC"}

package/dist/shaders/textured.wgsl.js

@@ -36,17 +36,19 @@ function deriveTexturedShader() {
     s = replaceOnce(s, '@binding(0) @group(0) var<uniform> uniforms: Uniforms;', '@binding(0) @group(0) var<uniform> uniforms: Uniforms;\n' +
         '        @binding(1) @group(0) var albedoTex: texture_2d<f32>;\n' +
         '        @binding(2) @group(0) var albedoSampler: sampler;', 'uniform binding');
-    // 2. UV vertex attribute on VertexInput. Placed at @location(10), NOT 3-9:
+    // 2. UV vertex attribute on VertexInput. Placed at @location(12), NOT 3-11:
     //    main.wgsl also declares vs_instanced + InstanceInput at vertex-input
-    //    @location 3..9 (mat4 3-6, entityId 7, colour 8, selected flag 9), which
+    //    @location 3..11 (mat4 3-6, entityId 7, colour 8, selected flag 9,
+    //    RTE anchor high/low 10-11), which
     //    this derived module still contains (unused by the textured pipeline). A uv
-    //    in 3..9 would collide with InstanceInput in vs_instanced's input interface
-    //    = a shader-creation error. @10 is clear of both the per-vertex inputs
-    //    (0..2) and the per-instance inputs (3..9). The textured pipeline's slot-0
-    //    uv attribute uses shaderLocation 10 to match.
-    s = replaceOnce(s, '          @location(2) entityId: u32,\n        }\n\n        struct VertexOutput {', '          @location(2) entityId: u32,\n          @location(10) uv: vec2<f32>,\n        }\n\n        struct VertexOutput {', 'VertexInput uv');
-    // 3. UV interpolant on VertexOutput (after the @location(5) instSelected varying).
-    s = replaceOnce(s, '          @location(5) @interpolate(flat) instSelected: u32,\n        }', '          @location(5) @interpolate(flat) instSelected: u32,\n          @location(6) uv: vec2<f32>,\n        }', 'VertexOutput uv');
+    //    in 3..11 would collide with InstanceInput in vs_instanced's input interface
+    //    = a shader-creation error. @12 is clear of both the per-vertex inputs
+    //    (0..2) and the per-instance inputs (3..11). The textured pipeline's slot-0
+    //    uv attribute uses shaderLocation 12 to match.
+    s = replaceOnce(s, '          @location(2) entityId: u32,\n        }\n\n        struct VertexOutput {', '          @location(2) entityId: u32,\n          @location(12) uv: vec2<f32>,\n        }\n\n        struct VertexOutput {', 'VertexInput uv');
+    // 3. UV interpolant on VertexOutput. Location 6 is the main shader's
+    // camera-relative fragment position (#5049), so texture UVs stay at 7.
+    s = replaceOnce(s, '          @location(6) eyePos: vec3<f32>,\n        }', '          @location(6) eyePos: vec3<f32>,\n          @location(7) uv: vec2<f32>,\n        }', 'VertexOutput uv');
     // 4. Pass UV through the vertex shader.
     s = replaceOnce(s, '          output.entityId = input.entityId;', '          output.entityId = input.entityId;\n          output.uv = input.uv;', 'vs_main uv passthrough');
     // 5. Sample the texture; multiply by the authored tint (white = passthrough).

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

@@ -1 +1 @@
-{"version":3,"file":"textured.wgsl.js","sourceRoot":"","sources":["../../src/shaders/textured.wgsl.ts"],"names":[],"mappings":"AAAA;;+DAE+D;AAE/D;;;;;;;;;;;;;;;;;GAiBG;AACH,OAAO,EAAE,gBAAgB,EAAE,MAAM,gBAAgB,CAAC;AAElD,SAAS,WAAW,CAAC,GAAW,EAAE,IAAY,EAAE,IAAY,EAAE,KAAa;IACzE,MAAM,GAAG,GAAG,GAAG,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC;IAC9B,IAAI,GAAG,KAAK,CAAC,CAAC,EAAE,CAAC;QACf,MAAM,IAAI,KAAK,CACb,0BAA0B,KAAK,4EAA4E,CAC5G,CAAC;IACJ,CAAC;IACD,IAAI,GAAG,CAAC,OAAO,CAAC,IAAI,EAAE,GAAG,GAAG,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC;QAChD,MAAM,IAAI,KAAK,CAAC,0BAA0B,KAAK,2CAA2C,CAAC,CAAC;IAC9F,CAAC;IACD,OAAO,GAAG,CAAC,KAAK,CAAC,CAAC,EAAE,GAAG,CAAC,GAAG,IAAI,GAAG,GAAG,CAAC,KAAK,CAAC,GAAG,GAAG,IAAI,CAAC,MAAM,CAAC,CAAC;AACjE,CAAC;AAED,SAAS,oBAAoB;IAC3B,IAAI,CAAC,GAAG,gBAAgB,CAAC;IAEzB,uEAAuE;IACvE,CAAC,GAAG,WAAW,CACb,CAAC,EACD,wDAAwD,EACxD,0DAA0D;QACxD,iEAAiE;QACjE,2DAA2D,EAC7D,iBAAiB,CAClB,CAAC;IAEF,2EAA2E;IAC3E,0EAA0E;IAC1E,6EAA6E;IAC7E,gFAAgF;IAChF,gFAAgF;IAChF,2EAA2E;IAC3E,+EAA+E;IAC/E,mDAAmD;IACnD,CAAC,GAAG,WAAW,CACb,CAAC,EACD,mFAAmF,EACnF,2HAA2H,EAC3H,gBAAgB,CACjB,CAAC;IAEF,mFAAmF;IACnF,CAAC,GAAG,WAAW,CACb,CAAC,EACD,yEAAyE,EACzE,gHAAgH,EAChH,iBAAiB,CAClB,CAAC;IAEF,wCAAwC;IACxC,CAAC,GAAG,WAAW,CACb,CAAC,EACD,6CAA6C,EAC7C,8EAA8E,EAC9E,wBAAwB,CACzB,CAAC;IAEF,8EAA8E;IAC9E,6EAA6E;IAC7E,+EAA+E;IAC/E,yEAAyE;IACzE,2EAA2E;IAC3E,mDAAmD;IACnD,yEAAyE;IACzE,+EAA+E;IAC/E,6EAA6E;IAC7E,8DAA8D;IAC9D,CAAC,GAAG,WAAW,CACb,CAAC,EACD,kCAAkC,EAClC,wEAAwE;QACtE,qDAAqD;QACrD,8DAA8D,EAChE,eAAe,CAChB,CAAC;IAEF,OAAO,CAAC,CAAC;AACX,CAAC;AAED,MAAM,CAAC,MAAM,oBAAoB,GAAG,oBAAoB,EAAE,CAAC"}
+{"version":3,"file":"textured.wgsl.js","sourceRoot":"","sources":["../../src/shaders/textured.wgsl.ts"],"names":[],"mappings":"AAAA;;+DAE+D;AAE/D;;;;;;;;;;;;;;;;;GAiBG;AACH,OAAO,EAAE,gBAAgB,EAAE,MAAM,gBAAgB,CAAC;AAElD,SAAS,WAAW,CAAC,GAAW,EAAE,IAAY,EAAE,IAAY,EAAE,KAAa;IACzE,MAAM,GAAG,GAAG,GAAG,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC;IAC9B,IAAI,GAAG,KAAK,CAAC,CAAC,EAAE,CAAC;QACf,MAAM,IAAI,KAAK,CACb,0BAA0B,KAAK,4EAA4E,CAC5G,CAAC;IACJ,CAAC;IACD,IAAI,GAAG,CAAC,OAAO,CAAC,IAAI,EAAE,GAAG,GAAG,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC;QAChD,MAAM,IAAI,KAAK,CAAC,0BAA0B,KAAK,2CAA2C,CAAC,CAAC;IAC9F,CAAC;IACD,OAAO,GAAG,CAAC,KAAK,CAAC,CAAC,EAAE,GAAG,CAAC,GAAG,IAAI,GAAG,GAAG,CAAC,KAAK,CAAC,GAAG,GAAG,IAAI,CAAC,MAAM,CAAC,CAAC;AACjE,CAAC;AAED,SAAS,oBAAoB;IAC3B,IAAI,CAAC,GAAG,gBAAgB,CAAC;IAEzB,uEAAuE;IACvE,CAAC,GAAG,WAAW,CACb,CAAC,EACD,wDAAwD,EACxD,0DAA0D;QACxD,iEAAiE;QACjE,2DAA2D,EAC7D,iBAAiB,CAClB,CAAC;IAEF,4EAA4E;IAC5E,0EAA0E;IAC1E,uEAAuE;IACvE,uCAAuC;IACvC,gFAAgF;IAChF,iFAAiF;IACjF,2EAA2E;IAC3E,gFAAgF;IAChF,mDAAmD;IACnD,CAAC,GAAG,WAAW,CACb,CAAC,EACD,mFAAmF,EACnF,2HAA2H,EAC3H,gBAAgB,CACjB,CAAC;IAEF,qEAAqE;IACrE,uEAAuE;IACvE,CAAC,GAAG,WAAW,CACb,CAAC,EACD,sDAAsD,EACtD,6FAA6F,EAC7F,iBAAiB,CAClB,CAAC;IAEF,wCAAwC;IACxC,CAAC,GAAG,WAAW,CACb,CAAC,EACD,6CAA6C,EAC7C,8EAA8E,EAC9E,wBAAwB,CACzB,CAAC;IAEF,8EAA8E;IAC9E,6EAA6E;IAC7E,+EAA+E;IAC/E,yEAAyE;IACzE,2EAA2E;IAC3E,mDAAmD;IACnD,yEAAyE;IACzE,+EAA+E;IAC/E,6EAA6E;IAC7E,8DAA8D;IAC9D,CAAC,GAAG,WAAW,CACb,CAAC,EACD,kCAAkC,EAClC,wEAAwE;QACtE,qDAAqD;QACrD,8DAA8D,EAChE,eAAe,CAChB,CAAC;IAEF,OAAO,CAAC,CAAC;AACX,CAAC;AAED,MAAM,CAAC,MAAM,oBAAoB,GAAG,oBAAoB,EAAE,CAAC"}

package/dist/shadow-light-matrix.d.ts

@@ -60,6 +60,13 @@ export interface SunLightFit {
     /** Near→far depth span along the sun axis, world units. */
     depthRange: number;
 }
+/** A coarse site-wide map must not lift receivers beyond local BIM geometry. */
+export declare const MAX_SHADOW_NORMAL_BIAS_METRES = 0.25;
+/**
+ * Scales normal bias with the shadow-map texel at ordinary resolutions while
+ * bounding the coarse whole-site fallback in real-world metres.
+ */
+export declare function resolveShadowNormalBiasMetres(texelWorld: number, pcfRadius: number): number;
 /**
  * Fit the sun's orthographic shadow frustum. Pure; see the file header for the
  * fitting policy. The returned matrix maps world space straight to the shadow

package/dist/shadow-light-matrix.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"shadow-light-matrix.d.ts","sourceRoot":"","sources":["../src/shadow-light-matrix.ts"],"names":[],"mappings":"AAIA;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AAEH,OAAO,KAAK,EAAE,IAAI,EAAE,IAAI,EAAE,MAAM,YAAY,CAAC;AAG7C,MAAM,WAAW,iBAAiB;IAChC;;;;OAIG;IACH,YAAY,EAAE,SAAS,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,CAAC;IAChD,yCAAyC;IACzC,SAAS,EAAE,SAAS,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,CAAC;IAC7C,yCAAyC;IACzC,SAAS,EAAE,SAAS,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,CAAC;IAC7C;;;;OAIG;IACH,YAAY,CAAC,EAAE,SAAS,IAAI,EAAE,CAAC;IAC/B;;;;OAIG;IACH,cAAc,CAAC,EAAE,MAAM,CAAC;CACzB;AAED,MAAM,WAAW,WAAW;IAC1B,2EAA2E;IAC3E,aAAa,EAAE,IAAI,CAAC;IACpB,+DAA+D;IAC/D,SAAS,EAAE,IAAI,CAAC;IAChB,8DAA8D;IAC9D,cAAc,EAAE,MAAM,CAAC;IACvB,+DAA+D;IAC/D,eAAe,EAAE,MAAM,CAAC;IACxB,2DAA2D;IAC3D,UAAU,EAAE,MAAM,CAAC;CACpB;AAwCD;;;;;GAKG;AACH,wBAAgB,iBAAiB,CAAC,MAAM,EAAE,iBAAiB,GAAG,WAAW,CA0FxE;AAED,MAAM,WAAW,mBAAmB;IAClC,0BAA0B;IAC1B,GAAG,EAAE,IAAI,CAAC;IACV,0CAA0C;IAC1C,OAAO,EAAE,IAAI,CAAC;IACd,yBAAyB;IACzB,KAAK,EAAE,IAAI,CAAC;IACZ,sBAAsB;IACtB,EAAE,EAAE,IAAI,CAAC;IACT,6CAA6C;IAC7C,IAAI,EAAE,MAAM,CAAC;IACb,+BAA+B;IAC/B,MAAM,EAAE,MAAM,CAAC;IACf,yEAAyE;IACzE,KAAK,EAAE,OAAO,CAAC;IACf,sEAAsE;IACtE,eAAe,EAAE,MAAM,CAAC;IACxB,SAAS,EAAE,SAAS,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,CAAC;IAC7C,SAAS,EAAE,SAAS,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,CAAC;IAC7C,2EAA2E;IAC3E,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED;;;;;;;;;;;;GAYG;AACH,wBAAgB,yBAAyB,CAAC,CAAC,EAAE,mBAAmB,GAAG,IAAI,EAAE,GAAG,IAAI,CAoC/E"}
+{"version":3,"file":"shadow-light-matrix.d.ts","sourceRoot":"","sources":["../src/shadow-light-matrix.ts"],"names":[],"mappings":"AAIA;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AAEH,OAAO,KAAK,EAAE,IAAI,EAAE,IAAI,EAAE,MAAM,YAAY,CAAC;AAG7C,MAAM,WAAW,iBAAiB;IAChC;;;;OAIG;IACH,YAAY,EAAE,SAAS,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,CAAC;IAChD,yCAAyC;IACzC,SAAS,EAAE,SAAS,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,CAAC;IAC7C,yCAAyC;IACzC,SAAS,EAAE,SAAS,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,CAAC;IAC7C;;;;OAIG;IACH,YAAY,CAAC,EAAE,SAAS,IAAI,EAAE,CAAC;IAC/B;;;;OAIG;IACH,cAAc,CAAC,EAAE,MAAM,CAAC;CACzB;AAED,MAAM,WAAW,WAAW;IAC1B,2EAA2E;IAC3E,aAAa,EAAE,IAAI,CAAC;IACpB,+DAA+D;IAC/D,SAAS,EAAE,IAAI,CAAC;IAChB,8DAA8D;IAC9D,cAAc,EAAE,MAAM,CAAC;IACvB,+DAA+D;IAC/D,eAAe,EAAE,MAAM,CAAC;IACxB,2DAA2D;IAC3D,UAAU,EAAE,MAAM,CAAC;CACpB;AAID,gFAAgF;AAChF,eAAO,MAAM,6BAA6B,OAAO,CAAC;AAElD;;;GAGG;AACH,wBAAgB,6BAA6B,CAAC,UAAU,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,MAAM,CAG3F;AAsCD;;;;;GAKG;AACH,wBAAgB,iBAAiB,CAAC,MAAM,EAAE,iBAAiB,GAAG,WAAW,CA0FxE;AAED,MAAM,WAAW,mBAAmB;IAClC,0BAA0B;IAC1B,GAAG,EAAE,IAAI,CAAC;IACV,0CAA0C;IAC1C,OAAO,EAAE,IAAI,CAAC;IACd,yBAAyB;IACzB,KAAK,EAAE,IAAI,CAAC;IACZ,sBAAsB;IACtB,EAAE,EAAE,IAAI,CAAC;IACT,6CAA6C;IAC7C,IAAI,EAAE,MAAM,CAAC;IACb,+BAA+B;IAC/B,MAAM,EAAE,MAAM,CAAC;IACf,yEAAyE;IACzE,KAAK,EAAE,OAAO,CAAC;IACf,sEAAsE;IACtE,eAAe,EAAE,MAAM,CAAC;IACxB,SAAS,EAAE,SAAS,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,CAAC;IAC7C,SAAS,EAAE,SAAS,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,CAAC;IAC7C,2EAA2E;IAC3E,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED;;;;;;;;;;;;GAYG;AACH,wBAAgB,yBAAyB,CAAC,CAAC,EAAE,mBAAmB,GAAG,IAAI,EAAE,GAAG,IAAI,CAoC/E"}

package/dist/shadow-light-matrix.js

@@ -3,6 +3,17 @@
  * file, You can obtain one at https://mozilla.org/MPL/2.0/. */
 import { MathUtils } from './math.js';
 const DEFAULT_SUN = { x: 0, y: 1, z: 0 };
+/** A coarse site-wide map must not lift receivers beyond local BIM geometry. */
+export const MAX_SHADOW_NORMAL_BIAS_METRES = 0.25;
+/**
+ * Scales normal bias with the shadow-map texel at ordinary resolutions while
+ * bounding the coarse whole-site fallback in real-world metres.
+ */
+export function resolveShadowNormalBiasMetres(texelWorld, pcfRadius) {
+    if (!Number.isFinite(texelWorld) || !Number.isFinite(pcfRadius))
+        return 0;
+    return Math.min(Math.max(texelWorld, 0) * (2 + Math.max(pcfRadius, 0)), MAX_SHADOW_NORMAL_BIAS_METRES);
+}
 /** Unit sun direction, falling back to straight down-up for unusable input. */
 function resolveSun(dir) {
     const x = dir[0], y = dir[1], z = dir[2];

package/dist/shadow-light-matrix.js.map

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

package/dist/shadow-occluder-batches.d.ts

@@ -0,0 +1,10 @@
+import type { RenderPipeline } from './pipeline.js';
+import type { BatchedMesh, RenderOptions } from './types.js';
+export interface ShadowBatchScene {
+    getBatchedMeshes(): BatchedMesh[];
+    requestBatchResidency(batch: BatchedMesh): void;
+    recordBatchDrawn(batch: BatchedMesh): void;
+    getOrCreatePartialBatch(key: string, colorKey: string, ids: Set<number>, device: GPUDevice, pipeline: RenderPipeline, epoch: number): BatchedMesh | null | undefined;
+}
+export declare function shadowOccluderBatches(scene: ShadowBatchScene, options: RenderOptions, device: GPUDevice, filtered: boolean, pipeline: RenderPipeline | null, epoch: number): BatchedMesh[];
+//# sourceMappingURL=shadow-occluder-batches.d.ts.map

package/dist/shadow-occluder-batches.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"shadow-occluder-batches.d.ts","sourceRoot":"","sources":["../src/shadow-occluder-batches.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,eAAe,CAAC;AAEpD,OAAO,KAAK,EAAE,WAAW,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AAE7D,MAAM,WAAW,gBAAgB;IAC/B,gBAAgB,IAAI,WAAW,EAAE,CAAC;IAClC,qBAAqB,CAAC,KAAK,EAAE,WAAW,GAAG,IAAI,CAAC;IAChD,gBAAgB,CAAC,KAAK,EAAE,WAAW,GAAG,IAAI,CAAC;IAC3C,uBAAuB,CAAC,GAAG,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,EAAE,GAAG,EAAE,GAAG,CAAC,MAAM,CAAC,EAAE,MAAM,EAAE,SAAS,EAAE,QAAQ,EAAE,cAAc,EAAE,KAAK,EAAE,MAAM,GAAG,WAAW,GAAG,IAAI,GAAG,SAAS,CAAC;CACtK;AAKD,wBAAgB,qBAAqB,CAAC,KAAK,EAAE,gBAAgB,EAAE,OAAO,EAAE,aAAa,EAAE,MAAM,EAAE,SAAS,EAAE,QAAQ,EAAE,OAAO,EAAE,QAAQ,EAAE,cAAc,GAAG,IAAI,EAAE,KAAK,EAAE,MAAM,GAAG,WAAW,EAAE,CAc1L"}

package/dist/shadow-occluder-batches.js

@@ -0,0 +1,39 @@
+/* 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/. */
+import { classifyBatchVisibility, DEFAULT_MIN_CAST_ALPHA } from './shadow-occluders.js';
+function noteResidency(scene, batch) {
+    if (batch.color[3] < DEFAULT_MIN_CAST_ALPHA)
+        return;
+    if (batch.gpuResident === false)
+        scene.requestBatchResidency(batch);
+    else
+        scene.recordBatchDrawn(batch);
+}
+export function shadowOccluderBatches(scene, options, device, filtered, pipeline, epoch) {
+    const all = scene.getBatchedMeshes();
+    if (!filtered) {
+        for (const batch of all)
+            noteResidency(scene, batch);
+        return all;
+    }
+    const result = [];
+    for (const batch of all) {
+        const visible = classifyBatchVisibility(batch.expressIds, options.hiddenIds, options.isolatedIds);
+        if (visible.kind === 'none')
+            continue;
+        if (visible.kind === 'all') {
+            noteResidency(scene, batch);
+            result.push(batch);
+            continue;
+        }
+        if (batch.color[3] < DEFAULT_MIN_CAST_ALPHA || !pipeline)
+            continue;
+        noteResidency(scene, batch);
+        const subset = scene.getOrCreatePartialBatch(`${batch.colorKey}:${batch.id}`, batch.colorKey, visible.visibleIds, device, pipeline, epoch);
+        if (subset && subset.indexCount > 0)
+            result.push(subset);
+    }
+    return result;
+}
+//# sourceMappingURL=shadow-occluder-batches.js.map

package/dist/shadow-occluder-batches.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"shadow-occluder-batches.js","sourceRoot":"","sources":["../src/shadow-occluder-batches.ts"],"names":[],"mappings":"AAAA;;+DAE+D;AAG/D,OAAO,EAAE,uBAAuB,EAAE,sBAAsB,EAAE,MAAM,uBAAuB,CAAC;AASxF,SAAS,aAAa,CAAC,KAAuB,EAAE,KAAkB;IAChE,IAAI,KAAK,CAAC,KAAK,CAAC,CAAC,CAAC,GAAG,sBAAsB;QAAE,OAAO;IACpD,IAAI,KAAK,CAAC,WAAW,KAAK,KAAK;QAAE,KAAK,CAAC,qBAAqB,CAAC,KAAK,CAAC,CAAC;;QAAM,KAAK,CAAC,gBAAgB,CAAC,KAAK,CAAC,CAAC;AAC1G,CAAC;AACD,MAAM,UAAU,qBAAqB,CAAC,KAAuB,EAAE,OAAsB,EAAE,MAAiB,EAAE,QAAiB,EAAE,QAA+B,EAAE,KAAa;IACzK,MAAM,GAAG,GAAG,KAAK,CAAC,gBAAgB,EAAE,CAAC;IACrC,IAAI,CAAC,QAAQ,EAAE,CAAC;QAAC,KAAK,MAAM,KAAK,IAAI,GAAG;YAAE,aAAa,CAAC,KAAK,EAAE,KAAK,CAAC,CAAC;QAAC,OAAO,GAAG,CAAC;IAAC,CAAC;IACpF,MAAM,MAAM,GAAkB,EAAE,CAAC;IACjC,KAAK,MAAM,KAAK,IAAI,GAAG,EAAE,CAAC;QACxB,MAAM,OAAO,GAAG,uBAAuB,CAAC,KAAK,CAAC,UAAU,EAAE,OAAO,CAAC,SAAS,EAAE,OAAO,CAAC,WAAW,CAAC,CAAC;QAClG,IAAI,OAAO,CAAC,IAAI,KAAK,MAAM;YAAE,SAAS;QACtC,IAAI,OAAO,CAAC,IAAI,KAAK,KAAK,EAAE,CAAC;YAAC,aAAa,CAAC,KAAK,EAAE,KAAK,CAAC,CAAC;YAAC,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;YAAC,SAAS;QAAC,CAAC;QAC1F,IAAI,KAAK,CAAC,KAAK,CAAC,CAAC,CAAC,GAAG,sBAAsB,IAAI,CAAC,QAAQ;YAAE,SAAS;QACnE,aAAa,CAAC,KAAK,EAAE,KAAK,CAAC,CAAC;QAC5B,MAAM,MAAM,GAAG,KAAK,CAAC,uBAAuB,CAAC,GAAG,KAAK,CAAC,QAAQ,IAAI,KAAK,CAAC,EAAE,EAAE,EAAE,KAAK,CAAC,QAAQ,EAAE,OAAO,CAAC,UAAU,EAAE,MAAM,EAAE,QAAQ,EAAE,KAAK,CAAC,CAAC;QAC3I,IAAI,MAAM,IAAI,MAAM,CAAC,UAAU,GAAG,CAAC;YAAE,MAAM,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;IAC3D,CAAC;IACD,OAAO,MAAM,CAAC;AAChB,CAAC"}

package/dist/shadow-occluders.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"shadow-occluders.d.ts","sourceRoot":"","sources":["../src/shadow-occluders.ts"],"names":[],"mappings":"AAIA;;;;;;;;;;;;;;;;;;GAkBG;AAEH,OAAO,KAAK,EAAE,WAAW,EAAE,IAAI,EAAE,MAAM,YAAY,CAAC;AACpD,OAAO,KAAK,EAAE,oBAAoB,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AACrE,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,kBAAkB,CAAC;AAG3D,qEAAqE;AACrE,MAAM,WAAW,qBAAqB;IACpC,OAAO,EAAE,SAAS,WAAW,EAAE,CAAC;IAChC,SAAS,EAAE,SAAS,oBAAoB,EAAE,CAAC;IAC3C,QAAQ,EAAE,SAAS,YAAY,EAAE,CAAC;IAClC;;;;;OAKG;IACH,MAAM,CAAC,EAAE,SAAS,IAAI,EAAE,CAAC;CAC1B;AAED,oDAAoD;AACpD,MAAM,WAAW,gBAAgB;IAC/B,SAAS,CAAC,EAAE,WAAW,CAAC,MAAM,CAAC,CAAC;IAChC,WAAW,CAAC,EAAE,WAAW,CAAC,MAAM,CAAC,CAAC;CACnC;AAED,iDAAiD;AACjD,MAAM,WAAW,qBAAqB;IACpC;;;;;;;;;OASG;IACH,YAAY,CAAC,EAAE,MAAM,CAAC;CACvB;AAED;;;;GAIG;AACH,eAAO,MAAM,sBAAsB,MAAM,CAAC;AAE1C;;;;;;GAMG;AACH,wBAAgB,iBAAiB,CAC/B,MAAM,EAAE,SAAS,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,GAAG,SAAS,EACrD,GAAG,GAAE,YAAmC,GACvC,YAAY,CASd;AAsBD;;;;;;;;;;;;GAYG;AACH,MAAM,MAAM,oBAAoB,GAC5B;IAAE,IAAI,EAAE,KAAK,CAAA;CAAE,GACf;IAAE,IAAI,EAAE,MAAM,CAAA;CAAE,GAChB;IAAE,IAAI,EAAE,SAAS,CAAC;IAAC,UAAU,EAAE,GAAG,CAAC,MAAM,CAAC,CAAA;CAAE,CAAC;AAEjD,wBAAgB,uBAAuB,CACrC,UAAU,EAAE,SAAS,MAAM,EAAE,EAC7B,SAAS,EAAE,WAAW,CAAC,MAAM,CAAC,GAAG,IAAI,GAAG,SAAS,EACjD,WAAW,EAAE,WAAW,CAAC,MAAM,CAAC,GAAG,IAAI,GAAG,SAAS,GAClD,oBAAoB,CAYtB;AAED;;;;;;;;;;;;;GAaG;AACH,wBAAgB,sBAAsB,CACpC,OAAO,EAAE,qBAAqB,EAC9B,UAAU,CAAC,EAAE,gBAAgB,EAC7B,OAAO,CAAC,EAAE,qBAAqB,GAC9B,kBAAkB,EAAE,CAgEtB"}
+{"version":3,"file":"shadow-occluders.d.ts","sourceRoot":"","sources":["../src/shadow-occluders.ts"],"names":[],"mappings":"AAIA;;;;;;;;;;;;;;;;;;GAkBG;AAEH,OAAO,KAAK,EAAE,WAAW,EAAE,IAAI,EAAE,MAAM,YAAY,CAAC;AACpD,OAAO,KAAK,EAAE,oBAAoB,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AACrE,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,kBAAkB,CAAC;AAG3D,qEAAqE;AACrE,MAAM,WAAW,qBAAqB;IACpC,OAAO,EAAE,SAAS,WAAW,EAAE,CAAC;IAChC,SAAS,EAAE,SAAS,oBAAoB,EAAE,CAAC;IAC3C,QAAQ,EAAE,SAAS,YAAY,EAAE,CAAC;IAClC;;;;;OAKG;IACH,MAAM,CAAC,EAAE,SAAS,IAAI,EAAE,CAAC;CAC1B;AAED,oDAAoD;AACpD,MAAM,WAAW,gBAAgB;IAC/B,SAAS,CAAC,EAAE,WAAW,CAAC,MAAM,CAAC,CAAC;IAChC,WAAW,CAAC,EAAE,WAAW,CAAC,MAAM,CAAC,CAAC;CACnC;AAED,iDAAiD;AACjD,MAAM,WAAW,qBAAqB;IACpC;;;;;;;;;OASG;IACH,YAAY,CAAC,EAAE,MAAM,CAAC;CACvB;AAED;;;;GAIG;AACH,eAAO,MAAM,sBAAsB,MAAM,CAAC;AAE1C;;;;;;GAMG;AACH,wBAAgB,iBAAiB,CAC/B,MAAM,EAAE,SAAS,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,GAAG,SAAS,EACrD,GAAG,GAAE,YAAmC,GACvC,YAAY,CASd;AAsBD;;;;;;;;;;;;GAYG;AACH,MAAM,MAAM,oBAAoB,GAC5B;IAAE,IAAI,EAAE,KAAK,CAAA;CAAE,GACf;IAAE,IAAI,EAAE,MAAM,CAAA;CAAE,GAChB;IAAE,IAAI,EAAE,SAAS,CAAC;IAAC,UAAU,EAAE,GAAG,CAAC,MAAM,CAAC,CAAA;CAAE,CAAC;AAEjD,wBAAgB,uBAAuB,CACrC,UAAU,EAAE,SAAS,MAAM,EAAE,EAC7B,SAAS,EAAE,WAAW,CAAC,MAAM,CAAC,GAAG,IAAI,GAAG,SAAS,EACjD,WAAW,EAAE,WAAW,CAAC,MAAM,CAAC,GAAG,IAAI,GAAG,SAAS,GAClD,oBAAoB,CAYtB;AAED;;;;;;;;;;;;;GAaG;AACH,wBAAgB,sBAAsB,CACpC,OAAO,EAAE,qBAAqB,EAC9B,UAAU,CAAC,EAAE,gBAAgB,EAC7B,OAAO,CAAC,EAAE,qBAAqB,GAC9B,kBAAkB,EAAE,CAoEtB"}