@pascal-app/viewer 0.7.0 → 0.9.1

package/dist/store/use-viewer.d.ts

@@ -1,5 +1,8 @@
 import type { AnyNode, BaseNode, BuildingNode, LevelNode, ZoneNode } from '@pascal-app/core';
 import type { Object3D } from 'three';
+import type { EdgeMode } from '../lib/edge-style';
+import type { ColorPreset, RenderShading } from '../lib/materials';
+export type RenderContext = 'editor' | 'viewer';
 type SelectionPath = {
     buildingId: BuildingNode['id'] | null;
     levelId: LevelNode['id'] | null;
@@ -20,8 +23,21 @@ type ViewerState = {
     setHoveredId: (id: AnyNode['id'] | ZoneNode['id'] | null) => void;
     cameraMode: 'perspective' | 'orthographic';
     setCameraMode: (mode: 'perspective' | 'orthographic') => void;
-    theme: 'light' | 'dark';
-    setTheme: (theme: 'light' | 'dark') => void;
+    sceneTheme: string;
+    setSceneTheme: (id: string) => void;
+    renderContext: RenderContext;
+    setRenderContext: (context: RenderContext) => void;
+    shading: RenderShading;
+    shadingByContext: Partial<Record<RenderContext, RenderShading>>;
+    setShading: (shading: RenderShading) => void;
+    textures: boolean;
+    setTextures: (textures: boolean) => void;
+    colorPreset: ColorPreset;
+    setColorPreset: (preset: ColorPreset) => void;
+    edges: EdgeMode;
+    setEdges: (edges: EdgeMode) => void;
+    shadows: boolean;
+    setShadows: (shadows: boolean) => void;
     unit: 'metric' | 'imperial';
     setUnit: (unit: 'metric' | 'imperial') => void;
     levelMode: 'stacked' | 'exploded' | 'solo' | 'manual';
@@ -52,6 +68,18 @@ type ViewerState = {
     setWalkthroughMode: (mode: boolean) => void;
     cameraDragging: boolean;
     setCameraDragging: (dragging: boolean) => void;
+    /**
+     * True while a host-driven drag is in progress (editor handles —
+     * height arrow, width arrow, etc.). Suppresses node pointer event
+     * routing so the synthetic click on pointerup doesn't reroute
+     * selection to whatever mesh the cursor lands on at release.
+     * Conceptually a sibling of `cameraDragging` — both mean "user is
+     * dragging; don't treat the next pointerup as a click on the
+     * scene." Set by the host (e.g. `NodeArrowHandles` in the editor);
+     * the viewer only reads it.
+     */
+    inputDragging: boolean;
+    setInputDragging: (dragging: boolean) => void;
 };
 declare const useViewer: import("zustand").UseBoundStore<Omit<import("zustand").StoreApi<ViewerState>, "setState" | "persist"> & {
     setState(partial: ViewerState | Partial<ViewerState> | ((state: ViewerState) => ViewerState | Partial<ViewerState>), replace?: false | undefined): unknown;
@@ -59,7 +87,12 @@ declare const useViewer: import("zustand").UseBoundStore<Omit<import("zustand").
     persist: {
         setOptions: (options: Partial<import("zustand/middleware").PersistOptions<ViewerState, {
             cameraMode: "perspective" | "orthographic";
-            theme: "light" | "dark";
+            sceneTheme: string;
+            shadingByContext: Partial<Record<RenderContext, RenderShading>>;
+            textures: boolean;
+            colorPreset: ColorPreset;
+            edges: EdgeMode;
+            shadows: boolean;
             unit: "metric" | "imperial";
             levelMode: "manual" | "stacked" | "exploded" | "solo";
             wallMode: "up" | "down" | "cutaway";
@@ -76,7 +109,12 @@ declare const useViewer: import("zustand").UseBoundStore<Omit<import("zustand").
         onFinishHydration: (fn: (state: ViewerState) => void) => () => void;
         getOptions: () => Partial<import("zustand/middleware").PersistOptions<ViewerState, {
             cameraMode: "perspective" | "orthographic";
-            theme: "light" | "dark";
+            sceneTheme: string;
+            shadingByContext: Partial<Record<RenderContext, RenderShading>>;
+            textures: boolean;
+            colorPreset: ColorPreset;
+            edges: EdgeMode;
+            shadows: boolean;
             unit: "metric" | "imperial";
             levelMode: "manual" | "stacked" | "exploded" | "solo";
             wallMode: "up" | "down" | "cutaway";

package/dist/store/use-viewer.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"use-viewer.d.ts","sourceRoot":"","sources":["../../src/store/use-viewer.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"use-viewer.d.ts","sourceRoot":"","sources":["../../src/store/use-viewer.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,OAAO,EAAE,QAAQ,EAAE,YAAY,EAAE,SAAS,EAAE,QAAQ,EAAE,MAAM,kBAAkB,CAAA;AAC5F,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,OAAO,CAAA;AAIrC,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,mBAAmB,CAAA;AACjD,OAAO,KAAK,EAAE,WAAW,EAAE,aAAa,EAAE,MAAM,kBAAkB,CAAA;AAElE,MAAM,MAAM,aAAa,GAAG,QAAQ,GAAG,QAAQ,CAAA;AAE/C,KAAK,aAAa,GAAG;IACnB,UAAU,EAAE,YAAY,CAAC,IAAI,CAAC,GAAG,IAAI,CAAA;IACrC,OAAO,EAAE,SAAS,CAAC,IAAI,CAAC,GAAG,IAAI,CAAA;IAC/B,MAAM,EAAE,QAAQ,CAAC,IAAI,CAAC,GAAG,IAAI,CAAA;IAC7B,WAAW,EAAE,QAAQ,CAAC,IAAI,CAAC,EAAE,CAAA;CAC9B,CAAA;AAED,KAAK,QAAQ,GAAG;IACd,eAAe,EAAE,QAAQ,EAAE,CAAA;IAC3B,cAAc,EAAE,QAAQ,EAAE,CAAA;CAC3B,CAAA;AAED,KAAK,WAAW,GAAG;IACjB,SAAS,EAAE,aAAa,CAAA;IACxB,kBAAkB,EAAE,QAAQ,CAAC,IAAI,CAAC,EAAE,CAAA;IACpC,qBAAqB,EAAE,CAAC,GAAG,EAAE,QAAQ,CAAC,IAAI,CAAC,EAAE,KAAK,IAAI,CAAA;IACtD,kBAAkB,EAAE,MAAM,CAAA;IAC1B,qBAAqB,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,CAAA;IAC7C,SAAS,EAAE,OAAO,CAAC,IAAI,CAAC,GAAG,QAAQ,CAAC,IAAI,CAAC,GAAG,IAAI,CAAA;IAChD,YAAY,EAAE,CAAC,EAAE,EAAE,OAAO,CAAC,IAAI,CAAC,GAAG,QAAQ,CAAC,IAAI,CAAC,GAAG,IAAI,KAAK,IAAI,CAAA;IAEjE,UAAU,EAAE,aAAa,GAAG,cAAc,CAAA;IAC1C,aAAa,EAAE,CAAC,IAAI,EAAE,aAAa,GAAG,cAAc,KAAK,IAAI,CAAA;IAE7D,UAAU,EAAE,MAAM,CAAA;IAClB,aAAa,EAAE,CAAC,EAAE,EAAE,MAAM,KAAK,IAAI,CAAA;IAEnC,aAAa,EAAE,aAAa,CAAA;IAC5B,gBAAgB,EAAE,CAAC,OAAO,EAAE,aAAa,KAAK,IAAI,CAAA;IAElD,OAAO,EAAE,aAAa,CAAA;IACtB,gBAAgB,EAAE,OAAO,CAAC,MAAM,CAAC,aAAa,EAAE,aAAa,CAAC,CAAC,CAAA;IAC/D,UAAU,EAAE,CAAC,OAAO,EAAE,aAAa,KAAK,IAAI,CAAA;IAE5C,QAAQ,EAAE,OAAO,CAAA;IACjB,WAAW,EAAE,CAAC,QAAQ,EAAE,OAAO,KAAK,IAAI,CAAA;IAExC,WAAW,EAAE,WAAW,CAAA;IACxB,cAAc,EAAE,CAAC,MAAM,EAAE,WAAW,KAAK,IAAI,CAAA;IAE7C,KAAK,EAAE,QAAQ,CAAA;IACf,QAAQ,EAAE,CAAC,KAAK,EAAE,QAAQ,KAAK,IAAI,CAAA;IAEnC,OAAO,EAAE,OAAO,CAAA;IAChB,UAAU,EAAE,CAAC,OAAO,EAAE,OAAO,KAAK,IAAI,CAAA;IAEtC,IAAI,EAAE,QAAQ,GAAG,UAAU,CAAA;IAC3B,OAAO,EAAE,CAAC,IAAI,EAAE,QAAQ,GAAG,UAAU,KAAK,IAAI,CAAA;IAE9C,SAAS,EAAE,SAAS,GAAG,UAAU,GAAG,MAAM,GAAG,QAAQ,CAAA;IACrD,YAAY,EAAE,CAAC,IAAI,EAAE,SAAS,GAAG,UAAU,GAAG,MAAM,GAAG,QAAQ,KAAK,IAAI,CAAA;IAExE,QAAQ,EAAE,IAAI,GAAG,SAAS,GAAG,MAAM,CAAA;IACnC,WAAW,EAAE,CAAC,IAAI,EAAE,IAAI,GAAG,SAAS,GAAG,MAAM,KAAK,IAAI,CAAA;IAEtD,SAAS,EAAE,OAAO,CAAA;IAClB,YAAY,EAAE,CAAC,IAAI,EAAE,OAAO,KAAK,IAAI,CAAA;IAErC,UAAU,EAAE,OAAO,CAAA;IACnB,aAAa,EAAE,CAAC,IAAI,EAAE,OAAO,KAAK,IAAI,CAAA;IAEtC,QAAQ,EAAE,OAAO,CAAA;IACjB,WAAW,EAAE,CAAC,IAAI,EAAE,OAAO,KAAK,IAAI,CAAA;IAEpC,SAAS,EAAE,MAAM,GAAG,IAAI,CAAA;IACxB,YAAY,EAAE,CAAC,EAAE,EAAE,MAAM,GAAG,IAAI,KAAK,IAAI,CAAA;IACzC,kBAAkB,EAAE,MAAM,CACxB,MAAM,EACN;QAAE,SAAS,CAAC,EAAE,OAAO,CAAC;QAAC,UAAU,CAAC,EAAE,OAAO,CAAC;QAAC,QAAQ,CAAC,EAAE,OAAO,CAAA;KAAE,CAClE,CAAA;IAGD,YAAY,EAAE,CAAC,OAAO,EAAE,OAAO,CAAC,aAAa,CAAC,KAAK,IAAI,CAAA;IACvD,cAAc,EAAE,MAAM,IAAI,CAAA;IAE1B,QAAQ,EAAE,QAAQ,CAAA;IAGlB,WAAW,EAAE,CAAC,CAAC,MAAM,CAAC,EAAE,KAAK,GAAG,KAAK,GAAG,KAAK,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC,GAAG,IAAI,CAAA;IACvE,cAAc,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,MAAM,CAAC,EAAE,KAAK,GAAG,KAAK,GAAG,KAAK,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC,GAAG,IAAI,KAAK,IAAI,CAAA;IAExF,WAAW,EAAE,OAAO,CAAA;IACpB,cAAc,EAAE,CAAC,OAAO,EAAE,OAAO,KAAK,IAAI,CAAA;IAE1C,eAAe,EAAE,OAAO,CAAA;IACxB,kBAAkB,EAAE,CAAC,IAAI,EAAE,OAAO,KAAK,IAAI,CAAA;IAE3C,cAAc,EAAE,OAAO,CAAA;IACvB,iBAAiB,EAAE,CAAC,QAAQ,EAAE,OAAO,KAAK,IAAI,CAAA;IAE9C;;;;;;;;;OASG;IACH,aAAa,EAAE,OAAO,CAAA;IACtB,gBAAgB,EAAE,CAAC,QAAQ,EAAE,OAAO,KAAK,IAAI,CAAA;CAC9C,CAAA;AAED,QAAA,MAAM,SAAS;;;;;;;;;;;;;;;;4BApCG,OAAO;6BAAe,OAAO;2BAAa,OAAO;;;;;;;;;;;;;;;;;;;;4BAAjD,OAAO;6BAAe,OAAO;2BAAa,OAAO;;;;EA4MlE,CAAA;AAED,eAAe,SAAS,CAAA"}

package/dist/store/use-viewer.js

@@ -11,8 +11,24 @@ const useViewer = create()(persist((set) => ({
     setHoveredId: (id) => set((state) => (state.hoveredId === id ? state : { hoveredId: id })),
     cameraMode: 'perspective',
     setCameraMode: (mode) => set({ cameraMode: mode }),
-    theme: 'light',
-    setTheme: (theme) => set({ theme }),
+    sceneTheme: 'studio',
+    setSceneTheme: (id) => set({ sceneTheme: id }),
+    renderContext: 'editor',
+    setRenderContext: (context) => set({ renderContext: context }),
+    shading: 'rendered',
+    shadingByContext: {},
+    setShading: (shading) => set((state) => ({
+        shading,
+        shadingByContext: { ...state.shadingByContext, [state.renderContext]: shading },
+    })),
+    textures: true,
+    setTextures: (textures) => set({ textures }),
+    colorPreset: 'clay',
+    setColorPreset: (preset) => set({ colorPreset: preset }),
+    edges: 'soft',
+    setEdges: (edges) => set({ edges }),
+    shadows: true,
+    setShadows: (shadows) => set({ shadows }),
     unit: 'metric',
     setUnit: (unit) => set({ unit }),
     levelMode: 'stacked',
@@ -106,11 +122,18 @@ const useViewer = create()(persist((set) => ({
     setWalkthroughMode: (mode) => set({ walkthroughMode: mode }),
     cameraDragging: false,
     setCameraDragging: (dragging) => set({ cameraDragging: dragging }),
+    inputDragging: false,
+    setInputDragging: (dragging) => set({ inputDragging: dragging }),
 }), {
     name: 'viewer-preferences',
     partialize: (state) => ({
         cameraMode: state.cameraMode,
-        theme: state.theme,
+        sceneTheme: state.sceneTheme,
+        shadingByContext: state.shadingByContext,
+        textures: state.textures,
+        colorPreset: state.colorPreset,
+        edges: state.edges,
+        shadows: state.shadows,
         unit: state.unit,
         levelMode: state.levelMode,
         wallMode: state.wallMode,

package/dist/systems/ceiling/ceiling-system.d.ts

@@ -2,7 +2,11 @@ import { type CeilingNode } from '@pascal-app/core';
 import * as THREE from 'three';
 export declare const CeilingSystem: () => null;
 /**
- * Generates flat ceiling geometry from polygon (no extrusion)
+ * Generates flat ceiling geometry from polygon (no extrusion).
+ *
+ * `extraHoles` are transient, derived cutouts (e.g. recessed-fixture
+ * footprints) that are cut alongside the node's persisted `holes` but never
+ * stored on the node — they are recomputed on every rebuild.
  */
-export declare function generateCeilingGeometry(ceilingNode: CeilingNode): THREE.BufferGeometry;
+export declare function generateCeilingGeometry(ceilingNode: CeilingNode, extraHoles?: Array<Array<[number, number]>>): THREE.BufferGeometry;
 //# sourceMappingURL=ceiling-system.d.ts.map

package/dist/systems/ceiling/ceiling-system.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"ceiling-system.d.ts","sourceRoot":"","sources":["../../../src/systems/ceiling/ceiling-system.tsx"],"names":[],"mappings":"AACA,OAAO,EAAkB,KAAK,WAAW,EAA2B,MAAM,kBAAkB,CAAA;AAC5F,OAAO,KAAK,KAAK,MAAM,OAAO,CAAA;AAa9B,eAAO,MAAM,aAAa,YAuBzB,CAAA;AAqBD;;GAEG;AACH,wBAAgB,uBAAuB,CAAC,WAAW,EAAE,WAAW,GAAG,KAAK,CAAC,cAAc,CAgDtF"}
+{"version":3,"file":"ceiling-system.d.ts","sourceRoot":"","sources":["../../../src/systems/ceiling/ceiling-system.tsx"],"names":[],"mappings":"AAAA,OAAO,EAEL,KAAK,WAAW,EAMjB,MAAM,kBAAkB,CAAA;AAEzB,OAAO,KAAK,KAAK,MAAM,OAAO,CAAA;AAgB9B,eAAO,MAAM,aAAa,YA4BzB,CAAA;AA2DD;;;;;;GAMG;AACH,wBAAgB,uBAAuB,CACrC,WAAW,EAAE,WAAW,EACxB,UAAU,GAAE,KAAK,CAAC,KAAK,CAAC,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,CAAM,GAC9C,KAAK,CAAC,cAAc,CA0DtB"}

package/dist/systems/ceiling/ceiling-system.js

@@ -1,6 +1,7 @@
+import { getEffectiveNode, nodeRegistry, sceneRegistry, useLiveTransforms, useScene, } from '@pascal-app/core';
 import { useFrame } from '@react-three/fiber';
-import { sceneRegistry, useScene } from '@pascal-app/core';
 import * as THREE from 'three';
+import { mergeSurfaceHolePolygons } from '../surface-hole-geometry';
 function ensureUv2Attribute(geometry) {
     const uv = geometry.getAttribute('uv');
     if (!uv)
@@ -24,7 +25,12 @@ export const CeilingSystem = () => {
                 return;
             const mesh = sceneRegistry.nodes.get(id);
             if (mesh) {
-                updateCeilingGeometry(node, mesh);
+                // Merge any live drag override so the polygon / height resize
+                // arrow rebuilds the mesh at pointer rate — zustand only learns
+                // the final value on commit. Mirrors WallSystem / GeometrySystem.
+                const effective = getEffectiveNode(node);
+                const itemHoles = collectCeilingHoles(effective, nodes);
+                updateCeilingGeometry(effective, mesh, itemHoles);
                 clearDirty(id);
             }
             // If mesh not found, keep it dirty for next frame
@@ -32,28 +38,70 @@ export const CeilingSystem = () => {
     });
     return null;
 };
+/**
+ * Collects ceiling-hole polygons from child nodes that declare the `ceilingCut`
+ * capability. Each child's `buildCeilingHole` returns a rotated-rectangle
+ * footprint in ceiling-local [x, z] space (or `null` to opt out), which is
+ * merged as an extra hole before triangulation.
+ *
+ * The viewer never branches on `child.type` — the dispatch goes through
+ * `nodeRegistry`, so any future kind (a heat lamp, a skylight panel, …) can
+ * participate just by declaring `capabilities.ceilingCut` on its definition.
+ */
+function collectCeilingHoles(ceiling, nodes) {
+    const holes = [];
+    for (const childId of ceiling.children ?? []) {
+        const child = nodes[childId];
+        if (!child)
+            continue;
+        const def = nodeRegistry.get(child.type);
+        const hole = def?.capabilities?.ceilingCut?.buildCeilingHole(child);
+        if (hole)
+            holes.push(hole);
+    }
+    return holes;
+}
 /**
  * Updates the geometry for a single ceiling
  */
-function updateCeilingGeometry(node, mesh) {
-    const newGeo = generateCeilingGeometry(node);
+function updateCeilingGeometry(node, mesh, extraHoles = []) {
+    const newGeo = generateCeilingGeometry(node, extraHoles);
     mesh.geometry.dispose();
     mesh.geometry = newGeo;
     const gridMesh = mesh.getObjectByName('ceiling-grid');
     if (gridMesh) {
         gridMesh.geometry.dispose();
-        gridMesh.geometry = newGeo;
+        gridMesh.geometry = newGeo.clone();
     }
-    // Position at the ceiling height
-    mesh.position.y = (node.height ?? 2.5) - 0.01; // Slight offset to avoid z-fighting with upper-level slabs
+    // Position at the ceiling height and reset X/Z so live-drag mesh
+    // offsets (set by move tools during the drag) don't leak into the
+    // canonical position after the rebuild. Matches the pattern used by
+    // FenceSystem.updateFenceGeometry / GeometrySystem (both fully reset
+    // position+rotation after rebuild).
+    const liveTransform = useLiveTransforms.getState().get(node.id);
+    mesh.position.x = liveTransform?.position[0] ?? 0;
+    mesh.position.z = liveTransform?.position[2] ?? 0;
+    mesh.position.y = (node.height ?? 2.5) - 0.01 + (liveTransform?.position[1] ?? 0); // Slight offset to avoid z-fighting with upper-level slabs
 }
 /**
- * Generates flat ceiling geometry from polygon (no extrusion)
+ * Generates flat ceiling geometry from polygon (no extrusion).
+ *
+ * `extraHoles` are transient, derived cutouts (e.g. recessed-fixture
+ * footprints) that are cut alongside the node's persisted `holes` but never
+ * stored on the node — they are recomputed on every rebuild.
  */
-export function generateCeilingGeometry(ceilingNode) {
+export function generateCeilingGeometry(ceilingNode, extraHoles = []) {
     const polygon = ceilingNode.polygon;
     if (polygon.length < 3) {
-        return new THREE.BufferGeometry();
+        // A degenerate ceiling (fewer than 3 points, e.g. mid-edit) still gets a
+        // non-empty position buffer — three zero-vertices forming one invisible
+        // triangle. An empty attribute (count 0) would leave WebGPU vertex buffer
+        // slot 0 unbound when this mesh (and its cloned grid overlay) is drawn,
+        // which the validator rejects ("slot 0 … was not set") and which poisons
+        // the whole command encoder.
+        const degenerate = new THREE.BufferGeometry();
+        degenerate.setAttribute('position', new THREE.Float32BufferAttribute(new Float32Array(9), 3));
+        return degenerate;
     }
     // Create shape from polygon
     // Shape is in X-Y plane, we'll rotate to X-Z plane
@@ -66,8 +114,10 @@ export function generateCeilingGeometry(ceilingNode) {
         shape.lineTo(pt[0], -pt[1]);
     }
     shape.closePath();
-    // Add holes to the shape
-    const holes = ceilingNode.holes || [];
+    // Add holes to the shape: persisted structural openings (stair/elevator/
+    // manual, merged to dissolve overlaps) plus transient recessed-fixture
+    // cutouts. Both are in the same ceiling-local [x, z] space.
+    const holes = [...mergeSurfaceHolePolygons(ceilingNode.holes || []), ...extraHoles];
     for (const holePolygon of holes) {
         if (holePolygon.length < 3)
             continue;

package/dist/systems/door/door-system.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"door-system.d.ts","sourceRoot":"","sources":["../../../src/systems/door/door-system.tsx"],"names":[],"mappings":"AAiBA,eAAO,MAAM,UAAU,YA2BtB,CAAA"}
+{"version":3,"file":"door-system.d.ts","sourceRoot":"","sources":["../../../src/systems/door/door-system.tsx"],"names":[],"mappings":"AA8CA,eAAO,MAAM,UAAU,YAwFtB,CAAA"}