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

package/dist/gutter/renderer.js

@@ -1,7 +1,7 @@
 'use client';
 import { jsx as _jsx } from "react/jsx-runtime";
 import { useLiveNodeOverrides, useRegistry, useScene, } from '@pascal-app/core';
-import { createMaterial, createMaterialFromPresetRef, createSurfaceRoleMaterial, useNodeEvents, useViewer, } from '@pascal-app/viewer';
+import { createMaterial, createMaterialFromPresetRef, createSurfaceRoleMaterial, resolveMaterialRef, useNodeEvents, useViewer, } from '@pascal-app/viewer';
 import { useEffect, useMemo, useRef } from 'react';
 import * as THREE from 'three';
 import { useShallow } from 'zustand/react/shallow';
@@ -10,11 +10,25 @@ import { computeGutterMitres, NO_MITRES } from './corner-mitre';
 import { computeSharedEaveY } from './eave-align';
 import { computeEaveY } from './eave-snap';
 import { buildGutterGeometry } from './geometry';
+import { segmentForGutterTrimClip } from './trim-clip';
 const defaultMaterial = new THREE.MeshStandardMaterial({
     color: 0xff_ff_ff,
     roughness: 0.7,
     metalness: 0.25,
 });
+function leanToJointMitres(node) {
+    const metadata = node.metadata && typeof node.metadata === 'object' && !Array.isArray(node.metadata)
+        ? node.metadata
+        : {};
+    const value = metadata.leanToGutterMitres;
+    if (!(value && typeof value === 'object' && !Array.isArray(value)))
+        return NO_MITRES;
+    const mitres = value;
+    return {
+        left: typeof mitres.left === 'number' && Number.isFinite(mitres.left) ? mitres.left : 0,
+        right: typeof mitres.right === 'number' && Number.isFinite(mitres.right) ? mitres.right : 0,
+    };
+}
 /**
  * Gutter renderer. Mounts at the eave of the host roof-segment — the
  * gutter hangs level off the eave line (gravity wins; no slope tilt).
@@ -39,6 +53,7 @@ const GutterRenderer = ({ node: storeNode }) => {
     const textures = useViewer((s) => s.textures);
     const colorPreset = useViewer((s) => s.colorPreset);
     const sceneTheme = useViewer((s) => s.sceneTheme);
+    const sceneMaterials = useScene((s) => s.materials);
     const overrides = useLiveNodeOverrides((s) => s.get(storeNode.id));
     const node = overrides ? { ...storeNode, ...overrides } : storeNode;
     const segment = useScene((state) => node.roofSegmentId
@@ -74,6 +89,9 @@ const GutterRenderer = ({ node: storeNode }) => {
         if (!roof)
             return [];
         const out = [];
+        const managedByLeanTo = typeof node.metadata?.managedByLeanTo === 'string'
+            ? node.metadata.managedByLeanTo
+            : null;
         for (const sid of roof.children ?? []) {
             const s = state.nodes[sid];
             if (s?.type !== 'roof-segment')
@@ -85,6 +103,21 @@ const GutterRenderer = ({ node: storeNode }) => {
                     out.push(g);
             }
         }
+        if (managedByLeanTo) {
+            for (const candidate of Object.values(state.nodes)) {
+                if (candidate?.type !== 'gutter' || candidate.id === storeNode.id)
+                    continue;
+                const candidateMetadata = candidate.metadata;
+                if (typeof candidateMetadata?.managedByLeanTo !== 'string')
+                    continue;
+                const segment = candidate.roofSegmentId
+                    ? state.nodes[candidate.roofSegmentId]
+                    : undefined;
+                if (!segment || out.some((node) => node.id === segment.id))
+                    continue;
+                out.push(segment, candidate);
+            }
+        }
         return out;
     }));
     // Mitres AND the run's shared eave height come from the same sibling
@@ -133,8 +166,13 @@ const GutterRenderer = ({ node: storeNode }) => {
         effectiveSegment?.roofType,
         mitreNodes,
     ]);
+    const jointMitres = leanToJointMitres(node);
+    const renderedMitres = {
+        left: jointMitres.left || mitres.left,
+        right: jointMitres.right || mitres.right,
+    };
     // biome-ignore lint/correctness/useExhaustiveDependencies: deps deliberately list the build inputs; depending on the whole object would rebuild on unrelated field changes.
-    const geometry = useMemo(() => buildGutterGeometry(node, mitres), [
+    const geometry = useMemo(() => buildGutterGeometry(node, renderedMitres), [
         node.length,
         node.size,
         node.thickness,
@@ -143,11 +181,14 @@ const GutterRenderer = ({ node: storeNode }) => {
         node.endCapRight,
         node.hangerStyle,
         node.hangerSpacing,
+        node.arc?.centerX,
+        node.arc?.centerZ,
+        node.arc?.radius,
         // Value-compare the outlets array so the CSG drills only rebuild
         // when an outlet's offset / diameter changes or one is added.
         JSON.stringify(node.outlets),
-        mitres.left,
-        mitres.right,
+        renderedMitres.left,
+        renderedMitres.right,
     ]);
     useEffect(() => () => geometry.dispose(), [geometry]);
     // Paint surface: explicit material wins, then preset, then the cached
@@ -162,20 +203,35 @@ const GutterRenderer = ({ node: storeNode }) => {
     // visible face. FrontSide is therefore sufficient and DoubleSide is not
     // needed.
     const material = useMemo(() => {
-        if (!textures || (!node.material && !node.materialPreset)) {
+        if (!textures) {
+            return createSurfaceRoleMaterial('roof', colorPreset, THREE.FrontSide, sceneTheme);
+        }
+        const slotMaterial = resolveMaterialRef(node.slots?.gutter, sceneMaterials, shading);
+        if (slotMaterial)
+            return slotMaterial;
+        if (!node.material && !node.materialPreset) {
             return createSurfaceRoleMaterial('roof', colorPreset, THREE.FrontSide, sceneTheme);
         }
         return node.material
             ? createMaterial(node.material, shading)
             : (createMaterialFromPresetRef(node.materialPreset, shading) ?? defaultMaterial);
-    }, [textures, colorPreset, sceneTheme, shading, node.material, node.materialPreset]);
+    }, [
+        textures,
+        colorPreset,
+        sceneTheme,
+        shading,
+        node.slots?.gutter,
+        node.material,
+        node.materialPreset,
+        sceneMaterials,
+    ]);
     // Map gutter-local geometry into the host segment's local frame (where the
     // trim cut prisms live) — same pose the inner mesh group is mounted with
     // (position [x, liveEaveY, z] + yaw). Computed before the early return so the
     // hook order stays stable.
     const liveEaveYForClip = sharedEaveY ?? (effectiveSegment ? computeEaveY(effectiveSegment) : 0);
     const localToSegment = useMemo(() => new THREE.Matrix4().compose(new THREE.Vector3(node.position[0] ?? 0, liveEaveYForClip, node.position[2] ?? 0), new THREE.Quaternion().setFromAxisAngle(new THREE.Vector3(0, 1, 0), node.rotation ?? 0), new THREE.Vector3(1, 1, 1)), [node.position[0], node.position[2], node.rotation, liveEaveYForClip]);
-    const clippedGeometry = useSegmentTrimClippedGeometry(geometry, effectiveSegment, localToSegment);
+    const clippedGeometry = useSegmentTrimClippedGeometry(geometry, segmentForGutterTrimClip(node, effectiveSegment), localToSegment);
     if (!segment || !effectiveSegment)
         return null;
     // `node.position` is segment-local — the placement tool resolves the

package/dist/gutter/trim-clip.d.ts

@@ -0,0 +1,3 @@
+import type { GutterNode, RoofSegmentNode } from '@pascal-app/core';
+export declare function segmentForGutterTrimClip(gutter: Pick<GutterNode, 'arc'>, segment: RoofSegmentNode | undefined): RoofSegmentNode | undefined;
+//# sourceMappingURL=trim-clip.d.ts.map

package/dist/gutter/trim-clip.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"trim-clip.d.ts","sourceRoot":"","sources":["../../src/gutter/trim-clip.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,eAAe,EAAE,MAAM,kBAAkB,CAAA;AAEnE,wBAAgB,wBAAwB,CACtC,MAAM,EAAE,IAAI,CAAC,UAAU,EAAE,KAAK,CAAC,EAC/B,OAAO,EAAE,eAAe,GAAG,SAAS,GACnC,eAAe,GAAG,SAAS,CAI7B"}

package/dist/gutter/trim-clip.js

@@ -0,0 +1,5 @@
+export function segmentForGutterTrimClip(gutter, segment) {
+    // Segment trim cutters are axis-aligned boxes. On a long arc, the back cutter
+    // crosses the gutter twice and removes two unrelated sections of the run.
+    return gutter.arc && segment?.arc ? undefined : segment;
+}

package/dist/hvac-equipment/parametrics.js

@@ -14,9 +14,9 @@ export const hvacEquipmentParametrics = {
         {
             label: 'Cabinet',
             fields: [
-                { key: 'width', kind: 'number', unit: 'm', min: 0.3, max: 2, step: 0.05 },
-                { key: 'depth', kind: 'number', unit: 'm', min: 0.3, max: 2, step: 0.05 },
-                { key: 'height', kind: 'number', unit: 'm', min: 0.4, max: 2.5, step: 0.05 },
+                { key: 'width', kind: 'number', unit: 'm', min: 0.3, max: 1000, step: 0.05 },
+                { key: 'depth', kind: 'number', unit: 'm', min: 0.3, max: 1000, step: 0.05 },
+                { key: 'height', kind: 'number', unit: 'm', min: 0.4, max: 1000, step: 0.05 },
             ],
         },
         {

package/dist/hvac-equipment/tool.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"tool.d.ts","sourceRoot":"","sources":["../../src/hvac-equipment/tool.tsx"],"names":[],"mappings":"AA2BA;;;;;;;GAOG;AACH,QAAA,MAAM,iBAAiB,0CAyGtB,CAAA;AAED,eAAe,iBAAiB,CAAA"}
+{"version":3,"file":"tool.d.ts","sourceRoot":"","sources":["../../src/hvac-equipment/tool.tsx"],"names":[],"mappings":"AA4BA;;;;;;;GAOG;AACH,QAAA,MAAM,iBAAiB,0CAiHtB,CAAA;AAED,eAAe,iBAAiB,CAAA"}

package/dist/hvac-equipment/tool.js

@@ -5,6 +5,7 @@ import { isGridSnapActive, isMagneticSnapActive, triggerSFX, useEditor } from '@
 import { useViewer } from '@pascal-app/viewer';
 import { Html } from '@react-three/drei';
 import { useEffect, useMemo, useRef, useState } from 'react';
+import { subscribeAccessorySnapping } from '../shared/accessory-snapping';
 import { alignDrawPoint, clearDrawAlignment } from '../shared/draw-alignment';
 import { LevelOffsetGroup } from '../shared/level-offset-group';
 import { hvacEquipmentDefinition } from './definition';
@@ -55,9 +56,13 @@ const HvacEquipmentTool = () => {
         // it); `'off'` is the no-snap bypass.
         const resolveAligned = (event) => alignDrawPoint(resolve(event), {
             applySnap: isMagneticSnapActive(),
-            bypass: false,
+            bypass: !isMagneticSnapActive(),
         });
-        const onMove = (event) => setCursor(resolveAligned(event));
+        let lastEvent = null;
+        const onMove = (event) => {
+            lastEvent = event;
+            setCursor(resolveAligned(event));
+        };
         const onClick = (event) => {
             const position = resolveAligned(event);
             const unit = HvacEquipmentNode.parse({
@@ -91,10 +96,15 @@ const HvacEquipmentTool = () => {
             setYaw(yawRef.current);
             triggerSFX('sfx:item-rotate');
         };
+        const unsubscribeSnapping = subscribeAccessorySnapping(() => {
+            if (lastEvent)
+                onMove(lastEvent);
+        });
         emitter.on('grid:move', onMove);
         emitter.on('grid:click', onClick);
         window.addEventListener('keydown', onKeyDown, true);
         return () => {
+            unsubscribeSnapping();
             emitter.off('grid:move', onMove);
             emitter.off('grid:click', onClick);
             window.removeEventListener('keydown', onKeyDown, true);

package/dist/index.d.ts

@@ -16,9 +16,11 @@ import type { Plugin } from '@pascal-app/core';
  * gone — every kind dispatches through the registry.
  */
 export declare const builtinPlugin: Plugin;
+export { applyBlockCommand, type BlockCommand, type BlockCommandResult, type BlockSelection, blockFaceCentroid, blockFaceNormal, } from './block/commands';
+export { blockDefinition } from './block/definition';
 export { boxVentDefinition } from './box-vent';
 export { buildingDefinition } from './building';
-export { bakeCabinetAnimationClip, type CabinetPlacementType, cabinetDefinition, cabinetModuleDefinition, poseCabinetMovingParts, useCabinetPlacementStatus, useCabinetPlacementType, } from './cabinet';
+export { bakeCabinetAnimationClip, CABINET_PLANNING_TOLERANCE, type CabinetPlacementType, type CabinetPlanningIssue, type CabinetPlanningIssueCode, type CabinetPlanningOptions, type CabinetPlanningReport, cabinetDefinition, cabinetModuleDefinition, MIN_PRACTICAL_TOP_CABINET_HEIGHT, poseCabinetMovingParts, useCabinetPlacementStatus, useCabinetPlacementType, validateCabinetRun, } from './cabinet';
 export { ceilingDefinition } from './ceiling';
 export { chimneyDefinition } from './chimney';
 export { columnDefinition } from './column';
@@ -37,6 +39,7 @@ export { guideDefinition } from './guide';
 export { gutterDefinition } from './gutter';
 export { hvacEquipmentDefinition } from './hvac-equipment';
 export { itemDefinition } from './item';
+export { leanToExtensionDefinition } from './lean-to-extension';
 export { levelDefinition } from './level';
 export { linesetDefinition } from './lineset';
 export { liquidLineDefinition, useLiquidLineToolOptions } from './liquid-line';
@@ -45,7 +48,7 @@ export { pipeFittingDefinition } from './pipe-fitting';
 export { pipeSegmentDefinition } from './pipe-segment';
 export { pipeTrapDefinition } from './pipe-trap';
 export { ridgeVentDefinition } from './ridge-vent';
-export { roofDefinition } from './roof';
+export { type RoofFootprintSourceChoice, roofDefinition, useRoofFootprintSource } from './roof';
 export { roofSegmentDefinition } from './roof-segment';
 export { scanDefinition } from './scan';
 export { shelfDefinition } from './shelf';

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"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"}

package/dist/index.js

@@ -1,3 +1,4 @@
+import { blockDefinition } from './block/definition';
 import { boxVentDefinition } from './box-vent';
 import { buildingDefinition } from './building';
 import { cabinetDefinition, cabinetModuleDefinition } from './cabinet';
@@ -19,6 +20,7 @@ import { guideDefinition } from './guide';
 import { gutterDefinition } from './gutter';
 import { hvacEquipmentDefinition } from './hvac-equipment';
 import { itemDefinition } from './item';
+import { leanToExtensionDefinition } from './lean-to-extension';
 import { levelDefinition } from './level';
 import { linesetDefinition } from './lineset';
 import { liquidLineDefinition } from './liquid-line';
@@ -65,8 +67,10 @@ export const builtinPlugin = {
     nodes: [
         // Stage E-complete (full registry path)
         shelfDefinition,
+        blockDefinition,
         spawnDefinition,
         wallDefinition,
+        leanToExtensionDefinition,
         fenceDefinition,
         slabDefinition,
         ceilingDefinition,
@@ -117,9 +121,11 @@ export const builtinPlugin = {
         pipeTrapDefinition,
     ],
 };
+export { applyBlockCommand, blockFaceCentroid, blockFaceNormal, } from './block/commands';
+export { blockDefinition } from './block/definition';
 export { boxVentDefinition } from './box-vent';
 export { buildingDefinition } from './building';
-export { bakeCabinetAnimationClip, cabinetDefinition, cabinetModuleDefinition, poseCabinetMovingParts, useCabinetPlacementStatus, useCabinetPlacementType, } from './cabinet';
+export { bakeCabinetAnimationClip, CABINET_PLANNING_TOLERANCE, cabinetDefinition, cabinetModuleDefinition, MIN_PRACTICAL_TOP_CABINET_HEIGHT, poseCabinetMovingParts, useCabinetPlacementStatus, useCabinetPlacementType, validateCabinetRun, } from './cabinet';
 export { ceilingDefinition } from './ceiling';
 export { chimneyDefinition } from './chimney';
 export { columnDefinition } from './column';
@@ -138,6 +144,7 @@ export { guideDefinition } from './guide';
 export { gutterDefinition } from './gutter';
 export { hvacEquipmentDefinition } from './hvac-equipment';
 export { itemDefinition } from './item';
+export { leanToExtensionDefinition } from './lean-to-extension';
 export { levelDefinition } from './level';
 export { linesetDefinition } from './lineset';
 export { liquidLineDefinition, useLiquidLineToolOptions } from './liquid-line';
@@ -146,7 +153,7 @@ export { pipeFittingDefinition } from './pipe-fitting';
 export { pipeSegmentDefinition } from './pipe-segment';
 export { pipeTrapDefinition } from './pipe-trap';
 export { ridgeVentDefinition } from './ridge-vent';
-export { roofDefinition } from './roof';
+export { roofDefinition, useRoofFootprintSource } from './roof';
 export { roofSegmentDefinition } from './roof-segment';
 export { scanDefinition } from './scan';
 export { shelfDefinition } from './shelf';

package/dist/item/definition.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"definition.d.ts","sourceRoot":"","sources":["../../src/item/definition.ts"],"names":[],"mappings":"AAAA,OAAO,EAKL,KAAK,cAAc,EACpB,MAAM,kBAAkB,CAAA;AAMzB,OAAO,EAAE,QAAQ,EAAE,MAAM,UAAU,CAAA;AA+HnC;;;;;;;;;;;;;;;;;;;;;;;;;;;GA2BG;AACH,eAAO,MAAM,cAAc,EAAE,cAAc,CAAC,OAAO,QAAQ,CAgL1D,CAAA"}
+{"version":3,"file":"definition.d.ts","sourceRoot":"","sources":["../../src/item/definition.ts"],"names":[],"mappings":"AAAA,OAAO,EAKL,KAAK,cAAc,EACpB,MAAM,kBAAkB,CAAA;AAMzB,OAAO,EAAE,QAAQ,EAAE,MAAM,UAAU,CAAA;AA+HnC;;;;;;;;;;;;;;;;;;;;;;;;;;;GA2BG;AACH,eAAO,MAAM,cAAc,EAAE,cAAc,CAAC,OAAO,QAAQ,CAwL1D,CAAA"}

package/dist/item/definition.js

@@ -154,7 +154,7 @@ export const itemDefinition = {
     kind: 'item',
     snapProfile: 'item',
     facingIndicator: true,
-    schemaVersion: 1,
+    schemaVersion: 2,
     schema: ItemNode,
     category: 'furnish',
     surfaceRole: 'furnishing',
@@ -188,6 +188,14 @@ export const itemDefinition = {
     }),
     capabilities: {
         selectable: { hitVolume: 'bbox' },
+        surfaces: {
+            top: {
+                height: (node) => {
+                    const item = node;
+                    return (item.asset.surface?.height ?? item.asset.dimensions[1]) * item.scale[1];
+                },
+            },
+        },
         duplicable: true,
         deletable: true,
         paint: itemPaint,
@@ -204,7 +212,7 @@ export const itemDefinition = {
         // host app strips these via `getHostRefFields(def)` so the
         // descendant re-attaches against the new host geometry at
         // placement time.
-        hostRefFields: ['wallId', 'wallT', 'roofSegmentId', 'roofFace'],
+        hostRefFields: ['wallId', 'wallT', 'roofSegmentId', 'roofFace', 'blockFaceId'],
         // Floor items get lifted by slabs underneath via the generic
         // `<FloorElevationSystem>`. Wall- / ceiling-attached items live in
         // their parent's local frame and skip the lift via `applies`.

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

@@ -1 +1 @@
-{"version":3,"file":"floorplan-move.d.ts","sourceRoot":"","sources":["../../src/item/floorplan-move.ts"],"names":[],"mappings":"AAAA,OAAO,EAKL,KAAK,mBAAmB,EAIxB,KAAK,QAAQ,EAMd,MAAM,kBAAkB,CAAA;AAkJzB,eAAO,MAAM,uBAAuB,EAAE,mBAAmB,CAAC,QAAQ,CA+BjE,CAAA"}
+{"version":3,"file":"floorplan-move.d.ts","sourceRoot":"","sources":["../../src/item/floorplan-move.ts"],"names":[],"mappings":"AAAA,OAAO,EAKL,KAAK,mBAAmB,EAKxB,KAAK,QAAQ,EAMd,MAAM,kBAAkB,CAAA;AAsKzB,eAAO,MAAM,uBAAuB,EAAE,mBAAmB,CAAC,QAAQ,CA+BjE,CAAA"}

package/dist/item/floorplan-move.js

@@ -1,4 +1,4 @@
-import { collectAlignmentAnchors, getRoofWallFaceFrame, getScaledDimensions, movingFootprintAnchors, roofFacePointToSegment, useLiveNodeOverrides, useScene, } from '@pascal-app/core';
+import { collectAlignmentAnchors, getBlockFaceFrame, getRoofWallFaceFrame, getScaledDimensions, movingFootprintAnchors, roofFacePointToSegment, useLiveNodeOverrides, useScene, } from '@pascal-app/core';
 import { applyFloorplanAlignment, isGridSnapActive, isMagneticSnapActive, useEditor, } from '@pascal-app/editor';
 import { createFloorplanCursorResolver } from '../shared/floorplan-cursor';
 import { findClosestWallInPlan, snapLocalXToNeighbors } from '../shared/wall-attach-target';
@@ -64,6 +64,24 @@ function resolveItemPlanTransform(item, nodes, cache = new Map()) {
             };
         }
     }
+    else if (parent?.type === 'block' && item.blockFaceId) {
+        const frame = getBlockFaceFrame(parent.topology, item.blockFaceId);
+        if (frame) {
+            const localX = frame.origin[0] +
+                frame.xAxis[0] * item.position[0] +
+                frame.yAxis[0] * item.position[1] +
+                frame.normal[0] * item.position[2];
+            const localZ = frame.origin[2] +
+                frame.xAxis[2] * item.position[0] +
+                frame.yAxis[2] * item.position[1] +
+                frame.normal[2] * item.position[2];
+            const [offsetX, offsetZ] = rotateVec(localX, localZ, parent.rotation ?? 0);
+            result = {
+                point: [parent.position[0] + offsetX, parent.position[2] + offsetZ],
+                rotation: (parent.rotation ?? 0) - Math.atan2(frame.xAxis[2], frame.xAxis[0]) + localRotation,
+            };
+        }
+    }
     cache.set(item.id, result);
     return result;
 }
@@ -159,6 +177,7 @@ function buildWallItemSession(node, startLevelId) {
                 parentId: hit.wall.id,
                 roofSegmentId: undefined,
                 roofFace: undefined,
+                blockFaceId: undefined,
             };
             useLiveNodeOverrides.getState().set(node.id, lastPatch);
             useScene.getState().markDirty(node.id);

package/dist/item/floorplan.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"floorplan.d.ts","sourceRoot":"","sources":["../../src/item/floorplan.ts"],"names":[],"mappings":"AAAA,OAAO,EAGL,KAAK,iBAAiB,EAEtB,KAAK,eAAe,EAGpB,KAAK,QAAQ,EAId,MAAM,kBAAkB,CAAA;AAgJzB,wBAAgB,6BAA6B,CAC3C,IAAI,EAAE,QAAQ,EACd,GAAG,EAAE,eAAe,GACnB,iBAAiB,GAAG,IAAI,CA+C1B;AAED,wBAAgB,kBAAkB,CAAC,IAAI,EAAE,QAAQ,EAAE,GAAG,EAAE,eAAe,GAAG,iBAAiB,GAAG,IAAI,CAmGjG"}
+{"version":3,"file":"floorplan.d.ts","sourceRoot":"","sources":["../../src/item/floorplan.ts"],"names":[],"mappings":"AAAA,OAAO,EAGL,KAAK,iBAAiB,EAEtB,KAAK,eAAe,EAIpB,KAAK,QAAQ,EAId,MAAM,kBAAkB,CAAA;AAsKzB,wBAAgB,6BAA6B,CAC3C,IAAI,EAAE,QAAQ,EACd,GAAG,EAAE,eAAe,GACnB,iBAAiB,GAAG,IAAI,CA+C1B;AAED,wBAAgB,kBAAkB,CAAC,IAAI,EAAE,QAAQ,EAAE,GAAG,EAAE,eAAe,GAAG,iBAAiB,GAAG,IAAI,CAmGjG"}

package/dist/item/floorplan.js

@@ -1,4 +1,4 @@
-import { getRoofWallFaceFrame, getScaledDimensions, roofFacePointToSegment, useLiveTransforms, } from '@pascal-app/core';
+import { getBlockFaceFrame, getRoofWallFaceFrame, getScaledDimensions, roofFacePointToSegment, useLiveTransforms, } from '@pascal-app/core';
 import { formatLinearMeasurement, readFloorplanMetricNotationOverride } from '@pascal-app/editor';
 // Plan-space rotation convention used by the legacy `rotatePlanVector`
 // in `editor/src/lib/floorplan/geometry.ts`. This is a CLOCKWISE rotation
@@ -94,6 +94,27 @@ function resolveItemTransform(item, ctx, cache = new Map()) {
             };
         }
     }
+    else if (parentNode?.type === 'block' && item.blockFaceId) {
+        const frame = getBlockFaceFrame(parentNode.topology, item.blockFaceId);
+        if (frame) {
+            const localX = frame.origin[0] +
+                frame.xAxis[0] * item.position[0] +
+                frame.yAxis[0] * item.position[1] +
+                frame.normal[0] * item.position[2];
+            const localZ = frame.origin[2] +
+                frame.xAxis[2] * item.position[0] +
+                frame.yAxis[2] * item.position[1] +
+                frame.normal[2] * item.position[2];
+            const hostRotation = parentNode.rotation ?? 0;
+            const [offsetX, offsetZ] = rotateVec(localX, localZ, hostRotation);
+            const faceRotation = -Math.atan2(frame.xAxis[2], frame.xAxis[0]);
+            result = {
+                x: parentNode.position[0] + offsetX,
+                y: parentNode.position[2] + offsetZ,
+                rotation: hostRotation + faceRotation + localRotation,
+            };
+        }
+    }
     else {
         // Level / slab / ceiling parent — item.position is level-local.
         result = {

package/dist/item/move-tool.d.ts

@@ -1,4 +1,31 @@
-import { type ItemNode } from '@pascal-app/core';
+import { type AnyNode, type ItemNode } from '@pascal-app/core';
+import { type PlacementState } from '@pascal-app/editor';
+/**
+ * Phase 5 Stage D — item's registry-driven 3D move affordance.
+ *
+ * Replaces the legacy `MoveItemContent` in `editor/src/components/tools/
+ * item/move-tool.tsx`. Behaviour is identical: it adopts the moving node
+ * (or creates a draft for duplicates flagged `isNew`), runs the placement
+ * coordinator with surface strategies for floor / wall / ceiling / item-
+ * surface, and commits via `useScene.updateNode` on click.
+ *
+ * Registered via `def.affordanceTools.move`. The editor's
+ * `MoveTool` dispatcher picks this up through `getRegistryAffordance
+ * Tool('item', 'move')` before its legacy chain reaches `<MoveItemContent>`
+ * — so the legacy fallback can now go away.
+ *
+ * Closes the 2D ↔ 3D coexistence bugs from last session: when both
+ * paths mounted, the legacy mover's `destroy()` would clobber the 2D
+ * commit; with this tool owning the move, only one path is alive at a
+ * time.
+ *
+ * Placement primitives (`useDraftNode`, `usePlacementCoordinator`,
+ * `PlacementState`) are re-exported from `@pascal-app/editor` — same
+ * hooks the legacy code used. When `ItemTool` (item placement, not
+ * move) also ports to `def.tool`, the primitives can be inlined here
+ * and dropped from editor.
+ */
+export declare function getInitialState(node: ItemNode, parent?: AnyNode | undefined): PlacementState;
 export declare function MoveItemTool({ node }: {
     node: ItemNode;
 }): import("react").JSX.Element;

package/dist/item/move-tool.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"move-tool.d.ts","sourceRoot":"","sources":["../../src/item/move-tool.tsx"],"names":[],"mappings":"AAEA,OAAO,EAAkB,KAAK,QAAQ,EAAY,MAAM,kBAAkB,CAAA;AAuG1E,wBAAgB,YAAY,CAAC,EAAE,IAAI,EAAE,EAAE;IAAE,IAAI,EAAE,QAAQ,CAAA;CAAE,+BAsDxD;AAED,eAAe,YAAY,CAAA"}
+{"version":3,"file":"move-tool.d.ts","sourceRoot":"","sources":["../../src/item/move-tool.tsx"],"names":[],"mappings":"AAEA,OAAO,EAAE,KAAK,OAAO,EAAkB,KAAK,QAAQ,EAAY,MAAM,kBAAkB,CAAA;AACxF,OAAO,EACL,KAAK,cAAc,EAKpB,MAAM,oBAAoB,CAAA;AAG3B;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AACH,wBAAgB,eAAe,CAC7B,IAAI,EAAE,QAAQ,EACd,MAAM,GAAE,OAAO,GAAG,SAEL,GACZ,cAAc,CA4EhB;AAED,wBAAgB,YAAY,CAAC,EAAE,IAAI,EAAE,EAAE;IAAE,IAAI,EAAE,QAAQ,CAAA;CAAE,+BAsDxD;AAED,eAAe,YAAY,CAAA"}

package/dist/item/move-tool.js

@@ -28,8 +28,21 @@ import { Vector3 } from 'three';
  * move) also ports to `def.tool`, the primitives can be inlined here
  * and dropped from editor.
  */
-function getInitialState(node) {
+export function getInitialState(node, parent = node.parentId
+    ? useScene.getState().nodes[node.parentId]
+    : undefined) {
     const attachTo = node.asset.attachTo;
+    if (node.blockFaceId && parent?.type === 'block') {
+        return {
+            surface: 'block-face',
+            wallId: null,
+            roofSegmentId: null,
+            blockId: parent.id,
+            ceilingId: null,
+            surfaceItemId: null,
+            shelfId: null,
+        };
+    }
     if (attachTo === 'wall' || attachTo === 'wall-side') {
         if (node.roofSegmentId) {
             return {
@@ -65,7 +78,6 @@ function getInitialState(node) {
     // handler — which preserves the grab offset — instead of a fresh `enter()`
     // that snaps the item's origin under the cursor. Without this the item
     // teleports the instant it's grabbed.
-    const parent = node.parentId ? useScene.getState().nodes[node.parentId] : undefined;
     if (parent?.type === 'item') {
         return {
             surface: 'item-surface',

package/dist/item/renderer.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"renderer.d.ts","sourceRoot":"","sources":["../../src/item/renderer.tsx"],"names":[],"mappings":"AAEA,OAAO,EAML,KAAK,QAAQ,EAWd,MAAM,kBAAkB,CAAA;AAmZzB,eAAO,MAAM,YAAY,GAAI,qBAAqB;IAAE,IAAI,EAAE,QAAQ,CAAA;CAAE,gCAqDnE,CAAA;AA+CD,eAAO,MAAM,WAAW,GAAI,UAAU;IAAE,IAAI,EAAE,QAAQ,CAAA;CAAE,gCAUvD,CAAA;AAuRD,eAAe,YAAY,CAAA"}
+{"version":3,"file":"renderer.d.ts","sourceRoot":"","sources":["../../src/item/renderer.tsx"],"names":[],"mappings":"AAEA,OAAO,EAML,KAAK,QAAQ,EAYd,MAAM,kBAAkB,CAAA;AA6ZzB,eAAO,MAAM,YAAY,GAAI,qBAAqB;IAAE,IAAI,EAAE,QAAQ,CAAA;CAAE,gCA4DnE,CAAA;AA+CD,eAAO,MAAM,WAAW,GAAI,UAAU;IAAE,IAAI,EAAE,QAAQ,CAAA;CAAE,gCAUvD,CAAA;AA4RD,eAAe,YAAY,CAAA"}

package/dist/item/renderer.js

@@ -1,15 +1,16 @@
 'use client';
 import { jsx as _jsx, jsxs as _jsxs, Fragment as _Fragment } from "react/jsx-runtime";
-import { deriveSlotId, getScaledDimensions, isSlotMaterialName, itemClipRegistry, LIBRARY_MATERIAL_REF_PREFIX, SCENE_MATERIAL_REF_PREFIX, toLibraryMaterialRef, useInteractive, useLiveNodeOverrides, useRegistry, useScene, } from '@pascal-app/core';
+import { deriveSlotId, getScaledDimensions, isSlotMaterialName, itemClipRegistry, LIBRARY_MATERIAL_REF_PREFIX, SCENE_MATERIAL_REF_PREFIX, sceneRegistry, toLibraryMaterialRef, useInteractive, useLiveNodeOverrides, useRegistry, useScene, } from '@pascal-app/core';
 import { configureKtx2Support, createDefaultMaterial, createSurfaceRoleMaterial, ErrorBoundary, glassMaterial, NodeRenderer, resolveCdnUrl, resolveMaterialRef, stampPascalTextureRef, useItemLightPool, useNodeEvents, useViewer, } from '@pascal-app/viewer';
 import { useAnimations } from '@react-three/drei';
 import { Clone } from '@react-three/drei/core/Clone';
 import { useFrame, useLoader, useThree } from '@react-three/fiber';
-import { Suspense, useCallback, useEffect, useLayoutEffect, useMemo, useRef, useState } from 'react';
+import { Suspense, useCallback, useEffect, useLayoutEffect, useMemo, useRef, useState, } from 'react';
 import { MathUtils, Texture } from 'three';
 import { MeshoptDecoder } from 'three/examples/jsm/libs/meshopt_decoder.module.js';
 import { DRACOLoader } from 'three/examples/jsm/loaders/DRACOLoader.js';
 import { positionLocal, smoothstep, time } from 'three/tsl';
+import { BlockFaceHostFrame } from '../shared/block-face-host';
 import { RoofFaceHostFrame } from '../shared/roof-face-host';
 import { cancelItemModelLoad, getUnavailableItemAsset, ItemGLTFLoader } from './model-loader';
 const getAuthoredSlotId = (material) => isSlotMaterialName(material.name) ? deriveSlotId(material.name) : null;
@@ -291,6 +292,9 @@ export const ItemRenderer = ({ node: storeNode }) => {
             setSettled(true);
     }, [roomClearPreview, setSettled]);
     const content = (_jsx("group", { position: node.position, ref: ref, rotation: node.rotation, visible: node.visible, children: roomClearPreview ? (_jsx(ClearPreviewModel, { node: node })) : (_jsxs(_Fragment, { children: [_jsx(ModelWithRetry, { node: node, setSettled: setSettled }, node.asset.src ?? 'no-src'), node.children?.map((childId) => (_jsx(NodeRenderer, { nodeId: childId }, childId)))] })) }));
+    if (node.blockFaceId && node.parentId) {
+        return (_jsx(BlockFaceHostFrame, { blockId: node.parentId, faceId: node.blockFaceId, children: content }));
+    }
     if (!node.roofSegmentId)
         return content;
     return (_jsx(RoofFaceHostFrame, { roofFace: node.roofFace, roofSegmentId: node.roofSegmentId, children: content }));
@@ -354,12 +358,17 @@ const ModelRenderer = ({ node, markSettled }) => {
 };
 const LoadedModelRenderer = ({ gltf: { scene, nodes, animations }, node, markSettled, }) => {
     const ref = useRef(null);
-    const { actions } = useAnimations(animations, ref);
     // Mounting past the suspense gate means the GLB resolved — the item's build
     // work is done (`ItemSystem` may clear its dirty mark, scene-ready may fire).
     useEffect(() => {
+        // Clip presence, not just the effect path: with no animEffect,
+        // <ItemAnimation> still autoplays the first clip, and the node batch must
+        // keep such items out of static batches (shared/node-batch/candidates).
+        const group = sceneRegistry.nodes.get(node.id);
+        if (group)
+            group.userData.itemHasAnimations = animations.length > 0;
         markSettled();
-    }, [markSettled]);
+    }, [markSettled, node.id, animations]);
     const shading = useViewer((s) => s.shading);
     const textures = useViewer((s) => s.textures);
     const colorPreset = useViewer((s) => s.colorPreset);
@@ -442,9 +451,10 @@ const LoadedModelRenderer = ({ gltf: { scene, nodes, animations }, node, markSet
     }, [node.id, animEffect, animations]);
     // useGLTF caches scenes, and Clone shares child geometry/material references.
     // Undo can unmount one item while another clone of the same asset still needs them.
-    return (_jsxs(_Fragment, { children: [_jsx("group", { scale: node.scale, children: _jsx(Clone, { dispose: null, object: scene, position: node.asset.offset, ref: ref, rotation: node.asset.rotation, scale: node.asset.scale || [1, 1, 1], ...handlers }) }), animations.length > 0 && (_jsx(ItemAnimation, { actions: actions, animations: animations, animEffect: animEffect, interactive: interactive ?? null, nodeId: node.id })), lightEffects.map((effect, i) => (_jsx(ItemLightRegistrar, { effect: effect, index: i, interactive: interactive, nodeId: node.id }, i)))] }));
+    return (_jsxs(_Fragment, { children: [_jsx("group", { scale: node.scale, children: _jsx(Clone, { dispose: null, object: scene, position: node.asset.offset, ref: ref, rotation: node.asset.rotation, scale: node.asset.scale || [1, 1, 1], ...handlers }) }), animations.length > 0 && (_jsx(ItemAnimation, { animations: animations, animEffect: animEffect, interactive: interactive ?? null, nodeId: node.id, rootRef: ref })), lightEffects.map((effect, i) => (_jsx(ItemLightRegistrar, { effect: effect, index: i, interactive: interactive, nodeId: node.id }, i)))] }));
 };
-const ItemAnimation = ({ nodeId, animEffect, interactive, actions, animations, }) => {
+const ItemAnimation = ({ nodeId, animEffect, interactive, animations, rootRef, }) => {
+    const { actions } = useAnimations(animations, rootRef);
     const activeClipRef = useRef(null);
     const fadingOutRef = useRef(null);
     // Reactive: derive target clip name — only re-renders when the clip name itself changes

package/dist/item/system.d.ts

@@ -5,6 +5,11 @@
  *    (wall-side z-offset, slab elevation, ceiling mounting).
  *  - **`ItemLightSystem`** — manages light sources attached to items
  *    (lamps, ceiling lights, etc.).
+ *  - **`NodeBatchSystem`** — once nodes stop changing, draws items, columns,
+ *    ceilings, slabs and wall-hosted openings through per-material BatchedMeshes; lit or
+ *    edited nodes draw themselves (see ../shared/node-batch/types.ts).
+ *    Mounted from the item bundle because it must mount exactly once and
+ *    every registered kind's system mounts scene-wide.
  */
 declare const ItemSystems: () => import("react").JSX.Element;
 export default ItemSystems;

package/dist/item/system.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"system.d.ts","sourceRoot":"","sources":["../../src/item/system.tsx"],"names":[],"mappings":"AAIA;;;;;;;GAOG;AACH,QAAA,MAAM,WAAW,mCAOhB,CAAA;AAED,eAAe,WAAW,CAAA"}
+{"version":3,"file":"system.d.ts","sourceRoot":"","sources":["../../src/item/system.tsx"],"names":[],"mappings":"AAKA;;;;;;;;;;;;GAYG;AACH,QAAA,MAAM,WAAW,mCAQhB,CAAA;AAED,eAAe,WAAW,CAAA"}

package/dist/item/system.js

@@ -1,6 +1,7 @@
 'use client';
 import { jsx as _jsx, Fragment as _Fragment, jsxs as _jsxs } from "react/jsx-runtime";
 import { ItemLightSystem, ItemSystem } from '@pascal-app/viewer';
+import { NodeBatchSystem } from '../shared/node-batch/system';
 /**
  * Registry-driven item system bundle.
  *
@@ -8,8 +9,13 @@ import { ItemLightSystem, ItemSystem } from '@pascal-app/viewer';
  *    (wall-side z-offset, slab elevation, ceiling mounting).
  *  - **`ItemLightSystem`** — manages light sources attached to items
  *    (lamps, ceiling lights, etc.).
+ *  - **`NodeBatchSystem`** — once nodes stop changing, draws items, columns,
+ *    ceilings, slabs and wall-hosted openings through per-material BatchedMeshes; lit or
+ *    edited nodes draw themselves (see ../shared/node-batch/types.ts).
+ *    Mounted from the item bundle because it must mount exactly once and
+ *    every registered kind's system mounts scene-wide.
  */
 const ItemSystems = () => {
-    return (_jsxs(_Fragment, { children: [_jsx(ItemSystem, {}), _jsx(ItemLightSystem, {})] }));
+    return (_jsxs(_Fragment, { children: [_jsx(ItemSystem, {}), _jsx(ItemLightSystem, {}), _jsx(NodeBatchSystem, {})] }));
 };
 export default ItemSystems;