@2112-lab/central-plant 0.3.13 → 0.3.15

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

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

package/dist/cjs/src/managers/pathfinding/PathRenderingManager.js

@@ -112,7 +112,11 @@ var PathRenderingManager = /*#__PURE__*/function (_BaseDisposable) {
   }, {
     key: "createGateways",
     value: function createGateways(pathfindingResult) {
-      var _this2 = this;
+      var _this$sceneViewer$man,
+        _this$sceneViewer,
+        _this2 = this;
+      // Check current gateway visibility setting
+      var showGateways = (_this$sceneViewer$man = (_this$sceneViewer = this.sceneViewer) === null || _this$sceneViewer === void 0 || (_this$sceneViewer = _this$sceneViewer.managers) === null || _this$sceneViewer === void 0 || (_this$sceneViewer = _this$sceneViewer.settingsManager) === null || _this$sceneViewer === void 0 ? void 0 : _this$sceneViewer.getSetting('scene', 'showGatewaySpheres')) !== null && _this$sceneViewer$man !== void 0 ? _this$sceneViewer$man : true;
       pathfindingResult.gateways.forEach(function (gateway) {
         if (!gateway.position) {
           console.warn("\u26A0\uFE0F Gateway ".concat(gateway.id, " missing position, skipping creation"));
@@ -157,6 +161,9 @@ var PathRenderingManager = /*#__PURE__*/function (_BaseDisposable) {
           }
         };
 
+        // Apply current visibility setting
+        gatewayMesh.visible = showGateways;
+
         // Add to scene
         _this2.sceneViewer.scene.add(gatewayMesh);
         console.log("\uD83D\uDD27 Created gateway: ".concat(gateway.id, " at [").concat(gatewayMesh.position.x.toFixed(2), ", ").concat(gatewayMesh.position.y.toFixed(2), ", ").concat(gatewayMesh.position.z.toFixed(2), "]"));

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

@@ -7,6 +7,7 @@ var THREE = require('three');
 var ioDeviceUtils = require('../../utils/ioDeviceUtils.js');
 var modelPreloader = require('../../rendering/modelPreloader.js');
 var boundingBoxUtils = require('../../utils/boundingBoxUtils.js');
+var viewport2DManager = require('./viewport2DManager.js');
 
 function _interopNamespace(e) {
   if (e && e.__esModule) return e;
@@ -604,13 +605,9 @@ var ModelManager = /*#__PURE__*/function () {
                 // Update both the JSON data object AND the live scene object
                 jsonData.userData.worldBoundingBox = worldBoundingBox;
                 glbModel.userData.worldBoundingBox = worldBoundingBox;
-                // Snapshot the object's local position so viewport2DManager can compute
+                // Cache the object's position so viewport2DManager can compute
                 // world-bbox updates via a fast O(1) position delta instead of re-traversing geometry
-                glbModel.userData._wbbBasePosition = {
-                  x: glbModel.position.x,
-                  y: glbModel.position.y,
-                  z: glbModel.position.z
-                };
+                viewport2DManager.cacheBasePosition(glbModel, worldBoundingBox);
               });
 
               // Dispatch completion event

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

@@ -27,6 +27,29 @@ function _interopNamespace(e) {
 
 var THREE__namespace = /*#__PURE__*/_interopNamespace(THREE);
 
+/**
+ * WeakMap cache for storing base position data per Object3D.
+ * Used by _getOrComputeWorldBoundingBox() for O(1) bbox offset calculations.
+ * WeakMap ensures automatic cleanup when objects are garbage collected.
+ * @type {WeakMap<THREE.Object3D, {x: number, y: number, z: number, worldBoundingBox: {min: number[], max: number[]}}>}
+ */
+var _basePositionCache = new WeakMap();
+
+/**
+ * Store base position and worldBoundingBox for an Object3D.
+ * Called by modelManager after GLB loading to enable fast bbox updates.
+ * @param {THREE.Object3D} object - The loaded GLB model
+ * @param {{min: number[], max: number[]}} worldBoundingBox - Computed world bounding box
+ */
+function cacheBasePosition(object, worldBoundingBox) {
+  _basePositionCache.set(object, {
+    x: object.position.x,
+    y: object.position.y,
+    z: object.position.z,
+    worldBoundingBox: worldBoundingBox
+  });
+}
+
 /**
  * Viewport2DInstance
  * Represents a single 2D viewport with its own Konva stage and configuration
@@ -675,16 +698,15 @@ var Viewport2DManager = /*#__PURE__*/function (_BaseDisposable2) {
   }, {
     key: "_getOrComputeWorldBoundingBox",
     value: function _getOrComputeWorldBoundingBox(object) {
-      var _object$userData, _object$userData2;
       // Fast path: offset the stored world bbox by the position delta since load time.
       // Translation only shifts the bbox center — extents stay identical — so this is O(1)
       // instead of O(meshes × vertices) from a full geometry traversal.
-      var stored = (_object$userData = object.userData) === null || _object$userData === void 0 ? void 0 : _object$userData.worldBoundingBox;
-      var basePos = (_object$userData2 = object.userData) === null || _object$userData2 === void 0 ? void 0 : _object$userData2._wbbBasePosition;
-      if (stored && basePos) {
-        var dx = object.position.x - basePos.x;
-        var dy = object.position.y - basePos.y;
-        var dz = object.position.z - basePos.z;
+      var cached = _basePositionCache.get(object);
+      if (cached) {
+        var dx = object.position.x - cached.x;
+        var dy = object.position.y - cached.y;
+        var dz = object.position.z - cached.z;
+        var stored = cached.worldBoundingBox;
         if (dx === 0 && dy === 0 && dz === 0) return stored;
         return {
           min: [stored.min[0] + dx, stored.min[1] + dy, stored.min[2] + dz],
@@ -1091,10 +1113,10 @@ var Viewport2DManager = /*#__PURE__*/function (_BaseDisposable2) {
       }
       var components = [];
       this.sceneViewer.scene.traverse(function (object) {
-        var _object$userData3, _object$userData4;
+        var _object$userData, _object$userData2;
         // Only match the ROOT component object — must have both objectType:'component'
         // AND libraryId (inner GLB mesh nodes don't have libraryId)
-        if (((_object$userData3 = object.userData) === null || _object$userData3 === void 0 ? void 0 : _object$userData3.objectType) === 'component' && (_object$userData4 = object.userData) !== null && _object$userData4 !== void 0 && _object$userData4.libraryId) {
+        if (((_object$userData = object.userData) === null || _object$userData === void 0 ? void 0 : _object$userData.objectType) === 'component' && (_object$userData2 = object.userData) !== null && _object$userData2 !== void 0 && _object$userData2.libraryId) {
           components.push(object);
         }
       });
@@ -1314,3 +1336,4 @@ var Viewport2DManager = /*#__PURE__*/function (_BaseDisposable2) {
 }(baseDisposable.BaseDisposable);
 
 exports.Viewport2DManager = Viewport2DManager;
+exports.cacheBasePosition = cacheBasePosition;

package/dist/cjs/src/managers/system/settingsManager.js

@@ -12,6 +12,7 @@ var DEFAULT_SETTINGS = {
   scene: {
     autoRotation: false,
     checkUnderground: true,
+    showGatewaySpheres: false,
     splitSegmentsWithComponentConnectors: true
   },
   viewport: {
@@ -242,9 +243,37 @@ var SettingsManager = /*#__PURE__*/function (_BaseDisposable) {
           component.transformManager.checkUnderground = sceneSettings.checkUnderground;
         }
       }
+
+      // Handle gateway sphere visibility
+      if (sceneSettings.hasOwnProperty('showGatewaySpheres')) {
+        this.setGatewayVisibility(sceneSettings.showGatewaySpheres);
+      }
       console.log('🎬 Scene settings applied:', sceneSettings);
     }
 
+    /**
+     * Set visibility of all gateway spheres in the scene
+     * @param {boolean} visible - Whether gateways should be visible
+     */
+  }, {
+    key: "setGatewayVisibility",
+    value: function setGatewayVisibility(visible) {
+      var _this$sceneViewer;
+      if (!((_this$sceneViewer = this.sceneViewer) !== null && _this$sceneViewer !== void 0 && _this$sceneViewer.scene)) {
+        console.warn('⚠️ Scene not available for gateway visibility toggle');
+        return;
+      }
+      var gatewayCount = 0;
+      this.sceneViewer.scene.traverse(function (object) {
+        var _object$userData;
+        if (((_object$userData = object.userData) === null || _object$userData === void 0 ? void 0 : _object$userData.objectType) === 'gateway') {
+          object.visible = visible;
+          gatewayCount++;
+        }
+      });
+      console.log("\uD83D\uDD2E Gateway visibility set to ".concat(visible, " (").concat(gatewayCount, " gateways affected)"));
+    }
+
     /**
      * Apply viewport-specific settings
      * @param {Object} viewportSettings - Viewport settings

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

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

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

@@ -88,7 +88,11 @@ var PathRenderingManager = /*#__PURE__*/function (_BaseDisposable) {
   }, {
     key: "createGateways",
     value: function createGateways(pathfindingResult) {
-      var _this2 = this;
+      var _this$sceneViewer$man,
+        _this$sceneViewer,
+        _this2 = this;
+      // Check current gateway visibility setting
+      var showGateways = (_this$sceneViewer$man = (_this$sceneViewer = this.sceneViewer) === null || _this$sceneViewer === void 0 || (_this$sceneViewer = _this$sceneViewer.managers) === null || _this$sceneViewer === void 0 || (_this$sceneViewer = _this$sceneViewer.settingsManager) === null || _this$sceneViewer === void 0 ? void 0 : _this$sceneViewer.getSetting('scene', 'showGatewaySpheres')) !== null && _this$sceneViewer$man !== void 0 ? _this$sceneViewer$man : true;
       pathfindingResult.gateways.forEach(function (gateway) {
         if (!gateway.position) {
           console.warn("\u26A0\uFE0F Gateway ".concat(gateway.id, " missing position, skipping creation"));
@@ -133,6 +137,9 @@ var PathRenderingManager = /*#__PURE__*/function (_BaseDisposable) {
           }
         };
 
+        // Apply current visibility setting
+        gatewayMesh.visible = showGateways;
+
         // Add to scene
         _this2.sceneViewer.scene.add(gatewayMesh);
         console.log("\uD83D\uDD27 Created gateway: ".concat(gateway.id, " at [").concat(gatewayMesh.position.x.toFixed(2), ", ").concat(gatewayMesh.position.y.toFixed(2), ", ").concat(gatewayMesh.position.z.toFixed(2), "]"));

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

@@ -3,6 +3,7 @@ import * as THREE from 'three';
 import { attachIODevicesToComponent } from '../../utils/ioDeviceUtils.js';
 import modelPreloader from '../../rendering/modelPreloader.js';
 import { computeFilteredBoundingBox } from '../../utils/boundingBoxUtils.js';
+import { cacheBasePosition } from './viewport2DManager.js';
 
 var ModelManager = /*#__PURE__*/function () {
   function ModelManager(sceneViewer) {
@@ -580,13 +581,9 @@ var ModelManager = /*#__PURE__*/function () {
                 // Update both the JSON data object AND the live scene object
                 jsonData.userData.worldBoundingBox = worldBoundingBox;
                 glbModel.userData.worldBoundingBox = worldBoundingBox;
-                // Snapshot the object's local position so viewport2DManager can compute
+                // Cache the object's position so viewport2DManager can compute
                 // world-bbox updates via a fast O(1) position delta instead of re-traversing geometry
-                glbModel.userData._wbbBasePosition = {
-                  x: glbModel.position.x,
-                  y: glbModel.position.y,
-                  z: glbModel.position.z
-                };
+                cacheBasePosition(glbModel, worldBoundingBox);
               });
 
               // Dispatch completion event

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

@@ -3,6 +3,29 @@ import { BaseDisposable } from '../../core/baseDisposable.js';
 import * as THREE from 'three';
 import { computeFilteredBoundingBox } from '../../utils/boundingBoxUtils.js';
 
+/**
+ * WeakMap cache for storing base position data per Object3D.
+ * Used by _getOrComputeWorldBoundingBox() for O(1) bbox offset calculations.
+ * WeakMap ensures automatic cleanup when objects are garbage collected.
+ * @type {WeakMap<THREE.Object3D, {x: number, y: number, z: number, worldBoundingBox: {min: number[], max: number[]}}>}
+ */
+var _basePositionCache = new WeakMap();
+
+/**
+ * Store base position and worldBoundingBox for an Object3D.
+ * Called by modelManager after GLB loading to enable fast bbox updates.
+ * @param {THREE.Object3D} object - The loaded GLB model
+ * @param {{min: number[], max: number[]}} worldBoundingBox - Computed world bounding box
+ */
+function cacheBasePosition(object, worldBoundingBox) {
+  _basePositionCache.set(object, {
+    x: object.position.x,
+    y: object.position.y,
+    z: object.position.z,
+    worldBoundingBox: worldBoundingBox
+  });
+}
+
 /**
  * Viewport2DInstance
  * Represents a single 2D viewport with its own Konva stage and configuration
@@ -651,16 +674,15 @@ var Viewport2DManager = /*#__PURE__*/function (_BaseDisposable2) {
   }, {
     key: "_getOrComputeWorldBoundingBox",
     value: function _getOrComputeWorldBoundingBox(object) {
-      var _object$userData, _object$userData2;
       // Fast path: offset the stored world bbox by the position delta since load time.
       // Translation only shifts the bbox center — extents stay identical — so this is O(1)
       // instead of O(meshes × vertices) from a full geometry traversal.
-      var stored = (_object$userData = object.userData) === null || _object$userData === void 0 ? void 0 : _object$userData.worldBoundingBox;
-      var basePos = (_object$userData2 = object.userData) === null || _object$userData2 === void 0 ? void 0 : _object$userData2._wbbBasePosition;
-      if (stored && basePos) {
-        var dx = object.position.x - basePos.x;
-        var dy = object.position.y - basePos.y;
-        var dz = object.position.z - basePos.z;
+      var cached = _basePositionCache.get(object);
+      if (cached) {
+        var dx = object.position.x - cached.x;
+        var dy = object.position.y - cached.y;
+        var dz = object.position.z - cached.z;
+        var stored = cached.worldBoundingBox;
         if (dx === 0 && dy === 0 && dz === 0) return stored;
         return {
           min: [stored.min[0] + dx, stored.min[1] + dy, stored.min[2] + dz],
@@ -1067,10 +1089,10 @@ var Viewport2DManager = /*#__PURE__*/function (_BaseDisposable2) {
       }
       var components = [];
       this.sceneViewer.scene.traverse(function (object) {
-        var _object$userData3, _object$userData4;
+        var _object$userData, _object$userData2;
         // Only match the ROOT component object — must have both objectType:'component'
         // AND libraryId (inner GLB mesh nodes don't have libraryId)
-        if (((_object$userData3 = object.userData) === null || _object$userData3 === void 0 ? void 0 : _object$userData3.objectType) === 'component' && (_object$userData4 = object.userData) !== null && _object$userData4 !== void 0 && _object$userData4.libraryId) {
+        if (((_object$userData = object.userData) === null || _object$userData === void 0 ? void 0 : _object$userData.objectType) === 'component' && (_object$userData2 = object.userData) !== null && _object$userData2 !== void 0 && _object$userData2.libraryId) {
           components.push(object);
         }
       });
@@ -1289,4 +1311,4 @@ var Viewport2DManager = /*#__PURE__*/function (_BaseDisposable2) {
   }]);
 }(BaseDisposable);
 
-export { Viewport2DManager };
+export { Viewport2DManager, cacheBasePosition };

package/dist/esm/src/managers/system/settingsManager.js

@@ -8,6 +8,7 @@ var DEFAULT_SETTINGS = {
   scene: {
     autoRotation: false,
     checkUnderground: true,
+    showGatewaySpheres: false,
     splitSegmentsWithComponentConnectors: true
   },
   viewport: {
@@ -238,9 +239,37 @@ var SettingsManager = /*#__PURE__*/function (_BaseDisposable) {
           component.transformManager.checkUnderground = sceneSettings.checkUnderground;
         }
       }
+
+      // Handle gateway sphere visibility
+      if (sceneSettings.hasOwnProperty('showGatewaySpheres')) {
+        this.setGatewayVisibility(sceneSettings.showGatewaySpheres);
+      }
       console.log('🎬 Scene settings applied:', sceneSettings);
     }
 
+    /**
+     * Set visibility of all gateway spheres in the scene
+     * @param {boolean} visible - Whether gateways should be visible
+     */
+  }, {
+    key: "setGatewayVisibility",
+    value: function setGatewayVisibility(visible) {
+      var _this$sceneViewer;
+      if (!((_this$sceneViewer = this.sceneViewer) !== null && _this$sceneViewer !== void 0 && _this$sceneViewer.scene)) {
+        console.warn('⚠️ Scene not available for gateway visibility toggle');
+        return;
+      }
+      var gatewayCount = 0;
+      this.sceneViewer.scene.traverse(function (object) {
+        var _object$userData;
+        if (((_object$userData = object.userData) === null || _object$userData === void 0 ? void 0 : _object$userData.objectType) === 'gateway') {
+          object.visible = visible;
+          gatewayCount++;
+        }
+      });
+      console.log("\uD83D\uDD2E Gateway visibility set to ".concat(visible, " (").concat(gatewayCount, " gateways affected)"));
+    }
+
     /**
      * Apply viewport-specific settings
      * @param {Object} viewportSettings - Viewport settings

package/package.json

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