@2112-lab/central-plant 0.3.49 → 0.3.51

package/dist/esm/src/managers/pathfinding/pathfindingManager.js

@@ -3,7 +3,7 @@ import * as THREE from 'three';
 import { Pathfinder } from '@2112-lab/pathfinder';
 import { BaseDisposable } from '../../core/baseDisposable.js';
 import { PathData } from '../../core/pathfindingData.js';
-import { computeFilteredBoundingBox, computeConnectorBoundingBoxes, computeIODeviceBoundingBoxes } from '../../utils/boundingBoxUtils.js';
+import { computeFilteredBoundingBox, computeIODeviceBoundingBoxes, computeConnectorBoundingBoxes } from '../../utils/boundingBoxUtils.js';
 import { SceneDataManager } from './sceneDataManager.js';
 import { PathRenderingManager } from './PathRenderingManager.js';
 import { ConnectorManager } from './ConnectorManager.js';
@@ -202,204 +202,344 @@ var PathfindingManager = /*#__PURE__*/function (_BaseDisposable) {
     }
 
     /**
-     * Enrich scene data with world-space bounding boxes and positions for collision avoidance
-     * @param {Object|Array} sceneData - Original scene data or array of children
-     * @returns {Object|Array} Enriched scene data (shallow copy with modifications)
+     * Enrich sceneData with worldBoundingBox for segments and components
+     * Connectors remain with just position information.
+     *
+     * Uses _bboxCache to avoid recomputing filtered / io-device bboxes
+     * when the underlying object's world matrix has not changed.
+     *
+     * @param {Object} sceneData - Original scene data
+     * @returns {Object} Enriched scene data (shallow copy with modifications)
      * @private
      */
   }, {
     key: "_enrichSceneDataWithBoundingBoxes",
     value: function _enrichSceneDataWithBoundingBoxes(sceneData) {
       var _this4 = this;
-      if (!sceneData) return sceneData;
-
-      // Recursive helper to enrich a node and its children
-      var _enrichNode = function enrichNode(node) {
-        if (!node) return node;
-        var enrichedNode = _objectSpread2({}, node);
+      // Create a shallow copy of sceneData structure
+      var enriched = _objectSpread2({}, sceneData);
+      if (!sceneData.children || !Array.isArray(sceneData.children)) {
+        console.warn('⚠️ sceneData has no children array');
+        return enriched;
+      }
 
+      // Process children to add worldBoundingBox to segments and components
+      enriched.children = sceneData.children.map(function (child) {
         // Skip computed objects ( elbows etc )
-        if (node.userData && (node.userData.isComputed === true || node.userData.objectType === 'elbow')) {
-          return node;
+        if (child.userData && (child.userData.isComputed === true || child.userData.objectType === 'elbow')) {
+          return child;
         }
 
-        // ── Enrich Segments ──
-        if (node.userData && node.userData.objectType === 'segment') {
-          var segmentObject = _this4.sceneViewer.scene.getObjectByProperty('uuid', node.uuid);
+        // Enrich segments (check if objectType is 'segment' in userData)
+        if (child.userData && child.userData.objectType === 'segment') {
+          // Find the actual segment object in the scene
+          var segmentObject = _this4.sceneViewer.scene.getObjectByProperty('uuid', child.uuid);
           if (segmentObject) {
+            // ── Cache check ──
             var hash = _this4._matrixHash(segmentObject);
-            var cached = _this4._bboxCache.get(node.uuid);
+            var cached = _this4._bboxCache.get(child.uuid);
             if (cached && cached.matrixHash === hash && cached.segmentBBox) {
-              enrichedNode.userData = _objectSpread2(_objectSpread2({}, node.userData), {}, {
-                worldBoundingBox: cached.segmentBBox
-              });
-            } else {
-              var worldBBox = new THREE.Box3().setFromObject(segmentObject);
-              var bboxData = {
-                min: [worldBBox.min.x, worldBBox.min.y, worldBBox.min.z],
-                max: [worldBBox.max.x, worldBBox.max.y, worldBBox.max.z]
-              };
-              _this4._bboxCache.set(node.uuid, {
-                matrixHash: hash,
-                segmentBBox: bboxData
-              });
-              enrichedNode.userData = _objectSpread2(_objectSpread2({}, node.userData), {}, {
-                worldBoundingBox: bboxData
+              return _objectSpread2(_objectSpread2({}, child), {}, {
+                userData: _objectSpread2(_objectSpread2({}, child.userData), {}, {
+                  worldBoundingBox: cached.segmentBBox
+                })
               });
             }
+
+            // Compute world bounding box
+            var worldBBox = new THREE.Box3().setFromObject(segmentObject);
+            var bboxData = {
+              min: [worldBBox.min.x, worldBBox.min.y, worldBBox.min.z],
+              max: [worldBBox.max.x, worldBBox.max.y, worldBBox.max.z]
+            };
+
+            // Store in cache
+            _this4._bboxCache.set(child.uuid, {
+              matrixHash: hash,
+              segmentBBox: bboxData
+            });
+            return _objectSpread2(_objectSpread2({}, child), {}, {
+              userData: _objectSpread2(_objectSpread2({}, child.userData), {}, {
+                worldBoundingBox: bboxData
+              })
+            });
+          } else {
+            console.warn("\u26A0\uFE0F Could not find segment object in scene: ".concat(child.uuid));
           }
         }
 
-        // ── Enrich Components ──
-        else if (node.userData && node.userData.objectType === 'component') {
-          var componentObject = _this4.sceneViewer.scene.getObjectByProperty('uuid', node.uuid);
+        // Enrich components (check if objectType is 'component' in userData)
+        if (child.userData && child.userData.objectType === 'component') {
+          // Find the actual component object in the scene
+          var componentObject = _this4.sceneViewer.scene.getObjectByProperty('uuid', child.uuid);
           if (componentObject) {
+            // Explicitly update matrices for this component subtree before computing bounding boxes
             componentObject.updateMatrixWorld(true);
+
+            // ── Cache check ──
             var _hash = _this4._matrixHash(componentObject);
-            var _cached = _this4._bboxCache.get(node.uuid);
+            var _cached = _this4._bboxCache.get(child.uuid);
             if (_cached && _cached.matrixHash === _hash && _cached.filteredBBox) {
-              enrichedNode.position = {
-                x: componentObject.position.x,
-                y: componentObject.position.y,
-                z: componentObject.position.z
-              };
-              enrichedNode.rotation = {
-                x: THREE.MathUtils.radToDeg(componentObject.rotation.x),
-                y: THREE.MathUtils.radToDeg(componentObject.rotation.y),
-                z: THREE.MathUtils.radToDeg(componentObject.rotation.z)
-              };
-              enrichedNode.userData = _objectSpread2(_objectSpread2({}, node.userData), {}, {
-                worldBoundingBox: _cached.filteredBBox,
-                position: [componentObject.position.x, componentObject.position.y, componentObject.position.z]
+              // Rebuild enriched child from cached data
+              var _enrichedChild = _objectSpread2(_objectSpread2({}, child), {}, {
+                // Sync live transform even on cache hit just in case the manifest (child) is stale
+                position: {
+                  x: componentObject.position.x,
+                  y: componentObject.position.y,
+                  z: componentObject.position.z
+                },
+                rotation: {
+                  x: THREE.MathUtils.radToDeg(componentObject.rotation.x),
+                  y: THREE.MathUtils.radToDeg(componentObject.rotation.y),
+                  z: THREE.MathUtils.radToDeg(componentObject.rotation.z)
+                },
+                userData: _objectSpread2(_objectSpread2({}, child.userData), {}, {
+                  worldBoundingBox: _cached.filteredBBox,
+                  position: [componentObject.position.x, componentObject.position.y, componentObject.position.z]
+                })
               });
-
-              // Re-merge cached connectors and devices if they exist
-              if (!enrichedNode.children) enrichedNode.children = [];
-              if (_cached.connectorBBoxes) {
-                _cached.connectorBBoxes.forEach(function (conn) {
-                  return _this4._mergeEnrichedChild(enrichedNode.children, conn);
+              if (_cached.ioDeviceBBoxes && _cached.ioDeviceBBoxes.length > 0) {
+                if (!_enrichedChild.children) _enrichedChild.children = [];
+                _cached.ioDeviceBBoxes.forEach(function (deviceBBox) {
+                  var existingIndex = _enrichedChild.children.findIndex(function (c) {
+                    return c.uuid === deviceBBox.uuid;
+                  });
+                  if (existingIndex >= 0) {
+                    _enrichedChild.children[existingIndex] = _objectSpread2(_objectSpread2({}, _enrichedChild.children[existingIndex]), {}, {
+                      position: {
+                        x: deviceBBox.userData.position[0],
+                        y: deviceBBox.userData.position[1],
+                        z: deviceBBox.userData.position[2]
+                      },
+                      userData: _objectSpread2(_objectSpread2({}, _enrichedChild.children[existingIndex].userData), {}, {
+                        objectType: 'io-device',
+                        worldBoundingBox: deviceBBox.worldBoundingBox,
+                        position: deviceBBox.userData.position
+                      })
+                    });
+                  } else {
+                    _enrichedChild.children.push({
+                      uuid: deviceBBox.uuid,
+                      position: {
+                        x: deviceBBox.userData.position[0],
+                        y: deviceBBox.userData.position[1],
+                        z: deviceBBox.userData.position[2]
+                      },
+                      userData: _objectSpread2(_objectSpread2({}, deviceBBox.userData), {}, {
+                        worldBoundingBox: deviceBBox.worldBoundingBox,
+                        position: deviceBBox.userData.position
+                      }),
+                      children: []
+                    });
+                  }
                 });
               }
-              if (_cached.ioDeviceBBoxes) {
-                _cached.ioDeviceBBoxes.forEach(function (dev) {
-                  return _this4._mergeEnrichedChild(enrichedNode.children, dev);
+
+              // Also reinject connectors from cache
+              if (_cached.connectorBBoxes && _cached.connectorBBoxes.length > 0) {
+                if (!_enrichedChild.children) _enrichedChild.children = [];
+                _cached.connectorBBoxes.forEach(function (connBBox) {
+                  var existingIndex = _enrichedChild.children.findIndex(function (c) {
+                    return c.uuid === connBBox.uuid;
+                  });
+                  if (existingIndex >= 0) {
+                    _enrichedChild.children[existingIndex] = _objectSpread2(_objectSpread2({}, _enrichedChild.children[existingIndex]), {}, {
+                      position: {
+                        x: connBBox.userData.position[0],
+                        y: connBBox.userData.position[1],
+                        z: connBBox.userData.position[2]
+                      },
+                      userData: _objectSpread2(_objectSpread2({}, _enrichedChild.children[existingIndex].userData), {}, {
+                        worldBoundingBox: connBBox.worldBoundingBox,
+                        position: connBBox.userData.position
+                      })
+                    });
+                  } else {
+                    _enrichedChild.children.push({
+                      uuid: connBBox.uuid,
+                      position: {
+                        x: connBBox.userData.position[0],
+                        y: connBBox.userData.position[1],
+                        z: connBBox.userData.position[2]
+                      },
+                      userData: _objectSpread2(_objectSpread2({}, connBBox.userData), {}, {
+                        worldBoundingBox: connBBox.worldBoundingBox,
+                        position: connBBox.userData.position
+                      }),
+                      children: []
+                    });
+                  }
                 });
               }
-            } else {
-              var filteredBBox = computeFilteredBoundingBox(componentObject, ['io-device', 'connector']);
-              var _bboxData = {
-                min: [filteredBBox.min.x, filteredBBox.min.y, filteredBBox.min.z],
-                max: [filteredBBox.max.x, filteredBBox.max.y, filteredBBox.max.z]
-              };
-              enrichedNode.position = {
+              return _enrichedChild;
+            }
+
+            // Compute FILTERED bounding box — excludes io-device and connector subtrees
+            // so the component body bbox is tight-fitting and doesn't envelop attached devices
+            var filteredBBox = computeFilteredBoundingBox(componentObject, ['io-device', 'connector']);
+            console.log("\uD83D\uDD04 Updated worldBoundingBox for component ".concat(child.uuid, " (filtered): min=[").concat(filteredBBox.min.x.toFixed(2), ", ").concat(filteredBBox.min.y.toFixed(2), ", ").concat(filteredBBox.min.z.toFixed(2), "], max=[").concat(filteredBBox.max.x.toFixed(2), ", ").concat(filteredBBox.max.y.toFixed(2), ", ").concat(filteredBBox.max.z.toFixed(2), "]"));
+            var _bboxData = {
+              min: [filteredBBox.min.x, filteredBBox.min.y, filteredBBox.min.z],
+              max: [filteredBBox.max.x, filteredBBox.max.y, filteredBBox.max.z]
+            };
+
+            // Build the enriched component entry
+            var enrichedChild = _objectSpread2(_objectSpread2({}, child), {}, {
+              // Sync live transform to ensure pathfinder has latest coordinates
+              position: {
                 x: componentObject.position.x,
                 y: componentObject.position.y,
                 z: componentObject.position.z
-              };
-              enrichedNode.rotation = {
+              },
+              rotation: {
                 x: THREE.MathUtils.radToDeg(componentObject.rotation.x),
                 y: THREE.MathUtils.radToDeg(componentObject.rotation.y),
                 z: THREE.MathUtils.radToDeg(componentObject.rotation.z)
-              };
-              enrichedNode.userData = _objectSpread2(_objectSpread2({}, node.userData), {}, {
+              },
+              userData: _objectSpread2(_objectSpread2({}, child.userData), {}, {
                 worldBoundingBox: _bboxData,
                 position: [componentObject.position.x, componentObject.position.y, componentObject.position.z]
+              })
+            });
+
+            // Compute separate bounding boxes for each attached io-device
+            var ioDeviceBBoxes = computeIODeviceBoundingBoxes(componentObject);
+            if (ioDeviceBBoxes.length > 0) {
+              // Ensure children array exists (may already contain connectors)
+              if (!enrichedChild.children) {
+                enrichedChild.children = [];
+              }
+
+              // Inject io-device entries with their own worldBoundingBox
+              ioDeviceBBoxes.forEach(function (deviceBBox) {
+                var existingIndex = enrichedChild.children.findIndex(function (c) {
+                  return c.uuid === deviceBBox.uuid;
+                });
+                if (existingIndex >= 0) {
+                  enrichedChild.children[existingIndex] = _objectSpread2(_objectSpread2({}, enrichedChild.children[existingIndex]), {}, {
+                    position: {
+                      x: deviceBBox.userData.position[0],
+                      y: deviceBBox.userData.position[1],
+                      z: deviceBBox.userData.position[2]
+                    },
+                    userData: _objectSpread2(_objectSpread2({}, enrichedChild.children[existingIndex].userData), {}, {
+                      objectType: 'io-device',
+                      worldBoundingBox: deviceBBox.worldBoundingBox,
+                      position: deviceBBox.userData.position
+                    })
+                  });
+                } else {
+                  enrichedChild.children.push({
+                    uuid: deviceBBox.uuid,
+                    position: {
+                      x: deviceBBox.userData.position[0],
+                      y: deviceBBox.userData.position[1],
+                      z: deviceBBox.userData.position[2]
+                    },
+                    userData: _objectSpread2(_objectSpread2({}, deviceBBox.userData), {}, {
+                      worldBoundingBox: deviceBBox.worldBoundingBox,
+                      position: deviceBBox.userData.position
+                    }),
+                    children: []
+                  });
+                }
+                console.log("\uD83D\uDCE6 Injected io-device bbox for ".concat(deviceBBox.uuid, ": min=[").concat(deviceBBox.worldBoundingBox.min.map(function (v) {
+                  return v.toFixed(2);
+                }).join(', '), "], max=[").concat(deviceBBox.worldBoundingBox.max.map(function (v) {
+                  return v.toFixed(2);
+                }).join(', '), "]"));
               });
-              var connectorBBoxes = computeConnectorBoundingBoxes(componentObject);
-              var ioDeviceBBoxes = computeIODeviceBoundingBoxes(componentObject);
-              if (!enrichedNode.children) enrichedNode.children = [];
-              connectorBBoxes.forEach(function (conn) {
-                return _this4._mergeEnrichedChild(enrichedNode.children, conn);
-              });
-              ioDeviceBBoxes.forEach(function (dev) {
-                return _this4._mergeEnrichedChild(enrichedNode.children, dev);
-              });
-              _this4._bboxCache.set(node.uuid, {
-                matrixHash: _hash,
-                filteredBBox: _bboxData,
-                ioDeviceBBoxes: ioDeviceBBoxes,
-                connectorBBoxes: connectorBBoxes
+              console.log("\uD83D\uDCE6 Injected ".concat(ioDeviceBBoxes.length, " io-device bounding box(es) for component ").concat(child.uuid));
+            }
+
+            // PHASE 2: Enrich Connectors (CRITICAL for pathfinding API)
+            // Also compute world bounding boxes for connectors and inject into children.
+            // This ensures endpoints have world coordinates in sceneDataCopy.
+            var connectorBBoxes = computeConnectorBoundingBoxes(componentObject);
+            if (connectorBBoxes.length > 0) {
+              if (!enrichedChild.children) enrichedChild.children = [];
+              connectorBBoxes.forEach(function (connBBox) {
+                var existingIndex = enrichedChild.children.findIndex(function (c) {
+                  return c.uuid === connBBox.uuid;
+                });
+                if (existingIndex >= 0) {
+                  enrichedChild.children[existingIndex] = _objectSpread2(_objectSpread2({}, enrichedChild.children[existingIndex]), {}, {
+                    position: {
+                      x: connBBox.userData.position[0],
+                      y: connBBox.userData.position[1],
+                      z: connBBox.userData.position[2]
+                    },
+                    userData: _objectSpread2(_objectSpread2({}, enrichedChild.children[existingIndex].userData), {}, {
+                      worldBoundingBox: connBBox.worldBoundingBox,
+                      position: connBBox.userData.position
+                    })
+                  });
+                } else {
+                  enrichedChild.children.push({
+                    uuid: connBBox.uuid,
+                    position: {
+                      x: connBBox.userData.position[0],
+                      y: connBBox.userData.position[1],
+                      z: connBBox.userData.position[2]
+                    },
+                    userData: _objectSpread2(_objectSpread2({}, connBBox.userData), {}, {
+                      worldBoundingBox: connBBox.worldBoundingBox,
+                      position: connBBox.userData.position
+                    }),
+                    children: []
+                  });
+                }
               });
             }
+
+            // Store in cache
+            _this4._bboxCache.set(child.uuid, {
+              matrixHash: _hash,
+              filteredBBox: _bboxData,
+              ioDeviceBBoxes: ioDeviceBBoxes,
+              connectorBBoxes: connectorBBoxes
+            });
+            return enrichedChild;
+          } else {
+            console.warn("\u26A0\uFE0F Could not find component object in scene: ".concat(child.uuid));
           }
         }
 
-        // ── Enrich Standalone Objects (Gateways/Connectors) ──
-        else if (node.userData && (node.userData.objectType === 'gateway' || node.userData.objectType === 'connector')) {
-          var _node$userData;
-          var object = _this4.sceneViewer.scene.getObjectByProperty('uuid', node.uuid) || _this4.sceneViewer.scene.getObjectByProperty('uuid', (_node$userData = node.userData) === null || _node$userData === void 0 ? void 0 : _node$userData.originalUuid);
+        // ────────────────────────────────────────────────────────────────────────
+        // PHASE 3: Handle top-level Gateways and Connectors
+        // ────────────────────────────────────────────────────────────────────────
+        if (child.userData && (child.userData.objectType === 'gateway' || child.userData.objectType === 'connector')) {
+          var _child$userData;
+          var object = _this4.sceneViewer.scene.getObjectByProperty('uuid', child.uuid) || _this4.sceneViewer.scene.getObjectByProperty('uuid', (_child$userData = child.userData) === null || _child$userData === void 0 ? void 0 : _child$userData.originalUuid);
           if (object) {
             var worldPos = new THREE.Vector3();
             object.getWorldPosition(worldPos);
-            enrichedNode.position = {
-              x: worldPos.x,
-              y: worldPos.y,
-              z: worldPos.z
-            };
-            enrichedNode.userData = _objectSpread2(_objectSpread2({}, node.userData), {}, {
-              position: [worldPos.x, worldPos.y, worldPos.z]
+            return _objectSpread2(_objectSpread2({}, child), {}, {
+              // Sync live transform to ensure pathfinder has latest coordinates
+              position: {
+                x: worldPos.x,
+                y: worldPos.y,
+                z: worldPos.z
+              },
+              userData: _objectSpread2(_objectSpread2({}, child.userData), {}, {
+                position: [worldPos.x, worldPos.y, worldPos.z]
+              })
             });
-
-            // If it's a connector, also sync direction
-            if (node.userData.objectType === 'connector') {
-              var worldDir = new THREE.Vector3(0, 0, 1);
-              if (node.userData.direction) worldDir.set(node.userData.direction[0], node.userData.direction[1], node.userData.direction[2]);
-              worldDir.applyQuaternion(object.getWorldQuaternion(new THREE.Quaternion())).normalize();
-              enrichedNode.userData.direction = [worldDir.x, worldDir.y, worldDir.z];
-            }
           }
         }
 
-        // Recurse into children
-        if (node.children && Array.isArray(node.children)) {
-          enrichedNode.children = node.children.map(_enrichNode);
-        }
-        return enrichedNode;
-      };
-
-      // Handle root being an array or object
-      if (Array.isArray(sceneData)) {
-        return sceneData.map(_enrichNode);
-      } else if (sceneData.children && Array.isArray(sceneData.children)) {
-        var enrichedRoot = _objectSpread2({}, sceneData);
-        enrichedRoot.children = sceneData.children.map(_enrichNode);
-        return enrichedRoot;
-      } else {
-        return _enrichNode(sceneData);
-      }
+        // For non-segments and non-components (and if object search failed), return as-is
+        return child;
+      });
+      return enriched;
     }
 
     /**
-     * Helper to merge an enriched child (connector/device) into a children array
-     * @private
+     * Core pathfinding logic shared across initialization and updates
      */
-  }, {
-    key: "_mergeEnrichedChild",
-    value: function _mergeEnrichedChild(childrenArray, enrichedData) {
-      var existingIndex = childrenArray.findIndex(function (c) {
-        return c.uuid === enrichedData.uuid;
-      });
-      var nodeToMerge = {
-        uuid: enrichedData.uuid,
-        position: {
-          x: enrichedData.userData.position[0],
-          y: enrichedData.userData.position[1],
-          z: enrichedData.userData.position[2]
-        },
-        userData: _objectSpread2(_objectSpread2({}, enrichedData.userData), {}, {
-          worldBoundingBox: enrichedData.worldBoundingBox
-        }),
-        children: []
-      };
-      if (existingIndex >= 0) {
-        childrenArray[existingIndex] = _objectSpread2(_objectSpread2({}, childrenArray[existingIndex]), nodeToMerge);
-      } else {
-        childrenArray.push(nodeToMerge);
-      }
-    }
   }, {
     key: "_executePathfinding",
-    value: function () {
+    value: (function () {
       var _executePathfinding2 = _asyncToGenerator(/*#__PURE__*/_regenerator().m(function _callee(sceneData, connections) {
         var _this5 = this,
           _sceneDataCopy$childr,
@@ -574,7 +714,7 @@ var PathfindingManager = /*#__PURE__*/function (_BaseDisposable) {
         return _executePathfinding2.apply(this, arguments);
       }
       return _executePathfinding;
-    }()
+    }())
   }, {
     key: "getSimplifiedSceneData",
     value: function getSimplifiedSceneData() {

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

@@ -2,6 +2,7 @@ import { createClass as _createClass, classCallCheck as _classCallCheck, asyncTo
 import * as THREE from 'three';
 import { OrbitControls } from '../../../node_modules/three/examples/jsm/controls/OrbitControls.js';
 import { GLTFLoader } from '../../../node_modules/three/examples/jsm/loaders/GLTFLoader.js';
+import { DEFAULT_HOME_VIEW_DIRECTION, HOME_EMPTY_CAMERA_HEIGHT_ABOVE_GROUND } from '../controls/cameraControlsManager.js';
 
 var SceneInitializationManager = /*#__PURE__*/function () {
   function SceneInitializationManager(sceneViewer) {
@@ -30,7 +31,7 @@ var SceneInitializationManager = /*#__PURE__*/function () {
               containerWidth = containerRect.width;
               containerHeight = containerRect.height; // Create camera (Z-up coordinate system with flipped Y)
               component.camera = new THREE.PerspectiveCamera(50, containerWidth / containerHeight, 0.01, 1000);
-              component.camera.position.set(-8, -9, 2); // Flipped Y direction
+              component.camera.position.set(DEFAULT_HOME_VIEW_DIRECTION.x, DEFAULT_HOME_VIEW_DIRECTION.y, HOME_EMPTY_CAMERA_HEIGHT_ABOVE_GROUND);
               component.camera.up.set(0, 0, 1); // Set Z as up vector
 
               // Create renderer

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

@@ -3,6 +3,7 @@ import * as THREE from 'three';
 import { loadTextureSet } from '../environment/textureConfig.js';
 import { ModelManager } from './modelManager.js';
 import { SceneClearingUtility } from '../../utils/sceneClearingUtility.js';
+import { DEFAULT_HOME_VIEW_DIRECTION } from '../controls/cameraControlsManager.js';
 
 var _excluded = ["direction"],
   _excluded2 = ["direction"];
@@ -1118,6 +1119,7 @@ var SceneOperationsManager = /*#__PURE__*/function () {
   }, {
     key: "_finalizeScene",
     value: function _finalizeScene(data, crosscubeTextureSet, isImported) {
+      var _component$cameraCont;
       var component = this.sceneViewer;
       component.currentSceneData = data;
       component.crosscubeTextureSet = crosscubeTextureSet;
@@ -1129,6 +1131,14 @@ var SceneOperationsManager = /*#__PURE__*/function () {
         }
         this._setTransformControlsState(true, false); // Enable but keep hidden initially
       }
+
+      // Frame the camera so all components fit perfectly in view (low, ground-level angle)
+      if ((_component$cameraCont = component.cameraControlsManager) !== null && _component$cameraCont !== void 0 && _component$cameraCont.fitCameraToScene) {
+        component.cameraControlsManager.fitCameraToScene({
+          direction: DEFAULT_HOME_VIEW_DIRECTION,
+          groundLevel: true
+        });
+      }
     }
 
     /**

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

@@ -1,4 +1,4 @@
-import { createForOfIteratorHelper as _createForOfIteratorHelper, objectSpread2 as _objectSpread2, construct as _construct, toConsumableArray as _toConsumableArray } from '../../_virtual/_rollupPluginBabelHelpers.js';
+import { objectSpread2 as _objectSpread2, createForOfIteratorHelper as _createForOfIteratorHelper, construct as _construct, toConsumableArray as _toConsumableArray } from '../../_virtual/_rollupPluginBabelHelpers.js';
 import * as THREE from 'three';
 
 /**

package/package.json

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