@pascal-app/nodes 1.0.0-beta.5 → 1.0.0

package/dist/duct-fitting/parametrics.js

@@ -2,7 +2,7 @@ import { useScene, } from '@pascal-app/core';
 import { Vector3 } from 'three';
 import { autoOffsetInvalidationUpdates, readAutoOffsetTag, withAutoOffsetTag, } from '../shared/auto-offset-tag';
 import { DuctFittingSizeSwapEditor } from './inspector-editors';
-import { getDuctFittingPorts } from './ports';
+import { adapterShape, getDuctFittingPorts } from './ports';
 /** Schema bounds for `diameter` / `diameter2`. */
 const clampDiameter = (d) => Math.min(48, Math.max(2, d));
 const equivalentDiameterIn = (widthIn, heightIn) => 2 * Math.sqrt((widthIn * heightIn) / Math.PI);
@@ -81,6 +81,10 @@ export const ductFittingParametrics = {
     // this the legs keep the stale round size.
     derive: (next, patch) => {
         const out = {};
+        if (next.fittingType === 'transition') {
+            out.inletShape = adapterShape(next);
+            out.outletShape = adapterShape(next, true);
+        }
         if ('shape' in patch && next.fittingType !== 'reducer') {
             // `next` still carries the pre-edit diameters, so its ports sit
             // where the mated ducts end — size off the actual neighbours.
@@ -111,13 +115,15 @@ export const ductFittingParametrics = {
         // Non-round legs write their area-equivalent round size back into the
         // diameters (leg lengths + advertised ports). A transition's inlet is
         // always the rect end regardless of `shape`.
-        const runShape = next.fittingType === 'transition' ? 'rect' : next.shape;
-        if (runShape !== 'round' && next.fittingType !== 'reducer') {
+        const adapter = ['transition', 'reducer'].includes(next.fittingType);
+        const runShape = adapter ? adapterShape(next) : next.shape;
+        if (runShape !== 'round') {
             const equivalent = runShape === 'oval' ? ovalEquivalentDiameterIn : equivalentDiameterIn;
             out.diameter = clampDiameter(equivalent(out.width ?? next.width, out.height ?? next.height));
         }
-        const shape2 = out.shape2 ?? next.shape2;
-        if ((next.fittingType === 'tee' || next.fittingType === 'cross') && shape2 !== 'round') {
+        const shape2 = adapter ? adapterShape(next, true) : (out.shape2 ?? next.shape2);
+        if ((adapter || next.fittingType === 'tee' || next.fittingType === 'cross') &&
+            shape2 !== 'round') {
             const equivalent2 = shape2 === 'oval' ? ovalEquivalentDiameterIn : equivalentDiameterIn;
             out.diameter2 = clampDiameter(equivalent2(out.width2 ?? next.width2, out.height2 ?? next.height2));
         }
@@ -198,8 +204,16 @@ export const ductFittingParametrics = {
                 {
                     key: 'fittingType',
                     kind: 'enum',
-                    options: ['elbow', 'tee', 'cross', 'reducer', 'transition'],
-                    display: 'segmented',
+                    options: [
+                        'elbow',
+                        'tee',
+                        'cross',
+                        'reducer',
+                        'transition',
+                        'end-cap',
+                        'damper',
+                        'access-panel',
+                    ],
                 },
                 {
                     key: 'angle',
@@ -210,6 +224,33 @@ export const ductFittingParametrics = {
                     step: 15,
                     visibleIf: (n) => n.fittingType === 'elbow',
                 },
+                {
+                    key: 'damperAngle',
+                    kind: 'number',
+                    unit: '°',
+                    min: 0,
+                    max: 90,
+                    step: 5,
+                    visibleIf: (n) => n.fittingType === 'damper',
+                },
+                {
+                    key: 'panelWidth',
+                    kind: 'number',
+                    unit: 'm',
+                    min: 0.1,
+                    max: 1.2,
+                    step: 0.05,
+                    visibleIf: (n) => n.fittingType === 'access-panel',
+                },
+                {
+                    key: 'panelHeight',
+                    kind: 'number',
+                    unit: 'm',
+                    min: 0.1,
+                    max: 1.2,
+                    step: 0.05,
+                    visibleIf: (n) => n.fittingType === 'access-panel',
+                },
                 {
                     key: 'branchAngle',
                     kind: 'number',
@@ -230,6 +271,18 @@ export const ductFittingParametrics = {
         {
             label: 'Connections',
             fields: [
+                {
+                    key: 'inletShape',
+                    kind: 'enum',
+                    options: ['round', 'rect', 'oval'],
+                    visibleIf: (n) => ['reducer', 'transition'].includes(n.fittingType),
+                },
+                {
+                    key: 'outletShape',
+                    kind: 'enum',
+                    options: ['round', 'rect', 'oval'],
+                    visibleIf: (n) => ['reducer', 'transition'].includes(n.fittingType),
+                },
                 {
                     key: 'shape',
                     kind: 'enum',
@@ -248,7 +301,8 @@ export const ductFittingParametrics = {
                     step: 1,
                     // Hidden when the run legs are rect / oval (transition's inlet
                     // always is) — `diameter` is then derived as the area equivalent.
-                    visibleIf: (n) => n.fittingType === 'reducer' || (n.fittingType !== 'transition' && n.shape === 'round'),
+                    visibleIf: (n) => (['reducer', 'transition'].includes(n.fittingType) ? adapterShape(n) : n.shape) ===
+                        'round',
                 },
                 {
                     key: 'width',
@@ -257,7 +311,8 @@ export const ductFittingParametrics = {
                     min: 4,
                     max: 60,
                     step: 1,
-                    visibleIf: (n) => n.fittingType === 'transition' || (n.shape !== 'round' && n.fittingType !== 'reducer'),
+                    visibleIf: (n) => (['reducer', 'transition'].includes(n.fittingType) ? adapterShape(n) : n.shape) !==
+                        'round',
                 },
                 {
                     key: 'height',
@@ -266,13 +321,15 @@ export const ductFittingParametrics = {
                     min: 3,
                     max: 40,
                     step: 1,
-                    visibleIf: (n) => n.fittingType === 'transition' || (n.shape !== 'round' && n.fittingType !== 'reducer'),
+                    visibleIf: (n) => (['reducer', 'transition'].includes(n.fittingType) ? adapterShape(n) : n.shape) !==
+                        'round',
                 },
                 {
                     key: 'swapWidthHeight',
                     kind: 'custom',
                     component: DuctFittingSizeSwapEditor,
-                    visibleIf: (n) => n.fittingType === 'transition' || (n.shape !== 'round' && n.fittingType !== 'reducer'),
+                    visibleIf: (n) => (['reducer', 'transition'].includes(n.fittingType) ? adapterShape(n) : n.shape) !==
+                        'round',
                 },
                 {
                     key: 'shape2',
@@ -288,9 +345,11 @@ export const ductFittingParametrics = {
                     min: 4,
                     max: 24,
                     step: 1,
-                    visibleIf: (n) => n.fittingType !== 'elbow' &&
+                    visibleIf: (n) => ['tee', 'cross', 'reducer', 'transition'].includes(n.fittingType) &&
                         (n.fittingType !== 'tee' || n.shape2 === 'round') &&
-                        (n.fittingType !== 'cross' || n.shape2 === 'round'),
+                        (n.fittingType !== 'cross' || n.shape2 === 'round') &&
+                        (!['reducer', 'transition'].includes(n.fittingType) ||
+                            adapterShape(n, true) === 'round'),
                 },
                 {
                     key: 'width2',
@@ -299,7 +358,9 @@ export const ductFittingParametrics = {
                     min: 4,
                     max: 60,
                     step: 1,
-                    visibleIf: (n) => (n.fittingType === 'tee' || n.fittingType === 'cross') && n.shape2 !== 'round',
+                    visibleIf: (n) => ['reducer', 'transition'].includes(n.fittingType)
+                        ? adapterShape(n, true) !== 'round'
+                        : (n.fittingType === 'tee' || n.fittingType === 'cross') && n.shape2 !== 'round',
                 },
                 {
                     key: 'height2',
@@ -308,7 +369,9 @@ export const ductFittingParametrics = {
                     min: 3,
                     max: 40,
                     step: 1,
-                    visibleIf: (n) => (n.fittingType === 'tee' || n.fittingType === 'cross') && n.shape2 !== 'round',
+                    visibleIf: (n) => ['reducer', 'transition'].includes(n.fittingType)
+                        ? adapterShape(n, true) !== 'round'
+                        : (n.fittingType === 'tee' || n.fittingType === 'cross') && n.shape2 !== 'round',
                 },
                 {
                     key: 'ductMaterial',

package/dist/duct-fitting/ports.d.ts

@@ -26,6 +26,7 @@ type LocalPort = {
  * 135° → upstream lateral); reducer -X → +X.
  */
 export declare function localFittingPorts(node: DuctFittingNode): LocalPort[];
+export declare function adapterShape(node: DuctFittingNode, outlet?: boolean): 'round' | 'rect' | 'oval';
 /** `def.ports` — local ports transformed into level-local space. */
 export declare function getDuctFittingPorts(node: DuctFittingNode): NodePort[];
 export {};

package/dist/duct-fitting/ports.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"ports.d.ts","sourceRoot":"","sources":["../../src/duct-fitting/ports.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,kBAAkB,CAAA;AAChD,OAAO,EAAS,OAAO,EAAE,MAAM,OAAO,CAAA;AACtC,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,UAAU,CAAA;AAI/C;;;;;GAKG;AACH,wBAAgB,gBAAgB,CAAC,cAAc,EAAE,MAAM,GAAG,MAAM,CAG/D;AAED,KAAK,SAAS,GAAG;IAAE,EAAE,EAAE,MAAM,CAAC;IAAC,QAAQ,EAAE,OAAO,CAAC;IAAC,SAAS,EAAE,OAAO,CAAC;IAAC,QAAQ,EAAE,MAAM,CAAA;CAAE,CAAA;AAExF;;;;;;;;;;GAUG;AACH,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,eAAe,GAAG,SAAS,EAAE,CAoGpE;AAED,oEAAoE;AACpE,wBAAgB,mBAAmB,CAAC,IAAI,EAAE,eAAe,GAAG,QAAQ,EAAE,CAcrE"}
+{"version":3,"file":"ports.d.ts","sourceRoot":"","sources":["../../src/duct-fitting/ports.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,kBAAkB,CAAA;AAChD,OAAO,EAAS,OAAO,EAAE,MAAM,OAAO,CAAA;AACtC,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,UAAU,CAAA;AAI/C;;;;;GAKG;AACH,wBAAgB,gBAAgB,CAAC,cAAc,EAAE,MAAM,GAAG,MAAM,CAG/D;AAED,KAAK,SAAS,GAAG;IAAE,EAAE,EAAE,MAAM,CAAC;IAAC,QAAQ,EAAE,OAAO,CAAC;IAAC,SAAS,EAAE,OAAO,CAAC;IAAC,QAAQ,EAAE,MAAM,CAAA;CAAE,CAAA;AAExF;;;;;;;;;;GAUG;AACH,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,eAAe,GAAG,SAAS,EAAE,CAyHpE;AAED,wBAAgB,YAAY,CAAC,IAAI,EAAE,eAAe,EAAE,MAAM,UAAQ,GAAG,OAAO,GAAG,MAAM,GAAG,MAAM,CAO7F;AAED,oEAAoE;AACpE,wBAAgB,mBAAmB,CAAC,IAAI,EAAE,eAAe,GAAG,QAAQ,EAAE,CAgCrE"}

package/dist/duct-fitting/ports.js

@@ -22,6 +22,28 @@ export function fittingLegLength(diameterInches) {
  * 135° → upstream lateral); reducer -X → +X.
  */
 export function localFittingPorts(node) {
+    if (node.fittingType === 'access-panel')
+        return [];
+    if (['end-cap', 'damper', 'coupling'].includes(node.fittingType)) {
+        const half = node.fittingType === 'end-cap' ? 0.025 : 0.1;
+        const inlet = {
+            id: 'inlet',
+            position: new Vector3(-half, 0, 0),
+            direction: new Vector3(-1, 0, 0),
+            diameter: node.diameter,
+        };
+        return node.fittingType === 'end-cap'
+            ? [inlet]
+            : [
+                inlet,
+                {
+                    id: 'outlet',
+                    position: new Vector3(half, 0, 0),
+                    direction: new Vector3(1, 0, 0),
+                    diameter: node.diameter,
+                },
+            ];
+    }
     const main = fittingLegLength(node.diameter);
     if (node.fittingType === 'elbow') {
         const theta = (node.angle * Math.PI) / 180;
@@ -122,6 +144,15 @@ export function localFittingPorts(node) {
         },
     ];
 }
+export function adapterShape(node, outlet = false) {
+    const inlet = node.inletShape ?? (node.fittingType === 'transition' ? 'rect' : 'round');
+    if (!outlet)
+        return inlet;
+    const target = node.outletShape ?? 'round';
+    if (node.fittingType === 'transition' && target === inlet)
+        return inlet === 'round' ? 'rect' : 'round';
+    return target;
+}
 /** `def.ports` — local ports transformed into level-local space. */
 export function getDuctFittingPorts(node) {
     const euler = new Euler(node.rotation[0], node.rotation[1], node.rotation[2]);
@@ -134,6 +165,21 @@ export function getDuctFittingPorts(node) {
             position: [position.x, position.y, position.z],
             direction: [direction.x, direction.y, direction.z],
             diameter: port.diameter,
+            shape: node.fittingType === 'reducer' || node.fittingType === 'transition'
+                ? adapterShape(node, port.id === 'outlet')
+                : node.shape === 'round'
+                    ? 'round'
+                    : port.id.startsWith('branch')
+                        ? node.shape2
+                        : node.shape,
+            width: port.id.startsWith('branch') ||
+                (port.id === 'outlet' && ['reducer', 'transition'].includes(node.fittingType))
+                ? node.width2
+                : node.width,
+            height: port.id.startsWith('branch') ||
+                (port.id === 'outlet' && ['reducer', 'transition'].includes(node.fittingType))
+                ? node.height2
+                : node.height,
             system: node.system,
         };
     });

package/dist/duct-fitting/tool.d.ts

@@ -1,3 +1,22 @@
+import { DuctFittingNode } from '@pascal-app/core';
+import { Quaternion } from 'three';
+import { type ScenePort } from '../shared/ports';
+type Placement = {
+    position: [number, number, number];
+    rotation: [number, number, number];
+    snapPort: ScenePort | null;
+    node: DuctFittingNode;
+    valid: boolean;
+};
+/**
+ * Resolve where the fitting would land for a cursor at `raw`:
+ *   - Near an existing port → mate: orientation aligns the inlet onto
+ *     the port (plus the user's manual R/T rotation, pivoting around
+ *     the inlet collar so it stays on the port while the body sweeps).
+ *   - Otherwise → grid-snapped free placement on the floor, manual
+ *     rotation only.
+ */
+export declare function resolvePlacement(raw: [number, number, number], previewNode: DuctFittingNode, gridStep: number, manualQuat: Quaternion, surfaceHit: boolean, surfaceNormal?: [number, number, number], support?: (node: DuctFittingNode | import("@pascal-app/core").PipeFittingNode, rotation: [number, number, number], position: [number, number, number], surfacePoint: [number, number, number], surfaceNormal?: [number, number, number]) => [number, number, number]): Placement;
 /**
  * Click-place tool for duct fittings (elbow / tee / reducer).
  *

package/dist/duct-fitting/tool.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"tool.d.ts","sourceRoot":"","sources":["../../src/duct-fitting/tool.tsx"],"names":[],"mappings":"AA0FA;;;;;;;;;;;;;;GAcG;AACH,QAAA,MAAM,eAAe,0CAuJpB,CAAA;AAED,eAAe,eAAe,CAAA"}
+{"version":3,"file":"tool.d.ts","sourceRoot":"","sources":["../../src/duct-fitting/tool.tsx"],"names":[],"mappings":"AAEA,OAAO,EAAE,eAAe,EAAqC,MAAM,kBAAkB,CAAA;AAarF,OAAO,EAA8B,UAAU,EAAW,MAAM,OAAO,CAAA;AAsBvE,OAAO,EAAwC,KAAK,SAAS,EAAE,MAAM,iBAAiB,CAAA;AAOtF,KAAK,SAAS,GAAG;IACf,QAAQ,EAAE,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,CAAA;IAClC,QAAQ,EAAE,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,CAAA;IAClC,QAAQ,EAAE,SAAS,GAAG,IAAI,CAAA;IAC1B,IAAI,EAAE,eAAe,CAAA;IACrB,KAAK,EAAE,OAAO,CAAA;CACf,CAAA;AAED;;;;;;;GAOG;AACH,wBAAgB,gBAAgB,CAC9B,GAAG,EAAE,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,EAC7B,WAAW,EAAE,eAAe,EAC5B,QAAQ,EAAE,MAAM,EAChB,UAAU,EAAE,UAAU,EACtB,UAAU,EAAE,OAAO,EACnB,aAAa,CAAC,EAAE,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,EACxC,OAAO,6PAAgC,GACtC,SAAS,CAsEX;AAED;;;;;;;;;;;;;;GAcG;AACH,QAAA,MAAM,eAAe,0CAsOpB,CAAA;AAED,eAAe,eAAe,CAAA"}

package/dist/duct-fitting/tool.js

@@ -1,25 +1,24 @@
 'use client';
 import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
 import { DuctFittingNode, emitter, useScene } from '@pascal-app/core';
-import { CursorSphere, EDITOR_LAYER, isGridSnapActive, triggerSFX, useEditor, } from '@pascal-app/editor';
+import { CursorSphere, EDITOR_LAYER, isGridSnapActive, isMagneticSnapActive, triggerSFX, useEditor, useInteractionScope, } from '@pascal-app/editor';
 import { useViewer } from '@pascal-app/viewer';
 import { Html } from '@react-three/drei';
 import { useEffect, useMemo, useRef, useState } from 'react';
-import { Euler, Quaternion, Vector3 } from 'three';
+import { Euler, Mesh, Quaternion, Vector3 } from 'three';
+import { accessoryCursor } from '../shared/accessory-cursor';
+import { accessoryMateQuaternion, inheritFittingProfile, placeAccessPanel, } from '../shared/accessory-placement';
+import { findAccessoryPort, snapAccessoryPoint, subscribeAccessorySnapping, } from '../shared/accessory-snapping';
+import { ConnectionFeedback } from '../shared/connection-feedback';
+import { alignDrawPoint, clearDrawAlignment } from '../shared/draw-alignment';
 import { AXIS_VECTORS, cycleRotationAxis, getRotationAxis, ROTATE_STEP_RAD, } from '../shared/fitting-rotation';
+import { createFittingSurfaceSupport } from '../shared/fitting-surface-support';
 import { LevelOffsetGroup } from '../shared/level-offset-group';
-import { collectScenePorts, DUCT_PORT_SYSTEMS, findNearestPortXZ, } from '../shared/ports';
+import { collectScenePorts, DUCT_PORT_SYSTEMS } from '../shared/ports';
 import { ductFittingDefinition } from './definition';
 import { buildDuctFittingGeometry } from './geometry';
 import { localFittingPorts } from './ports';
-/** Snap radius (meters, XZ) for mating onto an existing port. */
-const PORT_SNAP_RADIUS_M = 0.5;
 const PREVIEW_OPACITY = 0.55;
-function snap(value, step) {
-    if (step <= 0)
-        return value;
-    return Math.round(value / step) * step;
-}
 /**
  * Resolve where the fitting would land for a cursor at `raw`:
  *   - Near an existing port → mate: orientation aligns the inlet onto
@@ -28,16 +27,41 @@ function snap(value, step) {
  *   - Otherwise → grid-snapped free placement on the floor, manual
  *     rotation only.
  */
-function resolvePlacement(raw, previewNode, gridStep, manualQuat) {
-    const port = findNearestPortXZ(raw, collectScenePorts({ systems: DUCT_PORT_SYSTEMS }), PORT_SNAP_RADIUS_M);
+export function resolvePlacement(raw, previewNode, gridStep, manualQuat, surfaceHit, surfaceNormal, support = createFittingSurfaceSupport()) {
+    const levelId = useViewer.getState().selection.levelId;
+    if (previewNode.fittingType === 'access-panel') {
+        const enabled = isGridSnapActive() || isMagneticSnapActive();
+        const mounted = enabled
+            ? placeAccessPanel(raw, previewNode, useScene.getState().nodes, levelId, surfaceHit, gridStep)
+            : null;
+        const normal = new Vector3(...(surfaceNormal ?? [0, 1, 0])).normalize();
+        const orientation = manualQuat
+            .clone()
+            .multiply(new Quaternion().setFromUnitVectors(new Vector3(0, 0, 1), normal));
+        const euler = new Euler().setFromQuaternion(orientation);
+        const rotation = [euler.x, euler.y, euler.z];
+        return {
+            ...(mounted ?? {
+                position: support(previewNode, rotation, snapAccessoryPoint(raw, gridStep, surfaceNormal), raw, surfaceNormal),
+                rotation,
+            }),
+            snapPort: null,
+            node: previewNode,
+            valid: true,
+        };
+    }
+    const port = levelId
+        ? findAccessoryPort(raw, collectScenePorts({ systems: DUCT_PORT_SYSTEMS, levelId }), isGridSnapActive() || isMagneticSnapActive(), surfaceHit)
+        : null;
     if (port) {
-        const direction = new Vector3(...port.direction).normalize();
+        clearDrawAlignment();
+        const fittedNode = inheritFittingProfile(previewNode, port, useScene.getState().nodes);
         // Local +X must map onto the port's outward direction so the inlet
         // (local -X) faces back into the run it's joining. Manual rotation
         // composes in the world frame on top of the mate orientation.
-        const mate = new Quaternion().setFromUnitVectors(new Vector3(1, 0, 0), direction);
+        const mate = accessoryMateQuaternion(fittedNode, port, useScene.getState().nodes);
         const final = manualQuat.clone().multiply(mate);
-        const inlet = localFittingPorts(previewNode)[0];
+        const inlet = localFittingPorts(fittedNode)[0];
         const inletWorldOffset = inlet.position.clone().applyQuaternion(final);
         const position = new Vector3(...port.position).sub(inletWorldOffset);
         const euler = new Euler().setFromQuaternion(final);
@@ -45,13 +69,22 @@ function resolvePlacement(raw, previewNode, gridStep, manualQuat) {
             position: [position.x, position.y, position.z],
             rotation: [euler.x, euler.y, euler.z],
             snapPort: port,
+            node: fittedNode,
+            valid: true,
         };
     }
     const euler = new Euler().setFromQuaternion(manualQuat);
+    const rotation = [euler.x, euler.y, euler.z];
+    const snapped = alignDrawPoint(snapAccessoryPoint(raw, gridStep, surfaceNormal), {
+        applySnap: !surfaceHit && isMagneticSnapActive(),
+        bypass: surfaceHit || !isMagneticSnapActive(),
+    });
     return {
-        position: [snap(raw[0], gridStep), 0, snap(raw[2], gridStep)],
-        rotation: [euler.x, euler.y, euler.z],
+        position: support(previewNode, rotation, snapped, raw, surfaceNormal),
+        rotation,
         snapPort: null,
+        node: previewNode,
+        valid: true,
     };
 }
 /**
@@ -72,51 +105,103 @@ function resolvePlacement(raw, previewNode, gridStep, manualQuat) {
 const DuctFittingTool = () => {
     const activeLevelId = useViewer((s) => s.selection.levelId);
     const [placement, setPlacement] = useState(null);
+    const toolDefaults = useEditor((s) => s.toolDefaults['duct-fitting']);
     const axis = useEditor((s) => s.rotationAxis);
     // Accumulated manual rotation from R/T presses. Ref (not state) so the
     // emitter callbacks always read the latest without re-subscribing; a
     // placement recompute is triggered explicitly after each change.
+    const support = useMemo(createFittingSurfaceSupport, []);
     const manualQuatRef = useRef(new Quaternion());
     // Last raw cursor position so a key press can recompute the placement
     // without waiting for the next mouse move.
+    const surfaceNormalRef = useRef(undefined);
+    const surfaceHitRef = useRef(false);
     const lastRawRef = useRef(null);
     // Ghost matches exactly what a click creates (the kind's defaults).
-    const previewNode = useMemo(() => DuctFittingNode.parse({ ...ductFittingDefinition.defaults(), name: 'Duct fitting' }), []);
+    const previewNode = useMemo(() => DuctFittingNode.parse({ ...ductFittingDefinition.defaults(), ...toolDefaults }), [toolDefaults]);
+    const displayNode = placement?.node ?? previewNode;
     const ghost = useMemo(() => {
-        const group = buildDuctFittingGeometry(previewNode);
+        const group = buildDuctFittingGeometry({
+            ...displayNode,
+            rotation: placement?.rotation ?? displayNode.rotation,
+        });
         group.traverse((child) => {
             // Overlay layer keeps the placement ghost out of the ink / SSGI
             // buffers and the thumbnail export, like every other tool preview.
             child.layers.set(EDITOR_LAYER);
-            const mesh = child;
-            if (mesh.material) {
-                mesh.material.transparent = true;
-                mesh.material.opacity = PREVIEW_OPACITY;
+            child.raycast = () => { };
+            if (child instanceof Mesh) {
+                const clone = (material) => {
+                    const copy = material.clone();
+                    copy.transparent = true;
+                    copy.opacity = PREVIEW_OPACITY;
+                    return copy;
+                };
+                child.material = Array.isArray(child.material)
+                    ? child.material.map(clone)
+                    : clone(child.material);
             }
         });
         return group;
-    }, [previewNode]);
+    }, [displayNode, placement?.rotation]);
+    useEffect(() => () => {
+        ghost.traverse((object) => {
+            if (!(object instanceof Mesh))
+                return;
+            object.geometry.dispose();
+            for (const material of Array.isArray(object.material) ? object.material : [object.material])
+                material.dispose();
+        });
+    }, [ghost]);
     useEffect(() => {
         if (!activeLevelId)
             return;
+        const draft = DuctFittingNode.parse({ ...previewNode, parentId: activeLevelId });
+        useInteractionScope.getState().begin({
+            kind: 'placing',
+            node: draft,
+            nodeId: draft.id,
+            nodeType: draft.type,
+            view: '3d',
+            pressDrag: false,
+            driver: 'registry-tool',
+        });
         const recompute = () => {
             const raw = lastRawRef.current;
             if (!raw)
                 return;
-            setPlacement(resolvePlacement(raw, previewNode, isGridSnapActive() ? useEditor.getState().gridSnapStep : 0, manualQuatRef.current));
+            const next = resolvePlacement(raw, previewNode, isGridSnapActive() ? useEditor.getState().gridSnapStep : 0, manualQuatRef.current, surfaceHitRef.current, surfaceNormalRef.current, support);
+            setPlacement((previous) => ({
+                ...next,
+                node: previous && JSON.stringify(previous.node) === JSON.stringify(next.node)
+                    ? previous.node
+                    : next.node,
+                rotation: previous?.rotation.every((v, i) => v === next.rotation[i])
+                    ? previous.rotation
+                    : next.rotation,
+            }));
         };
         const onMove = (event) => {
-            lastRawRef.current = [event.localPosition[0], 0, event.localPosition[2]];
+            const cursor = accessoryCursor(event, activeLevelId);
+            surfaceNormalRef.current = cursor.normal;
+            surfaceHitRef.current = cursor.surface;
+            lastRawRef.current = cursor.point;
             recompute();
         };
         const onClick = (event) => {
-            lastRawRef.current = [event.localPosition[0], 0, event.localPosition[2]];
-            const { position, rotation } = resolvePlacement(lastRawRef.current, previewNode, isGridSnapActive() ? useEditor.getState().gridSnapStep : 0, manualQuatRef.current);
+            const cursor = accessoryCursor(event, activeLevelId);
+            surfaceNormalRef.current = cursor.normal;
+            surfaceHitRef.current = cursor.surface;
+            lastRawRef.current = cursor.point;
+            const resolved = resolvePlacement(lastRawRef.current, previewNode, isGridSnapActive() ? useEditor.getState().gridSnapStep : 0, manualQuatRef.current, surfaceHitRef.current, surfaceNormalRef.current, support);
+            if (!resolved.valid)
+                return;
             const fitting = DuctFittingNode.parse({
-                ...ductFittingDefinition.defaults(),
-                name: 'Duct fitting',
-                position,
-                rotation,
+                ...resolved.node,
+                id: undefined,
+                name: resolved.node.fittingType.replaceAll('-', ' ').replace(/^./, (c) => c.toUpperCase()),
+                position: resolved.position,
+                rotation: resolved.rotation,
             });
             useScene.getState().createNode(fitting, activeLevelId);
             useViewer.getState().setSelection({ selectedIds: [fitting.id] });
@@ -144,17 +229,24 @@ const DuctFittingTool = () => {
                 cycleRotationAxis();
             }
         };
+        recompute();
+        const unsubscribeSnapping = subscribeAccessorySnapping(recompute);
         emitter.on('grid:move', onMove);
         emitter.on('grid:click', onClick);
         window.addEventListener('keydown', onKeyDown, true);
         return () => {
+            useInteractionScope
+                .getState()
+                .endIf((scope) => scope.kind === 'placing' && scope.nodeId === draft.id);
+            unsubscribeSnapping();
+            clearDrawAlignment();
             emitter.off('grid:move', onMove);
             emitter.off('grid:click', onClick);
             window.removeEventListener('keydown', onKeyDown, true);
         };
-    }, [activeLevelId, previewNode]);
+    }, [activeLevelId, previewNode, support]);
     if (!activeLevelId || !placement)
         return null;
-    return (_jsxs(LevelOffsetGroup, { children: [_jsx(CursorSphere, { position: placement.position }), _jsx("group", { position: placement.position, rotation: placement.rotation, children: _jsx("primitive", { object: ghost }) }), _jsx(Html, { center: true, position: [placement.position[0], placement.position[1] + 1.45, placement.position[2]], style: { pointerEvents: 'none', userSelect: 'none' }, zIndexRange: [100, 0], children: _jsxs("div", { className: "flex items-center gap-2 whitespace-nowrap rounded-full border border-border/60 bg-background/90 px-4 py-1.5 text-xs tabular-nums shadow-sm backdrop-blur", children: [_jsxs("span", { className: "font-medium text-foreground", children: ["Axis ", axis.toUpperCase()] }), _jsx("span", { "aria-hidden": true, className: "text-muted-foreground", children: "\u00B7" }), _jsx("span", { className: "text-muted-foreground", children: "R/T rotate" }), _jsx("span", { "aria-hidden": true, className: "text-muted-foreground", children: "\u00B7" }), _jsx("span", { className: "text-muted-foreground", children: "\u2325 axis" })] }) }), placement.snapPort && (_jsxs("mesh", { layers: EDITOR_LAYER, position: placement.snapPort.position, children: [_jsx("sphereGeometry", { args: [0.18, 24, 16] }), _jsx("meshBasicMaterial", { color: "#818cf8", depthTest: false, opacity: 0.35, transparent: true })] }))] }));
+    return (_jsxs(LevelOffsetGroup, { children: [previewNode.fittingType !== 'access-panel' && (_jsx(ConnectionFeedback, { point: placement.position, target: placement.snapPort, levelId: activeLevelId, profile: displayNode })), _jsx(CursorSphere, { position: placement.position }), _jsx("group", { position: placement.position, rotation: placement.rotation, children: _jsx("primitive", { object: ghost }) }), _jsx(Html, { center: true, position: [placement.position[0], placement.position[1] + 1.45, placement.position[2]], style: { pointerEvents: 'none', userSelect: 'none' }, zIndexRange: [100, 0], children: _jsxs("div", { className: "flex items-center gap-2 whitespace-nowrap rounded-full border border-border/60 bg-background/90 px-4 py-1.5 text-xs tabular-nums shadow-sm backdrop-blur", children: [previewNode.fittingType === 'access-panel' && (_jsx("span", { children: placement.valid ? 'Place access door' : 'Hover a duct face that fits the door' })), _jsxs("span", { className: "font-medium text-foreground", children: ["Axis ", axis.toUpperCase()] }), _jsx("span", { "aria-hidden": true, className: "text-muted-foreground", children: "\u00B7" }), _jsx("span", { className: "text-muted-foreground", children: "R/T rotate" }), _jsx("span", { "aria-hidden": true, className: "text-muted-foreground", children: "\u00B7" }), _jsx("span", { className: "text-muted-foreground", children: "\u2325 axis" })] }) }), placement.snapPort && (_jsxs("mesh", { layers: EDITOR_LAYER, position: placement.snapPort.position, children: [_jsx("sphereGeometry", { args: [0.18, 24, 16] }), _jsx("meshBasicMaterial", { color: "#818cf8", depthTest: false, opacity: 0.35, transparent: true })] }))] }));
 };
 export default DuctFittingTool;

package/dist/duct-segment/continuation.d.ts

@@ -0,0 +1,21 @@
+import { type AnyNode, type AnyNodeId, type DuctFittingNode, type FloorplanAffordance } from '@pascal-app/core';
+import { type RunContinuationHandlePlan } from '../shared/elbow-branch-continuation';
+import type { RunBodyHit, ScenePort } from '../shared/ports';
+import type { DuctSegmentNode } from './schema';
+export type DuctEndpoint = 'start' | 'end';
+export type DuctContinuationSeed = {
+    duct: DuctSegmentNode;
+    port: ScenePort | null;
+    body: RunBodyHit | null;
+    promotedFitting?: DuctFittingNode;
+};
+export declare function ductEndpointPort(duct: DuctSegmentNode, endpoint: DuctEndpoint): ScenePort | null;
+export declare function ductContinuationHandlePoint(duct: DuctSegmentNode, endpoint: DuctEndpoint, gap?: number): [number, number, number] | null;
+export declare function ductContinuationHandlePlan(duct: DuctSegmentNode, endpoint: DuctEndpoint, nodes: Readonly<Record<string, AnyNode>>, gap?: number): RunContinuationHandlePlan | null;
+export declare function resolveDuctContinuationSeed(defaults: unknown, nodes: Record<string, AnyNode>): DuctContinuationSeed | null;
+export declare function activateDuctBranch(duct: DuctSegmentNode, segmentIndex: number, point: [number, number, number]): void;
+export declare function activateDuctContinuation(duct: DuctSegmentNode, endpoint: DuctEndpoint, fittingId?: AnyNodeId): void;
+export declare const ductContinuationAffordance: FloorplanAffordance<DuctSegmentNode>;
+export declare const ductBranchAffordance: FloorplanAffordance<DuctSegmentNode>;
+export declare function currentDuctContinuationSeed(): DuctContinuationSeed | null;
+//# sourceMappingURL=continuation.d.ts.map

package/dist/duct-segment/continuation.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"continuation.d.ts","sourceRoot":"","sources":["../../src/duct-segment/continuation.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,KAAK,OAAO,EACZ,KAAK,SAAS,EACd,KAAK,eAAe,EACpB,KAAK,mBAAmB,EAEzB,MAAM,kBAAkB,CAAA;AAGzB,OAAO,EAIL,KAAK,yBAAyB,EAE/B,MAAM,qCAAqC,CAAA;AAC5C,OAAO,KAAK,EAAE,UAAU,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAA;AAE5D,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,UAAU,CAAA;AAE/C,MAAM,MAAM,YAAY,GAAG,OAAO,GAAG,KAAK,CAAA;AAE1C,MAAM,MAAM,oBAAoB,GAAG;IACjC,IAAI,EAAE,eAAe,CAAA;IACrB,IAAI,EAAE,SAAS,GAAG,IAAI,CAAA;IACtB,IAAI,EAAE,UAAU,GAAG,IAAI,CAAA;IACvB,eAAe,CAAC,EAAE,eAAe,CAAA;CAClC,CAAA;AAYD,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,eAAe,EAAE,QAAQ,EAAE,YAAY,GAAG,SAAS,GAAG,IAAI,CAkBhG;AAED,wBAAgB,2BAA2B,CACzC,IAAI,EAAE,eAAe,EACrB,QAAQ,EAAE,YAAY,EACtB,GAAG,SAAO,GACT,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,GAAG,IAAI,CAQjC;AAED,wBAAgB,0BAA0B,CACxC,IAAI,EAAE,eAAe,EACrB,QAAQ,EAAE,YAAY,EACtB,KAAK,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,EACxC,GAAG,SAAO,GACT,yBAAyB,GAAG,IAAI,CAGlC;AAED,wBAAgB,2BAA2B,CACzC,QAAQ,EAAE,OAAO,EACjB,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAC7B,oBAAoB,GAAG,IAAI,CAiD7B;AAED,wBAAgB,kBAAkB,CAChC,IAAI,EAAE,eAAe,EACrB,YAAY,EAAE,MAAM,EACpB,KAAK,EAAE,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,GAC9B,IAAI,CAmBN;AAED,wBAAgB,wBAAwB,CACtC,IAAI,EAAE,eAAe,EACrB,QAAQ,EAAE,YAAY,EACtB,SAAS,CAAC,EAAE,SAAS,GACpB,IAAI,CAiBN;AAED,eAAO,MAAM,0BAA0B,EAAE,mBAAmB,CAAC,eAAe,CAiB3E,CAAA;AAED,eAAO,MAAM,oBAAoB,EAAE,mBAAmB,CAAC,eAAe,CAiBrE,CAAA;AAED,wBAAgB,2BAA2B,IAAI,oBAAoB,GAAG,IAAI,CAKzE"}