@luxalgo/vela 0.8.2 → 0.8.4

package/dist/{options-NAUHiQEC.d.cts → options-CSXbjMM5.d.ts}

@@ -613,6 +613,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 +854,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 +869,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 +898,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 +919,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 +947,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 +967,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 +1109,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 +1182,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 +1243,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. */
@@ -1694,6 +1754,15 @@ interface IChartRenderer {
      * a renderer without runtime style switching omits it.
      */
     onPriceStyleChange?(cb: (style: PriceStyle) => void): Unsubscribe;
+    /**
+     * The renderer tells core that the base price style is ABOUT to change, `from` → `to`
+     * — the same sources as {@link onPriceStyleChange} (one runtime write path), called
+     * synchronously before the renderer touches its scene, so the chart still paints
+     * `from` while the callback runs. Never called for the constructed style or for a
+     * write of the style already shown. Callbacks must not change the style themselves.
+     * Optional — a renderer without runtime style switching omits it.
+     */
+    onPriceStyleWillChange?(cb: (from: PriceStyle, to: PriceStyle) => void): Unsubscribe;
     /** The renderer tells core when the user edits an input in-chart. */
     onInputChange(cb: (e: InputChangeEvent) => void): Unsubscribe;
     /** The renderer tells core when the user removes an indicator in-chart (the legend ✕). */
@@ -1967,7 +2036,61 @@ interface VelaOptions extends MarketConfig {
      *  chart with `chart.renderer.listSettingsIds()`; the catalog is documented in
      *  docs/user/options.md. */
     settings?: SettingsVisibilityPolicy;
+    /** Price-axis customization (native renderer): `ticks` replaces the built-in tick
+     *  ladder of every pane's price axis — labels and horizontal gridlines together. */
+    priceAxis?: PriceAxisOptions;
+}
+/** Price-axis customization (see `VelaOptions.priceAxis`). */
+interface PriceAxisOptions {
+    /** Supplies the ticks of each pane's price axis — the labels and the horizontal
+     *  gridlines both follow them. Called per pane when the pane's range, size or mode
+     *  changes. Returning `null`/`undefined` keeps the built-in ticks. Seeds the native
+     *  renderer's runtime `priceAxisTicks` feature; `null` (the default) = built-in ticks. */
+    ticks?: PriceAxisTicksFn | null;
+}
+/** One price-axis tick: a gridline at `price` and its axis label. */
+interface PriceAxisTick {
+    /** Where the tick sits, in prices (also in percent/indexed mode). */
+    price: number;
+    /** The axis label, drawn as given. */
+    label: string;
+    /** true = emphasized (semibold), false = de-emphasized (muted), omitted = the regular label. */
+    major?: boolean;
 }
+/** What a {@link PriceAxisTicksFn} receives for one pane. */
+interface PriceAxisTickContext {
+    /** The pane whose axis is being built. */
+    pane: {
+        id: string;
+        kind: 'price' | 'study';
+    };
+    /** The pane's visible value range, in prices (also in percent/indexed mode). */
+    min: number;
+    /** Upper end of the visible range, in prices. */
+    max: number;
+    /** Whether the pane's scale is logarithmic. */
+    log: boolean;
+    /** Pane height in CSS px. */
+    height: number;
+    /** The mode the axis labels render in this frame. */
+    mode: 'price' | 'percent' | 'indexed';
+    /** The percent/indexed baseline price (undefined in price mode). */
+    baseline?: number;
+    /** The symbol's tick size, when known. */
+    mintick?: number;
+    /** The axis font size in px. */
+    fontSize: number;
+    /** A price's pane-relative y in CSS px (honours log and inverted scales). */
+    priceToY(price: number): number;
+    /** Vela's own ticks for this frame — return them, or a filtered/extended copy, to build on the default. */
+    defaults: readonly PriceAxisTick[];
+}
+/**
+ * Builds a pane's price-axis ticks. Return the ticks to draw (an empty array draws none),
+ * or `null`/`undefined` to keep the built-in ones. Entries with a non-finite `price` or a
+ * non-string `label` are dropped; a function that throws falls back to the built-in ticks.
+ */
+type PriceAxisTicksFn = (ctx: PriceAxisTickContext) => readonly PriceAxisTick[] | null | undefined;
 /** Settings-dialog visibility policy (see `VelaOptions.settings`). */
 interface SettingsVisibilityPolicy {
     /** Setting ids to hide — a tab, a group, or a row; an id hides its subtree. */
@@ -2048,6 +2171,8 @@ interface RendererDisplayOptions {
     upColor: string;
     downColor: string;
     priceStyle: PriceStyle;
+    /** Host price-axis ticks (`VelaOptions.priceAxis.ticks`); absent/null = built-in ticks. */
+    priceAxisTicks?: PriceAxisTicksFn | null;
 }
 /**
  * Where to move an indicator (via `handle.moveTo(...)`):
@@ -2108,4 +2233,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 SettingsVisibilityPolicy 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 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 SeriesDisplay as aT, type SeriesKind as aU, type SeriesPoint as aV, type SeriesSpec as aW, type SeriesSurface as aX, type SeriesValueDelta as aY, type SettingsField as aZ, type SettingsSchema 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 TableCell as b0, type TableMerge as b1, type TablePosition as b2, type ToolbarGroupConfig as b3, type TradeExecution as b4, type ValuePatch as b5, buildToolbar as b6, defaultToolbar as b7, inputDeltas as b8, inputVisible as b9, seriesInScale as ba, seriesShownOn as bb, type PaneInfo as bc, 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-CqxWoDKS.d.ts → plugin-BDxUhGO3.d.ts}

@@ -1,9 +1,9 @@
-import { z as DrawingTypeKey, af as DrawingStyle, S as SerializedDrawing, D as Drawing, O as OHLCV, aU as SeriesKind, c as VelaTheme } from './options-NAUHiQEC.js';
-import { f as DataControl } from './contributions-bWgwyiVi.js';
-import './side-panel-wMNfgyZb.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-CSXbjMM5.js';
+import { f as DataControl } from './contributions-BY3zSYiZ.js';
+import './side-panel-_2UK1gSm.js';
 import './icons-BZYbJXSV.js';
 import './keymap-CGOz5F5f.js';
-import './DataProvider-DpOWZD8F.js';
+import './DataProvider-Byo8pEv0.js';
 
 /** What a drawing type contributes to the toolbar + factory (renderer-neutral). */
 interface DrawingTypeMeta {

package/dist/{plugin-CjjzZX2F.d.cts → plugin-CiQVyETg.d.cts}

@@ -1,9 +1,9 @@
-import { z as DrawingTypeKey, af as DrawingStyle, S as SerializedDrawing, D as Drawing, O as OHLCV, aU as SeriesKind, c as VelaTheme } from './options-NAUHiQEC.cjs';
-import { f as DataControl } from './contributions-Cgm9RJYP.cjs';
-import './side-panel-wMNfgyZb.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-CSXbjMM5.cjs';
+import { f as DataControl } from './contributions-DOm40g5-.cjs';
+import './side-panel-_2UK1gSm.cjs';
 import './icons-BZYbJXSV.cjs';
 import './keymap-CGOz5F5f.cjs';
-import './DataProvider-COGDs9Xg.cjs';
+import './DataProvider-Bw58CjYy.cjs';
 
 /** What a drawing type contributes to the toolbar + factory (renderer-neutral). */
 interface DrawingTypeMeta {