acttrader-charts 1.3.0-beta.28 → 1.3.0-beta.29

package/README.md

@@ -2957,3 +2957,52 @@ npm run lint       # ESLint
 ## License
 
 MIT
+
+## Bar Replay
+
+Replay history bar by bar, as TradingView does. `enableReplay: true` adds a
+**Replay** button to the header (simple and advanced layouts); it opens a
+control strip under the chart:
+
+```
+⇤ Select bar ▾ │ ▷  ▷|  1x  1D │ ▷▷|                                        ✕
+```
+
+- **Select bar** — a cut line with a scissors badge follows the pointer; click
+  a bar and everything from it onward is hidden. The ▾ menu also offers
+  **Select date…**, **First available date** and **Random bar**.
+- **▷ / ▷|** — play at the chosen speed (`0.1x` – `10x` bars per second) or
+  step one bar forward. Keyboard: `Shift+→` step, `Shift+↓` play/pause,
+  `Esc` leaves select mode.
+- **▷▷|** — jump to real time: every hidden bar comes back, including live
+  bars built while the replay ran. **✕** closes the strip.
+
+Live ticks keep updating the hidden series during a replay, so nothing is
+lost; a `loadData()` during a replay (timeframe or symbol change) keeps the
+replay date. Default `false`; without it nothing changes.
+
+```ts
+const chart = new ChartEngine({ container, enableReplay: true });
+
+// Drive it from code (works without the header button too):
+chart.openReplay();                 // show the strip, arm "Select bar"
+chart.startReplay('2026-06-01');    // hide bars after this date (number | Date | string)
+chart.setReplaySpeed(3);            // bars per second
+chart.playReplay(); chart.pauseReplay(); chart.replayStepForward();
+chart.exitReplay();                 // back to real time, strip stays open
+chart.closeReplay();                // back to real time and close the strip
+chart.isReplayActive();
+
+chart.on('replayStart', ({ time }) => { /* bars after `time` are hidden */ });
+chart.on('replayStep',  ({ time }) => { /* one more bar revealed */ });
+chart.on('replayEnd',   ({ time }) => { /* last hidden bar revealed */ });
+chart.on('replayExit',  () => { /* live chart is back */ });
+```
+
+On Android and iOS the same controls are bridge commands — `openReplay`,
+`closeReplay`, `startReplay { time }`, `playReplay`, `pauseReplay`,
+`replayStepForward`, `setReplaySpeed { barsPerSecond }`, `exitReplay` — with
+`enableReplay` on `init`; the four events above arrive through the bridge and the
+mobile header gets its own Replay button. See the `charts-android` and
+`charts-ios` READMEs for the Kotlin / Swift calls.
+

package/dist/{MACD-CzNHIupn.d.cts → MACD-CsTuaERC.d.cts}

@@ -1865,6 +1865,21 @@ interface ChartConfig {
      * (a one-time `console.warn` is logged at init).
      */
     enableSnapshot?: boolean;
+    /**
+     * **Bar Replay** — replay history bar by bar, as TradingView does.
+     *
+     * Adds a "Replay" button to the header (simple and advanced layouts). It opens a control strip
+     * under the chart: pick a start bar (click on the chart, a date, the first
+     * available bar or a random one), then play, pause, step forward, change
+     * speed, or jump back to real time. Bars after the replay point are hidden
+     * until they are revealed; live ticks keep updating the hidden series, so
+     * nothing is lost when the replay ends.
+     *
+     * Drive it from code with {@link ChartEngine.openReplay},
+     * {@link ChartEngine.startReplay}, {@link ChartEngine.playReplay} and friends.
+     * Default `false`.
+     */
+    enableReplay?: boolean;
     /**
      * Show the **Templates** section at the foot of the indicators flyout —
      * named, reusable indicator sets the user can save from the current chart
@@ -2979,6 +2994,20 @@ type ChartEventMap = {
      * browser action immediately after emitting; mobile wrappers can intercept
      * via the JS bridge to short-circuit and use platform APIs.
      */
+    /** Bar Replay started (or restarted) at the bar with this open time. */
+    replayStart: {
+        time: number;
+    };
+    /** Bar Replay revealed the next bar. */
+    replayStep: {
+        time: number;
+    };
+    /** Bar Replay revealed the last hidden bar. */
+    replayEnd: {
+        time: number;
+    };
+    /** Bar Replay ended and the live chart is back. */
+    replayExit: Record<string, never>;
     snapshot: {
         /** Full PNG data URL of the composited chart canvas. */
         dataUrl: string;

package/dist/{MACD-CzNHIupn.d.ts → MACD-CsTuaERC.d.ts}

@@ -1865,6 +1865,21 @@ interface ChartConfig {
      * (a one-time `console.warn` is logged at init).
      */
     enableSnapshot?: boolean;
+    /**
+     * **Bar Replay** — replay history bar by bar, as TradingView does.
+     *
+     * Adds a "Replay" button to the header (simple and advanced layouts). It opens a control strip
+     * under the chart: pick a start bar (click on the chart, a date, the first
+     * available bar or a random one), then play, pause, step forward, change
+     * speed, or jump back to real time. Bars after the replay point are hidden
+     * until they are revealed; live ticks keep updating the hidden series, so
+     * nothing is lost when the replay ends.
+     *
+     * Drive it from code with {@link ChartEngine.openReplay},
+     * {@link ChartEngine.startReplay}, {@link ChartEngine.playReplay} and friends.
+     * Default `false`.
+     */
+    enableReplay?: boolean;
     /**
      * Show the **Templates** section at the foot of the indicators flyout —
      * named, reusable indicator sets the user can save from the current chart
@@ -2979,6 +2994,20 @@ type ChartEventMap = {
      * browser action immediately after emitting; mobile wrappers can intercept
      * via the JS bridge to short-circuit and use platform APIs.
      */
+    /** Bar Replay started (or restarted) at the bar with this open time. */
+    replayStart: {
+        time: number;
+    };
+    /** Bar Replay revealed the next bar. */
+    replayStep: {
+        time: number;
+    };
+    /** Bar Replay revealed the last hidden bar. */
+    replayEnd: {
+        time: number;
+    };
+    /** Bar Replay ended and the live chart is back. */
+    replayExit: Record<string, never>;
     snapshot: {
         /** Full PNG data URL of the composited chart canvas. */
         dataUrl: string;