@pascal-app/nodes 1.0.3 → 1.0.5

package/dist/item/floorplan.js

@@ -1,6 +1,7 @@
-import { getBlockFaceFrame, getEffectiveNode, getRoofWallFaceFrame, getScaledDimensions, roofFacePointToSegment, useLiveTransforms, } from '@pascal-app/core';
-import { formatLinearMeasurement, readFloorplanMetricNotationOverride } from '@pascal-app/editor';
-import { restingNodePlanFrame } from '../shared/resting-surface-plan';
+import { getBlockFaceFrame, getEffectiveNode, getRoofWallFaceFrame, getScaledDimensions, getWallBodyCenterOffset, getWallLocalFaceZ, roofFacePointToSegment, scriptImages, useLiveTransforms, } from '@pascal-app/core';
+import { formatLinearMeasurement, readFloorplanContext, readFloorplanMetricNotationOverride, } from '@pascal-app/editor';
+import { restingNodePlanFrame } from '../shared/resting-surface-plan.js';
+import { buildPlanItemSymbol, classifyPlanItem, PLAN_SYMBOL_METADATA_KEY } from './plan-symbols.js';
 // Plan-space rotation convention used by the legacy `rotatePlanVector`
 // in `editor/src/lib/floorplan/geometry.ts`. This is a CLOCKWISE rotation
 // — the registry-side equivalent of the canonical floor-plan transform
@@ -74,8 +75,9 @@ export function resolveItemTransform(item, ctx, cache = new Map()) {
         const wall = parentNode;
         const wallRotation = -Math.atan2(wall.end[1] - wall.start[1], wall.end[0] - wall.start[0]);
         const wallLocalZ = item.asset.attachTo === 'wall-side'
-            ? ((wall.thickness ?? 0.1) / 2) * (item.side === 'front' ? 1 : -1)
-            : item.position[2];
+            ? getWallLocalFaceZ(parentNode, item.side === 'front' ? 'a' : 'b')
+            : item.position[2] +
+                (item.asset.attachTo === 'wall' ? getWallBodyCenterOffset(parentNode) : 0);
         const [offsetX, offsetY] = rotateVec(item.position[0], wallLocalZ, wallRotation);
         result = {
             x: wall.start[0] + offsetX,
@@ -273,13 +275,41 @@ export function buildItemFloorplan(node, ctx) {
         const [rx, ry] = rotateVec(x, y, transform.rotation);
         return [cx + rx, cy + ry];
     });
+    // A sheet (drafting) draws the permit-set symbol — fixtures as labelled
+    // linework, furniture as a light outline — never the sprite or the
+    // editor's amber footprint. Ceiling items and decor draw nothing.
+    if (readFloorplanContext(ctx).drafting) {
+        const planClass = classifyPlanItem(node.asset);
+        const symbol = buildPlanItemSymbol(planClass, {
+            map: (x, y) => {
+                const [rx, ry] = rotateVec(x, y, transform.rotation);
+                return [cx + rx, cy + ry];
+            },
+            width,
+            depth,
+        });
+        // the sheet lays its tags out around fixtures and (more loosely)
+        // furniture; the mark rides on the outline itself, which the sheet's
+        // model / annotation split passes through untouched (it rebuilds groups)
+        const [outline, ...rest] = symbol;
+        if (!outline)
+            return null;
+        const marked = {
+            ...outline,
+            metadata: {
+                ...outline.metadata,
+                [PLAN_SYMBOL_METADATA_KEY]: planClass.kind,
+            },
+        };
+        return { kind: 'group', children: [marked, ...rest] };
+    }
     const isSelected = ctx.viewState?.selected ?? false;
     // Marquee preview — the about-to-be-selected tint every other kind shows.
     const isHighlighted = ctx.viewState?.highlighted ?? false;
     const showSelection = isSelected || isHighlighted;
     const isMoving = ctx.viewState?.moving ?? false;
     const selectedStroke = ctx.viewState?.palette?.selectedStroke ?? '#3b82f6';
-    const floorPlanUrl = node.asset.floorPlanUrl;
+    const floorPlanUrl = scriptImages(node)?.floorPlan ?? node.asset.floorPlanUrl;
     const children = [
         {
             kind: 'polygon',

package/dist/item/index.d.ts

@@ -1,3 +1,4 @@
-export { itemDefinition } from './definition';
-export { ItemNode } from './schema';
+export { itemDefinition } from './definition.js';
+export { getPendingItemModelLoadCount } from './model-loader.js';
+export { ItemNode } from './schema.js';
 //# sourceMappingURL=index.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/item/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,MAAM,cAAc,CAAA;AAC7C,OAAO,EAAE,QAAQ,EAAE,MAAM,UAAU,CAAA"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/item/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,MAAM,cAAc,CAAA;AAC7C,OAAO,EAAE,4BAA4B,EAAE,MAAM,gBAAgB,CAAA;AAC7D,OAAO,EAAE,QAAQ,EAAE,MAAM,UAAU,CAAA"}

package/dist/item/index.js

@@ -1,2 +1,3 @@
-export { itemDefinition } from './definition';
-export { ItemNode } from './schema';
+export { itemDefinition } from './definition.js';
+export { getPendingItemModelLoadCount } from './model-loader.js';
+export { ItemNode } from './schema.js';

package/dist/item/model-loader.d.ts

@@ -1,5 +1,7 @@
 import { LoadingManager } from 'three';
 import { type GLTF, GLTFLoader } from 'three/examples/jsm/loaders/GLTFLoader.js';
+/** Active item transactions on this host manager, including their retry waits. */
+export declare function getPendingItemModelLoadCount(manager?: LoadingManager): number;
 export type ItemAssetUnavailable = {
     message: string;
     url: string;
@@ -8,11 +10,16 @@ export type ItemModelLoadFailureKind = 'retryable' | 'unavailable' | 'unexpected
 export declare function classifyItemModelLoadFailure(error: unknown): ItemModelLoadFailureKind;
 export declare function createUnavailableItemGltf(url: string, error: unknown): GLTF;
 export declare function getUnavailableItemAsset(gltf: GLTF): ItemAssetUnavailable | null;
+/** GLTFLoader can resolve a model after a referenced texture failed. */
+export declare function getItemResourceFailures(gltf: Pick<GLTF, 'userData'>): string[];
 export declare function cancelItemModelLoad(url: string): void;
 export declare class ItemGLTFLoader extends GLTFLoader {
     readonly hostManager: LoadingManager;
     readonly retryDelaysMs: readonly number[];
+    private resourceFailureVersion;
+    private readonly resourceFailures;
     constructor(manager?: LoadingManager, retryDelaysMs?: readonly [1000, 3000]);
+    parse(data: ArrayBuffer | string, path: string, onLoad: (gltf: GLTF) => void, onError?: (event: ErrorEvent) => void): void;
     load(url: string, onLoad: (gltf: GLTF) => void, onProgress?: (event: ProgressEvent) => void, onError?: (error: unknown) => void): void;
 }
 //# sourceMappingURL=model-loader.d.ts.map

package/dist/item/model-loader.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"model-loader.d.ts","sourceRoot":"","sources":["../../src/item/model-loader.ts"],"names":[],"mappings":"AAAA,OAAO,EAAgC,cAAc,EAAE,MAAM,OAAO,CAAA;AACpE,OAAO,EAAE,KAAK,IAAI,EAAE,UAAU,EAAE,MAAM,0CAA0C,CAAA;AAUhF,MAAM,MAAM,oBAAoB,GAAG;IACjC,OAAO,EAAE,MAAM,CAAA;IACf,GAAG,EAAE,MAAM,CAAA;CACZ,CAAA;AAED,MAAM,MAAM,wBAAwB,GAAG,WAAW,GAAG,aAAa,GAAG,YAAY,CAAA;AAEjF,wBAAgB,4BAA4B,CAAC,KAAK,EAAE,OAAO,GAAG,wBAAwB,CAgBrF;AAED,wBAAgB,yBAAyB,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,OAAO,GAAG,IAAI,CAiB3E;AAED,wBAAgB,uBAAuB,CAAC,IAAI,EAAE,IAAI,GAAG,oBAAoB,GAAG,IAAI,CAO/E;AAED,wBAAgB,mBAAmB,CAAC,GAAG,EAAE,MAAM,QAE9C;AAED,qBAAa,cAAe,SAAQ,UAAU;IAC5C,QAAQ,CAAC,WAAW,EAAE,cAAc,CAAA;IACpC,QAAQ,CAAC,aAAa,EAAE,SAAS,MAAM,EAAE,CAAA;gBAE7B,OAAO,CAAC,EAAE,cAAc,EAAE,aAAa,wBAA0B;IAMpE,IAAI,CACX,GAAG,EAAE,MAAM,EACX,MAAM,EAAE,CAAC,IAAI,EAAE,IAAI,KAAK,IAAI,EAC5B,UAAU,CAAC,EAAE,CAAC,KAAK,EAAE,aAAa,KAAK,IAAI,EAC3C,OAAO,CAAC,EAAE,CAAC,KAAK,EAAE,OAAO,KAAK,IAAI,GACjC,IAAI;CAwER"}
+{"version":3,"file":"model-loader.d.ts","sourceRoot":"","sources":["../../src/item/model-loader.ts"],"names":[],"mappings":"AACA,OAAO,EAAgC,cAAc,EAAE,MAAM,OAAO,CAAA;AAEpE,OAAO,EAAE,KAAK,IAAI,EAAE,UAAU,EAAE,MAAM,0CAA0C,CAAA;AAShF,kFAAkF;AAClF,wBAAgB,4BAA4B,CAAC,OAAO,iBAAwB,GAAG,MAAM,CAEpF;AAMD,MAAM,MAAM,oBAAoB,GAAG;IACjC,OAAO,EAAE,MAAM,CAAA;IACf,GAAG,EAAE,MAAM,CAAA;CACZ,CAAA;AAED,MAAM,MAAM,wBAAwB,GAAG,WAAW,GAAG,aAAa,GAAG,YAAY,CAAA;AAEjF,wBAAgB,4BAA4B,CAAC,KAAK,EAAE,OAAO,GAAG,wBAAwB,CAiBrF;AAED,wBAAgB,yBAAyB,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,OAAO,GAAG,IAAI,CAiB3E;AAED,wBAAgB,uBAAuB,CAAC,IAAI,EAAE,IAAI,GAAG,oBAAoB,GAAG,IAAI,CAO/E;AAED,wEAAwE;AACxE,wBAAgB,uBAAuB,CAAC,IAAI,EAAE,IAAI,CAAC,IAAI,EAAE,UAAU,CAAC,GAAG,MAAM,EAAE,CAK9E;AAED,wBAAgB,mBAAmB,CAAC,GAAG,EAAE,MAAM,QAE9C;AAED,qBAAa,cAAe,SAAQ,UAAU;IAC5C,QAAQ,CAAC,WAAW,EAAE,cAAc,CAAA;IACpC,QAAQ,CAAC,aAAa,EAAE,SAAS,MAAM,EAAE,CAAA;IACzC,OAAO,CAAC,sBAAsB,CAAI;IAClC,OAAO,CAAC,QAAQ,CAAC,gBAAgB,CAA4B;IAE7D,YAAY,OAAO,CAAC,EAAE,cAAc,EAAE,aAAa,wBAA0B,EAS5E;IAEQ,KAAK,CACZ,IAAI,EAAE,WAAW,GAAG,MAAM,EAC1B,IAAI,EAAE,MAAM,EACZ,MAAM,EAAE,CAAC,IAAI,EAAE,IAAI,KAAK,IAAI,EAC5B,OAAO,CAAC,EAAE,CAAC,KAAK,EAAE,UAAU,KAAK,IAAI,GACpC,IAAI,CAkBN;IAEQ,IAAI,CACX,GAAG,EAAE,MAAM,EACX,MAAM,EAAE,CAAC,IAAI,EAAE,IAAI,KAAK,IAAI,EAC5B,UAAU,CAAC,EAAE,CAAC,KAAK,EAAE,aAAa,KAAK,IAAI,EAC3C,OAAO,CAAC,EAAE,CAAC,KAAK,EAAE,OAAO,KAAK,IAAI,GACjC,IAAI,CAsGN;CACF"}

package/dist/item/model-loader.js

@@ -1,11 +1,22 @@
+import { preserveGltfUnlit } from '@pascal-app/viewer';
 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 ITEM_RESOURCE_FAILURES_KEY = 'pascalItemResourceFailures';
 const DEFAULT_RETRY_DELAYS_MS = [1_000, 3_000];
 const itemLoadGenerations = new Map();
+const pendingItemModelLoads = new WeakMap();
+const malformedItemJsonErrors = new WeakSet();
+/** 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';
+    if (malformedItemJsonErrors.has(error))
+        return 'unavailable';
     const status = error.response?.status;
     if (status === 408 ||
         status === 425 ||
@@ -45,27 +56,68 @@ export function getUnavailableItemAsset(gltf) {
         ? { url: candidate.url, message: candidate.message }
         : null;
 }
+/** GLTFLoader can resolve a model after a referenced texture failed. */
+export function getItemResourceFailures(gltf) {
+    const failures = gltf.userData?.[ITEM_RESOURCE_FAILURES_KEY];
+    return Array.isArray(failures)
+        ? failures.filter((url) => typeof url === 'string')
+        : [];
+}
 export function cancelItemModelLoad(url) {
     itemLoadGenerations.set(url, (itemLoadGenerations.get(url) ?? 0) + 1);
 }
 export class ItemGLTFLoader extends GLTFLoader {
     hostManager;
     retryDelaysMs;
+    resourceFailureVersion = 0;
+    resourceFailures = new Map();
     constructor(manager, retryDelaysMs = DEFAULT_RETRY_DELAYS_MS) {
         super(new LoadingManager());
+        this.register(preserveGltfUnlit);
+        this.manager.onError = (url) => {
+            this.resourceFailures.set(url, ++this.resourceFailureVersion);
+        };
+        this.setMeshoptDecoder(MeshoptDecoder);
         this.hostManager = manager ?? DefaultLoadingManager;
         this.retryDelaysMs = retryDelaysMs;
     }
+    parse(data, path, onLoad, onError) {
+        try {
+            super.parse(data, path, onLoad, onError);
+        }
+        catch (error) {
+            if (error instanceof SyntaxError) {
+                const text = typeof data === 'string' ? data : new TextDecoder().decode(data);
+                // Confirm invalid asset JSON, rather than classifying a plugin's or
+                // consumer's SyntaxError as unavailable. Leave native GLB parsing alone.
+                if (typeof data === 'string' || !text.startsWith('glTF')) {
+                    try {
+                        JSON.parse(text);
+                    }
+                    catch (parseError) {
+                        if (parseError instanceof SyntaxError)
+                            malformedItemJsonErrors.add(error);
+                    }
+                }
+            }
+            throw error;
+        }
+    }
     load(url, onLoad, onProgress, onError) {
         const generation = itemLoadGenerations.get(url) ?? 0;
+        const resourceVersion = this.resourceFailureVersion;
         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)
@@ -76,10 +128,18 @@ export class ItemGLTFLoader extends GLTFLoader {
             }
             finished = true;
             try {
+                // Keep the live model's existing fallback behavior; only make known
+                // missing resources observable to capture readiness. Concurrent loads
+                // on this manager are deliberately conservative.
+                const failures = [...this.resourceFailures]
+                    .filter(([failedUrl, version]) => failedUrl !== url && version > resourceVersion)
+                    .map(([failedUrl]) => failedUrl);
+                if (failures.length)
+                    gltf.userData[ITEM_RESOURCE_FAILURES_KEY] = failures;
                 onLoad(gltf);
             }
             finally {
-                this.hostManager.itemEnd(url);
+                end();
             }
         };
         const fail = (error) => {
@@ -97,8 +157,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 +170,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.map

@@ -1 +1 @@
-{"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"}
+{"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;eAEc,YAAY"}

package/dist/item/move-tool.js

@@ -124,9 +124,9 @@ export function MoveItemTool({ node: source }) {
     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 && !isSceneDraft
             ? {
@@ -147,7 +147,7 @@ export function MoveItemTool({ node: source }) {
                 // 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 {

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.js';
 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 { Fragment as _Fragment, jsx as _jsx, jsxs as _jsxs } 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.js';
 /**
  * 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-700 dark: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;
@@ -92,12 +80,20 @@ export default function ItemPanel() {
                                     const radians = ((currentDegrees + 45) * Math.PI) / 180;
                                     handleUpdate({ rotation: [node.rotation[0], radians, node.rotation[2]] });
                                 } })] })] }), _jsxs(PanelSection, { title: "Scale", children: [_jsxs("div", { className: "flex items-center justify-between px-2 pb-2", children: [_jsx("span", { className: "font-medium text-[10px] text-muted-foreground/80 uppercase tracking-wider", children: "Uniform Scale" }), _jsx("button", { className: uniformScale
-                                    ? 'flex h-6 w-6 items-center justify-center rounded-md bg-[#3e3e3e] text-muted-foreground transition-colors hover:text-foreground'
-                                    : 'flex h-6 w-6 items-center justify-center rounded-md bg-[#2C2C2E] text-muted-foreground transition-colors hover:bg-[#3e3e3e] hover:text-foreground', onClick: () => setUniformScale((v) => !v), type: "button", children: uniformScale ? _jsx(Link, { className: "h-3.5 w-3.5" }) : _jsx(Link2Off, { className: "h-3.5 w-3.5" }) })] }), uniformScale ? (_jsx(SliderControl, { label: _jsxs(_Fragment, { children: ["XYZ", _jsx("sub", { className: "ml-[1px] text-[11px] opacity-70", children: "scale" })] }), max: 10, min: 0.01, onChange: (value) => {
+                                    ? 'flex h-6 w-6 items-center justify-center rounded-md bg-black/8 dark:bg-[#3e3e3e] text-muted-foreground transition-colors hover:text-foreground'
+                                    : 'flex h-6 w-6 items-center justify-center rounded-md bg-black/4 dark:bg-[#2C2C2E] text-muted-foreground transition-colors hover:bg-black/8 dark:hover:bg-[#3e3e3e] hover:text-foreground', onClick: () => setUniformScale((v) => !v), type: "button", children: uniformScale ? _jsx(Link, { className: "h-3.5 w-3.5" }) : _jsx(Link2Off, { className: "h-3.5 w-3.5" }) })] }), uniformScale ? (_jsx(SliderControl, { label: _jsxs(_Fragment, { children: ["XYZ", _jsx("sub", { className: "ml-[1px] text-[11px] opacity-70", children: "scale" })] }), max: 10, min: 0.01, onChange: (value) => {
                             const v = Math.max(0.01, value);
                             handleUpdate({ scale: [v, v, v] });
                         }, 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 })] }) })] }));
+                            return (_jsxs("span", { className: "font-mono text-foreground dark:text-white", children: [Math.round(w * 100) / 100, "\u00D7", Math.round(h * 100) / 100, "\u00D7", Math.round(d * 100) / 100] }));
+                        })()] }) }), _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-600 dark: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/parametrics.d.ts

@@ -1,5 +1,5 @@
 import type { ParametricDescriptor } from '@pascal-app/core';
-import type { ItemNode } from './schema';
+import type { ItemNode } from './schema.js';
 /**
  * Inspector descriptor for item. The fields shape (position / rotation /
  * scale sliders, catalog popover, move / duplicate / delete actions)

package/dist/item/parametrics.js

@@ -8,5 +8,5 @@
  */
 export const itemParametrics = {
     groups: [],
-    customPanel: () => import('./panel'),
+    customPanel: () => import('./panel.js'),
 };

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;
+}