@pascal-app/viewer 0.9.1 → 1.0.0-beta.1

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

@@ -1,6 +1,6 @@
 'use client';
 import { jsx as _jsx, Fragment as _Fragment, jsxs as _jsxs } from "react/jsx-runtime";
-import { emitter, getSelectableKinds, pointInPolygon, sceneRegistry, useScene, } from '@pascal-app/core';
+import { emitter, getSelectableKinds, pointInPolygon, resolveSelectionProxyId, sceneRegistry, useScene, } from '@pascal-app/core';
 import { useThree } from '@react-three/fiber';
 import { useEffect, useRef } from 'react';
 import { Vector3 } from 'three';
@@ -122,16 +122,18 @@ const isNodeInZone = (node, levelId, zoneId) => {
 };
 const getStrategy = () => {
     const { buildingId, levelId, zoneId } = useViewer.getState().selection;
-    const computeNextIds = (node, selectedIds, event) => {
+    const computeNextIds = (nodeId, selectedIds, event) => {
         const isMeta = event?.metaKey || event?.nativeEvent?.metaKey;
         const isCtrl = event?.ctrlKey || event?.nativeEvent?.ctrlKey;
-        if (isMeta || isCtrl) {
-            if (selectedIds.includes(node.id)) {
-                return selectedIds.filter((id) => id !== node.id);
+        // Shift toggles membership like Cmd/Ctrl.
+        const isShift = event?.shiftKey || event?.nativeEvent?.shiftKey;
+        if (isMeta || isCtrl || isShift) {
+            if (selectedIds.includes(nodeId)) {
+                return selectedIds.filter((id) => id !== nodeId);
             }
-            return [...selectedIds, node.id];
+            return [...selectedIds, nodeId];
         }
-        return [node.id];
+        return [nodeId];
     };
     // No building selected -> can select buildings
     if (!buildingId) {
@@ -195,9 +197,10 @@ const getStrategy = () => {
                 }
             }
             const { selectedIds } = useViewer.getState().selection;
+            const proxyId = resolveSelectionProxyId(nodeToSelect, useScene.getState().nodes);
             useViewer
                 .getState()
-                .setSelection({ selectedIds: computeNextIds(nodeToSelect, selectedIds, nativeEvent) });
+                .setSelection({ selectedIds: computeNextIds(proxyId, selectedIds, nativeEvent) });
         },
         handleDeselect: () => {
             const { selectedIds } = useViewer.getState().selection;
@@ -248,7 +251,9 @@ export const SelectionManager = () => {
                     useViewer.setState({ hoveredId: null });
                     return;
                 }
-                useViewer.setState({ hoveredId: event.node.id });
+                useViewer.setState({
+                    hoveredId: resolveSelectionProxyId(event.node, useScene.getState().nodes),
+                });
             }
         };
         const onLeave = (event) => {
@@ -259,7 +264,10 @@ export const SelectionManager = () => {
                 return;
             if (strategy.isValid(event.node)) {
                 event.stopPropagation();
-                useViewer.setState({ hoveredId: null });
+                const targetId = resolveSelectionProxyId(event.node, useScene.getState().nodes);
+                if (useViewer.getState().hoveredId === targetId) {
+                    useViewer.setState({ hoveredId: null });
+                }
             }
         };
         const onClick = (event) => {
@@ -345,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;
@@ -369,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;AAU3C,QAAA,MAAM,WAAW,GAAI,MAAM,MAAM,KAAG,UAAU,CAAC,OAAO,OAAO,CA2B5D,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,33 +1,11 @@
 import { useGLTF } from '@react-three/drei';
 import { useThree } from '@react-three/fiber';
-import { KTX2Loader } from 'three/examples/jsm/Addons.js';
 import { MeshoptDecoder } from 'three/examples/jsm/libs/meshopt_decoder.module.js';
-const ktx2LoaderInstance = new KTX2Loader();
-ktx2LoaderInstance.setTranscoderPath('https://cdn.jsdelivr.net/gh/pmndrs/drei-assets@master/basis/');
-const ktx2ConfiguredRenderers = new WeakSet();
-const ktx2WarningLoggedRenderers = new WeakSet();
+import { configureKtx2Support } from '../lib/ktx2-loader';
 const useGLTFKTX2 = (path) => {
     const gl = useThree((state) => state.gl);
     return useGLTF(path, true, true, (loader) => {
-        const renderer = gl;
-        if (!ktx2ConfiguredRenderers.has(renderer)) {
-            try {
-                ktx2LoaderInstance.detectSupport(gl);
-                ktx2ConfiguredRenderers.add(renderer);
-            }
-            catch (error) {
-                // Some WebGPU flows can transiently call this before backend init.
-                // Avoid crashing the whole scene; scans may render without KTX2 on this pass.
-                if (!ktx2WarningLoggedRenderers.has(renderer)) {
-                    console.warn('[viewer] Skipping KTX2 support detection for now.', error);
-                    ktx2WarningLoggedRenderers.add(renderer);
-                }
-            }
-        }
-        if (ktx2ConfiguredRenderers.has(renderer)) {
-            // eslint-disable-next-line @typescript-eslint/no-explicit-any
-            loader.setKTX2Loader(ktx2LoaderInstance);
-        }
+        configureKtx2Support(loader, gl);
         loader.setMeshoptDecoder(MeshoptDecoder);
     });
 };

package/dist/hooks/use-node-events.d.ts

@@ -6,7 +6,7 @@ type NodeByKind<K extends AnyNodeType> = Extract<AnyNode, {
 export declare function useNodeEvents<K extends AnyNodeType>(node: NodeByKind<K>, type: K): {
     onPointerDown: (e: ThreeEvent<PointerEvent>) => void;
     onPointerUp: (e: ThreeEvent<PointerEvent>) => void;
-    onClick: (e: ThreeEvent<PointerEvent>) => void;
+    onClick: (_e: ThreeEvent<PointerEvent>) => void;
     onPointerEnter: (e: ThreeEvent<PointerEvent>) => void;
     onPointerLeave: (e: ThreeEvent<PointerEvent>) => void;
     onPointerMove: (e: ThreeEvent<PointerEvent>) => void;

package/dist/hooks/use-node-events.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"use-node-events.d.ts","sourceRoot":"","sources":["../../src/hooks/use-node-events.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,KAAK,OAAO,EACZ,KAAK,WAAW,EAIjB,MAAM,kBAAkB,CAAA;AACzB,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,oBAAoB,CAAA;AAQpD,KAAK,UAAU,CAAC,CAAC,SAAS,WAAW,IAAI,OAAO,CAAC,OAAO,EAAE;IAAE,IAAI,EAAE,CAAC,CAAA;CAAE,CAAC,CAAA;AAEtE,wBAAgB,aAAa,CAAC,CAAC,SAAS,WAAW,EAAE,IAAI,EAAE,UAAU,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE,CAAC;uBAgC1D,UAAU,CAAC,YAAY,CAAC;qBAK1B,UAAU,CAAC,YAAY,CAAC;iBAQ5B,UAAU,CAAC,YAAY,CAAC;wBAIjB,UAAU,CAAC,YAAY,CAAC;wBAIxB,UAAU,CAAC,YAAY,CAAC;uBAIzB,UAAU,CAAC,YAAY,CAAC;uBAIxB,UAAU,CAAC,YAAY,CAAC;uBAIxB,UAAU,CAAC,YAAY,CAAC;EAK9C"}
+{"version":3,"file":"use-node-events.d.ts","sourceRoot":"","sources":["../../src/hooks/use-node-events.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,KAAK,OAAO,EACZ,KAAK,WAAW,EAIjB,MAAM,kBAAkB,CAAA;AACzB,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,oBAAoB,CAAA;AAQpD,KAAK,UAAU,CAAC,CAAC,SAAS,WAAW,IAAI,OAAO,CAAC,OAAO,EAAE;IAAE,IAAI,EAAE,CAAC,CAAA;CAAE,CAAC,CAAA;AAEtE,wBAAgB,aAAa,CAAC,CAAC,SAAS,WAAW,EAAE,IAAI,EAAE,UAAU,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE,CAAC;uBAwC1D,UAAU,CAAC,YAAY,CAAC;qBAK1B,UAAU,CAAC,YAAY,CAAC;kBAQ3B,UAAU,CAAC,YAAY,CAAC;wBAIlB,UAAU,CAAC,YAAY,CAAC;wBAIxB,UAAU,CAAC,YAAY,CAAC;uBAIzB,UAAU,CAAC,YAAY,CAAC;uBAIxB,UAAU,CAAC,YAAY,CAAC;uBAIxB,UAAU,CAAC,YAAY,CAAC;EAK9C"}

package/dist/hooks/use-node-events.js

@@ -19,25 +19,33 @@ export function useNodeEvents(node, type) {
         // through that generic surface without enumerating every kind.
         emitter.emit(eventKey, payload);
     };
-    // Suppress node pointer events while an interaction drag is in
-    // progress. `cameraDragging` covers orbit/pan/dolly; `inputDragging`
-    // covers host-driven drags (editor handle arrows etc.). Without
-    // this, the synthesized click on pointerup would reroute selection
-    // to whatever mesh the cursor lands on at release.
-    const isInteractionActive = () => {
+    // Camera drags (orbit / pan / dolly) suppress ALL node pointer events.
+    //
+    // `inputDragging` (host-driven drags: handle arrows, press-drag moves)
+    // additionally suppresses the SELECTION events — without it the click
+    // synthesized on pointer-release would reroute selection to whatever mesh
+    // sits under the cursor at release. It must NOT suppress the SPATIAL events
+    // (`enter` / `move` / `leave`): a surface-following move tool — a door /
+    // window sliding along a wall — runs WITH `inputDragging` set and depends on
+    // those events to track the cursor. Consumers that should ignore drag-time
+    // spatial events gate on `inputDragging` themselves (the editor's hover and
+    // paint paths, box-select), so emitting them during a drag only reaches the
+    // active move tool that wants them.
+    const spatialSuppressed = () => useViewer.getState().cameraDragging;
+    const selectionSuppressed = () => {
         const s = useViewer.getState();
         return s.cameraDragging || s.inputDragging;
     };
     return {
         onPointerDown: (e) => {
-            if (isInteractionActive())
+            if (selectionSuppressed())
                 return;
             if (e.button !== 0)
                 return;
             emit('pointerdown', e);
         },
         onPointerUp: (e) => {
-            if (isInteractionActive())
+            if (selectionSuppressed())
                 return;
             if (e.button !== 0)
                 return;
@@ -46,32 +54,32 @@ export function useNodeEvents(node, type) {
             // which often fails if the mouse moves even 1 pixel.
             emit('click', e);
         },
-        onClick: (e) => {
+        onClick: (_e) => {
             // Disable default R3F click since we synthesize it on pointerup
             // This prevents double-clicks from firing twice.
         },
         onPointerEnter: (e) => {
-            if (isInteractionActive())
+            if (spatialSuppressed())
                 return;
             emit('enter', e);
         },
         onPointerLeave: (e) => {
-            if (isInteractionActive())
+            if (spatialSuppressed())
                 return;
             emit('leave', e);
         },
         onPointerMove: (e) => {
-            if (isInteractionActive())
+            if (spatialSuppressed())
                 return;
             emit('move', e);
         },
         onDoubleClick: (e) => {
-            if (isInteractionActive())
+            if (selectionSuppressed())
                 return;
             emit('double-click', e);
         },
         onContextMenu: (e) => {
-            if (isInteractionActive())
+            if (selectionSuppressed())
                 return;
             emit('context-menu', e);
         },

package/dist/index.d.ts

@@ -2,29 +2,42 @@ export type { SurfaceRole } from '@pascal-app/core';
 export { ErrorBoundary } from './components/error-boundary';
 export { NodeRenderer } from './components/renderers/node-renderer';
 export { default as Viewer, type ViewerHandle } from './components/viewer';
+export { type BVHEcctrlApi, default as BVHEcctrl, type MovementInput, } from './components/viewer/bvh-ecctrl';
+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 { 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 { WalkthroughControls } from './components/viewer/walkthrough-controls';
+export { SceneEnvironment } from './components/viewer/scene-environment';
 export { useAssetUrl } from './hooks/use-asset-url';
 export { useGLTFKTX2 } from './hooks/use-gltf-ktx2';
 export { useNodeEvents } from './hooks/use-node-events';
 export { ASSETS_CDN_URL, resolveAssetUrl, resolveCdnUrl } from './lib/asset-url';
-export { ADDITION, Brush, computeGeometryBoundsTree, csgEvaluator, csgGeometry, csgMaterials, prepareBrushForCSG, SUBTRACTION, } from './lib/csg-utils';
+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 { 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, resolveSurfaceColor, WHITE_PALETTE, } from './lib/materials';
+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 { 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';
-export { DoorSystem } from './systems/door/door-system';
+export { buildDoorPreviewMesh, DoorSystem, poseDoorMovingParts } from './systems/door/door-system';
 export { ElevatorInteractionSystem } from './systems/elevator/elevator-interaction-system';
-export { FenceSystem, generateFenceGeometry } from './systems/fence/fence-system';
+export { FenceSystem, generateFenceGeometry, generateFenceSlotGeometries, } from './systems/fence/fence-system';
 export { FloorElevationSystem } from './systems/floor-elevation/floor-elevation-system';
 export { GuideSystem } from './systems/guide/guide-system';
 export { InteractiveSystem } from './systems/interactive/interactive-system';
@@ -33,15 +46,16 @@ export { ItemLightSystem } from './systems/item-light/item-light-system';
 export { LevelSystem } from './systems/level/level-system';
 export { snapLevelsToTruePositions } from './systems/level/level-utils';
 export { getRoofMaterialArray } from './systems/roof/roof-materials';
-export { getRoofOuterSurfaceFrameAtPoint, getRoofSegmentBrushes, mapRoofGroupMaterialIndex, ROOF_MATERIAL_SLOT_COUNT, RoofSystem, remapRoofShellFaces, roofCsgDummyMats, type SurfaceFrame, } from './systems/roof/roof-system';
+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';
 export { WallCutout } from './systems/wall/wall-cutout';
 export { getVisibleWallMaterials } from './systems/wall/wall-materials';
 export { WallSystem } from './systems/wall/wall-system';
-export { WindowAnimationSystem } from './systems/window/window-animation-system';
-export { WindowSystem } from './systems/window/window-system';
+export { poseWindowMovingParts, WindowAnimationSystem, } from './systems/window/window-animation-system';
+export { buildWindowPreviewMesh, WindowSystem } from './systems/window/window-system';
 export { ZoneSystem } from './systems/zone/zone-system';
 //# sourceMappingURL=index.d.ts.map

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

@@ -11,33 +11,46 @@ export { ErrorBoundary } from './components/error-boundary';
 // — no per-kind re-exports needed.
 export { NodeRenderer } from './components/renderers/node-renderer';
 export { default as Viewer } from './components/viewer';
+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 { 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 { WalkthroughControls } from './components/viewer/walkthrough-controls';
+export { SceneEnvironment } from './components/viewer/scene-environment';
 export { useAssetUrl } from './hooks/use-asset-url';
 export { useGLTFKTX2 } from './hooks/use-gltf-ktx2';
 export { useNodeEvents } from './hooks/use-node-events';
 export { ASSETS_CDN_URL, resolveAssetUrl, resolveCdnUrl } from './lib/asset-url';
+export { backdropGradient, deepSkyColor, horizonHazeColor } from './lib/backdrop';
+export { applyWorldScaleBoxUVs } from './lib/box-uv';
 // CSG primitives — used by chimney's roof-trim and other kinds whose
 // 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, prepareBrushForCSG, SUBTRACTION, } from './lib/csg-utils';
+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 { 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, resolveSurfaceColor, WHITE_PALETTE, } from './lib/materials';
+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 { 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';
-export { DoorSystem } from './systems/door/door-system';
+export { buildDoorPreviewMesh, DoorSystem, poseDoorMovingParts } from './systems/door/door-system';
 export { ElevatorInteractionSystem } from './systems/elevator/elevator-interaction-system';
 // Fence system follows the wall re-export pattern — composed into the
 // registry-driven fence definition's `def.system`. Removed in Phase 6
 // alongside the legacy fence mount point.
-export { FenceSystem, generateFenceGeometry } from './systems/fence/fence-system';
+export { FenceSystem, generateFenceGeometry, generateFenceSlotGeometries, } from './systems/fence/fence-system';
 // Generic floor-elevation system. Lifts the rendered mesh of any kind
 // whose definition declares `capabilities.floorPlaced` by the slab
 // elevation under its footprint. Replaces the per-kind elevation block
@@ -57,14 +70,17 @@ export { getRoofMaterialArray } from './systems/roof/roof-materials';
 // the roof shell (chimney's self-trim, dormer's virtual-segment cut)
 // read these through the public surface. No kind-specific helpers
 // belong here — those live in `@pascal-app/nodes/<kind>/`.
-export { getRoofOuterSurfaceFrameAtPoint, getRoofSegmentBrushes, mapRoofGroupMaterialIndex, ROOF_MATERIAL_SLOT_COUNT, RoofSystem, remapRoofShellFaces, roofCsgDummyMats, } from './systems/roof/roof-system';
+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
+// roof-wall opening cuts in `@pascal-app/nodes` — keeps shaped holes
+// (arch / rounded / frameless opening) identical across both hosts.
+export { buildOpeningCutoutGeometry, getOpeningCutoutBottomPadding, hasFlatOpeningCutoutBottom, } from './systems/wall/opening-cutout-geometry';
 export { WallCutout } from './systems/wall/wall-cutout';
 export { getVisibleWallMaterials } from './systems/wall/wall-materials';
 // Wall internals re-exported so `@pascal-app/nodes`' registry-driven wall
@@ -72,6 +88,6 @@ export { getVisibleWallMaterials } from './systems/wall/wall-materials';
 // 800+ lines of CSG / mitering logic during Phase 3. These exports are
 // removed in Phase 6 when the legacy mount points are deleted.
 export { WallSystem } from './systems/wall/wall-system';
-export { WindowAnimationSystem } from './systems/window/window-animation-system';
-export { WindowSystem } from './systems/window/window-system';
+export { poseWindowMovingParts, WindowAnimationSystem, } from './systems/window/window-animation-system';
+export { buildWindowPreviewMesh, WindowSystem } from './systems/window/window-system';
 export { ZoneSystem } from './systems/zone/zone-system';

package/dist/lib/backdrop.d.ts

@@ -0,0 +1,33 @@
+/**
+ * Shared backdrop gradient: flat background looking down, a warm haze band
+ * hugging the horizon, the theme sky arriving just above it and deepening
+ * toward the zenith. One formula serves the post-processing backdrop and the
+ * thumbnail pipeline (per-pixel view ray) AND the site horizon disc's
+ * far-field dissolve (per-fragment view direction) — the disc converges to
+ * exactly this colour, so ground and backdrop meet without a seam from any
+ * camera pose.
+ *
+ * `dirY` is the world-space view direction's Y component (horizon = 0).
+ * Colour inputs are TSL nodes (uniforms or literals).
+ */
+export declare function backdropGradient({ dirY, background, haze, sky, skyDeep, }: {
+    dirY: any;
+    background: any;
+    haze: any;
+    sky: any;
+    skyDeep: any;
+}): any;
+/**
+ * Atmospheric haze at the horizon: the theme's *sky* colour pulled toward a
+ * warm sun tint — skyish and sunish at once, so the band reads as part of
+ * the sky rather than a white stripe. Dark themes keep it faint (a low glow
+ * over the night zenith).
+ */
+export declare function horizonHazeColor(sky: string, appearance: 'light' | 'dark'): string;
+/**
+ * Zenith colour derived from the theme's sky: saturated and darkened in HSL
+ * so the hue stays the theme's own (blue studio, lavender sunset, near-black
+ * night) while the top of the frame gets real colour depth.
+ */
+export declare function deepSkyColor(sky: string): string;
+//# sourceMappingURL=backdrop.d.ts.map

package/dist/lib/backdrop.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"backdrop.d.ts","sourceRoot":"","sources":["../../src/lib/backdrop.ts"],"names":[],"mappings":"AAEA;;;;;;;;;;;GAWG;AACH,wBAAgB,gBAAgB,CAAC,EAC/B,IAAI,EACJ,UAAU,EACV,IAAI,EACJ,GAAG,EACH,OAAO,GACR,EAAE;IACD,IAAI,EAAE,GAAG,CAAA;IACT,UAAU,EAAE,GAAG,CAAA;IACf,IAAI,EAAE,GAAG,CAAA;IACT,GAAG,EAAE,GAAG,CAAA;IACR,OAAO,EAAE,GAAG,CAAA;CACb,GAAG,GAAG,CAUN;AAMD;;;;;GAKG;AACH,wBAAgB,gBAAgB,CAAC,GAAG,EAAE,MAAM,EAAE,UAAU,EAAE,OAAO,GAAG,MAAM,GAAG,MAAM,CAWlF;AAED;;;;GAIG;AACH,wBAAgB,YAAY,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAyChD"}

package/dist/lib/backdrop.js

@@ -0,0 +1,92 @@
+import { abs, exp, mix, smoothstep } from 'three/tsl';
+/**
+ * Shared backdrop gradient: flat background looking down, a warm haze band
+ * hugging the horizon, the theme sky arriving just above it and deepening
+ * toward the zenith. One formula serves the post-processing backdrop and the
+ * thumbnail pipeline (per-pixel view ray) AND the site horizon disc's
+ * far-field dissolve (per-fragment view direction) — the disc converges to
+ * exactly this colour, so ground and backdrop meet without a seam from any
+ * camera pose.
+ *
+ * `dirY` is the world-space view direction's Y component (horizon = 0).
+ * Colour inputs are TSL nodes (uniforms or literals).
+ */
+export function backdropGradient({ dirY, background, haze, sky, skyDeep, }) {
+    // The pale sky arrives fast (full by ≈8° elevation) so eye-level frames
+    // actually show it, then deepens toward the zenith for a real gradient —
+    // a single pale stop reads as a white void with blue "hiding" up top.
+    let base = mix(background, sky, smoothstep(-0.02, 0.14, dirY));
+    base = mix(base, skyDeep, smoothstep(0.1, 0.55, dirY));
+    // Haze as an exponential glow hugging the horizon tightly: C¹-smooth on
+    // both sides, so it brightens the junction without ever drawing an edge.
+    const hazeWeight = exp(abs(dirY).mul(-11)).mul(0.8);
+    return mix(base, haze, hazeWeight);
+}
+// Warm sun tint the haze pulls toward — aerial perspective is sky-coloured
+// light plus a little sun scatter, not white fog.
+const HAZE_SUN_TINT = [255, 244, 222];
+/**
+ * Atmospheric haze at the horizon: the theme's *sky* colour pulled toward a
+ * warm sun tint — skyish and sunish at once, so the band reads as part of
+ * the sky rather than a white stripe. Dark themes keep it faint (a low glow
+ * over the night zenith).
+ */
+export function horizonHazeColor(sky, appearance) {
+    const amount = appearance === 'dark' ? 0.25 : 0.5;
+    const hex = sky.replace('#', '');
+    let out = '#';
+    for (let i = 0; i < 3; i++) {
+        const c = Number.parseInt(hex.slice(i * 2, i * 2 + 2), 16);
+        out += Math.round(c + (HAZE_SUN_TINT[i] - c) * amount)
+            .toString(16)
+            .padStart(2, '0');
+    }
+    return out;
+}
+/**
+ * Zenith colour derived from the theme's sky: saturated and darkened in HSL
+ * so the hue stays the theme's own (blue studio, lavender sunset, near-black
+ * night) while the top of the frame gets real colour depth.
+ */
+export function deepSkyColor(sky) {
+    const hex = sky.replace('#', '');
+    const r = Number.parseInt(hex.slice(0, 2), 16) / 255;
+    const g = Number.parseInt(hex.slice(2, 4), 16) / 255;
+    const b = Number.parseInt(hex.slice(4, 6), 16) / 255;
+    const max = Math.max(r, g, b);
+    const min = Math.min(r, g, b);
+    const l = (max + min) / 2;
+    const d = max - min;
+    let h = 0;
+    let s = 0;
+    if (d > 0) {
+        s = d / (1 - Math.abs(2 * l - 1));
+        if (max === r)
+            h = ((g - b) / d + (g < b ? 6 : 0)) / 6;
+        else if (max === g)
+            h = ((b - r) / d + 2) / 6;
+        else
+            h = ((r - g) / d + 4) / 6;
+    }
+    const s2 = Math.min(1, s * 1.5 + 0.05);
+    const l2 = l * 0.72;
+    const c = (1 - Math.abs(2 * l2 - 1)) * s2;
+    const x = c * (1 - Math.abs(((h * 6) % 2) - 1));
+    const m = l2 - c / 2;
+    const sector = Math.floor(h * 6) % 6;
+    const rgb = [
+        [c, x, 0],
+        [x, c, 0],
+        [0, c, x],
+        [0, x, c],
+        [x, 0, c],
+        [c, 0, x],
+    ][sector];
+    let out = '#';
+    for (const channel of rgb) {
+        out += Math.round((channel + m) * 255)
+            .toString(16)
+            .padStart(2, '0');
+    }
+    return out;
+}

package/dist/lib/box-uv.d.ts

@@ -0,0 +1,13 @@
+import type { BoxGeometry } from 'three';
+/**
+ * Rewrite a default `BoxGeometry`'s UVs to world scale — 1 UV unit = 1 metre —
+ * so tiled finishes (with `repeat` in tiles-per-metre) render at a consistent
+ * real-world scale instead of stretching to fit each face. Matches the
+ * world-scale UV convention used by the procedural slab/wall geometry.
+ *
+ * three.js builds box faces in the fixed order [+X, -X, +Y, -Y, +Z, -Z], four
+ * verts each, with UVs spanning 0→1 across the face. Each face's two in-plane
+ * dimensions differ, so we scale U/V per face by that face's size in metres.
+ */
+export declare function applyWorldScaleBoxUVs(geometry: BoxGeometry, w: number, h: number, d: number): void;
+//# sourceMappingURL=box-uv.d.ts.map

package/dist/lib/box-uv.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"box-uv.d.ts","sourceRoot":"","sources":["../../src/lib/box-uv.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,OAAO,CAAA;AAExC;;;;;;;;;GASG;AACH,wBAAgB,qBAAqB,CACnC,QAAQ,EAAE,WAAW,EACrB,CAAC,EAAE,MAAM,EACT,CAAC,EAAE,MAAM,EACT,CAAC,EAAE,MAAM,GACR,IAAI,CAsBN"}

package/dist/lib/box-uv.js

@@ -0,0 +1,32 @@
+/**
+ * Rewrite a default `BoxGeometry`'s UVs to world scale — 1 UV unit = 1 metre —
+ * so tiled finishes (with `repeat` in tiles-per-metre) render at a consistent
+ * real-world scale instead of stretching to fit each face. Matches the
+ * world-scale UV convention used by the procedural slab/wall geometry.
+ *
+ * three.js builds box faces in the fixed order [+X, -X, +Y, -Y, +Z, -Z], four
+ * verts each, with UVs spanning 0→1 across the face. Each face's two in-plane
+ * dimensions differ, so we scale U/V per face by that face's size in metres.
+ */
+export function applyWorldScaleBoxUVs(geometry, w, h, d) {
+    const uv = geometry.getAttribute('uv');
+    if (!uv || uv.count < 24)
+        return; // non-default segmentation — leave as-is
+    // [uScaleMetres, vScaleMetres] per face, in three's face order.
+    const faceScale = [
+        [d, h], // +X
+        [d, h], // -X
+        [w, d], // +Y
+        [w, d], // -Y
+        [w, h], // +Z
+        [w, h], // -Z
+    ];
+    for (let face = 0; face < 6; face += 1) {
+        const [us, vs] = faceScale[face];
+        for (let v = 0; v < 4; v += 1) {
+            const i = face * 4 + v;
+            uv.setXY(i, uv.getX(i) * us, uv.getY(i) * vs);
+        }
+    }
+    uv.needsUpdate = true;
+}

package/dist/lib/csg-utils.d.ts

@@ -1,16 +1,10 @@
-import type * as THREE from 'three';
+import * as THREE from 'three';
 import { type Brush, Evaluator } from 'three-bvh-csg';
-/**
- * Shared CSG primitives used by kinds whose geometry subtracts pieces
- * against their host (chimney trimmed by the roof shell, skylight
- * frame as a ring cut from a box, etc.). Lives in viewer because
- * three-bvh-csg + three-mesh-bvh are viewer-only deps; kinds living
- * in `@pascal-app/nodes` import these through the public surface.
- */
+export declare function ensureRenderableGeometryAttributes(geometry: THREE.BufferGeometry): THREE.BufferGeometry;
 export declare function csgGeometry(brush: Brush): THREE.BufferGeometry;
 export declare function csgMaterials(brush: Brush): THREE.Material[];
 export declare const csgEvaluator: Evaluator;
 export declare function computeGeometryBoundsTree(geometry: THREE.BufferGeometry): void;
 export declare function prepareBrushForCSG(brush: Brush): void;
-export { ADDITION, Brush, SUBTRACTION } from 'three-bvh-csg';
+export { ADDITION, Brush, INTERSECTION, SUBTRACTION } from 'three-bvh-csg';
 //# sourceMappingURL=csg-utils.d.ts.map

package/dist/lib/csg-utils.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"csg-utils.d.ts","sourceRoot":"","sources":["../../src/lib/csg-utils.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,KAAK,KAAK,MAAM,OAAO,CAAA;AACnC,OAAO,EAAE,KAAK,KAAK,EAAE,SAAS,EAAE,MAAM,eAAe,CAAA;AAGrD;;;;;;GAMG;AAEH,wBAAgB,WAAW,CAAC,KAAK,EAAE,KAAK,GAAG,KAAK,CAAC,cAAc,CAE9D;AAED,wBAAgB,YAAY,CAAC,KAAK,EAAE,KAAK,GAAG,KAAK,CAAC,QAAQ,EAAE,CAG3D;AAED,eAAO,MAAM,YAAY,WAAkB,CAAA;AAK3C,wBAAgB,yBAAyB,CAAC,QAAQ,EAAE,KAAK,CAAC,cAAc,QAMvE;AAED,wBAAgB,kBAAkB,CAAC,KAAK,EAAE,KAAK,QAG9C;AAID,OAAO,EAAE,QAAQ,EAAE,KAAK,EAAE,WAAW,EAAE,MAAM,eAAe,CAAA"}
+{"version":3,"file":"csg-utils.d.ts","sourceRoot":"","sources":["../../src/lib/csg-utils.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,KAAK,MAAM,OAAO,CAAA;AAC9B,OAAO,EAAE,KAAK,KAAK,EAAE,SAAS,EAAE,MAAM,eAAe,CAAA;AA4CrD,wBAAgB,kCAAkC,CAChD,QAAQ,EAAE,KAAK,CAAC,cAAc,GAC7B,KAAK,CAAC,cAAc,CAoCtB;AAED,wBAAgB,WAAW,CAAC,KAAK,EAAE,KAAK,GAAG,KAAK,CAAC,cAAc,CAE9D;AAED,wBAAgB,YAAY,CAAC,KAAK,EAAE,KAAK,GAAG,KAAK,CAAC,QAAQ,EAAE,CAG3D;AAED,eAAO,MAAM,YAAY,WAAkB,CAAA;AAK3C,wBAAgB,yBAAyB,CAAC,QAAQ,EAAE,KAAK,CAAC,cAAc,QAMvE;AAED,wBAAgB,kBAAkB,CAAC,KAAK,EAAE,KAAK,QAI9C;AAID,OAAO,EAAE,QAAQ,EAAE,KAAK,EAAE,YAAY,EAAE,WAAW,EAAE,MAAM,eAAe,CAAA"}