@2112-lab/central-plant 0.1.51 → 0.1.52

package/dist/bundle/index.js

@@ -19090,23 +19090,30 @@ var TransformOperationsManager = /*#__PURE__*/function () {
      * @param {number} value - The value to translate by
      * @returns {boolean} True if translation was successful, false otherwise
      */
+    /**
+     * Validate all preconditions for translateSegment operation
+     * @param {string} segmentId - The UUID of the segment to translate
+     * @param {string} axis - The axis to translate on ('x', 'y', or 'z')
+     * @param {number} value - The value to translate by
+     * @returns {Object|null} Returns { segment } if all checks pass, null otherwise
+     * @private
+     */
   }, {
-    key: "translateSegment",
-    value: function translateSegment(segmentId, axis, value) {
-      var _segment$userData, _segment$userData2, _segment$userData3, _this$sceneViewer2, _this$sceneViewer$man2, _this$sceneViewer$man3, _this$sceneViewer$man4;
-      var skipPathUpdate = arguments.length > 3 && arguments[3] !== undefined ? arguments[3] : false;
+    key: "validateTranslateSegment",
+    value: function validateTranslateSegment(segmentId, axis, value) {
+      var _segment$userData, _segment$userData2, _segment$userData3;
       // Validate parameters
       if (!segmentId || !axis || value === undefined || value === null) {
         console.error('❌ translateSegment(): Invalid parameters');
-        return false;
+        return null;
       }
       if (!['x', 'y', 'z'].includes(axis)) {
         console.error("\u274C translateSegment(): Invalid axis '".concat(axis, "'. Must be 'x', 'y', or 'z'"));
-        return false;
+        return null;
       }
       if (!this.sceneViewer || !this.sceneViewer.scene) {
         console.error('❌ translateSegment(): Scene viewer or scene not available');
-        return false;
+        return null;
       }
 
       // Find the segment in the scene
@@ -19119,25 +19126,25 @@ var TransformOperationsManager = /*#__PURE__*/function () {
       });
       if (!segment) {
         console.error("\u274C translateSegment(): Segment with ID '".concat(segmentId, "' not found in scene"));
-        return false;
+        return null;
       }
 
       // Validate that it's actually a pipe segment
       if (!((_segment$userData = segment.userData) !== null && _segment$userData !== void 0 && _segment$userData.objectType) === 'segment') {
         console.error("\u274C translateSegment(): Object with ID '".concat(segmentId, "' is not a valid pipe segment"));
-        return false;
+        return null;
       }
 
       // Check if segment is transformable
       if (((_segment$userData2 = segment.userData) === null || _segment$userData2 === void 0 ? void 0 : _segment$userData2.transformable) === false) {
         console.warn("\u26A0\uFE0F translateSegment(): Segment '".concat(segmentId, "' is marked as non-transformable (stub segment)"));
-        return false;
+        return null;
       }
 
       // Check if segment is immutable (computed from pathfinder)
       if (((_segment$userData3 = segment.userData) === null || _segment$userData3 === void 0 ? void 0 : _segment$userData3.immutable) === true) {
         console.warn("\u26A0\uFE0F translateSegment(): Segment '".concat(segmentId, "' is immutable (computed from pathfinder)"));
-        return false;
+        return null;
       }
 
       // Check segment orientation and cancel invalid translations
@@ -19156,62 +19163,74 @@ var TransformOperationsManager = /*#__PURE__*/function () {
       if (absX > tolerance && axis === 'x') {
         console.warn("\u26A0\uFE0F translateSegment(): Cannot translate segment along ".concat(axis.toUpperCase(), " axis - segment runs along this axis"));
         console.warn("   Segment direction: [".concat(direction.x.toFixed(3), ", ").concat(direction.y.toFixed(3), ", ").concat(direction.z.toFixed(3), "]"));
-        return false;
+        return null;
       }
       if (absY > tolerance && axis === 'y') {
         console.warn("\u26A0\uFE0F translateSegment(): Cannot translate segment along ".concat(axis.toUpperCase(), " axis - segment runs along this axis"));
         console.warn("   Segment direction: [".concat(direction.x.toFixed(3), ", ").concat(direction.y.toFixed(3), ", ").concat(direction.z.toFixed(3), "]"));
-        return false;
+        return null;
       }
       if (absZ > tolerance && axis === 'z') {
         console.warn("\u26A0\uFE0F translateSegment(): Cannot translate segment along ".concat(axis.toUpperCase(), " axis - segment runs along this axis"));
         console.warn("   Segment direction: [".concat(direction.x.toFixed(3), ", ").concat(direction.y.toFixed(3), ", ").concat(direction.z.toFixed(3), "]"));
-        return false;
+        return null;
       }
-      console.log('[translateSegment] segment:', segment);
 
-      // Calculate segment endpoints to check for nearby connectors
-      var segmentEndpoints = this.calculateSegmentEndpoints(segment);
+      // All checks passed - return the segment
+      return {
+        segment: segment
+      };
+    }
 
-      // Check if there are any connectors (component or manual) at segment endpoints
-      var connectorsAtEndpoints = this.findConnectorsAtPositions([segmentEndpoints.start, segmentEndpoints.end], 0.15 // tolerance for position matching
-      );
-      console.log("\uD83D\uDD0D Found ".concat(connectorsAtEndpoints.length, " total connectors at segment endpoints:"), connectorsAtEndpoints.map(function (c) {
-        var _c$userData, _c$parent, _c$parent2;
-        return {
-          uuid: c.uuid,
-          type: (_c$userData = c.userData) === null || _c$userData === void 0 ? void 0 : _c$userData.objectType,
-          parent: (_c$parent = c.parent) === null || _c$parent === void 0 ? void 0 : _c$parent.uuid,
-          parentType: (_c$parent2 = c.parent) === null || _c$parent2 === void 0 || (_c$parent2 = _c$parent2.userData) === null || _c$parent2 === void 0 ? void 0 : _c$parent2.objectType
-        };
-      }));
-      console.log("\uD83D\uDD04 translateSegment(): Translating segment ".concat(segmentId, " on ").concat(axis, " axis by ").concat(value));
+    /**
+     * Validate collision constraints for translateSegment operation
+     * Temporarily applies the translation to check for collisions, then reverts
+     * @param {THREE.Object3D} segment - The segment to check
+     * @param {string} axis - The axis to translate on ('x', 'y', or 'z')
+     * @param {number} value - The value to translate by
+     * @returns {boolean} True if no collisions detected, false if translation would cause collision
+     * @private
+     */
+  }, {
+    key: "validateTranslateSegmentCollisions",
+    value: function validateTranslateSegmentCollisions(segment, axis, value) {
+      var _this$sceneViewer2;
+      // Store original position for reverting
+      var originalPosition = segment.position[axis];
 
       // Temporarily apply the translation to check for collisions
-      var originalPosition = segment.position[axis];
       segment.position[axis] += value;
       segment.updateMatrix();
       segment.updateMatrixWorld(true);
 
       // Check for collision with component connectors along the segment's path
-      var collision = this.checkSegmentPathConnectorCollision(segment);
-      if (collision) {
+      var connectorCollision = this.checkSegmentPathConnectorCollision(segment);
+      if (connectorCollision) {
         // Revert the translation
         segment.position[axis] = originalPosition;
         segment.updateMatrix();
         segment.updateMatrixWorld(true);
         console.warn("\u26A0\uFE0F translateSegment(): Translation canceled - segment path comes within 0.5 radius of component connector");
-        console.warn("   Distance to connector: ".concat(collision.distance.toFixed(3), " (max allowed: 0.5)"));
-        console.warn("   Closest point on segment: [".concat(collision.collisionPoint.x.toFixed(3), ", ").concat(collision.collisionPoint.y.toFixed(3), ", ").concat(collision.collisionPoint.z.toFixed(3), "]"));
-        console.warn("   Connector position: [".concat(collision.connectorPos.x.toFixed(3), ", ").concat(collision.connectorPos.y.toFixed(3), ", ").concat(collision.connectorPos.z.toFixed(3), "]"));
-        console.warn("   Colliding connector: ".concat(collision.connectorId, " on component: ").concat(collision.componentId));
+        console.warn("   Distance to connector: ".concat(connectorCollision.distance.toFixed(3), " (max allowed: 0.5)"));
+        console.warn("   Closest point on segment: [".concat(connectorCollision.collisionPoint.x.toFixed(3), ", ").concat(connectorCollision.collisionPoint.y.toFixed(3), ", ").concat(connectorCollision.collisionPoint.z.toFixed(3), "]"));
+        console.warn("   Connector position: [".concat(connectorCollision.connectorPos.x.toFixed(3), ", ").concat(connectorCollision.connectorPos.y.toFixed(3), ", ").concat(connectorCollision.connectorPos.z.toFixed(3), "]"));
+        console.warn("   Colliding connector: ".concat(connectorCollision.connectorId, " on component: ").concat(connectorCollision.componentId));
         return false;
       }
 
-      // Revert the temporary translation before continuing with the normal flow
-      segment.position[axis] = originalPosition;
-      segment.updateMatrix();
-      segment.updateMatrixWorld(true);
+      // Check for collision with component bounding boxes
+      var componentCollision = this.checkSegmentComponentBoundingBoxCollision(segment);
+      if (componentCollision) {
+        // Revert the translation
+        segment.position[axis] = originalPosition;
+        segment.updateMatrix();
+        segment.updateMatrixWorld(true);
+        console.warn("\u26A0\uFE0F translateSegment(): Translation canceled - segment would collide with component bounding box");
+        console.warn("   Component ID: ".concat(componentCollision.componentId));
+        console.warn("   Component Name: ".concat(componentCollision.componentName));
+        console.warn("   Component Type: ".concat(componentCollision.componentType));
+        return false;
+      }
 
       // Check if translationalOverrideForAutomaticSegments is enabled
       var translationalOverride = (_this$sceneViewer2 = this.sceneViewer) === null || _this$sceneViewer2 === void 0 || (_this$sceneViewer2 = _this$sceneViewer2.managers) === null || _this$sceneViewer2 === void 0 || (_this$sceneViewer2 = _this$sceneViewer2.settingsManager) === null || _this$sceneViewer2 === void 0 ? void 0 : _this$sceneViewer2.getSetting('scene', 'translationalOverrideForAutomaticSegments');
@@ -19220,33 +19239,50 @@ var TransformOperationsManager = /*#__PURE__*/function () {
       if (translationalOverride === false) {
         console.log('🔍 Checking for intersections with computed segments (translationalOverrideForAutomaticSegments is disabled)');
 
-        // Temporarily apply the translation to check for intersections
-        var _originalPosition = segment.position[axis];
-        segment.position[axis] += value;
-        segment.updateMatrix();
-        segment.updateMatrixWorld(true);
-
         // Check if the translated segment intersects with any computed segments
         var hasIntersection = this.checkSegmentIntersection(segment);
         console.log("\uD83D\uDD04 translateSegment() hasIntersection:", hasIntersection);
         if (hasIntersection) {
           // Revert the translation
-          segment.position[axis] = _originalPosition;
+          segment.position[axis] = originalPosition;
           segment.updateMatrix();
           segment.updateMatrixWorld(true);
           console.warn("\u26A0\uFE0F translateSegment(): Translation canceled - segment would intersect with computed segment(s)");
           return false;
         }
         console.log('✅ No intersections detected, proceeding with translation');
-      } else {
-        // Apply the translation to the Three.js object
-        segment.position[axis] += value;
+      }
 
-        // Update matrices
-        segment.updateMatrix();
-        segment.updateMatrixWorld(true);
+      // Revert the temporary translation
+      segment.position[axis] = originalPosition;
+      segment.updateMatrix();
+      segment.updateMatrixWorld(true);
+      return true;
+    }
+  }, {
+    key: "translateSegment",
+    value: function translateSegment(segmentId, axis, value) {
+      var _this$sceneViewer$man2, _this$sceneViewer$man3, _this$sceneViewer$man4;
+      var skipPathUpdate = arguments.length > 3 && arguments[3] !== undefined ? arguments[3] : false;
+      // Run all basic validation checks
+      var validationResult = this.validateTranslateSegment(segmentId, axis, value);
+      if (!validationResult) {
+        return false;
+      }
+      var segment = validationResult.segment;
+      console.log("\uD83D\uDD04 translateSegment(): Translating segment ".concat(segmentId, " on ").concat(axis, " axis by ").concat(value));
+
+      // Run collision validation checks
+      var collisionValidation = this.validateTranslateSegmentCollisions(segment, axis, value);
+      if (!collisionValidation) {
+        return false;
       }
 
+      // All validations passed - apply the translation
+      segment.position[axis] += value;
+      segment.updateMatrix();
+      segment.updateMatrixWorld(true);
+
       // Validate PathfindingManager and SceneOperationsManager availability
       var pathfindingManager = (_this$sceneViewer$man2 = this.sceneViewer.managers) === null || _this$sceneViewer$man2 === void 0 ? void 0 : _this$sceneViewer$man2.pathfindingManager;
       var sceneOperationsManager = (_this$sceneViewer$man3 = this.sceneViewer.managers) === null || _this$sceneViewer$man3 === void 0 ? void 0 : _this$sceneViewer$man3.sceneOperationsManager;
@@ -20030,6 +20066,48 @@ var TransformOperationsManager = /*#__PURE__*/function () {
       return collision;
     }
 
+    /**
+     * Check if a segment would collide with any component's bounding box
+     * @param {THREE.Object3D} segment - The segment to check for collisions
+     * @returns {Object|null} Collision info {componentId, componentName, componentType} if collision detected, null otherwise
+     * @private
+     */
+  }, {
+    key: "checkSegmentComponentBoundingBoxCollision",
+    value: function checkSegmentComponentBoundingBoxCollision(segment) {
+      var _this$sceneViewer8;
+      if (!((_this$sceneViewer8 = this.sceneViewer) !== null && _this$sceneViewer8 !== void 0 && _this$sceneViewer8.scene) || !segment) {
+        return null;
+      }
+
+      // Create a bounding box for the segment
+      var segmentBBox = new THREE__namespace.Box3().setFromObject(segment);
+      var collision = null;
+
+      // Traverse scene to find all components
+      this.sceneViewer.scene.traverse(function (child) {
+        var _child$userData11, _child$userData12;
+        if (collision) return; // Stop if collision already found
+
+        // Check if this is a component (equipment)
+        if (((_child$userData11 = child.userData) === null || _child$userData11 === void 0 ? void 0 : _child$userData11.objectType) === 'component' && (_child$userData12 = child.userData) !== null && _child$userData12 !== void 0 && _child$userData12.libraryId) {
+          // Create bounding box for the component
+          var componentBBox = new THREE__namespace.Box3().setFromObject(child);
+
+          // Check if bounding boxes intersect
+          if (segmentBBox.intersectsBox(componentBBox)) {
+            console.log('⚠️ TransformOperationsManager: Segment bounding box collision with component:', child.userData.libraryId || child.name || child.uuid);
+            collision = {
+              componentId: child.uuid,
+              componentName: child.name || 'Unknown',
+              componentType: child.userData.libraryId || 'Unknown'
+            };
+          }
+        }
+      });
+      return collision;
+    }
+
     /**
      * Calculate the minimum distance between two line segments in 3D space
      * @param {THREE.Vector3} p1 - Start point of first segment
@@ -20139,10 +20217,10 @@ var TransformOperationsManager = /*#__PURE__*/function () {
   }, {
     key: "snapSegmentConnectorsToNearbyEndpoints",
     value: function snapSegmentConnectorsToNearbyEndpoints(movedSegment) {
-      var _this$sceneViewer8,
-        _this$sceneViewer9,
+      var _this$sceneViewer9,
+        _this$sceneViewer0,
         _this2 = this;
-      if (!movedSegment || !((_this$sceneViewer8 = this.sceneViewer) !== null && _this$sceneViewer8 !== void 0 && _this$sceneViewer8.scene)) {
+      if (!movedSegment || !((_this$sceneViewer9 = this.sceneViewer) !== null && _this$sceneViewer9 !== void 0 && _this$sceneViewer9.scene)) {
         return [];
       }
       console.log('🔗 Finding adjacent segments connected to moved segment...');
@@ -20150,8 +20228,8 @@ var TransformOperationsManager = /*#__PURE__*/function () {
       // Get the moved segment's connectors
       var movedConnectors = [];
       movedSegment.traverse(function (child) {
-        var _child$userData11;
-        if (((_child$userData11 = child.userData) === null || _child$userData11 === void 0 ? void 0 : _child$userData11.objectType) === 'segment-connector') {
+        var _child$userData13;
+        if (((_child$userData13 = child.userData) === null || _child$userData13 === void 0 ? void 0 : _child$userData13.objectType) === 'segment-connector') {
           movedConnectors.push(child);
         }
       });
@@ -20164,7 +20242,7 @@ var TransformOperationsManager = /*#__PURE__*/function () {
       var newEndpoints = this.calculateSegmentEndpoints(movedSegment);
 
       // Check scene data for connections involving the moved segment's connectors
-      var connections = ((_this$sceneViewer9 = this.sceneViewer) === null || _this$sceneViewer9 === void 0 || (_this$sceneViewer9 = _this$sceneViewer9.currentSceneData) === null || _this$sceneViewer9 === void 0 ? void 0 : _this$sceneViewer9.connections) || [];
+      var connections = ((_this$sceneViewer0 = this.sceneViewer) === null || _this$sceneViewer0 === void 0 || (_this$sceneViewer0 = _this$sceneViewer0.currentSceneData) === null || _this$sceneViewer0 === void 0 ? void 0 : _this$sceneViewer0.connections) || [];
       var movedConnectorIds = movedConnectors.map(function (c) {
         return c.uuid;
       });
@@ -20221,8 +20299,8 @@ var TransformOperationsManager = /*#__PURE__*/function () {
         // Get all connectors of the adjacent segment
         var adjacentConnectors = [];
         adjacentSegment.traverse(function (child) {
-          var _child$userData12;
-          if (((_child$userData12 = child.userData) === null || _child$userData12 === void 0 ? void 0 : _child$userData12.objectType) === 'segment-connector') {
+          var _child$userData14;
+          if (((_child$userData14 = child.userData) === null || _child$userData14 === void 0 ? void 0 : _child$userData14.objectType) === 'segment-connector') {
             adjacentConnectors.push(child);
           }
         });
@@ -20320,9 +20398,9 @@ var TransformOperationsManager = /*#__PURE__*/function () {
   }, {
     key: "updateConnectorPositionInSceneData",
     value: function updateConnectorPositionInSceneData(connector, worldPosition, parentSegment) {
-      var _this$sceneViewer0;
+      var _this$sceneViewer1;
       // Update scene data if available
-      if (!((_this$sceneViewer0 = this.sceneViewer) !== null && _this$sceneViewer0 !== void 0 && _this$sceneViewer0.currentSceneData)) {
+      if (!((_this$sceneViewer1 = this.sceneViewer) !== null && _this$sceneViewer1 !== void 0 && _this$sceneViewer1.currentSceneData)) {
         return;
       }
       var cleanPosition = function cleanPosition(value) {
@@ -20584,8 +20662,8 @@ var TransformOperationsManager = /*#__PURE__*/function () {
       // Get the active segment's connectors
       var activeConnectors = [];
       activeSegment.traverse(function (child) {
-        var _child$userData13;
-        if (((_child$userData13 = child.userData) === null || _child$userData13 === void 0 ? void 0 : _child$userData13.objectType) === 'segment-connector') {
+        var _child$userData15;
+        if (((_child$userData15 = child.userData) === null || _child$userData15 === void 0 ? void 0 : _child$userData15.objectType) === 'segment-connector') {
           activeConnectors.push(child);
         }
       });
@@ -25234,6 +25312,11 @@ var PathRenderingManager = /*#__PURE__*/function (_BaseDisposable) {
           var fromIsComponentConnector = pathData.fromObjectType === 'component-connector';
           var toIsComponentConnector = pathData.toObjectType === 'component-connector';
 
+          // Check if endpoints have direction constraints (more accurate for immutability)
+          // Segments adjacent to connectors with direction should be immutable
+          var fromHasDirection = pathData.fromHasDirection !== undefined ? pathData.fromHasDirection : fromIsComponentConnector;
+          var toHasDirection = pathData.toHasDirection !== undefined ? pathData.toHasDirection : toIsComponentConnector;
+
           // Create one cylinder per segment (after colinear optimization, this should be minimal segments)
           for (var j = 0; j < pathPoints.length - 1; j++) {
             var start = pathPoints[j];
@@ -25262,10 +25345,12 @@ var PathRenderingManager = /*#__PURE__*/function (_BaseDisposable) {
             // Make pipe segments selectable and add identifying data
             var segmentId = cylinder.uuid;
 
-            // Determine if this segment should be immutable (first or last 0.5-unit segment connected to component)
+            // Determine if this segment should be immutable (first or last segment connected to connector with direction)
+            // Segments adjacent to connectors with direction constraints are immutable (cannot be edited)
+            // Segments adjacent to gateways (no direction) can be edited
             var isFirstSegment = j === 0;
             var isLastSegment = j === pathPoints.length - 2;
-            var isImmutable = fromIsComponentConnector && isFirstSegment || toIsComponentConnector && isLastSegment;
+            var isImmutable = fromHasDirection && isFirstSegment || toHasDirection && isLastSegment;
 
             // Add userData to make pipe segments selectable and for tooltip display
             cylinder.userData = {
@@ -25287,7 +25372,6 @@ var PathRenderingManager = /*#__PURE__*/function (_BaseDisposable) {
             _this3.createAndAddElbowIfNeeded(pathPoints, j, pipeRadius, pipeMaterial, pathData, index, sceneViewer.scene // Pass scene instead of polyline
             );
           }
-          console.log("\u2705 Created pipe path ".concat(pathData.from, "-").concat(pathData.to, " with ").concat(pathPoints.length - 1, " segments"));
         }
       });
     }
@@ -25637,7 +25721,8 @@ var ConnectorManager = /*#__PURE__*/function (_BaseDisposable) {
 
     /**
      * Restructure connections to use the new connectors
-     * @param {string} authoritativeConnectorUUID - The authoritative connector UUID
+     * Measures distance from point-a to both connectors and connects to the nearest one
+     * @param {string} authoritativeConnectorUUID - The authoritative connector UUID (point-a)
      * @param {Array} connectors - Array of connector objects (0: start, 1: end)
      * @param {Object} currentSceneData - Current scene data
      * @param {Array<string>} convertedGatewayUUIDs - Array of gateway UUIDs that were converted to manual (optional)
@@ -25652,6 +25737,66 @@ var ConnectorManager = /*#__PURE__*/function (_BaseDisposable) {
 
       console.log("\uD83D\uDD27 [restructureConnections] connectors:", JSON.parse(JSON.stringify(connectors)));
       console.log("\uD83D\uDD27 [restructureConnections] convertedGatewayUUIDs:", convertedGatewayUUIDs);
+      console.log("\uD83D\uDD27 [restructureConnections] authoritativeConnectorUUID:", authoritativeConnectorUUID);
+
+      // Find the authoritative connector object (point-a) in the scene to measure distances
+      var authoritativeObject = null;
+      this.sceneViewer.scene.traverse(function (obj) {
+        if (obj.uuid === authoritativeConnectorUUID) {
+          authoritativeObject = obj;
+        }
+      });
+      if (!authoritativeObject) {
+        console.error("\u274C [restructureConnections] Could not find authoritative connector: ".concat(authoritativeConnectorUUID));
+        console.error("\u274C [restructureConnections] This may indicate:");
+        console.error("   1. The connector UUID changed during gateway manualization");
+        console.error("   2. The original connection was removed/modified before restructuring");
+        console.error("   3. The findOriginalConnection method returned a stale connection");
+        console.error("\u274C [restructureConnections] Current connections:", JSON.stringify(currentSceneData.connections, null, 2));
+
+        // FALLBACK: Try to find any connector that might be the authoritative one
+        // Look for objects with similar UUID patterns or check the original connection endpoints
+        console.warn("\u26A0\uFE0F [restructureConnections] Attempting fallback connector search...");
+
+        // Search for possible matches (component connectors, gateway connectors, etc.)
+        var possibleMatches = [];
+        this.sceneViewer.scene.traverse(function (obj) {
+          var _obj$userData, _obj$userData2, _obj$userData3;
+          if (((_obj$userData = obj.userData) === null || _obj$userData === void 0 ? void 0 : _obj$userData.objectType) === 'connector' || ((_obj$userData2 = obj.userData) === null || _obj$userData2 === void 0 ? void 0 : _obj$userData2.objectType) === 'segment-connector' || ((_obj$userData3 = obj.userData) === null || _obj$userData3 === void 0 ? void 0 : _obj$userData3.objectType) === 'gateway-connector') {
+            possibleMatches.push({
+              uuid: obj.uuid,
+              objectType: obj.userData.objectType,
+              isDeclared: obj.userData.isDeclared
+            });
+          }
+        });
+        console.warn("\u26A0\uFE0F [restructureConnections] Found ".concat(possibleMatches.length, " possible connectors:"), possibleMatches);
+        console.error("\u274C [restructureConnections] Cannot proceed without authoritative connector");
+        return;
+      }
+
+      // Get world positions for distance calculation
+      var pointA = new THREE__namespace.Vector3();
+      authoritativeObject.getWorldPosition(pointA);
+      var connector1Position = new THREE__namespace.Vector3();
+      var connector2Position = new THREE__namespace.Vector3();
+      connectors[0].getWorldPosition(connector1Position);
+      connectors[1].getWorldPosition(connector2Position);
+
+      // Calculate distances from point-a to both segment connectors
+      var distanceToConnector1 = pointA.distanceTo(connector1Position);
+      var distanceToConnector2 = pointA.distanceTo(connector2Position);
+      console.log("\uD83D\uDCCF [restructureConnections] Distance from ".concat(authoritativeConnectorUUID, " to:"));
+      console.log("   - ".concat(startConnectorUUID, ": ").concat(distanceToConnector1.toFixed(4)));
+      console.log("   - ".concat(endConnectorUUID, ": ").concat(distanceToConnector2.toFixed(4)));
+
+      // Determine which connector is nearest to point-a
+      var nearestConnector = distanceToConnector1 <= distanceToConnector2 ? connectors[0] : connectors[1];
+      var farthestConnector = distanceToConnector1 > distanceToConnector2 ? connectors[0] : connectors[1];
+      var nearestConnectorUUID = nearestConnector.uuid;
+      var farthestConnectorUUID = farthestConnector.uuid;
+      console.log("\u2705 [restructureConnections] Nearest connector: ".concat(nearestConnectorUUID, " (distance: ").concat(Math.min(distanceToConnector1, distanceToConnector2).toFixed(4), ")"));
+      console.log("\uD83D\uDCCD [restructureConnections] Farthest connector: ".concat(farthestConnectorUUID, " (distance: ").concat(Math.max(distanceToConnector1, distanceToConnector2).toFixed(4), ")"));
 
       // Deep copy connections array to prevent unintended mutations during iteration
       // Then map to update references, creating new connection objects
@@ -25660,30 +25805,32 @@ var ConnectorManager = /*#__PURE__*/function (_BaseDisposable) {
 
         // Create a shallow copy of the connection object
         var updatedConnection = _objectSpread2({}, connection);
+
+        // Update connections to point to the FARTHEST connector (opposite end from point-a)
         if (connection.from === authoritativeConnectorUUID) {
-          updatedConnection.from = endConnectorUUID;
-          console.log("\u2705 [restructureConnections] Updated connection.from to ".concat(endConnectorUUID));
+          updatedConnection.from = farthestConnectorUUID;
+          console.log("\u2705 [restructureConnections] Updated connection.from to ".concat(farthestConnectorUUID, " (farthest)"));
         }
         if (connection.to === authoritativeConnectorUUID) {
-          updatedConnection.to = endConnectorUUID;
-          console.log("\u2705 [restructureConnections] Updated connection.to to ".concat(endConnectorUUID));
+          updatedConnection.to = farthestConnectorUUID;
+          console.log("\u2705 [restructureConnections] Updated connection.to to ".concat(farthestConnectorUUID, " (farthest)"));
         }
         return updatedConnection;
       });
 
       // Check if the new connection already exists to prevent duplicates
       var newConnectionExists = currentSceneData.connections.some(function (conn) {
-        return conn.from === authoritativeConnectorUUID && conn.to === startConnectorUUID || conn.from === startConnectorUUID && conn.to === authoritativeConnectorUUID;
+        return conn.from === authoritativeConnectorUUID && conn.to === nearestConnectorUUID || conn.from === nearestConnectorUUID && conn.to === authoritativeConnectorUUID;
       });
       if (!newConnectionExists) {
-        // Add new connection from authoritative connector to the segment start
+        // Add new connection from authoritative connector (point-a) to the NEAREST segment connector
         currentSceneData.connections.push({
           from: authoritativeConnectorUUID,
-          to: startConnectorUUID
+          to: nearestConnectorUUID
         });
-        console.log("\u2705 [restructureConnections] Added new connection: ".concat(authoritativeConnectorUUID, " \u2192 ").concat(startConnectorUUID));
+        console.log("\u2705 [restructureConnections] Added new connection: ".concat(authoritativeConnectorUUID, " \u2192 ").concat(nearestConnectorUUID, " (nearest)"));
       } else {
-        console.log("\u26A0\uFE0F [restructureConnections] Connection already exists, skipping: ".concat(authoritativeConnectorUUID, " \u2192 ").concat(startConnectorUUID));
+        console.log("\u26A0\uFE0F [restructureConnections] Connection already exists, skipping: ".concat(authoritativeConnectorUUID, " \u2192 ").concat(nearestConnectorUUID));
       }
 
       // Log converted gateways for tracking
@@ -25730,11 +25877,11 @@ var ConnectorManager = /*#__PURE__*/function (_BaseDisposable) {
       var fromObject = null;
       var toObject = null;
       sceneViewer.scene.traverse(function (obj) {
-        var _obj$userData, _obj$userData2;
-        if (obj.uuid === pathFrom || ((_obj$userData = obj.userData) === null || _obj$userData === void 0 ? void 0 : _obj$userData.originalUuid) === pathFrom) {
+        var _obj$userData4, _obj$userData5;
+        if (obj.uuid === pathFrom || ((_obj$userData4 = obj.userData) === null || _obj$userData4 === void 0 ? void 0 : _obj$userData4.originalUuid) === pathFrom) {
           fromObject = obj;
         }
-        if (obj.uuid === pathTo || ((_obj$userData2 = obj.userData) === null || _obj$userData2 === void 0 ? void 0 : _obj$userData2.originalUuid) === pathTo) {
+        if (obj.uuid === pathTo || ((_obj$userData5 = obj.userData) === null || _obj$userData5 === void 0 ? void 0 : _obj$userData5.originalUuid) === pathTo) {
           toObject = obj;
         }
       });
@@ -29444,20 +29591,29 @@ var SceneOperationsManager = /*#__PURE__*/function () {
       // Now add connectors to the segment's children array in scene data
       connectorManager.addConnectorsToScene(connectors);
 
-      // Find the original connection that this segment belongs to (after gateways are converted)
+      // Check and convert connected gateways to manual (declared) FIRST
+      // CRITICAL: This must happen BEFORE finding the authoritative connector
+      // because gateway conversion may modify the connections array
+      // NOTE: This may trigger path regeneration via translateGateway, so segment must already be renamed
+      var convertedGatewayUUIDs = this._convertConnectedGatewaysToManual(connectors, currentSceneData);
+      console.log('🔍 Gateway conversion completed, now finding authoritative connector with updated connections');
+
+      // Find the original connection that this segment belongs to (AFTER gateways are converted)
+      // IMPORTANT: This must run after gateway conversion because connections may have changed
       var originalConnection = connectorManager.findOriginalConnection(segment, currentSceneData.connections);
       if (!originalConnection) {
         console.warn('⚠️ Could not find original connection for segment:', segment.uuid);
+        console.warn('⚠️ This may indicate the connection was modified during gateway conversion');
+        console.warn('⚠️ Available connections:', JSON.stringify(currentSceneData.connections, null, 2));
         return;
       }
-      console.log('🔍 Found original connection:', originalConnection);
+      console.log('🔍 Found original connection (after gateway conversion):', originalConnection);
+
+      // Determine the authoritative connector (the non-gateway endpoint)
+      // After gateway conversion, gateways should have connectors, so check for "Gateway" pattern
       var authoritativeConnectorUUID = originalConnection.from.includes("Gateway") === false ? originalConnection.from : originalConnection.to;
       console.log('[SceneOperations] authoritativeConnectorUUID:', authoritativeConnectorUUID);
 
-      // Check and convert connected gateways to manual (declared)
-      // NOTE: This may trigger path regeneration via translateGateway, so segment must already be renamed
-      var convertedGatewayUUIDs = this._convertConnectedGatewaysToManual(connectors, currentSceneData);
-
       // Restructure connections, passing any converted gateway UUIDs
       connectorManager.restructureConnections(authoritativeConnectorUUID, connectors, currentSceneData, convertedGatewayUUIDs);
 
@@ -33609,7 +33765,7 @@ var CentralPlant = /*#__PURE__*/function (_BaseDisposable) {
    * Initialize the CentralPlant manager
    * 
    * @constructor
-   * @version 0.1.51
+   * @version 0.1.52
    * @updated 2025-10-22
    * 
    * @description Creates a new CentralPlant instance and initializes internal managers and utilities.

package/dist/cjs/src/core/centralPlant.js

@@ -19,7 +19,7 @@ var CentralPlant = /*#__PURE__*/function (_BaseDisposable) {
    * Initialize the CentralPlant manager
    * 
    * @constructor
-   * @version 0.1.51
+   * @version 0.1.52
    * @updated 2025-10-22
    * 
    * @description Creates a new CentralPlant instance and initializes internal managers and utilities.