@2112-lab/central-plant 0.3.26 → 0.3.28

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

@@ -761,13 +761,8 @@ var SceneOperationsManager = /*#__PURE__*/function () {
               phaseStart = performance.now();
               this._finalizeScene(data, crosscubeTextureSet, isImported);
               timers.phase5_finalize = performance.now() - phaseStart;
-
-              // Phase 6: Load behaviors (after GLB models are present so output objects can be resolved)
-              phaseStart = performance.now();
-              this._processBehaviors(data);
-              timers.phase6_behaviors = performance.now() - phaseStart;
               totalTime = performance.now() - totalStart;
-              console.log("\u23F1\uFE0F Scene Loading Performance:\n   Phase 1 (Prepare)      : ".concat(timers.phase1_prepare.toFixed(0), "ms\n   Phase 2 (Create Objects): ").concat(timers.phase2_createObjects.toFixed(0), "ms\n   Phase 3 (GLB Models)    : ").concat(timers.phase3_glbModels.toFixed(0), "ms\n   Phase 4 (Pathfinding)   : ").concat(timers.phase4_pathfinding.toFixed(0), "ms\n   Phase 5 (Finalize)      : ").concat(timers.phase5_finalize.toFixed(0), "ms\n   Phase 6 (Behaviors)     : ").concat(timers.phase6_behaviors.toFixed(0), "ms\n   \u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\n   Total                   : ").concat(totalTime.toFixed(0), "ms"));
+              console.log("\u23F1\uFE0F Scene Loading Performance:\n   Phase 1 (Prepare)      : ".concat(timers.phase1_prepare.toFixed(0), "ms\n   Phase 2 (Create Objects): ").concat(timers.phase2_createObjects.toFixed(0), "ms\n   Phase 3 (GLB Models)    : ").concat(timers.phase3_glbModels.toFixed(0), "ms\n   Phase 4 (Pathfinding)   : ").concat(timers.phase4_pathfinding.toFixed(0), "ms\n   Phase 5 (Finalize)      : ").concat(timers.phase5_finalize.toFixed(0), "ms\n   \u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\n   Total                   : ").concat(totalTime.toFixed(0), "ms"));
               console.log('✅ Scene loaded successfully');
 
               // Notify UI components (e.g. SceneHierarchy) that the scene is fully loaded
@@ -1125,278 +1120,6 @@ var SceneOperationsManager = /*#__PURE__*/function () {
       }
     }
 
-    /**
-     * Process behaviors from the scene data, expand any defaultBehaviors defined
-     * on component dictionary entries, resolve behaviorRef entries against device
-     * assets, inject per-instance component UUIDs, and hand the flat resolved
-     * array to BehaviorManager.
-     *
-     * Resolution cascade:
-     *   1. Explicit behaviors in data.behaviors — passed through as-is (behaviorRef
-     *      entries are resolved against the component/device dictionaries).
-     *   2. defaultBehaviors[] on each placed smart component's dictionary entry —
-     *      expanded per instance with the instance UUID injected.  Compact
-     *      behaviorRef-derived entries are tagged _isDefaultBehavior:true (the
-     *      exporter can re-derive them); full L2 behavior objects are tagged false
-     *      so they are exported verbatim and survive round-trips.
-     *
-     * @param {Object} data - Scene JSON data
-     */
-  }, {
-    key: "_processBehaviors",
-    value: function _processBehaviors(data) {
-      var _this$sceneViewer2,
-        _this$sceneViewer$cen2,
-        _this5 = this,
-        _data$scene3;
-      var behaviorManager = (_this$sceneViewer2 = this.sceneViewer) === null || _this$sceneViewer2 === void 0 || (_this$sceneViewer2 = _this$sceneViewer2.managers) === null || _this$sceneViewer2 === void 0 ? void 0 : _this$sceneViewer2.behaviorManager;
-      if (!behaviorManager) {
-        console.warn('⚠️ _processBehaviors: BehaviorManager not available');
-        return;
-      }
-
-      // Obtain the component dictionary (extended = includes S3/smart components)
-      var componentDictionary = ((_this$sceneViewer$cen2 = this.sceneViewer.centralPlant) === null || _this$sceneViewer$cen2 === void 0 || (_this$sceneViewer$cen2 = _this$sceneViewer$cen2.managers) === null || _this$sceneViewer$cen2 === void 0 || (_this$sceneViewer$cen2 = _this$sceneViewer$cen2.componentDataManager) === null || _this$sceneViewer$cen2 === void 0 ? void 0 : _this$sceneViewer$cen2.componentDictionary) || {};
-
-      // ── Step A: Resolve any behaviorRef entries from data.behaviors ─────────
-      var explicitBehaviors = [];
-      if (Array.isArray(data === null || data === void 0 ? void 0 : data.behaviors)) {
-        data.behaviors.forEach(function (entry) {
-          if (entry.behaviorRef) {
-            var resolved = _this5._resolveBehaviorRef(entry, componentDictionary);
-            if (resolved) explicitBehaviors.push(resolved);
-          } else {
-            explicitBehaviors.push(entry);
-          }
-        });
-      }
-
-      // Build a set of explicit behavior ids for deduplication
-      var explicitIds = new Set(explicitBehaviors.map(function (b) {
-        return b.id;
-      }));
-
-      // Build a set of (component::attachment::state) tuples covered by explicit
-      // behaviors.  If an expanded default behavior would produce the SAME input
-      // tuple, the explicit behavior is treated as the intentional override and
-      // the default expansion is skipped.  This prevents a component's built-in
-      // switch→LED wiring from doubling-up when the user has deliberately authored
-      // cross-component behaviors that re-wire the same switch.
-      var explicitInputTuples = new Set(explicitBehaviors.filter(function (b) {
-        var _b$input, _b$input2, _b$input3;
-        return ((_b$input = b.input) === null || _b$input === void 0 ? void 0 : _b$input.component) && ((_b$input2 = b.input) === null || _b$input2 === void 0 ? void 0 : _b$input2.attachment) && ((_b$input3 = b.input) === null || _b$input3 === void 0 ? void 0 : _b$input3.state);
-      }).map(function (b) {
-        return "".concat(b.input.component, "::").concat(b.input.attachment, "::").concat(b.input.state);
-      }));
-
-      // Build a set of instanceUuids already covered by behaviorRef entries in
-      // data.behaviors (written by the exporter for smart component defaults).
-      // Step B skips these instances to avoid loading the same behaviors twice —
-      // once via Step A (resolved from data.behaviors refs) and once via Step B
-      // (auto-expanded from the component dictionary).
-      var coveredInstances = new Set();
-      if (Array.isArray(data === null || data === void 0 ? void 0 : data.behaviors)) {
-        data.behaviors.forEach(function (entry) {
-          if (entry.behaviorRef && entry.component) {
-            coveredInstances.add(entry.component);
-          }
-        });
-      }
-
-      // ── Step B: Walk placed components and expand their defaultBehaviors ─────
-      var instanceBehaviors = [];
-      if (Array.isArray(data === null || data === void 0 || (_data$scene3 = data.scene) === null || _data$scene3 === void 0 ? void 0 : _data$scene3.children)) {
-        data.scene.children.forEach(function (child) {
-          var _child$userData0, _compData$defaultBeha;
-          var libraryId = (_child$userData0 = child.userData) === null || _child$userData0 === void 0 ? void 0 : _child$userData0.libraryId;
-          if (!libraryId) return;
-          var instanceUuid = child.uuid;
-          // Skip instances whose defaults were already resolved by Step A
-          // (they have explicit behaviorRef entries in data.behaviors).
-          if (coveredInstances.has(instanceUuid)) return;
-          var compData = componentDictionary[libraryId];
-          if (!(compData !== null && compData !== void 0 && (_compData$defaultBeha = compData.defaultBehaviors) !== null && _compData$defaultBeha !== void 0 && _compData$defaultBeha.length)) return;
-          compData.defaultBehaviors.forEach(function (template) {
-            var _expanded$input, _expanded$input2, _expanded$input3;
-            var expanded = _this5._expandDefaultBehavior(template, instanceUuid, componentDictionary);
-            if (!expanded) return;
-            // Skip if an explicit scene behavior already covers this id
-            if (explicitIds.has(expanded.id)) return;
-            // Skip if an explicit scene behavior already covers the same
-            // (component, attachment, state) input tuple.  This prevents a
-            // component's built-in default wiring (e.g. switch → own LED) from
-            // double-firing when the user has authored a cross-component override
-            // that rewires the same switch to a different target.
-            if ((_expanded$input = expanded.input) !== null && _expanded$input !== void 0 && _expanded$input.component && (_expanded$input2 = expanded.input) !== null && _expanded$input2 !== void 0 && _expanded$input2.attachment && (_expanded$input3 = expanded.input) !== null && _expanded$input3 !== void 0 && _expanded$input3.state) {
-              var tuple = "".concat(expanded.input.component, "::").concat(expanded.input.attachment, "::").concat(expanded.input.state);
-              if (explicitInputTuples.has(tuple)) return;
-            }
-            // All component defaultBehaviors are re-derivable from the component
-            // asset at export time (via compact behaviorRef), so mark them all.
-            expanded._isDefaultBehavior = true;
-            instanceBehaviors.push(expanded);
-          });
-        });
-      }
-      var allBehaviors = [].concat(explicitBehaviors, instanceBehaviors);
-      if (allBehaviors.length === 0) return;
-      behaviorManager.loadBehaviors(allBehaviors);
-      console.log("\u2705 _processBehaviors: loaded ".concat(explicitBehaviors.length, " explicit + ").concat(instanceBehaviors.length, " default-expanded behavior(s)"));
-    }
-
-    /**
-     * Register the defaultBehaviors of a single newly placed component instance
-     * into the BehaviorManager.  Called from addComponent() (drag-drop), where
-     * _processBehaviors() (scene-load path) is not invoked.
-     *
-     * @param {Object} componentData - Entry from the component dictionary
-     * @param {string} instanceUuid  - UUID of the placed component (componentModel.uuid)
-     */
-  }, {
-    key: "registerBehaviorsForComponentInstance",
-    value: function registerBehaviorsForComponentInstance(componentData, instanceUuid) {
-      var _this$sceneViewer3,
-        _componentData$defaul,
-        _this$sceneViewer$cen3,
-        _this6 = this;
-      var behaviorManager = (_this$sceneViewer3 = this.sceneViewer) === null || _this$sceneViewer3 === void 0 || (_this$sceneViewer3 = _this$sceneViewer3.managers) === null || _this$sceneViewer3 === void 0 ? void 0 : _this$sceneViewer3.behaviorManager;
-      if (!behaviorManager) return;
-      if (!(componentData !== null && componentData !== void 0 && (_componentData$defaul = componentData.defaultBehaviors) !== null && _componentData$defaul !== void 0 && _componentData$defaul.length)) return;
-      var componentDictionary = ((_this$sceneViewer$cen3 = this.sceneViewer.centralPlant) === null || _this$sceneViewer$cen3 === void 0 || (_this$sceneViewer$cen3 = _this$sceneViewer$cen3.managers) === null || _this$sceneViewer$cen3 === void 0 || (_this$sceneViewer$cen3 = _this$sceneViewer$cen3.componentDataManager) === null || _this$sceneViewer$cen3 === void 0 ? void 0 : _this$sceneViewer$cen3.componentDictionary) || {};
-      var registered = 0;
-      componentData.defaultBehaviors.forEach(function (template) {
-        var expanded = _this6._expandDefaultBehavior(template, instanceUuid, componentDictionary);
-        if (!expanded) return;
-        expanded._isDefaultBehavior = true;
-        behaviorManager.addBehavior(expanded);
-        registered++;
-      });
-      if (registered > 0) {
-        console.log("\u2705 registerBehaviorsForComponentInstance: registered ".concat(registered, " behavior(s) for instance ").concat(instanceUuid));
-      }
-    }
-
-    /**
-     * Resolve a scene-level or component-level behaviorRef entry into a full
-     * behavior definition by looking up the referenced template in the device
-     * asset's defaultBehaviors[] and substituting 'self' with the real
-     * attachmentId.
-     *
-     * Ref shape: { behaviorRef, deviceId, attachment, component? }
-     *
-     * @param {Object} ref
-     * @param {Object} componentDictionary
-     * @returns {Object|null} Resolved behavior or null if not found
-     */
-  }, {
-    key: "_resolveBehaviorRef",
-    value: function _resolveBehaviorRef(ref, componentDictionary) {
-      var _resolved$input, _resolved$output;
-      if (!ref.behaviorRef) {
-        console.warn('⚠️ _resolveBehaviorRef: missing behaviorRef', ref);
-        return null;
-      }
-
-      // ── Component-level L2 ref: { behaviorRef, libraryId, component } ──────
-      // The full behavior template lives on the smart component's defaultBehaviors[].
-      // No 'self' substitution needed — attachment IDs are already real.
-      if (ref.libraryId) {
-        var compData = componentDictionary[ref.libraryId];
-        if (!compData) {
-          console.warn("\u26A0\uFE0F _resolveBehaviorRef: component \"".concat(ref.libraryId, "\" not in dictionary"));
-          return null;
-        }
-        var _template = (compData.defaultBehaviors || []).find(function (b) {
-          return b.id === ref.behaviorRef;
-        });
-        if (!_template) {
-          console.warn("\u26A0\uFE0F _resolveBehaviorRef: behavior \"".concat(ref.behaviorRef, "\" not found on component \"").concat(ref.libraryId, "\""));
-          return null;
-        }
-        var _resolved = JSON.parse(JSON.stringify(_template));
-        _resolved.id = "".concat(_resolved.id, "::").concat(ref.component);
-        if (ref.component) {
-          _resolved.input = _rollupPluginBabelHelpers.objectSpread2(_rollupPluginBabelHelpers.objectSpread2({}, _resolved.input), {}, {
-            component: ref.component
-          });
-          _resolved.output = _rollupPluginBabelHelpers.objectSpread2(_rollupPluginBabelHelpers.objectSpread2({}, _resolved.output), {}, {
-            component: ref.component
-          });
-        }
-        return _resolved;
-      }
-
-      // ── Device-level L1 ref: { behaviorRef, deviceId, attachment, component } ─
-      if (!ref.deviceId || !ref.attachment) {
-        console.warn('⚠️ _resolveBehaviorRef: incomplete ref', ref);
-        return null;
-      }
-      var deviceData = componentDictionary[ref.deviceId];
-      if (!deviceData) {
-        console.warn("\u26A0\uFE0F _resolveBehaviorRef: device \"".concat(ref.deviceId, "\" not in dictionary"));
-        return null;
-      }
-      var template = (deviceData.defaultBehaviors || []).find(function (b) {
-        return b.id === ref.behaviorRef;
-      });
-      if (!template) {
-        console.warn("\u26A0\uFE0F _resolveBehaviorRef: behavior \"".concat(ref.behaviorRef, "\" not found on device \"").concat(ref.deviceId, "\""));
-        return null;
-      }
-      // Deep clone and substitute 'self' -> real attachmentId
-      var resolved = JSON.parse(JSON.stringify(template));
-      resolved.id = "".concat(resolved.id, "::").concat(ref.attachment);
-      if (((_resolved$input = resolved.input) === null || _resolved$input === void 0 ? void 0 : _resolved$input.attachment) === 'self') resolved.input.attachment = ref.attachment;
-      if (((_resolved$output = resolved.output) === null || _resolved$output === void 0 ? void 0 : _resolved$output.attachment) === 'self') resolved.output.attachment = ref.attachment;
-      // Inject component UUID guard if the ref carries one
-      if (ref.component) {
-        resolved.input = _rollupPluginBabelHelpers.objectSpread2(_rollupPluginBabelHelpers.objectSpread2({}, resolved.input), {}, {
-          component: ref.component
-        });
-        resolved.output = _rollupPluginBabelHelpers.objectSpread2(_rollupPluginBabelHelpers.objectSpread2({}, resolved.output), {}, {
-          component: ref.component
-        });
-      }
-      return resolved;
-    }
-
-    /**
-     * Expand a single defaultBehaviors[] template entry for a specific component
-     * instance placed in the scene.
-     *
-     * If the entry is a behaviorRef, it is first resolved against the device
-     * library; otherwise it is treated as a full behavior definition.
-     * In both cases the instanceUuid is injected as input.component and
-     * output.component, and the behavior id is suffixed with ::instanceUuid.
-     *
-     * @param {Object} template - Entry from compData.defaultBehaviors[]
-     * @param {string} instanceUuid - UUID of the placed component instance
-     * @param {Object} componentDictionary
-     * @returns {Object|null}
-     */
-  }, {
-    key: "_expandDefaultBehavior",
-    value: function _expandDefaultBehavior(template, instanceUuid, componentDictionary) {
-      var base;
-      if (template.behaviorRef) {
-        // Resolve the device ref first (substitutes 'self' -> attachment)
-        base = this._resolveBehaviorRef(template, componentDictionary);
-        if (!base) return null;
-      } else {
-        base = JSON.parse(JSON.stringify(template));
-      }
-      // Suffix the id so each instance gets a unique behavior id
-      base.id = "".concat(base.id, "::").concat(instanceUuid);
-      // Inject the instance UUID as the component scope guard
-      base.input = _rollupPluginBabelHelpers.objectSpread2(_rollupPluginBabelHelpers.objectSpread2({}, base.input), {}, {
-        component: instanceUuid
-      });
-      base.output = _rollupPluginBabelHelpers.objectSpread2(_rollupPluginBabelHelpers.objectSpread2({}, base.output), {}, {
-        component: instanceUuid
-      });
-      return base;
-    }
-
     /**
      * Save original world matrices for direction calculations
      */
@@ -1465,7 +1188,7 @@ var SceneOperationsManager = /*#__PURE__*/function () {
     key: "loadSceneFromData",
     value: (function () {
       var _loadSceneFromData = _rollupPluginBabelHelpers.asyncToGenerator(/*#__PURE__*/_rollupPluginBabelHelpers.regenerator().m(function _callee9(data) {
-        var _data$scene4, _data$scene5, _data$scene6, _data$scene7;
+        var _data$scene3, _data$scene4, _data$scene5, _data$scene6;
         return _rollupPluginBabelHelpers.regenerator().w(function (_context9) {
           while (1) switch (_context9.n) {
             case 0:
@@ -1475,10 +1198,10 @@ var SceneOperationsManager = /*#__PURE__*/function () {
                 dataType: _rollupPluginBabelHelpers["typeof"](data),
                 hasScene: !!(data !== null && data !== void 0 && data.scene),
                 sceneType: _rollupPluginBabelHelpers["typeof"](data === null || data === void 0 ? void 0 : data.scene),
-                hasChildren: !!(data !== null && data !== void 0 && (_data$scene4 = data.scene) !== null && _data$scene4 !== void 0 && _data$scene4.children),
-                childrenType: data !== null && data !== void 0 && (_data$scene5 = data.scene) !== null && _data$scene5 !== void 0 && _data$scene5.children ? _rollupPluginBabelHelpers["typeof"](data.scene.children) : 'undefined',
-                isArray: Array.isArray(data === null || data === void 0 || (_data$scene6 = data.scene) === null || _data$scene6 === void 0 ? void 0 : _data$scene6.children),
-                childrenLength: data === null || data === void 0 || (_data$scene7 = data.scene) === null || _data$scene7 === void 0 || (_data$scene7 = _data$scene7.children) === null || _data$scene7 === void 0 ? void 0 : _data$scene7.length,
+                hasChildren: !!(data !== null && data !== void 0 && (_data$scene3 = data.scene) !== null && _data$scene3 !== void 0 && _data$scene3.children),
+                childrenType: data !== null && data !== void 0 && (_data$scene4 = data.scene) !== null && _data$scene4 !== void 0 && _data$scene4.children ? _rollupPluginBabelHelpers["typeof"](data.scene.children) : 'undefined',
+                isArray: Array.isArray(data === null || data === void 0 || (_data$scene5 = data.scene) === null || _data$scene5 === void 0 ? void 0 : _data$scene5.children),
+                childrenLength: data === null || data === void 0 || (_data$scene6 = data.scene) === null || _data$scene6 === void 0 || (_data$scene6 = _data$scene6.children) === null || _data$scene6 === void 0 ? void 0 : _data$scene6.length,
                 dataKeys: data ? Object.keys(data) : [],
                 sceneKeys: data !== null && data !== void 0 && data.scene ? Object.keys(data.scene) : []
               });
@@ -1609,8 +1332,8 @@ var SceneOperationsManager = /*#__PURE__*/function () {
         // Process children (connectors, etc.) if they exist
         if (componentModel.children && componentModel.children.length > 0) {
           componentModel.children.forEach(function (child) {
-            var _child$userData1, _child$userData10;
-            var childType = ((_child$userData1 = child.userData) === null || _child$userData1 === void 0 ? void 0 : _child$userData1.objectType) || ((_child$userData10 = child.userData) === null || _child$userData10 === void 0 ? void 0 : _child$userData10.objectType);
+            var _child$userData0, _child$userData1;
+            var childType = ((_child$userData0 = child.userData) === null || _child$userData0 === void 0 ? void 0 : _child$userData0.objectType) || ((_child$userData1 = child.userData) === null || _child$userData1 === void 0 ? void 0 : _child$userData1.objectType);
             if (childType === 'connector') {
               var _child$geometry;
               var childBoundingBox = new THREE__namespace.Box3().setFromObject(child);
@@ -1695,8 +1418,8 @@ var SceneOperationsManager = /*#__PURE__*/function () {
       if (segment.children && segment.children.length > 0) {
         var childrenToRemove = _rollupPluginBabelHelpers.toConsumableArray(segment.children);
         childrenToRemove.forEach(function (child) {
-          var _child$userData11;
-          if ((_child$userData11 = child.userData) !== null && _child$userData11 !== void 0 && _child$userData11.isPipeElbow) {
+          var _child$userData10;
+          if ((_child$userData10 = child.userData) !== null && _child$userData10 !== void 0 && _child$userData10.isPipeElbow) {
             console.log("\uD83D\uDDD1\uFE0F Removing elbow child from segment before manualization: ".concat(child.uuid));
             segment.remove(child);
             if (child.geometry) child.geometry.dispose();
@@ -1847,7 +1570,7 @@ var SceneOperationsManager = /*#__PURE__*/function () {
     value: function _convertConnectedGatewaysToManual(connectors, currentSceneData) {
       var _connectors$,
         _segment$userData2,
-        _this7 = this;
+        _this5 = this;
       console.log('🔍 Checking for connected gateways to convert to manual...');
       var sceneViewer = this.sceneViewer;
       var convertedGateways = [];
@@ -1884,7 +1607,7 @@ var SceneOperationsManager = /*#__PURE__*/function () {
             console.log("\uD83D\uDD27 Found computed gateway at endpoint: ".concat(endpointObject.uuid, " - converting to manual"));
 
             // Convert gateway to manual (declared) using manualizeGateway for consistency
-            _this7.manualizeGateway(endpointObject, currentSceneData);
+            _this5.manualizeGateway(endpointObject, currentSceneData);
             convertedGateways.push(endpointObject);
           } else if (((_endpointObject$userD5 = endpointObject.userData) === null || _endpointObject$userD5 === void 0 ? void 0 : _endpointObject$userD5.objectType) === 'gateway' && ((_endpointObject$userD6 = endpointObject.userData) === null || _endpointObject$userD6 === void 0 ? void 0 : _endpointObject$userD6.isDeclared) === true) {
             console.log("\u2139\uFE0F Gateway ".concat(endpointObject.uuid, " is already declared (manual), skipping conversion"));

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

@@ -233,6 +233,34 @@ function computeIODeviceBoundingBoxes(componentObject) {
  * const helpers = createSelectionBoxHelpers(pumpModel, 0x00ff00)
  * helpers.forEach(h => scene.add(h))
  */
+/**
+ * Returns a filtered bounding box for `object`, using a cache stored on
+ * `object.userData._filteredBBoxCache`.  The cache key is the serialised
+ * world-matrix elements string; if the object has moved the cache is
+ * automatically invalidated and recomputed.
+ *
+ * This avoids the expensive full-traverse on every selection event for
+ * large smart components with many child meshes.
+ *
+ * @param {THREE.Object3D} object
+ * @param {string[]} excludeTypes
+ * @returns {THREE.Box3}
+ */
+function computeFilteredBoundingBoxCached(object, excludeTypes) {
+  object.updateMatrixWorld(true);
+  var matrixKey = object.matrixWorld.elements.join(',');
+  var cache = object.userData._filteredBBoxCache;
+  if (cache && cache.matrixKey === matrixKey) {
+    return new THREE__namespace.Box3(_rollupPluginBabelHelpers.construct(THREE__namespace.Vector3, _rollupPluginBabelHelpers.toConsumableArray(cache.min)), _rollupPluginBabelHelpers.construct(THREE__namespace.Vector3, _rollupPluginBabelHelpers.toConsumableArray(cache.max)));
+  }
+  var box = computeFilteredBoundingBox(object, excludeTypes);
+  object.userData._filteredBBoxCache = {
+    matrixKey: matrixKey,
+    min: box.min.toArray(),
+    max: box.max.toArray()
+  };
+  return box;
+}
 function createSelectionBoxHelpers(object) {
   var _object$children;
   var color = arguments.length > 1 && arguments[1] !== undefined ? arguments[1] : 0x00ff00;
@@ -246,7 +274,7 @@ function createSelectionBoxHelpers(object) {
   });
   if (hasIODevices) {
     // 1. Create filtered helper for the component body
-    var filteredBox = computeFilteredBoundingBox(object, excludeTypes);
+    var filteredBox = computeFilteredBoundingBoxCached(object, excludeTypes);
     var componentHelper = _createBoxHelperFromBox3(filteredBox, color);
     componentHelper.isHelper = true;
     componentHelper.userData = {
@@ -256,33 +284,6 @@ function createSelectionBoxHelpers(object) {
       excludeTypes: excludeTypes
     };
     helpers.push(componentHelper);
-
-    // 2. Create individual helpers for each io-device
-    var _iterator2 = _rollupPluginBabelHelpers.createForOfIteratorHelper(object.children),
-      _step2;
-    try {
-      for (_iterator2.s(); !(_step2 = _iterator2.n()).done;) {
-        var _child$userData3;
-        var child = _step2.value;
-        if (((_child$userData3 = child.userData) === null || _child$userData3 === void 0 ? void 0 : _child$userData3.objectType) !== 'io-device') continue;
-        var deviceBox = new THREE__namespace.Box3().setFromObject(child);
-        if (deviceBox.isEmpty()) continue;
-        var deviceHelper = _createBoxHelperFromBox3(deviceBox, color);
-        deviceHelper.isHelper = true;
-        deviceHelper.userData = {
-          isBoundingBox: true,
-          sourceObjectUuid: child.uuid,
-          isFiltered: false,
-          isIODevice: true,
-          parentComponentUuid: object.uuid
-        };
-        helpers.push(deviceHelper);
-      }
-    } catch (err) {
-      _iterator2.e(err);
-    } finally {
-      _iterator2.f();
-    }
   } else {
     // Standard BoxHelper for non-smart objects
     var boxHelper = new THREE__namespace.BoxHelper(object, color);
@@ -306,11 +307,11 @@ function createSelectionBoxHelpers(object) {
  * @param {THREE.Scene} scene - The scene (for finding objects by uuid)
  */
 function updateSelectionBoxHelpers(helpers, selectedObjects, scene) {
-  var _iterator3 = _rollupPluginBabelHelpers.createForOfIteratorHelper(helpers),
-    _step3;
+  var _iterator2 = _rollupPluginBabelHelpers.createForOfIteratorHelper(helpers),
+    _step2;
   try {
     var _loop = function _loop() {
-      var helper = _step3.value;
+      var helper = _step2.value;
       var _helper$userData = helper.userData,
         sourceObjectUuid = _helper$userData.sourceObjectUuid,
         isFiltered = _helper$userData.isFiltered,
@@ -333,29 +334,26 @@ function updateSelectionBoxHelpers(helpers, selectedObjects, scene) {
       if (!sourceObject) return 1; // continue
       sourceObject.updateMatrixWorld(true);
       if (isFiltered && excludeTypes) {
-        // Recompute filtered bbox
-        var box = computeFilteredBoundingBox(sourceObject, excludeTypes);
+        // Recompute filtered bbox (uses cache when the object hasn't moved)
+        var box = computeFilteredBoundingBoxCached(sourceObject, excludeTypes);
         _updateBoxHelperPositions(helper, box);
-      } else if (isIODevice) {
-        // Recompute io-device bbox
-        var _box = new THREE__namespace.Box3().setFromObject(sourceObject);
-        _updateBoxHelperPositions(helper, _box);
       } else if (helper.update) {
         // Standard BoxHelper — use built-in update
         helper.update();
       }
     };
-    for (_iterator3.s(); !(_step3 = _iterator3.n()).done;) {
+    for (_iterator2.s(); !(_step2 = _iterator2.n()).done;) {
       if (_loop()) continue;
     }
   } catch (err) {
-    _iterator3.e(err);
+    _iterator2.e(err);
   } finally {
-    _iterator3.f();
+    _iterator2.f();
   }
 }
 
 exports.computeFilteredBoundingBox = computeFilteredBoundingBox;
+exports.computeFilteredBoundingBoxCached = computeFilteredBoundingBoxCached;
 exports.computeIODeviceBoundingBoxes = computeIODeviceBoundingBoxes;
 exports.createSelectionBoxHelpers = createSelectionBoxHelpers;
 exports.updateSelectionBoxHelpers = updateSelectionBoxHelpers;

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

@@ -31,7 +31,7 @@ var CentralPlant = /*#__PURE__*/function (_BaseDisposable) {
    * Initialize the CentralPlant manager
    * 
    * @constructor
-   * @version 0.3.26
+   * @version 0.3.28
    * @updated 2025-10-22
    * 
    * @description Creates a new CentralPlant instance and initializes internal managers and utilities.
@@ -1065,107 +1065,6 @@ var CentralPlant = /*#__PURE__*/function (_BaseDisposable) {
       };
     }
 
-    // ─────────────────────────────────────────────────────────────────────────
-    // BEHAVIORS API
-    // ─────────────────────────────────────────────────────────────────────────
-
-    /**
-     * Get all behavior definitions currently stored in the BehaviorManager.
-     * @returns {Array<Object>} Array of behavior definition objects, or empty array.
-     * @example
-     * const behaviors = centralPlant.getBehaviors()
-     * behaviors.forEach(b => console.log(b.id, b.input, b.output))
-     */
-  }, {
-    key: "getBehaviors",
-    value: function getBehaviors() {
-      var _this$sceneViewer4;
-      var bm = (_this$sceneViewer4 = this.sceneViewer) === null || _this$sceneViewer4 === void 0 || (_this$sceneViewer4 = _this$sceneViewer4.managers) === null || _this$sceneViewer4 === void 0 ? void 0 : _this$sceneViewer4.behaviorManager;
-      if (!bm) {
-        console.warn('⚠️ getBehaviors(): BehaviorManager not available');
-        return [];
-      }
-      return bm.getBehaviors();
-    }
-
-    /**
-     * Add a behavior definition at runtime.
-     * @param {Object} behaviorDef - Full behavior definition object (must have unique `id`)
-     * @returns {boolean} True if added successfully, false otherwise
-     * @example
-     * centralPlant.addBehavior({
-     *   id: 'my-behavior',
-     *   input: { attachment: 'device-01', dataPoint: 'boolean-status-01' },
-     *   output: { attachment: 'light-01', child: 'indicator-mesh-01' },
-     *   conditions: [{ when: 'dataPoint.value === true', actions: [{ set: 'material.emissiveIntensity', value: 1.0 }] }]
-     * })
-     */
-  }, {
-    key: "addBehavior",
-    value: function addBehavior(behaviorDef) {
-      var _this$sceneViewer5, _this$sceneViewer6;
-      var bm = (_this$sceneViewer5 = this.sceneViewer) === null || _this$sceneViewer5 === void 0 || (_this$sceneViewer5 = _this$sceneViewer5.managers) === null || _this$sceneViewer5 === void 0 ? void 0 : _this$sceneViewer5.behaviorManager;
-      if (!bm) {
-        console.warn('⚠️ addBehavior(): BehaviorManager not available');
-        return false;
-      }
-      // Also persist into currentSceneData so export includes it
-      if ((_this$sceneViewer6 = this.sceneViewer) !== null && _this$sceneViewer6 !== void 0 && _this$sceneViewer6.currentSceneData) {
-        if (!Array.isArray(this.sceneViewer.currentSceneData.behaviors)) {
-          this.sceneViewer.currentSceneData.behaviors = [];
-        }
-        this.sceneViewer.currentSceneData.behaviors.push(behaviorDef);
-      }
-      return bm.addBehavior(behaviorDef);
-    }
-
-    /**
-     * Remove a behavior definition by id.
-     * @param {string} behaviorId
-     * @returns {boolean} True if removed, false if not found
-     * @example
-     * centralPlant.removeBehavior('my-behavior')
-     */
-  }, {
-    key: "removeBehavior",
-    value: function removeBehavior(behaviorId) {
-      var _this$sceneViewer7, _this$sceneViewer8;
-      var bm = (_this$sceneViewer7 = this.sceneViewer) === null || _this$sceneViewer7 === void 0 || (_this$sceneViewer7 = _this$sceneViewer7.managers) === null || _this$sceneViewer7 === void 0 ? void 0 : _this$sceneViewer7.behaviorManager;
-      if (!bm) {
-        console.warn('⚠️ removeBehavior(): BehaviorManager not available');
-        return false;
-      }
-      // Also remove from currentSceneData
-      if ((_this$sceneViewer8 = this.sceneViewer) !== null && _this$sceneViewer8 !== void 0 && (_this$sceneViewer8 = _this$sceneViewer8.currentSceneData) !== null && _this$sceneViewer8 !== void 0 && _this$sceneViewer8.behaviors) {
-        var idx = this.sceneViewer.currentSceneData.behaviors.findIndex(function (b) {
-          return b.id === behaviorId;
-        });
-        if (idx !== -1) this.sceneViewer.currentSceneData.behaviors.splice(idx, 1);
-      }
-      return bm.removeBehavior(behaviorId);
-    }
-
-    /**
-     * Simulate an IO device state value arriving and trigger any matching behaviors.
-     * Useful for live testing in the UI or for integration with real data feeds.
-     * @param {string} attachmentId - The attachment id of the input io-device
-     * @param {string} stateId      - The state id on that device
-     * @param {*}      value        - The new state value
-     * @example
-     * centralPlant.triggerState('pump-push-button-01', 'power', true)
-     */
-  }, {
-    key: "triggerState",
-    value: function triggerState(attachmentId, stateId, value, parentUuid) {
-      var _this$sceneViewer9;
-      var bm = (_this$sceneViewer9 = this.sceneViewer) === null || _this$sceneViewer9 === void 0 || (_this$sceneViewer9 = _this$sceneViewer9.managers) === null || _this$sceneViewer9 === void 0 ? void 0 : _this$sceneViewer9.behaviorManager;
-      if (!bm) {
-        console.warn('⚠️ triggerState(): BehaviorManager not available');
-        return;
-      }
-      bm.triggerState(attachmentId, stateId, value, parentUuid);
-    }
-
     /**
      * Set the state of an I/O device instance in the Three.js scene.
      *
@@ -1198,15 +1097,9 @@ var CentralPlant = /*#__PURE__*/function (_BaseDisposable) {
   }, {
     key: "setIoDeviceState",
     value: function setIoDeviceState(attachmentId, stateId, value, parentUuid) {
-      var _this$sceneViewer0, _this$sceneViewer1, _this$sceneViewer10;
-      var bm = (_this$sceneViewer0 = this.sceneViewer) === null || _this$sceneViewer0 === void 0 || (_this$sceneViewer0 = _this$sceneViewer0.managers) === null || _this$sceneViewer0 === void 0 ? void 0 : _this$sceneViewer0.behaviorManager;
-      if (!bm) {
-        console.warn('⚠️ setIoDeviceState(): BehaviorManager not available');
-        return false;
-      }
-
+      var _this$sceneViewer4, _this$sceneViewer5, _this$sceneViewer6;
       // 1. Persist via state adapter if one has been configured
-      var stateAdapter = (_this$sceneViewer1 = this.sceneViewer) === null || _this$sceneViewer1 === void 0 || (_this$sceneViewer1 = _this$sceneViewer1.managers) === null || _this$sceneViewer1 === void 0 || (_this$sceneViewer1 = _this$sceneViewer1.componentTooltipManager) === null || _this$sceneViewer1 === void 0 ? void 0 : _this$sceneViewer1._stateAdapter;
+      var stateAdapter = (_this$sceneViewer4 = this.sceneViewer) === null || _this$sceneViewer4 === void 0 || (_this$sceneViewer4 = _this$sceneViewer4.managers) === null || _this$sceneViewer4 === void 0 || (_this$sceneViewer4 = _this$sceneViewer4.componentTooltipManager) === null || _this$sceneViewer4 === void 0 ? void 0 : _this$sceneViewer4._stateAdapter;
       if (stateAdapter !== null && stateAdapter !== void 0 && stateAdapter.setState) {
         var scopedKey = parentUuid ? "".concat(parentUuid, "::").concat(attachmentId) : attachmentId;
         try {
@@ -1216,11 +1109,11 @@ var CentralPlant = /*#__PURE__*/function (_BaseDisposable) {
         }
       }
 
-      // 2. Apply Three.js behavior changes
-      bm.triggerState(attachmentId, stateId, value, parentUuid);
+      // 2. Apply io-animation changes
+      (_this$sceneViewer5 = this.sceneViewer) === null || _this$sceneViewer5 === void 0 || (_this$sceneViewer5 = _this$sceneViewer5.managers) === null || _this$sceneViewer5 === void 0 || (_this$sceneViewer5 = _this$sceneViewer5.ioAnimationManager) === null || _this$sceneViewer5 === void 0 || _this$sceneViewer5.triggerState(attachmentId, stateId, value, parentUuid);
 
       // 3. Emit event for host apps that don't use the state adapter (e.g. cp3d-viewer)
-      (_this$sceneViewer10 = this.sceneViewer) === null || _this$sceneViewer10 === void 0 || _this$sceneViewer10.emit('io-device-state-changed', {
+      (_this$sceneViewer6 = this.sceneViewer) === null || _this$sceneViewer6 === void 0 || _this$sceneViewer6.emit('io-device-state-changed', {
         attachmentId: attachmentId,
         stateId: stateId,
         value: value,
@@ -1242,8 +1135,8 @@ var CentralPlant = /*#__PURE__*/function (_BaseDisposable) {
   }, {
     key: "getSceneAttachments",
     value: function getSceneAttachments() {
-      var _this$sceneViewer11;
-      var scene = (_this$sceneViewer11 = this.sceneViewer) === null || _this$sceneViewer11 === void 0 ? void 0 : _this$sceneViewer11.scene;
+      var _this$sceneViewer7;
+      var scene = (_this$sceneViewer7 = this.sceneViewer) === null || _this$sceneViewer7 === void 0 ? void 0 : _this$sceneViewer7.scene;
       if (!scene) return [];
       var results = [];
       scene.traverse(function (obj) {