@2112-lab/central-plant 0.3.41 → 0.3.43

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
+    });
   });
 }
 
@@ -2844,8 +2970,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;
@@ -4209,10 +4335,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);
@@ -5232,9 +5354,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;
@@ -27775,7 +27898,7 @@ var PathRenderingManager = /*#__PURE__*/function (_BaseDisposable) {
   }]);
 }(BaseDisposable);
 
-var _excluded$1 = ["direction"];
+var _excluded$2 = ["direction"];
 var ConnectorManager = /*#__PURE__*/function (_BaseDisposable) {
   function ConnectorManager(sceneViewer) {
     var _this;
@@ -27920,7 +28043,7 @@ var ConnectorManager = /*#__PURE__*/function (_BaseDisposable) {
           // Filter out 'direction' attribute - manual segment connectors don't need it
           var _ref = connector.userData || {};
             _ref.direction;
-            var cleanedUserData = _objectWithoutProperties(_ref, _excluded$1);
+            var cleanedUserData = _objectWithoutProperties(_ref, _excluded$2);
           var sceneDataConnector = {
             uuid: connector.uuid,
             userData: _objectSpread2(_objectSpread2({}, cleanedUserData), {}, {
@@ -31438,7 +31561,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 +31606,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
@@ -32687,7 +32810,7 @@ var SceneClearingUtility = /*#__PURE__*/function () {
   }]);
 }();
 
-var _excluded = ["direction"],
+var _excluded$1 = ["direction"],
   _excluded2 = ["direction"];
 var SceneOperationsManager = /*#__PURE__*/function () {
   function SceneOperationsManager(sceneViewer) {
@@ -33276,7 +33399,7 @@ var SceneOperationsManager = /*#__PURE__*/function () {
         // Initialize userData (filter out 'direction' - manual segment connectors don't need it)
         var _ref = connectorData.userData || {};
           _ref.direction;
-          var _cleanedUserData = _objectWithoutProperties(_ref, _excluded);
+          var _cleanedUserData = _objectWithoutProperties(_ref, _excluded$1);
         _connectorMesh.userData = _objectSpread2(_objectSpread2({}, _cleanedUserData), {}, {
           originalUuid: connectorData.uuid,
           objectType: 'segment-connector',
@@ -36612,61 +36735,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 +37802,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
@@ -37743,13 +37858,14 @@ function parseCrossBehavior(behavior) {
 /**
  * @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__namespace.Vector3 ? offset.clone() : new THREE__namespace.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__namespace.Quaternion();
-  modelRoot.getWorldQuaternion(q);
+  var q = customQuat ? customQuat.clone() : new THREE__namespace.Quaternion();
+  if (!customQuat) modelRoot.getWorldQuaternion(q);
   return v.applyQuaternion(q);
 }
 
@@ -37760,14 +37876,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__namespace.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);
 }
@@ -37779,10 +37896,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);
 }
@@ -38377,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,
@@ -39976,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();
@@ -40213,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);
@@ -40500,7 +40608,7 @@ var CentralPlantInternals = /*#__PURE__*/function () {
 /**
  * Scene-level behavior helpers: scan endpoints, register behaviors, cross-component links.
  */
-function getComponentDictionary(centralPlant) {
+function getComponentDictionary$1(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) || null;
 }
@@ -40531,7 +40639,7 @@ function scanSceneIoEndpoints(centralPlant) {
   var _centralPlant$sceneVi;
   var scene = centralPlant === null || centralPlant === void 0 || (_centralPlant$sceneVi = centralPlant.sceneViewer) === null || _centralPlant$sceneVi === void 0 ? void 0 : _centralPlant$sceneVi.scene;
   if (!scene) return [];
-  var dict = getComponentDictionary(centralPlant);
+  var dict = getComponentDictionary$1(centralPlant);
   var endpoints = [];
   scene.traverse(function (obj) {
     var _obj$userData, _parent$userData, _parent$userData2;
@@ -40624,7 +40732,7 @@ function reregisterSceneBehaviors(centralPlant) {
   var _centralPlant$sceneVi4;
   var ioBehavMgr = getIoBehaviorManager(centralPlant === null || centralPlant === void 0 ? void 0 : centralPlant.sceneViewer);
   var scene = centralPlant === null || centralPlant === void 0 || (_centralPlant$sceneVi4 = centralPlant.sceneViewer) === null || _centralPlant$sceneVi4 === void 0 ? void 0 : _centralPlant$sceneVi4.scene;
-  var dict = getComponentDictionary(centralPlant);
+  var dict = getComponentDictionary$1(centralPlant);
   if (!ioBehavMgr || !scene) return;
   var crossBehaviors = loadCrossComponentBehaviors(centralPlant);
   ioBehavMgr.setCrossComponentBehaviors(crossBehaviors);
@@ -40636,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);
   });
 }
 
@@ -40666,7 +40774,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.
@@ -43158,7 +43266,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:
@@ -43179,64 +43287,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);
@@ -44874,6 +44996,88 @@ var SceneHierarchyManager = /*#__PURE__*/function (_BaseDisposable) {
   }]);
 }(BaseDisposable);
 
+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) || {};
+}
+
 /**
  * Generic Cache Management using Browser Cache API
  * Framework-agnostic implementation of caching logic
@@ -49344,6 +49548,7 @@ exports.SceneTooltipsManager = SceneTooltipsManager;
 exports.SnapshotManager = SnapshotManager;
 exports.ThreeJSResourceManager = ThreeJSResourceManager;
 exports.applyCrossComponentBehaviors = applyCrossComponentBehaviors;
+exports.applyDefaultIoDeviceStates = applyDefaultIoDeviceStates;
 exports.applyModelRootTranslation = applyModelRootTranslation;
 exports.applyModelRootTranslationFromWorldBase = applyModelRootTranslationFromWorldBase;
 exports.buildCrossBehavior = buildCrossBehavior;
@@ -49353,8 +49558,10 @@ exports.cacheManager = cacheManager;
 exports.cleanExpiredCache = cleanExpiredCache;
 exports.cleanInvalidCacheEntries = cleanInvalidCacheEntries;
 exports.clearS3Cache = clearS3Cache;
+exports.collectSceneLibraryIds = collectSceneLibraryIds;
 exports.createPathfindingRequest = createPathfindingRequest;
 exports.createTransformControls = createTransformControls;
+exports.embedComponentDefinitions = embedComponentDefinitions;
 exports.findObjectByHardcodedUuid = findObjectByHardcodedUuid;
 exports.formatCacheExpiry = formatCacheExpiry;
 exports.generateUniqueComponentId = generateUniqueComponentId;
@@ -49369,6 +49576,7 @@ exports.getCachedLocalJson = getCachedLocalJson;
 exports.getCachedS3Json = getCachedS3Json;
 exports.getCachedS3Object = getCachedS3Object;
 exports.getCachedS3ObjectURL = getCachedS3ObjectURL;
+exports.getComponentDictionary = getComponentDictionary;
 exports.getCurrentCacheName = getCurrentCacheName;
 exports.getGlobalCacheStats = getGlobalCacheStats;
 exports.getGlobalOnlyCacheStats = getGlobalOnlyCacheStats;
@@ -49407,6 +49615,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;