fix(editor): improve duct routing and parametric controls

[sudhir9297]

What does this PR do?

• Rectangular and oval duct wall clearance

  • Issue: Rectangular and oval ducts could be placed partly inside a wall because placement clearance used only the profile height.
  • Fixed: Placement and wall attachments now use the largest profile dimension, with a small wall standoff for non-round ducts.

• Keep a run on its starting wall

  • Issue: Continuing a duct or pipe run could move onto another wall when the cursor crossed the room.
  • Fixed: The run stays constrained to the wall face where its first point was placed.

• Automatic endcap cleanup

  • Issue: Deleting a duct or pipe left its automatically generated endcap behind.
  • Fixed: Deleting a run removes its automatic endcap while preserving manually placed endcaps.

• Parametric inspector controls

  • Issue: Inspector groups and action buttons did not support the desired initial layout and grouping.
  • Fixed: Groups can specify their initial expansion state, and parametric actions use a two-column layout where appropriate.

How to test

1. Run the editor with bun run dev.

   • The editor should start at http://localhost:3002.

2. Draw round, rectangular, and oval duct runs against a wall.

   • All profiles should remain outside the wall, and continuing a run should stay on its starting wall face.

3. Delete a duct or pipe with an automatic endcap.

   • The automatic endcap should be deleted with the run; manually placed endcaps should remain.

4. Open a parametric inspector with multiple groups and actions.

   • Groups should use their configured initial state and actions should be laid out consistently.

5. Run bun run checks.

   • Formatting, lint checks, type checks, and the full type validation should pass.

Focused node tests: 27 passed.

Screenshots / screen recording

Not added yet.

Checklist

• I've tested this locally with bun dev
• My code follows the existing code style (run bun check to verify)
• I've updated relevant documentation (if applicable)
• This PR targets the main branch

---

Note

Medium Risk
Touches shared run-drafting logic, scene deletion cascades, and scene-load timing; behavior changes are user-visible but covered by new tests.

Overview
Improves duct/pipe drafting and inspector UX, with tighter editor load behavior and broader test coverage.

Routing & clearance: New ductSurfaceClearanceM drives surface clearance and wall attachments so rectangular/oval ducts use their largest cross-section dimension against walls (plus a small standoff), while floor/ceiling clearance still uses height. The shared distribution run tool locks drafting to the wall face where the run started (when not snapped to a port/body) and releases that lock when the user commits a segment that steps off the wall plane.

Deletion: Duct and pipe onDeleteCascade now includes automatic run end caps via findAutomaticRunEndCapIds, leaving manually placed end caps untouched.

Inspector: ParamGroup gains optional defaultExpanded, wired through single- and multi-selection parametric panels; action buttons use a two-column grid when parametric actions are present. Group React keys are more stable (nodeType + label).

Editor: Scene loading passes the current sceneLoadAttempt into the loader and only applies the graph when the attempt still matches, avoiding stale loads on rapid retries.

Tests: Adds @react-three/test-renderer and coverage for clearance math, wall locking, end-cap cascade delete, and wall-plane behavior for duct/pipe tools.

^{Reviewed by Cursor Bugbot for commit cdf2cbc. Bugbot is set up for automated code reviews on this repo. Configure here.}

[pascal]

I hit an error while handling your request (Model unavailable on AI Gateway free tier: Free tier users do not have access to this model. Upgrade to paid credits at https://vercel.com/d?to=%2F%5Bteam%5D%2F%7E%2Fai%3Fmodal%3Dtop-up for unrestricted…).

Please try again, rephrase, or reach out if it keeps failing.

Error id: 3c5ee842-fe04-498b-b876-c397431a6467

[cursor]

Stale Bugbot comment from a previous run.

[cursor]

Stale Bugbot comment from a previous run.

[cursor]

Cursor Bugbot has reviewed your changes using high effort and found 1 potential issue.

^{❌ Bugbot Autofix is OFF. To automatically fix reported issues with cloud agents, enable autofix in the Cursor dashboard.}

^{Reviewed by Cursor Bugbot for commit c02bca2. Configure here.}