@2112-lab/central-plant 0.2.10 → 0.3.0

package/dist/cjs/src/managers/pathfinding/pathfindingManager.js

@@ -541,6 +541,103 @@ var PathfindingManager = /*#__PURE__*/function (_BaseDisposable) {
       return this.pathDataStore.get(pathId);
     }
 
+    /**
+     * Propagate flowAttributes from the original connection list to any gateway-split
+     * rendered sub-paths in pathDataStore, then apply all flow visualizations.
+     * Called after every pathfinding execution (initial load and transform updates).
+     *
+     * @param {Array} connections - Original connections array (may include flowAttributes)
+     * @param {object} pathfindingResult - Result returned by _executePathfinding
+     * @private
+     */
+  }, {
+    key: "_propagateFlowAttributesAndApplyVisualizations",
+    value: function _propagateFlowAttributesAndApplyVisualizations(connections, pathfindingResult) {
+      var _this5 = this,
+        _this$sceneViewer;
+      if (!Array.isArray(connections) || !pathfindingResult) return;
+
+      // Pass 1: use the explicit gateway connection mappings to build a precise
+      //         original-pathId → Set<renderedPathId> map.
+      var originalToSubPaths = new Map();
+      if (pathfindingResult.gateways) {
+        pathfindingResult.gateways.forEach(function (gateway) {
+          var _ref = gateway.connections || {},
+            removed = _ref.removed,
+            added = _ref.added;
+          if (!(removed !== null && removed !== void 0 && removed.length) || !(added !== null && added !== void 0 && added.length)) return;
+          removed.forEach(function (removedConn) {
+            var origId = "".concat(removedConn.from, "-->").concat(removedConn.to);
+            if (!originalToSubPaths.has(origId)) originalToSubPaths.set(origId, new Set());
+            added.forEach(function (addedConn) {
+              originalToSubPaths.get(origId).add("".concat(addedConn.from, "-->").concat(addedConn.to));
+            });
+          });
+        });
+      }
+      connections.forEach(function (conn) {
+        if (!conn.flowAttributes) return;
+        var origId = "".concat(conn.from, "-->").concat(conn.to);
+        var subPathIds = new Set(originalToSubPaths.get(origId) || []);
+        subPathIds.add(origId);
+        subPathIds.forEach(function (subPathId) {
+          var pd = _this5.pathDataStore.get(subPathId);
+          if (pd && Object.keys(pd.flowAttributes).length === 0) {
+            Object.entries(conn.flowAttributes).forEach(function (_ref2) {
+              var _ref3 = _rollupPluginBabelHelpers.slicedToArray(_ref2, 2),
+                key = _ref3[0],
+                value = _ref3[1];
+              return pd.setFlowAttribute(key, value);
+            });
+          }
+        });
+      });
+
+      // Pass 2: endpoint fallback for Gateway→Gateway intermediate segments and
+      // for paths whose connections were restructured by manualizeSegment/manualizeGateway.
+      // After manualization, currentSceneData.connections no longer contains the original
+      // A→B entry with flowAttributes (it's been split into new sub-connections), so we
+      // seed the endpoint maps from both the connections array AND from existing pathDataStore
+      // entries that already carry flowAttributes — those persist across re-executions.
+      var fromEndpointAttrs = new Map();
+      var toEndpointAttrs = new Map();
+
+      // Seed from persisted pathDataStore entries first (covers post-manualization re-runs)
+      this.pathDataStore.forEach(function (pd, pathId) {
+        if (Object.keys(pd.flowAttributes).length === 0) return;
+        var sepIdx = pathId.indexOf('-->');
+        if (sepIdx === -1) return;
+        var from = pathId.slice(0, sepIdx);
+        var to = pathId.slice(sepIdx + 3);
+        if (!fromEndpointAttrs.has(from)) fromEndpointAttrs.set(from, pd.flowAttributes);
+        if (!toEndpointAttrs.has(to)) toEndpointAttrs.set(to, pd.flowAttributes);
+      });
+
+      // Also seed from connections array (covers initial load before pathDataStore has any attrs)
+      connections.forEach(function (conn) {
+        if (!conn.flowAttributes) return;
+        if (!fromEndpointAttrs.has(conn.from)) fromEndpointAttrs.set(conn.from, conn.flowAttributes);
+        if (!toEndpointAttrs.has(conn.to)) toEndpointAttrs.set(conn.to, conn.flowAttributes);
+      });
+      this.pathDataStore.forEach(function (pd, pathId) {
+        if (Object.keys(pd.flowAttributes).length > 0) return;
+        var sepIdx = pathId.indexOf('-->');
+        if (sepIdx === -1) return;
+        var from = pathId.slice(0, sepIdx);
+        var to = pathId.slice(sepIdx + 3);
+        var attrs = fromEndpointAttrs.get(from) || toEndpointAttrs.get(to);
+        if (attrs) Object.entries(attrs).forEach(function (_ref4) {
+          var _ref5 = _rollupPluginBabelHelpers.slicedToArray(_ref4, 2),
+            key = _ref5[0],
+            value = _ref5[1];
+          return pd.setFlowAttribute(key, value);
+        });
+      });
+
+      // Apply visualizations
+      (_this$sceneViewer = this.sceneViewer) === null || _this$sceneViewer === void 0 || (_this$sceneViewer = _this$sceneViewer.managers) === null || _this$sceneViewer === void 0 || (_this$sceneViewer = _this$sceneViewer.pathFlowManager) === null || _this$sceneViewer === void 0 || _this$sceneViewer.applyAllVisualizations();
+    }
+
     /**
      * Initialize pathfinder and create paths
      */
@@ -548,9 +645,8 @@ var PathfindingManager = /*#__PURE__*/function (_BaseDisposable) {
     key: "initializePathfinder",
     value: (function () {
       var _initializePathfinder = _rollupPluginBabelHelpers.asyncToGenerator(/*#__PURE__*/_rollupPluginBabelHelpers.regenerator().m(function _callee2(data, crosscubeTextureSet) {
-        var _this5 = this,
-          _this$sceneViewer;
-        var pathfindingResult, originalToSubPaths, fromEndpointAttrs, flowMgr;
+        var _this6 = this;
+        var pathfindingResult;
         return _rollupPluginBabelHelpers.regenerator().w(function (_context2) {
           while (1) switch (_context2.n) {
             case 0:
@@ -563,11 +659,11 @@ var PathfindingManager = /*#__PURE__*/function (_BaseDisposable) {
                 data.connections.forEach(function (conn) {
                   if (conn.flowAttributes && _rollupPluginBabelHelpers["typeof"](conn.flowAttributes) === 'object') {
                     var pathId = "".concat(conn.from, "-->").concat(conn.to);
-                    var pd = _this5._getOrCreatePathData(pathId, conn.from, conn.to);
-                    Object.entries(conn.flowAttributes).forEach(function (_ref) {
-                      var _ref2 = _rollupPluginBabelHelpers.slicedToArray(_ref, 2),
-                        key = _ref2[0],
-                        value = _ref2[1];
+                    var pd = _this6._getOrCreatePathData(pathId, conn.from, conn.to);
+                    Object.entries(conn.flowAttributes).forEach(function (_ref6) {
+                      var _ref7 = _rollupPluginBabelHelpers.slicedToArray(_ref6, 2),
+                        key = _ref7[0],
+                        value = _ref7[1];
                       pd.setFlowAttribute(key, value);
                     });
                     console.log("\uD83C\uDF0A Loaded flowAttributes for path \"".concat(pathId, "\":"), conn.flowAttributes);
@@ -583,82 +679,7 @@ var PathfindingManager = /*#__PURE__*/function (_BaseDisposable) {
               });
             case 1:
               pathfindingResult = _context2.v;
-              // ── Propagate flowAttributes to gateway-split rendered paths ──────────
-              // The pathfinder may split a connection A→B through gateway waypoints,
-              // producing sub-paths like A→G and G→B with different pathIds.
-              // We need to copy the original connection's flowAttributes onto every
-              // rendered sub-path entry in pathDataStore so the visualisation can
-              // find them by their rendered pathId.
-              if (Array.isArray(data.connections) && pathfindingResult) {
-                // Pass 1: use the explicit gateway connection mappings to get a precise
-                //         original→sub-path map.
-                originalToSubPaths = new Map(); // origPathId → Set<renderedPathId>
-                if (pathfindingResult.gateways) {
-                  pathfindingResult.gateways.forEach(function (gateway) {
-                    var _ref3 = gateway.connections || {},
-                      removed = _ref3.removed,
-                      added = _ref3.added;
-                    if (!(removed !== null && removed !== void 0 && removed.length) || !(added !== null && added !== void 0 && added.length)) return;
-                    removed.forEach(function (removedConn) {
-                      var origId = "".concat(removedConn.from, "-->").concat(removedConn.to);
-                      if (!originalToSubPaths.has(origId)) originalToSubPaths.set(origId, new Set());
-                      added.forEach(function (addedConn) {
-                        originalToSubPaths.get(origId).add("".concat(addedConn.from, "-->").concat(addedConn.to));
-                      });
-                    });
-                  });
-                }
-                data.connections.forEach(function (conn) {
-                  if (!conn.flowAttributes) return;
-                  var origId = "".concat(conn.from, "-->").concat(conn.to);
-                  var subPathIds = new Set(originalToSubPaths.get(origId) || []);
-                  subPathIds.add(origId); // include the direct path if it wasn't rewired
-
-                  subPathIds.forEach(function (subPathId) {
-                    var pd = _this5.pathDataStore.get(subPathId);
-                    if (pd && Object.keys(pd.flowAttributes).length === 0) {
-                      Object.entries(conn.flowAttributes).forEach(function (_ref4) {
-                        var _ref5 = _rollupPluginBabelHelpers.slicedToArray(_ref4, 2),
-                          key = _ref5[0],
-                          value = _ref5[1];
-                        pd.setFlowAttribute(key, value);
-                      });
-                      console.log("\uD83C\uDF0A Propagated flowAttributes to sub-path \"".concat(subPathId, "\" from \"").concat(origId, "\""));
-                    }
-                  });
-                });
-
-                // Pass 2: endpoint fallback for any rendered path still missing attributes
-                // (covers Gateway→Gateway intermediate segments not captured by gateway.connections.added)
-                fromEndpointAttrs = new Map(); // connectorId → flowAttributes
-                data.connections.forEach(function (conn) {
-                  if (conn.flowAttributes && !fromEndpointAttrs.has(conn.from)) {
-                    fromEndpointAttrs.set(conn.from, conn.flowAttributes);
-                  }
-                });
-                this.pathDataStore.forEach(function (pd, pathId) {
-                  if (Object.keys(pd.flowAttributes).length > 0) return;
-                  var sepIdx = pathId.indexOf('-->');
-                  if (sepIdx === -1) return;
-                  var from = pathId.slice(0, sepIdx);
-                  var attrs = fromEndpointAttrs.get(from);
-                  if (attrs) {
-                    Object.entries(attrs).forEach(function (_ref6) {
-                      var _ref7 = _rollupPluginBabelHelpers.slicedToArray(_ref6, 2),
-                        key = _ref7[0],
-                        value = _ref7[1];
-                      return pd.setFlowAttribute(key, value);
-                    });
-                    console.log("\uD83C\uDF0A Endpoint-matched flowAttributes for path \"".concat(pathId, "\""));
-                  }
-                });
-              }
-
-              // ── Apply flow visualizations now that paths are rendered ──────────────
-              flowMgr = (_this$sceneViewer = this.sceneViewer) === null || _this$sceneViewer === void 0 || (_this$sceneViewer = _this$sceneViewer.managers) === null || _this$sceneViewer === void 0 ? void 0 : _this$sceneViewer.pathFlowManager;
-              if (flowMgr) {
-                flowMgr.applyAllVisualizations();
-              }
+              this._propagateFlowAttributesAndApplyVisualizations(data.connections, pathfindingResult);
 
               // Update connections with rewired connections
               if (pathfindingResult.rewiredConnections) {
@@ -784,6 +805,9 @@ var PathfindingManager = /*#__PURE__*/function (_BaseDisposable) {
               });
             case 2:
               result = _context3.v;
+              // Re-apply flow attribute colors (new materials are created on each execution)
+              this._propagateFlowAttributesAndApplyVisualizations(currentSceneData.connections, result);
+
               // Cache fingerprint + result for next comparison
               this._lastPathfindingFingerprint = fingerprint;
               this._lastPathfindingResult = result;

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

@@ -1771,7 +1771,7 @@ var SceneOperationsManager = /*#__PURE__*/function () {
       if (typeof window !== 'undefined') {
         isDev = window.location.hostname === 'localhost' || window.location.hostname === '127.0.0.1';
       }
-      if (isDev && segment.material) {
+      if (isDev && process.env.DISABLE_MANUALIZED_SEGMENT_COLORING !== 'true' && segment.material) {
         segment.material.color.setHex(0x0000ff); // Blue
         console.log('🎨 Set manual segment material color to blue (dev mode)');
       }
@@ -1802,7 +1802,7 @@ var SceneOperationsManager = /*#__PURE__*/function () {
       console.log('🔌 Created connectors:', connectors);
 
       // In dev mode, enlarge connectors by 1.5x and turn them red
-      if (isDev) {
+      if (isDev && process.env.DISABLE_MANUALIZED_SEGMENT_COLORING !== 'true') {
         connectors.forEach(function (connector) {
           if (connector) {
             connector.scale.set(1.25, 1.25, 1.25);

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

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

package/dist/esm/src/index.js

@@ -25,7 +25,10 @@ export { loadTextureSetAndCreateMaterial } from './managers/environment/textureC
 export { ThreeJSResourceManager } from './managers/system/threeJSResourceManager.js';
 export { PerformanceMonitorManager } from './managers/system/performanceMonitorManager.js';
 export { OperationHistoryManager } from './managers/system/operationHistoryManager.js';
-export { CACHE_EXPIRY, CACHE_NAME_PREFIX, CacheManager, cacheManager } from './managers/CacheManager.js';
+export { CACHE_EXPIRY, CACHE_NAME_PREFIX, CacheManager, cacheManager } from './managers/cache/CacheManager.js';
+export { GLOBAL_CACHE_NAME, cacheJsonData, cleanExpiredCache, cleanInvalidCacheEntries, clearS3Cache, formatCacheExpiry, getAllCacheKeys, getCacheExpiryForPath, getCacheStats, getCachedJsonData, getCachedLocalFile, getCachedLocalFileURL, getCachedLocalJson, getCachedS3Json, getCachedS3Object, getCachedS3ObjectURL, getCurrentCacheName, getGlobalCacheStats, getGlobalOnlyCacheStats, getThumbnailKey, getUserOnlyCacheStats, isCached, isThumbnailCached, preloadLocalFiles, preloadS3Objects, removeCachedJsonData, resetCacheIdentity, resetGlobalCacheStats, switchCachePartition } from './managers/cache/S3CacheService.js';
+export { S3MetadataCacheService, s3MetadataCache } from './managers/cache/S3MetadataCacheService.js';
+export { measureS3Transfer } from './managers/cache/s3Timing.js';
 export { ModelManager } from './managers/scene/modelManager.js';
 export { default as modelPreloader } from './rendering/modelPreloader.js';
 import * as rendering2D from './rendering/rendering2D.js';