@pascal-app/nodes 1.0.3 → 1.0.5

package/dist/shared/finish-script-model.js

@@ -0,0 +1,32 @@
+'use client';
+import { jsx as _jsx } from "react/jsx-runtime";
+import { artifactUrl, scriptedSize, } from '@pascal-app/core';
+import { useMemo } from 'react';
+import { ScriptedModel } from '../item/renderer.js';
+/**
+ * A finish its script built (a room's floor, a wall's face), drawn as an authored object's artifact
+ * is (its slots, the render shading), in the frame it was built in. It belongs to its host: no
+ * pointer events of its own, so a click on it reaches the floor or the wall beneath.
+ */
+export function FinishScriptModel({ ownerId, parentId, script, }) {
+    const view = useMemo(() => {
+        const [width, height, depth] = scriptedSize(script.manifest);
+        return {
+            id: ownerId,
+            type: 'item',
+            parentId,
+            metadata: {},
+            source: script,
+            scale: [1, 1, 1],
+            asset: {
+                src: artifactUrl(script.artifact),
+                dimensions: [width, height, depth],
+                offset: [0, 0, 0],
+                rotation: [0, 0, 0],
+                scale: [1, 1, 1],
+            },
+        };
+    }, [ownerId, parentId, script]);
+    return _jsx(ScriptedModel, { setSettled: settleNothing, view: view });
+}
+const settleNothing = () => { };

package/dist/shared/fitting-deletion-cleanup.js

@@ -1,6 +1,6 @@
 import { Euler, Matrix4, Quaternion, Vector3 } from 'three';
-import { getDuctFittingPorts } from '../duct-fitting/ports';
-import { getPipeFittingPorts } from '../pipe-fitting/ports';
+import { getDuctFittingPorts } from '../duct-fitting/ports.js';
+import { getPipeFittingPorts } from '../pipe-fitting/ports.js';
 const MATE_TOLERANCE_SQ = 0.05 ** 2;
 const DIRECTION_TOLERANCE = 1e-4;
 function distanceSquared(a, b) {

package/dist/shared/fitting-endpoint-reaim.js

@@ -1,6 +1,6 @@
-import { getDuctFittingPorts } from '../duct-fitting/ports';
-import { getPipeFittingPorts } from '../pipe-fitting/ports';
-import { planElbowRealign, planPipeElbowRealign, planTeeBranchRealign } from './auto-fitting';
+import { getDuctFittingPorts } from '../duct-fitting/ports.js';
+import { getPipeFittingPorts } from '../pipe-fitting/ports.js';
+import { planElbowRealign, planPipeElbowRealign, planTeeBranchRealign } from './auto-fitting.js';
 /** Distance (m) under which a run end counts as sitting on a fitting collar —
  *  matches core's port-coincidence epsilon. */
 const COINCIDENT_EPS_M = 0.05;

package/dist/shared/fitting-surface-support.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"fitting-surface-support.d.ts","sourceRoot":"","sources":["../../src/shared/fitting-surface-support.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,eAAe,EAAE,MAAM,kBAAkB,CAAA;AAKxE,KAAK,KAAK,GAAG,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,CAAA;AAErC,wBAAgB,2BAA2B,KAIvC,MAAM,eAAe,GAAG,eAAe,EACvC,UAAU,KAAK,EACf,UAAU,KAAK,EACf,cAAc,KAAK,EACnB,gBAAe,KAAiB,KAC/B,KAAK,CAkCT"}
+{"version":3,"file":"fitting-surface-support.d.ts","sourceRoot":"","sources":["../../src/shared/fitting-surface-support.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,eAAe,EAAE,MAAM,kBAAkB,CAAA;AAKxE,KAAK,KAAK,GAAG,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,CAAA;AAErC,wBAAgB,2BAA2B,WAIjC,eAAe,GAAG,eAAe,YAC7B,KAAK,YACL,KAAK,gBACD,KAAK,kBACJ,KAAK,KACnB,KAAK,CAkCT"}

package/dist/shared/fitting-surface-support.js

@@ -1,6 +1,6 @@
 import { Mesh, Vector3 } from 'three';
-import { buildDuctFittingGeometry } from '../duct-fitting/geometry';
-import { buildPipeFittingGeometry } from '../pipe-fitting/geometry';
+import { buildDuctFittingGeometry } from '../duct-fitting/geometry.js';
+import { buildPipeFittingGeometry } from '../pipe-fitting/geometry.js';
 export function createFittingSurfaceSupport() {
     let key = '';
     let vertices = [];

package/dist/shared/fitting-tool-options.js

@@ -1,5 +1,5 @@
 import { useEditor } from '@pascal-app/editor';
-import { reducerOutletDiameter } from './reducer-size';
+import { reducerOutletDiameter } from './reducer-size.js';
 const label = (value) => ({
     rect: 'Rectangular',
     pvc: 'PVC',

package/dist/shared/floor-placement.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"floor-placement.d.ts","sourceRoot":"","sources":["../../src/shared/floor-placement.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,KAAK,OAAO,EAEZ,KAAK,SAAS,EAEd,KAAK,SAAS,EACd,gBAAgB,EAGjB,MAAM,kBAAkB,CAAA;AAGzB,eAAO,MAAM,qCAAqC,OAAO,CAAA;AAEzD,MAAM,MAAM,+BAA+B,GAAG,SAAS,GAAG,SAAS,CAAC,OAAO,CAAC,CAAA;AAE5E,wBAAgB,qBAAqB,CAAC,KAAK,EAAE,+BAA+B,GAAG,OAAO,CAErF;AAED,KAAK,2BAA2B,GAAG;IACjC,IAAI,EAAE,OAAO,CAAA;IACb,IAAI,EAAE,MAAM,CAAA;IACZ,IAAI,EAAE,MAAM,CAAA;IACZ,QAAQ,EAAE,MAAM,CAAA;IAChB,UAAU,EAAE,UAAU,CAAC,OAAO,gBAAgB,CAAC,CAAC,CAAC,CAAC,CAAC,YAAY,CAAC,CAAA;IAChE,aAAa,CAAC,EAAE,OAAO,CAAA;IACvB,kBAAkB,CAAC,EAAE,OAAO,CAAA;IAC5B,UAAU,CAAC,EAAE,OAAO,CAAA;IACpB,SAAS,CAAC,EAAE,MAAM,CAAA;CACnB,CAAA;AAID,wBAAgB,4BAA4B,CAC1C,OAAO,EAAE,MAAM,EACf,KAAK,EAAE,+BAA+B,EACtC,QAAQ,EAAE,MAAM,EAChB,UAAU,UAAQ,GACjB,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,CAmB1B;AAED,wBAAgB,4BAA4B,CAAC,EAC3C,IAAI,EACJ,IAAI,EACJ,IAAI,EACJ,QAAQ,EACR,UAAU,EACV,aAAoB,EACpB,kBAAyB,EACzB,UAAkB,EAClB,SAAa,GACd,EAAE,2BAA2B;cAoBD,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC;;EAGpD;AAgBD,wBAAgB,8BAA8B,CAAC,KAAK,EAAE,+BAA+B,QAUpF;AAED,wBAAgB,6BAA6B,CAC3C,OAAO,EAAE,CAAC,KAAK,EAAE,+BAA+B,KAAK,IAAI,cAS1D;AAED,wBAAgB,mCAAmC,CACjD,aAAa,EAAE,CAAC,KAAK,EAAE,+BAA+B,KAAK,IAAI,cAShE"}
+{"version":3,"file":"floor-placement.d.ts","sourceRoot":"","sources":["../../src/shared/floor-placement.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,KAAK,OAAO,EAEZ,KAAK,SAAS,EAEd,KAAK,SAAS,EACd,gBAAgB,EAGjB,MAAM,kBAAkB,CAAA;AAGzB,eAAO,MAAM,qCAAqC,OAAO,CAAA;AAEzD,MAAM,MAAM,+BAA+B,GAAG,SAAS,GAAG,SAAS,CAAC,OAAO,CAAC,CAAA;AAE5E,wBAAgB,qBAAqB,CAAC,KAAK,EAAE,+BAA+B,GAAG,OAAO,CAErF;AAED,KAAK,2BAA2B,GAAG;IACjC,IAAI,EAAE,OAAO,CAAA;IACb,IAAI,EAAE,MAAM,CAAA;IACZ,IAAI,EAAE,MAAM,CAAA;IACZ,QAAQ,EAAE,MAAM,CAAA;IAChB,UAAU,EAAE,UAAU,CAAC,OAAO,gBAAgB,CAAC,CAAC,CAAC,CAAC,CAAC,YAAY,CAAC,CAAA;IAChE,aAAa,CAAC,EAAE,OAAO,CAAA;IACvB,kBAAkB,CAAC,EAAE,OAAO,CAAA;IAC5B,UAAU,CAAC,EAAE,OAAO,CAAA;IACpB,SAAS,CAAC,EAAE,MAAM,CAAA;CACnB,CAAA;AAID,wBAAgB,4BAA4B,CAC1C,OAAO,EAAE,MAAM,EACf,KAAK,EAAE,+BAA+B,EACtC,QAAQ,EAAE,MAAM,EAChB,UAAU,UAAQ,GACjB,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,CAmB1B;AAED,wBAAgB,4BAA4B,CAAC,EAC3C,IAAI,EACJ,IAAI,EACJ,IAAI,EACJ,QAAQ,EACR,UAAU,EACV,aAAoB,EACpB,kBAAyB,EACzB,UAAkB,EAClB,SAAa,GACd,EAAE,2BAA2B;IAoB1B,QAAQ,EAAiB,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC;IACjD,MAAM;EAET;AAgBD,wBAAgB,8BAA8B,CAAC,KAAK,EAAE,+BAA+B,QAUpF;AAED,wBAAgB,6BAA6B,CAC3C,OAAO,EAAE,CAAC,KAAK,EAAE,+BAA+B,KAAK,IAAI,cAS1D;AAED,wBAAgB,mCAAmC,CACjD,aAAa,EAAE,CAAC,KAAK,EAAE,+BAA+B,KAAK,IAAI,cAShE"}

package/dist/shared/floorplan-cursor.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"floorplan-cursor.d.ts","sourceRoot":"","sources":["../../src/shared/floorplan-cursor.ts"],"names":[],"mappings":"AAAA,OAAO,EAEL,KAAK,yBAAyB,EAC9B,KAAK,WAAW,EAEjB,MAAM,oBAAoB,CAAA;AAE3B,KAAK,8BAA8B,GAAG;IACpC,IAAI,CAAC,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,MAAM,CAAA;CACjC,CAAA;AAED,wBAAgB,6BAA6B,CAAC,IAAI,EAAE;IAClD,QAAQ,EAAE,SAAS,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;IACnC,QAAQ,CAAC,EAAE,OAAO,CAAA;IAClB,IAAI,CAAC,EAAE,yBAAyB,CAAA;CACjC,IAMG,WAAW,SAAS,CAAC,MAAM,EAAE,MAAM,CAAC,EACpC,UAAS,8BAAmC,KAC3C,WAAW,CAWf"}
+{"version":3,"file":"floorplan-cursor.d.ts","sourceRoot":"","sources":["../../src/shared/floorplan-cursor.ts"],"names":[],"mappings":"AAAA,OAAO,EAEL,KAAK,yBAAyB,EAC9B,KAAK,WAAW,EAEjB,MAAM,oBAAoB,CAAA;AAE3B,KAAK,8BAA8B,GAAG;IACpC,IAAI,CAAC,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,MAAM,CAAA;CACjC,CAAA;AAED,wBAAgB,6BAA6B,CAAC,IAAI,EAAE;IAClD,QAAQ,EAAE,SAAS,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;IACnC,QAAQ,CAAC,EAAE,OAAO,CAAA;IAClB,IAAI,CAAC,EAAE,yBAAyB,CAAA;CACjC,eAMc,SAAS,CAAC,MAAM,EAAE,MAAM,CAAC,YAC3B,8BAA8B,KACtC,WAAW,CAWf"}

package/dist/shared/hosted-resize.d.ts

@@ -1,7 +1,8 @@
-import { type AnyNode, type AnyNodeId, type HandleDescriptor, type SceneApi } from '@pascal-app/core';
+import { type AnyNode, type AnyNodeId, type HandleDescriptor, type SceneApi, type SurfaceProvider } from '@pascal-app/core';
 export type HostedEditPolicy = {
     host: (node: AnyNode) => boolean;
     child: (node: AnyNode) => boolean;
+    provider?: SurfaceProvider;
 };
 type Nodes = Record<AnyNodeId, AnyNode>;
 export type HostedUpdate = readonly [AnyNodeId, Partial<AnyNode>];

package/dist/shared/hosted-resize.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"hosted-resize.d.ts","sourceRoot":"","sources":["../../src/shared/hosted-resize.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,KAAK,OAAO,EACZ,KAAK,SAAS,EAGd,KAAK,gBAAgB,EAGrB,KAAK,QAAQ,EAEd,MAAM,kBAAkB,CAAA;AAGzB,MAAM,MAAM,gBAAgB,GAAG;IAC7B,IAAI,EAAE,CAAC,IAAI,EAAE,OAAO,KAAK,OAAO,CAAA;IAChC,KAAK,EAAE,CAAC,IAAI,EAAE,OAAO,KAAK,OAAO,CAAA;CAClC,CAAA;AAED,KAAK,KAAK,GAAG,MAAM,CAAC,SAAS,EAAE,OAAO,CAAC,CAAA;AACvC,MAAM,MAAM,YAAY,GAAG,SAAS,CAAC,SAAS,EAAE,OAAO,CAAC,OAAO,CAAC,CAAC,CAAA;AASjE,wBAAgB,kBAAkB,CAChC,MAAM,EAAE,KAAK,EACb,KAAK,EAAE,KAAK,EACZ,MAAM,EAAE,gBAAgB,GACvB,YAAY,EAAE,GAAG,IAAI,CA4EvB;AAED,wBAAgB,cAAc,CAC5B,QAAQ,EAAE,QAAQ,EAClB,KAAK,EAAE,CAAC,MAAM,EAAE,QAAQ,KAAK,IAAI,EACjC,MAAM,EAAE,gBAAgB,GACvB,YAAY,EAAE,GAAG,IAAI,CA8BvB;AAED,wBAAgB,kBAAkB,CAAC,CAAC,SAAS,OAAO,EAClD,UAAU,EAAE,gBAAgB,CAAC,CAAC,CAAC,EAC/B,MAAM,EAAE,gBAAgB,GACvB,gBAAgB,CAAC,CAAC,CAAC,CA6DrB"}
+{"version":3,"file":"hosted-resize.d.ts","sourceRoot":"","sources":["../../src/shared/hosted-resize.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,KAAK,OAAO,EACZ,KAAK,SAAS,EAGd,KAAK,gBAAgB,EAGrB,KAAK,QAAQ,EACb,KAAK,eAAe,EAErB,MAAM,kBAAkB,CAAA;AAUzB,MAAM,MAAM,gBAAgB,GAAG;IAC7B,IAAI,EAAE,CAAC,IAAI,EAAE,OAAO,KAAK,OAAO,CAAA;IAChC,KAAK,EAAE,CAAC,IAAI,EAAE,OAAO,KAAK,OAAO,CAAA;IACjC,QAAQ,CAAC,EAAE,eAAe,CAAA;CAC3B,CAAA;AAED,KAAK,KAAK,GAAG,MAAM,CAAC,SAAS,EAAE,OAAO,CAAC,CAAA;AACvC,MAAM,MAAM,YAAY,GAAG,SAAS,CAAC,SAAS,EAAE,OAAO,CAAC,OAAO,CAAC,CAAC,CAAA;AASjE,wBAAgB,kBAAkB,CAChC,MAAM,EAAE,KAAK,EACb,KAAK,EAAE,KAAK,EACZ,MAAM,EAAE,gBAAgB,GACvB,YAAY,EAAE,GAAG,IAAI,CAsFvB;AAED,wBAAgB,cAAc,CAC5B,QAAQ,EAAE,QAAQ,EAClB,KAAK,EAAE,CAAC,MAAM,EAAE,QAAQ,KAAK,IAAI,EACjC,MAAM,EAAE,gBAAgB,GACvB,YAAY,EAAE,GAAG,IAAI,CA8BvB;AAED,wBAAgB,kBAAkB,CAAC,CAAC,SAAS,OAAO,EAClD,UAAU,EAAE,gBAAgB,CAAC,CAAC,CAAC,EAC/B,MAAM,EAAE,gBAAgB,GACvB,gBAAgB,CAAC,CAAC,CAAC,CA6DrB"}

package/dist/shared/hosted-resize.js

@@ -1,5 +1,5 @@
 import { getScaledDimensions, getSurfaceProvider, nodeRegistry, surfaceRegionContainsFootprint, } from '@pascal-app/core';
-import { boundsOf, boxCorners, frame, transformPoint } from '@pascal-app/core/procedural-items';
+import { boundsOf, boxCorners, evaluateRecipe, frame, isProceduralItem, transformPoint, } from '@pascal-app/core/procedural-items';
 function surfaceScene(nodes) {
     return {
         nodes: () => nodes,
@@ -19,7 +19,7 @@ export function hostedChildUpdates(before, after, policy) {
         const nextHost = after[host.id];
         if (!nextHost || !policy.host(nextHost))
             return null;
-        const provider = getSurfaceProvider(host);
+        const provider = policy.provider ?? getSurfaceProvider(host);
         const nextSurfaces = provider.surfaces?.(nextHost, { scene: surfaceScene(after) }) ?? [];
         if (JSON.stringify(provider.surfaces?.(host, { scene: surfaceScene(before) })) ===
             JSON.stringify(nextSurfaces))
@@ -27,9 +27,17 @@ export function hostedChildUpdates(before, after, policy) {
         for (const child of children) {
             if (!child || !('position' in child) || !('rotation' in child))
                 continue;
+            const recipeBounds = isProceduralItem(child)
+                ? evaluateRecipe(child.recipe, child.parameters)
+                : null;
             const bounds = child.type === 'item'
                 ? { size: getScaledDimensions(child), center: undefined }
-                : nodeRegistry.get(child.type)?.capabilities.dragBounds?.(child, before);
+                : recipeBounds
+                    ? {
+                        size: recipeBounds.dimensions,
+                        center: recipeBounds.min.map((value, index) => (value + recipeBounds.max[index]) / 2),
+                    }
+                    : nodeRegistry.get(child.type)?.capabilities.dragBounds?.(child, before);
             if (!bounds)
                 continue;
             const center = bounds.center ?? [0, bounds.size[1] / 2, 0];

package/dist/shared/item-interaction-actions.d.ts

@@ -0,0 +1,6 @@
+/**
+ * The light switch for a single selected item or procedural item. Play/Stop
+ * comes from the action menu's `capabilities.mechanism` button.
+ */
+export default function ItemInteractionActions(): import("react").JSX.Element | null;
+//# sourceMappingURL=item-interaction-actions.d.ts.map

package/dist/shared/item-interaction-actions.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"item-interaction-actions.d.ts","sourceRoot":"","sources":["../../src/shared/item-interaction-actions.tsx"],"names":[],"mappings":"AAOA;;;GAGG;AACH,MAAM,CAAC,OAAO,UAAU,sBAAsB,uCAsB7C"}

package/dist/shared/item-interaction-actions.js

@@ -0,0 +1,27 @@
+'use client';
+import { jsx as _jsx } from "react/jsx-runtime";
+import { nodeMechanism, useInteractive, useScene } from '@pascal-app/core';
+import { ActionMenuButton } from '@pascal-app/editor';
+import { useViewer } from '@pascal-app/viewer';
+import { Lightbulb, LightbulbOff } from 'lucide-react';
+import { itemHasLights, itemLightsOn, toggleItemLights } from './item-interactions.js';
+/**
+ * The light switch for a single selected item or procedural item. Play/Stop
+ * comes from the action menu's `capabilities.mechanism` button.
+ */
+export default function ItemInteractionActions() {
+    const selected = useViewer((s) => s.selection.selectedIds);
+    const node = useScene((s) => selected.length === 1 ? s.nodes[selected[0]] : undefined);
+    const hasLights = itemHasLights(node);
+    const lit = useInteractive((s) => (node && hasLights ? itemLightsOn(node, s) : false));
+    if (!(node && hasLights))
+        return null;
+    return (_jsx(ActionMenuButton
+    // E runs the mechanism when there is one, and only otherwise the light.
+    , { 
+        // E runs the mechanism when there is one, and only otherwise the light.
+        keys: nodeMechanism(node) ? undefined : ['E'], label: lit ? 'Turn light off' : 'Turn light on', onClick: (event) => {
+            event.stopPropagation();
+            toggleItemLights(node);
+        }, pressed: lit, children: lit ? _jsx(Lightbulb, { className: "h-4 w-4" }) : _jsx(LightbulbOff, { className: "h-4 w-4" }) }));
+}

package/dist/shared/item-interactions.d.ts

@@ -0,0 +1,9 @@
+import { type AnyNode, type InteractiveState, type MechanismCapability } from '@pascal-app/core';
+/** A catalog item's animation toggles: every toggle but the light switch. */
+export declare const itemMechanism: MechanismCapability;
+/** A procedural item's moving parts, all driven through its motion timeline. */
+export declare const proceduralMechanism: MechanismCapability;
+export declare function itemHasLights(node: AnyNode | undefined): boolean;
+export declare function itemLightsOn(node: AnyNode, state: InteractiveState): boolean;
+export declare function toggleItemLights(node: AnyNode): void;
+//# sourceMappingURL=item-interactions.d.ts.map

package/dist/shared/item-interactions.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"item-interactions.d.ts","sourceRoot":"","sources":["../../src/shared/item-interactions.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,KAAK,OAAO,EAEZ,KAAK,gBAAgB,EACrB,KAAK,mBAAmB,EAEzB,MAAM,kBAAkB,CAAA;AA4BzB,6EAA6E;AAC7E,eAAO,MAAM,aAAa,EAAE,mBAY3B,CAAA;AAED,gFAAgF;AAChF,eAAO,MAAM,mBAAmB,EAAE,mBAKjC,CAAA;AAED,wBAAgB,aAAa,CAAC,IAAI,EAAE,OAAO,GAAG,SAAS,GAAG,OAAO,CAKhE;AAED,wBAAgB,YAAY,CAAC,IAAI,EAAE,OAAO,EAAE,KAAK,EAAE,gBAAgB,GAAG,OAAO,CAQ5E;AAED,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,OAAO,QAW7C"}

package/dist/shared/item-interactions.js

@@ -0,0 +1,74 @@
+import { useInteractive, } from '@pascal-app/core';
+import { operableParts } from '@pascal-app/core/procedural-items';
+// Catalog light and animation effects both read the first toggle, so on a lamp
+// that toggle is the light switch and any further toggles are the mechanisms.
+function catalogToggles(interactive) {
+    const toggles = interactive.controls.flatMap((control, index) => control.kind === 'toggle' ? [index] : []);
+    const light = interactive.effects.some((effect) => effect.kind === 'light')
+        ? (toggles[0] ?? -1)
+        : -1;
+    const mechanisms = interactive.effects.some((effect) => effect.kind === 'animation')
+        ? toggles.filter((index) => index !== light)
+        : [];
+    return { light, mechanisms };
+}
+function motionPartIds(node) {
+    return node.type === 'procedural-item' ? operableParts(node.recipe).map((part) => part.id) : [];
+}
+function mechanismToggles(node) {
+    return node.type === 'item' && node.asset.interactive
+        ? catalogToggles(node.asset.interactive).mechanisms
+        : [];
+}
+/** A catalog item's animation toggles: every toggle but the light switch. */
+export const itemMechanism = {
+    has: (node) => mechanismToggles(node).length > 0,
+    isOn: (node, state) => {
+        const values = state.items[node.id]?.controlValues;
+        return mechanismToggles(node).some((index) => Boolean(values?.[index]));
+    },
+    set: (node, on) => {
+        if (node.type !== 'item' || !node.asset.interactive)
+            return;
+        const state = useInteractive.getState();
+        state.initItem(node.id, node.asset.interactive);
+        for (const index of mechanismToggles(node))
+            state.setControlValue(node.id, index, on);
+    },
+};
+/** A procedural item's moving parts, all driven through its motion timeline. */
+export const proceduralMechanism = {
+    has: (node) => motionPartIds(node).length > 0,
+    isOn: (node, state) => motionPartIds(node).some((partId) => state.procedural[node.id]?.parts[partId]),
+    set: (node, on) => useInteractive.getState().setProceduralParts(node.id, motionPartIds(node), on),
+};
+export function itemHasLights(node) {
+    if (node?.type === 'procedural-item')
+        return node.recipe.parts.some((part) => part.light);
+    if (node?.type === 'item' && node.asset.interactive)
+        return catalogToggles(node.asset.interactive).light >= 0;
+    return false;
+}
+export function itemLightsOn(node, state) {
+    if (node.type === 'procedural-item')
+        return state.procedural[node.id]?.lightsOn ?? state.lampDefault;
+    if (node.type === 'item' && node.asset.interactive) {
+        const { light } = catalogToggles(node.asset.interactive);
+        return light >= 0 && Boolean(state.items[node.id]?.controlValues[light]);
+    }
+    return false;
+}
+export function toggleItemLights(node) {
+    const state = useInteractive.getState();
+    if (node.type === 'procedural-item') {
+        state.toggleProceduralLights(node.id);
+        return;
+    }
+    if (node.type !== 'item' || !node.asset.interactive)
+        return;
+    const { light } = catalogToggles(node.asset.interactive);
+    if (light < 0)
+        return;
+    state.initItem(node.id, node.asset.interactive);
+    state.setControlValue(node.id, light, !itemLightsOn(node, useInteractive.getState()));
+}

package/dist/shared/item-light-placement.d.ts

@@ -0,0 +1,2 @@
+export declare function canRegisterItemLight(metadata: Record<string, unknown> | undefined): boolean;
+//# sourceMappingURL=item-light-placement.d.ts.map

package/dist/shared/item-light-placement.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"item-light-placement.d.ts","sourceRoot":"","sources":["../../src/shared/item-light-placement.ts"],"names":[],"mappings":"AAAA,wBAAgB,oBAAoB,CAAC,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,SAAS,GAAG,OAAO,CAE3F"}

package/dist/shared/item-light-placement.js

@@ -0,0 +1,3 @@
+export function canRegisterItemLight(metadata) {
+    return metadata?.isNew !== true;
+}

package/dist/shared/lean-to-post-omissions.d.ts

@@ -1,5 +1,5 @@
 import type { AnyNode, AnyNodeId, ColumnNode, LeanToExtensionNode } from '@pascal-app/core';
-import type { LeanToPostSide } from '../lean-to-extension/assembly';
+import type { LeanToPostSide } from '../lean-to-extension/assembly.js';
 export declare function isLeanToPostOmitted(leanTo: LeanToExtensionNode, side: LeanToPostSide, index: number): boolean;
 export declare function leanToPostOmissionPatchesOnDelete(column: ColumnNode, nodes: Record<AnyNodeId, AnyNode>): Array<{
     id: AnyNodeId;

package/dist/shared/lean-to-post-omissions.js

@@ -1,4 +1,4 @@
-import { resolveLeanToLayout } from '../lean-to-extension/layout';
+import { resolveLeanToLayout } from '../lean-to-extension/layout.js';
 function managedPostSlot(column) {
     const metadata = column.metadata;
     if (!metadata || typeof metadata !== 'object' || Array.isArray(metadata))

package/dist/shared/mep-ghost.js

@@ -4,11 +4,11 @@ import { EDITOR_LAYER } from '@pascal-app/editor';
 import { disposeObject3DResources } from '@pascal-app/viewer';
 import { useEffect, useMemo } from 'react';
 import { Mesh, MeshBasicMaterial } from 'three';
-import { buildDuctFittingGeometry } from '../duct-fitting/geometry';
-import { buildDuctSegmentGeometry } from '../duct-segment/geometry';
-import { buildPipeFittingGeometry } from '../pipe-fitting/geometry';
-import { buildPipeSegmentGeometry } from '../pipe-segment/geometry';
-import { INVALID_GHOST_COLOR, VALID_GHOST_COLOR } from './ghost-materials';
+import { buildDuctFittingGeometry } from '../duct-fitting/geometry.js';
+import { buildDuctSegmentGeometry } from '../duct-segment/geometry.js';
+import { buildPipeFittingGeometry } from '../pipe-fitting/geometry.js';
+import { buildPipeSegmentGeometry } from '../pipe-segment/geometry.js';
+import { INVALID_GHOST_COLOR, VALID_GHOST_COLOR } from './ghost-materials.js';
 /** Indigo-400 — the shared MEP preview accent (matches the draw-tool ghost). */
 export const GHOST_COLOR = '#818cf8';
 export const GHOST_OPACITY = 0.55;

package/dist/shared/move-roof-tool.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"move-roof-tool.d.ts","sourceRoot":"","sources":["../../src/shared/move-roof-tool.tsx"],"names":[],"mappings":"AAAA,OAAO,EASL,KAAK,QAAQ,EACb,KAAK,eAAe,EAGpB,KAAK,SAAS,EACd,KAAK,gBAAgB,EAMtB,MAAM,kBAAkB,CAAA;AAwDzB,eAAO,MAAM,YAAY,EAAE,KAAK,CAAC,EAAE,CAAC;IAClC,IAAI,EAAE,QAAQ,GAAG,eAAe,GAAG,SAAS,GAAG,gBAAgB,CAAA;CAChE,CAofA,CAAA;AAED,eAAe,YAAY,CAAA"}
+{"version":3,"file":"move-roof-tool.d.ts","sourceRoot":"","sources":["../../src/shared/move-roof-tool.tsx"],"names":[],"mappings":"AAAA,OAAO,EASL,KAAK,QAAQ,EACb,KAAK,eAAe,EAIpB,KAAK,SAAS,EACd,KAAK,gBAAgB,EAQtB,MAAM,kBAAkB,CAAA;AA2DzB,eAAO,MAAM,YAAY,EAAE,KAAK,CAAC,EAAE,CAAC;IAClC,IAAI,EAAE,QAAQ,GAAG,eAAe,GAAG,SAAS,GAAG,gBAAgB,CAAA;CAChE,CAsmBA,CAAA;eAEc,YAAY"}

package/dist/shared/move-roof-tool.js

@@ -1,9 +1,11 @@
 import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
-import { collectAlignmentAnchors, emitter, movingAlignmentAnchors, nodeRegistry, resolveAlignment, resolveSupportSlabPatch, sceneRegistry, useLiveNodeOverrides, useLiveTransforms, useScene, } from '@pascal-app/core';
-import { CursorSphere, commitFreshPlacementSubtree, consumePlacementDragRelease, DragBoundingBox, getFloorStackPreviewPosition, isMagneticSnapActive, resolvePlanarCursorPosition, snapFenceDraftPoint, stripPlacementMetadataFlags, triggerSFX, useAlignmentGuides, useEditor, useFreshPlacementVisibility, } from '@pascal-app/editor';
+import { collectAlignmentAnchors, emitter, movingAlignmentAnchors, nodeRegistry, resolveAlignment, resolveStairSurfaceSnap, resolveSupportSlabPatch, sceneRegistry, seatRoofs, useLiveNodeOverrides, useLiveTransforms, useScene, } from '@pascal-app/core';
+import { CursorSphere, commitFreshPlacementSubtree, consumePlacementDragRelease, DragBoundingBox, getFloorStackPreviewPosition, isMagneticSnapActive, isTypingTarget, resolvePlanarCursorPosition, selectPlacedNode, stripPlacementMetadataFlags, triggerSFX, useAlignmentGuides, useEditor, useFreshPlacementVisibility, } from '@pascal-app/editor';
 import { useViewer } from '@pascal-app/viewer';
 import { useCallback, useEffect, useRef, useState } from 'react';
 import * as THREE from 'three';
+import { snapFenceDraftPoint } from '../fence/drafting.js';
+import { clearStairMovePreview, publishStairMovePreview } from '../stair/surface-move-preview.js';
 /** Figma-style alignment-snap threshold (meters), matching the other tools. */
 const ALIGNMENT_THRESHOLD_M = 0.08;
 function disableRaycastDuringDrag(root) {
@@ -30,7 +32,9 @@ function resolvePreviewRotationY(node, localRotation) {
     }
     return localRotation;
 }
-export const MoveRoofTool = ({ node: movingNode }) => {
+export const MoveRoofTool = ({ node: sourceNode }) => {
+    const currentNode = useScene((state) => sourceNode.type === 'stair' ? state.nodes[sourceNode.id] : undefined);
+    const movingNode = sourceNode.type === 'stair' && currentNode?.type === 'stair' ? currentNode : sourceNode;
     const { isFreshPlacement, previewVisible: cursorVisible, revealFreshPlacement, useAbsoluteCursorPlacement, } = useFreshPlacementVisibility({
         node: movingNode,
         enabled: movingNode.type === 'roof' || movingNode.type === 'stair',
@@ -89,10 +93,21 @@ export const MoveRoofTool = ({ node: movingNode }) => {
         // resetting the mesh position (it resets on dirty) and from triggering
         // expensive merged-mesh CSG rebuilds on every frame.
         let wasCommitted = false;
-        let wasCancelled = false;
         let hasMoved = false;
+        let surfaceSnap = null;
+        const flightId = movingNode.type === 'stair'
+            ? movingNode.children
+                .map((id) => useScene.getState().nodes[id])
+                .find((child) => child?.type === 'stair-segment' && child.segmentType === 'stair')?.id
+            : undefined;
+        const clearSurfacePreview = () => {
+            if (movingNode.type !== 'stair')
+                return;
+            clearStairMovePreview(movingNode.id, flightId);
+        };
         // Track pending rotation — no store updates during drag
         let pendingRotation = movingNode.rotation;
+        let freeRotation = pendingRotation;
         let lastLocalPosition = [
             movingNode.position[0],
             movingNode.position[1],
@@ -220,7 +235,7 @@ export const MoveRoofTool = ({ node: movingNode }) => {
             hasMoved = true;
             revealFreshPlacement();
             const y = event.position[1];
-            const roofBypassSnap = event.nativeEvent?.shiftKey === true;
+            const roofBypassSnap = event.nativeEvent?.altKey === true;
             const snappedLocal = snapFenceDraftPoint({
                 point: [event.localPosition[0], event.localPosition[2]],
                 walls: levelWalls,
@@ -239,17 +254,44 @@ export const MoveRoofTool = ({ node: movingNode }) => {
             dragAnchorRef.current = resolved.anchor;
             let [localX, localZ] = resolved.point;
             if (alignTopLevel) {
-                const aligned = alignLocalPoint(localX, localZ, event.nativeEvent?.altKey === true || event.nativeEvent?.shiftKey === true);
+                const aligned = alignLocalPoint(localX, localZ, event.nativeEvent?.altKey === true);
                 localX = aligned[0];
                 localZ = aligned[1];
             }
-            if (event.nativeEvent?.shiftKey !== true &&
+            if (event.nativeEvent?.altKey !== true &&
                 previousGridPosRef.current &&
                 (localX !== previousGridPosRef.current[0] || localZ !== previousGridPosRef.current[1])) {
                 triggerSFX('sfx:grid-snap');
             }
             previousGridPosRef.current = [localX, localZ];
             lastLocalPosition = [localX, movingNode.position[1], localZ];
+            const wasSurfaceSnapped = surfaceSnap !== null;
+            if (movingNode.type === 'stair' &&
+                event.nativeEvent?.altKey !== true &&
+                isMagneticSnapActive()) {
+                const sceneNodes = useScene.getState().nodes;
+                const segment = movingNode.children
+                    .map((id) => sceneNodes[id])
+                    .find((child) => child?.type === 'stair-segment' && child.segmentType === 'stair');
+                const baseElevation = getPreviewPosition(lastLocalPosition)[1];
+                surfaceSnap = resolveStairSurfaceSnap({ ...movingNode, rotation: freeRotation }, sceneNodes, lastLocalPosition, segment?.length ?? 3, baseElevation, useScene.getState().installedPlugins);
+                if (surfaceSnap) {
+                    if (!wasSurfaceSnapped)
+                        freeRotation = pendingRotation;
+                    lastLocalPosition = surfaceSnap.position;
+                    pendingRotation = surfaceSnap.rotation;
+                    setPreviewRotation(surfaceSnap.rotation);
+                }
+            }
+            else
+                surfaceSnap = null;
+            if (wasSurfaceSnapped && !surfaceSnap) {
+                pendingRotation = freeRotation;
+                setPreviewRotation(resolvePreviewRotationY(movingNode, freeRotation));
+            }
+            if (movingNode.type === 'stair') {
+                publishStairMovePreview(movingNode.id, flightId, lastLocalPosition, pendingRotation, surfaceSnap);
+            }
             const previewPosition = getPreviewPosition(lastLocalPosition);
             setCursorWorldPos(isFloorPlaced ? previewPosition : localPositionToToolLocal(lastLocalPosition));
             // Directly update the Three.js mesh — no store update during drag
@@ -262,6 +304,8 @@ export const MoveRoofTool = ({ node: movingNode }) => {
                     mesh.position.x = localX;
                     mesh.position.z = localZ;
                 }
+                if (movingNode.type === 'stair')
+                    mesh.rotation.y = resolvePreviewRotationY(movingNode, pendingRotation);
             }
             // Publish canonical position so the 2D floorplan can track the drag.
             // Floor-placed parents (stairs) stay in their committed local frame;
@@ -289,14 +333,22 @@ export const MoveRoofTool = ({ node: movingNode }) => {
                 position,
                 rotation: pendingRotation,
             };
-            const supportPatch = isFloorPlaced
-                ? resolveSupportSlabPatch(effectiveNode, {
-                    ...useScene.getState().nodes,
-                    [movingNode.id]: effectiveNode,
-                })
-                : {};
+            const supportPatch = surfaceSnap
+                ? {}
+                : isFloorPlaced
+                    ? resolveSupportSlabPatch(effectiveNode, {
+                        ...useScene.getState().nodes,
+                        [movingNode.id]: effectiveNode,
+                    })
+                    : {};
             let committedId = movingNode.id;
             if (isNew) {
+                if (surfaceSnap && flightId)
+                    useScene.getState().updateNode(flightId, {
+                        height: surfaceSnap.totalRise,
+                        length: surfaceSnap.length,
+                        stepCount: surfaceSnap.stepCount,
+                    });
                 committedId =
                     commitFreshPlacementSubtree(movingNode.id, {
                         position,
@@ -304,23 +356,76 @@ export const MoveRoofTool = ({ node: movingNode }) => {
                         metadata: committedMeta,
                         visible: true,
                         ...supportPatch,
+                        ...(surfaceSnap
+                            ? {
+                                totalRise: surfaceSnap.totalRise,
+                                stepCount: surfaceSnap.stepCount,
+                                slabOpeningMode: 'none',
+                                destinationSurfaceId: surfaceSnap.surfaceId,
+                                railingMode: 'none',
+                            }
+                            : movingNode.type === 'stair' && movingNode.destinationSurfaceId
+                                ? { destinationSurfaceId: undefined }
+                                : {}),
                     }) ?? committedId;
             }
             else {
                 // The store still holds the original values (we didn't update during drag).
                 // Resume temporal and apply the final state as a single undoable step.
-                useScene.temporal.getState().resume();
-                useScene.getState().updateNode(movingNode.id, {
+                const patch = {
                     position,
                     rotation: pendingRotation,
                     metadata: committedMeta,
                     ...supportPatch,
-                });
+                };
+                useScene.temporal.getState().resume();
+                if (movingNode.type === 'roof' || movingNode.type === 'roof-segment') {
+                    // Moved or turned onto the walls that carry it, a roof goes to the level above them.
+                    const scene = useScene.getState();
+                    scene.applyNodeChanges(seatRoofs(scene.nodes, { update: [{ id: movingNode.id, data: patch }] }).changes);
+                }
+                else {
+                    useScene.getState().updateNodes([
+                        {
+                            id: movingNode.id,
+                            data: {
+                                ...(surfaceSnap
+                                    ? {
+                                        totalRise: surfaceSnap.totalRise,
+                                        stepCount: surfaceSnap.stepCount,
+                                        slabOpeningMode: 'none',
+                                        destinationSurfaceId: surfaceSnap.surfaceId,
+                                        railingMode: 'none',
+                                    }
+                                    : movingNode.type === 'stair' && movingNode.destinationSurfaceId
+                                        ? { destinationSurfaceId: undefined }
+                                        : {}),
+                                position,
+                                rotation: pendingRotation,
+                                metadata: committedMeta,
+                                ...supportPatch,
+                            },
+                        },
+                        ...(surfaceSnap && flightId
+                            ? [
+                                {
+                                    id: flightId,
+                                    data: {
+                                        height: surfaceSnap.totalRise,
+                                        length: surfaceSnap.length,
+                                        stepCount: surfaceSnap.stepCount,
+                                    },
+                                },
+                            ]
+                            : []),
+                    ]);
+                }
                 useScene.temporal.getState().pause();
             }
             triggerSFX('sfx:item-place');
-            useViewer.getState().setSelection({ selectedIds: [committedId] });
+            selectPlacedNode(committedId);
             clearHostedPreview();
+            clearSurfacePreview();
             useLiveTransforms.getState().clear(movingNode.id);
             useEditor.getState().setMovingNodeOrigin('3d');
             exitMoveMode();
@@ -332,8 +437,8 @@ export const MoveRoofTool = ({ node: movingNode }) => {
             onGridClick({ nativeEvent: event });
         };
         const onCancel = () => {
-            wasCancelled = true;
             clearHostedPreview();
+            clearSurfacePreview();
             useLiveTransforms.getState().clear(movingNode.id);
             useAlignmentGuides.getState().clear();
             if (isNew) {
@@ -350,9 +455,8 @@ export const MoveRoofTool = ({ node: movingNode }) => {
             exitMoveMode();
         };
         const onKeyDown = (event) => {
-            if (event.target instanceof HTMLInputElement || event.target instanceof HTMLTextAreaElement) {
+            if (isTypingTarget(event.target))
                 return;
-            }
             const ROTATION_STEP = Math.PI / 4;
             let rotationDelta = 0;
             if (event.key === 'r' || event.key === 'R')
@@ -363,7 +467,10 @@ export const MoveRoofTool = ({ node: movingNode }) => {
                 event.preventDefault();
                 triggerSFX('sfx:item-rotate');
                 pendingRotation += rotationDelta;
+                freeRotation += rotationDelta;
                 setPreviewRotation(resolvePreviewRotationY(movingNode, pendingRotation));
+                if (movingNode.type === 'stair')
+                    publishStairMovePreview(movingNode.id, flightId, lastLocalPosition, pendingRotation, surfaceSnap);
                 // Directly update the Three.js mesh — no store update during drag
                 const mesh = sceneRegistry.nodes.get(movingNode.id);
                 if (mesh) {
@@ -397,23 +504,10 @@ export const MoveRoofTool = ({ node: movingNode }) => {
             restoreRaycasts();
             // Clear ephemeral live transform + any alignment guides
             clearHostedPreview();
+            clearSurfacePreview();
             useLiveTransforms.getState().clear(movingNode.id);
             useAlignmentGuides.getState().clear();
-            // Skip restore when the 2D floor-plan overlay claimed teardown
-            // ownership — same contract `FloorplanRegistryMoveOverlay` uses to
-            // decide whether to revert its own apply() writes. Without this,
-            // a stair / roof move committed in the floor plan unmounts this
-            // tool with `wasCommitted === false` (this tool's own grid-click
-            // never fired), and the restore below stomps the just-committed
-            // position back to the snapshot.
-            const finalisedBy2D = useEditor.getState().movingNodeOrigin === '2d';
-            if (!(wasCommitted || wasCancelled || isNew || finalisedBy2D)) {
-                useScene.getState().updateNode(movingNode.id, {
-                    position: original.position,
-                    rotation: original.rotation,
-                    metadata: original.metadata,
-                });
-            }
+            // Drag motion only changes previews. Cleanup never rewrites a committed pose.
             useScene.temporal.getState().resume();
             emitter.off('grid:move', onGridMove);
             emitter.off('grid:click', onGridClick);

package/dist/shared/node-batch/batchable.d.ts

@@ -0,0 +1,12 @@
+import { type AnyNode, type BatchableConfig } from '@pascal-app/core';
+/** One packed allocation per node mesh, for geometry each rebuild replaces. */
+export declare const nodeMeshBatchKey: (node: AnyNode, meshIndex: number) => string;
+export declare const columnBatchable: BatchableConfig;
+/** Ceiling undersides and slab bodies are trimmed by walls and rebuilt in place. */
+export declare const surfaceBatchable: BatchableConfig;
+export declare const itemBatchable: BatchableConfig;
+export declare const doorBatchable: BatchableConfig;
+export declare const windowBatchable: BatchableConfig;
+/** Imported meshes and blocks build their own geometry per node, rebuilt in place. */
+export declare const perNodeGeometryBatchable: BatchableConfig;
+//# sourceMappingURL=batchable.d.ts.map

package/dist/shared/node-batch/batchable.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"batchable.d.ts","sourceRoot":"","sources":["../../../src/shared/node-batch/batchable.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,KAAK,OAAO,EACZ,KAAK,eAAe,EAGrB,MAAM,kBAAkB,CAAA;AAEzB,+EAA+E;AAC/E,eAAO,MAAM,gBAAgB,SAAU,OAAO,aAAa,MAAM,WAA8B,CAAA;AAE/F,eAAO,MAAM,eAAe,EAAE,eAI7B,CAAA;AAED,oFAAoF;AACpF,eAAO,MAAM,gBAAgB,EAAE,eAI9B,CAAA;AAED,eAAO,MAAM,aAAa,EAAE,eAgB3B,CAAA;AAMD,eAAO,MAAM,aAAa,EAAE,eAI3B,CAAA;AAED,eAAO,MAAM,eAAe,EAAE,eAI7B,CAAA;AAED,sFAAsF;AACtF,eAAO,MAAM,wBAAwB,EAAE,eAGtC,CAAA"}