@2112-lab/central-plant 0.3.38 → 0.3.39

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

@@ -1,6 +1,7 @@
-import { createClass as _createClass, objectSpread2 as _objectSpread2, toConsumableArray as _toConsumableArray, typeof as _typeof, classCallCheck as _classCallCheck, asyncToGenerator as _asyncToGenerator, regenerator as _regenerator, regeneratorValues as _regeneratorValues, slicedToArray as _slicedToArray, createForOfIteratorHelper as _createForOfIteratorHelper } from '../../../_virtual/_rollupPluginBabelHelpers.js';
+import { createClass as _createClass, objectSpread2 as _objectSpread2, toConsumableArray as _toConsumableArray, typeof as _typeof, classCallCheck as _classCallCheck, asyncToGenerator as _asyncToGenerator, regenerator as _regenerator, createForOfIteratorHelper as _createForOfIteratorHelper } from '../../../_virtual/_rollupPluginBabelHelpers.js';
 import * as THREE from 'three';
 import { attachIODevicesToComponent } from '../../utils/ioDeviceUtils.js';
+import { registerBehaviorsForComponent } from '../../utils/behaviorRegistration.js';
 import modelPreloader from '../../rendering/modelPreloader.js';
 import { computeFilteredBoundingBox, computeFilteredBoundingBoxCached } from '../../utils/boundingBoxUtils.js';
 import { cacheBasePosition } from './viewport2DManager.js';
@@ -53,12 +54,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
@@ -71,16 +72,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
@@ -90,70 +91,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);
 
@@ -171,14 +119,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);
@@ -257,84 +205,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]]);
       }));
@@ -441,8 +389,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();
@@ -450,23 +398,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]]);
       }));
@@ -484,11 +432,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:', {
@@ -497,7 +445,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..."));
@@ -519,10 +467,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);
 
@@ -553,7 +501,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);
@@ -561,41 +509,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]]);
       }));
@@ -614,14 +562,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..."));
@@ -641,7 +589,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"));
@@ -684,7 +632,7 @@ var ModelManager = /*#__PURE__*/function () {
                 }));
               }
             case 3:
-              return _context6.a(2);
+              return _context5.a(2);
           }
         }, _callee5);
       }));
@@ -719,26 +667,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]]);
       }));

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

@@ -90,10 +90,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:
@@ -459,9 +464,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()

package/dist/esm/src/utils/animationTransformUtils.js

@@ -0,0 +1,41 @@
+import * as THREE from 'three';
+
+/**
+ * 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.Vector3 ? offset.clone() : new THREE.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.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.Vector3();
+  mesh.getWorldPosition(origWorldPos);
+  var newWorldPos = origWorldPos.add(modelOffsetToWorldDelta(modelRoot, modelOffset));
+  if (mesh.parent) mesh.parent.worldToLocal(newWorldPos);
+  mesh.position.copy(newWorldPos);
+}
+
+export { applyModelRootTranslation, modelOffsetToWorldDelta };

package/dist/esm/src/utils/behaviorDispatch.js

@@ -0,0 +1,56 @@
+/**
+ * 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;
+  });
+}
+
+export { getIoBehaviorManager, getScopedAttachmentKey, resolveDataPoints };