@luxalgo/vela 0.8.4 → 0.8.5

package/dist/{contributions-DOm40g5-.d.cts → contributions-D8xuYc9U.d.cts}

@@ -1,5 +1,5 @@
-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, a_ as SeriesSpec, ak as Fill, H as Background, aQ 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, bg as PaneInfo, aj as DrawingsOption, ad as DrawingSeriesGateway, bh as DrawingToolDefaults, bi as DrawingToolTemplate, 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-CSXbjMM5.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-Bw58CjYy.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, a_ as SeriesSpec, ak as Fill, H as Background, aQ 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, bg as PaneInfo, aj as DrawingsOption, ad as DrawingSeriesGateway, bh as DrawingToolDefaults, bi as DrawingToolTemplate, 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-BI5Tp32b.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-DdqMxKdl.cjs';
 
 /**
  * A strategy's broker state at ONE bar — the flat summary a host reads while a script
@@ -502,7 +502,13 @@ interface NativeIndicatorContext {
     bars(): readonly OHLCV[];
     /** Market-data access (trades / capabilities) for data-driven natives. */
     readonly data: DataControl;
-    /** Push a fresh render output; the chart mounts it (first call) or patches it (subsequent). */
+    /**
+     * Push a fresh render output; the chart mounts it (first call) or patches it (subsequent).
+     * Series payloads are index-aligned: one slot per bar of `bars()` AS IT STANDS AT THE
+     * CALL, first slot on its first bar. The chart keeps an emitted output on those bars
+     * when history later lands in front of them (or the oldest bars are trimmed), until the
+     * next emit replaces it.
+     */
     emit(out: NativeIndicatorOutput): void;
     /**
      * Push a BESPOKE render payload to the renderer's native layer for this indicator's type (for a
@@ -521,7 +527,8 @@ interface NativeIndicatorContext {
 interface NativeIndicator {
     /** Begin: compute + emit the first output. */
     start(ctx: NativeIndicatorContext, inputs: Record<string, InputValue>): void;
-    /** A live tick arrived (bars changed) — recompute + emit. */
+    /** The bars changed — a live tick, older history landing, or the candles re-derived
+     *  by a price style — recompute + emit. */
     onBars(): void;
     /** The viewport changed (scroll/zoom) — for range-aware natives (see `reactsToViewport`). */
     onViewport(range: VisibleRange): void;
@@ -533,7 +540,10 @@ interface NativeIndicator {
     suspend(): void;
     /** Shown again — resume + re-emit. */
     resume(): void;
-    /** Removed — full teardown (clear caches, stop timers). Only ever called after `start`. */
+    /** Removed, or replaced by a fresh instance (a market switch stops it as the switch
+     *  begins) — full teardown (clear caches, stop timers). Only ever called after `start`.
+     *  Pushes made inside `stop()` still land (a layer-backed native clears its channel
+     *  here); once it returns, the context drops every push and emit. */
     stop(): void;
 }
 /**
@@ -555,6 +565,17 @@ interface NativeIndicatorDescriptor {
     readonly overlay: boolean;
     /** Whether instances react to viewport changes (drives the orchestrator's viewport poke). */
     readonly reactsToViewport?: boolean;
+    /**
+     * Compute only over the chart's COMPLETE history, the way script indicators do. While
+     * the history is still loading (a deep load streaming in, a source healing a cold
+     * symbol, a deeper depth being fetched), the instance is not started — its legend row
+     * shows a loading state, and `ready` / `indicator:added` wait — or, when it already
+     * runs, `onBars()` is held and the previous output stays on its bars. The first
+     * compute (or the re-run) comes once the history completes, so values computed over
+     * a partial history never paint and never repaint. Absent ⇒ the instance starts on
+     * the first bars and `onBars()` fires for every history chunk as it lands.
+     */
+    readonly waitsForHistory?: boolean;
     /** Marks the type as beta — surfaced in the catalog so a host "add indicator" UI can badge it. */
     readonly beta?: boolean;
     /**
@@ -1305,6 +1326,7 @@ interface PaneController {
     removePaneAndIndicators(paneId: string): void;
     collapsePane(paneId: string, collapsed: boolean): void;
     maximizePane(paneId: string | null): void;
+    setPaneHeightWeight(paneId: string, weight: number): void;
     moveIndicator(id: string, target: MoveTarget): void;
 }
 /**
@@ -1327,6 +1349,14 @@ declare class PanesControl {
     collapse(paneId: string, collapsed?: boolean): this;
     /** Maximize one pane to fill the plot, or restore the split (`null`). */
     maximize(paneId: string | null): this;
+    /**
+     * Set a pane's height weight: the panes share the plot height in proportion to their
+     * weights, so `setHeightWeight('price', 6)` next to two study panes at 1 gives the price
+     * pane three quarters of the height. The weight sticks until the user drags a separator
+     * or it is set again; a collapsed pane applies it when expanded. `weight` must be a
+     * positive number.
+     */
+    setHeightWeight(paneId: string, weight: number): this;
     /** Move/merge an indicator to a pane — sugar for `handle.moveTo(...)` by id. */
     moveIndicator(id: string, target: MoveTarget): this;
     private guard;
@@ -1975,6 +2005,8 @@ interface ContextMenuPointer {
     time: number | null;
     /** The kind of pane the pointer is on; null off the plot. */
     paneKind: 'price' | 'study' | null;
+    /** The id of the pane the pointer is on, as `chart.panes.list()` reports it; null off the plot. */
+    paneId: string | null;
 }
 /** What {@link WidgetContext.addIndicator} takes: a named script, ready to run. */
 interface ExternalIndicatorEntry {

package/dist/{contributions-BY3zSYiZ.d.ts → contributions-P9fBBuY1.d.ts}

@@ -1,5 +1,5 @@
-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, a_ as SeriesSpec, ak as Fill, H as Background, aQ 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, bg as PaneInfo, aj as DrawingsOption, ad as DrawingSeriesGateway, bh as DrawingToolDefaults, bi as DrawingToolTemplate, 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-CSXbjMM5.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-Byo8pEv0.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, a_ as SeriesSpec, ak as Fill, H as Background, aQ 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, bg as PaneInfo, aj as DrawingsOption, ad as DrawingSeriesGateway, bh as DrawingToolDefaults, bi as DrawingToolTemplate, 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-BI5Tp32b.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-BUdlkx9I.js';
 
 /**
  * A strategy's broker state at ONE bar — the flat summary a host reads while a script
@@ -502,7 +502,13 @@ interface NativeIndicatorContext {
     bars(): readonly OHLCV[];
     /** Market-data access (trades / capabilities) for data-driven natives. */
     readonly data: DataControl;
-    /** Push a fresh render output; the chart mounts it (first call) or patches it (subsequent). */
+    /**
+     * Push a fresh render output; the chart mounts it (first call) or patches it (subsequent).
+     * Series payloads are index-aligned: one slot per bar of `bars()` AS IT STANDS AT THE
+     * CALL, first slot on its first bar. The chart keeps an emitted output on those bars
+     * when history later lands in front of them (or the oldest bars are trimmed), until the
+     * next emit replaces it.
+     */
     emit(out: NativeIndicatorOutput): void;
     /**
      * Push a BESPOKE render payload to the renderer's native layer for this indicator's type (for a
@@ -521,7 +527,8 @@ interface NativeIndicatorContext {
 interface NativeIndicator {
     /** Begin: compute + emit the first output. */
     start(ctx: NativeIndicatorContext, inputs: Record<string, InputValue>): void;
-    /** A live tick arrived (bars changed) — recompute + emit. */
+    /** The bars changed — a live tick, older history landing, or the candles re-derived
+     *  by a price style — recompute + emit. */
     onBars(): void;
     /** The viewport changed (scroll/zoom) — for range-aware natives (see `reactsToViewport`). */
     onViewport(range: VisibleRange): void;
@@ -533,7 +540,10 @@ interface NativeIndicator {
     suspend(): void;
     /** Shown again — resume + re-emit. */
     resume(): void;
-    /** Removed — full teardown (clear caches, stop timers). Only ever called after `start`. */
+    /** Removed, or replaced by a fresh instance (a market switch stops it as the switch
+     *  begins) — full teardown (clear caches, stop timers). Only ever called after `start`.
+     *  Pushes made inside `stop()` still land (a layer-backed native clears its channel
+     *  here); once it returns, the context drops every push and emit. */
     stop(): void;
 }
 /**
@@ -555,6 +565,17 @@ interface NativeIndicatorDescriptor {
     readonly overlay: boolean;
     /** Whether instances react to viewport changes (drives the orchestrator's viewport poke). */
     readonly reactsToViewport?: boolean;
+    /**
+     * Compute only over the chart's COMPLETE history, the way script indicators do. While
+     * the history is still loading (a deep load streaming in, a source healing a cold
+     * symbol, a deeper depth being fetched), the instance is not started — its legend row
+     * shows a loading state, and `ready` / `indicator:added` wait — or, when it already
+     * runs, `onBars()` is held and the previous output stays on its bars. The first
+     * compute (or the re-run) comes once the history completes, so values computed over
+     * a partial history never paint and never repaint. Absent ⇒ the instance starts on
+     * the first bars and `onBars()` fires for every history chunk as it lands.
+     */
+    readonly waitsForHistory?: boolean;
     /** Marks the type as beta — surfaced in the catalog so a host "add indicator" UI can badge it. */
     readonly beta?: boolean;
     /**
@@ -1305,6 +1326,7 @@ interface PaneController {
     removePaneAndIndicators(paneId: string): void;
     collapsePane(paneId: string, collapsed: boolean): void;
     maximizePane(paneId: string | null): void;
+    setPaneHeightWeight(paneId: string, weight: number): void;
     moveIndicator(id: string, target: MoveTarget): void;
 }
 /**
@@ -1327,6 +1349,14 @@ declare class PanesControl {
     collapse(paneId: string, collapsed?: boolean): this;
     /** Maximize one pane to fill the plot, or restore the split (`null`). */
     maximize(paneId: string | null): this;
+    /**
+     * Set a pane's height weight: the panes share the plot height in proportion to their
+     * weights, so `setHeightWeight('price', 6)` next to two study panes at 1 gives the price
+     * pane three quarters of the height. The weight sticks until the user drags a separator
+     * or it is set again; a collapsed pane applies it when expanded. `weight` must be a
+     * positive number.
+     */
+    setHeightWeight(paneId: string, weight: number): this;
     /** Move/merge an indicator to a pane — sugar for `handle.moveTo(...)` by id. */
     moveIndicator(id: string, target: MoveTarget): this;
     private guard;
@@ -1975,6 +2005,8 @@ interface ContextMenuPointer {
     time: number | null;
     /** The kind of pane the pointer is on; null off the plot. */
     paneKind: 'price' | 'study' | null;
+    /** The id of the pane the pointer is on, as `chart.panes.list()` reports it; null off the plot. */
+    paneId: string | null;
 }
 /** What {@link WidgetContext.addIndicator} takes: a named script, ready to run. */
 interface ExternalIndicatorEntry {