@2112-lab/central-plant 0.1.92 → 0.1.94

package/dist/bundle/index.js

@@ -3957,6 +3957,17 @@ var TransformControlsManager = /*#__PURE__*/function () {
             obj.userData._multiSelectOriginalRotation = obj.rotation.clone();
             obj.userData._multiSelectOriginalScale = obj.scale.clone();
           });
+
+          // Snapshot group position and helper geometry vertices so we can do
+          // cheap per-frame bbox translation without re-traversing the mesh hierarchy.
+          _this2._dragStartGroupPosition = _this2.multiSelectionGroup.position.clone();
+          _this2.boundingBoxHelpers.forEach(function (helper) {
+            var _helper$geometry;
+            var posAttr = (_helper$geometry = helper.geometry) === null || _helper$geometry === void 0 || (_helper$geometry = _helper$geometry.attributes) === null || _helper$geometry === void 0 ? void 0 : _helper$geometry.position;
+            if (posAttr) {
+              helper.userData._dragStartPositions = new Float32Array(posAttr.array);
+            }
+          });
         }
 
         // Disable orbit controls during transformation
@@ -4021,6 +4032,13 @@ var TransformControlsManager = /*#__PURE__*/function () {
                 }
               }
             case 3:
+              // Ensure the bounding box reflects the final post-drag object position.
+              // applyMultiSelectionTransform calls _finalizeMultiSelectionTransform →
+              // createMultiBoundingBox for moves above the threshold.  Call updateBoundingBox
+              // here as a safety net for sub-threshold moves or rotation mode, where
+              // _finalizeMultiSelectionTransform is not triggered.
+              _this2.updateBoundingBox();
+
               // Dispatch custom scene update event after transform completes
               if (typeof window !== 'undefined') {
                 console.log('📡 Dispatching sceneUpdateComplete event after transform');
@@ -4034,6 +4052,12 @@ var TransformControlsManager = /*#__PURE__*/function () {
                 });
                 window.dispatchEvent(sceneCompleteEvent);
               }
+
+              // Clean up per-drag snapshots
+              _this2._dragStartGroupPosition = null;
+              _this2.boundingBoxHelpers.forEach(function (helper) {
+                delete helper.userData._dragStartPositions;
+              });
               console.log("\u2705 Transform completed: ".concat(_this2.currentMode, " mode"));
             case 4:
               return _context.a(2);
@@ -4042,33 +4066,16 @@ var TransformControlsManager = /*#__PURE__*/function () {
       }));
       // Transform changing event
       this.eventHandlers.transforming = function () {
-        // Apply real-time visual transformation to objects during drag
+        // Apply real-time visual transformation to objects during drag.
         if (_this2.selectedObjects.length > 0 && _this2.multiSelectionGroup) {
           _this2.applyRealtimeTransform();
         }
 
-        // Clear the bounding box cache for all selected objects during transformation
-        _this2.selectedObjects.forEach(function (obj) {
-          if (_this2.boundingBoxCache.has(obj)) {
-            _this2.boundingBoxCache.delete(obj);
-          }
-        });
-
-        // Update bounding box during transformation
-        _this2.updateBoundingBox();
-
-        // Dispatch custom scene update event during transform (optional - fires continuously)
-        if (typeof window !== 'undefined') {
-          var _this2$selectedObject2;
-          var sceneCompleteEvent = new CustomEvent('sceneUpdateComplete', {
-            detail: {
-              timestamp: Date.now(),
-              transformType: _this2.currentMode,
-              objectName: ((_this2$selectedObject2 = _this2.selectedObjects[0]) === null || _this2$selectedObject2 === void 0 ? void 0 : _this2$selectedObject2.name) || 'unknown',
-              isTransforming: true
-            }
-          });
-          window.dispatchEvent(sceneCompleteEvent);
+        // Per-frame bbox tracking: during translate we can cheaply shift the
+        // pre-snapshotted helper geometry vertices by the drag delta instead of
+        // re-traversing the full mesh hierarchy every pointermove.
+        if (_this2.currentMode === 'translate') {
+          _this2._applyDeltaToBoundingBoxHelpers();
         }
       };
       // First remove any existing listeners to prevent duplicates
@@ -4821,6 +4828,43 @@ var TransformControlsManager = /*#__PURE__*/function () {
       }
     }
 
+    /**
+     * Cheap per-frame bounding box update during translation drag.
+     * Shifts the 8 pre-snapshotted geometry vertices of every helper by the
+     * current drag delta. O(8 additions per helper) — no mesh traversal.
+     * Only valid for translate mode where the box shape is invariant.
+     * @private
+     */
+  }, {
+    key: "_applyDeltaToBoundingBoxHelpers",
+    value: function _applyDeltaToBoundingBoxHelpers() {
+      if (!this._dragStartGroupPosition || this.boundingBoxHelpers.length === 0) return;
+      var delta = this.multiSelectionGroup.position.clone().sub(this._dragStartGroupPosition);
+      var _iterator3 = _createForOfIteratorHelper(this.boundingBoxHelpers),
+        _step3;
+      try {
+        for (_iterator3.s(); !(_step3 = _iterator3.n()).done;) {
+          var _helper$geometry2;
+          var helper = _step3.value;
+          var startPositions = helper.userData._dragStartPositions;
+          var posAttr = (_helper$geometry2 = helper.geometry) === null || _helper$geometry2 === void 0 || (_helper$geometry2 = _helper$geometry2.attributes) === null || _helper$geometry2 === void 0 ? void 0 : _helper$geometry2.position;
+          if (!startPositions || !posAttr) continue;
+          var arr = posAttr.array;
+          // 8 vertices × 3 floats (x, y, z)
+          for (var i = 0; i < 24; i += 3) {
+            arr[i] = startPositions[i] + delta.x;
+            arr[i + 1] = startPositions[i + 1] + delta.y;
+            arr[i + 2] = startPositions[i + 2] + delta.z;
+          }
+          posAttr.needsUpdate = true;
+        }
+      } catch (err) {
+        _iterator3.e(err);
+      } finally {
+        _iterator3.f();
+      }
+    }
+
     /**
      * Set the transformation mode
      * @param {'translate' | 'rotate' | 'scale'} mode - The transformation mode
@@ -5195,11 +5239,11 @@ var TransformControlsManager = /*#__PURE__*/function () {
       var objectFilter = arguments.length > 1 && arguments[1] !== undefined ? arguments[1] : null;
       var objectsWithBounds = this.getSelectableObjectsWithBounds(objectFilter);
       var intersections = [];
-      var _iterator3 = _createForOfIteratorHelper(objectsWithBounds),
-        _step3;
+      var _iterator4 = _createForOfIteratorHelper(objectsWithBounds),
+        _step4;
       try {
-        for (_iterator3.s(); !(_step3 = _iterator3.n()).done;) {
-          var item = _step3.value;
+        for (_iterator4.s(); !(_step4 = _iterator4.n()).done;) {
+          var item = _step4.value;
           var object = item.object,
             boundingBox = item.boundingBox;
 
@@ -5219,9 +5263,9 @@ var TransformControlsManager = /*#__PURE__*/function () {
 
         // Sort by distance (closest first)
       } catch (err) {
-        _iterator3.e(err);
+        _iterator4.e(err);
       } finally {
-        _iterator3.f();
+        _iterator4.f();
       }
       intersections.sort(function (a, b) {
         return a.distance - b.distance;
@@ -11457,11 +11501,35 @@ var SceneExportManager = /*#__PURE__*/function () {
         // For connectors/gateways: no children (they're leaf nodes)
         if (threeObject.children && threeObject.children.length > 0) {
           var exportableChildren = [];
-          if (threeObject.userData.objectType === 'component') ; else if (isManualSegment) {
-            // For manual segments, export their connector children
+          if (threeObject.userData.objectType === 'component') {
+            // Export connector children (skip mesh geometry - it lives in the component dictionary GLB)
             threeObject.children.forEach(function (child) {
               var _child$userData;
-              if (((_child$userData = child.userData) === null || _child$userData === void 0 ? void 0 : _child$userData.objectType) === 'segment-connector') {
+              if (((_child$userData = child.userData) === null || _child$userData === void 0 ? void 0 : _child$userData.objectType) === 'connector') {
+                var connectorJson = {
+                  // Use the raw Three.js UUID — connections in currentSceneData reference this exact value
+                  uuid: child.uuid,
+                  userData: _objectSpread2(_objectSpread2({
+                    objectType: 'connector'
+                  }, child.userData.direction ? {
+                    direction: child.userData.direction
+                  } : {}), child.userData.group ? {
+                    group: child.userData.group
+                  } : {}),
+                  position: {
+                    x: roundIfClose(child.position.x),
+                    y: roundIfClose(child.position.y),
+                    z: roundIfClose(child.position.z)
+                  }
+                };
+                exportableChildren.push(connectorJson);
+              }
+            });
+          } else if (isManualSegment) {
+            // For manual segments, export their connector children
+            threeObject.children.forEach(function (child) {
+              var _child$userData2;
+              if (((_child$userData2 = child.userData) === null || _child$userData2 === void 0 ? void 0 : _child$userData2.objectType) === 'segment-connector') {
                 // Call the class method using bound reference
                 var connectorJson = convertSegmentConnectorToJson(child, threeObject);
                 if (connectorJson) {
@@ -11487,9 +11555,9 @@ var SceneExportManager = /*#__PURE__*/function () {
       var findManualSegments = function findManualSegments(object) {
         var manualSegments = [];
         object.traverse(function (child) {
-          var _child$userData2;
+          var _child$userData3;
           // Check if this is a manual segment
-          if (((_child$userData2 = child.userData) === null || _child$userData2 === void 0 ? void 0 : _child$userData2.objectType) === 'segment') {
+          if (((_child$userData3 = child.userData) === null || _child$userData3 === void 0 ? void 0 : _child$userData3.objectType) === 'segment') {
             manualSegments.push(child);
           }
         });
@@ -11518,10 +11586,23 @@ var SceneExportManager = /*#__PURE__*/function () {
       // Helper function to extract behaviors from current scene data
       var extractBehaviors = function extractBehaviors() {
         var _this$sceneViewer, _this$sceneViewer2;
+        // Only export behaviors that are NOT re-derivable from a component's
+        // defaultBehaviors[].  All component/device default behaviors are
+        // reconstructed at load time by Step B of _processBehaviors() using the
+        // component dictionary, so writing compact behaviorRef entries for them
+        // would be redundant.  The scene JSON behaviors[] array is reserved for
+        // any future scene-level overrides that cannot be derived from the asset.
         if ((_this$sceneViewer = _this.sceneViewer) !== null && _this$sceneViewer !== void 0 && (_this$sceneViewer = _this$sceneViewer.managers) !== null && _this$sceneViewer !== void 0 && _this$sceneViewer.behaviorManager) {
-          return _this.sceneViewer.managers.behaviorManager.getBehaviors();
+          return _this.sceneViewer.managers.behaviorManager.getBehaviors().filter(function (b) {
+            return !b._isDefaultBehavior;
+          });
         }
-        return ((_this$sceneViewer2 = _this.sceneViewer) === null || _this$sceneViewer2 === void 0 || (_this$sceneViewer2 = _this$sceneViewer2.currentSceneData) === null || _this$sceneViewer2 === void 0 ? void 0 : _this$sceneViewer2.behaviors) || [];
+        // Fallback when BehaviorManager is not available: exclude any entry that
+        // was already a behaviorRef (it was derivable from the component asset)
+        // and exclude the legacy _isDefaultBehavior marker if present.
+        return (((_this$sceneViewer2 = _this.sceneViewer) === null || _this$sceneViewer2 === void 0 || (_this$sceneViewer2 = _this$sceneViewer2.currentSceneData) === null || _this$sceneViewer2 === void 0 ? void 0 : _this$sceneViewer2.behaviors) || []).filter(function (b) {
+          return !b.behaviorRef && !b._isDefaultBehavior;
+        });
       };
 
       // Build the complete export data structure (matching central-plant-input.json format)
@@ -11676,14 +11757,14 @@ var SceneExportManager = /*#__PURE__*/function () {
               BufferGeometryUtils$1 = BufferGeometryUtilsModule.BufferGeometryUtils || BufferGeometryUtilsModule.default || BufferGeometryUtilsModule; // Create a new scene for export instead of cloning
               exportScene = new _THREE.Scene(); // Helper function to check if an object should be exported
               shouldExport = function shouldExport(child) {
-                var _child$name2, _child$userData3, _child$userData4, _child$userData5, _child$userData6;
+                var _child$name2, _child$userData4, _child$userData5, _child$userData6, _child$userData7;
                 if ((_child$name2 = child.name) !== null && _child$name2 !== void 0 && _child$name2.includes('Polyline')) return false; // Will handle separately
                 if (child.name === 'fogPlane') return false; // Skip fog plane
-                if ((_child$userData3 = child.userData) !== null && _child$userData3 !== void 0 && _child$userData3.isBrickWall) return false; // Skip environment
-                if ((_child$userData4 = child.userData) !== null && _child$userData4 !== void 0 && _child$userData4.isBaseGround) return false; // Skip environment
-                if ((_child$userData5 = child.userData) !== null && _child$userData5 !== void 0 && _child$userData5.isBaseGrid) return false; // Skip environment
+                if ((_child$userData4 = child.userData) !== null && _child$userData4 !== void 0 && _child$userData4.isBrickWall) return false; // Skip environment
+                if ((_child$userData5 = child.userData) !== null && _child$userData5 !== void 0 && _child$userData5.isBaseGround) return false; // Skip environment
+                if ((_child$userData6 = child.userData) !== null && _child$userData6 !== void 0 && _child$userData6.isBaseGrid) return false; // Skip environment
                 if (child.isLight) return false; // Skip lights
-                if ((_child$userData6 = child.userData) !== null && _child$userData6 !== void 0 && _child$userData6.isTransformControls) return false; // Skip transform controls
+                if ((_child$userData7 = child.userData) !== null && _child$userData7 !== void 0 && _child$userData7.isTransformControls) return false; // Skip transform controls
                 if (child.isTransformControls) return false; // Skip transform controls
                 if (child.type && child.type.includes('TransformControls')) return false;
                 if (child.type && child.type.includes('Helper')) return false; // Skip helpers
@@ -19510,62 +19591,43 @@ var ComponentDataManager = /*#__PURE__*/function (_BaseDisposable) {
     key: "_loadComponentDictionary",
     value: (function () {
       var _loadComponentDictionary2 = _asyncToGenerator(/*#__PURE__*/_regenerator().m(function _callee6() {
-        var _yield$import, getCachedLocalJson, response, _t4, _t5;
+        var response, _t4;
         return _regenerator().w(function (_context6) {
           while (1) switch (_context6.n) {
             case 0:
               _context6.p = 0;
-              if (!(typeof window !== 'undefined' && 'caches' in window)) {
-                _context6.n = 5;
-                break;
-              }
-              _context6.p = 1;
-              _context6.n = 2;
-              return Promise.resolve().then(function () { return /*#__PURE__*/_interopNamespace(require('~/utils/s3Cache')); });
-            case 2:
-              _yield$import = _context6.v;
-              getCachedLocalJson = _yield$import.getCachedLocalJson;
-              _context6.n = 3;
-              return getCachedLocalJson('/library/component-dictionary.json');
-            case 3:
-              this.componentDictionary = _context6.v;
-              console.log('📚 ComponentDataManager: Component dictionary loaded from cache');
-              return _context6.a(2);
-            case 4:
-              _context6.p = 4;
-              _t4 = _context6.v;
-              console.warn('⚠️ ComponentDataManager: Cache load failed, falling back to direct fetch:', _t4);
-            case 5:
-              _context6.n = 6;
-              return fetch('/library/component-dictionary.json');
-            case 6:
+              _context6.n = 1;
+              return fetch('/library/component-dictionary.json', {
+                cache: 'no-cache'
+              });
+            case 1:
               response = _context6.v;
               if (!response.ok) {
-                _context6.n = 8;
+                _context6.n = 3;
                 break;
               }
-              _context6.n = 7;
+              _context6.n = 2;
               return response.json();
-            case 7:
+            case 2:
               this.componentDictionary = _context6.v;
               console.log('📚 ComponentDataManager: Component dictionary loaded successfully');
-              _context6.n = 9;
+              _context6.n = 4;
               break;
-            case 8:
+            case 3:
               console.warn('⚠️ ComponentDataManager: Could not load component dictionary');
               this.componentDictionary = null;
-            case 9:
-              _context6.n = 11;
+            case 4:
+              _context6.n = 6;
               break;
-            case 10:
-              _context6.p = 10;
-              _t5 = _context6.v;
-              console.warn('⚠️ ComponentDataManager: Error loading component dictionary:', _t5);
+            case 5:
+              _context6.p = 5;
+              _t4 = _context6.v;
+              console.warn('⚠️ ComponentDataManager: Error loading component dictionary:', _t4);
               this.componentDictionary = null;
-            case 11:
+            case 6:
               return _context6.a(2);
           }
-        }, _callee6, this, [[1, 4], [0, 10]]);
+        }, _callee6, this, [[0, 5]]);
       }));
       function _loadComponentDictionary() {
         return _loadComponentDictionary2.apply(this, arguments);
@@ -19814,6 +19876,8 @@ var ComponentDataManager = /*#__PURE__*/function (_BaseDisposable) {
         boundingBox: component.boundingBox || null,
         adaptedBoundingBox: component.adaptedBoundingBox || null,
         children: component.children || [],
+        meshChildren: component.meshChildren || [],
+        defaultBehaviors: component.defaultBehaviors || [],
         specifications: ((_component$metadata2 = component.metadata) === null || _component$metadata2 === void 0 ? void 0 : _component$metadata2.specifications) || {},
         description: ((_component$metadata3 = component.metadata) === null || _component$metadata3 === void 0 ? void 0 : _component$metadata3.description) || ''
       });
@@ -30710,6 +30774,9 @@ var SceneOperationsManager = /*#__PURE__*/function () {
               // Phase 6: Load behaviors (after GLB models are present so output objects can be resolved)
               this._processBehaviors(data);
               console.log('✅ Scene loaded successfully');
+
+              // Notify UI components (e.g. SceneHierarchy) that the scene is fully loaded
+              this.sceneViewer.emit('scene-loaded');
               _context4.n = 7;
               break;
             case 6:
@@ -31062,20 +31129,252 @@ var SceneOperationsManager = /*#__PURE__*/function () {
     }
 
     /**
-     * Process behaviors from the scene data and pass them to the BehaviorManager.
+     * 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;
-      if (!(data !== null && data !== void 0 && data.behaviors) || !Array.isArray(data.behaviors)) return;
+      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;
       }
-      behaviorManager.loadBehaviors(data.behaviors);
+
+      // 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 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 = _this5._expandDefaultBehavior(template, instanceUuid, componentDictionary);
+            if (!expanded) return;
+            // Skip if an explicit scene behavior already covers this id
+            if (explicitIds.has(expanded.id)) 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 = _objectSpread2(_objectSpread2({}, _resolved.input), {}, {
+            component: ref.component
+          });
+          _resolved.output = _objectSpread2(_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 = _objectSpread2(_objectSpread2({}, resolved.input), {}, {
+          component: ref.component
+        });
+        resolved.output = _objectSpread2(_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 = _objectSpread2(_objectSpread2({}, base.input), {}, {
+        component: instanceUuid
+      });
+      base.output = _objectSpread2(_objectSpread2({}, base.output), {}, {
+        component: instanceUuid
+      });
+      return base;
     }
 
     /**
@@ -31146,7 +31445,7 @@ var SceneOperationsManager = /*#__PURE__*/function () {
     key: "loadSceneFromData",
     value: (function () {
       var _loadSceneFromData = _asyncToGenerator(/*#__PURE__*/_regenerator().m(function _callee9(data) {
-        var _data$scene3, _data$scene4, _data$scene5, _data$scene6;
+        var _data$scene4, _data$scene5, _data$scene6, _data$scene7;
         return _regenerator().w(function (_context9) {
           while (1) switch (_context9.n) {
             case 0:
@@ -31156,10 +31455,10 @@ var SceneOperationsManager = /*#__PURE__*/function () {
                 dataType: _typeof(data),
                 hasScene: !!(data !== null && data !== void 0 && data.scene),
                 sceneType: _typeof(data === null || data === void 0 ? void 0 : data.scene),
-                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 ? _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,
+                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 ? _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,
                 dataKeys: data ? Object.keys(data) : [],
                 sceneKeys: data !== null && data !== void 0 && data.scene ? Object.keys(data.scene) : []
               });
@@ -31290,8 +31589,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$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);
+            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);
             if (childType === 'connector') {
               var _child$geometry;
               var childBoundingBox = new THREE__namespace.Box3().setFromObject(child);
@@ -31376,8 +31675,8 @@ var SceneOperationsManager = /*#__PURE__*/function () {
       if (segment.children && segment.children.length > 0) {
         var childrenToRemove = _toConsumableArray(segment.children);
         childrenToRemove.forEach(function (child) {
-          var _child$userData10;
-          if ((_child$userData10 = child.userData) !== null && _child$userData10 !== void 0 && _child$userData10.isPipeElbow) {
+          var _child$userData11;
+          if ((_child$userData11 = child.userData) !== null && _child$userData11 !== void 0 && _child$userData11.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();
@@ -31528,7 +31827,7 @@ var SceneOperationsManager = /*#__PURE__*/function () {
     value: function _convertConnectedGatewaysToManual(connectors, currentSceneData) {
       var _connectors$,
         _segment$userData2,
-        _this5 = this;
+        _this7 = this;
       console.log('🔍 Checking for connected gateways to convert to manual...');
       var sceneViewer = this.sceneViewer;
       var convertedGateways = [];
@@ -31565,7 +31864,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
-            _this5.manualizeGateway(endpointObject, currentSceneData);
+            _this7.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"));
@@ -36512,7 +36811,7 @@ var CentralPlantInternals = /*#__PURE__*/function () {
         return false;
       }
       try {
-        var _componentData$childr, _componentData$childr2, _this$centralPlant$sc6, _componentData$childr3;
+        var _componentData$childr, _componentData$childr2, _this$centralPlant$sc6, _componentData$childr3, _componentData$defaul;
         // Generate a unique component ID if not provided
         var componentId = options.customId || this.generateUniqueComponentId(libraryId);
 
@@ -36718,6 +37017,15 @@ var CentralPlantInternals = /*#__PURE__*/function () {
           attachIODevicesToComponent(componentModel, componentData, modelPreloader, componentId);
         }
 
+        // Register default behaviors for smart components so the BehaviorManager
+        // responds to tooltip-driven state changes immediately after drop.
+        // (The scene-load path uses _processBehaviors instead, which runs on loadSceneData.)
+        if ((_componentData$defaul = componentData.defaultBehaviors) !== null && _componentData$defaul !== void 0 && _componentData$defaul.length) {
+          var _this$centralPlant$sc7, _som$registerBehavior;
+          var som = (_this$centralPlant$sc7 = this.centralPlant.sceneViewer) === null || _this$centralPlant$sc7 === void 0 ? void 0 : _this$centralPlant$sc7.sceneOperationsManager;
+          som === null || som === void 0 || (_som$registerBehavior = som.registerBehaviorsForComponentInstance) === null || _som$registerBehavior === void 0 || _som$registerBehavior.call(som, componentData, componentId);
+        }
+
         // Notify the component manager about the new component
         if (componentManager.registerComponent) {
           componentManager.registerComponent(componentModel);
@@ -36776,9 +37084,9 @@ var CentralPlantInternals = /*#__PURE__*/function () {
   }, {
     key: "deleteComponent",
     value: function deleteComponent(componentId) {
-      var _this$centralPlant$sc7;
+      var _this$centralPlant$sc8;
       // Check if component manager is available
-      var componentManager = (_this$centralPlant$sc7 = this.centralPlant.sceneViewer) === null || _this$centralPlant$sc7 === void 0 ? void 0 : _this$centralPlant$sc7.componentManager;
+      var componentManager = (_this$centralPlant$sc8 = this.centralPlant.sceneViewer) === null || _this$centralPlant$sc8 === void 0 ? void 0 : _this$centralPlant$sc8.componentManager;
       if (!componentManager) {
         console.error('❌ deleteComponent(): Component manager not available');
         return false;
@@ -36873,7 +37181,7 @@ var CentralPlant = /*#__PURE__*/function (_BaseDisposable) {
    * Initialize the CentralPlant manager
    * 
    * @constructor
-   * @version 0.1.92
+   * @version 0.1.94
    * @updated 2025-10-22
    * 
    * @description Creates a new CentralPlant instance and initializes internal managers and utilities.