@luxalgo/vela 0.7.0 → 0.7.1

package/dist/{contributions-Cv2Mutvn.d.cts → contributions-CcBFe-91.d.cts}

@@ -1,5 +1,5 @@
-import { x as Millis, an as InputSchema, al as IndicatorMeta, P as PriceStyle, O as OHLCV, I as InputValue, l as IndicatorModel, k as MoveTarget, aH as PaneAxis, aV as SeriesSpec, aj as Fill, G as Background, aM as PriceLine, a6 as DrawingLine, a2 as DrawingBox, a5 as DrawingLabel, aa as DrawingPolyline, a7 as DrawingLinefill, af as DrawingTable, h as IndicatorStatus, a as VisibleRange, c as VelaTheme, S as SerializedDrawing, z as DrawingTypeKey, y as SnapMode, a8 as DrawingMode, u as MarkClickEvent, e as IChartRenderer, R as RendererCapabilities, o as LegendActionView, p as LegendCalloutView, U as Unsubscribe, C as CrosshairEvent, A as AxisLongPressEvent, v as DataWindowReadout, n as SymbolPickerFn, W as WallClock, b8 as PaneInfo, ai as DrawingsOption, ac as DrawingSeriesGateway, D as Drawing, s as TimelineMark, t as MarkGroup, b as VelaOptions, E as AddIndicatorOptions, aG as MarketSwitch, aF as MarketSnapshot, V as VisibleRangePreset, T as ThemeName } from './options-ex2_gtKp.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-Ck2qyS_9.cjs';
+import { x as Millis, an as InputSchema, al as IndicatorMeta, P as PriceStyle, O as OHLCV, I as InputValue, l as IndicatorModel, k as MoveTarget, aH as PaneAxis, aW as SeriesSpec, aj as Fill, G as Background, aM as PriceLine, a6 as DrawingLine, a2 as DrawingBox, a5 as DrawingLabel, aa as DrawingPolyline, a7 as DrawingLinefill, af as DrawingTable, h as IndicatorStatus, a as VisibleRange, c as VelaTheme, S as SerializedDrawing, z as DrawingTypeKey, y as SnapMode, a8 as DrawingMode, u as MarkClickEvent, e as IChartRenderer, R as RendererCapabilities, o as LegendActionView, p as LegendCalloutView, U as Unsubscribe, C as CrosshairEvent, A as AxisLongPressEvent, v as DataWindowReadout, n as SymbolPickerFn, W as WallClock, bc as PaneInfo, ai as DrawingsOption, ac as DrawingSeriesGateway, D as Drawing, s as TimelineMark, t as MarkGroup, b as VelaOptions, E as AddIndicatorOptions, aG as MarketSwitch, aF as MarketSnapshot, V as VisibleRangePreset, T as ThemeName } from './options-C7b_Qssu.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-D5uMiJYz.cjs';
 
 /**
  * A strategy's broker state at ONE bar — the flat summary a host reads while a script
@@ -282,9 +282,10 @@ interface IndicatorEventMap extends Record<string, unknown> {
 interface IndicatorHandle {
     readonly id: string;
     readonly title: string;
-    /** The script source this indicator was added with. `undefined` for a NATIVE
-     *  (core-computed) indicator — there is no script to show. What a host editor
-     *  opens when a legend action asks for "the code behind this row". */
+    /** The script source this indicator currently runs (the one it was added with,
+     *  until {@link updateCode} replaces it). `undefined` for a NATIVE (core-computed)
+     *  indicator — there is no script to show. What a host editor opens when a legend
+     *  action asks for "the code behind this row". */
     readonly source?: string;
     /** The registered type of a NATIVE (core-computed) indicator — `undefined` for a
      *  script indicator. The two are exclusive: a handle has a `source` or a `nativeType`. */
@@ -309,6 +310,17 @@ interface IndicatorHandle {
     setProp(key: string, value: InputValue): void;
     /** Override several declaration props at once and re-run. */
     setProps(values: Record<string, InputValue>): void;
+    /**
+     * Replace the script and re-run it **in place** — same `id`, same legend row, same
+     * pane placement, same handle; the seam for a host editor's "run my edit" and for a
+     * library's "update to the new version". The new source is prepared first: only once
+     * it compiles is the running script stopped and the new one started, so a broken edit
+     * leaves the current indicator computing and painting and reports through `error`.
+     * Input and prop values survive where the new script still declares their key;
+     * anything else takes the new declaration default. No-op for a native indicator and
+     * for an unchanged source.
+     */
+    updateCode(source: string): void;
     /**
      * Hide or show the indicator. Hiding **suspends** it — its visuals are dropped (the legend
      * row stays, marked hidden) and its computation stops (the engine session is torn down), so a
@@ -439,6 +451,10 @@ interface NativeIndicatorOutput {
 }
 /** Services the host gives a running native indicator. */
 interface NativeIndicatorContext {
+    /** This instance's indicator id — the same id its `IndicatorHandle`, `inspect()` and
+     *  the pane listing report. Lets an instance name itself to host code (a picker, a
+     *  hit-test) and tell itself apart from siblings of a `multiInstance` type. */
+    readonly id: string;
     readonly symbol: string;
     readonly timeframe: string;
     readonly live: boolean;
@@ -475,11 +491,13 @@ interface NativeIndicator {
     onViewport(range: VisibleRange): void;
     /** Settings changed — recompute + emit. */
     setInputs(inputs: Record<string, InputValue>): void;
-    /** Hidden — stop timers/fetches (free resources); the instance + its state are kept for resume. */
+    /** Hidden — stop timers/fetches (free resources); the instance + its state are kept for resume.
+     *  Only ever called after `start` (an instance added hidden is not suspended — it is
+     *  started when first shown). */
     suspend(): void;
     /** Shown again — resume + re-emit. */
     resume(): void;
-    /** Removed — full teardown (clear caches, stop timers). */
+    /** Removed — full teardown (clear caches, stop timers). Only ever called after `start`. */
     stop(): void;
 }
 /**
@@ -515,8 +533,10 @@ interface NativeIndicatorDescriptor {
     /**
      * Allow several instances of this type on one chart — every add creates a new one (a study
      * like a moving average is typically stacked at different lengths). Absent ⇒ SINGLE instance
-     * per type: a second add returns the existing handle. A type that pushes a bespoke layer
-     * payload through `pushData` must stay single-instance (the layer is keyed by type).
+     * per type: a second add returns the existing handle. A type that paints through a renderer
+     * layer (`pushData`) gets ONE layer instance per indicator instance, each fed by that
+     * instance's own channel and painting on that instance's pane — so instances never
+     * overwrite each other (see `IndicatorModel.native.channel`).
      */
     readonly multiInstance?: boolean;
     inputsSchema(): InputSchema[];
@@ -574,6 +594,8 @@ type ScriptRunCause =
  | 'bar'
 /** An input was edited. */
  | 'inputs'
+/** The script's source was replaced in place (`handle.updateCode`). */
+ | 'code'
 /** The visible range moved (viewport-aware scripts only). */
  | 'viewport'
 /** The chart's market changed and the script re-executed over the new bars. */