@2112-lab/central-plant 0.3.28 → 0.3.30

package/dist/bundle/index.js

@@ -4171,6 +4171,7 @@ var TransformControlsManager = /*#__PURE__*/function () {
         raycaster.setFromCamera(mouse, _this4.camera);
         var allIntersects = raycaster.intersectObjects(_this4.scene.children, true);
         var ioDeviceObject = null;
+        var hitMesh = null;
         var _iterator = _createForOfIteratorHelper(allIntersects),
           _step;
         try {
@@ -4185,7 +4186,10 @@ var TransformControlsManager = /*#__PURE__*/function () {
               }
               obj = obj.parent;
             }
-            if (ioDeviceObject) break;
+            if (ioDeviceObject) {
+              hitMesh = hit.object;
+              break;
+            }
           }
         } catch (err) {
           _iterator.e(err);
@@ -4200,7 +4204,7 @@ var TransformControlsManager = /*#__PURE__*/function () {
         _this4._ioDragStartY = event.clientY;
         _this4._ioDragMoved = false;
         if (_this4.orbitControls) _this4.orbitControls.enabled = false;
-        _this4.callbacks.onIODeviceDrag(ioDeviceObject, 0, true);
+        _this4.callbacks.onIODeviceDrag(ioDeviceObject, 0, true, hitMesh);
         var onMove = function onMove(e) {
           var dx = e.clientX - _this4._ioDragStartX;
           var dy = e.clientY - _this4._ioDragStartY;
@@ -31309,7 +31313,7 @@ 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, ioAnimMgr, _loop, _i, _Object$entries, warmFn, _jsonEntry$userData4, _t;
+        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) {
             case 0:
@@ -31352,22 +31356,22 @@ var ModelManager = /*#__PURE__*/function () {
               _context2.n = 4;
               return attachIODevicesToComponent(libraryModel, componentData, modelPreloader, originalProps.uuid);
             case 4:
-              // Register animation configs for each attached device
-              ioAnimMgr = (_this$sceneViewer = this.sceneViewer) === null || _this$sceneViewer === void 0 || (_this$sceneViewer = _this$sceneViewer.managers) === null || _this$sceneViewer === void 0 ? void 0 : _this$sceneViewer.ioAnimationManager;
-              if (!ioAnimMgr) {
+              // 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 = 8;
                 break;
               }
               _loop = /*#__PURE__*/_regenerator().m(function _loop() {
-                var _modelPreloader$compo, _deviceData$animation;
+                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 animationConfig:"), (_deviceData$animation = deviceData === null || deviceData === void 0 ? void 0 : deviceData.animationConfig) !== null && _deviceData$animation !== void 0 ? _deviceData$animation : 'NONE');
-                      if (deviceData !== null && deviceData !== void 0 && deviceData.animationConfig) {
+                      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;
                       }
@@ -31379,7 +31383,7 @@ var ModelManager = /*#__PURE__*/function () {
                         if (!deviceRoot && ((_obj$userData = obj.userData) === null || _obj$userData === void 0 ? void 0 : _obj$userData.attachmentId) === attachmentId) deviceRoot = obj;
                       });
                       if (deviceRoot) {
-                        ioAnimMgr.loadAnimations(attachmentId, deviceData.animationConfig, deviceRoot, originalProps.uuid);
+                        ioBehavMgr.loadBehaviors(attachmentId, deviceData.behaviorConfig, deviceRoot, originalProps.uuid);
                       }
                     case 2:
                       return _context.a(2);
@@ -36654,7 +36658,7 @@ var ComponentTooltipManager = /*#__PURE__*/function (_BaseDisposable) {
       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.ioAnimationManager) === null || _this$sceneViewer === void 0 || _this$sceneViewer.triggerState(attachmentId, dpId, newVal, parentUuid);
+      (_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);
       console.log("\uD83D\uDD04 [IODevice] Toggled ".concat(scopedAttachmentId, ".").concat(dpId, ": ").concat(currentVal, " \u2192 ").concat(newVal));
     }
 
@@ -36669,7 +36673,7 @@ var ComponentTooltipManager = /*#__PURE__*/function (_BaseDisposable) {
      */
   }, {
     key: "startIODeviceDrag",
-    value: function startIODeviceDrag(ioDeviceObject) {
+    value: function startIODeviceDrag(ioDeviceObject, hitMesh) {
       var _this$sceneViewer2,
         _this2 = this;
       if (!ioDeviceObject || !this._stateAdapter) return;
@@ -36687,8 +36691,8 @@ var ComponentTooltipManager = /*#__PURE__*/function (_BaseDisposable) {
         obj = obj.parent;
       }
       var scopedAttachmentId = this._getScopedAttachmentKey(attachmentId, parentUuid);
-      var ioAnimMgr = (_this$sceneViewer2 = this.sceneViewer) === null || _this$sceneViewer2 === void 0 || (_this$sceneViewer2 = _this$sceneViewer2.managers) === null || _this$sceneViewer2 === void 0 ? void 0 : _this$sceneViewer2.ioAnimationManager;
-      var dataPoints = ((ioAnimMgr === null || ioAnimMgr === void 0 ? void 0 : ioAnimMgr.getAnimationDataPoints(parentUuid, attachmentId)) || []).concat((ud === null || ud === void 0 ? void 0 : ud.dataPoints) || [])
+      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) {
@@ -36817,7 +36821,7 @@ var ComponentTooltipManager = /*#__PURE__*/function (_BaseDisposable) {
         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.ioAnimationManager) === null || _this$sceneViewer3 === void 0 || _this$sceneViewer3.triggerState(attachmentId, dpId, newVal, parentUuid);
+      (_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);
     }
 
     /**
@@ -36942,11 +36946,11 @@ var ComponentTooltipManager = /*#__PURE__*/function (_BaseDisposable) {
           var _this3$sceneViewer$ma, _this3$sceneViewer;
           var attachmentId = child.userData.attachmentId || '';
 
-          // Use only data points from the animate window (animationConfig).
+          // 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.ioAnimationManager) === null || _this3$sceneViewer === void 0 ? void 0 : _this3$sceneViewer.getAnimationDataPoints(parentUuid, attachmentId)) !== null && _this3$sceneViewer$ma !== void 0 ? _this3$sceneViewer$ma : [];
+          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 : [];
 
-          // When data points come from animationConfig they already carry direction:'input'.
+          // When data points come from behaviorConfig they already carry direction:'input'.
           // Pass null so _buildDataPointRow uses the per-dp direction instead of the
           // device-level ioDirection (which may be 'output' and would hide controls).
           var deviceDirection = dataPoints.length > 0 ? null : child.userData.ioDirection || 'output';
@@ -37185,7 +37189,7 @@ var ComponentTooltipManager = /*#__PURE__*/function (_BaseDisposable) {
           var _this5$_stateAdapter, _this5$selectedObject, _this5$sceneViewer;
           (_this5$_stateAdapter = _this5._stateAdapter) === null || _this5$_stateAdapter === void 0 || _this5$_stateAdapter.setState(scopedAttachmentId, dpId, newVal);
           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.ioAnimationManager) === null || _this5$sceneViewer === void 0 || _this5$sceneViewer.triggerState(originalAttachmentId || scopedAttachmentId, dpId, newVal, parentUuid);
+          (_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);
         });
         row.appendChild(ctrl);
         this._stateElements.set(key, {
@@ -37357,11 +37361,11 @@ var ComponentTooltipManager = /*#__PURE__*/function (_BaseDisposable) {
   }]);
 }(BaseDisposable);
 
-var IoAnimationManager = /*#__PURE__*/function (_BaseDisposable) {
-  function IoAnimationManager(sceneViewer) {
+var IoBehaviorManager = /*#__PURE__*/function (_BaseDisposable) {
+  function IoBehaviorManager(sceneViewer) {
     var _this;
-    _classCallCheck(this, IoAnimationManager);
-    _this = _callSuper(this, IoAnimationManager);
+    _classCallCheck(this, IoBehaviorManager);
+    _this = _callSuper(this, IoBehaviorManager);
     _this.sceneViewer = sceneViewer;
 
     /**
@@ -37386,21 +37390,34 @@ var IoAnimationManager = /*#__PURE__*/function (_BaseDisposable) {
    * so that mesh references are live.
    *
    * @param {string} attachmentId - The attachment key (e.g. 'attch-switch-01')
-   * @param {Object|Array} animationConfig - Serialized config; either the full object
-   *   { animations: [...] } or a plain array of animation entries.
+   * @param {Object|Array} behaviorConfig - Serialized config; either the full object
+   *   { behaviors: [...] } or a plain array of behavior entries.
    * @param {THREE.Object3D} deviceModelRoot - The device's root Object3D as added to the scene
    * @param {string} parentUuid - UUID of the host component Object3D
    */
-  _inherits(IoAnimationManager, _BaseDisposable);
-  return _createClass(IoAnimationManager, [{
-    key: "loadAnimations",
-    value: function loadAnimations(attachmentId, animationConfig, deviceModelRoot, parentUuid) {
-      var _animationConfig$anim;
-      if (!animationConfig || !deviceModelRoot) return;
-      var anims = Array.isArray(animationConfig) ? animationConfig : (_animationConfig$anim = animationConfig.animations) !== null && _animationConfig$anim !== void 0 ? _animationConfig$anim : [];
+  _inherits(IoBehaviorManager, _BaseDisposable);
+  return _createClass(IoBehaviorManager, [{
+    key: "loadBehaviors",
+    value: function loadBehaviors(attachmentId, behaviorConfig, deviceModelRoot, parentUuid) {
+      var _behaviorConfig$behav;
+      if (!behaviorConfig || !deviceModelRoot) return;
+      var anims = Array.isArray(behaviorConfig) ? behaviorConfig : (_behaviorConfig$behav = behaviorConfig.behaviors) !== null && _behaviorConfig$behav !== void 0 ? _behaviorConfig$behav : [];
       if (!anims.length) return;
       var key = this._key(parentUuid, attachmentId);
       var entries = [];
+
+      // Capture the device root's world orientation once so each entry can
+      // convert the configured axis from device-local space to world space.
+      var deviceWorldQuat = new THREE__namespace.Quaternion();
+      deviceModelRoot.getWorldQuaternion(deviceWorldQuat);
+
+      // Compute the model's native max dimension so rotAxisOffset values (stored
+      // in dialog-viewer-world units, where the model is normalised to 1 unit)
+      // can be scaled to runtime-world units.  viewerMaxDim = 1 / ns_viewer.
+      var _deviceBox = new THREE__namespace.Box3().setFromObject(deviceModelRoot);
+      var _deviceSize = new THREE__namespace.Vector3();
+      _deviceBox.getSize(_deviceSize);
+      var viewerMaxDim = Math.max(_deviceSize.x, _deviceSize.y, _deviceSize.z) || 1;
       var _iterator = _createForOfIteratorHelper(anims),
         _step;
       try {
@@ -37408,14 +37425,26 @@ var IoAnimationManager = /*#__PURE__*/function (_BaseDisposable) {
           var anim = _step.value;
           var mesh = this._resolveMesh(anim, deviceModelRoot);
           if (!mesh) {
-            console.warn("[IoAnimationManager] Could not find mesh for animation \"".concat(anim.name || anim.stateVariable, "\" (uuid: ").concat(anim.meshUuid, ", name: \"").concat(anim.meshName, "\")"));
+            console.warn("[IoBehaviorManager] Could not find mesh for animation \"".concat(anim.name || anim.stateVariable, "\" (uuid: ").concat(anim.meshUuid, ", name: \"").concat(anim.meshName, "\")"));
             continue;
           }
+          var worldPos = new THREE__namespace.Vector3();
+          mesh.getWorldPosition(worldPos);
+          var worldQuat = new THREE__namespace.Quaternion();
+          mesh.getWorldQuaternion(worldQuat);
+          var box = new THREE__namespace.Box3().setFromObject(mesh);
+          var worldCenter = new THREE__namespace.Vector3();
+          if (!box.isEmpty()) box.getCenter(worldCenter);else worldCenter.copy(worldPos);
           entries.push({
             anim: anim,
             mesh: mesh,
             origPos: mesh.position.clone(),
-            origRot: mesh.rotation.clone()
+            origRot: mesh.rotation.clone(),
+            origWorldPos: worldPos,
+            origWorldQuat: worldQuat,
+            origWorldCenter: worldCenter,
+            deviceWorldQuat: deviceWorldQuat.clone(),
+            viewerMaxDim: viewerMaxDim
           });
         }
       } catch (err) {
@@ -37425,11 +37454,11 @@ var IoAnimationManager = /*#__PURE__*/function (_BaseDisposable) {
       }
       if (entries.length) {
         this._entries.set(key, entries);
-        console.log("[IoAnimationManager] Loaded ".concat(entries.length, " animation(s) for attachment \"").concat(attachmentId, "\" (parent: ").concat(parentUuid, ") \u2014 stateVariables: ").concat(entries.map(function (e) {
+        console.log("[IoBehaviorManager] Loaded ".concat(entries.length, " animation(s) for attachment \"").concat(attachmentId, "\" (parent: ").concat(parentUuid, ") \u2014 stateVariables: ").concat(entries.map(function (e) {
           return e.anim.stateVariable;
         }).join(', ')));
       } else {
-        console.warn("[IoAnimationManager] No mesh entries resolved for attachment \"".concat(attachmentId, "\" \u2014 animationConfig had ").concat(anims.length, " entries but none matched a mesh"));
+        console.warn("[IoBehaviorManager] No mesh entries resolved for attachment \"".concat(attachmentId, "\" \u2014 behaviorConfig had ").concat(anims.length, " entries but none matched a mesh"));
       }
     }
 
@@ -37489,13 +37518,26 @@ var IoAnimationManager = /*#__PURE__*/function (_BaseDisposable) {
   }, {
     key: "getAnimationDataPoints",
     value: function getAnimationDataPoints(parentUuid, attachmentId) {
+      var _this2 = this;
+      var hitMesh = arguments.length > 2 && arguments[2] !== undefined ? arguments[2] : null;
       var key = this._key(parentUuid, attachmentId);
       var entries = this._entries.get(key);
       if (!(entries !== null && entries !== void 0 && entries.length)) return [];
 
+      // When a specific mesh was clicked, filter to only animations whose target
+      // mesh is the clicked mesh or an ancestor of it (e.g. the clicked primitive
+      // is inside a group that is the animation target).
+      var filtered = entries;
+      if (hitMesh) {
+        var matching = entries.filter(function (e) {
+          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 _iterator3 = _createForOfIteratorHelper(entries),
+      var _iterator3 = _createForOfIteratorHelper(filtered),
         _step3;
       try {
         for (_iterator3.s(); !(_step3 = _iterator3.n()).done;) {
@@ -37623,7 +37665,7 @@ var IoAnimationManager = /*#__PURE__*/function (_BaseDisposable) {
     key: "dispose",
     value: function dispose() {
       this._entries.clear();
-      _superPropGet(IoAnimationManager, "dispose", this, 3)([]);
+      _superPropGet(IoBehaviorManager, "dispose", this, 3)([]);
     }
 
     // ─────────────────────────────────────────────────────────────────────────
@@ -37635,6 +37677,22 @@ var IoAnimationManager = /*#__PURE__*/function (_BaseDisposable) {
       return "".concat(parentUuid, "::").concat(attachmentId);
     }
 
+    /**
+     * Returns true if `candidate` is `ancestor` or any descendant of `ancestor`.
+     * @param {THREE.Object3D} candidate
+     * @param {THREE.Object3D} ancestor
+     */
+  }, {
+    key: "_isMeshOrDescendant",
+    value: function _isMeshOrDescendant(candidate, ancestor) {
+      var obj = candidate;
+      while (obj) {
+        if (obj === ancestor) return true;
+        obj = obj.parent;
+      }
+      return false;
+    }
+
     /**
      * Find the mesh inside `root` using UUID first, then name as fallback.
      * GLTFLoader assigns fresh UUIDs on every load, so name is the reliable key.
@@ -37675,7 +37733,12 @@ var IoAnimationManager = /*#__PURE__*/function (_BaseDisposable) {
       var anim = entry.anim,
         mesh = entry.mesh,
         origPos = entry.origPos,
-        origRot = entry.origRot;
+        origRot = entry.origRot,
+        origWorldPos = entry.origWorldPos,
+        origWorldQuat = entry.origWorldQuat,
+        origWorldCenter = entry.origWorldCenter,
+        deviceWorldQuat = entry.deviceWorldQuat,
+        viewerMaxDim = entry.viewerMaxDim;
       var mapping = this._resolveMapping(anim, value);
       if (!mapping) return;
       var types = anim.transformTypes || [];
@@ -37687,7 +37750,7 @@ var IoAnimationManager = /*#__PURE__*/function (_BaseDisposable) {
           if (type === 'translation') {
             this._applyTranslation(mesh, origPos, mapping.transform);
           } else if (type === 'rotation') {
-            this._applyRotation(mesh, origPos, origRot, anim, mapping.rotationTransform);
+            this._applyRotation(mesh, origPos, origRot, anim, mapping.rotationTransform, origWorldPos, origWorldQuat, origWorldCenter, deviceWorldQuat, viewerMaxDim);
           } else if (type === 'color') {
             this._applyColor(mesh, mapping.colorTransform);
           }
@@ -37832,26 +37895,24 @@ var IoAnimationManager = /*#__PURE__*/function (_BaseDisposable) {
     }
 
     /**
-     * Apply a rotation around an arbitrary pivot point in device-local space,
-     * optionally also displacing the mesh position to simulate orbital motion.
-     *
-     * Math (all in device-local space):
-     *   pivot   = rotAxisOffset
-     *   delta   = origPos - pivot
-     *   newDelta = rotate(delta, angle, axis)
-     *   newPos  = pivot + newDelta
-     *   newRot[axis] = origRot[axis] + angle
+     * Apply a rotation around an arbitrary pivot point using world-space quaternion
+     * math matching the ReconstructionViewer's setMeshPreviewRotationAxis approach.
+     * This ensures the runtime axis/pivot matches what the user configured in the
+     * animation dialog, regardless of the device's parent transform in the scene.
      *
      * @param {THREE.Object3D} mesh
-     * @param {THREE.Vector3}  origPos
-     * @param {THREE.Euler}    origRot
+     * @param {THREE.Vector3}  origPos        - local position at load time (unused, kept for signature compat)
+     * @param {THREE.Euler}    origRot        - local rotation at load time (unused)
      * @param {Object}         anim
-     * @param {number}         angleDeg - Degrees
+     * @param {number}         angleDeg       - Degrees
+     * @param {THREE.Vector3}  origWorldPos   - world position at load time
+     * @param {THREE.Quaternion} origWorldQuat - world quaternion at load time
+     * @param {THREE.Vector3}  origWorldCenter - world bounding-box center at load time
      */
   }, {
     key: "_applyRotation",
-    value: function _applyRotation(mesh, origPos, origRot, anim, angleDeg) {
-      var _anim$rotAxis, _anim$rotAxisOffset, _off$x, _off$y, _off$z;
+    value: function _applyRotation(mesh, origPos, origRot, anim, angleDeg, origWorldPos, origWorldQuat, origWorldCenter, deviceWorldQuat, viewerMaxDim) {
+      var _anim$rotAxis, _anim$rotAxisOffset;
       var angle = THREE__namespace.MathUtils.degToRad(typeof angleDeg === 'number' ? angleDeg : 0);
       var axis = ((_anim$rotAxis = anim.rotAxis) !== null && _anim$rotAxis !== void 0 ? _anim$rotAxis : 'x').toLowerCase();
       var off = (_anim$rotAxisOffset = anim.rotAxisOffset) !== null && _anim$rotAxisOffset !== void 0 ? _anim$rotAxisOffset : {
@@ -37860,13 +37921,57 @@ var IoAnimationManager = /*#__PURE__*/function (_BaseDisposable) {
         z: 0
       };
 
-      // Unit vector for the chosen axis
-      var axisVec = new THREE__namespace.Vector3(axis === 'x' ? 1 : 0, axis === 'y' ? 1 : 0, axis === 'z' ? 1 : 0);
-      var pivot = new THREE__namespace.Vector3((_off$x = off.x) !== null && _off$x !== void 0 ? _off$x : 0, (_off$y = off.y) !== null && _off$y !== void 0 ? _off$y : 0, (_off$z = off.z) !== null && _off$z !== void 0 ? _off$z : 0);
-      var delta = origPos.clone().sub(pivot);
-      delta.applyAxisAngle(axisVec, angle);
-      mesh.position.copy(pivot).add(delta);
-      mesh.rotation[axis] = origRot[axis] + angle;
+      // Local axis in the device's coordinate system
+      var localAxisVec = new THREE__namespace.Vector3(axis === 'x' ? 1 : 0, axis === 'y' ? 1 : 0, axis === 'z' ? 1 : 0);
+      if (origWorldPos && origWorldQuat && origWorldCenter) {
+        // Transform the configured axis from device-local space into world space
+        // so that 'X' means the device's local X, not the world X.
+        var worldAxisVec = localAxisVec.clone().applyQuaternion(deviceWorldQuat || new THREE__namespace.Quaternion());
+
+        // rotAxisOffset is stored in dialog-viewer-world space where the model root
+        // has been rotated Rot_Z(π) by default (ReconstructionViewer's else branch).
+        // Translation uses the same convention and negates X/Y to compensate.
+        // For rotation offset we apply the same compensation mathematically:
+        //   offset_runtime = deviceWorldQuat × Rot_Z(π) × offset_dialog × scale
+        // This maps from dialog world space (post Z+180° flip) → model local → world.
+        var scale = viewerMaxDim || 1;
+        var rotZ180 = new THREE__namespace.Quaternion().setFromAxisAngle(new THREE__namespace.Vector3(0, 0, 1), Math.PI);
+        var qCombined = (deviceWorldQuat || new THREE__namespace.Quaternion()).clone().multiply(rotZ180);
+        var offWorld = new THREE__namespace.Vector3((off.x || 0) * scale, (off.y || 0) * scale, (off.z || 0) * scale).applyQuaternion(qCombined);
+        var pivot = origWorldCenter.clone().add(offWorld);
+        var deltaQuat = new THREE__namespace.Quaternion().setFromAxisAngle(worldAxisVec, angle);
+
+        // Rotate world position around pivot
+        var offsetVec = origWorldPos.clone().sub(pivot);
+        offsetVec.applyQuaternion(deltaQuat);
+        var newWorldPos = pivot.clone().add(offsetVec);
+
+        // Compose world quaternion
+        var newWorldQuat = deltaQuat.clone().multiply(origWorldQuat);
+
+        // Convert world position → parent local space
+        if (mesh.parent) {
+          mesh.parent.worldToLocal(newWorldPos);
+        }
+        mesh.position.copy(newWorldPos);
+
+        // Convert quaternion → parent local space
+        if (mesh.parent) {
+          var parentWorldQuat = new THREE__namespace.Quaternion();
+          mesh.parent.getWorldQuaternion(parentWorldQuat);
+          parentWorldQuat.invert();
+          newWorldQuat.premultiply(parentWorldQuat);
+        }
+        mesh.quaternion.copy(newWorldQuat);
+      } else {
+        var _off$x, _off$y, _off$z;
+        // Fallback for entries loaded without world data
+        var _pivot = new THREE__namespace.Vector3((_off$x = off.x) !== null && _off$x !== void 0 ? _off$x : 0, (_off$y = off.y) !== null && _off$y !== void 0 ? _off$y : 0, (_off$z = off.z) !== null && _off$z !== void 0 ? _off$z : 0);
+        var delta = origPos.clone().sub(_pivot);
+        delta.applyAxisAngle(localAxisVec, angle);
+        mesh.position.copy(_pivot).add(delta);
+        mesh.rotation[axis] = origRot[axis] + angle;
+      }
     }
 
     /**
@@ -38248,7 +38353,7 @@ var CentralPlantInternals = /*#__PURE__*/function () {
       this.centralPlant.managers.cameraControlsManager = new CameraControlsManager(this.centralPlant.sceneViewer);
       this.centralPlant.managers.componentDragManager = new ComponentDragManager(this.centralPlant.sceneViewer);
       this.centralPlant.managers.viewport2DManager = new Viewport2DManager(this.centralPlant.sceneViewer);
-      this.centralPlant.managers.ioAnimationManager = new IoAnimationManager(this.centralPlant.sceneViewer);
+      this.centralPlant.managers.ioBehaviorManager = new IoBehaviorManager(this.centralPlant.sceneViewer);
       this.centralPlant.managers.ioOutlineManager = new IoOutlineManager(this.centralPlant.sceneViewer);
 
       // All managers are now stored in the managers collection and will be attached via attachToComponent()
@@ -39227,23 +39332,23 @@ var CentralPlantInternals = /*#__PURE__*/function () {
           var _this$centralPlant$sc8;
           attachIODevicesToComponent(componentModel, componentData, modelPreloader, componentId);
 
-          // Register animation configs so IoAnimationManager can respond to state changes
-          var ioAnimMgr = (_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.ioAnimationManager;
-          if (ioAnimMgr) {
+          // 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.animationConfig)) return 1; // continue
+              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) {
-                ioAnimMgr.loadAnimations(attachmentId, deviceData.animationConfig, deviceRoot, componentId);
+                ioBehavMgr.loadBehaviors(attachmentId, deviceData.behaviorConfig, deviceRoot, componentId);
               }
             };
             for (var _i = 0, _Object$entries = Object.entries(componentData.attachedDevices); _i < _Object$entries.length; _i++) {
@@ -39550,7 +39655,7 @@ var CentralPlant = /*#__PURE__*/function (_BaseDisposable) {
    * Initialize the CentralPlant manager
    * 
    * @constructor
-   * @version 0.3.28
+   * @version 0.3.30
    * @updated 2025-10-22
    * 
    * @description Creates a new CentralPlant instance and initializes internal managers and utilities.
@@ -40628,8 +40733,8 @@ var CentralPlant = /*#__PURE__*/function (_BaseDisposable) {
         }
       }
 
-      // 2. Apply io-animation changes
-      (_this$sceneViewer5 = this.sceneViewer) === null || _this$sceneViewer5 === void 0 || (_this$sceneViewer5 = _this$sceneViewer5.managers) === null || _this$sceneViewer5 === void 0 || (_this$sceneViewer5 = _this$sceneViewer5.ioAnimationManager) === null || _this$sceneViewer5 === void 0 || _this$sceneViewer5.triggerState(attachmentId, stateId, value, parentUuid);
+      // 2. Apply io-behavior changes
+      (_this$sceneViewer5 = this.sceneViewer) === null || _this$sceneViewer5 === void 0 || (_this$sceneViewer5 = _this$sceneViewer5.managers) === null || _this$sceneViewer5 === void 0 || (_this$sceneViewer5 = _this$sceneViewer5.ioBehaviorManager) === null || _this$sceneViewer5 === void 0 || _this$sceneViewer5.triggerState(attachmentId, stateId, value, parentUuid);
 
       // 3. Emit event for host apps that don't use the state adapter (e.g. cp3d-viewer)
       (_this$sceneViewer6 = this.sceneViewer) === null || _this$sceneViewer6 === void 0 || _this$sceneViewer6.emit('io-device-state-changed', {
@@ -42460,7 +42565,7 @@ var sceneViewer = /*#__PURE__*/function (_BaseDisposable) {
               this.centralPlant.attachToComponent();
 
               // Sync our managers tracking object after attachment
-              managerKeys = ['threeJSResourceManager', 'performanceMonitorManager', 'settingsManager', 'sceneExportManager', 'componentManager', 'sceneInitializationManager', 'environmentManager', 'keyboardControlsManager', 'pathfindingManager', 'pathFlowManager', 'ioAnimationManager', 'ioOutlineManager', 'sceneOperationsManager', 'animationManager', 'cameraControlsManager', 'componentDragManager', 'tooltipsManager', 'componentTooltipManager']; // Populate our managers tracking object
+              managerKeys = ['threeJSResourceManager', 'performanceMonitorManager', 'settingsManager', 'sceneExportManager', 'componentManager', 'sceneInitializationManager', 'environmentManager', 'keyboardControlsManager', 'pathfindingManager', 'pathFlowManager', 'ioBehaviorManager', 'ioOutlineManager', 'sceneOperationsManager', 'animationManager', 'cameraControlsManager', 'componentDragManager', 'tooltipsManager', 'componentTooltipManager']; // Populate our managers tracking object
               managerKeys.forEach(function (key) {
                 if (_this2[key]) {
                   _this2.managers[key] = _this2[key];
@@ -42790,12 +42895,12 @@ var sceneViewer = /*#__PURE__*/function (_BaseDisposable) {
             _this4.componentTooltipManager.toggleIODeviceBinaryState(ioDeviceObject);
           }
         },
-        onIODeviceDrag: function onIODeviceDrag(ioDeviceObject, signedDelta, isStart) {
+        onIODeviceDrag: function onIODeviceDrag(ioDeviceObject, signedDelta, isStart, hitMesh) {
           if (isStart) {
-            var _ioDeviceObject$userD, _this4$managers$ioAni, _this4$managers, _this4$managers2;
+            var _ioDeviceObject$userD, _this4$managers$ioBeh, _this4$managers, _this4$managers2;
             // Resolve parentUuid by walking up to the host component.
             // Use userData.originalUuid (the custom componentId) because that
-            // is what IoAnimationManager uses as the map key — NOT obj.uuid.
+            // is what IoBehaviorManager uses as the map key — NOT obj.uuid.
             var parentUuid = null;
             var obj = ioDeviceObject.parent;
             while (obj) {
@@ -42811,13 +42916,13 @@ var sceneViewer = /*#__PURE__*/function (_BaseDisposable) {
             // silhouette is isolated and the outline ring is visible around
             // them specifically (not swallowed by the larger device body).
             // Fall back to the whole device group when none are registered.
-            var animatedMeshes = attachmentId && parentUuid ? (_this4$managers$ioAni = (_this4$managers = _this4.managers) === null || _this4$managers === void 0 || (_this4$managers = _this4$managers.ioAnimationManager) === null || _this4$managers === void 0 ? void 0 : _this4$managers.getAnimatedMeshes(parentUuid, attachmentId)) !== null && _this4$managers$ioAni !== void 0 ? _this4$managers$ioAni : [] : [];
+            var animatedMeshes = attachmentId && parentUuid ? (_this4$managers$ioBeh = (_this4$managers = _this4.managers) === null || _this4$managers === void 0 || (_this4$managers = _this4$managers.ioBehaviorManager) === null || _this4$managers === void 0 ? void 0 : _this4$managers.getAnimatedMeshes(parentUuid, attachmentId)) !== null && _this4$managers$ioBeh !== void 0 ? _this4$managers$ioBeh : [] : [];
             var targets = animatedMeshes.length > 0 ? animatedMeshes : [ioDeviceObject];
             (_this4$managers2 = _this4.managers) === null || _this4$managers2 === void 0 || (_this4$managers2 = _this4$managers2.ioOutlineManager) === null || _this4$managers2 === void 0 || _this4$managers2.setTargets(targets);
           }
           if (!_this4.componentTooltipManager) return;
           if (isStart) {
-            _this4.componentTooltipManager.startIODeviceDrag(ioDeviceObject);
+            _this4.componentTooltipManager.startIODeviceDrag(ioDeviceObject, hitMesh);
           } else {
             _this4.componentTooltipManager.updateIODeviceDrag(signedDelta);
           }
@@ -48190,7 +48295,7 @@ exports.ComponentTooltipManager = ComponentTooltipManager;
 exports.EnvironmentManager = EnvironmentManager;
 exports.FLOW_ATTRIBUTE_KEYS = FLOW_ATTRIBUTE_KEYS;
 exports.GLOBAL_CACHE_NAME = GLOBAL_CACHE_NAME;
-exports.IoAnimationManager = IoAnimationManager;
+exports.IoBehaviorManager = IoBehaviorManager;
 exports.KeyboardControlsManager = KeyboardControlsManager;
 exports.ModelManager = ModelManager;
 exports.OperationHistoryManager = OperationHistoryManager;

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

@@ -35,7 +35,7 @@ var CentralPlant = /*#__PURE__*/function (_BaseDisposable) {
    * Initialize the CentralPlant manager
    * 
    * @constructor
-   * @version 0.3.28
+   * @version 0.3.30
    * @updated 2025-10-22
    * 
    * @description Creates a new CentralPlant instance and initializes internal managers and utilities.
@@ -1113,8 +1113,8 @@ var CentralPlant = /*#__PURE__*/function (_BaseDisposable) {
         }
       }
 
-      // 2. Apply io-animation changes
-      (_this$sceneViewer5 = this.sceneViewer) === null || _this$sceneViewer5 === void 0 || (_this$sceneViewer5 = _this$sceneViewer5.managers) === null || _this$sceneViewer5 === void 0 || (_this$sceneViewer5 = _this$sceneViewer5.ioAnimationManager) === null || _this$sceneViewer5 === void 0 || _this$sceneViewer5.triggerState(attachmentId, stateId, value, parentUuid);
+      // 2. Apply io-behavior changes
+      (_this$sceneViewer5 = this.sceneViewer) === null || _this$sceneViewer5 === void 0 || (_this$sceneViewer5 = _this$sceneViewer5.managers) === null || _this$sceneViewer5 === void 0 || (_this$sceneViewer5 = _this$sceneViewer5.ioBehaviorManager) === null || _this$sceneViewer5 === void 0 || _this$sceneViewer5.triggerState(attachmentId, stateId, value, parentUuid);
 
       // 3. Emit event for host apps that don't use the state adapter (e.g. cp3d-viewer)
       (_this$sceneViewer6 = this.sceneViewer) === null || _this$sceneViewer6 === void 0 || _this$sceneViewer6.emit('io-device-state-changed', {

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

@@ -26,7 +26,7 @@ var componentDragManager = require('../managers/controls/componentDragManager.js
 var sceneTooltipsManager = require('../managers/scene/sceneTooltipsManager.js');
 var componentTooltipManager = require('../managers/scene/componentTooltipManager.js');
 var viewport2DManager = require('../managers/scene/viewport2DManager.js');
-var IoAnimationManager = require('../managers/behaviors/IoAnimationManager.js');
+var IoBehaviorManager = require('../managers/behaviors/IoBehaviorManager.js');
 var IoOutlineManager = require('../managers/behaviors/IoOutlineManager.js');
 var nameUtils = require('../utils/nameUtils.js');
 var ioDeviceUtils = require('../utils/ioDeviceUtils.js');
@@ -173,7 +173,7 @@ var CentralPlantInternals = /*#__PURE__*/function () {
       this.centralPlant.managers.cameraControlsManager = new cameraControlsManager.CameraControlsManager(this.centralPlant.sceneViewer);
       this.centralPlant.managers.componentDragManager = new componentDragManager.ComponentDragManager(this.centralPlant.sceneViewer);
       this.centralPlant.managers.viewport2DManager = new viewport2DManager.Viewport2DManager(this.centralPlant.sceneViewer);
-      this.centralPlant.managers.ioAnimationManager = new IoAnimationManager.IoAnimationManager(this.centralPlant.sceneViewer);
+      this.centralPlant.managers.ioBehaviorManager = new IoBehaviorManager.IoBehaviorManager(this.centralPlant.sceneViewer);
       this.centralPlant.managers.ioOutlineManager = new IoOutlineManager.IoOutlineManager(this.centralPlant.sceneViewer);
 
       // All managers are now stored in the managers collection and will be attached via attachToComponent()
@@ -1152,23 +1152,23 @@ var CentralPlantInternals = /*#__PURE__*/function () {
           var _this$centralPlant$sc8;
           ioDeviceUtils.attachIODevicesToComponent(componentModel, componentData, modelPreloader, componentId);
 
-          // Register animation configs so IoAnimationManager can respond to state changes
-          var ioAnimMgr = (_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.ioAnimationManager;
-          if (ioAnimMgr) {
+          // 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 = _rollupPluginBabelHelpers.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.animationConfig)) return 1; // continue
+              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) {
-                ioAnimMgr.loadAnimations(attachmentId, deviceData.animationConfig, deviceRoot, componentId);
+                ioBehavMgr.loadBehaviors(attachmentId, deviceData.behaviorConfig, deviceRoot, componentId);
               }
             };
             for (var _i = 0, _Object$entries = Object.entries(componentData.attachedDevices); _i < _Object$entries.length; _i++) {