@2112-lab/central-plant 0.3.47 → 0.3.49

package/dist/cjs/src/managers/scene/modelManager.js

@@ -4,6 +4,7 @@ Object.defineProperty(exports, '__esModule', { value: true });
 
 var _rollupPluginBabelHelpers = require('../../../_virtual/_rollupPluginBabelHelpers.js');
 var THREE = require('three');
+var nameUtils = require('../../utils/nameUtils.js');
 var ioDeviceUtils = require('../../utils/ioDeviceUtils.js');
 var behaviorRegistration = require('../../utils/behaviorRegistration.js');
 var modelPreloader = require('../../rendering/modelPreloader.js');
@@ -162,36 +163,58 @@ var ModelManager = /*#__PURE__*/function () {
      * @param {THREE.Object3D} targetMesh - The mesh whose connectors to preserve
      * @param {string} parentUuid - The UUID of the parent component
      */
+    /**
+     * Identifies all connector objects within a model hierarchy and prepares them
+     * to be preserved when the model is replaced or modified.
+     * Uses traverse() to find connectors at any depth in the hierarchy.
+     * @param {THREE.Object3D} targetMesh - The root of the model to search
+     * @param {string} parentUuid - The UUID of the parent component
+     * @returns {Array<THREE.Object3D>} Array of cloned and prepared connector objects
+     */
   }, {
     key: "_preserveConnectorChildren",
     value: function _preserveConnectorChildren(targetMesh, parentUuid) {
       var _this = this;
       var connectorChildren = [];
-      targetMesh.children.forEach(function (child, index) {
+      var connectorIndex = 0;
+
+      // Use traverse to find connectors at ANY depth in the hierarchy
+      targetMesh.traverse(function (child) {
         var _child$userData;
         var isConnectorGeometry = child.geometry && (child.geometry.uuid === 'CONNECTOR-GEO' || child.geometry.type === 'SphereGeometry' && child.geometry.parameters);
         var isConnectorByName = child.name && child.name.toLowerCase().includes('connector');
-        // Also recognise connectors declared via userData (e.g. inline connectors from SAMPLE_1.json
-        // whose geometry may be a fallback BufferGeometry rather than a SphereGeometry).
         var isConnectorByUserData = ((_child$userData = child.userData) === null || _child$userData === void 0 ? void 0 : _child$userData.objectType) === 'connector';
         if (isConnectorGeometry && isConnectorByName || isConnectorByUserData) {
+          connectorIndex++;
+
           // Ensure userData exists and has worldBoundingBox
           if (!child.userData) child.userData = {};
           if (!child.userData.worldBoundingBox) {
             child.userData.worldBoundingBox = _this._calculateWorldBoundingBox(child);
           }
 
-          // Clone and preserve critical userData
+          // Clone the connector
           var clonedConnector = child.clone();
 
-          // Generate proper connector UUID based on parent component UUID
-          // Format: COMPONENT-UUID-CONNECTOR-INDEX (matching JSON import pattern)
-          var connectorUuid = "".concat(parentUuid, "-CONNECTOR-").concat(index + 1);
+          // CRITICAL: Convert nested world position to root-relative position
+          // This ensures the connector stays in the same place when re-added as a direct child of targetMesh
+          var targetInverse = targetMesh.matrixWorld.clone().invert();
+          var worldPos = new THREE__namespace.Vector3();
+          child.getWorldPosition(worldPos);
+          clonedConnector.position.copy(worldPos.applyMatrix4(targetInverse));
+
+          // Get hardcoded UUID if it exists (e.g. from JSON mesh placeholder)
+          // This ensures compatibility with existing scene JSON naming conventions
+          var existingUuid = nameUtils.getHardcodedUuid(child);
+
+          // Generate fallback UUID only if existing one isn't already parent-prefixed
+          // Format: COMPONENT-UUID-CONNECTOR-INDEX (stable fallback)
+          var connectorUuid = existingUuid && existingUuid.includes(parentUuid) ? existingUuid : "".concat(parentUuid, "-CONNECTOR-").concat(connectorIndex);
           clonedConnector.uuid = connectorUuid;
           if (child.userData) {
             clonedConnector.userData = _rollupPluginBabelHelpers.objectSpread2({}, child.userData);
 
-            // Deep copy critical data - handle both array [x,y,z] and object {x,y,z} formats
+            // Deep copy critical data
             if (child.userData.worldBoundingBox) {
               var wbb = child.userData.worldBoundingBox;
               clonedConnector.userData.worldBoundingBox = {
@@ -200,7 +223,6 @@ var ModelManager = /*#__PURE__*/function () {
               };
             }
             if (child.userData.direction) {
-              // Handle both array [x,y,z] and object {x,y,z} formats
               if (Array.isArray(child.userData.direction)) {
                 clonedConnector.userData.direction = _rollupPluginBabelHelpers.toConsumableArray(child.userData.direction);
               } else if (_rollupPluginBabelHelpers["typeof"](child.userData.direction) === 'object') {
@@ -212,11 +234,12 @@ var ModelManager = /*#__PURE__*/function () {
 
             // Set originalUuid to match the actual uuid (maintains consistency)
             clonedConnector.userData.originalUuid = connectorUuid;
-            clonedConnector.userData.objectType = child.userData.objectType || (child.name.toLowerCase().includes('connector') ? 'connector' : 'gateway');
+            clonedConnector.userData.objectType = child.userData.objectType || 'connector';
           }
           connectorChildren.push(clonedConnector);
         }
       });
+      console.log("\uD83D\uDEE1\uFE0F Preserved ".concat(connectorChildren.length, " connector(s) for component ").concat(parentUuid));
       return connectorChildren;
     }
 

package/dist/cjs/src/managers/scene/sceneExportManager.js

@@ -103,6 +103,11 @@ var SceneExportManager = /*#__PURE__*/function () {
       // Helper function to convert Three.js object to minimal JSON format
       var convertObjectToJson = function convertObjectToJson(threeObject) {
         var _threeObject$name, _threeObject$userData, _threeObject$userData2, _threeObject$userData3, _threeObject$userData4, _threeObject$userData5, _threeObject$userData6, _threeObject$userData7, _threeObject$userData8, _threeObject$userData9, _threeObject$userData0, _threeObject$userData1, _threeObject$userData10;
+        // Ensure world matrices are updated for this subtree before exporting
+        if (threeObject.updateMatrixWorld) {
+          threeObject.updateMatrixWorld(true);
+        }
+
         // Skip certain objects that shouldn't be exported
         if (!threeObject || (_threeObject$name = threeObject.name) !== null && _threeObject$name !== void 0 && _threeObject$name.includes('Polyline') ||
         // Skip pipe paths
@@ -241,11 +246,10 @@ var SceneExportManager = /*#__PURE__*/function () {
           };
         }
 
-        // For components: only export child connectors if they were manually added/defined.
-        // Most connectors are injected from dictionary at import time, but some (like manually placed ones)
-        // need to be persisted to maintain connections in the exported scene.
+        // Only manual segments persist their connector children here.
+        // Component connectors are NOT exported — they are regenerated from the
+        // component dictionary on load (see note below), keeping the scene JSON minimal.
         if (threeObject.children && threeObject.children.length > 0) {
-          var _threeObject$userData11;
           var exportableChildren = [];
           if (isManualSegment) {
             // For manual segments, export their connector children
@@ -259,26 +263,15 @@ var SceneExportManager = /*#__PURE__*/function () {
                 }
               }
             });
-          } else if (((_threeObject$userData11 = threeObject.userData) === null || _threeObject$userData11 === void 0 ? void 0 : _threeObject$userData11.objectType) === 'component') {
-            // For components, only export connectors that have objectType='connector'
-            // Standard dictionary-injected connectors should be exported so connections work on re-import
-            threeObject.children.forEach(function (child) {
-              var _child$userData2;
-              if (((_child$userData2 = child.userData) === null || _child$userData2 === void 0 ? void 0 : _child$userData2.objectType) === 'connector') {
-                exportableChildren.push({
-                  uuid: child.uuid,
-                  name: child.name,
-                  type: 'Mesh',
-                  position: {
-                    x: roundIfClose(child.position.x),
-                    y: roundIfClose(child.position.y),
-                    z: roundIfClose(child.position.z)
-                  },
-                  userData: _rollupPluginBabelHelpers.objectSpread2({}, child.userData)
-                });
-              }
-            });
           }
+          // NOTE: Component connectors are intentionally NOT exported.
+          // They are defined in the component dictionary and regenerated on load by
+          // sceneOperationsManager._injectConnectorChildrenFromDictionary using the
+          // matching uuid scheme (`${componentUuid}_${dictConnectorUuid}`), and the
+          // pathfinder rebuilds their world positions/bounding boxes on every run
+          // (computeConnectorBoundingBoxes). Connections still resolve because the
+          // regenerated connector uuids match the connection endpoints.
+
           if (exportableChildren.length > 0) {
             jsonObject.children = exportableChildren;
           }
@@ -292,9 +285,9 @@ var SceneExportManager = /*#__PURE__*/function () {
       // Extract main scene objects (components and standalone connectors)
       var sceneChildren = [];
       this.sceneViewer.scene.children.forEach(function (child) {
-        var _child$userData3;
+        var _child$userData2;
         // Only export components and connectors; skip segments, gateways, polylines, etc.
-        var objectType = (_child$userData3 = child.userData) === null || _child$userData3 === void 0 ? void 0 : _child$userData3.objectType;
+        var objectType = (_child$userData2 = child.userData) === null || _child$userData2 === void 0 ? void 0 : _child$userData2.objectType;
         if (objectType !== 'component' && objectType !== 'connector') {
           return;
         }
@@ -458,14 +451,14 @@ var SceneExportManager = /*#__PURE__*/function () {
               BufferGeometryUtils = BufferGeometryUtilsModule.BufferGeometryUtils || BufferGeometryUtilsModule.default || BufferGeometryUtilsModule; // Create a new scene for export instead of cloning
               exportScene = new _THREE.Scene(); // Helper function to check if an object should be exported
               shouldExport = function shouldExport(child) {
-                var _child$name, _child$userData4, _child$userData5, _child$userData6, _child$userData7;
+                var _child$name, _child$userData3, _child$userData4, _child$userData5, _child$userData6;
                 if ((_child$name = child.name) !== null && _child$name !== void 0 && _child$name.includes('Polyline')) return false; // Will handle separately
                 if (child.name === 'fogPlane') return false; // Skip fog plane
-                if ((_child$userData4 = child.userData) !== null && _child$userData4 !== void 0 && _child$userData4.isBrickWall) return false; // Skip environment
-                if ((_child$userData5 = child.userData) !== null && _child$userData5 !== void 0 && _child$userData5.isBaseGround) return false; // Skip environment
-                if ((_child$userData6 = child.userData) !== null && _child$userData6 !== void 0 && _child$userData6.isBaseGrid) return false; // Skip environment
+                if ((_child$userData3 = child.userData) !== null && _child$userData3 !== void 0 && _child$userData3.isBrickWall) return false; // Skip environment
+                if ((_child$userData4 = child.userData) !== null && _child$userData4 !== void 0 && _child$userData4.isBaseGround) return false; // Skip environment
+                if ((_child$userData5 = child.userData) !== null && _child$userData5 !== void 0 && _child$userData5.isBaseGrid) return false; // Skip environment
                 if (child.isLight) return false; // Skip lights
-                if ((_child$userData7 = child.userData) !== null && _child$userData7 !== void 0 && _child$userData7.isTransformControls) return false; // Skip transform controls
+                if ((_child$userData6 = child.userData) !== null && _child$userData6 !== void 0 && _child$userData6.isTransformControls) return false; // Skip transform controls
                 if (child.isTransformControls) return false; // Skip transform controls
                 if (child.type && child.type.includes('TransformControls')) return false;
                 if (child.type && child.type.includes('Helper')) return false; // Skip helpers

package/dist/cjs/src/managers/scene/sceneOperationsManager.js

@@ -890,6 +890,19 @@ var SceneOperationsManager = /*#__PURE__*/function () {
       if (!(data !== null && data !== void 0 && (_data$scene2 = data.scene) !== null && _data$scene2 !== void 0 && _data$scene2.children) || !componentDictionary) {
         return;
       }
+
+      // Collect every connector uuid referenced by the scene's connections so we
+      // can inject connectors under the SAME uuid scheme the scene actually uses.
+      // Two schemes exist in the wild:
+      //   - Preferred (runtime add path + minimal export): `${componentUuid}_${dictConnectorUuid}`
+      //   - Legacy (older hand-authored scenes):           `${componentUuid}-CONNECTOR-${index+1}`
+      var connectionEndpoints = new Set();
+      if (Array.isArray(data.connections)) {
+        data.connections.forEach(function (conn) {
+          if (conn !== null && conn !== void 0 && conn.from) connectionEndpoints.add(conn.from);
+          if (conn !== null && conn !== void 0 && conn.to) connectionEndpoints.add(conn.to);
+        });
+      }
       var componentsProcessed = 0;
       var connectorsInjected = 0;
       data.scene.children.forEach(function (child) {
@@ -912,9 +925,18 @@ var SceneOperationsManager = /*#__PURE__*/function () {
 
               // Deep clone the connector children from the dictionary
               child.children = dictEntry.children.map(function (connector, index) {
-                // Generate unique UUID for this connector instance
-                // Format: COMPONENT-UUID-CONNECTOR-INDEX
-                var connectorUuid = "".concat(child.uuid, "-CONNECTOR-").concat(index + 1);
+                // Choose the connector uuid that matches the scheme the scene's
+                // connections reference. Prefer `${componentUuid}_${dictConnectorUuid}`
+                // (sandbox add path + minimal export); fall back to the legacy
+                // index-based scheme `${componentUuid}-CONNECTOR-${index+1}` when the
+                // connections reference that form. If neither is referenced (e.g. an
+                // unconnected connector), default to the preferred scheme.
+                var legacyUuid = "".concat(child.uuid, "-CONNECTOR-").concat(index + 1);
+                var preferredUuid = connector.uuid ? "".concat(child.uuid, "_").concat(connector.uuid) : legacyUuid;
+                var connectorUuid = preferredUuid;
+                if (!connectionEndpoints.has(preferredUuid) && connectionEndpoints.has(legacyUuid)) {
+                  connectorUuid = legacyUuid;
+                }
 
                 // Clone connector with deep copy of userData
                 var clonedConnector = _rollupPluginBabelHelpers.objectSpread2(_rollupPluginBabelHelpers.objectSpread2({}, connector), {}, {
@@ -1348,24 +1370,29 @@ var SceneOperationsManager = /*#__PURE__*/function () {
           children: [] // Initialize children array
         };
 
-        // Collect children that are connectors
-        if (componentModel.children) {
-          componentModel.children.forEach(function (child) {
-            if (child.userData && child.userData.objectType === 'connector') {
-              componentSceneData.children.push({
-                uuid: child.uuid,
-                name: child.name,
-                type: 'Mesh',
-                position: {
-                  x: child.position.x,
-                  y: child.position.y,
-                  z: child.position.z
-                },
-                userData: _rollupPluginBabelHelpers.objectSpread2({}, child.userData)
-              });
-            }
-          });
-        }
+        // Collect children that are connectors (using traverse to find deep children in models)
+        componentModel.traverse(function (child) {
+          if (child.userData && child.userData.objectType === 'connector') {
+            // Calculate position relative to component root
+            // This ensures that when we re-add it as a direct child of the component,
+            // it maintains the same world position relative to the component.
+            var componentMatrixWorldInverse = componentModel.matrixWorld.clone().invert();
+            var childWorldPos = new THREE__namespace.Vector3();
+            child.getWorldPosition(childWorldPos);
+            var relativePos = childWorldPos.applyMatrix4(componentMatrixWorldInverse);
+            componentSceneData.children.push({
+              uuid: child.uuid,
+              name: child.name,
+              type: 'Mesh',
+              position: {
+                x: relativePos.x,
+                y: relativePos.y,
+                z: relativePos.z
+              },
+              userData: _rollupPluginBabelHelpers.objectSpread2({}, child.userData)
+            });
+          }
+        });
 
         // Add the component to the scene data
         if (!currentSceneData.scene.children) {

package/dist/cjs/src/utils/boundingBoxUtils.js

@@ -179,41 +179,36 @@ function computeFilteredBoundingBox(object) {
  */
 function computeIODeviceBoundingBoxes(componentObject) {
   var results = [];
-  var _iterator = _rollupPluginBabelHelpers.createForOfIteratorHelper(componentObject.children),
-    _step;
-  try {
-    for (_iterator.s(); !(_step = _iterator.n()).done;) {
-      var _child$userData;
-      var child = _step.value;
-      if (((_child$userData = child.userData) === null || _child$userData === void 0 ? void 0 : _child$userData.objectType) !== 'io-device') continue;
-      var bbox = new THREE__namespace.Box3().setFromObject(child);
-      if (!bbox.isEmpty()) {
-        results.push({
-          uuid: child.uuid,
-          userData: {
-            objectType: 'io-device',
-            deviceId: child.userData.deviceId || null,
-            attachmentId: child.userData.attachmentId || null,
-            parentComponentId: child.userData.parentComponentId || componentObject.uuid
-          },
-          worldBoundingBox: {
-            min: [bbox.min.x, bbox.min.y, bbox.min.z],
-            max: [bbox.max.x, bbox.max.y, bbox.max.z]
-          }
-        });
-      }
+  componentObject.traverse(function (child) {
+    var _child$userData;
+    if (((_child$userData = child.userData) === null || _child$userData === void 0 ? void 0 : _child$userData.objectType) !== 'io-device') return;
+    var bbox = new THREE__namespace.Box3().setFromObject(child);
+    var worldPos = new THREE__namespace.Vector3();
+    child.getWorldPosition(worldPos);
+    if (!bbox.isEmpty()) {
+      results.push({
+        uuid: child.uuid,
+        userData: {
+          objectType: 'io-device',
+          deviceId: child.userData.deviceId || null,
+          attachmentId: child.userData.attachmentId || null,
+          parentComponentId: child.userData.parentComponentId || componentObject.uuid,
+          // Sync position for pathfinder
+          position: [worldPos.x, worldPos.y, worldPos.z]
+        },
+        worldBoundingBox: {
+          min: [bbox.min.x, bbox.min.y, bbox.min.z],
+          max: [bbox.max.x, bbox.max.y, bbox.max.z]
+        }
+      });
     }
-  } catch (err) {
-    _iterator.e(err);
-  } finally {
-    _iterator.f();
-  }
+  });
   return results;
 }
 
 /**
  * Computes individual world-space bounding boxes for each connector child
- * of a component.
+ * of a component. Supports deep children (e.g. within GLB model hierarchy).
  * 
  * @param {THREE.Object3D} componentObject - The component's Three.js object
  * @returns {Array<{uuid: string, userData: Object, worldBoundingBox: {min: number[], max: number[]}}>}
@@ -221,38 +216,40 @@ function computeIODeviceBoundingBoxes(componentObject) {
  */
 function computeConnectorBoundingBoxes(componentObject) {
   var results = [];
-  var _iterator2 = _rollupPluginBabelHelpers.createForOfIteratorHelper(componentObject.children),
-    _step2;
-  try {
-    for (_iterator2.s(); !(_step2 = _iterator2.n()).done;) {
-      var _child$userData2;
-      var child = _step2.value;
-      if (((_child$userData2 = child.userData) === null || _child$userData2 === void 0 ? void 0 : _child$userData2.objectType) !== 'connector') continue;
-      var bbox = new THREE__namespace.Box3().setFromObject(child);
+  componentObject.traverse(function (child) {
+    var _child$userData2;
+    if (((_child$userData2 = child.userData) === null || _child$userData2 === void 0 ? void 0 : _child$userData2.objectType) !== 'connector') return;
+    var bbox = new THREE__namespace.Box3().setFromObject(child);
+    var worldPos = new THREE__namespace.Vector3();
+    child.getWorldPosition(worldPos);
 
-      // Fallback if mesh is too small or empty (sometimes connectors are just points)
-      if (bbox.isEmpty() || bbox.getSize(new THREE__namespace.Vector3()).length() < 0.01) {
-        var worldPos = new THREE__namespace.Vector3();
-        child.getWorldPosition(worldPos);
-        var size = 0.1;
-        bbox.setFromCenterAndSize(worldPos, new THREE__namespace.Vector3(size, size, size));
-      }
-      results.push({
-        uuid: child.uuid,
-        userData: _rollupPluginBabelHelpers.objectSpread2(_rollupPluginBabelHelpers.objectSpread2({}, child.userData), {}, {
-          objectType: 'connector'
-        }),
-        worldBoundingBox: {
-          min: [bbox.min.x, bbox.min.y, bbox.min.z],
-          max: [bbox.max.x, bbox.max.y, bbox.max.z]
-        }
-      });
+    // Compute world-space direction vector (Crucial for rotation-aware pathfinding)
+    // Default to [0, 0, 1] if not specified (Standard for our coordinate system)
+    var localDirData = child.userData && Array.isArray(child.userData.direction) ? child.userData.direction : [0, 0, 1];
+    var localDir = new THREE__namespace.Vector3(localDirData[0], localDirData[1], localDirData[2]);
+    var worldQuat = new THREE__namespace.Quaternion();
+    child.getWorldQuaternion(worldQuat);
+    var worldDir = localDir.clone().applyQuaternion(worldQuat).normalize();
+
+    // Fallback if mesh is too small or empty (sometimes connectors are just points)
+    if (bbox.isEmpty() || bbox.getSize(new THREE__namespace.Vector3()).length() < 0.01) {
+      var size = 0.1;
+      bbox.setFromCenterAndSize(worldPos, new THREE__namespace.Vector3(size, size, size));
     }
-  } catch (err) {
-    _iterator2.e(err);
-  } finally {
-    _iterator2.f();
-  }
+    results.push({
+      uuid: child.uuid,
+      userData: _rollupPluginBabelHelpers.objectSpread2(_rollupPluginBabelHelpers.objectSpread2({}, child.userData), {}, {
+        objectType: 'connector',
+        // Update both position AND direction for pathfinder
+        position: [worldPos.x, worldPos.y, worldPos.z],
+        direction: [worldDir.x, worldDir.y, worldDir.z]
+      }),
+      worldBoundingBox: {
+        min: [bbox.min.x, bbox.min.y, bbox.min.z],
+        max: [bbox.max.x, bbox.max.y, bbox.max.z]
+      }
+    });
+  });
   return results;
 }
 
@@ -352,11 +349,11 @@ function createSelectionBoxHelpers(object) {
  * @param {THREE.Scene} scene - The scene (for finding objects by uuid)
  */
 function updateSelectionBoxHelpers(helpers, selectedObjects, scene) {
-  var _iterator3 = _rollupPluginBabelHelpers.createForOfIteratorHelper(helpers),
-    _step3;
+  var _iterator = _rollupPluginBabelHelpers.createForOfIteratorHelper(helpers),
+    _step;
   try {
     var _loop = function _loop() {
-      var helper = _step3.value;
+      var helper = _step.value;
       var _helper$userData = helper.userData,
         sourceObjectUuid = _helper$userData.sourceObjectUuid,
         isFiltered = _helper$userData.isFiltered,
@@ -387,13 +384,13 @@ function updateSelectionBoxHelpers(helpers, selectedObjects, scene) {
         helper.update();
       }
     };
-    for (_iterator3.s(); !(_step3 = _iterator3.n()).done;) {
+    for (_iterator.s(); !(_step = _iterator.n()).done;) {
       if (_loop()) continue;
     }
   } catch (err) {
-    _iterator3.e(err);
+    _iterator.e(err);
   } finally {
-    _iterator3.f();
+    _iterator.f();
   }
 }
 

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

@@ -33,7 +33,7 @@ var CentralPlant = /*#__PURE__*/function (_BaseDisposable) {
    * Initialize the CentralPlant manager
    * 
    * @constructor
-   * @version 0.3.47
+   * @version 0.3.49
    * @updated 2025-10-22
    * 
    * @description Creates a new CentralPlant instance and initializes internal managers and utilities.
@@ -363,7 +363,8 @@ var CentralPlant = /*#__PURE__*/function (_BaseDisposable) {
   }, {
     key: "translate",
     value: function translate(componentId, axis, value) {
-      return this.internals.translateComponent(componentId, axis, value);
+      var skipPathUpdate = arguments.length > 3 && arguments[3] !== undefined ? arguments[3] : false;
+      return this.internals.translateComponent(componentId, axis, value, skipPathUpdate);
     }
 
     /**
@@ -1061,18 +1062,19 @@ var CentralPlant = /*#__PURE__*/function (_BaseDisposable) {
         return [];
       }
 
-      // Traverse through all components in the scene data
-      sceneData.scene.children.forEach(function (component) {
-        // Each component may have connector children
-        if (component.children && Array.isArray(component.children)) {
-          component.children.forEach(function (child) {
-            // Check if this child is a connector
-            if (child.userData && child.userData.objectType === 'connector' && child.uuid) {
-              allConnectorIds.push(child.uuid);
-            }
-          });
-        }
-      });
+      // Recursive search for connector IDs
+      var _findConnectorIds = function findConnectorIds(nodes) {
+        if (!nodes || !Array.isArray(nodes)) return;
+        nodes.forEach(function (node) {
+          if (node.userData && node.userData.objectType === 'connector' && node.uuid) {
+            allConnectorIds.push(node.uuid);
+          }
+          if (node.children && Array.isArray(node.children)) {
+            _findConnectorIds(node.children);
+          }
+        });
+      };
+      _findConnectorIds(sceneData.scene.children);
 
       // Get existing connections
       var existingConnections = this.getConnections();
@@ -1102,28 +1104,28 @@ var CentralPlant = /*#__PURE__*/function (_BaseDisposable) {
      * const infos = centralPlant.getAvailableConnectionsInfo()
      * // [{ id: 'PUMP-1-CONNECTOR-1', flow: 'out' }, ...]
      */
+    /**
+     * Get all connectors in the scene that are currently available (not used in a connection).
+     * Searches the active Three.js scene directly for the most accurate results.
+     * @returns {Array<{id: string, flow: string}>} Array of connector info objects
+     * @since 0.1.72 (Updated to search Three.js scene directly)
+     */
   }, {
     key: "getAvailableConnectionsInfo",
     value: function getAvailableConnectionsInfo() {
-      if (!this.sceneViewer || !this.sceneViewer.currentSceneData) {
-        console.warn('⚠️ getAvailableConnectionsInfo(): Scene viewer or current scene data not available');
-        return [];
-      }
-      var sceneData = this.sceneViewer.currentSceneData;
-      if (!sceneData.scene || !sceneData.scene.children) {
-        console.warn('⚠️ getAvailableConnectionsInfo(): Invalid scene data structure');
+      if (!this.sceneViewer || !this.sceneViewer.scene) {
+        console.warn('⚠️ getAvailableConnectionsInfo(): Scene viewer or scene not available');
         return [];
       }
       var allConnectorInfos = [];
-      sceneData.scene.children.forEach(function (component) {
-        if (component.children && Array.isArray(component.children)) {
-          component.children.forEach(function (child) {
-            if (child.userData && child.userData.objectType === 'connector' && child.uuid) {
-              allConnectorInfos.push({
-                id: child.uuid,
-                flow: child.userData.flow || 'bi'
-              });
-            }
+
+      // Search the Three.js scene directly for connectors
+      // This is more reliable than searching currentSceneData which might be stale
+      this.sceneViewer.scene.traverse(function (node) {
+        if (node.userData && node.userData.objectType === 'connector' && node.uuid) {
+          allConnectorInfos.push({
+            id: node.uuid,
+            flow: node.userData.flow || 'bi'
           });
         }
       });
@@ -1145,30 +1147,29 @@ var CentralPlant = /*#__PURE__*/function (_BaseDisposable) {
      * const result = centralPlant.validateConnections()
      * result.invalid.forEach(({ connection, reason }) => console.warn(reason, connection))
      */
+    /**
+     * Validate all connections in the current scene for flow direction compatibility.
+     * Searches the active Three.js scene for connector flow markers.
+     * @returns {{ valid: Array<Object>, invalid: Array<{connection: Object, reason: string}> }}
+     * @since 0.1.72 (Updated to search Three.js scene directly)
+     */
   }, {
     key: "validateConnections",
     value: function validateConnections() {
-      if (!this.sceneViewer || !this.sceneViewer.currentSceneData) {
-        console.warn('⚠️ validateConnections(): Scene viewer or current scene data not available');
+      if (!this.sceneViewer || !this.sceneViewer.scene) {
+        console.warn('⚠️ validateConnections(): Scene viewer or scene not available');
         return {
           valid: [],
           invalid: []
         };
       }
       var connections = this.getConnections();
-      var sceneData = this.sceneViewer.currentSceneData;
 
-      // Build lookup map: connectorId → flow
+      // Build lookup map: connectorId → flow from the Three.js scene
       var flowMap = {};
-      var scene = sceneData.scene || {};
-      var children = scene.children || [];
-      children.forEach(function (component) {
-        if (component.children && Array.isArray(component.children)) {
-          component.children.forEach(function (child) {
-            if (child.userData && child.userData.objectType === 'connector' && child.uuid) {
-              flowMap[child.uuid] = child.userData.flow || 'bi';
-            }
-          });
+      this.sceneViewer.scene.traverse(function (node) {
+        if (node.userData && node.userData.objectType === 'connector' && node.uuid) {
+          flowMap[node.uuid] = node.userData.flow || 'bi';
         }
       });
       var valid = [];

package/dist/esm/src/core/centralPlantInternals.js

@@ -450,17 +450,19 @@ var CentralPlantInternals = /*#__PURE__*/function () {
      * @param {string} componentId - The UUID of the component to translate
      * @param {string} axis - The axis to translate on ('x', 'y', or 'z')
      * @param {number} value - The value to translate by
+     * @param {boolean} [skipPathUpdate=false] - Whether to skip triggering pathfinding
      * @returns {boolean} True if translation was successful, false otherwise
      */
   }, {
     key: "translateComponent",
     value: function translateComponent(componentId, axis, value) {
       var _this$centralPlant$ma;
+      var skipPathUpdate = arguments.length > 3 && arguments[3] !== undefined ? arguments[3] : false;
       if (!((_this$centralPlant$ma = this.centralPlant.managers) !== null && _this$centralPlant$ma !== void 0 && _this$centralPlant$ma.transformOperationsManager)) {
         console.error('❌ translateComponent(): TransformOperationsManager not available');
         return false;
       }
-      return this.centralPlant.managers.transformOperationsManager.translateComponent(componentId, axis, value);
+      return this.centralPlant.managers.transformOperationsManager.translateComponent(componentId, axis, value, skipPathUpdate);
     }
 
     /**
@@ -552,7 +554,7 @@ var CentralPlantInternals = /*#__PURE__*/function () {
             } else if (objectType === 'gateway') {
               success = this.translateGateway(objectId, axis, value);
             } else if (objectType === 'component') {
-              success = this.translateComponent(objectId, axis, value);
+              success = this.translateComponent(objectId, axis, value, skipPathUpdate);
             } else {
               result.errors.push("Unknown object type: ".concat(objectType, " (").concat(objectId, ")"));
               console.warn("\u26A0\uFE0F Unknown object type: ".concat(objectType, " for ").concat(objectId));

package/dist/esm/src/core/sceneViewer.js

@@ -98,7 +98,7 @@ var sceneViewer = /*#__PURE__*/function (_BaseDisposable) {
               this.centralPlant.attachToComponent();
 
               // Sync our managers tracking object after attachment
-              managerKeys = ['threeJSResourceManager', 'performanceMonitorManager', 'settingsManager', 'sceneExportManager', 'componentManager', 'sceneInitializationManager', 'environmentManager', 'keyboardControlsManager', 'pathfindingManager', 'pathFlowManager', 'ioBehaviorManager', 'ioOutlineManager', 'sceneOperationsManager', 'animationManager', 'cameraControlsManager', 'componentDragManager', 'tooltipsManager', 'componentTooltipManager']; // Populate our managers tracking object
+              managerKeys = ['threeJSResourceManager', 'performanceMonitorManager', 'settingsManager', 'sceneExportManager', 'componentManager', 'transformOperationsManager', 'sceneInitializationManager', 'environmentManager', 'keyboardControlsManager', 'pathfindingManager', 'pathFlowManager', 'ioBehaviorManager', 'ioOutlineManager', 'sceneOperationsManager', 'animationManager', 'cameraControlsManager', 'componentDragManager', 'tooltipsManager', 'componentTooltipManager']; // Populate our managers tracking object
               managerKeys.forEach(function (key) {
                 if (_this2[key]) {
                   _this2.managers[key] = _this2[key];