@2112-lab/central-plant 0.3.39 → 0.3.42

package/dist/bundle/index.js

@@ -1164,6 +1164,122 @@ var DisposalUtilities = /*#__PURE__*/function () {
   }]);
 }();
 
+/**
+ * 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;
+  });
+}
+
+/**
+ * Apply persisted default values for I/O device animation states in the live scene.
+ * Updates the state adapter (e.g. Vuex) and drives mesh animations via IoBehaviorManager.
+ *
+ * @param {Object} centralPlant
+ * @param {{ parentUuid?: string, attachmentId?: string }} [options]
+ */
+function applyDefaultIoDeviceStates(centralPlant) {
+  var _centralPlant$sceneVi;
+  var options = arguments.length > 1 && arguments[1] !== undefined ? arguments[1] : {};
+  var parentUuid = options.parentUuid,
+    attachmentId = options.attachmentId;
+  var ioBehavMgr = getIoBehaviorManager(centralPlant === null || centralPlant === void 0 ? void 0 : centralPlant.sceneViewer);
+  var scene = centralPlant === null || centralPlant === void 0 || (_centralPlant$sceneVi = centralPlant.sceneViewer) === null || _centralPlant$sceneVi === void 0 ? void 0 : _centralPlant$sceneVi.scene;
+  if (!ioBehavMgr || !scene || typeof (centralPlant === null || centralPlant === void 0 ? void 0 : centralPlant.setIoDeviceState) !== 'function') return;
+  var seen = new Set();
+  scene.traverse(function (obj) {
+    var _obj$userData, _obj$parent;
+    if (((_obj$userData = obj.userData) === null || _obj$userData === void 0 ? void 0 : _obj$userData.objectType) !== 'io-device') return;
+    var objParentUuid = obj.userData.parentComponentId || ((_obj$parent = obj.parent) === null || _obj$parent === void 0 ? void 0 : _obj$parent.uuid);
+    var objAttachmentId = obj.userData.attachmentId;
+    if (!objParentUuid || !objAttachmentId) return;
+    if (parentUuid && objParentUuid !== parentUuid) return;
+    if (attachmentId && objAttachmentId !== attachmentId) return;
+    var scopedKey = getScopedAttachmentKey(objAttachmentId, objParentUuid);
+    if (seen.has(scopedKey)) return;
+    seen.add(scopedKey);
+    var dps = ioBehavMgr.getAnimationDataPoints(objParentUuid, objAttachmentId) || [];
+    if (dps.length) {
+      var _iterator = _createForOfIteratorHelper(dps),
+        _step;
+      try {
+        for (_iterator.s(); !(_step = _iterator.n()).done;) {
+          var dp = _step.value;
+          if (!(dp !== null && dp !== void 0 && dp.id) || dp.defaultValue === undefined || dp.defaultValue === null) continue;
+          centralPlant.setIoDeviceState(objAttachmentId, dp.id, dp.defaultValue, objParentUuid);
+        }
+      } catch (err) {
+        _iterator.e(err);
+      } finally {
+        _iterator.f();
+      }
+      return;
+    }
+    var _iterator2 = _createForOfIteratorHelper(obj.userData.dataPoints || []),
+      _step2;
+    try {
+      for (_iterator2.s(); !(_step2 = _iterator2.n()).done;) {
+        var _dp = _step2.value;
+        var dpId = _dp.id || _dp.name;
+        if (!dpId || _dp.defaultValue === undefined || _dp.defaultValue === null) continue;
+        centralPlant.setIoDeviceState(objAttachmentId, dpId, _dp.defaultValue, objParentUuid);
+      }
+    } catch (err) {
+      _iterator2.e(err);
+    } finally {
+      _iterator2.f();
+    }
+  });
+}
+
 /**
  * Register mesh animations and intra-component state links when a smart
  * component is placed or imported into the scene.
@@ -1173,8 +1289,9 @@ var DisposalUtilities = /*#__PURE__*/function () {
  * @param {Object} componentData - Smart component dictionary entry
  * @param {Object} componentModel - Root THREE.Object3D of the placed component
  * @param {Object} componentDictionary - modelPreloader.componentDictionary
+ * @param {Object} [centralPlant] - When provided, default animation states are applied after registration
  */
-function registerBehaviorsForComponent(ioBehavMgr, componentUuid, componentData, componentModel, componentDictionary) {
+function registerBehaviorsForComponent(ioBehavMgr, componentUuid, componentData, componentModel, componentDictionary, centralPlant) {
   var _componentData$behavi;
   if (!ioBehavMgr || !componentData || !componentModel) {
     return;
@@ -1204,6 +1321,11 @@ function registerBehaviorsForComponent(ioBehavMgr, componentUuid, componentData,
   } else if (componentData.isSmart) {
     ioBehavMgr.registerComponentBehaviors(componentUuid, []);
   }
+  if (centralPlant) {
+    applyDefaultIoDeviceStates(centralPlant, {
+      parentUuid: componentUuid
+    });
+  }
 }
 
 /**
@@ -1229,6 +1351,10 @@ function reloadBehaviorsForDeviceAsset(ioBehavMgr, deviceAssetId, componentDicti
     if (!parentUuid || !attachmentId) return;
     ioBehavMgr.unloadForAttachment(parentUuid, attachmentId);
     ioBehavMgr.loadBehaviors(attachmentId, deviceData.behaviorConfig, obj, parentUuid);
+    applyDefaultIoDeviceStates(centralPlant, {
+      parentUuid: parentUuid,
+      attachmentId: attachmentId
+    });
   });
 }
 
@@ -31438,7 +31564,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, ioBehavMgr, warmFn, _jsonEntry$userData4, _t;
+        var component, _jsonEntry$userData, _jsonEntry$userData2, _jsonEntry$userData3, originalProps, connectorChildren, gltfScene, libraryModel, _this$sceneViewer, ioBehavMgr, _this$sceneViewer2, warmFn, _jsonEntry$userData4, _t;
         return _regenerator().w(function (_context) {
           while (1) switch (_context.n) {
             case 0:
@@ -31483,7 +31609,7 @@ var ModelManager = /*#__PURE__*/function () {
             case 4:
               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) {
-                registerBehaviorsForComponent(ioBehavMgr, originalProps.uuid, componentData, libraryModel, modelPreloader.componentDictionary);
+                registerBehaviorsForComponent(ioBehavMgr, originalProps.uuid, componentData, libraryModel, modelPreloader.componentDictionary, (_this$sceneViewer2 = this.sceneViewer) === null || _this$sceneViewer2 === void 0 ? void 0 : _this$sceneViewer2.centralPlant);
               }
             case 5:
               // Replace mesh in scene
@@ -36612,61 +36738,6 @@ var SceneTooltipsManager = /*#__PURE__*/function (_BaseDisposable) {
   }]);
 }(BaseDisposable);
 
-/**
- * Shared I/O device state dispatch helpers used by centralPlant and componentTooltipManager.
- */
-
-/**
- * @param {string} attachmentId
- * @param {string|null|undefined} parentUuid
- * @returns {string}
- */
-function getScopedAttachmentKey(attachmentId, parentUuid) {
-  if (!parentUuid) return attachmentId;
-  return "".concat(parentUuid, "::").concat(attachmentId);
-}
-
-/**
- * @param {Object} sceneViewer
- * @returns {import('../managers/behaviors/IoBehaviorManager.js').IoBehaviorManager|null}
- */
-function getIoBehaviorManager(sceneViewer) {
-  var _sceneViewer$managers, _sceneViewer$centralP;
-  if (!sceneViewer) return null;
-  return ((_sceneViewer$managers = sceneViewer.managers) === null || _sceneViewer$managers === void 0 ? void 0 : _sceneViewer$managers.ioBehaviorManager) || sceneViewer.ioBehaviorManager || ((_sceneViewer$centralP = sceneViewer.centralPlant) === null || _sceneViewer$centralP === void 0 || (_sceneViewer$centralP = _sceneViewer$centralP.managers) === null || _sceneViewer$centralP === void 0 ? void 0 : _sceneViewer$centralP.ioBehaviorManager) || null;
-}
-
-/**
- * Resolve tooltip/drag data points for an I/O device attachment.
- * Prefers behaviorConfig-driven animation data points; merges legacy ioConfig snapshot.
- *
- * @param {string} parentUuid
- * @param {string} attachmentId
- * @param {Object} userData - io-device userData (may include dataPoints snapshot)
- * @param {import('../managers/behaviors/IoBehaviorManager.js').IoBehaviorManager|null} ioBehaviorManager
- * @param {THREE.Object3D|null} [hitMesh]
- * @returns {Object[]}
- */
-function resolveDataPoints(parentUuid, attachmentId, userData, ioBehaviorManager) {
-  var hitMesh = arguments.length > 4 && arguments[4] !== undefined ? arguments[4] : null;
-  var fromAnimations = (ioBehaviorManager === null || ioBehaviorManager === void 0 ? void 0 : ioBehaviorManager.getAnimationDataPoints(parentUuid, attachmentId, hitMesh)) || [];
-  if (fromAnimations.length) return fromAnimations;
-  var legacy = (userData === null || userData === void 0 ? void 0 : userData.dataPoints) || [];
-  return legacy.map(function (dp) {
-    var _dp$defaultValue;
-    return {
-      id: dp.id || dp.name,
-      name: dp.name || dp.id,
-      stateType: dp.stateType || 'binary',
-      stateConfig: dp.stateConfig || {},
-      defaultValue: (_dp$defaultValue = dp.defaultValue) !== null && _dp$defaultValue !== void 0 ? _dp$defaultValue : null,
-      direction: dp.direction || (userData === null || userData === void 0 ? void 0 : userData.ioDirection) || 'output'
-    };
-  }).filter(function (dp) {
-    return dp.id;
-  });
-}
-
 // ---------------------------------------------------------------------------
 // Inline styles (injected once into the document head)
 // ---------------------------------------------------------------------------
@@ -37734,6 +37805,53 @@ function parseCrossBehavior(behavior) {
   };
 }
 
+/**
+ * Resolve the runtime default value for an animation behavior entry.
+ * Uses explicit `defaultValue` when present; otherwise infers from stateType and mappings.
+ *
+ * @param {Object} anim - Behavior entry from behaviorConfig
+ * @returns {boolean|string|number}
+ */
+function resolveAnimationDefaultValue(anim) {
+  var _anim$stateConfig2, _anim$stateConfig3;
+  if (!anim) return null;
+  var rawType = (anim.stateType || '').toLowerCase();
+  var isBinary = rawType === 'binary' || rawType === 'boolean';
+  var isEnum = rawType === 'enum';
+  if (anim.defaultValue !== undefined && anim.defaultValue !== null) {
+    if (isBinary) return !!anim.defaultValue;
+    if (isEnum) return String(anim.defaultValue);
+    var n = Number(anim.defaultValue);
+    return Number.isNaN(n) ? 0 : n;
+  }
+  if (isBinary) return false;
+  if (isEnum) {
+    var _anim$stateConfig, _resolved$;
+    var _mappingValues = (anim.mappings || []).map(function (m) {
+      return m.stateValue;
+    }).filter(function (v) {
+      return v !== '' && v != null;
+    });
+    var options = (((_anim$stateConfig = anim.stateConfig) === null || _anim$stateConfig === void 0 ? void 0 : _anim$stateConfig.options) || []).filter(function (o) {
+      return o !== '';
+    });
+    var resolved = options.length ? options : _toConsumableArray(new Set(_mappingValues.map(String)));
+    return (_resolved$ = resolved[0]) !== null && _resolved$ !== void 0 ? _resolved$ : '';
+  }
+  var mappingValues = (anim.mappings || []).map(function (m) {
+    return m.stateValue;
+  });
+  var nums = mappingValues.map(Number).filter(function (n) {
+    return !Number.isNaN(n);
+  });
+  if (nums.length) return Math.min.apply(Math, _toConsumableArray(nums));
+  if (((_anim$stateConfig2 = anim.stateConfig) === null || _anim$stateConfig2 === void 0 ? void 0 : _anim$stateConfig2.min) !== undefined && ((_anim$stateConfig3 = anim.stateConfig) === null || _anim$stateConfig3 === void 0 ? void 0 : _anim$stateConfig3.min) !== null) {
+    var min = Number(anim.stateConfig.min);
+    return Number.isNaN(min) ? 0 : min;
+  }
+  return 0;
+}
+
 /**
  * Translation helpers for I/O device animations.
  * Offsets are expressed in the device/model root's local space so every child
@@ -37772,6 +37890,21 @@ function applyModelRootTranslation(mesh, modelRoot, origLocalPos, modelOffset) {
   mesh.position.copy(newWorldPos);
 }
 
+/**
+ * Apply a model-root-space translation from a cached rest world position (preview).
+ *
+ * @param {THREE.Object3D} mesh
+ * @param {THREE.Object3D} modelRoot
+ * @param {THREE.Vector3} baseWorldPos
+ * @param {{ x?: number, y?: number, z?: number }} modelOffset
+ */
+function applyModelRootTranslationFromWorldBase(mesh, modelRoot, baseWorldPos, modelOffset) {
+  if (!mesh || !modelRoot || !baseWorldPos) return;
+  var newWorldPos = baseWorldPos.clone().add(modelOffsetToWorldDelta(modelRoot, modelOffset));
+  if (mesh.parent) mesh.parent.worldToLocal(newWorldPos);
+  mesh.position.copy(newWorldPos);
+}
+
 var IoBehaviorManager = /*#__PURE__*/function (_BaseDisposable) {
   function IoBehaviorManager(sceneViewer) {
     var _this;
@@ -38362,18 +38495,7 @@ var IoBehaviorManager = /*#__PURE__*/function (_BaseDisposable) {
               stateConfig.max = Math.max.apply(Math, _toConsumableArray(nums));
             }
           }
-
-          // Sensible default values
-          var defaultValue = void 0;
-          if (stateType === 'binary') {
-            defaultValue = 0;
-          } else if (stateType === 'enum') {
-            var _stateConfig$options$, _stateConfig$options;
-            defaultValue = (_stateConfig$options$ = (_stateConfig$options = stateConfig.options) === null || _stateConfig$options === void 0 ? void 0 : _stateConfig$options[0]) !== null && _stateConfig$options$ !== void 0 ? _stateConfig$options$ : '';
-          } else {
-            var _stateConfig$min;
-            defaultValue = (_stateConfig$min = stateConfig.min) !== null && _stateConfig$min !== void 0 ? _stateConfig$min : 0;
-          }
+          var defaultValue = resolveAnimationDefaultValue(_anim);
           dps.push({
             id: stateVar,
             name: _anim.name || stateVar,
@@ -39961,7 +40083,8 @@ var CentralPlantInternals = /*#__PURE__*/function () {
   }, {
     key: "addComponent",
     value: function addComponent(libraryId) {
-      var _this$centralPlant$sc6;
+      var _this$centralPlant$sc6,
+        _this2 = this;
       var options = arguments.length > 1 && arguments[1] !== undefined ? arguments[1] : {};
       // Use centralized validation for component addition parameters
       var existingIds = this.getComponentIds();
@@ -40198,7 +40321,7 @@ var CentralPlantInternals = /*#__PURE__*/function () {
           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;
           attachIODevicesToComponent(componentModel, componentData, modelPreloader, componentId).then(function () {
             if (ioBehavMgr) {
-              registerBehaviorsForComponent(ioBehavMgr, componentId, componentData, componentModel, modelPreloader.componentDictionary);
+              registerBehaviorsForComponent(ioBehavMgr, componentId, componentData, componentModel, modelPreloader.componentDictionary, _this2.centralPlant);
             }
           }).catch(function (err) {
             console.error("\u274C Error attaching IO devices for ".concat(libraryId, ":"), err);
@@ -40621,7 +40744,7 @@ function reregisterSceneBehaviors(centralPlant) {
     if (!libraryId) return;
     var componentData = dict[libraryId];
     if (!componentData) return;
-    registerBehaviorsForComponent(ioBehavMgr, obj.uuid, componentData, obj, dict);
+    registerBehaviorsForComponent(ioBehavMgr, obj.uuid, componentData, obj, dict, centralPlant);
   });
 }
 
@@ -40651,7 +40774,7 @@ var CentralPlant = /*#__PURE__*/function (_BaseDisposable) {
    * Initialize the CentralPlant manager
    * 
    * @constructor
-   * @version 0.3.39
+   * @version 0.3.42
    * @updated 2025-10-22
    * 
    * @description Creates a new CentralPlant instance and initializes internal managers and utilities.
@@ -49329,6 +49452,9 @@ exports.SceneTooltipsManager = SceneTooltipsManager;
 exports.SnapshotManager = SnapshotManager;
 exports.ThreeJSResourceManager = ThreeJSResourceManager;
 exports.applyCrossComponentBehaviors = applyCrossComponentBehaviors;
+exports.applyDefaultIoDeviceStates = applyDefaultIoDeviceStates;
+exports.applyModelRootTranslation = applyModelRootTranslation;
+exports.applyModelRootTranslationFromWorldBase = applyModelRootTranslationFromWorldBase;
 exports.buildCrossBehavior = buildCrossBehavior;
 exports.buildIntraBehavior = buildIntraBehavior;
 exports.cacheJsonData = cacheJsonData;
@@ -49376,6 +49502,7 @@ exports.loadTextureSetAndCreateMaterial = loadTextureSetAndCreateMaterial;
 exports.markAsComputed = markAsComputed;
 exports.markAsDeclared = markAsDeclared;
 exports.measureS3Transfer = measureS3Transfer;
+exports.modelOffsetToWorldDelta = modelOffsetToWorldDelta;
 exports.modelPreloader = modelPreloader;
 exports.normalizeBehavior = normalizeBehavior;
 exports.parseCrossBehavior = parseCrossBehavior;
@@ -49389,6 +49516,7 @@ exports.removeCachedJsonData = removeCachedJsonData;
 exports.reregisterSceneBehaviors = reregisterSceneBehaviors;
 exports.resetCacheIdentity = resetCacheIdentity;
 exports.resetGlobalCacheStats = resetGlobalCacheStats;
+exports.resolveAnimationDefaultValue = resolveAnimationDefaultValue;
 exports.resolveDataPoints = resolveDataPoints;
 exports.s3MetadataCache = s3MetadataCache;
 exports.scanSceneIoEndpoints = scanSceneIoEndpoints;

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

@@ -37,7 +37,7 @@ var CentralPlant = /*#__PURE__*/function (_BaseDisposable) {
    * Initialize the CentralPlant manager
    * 
    * @constructor
-   * @version 0.3.39
+   * @version 0.3.42
    * @updated 2025-10-22
    * 
    * @description Creates a new CentralPlant instance and initializes internal managers and utilities.

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

@@ -916,7 +916,8 @@ var CentralPlantInternals = /*#__PURE__*/function () {
   }, {
     key: "addComponent",
     value: function addComponent(libraryId) {
-      var _this$centralPlant$sc6;
+      var _this$centralPlant$sc6,
+        _this2 = this;
       var options = arguments.length > 1 && arguments[1] !== undefined ? arguments[1] : {};
       // Use centralized validation for component addition parameters
       var existingIds = this.getComponentIds();
@@ -1153,7 +1154,7 @@ var CentralPlantInternals = /*#__PURE__*/function () {
           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;
           ioDeviceUtils.attachIODevicesToComponent(componentModel, componentData, modelPreloader, componentId).then(function () {
             if (ioBehavMgr) {
-              behaviorRegistration.registerBehaviorsForComponent(ioBehavMgr, componentId, componentData, componentModel, modelPreloader.componentDictionary);
+              behaviorRegistration.registerBehaviorsForComponent(ioBehavMgr, componentId, componentData, componentModel, modelPreloader.componentDictionary, _this2.centralPlant);
             }
           }).catch(function (err) {
             console.error("\u274C Error attaching IO devices for ".concat(libraryId, ":"), err);

package/dist/cjs/src/index.js

@@ -18,6 +18,7 @@ var behaviorSchema = require('./utils/behaviorSchema.js');
 var behaviorRegistration = require('./utils/behaviorRegistration.js');
 var behaviorDispatch = require('./utils/behaviorDispatch.js');
 var behaviorSceneUtils = require('./utils/behaviorSceneUtils.js');
+var animationTransformUtils = require('./utils/animationTransformUtils.js');
 var componentManager = require('./managers/components/componentManager.js');
 var animationManager = require('./managers/scene/animationManager.js');
 var pathfindingManager = require('./managers/pathfinding/pathfindingManager.js');
@@ -77,8 +78,10 @@ exports.buildIntraBehavior = behaviorSchema.buildIntraBehavior;
 exports.normalizeBehavior = behaviorSchema.normalizeBehavior;
 exports.parseCrossBehavior = behaviorSchema.parseCrossBehavior;
 exports.parseIntraBehavior = behaviorSchema.parseIntraBehavior;
+exports.resolveAnimationDefaultValue = behaviorSchema.resolveAnimationDefaultValue;
 exports.registerBehaviorsForComponent = behaviorRegistration.registerBehaviorsForComponent;
 exports.reloadBehaviorsForDeviceAsset = behaviorRegistration.reloadBehaviorsForDeviceAsset;
+exports.applyDefaultIoDeviceStates = behaviorDispatch.applyDefaultIoDeviceStates;
 exports.getIoBehaviorManager = behaviorDispatch.getIoBehaviorManager;
 exports.getScopedAttachmentKey = behaviorDispatch.getScopedAttachmentKey;
 exports.resolveDataPoints = behaviorDispatch.resolveDataPoints;
@@ -87,6 +90,9 @@ exports.loadCrossComponentBehaviors = behaviorSceneUtils.loadCrossComponentBehav
 exports.refreshSceneIntraBehaviors = behaviorSceneUtils.refreshSceneIntraBehaviors;
 exports.reregisterSceneBehaviors = behaviorSceneUtils.reregisterSceneBehaviors;
 exports.scanSceneIoEndpoints = behaviorSceneUtils.scanSceneIoEndpoints;
+exports.applyModelRootTranslation = animationTransformUtils.applyModelRootTranslation;
+exports.applyModelRootTranslationFromWorldBase = animationTransformUtils.applyModelRootTranslationFromWorldBase;
+exports.modelOffsetToWorldDelta = animationTransformUtils.modelOffsetToWorldDelta;
 exports.ComponentManager = componentManager.ComponentManager;
 exports.AnimationManager = animationManager.AnimationManager;
 exports.PathfindingManager = pathfindingManager.PathfindingManager;

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

@@ -619,18 +619,7 @@ var IoBehaviorManager = /*#__PURE__*/function (_BaseDisposable) {
               stateConfig.max = Math.max.apply(Math, _rollupPluginBabelHelpers.toConsumableArray(nums));
             }
           }
-
-          // Sensible default values
-          var defaultValue = void 0;
-          if (stateType === 'binary') {
-            defaultValue = 0;
-          } else if (stateType === 'enum') {
-            var _stateConfig$options$, _stateConfig$options;
-            defaultValue = (_stateConfig$options$ = (_stateConfig$options = stateConfig.options) === null || _stateConfig$options === void 0 ? void 0 : _stateConfig$options[0]) !== null && _stateConfig$options$ !== void 0 ? _stateConfig$options$ : '';
-          } else {
-            var _stateConfig$min;
-            defaultValue = (_stateConfig$min = stateConfig.min) !== null && _stateConfig$min !== void 0 ? _stateConfig$min : 0;
-          }
+          var defaultValue = behaviorSchema.resolveAnimationDefaultValue(_anim);
           dps.push({
             id: stateVar,
             name: _anim.name || stateVar,

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

@@ -78,7 +78,7 @@ var ModelManager = /*#__PURE__*/function () {
     key: "loadLibraryModel",
     value: function () {
       var _loadLibraryModel = _rollupPluginBabelHelpers.asyncToGenerator(/*#__PURE__*/_rollupPluginBabelHelpers.regenerator().m(function _callee(targetMesh, jsonEntry, componentData) {
-        var component, _jsonEntry$userData, _jsonEntry$userData2, _jsonEntry$userData3, originalProps, connectorChildren, gltfScene, libraryModel, _this$sceneViewer, ioBehavMgr, warmFn, _jsonEntry$userData4, _t;
+        var component, _jsonEntry$userData, _jsonEntry$userData2, _jsonEntry$userData3, originalProps, connectorChildren, gltfScene, libraryModel, _this$sceneViewer, ioBehavMgr, _this$sceneViewer2, warmFn, _jsonEntry$userData4, _t;
         return _rollupPluginBabelHelpers.regenerator().w(function (_context) {
           while (1) switch (_context.n) {
             case 0:
@@ -123,7 +123,7 @@ var ModelManager = /*#__PURE__*/function () {
             case 4:
               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) {
-                behaviorRegistration.registerBehaviorsForComponent(ioBehavMgr, originalProps.uuid, componentData, libraryModel, modelPreloader["default"].componentDictionary);
+                behaviorRegistration.registerBehaviorsForComponent(ioBehavMgr, originalProps.uuid, componentData, libraryModel, modelPreloader["default"].componentDictionary, (_this$sceneViewer2 = this.sceneViewer) === null || _this$sceneViewer2 === void 0 ? void 0 : _this$sceneViewer2.centralPlant);
               }
             case 5:
               // Replace mesh in scene

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

@@ -62,5 +62,21 @@ function applyModelRootTranslation(mesh, modelRoot, origLocalPos, modelOffset) {
   mesh.position.copy(newWorldPos);
 }
 
+/**
+ * Apply a model-root-space translation from a cached rest world position (preview).
+ *
+ * @param {THREE.Object3D} mesh
+ * @param {THREE.Object3D} modelRoot
+ * @param {THREE.Vector3} baseWorldPos
+ * @param {{ x?: number, y?: number, z?: number }} modelOffset
+ */
+function applyModelRootTranslationFromWorldBase(mesh, modelRoot, baseWorldPos, modelOffset) {
+  if (!mesh || !modelRoot || !baseWorldPos) return;
+  var newWorldPos = baseWorldPos.clone().add(modelOffsetToWorldDelta(modelRoot, modelOffset));
+  if (mesh.parent) mesh.parent.worldToLocal(newWorldPos);
+  mesh.position.copy(newWorldPos);
+}
+
 exports.applyModelRootTranslation = applyModelRootTranslation;
+exports.applyModelRootTranslationFromWorldBase = applyModelRootTranslationFromWorldBase;
 exports.modelOffsetToWorldDelta = modelOffsetToWorldDelta;

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

@@ -2,6 +2,8 @@
 
 Object.defineProperty(exports, '__esModule', { value: true });
 
+var _rollupPluginBabelHelpers = require('../../_virtual/_rollupPluginBabelHelpers.js');
+
 /**
  * Shared I/O device state dispatch helpers used by centralPlant and componentTooltipManager.
  */
@@ -57,6 +59,68 @@ function resolveDataPoints(parentUuid, attachmentId, userData, ioBehaviorManager
   });
 }
 
+/**
+ * Apply persisted default values for I/O device animation states in the live scene.
+ * Updates the state adapter (e.g. Vuex) and drives mesh animations via IoBehaviorManager.
+ *
+ * @param {Object} centralPlant
+ * @param {{ parentUuid?: string, attachmentId?: string }} [options]
+ */
+function applyDefaultIoDeviceStates(centralPlant) {
+  var _centralPlant$sceneVi;
+  var options = arguments.length > 1 && arguments[1] !== undefined ? arguments[1] : {};
+  var parentUuid = options.parentUuid,
+    attachmentId = options.attachmentId;
+  var ioBehavMgr = getIoBehaviorManager(centralPlant === null || centralPlant === void 0 ? void 0 : centralPlant.sceneViewer);
+  var scene = centralPlant === null || centralPlant === void 0 || (_centralPlant$sceneVi = centralPlant.sceneViewer) === null || _centralPlant$sceneVi === void 0 ? void 0 : _centralPlant$sceneVi.scene;
+  if (!ioBehavMgr || !scene || typeof (centralPlant === null || centralPlant === void 0 ? void 0 : centralPlant.setIoDeviceState) !== 'function') return;
+  var seen = new Set();
+  scene.traverse(function (obj) {
+    var _obj$userData, _obj$parent;
+    if (((_obj$userData = obj.userData) === null || _obj$userData === void 0 ? void 0 : _obj$userData.objectType) !== 'io-device') return;
+    var objParentUuid = obj.userData.parentComponentId || ((_obj$parent = obj.parent) === null || _obj$parent === void 0 ? void 0 : _obj$parent.uuid);
+    var objAttachmentId = obj.userData.attachmentId;
+    if (!objParentUuid || !objAttachmentId) return;
+    if (parentUuid && objParentUuid !== parentUuid) return;
+    if (attachmentId && objAttachmentId !== attachmentId) return;
+    var scopedKey = getScopedAttachmentKey(objAttachmentId, objParentUuid);
+    if (seen.has(scopedKey)) return;
+    seen.add(scopedKey);
+    var dps = ioBehavMgr.getAnimationDataPoints(objParentUuid, objAttachmentId) || [];
+    if (dps.length) {
+      var _iterator = _rollupPluginBabelHelpers.createForOfIteratorHelper(dps),
+        _step;
+      try {
+        for (_iterator.s(); !(_step = _iterator.n()).done;) {
+          var dp = _step.value;
+          if (!(dp !== null && dp !== void 0 && dp.id) || dp.defaultValue === undefined || dp.defaultValue === null) continue;
+          centralPlant.setIoDeviceState(objAttachmentId, dp.id, dp.defaultValue, objParentUuid);
+        }
+      } catch (err) {
+        _iterator.e(err);
+      } finally {
+        _iterator.f();
+      }
+      return;
+    }
+    var _iterator2 = _rollupPluginBabelHelpers.createForOfIteratorHelper(obj.userData.dataPoints || []),
+      _step2;
+    try {
+      for (_iterator2.s(); !(_step2 = _iterator2.n()).done;) {
+        var _dp = _step2.value;
+        var dpId = _dp.id || _dp.name;
+        if (!dpId || _dp.defaultValue === undefined || _dp.defaultValue === null) continue;
+        centralPlant.setIoDeviceState(objAttachmentId, dpId, _dp.defaultValue, objParentUuid);
+      }
+    } catch (err) {
+      _iterator2.e(err);
+    } finally {
+      _iterator2.f();
+    }
+  });
+}
+
+exports.applyDefaultIoDeviceStates = applyDefaultIoDeviceStates;
 exports.getIoBehaviorManager = getIoBehaviorManager;
 exports.getScopedAttachmentKey = getScopedAttachmentKey;
 exports.resolveDataPoints = resolveDataPoints;

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

@@ -3,6 +3,7 @@
 Object.defineProperty(exports, '__esModule', { value: true });
 
 var _rollupPluginBabelHelpers = require('../../_virtual/_rollupPluginBabelHelpers.js');
+var behaviorDispatch = require('./behaviorDispatch.js');
 
 /**
  * Register mesh animations and intra-component state links when a smart
@@ -13,8 +14,9 @@ var _rollupPluginBabelHelpers = require('../../_virtual/_rollupPluginBabelHelper
  * @param {Object} componentData - Smart component dictionary entry
  * @param {Object} componentModel - Root THREE.Object3D of the placed component
  * @param {Object} componentDictionary - modelPreloader.componentDictionary
+ * @param {Object} [centralPlant] - When provided, default animation states are applied after registration
  */
-function registerBehaviorsForComponent(ioBehavMgr, componentUuid, componentData, componentModel, componentDictionary) {
+function registerBehaviorsForComponent(ioBehavMgr, componentUuid, componentData, componentModel, componentDictionary, centralPlant) {
   var _componentData$behavi;
   if (!ioBehavMgr || !componentData || !componentModel) {
     return;
@@ -44,6 +46,11 @@ function registerBehaviorsForComponent(ioBehavMgr, componentUuid, componentData,
   } else if (componentData.isSmart) {
     ioBehavMgr.registerComponentBehaviors(componentUuid, []);
   }
+  if (centralPlant) {
+    behaviorDispatch.applyDefaultIoDeviceStates(centralPlant, {
+      parentUuid: componentUuid
+    });
+  }
 }
 
 /**
@@ -69,6 +76,10 @@ function reloadBehaviorsForDeviceAsset(ioBehavMgr, deviceAssetId, componentDicti
     if (!parentUuid || !attachmentId) return;
     ioBehavMgr.unloadForAttachment(parentUuid, attachmentId);
     ioBehavMgr.loadBehaviors(attachmentId, deviceData.behaviorConfig, obj, parentUuid);
+    behaviorDispatch.applyDefaultIoDeviceStates(centralPlant, {
+      parentUuid: parentUuid,
+      attachmentId: attachmentId
+    });
   });
 }
 

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

@@ -144,7 +144,7 @@ function reregisterSceneBehaviors(centralPlant) {
     if (!libraryId) return;
     var componentData = dict[libraryId];
     if (!componentData) return;
-    behaviorRegistration.registerBehaviorsForComponent(ioBehavMgr, obj.uuid, componentData, obj, dict);
+    behaviorRegistration.registerBehaviorsForComponent(ioBehavMgr, obj.uuid, componentData, obj, dict, centralPlant);
   });
 }
 

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

@@ -202,8 +202,56 @@ function parseCrossBehavior(behavior) {
   };
 }
 
+/**
+ * Resolve the runtime default value for an animation behavior entry.
+ * Uses explicit `defaultValue` when present; otherwise infers from stateType and mappings.
+ *
+ * @param {Object} anim - Behavior entry from behaviorConfig
+ * @returns {boolean|string|number}
+ */
+function resolveAnimationDefaultValue(anim) {
+  var _anim$stateConfig2, _anim$stateConfig3;
+  if (!anim) return null;
+  var rawType = (anim.stateType || '').toLowerCase();
+  var isBinary = rawType === 'binary' || rawType === 'boolean';
+  var isEnum = rawType === 'enum';
+  if (anim.defaultValue !== undefined && anim.defaultValue !== null) {
+    if (isBinary) return !!anim.defaultValue;
+    if (isEnum) return String(anim.defaultValue);
+    var n = Number(anim.defaultValue);
+    return Number.isNaN(n) ? 0 : n;
+  }
+  if (isBinary) return false;
+  if (isEnum) {
+    var _anim$stateConfig, _resolved$;
+    var _mappingValues = (anim.mappings || []).map(function (m) {
+      return m.stateValue;
+    }).filter(function (v) {
+      return v !== '' && v != null;
+    });
+    var options = (((_anim$stateConfig = anim.stateConfig) === null || _anim$stateConfig === void 0 ? void 0 : _anim$stateConfig.options) || []).filter(function (o) {
+      return o !== '';
+    });
+    var resolved = options.length ? options : _rollupPluginBabelHelpers.toConsumableArray(new Set(_mappingValues.map(String)));
+    return (_resolved$ = resolved[0]) !== null && _resolved$ !== void 0 ? _resolved$ : '';
+  }
+  var mappingValues = (anim.mappings || []).map(function (m) {
+    return m.stateValue;
+  });
+  var nums = mappingValues.map(Number).filter(function (n) {
+    return !Number.isNaN(n);
+  });
+  if (nums.length) return Math.min.apply(Math, _rollupPluginBabelHelpers.toConsumableArray(nums));
+  if (((_anim$stateConfig2 = anim.stateConfig) === null || _anim$stateConfig2 === void 0 ? void 0 : _anim$stateConfig2.min) !== undefined && ((_anim$stateConfig3 = anim.stateConfig) === null || _anim$stateConfig3 === void 0 ? void 0 : _anim$stateConfig3.min) !== null) {
+    var min = Number(anim.stateConfig.min);
+    return Number.isNaN(min) ? 0 : min;
+  }
+  return 0;
+}
+
 exports.buildCrossBehavior = buildCrossBehavior;
 exports.buildIntraBehavior = buildIntraBehavior;
 exports.normalizeBehavior = normalizeBehavior;
 exports.parseCrossBehavior = parseCrossBehavior;
 exports.parseIntraBehavior = parseIntraBehavior;
+exports.resolveAnimationDefaultValue = resolveAnimationDefaultValue;

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

@@ -33,7 +33,7 @@ var CentralPlant = /*#__PURE__*/function (_BaseDisposable) {
    * Initialize the CentralPlant manager
    * 
    * @constructor
-   * @version 0.3.39
+   * @version 0.3.42
    * @updated 2025-10-22
    * 
    * @description Creates a new CentralPlant instance and initializes internal managers and utilities.

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

@@ -892,7 +892,8 @@ var CentralPlantInternals = /*#__PURE__*/function () {
   }, {
     key: "addComponent",
     value: function addComponent(libraryId) {
-      var _this$centralPlant$sc6;
+      var _this$centralPlant$sc6,
+        _this2 = this;
       var options = arguments.length > 1 && arguments[1] !== undefined ? arguments[1] : {};
       // Use centralized validation for component addition parameters
       var existingIds = this.getComponentIds();
@@ -1129,7 +1130,7 @@ var CentralPlantInternals = /*#__PURE__*/function () {
           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;
           attachIODevicesToComponent(componentModel, componentData, modelPreloader, componentId).then(function () {
             if (ioBehavMgr) {
-              registerBehaviorsForComponent(ioBehavMgr, componentId, componentData, componentModel, modelPreloader.componentDictionary);
+              registerBehaviorsForComponent(ioBehavMgr, componentId, componentData, componentModel, modelPreloader.componentDictionary, _this2.centralPlant);
             }
           }).catch(function (err) {
             console.error("\u274C Error attaching IO devices for ".concat(libraryId, ":"), err);

package/dist/esm/src/index.js

@@ -10,10 +10,11 @@ export { SceneTooltipsManager } from './managers/scene/sceneTooltipsManager.js';
 export { ComponentTooltipManager } from './managers/scene/componentTooltipManager.js';
 export { SceneHierarchyManager } from './managers/scene/sceneHierarchyManager.js';
 export { IoBehaviorManager } from './managers/behaviors/IoBehaviorManager.js';
-export { buildCrossBehavior, buildIntraBehavior, normalizeBehavior, parseCrossBehavior, parseIntraBehavior } from './utils/behaviorSchema.js';
+export { buildCrossBehavior, buildIntraBehavior, normalizeBehavior, parseCrossBehavior, parseIntraBehavior, resolveAnimationDefaultValue } from './utils/behaviorSchema.js';
 export { registerBehaviorsForComponent, reloadBehaviorsForDeviceAsset } from './utils/behaviorRegistration.js';
-export { getIoBehaviorManager, getScopedAttachmentKey, resolveDataPoints } from './utils/behaviorDispatch.js';
+export { applyDefaultIoDeviceStates, getIoBehaviorManager, getScopedAttachmentKey, resolveDataPoints } from './utils/behaviorDispatch.js';
 export { applyCrossComponentBehaviors, loadCrossComponentBehaviors, refreshSceneIntraBehaviors, reregisterSceneBehaviors, scanSceneIoEndpoints } from './utils/behaviorSceneUtils.js';
+export { applyModelRootTranslation, applyModelRootTranslationFromWorldBase, modelOffsetToWorldDelta } from './utils/animationTransformUtils.js';
 export { ComponentManager } from './managers/components/componentManager.js';
 export { AnimationManager } from './managers/scene/animationManager.js';
 export { PathfindingManager } from './managers/pathfinding/pathfindingManager.js';

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

@@ -1,7 +1,7 @@
 import { inherits as _inherits, createClass as _createClass, createForOfIteratorHelper as _createForOfIteratorHelper, slicedToArray as _slicedToArray, toConsumableArray as _toConsumableArray, superPropGet as _superPropGet, classCallCheck as _classCallCheck, callSuper as _callSuper } from '../../../_virtual/_rollupPluginBabelHelpers.js';
 import * as THREE from 'three';
 import { BaseDisposable } from '../../core/baseDisposable.js';
-import { normalizeBehavior } from '../../utils/behaviorSchema.js';
+import { normalizeBehavior, resolveAnimationDefaultValue } from '../../utils/behaviorSchema.js';
 import { getScopedAttachmentKey } from '../../utils/behaviorDispatch.js';
 import { applyModelRootTranslation } from '../../utils/animationTransformUtils.js';
 
@@ -595,18 +595,7 @@ var IoBehaviorManager = /*#__PURE__*/function (_BaseDisposable) {
               stateConfig.max = Math.max.apply(Math, _toConsumableArray(nums));
             }
           }
-
-          // Sensible default values
-          var defaultValue = void 0;
-          if (stateType === 'binary') {
-            defaultValue = 0;
-          } else if (stateType === 'enum') {
-            var _stateConfig$options$, _stateConfig$options;
-            defaultValue = (_stateConfig$options$ = (_stateConfig$options = stateConfig.options) === null || _stateConfig$options === void 0 ? void 0 : _stateConfig$options[0]) !== null && _stateConfig$options$ !== void 0 ? _stateConfig$options$ : '';
-          } else {
-            var _stateConfig$min;
-            defaultValue = (_stateConfig$min = stateConfig.min) !== null && _stateConfig$min !== void 0 ? _stateConfig$min : 0;
-          }
+          var defaultValue = resolveAnimationDefaultValue(_anim);
           dps.push({
             id: stateVar,
             name: _anim.name || stateVar,

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

@@ -54,7 +54,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, ioBehavMgr, warmFn, _jsonEntry$userData4, _t;
+        var component, _jsonEntry$userData, _jsonEntry$userData2, _jsonEntry$userData3, originalProps, connectorChildren, gltfScene, libraryModel, _this$sceneViewer, ioBehavMgr, _this$sceneViewer2, warmFn, _jsonEntry$userData4, _t;
         return _regenerator().w(function (_context) {
           while (1) switch (_context.n) {
             case 0:
@@ -99,7 +99,7 @@ var ModelManager = /*#__PURE__*/function () {
             case 4:
               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) {
-                registerBehaviorsForComponent(ioBehavMgr, originalProps.uuid, componentData, libraryModel, modelPreloader.componentDictionary);
+                registerBehaviorsForComponent(ioBehavMgr, originalProps.uuid, componentData, libraryModel, modelPreloader.componentDictionary, (_this$sceneViewer2 = this.sceneViewer) === null || _this$sceneViewer2 === void 0 ? void 0 : _this$sceneViewer2.centralPlant);
               }
             case 5:
               // Replace mesh in scene

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

@@ -38,4 +38,19 @@ function applyModelRootTranslation(mesh, modelRoot, origLocalPos, modelOffset) {
   mesh.position.copy(newWorldPos);
 }
 
-export { applyModelRootTranslation, modelOffsetToWorldDelta };
+/**
+ * Apply a model-root-space translation from a cached rest world position (preview).
+ *
+ * @param {THREE.Object3D} mesh
+ * @param {THREE.Object3D} modelRoot
+ * @param {THREE.Vector3} baseWorldPos
+ * @param {{ x?: number, y?: number, z?: number }} modelOffset
+ */
+function applyModelRootTranslationFromWorldBase(mesh, modelRoot, baseWorldPos, modelOffset) {
+  if (!mesh || !modelRoot || !baseWorldPos) return;
+  var newWorldPos = baseWorldPos.clone().add(modelOffsetToWorldDelta(modelRoot, modelOffset));
+  if (mesh.parent) mesh.parent.worldToLocal(newWorldPos);
+  mesh.position.copy(newWorldPos);
+}
+
+export { applyModelRootTranslation, applyModelRootTranslationFromWorldBase, modelOffsetToWorldDelta };

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

@@ -1,3 +1,5 @@
+import { createForOfIteratorHelper as _createForOfIteratorHelper } from '../../_virtual/_rollupPluginBabelHelpers.js';
+
 /**
  * Shared I/O device state dispatch helpers used by centralPlant and componentTooltipManager.
  */
@@ -53,4 +55,65 @@ function resolveDataPoints(parentUuid, attachmentId, userData, ioBehaviorManager
   });
 }
 
-export { getIoBehaviorManager, getScopedAttachmentKey, resolveDataPoints };
+/**
+ * Apply persisted default values for I/O device animation states in the live scene.
+ * Updates the state adapter (e.g. Vuex) and drives mesh animations via IoBehaviorManager.
+ *
+ * @param {Object} centralPlant
+ * @param {{ parentUuid?: string, attachmentId?: string }} [options]
+ */
+function applyDefaultIoDeviceStates(centralPlant) {
+  var _centralPlant$sceneVi;
+  var options = arguments.length > 1 && arguments[1] !== undefined ? arguments[1] : {};
+  var parentUuid = options.parentUuid,
+    attachmentId = options.attachmentId;
+  var ioBehavMgr = getIoBehaviorManager(centralPlant === null || centralPlant === void 0 ? void 0 : centralPlant.sceneViewer);
+  var scene = centralPlant === null || centralPlant === void 0 || (_centralPlant$sceneVi = centralPlant.sceneViewer) === null || _centralPlant$sceneVi === void 0 ? void 0 : _centralPlant$sceneVi.scene;
+  if (!ioBehavMgr || !scene || typeof (centralPlant === null || centralPlant === void 0 ? void 0 : centralPlant.setIoDeviceState) !== 'function') return;
+  var seen = new Set();
+  scene.traverse(function (obj) {
+    var _obj$userData, _obj$parent;
+    if (((_obj$userData = obj.userData) === null || _obj$userData === void 0 ? void 0 : _obj$userData.objectType) !== 'io-device') return;
+    var objParentUuid = obj.userData.parentComponentId || ((_obj$parent = obj.parent) === null || _obj$parent === void 0 ? void 0 : _obj$parent.uuid);
+    var objAttachmentId = obj.userData.attachmentId;
+    if (!objParentUuid || !objAttachmentId) return;
+    if (parentUuid && objParentUuid !== parentUuid) return;
+    if (attachmentId && objAttachmentId !== attachmentId) return;
+    var scopedKey = getScopedAttachmentKey(objAttachmentId, objParentUuid);
+    if (seen.has(scopedKey)) return;
+    seen.add(scopedKey);
+    var dps = ioBehavMgr.getAnimationDataPoints(objParentUuid, objAttachmentId) || [];
+    if (dps.length) {
+      var _iterator = _createForOfIteratorHelper(dps),
+        _step;
+      try {
+        for (_iterator.s(); !(_step = _iterator.n()).done;) {
+          var dp = _step.value;
+          if (!(dp !== null && dp !== void 0 && dp.id) || dp.defaultValue === undefined || dp.defaultValue === null) continue;
+          centralPlant.setIoDeviceState(objAttachmentId, dp.id, dp.defaultValue, objParentUuid);
+        }
+      } catch (err) {
+        _iterator.e(err);
+      } finally {
+        _iterator.f();
+      }
+      return;
+    }
+    var _iterator2 = _createForOfIteratorHelper(obj.userData.dataPoints || []),
+      _step2;
+    try {
+      for (_iterator2.s(); !(_step2 = _iterator2.n()).done;) {
+        var _dp = _step2.value;
+        var dpId = _dp.id || _dp.name;
+        if (!dpId || _dp.defaultValue === undefined || _dp.defaultValue === null) continue;
+        centralPlant.setIoDeviceState(objAttachmentId, dpId, _dp.defaultValue, objParentUuid);
+      }
+    } catch (err) {
+      _iterator2.e(err);
+    } finally {
+      _iterator2.f();
+    }
+  });
+}
+
+export { applyDefaultIoDeviceStates, getIoBehaviorManager, getScopedAttachmentKey, resolveDataPoints };

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

@@ -1,4 +1,5 @@
 import { slicedToArray as _slicedToArray } from '../../_virtual/_rollupPluginBabelHelpers.js';
+import { applyDefaultIoDeviceStates } from './behaviorDispatch.js';
 
 /**
  * Register mesh animations and intra-component state links when a smart
@@ -9,8 +10,9 @@ import { slicedToArray as _slicedToArray } from '../../_virtual/_rollupPluginBab
  * @param {Object} componentData - Smart component dictionary entry
  * @param {Object} componentModel - Root THREE.Object3D of the placed component
  * @param {Object} componentDictionary - modelPreloader.componentDictionary
+ * @param {Object} [centralPlant] - When provided, default animation states are applied after registration
  */
-function registerBehaviorsForComponent(ioBehavMgr, componentUuid, componentData, componentModel, componentDictionary) {
+function registerBehaviorsForComponent(ioBehavMgr, componentUuid, componentData, componentModel, componentDictionary, centralPlant) {
   var _componentData$behavi;
   if (!ioBehavMgr || !componentData || !componentModel) {
     return;
@@ -40,6 +42,11 @@ function registerBehaviorsForComponent(ioBehavMgr, componentUuid, componentData,
   } else if (componentData.isSmart) {
     ioBehavMgr.registerComponentBehaviors(componentUuid, []);
   }
+  if (centralPlant) {
+    applyDefaultIoDeviceStates(centralPlant, {
+      parentUuid: componentUuid
+    });
+  }
 }
 
 /**
@@ -65,6 +72,10 @@ function reloadBehaviorsForDeviceAsset(ioBehavMgr, deviceAssetId, componentDicti
     if (!parentUuid || !attachmentId) return;
     ioBehavMgr.unloadForAttachment(parentUuid, attachmentId);
     ioBehavMgr.loadBehaviors(attachmentId, deviceData.behaviorConfig, obj, parentUuid);
+    applyDefaultIoDeviceStates(centralPlant, {
+      parentUuid: parentUuid,
+      attachmentId: attachmentId
+    });
   });
 }
 

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

@@ -140,7 +140,7 @@ function reregisterSceneBehaviors(centralPlant) {
     if (!libraryId) return;
     var componentData = dict[libraryId];
     if (!componentData) return;
-    registerBehaviorsForComponent(ioBehavMgr, obj.uuid, componentData, obj, dict);
+    registerBehaviorsForComponent(ioBehavMgr, obj.uuid, componentData, obj, dict, centralPlant);
   });
 }
 

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

@@ -1,4 +1,4 @@
-import { objectSpread2 as _objectSpread2, slicedToArray as _slicedToArray, typeof as _typeof } from '../../_virtual/_rollupPluginBabelHelpers.js';
+import { objectSpread2 as _objectSpread2, slicedToArray as _slicedToArray, typeof as _typeof, toConsumableArray as _toConsumableArray } from '../../_virtual/_rollupPluginBabelHelpers.js';
 
 /**
  * Shared behavior schema helpers for runtime normalization and UI authoring.
@@ -198,4 +198,51 @@ function parseCrossBehavior(behavior) {
   };
 }
 
-export { buildCrossBehavior, buildIntraBehavior, normalizeBehavior, parseCrossBehavior, parseIntraBehavior };
+/**
+ * Resolve the runtime default value for an animation behavior entry.
+ * Uses explicit `defaultValue` when present; otherwise infers from stateType and mappings.
+ *
+ * @param {Object} anim - Behavior entry from behaviorConfig
+ * @returns {boolean|string|number}
+ */
+function resolveAnimationDefaultValue(anim) {
+  var _anim$stateConfig2, _anim$stateConfig3;
+  if (!anim) return null;
+  var rawType = (anim.stateType || '').toLowerCase();
+  var isBinary = rawType === 'binary' || rawType === 'boolean';
+  var isEnum = rawType === 'enum';
+  if (anim.defaultValue !== undefined && anim.defaultValue !== null) {
+    if (isBinary) return !!anim.defaultValue;
+    if (isEnum) return String(anim.defaultValue);
+    var n = Number(anim.defaultValue);
+    return Number.isNaN(n) ? 0 : n;
+  }
+  if (isBinary) return false;
+  if (isEnum) {
+    var _anim$stateConfig, _resolved$;
+    var _mappingValues = (anim.mappings || []).map(function (m) {
+      return m.stateValue;
+    }).filter(function (v) {
+      return v !== '' && v != null;
+    });
+    var options = (((_anim$stateConfig = anim.stateConfig) === null || _anim$stateConfig === void 0 ? void 0 : _anim$stateConfig.options) || []).filter(function (o) {
+      return o !== '';
+    });
+    var resolved = options.length ? options : _toConsumableArray(new Set(_mappingValues.map(String)));
+    return (_resolved$ = resolved[0]) !== null && _resolved$ !== void 0 ? _resolved$ : '';
+  }
+  var mappingValues = (anim.mappings || []).map(function (m) {
+    return m.stateValue;
+  });
+  var nums = mappingValues.map(Number).filter(function (n) {
+    return !Number.isNaN(n);
+  });
+  if (nums.length) return Math.min.apply(Math, _toConsumableArray(nums));
+  if (((_anim$stateConfig2 = anim.stateConfig) === null || _anim$stateConfig2 === void 0 ? void 0 : _anim$stateConfig2.min) !== undefined && ((_anim$stateConfig3 = anim.stateConfig) === null || _anim$stateConfig3 === void 0 ? void 0 : _anim$stateConfig3.min) !== null) {
+    var min = Number(anim.stateConfig.min);
+    return Number.isNaN(min) ? 0 : min;
+  }
+  return 0;
+}
+
+export { buildCrossBehavior, buildIntraBehavior, normalizeBehavior, parseCrossBehavior, parseIntraBehavior, resolveAnimationDefaultValue };

package/dist/index.d.ts

@@ -52,7 +52,10 @@ export interface BehaviorEntry {
   meshUuid?: string
   meshName?: string
   stateVariable: string
-  stateType?: 'binary' | 'enum' | 'continuous' | 'number' | 'boolean'
+  stateType?: 'binary' | 'enum' | 'continuous' | 'number' | 'boolean' | 'range'
+  defaultValue?: boolean | string | number
+  useFormula?: boolean
+  stateConfig?: Record<string, unknown>
   transformTypes?: string[]
   rotAxis?: 'x' | 'y' | 'z'
   rotAxisOffset?: { x: number; y: number; z: number }
@@ -144,6 +147,7 @@ export declare function parseCrossBehavior(behavior: CrossComponentBehavior): {
   inputState: string
   outputs: Array<{ endpoint: string; state: string }>
 }
+export declare function resolveAnimationDefaultValue(anim: BehaviorEntry): boolean | string | number | null
 
 export declare function getScopedAttachmentKey(attachmentId: string, parentUuid?: string | null): string
 export declare function getIoBehaviorManager(sceneViewer: any): IoBehaviorManager | null
@@ -160,7 +164,13 @@ export declare function registerBehaviorsForComponent(
   componentUuid: string,
   componentData: SmartComponentAsset,
   componentModel: any,
-  componentDictionary: Record<string, any>
+  componentDictionary: Record<string, any>,
+  centralPlant?: any
+): void
+
+export declare function applyDefaultIoDeviceStates(
+  centralPlant: any,
+  options?: { parentUuid?: string; attachmentId?: string }
 ): void
 
 export declare function reloadBehaviorsForDeviceAsset(
@@ -176,6 +186,23 @@ export declare function loadCrossComponentBehaviors(centralPlant: any): CrossCom
 export declare function refreshSceneIntraBehaviors(centralPlant: any, libraryId: string, behaviors: CrossComponentBehavior[]): void
 export declare function reregisterSceneBehaviors(centralPlant: any): void
 
+export declare function modelOffsetToWorldDelta(
+  modelRoot: any,
+  offset: { x?: number; y?: number; z?: number } | { clone(): any }
+): any
+export declare function applyModelRootTranslation(
+  mesh: any,
+  modelRoot: any,
+  origLocalPos: any,
+  modelOffset: { x?: number; y?: number; z?: number }
+): void
+export declare function applyModelRootTranslationFromWorldBase(
+  mesh: any,
+  modelRoot: any,
+  baseWorldPos: any,
+  modelOffset: { x?: number; y?: number; z?: number }
+): void
+
 export declare class IoBehaviorManager {
   constructor(sceneViewer: any)
   loadBehaviors(attachmentId: string, behaviorConfig: BehaviorEntry[] | { behaviors: BehaviorEntry[] }, deviceModelRoot: any, parentUuid: string): void
@@ -290,7 +317,8 @@ export {
   buildIntraBehavior,
   parseIntraBehavior,
   buildCrossBehavior,
-  parseCrossBehavior
+  parseCrossBehavior,
+  resolveAnimationDefaultValue
 } from './utils/behaviorSchema.js';
 export {
   registerBehaviorsForComponent,
@@ -299,7 +327,8 @@ export {
 export {
   getScopedAttachmentKey,
   getIoBehaviorManager,
-  resolveDataPoints
+  resolveDataPoints,
+  applyDefaultIoDeviceStates
 } from './utils/behaviorDispatch.js';
 export {
   scanSceneIoEndpoints,

package/package.json

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