@pascal-app/nodes 1.0.0-beta.4 → 1.0.0

package/dist/door/move-tool.js

@@ -1,11 +1,13 @@
 import { jsx as _jsx, Fragment as _Fragment, jsxs as _jsxs } from "react/jsx-runtime";
-import { DoorNode, emitter, isCurvedWall, sceneRegistry, spatialGridManager, useLiveTransforms, useScene, } from '@pascal-app/core';
+import { DoorNode, emitter, holdHiddenWallPointerEvents, isCurvedWall, sceneRegistry, spatialGridManager, useLiveTransforms, useScene, } from '@pascal-app/core';
 import { calculateItemRotation, clearPlacementSurface, consumePlacementDragRelease, EDITOR_LAYER, getSideFromNormal, isGridSnapActive, isMagneticSnapActive, isValidWallSideFace, publishPlacementSurface, stripPlacementMetadataFlags, triggerSFX, useAlignmentGuides, useEditor, useFacingPose, } from '@pascal-app/editor';
 import { useViewer } from '@pascal-app/viewer';
 import { useCallback, useEffect, useMemo, useRef, useState } from 'react';
 import { BoxGeometry, EdgesGeometry, Vector3 } from 'three';
 import { LineBasicNodeMaterial } from 'three/webgpu';
 import { clearOpeningGuides3D, publishOpeningGuidesForWallEvent, } from '../shared/opening-guides-runtime';
+import { beginOpeningMoveHistorySession } from '../shared/opening-move-history';
+import { isWallMeshHidden, shouldIgnoreWallEventForOpeningMove, } from '../shared/opening-move-wall-gate';
 import { getRoofWallOpeningCursorPose, resolveRoofWallOpeningTarget, } from '../shared/roof-wall-opening-placement';
 import { resolveOpeningPlacement } from '../shared/wall-attach-target';
 import { collectWallOpeningAlignmentCandidates, resolveWallSlideAlignment, } from '../shared/wall-opening-alignment';
@@ -43,7 +45,19 @@ const MoveDoorTool = ({ node: movingDoorNode }) => {
         useEditor.getState().setMovingNode(null);
     }, []);
     useEffect(() => {
-        useScene.temporal.getState().pause();
+        // One undo entry per gesture: hold the REFCOUNTED history pause for the
+        // move's lifetime (a raw `temporal.pause()` is invisible to
+        // `getSceneHistoryPauseDepth()`, so a cooperating system's balanced
+        // pause/resume pair could zero the refcount mid-drag and resume tracking
+        // — every mid-drag write then became its own undo entry). The commit
+        // paths run their single tracked write through `history.commitStep`.
+        const history = beginOpeningMoveHistorySession();
+        // This tool's whole cursor model is the wall surface (`wall:enter` /
+        // `wall:move` / `wall:click`). Walls hidden by the wall-mode pass (X-ray
+        // 'down' mode) are pointer-transparent for selection; hold their pointer
+        // events for the move's lifetime so the door keeps sliding along its wall
+        // instead of detaching into the floor free-follow.
+        const releaseHiddenWallHold = holdHiddenWallPointerEvents();
         const meta = typeof movingDoorNode.metadata === 'object' && movingDoorNode.metadata !== null
             ? movingDoorNode.metadata
             : {};
@@ -187,6 +201,18 @@ const MoveDoorTool = ({ node: movingDoorNode }) => {
                 itemRotation: calculateItemRotation(event.normal) + rotationOffset,
             };
         };
+        // While MOVING an existing door, a HIDDEN wall may drive the drag only if
+        // it is the door's own wall (grab wall / current mid-drag host) — an
+        // interposed hidden wall between the camera and the door's wall must not
+        // capture the drag and silently re-parent the door on commit. Ignored
+        // events are NOT stopPropagation'd, so the ray falls through to the own
+        // wall behind. Fresh placements (`isNew`) keep the all-walls behavior.
+        const wallEventIgnored = (event) => !isNew &&
+            shouldIgnoreWallEventForOpeningMove({
+                eventWallId: event.node.id,
+                eventWallHidden: isWallMeshHidden(event.node.id),
+                ownWallIds: [original.wallId, currentHostId],
+            });
         const resolveMoveTarget = (event) => {
             if (!isValidWallSideFace(event.normal))
                 return;
@@ -223,7 +249,7 @@ const MoveDoorTool = ({ node: movingDoorNode }) => {
                 applySnap: isMagneticSnapActive(),
             });
             const { clampedX, clampedY } = clampToWall(event.node, localX, movingDoorNode.width, movingDoorNode.height);
-            const valid = !hasWallChildOverlap(event.node.id, clampedX, clampedY, movingDoorNode.width, movingDoorNode.height, movingDoorNode.id);
+            const valid = !hasWallChildOverlap(event.node.id, useScene.getState().nodes, clampedX, clampedY, movingDoorNode.width, movingDoorNode.height, movingDoorNode.id);
             return {
                 wallNode: event.node,
                 wallId: event.node.id,
@@ -327,6 +353,11 @@ const MoveDoorTool = ({ node: movingDoorNode }) => {
             });
         };
         const onWallEnter = (event) => {
+            // Interposed hidden wall: ignore WITHOUT tearing down the current
+            // preview or stopping propagation — the own wall behind it (a later,
+            // farther intersection on this same ray) emits its own event.
+            if (wallEventIgnored(event))
+                return;
             const target = resolveMoveTarget(event);
             if (!target) {
                 onWallLeave();
@@ -342,6 +373,9 @@ const MoveDoorTool = ({ node: movingDoorNode }) => {
             event.stopPropagation();
         };
         const onWallMove = (event) => {
+            // See onWallEnter — interposed hidden walls never own the move.
+            if (wallEventIgnored(event))
+                return;
             if (!isValidWallSideFace(event.normal)) {
                 onWallLeave();
                 return;
@@ -376,8 +410,10 @@ const MoveDoorTool = ({ node: movingDoorNode }) => {
             committed = true;
             let placedId;
             if (isNew) {
+                // Duplicate mode: delete the transient draft while history is still
+                // paused, then create the real node as the gesture's ONE tracked
+                // write — undo removes the new door entirely.
                 useScene.getState().deleteNode(movingDoorNode.id);
-                useScene.temporal.getState().resume();
                 const cloned = structuredClone(movingDoorNode);
                 delete cloned.id;
                 cloned.metadata = stripPlacementMetadataFlags(cloned.metadata);
@@ -394,10 +430,15 @@ const MoveDoorTool = ({ node: movingDoorNode }) => {
                     // must be visible regardless of the pre-commit free-follow state.
                     visible: true,
                 });
-                useScene.getState().createNode(node, target.wallId);
+                history.commitStep(() => {
+                    useScene.getState().createNode(node, target.wallId);
+                });
                 placedId = node.id;
             }
             else {
+                // Move mode: restore the exact pre-drag state while history is still
+                // paused (the clean undo baseline), then apply the drop as the
+                // gesture's ONE tracked write — undo reverts to the original state.
                 useScene.getState().updateNode(movingDoorNode.id, {
                     position: original.position,
                     rotation: original.rotation,
@@ -409,16 +450,17 @@ const MoveDoorTool = ({ node: movingDoorNode }) => {
                     metadata: original.metadata,
                     visible: original.visible,
                 });
-                useScene.temporal.getState().resume();
-                useScene.getState().updateNode(movingDoorNode.id, {
-                    position: [target.clampedX, target.clampedY, 0],
-                    rotation: [0, target.itemRotation, 0],
-                    side: target.side,
-                    parentId: target.wallId,
-                    wallId: target.wallId,
-                    roofSegmentId: undefined,
-                    metadata: {},
-                    visible: true,
+                history.commitStep(() => {
+                    useScene.getState().updateNode(movingDoorNode.id, {
+                        position: [target.clampedX, target.clampedY, 0],
+                        rotation: [0, target.itemRotation, 0],
+                        side: target.side,
+                        parentId: target.wallId,
+                        wallId: target.wallId,
+                        roofSegmentId: undefined,
+                        metadata: {},
+                        visible: true,
+                    });
                 });
                 if (original.parentId && original.parentId !== target.wallId) {
                     markHostDirty(original.parentId);
@@ -427,7 +469,6 @@ const MoveDoorTool = ({ node: movingDoorNode }) => {
             }
             markHostDirty(target.wallId);
             useLiveTransforms.getState().clear(movingDoorNode.id);
-            useScene.temporal.getState().pause();
             triggerSFX('sfx:structure-build');
             hideCursor();
             useViewer.getState().setSelection({ selectedIds: [placedId] });
@@ -436,6 +477,10 @@ const MoveDoorTool = ({ node: movingDoorNode }) => {
         const onWallClick = (event) => {
             if (committed)
                 return;
+            // A click on an interposed hidden wall must not commit / re-parent;
+            // let it fall through to the own wall behind (see onWallEnter).
+            if (wallEventIgnored(event))
+                return;
             if (!isValidWallSideFace(event.normal))
                 return;
             if (isCurvedWall(event.node))
@@ -630,8 +675,9 @@ const MoveDoorTool = ({ node: movingDoorNode }) => {
             const segmentId = target.segment.id;
             let placedId;
             if (isNew) {
+                // See commitToWall — delete the draft paused, create as the ONE
+                // tracked write.
                 useScene.getState().deleteNode(movingDoorNode.id);
-                useScene.temporal.getState().resume();
                 const cloned = structuredClone(movingDoorNode);
                 delete cloned.id;
                 cloned.metadata = stripPlacementMetadataFlags(cloned.metadata);
@@ -646,10 +692,14 @@ const MoveDoorTool = ({ node: movingDoorNode }) => {
                     parentId: segmentId,
                     visible: true,
                 });
-                useScene.getState().createNode(node, segmentId);
+                history.commitStep(() => {
+                    useScene.getState().createNode(node, segmentId);
+                });
                 placedId = node.id;
             }
             else {
+                // See commitToWall — restore the pre-drag baseline paused, drop as
+                // the ONE tracked write.
                 useScene.getState().updateNode(movingDoorNode.id, {
                     position: original.position,
                     rotation: original.rotation,
@@ -661,17 +711,18 @@ const MoveDoorTool = ({ node: movingDoorNode }) => {
                     metadata: original.metadata,
                     visible: original.visible,
                 });
-                useScene.temporal.getState().resume();
-                useScene.getState().updateNode(movingDoorNode.id, {
-                    position: target.position,
-                    rotation: [0, 0, 0],
-                    side: 'front',
-                    parentId: segmentId,
-                    wallId: undefined,
-                    roofSegmentId: segmentId,
-                    roofFace: target.face.id,
-                    metadata: {},
-                    visible: true,
+                history.commitStep(() => {
+                    useScene.getState().updateNode(movingDoorNode.id, {
+                        position: target.position,
+                        rotation: [0, 0, 0],
+                        side: 'front',
+                        parentId: segmentId,
+                        wallId: undefined,
+                        roofSegmentId: segmentId,
+                        roofFace: target.face.id,
+                        metadata: {},
+                        visible: true,
+                    });
                 });
                 if (original.parentId && original.parentId !== segmentId) {
                     markHostDirty(original.parentId);
@@ -680,7 +731,6 @@ const MoveDoorTool = ({ node: movingDoorNode }) => {
             }
             markHostDirty(segmentId);
             useLiveTransforms.getState().clear(movingDoorNode.id);
-            useScene.temporal.getState().pause();
             triggerSFX('sfx:structure-build');
             hideCursor();
             useViewer.getState().setSelection({ selectedIds: [placedId] });
@@ -718,7 +768,10 @@ const MoveDoorTool = ({ node: movingDoorNode }) => {
                 if (original.parentId)
                     markHostDirty(original.parentId);
             }
-            useScene.temporal.getState().resume();
+            // The revert writes above ran under the gesture's history pause (never
+            // tracked); ending the session here keeps a cancelled move out of undo
+            // entirely. `end` is idempotent — the effect cleanup's end() is a no-op.
+            history.end();
             hideCursor();
             exitMoveMode();
         };
@@ -869,7 +922,8 @@ const MoveDoorTool = ({ node: movingDoorNode }) => {
             clearOpeningGuides3D();
             useFacingPose.getState().clear();
             clearPlacementSurface();
-            useScene.temporal.getState().resume();
+            releaseHiddenWallHold();
+            history.end();
             emitter.off('wall:enter', onWallEnter);
             emitter.off('wall:move', onWallMove);
             emitter.off('wall:click', onWallClick);

package/dist/door/panel.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"panel.d.ts","sourceRoot":"","sources":["../../src/door/panel.tsx"],"names":[],"mappings":"AAuIA,MAAM,CAAC,OAAO,UAAU,SAAS,uCAmpChC"}
+{"version":3,"file":"panel.d.ts","sourceRoot":"","sources":["../../src/door/panel.tsx"],"names":[],"mappings":"AAuIA,MAAM,CAAC,OAAO,UAAU,SAAS,uCAkpChC"}

package/dist/door/panel.js

@@ -484,7 +484,7 @@ export default function DoorPanel() {
                                     ], value: node.leafCount === 2 ? '2' : '4' })] }) }), _jsx(SliderControl, { label: "Open", max: 100, min: 0, onChange: (v) => handleUpdate({ operationState: v / 100 }), precision: 0, restoreOnCommit: false, step: 5, unit: "%", value: Math.round((node.operationState ?? 0) * 100) })] })), showSlideSection && (_jsxs(PanelSection, { title: "Slide", children: [_jsx("div", { className: "flex flex-col gap-2 px-1 pb-1", children: _jsxs("div", { className: "space-y-1", children: [_jsx("span", { className: "font-medium text-[10px] text-muted-foreground/80 uppercase tracking-wider", children: doorType === 'pocket' ? 'Pocket' : doorType === 'barn' ? 'Rail' : 'Panel' }), _jsx(SegmentedControl, { onChange: (v) => handleUpdate({ slideDirection: v }), options: [
                                         { label: 'Left', value: 'left' },
                                         { label: 'Right', value: 'right' },
-                                    ], value: node.slideDirection ?? 'left' })] }) }), _jsx(SliderControl, { label: "Open", max: 100, min: 0, onChange: (v) => handleUpdate({ operationState: v / 100 }), precision: 0, restoreOnCommit: false, step: 5, unit: "%", value: Math.round((node.operationState ?? 0) * 100) })] })), showGarageSection && (_jsxs(PanelSection, { title: "Garage", children: [_jsx(SliderControl, { label: "Open", max: 100, min: 0, onChange: (v) => handleUpdate({ operationState: v / 100 }), precision: 0, restoreOnCommit: false, step: 5, unit: "%", value: Math.round((node.operationState ?? 0) * 100) }), isSectionalGarageDoor && (_jsx(SliderControl, { label: "Panels", max: 8, min: 3, onChange: (v) => handleUpdate({ garagePanelCount: Math.round(v) }), precision: 0, restoreOnCommit: false, step: 1, value: node.garagePanelCount ?? 4 }))] })), _jsxs(PanelSection, { title: "Dimensions", children: [_jsx(SliderControl, { label: "Width", max: maxDoorWidth, min: 0.5, onChange: (v) => handleUpdate({ width: v }), precision: 2, restoreOnCommit: false, step: 0.05, unit: "m", value: Math.round(node.width * 100) / 100 }), _jsx(SliderControl, { label: "Height", max: 4, min: 1.0, onChange: (v) => handleUpdate({
+                                    ], value: node.slideDirection ?? 'left' })] }) }), _jsx(SliderControl, { label: "Open", max: 100, min: 0, onChange: (v) => handleUpdate({ operationState: v / 100 }), precision: 0, restoreOnCommit: false, step: 5, unit: "%", value: Math.round((node.operationState ?? 0) * 100) })] })), showGarageSection && (_jsxs(PanelSection, { title: "Garage", children: [_jsx(SliderControl, { label: "Open", max: 100, min: 0, onChange: (v) => handleUpdate({ operationState: v / 100 }), precision: 0, restoreOnCommit: false, step: 5, unit: "%", value: Math.round((node.operationState ?? 0) * 100) }), isSectionalGarageDoor && (_jsx(SliderControl, { label: "Panels", max: 8, min: 3, onChange: (v) => handleUpdate({ garagePanelCount: Math.round(v) }), precision: 0, restoreOnCommit: false, step: 1, value: node.garagePanelCount ?? 4 }))] })), _jsxs(PanelSection, { title: "Dimensions", children: [_jsx(SliderControl, { label: "Width", max: maxDoorWidth, min: 0.5, onChange: (v) => handleUpdate({ width: v }), precision: 2, restoreOnCommit: false, step: 0.05, unit: "m", value: Math.round(node.width * 100) / 100 }), _jsx(SliderControl, { label: "Height", max: 1000, min: 1.0, onChange: (v) => handleUpdate({
                             height: v,
                             position: [node.position[0], v / 2, node.position[2]],
                             // Keep the handle at the same relative height as the door resizes,

package/dist/door/parametrics.js

@@ -11,8 +11,8 @@ export const doorParametrics = {
         {
             label: 'Dimensions',
             fields: [
-                { key: 'width', kind: 'number', unit: 'm', min: 0.5, max: 6, step: 0.05 },
-                { key: 'height', kind: 'number', unit: 'm', min: 1.0, max: 4, step: 0.05 },
+                { key: 'width', kind: 'number', unit: 'm', min: 0.5, max: 1000, step: 0.05 },
+                { key: 'height', kind: 'number', unit: 'm', min: 1.0, max: 1000, step: 0.05 },
             ],
         },
         {

package/dist/door/tool.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"tool.d.ts","sourceRoot":"","sources":["../../src/door/tool.tsx"],"names":[],"mappings":"AAiEA;;;;;;;;;;;GAWG;AACH,QAAA,MAAM,QAAQ,EAAE,KAAK,CAAC,EAkrBrB,CAAA;AAED,eAAe,QAAQ,CAAA"}
+{"version":3,"file":"tool.d.ts","sourceRoot":"","sources":["../../src/door/tool.tsx"],"names":[],"mappings":"AAiEA;;;;;;;;;;;GAWG;AACH,QAAA,MAAM,QAAQ,EAAE,KAAK,CAAC,EAqsBrB,CAAA;AAED,eAAe,QAAQ,CAAA"}

package/dist/door/tool.js

@@ -1,6 +1,6 @@
 import { jsx as _jsx, Fragment as _Fragment, jsxs as _jsxs } from "react/jsx-runtime";
-import { DoorNode, emitter, isCurvedWall, sceneRegistry, spatialGridManager, useScene, WallNode as WallNodeSchema, } from '@pascal-app/core';
-import { calculateCursorRotation, calculateItemRotation, EDITOR_LAYER, getSideFromNormal, isMagneticSnapActive, isValidWallSideFace, triggerSFX, useAlignmentGuides, useEditor, useFacingPose, usePlacementPreview, } from '@pascal-app/editor';
+import { DoorNode, emitter, holdHiddenWallPointerEvents, isCurvedWall, sceneRegistry, spatialGridManager, useScene, WallNode as WallNodeSchema, } from '@pascal-app/core';
+import { calculateItemRotation, EDITOR_LAYER, getSideFromNormal, isMagneticSnapActive, isValidWallSideFace, triggerSFX, useAlignmentGuides, useEditor, useFacingPose, usePlacementPreview, } from '@pascal-app/editor';
 import { useViewer } from '@pascal-app/viewer';
 import { useEffect, useMemo, useRef, useState } from 'react';
 import { BoxGeometry, EdgesGeometry, Vector3 } from 'three';
@@ -210,7 +210,7 @@ const DoorTool = () => {
                 applySnap,
             });
             const { clampedX, clampedY } = clampToWall(wall, localX, width, height);
-            const valid = !hasWallChildOverlap(wall.id, clampedX, clampedY, width, height, ignoreId);
+            const valid = !hasWallChildOverlap(wall.id, useScene.getState().nodes, clampedX, clampedY, width, height, ignoreId);
             return { clampedX, clampedY, valid };
         };
         // Shared create/update path for the wall draft — used by the direct
@@ -350,7 +350,13 @@ const DoorTool = () => {
             const side = sideFlip ? (faceSide === 'front' ? 'back' : 'front') : faceSide;
             const flipOffset = sideFlip ? Math.PI : 0;
             const itemRotation = calculateItemRotation(event.normal) + flipOffset;
-            const cursorRotation = calculateCursorRotation(event.normal, event.node.start, event.node.end) + flipOffset;
+            const cursorRotation = 
+            // World yaw of a wall CHILD (-wallAngle + itemRotation, which already
+            // carries the flip) — `calculateCursorRotation` was π off, pointing
+            // the facing triangle at the far side of the wall (see
+            // MoveDoorTool.applyPreview).
+            itemRotation -
+                Math.atan2(event.node.end[1] - event.node.start[1], event.node.end[0] - event.node.start[0]);
             applyWallTarget({
                 wall: event.node,
                 rawLocalX: event.localPosition[0],
@@ -577,12 +583,18 @@ const DoorTool = () => {
         emitter.on('grid:move', onGridFreeFollow);
         emitter.on('tool:cancel', onCancel);
         window.addEventListener('keydown', onKeyDown);
+        // Placement tracks the cursor through wall events; keep walls hidden by
+        // the wall-mode pass (X-ray 'down' mode) pointer-targetable while the
+        // tool is active so a new door still snaps onto them (see the wall
+        // renderer's pointer transparency).
+        const releaseHiddenWallHold = holdHiddenWallPointerEvents();
         return () => {
             destroyDraft();
             hideCursor();
             clearPlacementPreview();
             useAlignmentGuides.getState().clear();
             clearOpeningGuides3D();
+            releaseHiddenWallHold();
             useScene.temporal.getState().resume();
             emitter.off('wall:enter', onWallHover);
             emitter.off('wall:move', onWallHover);

package/dist/dormer/csg-geometry.d.ts

@@ -1,4 +1,4 @@
-import { type DormerNode, type RoofSegmentNode } from '@pascal-app/core';
+import { type DormerNode, type RoofSegmentNode, type WindowNode } from '@pascal-app/core';
 import * as THREE from 'three';
 export declare const DORMER_GABLE_MATERIAL_INDEX = 4;
 /**
@@ -7,46 +7,10 @@ export declare const DORMER_GABLE_MATERIAL_INDEX = 4;
  * the live preview during slider drags so we don't re-run CSG on every
  * pointer move. Also used by the placement / move-tool ghost.
  *
- * Builds a rectangular body + simple roof in dormer-mesh-local. For
- * `flat` dormers the roof triangle is skipped. Other roof types use
- * the gable approximation — it's a rough silhouette by design.
- *
  * The wall sits at material slot 0 and the roof at slot 3 so it picks
  * up the same material array the renderer passes for the CSG output.
  */
 export declare function buildDormerFallbackGeometry(dormer: DormerNode): THREE.BufferGeometry;
-export declare function createDormerArchShape(w: number, h: number, archHeight: number): THREE.Shape;
-export declare function normalizeDormerCornerRadii(radii: [number, number, number, number], w: number, h: number): [number, number, number, number];
-export declare function createDormerRoundedShape(w: number, h: number, radii: [number, number, number, number]): THREE.Shape;
-/**
- * Which gable faces of a dormer have a visible window opening.
- * "front" = mesh-local +Z, "back" = mesh-local −Z (after the +π/2 yaw
- * bake for non-shed roofs).
- *
- * Each face centre is lifted into segment-local X *and* Z (the yaw
- * matters, and on hip hosts the end slopes fall along X) and compared
- * against the host's canonical per-type surface line via
- * `getRoofSegmentSurfaceY`, which extrapolates past the structural
- * eave instead of plateauing at the wall top — a face hanging in free
- * air past the eave keeps dropping. Gates both the CSG window-cut
- * decision (`generateDormerGeometry`) and the live render
- * (window-assembly.tsx).
- */
-export declare function getDormerExposedFaces(dormer: DormerNode, hostSegment: RoofSegmentNode): {
-    front: boolean;
-    back: boolean;
-};
-/**
- * Computed dimensions for the window opening on a dormer's gable face.
- * The skirt (the wall extension below the eave used for CSG-trim) is
- * `DORMER_DROP_BELOW` tall, so the window sits within that band.
- */
-export declare function getDormerSkirtWindowDims(dormer: DormerNode): {
-    width: number;
-    height: number;
-    centerY: number;
-    offsetX: number;
-};
 /**
  * Build the trimmed dormer geometry hosted on a roof segment. The
  * dormer's own walls+roof are generated via `getRoofSegmentBrushes`
@@ -54,7 +18,7 @@ export declare function getDormerSkirtWindowDims(dormer: DormerNode): {
  * CSG-subtracted in dormer-mesh-local space. Window openings are then
  * subtracted on each exposed gable face.
  */
-export declare function generateDormerGeometry(dormer: DormerNode, hostSegment: RoofSegmentNode): THREE.BufferGeometry;
+export declare function generateDormerGeometry(dormer: DormerNode, hostSegment: RoofSegmentNode, hostedWindows?: readonly WindowNode[]): THREE.BufferGeometry;
 /**
  * Build the dormer cut shape in dormer-mesh-local coordinates. The
  * returned geometry is centered at X=Z=0 and spans Y ∈ [-skirt, peak]
@@ -64,10 +28,10 @@ export declare function generateDormerGeometry(dormer: DormerNode, hostSegment:
  * Shapes per roof type:
  * - **flat**:                a plain box (top flush with the eave; the
  *                            dormer body has no roof above wallH).
- * - **shed**:                trapezoid in YZ, extruded along X. Eave
- *                            at z=+d/2 (y=wallH), peak at z=-d/2
- *                            (y=wallH+roofH) — matches the slope
- *                            direction the dormer body uses.
+ * - **shed**:                trapezoid in YZ, extruded along X. The
+ *                            base shape is high at z=-d/2; the caller
+ *                            flips it when the configured high side is
+ *                            the front.
  * - **gable / gambrel**:     pentagon (rectangle + symmetric triangle)
  *                            in XY, extruded along Z. Ridge runs
  *                            along Z (mesh-Z = virtualSegment-X after

package/dist/dormer/csg-geometry.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"csg-geometry.d.ts","sourceRoot":"","sources":["../../src/dormer/csg-geometry.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,KAAK,UAAU,EAIf,KAAK,eAAe,EACrB,MAAM,kBAAkB,CAAA;AAezB,OAAO,KAAK,KAAK,MAAM,OAAO,CAAA;AAW9B,eAAO,MAAM,2BAA2B,IAAI,CAAA;AAK5C;;;;;;;;;;;;GAYG;AACH,wBAAgB,2BAA2B,CAAC,MAAM,EAAE,UAAU,GAAG,KAAK,CAAC,cAAc,CA4CpF;AAED,wBAAgB,qBAAqB,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,GAAG,KAAK,CAAC,KAAK,CAoB3F;AAED,wBAAgB,0BAA0B,CACxC,KAAK,EAAE,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,EACvC,CAAC,EAAE,MAAM,EACT,CAAC,EAAE,MAAM,GACR,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,CAWlC;AAED,wBAAgB,wBAAwB,CACtC,CAAC,EAAE,MAAM,EACT,CAAC,EAAE,MAAM,EACT,KAAK,EAAE,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,GACtC,KAAK,CAAC,KAAK,CAqBb;AA8CD;;;;;;;;;;;;;GAaG;AACH,wBAAgB,qBAAqB,CACnC,MAAM,EAAE,UAAU,EAClB,WAAW,EAAE,eAAe,GAC3B;IAAE,KAAK,EAAE,OAAO,CAAC;IAAC,IAAI,EAAE,OAAO,CAAA;CAAE,CA0BnC;AAED;;;;GAIG;AACH,wBAAgB,wBAAwB,CAAC,MAAM,EAAE,UAAU,GAAG;IAC5D,KAAK,EAAE,MAAM,CAAA;IACb,MAAM,EAAE,MAAM,CAAA;IACd,OAAO,EAAE,MAAM,CAAA;IACf,OAAO,EAAE,MAAM,CAAA;CAChB,CAUA;AAED;;;;;;GAMG;AACH,wBAAgB,sBAAsB,CACpC,MAAM,EAAE,UAAU,EAClB,WAAW,EAAE,eAAe,GAC3B,KAAK,CAAC,cAAc,CA0OtB;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;GA2BG;AACH,wBAAgB,mBAAmB,CACjC,QAAQ,EAAE,UAAU,CAAC,UAAU,CAAC,EAChC,MAAM,EAAE,MAAM,EACd,MAAM,EAAE,MAAM,EACd,KAAK,EAAE,MAAM,EACb,KAAK,EAAE,MAAM,EACb,KAAK,EAAE,MAAM,GACZ,KAAK,CAAC,cAAc,CAmMtB;AAED;;;;;;;;;;;;;;;GAeG;AACH,wBAAgB,kBAAkB,CAAC,MAAM,EAAE,UAAU,GAAG,KAAK,CAAC,cAAc,GAAG,IAAI,CA0DlF"}
+{"version":3,"file":"csg-geometry.d.ts","sourceRoot":"","sources":["../../src/dormer/csg-geometry.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,KAAK,UAAU,EAKf,KAAK,eAAe,EACpB,KAAK,UAAU,EAChB,MAAM,kBAAkB,CAAA;AAgBzB,OAAO,KAAK,KAAK,MAAM,OAAO,CAAA;AAW9B,eAAO,MAAM,2BAA2B,IAAI,CAAA;AAK5C;;;;;;;;GAQG;AACH,wBAAgB,2BAA2B,CAAC,MAAM,EAAE,UAAU,GAAG,KAAK,CAAC,cAAc,CAEpF;AAiBD;;;;;;GAMG;AACH,wBAAgB,sBAAsB,CACpC,MAAM,EAAE,UAAU,EAClB,WAAW,EAAE,eAAe,EAC5B,aAAa,GAAE,SAAS,UAAU,EAAO,GACxC,KAAK,CAAC,cAAc,CAsOtB;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;GA2BG;AACH,wBAAgB,mBAAmB,CACjC,QAAQ,EAAE,UAAU,CAAC,UAAU,CAAC,EAChC,MAAM,EAAE,MAAM,EACd,MAAM,EAAE,MAAM,EACd,KAAK,EAAE,MAAM,EACb,KAAK,EAAE,MAAM,EACb,KAAK,EAAE,MAAM,GACZ,KAAK,CAAC,cAAc,CAmMtB;AAED;;;;;;;;;;;;;;;GAeG;AACH,wBAAgB,kBAAkB,CAAC,MAAM,EAAE,UAAU,GAAG,KAAK,CAAC,cAAc,GAAG,IAAI,CA6DlF"}