@2112-lab/central-plant 0.3.58 → 0.3.59

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

@@ -11,6 +11,8 @@ require('../rendering/modelPreloader.js');
 var behaviorSceneUtils = require('../utils/behaviorSceneUtils.js');
 var behaviorDispatch = require('../utils/behaviorDispatch.js');
 var boundingBoxUtils = require('../utils/boundingBoxUtils.js');
+var stateEngine = require('./stateEngine.js');
+var stateEngineScene = require('./stateEngineScene.js');
 
 function _interopNamespace(e) {
   if (e && e.__esModule) return e;
@@ -58,7 +60,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.
@@ -97,6 +99,14 @@ var CentralPlant = /*#__PURE__*/function (_BaseDisposable) {
     // Initialize internals handler
     _this.internals = new centralPlantInternals.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.StateEngine();
+    _this._unsubscribeStateEngine = _this.stateEngine.subscribe(function (change) {
+      return _this._onEngineStateChange(change);
+    });
+
     // Optional cache primer function (dependency injection)
     _this.cachePrimer = null;
 
@@ -273,6 +283,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(stateEngineScene.extractDeclaration(sceneData));
+                } catch (err) {
+                  console.warn('⚠️ setImportedSceneData(): stateEngine.load() failed:', err);
+                }
+              }
+
               // Scene behaviors loaded
 
               // Cross-component behaviors are registered by sceneOperationsManager.loadSceneData()
@@ -1221,12 +1241,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(stateEngineScene.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;
@@ -1250,6 +1290,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 = stateEngineScene.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
@@ -1257,16 +1316,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);
       }
@@ -1301,8 +1360,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) {
@@ -3083,12 +3142,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();
       }
@@ -3139,8 +3200,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/cjs/src/core/centralPlantInternals.js

@@ -30,6 +30,8 @@ var componentTooltipManager = require('../managers/scene/componentTooltipManager
 var viewport2DManager = require('../managers/scene/viewport2DManager.js');
 var IoBehaviorManager = require('../managers/behaviors/IoBehaviorManager.js');
 var IoOutlineManager = require('../managers/behaviors/IoOutlineManager.js');
+var EffectiveVisualManager = require('../managers/state/EffectiveVisualManager.js');
+var controlPanelManager = require('../managers/scene/controlPanelManager.js');
 var nameUtils = require('../utils/nameUtils.js');
 var ioDeviceUtils = require('../utils/ioDeviceUtils.js');
 var boundingBoxUtils = require('../utils/boundingBoxUtils.js');
@@ -178,6 +180,8 @@ var CentralPlantInternals = /*#__PURE__*/function () {
       this.centralPlant.managers.viewport2DManager = new viewport2DManager.Viewport2DManager(this.centralPlant.sceneViewer);
       this.centralPlant.managers.ioBehaviorManager = new IoBehaviorManager.IoBehaviorManager(this.centralPlant.sceneViewer);
       this.centralPlant.managers.ioOutlineManager = new IoOutlineManager.IoOutlineManager(this.centralPlant.sceneViewer);
+      this.centralPlant.managers.effectiveVisualManager = new EffectiveVisualManager.EffectiveVisualManager(this.centralPlant.sceneViewer);
+      this.centralPlant.managers.controlPanelManager = new controlPanelManager.ControlPanelManager(this.centralPlant.sceneViewer);
 
       // All managers are now stored in the managers collection and will be attached via attachToComponent()
     }

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

@@ -821,20 +821,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');