@2112-lab/central-plant 0.3.13 → 0.3.14

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.14
    * @updated 2025-10-22
    * 
    * @description Creates a new CentralPlant instance and initializes internal managers and utilities.

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/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.14
    * @updated 2025-10-22
    * 
    * @description Creates a new CentralPlant instance and initializes internal managers and utilities.

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/package.json

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