@2112-lab/central-plant 0.3.58 → 0.3.59

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

@@ -7,6 +7,8 @@ import '../rendering/modelPreloader.js';
 import { scanSceneIoEndpoints, applyCrossComponentBehaviors, loadCrossComponentBehaviors, reregisterSceneBehaviors } from '../utils/behaviorSceneUtils.js';
 import { getScopedAttachmentKey } from '../utils/behaviorDispatch.js';
 import { computeFilteredBoundingBox } from '../utils/boundingBoxUtils.js';
+import { StateEngine } from './stateEngine.js';
+import { ioAddress, parseIoAddress, extractDeclaration } from './stateEngineScene.js';
 
 // ─────────────────────────────────────────────────────────────────────────────
 // Flow-direction compatibility helper (module-level, no class dependency)
@@ -34,7 +36,7 @@ var CentralPlant = /*#__PURE__*/function (_BaseDisposable) {
    * Initialize the CentralPlant manager
    * 
    * @constructor
-   * @version 0.3.58
+   * @version 0.3.59
    * @updated 2025-10-22
    * 
    * @description Creates a new CentralPlant instance and initializes internal managers and utilities.
@@ -73,6 +75,14 @@ var CentralPlant = /*#__PURE__*/function (_BaseDisposable) {
     // Initialize internals handler
     _this.internals = new CentralPlantInternals(_this);
 
+    // Portable State Engine: single source of truth for desired/effective state
+    // (plant/group/object/pipe). Owned here; the write door and scene load/save
+    // route through it. The 3D layer/store mirror its output (Framework §12–§13).
+    _this.stateEngine = new StateEngine();
+    _this._unsubscribeStateEngine = _this.stateEngine.subscribe(function (change) {
+      return _this._onEngineStateChange(change);
+    });
+
     // Optional cache primer function (dependency injection)
     _this.cachePrimer = null;
 
@@ -249,6 +259,16 @@ var CentralPlant = /*#__PURE__*/function (_BaseDisposable) {
                 timestamp: new Date().toISOString()
               });
 
+              // Load plant / groups / chains / stateRegistry into the State Engine. v3.0
+              // scenes carry these; legacy v2.3 scenes load with safe defaults (§15).
+              if (this.stateEngine) {
+                try {
+                  this.stateEngine.load(extractDeclaration(sceneData));
+                } catch (err) {
+                  console.warn('⚠️ setImportedSceneData(): stateEngine.load() failed:', err);
+                }
+              }
+
               // Scene behaviors loaded
 
               // Cross-component behaviors are registered by sceneOperationsManager.loadSceneData()
@@ -1197,12 +1217,32 @@ var CentralPlant = /*#__PURE__*/function (_BaseDisposable) {
     }
 
     /**
-     * Internal single path for I/O state changes: persist, animate, link, emit.
+     * Internal single path for I/O state changes. Routes the write through the
+     * State Engine (the one write door, Framework §12); the engine subscription
+     * ({@link CentralPlant#_onEngineStateChange}) mirrors to the state adapter,
+     * animates meshes, and emits. Falls back to a direct write only if the engine
+     * is unavailable.
      * @private
      */
   }, {
     key: "_dispatchIoState",
     value: function _dispatchIoState(attachmentId, stateId, value, parentUuid) {
+      if (this.stateEngine) {
+        this.stateEngine.setDesired(ioAddress(attachmentId, stateId, parentUuid), value);
+        return;
+      }
+      this._dispatchIoStateDirect(attachmentId, stateId, value, parentUuid);
+    }
+
+    /**
+     * Persist to the state adapter, animate meshes, and emit for one I/O data
+     * point. This is the mirror side of the engine (driven from desired, since I/O
+     * data points are ungated) and the legacy fallback when no engine is present.
+     * @private
+     */
+  }, {
+    key: "_dispatchIoStateDirect",
+    value: function _dispatchIoStateDirect(attachmentId, stateId, value, parentUuid) {
       var _this$managers, _this$sceneViewer5, _this$sceneViewer6, _this$managers2, _this$sceneViewer7, _this$sceneViewer8, _this$sceneViewer9;
       var tooltipMgr = ((_this$managers = this.managers) === null || _this$managers === void 0 ? void 0 : _this$managers.componentTooltipManager) || ((_this$sceneViewer5 = this.sceneViewer) === null || _this$sceneViewer5 === void 0 ? void 0 : _this$sceneViewer5.componentTooltipManager) || ((_this$sceneViewer6 = this.sceneViewer) === null || _this$sceneViewer6 === void 0 || (_this$sceneViewer6 = _this$sceneViewer6.managers) === null || _this$sceneViewer6 === void 0 ? void 0 : _this$sceneViewer6.componentTooltipManager);
       var stateAdapter = tooltipMgr === null || tooltipMgr === void 0 ? void 0 : tooltipMgr._stateAdapter;
@@ -1226,6 +1266,25 @@ var CentralPlant = /*#__PURE__*/function (_BaseDisposable) {
       });
     }
 
+    /**
+     * State Engine subscriber: fan a committed registry change out to the 3D/store
+     * layer. I/O device data points (3-part addresses) mirror to the adapter and
+     * animate; every change (incl. plant/group/object/pipe effective) is surfaced
+     * as `engine-state-changed` for gating-aware visual subscribers (§13).
+     * @private
+     * @param {{ address: string, desired: *, effective: * }} change
+     */
+  }, {
+    key: "_onEngineStateChange",
+    value: function _onEngineStateChange(change) {
+      var _this$sceneViewer0;
+      var io = parseIoAddress(change.address);
+      if (io) {
+        this._dispatchIoStateDirect(io.attachmentId, io.stateId, change.desired, io.parentUuid);
+      }
+      (_this$sceneViewer0 = this.sceneViewer) === null || _this$sceneViewer0 === void 0 || _this$sceneViewer0.emit('engine-state-changed', change);
+    }
+
     /**
      * Configure the state adapter on both tooltip and behavior managers.
      * @param {{ getState: Function, setState: Function }} stateAdapter
@@ -1233,16 +1292,16 @@ var CentralPlant = /*#__PURE__*/function (_BaseDisposable) {
   }, {
     key: "configureStateAdapter",
     value: function configureStateAdapter(stateAdapter) {
-      var _this$managers3, _this$sceneViewer0, _this$managers4, _this$sceneViewer10, _this$sceneViewer11;
-      var tooltipMgr = ((_this$managers3 = this.managers) === null || _this$managers3 === void 0 ? void 0 : _this$managers3.componentTooltipManager) || ((_this$sceneViewer0 = this.sceneViewer) === null || _this$sceneViewer0 === void 0 ? void 0 : _this$sceneViewer0.componentTooltipManager);
+      var _this$managers3, _this$sceneViewer1, _this$managers4, _this$sceneViewer11, _this$sceneViewer12;
+      var tooltipMgr = ((_this$managers3 = this.managers) === null || _this$managers3 === void 0 ? void 0 : _this$managers3.componentTooltipManager) || ((_this$sceneViewer1 = this.sceneViewer) === null || _this$sceneViewer1 === void 0 ? void 0 : _this$sceneViewer1.componentTooltipManager);
       if (tooltipMgr !== null && tooltipMgr !== void 0 && tooltipMgr.configure) {
-        var _this$sceneViewer1;
+        var _this$sceneViewer10;
         tooltipMgr.configure(stateAdapter);
-        if ((_this$sceneViewer1 = this.sceneViewer) !== null && _this$sceneViewer1 !== void 0 && _this$sceneViewer1.managers) {
+        if ((_this$sceneViewer10 = this.sceneViewer) !== null && _this$sceneViewer10 !== void 0 && _this$sceneViewer10.managers) {
           this.sceneViewer.managers.componentTooltipManager = tooltipMgr;
         }
       }
-      var ioBehavMgr = ((_this$managers4 = this.managers) === null || _this$managers4 === void 0 ? void 0 : _this$managers4.ioBehaviorManager) || ((_this$sceneViewer10 = this.sceneViewer) === null || _this$sceneViewer10 === void 0 || (_this$sceneViewer10 = _this$sceneViewer10.managers) === null || _this$sceneViewer10 === void 0 ? void 0 : _this$sceneViewer10.ioBehaviorManager) || ((_this$sceneViewer11 = this.sceneViewer) === null || _this$sceneViewer11 === void 0 ? void 0 : _this$sceneViewer11.ioBehaviorManager);
+      var ioBehavMgr = ((_this$managers4 = this.managers) === null || _this$managers4 === void 0 ? void 0 : _this$managers4.ioBehaviorManager) || ((_this$sceneViewer11 = this.sceneViewer) === null || _this$sceneViewer11 === void 0 || (_this$sceneViewer11 = _this$sceneViewer11.managers) === null || _this$sceneViewer11 === void 0 ? void 0 : _this$sceneViewer11.ioBehaviorManager) || ((_this$sceneViewer12 = this.sceneViewer) === null || _this$sceneViewer12 === void 0 ? void 0 : _this$sceneViewer12.ioBehaviorManager);
       if (ioBehavMgr !== null && ioBehavMgr !== void 0 && ioBehavMgr.configure) {
         ioBehavMgr.configure(stateAdapter);
       }
@@ -1277,8 +1336,8 @@ var CentralPlant = /*#__PURE__*/function (_BaseDisposable) {
   }, {
     key: "getSceneAttachments",
     value: function getSceneAttachments() {
-      var _this$sceneViewer12;
-      var scene = (_this$sceneViewer12 = this.sceneViewer) === null || _this$sceneViewer12 === void 0 ? void 0 : _this$sceneViewer12.scene;
+      var _this$sceneViewer13;
+      var scene = (_this$sceneViewer13 = this.sceneViewer) === null || _this$sceneViewer13 === void 0 ? void 0 : _this$sceneViewer13.scene;
       if (!scene) return [];
       var results = [];
       scene.traverse(function (obj) {
@@ -3059,12 +3118,14 @@ var CentralPlant = /*#__PURE__*/function (_BaseDisposable) {
   }, {
     key: "clearScene",
     value: function clearScene() {
-      var _this$sceneViewer13;
+      var _this$sceneViewer14, _this$stateEngine;
       this.importedSceneData = null;
-      var ioBehavMgr = (_this$sceneViewer13 = this.sceneViewer) === null || _this$sceneViewer13 === void 0 || (_this$sceneViewer13 = _this$sceneViewer13.managers) === null || _this$sceneViewer13 === void 0 ? void 0 : _this$sceneViewer13.ioBehaviorManager;
+      var ioBehavMgr = (_this$sceneViewer14 = this.sceneViewer) === null || _this$sceneViewer14 === void 0 || (_this$sceneViewer14 = _this$sceneViewer14.managers) === null || _this$sceneViewer14 === void 0 ? void 0 : _this$sceneViewer14.ioBehaviorManager;
       if (ioBehavMgr) {
         ioBehavMgr.setCrossComponentBehaviors([]);
       }
+      // Reset the registry so pipe/object keys from the old scene don't linger (§15).
+      (_this$stateEngine = this.stateEngine) === null || _this$stateEngine === void 0 || _this$stateEngine.reset();
       if (this.sceneViewer && this.sceneViewer.scene) {
         this.sceneViewer.scene.clear();
       }
@@ -3115,8 +3176,16 @@ var CentralPlant = /*#__PURE__*/function (_BaseDisposable) {
   }, {
     key: "_doDispose",
     value: function _doDispose() {
+      var _this$stateEngine2;
       console.log('🧹 Disposing CentralPlant using enhanced disposal patterns...');
 
+      // Tear down the State Engine subscription and registry.
+      if (this._unsubscribeStateEngine) {
+        this._unsubscribeStateEngine();
+        this._unsubscribeStateEngine = null;
+      }
+      (_this$stateEngine2 = this.stateEngine) === null || _this$stateEngine2 === void 0 || _this$stateEngine2.reset();
+
       // Use batch disposal for all managers
       var managers = Object.values(this.managers).filter(function (manager) {
         return manager && typeof manager.dispose === 'function';

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

@@ -26,6 +26,8 @@ import { ComponentTooltipManager } from '../managers/scene/componentTooltipManag
 import { Viewport2DManager } from '../managers/scene/viewport2DManager.js';
 import { IoBehaviorManager } from '../managers/behaviors/IoBehaviorManager.js';
 import { IoOutlineManager } from '../managers/behaviors/IoOutlineManager.js';
+import { EffectiveVisualManager } from '../managers/state/EffectiveVisualManager.js';
+import { ControlPanelManager } from '../managers/scene/controlPanelManager.js';
 import { generateUuidFromName, getHardcodedUuid, findObjectByHardcodedUuid, generateUniqueComponentId } from '../utils/nameUtils.js';
 import { attachIODevicesToComponent } from '../utils/ioDeviceUtils.js';
 import { computeFilteredBoundingBoxCached } from '../utils/boundingBoxUtils.js';
@@ -154,6 +156,8 @@ var CentralPlantInternals = /*#__PURE__*/function () {
       this.centralPlant.managers.viewport2DManager = new Viewport2DManager(this.centralPlant.sceneViewer);
       this.centralPlant.managers.ioBehaviorManager = new IoBehaviorManager(this.centralPlant.sceneViewer);
       this.centralPlant.managers.ioOutlineManager = new IoOutlineManager(this.centralPlant.sceneViewer);
+      this.centralPlant.managers.effectiveVisualManager = new EffectiveVisualManager(this.centralPlant.sceneViewer);
+      this.centralPlant.managers.controlPanelManager = new ControlPanelManager(this.centralPlant.sceneViewer);
 
       // All managers are now stored in the managers collection and will be attached via attachToComponent()
     }

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

@@ -817,20 +817,24 @@ var CentralPlantValidator = /*#__PURE__*/function () {
     key: "validateImportedSceneData",
     value: function validateImportedSceneData(sceneData) {
       var results = [];
-      var hardcodedVersion = "2.3";
 
-      // Version validation - MUST be the value of hardcodedVersion
-      if (!sceneData.version || sceneData.version !== hardcodedVersion) {
+      // Supported scene formats: 2.3 (legacy I/O behaviors) and 3.0 (State Engine:
+      // adds plant/groups/chains/stateRegistry). Both load; older scenes keep working.
+      var supportedVersions = ["2.3", "3.0"];
+
+      // Version validation - MUST be one of the supported versions
+      if (!sceneData.version || !supportedVersions.includes(sceneData.version)) {
         var providedVersion = sceneData.version || 'unknown';
-        alert("The central-plant requires the input file to be version ".concat(hardcodedVersion));
+        var supportedList = supportedVersions.join(' or ');
+        alert("The central-plant requires the input file to be version ".concat(supportedList));
         results.push({
           isValid: false,
           severity: ValidationSeverity.ERROR,
-          message: "Invalid version: \"".concat(providedVersion, "\". Required version is \"").concat(hardcodedVersion, "\""),
+          message: "Invalid version: \"".concat(providedVersion, "\". Supported versions are ").concat(supportedList),
           code: 'INVALID_VERSION',
           metadata: {
             providedVersion: providedVersion,
-            requiredVersion: hardcodedVersion
+            supportedVersions: supportedVersions
           }
         });
         return this._combineValidationResults(results, 'scene_import_validation');