npm - @pascal-app/editor - Versions diffs - 0.9.1 → 0.9.2 - Mend

@pascal-app/editor 0.9.1 → 0.9.2

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (262) hide show

package/package.json +12 -9
package/src/components/editor/alignment-3d-guide-layer.tsx +10 -2
package/src/components/editor/bake-exporter.tsx +47 -0
package/src/components/editor/custom-camera-controls.tsx +63 -25
package/src/components/editor/editor-layout-mobile.tsx +5 -0
package/src/components/editor/editor-layout-v2.tsx +18 -0
package/src/components/editor/export-manager.tsx +71 -63
package/src/components/editor/fence-tangent-lines-3d.tsx +87 -0
package/src/components/editor/first-person/build-collider-world.test.ts +36 -3
package/src/components/editor/first-person/build-collider-world.ts +32 -5
package/src/components/editor/first-person-controls.tsx +118 -7
package/src/components/editor/floating-action-menu.tsx +410 -33
package/src/components/editor/floating-building-action-menu.tsx +1 -1
package/src/components/editor/floorplan-background-selection.test.ts +58 -0
package/src/components/editor/floorplan-background-selection.ts +3 -2
package/src/components/editor/floorplan-panel.tsx +1804 -849
package/src/components/editor/grid.tsx +166 -39
package/src/components/editor/group-actions.ts +457 -0
package/src/components/editor/group-floating-action-menu.tsx +130 -0
package/src/components/editor/group-move-3d.ts +397 -0
package/src/components/editor/group-rotate-handle.tsx +102 -64
package/src/components/editor/group-selection-box-3d.tsx +173 -0
package/src/components/editor/group-transform-shared.test.ts +192 -1
package/src/components/editor/group-transform-shared.ts +240 -7
package/src/components/editor/handles/handle-arrow.tsx +81 -23
package/src/components/editor/handles/use-handle-drag.ts +37 -4
package/src/components/editor/index.tsx +248 -27
package/src/components/editor/measurement-pill.tsx +62 -22
package/src/components/editor/node-action-menu.tsx +14 -1
package/src/components/editor/node-arrow-handles.tsx +366 -173
package/src/components/editor/opening-guides-3d-layer.tsx +144 -0
package/src/components/editor/quick-measurement-card.tsx +70 -0
package/src/components/editor/quick-measurement-hud.tsx +28 -0
package/src/components/editor/riser-diagram-panel.tsx +137 -0
package/src/components/editor/selection-manager.tsx +812 -466
package/src/components/editor/site-edge-labels.tsx +4 -4
package/src/components/editor/slab-hole-highlights.tsx +13 -5
package/src/components/editor/snapshot-capture-overlay.tsx +255 -115
package/src/components/editor/three-context-bridge.ts +22 -0
package/src/components/editor/thumbnail-generator.tsx +136 -43
package/src/components/editor/use-floorplan-background-placement.ts +113 -45
package/src/components/editor/use-floorplan-scene-data.ts +5 -5
package/src/components/editor/use-mesh-settle-epoch.ts +26 -0
package/src/components/editor/wall-measurement-label.tsx +3 -13
package/src/components/editor/wall-move-side-handles.tsx +36 -21
package/src/components/editor/wall-snap-beacon-layer.tsx +160 -6
package/src/components/editor-2d/floorplan-action-menu-layer.tsx +9 -5
package/src/components/editor-2d/floorplan-cursor-indicator-overlay.tsx +1 -1
package/src/components/editor-2d/floorplan-group-action-menu.tsx +87 -0
package/src/components/editor-2d/floorplan-group-move.tsx +701 -0
package/src/components/editor-2d/floorplan-measurement-tool-layer.test.ts +113 -0
package/src/components/editor-2d/floorplan-measurement-tool-layer.tsx +1656 -0
package/src/components/editor-2d/floorplan-quick-measure-layer.tsx +212 -0
package/src/components/editor-2d/floorplan-registry-action-menu.tsx +169 -4
package/src/components/editor-2d/floorplan-registry-move-overlay.tsx +300 -59
package/src/components/editor-2d/floorplan-snap-beacon-layer.tsx +5 -3
package/src/components/editor-2d/renderers/floorplan-label-angle.test.ts +15 -0
package/src/components/editor-2d/renderers/floorplan-label-angle.ts +14 -0
package/src/components/editor-2d/renderers/floorplan-placement-preview-layer.tsx +4 -1
package/src/components/editor-2d/renderers/floorplan-registry-layer.test.ts +308 -0
package/src/components/editor-2d/renderers/floorplan-registry-layer.tsx +1704 -342
package/src/components/editor-2d/renderers/floorplan-voronoi-layer.tsx +128 -0
package/src/components/systems/ceiling/ceiling-selection-affordance-system.tsx +419 -60
package/src/components/systems/ceiling/ceiling-system.tsx +97 -4
package/src/components/systems/roof/roof-edit-system.tsx +1768 -13
package/src/components/systems/selection-affordance-manager.tsx +38 -0
package/src/components/systems/zone/zone-label-editor-system.tsx +14 -1
package/src/components/systems/zone/zone-system.tsx +42 -13
package/src/components/tools/elevator/elevator-tool.tsx +34 -8
package/src/components/tools/elevator/move-elevator-tool.tsx +13 -2
package/src/components/tools/fence/fence-drafting.ts +80 -8
package/src/components/tools/item/move-tool.tsx +17 -13
package/src/components/tools/item/placement-math.test.ts +13 -1
package/src/components/tools/item/placement-math.ts +28 -2
package/src/components/tools/item/placement-strategies.ts +246 -5
package/src/components/tools/item/placement-types.ts +13 -1
package/src/components/tools/item/use-draft-node.ts +31 -1
package/src/components/tools/item/use-placement-coordinator.tsx +761 -121
package/src/components/tools/registry/move-registry-node-tool.tsx +561 -99
package/src/components/tools/roof/roof-tool.tsx +320 -94
package/src/components/tools/select/box-select-state.ts +18 -7
package/src/components/tools/select/box-select-tool.tsx +176 -40
package/src/components/tools/select/marquee-geometry.test.ts +161 -0
package/src/components/tools/select/marquee-geometry.ts +155 -0
package/src/components/tools/select/plane-box-select-tool.tsx +1 -8
package/src/components/tools/select/select-candidates.ts +1 -1
package/src/components/tools/shared/cursor-sphere.tsx +62 -26
package/src/components/tools/shared/drag-bounding-box.tsx +28 -4
package/src/components/tools/shared/facing-indicator.tsx +87 -0
package/src/components/tools/shared/facing-pose-indicator.tsx +54 -0
package/src/components/tools/shared/placement-box.tsx +183 -1
package/src/components/tools/shared/polygon-editor.tsx +276 -35
package/src/components/tools/site/site-boundary-editor.tsx +88 -36
package/src/components/tools/stair/stair-defaults.ts +1 -0
package/src/components/tools/stair/stair-tool.tsx +82 -11
package/src/components/tools/tool-manager.tsx +86 -25
package/src/components/tools/wall/wall-drafting.test.ts +330 -0
package/src/components/tools/wall/wall-drafting.ts +180 -103
package/src/components/tools/wall/wall-snap-geometry.test.ts +44 -0
package/src/components/tools/wall/wall-snap-geometry.ts +67 -6
package/src/components/tools/zone/zone-boundary-editor.tsx +5 -1
package/src/components/tools/zone/zone-tool.tsx +82 -88
package/src/components/ui/action-menu/camera-actions.tsx +24 -17
package/src/components/ui/action-menu/control-modes.tsx +40 -93
package/src/components/ui/action-menu/furnish-tools.tsx +5 -5
package/src/components/ui/action-menu/index.tsx +2 -4
package/src/components/ui/action-menu/measurement-control.tsx +188 -0
package/src/components/ui/action-menu/structure-tools.tsx +22 -13
package/src/components/ui/action-menu/view-toggles.tsx +42 -90
package/src/components/ui/command-palette/editor-commands.tsx +2 -2
package/src/components/ui/command-palette/index.tsx +4 -3
package/src/components/ui/controls/material-paint-panel.tsx +86 -17
package/src/components/ui/controls/material-picker.tsx +83 -152
package/src/components/ui/controls/material-properties-editor.tsx +108 -0
package/src/components/ui/controls/metric-control.tsx +118 -44
package/src/components/ui/controls/scene-material-list.tsx +247 -0
package/src/components/ui/controls/slider-control.tsx +88 -38
package/src/components/ui/floating-level-selector.tsx +1 -1
package/src/components/ui/helpers/building-helper.tsx +10 -23
package/src/components/ui/helpers/contextual-helper-panel.tsx +428 -0
package/src/components/ui/helpers/helper-manager.tsx +227 -14
package/src/components/ui/helpers/item-helper.tsx +28 -32
package/src/components/ui/helpers/registered-tool-helper.tsx +45 -11
package/src/components/ui/helpers/roof-helper.tsx +10 -12
package/src/components/ui/icon-ref.tsx +47 -0
package/src/components/ui/item-catalog/catalog-items.tsx +39 -1
package/src/components/ui/item-catalog/item-catalog.tsx +13 -36
package/src/components/ui/level-duplicate-dialog.tsx +1 -1
package/src/components/ui/panels/node-display.ts +17 -17
package/src/components/ui/panels/panel-manager.tsx +22 -13
package/src/components/ui/panels/panel-wrapper.tsx +24 -3
package/src/components/ui/panels/parametric-inspector.tsx +15 -2
package/src/components/ui/panels/reference-panel.tsx +54 -19
package/src/components/ui/primitives/shortcut-token.tsx +39 -3
package/src/components/ui/primitives/sidebar.tsx +1 -0
package/src/components/ui/sidebar/app-sidebar.tsx +5 -1
package/src/components/ui/sidebar/icon-rail.tsx +50 -31
package/src/components/ui/sidebar/panels/plugins-panel.tsx +218 -0
package/src/components/ui/sidebar/panels/settings-panel/index.tsx +71 -40
package/src/components/ui/sidebar/panels/settings-panel/keyboard-shortcuts-dialog.tsx +60 -6
package/src/components/ui/sidebar/panels/settings-panel/load-build-dialog.tsx +12 -4
package/src/components/ui/sidebar/panels/site-panel/ceiling-tree-node.tsx +4 -3
package/src/components/ui/sidebar/panels/site-panel/chimney-tree-node.tsx +10 -7
package/src/components/ui/sidebar/panels/site-panel/column-tree-node.tsx +1 -1
package/src/components/ui/sidebar/panels/site-panel/door-tree-node.tsx +7 -2
package/src/components/ui/sidebar/panels/site-panel/dormer-tree-node.tsx +10 -7
package/src/components/ui/sidebar/panels/site-panel/elevator-tree-node.tsx +1 -1
package/src/components/ui/sidebar/panels/site-panel/fence-tree-node.tsx +1 -1
package/src/components/ui/sidebar/panels/site-panel/gutter-tree-node.tsx +10 -7
package/src/components/ui/sidebar/panels/site-panel/index.tsx +40 -17
package/src/components/ui/sidebar/panels/site-panel/item-tree-node.tsx +31 -17
package/src/components/ui/sidebar/panels/site-panel/level-tree-node.tsx +1 -1
package/src/components/ui/sidebar/panels/site-panel/registry-tree-node.tsx +72 -25
package/src/components/ui/sidebar/panels/site-panel/roof-tree-node.tsx +7 -3
package/src/components/ui/sidebar/panels/site-panel/shelf-tree-node.tsx +12 -8
package/src/components/ui/sidebar/panels/site-panel/slab-tree-node.tsx +4 -3
package/src/components/ui/sidebar/panels/site-panel/solar-panel-tree-node.tsx +10 -7
package/src/components/ui/sidebar/panels/site-panel/spawn-tree-node.tsx +1 -1
package/src/components/ui/sidebar/panels/site-panel/stair-tree-node.tsx +2 -2
package/src/components/ui/sidebar/panels/site-panel/tree-node.tsx +44 -3
package/src/components/ui/sidebar/panels/site-panel/tree-structure.ts +36 -0
package/src/components/ui/sidebar/panels/site-panel/wall-tree-node.tsx +1 -1
package/src/components/ui/sidebar/panels/site-panel/window-tree-node.tsx +7 -2
package/src/components/ui/sidebar/panels/site-panel/zone-tree-node.tsx +3 -3
package/src/components/ui/sidebar/tab-bar.tsx +42 -28
package/src/components/ui/sidebar/use-plugin-panels.tsx +132 -0
package/src/components/ui/snap-target-badge.test.tsx +40 -0
package/src/components/ui/snap-target-badge.tsx +88 -0
package/src/components/viewer-overlay.tsx +85 -10
package/src/components/viewer-zone-system.tsx +6 -1
package/src/hooks/use-auto-save.test.ts +14 -0
package/src/hooks/use-auto-save.ts +54 -7
package/src/hooks/use-ceiling-events.ts +3 -2
package/src/hooks/use-drag-action.ts +4 -1
package/src/hooks/use-keyboard.ts +385 -40
package/src/index.tsx +219 -6
package/src/lib/active-placement-surface.ts +35 -0
package/src/lib/ceiling-plan-snap.ts +24 -0
package/src/lib/contextual-help.test.ts +112 -0
package/src/lib/contextual-help.ts +144 -0
package/src/lib/continuation.ts +64 -0
package/src/lib/direct-manipulation.test.ts +192 -0
package/src/lib/direct-manipulation.ts +109 -0
package/src/lib/editor-api.ts +23 -35
package/src/lib/floorplan/apply-alignment.test.ts +25 -0
package/src/lib/floorplan/apply-alignment.ts +18 -12
package/src/lib/floorplan/floorplan-export.tsx +364 -0
package/src/lib/floorplan/geometry.ts +53 -0
package/src/lib/floorplan/index.ts +3 -0
package/src/lib/floorplan/items.ts +5 -2
package/src/lib/floorplan/plan-coords.ts +21 -0
package/src/lib/fresh-planar-placement.test.ts +240 -3
package/src/lib/fresh-planar-placement.ts +68 -1
package/src/lib/glb-export.test.ts +441 -0
package/src/lib/glb-export.ts +874 -0
package/src/lib/history.ts +9 -0
package/src/lib/interaction/hot-set.test.ts +133 -0
package/src/lib/interaction/hot-set.ts +67 -0
package/src/lib/interaction/overlay-policy.test.ts +51 -0
package/src/lib/interaction/overlay-policy.ts +59 -0
package/src/lib/interaction/scope.ts +211 -0
package/src/lib/level-selection.ts +2 -2
package/src/lib/material-paint.ts +36 -49
package/src/lib/measurement-kind.test.ts +30 -0
package/src/lib/measurement-kind.ts +19 -0
package/src/lib/measurement-label.test.ts +47 -0
package/src/lib/measurement-label.ts +68 -0
package/src/lib/measurement-parser.ts +116 -0
package/src/lib/measurements.test.ts +183 -0
package/src/lib/measurements.ts +199 -0
package/src/lib/paint-scope.test.ts +454 -0
package/src/lib/paint-scope.ts +461 -0
package/src/lib/placement-drag-release.ts +23 -0
package/src/lib/planar-cursor-placement.test.ts +57 -0
package/src/lib/plugin-panels.test.ts +19 -0
package/src/lib/plugin-panels.ts +91 -0
package/src/lib/quick-measurement.test.ts +77 -0
package/src/lib/quick-measurement.ts +109 -0
package/src/lib/roof-duplication.ts +6 -6
package/src/lib/roof-hover-outline-proxy.ts +22 -0
package/src/lib/roof-wall-hit.ts +164 -0
package/src/lib/scene-clipboard.test.ts +196 -0
package/src/lib/scene-clipboard.ts +73 -8
package/src/lib/scene.ts +28 -5
package/src/lib/selection-routing.test.ts +298 -0
package/src/lib/selection-routing.ts +175 -0
package/src/lib/sfx/index.ts +1 -0
package/src/lib/sfx/movement-tick.test.ts +65 -0
package/src/lib/sfx/movement-tick.ts +18 -0
package/src/lib/sfx-bus.ts +50 -13
package/src/lib/sfx-player.test.ts +124 -0
package/src/lib/sfx-player.ts +111 -66
package/src/lib/slab-plan-snap.test.ts +93 -0
package/src/lib/slab-plan-snap.ts +108 -0
package/src/lib/snapping-mode.test.ts +138 -0
package/src/lib/snapping-mode.ts +179 -0
package/src/lib/stair-duplication.ts +4 -4
package/src/lib/surface-plan-snap.test.ts +71 -0
package/src/lib/surface-plan-snap.ts +256 -0
package/src/lib/use-linear-display.ts +40 -0
package/src/lib/world-grid-snap.ts +37 -5
package/src/store/use-direct-manipulation-feedback.ts +20 -0
package/src/store/use-editor.tsx +484 -114
package/src/store/use-facing-pose.ts +44 -0
package/src/store/use-fence-curve-draft.ts +21 -0
package/src/store/use-floorplan-draft-preview.ts +101 -0
package/src/store/use-floorplan-marquee.ts +50 -0
package/src/store/use-interaction-scope.test.ts +186 -0
package/src/store/use-interaction-scope.ts +132 -0
package/src/store/use-measurement-draft.test.ts +530 -0
package/src/store/use-measurement-draft.ts +543 -0
package/src/store/use-opening-guides.ts +41 -0
package/src/store/use-placement-preview.ts +11 -3
package/src/store/use-quick-measurement-hud.test.ts +53 -0
package/src/store/use-quick-measurement-hud.ts +77 -0
package/src/store/use-segment-draft-chain.ts +28 -0
package/src/store/use-stair-build-preview.ts +43 -0
package/src/store/use-wall-snap-indicator.ts +2 -0
package/src/components/editor/first-person/bvh-ecctrl.tsx +0 -860
package/src/components/editor/group-move-handle.tsx +0 -316
package/src/components/ui/panels/paint-panel.tsx +0 -163
package/src/lib/level-name.ts +0 -11

package/src/components/systems/selection-affordance-manager.tsx ADDED Viewed

@@ -0,0 +1,38 @@
+'use client'
+import { type AnyNodeId, useScene } from '@pascal-app/core'
+import { useViewer } from '@pascal-app/viewer'
+import { type ComponentType, Suspense, useMemo } from 'react'
+import { getRegistryAffordanceTool } from '../tools/shared/affordance-dispatch'
+/**
+ * Editor-mounted dispatcher for a kind's selection-time editing UI.
+ *
+ * Some kinds expose drag-to-edit affordances that should appear only
+ * while a single node of that kind is selected — duct / pipe / lineset
+ * path-point handles, fitting Alt-axis-cycling listeners. These read
+ * `useEditor` (grid snap step, rotation axis) and render the editor's
+ * `DimensionPill`, so they must NOT ride in `def.system` (which the
+ * viewer package mounts for the read-only route). The kind declares the
+ * component under `def.affordanceTools.selection` and this manager —
+ * mounted inside the editor only — loads it for the selected kind.
+ */
+export function SelectionAffordanceManager() {
+  const selectedIds = useViewer((s) => s.selection.selectedIds)
+  const selectedKind = useScene((s) => {
+    if (selectedIds.length !== 1) return null
+    return s.nodes[selectedIds[0] as AnyNodeId]?.type ?? null
+  })
+  const Component = useMemo<ComponentType | null>(() => {
+    if (!selectedKind) return null
+    return getRegistryAffordanceTool(selectedKind, 'selection')
+  }, [selectedKind])
+  if (!Component) return null
+  return (
+    <Suspense fallback={null}>
+      <Component />
+    </Suspense>
+  )
+}

package/src/components/systems/zone/zone-label-editor-system.tsx CHANGED Viewed

@@ -6,8 +6,10 @@ import { Check, Pencil } from 'lucide-react'
 import { useCallback, useEffect, useRef, useState } from 'react'
 import { createPortal } from 'react-dom'
 import { useShallow } from 'zustand/react/shallow'
+import { resolveOverlayPolicy } from '../../../lib/interaction/overlay-policy'
 import { sfxEmitter } from '../../../lib/sfx-bus'
 import useEditor from '../../../store/use-editor'
+import useInteractionScope from '../../../store/use-interaction-scope'
 // ─── Per-zone label editor ────────────────────────────────────────────────────
@@ -19,6 +21,10 @@ function ZoneLabelEditor({ zoneId }: { zoneId: ZoneNode['id'] }) {
   const selectedZoneId = useViewer((s) => s.selection.zoneId)
   const hoveredId = useViewer((s) => s.hoveredId)
   const mode = useEditor((s) => s.mode)
+  // During an active interaction the zone label is a context badge that steps
+  // back: faded + non-interactive so it can't be hovered/clicked mid-action.
+  const scope = useInteractionScope((s) => s.scope)
+  const labelStepBack = resolveOverlayPolicy(scope).contextBadges === 'faded'
   const isSelected = selectedZoneId === zoneId
   const isDeleteHovered = mode === 'delete' && hoveredId === zoneId
   const [editing, setEditing] = useState(false)
@@ -149,7 +155,8 @@ function ZoneLabelEditor({ zoneId }: { zoneId: ZoneNode['id'] }) {
     fontSize: 14,
     fontFamily: 'sans-serif',
     userSelect: 'none',
-    pointerEvents: 'auto',
+    pointerEvents: labelStepBack ? 'none' : 'auto',
+    opacity: labelStepBack ? 0.4 : undefined,
     display: 'inline-flex',
     alignItems: 'center',
     gap: 4,
@@ -309,6 +316,12 @@ export function ZoneLabelEditorSystem() {
         .map((n) => n.id as ZoneNode['id']),
     ),
   )
+  // The zone renderer unmounts its <Html> label when zones are hidden —
+  // unmount the portals with it, or each editor would hold (and rAF-poll for)
+  // a detached label element.
+  const showZones = useViewer((s) => s.showZones)
+  if (!showZones) return null
   return (
     <>

package/src/components/systems/zone/zone-system.tsx CHANGED Viewed

@@ -1,21 +1,46 @@
 import { sceneRegistry, useScene, type ZoneNode } from '@pascal-app/core'
 import { useViewer } from '@pascal-app/viewer'
 import { useFrame } from '@react-three/fiber'
+import { useEffect } from 'react'
 import { type Group, MathUtils, type Mesh } from 'three'
 import type { MeshBasicNodeMaterial } from 'three/webgpu'
+import { resolveOverlayPolicy } from '../../../lib/interaction/overlay-policy'
 import useEditor from '../../../store/use-editor'
+import useInteractionScope from '../../../store/use-interaction-scope'
 // Disable raycasting on zone geometry so clicks pass through to items underneath.
 // Zone selection in the editor is handled exclusively via the HTML label overlay.
 const noopRaycast = () => {}
 export const ZoneSystem = () => {
+  // Outside the zones layer (or during snapshot capture) zones unmount
+  // entirely — meshes AND drei <Html> labels, which cost per-frame matrix work
+  // + live DOM even at opacity 0. The renderer reads this viewer flag; the
+  // unmount cleanup restores the default so preview / first-person surfaces
+  // (which swap this system for ViewerZoneSystem) keep their labels.
+  const structureLayerState = useEditor((s) => s.structureLayer)
+  const isCaptureModeState = useEditor((s) => s.isCaptureMode)
+  useEffect(() => {
+    useViewer.getState().setShowZones(structureLayerState === 'zones' && !isCaptureModeState)
+    return () => useViewer.getState().setShowZones(true)
+  }, [structureLayerState, isCaptureModeState])
   useFrame((_, delta) => {
+    if (!useViewer.getState().showZones) return
     const structureLayer = useEditor.getState().structureLayer
     const editorMode = useEditor.getState().mode
     const selectedLevelId = useViewer.getState().selection.levelId
     const selectedZoneId = useViewer.getState().selection.zoneId
     const hoveredId = useViewer.getState().hoveredId
+    // Snapshot capture is a clean, camera-only surface — never show zone
+    // geometry or the HTML zone tags in the framed shot.
+    const isCaptureMode = useEditor.getState().isCaptureMode
+    // During any active interaction zone labels step back entirely — they are
+    // not a primary editing concern and would distract / invite misclicks.
+    const zoneLabelsHidden =
+      resolveOverlayPolicy(useInteractionScope.getState().scope).zoneLabels === 'hidden'
     const zoneGeometryVisible = structureLayer === 'zones'
     const zones = sceneRegistry.byType.zone || new Set()
@@ -35,12 +60,22 @@ export const ZoneSystem = () => {
       // Keep group visible (so <Html> labels stay active), hide/show meshes only.
       // Show meshes when: in zone mode, selected, or delete-hovered.
       if (!obj.visible) obj.visible = true
-      const meshVisible = zoneGeometryVisible || isSelected || isDeleteHovered
-      const targetOpacity = isSelected || isDeleteHovered ? 1 : zoneGeometryVisible ? 1 : 0
+      const meshVisible = !isCaptureMode && (zoneGeometryVisible || isSelected || isDeleteHovered)
+      const targetOpacity = isCaptureMode
+        ? 0
+        : isSelected || isDeleteHovered
+          ? 1
+          : zoneGeometryVisible
+            ? 1
+            : 0
+      // Raycast is re-disabled per frame (not once per group): the meshes
+      // remount whenever the zones layer toggles, so a one-shot flag on the
+      // persistent group would leave fresh meshes clickable.
       const walls = (obj as Group).getObjectByName('walls') as Mesh | undefined
       if (walls) {
         walls.visible = meshVisible
+        walls.raycast = noopRaycast
         const material = walls.material as MeshBasicNodeMaterial
         if (material?.userData?.uOpacity) {
           material.userData.uOpacity.value = MathUtils.lerp(
@@ -54,6 +89,7 @@ export const ZoneSystem = () => {
       const floor = (obj as Group).getObjectByName('floor') as Mesh | undefined
       if (floor) {
         floor.visible = meshVisible
+        floor.raycast = noopRaycast
         const material = floor.material as MeshBasicNodeMaterial
         if (material?.userData?.uOpacity) {
           material.userData.uOpacity.value = MathUtils.lerp(
@@ -64,17 +100,10 @@ export const ZoneSystem = () => {
         }
       }
-      // Disable raycasting once per zone object so geometry never intercepts clicks
-      if (!obj.userData.__raycastDisabled) {
-        obj.raycast = noopRaycast
-        obj.traverse((child) => {
-          child.raycast = noopRaycast
-        })
-        obj.userData.__raycastDisabled = true
-      }
-      // Labels: always visible on the current level (regardless of mode)
-      const showLabel = !!selectedLevelId && isOnSelectedLevel
+      // Labels: visible on the current level (regardless of mode), but never
+      // during snapshot capture.
+      const showLabel =
+        !isCaptureMode && !zoneLabelsHidden && !!selectedLevelId && isOnSelectedLevel
       const labelOpacity = showLabel ? '1' : '0'
       const labelEl = document.getElementById(`${zoneId}-label`)
       if (labelEl && labelEl.style.opacity !== labelOpacity) {

package/src/components/tools/elevator/elevator-tool.tsx CHANGED Viewed

@@ -9,11 +9,18 @@ import {
   resolveAlignment,
   useScene,
 } from '@pascal-app/core'
-import { useAlignmentGuides } from '@pascal-app/editor'
 import { useEffect, useMemo, useRef } from 'react'
 import * as THREE from 'three'
 import { resolveCurrentBuildingId, resolveElevatorSupportY } from '../../../lib/elevator-support'
 import { sfxEmitter } from '../../../lib/sfx-bus'
+import useAlignmentGuides from '../../../store/use-alignment-guides'
+import useEditor, {
+  isAlignmentGuideActive,
+  isGridSnapActive,
+  isMagneticSnapActive,
+} from '../../../store/use-editor'
 import usePlacementPreview from '../../../store/use-placement-preview'
 import { CursorSphere } from '../shared/cursor-sphere'
 import {
@@ -163,13 +170,16 @@ export const ElevatorTool: React.FC<ElevatorToolProps> = ({ buildingId, levelId,
     // point: resolving against the grid point would only ever catch anchors
     // that happen to sit on a grid line, so off-grid items (furniture, angled
     // walls) would never surface a guide. The matched axis locks exactly to the
-    // candidate's coordinate; the other axis keeps its grid snap. Alt bypasses.
+    // candidate's coordinate; the other axis keeps its grid snap. Guides are
+    // published in every snapping mode (including Off); the magnetic pull toward
+    // them (applySnap) applies only in 'lines' mode.
     const alignPoint = (
       gridX: number,
       gridZ: number,
       rawX: number,
       rawZ: number,
       bypass: boolean,
+      applySnap: boolean,
     ): [number, number] => {
       if (bypass || alignmentCandidates.length === 0) {
         useAlignmentGuides.getState().clear()
@@ -185,6 +195,7 @@ export const ElevatorTool: React.FC<ElevatorToolProps> = ({ buildingId, levelId,
         return [gridX, gridZ]
       }
       useAlignmentGuides.getState().set(ar.guides)
+      if (!applySnap) return [gridX, gridZ]
       let x = gridX
       let z = gridZ
       for (const guide of ar.guides) {
@@ -195,12 +206,20 @@ export const ElevatorTool: React.FC<ElevatorToolProps> = ({ buildingId, levelId,
     }
     const onGridMove = (event: GridEvent) => {
+      // Grid snap follows the global mode (live step so the HUD chip is
+      // honest); Off keeps the raw cursor. Shift cycles the mode centrally.
+      const step = useEditor.getState().gridSnapStep
       const [gridX, gridZ] = alignPoint(
-        Math.round(event.localPosition[0] * 2) / 2,
-        Math.round(event.localPosition[2] * 2) / 2,
+        isGridSnapActive()
+          ? Math.round(event.localPosition[0] / step) * step
+          : event.localPosition[0],
+        isGridSnapActive()
+          ? Math.round(event.localPosition[2] / step) * step
+          : event.localPosition[2],
         event.localPosition[0],
         event.localPosition[2],
-        event.nativeEvent?.altKey === true,
+        !isAlignmentGuideActive(),
+        isMagneticSnapActive(),
       )
       const supportY = resolveElevatorSupportY({
         buildingId: currentBuildingId,
@@ -220,6 +239,7 @@ export const ElevatorTool: React.FC<ElevatorToolProps> = ({ buildingId, levelId,
       })
       if (
+        (isGridSnapActive() || isMagneticSnapActive()) &&
         previousGridPosRef.current &&
         (gridX !== previousGridPosRef.current[0] || gridZ !== previousGridPosRef.current[1])
       ) {
@@ -237,12 +257,18 @@ export const ElevatorTool: React.FC<ElevatorToolProps> = ({ buildingId, levelId,
       })
       if (!latestBuildingId) return
+      const step = useEditor.getState().gridSnapStep
       const [gridX, gridZ] = alignPoint(
-        Math.round(event.localPosition[0] * 2) / 2,
-        Math.round(event.localPosition[2] * 2) / 2,
+        isGridSnapActive()
+          ? Math.round(event.localPosition[0] / step) * step
+          : event.localPosition[0],
+        isGridSnapActive()
+          ? Math.round(event.localPosition[2] / step) * step
+          : event.localPosition[2],
         event.localPosition[0],
         event.localPosition[2],
-        event.nativeEvent?.altKey === true,
+        !isAlignmentGuideActive(),
+        isMagneticSnapActive(),
       )
       commitElevatorPlacement(
         latestBuildingId,

package/src/components/tools/elevator/move-elevator-tool.tsx CHANGED Viewed

@@ -15,6 +15,7 @@ import {
 import { useCallback, useEffect, useRef, useState } from 'react'
 import { markToolCancelConsumed } from '../../../hooks/use-keyboard'
 import { resolveElevatorSupportY } from '../../../lib/elevator-support'
+import { consumePlacementDragRelease } from '../../../lib/placement-drag-release'
 import { sfxEmitter } from '../../../lib/sfx-bus'
 import useEditor from '../../../store/use-editor'
 import { CursorSphere } from '../shared/cursor-sphere'
@@ -131,8 +132,9 @@ export function MoveElevatorTool({
     }
     const onGridMove = (event: GridEvent) => {
-      const rawX = Math.round(event.localPosition[0] * 2) / 2
-      const rawZ = Math.round(event.localPosition[2] * 2) / 2
+      const bypassSnap = event.nativeEvent?.shiftKey === true
+      const rawX = bypassSnap ? event.localPosition[0] : Math.round(event.localPosition[0] * 2) / 2
+      const rawZ = bypassSnap ? event.localPosition[2] : Math.round(event.localPosition[2] * 2) / 2
       const anchor = dragAnchorRef.current ?? [rawX, rawZ]
       dragAnchorRef.current = anchor
       const gridX = movingNode.position[0] + (rawX - anchor[0])
@@ -145,6 +147,7 @@ export function MoveElevatorTool({
       })
       if (
+        !bypassSnap &&
         previousGridPosRef.current &&
         (gridX !== previousGridPosRef.current[0] || gridZ !== previousGridPosRef.current[1])
       ) {
@@ -158,6 +161,7 @@ export function MoveElevatorTool({
     }
     const onGridClick = (event: GridEvent) => {
+      if (wasCommitted) return
       const nextPosition: ElevatorNode['position'] = [...previewPositionRef.current]
       wasCommitted = true
@@ -187,6 +191,11 @@ export function MoveElevatorTool({
       event.nativeEvent?.stopPropagation?.()
     }
+    const onPlacementDragPointerUp = (event: PointerEvent) => {
+      if (!consumePlacementDragRelease(event)) return
+      onGridClick({ nativeEvent: event } as unknown as GridEvent)
+    }
     const onCancel = () => {
       wasCancelled = true
       clearPreview()
@@ -229,6 +238,7 @@ export function MoveElevatorTool({
     emitter.on('grid:click', onGridClick)
     emitter.on('tool:cancel', onCancel)
     window.addEventListener('keydown', onKeyDown)
+    window.addEventListener('pointerup', onPlacementDragPointerUp)
     return () => {
       clearPreview()
@@ -245,6 +255,7 @@ export function MoveElevatorTool({
       emitter.off('grid:click', onGridClick)
       emitter.off('tool:cancel', onCancel)
       window.removeEventListener('keydown', onKeyDown)
+      window.removeEventListener('pointerup', onPlacementDragPointerUp)
     }
   }, [movingNode, exitMoveMode])

package/src/components/tools/fence/fence-drafting.ts CHANGED Viewed

@@ -1,8 +1,11 @@
 import {
+  DEFAULT_ANGLE_STEP,
   FenceNode,
+  getTwoPointFenceCurveTangents,
   getWallCurveFrameAt,
   getWallCurveLength,
   isCurvedWall,
+  snapPointAlongAngleRay,
   useScene,
   type WallNode,
 } from '@pascal-app/core'
@@ -12,9 +15,7 @@ import useEditor from '../../../store/use-editor'
 import {
   findWallSnapTarget,
   getSegmentGridStep,
-  getWallAngleSnapStep,
   isSegmentLongEnough,
-  snapPointTo45Degrees,
   snapPointToGrid,
   type WallPlanPoint,
 } from '../wall/wall-drafting'
@@ -132,7 +133,9 @@ export function snapFenceDraftPoint(args: {
   start?: FencePlanPoint
   angleSnap?: boolean
   ignoreFenceIds?: string[]
-  /** Override the grid step (e.g. `WALL_FINE_GRID_STEP` for precision mode). */
+  bypassSnap?: boolean
+  magnetic?: boolean
+  /** Override the grid step. */
   step?: number
   /**
    * Optional grid-snap function. When provided, replaces the default
@@ -142,17 +145,45 @@ export function snapFenceDraftPoint(args: {
    */
   gridSnap?: (point: FencePlanPoint) => FencePlanPoint
 }): FencePlanPoint {
-  const { point, walls, fences, start, angleSnap = false, ignoreFenceIds, step, gridSnap } = args
+  const {
+    point,
+    walls,
+    fences,
+    start,
+    angleSnap = false,
+    ignoreFenceIds,
+    bypassSnap = false,
+    magnetic = true,
+    step,
+    gridSnap,
+  } = args
+  if (bypassSnap) return point
   const gridStep = step ?? getSegmentGridStep()
-  const angleStep = getWallAngleSnapStep(gridStep)
-  const basePoint =
+  // Magnetic endpoint snap must beat the angle lock, and the lock can pull
+  // the cursor far enough off an endpoint that probing the locked point
+  // would never engage — so under the lock, probe from the RAW cursor
+  // first (mirrors `snapWallDraftPointDetailed`'s special-point pre-pass).
+  if (start && angleSnap) {
+    const rawTarget =
+      magnetic &&
+      (findFenceSnapTarget(point, fences, ignoreFenceIds) ?? findWallSnapTarget(point, walls))
+    if (rawTarget) return rawTarget
+  }
+  // The angle path snaps the distance ALONG the 15° ray — a scalar, the
+  // same in world and local frames — so the `gridSnap` world-grid override
+  // only applies when the angle lock is off.
+  const basePoint: FencePlanPoint =
     start && angleSnap
-      ? snapPointTo45Degrees(start, point, gridStep, angleStep, gridSnap)
+      ? [...snapPointAlongAngleRay(start, point, DEFAULT_ANGLE_STEP, gridStep)]
       : gridSnap
         ? gridSnap(point)
         : snapPointToGrid(point, gridStep)
-  const fenceSnapTarget = findFenceSnapTarget(basePoint, fences, ignoreFenceIds)
+  if (!magnetic) return basePoint
+  const fenceSnapTarget = findFenceSnapTarget(basePoint, fences, ignoreFenceIds)
   return fenceSnapTarget ?? findWallSnapTarget(basePoint, walls) ?? basePoint
 }
@@ -184,3 +215,44 @@ export function createFenceOnCurrentLevel(
   return fence
 }
+/**
+ * Commit a smooth spline fence from a list of drawn control points. The
+ * centerline becomes a Catmull-Rom curve through `path`; `start`/`end` are
+ * pinned to the first/last point so endpoint handles, bbox, and miter
+ * references stay valid. Requires >= 2 points spanning a usable distance.
+ */
+export function createSplineFenceOnCurrentLevel(
+  path: FencePlanPoint[],
+  tangents = getTwoPointFenceCurveTangents(path),
+): FenceNode | null {
+  const currentLevelId = useViewer.getState().selection.levelId
+  const { createNode, nodes } = useScene.getState()
+  if (!currentLevelId || path.length < 2) {
+    return null
+  }
+  const start = path[0]!
+  const end = path[path.length - 1]!
+  // A degenerate single-point-ish path (all clicks on one spot) is rejected
+  // the same way a too-short straight segment is.
+  if (!isSegmentLongEnough(start, end) && path.length < 3) {
+    return null
+  }
+  const fenceCount = Object.values(nodes).filter((node) => node.type === 'fence').length
+  const defaults = useEditor.getState().toolDefaults.fence ?? {}
+  const fence = FenceNode.parse({
+    ...defaults,
+    name: `Fence ${fenceCount + 1}`,
+    start,
+    end,
+    path,
+    tangents,
+  })
+  createNode(fence, currentLevelId)
+  sfxEmitter.emit('sfx:structure-build')
+  return fence
+}

package/src/components/tools/item/move-tool.tsx CHANGED Viewed

@@ -1,7 +1,7 @@
 import type { AnyNodeId, ElevatorNode, SpawnNode } from '@pascal-app/core'
 import { nodeRegistry } from '@pascal-app/core'
 import { Suspense } from 'react'
-import useEditor from '../../../store/use-editor'
+import { useMovingNode } from '../../../store/use-interaction-scope'
 import { MoveElevatorTool } from '../elevator/move-elevator-tool'
 import { MoveRegistryNodeTool } from '../registry/move-registry-node-tool'
 import { getRegistryAffordanceTool } from '../shared/affordance-dispatch'
@@ -9,14 +9,17 @@ import { getRegistryAffordanceTool } from '../shared/affordance-dispatch'
 /**
  * MoveTool dispatcher. Routes to (in order):
  *
- *   1. `MoveRegistryNodeTool` — generic translate-on-XZ for kinds that
- *      declare `capabilities.movable` (shelf, spawn, item-with-floor-attach,
- *      …).
- *   2. `def.affordanceTools.move` — kind-owned move component, lazy-loaded
- *      via `getRegistryAffordanceTool`. Covers both generic movers
- *      (slab / ceiling / wall / fence / column / item / door / window) and
- *      the bespoke roof / roof-segment / stair / stair-segment / building
- *      movers ported into `@pascal-app/nodes`.
+ *   1. `def.affordanceTools.move` — kind-owned move component, lazy-loaded
+ *      via `getRegistryAffordanceTool`. Covers generic movers
+ *      (slab / ceiling / wall / fence / column / item / door / window), the
+ *      bespoke roof / roof-segment / stair / stair-segment / building
+ *      movers, and the polyline / fitting ghost-placement movers
+ *      (duct-segment / duct-fitting). A kind that ships its own mover wins
+ *      even if it also declares `capabilities.movable` (duct-fitting keeps
+ *      `movable` for the inspector / hint readers but places via its ghost).
+ *   2. `MoveRegistryNodeTool` — generic translate-on-XZ for kinds that only
+ *      declare `capabilities.movable` (shelf, spawn, duct-terminal,
+ *      hvac-equipment, …).
  *   3. `elevator` is the lone remaining legacy arm — its bespoke cab/shaft
  *      mover hasn't been ported to a kind-owned affordance yet.
  */
@@ -24,14 +27,11 @@ export const MoveTool: React.FC<{
   onNodeMoved?: (nodeId: AnyNodeId) => void
   onSpawnMoved?: (nodeId: SpawnNode['id']) => void
 }> = ({ onNodeMoved }) => {
-  const movingNode = useEditor((state) => state.movingNode)
+  const movingNode = useMovingNode()
   if (!movingNode) return null
   const def = nodeRegistry.get(movingNode.type)
-  if (def?.capabilities?.movable) {
-    return <MoveRegistryNodeTool node={movingNode} />
-  }
   const RegistryMove = getRegistryAffordanceTool(movingNode.type, 'move')
   if (RegistryMove) {
@@ -42,6 +42,10 @@ export const MoveTool: React.FC<{
     )
   }
+  if (def?.capabilities?.movable) {
+    return <MoveRegistryNodeTool node={movingNode} />
+  }
   if (movingNode.type === 'elevator')
     return <MoveElevatorTool node={movingNode as ElevatorNode} onCommitted={onNodeMoved} />
   return null

package/src/components/tools/item/placement-math.test.ts CHANGED Viewed

@@ -1,5 +1,5 @@
 import { describe, expect, test } from 'bun:test'
-import { stripTransient } from './placement-math'
+import { getDetachedAttachmentPreviewLift, stripTransient } from './placement-math'
 describe('stripTransient', () => {
   test('removes placement-only metadata flags before commit', () => {
@@ -8,3 +8,15 @@ describe('stripTransient', () => {
     })
   })
 })
+describe('getDetachedAttachmentPreviewLift', () => {
+  test('raises attach-only item previews while they are detached from their host', () => {
+    expect(getDetachedAttachmentPreviewLift('wall')).toBeGreaterThan(0)
+    expect(getDetachedAttachmentPreviewLift('wall-side')).toBeGreaterThan(0)
+    expect(getDetachedAttachmentPreviewLift('ceiling')).toBeGreaterThan(0)
+  })
+  test('keeps floor item previews on the floor', () => {
+    expect(getDetachedAttachmentPreviewLift(undefined)).toBe(0)
+  })
+})

package/src/components/tools/item/placement-math.ts CHANGED Viewed

@@ -1,9 +1,26 @@
 import { type AssetInput, isObject } from '@pascal-app/core'
 import { Euler, Matrix3, type Matrix4, Quaternion, Vector3 } from 'three'
-import useEditor from '../../../store/use-editor'
+import { resolveSnapFlags } from '../../../lib/snapping-mode'
+import useEditor, { getActiveSnappingMode } from '../../../store/use-editor'
+// Sentinel returned when the active context's snapping mode disables grid snap.
+// The snap helpers below treat any `step <= 0` as "no grid snap" and pass the
+// raw value through. For items the default mode is now `lines` (grid off), so
+// item placement/move is free + line-snap unless the user opts into `grid`.
 function getGridSnapStep(): number {
-  return useEditor.getState().gridSnapStep
+  return resolveSnapFlags(getActiveSnappingMode()).grid ? useEditor.getState().gridSnapStep : 0
+}
+const ROTATION_QUANTUM = Math.PI / 4
+/**
+ * R/T rotation: round the current angle to the nearest 45° then step ONE
+ * increment in `direction` (+1 / -1), so the node always lands on a clean 45°
+ * multiple regardless of its starting angle (12° → 45°, 40° → 90°) rather than a
+ * blind ±45° from an arbitrary angle.
+ */
+export function steppedRotation(current: number, direction: 1 | -1): number {
+  return (Math.round(current / ROTATION_QUANTUM) + direction) * ROTATION_QUANTUM
 }
 function positiveModulo(value: number, divisor: number): number {
@@ -14,6 +31,7 @@ function positiveModulo(value: number, divisor: number): number {
  * Snaps a position to the active grid step, aligning item edges to grid lines.
  */
 export function snapToGrid(position: number, dimension: number, step = getGridSnapStep()): number {
+  if (step <= 0) return position
   const halfDim = dimension / 2
   const offset = positiveModulo(halfDim, step)
   return Math.round((position - offset) / step) * step + offset
@@ -23,6 +41,7 @@ export function snapToGrid(position: number, dimension: number, step = getGridSn
  * Snap a value to the active grid step (used for wall-local positions).
  */
 export function snapToHalf(value: number, step = getGridSnapStep()): number {
+  if (step <= 0) return value
   return Math.round(value / step) * step
 }
@@ -30,6 +49,7 @@ export function snapToHalf(value: number, step = getGridSnapStep()): number {
  * Round a value up to the next multiple of `step`, with a minimum of `step`.
  */
 export function snapUpToGridStep(value: number, step = getGridSnapStep()): number {
+  if (step <= 0) return value
   return Math.max(step, Math.ceil(value / step) * step)
 }
@@ -55,6 +75,12 @@ export function getGridAlignedDimensions(
   return [snapUpToGridStep(w, step), h, snapUpToGridStep(d, step)]
 }
+export function getDetachedAttachmentPreviewLift(
+  attachTo: AssetInput['attachTo'] | null | undefined,
+): number {
+  return attachTo ? 0.45 : 0
+}
 /**
  * Calculate cursor rotation in WORLD space from wall normal and orientation.
  */