@luxalgo/vela 0.7.7 → 0.8.0

package/dist/{contributions-DF_Ea07m.d.cts → contributions-CtlptxR8.d.cts}

@@ -1,5 +1,5 @@
-import { x as Millis, an as InputSchema, al as IndicatorMeta, P as PriceStyle, O as OHLCV, I as InputValue, l as IndicatorModel, k as MoveTarget, aH as PaneAxis, aW as SeriesSpec, aj as Fill, G as Background, aM as PriceLine, a6 as DrawingLine, a2 as DrawingBox, a5 as DrawingLabel, aa as DrawingPolyline, a7 as DrawingLinefill, af as DrawingTable, h as IndicatorStatus, a as VisibleRange, c as VelaTheme, S as SerializedDrawing, z as DrawingTypeKey, y as SnapMode, a8 as DrawingMode, u as MarkClickEvent, e as IChartRenderer, R as RendererCapabilities, o as LegendActionView, p as LegendCalloutView, U as Unsubscribe, C as CrosshairEvent, A as AxisLongPressEvent, v as DataWindowReadout, n as SymbolPickerFn, W as WallClock, bc as PaneInfo, ai as DrawingsOption, ac as DrawingSeriesGateway, D as Drawing, s as TimelineMark, t as MarkGroup, b as VelaOptions, E as AddIndicatorOptions, aG as MarketSwitch, aF as MarketSnapshot, V as VisibleRangePreset, T as ThemeName } from './options-D1AJKsn_.cjs';
-import { S as SymbolInfo, B as BarRange, M as MarketDataFeed, D as DataProvider, P as ProviderInfo, a as SymbolDescriptor, b as ProviderCapabilities } from './DataProvider-CGa4KHRa.cjs';
+import { x as Millis, ao as InputSchema, am as IndicatorMeta, P as PriceStyle, O as OHLCV, I as InputValue, l as IndicatorModel, k as MoveTarget, aH as PaneAxis, aW as SeriesSpec, ak as Fill, H as Background, aM as PriceLine, a7 as DrawingLine, a3 as DrawingBox, a6 as DrawingLabel, ab as DrawingPolyline, a8 as DrawingLinefill, ag as DrawingTable, h as IndicatorStatus, a as VisibleRange, c as VelaTheme, S as SerializedDrawing, z as DrawingTypeKey, y as SnapMode, a9 as DrawingMode, u as MarkClickEvent, e as IChartRenderer, R as RendererCapabilities, o as LegendActionView, p as LegendCalloutView, U as Unsubscribe, C as CrosshairEvent, r as ClickEvent, A as AxisLongPressEvent, v as DataWindowReadout, n as SymbolPickerFn, W as WallClock, bc as PaneInfo, aj as DrawingsOption, ad as DrawingSeriesGateway, D as Drawing, s as TimelineMark, t as MarkGroup, b as VelaOptions, F as AddIndicatorOptions, aG as MarketSwitch, E as MarketSnapshot, V as VisibleRangePreset, T as ThemeName } from './options-BnEPUuVV.cjs';
+import { S as SymbolInfo, B as BarRange, M as MarketDataFeed, D as DataProvider, P as ProviderInfo, a as SymbolDescriptor, b as ProviderCapabilities } from './DataProvider-BrlxntPN.cjs';
 
 /**
  * A strategy's broker state at ONE bar — the flat summary a host reads while a script
@@ -474,6 +474,8 @@ interface NativeIndicatorContext {
     readonly id: string;
     readonly symbol: string;
     readonly timeframe: string;
+    /** Whether the chart streams live data. False during a bar replay — entering and
+     *  leaving replay RESTARTS the indicator, so this never changes within one context. */
     readonly live: boolean;
     /** The chart's trading session (`'regular'` | `'extended'`); undefined = regular /
      *  no session model. A session switch reloads the market and RESTARTS the
@@ -681,6 +683,129 @@ interface ScriptRunResult {
     remove(): void;
 }
 
+/** Where a bar replay stands (`chart.replay.state`). */
+interface ReplayState {
+    /** Replay mode is on: the chart shows history up to the cursor, live updates are paused.
+     *  Stays on through a timeframe/session switch while the new bars load (`cursorTime`
+     *  is null until the replay resumes on them). */
+    active: boolean;
+    /** Bars are being revealed on a timer (`play`), as opposed to paused / stepped by hand. */
+    playing: boolean;
+    /** Open time (epoch ms) of the newest bar on screen; null when replay is off. */
+    cursorTime: number | null;
+    /** Bars still hidden to the right of the cursor. */
+    remaining: number;
+    /** Open time (epoch ms) of the next bar a step completes — the one forming tick by tick,
+     *  else the next hidden one; null when nothing is left or replay is off. Lets a host
+     *  keep several charts on one clock (see `VelaWorkspace.replay`). */
+    nextTime: number | null;
+    /** Delay between two updates while playing (ms) — two bars, or two ticks with {@link ReplayControl.setTicks}. */
+    intervalMs: number;
+}
+/** Options for {@link ReplayControl.start}. */
+interface ReplayStartOptions {
+    /**
+     * Epoch ms. The chart keeps every bar that opened at or before it and hides the rest.
+     * Older than the loaded history ⇒ the history is deepened first (clamped to the
+     * oldest bar the source serves).
+     */
+    from: number;
+}
+/** Why a replay ended (`replay:end`). */
+type ReplayEndReason = 'stopped' | 'finished' | 'market';
+/** One intrabar update of a replayed bar ({@link ReplayControl.setTicks}). */
+interface ReplayTick {
+    /** The price the forming candle closes at after this update. */
+    price: number;
+    /** The extremes traded since the previous update (default: `price`) — lets one update
+     *  stand for a whole span, e.g. a lower-timeframe bar. */
+    high?: number;
+    low?: number;
+    /** Where the candle opens — read on a bar's first update only (default: `price`). */
+    open?: number;
+    /** Volume traded by this update. When no tick of a bar carries one, the bar's volume
+     *  is spread evenly across its ticks. */
+    volume?: number;
+}
+/**
+ * Where a replay gets the intrabar prices of a bar it is about to reveal: `bar` is the
+ * stored bar, `end` the open time of the bar after it (the span the ticks cover is
+ * `[bar.time, end)`), `signal` aborts when the replay moves on (seek, stop, new source).
+ * Prices come oldest first. An empty list — or a failure — reveals the bar whole.
+ */
+type ReplayTickSource = (bar: OHLCV, opts: {
+    end: number;
+    signal: AbortSignal;
+}) => readonly ReplayTick[] | Promise<readonly ReplayTick[]>;
+/** What the chart implements behind {@link ReplayControl}. */
+interface ReplayController {
+    replayStart(opts: ReplayStartOptions): Promise<void>;
+    replayStep(): boolean;
+    replayStepUpdate(): boolean;
+    replayPlay(intervalMs?: number): void;
+    replayPause(): void;
+    replayStop(): void;
+    replayState(): ReplayState;
+    replayBounds(): ReplayBounds | null;
+    replaySetTicks(source: ReplayTickSource | null): void;
+}
+/** The open times of the oldest and newest bar a replay can start from (`chart.replay.bounds`). */
+interface ReplayBounds {
+    first: number;
+    last: number;
+}
+/**
+ * The chart's bar-replay control surface (`chart.replay`) — sibling of `chart.data` /
+ * `chart.marks`. Rewinds the chart to a past bar and reveals the following bars one at a
+ * time, by hand or on a timer, from the history already in memory (nothing is refetched).
+ * Revealed bars travel the exact path of a live bar: indicators, chart-type engines and
+ * the `bar` event see them as new bars — but script alerts stay quiet (a replayed bar is
+ * history, not a live signal). Live updates pause for the duration; `stop()` (or
+ * revealing the last bar) restores the full history and resumes them. A timeframe or
+ * session switch carries the replay over to the new bars at the same point in time; a
+ * symbol switch ends it.
+ */
+declare class ReplayControl {
+    private readonly ctrl;
+    constructor(ctrl: ReplayController);
+    /**
+     * Enter replay (or seek, when already replaying) at `opts.from`. Resolves once the
+     * chart shows the rewound history — after any in-flight history load has finished.
+     * Starts paused; call {@link play} or {@link step}.
+     */
+    start(opts: ReplayStartOptions): Promise<void>;
+    /** Reveal the next bar — or, mid-way through a bar played tick by tick, complete it.
+     *  Returns false when replay is off or nothing is left. */
+    step(): boolean;
+    /** Reveal the next UPDATE: with {@link setTicks}, the next tick of the forming bar — or
+     *  the next bar opened at its first tick (once its ticks are in, if still loading);
+     *  otherwise the next whole bar, like {@link step}. Returns false when nothing is left. */
+    stepUpdate(): boolean;
+    /** Reveal one bar (one tick, with {@link setTicks}) every `intervalMs` (default: the last
+     *  interval used, else 1000). Calling it again while playing changes the pace. */
+    play(intervalMs?: number): this;
+    pause(): this;
+    /** Leave replay: the full history comes back and live updates resume. Also cancels a
+     *  `start()` still loading older history (the chart returns to its previous depth). */
+    stop(): this;
+    get state(): ReplayState;
+    /** The loaded history a replay can walk — hidden bars included while replaying. Null
+     *  before any bar loaded. A start older than `first` deepens the history first. */
+    get bounds(): ReplayBounds | null;
+    /**
+     * Play each revealed bar as a series of intrabar updates instead of whole: while
+     * playing, the forming candle opens at the first tick, then every tick moves its close
+     * and stretches its high and low, exactly like a live tick — indicators, chart types
+     * and the `bar` event follow — and the last one settles it on the stored bar. The play
+     * interval is then the time between two TICKS: a bar lasts as many intervals as it
+     * has ticks (below ~16 ms, ticks are batched per frame). The next bar's ticks are
+     * requested while the current one plays; playback waits for them. `null` goes back to
+     * whole bars. Takes effect from the next bar; a bar forming when the source changes
+     * completes at once.
+     */
+    setTicks(source: ReplayTickSource | null): this;
+}
+
 /** Chart-level events emitted on `chart.on(...)`. */
 interface VelaEventMap extends Record<string, unknown> {
     ready: undefined;
@@ -838,7 +963,7 @@ interface VelaEventMap extends Record<string, unknown> {
     "context:changed": {
         id: string;
     };
-    /** A live tick: the forming bar was updated or a new bar appended. */
+    /** A live tick: the forming bar was updated or a new bar appended (a bar revealed by replay included). */
     bar: OHLCV;
     /**
      * The visible time range moved (pan/zoom/fit — fires per applied change, NOT
@@ -865,8 +990,42 @@ interface VelaEventMap extends Record<string, unknown> {
         oldestTime: number;
         barsLoaded: number;
     };
+    /** Replay mode began (or seeked): the chart shows history up to `cursorTime`, `remaining` bars are hidden. */
+    "replay:start": {
+        cursorTime: number;
+        remaining: number;
+    };
+    /** One hidden bar was revealed (it also fires `bar`, like a live bar). A bar played tick
+     *  by tick steps once, when its last tick settles it. */
+    "replay:step": {
+        cursorTime: number;
+        remaining: number;
+    };
+    /** An intrabar update of the bar forming at `cursorTime` (`chart.replay.setTicks`):
+     *  tick `index` of `count` is applied (batched updates report the last one). */
+    "replay:tick": {
+        cursorTime: number;
+        index: number;
+        count: number;
+    };
+    /** Timed reveal started, or its pace changed. */
+    "replay:play": {
+        intervalMs: number;
+    };
+    /** Timed reveal paused — `pause()`, or a seek (`start()` while playing). */
+    "replay:pause": undefined;
+    /**
+     * Replay mode ended: `'stopped'` = `chart.replay.stop()`, `'finished'` = the last hidden
+     * bar was revealed, `'market'` = a symbol switch replaced the history (a timeframe or
+     * session switch carries the replay over instead). The full history
+     * is back and live updates resumed.
+     */
+    "replay:end": {
+        reason: ReplayEndReason;
+    };
     /** An indicator's script raised an alert. `indicator` names the source — the
-     *  indicator's display title (what its legend row shows). */
+     *  indicator's display title (what its legend row shows). Never fires for bars a
+     *  replay reveals (`chart.replay`). */
     alert: EngineAlert & {
         indicator?: string;
     };
@@ -1014,6 +1173,10 @@ declare class RendererControl {
      * public seam host chrome (status lines, data windows) builds on.
      */
     onCrosshairMove(cb: (e: CrosshairEvent) => void): Unsubscribe;
+    /** A click — or a touch tap — on the plot, never the end of a pan: the open time of
+     *  the bar under it (`null` off the bars). On touch, where a tap moves no crosshair,
+     *  this is how an interaction learns which bar was chosen. */
+    onClick(cb: (e: ClickEvent) => void): Unsubscribe;
     /** Touch long-press on a price or time axis strip — silent no-op without the seam. */
     onAxisLongPress(cb: (e: AxisLongPressEvent) => void): Unsubscribe;
     /**
@@ -1487,6 +1650,7 @@ declare class Vela {
     private readonly dataControl;
     private readonly drawingsControl;
     private readonly marksControl;
+    private readonly replayControl;
     constructor(container: HTMLElement | string, options?: VelaOptions, deps?: VelaDeps);
     /**
      * Register a scripting engine so `addIndicator({ language })` can run that
@@ -1622,6 +1786,14 @@ declare class Vela {
      * model still fills but nothing paints (`chart.marks.supported`).
      */
     get marks(): MarksControl;
+    /**
+     * The chart's bar-replay control surface: rewind to a past bar and reveal the
+     * following ones by hand or on a timer, from the history already loaded —
+     * `await chart.replay.start({ from })`, `chart.replay.play(2000)`, `chart.replay.step()`,
+     * `chart.replay.stop()`. Revealed bars behave like live bars for indicators; live
+     * updates pause meanwhile. Follow it with the `replay:*` events.
+     */
+    get replay(): ReplayControl;
     on<K extends keyof VelaEventMap>(event: K, handler: (payload: VelaEventMap[K]) => void): () => void;
     /** The current visible time range (`from`/`to` in epoch-ms), or null before data loads. */
     getVisibleRange(): VisibleRange | null;
@@ -1675,6 +1847,11 @@ interface WidgetContext {
      *  it. The dock stays exclusive: opening one closes whichever was showing. Unknown ids
      *  are ignored. The seam a plugin uses to open ITS OWN panel programmatically. */
     togglePanel(id: string, open?: boolean): void;
+    /** Dock `el` as a full-width strip in the shell's layout, between the chart area and
+     *  the bottom bar — the charts shrink to make room. Strips stack in docking order.
+     *  Returns the undock (removes `el`; a no-op once it has left the strip area). The
+     *  caller owns `el`, its content and styling. */
+    dockStrip(el: HTMLElement): () => void;
     /** The widget's root element — pass it as `host` when mounting kit components
      *  (Dialog/Menu/Tooltip) from an action; without an explicit host they portal to
      *  the body, OUTSIDE the theme variables. A multi-chart shell hands its own root. */
@@ -1743,6 +1920,11 @@ interface WidgetActionDescriptor {
      *  right after the style/layout dropdowns, styled like them (the spot and look of
      *  the built-in Indicators button, for actions that replace it). */
     align?: 'left' | 'right';
+    /** Topbar only: where the action goes on the MOBILE layout (the topbar is hidden
+     *  there). `'bar'` is an icon stop on the bottom bar; `'menu'` is a row in the
+     *  three-dots menu — a left (primary) action right after Layout, a right one at the
+     *  end. Default: `'bar'` for `align: 'left'`, `'menu'` otherwise. */
+    mobile?: 'bar' | 'menu';
     /** Runtime gate — omitted ⇒ always shown. */
     when?: (ctx: WidgetContext) => boolean;
     run: (ctx: WidgetContext) => void;
@@ -2040,4 +2222,4 @@ declare function unregisterDefaultEngine(language: string): void;
  *  language. The shell layers (widget, workspace cell) register exactly this result. */
 declare function resolveEngines(overrides?: Record<string, EngineFactory>): Record<string, EngineFactory>;
 
-export { type SymbolRankingHook as $, type RunIndicatorResult as A, type BarsChangeReason as B, type CellStateContext as C, type DrawingsDocument as D, type ExternalIndicatorEntry as E, type FetchSeries as F, type SceneInspection as G, type ScriptRunCause as H, type IndicatorHandle as I, type ScriptRunResult as J, type SidePanelButton as K, type LegendActionDescriptor as L, MarksControl as M, type NativeIndicator as N, OVERRIDABLE_TOPBAR_IDS as O, type ParsedSymbol as P, type SidePanelDescriptor as Q, type Resolved as R, type ScriptingEngine as S, type SidePanelHandle as T, type SidePanelHeader as U, Vela as V, type WidgetContext as W, type StatePersistenceHandler as X, type StrategyFill as Y, type StrategyState as Z, type StrategyTrade as _, type ScriptRun as a, TypedEventBus as a0, type VelaDeps as a1, type VelaEventMap as a2, type VisibleBarRange as a3, type WidgetActionDescriptor as a4, type WidgetActionTarget as a5, type WidgetAttachment as a6, getNativeIndicator as a7, legendActions as a8, legendCallouts as a9, DEFAULT_PANEL_ORDER as aA, nativeIndicatorDescriptors as aa, nativeIndicatorTypes as ab, registerDefaultEngine as ac, registerLegendAction as ad, registerLegendCallout as ae, registerNativeIndicator as af, registerSidePanel as ag, registerStatePersistence as ah, registerSymbolRanking as ai, registerWidgetAction as aj, registerWidgetAttachment as ak, resolveEngines as al, sidePanels as am, statePersistenceHandlers as an, symbolRanking as ao, topbarActionOverride as ap, unregisterDefaultEngine as aq, unregisterLegendAction as ar, unregisterLegendCallout as as, unregisterNativeIndicator as at, unregisterSidePanel as au, unregisterStatePersistence as av, unregisterWidgetAction as aw, unregisterWidgetAttachment as ax, widgetActions as ay, widgetAttachments as az, type ContextSelect as b, DataControl as c, DrawingsControl as d, type EngineAlert as e, type EngineCapabilities as f, type EngineContextSnapshot as g, type EngineFactory as h, type EngineWarning as i, type ExecutionHandlers as j, type ExecutionMarket as k, type ExecutionRequest as l, type ExecutionSession as m, type IndicatorEventMap as n, type IndicatorSummary as o, type LegendCalloutContent as p, type LegendCalloutDescriptor as q, type LegendCalloutItem as r, type LegendCalloutSpec as s, type LegendIndicatorInfo as t, type NativeIndicatorContext as u, type NativeIndicatorDescriptor as v, type NativeIndicatorInfo as w, type NativeIndicatorOutput as x, type PreparedScript as y, RendererControl as z };
+export { type SidePanelButton as $, type NativeIndicatorDescriptor as A, type BarsChangeReason as B, type CellStateContext as C, type DrawingsDocument as D, type ExternalIndicatorEntry as E, type FetchSeries as F, type NativeIndicatorInfo as G, type NativeIndicatorOutput as H, type IndicatorHandle as I, type PreparedScript as J, RendererControl as K, type LegendActionDescriptor as L, MarksControl as M, type NativeIndicator as N, OVERRIDABLE_TOPBAR_IDS as O, type ParsedSymbol as P, ReplayControl as Q, type ReplayState as R, type ScriptingEngine as S, type ReplayEndReason as T, type ReplayStartOptions as U, Vela as V, type WidgetContext as W, type RunIndicatorResult as X, type SceneInspection as Y, type ScriptRunCause as Z, type ScriptRunResult as _, type ReplayBounds as a, type SidePanelDescriptor as a0, type SidePanelHandle as a1, type SidePanelHeader as a2, type StatePersistenceHandler as a3, type StrategyFill as a4, type StrategyState as a5, type StrategyTrade as a6, type SymbolRankingHook as a7, TypedEventBus as a8, type VelaDeps as a9, unregisterNativeIndicator as aA, unregisterSidePanel as aB, unregisterStatePersistence as aC, unregisterWidgetAction as aD, unregisterWidgetAttachment as aE, widgetActions as aF, widgetAttachments as aG, DEFAULT_PANEL_ORDER as aH, type VisibleBarRange as aa, type WidgetActionDescriptor as ab, type WidgetActionTarget as ac, type WidgetAttachment as ad, getNativeIndicator as ae, legendActions as af, legendCallouts as ag, nativeIndicatorDescriptors as ah, nativeIndicatorTypes as ai, registerDefaultEngine as aj, registerLegendAction as ak, registerLegendCallout as al, registerNativeIndicator as am, registerSidePanel as an, registerStatePersistence as ao, registerSymbolRanking as ap, registerWidgetAction as aq, registerWidgetAttachment as ar, resolveEngines as as, sidePanels as at, statePersistenceHandlers as au, symbolRanking as av, topbarActionOverride as aw, unregisterDefaultEngine as ax, unregisterLegendAction as ay, unregisterLegendCallout as az, type VelaEventMap as b, type ScriptRun as c, type Resolved as d, type ReplayTick as e, DataControl as f, type ReplayTickSource as g, type ContextSelect as h, DrawingsControl as i, type EngineAlert as j, type EngineCapabilities as k, type EngineContextSnapshot as l, type EngineFactory as m, type EngineWarning as n, type ExecutionHandlers as o, type ExecutionMarket as p, type ExecutionRequest as q, type ExecutionSession as r, type IndicatorEventMap as s, type IndicatorSummary as t, type LegendCalloutContent as u, type LegendCalloutDescriptor as v, type LegendCalloutItem as w, type LegendCalloutSpec as x, type LegendIndicatorInfo as y, type NativeIndicatorContext as z };

package/dist/{contributions-nKOSeLy8.d.ts → contributions-tjNExo1o.d.ts}

@@ -1,5 +1,5 @@
-import { x as Millis, an as InputSchema, al as IndicatorMeta, P as PriceStyle, O as OHLCV, I as InputValue, l as IndicatorModel, k as MoveTarget, aH as PaneAxis, aW as SeriesSpec, aj as Fill, G as Background, aM as PriceLine, a6 as DrawingLine, a2 as DrawingBox, a5 as DrawingLabel, aa as DrawingPolyline, a7 as DrawingLinefill, af as DrawingTable, h as IndicatorStatus, a as VisibleRange, c as VelaTheme, S as SerializedDrawing, z as DrawingTypeKey, y as SnapMode, a8 as DrawingMode, u as MarkClickEvent, e as IChartRenderer, R as RendererCapabilities, o as LegendActionView, p as LegendCalloutView, U as Unsubscribe, C as CrosshairEvent, A as AxisLongPressEvent, v as DataWindowReadout, n as SymbolPickerFn, W as WallClock, bc as PaneInfo, ai as DrawingsOption, ac as DrawingSeriesGateway, D as Drawing, s as TimelineMark, t as MarkGroup, b as VelaOptions, E as AddIndicatorOptions, aG as MarketSwitch, aF as MarketSnapshot, V as VisibleRangePreset, T as ThemeName } from './options-D1AJKsn_.js';
-import { S as SymbolInfo, B as BarRange, M as MarketDataFeed, D as DataProvider, P as ProviderInfo, a as SymbolDescriptor, b as ProviderCapabilities } from './DataProvider-CmWUtDVL.js';
+import { x as Millis, ao as InputSchema, am as IndicatorMeta, P as PriceStyle, O as OHLCV, I as InputValue, l as IndicatorModel, k as MoveTarget, aH as PaneAxis, aW as SeriesSpec, ak as Fill, H as Background, aM as PriceLine, a7 as DrawingLine, a3 as DrawingBox, a6 as DrawingLabel, ab as DrawingPolyline, a8 as DrawingLinefill, ag as DrawingTable, h as IndicatorStatus, a as VisibleRange, c as VelaTheme, S as SerializedDrawing, z as DrawingTypeKey, y as SnapMode, a9 as DrawingMode, u as MarkClickEvent, e as IChartRenderer, R as RendererCapabilities, o as LegendActionView, p as LegendCalloutView, U as Unsubscribe, C as CrosshairEvent, r as ClickEvent, A as AxisLongPressEvent, v as DataWindowReadout, n as SymbolPickerFn, W as WallClock, bc as PaneInfo, aj as DrawingsOption, ad as DrawingSeriesGateway, D as Drawing, s as TimelineMark, t as MarkGroup, b as VelaOptions, F as AddIndicatorOptions, aG as MarketSwitch, E as MarketSnapshot, V as VisibleRangePreset, T as ThemeName } from './options-BnEPUuVV.js';
+import { S as SymbolInfo, B as BarRange, M as MarketDataFeed, D as DataProvider, P as ProviderInfo, a as SymbolDescriptor, b as ProviderCapabilities } from './DataProvider-DwFIoV4r.js';
 
 /**
  * A strategy's broker state at ONE bar — the flat summary a host reads while a script
@@ -474,6 +474,8 @@ interface NativeIndicatorContext {
     readonly id: string;
     readonly symbol: string;
     readonly timeframe: string;
+    /** Whether the chart streams live data. False during a bar replay — entering and
+     *  leaving replay RESTARTS the indicator, so this never changes within one context. */
     readonly live: boolean;
     /** The chart's trading session (`'regular'` | `'extended'`); undefined = regular /
      *  no session model. A session switch reloads the market and RESTARTS the
@@ -681,6 +683,129 @@ interface ScriptRunResult {
     remove(): void;
 }
 
+/** Where a bar replay stands (`chart.replay.state`). */
+interface ReplayState {
+    /** Replay mode is on: the chart shows history up to the cursor, live updates are paused.
+     *  Stays on through a timeframe/session switch while the new bars load (`cursorTime`
+     *  is null until the replay resumes on them). */
+    active: boolean;
+    /** Bars are being revealed on a timer (`play`), as opposed to paused / stepped by hand. */
+    playing: boolean;
+    /** Open time (epoch ms) of the newest bar on screen; null when replay is off. */
+    cursorTime: number | null;
+    /** Bars still hidden to the right of the cursor. */
+    remaining: number;
+    /** Open time (epoch ms) of the next bar a step completes — the one forming tick by tick,
+     *  else the next hidden one; null when nothing is left or replay is off. Lets a host
+     *  keep several charts on one clock (see `VelaWorkspace.replay`). */
+    nextTime: number | null;
+    /** Delay between two updates while playing (ms) — two bars, or two ticks with {@link ReplayControl.setTicks}. */
+    intervalMs: number;
+}
+/** Options for {@link ReplayControl.start}. */
+interface ReplayStartOptions {
+    /**
+     * Epoch ms. The chart keeps every bar that opened at or before it and hides the rest.
+     * Older than the loaded history ⇒ the history is deepened first (clamped to the
+     * oldest bar the source serves).
+     */
+    from: number;
+}
+/** Why a replay ended (`replay:end`). */
+type ReplayEndReason = 'stopped' | 'finished' | 'market';
+/** One intrabar update of a replayed bar ({@link ReplayControl.setTicks}). */
+interface ReplayTick {
+    /** The price the forming candle closes at after this update. */
+    price: number;
+    /** The extremes traded since the previous update (default: `price`) — lets one update
+     *  stand for a whole span, e.g. a lower-timeframe bar. */
+    high?: number;
+    low?: number;
+    /** Where the candle opens — read on a bar's first update only (default: `price`). */
+    open?: number;
+    /** Volume traded by this update. When no tick of a bar carries one, the bar's volume
+     *  is spread evenly across its ticks. */
+    volume?: number;
+}
+/**
+ * Where a replay gets the intrabar prices of a bar it is about to reveal: `bar` is the
+ * stored bar, `end` the open time of the bar after it (the span the ticks cover is
+ * `[bar.time, end)`), `signal` aborts when the replay moves on (seek, stop, new source).
+ * Prices come oldest first. An empty list — or a failure — reveals the bar whole.
+ */
+type ReplayTickSource = (bar: OHLCV, opts: {
+    end: number;
+    signal: AbortSignal;
+}) => readonly ReplayTick[] | Promise<readonly ReplayTick[]>;
+/** What the chart implements behind {@link ReplayControl}. */
+interface ReplayController {
+    replayStart(opts: ReplayStartOptions): Promise<void>;
+    replayStep(): boolean;
+    replayStepUpdate(): boolean;
+    replayPlay(intervalMs?: number): void;
+    replayPause(): void;
+    replayStop(): void;
+    replayState(): ReplayState;
+    replayBounds(): ReplayBounds | null;
+    replaySetTicks(source: ReplayTickSource | null): void;
+}
+/** The open times of the oldest and newest bar a replay can start from (`chart.replay.bounds`). */
+interface ReplayBounds {
+    first: number;
+    last: number;
+}
+/**
+ * The chart's bar-replay control surface (`chart.replay`) — sibling of `chart.data` /
+ * `chart.marks`. Rewinds the chart to a past bar and reveals the following bars one at a
+ * time, by hand or on a timer, from the history already in memory (nothing is refetched).
+ * Revealed bars travel the exact path of a live bar: indicators, chart-type engines and
+ * the `bar` event see them as new bars — but script alerts stay quiet (a replayed bar is
+ * history, not a live signal). Live updates pause for the duration; `stop()` (or
+ * revealing the last bar) restores the full history and resumes them. A timeframe or
+ * session switch carries the replay over to the new bars at the same point in time; a
+ * symbol switch ends it.
+ */
+declare class ReplayControl {
+    private readonly ctrl;
+    constructor(ctrl: ReplayController);
+    /**
+     * Enter replay (or seek, when already replaying) at `opts.from`. Resolves once the
+     * chart shows the rewound history — after any in-flight history load has finished.
+     * Starts paused; call {@link play} or {@link step}.
+     */
+    start(opts: ReplayStartOptions): Promise<void>;
+    /** Reveal the next bar — or, mid-way through a bar played tick by tick, complete it.
+     *  Returns false when replay is off or nothing is left. */
+    step(): boolean;
+    /** Reveal the next UPDATE: with {@link setTicks}, the next tick of the forming bar — or
+     *  the next bar opened at its first tick (once its ticks are in, if still loading);
+     *  otherwise the next whole bar, like {@link step}. Returns false when nothing is left. */
+    stepUpdate(): boolean;
+    /** Reveal one bar (one tick, with {@link setTicks}) every `intervalMs` (default: the last
+     *  interval used, else 1000). Calling it again while playing changes the pace. */
+    play(intervalMs?: number): this;
+    pause(): this;
+    /** Leave replay: the full history comes back and live updates resume. Also cancels a
+     *  `start()` still loading older history (the chart returns to its previous depth). */
+    stop(): this;
+    get state(): ReplayState;
+    /** The loaded history a replay can walk — hidden bars included while replaying. Null
+     *  before any bar loaded. A start older than `first` deepens the history first. */
+    get bounds(): ReplayBounds | null;
+    /**
+     * Play each revealed bar as a series of intrabar updates instead of whole: while
+     * playing, the forming candle opens at the first tick, then every tick moves its close
+     * and stretches its high and low, exactly like a live tick — indicators, chart types
+     * and the `bar` event follow — and the last one settles it on the stored bar. The play
+     * interval is then the time between two TICKS: a bar lasts as many intervals as it
+     * has ticks (below ~16 ms, ticks are batched per frame). The next bar's ticks are
+     * requested while the current one plays; playback waits for them. `null` goes back to
+     * whole bars. Takes effect from the next bar; a bar forming when the source changes
+     * completes at once.
+     */
+    setTicks(source: ReplayTickSource | null): this;
+}
+
 /** Chart-level events emitted on `chart.on(...)`. */
 interface VelaEventMap extends Record<string, unknown> {
     ready: undefined;
@@ -838,7 +963,7 @@ interface VelaEventMap extends Record<string, unknown> {
     "context:changed": {
         id: string;
     };
-    /** A live tick: the forming bar was updated or a new bar appended. */
+    /** A live tick: the forming bar was updated or a new bar appended (a bar revealed by replay included). */
     bar: OHLCV;
     /**
      * The visible time range moved (pan/zoom/fit — fires per applied change, NOT
@@ -865,8 +990,42 @@ interface VelaEventMap extends Record<string, unknown> {
         oldestTime: number;
         barsLoaded: number;
     };
+    /** Replay mode began (or seeked): the chart shows history up to `cursorTime`, `remaining` bars are hidden. */
+    "replay:start": {
+        cursorTime: number;
+        remaining: number;
+    };
+    /** One hidden bar was revealed (it also fires `bar`, like a live bar). A bar played tick
+     *  by tick steps once, when its last tick settles it. */
+    "replay:step": {
+        cursorTime: number;
+        remaining: number;
+    };
+    /** An intrabar update of the bar forming at `cursorTime` (`chart.replay.setTicks`):
+     *  tick `index` of `count` is applied (batched updates report the last one). */
+    "replay:tick": {
+        cursorTime: number;
+        index: number;
+        count: number;
+    };
+    /** Timed reveal started, or its pace changed. */
+    "replay:play": {
+        intervalMs: number;
+    };
+    /** Timed reveal paused — `pause()`, or a seek (`start()` while playing). */
+    "replay:pause": undefined;
+    /**
+     * Replay mode ended: `'stopped'` = `chart.replay.stop()`, `'finished'` = the last hidden
+     * bar was revealed, `'market'` = a symbol switch replaced the history (a timeframe or
+     * session switch carries the replay over instead). The full history
+     * is back and live updates resumed.
+     */
+    "replay:end": {
+        reason: ReplayEndReason;
+    };
     /** An indicator's script raised an alert. `indicator` names the source — the
-     *  indicator's display title (what its legend row shows). */
+     *  indicator's display title (what its legend row shows). Never fires for bars a
+     *  replay reveals (`chart.replay`). */
     alert: EngineAlert & {
         indicator?: string;
     };
@@ -1014,6 +1173,10 @@ declare class RendererControl {
      * public seam host chrome (status lines, data windows) builds on.
      */
     onCrosshairMove(cb: (e: CrosshairEvent) => void): Unsubscribe;
+    /** A click — or a touch tap — on the plot, never the end of a pan: the open time of
+     *  the bar under it (`null` off the bars). On touch, where a tap moves no crosshair,
+     *  this is how an interaction learns which bar was chosen. */
+    onClick(cb: (e: ClickEvent) => void): Unsubscribe;
     /** Touch long-press on a price or time axis strip — silent no-op without the seam. */
     onAxisLongPress(cb: (e: AxisLongPressEvent) => void): Unsubscribe;
     /**
@@ -1487,6 +1650,7 @@ declare class Vela {
     private readonly dataControl;
     private readonly drawingsControl;
     private readonly marksControl;
+    private readonly replayControl;
     constructor(container: HTMLElement | string, options?: VelaOptions, deps?: VelaDeps);
     /**
      * Register a scripting engine so `addIndicator({ language })` can run that
@@ -1622,6 +1786,14 @@ declare class Vela {
      * model still fills but nothing paints (`chart.marks.supported`).
      */
     get marks(): MarksControl;
+    /**
+     * The chart's bar-replay control surface: rewind to a past bar and reveal the
+     * following ones by hand or on a timer, from the history already loaded —
+     * `await chart.replay.start({ from })`, `chart.replay.play(2000)`, `chart.replay.step()`,
+     * `chart.replay.stop()`. Revealed bars behave like live bars for indicators; live
+     * updates pause meanwhile. Follow it with the `replay:*` events.
+     */
+    get replay(): ReplayControl;
     on<K extends keyof VelaEventMap>(event: K, handler: (payload: VelaEventMap[K]) => void): () => void;
     /** The current visible time range (`from`/`to` in epoch-ms), or null before data loads. */
     getVisibleRange(): VisibleRange | null;
@@ -1675,6 +1847,11 @@ interface WidgetContext {
      *  it. The dock stays exclusive: opening one closes whichever was showing. Unknown ids
      *  are ignored. The seam a plugin uses to open ITS OWN panel programmatically. */
     togglePanel(id: string, open?: boolean): void;
+    /** Dock `el` as a full-width strip in the shell's layout, between the chart area and
+     *  the bottom bar — the charts shrink to make room. Strips stack in docking order.
+     *  Returns the undock (removes `el`; a no-op once it has left the strip area). The
+     *  caller owns `el`, its content and styling. */
+    dockStrip(el: HTMLElement): () => void;
     /** The widget's root element — pass it as `host` when mounting kit components
      *  (Dialog/Menu/Tooltip) from an action; without an explicit host they portal to
      *  the body, OUTSIDE the theme variables. A multi-chart shell hands its own root. */
@@ -1743,6 +1920,11 @@ interface WidgetActionDescriptor {
      *  right after the style/layout dropdowns, styled like them (the spot and look of
      *  the built-in Indicators button, for actions that replace it). */
     align?: 'left' | 'right';
+    /** Topbar only: where the action goes on the MOBILE layout (the topbar is hidden
+     *  there). `'bar'` is an icon stop on the bottom bar; `'menu'` is a row in the
+     *  three-dots menu — a left (primary) action right after Layout, a right one at the
+     *  end. Default: `'bar'` for `align: 'left'`, `'menu'` otherwise. */
+    mobile?: 'bar' | 'menu';
     /** Runtime gate — omitted ⇒ always shown. */
     when?: (ctx: WidgetContext) => boolean;
     run: (ctx: WidgetContext) => void;
@@ -2040,4 +2222,4 @@ declare function unregisterDefaultEngine(language: string): void;
  *  language. The shell layers (widget, workspace cell) register exactly this result. */
 declare function resolveEngines(overrides?: Record<string, EngineFactory>): Record<string, EngineFactory>;
 
-export { type SymbolRankingHook as $, type RunIndicatorResult as A, type BarsChangeReason as B, type CellStateContext as C, type DrawingsDocument as D, type ExternalIndicatorEntry as E, type FetchSeries as F, type SceneInspection as G, type ScriptRunCause as H, type IndicatorHandle as I, type ScriptRunResult as J, type SidePanelButton as K, type LegendActionDescriptor as L, MarksControl as M, type NativeIndicator as N, OVERRIDABLE_TOPBAR_IDS as O, type ParsedSymbol as P, type SidePanelDescriptor as Q, type Resolved as R, type ScriptingEngine as S, type SidePanelHandle as T, type SidePanelHeader as U, Vela as V, type WidgetContext as W, type StatePersistenceHandler as X, type StrategyFill as Y, type StrategyState as Z, type StrategyTrade as _, type ScriptRun as a, TypedEventBus as a0, type VelaDeps as a1, type VelaEventMap as a2, type VisibleBarRange as a3, type WidgetActionDescriptor as a4, type WidgetActionTarget as a5, type WidgetAttachment as a6, getNativeIndicator as a7, legendActions as a8, legendCallouts as a9, DEFAULT_PANEL_ORDER as aA, nativeIndicatorDescriptors as aa, nativeIndicatorTypes as ab, registerDefaultEngine as ac, registerLegendAction as ad, registerLegendCallout as ae, registerNativeIndicator as af, registerSidePanel as ag, registerStatePersistence as ah, registerSymbolRanking as ai, registerWidgetAction as aj, registerWidgetAttachment as ak, resolveEngines as al, sidePanels as am, statePersistenceHandlers as an, symbolRanking as ao, topbarActionOverride as ap, unregisterDefaultEngine as aq, unregisterLegendAction as ar, unregisterLegendCallout as as, unregisterNativeIndicator as at, unregisterSidePanel as au, unregisterStatePersistence as av, unregisterWidgetAction as aw, unregisterWidgetAttachment as ax, widgetActions as ay, widgetAttachments as az, type ContextSelect as b, DataControl as c, DrawingsControl as d, type EngineAlert as e, type EngineCapabilities as f, type EngineContextSnapshot as g, type EngineFactory as h, type EngineWarning as i, type ExecutionHandlers as j, type ExecutionMarket as k, type ExecutionRequest as l, type ExecutionSession as m, type IndicatorEventMap as n, type IndicatorSummary as o, type LegendCalloutContent as p, type LegendCalloutDescriptor as q, type LegendCalloutItem as r, type LegendCalloutSpec as s, type LegendIndicatorInfo as t, type NativeIndicatorContext as u, type NativeIndicatorDescriptor as v, type NativeIndicatorInfo as w, type NativeIndicatorOutput as x, type PreparedScript as y, RendererControl as z };
+export { type SidePanelButton as $, type NativeIndicatorDescriptor as A, type BarsChangeReason as B, type CellStateContext as C, type DrawingsDocument as D, type ExternalIndicatorEntry as E, type FetchSeries as F, type NativeIndicatorInfo as G, type NativeIndicatorOutput as H, type IndicatorHandle as I, type PreparedScript as J, RendererControl as K, type LegendActionDescriptor as L, MarksControl as M, type NativeIndicator as N, OVERRIDABLE_TOPBAR_IDS as O, type ParsedSymbol as P, ReplayControl as Q, type ReplayState as R, type ScriptingEngine as S, type ReplayEndReason as T, type ReplayStartOptions as U, Vela as V, type WidgetContext as W, type RunIndicatorResult as X, type SceneInspection as Y, type ScriptRunCause as Z, type ScriptRunResult as _, type ReplayBounds as a, type SidePanelDescriptor as a0, type SidePanelHandle as a1, type SidePanelHeader as a2, type StatePersistenceHandler as a3, type StrategyFill as a4, type StrategyState as a5, type StrategyTrade as a6, type SymbolRankingHook as a7, TypedEventBus as a8, type VelaDeps as a9, unregisterNativeIndicator as aA, unregisterSidePanel as aB, unregisterStatePersistence as aC, unregisterWidgetAction as aD, unregisterWidgetAttachment as aE, widgetActions as aF, widgetAttachments as aG, DEFAULT_PANEL_ORDER as aH, type VisibleBarRange as aa, type WidgetActionDescriptor as ab, type WidgetActionTarget as ac, type WidgetAttachment as ad, getNativeIndicator as ae, legendActions as af, legendCallouts as ag, nativeIndicatorDescriptors as ah, nativeIndicatorTypes as ai, registerDefaultEngine as aj, registerLegendAction as ak, registerLegendCallout as al, registerNativeIndicator as am, registerSidePanel as an, registerStatePersistence as ao, registerSymbolRanking as ap, registerWidgetAction as aq, registerWidgetAttachment as ar, resolveEngines as as, sidePanels as at, statePersistenceHandlers as au, symbolRanking as av, topbarActionOverride as aw, unregisterDefaultEngine as ax, unregisterLegendAction as ay, unregisterLegendCallout as az, type VelaEventMap as b, type ScriptRun as c, type Resolved as d, type ReplayTick as e, DataControl as f, type ReplayTickSource as g, type ContextSelect as h, DrawingsControl as i, type EngineAlert as j, type EngineCapabilities as k, type EngineContextSnapshot as l, type EngineFactory as m, type EngineWarning as n, type ExecutionHandlers as o, type ExecutionMarket as p, type ExecutionRequest as q, type ExecutionSession as r, type IndicatorEventMap as s, type IndicatorSummary as t, type LegendCalloutContent as u, type LegendCalloutDescriptor as v, type LegendCalloutItem as w, type LegendCalloutSpec as x, type LegendIndicatorInfo as y, type NativeIndicatorContext as z };