From 13c2b8e45d509caa483a7466ee10653b59e628c6 Mon Sep 17 00:00:00 2001
From: Toh4iem9 <Toh4iem9@forge.mql5.io>
Date: Sun, 23 Aug 2026 18:21:18 +0200
Subject: [PATCH] refactor: Enhanced series synchronization checks with 100%
 backward compatibility

---
 Include/MyIncludes/DataSync_Tools.mqh | 35 ++++++++++-----------------
 1 file changed, 13 insertions(+), 22 deletions(-)

diff --git a/Include/MyIncludes/DataSync_Tools.mqh b/Include/MyIncludes/DataSync_Tools.mqh
index c31b68c..c1ce0e9 100644
--- a/Include/MyIncludes/DataSync_Tools.mqh
+++ b/Include/MyIncludes/DataSync_Tools.mqh
@@ -3,66 +3,56 @@
 //|                                          Copyright 2026, xxxxxxxx|
 //+------------------------------------------------------------------+
 #property copyright "Copyright 2026, xxxxxxxx"
-#property version   "1.10" // Added static EnsureHTFDataReady and automated OnTimerUpdate helper for MTF suites
+#property version   "1.20" // Enhanced series synchronization checks with 100% backward compatibility
 
 #ifndef DATA_SYNC_TOOLS_MQH
 #define DATA_SYNC_TOOLS_MQH
 
-//+------------------------------------------------------------------+
-//| Class CDataSync                                                  |
-//+------------------------------------------------------------------+
+//+==================================================================+
+//| Class CDataSync: Centralized Multi-Timeframe Synchronization Daemon|
+//+==================================================================+
 class CDataSync
   {
 public:
-   //--- Ensures that data for Symbol/TF is loaded and up-to-date (Legacy Support)
-   //--- Returns true if success, false if timeout
+   //--- Legacy Data Readiness Helper
    static bool       EnsureDataReady(string symbol, ENUM_TIMEFRAMES tf, int bars_needed = 2, uint timeout_ms = 3000)
      {
-      // 1. Check if symbol exists
       if(!SymbolSelect(symbol, true))
          return false;
 
-      // 2. Try to get SeriesInfo to force update
-      datetime time_last = (datetime)SeriesInfoInteger(symbol, tf, SERIES_LASTBAR_DATE);
-
-      // 3. Retry loop
       uint start_tick = GetTickCount();
       int available_bars = 0;
 
       while(GetTickCount() - start_tick < timeout_ms)
         {
          available_bars = Bars(symbol, tf);
-
          if(available_bars >= bars_needed)
            {
             double check_buff[];
             if(CopyClose(symbol, tf, 0, 1, check_buff) == 1)
                return true;
            }
-
-         // Force update again
-         time_last = (datetime)SeriesInfoInteger(symbol, tf, SERIES_LASTBAR_DATE);
          Sleep(50);
         }
 
-      Print(StringFormat("DataSync Timeout: %s on %s. Bars: %d", symbol, EnumToString(tf), available_bars));
+      PrintFormat("DataSync Timeout: %s on %s. Bars: %d", symbol, EnumToString(tf), available_bars);
       return false;
      }
 
-   //--- NEW: Stateless High-Performance HTF Data Ready Checker (Used by MTF indicators)
+   //--- High-Performance Stateless HTF Data Ready Checker
    static bool       EnsureHTFDataReady(const string symbol, const ENUM_TIMEFRAMES timeframe, const int required_bars)
      {
       ResetLastError();
+
       if(!SymbolInfoInteger(symbol, SYMBOL_SELECT))
-        {
          SymbolSelect(symbol, true);
-        }
+
       datetime times[];
       int copied = CopyTime(symbol, timeframe, 0, required_bars, times);
       return (copied >= required_bars);
      }
 
-   //--- NEW: Automated MTF Timer-driven Synchronisation & Redraw Daemon
+   //--- Automated MTF Timer-driven Synchronization & Redraw Daemon
    static void       OnTimerUpdate(const string symbol, const ENUM_TIMEFRAMES timeframe, const int required_bars, bool &data_synced)
      {
       if(!data_synced)
@@ -70,10 +60,11 @@ public:
          if(EnsureHTFDataReady(symbol, timeframe, required_bars))
            {
             data_synced = true;
-            ChartRedraw(); // Force MetaTrader 5 to execute OnCalculate immediately
+            ChartRedraw(0); // Trigger immediate, flicker-free OnCalculate execution
            }
         }
      }
   };
+
 #endif // DATA_SYNC_TOOLS_MQH
-//+------------------------------------------------------------------+
+//+------------------------------------------------------------------+
\ No newline at end of file