@pascal-app/nodes 1.0.3 → 1.0.5

package/dist/ceiling/height-bounds.d.ts

@@ -0,0 +1,19 @@
+import { type AnyNode, type AnyNodeId, type CeilingNode } from '@pascal-app/core';
+/** Handle floor for a ceiling at grade: keeps the drag arrow off the floor. */
+export declare const CEILING_HANDLE_MIN_HEIGHT = 0.5;
+/** Panel slider floor for a ceiling at grade. */
+export declare const CEILING_PANEL_MIN_HEIGHT = 0;
+export type CeilingHeightRange = {
+    min: number;
+    max: number;
+};
+/**
+ * Where a ceiling's stored height may go. `max` clamps under the storey
+ * plane and any covering slab from the level above (clamp, never ask);
+ * `min` lets a ceiling on a level above grade hang down to grade, and
+ * keeps `atGradeMin` on the ground storey.
+ */
+export declare function ceilingHeightRange(ceiling: Pick<CeilingNode, 'parentId' | 'polygon'>, nodes: Record<AnyNodeId, AnyNode>, atGradeMin: number): CeilingHeightRange;
+/** Same order as the slider and handle clamps: the upper bound wins a conflict. */
+export declare function clampCeilingHeight(height: number, range: CeilingHeightRange): number;
+//# sourceMappingURL=height-bounds.d.ts.map

package/dist/ceiling/height-bounds.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"height-bounds.d.ts","sourceRoot":"","sources":["../../src/ceiling/height-bounds.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,KAAK,OAAO,EACZ,KAAK,SAAS,EACd,KAAK,WAAW,EAGjB,MAAM,kBAAkB,CAAA;AAEzB,+EAA+E;AAC/E,eAAO,MAAM,yBAAyB,MAAM,CAAA;AAC5C,iDAAiD;AACjD,eAAO,MAAM,wBAAwB,IAAI,CAAA;AAEzC,MAAM,MAAM,kBAAkB,GAAG;IAAE,GAAG,EAAE,MAAM,CAAC;IAAC,GAAG,EAAE,MAAM,CAAA;CAAE,CAAA;AAE7D;;;;;GAKG;AACH,wBAAgB,kBAAkB,CAChC,OAAO,EAAE,IAAI,CAAC,WAAW,EAAE,UAAU,GAAG,SAAS,CAAC,EAClD,KAAK,EAAE,MAAM,CAAC,SAAS,EAAE,OAAO,CAAC,EACjC,UAAU,EAAE,MAAM,GACjB,kBAAkB,CAOpB;AAED,mFAAmF;AACnF,wBAAgB,kBAAkB,CAAC,MAAM,EAAE,MAAM,EAAE,KAAK,EAAE,kBAAkB,GAAG,MAAM,CAEpF"}

package/dist/ceiling/height-bounds.js

@@ -0,0 +1,24 @@
+import { getCeilingClampBound, getCeilingMinHeight, } from '@pascal-app/core';
+/** Handle floor for a ceiling at grade: keeps the drag arrow off the floor. */
+export const CEILING_HANDLE_MIN_HEIGHT = 0.5;
+/** Panel slider floor for a ceiling at grade. */
+export const CEILING_PANEL_MIN_HEIGHT = 0;
+/**
+ * Where a ceiling's stored height may go. `max` clamps under the storey
+ * plane and any covering slab from the level above (clamp, never ask);
+ * `min` lets a ceiling on a level above grade hang down to grade, and
+ * keeps `atGradeMin` on the ground storey.
+ */
+export function ceilingHeightRange(ceiling, nodes, atGradeMin) {
+    const parent = ceiling.parentId ? nodes[ceiling.parentId] : undefined;
+    if (parent?.type !== 'level')
+        return { min: atGradeMin, max: Number.POSITIVE_INFINITY };
+    return {
+        min: getCeilingMinHeight(parent.id, nodes, atGradeMin),
+        max: getCeilingClampBound(parent.id, nodes, ceiling.polygon ?? []),
+    };
+}
+/** Same order as the slider and handle clamps: the upper bound wins a conflict. */
+export function clampCeilingHeight(height, range) {
+    return Math.min(range.max, Math.max(range.min, height));
+}

package/dist/ceiling/hole-editor.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"hole-editor.d.ts","sourceRoot":"","sources":["../../src/ceiling/hole-editor.tsx"],"names":[],"mappings":"AAEA,OAAO,EACL,KAAK,WAAW,EAKjB,MAAM,kBAAkB,CAAA;AAKzB;;GAEG;AACH,eAAO,MAAM,iBAAiB,EAAE,KAAK,CAAC,EAAE,CAAC;IACvC,SAAS,EAAE,WAAW,CAAC,IAAI,CAAC,CAAA;IAC5B,SAAS,EAAE,MAAM,CAAA;CAClB,CAwDA,CAAA;AAED,eAAe,iBAAiB,CAAA"}
+{"version":3,"file":"hole-editor.d.ts","sourceRoot":"","sources":["../../src/ceiling/hole-editor.tsx"],"names":[],"mappings":"AAEA,OAAO,EACL,KAAK,WAAW,EAKjB,MAAM,kBAAkB,CAAA;AAKzB;;GAEG;AACH,eAAO,MAAM,iBAAiB,EAAE,KAAK,CAAC,EAAE,CAAC;IACvC,SAAS,EAAE,WAAW,CAAC,IAAI,CAAC,CAAA;IAC5B,SAAS,EAAE,MAAM,CAAA;CAClB,CAuDA,CAAA;eAEc,iBAAiB"}

package/dist/ceiling/hole-editor.js

@@ -1,7 +1,7 @@
 'use client';
 import { jsx as _jsx } from "react/jsx-runtime";
 import { resolveCeilingHeight, resolveLevelId, useLiveNodeOverrides, useScene, } from '@pascal-app/core';
-import { PolygonEditor } from '@pascal-app/editor';
+import { PolygonEditor, setCeilingHoles } from '@pascal-app/editor';
 import { useViewer } from '@pascal-app/viewer';
 import { useCallback, useEffect } from 'react';
 /**
@@ -9,7 +9,6 @@ import { useCallback, useEffect } from 'react';
  */
 export const CeilingHoleEditor = ({ ceilingId, holeIndex }) => {
     const ceilingNode = useScene((s) => s.nodes[ceilingId]);
-    const updateNode = useScene((s) => s.updateNode);
     const markDirty = useScene((s) => s.markDirty);
     const setSelection = useViewer((s) => s.setSelection);
     const ceiling = ceilingNode?.type === 'ceiling' ? ceilingNode : null;
@@ -18,9 +17,9 @@ export const CeilingHoleEditor = ({ ceilingId, holeIndex }) => {
     const handlePolygonChange = useCallback((newPolygon) => {
         const updatedHoles = [...holes];
         updatedHoles[holeIndex] = newPolygon;
-        updateNode(ceilingId, { holes: updatedHoles });
+        setCeilingHoles(ceilingId, { holes: updatedHoles });
         setSelection({ selectedIds: [ceilingId] });
-    }, [ceilingId, holeIndex, holes, updateNode, setSelection]);
+    }, [ceilingId, holeIndex, holes, setSelection]);
     const handlePolygonPreview = useCallback((preview) => {
         if (preview) {
             const updatedHoles = [...holes];

package/dist/ceiling/index.d.ts

@@ -1,3 +1,3 @@
-export { ceilingDefinition } from './definition';
-export { CeilingNode } from './schema';
+export { ceilingDefinition } from './definition.js';
+export { CeilingNode } from './schema.js';
 //# sourceMappingURL=index.d.ts.map

package/dist/ceiling/index.js

@@ -1,2 +1,2 @@
-export { ceilingDefinition } from './definition';
-export { CeilingNode } from './schema';
+export { ceilingDefinition } from './definition.js';
+export { CeilingNode } from './schema.js';

package/dist/ceiling/materials.d.ts

@@ -1,14 +1,18 @@
-import { type SceneMaterial, type SceneMaterialId } from '@pascal-app/core';
+import { type MaterialSchema, type SceneMaterial, type SceneMaterialId } from '@pascal-app/core';
+import { type RenderShading } from '@pascal-app/viewer';
+import type { Material } from 'three';
 import { MeshBasicNodeMaterial } from 'three/webgpu';
 export type CeilingMaterials = {
     topMaterial: MeshBasicNodeMaterial;
-    bottomMaterial: MeshBasicNodeMaterial;
+    bottomMaterial: Material;
 };
-export declare function getCeilingMaterials(color?: string): CeilingMaterials;
+export declare function getCeilingMaterials(color?: string, shading?: RenderShading): CeilingMaterials;
+/** Resolve through the shared caches, without mutating another surface's material. */
+export declare function resolveCeilingFinish(finish: MaterialSchema | string | undefined, sceneMaterials: Record<SceneMaterialId, SceneMaterial> | undefined, shading: RenderShading): Material | null;
 /**
  * Resolve a slot `MaterialRef` to a flat colour for the ceiling surface.
  * `library:` refs use the catalog preset's base colour; `scene:` refs use the
- * stored material's colour. Returns null for a dangling / unparseable ref so
+ * stored material's colour; a plain colour is itself. Returns null for a dangling / unparseable ref so
  * the caller falls back to its default.
  */
 export declare function ceilingColorFromRef(ref: string | undefined, sceneMaterials: Record<SceneMaterialId, SceneMaterial> | undefined): string | null;

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

@@ -1 +1 @@
-{"version":3,"file":"materials.d.ts","sourceRoot":"","sources":["../../src/ceiling/materials.ts"],"names":[],"mappings":"AAAA,OAAO,EAIL,KAAK,aAAa,EAClB,KAAK,eAAe,EACrB,MAAM,kBAAkB,CAAA;AAEzB,OAAO,EAAuB,qBAAqB,EAAE,MAAM,cAAc,CAAA;AAoBzE,MAAM,MAAM,gBAAgB,GAAG;IAC7B,WAAW,EAAE,qBAAqB,CAAA;IAClC,cAAc,EAAE,qBAAqB,CAAA;CACtC,CAAA;AAqBD,wBAAgB,mBAAmB,CAAC,KAAK,SAAY,GAAG,gBAAgB,CAMvE;AAED;;;;;GAKG;AACH,wBAAgB,mBAAmB,CACjC,GAAG,EAAE,MAAM,GAAG,SAAS,EACvB,cAAc,EAAE,MAAM,CAAC,eAAe,EAAE,aAAa,CAAC,GAAG,SAAS,GACjE,MAAM,GAAG,IAAI,CASf"}
+{"version":3,"file":"materials.d.ts","sourceRoot":"","sources":["../../src/ceiling/materials.ts"],"names":[],"mappings":"AAAA,OAAO,EAGL,KAAK,cAAc,EAInB,KAAK,aAAa,EAClB,KAAK,eAAe,EACrB,MAAM,kBAAkB,CAAA;AACzB,OAAO,EAA4C,KAAK,aAAa,EAAE,MAAM,oBAAoB,CAAA;AACjG,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,OAAO,CAAA;AAErC,OAAO,EAAuB,qBAAqB,EAAE,MAAM,cAAc,CAAA;AAmBzE,MAAM,MAAM,gBAAgB,GAAG;IAC7B,WAAW,EAAE,qBAAqB,CAAA;IAClC,cAAc,EAAE,QAAQ,CAAA;CACzB,CAAA;AAgBD,wBAAgB,mBAAmB,CACjC,KAAK,SAAY,EACjB,OAAO,GAAE,aAA0B,GAClC,gBAAgB,CAuBlB;AAED,sFAAsF;AACtF,wBAAgB,oBAAoB,CAClC,MAAM,EAAE,cAAc,GAAG,MAAM,GAAG,SAAS,EAC3C,cAAc,EAAE,MAAM,CAAC,eAAe,EAAE,aAAa,CAAC,GAAG,SAAS,EAClE,OAAO,EAAE,aAAa,GACrB,QAAQ,GAAG,IAAI,CA6BjB;AAED;;;;;GAKG;AACH,wBAAgB,mBAAmB,CACjC,GAAG,EAAE,MAAM,GAAG,SAAS,EACvB,cAAc,EAAE,MAAM,CAAC,eAAe,EAAE,aAAa,CAAC,GAAG,SAAS,GACjE,MAAM,GAAG,IAAI,CAiBf"}

package/dist/ceiling/materials.js

@@ -1,13 +1,13 @@
-import { getMaterialPresetByRef, parseMaterialRef, resolveMaterial, } from '@pascal-app/core';
+import { getCatalogMaterialById, getMaterialPresetByRef, parseMaterialColor, parseMaterialRef, resolveMaterial, } from '@pascal-app/core';
+import { createMaterial, createMaterialFromPreset } from '@pascal-app/viewer';
 import { float, mix, positionWorld, smoothstep } from 'three/tsl';
 import { BackSide, FrontSide, MeshBasicNodeMaterial } from 'three/webgpu';
 /**
  * Ceiling material builders, shared by the renderer (mesh appearance) and the
- * paint capability (hover preview). A ceiling is a flat tinted surface: the
- * underside (`bottom`, seen from inside the room, `BackSide`) is opaque, while
+ * paint capability (hover preview). The underside faces the room, while
  * the `top` carries a transparent TSL grid overlay used while placing /
- * selecting ceiling-hosted items. Both derive from a single colour, so slot
- * painting resolves a colour and rebuilds these — it never applies a PBR map.
+ * selecting ceiling-hosted items. Only the overlay reduces a finish to colour;
+ * the underside keeps its lighting, textures and physical properties.
  */
 const gridScale = 5;
 const gridX = positionWorld.x.mul(gridScale).fract();
@@ -17,7 +17,7 @@ const lineX = smoothstep(lineWidth, 0, gridX).add(smoothstep(1.0 - lineWidth, 1.
 const lineY = smoothstep(lineWidth, 0, gridY).add(smoothstep(1.0 - lineWidth, 1.0, gridY));
 const gridPattern = lineX.max(lineY);
 const gridOpacity = mix(float(0.2), float(0.6), gridPattern);
-function createCeilingMaterials(color = '#999999') {
+function createCeilingGrid(color) {
     const topMaterial = new MeshBasicNodeMaterial({
         color,
         transparent: true,
@@ -25,33 +25,67 @@ function createCeilingMaterials(color = '#999999') {
         side: FrontSide,
     });
     topMaterial.opacityNode = gridOpacity;
-    const bottomMaterial = new MeshBasicNodeMaterial({
-        color,
-        side: BackSide,
-    });
-    return { topMaterial, bottomMaterial };
+    return topMaterial;
+}
+const ceilingGridCache = new Map();
+export function getCeilingMaterials(color = '#999999', shading = 'rendered') {
+    let topMaterial = ceilingGridCache.get(color);
+    if (!topMaterial) {
+        topMaterial = createCeilingGrid(color);
+        ceilingGridCache.set(color, topMaterial);
+    }
+    return {
+        topMaterial,
+        bottomMaterial: createMaterial({
+            preset: 'custom',
+            properties: {
+                color,
+                roughness: 0.9,
+                metalness: 0,
+                opacity: 1,
+                transparent: false,
+                side: 'back',
+            },
+        }, shading),
+    };
 }
-const ceilingMaterialCache = new Map();
-export function getCeilingMaterials(color = '#999999') {
-    const cached = ceilingMaterialCache.get(color);
-    if (cached)
-        return cached;
-    const materials = createCeilingMaterials(color);
-    ceilingMaterialCache.set(color, materials);
-    return materials;
+/** Resolve through the shared caches, without mutating another surface's material. */
+export function resolveCeilingFinish(finish, sceneMaterials, shading) {
+    if (!finish)
+        return null;
+    if (typeof finish !== 'string') {
+        return createMaterial({ ...finish, properties: { ...resolveMaterial(finish), side: 'back' } }, shading);
+    }
+    const color = parseMaterialColor(finish);
+    if (color)
+        return resolveCeilingFinish({ properties: { ...resolveMaterial(), color } }, sceneMaterials, shading);
+    const parsed = parseMaterialRef(finish);
+    if (parsed?.kind === 'scene')
+        return resolveCeilingFinish(sceneMaterials?.[parsed.id]?.material, sceneMaterials, shading);
+    const preset = getMaterialPresetByRef(finish);
+    return preset
+        ? createMaterialFromPreset({ ...preset, mapProperties: { ...preset.mapProperties, side: BackSide } }, shading)
+        : null;
 }
 /**
  * Resolve a slot `MaterialRef` to a flat colour for the ceiling surface.
  * `library:` refs use the catalog preset's base colour; `scene:` refs use the
- * stored material's colour. Returns null for a dangling / unparseable ref so
+ * stored material's colour; a plain colour is itself. Returns null for a dangling / unparseable ref so
  * the caller falls back to its default.
  */
 export function ceilingColorFromRef(ref, sceneMaterials) {
+    const color = parseMaterialColor(ref);
+    if (color)
+        return color;
     const parsed = parseMaterialRef(ref);
     if (!parsed)
         return null;
     if (parsed.kind === 'library') {
-        return getMaterialPresetByRef(ref)?.mapProperties.color ?? null;
+        // A flat tint: the catalog's preview colour reads as the finish (a textured
+        // preset's map colour is often plain white).
+        return (getCatalogMaterialById(parsed.id)?.previewColor ??
+            getMaterialPresetByRef(ref)?.mapProperties.color ??
+            null);
     }
     const sceneMaterial = sceneMaterials?.[parsed.id];
     if (!sceneMaterial)

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

@@ -1 +1 @@
-{"version":3,"file":"move-tool.d.ts","sourceRoot":"","sources":["../../src/ceiling/move-tool.tsx"],"names":[],"mappings":"AAEA,OAAO,EAEL,KAAK,WAAW,EAWjB,MAAM,kBAAkB,CAAA;AAgFzB,eAAO,MAAM,eAAe,EAAE,KAAK,CAAC,EAAE,CAAC;IAAE,IAAI,EAAE,WAAW,CAAA;CAAE,CAwK3D,CAAA;AAiHD,eAAe,eAAe,CAAA"}
+{"version":3,"file":"move-tool.d.ts","sourceRoot":"","sources":["../../src/ceiling/move-tool.tsx"],"names":[],"mappings":"AAEA,OAAO,EAEL,KAAK,WAAW,EAWjB,MAAM,kBAAkB,CAAA;AAgFzB,eAAO,MAAM,eAAe,EAAE,KAAK,CAAC,EAAE,CAAC;IAAE,IAAI,EAAE,WAAW,CAAA;CAAE,CAwK3D,CAAA;eAiHc,eAAe"}

package/dist/ceiling/paint.d.ts

@@ -1,9 +1,3 @@
-/**
- * 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.
- */
-export declare const ceilingPaint: import("@pascal-app/core").PaintCapability;
+import { type PaintCapability } from '@pascal-app/core';
+export declare const ceilingPaint: PaintCapability;
 //# sourceMappingURL=paint.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"paint.d.ts","sourceRoot":"","sources":["../../src/ceiling/paint.ts"],"names":[],"mappings":"AAUA;;;;;;GAMG;AACH,eAAO,MAAM,YAAY,4CAwBvB,CAAA"}
+{"version":3,"file":"paint.d.ts","sourceRoot":"","sources":["../../src/ceiling/paint.ts"],"names":[],"mappings":"AAAA,OAAO,EASL,KAAK,eAAe,EAOrB,MAAM,kBAAkB,CAAA;AAgHzB,eAAO,MAAM,YAAY,EAAE,eAyB1B,CAAA"}

package/dist/ceiling/paint.js

@@ -1,32 +1,90 @@
-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, useScene, } from '@pascal-app/core';
+import { CEILING_REGION_MESH, useViewer } from '@pascal-app/viewer';
+import { createSlotPaintCapability, resolveSlotPaintMaterialRef } from '../shared/slot-paint.js';
+import { swapPreviewMaterial } from '../shared/swap-preview-material.js';
+import { getCeilingMaterials, resolveCeilingFinish } from './materials.js';
 /**
- * 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
+ * room-facing material 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 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 shading = useViewer.getState().shading;
+    const finish = resolveCeilingFinish(materialPreset ?? material, useScene.getState().materials, shading);
+    const erasing = material === undefined && materialPreset === undefined;
+    if (role === CEILING_SURFACE_ROLE) {
+        // Erasing shows the default the ceiling returns to.
+        const shown = finish ??
+            (erasing ? getCeilingMaterials(CEILING_SLOT_DEFAULT_COLOR, shading).bottomMaterial : 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, shown);
+    }
+    const region = regionMesh(mesh, role);
+    if (!region)
+        return null;
+    // An erased region shows the ceiling's own finish under it.
+    const preview = finish ? finish : 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 +93,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;eAEc,YAAY"}

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 { Fragment as _Fragment, jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
+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.js';
 /**
  * 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,12 +198,12 @@ 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
                                     : `Taller than this level (${formatLinearMeasurement(maxHeight, unit, metricNotation)} available). Raise the level height first.` }, preset.label));
-                        }) }), Number.isFinite(maxHeight) && (_jsxs("div", { className: "px-1 pb-1 text-[11px] text-muted-foreground", children: ["Limited by the level to ", formatLinearMeasurement(maxHeight, unit, metricNotation), " \u2014 raise the level height for a taller ceiling."] }))] }), _jsx(PanelSection, { title: "Info", children: _jsxs("div", { className: "flex items-center justify-between px-2 py-1 text-muted-foreground text-sm", children: [_jsx("span", { children: "Area" }), _jsxs("span", { className: "font-mono text-white", children: [area.toFixed(2), " m\u00B2"] })] }) }), _jsxs(PanelSection, { title: "Holes", children: [node.holes && node.holes.length > 0 ? (_jsx("div", { className: "flex flex-col gap-1 pb-2", children: node.holes.map((hole, index) => {
+                        }) }), Number.isFinite(maxHeight) && (_jsxs("div", { className: "px-1 pb-1 text-[11px] text-muted-foreground", children: ["Limited by the level to ", formatLinearMeasurement(maxHeight, unit, metricNotation), " \u2014 raise the level height for a taller ceiling."] }))] }), _jsx(PanelSection, { title: "Info", children: _jsxs("div", { className: "flex items-center justify-between px-2 py-1 text-muted-foreground text-sm", children: [_jsx("span", { children: "Area" }), _jsxs("span", { className: "font-mono text-foreground dark:text-white", children: [area.toFixed(2), " m\u00B2"] })] }) }), _jsxs(PanelSection, { title: "Holes", children: [node.holes && node.holes.length > 0 ? (_jsx("div", { className: "flex flex-col gap-1 pb-2", children: node.holes.map((hole, index) => {
                             const holeArea = calculateArea(hole);
                             const isEditing = editingHole?.nodeId === selectedId && editingHole?.holeIndex === index;
                             const source = node.holeMetadata?.[index]?.source ?? 'manual';
@@ -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-foreground dark: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-black/4 dark: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-black/4 dark:bg-[#2C2C2E] text-muted-foreground hover:bg-black/8 dark: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-600 dark:text-red-400 hover:bg-red-500/20 hover:text-red-700 dark: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/parametrics.d.ts

@@ -1,5 +1,5 @@
 import type { ParametricDescriptor } from '@pascal-app/core';
-import type { CeilingNode } from './schema';
+import type { CeilingNode } from './schema.js';
 /**
  * Inspector descriptor for ceiling.
  *

package/dist/ceiling/parametrics.js

@@ -12,5 +12,5 @@ export const ceilingParametrics = {
             fields: [{ key: 'height', kind: 'number', unit: 'm', min: 0.1, max: 1000, step: 0.05 }],
         },
     ],
-    customPanel: () => import('./panel'),
+    customPanel: () => import('./panel.js'),
 };

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,EAOjB,MAAM,kBAAkB,CAAA;AAoBzB,eAAO,MAAM,eAAe,aAAc;IAAE,IAAI,EAAE,WAAW,CAAA;CAAE,gCAiJ9D,CAAA;eAEc,eAAe"}