@pascal-app/viewer 1.0.6 → 1.1.0

package/dist/lib/pointer-events.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"pointer-events.d.ts","sourceRoot":"","sources":["../../src/lib/pointer-events.ts"],"names":[],"mappings":"AA8BA,OAAO,EACL,MAAM,IAAI,eAAe,EAGzB,KAAK,YAAY,EAMjB,KAAK,SAAS,EAEf,MAAM,oBAAoB,CAAA;AAC3B,OAAO,KAAK,KAAK,MAAM,OAAO,CAAA;AAI9B,+FAA+F;AAC/F,MAAM,MAAM,gBAAgB,GAAG;IAC7B,QAAQ,EAAE,MAAM,CAAA;IAChB,OAAO,EAAE,MAAM,CAAA;IACf,KAAK,EAAE,MAAM,GAAG,SAAS,CAAA;IACzB,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;CAC/B,CAAA;AAED,MAAM,MAAM,uBAAuB,GAAG,CAAC,UAAU,EAAE,gBAAgB,KAAK,IAAI,CAAA;AAmC5E,0GAA0G;AAC1G,wBAAgB,eAAe,CAAC,CAAC,SAAS,KAAK,CAAC,QAAQ,CAAC,SAAS,CAAC,EAAE,OAAO,EAAE,CAAC,GAAG,CAAC,CAGlF;AAYD,wBAAgB,mBAAmB,CACjC,MAAM,SAA8D,EACpE,YAAY,CAAC,EAAE,uBAAuB,GACrC,OAAO,eAAe,CAIxB;AAiED;;;;;;;GAOG;AACH,wBAAgB,qBAAqB,CACnC,MAAM,EAAE,KAAK,CAAC,QAAQ,EACtB,QAAQ,GAAE,KAAK,CAAC,QAAQ,GAAG,KAAK,CAAC,QAAQ,EAAE,GAAG,SAA2C,GACxF,OAAO,CAST;AAMD,KAAK,mBAAmB,GAAG,CAAC,MAAM,EAAE,KAAK,CAAC,QAAQ,KAAK,IAAI,CAAA;AAmC3D;;;GAGG;AACH,wBAAgB,iBAAiB,CAC/B,SAAS,EAAE,KAAK,CAAC,SAAS,EAC1B,MAAM,EAAE,KAAK,CAAC,QAAQ,EACtB,IAAI,EAAE,mBAAmB,GACxB,KAAK,CAAC,YAAY,EAAE,CAiBtB;AA+GD,wBAAgB,yBAAyB,CACvC,KAAK,EAAE,SAAS,EAChB,YAAY,CAAC,EAAE,uBAAuB,GACrC,YAAY,CAAC,WAAW,CAAC,CAmB3B"}
+{"version":3,"file":"pointer-events.d.ts","sourceRoot":"","sources":["../../src/lib/pointer-events.ts"],"names":[],"mappings":"AAmCA,OAAO,EACL,MAAM,IAAI,eAAe,EAGzB,KAAK,YAAY,EAMjB,KAAK,SAAS,EAEf,MAAM,oBAAoB,CAAA;AAC3B,OAAO,KAAK,KAAK,MAAM,OAAO,CAAA;AAI9B,+FAA+F;AAC/F,MAAM,MAAM,gBAAgB,GAAG;IAC7B,QAAQ,EAAE,MAAM,CAAA;IAChB,OAAO,EAAE,MAAM,CAAA;IACf,KAAK,EAAE,MAAM,GAAG,SAAS,CAAA;IACzB,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;CAC/B,CAAA;AAED,MAAM,MAAM,uBAAuB,GAAG,CAAC,UAAU,EAAE,gBAAgB,KAAK,IAAI,CAAA;AAmC5E,0GAA0G;AAC1G,wBAAgB,eAAe,CAAC,CAAC,SAAS,KAAK,CAAC,QAAQ,CAAC,SAAS,CAAC,EAAE,OAAO,EAAE,CAAC,GAAG,CAAC,CAGlF;AAYD,wBAAgB,mBAAmB,CACjC,MAAM,SAA8D,EACpE,YAAY,CAAC,EAAE,uBAAuB,GACrC,OAAO,eAAe,CAIxB;AAiED;;;;;;;GAOG;AACH,wBAAgB,qBAAqB,CACnC,MAAM,EAAE,KAAK,CAAC,QAAQ,EACtB,QAAQ,GAAE,KAAK,CAAC,QAAQ,GAAG,KAAK,CAAC,QAAQ,EAAE,GAAG,SAA2C,GACxF,OAAO,CAST;AAMD,KAAK,mBAAmB,GAAG,CAAC,MAAM,EAAE,KAAK,CAAC,QAAQ,KAAK,IAAI,CAAA;AAmC3D;;;GAGG;AACH,wBAAgB,iBAAiB,CAC/B,SAAS,EAAE,KAAK,CAAC,SAAS,EAC1B,MAAM,EAAE,KAAK,CAAC,QAAQ,EACtB,IAAI,EAAE,mBAAmB,GACxB,KAAK,CAAC,YAAY,EAAE,CAiBtB;AA+GD,wBAAgB,yBAAyB,CACvC,KAAK,EAAE,SAAS,EAChB,YAAY,CAAC,EAAE,uBAAuB,GACrC,YAAY,CAAC,WAAW,CAAC,CAmB3B"}

package/dist/lib/pointer-events.js

@@ -26,7 +26,7 @@
  * Ray collection is cached; camera-drag moves are throttled before stock dispatch.
  * The throttle is a vendored-manager policy; dev ?stockEvents uses untouched R3F.
  */
-import { sceneRegistry, useScene } from '@pascal-app/core';
+import { isDevelopmentBuild, isDevelopmentOutsideTests, sceneRegistry, useScene, } from '@pascal-app/core';
 import { events as createWebEvents, getRootState, } from '@react-three/fiber';
 import * as THREE from 'three';
 import { acceleratedRaycast } from 'three-mesh-bvh';
@@ -63,7 +63,7 @@ function isSupportedRaycast(raycast) {
         raycast[pureRaycast] === true);
 }
 export function choosePointerEvents(search = typeof window !== 'undefined' ? window.location.search : '', onBreadcrumb) {
-    return process.env.NODE_ENV !== 'production' && new URLSearchParams(search).has('stockEvents')
+    return isDevelopmentBuild() && new URLSearchParams(search).has('stockEvents')
         ? createWebEvents
         : (store) => createPascalPointerEvents(store, onBreadcrumb);
 }
@@ -443,7 +443,7 @@ function createEvents(store, onBreadcrumb) {
                         stats.fallbackEvents++;
                         stats.lastFallbackReason = reason;
                         if (unsupported &&
-                            process.env.NODE_ENV === 'development' &&
+                            isDevelopmentOutsideTests() &&
                             !warnedRaycastNames.has(reason.fnName)) {
                             warnedRaycastNames.add(reason.fnName);
                             console.warn(`[pointer-events] Stock fallback for raycast "${reason.fnName}" on ${reason.objectType} "${reason.objectName}". Use markPureRaycast only after verifying it appends hits without reading prior hits or mutating scene/query state.`);

package/dist/lib/post-processing-resources.d.ts

@@ -3,6 +3,10 @@ import type { LayerPassIndex } from './layer-pass';
 export declare class PostProcessingResources {
     layerIndex: LayerPassIndex | null;
     readonly passes: PassNode[];
+    /** Effect nodes (AO, temporal AA, bloom) owning render targets. */
+    readonly effects: Array<{
+        dispose(): void;
+    }>;
     outline: {
         dispose(): void;
     } | null;

package/dist/lib/post-processing-resources.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"post-processing-resources.d.ts","sourceRoot":"","sources":["../../src/lib/post-processing-resources.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAE,cAAc,EAAE,MAAM,cAAc,CAAA;AAC5D,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,cAAc,CAAA;AAIlD,qBAAa,uBAAuB;IAClC,UAAU,EAAE,cAAc,GAAG,IAAI,CAAO;IACxC,QAAQ,CAAC,MAAM,EAAE,QAAQ,EAAE,CAAK;IAChC,OAAO,EAAE;QAAE,OAAO,IAAI,IAAI,CAAA;KAAE,GAAG,IAAI,CAAO;IAC1C,QAAQ,EAAE,cAAc,GAAG,IAAI,CAAO;IAEtC,OAAO,SASN;CACF"}
+{"version":3,"file":"post-processing-resources.d.ts","sourceRoot":"","sources":["../../src/lib/post-processing-resources.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAE,cAAc,EAAE,MAAM,cAAc,CAAA;AAC5D,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,cAAc,CAAA;AAIlD,qBAAa,uBAAuB;IAClC,UAAU,EAAE,cAAc,GAAG,IAAI,CAAO;IACxC,QAAQ,CAAC,MAAM,EAAE,QAAQ,EAAE,CAAK;IAChC,mEAAmE;IACnE,QAAQ,CAAC,OAAO,EAAE,KAAK,CAAC;QAAE,OAAO,IAAI,IAAI,CAAA;KAAE,CAAC,CAAK;IACjD,OAAO,EAAE;QAAE,OAAO,IAAI,IAAI,CAAA;KAAE,GAAG,IAAI,CAAO;IAC1C,QAAQ,EAAE,cAAc,GAAG,IAAI,CAAO;IAEtC,OAAO,SAWN;CACF"}

package/dist/lib/post-processing-resources.js

@@ -3,6 +3,8 @@
 export class PostProcessingResources {
     layerIndex = null;
     passes = [];
+    /** Effect nodes (AO, temporal AA, bloom) owning render targets. */
+    effects = [];
     outline = null;
     pipeline = null;
     dispose() {
@@ -11,6 +13,9 @@ export class PostProcessingResources {
         for (const pass of this.passes)
             pass.dispose();
         this.passes.length = 0;
+        for (const effect of this.effects)
+            effect.dispose();
+        this.effects.length = 0;
         this.outline?.dispose();
         this.outline = null;
         this.pipeline?.dispose();

package/dist/lib/readback-rows.d.ts

@@ -0,0 +1,14 @@
+/**
+ * An RGBA8 render-target readback as tightly packed, top-down rows (what
+ * `ImageData` wants). Three shapes come back:
+ * - WebGPU, three before r187: top-down, each row padded to 256 bytes when
+ *   width × 4 isn't already a multiple of 256.
+ * - WebGPU, three r187+: top-down and already tight (three strips the padding).
+ * - WebGL2 fallback (iOS Chrome, etc.): tight but bottom-up (the framebuffer
+ *   convention).
+ * The WebGPU padding is settled by the buffer's exact length, not assumed:
+ * depadding a tight buffer (or reading a padded one tight) walks every row
+ * sideways and shears the frame into horizontal streaks.
+ */
+export declare function readbackRows(pixels: Uint8Array, width: number, height: number, isWebGPU: boolean): Uint8ClampedArray;
+//# sourceMappingURL=readback-rows.d.ts.map

package/dist/lib/readback-rows.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"readback-rows.d.ts","sourceRoot":"","sources":["../../src/lib/readback-rows.ts"],"names":[],"mappings":"AAGA;;;;;;;;;;;GAWG;AACH,wBAAgB,YAAY,CAC1B,MAAM,EAAE,UAAU,EAClB,KAAK,EAAE,MAAM,EACb,MAAM,EAAE,MAAM,EACd,QAAQ,EAAE,OAAO,GAChB,iBAAiB,CAsBnB"}

package/dist/lib/readback-rows.js

@@ -0,0 +1,31 @@
+/** WebGPU's `copyTextureToBuffer` aligns every row to this many bytes. */
+const WEBGPU_ROW_ALIGNMENT = 256;
+/**
+ * An RGBA8 render-target readback as tightly packed, top-down rows (what
+ * `ImageData` wants). Three shapes come back:
+ * - WebGPU, three before r187: top-down, each row padded to 256 bytes when
+ *   width × 4 isn't already a multiple of 256.
+ * - WebGPU, three r187+: top-down and already tight (three strips the padding).
+ * - WebGL2 fallback (iOS Chrome, etc.): tight but bottom-up (the framebuffer
+ *   convention).
+ * The WebGPU padding is settled by the buffer's exact length, not assumed:
+ * depadding a tight buffer (or reading a padded one tight) walks every row
+ * sideways and shears the frame into horizontal streaks.
+ */
+export function readbackRows(pixels, width, height, isWebGPU) {
+    const tightBytesPerRow = width * 4;
+    const tightTotal = tightBytesPerRow * height;
+    const paddedBytesPerRow = Math.ceil(tightBytesPerRow / WEBGPU_ROW_ALIGNMENT) * WEBGPU_ROW_ALIGNMENT;
+    const stride = isWebGPU && pixels.byteLength === paddedBytesPerRow * height
+        ? paddedBytesPerRow
+        : tightBytesPerRow;
+    if (isWebGPU && stride === tightBytesPerRow) {
+        return new Uint8ClampedArray(pixels.buffer, pixels.byteOffset, Math.min(pixels.byteLength, tightTotal));
+    }
+    const rows = new Uint8ClampedArray(tightTotal);
+    for (let row = 0; row < height; row++) {
+        const source = (isWebGPU ? row : height - 1 - row) * stride;
+        rows.set(pixels.subarray(source, source + tightBytesPerRow), row * tightBytesPerRow);
+    }
+    return rows;
+}

package/dist/lib/reveal-pose.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"reveal-pose.d.ts","sourceRoot":"","sources":["../../src/lib/reveal-pose.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,IAAI,EAAsB,KAAK,QAAQ,EAAE,OAAO,EAAE,MAAM,OAAO,CAAA;AACxE,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,eAAe,CAAA;AAwDhD,wBAAgB,aAAa,CAAC,MAAM,EAAE,QAAQ,EAAE,KAAK,EAAE,OAAO,EAAE,KAAK,EAAE,OAAO,EAAE,IAAI,SAAI,GAAG,IAAI,CAU9F;AAED;;;;;GAKG;AACH,wBAAgB,YAAY,CAC1B,MAAM,EAAE,QAAQ,EAChB,IAAI,EAAE,OAAO,EACb,GAAG,EAAE,MAAM,EACX,IAAI,EAAE,MAAM,EACZ,GAAG,SAAI,GACN,IAAI,CAKN;AAED,wBAAgB,eAAe,CAAC,MAAM,EAAE,QAAQ,GAAG,IAAI,CAOtD;AAED,wBAAgB,aAAa,CAAC,MAAM,EAAE,QAAQ,GAAG,OAAO,CAEvD;AAGD,qEAAqE;AACrE,eAAO,MAAM,SAAS,OAAO,CAAA;AAU7B,MAAM,MAAM,gBAAgB,GAAG;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,OAAO,CAAA;CAAE,CAAA;AAE/D,MAAM,MAAM,iBAAiB,GAAG;IAC9B;;;OAGG;IACH,IAAI,CAAC,EAAE,MAAM,CAAA;IACb,6GAA6G;IAC7G,MAAM,CAAC,EAAE,MAAM,CAAA;IACf;;;OAGG;IACH,SAAS,CAAC,EAAE,MAAM,CAAA;CACnB,CAAA;AAKD;;;;;GAKG;AACH,wBAAgB,YAAY,CAC1B,KAAK,EAAE,WAAW,EAClB,CAAC,EAAE,MAAM,EACT,MAAM,EAAE,MAAM,EACd,GAAG,GAAE,gBAAoD,EACzD,OAAO,GAAE,iBAAsB,GAC9B,gBAAgB,CAgDlB;AAED,MAAM,MAAM,iBAAiB,GAAG,gBAAgB,GAAG;IACjD,oFAAoF;IACpF,OAAO,EAAE,MAAM,CAAA;CAChB,CAAA;AAID,eAAO,MAAM,gBAAgB,MAAM,CAAA;AACnC,eAAO,MAAM,gBAAgB,MAAM,CAAA;AAOnC;;;;;;GAMG;AACH,wBAAgB,aAAa,CAC3B,KAAK,EAAE,WAAW,EAClB,CAAC,EAAE,MAAM,EACT,MAAM,EAAE,MAAM,EACd,GAAG,GAAE,iBAAiE,GACrE,iBAAiB,CAmCnB;AAED;;;GAGG;AACH,eAAO,MAAM,cAAc,EAAE,MAAM,CAAC,WAAW,EAAE,MAAM,CAQtD,CAAA;AAED,uFAAuF;AACvF,wBAAgB,eAAe,CAAC,KAAK,EAAE,WAAW,EAAE,CAAC,EAAE,MAAM,GAAG,OAAO,CAGtE;AAKD,2FAA2F;AAC3F,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,QAAQ,EAAE,GAAG,GAAE,IAAiB,GAAG,IAAI,CAgB9E;AAED;;;;;GAKG;AACH,wBAAgB,WAAW,CAAC,GAAG,EAAE,IAAI,EAAE,KAAK,EAAE,WAAW,GAAG,OAAO,CAMlE"}
+{"version":3,"file":"reveal-pose.d.ts","sourceRoot":"","sources":["../../src/lib/reveal-pose.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,IAAI,EAAsB,KAAK,QAAQ,EAAE,OAAO,EAAE,MAAM,OAAO,CAAA;AACxE,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,eAAe,CAAA;AAyDhD,wBAAgB,aAAa,CAAC,MAAM,EAAE,QAAQ,EAAE,KAAK,EAAE,OAAO,EAAE,KAAK,EAAE,OAAO,EAAE,IAAI,SAAI,GAAG,IAAI,CAW9F;AAED;;;;;GAKG;AACH,wBAAgB,YAAY,CAC1B,MAAM,EAAE,QAAQ,EAChB,IAAI,EAAE,OAAO,EACb,GAAG,EAAE,MAAM,EACX,IAAI,EAAE,MAAM,EACZ,GAAG,SAAI,GACN,IAAI,CAKN;AAED,wBAAgB,eAAe,CAAC,MAAM,EAAE,QAAQ,GAAG,IAAI,CAQtD;AAED,wBAAgB,aAAa,CAAC,MAAM,EAAE,QAAQ,GAAG,OAAO,CAEvD;AAGD,qEAAqE;AACrE,eAAO,MAAM,SAAS,OAAO,CAAA;AAU7B,MAAM,MAAM,gBAAgB,GAAG;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,OAAO,CAAA;CAAE,CAAA;AAE/D,MAAM,MAAM,iBAAiB,GAAG;IAC9B;;;OAGG;IACH,IAAI,CAAC,EAAE,MAAM,CAAA;IACb,6GAA6G;IAC7G,MAAM,CAAC,EAAE,MAAM,CAAA;IACf;;;OAGG;IACH,SAAS,CAAC,EAAE,MAAM,CAAA;CACnB,CAAA;AAKD;;;;;GAKG;AACH,wBAAgB,YAAY,CAC1B,KAAK,EAAE,WAAW,EAClB,CAAC,EAAE,MAAM,EACT,MAAM,EAAE,MAAM,EACd,GAAG,GAAE,gBAAoD,EACzD,OAAO,GAAE,iBAAsB,GAC9B,gBAAgB,CAgDlB;AAED,MAAM,MAAM,iBAAiB,GAAG,gBAAgB,GAAG;IACjD,oFAAoF;IACpF,OAAO,EAAE,MAAM,CAAA;CAChB,CAAA;AAID,eAAO,MAAM,gBAAgB,MAAM,CAAA;AACnC,eAAO,MAAM,gBAAgB,MAAM,CAAA;AAOnC;;;;;;GAMG;AACH,wBAAgB,aAAa,CAC3B,KAAK,EAAE,WAAW,EAClB,CAAC,EAAE,MAAM,EACT,MAAM,EAAE,MAAM,EACd,GAAG,GAAE,iBAAiE,GACrE,iBAAiB,CAmCnB;AAED;;;GAGG;AACH,eAAO,MAAM,cAAc,EAAE,MAAM,CAAC,WAAW,EAAE,MAAM,CAQtD,CAAA;AAED,uFAAuF;AACvF,wBAAgB,eAAe,CAAC,KAAK,EAAE,WAAW,EAAE,CAAC,EAAE,MAAM,GAAG,OAAO,CAGtE;AAKD,2FAA2F;AAC3F,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,QAAQ,EAAE,GAAG,GAAE,IAAiB,GAAG,IAAI,CAgB9E;AAED;;;;;GAKG;AACH,wBAAgB,WAAW,CAAC,GAAG,EAAE,IAAI,EAAE,KAAK,EAAE,WAAW,GAAG,OAAO,CAMlE"}

package/dist/lib/reveal-pose.js

@@ -1,5 +1,6 @@
 import { Box3, Matrix4, Vector3 } from 'three';
 import { clearRevealWipe } from './reveal-wipe';
+import { setMatrixPosed } from './scene-matrices';
 const poses = new WeakMap();
 const step = new Matrix4();
 const glideStep = new Matrix4();
@@ -35,6 +36,7 @@ export function setRevealPose(object, pivot, scale, lift = 0) {
         pose = { pivot: new Vector3(), scale: new Vector3(), lift: 0, glide: null };
         poses.set(object, pose);
         object.updateMatrix = updateRevealedMatrix;
+        setMatrixPosed(object, true);
     }
     pose.pivot.copy(pivot);
     pose.scale.copy(scale);
@@ -59,6 +61,7 @@ export function clearRevealPose(object) {
     if (!poses.delete(object))
         return;
     delete object.updateMatrix;
+    setMatrixPosed(object, false);
     if (object.matrixAutoUpdate)
         object.updateMatrix();
     object.matrixWorldNeedsUpdate = true;

package/dist/lib/scene-matrices.d.ts

@@ -0,0 +1,12 @@
+import { Object3D } from 'three';
+/** Marks `object` as composing its matrix from more than its TRS, or no longer (`false`). */
+export declare function setMatrixPosed(object: Object3D, on: boolean): void;
+/** Whether `object` is hidden only because this render set it aside (outline proxies read this). */
+export declare function isSetAsideForRender(object: Object3D): boolean;
+/**
+ * Runs `render` with the scene's matrices updated once beforehand, three's per-render update off,
+ * and the subtrees no pass draws set aside, so every pass sees the same, already current, matrices
+ * and walks only what it can draw.
+ */
+export declare function renderWithSceneMatrices<T>(scene: Object3D, render: () => T): T;
+//# sourceMappingURL=scene-matrices.d.ts.map

package/dist/lib/scene-matrices.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"scene-matrices.d.ts","sourceRoot":"","sources":["../../src/lib/scene-matrices.ts"],"names":[],"mappings":"AAAA,OAAO,EAA8C,QAAQ,EAAE,MAAM,OAAO,CAAA;AAuP5E,6FAA6F;AAC7F,wBAAgB,cAAc,CAAC,MAAM,EAAE,QAAQ,EAAE,EAAE,EAAE,OAAO,GAAG,IAAI,CASlE;AAqCD,oGAAoG;AACpG,wBAAgB,mBAAmB,CAAC,MAAM,EAAE,QAAQ,GAAG,OAAO,CAE7D;AAED;;;;GAIG;AACH,wBAAgB,uBAAuB,CAAC,CAAC,EAAE,KAAK,EAAE,QAAQ,EAAE,MAAM,EAAE,MAAM,CAAC,GAAG,CAAC,CA0B9E"}

package/dist/lib/scene-matrices.js

@@ -0,0 +1,287 @@
+import { Object3D } from 'three';
+import { getLayoutRevision, isLayoutObserved } from './layer-pass';
+import { BATCHED_LAYER, SHADOW_ONLY_LAYER } from './layers';
+/**
+ * The frame's one walk over the scene graph before it renders: matrices, recomputing only what
+ * changed, and the subtrees no pass of this frame can draw.
+ *
+ * three's `updateMatrixWorld` recomposes every object's local matrix and multiplies every world
+ * matrix each time it runs, and every `renderer.render` of the scene runs it again (prepass,
+ * scene pass, layer passes, shadows). Editor scenes hold ~10k objects, almost all static, so that
+ * was ~13 ms a frame. Here each object remembers the inputs its matrices were last built from —
+ * position, quaternion, scale and pivot (or the local matrix itself when `matrixAutoUpdate` is
+ * off) and its parent — and is rebuilt only when one differs, or when its parent's world matrix
+ * was. The results are the same as three's: a write to `position` is seen the same frame.
+ *
+ * Every pass also walks the whole graph to find what to draw, and most of an editor scene is not
+ * drawable by the color passes: batched originals live on the batched layer, a soloed level's
+ * objects on the shadow-only layer. The same walk finds the top-most subtrees with nothing a pass
+ * can draw this frame, and they are hidden for the render alone, so three never enters them.
+ * Shadow-only content counts as drawable when a light's shadow map renders this frame. Picking,
+ * outlines and bounds run outside the render and see the scene unchanged.
+ *
+ * Those set-aside subtrees are not walked again while nothing could change what they hold: no
+ * observed mask write or child insertion or removal anywhere (LayerPassIndex's revision), no move
+ * of their parent, and at least every {@link FULL_WALK_FRAMES} frames regardless. Their matrices
+ * (picking reads them) are brought up to date on the next full walk.
+ *
+ * Objects that override `updateMatrixWorld` (cameras, skinned meshes, audio, some helpers) are
+ * handed to their own method, which brings their subtree up to date the way three would; they and
+ * their subtrees always count as drawable.
+ */
+const BASE_UPDATE_MATRIX_WORLD = Object3D.prototype.updateMatrixWorld;
+const MATRIX = 16;
+const FULL_WALK_FRAMES = 30;
+/** Layers some pass of the frame may draw: everything but the batched originals'. */
+const COLOR_LAYERS = ~((1 << BATCHED_LAYER) | (1 << SHADOW_ONLY_LAYER));
+const SHADOW_LAYERS = 1 << SHADOW_ONLY_LAYER;
+/** Bit 1: holds something a color pass draws. Bit 2: something only a shadow pass draws. */
+const COLOR = 1;
+const SHADOW = 2;
+const MEMO = Symbol('pascal:scene-matrices');
+function memoOf(object) {
+    let memo = object[MEMO];
+    if (!memo) {
+        memo = {
+            local: new Float64Array(MATRIX).fill(Number.NaN),
+            parent: undefined,
+            holds: 0,
+            idle: false,
+            drawn: isDrawn(object),
+            custom: object.updateMatrixWorld !== BASE_UPDATE_MATRIX_WORLD,
+        };
+        object[MEMO] = memo;
+    }
+    return memo;
+}
+/** Whether `object`'s TRS (and pivot) differ from what its matrix was last composed from. */
+function trsChanged(object, local) {
+    const { position: p, quaternion: q, scale: s } = object;
+    const pivot = object.pivot ?? null;
+    const px = pivot ? pivot.x : Number.NaN;
+    const py = pivot ? pivot.y : Number.NaN;
+    const pz = pivot ? pivot.z : Number.NaN;
+    if (local[0] === p.x &&
+        local[1] === p.y &&
+        local[2] === p.z &&
+        local[3] === q.x &&
+        local[4] === q.y &&
+        local[5] === q.z &&
+        local[6] === q.w &&
+        local[7] === s.x &&
+        local[8] === s.y &&
+        local[9] === s.z &&
+        // NaN marks "no pivot"; Object.is matches it to itself.
+        Object.is(local[10], px) &&
+        Object.is(local[11], py) &&
+        Object.is(local[12], pz)) {
+        return false;
+    }
+    local[0] = p.x;
+    local[1] = p.y;
+    local[2] = p.z;
+    local[3] = q.x;
+    local[4] = q.y;
+    local[5] = q.z;
+    local[6] = q.w;
+    local[7] = s.x;
+    local[8] = s.y;
+    local[9] = s.z;
+    local[10] = px;
+    local[11] = py;
+    local[12] = pz;
+    return true;
+}
+/** Whether a hand-set local matrix differs from the one the world matrix was last built from. */
+function matrixChanged(matrix, local) {
+    const e = matrix.elements;
+    let changed = false;
+    for (let i = 0; i < MATRIX; i++) {
+        if (local[i] !== e[i]) {
+            local[i] = e[i];
+            changed = true;
+        }
+    }
+    return changed;
+}
+/** Objects a pass draws or collects itself; groups and plain nodes only hold them. */
+function isDrawn(o) {
+    return (o.isMesh === true ||
+        o.isLine === true ||
+        o.isPoints === true ||
+        o.isSprite === true ||
+        o.isLight === true ||
+        o.isLOD === true ||
+        o.isClippingGroup === true ||
+        o.isBundleGroup === true);
+}
+function update(object, force, walk) {
+    const memo = memoOf(object);
+    if (memo.custom) {
+        object.updateMatrixWorld(force);
+        memo.holds = COLOR | SHADOW;
+        return memo.holds;
+    }
+    // What this walk compares decides, not `matrixWorldNeedsUpdate`: other code's
+    // `updateWorldMatrix(true, …)` raises that flag up whole ancestor chains every frame while
+    // recomputing the same values, and honouring it forced the entire graph each frame.
+    let changed = force;
+    if (posed.size > 0 && posed.has(object)) {
+        object.updateMatrix();
+        changed = true;
+    }
+    else if (object.matrixAutoUpdate) {
+        // A matrix kept by hand earlier left 16 numbers here; TRS uses the first 13.
+        if (trsChanged(object, memo.local)) {
+            object.updateMatrix();
+            changed = true;
+        }
+    }
+    else if (matrixChanged(object.matrix, memo.local)) {
+        changed = true;
+    }
+    // A set-aside subtree that has not itself moved holds what it held; what is inside changes
+    // drawability only through a mask or child event, which forces a full walk.
+    if (walk.skipIdle && memo.idle && !changed && memo.parent === object.parent)
+        return memo.holds;
+    if (memo.parent !== object.parent) {
+        memo.parent = object.parent;
+        changed = true;
+    }
+    if (changed) {
+        if (object.matrixWorldAutoUpdate === true) {
+            if (object.parent === null)
+                object.matrixWorld.copy(object.matrix);
+            else
+                object.matrixWorld.multiplyMatrices(object.parent.matrixWorld, object.matrix);
+        }
+        force = true;
+    }
+    object.matrixWorldNeedsUpdate = false;
+    let all = 0;
+    if (memo.drawn) {
+        const mask = object.layers.mask;
+        if (mask & COLOR_LAYERS)
+            all |= COLOR;
+        if (mask & SHADOW_LAYERS)
+            all |= SHADOW;
+        const light = object;
+        if (light.isLight && light.castShadow && light.shadow) {
+            walk.shadowLights.push(light);
+            if (light.shadow.autoUpdate || light.shadow.needsUpdate)
+                walk.shadowPending = true;
+        }
+    }
+    const children = object.children;
+    for (let i = 0; i < children.length; i++)
+        all |= update(children[i], force, walk);
+    // Children's results decide which of them to set aside: those with nothing, under a parent
+    // that holds something (the parent's own parent sets the parent aside otherwise).
+    if (all !== 0) {
+        for (let i = 0; i < children.length; i++) {
+            const child = children[i];
+            const childMemo = child[MEMO];
+            if (!childMemo)
+                continue;
+            const held = childMemo.holds;
+            const aside = all & COLOR ? !(held & COLOR) : !(held & SHADOW);
+            childMemo.idle = aside;
+            if (!aside)
+                continue;
+            if (!(held & SHADOW))
+                walk.shadowIdle.push(child);
+            if (all & COLOR)
+                walk.colorIdle.push(child);
+        }
+    }
+    memo.holds = all;
+    return all;
+}
+/**
+ * Objects whose `updateMatrix` composes a pose that moves on its own (a construction reveal, an
+ * agent's glide: reveal-pose.ts) — their TRS stays put, so they recompose every frame.
+ */
+const posed = new Set();
+/** Marks `object` as composing its matrix from more than its TRS, or no longer (`false`). */
+export function setMatrixPosed(object, on) {
+    if (on) {
+        posed.add(object);
+        return;
+    }
+    posed.delete(object);
+    // Its last posed matrix is not what its TRS gives: rebuild on the next walk.
+    const memo = object[MEMO];
+    if (memo)
+        memo.local[0] = Number.NaN;
+}
+let lastRevision = -1;
+let framesSinceFull = 0;
+/**
+ * Brings every matrix under `root` up to date, rebuilding only those whose inputs changed.
+ * Returns what it found: the subtrees nothing of this frame draws, and the shadow casting lights.
+ */
+function updateSceneMatrices(root) {
+    const skipIdle = isLayoutObserved(root) &&
+        getLayoutRevision() === lastRevision &&
+        framesSinceFull < FULL_WALK_FRAMES;
+    framesSinceFull = skipIdle ? framesSinceFull + 1 : 0;
+    const walk = {
+        colorIdle: [],
+        shadowIdle: [],
+        shadowPending: false,
+        skipIdle,
+        shadowLights: [],
+    };
+    update(root, false, walk);
+    lastRevision = getLayoutRevision();
+    if (walk.shadowPending && skipIdle) {
+        // Shadow-only content skipped while color-idle must be current before a shadow pass draws it.
+        framesSinceFull = FULL_WALK_FRAMES;
+        return updateSceneMatrices(root);
+    }
+    return walk;
+}
+/** The shadow map each light had after the last render. */
+const shadowMaps = new WeakMap();
+const hidden = new Set();
+/** Whether `object` is hidden only because this render set it aside (outline proxies read this). */
+export function isSetAsideForRender(object) {
+    return hidden.has(object);
+}
+/**
+ * Runs `render` with the scene's matrices updated once beforehand, three's per-render update off,
+ * and the subtrees no pass draws set aside, so every pass sees the same, already current, matrices
+ * and walks only what it can draw.
+ */
+export function renderWithSceneMatrices(scene, render) {
+    const walk = updateSceneMatrices(scene);
+    const idle = walk.shadowPending ? walk.shadowIdle : walk.colorIdle;
+    hidden.clear();
+    for (const object of idle) {
+        if (!object.visible)
+            continue;
+        object.visible = false;
+        hidden.add(object);
+    }
+    const auto = scene.matrixWorldAutoUpdate;
+    scene.matrixWorldAutoUpdate = false;
+    try {
+        return render();
+    }
+    finally {
+        scene.matrixWorldAutoUpdate = auto;
+        for (const object of hidden)
+            object.visible = true;
+        hidden.clear();
+        // A light whose shadow map was (re)built during the render drew it without what this frame
+        // set aside (a shadow node rebuilt with the pipeline): draw it whole next frame.
+        for (const light of walk.shadowLights) {
+            const map = light.shadow.map;
+            if (shadowMaps.get(light) === map)
+                continue;
+            shadowMaps.set(light, map);
+            if (map)
+                light.shadow.needsUpdate = true;
+        }
+    }
+}

package/dist/lib/scene-pass-mrt.d.ts

@@ -1,6 +1,9 @@
 import { mrt } from 'three/tsl';
-/** Unlit assets already contain their lighting; screen-space AO/GI must not light them again. */
-export declare function sceneLightingMask(): import("three/webgpu").VarNode<"vec4", import("three/webgpu").JoinNode<"vec4">>;
+/**
+ * Per-pixel weights. R: screen-space AO/GI applies (unlit assets already contain their lighting
+ * and must not be lit again). G: the pixel feeds the bloom (not editor highlights, see `markHighlight`).
+ */
+export declare function sceneLightingMask(): import("three/webgpu").JoinNode<"vec4">;
 /**
  * The scene pass's attachments. three blends `output` by the material and leaves every other
  * attachment unblended, so a transparent draw overwrites the whole of what it covers in the normals

package/dist/lib/scene-pass-mrt.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"scene-pass-mrt.d.ts","sourceRoot":"","sources":["../../src/lib/scene-pass-mrt.ts"],"names":[],"mappings":"AACA,OAAO,EAAgB,GAAG,EAAiB,MAAM,WAAW,CAAA;AAM5D,iGAAiG;AACjG,wBAAgB,iBAAiB,oFAKhC;AAED;;;;;;GAMG;AACH,wBAAgB,YAAY,CAAC,OAAO,EAAE,UAAU,CAAC,OAAO,GAAG,CAAC,CAAC,CAAC,CAAC,kCAK9D"}
+{"version":3,"file":"scene-pass-mrt.d.ts","sourceRoot":"","sources":["../../src/lib/scene-pass-mrt.ts"],"names":[],"mappings":"AACA,OAAO,EAAgB,GAAG,EAAiB,MAAM,WAAW,CAAA;AAO5D;;;GAGG;AACH,wBAAgB,iBAAiB,4CAMhC;AAED;;;;;;GAMG;AACH,wBAAgB,YAAY,CAAC,OAAO,EAAE,UAAU,CAAC,OAAO,GAAG,CAAC,CAAC,CAAC,CAAC,kCAK9D"}

package/dist/lib/scene-pass-mrt.js

@@ -1,12 +1,17 @@
 import { MaterialBlending } from 'three';
 import { diffuseColor, mrt, uniform, vec4 } from 'three/tsl';
 import { BlendMode } from 'three/webgpu';
+import { isHighlight } from './editor-highlight';
 import { importedUnlitMaterial } from './gltf-unlit';
 const materialBlend = new BlendMode(MaterialBlending);
-/** Unlit assets already contain their lighting; screen-space AO/GI must not light them again. */
+/**
+ * Per-pixel weights. R: screen-space AO/GI applies (unlit assets already contain their lighting
+ * and must not be lit again). G: the pixel feeds the bloom (not editor highlights, see `markHighlight`).
+ */
 export function sceneLightingMask() {
     const weight = uniform(1).onObjectUpdate(({ material }) => importedUnlitMaterial(material) ? 0 : 1);
-    return vec4(weight, 0, 0, diffuseColor.a);
+    const bloomWeight = uniform(1).onObjectUpdate(({ material }) => (isHighlight(material) ? 0 : 1));
+    return vec4(weight, bloomWeight, 0, diffuseColor.a);
 }
 /**
  * The scene pass's attachments. three blends `output` by the material and leaves every other

package/dist/lib/scene-themes.d.ts

@@ -44,8 +44,6 @@ export declare const UNDERGROUND_PALETTE: {
     readonly vignette: '#0c0c0c';
     /** The thin rim along the cut of the hole in the ground, from above. */
     readonly rim: '#3c3c3c';
-    /** The grade ring under the ground: a light rim where the ground meets the level. */
-    readonly ring: '#b4b4b4';
     /** The sky light's tint (ambient and hemisphere pulled toward it under the ground). */
     readonly tint: '#c8c8c8';
 };

package/dist/lib/scene-themes.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"scene-themes.d.ts","sourceRoot":"","sources":["../../src/lib/scene-themes.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,gBAAgB,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAA;AAErE,MAAM,MAAM,UAAU,GAAG;IACvB,EAAE,EAAE,MAAM,CAAA;IACV,IAAI,EAAE,MAAM,CAAA;IAIZ,UAAU,EAAE,OAAO,GAAG,MAAM,CAAA;IAC5B,UAAU,EAAE,MAAM,CAAA;IAIlB,aAAa,CAAC,EAAE,MAAM,GAAG,IAAI,CAAA;IAI7B,MAAM,EAAE,MAAM,CAAA;IACd,OAAO,EAAE;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,SAAS,EAAE,MAAM,CAAA;KAAE,CAAA;IAC7C,IAAI,CAAC,EAAE;QAAE,GAAG,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAC;QAAC,SAAS,EAAE,MAAM,CAAA;KAAE,CAAA;IACzD,MAAM,EAAE,WAAW,CAAC,WAAW,CAAC,gBAAgB,CAAC,UAAU,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAA;IACxE,mBAAmB,EAAE,MAAM,CAAA;IAC3B,WAAW,CAAC,EAAE,WAAW,CAAC,gBAAgB,CAAC,UAAU,CAAC,CAAC,CAAC,aAAa,CAAC,CAAA;IACtE,cAAc,CAAC,EAAE,gBAAgB,CAAC,gBAAgB,CAAC,CAAA;IACnD,SAAS,CAAC,EAAE,OAAO,CAAC,MAAM,CAAC,WAAW,EAAE,MAAM,CAAC,CAAC,CAAA;CACjD,CAAA;AAED,wBAAgB,iBAAiB,CAAC,KAAK,EAAE,UAAU,EAAE,YAAY,CAAC,EAAE,gBAAgB,GAAG,UAAU,CAUhG;AAED,eAAO,MAAM,YAAY,EAAE,UAAU,EAoMpC,CAAA;AAED,eAAO,MAAM,eAAe,UAAwC,CAAA;AAIpE,wBAAgB,aAAa,CAAC,EAAE,EAAE,MAAM,GAAG,UAAU,CAEpD;AAED;;;;;;GAMG;AACH,eAAO,MAAM,mBAAmB;IAC9B,8EAA8E;aAC9E,UAAU,EAAE,SAAS;IACrB,yCAAyC;aACzC,IAAI,EAAE,SAAS;IACf,iDAAiD;aACjD,GAAG,EAAE,SAAS;aACd,OAAO,EAAE,SAAS;IAClB,6CAA6C;aAC7C,QAAQ,EAAE,SAAS;IACnB,wEAAwE;aACxE,GAAG,EAAE,SAAS;IACd,qFAAqF;aACrF,IAAI,EAAE,SAAS;IACf,uFAAuF;aACvF,IAAI,EAAE,SAAS;CACP,CAAA"}
+{"version":3,"file":"scene-themes.d.ts","sourceRoot":"","sources":["../../src/lib/scene-themes.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,gBAAgB,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAA;AAErE,MAAM,MAAM,UAAU,GAAG;IACvB,EAAE,EAAE,MAAM,CAAA;IACV,IAAI,EAAE,MAAM,CAAA;IAIZ,UAAU,EAAE,OAAO,GAAG,MAAM,CAAA;IAC5B,UAAU,EAAE,MAAM,CAAA;IAIlB,aAAa,CAAC,EAAE,MAAM,GAAG,IAAI,CAAA;IAI7B,MAAM,EAAE,MAAM,CAAA;IACd,OAAO,EAAE;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,SAAS,EAAE,MAAM,CAAA;KAAE,CAAA;IAC7C,IAAI,CAAC,EAAE;QAAE,GAAG,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAC;QAAC,SAAS,EAAE,MAAM,CAAA;KAAE,CAAA;IACzD,MAAM,EAAE,WAAW,CAAC,WAAW,CAAC,gBAAgB,CAAC,UAAU,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAA;IACxE,mBAAmB,EAAE,MAAM,CAAA;IAC3B,WAAW,CAAC,EAAE,WAAW,CAAC,gBAAgB,CAAC,UAAU,CAAC,CAAC,CAAC,aAAa,CAAC,CAAA;IACtE,cAAc,CAAC,EAAE,gBAAgB,CAAC,gBAAgB,CAAC,CAAA;IACnD,SAAS,CAAC,EAAE,OAAO,CAAC,MAAM,CAAC,WAAW,EAAE,MAAM,CAAC,CAAC,CAAA;CACjD,CAAA;AAED,wBAAgB,iBAAiB,CAAC,KAAK,EAAE,UAAU,EAAE,YAAY,CAAC,EAAE,gBAAgB,GAAG,UAAU,CAUhG;AAED,eAAO,MAAM,YAAY,EAAE,UAAU,EAoMpC,CAAA;AAED,eAAO,MAAM,eAAe,UAAwC,CAAA;AAIpE,wBAAgB,aAAa,CAAC,EAAE,EAAE,MAAM,GAAG,UAAU,CAEpD;AAED;;;;;;GAMG;AACH,eAAO,MAAM,mBAAmB;IAC9B,8EAA8E;aAC9E,UAAU,EAAE,SAAS;IACrB,yCAAyC;aACzC,IAAI,EAAE,SAAS;IACf,iDAAiD;aACjD,GAAG,EAAE,SAAS;aACd,OAAO,EAAE,SAAS;IAClB,6CAA6C;aAC7C,QAAQ,EAAE,SAAS;IACnB,wEAAwE;aACxE,GAAG,EAAE,SAAS;IACd,uFAAuF;aACvF,IAAI,EAAE,SAAS;CACP,CAAA"}

package/dist/lib/scene-themes.js

@@ -231,8 +231,6 @@ export const UNDERGROUND_PALETTE = {
     vignette: '#0c0c0c',
     /** The thin rim along the cut of the hole in the ground, from above. */
     rim: '#3c3c3c',
-    /** The grade ring under the ground: a light rim where the ground meets the level. */
-    ring: '#b4b4b4',
     /** The sky light's tint (ambient and hemisphere pulled toward it under the ground). */
     tint: '#c8c8c8',
 };

package/dist/lib/scene-visibility.d.ts

@@ -13,6 +13,8 @@ export type HiddenReason = 'isolated' | 'shadow-only' | 'batched' | 'wall-batche
 export declare function hideFromScene(obj: Object3D, reason: HiddenReason): void;
 /** Drops `reason`, restoring the mask `obj` had before the first one arrived. */
 export declare function showInScene(obj: Object3D, reason: HiddenReason): void;
+/** The reasons `obj` is held off the scene layer, if any. */
+export declare function heldReasons(obj: Object3D): ReadonlySet<HiddenReason> | undefined;
 export declare function temporarilyShowShadowOnly(root: Object3D): () => void;
 /**
  * Lifts what the user's view holds back under `root` — solo's shadow-only

package/dist/lib/scene-visibility.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"scene-visibility.d.ts","sourceRoot":"","sources":["../../src/lib/scene-visibility.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,OAAO,CAAA;AAGrC;;;;;;;;GAQG;AACH,MAAM,MAAM,YAAY,GAAG,UAAU,GAAG,aAAa,GAAG,SAAS,GAAG,cAAc,GAAG,cAAc,CAAA;AAmBnG,2EAA2E;AAC3E,wBAAgB,aAAa,CAAC,GAAG,EAAE,QAAQ,EAAE,MAAM,EAAE,YAAY,GAAG,IAAI,CAMvE;AAED,iFAAiF;AACjF,wBAAgB,WAAW,CAAC,GAAG,EAAE,QAAQ,EAAE,MAAM,EAAE,YAAY,GAAG,IAAI,CAarE;AAED,wBAAgB,yBAAyB,CAAC,IAAI,EAAE,QAAQ,GAAG,MAAM,IAAI,CAEpE;AAED;;;;GAIG;AACH,wBAAgB,2BAA2B,CAAC,IAAI,EAAE,QAAQ,GAAG,MAAM,IAAI,CAEtE;AAED;;;;GAIG;AACH,wBAAgB,yBAAyB,CACvC,QAAQ,EAAE,SAAS,QAAQ,EAAE,EAC7B,KAAK,EAAE,OAAO,GACb,MAAM,IAAI,CAYZ;AAED,wFAAwF;AACxF,wBAAgB,wBAAwB,CAAC,IAAI,EAAE,QAAQ,EAAE,MAAM,EAAE,YAAY,GAAG,MAAM,IAAI,CAczF"}
+{"version":3,"file":"scene-visibility.d.ts","sourceRoot":"","sources":["../../src/lib/scene-visibility.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,OAAO,CAAA;AAGrC;;;;;;;;GAQG;AACH,MAAM,MAAM,YAAY,GAAG,UAAU,GAAG,aAAa,GAAG,SAAS,GAAG,cAAc,GAAG,cAAc,CAAA;AAoBnG,2EAA2E;AAC3E,wBAAgB,aAAa,CAAC,GAAG,EAAE,QAAQ,EAAE,MAAM,EAAE,YAAY,GAAG,IAAI,CASvE;AAED,iFAAiF;AACjF,wBAAgB,WAAW,CAAC,GAAG,EAAE,QAAQ,EAAE,MAAM,EAAE,YAAY,GAAG,IAAI,CAarE;AAED,6DAA6D;AAC7D,wBAAgB,WAAW,CAAC,GAAG,EAAE,QAAQ,GAAG,WAAW,CAAC,YAAY,CAAC,GAAG,SAAS,CAEhF;AAED,wBAAgB,yBAAyB,CAAC,IAAI,EAAE,QAAQ,GAAG,MAAM,IAAI,CAEpE;AAED;;;;GAIG;AACH,wBAAgB,2BAA2B,CAAC,IAAI,EAAE,QAAQ,GAAG,MAAM,IAAI,CAEtE;AAED;;;;GAIG;AACH,wBAAgB,yBAAyB,CACvC,QAAQ,EAAE,SAAS,QAAQ,EAAE,EAC7B,KAAK,EAAE,OAAO,GACb,MAAM,IAAI,CAYZ;AAED,wFAAwF;AACxF,wBAAgB,wBAAwB,CAAC,IAAI,EAAE,QAAQ,EAAE,MAAM,EAAE,YAAY,GAAG,MAAM,IAAI,CAczF"}

package/dist/lib/scene-visibility.js

@@ -14,7 +14,11 @@ const HOLD = Symbol('pascal:scene-visibility:hold');
 /** Holds `obj` off the scene layer for `reason`. Idempotent per reason. */
 export function hideFromScene(obj, reason) {
     const holder = obj;
-    const hold = holder[HOLD] ?? { original: obj.layers.mask, reasons: new Set() };
+    // Solo re-hides whole levels every frame: when nothing rewrote the mask since, there is no work.
+    const held = holder[HOLD];
+    if (held?.reasons.has(reason) && held.applied === obj.layers.mask)
+        return;
+    const hold = held ?? { original: obj.layers.mask, reasons: new Set() };
     holder[HOLD] = hold;
     hold.reasons.add(reason);
     applyHold(obj, hold);
@@ -33,6 +37,10 @@ export function showInScene(obj, reason) {
     obj.layers.mask = hold.original;
     delete holder[HOLD];
 }
+/** The reasons `obj` is held off the scene layer, if any. */
+export function heldReasons(obj) {
+    return obj[HOLD]?.reasons;
+}
 export function temporarilyShowShadowOnly(root) {
     return temporarilyShowHeld(root, ['shadow-only']);
 }
@@ -114,8 +122,9 @@ function applyHold(obj, hold) {
         obj.layers.disable(SHADOW_ONLY_LAYER);
     if (hold.reasons.has('batched') || hold.reasons.has('wall-batched')) {
         obj.layers.enable(BATCHED_LAYER);
-        return;
     }
-    if (!hold.reasons.has('isolated') && hold.reasons.has('shadow-only'))
+    else if (!hold.reasons.has('isolated') && hold.reasons.has('shadow-only')) {
         obj.layers.enable(SHADOW_ONLY_LAYER);
+    }
+    hold.applied = obj.layers.mask;
 }

package/dist/lib/site-surfaces.d.ts

@@ -4,14 +4,9 @@ import type { Object3D } from 'three';
  * drawn on the ground (property line, setbacks, contours) carry none.
  */
 export declare const SITE_GROUND = "siteGround";
-/**
- * `userData` key marking the generic foundation under the buildings (footing and stem, drawn under
- * the ground): a capture that sees through the veil leaves it out, as it left it out before it was drawn.
- */
-export declare const SITE_FOUNDATION = "siteFoundation";
 /**
  * `solid`: the lot's fill, its sculpted terrain, the horizon disc. `veil`: what is drawn in their
- * place over a level below grade, the grade ring with it.
+ * place over a level below grade.
  */
 export type SiteGroundRole = 'solid' | 'veil';
 /**
@@ -19,8 +14,6 @@ export type SiteGroundRole = 'solid' | 'veil';
  * its registered children (buildings, items), which are groups.
  */
 export declare function siteSurfaces(): Object3D[];
-/** The site's generic foundation meshes, shown or not. */
-export declare function siteFoundation(): Object3D[];
 /** The site's ground by role, shown or not: the veil is hidden until a level below grade is shown. */
 export declare function siteGround(): Record<SiteGroundRole, Object3D[]>;
 /**

package/dist/lib/site-surfaces.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"site-surfaces.d.ts","sourceRoot":"","sources":["../../src/lib/site-surfaces.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,OAAO,CAAA;AAGrC;;;GAGG;AACH,eAAO,MAAM,WAAW,eAAe,CAAA;AAEvC;;;GAGG;AACH,eAAO,MAAM,eAAe,mBAAmB,CAAA;AAE/C;;;GAGG;AACH,MAAM,MAAM,cAAc,GAAG,OAAO,GAAG,MAAM,CAAA;AAE7C;;;GAGG;AACH,wBAAgB,YAAY,IAAI,QAAQ,EAAE,CAUzC;AAED,0DAA0D;AAC1D,wBAAgB,cAAc,IAAI,QAAQ,EAAE,CAQ3C;AAED,sGAAsG;AACtG,wBAAgB,UAAU,IAAI,MAAM,CAAC,cAAc,EAAE,QAAQ,EAAE,CAAC,CAS/D;AAED;;;;GAIG;AACH,wBAAgB,qBAAqB,CAAC,MAAM,EAAE,OAAO,GAAG,MAAM,IAAI,CAYjE"}
+{"version":3,"file":"site-surfaces.d.ts","sourceRoot":"","sources":["../../src/lib/site-surfaces.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,OAAO,CAAA;AAGrC;;;GAGG;AACH,eAAO,MAAM,WAAW,eAAe,CAAA;AAEvC;;;GAGG;AACH,MAAM,MAAM,cAAc,GAAG,OAAO,GAAG,MAAM,CAAA;AAE7C;;;GAGG;AACH,wBAAgB,YAAY,IAAI,QAAQ,EAAE,CAUzC;AAED,sGAAsG;AACtG,wBAAgB,UAAU,IAAI,MAAM,CAAC,cAAc,EAAE,QAAQ,EAAE,CAAC,CAS/D;AAED;;;;GAIG;AACH,wBAAgB,qBAAqB,CAAC,MAAM,EAAE,OAAO,GAAG,MAAM,IAAI,CASjE"}