@pascal-app/nodes 1.0.1 → 1.0.4

package/dist/item/model-loader.js

@@ -1,8 +1,14 @@
 import { DefaultLoadingManager, Group, LoadingManager } from 'three';
+import { MeshoptDecoder } from 'three/examples/jsm/libs/meshopt_decoder.module.js';
 import { GLTFLoader } from 'three/examples/jsm/loaders/GLTFLoader.js';
 const ITEM_ASSET_UNAVAILABLE_KEY = 'pascalItemAssetUnavailable';
 const DEFAULT_RETRY_DELAYS_MS = [1_000, 3_000];
 const itemLoadGenerations = new Map();
+const pendingItemModelLoads = new WeakMap();
+/** Active item transactions on this host manager, including their retry waits. */
+export function getPendingItemModelLoadCount(manager = DefaultLoadingManager) {
+    return pendingItemModelLoads.get(manager) ?? 0;
+}
 export function classifyItemModelLoadFailure(error) {
     if (!(error instanceof Error))
         return 'unexpected';
@@ -53,6 +59,7 @@ export class ItemGLTFLoader extends GLTFLoader {
     retryDelaysMs;
     constructor(manager, retryDelaysMs = DEFAULT_RETRY_DELAYS_MS) {
         super(new LoadingManager());
+        this.setMeshoptDecoder(MeshoptDecoder);
         this.hostManager = manager ?? DefaultLoadingManager;
         this.retryDelaysMs = retryDelaysMs;
     }
@@ -61,11 +68,15 @@ export class ItemGLTFLoader extends GLTFLoader {
         let retryCount = 0;
         let finished = false;
         const wasCancelled = () => (itemLoadGenerations.get(url) ?? 0) !== generation;
+        const end = () => {
+            pendingItemModelLoads.set(this.hostManager, getPendingItemModelLoadCount(this.hostManager) - 1);
+            this.hostManager.itemEnd(url);
+        };
         const cancel = () => {
             if (finished)
                 return;
             finished = true;
-            this.hostManager.itemEnd(url);
+            end();
         };
         const complete = (gltf) => {
             if (finished)
@@ -79,7 +90,7 @@ export class ItemGLTFLoader extends GLTFLoader {
                 onLoad(gltf);
             }
             finally {
-                this.hostManager.itemEnd(url);
+                end();
             }
         };
         const fail = (error) => {
@@ -97,8 +108,12 @@ export class ItemGLTFLoader extends GLTFLoader {
                     console.error(error);
             }
             finally {
-                this.hostManager.itemError(url);
-                this.hostManager.itemEnd(url);
+                try {
+                    this.hostManager.itemError(url);
+                }
+                finally {
+                    end();
+                }
             }
         };
         const attempt = () => {
@@ -106,26 +121,43 @@ export class ItemGLTFLoader extends GLTFLoader {
                 cancel();
                 return;
             }
-            super.load(url, complete, onProgress, (error) => {
-                if (wasCancelled()) {
-                    cancel();
-                    return;
-                }
-                const kind = classifyItemModelLoadFailure(error);
-                if (kind === 'unexpected') {
-                    fail(error);
-                    return;
-                }
-                if (kind === 'unavailable' || retryCount >= this.retryDelaysMs.length) {
-                    complete(createUnavailableItemGltf(url, error));
-                    return;
-                }
-                const delay = this.retryDelaysMs[retryCount] ?? 0;
-                retryCount += 1;
-                setTimeout(attempt, delay);
-            });
+            try {
+                super.load(url, complete, onProgress, (error) => {
+                    if (finished)
+                        return;
+                    if (wasCancelled()) {
+                        cancel();
+                        return;
+                    }
+                    const kind = classifyItemModelLoadFailure(error);
+                    if (kind === 'unexpected') {
+                        fail(error);
+                        return;
+                    }
+                    if (kind === 'unavailable' || retryCount >= this.retryDelaysMs.length) {
+                        complete(createUnavailableItemGltf(url, error));
+                        return;
+                    }
+                    const delay = this.retryDelaysMs[retryCount] ?? 0;
+                    retryCount += 1;
+                    setTimeout(attempt, delay);
+                });
+            }
+            catch (error) {
+                if (finished)
+                    throw error;
+                fail(error);
+            }
         };
-        this.hostManager.itemStart(url);
+        pendingItemModelLoads.set(this.hostManager, getPendingItemModelLoadCount(this.hostManager) + 1);
+        try {
+            this.hostManager.itemStart(url);
+        }
+        catch (error) {
+            finished = true;
+            end();
+            throw error;
+        }
         attempt();
     }
 }

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

@@ -26,7 +26,7 @@ import { type PlacementState } from '@pascal-app/editor';
  * and dropped from editor.
  */
 export declare function getInitialState(node: ItemNode, parent?: AnyNode | undefined): PlacementState;
-export declare function MoveItemTool({ node }: {
+export declare function MoveItemTool({ node: source }: {
     node: ItemNode;
 }): import("react").JSX.Element;
 export default MoveItemTool;

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

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

package/dist/item/move-tool.js

@@ -1,7 +1,8 @@
 'use client';
 import { Fragment as _Fragment, jsx as _jsx } from "react/jsx-runtime";
-import { useScene } from '@pascal-app/core';
+import { canHostSurfaceChild, useScene, } from '@pascal-app/core';
 import { triggerSFX, useDraftNode, useEditor, usePlacementCoordinator, } from '@pascal-app/editor';
+import { useMemo } from 'react';
 import { Vector3 } from 'three';
 /**
  * Phase 5 Stage D — item's registry-driven 3D move affordance.
@@ -78,7 +79,10 @@ export function getInitialState(node, parent = node.parentId
     // handler — which preserves the grab offset — instead of a fresh `enter()`
     // that snaps the item's origin under the cursor. Without this the item
     // teleports the instant it's grabbed.
-    if (parent?.type === 'item' || parent?.type === 'cabinet' || parent?.type === 'procedural-item') {
+    if (parent?.type === 'item' ||
+        parent?.type === 'cabinet' ||
+        parent?.type === 'procedural-item' ||
+        (parent && parent.type !== 'shelf' && canHostSurfaceChild(parent, node.type, node.id))) {
         return {
             surface: 'item-surface',
             wallId: null,
@@ -107,20 +111,24 @@ export function getInitialState(node, parent = node.parentId
         shelfId: null,
     };
 }
-export function MoveItemTool({ node }) {
+export function MoveItemTool({ node: source }) {
+    const node = useMemo(() => source.metadata?.isNew
+        ? (useScene.getState().nodes[source.id] ?? source)
+        : source, [source]);
     const draftNode = useDraftNode();
     const meta = typeof node.metadata === 'object' && node.metadata !== null
         ? node.metadata
         : {};
     const isNew = !!meta.isNew;
+    const isSceneDraft = useMemo(() => isNew && !!useScene.getState().nodes[node.id], [isNew, node.id]);
     const cursor = usePlacementCoordinator({
         asset: node.asset,
         draftNode,
-        // Carry painted slot overrides onto the duplicate's draft (wall/ceiling
-        // items create their draft lazily inside the coordinator).
-        slots: node.slots,
+        // The duplicate's draft keeps the item's painted slots and collections
+        // (wall/ceiling items create their draft lazily inside the coordinator).
+        copied: node,
         // Duplicates start fresh in floor mode; wall/ceiling draft is created lazily by ensureDraft.
-        initialState: isNew
+        initialState: isNew && !isSceneDraft
             ? {
                 surface: 'floor',
                 wallId: null,
@@ -132,19 +140,19 @@ export function MoveItemTool({ node }) {
             : getInitialState(node),
         // Preserve the original item's scale so Y-position calculations use the correct height.
         defaultScale: isNew ? node.scale : undefined,
-        preserveDragOffset: true,
+        preserveDragOffset: !isSceneDraft,
         initDraft: (gridPosition) => {
-            if (isNew) {
+            if (isNew && !isSceneDraft) {
                 // Duplicate: floor items get a draft immediately; wall/ceiling
                 // items are created lazily on surface entry.
                 gridPosition.copy(new Vector3(...node.position));
                 if (!node.asset.attachTo) {
-                    draftNode.create(gridPosition, node.asset, node.rotation, node.scale, node.slots);
+                    draftNode.create(gridPosition, node.asset, node.rotation, node.scale, node);
                 }
             }
             else {
                 draftNode.adopt(node);
-                gridPosition.copy(new Vector3(...node.position));
+                gridPosition.copy(new Vector3(...draftNode.current.position));
             }
         },
         onCommitted: () => {

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

@@ -1 +1 @@
-{"version":3,"file":"paint.d.ts","sourceRoot":"","sources":["../../src/item/paint.ts"],"names":[],"mappings":"AAAA,OAAO,EAML,KAAK,eAAe,EAMrB,MAAM,kBAAkB,CAAA;AA+NzB,eAAO,MAAM,SAAS,EAAE,eAoBvB,CAAA"}
+{"version":3,"file":"paint.d.ts","sourceRoot":"","sources":["../../src/item/paint.ts"],"names":[],"mappings":"AAAA,OAAO,EAML,KAAK,eAAe,EAOrB,MAAM,kBAAkB,CAAA;AAwNzB,eAAO,MAAM,SAAS,EAAE,eAWvB,CAAA"}

package/dist/item/paint.js

@@ -1,5 +1,6 @@
-import { generateSceneMaterialId, parseMaterialRef, toSceneMaterialRef, useScene, } from '@pascal-app/core';
+import { generateSceneMaterialId, parseMaterialRef, slotPaintMaterial, toSceneMaterialRef, useScene, } from '@pascal-app/core';
 import { createMaterial, createMaterialFromPresetRef, useViewer } from '@pascal-app/viewer';
+import { swapPreviewMaterial } from '../shared/swap-preview-material';
 function deepEqual(a, b) {
     if (Object.is(a, b))
         return true;
@@ -159,7 +160,6 @@ function applyItemPreview(role, root, material, materialPreset) {
         if (Array.isArray(tag)) {
             const current = mesh.material;
             if (Array.isArray(current)) {
-                const previousArray = [...current];
                 const nextArray = [...current];
                 let changed = false;
                 for (let index = 0; index < tag.length; index += 1) {
@@ -170,20 +170,13 @@ function applyItemPreview(role, root, material, materialPreset) {
                 }
                 if (!changed)
                     return;
-                mesh.material = nextArray;
-                restores.push(() => {
-                    mesh.material = previousArray;
-                });
+                restores.push(swapPreviewMaterial(mesh, nextArray));
                 return;
             }
             if (tag[0] !== role)
                 return;
         }
-        const previous = mesh.material;
-        mesh.material = previewMaterial;
-        restores.push(() => {
-            mesh.material = previous;
-        });
+        restores.push(swapPreviewMaterial(mesh, previewMaterial));
     });
     if (restores.length === 0)
         return null;
@@ -198,17 +191,5 @@ export const itemPaint = {
     buildPatch: ({ node, role, material, materialPreset }) => buildItemSlotsPatch(node, role, material, materialPreset),
     commit: ({ node, role, material, materialPreset }) => commitItemPaint(node, role, material, materialPreset),
     applyPreview: ({ role, root, material, materialPreset }) => applyItemPreview(role, root, material, materialPreset),
-    getEffectiveMaterial: ({ node, role }) => {
-        const ref = node.slots?.[role];
-        const parsed = parseMaterialRef(ref);
-        if (!parsed)
-            return null;
-        if (parsed.kind === 'library') {
-            return { material: undefined, materialPreset: ref };
-        }
-        const sceneMaterial = useScene.getState().materials[parsed.id];
-        if (!sceneMaterial)
-            return null;
-        return { material: sceneMaterial.material, materialPreset: undefined };
-    },
+    getEffectiveMaterial: ({ node, role }) => slotPaintMaterial(node.slots?.[role], useScene.getState().materials),
 };

package/dist/item/panel.d.ts

@@ -2,9 +2,7 @@
  * Stage E inspector for item. 1:1 port of the legacy
  * `editor/components/ui/panels/item-panel.tsx`, relocated into the
  * kind's folder so `parametrics.customPanel` mounts it through the
- * registry inspector. The catalog popover (`<CollectionsPopover>`) is
- * the only kind-specific UI that can't be expressed via the generic
- * auto-inspector today — kept inline.
+ * registry inspector.
  *
  * Slider-drag fix recipe applied: scale / position / rotation slider
  * `onChange` callbacks read from a `useRef(node)` instead of the

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

@@ -1 +1 @@
-{"version":3,"file":"panel.d.ts","sourceRoot":"","sources":["../../src/item/panel.tsx"],"names":[],"mappings":"AAiBA;;;;;;;;;;;;;GAaG;AACH,MAAM,CAAC,OAAO,UAAU,SAAS,uCAwShC"}
+{"version":3,"file":"panel.d.ts","sourceRoot":"","sources":["../../src/item/panel.tsx"],"names":[],"mappings":"AAyBA;;;;;;;;;;;GAWG;AACH,MAAM,CAAC,OAAO,UAAU,SAAS,uCAiShC"}

package/dist/item/panel.js

@@ -1,17 +1,16 @@
 'use client';
-import { jsx as _jsx, Fragment as _Fragment, jsxs as _jsxs } from "react/jsx-runtime";
-import { getScaledDimensions, ItemNode, useScene } from '@pascal-app/core';
-import { ActionButton, ActionGroup, CollectionsPopover, PanelSection, PanelWrapper, SliderControl, triggerSFX, useEditor, } from '@pascal-app/editor';
+import { jsx as _jsx, jsxs as _jsxs, Fragment as _Fragment } from "react/jsx-runtime";
+import { getScaledDimensions, scriptImages, useScene, } from '@pascal-app/core';
+import { ActionButton, ActionGroup, duplicateNodeAndPickUp, PanelSection, PanelWrapper, SliderControl, triggerSFX, useEditor, usePlacementNotice, } from '@pascal-app/editor';
 import { useViewer } from '@pascal-app/viewer';
 import { Copy, Link, Link2Off, Move, Trash2 } from 'lucide-react';
 import { useCallback, useRef, useState } from 'react';
+import { AuthoredParams } from './authored-params';
 /**
  * Stage E inspector for item. 1:1 port of the legacy
  * `editor/components/ui/panels/item-panel.tsx`, relocated into the
  * kind's folder so `parametrics.customPanel` mounts it through the
- * registry inspector. The catalog popover (`<CollectionsPopover>`) is
- * the only kind-specific UI that can't be expressed via the generic
- * auto-inspector today — kept inline.
+ * registry inspector.
  *
  * Slider-drag fix recipe applied: scale / position / rotation slider
  * `onChange` callbacks read from a `useRef(node)` instead of the
@@ -25,6 +24,7 @@ export default function ItemPanel() {
     const deleteNode = useScene((s) => s.deleteNode);
     const setMovingNode = useEditor((s) => s.setMovingNode);
     const node = useScene((s) => selectedId ? s.nodes[selectedId] : undefined);
+    const fitWarning = usePlacementNotice(selectedId);
     const [uniformScale, setUniformScale] = useState(true);
     const nodeRef = useRef(node);
     nodeRef.current = node;
@@ -54,21 +54,9 @@ export default function ItemPanel() {
         }
     }, [node, setMovingNode, setSelection]);
     const handleDuplicate = useCallback(() => {
-        if (!node)
-            return;
-        triggerSFX('sfx:item-pick');
-        const proto = ItemNode.parse({
-            position: [...node.position],
-            rotation: [...node.rotation],
-            name: node.name,
-            asset: node.asset,
-            parentId: node.parentId,
-            side: node.side,
-            metadata: { isNew: true },
-        });
-        setMovingNode(proto);
-        setSelection({ selectedIds: [] });
-    }, [node, setMovingNode, setSelection]);
+        if (node)
+            duplicateNodeAndPickUp(node);
+    }, [node]);
     const handleDelete = useCallback(() => {
         if (!selectedId)
             return;
@@ -78,10 +66,10 @@ export default function ItemPanel() {
     }, [selectedId, deleteNode, setSelection]);
     if (!(node && node.type === 'item' && selectedId))
         return null;
-    return (_jsxs(PanelWrapper, { icon: node.asset.thumbnail || '/icons/item.webp', onClose: handleClose, title: node.name || node.asset.name, width: 300, children: [_jsxs(PanelSection, { title: "Position", children: [_jsx(SliderControl, { label: _jsxs(_Fragment, { children: ["X", _jsx("sub", { className: "ml-[1px] text-[11px] opacity-70", children: "pos" })] }), max: node.position[0] + 2, min: node.position[0] - 2, onChange: (value) => handleUpdate({ position: [value, node.position[1], node.position[2]] }), precision: 2, step: 0.01, unit: "m", value: node.position[0] }), _jsx(SliderControl, { label: _jsxs(_Fragment, { children: ["Y", _jsx("sub", { className: "ml-[1px] text-[11px] opacity-70", children: "pos" })] }), max: node.position[1] + 2, min: node.position[1] - 2, onChange: (value) => handleUpdate({ position: [node.position[0], value, node.position[2]] }), precision: 2, step: 0.01, unit: "m", value: node.position[1] }), _jsx(SliderControl, { label: _jsxs(_Fragment, { children: ["Z", _jsx("sub", { className: "ml-[1px] text-[11px] opacity-70", children: "pos" })] }), max: node.position[2] + 2, min: node.position[2] - 2, onChange: (value) => handleUpdate({ position: [node.position[0], node.position[1], value] }), precision: 2, step: 0.01, unit: "m", value: node.position[2] })] }), _jsxs(PanelSection, { title: "Rotation", children: [_jsx(SliderControl, { label: _jsxs(_Fragment, { children: ["Y", _jsx("sub", { className: "ml-[1px] text-[11px] opacity-70", children: "rot" })] }), max: Math.round((node.rotation[1] * 180) / Math.PI) + 45, min: Math.round((node.rotation[1] * 180) / Math.PI) - 45, onChange: (degrees) => {
+    return (_jsxs(PanelWrapper, { icon: scriptImages(node)?.thumbnail ?? (node.asset.thumbnail || '/icons/item.webp'), onClose: handleClose, title: node.name || node.asset.name, width: 300, children: [fitWarning && (_jsxs("div", { className: "mx-1 mb-1 flex gap-2 rounded-lg bg-amber-400/10 px-3 py-2 text-xs", children: [_jsx("span", { className: "font-semibold text-amber-400", children: "!" }), _jsxs("div", { className: "flex flex-col gap-0.5", children: [_jsx("span", { className: "font-medium text-foreground", children: fitWarning.line }), fitWarning.detail && (_jsx("span", { className: "text-muted-foreground", children: fitWarning.detail }))] })] })), _jsx(AuthoredParams, { node: node }), _jsxs(PanelSection, { title: "Position", children: [_jsx(SliderControl, { label: _jsxs(_Fragment, { children: ["X", _jsx("sub", { className: "ml-[1px] text-[11px] opacity-70", children: "pos" })] }), max: node.position[0] + 2, min: node.position[0] - 2, onChange: (value) => handleUpdate({ position: [value, node.position[1], node.position[2]] }), precision: 2, step: 0.01, unit: "m", value: node.position[0] }), _jsx(SliderControl, { label: _jsxs(_Fragment, { children: ["Y", _jsx("sub", { className: "ml-[1px] text-[11px] opacity-70", children: "pos" })] }), max: node.position[1] + 2, min: node.position[1] - 2, onChange: (value) => handleUpdate({ position: [node.position[0], value, node.position[2]] }), precision: 2, step: 0.01, unit: "m", value: node.position[1] }), _jsx(SliderControl, { label: _jsxs(_Fragment, { children: ["Z", _jsx("sub", { className: "ml-[1px] text-[11px] opacity-70", children: "pos" })] }), max: node.position[2] + 2, min: node.position[2] - 2, onChange: (value) => handleUpdate({ position: [node.position[0], node.position[1], value] }), precision: 2, step: 0.01, unit: "m", value: node.position[2] })] }), _jsxs(PanelSection, { title: "Rotation", children: [_jsx(TiltSlider, { axis: 0, label: "X", node: node, onUpdate: handleUpdate }), _jsx(SliderControl, { label: _jsxs(_Fragment, { children: ["Y", _jsx("sub", { className: "ml-[1px] text-[11px] opacity-70", children: "rot" })] }), max: Math.round((node.rotation[1] * 180) / Math.PI) + 45, min: Math.round((node.rotation[1] * 180) / Math.PI) - 45, onChange: (degrees) => {
                             const radians = (degrees * Math.PI) / 180;
                             handleUpdate({ rotation: [node.rotation[0], radians, node.rotation[2]] });
-                        }, precision: 0, step: 1, unit: "\u00B0", value: Math.round((node.rotation[1] * 180) / Math.PI) }), _jsxs("div", { className: "flex gap-1.5 px-1 pt-2 pb-1", children: [_jsx(ActionButton, { label: "-45\u00B0", onClick: () => {
+                        }, precision: 0, step: 1, unit: "\u00B0", value: Math.round((node.rotation[1] * 180) / Math.PI) }), _jsx(TiltSlider, { axis: 2, label: "Z", node: node, onUpdate: handleUpdate }), _jsxs("div", { className: "flex gap-1.5 px-1 pt-2 pb-1", children: [_jsx(ActionButton, { label: "-45\u00B0", onClick: () => {
                                     triggerSFX('sfx:item-rotate');
                                     const currentDegrees = (node.rotation[1] * 180) / Math.PI;
                                     const radians = ((currentDegrees - 45) * Math.PI) / 180;
@@ -99,5 +87,13 @@ export default function ItemPanel() {
                         }, precision: 2, step: 0.1, value: Math.round(node.scale[0] * 100) / 100 })) : (_jsxs(_Fragment, { children: [_jsx(SliderControl, { label: _jsxs(_Fragment, { children: ["X", _jsx("sub", { className: "ml-[1px] text-[11px] opacity-70", children: "scale" })] }), max: 10, min: 0.01, onChange: (value) => handleUpdate({ scale: [Math.max(0.01, value), node.scale[1], node.scale[2]] }), precision: 2, step: 0.1, value: Math.round(node.scale[0] * 100) / 100 }), _jsx(SliderControl, { label: _jsxs(_Fragment, { children: ["Y", _jsx("sub", { className: "ml-[1px] text-[11px] opacity-70", children: "scale" })] }), max: 10, min: 0.01, onChange: (value) => handleUpdate({ scale: [node.scale[0], Math.max(0.01, value), node.scale[2]] }), precision: 2, step: 0.1, value: Math.round(node.scale[1] * 100) / 100 }), _jsx(SliderControl, { label: _jsxs(_Fragment, { children: ["Z", _jsx("sub", { className: "ml-[1px] text-[11px] opacity-70", children: "scale" })] }), max: 10, min: 0.01, onChange: (value) => handleUpdate({ scale: [node.scale[0], node.scale[1], Math.max(0.01, value)] }), precision: 2, step: 0.1, value: Math.round(node.scale[2] * 100) / 100 })] }))] }), _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: "Dimensions" }), (() => {
                             const [w, h, d] = getScaledDimensions(node);
                             return (_jsxs("span", { className: "font-mono text-white", children: [Math.round(w * 100) / 100, "\u00D7", Math.round(h * 100) / 100, "\u00D7", Math.round(d * 100) / 100] }));
-                        })()] }) }), _jsx(PanelSection, { title: "Collections", children: _jsx(ActionGroup, { children: _jsx(CollectionsPopover, { collectionIds: node.collectionIds, nodeId: selectedId, children: _jsx(ActionButton, { label: "Manage collections\u2026" }) }) }) }), _jsx(PanelSection, { title: "Actions", children: _jsxs(ActionGroup, { children: [_jsx(ActionButton, { icon: _jsx(Move, { className: "h-3.5 w-3.5" }), label: "Move", onClick: handleMove }), _jsx(ActionButton, { icon: _jsx(Copy, { className: "h-3.5 w-3.5" }), label: "Duplicate", onClick: handleDuplicate }), _jsx(ActionButton, { className: "hover:bg-red-500/20", icon: _jsx(Trash2, { className: "h-3.5 w-3.5 text-red-400" }), label: "Delete", onClick: handleDelete })] }) })] }));
+                        })()] }) }), _jsx(PanelSection, { title: "Actions", children: _jsxs(ActionGroup, { children: [_jsx(ActionButton, { icon: _jsx(Move, { className: "h-3.5 w-3.5" }), label: "Move", onClick: handleMove }), _jsx(ActionButton, { icon: _jsx(Copy, { className: "h-3.5 w-3.5" }), label: "Duplicate", onClick: handleDuplicate }), _jsx(ActionButton, { className: "hover:bg-red-500/20", icon: _jsx(Trash2, { className: "h-3.5 w-3.5 text-red-400" }), label: "Delete", onClick: handleDelete })] }) })] }));
+}
+/** Tilt about X or Z: aiming a spotlight, leaning a frame. Y stays the main turn above. */
+function TiltSlider({ axis, label, node, onUpdate, }) {
+    return (_jsx(SliderControl, { label: _jsxs(_Fragment, { children: [label, _jsx("sub", { className: "ml-[1px] text-[11px] opacity-70", children: "rot" })] }), max: 180, min: -180, onChange: (degrees) => {
+            const rotation = [...node.rotation];
+            rotation[axis] = (degrees * Math.PI) / 180;
+            onUpdate({ rotation });
+        }, precision: 0, step: 1, unit: "\u00B0", value: Math.round((node.rotation[axis] * 180) / Math.PI) }));
 }

package/dist/item/placement-notice.d.ts

@@ -0,0 +1,14 @@
+import { type AnyNode, type ItemNode, type LiveTransformLike, type PlacementNotice } from '@pascal-app/core';
+import { type FloorItemMisfit } from '@pascal-app/core/building';
+/** What a person reads for a floor item that does not fit: in a door's way, or too large for its room. */
+export declare function floorItemMisfitNotice(misfit: FloorItemMisfit, dimensions: readonly number[]): PlacementNotice;
+/**
+ * The item's `placementNotice`: a floor item in a door's way or too large for its room, by the
+ * check place_items refuses with (`floorItemFit`), at its live pose while it is placed or moved.
+ * An item on a table, a shelf or a wall is not checked.
+ */
+export declare function itemPlacementNotice(node: ItemNode, { nodes, live }: {
+    nodes: Readonly<Record<string, AnyNode>>;
+    live?: LiveTransformLike;
+}): PlacementNotice | null;
+//# sourceMappingURL=placement-notice.d.ts.map

package/dist/item/placement-notice.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"placement-notice.d.ts","sourceRoot":"","sources":["../../src/item/placement-notice.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,KAAK,OAAO,EAEZ,KAAK,QAAQ,EACb,KAAK,iBAAiB,EACtB,KAAK,eAAe,EACrB,MAAM,kBAAkB,CAAA;AACzB,OAAO,EAAE,KAAK,eAAe,EAAgB,MAAM,2BAA2B,CAAA;AAI9E,0GAA0G;AAC1G,wBAAgB,qBAAqB,CACnC,MAAM,EAAE,eAAe,EACvB,UAAU,EAAE,SAAS,MAAM,EAAE,GAC5B,eAAe,CAQjB;AAED;;;;GAIG;AACH,wBAAgB,mBAAmB,CACjC,IAAI,EAAE,QAAQ,EACd,EAAE,KAAK,EAAE,IAAI,EAAE,EAAE;IAAE,KAAK,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAAC;IAAC,IAAI,CAAC,EAAE,iBAAiB,CAAA;CAAE,GACtF,eAAe,GAAG,IAAI,CAkBxB"}

package/dist/item/placement-notice.js

@@ -0,0 +1,38 @@
+import { getScaledDimensions, } from '@pascal-app/core';
+import { floorItemFit } from '@pascal-app/core/building';
+const round = (value) => Math.round(value * 100) / 100;
+/** What a person reads for a floor item that does not fit: in a door's way, or too large for its room. */
+export function floorItemMisfitNotice(misfit, dimensions) {
+    const name = misfit.room?.name.trim();
+    if (misfit.code === 'blocks_door')
+        return { line: name ? `Blocks the door to ${name}` : 'Blocks a door' };
+    return {
+        line: name ? `Too large for ${name}` : 'Too large for its room',
+        detail: `${round(dimensions[0] ?? 0)} × ${round(dimensions[2] ?? 0)} m in a ${round(misfit.room.width)} × ${round(misfit.room.depth)} m room`,
+    };
+}
+/**
+ * The item's `placementNotice`: a floor item in a door's way or too large for its room, by the
+ * check place_items refuses with (`floorItemFit`), at its live pose while it is placed or moved.
+ * An item on a table, a shelf or a wall is not checked.
+ */
+export function itemPlacementNotice(node, { nodes, live }) {
+    if (!node.parentId || nodes[node.parentId]?.type !== 'level')
+        return null;
+    const item = live
+        ? {
+            ...node,
+            position: live.position,
+            rotation: [node.rotation[0], live.rotation, node.rotation[2]],
+        }
+        : node;
+    const dimensions = getScaledDimensions(item);
+    const misfit = floorItemFit(nodes, {
+        levelId: node.parentId,
+        x: item.position[0],
+        z: item.position[2],
+        rotationDeg: ((item.rotation?.[1] ?? 0) * 180) / Math.PI,
+        dimensions,
+    });
+    return misfit ? floorItemMisfitNotice(misfit, dimensions) : null;
+}

package/dist/item/plan-symbols.d.ts

@@ -0,0 +1,67 @@
+import type { FloorplanGeometry, FloorplanPoint } from '@pascal-app/core';
+/**
+ * PERMIT-SET PLAN SYMBOLS for items — what a sheet draws instead of the
+ * asset's raster sprite: real fixtures (sinks …) with fixture labels, as a
+ * full plan set shows them.
+ *
+ * A plans examiner reads plumbing fixtures and appliances off the floor plan,
+ * so those draw as crisp linework at true size with the standard label (WC,
+ * LAV, TUB, SHWR, W, D, WH, REF, R, DW …). Furniture is thin light-grey
+ * outline, a car a light dashed outline, and ceiling-mounted items, wall
+ * devices and decor are left off — the lights go on the electrical plan.
+ *
+ * Symbols are built in the item's LOCAL plan frame, true size: x across the
+ * width, y along the depth, the BACK (the wall it stands against) at
+ * y = -depth / 2 and the front at +depth / 2. The caller maps the points.
+ */
+/**
+ * Metadata key on a drafted item's group naming what it is (`fixture`,
+ * `furniture`, `car`) — how a sheet tells a WC it must keep text off from a
+ * bed it may overlap, without re-classifying the asset itself.
+ */
+export declare const PLAN_SYMBOL_METADATA_KEY = "pascal:sheet/plan-symbol";
+export type PlanFixtureKind = 'wc' | 'lav' | 'tub' | 'shower' | 'washer' | 'dryer' | 'washer-dryer' | 'water-heater' | 'ref' | 'range' | 'cooktop' | 'oven' | 'dw' | 'mw' | 'sink' | 'fireplace' | 'ev' | 'condenser';
+export type PlanItemClass = {
+    kind: 'fixture';
+    fixture: PlanFixtureKind;
+    label: string;
+} | {
+    kind: 'casework';
+} | {
+    kind: 'car';
+} | {
+    kind: 'furniture';
+    shape: 'bed' | 'sofa' | 'plain';
+} | {
+    kind: 'omit';
+};
+type AssetLike = {
+    id?: string;
+    name?: string;
+    category?: string;
+    tags?: readonly string[];
+    attachTo?: string;
+};
+/** What a sheet draws for an item, from its asset. */
+export declare function classifyPlanItem(asset: AssetLike): PlanItemClass;
+/** Fixture linework — the weight casework draws in, near-black. */
+export declare const FIXTURE_STROKE = "#1f2937";
+export declare const FIXTURE_STROKE_WIDTH = 0.012;
+/** Furniture: thin, light grey — present, never competing with the walls. */
+export declare const FURNITURE_STROKE = "#9ca3af";
+export declare const FURNITURE_STROKE_WIDTH = 0.006;
+/** Fixture label size on the paper, points, and its plan-metre size at 1/4" = 1'-0". */
+export declare const FIXTURE_LABEL_PT = 6.5;
+export declare const FIXTURE_LABEL_SIZE = 0.11;
+export type PlanSymbolFrame = {
+    /** Local (x across, y along the depth; back = -depth / 2) → plan point. */
+    map: (x: number, y: number) => FloorplanPoint;
+    width: number;
+    depth: number;
+};
+/**
+ * The drafting symbol for an item, in plan coordinates. Empty for `omit`.
+ */
+export declare function buildPlanItemSymbol(cls: PlanItemClass, frame: PlanSymbolFrame): FloorplanGeometry[];
+export {};
+//# sourceMappingURL=plan-symbols.d.ts.map

package/dist/item/plan-symbols.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"plan-symbols.d.ts","sourceRoot":"","sources":["../../src/item/plan-symbols.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,iBAAiB,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAA;AAGzE;;;;;;;;;;;;;;GAcG;AAEH;;;;GAIG;AACH,eAAO,MAAM,wBAAwB,6BAA6B,CAAA;AAElE,MAAM,MAAM,eAAe,GACvB,IAAI,GACJ,KAAK,GACL,KAAK,GACL,QAAQ,GACR,QAAQ,GACR,OAAO,GACP,cAAc,GACd,cAAc,GACd,KAAK,GACL,OAAO,GACP,SAAS,GACT,MAAM,GACN,IAAI,GACJ,IAAI,GACJ,MAAM,GACN,WAAW,GACX,IAAI,GACJ,WAAW,CAAA;AAEf,MAAM,MAAM,aAAa,GACrB;IAAE,IAAI,EAAE,SAAS,CAAC;IAAC,OAAO,EAAE,eAAe,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAE,GAC5D;IAAE,IAAI,EAAE,UAAU,CAAA;CAAE,GACpB;IAAE,IAAI,EAAE,KAAK,CAAA;CAAE,GACf;IAAE,IAAI,EAAE,WAAW,CAAC;IAAC,KAAK,EAAE,KAAK,GAAG,MAAM,GAAG,OAAO,CAAA;CAAE,GACtD;IAAE,IAAI,EAAE,MAAM,CAAA;CAAE,CAAA;AAEpB,KAAK,SAAS,GAAG;IACf,EAAE,CAAC,EAAE,MAAM,CAAA;IACX,IAAI,CAAC,EAAE,MAAM,CAAA;IACb,QAAQ,CAAC,EAAE,MAAM,CAAA;IACjB,IAAI,CAAC,EAAE,SAAS,MAAM,EAAE,CAAA;IACxB,QAAQ,CAAC,EAAE,MAAM,CAAA;CAClB,CAAA;AA4CD,sDAAsD;AACtD,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,SAAS,GAAG,aAAa,CA2BhE;AAID,mEAAmE;AACnE,eAAO,MAAM,cAAc,YAAY,CAAA;AACvC,eAAO,MAAM,oBAAoB,QAAQ,CAAA;AAEzC,6EAA6E;AAC7E,eAAO,MAAM,gBAAgB,YAAY,CAAA;AACzC,eAAO,MAAM,sBAAsB,QAAQ,CAAA;AAE3C,wFAAwF;AACxF,eAAO,MAAM,gBAAgB,MAAM,CAAA;AACnC,eAAO,MAAM,kBAAkB,OAAO,CAAA;AAEtC,MAAM,MAAM,eAAe,GAAG;IAC5B,2EAA2E;IAC3E,GAAG,EAAE,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,KAAK,cAAc,CAAA;IAC7C,KAAK,EAAE,MAAM,CAAA;IACb,KAAK,EAAE,MAAM,CAAA;CACd,CAAA;AAED;;GAEG;AACH,wBAAgB,mBAAmB,CACjC,GAAG,EAAE,aAAa,EAClB,KAAK,EAAE,eAAe,GACrB,iBAAiB,EAAE,CAqBrB"}