@luxalgo/vela 0.6.21 → 0.7.0

package/dist/{options-BCRmYALw.d.cts → options-ex2_gtKp.d.cts}

@@ -495,6 +495,8 @@ interface IndicatorModel {
     native?: {
         type: string;
     };
+    /** `false` ⇒ no legend row and no pane listing for this indicator (host-owned chrome); absent ⇒ a row. */
+    legend?: boolean;
     /**
      * Value-axis override for the pane this indicator OWNS — declared by content that is
      * not value-mapped (e.g. a bespoke renderer layer painting in pixel bands), where a
@@ -626,6 +628,35 @@ type ScenePatch = ValuePatch | SchemaPatch;
 /** A function that detaches a previously-registered subscription. */
 type Unsubscribe = () => void;
 
+/**
+ * A once-per-second wall-clock pulse. Every subscriber receives the SAME `now` for a
+ * given second, so chrome that displays time (a bottom-bar clock, a countdown-to-bar-close
+ * chip) can be driven from one source and never disagrees about which second it is.
+ */
+interface WallClock {
+    /** Called shortly after every wall-clock second boundary with that instant (epoch ms). */
+    onTick(cb: (now: number) => void): Unsubscribe;
+}
+/**
+ * A {@link WallClock} aligned to the wall clock's second boundaries. Free-running
+ * `setInterval(1000)` timers start at an arbitrary sub-second phase and slide against
+ * each other, so two of them sample different seconds part of the time; this one
+ * re-arms a `setTimeout` to the NEXT boundary after every tick, so it fires just past
+ * `hh:mm:ss.000` regardless of when it was started or how long the callback took (a
+ * throttled background tab simply skips seconds — it never drifts). Runs only while it
+ * has subscribers: zero idle timers when nothing displays time.
+ */
+declare class SecondClock implements WallClock {
+    private readonly now;
+    private readonly subs;
+    private timer;
+    constructor(now?: () => number);
+    onTick(cb: (now: number) => void): Unsubscribe;
+    /** Milliseconds from `now` to just past the next second boundary. */
+    static delayToNextSecond(now: number): number;
+    private arm;
+}
+
 /**
  * Async series access for data-driven drawings — the ranged, any-timeframe sibling
  * of {@link Projector.barsInRange}. Painting stays synchronous: a read either serves
@@ -1164,6 +1195,103 @@ interface IDrawingsRendererPort {
     onDrawingIntent(cb: (intent: DrawingIntent) => void): Unsubscribe;
 }
 
+/** The built-in glyph outlines. */
+type MarkShape = 'circle' | 'square' | 'diamond' | 'pin';
+/**
+ * How a mark looks on the lane: a colored token carrying either a short letter or a
+ * registered icon (`registerIcon` from `vela/ui` — an id, never inline markup, so a mark
+ * payload can come from data without ever carrying SVG). `icon` wins over `letter`
+ * when both are given; the symbol's ink is auto-contrasted against `color`.
+ */
+interface MarkGlyph {
+    /** Token outline (default `'circle'`). */
+    shape?: MarkShape;
+    /** Token fill — any CSS color. */
+    color: string;
+    /** One or two characters drawn inside the token (`'D'`, `'E'`, `'!'`). */
+    letter?: string;
+    /** Icon id from the icon registry, drawn inside the token. */
+    icon?: string;
+}
+/** One row of a structured panel — the callout vocabulary plus a label/value field. */
+type MarkPanelItem = {
+    type: 'text';
+    text: string;
+} | {
+    type: 'field';
+    label: string;
+    value: string;
+} | {
+    type: 'button';
+    label: string;
+    /** Emphasized (selection-colored) button — the panel's main action. */
+    primary?: boolean;
+    /** Close the popup after `run` (default true). */
+    close?: boolean;
+    run(): void;
+};
+/**
+ * What the popup shows for one mark: plain text (escaped), HTML (sanitized through an
+ * allowlist — scripts, styles, frames, event handlers and `javascript:` URLs never
+ * reach the page), or a structured panel of rows and buttons.
+ */
+type MarkContent = {
+    text: string;
+} | {
+    html: string;
+} | {
+    panel: {
+        items: MarkPanelItem[];
+    };
+};
+/** A content value, or a thunk resolved when the popup needs it (details fetched on click). */
+type MarkContentSource = MarkContent | (() => MarkContent | Promise<MarkContent>);
+/** One timeline mark. */
+interface TimelineMark {
+    /** Stable id — re-adding an id replaces the mark. */
+    id: string;
+    /**
+     * The moment the mark belongs to, epoch-ms. The glyph never sits at this exact pixel:
+     * it centers on the bar whose span contains the time (a time falling in a gap — a
+     * weekend, a closed session — goes to the first bar that follows; one past the newest
+     * bar projects onto the extrapolated grid in the right whitespace).
+     */
+    time: Millis;
+    /** Popup heading — shown above the content whatever its form. */
+    title?: string;
+    glyph: MarkGlyph;
+    /** Hover text on the glyph. */
+    tooltip?: string;
+    /**
+     * The visibility group the mark belongs to (`'dividends'`, `'splits'`). Marks of one
+     * group that land on the same bar cluster into one glyph; groups get a checkbox each
+     * in the chart settings (the Events tab). Define the display label with
+     * `chart.marks.defineGroup`; an undefined group shows its capitalized id.
+     */
+    group?: string;
+    /** Popup content. Without it a click only emits `mark:click` — the host owns the UI. */
+    content?: MarkContentSource;
+}
+/** A visibility group's presentation (see {@link TimelineMark.group}). */
+interface MarkGroup {
+    id: string;
+    /** The settings checkbox label (`'Dividends'`). */
+    label: string;
+    /** Default visibility before the user toggles it (default true). A persisted choice wins. */
+    visible?: boolean;
+}
+/** The `mark:click` payload — every mark under the clicked glyph (a cluster lists them all). */
+interface MarkClickEvent {
+    /** The cluster's first mark (earliest time, then insertion order). */
+    id: string;
+    /** Every mark in the clicked cluster, in cluster order. */
+    ids: string[];
+    /** The first mark's time, epoch-ms. */
+    time: Millis;
+    /** The cluster's group, when its marks belong to one. */
+    group?: string;
+}
+
 /** What a rendering backend supports — drives graceful degradation + warnings. */
 interface RendererCapabilities {
     panes: boolean;
@@ -1194,6 +1322,10 @@ interface RendererCapabilities {
      *  ticks on the price pane, plus the `tradeMarkers` display feature. Absent/false ⇒ the
      *  channel is carried through mounts/patches but never painted. */
     trades?: boolean;
+    /** Timeline marks (`chart.marks`): host events pinned to a bar, painted as glyphs on a lane
+     *  above the time axis with a detail popup on click. Absent/false ⇒ the model still fills
+     *  (`chart.marks.all()`) but nothing paints. */
+    timelineMarks?: boolean;
     /** Whether the renderer provides the in-chart inputs/settings UI. */
     inputsUI: boolean;
 }
@@ -1398,6 +1530,15 @@ interface IChartRenderer {
      * layers omits it.
      */
     setNativeData?(type: string, data: unknown): void;
+    /**
+     * Replace the timeline marks + their group definitions (the `chart.marks` model). The
+     * renderer snaps each mark onto its bar, folds same-bar/same-group marks into clusters, and
+     * paints the lane above the time axis; group visibility is its own display state (the
+     * `marks` feature). Present iff `capabilities.timelineMarks`.
+     */
+    setTimelineMarks?(marks: readonly TimelineMark[], groups: readonly MarkGroup[]): void;
+    /** A timeline-mark glyph was clicked — every mark of its cluster is listed. Present iff `capabilities.timelineMarks`. */
+    onMarkClick?(cb: (e: MarkClickEvent) => void): Unsubscribe;
     /**
      * Reflect an indicator's live status in its legend row: `'loading'` (a fetch is in flight —
      * spinner), `'live'` (live-updating — a distinct pulse), or `'idle'` (nothing). Optional.
@@ -1624,6 +1765,13 @@ interface IChartRenderer {
      * pointer-first one. Optional — a renderer without adaptive chrome omits it.
      */
     setLayoutMode?(mode: 'mobile' | 'desktop'): void;
+    /**
+     * Drive the renderer's time-of-day displays (the countdown-to-bar-close chip) from the
+     * HOST's second pulse instead of the renderer's own, so they read the same second as
+     * the host's clock chrome. `null` restores the renderer's own pulse. Optional — a
+     * renderer without time-of-day chrome omits it.
+     */
+    setWallClock?(clock: WallClock | null): void;
     /**
      * Interactive user-drawings surface. Present iff `capabilities.userDrawings`.
      * The core `DrawingController` drives it (commands down) and listens for
@@ -1735,10 +1883,12 @@ interface VelaOptions extends MarketConfig {
      *  or force `'canvas2d'` / `'webgl2'`. Native renderer only. */
     nativeBackend?: NativeBackend;
     /** Native-renderer animations. `true`/`false` toggles all; an object configures
-     *  each independently. Default: eased **zoom on**, inertial **pan on but snappy**
-     *  (short glide), live-bar glide **off**. Set `{ pan: false }` for an instant pan
-     *  with no momentum, `{ liveBar: true }` (or a duration in ms) to make the forming
-     *  candle slide toward each live tick instead of snapping. */
+     *  each motion independently — on/off, or its ease duration in ms. Default: eased
+     *  **zoom on**, inertial **pan on but snappy** (short glide), gliding **autoscale
+     *  on**, first-paint **reveal on**, live-bar glide **off**. Set `{ pan: false }` for an
+     *  instant pan with no momentum, `{ zoom: 150 }` for a slower zoom glide,
+     *  `{ liveBar: true }` (or a duration in ms) to make the forming candle slide toward
+     *  each live tick instead of snapping, `{ intro: false }` to skip the reveal. */
     animations?: boolean | AnimationConfig;
     /** Neon glow/bloom intensity for line series (0 = off, ~0.6 = strong). WebGL2 only
      *  — the canvas2d backend ignores it. Default 0. */
@@ -1773,12 +1923,29 @@ interface SettingsVisibilityPolicy {
     /** Setting ids to hide — a tab, a group, or a row; an id hides its subtree. */
     hidden?: readonly string[];
 }
-/** Per-feature native-renderer animation toggles. */
+/**
+ * Per-feature native-renderer animation settings. Every eased motion takes
+ * `boolean | number`: `false`/`0` = off (the motion is instant), `true` = the built-in
+ * duration, a number = its ease time-constant in ms — the motion covers ~63% of the
+ * remaining distance per time-constant and is visually settled after about three of
+ * them (clamped to {@link ANIMATION_EASE_MAX_MS}).
+ */
 interface AnimationConfig {
-    /** Eased cursor-anchored wheel-zoom (+ gliding autoscale while zooming). Default true. */
-    zoom?: boolean;
-    /** Inertial/kinetic pan — a short snappy glide after a drag-release. Default true. */
-    pan?: boolean;
+    /** Eased cursor-anchored wheel-zoom: the bar spacing glides toward each wheel notch's
+     *  target instead of jumping. Default `true` ({@link ZOOM_EASE_DEFAULT_MS}). */
+    zoom?: boolean | number;
+    /** Inertial/kinetic pan — the velocity a drag releases with decays over this
+     *  time-constant (a short, snappy glide by default; `false` stops dead). Default
+     *  `true` ({@link PAN_INERTIA_DEFAULT_MS}). */
+    pan?: boolean | number;
+    /** The programmatic scroll glide — the scroll-to-latest button, `chart.panBy`, the
+     *  keyboard pan keys — easing the view toward its target at constant zoom. Default:
+     *  follows `pan` on/off, at {@link SCROLL_EASE_DEFAULT_MS} when on. */
+    scroll?: boolean | number;
+    /** Autoscale glide: while a zoom or fling is in flight the price scale eases toward
+     *  its new window instead of snapping every frame. Default `true`
+     *  ({@link AUTOSCALE_EASE_DEFAULT_MS}). */
+    autoscale?: boolean | number;
     /** Glide of the forming bar: on a live tick the displayed high/low/close ease toward
      *  the new values instead of snapping (the price line and axis label follow). `true`
      *  uses the default duration ({@link LIVE_BAR_EASE_DEFAULT_MS}); a number is the ease
@@ -1786,6 +1953,24 @@ interface AnimationConfig {
      *  {@link LIVE_BAR_EASE_MAX_MS}); `false`/`0` snaps. A new bar always snaps. Default
      *  `false` — the painted candle is then never behind the real data. */
     liveBar?: boolean | number;
+    /** The first-paint reveal: candles draw themselves in, left to right, when they first
+     *  appear. `true` = the default `'settle'` style (an overshoot that eases back);
+     *  `'grow'` = a plain ease-out; `false` = no reveal; an object picks the style and/or
+     *  the `duration` of the whole sweep in ms (default {@link INTRO_DURATION_DEFAULT_MS};
+     *  clamped to {@link INTRO_DURATION_MAX_MS}). Default `true`. */
+    intro?: boolean | IntroStyle | IntroConfig;
+}
+/** The first-paint reveal styles: `settle` overshoots and eases back, `grow` eases out. */
+type IntroStyle = 'settle' | 'grow';
+/** Object form of `animations.intro` — style and/or sweep duration (ms). */
+interface IntroConfig {
+    style?: IntroStyle;
+    duration?: number;
+}
+/** A resolved `animations.intro`: `style: false` = no reveal. */
+interface IntroAnimation {
+    style: IntroStyle | false;
+    duration: number;
 }
 /** Native geometry-layer backend selection. */
 type NativeBackend = 'auto' | 'canvas2d' | 'webgl2';
@@ -1803,9 +1988,12 @@ interface RendererDisplayOptions {
     currentPriceLine: boolean;
     logScale: boolean;
     nativeBackend: NativeBackend;
-    animZoom: boolean;
-    animPan: boolean;
+    animZoom: number;
+    animPan: number;
+    animScroll: number;
+    animAutoscale: number;
     animLiveBar: number;
+    animIntro: IntroAnimation;
     glow: number;
     upColor: string;
     downColor: string;
@@ -1860,4 +2048,4 @@ interface AddIndicatorOptions {
     title?: string;
 }
 
-export { type DrawingExtend as $, type AxisLongPressEvent as A, type Background as B, type CrosshairEvent as C, Drawing as D, type BoxFontFamily as E, type BoxHAlign as F, type BoxTextSize as G, type BoxVAlign as H, type InputValue as I, type CandleBarColor as J, type CandleSeries as K, type LineStyle as L, type MarketConfig as M, type NativeBackend as N, type OHLCV as O, type PriceStyle as P, type CandleStyle as Q, type RendererCapabilities as R, type SerializedDrawing as S, type ThemeName as T, type Unsubscribe as U, type VisibleRangePreset as V, type DataWindowGroup as W, type DataWindowOHLC as X, type DataWindowRow as Y, type DirtyRange as Z, type DrawingBox as _, type VisibleRange as a, type DrawingIntent as a0, type DrawingLabel as a1, type DrawingLine as a2, type DrawingLinefill as a3, type DrawingMode as a4, type DrawingPoint as a5, type DrawingPolyline as a6, type DrawingSeriesBar as a7, type DrawingSeriesGateway as a8, type DrawingSeriesState as a9, type PriceLine as aA, type Projector as aB, type ProviderName as aC, type RendererConstructor as aD, type Scene as aE, type SchemaPatch as aF, type SeriesKind as aG, type SeriesPoint as aH, type SeriesSpec as aI, type SeriesValueDelta as aJ, type SettingsField as aK, type SettingsSchema as aL, type SettingsVisibilityPolicy as aM, type TableCell as aN, type TableMerge as aO, type TablePosition as aP, type ToolbarGroupConfig as aQ, type TradeExecution as aR, type ValuePatch as aS, buildToolbar as aT, defaultToolbar as aU, inputDeltas as aV, inputVisible as aW, type PaneInfo as aX, type DrawingStyle as aa, type DrawingTable as ab, type DrawingText as ac, type DrawingXLoc as ad, type DrawingsOption as ae, type Fill as af, type FillGradientStop as ag, type IndicatorMeta as ah, type InputCondition as ai, type InputSchema as aj, type InputType as ak, type InputWhen as al, type LabelStyle as am, type LabelYLoc as an, type LineLikeKind as ao, type LineLikeSeries as ap, type LineLikeStyle as aq, type MarkerPoint as ar, type MarkerSeries as as, type MarketSnapshot as at, type MarketSwitch as au, type PaneAxis as av, type PaneAxisBand as aw, type PaneHint as ax, type PaneKind as ay, type PolylinePoint as az, type VelaOptions as b, 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 DataWindowReadout as s, type IDrawingsRendererPort as t, type Millis as u, type SnapMode as v, type DrawingTypeKey as w, type ToolbarDefinition as x, type AddIndicatorOptions as y, type AnimationConfig as z };
+export { type DataWindowOHLC as $, type AxisLongPressEvent as A, type ToolbarDefinition as B, type CrosshairEvent as C, Drawing as D, type AddIndicatorOptions as E, type AnimationConfig as F, type Background as G, type BoxFontFamily as H, type InputValue as I, type BoxHAlign as J, type BoxTextSize as K, type LineStyle as L, type MarketConfig as M, type NativeBackend as N, type OHLCV as O, type PriceStyle as P, type BoxVAlign 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 CandleBarColor as X, type CandleSeries as Y, type CandleStyle as Z, type DataWindowGroup as _, type VisibleRange as a, type TableMerge as a$, type DataWindowRow as a0, type DirtyRange as a1, type DrawingBox as a2, type DrawingExtend as a3, type DrawingIntent as a4, type DrawingLabel as a5, type DrawingLine as a6, type DrawingLinefill as a7, type DrawingMode as a8, type DrawingPoint as a9, type MarkGlyph as aA, type MarkPanelItem as aB, type MarkShape as aC, type MarkerPoint as aD, type MarkerSeries as aE, type MarketSnapshot 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 PriceLine as aM, type Projector as aN, type ProviderName as aO, type RendererConstructor as aP, type Scene as aQ, type SchemaPatch as aR, SecondClock as aS, type SeriesKind as aT, type SeriesPoint as aU, type SeriesSpec as aV, type SeriesValueDelta as aW, type SettingsField as aX, type SettingsSchema as aY, type SettingsVisibilityPolicy as aZ, type TableCell as a_, type DrawingPolyline as aa, type DrawingSeriesBar as ab, type DrawingSeriesGateway as ac, type DrawingSeriesState as ad, type DrawingStyle as ae, type DrawingTable as af, type DrawingText as ag, type DrawingXLoc as ah, type DrawingsOption as ai, type Fill as aj, type FillGradientStop as ak, type IndicatorMeta as al, type InputCondition as am, type InputSchema as an, type InputType as ao, type InputWhen as ap, type IntroAnimation as aq, type IntroConfig as ar, type IntroStyle as as, type LabelStyle as at, type LabelYLoc as au, type LineLikeKind as av, type LineLikeSeries as aw, type LineLikeStyle as ax, type MarkContent as ay, type MarkContentSource as az, type VelaOptions as b, type TablePosition as b0, type ToolbarGroupConfig as b1, type TradeExecution as b2, type ValuePatch as b3, buildToolbar as b4, defaultToolbar as b5, inputDeltas as b6, inputVisible as b7, type PaneInfo as b8, 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/{options-BCRmYALw.d.ts → options-ex2_gtKp.d.ts}

@@ -495,6 +495,8 @@ interface IndicatorModel {
     native?: {
         type: string;
     };
+    /** `false` ⇒ no legend row and no pane listing for this indicator (host-owned chrome); absent ⇒ a row. */
+    legend?: boolean;
     /**
      * Value-axis override for the pane this indicator OWNS — declared by content that is
      * not value-mapped (e.g. a bespoke renderer layer painting in pixel bands), where a
@@ -626,6 +628,35 @@ type ScenePatch = ValuePatch | SchemaPatch;
 /** A function that detaches a previously-registered subscription. */
 type Unsubscribe = () => void;
 
+/**
+ * A once-per-second wall-clock pulse. Every subscriber receives the SAME `now` for a
+ * given second, so chrome that displays time (a bottom-bar clock, a countdown-to-bar-close
+ * chip) can be driven from one source and never disagrees about which second it is.
+ */
+interface WallClock {
+    /** Called shortly after every wall-clock second boundary with that instant (epoch ms). */
+    onTick(cb: (now: number) => void): Unsubscribe;
+}
+/**
+ * A {@link WallClock} aligned to the wall clock's second boundaries. Free-running
+ * `setInterval(1000)` timers start at an arbitrary sub-second phase and slide against
+ * each other, so two of them sample different seconds part of the time; this one
+ * re-arms a `setTimeout` to the NEXT boundary after every tick, so it fires just past
+ * `hh:mm:ss.000` regardless of when it was started or how long the callback took (a
+ * throttled background tab simply skips seconds — it never drifts). Runs only while it
+ * has subscribers: zero idle timers when nothing displays time.
+ */
+declare class SecondClock implements WallClock {
+    private readonly now;
+    private readonly subs;
+    private timer;
+    constructor(now?: () => number);
+    onTick(cb: (now: number) => void): Unsubscribe;
+    /** Milliseconds from `now` to just past the next second boundary. */
+    static delayToNextSecond(now: number): number;
+    private arm;
+}
+
 /**
  * Async series access for data-driven drawings — the ranged, any-timeframe sibling
  * of {@link Projector.barsInRange}. Painting stays synchronous: a read either serves
@@ -1164,6 +1195,103 @@ interface IDrawingsRendererPort {
     onDrawingIntent(cb: (intent: DrawingIntent) => void): Unsubscribe;
 }
 
+/** The built-in glyph outlines. */
+type MarkShape = 'circle' | 'square' | 'diamond' | 'pin';
+/**
+ * How a mark looks on the lane: a colored token carrying either a short letter or a
+ * registered icon (`registerIcon` from `vela/ui` — an id, never inline markup, so a mark
+ * payload can come from data without ever carrying SVG). `icon` wins over `letter`
+ * when both are given; the symbol's ink is auto-contrasted against `color`.
+ */
+interface MarkGlyph {
+    /** Token outline (default `'circle'`). */
+    shape?: MarkShape;
+    /** Token fill — any CSS color. */
+    color: string;
+    /** One or two characters drawn inside the token (`'D'`, `'E'`, `'!'`). */
+    letter?: string;
+    /** Icon id from the icon registry, drawn inside the token. */
+    icon?: string;
+}
+/** One row of a structured panel — the callout vocabulary plus a label/value field. */
+type MarkPanelItem = {
+    type: 'text';
+    text: string;
+} | {
+    type: 'field';
+    label: string;
+    value: string;
+} | {
+    type: 'button';
+    label: string;
+    /** Emphasized (selection-colored) button — the panel's main action. */
+    primary?: boolean;
+    /** Close the popup after `run` (default true). */
+    close?: boolean;
+    run(): void;
+};
+/**
+ * What the popup shows for one mark: plain text (escaped), HTML (sanitized through an
+ * allowlist — scripts, styles, frames, event handlers and `javascript:` URLs never
+ * reach the page), or a structured panel of rows and buttons.
+ */
+type MarkContent = {
+    text: string;
+} | {
+    html: string;
+} | {
+    panel: {
+        items: MarkPanelItem[];
+    };
+};
+/** A content value, or a thunk resolved when the popup needs it (details fetched on click). */
+type MarkContentSource = MarkContent | (() => MarkContent | Promise<MarkContent>);
+/** One timeline mark. */
+interface TimelineMark {
+    /** Stable id — re-adding an id replaces the mark. */
+    id: string;
+    /**
+     * The moment the mark belongs to, epoch-ms. The glyph never sits at this exact pixel:
+     * it centers on the bar whose span contains the time (a time falling in a gap — a
+     * weekend, a closed session — goes to the first bar that follows; one past the newest
+     * bar projects onto the extrapolated grid in the right whitespace).
+     */
+    time: Millis;
+    /** Popup heading — shown above the content whatever its form. */
+    title?: string;
+    glyph: MarkGlyph;
+    /** Hover text on the glyph. */
+    tooltip?: string;
+    /**
+     * The visibility group the mark belongs to (`'dividends'`, `'splits'`). Marks of one
+     * group that land on the same bar cluster into one glyph; groups get a checkbox each
+     * in the chart settings (the Events tab). Define the display label with
+     * `chart.marks.defineGroup`; an undefined group shows its capitalized id.
+     */
+    group?: string;
+    /** Popup content. Without it a click only emits `mark:click` — the host owns the UI. */
+    content?: MarkContentSource;
+}
+/** A visibility group's presentation (see {@link TimelineMark.group}). */
+interface MarkGroup {
+    id: string;
+    /** The settings checkbox label (`'Dividends'`). */
+    label: string;
+    /** Default visibility before the user toggles it (default true). A persisted choice wins. */
+    visible?: boolean;
+}
+/** The `mark:click` payload — every mark under the clicked glyph (a cluster lists them all). */
+interface MarkClickEvent {
+    /** The cluster's first mark (earliest time, then insertion order). */
+    id: string;
+    /** Every mark in the clicked cluster, in cluster order. */
+    ids: string[];
+    /** The first mark's time, epoch-ms. */
+    time: Millis;
+    /** The cluster's group, when its marks belong to one. */
+    group?: string;
+}
+
 /** What a rendering backend supports — drives graceful degradation + warnings. */
 interface RendererCapabilities {
     panes: boolean;
@@ -1194,6 +1322,10 @@ interface RendererCapabilities {
      *  ticks on the price pane, plus the `tradeMarkers` display feature. Absent/false ⇒ the
      *  channel is carried through mounts/patches but never painted. */
     trades?: boolean;
+    /** Timeline marks (`chart.marks`): host events pinned to a bar, painted as glyphs on a lane
+     *  above the time axis with a detail popup on click. Absent/false ⇒ the model still fills
+     *  (`chart.marks.all()`) but nothing paints. */
+    timelineMarks?: boolean;
     /** Whether the renderer provides the in-chart inputs/settings UI. */
     inputsUI: boolean;
 }
@@ -1398,6 +1530,15 @@ interface IChartRenderer {
      * layers omits it.
      */
     setNativeData?(type: string, data: unknown): void;
+    /**
+     * Replace the timeline marks + their group definitions (the `chart.marks` model). The
+     * renderer snaps each mark onto its bar, folds same-bar/same-group marks into clusters, and
+     * paints the lane above the time axis; group visibility is its own display state (the
+     * `marks` feature). Present iff `capabilities.timelineMarks`.
+     */
+    setTimelineMarks?(marks: readonly TimelineMark[], groups: readonly MarkGroup[]): void;
+    /** A timeline-mark glyph was clicked — every mark of its cluster is listed. Present iff `capabilities.timelineMarks`. */
+    onMarkClick?(cb: (e: MarkClickEvent) => void): Unsubscribe;
     /**
      * Reflect an indicator's live status in its legend row: `'loading'` (a fetch is in flight —
      * spinner), `'live'` (live-updating — a distinct pulse), or `'idle'` (nothing). Optional.
@@ -1624,6 +1765,13 @@ interface IChartRenderer {
      * pointer-first one. Optional — a renderer without adaptive chrome omits it.
      */
     setLayoutMode?(mode: 'mobile' | 'desktop'): void;
+    /**
+     * Drive the renderer's time-of-day displays (the countdown-to-bar-close chip) from the
+     * HOST's second pulse instead of the renderer's own, so they read the same second as
+     * the host's clock chrome. `null` restores the renderer's own pulse. Optional — a
+     * renderer without time-of-day chrome omits it.
+     */
+    setWallClock?(clock: WallClock | null): void;
     /**
      * Interactive user-drawings surface. Present iff `capabilities.userDrawings`.
      * The core `DrawingController` drives it (commands down) and listens for
@@ -1735,10 +1883,12 @@ interface VelaOptions extends MarketConfig {
      *  or force `'canvas2d'` / `'webgl2'`. Native renderer only. */
     nativeBackend?: NativeBackend;
     /** Native-renderer animations. `true`/`false` toggles all; an object configures
-     *  each independently. Default: eased **zoom on**, inertial **pan on but snappy**
-     *  (short glide), live-bar glide **off**. Set `{ pan: false }` for an instant pan
-     *  with no momentum, `{ liveBar: true }` (or a duration in ms) to make the forming
-     *  candle slide toward each live tick instead of snapping. */
+     *  each motion independently — on/off, or its ease duration in ms. Default: eased
+     *  **zoom on**, inertial **pan on but snappy** (short glide), gliding **autoscale
+     *  on**, first-paint **reveal on**, live-bar glide **off**. Set `{ pan: false }` for an
+     *  instant pan with no momentum, `{ zoom: 150 }` for a slower zoom glide,
+     *  `{ liveBar: true }` (or a duration in ms) to make the forming candle slide toward
+     *  each live tick instead of snapping, `{ intro: false }` to skip the reveal. */
     animations?: boolean | AnimationConfig;
     /** Neon glow/bloom intensity for line series (0 = off, ~0.6 = strong). WebGL2 only
      *  — the canvas2d backend ignores it. Default 0. */
@@ -1773,12 +1923,29 @@ interface SettingsVisibilityPolicy {
     /** Setting ids to hide — a tab, a group, or a row; an id hides its subtree. */
     hidden?: readonly string[];
 }
-/** Per-feature native-renderer animation toggles. */
+/**
+ * Per-feature native-renderer animation settings. Every eased motion takes
+ * `boolean | number`: `false`/`0` = off (the motion is instant), `true` = the built-in
+ * duration, a number = its ease time-constant in ms — the motion covers ~63% of the
+ * remaining distance per time-constant and is visually settled after about three of
+ * them (clamped to {@link ANIMATION_EASE_MAX_MS}).
+ */
 interface AnimationConfig {
-    /** Eased cursor-anchored wheel-zoom (+ gliding autoscale while zooming). Default true. */
-    zoom?: boolean;
-    /** Inertial/kinetic pan — a short snappy glide after a drag-release. Default true. */
-    pan?: boolean;
+    /** Eased cursor-anchored wheel-zoom: the bar spacing glides toward each wheel notch's
+     *  target instead of jumping. Default `true` ({@link ZOOM_EASE_DEFAULT_MS}). */
+    zoom?: boolean | number;
+    /** Inertial/kinetic pan — the velocity a drag releases with decays over this
+     *  time-constant (a short, snappy glide by default; `false` stops dead). Default
+     *  `true` ({@link PAN_INERTIA_DEFAULT_MS}). */
+    pan?: boolean | number;
+    /** The programmatic scroll glide — the scroll-to-latest button, `chart.panBy`, the
+     *  keyboard pan keys — easing the view toward its target at constant zoom. Default:
+     *  follows `pan` on/off, at {@link SCROLL_EASE_DEFAULT_MS} when on. */
+    scroll?: boolean | number;
+    /** Autoscale glide: while a zoom or fling is in flight the price scale eases toward
+     *  its new window instead of snapping every frame. Default `true`
+     *  ({@link AUTOSCALE_EASE_DEFAULT_MS}). */
+    autoscale?: boolean | number;
     /** Glide of the forming bar: on a live tick the displayed high/low/close ease toward
      *  the new values instead of snapping (the price line and axis label follow). `true`
      *  uses the default duration ({@link LIVE_BAR_EASE_DEFAULT_MS}); a number is the ease
@@ -1786,6 +1953,24 @@ interface AnimationConfig {
      *  {@link LIVE_BAR_EASE_MAX_MS}); `false`/`0` snaps. A new bar always snaps. Default
      *  `false` — the painted candle is then never behind the real data. */
     liveBar?: boolean | number;
+    /** The first-paint reveal: candles draw themselves in, left to right, when they first
+     *  appear. `true` = the default `'settle'` style (an overshoot that eases back);
+     *  `'grow'` = a plain ease-out; `false` = no reveal; an object picks the style and/or
+     *  the `duration` of the whole sweep in ms (default {@link INTRO_DURATION_DEFAULT_MS};
+     *  clamped to {@link INTRO_DURATION_MAX_MS}). Default `true`. */
+    intro?: boolean | IntroStyle | IntroConfig;
+}
+/** The first-paint reveal styles: `settle` overshoots and eases back, `grow` eases out. */
+type IntroStyle = 'settle' | 'grow';
+/** Object form of `animations.intro` — style and/or sweep duration (ms). */
+interface IntroConfig {
+    style?: IntroStyle;
+    duration?: number;
+}
+/** A resolved `animations.intro`: `style: false` = no reveal. */
+interface IntroAnimation {
+    style: IntroStyle | false;
+    duration: number;
 }
 /** Native geometry-layer backend selection. */
 type NativeBackend = 'auto' | 'canvas2d' | 'webgl2';
@@ -1803,9 +1988,12 @@ interface RendererDisplayOptions {
     currentPriceLine: boolean;
     logScale: boolean;
     nativeBackend: NativeBackend;
-    animZoom: boolean;
-    animPan: boolean;
+    animZoom: number;
+    animPan: number;
+    animScroll: number;
+    animAutoscale: number;
     animLiveBar: number;
+    animIntro: IntroAnimation;
     glow: number;
     upColor: string;
     downColor: string;
@@ -1860,4 +2048,4 @@ interface AddIndicatorOptions {
     title?: string;
 }
 
-export { type DrawingExtend as $, type AxisLongPressEvent as A, type Background as B, type CrosshairEvent as C, Drawing as D, type BoxFontFamily as E, type BoxHAlign as F, type BoxTextSize as G, type BoxVAlign as H, type InputValue as I, type CandleBarColor as J, type CandleSeries as K, type LineStyle as L, type MarketConfig as M, type NativeBackend as N, type OHLCV as O, type PriceStyle as P, type CandleStyle as Q, type RendererCapabilities as R, type SerializedDrawing as S, type ThemeName as T, type Unsubscribe as U, type VisibleRangePreset as V, type DataWindowGroup as W, type DataWindowOHLC as X, type DataWindowRow as Y, type DirtyRange as Z, type DrawingBox as _, type VisibleRange as a, type DrawingIntent as a0, type DrawingLabel as a1, type DrawingLine as a2, type DrawingLinefill as a3, type DrawingMode as a4, type DrawingPoint as a5, type DrawingPolyline as a6, type DrawingSeriesBar as a7, type DrawingSeriesGateway as a8, type DrawingSeriesState as a9, type PriceLine as aA, type Projector as aB, type ProviderName as aC, type RendererConstructor as aD, type Scene as aE, type SchemaPatch as aF, type SeriesKind as aG, type SeriesPoint as aH, type SeriesSpec as aI, type SeriesValueDelta as aJ, type SettingsField as aK, type SettingsSchema as aL, type SettingsVisibilityPolicy as aM, type TableCell as aN, type TableMerge as aO, type TablePosition as aP, type ToolbarGroupConfig as aQ, type TradeExecution as aR, type ValuePatch as aS, buildToolbar as aT, defaultToolbar as aU, inputDeltas as aV, inputVisible as aW, type PaneInfo as aX, type DrawingStyle as aa, type DrawingTable as ab, type DrawingText as ac, type DrawingXLoc as ad, type DrawingsOption as ae, type Fill as af, type FillGradientStop as ag, type IndicatorMeta as ah, type InputCondition as ai, type InputSchema as aj, type InputType as ak, type InputWhen as al, type LabelStyle as am, type LabelYLoc as an, type LineLikeKind as ao, type LineLikeSeries as ap, type LineLikeStyle as aq, type MarkerPoint as ar, type MarkerSeries as as, type MarketSnapshot as at, type MarketSwitch as au, type PaneAxis as av, type PaneAxisBand as aw, type PaneHint as ax, type PaneKind as ay, type PolylinePoint as az, type VelaOptions as b, 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 DataWindowReadout as s, type IDrawingsRendererPort as t, type Millis as u, type SnapMode as v, type DrawingTypeKey as w, type ToolbarDefinition as x, type AddIndicatorOptions as y, type AnimationConfig as z };
+export { type DataWindowOHLC as $, type AxisLongPressEvent as A, type ToolbarDefinition as B, type CrosshairEvent as C, Drawing as D, type AddIndicatorOptions as E, type AnimationConfig as F, type Background as G, type BoxFontFamily as H, type InputValue as I, type BoxHAlign as J, type BoxTextSize as K, type LineStyle as L, type MarketConfig as M, type NativeBackend as N, type OHLCV as O, type PriceStyle as P, type BoxVAlign 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 CandleBarColor as X, type CandleSeries as Y, type CandleStyle as Z, type DataWindowGroup as _, type VisibleRange as a, type TableMerge as a$, type DataWindowRow as a0, type DirtyRange as a1, type DrawingBox as a2, type DrawingExtend as a3, type DrawingIntent as a4, type DrawingLabel as a5, type DrawingLine as a6, type DrawingLinefill as a7, type DrawingMode as a8, type DrawingPoint as a9, type MarkGlyph as aA, type MarkPanelItem as aB, type MarkShape as aC, type MarkerPoint as aD, type MarkerSeries as aE, type MarketSnapshot 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 PriceLine as aM, type Projector as aN, type ProviderName as aO, type RendererConstructor as aP, type Scene as aQ, type SchemaPatch as aR, SecondClock as aS, type SeriesKind as aT, type SeriesPoint as aU, type SeriesSpec as aV, type SeriesValueDelta as aW, type SettingsField as aX, type SettingsSchema as aY, type SettingsVisibilityPolicy as aZ, type TableCell as a_, type DrawingPolyline as aa, type DrawingSeriesBar as ab, type DrawingSeriesGateway as ac, type DrawingSeriesState as ad, type DrawingStyle as ae, type DrawingTable as af, type DrawingText as ag, type DrawingXLoc as ah, type DrawingsOption as ai, type Fill as aj, type FillGradientStop as ak, type IndicatorMeta as al, type InputCondition as am, type InputSchema as an, type InputType as ao, type InputWhen as ap, type IntroAnimation as aq, type IntroConfig as ar, type IntroStyle as as, type LabelStyle as at, type LabelYLoc as au, type LineLikeKind as av, type LineLikeSeries as aw, type LineLikeStyle as ax, type MarkContent as ay, type MarkContentSource as az, type VelaOptions as b, type TablePosition as b0, type ToolbarGroupConfig as b1, type TradeExecution as b2, type ValuePatch as b3, buildToolbar as b4, defaultToolbar as b5, inputDeltas as b6, inputVisible as b7, type PaneInfo as b8, 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-B4mnNAeh.d.ts → plugin-CiyhU7pi.d.ts}

@@ -1,9 +1,9 @@
-import { w as DrawingTypeKey, aa as DrawingStyle, S as SerializedDrawing, D as Drawing, aG as SeriesKind, O as OHLCV, c as VelaTheme } from './options-BCRmYALw.js';
-import { c as DataControl } from './contributions-FqIWhN4p.js';
+import { z as DrawingTypeKey, ae as DrawingStyle, S as SerializedDrawing, D as Drawing, aT as SeriesKind, O as OHLCV, c as VelaTheme } from './options-ex2_gtKp.js';
+import { c as DataControl } from './contributions-BjQ7hyIx.js';
 import './side-panel-HF0IAzwf.js';
 import './icons-BZYbJXSV.js';
 import './keymap-CGOz5F5f.js';
-import './DataProvider-Cb-2lC5O.js';
+import './DataProvider-Bu9E5Zh5.js';
 
 /** What a drawing type contributes to the toolbar + factory (renderer-neutral). */
 interface DrawingTypeMeta {

package/dist/{plugin-Ccupy_BV.d.cts → plugin-absNH7Yn.d.cts}

@@ -1,9 +1,9 @@
-import { w as DrawingTypeKey, aa as DrawingStyle, S as SerializedDrawing, D as Drawing, aG as SeriesKind, O as OHLCV, c as VelaTheme } from './options-BCRmYALw.cjs';
-import { c as DataControl } from './contributions-D8HdlKmp.cjs';
+import { z as DrawingTypeKey, ae as DrawingStyle, S as SerializedDrawing, D as Drawing, aT as SeriesKind, O as OHLCV, c as VelaTheme } from './options-ex2_gtKp.cjs';
+import { c as DataControl } from './contributions-Cv2Mutvn.cjs';
 import './side-panel-HF0IAzwf.cjs';
 import './icons-BZYbJXSV.cjs';
 import './keymap-CGOz5F5f.cjs';
-import './DataProvider-UtWw2CgJ.cjs';
+import './DataProvider-Ck2qyS_9.cjs';
 
 /** What a drawing type contributes to the toolbar + factory (renderer-neutral). */
 interface DrawingTypeMeta {