@2112-lab/central-plant 0.3.41 → 0.3.43

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

@@ -33,7 +33,7 @@ var CentralPlant = /*#__PURE__*/function (_BaseDisposable) {
    * Initialize the CentralPlant manager
    * 
    * @constructor
-   * @version 0.3.41
+   * @version 0.3.43
    * @updated 2025-10-22
    * 
    * @description Creates a new CentralPlant instance and initializes internal managers and utilities.
@@ -2525,7 +2525,7 @@ var CentralPlant = /*#__PURE__*/function (_BaseDisposable) {
     key: "importScene",
     value: (function () {
       var _importScene = _asyncToGenerator(/*#__PURE__*/_regenerator().m(function _callee10(jsonData) {
-        var validation, missingIds, resolved, _t4, _t5;
+        var validation, embeddedCount, missingIds, resolved, _t4, _t5;
         return _regenerator().w(function (_context10) {
           while (1) switch (_context10.n) {
             case 0:
@@ -2546,64 +2546,78 @@ var CentralPlant = /*#__PURE__*/function (_BaseDisposable) {
               console.error('❌ Invalid scene data format:', validation.message);
               return _context10.a(2, false);
             case 2:
+              if (!(jsonData.componentDefinitions && _typeof(jsonData.componentDefinitions) === 'object')) {
+                _context10.n = 4;
+                break;
+              }
+              embeddedCount = Object.keys(jsonData.componentDefinitions).length;
+              if (!(embeddedCount > 0)) {
+                _context10.n = 4;
+                break;
+              }
+              _context10.n = 3;
+              return this.extendComponentDictionary(jsonData.componentDefinitions);
+            case 3:
+              console.log("\uD83D\uDCE6 importScene(): Applied ".concat(embeddedCount, " embedded component definition(s)"));
+            case 4:
               if (!this._componentDefinitionResolver) {
-                _context10.n = 8;
+                _context10.n = 10;
                 break;
               }
               missingIds = this.getMissingLibraryIds(jsonData);
               if (!(missingIds.length > 0)) {
-                _context10.n = 8;
+                _context10.n = 10;
                 break;
               }
-              _context10.p = 3;
+              _context10.p = 5;
               console.log("\uD83D\uDD0D importScene(): Resolving ".concat(missingIds.length, " missing component definition(s)..."));
-              _context10.n = 4;
+              _context10.n = 6;
               return this._componentDefinitionResolver(missingIds);
-            case 4:
+            case 6:
               resolved = _context10.v;
               if (!(resolved && _typeof(resolved) === 'object' && Object.keys(resolved).length > 0)) {
-                _context10.n = 6;
+                _context10.n = 8;
                 break;
               }
-              _context10.n = 5;
+              _context10.n = 7;
               return this.extendComponentDictionary(resolved);
-            case 5:
+            case 7:
               console.log("\u2705 importScene(): Resolved ".concat(Object.keys(resolved).length, " component definition(s)"));
-            case 6:
-              _context10.n = 8;
+            case 8:
+              _context10.n = 10;
               break;
-            case 7:
-              _context10.p = 7;
+            case 9:
+              _context10.p = 9;
               _t4 = _context10.v;
               console.warn('⚠️ importScene(): Component definition resolver failed, continuing with existing dictionary:', _t4);
-            case 8:
-              _context10.n = 9;
+            case 10:
+              _context10.n = 11;
               return this.setImportedSceneData(jsonData);
-            case 9:
+            case 11:
               if (!(this.sceneViewer && this.sceneViewer.sceneOperationsManager)) {
-                _context10.n = 11;
+                _context10.n = 13;
                 break;
               }
-              _context10.n = 10;
+              _context10.n = 12;
               return this.sceneViewer.sceneOperationsManager.loadSceneFromData(jsonData);
-            case 10:
+            case 12:
               console.log('✅ Scene imported successfully');
               return _context10.a(2, true);
-            case 11:
+            case 13:
               console.error('❌ SceneViewer not available for scene loading');
               return _context10.a(2, false);
-            case 12:
-              _context10.n = 14;
+            case 14:
+              _context10.n = 16;
               break;
-            case 13:
-              _context10.p = 13;
+            case 15:
+              _context10.p = 15;
               _t5 = _context10.v;
               console.error('❌ Error importing scene:', _t5);
               return _context10.a(2, false);
-            case 14:
+            case 16:
               return _context10.a(2);
           }
-        }, _callee10, this, [[3, 7], [1, 13]]);
+        }, _callee10, this, [[5, 9], [1, 15]]);
       }));
       function importScene(_x6) {
         return _importScene.apply(this, arguments);

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 { collectSceneLibraryIds, embedComponentDefinitions, getComponentDictionary } from './utils/demoSceneUtils.js';
 export { applyModelRootTranslation, applyModelRootTranslationFromWorldBase, modelOffsetToWorldDelta } from './utils/animationTransformUtils.js';
 export { ComponentManager } from './managers/components/componentManager.js';
 export { AnimationManager } from './managers/scene/animationManager.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/controls/transformControls.js

@@ -490,8 +490,8 @@ var transformControls = /*#__PURE__*/function (_THREE$Object3D) {
   }, {
     key: "setMode",
     value: function setMode(mode) {
-      if (mode === 'scale') {
-        console.warn('transformControls: Scale mode has been removed. Using translate mode instead.');
+      if (mode !== 'translate') {
+        console.warn("transformControls: ".concat(mode, " mode is disabled. Locking to translate."));
         mode = 'translate';
       }
       this.mode = mode;

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

@@ -415,10 +415,6 @@ var TransformControlsManager = /*#__PURE__*/function () {
             // Translate mode
             _this3.setMode('translate');
             break;
-          case 'KeyR':
-            // Rotate mode
-            _this3.setMode('rotate');
-            break;
         }
       };
       window.addEventListener('keydown', this.eventHandlers.keydown);
@@ -1438,9 +1434,10 @@ var TransformControlsManager = /*#__PURE__*/function () {
   }, {
     key: "setMode",
     value: function setMode(mode) {
-      if (!['translate', 'rotate', 'scale'].includes(mode)) {
-        console.warn("\u26A0\uFE0F Invalid transform mode: ".concat(mode));
-        return;
+      // Only allow translate mode - lock rotation and scale controls
+      if (mode !== 'translate') {
+        console.warn("\u26A0\uFE0F Transform mode ".concat(mode, " is disabled. Locking to translate."));
+        mode = 'translate';
       }
       var previousMode = this.currentMode;
       this.currentMode = mode;

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

@@ -9,13 +9,14 @@ import * as THREE from 'three';
 /**
  * @param {THREE.Object3D} modelRoot
  * @param {{ x?: number, y?: number, z?: number }|THREE.Vector3} offset
+ * @param {THREE.Quaternion} [customQuat] - Optional override for model orientation
  * @returns {THREE.Vector3}
  */
-function modelOffsetToWorldDelta(modelRoot, offset) {
+function modelOffsetToWorldDelta(modelRoot, offset, customQuat) {
   var _offset$x, _offset$y, _offset$z;
   var v = offset instanceof THREE.Vector3 ? offset.clone() : new THREE.Vector3((_offset$x = offset === null || offset === void 0 ? void 0 : offset.x) !== null && _offset$x !== void 0 ? _offset$x : 0, (_offset$y = offset === null || offset === void 0 ? void 0 : offset.y) !== null && _offset$y !== void 0 ? _offset$y : 0, (_offset$z = offset === null || offset === void 0 ? void 0 : offset.z) !== null && _offset$z !== void 0 ? _offset$z : 0);
-  var q = new THREE.Quaternion();
-  modelRoot.getWorldQuaternion(q);
+  var q = customQuat ? customQuat.clone() : new THREE.Quaternion();
+  if (!customQuat) modelRoot.getWorldQuaternion(q);
   return v.applyQuaternion(q);
 }
 
@@ -26,14 +27,15 @@ function modelOffsetToWorldDelta(modelRoot, offset) {
  * @param {THREE.Object3D} modelRoot
  * @param {THREE.Vector3} origLocalPos
  * @param {{ x?: number, y?: number, z?: number }} modelOffset
+ * @param {THREE.Quaternion} [customQuat]
  */
-function applyModelRootTranslation(mesh, modelRoot, origLocalPos, modelOffset) {
+function applyModelRootTranslation(mesh, modelRoot, origLocalPos, modelOffset, customQuat) {
   if (!mesh || !modelRoot || !origLocalPos) return;
   mesh.position.copy(origLocalPos);
   mesh.updateMatrixWorld(true);
   var origWorldPos = new THREE.Vector3();
   mesh.getWorldPosition(origWorldPos);
-  var newWorldPos = origWorldPos.add(modelOffsetToWorldDelta(modelRoot, modelOffset));
+  var newWorldPos = origWorldPos.add(modelOffsetToWorldDelta(modelRoot, modelOffset, customQuat));
   if (mesh.parent) mesh.parent.worldToLocal(newWorldPos);
   mesh.position.copy(newWorldPos);
 }
@@ -45,10 +47,11 @@ function applyModelRootTranslation(mesh, modelRoot, origLocalPos, modelOffset) {
  * @param {THREE.Object3D} modelRoot
  * @param {THREE.Vector3} baseWorldPos
  * @param {{ x?: number, y?: number, z?: number }} modelOffset
+ * @param {THREE.Quaternion} [customQuat]
  */
-function applyModelRootTranslationFromWorldBase(mesh, modelRoot, baseWorldPos, modelOffset) {
+function applyModelRootTranslationFromWorldBase(mesh, modelRoot, baseWorldPos, modelOffset, customQuat) {
   if (!mesh || !modelRoot || !baseWorldPos) return;
-  var newWorldPos = baseWorldPos.clone().add(modelOffsetToWorldDelta(modelRoot, modelOffset));
+  var newWorldPos = baseWorldPos.clone().add(modelOffsetToWorldDelta(modelRoot, modelOffset, customQuat));
   if (mesh.parent) mesh.parent.worldToLocal(newWorldPos);
   mesh.position.copy(newWorldPos);
 }

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/esm/src/utils/demoSceneUtils.js

@@ -0,0 +1,85 @@
+import { typeof as _typeof, objectWithoutProperties as _objectWithoutProperties, objectSpread2 as _objectSpread2 } from '../../_virtual/_rollupPluginBabelHelpers.js';
+
+var _excluded = ["componentDefinitions"];
+/**
+ * Helpers for portable demo scene JSON (embedded component definitions).
+ */
+
+function cloneDefinition(def) {
+  if (!def || _typeof(def) !== 'object') return null;
+  try {
+    return JSON.parse(JSON.stringify(def));
+  } catch (_unused) {
+    return _objectSpread2({}, def);
+  }
+}
+
+/**
+ * Collect unique library IDs referenced by scene nodes.
+ * @param {Object} sceneData
+ * @returns {string[]}
+ */
+function collectSceneLibraryIds(sceneData) {
+  var _sceneData$scene;
+  var ids = new Set();
+  var _walk = function walk(nodes) {
+    if (!Array.isArray(nodes)) return;
+    nodes.forEach(function (node) {
+      var _node$userData;
+      var libraryId = node === null || node === void 0 || (_node$userData = node.userData) === null || _node$userData === void 0 ? void 0 : _node$userData.libraryId;
+      if (libraryId) ids.add(libraryId);
+      if (node.children) _walk(node.children);
+    });
+  };
+  _walk(sceneData === null || sceneData === void 0 || (_sceneData$scene = sceneData.scene) === null || _sceneData$scene === void 0 ? void 0 : _sceneData$scene.children);
+  return Array.from(ids);
+}
+
+/**
+ * Embed component/device definitions required by a scene into the JSON payload.
+ * @param {Object} sceneData
+ * @param {Record<string, Object>} componentDictionary
+ * @returns {Object}
+ */
+function embedComponentDefinitions(sceneData) {
+  var componentDictionary = arguments.length > 1 && arguments[1] !== undefined ? arguments[1] : {};
+  if (!sceneData || _typeof(sceneData) !== 'object') return sceneData;
+  var libraryIds = collectSceneLibraryIds(sceneData);
+  var componentDefinitions = {};
+  var deviceIds = new Set();
+  libraryIds.forEach(function (libraryId) {
+    var def = componentDictionary[libraryId];
+    if (!def) return;
+    componentDefinitions[libraryId] = cloneDefinition(def);
+    var attachedDevices = def.attachedDevices;
+    if (!attachedDevices || _typeof(attachedDevices) !== 'object') return;
+    Object.values(attachedDevices).forEach(function (att) {
+      if (att !== null && att !== void 0 && att.deviceId) deviceIds.add(att.deviceId);
+    });
+  });
+  deviceIds.forEach(function (deviceId) {
+    if (componentDefinitions[deviceId]) return;
+    var deviceDef = componentDictionary[deviceId];
+    if (deviceDef) componentDefinitions[deviceId] = cloneDefinition(deviceDef);
+  });
+  if (!Object.keys(componentDefinitions).length) {
+    sceneData.componentDefinitions;
+      var rest = _objectWithoutProperties(sceneData, _excluded);
+    return rest;
+  }
+  return _objectSpread2(_objectSpread2({}, sceneData), {}, {
+    componentDefinitions: componentDefinitions
+  });
+}
+
+/**
+ * Resolve the live component dictionary from a CentralPlant instance.
+ * @param {Object} centralPlant
+ * @returns {Record<string, Object>}
+ */
+function getComponentDictionary(centralPlant) {
+  var _centralPlant$getUtil, _centralPlant$manager;
+  return (centralPlant === null || centralPlant === void 0 || (_centralPlant$getUtil = centralPlant.getUtility) === null || _centralPlant$getUtil === void 0 || (_centralPlant$getUtil = _centralPlant$getUtil.call(centralPlant, 'modelPreloader')) === null || _centralPlant$getUtil === void 0 ? void 0 : _centralPlant$getUtil.componentDictionary) || (centralPlant === null || centralPlant === void 0 || (_centralPlant$manager = centralPlant.managers) === null || _centralPlant$manager === void 0 || (_centralPlant$manager = _centralPlant$manager.componentDataManager) === null || _centralPlant$manager === void 0 ? void 0 : _centralPlant$manager.componentDictionary) || {};
+}
+
+export { collectSceneLibraryIds, embedComponentDefinitions, getComponentDictionary };

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(
@@ -307,7 +317,8 @@ export {
   buildIntraBehavior,
   parseIntraBehavior,
   buildCrossBehavior,
-  parseCrossBehavior
+  parseCrossBehavior,
+  resolveAnimationDefaultValue
 } from './utils/behaviorSchema.js';
 export {
   registerBehaviorsForComponent,
@@ -316,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.41",
+  "version": "0.3.43",
   "description": "Utility modules for the Central Plant Application",
   "main": "dist/bundle/index.js",
   "module": "dist/esm/src/index.js",