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

package/dist/duct-fitting/accessory-geometry.js

@@ -0,0 +1,47 @@
+import { Group } from 'three';
+import { addBox, addProfile, hardwareMaterial } from '../shared/accessory-geometry';
+export function buildDuctAccessory(node, material) {
+    if (!['end-cap', 'damper', 'access-panel', 'coupling'].includes(node.fittingType))
+        return null;
+    const group = new Group();
+    const hardware = node.fittingType === 'damper' || node.fittingType === 'access-panel'
+        ? hardwareMaterial()
+        : material;
+    if (node.fittingType === 'access-panel') {
+        const w = node.panelWidth;
+        const h = node.panelHeight;
+        addBox(group, 'access-gasket', [w + 0.012, h + 0.012, 0.004], [0, 0, 0.002], hardware);
+        addBox(group, 'access-door', [w, h, 0.012], [0, 0, 0.01], material);
+        for (const side of [-1, 1]) {
+            addBox(group, `access-frame-side-${side}`, [0.016, h + 0.04, 0.012], [side * (w / 2 + 0.012), 0, 0.006], material);
+            addBox(group, `access-frame-rail-${side}`, [w + 0.04, 0.016, 0.012], [0, side * (h / 2 + 0.012), 0.006], material);
+            addBox(group, `access-hinge-${side}`, [0.028, 0.03, 0.018], [-w / 2, side * h * 0.28, 0.018], hardware);
+            addBox(group, `access-latch-${side}`, [0.025, 0.012, 0.015], [w * 0.36, side * h * 0.28, 0.024], hardware);
+        }
+        return group;
+    }
+    const width = (node.shape === 'round' ? node.diameter : node.width) * 0.0254;
+    const height = (node.shape === 'round' ? node.diameter : node.height) * 0.0254;
+    const cap = node.fittingType === 'end-cap';
+    const half = cap ? 0.025 : 0.1;
+    addProfile(group, 'accessory-sleeve', node.shape, width, height, -half, half, material, 0.0015);
+    for (const x of cap ? [-half] : [-half, half - 0.008]) {
+        addProfile(group, `accessory-flange-${x}`, node.shape, width + 0.02, height + 0.02, x, x + 0.008, material, 0.011);
+    }
+    if (cap) {
+        addProfile(group, 'end-cap-closure', node.shape, width, height, half - 0.002, half, material);
+        addProfile(group, 'end-cap-folded-rim', node.shape, width + 0.008, height + 0.008, half - 0.008, half, material, 0.006);
+    }
+    if (node.fittingType === 'damper') {
+        const blade = addProfile(group, 'damper-blade', node.shape, width - 0.006, height - 0.006, -0.001, 0.001, hardware);
+        blade.rotation.z = (-node.damperAngle * Math.PI) / 180;
+        addBox(group, 'damper-spindle', [0.008, 0.008, width + 0.06], [0, 0, 0], hardware);
+        addBox(group, 'damper-bearing', [0.04, 0.04, 0.012], [0, 0, width / 2 + 0.01], material);
+        const handle = addBox(group, 'damper-handle', [0.015, 0.09, 0.01], [0, 0, width / 2 + 0.035], hardware);
+        handle.geometry.translate(0, 0.035, 0);
+        handle.rotation.z = (-node.damperAngle * Math.PI) / 180;
+    }
+    if (node.fittingType === 'coupling')
+        addProfile(group, 'coupling-center-seam', node.shape, width + 0.008, height + 0.008, -0.004, 0.004, material, 0.005);
+    return group;
+}

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

@@ -1 +1 @@
-{"version":3,"file":"definition.d.ts","sourceRoot":"","sources":["../../src/duct-fitting/definition.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAA;AAOtD,OAAO,EAAE,eAAe,EAAE,MAAM,UAAU,CAAA;AAE1C;;;;;;;GAOG;AACH,eAAO,MAAM,qBAAqB,EAAE,cAAc,CAAC,OAAO,eAAe,CAyHxE,CAAA"}
+{"version":3,"file":"definition.d.ts","sourceRoot":"","sources":["../../src/duct-fitting/definition.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAA;AAQtD,OAAO,EAAE,eAAe,EAAE,MAAM,UAAU,CAAA;AAE1C;;;;;;;GAOG;AACH,eAAO,MAAM,qBAAqB,EAAE,cAAc,CAAC,OAAO,eAAe,CAiIxE,CAAA"}

package/dist/duct-fitting/definition.js

@@ -1,5 +1,6 @@
 import { ductBodyPaint, ductBodySlots } from '../shared/duct-body-paint';
 import { rotateFittingNode } from '../shared/fitting-rotation';
+import { ductFittingToolOptions } from '../shared/fitting-tool-options';
 import { buildDuctFittingFloorplan } from './floorplan';
 import { buildDuctFittingGeometry } from './geometry';
 import { ductFittingParametrics } from './parametrics';
@@ -15,7 +16,7 @@ import { DuctFittingNode } from './schema';
  */
 export const ductFittingDefinition = {
     kind: 'duct-fitting',
-    schemaVersion: 1,
+    schemaVersion: 3,
     schema: DuctFittingNode,
     category: 'utility',
     distributionRole: 'fitting',
@@ -27,6 +28,9 @@ export const ductFittingDefinition = {
         metadata: {},
         position: [0, 0, 0],
         rotation: [0, 0, 0],
+        damperAngle: 0,
+        panelWidth: 0.25,
+        panelHeight: 0.15,
         fittingType: 'elbow',
         shape: 'rect',
         width: 14,
@@ -56,11 +60,16 @@ export const ductFittingDefinition = {
     geometry: buildDuctFittingGeometry,
     geometryKey: (n) => JSON.stringify([
         n.fittingType,
+        n.damperAngle,
+        n.panelWidth,
+        n.panelHeight,
         // The mitered elbow + flange profiles swap width/height roles based
         // on where world-up sits in the local frame, so orientation is a
         // geometry input.
         n.rotation,
         n.shape,
+        n.inletShape,
+        n.outletShape,
         n.width,
         n.height,
         n.shape2,
@@ -103,6 +112,7 @@ export const ductFittingDefinition = {
         // `capabilities.movable` in the MoveTool dispatcher.
         move: () => import('./move-tool'),
     },
+    toolOptions: ductFittingToolOptions,
     tool: () => import('./tool'),
     toolHints: [
         { key: 'Click', label: 'Place fitting' },

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

@@ -1 +1 @@
-{"version":3,"file":"floorplan.d.ts","sourceRoot":"","sources":["../../src/duct-fitting/floorplan.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,iBAAiB,EAAE,eAAe,EAAE,MAAM,kBAAkB,CAAA;AAG1E,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,UAAU,CAAA;AAM/C;;;;;;;GAOG;AACH,wBAAgB,yBAAyB,CACvC,IAAI,EAAE,eAAe,EACrB,GAAG,EAAE,eAAe,GACnB,iBAAiB,GAAG,IAAI,CAgD1B"}
+{"version":3,"file":"floorplan.d.ts","sourceRoot":"","sources":["../../src/duct-fitting/floorplan.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,iBAAiB,EAAE,eAAe,EAAE,MAAM,kBAAkB,CAAA;AAO1E,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,UAAU,CAAA;AAM/C;;;;;;;GAOG;AACH,wBAAgB,yBAAyB,CACvC,IAAI,EAAE,eAAe,EACrB,GAAG,EAAE,eAAe,GACnB,iBAAiB,GAAG,IAAI,CAoD1B"}

package/dist/duct-fitting/floorplan.js

@@ -1,4 +1,8 @@
+import { MeshStandardMaterial } from 'three';
 import { INCHES_TO_METERS } from '../duct-segment/geometry';
+import { accessoryFloorplan } from '../shared/accessory-floorplan';
+import { buildDuctAccessory } from './accessory-geometry';
+import { buildDuctFittingGeometry } from './geometry';
 import { getDuctFittingPorts } from './ports';
 const SUPPLY_COLOR = '#d4825a';
 const RETURN_COLOR = '#5a8ad4';
@@ -12,6 +16,10 @@ const BODY_COLOR = '#9ca3af';
  * circle, which is exactly how it should read from above.
  */
 export function buildDuctFittingFloorplan(node, ctx) {
+    if (['end-cap', 'damper', 'access-panel', 'coupling'].includes(node.fittingType))
+        return accessoryFloorplan(buildDuctAccessory(node, new MeshStandardMaterial()), node, ctx);
+    if (node.fittingType === 'transition' || node.fittingType === 'reducer')
+        return accessoryFloorplan(buildDuctFittingGeometry(node), node, ctx);
     const [cx, , cz] = node.position;
     const ports = getDuctFittingPorts(node);
     const view = ctx.viewState;

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

@@ -1 +1 @@
-{"version":3,"file":"geometry.d.ts","sourceRoot":"","sources":["../../src/duct-fitting/geometry.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,kBAAkB,CAAA;AACvD,OAAO,KAAK,EAAE,WAAW,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAA;AACpE,OAAO,EAML,KAAK,EAMN,MAAM,OAAO,CAAA;AAUd,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,UAAU,CAAA;AA6K/C;;;;;;;;;;;;;;;;;;;GAmBG;AACH,wBAAgB,wBAAwB,CACtC,IAAI,EAAE,eAAe,EACrB,GAAG,CAAC,EAAE,eAAe,EACrB,OAAO,GAAE,aAA0B,EACnC,QAAQ,UAAO,EACf,WAAW,GAAE,WAAoB,EACjC,UAAU,CAAC,EAAE,MAAM,GAClB,KAAK,CAoQP"}
+{"version":3,"file":"geometry.d.ts","sourceRoot":"","sources":["../../src/duct-fitting/geometry.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,kBAAkB,CAAA;AACvD,OAAO,KAAK,EAAE,WAAW,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAA;AACpE,OAAO,EAML,KAAK,EAMN,MAAM,OAAO,CAAA;AAWd,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,UAAU,CAAA;AAmL/C;;;;;;;;;;;;;;;;;;;GAmBG;AACH,wBAAgB,wBAAwB,CACtC,IAAI,EAAE,eAAe,EACrB,GAAG,CAAC,EAAE,eAAe,EACrB,OAAO,GAAE,aAA0B,EACnC,QAAQ,UAAO,EACf,WAAW,GAAE,WAAoB,EACjC,UAAU,CAAC,EAAE,MAAM,GAClB,KAAK,CAyRP"}

package/dist/duct-fitting/geometry.js

@@ -1,7 +1,8 @@
 import { BufferGeometry, CylinderGeometry, DoubleSide, Euler, Float32BufferAttribute, Group, Mesh, SphereGeometry, TorusGeometry, Vector3, } from 'three';
 import { buildOvalSection, buildRectSection, buildSection, createDuctMaterial, INCHES_TO_METERS, } from '../duct-segment/geometry';
 import { DUCT_BODY_SLOT_ID } from '../shared/duct-body-paint';
-import { localFittingPorts } from './ports';
+import { buildDuctAccessory } from './accessory-geometry';
+import { adapterShape, localFittingPorts } from './ports';
 const RADIAL_SEGMENTS = 24;
 const UP = new Vector3(0, 1, 0);
 /**
@@ -104,17 +105,7 @@ function buildMiteredElbow(inletPos, outletPos, sweepM, cheekM, profileShape, ma
     mesh.name = `fitting-elbow-${profileShape}`;
     return mesh;
 }
-/**
- * Square-to-round loft between a rect ring at `xRect` and a round ring
- * at `xRound`, both centered on the local X axis (the straight-through
- * run). Profiles are sampled at matching polar angles — the rect point
- * is the ray's intersection with the rectangle boundary — so the skin
- * twists nowhere. Non-indexed triangles + computed normals give the
- * faceted gore look of a real shop-made square-to-round.
- */
-function buildRectToRoundLoft(xRect, xRound, widthM, heightM, radius, material) {
-    const hw = widthM / 2;
-    const hh = heightM / 2;
+function buildProfileLoft(xRect, xRound, widthM, heightM, material, inletShape, outletShape, outletWidthM, outletHeightM) {
     const rectRing = [];
     const roundRing = [];
     for (let i = 0; i < RADIAL_SEGMENTS; i++) {
@@ -124,9 +115,24 @@ function buildRectToRoundLoft(xRect, xRound, widthM, heightM, radius, material)
         // Scale the unit ray until it hits the rectangle boundary. Width
         // spans local Z and height local Y — the same axes buildRectSection
         // gives a +X run.
-        const t = 1 / Math.max(Math.abs(cz) / hw, Math.abs(sy) / hh);
+        const radiusAt = (shape, w, h) => {
+            if (shape === 'round')
+                return w / 2;
+            if (shape === 'rect')
+                return 1 / Math.max(Math.abs(cz) / (w / 2), Math.abs(sy) / (h / 2));
+            const r = Math.min(w, h) / 2;
+            const offset = Math.abs(w - h) / 2;
+            const major = Math.abs(w >= h ? cz : sy);
+            const minor = Math.abs(w >= h ? sy : cz);
+            const flat = minor > 1e-9 ? r / minor : Infinity;
+            return flat * major <= offset
+                ? flat
+                : offset * major + Math.sqrt(Math.max(0, r * r - offset * offset * minor * minor));
+        };
+        const t = radiusAt(inletShape, widthM, heightM);
+        const u = radiusAt(outletShape, outletWidthM, outletHeightM);
         rectRing.push(new Vector3(xRect, t * sy, t * cz));
-        roundRing.push(new Vector3(xRound, radius * sy, radius * cz));
+        roundRing.push(new Vector3(xRound, u * sy, u * cz));
     }
     const positions = [];
     const tri = (a, b, c) => positions.push(a.x, a.y, a.z, b.x, b.y, b.z, c.x, c.y, c.z);
@@ -167,6 +173,14 @@ function buildRectToRoundLoft(xRect, xRound, widthM, heightM, radius, material)
 export function buildDuctFittingGeometry(node, ctx, shading = 'rendered', textures = true, colorPreset = 'clay', sceneTheme) {
     const group = new Group();
     const material = createDuctMaterial(node, ctx?.materials, shading, textures, colorPreset, sceneTheme);
+    const accessory = buildDuctAccessory(node, material);
+    if (accessory) {
+        accessory.traverse((object) => {
+            if (object instanceof Mesh)
+                object.userData.slotId = DUCT_BODY_SLOT_ID;
+        });
+        return accessory;
+    }
     const radiusMain = (node.diameter * INCHES_TO_METERS) / 2;
     const ports = localFittingPorts(node);
     const widthM = node.width * INCHES_TO_METERS;
@@ -178,7 +192,9 @@ export function buildDuctFittingGeometry(node, ctx, shading = 'rendered', textur
     // where world-up sits in the fitting's local frame.
     const hingeWorld = UP.clone().applyEuler(new Euler(node.rotation[0], node.rotation[1], node.rotation[2]));
     const hingeIsVertical = Math.abs(hingeWorld.y) >= Math.SQRT1_2;
-    if (node.fittingType === 'reducer') {
+    if (node.fittingType === 'reducer' &&
+        adapterShape(node) === 'round' &&
+        adapterShape(node, true) === 'round') {
         const radiusOut = (node.diameter2 * INCHES_TO_METERS) / 2;
         const inlet = ports[0];
         const outlet = ports[1];
@@ -194,19 +210,24 @@ export function buildDuctFittingGeometry(node, ctx, shading = 'rendered', textur
         if (stubB)
             group.add(stubB);
     }
-    else if (node.fittingType === 'transition') {
-        // Square-to-round: rect stub on the inlet, lofted gore body through
-        // the junction, round stub on the outlet. Same inline layout as the
-        // reducer, with the taper replaced by the loft.
-        const radiusOut = (node.diameter2 * INCHES_TO_METERS) / 2;
+    else if (node.fittingType === 'transition' || node.fittingType === 'reducer') {
         const inlet = ports[0];
         const outlet = ports[1];
-        const taperHalf = Math.abs(inlet.position.x) / 3;
-        const stubA = buildRectSection(inlet.position, new Vector3(-taperHalf, 0, 0), widthM, heightM, material, 'fitting-stub-inlet');
+        const taperHalf = Math.abs(inlet.position.x) * 0.7;
+        const inletShape = adapterShape(node);
+        const outletShape = adapterShape(node, true);
+        const w1 = inletShape === 'round' ? node.diameter * INCHES_TO_METERS : widthM;
+        const h1 = inletShape === 'round' ? w1 : heightM;
+        const w2 = (outletShape === 'round' ? node.diameter2 : node.width2) * INCHES_TO_METERS;
+        const h2 = outletShape === 'round' ? w2 : node.height2 * INCHES_TO_METERS;
+        const stub = (a, b, shape, w, h, name) => shape === 'round'
+            ? buildSection(a, b, w / 2, material, name)
+            : (shape === 'oval' ? buildOvalSection : buildRectSection)(a, b, w, h, material, name);
+        const stubA = stub(inlet.position, new Vector3(-taperHalf, 0, 0), inletShape, w1, h1, 'fitting-stub-inlet');
+        const stubB = stub(new Vector3(taperHalf, 0, 0), outlet.position, outletShape, w2, h2, 'fitting-stub-outlet');
         if (stubA)
             group.add(stubA);
-        group.add(buildRectToRoundLoft(-taperHalf, taperHalf, widthM, heightM, radiusOut, material));
-        const stubB = buildSection(new Vector3(taperHalf, 0, 0), outlet.position, radiusOut, material, 'fitting-stub-outlet');
+        group.add(buildProfileLoft(-taperHalf, taperHalf, w1, h1, material, inletShape, outletShape, w2, h2));
         if (stubB)
             group.add(stubB);
     }
@@ -279,21 +300,10 @@ export function buildDuctFittingGeometry(node, ctx, shading = 'rendered', textur
         junction.name = 'fitting-junction';
         group.add(junction);
     }
-    // Joint trim at each opening. Round legs get a crimp-collar torus just
-    // proud of the stub; rect legs get a drive-cleat flange — the thin
-    // raised rim (TDC/S-cleat) real sheet-metal trunk joints wear where a
-    // section meets a fitting. The plate is centered on the collar plane so
-    // the rim reads as the seam between fitting and duct. Run legs
-    // (inlet/outlet) are rect when `shape` is rect; a rect tee's branch is
-    // rect when `shape2` is rect. Reducers ignore shape.
-    // Which profile a leg's opening carries: a transition's inlet is its
-    // rect end regardless of `shape`; reducers are always round; otherwise
-    // the run legs follow `shape` and a tee's branch follows `shape2`
-    // (only meaningful when the run itself is non-round).
     const legShape = (portId) => {
-        if (node.fittingType === 'transition')
-            return portId === 'inlet' ? 'rect' : 'round';
-        if (node.fittingType === 'reducer' || node.shape === 'round')
+        if (node.fittingType === 'transition' || node.fittingType === 'reducer')
+            return adapterShape(node, portId === 'outlet');
+        if (node.shape === 'round')
             return 'round';
         return portId === 'branch' || portId === 'branch2' ? node.shape2 : node.shape;
     };
@@ -302,6 +312,10 @@ export function buildDuctFittingGeometry(node, ctx, shading = 'rendered', textur
     // fold hinge lies horizontal (riser elbows) — same choice as the
     // mitered solid above.
     const rectLegProfile = (portId) => {
+        if (node.fittingType === 'transition' || node.fittingType === 'reducer')
+            return portId === 'outlet'
+                ? [node.width2 * INCHES_TO_METERS, node.height2 * INCHES_TO_METERS]
+                : [widthM, heightM];
         if (portId === 'branch' || portId === 'branch2') {
             const width2M = node.width2 * INCHES_TO_METERS;
             const height2M = node.height2 * INCHES_TO_METERS;

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

@@ -1 +1 @@
-{"version":3,"file":"parametrics.d.ts","sourceRoot":"","sources":["../../src/duct-fitting/parametrics.ts"],"names":[],"mappings":"AAAA,OAAO,EAIL,KAAK,oBAAoB,EAE1B,MAAM,kBAAkB,CAAA;AASzB,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,UAAU,CAAA;AAkF/C,eAAO,MAAM,sBAAsB,EAAE,oBAAoB,CAAC,eAAe,CAoQxE,CAAA"}
+{"version":3,"file":"parametrics.d.ts","sourceRoot":"","sources":["../../src/duct-fitting/parametrics.ts"],"names":[],"mappings":"AAAA,OAAO,EAIL,KAAK,oBAAoB,EAE1B,MAAM,kBAAkB,CAAA;AASzB,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,UAAU,CAAA;AAkF/C,eAAO,MAAM,sBAAsB,EAAE,oBAAoB,CAAC,eAAe,CAqUxE,CAAA"}

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"}