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

package/dist/cabinet/flame-index.d.ts

@@ -0,0 +1,3 @@
+import type { Object3D } from 'three';
+export declare function collectCabinetFlameObjects(root: Object3D): Object3D[];
+//# sourceMappingURL=flame-index.d.ts.map

package/dist/cabinet/flame-index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"flame-index.d.ts","sourceRoot":"","sources":["../../src/cabinet/flame-index.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,OAAO,CAAA;AAUrC,wBAAgB,0BAA0B,CAAC,IAAI,EAAE,QAAQ,GAAG,QAAQ,EAAE,CAMrE"}

package/dist/cabinet/flame-index.js

@@ -0,0 +1,13 @@
+function isFlameObject(object) {
+    return Boolean(object.userData.cabinetFlameJet ||
+        object.userData.cabinetFlamePulse ||
+        object.userData.cabinetFlameMaterialPulse);
+}
+export function collectCabinetFlameObjects(root) {
+    const objects = [];
+    root.traverse((object) => {
+        if (isFlameObject(object))
+            objects.push(object);
+    });
+    return objects;
+}

package/dist/cabinet/floorplan-move.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"floorplan-move.d.ts","sourceRoot":"","sources":["../../src/cabinet/floorplan-move.ts"],"names":[],"mappings":"AAAA,OAAO,EAIL,KAAK,iBAAiB,IAAI,qBAAqB,EAG/C,KAAK,mBAAmB,EAMzB,MAAM,kBAAkB,CAAA;AA8GzB;;;;;;;;;;;GAWG;AACH,eAAO,MAAM,gCAAgC,EAAE,mBAAmB,CAAC,qBAAqB,CAiHvF,CAAA"}
+{"version":3,"file":"floorplan-move.d.ts","sourceRoot":"","sources":["../../src/cabinet/floorplan-move.ts"],"names":[],"mappings":"AAAA,OAAO,EAIL,KAAK,iBAAiB,IAAI,qBAAqB,EAG/C,KAAK,mBAAmB,EAMzB,MAAM,kBAAkB,CAAA;AAqHzB;;;;;;;;;;;GAWG;AACH,eAAO,MAAM,gCAAgC,EAAE,mBAAmB,CAAC,qBAAqB,CA6LvF,CAAA"}

package/dist/cabinet/floorplan-move.js

@@ -1,7 +1,7 @@
 import { createSceneApi, useLiveNodeOverrides, useScene, } from '@pascal-app/core';
 import { isAlignmentGuideActive, isGridSnapActive, isMagneticSnapActive, useAlignmentGuides, useEditor, } from '@pascal-app/editor';
 import { cabinetModuleParentFrame } from './move-frame';
-import { bumpCabinetRunLayoutRevision, syncCornerRunsFromSourceModule } from './run-ops';
+import { bumpCabinetRunLayoutRevision, previewCornerRunsFromRunSources, syncCornerRunsFromSourceModule, } from './run-ops';
 import { resolveCabinetModuleWallSnapLocal } from './wall-snap';
 function alignmentGuideFromParentFrameMatch(match) {
     return {
@@ -22,7 +22,7 @@ function mergeSceneUpdate(updates, id, patch) {
         ...patch,
     });
 }
-function collectCabinetModuleMoveCommitUpdates({ lastLocal, moduleId, runId, }) {
+function collectCabinetModuleMoveCommitUpdates({ lastLocal, moduleId, previousModule, runId, }) {
     const baseNodes = useScene.getState().nodes;
     const nodes = { ...baseNodes };
     const updates = new Map();
@@ -75,6 +75,7 @@ function collectCabinetModuleMoveCommitUpdates({ lastLocal, moduleId, runId, })
     if (liveModule?.type === 'cabinet-module') {
         syncCornerRunsFromSourceModule({
             module: liveModule,
+            previousModule,
             run: sceneApi.get(runId) ?? liveRun,
             sceneApi,
         });
@@ -100,9 +101,75 @@ export const cabinetModuleFloorplanMoveTarget = ({ node, nodes, }) => {
     const run = cabinetModuleParentFrame.resolveParent(node, nodes);
     const originalLocal = [...node.position];
     let lastLocal = originalLocal;
+    let lastPositionValid = true;
+    let forcePlace = false;
+    const initialPreviewSceneApi = createSceneApi(useScene);
+    const initialCornerPreview = run
+        ? previewCornerRunsFromRunSources({
+            initialOverrides: [[moduleId, { position: originalLocal }]],
+            previousModules: [node],
+            run,
+            sceneApi: initialPreviewSceneApi,
+        })
+        : [];
+    const affectedIds = new Set([moduleId, ...(run ? [run.id] : [])]);
+    for (const [id] of initialCornerPreview)
+        affectedIds.add(id);
+    let activePreviewIds = new Set();
+    const publishPreview = (position) => {
+        if (!run) {
+            useLiveNodeOverrides.getState().set(moduleId, { position });
+            return;
+        }
+        const entries = previewCornerRunsFromRunSources({
+            initialOverrides: [[moduleId, { position }]],
+            previousModules: [node],
+            run,
+            sceneApi: createSceneApi(useScene),
+        });
+        const nextIds = new Set(entries.map(([id]) => id));
+        for (const id of activePreviewIds) {
+            if (!nextIds.has(id))
+                useLiveNodeOverrides.getState().clear(id);
+        }
+        useLiveNodeOverrides.getState().setMany(entries);
+        activePreviewIds = nextIds;
+        const scene = useScene.getState();
+        scene.markDirty(run.id);
+        for (const [id] of entries) {
+            if (scene.nodes[id])
+                scene.markDirty(id);
+        }
+    };
     const session = {
-        affectedIds: run ? [moduleId, run.id] : [moduleId],
-        apply({ planPoint }) {
+        affectedIds: [...affectedIds],
+        apply({ planPoint, modifiers }) {
+            forcePlace = modifiers.altKey;
+            if ((isGridSnapActive() || isMagneticSnapActive()) && run?.parentId) {
+                const rawLocal = cabinetModuleParentFrame.planToLocal(run, planPoint[0], originalLocal[1], planPoint[1], useScene.getState().nodes);
+                const wallLocal = resolveCabinetModuleWallSnapLocal({
+                    candidateLocal: rawLocal,
+                    gridStep: isGridSnapActive() ? useEditor.getState().gridSnapStep : 0,
+                    module: node,
+                    nodes: useScene.getState().nodes,
+                    parentLevelId: run.parentId,
+                    run,
+                });
+                if (wallLocal) {
+                    lastLocal = wallLocal;
+                    lastPositionValid = cabinetModuleParentFrame.isValidPosition
+                        ? cabinetModuleParentFrame.isValidPosition({
+                            node: { ...node, position: wallLocal },
+                            parent: run,
+                            position: wallLocal,
+                            nodes: useScene.getState().nodes,
+                        })
+                        : true;
+                    useAlignmentGuides.getState().clear();
+                    publishPreview(wallLocal);
+                    return;
+                }
+            }
             const snap = (value) => isGridSnapActive()
                 ? Math.round(value / useEditor.getState().gridSnapStep) *
                     useEditor.getState().gridSnapStep
@@ -113,7 +180,8 @@ export const cabinetModuleFloorplanMoveTarget = ({ node, nodes, }) => {
             // same as the generic overlay would have done.
             if (!run) {
                 lastLocal = [planX, originalLocal[1], planZ];
-                useLiveNodeOverrides.getState().set(moduleId, { position: lastLocal });
+                lastPositionValid = true;
+                publishPreview(lastLocal);
                 return;
             }
             let local = cabinetModuleParentFrame.planToLocal(run, planX, originalLocal[1], planZ, useScene.getState().nodes);
@@ -133,28 +201,23 @@ export const cabinetModuleFloorplanMoveTarget = ({ node, nodes, }) => {
                     }
                 }
             }
-            // Wall attachment snap — 2D parity with the 3D move tool's
-            // `groupMoveSnap` pass: active in every snapping mode except Off.
-            if ((isGridSnapActive() || isMagneticSnapActive()) && run.parentId) {
-                const snapped = resolveCabinetModuleWallSnapLocal({
-                    candidateLocal: local,
-                    module: node,
-                    nodes: useScene.getState().nodes,
-                    parentLevelId: run.parentId,
-                    run,
-                });
-                if (snapped)
-                    local = snapped;
-            }
             lastLocal = local;
-            useLiveNodeOverrides.getState().set(moduleId, { position: local });
-            useScene.getState().markDirty(run.id);
+            lastPositionValid = cabinetModuleParentFrame.isValidPosition
+                ? cabinetModuleParentFrame.isValidPosition({
+                    node: { ...node, position: local },
+                    parent: run,
+                    position: local,
+                    nodes: useScene.getState().nodes,
+                })
+                : true;
+            publishPreview(local);
         },
         canCommit() {
             const live = useScene.getState().nodes[moduleId];
             if (live?.type !== 'cabinet-module')
                 return false;
-            return lastLocal[0] !== originalLocal[0] || lastLocal[2] !== originalLocal[2];
+            const changed = lastLocal[0] !== originalLocal[0] || lastLocal[2] !== originalLocal[2];
+            return changed && (lastPositionValid || forcePlace);
         },
         commit() {
             const scene = useScene.getState();
@@ -165,7 +228,12 @@ export const cabinetModuleFloorplanMoveTarget = ({ node, nodes, }) => {
                 return;
             }
             const runId = run.id;
-            const updates = collectCabinetModuleMoveCommitUpdates({ lastLocal, moduleId, runId });
+            const updates = collectCabinetModuleMoveCommitUpdates({
+                lastLocal,
+                moduleId,
+                previousModule: node,
+                runId,
+            });
             if (updates) {
                 scene.updateNodes(updates);
                 return;
@@ -182,6 +250,7 @@ export const cabinetModuleFloorplanMoveTarget = ({ node, nodes, }) => {
             if (liveModule?.type === 'cabinet-module') {
                 syncCornerRunsFromSourceModule({
                     module: liveModule,
+                    previousModule: node,
                     run: sceneApi.get(runId) ?? liveRun,
                     sceneApi,
                 });

package/dist/cabinet/geometry/fridge.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"fridge.d.ts","sourceRoot":"","sources":["../../../src/cabinet/geometry/fridge.ts"],"names":[],"mappings":"AAAA,OAAO,EAAe,KAAK,EAAuB,MAAM,OAAO,CAAA;AAC/D,OAAO,KAAK,EAAE,4BAA4B,EAAE,MAAM,UAAU,CAAA;AAC5D,OAAO,EAIL,KAAK,mBAAmB,EACxB,KAAK,oBAAoB,EAc1B,MAAM,UAAU,CAAA;AAy3BjB,wBAAgB,oBAAoB,CAClC,KAAK,EAAE,KAAK,EACZ,IAAI,EAAE,mBAAmB,EACzB,SAAS,EAAE,oBAAoB,EAC/B,IAAI,EAAE,4BAA4B,EAClC,SAAS,EAAE,MAAM,EACjB,UAAU,EAAE,MAAM,EAClB,WAAW,EAAE,MAAM,EACnB,YAAY,EAAE,MAAM,EACpB,YAAY,EAAE,MAAM,EACpB,MAAM,EAAE,MAAM,EACd,KAAK,EAAE,MAAM,QA2Ld"}
+{"version":3,"file":"fridge.d.ts","sourceRoot":"","sources":["../../../src/cabinet/geometry/fridge.ts"],"names":[],"mappings":"AAAA,OAAO,EAAe,KAAK,EAAuB,MAAM,OAAO,CAAA;AAC/D,OAAO,KAAK,EAAE,4BAA4B,EAAE,MAAM,UAAU,CAAA;AAE5D,OAAO,EAIL,KAAK,mBAAmB,EACxB,KAAK,oBAAoB,EAc1B,MAAM,UAAU,CAAA;AAy3BjB,wBAAgB,oBAAoB,CAClC,KAAK,EAAE,KAAK,EACZ,IAAI,EAAE,mBAAmB,EACzB,SAAS,EAAE,oBAAoB,EAC/B,IAAI,EAAE,4BAA4B,EAClC,SAAS,EAAE,MAAM,EACjB,UAAU,EAAE,MAAM,EAClB,WAAW,EAAE,MAAM,EACnB,YAAY,EAAE,MAAM,EACpB,YAAY,EAAE,MAAM,EACpB,MAAM,EAAE,MAAM,EACd,KAAK,EAAE,MAAM,QAqOd"}

package/dist/cabinet/geometry/fridge.js

@@ -1,4 +1,5 @@
 import { BoxGeometry, Group, Mesh } from 'three';
+import { addHandleFeature, buildFrontGeometry } from './fronts';
 import { addApplianceHandle, addBox, applianceDisplayMaterial, microwaveScreenMaterial, refrigeratorBinMaterial, refrigeratorBrassAccentMaterial, refrigeratorDarkTrimMaterial, refrigeratorDrawerMaterial, refrigeratorLightMaterial, refrigeratorLinerAccentMaterial, refrigeratorLinerMaterial, refrigeratorSealMaterial, refrigeratorSilverMaterial, refrigeratorWaterMaterial, roundedButtonGeometry, stampSlot, } from './shared';
 function addFridgeWireBasket(group, materials, x, width, depth, y, zCenter, name) {
     const bar = 0.006;
@@ -388,6 +389,29 @@ export function addFridgeCompartment(group, node, materials, kind, faceWidth, fa
         const doorHeight = Math.max(0.01, layout.height - doorGap * 2);
         const doorCenterX = shellWidth * layout.xFraction;
         const doorCenterY = shellCenterY + layout.y;
-        addFridgeLeaf(group, materials, doorWidth, doorHeight, layout.hinge, doorCenterX, doorCenterY, frontZ, `${name}-door-${layout.key}`, layout.section, node.operationState ?? 0);
+        const doorName = `${name}-door-${layout.key}`;
+        if (node.panelReady) {
+            const hingeGroup = new Group();
+            hingeGroup.name = `${doorName}-hinge`;
+            hingeGroup.position.set(layout.hinge === 'left' ? doorCenterX - doorWidth / 2 : doorCenterX + doorWidth / 2, doorCenterY, frontZ);
+            hingeGroup.rotation.y =
+                (layout.hinge === 'left' ? -1 : 1) * (Math.PI * 0.62) * (node.operationState ?? 0);
+            hingeGroup.userData.cabinetPose = {
+                type: 'rotate',
+                axis: 'y',
+                angle: (layout.hinge === 'left' ? -1 : 1) * (Math.PI * 0.62),
+            };
+            const panel = stampSlot(new Mesh(buildFrontGeometry(node, doorWidth, doorHeight, false, layout.hinge), materials.front), 'front');
+            panel.name = `${doorName}-panel`;
+            panel.position.x = layout.hinge === 'left' ? doorWidth / 2 : -doorWidth / 2;
+            panel.castShadow = true;
+            panel.receiveShadow = true;
+            addHandleFeature(panel, node, materials, doorWidth, doorHeight, layout.hinge, true, false, `${doorName}-handle`);
+            hingeGroup.add(panel);
+            group.add(hingeGroup);
+        }
+        else {
+            addFridgeLeaf(group, materials, doorWidth, doorHeight, layout.hinge, doorCenterX, doorCenterY, frontZ, doorName, layout.section, node.operationState ?? 0);
+        }
     }
 }

package/dist/cabinet/geometry/fronts.d.ts

@@ -2,6 +2,10 @@ import { type BufferGeometry, Group, type Material, type Object3D } from 'three'
 import { type CabinetGeometryNode, type CabinetSlotMaterials } from './shared';
 export declare function buildFrontGeometry(node: CabinetGeometryNode, width: number, height: number, drawer: boolean, hinge?: 'left' | 'right' | null): BufferGeometry;
 export declare function addBarHandle(group: Object3D, position: [number, number, number], length: number, vertical: boolean, name: string, material: Material): void;
+export declare function addHandleFeature(group: Object3D, node: CabinetGeometryNode, materials: CabinetSlotMaterials, width: number, height: number, hinge: 'left' | 'right' | null, vertical: boolean, drawer?: boolean, name?: string, placement?: {
+    x?: number;
+    y?: number;
+}): void;
 export declare function addDoorFronts(group: Group, node: CabinetGeometryNode, materials: CabinetSlotMaterials, openingWidth: number, openingHeight: number, centerX: number, centerY: number, frontZ: number, doorType: 'single-left' | 'single-right' | 'double' | 'glass'): void;
 export declare function addSinkFalseFront(group: Group, node: CabinetGeometryNode, materials: CabinetSlotMaterials, faceWidth: number, faceHeight: number, centerY: number, frontZ: number, index: number): void;
 export declare function addShelfBoards(group: Group, materials: CabinetSlotMaterials, openingWidth: number, openingDepth: number, board: number, y0: number, height: number, count: number, centerX?: number): void;

package/dist/cabinet/geometry/fronts.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"fronts.d.ts","sourceRoot":"","sources":["../../../src/cabinet/geometry/fronts.ts"],"names":[],"mappings":"AAOA,OAAO,EAEL,KAAK,cAAc,EAGnB,KAAK,EACL,KAAK,QAAQ,EAIb,KAAK,QAAQ,EAGd,MAAM,OAAO,CAAA;AACd,OAAO,EAEL,KAAK,mBAAmB,EACxB,KAAK,oBAAoB,EAG1B,MAAM,UAAU,CAAA;AAoSjB,wBAAgB,kBAAkB,CAChC,IAAI,EAAE,mBAAmB,EACzB,KAAK,EAAE,MAAM,EACb,MAAM,EAAE,MAAM,EACd,MAAM,EAAE,OAAO,EACf,KAAK,GAAE,MAAM,GAAG,OAAO,GAAG,IAAW,GACpC,cAAc,CAUhB;AAsBD,wBAAgB,YAAY,CAC1B,KAAK,EAAE,QAAQ,EACf,QAAQ,EAAE,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,EAClC,MAAM,EAAE,MAAM,EACd,QAAQ,EAAE,OAAO,EACjB,IAAI,EAAE,MAAM,EACZ,QAAQ,EAAE,QAAQ,QA4BnB;AA6PD,wBAAgB,aAAa,CAC3B,KAAK,EAAE,KAAK,EACZ,IAAI,EAAE,mBAAmB,EACzB,SAAS,EAAE,oBAAoB,EAC/B,YAAY,EAAE,MAAM,EACpB,aAAa,EAAE,MAAM,EACrB,OAAO,EAAE,MAAM,EACf,OAAO,EAAE,MAAM,EACf,MAAM,EAAE,MAAM,EACd,QAAQ,EAAE,aAAa,GAAG,cAAc,GAAG,QAAQ,GAAG,OAAO,QA8C9D;AAED,wBAAgB,iBAAiB,CAC/B,KAAK,EAAE,KAAK,EACZ,IAAI,EAAE,mBAAmB,EACzB,SAAS,EAAE,oBAAoB,EAC/B,SAAS,EAAE,MAAM,EACjB,UAAU,EAAE,MAAM,EAClB,OAAO,EAAE,MAAM,EACf,MAAM,EAAE,MAAM,EACd,KAAK,EAAE,MAAM,QAgBd;AAED,wBAAgB,cAAc,CAC5B,KAAK,EAAE,KAAK,EACZ,SAAS,EAAE,oBAAoB,EAC/B,YAAY,EAAE,MAAM,EACpB,YAAY,EAAE,MAAM,EACpB,KAAK,EAAE,MAAM,EACb,EAAE,EAAE,MAAM,EACV,MAAM,EAAE,MAAM,EACd,KAAK,EAAE,MAAM,EACb,OAAO,SAAI,QAcZ;AAOD,wBAAgB,eAAe,CAC7B,KAAK,EAAE,KAAK,EACZ,IAAI,EAAE,mBAAmB,EACzB,SAAS,EAAE,oBAAoB,EAC/B,SAAS,EAAE,MAAM,EACjB,UAAU,EAAE,MAAM,EAClB,OAAO,EAAE,MAAM,EACf,EAAE,EAAE,MAAM,EACV,eAAe,EAAE,MAAM,EACvB,MAAM,EAAE,MAAM,EACd,KAAK,EAAE,MAAM,EACb,QAAQ,EAAE,MAAM,EAChB,QAAQ,EAAE,MAAM,QAiFjB"}
+{"version":3,"file":"fronts.d.ts","sourceRoot":"","sources":["../../../src/cabinet/geometry/fronts.ts"],"names":[],"mappings":"AAOA,OAAO,EAEL,KAAK,cAAc,EAGnB,KAAK,EACL,KAAK,QAAQ,EAIb,KAAK,QAAQ,EAGd,MAAM,OAAO,CAAA;AACd,OAAO,EAEL,KAAK,mBAAmB,EACxB,KAAK,oBAAoB,EAG1B,MAAM,UAAU,CAAA;AAoSjB,wBAAgB,kBAAkB,CAChC,IAAI,EAAE,mBAAmB,EACzB,KAAK,EAAE,MAAM,EACb,MAAM,EAAE,MAAM,EACd,MAAM,EAAE,OAAO,EACf,KAAK,GAAE,MAAM,GAAG,OAAO,GAAG,IAAW,GACpC,cAAc,CAUhB;AAsBD,wBAAgB,YAAY,CAC1B,KAAK,EAAE,QAAQ,EACf,QAAQ,EAAE,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,EAClC,MAAM,EAAE,MAAM,EACd,QAAQ,EAAE,OAAO,EACjB,IAAI,EAAE,MAAM,EACZ,QAAQ,EAAE,QAAQ,QA4BnB;AAwED,wBAAgB,gBAAgB,CAC9B,KAAK,EAAE,QAAQ,EACf,IAAI,EAAE,mBAAmB,EACzB,SAAS,EAAE,oBAAoB,EAC/B,KAAK,EAAE,MAAM,EACb,MAAM,EAAE,MAAM,EACd,KAAK,EAAE,MAAM,GAAG,OAAO,GAAG,IAAI,EAC9B,QAAQ,EAAE,OAAO,EACjB,MAAM,UAAQ,EACd,IAAI,SAAW,EACf,SAAS,CAAC,EAAE;IAAE,CAAC,CAAC,EAAE,MAAM,CAAC;IAAC,CAAC,CAAC,EAAE,MAAM,CAAA;CAAE,QAwBvC;AAmJD,wBAAgB,aAAa,CAC3B,KAAK,EAAE,KAAK,EACZ,IAAI,EAAE,mBAAmB,EACzB,SAAS,EAAE,oBAAoB,EAC/B,YAAY,EAAE,MAAM,EACpB,aAAa,EAAE,MAAM,EACrB,OAAO,EAAE,MAAM,EACf,OAAO,EAAE,MAAM,EACf,MAAM,EAAE,MAAM,EACd,QAAQ,EAAE,aAAa,GAAG,cAAc,GAAG,QAAQ,GAAG,OAAO,QA8C9D;AAED,wBAAgB,iBAAiB,CAC/B,KAAK,EAAE,KAAK,EACZ,IAAI,EAAE,mBAAmB,EACzB,SAAS,EAAE,oBAAoB,EAC/B,SAAS,EAAE,MAAM,EACjB,UAAU,EAAE,MAAM,EAClB,OAAO,EAAE,MAAM,EACf,MAAM,EAAE,MAAM,EACd,KAAK,EAAE,MAAM,QAgBd;AAED,wBAAgB,cAAc,CAC5B,KAAK,EAAE,KAAK,EACZ,SAAS,EAAE,oBAAoB,EAC/B,YAAY,EAAE,MAAM,EACpB,YAAY,EAAE,MAAM,EACpB,KAAK,EAAE,MAAM,EACb,EAAE,EAAE,MAAM,EACV,MAAM,EAAE,MAAM,EACd,KAAK,EAAE,MAAM,EACb,OAAO,SAAI,QAcZ;AAOD,wBAAgB,eAAe,CAC7B,KAAK,EAAE,KAAK,EACZ,IAAI,EAAE,mBAAmB,EACzB,SAAS,EAAE,oBAAoB,EAC/B,SAAS,EAAE,MAAM,EACjB,UAAU,EAAE,MAAM,EAClB,OAAO,EAAE,MAAM,EACf,EAAE,EAAE,MAAM,EACV,eAAe,EAAE,MAAM,EACvB,MAAM,EAAE,MAAM,EACd,KAAK,EAAE,MAAM,EACb,QAAQ,EAAE,MAAM,EAChB,QAAQ,EAAE,MAAM,QAiFjB"}

package/dist/cabinet/geometry/fronts.js

@@ -313,7 +313,7 @@ function resolveHandlePlacement(node, width, height, drawer, hinge) {
         y: drawer ? (position === 'center' ? 0 : frameY) : position === 'center' ? 0 : defaultY,
     };
 }
-function addHandleFeature(group, node, materials, width, height, hinge, vertical, drawer = false, name = 'handle', placement) {
+export function addHandleFeature(group, node, materials, width, height, hinge, vertical, drawer = false, name = 'handle', placement) {
     const style = node.handleStyle ?? 'bar';
     if (style === 'none')
         return;

package/dist/cabinet/geometry/run.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"run.d.ts","sourceRoot":"","sources":["../../../src/cabinet/geometry/run.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,iBAAiB,EAAE,WAAW,EAAE,eAAe,EAAE,MAAM,kBAAkB,CAAA;AACvF,OAAO,KAAK,EAAE,WAAW,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAA;AACpE,OAAO,EAAE,KAAK,EAAa,MAAM,OAAO,CAAA;AAMxC,wBAAgB,aAAa,CAAC,GAAG,CAAC,EAAE,eAAe,GAAG,iBAAiB,EAAE,CAIxE;AAED,wBAAgB,uBAAuB,CACrC,IAAI,EAAE,WAAW,EACjB,GAAG,EAAE,eAAe,GAAG,SAAS,EAChC,OAAO,EAAE,aAAa,EACtB,QAAQ,EAAE,OAAO,EACjB,WAAW,EAAE,WAAW,EACxB,UAAU,EAAE,MAAM,GAAG,SAAS,GAC7B,KAAK,GAAG,IAAI,CA2Ld"}
+{"version":3,"file":"run.d.ts","sourceRoot":"","sources":["../../../src/cabinet/geometry/run.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,iBAAiB,EAAE,WAAW,EAAE,eAAe,EAAE,MAAM,kBAAkB,CAAA;AACvF,OAAO,KAAK,EAAE,WAAW,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAA;AACpE,OAAO,EAAE,KAAK,EAAQ,MAAM,OAAO,CAAA;AAOnC,wBAAgB,aAAa,CAAC,GAAG,CAAC,EAAE,eAAe,GAAG,iBAAiB,EAAE,CAIxE;AAED,wBAAgB,uBAAuB,CACrC,IAAI,EAAE,WAAW,EACjB,GAAG,EAAE,eAAe,GAAG,SAAS,EAChC,OAAO,EAAE,aAAa,EACtB,QAAQ,EAAE,OAAO,EACjB,WAAW,EAAE,WAAW,EACxB,UAAU,EAAE,MAAM,GAAG,SAAS,GAC7B,KAAK,GAAG,IAAI,CAmNd"}

package/dist/cabinet/geometry/run.js

@@ -1,6 +1,7 @@
-import { Group } from 'three';
+import { Group, Mesh } from 'three';
 import { getRunSpanEnds, getRunSpans } from '../run-layout';
 import { compartmentSinkLayout, stackForCabinet } from '../stack';
+import { buildFrontGeometry } from './fronts';
 import { addBox, getCabinetSlotMaterials } from './shared';
 import { cutSinkIntoCountertop, sinkBowls } from './sink';
 export function getRunModules(ctx) {
@@ -34,6 +35,23 @@ export function buildCabinetRunGeometry(node, ctx, shading, textures, colorPrese
         if (node.withFinishedBack) {
             addBox(group, [span.width, span.topY, node.boardThickness], [span.centerX, span.topY / 2, span.minZ - node.boardThickness / 2], materials.front, 'cabinet-run-back-panel', 'front');
         }
+        if (node.withFinishedEnds) {
+            for (const side of ['left', 'right']) {
+                const exposed = side === 'left' ? exposedLeft : exposedRight;
+                if (!exposed)
+                    continue;
+                const endPanel = new Mesh(buildFrontGeometry(node, span.depth, span.topY, false, null), materials.front);
+                endPanel.name = `cabinet-run-finished-end-${side}`;
+                endPanel.position.set(side === 'left'
+                    ? span.minX - node.frontThickness / 2
+                    : span.maxX + node.frontThickness / 2, span.topY / 2, span.centerZ);
+                endPanel.rotation.y = side === 'left' ? -Math.PI / 2 : Math.PI / 2;
+                endPanel.castShadow = true;
+                endPanel.receiveShadow = true;
+                endPanel.userData.slotId = 'front';
+                group.add(endPanel);
+            }
+        }
         // Raised bar counter: knee wall against one run face topped by a slab at
         // bar height, cantilevered outward as knee space for stools. Side bars
         // apply only to the run's end span on that side.

package/dist/cabinet/geometry.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"geometry.d.ts","sourceRoot":"","sources":["../../src/cabinet/geometry.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAe,eAAe,EAAE,MAAM,kBAAkB,CAAA;AACpE,OAAO,KAAK,EAAE,WAAW,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAA;AACpE,OAAO,EAAE,KAAK,EAAE,MAAM,OAAO,CAAA;AAc7B,OAAO,EAAU,KAAK,mBAAmB,EAA2B,MAAM,mBAAmB,CAAA;AAmB7F,wBAAgB,oBAAoB,CAClC,IAAI,EAAE,mBAAmB,EACzB,GAAG,CAAC,EAAE,eAAe,EACrB,OAAO,GAAE,aAA0B,EACnC,QAAQ,UAAO,EACf,WAAW,GAAE,WAAoB,EACjC,UAAU,CAAC,EAAE,MAAM,GAClB,KAAK,CA2dP"}
+{"version":3,"file":"geometry.d.ts","sourceRoot":"","sources":["../../src/cabinet/geometry.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAkC,eAAe,EAAE,MAAM,kBAAkB,CAAA;AACvF,OAAO,KAAK,EAAE,WAAW,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAA;AACpE,OAAO,EAAE,KAAK,EAAE,MAAM,OAAO,CAAA;AAc7B,OAAO,EAEL,KAAK,mBAAmB,EAGzB,MAAM,mBAAmB,CAAA;AAuJ1B,wBAAgB,oBAAoB,CAClC,IAAI,EAAE,mBAAmB,EACzB,GAAG,CAAC,EAAE,eAAe,EACrB,OAAO,GAAE,aAA0B,EACnC,QAAQ,UAAO,EACf,WAAW,GAAE,WAAoB,EACjC,UAAU,CAAC,EAAE,MAAM,GAClB,KAAK,CA8dP"}

package/dist/cabinet/geometry.js

@@ -7,7 +7,7 @@ import { addRangeHoodCompartment } from './geometry/hood';
 import { addApplianceCompartment } from './geometry/oven-microwave';
 import { addPullOutPantryCompartment } from './geometry/pantry';
 import { buildCabinetRunGeometry } from './geometry/run';
-import { addBox, getCabinetSlotMaterials } from './geometry/shared';
+import { addBox, getCabinetSlotMaterials, } from './geometry/shared';
 import { addSinkCompartment, cutSinkIntoCountertop, sinkBowls } from './geometry/sink';
 import { compartmentDoorType, compartmentDrawerCount, compartmentShelfCount, compartmentSinkLayout, isHoodCompartmentType, normalizeCabinetStack, stackForCabinet, } from './stack';
 const CORNER_FILLER_TOP_INSET = 0.001;
@@ -15,6 +15,66 @@ const CORNER_FILLER_SIDE_INSET = 0.001;
 const WALL_CORNER_FILLER_FRONT_HEIGHT_INSET = 0.001;
 const SINK_FALSE_FRONT_HEIGHT = 0.22;
 const MIN_RENDERABLE_BRIDGE_FILLER_WIDTH = 1e-4;
+function addTopFinishGeometry(group, node, materials, topY, isWallCornerFiller = false) {
+    if (!node.topFinish || node.topFinish === 'none')
+        return;
+    const height = Math.max(0.05, node.topFinishHeight ?? 0.33);
+    const board = node.boardThickness;
+    const depth = Math.min(node.depth, Math.max(0.15, node.topFinishDepth ?? node.depth));
+    const backInset = Math.min(0.012, depth * 0.08);
+    const backThickness = Math.min(0.006, board / 2);
+    const centerZ = (node.depth - depth) / 2;
+    const inset = node.frontOverlay === 'inset';
+    const isCornerFiller = node.moduleKind === 'corner-filler';
+    const openLeft = node.openSide === 'left';
+    const openRight = node.openSide === 'right';
+    const topFrontZ = inset
+        ? centerZ + depth / 2 - node.frontThickness / 2 - 0.0015
+        : centerZ + depth / 2 + node.frontThickness / 2 - 0.0015;
+    if (node.topFinish === 'trim') {
+        addBox(group, [node.width, height, depth], [0, topY + height / 2, centerZ], materials.carcass, 'cabinet-top-trim', 'carcass');
+        return;
+    }
+    const innerLeft = -node.width / 2 + (node.openSide === 'left' ? 0 : board);
+    const innerRight = node.width / 2 - (node.openSide === 'right' ? 0 : board);
+    const innerWidth = Math.max(0.01, innerRight - innerLeft);
+    const innerCenterX = (innerLeft + innerRight) / 2;
+    if (!openLeft) {
+        addBox(group, [board, height, depth], [-node.width / 2 + board / 2, topY + height / 2, centerZ], materials.carcass, 'cabinet-top-cabinet-side-left', 'carcass');
+    }
+    if (!openRight) {
+        addBox(group, [board, height, depth], [node.width / 2 - board / 2, topY + height / 2, centerZ], materials.carcass, 'cabinet-top-cabinet-side-right', 'carcass');
+    }
+    addBox(group, [innerWidth, board, depth], [innerCenterX, topY + board / 2, centerZ], materials.carcass, 'cabinet-top-cabinet-bottom', 'carcass');
+    addBox(group, [innerWidth, board, depth], [innerCenterX, topY + height - board / 2, centerZ], materials.carcass, 'cabinet-top-cabinet-top', 'carcass');
+    addBox(group, [innerWidth, Math.max(0.001, height - board * 2), backThickness], [innerCenterX, topY + height / 2, centerZ - depth / 2 + backInset + backThickness / 2], materials.carcass, 'cabinet-top-cabinet-back', 'carcass');
+    if (isCornerFiller) {
+        const frontExtension = board / 2 + node.frontGap;
+        const wallFrontSharedInset = isWallCornerFiller ? node.frontThickness + node.frontGap : 0;
+        const frontLeft = -node.width / 2 -
+            (openLeft ? frontExtension : 0) +
+            (isWallCornerFiller && openRight ? wallFrontSharedInset : 0);
+        const frontRight = node.width / 2 +
+            (openRight ? frontExtension : 0) -
+            (isWallCornerFiller && openLeft ? wallFrontSharedInset : 0);
+        const frontHeight = isWallCornerFiller
+            ? Math.max(0.01, height - WALL_CORNER_FILLER_FRONT_HEIGHT_INSET * 2)
+            : height;
+        addBox(group, [Math.max(0.01, frontRight - frontLeft), frontHeight, node.frontThickness], [(frontLeft + frontRight) / 2, topY + height / 2, topFrontZ], materials.front, 'cabinet-top-corner-filler-front', 'front');
+        return;
+    }
+    // Keep the upper front's reveal contract identical to the parent cabinet.
+    // Overlay fronts reserve one extra front gap at the opening edge; addDoorFronts
+    // applies the remaining leaf-to-leaf gaps. Inset fronts use the carcass opening.
+    const faceWidth = inset ? innerWidth : Math.max(0.01, node.width - node.frontGap);
+    const topDoorCompartment = stackForCabinet(node).find((compartment) => compartment.type === 'door');
+    const topDoorType = topDoorCompartment
+        ? compartmentDoorType(topDoorCompartment, node.width)
+        : node.width > 0.5
+            ? 'double'
+            : 'single-left';
+    addDoorFronts(group, node, materials, faceWidth, inset ? Math.max(0.01, height - board * 2) : height, 0, topY + height / 2, topFrontZ, topDoorType);
+}
 export function buildCabinetGeometry(node, ctx, shading = 'rendered', textures = true, colorPreset = 'clay', sceneTheme) {
     if (node.type === 'cabinet') {
         const run = buildCabinetRunGeometry(node, ctx, shading, textures, colorPreset, sceneTheme);
@@ -109,6 +169,7 @@ export function buildCabinetGeometry(node, ctx, shading = 'rendered', textures =
         if (node.cornerShelf) {
             addShelfBoards(filler, materials, innerWidth, shelfDepth, board, plinth + board, Math.max(0.01, carcassHeight - board * 2), shelfCount, innerCenterX);
         }
+        addTopFinishGeometry(filler, node, materials, topY, isWallCornerFiller);
         return filler;
     }
     const rows = normalizeCabinetStack(node);
@@ -219,5 +280,6 @@ export function buildCabinetGeometry(node, ctx, shading = 'rendered', textures =
             addRangeHoodCompartment(group, node, materials, row.compartment.type, plinth + row.y0, row.height, ctx, index);
         }
     });
+    addTopFinishGeometry(group, node, materials, topY);
     return group;
 }

package/dist/cabinet/index.d.ts

@@ -2,4 +2,5 @@ export { bakeCabinetAnimationClip, poseCabinetMovingParts } from './animation';
 export { cabinetDefinition, cabinetModuleDefinition } from './definition';
 export { default as useCabinetPlacementStatus } from './placement-status';
 export { type CabinetPlacementType, default as useCabinetPlacementType, } from './placement-type';
+export { CABINET_PLANNING_TOLERANCE, type CabinetPlanningIssue, type CabinetPlanningIssueCode, type CabinetPlanningOptions, type CabinetPlanningReport, MIN_PRACTICAL_TOP_CABINET_HEIGHT, validateCabinetRun, } from './validation';
 //# sourceMappingURL=index.d.ts.map

package/dist/cabinet/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/cabinet/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,wBAAwB,EAAE,sBAAsB,EAAE,MAAM,aAAa,CAAA;AAC9E,OAAO,EAAE,iBAAiB,EAAE,uBAAuB,EAAE,MAAM,cAAc,CAAA;AACzE,OAAO,EAAE,OAAO,IAAI,yBAAyB,EAAE,MAAM,oBAAoB,CAAA;AACzE,OAAO,EACL,KAAK,oBAAoB,EACzB,OAAO,IAAI,uBAAuB,GACnC,MAAM,kBAAkB,CAAA"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/cabinet/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,wBAAwB,EAAE,sBAAsB,EAAE,MAAM,aAAa,CAAA;AAC9E,OAAO,EAAE,iBAAiB,EAAE,uBAAuB,EAAE,MAAM,cAAc,CAAA;AACzE,OAAO,EAAE,OAAO,IAAI,yBAAyB,EAAE,MAAM,oBAAoB,CAAA;AACzE,OAAO,EACL,KAAK,oBAAoB,EACzB,OAAO,IAAI,uBAAuB,GACnC,MAAM,kBAAkB,CAAA;AACzB,OAAO,EACL,0BAA0B,EAC1B,KAAK,oBAAoB,EACzB,KAAK,wBAAwB,EAC7B,KAAK,sBAAsB,EAC3B,KAAK,qBAAqB,EAC1B,gCAAgC,EAChC,kBAAkB,GACnB,MAAM,cAAc,CAAA"}

package/dist/cabinet/index.js

@@ -2,3 +2,4 @@ export { bakeCabinetAnimationClip, poseCabinetMovingParts } from './animation';
 export { cabinetDefinition, cabinetModuleDefinition } from './definition';
 export { default as useCabinetPlacementStatus } from './placement-status';
 export { default as useCabinetPlacementType, } from './placement-type';
+export { CABINET_PLANNING_TOLERANCE, MIN_PRACTICAL_TOP_CABINET_HEIGHT, validateCabinetRun, } from './validation';

package/dist/cabinet/insertion.d.ts

@@ -0,0 +1,19 @@
+import type { AnyNodeId, CabinetModuleNode, CabinetNode, SceneApi } from '@pascal-app/core';
+export declare function cabinetModuleForRunInsertion(module: CabinetModuleNode, run: CabinetNode): CabinetModuleNode;
+export declare function applyCabinetModuleInsertion({ module, plan, run, sceneApi, }: {
+    module: CabinetModuleNode;
+    plan: {
+        modules: ReadonlyArray<{
+            id: AnyNodeId;
+            position: [number, number, number];
+            width: number;
+        }>;
+        inserted: {
+            position: [number, number, number];
+            width: number;
+        };
+    };
+    run: CabinetNode;
+    sceneApi: SceneApi;
+}): AnyNodeId | null;
+//# sourceMappingURL=insertion.d.ts.map

package/dist/cabinet/insertion.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"insertion.d.ts","sourceRoot":"","sources":["../../src/cabinet/insertion.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAW,SAAS,EAAE,iBAAiB,EAAE,WAAW,EAAE,QAAQ,EAAE,MAAM,kBAAkB,CAAA;AAEpG,wBAAgB,4BAA4B,CAC1C,MAAM,EAAE,iBAAiB,EACzB,GAAG,EAAE,WAAW,GACf,iBAAiB,CAWnB;AAED,wBAAgB,2BAA2B,CAAC,EAC1C,MAAM,EACN,IAAI,EACJ,GAAG,EACH,QAAQ,GACT,EAAE;IACD,MAAM,EAAE,iBAAiB,CAAA;IACzB,IAAI,EAAE;QACJ,OAAO,EAAE,aAAa,CAAC;YACrB,EAAE,EAAE,SAAS,CAAA;YACb,QAAQ,EAAE,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,CAAA;YAClC,KAAK,EAAE,MAAM,CAAA;SACd,CAAC,CAAA;QACF,QAAQ,EAAE;YACR,QAAQ,EAAE,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,CAAA;YAClC,KAAK,EAAE,MAAM,CAAA;SACd,CAAA;KACF,CAAA;IACD,GAAG,EAAE,WAAW,CAAA;IAChB,QAAQ,EAAE,QAAQ,CAAA;CACnB,GAAG,SAAS,GAAG,IAAI,CAuCnB"}

package/dist/cabinet/insertion.js

@@ -0,0 +1,49 @@
+export function cabinetModuleForRunInsertion(module, run) {
+    return {
+        ...module,
+        parentId: run.id,
+        plinthHeight: run.plinthHeight,
+        showPlinth: false,
+        countertopThickness: 0,
+        countertopOverhang: run.countertopOverhang,
+        countertopBackOverhang: run.countertopBackOverhang,
+        withCountertop: false,
+    };
+}
+export function applyCabinetModuleInsertion({ module, plan, run, sceneApi, }) {
+    const liveRun = sceneApi.get(run.id);
+    if (!liveRun)
+        return null;
+    const plannedIds = new Set(plan.modules.map((entry) => entry.id));
+    for (const planned of plan.modules) {
+        const current = sceneApi.get(planned.id);
+        if (!current || current.parentId !== liveRun.id)
+            return null;
+        sceneApi.update(current.id, {
+            position: planned.position,
+            width: planned.width,
+        });
+    }
+    const inserted = {
+        ...cabinetModuleForRunInsertion(module, liveRun),
+        position: plan.inserted.position,
+        width: plan.inserted.width,
+    };
+    sceneApi.upsert(inserted, liveRun.id);
+    const orderedModules = [
+        ...plan.modules.map((entry) => ({ id: entry.id, x: entry.position[0] })),
+        { id: inserted.id, x: inserted.position[0] },
+    ].sort((left, right) => left.x - right.x);
+    const otherChildren = (liveRun.children ?? []).filter((id) => !plannedIds.has(id) && id !== inserted.id);
+    const allModules = [
+        ...plan.modules.map((entry) => ({ width: entry.width, x: entry.position[0] })),
+        { width: inserted.width, x: inserted.position[0] },
+    ];
+    const minX = Math.min(...allModules.map(({ x, width }) => x - width / 2));
+    const maxX = Math.max(...allModules.map(({ x, width }) => x + width / 2));
+    sceneApi.update(liveRun.id, {
+        children: [...otherChildren, ...orderedModules.map(({ id }) => id)],
+        width: maxX - minX,
+    });
+    return inserted.id;
+}

package/dist/cabinet/move-frame.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"move-frame.d.ts","sourceRoot":"","sources":["../../src/cabinet/move-frame.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAKV,kBAAkB,EAEnB,MAAM,kBAAkB,CAAA;AAiSzB,eAAO,MAAM,wBAAwB,EAAE,kBAgCtC,CAAA"}
+{"version":3,"file":"move-frame.d.ts","sourceRoot":"","sources":["../../src/cabinet/move-frame.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAKV,kBAAkB,EAEnB,MAAM,kBAAkB,CAAA;AA8VzB,eAAO,MAAM,wBAAwB,EAAE,kBAwDtC,CAAA"}

package/dist/cabinet/move-frame.js

@@ -1,8 +1,52 @@
-import { planToRunLocal, runLocalToPlan } from './run-layout';
-import { bumpCabinetRunLayoutRevision, syncCornerRunsFromSourceModule } from './run-ops';
+import { findLevelAncestorId } from '@pascal-app/core';
+import { findWallOpeningConflicts } from '../shared/wall-opening-clearance';
+import { moduleMaxX, moduleMinX, planToRunLocal, runLocalToPlan } from './run-layout';
+import { bumpCabinetRunLayoutRevision, cabinetModulesForRun, cabinetModuleTotalHeight, previewCornerRunsFromRunSources, syncCornerRunsFromSourceModule, } from './run-ops';
+import { findClosestCabinetWallInPlan, resolveCabinetWallFaceOffset } from './wall-snap';
 /** Matches the generic move tool's Figma-alignment pull (8 cm). */
 const MAGNETIC_THRESHOLD_M = 0.08;
 const GUIDE_EPSILON_M = 1e-4;
+function modulesOverlap(a, b) {
+    const xOverlap = moduleMinX(a) < moduleMaxX(b) - GUIDE_EPSILON_M &&
+        moduleMaxX(a) > moduleMinX(b) + GUIDE_EPSILON_M;
+    const aMinZ = a.position[2] - a.depth / 2;
+    const aMaxZ = a.position[2] + a.depth / 2;
+    const bMinZ = b.position[2] - b.depth / 2;
+    const bMaxZ = b.position[2] + b.depth / 2;
+    return xOverlap && aMinZ < bMaxZ - GUIDE_EPSILON_M && aMaxZ > bMinZ + GUIDE_EPSILON_M;
+}
+function moduleOverlapsWallOpening(module, parent, position, nodes) {
+    const levelId = findLevelAncestorId(parent.id, nodes);
+    if (!levelId)
+        return false;
+    const planPosition = localToPlan(parent, position, nodes);
+    const hit = findClosestCabinetWallInPlan({
+        excludeIds: [],
+        nodes: nodes,
+        parentLevelId: levelId,
+        planPoint: [planPosition[0], planPosition[2]],
+        yaw: frameWorldTransform(parent, nodes).rotation + module.rotation,
+    });
+    if (!hit)
+        return false;
+    const normalScale = hit.side === 'front' ? 1 : -1;
+    const expectedPerp = resolveCabinetWallFaceOffset({
+        hit,
+        nodes: nodes,
+        parentLevelId: levelId,
+    }) +
+        normalScale * (module.depth / 2);
+    if (Math.abs(hit.perpDistance - expectedPerp) > 0.12)
+        return false;
+    return (findWallOpeningConflicts({
+        bottom: planPosition[1],
+        height: cabinetModuleTotalHeight(module),
+        localX: hit.localX,
+        nodes: nodes,
+        wall: hit.wall,
+        width: module.width,
+    }).length > 0);
+}
 function frameParent(node, nodes) {
     if (node.type !== 'cabinet-module' || !node.parentId)
         return null;
@@ -224,6 +268,28 @@ export const cabinetModuleParentFrame = {
     planToLocal,
     magneticSnap,
     magneticSnapMatches,
+    previewOverrides: ({ node, parent, position, sceneApi }) => {
+        if (node.type !== 'cabinet-module' || parent.type !== 'cabinet')
+            return [];
+        return previewCornerRunsFromRunSources({
+            initialOverrides: [[node.id, { position: [...position] }]],
+            previousModules: [node],
+            run: parent,
+            sceneApi,
+        }).filter(([id]) => id !== node.id);
+    },
+    isValidPosition: ({ node, parent, position, nodes }) => {
+        if (node.type !== 'cabinet-module' || parent.type !== 'cabinet')
+            return true;
+        const moving = { ...node, position: [...position] };
+        const siblingConflict = cabinetModulesForRun(parent, nodes).some((sibling) => {
+            if (sibling.id === moving.id)
+                return false;
+            return modulesOverlap(moving, sibling);
+        });
+        return (!siblingConflict &&
+            !moduleOverlapsWallOpening(moving, parent, position, nodes));
+    },
     // Module position isn't in the run's geometryKey, so a committed move must
     // bump the layout revision to re-flow spans/countertop — and re-anchor any
     // linked L-corner runs to the module's new edge.

package/dist/cabinet/panel-context.d.ts

@@ -0,0 +1,7 @@
+import type { AnyNode, AnyNodeId, CabinetModuleNode, CabinetNode } from '@pascal-app/core';
+export type CabinetModulePanelContext = {
+    parentRun: CabinetNode;
+    reflowModule: CabinetModuleNode | null;
+};
+export declare function cabinetModulePanelContext(module: CabinetModuleNode, nodes: Readonly<Partial<Record<AnyNodeId, AnyNode>>>): CabinetModulePanelContext | null;
+//# sourceMappingURL=panel-context.d.ts.map

package/dist/cabinet/panel-context.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"panel-context.d.ts","sourceRoot":"","sources":["../../src/cabinet/panel-context.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,SAAS,EAAE,iBAAiB,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAA;AAE1F,MAAM,MAAM,yBAAyB,GAAG;IACtC,SAAS,EAAE,WAAW,CAAA;IACtB,YAAY,EAAE,iBAAiB,GAAG,IAAI,CAAA;CACvC,CAAA;AAED,wBAAgB,yBAAyB,CACvC,MAAM,EAAE,iBAAiB,EACzB,KAAK,EAAE,QAAQ,CAAC,OAAO,CAAC,MAAM,CAAC,SAAS,EAAE,OAAO,CAAC,CAAC,CAAC,GACnD,yBAAyB,GAAG,IAAI,CAgBlC"}

package/dist/cabinet/panel-context.js

@@ -0,0 +1,16 @@
+export function cabinetModulePanelContext(module, nodes) {
+    const directParentId = module.parentId;
+    let current = directParentId ? nodes[directParentId] : undefined;
+    const visited = new Set();
+    while (current && !visited.has(current.id)) {
+        visited.add(current.id);
+        if (current.type === 'cabinet') {
+            return {
+                parentRun: current,
+                reflowModule: current.id === directParentId ? module : null,
+            };
+        }
+        current = current.parentId ? nodes[current.parentId] : undefined;
+    }
+    return null;
+}