@2112-lab/central-plant 0.2.3 → 0.2.5

package/dist/bundle/index.js

@@ -28480,7 +28480,7 @@ var BehaviorManager = /*#__PURE__*/function (_BaseDisposable) {
         if (_this4._testCondition(condition.when, value)) {
           if (Array.isArray(condition.actions)) {
             condition.actions.forEach(function (action) {
-              _this4._applyAction(output, action.set, action.value);
+              _this4._applyAction(output, action.set, action.value, action.relative === true);
             });
           }
         }
@@ -28558,6 +28558,7 @@ var BehaviorManager = /*#__PURE__*/function (_BaseDisposable) {
   }, {
     key: "_applyAction",
     value: function _applyAction(object, propertyPath, value) {
+      var relative = arguments.length > 3 && arguments[3] !== undefined ? arguments[3] : false;
       if (!object || typeof propertyPath !== 'string') return;
       var parts = propertyPath.split('.');
 
@@ -28583,6 +28584,15 @@ var BehaviorManager = /*#__PURE__*/function (_BaseDisposable) {
         return;
       }
 
+      // If relative, capture the mesh's original value on first execution and offset from it.
+      if (relative) {
+        var baselineKey = "_baseline_".concat(propertyPath.replace(/\./g, '_'));
+        if (!(baselineKey in object.userData)) {
+          object.userData[baselineKey] = target[lastKey];
+        }
+        value = object.userData[baselineKey] + parseFloat(value);
+      }
+
       // THREE.Color objects must be mutated via .set() rather than replaced
       var existing = target[lastKey];
       if (existing && existing.isColor && typeof value === 'string') {
@@ -28635,7 +28645,7 @@ function attachIODevicesToComponent(_x, _x2, _x3, _x4) {
 }
 function _attachIODevicesToComponent() {
   _attachIODevicesToComponent = _asyncToGenerator(/*#__PURE__*/_regenerator().m(function _callee(componentModel, componentData, modelPreloader, parentComponentId) {
-    var attachedDevices, _i, _Object$entries, _Object$entries$_i, attachmentId, attachment, _modelPreloader$compo, _deviceData$ioConfig, _deviceData$ioConfig2, _deviceData$ioConfig3, _attachment$attachmen, deviceData, cachedDevice, _modelPreloader$loadi, deviceModel, pos, _t, _t2;
+    var attachedDevices, _i, _Object$entries, _Object$entries$_i, attachmentId, attachment, _modelPreloader$compo, _deviceData$ioConfig, _deviceData$ioConfig2, _deviceData$ioConfig3, _attachment$attachmen, _attachment$attachmen2, deviceData, cachedDevice, _modelPreloader$loadi, deviceModel, pos, rot, deg2rad, _t, _t2;
     return _regenerator().w(function (_context) {
       while (1) switch (_context.n) {
         case 0:
@@ -28736,6 +28746,13 @@ function _attachIODevicesToComponent() {
             deviceModel.position.set(pos.x || 0, pos.y || 0, pos.z || 0);
           }
 
+          // Apply face-based rotation (stored in degrees, XYZ Euler order)
+          if ((_attachment$attachmen2 = attachment.attachmentPoint) !== null && _attachment$attachmen2 !== void 0 && _attachment$attachmen2.rotation) {
+            rot = attachment.attachmentPoint.rotation;
+            deg2rad = Math.PI / 180;
+            deviceModel.rotation.set((rot.x || 0) * deg2rad, (rot.y || 0) * deg2rad, (rot.z || 0) * deg2rad, 'XYZ');
+          }
+
           // IO device models are authored at the same real-world unit scale
           // as the host component, so keep them at their natural (1:1) size.
           // Note: attachmentPoint.scale is the connector marker sphere size,
@@ -32575,7 +32592,7 @@ var ComponentDragManager = /*#__PURE__*/function (_BaseDisposable) {
     key: "_attachIODeviceModelsToPreview",
     value: (function () {
       var _attachIODeviceModelsToPreview2 = _asyncToGenerator(/*#__PURE__*/_regenerator().m(function _callee3(parentObject, componentData, modelPreloader) {
-        var _i, _Object$entries, _Object$entries$_i, attachmentId, attachment, _modelPreloader$compo, _deviceData$ioConfig, _deviceData$ioConfig2, _deviceData$ioConfig3, _attachment$attachmen, deviceData, cachedDevice, _modelPreloader$loadi, deviceModel, pos, _t3;
+        var _i, _Object$entries, _Object$entries$_i, attachmentId, attachment, _modelPreloader$compo, _deviceData$ioConfig, _deviceData$ioConfig2, _deviceData$ioConfig3, _attachment$attachmen, _attachment$attachmen2, deviceData, cachedDevice, _modelPreloader$loadi, deviceModel, pos, rot, deg2rad, _t3;
         return _regenerator().w(function (_context3) {
           while (1) switch (_context3.n) {
             case 0:
@@ -32650,6 +32667,13 @@ var ComponentDragManager = /*#__PURE__*/function (_BaseDisposable) {
                 deviceModel.position.set(pos.x || 0, pos.y || 0, pos.z || 0);
               }
 
+              // Apply face-based rotation (stored in degrees, XYZ Euler order)
+              if ((_attachment$attachmen2 = attachment.attachmentPoint) !== null && _attachment$attachmen2 !== void 0 && _attachment$attachmen2.rotation) {
+                rot = attachment.attachmentPoint.rotation;
+                deg2rad = Math.PI / 180;
+                deviceModel.rotation.set((rot.x || 0) * deg2rad, (rot.y || 0) * deg2rad, (rot.z || 0) * deg2rad, 'XYZ');
+              }
+
               // IO device models use their natural (1:1) scale — the stored
               // attachmentPoint.scale value is for the connector marker sphere.
               deviceModel.scale.setScalar(1);
@@ -37214,7 +37238,7 @@ var CentralPlant = /*#__PURE__*/function (_BaseDisposable) {
    * Initialize the CentralPlant manager
    * 
    * @constructor
-   * @version 0.2.3
+   * @version 0.2.5
    * @updated 2025-10-22
    * 
    * @description Creates a new CentralPlant instance and initializes internal managers and utilities.
@@ -38248,6 +38272,69 @@ var CentralPlant = /*#__PURE__*/function (_BaseDisposable) {
       bm.triggerState(attachmentId, stateId, value, parentUuid);
     }
 
+    /**
+     * 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)
+     */
+  }, {
+    key: "setIoDeviceState",
+    value: function setIoDeviceState(attachmentId, stateId, value, parentUuid) {
+      var _this$sceneViewer0, _this$sceneViewer1, _this$sceneViewer10;
+      var bm = (_this$sceneViewer0 = this.sceneViewer) === null || _this$sceneViewer0 === void 0 || (_this$sceneViewer0 = _this$sceneViewer0.managers) === null || _this$sceneViewer0 === void 0 ? void 0 : _this$sceneViewer0.behaviorManager;
+      if (!bm) {
+        console.warn('⚠️ setIoDeviceState(): BehaviorManager not available');
+        return false;
+      }
+
+      // 1. Persist via state adapter if one has been configured
+      var stateAdapter = (_this$sceneViewer1 = this.sceneViewer) === null || _this$sceneViewer1 === void 0 || (_this$sceneViewer1 = _this$sceneViewer1.managers) === null || _this$sceneViewer1 === void 0 || (_this$sceneViewer1 = _this$sceneViewer1.componentTooltipManager) === null || _this$sceneViewer1 === void 0 ? void 0 : _this$sceneViewer1._stateAdapter;
+      if (stateAdapter !== null && stateAdapter !== void 0 && stateAdapter.setState) {
+        var scopedKey = parentUuid ? "".concat(parentUuid, "::").concat(attachmentId) : attachmentId;
+        try {
+          stateAdapter.setState(scopedKey, stateId, value);
+        } catch (err) {
+          console.warn('⚠️ setIoDeviceState(): stateAdapter.setState() threw:', err);
+        }
+      }
+
+      // 2. Apply Three.js behavior changes
+      bm.triggerState(attachmentId, stateId, value, parentUuid);
+
+      // 3. Emit event for host apps that don't use the state adapter (e.g. cp3d-viewer)
+      (_this$sceneViewer10 = this.sceneViewer) === null || _this$sceneViewer10 === void 0 || _this$sceneViewer10.emit('io-device-state-changed', {
+        attachmentId: attachmentId,
+        stateId: stateId,
+        value: value,
+        parentUuid: parentUuid || null
+      });
+      return true;
+    }
+
     /**
      * Return all io-device attachments present in the current Three.js scene.
      * Each entry carries the attachmentId, an optional label, and the parent
@@ -38261,8 +38348,8 @@ var CentralPlant = /*#__PURE__*/function (_BaseDisposable) {
   }, {
     key: "getSceneAttachments",
     value: function getSceneAttachments() {
-      var _this$sceneViewer0;
-      var scene = (_this$sceneViewer0 = this.sceneViewer) === null || _this$sceneViewer0 === void 0 ? void 0 : _this$sceneViewer0.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) {

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

@@ -19,7 +19,7 @@ var CentralPlant = /*#__PURE__*/function (_BaseDisposable) {
    * Initialize the CentralPlant manager
    * 
    * @constructor
-   * @version 0.2.3
+   * @version 0.2.5
    * @updated 2025-10-22
    * 
    * @description Creates a new CentralPlant instance and initializes internal managers and utilities.
@@ -1053,6 +1053,69 @@ var CentralPlant = /*#__PURE__*/function (_BaseDisposable) {
       bm.triggerState(attachmentId, stateId, value, parentUuid);
     }
 
+    /**
+     * 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)
+     */
+  }, {
+    key: "setIoDeviceState",
+    value: function setIoDeviceState(attachmentId, stateId, value, parentUuid) {
+      var _this$sceneViewer0, _this$sceneViewer1, _this$sceneViewer10;
+      var bm = (_this$sceneViewer0 = this.sceneViewer) === null || _this$sceneViewer0 === void 0 || (_this$sceneViewer0 = _this$sceneViewer0.managers) === null || _this$sceneViewer0 === void 0 ? void 0 : _this$sceneViewer0.behaviorManager;
+      if (!bm) {
+        console.warn('⚠️ setIoDeviceState(): BehaviorManager not available');
+        return false;
+      }
+
+      // 1. Persist via state adapter if one has been configured
+      var stateAdapter = (_this$sceneViewer1 = this.sceneViewer) === null || _this$sceneViewer1 === void 0 || (_this$sceneViewer1 = _this$sceneViewer1.managers) === null || _this$sceneViewer1 === void 0 || (_this$sceneViewer1 = _this$sceneViewer1.componentTooltipManager) === null || _this$sceneViewer1 === void 0 ? void 0 : _this$sceneViewer1._stateAdapter;
+      if (stateAdapter !== null && stateAdapter !== void 0 && stateAdapter.setState) {
+        var scopedKey = parentUuid ? "".concat(parentUuid, "::").concat(attachmentId) : attachmentId;
+        try {
+          stateAdapter.setState(scopedKey, stateId, value);
+        } catch (err) {
+          console.warn('⚠️ setIoDeviceState(): stateAdapter.setState() threw:', err);
+        }
+      }
+
+      // 2. Apply Three.js behavior changes
+      bm.triggerState(attachmentId, stateId, value, parentUuid);
+
+      // 3. Emit event for host apps that don't use the state adapter (e.g. cp3d-viewer)
+      (_this$sceneViewer10 = this.sceneViewer) === null || _this$sceneViewer10 === void 0 || _this$sceneViewer10.emit('io-device-state-changed', {
+        attachmentId: attachmentId,
+        stateId: stateId,
+        value: value,
+        parentUuid: parentUuid || null
+      });
+      return true;
+    }
+
     /**
      * Return all io-device attachments present in the current Three.js scene.
      * Each entry carries the attachmentId, an optional label, and the parent
@@ -1066,8 +1129,8 @@ var CentralPlant = /*#__PURE__*/function (_BaseDisposable) {
   }, {
     key: "getSceneAttachments",
     value: function getSceneAttachments() {
-      var _this$sceneViewer0;
-      var scene = (_this$sceneViewer0 = this.sceneViewer) === null || _this$sceneViewer0 === void 0 ? void 0 : _this$sceneViewer0.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) {

package/dist/cjs/src/managers/behaviors/BehaviorManager.js

@@ -264,7 +264,7 @@ var BehaviorManager = /*#__PURE__*/function (_BaseDisposable) {
         if (_this4._testCondition(condition.when, value)) {
           if (Array.isArray(condition.actions)) {
             condition.actions.forEach(function (action) {
-              _this4._applyAction(output, action.set, action.value);
+              _this4._applyAction(output, action.set, action.value, action.relative === true);
             });
           }
         }
@@ -342,6 +342,7 @@ var BehaviorManager = /*#__PURE__*/function (_BaseDisposable) {
   }, {
     key: "_applyAction",
     value: function _applyAction(object, propertyPath, value) {
+      var relative = arguments.length > 3 && arguments[3] !== undefined ? arguments[3] : false;
       if (!object || typeof propertyPath !== 'string') return;
       var parts = propertyPath.split('.');
 
@@ -367,6 +368,15 @@ var BehaviorManager = /*#__PURE__*/function (_BaseDisposable) {
         return;
       }
 
+      // If relative, capture the mesh's original value on first execution and offset from it.
+      if (relative) {
+        var baselineKey = "_baseline_".concat(propertyPath.replace(/\./g, '_'));
+        if (!(baselineKey in object.userData)) {
+          object.userData[baselineKey] = target[lastKey];
+        }
+        value = object.userData[baselineKey] + parseFloat(value);
+      }
+
       // THREE.Color objects must be mutated via .set() rather than replaced
       var existing = target[lastKey];
       if (existing && existing.isColor && typeof value === 'string') {

package/dist/cjs/src/managers/controls/componentDragManager.js

@@ -345,7 +345,7 @@ var ComponentDragManager = /*#__PURE__*/function (_BaseDisposable) {
     key: "_attachIODeviceModelsToPreview",
     value: (function () {
       var _attachIODeviceModelsToPreview2 = _rollupPluginBabelHelpers.asyncToGenerator(/*#__PURE__*/_rollupPluginBabelHelpers.regenerator().m(function _callee3(parentObject, componentData, modelPreloader) {
-        var _i, _Object$entries, _Object$entries$_i, attachmentId, attachment, _modelPreloader$compo, _deviceData$ioConfig, _deviceData$ioConfig2, _deviceData$ioConfig3, _attachment$attachmen, deviceData, cachedDevice, _modelPreloader$loadi, deviceModel, pos, _t3;
+        var _i, _Object$entries, _Object$entries$_i, attachmentId, attachment, _modelPreloader$compo, _deviceData$ioConfig, _deviceData$ioConfig2, _deviceData$ioConfig3, _attachment$attachmen, _attachment$attachmen2, deviceData, cachedDevice, _modelPreloader$loadi, deviceModel, pos, rot, deg2rad, _t3;
         return _rollupPluginBabelHelpers.regenerator().w(function (_context3) {
           while (1) switch (_context3.n) {
             case 0:
@@ -420,6 +420,13 @@ var ComponentDragManager = /*#__PURE__*/function (_BaseDisposable) {
                 deviceModel.position.set(pos.x || 0, pos.y || 0, pos.z || 0);
               }
 
+              // Apply face-based rotation (stored in degrees, XYZ Euler order)
+              if ((_attachment$attachmen2 = attachment.attachmentPoint) !== null && _attachment$attachmen2 !== void 0 && _attachment$attachmen2.rotation) {
+                rot = attachment.attachmentPoint.rotation;
+                deg2rad = Math.PI / 180;
+                deviceModel.rotation.set((rot.x || 0) * deg2rad, (rot.y || 0) * deg2rad, (rot.z || 0) * deg2rad, 'XYZ');
+              }
+
               // IO device models use their natural (1:1) scale — the stored
               // attachmentPoint.scale value is for the connector marker sphere.
               deviceModel.scale.setScalar(1);

package/dist/cjs/src/utils/ioDeviceUtils.js

@@ -27,7 +27,7 @@ function attachIODevicesToComponent(_x, _x2, _x3, _x4) {
 }
 function _attachIODevicesToComponent() {
   _attachIODevicesToComponent = _rollupPluginBabelHelpers.asyncToGenerator(/*#__PURE__*/_rollupPluginBabelHelpers.regenerator().m(function _callee(componentModel, componentData, modelPreloader, parentComponentId) {
-    var attachedDevices, _i, _Object$entries, _Object$entries$_i, attachmentId, attachment, _modelPreloader$compo, _deviceData$ioConfig, _deviceData$ioConfig2, _deviceData$ioConfig3, _attachment$attachmen, deviceData, cachedDevice, _modelPreloader$loadi, deviceModel, pos, _t, _t2;
+    var attachedDevices, _i, _Object$entries, _Object$entries$_i, attachmentId, attachment, _modelPreloader$compo, _deviceData$ioConfig, _deviceData$ioConfig2, _deviceData$ioConfig3, _attachment$attachmen, _attachment$attachmen2, deviceData, cachedDevice, _modelPreloader$loadi, deviceModel, pos, rot, deg2rad, _t, _t2;
     return _rollupPluginBabelHelpers.regenerator().w(function (_context) {
       while (1) switch (_context.n) {
         case 0:
@@ -128,6 +128,13 @@ function _attachIODevicesToComponent() {
             deviceModel.position.set(pos.x || 0, pos.y || 0, pos.z || 0);
           }
 
+          // Apply face-based rotation (stored in degrees, XYZ Euler order)
+          if ((_attachment$attachmen2 = attachment.attachmentPoint) !== null && _attachment$attachmen2 !== void 0 && _attachment$attachmen2.rotation) {
+            rot = attachment.attachmentPoint.rotation;
+            deg2rad = Math.PI / 180;
+            deviceModel.rotation.set((rot.x || 0) * deg2rad, (rot.y || 0) * deg2rad, (rot.z || 0) * deg2rad, 'XYZ');
+          }
+
           // IO device models are authored at the same real-world unit scale
           // as the host component, so keep them at their natural (1:1) size.
           // Note: attachmentPoint.scale is the connector marker sphere size,

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

@@ -15,7 +15,7 @@ var CentralPlant = /*#__PURE__*/function (_BaseDisposable) {
    * Initialize the CentralPlant manager
    * 
    * @constructor
-   * @version 0.2.3
+   * @version 0.2.5
    * @updated 2025-10-22
    * 
    * @description Creates a new CentralPlant instance and initializes internal managers and utilities.
@@ -1049,6 +1049,69 @@ var CentralPlant = /*#__PURE__*/function (_BaseDisposable) {
       bm.triggerState(attachmentId, stateId, value, parentUuid);
     }
 
+    /**
+     * 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)
+     */
+  }, {
+    key: "setIoDeviceState",
+    value: function setIoDeviceState(attachmentId, stateId, value, parentUuid) {
+      var _this$sceneViewer0, _this$sceneViewer1, _this$sceneViewer10;
+      var bm = (_this$sceneViewer0 = this.sceneViewer) === null || _this$sceneViewer0 === void 0 || (_this$sceneViewer0 = _this$sceneViewer0.managers) === null || _this$sceneViewer0 === void 0 ? void 0 : _this$sceneViewer0.behaviorManager;
+      if (!bm) {
+        console.warn('⚠️ setIoDeviceState(): BehaviorManager not available');
+        return false;
+      }
+
+      // 1. Persist via state adapter if one has been configured
+      var stateAdapter = (_this$sceneViewer1 = this.sceneViewer) === null || _this$sceneViewer1 === void 0 || (_this$sceneViewer1 = _this$sceneViewer1.managers) === null || _this$sceneViewer1 === void 0 || (_this$sceneViewer1 = _this$sceneViewer1.componentTooltipManager) === null || _this$sceneViewer1 === void 0 ? void 0 : _this$sceneViewer1._stateAdapter;
+      if (stateAdapter !== null && stateAdapter !== void 0 && stateAdapter.setState) {
+        var scopedKey = parentUuid ? "".concat(parentUuid, "::").concat(attachmentId) : attachmentId;
+        try {
+          stateAdapter.setState(scopedKey, stateId, value);
+        } catch (err) {
+          console.warn('⚠️ setIoDeviceState(): stateAdapter.setState() threw:', err);
+        }
+      }
+
+      // 2. Apply Three.js behavior changes
+      bm.triggerState(attachmentId, stateId, value, parentUuid);
+
+      // 3. Emit event for host apps that don't use the state adapter (e.g. cp3d-viewer)
+      (_this$sceneViewer10 = this.sceneViewer) === null || _this$sceneViewer10 === void 0 || _this$sceneViewer10.emit('io-device-state-changed', {
+        attachmentId: attachmentId,
+        stateId: stateId,
+        value: value,
+        parentUuid: parentUuid || null
+      });
+      return true;
+    }
+
     /**
      * Return all io-device attachments present in the current Three.js scene.
      * Each entry carries the attachmentId, an optional label, and the parent
@@ -1062,8 +1125,8 @@ var CentralPlant = /*#__PURE__*/function (_BaseDisposable) {
   }, {
     key: "getSceneAttachments",
     value: function getSceneAttachments() {
-      var _this$sceneViewer0;
-      var scene = (_this$sceneViewer0 = this.sceneViewer) === null || _this$sceneViewer0 === void 0 ? void 0 : _this$sceneViewer0.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) {

package/dist/esm/src/managers/behaviors/BehaviorManager.js

@@ -260,7 +260,7 @@ var BehaviorManager = /*#__PURE__*/function (_BaseDisposable) {
         if (_this4._testCondition(condition.when, value)) {
           if (Array.isArray(condition.actions)) {
             condition.actions.forEach(function (action) {
-              _this4._applyAction(output, action.set, action.value);
+              _this4._applyAction(output, action.set, action.value, action.relative === true);
             });
           }
         }
@@ -338,6 +338,7 @@ var BehaviorManager = /*#__PURE__*/function (_BaseDisposable) {
   }, {
     key: "_applyAction",
     value: function _applyAction(object, propertyPath, value) {
+      var relative = arguments.length > 3 && arguments[3] !== undefined ? arguments[3] : false;
       if (!object || typeof propertyPath !== 'string') return;
       var parts = propertyPath.split('.');
 
@@ -363,6 +364,15 @@ var BehaviorManager = /*#__PURE__*/function (_BaseDisposable) {
         return;
       }
 
+      // If relative, capture the mesh's original value on first execution and offset from it.
+      if (relative) {
+        var baselineKey = "_baseline_".concat(propertyPath.replace(/\./g, '_'));
+        if (!(baselineKey in object.userData)) {
+          object.userData[baselineKey] = target[lastKey];
+        }
+        value = object.userData[baselineKey] + parseFloat(value);
+      }
+
       // THREE.Color objects must be mutated via .set() rather than replaced
       var existing = target[lastKey];
       if (existing && existing.isColor && typeof value === 'string') {

package/dist/esm/src/managers/controls/componentDragManager.js

@@ -321,7 +321,7 @@ var ComponentDragManager = /*#__PURE__*/function (_BaseDisposable) {
     key: "_attachIODeviceModelsToPreview",
     value: (function () {
       var _attachIODeviceModelsToPreview2 = _asyncToGenerator(/*#__PURE__*/_regenerator().m(function _callee3(parentObject, componentData, modelPreloader) {
-        var _i, _Object$entries, _Object$entries$_i, attachmentId, attachment, _modelPreloader$compo, _deviceData$ioConfig, _deviceData$ioConfig2, _deviceData$ioConfig3, _attachment$attachmen, deviceData, cachedDevice, _modelPreloader$loadi, deviceModel, pos, _t3;
+        var _i, _Object$entries, _Object$entries$_i, attachmentId, attachment, _modelPreloader$compo, _deviceData$ioConfig, _deviceData$ioConfig2, _deviceData$ioConfig3, _attachment$attachmen, _attachment$attachmen2, deviceData, cachedDevice, _modelPreloader$loadi, deviceModel, pos, rot, deg2rad, _t3;
         return _regenerator().w(function (_context3) {
           while (1) switch (_context3.n) {
             case 0:
@@ -396,6 +396,13 @@ var ComponentDragManager = /*#__PURE__*/function (_BaseDisposable) {
                 deviceModel.position.set(pos.x || 0, pos.y || 0, pos.z || 0);
               }
 
+              // Apply face-based rotation (stored in degrees, XYZ Euler order)
+              if ((_attachment$attachmen2 = attachment.attachmentPoint) !== null && _attachment$attachmen2 !== void 0 && _attachment$attachmen2.rotation) {
+                rot = attachment.attachmentPoint.rotation;
+                deg2rad = Math.PI / 180;
+                deviceModel.rotation.set((rot.x || 0) * deg2rad, (rot.y || 0) * deg2rad, (rot.z || 0) * deg2rad, 'XYZ');
+              }
+
               // IO device models use their natural (1:1) scale — the stored
               // attachmentPoint.scale value is for the connector marker sphere.
               deviceModel.scale.setScalar(1);

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

@@ -23,7 +23,7 @@ function attachIODevicesToComponent(_x, _x2, _x3, _x4) {
 }
 function _attachIODevicesToComponent() {
   _attachIODevicesToComponent = _asyncToGenerator(/*#__PURE__*/_regenerator().m(function _callee(componentModel, componentData, modelPreloader, parentComponentId) {
-    var attachedDevices, _i, _Object$entries, _Object$entries$_i, attachmentId, attachment, _modelPreloader$compo, _deviceData$ioConfig, _deviceData$ioConfig2, _deviceData$ioConfig3, _attachment$attachmen, deviceData, cachedDevice, _modelPreloader$loadi, deviceModel, pos, _t, _t2;
+    var attachedDevices, _i, _Object$entries, _Object$entries$_i, attachmentId, attachment, _modelPreloader$compo, _deviceData$ioConfig, _deviceData$ioConfig2, _deviceData$ioConfig3, _attachment$attachmen, _attachment$attachmen2, deviceData, cachedDevice, _modelPreloader$loadi, deviceModel, pos, rot, deg2rad, _t, _t2;
     return _regenerator().w(function (_context) {
       while (1) switch (_context.n) {
         case 0:
@@ -124,6 +124,13 @@ function _attachIODevicesToComponent() {
             deviceModel.position.set(pos.x || 0, pos.y || 0, pos.z || 0);
           }
 
+          // Apply face-based rotation (stored in degrees, XYZ Euler order)
+          if ((_attachment$attachmen2 = attachment.attachmentPoint) !== null && _attachment$attachmen2 !== void 0 && _attachment$attachmen2.rotation) {
+            rot = attachment.attachmentPoint.rotation;
+            deg2rad = Math.PI / 180;
+            deviceModel.rotation.set((rot.x || 0) * deg2rad, (rot.y || 0) * deg2rad, (rot.z || 0) * deg2rad, 'XYZ');
+          }
+
           // IO device models are authored at the same real-world unit scale
           // as the host component, so keep them at their natural (1:1) size.
           // Note: attachmentPoint.scale is the connector marker sphere size,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@2112-lab/central-plant",
-  "version": "0.2.3",
+  "version": "0.2.5",
   "description": "Utility modules for the Central Plant Application",
   "main": "dist/bundle/index.js",
   "module": "dist/esm/src/index.js",