@pascal-app/nodes 1.0.1 → 1.0.4

package/dist/shared/draft-axis-guides.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"draft-axis-guides.d.ts","sourceRoot":"","sources":["../../src/shared/draft-axis-guides.tsx"],"names":[],"mappings":"AAAA,OAAO,EAML,KAAK,aAAa,EACnB,MAAM,oBAAoB,CAAA;AA6B3B,MAAM,MAAM,eAAe,GAAG;IAC5B,EAAE,EAAE,MAAM,CAAA;IACV,KAAK,EAAE,MAAM,CAAA;IACb,QAAQ,EAAE,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,CAAA;IAClC,GAAG,EAAE;QACH,MAAM,EAAE,aAAa,CAAA;QACrB,MAAM,EAAE,MAAM,CAAA;QACd,UAAU,EAAE,MAAM,CAAA;QAClB,QAAQ,EAAE,MAAM,CAAA;QAChB,CAAC,EAAE,MAAM,CAAA;KACV,CAAA;CACF,CAAA;AAED,MAAM,MAAM,mBAAmB,GAAG;IAChC,MAAM,EAAE,aAAa,CAAA;IACrB,SAAS,EAAE,aAAa,GAAG,IAAI,CAAA;IAC/B,CAAC,EAAE,MAAM,CAAA;IACT,UAAU,EAAE,eAAe,GAAG,IAAI,CAAA;CACnC,GAAG,IAAI,CAAA;AAeR,wBAAgB,wBAAwB,CACtC,KAAK,EAAE,aAAa,EACpB,GAAG,EAAE,aAAa,EAClB,CAAC,EAAE,MAAM,GACR,eAAe,GAAG,IAAI,CAyCxB;AAED,wBAAgB,eAAe,CAAC,EAC9B,KAAK,EACL,UAAU,EACV,gBAAgB,GACjB,EAAE;IACD,KAAK,EAAE,mBAAmB,CAAA;IAC1B,UAAU,EAAE,MAAM,CAAA;IAClB,gBAAgB,EAAE,MAAM,CAAA;CACzB,sCA2CA;AAoBD,wBAAgB,aAAa,CAAC,EAAE,GAAG,EAAE,KAAK,EAAE,EAAE;IAAE,GAAG,EAAE,eAAe,CAAC,KAAK,CAAC,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAE,+BAkC3F;AAED,wBAAgB,qBAAqB,CAAC,EACpC,KAAK,EACL,KAAK,EACL,QAAQ,EACR,WAAW,GACZ,EAAE;IACD,KAAK,EAAE,MAAM,CAAA;IACb,KAAK,EAAE,MAAM,CAAA;IACb,QAAQ,EAAE,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,CAAA;IAClC,WAAW,EAAE,MAAM,CAAA;CACpB,+BAmBA"}
+{"version":3,"file":"draft-axis-guides.d.ts","sourceRoot":"","sources":["../../src/shared/draft-axis-guides.tsx"],"names":[],"mappings":"AAAA,OAAO,EAOL,KAAK,aAAa,EACnB,MAAM,oBAAoB,CAAA;AA4B3B,MAAM,MAAM,eAAe,GAAG;IAC5B,EAAE,EAAE,MAAM,CAAA;IACV,KAAK,EAAE,MAAM,CAAA;IACb,QAAQ,EAAE,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,CAAA;IAClC,GAAG,EAAE;QACH,MAAM,EAAE,aAAa,CAAA;QACrB,MAAM,EAAE,MAAM,CAAA;QACd,UAAU,EAAE,MAAM,CAAA;QAClB,QAAQ,EAAE,MAAM,CAAA;QAChB,CAAC,EAAE,MAAM,CAAA;KACV,CAAA;CACF,CAAA;AAED,MAAM,MAAM,mBAAmB,GAAG;IAChC,MAAM,EAAE,aAAa,CAAA;IACrB,SAAS,EAAE,aAAa,GAAG,IAAI,CAAA;IAC/B,CAAC,EAAE,MAAM,CAAA;IACT,UAAU,EAAE,eAAe,GAAG,IAAI,CAAA;CACnC,GAAG,IAAI,CAAA;AAeR,wBAAgB,wBAAwB,CACtC,KAAK,EAAE,aAAa,EACpB,GAAG,EAAE,aAAa,EAClB,CAAC,EAAE,MAAM,GACR,eAAe,GAAG,IAAI,CAyCxB;AAED,wBAAgB,eAAe,CAAC,EAC9B,KAAK,EACL,UAAU,EACV,gBAAgB,GACjB,EAAE;IACD,KAAK,EAAE,mBAAmB,CAAA;IAC1B,UAAU,EAAE,MAAM,CAAA;IAClB,gBAAgB,EAAE,MAAM,CAAA;CACzB,sCA2CA;AAoBD,wBAAgB,aAAa,CAAC,EAAE,GAAG,EAAE,KAAK,EAAE,EAAE;IAAE,GAAG,EAAE,eAAe,CAAC,KAAK,CAAC,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAE,+BAkC3F"}

package/dist/shared/draft-axis-guides.js

@@ -1,6 +1,5 @@
 import { jsx as _jsx, jsxs as _jsxs, Fragment as _Fragment } from "react/jsx-runtime";
-import { EDITOR_LAYER, formatAngleRadians, getAngleArcToSegmentReference, getAngleToSegmentReference, } from '@pascal-app/editor';
-import { Html } from '@react-three/drei';
+import { DraftMeasurementLabel, EDITOR_LAYER, formatAngleRadians, getAngleArcToSegmentReference, getAngleToSegmentReference, } from '@pascal-app/editor';
 import { useMemo } from 'react';
 import { BufferGeometry, Vector3 } from 'three';
 /**
@@ -99,9 +98,3 @@ export function DraftAngleArc({ arc, color }) {
     }, [arc]);
     return (_jsx("line", { frustumCulled: false, geometry: geometry, layers: EDITOR_LAYER, renderOrder: 2, children: _jsx("lineBasicNodeMaterial", { color: color, depthTest: false, depthWrite: false, linewidth: 2, opacity: 0.95, transparent: true }) }));
 }
-export function DraftMeasurementLabel({ color, label, position, shadowColor, }) {
-    return (_jsx(Html, { center: true, position: position, style: { pointerEvents: 'none', userSelect: 'none' }, zIndexRange: [100, 0], children: _jsx("div", { className: "whitespace-nowrap font-bold font-mono text-[15px]", style: {
-                color,
-                textShadow: `-1.5px -1.5px 0 ${shadowColor}, 1.5px -1.5px 0 ${shadowColor}, -1.5px 1.5px 0 ${shadowColor}, 1.5px 1.5px 0 ${shadowColor}, 0 0 4px ${shadowColor}, 0 0 4px ${shadowColor}`,
-            }, children: label }) }));
-}

package/dist/shared/duct-body-paint.d.ts

@@ -1,6 +1,2 @@
-import type { SlotDeclaration } from '@pascal-app/core';
-export declare const DUCT_BODY_SLOT_ID = "body";
-export declare const DUCT_BODY_SLOT_DEFAULT = "#ffffff";
-export declare function ductBodySlots(): SlotDeclaration[];
 export declare const ductBodyPaint: import("@pascal-app/core").PaintCapability;
 //# sourceMappingURL=duct-body-paint.d.ts.map

package/dist/shared/duct-body-paint.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"duct-body-paint.d.ts","sourceRoot":"","sources":["../../src/shared/duct-body-paint.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,kBAAkB,CAAA;AAGvD,eAAO,MAAM,iBAAiB,SAAS,CAAA;AACvC,eAAO,MAAM,sBAAsB,YAAY,CAAA;AAE/C,wBAAgB,aAAa,IAAI,eAAe,EAAE,CAEjD;AAED,eAAO,MAAM,aAAa,4CAMxB,CAAA"}
+{"version":3,"file":"duct-body-paint.d.ts","sourceRoot":"","sources":["../../src/shared/duct-body-paint.ts"],"names":[],"mappings":"AAGA,eAAO,MAAM,aAAa,4CAMxB,CAAA"}

package/dist/shared/duct-body-paint.js

@@ -1,9 +1,5 @@
+import { DUCT_BODY_SLOT_ID } from '@pascal-app/core';
 import { createSlotPaintCapability, previewGeometrySlot } from './slot-paint';
-export const DUCT_BODY_SLOT_ID = 'body';
-export const DUCT_BODY_SLOT_DEFAULT = '#ffffff';
-export function ductBodySlots() {
-    return [{ slotId: DUCT_BODY_SLOT_ID, label: 'Body', default: DUCT_BODY_SLOT_DEFAULT }];
-}
 export const ductBodyPaint = createSlotPaintCapability({
     resolveRole: ({ hitObject }) => {
         const slotId = hitObject?.userData?.slotId;

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

@@ -0,0 +1,12 @@
+import { type AnyNode, type AnyNodeId, type HandleDescriptor, type SceneApi } from '@pascal-app/core';
+export type HostedEditPolicy = {
+    host: (node: AnyNode) => boolean;
+    child: (node: AnyNode) => boolean;
+};
+type Nodes = Record<AnyNodeId, AnyNode>;
+export type HostedUpdate = readonly [AnyNodeId, Partial<AnyNode>];
+export declare function hostedChildUpdates(before: Nodes, after: Nodes, policy: HostedEditPolicy): HostedUpdate[] | null;
+export declare function planHostedEdit(sceneApi: SceneApi, apply: (staged: SceneApi) => void, policy: HostedEditPolicy): HostedUpdate[] | null;
+export declare function withHostedChildren<N extends AnyNode>(descriptor: HandleDescriptor<N>, policy: HostedEditPolicy): HandleDescriptor<N>;
+export {};
+//# sourceMappingURL=hosted-resize.d.ts.map

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

@@ -0,0 +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"}

package/dist/shared/hosted-resize.js

@@ -0,0 +1,166 @@
+import { getScaledDimensions, getSurfaceProvider, nodeRegistry, surfaceRegionContainsFootprint, } from '@pascal-app/core';
+import { boundsOf, boxCorners, frame, transformPoint } from '@pascal-app/core/procedural-items';
+function surfaceScene(nodes) {
+    return {
+        nodes: () => nodes,
+        get: (id) => nodes[id],
+    };
+}
+export function hostedChildUpdates(before, after, policy) {
+    const updates = [];
+    for (const host of Object.values(before)) {
+        if (!policy.host(host))
+            continue;
+        const children = (host.children ?? [])
+            .map((id) => before[id])
+            .filter((child) => child?.parentId === host.id && policy.child(child));
+        if (!children.length)
+            continue;
+        const nextHost = after[host.id];
+        if (!nextHost || !policy.host(nextHost))
+            return null;
+        const provider = getSurfaceProvider(host);
+        const nextSurfaces = provider.surfaces?.(nextHost, { scene: surfaceScene(after) }) ?? [];
+        if (JSON.stringify(provider.surfaces?.(host, { scene: surfaceScene(before) })) ===
+            JSON.stringify(nextSurfaces))
+            continue;
+        for (const child of children) {
+            if (!child || !('position' in child) || !('rotation' in child))
+                continue;
+            const bounds = child.type === 'item'
+                ? { size: getScaledDimensions(child), center: undefined }
+                : nodeRegistry.get(child.type)?.capabilities.dragBounds?.(child, before);
+            if (!bounds)
+                continue;
+            const center = bounds.center ?? [0, bounds.size[1] / 2, 0];
+            const localBounds = {
+                min: center.map((v, i) => v - bounds.size[i] / 2),
+                max: center.map((v, i) => v + bounds.size[i] / 2),
+            };
+            const position = child.position;
+            const rotation = (typeof child.rotation === 'number' ? [0, child.rotation, 0] : child.rotation);
+            const projected = boundsOf(boxCorners(localBounds.min, localBounds.max).map((p) => transformPoint(frame(position, rotation), p)));
+            const hit = {
+                point: [
+                    (projected.min[0] + projected.max[0]) / 2,
+                    projected.min[1],
+                    (projected.min[2] + projected.max[2]) / 2,
+                ],
+                normalWorldY: 1,
+            };
+            const previousSurface = provider.resolveHit(host, hit, { scene: surfaceScene(before) });
+            if (!previousSurface || Math.abs(previousSurface.position[1] - projected.min[1]) > 1e-5)
+                continue;
+            const nextSurface = nextSurfaces.find((surface) => surface.id === previousSurface.id);
+            if (!nextSurface)
+                return null;
+            const nextPosition = [
+                position[0],
+                position[1] + nextSurface.position[1] - previousSurface.position[1],
+                position[2],
+            ];
+            const surfaceLocal = [
+                nextPosition[0] - nextSurface.position[0],
+                nextPosition[1] - nextSurface.position[1],
+                nextPosition[2] - nextSurface.position[2],
+            ];
+            if (!surfaceRegionContainsFootprint(nextSurface.region, surfaceLocal, bounds.size, rotation, localBounds))
+                return null;
+            if (Math.abs(nextPosition[1] - position[1]) > 1e-8)
+                updates.push([child.id, { position: nextPosition }]);
+        }
+    }
+    return updates;
+}
+export function planHostedEdit(sceneApi, apply, policy) {
+    const before = sceneApi.nodes();
+    const after = { ...before };
+    const updates = new Map();
+    let supported = true;
+    const staged = {
+        ...sceneApi,
+        ...surfaceScene(after),
+        update(id, data) {
+            if (!after[id])
+                return;
+            after[id] = { ...after[id], ...data };
+            updates.set(id, { ...updates.get(id), ...data });
+        },
+        upsert(node) {
+            supported = false;
+            return node.id;
+        },
+        delete() {
+            supported = false;
+        },
+        markDirty() { },
+        pauseHistory() { },
+        resumeHistory() { },
+    };
+    apply(staged);
+    if (!supported)
+        return null;
+    const children = hostedChildUpdates(before, after, policy);
+    if (!children)
+        return null;
+    for (const [id, data] of children)
+        updates.set(id, data);
+    return [...updates];
+}
+export function withHostedChildren(descriptor, policy) {
+    if (descriptor.kind === 'radial-resize')
+        return {
+            ...descriptor,
+            apply(node, value, scene) {
+                const patch = descriptor.apply(node, value, scene);
+                if (planHostedEdit(scene, (staged) => staged.update(node.id, patch), policy))
+                    return patch;
+                return Object.fromEntries(Object.keys(patch).map((key) => [key, node[key]]));
+            },
+        };
+    if (descriptor.kind !== 'linear-resize')
+        return descriptor;
+    const plan = (node, patch, sceneApi, modifiers) => planHostedEdit(sceneApi, (staged) => {
+        if (descriptor.commit)
+            descriptor.commit(node, patch, staged, modifiers);
+        else
+            staged.update(descriptor.overrideTarget?.(node, staged) ?? node.id, patch);
+    }, policy);
+    const hasHostedChildren = (scene) => Object.values(scene?.nodes() ?? {}).some((node) => policy.host(node) &&
+        (node.children ?? []).some((id) => {
+            const child = scene.get(id);
+            return child && policy.child(child);
+        }));
+    return {
+        ...descriptor,
+        apply(node, value, sceneApi, modifiers) {
+            const patch = descriptor.apply(node, value, sceneApi, modifiers);
+            if (!hasHostedChildren(sceneApi) || plan(node, patch, sceneApi, modifiers))
+                return patch;
+            const target = sceneApi.get(descriptor.overrideTarget?.(node, sceneApi) ?? node.id) ?? node;
+            return Object.fromEntries(Object.keys(patch).map((key) => [key, target[key]]));
+        },
+        previewOverrides(node, value, sceneApi, modifiers) {
+            if (!hasHostedChildren(sceneApi))
+                return descriptor.previewOverrides?.(node, value, sceneApi, modifiers) ?? [];
+            const patch = descriptor.apply(node, value, sceneApi, modifiers);
+            return plan(node, patch, sceneApi, modifiers) ?? [];
+        },
+        commit(node, patch, sceneApi, modifiers) {
+            if (!hasHostedChildren(sceneApi)) {
+                if (descriptor.commit)
+                    descriptor.commit(node, patch, sceneApi, modifiers);
+                else
+                    sceneApi.update(descriptor.overrideTarget?.(node, sceneApi) ?? node.id, patch);
+                return;
+            }
+            const updates = plan(node, patch, sceneApi, modifiers);
+            if (!updates)
+                return;
+            for (const [id, data] of updates) {
+                sceneApi.update(id, data);
+                sceneApi.markDirty(id);
+            }
+        },
+    };
+}

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';
+/**
+ * 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/move-roof-tool.js

@@ -1,9 +1,10 @@
 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 { CursorSphere, commitFreshPlacementSubtree, consumePlacementDragRelease, DragBoundingBox, getFloorStackPreviewPosition, isMagneticSnapActive, resolvePlanarCursorPosition, 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';
 /** Figma-style alignment-snap threshold (meters), matching the other tools. */
 const ALIGNMENT_THRESHOLD_M = 0.08;
 function disableRaycastDuringDrag(root) {

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,GAAI,MAAM,OAAO,EAAE,WAAW,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;AAID,eAAO,MAAM,aAAa,EAAE,eAG3B,CAAA;AAED,eAAO,MAAM,eAAe,EAAE,eAG7B,CAAA;AAED,sFAAsF;AACtF,eAAO,MAAM,wBAAwB,EAAE,eAGtC,CAAA"}

package/dist/shared/node-batch/batchable.js

@@ -0,0 +1,41 @@
+import { itemClipRegistry, useInteractive, } from '@pascal-app/core';
+/** One packed allocation per node mesh, for geometry each rebuild replaces. */
+export const nodeMeshBatchKey = (node, meshIndex) => `${node.id}:${meshIndex}`;
+export const columnBatchable = {
+    scope: 'level',
+    excluded: (node) => itemClipRegistry.has(node.id),
+    settled: (data) => !data.scriptedColumn || data.itemModelSettled === true,
+};
+/** Ceiling undersides and slab bodies are trimmed by walls and rebuilt in place. */
+export const surfaceBatchable = {
+    scope: 'level',
+    batchKey: nodeMeshBatchKey,
+    waitsForWalls: true,
+};
+export const itemBatchable = {
+    scope: 'level',
+    // An animation effect or a registered clip means the item animates its own
+    // subtree (a fan's spin) — per-mesh transforms move under a static batch
+    // instance. Light effects drive separate light objects, so a lit porch or
+    // lamp still batches.
+    excluded: (node) => Boolean(node.asset?.interactive?.effects?.some((effect) => effect.kind === 'animation')) || itemClipRegistry.has(node.id),
+    // Items hold their dirty mark until the GLB settles. A GLB that ships clips
+    // autoplays its first one even without an interactive effect
+    // (ItemAnimation's no-effect fallback) — static batching would freeze it.
+    settled: (userData) => userData.itemModelSettled === true && userData.itemHasAnimations !== true,
+};
+// Mid-swing openings rebuild per tick off their animation record; the
+// completion dirty mark re-joins them at the settled pose.
+export const doorBatchable = {
+    scope: 'wall',
+    excluded: (node) => node.id in useInteractive.getState().doorAnimations,
+};
+export const windowBatchable = {
+    scope: 'wall',
+    excluded: (node) => node.id in useInteractive.getState().windowAnimations,
+};
+/** Imported meshes and blocks build their own geometry per node, rebuilt in place. */
+export const perNodeGeometryBatchable = {
+    scope: 'level',
+    batchKey: nodeMeshBatchKey,
+};

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

@@ -1,11 +1,13 @@
+import { type AnyNode, type BatchableConfig } from '@pascal-app/core';
 import type { BatchCandidate } from './types';
 /**
- * Candidate collection + source hide/reveal for node batching. Counterpart of
- * the wall batch's `toCandidate` (../../wall/wall-batch-system.tsx), walking
- * each node's mounted subtree instead of a single wall mesh.
+ * Kinds that declare `capabilities.batchable`, re-read when a plugin
+ * registers. Walls keep their merged-geometry batch.
  */
-/** Kinds the batch system manages. Walls keep their merged-geometry batch. */
-export declare const BATCH_KINDS: ReadonlySet<string>;
+export declare function batchableKinds(): ReadonlyMap<string, BatchableConfig>;
+export declare function batchableConfig(node: AnyNode | undefined): BatchableConfig | undefined;
+/** A wall-scoped node (door, window) moves with its host wall. */
+export declare function isWallHosted(node: AnyNode | undefined): boolean;
 export declare function collectBatchCandidate(nodeId: string): BatchCandidate | null;
 export declare function hideBatchedNode(candidate: BatchCandidate): void;
 /**

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

@@ -1 +1 @@
-{"version":3,"file":"candidates.d.ts","sourceRoot":"","sources":["../../../src/shared/node-batch/candidates.ts"],"names":[],"mappings":"AAaA,OAAO,KAAK,EAAE,cAAc,EAAc,MAAM,SAAS,CAAA;AAEzD;;;;GAIG;AAEH,8EAA8E;AAC9E,eAAO,MAAM,WAAW,EAAE,WAAW,CAAC,MAAM,CAO1C,CAAA;AA2EF,wBAAgB,qBAAqB,CAAC,MAAM,EAAE,MAAM,GAAG,cAAc,GAAG,IAAI,CAqF3E;AAED,wBAAgB,eAAe,CAAC,SAAS,EAAE,cAAc,GAAG,IAAI,CAI/D;AAED;;;;;;;;GAQG;AACH,wBAAgB,qBAAqB,IAAI,IAAI,CAQ5C;AAED,wBAAgB,iBAAiB,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI,CAKtD;AAED;;;;GAIG;AACH,wBAAgB,kBAAkB,CAAC,OAAO,EAAE,WAAW,CAAC,MAAM,CAAC,GAAG,GAAG,CAAC,MAAM,CAAC,CAyB5E;AAED,wBAAgB,mBAAmB,IAAI,WAAW,CAAC,MAAM,CAAC,CAOzD"}
+{"version":3,"file":"candidates.d.ts","sourceRoot":"","sources":["../../../src/shared/node-batch/candidates.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,KAAK,OAAO,EAEZ,KAAK,eAAe,EAOrB,MAAM,kBAAkB,CAAA;AAIzB,OAAO,KAAK,EAAE,cAAc,EAAc,MAAM,SAAS,CAAA;AAWzD;;;GAGG;AACH,wBAAgB,cAAc,IAAI,WAAW,CAAC,MAAM,EAAE,eAAe,CAAC,CAYrE;AAED,wBAAgB,eAAe,CAAC,IAAI,EAAE,OAAO,GAAG,SAAS,GAAG,eAAe,GAAG,SAAS,CAEtF;AAED,kEAAkE;AAClE,wBAAgB,YAAY,CAAC,IAAI,EAAE,OAAO,GAAG,SAAS,GAAG,OAAO,CAE/D;AAsDD,wBAAgB,qBAAqB,CAAC,MAAM,EAAE,MAAM,GAAG,cAAc,GAAG,IAAI,CAsE3E;AAED,wBAAgB,eAAe,CAAC,SAAS,EAAE,cAAc,GAAG,IAAI,CAI/D;AAED;;;;;;;;GAQG;AACH,wBAAgB,qBAAqB,IAAI,IAAI,CAQ5C;AAED,wBAAgB,iBAAiB,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI,CAKtD;AAED;;;;GAIG;AACH,wBAAgB,kBAAkB,CAAC,OAAO,EAAE,WAAW,CAAC,MAAM,CAAC,GAAG,GAAG,CAAC,MAAM,CAAC,CAyB5E;AAED,wBAAgB,mBAAmB,IAAI,WAAW,CAAC,MAAM,CAAC,CAOzD"}