@pascal-app/nodes 1.0.3 → 1.0.4

package/dist/ceiling/paint.js

@@ -1,32 +1,99 @@
-import { getMaterialPresetByRef, resolveMaterial, } from '@pascal-app/core';
-import { createSlotPaintCapability } from '../shared/slot-paint';
-import { getCeilingMaterials } from './materials';
+import { CEILING_SLOT_DEFAULT_COLOR, CEILING_SURFACE_ROLE, ceilingPaintRegions, ceilingRegionsOwner, parseCeilingRegionRole, parseMaterialRef, resolveMaterial, useScene, } from '@pascal-app/core';
+import { CEILING_REGION_MESH } from '@pascal-app/viewer';
+import { createSlotPaintCapability, resolveSlotPaintMaterialRef } from '../shared/slot-paint';
+import { swapPreviewMaterial } from '../shared/swap-preview-material';
+import { ceilingColorFromRef, getCeilingMaterials } from './materials';
 /**
- * Ceiling paint on the unified slot model. A ceiling has one paintable surface,
- * so every hit resolves to `surface`; commit writes `node.slots.surface`. The
- * preview swaps the registered underside mesh to the ceiling's own flat-tinted
- * material (built `BackSide`, the way it renders), so the hover preview matches
- * the committed result — a generic PBR preview would be invisible from below.
+ * Ceiling paint on the unified slot model. A ceiling's own finish is its
+ * `surface` slot (`node.slots.surface`); a painted part of it is a region —
+ * the room's (`zone.ceiling.regions`) for an automatic ceiling, the ceiling's
+ * own (`ceiling.regions`) for a manual one — drawn as its own mesh tagged
+ * `region:<id>`. A click lands on what shows there. Previews swap the ceiling's
+ * flat-tinted material (built `BackSide`, the way it renders) on exactly the
+ * mesh the click would change, so the hover matches the committed result.
  */
-export const ceilingPaint = createSlotPaintCapability({
-    resolveRole: () => 'surface',
-    applyPreview: ({ material, materialPreset, root }) => {
-        const color = materialPreset
-            ? (getMaterialPresetByRef(materialPreset)?.mapProperties.color ?? null)
-            : material
-                ? (resolveMaterial(material).color ?? null)
-                : null;
-        if (!color)
+function previewColor(material, materialPreset) {
+    return materialPreset
+        ? ceilingColorFromRef(materialPreset, useScene.getState().materials)
+        : material
+            ? (resolveMaterial(material).color ?? null)
+            : null;
+}
+function regionMesh(root, role) {
+    let found = null;
+    root.traverse((object) => {
+        if (!found && object.name === CEILING_REGION_MESH && object.userData.paintRole === role)
+            found = object;
+    });
+    return found;
+}
+function applyCeilingPreview({ role, material, materialPreset, root }) {
+    const mesh = root;
+    if (!mesh.isMesh)
+        return null;
+    const color = previewColor(material, materialPreset);
+    const erasing = material === undefined && materialPreset === undefined;
+    if (role === CEILING_SURFACE_ROLE) {
+        // Erasing shows the default the ceiling returns to.
+        const shown = color ?? (erasing ? CEILING_SLOT_DEFAULT_COLOR : null);
+        if (!shown)
             return () => { };
-        const mesh = root;
-        if (!mesh.isMesh)
-            return null;
-        const previous = mesh.material;
-        mesh.material = getCeilingMaterials(color).bottomMaterial;
-        return () => {
-            mesh.material = previous;
+        return swapPreviewMaterial(mesh, getCeilingMaterials(shown).bottomMaterial);
+    }
+    const region = regionMesh(mesh, role);
+    if (!region)
+        return null;
+    // An erased region shows the ceiling's own finish under it.
+    const preview = color
+        ? getCeilingMaterials(color).bottomMaterial
+        : erasing
+            ? mesh.material
+            : null;
+    return preview ? swapPreviewMaterial(region, preview) : () => { };
+}
+/** Repaint a region, or remove it for the eraser, in one history step. */
+function commitCeilingRegion(ceiling, regionId, material, materialPreset) {
+    const state = useScene.getState();
+    const resolution = resolveSlotPaintMaterialRef(state.materials, material, materialPreset);
+    if (!resolution)
+        return;
+    const { ref, newSceneMaterial } = resolution;
+    const owner = ceilingRegionsOwner(ceiling);
+    useScene.setState((current) => {
+        if (current.readOnly)
+            return current;
+        const node = current.nodes[owner.id];
+        const regions = node?.type === 'zone'
+            ? (node.ceiling?.regions ?? [])
+            : node?.type === 'ceiling'
+                ? (node.regions ?? [])
+                : null;
+        if (!(node && regions?.some((region) => region.id === regionId)))
+            return current;
+        const next = ref
+            ? regions.map((region) => (region.id === regionId ? { ...region, finish: ref } : region))
+            : regions.filter((region) => region.id !== regionId);
+        const updated = (node.type === 'zone'
+            ? { ...node, ceiling: { ...node.ceiling, regions: next.length ? next : undefined } }
+            : { ...node, regions: next.length ? next : undefined });
+        return {
+            ...(newSceneMaterial
+                ? { materials: { ...current.materials, [newSceneMaterial.id]: newSceneMaterial } }
+                : {}),
+            nodes: { ...current.nodes, [owner.id]: updated },
         };
+    });
+    useScene.getState().markDirty(ceiling.id);
+}
+function regionFinish(ceiling, regionId) {
+    return ceilingPaintRegions(ceiling, useScene.getState().nodes).find((region) => region.id === regionId)?.finish;
+}
+const base = createSlotPaintCapability({
+    resolveRole: ({ hitObject }) => {
+        const role = hitObject?.userData?.paintRole;
+        return typeof role === 'string' && parseCeilingRegionRole(role) ? role : CEILING_SURFACE_ROLE;
     },
+    applyPreview: applyCeilingPreview,
     legacyEffective: (node) => {
         const ceiling = node;
         if (ceiling.materialPreset || ceiling.material) {
@@ -35,3 +102,33 @@ export const ceilingPaint = createSlotPaintCapability({
         return null;
     },
 });
+export const ceilingPaint = {
+    ...base,
+    roleLabel: (_node, role) => (parseCeilingRegionRole(role) ? 'Painted part' : null),
+    buildPatch: (args) => parseCeilingRegionRole(args.role) ? {} : base.buildPatch(args),
+    commit: (args) => {
+        const regionId = parseCeilingRegionRole(args.role);
+        if (!regionId)
+            return base.commit?.(args);
+        commitCeilingRegion(args.node, regionId, args.material, args.materialPreset);
+    },
+    getEffectiveMaterial: (args) => {
+        const regionId = parseCeilingRegionRole(args.role);
+        if (!regionId)
+            return base.getEffectiveMaterial?.(args) ?? null;
+        const finish = regionFinish(args.node, regionId);
+        if (finish === undefined)
+            return null;
+        if (typeof finish !== 'string')
+            return { material: finish, materialPreset: undefined };
+        const parsed = parseMaterialRef(finish);
+        if (parsed?.kind === 'library')
+            return { material: undefined, materialPreset: finish };
+        if (parsed?.kind === 'scene') {
+            const sceneMaterial = useScene.getState().materials[parsed.id];
+            if (sceneMaterial)
+                return { material: sceneMaterial.material, materialPreset: undefined };
+        }
+        return null;
+    },
+};

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

@@ -1 +1 @@
-{"version":3,"file":"panel.d.ts","sourceRoot":"","sources":["../../src/ceiling/panel.tsx"],"names":[],"mappings":"AA2BA;;;;;;;GAOG;AACH,wBAAgB,YAAY,uCA6W3B;AAED,eAAe,YAAY,CAAA"}
+{"version":3,"file":"panel.d.ts","sourceRoot":"","sources":["../../src/ceiling/panel.tsx"],"names":[],"mappings":"AA4BA;;;;;;;GAOG;AACH,wBAAgB,YAAY,uCA2Y3B;AAED,eAAe,YAAY,CAAA"}

package/dist/ceiling/panel.js

@@ -1,10 +1,11 @@
 'use client';
 import { jsx as _jsx, jsxs as _jsxs, Fragment as _Fragment } from "react/jsx-runtime";
-import { getCeilingClampBound, resolveCeilingHeight, useScene, } from '@pascal-app/core';
-import { ActionButton, ActionGroup, formatLinearMeasurement, holeEditScope, PanelSection, PanelWrapper, SegmentedControl, SliderControl, triggerSFX, useEditingHole, useEditor, useInteractionScope, } from '@pascal-app/editor';
+import { resolveCeilingHeight, useScene } from '@pascal-app/core';
+import { ActionButton, ActionGroup, exitCeilingEditToRoom, formatLinearMeasurement, holeEditScope, PanelSection, PanelWrapper, SegmentedControl, ShapeChoice, SliderControl, setCeilingHoles, startOpeningDraft, triggerSFX, useCeilingEditCeilingId, useCeilingEditSession, useEditingHole, useEditor, useInteractionScope, } from '@pascal-app/editor';
 import { useViewer } from '@pascal-app/viewer';
 import { Edit, Move, Plus, Trash2 } from 'lucide-react';
 import { useCallback, useEffect, useRef } from 'react';
+import { CEILING_PANEL_MIN_HEIGHT, ceilingHeightRange, clampCeilingHeight } from './height-bounds';
 /**
  * Phase 5 Stage E — ceiling inspector (kind-owned).
  *
@@ -19,20 +20,23 @@ export function CeilingPanel() {
     const metricNotation = useViewer((s) => s.metricNotation);
     const setSelection = useViewer((s) => s.setSelection);
     const editingHole = useEditingHole();
+    // Holes are edited only inside this ceiling's Edit ceiling session.
+    const canEditHoles = useCeilingEditCeilingId() === selectedId;
+    // The room an edited ceiling belongs to; its openings are cut from the room.
+    const roomZoneId = useCeilingEditSession((s) => s.session && s.session.ceilingId === selectedId ? s.session.zoneId : null);
     const setMovingNode = useEditor((s) => s.setMovingNode);
     const node = useScene((s) => selectedId ? s.nodes[selectedId] : undefined);
     // Ceilings no longer drive the storey height — the stored level height
     // does — so height writes clamp under min(storey plane, lowest covering
     // slab underside from the level above) − margin instead of poking into
-    // the level above or a deck hanging from it (clamp, never ask).
-    // Selector returns a primitive, so recomputing per store update is
-    // re-render-safe.
-    const maxHeight = useScene((s) => {
-        const parent = node?.parentId ? s.nodes[node.parentId] : undefined;
-        return parent?.type === 'level'
-            ? getCeilingClampBound(parent.id, s.nodes, node?.polygon ?? [])
-            : Number.POSITIVE_INFINITY;
-    });
+    // the level above or a deck hanging from it (clamp, never ask). On a
+    // level above grade the floor is grade, not the level floor, so roof-level
+    // soffits keep their negative heights. Selectors return primitives, so
+    // recomputing per store update is re-render-safe.
+    const maxHeight = useScene((s) => node ? ceilingHeightRange(node, s.nodes, CEILING_PANEL_MIN_HEIGHT).max : Infinity);
+    const minHeight = useScene((s) => node
+        ? ceilingHeightRange(node, s.nodes, CEILING_PANEL_MIN_HEIGHT).min
+        : CEILING_PANEL_MIN_HEIGHT);
     // Effective height: the stored custom height, or — for follows-mode
     // ceilings (absent `height`) — the live level-top bound. Primitive
     // selector so it tracks level-height / covering-slab edits.
@@ -42,12 +46,14 @@ export function CeilingPanel() {
             : undefined;
         return ceiling?.type === 'ceiling' ? resolveCeilingHeight(ceiling, s.nodes) : 2.5;
     });
-    // Panel slider-drag fix recipe (plans/editor-node-registry.md): stable
-    // handler refs so slider drags don't trigger Maximum update depth.
+    // Stable handler refs so slider drags don't trigger Maximum update depth;
+    // see "Custom panels" in wiki/architecture/node-definitions.md.
     const nodeRef = useRef(node);
     nodeRef.current = node;
     const maxHeightRef = useRef(maxHeight);
     maxHeightRef.current = maxHeight;
+    const minHeightRef = useRef(minHeight);
+    minHeightRef.current = minHeight;
     const resolvedHeightRef = useRef(resolvedHeight);
     resolvedHeightRef.current = resolvedHeight;
     const handleUpdate = useCallback((updates) => {
@@ -56,7 +62,12 @@ export function CeilingPanel() {
         useScene.getState().updateNode(selectedId, updates);
     }, [selectedId]);
     const handleHeightChange = useCallback((proposed) => {
-        handleUpdate({ height: Math.min(proposed, maxHeightRef.current) });
+        handleUpdate({
+            height: clampCeilingHeight(proposed, {
+                min: minHeightRef.current,
+                max: maxHeightRef.current,
+            }),
+        });
     }, [handleUpdate]);
     const handleTopModeChange = useCallback((mode) => {
         const n = nodeRef.current;
@@ -115,14 +126,16 @@ export function CeilingPanel() {
         ];
         const currentHoles = node?.holes || [];
         const currentMetadata = currentHoles.map((_, index) => node?.holeMetadata?.[index] ?? { source: 'manual' });
-        handleUpdate({
+        const added = setCeilingHoles(selectedId, {
             holes: [...currentHoles, newHole],
             holeMetadata: [...currentMetadata, { source: 'manual' }],
         });
+        if (!added)
+            return;
         useInteractionScope
             .getState()
             .begin(holeEditScope({ nodeId: selectedId, holeIndex: currentHoles.length }));
-    }, [node, selectedId, handleUpdate]);
+    }, [node, selectedId]);
     const handleEditHole = useCallback((index) => {
         if (!selectedId)
             return;
@@ -137,13 +150,13 @@ export function CeilingPanel() {
         const newHoles = currentHoles.filter((_, i) => i !== index);
         const currentMetadata = currentHoles.map((_, metadataIndex) => node?.holeMetadata?.[metadataIndex] ?? { source: 'manual' });
         const newMetadata = currentMetadata.filter((_, i) => i !== index);
-        handleUpdate({ holes: newHoles, holeMetadata: newMetadata });
+        setCeilingHoles(selectedId, { holes: newHoles, holeMetadata: newMetadata });
         if (editingHole?.nodeId === selectedId && editingHole?.holeIndex === index) {
             useInteractionScope
                 .getState()
                 .endIf((scope) => scope.kind === 'reshaping' && scope.reshape === 'hole');
         }
-    }, [selectedId, node?.holes, node?.holeMetadata, handleUpdate, editingHole]);
+    }, [selectedId, node?.holes, node?.holeMetadata, editingHole]);
     const handleMove = useCallback(() => {
         if (!node)
             return;
@@ -185,7 +198,7 @@ export function CeilingPanel() {
     return (_jsxs(PanelWrapper, { icon: "/icons/ceiling.webp", onClose: handleClose, title: node.name || 'Ceiling', width: 320, children: [_jsxs(PanelSection, { title: "Height", children: [_jsx(SegmentedControl, { onChange: handleTopModeChange, options: [
                             { label: 'Follows level', value: 'storey' },
                             { label: 'Custom height', value: 'custom' },
-                        ], value: isFollows ? 'storey' : 'custom' }), isFollows ? (_jsxs("div", { className: "px-1 text-[11px] text-muted-foreground", children: ["Currently ", formatLinearMeasurement(resolvedHeight, unit, metricNotation)] })) : (_jsx(SliderControl, { label: "Height", max: Math.min(1000, maxHeight), min: 0, onChange: handleHeightChange, precision: 3, step: 0.01, unit: "m", value: node.height ?? resolvedHeight })), _jsx("div", { className: "mt-2 grid grid-cols-3 gap-1.5 px-1 pb-1", children: heightPresets.map((preset) => {
+                        ], value: isFollows ? 'storey' : 'custom' }), isFollows ? (_jsxs("div", { className: "px-1 text-[11px] text-muted-foreground", children: ["Currently ", formatLinearMeasurement(resolvedHeight, unit, metricNotation)] })) : (_jsx(SliderControl, { label: "Height", max: Math.min(1000, maxHeight), min: minHeight, onChange: handleHeightChange, precision: 3, step: 0.01, unit: "m", value: node.height ?? resolvedHeight })), _jsx("div", { className: "mt-2 grid grid-cols-3 gap-1.5 px-1 pb-1", children: heightPresets.map((preset) => {
                             const fits = preset.height <= maxHeight;
                             return (_jsx(ActionButton, { className: fits ? undefined : 'cursor-not-allowed opacity-40', disabled: !fits, label: preset.label, onClick: () => handleHeightChange(preset.height), title: fits
                                     ? undefined
@@ -198,9 +211,13 @@ export function CeilingPanel() {
                             const autoLabel = source === 'elevator' ? 'Auto elevator cutout' : 'Auto stair cutout';
                             return (_jsxs("div", { className: `flex items-center justify-between rounded-lg border p-2 transition-colors ${isEditing
                                     ? 'border-primary/50 bg-primary/10'
-                                    : 'border-transparent hover:bg-accent/30'}`, children: [_jsxs("div", { className: "min-w-0 flex-1", children: [_jsxs("p", { className: `font-medium text-xs ${isEditing ? 'text-primary' : 'text-white'}`, children: ["Hole ", index + 1, " ", isEditing && '(Editing)'] }), _jsxs("p", { className: "text-[10px] text-muted-foreground", children: [holeArea.toFixed(2), " m\u00B2 \u00B7 ", hole.length, " pts \u00B7", ' ', isAutoHole ? autoLabel : 'Manual'] })] }), _jsx("div", { className: "flex items-center gap-1", children: isEditing ? (_jsx(ActionButton, { className: "h-7 bg-primary text-primary-foreground hover:bg-primary/90", label: "Done", onClick: () => useInteractionScope
-                                                .getState()
-                                                .endIf((scope) => scope.kind === 'reshaping' && scope.reshape === 'hole') })) : isAutoHole ? (_jsx("div", { className: "rounded-md bg-[#2C2C2E] px-2 py-1 text-[10px] text-muted-foreground", children: "Auto" })) : (_jsxs(_Fragment, { children: [_jsx("button", { className: "flex h-7 w-7 items-center justify-center rounded-md bg-[#2C2C2E] text-muted-foreground hover:bg-[#3e3e3e] hover:text-foreground", onClick: () => handleEditHole(index), type: "button", children: _jsx(Edit, { className: "h-3.5 w-3.5" }) }), _jsx("button", { className: "flex h-7 w-7 items-center justify-center rounded-md bg-red-500/10 text-red-400 hover:bg-red-500/20 hover:text-red-300", onClick: () => handleDeleteHole(index), type: "button", children: _jsx(Trash2, { className: "h-3.5 w-3.5" }) })] })) })] }, index));
-                        }) })) : (_jsx("div", { className: "px-2 py-3 text-center text-muted-foreground text-xs", children: "No holes" })), _jsx("div", { className: "px-1 pt-1 pb-1", children: _jsx(ActionButton, { className: "w-full", disabled: editingHole?.nodeId === selectedId, icon: _jsx(Plus, { className: "h-3.5 w-3.5" }), label: "Add Hole", onClick: handleAddHole }) })] }), _jsx(ActionGroup, { children: _jsx(ActionButton, { icon: _jsx(Move, { className: "h-3.5 w-3.5" }), label: "Move", onClick: handleMove }) })] }));
+                                    : 'border-transparent hover:bg-accent/30'}`, children: [_jsxs("div", { className: "min-w-0 flex-1", children: [_jsxs("p", { className: `font-medium text-xs ${isEditing ? 'text-primary' : 'text-white'}`, children: ["Hole ", index + 1, " ", isEditing && '(Editing)'] }), _jsxs("p", { className: "text-[10px] text-muted-foreground", children: [holeArea.toFixed(2), " m\u00B2 \u00B7 ", hole.length, " pts \u00B7", ' ', isAutoHole ? autoLabel : 'Manual'] })] }), _jsx("div", { className: "flex items-center gap-1", children: isEditing ? (_jsx(ActionButton, { className: "h-7 bg-primary text-primary-foreground hover:bg-primary/90", label: "Done", onClick: () => {
+                                                useInteractionScope
+                                                    .getState()
+                                                    .endIf((scope) => scope.kind === 'reshaping' && scope.reshape === 'hole');
+                                                // A finished opening is a completed action: back to the room.
+                                                exitCeilingEditToRoom();
+                                            } })) : isAutoHole ? (_jsx("div", { className: "rounded-md bg-[#2C2C2E] px-2 py-1 text-[10px] text-muted-foreground", children: "Auto" })) : canEditHoles ? (_jsxs(_Fragment, { children: [_jsx("button", { className: "flex h-7 w-7 items-center justify-center rounded-md bg-[#2C2C2E] text-muted-foreground hover:bg-[#3e3e3e] hover:text-foreground", onClick: () => handleEditHole(index), type: "button", children: _jsx(Edit, { className: "h-3.5 w-3.5" }) }), _jsx("button", { className: "flex h-7 w-7 items-center justify-center rounded-md bg-red-500/10 text-red-400 hover:bg-red-500/20 hover:text-red-300", onClick: () => handleDeleteHole(index), type: "button", children: _jsx(Trash2, { className: "h-3.5 w-3.5" }) })] })) : null })] }, index));
+                        }) })) : (_jsx("div", { className: "px-2 py-3 text-center text-muted-foreground text-xs", children: "No holes" })), _jsx("div", { className: "px-1 pt-1 pb-1", children: roomZoneId ? (_jsx(ShapeChoice, { className: "px-1 text-muted-foreground text-xs", disabled: !canEditHoles, label: "Cut opening", onPick: (shape) => startOpeningDraft(roomZoneId, 'ceiling', shape) })) : (_jsx(ActionButton, { className: "w-full", disabled: !canEditHoles || editingHole?.nodeId === selectedId, icon: _jsx(Plus, { className: "h-3.5 w-3.5" }), label: "Add Hole", onClick: handleAddHole })) })] }), _jsx(ActionGroup, { children: _jsx(ActionButton, { icon: _jsx(Move, { className: "h-3.5 w-3.5" }), label: "Move", onClick: handleMove }) })] }));
 }
 export default CeilingPanel;

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

@@ -1 +1 @@
-{"version":3,"file":"renderer.d.ts","sourceRoot":"","sources":["../../src/ceiling/renderer.tsx"],"names":[],"mappings":"AAEA,OAAO,EACL,KAAK,WAAW,EAOjB,MAAM,kBAAkB,CAAA;AAkBzB,eAAO,MAAM,eAAe,GAAI,UAAU;IAAE,IAAI,EAAE,WAAW,CAAA;CAAE,gCA2G9D,CAAA;AAED,eAAe,eAAe,CAAA"}
+{"version":3,"file":"renderer.d.ts","sourceRoot":"","sources":["../../src/ceiling/renderer.tsx"],"names":[],"mappings":"AAEA,OAAO,EAIL,KAAK,WAAW,EASjB,MAAM,kBAAkB,CAAA;AAmBzB,eAAO,MAAM,eAAe,GAAI,UAAU;IAAE,IAAI,EAAE,WAAW,CAAA;CAAE,gCAgJ9D,CAAA;AAED,eAAe,eAAe,CAAA"}

package/dist/ceiling/renderer.js

@@ -1,12 +1,11 @@
 'use client';
 import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
-import { getMaterialPresetByRef, resolveCeilingHeight, resolveMaterial, useLiveTransforms, useRegistry, useScene, } from '@pascal-app/core';
-import { createSurfaceRoleMaterial, NodeRenderer, resolveSurfaceColor, useNodeEvents, useViewer, } from '@pascal-app/viewer';
-import { useEffect, useLayoutEffect, useMemo, useRef } from 'react';
+import { CEILING_DRAW_OFFSET, CEILING_SLOT_DEFAULT_COLOR, ceilingPaintRegions, getMaterialPresetByRef, resolveCeilingHeight, resolveMaterial, useLiveTransforms, useRegistry, useScene, } from '@pascal-app/core';
+import { CEILING_REGION_MESH, createSurfaceRoleMaterial, NodeRenderer, resolveSurfaceColor, useNodeEvents, useViewer, } from '@pascal-app/viewer';
+import { useCallback, useEffect, useLayoutEffect, useMemo, useRef } from 'react';
 import { BackSide } from 'three/webgpu';
 import { createPlaceholderGeometry } from '../shared/placeholder-geometry';
 import { ceilingColorFromRef, getCeilingMaterials } from './materials';
-import { CEILING_SLOT_DEFAULT_COLOR } from './slots';
 function createEmptyGeometry() {
     return createPlaceholderGeometry();
 }
@@ -36,7 +35,7 @@ export const CeilingRenderer = ({ node }) => {
     // (primitive selector, so follows-mode ceilings track level-height edits
     // and covering-slab changes without a node write).
     const resolvedHeight = useScene((s) => resolveCeilingHeight(node, s.nodes));
-    const ceilingY = resolvedHeight - 0.01 + (liveTransform?.position[1] ?? 0);
+    const ceilingY = resolvedHeight - CEILING_DRAW_OFFSET + (liveTransform?.position[1] ?? 0);
     const position = [
         liveTransform?.position[0] ?? 0,
         ceilingY,
@@ -87,6 +86,43 @@ export const CeilingRenderer = ({ node }) => {
         node.material?.properties,
         node.material?.texture,
     ]);
+    // Painted parts draw with the same flat tint as the ceiling; the system builds
+    // their meshes and asks this for the material.
+    const regionMaterial = useCallback((finish) => {
+        if (!textures)
+            return materials.bottomMaterial;
+        const color = typeof finish === 'string'
+            ? ceilingColorFromRef(finish, sceneMaterials)
+            : finish
+                ? resolveMaterial(finish).color
+                : null;
+        return getCeilingMaterials(color || CEILING_SLOT_DEFAULT_COLOR).bottomMaterial;
+    }, [textures, sceneMaterials, materials]);
+    useLayoutEffect(() => {
+        const mesh = ref.current;
+        if (!mesh)
+            return;
+        mesh.userData.ceilingRegionMaterial = regionMaterial;
+        let repainted = false;
+        for (const child of mesh.children)
+            if (child.name === CEILING_REGION_MESH) {
+                ;
+                child.material = regionMaterial(child.userData.finish);
+                repainted = true;
+            }
+        // A batched copy keeps the old material until the ceiling is rebuilt.
+        if (repainted)
+            useScene.getState().markDirty(node.id);
+    }, [node.id, regionMaterial]);
+    // An automatic ceiling's regions live on its room: a repaint there rebuilds it.
+    const regionsKey = useScene((s) => JSON.stringify(ceilingPaintRegions(node, s.nodes)));
+    const builtRegionsKey = useRef(regionsKey);
+    useEffect(() => {
+        if (builtRegionsKey.current === regionsKey)
+            return;
+        builtRegionsKey.current = regionsKey;
+        useScene.getState().markDirty(node.id);
+    }, [node.id, regionsKey]);
     return (_jsxs("mesh", { geometry: placeholderGeometry, material: materials.bottomMaterial, position: position, ref: ref, visible: node.visible !== false, ...handlers, children: [_jsx("mesh", { geometry: gridPlaceholderGeometry, material: materials.topMaterial, name: "ceiling-grid", scale: 0, visible: false }), (node.children ?? []).map((childId) => (_jsx(NodeRenderer, { nodeId: childId }, childId)))] }));
 };
 export default CeilingRenderer;

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

@@ -1 +1 @@
-{"version":3,"file":"move-tool.d.ts","sourceRoot":"","sources":["../../src/chimney/move-tool.tsx"],"names":[],"mappings":"AAEA,OAAO,EAEL,KAAK,WAAW,EAOjB,MAAM,kBAAkB,CAAA;AAiCzB;;;;;;;;;;;;GAYG;AACH,QAAA,MAAM,eAAe,GAAI,UAAU;IAAE,IAAI,EAAE,WAAW,CAAA;CAAE,uCAoRvD,CAAA;AAED,eAAe,eAAe,CAAA"}
+{"version":3,"file":"move-tool.d.ts","sourceRoot":"","sources":["../../src/chimney/move-tool.tsx"],"names":[],"mappings":"AAEA,OAAO,EAEL,KAAK,WAAW,EAOjB,MAAM,kBAAkB,CAAA;AAkCzB;;;;;;;;;;;;GAYG;AACH,QAAA,MAAM,eAAe,GAAI,UAAU;IAAE,IAAI,EAAE,WAAW,CAAA;CAAE,uCA0RvD,CAAA;AAED,eAAe,eAAe,CAAA"}

package/dist/chimney/move-tool.js

@@ -1,7 +1,7 @@
 'use client';
 import { jsx as _jsx } from "react/jsx-runtime";
 import { ChimneyNode as ChimneyNodeSchema, emitter, sceneRegistry, useScene, } from '@pascal-app/core';
-import { consumePlacementDragRelease, markToolCancelConsumed, triggerSFX, useEditor, } from '@pascal-app/editor';
+import { consumePlacementDragRelease, copyCollectionIds, markToolCancelConsumed, triggerSFX, useEditor, } from '@pascal-app/editor';
 import { useViewer } from '@pascal-app/viewer';
 import { useEffect, useMemo, useRef, useState } from 'react';
 import * as THREE from 'three';
@@ -157,7 +157,13 @@ const MoveChimneyTool = ({ node }) => {
                 useScene.temporal.getState().resume();
                 state.applyNodeChanges({
                     delete: node.id ? [node.id] : [],
-                    create: [{ node: committed, parentId: targetSegmentId }],
+                    create: [
+                        {
+                            node: committed,
+                            parentId: targetSegmentId,
+                            collectionIds: copyCollectionIds(node),
+                        },
+                    ],
                 });
                 state.dirtyNodes.add(targetSegmentId);
                 setSelection({ selectedIds: [committed.id] });

package/dist/chimney/paint.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"paint.d.ts","sourceRoot":"","sources":["../../src/chimney/paint.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,mBAAmB,EACnB,WAAW,EACX,cAAc,EACd,eAAe,EAChB,MAAM,kBAAkB,CAAA;AAIzB;;;;;;;;;GASG;AACH,wBAAgB,kBAAkB,CAAC,aAAa,EAAE,MAAM,GAAG,IAAI,GAAG,mBAAmB,CAEpF;AAED,wBAAgB,yBAAyB,CACvC,IAAI,EAAE,mBAAmB,EACzB,QAAQ,EAAE,cAAc,GAAG,SAAS,EACpC,cAAc,EAAE,MAAM,GAAG,SAAS,GACjC,OAAO,CAAC,WAAW,CAAC,CAKtB;AAED,wBAAgB,2BAA2B,CACzC,IAAI,EAAE,WAAW,EACjB,IAAI,EAAE,mBAAmB,GACxB;IAAE,QAAQ,EAAE,cAAc,GAAG,SAAS,CAAC;IAAC,cAAc,EAAE,MAAM,GAAG,SAAS,CAAA;CAAE,CAQ9E;AAyDD;;;;GAIG;AACH,eAAO,MAAM,YAAY,EAAE,eAW1B,CAAA"}
+{"version":3,"file":"paint.d.ts","sourceRoot":"","sources":["../../src/chimney/paint.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,mBAAmB,EACnB,WAAW,EACX,cAAc,EACd,eAAe,EAChB,MAAM,kBAAkB,CAAA;AAKzB;;;;;;;;;GASG;AACH,wBAAgB,kBAAkB,CAAC,aAAa,EAAE,MAAM,GAAG,IAAI,GAAG,mBAAmB,CAEpF;AAED,wBAAgB,yBAAyB,CACvC,IAAI,EAAE,mBAAmB,EACzB,QAAQ,EAAE,cAAc,GAAG,SAAS,EACpC,cAAc,EAAE,MAAM,GAAG,SAAS,GACjC,OAAO,CAAC,WAAW,CAAC,CAKtB;AAED,wBAAgB,2BAA2B,CACzC,IAAI,EAAE,WAAW,EACjB,IAAI,EAAE,mBAAmB,GACxB;IAAE,QAAQ,EAAE,cAAc,GAAG,SAAS,CAAC;IAAC,cAAc,EAAE,MAAM,GAAG,SAAS,CAAA;CAAE,CAQ9E;AAiDD;;;;GAIG;AACH,eAAO,MAAM,YAAY,EAAE,eAW1B,CAAA"}

package/dist/chimney/paint.js

@@ -1,4 +1,5 @@
 import { createMaterial, createMaterialFromPresetRef } from '@pascal-app/viewer';
+import { swapPreviewMaterial } from '../shared/swap-preview-material';
 /**
  * Resolve a chimney face click to its logical surface role.
  *
@@ -55,20 +56,12 @@ function applyChimneyPreview(role, previewMaterial, root) {
             const previousAtIdx = current[idx];
             if (!previousAtIdx)
                 return;
-            const previousArray = [...current];
             const nextArray = [...current];
             nextArray[idx] = previewMaterial;
-            mesh.material = nextArray;
-            restores.push(() => {
-                mesh.material = previousArray;
-            });
+            restores.push(swapPreviewMaterial(mesh, nextArray));
         }
         else if (role === 'body') {
-            const previous = mesh.material;
-            mesh.material = previewMaterial;
-            restores.push(() => {
-                mesh.material = previous;
-            });
+            restores.push(swapPreviewMaterial(mesh, previewMaterial));
         }
     });
     if (restores.length === 0)

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

@@ -1 +1 @@
-{"version":3,"file":"definition.d.ts","sourceRoot":"","sources":["../../src/column/definition.ts"],"names":[],"mappings":"AAAA,OAAO,EAML,KAAK,cAAc,EACpB,MAAM,kBAAkB,CAAA;AAYzB,OAAO,EAAE,UAAU,EAAE,MAAM,UAAU,CAAA;AA4TrC;;;;;;;;;;;;;;;;GAgBG;AACH,eAAO,MAAM,gBAAgB,EAAE,cAAc,CAAC,OAAO,UAAU,CAqG9D,CAAA"}
+{"version":3,"file":"definition.d.ts","sourceRoot":"","sources":["../../src/column/definition.ts"],"names":[],"mappings":"AAAA,OAAO,EAOL,KAAK,cAAc,EACpB,MAAM,kBAAkB,CAAA;AAczB,OAAO,EAAE,UAAU,EAAE,MAAM,UAAU,CAAA;AA4UrC;;;;;;;;;;;;;;;;GAgBG;AACH,eAAO,MAAM,gBAAgB,EAAE,cAAc,CAAC,OAAO,UAAU,CAsG9D,CAAA"}

package/dist/column/definition.js

@@ -1,5 +1,7 @@
-import { ColumnNode as ColumnNodeSchema, } from '@pascal-app/core';
+import { ColumnNode as ColumnNodeSchema, columnSlots, } from '@pascal-app/core';
 import { withHostedChildren } from '../shared/hosted-resize';
+import { columnBatchable } from '../shared/node-batch/batchable';
+import { rebuildScriptedSize } from '../shared/scripted-opening-handles';
 import { collectStructuralGridAxes, resolveStructuralGridSnap, } from '../structural-grid/coordination';
 import { buildColumnFloorplan, computeColumnFloorplanLevelData } from './floorplan';
 import { columnResizeAffordance, columnRotateAffordance } from './floorplan-affordances';
@@ -8,7 +10,6 @@ import { columnHostedPolicy } from './hosted-resize';
 import { columnPaint } from './paint';
 import { columnParametrics } from './parametrics';
 import { ColumnNode } from './schema';
-import { columnSlots } from './slots';
 import { columnSurfaceProvider } from './surface';
 // Limits + offsets shared with the in-world arrows. Mirrors the floors
 // the renderer clamps to (`Math.max(0.2, node.height)` etc.) so a drag
@@ -183,6 +184,8 @@ function isLeanToManagedColumn(node) {
 // non-vertical supports fall back to the widest sensible brace bound so
 // the rotation handle clears the splay.
 function columnFootprintHalf(n) {
+    if (n.source)
+        return { halfX: n.width / 2, halfZ: n.depth / 2 };
     if (n.supportStyle === 'vertical') {
         if (ROUND_CROSS_SECTIONS.has(n.crossSection)) {
             return { halfX: n.radius, halfZ: n.radius };
@@ -255,6 +258,24 @@ function columnMoveHandle() {
     };
 }
 function columnHandles(node) {
+    if (node.source) {
+        const declared = new Set(node.source.manifest.params.map((param) => param.id));
+        const sizes = [];
+        if (declared.has('height'))
+            sizes.push(columnHeightHandle());
+        if (declared.has('width'))
+            sizes.push(columnAxisHandle('x'));
+        if (declared.has('depth'))
+            sizes.push(columnAxisHandle('z'));
+        return [
+            ...sizes.map((handle) => ({
+                ...handle,
+                commit: (initial, patch) => rebuildScriptedSize(initial, patch),
+            })),
+            columnRotateHandle(),
+            columnMoveHandle(),
+        ];
+    }
     // 1. Height (universal).
     // 2. Footprint arrows depending on supportStyle + crossSection:
     //    - non-vertical supports → braceWidth + braceDepth (skips crossSection)
@@ -328,6 +349,7 @@ export const columnDefinition = {
         return rest;
     },
     capabilities: {
+        batchable: columnBatchable,
         surfacePlacement: 'floor-only',
         selectable: { hitVolume: 'bbox' },
         surfaces: {

package/dist/column/floorplan-affordances.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"floorplan-affordances.d.ts","sourceRoot":"","sources":["../../src/column/floorplan-affordances.ts"],"names":[],"mappings":"AAAA,OAAO,EAEL,KAAK,UAAU,EACf,KAAK,mBAAmB,EAGzB,MAAM,kBAAkB,CAAA;AAczB;;;;;;;;;;;;;;GAcG;AACH,MAAM,MAAM,mBAAmB,GAAG;IAChC,GAAG,EACC,OAAO,GACP,OAAO,GACP,SAAS,GACT,QAAQ,GACR,aAAa,GACb,aAAa,GACb,qBAAqB,GACrB,kBAAkB,CAAA;IACtB,QAAQ,EAAE,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;CAC3B,CAAA;AAED,eAAO,MAAM,sBAAsB,EAAE,mBAAmB,CAAC,UAAU,CAsFlE,CAAA;AAED;;;;;;;;GAQG;AACH,eAAO,MAAM,sBAAsB,EAAE,mBAAmB,CAAC,UAAU,CAgClE,CAAA"}
+{"version":3,"file":"floorplan-affordances.d.ts","sourceRoot":"","sources":["../../src/column/floorplan-affordances.ts"],"names":[],"mappings":"AAAA,OAAO,EAEL,KAAK,UAAU,EACf,KAAK,mBAAmB,EAGzB,MAAM,kBAAkB,CAAA;AAezB;;;;;;;;;;;;;;GAcG;AACH,MAAM,MAAM,mBAAmB,GAAG;IAChC,GAAG,EACC,OAAO,GACP,OAAO,GACP,SAAS,GACT,QAAQ,GACR,aAAa,GACb,aAAa,GACb,qBAAqB,GACrB,kBAAkB,CAAA;IACtB,QAAQ,EAAE,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;CAC3B,CAAA;AAED,eAAO,MAAM,sBAAsB,EAAE,mBAAmB,CAAC,UAAU,CA0FlE,CAAA;AAED;;;;;;;;GAQG;AACH,eAAO,MAAM,sBAAsB,EAAE,mBAAmB,CAAC,UAAU,CAgClE,CAAA"}

package/dist/column/floorplan-affordances.js

@@ -1,6 +1,7 @@
 import { useLiveNodeOverrides, useScene, } from '@pascal-app/core';
 import { isAngleSnapActive } from '@pascal-app/editor';
 import { rotateAffordanceDelta } from '../shared/rotate-affordance';
+import { rebuildScriptedSize } from '../shared/scripted-opening-handles';
 import { planColumnEdit } from './hosted-resize';
 // Floor minimums — mirror the 3D handles in `column/definition.ts` so a
 // drag can't push a value past what the renderer accepts.
@@ -85,6 +86,10 @@ export const columnResizeAffordance = {
             commit() {
                 if (Object.keys(lastPatch).length > 0) {
                     useLiveNodeOverrides.getState().clear(columnId);
+                    if (node.source) {
+                        rebuildScriptedSize(node, lastPatch);
+                        return;
+                    }
                     const updates = planColumnEdit(columnId, lastPatch);
                     if (updates)
                         useScene.getState().updateNodes(updates.map(([id, data]) => ({ id, data })));

package/dist/column/floorplan.d.ts

@@ -1,4 +1,4 @@
-import type { AnyNode, ColumnNode, FloorplanGeometry, FloorplanPoint, GeometryContext, StructuralGridNode } from '@pascal-app/core';
+import { type AnyNode, type ColumnNode, type FloorplanGeometry, type FloorplanPoint, type GeometryContext, type StructuralGridNode } from '@pascal-app/core';
 export type ColumnFloorplanLevelData = {
     structuralGrids: StructuralGridNode[];
 };

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

@@ -1 +1 @@
-{"version":3,"file":"floorplan.d.ts","sourceRoot":"","sources":["../../src/column/floorplan.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,OAAO,EACP,UAAU,EACV,iBAAiB,EACjB,cAAc,EACd,eAAe,EACf,kBAAkB,EACnB,MAAM,kBAAkB,CAAA;AAsBzB,MAAM,MAAM,wBAAwB,GAAG;IACrC,eAAe,EAAE,kBAAkB,EAAE,CAAA;CACtC,CAAA;AAED,wBAAgB,+BAA+B,CAAC,EAC9C,QAAQ,EACR,KAAK,GACN,EAAE;IACD,QAAQ,EAAE,SAAS,UAAU,EAAE,CAAA;IAC/B,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;CAC/B,GAAG,wBAAwB,CAI3B;AAED;;;;;;;;;;;GAWG;AACH,wBAAgB,oBAAoB,CAClC,IAAI,EAAE,UAAU,EAChB,GAAG,EAAE,eAAe,GACnB,iBAAiB,GAAG,IAAI,CA6L1B;AAED,wBAAgB,2BAA2B,CAAC,IAAI,EAAE,UAAU,GAAG,cAAc,EAAE,CAE9E"}
+{"version":3,"file":"floorplan.d.ts","sourceRoot":"","sources":["../../src/column/floorplan.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,KAAK,OAAO,EACZ,KAAK,UAAU,EACf,KAAK,iBAAiB,EACtB,KAAK,cAAc,EACnB,KAAK,eAAe,EACpB,KAAK,kBAAkB,EAExB,MAAM,kBAAkB,CAAA;AAsBzB,MAAM,MAAM,wBAAwB,GAAG;IACrC,eAAe,EAAE,kBAAkB,EAAE,CAAA;CACtC,CAAA;AAED,wBAAgB,+BAA+B,CAAC,EAC9C,QAAQ,EACR,KAAK,GACN,EAAE;IACD,QAAQ,EAAE,SAAS,UAAU,EAAE,CAAA;IAC/B,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;CAC/B,GAAG,wBAAwB,CAI3B;AAED;;;;;;;;;;;GAWG;AACH,wBAAgB,oBAAoB,CAClC,IAAI,EAAE,UAAU,EAChB,GAAG,EAAE,eAAe,GACnB,iBAAiB,GAAG,IAAI,CAsN1B;AAED,wBAAgB,2BAA2B,CAAC,IAAI,EAAE,UAAU,GAAG,cAAc,EAAE,CAiB9E"}