@2112-lab/central-plant 0.1.4 → 0.1.5

package/dist/cjs/src/helpers/sceneHelper.js

@@ -1 +1,572 @@
-"use strict";Object.defineProperty(exports,"t",{value:!0});var e=require("../../_virtual/_rollupPluginBabelHelpers.js"),t=require("three"),i=require("../core/nameUtils.js");function n(e){if(e&&e.t)return e;var t=Object.create(null);return e&&Object.keys(e).forEach(function(i){if("default"!==i){var n=Object.getOwnPropertyDescriptor(e,i);Object.defineProperty(t,i,n.get?n:{enumerable:!0,get:function(){return e[i]}})}}),t.default=e,Object.freeze(t)}var s=n(t),o=function(){return e.createClass(function t(){var i=arguments.length>0&&void 0!==arguments[0]?arguments[0]:{};e.classCallCheck(this,t),this.scene=i.scene||null,this.camera=i.camera||null,this.renderer=i.renderer||null,this.controls=i.controls||null,this.transformManager=i.transformManager||null,this.componentManager=i.componentManager||null,this.pathfindingManager=i.pathfindingManager||null,this.currentSceneData=i.currentSceneData||null,this.logger=i.logger||console,this.isInitialized=!1,this.selectedObject=null,this.sceneObjects=[],this.logger.info("🔧 SceneHelper initialized")},[{key:"initialize",value:function(e){this.scene=e.scene,this.camera=e.camera,this.renderer=e.renderer,this.controls=e.controls,this.transformManager=e.transformManager,this.componentManager=e.componentManager,this.pathfindingManager=e.pathfindingManager,this.currentSceneData=e.currentSceneData,this.isInitialized=!0,this.logger.info("✅ SceneHelper initialized with scene components")}},{key:"updateSceneData",value:function(e){this.currentSceneData=e}},{key:"isReady",value:function(){return this.isInitialized&&this.scene&&this.camera&&this.renderer}},{key:"getSceneObjects",value:function(){var t=arguments.length>0&&void 0!==arguments[0]?arguments[0]:{};if(!this.scene)return this.logger.warn("⚠️ Scene not available for object retrieval"),[];var n=t.includeComponents,s=void 0===n||n,o=t.includeConnectors,r=void 0===o||o,l=t.includeGateways,u=void 0===l||l,a=t.includeHelpers,c=void 0!==a&&a,h=t.includeInvisible,v=void 0!==h&&h,f=t.componentTypesFilter,d=void 0===f?null:f,b=[];return this.scene.traverse(function(t){if(t.userData){var n=t.userData.componentType,o=t.visible;(v||o)&&("component"!==n||s)&&("connector"!==n||r)&&("gateway"!==n||u)&&("helper"!==n||c)&&(d&&Array.isArray(d)&&!d.includes(n)||t.name&&(t.name.includes("helper")||t.name.includes("Helper")||t.name.includes("controls")||"CameraGimbal"===t.name||"GridHelper"===t.type||"AxesHelper"===t.type)||b.push({uuid:i.getHardcodedUuid(t),name:t.name||"Unnamed Object",type:t.type,object:t,componentType:n,position:t.position.clone(),rotation:t.rotation.clone(),scale:t.scale.clone(),visible:o,userData:e.objectSpread2({},t.userData)}))}}),b}},{key:"getSceneObjectsHierarchy",value:function(){if(!this.scene)return this.logger.warn("⚠️ Scene not available for hierarchy retrieval"),[];var e=function(t){var n,s=arguments.length>1&&void 0!==arguments[1]?arguments[1]:0;if(t.name&&(t.name.includes("helper")||t.name.includes("Helper")||t.name.includes("controls")||"CameraGimbal"===t.name)||"GridHelper"===t.type||"AxesHelper"===t.type)return null;var o=null===(n=t.userData)||void 0===n?void 0:n.componentType;if(!("Scene"===t.type||"component"===o||"connector"===o||"gateway"===o)&&"Scene"!==t.type)return null;var r={uuid:i.getHardcodedUuid(t),name:t.name||"Unnamed Object",type:t.type,object:t,componentType:o||"other",level:s,visible:t.visible,children:[]};return t.children&&t.children.length>0&&t.children.forEach(function(t){var i=e(t,s+1);i&&r.children.push(i)}),r},t=[];return this.scene.children&&this.scene.children.length>0&&this.scene.children.forEach(function(i){var n=e(i,0);n&&t.push(n)}),t}},{key:"findObjectByUuid",value:function(e){if(!this.scene||!e)return null;var t=null;return this.scene.traverse(function(n){i.getHardcodedUuid(n)!==e||(t=n)}),t}},{key:"findObjectsByName",value:function(e){var t=arguments.length>1&&void 0!==arguments[1]&&arguments[1];if(!this.scene||!e)return[];var i=[];return this.scene.traverse(function(n){n.name&&((t?n.name===e:n.name.toLowerCase().includes(e.toLowerCase()))&&i.push(n))}),i}},{key:"findObjectsByComponentType",value:function(e){if(!this.scene||!e)return[];var t=[];return this.scene.traverse(function(i){var n;(null===(n=i.userData)||void 0===n?void 0:n.componentType)===e&&t.push(i)}),t}},{key:"isSelectableObject",value:function(e){var t;if(!e||!e.parent)return!1;var i=null===(t=e.userData)||void 0===t?void 0:t.componentType,n="component"===i,s="connector"===i,o="gateway"===i;return(e.isMesh||e.isObject3D)&&e.visible&&(n||s||o)}},{key:"selectObject",value:function(e){return e&&this.isSelectableObject(e)?(this.selectedObject=e,this.transformManager&&this.transformManager.selectObject(e),this.logger.info("✅ Object selected: ".concat(e.name," (").concat(e.uuid,")")),!0):(this.logger.warn("⚠️ Cannot select invalid object"),!1)}},{key:"deselectObject",value:function(){this.transformManager&&this.transformManager.deselectObject(),this.selectedObject=null,this.logger.info("✅ Object deselected")}},{key:"getSelectedObject",value:function(){return this.selectedObject}},{key:"getSelectedTransform",value:function(){return this.transformManager&&this.selectedObject?this.transformManager.getTransformData():null}},{key:"focusOnObject",value:function(e){var t=arguments.length>1&&void 0!==arguments[1]?arguments[1]:{};if(e&&this.camera&&this.controls){var i=t.distance,n=void 0===i?10:i,o=t.animate,r=void 0===o||o,l=t.duration,u=void 0===l?1e3:l,a=new s.Vector3;e.getWorldPosition(a);var c=a.clone().add(new s.Vector3(n,n,n));r&&this.controls.transitionTo?this.controls.transitionTo(c,a,u):(this.camera.position.copy(c),this.camera.lookAt(a),this.controls.target&&(this.controls.target.copy(a),this.controls.update())),this.logger.info("🎥 Camera focused on object: ".concat(e.name))}else this.logger.warn("⚠️ Cannot focus on object: missing components")}},{key:"fitAllObjectsInView",value:function(){if(this.camera&&this.controls){var e=new s.Box3,t=this.getSceneObjects({includeHelpers:!1});if(0!==t.length){t.forEach(function(t){var i=t.object;e.expandByObject(i)});var i=e.getCenter(new s.Vector3),n=e.getSize(new s.Vector3),o=Math.max(n.x,n.y,n.z)/(2*Math.tan(Math.PI*this.camera.fov/360));this.camera.position.copy(i),this.camera.position.z+=1.5*o,this.controls.target&&(this.controls.target.copy(i),this.controls.update()),this.logger.info("🎥 Camera fitted to ".concat(t.length," objects"))}else this.logger.warn("⚠️ No objects to fit in view")}else this.logger.warn("⚠️ Cannot fit objects in view: missing camera or controls")}},{key:"getComponentsWithDimensions",value:function(){if(!this.currentSceneData)return[];var e=[];return this.scene.traverse(function(t){t.userData&&"component"===t.userData.componentType&&t.userData.dimensions&&e.push({name:t.name||"Unnamed Component",uuid:i.getHardcodedUuid(t),position:t.position.clone(),rotation:t.rotation.clone(),dimensions:t.userData.dimensions,boundingBox:t.userData.adaptedBoundingBox,libraryId:t.userData.libraryId,object:t})}),e}},{key:"getSceneStats",value:function(){if(!this.scene)return{};var e={totalObjects:0,components:0,connectors:0,gateways:0,meshes:0,materials:0,textures:0,lights:0,cameras:0};return this.scene.traverse(function(t){var i,n,s;e.totalObjects++,"component"===(null===(i=t.userData)||void 0===i?void 0:i.componentType)&&e.components++,"connector"===(null===(n=t.userData)||void 0===n?void 0:n.componentType)&&e.connectors++,"gateway"===(null===(s=t.userData)||void 0===s?void 0:s.componentType)&&e.gateways++,t.isMesh&&e.meshes++,t.isLight&&e.lights++,t.isCamera&&e.cameras++,t.material&&e.materials++}),e}},{key:"debugSceneInfo",value:function(){var e,t=this.getSceneStats(),i=this.getSceneObjects();this.logger.info("🔍 Scene Debug Information:"),this.logger.info("  Statistics:",t),this.logger.info("  Objects:",i.length),this.logger.info("  Selected:",(null===(e=this.selectedObject)||void 0===e?void 0:e.name)||"None"),this.logger.info("  Scene Data:",this.currentSceneData?"Available":"Not Available")}},{key:"hasVisibleObjects",value:function(){var e=this;if(!this.scene)return!1;var t=!1;return this.scene.traverse(function(i){var n;i.visible&&null!==(n=i.userData)&&void 0!==n&&n.componentType&&i!==e.scene&&(t=!0)}),t}},{key:"dispose",value:function(){this.scene=null,this.camera=null,this.renderer=null,this.controls=null,this.transformManager=null,this.componentManager=null,this.pathfindingManager=null,this.currentSceneData=null,this.selectedObject=null,this.sceneObjects=[],this.isInitialized=!1,this.logger.info("🧹 SceneHelper disposed")}}])}();exports.SceneHelper=o,exports.default=o;
+'use strict';
+
+Object.defineProperty(exports, '__esModule', { value: true });
+
+var _rollupPluginBabelHelpers = require('../../_virtual/_rollupPluginBabelHelpers.js');
+var THREE = require('three');
+var nameUtils = require('../core/nameUtils.js');
+
+function _interopNamespace(e) {
+  if (e && e.__esModule) return e;
+  var n = Object.create(null);
+  if (e) {
+    Object.keys(e).forEach(function (k) {
+      if (k !== 'default') {
+        var d = Object.getOwnPropertyDescriptor(e, k);
+        Object.defineProperty(n, k, d.get ? d : {
+          enumerable: true,
+          get: function () { return e[k]; }
+        });
+      }
+    });
+  }
+  n["default"] = e;
+  return Object.freeze(n);
+}
+
+var THREE__namespace = /*#__PURE__*/_interopNamespace(THREE);
+
+var SceneHelper = /*#__PURE__*/function () {
+  function SceneHelper() {
+    var options = arguments.length > 0 && arguments[0] !== undefined ? arguments[0] : {};
+    _rollupPluginBabelHelpers.classCallCheck(this, SceneHelper);
+    // Core Three.js references
+    this.scene = options.scene || null;
+    this.camera = options.camera || null;
+    this.renderer = options.renderer || null;
+    this.controls = options.controls || null;
+
+    // Manager references
+    this.transformManager = options.transformManager || null;
+    this.componentManager = options.componentManager || null;
+    this.pathfindingManager = options.pathfindingManager || null;
+
+    // Scene data
+    this.currentSceneData = options.currentSceneData || null;
+
+    // Logger
+    this.logger = options.logger || console;
+
+    // Initialize state
+    this.isInitialized = false;
+    this.selectedObject = null;
+    this.sceneObjects = [];
+    this.logger.info('🔧 SceneHelper initialized');
+  }
+
+  /**
+   * Initialize the scene helper with Three.js components
+   * @param {Object} components - Object containing scene, camera, renderer, etc.
+   */
+  return _rollupPluginBabelHelpers.createClass(SceneHelper, [{
+    key: "initialize",
+    value: function initialize(components) {
+      this.scene = components.scene;
+      this.camera = components.camera;
+      this.renderer = components.renderer;
+      this.controls = components.controls;
+      this.transformManager = components.transformManager;
+      this.componentManager = components.componentManager;
+      this.pathfindingManager = components.pathfindingManager;
+      this.currentSceneData = components.currentSceneData;
+      this.isInitialized = true;
+      this.logger.info('✅ SceneHelper initialized with scene components');
+    }
+
+    /**
+     * Update scene data reference
+     * @param {Object} sceneData - Current scene data
+     */
+  }, {
+    key: "updateSceneData",
+    value: function updateSceneData(sceneData) {
+      this.currentSceneData = sceneData;
+    }
+
+    /**
+     * Check if the scene helper is properly initialized
+     * @returns {boolean} True if initialized
+     */
+  }, {
+    key: "isReady",
+    value: function isReady() {
+      return this.isInitialized && this.scene && this.camera && this.renderer;
+    }
+
+    // ===== SCENE OBJECT OPERATIONS =====
+
+    /**
+     * Get all scene objects with filtering options
+     * @param {Object} options - Filtering options
+     * @returns {Array} Array of scene objects
+     */
+  }, {
+    key: "getSceneObjects",
+    value: function getSceneObjects() {
+      var options = arguments.length > 0 && arguments[0] !== undefined ? arguments[0] : {};
+      if (!this.scene) {
+        this.logger.warn('⚠️ Scene not available for object retrieval');
+        return [];
+      }
+      var _options$includeCompo = options.includeComponents,
+        includeComponents = _options$includeCompo === void 0 ? true : _options$includeCompo,
+        _options$includeConne = options.includeConnectors,
+        includeConnectors = _options$includeConne === void 0 ? true : _options$includeConne,
+        _options$includeGatew = options.includeGateways,
+        includeGateways = _options$includeGatew === void 0 ? true : _options$includeGatew,
+        _options$includeHelpe = options.includeHelpers,
+        includeHelpers = _options$includeHelpe === void 0 ? false : _options$includeHelpe,
+        _options$includeInvis = options.includeInvisible,
+        includeInvisible = _options$includeInvis === void 0 ? false : _options$includeInvis,
+        _options$componentTyp = options.componentTypesFilter,
+        componentTypesFilter = _options$componentTyp === void 0 ? null : _options$componentTyp;
+      var objects = [];
+      this.scene.traverse(function (object) {
+        // Skip objects without valid userData
+        if (!object.userData) return;
+        var componentType = object.userData.componentType;
+        var isVisible = object.visible;
+
+        // Apply visibility filter
+        if (!includeInvisible && !isVisible) return;
+
+        // Apply component type filters
+        if (componentType === 'component' && !includeComponents) return;
+        if (componentType === 'connector' && !includeConnectors) return;
+        if (componentType === 'gateway' && !includeGateways) return;
+        if (componentType === 'helper' && !includeHelpers) return;
+
+        // Apply specific component types filter
+        if (componentTypesFilter && Array.isArray(componentTypesFilter)) {
+          if (!componentTypesFilter.includes(componentType)) return;
+        }
+
+        // Skip internal objects and helpers by name
+        if (object.name && (object.name.includes('helper') || object.name.includes('Helper') || object.name.includes('controls') || object.name === 'CameraGimbal' || object.type === 'GridHelper' || object.type === 'AxesHelper')) {
+          return;
+        }
+        objects.push({
+          uuid: nameUtils.getHardcodedUuid(object),
+          name: object.name || 'Unnamed Object',
+          type: object.type,
+          object: object,
+          componentType: componentType,
+          position: object.position.clone(),
+          rotation: object.rotation.clone(),
+          scale: object.scale.clone(),
+          visible: isVisible,
+          userData: _rollupPluginBabelHelpers.objectSpread2({}, object.userData)
+        });
+      });
+      return objects;
+    }
+
+    /**
+     * Get scene objects in a hierarchical structure
+     * @param {Object} options - Filtering options
+     * @returns {Array} Hierarchical array of scene objects
+     */
+  }, {
+    key: "getSceneObjectsHierarchy",
+    value: function getSceneObjectsHierarchy() {
+      if (!this.scene) {
+        this.logger.warn('⚠️ Scene not available for hierarchy retrieval');
+        return [];
+      }
+      var _createHierarchy = function createHierarchy(object) {
+        var _object$userData;
+        var level = arguments.length > 1 && arguments[1] !== undefined ? arguments[1] : 0;
+        // Skip internal objects and helpers
+        if (object.name && (object.name.includes('helper') || object.name.includes('Helper') || object.name.includes('controls') || object.name === 'CameraGimbal') || object.type === 'GridHelper' || object.type === 'AxesHelper') {
+          return null;
+        }
+        var componentType = (_object$userData = object.userData) === null || _object$userData === void 0 ? void 0 : _object$userData.componentType;
+        var shouldInclude = object.type === 'Scene' || componentType === 'component' || componentType === 'connector' || componentType === 'gateway';
+        if (!shouldInclude && object.type !== 'Scene') {
+          return null;
+        }
+        var hierarchyItem = {
+          uuid: nameUtils.getHardcodedUuid(object),
+          name: object.name || 'Unnamed Object',
+          type: object.type,
+          object: object,
+          componentType: componentType || 'other',
+          level: level,
+          visible: object.visible,
+          children: []
+        };
+
+        // Process children
+        if (object.children && object.children.length > 0) {
+          object.children.forEach(function (child) {
+            var childItem = _createHierarchy(child, level + 1);
+            if (childItem) {
+              hierarchyItem.children.push(childItem);
+            }
+          });
+        }
+        return hierarchyItem;
+      };
+
+      // Start from scene children to avoid including the scene root
+      var hierarchy = [];
+      if (this.scene.children && this.scene.children.length > 0) {
+        this.scene.children.forEach(function (child) {
+          var childItem = _createHierarchy(child, 0);
+          if (childItem) {
+            hierarchy.push(childItem);
+          }
+        });
+      }
+      return hierarchy;
+    }
+
+    /**
+     * Find an object in the scene by UUID
+     * @param {string} uuid - Object UUID to find
+     * @returns {Object|null} Found object or null
+     */
+  }, {
+    key: "findObjectByUuid",
+    value: function findObjectByUuid(uuid) {
+      if (!this.scene || !uuid) return null;
+      var foundObject = null;
+      this.scene.traverse(function (object) {
+        if (nameUtils.getHardcodedUuid(object) === uuid) {
+          foundObject = object;
+          return; // Stop traversal
+        }
+      });
+      return foundObject;
+    }
+
+    /**
+     * Find objects by name (supports partial matching)
+     * @param {string} name - Object name to search for
+     * @param {boolean} exactMatch - Whether to use exact matching
+     * @returns {Array} Array of matching objects
+     */
+  }, {
+    key: "findObjectsByName",
+    value: function findObjectsByName(name) {
+      var exactMatch = arguments.length > 1 && arguments[1] !== undefined ? arguments[1] : false;
+      if (!this.scene || !name) return [];
+      var foundObjects = [];
+      this.scene.traverse(function (object) {
+        if (object.name) {
+          var matches = exactMatch ? object.name === name : object.name.toLowerCase().includes(name.toLowerCase());
+          if (matches) {
+            foundObjects.push(object);
+          }
+        }
+      });
+      return foundObjects;
+    }
+
+    /**
+     * Find objects by component type
+     * @param {string} componentType - Component type to search for
+     * @returns {Array} Array of matching objects
+     */
+  }, {
+    key: "findObjectsByComponentType",
+    value: function findObjectsByComponentType(componentType) {
+      if (!this.scene || !componentType) return [];
+      var foundObjects = [];
+      this.scene.traverse(function (object) {
+        var _object$userData2;
+        if (((_object$userData2 = object.userData) === null || _object$userData2 === void 0 ? void 0 : _object$userData2.componentType) === componentType) {
+          foundObjects.push(object);
+        }
+      });
+      return foundObjects;
+    }
+
+    // ===== OBJECT SELECTION AND TRANSFORM =====
+
+    /**
+     * Check if an object is selectable for transformation
+     * @param {Object} object - Three.js object to check
+     * @returns {boolean} True if object can be selected
+     */
+  }, {
+    key: "isSelectableObject",
+    value: function isSelectableObject(object) {
+      var _object$userData3;
+      if (!object || !object.parent) return false;
+
+      // Check for different component types
+      var componentType = (_object$userData3 = object.userData) === null || _object$userData3 === void 0 ? void 0 : _object$userData3.componentType;
+      var isComponent = componentType === 'component';
+      var isConnector = componentType === 'connector';
+      var isGateway = componentType === 'gateway';
+
+      // Check if it's a valid mesh or object3D
+      var isValidType = (object.isMesh || object.isObject3D) && object.visible;
+      return isValidType && (isComponent || isConnector || isGateway);
+    }
+
+    /**
+     * Select an object for transformation
+     * @param {Object} object - Three.js object to select
+     * @returns {boolean} True if selection was successful
+     */
+  }, {
+    key: "selectObject",
+    value: function selectObject(object) {
+      if (!object || !this.isSelectableObject(object)) {
+        this.logger.warn('⚠️ Cannot select invalid object');
+        return false;
+      }
+      this.selectedObject = object;
+
+      // Use transform manager if available
+      if (this.transformManager) {
+        this.transformManager.selectObject(object);
+      }
+      this.logger.info("\u2705 Object selected: ".concat(object.name, " (").concat(object.uuid, ")"));
+      return true;
+    }
+
+    /**
+     * Deselect the currently selected object
+     */
+  }, {
+    key: "deselectObject",
+    value: function deselectObject() {
+      if (this.transformManager) {
+        this.transformManager.deselectObject();
+      }
+      this.selectedObject = null;
+      this.logger.info('✅ Object deselected');
+    }
+
+    /**
+     * Get the currently selected object
+     * @returns {Object|null} Selected object or null
+     */
+  }, {
+    key: "getSelectedObject",
+    value: function getSelectedObject() {
+      return this.selectedObject;
+    }
+
+    /**
+     * Get transform data for the selected object
+     * @returns {Object|null} Transform data or null
+     */
+  }, {
+    key: "getSelectedTransform",
+    value: function getSelectedTransform() {
+      if (!this.transformManager || !this.selectedObject) return null;
+      return this.transformManager.getTransformData();
+    }
+
+    // ===== CAMERA AND VIEWPORT OPERATIONS =====
+
+    /**
+     * Focus camera on an object
+     * @param {Object} object - Three.js object to focus on
+     * @param {Object} options - Focus options
+     */
+  }, {
+    key: "focusOnObject",
+    value: function focusOnObject(object) {
+      var options = arguments.length > 1 && arguments[1] !== undefined ? arguments[1] : {};
+      if (!object || !this.camera || !this.controls) {
+        this.logger.warn('⚠️ Cannot focus on object: missing components');
+        return;
+      }
+      var _options$distance = options.distance,
+        distance = _options$distance === void 0 ? 10 : _options$distance,
+        _options$animate = options.animate,
+        animate = _options$animate === void 0 ? true : _options$animate,
+        _options$duration = options.duration,
+        duration = _options$duration === void 0 ? 1000 : _options$duration;
+
+      // Get object world position
+      var objectPosition = new THREE__namespace.Vector3();
+      object.getWorldPosition(objectPosition);
+
+      // Calculate camera position
+      var cameraPosition = objectPosition.clone().add(new THREE__namespace.Vector3(distance, distance, distance));
+      if (animate && this.controls.transitionTo) {
+        // Animate camera transition if supported
+        this.controls.transitionTo(cameraPosition, objectPosition, duration);
+      } else {
+        // Immediate camera positioning
+        this.camera.position.copy(cameraPosition);
+        this.camera.lookAt(objectPosition);
+        if (this.controls.target) {
+          this.controls.target.copy(objectPosition);
+          this.controls.update();
+        }
+      }
+      this.logger.info("\uD83C\uDFA5 Camera focused on object: ".concat(object.name));
+    }
+
+    /**
+     * Fit all objects in camera view
+     */
+  }, {
+    key: "fitAllObjectsInView",
+    value: function fitAllObjectsInView() {
+      if (!this.camera || !this.controls) {
+        this.logger.warn('⚠️ Cannot fit objects in view: missing camera or controls');
+        return;
+      }
+      var box = new THREE__namespace.Box3();
+      var objects = this.getSceneObjects({
+        includeHelpers: false
+      });
+      if (objects.length === 0) {
+        this.logger.warn('⚠️ No objects to fit in view');
+        return;
+      }
+
+      // Calculate bounding box of all objects
+      objects.forEach(function (_ref) {
+        var object = _ref.object;
+        box.expandByObject(object);
+      });
+
+      // Calculate center and size
+      var center = box.getCenter(new THREE__namespace.Vector3());
+      var size = box.getSize(new THREE__namespace.Vector3());
+
+      // Calculate distance needed to fit all objects
+      var maxDim = Math.max(size.x, size.y, size.z);
+      var distance = maxDim / (2 * Math.tan(Math.PI * this.camera.fov / 360));
+
+      // Position camera
+      this.camera.position.copy(center);
+      this.camera.position.z += distance * 1.5;
+      if (this.controls.target) {
+        this.controls.target.copy(center);
+        this.controls.update();
+      }
+      this.logger.info("\uD83C\uDFA5 Camera fitted to ".concat(objects.length, " objects"));
+    }
+
+    // ===== SCENE DATA OPERATIONS =====
+
+    /**
+     * Get components with dimensions from scene data
+     * @returns {Array} Array of components with dimension data
+     */
+  }, {
+    key: "getComponentsWithDimensions",
+    value: function getComponentsWithDimensions() {
+      if (!this.currentSceneData) return [];
+      var components = [];
+      this.scene.traverse(function (object) {
+        if (object.userData && object.userData.componentType === 'component' && object.userData.dimensions) {
+          components.push({
+            name: object.name || 'Unnamed Component',
+            uuid: nameUtils.getHardcodedUuid(object),
+            position: object.position.clone(),
+            rotation: object.rotation.clone(),
+            dimensions: object.userData.dimensions,
+            boundingBox: object.userData.adaptedBoundingBox,
+            libraryId: object.userData.libraryId,
+            object: object
+          });
+        }
+      });
+      return components;
+    }
+
+    /**
+     * Get scene statistics
+     * @returns {Object} Scene statistics
+     */
+  }, {
+    key: "getSceneStats",
+    value: function getSceneStats() {
+      if (!this.scene) return {};
+      var stats = {
+        totalObjects: 0,
+        components: 0,
+        connectors: 0,
+        gateways: 0,
+        meshes: 0,
+        materials: 0,
+        textures: 0,
+        lights: 0,
+        cameras: 0
+      };
+      this.scene.traverse(function (object) {
+        var _object$userData4, _object$userData5, _object$userData6;
+        stats.totalObjects++;
+        if (((_object$userData4 = object.userData) === null || _object$userData4 === void 0 ? void 0 : _object$userData4.componentType) === 'component') stats.components++;
+        if (((_object$userData5 = object.userData) === null || _object$userData5 === void 0 ? void 0 : _object$userData5.componentType) === 'connector') stats.connectors++;
+        if (((_object$userData6 = object.userData) === null || _object$userData6 === void 0 ? void 0 : _object$userData6.componentType) === 'gateway') stats.gateways++;
+        if (object.isMesh) stats.meshes++;
+        if (object.isLight) stats.lights++;
+        if (object.isCamera) stats.cameras++;
+        if (object.material) stats.materials++;
+      });
+      return stats;
+    }
+
+    // ===== UTILITY METHODS =====
+
+    /**
+     * Log scene information for debugging
+     */
+  }, {
+    key: "debugSceneInfo",
+    value: function debugSceneInfo() {
+      var _this$selectedObject;
+      var stats = this.getSceneStats();
+      var objects = this.getSceneObjects();
+      this.logger.info('🔍 Scene Debug Information:');
+      this.logger.info('  Statistics:', stats);
+      this.logger.info('  Objects:', objects.length);
+      this.logger.info('  Selected:', ((_this$selectedObject = this.selectedObject) === null || _this$selectedObject === void 0 ? void 0 : _this$selectedObject.name) || 'None');
+      this.logger.info('  Scene Data:', this.currentSceneData ? 'Available' : 'Not Available');
+    }
+
+    /**
+     * Check if scene has any visible objects
+     * @returns {boolean} True if scene has visible objects
+     */
+  }, {
+    key: "hasVisibleObjects",
+    value: function hasVisibleObjects() {
+      var _this = this;
+      if (!this.scene) return false;
+      var hasVisible = false;
+      this.scene.traverse(function (object) {
+        var _object$userData7;
+        if (object.visible && (_object$userData7 = object.userData) !== null && _object$userData7 !== void 0 && _object$userData7.componentType && object !== _this.scene) {
+          hasVisible = true;
+        }
+      });
+      return hasVisible;
+    }
+
+    /**
+     * Dispose of the scene helper
+     */
+  }, {
+    key: "dispose",
+    value: function dispose() {
+      this.scene = null;
+      this.camera = null;
+      this.renderer = null;
+      this.controls = null;
+      this.transformManager = null;
+      this.componentManager = null;
+      this.pathfindingManager = null;
+      this.currentSceneData = null;
+      this.selectedObject = null;
+      this.sceneObjects = [];
+      this.isInitialized = false;
+      this.logger.info('🧹 SceneHelper disposed');
+    }
+  }]);
+}();
+
+exports.SceneHelper = SceneHelper;
+exports["default"] = SceneHelper;

package/dist/cjs/src/index.js

@@ -1 +1,69 @@
-"use strict";Object.defineProperty(exports,"o",{value:!0});var e=require("./core/centralPlant.js"),r=require("./core/debugLogger.js"),s=require("./core/nameUtils.js"),a=require("./core/mathUtils.js"),n=require("./managers/scene/sceneInitializationManager.js"),o=require("./managers/scene/sceneOperationsManager.js"),t=require("./managers/scene/sceneExportManager.js"),i=require("./managers/scene/sceneTooltipsManager.js"),p=require("./managers/components/componentManager.js"),g=require("./managers/components/animationManager.js"),x=require("./managers/components/pathfindingManager.js"),m=require("./managers/controls/transformControlsManager.js"),u=require("./managers/controls/keyboardControlsManager.js"),j=require("./managers/controls/cameraControlsManager.js"),q=require("./managers/controls/dragDropManager.js"),c=require("./managers/environment/environmentManager.js"),l=require("./managers/environment/textureConfig.js"),d=require("./managers/system/hotReloadManager.js"),M=require("./managers/system/disposalManager.js"),y=require("./managers/system/performanceMonitor.js"),v=require("./rendering/modelPreloader.js"),f=require("./rendering/rendering2D.js"),C=require("./rendering/rendering3D.js"),b=require("./data/import.js"),h=require("./data/export.js"),D=require("./data/numerics.js"),O=require("./analysis/analysis.js"),P=require("./analysis/testing.js");exports.CentralPlant=e.CentralPlant,exports.DebugLogger=r.DebugLogger,exports.logger=r.logger,exports.modelLogger=r.modelLogger,exports.pathfinderLogger=r.pathfinderLogger,exports.transformLogger=r.transformLogger,exports.findObjectByHardcodedUuid=s.findObjectByHardcodedUuid,exports.generateUuidFromName=s.generateUuidFromName,exports.getHardcodedUuid=s.getHardcodedUuid,exports.MathUtils=a.MathUtils,exports.SceneInitializationManager=n.SceneInitializationManager,exports.SceneOperationsManager=o.SceneOperationsManager,exports.SceneExportManager=t.SceneExportManager,exports.SceneTooltipsManager=i.SceneTooltipsManager,exports.ComponentManager=p.ComponentManager,exports.AnimationManager=g.AnimationManager,exports.PathfindingManager=x.PathfindingManager,exports.createTransformControls=m.createTransformControls,exports.KeyboardControlsManager=u.KeyboardControlsManager,exports.CameraControlsManager=j.CameraControlsManager,exports.DragDropManager=q.default,exports.EnvironmentManager=c.EnvironmentManager,exports.loadTextureSetAndCreateMaterial=l.loadTextureSetAndCreateMaterial,exports.HotReloadManager=d.HotReloadManager,exports.DisposalManager=M.DisposalManager,exports.PerformanceMonitor=y.PerformanceMonitor,exports.modelPreloader=v.default,exports.Rendering2D=f,exports.Rendering3D=C,exports.ImportUtils=b,exports.ExportUtils=h,exports.Numerics=D,exports.Analysis=O,exports.Testing=P;
+'use strict';
+
+Object.defineProperty(exports, '__esModule', { value: true });
+
+var centralPlant = require('./core/centralPlant.js');
+var debugLogger = require('./core/debugLogger.js');
+var nameUtils = require('./core/nameUtils.js');
+var mathUtils = require('./core/mathUtils.js');
+var sceneInitializationManager = require('./managers/scene/sceneInitializationManager.js');
+var sceneOperationsManager = require('./managers/scene/sceneOperationsManager.js');
+var sceneExportManager = require('./managers/scene/sceneExportManager.js');
+var sceneTooltipsManager = require('./managers/scene/sceneTooltipsManager.js');
+var componentManager = require('./managers/components/componentManager.js');
+var animationManager = require('./managers/components/animationManager.js');
+var pathfindingManager = require('./managers/components/pathfindingManager.js');
+var transformControlsManager = require('./managers/controls/transformControlsManager.js');
+var keyboardControlsManager = require('./managers/controls/keyboardControlsManager.js');
+var cameraControlsManager = require('./managers/controls/cameraControlsManager.js');
+var dragDropManager = require('./managers/controls/dragDropManager.js');
+var environmentManager = require('./managers/environment/environmentManager.js');
+var textureConfig = require('./managers/environment/textureConfig.js');
+var hotReloadManager = require('./managers/system/hotReloadManager.js');
+var disposalManager = require('./managers/system/disposalManager.js');
+var performanceMonitor = require('./managers/system/performanceMonitor.js');
+var modelPreloader = require('./rendering/modelPreloader.js');
+var rendering2D = require('./rendering/rendering2D.js');
+var rendering3D = require('./rendering/rendering3D.js');
+var _import = require('./data/import.js');
+var _export = require('./data/export.js');
+var numerics = require('./data/numerics.js');
+var analysis = require('./analysis/analysis.js');
+var testing = require('./analysis/testing.js');
+
+
+
+exports.CentralPlant = centralPlant.CentralPlant;
+exports.DebugLogger = debugLogger.DebugLogger;
+exports.logger = debugLogger.logger;
+exports.modelLogger = debugLogger.modelLogger;
+exports.pathfinderLogger = debugLogger.pathfinderLogger;
+exports.transformLogger = debugLogger.transformLogger;
+exports.findObjectByHardcodedUuid = nameUtils.findObjectByHardcodedUuid;
+exports.generateUuidFromName = nameUtils.generateUuidFromName;
+exports.getHardcodedUuid = nameUtils.getHardcodedUuid;
+exports.MathUtils = mathUtils.MathUtils;
+exports.SceneInitializationManager = sceneInitializationManager.SceneInitializationManager;
+exports.SceneOperationsManager = sceneOperationsManager.SceneOperationsManager;
+exports.SceneExportManager = sceneExportManager.SceneExportManager;
+exports.SceneTooltipsManager = sceneTooltipsManager.SceneTooltipsManager;
+exports.ComponentManager = componentManager.ComponentManager;
+exports.AnimationManager = animationManager.AnimationManager;
+exports.PathfindingManager = pathfindingManager.PathfindingManager;
+exports.createTransformControls = transformControlsManager.createTransformControls;
+exports.KeyboardControlsManager = keyboardControlsManager.KeyboardControlsManager;
+exports.CameraControlsManager = cameraControlsManager.CameraControlsManager;
+exports.DragDropManager = dragDropManager["default"];
+exports.EnvironmentManager = environmentManager.EnvironmentManager;
+exports.loadTextureSetAndCreateMaterial = textureConfig.loadTextureSetAndCreateMaterial;
+exports.HotReloadManager = hotReloadManager.HotReloadManager;
+exports.DisposalManager = disposalManager.DisposalManager;
+exports.PerformanceMonitor = performanceMonitor.PerformanceMonitor;
+exports.modelPreloader = modelPreloader["default"];
+exports.Rendering2D = rendering2D;
+exports.Rendering3D = rendering3D;
+exports.ImportUtils = _import;
+exports.ExportUtils = _export;
+exports.Numerics = numerics;
+exports.Analysis = analysis;
+exports.Testing = testing;