@2112-lab/central-plant 0.3.21 → 0.3.22

package/dist/bundle/index.js

@@ -31463,12 +31463,12 @@ var ModelManager = /*#__PURE__*/function () {
     key: "loadLibraryModel",
     value: function () {
       var _loadLibraryModel = _asyncToGenerator(/*#__PURE__*/_regenerator().m(function _callee(targetMesh, jsonEntry, componentData) {
-        var component, _jsonEntry$userData, _jsonEntry$userData2, _jsonEntry$userData3, originalProps, connectorChildren, gltfScene, libraryModel, _jsonEntry$userData4, _t;
-        return _regenerator().w(function (_context) {
-          while (1) switch (_context.n) {
+        var component, _jsonEntry$userData, _jsonEntry$userData2, _jsonEntry$userData3, originalProps, connectorChildren, gltfScene, libraryModel, _this$sceneViewer, ioAnimMgr, _loop, _i, _Object$entries, _jsonEntry$userData4, _t;
+        return _regenerator().w(function (_context2) {
+          while (1) switch (_context2.n) {
             case 0:
               component = this.sceneViewer;
-              _context.p = 1;
+              _context2.p = 1;
               console.log("Loading library GLB model for ".concat((_jsonEntry$userData = jsonEntry.userData) === null || _jsonEntry$userData === void 0 ? void 0 : _jsonEntry$userData.libraryId, "..."));
 
               // Store original mesh properties before async operation
@@ -31481,16 +31481,16 @@ var ModelManager = /*#__PURE__*/function () {
                 uuid: targetMesh.uuid
               }; // Preserve connector children (pass parent UUID for proper connector UUID generation)
               connectorChildren = this._preserveConnectorChildren(targetMesh, originalProps.uuid); // Get model from cache or load directly
-              _context.n = 2;
+              _context2.n = 2;
               return this._getLibraryModel(componentData.modelKey, (_jsonEntry$userData2 = jsonEntry.userData) === null || _jsonEntry$userData2 === void 0 ? void 0 : _jsonEntry$userData2.libraryId);
             case 2:
-              gltfScene = _context.v;
+              gltfScene = _context2.v;
               if (gltfScene) {
-                _context.n = 3;
+                _context2.n = 3;
                 break;
               }
               console.warn("\u26A0\uFE0F Could not load model ".concat(componentData.modelKey, ", keeping original mesh"));
-              return _context.a(2, targetMesh);
+              return _context2.a(2, targetMesh);
             case 3:
               // Configure the loaded model
               libraryModel = this._configureLibraryModel(gltfScene, jsonEntry, componentData, originalProps); // Add preserved connectors
@@ -31500,23 +31500,74 @@ var ModelManager = /*#__PURE__*/function () {
 
               // Attach IO devices for smart components (import flow)
               if (!(componentData.isSmart && componentData.attachedDevices)) {
-                _context.n = 4;
+                _context2.n = 8;
                 break;
               }
-              _context.n = 4;
+              _context2.n = 4;
               return attachIODevicesToComponent(libraryModel, componentData, modelPreloader, originalProps.uuid);
             case 4:
+              // Register animation configs for each attached device
+              ioAnimMgr = (_this$sceneViewer = this.sceneViewer) === null || _this$sceneViewer === void 0 || (_this$sceneViewer = _this$sceneViewer.managers) === null || _this$sceneViewer === void 0 ? void 0 : _this$sceneViewer.ioAnimationManager;
+              if (!ioAnimMgr) {
+                _context2.n = 8;
+                break;
+              }
+              _loop = /*#__PURE__*/_regenerator().m(function _loop() {
+                var _modelPreloader$compo;
+                var _Object$entries$_i, attachmentId, attachment, deviceData, deviceRoot;
+                return _regenerator().w(function (_context) {
+                  while (1) switch (_context.n) {
+                    case 0:
+                      _Object$entries$_i = _slicedToArray(_Object$entries[_i], 2), attachmentId = _Object$entries$_i[0], attachment = _Object$entries$_i[1];
+                      deviceData = (_modelPreloader$compo = modelPreloader.componentDictionary) === null || _modelPreloader$compo === void 0 ? void 0 : _modelPreloader$compo[attachment.deviceId];
+                      if (deviceData !== null && deviceData !== void 0 && deviceData.animationConfig) {
+                        _context.n = 1;
+                        break;
+                      }
+                      return _context.a(2, 1);
+                    case 1:
+                      deviceRoot = null;
+                      libraryModel.traverse(function (obj) {
+                        var _obj$userData;
+                        if (!deviceRoot && ((_obj$userData = obj.userData) === null || _obj$userData === void 0 ? void 0 : _obj$userData.attachmentId) === attachmentId) deviceRoot = obj;
+                      });
+                      if (deviceRoot) {
+                        ioAnimMgr.loadAnimations(attachmentId, deviceData.animationConfig, deviceRoot, originalProps.uuid);
+                      }
+                    case 2:
+                      return _context.a(2);
+                  }
+                }, _loop);
+              });
+              _i = 0, _Object$entries = Object.entries(componentData.attachedDevices);
+            case 5:
+              if (!(_i < _Object$entries.length)) {
+                _context2.n = 8;
+                break;
+              }
+              return _context2.d(_regeneratorValues(_loop()), 6);
+            case 6:
+              if (!_context2.v) {
+                _context2.n = 7;
+                break;
+              }
+              return _context2.a(3, 7);
+            case 7:
+              _i++;
+              _context2.n = 5;
+              break;
+            case 8:
               // Replace mesh in scene
               this._replaceMeshInScene(targetMesh, libraryModel, originalProps.parent, component);
               console.log("\uD83C\uDF89 ".concat((_jsonEntry$userData3 = jsonEntry.userData) === null || _jsonEntry$userData3 === void 0 ? void 0 : _jsonEntry$userData3.libraryId, " GLB model successfully rendered in scene"));
-              return _context.a(2, libraryModel);
-            case 5:
-              _context.p = 5;
-              _t = _context.v;
+              return _context2.a(2, libraryModel);
+            case 9:
+              _context2.p = 9;
+              _t = _context2.v;
               console.error("\u274C Error loading ".concat((_jsonEntry$userData4 = jsonEntry.userData) === null || _jsonEntry$userData4 === void 0 ? void 0 : _jsonEntry$userData4.libraryId, " GLB model:"), _t);
-              return _context.a(2, targetMesh);
+              return _context2.a(2, targetMesh);
           }
-        }, _callee, this, [[1, 5]]);
+        }, _callee, this, [[1, 9]]);
       }));
       function loadLibraryModel(_x, _x2, _x3) {
         return _loadLibraryModel.apply(this, arguments);
@@ -31595,84 +31646,84 @@ var ModelManager = /*#__PURE__*/function () {
       var _getLibraryModel2 = _asyncToGenerator(/*#__PURE__*/_regenerator().m(function _callee2(modelKey, libraryId) {
         var _this2 = this;
         var gltfScene, preloaderStatus, modelPath, gltf, _t2, _t3, _t4;
-        return _regenerator().w(function (_context2) {
-          while (1) switch (_context2.n) {
+        return _regenerator().w(function (_context3) {
+          while (1) switch (_context3.n) {
             case 0:
               // Try cache first
               gltfScene = modelPreloader.getCachedModelWithDimensions(modelKey, libraryId);
               if (!gltfScene) {
-                _context2.n = 1;
+                _context3.n = 1;
                 break;
               }
               console.log("\uD83C\uDFAF GLB cache HIT: ".concat(modelKey));
-              return _context2.a(2, gltfScene);
+              return _context3.a(2, gltfScene);
             case 1:
               // Check if preloading is in progress
               preloaderStatus = modelPreloader.getStatus();
               if (!preloaderStatus.isPreloading) {
-                _context2.n = 6;
+                _context3.n = 6;
                 break;
               }
               console.log("\u23F3 Waiting for preloader: ".concat(modelKey));
-              _context2.p = 2;
-              _context2.n = 3;
+              _context3.p = 2;
+              _context3.n = 3;
               return modelPreloader.preloadingPromise;
             case 3:
               gltfScene = modelPreloader.getCachedModelWithDimensions(modelKey, libraryId);
               if (!gltfScene) {
-                _context2.n = 4;
+                _context3.n = 4;
                 break;
               }
               console.log("\uD83C\uDFAF GLB cache HIT (after preload): ".concat(modelKey));
-              return _context2.a(2, gltfScene);
+              return _context3.a(2, gltfScene);
             case 4:
-              _context2.n = 6;
+              _context3.n = 6;
               break;
             case 5:
-              _context2.p = 5;
-              _t2 = _context2.v;
+              _context3.p = 5;
+              _t2 = _context3.v;
               console.warn("\u26A0\uFE0F Preloading failed:", _t2);
             case 6:
-              _context2.p = 6;
+              _context3.p = 6;
               if (!modelPreloader.urlResolver) {
-                _context2.n = 11;
+                _context3.n = 11;
                 break;
               }
-              _context2.p = 7;
-              _context2.n = 8;
+              _context3.p = 7;
+              _context3.n = 8;
               return modelPreloader.urlResolver(modelKey);
             case 8:
-              modelPath = _context2.v;
+              modelPath = _context3.v;
               console.log("\uD83D\uDD17 Resolved URL for ".concat(modelKey));
-              _context2.n = 10;
+              _context3.n = 10;
               break;
             case 9:
-              _context2.p = 9;
-              _t3 = _context2.v;
+              _context3.p = 9;
+              _t3 = _context3.v;
               console.warn("\u26A0\uFE0F URL resolver failed for ".concat(modelKey, ", falling back to local path:"), _t3);
               modelPath = "".concat(modelPreloader.modelsBasePath).concat(modelKey);
             case 10:
-              _context2.n = 12;
+              _context3.n = 12;
               break;
             case 11:
               modelPath = "".concat(modelPreloader.modelsBasePath).concat(modelKey);
             case 12:
               console.log("\uD83D\uDCC2 Fallback loading from: ".concat(modelPath));
-              _context2.n = 13;
+              _context3.n = 13;
               return new Promise(function (resolve, reject) {
                 _this2.sceneViewer.gltfLoader.load(modelPath, resolve, undefined, reject);
               });
             case 13:
-              gltf = _context2.v;
+              gltf = _context3.v;
               if (libraryId) {
                 modelPreloader.cacheModel(modelKey, gltf.scene.clone(), libraryId);
               }
-              return _context2.a(2, gltf.scene);
+              return _context3.a(2, gltf.scene);
             case 14:
-              _context2.p = 14;
-              _t4 = _context2.v;
+              _context3.p = 14;
+              _t4 = _context3.v;
               console.error("Failed to load model ".concat(modelKey, ":"), _t4);
-              return _context2.a(2, null);
+              return _context3.a(2, null);
           }
         }, _callee2, null, [[7, 9], [6, 14], [2, 5]]);
       }));
@@ -31779,8 +31830,8 @@ var ModelManager = /*#__PURE__*/function () {
     value: (function () {
       var _verifyModelPreloaderCache = _asyncToGenerator(/*#__PURE__*/_regenerator().m(function _callee3() {
         var preloaderStatus, _t5;
-        return _regenerator().w(function (_context3) {
-          while (1) switch (_context3.n) {
+        return _regenerator().w(function (_context4) {
+          while (1) switch (_context4.n) {
             case 0:
               console.log('🔍 Verifying model preloader cache state...');
               preloaderStatus = modelPreloader.getStatus();
@@ -31788,23 +31839,23 @@ var ModelManager = /*#__PURE__*/function () {
 
               // If preloading is still in progress, wait for completion
               if (!preloaderStatus.isPreloading) {
-                _context3.n = 4;
+                _context4.n = 4;
                 break;
               }
               console.log('⏳ Waiting for model preloading to complete...');
-              _context3.p = 1;
-              _context3.n = 2;
+              _context4.p = 1;
+              _context4.n = 2;
               return modelPreloader.preloadingPromise;
             case 2:
               console.log('✅ Model preloading completed');
-              _context3.n = 4;
+              _context4.n = 4;
               break;
             case 3:
-              _context3.p = 3;
-              _t5 = _context3.v;
+              _context4.p = 3;
+              _t5 = _context4.v;
               console.warn('⚠️ Model preloading failed, some models may load directly:', _t5);
             case 4:
-              return _context3.a(2, preloaderStatus);
+              return _context4.a(2, preloaderStatus);
           }
         }, _callee3, null, [[1, 3]]);
       }));
@@ -31822,11 +31873,11 @@ var ModelManager = /*#__PURE__*/function () {
     value: (function () {
       var _preloadMissingModels = _asyncToGenerator(/*#__PURE__*/_regenerator().m(function _callee4(data, componentDictionary) {
         var _data$scene, _data$scene2, requiredModels, preloaderStatus, cachedModels, missingModels, basePath, modelUrls, _iterator, _step, modelKey, _t6, _t7;
-        return _regenerator().w(function (_context4) {
-          while (1) switch (_context4.n) {
+        return _regenerator().w(function (_context5) {
+          while (1) switch (_context5.n) {
             case 0:
               if (!(!data || !data.scene || !Array.isArray(data.scene.children))) {
-                _context4.n = 1;
+                _context5.n = 1;
                 break;
               }
               console.warn('⚠️ Invalid scene data structure in preloadMissingModels:', {
@@ -31835,7 +31886,7 @@ var ModelManager = /*#__PURE__*/function () {
                 hasChildren: !!(data !== null && data !== void 0 && (_data$scene = data.scene) !== null && _data$scene !== void 0 && _data$scene.children),
                 childrenType: data !== null && data !== void 0 && (_data$scene2 = data.scene) !== null && _data$scene2 !== void 0 && _data$scene2.children ? _typeof(data.scene.children) : 'undefined'
               });
-              return _context4.a(2);
+              return _context5.a(2);
             case 1:
               requiredModels = new Set();
               console.log("\uD83D\uDD0D Checking ".concat(data.scene.children.length, " scene objects for required models..."));
@@ -31857,10 +31908,10 @@ var ModelManager = /*#__PURE__*/function () {
                 }
               });
               console.log('🔍 Required models for this scene (Set):', Array.from(requiredModels));
-              _context4.n = 2;
+              _context5.n = 2;
               return this.verifyModelPreloaderCache();
             case 2:
-              preloaderStatus = _context4.v;
+              preloaderStatus = _context5.v;
               cachedModels = preloaderStatus.cachedModels;
               console.log('ModelPreloader cached models:', cachedModels);
 
@@ -31891,7 +31942,7 @@ var ModelManager = /*#__PURE__*/function () {
                 });
               }
               if (!(missingModels.length > 0)) {
-                _context4.n = 12;
+                _context5.n = 12;
                 break;
               }
               console.warn('⚠️ Some required models are not cached:', missingModels);
@@ -31899,41 +31950,41 @@ var ModelManager = /*#__PURE__*/function () {
 
               // Preload missing models (Main in-memory preloader)
               _iterator = _createForOfIteratorHelper(missingModels);
-              _context4.p = 3;
+              _context5.p = 3;
               _iterator.s();
             case 4:
               if ((_step = _iterator.n()).done) {
-                _context4.n = 9;
+                _context5.n = 9;
                 break;
               }
               modelKey = _step.value;
-              _context4.p = 5;
-              _context4.n = 6;
+              _context5.p = 5;
+              _context5.n = 6;
               return modelPreloader.preloadSingleModel(modelKey);
             case 6:
               console.log("\u2705 Successfully preloaded missing model: ".concat(modelKey));
-              _context4.n = 8;
+              _context5.n = 8;
               break;
             case 7:
-              _context4.p = 7;
-              _t6 = _context4.v;
+              _context5.p = 7;
+              _t6 = _context5.v;
               console.warn("\u274C Failed to preload missing model ".concat(modelKey, ":"), _t6);
             case 8:
-              _context4.n = 4;
+              _context5.n = 4;
               break;
             case 9:
-              _context4.n = 11;
+              _context5.n = 11;
               break;
             case 10:
-              _context4.p = 10;
-              _t7 = _context4.v;
+              _context5.p = 10;
+              _t7 = _context5.v;
               _iterator.e(_t7);
             case 11:
-              _context4.p = 11;
+              _context5.p = 11;
               _iterator.f();
-              return _context4.f(11);
+              return _context5.f(11);
             case 12:
-              return _context4.a(2);
+              return _context5.a(2);
           }
         }, _callee4, this, [[5, 7], [3, 10, 11, 12]]);
       }));
@@ -31952,14 +32003,14 @@ var ModelManager = /*#__PURE__*/function () {
       var _replaceWithGLBModels = _asyncToGenerator(/*#__PURE__*/_regenerator().m(function _callee5(libraryObjectsToReplace) {
         var _this3 = this;
         var startTime, glbLoadingPromises;
-        return _regenerator().w(function (_context5) {
-          while (1) switch (_context5.n) {
+        return _regenerator().w(function (_context6) {
+          while (1) switch (_context6.n) {
             case 0:
               if (!(libraryObjectsToReplace.length === 0)) {
-                _context5.n = 1;
+                _context6.n = 1;
                 break;
               }
-              return _context5.a(2);
+              return _context6.a(2);
             case 1:
               startTime = performance.now();
               console.log("\uD83D\uDD04 Replacing ".concat(libraryObjectsToReplace.length, " objects with GLB models..."));
@@ -31979,7 +32030,7 @@ var ModelManager = /*#__PURE__*/function () {
                   return basicObject;
                 });
               });
-              _context5.n = 2;
+              _context6.n = 2;
               return Promise.all(glbLoadingPromises);
             case 2:
               console.log("\u23F1\uFE0F All GLB models loaded in ".concat((performance.now() - startTime).toFixed(0), "ms"));
@@ -32022,7 +32073,7 @@ var ModelManager = /*#__PURE__*/function () {
                 }));
               }
             case 3:
-              return _context5.a(2);
+              return _context6.a(2);
           }
         }, _callee5);
       }));
@@ -32057,26 +32108,26 @@ var ModelManager = /*#__PURE__*/function () {
     value: (function () {
       var _loadComponentDictionary = _asyncToGenerator(/*#__PURE__*/_regenerator().m(function _callee6() {
         var response, dict, _t8;
-        return _regenerator().w(function (_context6) {
-          while (1) switch (_context6.n) {
+        return _regenerator().w(function (_context7) {
+          while (1) switch (_context7.n) {
             case 0:
-              _context6.p = 0;
+              _context7.p = 0;
               console.log('🔄 ModelManager loading component dictionary...');
-              _context6.n = 1;
+              _context7.n = 1;
               return fetch('/library/component-dictionary.json');
             case 1:
-              response = _context6.v;
-              _context6.n = 2;
+              response = _context7.v;
+              _context7.n = 2;
               return response.json();
             case 2:
-              dict = _context6.v;
+              dict = _context7.v;
               console.log('✅ ModelManager loaded dictionary:', Object.keys(dict).length, 'entries');
-              return _context6.a(2, dict);
+              return _context7.a(2, dict);
             case 3:
-              _context6.p = 3;
-              _t8 = _context6.v;
+              _context7.p = 3;
+              _t8 = _context7.v;
               console.warn('⚠️ Could not load component dictionary:', _t8);
-              return _context6.a(2, {});
+              return _context7.a(2, {});
           }
         }, _callee6, null, [[0, 3]]);
       }));
@@ -36978,7 +37029,7 @@ var ComponentTooltipManager = /*#__PURE__*/function (_BaseDisposable) {
   }, {
     key: "toggleIODeviceBinaryState",
     value: function toggleIODeviceBinaryState(ioDeviceObject) {
-      var _ref, _this$sceneViewer;
+      var _ref, _this$sceneViewer, _this$sceneViewer2;
       if (!ioDeviceObject || !this._stateAdapter) return;
       var ud = ioDeviceObject.userData;
       var attachmentId = ud === null || ud === void 0 ? void 0 : ud.attachmentId;
@@ -37013,6 +37064,7 @@ var ComponentTooltipManager = /*#__PURE__*/function (_BaseDisposable) {
       var newVal = !Boolean(currentVal);
       this._stateAdapter.setState(scopedAttachmentId, dpId, newVal);
       (_this$sceneViewer = this.sceneViewer) === null || _this$sceneViewer === void 0 || (_this$sceneViewer = _this$sceneViewer.managers) === null || _this$sceneViewer === void 0 || (_this$sceneViewer = _this$sceneViewer.behaviorManager) === null || _this$sceneViewer === void 0 || _this$sceneViewer.triggerState(attachmentId, dpId, newVal, parentUuid);
+      (_this$sceneViewer2 = this.sceneViewer) === null || _this$sceneViewer2 === void 0 || (_this$sceneViewer2 = _this$sceneViewer2.managers) === null || _this$sceneViewer2 === void 0 || (_this$sceneViewer2 = _this$sceneViewer2.ioAnimationManager) === null || _this$sceneViewer2 === void 0 || _this$sceneViewer2.triggerState(attachmentId, dpId, newVal, parentUuid);
       console.log("\uD83D\uDD04 [IODevice] Toggled ".concat(scopedAttachmentId, ".").concat(dpId, ": ").concat(currentVal, " \u2192 ").concat(newVal));
     }
 
@@ -37286,11 +37338,11 @@ var ComponentTooltipManager = /*#__PURE__*/function (_BaseDisposable) {
   }, {
     key: "_positionTooltip",
     value: function _positionTooltip() {
-      var _this$sceneViewer2, _this$sceneViewer3;
+      var _this$sceneViewer3, _this$sceneViewer4;
       if (!this.tooltipEl || !this.selectedObject) return;
       var container = this._getContainer();
-      var camera = (_this$sceneViewer2 = this.sceneViewer) === null || _this$sceneViewer2 === void 0 ? void 0 : _this$sceneViewer2.camera;
-      var renderer = (_this$sceneViewer3 = this.sceneViewer) === null || _this$sceneViewer3 === void 0 ? void 0 : _this$sceneViewer3.renderer;
+      var camera = (_this$sceneViewer3 = this.sceneViewer) === null || _this$sceneViewer3 === void 0 ? void 0 : _this$sceneViewer3.camera;
+      var renderer = (_this$sceneViewer4 = this.sceneViewer) === null || _this$sceneViewer4 === void 0 ? void 0 : _this$sceneViewer4.renderer;
       if (!container || !camera || !renderer) return;
 
       // Compute bounding box to position above the component
@@ -37327,8 +37379,8 @@ var ComponentTooltipManager = /*#__PURE__*/function (_BaseDisposable) {
   }, {
     key: "_getContainer",
     value: function _getContainer() {
-      var _this$sceneViewer4;
-      return ((_this$sceneViewer4 = this.sceneViewer) === null || _this$sceneViewer4 === void 0 || (_this$sceneViewer4 = _this$sceneViewer4.renderer) === null || _this$sceneViewer4 === void 0 || (_this$sceneViewer4 = _this$sceneViewer4.domElement) === null || _this$sceneViewer4 === void 0 ? void 0 : _this$sceneViewer4.parentElement) || null;
+      var _this$sceneViewer5;
+      return ((_this$sceneViewer5 = this.sceneViewer) === null || _this$sceneViewer5 === void 0 || (_this$sceneViewer5 = _this$sceneViewer5.renderer) === null || _this$sceneViewer5 === void 0 || (_this$sceneViewer5 = _this$sceneViewer5.domElement) === null || _this$sceneViewer5 === void 0 ? void 0 : _this$sceneViewer5.parentElement) || null;
     }
 
     // -----------------------------------------------------------------------
@@ -37368,7 +37420,7 @@ var ComponentTooltipManager = /*#__PURE__*/function (_BaseDisposable) {
       var currentVal = (_ref2 = (_this$_stateAdapter$g = (_this$_stateAdapter = this._stateAdapter) === null || _this$_stateAdapter === void 0 ? void 0 : _this$_stateAdapter.getState(scopedAttachmentId, dpId)) !== null && _this$_stateAdapter$g !== void 0 ? _this$_stateAdapter$g : dp.defaultValue) !== null && _ref2 !== void 0 ? _ref2 : null;
       if (isInput) {
         var ctrl = this._buildInputControl(dp, currentVal, function (newVal) {
-          var _this4$_stateAdapter, _this4$selectedObject, _this4$sceneViewer;
+          var _this4$_stateAdapter, _this4$selectedObject, _this4$sceneViewer, _this4$sceneViewer2;
           (_this4$_stateAdapter = _this4._stateAdapter) === null || _this4$_stateAdapter === void 0 || _this4$_stateAdapter.setState(scopedAttachmentId, dpId, newVal);
           // Also fire BehaviorManager so any wired behaviors react immediately.
           // Pass the parent component UUID so behaviors scoped to a specific instance
@@ -37376,6 +37428,7 @@ var ComponentTooltipManager = /*#__PURE__*/function (_BaseDisposable) {
           // Use originalAttachmentId for behavior triggering as behaviors are keyed by original ID
           var parentUuid = ((_this4$selectedObject = _this4.selectedObject) === null || _this4$selectedObject === void 0 ? void 0 : _this4$selectedObject.uuid) || null;
           (_this4$sceneViewer = _this4.sceneViewer) === null || _this4$sceneViewer === void 0 || (_this4$sceneViewer = _this4$sceneViewer.managers) === null || _this4$sceneViewer === void 0 || (_this4$sceneViewer = _this4$sceneViewer.behaviorManager) === null || _this4$sceneViewer === void 0 || _this4$sceneViewer.triggerState(originalAttachmentId || scopedAttachmentId, dpId, newVal, parentUuid);
+          (_this4$sceneViewer2 = _this4.sceneViewer) === null || _this4$sceneViewer2 === void 0 || (_this4$sceneViewer2 = _this4$sceneViewer2.managers) === null || _this4$sceneViewer2 === void 0 || (_this4$sceneViewer2 = _this4$sceneViewer2.ioAnimationManager) === null || _this4$sceneViewer2 === void 0 || _this4$sceneViewer2.triggerState(originalAttachmentId || scopedAttachmentId, dpId, newVal, parentUuid);
         });
         row.appendChild(ctrl);
         this._stateElements.set(key, {
@@ -37547,6 +37600,399 @@ var ComponentTooltipManager = /*#__PURE__*/function (_BaseDisposable) {
   }]);
 }(BaseDisposable);
 
+var IoAnimationManager = /*#__PURE__*/function (_BaseDisposable) {
+  function IoAnimationManager(sceneViewer) {
+    var _this;
+    _classCallCheck(this, IoAnimationManager);
+    _this = _callSuper(this, IoAnimationManager);
+    _this.sceneViewer = sceneViewer;
+
+    /**
+     * Map: `${parentUuid}::${attachmentId}` → Array<{
+     *   anim: Object,
+     *   mesh: THREE.Object3D,
+     *   origPos: THREE.Vector3,
+     *   origRot: THREE.Euler
+     * }>
+     */
+    _this._entries = new Map();
+    return _this;
+  }
+
+  // ─────────────────────────────────────────────────────────────────────────
+  // PUBLIC API
+  // ─────────────────────────────────────────────────────────────────────────
+
+  /**
+   * Register animation entries for one attached I/O device.
+   * Should be called after the device GLB has been merged into the scene
+   * so that mesh references are live.
+   *
+   * @param {string} attachmentId - The attachment key (e.g. 'attch-switch-01')
+   * @param {Object|Array} animationConfig - Serialized config; either the full object
+   *   { animations: [...] } or a plain array of animation entries.
+   * @param {THREE.Object3D} deviceModelRoot - The device's root Object3D as added to the scene
+   * @param {string} parentUuid - UUID of the host component Object3D
+   */
+  _inherits(IoAnimationManager, _BaseDisposable);
+  return _createClass(IoAnimationManager, [{
+    key: "loadAnimations",
+    value: function loadAnimations(attachmentId, animationConfig, deviceModelRoot, parentUuid) {
+      var _animationConfig$anim;
+      if (!animationConfig || !deviceModelRoot) return;
+      var anims = Array.isArray(animationConfig) ? animationConfig : (_animationConfig$anim = animationConfig.animations) !== null && _animationConfig$anim !== void 0 ? _animationConfig$anim : [];
+      if (!anims.length) return;
+      var key = this._key(parentUuid, attachmentId);
+      var entries = [];
+      var _iterator = _createForOfIteratorHelper(anims),
+        _step;
+      try {
+        for (_iterator.s(); !(_step = _iterator.n()).done;) {
+          var anim = _step.value;
+          var mesh = this._resolveMesh(anim, deviceModelRoot);
+          if (!mesh) {
+            console.warn("[IoAnimationManager] Could not find mesh for animation \"".concat(anim.name || anim.stateVariable, "\" (uuid: ").concat(anim.meshUuid, ", name: \"").concat(anim.meshName, "\")"));
+            continue;
+          }
+          entries.push({
+            anim: anim,
+            mesh: mesh,
+            origPos: mesh.position.clone(),
+            origRot: mesh.rotation.clone()
+          });
+        }
+      } catch (err) {
+        _iterator.e(err);
+      } finally {
+        _iterator.f();
+      }
+      if (entries.length) {
+        this._entries.set(key, entries);
+        console.log("[IoAnimationManager] Loaded ".concat(entries.length, " animation(s) for attachment \"").concat(attachmentId, "\" (parent: ").concat(parentUuid, ")"));
+      }
+    }
+
+    /**
+     * Apply animations triggered by an IO device state change.
+     * Should be called in parallel with BehaviorManager.triggerState().
+     *
+     * @param {string} attachmentId - Raw attachment key (not scoped)
+     * @param {string} dataPointId  - The data point / state variable id that changed
+     * @param {*}      value        - New state value
+     * @param {string} parentUuid   - UUID of the host component
+     */
+  }, {
+    key: "triggerState",
+    value: function triggerState(attachmentId, dataPointId, value, parentUuid) {
+      var key = this._key(parentUuid, attachmentId);
+      var entries = this._entries.get(key);
+      if (!(entries !== null && entries !== void 0 && entries.length)) return;
+      var _iterator2 = _createForOfIteratorHelper(entries),
+        _step2;
+      try {
+        for (_iterator2.s(); !(_step2 = _iterator2.n()).done;) {
+          var entry = _step2.value;
+          if (entry.anim.stateVariable !== dataPointId) continue;
+          this._applyAnimation(entry, value);
+        }
+      } catch (err) {
+        _iterator2.e(err);
+      } finally {
+        _iterator2.f();
+      }
+    }
+
+    /**
+     * Remove all animation entries associated with a given host component.
+     * Call when a component is removed from the scene.
+     *
+     * @param {string} parentUuid
+     */
+  }, {
+    key: "unloadForComponent",
+    value: function unloadForComponent(parentUuid) {
+      var prefix = "".concat(parentUuid, "::");
+      var _iterator3 = _createForOfIteratorHelper(this._entries.keys()),
+        _step3;
+      try {
+        for (_iterator3.s(); !(_step3 = _iterator3.n()).done;) {
+          var key = _step3.value;
+          if (key.startsWith(prefix)) {
+            this._entries.delete(key);
+          }
+        }
+      } catch (err) {
+        _iterator3.e(err);
+      } finally {
+        _iterator3.f();
+      }
+    }
+  }, {
+    key: "dispose",
+    value: function dispose() {
+      this._entries.clear();
+      _superPropGet(IoAnimationManager, "dispose", this, 3)([]);
+    }
+
+    // ─────────────────────────────────────────────────────────────────────────
+    // PRIVATE HELPERS
+    // ─────────────────────────────────────────────────────────────────────────
+  }, {
+    key: "_key",
+    value: function _key(parentUuid, attachmentId) {
+      return "".concat(parentUuid, "::").concat(attachmentId);
+    }
+
+    /**
+     * Find the mesh inside `root` using UUID first, then name as fallback.
+     * GLTFLoader assigns fresh UUIDs on every load, so name is the reliable key.
+     * @param {Object} anim
+     * @param {THREE.Object3D} root
+     * @returns {THREE.Object3D|null}
+     */
+  }, {
+    key: "_resolveMesh",
+    value: function _resolveMesh(anim, root) {
+      var found = null;
+      root.traverse(function (obj) {
+        if (found) return;
+
+        // Prefer UUID match (works when the device was cloned from a cached instance
+        // whose UUIDs were preserved)
+        if (anim.meshUuid && obj.uuid === anim.meshUuid) {
+          found = obj;
+          return;
+        }
+
+        // Reliable fallback: mesh name
+        if (anim.meshName && obj.name === anim.meshName) {
+          found = obj;
+        }
+      });
+      return found;
+    }
+
+    /**
+     * Resolve which mapping row to use and apply all declared transform types.
+     * @param {{ anim, mesh, origPos, origRot }} entry
+     * @param {*} value - Current state value
+     */
+  }, {
+    key: "_applyAnimation",
+    value: function _applyAnimation(entry, value) {
+      var anim = entry.anim,
+        mesh = entry.mesh,
+        origPos = entry.origPos,
+        origRot = entry.origRot;
+      var mapping = this._resolveMapping(anim, value);
+      if (!mapping) return;
+      var types = anim.transformTypes || [];
+      var _iterator4 = _createForOfIteratorHelper(types),
+        _step4;
+      try {
+        for (_iterator4.s(); !(_step4 = _iterator4.n()).done;) {
+          var type = _step4.value;
+          if (type === 'translation') {
+            this._applyTranslation(mesh, origPos, mapping.transform);
+          } else if (type === 'rotation') {
+            this._applyRotation(mesh, origPos, origRot, anim, mapping.rotationTransform);
+          } else if (type === 'color') {
+            this._applyColor(mesh, mapping.colorTransform);
+          }
+        }
+      } catch (err) {
+        _iterator4.e(err);
+      } finally {
+        _iterator4.f();
+      }
+    }
+
+    /**
+     * Find the mapping row that matches `value` for the given animation entry.
+     *
+     * - binary / enum: find where mapping.stateValue == value (loose equality so
+     *   JSON-deserialised "true" matches boolean true)
+     * - continuous: linear interpolation between ordered anchor points
+     *
+     * @returns {Object|null} The matched/interpolated mapping row, or null.
+     */
+  }, {
+    key: "_resolveMapping",
+    value: function _resolveMapping(anim, value) {
+      var stateType = anim.stateType,
+        mappings = anim.mappings;
+      if (!(mappings !== null && mappings !== void 0 && mappings.length)) return null;
+      if (stateType === 'binary' || stateType === 'enum') {
+        var _mappings$find;
+        // eslint-disable-next-line eqeqeq
+        return (_mappings$find = mappings.find(function (m) {
+          return m.stateValue == value;
+        })) !== null && _mappings$find !== void 0 ? _mappings$find : null;
+      }
+      if (stateType === 'continuous') {
+        var num = Number(value);
+        if (isNaN(num)) return null;
+
+        // Sort anchors by numeric stateValue
+        var sorted = _toConsumableArray(mappings).filter(function (m) {
+          return m.stateValue != null && !isNaN(Number(m.stateValue));
+        }).sort(function (a, b) {
+          return Number(a.stateValue) - Number(b.stateValue);
+        });
+        if (!sorted.length) return null;
+        if (sorted.length === 1) return sorted[0];
+
+        // Clamp to range
+        if (num <= Number(sorted[0].stateValue)) return sorted[0];
+        if (num >= Number(sorted[sorted.length - 1].stateValue)) return sorted[sorted.length - 1];
+
+        // Find surrounding anchors and interpolate
+        for (var i = 0; i < sorted.length - 1; i++) {
+          var lo = sorted[i];
+          var hi = sorted[i + 1];
+          var loVal = Number(lo.stateValue);
+          var hiVal = Number(hi.stateValue);
+          if (num >= loVal && num <= hiVal) {
+            var t = (num - loVal) / (hiVal - loVal);
+            return this._lerpMapping(lo, hi, t);
+          }
+        }
+      }
+      return null;
+    }
+
+    /**
+     * Linear-interpolate between two mapping rows.
+     * @param {Object} lo - lower anchor mapping
+     * @param {Object} hi - upper anchor mapping
+     * @param {number} t  - 0..1
+     */
+  }, {
+    key: "_lerpMapping",
+    value: function _lerpMapping(lo, hi, t) {
+      var _lo$transform$x, _lo$transform, _hi$transform$x, _hi$transform, _lo$transform$y, _lo$transform2, _hi$transform$y, _hi$transform2, _lo$transform$z, _lo$transform3, _hi$transform$z, _hi$transform3;
+      var lerp = function lerp(a, b) {
+        return a + (b - a) * t;
+      };
+      var transform = {
+        x: lerp((_lo$transform$x = (_lo$transform = lo.transform) === null || _lo$transform === void 0 ? void 0 : _lo$transform.x) !== null && _lo$transform$x !== void 0 ? _lo$transform$x : 0, (_hi$transform$x = (_hi$transform = hi.transform) === null || _hi$transform === void 0 ? void 0 : _hi$transform.x) !== null && _hi$transform$x !== void 0 ? _hi$transform$x : 0),
+        y: lerp((_lo$transform$y = (_lo$transform2 = lo.transform) === null || _lo$transform2 === void 0 ? void 0 : _lo$transform2.y) !== null && _lo$transform$y !== void 0 ? _lo$transform$y : 0, (_hi$transform$y = (_hi$transform2 = hi.transform) === null || _hi$transform2 === void 0 ? void 0 : _hi$transform2.y) !== null && _hi$transform$y !== void 0 ? _hi$transform$y : 0),
+        z: lerp((_lo$transform$z = (_lo$transform3 = lo.transform) === null || _lo$transform3 === void 0 ? void 0 : _lo$transform3.z) !== null && _lo$transform$z !== void 0 ? _lo$transform$z : 0, (_hi$transform$z = (_hi$transform3 = hi.transform) === null || _hi$transform3 === void 0 ? void 0 : _hi$transform3.z) !== null && _hi$transform$z !== void 0 ? _hi$transform$z : 0)
+      };
+      var rotationTransform = lerp(typeof lo.rotationTransform === 'number' ? lo.rotationTransform : 0, typeof hi.rotationTransform === 'number' ? hi.rotationTransform : 0);
+
+      // Color interpolation: convert hex → RGB components → lerp → back to hex
+      var colorTransform = this._lerpHex(lo.colorTransform, hi.colorTransform, t);
+      return {
+        stateValue: null,
+        transform: transform,
+        rotationTransform: rotationTransform,
+        colorTransform: colorTransform
+      };
+    }
+
+    /**
+     * Interpolate between two hex colour strings.
+     */
+  }, {
+    key: "_lerpHex",
+    value: function _lerpHex(hexA, hexB, t) {
+      try {
+        var ca = new THREE__namespace.Color(hexA);
+        var cb = new THREE__namespace.Color(hexB);
+        ca.lerp(cb, t);
+        return "#".concat(ca.getHexString());
+      } catch (_unused) {
+        return hexA !== null && hexA !== void 0 ? hexA : '#ffffff';
+      }
+    }
+
+    // ─────────────────────────────────────────────────────────────────────────
+    // TRANSFORM APPLIERS
+    // ─────────────────────────────────────────────────────────────────────────
+
+    /**
+     * Apply a position delta relative to the mesh's original position.
+     * @param {THREE.Object3D} mesh
+     * @param {THREE.Vector3} origPos
+     * @param {{ x, y, z }} transform - Deltas
+     */
+  }, {
+    key: "_applyTranslation",
+    value: function _applyTranslation(mesh, origPos, transform) {
+      var _transform$x, _transform$y, _transform$z;
+      if (!transform) return;
+      mesh.position.set(origPos.x + ((_transform$x = transform.x) !== null && _transform$x !== void 0 ? _transform$x : 0), origPos.y + ((_transform$y = transform.y) !== null && _transform$y !== void 0 ? _transform$y : 0), origPos.z + ((_transform$z = transform.z) !== null && _transform$z !== void 0 ? _transform$z : 0));
+    }
+
+    /**
+     * Apply a rotation around an arbitrary pivot point in device-local space,
+     * optionally also displacing the mesh position to simulate orbital motion.
+     *
+     * Math (all in device-local space):
+     *   pivot   = rotAxisOffset
+     *   delta   = origPos - pivot
+     *   newDelta = rotate(delta, angle, axis)
+     *   newPos  = pivot + newDelta
+     *   newRot[axis] = origRot[axis] + angle
+     *
+     * @param {THREE.Object3D} mesh
+     * @param {THREE.Vector3}  origPos
+     * @param {THREE.Euler}    origRot
+     * @param {Object}         anim
+     * @param {number}         angleDeg - Degrees
+     */
+  }, {
+    key: "_applyRotation",
+    value: function _applyRotation(mesh, origPos, origRot, anim, angleDeg) {
+      var _anim$rotAxis, _anim$rotAxisOffset, _off$x, _off$y, _off$z;
+      var angle = THREE__namespace.MathUtils.degToRad(typeof angleDeg === 'number' ? angleDeg : 0);
+      var axis = ((_anim$rotAxis = anim.rotAxis) !== null && _anim$rotAxis !== void 0 ? _anim$rotAxis : 'x').toLowerCase();
+      var off = (_anim$rotAxisOffset = anim.rotAxisOffset) !== null && _anim$rotAxisOffset !== void 0 ? _anim$rotAxisOffset : {
+        x: 0,
+        y: 0,
+        z: 0
+      };
+
+      // Unit vector for the chosen axis
+      var axisVec = new THREE__namespace.Vector3(axis === 'x' ? 1 : 0, axis === 'y' ? 1 : 0, axis === 'z' ? 1 : 0);
+      var pivot = new THREE__namespace.Vector3((_off$x = off.x) !== null && _off$x !== void 0 ? _off$x : 0, (_off$y = off.y) !== null && _off$y !== void 0 ? _off$y : 0, (_off$z = off.z) !== null && _off$z !== void 0 ? _off$z : 0);
+      var delta = origPos.clone().sub(pivot);
+      delta.applyAxisAngle(axisVec, angle);
+      mesh.position.copy(pivot).add(delta);
+      mesh.rotation[axis] = origRot[axis] + angle;
+    }
+
+    /**
+     * Apply a colour to all Mesh descendants of `mesh`.
+     * Creates a cloned material per mesh on first call to avoid shared-material
+     * cross-contamination between different device instances.
+     *
+     * @param {THREE.Object3D} mesh
+     * @param {string} colorHex - e.g. '#ff0000'
+     */
+  }, {
+    key: "_applyColor",
+    value: function _applyColor(mesh, colorHex) {
+      if (!colorHex) return;
+      mesh.traverse(function (obj) {
+        if (!obj.isMesh || !obj.material) return;
+
+        // Ensure this mesh has its own material instance
+        if (!obj.userData._materialCloned) {
+          obj.material = obj.material.clone();
+          obj.userData._materialCloned = true;
+        }
+        try {
+          obj.material.color.set(colorHex);
+        } catch (e) {
+          // Material may not have a color property (e.g. MeshDepthMaterial)
+        }
+      });
+    }
+  }]);
+}(BaseDisposable);
+
 // ─────────────────────────────────────────────────────────────────────────────
 // Flow-direction helpers (module-level)
 // ─────────────────────────────────────────────────────────────────────────────
@@ -37668,6 +38114,7 @@ var CentralPlantInternals = /*#__PURE__*/function () {
       this.centralPlant.managers.cameraControlsManager = new CameraControlsManager(this.centralPlant.sceneViewer);
       this.centralPlant.managers.componentDragManager = new ComponentDragManager(this.centralPlant.sceneViewer);
       this.centralPlant.managers.viewport2DManager = new Viewport2DManager(this.centralPlant.sceneViewer);
+      this.centralPlant.managers.ioAnimationManager = new IoAnimationManager(this.centralPlant.sceneViewer);
 
       // All managers are now stored in the managers collection and will be attached via attachToComponent()
     }
@@ -38938,7 +39385,7 @@ var CentralPlant = /*#__PURE__*/function (_BaseDisposable) {
    * Initialize the CentralPlant manager
    * 
    * @constructor
-   * @version 0.3.21
+   * @version 0.3.22
    * @updated 2025-10-22
    * 
    * @description Creates a new CentralPlant instance and initializes internal managers and utilities.
@@ -41955,7 +42402,7 @@ var sceneViewer = /*#__PURE__*/function (_BaseDisposable) {
               this.centralPlant.attachToComponent();
 
               // Sync our managers tracking object after attachment
-              managerKeys = ['threeJSResourceManager', 'performanceMonitorManager', 'settingsManager', 'sceneExportManager', 'componentManager', 'sceneInitializationManager', 'environmentManager', 'keyboardControlsManager', 'pathfindingManager', 'pathFlowManager', 'behaviorManager', 'sceneOperationsManager', 'animationManager', 'cameraControlsManager', 'componentDragManager', 'tooltipsManager', 'componentTooltipManager']; // Populate our managers tracking object
+              managerKeys = ['threeJSResourceManager', 'performanceMonitorManager', 'settingsManager', 'sceneExportManager', 'componentManager', 'sceneInitializationManager', 'environmentManager', 'keyboardControlsManager', 'pathfindingManager', 'pathFlowManager', 'behaviorManager', 'ioAnimationManager', 'sceneOperationsManager', 'animationManager', 'cameraControlsManager', 'componentDragManager', 'tooltipsManager', 'componentTooltipManager']; // Populate our managers tracking object
               managerKeys.forEach(function (key) {
                 if (_this2[key]) {
                   _this2.managers[key] = _this2[key];
@@ -47646,6 +48093,7 @@ exports.ComponentTooltipManager = ComponentTooltipManager;
 exports.EnvironmentManager = EnvironmentManager;
 exports.FLOW_ATTRIBUTE_KEYS = FLOW_ATTRIBUTE_KEYS;
 exports.GLOBAL_CACHE_NAME = GLOBAL_CACHE_NAME;
+exports.IoAnimationManager = IoAnimationManager;
 exports.KeyboardControlsManager = KeyboardControlsManager;
 exports.ModelManager = ModelManager;
 exports.OperationHistoryManager = OperationHistoryManager;