@pascal-app/viewer 0.9.2 → 1.0.0-beta.2

package/README.md

@@ -5,19 +5,19 @@
 ## Installation
 
 ```bash
-npm install @pascal-app/viewer @pascal-app/core
+npm install @pascal-app/core @pascal-app/viewer @pascal-app/editor @pascal-app/nodes
 ```
 
 ## Peer Dependencies
 
 ```bash
-npm install react three @react-three/fiber @react-three/drei
+npm install next react react-dom three @react-three/fiber @react-three/drei lucide-react zustand
 ```
 
 ## What's Included
 
 - **Viewer Component** - WebGPU-powered 3D viewer with camera controls
-- **Node Renderers** - React Three Fiber components for all node types
+- **Node Rendering Runtime** - Registry-driven dispatch for node renderers supplied by `@pascal-app/nodes`
 - **Post-Processing** - SSGI (ambient occlusion + global illumination), TRAA (anti-aliasing), outline effects
 - **Level System** - Level visibility and positioning (stacked/exploded/solo modes)
 - **Wall Cutout System** - Dynamic wall hiding based on camera position
@@ -26,10 +26,22 @@ npm install react three @react-three/fiber @react-three/drei
 ## Usage
 
 ```typescript
-import { Viewer, useViewer } from '@pascal-app/viewer'
-import { useScene } from '@pascal-app/core'
+import { loadPlugin } from '@pascal-app/core'
+import { builtinPlugin } from '@pascal-app/nodes'
+import { Viewer } from '@pascal-app/viewer'
+import { useEffect, useState } from 'react'
+
+const registryReady = loadPlugin(builtinPlugin)
 
 function App() {
+  const [ready, setReady] = useState(false)
+
+  useEffect(() => {
+    void registryReady.then(() => setReady(true))
+  }, [])
+
+  if (!ready) return null
+
   return (
     <div style={{ width: '100vw', height: '100vh' }}>
       <Viewer />
@@ -38,6 +50,9 @@ function App() {
 }
 ```
 
+Load the built-in plugin once, before mounting any viewer. Without it, the registry has no node
+definitions and scene nodes cannot render. Host-provided plugins use the same `loadPlugin` API.
+
 ## Custom Camera Controls
 
 ```typescript

package/dist/components/viewer/frame-limiter.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"frame-limiter.d.ts","sourceRoot":"","sources":["../../../src/components/viewer/frame-limiter.tsx"],"names":[],"mappings":"AAIA,KAAK,iBAAiB,GAAG;IACvB,GAAG,CAAC,EAAE,MAAM,CAAA;CACb,CAAA;AAgBD,QAAA,MAAM,YAAY,EAAE,KAAK,CAAC,EAAE,CAAC,iBAAiB,CAuD7C,CAAA;AAED,eAAe,YAAY,CAAA"}
+{"version":3,"file":"frame-limiter.d.ts","sourceRoot":"","sources":["../../../src/components/viewer/frame-limiter.tsx"],"names":[],"mappings":"AAIA,KAAK,iBAAiB,GAAG;IACvB,GAAG,CAAC,EAAE,MAAM,CAAA;CACb,CAAA;AAgBD,QAAA,MAAM,YAAY,EAAE,KAAK,CAAC,EAAE,CAAC,iBAAiB,CAyE7C,CAAA;AAED,eAAe,YAAY,CAAA"}

package/dist/components/viewer/frame-limiter.js

@@ -28,13 +28,16 @@ const FrameLimiter = ({ fps = 50 }) => {
         let timer = null;
         let sizeSynced = false;
         const interval = 1000 / fps;
+        function syncSize() {
+            if (sizeSynced)
+                return;
+            renderer.setPixelRatio(dpr);
+            renderer.setSize(size.width, size.height, false);
+            sizeSynced = true;
+        }
         function tick(t) {
             raf = requestAnimationFrame(tick);
-            if (!sizeSynced) {
-                renderer.setPixelRatio(dpr);
-                renderer.setSize(size.width, size.height, false);
-                sizeSynced = true;
-            }
+            syncSize();
             elapsed = t - then;
             if (elapsed > interval) {
                 advance(i);
@@ -42,6 +45,15 @@ const FrameLimiter = ({ fps = 50 }) => {
                 then = t - (elapsed % interval);
             }
         }
+        function kick() {
+            syncSize();
+            i += 1 / 1000;
+            advance(i);
+        }
+        function onVisibilityChange() {
+            if (document.visibilityState === 'visible')
+                kick();
+        }
         // Set frameloop to never, it will shut down the default render loop
         set({ frameloop: 'never' });
         if (DRAW_DISABLED) {
@@ -53,6 +65,11 @@ const FrameLimiter = ({ fps = 50 }) => {
         else {
             // Kick off custom render loop
             raf = requestAnimationFrame(tick);
+            // rAF can stall while a tab is hidden, unfocused, or occluded. With the
+            // default loop disabled, force one current frame as soon as it resumes.
+            document.addEventListener('visibilitychange', onVisibilityChange);
+            window.addEventListener('focus', kick);
+            window.addEventListener('pageshow', kick);
         }
         // Restore initial setting
         return () => {
@@ -62,6 +79,9 @@ const FrameLimiter = ({ fps = 50 }) => {
             if (timer) {
                 clearInterval(timer);
             }
+            document.removeEventListener('visibilitychange', onVisibilityChange);
+            window.removeEventListener('focus', kick);
+            window.removeEventListener('pageshow', kick);
             set({ frameloop: initFrameloop });
         };
     }, [advance, dpr, fps, initFrameloop, renderPaused, renderer, set, size.height, size.width]);

package/dist/components/viewer/glb-scene.js

@@ -421,7 +421,7 @@ export function GlbScene({ url, interactiveItems, referenceNodes, replaceNodes,
         }
         else {
             bookmarkNode = rootNode;
-            _camBox.setFromObject(gltf.scene);
+            _camBox.setFromObject(rootNode ?? gltf.scene);
         }
         const bookmark = bookmarkNode?.userData?.camera;
         if (bookmark) {
@@ -781,7 +781,7 @@ export function GlbScene({ url, interactiveItems, referenceNodes, replaceNodes,
         }
     });
     // E or click activates the openable in view. The click also re-locks the
-    // pointer via WalkthroughControls — harmless overlap; no selection happens.
+    // pointer through the walkthrough controller; no selection happens.
     const activateWalkDoor = useCallback(() => {
         if (walkDoorRef.current)
             toggleOpenable(walkDoorRef.current);

package/dist/components/viewer/glb-walkthrough-controller.d.ts

@@ -1,3 +1,13 @@
+export declare const WALKTHROUGH_FOV = 60;
+export declare const STAND_CAPSULE: [number, number, number, number];
+export declare const CROUCH_CAPSULE: [number, number, number, number];
+export declare const STAND_FLOAT_HEIGHT = 0.5;
+export declare const CROUCH_FLOAT_HEIGHT = 0.25;
+export declare const CROUCH_EYE_OFFSET = 0.1;
+export declare const CROUCH_WALK_SPEED = 1;
+export declare const CROUCH_RUN_SPEED = 1.4;
+export declare const STAND_CLEARANCE = 1.25;
+export declare const EYE_LERP_SPEED = 12;
 /**
  * First-person walkthrough controller for the baked GLB. Reuses the editor's
  * `BVHEcctrl` capsule character controller (gravity, jump, sprint, ground-float,

package/dist/components/viewer/glb-walkthrough-controller.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"glb-walkthrough-controller.d.ts","sourceRoot":"","sources":["../../../src/components/viewer/glb-walkthrough-controller.tsx"],"names":[],"mappings":"AAgOA;;;;;;;GAOG;AACH,wBAAgB,wBAAwB,CAAC,EAAE,GAAG,EAAE,EAAE;IAAE,GAAG,EAAE,MAAM,CAAA;CAAE,sCAyLhE"}
+{"version":3,"file":"glb-walkthrough-controller.d.ts","sourceRoot":"","sources":["../../../src/components/viewer/glb-walkthrough-controller.tsx"],"names":[],"mappings":"AAiCA,eAAO,MAAM,eAAe,KAAK,CAAA;AAkBjC,eAAO,MAAM,aAAa,EAAE,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,CAAqB,CAAA;AAChF,eAAO,MAAM,cAAc,EAAE,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,CAAqB,CAAA;AACjF,eAAO,MAAM,kBAAkB,MAAM,CAAA;AACrC,eAAO,MAAM,mBAAmB,OAAO,CAAA;AACvC,eAAO,MAAM,iBAAiB,MAAM,CAAA;AACpC,eAAO,MAAM,iBAAiB,IAAI,CAAA;AAClC,eAAO,MAAM,gBAAgB,MAAM,CAAA;AAInC,eAAO,MAAM,eAAe,OAAO,CAAA;AACnC,eAAO,MAAM,cAAc,KAAK,CAAA;AA8LhC;;;;;;;GAOG;AACH,wBAAgB,wBAAwB,CAAC,EAAE,GAAG,EAAE,EAAE;IAAE,GAAG,EAAE,MAAM,CAAA;CAAE,sCAqPhE"}

package/dist/components/viewer/glb-walkthrough-controller.js

@@ -3,14 +3,18 @@ import { jsx as _jsx } from "react/jsx-runtime";
 import { KeyboardControls } from '@react-three/drei';
 import { useFrame, useThree } from '@react-three/fiber';
 import { useCallback, useEffect, useRef, useState } from 'react';
-import { Box3, BoxGeometry, BufferGeometry, Euler, Float32BufferAttribute, Matrix4, Mesh, MeshBasicMaterial, Quaternion, Vector3, } from 'three';
+import { Box3, BoxGeometry, BufferGeometry, Euler, Float32BufferAttribute, Matrix4, Mesh, MeshBasicMaterial, Quaternion, Raycaster, Vector3, } from 'three';
 import { mergeGeometries } from 'three/examples/jsm/utils/BufferGeometryUtils.js';
 import { acceleratedRaycast, computeBoundsTree, disposeBoundsTree } from 'three-mesh-bvh';
 import { useGLTFKTX2 } from '../../hooks/use-gltf-ktx2';
 import { SCENE_LAYER } from '../../lib/layers';
 import useViewer from '../../store/use-viewer';
 import BVHEcctrl, {} from './bvh-ecctrl';
-import { WALKTHROUGH_FOV } from './walkthrough-controls';
+// First-person FOV. The orbit camera is 50° (set on the Canvas), which feels
+// cramped on foot; ~60° vertical (~90° horizontal at 16:9) restores peripheral
+// awareness without wide-angle distortion. Applied only while walking — both
+// walkthrough controllers read this and restore the orbit FOV on exit.
+export const WALKTHROUGH_FOV = 60;
 // Eye/capsule geometry mirrors the editor's first-person controller so the
 // baked walkthrough feels identical. The capsule centre sits below the eye; the
 // camera rides the capsule with a small offset and the controller floats it to
@@ -20,6 +24,26 @@ const CONTROLLER_CENTER_FROM_EYE = 0.85;
 const SPAWN_EYE_HEIGHT = 1.65;
 const LOOK_SENSITIVITY = 0.002;
 const VOID_FALL_RESPAWN_DEPTH = 12;
+// Crouch (hold Ctrl): swap to a short capsule — it shrinks around the centre,
+// so a crouch mid-jump also lowers the head AND raises the feet, letting the
+// player thread window openings. Standing back up is gated on headroom.
+// The float gap counts toward the effective obstacle height (the capsule rides
+// floatHeight above the ground), so crouching also lowers it: crouched span is
+// CROUCH_FLOAT_HEIGHT + capsule = 0.25 + 0.7 = 0.95 m — fits a 1 m opening.
+export const STAND_CAPSULE = [0.25, 0.8, 4, 8];
+export const CROUCH_CAPSULE = [0.25, 0.2, 4, 8];
+export const STAND_FLOAT_HEIGHT = 0.5;
+export const CROUCH_FLOAT_HEIGHT = 0.25;
+export const CROUCH_EYE_OFFSET = 0.1;
+export const CROUCH_WALK_SPEED = 1;
+export const CROUCH_RUN_SPEED = 1.4;
+// Headroom (from the capsule centre, upward) required before uncrouching:
+// standing raises the centre by half the length delta plus the float delta,
+// and the standing capsule top sits standLength/2 + radius above the centre.
+export const STAND_CLEARANCE = 1.25;
+export const EYE_LERP_SPEED = 12;
+const standClearanceRaycaster = new Raycaster();
+const UP = new Vector3(0, 1, 0);
 // Kinds that must not block the player: room helpers, the spawn marker, the
 // ceiling/roof shell (you walk under them), and door/window leaves — excluding
 // the latter lets you pass any doorway whether the leaf is open or shut (the
@@ -34,7 +58,7 @@ const keyboardMap = [
     { name: 'jump', keys: ['Space'] },
     { name: 'run', keys: ['ShiftLeft', 'ShiftRight'] },
 ];
-const cameraOffset = new Vector3(0, CAMERA_EYE_OFFSET, 0);
+const cameraOffset = new Vector3();
 const cameraEuler = new Euler(0, 0, 0, 'YXZ');
 const spawnQuat = new Quaternion();
 const spawnEuler = new Euler(0, 0, 0, 'YXZ');
@@ -205,6 +229,10 @@ export function GlbWalkthroughController({ url }) {
     const controllerRef = useRef(null);
     const yawRef = useRef(0);
     const pitchRef = useRef(0);
+    const crouchKeyRef = useRef(false);
+    const suspendRef = useRef(false);
+    const eyeOffsetRef = useRef(CAMERA_EYE_OFFSET);
+    const [crouched, setCrouched] = useState(false);
     const [start, setStart] = useState(null);
     const [world, setWorld] = useState(null);
     // Build the collider on the first frame (priority after GlbScene's level loop,
@@ -299,22 +327,63 @@ export function GlbWalkthroughController({ url }) {
             if (event.code === 'Escape' && document.pointerLockElement !== canvas) {
                 useViewer.getState().setWalkthroughMode(false);
             }
+            // P toggles a cursor pause (advertised in the HUD): frees the pointer
+            // without leaving the walkthrough — e.g. for an OS screenshot, which
+            // needs a movable cursor — and click or P resumes.
+            if (event.code === 'KeyP') {
+                if (document.pointerLockElement === canvas) {
+                    suspendRef.current = true;
+                    useViewer.getState().setWalkthroughSuspended(true);
+                    document.exitPointerLock();
+                }
+                else if (suspendRef.current) {
+                    const result = canvas.requestPointerLock?.();
+                    if (result && typeof result.catch === 'function')
+                        result.catch(() => { });
+                }
+            }
+            // While paused (P), crouch is frozen as-is — ⌃⇧⌘4 (clipboard screenshot)
+            // must not toggle it under the user.
+            if ((event.code === 'ControlLeft' || event.code === 'ControlRight') && !suspendRef.current) {
+                crouchKeyRef.current = true;
+            }
+        };
+        const onKeyUp = (event) => {
+            if ((event.code === 'ControlLeft' || event.code === 'ControlRight') && !suspendRef.current) {
+                crouchKeyRef.current = false;
+            }
+        };
+        const onBlur = () => {
+            if (!suspendRef.current)
+                crouchKeyRef.current = false;
         };
         const onPointerLockChange = () => {
-            if (document.pointerLockElement === canvas)
+            if (document.pointerLockElement === canvas) {
                 wasLocked = true;
-            else if (wasLocked)
+                suspendRef.current = false;
+                useViewer.getState().setWalkthroughSuspended(false);
+            }
+            else if (suspendRef.current) {
+                // Deliberately released (screenshot pause) — stay in walkthrough.
+            }
+            else if (wasLocked) {
                 useViewer.getState().setWalkthroughMode(false);
+            }
         };
         document.addEventListener('mousemove', onMouseMove);
         canvas.addEventListener('click', onClick);
         document.addEventListener('keydown', onKeyDown);
+        document.addEventListener('keyup', onKeyUp);
+        window.addEventListener('blur', onBlur);
         document.addEventListener('pointerlockchange', onPointerLockChange);
         return () => {
             document.removeEventListener('mousemove', onMouseMove);
             canvas.removeEventListener('click', onClick);
             document.removeEventListener('keydown', onKeyDown);
+            document.removeEventListener('keyup', onKeyUp);
+            window.removeEventListener('blur', onBlur);
             document.removeEventListener('pointerlockchange', onPointerLockChange);
+            useViewer.getState().setWalkthroughSuspended(false);
             if (document.pointerLockElement === canvas)
                 document.exitPointerLock();
         };
@@ -336,8 +405,16 @@ export function GlbWalkthroughController({ url }) {
     const setControllerApi = useCallback((api) => {
         controllerRef.current = api;
     }, []);
+    const hasStandingClearance = useCallback((position) => {
+        const mesh = worldRef.current?.mesh;
+        if (!mesh)
+            return true;
+        standClearanceRaycaster.set(position, UP);
+        standClearanceRaycaster.far = STAND_CLEARANCE;
+        return standClearanceRaycaster.intersectObject(mesh, false).length === 0;
+    }, []);
     // Drive the camera from the capsule each frame + respawn if it falls into void.
-    useFrame(() => {
+    useFrame((_, delta) => {
         const group = controllerRef.current?.group;
         if (!group)
             return;
@@ -345,13 +422,24 @@ export function GlbWalkthroughController({ url }) {
             group.position.set(start.position[0], start.position[1], start.position[2]);
             controllerRef.current?.resetLinVel();
         }
+        // Crouch follows the held key; standing back up waits for headroom.
+        // Frozen while the cursor pause is active.
+        if (!suspendRef.current && crouchKeyRef.current !== crouched) {
+            if (crouchKeyRef.current)
+                setCrouched(true);
+            else if (hasStandingClearance(group.position))
+                setCrouched(false);
+        }
+        const targetEyeOffset = crouched ? CROUCH_EYE_OFFSET : CAMERA_EYE_OFFSET;
+        eyeOffsetRef.current +=
+            (targetEyeOffset - eyeOffsetRef.current) * Math.min(1, delta * EYE_LERP_SPEED);
         group.rotation.y = 0;
-        camera.position.copy(group.position).add(cameraOffset);
+        camera.position.copy(group.position).add(cameraOffset.set(0, eyeOffsetRef.current, 0));
         cameraEuler.set(pitchRef.current, yawRef.current, 0, 'YXZ');
         camera.quaternion.setFromEuler(cameraEuler);
         camera.updateMatrixWorld(true);
     }, 2.5);
     if (!(world && start))
         return null;
-    return (_jsx(KeyboardControls, { map: keyboardMap, children: _jsx(BVHEcctrl, { acceleration: 26, airDragFactor: 0.3, colliderCapsuleArgs: [0.25, 0.8, 4, 8], colliderMeshes: [world.mesh], collisionCheckIteration: 3, collisionPushBackDamping: 0.1, collisionPushBackThreshold: 0.001, deceleration: 30, delay: 0, fallGravityFactor: 4, floatCheckType: "BOTH", floatDampingC: 36, floatHeight: 0.5, floatPullBackHeight: 0.35, floatSensorRadius: 0.15, floatSpringK: 1200, gravity: 9.81, jumpVel: 5, maxRunSpeed: 5, maxSlope: 1.2, maxWalkSpeed: 2, position: start.position, ref: setControllerApi }) }));
+    return (_jsx(KeyboardControls, { map: keyboardMap, children: _jsx(BVHEcctrl, { acceleration: 26, airDragFactor: 0.3, colliderCapsuleArgs: crouched ? CROUCH_CAPSULE : STAND_CAPSULE, colliderMeshes: [world.mesh], collisionCheckIteration: 3, collisionPushBackDamping: 0.1, collisionPushBackThreshold: 0.001, deceleration: 30, delay: 0, fallGravityFactor: 4, floatCheckType: "BOTH", floatDampingC: 36, floatHeight: crouched ? CROUCH_FLOAT_HEIGHT : STAND_FLOAT_HEIGHT, floatPullBackHeight: 0.35, floatSensorRadius: 0.15, floatSpringK: 1200, gravity: 9.81, jumpVel: 5, maxRunSpeed: crouched ? CROUCH_RUN_SPEED : 5, maxSlope: 1.2, maxWalkSpeed: crouched ? CROUCH_WALK_SPEED : 2, position: start.position, ref: setControllerApi }) }));
 }

package/dist/components/viewer/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/components/viewer/index.tsx"],"names":[],"mappings":"AAEA,OAAO,EACL,KAAK,SAAS,EAKf,MAAM,kBAAkB,CAAA;AACzB,OAAO,EAAkB,KAAK,YAAY,EAAsB,MAAM,oBAAoB,CAAA;AAS1F,OAAO,KAAK,KAAK,MAAM,cAAc,CAAA;AAKrC,OAAO,KAAK,EAAE,WAAW,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAA;AAErE,OAAkB,EAAE,KAAK,aAAa,EAAE,MAAM,wBAAwB,CAAA;AAQtE,OAAuB,EAAwB,KAAK,WAAW,EAAE,MAAM,mBAAmB,CAAA;AAM1F,OAAO,QAAQ,oBAAoB,CAAC;IAOlC,UAAU,aAAa;QACrB,qBAAqB,EAAE,YAAY,CAAC,OAAO,KAAK,CAAC,qBAAqB,CAAC,CAAA;KACxE;CACF;AAuSD,UAAU,WAAW;IACnB,QAAQ,CAAC,EAAE,KAAK,CAAC,SAAS,CAAA;IAC1B,WAAW,CAAC,EAAE,WAAW,CAAA;IACzB,gBAAgB,CAAC,EAAE,SAAS,GAAG,QAAQ,CAAA;IACvC,IAAI,CAAC,EAAE,OAAO,CAAA;IACd,MAAM,CAAC,EAAE,OAAO,CAAA;IAChB,aAAa,CAAC,EAAE,aAAa,CAAA;IAC7B,WAAW,CAAC,EAAE,OAAO,CAAA;IACrB,aAAa,CAAC,EAAE;QACd,OAAO,CAAC,EAAE,aAAa,CAAA;QACvB,QAAQ,CAAC,EAAE,OAAO,CAAA;QAClB,WAAW,CAAC,EAAE,WAAW,CAAA;KAC1B,CAAA;IACD;;;;;;;OAOG;IACH,OAAO,CAAC,EAAE,SAAS,EAAE,GAAG,IAAI,CAAA;IAC5B;;;;;OAKG;IACH,aAAa,CAAC,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAAA;IACtC,kBAAkB,CAAC,EAAE,CAAC,KAAK,EAAE,OAAO,KAAK,IAAI,CAAA;IAC7C;;;;;OAKG;IACH,mBAAmB,CAAC,EAAE,MAAM,CAAA;IAC5B;;;;;;OAMG;IACH,aAAa,CAAC,EAAE,OAAO,CAAA;CACxB;AAED,yDAAyD;AACzD,MAAM,MAAM,YAAY,GAAG;IACzB;;;;;OAKG;IACH,WAAW,CAAC,GAAG,EAAE,SAAS,EAAE,GAAG,IAAI,GAAG,IAAI,CAAA;CAC3C,CAAA;AAED,QAAA,MAAM,MAAM,sGAoNV,CAAA;AAkBF,eAAe,MAAM,CAAA"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/components/viewer/index.tsx"],"names":[],"mappings":"AAEA,OAAO,EACL,KAAK,SAAS,EAKf,MAAM,kBAAkB,CAAA;AACzB,OAAO,EAAkB,KAAK,YAAY,EAAsB,MAAM,oBAAoB,CAAA;AAS1F,OAAO,KAAK,KAAK,MAAM,cAAc,CAAA;AAKrC,OAAO,KAAK,EAAE,WAAW,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAA;AAGrE,OAAkB,EAAE,KAAK,aAAa,EAAE,MAAM,wBAAwB,CAAA;AAQtE,OAAuB,EAAwB,KAAK,WAAW,EAAE,MAAM,mBAAmB,CAAA;AAU1F,OAAO,QAAQ,oBAAoB,CAAC;IAOlC,UAAU,aAAa;QACrB,qBAAqB,EAAE,YAAY,CAAC,OAAO,KAAK,CAAC,qBAAqB,CAAC,CAAA;KACxE;CACF;AAuSD,UAAU,WAAW;IACnB,QAAQ,CAAC,EAAE,KAAK,CAAC,SAAS,CAAA;IAC1B,WAAW,CAAC,EAAE,WAAW,CAAA;IACzB,gBAAgB,CAAC,EAAE,SAAS,GAAG,QAAQ,CAAA;IACvC,IAAI,CAAC,EAAE,OAAO,CAAA;IACd,MAAM,CAAC,EAAE,OAAO,CAAA;IAChB,aAAa,CAAC,EAAE,aAAa,CAAA;IAC7B,WAAW,CAAC,EAAE,OAAO,CAAA;IACrB,aAAa,CAAC,EAAE;QACd,OAAO,CAAC,EAAE,aAAa,CAAA;QACvB,QAAQ,CAAC,EAAE,OAAO,CAAA;QAClB,WAAW,CAAC,EAAE,WAAW,CAAA;KAC1B,CAAA;IACD;;;;;;;OAOG;IACH,OAAO,CAAC,EAAE,SAAS,EAAE,GAAG,IAAI,CAAA;IAC5B;;;;;OAKG;IACH,aAAa,CAAC,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAAA;IACtC,kBAAkB,CAAC,EAAE,CAAC,KAAK,EAAE,OAAO,KAAK,IAAI,CAAA;IAC7C;;;;;OAKG;IACH,mBAAmB,CAAC,EAAE,MAAM,CAAA;IAC5B;;;;;;OAMG;IACH,aAAa,CAAC,EAAE,OAAO,CAAA;CACxB;AAED,yDAAyD;AACzD,MAAM,MAAM,YAAY,GAAG;IACzB;;;;;OAKG;IACH,WAAW,CAAC,GAAG,EAAE,SAAS,EAAE,GAAG,IAAI,GAAG,IAAI,CAAA;CAC3C,CAAA;AAED,QAAA,MAAM,MAAM,sGA4NV,CAAA;AAkBF,eAAe,MAAM,CAAA"}

package/dist/components/viewer/index.js

@@ -9,6 +9,7 @@ import { PERF_OVERLAY_ENABLED, pushGpuSample } from '../../lib/gpu-perf';
 import { applyIsolation, clearIsolation } from '../../lib/isolation';
 import { ensureKtx2Support } from '../../lib/ktx2-loader';
 import { getSceneTheme } from '../../lib/scene-themes';
+import { installTextureNodeNullGuard } from '../../lib/texture-node-guard';
 import useViewer, {} from '../../store/use-viewer';
 import { FloorElevationSystem } from '../../systems/floor-elevation/floor-elevation-system';
 import { GeometrySystem } from '../../systems/geometry/geometry-system';
@@ -22,6 +23,9 @@ import { RegisteredSystems } from './registered-systems';
 import { SceneBvh } from './scene-bvh';
 import { SelectionManager } from './selection-manager';
 import { ViewerCamera } from './viewer-camera';
+// Must be in place before any node material builds — a null texture pulled by
+// a shared override-material pass otherwise kills the render pass outright.
+installTextureNodeNullGuard();
 extend(THREE);
 // R3F's <Canvas> useLayoutEffect has no deps, so any re-render (theme switch,
 // parent re-render, StrictMode double-mount) re-invokes `configure()`. With a
@@ -227,6 +231,11 @@ function SceneReadyTracker({ onSceneReadyChange, sceneReadyKey, sceneReadyMaxWai
     return null;
 }
 const Viewer = forwardRef(function Viewer({ children, hoverStyles = DEFAULT_HOVER_STYLES, selectionManager = 'default', perf = false, useBvh = true, renderContext = 'editor', transparent, defaultRender, isolate, sceneReadyKey, onSceneReadyChange, sceneReadyMaxWaitMs, disablePostFx = false, }, ref) {
+    useEffect(() => {
+        if (nodeRegistry.size === 0) {
+            console.warn('[viewer] Node registry is empty. Install @pascal-app/nodes and call await loadPlugin(builtinPlugin) before mounting <Viewer>.');
+        }
+    }, []);
     useImperativeHandle(ref, () => ({
         setIsolated: (ids) => applyIsolation(ids),
     }), []);

package/dist/components/viewer/post-processing.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"post-processing.d.ts","sourceRoot":"","sources":["../../../src/components/viewer/post-processing.tsx"],"names":[],"mappings":"AAwCA,eAAO,MAAM,YAAY;;;CAGxB,CAAA;AAGD,eAAO,MAAM,WAAW;;;;;;;;;;;;;CAavB,CAAA;AA0DD,MAAM,MAAM,UAAU,GAAG;IACvB,YAAY,EAAE,MAAM,CAAA;IACpB,WAAW,EAAE,MAAM,CAAA;IACnB,QAAQ,EAAE,MAAM,CAAA;IAChB,KAAK,EAAE,OAAO,CAAA;CACf,CAAA;AAED,MAAM,MAAM,WAAW,GAAG;IACxB,OAAO,EAAE,UAAU,CAAA;CACpB,GAAG,MAAM,CAAC,MAAM,EAAE,UAAU,CAAC,CAAA;AAS9B,eAAO,MAAM,oBAAoB,EAAE,WAElC,CAAA;AAiBD,QAAA,MAAM,oBAAoB,GAAI,iCAG3B;IACD,WAAW,CAAC,EAAE,WAAW,CAAA;IACzB,6EAA6E;IAC7E,aAAa,CAAC,EAAE,OAAO,CAAA;CACxB,SA8mBA,CAAA;AAED,eAAe,oBAAoB,CAAA"}
+{"version":3,"file":"post-processing.d.ts","sourceRoot":"","sources":["../../../src/components/viewer/post-processing.tsx"],"names":[],"mappings":"AAwCA,eAAO,MAAM,YAAY;;;CAGxB,CAAA;AAGD,eAAO,MAAM,WAAW;;;;;;;;;;;;;CAavB,CAAA;AA0DD,MAAM,MAAM,UAAU,GAAG;IACvB,YAAY,EAAE,MAAM,CAAA;IACpB,WAAW,EAAE,MAAM,CAAA;IACnB,QAAQ,EAAE,MAAM,CAAA;IAChB,KAAK,EAAE,OAAO,CAAA;CACf,CAAA;AAED,MAAM,MAAM,WAAW,GAAG;IACxB,OAAO,EAAE,UAAU,CAAA;CACpB,GAAG,MAAM,CAAC,MAAM,EAAE,UAAU,CAAC,CAAA;AAS9B,eAAO,MAAM,oBAAoB,EAAE,WAElC,CAAA;AAiBD,QAAA,MAAM,oBAAoB,GAAI,iCAG3B;IACD,WAAW,CAAC,EAAE,WAAW,CAAA;IACzB,6EAA6E;IAC7E,aAAa,CAAC,EAAE,OAAO,CAAA;CACxB,SAgnBA,CAAA;AAED,eAAe,oBAAoB,CAAA"}

package/dist/components/viewer/post-processing.js

@@ -618,6 +618,7 @@ const PostProcessingPasses = ({ hoverStyles = DEFAULT_HOVER_STYLES, disablePostF
         }
         catch (error) {
             hasPipelineErrorRef.current = true;
+            renderer.setRenderTarget?.(null);
             console.error('[viewer/post-processing] Render pass failed.', {
                 retryCount: retryCountRef.current,
                 rendererCtor: renderer.constructor?.name,

package/dist/components/viewer/selection-manager.js

@@ -353,13 +353,16 @@ const PointerMissedHandler = ({ clickHandledRef, }) => {
 };
 const OutlinerSync = () => {
     const selection = useViewer((s) => s.selection);
+    const externalSelectedIds = useViewer((s) => s.externalSelectedIds);
     const hoveredId = useViewer((s) => s.hoveredId);
     const outliner = useViewer((s) => s.outliner);
+    const geometryRevision = useViewer((s) => s.geometryRevision);
     const nodes = useScene((s) => s.nodes);
     useEffect(() => {
+        void geometryRevision;
         // Sync selected objects
         outliner.selectedObjects.length = 0;
-        for (const id of selection.selectedIds) {
+        for (const id of new Set([...selection.selectedIds, ...externalSelectedIds])) {
             const node = nodes[id];
             if (node?.type === 'slab')
                 continue;
@@ -377,6 +380,6 @@ const OutlinerSync = () => {
             if (obj)
                 outliner.hoveredObjects.push(obj);
         }
-    }, [selection, hoveredId, outliner, nodes]);
+    }, [selection, externalSelectedIds, hoveredId, outliner, nodes, geometryRevision]);
     return null;
 };

package/dist/hooks/use-gltf-ktx2.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"use-gltf-ktx2.d.ts","sourceRoot":"","sources":["../../src/hooks/use-gltf-ktx2.tsx"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,mBAAmB,CAAA;AAK3C,QAAA,MAAM,WAAW,GAAI,MAAM,MAAM,KAAG,UAAU,CAAC,OAAO,OAAO,CAU5D,CAAA;AAED,OAAO,EAAE,WAAW,EAAE,CAAA"}
+{"version":3,"file":"use-gltf-ktx2.d.ts","sourceRoot":"","sources":["../../src/hooks/use-gltf-ktx2.tsx"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,mBAAmB,CAAA;AAK3C,QAAA,MAAM,WAAW,GAAI,MAAM,MAAM,KAAG,UAAU,CAAC,OAAO,OAAO,CAO5D,CAAA;AAED,OAAO,EAAE,WAAW,EAAE,CAAA"}

package/dist/hooks/use-gltf-ktx2.js

@@ -1,14 +1,11 @@
 import { useGLTF } from '@react-three/drei';
 import { useThree } from '@react-three/fiber';
 import { MeshoptDecoder } from 'three/examples/jsm/libs/meshopt_decoder.module.js';
-import { ensureKtx2Support, ktx2Loader } from '../lib/ktx2-loader';
+import { configureKtx2Support } from '../lib/ktx2-loader';
 const useGLTFKTX2 = (path) => {
     const gl = useThree((state) => state.gl);
     return useGLTF(path, true, true, (loader) => {
-        if (ensureKtx2Support(gl)) {
-            // eslint-disable-next-line @typescript-eslint/no-explicit-any
-            loader.setKTX2Loader(ktx2Loader);
-        }
+        configureKtx2Support(loader, gl);
         loader.setMeshoptDecoder(MeshoptDecoder);
     });
 };

package/dist/index.d.ts

@@ -6,11 +6,10 @@ export { type BVHEcctrlApi, default as BVHEcctrl, type MovementInput, } from './
 export { buildGlbInteractiveItems, GlbInteractive, type GlbInteractiveItem, } from './components/viewer/glb-interactive';
 export { buildGlbReferenceNodes, buildGlbReplaceNodes, } from './components/viewer/glb-reference-nodes';
 export { type GlbHover, type GlbIdentity, type GlbLevel, GlbScene, type GlbWalkthrough, } from './components/viewer/glb-scene';
-export { GlbWalkthroughController } from './components/viewer/glb-walkthrough-controller';
+export { CROUCH_CAPSULE, CROUCH_EYE_OFFSET, CROUCH_FLOAT_HEIGHT, CROUCH_RUN_SPEED, CROUCH_WALK_SPEED, EYE_LERP_SPEED, GlbWalkthroughController, STAND_CAPSULE, STAND_CLEARANCE, STAND_FLOAT_HEIGHT, WALKTHROUGH_FOV, } from './components/viewer/glb-walkthrough-controller';
 export type { HoverStyle, HoverStyles } from './components/viewer/post-processing';
 export { DEFAULT_HOVER_STYLES, SSGI_PARAMS, } from './components/viewer/post-processing';
 export { SceneEnvironment } from './components/viewer/scene-environment';
-export { WalkthroughControls } from './components/viewer/walkthrough-controls';
 export { useAssetUrl } from './hooks/use-asset-url';
 export { useGLTFKTX2 } from './hooks/use-gltf-ktx2';
 export { useNodeEvents } from './hooks/use-node-events';
@@ -19,16 +18,20 @@ export { backdropGradient, deepSkyColor, horizonHazeColor } from './lib/backdrop
 export { applyWorldScaleBoxUVs } from './lib/box-uv';
 export { ADDITION, Brush, computeGeometryBoundsTree, csgEvaluator, csgGeometry, csgMaterials, INTERSECTION, prepareBrushForCSG, SUBTRACTION, } from './lib/csg-utils';
 export type { EdgeMode } from './lib/edge-style';
+export { computeHeroFraming, DEFAULT_FRAMING_EXCLUDED_TYPES, type HeroFraming, heroCameraPose, temporarilyHideNodeTypes, unionRegisteredNodeBounds, } from './lib/hero-pose';
 export { applyIsolation, clearIsolation, collectIsolationSubtree, isIsolationActive, } from './lib/isolation';
-export { ensureKtx2Support } from './lib/ktx2-loader';
+export { configureKtx2Support, ensureKtx2Support } from './lib/ktx2-loader';
 export { GRID_LAYER, OVERLAY_LAYER, SCENE_LAYER, ZONE_LAYER } from './lib/layers';
 export { applyMaterialPresetToMaterials, BLUEPRINT_PALETTE, baseMaterial, CLAY_PALETTE, type ColorPreset, clearMaterialCache, createDefaultMaterial, createMaterial, createMaterialFromPresetRef, createSurfaceRoleMaterial, DEFAULT_CEILING_MATERIAL, DEFAULT_DOOR_MATERIAL, DEFAULT_ROOF_MATERIAL, DEFAULT_SHELF_MATERIAL, DEFAULT_SLAB_MATERIAL, DEFAULT_STAIR_MATERIAL, DEFAULT_WALL_MATERIAL, DEFAULT_WINDOW_MATERIAL, disposeMaterial, glassMaterial, MONO_PALETTE, PRESET_PALETTES, type RenderShading, resolveMaterialRef, resolveSlotDefaultMaterial, resolveSurfaceColor, WHITE_PALETTE, } from './lib/materials';
 export { mergedOutline } from './lib/merged-outline-node';
 export { unionPolygons } from './lib/polygon-union';
 export { getSceneTheme, SCENE_THEME_IDS, SCENE_THEMES, type SceneTheme, } from './lib/scene-themes';
+export { createSnapshotPipeline, type SnapshotCaptureMode, type SnapshotCaptureResult, type SnapshotCropRegion, type SnapshotPipeline, type SnapshotSize, THUMBNAIL_HEIGHT, THUMBNAIL_WIDTH, } from './lib/snapshot-pipeline';
+export { buildTerrainPerimeterFillGeometry, type TerrainPerimeterPoint, } from './lib/terrain-perimeter-fill';
+export { getPascalTextureRef, type PascalTextureColorSpace, type PascalTextureMap, type PascalTextureRef, stampPascalTextureRef, textureMapForSlot, } from './lib/texture-reference';
 export { packNormalToRGB, unpackRGBToNormal } from './lib/tsl-compat';
 export { useItemLightPool } from './store/use-item-light-pool';
-export { applyCountryUnitDefault, default as useViewer } from './store/use-viewer';
+export { applyCountryUnitDefault, default as useViewer, type MetricNotation, } from './store/use-viewer';
 export { CeilingSystem } from './systems/ceiling/ceiling-system';
 export { createColumnBoxGeometry, createColumnCylinderGeometry, createColumnSphereGeometry, createColumnTorusGeometry, } from './systems/column/column-geometry';
 export { DoorAnimationSystem } from './systems/door/door-animation-system';
@@ -45,7 +48,7 @@ export { snapLevelsToTruePositions } from './systems/level/level-utils';
 export { getRoofMaterialArray } from './systems/roof/roof-materials';
 export { clipGeometryBySegmentTrim, generateRoofSegmentGeometry, getRoofOuterSurfaceFrameAtPoint, getRoofSegmentBrushes, mapRoofGroupMaterialIndex, ROOF_MATERIAL_SLOT_COUNT, RoofSystem, remapRoofShellFaces, roofCsgDummyMats, type SurfaceFrame, } from './systems/roof/roof-system';
 export { ScanSystem } from './systems/scan/scan-system';
-export { generateSlabGeometry, SlabSystem } from './systems/slab/slab-system';
+export { generateSlabGeometry } from './systems/slab/slab-system';
 export { getStairBodyMaterials, getStairRailingMaterial, getStraightStairSegmentBodyMaterials, type StairBodyMaterials, } from './systems/stair/stair-materials';
 export { StairSystem } from './systems/stair/stair-system';
 export { buildOpeningCutoutGeometry, getOpeningCutoutBottomPadding, hasFlatOpeningCutoutBottom, } from './systems/wall/opening-cutout-geometry';

package/dist/index.d.ts.map

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

package/dist/index.js

@@ -15,10 +15,9 @@ export { default as BVHEcctrl, } from './components/viewer/bvh-ecctrl';
 export { buildGlbInteractiveItems, GlbInteractive, } from './components/viewer/glb-interactive';
 export { buildGlbReferenceNodes, buildGlbReplaceNodes, } from './components/viewer/glb-reference-nodes';
 export { GlbScene, } from './components/viewer/glb-scene';
-export { GlbWalkthroughController } from './components/viewer/glb-walkthrough-controller';
+export { CROUCH_CAPSULE, CROUCH_EYE_OFFSET, CROUCH_FLOAT_HEIGHT, CROUCH_RUN_SPEED, CROUCH_WALK_SPEED, EYE_LERP_SPEED, GlbWalkthroughController, STAND_CAPSULE, STAND_CLEARANCE, STAND_FLOAT_HEIGHT, WALKTHROUGH_FOV, } from './components/viewer/glb-walkthrough-controller';
 export { DEFAULT_HOVER_STYLES, SSGI_PARAMS, } from './components/viewer/post-processing';
 export { SceneEnvironment } from './components/viewer/scene-environment';
-export { WalkthroughControls } from './components/viewer/walkthrough-controls';
 export { useAssetUrl } from './hooks/use-asset-url';
 export { useGLTFKTX2 } from './hooks/use-gltf-ktx2';
 export { useNodeEvents } from './hooks/use-node-events';
@@ -29,16 +28,20 @@ export { applyWorldScaleBoxUVs } from './lib/box-uv';
 // geometry subtracts pieces against their host. Lives in viewer
 // because three-bvh-csg / three-mesh-bvh are viewer-only deps.
 export { ADDITION, Brush, computeGeometryBoundsTree, csgEvaluator, csgGeometry, csgMaterials, INTERSECTION, prepareBrushForCSG, SUBTRACTION, } from './lib/csg-utils';
+export { computeHeroFraming, DEFAULT_FRAMING_EXCLUDED_TYPES, heroCameraPose, temporarilyHideNodeTypes, unionRegisteredNodeBounds, } from './lib/hero-pose';
 export { applyIsolation, clearIsolation, collectIsolationSubtree, isIsolationActive, } from './lib/isolation';
-export { ensureKtx2Support } from './lib/ktx2-loader';
+export { configureKtx2Support, ensureKtx2Support } from './lib/ktx2-loader';
 export { GRID_LAYER, OVERLAY_LAYER, SCENE_LAYER, ZONE_LAYER } from './lib/layers';
 export { applyMaterialPresetToMaterials, BLUEPRINT_PALETTE, baseMaterial, CLAY_PALETTE, clearMaterialCache, createDefaultMaterial, createMaterial, createMaterialFromPresetRef, createSurfaceRoleMaterial, DEFAULT_CEILING_MATERIAL, DEFAULT_DOOR_MATERIAL, DEFAULT_ROOF_MATERIAL, DEFAULT_SHELF_MATERIAL, DEFAULT_SLAB_MATERIAL, DEFAULT_STAIR_MATERIAL, DEFAULT_WALL_MATERIAL, DEFAULT_WINDOW_MATERIAL, disposeMaterial, glassMaterial, MONO_PALETTE, PRESET_PALETTES, resolveMaterialRef, resolveSlotDefaultMaterial, resolveSurfaceColor, WHITE_PALETTE, } from './lib/materials';
 export { mergedOutline } from './lib/merged-outline-node';
 export { unionPolygons } from './lib/polygon-union';
 export { getSceneTheme, SCENE_THEME_IDS, SCENE_THEMES, } from './lib/scene-themes';
+export { createSnapshotPipeline, THUMBNAIL_HEIGHT, THUMBNAIL_WIDTH, } from './lib/snapshot-pipeline';
+export { buildTerrainPerimeterFillGeometry, } from './lib/terrain-perimeter-fill';
+export { getPascalTextureRef, stampPascalTextureRef, textureMapForSlot, } from './lib/texture-reference';
 export { packNormalToRGB, unpackRGBToNormal } from './lib/tsl-compat';
 export { useItemLightPool } from './store/use-item-light-pool';
-export { applyCountryUnitDefault, default as useViewer } from './store/use-viewer';
+export { applyCountryUnitDefault, default as useViewer, } from './store/use-viewer';
 export { CeilingSystem } from './systems/ceiling/ceiling-system';
 export { createColumnBoxGeometry, createColumnCylinderGeometry, createColumnSphereGeometry, createColumnTorusGeometry, } from './systems/column/column-geometry';
 export { DoorAnimationSystem } from './systems/door/door-animation-system';
@@ -69,10 +72,9 @@ export { getRoofMaterialArray } from './systems/roof/roof-materials';
 // belong here — those live in `@pascal-app/nodes/<kind>/`.
 export { clipGeometryBySegmentTrim, generateRoofSegmentGeometry, getRoofOuterSurfaceFrameAtPoint, getRoofSegmentBrushes, mapRoofGroupMaterialIndex, ROOF_MATERIAL_SLOT_COUNT, RoofSystem, remapRoofShellFaces, roofCsgDummyMats, } from './systems/roof/roof-system';
 export { ScanSystem } from './systems/scan/scan-system';
-// Slab system follows the wall + fence re-export pattern — composed into
-// the registry-driven slab definition's `def.system`. Removed in Phase 6
-// alongside the legacy slab mount point.
-export { generateSlabGeometry, SlabSystem } from './systems/slab/slab-system';
+// Pure slab geometry generator — composed into the registry-driven slab
+// definition's `def.geometry` in `@pascal-app/nodes`.
+export { generateSlabGeometry } from './systems/slab/slab-system';
 export { getStairBodyMaterials, getStairRailingMaterial, getStraightStairSegmentBodyMaterials, } from './systems/stair/stair-materials';
 export { StairSystem } from './systems/stair/stair-system';
 // Pure opening-cutout profile math shared by the wall CSG pipeline and

package/dist/lib/hero-pose.d.ts

@@ -0,0 +1,47 @@
+import { Box3 } from 'three';
+export declare const DEFAULT_FRAMING_EXCLUDED_TYPES: readonly ["site", "scan", "guide", "spawn"];
+export declare function heroCameraPose({ boxes, aspect, aim, fovDeg, azimuthRad, elevationRad, padding, minDistance, frameShift, }: {
+    boxes: Box3 | readonly Box3[];
+    aspect: number;
+    /** Where the camera looks (frame center). Defaults to the union-box center;
+     *  pass the building's center to keep it dead-center while outlying boxes
+     *  (lot plate, far palms) simply take asymmetric margin — the corner fit
+     *  still guarantees every box stays in frame. */
+    aim?: [number, number, number];
+    fovDeg?: number;
+    azimuthRad?: number;
+    elevationRad?: number;
+    padding?: number;
+    minDistance?: number;
+    /** Fraction of the frustum half-height to drop the aim by. 0 keeps the aim
+     *  (the building center) exactly at frame center. */
+    frameShift?: number;
+}): {
+    position: [number, number, number];
+    target: [number, number, number];
+};
+export declare function unionRegisteredNodeBounds({ excludeTypes, }: {
+    excludeTypes: readonly string[];
+}): Box3 | null;
+export type HeroFraming = {
+    /** Fit constraints — everything that must stay in frame. */
+    boxes: Box3[];
+    /** Frame center: plate/structure center on XZ, building center on Y. */
+    aim: [number, number, number];
+    /** 45° to the dominant facade (falls back to world 45°). */
+    azimuthRad: number;
+};
+/**
+ * Framing for a scene hero shot. The base set is the built structure (walls,
+ * roofs, slabs, …) plus any intentionally-shaped site plate; an item joins
+ * only when it sits near that base — one palm at the far lot corner must not
+ * shrink the building. `building`/`level` container groups are skipped (their
+ * Object3D holds the whole subtree). The aim keeps the building dead-center:
+ * XZ from the plate+structure union, Y from the structure alone so the
+ * building — not the ground — is vertically centered. Scenes with no
+ * structure (pure furniture arrangements) fall back to framing every
+ * non-helper node.
+ */
+export declare function computeHeroFraming(): HeroFraming | null;
+export declare function temporarilyHideNodeTypes(types: readonly string[]): () => void;
+//# sourceMappingURL=hero-pose.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"hero-pose.d.ts","sourceRoot":"","sources":["../../src/lib/hero-pose.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,IAAI,EAA0B,MAAM,OAAO,CAAA;AAEpD,eAAO,MAAM,8BAA8B,6CAA8C,CAAA;AAEzF,wBAAgB,cAAc,CAAC,EAC7B,KAAK,EACL,MAAM,EACN,GAAG,EACH,MAAW,EACX,UAAwB,EACxB,YAAmC,EACnC,OAAc,EACd,WAAe,EACf,UAAc,GACf,EAAE;IACD,KAAK,EAAE,IAAI,GAAG,SAAS,IAAI,EAAE,CAAA;IAC7B,MAAM,EAAE,MAAM,CAAA;IACd;;;qDAGiD;IACjD,GAAG,CAAC,EAAE,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,CAAA;IAC9B,MAAM,CAAC,EAAE,MAAM,CAAA;IACf,UAAU,CAAC,EAAE,MAAM,CAAA;IACnB,YAAY,CAAC,EAAE,MAAM,CAAA;IACrB,OAAO,CAAC,EAAE,MAAM,CAAA;IAChB,WAAW,CAAC,EAAE,MAAM,CAAA;IACpB;yDACqD;IACrD,UAAU,CAAC,EAAE,MAAM,CAAA;CACpB,GAAG;IACF,QAAQ,EAAE,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,CAAA;IAClC,MAAM,EAAE,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,CAAA;CACjC,CA2DA;AAED,wBAAgB,yBAAyB,CAAC,EACxC,YAAY,GACb,EAAE;IACD,YAAY,EAAE,SAAS,MAAM,EAAE,CAAA;CAChC,GAAG,IAAI,GAAG,IAAI,CAgBd;AAiFD,MAAM,MAAM,WAAW,GAAG;IACxB,4DAA4D;IAC5D,KAAK,EAAE,IAAI,EAAE,CAAA;IACb,wEAAwE;IACxE,GAAG,EAAE,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,CAAA;IAC7B,4DAA4D;IAC5D,UAAU,EAAE,MAAM,CAAA;CACnB,CAAA;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,kBAAkB,IAAI,WAAW,GAAG,IAAI,CAuCvD;AAED,wBAAgB,wBAAwB,CAAC,KAAK,EAAE,SAAS,MAAM,EAAE,GAAG,MAAM,IAAI,CAiB7E"}