@2112-lab/central-plant 0.3.56 → 0.3.58

package/dist/bundle/index.js

@@ -4109,6 +4109,12 @@ var TransformControlsManager = /*#__PURE__*/function () {
         // Update bounding box if the transformed object is in current selection
         if (_this.selectedObjects.includes(eventData.object)) {
           console.log('🔲 Updating bounding boxes for selected objects after transform');
+          // Reposition the transform gizmo (and its selection group) to follow the
+          // object's new position. Programmatic transforms (e.g. the Transform tab's
+          // Translate/Rotate buttons) move the object directly without touching the
+          // multi-selection group the gizmo is attached to, so without this the widget
+          // would stay at the pre-transform centroid.
+          _this.syncSelectionToObjects();
           _this.updateBoundingBox();
         }
       };
@@ -5215,6 +5221,59 @@ var TransformControlsManager = /*#__PURE__*/function () {
       console.log("\uD83D\uDCE6 Multi-selection group created at centroid:", centroid.toArray());
     }
 
+    /**
+     * Re-sync the multi-selection group (and the attached transform gizmo) to the
+     * current world positions of the selected objects, in place.
+     *
+     * Used after a *programmatic* transform (e.g. the Transform tab's Translate /
+     * Rotate buttons), which mutates the object directly and does not move the
+     * selection group the gizmo is attached to. Unlike a full updateMultiSelection()
+     * this keeps the same group instance so the gizmo doesn't detach/re-attach.
+     *
+     * It also refreshes the cached original transforms so a subsequent gizmo drag
+     * computes its delta from the object's new position rather than jumping.
+     */
+  }, {
+    key: "syncSelectionToObjects",
+    value: function syncSelectionToObjects() {
+      var _this$transformContro;
+      if (!this.multiSelectionGroup || this.selectedObjects.length === 0) {
+        return;
+      }
+
+      // Recompute the centroid from the objects' current world positions.
+      var centroid = new THREE__namespace.Vector3();
+      this.selectedObjects.forEach(function (obj) {
+        obj.updateMatrixWorld(true);
+        var worldPos = new THREE__namespace.Vector3();
+        obj.getWorldPosition(worldPos);
+        centroid.add(worldPos);
+      });
+      centroid.divideScalar(this.selectedObjects.length);
+
+      // Move the group (and thus the attached gizmo) to the new centroid. Reset any
+      // rotation so the gizmo matches the freshly-created-group convention.
+      this.multiSelectionGroup.position.copy(centroid);
+      this.multiSelectionGroup.rotation.set(0, 0, 0);
+      this.multiSelectionGroup.updateMatrixWorld(true);
+
+      // Refresh cached originals so applyRealtimeTransform's delta stays correct on
+      // the next drag (its "original centroid" is derived from these values).
+      this.selectedObjects.forEach(function (obj) {
+        obj.userData._multiSelectOriginalPosition = obj.position.clone();
+        obj.userData._multiSelectOriginalRotation = obj.rotation.clone();
+        obj.userData._multiSelectOriginalScale = obj.scale.clone();
+        var worldPos = new THREE__namespace.Vector3();
+        obj.getWorldPosition(worldPos);
+        obj.userData._multiSelectOriginalWorldPosition = worldPos;
+      });
+
+      // Keep the gizmo's world matrix in sync with the repositioned group.
+      if ((_this$transformContro = this.transformControls) !== null && _this$transformContro !== void 0 && _this$transformContro.object) {
+        this.transformControls.updateMatrixWorld(true);
+      }
+    }
+
     /**
      * Create a bounding box that encompasses all selected objects
      */
@@ -5494,10 +5553,10 @@ var TransformControlsManager = /*#__PURE__*/function () {
   }, {
     key: "toggleTransformMode",
     value: function toggleTransformMode() {
-      var _this$transformContro;
+      var _this$transformContro2;
       var newMode = this.currentMode === 'translate' ? 'rotate' : 'translate';
       this.setMode(newMode);
-      if ((_this$transformContro = this.transformControls) !== null && _this$transformContro !== void 0 && _this$transformContro.object) {
+      if ((_this$transformContro2 = this.transformControls) !== null && _this$transformContro2 !== void 0 && _this$transformContro2.object) {
         this.transformControls.updateMatrixWorld(true);
       }
     }
@@ -27361,13 +27420,15 @@ var EnvironmentManager = /*#__PURE__*/function () {
               return this.createSkybox();
             case 1:
               this.setupLighting();
-              _context4.n = 2;
-              return this.addTexturedGround();
-            case 2:
-              // await this.addBrickWalls()
               this.addHorizonFog();
-              console.log('Environment initialization completed');
-            case 3:
+
+              // 2. Add ground (synchronously adds basic mesh)
+              // We do NOT await the texture loading here to speed up scene "Ready" state
+              this.addTexturedGround().catch(function (err) {
+                return console.warn('⚠️ Ground texture load failed:', err);
+              });
+              console.log('Environment initialization completed (textures loading in background)');
+            case 2:
               return _context4.a(2);
           }
         }, _callee4, this);
@@ -41823,7 +41884,7 @@ var CentralPlant = /*#__PURE__*/function (_BaseDisposable) {
    * Initialize the CentralPlant manager
    * 
    * @constructor
-   * @version 0.3.56
+   * @version 0.3.58
    * @updated 2025-10-22
    * 
    * @description Creates a new CentralPlant instance and initializes internal managers and utilities.
@@ -44441,23 +44502,18 @@ var CentralPlant = /*#__PURE__*/function (_BaseDisposable) {
     /**
      * Initialize model preloading from component dictionary
      * @param {string} [basePath='/library/'] - Base path for both dictionary and models (can be local path or S3 URL)
-     * @returns {Promise<Object>} Preloading progress results
-     * @description Loads the component dictionary and preloads all models for better performance
-     * @example
-     * // Local files (default)
-     * await centralPlant.initializeModelPreloading()
-     * 
-     * // S3 bucket
-     * await centralPlant.initializeModelPreloading('https://my-bucket.s3.amazonaws.com/library/')
-     * 
-     * // Custom local path
-     * await centralPlant.initializeModelPreloading('/custom/assets/')
+     * @param {Object} [options={}] - Optimization options
+     * @param {boolean} [options.autoPreloadModels=true] - If false, only loads the dictionary and skips preloading GLBs (improves initial load)
+     * @returns {Promise<Object>} Preloading progress results or dictionary summary
      */
   }, {
     key: "initializeModelPreloading",
     value: (function () {
       var _initializeModelPreloading = _asyncToGenerator(/*#__PURE__*/_regenerator().m(function _callee10() {
         var basePath,
+          options,
+          _options$autoPreloadM,
+          autoPreloadModels,
           normalizedBasePath,
           dictionaryPath,
           modelsBasePath,
@@ -44471,6 +44527,8 @@ var CentralPlant = /*#__PURE__*/function (_BaseDisposable) {
           while (1) switch (_context10.n) {
             case 0:
               basePath = _args10.length > 0 && _args10[0] !== undefined ? _args10[0] : '/library/';
+              options = _args10.length > 1 && _args10[1] !== undefined ? _args10[1] : {};
+              _options$autoPreloadM = options.autoPreloadModels, autoPreloadModels = _options$autoPreloadM === void 0 ? true : _options$autoPreloadM;
               _context10.p = 1;
               // Ensure basePath ends with a slash
               normalizedBasePath = basePath.endsWith('/') ? basePath : "".concat(basePath, "/");
@@ -44480,6 +44538,7 @@ var CentralPlant = /*#__PURE__*/function (_BaseDisposable) {
               console.log("\uD83D\uDCC2 Base path: ".concat(normalizedBasePath));
               console.log("\uD83D\uDCDA Dictionary path: ".concat(dictionaryPath));
               console.log("\uFFFD Models path: ".concat(modelsBasePath));
+              console.log("\u26A1 Auto-preload models: ".concat(autoPreloadModels));
 
               // Load the component dictionary
               _context10.n = 2;
@@ -44496,25 +44555,39 @@ var CentralPlant = /*#__PURE__*/function (_BaseDisposable) {
               return response.json();
             case 4:
               componentDictionary = _context10.v;
-              console.log('📚 Component dictionary loaded:', Object.keys(componentDictionary));
+              console.log('📚 Component dictionary loaded:', Object.keys(componentDictionary).length);
 
-              // Start preloading all models with the specified base path
+              // Get the model preloader utility
               _modelPreloader2 = this.getUtility('modelPreloader');
-              _context10.n = 5;
-              return _modelPreloader2.preloadAllModels(componentDictionary, modelsBasePath);
+              if (autoPreloadModels) {
+                _context10.n = 5;
+                break;
+              }
+              console.log('⚡ Lazy loading enabled: skipping automatic GLB preloading');
+              // We still need to give the preloader the dictionary and base path for later use
+              _modelPreloader2.componentDictionary = componentDictionary;
+              _modelPreloader2.setModelsBasePath(modelsBasePath);
+              return _context10.a(2, {
+                successCount: 0,
+                failureCount: 0,
+                dictionaryCount: Object.keys(componentDictionary).length
+              });
             case 5:
+              _context10.n = 6;
+              return _modelPreloader2.preloadAllModels(componentDictionary, modelsBasePath);
+            case 6:
               progress = _context10.v;
               console.log('🎉 Model preloading completed:', progress);
               return _context10.a(2, progress);
-            case 6:
-              _context10.p = 6;
+            case 7:
+              _context10.p = 7;
               _t3 = _context10.v;
               console.error('❌ Failed to initialize model preloading:', _t3);
               throw _t3;
-            case 7:
+            case 8:
               return _context10.a(2);
           }
-        }, _callee10, this, [[1, 6]]);
+        }, _callee10, this, [[1, 7]]);
       }));
       function initializeModelPreloading() {
         return _initializeModelPreloading.apply(this, arguments);
@@ -46484,7 +46557,7 @@ var CacheManager = /*#__PURE__*/function () {
     key: "execute",
     value: (function () {
       var _execute = _asyncToGenerator(/*#__PURE__*/_regenerator().m(function _callee4(_ref) {
-        var cacheKey, sourceKey, expiryMs, fetcher, processor, _ref$metadata, metadata, cacheName, cache, cachedResponse, cachedTime, age, result, fetchResult, blobOrJson, contentType, contentSize, responseBody, headers, cacheResponse, fallbackResult, _t2;
+        var cacheKey, sourceKey, expiryMs, fetcher, processor, _ref$metadata, metadata, cacheName, cache, cachedResponse, cachedTime, age, result, fetchResult, blobOrJson, error, contentType, contentSize, responseBody, headers, cacheResponse, fallbackResult, _t2;
         return _regenerator().w(function (_context4) {
           while (1) switch (_context4.n) {
             case 0:
@@ -46537,7 +46610,9 @@ var CacheManager = /*#__PURE__*/function () {
                 _context4.n = 9;
                 break;
               }
-              throw new Error("Fetch failed: ".concat(fetchResult.status));
+              error = new Error("Fetch failed: ".concat(fetchResult.status)); // Do not retry 404s - the file is genuinely missing
+              if (fetchResult.status === 404) error.noRetry = true;
+              throw error;
             case 9:
               _context4.n = 10;
               return processor(fetchResult.clone());
@@ -46588,20 +46663,29 @@ var CacheManager = /*#__PURE__*/function () {
             case 15:
               fallbackResult = _context4.v;
               if (!(fallbackResult instanceof Response)) {
+                _context4.n = 18;
+                break;
+              }
+              if (fallbackResult.ok) {
                 _context4.n = 16;
                 break;
               }
-              return _context4.a(2, processor(fallbackResult));
+              throw new Error("Fallback fetch failed: ".concat(fallbackResult.status));
             case 16:
-              return _context4.a(2, fallbackResult);
+              _context4.n = 17;
+              return processor(fallbackResult);
             case 17:
-              _context4.p = 17;
+              return _context4.a(2, _context4.v);
+            case 18:
+              return _context4.a(2, fallbackResult);
+            case 19:
+              _context4.p = 19;
               _context4.v;
               throw _t2;
-            case 18:
+            case 20:
               return _context4.a(2);
           }
-        }, _callee4, this, [[14, 17], [1, 13]]);
+        }, _callee4, this, [[14, 19], [1, 13]]);
       }));
       function execute(_x2) {
         return _execute.apply(this, arguments);

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

@@ -58,7 +58,7 @@ var CentralPlant = /*#__PURE__*/function (_BaseDisposable) {
    * Initialize the CentralPlant manager
    * 
    * @constructor
-   * @version 0.3.56
+   * @version 0.3.58
    * @updated 2025-10-22
    * 
    * @description Creates a new CentralPlant instance and initializes internal managers and utilities.
@@ -2676,23 +2676,18 @@ var CentralPlant = /*#__PURE__*/function (_BaseDisposable) {
     /**
      * Initialize model preloading from component dictionary
      * @param {string} [basePath='/library/'] - Base path for both dictionary and models (can be local path or S3 URL)
-     * @returns {Promise<Object>} Preloading progress results
-     * @description Loads the component dictionary and preloads all models for better performance
-     * @example
-     * // Local files (default)
-     * await centralPlant.initializeModelPreloading()
-     * 
-     * // S3 bucket
-     * await centralPlant.initializeModelPreloading('https://my-bucket.s3.amazonaws.com/library/')
-     * 
-     * // Custom local path
-     * await centralPlant.initializeModelPreloading('/custom/assets/')
+     * @param {Object} [options={}] - Optimization options
+     * @param {boolean} [options.autoPreloadModels=true] - If false, only loads the dictionary and skips preloading GLBs (improves initial load)
+     * @returns {Promise<Object>} Preloading progress results or dictionary summary
      */
   }, {
     key: "initializeModelPreloading",
     value: (function () {
       var _initializeModelPreloading = _rollupPluginBabelHelpers.asyncToGenerator(/*#__PURE__*/_rollupPluginBabelHelpers.regenerator().m(function _callee10() {
         var basePath,
+          options,
+          _options$autoPreloadM,
+          autoPreloadModels,
           normalizedBasePath,
           dictionaryPath,
           modelsBasePath,
@@ -2706,6 +2701,8 @@ var CentralPlant = /*#__PURE__*/function (_BaseDisposable) {
           while (1) switch (_context10.n) {
             case 0:
               basePath = _args10.length > 0 && _args10[0] !== undefined ? _args10[0] : '/library/';
+              options = _args10.length > 1 && _args10[1] !== undefined ? _args10[1] : {};
+              _options$autoPreloadM = options.autoPreloadModels, autoPreloadModels = _options$autoPreloadM === void 0 ? true : _options$autoPreloadM;
               _context10.p = 1;
               // Ensure basePath ends with a slash
               normalizedBasePath = basePath.endsWith('/') ? basePath : "".concat(basePath, "/");
@@ -2715,6 +2712,7 @@ var CentralPlant = /*#__PURE__*/function (_BaseDisposable) {
               console.log("\uD83D\uDCC2 Base path: ".concat(normalizedBasePath));
               console.log("\uD83D\uDCDA Dictionary path: ".concat(dictionaryPath));
               console.log("\uFFFD Models path: ".concat(modelsBasePath));
+              console.log("\u26A1 Auto-preload models: ".concat(autoPreloadModels));
 
               // Load the component dictionary
               _context10.n = 2;
@@ -2731,25 +2729,39 @@ var CentralPlant = /*#__PURE__*/function (_BaseDisposable) {
               return response.json();
             case 4:
               componentDictionary = _context10.v;
-              console.log('📚 Component dictionary loaded:', Object.keys(componentDictionary));
+              console.log('📚 Component dictionary loaded:', Object.keys(componentDictionary).length);
 
-              // Start preloading all models with the specified base path
+              // Get the model preloader utility
               _modelPreloader2 = this.getUtility('modelPreloader');
-              _context10.n = 5;
-              return _modelPreloader2.preloadAllModels(componentDictionary, modelsBasePath);
+              if (autoPreloadModels) {
+                _context10.n = 5;
+                break;
+              }
+              console.log('⚡ Lazy loading enabled: skipping automatic GLB preloading');
+              // We still need to give the preloader the dictionary and base path for later use
+              _modelPreloader2.componentDictionary = componentDictionary;
+              _modelPreloader2.setModelsBasePath(modelsBasePath);
+              return _context10.a(2, {
+                successCount: 0,
+                failureCount: 0,
+                dictionaryCount: Object.keys(componentDictionary).length
+              });
             case 5:
+              _context10.n = 6;
+              return _modelPreloader2.preloadAllModels(componentDictionary, modelsBasePath);
+            case 6:
               progress = _context10.v;
               console.log('🎉 Model preloading completed:', progress);
               return _context10.a(2, progress);
-            case 6:
-              _context10.p = 6;
+            case 7:
+              _context10.p = 7;
               _t3 = _context10.v;
               console.error('❌ Failed to initialize model preloading:', _t3);
               throw _t3;
-            case 7:
+            case 8:
               return _context10.a(2);
           }
-        }, _callee10, this, [[1, 6]]);
+        }, _callee10, this, [[1, 7]]);
       }));
       function initializeModelPreloading() {
         return _initializeModelPreloading.apply(this, arguments);

package/dist/cjs/src/managers/cache/CacheManager.js

@@ -202,7 +202,7 @@ var CacheManager = /*#__PURE__*/function () {
     key: "execute",
     value: (function () {
       var _execute = _rollupPluginBabelHelpers.asyncToGenerator(/*#__PURE__*/_rollupPluginBabelHelpers.regenerator().m(function _callee4(_ref) {
-        var cacheKey, sourceKey, expiryMs, fetcher, processor, _ref$metadata, metadata, cacheName, cache, cachedResponse, cachedTime, age, result, fetchResult, blobOrJson, contentType, contentSize, responseBody, headers, cacheResponse, fallbackResult, _t2;
+        var cacheKey, sourceKey, expiryMs, fetcher, processor, _ref$metadata, metadata, cacheName, cache, cachedResponse, cachedTime, age, result, fetchResult, blobOrJson, error, contentType, contentSize, responseBody, headers, cacheResponse, fallbackResult, _t2;
         return _rollupPluginBabelHelpers.regenerator().w(function (_context4) {
           while (1) switch (_context4.n) {
             case 0:
@@ -255,7 +255,9 @@ var CacheManager = /*#__PURE__*/function () {
                 _context4.n = 9;
                 break;
               }
-              throw new Error("Fetch failed: ".concat(fetchResult.status));
+              error = new Error("Fetch failed: ".concat(fetchResult.status)); // Do not retry 404s - the file is genuinely missing
+              if (fetchResult.status === 404) error.noRetry = true;
+              throw error;
             case 9:
               _context4.n = 10;
               return processor(fetchResult.clone());
@@ -306,20 +308,29 @@ var CacheManager = /*#__PURE__*/function () {
             case 15:
               fallbackResult = _context4.v;
               if (!(fallbackResult instanceof Response)) {
+                _context4.n = 18;
+                break;
+              }
+              if (fallbackResult.ok) {
                 _context4.n = 16;
                 break;
               }
-              return _context4.a(2, processor(fallbackResult));
+              throw new Error("Fallback fetch failed: ".concat(fallbackResult.status));
             case 16:
-              return _context4.a(2, fallbackResult);
+              _context4.n = 17;
+              return processor(fallbackResult);
             case 17:
-              _context4.p = 17;
+              return _context4.a(2, _context4.v);
+            case 18:
+              return _context4.a(2, fallbackResult);
+            case 19:
+              _context4.p = 19;
               _context4.v;
               throw _t2;
-            case 18:
+            case 20:
               return _context4.a(2);
           }
-        }, _callee4, this, [[14, 17], [1, 13]]);
+        }, _callee4, this, [[14, 19], [1, 13]]);
       }));
       function execute(_x2) {
         return _execute.apply(this, arguments);

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

@@ -164,6 +164,12 @@ var TransformControlsManager = /*#__PURE__*/function () {
         // Update bounding box if the transformed object is in current selection
         if (_this.selectedObjects.includes(eventData.object)) {
           console.log('🔲 Updating bounding boxes for selected objects after transform');
+          // Reposition the transform gizmo (and its selection group) to follow the
+          // object's new position. Programmatic transforms (e.g. the Transform tab's
+          // Translate/Rotate buttons) move the object directly without touching the
+          // multi-selection group the gizmo is attached to, so without this the widget
+          // would stay at the pre-transform centroid.
+          _this.syncSelectionToObjects();
           _this.updateBoundingBox();
         }
       };
@@ -1270,6 +1276,59 @@ var TransformControlsManager = /*#__PURE__*/function () {
       console.log("\uD83D\uDCE6 Multi-selection group created at centroid:", centroid.toArray());
     }
 
+    /**
+     * Re-sync the multi-selection group (and the attached transform gizmo) to the
+     * current world positions of the selected objects, in place.
+     *
+     * Used after a *programmatic* transform (e.g. the Transform tab's Translate /
+     * Rotate buttons), which mutates the object directly and does not move the
+     * selection group the gizmo is attached to. Unlike a full updateMultiSelection()
+     * this keeps the same group instance so the gizmo doesn't detach/re-attach.
+     *
+     * It also refreshes the cached original transforms so a subsequent gizmo drag
+     * computes its delta from the object's new position rather than jumping.
+     */
+  }, {
+    key: "syncSelectionToObjects",
+    value: function syncSelectionToObjects() {
+      var _this$transformContro;
+      if (!this.multiSelectionGroup || this.selectedObjects.length === 0) {
+        return;
+      }
+
+      // Recompute the centroid from the objects' current world positions.
+      var centroid = new THREE__namespace.Vector3();
+      this.selectedObjects.forEach(function (obj) {
+        obj.updateMatrixWorld(true);
+        var worldPos = new THREE__namespace.Vector3();
+        obj.getWorldPosition(worldPos);
+        centroid.add(worldPos);
+      });
+      centroid.divideScalar(this.selectedObjects.length);
+
+      // Move the group (and thus the attached gizmo) to the new centroid. Reset any
+      // rotation so the gizmo matches the freshly-created-group convention.
+      this.multiSelectionGroup.position.copy(centroid);
+      this.multiSelectionGroup.rotation.set(0, 0, 0);
+      this.multiSelectionGroup.updateMatrixWorld(true);
+
+      // Refresh cached originals so applyRealtimeTransform's delta stays correct on
+      // the next drag (its "original centroid" is derived from these values).
+      this.selectedObjects.forEach(function (obj) {
+        obj.userData._multiSelectOriginalPosition = obj.position.clone();
+        obj.userData._multiSelectOriginalRotation = obj.rotation.clone();
+        obj.userData._multiSelectOriginalScale = obj.scale.clone();
+        var worldPos = new THREE__namespace.Vector3();
+        obj.getWorldPosition(worldPos);
+        obj.userData._multiSelectOriginalWorldPosition = worldPos;
+      });
+
+      // Keep the gizmo's world matrix in sync with the repositioned group.
+      if ((_this$transformContro = this.transformControls) !== null && _this$transformContro !== void 0 && _this$transformContro.object) {
+        this.transformControls.updateMatrixWorld(true);
+      }
+    }
+
     /**
      * Create a bounding box that encompasses all selected objects
      */
@@ -1549,10 +1608,10 @@ var TransformControlsManager = /*#__PURE__*/function () {
   }, {
     key: "toggleTransformMode",
     value: function toggleTransformMode() {
-      var _this$transformContro;
+      var _this$transformContro2;
       var newMode = this.currentMode === 'translate' ? 'rotate' : 'translate';
       this.setMode(newMode);
-      if ((_this$transformContro = this.transformControls) !== null && _this$transformContro !== void 0 && _this$transformContro.object) {
+      if ((_this$transformContro2 = this.transformControls) !== null && _this$transformContro2 !== void 0 && _this$transformContro2.object) {
         this.transformControls.updateMatrixWorld(true);
       }
     }

package/dist/cjs/src/managers/environment/environmentManager.js

@@ -423,13 +423,15 @@ var EnvironmentManager = /*#__PURE__*/function () {
               return this.createSkybox();
             case 1:
               this.setupLighting();
-              _context4.n = 2;
-              return this.addTexturedGround();
-            case 2:
-              // await this.addBrickWalls()
               this.addHorizonFog();
-              console.log('Environment initialization completed');
-            case 3:
+
+              // 2. Add ground (synchronously adds basic mesh)
+              // We do NOT await the texture loading here to speed up scene "Ready" state
+              this.addTexturedGround().catch(function (err) {
+                return console.warn('⚠️ Ground texture load failed:', err);
+              });
+              console.log('Environment initialization completed (textures loading in background)');
+            case 2:
               return _context4.a(2);
           }
         }, _callee4, this);

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

@@ -34,7 +34,7 @@ var CentralPlant = /*#__PURE__*/function (_BaseDisposable) {
    * Initialize the CentralPlant manager
    * 
    * @constructor
-   * @version 0.3.56
+   * @version 0.3.58
    * @updated 2025-10-22
    * 
    * @description Creates a new CentralPlant instance and initializes internal managers and utilities.
@@ -2652,23 +2652,18 @@ var CentralPlant = /*#__PURE__*/function (_BaseDisposable) {
     /**
      * Initialize model preloading from component dictionary
      * @param {string} [basePath='/library/'] - Base path for both dictionary and models (can be local path or S3 URL)
-     * @returns {Promise<Object>} Preloading progress results
-     * @description Loads the component dictionary and preloads all models for better performance
-     * @example
-     * // Local files (default)
-     * await centralPlant.initializeModelPreloading()
-     * 
-     * // S3 bucket
-     * await centralPlant.initializeModelPreloading('https://my-bucket.s3.amazonaws.com/library/')
-     * 
-     * // Custom local path
-     * await centralPlant.initializeModelPreloading('/custom/assets/')
+     * @param {Object} [options={}] - Optimization options
+     * @param {boolean} [options.autoPreloadModels=true] - If false, only loads the dictionary and skips preloading GLBs (improves initial load)
+     * @returns {Promise<Object>} Preloading progress results or dictionary summary
      */
   }, {
     key: "initializeModelPreloading",
     value: (function () {
       var _initializeModelPreloading = _asyncToGenerator(/*#__PURE__*/_regenerator().m(function _callee10() {
         var basePath,
+          options,
+          _options$autoPreloadM,
+          autoPreloadModels,
           normalizedBasePath,
           dictionaryPath,
           modelsBasePath,
@@ -2682,6 +2677,8 @@ var CentralPlant = /*#__PURE__*/function (_BaseDisposable) {
           while (1) switch (_context10.n) {
             case 0:
               basePath = _args10.length > 0 && _args10[0] !== undefined ? _args10[0] : '/library/';
+              options = _args10.length > 1 && _args10[1] !== undefined ? _args10[1] : {};
+              _options$autoPreloadM = options.autoPreloadModels, autoPreloadModels = _options$autoPreloadM === void 0 ? true : _options$autoPreloadM;
               _context10.p = 1;
               // Ensure basePath ends with a slash
               normalizedBasePath = basePath.endsWith('/') ? basePath : "".concat(basePath, "/");
@@ -2691,6 +2688,7 @@ var CentralPlant = /*#__PURE__*/function (_BaseDisposable) {
               console.log("\uD83D\uDCC2 Base path: ".concat(normalizedBasePath));
               console.log("\uD83D\uDCDA Dictionary path: ".concat(dictionaryPath));
               console.log("\uFFFD Models path: ".concat(modelsBasePath));
+              console.log("\u26A1 Auto-preload models: ".concat(autoPreloadModels));
 
               // Load the component dictionary
               _context10.n = 2;
@@ -2707,25 +2705,39 @@ var CentralPlant = /*#__PURE__*/function (_BaseDisposable) {
               return response.json();
             case 4:
               componentDictionary = _context10.v;
-              console.log('📚 Component dictionary loaded:', Object.keys(componentDictionary));
+              console.log('📚 Component dictionary loaded:', Object.keys(componentDictionary).length);
 
-              // Start preloading all models with the specified base path
+              // Get the model preloader utility
               _modelPreloader2 = this.getUtility('modelPreloader');
-              _context10.n = 5;
-              return _modelPreloader2.preloadAllModels(componentDictionary, modelsBasePath);
+              if (autoPreloadModels) {
+                _context10.n = 5;
+                break;
+              }
+              console.log('⚡ Lazy loading enabled: skipping automatic GLB preloading');
+              // We still need to give the preloader the dictionary and base path for later use
+              _modelPreloader2.componentDictionary = componentDictionary;
+              _modelPreloader2.setModelsBasePath(modelsBasePath);
+              return _context10.a(2, {
+                successCount: 0,
+                failureCount: 0,
+                dictionaryCount: Object.keys(componentDictionary).length
+              });
             case 5:
+              _context10.n = 6;
+              return _modelPreloader2.preloadAllModels(componentDictionary, modelsBasePath);
+            case 6:
               progress = _context10.v;
               console.log('🎉 Model preloading completed:', progress);
               return _context10.a(2, progress);
-            case 6:
-              _context10.p = 6;
+            case 7:
+              _context10.p = 7;
               _t3 = _context10.v;
               console.error('❌ Failed to initialize model preloading:', _t3);
               throw _t3;
-            case 7:
+            case 8:
               return _context10.a(2);
           }
-        }, _callee10, this, [[1, 6]]);
+        }, _callee10, this, [[1, 7]]);
       }));
       function initializeModelPreloading() {
         return _initializeModelPreloading.apply(this, arguments);

package/dist/esm/src/managers/cache/CacheManager.js

@@ -198,7 +198,7 @@ var CacheManager = /*#__PURE__*/function () {
     key: "execute",
     value: (function () {
       var _execute = _asyncToGenerator(/*#__PURE__*/_regenerator().m(function _callee4(_ref) {
-        var cacheKey, sourceKey, expiryMs, fetcher, processor, _ref$metadata, metadata, cacheName, cache, cachedResponse, cachedTime, age, result, fetchResult, blobOrJson, contentType, contentSize, responseBody, headers, cacheResponse, fallbackResult, _t2;
+        var cacheKey, sourceKey, expiryMs, fetcher, processor, _ref$metadata, metadata, cacheName, cache, cachedResponse, cachedTime, age, result, fetchResult, blobOrJson, error, contentType, contentSize, responseBody, headers, cacheResponse, fallbackResult, _t2;
         return _regenerator().w(function (_context4) {
           while (1) switch (_context4.n) {
             case 0:
@@ -251,7 +251,9 @@ var CacheManager = /*#__PURE__*/function () {
                 _context4.n = 9;
                 break;
               }
-              throw new Error("Fetch failed: ".concat(fetchResult.status));
+              error = new Error("Fetch failed: ".concat(fetchResult.status)); // Do not retry 404s - the file is genuinely missing
+              if (fetchResult.status === 404) error.noRetry = true;
+              throw error;
             case 9:
               _context4.n = 10;
               return processor(fetchResult.clone());
@@ -302,20 +304,29 @@ var CacheManager = /*#__PURE__*/function () {
             case 15:
               fallbackResult = _context4.v;
               if (!(fallbackResult instanceof Response)) {
+                _context4.n = 18;
+                break;
+              }
+              if (fallbackResult.ok) {
                 _context4.n = 16;
                 break;
               }
-              return _context4.a(2, processor(fallbackResult));
+              throw new Error("Fallback fetch failed: ".concat(fallbackResult.status));
             case 16:
-              return _context4.a(2, fallbackResult);
+              _context4.n = 17;
+              return processor(fallbackResult);
             case 17:
-              _context4.p = 17;
+              return _context4.a(2, _context4.v);
+            case 18:
+              return _context4.a(2, fallbackResult);
+            case 19:
+              _context4.p = 19;
               _context4.v;
               throw _t2;
-            case 18:
+            case 20:
               return _context4.a(2);
           }
-        }, _callee4, this, [[14, 17], [1, 13]]);
+        }, _callee4, this, [[14, 19], [1, 13]]);
       }));
       function execute(_x2) {
         return _execute.apply(this, arguments);

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

@@ -140,6 +140,12 @@ var TransformControlsManager = /*#__PURE__*/function () {
         // Update bounding box if the transformed object is in current selection
         if (_this.selectedObjects.includes(eventData.object)) {
           console.log('🔲 Updating bounding boxes for selected objects after transform');
+          // Reposition the transform gizmo (and its selection group) to follow the
+          // object's new position. Programmatic transforms (e.g. the Transform tab's
+          // Translate/Rotate buttons) move the object directly without touching the
+          // multi-selection group the gizmo is attached to, so without this the widget
+          // would stay at the pre-transform centroid.
+          _this.syncSelectionToObjects();
           _this.updateBoundingBox();
         }
       };
@@ -1246,6 +1252,59 @@ var TransformControlsManager = /*#__PURE__*/function () {
       console.log("\uD83D\uDCE6 Multi-selection group created at centroid:", centroid.toArray());
     }
 
+    /**
+     * Re-sync the multi-selection group (and the attached transform gizmo) to the
+     * current world positions of the selected objects, in place.
+     *
+     * Used after a *programmatic* transform (e.g. the Transform tab's Translate /
+     * Rotate buttons), which mutates the object directly and does not move the
+     * selection group the gizmo is attached to. Unlike a full updateMultiSelection()
+     * this keeps the same group instance so the gizmo doesn't detach/re-attach.
+     *
+     * It also refreshes the cached original transforms so a subsequent gizmo drag
+     * computes its delta from the object's new position rather than jumping.
+     */
+  }, {
+    key: "syncSelectionToObjects",
+    value: function syncSelectionToObjects() {
+      var _this$transformContro;
+      if (!this.multiSelectionGroup || this.selectedObjects.length === 0) {
+        return;
+      }
+
+      // Recompute the centroid from the objects' current world positions.
+      var centroid = new THREE.Vector3();
+      this.selectedObjects.forEach(function (obj) {
+        obj.updateMatrixWorld(true);
+        var worldPos = new THREE.Vector3();
+        obj.getWorldPosition(worldPos);
+        centroid.add(worldPos);
+      });
+      centroid.divideScalar(this.selectedObjects.length);
+
+      // Move the group (and thus the attached gizmo) to the new centroid. Reset any
+      // rotation so the gizmo matches the freshly-created-group convention.
+      this.multiSelectionGroup.position.copy(centroid);
+      this.multiSelectionGroup.rotation.set(0, 0, 0);
+      this.multiSelectionGroup.updateMatrixWorld(true);
+
+      // Refresh cached originals so applyRealtimeTransform's delta stays correct on
+      // the next drag (its "original centroid" is derived from these values).
+      this.selectedObjects.forEach(function (obj) {
+        obj.userData._multiSelectOriginalPosition = obj.position.clone();
+        obj.userData._multiSelectOriginalRotation = obj.rotation.clone();
+        obj.userData._multiSelectOriginalScale = obj.scale.clone();
+        var worldPos = new THREE.Vector3();
+        obj.getWorldPosition(worldPos);
+        obj.userData._multiSelectOriginalWorldPosition = worldPos;
+      });
+
+      // Keep the gizmo's world matrix in sync with the repositioned group.
+      if ((_this$transformContro = this.transformControls) !== null && _this$transformContro !== void 0 && _this$transformContro.object) {
+        this.transformControls.updateMatrixWorld(true);
+      }
+    }
+
     /**
      * Create a bounding box that encompasses all selected objects
      */
@@ -1525,10 +1584,10 @@ var TransformControlsManager = /*#__PURE__*/function () {
   }, {
     key: "toggleTransformMode",
     value: function toggleTransformMode() {
-      var _this$transformContro;
+      var _this$transformContro2;
       var newMode = this.currentMode === 'translate' ? 'rotate' : 'translate';
       this.setMode(newMode);
-      if ((_this$transformContro = this.transformControls) !== null && _this$transformContro !== void 0 && _this$transformContro.object) {
+      if ((_this$transformContro2 = this.transformControls) !== null && _this$transformContro2 !== void 0 && _this$transformContro2.object) {
         this.transformControls.updateMatrixWorld(true);
       }
     }

package/dist/esm/src/managers/environment/environmentManager.js

@@ -399,13 +399,15 @@ var EnvironmentManager = /*#__PURE__*/function () {
               return this.createSkybox();
             case 1:
               this.setupLighting();
-              _context4.n = 2;
-              return this.addTexturedGround();
-            case 2:
-              // await this.addBrickWalls()
               this.addHorizonFog();
-              console.log('Environment initialization completed');
-            case 3:
+
+              // 2. Add ground (synchronously adds basic mesh)
+              // We do NOT await the texture loading here to speed up scene "Ready" state
+              this.addTexturedGround().catch(function (err) {
+                return console.warn('⚠️ Ground texture load failed:', err);
+              });
+              console.log('Environment initialization completed (textures loading in background)');
+            case 2:
               return _context4.a(2);
           }
         }, _callee4, this);

package/package.json

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