@2112-lab/central-plant 0.1.90 → 0.1.91

package/dist/bundle/index.js

@@ -28570,91 +28570,150 @@ var BehaviorManager = /*#__PURE__*/function (_BaseDisposable) {
  * Attach IO device models to a smart component from cached models.
  * Each device referenced in componentData.attachedDevices is looked up
  * in the model preloader cache, cloned, positioned, and added as a child.
+ * If a device model is not in cache, it will be preloaded first.
  * 
  * @param {THREE.Object3D} componentModel - The parent component model
  * @param {Object} componentData - Component dictionary entry (has attachedDevices)
  * @param {Object} modelPreloader - ModelPreloader instance with cache and componentDictionary
  * @param {string} parentComponentId - The parent component's UUID
- * @returns {void}
+ * @returns {Promise<void>}
  */
-function attachIODevicesToComponent(componentModel, componentData, modelPreloader, parentComponentId) {
-  var attachedDevices = componentData.attachedDevices;
-  if (!attachedDevices || Object.keys(attachedDevices).length === 0) {
-    return;
-  }
-  console.log("\uD83D\uDD0C attachIODevicesToComponent(): Attaching ".concat(Object.keys(attachedDevices).length, " IO devices to smart component"));
-  for (var _i = 0, _Object$entries = Object.entries(attachedDevices); _i < _Object$entries.length; _i++) {
-    var _Object$entries$_i = _slicedToArray(_Object$entries[_i], 2),
-      attachmentId = _Object$entries$_i[0],
-      attachment = _Object$entries$_i[1];
-    try {
-      var _modelPreloader$compo, _deviceData$ioConfig, _deviceData$ioConfig2, _deviceData$ioConfig3, _attachment$attachmen;
-      var deviceData = (_modelPreloader$compo = modelPreloader.componentDictionary) === null || _modelPreloader$compo === void 0 ? void 0 : _modelPreloader$compo[attachment.deviceId];
-      if (!deviceData || !deviceData.modelKey) {
-        console.warn("\u26A0\uFE0F IO device ".concat(attachment.deviceId, " not found in dictionary, skipping"));
-        continue;
-      }
-      var cachedDevice = modelPreloader.getCachedModelWithDimensions(deviceData.modelKey, attachment.deviceId);
-      if (!cachedDevice) {
-        console.warn("\u26A0\uFE0F IO device model not in cache: ".concat(deviceData.modelKey, ", skipping"));
-        continue;
-      }
-
-      // Clone so each component instance owns its own io-device subtree and materials.
-      // Without this, all placed copies of the same smart component share the cached
-      // object, causing material mutations (from behaviors) to bleed across instances.
-      var deviceModel = cachedDevice.clone();
-      deviceModel.traverse(function (child) {
-        if (child.isMesh && child.material) {
-          child.material = Array.isArray(child.material) ? child.material.map(function (m) {
-            return m.clone();
-          }) : child.material.clone();
-        }
-      });
+function attachIODevicesToComponent(_x, _x2, _x3, _x4) {
+  return _attachIODevicesToComponent.apply(this, arguments);
+}
+function _attachIODevicesToComponent() {
+  _attachIODevicesToComponent = _asyncToGenerator(/*#__PURE__*/_regenerator().m(function _callee(componentModel, componentData, modelPreloader, parentComponentId) {
+    var attachedDevices, _i, _Object$entries, _Object$entries$_i, attachmentId, attachment, _modelPreloader$compo, _deviceData$ioConfig, _deviceData$ioConfig2, _deviceData$ioConfig3, _attachment$attachmen, deviceData, cachedDevice, _modelPreloader$loadi, deviceModel, pos, _t, _t2;
+    return _regenerator().w(function (_context) {
+      while (1) switch (_context.n) {
+        case 0:
+          attachedDevices = componentData.attachedDevices;
+          if (!(!attachedDevices || Object.keys(attachedDevices).length === 0)) {
+            _context.n = 1;
+            break;
+          }
+          return _context.a(2);
+        case 1:
+          console.log("\uD83D\uDD0C attachIODevicesToComponent(): Attaching ".concat(Object.keys(attachedDevices).length, " IO devices to smart component"));
+          _i = 0, _Object$entries = Object.entries(attachedDevices);
+        case 2:
+          if (!(_i < _Object$entries.length)) {
+            _context.n = 14;
+            break;
+          }
+          _Object$entries$_i = _slicedToArray(_Object$entries[_i], 2), attachmentId = _Object$entries$_i[0], attachment = _Object$entries$_i[1];
+          _context.p = 3;
+          deviceData = (_modelPreloader$compo = modelPreloader.componentDictionary) === null || _modelPreloader$compo === void 0 ? void 0 : _modelPreloader$compo[attachment.deviceId];
+          if (!(!deviceData || !deviceData.modelKey)) {
+            _context.n = 4;
+            break;
+          }
+          console.warn("\u26A0\uFE0F IO device ".concat(attachment.deviceId, " not found in dictionary, skipping"));
+          return _context.a(3, 13);
+        case 4:
+          // Try to get from cache first
+          cachedDevice = modelPreloader.getCachedModelWithDimensions(deviceData.modelKey, attachment.deviceId); // If not in cache, try to preload it
+          if (cachedDevice) {
+            _context.n = 10;
+            break;
+          }
+          console.log("\uD83D\uDD04 IO device model not in cache, preloading: ".concat(deviceData.modelKey));
+          _context.p = 5;
+          if (!((_modelPreloader$loadi = modelPreloader.loadingPromises) !== null && _modelPreloader$loadi !== void 0 && _modelPreloader$loadi.has(deviceData.modelKey))) {
+            _context.n = 7;
+            break;
+          }
+          _context.n = 6;
+          return modelPreloader.loadingPromises.get(deviceData.modelKey);
+        case 6:
+          _context.n = 8;
+          break;
+        case 7:
+          _context.n = 8;
+          return modelPreloader.preloadSingleModel(deviceData.modelKey);
+        case 8:
+          cachedDevice = modelPreloader.getCachedModelWithDimensions(deviceData.modelKey, attachment.deviceId);
+          _context.n = 10;
+          break;
+        case 9:
+          _context.p = 9;
+          _t = _context.v;
+          console.warn("\u26A0\uFE0F Failed to preload IO device model ".concat(deviceData.modelKey, ":"), _t);
+        case 10:
+          if (cachedDevice) {
+            _context.n = 11;
+            break;
+          }
+          console.warn("\u26A0\uFE0F IO device model could not be loaded: ".concat(deviceData.modelKey, ", skipping"));
+          return _context.a(3, 13);
+        case 11:
+          // Clone so each component instance owns its own io-device subtree and materials.
+          // Without this, all placed copies of the same smart component share the cached
+          // object, causing material mutations (from behaviors) to bleed across instances.
+          deviceModel = cachedDevice.clone();
+          deviceModel.traverse(function (child) {
+            if (child.isMesh && child.material) {
+              child.material = Array.isArray(child.material) ? child.material.map(function (m) {
+                return m.clone();
+              }) : child.material.clone();
+            }
+          });
 
-      // Name the device model
-      deviceModel.name = "".concat(attachment.attachmentLabel || 'IO Device', " (").concat(attachmentId, ")");
-
-      // Set user data for identification — include ioConfig data points so the
-      // component tooltip can render state displays without an extra lookup.
-      deviceModel.userData = {
-        objectType: 'io-device',
-        deviceId: attachment.deviceId,
-        attachmentId: attachmentId,
-        attachmentLabel: attachment.attachmentLabel,
-        parentComponentId: parentComponentId,
-        deviceName: deviceData.name || '',
-        // Snapshot of the device's data point definitions (stateType, stateConfig, direction, etc.)
-        // ioConfig can use either 'states' (preferred) or legacy 'dataPoints' as the array key
-        dataPoints: ((_deviceData$ioConfig = deviceData.ioConfig) === null || _deviceData$ioConfig === void 0 ? void 0 : _deviceData$ioConfig.states) || ((_deviceData$ioConfig2 = deviceData.ioConfig) === null || _deviceData$ioConfig2 === void 0 ? void 0 : _deviceData$ioConfig2.dataPoints) || [],
-        // Device-level I/O direction: 'input' means the user can write state via the tooltip
-        ioDirection: ((_deviceData$ioConfig3 = deviceData.ioConfig) === null || _deviceData$ioConfig3 === void 0 ? void 0 : _deviceData$ioConfig3.direction) || 'output',
-        // Signal wiring sourced from this attachment (for state propagation reference)
-        signalOutputs: attachment.signalOutputs || []
-      };
+          // Name the device model
+          deviceModel.name = "".concat(attachment.attachmentLabel || 'IO Device', " (").concat(attachmentId, ")");
 
-      // Position at the attachment point
-      if ((_attachment$attachmen = attachment.attachmentPoint) !== null && _attachment$attachmen !== void 0 && _attachment$attachmen.position) {
-        var pos = attachment.attachmentPoint.position;
-        deviceModel.position.set(pos.x || 0, pos.y || 0, pos.z || 0);
-      }
+          // Set user data for identification — include ioConfig data points so the
+          // component tooltip can render state displays without an extra lookup.
+          deviceModel.userData = {
+            objectType: 'io-device',
+            deviceId: attachment.deviceId,
+            attachmentId: attachmentId,
+            attachmentLabel: attachment.attachmentLabel,
+            parentComponentId: parentComponentId,
+            deviceName: deviceData.name || '',
+            // Snapshot of the device's data point definitions (stateType, stateConfig, direction, etc.)
+            // ioConfig can use either 'states' (preferred) or legacy 'dataPoints' as the array key
+            dataPoints: ((_deviceData$ioConfig = deviceData.ioConfig) === null || _deviceData$ioConfig === void 0 ? void 0 : _deviceData$ioConfig.states) || ((_deviceData$ioConfig2 = deviceData.ioConfig) === null || _deviceData$ioConfig2 === void 0 ? void 0 : _deviceData$ioConfig2.dataPoints) || [],
+            // Device-level I/O direction: 'input' means the user can write state via the tooltip
+            ioDirection: ((_deviceData$ioConfig3 = deviceData.ioConfig) === null || _deviceData$ioConfig3 === void 0 ? void 0 : _deviceData$ioConfig3.direction) || 'output',
+            // Signal wiring sourced from this attachment (for state propagation reference)
+            signalOutputs: attachment.signalOutputs || []
+          };
 
-      // IO device models are authored at the same real-world unit scale
-      // as the host component, so keep them at their natural (1:1) size.
-      // Note: attachmentPoint.scale is the connector marker sphere size,
-      // NOT a desired device model scale.
-      deviceModel.scale.setScalar(1);
+          // Position at the attachment point
+          if ((_attachment$attachmen = attachment.attachmentPoint) !== null && _attachment$attachmen !== void 0 && _attachment$attachmen.position) {
+            pos = attachment.attachmentPoint.position;
+            deviceModel.position.set(pos.x || 0, pos.y || 0, pos.z || 0);
+          }
 
-      // Add as child of the component
-      componentModel.add(deviceModel);
-      console.log("\u2705 Attached IO device: ".concat(attachment.attachmentLabel || attachment.deviceId, " at"), {
-        position: deviceModel.position,
-        scale: deviceModel.scale
-      });
-    } catch (err) {
-      console.error("\u274C Error attaching IO device ".concat(attachment.deviceId, ":"), err);
-    }
-  }
+          // IO device models are authored at the same real-world unit scale
+          // as the host component, so keep them at their natural (1:1) size.
+          // Note: attachmentPoint.scale is the connector marker sphere size,
+          // NOT a desired device model scale.
+          deviceModel.scale.setScalar(1);
+
+          // Add as child of the component
+          componentModel.add(deviceModel);
+          console.log("\u2705 Attached IO device: ".concat(attachment.attachmentLabel || attachment.deviceId, " at"), {
+            position: deviceModel.position,
+            scale: deviceModel.scale
+          });
+          _context.n = 13;
+          break;
+        case 12:
+          _context.p = 12;
+          _t2 = _context.v;
+          console.error("\u274C Error attaching IO device ".concat(attachment.deviceId, ":"), _t2);
+        case 13:
+          _i++;
+          _context.n = 2;
+          break;
+        case 14:
+          return _context.a(2);
+      }
+    }, _callee, null, [[5, 9], [3, 12]]);
+  }));
+  return _attachIODevicesToComponent.apply(this, arguments);
 }
 
 var ModelManager = /*#__PURE__*/function () {
@@ -28741,21 +28800,24 @@ var ModelManager = /*#__PURE__*/function () {
               });
 
               // Attach IO devices for smart components (import flow)
-              if (componentData.isSmart && componentData.attachedDevices) {
-                attachIODevicesToComponent(libraryModel, componentData, modelPreloader, originalProps.uuid);
+              if (!(componentData.isSmart && componentData.attachedDevices)) {
+                _context.n = 4;
+                break;
               }
-
+              _context.n = 4;
+              return attachIODevicesToComponent(libraryModel, componentData, modelPreloader, originalProps.uuid);
+            case 4:
               // Replace mesh in scene
               this._replaceMeshInScene(targetMesh, libraryModel, originalProps.parent, component);
               console.log("\uD83C\uDF89 ".concat((_jsonEntry$userData3 = jsonEntry.userData) === null || _jsonEntry$userData3 === void 0 ? void 0 : _jsonEntry$userData3.libraryId, " GLB model successfully rendered in scene"));
               return _context.a(2, libraryModel);
-            case 4:
-              _context.p = 4;
+            case 5:
+              _context.p = 5;
               _t = _context.v;
               console.error("\u274C Error loading ".concat((_jsonEntry$userData4 = jsonEntry.userData) === null || _jsonEntry$userData4 === void 0 ? void 0 : _jsonEntry$userData4.libraryId, " GLB model:"), _t);
               return _context.a(2, targetMesh);
           }
-        }, _callee, this, [[1, 4]]);
+        }, _callee, this, [[1, 5]]);
       }));
       function loadLibraryModel(_x, _x2, _x3) {
         return _loadLibraryModel.apply(this, arguments);
@@ -36814,7 +36876,7 @@ var CentralPlant = /*#__PURE__*/function (_BaseDisposable) {
    * Initialize the CentralPlant manager
    * 
    * @constructor
-   * @version 0.1.90
+   * @version 0.1.91
    * @updated 2025-10-22
    * 
    * @description Creates a new CentralPlant instance and initializes internal managers and utilities.

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

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

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

@@ -111,21 +111,24 @@ var ModelManager = /*#__PURE__*/function () {
               });
 
               // Attach IO devices for smart components (import flow)
-              if (componentData.isSmart && componentData.attachedDevices) {
-                ioDeviceUtils.attachIODevicesToComponent(libraryModel, componentData, modelPreloader["default"], originalProps.uuid);
+              if (!(componentData.isSmart && componentData.attachedDevices)) {
+                _context.n = 4;
+                break;
               }
-
+              _context.n = 4;
+              return ioDeviceUtils.attachIODevicesToComponent(libraryModel, componentData, modelPreloader["default"], originalProps.uuid);
+            case 4:
               // Replace mesh in scene
               this._replaceMeshInScene(targetMesh, libraryModel, originalProps.parent, component);
               console.log("\uD83C\uDF89 ".concat((_jsonEntry$userData3 = jsonEntry.userData) === null || _jsonEntry$userData3 === void 0 ? void 0 : _jsonEntry$userData3.libraryId, " GLB model successfully rendered in scene"));
               return _context.a(2, libraryModel);
-            case 4:
-              _context.p = 4;
+            case 5:
+              _context.p = 5;
               _t = _context.v;
               console.error("\u274C Error loading ".concat((_jsonEntry$userData4 = jsonEntry.userData) === null || _jsonEntry$userData4 === void 0 ? void 0 : _jsonEntry$userData4.libraryId, " GLB model:"), _t);
               return _context.a(2, targetMesh);
           }
-        }, _callee, this, [[1, 4]]);
+        }, _callee, this, [[1, 5]]);
       }));
       function loadLibraryModel(_x, _x2, _x3) {
         return _loadLibraryModel.apply(this, arguments);

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

@@ -14,91 +14,150 @@ var _rollupPluginBabelHelpers = require('../../_virtual/_rollupPluginBabelHelper
  * Attach IO device models to a smart component from cached models.
  * Each device referenced in componentData.attachedDevices is looked up
  * in the model preloader cache, cloned, positioned, and added as a child.
+ * If a device model is not in cache, it will be preloaded first.
  * 
  * @param {THREE.Object3D} componentModel - The parent component model
  * @param {Object} componentData - Component dictionary entry (has attachedDevices)
  * @param {Object} modelPreloader - ModelPreloader instance with cache and componentDictionary
  * @param {string} parentComponentId - The parent component's UUID
- * @returns {void}
+ * @returns {Promise<void>}
  */
-function attachIODevicesToComponent(componentModel, componentData, modelPreloader, parentComponentId) {
-  var attachedDevices = componentData.attachedDevices;
-  if (!attachedDevices || Object.keys(attachedDevices).length === 0) {
-    return;
-  }
-  console.log("\uD83D\uDD0C attachIODevicesToComponent(): Attaching ".concat(Object.keys(attachedDevices).length, " IO devices to smart component"));
-  for (var _i = 0, _Object$entries = Object.entries(attachedDevices); _i < _Object$entries.length; _i++) {
-    var _Object$entries$_i = _rollupPluginBabelHelpers.slicedToArray(_Object$entries[_i], 2),
-      attachmentId = _Object$entries$_i[0],
-      attachment = _Object$entries$_i[1];
-    try {
-      var _modelPreloader$compo, _deviceData$ioConfig, _deviceData$ioConfig2, _deviceData$ioConfig3, _attachment$attachmen;
-      var deviceData = (_modelPreloader$compo = modelPreloader.componentDictionary) === null || _modelPreloader$compo === void 0 ? void 0 : _modelPreloader$compo[attachment.deviceId];
-      if (!deviceData || !deviceData.modelKey) {
-        console.warn("\u26A0\uFE0F IO device ".concat(attachment.deviceId, " not found in dictionary, skipping"));
-        continue;
-      }
-      var cachedDevice = modelPreloader.getCachedModelWithDimensions(deviceData.modelKey, attachment.deviceId);
-      if (!cachedDevice) {
-        console.warn("\u26A0\uFE0F IO device model not in cache: ".concat(deviceData.modelKey, ", skipping"));
-        continue;
-      }
-
-      // Clone so each component instance owns its own io-device subtree and materials.
-      // Without this, all placed copies of the same smart component share the cached
-      // object, causing material mutations (from behaviors) to bleed across instances.
-      var deviceModel = cachedDevice.clone();
-      deviceModel.traverse(function (child) {
-        if (child.isMesh && child.material) {
-          child.material = Array.isArray(child.material) ? child.material.map(function (m) {
-            return m.clone();
-          }) : child.material.clone();
-        }
-      });
+function attachIODevicesToComponent(_x, _x2, _x3, _x4) {
+  return _attachIODevicesToComponent.apply(this, arguments);
+}
+function _attachIODevicesToComponent() {
+  _attachIODevicesToComponent = _rollupPluginBabelHelpers.asyncToGenerator(/*#__PURE__*/_rollupPluginBabelHelpers.regenerator().m(function _callee(componentModel, componentData, modelPreloader, parentComponentId) {
+    var attachedDevices, _i, _Object$entries, _Object$entries$_i, attachmentId, attachment, _modelPreloader$compo, _deviceData$ioConfig, _deviceData$ioConfig2, _deviceData$ioConfig3, _attachment$attachmen, deviceData, cachedDevice, _modelPreloader$loadi, deviceModel, pos, _t, _t2;
+    return _rollupPluginBabelHelpers.regenerator().w(function (_context) {
+      while (1) switch (_context.n) {
+        case 0:
+          attachedDevices = componentData.attachedDevices;
+          if (!(!attachedDevices || Object.keys(attachedDevices).length === 0)) {
+            _context.n = 1;
+            break;
+          }
+          return _context.a(2);
+        case 1:
+          console.log("\uD83D\uDD0C attachIODevicesToComponent(): Attaching ".concat(Object.keys(attachedDevices).length, " IO devices to smart component"));
+          _i = 0, _Object$entries = Object.entries(attachedDevices);
+        case 2:
+          if (!(_i < _Object$entries.length)) {
+            _context.n = 14;
+            break;
+          }
+          _Object$entries$_i = _rollupPluginBabelHelpers.slicedToArray(_Object$entries[_i], 2), attachmentId = _Object$entries$_i[0], attachment = _Object$entries$_i[1];
+          _context.p = 3;
+          deviceData = (_modelPreloader$compo = modelPreloader.componentDictionary) === null || _modelPreloader$compo === void 0 ? void 0 : _modelPreloader$compo[attachment.deviceId];
+          if (!(!deviceData || !deviceData.modelKey)) {
+            _context.n = 4;
+            break;
+          }
+          console.warn("\u26A0\uFE0F IO device ".concat(attachment.deviceId, " not found in dictionary, skipping"));
+          return _context.a(3, 13);
+        case 4:
+          // Try to get from cache first
+          cachedDevice = modelPreloader.getCachedModelWithDimensions(deviceData.modelKey, attachment.deviceId); // If not in cache, try to preload it
+          if (cachedDevice) {
+            _context.n = 10;
+            break;
+          }
+          console.log("\uD83D\uDD04 IO device model not in cache, preloading: ".concat(deviceData.modelKey));
+          _context.p = 5;
+          if (!((_modelPreloader$loadi = modelPreloader.loadingPromises) !== null && _modelPreloader$loadi !== void 0 && _modelPreloader$loadi.has(deviceData.modelKey))) {
+            _context.n = 7;
+            break;
+          }
+          _context.n = 6;
+          return modelPreloader.loadingPromises.get(deviceData.modelKey);
+        case 6:
+          _context.n = 8;
+          break;
+        case 7:
+          _context.n = 8;
+          return modelPreloader.preloadSingleModel(deviceData.modelKey);
+        case 8:
+          cachedDevice = modelPreloader.getCachedModelWithDimensions(deviceData.modelKey, attachment.deviceId);
+          _context.n = 10;
+          break;
+        case 9:
+          _context.p = 9;
+          _t = _context.v;
+          console.warn("\u26A0\uFE0F Failed to preload IO device model ".concat(deviceData.modelKey, ":"), _t);
+        case 10:
+          if (cachedDevice) {
+            _context.n = 11;
+            break;
+          }
+          console.warn("\u26A0\uFE0F IO device model could not be loaded: ".concat(deviceData.modelKey, ", skipping"));
+          return _context.a(3, 13);
+        case 11:
+          // Clone so each component instance owns its own io-device subtree and materials.
+          // Without this, all placed copies of the same smart component share the cached
+          // object, causing material mutations (from behaviors) to bleed across instances.
+          deviceModel = cachedDevice.clone();
+          deviceModel.traverse(function (child) {
+            if (child.isMesh && child.material) {
+              child.material = Array.isArray(child.material) ? child.material.map(function (m) {
+                return m.clone();
+              }) : child.material.clone();
+            }
+          });
 
-      // Name the device model
-      deviceModel.name = "".concat(attachment.attachmentLabel || 'IO Device', " (").concat(attachmentId, ")");
+          // Name the device model
+          deviceModel.name = "".concat(attachment.attachmentLabel || 'IO Device', " (").concat(attachmentId, ")");
 
-      // Set user data for identification — include ioConfig data points so the
-      // component tooltip can render state displays without an extra lookup.
-      deviceModel.userData = {
-        objectType: 'io-device',
-        deviceId: attachment.deviceId,
-        attachmentId: attachmentId,
-        attachmentLabel: attachment.attachmentLabel,
-        parentComponentId: parentComponentId,
-        deviceName: deviceData.name || '',
-        // Snapshot of the device's data point definitions (stateType, stateConfig, direction, etc.)
-        // ioConfig can use either 'states' (preferred) or legacy 'dataPoints' as the array key
-        dataPoints: ((_deviceData$ioConfig = deviceData.ioConfig) === null || _deviceData$ioConfig === void 0 ? void 0 : _deviceData$ioConfig.states) || ((_deviceData$ioConfig2 = deviceData.ioConfig) === null || _deviceData$ioConfig2 === void 0 ? void 0 : _deviceData$ioConfig2.dataPoints) || [],
-        // Device-level I/O direction: 'input' means the user can write state via the tooltip
-        ioDirection: ((_deviceData$ioConfig3 = deviceData.ioConfig) === null || _deviceData$ioConfig3 === void 0 ? void 0 : _deviceData$ioConfig3.direction) || 'output',
-        // Signal wiring sourced from this attachment (for state propagation reference)
-        signalOutputs: attachment.signalOutputs || []
-      };
+          // Set user data for identification — include ioConfig data points so the
+          // component tooltip can render state displays without an extra lookup.
+          deviceModel.userData = {
+            objectType: 'io-device',
+            deviceId: attachment.deviceId,
+            attachmentId: attachmentId,
+            attachmentLabel: attachment.attachmentLabel,
+            parentComponentId: parentComponentId,
+            deviceName: deviceData.name || '',
+            // Snapshot of the device's data point definitions (stateType, stateConfig, direction, etc.)
+            // ioConfig can use either 'states' (preferred) or legacy 'dataPoints' as the array key
+            dataPoints: ((_deviceData$ioConfig = deviceData.ioConfig) === null || _deviceData$ioConfig === void 0 ? void 0 : _deviceData$ioConfig.states) || ((_deviceData$ioConfig2 = deviceData.ioConfig) === null || _deviceData$ioConfig2 === void 0 ? void 0 : _deviceData$ioConfig2.dataPoints) || [],
+            // Device-level I/O direction: 'input' means the user can write state via the tooltip
+            ioDirection: ((_deviceData$ioConfig3 = deviceData.ioConfig) === null || _deviceData$ioConfig3 === void 0 ? void 0 : _deviceData$ioConfig3.direction) || 'output',
+            // Signal wiring sourced from this attachment (for state propagation reference)
+            signalOutputs: attachment.signalOutputs || []
+          };
 
-      // Position at the attachment point
-      if ((_attachment$attachmen = attachment.attachmentPoint) !== null && _attachment$attachmen !== void 0 && _attachment$attachmen.position) {
-        var pos = attachment.attachmentPoint.position;
-        deviceModel.position.set(pos.x || 0, pos.y || 0, pos.z || 0);
-      }
+          // Position at the attachment point
+          if ((_attachment$attachmen = attachment.attachmentPoint) !== null && _attachment$attachmen !== void 0 && _attachment$attachmen.position) {
+            pos = attachment.attachmentPoint.position;
+            deviceModel.position.set(pos.x || 0, pos.y || 0, pos.z || 0);
+          }
 
-      // IO device models are authored at the same real-world unit scale
-      // as the host component, so keep them at their natural (1:1) size.
-      // Note: attachmentPoint.scale is the connector marker sphere size,
-      // NOT a desired device model scale.
-      deviceModel.scale.setScalar(1);
+          // IO device models are authored at the same real-world unit scale
+          // as the host component, so keep them at their natural (1:1) size.
+          // Note: attachmentPoint.scale is the connector marker sphere size,
+          // NOT a desired device model scale.
+          deviceModel.scale.setScalar(1);
 
-      // Add as child of the component
-      componentModel.add(deviceModel);
-      console.log("\u2705 Attached IO device: ".concat(attachment.attachmentLabel || attachment.deviceId, " at"), {
-        position: deviceModel.position,
-        scale: deviceModel.scale
-      });
-    } catch (err) {
-      console.error("\u274C Error attaching IO device ".concat(attachment.deviceId, ":"), err);
-    }
-  }
+          // Add as child of the component
+          componentModel.add(deviceModel);
+          console.log("\u2705 Attached IO device: ".concat(attachment.attachmentLabel || attachment.deviceId, " at"), {
+            position: deviceModel.position,
+            scale: deviceModel.scale
+          });
+          _context.n = 13;
+          break;
+        case 12:
+          _context.p = 12;
+          _t2 = _context.v;
+          console.error("\u274C Error attaching IO device ".concat(attachment.deviceId, ":"), _t2);
+        case 13:
+          _i++;
+          _context.n = 2;
+          break;
+        case 14:
+          return _context.a(2);
+      }
+    }, _callee, null, [[5, 9], [3, 12]]);
+  }));
+  return _attachIODevicesToComponent.apply(this, arguments);
 }
 
 exports.attachIODevicesToComponent = attachIODevicesToComponent;

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

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

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

@@ -87,21 +87,24 @@ var ModelManager = /*#__PURE__*/function () {
               });
 
               // Attach IO devices for smart components (import flow)
-              if (componentData.isSmart && componentData.attachedDevices) {
-                attachIODevicesToComponent(libraryModel, componentData, modelPreloader, originalProps.uuid);
+              if (!(componentData.isSmart && componentData.attachedDevices)) {
+                _context.n = 4;
+                break;
               }
-
+              _context.n = 4;
+              return attachIODevicesToComponent(libraryModel, componentData, modelPreloader, originalProps.uuid);
+            case 4:
               // Replace mesh in scene
               this._replaceMeshInScene(targetMesh, libraryModel, originalProps.parent, component);
               console.log("\uD83C\uDF89 ".concat((_jsonEntry$userData3 = jsonEntry.userData) === null || _jsonEntry$userData3 === void 0 ? void 0 : _jsonEntry$userData3.libraryId, " GLB model successfully rendered in scene"));
               return _context.a(2, libraryModel);
-            case 4:
-              _context.p = 4;
+            case 5:
+              _context.p = 5;
               _t = _context.v;
               console.error("\u274C Error loading ".concat((_jsonEntry$userData4 = jsonEntry.userData) === null || _jsonEntry$userData4 === void 0 ? void 0 : _jsonEntry$userData4.libraryId, " GLB model:"), _t);
               return _context.a(2, targetMesh);
           }
-        }, _callee, this, [[1, 4]]);
+        }, _callee, this, [[1, 5]]);
       }));
       function loadLibraryModel(_x, _x2, _x3) {
         return _loadLibraryModel.apply(this, arguments);

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

@@ -1,4 +1,4 @@
-import { slicedToArray as _slicedToArray } from '../../_virtual/_rollupPluginBabelHelpers.js';
+import { asyncToGenerator as _asyncToGenerator, regenerator as _regenerator, slicedToArray as _slicedToArray } from '../../_virtual/_rollupPluginBabelHelpers.js';
 
 /**
  * IO Device Utilities
@@ -10,91 +10,150 @@ import { slicedToArray as _slicedToArray } from '../../_virtual/_rollupPluginBab
  * Attach IO device models to a smart component from cached models.
  * Each device referenced in componentData.attachedDevices is looked up
  * in the model preloader cache, cloned, positioned, and added as a child.
+ * If a device model is not in cache, it will be preloaded first.
  * 
  * @param {THREE.Object3D} componentModel - The parent component model
  * @param {Object} componentData - Component dictionary entry (has attachedDevices)
  * @param {Object} modelPreloader - ModelPreloader instance with cache and componentDictionary
  * @param {string} parentComponentId - The parent component's UUID
- * @returns {void}
+ * @returns {Promise<void>}
  */
-function attachIODevicesToComponent(componentModel, componentData, modelPreloader, parentComponentId) {
-  var attachedDevices = componentData.attachedDevices;
-  if (!attachedDevices || Object.keys(attachedDevices).length === 0) {
-    return;
-  }
-  console.log("\uD83D\uDD0C attachIODevicesToComponent(): Attaching ".concat(Object.keys(attachedDevices).length, " IO devices to smart component"));
-  for (var _i = 0, _Object$entries = Object.entries(attachedDevices); _i < _Object$entries.length; _i++) {
-    var _Object$entries$_i = _slicedToArray(_Object$entries[_i], 2),
-      attachmentId = _Object$entries$_i[0],
-      attachment = _Object$entries$_i[1];
-    try {
-      var _modelPreloader$compo, _deviceData$ioConfig, _deviceData$ioConfig2, _deviceData$ioConfig3, _attachment$attachmen;
-      var deviceData = (_modelPreloader$compo = modelPreloader.componentDictionary) === null || _modelPreloader$compo === void 0 ? void 0 : _modelPreloader$compo[attachment.deviceId];
-      if (!deviceData || !deviceData.modelKey) {
-        console.warn("\u26A0\uFE0F IO device ".concat(attachment.deviceId, " not found in dictionary, skipping"));
-        continue;
-      }
-      var cachedDevice = modelPreloader.getCachedModelWithDimensions(deviceData.modelKey, attachment.deviceId);
-      if (!cachedDevice) {
-        console.warn("\u26A0\uFE0F IO device model not in cache: ".concat(deviceData.modelKey, ", skipping"));
-        continue;
-      }
-
-      // Clone so each component instance owns its own io-device subtree and materials.
-      // Without this, all placed copies of the same smart component share the cached
-      // object, causing material mutations (from behaviors) to bleed across instances.
-      var deviceModel = cachedDevice.clone();
-      deviceModel.traverse(function (child) {
-        if (child.isMesh && child.material) {
-          child.material = Array.isArray(child.material) ? child.material.map(function (m) {
-            return m.clone();
-          }) : child.material.clone();
-        }
-      });
+function attachIODevicesToComponent(_x, _x2, _x3, _x4) {
+  return _attachIODevicesToComponent.apply(this, arguments);
+}
+function _attachIODevicesToComponent() {
+  _attachIODevicesToComponent = _asyncToGenerator(/*#__PURE__*/_regenerator().m(function _callee(componentModel, componentData, modelPreloader, parentComponentId) {
+    var attachedDevices, _i, _Object$entries, _Object$entries$_i, attachmentId, attachment, _modelPreloader$compo, _deviceData$ioConfig, _deviceData$ioConfig2, _deviceData$ioConfig3, _attachment$attachmen, deviceData, cachedDevice, _modelPreloader$loadi, deviceModel, pos, _t, _t2;
+    return _regenerator().w(function (_context) {
+      while (1) switch (_context.n) {
+        case 0:
+          attachedDevices = componentData.attachedDevices;
+          if (!(!attachedDevices || Object.keys(attachedDevices).length === 0)) {
+            _context.n = 1;
+            break;
+          }
+          return _context.a(2);
+        case 1:
+          console.log("\uD83D\uDD0C attachIODevicesToComponent(): Attaching ".concat(Object.keys(attachedDevices).length, " IO devices to smart component"));
+          _i = 0, _Object$entries = Object.entries(attachedDevices);
+        case 2:
+          if (!(_i < _Object$entries.length)) {
+            _context.n = 14;
+            break;
+          }
+          _Object$entries$_i = _slicedToArray(_Object$entries[_i], 2), attachmentId = _Object$entries$_i[0], attachment = _Object$entries$_i[1];
+          _context.p = 3;
+          deviceData = (_modelPreloader$compo = modelPreloader.componentDictionary) === null || _modelPreloader$compo === void 0 ? void 0 : _modelPreloader$compo[attachment.deviceId];
+          if (!(!deviceData || !deviceData.modelKey)) {
+            _context.n = 4;
+            break;
+          }
+          console.warn("\u26A0\uFE0F IO device ".concat(attachment.deviceId, " not found in dictionary, skipping"));
+          return _context.a(3, 13);
+        case 4:
+          // Try to get from cache first
+          cachedDevice = modelPreloader.getCachedModelWithDimensions(deviceData.modelKey, attachment.deviceId); // If not in cache, try to preload it
+          if (cachedDevice) {
+            _context.n = 10;
+            break;
+          }
+          console.log("\uD83D\uDD04 IO device model not in cache, preloading: ".concat(deviceData.modelKey));
+          _context.p = 5;
+          if (!((_modelPreloader$loadi = modelPreloader.loadingPromises) !== null && _modelPreloader$loadi !== void 0 && _modelPreloader$loadi.has(deviceData.modelKey))) {
+            _context.n = 7;
+            break;
+          }
+          _context.n = 6;
+          return modelPreloader.loadingPromises.get(deviceData.modelKey);
+        case 6:
+          _context.n = 8;
+          break;
+        case 7:
+          _context.n = 8;
+          return modelPreloader.preloadSingleModel(deviceData.modelKey);
+        case 8:
+          cachedDevice = modelPreloader.getCachedModelWithDimensions(deviceData.modelKey, attachment.deviceId);
+          _context.n = 10;
+          break;
+        case 9:
+          _context.p = 9;
+          _t = _context.v;
+          console.warn("\u26A0\uFE0F Failed to preload IO device model ".concat(deviceData.modelKey, ":"), _t);
+        case 10:
+          if (cachedDevice) {
+            _context.n = 11;
+            break;
+          }
+          console.warn("\u26A0\uFE0F IO device model could not be loaded: ".concat(deviceData.modelKey, ", skipping"));
+          return _context.a(3, 13);
+        case 11:
+          // Clone so each component instance owns its own io-device subtree and materials.
+          // Without this, all placed copies of the same smart component share the cached
+          // object, causing material mutations (from behaviors) to bleed across instances.
+          deviceModel = cachedDevice.clone();
+          deviceModel.traverse(function (child) {
+            if (child.isMesh && child.material) {
+              child.material = Array.isArray(child.material) ? child.material.map(function (m) {
+                return m.clone();
+              }) : child.material.clone();
+            }
+          });
 
-      // Name the device model
-      deviceModel.name = "".concat(attachment.attachmentLabel || 'IO Device', " (").concat(attachmentId, ")");
+          // Name the device model
+          deviceModel.name = "".concat(attachment.attachmentLabel || 'IO Device', " (").concat(attachmentId, ")");
 
-      // Set user data for identification — include ioConfig data points so the
-      // component tooltip can render state displays without an extra lookup.
-      deviceModel.userData = {
-        objectType: 'io-device',
-        deviceId: attachment.deviceId,
-        attachmentId: attachmentId,
-        attachmentLabel: attachment.attachmentLabel,
-        parentComponentId: parentComponentId,
-        deviceName: deviceData.name || '',
-        // Snapshot of the device's data point definitions (stateType, stateConfig, direction, etc.)
-        // ioConfig can use either 'states' (preferred) or legacy 'dataPoints' as the array key
-        dataPoints: ((_deviceData$ioConfig = deviceData.ioConfig) === null || _deviceData$ioConfig === void 0 ? void 0 : _deviceData$ioConfig.states) || ((_deviceData$ioConfig2 = deviceData.ioConfig) === null || _deviceData$ioConfig2 === void 0 ? void 0 : _deviceData$ioConfig2.dataPoints) || [],
-        // Device-level I/O direction: 'input' means the user can write state via the tooltip
-        ioDirection: ((_deviceData$ioConfig3 = deviceData.ioConfig) === null || _deviceData$ioConfig3 === void 0 ? void 0 : _deviceData$ioConfig3.direction) || 'output',
-        // Signal wiring sourced from this attachment (for state propagation reference)
-        signalOutputs: attachment.signalOutputs || []
-      };
+          // Set user data for identification — include ioConfig data points so the
+          // component tooltip can render state displays without an extra lookup.
+          deviceModel.userData = {
+            objectType: 'io-device',
+            deviceId: attachment.deviceId,
+            attachmentId: attachmentId,
+            attachmentLabel: attachment.attachmentLabel,
+            parentComponentId: parentComponentId,
+            deviceName: deviceData.name || '',
+            // Snapshot of the device's data point definitions (stateType, stateConfig, direction, etc.)
+            // ioConfig can use either 'states' (preferred) or legacy 'dataPoints' as the array key
+            dataPoints: ((_deviceData$ioConfig = deviceData.ioConfig) === null || _deviceData$ioConfig === void 0 ? void 0 : _deviceData$ioConfig.states) || ((_deviceData$ioConfig2 = deviceData.ioConfig) === null || _deviceData$ioConfig2 === void 0 ? void 0 : _deviceData$ioConfig2.dataPoints) || [],
+            // Device-level I/O direction: 'input' means the user can write state via the tooltip
+            ioDirection: ((_deviceData$ioConfig3 = deviceData.ioConfig) === null || _deviceData$ioConfig3 === void 0 ? void 0 : _deviceData$ioConfig3.direction) || 'output',
+            // Signal wiring sourced from this attachment (for state propagation reference)
+            signalOutputs: attachment.signalOutputs || []
+          };
 
-      // Position at the attachment point
-      if ((_attachment$attachmen = attachment.attachmentPoint) !== null && _attachment$attachmen !== void 0 && _attachment$attachmen.position) {
-        var pos = attachment.attachmentPoint.position;
-        deviceModel.position.set(pos.x || 0, pos.y || 0, pos.z || 0);
-      }
+          // Position at the attachment point
+          if ((_attachment$attachmen = attachment.attachmentPoint) !== null && _attachment$attachmen !== void 0 && _attachment$attachmen.position) {
+            pos = attachment.attachmentPoint.position;
+            deviceModel.position.set(pos.x || 0, pos.y || 0, pos.z || 0);
+          }
 
-      // IO device models are authored at the same real-world unit scale
-      // as the host component, so keep them at their natural (1:1) size.
-      // Note: attachmentPoint.scale is the connector marker sphere size,
-      // NOT a desired device model scale.
-      deviceModel.scale.setScalar(1);
+          // IO device models are authored at the same real-world unit scale
+          // as the host component, so keep them at their natural (1:1) size.
+          // Note: attachmentPoint.scale is the connector marker sphere size,
+          // NOT a desired device model scale.
+          deviceModel.scale.setScalar(1);
 
-      // Add as child of the component
-      componentModel.add(deviceModel);
-      console.log("\u2705 Attached IO device: ".concat(attachment.attachmentLabel || attachment.deviceId, " at"), {
-        position: deviceModel.position,
-        scale: deviceModel.scale
-      });
-    } catch (err) {
-      console.error("\u274C Error attaching IO device ".concat(attachment.deviceId, ":"), err);
-    }
-  }
+          // Add as child of the component
+          componentModel.add(deviceModel);
+          console.log("\u2705 Attached IO device: ".concat(attachment.attachmentLabel || attachment.deviceId, " at"), {
+            position: deviceModel.position,
+            scale: deviceModel.scale
+          });
+          _context.n = 13;
+          break;
+        case 12:
+          _context.p = 12;
+          _t2 = _context.v;
+          console.error("\u274C Error attaching IO device ".concat(attachment.deviceId, ":"), _t2);
+        case 13:
+          _i++;
+          _context.n = 2;
+          break;
+        case 14:
+          return _context.a(2);
+      }
+    }, _callee, null, [[5, 9], [3, 12]]);
+  }));
+  return _attachIODevicesToComponent.apply(this, arguments);
 }
 
 export { attachIODevicesToComponent };

package/package.json

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