@pascal-app/viewer 0.8.0 → 0.9.2

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

@@ -14,18 +14,38 @@ export function useNodeEvents(node, type) {
             stopPropagation: () => e.stopPropagation(),
             nativeEvent: e,
         };
+        // `emitter.emit` is typed over a fixed union of `${kind}:${suffix}`
+        // keys; the `as never` cast lets us emit a kind-specific payload
+        // through that generic surface without enumerating every kind.
         emitter.emit(eventKey, payload);
     };
+    // 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 (useViewer.getState().cameraDragging)
+            if (selectionSuppressed())
                 return;
             if (e.button !== 0)
                 return;
             emit('pointerdown', e);
         },
         onPointerUp: (e) => {
-            if (useViewer.getState().cameraDragging)
+            if (selectionSuppressed())
                 return;
             if (e.button !== 0)
                 return;
@@ -34,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 (useViewer.getState().cameraDragging)
+            if (spatialSuppressed())
                 return;
             emit('enter', e);
         },
         onPointerLeave: (e) => {
-            if (useViewer.getState().cameraDragging)
+            if (spatialSuppressed())
                 return;
             emit('leave', e);
         },
         onPointerMove: (e) => {
-            if (useViewer.getState().cameraDragging)
+            if (spatialSuppressed())
                 return;
             emit('move', e);
         },
         onDoubleClick: (e) => {
-            if (useViewer.getState().cameraDragging)
+            if (selectionSuppressed())
                 return;
             emit('double-click', e);
         },
         onContextMenu: (e) => {
-            if (useViewer.getState().cameraDragging)
+            if (selectionSuppressed())
                 return;
             emit('context-menu', e);
         },

package/dist/index.d.ts

@@ -1,15 +1,58 @@
-export { default as Viewer } from './components/viewer';
+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 { GlbWalkthroughController } 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';
 export { ASSETS_CDN_URL, resolveAssetUrl, resolveCdnUrl } from './lib/asset-url';
-export { SCENE_LAYER, ZONE_LAYER } from './lib/layers';
-export { applyMaterialPresetToMaterials, clearMaterialCache, createDefaultMaterial, createMaterial, createMaterialFromPresetRef, DEFAULT_CEILING_MATERIAL, DEFAULT_DOOR_MATERIAL, DEFAULT_ROOF_MATERIAL, DEFAULT_SLAB_MATERIAL, DEFAULT_WALL_MATERIAL, DEFAULT_WINDOW_MATERIAL, disposeMaterial, glassMaterial, } from './lib/materials';
+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 { applyIsolation, clearIsolation, collectIsolationSubtree, isIsolationActive, } from './lib/isolation';
+export { 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 { default as useViewer } from './store/use-viewer';
+export { unionPolygons } from './lib/polygon-union';
+export { getSceneTheme, SCENE_THEME_IDS, SCENE_THEMES, type SceneTheme, } from './lib/scene-themes';
+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 { 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 { buildDoorPreviewMesh, DoorSystem, poseDoorMovingParts } from './systems/door/door-system';
+export { ElevatorInteractionSystem } from './systems/elevator/elevator-interaction-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';
+export { ItemSystem } from './systems/item/item-system';
+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 { getStairBodyMaterials, getStairRailingMaterial } from './systems/stair/stair-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 { 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 { 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":"AAAA,OAAO,EAAE,OAAO,IAAI,MAAM,EAAE,MAAM,qBAAqB,CAAA;AACvD,YAAY,EAAE,UAAU,EAAE,WAAW,EAAE,MAAM,qCAAqC,CAAA;AAClF,OAAO,EACL,oBAAoB,EACpB,WAAW,GACZ,MAAM,qCAAqC,CAAA;AAC5C,OAAO,EAAE,mBAAmB,EAAE,MAAM,0CAA0C,CAAA;AAC9E,OAAO,EAAE,cAAc,EAAE,eAAe,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAA;AAChF,OAAO,EAAE,WAAW,EAAE,UAAU,EAAE,MAAM,cAAc,CAAA;AACtD,OAAO,EACL,8BAA8B,EAC9B,kBAAkB,EAClB,qBAAqB,EACrB,cAAc,EACd,2BAA2B,EAC3B,wBAAwB,EACxB,qBAAqB,EACrB,qBAAqB,EACrB,qBAAqB,EACrB,qBAAqB,EACrB,uBAAuB,EACvB,eAAe,EACf,aAAa,GACd,MAAM,iBAAiB,CAAA;AACxB,OAAO,EAAE,aAAa,EAAE,MAAM,2BAA2B,CAAA;AACzD,OAAO,EAAE,OAAO,IAAI,SAAS,EAAE,MAAM,oBAAoB,CAAA;AACzD,OAAO,EAAE,iBAAiB,EAAE,MAAM,0CAA0C,CAAA;AAC5E,OAAO,EAAE,yBAAyB,EAAE,MAAM,6BAA6B,CAAA;AACvE,OAAO,EAAE,oBAAoB,EAAE,MAAM,+BAA+B,CAAA;AACpE,OAAO,EAAE,qBAAqB,EAAE,uBAAuB,EAAE,MAAM,iCAAiC,CAAA;AAChG,OAAO,EAAE,uBAAuB,EAAE,MAAM,+BAA+B,CAAA"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"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"}

package/dist/index.js

@@ -1,13 +1,91 @@
+// `NodeRenderer` is the recursive dispatch component used by parent
+// renderers (wall renders doors/windows, slab renders hosted items).
+// Public so registry-driven kinds can compose children without reaching
+// into viewer's internal paths.
+export { ErrorBoundary } from './components/error-boundary';
+// Stage A wrap-exports for the rest of the kinds — `@pascal-app/nodes`
+// registers each via `def.renderer` (and `def.system` when present)
+// Generic dispatch component used by recursive renderers (e.g. level →
+// children, building → children). The per-kind renderers live in
+// `@pascal-app/nodes/<kind>/renderer.tsx` and are loaded by the registry
+// — 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 { GlbWalkthroughController } 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';
 export { ASSETS_CDN_URL, resolveAssetUrl, resolveCdnUrl } from './lib/asset-url';
-export { SCENE_LAYER, ZONE_LAYER } from './lib/layers';
-export { applyMaterialPresetToMaterials, clearMaterialCache, createDefaultMaterial, createMaterial, createMaterialFromPresetRef, DEFAULT_CEILING_MATERIAL, DEFAULT_DOOR_MATERIAL, DEFAULT_ROOF_MATERIAL, DEFAULT_SLAB_MATERIAL, DEFAULT_WALL_MATERIAL, DEFAULT_WINDOW_MATERIAL, disposeMaterial, glassMaterial, } from './lib/materials';
+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, INTERSECTION, prepareBrushForCSG, SUBTRACTION, } from './lib/csg-utils';
+export { applyIsolation, clearIsolation, collectIsolationSubtree, isIsolationActive, } from './lib/isolation';
+export { 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 { default as useViewer } from './store/use-viewer';
+export { unionPolygons } from './lib/polygon-union';
+export { getSceneTheme, SCENE_THEME_IDS, SCENE_THEMES, } from './lib/scene-themes';
+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 { 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 { 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, 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
+// that used to live inside `ItemSystem`.
+export { FloorElevationSystem } from './systems/floor-elevation/floor-elevation-system';
+export { GuideSystem } from './systems/guide/guide-system';
 export { InteractiveSystem } from './systems/interactive/interactive-system';
+// Item systems for the registry-driven item definition. ItemSystem
+// applies attachTo-driven transforms each frame; ItemLightSystem
+// manages item-mounted light sources.
+export { ItemSystem } from './systems/item/item-system';
+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 { getStairBodyMaterials, getStairRailingMaterial } from './systems/stair/stair-materials';
+// Generic roof-segment primitives. Kinds that compose CSG against
+// 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 { 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';
+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
+// definition can compose them into `def.system` without duplicating the
+// 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 { 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

@@ -0,0 +1,10 @@
+import * as THREE from 'three';
+import { type Brush, Evaluator } from 'three-bvh-csg';
+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, INTERSECTION, SUBTRACTION } from 'three-bvh-csg';
+//# sourceMappingURL=csg-utils.d.ts.map

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

@@ -0,0 +1 @@
+{"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"}

package/dist/lib/csg-utils.js

@@ -0,0 +1,93 @@
+import * as THREE from 'three';
+import { Evaluator } from 'three-bvh-csg';
+import { computeBoundsTree } from 'three-mesh-bvh';
+/**
+ * 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.
+ */
+function zeroAttribute(count, itemSize) {
+    return new THREE.Float32BufferAttribute(new Float32Array(count * itemSize), itemSize);
+}
+function upNormalAttribute(count) {
+    const values = new Float32Array(count * 3);
+    for (let index = 0; index < count; index += 1) {
+        values[index * 3 + 1] = 1;
+    }
+    return new THREE.Float32BufferAttribute(values, 3);
+}
+function ensureAttributeCount(geometry, name, itemSize, count) {
+    const attribute = geometry.getAttribute(name);
+    if (attribute?.count === count && attribute.itemSize === itemSize)
+        return;
+    geometry.setAttribute(name, zeroAttribute(count, itemSize));
+}
+function copyVec2Attribute(attribute) {
+    const values = new Float32Array(attribute.count * 2);
+    for (let index = 0; index < attribute.count; index += 1) {
+        values[index * 2] = attribute.getX(index);
+        values[index * 2 + 1] = attribute.getY(index);
+    }
+    return new THREE.Float32BufferAttribute(values, 2);
+}
+export function ensureRenderableGeometryAttributes(geometry) {
+    const position = geometry.getAttribute('position');
+    if (!position || position.count === 0 || position.itemSize !== 3) {
+        geometry.setIndex(null);
+        geometry.clearGroups();
+        geometry.setAttribute('position', zeroAttribute(3, 3));
+        geometry.setAttribute('normal', upNormalAttribute(3));
+        geometry.setAttribute('uv', zeroAttribute(3, 2));
+        geometry.setAttribute('uv2', zeroAttribute(3, 2));
+        return geometry;
+    }
+    const count = position.count;
+    const normal = geometry.getAttribute('normal');
+    if (normal?.count !== count || normal.itemSize !== 3) {
+        geometry.deleteAttribute('normal');
+        try {
+            geometry.computeVertexNormals();
+        }
+        catch {
+            geometry.deleteAttribute('normal');
+        }
+    }
+    const computedNormal = geometry.getAttribute('normal');
+    if (computedNormal?.count !== count || computedNormal.itemSize !== 3) {
+        geometry.setAttribute('normal', upNormalAttribute(count));
+    }
+    ensureAttributeCount(geometry, 'uv', 2, count);
+    const uv = geometry.getAttribute('uv');
+    const uv2 = geometry.getAttribute('uv2');
+    if (uv2?.count !== count || uv2.itemSize !== 2) {
+        geometry.setAttribute('uv2', copyVec2Attribute(uv));
+    }
+    return geometry;
+}
+export function csgGeometry(brush) {
+    return ensureRenderableGeometryAttributes(brush.geometry);
+}
+export function csgMaterials(brush) {
+    const mat = brush.material;
+    return Array.isArray(mat) ? mat : [mat];
+}
+export const csgEvaluator = new Evaluator();
+csgEvaluator.useGroups = true;
+csgEvaluator.consolidateGroups = false;
+csgEvaluator.attributes = ['position', 'normal', 'uv', 'uv2'];
+export function computeGeometryBoundsTree(geometry) {
+    ;
+    geometry.computeBoundsTree =
+        computeBoundsTree;
+    geometry.computeBoundsTree({ maxLeafSize: 10 });
+}
+export function prepareBrushForCSG(brush) {
+    ensureRenderableGeometryAttributes(brush.geometry);
+    computeGeometryBoundsTree(brush.geometry);
+    brush.updateMatrixWorld();
+}
+// Re-export Brush + SUBTRACTION + ADDITION + INTERSECTION so kinds don't need a
+// direct `three-bvh-csg` dependency.
+export { ADDITION, Brush, INTERSECTION, SUBTRACTION } from 'three-bvh-csg';

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

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

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

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

package/dist/lib/csg-utils.test.js

@@ -0,0 +1,45 @@
+// @ts-expect-error — bun:test is provided by the Bun runtime; viewer does not
+// depend on @types/bun so the import type is unresolved at compile time.
+import { describe, expect, test } from 'bun:test';
+import * as THREE from 'three';
+import { ensureRenderableGeometryAttributes } from './csg-utils';
+describe('ensureRenderableGeometryAttributes', () => {
+    test('fills missing render attributes to match position count', () => {
+        const geometry = new THREE.BufferGeometry();
+        geometry.setAttribute('position', new THREE.Float32BufferAttribute(new Float32Array([0, 0, 0, 1, 0, 0, 0, 1, 0]), 3));
+        ensureRenderableGeometryAttributes(geometry);
+        expect(geometry.getAttribute('position')?.count).toBe(3);
+        expect(geometry.getAttribute('normal')?.count).toBe(3);
+        expect(geometry.getAttribute('uv')?.count).toBe(3);
+        expect(geometry.getAttribute('uv2')?.count).toBe(3);
+    });
+    test('replaces render attributes with the wrong item size', () => {
+        const geometry = new THREE.BufferGeometry();
+        geometry.setAttribute('position', new THREE.Float32BufferAttribute(new Float32Array([0, 0, 0, 1, 0, 0, 0, 1, 0]), 3));
+        geometry.setAttribute('uv', new THREE.Float32BufferAttribute(new Float32Array([0, 0, 0]), 1));
+        geometry.setAttribute('uv2', new THREE.Float32BufferAttribute(new Float32Array([0, 0, 0]), 1));
+        ensureRenderableGeometryAttributes(geometry);
+        expect(geometry.getAttribute('uv')?.itemSize).toBe(2);
+        expect(geometry.getAttribute('uv2')?.itemSize).toBe(2);
+        expect(geometry.getAttribute('uv')?.count).toBe(3);
+        expect(geometry.getAttribute('uv2')?.count).toBe(3);
+    });
+    test('copies uv into uv2 without depending on backing array layout', () => {
+        const geometry = new THREE.BufferGeometry();
+        geometry.setAttribute('position', new THREE.Float32BufferAttribute(new Float32Array([0, 0, 0, 1, 0, 0, 0, 1, 0]), 3));
+        geometry.setAttribute('uv', new THREE.InterleavedBufferAttribute(new THREE.InterleavedBuffer(new Float32Array([0, 0, 7, 1, 0, 8, 0, 1, 9]), 3), 2, 0));
+        ensureRenderableGeometryAttributes(geometry);
+        const uv2 = geometry.getAttribute('uv2');
+        expect(Array.from(uv2.array)).toEqual([0, 0, 1, 0, 0, 1]);
+    });
+    test('replaces empty geometries with a degenerate renderable triangle', () => {
+        const geometry = new THREE.BufferGeometry();
+        ensureRenderableGeometryAttributes(geometry);
+        expect(geometry.getIndex()).toBeNull();
+        expect(geometry.groups).toHaveLength(0);
+        expect(geometry.getAttribute('position')?.count).toBe(3);
+        expect(geometry.getAttribute('normal')?.count).toBe(3);
+        expect(geometry.getAttribute('uv')?.count).toBe(3);
+        expect(geometry.getAttribute('uv2')?.count).toBe(3);
+    });
+});

package/dist/lib/drawable-geometry.d.ts

@@ -0,0 +1,21 @@
+import type { BufferGeometry } from 'three';
+/**
+ * True when `geometry` has a bound, non-empty `position` attribute — i.e. it is
+ * safe to submit to the WebGPU renderer.
+ *
+ * A geometry whose `position` attribute has `count === 0` (or no `position` at
+ * all) leaves WebGPU **vertex buffer slot 0 unbound**. The validator rejects the
+ * draw with "Vertex buffer slot 0 … was not set", and — critically — that single
+ * rejected draw **poisons the entire command encoder**: every other draw in the
+ * frame (the whole scene + every editor overlay) is discarded on the next queue
+ * submit ("Invalid CommandBuffer"). The visible result is the whole canvas
+ * flickering/garbling, not just the offending mesh.
+ *
+ * Individual call-sites guard against *creating* empty geometry (see
+ * `createPlaceholderGeometry`, the ceiling/door degenerate fallbacks, etc.), but
+ * transient/derived geometries can still slip through. This predicate is the
+ * renderer-level safety net: skipping a count-0 draw is a no-op visually (it
+ * would draw nothing anyway) while keeping the command encoder healthy.
+ */
+export declare function hasDrawableGeometry(geometry: BufferGeometry | undefined | null): boolean;
+//# sourceMappingURL=drawable-geometry.d.ts.map

package/dist/lib/drawable-geometry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"drawable-geometry.d.ts","sourceRoot":"","sources":["../../src/lib/drawable-geometry.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,OAAO,CAAA;AAE3C;;;;;;;;;;;;;;;;;GAiBG;AACH,wBAAgB,mBAAmB,CAAC,QAAQ,EAAE,cAAc,GAAG,SAAS,GAAG,IAAI,GAAG,OAAO,CAGxF"}