@2112-lab/central-plant 0.1.71 → 0.1.73

package/dist/bundle/index.js

@@ -19434,7 +19434,8 @@ var ComponentDataManager = /*#__PURE__*/function (_BaseDisposable) {
         tags: component.tags || [],
         // Preserve S3 metadata
         isS3Component: component.isS3Component,
-        s3Path: component.s3Path
+        s3Path: component.s3Path,
+        preLoad: component.preLoad
       };
       return _objectSpread2(_objectSpread2({}, baseData), {}, {
         metadata: component.metadata || {},
@@ -27929,7 +27930,7 @@ var ModelManager = /*#__PURE__*/function () {
     key: "preloadMissingModels",
     value: (function () {
       var _preloadMissingModels = _asyncToGenerator(/*#__PURE__*/_regenerator().m(function _callee4(data, componentDictionary) {
-        var _data$scene, _data$scene2, requiredModels, preloaderStatus, cachedModels, missingModels, _iterator, _step, modelKey, _t5, _t6;
+        var _data$scene, _data$scene2, requiredModels, preloaderStatus, cachedModels, missingModels, basePath, modelUrls, _iterator, _step, modelKey, _t5, _t6;
         return _regenerator().w(function (_context4) {
           while (1) switch (_context4.n) {
             case 0:
@@ -27946,25 +27947,58 @@ var ModelManager = /*#__PURE__*/function () {
               return _context4.a(2);
             case 1:
               requiredModels = new Set();
+              console.log("\uD83D\uDD0D Checking ".concat(data.scene.children.length, " scene objects for required models..."));
               data.scene.children.forEach(function (child) {
-                var _child$userData, _child$userData2;
-                if ((_child$userData = child.userData) !== null && _child$userData !== void 0 && _child$userData.libraryId && componentDictionary[(_child$userData2 = child.userData) === null || _child$userData2 === void 0 ? void 0 : _child$userData2.libraryId]) {
-                  var _child$userData3;
-                  var modelKey = componentDictionary[(_child$userData3 = child.userData) === null || _child$userData3 === void 0 ? void 0 : _child$userData3.libraryId].modelKey;
-                  if (modelKey) {
-                    requiredModels.add(modelKey);
+                var _child$userData;
+                var libraryId = (_child$userData = child.userData) === null || _child$userData === void 0 ? void 0 : _child$userData.libraryId;
+                if (libraryId) {
+                  if (componentDictionary[libraryId]) {
+                    var modelKey = componentDictionary[libraryId].modelKey;
+                    if (modelKey) {
+                      requiredModels.add(modelKey);
+                      // console.log(`  Found required model for ${libraryId}: ${modelKey}`)
+                    } else {
+                      console.warn("  Item ".concat(libraryId, " has no modelKey in dictionary"));
+                    }
+                  } else {
+                    console.warn("  Item ".concat(libraryId, " found in scene but missing from dictionary"));
                   }
                 }
               });
-              console.log('🔍 Required models for this scene:', Array.from(requiredModels));
+              console.log('🔍 Required models for this scene (Set):', Array.from(requiredModels));
               _context4.n = 2;
               return this.verifyModelPreloaderCache();
             case 2:
               preloaderStatus = _context4.v;
               cachedModels = preloaderStatus.cachedModels;
+              console.log('ModelPreloader cached models:', cachedModels);
+
+              // Calculate missing models for IN-MEMORY preloading
               missingModels = Array.from(requiredModels).filter(function (model) {
                 return !cachedModels.includes(model);
               });
+              console.log('Missing models (calculated):', missingModels);
+
+              // OPTIONAL: Prime persistent browser cache (Cache Storage) using injected primer
+              // We prime ALL required models to ensure they are in the persistent cache, even if already in memory
+              if (requiredModels.size > 0 && this.sceneViewer && this.sceneViewer.centralPlant) {
+                // Construct URLs based on preloader's base path
+                basePath = modelPreloader.modelsBasePath || '/library/models/';
+                modelUrls = Array.from(requiredModels).map(function (key) {
+                  return "".concat(basePath).concat(key);
+                });
+                console.log("\uD83D\uDCBE Priming persistent cache for ".concat(modelUrls.length, " assets..."));
+                this.sceneViewer.centralPlant.primeCache(modelUrls).then(function (result) {
+                  if (result && !result.skipped) {
+                    console.log("\u2705 Persistent cache primed: ".concat(result.success, " success, ").concat(result.failed, " failed"));
+                    if (result.failed > 0) {
+                      console.warn('Cache priming failures:', result.errors);
+                    }
+                  }
+                }).catch(function (err) {
+                  return console.warn('Persistent cache priming failed:', err);
+                });
+              }
               if (!(missingModels.length > 0)) {
                 _context4.n = 12;
                 break;
@@ -27972,7 +28006,7 @@ var ModelManager = /*#__PURE__*/function () {
               console.warn('⚠️ Some required models are not cached:', missingModels);
               console.log('🔄 Attempting to preload missing models...');
 
-              // Preload missing models
+              // Preload missing models (Main in-memory preloader)
               _iterator = _createForOfIteratorHelper(missingModels);
               _context4.p = 3;
               _iterator.s();
@@ -28107,19 +28141,22 @@ var ModelManager = /*#__PURE__*/function () {
     key: "loadComponentDictionary",
     value: (function () {
       var _loadComponentDictionary = _asyncToGenerator(/*#__PURE__*/_regenerator().m(function _callee6() {
-        var response, _t7;
+        var response, dict, _t7;
         return _regenerator().w(function (_context6) {
           while (1) switch (_context6.n) {
             case 0:
               _context6.p = 0;
+              console.log('🔄 ModelManager loading component dictionary...');
               _context6.n = 1;
-              return fetch('./library/component-dictionary.json');
+              return fetch('/library/component-dictionary.json');
             case 1:
               response = _context6.v;
               _context6.n = 2;
               return response.json();
             case 2:
-              return _context6.a(2, _context6.v);
+              dict = _context6.v;
+              console.log('✅ ModelManager loaded dictionary:', Object.keys(dict).length, 'entries');
+              return _context6.a(2, dict);
             case 3:
               _context6.p = 3;
               _t7 = _context6.v;
@@ -29854,9 +29891,9 @@ var SceneOperationsManager = /*#__PURE__*/function () {
               // Store current scene data even for default scene
               component.currentSceneData = data;
 
-              // Use the consolidated scene loading function
+              // Use the consolidated scene loading function (treat as imported to ensure consistent behavior)
               _context8.n = 4;
-              return this.loadSceneData(data, false);
+              return this.loadSceneFromData(data);
             case 4:
               _context8.n = 6;
               break;
@@ -34657,7 +34694,7 @@ var CentralPlant = /*#__PURE__*/function (_BaseDisposable) {
    * Initialize the CentralPlant manager
    * 
    * @constructor
-   * @version 0.1.71
+   * @version 0.1.73
    * @updated 2025-10-22
    * 
    * @description Creates a new CentralPlant instance and initializes internal managers and utilities.
@@ -34696,6 +34733,9 @@ var CentralPlant = /*#__PURE__*/function (_BaseDisposable) {
     // Initialize internals handler
     _this.internals = new CentralPlantInternals(_this);
 
+    // Optional cache primer function (dependency injection)
+    _this.cachePrimer = null;
+
     // Initialize utilities immediately (they don't need scene viewer)
     _this.internals.initializeUtilities();
 
@@ -34723,6 +34763,54 @@ var CentralPlant = /*#__PURE__*/function (_BaseDisposable) {
       return this.internals.setSceneViewer(sceneViewer);
     }
 
+    /**
+     * Set the cache primer function (dependency injection)
+     * @param {Function} primerFn - Function that takes array of URLs and primes the cache
+     */
+  }, {
+    key: "setCachePrimer",
+    value: function setCachePrimer(primerFn) {
+      if (typeof primerFn !== 'function') {
+        console.warn('⚠️ Cache primer must be a function');
+        return;
+      }
+      this.cachePrimer = primerFn;
+      console.log('✅ Cache primer function set');
+    }
+
+    /**
+     * Prime the cache with the given URLs using the injected primer
+     * @param {Array<string>} urls - Array of URLs to cache
+     * @returns {Promise<Object>} Result of priming operation
+     */
+  }, {
+    key: "primeCache",
+    value: (function () {
+      var _primeCache = _asyncToGenerator(/*#__PURE__*/_regenerator().m(function _callee(urls) {
+        return _regenerator().w(function (_context) {
+          while (1) switch (_context.n) {
+            case 0:
+              if (this.cachePrimer) {
+                _context.n = 1;
+                break;
+              }
+              console.log('ℹ️ No cache primer set, skipping explicit cache priming');
+              return _context.a(2, {
+                success: 0,
+                failed: 0,
+                skipped: true
+              });
+            case 1:
+              console.log('🔄 Delegating to injected cache primer...', urls.length, 'urls');
+              return _context.a(2, this.cachePrimer(urls));
+          }
+        }, _callee, this);
+      }));
+      function primeCache(_x) {
+        return _primeCache.apply(this, arguments);
+      }
+      return primeCache;
+    }()
     /**
      * Set all managers and utilities on the scene viewer instance
      * @returns {boolean} True if attachment was successful, false otherwise
@@ -34734,6 +34822,7 @@ var CentralPlant = /*#__PURE__*/function (_BaseDisposable) {
      *   console.log('Managers and utilities attached to component');
      * }
      */
+    )
   }, {
     key: "attachToComponent",
     value: function attachToComponent() {
@@ -34775,12 +34864,12 @@ var CentralPlant = /*#__PURE__*/function (_BaseDisposable) {
   }, {
     key: "setImportedSceneData",
     value: (function () {
-      var _setImportedSceneData = _asyncToGenerator(/*#__PURE__*/_regenerator().m(function _callee(sceneData) {
+      var _setImportedSceneData = _asyncToGenerator(/*#__PURE__*/_regenerator().m(function _callee2(sceneData) {
         var _this$importedSceneDa, _this$importedSceneDa2;
-        return _regenerator().w(function (_context) {
-          while (1) switch (_context.n) {
+        return _regenerator().w(function (_context2) {
+          while (1) switch (_context2.n) {
             case 0:
-              _context.n = 1;
+              _context2.n = 1;
               return this.internals.clearSceneComponents();
             case 1:
               this.importedSceneData = _objectSpread2({}, sceneData);
@@ -34793,11 +34882,11 @@ var CentralPlant = /*#__PURE__*/function (_BaseDisposable) {
               // Reset component counter based on imported components to avoid ID conflicts
               this.internals.resetComponentCounter();
             case 2:
-              return _context.a(2);
+              return _context2.a(2);
           }
-        }, _callee, this);
+        }, _callee2, this);
       }));
-      function setImportedSceneData(_x) {
+      function setImportedSceneData(_x2) {
         return _setImportedSceneData.apply(this, arguments);
       }
       return setImportedSceneData;
@@ -35703,41 +35792,41 @@ var CentralPlant = /*#__PURE__*/function (_BaseDisposable) {
   }, {
     key: "getComponents",
     value: (function () {
-      var _getComponents = _asyncToGenerator(/*#__PURE__*/_regenerator().m(function _callee2() {
+      var _getComponents = _asyncToGenerator(/*#__PURE__*/_regenerator().m(function _callee3() {
         var options,
           validation,
           enhancedOptions,
-          _args2 = arguments,
+          _args3 = arguments,
           _t;
-        return _regenerator().w(function (_context2) {
-          while (1) switch (_context2.n) {
+        return _regenerator().w(function (_context3) {
+          while (1) switch (_context3.n) {
             case 0:
-              options = _args2.length > 0 && _args2[0] !== undefined ? _args2[0] : {};
+              options = _args3.length > 0 && _args3[0] !== undefined ? _args3[0] : {};
               // Validate filter options using centralized validator
               validation = this.internals.validator.validateComponentFilter(options);
               if (validation.isValid) {
-                _context2.n = 1;
+                _context3.n = 1;
                 break;
               }
               console.warn('⚠️ getComponents(): Invalid filter options provided:', validation.message);
-              return _context2.a(2, []);
+              return _context3.a(2, []);
             case 1:
-              _context2.p = 1;
+              _context3.p = 1;
               // Always include metadata
               enhancedOptions = _objectSpread2(_objectSpread2({}, options), {}, {
                 includeMetadata: true
               });
-              _context2.n = 2;
+              _context3.n = 2;
               return this.managers.componentDataManager.getDictionaryComponents(enhancedOptions);
             case 2:
-              return _context2.a(2, _context2.v);
+              return _context3.a(2, _context3.v);
             case 3:
-              _context2.p = 3;
-              _t = _context2.v;
+              _context3.p = 3;
+              _t = _context3.v;
               console.error('❌ getDictionaryComponents(): Error retrieving available components:', _t);
-              return _context2.a(2, []);
+              return _context3.a(2, []);
           }
-        }, _callee2, this, [[1, 3]]);
+        }, _callee3, this, [[1, 3]]);
       }));
       function getComponents() {
         return _getComponents.apply(this, arguments);
@@ -35840,25 +35929,25 @@ var CentralPlant = /*#__PURE__*/function (_BaseDisposable) {
   }, {
     key: "extendComponentDictionary",
     value: (function () {
-      var _extendComponentDictionary = _asyncToGenerator(/*#__PURE__*/_regenerator().m(function _callee3(additionalComponents) {
-        return _regenerator().w(function (_context3) {
-          while (1) switch (_context3.n) {
+      var _extendComponentDictionary = _asyncToGenerator(/*#__PURE__*/_regenerator().m(function _callee4(additionalComponents) {
+        return _regenerator().w(function (_context4) {
+          while (1) switch (_context4.n) {
             case 0:
               if (this.managers.componentDataManager) {
-                _context3.n = 1;
+                _context4.n = 1;
                 break;
               }
               console.warn('⚠️ extendComponentDictionary(): Component data manager not available');
-              return _context3.a(2, false);
+              return _context4.a(2, false);
             case 1:
-              _context3.n = 2;
+              _context4.n = 2;
               return this.managers.componentDataManager.extendComponentDictionary(additionalComponents);
             case 2:
-              return _context3.a(2, _context3.v);
+              return _context4.a(2, _context4.v);
           }
-        }, _callee3, this);
+        }, _callee4, this);
       }));
-      function extendComponentDictionary(_x2) {
+      function extendComponentDictionary(_x3) {
         return _extendComponentDictionary.apply(this, arguments);
       }
       return extendComponentDictionary;
@@ -35879,23 +35968,23 @@ var CentralPlant = /*#__PURE__*/function (_BaseDisposable) {
   }, {
     key: "removeS3Components",
     value: (function () {
-      var _removeS3Components = _asyncToGenerator(/*#__PURE__*/_regenerator().m(function _callee4() {
-        return _regenerator().w(function (_context4) {
-          while (1) switch (_context4.n) {
+      var _removeS3Components = _asyncToGenerator(/*#__PURE__*/_regenerator().m(function _callee5() {
+        return _regenerator().w(function (_context5) {
+          while (1) switch (_context5.n) {
             case 0:
               if (this.managers.componentDataManager) {
-                _context4.n = 1;
+                _context5.n = 1;
                 break;
               }
               console.warn('⚠️ removeS3Components(): Component data manager not available');
-              return _context4.a(2, false);
+              return _context5.a(2, false);
             case 1:
-              _context4.n = 2;
+              _context5.n = 2;
               return this.managers.componentDataManager.removeS3Components();
             case 2:
-              return _context4.a(2, _context4.v);
+              return _context5.a(2, _context5.v);
           }
-        }, _callee4, this);
+        }, _callee5, this);
       }));
       function removeS3Components() {
         return _removeS3Components.apply(this, arguments);
@@ -35919,25 +36008,25 @@ var CentralPlant = /*#__PURE__*/function (_BaseDisposable) {
   }, {
     key: "removeComponentFromDictionary",
     value: (function () {
-      var _removeComponentFromDictionary = _asyncToGenerator(/*#__PURE__*/_regenerator().m(function _callee5(componentKey) {
-        return _regenerator().w(function (_context5) {
-          while (1) switch (_context5.n) {
+      var _removeComponentFromDictionary = _asyncToGenerator(/*#__PURE__*/_regenerator().m(function _callee6(componentKey) {
+        return _regenerator().w(function (_context6) {
+          while (1) switch (_context6.n) {
             case 0:
               if (this.managers.componentDataManager) {
-                _context5.n = 1;
+                _context6.n = 1;
                 break;
               }
               console.warn('⚠️ removeComponentFromDictionary(): Component data manager not available');
-              return _context5.a(2, false);
+              return _context6.a(2, false);
             case 1:
-              _context5.n = 2;
+              _context6.n = 2;
               return this.managers.componentDataManager.removeComponentFromDictionary(componentKey);
             case 2:
-              return _context5.a(2, _context5.v);
+              return _context6.a(2, _context6.v);
           }
-        }, _callee5, this);
+        }, _callee6, this);
       }));
-      function removeComponentFromDictionary(_x3) {
+      function removeComponentFromDictionary(_x4) {
         return _removeComponentFromDictionary.apply(this, arguments);
       }
       return removeComponentFromDictionary;
@@ -36139,51 +36228,51 @@ var CentralPlant = /*#__PURE__*/function (_BaseDisposable) {
   }, {
     key: "initialize2DViewport",
     value: function () {
-      var _initialize2DViewport = _asyncToGenerator(/*#__PURE__*/_regenerator().m(function _callee6(container) {
+      var _initialize2DViewport = _asyncToGenerator(/*#__PURE__*/_regenerator().m(function _callee7(container) {
         var viewType,
           instanceKey,
           success,
-          _args6 = arguments,
+          _args7 = arguments,
           _t2;
-        return _regenerator().w(function (_context6) {
-          while (1) switch (_context6.n) {
+        return _regenerator().w(function (_context7) {
+          while (1) switch (_context7.n) {
             case 0:
-              viewType = _args6.length > 1 && _args6[1] !== undefined ? _args6[1] : 'top';
-              instanceKey = _args6.length > 2 && _args6[2] !== undefined ? _args6[2] : null;
+              viewType = _args7.length > 1 && _args7[1] !== undefined ? _args7[1] : 'top';
+              instanceKey = _args7.length > 2 && _args7[2] !== undefined ? _args7[2] : null;
               if (container) {
-                _context6.n = 1;
+                _context7.n = 1;
                 break;
               }
               console.warn('⚠️ initialize2DViewport(): No container provided');
-              return _context6.a(2, false);
+              return _context7.a(2, false);
             case 1:
               if (this.managers.viewport2DManager) {
-                _context6.n = 2;
+                _context7.n = 2;
                 break;
               }
               console.warn('⚠️ initialize2DViewport(): Viewport2D manager not available');
-              return _context6.a(2, false);
+              return _context7.a(2, false);
             case 2:
-              _context6.p = 2;
-              _context6.n = 3;
+              _context7.p = 2;
+              _context7.n = 3;
               return this.managers.viewport2DManager.initialize(container, viewType, instanceKey);
             case 3:
-              success = _context6.v;
+              success = _context7.v;
               if (success) {
                 console.log("\u2705 2D viewport initialized successfully (".concat(viewType, " view, key: ").concat(instanceKey || viewType, ")"));
               } else {
                 console.warn("\u26A0\uFE0F Failed to initialize 2D viewport (".concat(viewType, " view)"));
               }
-              return _context6.a(2, success);
+              return _context7.a(2, success);
             case 4:
-              _context6.p = 4;
-              _t2 = _context6.v;
+              _context7.p = 4;
+              _t2 = _context7.v;
               console.error('❌ initialize2DViewport(): Error initializing 2D viewport:', _t2);
-              return _context6.a(2, false);
+              return _context7.a(2, false);
           }
-        }, _callee6, this, [[2, 4]]);
+        }, _callee7, this, [[2, 4]]);
       }));
-      function initialize2DViewport(_x4) {
+      function initialize2DViewport(_x5) {
         return _initialize2DViewport.apply(this, arguments);
       }
       return initialize2DViewport;
@@ -36329,7 +36418,7 @@ var CentralPlant = /*#__PURE__*/function (_BaseDisposable) {
   }, {
     key: "initializeModelPreloading",
     value: (function () {
-      var _initializeModelPreloading = _asyncToGenerator(/*#__PURE__*/_regenerator().m(function _callee7() {
+      var _initializeModelPreloading = _asyncToGenerator(/*#__PURE__*/_regenerator().m(function _callee8() {
         var basePath,
           normalizedBasePath,
           dictionaryPath,
@@ -36338,13 +36427,13 @@ var CentralPlant = /*#__PURE__*/function (_BaseDisposable) {
           componentDictionary,
           _modelPreloader2,
           progress,
-          _args7 = arguments,
+          _args8 = arguments,
           _t3;
-        return _regenerator().w(function (_context7) {
-          while (1) switch (_context7.n) {
+        return _regenerator().w(function (_context8) {
+          while (1) switch (_context8.n) {
             case 0:
-              basePath = _args7.length > 0 && _args7[0] !== undefined ? _args7[0] : '/library/';
-              _context7.p = 1;
+              basePath = _args8.length > 0 && _args8[0] !== undefined ? _args8[0] : '/library/';
+              _context8.p = 1;
               // Ensure basePath ends with a slash
               normalizedBasePath = basePath.endsWith('/') ? basePath : "".concat(basePath, "/");
               dictionaryPath = "".concat(normalizedBasePath, "component-dictionary.json");
@@ -36355,39 +36444,39 @@ var CentralPlant = /*#__PURE__*/function (_BaseDisposable) {
               console.log("\uFFFD Models path: ".concat(modelsBasePath));
 
               // Load the component dictionary
-              _context7.n = 2;
+              _context8.n = 2;
               return fetch(dictionaryPath);
             case 2:
-              response = _context7.v;
+              response = _context8.v;
               if (response.ok) {
-                _context7.n = 3;
+                _context8.n = 3;
                 break;
               }
               throw new Error("Failed to load component dictionary: ".concat(response.status));
             case 3:
-              _context7.n = 4;
+              _context8.n = 4;
               return response.json();
             case 4:
-              componentDictionary = _context7.v;
+              componentDictionary = _context8.v;
               console.log('📚 Component dictionary loaded:', Object.keys(componentDictionary));
 
               // Start preloading all models with the specified base path
               _modelPreloader2 = this.getUtility('modelPreloader');
-              _context7.n = 5;
+              _context8.n = 5;
               return _modelPreloader2.preloadAllModels(componentDictionary, modelsBasePath);
             case 5:
-              progress = _context7.v;
+              progress = _context8.v;
               console.log('🎉 Model preloading completed:', progress);
-              return _context7.a(2, progress);
+              return _context8.a(2, progress);
             case 6:
-              _context7.p = 6;
-              _t3 = _context7.v;
+              _context8.p = 6;
+              _t3 = _context8.v;
               console.error('❌ Failed to initialize model preloading:', _t3);
               throw _t3;
             case 7:
-              return _context7.a(2);
+              return _context8.a(2);
           }
-        }, _callee7, this, [[1, 6]]);
+        }, _callee8, this, [[1, 6]]);
       }));
       function initializeModelPreloading() {
         return _initializeModelPreloading.apply(this, arguments);
@@ -36404,57 +36493,57 @@ var CentralPlant = /*#__PURE__*/function (_BaseDisposable) {
   }, {
     key: "importScene",
     value: (function () {
-      var _importScene = _asyncToGenerator(/*#__PURE__*/_regenerator().m(function _callee8(jsonData) {
+      var _importScene = _asyncToGenerator(/*#__PURE__*/_regenerator().m(function _callee9(jsonData) {
         var validation, _t4;
-        return _regenerator().w(function (_context8) {
-          while (1) switch (_context8.n) {
+        return _regenerator().w(function (_context9) {
+          while (1) switch (_context9.n) {
             case 0:
               if (jsonData) {
-                _context8.n = 1;
+                _context9.n = 1;
                 break;
               }
               console.error('❌ No JSON data provided for import');
-              return _context8.a(2, false);
+              return _context9.a(2, false);
             case 1:
-              _context8.p = 1;
+              _context9.p = 1;
               // Validate scene data structure
               validation = this.internals.validateAndAnalyzeSceneData(jsonData);
               if (validation.isValid) {
-                _context8.n = 2;
+                _context9.n = 2;
                 break;
               }
               console.error('❌ Invalid scene data format:', validation.message);
-              return _context8.a(2, false);
+              return _context9.a(2, false);
             case 2:
-              _context8.n = 3;
+              _context9.n = 3;
               return this.setImportedSceneData(jsonData);
             case 3:
               if (!(this.sceneViewer && this.sceneViewer.sceneOperationsManager)) {
-                _context8.n = 5;
+                _context9.n = 5;
                 break;
               }
-              _context8.n = 4;
+              _context9.n = 4;
               return this.sceneViewer.sceneOperationsManager.loadSceneFromData(jsonData);
             case 4:
               console.log('✅ Scene imported successfully');
-              return _context8.a(2, true);
+              return _context9.a(2, true);
             case 5:
               console.error('❌ SceneViewer not available for scene loading');
-              return _context8.a(2, false);
+              return _context9.a(2, false);
             case 6:
-              _context8.n = 8;
+              _context9.n = 8;
               break;
             case 7:
-              _context8.p = 7;
-              _t4 = _context8.v;
+              _context9.p = 7;
+              _t4 = _context9.v;
               console.error('❌ Error importing scene:', _t4);
-              return _context8.a(2, false);
+              return _context9.a(2, false);
             case 8:
-              return _context8.a(2);
+              return _context9.a(2);
           }
-        }, _callee8, this, [[1, 7]]);
+        }, _callee9, this, [[1, 7]]);
       }));
-      function importScene(_x5) {
+      function importScene(_x6) {
         return _importScene.apply(this, arguments);
       }
       return importScene;
@@ -36476,33 +36565,33 @@ var CentralPlant = /*#__PURE__*/function (_BaseDisposable) {
   }, {
     key: "exportSceneJSON",
     value: (function () {
-      var _exportSceneJSON = _asyncToGenerator(/*#__PURE__*/_regenerator().m(function _callee9() {
+      var _exportSceneJSON = _asyncToGenerator(/*#__PURE__*/_regenerator().m(function _callee0() {
         var filename,
-          _args9 = arguments,
+          _args0 = arguments,
           _t5;
-        return _regenerator().w(function (_context9) {
-          while (1) switch (_context9.n) {
+        return _regenerator().w(function (_context0) {
+          while (1) switch (_context0.n) {
             case 0:
-              filename = _args9.length > 0 && _args9[0] !== undefined ? _args9[0] : null;
+              filename = _args0.length > 0 && _args0[0] !== undefined ? _args0[0] : null;
               if (this.managers.sceneExportManager) {
-                _context9.n = 1;
+                _context0.n = 1;
                 break;
               }
               console.error('❌ Scene export manager not available');
-              return _context9.a(2, false);
+              return _context0.a(2, false);
             case 1:
-              _context9.p = 1;
-              _context9.n = 2;
+              _context0.p = 1;
+              _context0.n = 2;
               return this.managers.sceneExportManager.downloadSceneJSON(filename);
             case 2:
-              return _context9.a(2, _context9.v);
+              return _context0.a(2, _context0.v);
             case 3:
-              _context9.p = 3;
-              _t5 = _context9.v;
+              _context0.p = 3;
+              _t5 = _context0.v;
               console.error('❌ Error exporting scene as JSON:', _t5);
-              return _context9.a(2, false);
+              return _context0.a(2, false);
           }
-        }, _callee9, this, [[1, 3]]);
+        }, _callee0, this, [[1, 3]]);
       }));
       function exportSceneJSON() {
         return _exportSceneJSON.apply(this, arguments);
@@ -36527,33 +36616,33 @@ var CentralPlant = /*#__PURE__*/function (_BaseDisposable) {
   }, {
     key: "exportSceneGLTF",
     value: (function () {
-      var _exportSceneGLTF = _asyncToGenerator(/*#__PURE__*/_regenerator().m(function _callee0() {
+      var _exportSceneGLTF = _asyncToGenerator(/*#__PURE__*/_regenerator().m(function _callee1() {
         var filename,
-          _args0 = arguments,
+          _args1 = arguments,
           _t6;
-        return _regenerator().w(function (_context0) {
-          while (1) switch (_context0.n) {
+        return _regenerator().w(function (_context1) {
+          while (1) switch (_context1.n) {
             case 0:
-              filename = _args0.length > 0 && _args0[0] !== undefined ? _args0[0] : null;
+              filename = _args1.length > 0 && _args1[0] !== undefined ? _args1[0] : null;
               if (this.managers.sceneExportManager) {
-                _context0.n = 1;
+                _context1.n = 1;
                 break;
               }
               console.error('❌ Scene export manager not available');
-              return _context0.a(2, false);
+              return _context1.a(2, false);
             case 1:
-              _context0.p = 1;
-              _context0.n = 2;
+              _context1.p = 1;
+              _context1.n = 2;
               return this.managers.sceneExportManager.exportSceneAsGLTF(filename, false);
             case 2:
-              return _context0.a(2, _context0.v);
+              return _context1.a(2, _context1.v);
             case 3:
-              _context0.p = 3;
-              _t6 = _context0.v;
+              _context1.p = 3;
+              _t6 = _context1.v;
               console.error('❌ Error exporting scene as GLTF:', _t6);
-              return _context0.a(2, false);
+              return _context1.a(2, false);
           }
-        }, _callee0, this, [[1, 3]]);
+        }, _callee1, this, [[1, 3]]);
       }));
       function exportSceneGLTF() {
         return _exportSceneGLTF.apply(this, arguments);
@@ -36579,33 +36668,33 @@ var CentralPlant = /*#__PURE__*/function (_BaseDisposable) {
   }, {
     key: "exportSceneGLB",
     value: (function () {
-      var _exportSceneGLB = _asyncToGenerator(/*#__PURE__*/_regenerator().m(function _callee1() {
+      var _exportSceneGLB = _asyncToGenerator(/*#__PURE__*/_regenerator().m(function _callee10() {
         var filename,
-          _args1 = arguments,
+          _args10 = arguments,
           _t7;
-        return _regenerator().w(function (_context1) {
-          while (1) switch (_context1.n) {
+        return _regenerator().w(function (_context10) {
+          while (1) switch (_context10.n) {
             case 0:
-              filename = _args1.length > 0 && _args1[0] !== undefined ? _args1[0] : null;
+              filename = _args10.length > 0 && _args10[0] !== undefined ? _args10[0] : null;
               if (this.managers.sceneExportManager) {
-                _context1.n = 1;
+                _context10.n = 1;
                 break;
               }
               console.error('❌ Scene export manager not available');
-              return _context1.a(2, false);
+              return _context10.a(2, false);
             case 1:
-              _context1.p = 1;
-              _context1.n = 2;
+              _context10.p = 1;
+              _context10.n = 2;
               return this.managers.sceneExportManager.exportSceneAsGLB(filename);
             case 2:
-              return _context1.a(2, _context1.v);
+              return _context10.a(2, _context10.v);
             case 3:
-              _context1.p = 3;
-              _t7 = _context1.v;
+              _context10.p = 3;
+              _t7 = _context10.v;
               console.error('❌ Error exporting scene as GLB:', _t7);
-              return _context1.a(2, false);
+              return _context10.a(2, false);
           }
-        }, _callee1, this, [[1, 3]]);
+        }, _callee10, this, [[1, 3]]);
       }));
       function exportSceneGLB() {
         return _exportSceneGLB.apply(this, arguments);
@@ -36644,18 +36733,18 @@ var CentralPlant = /*#__PURE__*/function (_BaseDisposable) {
   }, {
     key: "loadSceneFromData",
     value: (function () {
-      var _loadSceneFromData = _asyncToGenerator(/*#__PURE__*/_regenerator().m(function _callee10(sceneData) {
-        return _regenerator().w(function (_context10) {
-          while (1) switch (_context10.n) {
+      var _loadSceneFromData = _asyncToGenerator(/*#__PURE__*/_regenerator().m(function _callee11(sceneData) {
+        return _regenerator().w(function (_context11) {
+          while (1) switch (_context11.n) {
             case 0:
-              _context10.n = 1;
+              _context11.n = 1;
               return this.setImportedSceneData(sceneData);
             case 1:
-              return _context10.a(2, true);
+              return _context11.a(2, true);
           }
-        }, _callee10, this);
+        }, _callee11, this);
       }));
-      function loadSceneFromData(_x6) {
+      function loadSceneFromData(_x7) {
         return _loadSceneFromData.apply(this, arguments);
       }
       return loadSceneFromData;
@@ -38005,6 +38094,1078 @@ var SceneHierarchyManager = /*#__PURE__*/function (_BaseDisposable) {
   }]);
 }(BaseDisposable);
 
+/**
+ * Generic Cache Management using Browser Cache API
+ * Framework-agnostic implementation of caching logic
+ */
+
+// Time constants
+var SECOND = 1000;
+var MINUTE = 60 * SECOND;
+var HOUR = 60 * MINUTE;
+var DAY = 24 * HOUR;
+var CACHE_EXPIRY = {
+  MODELS: 7 * DAY,
+  TEXTURES: 7 * DAY,
+  JSON: 24 * HOUR,
+  COMPONENT_DICTIONARY: 24 * HOUR,
+  SCENE_DATA: 12 * HOUR,
+  THUMBNAILS: Infinity,
+  SKYBOXES: 7 * DAY,
+  USER_CONTENT: 6 * HOUR,
+  TEMPORARY: 1 * HOUR,
+  DEFAULT: 24 * HOUR
+};
+var CACHE_NAME_PREFIX = 'central-plant-s3-cache-v1';
+var CacheManager = /*#__PURE__*/function () {
+  function CacheManager() {
+    _classCallCheck(this, CacheManager);
+    this.stats = {
+      hits: 0,
+      misses: 0,
+      errors: 0,
+      totalBytesServed: 0,
+      totalBytesCached: 0,
+      startTime: Date.now()
+    };
+    this.config = {
+      // Default user provider returns null (anonymous)
+      getUser: function () {
+        var _getUser = _asyncToGenerator(/*#__PURE__*/_regenerator().m(function _callee() {
+          return _regenerator().w(function (_context) {
+            while (1) switch (_context.n) {
+              case 0:
+                return _context.a(2, null);
+            }
+          }, _callee);
+        }));
+        function getUser() {
+          return _getUser.apply(this, arguments);
+        }
+        return getUser;
+      }(),
+      // Default error logger
+      onError: function onError(error) {
+        return console.error('CacheManager Error:', error);
+      }
+    };
+  }
+
+  /**
+   * Configure the cache manager
+   */
+  return _createClass(CacheManager, [{
+    key: "configure",
+    value: function configure() {
+      var options = arguments.length > 0 && arguments[0] !== undefined ? arguments[0] : {};
+      this.config = _objectSpread2(_objectSpread2({}, this.config), options);
+    }
+
+    /**
+     * Get cache expiry for a specific file path
+     */
+  }, {
+    key: "getExpiryForPath",
+    value: function getExpiryForPath(path) {
+      var assetType = arguments.length > 1 && arguments[1] !== undefined ? arguments[1] : null;
+      if (assetType && CACHE_EXPIRY[assetType.toUpperCase()]) {
+        return CACHE_EXPIRY[assetType.toUpperCase()];
+      }
+      var lowerPath = path ? path.toLowerCase() : '';
+      if (lowerPath.includes('/models/') || lowerPath.endsWith('.glb') || lowerPath.endsWith('.gltf')) {
+        return CACHE_EXPIRY.MODELS;
+      }
+      if (lowerPath.includes('/textures/') || lowerPath.endsWith('.jpg') || lowerPath.endsWith('.png') || lowerPath.endsWith('.webp')) {
+        return CACHE_EXPIRY.TEXTURES;
+      }
+      if (lowerPath.includes('/thumbnails/')) {
+        return CACHE_EXPIRY.THUMBNAILS;
+      }
+      if (lowerPath.includes('/skyboxes/') || lowerPath.endsWith('.hdr')) {
+        return CACHE_EXPIRY.SKYBOXES;
+      }
+      if (lowerPath.includes('component-dictionary')) {
+        return CACHE_EXPIRY.COMPONENT_DICTIONARY;
+      }
+      if (lowerPath.endsWith('.json')) {
+        return CACHE_EXPIRY.JSON;
+      }
+      return CACHE_EXPIRY.DEFAULT;
+    }
+
+    /**
+     * Get or open the cache handle efficiently
+     */
+  }, {
+    key: "_getCacheHandle",
+    value: (function () {
+      var _getCacheHandle2 = _asyncToGenerator(/*#__PURE__*/_regenerator().m(function _callee2(cacheName) {
+        return _regenerator().w(function (_context2) {
+          while (1) switch (_context2.n) {
+            case 0:
+              if (!(this._activeCacheName === cacheName && this._activeCacheHandle)) {
+                _context2.n = 1;
+                break;
+              }
+              return _context2.a(2, this._activeCacheHandle);
+            case 1:
+              // If we are switching caches, close/drop reference to the old one (GC handles it, but good practice)
+              this._activeCacheName = cacheName;
+              _context2.n = 2;
+              return caches.open(cacheName);
+            case 2:
+              this._activeCacheHandle = _context2.v;
+              return _context2.a(2, this._activeCacheHandle);
+          }
+        }, _callee2, this);
+      }));
+      function _getCacheHandle(_x) {
+        return _getCacheHandle2.apply(this, arguments);
+      }
+      return _getCacheHandle;
+    }()
+    /**
+     * Get the cache name for the current user
+     * Memoized to prevent excessive Auth calls
+     */
+    /**
+     * Resets the identity, forcing a re-fetch of the user/cache name on next access
+     */
+    )
+  }, {
+    key: "resetIdentity",
+    value: function resetIdentity() {
+      this._cachedCacheName = null;
+    }
+
+    /**
+     * Get the cache name for the current user
+     * Memoized indefinitely until resetIdentity() is called
+     */
+  }, {
+    key: "getCacheName",
+    value: (function () {
+      var _getCacheName = _asyncToGenerator(/*#__PURE__*/_regenerator().m(function _callee3() {
+        var user, cacheName, _user$attributes, userId, sanitizedUserId, _t;
+        return _regenerator().w(function (_context3) {
+          while (1) switch (_context3.n) {
+            case 0:
+              if (!this._cachedCacheName) {
+                _context3.n = 1;
+                break;
+              }
+              return _context3.a(2, this._cachedCacheName);
+            case 1:
+              _context3.p = 1;
+              _context3.n = 2;
+              return this.config.getUser();
+            case 2:
+              user = _context3.v;
+              if (!user) {
+                cacheName = "".concat(CACHE_NAME_PREFIX, "-anonymous");
+              } else {
+                userId = typeof user === 'string' ? user : user.username || ((_user$attributes = user.attributes) === null || _user$attributes === void 0 ? void 0 : _user$attributes.sub) || 'anonymous';
+                sanitizedUserId = userId.replace(/[^a-zA-Z0-9-]/g, '-');
+                cacheName = "".concat(CACHE_NAME_PREFIX, "-user-").concat(sanitizedUserId);
+              }
+              this._cachedCacheName = cacheName;
+              return _context3.a(2, cacheName);
+            case 3:
+              _context3.p = 3;
+              _t = _context3.v;
+              console.warn('Failed to get user for cache partition, using anonymous:', _t);
+              return _context3.a(2, "".concat(CACHE_NAME_PREFIX, "-anonymous"));
+          }
+        }, _callee3, this, [[1, 3]]);
+      }));
+      function getCacheName() {
+        return _getCacheName.apply(this, arguments);
+      }
+      return getCacheName;
+    }()
+    /**
+     * Execute a cache operation
+     */
+    )
+  }, {
+    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;
+        return _regenerator().w(function (_context4) {
+          while (1) switch (_context4.n) {
+            case 0:
+              cacheKey = _ref.cacheKey, sourceKey = _ref.sourceKey, expiryMs = _ref.expiryMs, fetcher = _ref.fetcher, processor = _ref.processor, _ref$metadata = _ref.metadata, metadata = _ref$metadata === void 0 ? {} : _ref$metadata, _ref.logType;
+              _context4.p = 1;
+              _context4.n = 2;
+              return this.getCacheName();
+            case 2:
+              cacheName = _context4.v;
+              _context4.n = 3;
+              return this._getCacheHandle(cacheName);
+            case 3:
+              cache = _context4.v;
+              _context4.n = 4;
+              return cache.match(cacheKey);
+            case 4:
+              cachedResponse = _context4.v;
+              if (!cachedResponse) {
+                _context4.n = 7;
+                break;
+              }
+              cachedTime = cachedResponse.headers.get('x-cached-time');
+              age = Date.now() - parseInt(cachedTime || '0');
+              if (!(age < expiryMs)) {
+                _context4.n = 6;
+                break;
+              }
+              _context4.n = 5;
+              return processor(cachedResponse.clone());
+            case 5:
+              result = _context4.v;
+              this.stats.hits++;
+              result instanceof Blob ? result.size : 0;
+              if (result instanceof Blob) this.stats.totalBytesServed += result.size;
+              return _context4.a(2, result);
+            case 6:
+              _context4.n = 7;
+              return cache.delete(cacheKey);
+            case 7:
+              this.stats.misses++;
+              _context4.n = 8;
+              return fetcher();
+            case 8:
+              fetchResult = _context4.v;
+              blobOrJson = fetchResult;
+              if (!(fetchResult instanceof Response)) {
+                _context4.n = 11;
+                break;
+              }
+              if (fetchResult.ok) {
+                _context4.n = 9;
+                break;
+              }
+              throw new Error("Fetch failed: ".concat(fetchResult.status));
+            case 9:
+              _context4.n = 10;
+              return processor(fetchResult.clone());
+            case 10:
+              blobOrJson = _context4.v;
+            case 11:
+              contentType = 'application/octet-stream';
+              contentSize = 0;
+              responseBody = blobOrJson;
+              if (blobOrJson instanceof Blob) {
+                contentType = blobOrJson.type;
+                contentSize = blobOrJson.size;
+                this.stats.totalBytesCached += contentSize;
+                this.stats.totalBytesServed += contentSize;
+              } else {
+                contentType = 'application/json';
+                responseBody = JSON.stringify(blobOrJson);
+                contentSize = responseBody.length;
+              }
+              headers = new Headers(_objectSpread2({
+                'Content-Type': contentType,
+                'x-cached-time': Date.now().toString(),
+                'x-source-key': sourceKey || ''
+              }, metadata));
+              cacheResponse = new Response(responseBody, {
+                headers: headers
+              });
+              _context4.n = 12;
+              return cache.put(cacheKey, cacheResponse);
+            case 12:
+              return _context4.a(2, blobOrJson);
+            case 13:
+              _context4.p = 13;
+              _t2 = _context4.v;
+              this.stats.errors++;
+              this.config.onError(_t2);
+
+              // Fallback
+              _context4.p = 14;
+              _context4.n = 15;
+              return fetcher();
+            case 15:
+              fallbackResult = _context4.v;
+              if (!(fallbackResult instanceof Response)) {
+                _context4.n = 16;
+                break;
+              }
+              return _context4.a(2, processor(fallbackResult));
+            case 16:
+              return _context4.a(2, fallbackResult);
+            case 17:
+              _context4.p = 17;
+              _context4.v;
+              throw _t2;
+            case 18:
+              return _context4.a(2);
+          }
+        }, _callee4, this, [[14, 17], [1, 13]]);
+      }));
+      function execute(_x2) {
+        return _execute.apply(this, arguments);
+      }
+      return execute;
+    }())
+  }, {
+    key: "getGlobalStats",
+    value: function getGlobalStats() {
+      var uptime = Date.now() - this.stats.startTime;
+      return _objectSpread2(_objectSpread2({}, this.stats), {}, {
+        hitRate: this.stats.hits + this.stats.misses > 0 ? (this.stats.hits / (this.stats.hits + this.stats.misses) * 100).toFixed(1) + '%' : '0%',
+        totalMBServed: (this.stats.totalBytesServed / 1024 / 1024).toFixed(2),
+        totalMBCached: (this.stats.totalBytesCached / 1024 / 1024).toFixed(2),
+        uptimeMinutes: (uptime / 1000 / 60).toFixed(1)
+      });
+    }
+  }, {
+    key: "resetStats",
+    value: function resetStats() {
+      this.stats = {
+        hits: 0,
+        misses: 0,
+        errors: 0,
+        totalBytesServed: 0,
+        totalBytesCached: 0,
+        startTime: Date.now()
+      };
+    }
+  }, {
+    key: "clearCache",
+    value: function () {
+      var _clearCache = _asyncToGenerator(/*#__PURE__*/_regenerator().m(function _callee5() {
+        var specificKey,
+          clearAllUsers,
+          cacheName,
+          cache,
+          keys,
+          _iterator,
+          _step,
+          req,
+          cacheNames,
+          appCaches,
+          _iterator2,
+          _step2,
+          name,
+          _cacheName,
+          _args5 = arguments,
+          _t4,
+          _t5,
+          _t6;
+        return _regenerator().w(function (_context5) {
+          while (1) switch (_context5.n) {
+            case 0:
+              specificKey = _args5.length > 0 && _args5[0] !== undefined ? _args5[0] : null;
+              clearAllUsers = _args5.length > 1 && _args5[1] !== undefined ? _args5[1] : false;
+              _context5.p = 1;
+              if (!specificKey) {
+                _context5.n = 12;
+                break;
+              }
+              _context5.n = 2;
+              return this.getCacheName();
+            case 2:
+              cacheName = _context5.v;
+              _context5.n = 3;
+              return caches.open(cacheName);
+            case 3:
+              cache = _context5.v;
+              _context5.n = 4;
+              return cache.keys();
+            case 4:
+              keys = _context5.v;
+              _iterator = _createForOfIteratorHelper(keys);
+              _context5.p = 5;
+              _iterator.s();
+            case 6:
+              if ((_step = _iterator.n()).done) {
+                _context5.n = 8;
+                break;
+              }
+              req = _step.value;
+              if (!req.url.includes(specificKey)) {
+                _context5.n = 7;
+                break;
+              }
+              _context5.n = 7;
+              return cache.delete(req);
+            case 7:
+              _context5.n = 6;
+              break;
+            case 8:
+              _context5.n = 10;
+              break;
+            case 9:
+              _context5.p = 9;
+              _t4 = _context5.v;
+              _iterator.e(_t4);
+            case 10:
+              _context5.p = 10;
+              _iterator.f();
+              return _context5.f(10);
+            case 11:
+              _context5.n = 23;
+              break;
+            case 12:
+              if (!clearAllUsers) {
+                _context5.n = 21;
+                break;
+              }
+              _context5.n = 13;
+              return caches.keys();
+            case 13:
+              cacheNames = _context5.v;
+              appCaches = cacheNames.filter(function (name) {
+                return name.startsWith(CACHE_NAME_PREFIX);
+              });
+              _iterator2 = _createForOfIteratorHelper(appCaches);
+              _context5.p = 14;
+              _iterator2.s();
+            case 15:
+              if ((_step2 = _iterator2.n()).done) {
+                _context5.n = 17;
+                break;
+              }
+              name = _step2.value;
+              _context5.n = 16;
+              return caches.delete(name);
+            case 16:
+              _context5.n = 15;
+              break;
+            case 17:
+              _context5.n = 19;
+              break;
+            case 18:
+              _context5.p = 18;
+              _t5 = _context5.v;
+              _iterator2.e(_t5);
+            case 19:
+              _context5.p = 19;
+              _iterator2.f();
+              return _context5.f(19);
+            case 20:
+              _context5.n = 23;
+              break;
+            case 21:
+              _context5.n = 22;
+              return this.getCacheName();
+            case 22:
+              _cacheName = _context5.v;
+              _context5.n = 23;
+              return caches.delete(_cacheName);
+            case 23:
+              return _context5.a(2, true);
+            case 24:
+              _context5.p = 24;
+              _t6 = _context5.v;
+              this.config.onError(_t6);
+              return _context5.a(2, false);
+          }
+        }, _callee5, this, [[14, 18, 19, 20], [5, 9, 10, 11], [1, 24]]);
+      }));
+      function clearCache() {
+        return _clearCache.apply(this, arguments);
+      }
+      return clearCache;
+    }()
+  }, {
+    key: "cleanExpired",
+    value: function () {
+      var _cleanExpired = _asyncToGenerator(/*#__PURE__*/_regenerator().m(function _callee6() {
+        var cacheName, cache, keys, count, _iterator3, _step3, request, response, cachedTime, age, sourceKey, expiryMs, _t7, _t8;
+        return _regenerator().w(function (_context6) {
+          while (1) switch (_context6.n) {
+            case 0:
+              _context6.p = 0;
+              _context6.n = 1;
+              return this.getCacheName();
+            case 1:
+              cacheName = _context6.v;
+              _context6.n = 2;
+              return this._getCacheHandle(cacheName);
+            case 2:
+              cache = _context6.v;
+              _context6.n = 3;
+              return cache.keys();
+            case 3:
+              keys = _context6.v;
+              count = 0;
+              _iterator3 = _createForOfIteratorHelper(keys);
+              _context6.p = 4;
+              _iterator3.s();
+            case 5:
+              if ((_step3 = _iterator3.n()).done) {
+                _context6.n = 9;
+                break;
+              }
+              request = _step3.value;
+              _context6.n = 6;
+              return cache.match(request);
+            case 6:
+              response = _context6.v;
+              cachedTime = response.headers.get('x-cached-time');
+              age = Date.now() - parseInt(cachedTime || '0');
+              sourceKey = response.headers.get('x-source-key') || request.url;
+              expiryMs = this.getExpiryForPath(sourceKey);
+              if (!(age > expiryMs)) {
+                _context6.n = 8;
+                break;
+              }
+              _context6.n = 7;
+              return cache.delete(request);
+            case 7:
+              count++;
+            case 8:
+              _context6.n = 5;
+              break;
+            case 9:
+              _context6.n = 11;
+              break;
+            case 10:
+              _context6.p = 10;
+              _t7 = _context6.v;
+              _iterator3.e(_t7);
+            case 11:
+              _context6.p = 11;
+              _iterator3.f();
+              return _context6.f(11);
+            case 12:
+              return _context6.a(2, count);
+            case 13:
+              _context6.p = 13;
+              _t8 = _context6.v;
+              this.config.onError(_t8);
+              return _context6.a(2, 0);
+          }
+        }, _callee6, this, [[4, 10, 11, 12], [0, 13]]);
+      }));
+      function cleanExpired() {
+        return _cleanExpired.apply(this, arguments);
+      }
+      return cleanExpired;
+    }()
+  }, {
+    key: "cleanInvalid",
+    value: function () {
+      var _cleanInvalid = _asyncToGenerator(/*#__PURE__*/_regenerator().m(function _callee7() {
+        var cacheName, cache, keys, cleanedCount, _iterator4, _step4, request, url, _t9, _t0;
+        return _regenerator().w(function (_context7) {
+          while (1) switch (_context7.n) {
+            case 0:
+              _context7.p = 0;
+              _context7.n = 1;
+              return this.getCacheName();
+            case 1:
+              cacheName = _context7.v;
+              _context7.n = 2;
+              return this._getCacheHandle(cacheName);
+            case 2:
+              cache = _context7.v;
+              _context7.n = 3;
+              return cache.keys();
+            case 3:
+              keys = _context7.v;
+              cleanedCount = 0;
+              _iterator4 = _createForOfIteratorHelper(keys);
+              _context7.p = 4;
+              _iterator4.s();
+            case 5:
+              if ((_step4 = _iterator4.n()).done) {
+                _context7.n = 8;
+                break;
+              }
+              request = _step4.value;
+              url = request.url;
+              if (!(url.includes('undefined') || url.includes('null') || url.includes('/library/models//'))) {
+                _context7.n = 7;
+                break;
+              }
+              _context7.n = 6;
+              return cache.delete(request);
+            case 6:
+              cleanedCount++;
+            case 7:
+              _context7.n = 5;
+              break;
+            case 8:
+              _context7.n = 10;
+              break;
+            case 9:
+              _context7.p = 9;
+              _t9 = _context7.v;
+              _iterator4.e(_t9);
+            case 10:
+              _context7.p = 10;
+              _iterator4.f();
+              return _context7.f(10);
+            case 11:
+              return _context7.a(2, cleanedCount);
+            case 12:
+              _context7.p = 12;
+              _t0 = _context7.v;
+              this.config.onError(_t0);
+              return _context7.a(2, 0);
+          }
+        }, _callee7, this, [[4, 9, 10, 11], [0, 12]]);
+      }));
+      function cleanInvalid() {
+        return _cleanInvalid.apply(this, arguments);
+      }
+      return cleanInvalid;
+    }()
+    /**
+     * Check if a key exists in cache and is valid
+     */
+  }, {
+    key: "has",
+    value: (function () {
+      var _has = _asyncToGenerator(/*#__PURE__*/_regenerator().m(function _callee8(cacheKey) {
+        var expiryMs,
+          cacheName,
+          cache,
+          response,
+          cachedTime,
+          age,
+          expiry,
+          _args8 = arguments,
+          _t1;
+        return _regenerator().w(function (_context8) {
+          while (1) switch (_context8.n) {
+            case 0:
+              expiryMs = _args8.length > 1 && _args8[1] !== undefined ? _args8[1] : null;
+              _context8.p = 1;
+              _context8.n = 2;
+              return this.getCacheName();
+            case 2:
+              cacheName = _context8.v;
+              _context8.n = 3;
+              return this._getCacheHandle(cacheName);
+            case 3:
+              cache = _context8.v;
+              _context8.n = 4;
+              return cache.match(cacheKey);
+            case 4:
+              response = _context8.v;
+              if (response) {
+                _context8.n = 5;
+                break;
+              }
+              return _context8.a(2, false);
+            case 5:
+              cachedTime = response.headers.get('x-cached-time');
+              age = Date.now() - parseInt(cachedTime || '0');
+              expiry = expiryMs || this.getExpiryForPath(cacheKey);
+              if (!(age < expiry)) {
+                _context8.n = 6;
+                break;
+              }
+              return _context8.a(2, true);
+            case 6:
+              _context8.n = 7;
+              return cache.delete(cacheKey);
+            case 7:
+              return _context8.a(2, false);
+            case 8:
+              _context8.n = 10;
+              break;
+            case 9:
+              _context8.p = 9;
+              _t1 = _context8.v;
+              this.config.onError(_t1);
+              return _context8.a(2, false);
+            case 10:
+              return _context8.a(2);
+          }
+        }, _callee8, this, [[1, 9]]);
+      }));
+      function has(_x3) {
+        return _has.apply(this, arguments);
+      }
+      return has;
+    }()
+    /**
+     * Get a value from cache without fetching (returns null on miss/expiry)
+     */
+    )
+  }, {
+    key: "get",
+    value: (function () {
+      var _get = _asyncToGenerator(/*#__PURE__*/_regenerator().m(function _callee0(cacheKey) {
+        var expiryMs,
+          processor,
+          cacheName,
+          cache,
+          response,
+          cachedTime,
+          age,
+          expiry,
+          _args0 = arguments,
+          _t10;
+        return _regenerator().w(function (_context0) {
+          while (1) switch (_context0.n) {
+            case 0:
+              expiryMs = _args0.length > 1 && _args0[1] !== undefined ? _args0[1] : null;
+              processor = _args0.length > 2 && _args0[2] !== undefined ? _args0[2] : (/*#__PURE__*/function () {
+                var _ref2 = _asyncToGenerator(/*#__PURE__*/_regenerator().m(function _callee9(r) {
+                  return _regenerator().w(function (_context9) {
+                    while (1) switch (_context9.n) {
+                      case 0:
+                        return _context9.a(2, r.json());
+                    }
+                  }, _callee9);
+                }));
+                return function (_x5) {
+                  return _ref2.apply(this, arguments);
+                };
+              }());
+              _context0.p = 1;
+              _context0.n = 2;
+              return this.getCacheName();
+            case 2:
+              cacheName = _context0.v;
+              _context0.n = 3;
+              return this._getCacheHandle(cacheName);
+            case 3:
+              cache = _context0.v;
+              _context0.n = 4;
+              return cache.match(cacheKey);
+            case 4:
+              response = _context0.v;
+              if (response) {
+                _context0.n = 5;
+                break;
+              }
+              return _context0.a(2, null);
+            case 5:
+              cachedTime = response.headers.get('x-cached-time');
+              age = Date.now() - parseInt(cachedTime || '0');
+              expiry = expiryMs || this.getExpiryForPath(cacheKey);
+              if (!(age < expiry)) {
+                _context0.n = 7;
+                break;
+              }
+              this.stats.hits++;
+              _context0.n = 6;
+              return processor(response);
+            case 6:
+              return _context0.a(2, _context0.v);
+            case 7:
+              _context0.n = 8;
+              return cache.delete(cacheKey);
+            case 8:
+              return _context0.a(2, null);
+            case 9:
+              _context0.n = 11;
+              break;
+            case 10:
+              _context0.p = 10;
+              _t10 = _context0.v;
+              this.config.onError(_t10);
+              return _context0.a(2, null);
+            case 11:
+              return _context0.a(2);
+          }
+        }, _callee0, this, [[1, 10]]);
+      }));
+      function get(_x4) {
+        return _get.apply(this, arguments);
+      }
+      return get;
+    }()
+    /**
+     * Delete a specific key from value
+     */
+    )
+  }, {
+    key: "delete",
+    value: (function () {
+      var _delete2 = _asyncToGenerator(/*#__PURE__*/_regenerator().m(function _callee1(cacheKey) {
+        var cacheName, cache, _t11;
+        return _regenerator().w(function (_context1) {
+          while (1) switch (_context1.n) {
+            case 0:
+              _context1.p = 0;
+              _context1.n = 1;
+              return this.getCacheName();
+            case 1:
+              cacheName = _context1.v;
+              _context1.n = 2;
+              return this._getCacheHandle(cacheName);
+            case 2:
+              cache = _context1.v;
+              _context1.n = 3;
+              return cache.delete(cacheKey);
+            case 3:
+              return _context1.a(2, _context1.v);
+            case 4:
+              _context1.p = 4;
+              _t11 = _context1.v;
+              this.config.onError(_t11);
+              return _context1.a(2, false);
+          }
+        }, _callee1, this, [[0, 4]]);
+      }));
+      function _delete(_x6) {
+        return _delete2.apply(this, arguments);
+      }
+      return _delete;
+    }()
+    /**
+     * Delete a specific named cache (partition)
+     */
+    )
+  }, {
+    key: "deleteCache",
+    value: (function () {
+      var _deleteCache = _asyncToGenerator(/*#__PURE__*/_regenerator().m(function _callee10(cacheName) {
+        var _t12;
+        return _regenerator().w(function (_context10) {
+          while (1) switch (_context10.n) {
+            case 0:
+              _context10.p = 0;
+              _context10.n = 1;
+              return caches.delete(cacheName);
+            case 1:
+              return _context10.a(2, _context10.v);
+            case 2:
+              _context10.p = 2;
+              _t12 = _context10.v;
+              this.config.onError(_t12);
+              return _context10.a(2, false);
+          }
+        }, _callee10, this, [[0, 2]]);
+      }));
+      function deleteCache(_x7) {
+        return _deleteCache.apply(this, arguments);
+      }
+      return deleteCache;
+    }())
+  }, {
+    key: "getDetailedStats",
+    value: function () {
+      var _getDetailedStats = _asyncToGenerator(/*#__PURE__*/_regenerator().m(function _callee11() {
+        var allUsers,
+          cacheNames,
+          plantCaches,
+          allStats,
+          _iterator5,
+          _step5,
+          _cacheName2,
+          _cache,
+          _keys,
+          _totalSize,
+          _iterator6,
+          _step6,
+          request,
+          response,
+          blob,
+          grandTotal,
+          cacheName,
+          cache,
+          keys,
+          totalSize,
+          items,
+          _iterator7,
+          _step7,
+          _request,
+          _response,
+          _blob,
+          cachedTime,
+          sourceKey,
+          _args11 = arguments,
+          _t13,
+          _t14,
+          _t15,
+          _t16;
+        return _regenerator().w(function (_context11) {
+          while (1) switch (_context11.n) {
+            case 0:
+              allUsers = _args11.length > 0 && _args11[0] !== undefined ? _args11[0] : false;
+              _context11.p = 1;
+              if (!allUsers) {
+                _context11.n = 21;
+                break;
+              }
+              _context11.n = 2;
+              return caches.keys();
+            case 2:
+              cacheNames = _context11.v;
+              plantCaches = cacheNames.filter(function (name) {
+                return name.startsWith(CACHE_NAME_PREFIX);
+              });
+              allStats = [];
+              _iterator5 = _createForOfIteratorHelper(plantCaches);
+              _context11.p = 3;
+              _iterator5.s();
+            case 4:
+              if ((_step5 = _iterator5.n()).done) {
+                _context11.n = 17;
+                break;
+              }
+              _cacheName2 = _step5.value;
+              _context11.n = 5;
+              return caches.open(_cacheName2);
+            case 5:
+              _cache = _context11.v;
+              _context11.n = 6;
+              return _cache.keys();
+            case 6:
+              _keys = _context11.v;
+              _totalSize = 0;
+              _iterator6 = _createForOfIteratorHelper(_keys);
+              _context11.p = 7;
+              _iterator6.s();
+            case 8:
+              if ((_step6 = _iterator6.n()).done) {
+                _context11.n = 12;
+                break;
+              }
+              request = _step6.value;
+              _context11.n = 9;
+              return _cache.match(request);
+            case 9:
+              response = _context11.v;
+              _context11.n = 10;
+              return response.blob();
+            case 10:
+              blob = _context11.v;
+              _totalSize += blob.size;
+            case 11:
+              _context11.n = 8;
+              break;
+            case 12:
+              _context11.n = 14;
+              break;
+            case 13:
+              _context11.p = 13;
+              _t13 = _context11.v;
+              _iterator6.e(_t13);
+            case 14:
+              _context11.p = 14;
+              _iterator6.f();
+              return _context11.f(14);
+            case 15:
+              allStats.push({
+                cacheName: _cacheName2,
+                count: _keys.length,
+                totalSize: _totalSize,
+                totalSizeMB: (_totalSize / 1024 / 1024).toFixed(2)
+              });
+            case 16:
+              _context11.n = 4;
+              break;
+            case 17:
+              _context11.n = 19;
+              break;
+            case 18:
+              _context11.p = 18;
+              _t14 = _context11.v;
+              _iterator5.e(_t14);
+            case 19:
+              _context11.p = 19;
+              _iterator5.f();
+              return _context11.f(19);
+            case 20:
+              grandTotal = allStats.reduce(function (sum, stat) {
+                return sum + stat.totalSize;
+              }, 0);
+              return _context11.a(2, {
+                caches: allStats,
+                totalCaches: allStats.length,
+                grandTotalSizeMB: (grandTotal / 1024 / 1024).toFixed(2)
+              });
+            case 21:
+              _context11.n = 22;
+              return this.getCacheName();
+            case 22:
+              cacheName = _context11.v;
+              _context11.n = 23;
+              return caches.open(cacheName);
+            case 23:
+              cache = _context11.v;
+              _context11.n = 24;
+              return cache.keys();
+            case 24:
+              keys = _context11.v;
+              totalSize = 0;
+              items = [];
+              _iterator7 = _createForOfIteratorHelper(keys);
+              _context11.p = 25;
+              _iterator7.s();
+            case 26:
+              if ((_step7 = _iterator7.n()).done) {
+                _context11.n = 30;
+                break;
+              }
+              _request = _step7.value;
+              _context11.n = 27;
+              return cache.match(_request);
+            case 27:
+              _response = _context11.v;
+              _context11.n = 28;
+              return _response.blob();
+            case 28:
+              _blob = _context11.v;
+              cachedTime = _response.headers.get('x-cached-time'); // Try to get key from headers or fallback
+              sourceKey = _response.headers.get('x-source-key') || _response.headers.get('x-s3-key') || _response.headers.get('x-local-path') || _request.url;
+              totalSize += _blob.size;
+              items.push({
+                url: _request.url,
+                sourceKey: sourceKey,
+                size: _blob.size,
+                sizeMB: (_blob.size / 1024 / 1024).toFixed(2),
+                type: _blob.type,
+                cachedTime: parseInt(cachedTime || '0'),
+                age: Date.now() - parseInt(cachedTime || '0')
+              });
+            case 29:
+              _context11.n = 26;
+              break;
+            case 30:
+              _context11.n = 32;
+              break;
+            case 31:
+              _context11.p = 31;
+              _t15 = _context11.v;
+              _iterator7.e(_t15);
+            case 32:
+              _context11.p = 32;
+              _iterator7.f();
+              return _context11.f(32);
+            case 33:
+              return _context11.a(2, {
+                count: keys.length,
+                totalSize: totalSize,
+                totalSizeMB: (totalSize / 1024 / 1024).toFixed(2),
+                items: items.sort(function (a, b) {
+                  return b.size - a.size;
+                })
+              });
+            case 34:
+              _context11.p = 34;
+              _t16 = _context11.v;
+              this.config.onError(_t16);
+              return _context11.a(2, {
+                count: 0,
+                totalSize: 0,
+                totalSizeMB: '0',
+                items: []
+              });
+          }
+        }, _callee11, this, [[25, 31, 32, 33], [7, 13, 14, 15], [3, 18, 19, 20], [1, 34]]);
+      }));
+      function getDetailedStats() {
+        return _getDetailedStats.apply(this, arguments);
+      }
+      return getDetailedStats;
+    }()
+  }]);
+}();
+var cacheManager = new CacheManager();
+
 var Rendering2D = /*#__PURE__*/function (_BaseDisposable) {
   function Rendering2D(_canvas) {
     var _this;
@@ -39319,6 +40480,9 @@ var rendering3D = /*#__PURE__*/Object.freeze({
 });
 
 exports.AnimationManager = AnimationManager;
+exports.CACHE_EXPIRY = CACHE_EXPIRY;
+exports.CACHE_NAME_PREFIX = CACHE_NAME_PREFIX;
+exports.CacheManager = CacheManager;
 exports.CameraControlsManager = CameraControlsManager;
 exports.CentralPlant = CentralPlant;
 exports.ComponentDataManager = ComponentDataManager;
@@ -39340,6 +40504,7 @@ exports.SceneOperationsManager = SceneOperationsManager;
 exports.SceneTooltipsManager = SceneTooltipsManager;
 exports.SnapshotManager = SnapshotManager;
 exports.ThreeJSResourceManager = ThreeJSResourceManager;
+exports.cacheManager = cacheManager;
 exports.createPathfindingRequest = createPathfindingRequest;
 exports.createTransformControls = createTransformControls;
 exports.findObjectByHardcodedUuid = findObjectByHardcodedUuid;