@2112-lab/central-plant 0.1.79 → 0.1.80

package/dist/bundle/index.js

@@ -30911,12 +30911,21 @@ var AnimationManager = /*#__PURE__*/function (_BaseDisposable) {
       if (sceneViewer.performanceMonitorManager) {
         sceneViewer.performanceMonitorManager.beginFrame();
       }
+      try {
+        // Update controls
+        sceneViewer.controls.update();
 
-      // Update controls
-      sceneViewer.controls.update();
-
-      // Render the scene
-      sceneViewer.renderer.render(sceneViewer.scene, sceneViewer.camera);
+        // Render the scene
+        sceneViewer.renderer.render(sceneViewer.scene, sceneViewer.camera);
+      } catch (renderError) {
+        // Catch WebGL or rendering errors to prevent the animation loop from
+        // producing a permanent white screen. Log once and continue so that
+        // subsequent frames can recover if the problematic object is removed.
+        if (!this._hasLoggedRenderError) {
+          console.error('❌ AnimationManager: Render error caught — scene may contain disposed resources:', renderError);
+          this._hasLoggedRenderError = true;
+        }
+      }
 
       // Render tooltips if tooltipsManager exists
       if (sceneViewer.tooltipsManager) {
@@ -31298,7 +31307,10 @@ var ComponentDragManager = /*#__PURE__*/function (_BaseDisposable) {
               }
               this.dragData.previewObject = cachedModel.clone();
 
-              // Clone materials to avoid affecting other objects
+              // Clone geometries and materials to fully isolate the preview from the cache.
+              // Without this, disposing the preview would invalidate shared GPU buffers
+              // and cause the scene to go white.
+              this._cloneGeometries(this.dragData.previewObject);
               this._cloneMaterials(this.dragData.previewObject);
 
               // Store original colors BEFORE making transparent
@@ -31437,6 +31449,7 @@ var ComponentDragManager = /*#__PURE__*/function (_BaseDisposable) {
               return _context3.a(3, 11);
             case 9:
               deviceModel = cachedDevice.clone();
+              this._cloneGeometries(deviceModel);
               this._cloneMaterials(deviceModel);
               this._storeOriginalColors(deviceModel);
               deviceModel.userData = {
@@ -31489,16 +31502,38 @@ var ComponentDragManager = /*#__PURE__*/function (_BaseDisposable) {
           if (Array.isArray(child.material)) {
             // Handle material arrays
             child.material = child.material.map(function (material) {
-              return material.clone();
+              var cloned = material.clone();
+              cloned.userData._isClonedMaterial = true;
+              return cloned;
             });
           } else {
             // Handle single materials
             child.material = child.material.clone();
+            child.material.userData._isClonedMaterial = true;
           }
         }
       });
     }
 
+    /**
+     * Clone all geometries in an object hierarchy to avoid shared geometry buffer issues.
+     * Three.js Object3D.clone() shares geometry references between the original and clone.
+     * Disposing shared geometry invalidates GPU buffers for ALL objects using that geometry,
+     * which causes the scene to go white. This method gives each mesh its own geometry copy.
+     * @param {THREE.Object3D} object - The object to clone geometries for
+     * @private
+     */
+  }, {
+    key: "_cloneGeometries",
+    value: function _cloneGeometries(object) {
+      object.traverse(function (child) {
+        if (child.isMesh && child.geometry) {
+          child.geometry = child.geometry.clone();
+          child.userData._isClonedGeometry = true;
+        }
+      });
+    }
+
     /**
      * Store original colors from all materials in an object hierarchy
      * @param {THREE.Object3D} object - The object to store colors from
@@ -31877,18 +31912,27 @@ var ComponentDragManager = /*#__PURE__*/function (_BaseDisposable) {
       if (this.dragData.previewObject) {
         this.sceneViewer.scene.remove(this.dragData.previewObject);
 
-        // Dispose of geometry and materials properly
+        // Dispose of CLONED geometry and materials only.
+        // Both geometries and materials were cloned during preview creation
+        // via _cloneGeometries() and _cloneMaterials(), so they are safe to dispose.
+        // IMPORTANT: Never dispose geometry/materials that are shared with the model cache.
         this.dragData.previewObject.traverse(function (child) {
-          if (child.geometry) {
-            child.geometry.dispose();
-          }
-          if (child.material) {
-            if (Array.isArray(child.material)) {
-              child.material.forEach(function (material) {
-                return material.dispose();
-              });
-            } else {
-              child.material.dispose();
+          if (child.isMesh) {
+            // Only dispose geometry if it was cloned for this preview
+            if (child.geometry && child.userData._isClonedGeometry) {
+              child.geometry.dispose();
+            }
+            // Only dispose material if it was cloned for this preview
+            if (child.material) {
+              if (Array.isArray(child.material)) {
+                child.material.forEach(function (material) {
+                  if (material.userData._isClonedMaterial) {
+                    material.dispose();
+                  }
+                });
+              } else if (child.material.userData._isClonedMaterial) {
+                child.material.dispose();
+              }
             }
           }
         });
@@ -35308,8 +35352,21 @@ var CentralPlantInternals = /*#__PURE__*/function () {
         // Clone the cached model to create a new instance
         var componentModel = cachedModel;
 
-        // Set the component properties
-        componentModel.uuid = componentId;
+        // Clone materials to isolate this component instance from the model cache.
+        // Without this, shared materials would cause visual side-effects when one
+        // component's material is modified (e.g., selection highlighting).
+        componentModel.traverse(function (child) {
+          if (child.isMesh && child.material) {
+            if (Array.isArray(child.material)) {
+              child.material = child.material.map(function (m) {
+                return m.clone();
+              });
+            } else {
+              child.material = child.material.clone();
+            }
+          }
+        });
+
         // Set the component properties
         componentModel.uuid = componentId;
 
@@ -35666,7 +35723,7 @@ var CentralPlant = /*#__PURE__*/function (_BaseDisposable) {
    * Initialize the CentralPlant manager
    * 
    * @constructor
-   * @version 0.1.79
+   * @version 0.1.80
    * @updated 2025-10-22
    * 
    * @description Creates a new CentralPlant instance and initializes internal managers and utilities.
@@ -41274,6 +41331,19 @@ var Rendering3D = /*#__PURE__*/function (_BaseDisposable) {
         this.renderer.useLegacyLights = false;
         container.appendChild(this.renderer.domElement);
 
+        // Register WebGL context lost/restored handlers for resilience.
+        // If the GPU context is lost (e.g., due to disposed buffers or driver issues),
+        // these handlers prevent a permanent white screen.
+        this._onContextLost = function (event) {
+          event.preventDefault();
+          console.warn('⚠️ WebGL context lost — rendering paused. The browser may restore it automatically.');
+        };
+        this._onContextRestored = function () {
+          console.log('✅ WebGL context restored — rendering will resume.');
+        };
+        this.renderer.domElement.addEventListener('webglcontextlost', this._onContextLost, false);
+        this.renderer.domElement.addEventListener('webglcontextrestored', this._onContextRestored, false);
+
         // Register resources for automatic cleanup
         this.registerDOMElement(this.renderer.domElement);
         this.registerDisposable(this.renderer, 'WebGLRenderer');
@@ -41484,6 +41554,18 @@ var Rendering3D = /*#__PURE__*/function (_BaseDisposable) {
         frameTime: 0
       };
 
+      // Remove WebGL context event listeners
+      if (this.renderer && this.renderer.domElement) {
+        if (this._onContextLost) {
+          this.renderer.domElement.removeEventListener('webglcontextlost', this._onContextLost, false);
+        }
+        if (this._onContextRestored) {
+          this.renderer.domElement.removeEventListener('webglcontextrestored', this._onContextRestored, false);
+        }
+      }
+      this._onContextLost = null;
+      this._onContextRestored = null;
+
       // Clear post processing
       this.postProcessing = {
         composer: null,

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

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

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

@@ -931,8 +931,21 @@ var CentralPlantInternals = /*#__PURE__*/function () {
         // Clone the cached model to create a new instance
         var componentModel = cachedModel;
 
-        // Set the component properties
-        componentModel.uuid = componentId;
+        // Clone materials to isolate this component instance from the model cache.
+        // Without this, shared materials would cause visual side-effects when one
+        // component's material is modified (e.g., selection highlighting).
+        componentModel.traverse(function (child) {
+          if (child.isMesh && child.material) {
+            if (Array.isArray(child.material)) {
+              child.material = child.material.map(function (m) {
+                return m.clone();
+              });
+            } else {
+              child.material = child.material.clone();
+            }
+          }
+        });
+
         // Set the component properties
         componentModel.uuid = componentId;
 

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

@@ -252,7 +252,10 @@ var ComponentDragManager = /*#__PURE__*/function (_BaseDisposable) {
               }
               this.dragData.previewObject = cachedModel.clone();
 
-              // Clone materials to avoid affecting other objects
+              // Clone geometries and materials to fully isolate the preview from the cache.
+              // Without this, disposing the preview would invalidate shared GPU buffers
+              // and cause the scene to go white.
+              this._cloneGeometries(this.dragData.previewObject);
               this._cloneMaterials(this.dragData.previewObject);
 
               // Store original colors BEFORE making transparent
@@ -391,6 +394,7 @@ var ComponentDragManager = /*#__PURE__*/function (_BaseDisposable) {
               return _context3.a(3, 11);
             case 9:
               deviceModel = cachedDevice.clone();
+              this._cloneGeometries(deviceModel);
               this._cloneMaterials(deviceModel);
               this._storeOriginalColors(deviceModel);
               deviceModel.userData = {
@@ -443,16 +447,38 @@ var ComponentDragManager = /*#__PURE__*/function (_BaseDisposable) {
           if (Array.isArray(child.material)) {
             // Handle material arrays
             child.material = child.material.map(function (material) {
-              return material.clone();
+              var cloned = material.clone();
+              cloned.userData._isClonedMaterial = true;
+              return cloned;
             });
           } else {
             // Handle single materials
             child.material = child.material.clone();
+            child.material.userData._isClonedMaterial = true;
           }
         }
       });
     }
 
+    /**
+     * Clone all geometries in an object hierarchy to avoid shared geometry buffer issues.
+     * Three.js Object3D.clone() shares geometry references between the original and clone.
+     * Disposing shared geometry invalidates GPU buffers for ALL objects using that geometry,
+     * which causes the scene to go white. This method gives each mesh its own geometry copy.
+     * @param {THREE.Object3D} object - The object to clone geometries for
+     * @private
+     */
+  }, {
+    key: "_cloneGeometries",
+    value: function _cloneGeometries(object) {
+      object.traverse(function (child) {
+        if (child.isMesh && child.geometry) {
+          child.geometry = child.geometry.clone();
+          child.userData._isClonedGeometry = true;
+        }
+      });
+    }
+
     /**
      * Store original colors from all materials in an object hierarchy
      * @param {THREE.Object3D} object - The object to store colors from
@@ -831,18 +857,27 @@ var ComponentDragManager = /*#__PURE__*/function (_BaseDisposable) {
       if (this.dragData.previewObject) {
         this.sceneViewer.scene.remove(this.dragData.previewObject);
 
-        // Dispose of geometry and materials properly
+        // Dispose of CLONED geometry and materials only.
+        // Both geometries and materials were cloned during preview creation
+        // via _cloneGeometries() and _cloneMaterials(), so they are safe to dispose.
+        // IMPORTANT: Never dispose geometry/materials that are shared with the model cache.
         this.dragData.previewObject.traverse(function (child) {
-          if (child.geometry) {
-            child.geometry.dispose();
-          }
-          if (child.material) {
-            if (Array.isArray(child.material)) {
-              child.material.forEach(function (material) {
-                return material.dispose();
-              });
-            } else {
-              child.material.dispose();
+          if (child.isMesh) {
+            // Only dispose geometry if it was cloned for this preview
+            if (child.geometry && child.userData._isClonedGeometry) {
+              child.geometry.dispose();
+            }
+            // Only dispose material if it was cloned for this preview
+            if (child.material) {
+              if (Array.isArray(child.material)) {
+                child.material.forEach(function (material) {
+                  if (material.userData._isClonedMaterial) {
+                    material.dispose();
+                  }
+                });
+              } else if (child.material.userData._isClonedMaterial) {
+                child.material.dispose();
+              }
             }
           }
         });

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

@@ -62,12 +62,21 @@ var AnimationManager = /*#__PURE__*/function (_BaseDisposable) {
       if (sceneViewer.performanceMonitorManager) {
         sceneViewer.performanceMonitorManager.beginFrame();
       }
-
-      // Update controls
-      sceneViewer.controls.update();
-
-      // Render the scene
-      sceneViewer.renderer.render(sceneViewer.scene, sceneViewer.camera);
+      try {
+        // Update controls
+        sceneViewer.controls.update();
+
+        // Render the scene
+        sceneViewer.renderer.render(sceneViewer.scene, sceneViewer.camera);
+      } catch (renderError) {
+        // Catch WebGL or rendering errors to prevent the animation loop from
+        // producing a permanent white screen. Log once and continue so that
+        // subsequent frames can recover if the problematic object is removed.
+        if (!this._hasLoggedRenderError) {
+          console.error('❌ AnimationManager: Render error caught — scene may contain disposed resources:', renderError);
+          this._hasLoggedRenderError = true;
+        }
+      }
 
       // Render tooltips if tooltipsManager exists
       if (sceneViewer.tooltipsManager) {

package/dist/cjs/src/rendering/rendering3D.js

@@ -480,6 +480,19 @@ var Rendering3D = /*#__PURE__*/function (_BaseDisposable) {
         this.renderer.useLegacyLights = false;
         container.appendChild(this.renderer.domElement);
 
+        // Register WebGL context lost/restored handlers for resilience.
+        // If the GPU context is lost (e.g., due to disposed buffers or driver issues),
+        // these handlers prevent a permanent white screen.
+        this._onContextLost = function (event) {
+          event.preventDefault();
+          console.warn('⚠️ WebGL context lost — rendering paused. The browser may restore it automatically.');
+        };
+        this._onContextRestored = function () {
+          console.log('✅ WebGL context restored — rendering will resume.');
+        };
+        this.renderer.domElement.addEventListener('webglcontextlost', this._onContextLost, false);
+        this.renderer.domElement.addEventListener('webglcontextrestored', this._onContextRestored, false);
+
         // Register resources for automatic cleanup
         this.registerDOMElement(this.renderer.domElement);
         this.registerDisposable(this.renderer, 'WebGLRenderer');
@@ -690,6 +703,18 @@ var Rendering3D = /*#__PURE__*/function (_BaseDisposable) {
         frameTime: 0
       };
 
+      // Remove WebGL context event listeners
+      if (this.renderer && this.renderer.domElement) {
+        if (this._onContextLost) {
+          this.renderer.domElement.removeEventListener('webglcontextlost', this._onContextLost, false);
+        }
+        if (this._onContextRestored) {
+          this.renderer.domElement.removeEventListener('webglcontextrestored', this._onContextRestored, false);
+        }
+      }
+      this._onContextLost = null;
+      this._onContextRestored = null;
+
       // Clear post processing
       this.postProcessing = {
         composer: null,

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

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

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

@@ -907,8 +907,21 @@ var CentralPlantInternals = /*#__PURE__*/function () {
         // Clone the cached model to create a new instance
         var componentModel = cachedModel;
 
-        // Set the component properties
-        componentModel.uuid = componentId;
+        // Clone materials to isolate this component instance from the model cache.
+        // Without this, shared materials would cause visual side-effects when one
+        // component's material is modified (e.g., selection highlighting).
+        componentModel.traverse(function (child) {
+          if (child.isMesh && child.material) {
+            if (Array.isArray(child.material)) {
+              child.material = child.material.map(function (m) {
+                return m.clone();
+              });
+            } else {
+              child.material = child.material.clone();
+            }
+          }
+        });
+
         // Set the component properties
         componentModel.uuid = componentId;
 

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

@@ -228,7 +228,10 @@ var ComponentDragManager = /*#__PURE__*/function (_BaseDisposable) {
               }
               this.dragData.previewObject = cachedModel.clone();
 
-              // Clone materials to avoid affecting other objects
+              // Clone geometries and materials to fully isolate the preview from the cache.
+              // Without this, disposing the preview would invalidate shared GPU buffers
+              // and cause the scene to go white.
+              this._cloneGeometries(this.dragData.previewObject);
               this._cloneMaterials(this.dragData.previewObject);
 
               // Store original colors BEFORE making transparent
@@ -367,6 +370,7 @@ var ComponentDragManager = /*#__PURE__*/function (_BaseDisposable) {
               return _context3.a(3, 11);
             case 9:
               deviceModel = cachedDevice.clone();
+              this._cloneGeometries(deviceModel);
               this._cloneMaterials(deviceModel);
               this._storeOriginalColors(deviceModel);
               deviceModel.userData = {
@@ -419,16 +423,38 @@ var ComponentDragManager = /*#__PURE__*/function (_BaseDisposable) {
           if (Array.isArray(child.material)) {
             // Handle material arrays
             child.material = child.material.map(function (material) {
-              return material.clone();
+              var cloned = material.clone();
+              cloned.userData._isClonedMaterial = true;
+              return cloned;
             });
           } else {
             // Handle single materials
             child.material = child.material.clone();
+            child.material.userData._isClonedMaterial = true;
           }
         }
       });
     }
 
+    /**
+     * Clone all geometries in an object hierarchy to avoid shared geometry buffer issues.
+     * Three.js Object3D.clone() shares geometry references between the original and clone.
+     * Disposing shared geometry invalidates GPU buffers for ALL objects using that geometry,
+     * which causes the scene to go white. This method gives each mesh its own geometry copy.
+     * @param {THREE.Object3D} object - The object to clone geometries for
+     * @private
+     */
+  }, {
+    key: "_cloneGeometries",
+    value: function _cloneGeometries(object) {
+      object.traverse(function (child) {
+        if (child.isMesh && child.geometry) {
+          child.geometry = child.geometry.clone();
+          child.userData._isClonedGeometry = true;
+        }
+      });
+    }
+
     /**
      * Store original colors from all materials in an object hierarchy
      * @param {THREE.Object3D} object - The object to store colors from
@@ -807,18 +833,27 @@ var ComponentDragManager = /*#__PURE__*/function (_BaseDisposable) {
       if (this.dragData.previewObject) {
         this.sceneViewer.scene.remove(this.dragData.previewObject);
 
-        // Dispose of geometry and materials properly
+        // Dispose of CLONED geometry and materials only.
+        // Both geometries and materials were cloned during preview creation
+        // via _cloneGeometries() and _cloneMaterials(), so they are safe to dispose.
+        // IMPORTANT: Never dispose geometry/materials that are shared with the model cache.
         this.dragData.previewObject.traverse(function (child) {
-          if (child.geometry) {
-            child.geometry.dispose();
-          }
-          if (child.material) {
-            if (Array.isArray(child.material)) {
-              child.material.forEach(function (material) {
-                return material.dispose();
-              });
-            } else {
-              child.material.dispose();
+          if (child.isMesh) {
+            // Only dispose geometry if it was cloned for this preview
+            if (child.geometry && child.userData._isClonedGeometry) {
+              child.geometry.dispose();
+            }
+            // Only dispose material if it was cloned for this preview
+            if (child.material) {
+              if (Array.isArray(child.material)) {
+                child.material.forEach(function (material) {
+                  if (material.userData._isClonedMaterial) {
+                    material.dispose();
+                  }
+                });
+              } else if (child.material.userData._isClonedMaterial) {
+                child.material.dispose();
+              }
             }
           }
         });

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

@@ -58,12 +58,21 @@ var AnimationManager = /*#__PURE__*/function (_BaseDisposable) {
       if (sceneViewer.performanceMonitorManager) {
         sceneViewer.performanceMonitorManager.beginFrame();
       }
-
-      // Update controls
-      sceneViewer.controls.update();
-
-      // Render the scene
-      sceneViewer.renderer.render(sceneViewer.scene, sceneViewer.camera);
+      try {
+        // Update controls
+        sceneViewer.controls.update();
+
+        // Render the scene
+        sceneViewer.renderer.render(sceneViewer.scene, sceneViewer.camera);
+      } catch (renderError) {
+        // Catch WebGL or rendering errors to prevent the animation loop from
+        // producing a permanent white screen. Log once and continue so that
+        // subsequent frames can recover if the problematic object is removed.
+        if (!this._hasLoggedRenderError) {
+          console.error('❌ AnimationManager: Render error caught — scene may contain disposed resources:', renderError);
+          this._hasLoggedRenderError = true;
+        }
+      }
 
       // Render tooltips if tooltipsManager exists
       if (sceneViewer.tooltipsManager) {

package/dist/esm/src/rendering/rendering3D.js

@@ -456,6 +456,19 @@ var Rendering3D = /*#__PURE__*/function (_BaseDisposable) {
         this.renderer.useLegacyLights = false;
         container.appendChild(this.renderer.domElement);
 
+        // Register WebGL context lost/restored handlers for resilience.
+        // If the GPU context is lost (e.g., due to disposed buffers or driver issues),
+        // these handlers prevent a permanent white screen.
+        this._onContextLost = function (event) {
+          event.preventDefault();
+          console.warn('⚠️ WebGL context lost — rendering paused. The browser may restore it automatically.');
+        };
+        this._onContextRestored = function () {
+          console.log('✅ WebGL context restored — rendering will resume.');
+        };
+        this.renderer.domElement.addEventListener('webglcontextlost', this._onContextLost, false);
+        this.renderer.domElement.addEventListener('webglcontextrestored', this._onContextRestored, false);
+
         // Register resources for automatic cleanup
         this.registerDOMElement(this.renderer.domElement);
         this.registerDisposable(this.renderer, 'WebGLRenderer');
@@ -666,6 +679,18 @@ var Rendering3D = /*#__PURE__*/function (_BaseDisposable) {
         frameTime: 0
       };
 
+      // Remove WebGL context event listeners
+      if (this.renderer && this.renderer.domElement) {
+        if (this._onContextLost) {
+          this.renderer.domElement.removeEventListener('webglcontextlost', this._onContextLost, false);
+        }
+        if (this._onContextRestored) {
+          this.renderer.domElement.removeEventListener('webglcontextrestored', this._onContextRestored, false);
+        }
+      }
+      this._onContextLost = null;
+      this._onContextRestored = null;
+
       // Clear post processing
       this.postProcessing = {
         composer: null,

package/package.json

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