@2112-lab/central-plant 0.1.93 → 0.1.95

package/dist/bundle/index.js

@@ -3957,6 +3957,17 @@ var TransformControlsManager = /*#__PURE__*/function () {
             obj.userData._multiSelectOriginalRotation = obj.rotation.clone();
             obj.userData._multiSelectOriginalScale = obj.scale.clone();
           });
+
+          // Snapshot group position and helper geometry vertices so we can do
+          // cheap per-frame bbox translation without re-traversing the mesh hierarchy.
+          _this2._dragStartGroupPosition = _this2.multiSelectionGroup.position.clone();
+          _this2.boundingBoxHelpers.forEach(function (helper) {
+            var _helper$geometry;
+            var posAttr = (_helper$geometry = helper.geometry) === null || _helper$geometry === void 0 || (_helper$geometry = _helper$geometry.attributes) === null || _helper$geometry === void 0 ? void 0 : _helper$geometry.position;
+            if (posAttr) {
+              helper.userData._dragStartPositions = new Float32Array(posAttr.array);
+            }
+          });
         }
 
         // Disable orbit controls during transformation
@@ -4021,6 +4032,13 @@ var TransformControlsManager = /*#__PURE__*/function () {
                 }
               }
             case 3:
+              // Ensure the bounding box reflects the final post-drag object position.
+              // applyMultiSelectionTransform calls _finalizeMultiSelectionTransform →
+              // createMultiBoundingBox for moves above the threshold.  Call updateBoundingBox
+              // here as a safety net for sub-threshold moves or rotation mode, where
+              // _finalizeMultiSelectionTransform is not triggered.
+              _this2.updateBoundingBox();
+
               // Dispatch custom scene update event after transform completes
               if (typeof window !== 'undefined') {
                 console.log('📡 Dispatching sceneUpdateComplete event after transform');
@@ -4034,6 +4052,12 @@ var TransformControlsManager = /*#__PURE__*/function () {
                 });
                 window.dispatchEvent(sceneCompleteEvent);
               }
+
+              // Clean up per-drag snapshots
+              _this2._dragStartGroupPosition = null;
+              _this2.boundingBoxHelpers.forEach(function (helper) {
+                delete helper.userData._dragStartPositions;
+              });
               console.log("\u2705 Transform completed: ".concat(_this2.currentMode, " mode"));
             case 4:
               return _context.a(2);
@@ -4042,33 +4066,16 @@ var TransformControlsManager = /*#__PURE__*/function () {
       }));
       // Transform changing event
       this.eventHandlers.transforming = function () {
-        // Apply real-time visual transformation to objects during drag
+        // Apply real-time visual transformation to objects during drag.
         if (_this2.selectedObjects.length > 0 && _this2.multiSelectionGroup) {
           _this2.applyRealtimeTransform();
         }
 
-        // Clear the bounding box cache for all selected objects during transformation
-        _this2.selectedObjects.forEach(function (obj) {
-          if (_this2.boundingBoxCache.has(obj)) {
-            _this2.boundingBoxCache.delete(obj);
-          }
-        });
-
-        // Update bounding box during transformation
-        _this2.updateBoundingBox();
-
-        // Dispatch custom scene update event during transform (optional - fires continuously)
-        if (typeof window !== 'undefined') {
-          var _this2$selectedObject2;
-          var sceneCompleteEvent = new CustomEvent('sceneUpdateComplete', {
-            detail: {
-              timestamp: Date.now(),
-              transformType: _this2.currentMode,
-              objectName: ((_this2$selectedObject2 = _this2.selectedObjects[0]) === null || _this2$selectedObject2 === void 0 ? void 0 : _this2$selectedObject2.name) || 'unknown',
-              isTransforming: true
-            }
-          });
-          window.dispatchEvent(sceneCompleteEvent);
+        // Per-frame bbox tracking: during translate we can cheaply shift the
+        // pre-snapshotted helper geometry vertices by the drag delta instead of
+        // re-traversing the full mesh hierarchy every pointermove.
+        if (_this2.currentMode === 'translate') {
+          _this2._applyDeltaToBoundingBoxHelpers();
         }
       };
       // First remove any existing listeners to prevent duplicates
@@ -4821,6 +4828,43 @@ var TransformControlsManager = /*#__PURE__*/function () {
       }
     }
 
+    /**
+     * Cheap per-frame bounding box update during translation drag.
+     * Shifts the 8 pre-snapshotted geometry vertices of every helper by the
+     * current drag delta. O(8 additions per helper) — no mesh traversal.
+     * Only valid for translate mode where the box shape is invariant.
+     * @private
+     */
+  }, {
+    key: "_applyDeltaToBoundingBoxHelpers",
+    value: function _applyDeltaToBoundingBoxHelpers() {
+      if (!this._dragStartGroupPosition || this.boundingBoxHelpers.length === 0) return;
+      var delta = this.multiSelectionGroup.position.clone().sub(this._dragStartGroupPosition);
+      var _iterator3 = _createForOfIteratorHelper(this.boundingBoxHelpers),
+        _step3;
+      try {
+        for (_iterator3.s(); !(_step3 = _iterator3.n()).done;) {
+          var _helper$geometry2;
+          var helper = _step3.value;
+          var startPositions = helper.userData._dragStartPositions;
+          var posAttr = (_helper$geometry2 = helper.geometry) === null || _helper$geometry2 === void 0 || (_helper$geometry2 = _helper$geometry2.attributes) === null || _helper$geometry2 === void 0 ? void 0 : _helper$geometry2.position;
+          if (!startPositions || !posAttr) continue;
+          var arr = posAttr.array;
+          // 8 vertices × 3 floats (x, y, z)
+          for (var i = 0; i < 24; i += 3) {
+            arr[i] = startPositions[i] + delta.x;
+            arr[i + 1] = startPositions[i + 1] + delta.y;
+            arr[i + 2] = startPositions[i + 2] + delta.z;
+          }
+          posAttr.needsUpdate = true;
+        }
+      } catch (err) {
+        _iterator3.e(err);
+      } finally {
+        _iterator3.f();
+      }
+    }
+
     /**
      * Set the transformation mode
      * @param {'translate' | 'rotate' | 'scale'} mode - The transformation mode
@@ -5195,11 +5239,11 @@ var TransformControlsManager = /*#__PURE__*/function () {
       var objectFilter = arguments.length > 1 && arguments[1] !== undefined ? arguments[1] : null;
       var objectsWithBounds = this.getSelectableObjectsWithBounds(objectFilter);
       var intersections = [];
-      var _iterator3 = _createForOfIteratorHelper(objectsWithBounds),
-        _step3;
+      var _iterator4 = _createForOfIteratorHelper(objectsWithBounds),
+        _step4;
       try {
-        for (_iterator3.s(); !(_step3 = _iterator3.n()).done;) {
-          var item = _step3.value;
+        for (_iterator4.s(); !(_step4 = _iterator4.n()).done;) {
+          var item = _step4.value;
           var object = item.object,
             boundingBox = item.boundingBox;
 
@@ -5219,9 +5263,9 @@ var TransformControlsManager = /*#__PURE__*/function () {
 
         // Sort by distance (closest first)
       } catch (err) {
-        _iterator3.e(err);
+        _iterator4.e(err);
       } finally {
-        _iterator3.f();
+        _iterator4.f();
       }
       intersections.sort(function (a, b) {
         return a.distance - b.distance;
@@ -11457,11 +11501,35 @@ var SceneExportManager = /*#__PURE__*/function () {
         // For connectors/gateways: no children (they're leaf nodes)
         if (threeObject.children && threeObject.children.length > 0) {
           var exportableChildren = [];
-          if (threeObject.userData.objectType === 'component') ; else if (isManualSegment) {
-            // For manual segments, export their connector children
+          if (threeObject.userData.objectType === 'component') {
+            // Export connector children (skip mesh geometry - it lives in the component dictionary GLB)
             threeObject.children.forEach(function (child) {
               var _child$userData;
-              if (((_child$userData = child.userData) === null || _child$userData === void 0 ? void 0 : _child$userData.objectType) === 'segment-connector') {
+              if (((_child$userData = child.userData) === null || _child$userData === void 0 ? void 0 : _child$userData.objectType) === 'connector') {
+                var connectorJson = {
+                  // Use the raw Three.js UUID — connections in currentSceneData reference this exact value
+                  uuid: child.uuid,
+                  userData: _objectSpread2(_objectSpread2({
+                    objectType: 'connector'
+                  }, child.userData.direction ? {
+                    direction: child.userData.direction
+                  } : {}), child.userData.group ? {
+                    group: child.userData.group
+                  } : {}),
+                  position: {
+                    x: roundIfClose(child.position.x),
+                    y: roundIfClose(child.position.y),
+                    z: roundIfClose(child.position.z)
+                  }
+                };
+                exportableChildren.push(connectorJson);
+              }
+            });
+          } else if (isManualSegment) {
+            // For manual segments, export their connector children
+            threeObject.children.forEach(function (child) {
+              var _child$userData2;
+              if (((_child$userData2 = child.userData) === null || _child$userData2 === void 0 ? void 0 : _child$userData2.objectType) === 'segment-connector') {
                 // Call the class method using bound reference
                 var connectorJson = convertSegmentConnectorToJson(child, threeObject);
                 if (connectorJson) {
@@ -11487,9 +11555,9 @@ var SceneExportManager = /*#__PURE__*/function () {
       var findManualSegments = function findManualSegments(object) {
         var manualSegments = [];
         object.traverse(function (child) {
-          var _child$userData2;
+          var _child$userData3;
           // Check if this is a manual segment
-          if (((_child$userData2 = child.userData) === null || _child$userData2 === void 0 ? void 0 : _child$userData2.objectType) === 'segment') {
+          if (((_child$userData3 = child.userData) === null || _child$userData3 === void 0 ? void 0 : _child$userData3.objectType) === 'segment') {
             manualSegments.push(child);
           }
         });
@@ -11689,14 +11757,14 @@ var SceneExportManager = /*#__PURE__*/function () {
               BufferGeometryUtils$1 = 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$name2, _child$userData3, _child$userData4, _child$userData5, _child$userData6;
+                var _child$name2, _child$userData4, _child$userData5, _child$userData6, _child$userData7;
                 if ((_child$name2 = child.name) !== null && _child$name2 !== void 0 && _child$name2.includes('Polyline')) return false; // Will handle separately
                 if (child.name === 'fogPlane') return false; // Skip fog plane
-                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$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.isLight) return false; // Skip lights
-                if ((_child$userData6 = child.userData) !== null && _child$userData6 !== void 0 && _child$userData6.isTransformControls) return false; // Skip transform controls
+                if ((_child$userData7 = child.userData) !== null && _child$userData7 !== void 0 && _child$userData7.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
@@ -28829,9 +28897,13 @@ var ModelManager = /*#__PURE__*/function () {
       var _this = this;
       var connectorChildren = [];
       targetMesh.children.forEach(function (child, index) {
+        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');
-        if (isConnectorGeometry && isConnectorByName) {
+        // 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) {
           // Ensure userData exists and has worldBoundingBox
           if (!child.userData) child.userData = {};
           if (!child.userData.worldBoundingBox) {
@@ -29115,8 +29187,8 @@ var ModelManager = /*#__PURE__*/function () {
               requiredModels = new Set();
               console.log("\uD83D\uDD0D Checking ".concat(data.scene.children.length, " scene objects for required models..."));
               data.scene.children.forEach(function (child) {
-                var _child$userData;
-                var libraryId = (_child$userData = child.userData) === null || _child$userData === void 0 ? void 0 : _child$userData.libraryId;
+                var _child$userData2;
+                var libraryId = (_child$userData2 = child.userData) === null || _child$userData2 === void 0 ? void 0 : _child$userData2.libraryId;
                 if (libraryId) {
                   if (componentDictionary[libraryId]) {
                     var modelKey = componentDictionary[libraryId].modelKey;
@@ -30171,6 +30243,24 @@ var SceneOperationsManager = /*#__PURE__*/function () {
           }
         }
       });
+
+      // Ensure CONNECTOR_GATEWAY_SPHERE exists even when all connectors are nested inside
+      // component children (e.g. SAMPLE_1.json inline connector definitions).  Without
+      // this geometry the connector meshes fall back to empty BufferGeometry, which then
+      // causes _preserveConnectorChildren to drop them during GLB model replacement.
+      if (!geometries['CONNECTOR_GATEWAY_SPHERE']) {
+        var hasNestedConnectors = data.scene.children.some(function (child) {
+          var _child$userData3;
+          return ((_child$userData3 = child.userData) === null || _child$userData3 === void 0 ? void 0 : _child$userData3.objectType) === 'component' && Array.isArray(child.children) && child.children.some(function (nestedChild) {
+            var _nestedChild$userData;
+            return ((_nestedChild$userData = nestedChild.userData) === null || _nestedChild$userData === void 0 ? void 0 : _nestedChild$userData.objectType) === 'connector';
+          });
+        });
+        if (hasNestedConnectors) {
+          geometries['CONNECTOR_GATEWAY_SPHERE'] = new THREE__namespace.SphereGeometry(0.1, 16, 16);
+          console.log('🔮 Created shared sphere geometry for nested inline connectors (radius: 0.1)');
+        }
+      }
       return geometries;
     }
 
@@ -30556,12 +30646,12 @@ var SceneOperationsManager = /*#__PURE__*/function () {
               _step;
             try {
               for (_iterator.s(); !(_step = _iterator.n()).done;) {
-                var _object$userData, _child$userData3;
+                var _object$userData, _child$userData4;
                 var child = _step.value;
                 // Enhanced matching logic with hardcoded UUID priority
 
                 // Strategy 1: Direct hardcoded UUID match (HIGHEST PRIORITY)
-                if (child.uuid === object.uuid || child.uuid === ((_object$userData = object.userData) === null || _object$userData === void 0 ? void 0 : _object$userData.originalUuid) || object.uuid === ((_child$userData3 = child.userData) === null || _child$userData3 === void 0 ? void 0 : _child$userData3.originalUuid)) {
+                if (child.uuid === object.uuid || child.uuid === ((_object$userData = object.userData) === null || _object$userData === void 0 ? void 0 : _object$userData.originalUuid) || object.uuid === ((_child$userData4 = child.userData) === null || _child$userData4 === void 0 ? void 0 : _child$userData4.originalUuid)) {
                   return child;
                 }
 
@@ -30706,6 +30796,9 @@ var SceneOperationsManager = /*#__PURE__*/function () {
               // Phase 6: Load behaviors (after GLB models are present so output objects can be resolved)
               this._processBehaviors(data);
               console.log('✅ Scene loaded successfully');
+
+              // Notify UI components (e.g. SceneHierarchy) that the scene is fully loaded
+              this.sceneViewer.emit('scene-loaded');
               _context4.n = 7;
               break;
             case 6:
@@ -30817,10 +30910,10 @@ var SceneOperationsManager = /*#__PURE__*/function () {
       var componentsProcessed = 0;
       var connectorsInjected = 0;
       data.scene.children.forEach(function (child) {
-        var _child$userData4, _child$userData5, _child$userData6;
-        var childType = ((_child$userData4 = child.userData) === null || _child$userData4 === void 0 ? void 0 : _child$userData4.objectType) || ((_child$userData5 = child.userData) === null || _child$userData5 === void 0 ? void 0 : _child$userData5.objectType);
+        var _child$userData5, _child$userData6, _child$userData7;
+        var childType = ((_child$userData5 = child.userData) === null || _child$userData5 === void 0 ? void 0 : _child$userData5.objectType) || ((_child$userData6 = child.userData) === null || _child$userData6 === void 0 ? void 0 : _child$userData6.objectType);
         // Only process components with libraryId
-        if (childType === 'component' && (_child$userData6 = child.userData) !== null && _child$userData6 !== void 0 && _child$userData6.libraryId) {
+        if (childType === 'component' && (_child$userData7 = child.userData) !== null && _child$userData7 !== void 0 && _child$userData7.libraryId) {
           var libraryId = child.userData.libraryId;
           var dictEntry = componentDictionary[libraryId];
 
@@ -30977,17 +31070,17 @@ var SceneOperationsManager = /*#__PURE__*/function () {
               geometries = this.createSceneGeometries(data, componentDictionary); // Create basic objects and track GLB replacements
               libraryObjectsToReplace = [];
               data.scene.children.forEach(function (child, index) {
-                var _child$userData7, _child$userData8;
+                var _child$userData8, _child$userData9;
                 var createdObject = _this4.createSceneObject(child, geometries, materials, componentDictionary);
                 _this4.sceneViewer.scene.add(createdObject);
 
                 // Track objects that need GLB model replacement
-                if ((_child$userData7 = child.userData) !== null && _child$userData7 !== void 0 && _child$userData7.libraryId && componentDictionary[(_child$userData8 = child.userData) === null || _child$userData8 === void 0 ? void 0 : _child$userData8.libraryId]) {
-                  var _child$userData9;
+                if ((_child$userData8 = child.userData) !== null && _child$userData8 !== void 0 && _child$userData8.libraryId && componentDictionary[(_child$userData9 = child.userData) === null || _child$userData9 === void 0 ? void 0 : _child$userData9.libraryId]) {
+                  var _child$userData0;
                   libraryObjectsToReplace.push({
                     basicObject: createdObject,
                     jsonData: child,
-                    componentData: componentDictionary[(_child$userData9 = child.userData) === null || _child$userData9 === void 0 ? void 0 : _child$userData9.libraryId]
+                    componentData: componentDictionary[(_child$userData0 = child.userData) === null || _child$userData0 === void 0 ? void 0 : _child$userData0.libraryId]
                   });
                 }
               });
@@ -31126,8 +31219,8 @@ var SceneOperationsManager = /*#__PURE__*/function () {
       var instanceBehaviors = [];
       if (Array.isArray(data === null || data === void 0 || (_data$scene3 = data.scene) === null || _data$scene3 === void 0 ? void 0 : _data$scene3.children)) {
         data.scene.children.forEach(function (child) {
-          var _child$userData0, _compData$defaultBeha;
-          var libraryId = (_child$userData0 = child.userData) === null || _child$userData0 === void 0 ? void 0 : _child$userData0.libraryId;
+          var _child$userData1, _compData$defaultBeha;
+          var libraryId = (_child$userData1 = child.userData) === null || _child$userData1 === void 0 ? void 0 : _child$userData1.libraryId;
           if (!libraryId) return;
           var instanceUuid = child.uuid;
           // Skip instances whose defaults were already resolved by Step A
@@ -31518,8 +31611,8 @@ var SceneOperationsManager = /*#__PURE__*/function () {
         // Process children (connectors, etc.) if they exist
         if (componentModel.children && componentModel.children.length > 0) {
           componentModel.children.forEach(function (child) {
-            var _child$userData1, _child$userData10;
-            var childType = ((_child$userData1 = child.userData) === null || _child$userData1 === void 0 ? void 0 : _child$userData1.objectType) || ((_child$userData10 = child.userData) === null || _child$userData10 === void 0 ? void 0 : _child$userData10.objectType);
+            var _child$userData10, _child$userData11;
+            var childType = ((_child$userData10 = child.userData) === null || _child$userData10 === void 0 ? void 0 : _child$userData10.objectType) || ((_child$userData11 = child.userData) === null || _child$userData11 === void 0 ? void 0 : _child$userData11.objectType);
             if (childType === 'connector') {
               var _child$geometry;
               var childBoundingBox = new THREE__namespace.Box3().setFromObject(child);
@@ -31604,8 +31697,8 @@ var SceneOperationsManager = /*#__PURE__*/function () {
       if (segment.children && segment.children.length > 0) {
         var childrenToRemove = _toConsumableArray(segment.children);
         childrenToRemove.forEach(function (child) {
-          var _child$userData11;
-          if ((_child$userData11 = child.userData) !== null && _child$userData11 !== void 0 && _child$userData11.isPipeElbow) {
+          var _child$userData12;
+          if ((_child$userData12 = child.userData) !== null && _child$userData12 !== void 0 && _child$userData12.isPipeElbow) {
             console.log("\uD83D\uDDD1\uFE0F Removing elbow child from segment before manualization: ".concat(child.uuid));
             segment.remove(child);
             if (child.geometry) child.geometry.dispose();
@@ -37110,7 +37203,7 @@ var CentralPlant = /*#__PURE__*/function (_BaseDisposable) {
    * Initialize the CentralPlant manager
    * 
    * @constructor
-   * @version 0.1.93
+   * @version 0.1.95
    * @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.93
+   * @version 0.1.95
    * @updated 2025-10-22
    * 
    * @description Creates a new CentralPlant instance and initializes internal managers and utilities.

package/dist/cjs/src/managers/controls/transformControlsManager.js

@@ -257,6 +257,17 @@ var TransformControlsManager = /*#__PURE__*/function () {
             obj.userData._multiSelectOriginalRotation = obj.rotation.clone();
             obj.userData._multiSelectOriginalScale = obj.scale.clone();
           });
+
+          // Snapshot group position and helper geometry vertices so we can do
+          // cheap per-frame bbox translation without re-traversing the mesh hierarchy.
+          _this2._dragStartGroupPosition = _this2.multiSelectionGroup.position.clone();
+          _this2.boundingBoxHelpers.forEach(function (helper) {
+            var _helper$geometry;
+            var posAttr = (_helper$geometry = helper.geometry) === null || _helper$geometry === void 0 || (_helper$geometry = _helper$geometry.attributes) === null || _helper$geometry === void 0 ? void 0 : _helper$geometry.position;
+            if (posAttr) {
+              helper.userData._dragStartPositions = new Float32Array(posAttr.array);
+            }
+          });
         }
 
         // Disable orbit controls during transformation
@@ -321,6 +332,13 @@ var TransformControlsManager = /*#__PURE__*/function () {
                 }
               }
             case 3:
+              // Ensure the bounding box reflects the final post-drag object position.
+              // applyMultiSelectionTransform calls _finalizeMultiSelectionTransform →
+              // createMultiBoundingBox for moves above the threshold.  Call updateBoundingBox
+              // here as a safety net for sub-threshold moves or rotation mode, where
+              // _finalizeMultiSelectionTransform is not triggered.
+              _this2.updateBoundingBox();
+
               // Dispatch custom scene update event after transform completes
               if (typeof window !== 'undefined') {
                 console.log('📡 Dispatching sceneUpdateComplete event after transform');
@@ -334,6 +352,12 @@ var TransformControlsManager = /*#__PURE__*/function () {
                 });
                 window.dispatchEvent(sceneCompleteEvent);
               }
+
+              // Clean up per-drag snapshots
+              _this2._dragStartGroupPosition = null;
+              _this2.boundingBoxHelpers.forEach(function (helper) {
+                delete helper.userData._dragStartPositions;
+              });
               console.log("\u2705 Transform completed: ".concat(_this2.currentMode, " mode"));
             case 4:
               return _context.a(2);
@@ -342,33 +366,16 @@ var TransformControlsManager = /*#__PURE__*/function () {
       }));
       // Transform changing event
       this.eventHandlers.transforming = function () {
-        // Apply real-time visual transformation to objects during drag
+        // Apply real-time visual transformation to objects during drag.
         if (_this2.selectedObjects.length > 0 && _this2.multiSelectionGroup) {
           _this2.applyRealtimeTransform();
         }
 
-        // Clear the bounding box cache for all selected objects during transformation
-        _this2.selectedObjects.forEach(function (obj) {
-          if (_this2.boundingBoxCache.has(obj)) {
-            _this2.boundingBoxCache.delete(obj);
-          }
-        });
-
-        // Update bounding box during transformation
-        _this2.updateBoundingBox();
-
-        // Dispatch custom scene update event during transform (optional - fires continuously)
-        if (typeof window !== 'undefined') {
-          var _this2$selectedObject2;
-          var sceneCompleteEvent = new CustomEvent('sceneUpdateComplete', {
-            detail: {
-              timestamp: Date.now(),
-              transformType: _this2.currentMode,
-              objectName: ((_this2$selectedObject2 = _this2.selectedObjects[0]) === null || _this2$selectedObject2 === void 0 ? void 0 : _this2$selectedObject2.name) || 'unknown',
-              isTransforming: true
-            }
-          });
-          window.dispatchEvent(sceneCompleteEvent);
+        // Per-frame bbox tracking: during translate we can cheaply shift the
+        // pre-snapshotted helper geometry vertices by the drag delta instead of
+        // re-traversing the full mesh hierarchy every pointermove.
+        if (_this2.currentMode === 'translate') {
+          _this2._applyDeltaToBoundingBoxHelpers();
         }
       };
       // First remove any existing listeners to prevent duplicates
@@ -1121,6 +1128,43 @@ var TransformControlsManager = /*#__PURE__*/function () {
       }
     }
 
+    /**
+     * Cheap per-frame bounding box update during translation drag.
+     * Shifts the 8 pre-snapshotted geometry vertices of every helper by the
+     * current drag delta. O(8 additions per helper) — no mesh traversal.
+     * Only valid for translate mode where the box shape is invariant.
+     * @private
+     */
+  }, {
+    key: "_applyDeltaToBoundingBoxHelpers",
+    value: function _applyDeltaToBoundingBoxHelpers() {
+      if (!this._dragStartGroupPosition || this.boundingBoxHelpers.length === 0) return;
+      var delta = this.multiSelectionGroup.position.clone().sub(this._dragStartGroupPosition);
+      var _iterator3 = _rollupPluginBabelHelpers.createForOfIteratorHelper(this.boundingBoxHelpers),
+        _step3;
+      try {
+        for (_iterator3.s(); !(_step3 = _iterator3.n()).done;) {
+          var _helper$geometry2;
+          var helper = _step3.value;
+          var startPositions = helper.userData._dragStartPositions;
+          var posAttr = (_helper$geometry2 = helper.geometry) === null || _helper$geometry2 === void 0 || (_helper$geometry2 = _helper$geometry2.attributes) === null || _helper$geometry2 === void 0 ? void 0 : _helper$geometry2.position;
+          if (!startPositions || !posAttr) continue;
+          var arr = posAttr.array;
+          // 8 vertices × 3 floats (x, y, z)
+          for (var i = 0; i < 24; i += 3) {
+            arr[i] = startPositions[i] + delta.x;
+            arr[i + 1] = startPositions[i + 1] + delta.y;
+            arr[i + 2] = startPositions[i + 2] + delta.z;
+          }
+          posAttr.needsUpdate = true;
+        }
+      } catch (err) {
+        _iterator3.e(err);
+      } finally {
+        _iterator3.f();
+      }
+    }
+
     /**
      * Set the transformation mode
      * @param {'translate' | 'rotate' | 'scale'} mode - The transformation mode
@@ -1495,11 +1539,11 @@ var TransformControlsManager = /*#__PURE__*/function () {
       var objectFilter = arguments.length > 1 && arguments[1] !== undefined ? arguments[1] : null;
       var objectsWithBounds = this.getSelectableObjectsWithBounds(objectFilter);
       var intersections = [];
-      var _iterator3 = _rollupPluginBabelHelpers.createForOfIteratorHelper(objectsWithBounds),
-        _step3;
+      var _iterator4 = _rollupPluginBabelHelpers.createForOfIteratorHelper(objectsWithBounds),
+        _step4;
       try {
-        for (_iterator3.s(); !(_step3 = _iterator3.n()).done;) {
-          var item = _step3.value;
+        for (_iterator4.s(); !(_step4 = _iterator4.n()).done;) {
+          var item = _step4.value;
           var object = item.object,
             boundingBox = item.boundingBox;
 
@@ -1519,9 +1563,9 @@ var TransformControlsManager = /*#__PURE__*/function () {
 
         // Sort by distance (closest first)
       } catch (err) {
-        _iterator3.e(err);
+        _iterator4.e(err);
       } finally {
-        _iterator3.f();
+        _iterator4.f();
       }
       intersections.sort(function (a, b) {
         return a.distance - b.distance;

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

@@ -146,9 +146,13 @@ var ModelManager = /*#__PURE__*/function () {
       var _this = this;
       var connectorChildren = [];
       targetMesh.children.forEach(function (child, index) {
+        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');
-        if (isConnectorGeometry && isConnectorByName) {
+        // 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) {
           // Ensure userData exists and has worldBoundingBox
           if (!child.userData) child.userData = {};
           if (!child.userData.worldBoundingBox) {
@@ -432,8 +436,8 @@ var ModelManager = /*#__PURE__*/function () {
               requiredModels = new Set();
               console.log("\uD83D\uDD0D Checking ".concat(data.scene.children.length, " scene objects for required models..."));
               data.scene.children.forEach(function (child) {
-                var _child$userData;
-                var libraryId = (_child$userData = child.userData) === null || _child$userData === void 0 ? void 0 : _child$userData.libraryId;
+                var _child$userData2;
+                var libraryId = (_child$userData2 = child.userData) === null || _child$userData2 === void 0 ? void 0 : _child$userData2.libraryId;
                 if (libraryId) {
                   if (componentDictionary[libraryId]) {
                     var modelKey = componentDictionary[libraryId].modelKey;

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

@@ -242,11 +242,35 @@ var SceneExportManager = /*#__PURE__*/function () {
         // For connectors/gateways: no children (they're leaf nodes)
         if (threeObject.children && threeObject.children.length > 0) {
           var exportableChildren = [];
-          if (threeObject.userData.objectType === 'component') ; else if (isManualSegment) {
-            // For manual segments, export their connector children
+          if (threeObject.userData.objectType === 'component') {
+            // Export connector children (skip mesh geometry - it lives in the component dictionary GLB)
             threeObject.children.forEach(function (child) {
               var _child$userData;
-              if (((_child$userData = child.userData) === null || _child$userData === void 0 ? void 0 : _child$userData.objectType) === 'segment-connector') {
+              if (((_child$userData = child.userData) === null || _child$userData === void 0 ? void 0 : _child$userData.objectType) === 'connector') {
+                var connectorJson = {
+                  // Use the raw Three.js UUID — connections in currentSceneData reference this exact value
+                  uuid: child.uuid,
+                  userData: _rollupPluginBabelHelpers.objectSpread2(_rollupPluginBabelHelpers.objectSpread2({
+                    objectType: 'connector'
+                  }, child.userData.direction ? {
+                    direction: child.userData.direction
+                  } : {}), child.userData.group ? {
+                    group: child.userData.group
+                  } : {}),
+                  position: {
+                    x: roundIfClose(child.position.x),
+                    y: roundIfClose(child.position.y),
+                    z: roundIfClose(child.position.z)
+                  }
+                };
+                exportableChildren.push(connectorJson);
+              }
+            });
+          } else if (isManualSegment) {
+            // For manual segments, export their connector children
+            threeObject.children.forEach(function (child) {
+              var _child$userData2;
+              if (((_child$userData2 = child.userData) === null || _child$userData2 === void 0 ? void 0 : _child$userData2.objectType) === 'segment-connector') {
                 // Call the class method using bound reference
                 var connectorJson = convertSegmentConnectorToJson(child, threeObject);
                 if (connectorJson) {
@@ -272,9 +296,9 @@ var SceneExportManager = /*#__PURE__*/function () {
       var findManualSegments = function findManualSegments(object) {
         var manualSegments = [];
         object.traverse(function (child) {
-          var _child$userData2;
+          var _child$userData3;
           // Check if this is a manual segment
-          if (((_child$userData2 = child.userData) === null || _child$userData2 === void 0 ? void 0 : _child$userData2.objectType) === 'segment') {
+          if (((_child$userData3 = child.userData) === null || _child$userData3 === void 0 ? void 0 : _child$userData3.objectType) === 'segment') {
             manualSegments.push(child);
           }
         });
@@ -474,14 +498,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$name2, _child$userData3, _child$userData4, _child$userData5, _child$userData6;
+                var _child$name2, _child$userData4, _child$userData5, _child$userData6, _child$userData7;
                 if ((_child$name2 = child.name) !== null && _child$name2 !== void 0 && _child$name2.includes('Polyline')) return false; // Will handle separately
                 if (child.name === 'fogPlane') return false; // Skip fog plane
-                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$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.isLight) return false; // Skip lights
-                if ((_child$userData6 = child.userData) !== null && _child$userData6 !== void 0 && _child$userData6.isTransformControls) return false; // Skip transform controls
+                if ((_child$userData7 = child.userData) !== null && _child$userData7 !== void 0 && _child$userData7.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

@@ -261,6 +261,24 @@ var SceneOperationsManager = /*#__PURE__*/function () {
           }
         }
       });
+
+      // Ensure CONNECTOR_GATEWAY_SPHERE exists even when all connectors are nested inside
+      // component children (e.g. SAMPLE_1.json inline connector definitions).  Without
+      // this geometry the connector meshes fall back to empty BufferGeometry, which then
+      // causes _preserveConnectorChildren to drop them during GLB model replacement.
+      if (!geometries['CONNECTOR_GATEWAY_SPHERE']) {
+        var hasNestedConnectors = data.scene.children.some(function (child) {
+          var _child$userData3;
+          return ((_child$userData3 = child.userData) === null || _child$userData3 === void 0 ? void 0 : _child$userData3.objectType) === 'component' && Array.isArray(child.children) && child.children.some(function (nestedChild) {
+            var _nestedChild$userData;
+            return ((_nestedChild$userData = nestedChild.userData) === null || _nestedChild$userData === void 0 ? void 0 : _nestedChild$userData.objectType) === 'connector';
+          });
+        });
+        if (hasNestedConnectors) {
+          geometries['CONNECTOR_GATEWAY_SPHERE'] = new THREE__namespace.SphereGeometry(0.1, 16, 16);
+          console.log('🔮 Created shared sphere geometry for nested inline connectors (radius: 0.1)');
+        }
+      }
       return geometries;
     }
 
@@ -646,12 +664,12 @@ var SceneOperationsManager = /*#__PURE__*/function () {
               _step;
             try {
               for (_iterator.s(); !(_step = _iterator.n()).done;) {
-                var _object$userData, _child$userData3;
+                var _object$userData, _child$userData4;
                 var child = _step.value;
                 // Enhanced matching logic with hardcoded UUID priority
 
                 // Strategy 1: Direct hardcoded UUID match (HIGHEST PRIORITY)
-                if (child.uuid === object.uuid || child.uuid === ((_object$userData = object.userData) === null || _object$userData === void 0 ? void 0 : _object$userData.originalUuid) || object.uuid === ((_child$userData3 = child.userData) === null || _child$userData3 === void 0 ? void 0 : _child$userData3.originalUuid)) {
+                if (child.uuid === object.uuid || child.uuid === ((_object$userData = object.userData) === null || _object$userData === void 0 ? void 0 : _object$userData.originalUuid) || object.uuid === ((_child$userData4 = child.userData) === null || _child$userData4 === void 0 ? void 0 : _child$userData4.originalUuid)) {
                   return child;
                 }
 
@@ -796,6 +814,9 @@ var SceneOperationsManager = /*#__PURE__*/function () {
               // Phase 6: Load behaviors (after GLB models are present so output objects can be resolved)
               this._processBehaviors(data);
               console.log('✅ Scene loaded successfully');
+
+              // Notify UI components (e.g. SceneHierarchy) that the scene is fully loaded
+              this.sceneViewer.emit('scene-loaded');
               _context4.n = 7;
               break;
             case 6:
@@ -907,10 +928,10 @@ var SceneOperationsManager = /*#__PURE__*/function () {
       var componentsProcessed = 0;
       var connectorsInjected = 0;
       data.scene.children.forEach(function (child) {
-        var _child$userData4, _child$userData5, _child$userData6;
-        var childType = ((_child$userData4 = child.userData) === null || _child$userData4 === void 0 ? void 0 : _child$userData4.objectType) || ((_child$userData5 = child.userData) === null || _child$userData5 === void 0 ? void 0 : _child$userData5.objectType);
+        var _child$userData5, _child$userData6, _child$userData7;
+        var childType = ((_child$userData5 = child.userData) === null || _child$userData5 === void 0 ? void 0 : _child$userData5.objectType) || ((_child$userData6 = child.userData) === null || _child$userData6 === void 0 ? void 0 : _child$userData6.objectType);
         // Only process components with libraryId
-        if (childType === 'component' && (_child$userData6 = child.userData) !== null && _child$userData6 !== void 0 && _child$userData6.libraryId) {
+        if (childType === 'component' && (_child$userData7 = child.userData) !== null && _child$userData7 !== void 0 && _child$userData7.libraryId) {
           var libraryId = child.userData.libraryId;
           var dictEntry = componentDictionary[libraryId];
 
@@ -1067,17 +1088,17 @@ var SceneOperationsManager = /*#__PURE__*/function () {
               geometries = this.createSceneGeometries(data, componentDictionary); // Create basic objects and track GLB replacements
               libraryObjectsToReplace = [];
               data.scene.children.forEach(function (child, index) {
-                var _child$userData7, _child$userData8;
+                var _child$userData8, _child$userData9;
                 var createdObject = _this4.createSceneObject(child, geometries, materials, componentDictionary);
                 _this4.sceneViewer.scene.add(createdObject);
 
                 // Track objects that need GLB model replacement
-                if ((_child$userData7 = child.userData) !== null && _child$userData7 !== void 0 && _child$userData7.libraryId && componentDictionary[(_child$userData8 = child.userData) === null || _child$userData8 === void 0 ? void 0 : _child$userData8.libraryId]) {
-                  var _child$userData9;
+                if ((_child$userData8 = child.userData) !== null && _child$userData8 !== void 0 && _child$userData8.libraryId && componentDictionary[(_child$userData9 = child.userData) === null || _child$userData9 === void 0 ? void 0 : _child$userData9.libraryId]) {
+                  var _child$userData0;
                   libraryObjectsToReplace.push({
                     basicObject: createdObject,
                     jsonData: child,
-                    componentData: componentDictionary[(_child$userData9 = child.userData) === null || _child$userData9 === void 0 ? void 0 : _child$userData9.libraryId]
+                    componentData: componentDictionary[(_child$userData0 = child.userData) === null || _child$userData0 === void 0 ? void 0 : _child$userData0.libraryId]
                   });
                 }
               });
@@ -1216,8 +1237,8 @@ var SceneOperationsManager = /*#__PURE__*/function () {
       var instanceBehaviors = [];
       if (Array.isArray(data === null || data === void 0 || (_data$scene3 = data.scene) === null || _data$scene3 === void 0 ? void 0 : _data$scene3.children)) {
         data.scene.children.forEach(function (child) {
-          var _child$userData0, _compData$defaultBeha;
-          var libraryId = (_child$userData0 = child.userData) === null || _child$userData0 === void 0 ? void 0 : _child$userData0.libraryId;
+          var _child$userData1, _compData$defaultBeha;
+          var libraryId = (_child$userData1 = child.userData) === null || _child$userData1 === void 0 ? void 0 : _child$userData1.libraryId;
           if (!libraryId) return;
           var instanceUuid = child.uuid;
           // Skip instances whose defaults were already resolved by Step A
@@ -1608,8 +1629,8 @@ var SceneOperationsManager = /*#__PURE__*/function () {
         // Process children (connectors, etc.) if they exist
         if (componentModel.children && componentModel.children.length > 0) {
           componentModel.children.forEach(function (child) {
-            var _child$userData1, _child$userData10;
-            var childType = ((_child$userData1 = child.userData) === null || _child$userData1 === void 0 ? void 0 : _child$userData1.objectType) || ((_child$userData10 = child.userData) === null || _child$userData10 === void 0 ? void 0 : _child$userData10.objectType);
+            var _child$userData10, _child$userData11;
+            var childType = ((_child$userData10 = child.userData) === null || _child$userData10 === void 0 ? void 0 : _child$userData10.objectType) || ((_child$userData11 = child.userData) === null || _child$userData11 === void 0 ? void 0 : _child$userData11.objectType);
             if (childType === 'connector') {
               var _child$geometry;
               var childBoundingBox = new THREE__namespace.Box3().setFromObject(child);
@@ -1694,8 +1715,8 @@ var SceneOperationsManager = /*#__PURE__*/function () {
       if (segment.children && segment.children.length > 0) {
         var childrenToRemove = _rollupPluginBabelHelpers.toConsumableArray(segment.children);
         childrenToRemove.forEach(function (child) {
-          var _child$userData11;
-          if ((_child$userData11 = child.userData) !== null && _child$userData11 !== void 0 && _child$userData11.isPipeElbow) {
+          var _child$userData12;
+          if ((_child$userData12 = child.userData) !== null && _child$userData12 !== void 0 && _child$userData12.isPipeElbow) {
             console.log("\uD83D\uDDD1\uFE0F Removing elbow child from segment before manualization: ".concat(child.uuid));
             segment.remove(child);
             if (child.geometry) child.geometry.dispose();

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

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

package/dist/esm/src/managers/controls/transformControlsManager.js

@@ -233,6 +233,17 @@ var TransformControlsManager = /*#__PURE__*/function () {
             obj.userData._multiSelectOriginalRotation = obj.rotation.clone();
             obj.userData._multiSelectOriginalScale = obj.scale.clone();
           });
+
+          // Snapshot group position and helper geometry vertices so we can do
+          // cheap per-frame bbox translation without re-traversing the mesh hierarchy.
+          _this2._dragStartGroupPosition = _this2.multiSelectionGroup.position.clone();
+          _this2.boundingBoxHelpers.forEach(function (helper) {
+            var _helper$geometry;
+            var posAttr = (_helper$geometry = helper.geometry) === null || _helper$geometry === void 0 || (_helper$geometry = _helper$geometry.attributes) === null || _helper$geometry === void 0 ? void 0 : _helper$geometry.position;
+            if (posAttr) {
+              helper.userData._dragStartPositions = new Float32Array(posAttr.array);
+            }
+          });
         }
 
         // Disable orbit controls during transformation
@@ -297,6 +308,13 @@ var TransformControlsManager = /*#__PURE__*/function () {
                 }
               }
             case 3:
+              // Ensure the bounding box reflects the final post-drag object position.
+              // applyMultiSelectionTransform calls _finalizeMultiSelectionTransform →
+              // createMultiBoundingBox for moves above the threshold.  Call updateBoundingBox
+              // here as a safety net for sub-threshold moves or rotation mode, where
+              // _finalizeMultiSelectionTransform is not triggered.
+              _this2.updateBoundingBox();
+
               // Dispatch custom scene update event after transform completes
               if (typeof window !== 'undefined') {
                 console.log('📡 Dispatching sceneUpdateComplete event after transform');
@@ -310,6 +328,12 @@ var TransformControlsManager = /*#__PURE__*/function () {
                 });
                 window.dispatchEvent(sceneCompleteEvent);
               }
+
+              // Clean up per-drag snapshots
+              _this2._dragStartGroupPosition = null;
+              _this2.boundingBoxHelpers.forEach(function (helper) {
+                delete helper.userData._dragStartPositions;
+              });
               console.log("\u2705 Transform completed: ".concat(_this2.currentMode, " mode"));
             case 4:
               return _context.a(2);
@@ -318,33 +342,16 @@ var TransformControlsManager = /*#__PURE__*/function () {
       }));
       // Transform changing event
       this.eventHandlers.transforming = function () {
-        // Apply real-time visual transformation to objects during drag
+        // Apply real-time visual transformation to objects during drag.
         if (_this2.selectedObjects.length > 0 && _this2.multiSelectionGroup) {
           _this2.applyRealtimeTransform();
         }
 
-        // Clear the bounding box cache for all selected objects during transformation
-        _this2.selectedObjects.forEach(function (obj) {
-          if (_this2.boundingBoxCache.has(obj)) {
-            _this2.boundingBoxCache.delete(obj);
-          }
-        });
-
-        // Update bounding box during transformation
-        _this2.updateBoundingBox();
-
-        // Dispatch custom scene update event during transform (optional - fires continuously)
-        if (typeof window !== 'undefined') {
-          var _this2$selectedObject2;
-          var sceneCompleteEvent = new CustomEvent('sceneUpdateComplete', {
-            detail: {
-              timestamp: Date.now(),
-              transformType: _this2.currentMode,
-              objectName: ((_this2$selectedObject2 = _this2.selectedObjects[0]) === null || _this2$selectedObject2 === void 0 ? void 0 : _this2$selectedObject2.name) || 'unknown',
-              isTransforming: true
-            }
-          });
-          window.dispatchEvent(sceneCompleteEvent);
+        // Per-frame bbox tracking: during translate we can cheaply shift the
+        // pre-snapshotted helper geometry vertices by the drag delta instead of
+        // re-traversing the full mesh hierarchy every pointermove.
+        if (_this2.currentMode === 'translate') {
+          _this2._applyDeltaToBoundingBoxHelpers();
         }
       };
       // First remove any existing listeners to prevent duplicates
@@ -1097,6 +1104,43 @@ var TransformControlsManager = /*#__PURE__*/function () {
       }
     }
 
+    /**
+     * Cheap per-frame bounding box update during translation drag.
+     * Shifts the 8 pre-snapshotted geometry vertices of every helper by the
+     * current drag delta. O(8 additions per helper) — no mesh traversal.
+     * Only valid for translate mode where the box shape is invariant.
+     * @private
+     */
+  }, {
+    key: "_applyDeltaToBoundingBoxHelpers",
+    value: function _applyDeltaToBoundingBoxHelpers() {
+      if (!this._dragStartGroupPosition || this.boundingBoxHelpers.length === 0) return;
+      var delta = this.multiSelectionGroup.position.clone().sub(this._dragStartGroupPosition);
+      var _iterator3 = _createForOfIteratorHelper(this.boundingBoxHelpers),
+        _step3;
+      try {
+        for (_iterator3.s(); !(_step3 = _iterator3.n()).done;) {
+          var _helper$geometry2;
+          var helper = _step3.value;
+          var startPositions = helper.userData._dragStartPositions;
+          var posAttr = (_helper$geometry2 = helper.geometry) === null || _helper$geometry2 === void 0 || (_helper$geometry2 = _helper$geometry2.attributes) === null || _helper$geometry2 === void 0 ? void 0 : _helper$geometry2.position;
+          if (!startPositions || !posAttr) continue;
+          var arr = posAttr.array;
+          // 8 vertices × 3 floats (x, y, z)
+          for (var i = 0; i < 24; i += 3) {
+            arr[i] = startPositions[i] + delta.x;
+            arr[i + 1] = startPositions[i + 1] + delta.y;
+            arr[i + 2] = startPositions[i + 2] + delta.z;
+          }
+          posAttr.needsUpdate = true;
+        }
+      } catch (err) {
+        _iterator3.e(err);
+      } finally {
+        _iterator3.f();
+      }
+    }
+
     /**
      * Set the transformation mode
      * @param {'translate' | 'rotate' | 'scale'} mode - The transformation mode
@@ -1471,11 +1515,11 @@ var TransformControlsManager = /*#__PURE__*/function () {
       var objectFilter = arguments.length > 1 && arguments[1] !== undefined ? arguments[1] : null;
       var objectsWithBounds = this.getSelectableObjectsWithBounds(objectFilter);
       var intersections = [];
-      var _iterator3 = _createForOfIteratorHelper(objectsWithBounds),
-        _step3;
+      var _iterator4 = _createForOfIteratorHelper(objectsWithBounds),
+        _step4;
       try {
-        for (_iterator3.s(); !(_step3 = _iterator3.n()).done;) {
-          var item = _step3.value;
+        for (_iterator4.s(); !(_step4 = _iterator4.n()).done;) {
+          var item = _step4.value;
           var object = item.object,
             boundingBox = item.boundingBox;
 
@@ -1495,9 +1539,9 @@ var TransformControlsManager = /*#__PURE__*/function () {
 
         // Sort by distance (closest first)
       } catch (err) {
-        _iterator3.e(err);
+        _iterator4.e(err);
       } finally {
-        _iterator3.f();
+        _iterator4.f();
       }
       intersections.sort(function (a, b) {
         return a.distance - b.distance;

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

@@ -122,9 +122,13 @@ var ModelManager = /*#__PURE__*/function () {
       var _this = this;
       var connectorChildren = [];
       targetMesh.children.forEach(function (child, index) {
+        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');
-        if (isConnectorGeometry && isConnectorByName) {
+        // 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) {
           // Ensure userData exists and has worldBoundingBox
           if (!child.userData) child.userData = {};
           if (!child.userData.worldBoundingBox) {
@@ -408,8 +412,8 @@ var ModelManager = /*#__PURE__*/function () {
               requiredModels = new Set();
               console.log("\uD83D\uDD0D Checking ".concat(data.scene.children.length, " scene objects for required models..."));
               data.scene.children.forEach(function (child) {
-                var _child$userData;
-                var libraryId = (_child$userData = child.userData) === null || _child$userData === void 0 ? void 0 : _child$userData.libraryId;
+                var _child$userData2;
+                var libraryId = (_child$userData2 = child.userData) === null || _child$userData2 === void 0 ? void 0 : _child$userData2.libraryId;
                 if (libraryId) {
                   if (componentDictionary[libraryId]) {
                     var modelKey = componentDictionary[libraryId].modelKey;

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

@@ -220,11 +220,35 @@ var SceneExportManager = /*#__PURE__*/function () {
         // For connectors/gateways: no children (they're leaf nodes)
         if (threeObject.children && threeObject.children.length > 0) {
           var exportableChildren = [];
-          if (threeObject.userData.objectType === 'component') ; else if (isManualSegment) {
-            // For manual segments, export their connector children
+          if (threeObject.userData.objectType === 'component') {
+            // Export connector children (skip mesh geometry - it lives in the component dictionary GLB)
             threeObject.children.forEach(function (child) {
               var _child$userData;
-              if (((_child$userData = child.userData) === null || _child$userData === void 0 ? void 0 : _child$userData.objectType) === 'segment-connector') {
+              if (((_child$userData = child.userData) === null || _child$userData === void 0 ? void 0 : _child$userData.objectType) === 'connector') {
+                var connectorJson = {
+                  // Use the raw Three.js UUID — connections in currentSceneData reference this exact value
+                  uuid: child.uuid,
+                  userData: _objectSpread2(_objectSpread2({
+                    objectType: 'connector'
+                  }, child.userData.direction ? {
+                    direction: child.userData.direction
+                  } : {}), child.userData.group ? {
+                    group: child.userData.group
+                  } : {}),
+                  position: {
+                    x: roundIfClose(child.position.x),
+                    y: roundIfClose(child.position.y),
+                    z: roundIfClose(child.position.z)
+                  }
+                };
+                exportableChildren.push(connectorJson);
+              }
+            });
+          } else if (isManualSegment) {
+            // For manual segments, export their connector children
+            threeObject.children.forEach(function (child) {
+              var _child$userData2;
+              if (((_child$userData2 = child.userData) === null || _child$userData2 === void 0 ? void 0 : _child$userData2.objectType) === 'segment-connector') {
                 // Call the class method using bound reference
                 var connectorJson = convertSegmentConnectorToJson(child, threeObject);
                 if (connectorJson) {
@@ -250,9 +274,9 @@ var SceneExportManager = /*#__PURE__*/function () {
       var findManualSegments = function findManualSegments(object) {
         var manualSegments = [];
         object.traverse(function (child) {
-          var _child$userData2;
+          var _child$userData3;
           // Check if this is a manual segment
-          if (((_child$userData2 = child.userData) === null || _child$userData2 === void 0 ? void 0 : _child$userData2.objectType) === 'segment') {
+          if (((_child$userData3 = child.userData) === null || _child$userData3 === void 0 ? void 0 : _child$userData3.objectType) === 'segment') {
             manualSegments.push(child);
           }
         });
@@ -452,14 +476,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$name2, _child$userData3, _child$userData4, _child$userData5, _child$userData6;
+                var _child$name2, _child$userData4, _child$userData5, _child$userData6, _child$userData7;
                 if ((_child$name2 = child.name) !== null && _child$name2 !== void 0 && _child$name2.includes('Polyline')) return false; // Will handle separately
                 if (child.name === 'fogPlane') return false; // Skip fog plane
-                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$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.isLight) return false; // Skip lights
-                if ((_child$userData6 = child.userData) !== null && _child$userData6 !== void 0 && _child$userData6.isTransformControls) return false; // Skip transform controls
+                if ((_child$userData7 = child.userData) !== null && _child$userData7 !== void 0 && _child$userData7.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/esm/src/managers/scene/sceneOperationsManager.js

@@ -237,6 +237,24 @@ var SceneOperationsManager = /*#__PURE__*/function () {
           }
         }
       });
+
+      // Ensure CONNECTOR_GATEWAY_SPHERE exists even when all connectors are nested inside
+      // component children (e.g. SAMPLE_1.json inline connector definitions).  Without
+      // this geometry the connector meshes fall back to empty BufferGeometry, which then
+      // causes _preserveConnectorChildren to drop them during GLB model replacement.
+      if (!geometries['CONNECTOR_GATEWAY_SPHERE']) {
+        var hasNestedConnectors = data.scene.children.some(function (child) {
+          var _child$userData3;
+          return ((_child$userData3 = child.userData) === null || _child$userData3 === void 0 ? void 0 : _child$userData3.objectType) === 'component' && Array.isArray(child.children) && child.children.some(function (nestedChild) {
+            var _nestedChild$userData;
+            return ((_nestedChild$userData = nestedChild.userData) === null || _nestedChild$userData === void 0 ? void 0 : _nestedChild$userData.objectType) === 'connector';
+          });
+        });
+        if (hasNestedConnectors) {
+          geometries['CONNECTOR_GATEWAY_SPHERE'] = new THREE.SphereGeometry(0.1, 16, 16);
+          console.log('🔮 Created shared sphere geometry for nested inline connectors (radius: 0.1)');
+        }
+      }
       return geometries;
     }
 
@@ -622,12 +640,12 @@ var SceneOperationsManager = /*#__PURE__*/function () {
               _step;
             try {
               for (_iterator.s(); !(_step = _iterator.n()).done;) {
-                var _object$userData, _child$userData3;
+                var _object$userData, _child$userData4;
                 var child = _step.value;
                 // Enhanced matching logic with hardcoded UUID priority
 
                 // Strategy 1: Direct hardcoded UUID match (HIGHEST PRIORITY)
-                if (child.uuid === object.uuid || child.uuid === ((_object$userData = object.userData) === null || _object$userData === void 0 ? void 0 : _object$userData.originalUuid) || object.uuid === ((_child$userData3 = child.userData) === null || _child$userData3 === void 0 ? void 0 : _child$userData3.originalUuid)) {
+                if (child.uuid === object.uuid || child.uuid === ((_object$userData = object.userData) === null || _object$userData === void 0 ? void 0 : _object$userData.originalUuid) || object.uuid === ((_child$userData4 = child.userData) === null || _child$userData4 === void 0 ? void 0 : _child$userData4.originalUuid)) {
                   return child;
                 }
 
@@ -772,6 +790,9 @@ var SceneOperationsManager = /*#__PURE__*/function () {
               // Phase 6: Load behaviors (after GLB models are present so output objects can be resolved)
               this._processBehaviors(data);
               console.log('✅ Scene loaded successfully');
+
+              // Notify UI components (e.g. SceneHierarchy) that the scene is fully loaded
+              this.sceneViewer.emit('scene-loaded');
               _context4.n = 7;
               break;
             case 6:
@@ -883,10 +904,10 @@ var SceneOperationsManager = /*#__PURE__*/function () {
       var componentsProcessed = 0;
       var connectorsInjected = 0;
       data.scene.children.forEach(function (child) {
-        var _child$userData4, _child$userData5, _child$userData6;
-        var childType = ((_child$userData4 = child.userData) === null || _child$userData4 === void 0 ? void 0 : _child$userData4.objectType) || ((_child$userData5 = child.userData) === null || _child$userData5 === void 0 ? void 0 : _child$userData5.objectType);
+        var _child$userData5, _child$userData6, _child$userData7;
+        var childType = ((_child$userData5 = child.userData) === null || _child$userData5 === void 0 ? void 0 : _child$userData5.objectType) || ((_child$userData6 = child.userData) === null || _child$userData6 === void 0 ? void 0 : _child$userData6.objectType);
         // Only process components with libraryId
-        if (childType === 'component' && (_child$userData6 = child.userData) !== null && _child$userData6 !== void 0 && _child$userData6.libraryId) {
+        if (childType === 'component' && (_child$userData7 = child.userData) !== null && _child$userData7 !== void 0 && _child$userData7.libraryId) {
           var libraryId = child.userData.libraryId;
           var dictEntry = componentDictionary[libraryId];
 
@@ -1043,17 +1064,17 @@ var SceneOperationsManager = /*#__PURE__*/function () {
               geometries = this.createSceneGeometries(data, componentDictionary); // Create basic objects and track GLB replacements
               libraryObjectsToReplace = [];
               data.scene.children.forEach(function (child, index) {
-                var _child$userData7, _child$userData8;
+                var _child$userData8, _child$userData9;
                 var createdObject = _this4.createSceneObject(child, geometries, materials, componentDictionary);
                 _this4.sceneViewer.scene.add(createdObject);
 
                 // Track objects that need GLB model replacement
-                if ((_child$userData7 = child.userData) !== null && _child$userData7 !== void 0 && _child$userData7.libraryId && componentDictionary[(_child$userData8 = child.userData) === null || _child$userData8 === void 0 ? void 0 : _child$userData8.libraryId]) {
-                  var _child$userData9;
+                if ((_child$userData8 = child.userData) !== null && _child$userData8 !== void 0 && _child$userData8.libraryId && componentDictionary[(_child$userData9 = child.userData) === null || _child$userData9 === void 0 ? void 0 : _child$userData9.libraryId]) {
+                  var _child$userData0;
                   libraryObjectsToReplace.push({
                     basicObject: createdObject,
                     jsonData: child,
-                    componentData: componentDictionary[(_child$userData9 = child.userData) === null || _child$userData9 === void 0 ? void 0 : _child$userData9.libraryId]
+                    componentData: componentDictionary[(_child$userData0 = child.userData) === null || _child$userData0 === void 0 ? void 0 : _child$userData0.libraryId]
                   });
                 }
               });
@@ -1192,8 +1213,8 @@ var SceneOperationsManager = /*#__PURE__*/function () {
       var instanceBehaviors = [];
       if (Array.isArray(data === null || data === void 0 || (_data$scene3 = data.scene) === null || _data$scene3 === void 0 ? void 0 : _data$scene3.children)) {
         data.scene.children.forEach(function (child) {
-          var _child$userData0, _compData$defaultBeha;
-          var libraryId = (_child$userData0 = child.userData) === null || _child$userData0 === void 0 ? void 0 : _child$userData0.libraryId;
+          var _child$userData1, _compData$defaultBeha;
+          var libraryId = (_child$userData1 = child.userData) === null || _child$userData1 === void 0 ? void 0 : _child$userData1.libraryId;
           if (!libraryId) return;
           var instanceUuid = child.uuid;
           // Skip instances whose defaults were already resolved by Step A
@@ -1584,8 +1605,8 @@ var SceneOperationsManager = /*#__PURE__*/function () {
         // Process children (connectors, etc.) if they exist
         if (componentModel.children && componentModel.children.length > 0) {
           componentModel.children.forEach(function (child) {
-            var _child$userData1, _child$userData10;
-            var childType = ((_child$userData1 = child.userData) === null || _child$userData1 === void 0 ? void 0 : _child$userData1.objectType) || ((_child$userData10 = child.userData) === null || _child$userData10 === void 0 ? void 0 : _child$userData10.objectType);
+            var _child$userData10, _child$userData11;
+            var childType = ((_child$userData10 = child.userData) === null || _child$userData10 === void 0 ? void 0 : _child$userData10.objectType) || ((_child$userData11 = child.userData) === null || _child$userData11 === void 0 ? void 0 : _child$userData11.objectType);
             if (childType === 'connector') {
               var _child$geometry;
               var childBoundingBox = new THREE.Box3().setFromObject(child);
@@ -1670,8 +1691,8 @@ var SceneOperationsManager = /*#__PURE__*/function () {
       if (segment.children && segment.children.length > 0) {
         var childrenToRemove = _toConsumableArray(segment.children);
         childrenToRemove.forEach(function (child) {
-          var _child$userData11;
-          if ((_child$userData11 = child.userData) !== null && _child$userData11 !== void 0 && _child$userData11.isPipeElbow) {
+          var _child$userData12;
+          if ((_child$userData12 = child.userData) !== null && _child$userData12 !== void 0 && _child$userData12.isPipeElbow) {
             console.log("\uD83D\uDDD1\uFE0F Removing elbow child from segment before manualization: ".concat(child.uuid));
             segment.remove(child);
             if (child.geometry) child.geometry.dispose();

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@2112-lab/central-plant",
-  "version": "0.1.93",
+  "version": "0.1.95",
   "description": "Utility modules for the Central Plant Application",
   "main": "dist/bundle/index.js",
   "module": "dist/esm/src/index.js",