@2112-lab/central-plant 0.3.38 → 0.3.41

package/dist/bundle/index.js

@@ -1164,6 +1164,74 @@ var DisposalUtilities = /*#__PURE__*/function () {
   }]);
 }();
 
+/**
+ * Register mesh animations and intra-component state links when a smart
+ * component is placed or imported into the scene.
+ *
+ * @param {import('../managers/behaviors/IoBehaviorManager.js').IoBehaviorManager} ioBehavMgr
+ * @param {string} componentUuid - Instance UUID of the parent component
+ * @param {Object} componentData - Smart component dictionary entry
+ * @param {Object} componentModel - Root THREE.Object3D of the placed component
+ * @param {Object} componentDictionary - modelPreloader.componentDictionary
+ */
+function registerBehaviorsForComponent(ioBehavMgr, componentUuid, componentData, componentModel, componentDictionary) {
+  var _componentData$behavi;
+  if (!ioBehavMgr || !componentData || !componentModel) {
+    return;
+  }
+  if (componentData.isSmart && componentData.attachedDevices) {
+    var _loop = function _loop() {
+      var _Object$entries$_i = _slicedToArray(_Object$entries[_i], 2),
+        attachmentId = _Object$entries$_i[0],
+        attachment = _Object$entries$_i[1];
+      var deviceData = componentDictionary === null || componentDictionary === void 0 ? void 0 : componentDictionary[attachment.deviceId];
+      if (!(deviceData !== null && deviceData !== void 0 && deviceData.behaviorConfig)) return 1; // continue
+      var deviceRoot = null;
+      componentModel.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) {
+        ioBehavMgr.loadBehaviors(attachmentId, deviceData.behaviorConfig, deviceRoot, componentUuid);
+      }
+    };
+    for (var _i = 0, _Object$entries = Object.entries(componentData.attachedDevices); _i < _Object$entries.length; _i++) {
+      if (_loop()) continue;
+    }
+  }
+  if (((_componentData$behavi = componentData.behaviors) === null || _componentData$behavi === void 0 ? void 0 : _componentData$behavi.length) > 0) {
+    ioBehavMgr.registerComponentBehaviors(componentUuid, componentData.behaviors);
+  } else if (componentData.isSmart) {
+    ioBehavMgr.registerComponentBehaviors(componentUuid, []);
+  }
+}
+
+/**
+ * Reload mesh behaviorConfig for every placed instance of an I/O device asset.
+ * Call after the animation wizard saves updated behaviorConfig to the dictionary.
+ *
+ * @param {import('../managers/behaviors/IoBehaviorManager.js').IoBehaviorManager} ioBehavMgr
+ * @param {string} deviceAssetId - Dictionary / asset id of the I/O device
+ * @param {Object} componentDictionary
+ * @param {Object} centralPlant
+ */
+function reloadBehaviorsForDeviceAsset(ioBehavMgr, deviceAssetId, componentDictionary, centralPlant) {
+  var _centralPlant$sceneVi;
+  var scene = centralPlant === null || centralPlant === void 0 || (_centralPlant$sceneVi = centralPlant.sceneViewer) === null || _centralPlant$sceneVi === void 0 ? void 0 : _centralPlant$sceneVi.scene;
+  var deviceData = componentDictionary === null || componentDictionary === void 0 ? void 0 : componentDictionary[deviceAssetId];
+  if (!ioBehavMgr || !scene || !(deviceData !== null && deviceData !== void 0 && deviceData.behaviorConfig)) return;
+  scene.traverse(function (obj) {
+    var _obj$userData2, _obj$userData3, _obj$parent;
+    if (((_obj$userData2 = obj.userData) === null || _obj$userData2 === void 0 ? void 0 : _obj$userData2.objectType) !== 'io-device') return;
+    if (((_obj$userData3 = obj.userData) === null || _obj$userData3 === void 0 ? void 0 : _obj$userData3.deviceId) !== deviceAssetId) return;
+    var parentUuid = obj.userData.parentComponentId || ((_obj$parent = obj.parent) === null || _obj$parent === void 0 ? void 0 : _obj$parent.uuid);
+    var attachmentId = obj.userData.attachmentId;
+    if (!parentUuid || !attachmentId) return;
+    ioBehavMgr.unloadForAttachment(parentUuid, attachmentId);
+    ioBehavMgr.loadBehaviors(attachmentId, deviceData.behaviorConfig, obj, parentUuid);
+  });
+}
+
 /**
  * Validation severity levels
  * @enum {string}
@@ -20325,6 +20393,14 @@ var ComponentDataManager = /*#__PURE__*/function (_BaseDisposable) {
                 if (!_this3.componentDictionary[key]) {
                   newComponents[key] = component;
                 } else {
+                  var _component$behaviors;
+                  var existing = _this3.componentDictionary[key];
+                  if (component.behaviorConfig) existing.behaviorConfig = component.behaviorConfig;
+                  if (component.meshNameMap) existing.meshNameMap = component.meshNameMap;
+                  if ((_component$behaviors = component.behaviors) !== null && _component$behaviors !== void 0 && _component$behaviors.length) existing.behaviors = component.behaviors;
+                  if (component.attachedDevices) {
+                    existing.attachedDevices = _objectSpread2(_objectSpread2({}, existing.attachedDevices || {}), component.attachedDevices);
+                  }
                   console.log("\u26A0\uFE0F Skipping duplicate component: ".concat(key, " (").concat(component.name || 'unnamed', ")"));
                 }
               });
@@ -20356,17 +20432,61 @@ var ComponentDataManager = /*#__PURE__*/function (_BaseDisposable) {
       }
       return extendComponentDictionary;
     }()
+    /**
+     * Merge mesh animation configs from host persistence into the live dictionary.
+     * @param {Object<string, { behaviorConfig?: Array, meshNameMap?: Object, behaviors?: Array }>} configsByAssetId
+     * @returns {number} Count of entries updated
+     */
+    )
+  }, {
+    key: "mergeBehaviorConfigsIntoDictionary",
+    value: function mergeBehaviorConfigsIntoDictionary(configsByAssetId) {
+      var _this$sceneViewer2;
+      if (!configsByAssetId || !this.componentDictionary) return 0;
+      var merged = 0;
+      for (var _i2 = 0, _Object$entries2 = Object.entries(configsByAssetId); _i2 < _Object$entries2.length; _i2++) {
+        var _Object$entries2$_i = _slicedToArray(_Object$entries2[_i2], 2),
+          assetId = _Object$entries2$_i[0],
+          attrs = _Object$entries2$_i[1];
+        var entry = this.componentDictionary[assetId];
+        if (!entry || !attrs) continue;
+        var updated = false;
+        if (attrs.behaviorConfig) {
+          entry.behaviorConfig = attrs.behaviorConfig;
+          updated = true;
+        }
+        if (attrs.meshNameMap) {
+          entry.meshNameMap = attrs.meshNameMap;
+          updated = true;
+        }
+        if ('behaviors' in attrs) {
+          var _attrs$behaviors;
+          if ((_attrs$behaviors = attrs.behaviors) !== null && _attrs$behaviors !== void 0 && _attrs$behaviors.length) {
+            entry.behaviors = attrs.behaviors;
+          } else {
+            delete entry.behaviors;
+          }
+          updated = true;
+        }
+        if (updated) merged++;
+      }
+      var modelPreloader = (_this$sceneViewer2 = this.sceneViewer) === null || _this$sceneViewer2 === void 0 || (_this$sceneViewer2 = _this$sceneViewer2.centralPlant) === null || _this$sceneViewer2 === void 0 || (_this$sceneViewer2 = _this$sceneViewer2.utilities) === null || _this$sceneViewer2 === void 0 ? void 0 : _this$sceneViewer2.modelPreloader;
+      if (modelPreloader) {
+        modelPreloader.componentDictionary = this.componentDictionary;
+      }
+      return merged;
+    }
+
     /**
      * Remove S3 components from the component dictionary
      * @returns {Promise<boolean>} True if components were removed successfully
      */
-    )
   }, {
     key: "removeS3Components",
     value: (function () {
       var _removeS3Components = _asyncToGenerator(/*#__PURE__*/_regenerator().m(function _callee4() {
         var _this4 = this;
-        var _this$sceneViewer2, keysToRemove, _i2, _Object$entries2, _Object$entries2$_i, key, component, modelPreloader, _t2;
+        var _this$sceneViewer3, keysToRemove, _i3, _Object$entries3, _Object$entries3$_i, key, component, modelPreloader, _t2;
         return _regenerator().w(function (_context4) {
           while (1) switch (_context4.n) {
             case 0:
@@ -20383,8 +20503,8 @@ var ComponentDataManager = /*#__PURE__*/function (_BaseDisposable) {
               _context4.p = 2;
               // Find and remove all S3 components
               keysToRemove = [];
-              for (_i2 = 0, _Object$entries2 = Object.entries(this.componentDictionary); _i2 < _Object$entries2.length; _i2++) {
-                _Object$entries2$_i = _slicedToArray(_Object$entries2[_i2], 2), key = _Object$entries2$_i[0], component = _Object$entries2$_i[1];
+              for (_i3 = 0, _Object$entries3 = Object.entries(this.componentDictionary); _i3 < _Object$entries3.length; _i3++) {
+                _Object$entries3$_i = _slicedToArray(_Object$entries3[_i3], 2), key = _Object$entries3$_i[0], component = _Object$entries3$_i[1];
                 if (component.isS3Component) {
                   keysToRemove.push(key);
                 }
@@ -20396,7 +20516,7 @@ var ComponentDataManager = /*#__PURE__*/function (_BaseDisposable) {
               });
 
               // Update ModelPreloader's dictionary reference
-              modelPreloader = (_this$sceneViewer2 = this.sceneViewer) === null || _this$sceneViewer2 === void 0 || (_this$sceneViewer2 = _this$sceneViewer2.centralPlant) === null || _this$sceneViewer2 === void 0 || (_this$sceneViewer2 = _this$sceneViewer2.utilities) === null || _this$sceneViewer2 === void 0 ? void 0 : _this$sceneViewer2.modelPreloader;
+              modelPreloader = (_this$sceneViewer3 = this.sceneViewer) === null || _this$sceneViewer3 === void 0 || (_this$sceneViewer3 = _this$sceneViewer3.centralPlant) === null || _this$sceneViewer3 === void 0 || (_this$sceneViewer3 = _this$sceneViewer3.utilities) === null || _this$sceneViewer3 === void 0 ? void 0 : _this$sceneViewer3.modelPreloader;
               if (modelPreloader) {
                 modelPreloader.componentDictionary = this.componentDictionary;
                 console.log("\uD83D\uDD04 Updated ModelPreloader's dictionary reference (".concat(Object.keys(this.componentDictionary).length, " total components)"));
@@ -20429,7 +20549,7 @@ var ComponentDataManager = /*#__PURE__*/function (_BaseDisposable) {
     key: "removeComponentFromDictionary",
     value: (function () {
       var _removeComponentFromDictionary = _asyncToGenerator(/*#__PURE__*/_regenerator().m(function _callee5(componentKey) {
-        var _this$sceneViewer3, modelPreloader, _t3;
+        var _this$sceneViewer4, modelPreloader, _t3;
         return _regenerator().w(function (_context5) {
           while (1) switch (_context5.n) {
             case 0:
@@ -20462,7 +20582,7 @@ var ComponentDataManager = /*#__PURE__*/function (_BaseDisposable) {
               delete this.componentDictionary[componentKey];
 
               // Update ModelPreloader's dictionary reference
-              modelPreloader = (_this$sceneViewer3 = this.sceneViewer) === null || _this$sceneViewer3 === void 0 || (_this$sceneViewer3 = _this$sceneViewer3.centralPlant) === null || _this$sceneViewer3 === void 0 || (_this$sceneViewer3 = _this$sceneViewer3.utilities) === null || _this$sceneViewer3 === void 0 ? void 0 : _this$sceneViewer3.modelPreloader;
+              modelPreloader = (_this$sceneViewer4 = this.sceneViewer) === null || _this$sceneViewer4 === void 0 || (_this$sceneViewer4 = _this$sceneViewer4.centralPlant) === null || _this$sceneViewer4 === void 0 || (_this$sceneViewer4 = _this$sceneViewer4.utilities) === null || _this$sceneViewer4 === void 0 ? void 0 : _this$sceneViewer4.modelPreloader;
               if (modelPreloader) {
                 modelPreloader.componentDictionary = this.componentDictionary;
                 console.log("\uD83D\uDD04 Updated ModelPreloader's dictionary reference (".concat(Object.keys(this.componentDictionary).length, " total components)"));
@@ -20562,10 +20682,10 @@ var ComponentDataManager = /*#__PURE__*/function (_BaseDisposable) {
       if (!this.componentDictionary) return 'unknown';
 
       // Look for component in dictionary
-      for (var _i3 = 0, _Object$entries3 = Object.entries(this.componentDictionary); _i3 < _Object$entries3.length; _i3++) {
-        var _Object$entries3$_i = _slicedToArray(_Object$entries3[_i3], 2),
-          key = _Object$entries3$_i[0],
-          component = _Object$entries3$_i[1];
+      for (var _i4 = 0, _Object$entries4 = Object.entries(this.componentDictionary); _i4 < _Object$entries4.length; _i4++) {
+        var _Object$entries4$_i = _slicedToArray(_Object$entries4[_i4], 2),
+          key = _Object$entries4$_i[0],
+          component = _Object$entries4$_i[1];
         if (key === 'categories') continue;
         if (name && name.toLowerCase().includes(key.toLowerCase())) {
           return component.category || 'unknown';
@@ -31318,12 +31438,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, _this$sceneViewer, ioBehavMgr, _loop, _i, _Object$entries, warmFn, _jsonEntry$userData4, _t;
-        return _regenerator().w(function (_context2) {
-          while (1) switch (_context2.n) {
+        var component, _jsonEntry$userData, _jsonEntry$userData2, _jsonEntry$userData3, originalProps, connectorChildren, gltfScene, libraryModel, _this$sceneViewer, ioBehavMgr, warmFn, _jsonEntry$userData4, _t;
+        return _regenerator().w(function (_context) {
+          while (1) switch (_context.n) {
             case 0:
               component = this.sceneViewer;
-              _context2.p = 1;
+              _context.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
@@ -31336,16 +31456,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
-              _context2.n = 2;
+              _context.n = 2;
               return this._getLibraryModel(componentData.modelKey, (_jsonEntry$userData2 = jsonEntry.userData) === null || _jsonEntry$userData2 === void 0 ? void 0 : _jsonEntry$userData2.libraryId);
             case 2:
-              gltfScene = _context2.v;
+              gltfScene = _context.v;
               if (gltfScene) {
-                _context2.n = 3;
+                _context.n = 3;
                 break;
               }
               console.warn("\u26A0\uFE0F Could not load model ".concat(componentData.modelKey, ", keeping original mesh"));
-              return _context2.a(2, targetMesh);
+              return _context.a(2, targetMesh);
             case 3:
               // Configure the loaded model
               libraryModel = this._configureLibraryModel(gltfScene, jsonEntry, componentData, originalProps); // Add preserved connectors
@@ -31355,70 +31475,17 @@ var ModelManager = /*#__PURE__*/function () {
 
               // Attach IO devices for smart components (import flow)
               if (!(componentData.isSmart && componentData.attachedDevices)) {
-                _context2.n = 9;
+                _context.n = 5;
                 break;
               }
-              _context2.n = 4;
+              _context.n = 4;
               return attachIODevicesToComponent(libraryModel, componentData, modelPreloader, originalProps.uuid);
             case 4:
-              // Register behavior configs for each attached device
               ioBehavMgr = (_this$sceneViewer = this.sceneViewer) === null || _this$sceneViewer === void 0 || (_this$sceneViewer = _this$sceneViewer.managers) === null || _this$sceneViewer === void 0 ? void 0 : _this$sceneViewer.ioBehaviorManager;
-              if (!ioBehavMgr) {
-                _context2.n = 9;
-                break;
+              if (ioBehavMgr) {
+                registerBehaviorsForComponent(ioBehavMgr, originalProps.uuid, componentData, libraryModel, modelPreloader.componentDictionary);
               }
-              _loop = /*#__PURE__*/_regenerator().m(function _loop() {
-                var _modelPreloader$compo, _deviceData$behaviorC;
-                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];
-                      console.log("[ModelManager] attachment \"".concat(attachmentId, "\" \u2192 deviceId \"").concat(attachment.deviceId, "\" \u2192 behaviorConfig:"), (_deviceData$behaviorC = deviceData === null || deviceData === void 0 ? void 0 : deviceData.behaviorConfig) !== null && _deviceData$behaviorC !== void 0 ? _deviceData$behaviorC : 'NONE');
-                      if (deviceData !== null && deviceData !== void 0 && deviceData.behaviorConfig) {
-                        _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) {
-                        ioBehavMgr.loadBehaviors(attachmentId, deviceData.behaviorConfig, 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:
-              // Register component-level behaviors (intra-component io-device linking)
-              if (componentData.behaviors && componentData.behaviors.length > 0) {
-                console.log("[ModelManager] Registering ".concat(componentData.behaviors.length, " component-level behavior(s) for ").concat(originalProps.uuid));
-                ioBehavMgr.registerComponentBehaviors(originalProps.uuid, componentData.behaviors);
-              }
-            case 9:
               // Replace mesh in scene
               this._replaceMeshInScene(targetMesh, libraryModel, originalProps.parent, component);
 
@@ -31436,14 +31503,14 @@ var ModelManager = /*#__PURE__*/function () {
                 }
               }
               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 _context2.a(2, libraryModel);
-            case 10:
-              _context2.p = 10;
-              _t = _context2.v;
+              return _context.a(2, libraryModel);
+            case 6:
+              _context.p = 6;
+              _t = _context.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 _context2.a(2, targetMesh);
+              return _context.a(2, targetMesh);
           }
-        }, _callee, this, [[1, 10]]);
+        }, _callee, this, [[1, 6]]);
       }));
       function loadLibraryModel(_x, _x2, _x3) {
         return _loadLibraryModel.apply(this, arguments);
@@ -31522,84 +31589,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 (_context3) {
-          while (1) switch (_context3.n) {
+        return _regenerator().w(function (_context2) {
+          while (1) switch (_context2.n) {
             case 0:
               // Try cache first
               gltfScene = modelPreloader.getCachedModelWithDimensions(modelKey, libraryId);
               if (!gltfScene) {
-                _context3.n = 1;
+                _context2.n = 1;
                 break;
               }
               console.log("\uD83C\uDFAF GLB cache HIT: ".concat(modelKey));
-              return _context3.a(2, gltfScene);
+              return _context2.a(2, gltfScene);
             case 1:
               // Check if preloading is in progress
               preloaderStatus = modelPreloader.getStatus();
               if (!preloaderStatus.isPreloading) {
-                _context3.n = 6;
+                _context2.n = 6;
                 break;
               }
               console.log("\u23F3 Waiting for preloader: ".concat(modelKey));
-              _context3.p = 2;
-              _context3.n = 3;
+              _context2.p = 2;
+              _context2.n = 3;
               return modelPreloader.preloadingPromise;
             case 3:
               gltfScene = modelPreloader.getCachedModelWithDimensions(modelKey, libraryId);
               if (!gltfScene) {
-                _context3.n = 4;
+                _context2.n = 4;
                 break;
               }
               console.log("\uD83C\uDFAF GLB cache HIT (after preload): ".concat(modelKey));
-              return _context3.a(2, gltfScene);
+              return _context2.a(2, gltfScene);
             case 4:
-              _context3.n = 6;
+              _context2.n = 6;
               break;
             case 5:
-              _context3.p = 5;
-              _t2 = _context3.v;
+              _context2.p = 5;
+              _t2 = _context2.v;
               console.warn("\u26A0\uFE0F Preloading failed:", _t2);
             case 6:
-              _context3.p = 6;
+              _context2.p = 6;
               if (!modelPreloader.urlResolver) {
-                _context3.n = 11;
+                _context2.n = 11;
                 break;
               }
-              _context3.p = 7;
-              _context3.n = 8;
+              _context2.p = 7;
+              _context2.n = 8;
               return modelPreloader.urlResolver(modelKey);
             case 8:
-              modelPath = _context3.v;
+              modelPath = _context2.v;
               console.log("\uD83D\uDD17 Resolved URL for ".concat(modelKey));
-              _context3.n = 10;
+              _context2.n = 10;
               break;
             case 9:
-              _context3.p = 9;
-              _t3 = _context3.v;
+              _context2.p = 9;
+              _t3 = _context2.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:
-              _context3.n = 12;
+              _context2.n = 12;
               break;
             case 11:
               modelPath = "".concat(modelPreloader.modelsBasePath).concat(modelKey);
             case 12:
               console.log("\uD83D\uDCC2 Fallback loading from: ".concat(modelPath));
-              _context3.n = 13;
+              _context2.n = 13;
               return new Promise(function (resolve, reject) {
                 _this2.sceneViewer.gltfLoader.load(modelPath, resolve, undefined, reject);
               });
             case 13:
-              gltf = _context3.v;
+              gltf = _context2.v;
               if (libraryId) {
                 modelPreloader.cacheModel(modelKey, gltf.scene.clone(), libraryId);
               }
-              return _context3.a(2, gltf.scene);
+              return _context2.a(2, gltf.scene);
             case 14:
-              _context3.p = 14;
-              _t4 = _context3.v;
+              _context2.p = 14;
+              _t4 = _context2.v;
               console.error("Failed to load model ".concat(modelKey, ":"), _t4);
-              return _context3.a(2, null);
+              return _context2.a(2, null);
           }
         }, _callee2, null, [[7, 9], [6, 14], [2, 5]]);
       }));
@@ -31706,8 +31773,8 @@ var ModelManager = /*#__PURE__*/function () {
     value: (function () {
       var _verifyModelPreloaderCache = _asyncToGenerator(/*#__PURE__*/_regenerator().m(function _callee3() {
         var preloaderStatus, _t5;
-        return _regenerator().w(function (_context4) {
-          while (1) switch (_context4.n) {
+        return _regenerator().w(function (_context3) {
+          while (1) switch (_context3.n) {
             case 0:
               console.log('🔍 Verifying model preloader cache state...');
               preloaderStatus = modelPreloader.getStatus();
@@ -31715,23 +31782,23 @@ var ModelManager = /*#__PURE__*/function () {
 
               // If preloading is still in progress, wait for completion
               if (!preloaderStatus.isPreloading) {
-                _context4.n = 4;
+                _context3.n = 4;
                 break;
               }
               console.log('⏳ Waiting for model preloading to complete...');
-              _context4.p = 1;
-              _context4.n = 2;
+              _context3.p = 1;
+              _context3.n = 2;
               return modelPreloader.preloadingPromise;
             case 2:
               console.log('✅ Model preloading completed');
-              _context4.n = 4;
+              _context3.n = 4;
               break;
             case 3:
-              _context4.p = 3;
-              _t5 = _context4.v;
+              _context3.p = 3;
+              _t5 = _context3.v;
               console.warn('⚠️ Model preloading failed, some models may load directly:', _t5);
             case 4:
-              return _context4.a(2, preloaderStatus);
+              return _context3.a(2, preloaderStatus);
           }
         }, _callee3, null, [[1, 3]]);
       }));
@@ -31749,11 +31816,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 (_context5) {
-          while (1) switch (_context5.n) {
+        return _regenerator().w(function (_context4) {
+          while (1) switch (_context4.n) {
             case 0:
               if (!(!data || !data.scene || !Array.isArray(data.scene.children))) {
-                _context5.n = 1;
+                _context4.n = 1;
                 break;
               }
               console.warn('⚠️ Invalid scene data structure in preloadMissingModels:', {
@@ -31762,7 +31829,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 _context5.a(2);
+              return _context4.a(2);
             case 1:
               requiredModels = new Set();
               console.log("\uD83D\uDD0D Checking ".concat(data.scene.children.length, " scene objects for required models..."));
@@ -31784,10 +31851,10 @@ var ModelManager = /*#__PURE__*/function () {
                 }
               });
               console.log('🔍 Required models for this scene (Set):', Array.from(requiredModels));
-              _context5.n = 2;
+              _context4.n = 2;
               return this.verifyModelPreloaderCache();
             case 2:
-              preloaderStatus = _context5.v;
+              preloaderStatus = _context4.v;
               cachedModels = preloaderStatus.cachedModels;
               console.log('ModelPreloader cached models:', cachedModels);
 
@@ -31818,7 +31885,7 @@ var ModelManager = /*#__PURE__*/function () {
                 });
               }
               if (!(missingModels.length > 0)) {
-                _context5.n = 12;
+                _context4.n = 12;
                 break;
               }
               console.warn('⚠️ Some required models are not cached:', missingModels);
@@ -31826,41 +31893,41 @@ var ModelManager = /*#__PURE__*/function () {
 
               // Preload missing models (Main in-memory preloader)
               _iterator = _createForOfIteratorHelper(missingModels);
-              _context5.p = 3;
+              _context4.p = 3;
               _iterator.s();
             case 4:
               if ((_step = _iterator.n()).done) {
-                _context5.n = 9;
+                _context4.n = 9;
                 break;
               }
               modelKey = _step.value;
-              _context5.p = 5;
-              _context5.n = 6;
+              _context4.p = 5;
+              _context4.n = 6;
               return modelPreloader.preloadSingleModel(modelKey);
             case 6:
               console.log("\u2705 Successfully preloaded missing model: ".concat(modelKey));
-              _context5.n = 8;
+              _context4.n = 8;
               break;
             case 7:
-              _context5.p = 7;
-              _t6 = _context5.v;
+              _context4.p = 7;
+              _t6 = _context4.v;
               console.warn("\u274C Failed to preload missing model ".concat(modelKey, ":"), _t6);
             case 8:
-              _context5.n = 4;
+              _context4.n = 4;
               break;
             case 9:
-              _context5.n = 11;
+              _context4.n = 11;
               break;
             case 10:
-              _context5.p = 10;
-              _t7 = _context5.v;
+              _context4.p = 10;
+              _t7 = _context4.v;
               _iterator.e(_t7);
             case 11:
-              _context5.p = 11;
+              _context4.p = 11;
               _iterator.f();
-              return _context5.f(11);
+              return _context4.f(11);
             case 12:
-              return _context5.a(2);
+              return _context4.a(2);
           }
         }, _callee4, this, [[5, 7], [3, 10, 11, 12]]);
       }));
@@ -31879,14 +31946,14 @@ var ModelManager = /*#__PURE__*/function () {
       var _replaceWithGLBModels = _asyncToGenerator(/*#__PURE__*/_regenerator().m(function _callee5(libraryObjectsToReplace) {
         var _this3 = this;
         var startTime, glbLoadingPromises;
-        return _regenerator().w(function (_context6) {
-          while (1) switch (_context6.n) {
+        return _regenerator().w(function (_context5) {
+          while (1) switch (_context5.n) {
             case 0:
               if (!(libraryObjectsToReplace.length === 0)) {
-                _context6.n = 1;
+                _context5.n = 1;
                 break;
               }
-              return _context6.a(2);
+              return _context5.a(2);
             case 1:
               startTime = performance.now();
               console.log("\uD83D\uDD04 Replacing ".concat(libraryObjectsToReplace.length, " objects with GLB models..."));
@@ -31906,7 +31973,7 @@ var ModelManager = /*#__PURE__*/function () {
                   return basicObject;
                 });
               });
-              _context6.n = 2;
+              _context5.n = 2;
               return Promise.all(glbLoadingPromises);
             case 2:
               console.log("\u23F1\uFE0F All GLB models loaded in ".concat((performance.now() - startTime).toFixed(0), "ms"));
@@ -31949,7 +32016,7 @@ var ModelManager = /*#__PURE__*/function () {
                 }));
               }
             case 3:
-              return _context6.a(2);
+              return _context5.a(2);
           }
         }, _callee5);
       }));
@@ -31984,26 +32051,26 @@ var ModelManager = /*#__PURE__*/function () {
     value: (function () {
       var _loadComponentDictionary = _asyncToGenerator(/*#__PURE__*/_regenerator().m(function _callee6() {
         var response, dict, _t8;
-        return _regenerator().w(function (_context7) {
-          while (1) switch (_context7.n) {
+        return _regenerator().w(function (_context6) {
+          while (1) switch (_context6.n) {
             case 0:
-              _context7.p = 0;
+              _context6.p = 0;
               console.log('🔄 ModelManager loading component dictionary...');
-              _context7.n = 1;
+              _context6.n = 1;
               return fetch('/library/component-dictionary.json');
             case 1:
-              response = _context7.v;
-              _context7.n = 2;
+              response = _context6.v;
+              _context6.n = 2;
               return response.json();
             case 2:
-              dict = _context7.v;
+              dict = _context6.v;
               console.log('✅ ModelManager loaded dictionary:', Object.keys(dict).length, 'entries');
-              return _context7.a(2, dict);
+              return _context6.a(2, dict);
             case 3:
-              _context7.p = 3;
-              _t8 = _context7.v;
+              _context6.p = 3;
+              _t8 = _context6.v;
               console.warn('⚠️ Could not load component dictionary:', _t8);
-              return _context7.a(2, {});
+              return _context6.a(2, {});
           }
         }, _callee6, null, [[0, 3]]);
       }));
@@ -32706,10 +32773,15 @@ var SceneOperationsManager = /*#__PURE__*/function () {
     key: "clearSceneObjects",
     value: function () {
       var _clearSceneObjects = _asyncToGenerator(/*#__PURE__*/_regenerator().m(function _callee() {
-        var result;
+        var _this$sceneViewer;
+        var ioBehavMgr, result;
         return _regenerator().w(function (_context) {
           while (1) switch (_context.n) {
             case 0:
+              ioBehavMgr = (_this$sceneViewer = this.sceneViewer) === null || _this$sceneViewer === void 0 || (_this$sceneViewer = _this$sceneViewer.managers) === null || _this$sceneViewer === void 0 ? void 0 : _this$sceneViewer.ioBehaviorManager;
+              if (ioBehavMgr !== null && ioBehavMgr !== void 0 && ioBehavMgr.resetForScene) {
+                ioBehavMgr.resetForScene();
+              }
               _context.n = 1;
               return this.sceneClearingUtility.clearAllObjects();
             case 1:
@@ -33075,9 +33147,9 @@ var SceneOperationsManager = /*#__PURE__*/function () {
       // Use crosscubeTextureSet if available, otherwise fallback material
       var material = materials[obj.material];
       if (!material) {
-        var _this$sceneViewer;
+        var _this$sceneViewer2;
         // Check if we have crosscubeTextureSet from scene loading
-        var crosscubeTextureSet = (_this$sceneViewer = this.sceneViewer) === null || _this$sceneViewer === void 0 ? void 0 : _this$sceneViewer.crosscubeTextureSet;
+        var crosscubeTextureSet = (_this$sceneViewer2 = this.sceneViewer) === null || _this$sceneViewer2 === void 0 ? void 0 : _this$sceneViewer2.crosscubeTextureSet;
         if (crosscubeTextureSet) {
           // Match PathfindingManager.createPipeMaterial() with textures
           var pathColor = '#245e29'; // Default green color from PathfindingManager.getPathColor()
@@ -36540,6 +36612,61 @@ var SceneTooltipsManager = /*#__PURE__*/function (_BaseDisposable) {
   }]);
 }(BaseDisposable);
 
+/**
+ * Shared I/O device state dispatch helpers used by centralPlant and componentTooltipManager.
+ */
+
+/**
+ * @param {string} attachmentId
+ * @param {string|null|undefined} parentUuid
+ * @returns {string}
+ */
+function getScopedAttachmentKey(attachmentId, parentUuid) {
+  if (!parentUuid) return attachmentId;
+  return "".concat(parentUuid, "::").concat(attachmentId);
+}
+
+/**
+ * @param {Object} sceneViewer
+ * @returns {import('../managers/behaviors/IoBehaviorManager.js').IoBehaviorManager|null}
+ */
+function getIoBehaviorManager(sceneViewer) {
+  var _sceneViewer$managers, _sceneViewer$centralP;
+  if (!sceneViewer) return null;
+  return ((_sceneViewer$managers = sceneViewer.managers) === null || _sceneViewer$managers === void 0 ? void 0 : _sceneViewer$managers.ioBehaviorManager) || sceneViewer.ioBehaviorManager || ((_sceneViewer$centralP = sceneViewer.centralPlant) === null || _sceneViewer$centralP === void 0 || (_sceneViewer$centralP = _sceneViewer$centralP.managers) === null || _sceneViewer$centralP === void 0 ? void 0 : _sceneViewer$centralP.ioBehaviorManager) || null;
+}
+
+/**
+ * Resolve tooltip/drag data points for an I/O device attachment.
+ * Prefers behaviorConfig-driven animation data points; merges legacy ioConfig snapshot.
+ *
+ * @param {string} parentUuid
+ * @param {string} attachmentId
+ * @param {Object} userData - io-device userData (may include dataPoints snapshot)
+ * @param {import('../managers/behaviors/IoBehaviorManager.js').IoBehaviorManager|null} ioBehaviorManager
+ * @param {THREE.Object3D|null} [hitMesh]
+ * @returns {Object[]}
+ */
+function resolveDataPoints(parentUuid, attachmentId, userData, ioBehaviorManager) {
+  var hitMesh = arguments.length > 4 && arguments[4] !== undefined ? arguments[4] : null;
+  var fromAnimations = (ioBehaviorManager === null || ioBehaviorManager === void 0 ? void 0 : ioBehaviorManager.getAnimationDataPoints(parentUuid, attachmentId, hitMesh)) || [];
+  if (fromAnimations.length) return fromAnimations;
+  var legacy = (userData === null || userData === void 0 ? void 0 : userData.dataPoints) || [];
+  return legacy.map(function (dp) {
+    var _dp$defaultValue;
+    return {
+      id: dp.id || dp.name,
+      name: dp.name || dp.id,
+      stateType: dp.stateType || 'binary',
+      stateConfig: dp.stateConfig || {},
+      defaultValue: (_dp$defaultValue = dp.defaultValue) !== null && _dp$defaultValue !== void 0 ? _dp$defaultValue : null,
+      direction: dp.direction || (userData === null || userData === void 0 ? void 0 : userData.ioDirection) || 'output'
+    };
+  }).filter(function (dp) {
+    return dp.id;
+  });
+}
+
 // ---------------------------------------------------------------------------
 // Inline styles (injected once into the document head)
 // ---------------------------------------------------------------------------
@@ -36549,6 +36676,7 @@ var ComponentTooltipManager = /*#__PURE__*/function (_BaseDisposable) {
    * @param {Object} sceneViewer - The sceneViewer instance
    */
   function ComponentTooltipManager(sceneViewer) {
+    var _this$sceneViewer, _this$sceneViewer$on;
     var _this;
     _classCallCheck(this, ComponentTooltipManager);
     _this = _callSuper(this, ComponentTooltipManager);
@@ -36573,29 +36701,38 @@ var ComponentTooltipManager = /*#__PURE__*/function (_BaseDisposable) {
      * Map of live DOM elements that display current data point values.
      * Key: `${attachmentId}::${dataPointId}`
      * Value: { el: HTMLElement, dp: Object, isInput: boolean }
-     * Populated during _buildTooltip; polled each frame in _refreshStateDisplays.
+     * Populated during _buildTooltip; refreshed on io-device-state-changed events.
      * @type {Map<string, {el: HTMLElement, dp: Object, isInput: boolean}>}
      */
     _this._stateElements = new Map();
+    _this._onIoStateChanged = _this._onIoStateChanged.bind(_this);
     _this._injectStyles();
     _this._onKeyDown = _this._onKeyDown.bind(_this);
     document.addEventListener('keydown', _this._onKeyDown);
+    (_this$sceneViewer = _this.sceneViewer) === null || _this$sceneViewer === void 0 || (_this$sceneViewer$on = _this$sceneViewer.on) === null || _this$sceneViewer$on === void 0 || _this$sceneViewer$on.call(_this$sceneViewer, 'io-device-state-changed', _this._onIoStateChanged);
     return _this;
   }
-
-  // -----------------------------------------------------------------------
-  // Lifecycle
-  // -----------------------------------------------------------------------
-
-  /**
-   * Called automatically by BaseDisposable.dispose()
-   * @override
-   */
   _inherits(ComponentTooltipManager, _BaseDisposable);
   return _createClass(ComponentTooltipManager, [{
+    key: "_onIoStateChanged",
+    value: function _onIoStateChanged() {
+      this._refreshStateDisplays();
+    }
+
+    // -----------------------------------------------------------------------
+    // Lifecycle
+    // -----------------------------------------------------------------------
+
+    /**
+     * Called automatically by BaseDisposable.dispose()
+     * @override
+     */
+  }, {
     key: "_doDispose",
     value: function _doDispose() {
+      var _this$sceneViewer2, _this$sceneViewer2$of;
       document.removeEventListener('keydown', this._onKeyDown);
+      (_this$sceneViewer2 = this.sceneViewer) === null || _this$sceneViewer2 === void 0 || (_this$sceneViewer2$of = _this$sceneViewer2.off) === null || _this$sceneViewer2$of === void 0 || _this$sceneViewer2$of.call(_this$sceneViewer2, 'io-device-state-changed', this._onIoStateChanged);
       this.hide();
       this._removeStyleTag();
       this._stateElements.clear();
@@ -36643,7 +36780,7 @@ var ComponentTooltipManager = /*#__PURE__*/function (_BaseDisposable) {
   }, {
     key: "toggleIODeviceBinaryState",
     value: function toggleIODeviceBinaryState(ioDeviceObject) {
-      var _ref, _this$sceneViewer;
+      var _ref;
       if (!ioDeviceObject || !this._stateAdapter) return;
       var ud = ioDeviceObject.userData;
       var attachmentId = ud === null || ud === void 0 ? void 0 : ud.attachmentId;
@@ -36664,7 +36801,7 @@ var ComponentTooltipManager = /*#__PURE__*/function (_BaseDisposable) {
 
       // Create a scoped attachment key to prevent state sharing between instances
       // of the same smart component that share the same attachmentId
-      var scopedAttachmentId = this._getScopedAttachmentKey(attachmentId, parentUuid);
+      var scopedAttachmentId = getScopedAttachmentKey(attachmentId, parentUuid);
 
       // Find the first binary state
       var binaryState = dataPoints.find(function (dp) {
@@ -36676,8 +36813,7 @@ var ComponentTooltipManager = /*#__PURE__*/function (_BaseDisposable) {
       // Fall back to defaultValue when state is uninitialized (null/undefined)
       var currentVal = (_ref = storedVal !== null && storedVal !== void 0 ? storedVal : binaryState.defaultValue) !== null && _ref !== void 0 ? _ref : false;
       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.ioBehaviorManager) === null || _this$sceneViewer === void 0 || _this$sceneViewer.triggerState(attachmentId, dpId, newVal, parentUuid);
+      this._dispatchIoState(attachmentId, dpId, newVal, parentUuid);
       console.log("\uD83D\uDD04 [IODevice] Toggled ".concat(scopedAttachmentId, ".").concat(dpId, ": ").concat(currentVal, " \u2192 ").concat(newVal));
     }
 
@@ -36693,8 +36829,7 @@ var ComponentTooltipManager = /*#__PURE__*/function (_BaseDisposable) {
   }, {
     key: "startIODeviceDrag",
     value: function startIODeviceDrag(ioDeviceObject, hitMesh) {
-      var _this$sceneViewer2,
-        _this2 = this;
+      var _this2 = this;
       if (!ioDeviceObject || !this._stateAdapter) return;
       var ud = ioDeviceObject.userData;
       var attachmentId = ud === null || ud === void 0 ? void 0 : ud.attachmentId;
@@ -36709,15 +36844,8 @@ var ComponentTooltipManager = /*#__PURE__*/function (_BaseDisposable) {
         }
         obj = obj.parent;
       }
-      var scopedAttachmentId = this._getScopedAttachmentKey(attachmentId, parentUuid);
-      var ioBehavMgr = (_this$sceneViewer2 = this.sceneViewer) === null || _this$sceneViewer2 === void 0 || (_this$sceneViewer2 = _this$sceneViewer2.managers) === null || _this$sceneViewer2 === void 0 ? void 0 : _this$sceneViewer2.ioBehaviorManager;
-      var dataPoints = ((ioBehavMgr === null || ioBehavMgr === void 0 ? void 0 : ioBehavMgr.getAnimationDataPoints(parentUuid, attachmentId, hitMesh)) || []).concat((ud === null || ud === void 0 ? void 0 : ud.dataPoints) || [])
-      // deduplicate by id
-      .filter(function (dp, i, arr) {
-        return arr.findIndex(function (d) {
-          return d.id === dp.id;
-        }) === i;
-      });
+      var scopedAttachmentId = getScopedAttachmentKey(attachmentId, parentUuid);
+      var dataPoints = resolveDataPoints(parentUuid, attachmentId, ud, getIoBehaviorManager(this.sceneViewer), hitMesh);
       var dpSessions = [];
       var _iterator = _createForOfIteratorHelper(dataPoints),
         _step;
@@ -36726,7 +36854,6 @@ var ComponentTooltipManager = /*#__PURE__*/function (_BaseDisposable) {
           var _this2$_stateAdapter$;
           var dp = _step.value;
           var stateType = (dp.stateType || '').toLowerCase();
-          if (stateType !== 'binary' && stateType !== 'boolean' && stateType !== 'enum') return 1; // continue
           var curVal = (_this2$_stateAdapter$ = _this2._stateAdapter.getState(scopedAttachmentId, dp.id)) !== null && _this2$_stateAdapter$ !== void 0 ? _this2$_stateAdapter$ : dp.defaultValue;
           if (stateType === 'binary' || stateType === 'boolean') {
             dpSessions.push({
@@ -36737,7 +36864,7 @@ var ComponentTooltipManager = /*#__PURE__*/function (_BaseDisposable) {
               stateType: 'binary',
               lastApplied: curVal
             });
-          } else {
+          } else if (stateType === 'enum') {
             var _dp$stateConfig;
             var opts = ((_dp$stateConfig = dp.stateConfig) === null || _dp$stateConfig === void 0 ? void 0 : _dp$stateConfig.options) || [];
             var curIdx = opts.findIndex(function (o) {
@@ -36753,10 +36880,27 @@ var ComponentTooltipManager = /*#__PURE__*/function (_BaseDisposable) {
               startIdx: curIdx >= 0 ? curIdx : 0,
               lastAppliedIdx: curIdx >= 0 ? curIdx : 0
             });
+          } else if (stateType === 'number' || stateType === 'continuous') {
+            var _dp$stateConfig$min, _dp$stateConfig2, _dp$stateConfig$max, _dp$stateConfig3;
+            var min = (_dp$stateConfig$min = (_dp$stateConfig2 = dp.stateConfig) === null || _dp$stateConfig2 === void 0 ? void 0 : _dp$stateConfig2.min) !== null && _dp$stateConfig$min !== void 0 ? _dp$stateConfig$min : 0;
+            var max = (_dp$stateConfig$max = (_dp$stateConfig3 = dp.stateConfig) === null || _dp$stateConfig3 === void 0 ? void 0 : _dp$stateConfig3.max) !== null && _dp$stateConfig$max !== void 0 ? _dp$stateConfig$max : 1;
+            var parsed = Number(curVal);
+            var startVal = Number.isFinite(parsed) ? Math.max(min, Math.min(max, parsed)) : min;
+            dpSessions.push({
+              dp: dp,
+              scopedAttachmentId: scopedAttachmentId,
+              attachmentId: attachmentId,
+              parentUuid: parentUuid,
+              stateType: 'number',
+              min: min,
+              max: max,
+              startVal: startVal,
+              lastApplied: startVal
+            });
           }
         };
         for (_iterator.s(); !(_step = _iterator.n()).done;) {
-          if (_loop()) continue;
+          _loop();
         }
       } catch (err) {
         _iterator.e(err);
@@ -36773,8 +36917,9 @@ var ComponentTooltipManager = /*#__PURE__*/function (_BaseDisposable) {
      * Called continuously during pointermove.
      *
      * Sign convention: up/right = positive `signedDelta`.
-     * - Binary:  > +20 px → true/on state,  < −20 px → false/off state.
-     * - Enum:    each ±30 px step advances/retreats one option in the list.
+     * - Binary:     > +20 px → true/on state,  < −20 px → false/off state.
+     * - Enum:       each ±30 px step advances/retreats one option in the list.
+     * - Continuous: ±200 px spans the configured min→max range.
      *
      * @param {number} signedDelta - Cumulative signed pixel displacement since drag start
      */
@@ -36785,6 +36930,7 @@ var ComponentTooltipManager = /*#__PURE__*/function (_BaseDisposable) {
       if (!session) return;
       var BINARY_THRESHOLD = 20;
       var ENUM_STEP_PX = 30;
+      var RANGE_PX = 200;
       var _iterator2 = _createForOfIteratorHelper(session.dpSessions),
         _step2;
       try {
@@ -36808,6 +36954,13 @@ var ComponentTooltipManager = /*#__PURE__*/function (_BaseDisposable) {
             if (newIdx === dps.lastAppliedIdx) continue;
             dps.lastAppliedIdx = newIdx;
             this._applyDpState(dps, dps.opts[newIdx]);
+          } else if (dps.stateType === 'number') {
+            var span = dps.max - dps.min || 1;
+            var delta = signedDelta / RANGE_PX * span;
+            var _newVal = Math.max(dps.min, Math.min(dps.max, dps.startVal + delta));
+            if (Math.abs(_newVal - dps.lastApplied) < span * 0.001) continue;
+            dps.lastApplied = _newVal;
+            this._applyDpState(dps, _newVal);
           }
         }
       } catch (err) {
@@ -36833,14 +36986,35 @@ var ComponentTooltipManager = /*#__PURE__*/function (_BaseDisposable) {
   }, {
     key: "_applyDpState",
     value: function _applyDpState(_ref2, newVal) {
-      var _this$_stateAdapter, _this$sceneViewer3;
-      var scopedAttachmentId = _ref2.scopedAttachmentId,
-        attachmentId = _ref2.attachmentId,
+      _ref2.scopedAttachmentId;
+        var attachmentId = _ref2.attachmentId,
         parentUuid = _ref2.parentUuid,
         dp = _ref2.dp;
-      var dpId = dp.id;
-      (_this$_stateAdapter = this._stateAdapter) === null || _this$_stateAdapter === void 0 || _this$_stateAdapter.setState(scopedAttachmentId, dpId, newVal);
-      (_this$sceneViewer3 = this.sceneViewer) === null || _this$sceneViewer3 === void 0 || (_this$sceneViewer3 = _this$sceneViewer3.managers) === null || _this$sceneViewer3 === void 0 || (_this$sceneViewer3 = _this$sceneViewer3.ioBehaviorManager) === null || _this$sceneViewer3 === void 0 || _this$sceneViewer3.triggerState(attachmentId, dpId, newVal, parentUuid);
+      this._dispatchIoState(attachmentId, dp.id, newVal, parentUuid);
+    }
+
+    /**
+     * Unified I/O state dispatch with fallback when centralPlant is unavailable.
+     * @private
+     */
+  }, {
+    key: "_dispatchIoState",
+    value: function _dispatchIoState(attachmentId, stateId, value, parentUuid) {
+      var _this$sceneViewer3, _this$_stateAdapter, _getIoBehaviorManager, _this$sceneViewer4;
+      var cp = (_this$sceneViewer3 = this.sceneViewer) === null || _this$sceneViewer3 === void 0 ? void 0 : _this$sceneViewer3.centralPlant;
+      if (cp && typeof cp._dispatchIoState === 'function') {
+        cp._dispatchIoState(attachmentId, stateId, value, parentUuid);
+        return;
+      }
+      var scopedKey = getScopedAttachmentKey(attachmentId, parentUuid);
+      (_this$_stateAdapter = this._stateAdapter) === null || _this$_stateAdapter === void 0 || _this$_stateAdapter.setState(scopedKey, stateId, value);
+      (_getIoBehaviorManager = getIoBehaviorManager(this.sceneViewer)) === null || _getIoBehaviorManager === void 0 || _getIoBehaviorManager.triggerState(attachmentId, stateId, value, parentUuid);
+      (_this$sceneViewer4 = this.sceneViewer) === null || _this$sceneViewer4 === void 0 || _this$sceneViewer4.emit('io-device-state-changed', {
+        attachmentId: attachmentId,
+        stateId: stateId,
+        value: value,
+        parentUuid: parentUuid || null
+      });
     }
 
     /**
@@ -36873,7 +37047,6 @@ var ComponentTooltipManager = /*#__PURE__*/function (_BaseDisposable) {
     value: function update() {
       if (!this.tooltipEl || !this.selectedObject) return;
       this._positionTooltip();
-      this._refreshStateDisplays();
     }
 
     /**
@@ -36932,21 +37105,6 @@ var ComponentTooltipManager = /*#__PURE__*/function (_BaseDisposable) {
       this._styleInjected = false;
     }
 
-    /**
-     * Generate a scoped attachment key that includes the parent component UUID.
-     * This ensures each instance of a smart component has isolated IO device state.
-     * @param {string} attachmentId - The original attachment ID from the component data
-     * @param {string|null} parentUuid - The UUID of the parent smart component instance
-     * @returns {string} A scoped key in the format "parentUuid::attachmentId" or just attachmentId if no parent
-     * @private
-     */
-  }, {
-    key: "_getScopedAttachmentKey",
-    value: function _getScopedAttachmentKey(attachmentId, parentUuid) {
-      if (!parentUuid) return attachmentId;
-      return "".concat(parentUuid, "::").concat(attachmentId);
-    }
-
     /**
      * Gather I/O device children from a component's Three.js hierarchy.
      * Returns richer data including attachmentId and data point definitions.
@@ -36962,12 +37120,11 @@ var ComponentTooltipManager = /*#__PURE__*/function (_BaseDisposable) {
       object.traverse(function (child) {
         var _child$userData;
         if (((_child$userData = child.userData) === null || _child$userData === void 0 ? void 0 : _child$userData.objectType) === 'io-device') {
-          var _this3$sceneViewer$ma, _this3$sceneViewer;
           var attachmentId = child.userData.attachmentId || '';
 
           // Use only data points from the animate window (behaviorConfig).
           // The static ioConfig.states[] snapshot on userData is intentionally ignored.
-          var dataPoints = (_this3$sceneViewer$ma = (_this3$sceneViewer = _this3.sceneViewer) === null || _this3$sceneViewer === void 0 || (_this3$sceneViewer = _this3$sceneViewer.managers) === null || _this3$sceneViewer === void 0 || (_this3$sceneViewer = _this3$sceneViewer.ioBehaviorManager) === null || _this3$sceneViewer === void 0 ? void 0 : _this3$sceneViewer.getAnimationDataPoints(parentUuid, attachmentId)) !== null && _this3$sceneViewer$ma !== void 0 ? _this3$sceneViewer$ma : [];
+          var dataPoints = resolveDataPoints(parentUuid, attachmentId, child.userData, getIoBehaviorManager(_this3.sceneViewer));
 
           // When data points come from behaviorConfig they already carry direction:'input'.
           // Pass null so _buildDataPointRow uses the per-dp direction instead of the
@@ -36977,7 +37134,7 @@ var ComponentTooltipManager = /*#__PURE__*/function (_BaseDisposable) {
             label: child.userData.attachmentLabel || child.name || child.userData.deviceId || 'Unknown Device',
             deviceId: child.userData.deviceId || '',
             attachmentId: attachmentId,
-            scopedAttachmentId: _this3._getScopedAttachmentKey(attachmentId, parentUuid),
+            scopedAttachmentId: getScopedAttachmentKey(attachmentId, parentUuid),
             dataPoints: dataPoints,
             direction: deviceDirection
           });
@@ -37123,11 +37280,11 @@ var ComponentTooltipManager = /*#__PURE__*/function (_BaseDisposable) {
   }, {
     key: "_positionTooltip",
     value: function _positionTooltip() {
-      var _this$sceneViewer4, _this$sceneViewer5;
+      var _this$sceneViewer5, _this$sceneViewer6;
       if (!this.tooltipEl || !this.selectedObject) return;
       var container = this._getContainer();
-      var camera = (_this$sceneViewer4 = this.sceneViewer) === null || _this$sceneViewer4 === void 0 ? void 0 : _this$sceneViewer4.camera;
-      var renderer = (_this$sceneViewer5 = this.sceneViewer) === null || _this$sceneViewer5 === void 0 ? void 0 : _this$sceneViewer5.renderer;
+      var camera = (_this$sceneViewer5 = this.sceneViewer) === null || _this$sceneViewer5 === void 0 ? void 0 : _this$sceneViewer5.camera;
+      var renderer = (_this$sceneViewer6 = this.sceneViewer) === null || _this$sceneViewer6 === void 0 ? void 0 : _this$sceneViewer6.renderer;
       if (!container || !camera || !renderer) return;
 
       // Compute bounding box to position above the component
@@ -37164,8 +37321,8 @@ var ComponentTooltipManager = /*#__PURE__*/function (_BaseDisposable) {
   }, {
     key: "_getContainer",
     value: function _getContainer() {
-      var _this$sceneViewer6;
-      return ((_this$sceneViewer6 = this.sceneViewer) === null || _this$sceneViewer6 === void 0 || (_this$sceneViewer6 = _this$sceneViewer6.renderer) === null || _this$sceneViewer6 === void 0 || (_this$sceneViewer6 = _this$sceneViewer6.domElement) === null || _this$sceneViewer6 === void 0 ? void 0 : _this$sceneViewer6.parentElement) || null;
+      var _this$sceneViewer7;
+      return ((_this$sceneViewer7 = this.sceneViewer) === null || _this$sceneViewer7 === void 0 || (_this$sceneViewer7 = _this$sceneViewer7.renderer) === null || _this$sceneViewer7 === void 0 || (_this$sceneViewer7 = _this$sceneViewer7.domElement) === null || _this$sceneViewer7 === void 0 ? void 0 : _this$sceneViewer7.parentElement) || null;
     }
 
     // -----------------------------------------------------------------------
@@ -37205,10 +37362,9 @@ var ComponentTooltipManager = /*#__PURE__*/function (_BaseDisposable) {
       var currentVal = (_ref3 = (_this$_stateAdapter$g = (_this$_stateAdapter2 = this._stateAdapter) === null || _this$_stateAdapter2 === void 0 ? void 0 : _this$_stateAdapter2.getState(scopedAttachmentId, dpId)) !== null && _this$_stateAdapter$g !== void 0 ? _this$_stateAdapter$g : dp.defaultValue) !== null && _ref3 !== void 0 ? _ref3 : null;
       if (isInput) {
         var ctrl = this._buildInputControl(dp, currentVal, function (newVal) {
-          var _this5$_stateAdapter, _this5$selectedObject, _this5$sceneViewer;
-          (_this5$_stateAdapter = _this5._stateAdapter) === null || _this5$_stateAdapter === void 0 || _this5$_stateAdapter.setState(scopedAttachmentId, dpId, newVal);
+          var _this5$selectedObject;
           var parentUuid = ((_this5$selectedObject = _this5.selectedObject) === null || _this5$selectedObject === void 0 ? void 0 : _this5$selectedObject.uuid) || null;
-          (_this5$sceneViewer = _this5.sceneViewer) === null || _this5$sceneViewer === void 0 || (_this5$sceneViewer = _this5$sceneViewer.managers) === null || _this5$sceneViewer === void 0 || (_this5$sceneViewer = _this5$sceneViewer.ioBehaviorManager) === null || _this5$sceneViewer === void 0 || _this5$sceneViewer.triggerState(originalAttachmentId || scopedAttachmentId, dpId, newVal, parentUuid);
+          _this5._dispatchIoState(originalAttachmentId || scopedAttachmentId, dpId, newVal, parentUuid);
         });
         row.appendChild(ctrl);
         this._stateElements.set(key, {
@@ -37217,9 +37373,9 @@ var ComponentTooltipManager = /*#__PURE__*/function (_BaseDisposable) {
           isInput: true
         });
       } else {
-        var _dp$stateConfig2;
+        var _dp$stateConfig4;
         // unit suffix (optional, shown between name and badge)
-        var unit = (_dp$stateConfig2 = dp.stateConfig) === null || _dp$stateConfig2 === void 0 ? void 0 : _dp$stateConfig2.unit;
+        var unit = (_dp$stateConfig4 = dp.stateConfig) === null || _dp$stateConfig4 === void 0 ? void 0 : _dp$stateConfig4.unit;
         if (unit) {
           var unitEl = document.createElement('span');
           unitEl.className = 'cp-tooltip__dp-unit';
@@ -37380,6 +37536,257 @@ var ComponentTooltipManager = /*#__PURE__*/function (_BaseDisposable) {
   }]);
 }(BaseDisposable);
 
+/**
+ * Shared behavior schema helpers for runtime normalization and UI authoring.
+ * Used by IoBehaviorManager and sandbox BehaviorDialog.
+ */
+
+/**
+ * Normalize behavior from shorthand to full format.
+ * Supports:
+ *   - input: "attachment.state" → { attachment, state }
+ *   - outputs: ["attachment.state", ...] → converted to _outputs array
+ *
+ * @param {Object} behavior - Raw behavior from scene JSON
+ * @returns {Object} Normalized behavior
+ */
+function normalizeBehavior(behavior) {
+  var normalized = _objectSpread2({}, behavior);
+  if (typeof behavior.input === 'string') {
+    var _behavior$input$split = behavior.input.split('.'),
+      _behavior$input$split2 = _slicedToArray(_behavior$input$split, 2),
+      attachment = _behavior$input$split2[0],
+      state = _behavior$input$split2[1];
+    normalized.input = {
+      attachment: attachment,
+      state: state
+    };
+  }
+  if (behavior.outputs) {
+    normalized._outputs = behavior.outputs.map(function (out) {
+      if (typeof out === 'string') {
+        var _out$split = out.split('.'),
+          _out$split2 = _slicedToArray(_out$split, 2),
+          _attachment = _out$split2[0],
+          _state = _out$split2[1];
+        return {
+          attachment: _attachment,
+          state: _state
+        };
+      }
+      return out;
+    });
+    delete normalized.outputs;
+  } else if (typeof behavior.output === 'string') {
+    var _behavior$output$spli = behavior.output.split('.'),
+      _behavior$output$spli2 = _slicedToArray(_behavior$output$spli, 2),
+      _attachment2 = _behavior$output$spli2[0],
+      _state2 = _behavior$output$spli2[1];
+    normalized.output = {
+      attachment: _attachment2,
+      state: _state2
+    };
+  }
+  return normalized;
+}
+
+/**
+ * Build intra-component shorthand behavior from form fields.
+ */
+function buildIntraBehavior(_ref) {
+  var id = _ref.id,
+    inputAttachment = _ref.inputAttachment,
+    inputState = _ref.inputState,
+    outputs = _ref.outputs;
+  return {
+    id: id || "behavior-".concat(Date.now()),
+    input: "".concat(inputAttachment, ".").concat(inputState),
+    outputs: outputs.filter(function (o) {
+      return o.attachment && o.state;
+    }).map(function (o) {
+      return "".concat(o.attachment, ".").concat(o.state);
+    })
+  };
+}
+
+/**
+ * Parse intra-component shorthand into form fields.
+ */
+function parseIntraBehavior(behavior) {
+  var inputAttachment = null;
+  var inputState = null;
+  if (typeof behavior.input === 'string') {
+    var _behavior$input$split3 = behavior.input.split('.');
+    var _behavior$input$split4 = _slicedToArray(_behavior$input$split3, 2);
+    inputAttachment = _behavior$input$split4[0];
+    inputState = _behavior$input$split4[1];
+  } else if (behavior.input && _typeof(behavior.input) === 'object') {
+    inputAttachment = behavior.input.attachment || null;
+    inputState = behavior.input.state || null;
+  }
+  var outputs = (behavior.outputs || []).map(function (out) {
+    if (typeof out === 'string') {
+      var _out$split3 = out.split('.'),
+        _out$split4 = _slicedToArray(_out$split3, 2),
+        attachment = _out$split4[0],
+        state = _out$split4[1];
+      return {
+        attachment: attachment,
+        state: state
+      };
+    }
+    return {
+      attachment: (out === null || out === void 0 ? void 0 : out.attachment) || null,
+      state: (out === null || out === void 0 ? void 0 : out.state) || null
+    };
+  });
+  return {
+    id: behavior.id || '',
+    inputAttachment: inputAttachment || null,
+    inputState: inputState || null,
+    outputs: outputs.length ? outputs : [{
+      attachment: null,
+      state: null
+    }]
+  };
+}
+
+/**
+ * Build cross-component behavior with component instance scoping.
+ */
+function buildCrossBehavior(_ref2) {
+  var id = _ref2.id,
+    inputEndpoint = _ref2.inputEndpoint,
+    inputState = _ref2.inputState,
+    outputs = _ref2.outputs;
+  var _split = (inputEndpoint || '').split('::'),
+    _split2 = _slicedToArray(_split, 2),
+    inputComponent = _split2[0],
+    inputAttachment = _split2[1];
+  return {
+    id: id || "behavior-".concat(Date.now()),
+    input: {
+      component: inputComponent,
+      attachment: inputAttachment,
+      state: inputState
+    },
+    outputs: outputs.filter(function (o) {
+      return o.endpoint && o.state;
+    }).map(function (o) {
+      var _o$endpoint$split = o.endpoint.split('::'),
+        _o$endpoint$split2 = _slicedToArray(_o$endpoint$split, 2),
+        component = _o$endpoint$split2[0],
+        attachment = _o$endpoint$split2[1];
+      return {
+        component: component,
+        attachment: attachment,
+        state: o.state
+      };
+    })
+  };
+}
+
+/**
+ * Parse cross-component behavior into form fields.
+ */
+function parseCrossBehavior(behavior) {
+  var inputComponent, inputAttachment, inputState;
+  if (typeof behavior.input === 'string') {
+    var _behavior$input$split5 = behavior.input.split('.'),
+      _behavior$input$split6 = _slicedToArray(_behavior$input$split5, 2),
+      attachment = _behavior$input$split6[0],
+      state = _behavior$input$split6[1];
+    inputAttachment = attachment;
+    inputState = state;
+    inputComponent = null;
+  } else if (behavior.input) {
+    inputComponent = behavior.input.component;
+    inputAttachment = behavior.input.attachment;
+    inputState = behavior.input.state;
+  }
+  var rawOutputs = behavior.outputs || (behavior.output ? [behavior.output] : behavior._outputs || []);
+  var outputs = rawOutputs.map(function (out) {
+    if (typeof out === 'string') {
+      var _out$split5 = out.split('.'),
+        _out$split6 = _slicedToArray(_out$split5, 2),
+        _attachment3 = _out$split6[0],
+        _state3 = _out$split6[1];
+      return {
+        endpoint: _attachment3 ? "::".concat(_attachment3) : null,
+        state: _state3
+      };
+    }
+    var endpoint = out.component && out.attachment ? "".concat(out.component, "::").concat(out.attachment) : out.attachment ? "::".concat(out.attachment) : null;
+    return {
+      endpoint: endpoint,
+      state: out.state || null
+    };
+  });
+  var inputEndpoint = inputComponent && inputAttachment ? "".concat(inputComponent, "::").concat(inputAttachment) : inputAttachment ? "::".concat(inputAttachment) : null;
+  return {
+    id: behavior.id || '',
+    inputEndpoint: inputEndpoint,
+    inputState: inputState || null,
+    outputs: outputs.length ? outputs : [{
+      endpoint: null,
+      state: null
+    }]
+  };
+}
+
+/**
+ * Translation helpers for I/O device animations.
+ * Offsets are expressed in the device/model root's local space so every child
+ * mesh moves along the same predictable axes regardless of intermediate parents.
+ */
+
+/**
+ * @param {THREE.Object3D} modelRoot
+ * @param {{ x?: number, y?: number, z?: number }|THREE.Vector3} offset
+ * @returns {THREE.Vector3}
+ */
+function modelOffsetToWorldDelta(modelRoot, offset) {
+  var _offset$x, _offset$y, _offset$z;
+  var v = offset instanceof THREE__namespace.Vector3 ? offset.clone() : new THREE__namespace.Vector3((_offset$x = offset === null || offset === void 0 ? void 0 : offset.x) !== null && _offset$x !== void 0 ? _offset$x : 0, (_offset$y = offset === null || offset === void 0 ? void 0 : offset.y) !== null && _offset$y !== void 0 ? _offset$y : 0, (_offset$z = offset === null || offset === void 0 ? void 0 : offset.z) !== null && _offset$z !== void 0 ? _offset$z : 0);
+  var q = new THREE__namespace.Quaternion();
+  modelRoot.getWorldQuaternion(q);
+  return v.applyQuaternion(q);
+}
+
+/**
+ * Apply a model-root-space translation from a mesh's rest local pose.
+ *
+ * @param {THREE.Object3D} mesh
+ * @param {THREE.Object3D} modelRoot
+ * @param {THREE.Vector3} origLocalPos
+ * @param {{ x?: number, y?: number, z?: number }} modelOffset
+ */
+function applyModelRootTranslation(mesh, modelRoot, origLocalPos, modelOffset) {
+  if (!mesh || !modelRoot || !origLocalPos) return;
+  mesh.position.copy(origLocalPos);
+  mesh.updateMatrixWorld(true);
+  var origWorldPos = new THREE__namespace.Vector3();
+  mesh.getWorldPosition(origWorldPos);
+  var newWorldPos = origWorldPos.add(modelOffsetToWorldDelta(modelRoot, modelOffset));
+  if (mesh.parent) mesh.parent.worldToLocal(newWorldPos);
+  mesh.position.copy(newWorldPos);
+}
+
+/**
+ * Apply a model-root-space translation from a cached rest world position (preview).
+ *
+ * @param {THREE.Object3D} mesh
+ * @param {THREE.Object3D} modelRoot
+ * @param {THREE.Vector3} baseWorldPos
+ * @param {{ x?: number, y?: number, z?: number }} modelOffset
+ */
+function applyModelRootTranslationFromWorldBase(mesh, modelRoot, baseWorldPos, modelOffset) {
+  if (!mesh || !modelRoot || !baseWorldPos) return;
+  var newWorldPos = baseWorldPos.clone().add(modelOffsetToWorldDelta(modelRoot, modelOffset));
+  if (mesh.parent) mesh.parent.worldToLocal(newWorldPos);
+  mesh.position.copy(newWorldPos);
+}
+
 var IoBehaviorManager = /*#__PURE__*/function (_BaseDisposable) {
   function IoBehaviorManager(sceneViewer) {
     var _this;
@@ -37397,12 +37804,11 @@ var IoBehaviorManager = /*#__PURE__*/function (_BaseDisposable) {
      */
     _this._entries = new Map();
     _this._crossComponentBehaviors = [];
-
-    /**
-     * Map: `${componentUuid}` → Array<{ id, input, outputs }>
-     * Component-level behaviors for intra-component io-device linking
-     */
     _this._componentBehaviors = new Map();
+    /** @type {Map<string, string>} parentUuid::attachmentId → parentUuid */
+    _this._attachmentParentMap = new Map();
+    /** @type {Map<string, Object[]>} cache key → data point definitions */
+    _this._dataPointsCache = new Map();
 
     /**
      * Injected by the host application to read and write I/O device state.
@@ -37492,7 +37898,10 @@ var IoBehaviorManager = /*#__PURE__*/function (_BaseDisposable) {
       }
       if (entries.length) {
         this._entries.set(key, entries);
-        // Loaded ${entries.length} animation(s) for attachment "${attachmentId}"
+        if (parentUuid && attachmentId) {
+          this._attachmentParentMap.set(this._key(parentUuid, attachmentId), parentUuid);
+        }
+        this._invalidateDataPointsCache(parentUuid, attachmentId);
       } else {
         console.warn("[IoBehaviorManager] No mesh entries resolved for attachment \"".concat(attachmentId, "\" \u2014 behaviorConfig had ").concat(anims.length, " entries but none matched a mesh"));
       }
@@ -37500,7 +37909,6 @@ var IoBehaviorManager = /*#__PURE__*/function (_BaseDisposable) {
 
     /**
      * 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
@@ -37510,70 +37918,36 @@ var IoBehaviorManager = /*#__PURE__*/function (_BaseDisposable) {
   }, {
     key: "triggerState",
     value: function triggerState(attachmentId, dataPointId, value, parentUuid) {
-      // triggerState: ${attachmentId}.${dataPointId} = ${value}
-
-      if (parentUuid) {
-        var key = this._key(parentUuid, attachmentId);
-        var entries = this._entries.get(key);
-        if (entries) {
-          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();
-          }
-        }
-      } else {
-        // Fallback when parentUuid is not provided: match by attachmentId suffix or exact key match
-        var suffix = "::".concat(attachmentId);
-        var _iterator3 = _createForOfIteratorHelper(this._entries.entries()),
-          _step3;
+      var _this$_crossComponent;
+      var resolvedParent = parentUuid || this._findComponentByAttachment(attachmentId);
+      if (!resolvedParent) return;
+      var key = this._key(resolvedParent, attachmentId);
+      var entries = this._entries.get(key);
+      if (entries) {
+        var _iterator2 = _createForOfIteratorHelper(entries),
+          _step2;
         try {
-          for (_iterator3.s(); !(_step3 = _iterator3.n()).done;) {
-            var _step3$value = _slicedToArray(_step3.value, 2),
-              _key2 = _step3$value[0],
-              _entries = _step3$value[1];
-            if (_key2 === attachmentId || _key2.endsWith(suffix)) {
-              var _iterator4 = _createForOfIteratorHelper(_entries),
-                _step4;
-              try {
-                for (_iterator4.s(); !(_step4 = _iterator4.n()).done;) {
-                  var _entry = _step4.value;
-                  if (_entry.anim.stateVariable !== dataPointId) continue;
-                  this._applyAnimation(_entry, value);
-                }
-              } catch (err) {
-                _iterator4.e(err);
-              } finally {
-                _iterator4.f();
-              }
-            }
+          for (_iterator2.s(); !(_step2 = _iterator2.n()).done;) {
+            var entry = _step2.value;
+            if (entry.anim.stateVariable !== dataPointId) continue;
+            this._applyAnimation(entry, value);
           }
         } catch (err) {
-          _iterator3.e(err);
+          _iterator2.e(err);
         } finally {
-          _iterator3.f();
+          _iterator2.f();
         }
       }
 
       // Evaluate component-level behaviors (intra-component io-device linking)
-      if (parentUuid && this._componentBehaviors.has(parentUuid)) {
-        var componentBehaviors = this._componentBehaviors.get(parentUuid);
-        // Checking component-level behaviors (count: ${componentBehaviors.length})
-        this.triggerCrossComponentBehaviors(componentBehaviors, parentUuid, attachmentId, dataPointId, value);
+      if (this._componentBehaviors.has(resolvedParent)) {
+        var componentBehaviors = this._componentBehaviors.get(resolvedParent);
+        this.triggerCrossComponentBehaviors(componentBehaviors, resolvedParent, attachmentId, dataPointId, value, {
+          sameComponent: true
+        });
       }
-
-      // Evaluate cross-component behaviors if any are registered
-      // Checking cross-component behaviors (count: ${this._crossComponentBehaviors?.length || 0})
-      if (this._crossComponentBehaviors && this._crossComponentBehaviors.length > 0) {
-        this.triggerCrossComponentBehaviors(this._crossComponentBehaviors, parentUuid, attachmentId, dataPointId, value);
+      if (((_this$_crossComponent = this._crossComponentBehaviors) === null || _this$_crossComponent === void 0 ? void 0 : _this$_crossComponent.length) > 0) {
+        this.triggerCrossComponentBehaviors(this._crossComponentBehaviors, resolvedParent, attachmentId, dataPointId, value);
       }
     }
 
@@ -37586,9 +37960,8 @@ var IoBehaviorManager = /*#__PURE__*/function (_BaseDisposable) {
   }, {
     key: "setCrossComponentBehaviors",
     value: function setCrossComponentBehaviors(behaviors) {
-      var _this2 = this;
       this._crossComponentBehaviors = (behaviors || []).map(function (b) {
-        return _this2._normalizeBehavior(b);
+        return normalizeBehavior(b);
       });
       // Loaded ${this._crossComponentBehaviors.length} cross-component behavior(s)
     }
@@ -37603,72 +37976,17 @@ var IoBehaviorManager = /*#__PURE__*/function (_BaseDisposable) {
   }, {
     key: "registerComponentBehaviors",
     value: function registerComponentBehaviors(componentUuid, behaviors) {
-      var _this3 = this;
-      if (!behaviors || behaviors.length === 0) return;
+      if (!behaviors || behaviors.length === 0) {
+        this._componentBehaviors.delete(componentUuid);
+        return;
+      }
       var normalized = behaviors.map(function (b) {
-        return _this3._normalizeBehavior(b);
+        return normalizeBehavior(b);
       });
       this._componentBehaviors.set(componentUuid, normalized);
       // Registered ${normalized.length} component-level behavior(s) for component ${componentUuid}
     }
 
-    /**
-     * Normalize behavior from shorthand to full format.
-     * Supports:
-     *   - input: "attachment.state" → { attachment, state }
-     *   - outputs: ["attachment.state", ...] → converted to individual behaviors
-     *
-     * @param {Object} behavior - Raw behavior from scene JSON
-     * @returns {Object} Normalized behavior
-     */
-  }, {
-    key: "_normalizeBehavior",
-    value: function _normalizeBehavior(behavior) {
-      var normalized = _objectSpread2({}, behavior);
-
-      // Parse shorthand input: "attachment.state"
-      if (typeof behavior.input === 'string') {
-        var _behavior$input$split = behavior.input.split('.'),
-          _behavior$input$split2 = _slicedToArray(_behavior$input$split, 2),
-          attachment = _behavior$input$split2[0],
-          state = _behavior$input$split2[1];
-        normalized.input = {
-          attachment: attachment,
-          state: state
-        };
-      }
-
-      // Parse shorthand output/outputs
-      if (behavior.outputs) {
-        // Multiple outputs - expand to array
-        normalized._outputs = behavior.outputs.map(function (out) {
-          if (typeof out === 'string') {
-            var _out$split = out.split('.'),
-              _out$split2 = _slicedToArray(_out$split, 2),
-              _attachment = _out$split2[0],
-              _state = _out$split2[1];
-            return {
-              attachment: _attachment,
-              state: _state
-            };
-          }
-          return out;
-        });
-        delete normalized.outputs;
-      } else if (typeof behavior.output === 'string') {
-        // Single output string
-        var _behavior$output$spli = behavior.output.split('.'),
-          _behavior$output$spli2 = _slicedToArray(_behavior$output$spli, 2),
-          _attachment2 = _behavior$output$spli2[0],
-          _state2 = _behavior$output$spli2[1];
-        normalized.output = {
-          attachment: _attachment2,
-          state: _state2
-        };
-      }
-      return normalized;
-    }
-
     /**
      * Find the parent component UUID for a given attachment ID.
      * Searches the scene tree for the io-device with this attachment ID,
@@ -37682,12 +38000,10 @@ var IoBehaviorManager = /*#__PURE__*/function (_BaseDisposable) {
     value: function _findComponentByAttachment(attachmentId) {
       var _this$sceneViewer;
       if (!((_this$sceneViewer = this.sceneViewer) !== null && _this$sceneViewer !== void 0 && _this$sceneViewer.scene)) return null;
-      var scene = this.sceneViewer.scene;
       var found = null;
-      scene.traverse(function (obj) {
+      this.sceneViewer.scene.traverse(function (obj) {
         var _obj$userData, _obj$userData2;
         if (found) return;
-        // Find the io-device object with this attachmentId
         if (((_obj$userData = obj.userData) === null || _obj$userData === void 0 ? void 0 : _obj$userData.objectType) === 'io-device' && ((_obj$userData2 = obj.userData) === null || _obj$userData2 === void 0 ? void 0 : _obj$userData2.attachmentId) === attachmentId) {
           found = obj.userData.parentComponentId;
         }
@@ -37731,20 +38047,21 @@ var IoBehaviorManager = /*#__PURE__*/function (_BaseDisposable) {
      * @param {string} triggerAttachmentId - Attachment ID of the triggering device
      * @param {string} triggerStateId - The state variable ID that changed
      * @param {*} value - The new state value
+     * @param {{ sameComponent?: boolean }} [options] - Intra-component links share one parent instance
      */
   }, {
     key: "triggerCrossComponentBehaviors",
     value: function triggerCrossComponentBehaviors(behaviors, triggerParentUuid, triggerAttachmentId, triggerStateId, value) {
+      var options = arguments.length > 5 && arguments[5] !== undefined ? arguments[5] : {};
       if (!behaviors || !Array.isArray(behaviors)) {
         return;
       }
-
-      // Evaluating ${behaviors.length} behavior(s)
-      var _iterator5 = _createForOfIteratorHelper(behaviors),
-        _step5;
+      var sameComponent = options.sameComponent === true;
+      var _iterator3 = _createForOfIteratorHelper(behaviors),
+        _step3;
       try {
-        for (_iterator5.s(); !(_step5 = _iterator5.n()).done;) {
-          var behavior = _step5.value;
+        for (_iterator3.s(); !(_step3 = _iterator3.n()).done;) {
+          var behavior = _step3.value;
           var input = behavior.input,
             output = behavior.output,
             _outputs = behavior._outputs,
@@ -37753,94 +38070,69 @@ var IoBehaviorManager = /*#__PURE__*/function (_BaseDisposable) {
             console.warn('[Behavior] Skipping behavior - missing input or output(s):', behavior);
             continue;
           }
-
-          // Auto-lookup component if not specified
-          var inputComponent = input.component || this._findComponentByAttachment(input.attachment);
-          console.log("[Behavior] Checking behavior \"".concat(behavior.id, "\":"), {
-            inputMatch: inputComponent === triggerParentUuid,
-            attachmentMatch: input.attachment === triggerAttachmentId,
-            stateMatch: input.state === triggerStateId,
-            expected: {
-              component: inputComponent,
-              attachment: input.attachment,
-              state: input.state
-            },
-            actual: {
-              component: triggerParentUuid,
-              attachment: triggerAttachmentId,
-              state: triggerStateId
-            }
-          });
-
-          // Verify that the input matches the triggering source
-          if (inputComponent === triggerParentUuid && input.attachment === triggerAttachmentId && input.state === triggerStateId) {
+          var inputComponent = input.component || (sameComponent ? triggerParentUuid : this._findComponentByAttachment(input.attachment));
+          var inputMatches = sameComponent ? input.attachment === triggerAttachmentId && input.state === triggerStateId : inputComponent === triggerParentUuid && input.attachment === triggerAttachmentId && input.state === triggerStateId;
+          if (inputMatches) {
             // Behavior "${behavior.id}" matched
 
             // Collect all outputs (single or multiple)
             var outputs = _outputs || (output ? [output] : []);
 
             // Process each output
-            var _iterator6 = _createForOfIteratorHelper(outputs),
-              _step6;
+            var _iterator4 = _createForOfIteratorHelper(outputs),
+              _step4;
             try {
-              for (_iterator6.s(); !(_step6 = _iterator6.n()).done;) {
-                var out = _step6.value;
+              for (_iterator4.s(); !(_step4 = _iterator4.n()).done;) {
+                var out = _step4.value;
                 // NEW: State-to-state pass-through pattern
                 if (out.state) {
-                  // Auto-lookup output component if not specified
-                  var outputComponent = out.component || this._findComponentByAttachment(out.attachment);
-
-                  // Direct state mapping without conditions
+                  var outputComponent = out.component || (sameComponent ? triggerParentUuid : this._findComponentByAttachment(out.attachment));
                   if (this._stateAdapter) {
-                    // Dispatching state-to-state: ${out.attachment}.${out.state} = ${value}
-                    this._stateAdapter.setState(out.attachment, out.state, value);
-
-                    // Trigger animations on the output component
-                    // triggerState(attachmentId, dataPointId, value, parentUuid)
+                    var scopedKey = getScopedAttachmentKey(out.attachment, outputComponent);
+                    this._stateAdapter.setState(scopedKey, out.state, value);
                     if (outputComponent) {
-                      // Triggering animations on output component
                       this.triggerState(out.attachment, out.state, value, outputComponent);
                     } else {
                       console.warn("[Behavior] Could not find component for attachment \"".concat(out.attachment, "\""));
                     }
                   } else {
-                    console.warn('[Behavior] ✗ State adapter not configured for state-to-state behavior');
+                    console.warn('[Behavior] State adapter not configured for state-to-state behavior');
                   }
                 }
                 // LEGACY: Mesh-based pattern with conditions
                 else if (conditions && out.child) {
                   // Using legacy mesh-based pattern with conditions
                   // Evaluate conditions
-                  var _iterator7 = _createForOfIteratorHelper(conditions),
-                    _step7;
+                  var _iterator5 = _createForOfIteratorHelper(conditions),
+                    _step5;
                   try {
-                    for (_iterator7.s(); !(_step7 = _iterator7.n()).done;) {
-                      var condition = _step7.value;
+                    for (_iterator5.s(); !(_step5 = _iterator5.n()).done;) {
+                      var condition = _step5.value;
                       if (this._evaluateCondition(condition.when, value)) {
                         // Apply actions to the target output component/attachment/child mesh
                         this._applyCrossComponentActions(out, condition.actions);
                       }
                     }
                   } catch (err) {
-                    _iterator7.e(err);
+                    _iterator5.e(err);
                   } finally {
-                    _iterator7.f();
+                    _iterator5.f();
                   }
                 } else {
                   console.warn('[Behavior] Output has neither state nor (child + conditions):', out);
                 }
               } // end outputs loop
             } catch (err) {
-              _iterator6.e(err);
+              _iterator4.e(err);
             } finally {
-              _iterator6.f();
+              _iterator4.f();
             }
           }
         }
       } catch (err) {
-        _iterator5.e(err);
+        _iterator3.e(err);
       } finally {
-        _iterator5.f();
+        _iterator3.f();
       }
     }
 
@@ -37910,17 +38202,17 @@ var IoBehaviorManager = /*#__PURE__*/function (_BaseDisposable) {
       }
 
       // 4. Apply actions to targetObj
-      var _iterator8 = _createForOfIteratorHelper(actions),
-        _step8;
+      var _iterator6 = _createForOfIteratorHelper(actions),
+        _step6;
       try {
-        for (_iterator8.s(); !(_step8 = _iterator8.n()).done;) {
-          var action = _step8.value;
+        for (_iterator6.s(); !(_step6 = _iterator6.n()).done;) {
+          var action = _step6.value;
           this._applyCrossComponentAction(targetObj, action);
         }
       } catch (err) {
-        _iterator8.e(err);
+        _iterator6.e(err);
       } finally {
-        _iterator8.f();
+        _iterator6.f();
       }
     }
 
@@ -38012,8 +38304,12 @@ var IoBehaviorManager = /*#__PURE__*/function (_BaseDisposable) {
   }, {
     key: "getAnimationDataPoints",
     value: function getAnimationDataPoints(parentUuid, attachmentId) {
-      var _this4 = this;
+      var _this2 = this;
       var hitMesh = arguments.length > 2 && arguments[2] !== undefined ? arguments[2] : null;
+      var cacheKey = "".concat(this._key(parentUuid, attachmentId), "::").concat((hitMesh === null || hitMesh === void 0 ? void 0 : hitMesh.uuid) || '');
+      if (this._dataPointsCache.has(cacheKey)) {
+        return this._dataPointsCache.get(cacheKey);
+      }
       var key = this._key(parentUuid, attachmentId);
       var entries = this._entries.get(key);
       if (!(entries !== null && entries !== void 0 && entries.length)) return [];
@@ -38024,35 +38320,35 @@ var IoBehaviorManager = /*#__PURE__*/function (_BaseDisposable) {
       var filtered = entries;
       if (hitMesh) {
         var matching = entries.filter(function (e) {
-          return _this4._isMeshOrDescendant(hitMesh, e.mesh);
+          return _this2._isMeshOrDescendant(hitMesh, e.mesh);
         });
         if (matching.length > 0) filtered = matching;
       }
 
       // Collapse multiple mesh entries that share the same stateVariable
       var seen = new Map(); // stateVariable → anim
-      var _iterator9 = _createForOfIteratorHelper(filtered),
-        _step9;
+      var _iterator7 = _createForOfIteratorHelper(filtered),
+        _step7;
       try {
-        for (_iterator9.s(); !(_step9 = _iterator9.n()).done;) {
-          var anim = _step9.value.anim;
+        for (_iterator7.s(); !(_step7 = _iterator7.n()).done;) {
+          var anim = _step7.value.anim;
           if (!seen.has(anim.stateVariable)) {
             seen.set(anim.stateVariable, anim);
           }
         }
       } catch (err) {
-        _iterator9.e(err);
+        _iterator7.e(err);
       } finally {
-        _iterator9.f();
+        _iterator7.f();
       }
       var dps = [];
-      var _iterator0 = _createForOfIteratorHelper(seen),
-        _step0;
+      var _iterator8 = _createForOfIteratorHelper(seen),
+        _step8;
       try {
-        for (_iterator0.s(); !(_step0 = _iterator0.n()).done;) {
-          var _step0$value = _slicedToArray(_step0.value, 2),
-            stateVar = _step0$value[0],
-            _anim = _step0$value[1];
+        for (_iterator8.s(); !(_step8 = _iterator8.n()).done;) {
+          var _step8$value = _slicedToArray(_step8.value, 2),
+            stateVar = _step8$value[0],
+            _anim = _step8$value[1];
           // Normalise stateType from AnimateDevicesDialog variants
           var stateType = void 0;
           var raw = (_anim.stateType || '').toLowerCase();
@@ -38103,10 +38399,11 @@ var IoBehaviorManager = /*#__PURE__*/function (_BaseDisposable) {
           });
         }
       } catch (err) {
-        _iterator0.e(err);
+        _iterator8.e(err);
       } finally {
-        _iterator0.f();
+        _iterator8.f();
       }
+      this._dataPointsCache.set(cacheKey, dps);
       return dps;
     }
 
@@ -38140,25 +38437,46 @@ var IoBehaviorManager = /*#__PURE__*/function (_BaseDisposable) {
     key: "unloadForComponent",
     value: function unloadForComponent(parentUuid) {
       var prefix = "".concat(parentUuid, "::");
-      var _iterator1 = _createForOfIteratorHelper(this._entries.keys()),
-        _step1;
-      try {
-        for (_iterator1.s(); !(_step1 = _iterator1.n()).done;) {
-          var key = _step1.value;
-          if (key.startsWith(prefix)) {
-            this._entries.delete(key);
-          }
+      for (var _i = 0, _arr = _toConsumableArray(this._entries.keys()); _i < _arr.length; _i++) {
+        var key = _arr[_i];
+        if (key.startsWith(prefix)) {
+          this._attachmentParentMap.delete(key);
+          this._entries.delete(key);
         }
-      } catch (err) {
-        _iterator1.e(err);
-      } finally {
-        _iterator1.f();
       }
+      this._componentBehaviors.delete(parentUuid);
+      this._invalidateDataPointsCacheForParent(parentUuid);
+    }
+
+    /**
+     * Remove animation entries for a single attachment on a component instance.
+     */
+  }, {
+    key: "unloadForAttachment",
+    value: function unloadForAttachment(parentUuid, attachmentId) {
+      var key = this._key(parentUuid, attachmentId);
+      this._entries.delete(key);
+      this._attachmentParentMap.delete(key);
+      this._invalidateDataPointsCache(parentUuid, attachmentId);
+    }
+
+    /**
+     * Clear all runtime behavior state when the scene is cleared or replaced.
+     */
+  }, {
+    key: "resetForScene",
+    value: function resetForScene() {
+      this._entries.clear();
+      this._componentBehaviors.clear();
+      this._crossComponentBehaviors = [];
+      this._attachmentParentMap.clear();
+      this._dataPointsCache.clear();
     }
   }, {
     key: "dispose",
     value: function dispose() {
-      this._entries.clear();
+      this.resetForScene();
+      this._stateAdapter = null;
       _superPropGet(IoBehaviorManager, "dispose", this, 3)([]);
     }
 
@@ -38225,20 +38543,20 @@ var IoBehaviorManager = /*#__PURE__*/function (_BaseDisposable) {
     key: "_applyAnimation",
     value: function _applyAnimation(entry, value) {
       var anim = entry.anim,
-        mesh = entry.mesh,
-        origPos = entry.origPos;
+        mesh = entry.mesh;
+        entry.origPos;
         entry.origRot;
         var viewerMaxDim = entry.viewerMaxDim;
       var mapping = this._resolveMapping(anim, value);
       if (!mapping) return;
       var types = anim.transformTypes || [];
-      var _iterator10 = _createForOfIteratorHelper(types),
-        _step10;
+      var _iterator9 = _createForOfIteratorHelper(types),
+        _step9;
       try {
-        for (_iterator10.s(); !(_step10 = _iterator10.n()).done;) {
-          var type = _step10.value;
+        for (_iterator9.s(); !(_step9 = _iterator9.n()).done;) {
+          var type = _step9.value;
           if (type === 'translation') {
-            this._applyTranslation(mesh, origPos, mapping.transform);
+            this._applyTranslation(entry, mapping.transform);
           } else if (type === 'rotation') {
             this._applyRotation(entry, anim, mapping.rotationTransform, viewerMaxDim);
           } else if (type === 'color') {
@@ -38246,9 +38564,9 @@ var IoBehaviorManager = /*#__PURE__*/function (_BaseDisposable) {
           }
         }
       } catch (err) {
-        _iterator10.e(err);
+        _iterator9.e(err);
       } finally {
-        _iterator10.f();
+        _iterator9.f();
       }
     }
 
@@ -38368,20 +38686,21 @@ var IoBehaviorManager = /*#__PURE__*/function (_BaseDisposable) {
     // ─────────────────────────────────────────────────────────────────────────
 
     /**
-     * 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
+     * Apply a translation offset in device-model-root space so every animated mesh
+     * shares the same axis directions regardless of intermediate parent transforms.
+     *
+     * @param {{ mesh, origPos, deviceModelRoot }} entry
+     * @param {{ x, y, z }} transform - Offset in model-root local space
      */
   }, {
     key: "_applyTranslation",
-    value: function _applyTranslation(mesh, origPos, transform) {
-      var _transform$x, _transform$y, _transform$z;
+    value: function _applyTranslation(entry, transform) {
       if (!transform) return;
-      // X and Y are negated to match the sign convention used in the AnimateDevicesDialog
-      // preview (_syncViewerTransform negates x and y before calling setMeshPreviewOffset).
-      // Z is added directly (no negation) — matching the dialog's z handling.
-      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));
+      var mesh = entry.mesh,
+        origPos = entry.origPos,
+        deviceModelRoot = entry.deviceModelRoot;
+      if (!mesh || !origPos || !deviceModelRoot) return;
+      applyModelRootTranslation(mesh, deviceModelRoot, origPos, transform);
     }
 
     /**
@@ -38400,6 +38719,9 @@ var IoBehaviorManager = /*#__PURE__*/function (_BaseDisposable) {
         origRot = entry.origRot,
         deviceModelRoot = entry.deviceModelRoot;
       if (!mesh || !origPos || !origRot) return null;
+      if (entry._restWorldCache) {
+        return entry._restWorldCache;
+      }
       var savedPos = mesh.position.clone();
       var savedQuat = mesh.quaternion.clone();
       mesh.position.copy(origPos);
@@ -38418,12 +38740,35 @@ var IoBehaviorManager = /*#__PURE__*/function (_BaseDisposable) {
       }
       mesh.position.copy(savedPos);
       mesh.quaternion.copy(savedQuat);
-      return {
+      entry._restWorldCache = {
         origWorldPos: origWorldPos,
         origWorldQuat: origWorldQuat,
         origWorldCenter: origWorldCenter,
         deviceWorldQuat: deviceWorldQuat
       };
+      return entry._restWorldCache;
+    }
+  }, {
+    key: "_invalidateDataPointsCache",
+    value: function _invalidateDataPointsCache(parentUuid, attachmentId) {
+      var prefix = "".concat(this._key(parentUuid, attachmentId), "::");
+      for (var _i2 = 0, _arr2 = _toConsumableArray(this._dataPointsCache.keys()); _i2 < _arr2.length; _i2++) {
+        var key = _arr2[_i2];
+        if (key.startsWith(prefix)) {
+          this._dataPointsCache.delete(key);
+        }
+      }
+    }
+  }, {
+    key: "_invalidateDataPointsCacheForParent",
+    value: function _invalidateDataPointsCacheForParent(parentUuid) {
+      var prefix = "".concat(parentUuid, "::");
+      for (var _i3 = 0, _arr3 = _toConsumableArray(this._dataPointsCache.keys()); _i3 < _arr3.length; _i3++) {
+        var key = _arr3[_i3];
+        if (key.startsWith(prefix)) {
+          this._dataPointsCache.delete(key);
+        }
+      }
     }
 
     /**
@@ -38956,6 +39301,7 @@ var CentralPlantInternals = /*#__PURE__*/function () {
         // Initialize the component tooltip manager (screen-space tooltip on selection)
         this.centralPlant.managers.componentTooltipManager = new ComponentTooltipManager(this.centralPlant.sceneViewer);
         this.centralPlant.sceneViewer.componentTooltipManager = this.centralPlant.managers.componentTooltipManager;
+        this.centralPlant.sceneViewer.managers.componentTooltipManager = this.centralPlant.managers.componentTooltipManager;
       }
     }
 
@@ -39864,37 +40210,14 @@ var CentralPlantInternals = /*#__PURE__*/function () {
         // Add attached IO device models for smart components
         if (componentData.isSmart && componentData.attachedDevices) {
           var _this$centralPlant$sc8;
-          attachIODevicesToComponent(componentModel, componentData, modelPreloader, componentId);
-
-          // Register behavior configs so IoBehaviorManager can respond to state changes
           var ioBehavMgr = (_this$centralPlant$sc8 = this.centralPlant.sceneViewer) === null || _this$centralPlant$sc8 === void 0 || (_this$centralPlant$sc8 = _this$centralPlant$sc8.managers) === null || _this$centralPlant$sc8 === void 0 ? void 0 : _this$centralPlant$sc8.ioBehaviorManager;
-          if (ioBehavMgr) {
-            var _loop = function _loop() {
-              var _modelPreloader$compo;
-              var _Object$entries$_i = _slicedToArray(_Object$entries[_i], 2),
-                attachmentId = _Object$entries$_i[0],
-                attachment = _Object$entries$_i[1];
-              var deviceData = (_modelPreloader$compo = modelPreloader.componentDictionary) === null || _modelPreloader$compo === void 0 ? void 0 : _modelPreloader$compo[attachment.deviceId];
-              if (!(deviceData !== null && deviceData !== void 0 && deviceData.behaviorConfig)) return 1; // continue
-              var deviceRoot = null;
-              componentModel.traverse(function (obj) {
-                var _obj$userData2;
-                if (!deviceRoot && ((_obj$userData2 = obj.userData) === null || _obj$userData2 === void 0 ? void 0 : _obj$userData2.attachmentId) === attachmentId) deviceRoot = obj;
-              });
-              if (deviceRoot) {
-                ioBehavMgr.loadBehaviors(attachmentId, deviceData.behaviorConfig, deviceRoot, componentId);
-              }
-            };
-            for (var _i = 0, _Object$entries = Object.entries(componentData.attachedDevices); _i < _Object$entries.length; _i++) {
-              if (_loop()) continue;
+          attachIODevicesToComponent(componentModel, componentData, modelPreloader, componentId).then(function () {
+            if (ioBehavMgr) {
+              registerBehaviorsForComponent(ioBehavMgr, componentId, componentData, componentModel, modelPreloader.componentDictionary);
             }
-
-            // Register component-level behaviors (intra-component io-device linking)
-            if (componentData.behaviors && componentData.behaviors.length > 0) {
-              // Registering ${componentData.behaviors.length} component-level behavior(s)
-              ioBehavMgr.registerComponentBehaviors(componentId, componentData.behaviors);
-            }
-          }
+          }).catch(function (err) {
+            console.error("\u274C Error attaching IO devices for ".concat(libraryId, ":"), err);
+          });
         }
 
         // Notify the component manager about the new component
@@ -40024,8 +40347,8 @@ var CentralPlantInternals = /*#__PURE__*/function () {
         // the component (e.g., dynamically added but not yet synced to sceneData)
         if (connectorIds.size === 0 && threeScene) {
           threeScene.traverse(function (obj) {
-            var _obj$userData3, _obj$userData4;
-            if ((obj.uuid === resolvedUuid || ((_obj$userData3 = obj.userData) === null || _obj$userData3 === void 0 ? void 0 : _obj$userData3.originalUuid) === resolvedUuid) && ((_obj$userData4 = obj.userData) === null || _obj$userData4 === void 0 ? void 0 : _obj$userData4.objectType) === 'component') {
+            var _obj$userData2, _obj$userData3;
+            if ((obj.uuid === resolvedUuid || ((_obj$userData2 = obj.userData) === null || _obj$userData2 === void 0 ? void 0 : _obj$userData2.originalUuid) === resolvedUuid) && ((_obj$userData3 = obj.userData) === null || _obj$userData3 === void 0 ? void 0 : _obj$userData3.objectType) === 'component') {
               obj.children.forEach(function (child) {
                 var _child$userData3;
                 if (((_child$userData3 = child.userData) === null || _child$userData3 === void 0 ? void 0 : _child$userData3.objectType) === 'connector') {
@@ -40069,18 +40392,23 @@ var CentralPlantInternals = /*#__PURE__*/function () {
         // Step 5: Remove the component from the Three.js scene
         var success = componentManager.removeComponentFromScene(componentId);
         if (success) {
+          var _this$centralPlant$sc10;
+          var ioBehavMgr = (_this$centralPlant$sc10 = this.centralPlant.sceneViewer) === null || _this$centralPlant$sc10 === void 0 || (_this$centralPlant$sc10 = _this$centralPlant$sc10.managers) === null || _this$centralPlant$sc10 === void 0 ? void 0 : _this$centralPlant$sc10.ioBehaviorManager;
+          if (ioBehavMgr !== null && ioBehavMgr !== void 0 && ioBehavMgr.unloadForComponent) {
+            ioBehavMgr.unloadForComponent(resolvedUuid);
+          }
           // Step 6: Directly remove SEGMENT-* and Gateway objects from Three.js whose
           // pathFrom/pathTo references one of this component's connectors.
           // This is surgical cleanup that works regardless of shouldUpdatePaths.
           if (connectorIds.size > 0 && threeScene) {
             var objectsToRemove = [];
             threeScene.traverse(function (obj) {
-              var _obj$uuid, _obj$userData5, _obj$uuid2, _obj$userData6;
-              var isComputedSegment = ((_obj$uuid = obj.uuid) === null || _obj$uuid === void 0 ? void 0 : _obj$uuid.startsWith('SEGMENT-')) && ((_obj$userData5 = obj.userData) === null || _obj$userData5 === void 0 ? void 0 : _obj$userData5.isDeclared) !== true;
-              var isComputedGateway = ((_obj$uuid2 = obj.uuid) === null || _obj$uuid2 === void 0 ? void 0 : _obj$uuid2.includes('Gateway')) && ((_obj$userData6 = obj.userData) === null || _obj$userData6 === void 0 ? void 0 : _obj$userData6.isDeclared) !== true;
+              var _obj$uuid, _obj$userData4, _obj$uuid2, _obj$userData5;
+              var isComputedSegment = ((_obj$uuid = obj.uuid) === null || _obj$uuid === void 0 ? void 0 : _obj$uuid.startsWith('SEGMENT-')) && ((_obj$userData4 = obj.userData) === null || _obj$userData4 === void 0 ? void 0 : _obj$userData4.isDeclared) !== true;
+              var isComputedGateway = ((_obj$uuid2 = obj.uuid) === null || _obj$uuid2 === void 0 ? void 0 : _obj$uuid2.includes('Gateway')) && ((_obj$userData5 = obj.userData) === null || _obj$userData5 === void 0 ? void 0 : _obj$userData5.isDeclared) !== true;
               if (isComputedSegment || isComputedGateway) {
-                var _obj$userData7, _obj$userData8;
-                if (connectorIds.has((_obj$userData7 = obj.userData) === null || _obj$userData7 === void 0 ? void 0 : _obj$userData7.pathFrom) || connectorIds.has((_obj$userData8 = obj.userData) === null || _obj$userData8 === void 0 ? void 0 : _obj$userData8.pathTo)) {
+                var _obj$userData6, _obj$userData7;
+                if (connectorIds.has((_obj$userData6 = obj.userData) === null || _obj$userData6 === void 0 ? void 0 : _obj$userData6.pathFrom) || connectorIds.has((_obj$userData7 = obj.userData) === null || _obj$userData7 === void 0 ? void 0 : _obj$userData7.pathTo)) {
                   objectsToRemove.push(obj);
                 }
               }
@@ -40169,6 +40497,149 @@ var CentralPlantInternals = /*#__PURE__*/function () {
   }]);
 }();
 
+/**
+ * Scene-level behavior helpers: scan endpoints, register behaviors, cross-component links.
+ */
+function getComponentDictionary(centralPlant) {
+  var _centralPlant$getUtil, _centralPlant$manager;
+  return (centralPlant === null || centralPlant === void 0 || (_centralPlant$getUtil = centralPlant.getUtility) === null || _centralPlant$getUtil === void 0 || (_centralPlant$getUtil = _centralPlant$getUtil.call(centralPlant, 'modelPreloader')) === null || _centralPlant$getUtil === void 0 ? void 0 : _centralPlant$getUtil.componentDictionary) || (centralPlant === null || centralPlant === void 0 || (_centralPlant$manager = centralPlant.managers) === null || _centralPlant$manager === void 0 || (_centralPlant$manager = _centralPlant$manager.componentDataManager) === null || _centralPlant$manager === void 0 ? void 0 : _centralPlant$manager.componentDictionary) || null;
+}
+function statesFromBehaviorConfig(device) {
+  if (!(device !== null && device !== void 0 && device.behaviorConfig) || !Array.isArray(device.behaviorConfig)) return [];
+  return device.behaviorConfig.map(function (b) {
+    return b.stateVariable;
+  }).filter(Boolean).filter(function (v, i, arr) {
+    return arr.indexOf(v) === i;
+  });
+}
+function resolveStatesForDevice(ioObj, deviceId, componentDictionary) {
+  var _ioObj$userData;
+  var device = componentDictionary === null || componentDictionary === void 0 ? void 0 : componentDictionary[deviceId];
+  var fromBehaviorConfig = statesFromBehaviorConfig(device);
+  if (fromBehaviorConfig.length) return fromBehaviorConfig;
+  return (((_ioObj$userData = ioObj.userData) === null || _ioObj$userData === void 0 ? void 0 : _ioObj$userData.dataPoints) || []).map(function (dp) {
+    return dp.id || dp.name;
+  }).filter(Boolean).filter(function (v, i, arr) {
+    return arr.indexOf(v) === i;
+  });
+}
+
+/**
+ * Scan the live Three.js scene for smart-component io-device endpoints.
+ */
+function scanSceneIoEndpoints(centralPlant) {
+  var _centralPlant$sceneVi;
+  var scene = centralPlant === null || centralPlant === void 0 || (_centralPlant$sceneVi = centralPlant.sceneViewer) === null || _centralPlant$sceneVi === void 0 ? void 0 : _centralPlant$sceneVi.scene;
+  if (!scene) return [];
+  var dict = getComponentDictionary(centralPlant);
+  var endpoints = [];
+  scene.traverse(function (obj) {
+    var _obj$userData, _parent$userData, _parent$userData2;
+    if (((_obj$userData = obj.userData) === null || _obj$userData === void 0 ? void 0 : _obj$userData.objectType) !== 'io-device') return;
+    var parent = obj.parent;
+    var parentUuid = obj.userData.parentComponentId || (parent === null || parent === void 0 ? void 0 : parent.uuid) || '';
+    var parentName = (parent === null || parent === void 0 || (_parent$userData = parent.userData) === null || _parent$userData === void 0 ? void 0 : _parent$userData.hardcodedUuid) || (parent === null || parent === void 0 ? void 0 : parent.name) || parentUuid;
+    var libraryId = (parent === null || parent === void 0 || (_parent$userData2 = parent.userData) === null || _parent$userData2 === void 0 ? void 0 : _parent$userData2.libraryId) || '';
+    var attachmentId = obj.userData.attachmentId || obj.name || obj.uuid;
+    var deviceId = obj.userData.deviceId || '';
+    endpoints.push({
+      key: getScopedAttachmentKey(attachmentId, parentUuid),
+      parentUuid: parentUuid,
+      parentName: parentName,
+      libraryId: libraryId,
+      attachmentId: attachmentId,
+      attachmentLabel: obj.userData.attachmentLabel || attachmentId,
+      deviceId: deviceId,
+      states: resolveStatesForDevice(obj, deviceId, dict)
+    });
+  });
+  return endpoints;
+}
+
+/**
+ * Load cross-component behaviors from scene data mirrors.
+ */
+function loadCrossComponentBehaviors(centralPlant) {
+  var _centralPlant$importe, _centralPlant$sceneVi2;
+  return (centralPlant === null || centralPlant === void 0 || (_centralPlant$importe = centralPlant.importedSceneData) === null || _centralPlant$importe === void 0 ? void 0 : _centralPlant$importe.behaviors) || (centralPlant === null || centralPlant === void 0 || (_centralPlant$sceneVi2 = centralPlant.sceneViewer) === null || _centralPlant$sceneVi2 === void 0 || (_centralPlant$sceneVi2 = _centralPlant$sceneVi2.currentSceneData) === null || _centralPlant$sceneVi2 === void 0 ? void 0 : _centralPlant$sceneVi2.behaviors) || [];
+}
+
+/**
+ * Persist cross-component behaviors to scene data mirrors and the runtime manager.
+ */
+function applyCrossComponentBehaviors(centralPlant, behaviors) {
+  var normalized = behaviors || [];
+  if (centralPlant.importedSceneData) {
+    if (normalized.length) {
+      centralPlant.importedSceneData.behaviors = normalized;
+    } else {
+      delete centralPlant.importedSceneData.behaviors;
+    }
+  }
+  var sceneViewer = centralPlant.sceneViewer;
+  if (sceneViewer && !sceneViewer.currentSceneData) {
+    var _centralPlant$getConn;
+    sceneViewer.currentSceneData = {
+      version: '2.3',
+      connections: ((_centralPlant$getConn = centralPlant.getConnections) === null || _centralPlant$getConn === void 0 ? void 0 : _centralPlant$getConn.call(centralPlant)) || [],
+      scene: {
+        children: []
+      }
+    };
+  }
+  var currentSceneData = sceneViewer === null || sceneViewer === void 0 ? void 0 : sceneViewer.currentSceneData;
+  if (currentSceneData) {
+    if (normalized.length) {
+      currentSceneData.behaviors = normalized;
+    } else {
+      delete currentSceneData.behaviors;
+    }
+  }
+  var ioBehavMgr = getIoBehaviorManager(sceneViewer);
+  if (ioBehavMgr) {
+    ioBehavMgr.setCrossComponentBehaviors(normalized);
+  }
+}
+
+/**
+ * Re-register intra-component behaviors on all scene instances of a smart component.
+ */
+function refreshSceneIntraBehaviors(centralPlant, libraryId, behaviors) {
+  var _centralPlant$sceneVi3;
+  var ioBehavMgr = getIoBehaviorManager(centralPlant === null || centralPlant === void 0 ? void 0 : centralPlant.sceneViewer);
+  var scene = centralPlant === null || centralPlant === void 0 || (_centralPlant$sceneVi3 = centralPlant.sceneViewer) === null || _centralPlant$sceneVi3 === void 0 ? void 0 : _centralPlant$sceneVi3.scene;
+  if (!ioBehavMgr || !scene || !libraryId) return;
+  scene.traverse(function (obj) {
+    var _obj$userData2, _obj$userData3;
+    if (((_obj$userData2 = obj.userData) === null || _obj$userData2 === void 0 ? void 0 : _obj$userData2.objectType) === 'component' && ((_obj$userData3 = obj.userData) === null || _obj$userData3 === void 0 ? void 0 : _obj$userData3.libraryId) === libraryId) {
+      ioBehavMgr.registerComponentBehaviors(obj.uuid, behaviors || []);
+    }
+  });
+}
+
+/**
+ * Re-register intra- and cross-component behaviors for all instances in the live scene.
+ */
+function reregisterSceneBehaviors(centralPlant) {
+  var _centralPlant$sceneVi4;
+  var ioBehavMgr = getIoBehaviorManager(centralPlant === null || centralPlant === void 0 ? void 0 : centralPlant.sceneViewer);
+  var scene = centralPlant === null || centralPlant === void 0 || (_centralPlant$sceneVi4 = centralPlant.sceneViewer) === null || _centralPlant$sceneVi4 === void 0 ? void 0 : _centralPlant$sceneVi4.scene;
+  var dict = getComponentDictionary(centralPlant);
+  if (!ioBehavMgr || !scene) return;
+  var crossBehaviors = loadCrossComponentBehaviors(centralPlant);
+  ioBehavMgr.setCrossComponentBehaviors(crossBehaviors);
+  if (!dict) return;
+  scene.traverse(function (obj) {
+    var _obj$userData4, _obj$userData5;
+    if (((_obj$userData4 = obj.userData) === null || _obj$userData4 === void 0 ? void 0 : _obj$userData4.objectType) !== 'component') return;
+    var libraryId = (_obj$userData5 = obj.userData) === null || _obj$userData5 === void 0 ? void 0 : _obj$userData5.libraryId;
+    if (!libraryId) return;
+    var componentData = dict[libraryId];
+    if (!componentData) return;
+    registerBehaviorsForComponent(ioBehavMgr, obj.uuid, componentData, obj, dict);
+  });
+}
+
 // ─────────────────────────────────────────────────────────────────────────────
 // Flow-direction compatibility helper (module-level, no class dependency)
 // ─────────────────────────────────────────────────────────────────────────────
@@ -40195,7 +40666,7 @@ var CentralPlant = /*#__PURE__*/function (_BaseDisposable) {
    * Initialize the CentralPlant manager
    * 
    * @constructor
-   * @version 0.3.38
+   * @version 0.3.41
    * @updated 2025-10-22
    * 
    * @description Creates a new CentralPlant instance and initializes internal managers and utilities.
@@ -40369,8 +40840,7 @@ var CentralPlant = /*#__PURE__*/function (_BaseDisposable) {
     key: "setImportedSceneData",
     value: (function () {
       var _setImportedSceneData = _asyncToGenerator(/*#__PURE__*/_regenerator().m(function _callee2(sceneData) {
-        var _this$importedSceneDa, _this$importedSceneDa2, _this$importedSceneDa3, _this$sceneViewer;
-        var ioBehavMgr;
+        var _this$importedSceneDa, _this$importedSceneDa2, _this$importedSceneDa3;
         return _regenerator().w(function (_context2) {
           while (1) switch (_context2.n) {
             case 0:
@@ -40387,14 +40857,7 @@ var CentralPlant = /*#__PURE__*/function (_BaseDisposable) {
 
               // Scene behaviors loaded
 
-              // Register behaviors with IoBehaviorManager
-              ioBehavMgr = (_this$sceneViewer = this.sceneViewer) === null || _this$sceneViewer === void 0 || (_this$sceneViewer = _this$sceneViewer.managers) === null || _this$sceneViewer === void 0 ? void 0 : _this$sceneViewer.ioBehaviorManager;
-              if (ioBehavMgr) {
-                // Setting cross-component behaviors
-                ioBehavMgr.setCrossComponentBehaviors(this.importedSceneData.behaviors || []);
-              } else {
-                console.warn('[Behavior] ioBehaviorManager not available!');
-              }
+              // Cross-component behaviors are registered by sceneOperationsManager.loadSceneData()
 
               // Reset component counter based on imported components to avoid ID conflicts
               this.internals.resetComponentCounter();
@@ -40575,8 +41038,8 @@ var CentralPlant = /*#__PURE__*/function (_BaseDisposable) {
   }, {
     key: "selectObject",
     value: function selectObject(objectOrId) {
-      var _this$sceneViewer2, _object;
-      if (!((_this$sceneViewer2 = this.sceneViewer) !== null && _this$sceneViewer2 !== void 0 && _this$sceneViewer2.transformManager)) {
+      var _this$sceneViewer, _object;
+      if (!((_this$sceneViewer = this.sceneViewer) !== null && _this$sceneViewer !== void 0 && _this$sceneViewer.transformManager)) {
         console.warn('⚠️ Transform manager not initialized');
         return false;
       }
@@ -40622,8 +41085,8 @@ var CentralPlant = /*#__PURE__*/function (_BaseDisposable) {
   }, {
     key: "toggleObject",
     value: function toggleObject(objectOrId) {
-      var _this$sceneViewer3, _object2;
-      if (!((_this$sceneViewer3 = this.sceneViewer) !== null && _this$sceneViewer3 !== void 0 && _this$sceneViewer3.transformManager)) {
+      var _this$sceneViewer2, _object2;
+      if (!((_this$sceneViewer2 = this.sceneViewer) !== null && _this$sceneViewer2 !== void 0 && _this$sceneViewer2.transformManager)) {
         console.warn('⚠️ Transform manager not initialized');
         return false;
       }
@@ -40659,8 +41122,8 @@ var CentralPlant = /*#__PURE__*/function (_BaseDisposable) {
   }, {
     key: "deselectObject",
     value: function deselectObject() {
-      var _this$sceneViewer4;
-      if (!((_this$sceneViewer4 = this.sceneViewer) !== null && _this$sceneViewer4 !== void 0 && _this$sceneViewer4.transformManager)) {
+      var _this$sceneViewer3;
+      if (!((_this$sceneViewer3 = this.sceneViewer) !== null && _this$sceneViewer3 !== void 0 && _this$sceneViewer3.transformManager)) {
         console.warn('⚠️ Transform manager not initialized');
         return false;
       }
@@ -41240,68 +41703,70 @@ var CentralPlant = /*#__PURE__*/function (_BaseDisposable) {
     }
 
     /**
-     * Set the state of an I/O device instance in the Three.js scene.
-     *
-     * This is the primary public API for driving IO device state changes from
-     * external code (real-time data feeds, AI agents, automated tests, etc.).
-     * It performs three coordinated actions in order:
-     *   1. Persists the new value through the state adapter (Vuex in sandbox,
-     *      or any custom adapter injected via componentTooltipManager.configure())
-     *      so that the host application's store stays consistent.
-     *   2. Evaluates all behaviors whose input matches this (attachmentId, stateId)
-     *      pair and applies the resulting property changes to Three.js meshes.
-     *   3. Emits an 'io-device-state-changed' event on the sceneViewer so that
-     *      host applications without a Vuex store (e.g. cp3d-viewer) can react.
-     *
-     * @param {string} attachmentId - The attachment ID of the IO device (matches
-     *   the `attachmentId` stored in the Three.js object's userData)
-     * @param {string} stateId - The data-point / state ID on the device (e.g. 'power', 'level')
-     * @param {*} value - The new state value (boolean, number, string, etc.)
-     * @param {string} [parentUuid] - UUID of the parent component instance.
-     *   Required when multiple instances of the same smart component share the
-     *   same attachmentId — prevents cross-instance state bleed.
-     * @returns {boolean} True if the behavior system was reached; false if unavailable.
-     * @example
-     * // Toggle a push-button on a specific pump instance
-     * centralPlant.setIoDeviceState('pump-push-button-01', 'power', true, pumpUuid)
-     *
-     * // Drive an analog level sensor (no parentUuid needed when only one instance)
-     * centralPlant.setIoDeviceState('chiller-level-sensor-01', 'level', 0.75)
+     * Internal single path for I/O state changes: persist, animate, link, emit.
+     * @private
      */
   }, {
-    key: "setIoDeviceState",
-    value: function setIoDeviceState(attachmentId, stateId, value, parentUuid) {
-      var _this$sceneViewer5, _this$sceneViewer6, _this$sceneViewer7;
-      // 1. Persist via state adapter if one has been configured
-      var stateAdapter = (_this$sceneViewer5 = this.sceneViewer) === null || _this$sceneViewer5 === void 0 || (_this$sceneViewer5 = _this$sceneViewer5.managers) === null || _this$sceneViewer5 === void 0 || (_this$sceneViewer5 = _this$sceneViewer5.componentTooltipManager) === null || _this$sceneViewer5 === void 0 ? void 0 : _this$sceneViewer5._stateAdapter;
+    key: "_dispatchIoState",
+    value: function _dispatchIoState(attachmentId, stateId, value, parentUuid) {
+      var _this$managers, _this$sceneViewer4, _this$sceneViewer5, _this$managers2, _this$sceneViewer6, _this$sceneViewer7, _this$sceneViewer8;
+      var tooltipMgr = ((_this$managers = this.managers) === null || _this$managers === void 0 ? void 0 : _this$managers.componentTooltipManager) || ((_this$sceneViewer4 = this.sceneViewer) === null || _this$sceneViewer4 === void 0 ? void 0 : _this$sceneViewer4.componentTooltipManager) || ((_this$sceneViewer5 = this.sceneViewer) === null || _this$sceneViewer5 === void 0 || (_this$sceneViewer5 = _this$sceneViewer5.managers) === null || _this$sceneViewer5 === void 0 ? void 0 : _this$sceneViewer5.componentTooltipManager);
+      var stateAdapter = tooltipMgr === null || tooltipMgr === void 0 ? void 0 : tooltipMgr._stateAdapter;
       if (stateAdapter !== null && stateAdapter !== void 0 && stateAdapter.setState) {
-        var scopedKey = parentUuid ? "".concat(parentUuid, "::").concat(attachmentId) : attachmentId;
+        var scopedKey = getScopedAttachmentKey(attachmentId, parentUuid);
         try {
           stateAdapter.setState(scopedKey, stateId, value);
         } catch (err) {
-          console.warn('⚠️ setIoDeviceState(): stateAdapter.setState() threw:', err);
+          console.warn('⚠️ _dispatchIoState(): stateAdapter.setState() threw:', err);
         }
       }
-
-      // 2. Apply io-behavior changes
-      var ioBehavMgr = (_this$sceneViewer6 = this.sceneViewer) === null || _this$sceneViewer6 === void 0 || (_this$sceneViewer6 = _this$sceneViewer6.managers) === null || _this$sceneViewer6 === void 0 ? void 0 : _this$sceneViewer6.ioBehaviorManager;
+      var ioBehavMgr = ((_this$managers2 = this.managers) === null || _this$managers2 === void 0 ? void 0 : _this$managers2.ioBehaviorManager) || ((_this$sceneViewer6 = this.sceneViewer) === null || _this$sceneViewer6 === void 0 || (_this$sceneViewer6 = _this$sceneViewer6.managers) === null || _this$sceneViewer6 === void 0 ? void 0 : _this$sceneViewer6.ioBehaviorManager) || ((_this$sceneViewer7 = this.sceneViewer) === null || _this$sceneViewer7 === void 0 ? void 0 : _this$sceneViewer7.ioBehaviorManager);
       if (ioBehavMgr) {
-        var _this$importedSceneDa4;
         ioBehavMgr.triggerState(attachmentId, stateId, value, parentUuid);
-
-        // Evaluate cross-component behaviors if they exist in the imported scene
-        if ((_this$importedSceneDa4 = this.importedSceneData) !== null && _this$importedSceneDa4 !== void 0 && _this$importedSceneDa4.behaviors) {
-          ioBehavMgr.triggerCrossComponentBehaviors(this.importedSceneData.behaviors, parentUuid, attachmentId, stateId, value);
-        }
       }
-
-      // 3. Emit event for host apps that don't use the state adapter (e.g. cp3d-viewer)
-      (_this$sceneViewer7 = this.sceneViewer) === null || _this$sceneViewer7 === void 0 || _this$sceneViewer7.emit('io-device-state-changed', {
+      (_this$sceneViewer8 = this.sceneViewer) === null || _this$sceneViewer8 === void 0 || _this$sceneViewer8.emit('io-device-state-changed', {
         attachmentId: attachmentId,
         stateId: stateId,
         value: value,
         parentUuid: parentUuid || null
       });
+    }
+
+    /**
+     * Configure the state adapter on both tooltip and behavior managers.
+     * @param {{ getState: Function, setState: Function }} stateAdapter
+     */
+  }, {
+    key: "configureStateAdapter",
+    value: function configureStateAdapter(stateAdapter) {
+      var _this$managers3, _this$sceneViewer9, _this$managers4, _this$sceneViewer1, _this$sceneViewer10;
+      var tooltipMgr = ((_this$managers3 = this.managers) === null || _this$managers3 === void 0 ? void 0 : _this$managers3.componentTooltipManager) || ((_this$sceneViewer9 = this.sceneViewer) === null || _this$sceneViewer9 === void 0 ? void 0 : _this$sceneViewer9.componentTooltipManager);
+      if (tooltipMgr !== null && tooltipMgr !== void 0 && tooltipMgr.configure) {
+        var _this$sceneViewer0;
+        tooltipMgr.configure(stateAdapter);
+        if ((_this$sceneViewer0 = this.sceneViewer) !== null && _this$sceneViewer0 !== void 0 && _this$sceneViewer0.managers) {
+          this.sceneViewer.managers.componentTooltipManager = tooltipMgr;
+        }
+      }
+      var ioBehavMgr = ((_this$managers4 = this.managers) === null || _this$managers4 === void 0 ? void 0 : _this$managers4.ioBehaviorManager) || ((_this$sceneViewer1 = this.sceneViewer) === null || _this$sceneViewer1 === void 0 || (_this$sceneViewer1 = _this$sceneViewer1.managers) === null || _this$sceneViewer1 === void 0 ? void 0 : _this$sceneViewer1.ioBehaviorManager) || ((_this$sceneViewer10 = this.sceneViewer) === null || _this$sceneViewer10 === void 0 ? void 0 : _this$sceneViewer10.ioBehaviorManager);
+      if (ioBehavMgr !== null && ioBehavMgr !== void 0 && ioBehavMgr.configure) {
+        ioBehavMgr.configure(stateAdapter);
+      }
+    }
+
+    /**
+     * Set the state of an I/O device instance in the Three.js scene.
+     *
+     * @param {string} attachmentId - IO device attachment ID
+     * @param {string} stateId - Data-point / state ID (e.g. 'power', 'level')
+     * @param {*} value - New state value
+     * @param {string} [parentUuid] - Parent component instance UUID
+     * @returns {boolean}
+     */
+  }, {
+    key: "setIoDeviceState",
+    value: function setIoDeviceState(attachmentId, stateId, value, parentUuid) {
+      this._dispatchIoState(attachmentId, stateId, value, parentUuid);
       return true;
     }
 
@@ -41318,8 +41783,8 @@ var CentralPlant = /*#__PURE__*/function (_BaseDisposable) {
   }, {
     key: "getSceneAttachments",
     value: function getSceneAttachments() {
-      var _this$sceneViewer8;
-      var scene = (_this$sceneViewer8 = this.sceneViewer) === null || _this$sceneViewer8 === void 0 ? void 0 : _this$sceneViewer8.scene;
+      var _this$sceneViewer11;
+      var scene = (_this$sceneViewer11 = this.sceneViewer) === null || _this$sceneViewer11 === void 0 ? void 0 : _this$sceneViewer11.scene;
       if (!scene) return [];
       var results = [];
       scene.traverse(function (obj) {
@@ -42027,6 +42492,58 @@ var CentralPlant = /*#__PURE__*/function (_BaseDisposable) {
       }
       return extendComponentDictionary;
     }()
+    /**
+     * Merge mesh animation configs into the component dictionary.
+     * @param {Object<string, { behaviorConfig?: Array, meshNameMap?: Object }>} configsByAssetId
+     * @returns {number} Count of dictionary entries updated
+     */
+    )
+  }, {
+    key: "mergeBehaviorConfigsIntoDictionary",
+    value: function mergeBehaviorConfigsIntoDictionary(configsByAssetId) {
+      if (!this.managers.componentDataManager) {
+        console.warn('⚠️ mergeBehaviorConfigsIntoDictionary(): Component data manager not available');
+        return 0;
+      }
+      return this.managers.componentDataManager.mergeBehaviorConfigsIntoDictionary(configsByAssetId);
+    }
+
+    /**
+     * Scan live scene for I/O device endpoints (for behavior authoring UIs).
+     */
+  }, {
+    key: "scanSceneIoEndpoints",
+    value: function scanSceneIoEndpoints$1() {
+      return scanSceneIoEndpoints(this);
+    }
+
+    /**
+     * Apply cross-component behaviors to scene data and the runtime manager.
+     */
+  }, {
+    key: "setSceneBehaviors",
+    value: function setSceneBehaviors(behaviors) {
+      applyCrossComponentBehaviors(this, behaviors);
+    }
+
+    /**
+     * Read cross-component behaviors from the current scene data mirrors.
+     */
+  }, {
+    key: "getSceneBehaviors",
+    value: function getSceneBehaviors() {
+      return loadCrossComponentBehaviors(this);
+    }
+
+    /**
+     * Re-register all intra- and cross-component behaviors on placed instances.
+     */
+  }, {
+    key: "reregisterSceneBehaviors",
+    value: function reregisterSceneBehaviors$1() {
+      reregisterSceneBehaviors(this);
+    }
+
     /**
      * Remove S3 components from component dictionary
      * @returns {Promise<boolean>} True if components were removed successfully, false otherwise
@@ -42039,7 +42556,6 @@ var CentralPlant = /*#__PURE__*/function (_BaseDisposable) {
      *   console.log('S3 components removed');
      * }
      */
-    )
   }, {
     key: "removeS3Components",
     value: (function () {
@@ -42946,9 +43462,9 @@ var CentralPlant = /*#__PURE__*/function (_BaseDisposable) {
   }, {
     key: "clearScene",
     value: function clearScene() {
-      var _this$sceneViewer9;
+      var _this$sceneViewer12;
       this.importedSceneData = null;
-      var ioBehavMgr = (_this$sceneViewer9 = this.sceneViewer) === null || _this$sceneViewer9 === void 0 || (_this$sceneViewer9 = _this$sceneViewer9.managers) === null || _this$sceneViewer9 === void 0 ? void 0 : _this$sceneViewer9.ioBehaviorManager;
+      var ioBehavMgr = (_this$sceneViewer12 = this.sceneViewer) === null || _this$sceneViewer12 === void 0 || (_this$sceneViewer12 = _this$sceneViewer12.managers) === null || _this$sceneViewer12 === void 0 ? void 0 : _this$sceneViewer12.ioBehaviorManager;
       if (ioBehavMgr) {
         ioBehavMgr.setCrossComponentBehaviors([]);
       }
@@ -48827,6 +49343,11 @@ exports.SceneOperationsManager = SceneOperationsManager;
 exports.SceneTooltipsManager = SceneTooltipsManager;
 exports.SnapshotManager = SnapshotManager;
 exports.ThreeJSResourceManager = ThreeJSResourceManager;
+exports.applyCrossComponentBehaviors = applyCrossComponentBehaviors;
+exports.applyModelRootTranslation = applyModelRootTranslation;
+exports.applyModelRootTranslationFromWorldBase = applyModelRootTranslationFromWorldBase;
+exports.buildCrossBehavior = buildCrossBehavior;
+exports.buildIntraBehavior = buildIntraBehavior;
 exports.cacheJsonData = cacheJsonData;
 exports.cacheManager = cacheManager;
 exports.cleanExpiredCache = cleanExpiredCache;
@@ -48852,8 +49373,10 @@ exports.getCurrentCacheName = getCurrentCacheName;
 exports.getGlobalCacheStats = getGlobalCacheStats;
 exports.getGlobalOnlyCacheStats = getGlobalOnlyCacheStats;
 exports.getHardcodedUuid = getHardcodedUuid;
+exports.getIoBehaviorManager = getIoBehaviorManager;
 exports.getObjectTypeName = getObjectTypeName;
 exports.getObjectsByType = getObjectsByType;
+exports.getScopedAttachmentKey = getScopedAttachmentKey;
 exports.getThumbnailKey = getThumbnailKey;
 exports.getUserOnlyCacheStats = getUserOnlyCacheStats;
 exports.isCached = isCached;
@@ -48865,17 +49388,28 @@ exports.isExportable = isExportable;
 exports.isGateway = isGateway;
 exports.isSegment = isSegment;
 exports.isThumbnailCached = isThumbnailCached;
+exports.loadCrossComponentBehaviors = loadCrossComponentBehaviors;
 exports.loadTextureSetAndCreateMaterial = loadTextureSetAndCreateMaterial;
 exports.markAsComputed = markAsComputed;
 exports.markAsDeclared = markAsDeclared;
 exports.measureS3Transfer = measureS3Transfer;
+exports.modelOffsetToWorldDelta = modelOffsetToWorldDelta;
 exports.modelPreloader = modelPreloader;
+exports.normalizeBehavior = normalizeBehavior;
+exports.parseCrossBehavior = parseCrossBehavior;
+exports.parseIntraBehavior = parseIntraBehavior;
 exports.preloadLocalFiles = preloadLocalFiles;
 exports.preloadS3Objects = preloadS3Objects;
+exports.refreshSceneIntraBehaviors = refreshSceneIntraBehaviors;
+exports.registerBehaviorsForComponent = registerBehaviorsForComponent;
+exports.reloadBehaviorsForDeviceAsset = reloadBehaviorsForDeviceAsset;
 exports.removeCachedJsonData = removeCachedJsonData;
+exports.reregisterSceneBehaviors = reregisterSceneBehaviors;
 exports.resetCacheIdentity = resetCacheIdentity;
 exports.resetGlobalCacheStats = resetGlobalCacheStats;
+exports.resolveDataPoints = resolveDataPoints;
 exports.s3MetadataCache = s3MetadataCache;
+exports.scanSceneIoEndpoints = scanSceneIoEndpoints;
 exports.sceneViewer = sceneViewer;
 exports.shouldRemoveOnRegeneration = shouldRemoveOnRegeneration;
 exports.switchCachePartition = switchCachePartition;