@crystaldesign/real-time-viewer-next 26.12.0-beta.2 → 26.12.0-beta.20

package/build/esm/{DeckCutoutSubsystem-5d0fb500.js → DeckCutoutSubsystem-34516143.js}

@@ -1,4 +1,4 @@
-import { p as parseElementKey, u as useStableEnvSlice, a as useRTVStore, b as bootPhase, D as DECK_COLLAR_LOAD_ID } from './index-cc012549.js';
+import { p as parseElementKey, u as useStableEnvSlice, a as useRTVStore, b as bootPhase, c as adoptPristineFadeState, D as DECK_COLLAR_LOAD_ID } from './index-8c31a811.js';
 import { useRef, useEffect, useMemo, useState, useCallback } from 'react';
 import _slicedToArray from '@babel/runtime/helpers/slicedToArray';
 import _defineProperty from '@babel/runtime/helpers/defineProperty';
@@ -2000,6 +2000,8 @@ function meshesMatching(root, patterns) {
  */
 function cloneDeckMaterial(source) {
   var clone = source.clone();
+  // The deck is sampled while the 2D→3D fade may still be driving its material.
+  adoptPristineFadeState(clone);
   if (clone instanceof MeshStandardMaterial) {
     clone.aoMap = null;
     clone.lightMap = null;

package/build/esm/{SunLensflare-9cbd6d72.js → SunLensflare-55ce48ee.js}

@@ -1,5 +1,5 @@
 import _slicedToArray from '@babel/runtime/helpers/slicedToArray';
-import { f as flushPendingBVH, g as collectCollisionTargets } from './index-cc012549.js';
+import { g as flushPendingBVH, h as collectCollisionTargets } from './index-8c31a811.js';
 import { useMemo, useEffect, useRef } from 'react';
 import { Billboard } from '@react-three/drei';
 import { useThree, useFrame } from '@react-three/fiber';

package/build/esm/{WaterSurface-715ff751.js → WaterSurface-ff270e38.js}

@@ -1,5 +1,5 @@
 import _slicedToArray from '@babel/runtime/helpers/slicedToArray';
-import { w as withRenderTarget, s as setCausticReceiversSuspended, c as waterUniforms, d as disableWaterUniforms, a as useRTVStore, F as FRAME_ORDER, e as sunAnglesToDirection, l as lightingSunTowardDirection } from './index-cc012549.js';
+import { w as withRenderTarget, s as setCausticReceiversSuspended, d as waterUniforms, e as disableWaterUniforms, a as useRTVStore, F as FRAME_ORDER, f as sunAnglesToDirection, l as lightingSunTowardDirection } from './index-8c31a811.js';
 import { useRef, useMemo, useEffect, useCallback, useState } from 'react';
 import { useThree, useFrame } from '@react-three/fiber';
 import { Vector3, WebGLRenderTarget, HalfFloatType, RGBAFormat, LinearFilter, OrthographicCamera, ShaderMaterial, DoubleSide, MeshStandardMaterial, Box3, NoToneMapping, Frustum, Matrix4, Vector4, Vector2, Plane, Scene, Mesh, PlaneGeometry, ClampToEdgeWrapping, UnsignedByteType, LinearMipmapLinearFilter, MeshBasicMaterial, Color } from 'three';

package/build/esm/{index-cc012549.js → index-8c31a811.js}

@@ -60,6 +60,21 @@ if (typeof __webpack_public_path__ !== 'undefined') {
   }
 }
 
+/**
+ * Two independent 32-bit hashes (djb2 + sdbm) plus the length, for callers that keep a digest of a
+ * string instead of the string itself. A collision would have to hit all three at once.
+ */
+function hashString(text) {
+  var h1 = 5381;
+  var h2 = 0;
+  for (var i = 0; i < text.length; i++) {
+    var c = text.charCodeAt(i);
+    h1 = (h1 << 5) + h1 + c | 0;
+    h2 = c + (h2 << 6) + (h2 << 16) - h2 | 0;
+  }
+  return "".concat(text.length, ":").concat(h1, ":").concat(h2);
+}
+
 function _createForOfIteratorHelper$J(r, e) { var t = "undefined" != typeof Symbol && r[Symbol.iterator] || r["@@iterator"]; if (!t) { if (Array.isArray(r) || (t = _unsupportedIterableToArray$J(r)) || e && r && "number" == typeof r.length) { t && (r = t); var _n = 0, F = function F() {}; return { s: F, n: function n() { return _n >= r.length ? { done: !0 } : { done: !1, value: r[_n++] }; }, e: function e(r) { throw r; }, f: F }; } throw new TypeError("Invalid attempt to iterate non-iterable instance.\nIn order to be iterable, non-array objects must have a [Symbol.iterator]() method."); } var o, a = !0, u = !1; return { s: function s() { t = t.call(r); }, n: function n() { var r = t.next(); return a = r.done, r; }, e: function e(r) { u = !0, o = r; }, f: function f() { try { a || null == t["return"] || t["return"](); } finally { if (u) throw o; } } }; }
 function _unsupportedIterableToArray$J(r, a) { if (r) { if ("string" == typeof r) return _arrayLikeToArray$J(r, a); var t = {}.toString.call(r).slice(8, -1); return "Object" === t && r.constructor && (t = r.constructor.name), "Map" === t || "Set" === t ? Array.from(r) : "Arguments" === t || /^(?:Ui|I)nt(?:8|16|32)(?:Clamped)?Array$/.test(t) ? _arrayLikeToArray$J(r, a) : void 0; } }
 function _arrayLikeToArray$J(r, a) { (null == a || a > r.length) && (a = r.length); for (var e = 0, n = Array(a); e < a; e++) n[e] = r[e]; return n; }
@@ -68,20 +83,11 @@ var cache = new Map();
 var generation = 0;
 
 /**
- * Two independent 32-bit hashes (djb2 + sdbm) over the serialized key tuple. A raw
- * product-material key carries the full mat-list (tens of KB) and distinct configurations are
- * unbounded — hashed keys keep the map's key memory flat.
+ * A raw product-material key carries the full mat-list (tens of KB) and distinct configurations
+ * are unbounded — hashed keys keep the map's key memory flat.
  */
 function hashKeys(keys) {
-  var serialized = JSON.stringify(keys);
-  var h1 = 5381;
-  var h2 = 0;
-  for (var i = 0; i < serialized.length; i++) {
-    var c = serialized.charCodeAt(i);
-    h1 = (h1 << 5) + h1 + c | 0;
-    h2 = c + (h2 << 6) + (h2 << 16) - h2 | 0;
-  }
-  return "".concat(h1, ":").concat(h2);
+  return hashString(JSON.stringify(keys));
 }
 
 /**
@@ -1055,6 +1061,12 @@ var createGLGenerationSlice = function createGLGenerationSlice(set, get) {
         glContextLost: lost
       });
     },
+    renderStopped: false,
+    setRenderStopped: function setRenderStopped(stopped) {
+      if (get().renderStopped !== stopped) set({
+        renderStopped: stopped
+      });
+    },
     glContextLossLoop: false,
     registerContextRestore: function registerContextRestore() {
       var now = Date.now();
@@ -4422,7 +4434,7 @@ var chunk$2;
 /** Memoized so the preload and the lazy mount share ONE chunk request. */
 function loadChunk$2() {
   var _chunk;
-  return (_chunk = chunk$2) !== null && _chunk !== void 0 ? _chunk : chunk$2 = import('./WaterSurface-715ff751.js');
+  return (_chunk = chunk$2) !== null && _chunk !== void 0 ? _chunk : chunk$2 = import('./WaterSurface-ff270e38.js');
 }
 
 /**
@@ -4457,7 +4469,7 @@ var chunk$1;
 /** Memoized so the preload and the lazy mount share ONE chunk request. */
 function loadChunk$1() {
   var _chunk;
-  return (_chunk = chunk$1) !== null && _chunk !== void 0 ? _chunk : chunk$1 = import('./DeckCutoutSubsystem-5d0fb500.js');
+  return (_chunk = chunk$1) !== null && _chunk !== void 0 ? _chunk : chunk$1 = import('./DeckCutoutSubsystem-34516143.js');
 }
 
 /**
@@ -4502,7 +4514,7 @@ var chunk;
 /** Memoized so the preload and the lazy mount share ONE chunk request. */
 function loadChunk() {
   var _chunk;
-  return (_chunk = chunk) !== null && _chunk !== void 0 ? _chunk : chunk = import('./SunLensflare-9cbd6d72.js');
+  return (_chunk = chunk) !== null && _chunk !== void 0 ? _chunk : chunk = import('./SunLensflare-55ce48ee.js');
 }
 
 /**
@@ -8422,6 +8434,48 @@ function dropFailedMaps(mat) {
   }
 }
 
+/** A material's state before a fade started driving it. */
+
+var FADE_ORIGINAL_KEY = 'rtvFadeOriginal';
+
+/**
+ * The 2D↔3D fade (`useMaterialFade`) drives `opacity` / `transparent` on every mesh material in
+ * the scene, so while it runs a material's live values are transient. The pre-fade state travels
+ * ON the material: `Material.clone()` copies `userData`, so a clone taken mid-fade — the deck
+ * collar sampling the deck, a caustic-receiver patch of a shared article material — carries the
+ * state it has to return to instead of freezing the faded values as its own.
+ */
+function stampFadeOriginal(mat, original) {
+  mat.userData[FADE_ORIGINAL_KEY] = {
+    opacity: original.opacity,
+    transparent: original.transparent
+  };
+}
+function readFadeOriginal(mat) {
+  var stamped = mat.userData[FADE_ORIGINAL_KEY];
+  if (typeof (stamped === null || stamped === void 0 ? void 0 : stamped.opacity) !== 'number' || typeof (stamped === null || stamped === void 0 ? void 0 : stamped.transparent) !== 'boolean') return null;
+  return {
+    opacity: stamped.opacity,
+    transparent: stamped.transparent
+  };
+}
+function clearFadeOriginal(mat) {
+  delete mat.userData[FADE_ORIGINAL_KEY];
+}
+
+/**
+ * Put a fresh clone back into its source's pre-fade state. A clone that keeps the faded values is
+ * restored TO them when the fade ends (they read as its original) — or, mounted after the fade
+ * already ended, is never restored at all.
+ */
+function adoptPristineFadeState(mat) {
+  var original = readFadeOriginal(mat);
+  if (!original) return;
+  mat.opacity = original.opacity;
+  mat.transparent = original.transparent;
+  clearFadeOriginal(mat);
+}
+
 function _createForOfIteratorHelper$t(r, e) { var t = "undefined" != typeof Symbol && r[Symbol.iterator] || r["@@iterator"]; if (!t) { if (Array.isArray(r) || (t = _unsupportedIterableToArray$t(r)) || e && r && "number" == typeof r.length) { t && (r = t); var _n = 0, F = function F() {}; return { s: F, n: function n() { return _n >= r.length ? { done: !0 } : { done: !1, value: r[_n++] }; }, e: function e(r) { throw r; }, f: F }; } throw new TypeError("Invalid attempt to iterate non-iterable instance.\nIn order to be iterable, non-array objects must have a [Symbol.iterator]() method."); } var o, a = !0, u = !1; return { s: function s() { t = t.call(r); }, n: function n() { var r = t.next(); return a = r.done, r; }, e: function e(r) { u = !0, o = r; }, f: function f() { try { a || null == t["return"] || t["return"](); } finally { if (u) throw o; } } }; }
 function _unsupportedIterableToArray$t(r, a) { if (r) { if ("string" == typeof r) return _arrayLikeToArray$t(r, a); var t = {}.toString.call(r).slice(8, -1); return "Object" === t && r.constructor && (t = r.constructor.name), "Map" === t || "Set" === t ? Array.from(r) : "Arguments" === t || /^(?:Ui|I)nt(?:8|16|32)(?:Clamped)?Array$/.test(t) ? _arrayLikeToArray$t(r, a) : void 0; } }
 function _arrayLikeToArray$t(r, a) { (null == a || a > r.length) && (a = r.length); for (var e = 0, n = Array(a); e < a; e++) n[e] = r[e]; return n; }
@@ -8512,6 +8566,8 @@ var FRAGMENT_OUTPUT_REPLACEMENT = /* glsl */"\n  #ifdef OPAQUE\n    diffuseColor
 function patchMaterialAsCausticReceiver(source, uniforms) {
   var _userData;
   var patched = source.clone();
+  // A shared source can be mid-fade, or left faded by a switch to 2D, when the receiver is patched.
+  adoptPristineFadeState(patched);
 
   // One uniform set per receiver material, seeded from the singleton;
   // `refreshCausticReceiverUniforms` keeps them current.
@@ -13907,10 +13963,16 @@ function useMaterialFade() {
       var mats = Array.isArray(mesh.material) ? mesh.material : [mesh.material];
       mats.forEach(function (mat) {
         if (!originals.has(mat)) {
-          originals.set(mat, {
+          var _readFadeOriginal;
+          // A material can enter the fade already stamped: a clone of a fading material
+          // (`Material.clone()` copies `userData`) or a cached material an earlier fade left
+          // faded. Its live values are transient then — the stamp is the state to return to.
+          var original = (_readFadeOriginal = readFadeOriginal(mat)) !== null && _readFadeOriginal !== void 0 ? _readFadeOriginal : {
             opacity: mat.opacity,
             transparent: mat.transparent
-          });
+          };
+          originals.set(mat, original);
+          stampFadeOriginal(mat, original);
           // Only the `transparent` flip changes the compiled program — recompile once when a
           // material enters the fade, not on every per-frame opacity write.
           mat.transparent = true;
@@ -13929,6 +13991,7 @@ function useMaterialFade() {
         mat.transparent = orig.transparent;
         mat.needsUpdate = true;
       }
+      clearFadeOriginal(mat);
     });
     originals.clear();
   }, []);
@@ -22119,7 +22182,8 @@ var LOG$5 = getLogger('RealTimeViewer', 'FrameloopVisibility');
  * visibility (pause when invisible) and the profile's `maxFps` cap.
  *
  * Visibility toggles `frameloop` between the env-resolved value and `'never'`
- * on tab hide / window blur.
+ * on tab hide / window blur, and while the host's `stopRender` holds
+ * (`renderStopped`).
  *
  * The FPS cap is gated at the renderer level, not via `frameloop` — we wrap
  * `gl.render` and throttle only the final present:
@@ -22266,9 +22330,14 @@ function useFrameloopVisibility() {
       var active = !hidden && focused;
       var _useRTVStore$getState = useRTVStore$1.getState(),
         isCapturing = _useRTVStore$getState.isCapturing,
-        glContextLost = _useRTVStore$getState.glContextLost;
-      // A lost context overrides everything, captures included.
-      var shouldRun = (active || isCapturing) && !glContextLost;
+        glContextLost = _useRTVStore$getState.glContextLost,
+        renderStopped = _useRTVStore$getState.renderStopped,
+        isSceneLoading = _useRTVStore$getState.isSceneLoading;
+      // A host-stopped render pauses the loop, except while a scene load is in flight: the boot
+      // gates end from `useFrame` (environment GLB placement), so a viewer covered mid-boot would
+      // otherwise hold the loading overlay until it is shown again. A capture keeps rendering
+      // regardless of visibility. A lost context overrides everything.
+      var shouldRun = (active && (!renderStopped || isSceneLoading) || isCapturing) && !glContextLost;
       var next = shouldRun ? envFrameloop : 'never';
       if (next === lastApplied) return;
       lastApplied = next;
@@ -22281,7 +22350,8 @@ function useFrameloopVisibility() {
         hidden: hidden,
         focused: focused,
         isCapturing: isCapturing,
-        glContextLost: glContextLost
+        glContextLost: glContextLost,
+        renderStopped: renderStopped
       });
       state.setFrameloop(next);
       if (next === 'demand') state.invalidate();
@@ -22321,6 +22391,11 @@ function useFrameloopVisibility() {
     }, function () {
       return apply('glContextLost-change');
     });
+    var unsubRenderStopped = useRTVStore$1.subscribe(function (s) {
+      return "".concat(s.renderStopped, "|").concat(s.isSceneLoading);
+    }, function () {
+      return apply('renderStopped-change');
+    });
     return function () {
       document.removeEventListener('visibilitychange', onVis);
       window.removeEventListener('blur', onBlur);
@@ -22330,6 +22405,7 @@ function useFrameloopVisibility() {
       window.clearInterval(pollId);
       unsubCapturing();
       unsubContextLost();
+      unsubRenderStopped();
       uninstallCap();
       // Don't force `'always'` on teardown — the next mount or the next
       // env change will set the correct value, and slamming `'always'`
@@ -22686,17 +22762,22 @@ function SceneRenderer() {
     window.addEventListener('pagehide', onPageHide, {
       once: true
     });
-    canvasCleanupRef.current = function () {
+    var cleanup = function cleanup() {
       for (var _i = 0, _auditTimers = auditTimers; _i < _auditTimers.length; _i++) {
         var timer = _auditTimers[_i];
         window.clearTimeout(timer);
       }
-      // This canvas' deadline must not outlive it and flag a future healthy canvas.
+      // Neither this canvas' deadline nor its listeners may outlive it: R3F force-loses the context
+      // ~500 ms after the Canvas unmounts, and a listener still attached would flag that teardown as
+      // a device loss — pausing the successor canvas and tripping the breaker 12 s later.
       window.clearTimeout(restoreDeadline);
+      canvas.removeEventListener('webglcontextlost', onContextLost, false);
+      canvas.removeEventListener('webglcontextrestored', onContextRestored, false);
       window.removeEventListener('pagehide', onPageHide);
     };
+    canvasCleanupRef.current = cleanup;
     var restoreDeadline = 0;
-    canvas.addEventListener('webglcontextlost', function (event) {
+    var onContextLost = function onContextLost(event) {
       event.preventDefault();
       CONTEXT_LOG.warn('WebGL context lost — preventing default to allow restore');
       // Pause the frameloop (see `useFrameloopVisibility`): rendering against the dead context
@@ -22709,8 +22790,8 @@ function SceneRenderer() {
       restoreDeadline = window.setTimeout(function () {
         if (useRTVStore$1.getState().glContextLost) useRTVStore$1.getState().tripContextLossBreaker('no restore within 12s');
       }, 12000);
-    }, false);
-    canvas.addEventListener('webglcontextrestored', function () {
+    };
+    var onContextRestored = function onContextRestored() {
       window.clearTimeout(restoreDeadline);
       CONTEXT_LOG.warn('WebGL context restored — rebuilding render-target-backed resources');
       useRTVStore$1.getState().logGLContextEvent('context restored — rebuilding');
@@ -22728,13 +22809,18 @@ function SceneRenderer() {
       evictEquirectMasters();
       evictGLTFCache();
       evictEnvironmentGLBs();
+      // Tear this canvas down before the swap: R3F force-loses its context ~500 ms after the unmount,
+      // and the successor's onCreated (which also runs this) waits for a debounced size measurement first.
+      cleanup();
       useRTVStore$1.getState().bumpGLGeneration();
       // Shrink the outgoing canvas once React swapped it out.
       window.setTimeout(function () {
         canvas.width = 1;
         canvas.height = 1;
       }, 0);
-    }, false);
+    };
+    canvas.addEventListener('webglcontextlost', onContextLost, false);
+    canvas.addEventListener('webglcontextrestored', onContextRestored, false);
   }, []);
   var _useRTVAnalyzerCompon = useRTVAnalyzerComponents(),
     DebugPanel = _useRTVAnalyzerCompon.DebugPanel,
@@ -23178,17 +23264,22 @@ function SceneLoadingDivaBridge() {
 
 /**
  * Hides the whole viewer (the canvas + everything it renders) while the scene
- * loads, so the user never sees a half-built scene pop in. Uses `visibility`
- * (not unmount / `display:none`) so the canvas keeps rendering and the in-flight
- * GLB finishes decoding + fires `endSceneLoad`, which reveals it in place.
+ * loads, so the user never sees a half-built scene pop in, and while the host
+ * has stopped rendering (`stopRender` → `renderStopped`). Uses `visibility`
+ * (not unmount / `display:none`) so the canvas keeps its size and its context:
+ * an in-flight GLB finishes decoding + fires `endSceneLoad`, which reveals it
+ * in place, and a paused viewer resumes without a reboot.
  */
 function SceneVisibilityGate(_ref) {
   var children = _ref.children;
   var isSceneLoading = useRTVStore$1(function (s) {
     return s.isSceneLoading;
   });
+  var renderStopped = useRTVStore$1(function (s) {
+    return s.renderStopped;
+  });
   return /*#__PURE__*/jsx("div", {
-    className: isSceneLoading ? "".concat(gate, " ").concat(hidden) : gate,
+    className: isSceneLoading || renderStopped ? "".concat(gate, " ").concat(hidden) : gate,
     children: children
   });
 }
@@ -23380,21 +23471,43 @@ function useAssembledScene(_ref) {
       return null;
     }
   }, [hqRenderScriptProp]);
+
+  // Scenes are compared by content, not by script string: the host re-emits the script for every
+  // render request (a different `_id`, render size or camera per request), and a new `ParsedScene`
+  // object alone re-runs every scene consumer — article-version bump, BVH, shadow rebuild, deck
+  // re-measure and collar rebuild — for a scene that did not change.
+  var lastParsedRef = useRef(null);
   var parsed = useMemo(function () {
+    var _lastParsedRef$curren;
     if (!externalHqs) return null;
     var parseStartedAt = bootClockMs();
+    var scene;
+    // The parse alone is guarded: nothing below may turn a scene that parsed fine into a blank viewer.
     try {
-      var scene = parseRenderScript(externalHqs, config.archiveBaseUrl);
-      bootPhase('parse done', {
-        ms: Math.round(bootClockMs() - parseStartedAt),
-        geoAssets: scene.geoAssets.length,
-        matAssets: scene.matAssets.length
-      });
-      return scene;
+      scene = parseRenderScript(externalHqs, config.archiveBaseUrl);
     } catch (err) {
       LOG$2.error(err instanceof Error ? err : new Error(String(err)));
       return null;
     }
+    // A digest, not the serialized scene: the full text of a pool scene would sit in this ref for
+    // the page's lifetime.
+    var signature = hashString(JSON.stringify(scene));
+    if (((_lastParsedRef$curren = lastParsedRef.current) === null || _lastParsedRef$curren === void 0 ? void 0 : _lastParsedRef$curren.signature) === signature) {
+      bootPhase('parse done (scene unchanged)', {
+        ms: Math.round(bootClockMs() - parseStartedAt)
+      });
+      return lastParsedRef.current.scene;
+    }
+    lastParsedRef.current = {
+      scene: scene,
+      signature: signature
+    };
+    bootPhase('parse done', {
+      ms: Math.round(bootClockMs() - parseStartedAt),
+      geoAssets: scene.geoAssets.length,
+      matAssets: scene.matAssets.length
+    });
+    return scene;
   }, [externalHqs, config.archiveBaseUrl]);
 
   // The first-article hold (see the id's doc). Begun before any reveal can happen (the seeded
@@ -23879,7 +23992,8 @@ function useHostPropsSync(_ref2) {
     elementsInfo = _ref2.elementsInfo,
     selectedElementId = _ref2.selectedElementId,
     selectedAccessoryKey = _ref2.selectedAccessoryKey,
-    callbacks = _ref2.callbacks;
+    callbacks = _ref2.callbacks,
+    stopRender = _ref2.stopRender;
   var setViewMode = useRTVStore$1(function (s) {
     return s.setViewMode;
   });
@@ -23916,6 +24030,9 @@ function useHostPropsSync(_ref2) {
   var setShowDimensionLines = useRTVStore$1(function (s) {
     return s.setShowDimensionLines;
   });
+  var setRenderStopped = useRTVStore$1(function (s) {
+    return s.setRenderStopped;
+  });
   var sceneElementCount = useRTVStore$1(function (s) {
     return s.elements.length;
   });
@@ -23972,6 +24089,9 @@ function useHostPropsSync(_ref2) {
   useEffect(function () {
     setShowDimensionLines(!!showDimensionLines);
   }, [setShowDimensionLines, showDimensionLines]);
+  useEffect(function () {
+    setRenderStopped(!!stopRender);
+  }, [setRenderStopped, stopRender]);
   useEffect(function () {
     if (focusElementId != null) {
       focusElementById(focusElementId);
@@ -24001,7 +24121,6 @@ function useHostPropsSync(_ref2) {
 var RealTimeRendererNext = /*#__PURE__*/memo(function (props) {
   var scene2d = props.scene2d,
     viewMode = props.viewMode,
-    stopRender = props.stopRender,
     analyzerComponents = props.analyzerComponents;
   var unsupported = useRTVStore$1(function (s) {
     return s.unsupported;
@@ -24024,7 +24143,7 @@ var RealTimeRendererNext = /*#__PURE__*/memo(function (props) {
   // must not unmount (killing the WebGL context) meanwhile — the visibility gate keeps it hidden
   // until the boot loads resolve.
   var hasAnything = hasStoreScene || parsed || scene2d || viewMode === '2d';
-  if (stopRender || !hasAnything) return null;
+  if (!hasAnything) return null;
 
   // Tier-0 fallback: render nothing rather than a broken WebGL context.
   if (unsupported) return null;
@@ -25154,4 +25273,4 @@ var internals = /*#__PURE__*/Object.freeze({
     mergePresetBundle: mergePresetBundle
 });
 
-export { DECK_COLLAR_LOAD_ID as D, ENVIRONMENT_CONFIG as E, FRAME_ORDER as F, RealTimeRendererNext as R, WHITE_ROOM_PRESET as W, useRTVStore$1 as a, bootPhase as b, waterUniforms as c, disableWaterUniforms as d, sunAnglesToDirection as e, flushPendingBVH as f, collectCollisionTargets as g, emitConfig as h, internals as i, lightingSunTowardDirection as l, parseElementKey as p, setCausticReceiversSuspended as s, useStableEnvSlice as u, withRenderTarget as w };
+export { DECK_COLLAR_LOAD_ID as D, ENVIRONMENT_CONFIG as E, FRAME_ORDER as F, RealTimeRendererNext as R, WHITE_ROOM_PRESET as W, useRTVStore$1 as a, bootPhase as b, adoptPristineFadeState as c, waterUniforms as d, disableWaterUniforms as e, sunAnglesToDirection as f, flushPendingBVH as g, collectCollisionTargets as h, internals as i, emitConfig as j, lightingSunTowardDirection as l, parseElementKey as p, setCausticReceiversSuspended as s, useStableEnvSlice as u, withRenderTarget as w };

package/build/esm/index.js

@@ -1,4 +1,4 @@
-export { E as ENVIRONMENT_CONFIG, W as WHITE_ROOM_PRESET, R as default, h as emitConfig, i as internals, a as useRTVStore } from './index-cc012549.js';
+export { E as ENVIRONMENT_CONFIG, W as WHITE_ROOM_PRESET, R as default, j as emitConfig, i as internals, a as useRTVStore } from './index-8c31a811.js';
 import 'react';
 import '@react-three/fiber';
 import 'three';

package/build/types/real-time-viewer-next/src/RealTimeRendererNext.d.ts

@@ -19,6 +19,11 @@ export interface RTVNextProps {
     scene2d?: RTVScene2D;
     viewMode?: '3d' | '2d';
     config: RTVConfig;
+    /**
+     * Pauses the viewer instead of unmounting it: the frameloop stops and the stage is hidden, while
+     * the assembled scene, every cache and the WebGL context stay alive for an instant return. A host
+     * that does not want the viewer to boot at all simply does not mount it.
+     */
     stopRender?: boolean;
     callbacks?: RTVCallbacks;
     analyzerComponents?: RTVAnalyzerComponentMap;

package/build/types/real-time-viewer-next/src/RealTimeRendererNext.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"RealTimeRendererNext.d.ts","sourceRoot":"","sources":["../../../../src/RealTimeRendererNext.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAe,MAAM,OAAO,CAAC;AAGpC,OAAO,EAAe,KAAK,YAAY,EAAE,KAAK,SAAS,EAAE,MAAM,SAAS,CAAC;AACzE,OAAO,EAAuB,KAAK,uBAAuB,EAAE,MAAM,sBAAsB,CAAC;AAIzF,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAC;AAClD,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,mBAAmB,CAAC;AAE5D,iGAAiG;AACjG,MAAM,WAAW,cAAc;IAC7B,YAAY,EAAE,MAAM,CAAC;IACrB,GAAG,CAAC,EAAE,MAAM,CAAC;CACd;AAED,MAAM,WAAW,YAAY;IAC3B;;;OAGG;IACH,WAAW,CAAC,EAAE,cAAc,CAAC;IAC7B,mGAAmG;IACnG,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,OAAO,CAAC,EAAE,UAAU,CAAC;IACrB,QAAQ,CAAC,EAAE,IAAI,GAAG,IAAI,CAAC;IACvB,MAAM,EAAE,SAAS,CAAC;IAClB,UAAU,CAAC,EAAE,OAAO,CAAC;IACrB,SAAS,CAAC,EAAE,YAAY,CAAC;IACzB,kBAAkB,CAAC,EAAE,uBAAuB,CAAC;IAC7C,6FAA6F;IAC7F,cAAc,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC/B,2FAA2F;IAC3F,YAAY,CAAC,EAAE,GAAG,CAAC,MAAM,EAAE,kBAAkB,CAAC,CAAC;IAC/C,4FAA4F;IAC5F,WAAW,CAAC,EAAE,OAAO,CAAC;IACtB,gGAAgG;IAChG,iBAAiB,CAAC,EAAE,OAAO,wBAAwB,EAAE,iBAAiB,EAAE,CAAC;IACzE,6FAA6F;IAC7F,oBAAoB,CAAC,EAAE,OAAO,wBAAwB,EAAE,oBAAoB,EAAE,CAAC;IAC/E;;;;;OAKG;IACH,mBAAmB,CAAC,EAAE,MAAM,CAAC;IAC7B,+FAA+F;IAC/F,qBAAqB,CAAC,EAAE,MAAM,CAAC;IAC/B,qGAAqG;IACrG,iBAAiB,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAClC;;;;;OAKG;IACH,oBAAoB,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACrC,yFAAyF;IACzF,kBAAkB,CAAC,EAAE,OAAO,CAAC;CAC9B;AAED,QAAA,MAAM,oBAAoB,oCAAgB,YAAY,8BAoCpD,CAAC;AAEH,eAAe,oBAAoB,CAAC"}
+{"version":3,"file":"RealTimeRendererNext.d.ts","sourceRoot":"","sources":["../../../../src/RealTimeRendererNext.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAe,MAAM,OAAO,CAAC;AAGpC,OAAO,EAAe,KAAK,YAAY,EAAE,KAAK,SAAS,EAAE,MAAM,SAAS,CAAC;AACzE,OAAO,EAAuB,KAAK,uBAAuB,EAAE,MAAM,sBAAsB,CAAC;AAIzF,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAC;AAClD,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,mBAAmB,CAAC;AAE5D,iGAAiG;AACjG,MAAM,WAAW,cAAc;IAC7B,YAAY,EAAE,MAAM,CAAC;IACrB,GAAG,CAAC,EAAE,MAAM,CAAC;CACd;AAED,MAAM,WAAW,YAAY;IAC3B;;;OAGG;IACH,WAAW,CAAC,EAAE,cAAc,CAAC;IAC7B,mGAAmG;IACnG,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,OAAO,CAAC,EAAE,UAAU,CAAC;IACrB,QAAQ,CAAC,EAAE,IAAI,GAAG,IAAI,CAAC;IACvB,MAAM,EAAE,SAAS,CAAC;IAClB;;;;OAIG;IACH,UAAU,CAAC,EAAE,OAAO,CAAC;IACrB,SAAS,CAAC,EAAE,YAAY,CAAC;IACzB,kBAAkB,CAAC,EAAE,uBAAuB,CAAC;IAC7C,6FAA6F;IAC7F,cAAc,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC/B,2FAA2F;IAC3F,YAAY,CAAC,EAAE,GAAG,CAAC,MAAM,EAAE,kBAAkB,CAAC,CAAC;IAC/C,4FAA4F;IAC5F,WAAW,CAAC,EAAE,OAAO,CAAC;IACtB,gGAAgG;IAChG,iBAAiB,CAAC,EAAE,OAAO,wBAAwB,EAAE,iBAAiB,EAAE,CAAC;IACzE,6FAA6F;IAC7F,oBAAoB,CAAC,EAAE,OAAO,wBAAwB,EAAE,oBAAoB,EAAE,CAAC;IAC/E;;;;;OAKG;IACH,mBAAmB,CAAC,EAAE,MAAM,CAAC;IAC7B,+FAA+F;IAC/F,qBAAqB,CAAC,EAAE,MAAM,CAAC;IAC/B,qGAAqG;IACrG,iBAAiB,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAClC;;;;;OAKG;IACH,oBAAoB,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACrC,yFAAyF;IACzF,kBAAkB,CAAC,EAAE,OAAO,CAAC;CAC9B;AAED,QAAA,MAAM,oBAAoB,oCAAgB,YAAY,8BAoCpD,CAAC;AAEH,eAAe,oBAAoB,CAAC"}

package/build/types/real-time-viewer-next/src/core/SceneRenderer.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"SceneRenderer.d.ts","sourceRoot":"","sources":["../../../../../src/core/SceneRenderer.tsx"],"names":[],"mappings":"AAAA,OAAO,KAA6E,MAAM,OAAO,CAAC;AA4ClG,wBAAgB,aAAa,sBAiQ5B"}
+{"version":3,"file":"SceneRenderer.d.ts","sourceRoot":"","sources":["../../../../../src/core/SceneRenderer.tsx"],"names":[],"mappings":"AAAA,OAAO,KAA6E,MAAM,OAAO,CAAC;AA4ClG,wBAAgB,aAAa,sBAmQ5B"}

package/build/types/real-time-viewer-next/src/core/camera/useMaterialFade.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"useMaterialFade.d.ts","sourceRoot":"","sources":["../../../../../../src/core/camera/useMaterialFade.ts"],"names":[],"mappings":"AAUA,wBAAgB,eAAe;kCAKjB,MAAM;;EAoCnB"}
+{"version":3,"file":"useMaterialFade.d.ts","sourceRoot":"","sources":["../../../../../../src/core/camera/useMaterialFade.ts"],"names":[],"mappings":"AAMA,wBAAgB,eAAe;kCAKjB,MAAM;;EA0CnB"}

package/build/types/real-time-viewer-next/src/core/environment/deckCutout/collectDeckTriangles.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"collectDeckTriangles.d.ts","sourceRoot":"","sources":["../../../../../../../src/core/environment/deckCutout/collectDeckTriangles.ts"],"names":[],"mappings":"AAAA,OAAO,EAAmD,KAAK,QAAQ,EAAE,KAAK,IAAI,EAAE,KAAK,QAAQ,EAAE,MAAM,OAAO,CAAC;AACjH,OAAO,EAA2D,KAAK,QAAQ,EAAE,KAAK,iBAAiB,EAAE,MAAM,+BAA+B,CAAC;AAI/I;;;;;GAKG;AACH,eAAO,MAAM,mBAAmB,QAAQ,CAAC;AAOzC,8EAA8E;AAC9E,MAAM,WAAW,WAAW;IAC1B,QAAQ,EAAE,MAAM,CAAC;IACjB,iCAAiC;IACjC,IAAI,EAAE,MAAM,CAAC;IACb,kGAAkG;IAClG,aAAa,EAAE,MAAM,CAAC;IACtB,0HAA0H;IAC1H,QAAQ,EAAE,QAAQ,GAAG,IAAI,CAAC;IAC1B,yGAAyG;IACzG,SAAS,EAAE,YAAY,GAAG,IAAI,CAAC;IAC/B,aAAa,EAAE,MAAM,CAAC;IACtB;;;;;OAKG;IACH,aAAa,EAAE,iBAAiB,GAAG,IAAI,CAAC;IACxC,iGAAiG;IACjG,aAAa,EAAE,MAAM,CAAC;IACtB,2FAA2F;IAC3F,KAAK,EAAE,QAAQ,GAAG,IAAI,CAAC;IACvB;;;;OAIG;IACH,MAAM,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAA;KAAE,GAAG,IAAI,CAAC;CAC3E;AAED,yFAAyF;AACzF,wBAAgB,cAAc,CAAC,IAAI,EAAE,QAAQ,EAAE,QAAQ,EAAE,MAAM,EAAE,GAAG,IAAI,EAAE,CAOzE;AAkBD;;;;GAIG;AACH,wBAAgB,oBAAoB,CAAC,QAAQ,EAAE,QAAQ,GAAG,QAAQ,EAAE,GAAG,MAAM,CAI5E;AAED;;;;;;;;;GASG;AACH,wBAAgB,oBAAoB,CAClC,MAAM,EAAE,IAAI,EAAE,EACd,SAAS,EAAE,IAAI,EACf,aAAa,EAAE,MAAM,GACpB;IACD,SAAS,EAAE,YAAY,CAAC;IACxB,aAAa,EAAE,MAAM,CAAC;IACtB,yEAAyE;IACzE,MAAM,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAA;KAAE,CAAC;CACpE,GAAG,IAAI,CAoEP;AAED;;;GAGG;AACH,wBAAgB,iBAAiB,CAAC,KAAK,EAAE,QAAQ,EAAE,QAAQ,EAAE,MAAM,EAAE,GAAG;IAAE,SAAS,EAAE,IAAI,GAAG,IAAI,CAAC;IAAC,OAAO,EAAE,WAAW,GAAG,IAAI,CAAA;CAAE,CAyB9H;AAED,oIAAoI;AACpI,wBAAgB,cAAc,CAAC,OAAO,EAAE,WAAW,GAAG,IAAI,GAAG,MAAM,CAElE;AAED,mEAAmE;AACnE,wBAAgB,mBAAmB,CAAC,OAAO,EAAE,WAAW,EAAE,cAAc,EAAE,OAAO,GAAG,MAAM,EAAE,CAoB3F"}
+{"version":3,"file":"collectDeckTriangles.d.ts","sourceRoot":"","sources":["../../../../../../../src/core/environment/deckCutout/collectDeckTriangles.ts"],"names":[],"mappings":"AAAA,OAAO,EAAmD,KAAK,QAAQ,EAAE,KAAK,IAAI,EAAE,KAAK,QAAQ,EAAE,MAAM,OAAO,CAAC;AACjH,OAAO,EAA2D,KAAK,QAAQ,EAAE,KAAK,iBAAiB,EAAE,MAAM,+BAA+B,CAAC;AAK/I;;;;;GAKG;AACH,eAAO,MAAM,mBAAmB,QAAQ,CAAC;AAOzC,8EAA8E;AAC9E,MAAM,WAAW,WAAW;IAC1B,QAAQ,EAAE,MAAM,CAAC;IACjB,iCAAiC;IACjC,IAAI,EAAE,MAAM,CAAC;IACb,kGAAkG;IAClG,aAAa,EAAE,MAAM,CAAC;IACtB,0HAA0H;IAC1H,QAAQ,EAAE,QAAQ,GAAG,IAAI,CAAC;IAC1B,yGAAyG;IACzG,SAAS,EAAE,YAAY,GAAG,IAAI,CAAC;IAC/B,aAAa,EAAE,MAAM,CAAC;IACtB;;;;;OAKG;IACH,aAAa,EAAE,iBAAiB,GAAG,IAAI,CAAC;IACxC,iGAAiG;IACjG,aAAa,EAAE,MAAM,CAAC;IACtB,2FAA2F;IAC3F,KAAK,EAAE,QAAQ,GAAG,IAAI,CAAC;IACvB;;;;OAIG;IACH,MAAM,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAA;KAAE,GAAG,IAAI,CAAC;CAC3E;AAED,yFAAyF;AACzF,wBAAgB,cAAc,CAAC,IAAI,EAAE,QAAQ,EAAE,QAAQ,EAAE,MAAM,EAAE,GAAG,IAAI,EAAE,CAOzE;AAoBD;;;;GAIG;AACH,wBAAgB,oBAAoB,CAAC,QAAQ,EAAE,QAAQ,GAAG,QAAQ,EAAE,GAAG,MAAM,CAI5E;AAED;;;;;;;;;GASG;AACH,wBAAgB,oBAAoB,CAClC,MAAM,EAAE,IAAI,EAAE,EACd,SAAS,EAAE,IAAI,EACf,aAAa,EAAE,MAAM,GACpB;IACD,SAAS,EAAE,YAAY,CAAC;IACxB,aAAa,EAAE,MAAM,CAAC;IACtB,yEAAyE;IACzE,MAAM,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAA;KAAE,CAAC;CACpE,GAAG,IAAI,CAoEP;AAED;;;GAGG;AACH,wBAAgB,iBAAiB,CAAC,KAAK,EAAE,QAAQ,EAAE,QAAQ,EAAE,MAAM,EAAE,GAAG;IAAE,SAAS,EAAE,IAAI,GAAG,IAAI,CAAC;IAAC,OAAO,EAAE,WAAW,GAAG,IAAI,CAAA;CAAE,CAyB9H;AAED,oIAAoI;AACpI,wBAAgB,cAAc,CAAC,OAAO,EAAE,WAAW,GAAG,IAAI,GAAG,MAAM,CAElE;AAED,mEAAmE;AACnE,wBAAgB,mBAAmB,CAAC,OAAO,EAAE,WAAW,EAAE,cAAc,EAAE,OAAO,GAAG,MAAM,EAAE,CAoB3F"}

package/build/types/real-time-viewer-next/src/core/materials/fadeState.d.ts

@@ -0,0 +1,23 @@
+import type { Material } from 'three';
+/** A material's state before a fade started driving it. */
+export interface MaterialFadeOriginal {
+    opacity: number;
+    transparent: boolean;
+}
+/**
+ * The 2D↔3D fade (`useMaterialFade`) drives `opacity` / `transparent` on every mesh material in
+ * the scene, so while it runs a material's live values are transient. The pre-fade state travels
+ * ON the material: `Material.clone()` copies `userData`, so a clone taken mid-fade — the deck
+ * collar sampling the deck, a caustic-receiver patch of a shared article material — carries the
+ * state it has to return to instead of freezing the faded values as its own.
+ */
+export declare function stampFadeOriginal(mat: Material, original: MaterialFadeOriginal): void;
+export declare function readFadeOriginal(mat: Material): MaterialFadeOriginal | null;
+export declare function clearFadeOriginal(mat: Material): void;
+/**
+ * Put a fresh clone back into its source's pre-fade state. A clone that keeps the faded values is
+ * restored TO them when the fade ends (they read as its original) — or, mounted after the fade
+ * already ended, is never restored at all.
+ */
+export declare function adoptPristineFadeState(mat: Material): void;
+//# sourceMappingURL=fadeState.d.ts.map

package/build/types/real-time-viewer-next/src/core/materials/fadeState.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"fadeState.d.ts","sourceRoot":"","sources":["../../../../../../src/core/materials/fadeState.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,OAAO,CAAC;AAEtC,2DAA2D;AAC3D,MAAM,WAAW,oBAAoB;IACnC,OAAO,EAAE,MAAM,CAAC;IAChB,WAAW,EAAE,OAAO,CAAC;CACtB;AAID;;;;;;GAMG;AACH,wBAAgB,iBAAiB,CAAC,GAAG,EAAE,QAAQ,EAAE,QAAQ,EAAE,oBAAoB,GAAG,IAAI,CAErF;AAED,wBAAgB,gBAAgB,CAAC,GAAG,EAAE,QAAQ,GAAG,oBAAoB,GAAG,IAAI,CAI3E;AAED,wBAAgB,iBAAiB,CAAC,GAAG,EAAE,QAAQ,GAAG,IAAI,CAErD;AAED;;;;GAIG;AACH,wBAAgB,sBAAsB,CAAC,GAAG,EAAE,QAAQ,GAAG,IAAI,CAM1D"}

package/build/types/real-time-viewer-next/src/core/materials/fadeState.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=fadeState.test.d.ts.map

package/build/types/real-time-viewer-next/src/core/materials/fadeState.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"fadeState.test.d.ts","sourceRoot":"","sources":["../../../../../../src/core/materials/fadeState.test.ts"],"names":[],"mappings":""}

package/build/types/real-time-viewer-next/src/core/useFrameloopVisibility.d.ts

@@ -3,7 +3,8 @@
  * visibility (pause when invisible) and the profile's `maxFps` cap.
  *
  * Visibility toggles `frameloop` between the env-resolved value and `'never'`
- * on tab hide / window blur.
+ * on tab hide / window blur, and while the host's `stopRender` holds
+ * (`renderStopped`).
  *
  * The FPS cap is gated at the renderer level, not via `frameloop` — we wrap
  * `gl.render` and throttle only the final present:

package/build/types/real-time-viewer-next/src/core/useFrameloopVisibility.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"useFrameloopVisibility.d.ts","sourceRoot":"","sources":["../../../../../src/core/useFrameloopVisibility.tsx"],"names":[],"mappings":"AAQA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA6BG;AACH,wBAAgB,sBAAsB,SA0LrC;AAED;;;GAGG;AACH,wBAAgB,6BAA6B,SAG5C"}
+{"version":3,"file":"useFrameloopVisibility.d.ts","sourceRoot":"","sources":["../../../../../src/core/useFrameloopVisibility.tsx"],"names":[],"mappings":"AAQA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA8BG;AACH,wBAAgB,sBAAsB,SAmMrC;AAED;;;GAGG;AACH,wBAAgB,6BAA6B,SAG5C"}

package/build/types/real-time-viewer-next/src/core/water/CausticReceiver.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"CausticReceiver.d.ts","sourceRoot":"","sources":["../../../../../../src/core/water/CausticReceiver.ts"],"names":[],"mappings":"AA4BA,OAAO,EAAE,oBAAoB,EAAoB,MAAM,OAAO,CAAC;AAE/D,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAC;AAIrD;;;;;GAKG;AACH,QAAA,MAAM,qBAAqB,gCAAgC,CAAC;AAE5D;;;;GAIG;AACH,KAAK,uBAAuB,GAAG,oBAAoB,GAAG;IACpD,CAAC,qBAAqB,CAAC,CAAC,EAAE,IAAI,CAAC;CAChC,CAAC;AAUF;;;;;;;GAOG;AACH,wBAAgB,4BAA4B,CAAC,SAAS,EAAE,OAAO,GAAG,IAAI,CAErE;AAsKD;;;;;;;;GAQG;AACH,wBAAgB,8BAA8B,CAAC,MAAM,EAAE,oBAAoB,EAAE,QAAQ,EAAE,aAAa,GAAG,uBAAuB,CAoE7H;AAED;;;;;GAKG;AACH,wBAAgB,8BAA8B,CAAC,QAAQ,EAAE,oBAAoB,EAAE,QAAQ,EAAE,aAAa,GAAG,IAAI,CAwC5G;AAwBD,mGAAmG;AACnG,wBAAgB,sBAAsB,CAAC,MAAM,EAAE,oBAAoB,EAAE,QAAQ,EAAE,aAAa,GAAG,oBAAoB,CAQlH;AAED,gGAAgG;AAChG,wBAAgB,yBAAyB,IAAI,IAAI,CAGhD;AAED,kGAAkG;AAClG,wBAAgB,sBAAsB,CAAC,MAAM,EAAE,oBAAoB,GAAG,IAAI,CAQzE"}
+{"version":3,"file":"CausticReceiver.d.ts","sourceRoot":"","sources":["../../../../../../src/core/water/CausticReceiver.ts"],"names":[],"mappings":"AA4BA,OAAO,EAAE,oBAAoB,EAAoB,MAAM,OAAO,CAAC;AAE/D,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAC;AAKrD;;;;;GAKG;AACH,QAAA,MAAM,qBAAqB,gCAAgC,CAAC;AAE5D;;;;GAIG;AACH,KAAK,uBAAuB,GAAG,oBAAoB,GAAG;IACpD,CAAC,qBAAqB,CAAC,CAAC,EAAE,IAAI,CAAC;CAChC,CAAC;AAUF;;;;;;;GAOG;AACH,wBAAgB,4BAA4B,CAAC,SAAS,EAAE,OAAO,GAAG,IAAI,CAErE;AAsKD;;;;;;;;GAQG;AACH,wBAAgB,8BAA8B,CAAC,MAAM,EAAE,oBAAoB,EAAE,QAAQ,EAAE,aAAa,GAAG,uBAAuB,CAsE7H;AAED;;;;;GAKG;AACH,wBAAgB,8BAA8B,CAAC,QAAQ,EAAE,oBAAoB,EAAE,QAAQ,EAAE,aAAa,GAAG,IAAI,CAwC5G;AAwBD,mGAAmG;AACnG,wBAAgB,sBAAsB,CAAC,MAAM,EAAE,oBAAoB,EAAE,QAAQ,EAAE,aAAa,GAAG,oBAAoB,CAQlH;AAED,gGAAgG;AAChG,wBAAgB,yBAAyB,IAAI,IAAI,CAGhD;AAED,kGAAkG;AAClG,wBAAgB,sBAAsB,CAAC,MAAM,EAAE,oBAAoB,GAAG,IAAI,CAQzE"}

package/build/types/real-time-viewer-next/src/hooks/useAssembledScene.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"useAssembledScene.d.ts","sourceRoot":"","sources":["../../../../../src/hooks/useAssembledScene.ts"],"names":[],"mappings":"AAEA,OAAO,EAAqB,KAAK,WAAW,EAAE,MAAM,6BAA6B,CAAC;AAKlF,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,yBAAyB,CAAC;AAsB5D,KAAK,mBAAmB,GAAG,IAAI,CAAC,YAAY,EAAE,gBAAgB,GAAG,SAAS,GAAG,QAAQ,GAAG,UAAU,CAAC,CAAC;AAEpG;;;;;;;;;;GAUG;AACH,wBAAgB,iBAAiB,CAAC,EAAE,cAAc,EAAE,kBAAkB,EAAE,OAAO,EAAE,MAAM,EAAE,QAAQ,EAAE,EAAE,mBAAmB,GAAG,WAAW,GAAG,IAAI,CAwF5I"}
+{"version":3,"file":"useAssembledScene.d.ts","sourceRoot":"","sources":["../../../../../src/hooks/useAssembledScene.ts"],"names":[],"mappings":"AAEA,OAAO,EAAqB,KAAK,WAAW,EAAE,MAAM,6BAA6B,CAAC;AAMlF,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,yBAAyB,CAAC;AAsB5D,KAAK,mBAAmB,GAAG,IAAI,CAAC,YAAY,EAAE,gBAAgB,GAAG,SAAS,GAAG,QAAQ,GAAG,UAAU,CAAC,CAAC;AAEpG;;;;;;;;;;GAUG;AACH,wBAAgB,iBAAiB,CAAC,EAAE,cAAc,EAAE,kBAAkB,EAAE,OAAO,EAAE,MAAM,EAAE,QAAQ,EAAE,EAAE,mBAAmB,GAAG,WAAW,GAAG,IAAI,CAuG5I"}

package/build/types/real-time-viewer-next/src/hooks/useHostPropsSync.d.ts

@@ -1,6 +1,6 @@
 import type { RTVNextProps } from '../RealTimeRendererNext';
 type HostConfigProps = Pick<RTVNextProps, 'config' | 'callbacks'>;
-type HostUiProps = Pick<RTVNextProps, 'viewMode' | 'plannerMode' | 'freePlacesOnGrids' | 'plannedPlacesOnGrids' | 'catalogInfo' | 'armedAccessoryCodex' | 'draggedAccessoryCodex' | 'showDimensionLines' | 'focusElementId' | 'elementsInfo' | 'selectedElementId' | 'selectedAccessoryKey' | 'callbacks'>;
+type HostUiProps = Pick<RTVNextProps, 'viewMode' | 'plannerMode' | 'freePlacesOnGrids' | 'plannedPlacesOnGrids' | 'catalogInfo' | 'armedAccessoryCodex' | 'draggedAccessoryCodex' | 'showDimensionLines' | 'focusElementId' | 'elementsInfo' | 'selectedElementId' | 'selectedAccessoryKey' | 'callbacks' | 'stopRender'>;
 /**
  * Installs the host's config + callbacks and kicks off device-tier detection.
  *
@@ -15,6 +15,6 @@ export declare function useHostConfigSync({ config, callbacks }: HostConfigProps
  * controlled-selection setters act on the scene that landed in the store
  * earlier in the same flush.
  */
-export declare function useHostPropsSync({ viewMode, plannerMode, freePlacesOnGrids, plannedPlacesOnGrids, catalogInfo, armedAccessoryCodex, draggedAccessoryCodex, showDimensionLines, focusElementId, elementsInfo, selectedElementId, selectedAccessoryKey, callbacks, }: HostUiProps): void;
+export declare function useHostPropsSync({ viewMode, plannerMode, freePlacesOnGrids, plannedPlacesOnGrids, catalogInfo, armedAccessoryCodex, draggedAccessoryCodex, showDimensionLines, focusElementId, elementsInfo, selectedElementId, selectedAccessoryKey, callbacks, stopRender, }: HostUiProps): void;
 export {};
 //# sourceMappingURL=useHostPropsSync.d.ts.map

package/build/types/real-time-viewer-next/src/hooks/useHostPropsSync.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"useHostPropsSync.d.ts","sourceRoot":"","sources":["../../../../../src/hooks/useHostPropsSync.ts"],"names":[],"mappings":"AAUA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,yBAAyB,CAAC;AAK5D,KAAK,eAAe,GAAG,IAAI,CAAC,YAAY,EAAE,QAAQ,GAAG,WAAW,CAAC,CAAC;AA2BlE,KAAK,WAAW,GAAG,IAAI,CACrB,YAAY,EACV,UAAU,GACV,aAAa,GACb,mBAAmB,GACnB,sBAAsB,GACtB,aAAa,GACb,qBAAqB,GACrB,uBAAuB,GACvB,oBAAoB,GACpB,gBAAgB,GAChB,cAAc,GACd,mBAAmB,GACnB,sBAAsB,GACtB,WAAW,CACd,CAAC;AAEF;;;;;GAKG;AACH,wBAAgB,iBAAiB,CAAC,EAAE,MAAM,EAAE,SAAS,EAAE,EAAE,eAAe,QAsCvE;AAED;;;;;;GAMG;AACH,wBAAgB,gBAAgB,CAAC,EAC/B,QAAQ,EACR,WAAW,EACX,iBAAiB,EACjB,oBAAoB,EACpB,WAAW,EACX,mBAAmB,EACnB,qBAAqB,EACrB,kBAAkB,EAClB,cAAc,EACd,YAAY,EACZ,iBAAiB,EACjB,oBAAoB,EACpB,SAAS,GACV,EAAE,WAAW,QA4Fb"}
+{"version":3,"file":"useHostPropsSync.d.ts","sourceRoot":"","sources":["../../../../../src/hooks/useHostPropsSync.ts"],"names":[],"mappings":"AAUA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,yBAAyB,CAAC;AAK5D,KAAK,eAAe,GAAG,IAAI,CAAC,YAAY,EAAE,QAAQ,GAAG,WAAW,CAAC,CAAC;AA2BlE,KAAK,WAAW,GAAG,IAAI,CACrB,YAAY,EACV,UAAU,GACV,aAAa,GACb,mBAAmB,GACnB,sBAAsB,GACtB,aAAa,GACb,qBAAqB,GACrB,uBAAuB,GACvB,oBAAoB,GACpB,gBAAgB,GAChB,cAAc,GACd,mBAAmB,GACnB,sBAAsB,GACtB,WAAW,GACX,YAAY,CACf,CAAC;AAEF;;;;;GAKG;AACH,wBAAgB,iBAAiB,CAAC,EAAE,MAAM,EAAE,SAAS,EAAE,EAAE,eAAe,QAsCvE;AAED;;;;;;GAMG;AACH,wBAAgB,gBAAgB,CAAC,EAC/B,QAAQ,EACR,WAAW,EACX,iBAAiB,EACjB,oBAAoB,EACpB,WAAW,EACX,mBAAmB,EACnB,qBAAqB,EACrB,kBAAkB,EAClB,cAAc,EACd,YAAY,EACZ,iBAAiB,EACjB,oBAAoB,EACpB,SAAS,EACT,UAAU,GACX,EAAE,WAAW,QAiGb"}

package/build/types/real-time-viewer-next/src/loadingGates.d.ts

@@ -8,9 +8,11 @@ import React, { type ReactNode } from 'react';
 export declare function SceneLoadingDivaBridge(): null;
 /**
  * Hides the whole viewer (the canvas + everything it renders) while the scene
- * loads, so the user never sees a half-built scene pop in. Uses `visibility`
- * (not unmount / `display:none`) so the canvas keeps rendering and the in-flight
- * GLB finishes decoding + fires `endSceneLoad`, which reveals it in place.
+ * loads, so the user never sees a half-built scene pop in, and while the host
+ * has stopped rendering (`stopRender` → `renderStopped`). Uses `visibility`
+ * (not unmount / `display:none`) so the canvas keeps its size and its context:
+ * an in-flight GLB finishes decoding + fires `endSceneLoad`, which reveals it
+ * in place, and a paused viewer resumes without a reboot.
  */
 export declare function SceneVisibilityGate({ children }: {
     children: ReactNode;

package/build/types/real-time-viewer-next/src/loadingGates.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"loadingGates.d.ts","sourceRoot":"","sources":["../../../../src/loadingGates.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,EAAqB,KAAK,SAAS,EAAE,MAAM,OAAO,CAAC;AAOjE;;;;;GAKG;AACH,wBAAgB,sBAAsB,SA6BrC;AAED;;;;;GAKG;AACH,wBAAgB,mBAAmB,CAAC,EAAE,QAAQ,EAAE,EAAE;IAAE,QAAQ,EAAE,SAAS,CAAA;CAAE,qBAGxE;AAED;gFACgF;AAChF,qBAAa,oBAAqB,SAAQ,KAAK,CAAC,SAAS,CAAC;IAAE,QAAQ,EAAE,SAAS,CAAA;CAAE,EAAE;IAAE,MAAM,EAAE,OAAO,CAAA;CAAE,CAAC;IACrG,KAAK;;MAAqB;IAC1B,MAAM,CAAC,wBAAwB;;;IAG/B,iBAAiB;IAGjB,MAAM;CAGP"}
+{"version":3,"file":"loadingGates.d.ts","sourceRoot":"","sources":["../../../../src/loadingGates.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,EAAqB,KAAK,SAAS,EAAE,MAAM,OAAO,CAAC;AAOjE;;;;;GAKG;AACH,wBAAgB,sBAAsB,SA6BrC;AAED;;;;;;;GAOG;AACH,wBAAgB,mBAAmB,CAAC,EAAE,QAAQ,EAAE,EAAE;IAAE,QAAQ,EAAE,SAAS,CAAA;CAAE,qBAIxE;AAED;gFACgF;AAChF,qBAAa,oBAAqB,SAAQ,KAAK,CAAC,SAAS,CAAC;IAAE,QAAQ,EAAE,SAAS,CAAA;CAAE,EAAE;IAAE,MAAM,EAAE,OAAO,CAAA;CAAE,CAAC;IACrG,KAAK;;MAAqB;IAC1B,MAAM,CAAC,wBAAwB;;;IAG/B,iBAAiB;IAGjB,MAAM;CAGP"}

package/build/types/real-time-viewer-next/src/store/slices/glGeneration.d.ts

@@ -16,6 +16,13 @@ export interface GLGenerationSlice {
     /** True between context lost and restored — the frameloop controller pauses while set. */
     glContextLost: boolean;
     setGLContextLost: (lost: boolean) => void;
+    /**
+     * Host `stopRender`: the viewer stays mounted with its scene and WebGL context, the frameloop
+     * pauses (`useFrameloopVisibility`) and `SceneVisibilityGate` hides the stage. A capture or a
+     * scene load in flight still gets frames — both need them to finish, and someone waits on them.
+     */
+    renderStopped: boolean;
+    setRenderStopped: (stopped: boolean) => void;
     /** Breaker: repeated losses in a short window swap the viewer to the error page instead of remount-thrash. */
     glContextLossLoop: boolean;
     /** Called from the `webglcontextrestored` handler; trips {@link glContextLossLoop} on repeats. */