@pascal-app/nodes 1.0.3 → 1.0.5

package/dist/index.js

@@ -1,53 +1,56 @@
-import { blockDefinition } from './block/definition';
-import { boxVentDefinition } from './box-vent';
-import { buildingDefinition } from './building';
-import { cabinetDefinition, cabinetModuleDefinition } from './cabinet';
-import { ceilingDefinition } from './ceiling';
-import { chimneyDefinition } from './chimney';
-import { columnDefinition } from './column';
-import { constructionDimensionDefinition } from './construction-dimension';
-import { cupolaDefinition } from './cupola';
-import { doorDefinition } from './door';
-import { dormerDefinition } from './dormer';
-import { downspoutDefinition } from './downspout';
-import { ductFittingDefinition } from './duct-fitting';
-import { ductSegmentDefinition } from './duct-segment';
-import { ductTerminalDefinition } from './duct-terminal';
-import { elevatorDefinition } from './elevator';
-import { eyebrowVentDefinition } from './eyebrow-vent';
-import { fenceDefinition } from './fence';
-import { guideDefinition } from './guide';
-import { gutterDefinition } from './gutter';
-import { hvacEquipmentDefinition } from './hvac-equipment';
-import { importedMeshDefinition } from './imported-mesh';
-import { itemDefinition } from './item';
-import { leanToExtensionDefinition } from './lean-to-extension';
-import { levelDefinition } from './level';
-import { linesetDefinition } from './lineset';
-import { liquidLineDefinition } from './liquid-line';
-import { measurementDefinition } from './measurement';
-import { pipeFittingDefinition } from './pipe-fitting';
-import { pipeSegmentDefinition } from './pipe-segment';
-import { pipeTrapDefinition } from './pipe-trap';
-import { proceduralItemDefinition } from './procedural-item/definition';
-import { ridgeVentDefinition } from './ridge-vent';
-import { roofDefinition } from './roof';
-import { roofSegmentDefinition } from './roof-segment';
-import { scanDefinition } from './scan';
-import { shelfDefinition } from './shelf';
-import { siteDefinition } from './site';
-import { skylightDefinition } from './skylight';
-import { slabDefinition } from './slab';
-import { solarPanelDefinition } from './solar-panel';
-import { spawnDefinition } from './spawn';
-import { stairDefinition } from './stair';
-import { stairSegmentDefinition } from './stair-segment';
-import { structuralGridDefinition } from './structural-grid';
-import { turbineVentDefinition } from './turbine-vent';
-import { unitDefinition } from './unit';
-import { wallDefinition } from './wall';
-import { windowDefinition } from './window';
-import { zoneDefinition } from './zone';
+import { blockDefinition } from './block/definition.js';
+import { boxVentDefinition } from './box-vent/index.js';
+import { buildingDefinition } from './building/index.js';
+import { cabinetDefinition, cabinetModuleDefinition } from './cabinet/index.js';
+import { ceilingDefinition } from './ceiling/index.js';
+import { chimneyDefinition } from './chimney/index.js';
+import { columnDefinition } from './column/index.js';
+import { constructionDimensionDefinition } from './construction-dimension/index.js';
+import { cupolaDefinition } from './cupola/index.js';
+import { doorDefinition } from './door/index.js';
+import { dormerDefinition } from './dormer/index.js';
+import { downspoutDefinition } from './downspout/index.js';
+import { ductFittingDefinition } from './duct-fitting/index.js';
+import { ductSegmentDefinition } from './duct-segment/index.js';
+import { ductTerminalDefinition } from './duct-terminal/index.js';
+import { elevatorDefinition } from './elevator/index.js';
+import { eyebrowVentDefinition } from './eyebrow-vent/index.js';
+import { fenceDefinition } from './fence/index.js';
+import { fenceGateDefinition, fenceOpeningDefinition } from './fence-feature/definition.js';
+import { floorOpeningDefinition } from './floor-opening/definition.js';
+import { guideDefinition } from './guide/index.js';
+import { gutterDefinition } from './gutter/index.js';
+import { hvacEquipmentDefinition } from './hvac-equipment/index.js';
+import { importedMeshDefinition } from './imported-mesh/index.js';
+import { itemDefinition } from './item/index.js';
+import { leanToExtensionDefinition } from './lean-to-extension/index.js';
+import { levelDefinition } from './level/index.js';
+import { linesetDefinition } from './lineset/index.js';
+import { liquidLineDefinition } from './liquid-line/index.js';
+import { measurementDefinition } from './measurement/index.js';
+import { pipeFittingDefinition } from './pipe-fitting/index.js';
+import { pipeSegmentDefinition } from './pipe-segment/index.js';
+import { pipeTrapDefinition } from './pipe-trap/index.js';
+import { proceduralItemDefinition } from './procedural-item/definition.js';
+import { ridgeVentDefinition } from './ridge-vent/index.js';
+import { roofDefinition } from './roof/index.js';
+import { roofSegmentDefinition } from './roof-segment/index.js';
+import { scanDefinition } from './scan/index.js';
+import { separatorDefinition } from './separator/definition.js';
+import { shelfDefinition } from './shelf/index.js';
+import { siteDefinition } from './site/index.js';
+import { skylightDefinition } from './skylight/index.js';
+import { slabDefinition } from './slab/index.js';
+import { solarPanelDefinition } from './solar-panel/index.js';
+import { spawnDefinition } from './spawn/index.js';
+import { stairDefinition } from './stair/index.js';
+import { stairSegmentDefinition } from './stair-segment/index.js';
+import { structuralGridDefinition } from './structural-grid/index.js';
+import { turbineVentDefinition } from './turbine-vent/index.js';
+import { unitDefinition } from './unit/index.js';
+import { wallDefinition } from './wall/index.js';
+import { windowDefinition } from './window/index.js';
+import { zoneDefinition } from './zone/index.js';
 /**
  * Built-in plugin bundling every node kind shipped with the Pascal editor.
  *
@@ -73,8 +76,12 @@ export const builtinPlugin = {
         blockDefinition,
         spawnDefinition,
         wallDefinition,
+        separatorDefinition,
+        floorOpeningDefinition,
         leanToExtensionDefinition,
         fenceDefinition,
+        fenceGateDefinition,
+        fenceOpeningDefinition,
         slabDefinition,
         ceilingDefinition,
         doorDefinition,
@@ -127,53 +134,68 @@ export const builtinPlugin = {
         pipeTrapDefinition,
     ],
 };
-export { applyBlockCommand, blockFaceCentroid, blockFaceNormal, } from './block/commands';
-export { blockDefinition } from './block/definition';
-export { boxVentDefinition } from './box-vent';
-export { buildingDefinition } from './building';
-export { bakeCabinetAnimationClip, CABINET_PLANNING_TOLERANCE, cabinetDefinition, cabinetModuleDefinition, MIN_PRACTICAL_TOP_CABINET_HEIGHT, poseCabinetMovingParts, useCabinetPlacementStatus, useCabinetPlacementType, validateCabinetRun, } from './cabinet';
-export { ceilingDefinition } from './ceiling';
-export { chimneyDefinition } from './chimney';
-export { columnDefinition } from './column';
-export { constructionDimensionDefinition } from './construction-dimension';
-export { cupolaDefinition } from './cupola';
-export { doorDefinition } from './door';
-export { dormerDefinition } from './dormer';
-export { downspoutDefinition } from './downspout';
-export { ductFittingDefinition } from './duct-fitting';
-export { ductSegmentDefinition } from './duct-segment';
-export { ductTerminalDefinition } from './duct-terminal';
-export { elevatorDefinition } from './elevator';
-export { eyebrowVentDefinition } from './eyebrow-vent';
-export { fenceDefinition } from './fence';
-export { guideDefinition } from './guide';
-export { gutterDefinition } from './gutter';
-export { hvacEquipmentDefinition } from './hvac-equipment';
-export { importedMeshDefinition } from './imported-mesh';
-export { itemDefinition } from './item';
-export { leanToExtensionDefinition } from './lean-to-extension';
-export { levelDefinition } from './level';
-export { linesetDefinition } from './lineset';
-export { liquidLineDefinition, useLiquidLineToolOptions } from './liquid-line';
-export { measurementDefinition } from './measurement';
-export { pipeFittingDefinition } from './pipe-fitting';
-export { pipeSegmentDefinition } from './pipe-segment';
-export { pipeTrapDefinition } from './pipe-trap';
-export { ridgeVentDefinition } from './ridge-vent';
-export { roofDefinition, useRoofFootprintSource } from './roof';
-export { roofSegmentDefinition } from './roof-segment';
-export { scanDefinition } from './scan';
-export { shelfDefinition } from './shelf';
-export { siteDefinition } from './site';
-export { skylightDefinition } from './skylight';
-export { slabDefinition } from './slab';
-export { solarPanelDefinition } from './solar-panel';
-export { spawnDefinition } from './spawn';
-export { stairDefinition } from './stair';
-export { stairSegmentDefinition } from './stair-segment';
-export { structuralGridDefinition } from './structural-grid';
-export { turbineVentDefinition } from './turbine-vent';
-export { unitDefinition } from './unit';
-export { wallDefinition } from './wall';
-export { windowDefinition } from './window';
-export { zoneDefinition } from './zone';
+export { applyBlockCommand, blockFaceCentroid, blockFaceNormal, } from './block/commands.js';
+export { blockDefinition } from './block/definition.js';
+export { boxVentDefinition } from './box-vent/index.js';
+export { buildingDefinition } from './building/index.js';
+export { bakeCabinetAnimationClip, beginKitchenPlacement, CABINET_PLANNING_TOLERANCE, cabinetDefinition, cabinetModuleDefinition, cabinetPresetById, findKitchenItems, KITCHEN_ITEMS, KitchenCollection, kitchenItemMatches, kitchenPresetForModule, MIN_PRACTICAL_TOP_CABINET_HEIGHT, poseCabinetMovingParts, useCabinetPlacementStatus, useCabinetPlacementType, validateCabinetRun, } from './cabinet/index.js';
+export { ceilingDefinition } from './ceiling/index.js';
+export { chimneyDefinition } from './chimney/index.js';
+export { columnDefinition } from './column/index.js';
+export { constructionDimensionDefinition } from './construction-dimension/index.js';
+export { cupolaDefinition } from './cupola/index.js';
+export { doorDefinition } from './door/index.js';
+export { dormerDefinition } from './dormer/index.js';
+export { downspoutDefinition } from './downspout/index.js';
+export { ductFittingDefinition } from './duct-fitting/index.js';
+export { ductSegmentDefinition } from './duct-segment/index.js';
+export { ductTerminalDefinition } from './duct-terminal/index.js';
+export { elevatorDefinition } from './elevator/index.js';
+export { eyebrowVentDefinition } from './eyebrow-vent/index.js';
+export { beginFenceFeaturePlacement, fenceDefinition } from './fence/index.js';
+export { fenceGateDefinition, fenceOpeningDefinition } from './fence-feature/definition.js';
+export { floorOpeningDefinition } from './floor-opening/definition.js';
+export { guideDefinition } from './guide/index.js';
+export { gutterDefinition } from './gutter/index.js';
+export { hvacEquipmentDefinition } from './hvac-equipment/index.js';
+export { importedMeshDefinition } from './imported-mesh/index.js';
+export { getPendingItemModelLoadCount, itemDefinition } from './item/index.js';
+export { registerWallObjectSceneCheck, wallObjectRenderedObservations, } from './item/wall-object-observations.js';
+export { leanToExtensionDefinition } from './lean-to-extension/index.js';
+export { levelDefinition } from './level/index.js';
+export { linesetDefinition } from './lineset/index.js';
+export { liquidLineDefinition, useLiquidLineToolOptions } from './liquid-line/index.js';
+export { measurementDefinition } from './measurement/index.js';
+export { pipeFittingDefinition } from './pipe-fitting/index.js';
+export { pipeSegmentDefinition } from './pipe-segment/index.js';
+export { pipeTrapDefinition } from './pipe-trap/index.js';
+export { ridgeVentDefinition } from './ridge-vent/index.js';
+export { roofDefinition, useRoofFootprintSource } from './roof/index.js';
+export { glazedRoofGeometryAdapter } from './roof/glazed-geometry.js';
+export { createGlazedRoofMaterials } from './roof/glazed-materials.js';
+export { createRoofGlazingPreview } from './roof/glazing-preview.js';
+export { roofSegmentDefinition } from './roof-segment/index.js';
+export { scanDefinition } from './scan/index.js';
+export { separatorDefinition } from './separator/definition.js';
+export { shelfDefinition } from './shelf/index.js';
+export { siteDefinition } from './site/index.js';
+export { skylightDefinition } from './skylight/index.js';
+export { slabDefinition } from './slab/index.js';
+export { solarPanelDefinition } from './solar-panel/index.js';
+export { spawnDefinition } from './spawn/index.js';
+export { stairDefinition } from './stair/index.js';
+export { guardBoxGeometry } from './stair/baluster-geometry.js';
+export { buildBalusterGuard } from './stair/baluster-guard.js';
+export { buildBoardsGuard } from './stair/boards-guard.js';
+export { buildCableGuard } from './stair/cable-guard.js';
+export { buildGlassGuard } from './stair/glass-guard.js';
+export { buildMetalGuard } from './stair/metal-guard.js';
+export { buildFloorplanStairEntry } from './stair/plan-entry.js';
+export { buildPostAndRailGuard } from './stair/post-and-rail-guard.js';
+export { stairSegmentDefinition } from './stair-segment/index.js';
+export { structuralGridDefinition } from './structural-grid/index.js';
+export { turbineVentDefinition } from './turbine-vent/index.js';
+export { unitDefinition } from './unit/index.js';
+export { wallDefinition } from './wall/index.js';
+export { windowDefinition } from './window/index.js';
+export { zoneDefinition } from './zone/index.js';

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.js';
+/**
+ * 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

@@ -1,10 +1,10 @@
 import { type NodeDefinition } from '@pascal-app/core';
-import { ItemNode } from './schema';
+import { ItemNode } from './schema.js';
 /**
  * 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,CAuN1D,CAAA"}

package/dist/item/definition.js

@@ -1,10 +1,14 @@
-import { getScaledDimensions, } from '@pascal-app/core';
-import { restingFloorplanAffectedIds } from '../shared/resting-surface-plan';
-import { buildItemContextualDimensions, buildItemFloorplan } from './floorplan';
-import { itemFloorplanMoveTarget } from './floorplan-move';
-import { itemPaint } from './paint';
-import { itemParametrics } from './parametrics';
-import { ItemNode } from './schema';
+import { getEffectiveCutterNode, getScaledDimensions, resolveCutterHost, toggleMechanism, } from '@pascal-app/core';
+import { itemHasLights, itemMechanism, toggleItemLights } from '../shared/item-interactions.js';
+import { itemBatchable } from '../shared/node-batch/batchable.js';
+import { restingFloorplanAffectedIds } from '../shared/resting-surface-plan.js';
+import { authoredItemFaceHost } from './authored-face-host.js';
+import { buildItemContextualDimensions, buildItemFloorplan } from './floorplan.js';
+import { itemFloorplanMoveTarget } from './floorplan-move.js';
+import { itemPaint } from './paint.js';
+import { itemParametrics } from './parametrics.js';
+import { itemPlacementNotice } from './placement-notice.js';
+import { ItemNode } from './schema.js';
 // 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
 // edge, both floated the same distance in front of the item. Mirrors the
@@ -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.js') },
         },
     },
     // Defaults shape is cast: the schema requires a fully-typed `asset`
@@ -188,7 +193,12 @@ export const itemDefinition = {
         },
     }),
     capabilities: {
+        reveal: { phase: 'furnishing', style: 'drop', height: 0.3 },
+        revealOnEdit: ['scale'],
+        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 +210,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
@@ -273,11 +284,11 @@ export const itemDefinition = {
     },
     renderer: {
         kind: 'parametric',
-        module: () => import('./renderer'),
+        module: () => import('./renderer.js'),
     },
-    preview: () => import('./renderer').then(({ ItemPreview }) => ({ default: ItemPreview })),
+    preview: () => import('./renderer.js').then(({ ItemPreview }) => ({ default: ItemPreview })),
     system: {
-        module: () => import('./system'),
+        module: () => import('./system.js'),
         // Same priority as the legacy ItemSystem.
         priority: 2,
     },
@@ -285,7 +296,7 @@ export const itemDefinition = {
     // Wraps the same placement coordinator the move-tool uses (surface
     // strategies for floor / wall / ceiling / item-surface). Replaces
     // the legacy `editor/src/components/tools/item/item-tool.tsx`.
-    tool: () => import('./tool'),
+    tool: () => import('./tool.js'),
     // Stage D — 3D move-tool (registry-driven). Adopts the moving node
     // and runs the placement coordinator with surface strategies for
     // floor / wall / ceiling / item-surface, including attachTo
@@ -293,18 +304,38 @@ export const itemDefinition = {
     // Replaces the legacy `MoveItemContent` in editor's dispatcher; the
     // `getRegistryAffordanceTool('item', 'move')` lookup picks this up.
     affordanceTools: {
-        move: () => import('./move-tool'),
+        move: () => import('./move-tool.js'),
     },
     // 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-move.js

@@ -1,10 +1,10 @@
 import { cascadeDirty, clearFaceHostItemFields, collectAlignmentAnchors, collectDescendants, createSceneApi, getBlockFaceFrame, getScaledDimensions, getSurfaceProvider, movingFootprintAnchors, nodeRegistry, resolveSupportSlabPatch, resolveSurfacePlacement, surfaceRegionContainsPoint, useLiveNodeOverrides, useScene, } from '@pascal-app/core';
 import { boundsOf, boxCorners, composeFrames, frame, transformPoint, } from '@pascal-app/core/procedural-items';
 import { applyFloorplanAlignment, isGridSnapActive, isMagneticSnapActive, surfaceAttachmentId, surfaceFramePose, updateSurfaceNode, useEditor, useInteractionScope, } from '@pascal-app/editor';
-import { createFloorplanCursorResolver } from '../shared/floorplan-cursor';
-import { restingNodePlanFrame } from '../shared/resting-surface-plan';
-import { findClosestWallInPlan, snapLocalXToNeighbors } from '../shared/wall-attach-target';
-import { resolveItemTransform } from './floorplan';
+import { createFloorplanCursorResolver } from '../shared/floorplan-cursor.js';
+import { restingNodePlanFrame } from '../shared/resting-surface-plan.js';
+import { findClosestWallInPlan, snapLocalXToNeighbors } from '../shared/wall-attach-target.js';
+import { resolveItemTransform } from './floorplan.js';
 function resolveItemPlanTransform(item, nodes) {
     const pose = resolveItemTransform(item, { resolve: (id) => nodes[id] });
     return {

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<`block_${string}` | `building_${string}` | `bvent_${string}` | `cabinet-module_${string}` | `cabinet_${string}` | `ceiling_${string}` | `chimney_${string}` | `column_${string}` | `construction-dimension_${string}` | `cupola_${string}` | `door_${string}` | `dormer_${string}` | `downspout_${string}` | `duct-fitting_${string}` | `duct-segment_${string}` | `duct-terminal_${string}` | `elevator_${string}` | `eyebrow-vent_${string}` | `fence-gate_${string}` | `fence-opening_${string}` | `fence_${string}` | `floor-opening_${string}` | `guide_${string}` | `gutter_${string}` | `hvac-equipment_${string}` | `imesh_${string}` | `item_${string}` | `leanto_${string}` | `level_${string}` | `lineset_${string}` | `liquid-line_${string}` | `measurement_${string}` | `pipe-fitting_${string}` | `pipe-segment_${string}` | `pipe-trap_${string}` | `procedural-item_${string}` | `roof_${string}` | `rseg_${string}` | `rvent_${string}` | `scan_${string}` | `separator_${string}` | `shelf_${string}` | `site_${string}` | `skylight_${string}` | `slab_${string}` | `solarpanel_${string}` | `spawn_${string}` | `sseg_${string}` | `stair_${string}` | `structural-grid_${string}` | `tvent_${string}` | `unit_${string}` | `wall_${string}` | `window_${string}` | `zone_${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"}