@pascal-app/nodes 1.0.3 → 1.0.4

package/dist/item/authored-face-host.d.ts

@@ -0,0 +1,10 @@
+import { type FaceHostCapability, type ItemNode } from '@pascal-app/core';
+/**
+ * Authored objects host ceiling items (pendants, fans, recessed cans) on
+ * their real undersides — a vault plane, a soffit, a beam — found from the
+ * pointer's hit, so placement follows the geometry the script built. A
+ * pendant hangs plumb, a recessed fixture tilts with the slope; either
+ * becomes the object's child.
+ */
+export declare const authoredItemFaceHost: FaceHostCapability<ItemNode>;
+//# sourceMappingURL=authored-face-host.d.ts.map

package/dist/item/authored-face-host.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"authored-face-host.d.ts","sourceRoot":"","sources":["../../src/item/authored-face-host.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,KAAK,kBAAkB,EAGvB,KAAK,QAAQ,EAGd,MAAM,kBAAkB,CAAA;AA4CzB;;;;;;GAMG;AACH,eAAO,MAAM,oBAAoB,EAAE,kBAAkB,CAAC,QAAQ,CAsC7D,CAAA"}

package/dist/item/authored-face-host.js

@@ -0,0 +1,87 @@
+import { flushMountRotation, mountsFlush, sceneRegistry, } from '@pascal-app/core';
+import { Quaternion, Triangle, Vector3 } from 'three';
+/** Faces pointing at least this far down take ceiling items (a vault plane at up to ~70°). */
+const UNDERSIDE_MAX_NORMAL_Y = -0.35;
+const UNDERSIDE_FACE = 'underside';
+function hitNormal(object, faceIndex) {
+    const geometry = object.geometry;
+    const position = geometry?.getAttribute('position');
+    if (!(geometry && position) || faceIndex === undefined)
+        return null;
+    const index = geometry.getIndex();
+    const vertex = (k) => (index ? index.getX(faceIndex * 3 + k) : faceIndex * 3 + k);
+    const triangle = new Triangle(new Vector3().fromBufferAttribute(position, vertex(0)), new Vector3().fromBufferAttribute(position, vertex(1)), new Vector3().fromBufferAttribute(position, vertex(2)));
+    return triangle.getNormal(new Vector3());
+}
+/**
+ * Where a ceiling item hangs under an authored object: the hit point and the
+ * face normal, both in the host item's frame, when the face points down.
+ */
+function resolveUnderside(args) {
+    if (!args.host.source || args.asset.attachTo !== 'ceiling')
+        return null;
+    const hostObject = sceneRegistry.nodes.get(args.host.id);
+    const object = args.object;
+    const localNormal = hitNormal(object, args.faceIndex);
+    if (!(hostObject && localNormal))
+        return null;
+    object.updateWorldMatrix(true, false);
+    hostObject.updateWorldMatrix(true, false);
+    const world = object.localToWorld(new Vector3(...args.localPosition));
+    const point = hostObject.worldToLocal(world.clone());
+    const toHost = hostObject.getWorldQuaternion(new Quaternion()).invert();
+    const normal = localNormal
+        .applyQuaternion(object.getWorldQuaternion(new Quaternion()))
+        .applyQuaternion(toHost)
+        .normalize();
+    if (normal.y > UNDERSIDE_MAX_NORMAL_Y)
+        return null;
+    return { world, point, normal };
+}
+/**
+ * Authored objects host ceiling items (pendants, fans, recessed cans) on
+ * their real undersides — a vault plane, a soffit, a beam — found from the
+ * pointer's hit, so placement follows the geometry the script built. A
+ * pendant hangs plumb, a recessed fixture tilts with the slope; either
+ * becomes the object's child.
+ */
+export const authoredItemFaceHost = {
+    currentFaceId: (item) => (item?.asset.attachTo === 'ceiling' ? UNDERSIDE_FACE : null),
+    clearItemFields: [],
+    resolvePlacement: (args) => {
+        const hit = resolveUnderside(args);
+        if (!hit)
+            return null;
+        const yaw = args.draftItem?.rotation[1] ?? 0;
+        // A recessed fixture seats flush along the face, tilted with a slope; a
+        // pendant or fan hangs plumb from the point.
+        const flush = mountsFlush({ ...args.asset, dimensions: args.rawDimensions });
+        const offset = flush
+            ? hit.normal.clone().multiplyScalar(0.02)
+            : new Vector3(0, -args.rawDimensions[1], 0);
+        const at = hit.point.clone().add(offset);
+        const position = [at.x, at.y, at.z];
+        const rotation = flush
+            ? flushMountRotation([hit.normal.x, hit.normal.y, hit.normal.z], yaw)
+            : [0, yaw, 0];
+        const cursor = hit.world.clone().add(offset);
+        return {
+            faceId: UNDERSIDE_FACE,
+            nodeUpdate: {
+                position,
+                rotation,
+                parentId: args.host.id,
+                wallId: undefined,
+                blockFaceId: undefined,
+                roofSegmentId: undefined,
+                roofFace: undefined,
+            },
+            position,
+            rotation,
+            cursorPosition: cursor.toArray(),
+            cursorRotation: rotation,
+        };
+    },
+    storedPlacementPatch: () => null,
+    isStoredPlacementValid: ({ host, asset }) => Boolean(host.source) && asset.attachTo === 'ceiling',
+};

package/dist/item/authored-params.d.ts

@@ -0,0 +1,15 @@
+import type { ScriptedNode } from '@pascal-app/core';
+/**
+ * The params an authored object's script declares, as controls. Sliders
+ * preview their value while dragging and rebuild on release (a rebuild runs
+ * the script again: tens to hundreds of milliseconds in three.js, seconds in
+ * Blender). A param changed from
+ * the script's default can be put back, alone or with all the others.
+ */
+export declare function AuthoredParams({ node, }: {
+    node: {
+        id: string;
+        source?: ScriptedNode['source'];
+    };
+}): import("react").JSX.Element | null;
+//# sourceMappingURL=authored-params.d.ts.map

package/dist/item/authored-params.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"authored-params.d.ts","sourceRoot":"","sources":["../../src/item/authored-params.tsx"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAGV,YAAY,EACb,MAAM,kBAAkB,CAAA;AAezB;;;;;;GAMG;AACH,wBAAgB,cAAc,CAAC,EAC7B,IAAI,GACL,EAAE;IACD,IAAI,EAAE;QAAE,EAAE,EAAE,MAAM,CAAC;QAAC,MAAM,CAAC,EAAE,YAAY,CAAC,QAAQ,CAAC,CAAA;KAAE,CAAA;CACtD,sCAsHA"}

package/dist/item/authored-params.js

@@ -0,0 +1,72 @@
+'use client';
+import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
+import { PanelSection, rebuildAuthoredObject, SegmentedControl, SliderControl, ToggleControl, Tooltip, TooltipContent, TooltipTrigger, } from '@pascal-app/editor';
+import { RotateCcw } from 'lucide-react';
+import { useRef, useState } from 'react';
+import { isScriptDefault, scriptDefault, scriptDefaultsPatch } from './script-param-defaults';
+/**
+ * The params an authored object's script declares, as controls. Sliders
+ * preview their value while dragging and rebuild on release (a rebuild runs
+ * the script again: tens to hundreds of milliseconds in three.js, seconds in
+ * Blender). A param changed from
+ * the script's default can be put back, alone or with all the others.
+ */
+export function AuthoredParams({ node, }) {
+    const source = node.source;
+    const [drafts, setDrafts] = useState({});
+    const [busy, setBusy] = useState(false);
+    const rebuilding = useRef(false);
+    const [error, setError] = useState(null);
+    if (!source || source.manifest.params.length === 0)
+        return null;
+    const rebuild = (patch) => {
+        if (rebuilding.current)
+            return;
+        rebuilding.current = true;
+        setBusy(true);
+        setError(null);
+        rebuildAuthoredObject(node.id, patch)
+            .catch((reason) => {
+            console.error('[authored object] rebuild failed', reason);
+            setError("Couldn't rebuild with these values.");
+        })
+            .finally(() => {
+            rebuilding.current = false;
+            setBusy(false);
+            setDrafts((current) => {
+                const rest = { ...current };
+                for (const id of Object.keys(patch))
+                    delete rest[id];
+                return rest;
+            });
+        });
+    };
+    const control = (spec) => {
+        const value = source.params[spec.id] ?? scriptDefault(spec);
+        const label = spec.label ?? spec.id;
+        if (spec.kind === 'boolean') {
+            return (_jsx(ToggleControl, { checked: Boolean(value), label: label, onChange: (checked) => rebuild({ [spec.id]: checked }) }));
+        }
+        if (spec.kind === 'string') {
+            if (!spec.options?.length) {
+                return (_jsxs("div", { className: "flex h-7 items-center justify-between gap-2 px-2 text-xs", children: [_jsx("span", { className: "text-muted-foreground", children: label }), _jsx("span", { className: "truncate", children: String(value) })] }));
+            }
+            return (_jsx(SegmentedControl, { onChange: (next) => rebuild({ [spec.id]: next }), options: spec.options.map((option) => ({ label: option, value: option })), value: String(value) }));
+        }
+        const current = drafts[spec.id] ?? Number(value);
+        const span = Math.max(Math.abs(Number(spec.default)), 1);
+        return (_jsx(SliderControl, { label: label, max: spec.max ?? Number(spec.default) + span, min: spec.min ?? Number(spec.default) - span, onChange: (next) => {
+                if (!rebuilding.current)
+                    setDrafts((d) => ({ ...d, [spec.id]: next }));
+            }, onCommit: (next) => rebuild({ [spec.id]: next }), precision: spec.step !== undefined && spec.step < 1 ? 2 : 0, restoreOnCommit: false, step: spec.step ?? 0.01, unit: spec.unit, value: current }));
+    };
+    const row = (spec) => {
+        const input = control(spec);
+        return (_jsxs("div", { className: "flex items-center gap-1", inert: busy, children: [_jsx("div", { className: "min-w-0 flex-1", children: input }), isScriptDefault(spec, source.params[spec.id]) ? null : (_jsx(ResetButton, { label: `Reset ${spec.label ?? spec.id}`, onClick: () => rebuild({ [spec.id]: scriptDefault(spec) }) }))] }, spec.id));
+    };
+    const resetAll = scriptDefaultsPatch(source.manifest.params, source.params);
+    return (_jsxs(PanelSection, { title: "Parameters", children: [source.manifest.params.map(row), Object.keys(resetAll).length > 0 ? (_jsxs("button", { className: "mt-1 flex h-8 items-center justify-center gap-1.5 rounded-full border border-border/50 px-3 font-medium text-foreground text-xs transition-colors hover:bg-accent/50", "data-authored-params-reset": true, disabled: busy, onClick: () => rebuild(resetAll), type: "button", children: [_jsx(RotateCcw, { className: "h-3.5 w-3.5" }), "Reset parameters"] })) : null, busy ? (_jsx("div", { className: "px-2 py-1 text-muted-foreground text-xs", children: source.language === 'bpy' ? 'Rebuilding in Blender…' : 'Rebuilding…' })) : null, error ? _jsx("div", { className: "px-2 py-1 text-red-400 text-xs", children: error }) : null] }));
+}
+function ResetButton({ label, onClick }) {
+    return (_jsxs(Tooltip, { children: [_jsx(TooltipTrigger, { asChild: true, children: _jsx("button", { "aria-label": label, className: "flex h-7 w-7 shrink-0 items-center justify-center rounded-full text-muted-foreground transition-colors hover:bg-accent hover:text-foreground", "data-authored-param-reset": true, onClick: onClick, type: "button", children: _jsx(RotateCcw, { className: "h-3.5 w-3.5" }) }) }), _jsx(TooltipContent, { side: "top", children: "Reset to default" })] }));
+}

package/dist/item/definition.d.ts

@@ -3,8 +3,8 @@ import { ItemNode } from './schema';
 /**
  * Item — Phase 5 batch kind. Catalog-backed, GLB-rendered, multi-host.
  *
- * Demonstrates the **custom `def.renderer` escape hatch** (see
- * plans/editor-node-registry.md): items use `useGLTF` from drei to
+ * Demonstrates the **custom `def.renderer` escape hatch** ("Opting out of a
+ * generic path" in wiki/architecture/node-definitions.md): items use `useGLTF` from drei to
  * load CDN assets, plus a non-trivial interactive-widget layer inside
  * the rendered scene. Not expressible as a pure `def.geometry`. The
  * registry mounts the custom React renderer as-is.

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

@@ -1 +1 @@
-{"version":3,"file":"definition.d.ts","sourceRoot":"","sources":["../../src/item/definition.ts"],"names":[],"mappings":"AAAA,OAAO,EAKL,KAAK,cAAc,EACpB,MAAM,kBAAkB,CAAA;AAOzB,OAAO,EAAE,QAAQ,EAAE,MAAM,UAAU,CAAA;AA+HnC;;;;;;;;;;;;;;;;;;;;;;;;;;;GA2BG;AACH,eAAO,MAAM,cAAc,EAAE,cAAc,CAAC,OAAO,QAAQ,CAyL1D,CAAA"}
+{"version":3,"file":"definition.d.ts","sourceRoot":"","sources":["../../src/item/definition.ts"],"names":[],"mappings":"AAAA,OAAO,EAML,KAAK,cAAc,EAGpB,MAAM,kBAAkB,CAAA;AAWzB,OAAO,EAAE,QAAQ,EAAE,MAAM,UAAU,CAAA;AA+HnC;;;;;;;;;;;;;;;;;;;;;;;;;;;GA2BG;AACH,eAAO,MAAM,cAAc,EAAE,cAAc,CAAC,OAAO,QAAQ,CAqN1D,CAAA"}

package/dist/item/definition.js

@@ -1,9 +1,13 @@
-import { getScaledDimensions, } from '@pascal-app/core';
+import { getEffectiveCutterNode, getScaledDimensions, resolveCutterHost, toggleMechanism, } from '@pascal-app/core';
+import { itemHasLights, itemMechanism, toggleItemLights } from '../shared/item-interactions';
+import { itemBatchable } from '../shared/node-batch/batchable';
 import { restingFloorplanAffectedIds } from '../shared/resting-surface-plan';
+import { authoredItemFaceHost } from './authored-face-host';
 import { buildItemContextualDimensions, buildItemFloorplan } from './floorplan';
 import { itemFloorplanMoveTarget } from './floorplan-move';
 import { itemPaint } from './paint';
 import { itemParametrics } from './parametrics';
+import { itemPlacementNotice } from './placement-notice';
 import { ItemNode } from './schema';
 // The two floor gizmos flank the item at mid-height so they never overlap,
 // even on small items: move sits past the left edge, rotate past the right
@@ -126,8 +130,8 @@ function itemWallMoveHandle() {
 /**
  * Item — Phase 5 batch kind. Catalog-backed, GLB-rendered, multi-host.
  *
- * Demonstrates the **custom `def.renderer` escape hatch** (see
- * plans/editor-node-registry.md): items use `useGLTF` from drei to
+ * Demonstrates the **custom `def.renderer` escape hatch** ("Opting out of a
+ * generic path" in wiki/architecture/node-definitions.md): items use `useGLTF` from drei to
  * load CDN assets, plus a non-trivial interactive-widget layer inside
  * the rendered scene. Not expressible as a pure `def.geometry`. The
  * registry mounts the custom React renderer as-is.
@@ -162,6 +166,7 @@ export const itemDefinition = {
     extensions: {
         'pascal:editor/floorplan': {
             contextualDimensions: buildItemContextualDimensions,
+            actionMenu: { actions: () => import('../shared/item-interaction-actions') },
         },
     },
     // Defaults shape is cast: the schema requires a fully-typed `asset`
@@ -188,7 +193,10 @@ export const itemDefinition = {
         },
     }),
     capabilities: {
+        batchable: itemBatchable,
         selectable: { hitVolume: 'bbox' },
+        // Authored objects host ceiling items on their undersides; catalog items do not.
+        faceHost: authoredItemFaceHost,
         surfaces: {
             top: {
                 height: (node) => {
@@ -200,6 +208,7 @@ export const itemDefinition = {
         duplicable: { subtree: 'with-children' },
         deletable: true,
         paint: itemPaint,
+        mechanism: itemMechanism,
         // Items participate in compositions — e.g. "table-with-plants",
         // "shelf-with-books-on-top" — so they're presettable in their own
         // right (and as descendants of presettable parents). The GLB-kind
@@ -298,13 +307,33 @@ export const itemDefinition = {
     // Stage C: floor-plan polygon. ctx.resolve walks the parent chain
     // (wall / nested item / level) to compute the world-space transform.
     floorplan: buildItemFloorplan,
-    floorplanAffectedIds: restingFloorplanAffectedIds,
+    floorplanAffectedIds: (args) => {
+        const ids = [...restingFloorplanAffectedIds(args)];
+        for (const node of [args.node, getEffectiveCutterNode(args.node)]) {
+            if (node.type !== 'item')
+                continue;
+            for (const cutter of node.source?.manifest.cutters ?? []) {
+                const host = resolveCutterHost(node, cutter.host === 'mounted' ? 'cutout' : `cut:${cutter.host}`, args.nodes);
+                if (host)
+                    ids.push(host.id);
+            }
+        }
+        return ids;
+    },
     // 2D move-on-floorplan handler. Branches on `asset.attachTo`:
     // wall items snap to walls (like door / window), ceiling items
     // snap to ceiling polygons, floor items snap to slabs. attachTo
     // *transitions* (drop a wall item on a ceiling) remain canonical
     // in the 3D path; 2D only re-anchors within the same family.
     floorplanMoveTarget: itemFloorplanMoveTarget,
+    placementNotice: itemPlacementNotice,
+    keyboardActions: {
+        e: {
+            appliesTo: (node) => itemMechanism.has(node) || itemHasLights(node),
+            // Same as the action bar: mechanisms when the item has them, otherwise its light.
+            run: (node) => itemMechanism.has(node) ? toggleMechanism(itemMechanism, node) : toggleItemLights(node),
+        },
+    },
     toolHints: [
         { key: 'Left click', label: 'Place item' },
         { key: 'R / T', label: 'Rotate' },

package/dist/item/floorplan.d.ts

@@ -19,7 +19,7 @@ type Transform = {
     y: number;
     rotation: number;
 };
-export declare function resolveItemTransform(item: ItemNode, ctx: GeometryContext, cache?: Map<`roof_${string}` | `rseg_${string}` | `site_${string}` | `building_${string}` | `level_${string}` | `elevator_${string}` | `unit_${string}` | `zone_${string}` | `block_${string}` | `ceiling_${string}` | `item_${string}` | `procedural-item_${string}` | `column_${string}` | `construction-dimension_${string}` | `wall_${string}` | `slab_${string}` | `fence_${string}` | `structural-grid_${string}` | `imesh_${string}` | `stair_${string}` | `scan_${string}` | `guide_${string}` | `measurement_${string}` | `spawn_${string}` | `shelf_${string}` | `duct-segment_${string}` | `duct-fitting_${string}` | `duct-terminal_${string}` | `hvac-equipment_${string}` | `lineset_${string}` | `liquid-line_${string}` | `pipe-segment_${string}` | `pipe-fitting_${string}` | `pipe-trap_${string}` | `leanto_${string}` | `door_${string}` | `window_${string}` | `cabinet_${string}` | `cabinet-module_${string}` | `sseg_${string}` | `bvent_${string}` | `rvent_${string}` | `tvent_${string}` | `cupola_${string}` | `eyebrow-vent_${string}` | `gutter_${string}` | `chimney_${string}` | `solarpanel_${string}` | `skylight_${string}` | `dormer_${string}` | `downspout_${string}`, Transform | null>): Transform | null;
+export declare function resolveItemTransform(item: ItemNode, ctx: GeometryContext, cache?: Map<`roof_${string}` | `rseg_${string}` | `site_${string}` | `building_${string}` | `level_${string}` | `elevator_${string}` | `unit_${string}` | `zone_${string}` | `block_${string}` | `ceiling_${string}` | `item_${string}` | `procedural-item_${string}` | `column_${string}` | `construction-dimension_${string}` | `wall_${string}` | `slab_${string}` | `separator_${string}` | `floor-opening_${string}` | `fence_${string}` | `structural-grid_${string}` | `imesh_${string}` | `stair_${string}` | `scan_${string}` | `guide_${string}` | `measurement_${string}` | `spawn_${string}` | `shelf_${string}` | `duct-segment_${string}` | `duct-fitting_${string}` | `duct-terminal_${string}` | `hvac-equipment_${string}` | `lineset_${string}` | `liquid-line_${string}` | `pipe-segment_${string}` | `pipe-fitting_${string}` | `pipe-trap_${string}` | `leanto_${string}` | `door_${string}` | `window_${string}` | `fence-gate_${string}` | `fence-opening_${string}` | `cabinet_${string}` | `cabinet-module_${string}` | `sseg_${string}` | `bvent_${string}` | `rvent_${string}` | `tvent_${string}` | `cupola_${string}` | `eyebrow-vent_${string}` | `gutter_${string}` | `chimney_${string}` | `solarpanel_${string}` | `skylight_${string}` | `dormer_${string}` | `downspout_${string}`, Transform | null>): Transform | null;
 export declare function buildItemContextualDimensions(node: ItemNode, ctx: GeometryContext): FloorplanGeometry | null;
 export declare function buildItemFloorplan(node: ItemNode, ctx: GeometryContext): FloorplanGeometry | null;
 export {};

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

@@ -1 +1 @@
-{"version":3,"file":"floorplan.d.ts","sourceRoot":"","sources":["../../src/item/floorplan.ts"],"names":[],"mappings":"AAAA,OAAO,EAGL,KAAK,iBAAiB,EAEtB,KAAK,eAAe,EAKpB,KAAK,QAAQ,EAId,MAAM,kBAAkB,CAAA;AAIzB;;;;;;;;;;;;;;GAcG;AACH,KAAK,SAAS,GAAG;IAAE,CAAC,EAAE,MAAM,CAAC;IAAC,CAAC,EAAE,MAAM,CAAC;IAAC,QAAQ,EAAE,MAAM,CAAA;CAAE,CAAA;AA2D3D,wBAAgB,oBAAoB,CAClC,IAAI,EAAE,QAAQ,EACd,GAAG,EAAE,eAAe,EACpB,KAAK,0pCAAyC,GAC7C,SAAS,GAAG,IAAI,CAwKlB;AAED,wBAAgB,6BAA6B,CAC3C,IAAI,EAAE,QAAQ,EACd,GAAG,EAAE,eAAe,GACnB,iBAAiB,GAAG,IAAI,CA+C1B;AAED,wBAAgB,kBAAkB,CAAC,IAAI,EAAE,QAAQ,EAAE,GAAG,EAAE,eAAe,GAAG,iBAAiB,GAAG,IAAI,CAmGjG"}
+{"version":3,"file":"floorplan.d.ts","sourceRoot":"","sources":["../../src/item/floorplan.ts"],"names":[],"mappings":"AAAA,OAAO,EAGL,KAAK,iBAAiB,EAEtB,KAAK,eAAe,EAOpB,KAAK,QAAQ,EAKd,MAAM,kBAAkB,CAAA;AASzB;;;;;;;;;;;;;;GAcG;AACH,KAAK,SAAS,GAAG;IAAE,CAAC,EAAE,MAAM,CAAC;IAAC,CAAC,EAAE,MAAM,CAAC;IAAC,QAAQ,EAAE,MAAM,CAAA;CAAE,CAAA;AA2D3D,wBAAgB,oBAAoB,CAClC,IAAI,EAAE,QAAQ,EACd,GAAG,EAAE,eAAe,EACpB,KAAK,mwCAAyC,GAC7C,SAAS,GAAG,IAAI,CAyKlB;AAED,wBAAgB,6BAA6B,CAC3C,IAAI,EAAE,QAAQ,EACd,GAAG,EAAE,eAAe,GACnB,iBAAiB,GAAG,IAAI,CA+C1B;AAED,wBAAgB,kBAAkB,CAAC,IAAI,EAAE,QAAQ,EAAE,GAAG,EAAE,eAAe,GAAG,iBAAiB,GAAG,IAAI,CA+HjG"}

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 { 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';
+import { buildPlanItemSymbol, classifyPlanItem, PLAN_SYMBOL_METADATA_KEY } from './plan-symbols';
 // 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 { getPendingItemModelLoadCount } from './model-loader';
 export { ItemNode } from './schema';
 //# 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 { getPendingItemModelLoadCount } from './model-loader';
 export { ItemNode } from './schema';

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;

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":"AAAA,OAAO,EAAgC,cAAc,EAAE,MAAM,OAAO,CAAA;AAEpE,OAAO,EAAE,KAAK,IAAI,EAAE,UAAU,EAAE,MAAM,0CAA0C,CAAA;AAOhF,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,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;IAOpE,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;CA+FR"}

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.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';
 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),
 };