@crystaldesign/real-time-viewer-next 26.12.0-rc.0 → 26.12.0-rc.2

package/build/esm/{DeckCutoutSubsystem-6453a4f4.js → DeckCutoutSubsystem-8b702df0.js}

@@ -1,11 +1,11 @@
-import { p as parseElementKey, u as useStableEnvSlice, a as useRTVStore, b as bootPhase, c as adoptPristineFadeState, D as DECK_COLLAR_LOAD_ID } from './index-428fd8ca.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-6f58b1ed.js';
 import { useRef, useEffect, useMemo, useState, useCallback } from 'react';
 import _slicedToArray from '@babel/runtime/helpers/slicedToArray';
 import _defineProperty from '@babel/runtime/helpers/defineProperty';
 import { useThree, useFrame } from '@react-three/fiber';
 import { getLogger } from '@crystaldesign/diva-core';
-import { Box3, Matrix4, Vector3, Matrix3, MeshStandardMaterial, Shape, Path, ExtrudeGeometry, BufferAttribute, TextureLoader, SRGBColorSpace, RepeatWrapping } from 'three';
 import _toConsumableArray from '@babel/runtime/helpers/toConsumableArray';
+import { Box3, Matrix4, Vector3, Matrix3, MeshStandardMaterial, Shape, Path, ExtrudeGeometry, BufferAttribute, TextureLoader, SRGBColorSpace, RepeatWrapping } from 'three';
 import { jsx, jsxs, Fragment } from 'react/jsx-runtime';
 import '@babel/runtime/helpers/asyncToGenerator';
 import '@babel/runtime/regenerator';
@@ -34,6 +34,64 @@ import '@react-three/postprocessing';
 import '@babel/runtime/helpers/construct';
 import 'detect-gpu';
 
+/**
+ * How a catalog names a geo. Assembled geo nodes are called `` `${nodePath}/geo:${assetId}:${i}` `` —
+ * a runtime path no catalog can be authored against — so a selector is translated by the resolver
+ * instead (geo name → asset ids → nodes).
+ */
+
+/**
+ * Resolve a {@link GeoSelector} to scene nodes.
+ *
+ * Assembled geo nodes are named `` `${nodePath}/geo:${assetId}:${i}` `` (see `SceneTree`), i.e. a
+ * runtime path carrying an asset id — nothing a catalog can be authored against. A selector names
+ * the geo the way a catalog does (`GeoAsset.name`, e.g. `GEO_GRIFF_L`) and this translates:
+ * name → asset ids → nodes.
+ */
+function resolveGeoNodes(root, geoAssets, selector) {
+  if ('nodeName' in selector) {
+    var node = root.getObjectByName(selector.nodeName);
+    return node ? [node] : [];
+  }
+  var matchesName = geoNameMatcher(selector);
+  if (!matchesName) return [];
+  var assetIds = geoAssets.filter(function (a) {
+    return matchesName(a.name);
+  }).map(function (a) {
+    return a.id;
+  });
+  if (assetIds.length === 0) return [];
+  var markers = assetIds.map(function (id) {
+    return "/geo:".concat(id, ":");
+  });
+  var all = [];
+  root.traverse(function (obj) {
+    if (obj.name && markers.some(function (m) {
+      return obj.name.includes(m);
+    })) all.push(obj);
+  });
+  return all;
+}
+
+/** The catalog-name test of a name-based selector; null when it names nothing. */
+function geoNameMatcher(selector) {
+  if ('geoNamePrefix' in selector) {
+    var prefix = selector.geoNamePrefix;
+    return prefix ? function (name) {
+      return name.startsWith(prefix);
+    } : null;
+  }
+  var geoName = selector.geoName;
+  return geoName ? function (name) {
+    return name === geoName;
+  } : null;
+}
+
+function ownKeys$1(e, r) { var t = Object.keys(e); if (Object.getOwnPropertySymbols) { var o = Object.getOwnPropertySymbols(e); r && (o = o.filter(function (r) { return Object.getOwnPropertyDescriptor(e, r).enumerable; })), t.push.apply(t, o); } return t; }
+function _objectSpread$1(e) { for (var r = 1; r < arguments.length; r++) { var t = null != arguments[r] ? arguments[r] : {}; r % 2 ? ownKeys$1(Object(t), !0).forEach(function (r) { _defineProperty(e, r, t[r]); }) : Object.getOwnPropertyDescriptors ? Object.defineProperties(e, Object.getOwnPropertyDescriptors(t)) : ownKeys$1(Object(t)).forEach(function (r) { Object.defineProperty(e, r, Object.getOwnPropertyDescriptor(t, r)); }); } return e; }
+function _createForOfIteratorHelper$8(r, e) { var t = "undefined" != typeof Symbol && r[Symbol.iterator] || r["@@iterator"]; if (!t) { if (Array.isArray(r) || (t = _unsupportedIterableToArray$8(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$8(r, a) { if (r) { if ("string" == typeof r) return _arrayLikeToArray$8(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$8(r, a) : void 0; } }
+function _arrayLikeToArray$8(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; }
 var ELEMENT_PREFIX = 'Element#';
 var _elementBox = new Box3();
 var _unionBox = new Box3();
@@ -136,6 +194,132 @@ function measureArticle(scene, patterns, elementsInfo) {
   };
 }
 
+/**
+ * The measurement narrowed to the article's geos whose catalog name starts with one of the
+ * comma-separated `geoPrefix`es: the rect, the bottom and the traced outline then describe only those
+ * parts — the basin, not the stairs or cover that come with the same article. The elements still move
+ * as a whole; only what is measured changes. Falls back to the whole article, with a note in
+ * `geoScope`, when no geo matches.
+ */
+function restrictToGeos(measurement, geoPrefix, geoAssets) {
+  var prefixes = geoPrefix.split(',').map(function (p) {
+    return p.trim();
+  }).filter(function (p) {
+    return p.length > 0;
+  });
+  if (prefixes.length === 0) return measurement;
+  var nodes = new Set();
+  var _iterator = _createForOfIteratorHelper$8(topLevelElements(measurement.elementObjects)),
+    _step;
+  try {
+    for (_iterator.s(); !(_step = _iterator.n()).done;) {
+      var element = _step.value;
+      var _iterator3 = _createForOfIteratorHelper$8(prefixes),
+        _step3;
+      try {
+        for (_iterator3.s(); !(_step3 = _iterator3.n()).done;) {
+          var prefix = _step3.value;
+          var _iterator4 = _createForOfIteratorHelper$8(resolveGeoNodes(element, geoAssets, {
+              geoNamePrefix: prefix
+            })),
+            _step4;
+          try {
+            for (_iterator4.s(); !(_step4 = _iterator4.n()).done;) {
+              var node = _step4.value;
+              nodes.add(node);
+            }
+          } catch (err) {
+            _iterator4.e(err);
+          } finally {
+            _iterator4.f();
+          }
+        }
+      } catch (err) {
+        _iterator3.e(err);
+      } finally {
+        _iterator3.f();
+      }
+    }
+  } catch (err) {
+    _iterator.e(err);
+  } finally {
+    _iterator.f();
+  }
+  _unionBox.makeEmpty();
+  var _iterator2 = _createForOfIteratorHelper$8(nodes),
+    _step2;
+  try {
+    for (_iterator2.s(); !(_step2 = _iterator2.n()).done;) {
+      var _node = _step2.value;
+      _elementBox.setFromObject(_node);
+      if (!_elementBox.isEmpty()) _unionBox.union(_elementBox);
+    }
+  } catch (err) {
+    _iterator2.e(err);
+  } finally {
+    _iterator2.f();
+  }
+  if (_unionBox.isEmpty()) {
+    return _objectSpread$1(_objectSpread$1({}, measurement), {}, {
+      geoScope: "geos ".concat(geoPrefix, ": NONE matched \u2014 ").concat(describeArticleGeos(measurement, prefixes, geoAssets), " \u2014 measured the whole article")
+    });
+  }
+  var worldBottomY = _unionBox.min.y;
+  _unionBox.applyMatrix4(measurement.floorLocal);
+  return _objectSpread$1(_objectSpread$1({}, measurement), {}, {
+    rect: {
+      minX: _unionBox.min.x,
+      maxX: _unionBox.max.x,
+      minY: _unionBox.min.y,
+      maxY: _unionBox.max.y,
+      minZ: _unionBox.min.z,
+      maxZ: _unionBox.max.z
+    },
+    worldBottomY: worldBottomY,
+    shapeNodes: _toConsumableArray(nodes),
+    geoScope: "geos ".concat(geoPrefix, ": ").concat(nodes.size, " node(s) [").concat(_toConsumableArray(new Set(_toConsumableArray(nodes).map(function (n) {
+      return geoAssetName(n, geoAssets);
+    }))).join(', '), "]")
+  });
+}
+var GEO_NODE_ID = /\/geo:(.+):\d+$/;
+
+/** Catalog geo name of an assembled geo node (`…/geo:<assetId>:<i>`), or the raw node name. */
+function geoAssetName(node, geoAssets) {
+  var _GEO_NODE_ID$exec, _geoAssets$find$name, _geoAssets$find;
+  var id = (_GEO_NODE_ID$exec = GEO_NODE_ID.exec(node.name)) === null || _GEO_NODE_ID$exec === void 0 ? void 0 : _GEO_NODE_ID$exec[1];
+  return (_geoAssets$find$name = (_geoAssets$find = geoAssets.find(function (a) {
+    return a.id === id;
+  })) === null || _geoAssets$find === void 0 ? void 0 : _geoAssets$find.name) !== null && _geoAssets$find$name !== void 0 ? _geoAssets$find$name : node.name;
+}
+
+/**
+ * Why a prefix matched nothing: the geo names the article actually carries, and whether a mesh INSIDE
+ * one of them carries the prefix instead — a name from the GLB, which the prefix is not matched against.
+ */
+function describeArticleGeos(measurement, prefixes, geoAssets) {
+  var geoNames = new Set();
+  var innerMatches = new Set();
+  var _iterator5 = _createForOfIteratorHelper$8(topLevelElements(measurement.elementObjects)),
+    _step5;
+  try {
+    for (_iterator5.s(); !(_step5 = _iterator5.n()).done;) {
+      var element = _step5.value;
+      element.traverse(function (obj) {
+        if (GEO_NODE_ID.test(obj.name)) geoNames.add(geoAssetName(obj, geoAssets));else if (prefixes.some(function (p) {
+          return obj.name.startsWith(p);
+        })) innerMatches.add(obj.name);
+      });
+    }
+  } catch (err) {
+    _iterator5.e(err);
+  } finally {
+    _iterator5.f();
+  }
+  var inner = innerMatches.size > 0 ? " | but GLB-internal nodes match: [".concat(_toConsumableArray(innerMatches).slice(0, 10).join(', '), "]") : '';
+  return "article geos: [".concat(_toConsumableArray(geoNames).join(', '), "]").concat(inner);
+}
+
 function _createForOfIteratorHelper$7(r, e) { var t = "undefined" != typeof Symbol && r[Symbol.iterator] || r["@@iterator"]; if (!t) { if (Array.isArray(r) || (t = _unsupportedIterableToArray$7(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$7(r, a) { if (r) { if ("string" == typeof r) return _arrayLikeToArray$7(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$7(r, a) : void 0; } }
 function _arrayLikeToArray$7(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; }
@@ -895,7 +1079,8 @@ function traceArticleFootprint(elements, floorLocal, rect, minLocalY, offset, di
         var pos = mesh.geometry.getAttribute('position');
         if (!pos) return;
         meshes.push(mesh);
-        sigParts.push("".concat(mesh.name, ":").concat(pos.count));
+        // Identity, not name: names can be empty, and a geoPrefix switch between equal-sized geos must re-trace.
+        sigParts.push("".concat(mesh.uuid, "/").concat(mesh.geometry.uuid, ":").concat(pos.count));
       });
     }
   } catch (err) {
@@ -1013,7 +1198,7 @@ function traceArticleFootprint(elements, floorLocal, rect, minLocalY, offset, di
  * without such a rule the deck's authored hole stays fully open.
  */
 function deriveArticleFootprint(measurement, rule, margin, cache) {
-  var _result$points$length, _result$points;
+  var _measurement$shapeNod, _result$points$length, _result$points;
   var pendingLiftY = arguments.length > 4 && arguments[4] !== undefined ? arguments[4] : 0;
   var result = {
     points: null,
@@ -1031,7 +1216,7 @@ function deriveArticleFootprint(measurement, rule, margin, cache) {
     elementObjects = measurement.elementObjects;
   var rawSizeX = rect.maxX - rect.minX;
   var rawSizeZ = rect.maxZ - rect.minZ;
-  var traced = traceArticleFootprint(topLevelElements(elementObjects), floorLocal, rect, floorTopY - rule.footprintSliceDepth, margin, result.trace, cache, pendingLiftY);
+  var traced = traceArticleFootprint((_measurement$shapeNod = measurement.shapeNodes) !== null && _measurement$shapeNod !== void 0 ? _measurement$shapeNod : topLevelElements(elementObjects), floorLocal, rect, floorTopY - rule.footprintSliceDepth, margin, result.trace, cache, pendingLiftY);
   var minX = Infinity;
   var maxX = -Infinity;
   var minZ = Infinity;
@@ -1233,7 +1418,7 @@ function _arrayLikeToArray$2(r, a) { (null == a || a > r.length) && (a = r.lengt
  * `message` is lazy — composed only when the key moved.
  */
 function measureLog(_ref) {
-  var _rule$match, _points$length, _fpBounds$map$join;
+  var _rule$match, _measurement$geoScope, _points$length, _fpBounds$map$join;
   var measurement = _ref.measurement,
     rule = _ref.rule,
     primaryCodex = _ref.primaryCodex,
@@ -1266,7 +1451,7 @@ function measureLog(_ref) {
     }
   }
   var fpBounds = points ? [fpMinX, fpMaxX, fpMinZ, fpMaxZ] : null;
-  var key = "".concat(primaryCodex !== null && primaryCodex !== void 0 ? primaryCodex : '', "|").concat((_rule$match = rule === null || rule === void 0 ? void 0 : rule.match) !== null && _rule$match !== void 0 ? _rule$match : '', "|").concat(footprint.sampledCount, "|").concat((_points$length = points === null || points === void 0 ? void 0 : points.length) !== null && _points$length !== void 0 ? _points$length : 0, "|").concat((_fpBounds$map$join = fpBounds === null || fpBounds === void 0 ? void 0 : fpBounds.map(function (v) {
+  var key = "".concat(primaryCodex !== null && primaryCodex !== void 0 ? primaryCodex : '', "|").concat((_rule$match = rule === null || rule === void 0 ? void 0 : rule.match) !== null && _rule$match !== void 0 ? _rule$match : '', "|").concat((_measurement$geoScope = measurement.geoScope) !== null && _measurement$geoScope !== void 0 ? _measurement$geoScope : '', "|").concat(footprint.sampledCount, "|").concat((_points$length = points === null || points === void 0 ? void 0 : points.length) !== null && _points$length !== void 0 ? _points$length : 0, "|").concat((_fpBounds$map$join = fpBounds === null || fpBounds === void 0 ? void 0 : fpBounds.map(function (v) {
     return v.toFixed(2);
   }).join(',')) !== null && _fpBounds$map$join !== void 0 ? _fpBounds$map$join : '');
   var message = function message() {
@@ -1290,7 +1475,8 @@ function measureLog(_ref) {
     } else {
       fpInfo = " | ".concat(footprint.source, " produced NO usable outline (").concat(footprint.sampledCount, " pts)").concat(footprint.repairNote, " \u2192 NO COLLAR, the authored hole stays fully open");
     }
-    return "[DeckCutout] article codex: ".concat(primaryCodex !== null && primaryCodex !== void 0 ? primaryCodex : '(unknown)', " \u2192 rule: ").concat(rule ? "'".concat(rule.match, "'") : '(none — articleSync globals)').concat(sliceInfo).concat(fpInfo);
+    var scope = measurement.geoScope ? " | ".concat(measurement.geoScope) : '';
+    return "[DeckCutout] article codex: ".concat(primaryCodex !== null && primaryCodex !== void 0 ? primaryCodex : '(unknown)', " \u2192 rule: ").concat(rule ? "'".concat(rule.match, "'") : '(none — articleSync globals)').concat(scope).concat(sliceInfo).concat(fpInfo);
   };
   return {
     key: key,
@@ -1355,6 +1541,8 @@ function DeckCutoutArticleSync() {
   var footprintMarkedRef = useRef(false);
   // One-shot codex/rule log: fires only when the measured codex or matched rule changes.
   var matchLogRef = useRef(null);
+  // One-shot height log: fires only when the measured tops, the deck or the pending lift change.
+  var heightLogRef = useRef(null);
   var geometryCacheRef = useRef(null);
   // Settle tracking: measure every frame while the pipeline is still changing.
   var settlingRef = useRef(false);
@@ -1415,6 +1603,7 @@ function DeckCutoutArticleSync() {
     stableMeasuresRef.current = 0;
   }, [articleVersion, decorVersion, active]);
   useFrame(function () {
+    var _useRTVStore$getState, _useRTVStore$getState2, _measured$geoScope;
     if (!active || patterns.length === 0) return;
     frameRef.current += 1;
     // While unsettled, measure EVERY frame: the pipeline converges by
@@ -1451,21 +1640,29 @@ function DeckCutoutArticleSync() {
       if (stableMeasuresRef.current >= SETTLE_STABLE_MEASURES) settlingRef.current = false;
     };
     measureCountRef.current += 1;
-    var measured = measureArticle(scene, patterns, useRTVStore.getState().elementsInfo);
-    if (!measured) {
+    var article = measureArticle(scene, patterns, useRTVStore.getState().elementsInfo);
+    if (!article) {
       setWaterOverride(null);
       setFootprintOverride(null);
       finishMeasure(true);
       return;
     }
-    var _pickArticleRule = pickArticleRule(deform.articleRules, measured.codexesByArea),
+    var _pickArticleRule = pickArticleRule(deform.articleRules, article.codexesByArea),
       rule = _pickArticleRule.rule,
       primaryCodex = _pickArticleRule.primaryCodex;
+    // A rule naming a `geoPrefix` measures only those geos — the basin, not the stairs or cover the
+    // same article ships with — so outline, rim, anchor and water all follow the basin alone.
+    var measured = rule !== null && rule !== void 0 && rule.geoPrefix ? restrictToGeos(article, rule.geoPrefix, (_useRTVStore$getState = (_useRTVStore$getState2 = useRTVStore.getState().scene) === null || _useRTVStore$getState2 === void 0 ? void 0 : _useRTVStore$getState2.geoAssets) !== null && _useRTVStore$getState !== void 0 ? _useRTVStore$getState : []) : article;
     // The anchor's lift changes what clears the slice plane and used to force a second full trace
     // per article load. It is fully determined here (same formula as `deriveElementAnchor`), so
     // the first trace evaluates the article at its post-lift height directly.
     var anchorCfg = deform.elementAnchor;
     var pendingLiftY = anchorActive ? (anchorCfg.alignTopToDeck ? measured.floorTopY - measured.rect.maxY : 0) + anchorCfg.offsetY : 0;
+    var heightLog = "[DeckCutout:height] top (floor-local): whole article ".concat(article.rect.maxY.toFixed(3), " | measured ").concat(measured.rect.maxY.toFixed(3)) + " (".concat((_measured$geoScope = measured.geoScope) !== null && _measured$geoScope !== void 0 ? _measured$geoScope : 'whole article', ") | rule ").concat(rule ? "'".concat(rule.match, "' geoPrefix '").concat(rule.geoPrefix, "'") : 'NONE matched') + " | deck top ".concat(measured.floorTopY.toFixed(3)) + " | pending lift ".concat(pendingLiftY.toFixed(3), " | anchor ").concat(anchorActive ? 'on' : 'OFF', ", alignTopToDeck ").concat(anchorCfg.alignTopToDeck, ", offsetY ").concat(anchorCfg.offsetY);
+    if (heightLogRef.current !== heightLog) {
+      heightLogRef.current = heightLog;
+      LOG$2.debug(heightLog);
+    }
     var traced = deriveArticleFootprint(measured, rule, deform.articleSync.margin, geometryCacheRef, pendingLiftY);
     var rect = traced.rim ? _objectSpread(_objectSpread({}, measured.rect), traced.rim) : measured.rect;
     var log = measureLog({

package/build/esm/{SunLensflare-46fa6ee8.js → SunLensflare-0676ae6e.js}

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

package/build/esm/{WaterSurface-10a28566.js → WaterSurface-f3e878b1.js}

@@ -1,5 +1,5 @@
 import _slicedToArray from '@babel/runtime/helpers/slicedToArray';
-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-428fd8ca.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-6f58b1ed.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';
@@ -1931,9 +1931,10 @@ function WaterSurfaceRenderer(_ref) {
       }
 
       // Receiving geometry is article AND deck, so either version invalidates
-      // the height map and the refraction capture.
+      // the height map and the refraction capture — and the article's settled
+      // placement, since the deck anchor moves it after its geos mount.
       var store = useRTVStore.getState();
-      var geometryVersion = store.articleVersion + store.decorVersion;
+      var geometryVersion = store.articleVersion + store.articleSettledVersion + store.decorVersion;
 
       // Keep the height map current and bind it to the caustics pass. The water
       // group is excluded — none of its meshes are receiving geometry.