@luxalgo/vela 0.8.3 → 0.8.5

package/dist/{options-lMUwmRwh.d.ts → options-BI5Tp32b.d.ts}

@@ -103,11 +103,20 @@ interface SeriesBase {
 }
 interface LineLikeSeries extends SeriesBase {
     kind: LineLikeKind;
+    /**
+     * One entry per bar the indicator ran over, index-aligned to the bars: entry `i` draws on
+     * bar `i`, whatever its `time`. Entries past the last bar draw on the bar slots after it,
+     * one per slot, so a series shifted forward continues into the chart's right whitespace;
+     * give them the times those slots would have. A gap is a `value: null` entry.
+     */
     points: SeriesPoint[];
     style: LineLikeStyle;
 }
 interface CandleSeries extends SeriesBase {
     kind: 'candle' | 'bar';
+    /** One entry per bar the indicator ran over, index-aligned like `points`. A bar with no
+     *  candle is an empty slot (or an entry with `NaN` prices): it draws nothing, and the
+     *  candles after it stay on their own bars. Never compact the array to drop it. */
     bars: OHLCV[];
     style?: Partial<CandleStyle>;
     /** Per-bar plotcandle/plotbar colours, aligned to `bars` by index (null ≡ use defaults). */
@@ -323,7 +332,8 @@ interface Pane {
     kind: PaneKind;
     /** Display order, top-to-bottom; the price pane is conventionally order 0. */
     order: number;
-    /** Relative height weight among panes (the renderer normalizes). */
+    /** Relative height weight among panes (the renderer normalizes). Omitted keeps the
+     *  weight an existing pane already has; a new pane gets the renderer's default. */
     heightWeight?: number;
     title?: string;
 }
@@ -613,6 +623,12 @@ type SeriesValueDelta = {
     seriesId: string;
     kind: 'bars';
     bars: OHLCV[];
+    /**
+     * The series' per-bar colors (see `CandleSeries.barColors`), index-aligned to `bars`.
+     * Omitted keeps the current ones; the orchestrator always states them, `[]` included,
+     * so a run that emits no colors clears the previous set instead of leaving it on new bars.
+     */
+    barColors?: Array<CandleBarColor | null>;
 } | {
     seriesId: string;
     kind: 'markers';
@@ -848,6 +864,10 @@ interface DrawingStyle {
     fillOpacity?: number;
     arrowLeft?: boolean;
     arrowRight?: boolean;
+    /** Run the line past its first anchor to the chart edge (trend line). */
+    extendLeft?: boolean;
+    /** Run the line past its second anchor to the chart edge (trend line). */
+    extendRight?: boolean;
 }
 /** A drawing's editable text/annotation block. */
 interface DrawingText {
@@ -859,6 +879,10 @@ interface DrawingText {
     vAlign: 'top' | 'center' | 'bottom';
     bold?: boolean;
     italic?: boolean;
+    /** Where a line's label sits along it (line tools); absent = the middle. */
+    place?: 'start' | 'middle' | 'end';
+    /** Which side of the line its label sits on (line tools); absent = above. */
+    side?: 'above' | 'below';
 }
 
 /**
@@ -884,6 +908,12 @@ interface SettingsField {
     }>;
     /** Cosmetic grouping in the popup. */
     group?: 'line' | 'fill' | 'text' | 'behavior';
+    /** Only offered while another setting holds one of these values (an option that matters
+     *  only in some modes). */
+    when?: {
+        path: string;
+        in: readonly unknown[];
+    };
 }
 interface SettingsSchema {
     fields: SettingsField[];
@@ -899,7 +929,7 @@ interface SettingsSchema {
  * The interactive user-drawing types. The lean-core set ships first; new types
  * (fibs/patterns) extend the union + register a class — no base/port change.
  */
-type DrawingTypeKey = 'trendline' | 'hline' | 'ray' | 'extendedline' | 'vline' | 'hray' | 'crossline' | 'infoline' | 'trendangle' | 'box' | 'text' | 'note' | 'pricenote' | 'comment' | 'pricelabel' | 'signpost' | 'parallelchannel' | 'disjointchannel' | 'flattopbottom' | 'regressionchannel' | 'anchoredvwap' | 'fixedrangevp' | 'pitchfork' | 'schiffpitchfork' | 'modifiedschiffpitchfork' | 'insidepitchfork' | 'arrow' | 'callout' | 'ellipse' | 'triangle' | 'polyline' | 'freehand' | 'highlighter' | 'circle' | 'rotatedrect' | 'path' | 'arc' | 'curve' | 'arrowmarkup' | 'arrowmarkdown' | 'flagmark' | 'iconstamp' | 'fibretracement' | 'fibextension' | 'fibextensiontrend' | 'fibfan' | 'fibtimezones' | 'fibchannel' | 'fibspeedfan' | 'trendfibtime' | 'fibcircles' | 'fibarcs' | 'fibwedge' | 'fibspiral' | 'gannfan' | 'gannbox' | 'gannsquare' | 'dedekind' | 'sonic' | 'supersonic' | 'goldensonic' | 'goldensupersonic' | 'datepricerange' | 'position' | 'magnifier' | 'xabcd' | 'abcd' | 'elliottimpulse' | 'elliottcorrection' | 'headshoulders' | 'gartley' | 'bat' | 'butterfly' | 'crab' | 'shark' | 'cypher';
+type DrawingTypeKey = 'trendline' | 'hline' | 'ray' | 'extendedline' | 'vline' | 'hray' | 'crossline' | 'infoline' | 'trendangle' | 'box' | 'text' | 'note' | 'pricenote' | 'comment' | 'pricelabel' | 'signpost' | 'parallelchannel' | 'disjointchannel' | 'flattopbottom' | 'regressionchannel' | 'anchoredvwap' | 'fixedrangevp' | 'pitchfork' | 'schiffpitchfork' | 'modifiedschiffpitchfork' | 'insidepitchfork' | 'arrow' | 'callout' | 'ellipse' | 'triangle' | 'polyline' | 'freehand' | 'highlighter' | 'circle' | 'rotatedrect' | 'path' | 'arc' | 'curve' | 'arrowmarkup' | 'arrowmarkdown' | 'flagmark' | 'iconstamp' | 'fibretracement' | 'fibextension' | 'fibextensiontrend' | 'fibfan' | 'fibtimezones' | 'fibchannel' | 'fibspeedfan' | 'trendfibtime' | 'fibcircles' | 'fibarcs' | 'fibwedge' | 'fibspiral' | 'gannfan' | 'gannbox' | 'gannsquare' | 'dedekind' | 'sonic' | 'supersonic' | 'goldensonic' | 'goldensupersonic' | 'datepricerange' | 'position' | 'magnifier' | 'xabcd' | 'abcd' | 'elliottimpulse' | 'elliottcorrection' | 'headshoulders' | 'gartley' | 'bat' | 'butterfly' | 'crab' | 'shark' | 'cypher' | 'fairvaluegap' | 'orderblock' | 'liquidity';
 /** One anchor's role + which axes its handle may move along. */
 interface AnchorSlot {
     role: string;
@@ -927,6 +957,8 @@ interface SerializedDrawing {
     createdAt: number;
     /** Per-type extras (e.g. box `extend`) — keeps the base closed. */
     props?: Record<string, unknown>;
+    /** The timeframe bands the drawing shows on (see `TIMEFRAME_BANDS`); absent = every one. */
+    showOn?: string[];
 }
 /**
  * The parent of every user drawing. Owns the shared state + settings/serialization
@@ -945,6 +977,8 @@ declare abstract class Drawing {
     locked: boolean;
     visible: boolean;
     zIndex: number;
+    /** The timeframe bands the drawing shows on; `undefined` = every timeframe. */
+    showOn?: string[];
     readonly createdAt: number;
     constructor(init: Partial<SerializedDrawing> & {
         paneId: string;
@@ -1085,6 +1119,24 @@ declare function buildToolbar(option: DrawingsOption | undefined): {
     visible: boolean;
 };
 
+/**
+ * A tool's remembered settings — what the next drawing of that type starts from. Captured
+ * from the last drawing of the type the user styled: its style, its text styling (never the
+ * words themselves) and its per-type settings (`props`: fib levels, position sizing, profile
+ * rows…). Geometry, lock, visibility and depth are per-drawing and never carried over.
+ */
+interface DrawingToolDefaults {
+    style?: Partial<DrawingStyle>;
+    text?: Partial<Omit<DrawingText, 'value'>>;
+    props?: Record<string, unknown>;
+}
+/** A named, saved look for one tool (a "style"): applied, it sets the same settings a
+ *  remembered default does — style, text styling and per-type settings. */
+interface DrawingToolTemplate {
+    name: string;
+    settings: DrawingToolDefaults;
+}
+
 /**
  * The renderer-local drawing MODES beyond an armed tool: the transient measure ruler,
  * the eraser, or none. Mutually exclusive with each other and with any armed tool —
@@ -1140,6 +1192,19 @@ type DrawingIntent = {
     kind: 'favorite';
     type: DrawingTypeKey;
     on: boolean;
+}
+/** The settings panel saved the drawing's look as a named style for its tool. */
+ | {
+    kind: 'template-save';
+    type: DrawingTypeKey;
+    name: string;
+    settings: DrawingToolDefaults;
+}
+/** The settings panel deleted one of a tool's saved styles. */
+ | {
+    kind: 'template-remove';
+    type: DrawingTypeKey;
+    name: string;
 } | {
     kind: 'snap-mode';
     mode: SnapMode;
@@ -1188,13 +1253,18 @@ interface IDrawingsRendererPort {
     syncDrawings(docs: readonly SerializedDrawing[]): void;
     /** Arm/disarm a tool (`null` = selection/idle, pan resumes). `lastStyle` is the
      *  tool's last-used style (if any) so the placement preview matches what will be
-     *  committed, rather than falling back to the type default. */
-    setActiveTool(type: DrawingTypeKey | null, lastStyle?: SerializedDrawing['style']): void;
+     *  committed, rather than falling back to the type default; `defaults` carries the
+     *  tool's whole remembered settings (style, text styling, per-type settings) for a
+     *  renderer that previews more than the style. */
+    setActiveTool(type: DrawingTypeKey | null, lastStyle?: SerializedDrawing['style'], defaults?: DrawingToolDefaults): void;
     /** Reflect which drawings are selected (drives handle painting); `[]` = none. */
     setSelection(ids: readonly string[]): void;
     /** Push the FAVORITE tool set (flyout stars + any favorites-driven UI). Optional —
      *  favorites still work headless without a renderer reflection. */
     setFavorites?(types: readonly DrawingTypeKey[]): void;
+    /** Push every tool's saved looks (the settings panel's style menu). Optional — the
+     *  styles still round-trip through the core without a renderer reflection. */
+    setToolTemplates?(map: Readonly<Partial<Record<DrawingTypeKey, DrawingToolTemplate[]>>>): void;
     /** Push per-tool shortcut hints — PRE-FORMATTED display strings (e.g. `'Alt+T'`)
      *  shown beside the tools in the toolbar flyouts. The host owns the keymap and the
      *  platform formatting; the renderer only displays. Optional. */
@@ -1456,6 +1526,9 @@ interface CrosshairEvent {
      *  horizontal level from the price pane). Optional and additive: a renderer that
      *  doesn't track panes omits it. */
     paneKind?: 'price' | 'study' | null;
+    /** The id of the pane under the cursor — the same id `chart.panes.list()` reports;
+     *  null off the plot. Optional and additive, like {@link paneKind}. */
+    paneId?: string | null;
     /** Value at the crosshair per series, keyed by stable series id. */
     values: ReadonlyMap<string, number>;
     /** The hovered price bar's OHLCV (null when the cursor is off any bar). */
@@ -1463,7 +1536,12 @@ interface CrosshairEvent {
 }
 interface ClickEvent {
     time: Millis | null;
+    /** Value at the click on its pane's scale, as {@link CrosshairEvent.price}. */
     price: number | null;
+    /** The kind of pane clicked; null off the plot. Optional — a renderer that doesn't track panes omits it. */
+    paneKind?: 'price' | 'study' | null;
+    /** The id of the pane clicked (as `chart.panes.list()` reports it); null off the plot. Optional. */
+    paneId?: string | null;
 }
 /** A touch long-press on an axis strip — the mobile substitute for a right-click menu. */
 interface AxisLongPressEvent {
@@ -1534,6 +1612,11 @@ type PaneAction = {
     type: 'maximize';
     paneId: string;
     maximized: boolean;
+}
+/** The user finished resizing panes (a separator drag or reset); read the new weights back through `paneHeightWeight`. */
+ | {
+    type: 'resize';
+    paneIds: string[];
 };
 /**
  * The rendering backend abstraction. No backend (e.g. lightweight-charts) types
@@ -1621,6 +1704,14 @@ interface IChartRenderer {
     setPaneCollapsed?(paneId: string, collapsed: boolean): void;
     /** Maximize one pane to fill the plot, or restore the previous split (`null`). */
     setPaneMaximized?(paneId: string | null): void;
+    /**
+     * Set a pane's height weight: panes share the plot height in proportion to their weights
+     * (collapsed panes aside). The weight must survive later `ensurePane` calls that carry
+     * none — only an explicit `heightWeight` replaces it.
+     */
+    setPaneHeightWeight?(paneId: string, weight: number): void;
+    /** A pane's current height weight, or null when the renderer has no such pane. */
+    paneHeightWeight?(paneId: string): number | null;
     /**
      * The renderer reports a user-initiated pane action (from a pane hover button or a
      * double-click). The host/core reflects it: `'remove'` tears down the pane's
@@ -2138,6 +2229,10 @@ interface PaneInfo {
     order: number;
     collapsed: boolean;
     maximized: boolean;
+    /** The pane's share of the plot height relative to the other panes (the price pane
+     *  defaults to 3, study panes to 1 on the native renderer). Absent on a renderer that
+     *  doesn't report pane sizes. */
+    heightWeight?: number;
     indicators: Array<{
         id: string;
         title: string;
@@ -2173,4 +2268,4 @@ interface AddIndicatorOptions {
     title?: string;
 }
 
-export { type DataWindowGroup as $, type AxisLongPressEvent as A, type ToolbarDefinition as B, type CrosshairEvent as C, Drawing as D, type MarketSnapshot as E, type AddIndicatorOptions as F, type AnimationConfig as G, type Background as H, type InputValue as I, type BoxFontFamily as J, type BoxHAlign as K, type LineStyle as L, type MarketConfig as M, type NativeBackend as N, type OHLCV as O, type PriceStyle as P, type BoxTextSize as Q, type RendererCapabilities as R, type SerializedDrawing as S, type ThemeName as T, type Unsubscribe as U, type VisibleRangePreset as V, type WallClock as W, type BoxVAlign as X, type CandleBarColor as Y, type CandleSeries as Z, type CandleStyle as _, type VisibleRange as a, type SeriesSurface as a$, type DataWindowOHLC as a0, type DataWindowRow as a1, type DirtyRange as a2, type DrawingBox as a3, type DrawingExtend as a4, type DrawingIntent as a5, type DrawingLabel as a6, type DrawingLine as a7, type DrawingLinefill as a8, type DrawingMode as a9, type MarkContentSource as aA, type MarkGlyph as aB, type MarkPanelItem as aC, type MarkShape as aD, type MarkerPoint as aE, type MarkerSeries as aF, type MarketSwitch as aG, type PaneAxis as aH, type PaneAxisBand as aI, type PaneHint as aJ, type PaneKind as aK, type PolylinePoint as aL, type PriceAxisOptions as aM, type PriceAxisTick as aN, type PriceAxisTickContext as aO, type PriceAxisTicksFn as aP, type PriceLine as aQ, type Projector as aR, type ProviderName as aS, type RendererConstructor as aT, type Scene as aU, type SchemaPatch as aV, SecondClock as aW, type SeriesDisplay as aX, type SeriesKind as aY, type SeriesPoint as aZ, type SeriesSpec as a_, type DrawingPoint as aa, type DrawingPolyline as ab, type DrawingSeriesBar as ac, type DrawingSeriesGateway as ad, type DrawingSeriesState as ae, type DrawingStyle as af, type DrawingTable as ag, type DrawingText as ah, type DrawingXLoc as ai, type DrawingsOption as aj, type Fill as ak, type FillGradientStop as al, type IndicatorMeta as am, type InputCondition as an, type InputSchema as ao, type InputType as ap, type InputWhen as aq, type IntroAnimation as ar, type IntroConfig as as, type IntroStyle as at, type LabelStyle as au, type LabelYLoc as av, type LineLikeKind as aw, type LineLikeSeries as ax, type LineLikeStyle as ay, type MarkContent as az, type VelaOptions as b, type SeriesValueDelta as b0, type SettingsField as b1, type SettingsSchema as b2, type SettingsVisibilityPolicy as b3, type TableCell as b4, type TableMerge as b5, type TablePosition as b6, type ToolbarGroupConfig as b7, type TradeExecution as b8, type ValuePatch as b9, buildToolbar as ba, defaultToolbar as bb, inputDeltas as bc, inputVisible as bd, seriesInScale as be, seriesShownOn as bf, type PaneInfo as bg, type VelaTheme as c, type MarketSession as d, type IChartRenderer as e, type RendererDisplayOptions as f, type IndicatorRenderHandle as g, type IndicatorStatus as h, type Pane as i, type PaneAction as j, type MoveTarget as k, type IndicatorModel as l, type ScenePatch as m, type SymbolPickerFn as n, type LegendActionView as o, type LegendCalloutView as p, type InputChangeEvent as q, type ClickEvent as r, type TimelineMark as s, type MarkGroup as t, type MarkClickEvent as u, type DataWindowReadout as v, type IDrawingsRendererPort as w, type Millis as x, type SnapMode as y, type DrawingTypeKey as z };
+export { type DataWindowGroup as $, type AxisLongPressEvent as A, type ToolbarDefinition as B, type CrosshairEvent as C, Drawing as D, type MarketSnapshot as E, type AddIndicatorOptions as F, type AnimationConfig as G, type Background as H, type InputValue as I, type BoxFontFamily as J, type BoxHAlign as K, type LineStyle as L, type MarketConfig as M, type NativeBackend as N, type OHLCV as O, type PriceStyle as P, type BoxTextSize as Q, type RendererCapabilities as R, type SerializedDrawing as S, type ThemeName as T, type Unsubscribe as U, type VisibleRangePreset as V, type WallClock as W, type BoxVAlign as X, type CandleBarColor as Y, type CandleSeries as Z, type CandleStyle as _, type VisibleRange as a, type SeriesSurface as a$, type DataWindowOHLC as a0, type DataWindowRow as a1, type DirtyRange as a2, type DrawingBox as a3, type DrawingExtend as a4, type DrawingIntent as a5, type DrawingLabel as a6, type DrawingLine as a7, type DrawingLinefill as a8, type DrawingMode as a9, type MarkContentSource as aA, type MarkGlyph as aB, type MarkPanelItem as aC, type MarkShape as aD, type MarkerPoint as aE, type MarkerSeries as aF, type MarketSwitch as aG, type PaneAxis as aH, type PaneAxisBand as aI, type PaneHint as aJ, type PaneKind as aK, type PolylinePoint as aL, type PriceAxisOptions as aM, type PriceAxisTick as aN, type PriceAxisTickContext as aO, type PriceAxisTicksFn as aP, type PriceLine as aQ, type Projector as aR, type ProviderName as aS, type RendererConstructor as aT, type Scene as aU, type SchemaPatch as aV, SecondClock as aW, type SeriesDisplay as aX, type SeriesKind as aY, type SeriesPoint as aZ, type SeriesSpec as a_, type DrawingPoint as aa, type DrawingPolyline as ab, type DrawingSeriesBar as ac, type DrawingSeriesGateway as ad, type DrawingSeriesState as ae, type DrawingStyle as af, type DrawingTable as ag, type DrawingText as ah, type DrawingXLoc as ai, type DrawingsOption as aj, type Fill as ak, type FillGradientStop as al, type IndicatorMeta as am, type InputCondition as an, type InputSchema as ao, type InputType as ap, type InputWhen as aq, type IntroAnimation as ar, type IntroConfig as as, type IntroStyle as at, type LabelStyle as au, type LabelYLoc as av, type LineLikeKind as aw, type LineLikeSeries as ax, type LineLikeStyle as ay, type MarkContent as az, type VelaOptions as b, type SeriesValueDelta as b0, type SettingsField as b1, type SettingsSchema as b2, type SettingsVisibilityPolicy as b3, type TableCell as b4, type TableMerge as b5, type TablePosition as b6, type ToolbarGroupConfig as b7, type TradeExecution as b8, type ValuePatch as b9, buildToolbar as ba, defaultToolbar as bb, inputDeltas as bc, inputVisible as bd, seriesInScale as be, seriesShownOn as bf, type PaneInfo as bg, type DrawingToolDefaults as bh, type DrawingToolTemplate as bi, type VelaTheme as c, type MarketSession as d, type IChartRenderer as e, type RendererDisplayOptions as f, type IndicatorRenderHandle as g, type IndicatorStatus as h, type Pane as i, type PaneAction as j, type MoveTarget as k, type IndicatorModel as l, type ScenePatch as m, type SymbolPickerFn as n, type LegendActionView as o, type LegendCalloutView as p, type InputChangeEvent as q, type ClickEvent as r, type TimelineMark as s, type MarkGroup as t, type MarkClickEvent as u, type DataWindowReadout as v, type IDrawingsRendererPort as w, type Millis as x, type SnapMode as y, type DrawingTypeKey as z };

package/dist/{plugin-Do5J5xuF.d.cts → plugin-B8F1nor8.d.cts}

@@ -1,9 +1,9 @@
-import { z as DrawingTypeKey, af as DrawingStyle, S as SerializedDrawing, D as Drawing, O as OHLCV, aY as SeriesKind, c as VelaTheme } from './options-lMUwmRwh.cjs';
-import { f as DataControl } from './contributions-BhOBRenr.cjs';
+import { z as DrawingTypeKey, af as DrawingStyle, S as SerializedDrawing, D as Drawing, O as OHLCV, aY as SeriesKind, c as VelaTheme } from './options-BI5Tp32b.cjs';
+import { f as DataControl } from './contributions-D8xuYc9U.cjs';
 import './side-panel-_2UK1gSm.cjs';
 import './icons-BZYbJXSV.cjs';
 import './keymap-CGOz5F5f.cjs';
-import './DataProvider-wbtJ3-Sa.cjs';
+import './DataProvider-DdqMxKdl.cjs';
 
 /** What a drawing type contributes to the toolbar + factory (renderer-neutral). */
 interface DrawingTypeMeta {
@@ -184,17 +184,23 @@ interface SeriesDataEngineHost {
 }
 /**
  * A per-chart data engine behind a chart type: created on first entry into the style,
- * suspended/resumed as the user switches styles, stopped when the chart is destroyed.
+ * suspended/resumed as the user switches styles, replaced by a fresh engine when the
+ * market or the replay state changes, stopped when the chart is destroyed.
  * All methods are fire-and-forget from the chart's point of view — the engine owns its
- * own scheduling and pushes results through the host channels.
+ * own scheduling and pushes results through the host channels. The host forwards pushes
+ * only from the chart's current, unsuspended engine: work still in flight when the
+ * engine is suspended or stopped never reaches the scene.
  */
 interface SeriesDataEngine {
     start(host: SeriesDataEngineHost): void;
-    /** The style was left — stop fetching/pushing, keep state for a cheap resume. */
+    /** The style was left, or a market switch began — stop fetching/pushing, keep state
+     *  for a cheap resume. Host pushes are dropped from here until `resume()`. */
     suspend(): void;
-    /** The style was re-entered. */
+    /** The style was re-entered — re-push what the layer shows (nothing pushed while
+     *  suspended reached it). */
     resume(): void;
-    /** The chart is going away — release everything. */
+    /** The chart is going away, or the engine is being replaced — release everything.
+     *  Its host drops every push from here on. */
     stop(): void;
     /** The visible range changed (pan/zoom) while the style is active. */
     onViewport?(range: {

package/dist/{plugin-Cr2Pj8q8.d.ts → plugin-D5Z-Q6TX.d.ts}

@@ -1,9 +1,9 @@
-import { z as DrawingTypeKey, af as DrawingStyle, S as SerializedDrawing, D as Drawing, O as OHLCV, aY as SeriesKind, c as VelaTheme } from './options-lMUwmRwh.js';
-import { f as DataControl } from './contributions-HGqnNb_P.js';
+import { z as DrawingTypeKey, af as DrawingStyle, S as SerializedDrawing, D as Drawing, O as OHLCV, aY as SeriesKind, c as VelaTheme } from './options-BI5Tp32b.js';
+import { f as DataControl } from './contributions-P9fBBuY1.js';
 import './side-panel-_2UK1gSm.js';
 import './icons-BZYbJXSV.js';
 import './keymap-CGOz5F5f.js';
-import './DataProvider-oH78tYXL.js';
+import './DataProvider-BUdlkx9I.js';
 
 /** What a drawing type contributes to the toolbar + factory (renderer-neutral). */
 interface DrawingTypeMeta {
@@ -184,17 +184,23 @@ interface SeriesDataEngineHost {
 }
 /**
  * A per-chart data engine behind a chart type: created on first entry into the style,
- * suspended/resumed as the user switches styles, stopped when the chart is destroyed.
+ * suspended/resumed as the user switches styles, replaced by a fresh engine when the
+ * market or the replay state changes, stopped when the chart is destroyed.
  * All methods are fire-and-forget from the chart's point of view — the engine owns its
- * own scheduling and pushes results through the host channels.
+ * own scheduling and pushes results through the host channels. The host forwards pushes
+ * only from the chart's current, unsuspended engine: work still in flight when the
+ * engine is suspended or stopped never reaches the scene.
  */
 interface SeriesDataEngine {
     start(host: SeriesDataEngineHost): void;
-    /** The style was left — stop fetching/pushing, keep state for a cheap resume. */
+    /** The style was left, or a market switch began — stop fetching/pushing, keep state
+     *  for a cheap resume. Host pushes are dropped from here until `resume()`. */
     suspend(): void;
-    /** The style was re-entered. */
+    /** The style was re-entered — re-push what the layer shows (nothing pushed while
+     *  suspended reached it). */
     resume(): void;
-    /** The chart is going away — release everything. */
+    /** The chart is going away, or the engine is being replaced — release everything.
+     *  Its host drops every push from here on. */
     stop(): void;
     /** The visible range changed (pan/zoom) while the style is active. */
     onViewport?(range: {