@luxalgo/vela 0.6.7 → 0.6.9

package/dist/{chunk-PN5KWFZ4.js → chunk-WFSZBX3R.js}

@@ -98,11 +98,11 @@ registerIcon(
 );
 registerIcon(
   "market-pre",
-  svg24('<path d="M12 2v8"/><path d="m4.93 10.93 1.41 1.41"/><path d="M2 18h2"/><path d="M20 18h2"/><path d="m19.07 10.93-1.41 1.41"/><path d="M22 22H2"/><path d="m16 6-4 4-4-4"/><path d="M16 18a4 4 0 0 0-8 0"/>')
+  svg24('<path d="M12 2v8"/><path d="m4.93 10.93 1.41 1.41"/><path d="M2 18h2"/><path d="M20 18h2"/><path d="m19.07 10.93-1.41 1.41"/><path d="M22 22H2"/><path d="m8 6 4-4 4 4"/><path d="M16 18a4 4 0 0 0-8 0"/>')
 );
 registerIcon(
   "market-post",
-  svg24('<path d="M12 10V2"/><path d="m4.93 10.93 1.41 1.41"/><path d="M2 18h2"/><path d="M20 18h2"/><path d="m19.07 10.93-1.41 1.41"/><path d="M22 22H2"/><path d="m16 18-4-4-4 4"/><path d="M16 6a4 4 0 0 0-8 0"/>')
+  svg24('<path d="M12 10V2"/><path d="m4.93 10.93 1.41 1.41"/><path d="M2 18h2"/><path d="M20 18h2"/><path d="m19.07 10.93-1.41 1.41"/><path d="M22 22H2"/><path d="m16 14-4 4-4-4"/><path d="M16 6a4 4 0 0 0-8 0"/>')
 );
 registerIcon("market-closed", svg24('<path d="M12 3a6 6 0 0 0 9 9 9 9 0 1 1-9-9Z"/>'));
 registerIcon(

package/dist/{contributions-Z12BrWCy.d.ts → contributions-C1U2Krwg.d.cts}

@@ -1,5 +1,5 @@
-import { t as Millis, ae as InputSchema, ac as IndicatorMeta, P as PriceStyle, O as OHLCV, m as InputValue, k as IndicatorModel, j as MoveTarget, aq as PaneAxis, aD as SeriesSpec, aa as Fill, B as Background, av as PriceLine, a0 as DrawingLine, Y as DrawingBox, $ as DrawingLabel, a4 as DrawingPolyline, a1 as DrawingLinefill, a6 as DrawingTable, g as IndicatorStatus, a as VisibleRange, c as VelaTheme, S as SerializedDrawing, v as DrawingTypeKey, u as SnapMode, a2 as DrawingMode, I as IChartRenderer, R as RendererCapabilities, o as LegendActionView, U as Unsubscribe, C as CrosshairEvent, A as AxisLongPressEvent, r as DataWindowReadout, n as SymbolPickerFn, aR as PaneInfo, a9 as DrawingsOption, D as Drawing, b as VelaOptions, x as AddIndicatorOptions, ap as MarketSwitch, ao as MarketSnapshot, V as VisibleRangePreset, T as ThemeName } from './options-BaVTMXaO.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-BSLlBpB9.js';
+import { u as Millis, af as InputSchema, ad as IndicatorMeta, P as PriceStyle, O as OHLCV, m as InputValue, k as IndicatorModel, j as MoveTarget, ar as PaneAxis, aE as SeriesSpec, ab as Fill, B as Background, aw as PriceLine, a1 as DrawingLine, Z as DrawingBox, a0 as DrawingLabel, a5 as DrawingPolyline, a2 as DrawingLinefill, a7 as DrawingTable, g as IndicatorStatus, a as VisibleRange, c as VelaTheme, S as SerializedDrawing, w as DrawingTypeKey, v as SnapMode, a3 as DrawingMode, I as IChartRenderer, R as RendererCapabilities, o as LegendActionView, p as LegendCalloutView, U as Unsubscribe, C as CrosshairEvent, A as AxisLongPressEvent, s as DataWindowReadout, n as SymbolPickerFn, aS as PaneInfo, aa as DrawingsOption, D as Drawing, b as VelaOptions, y as AddIndicatorOptions, aq as MarketSwitch, ap as MarketSnapshot, V as VisibleRangePreset, T as ThemeName } from './options-FM0peknS.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-8Z95Q-RJ.cjs';
 
 /**
  * A strategy's broker state at ONE bar — the flat summary a host reads while a script
@@ -92,6 +92,14 @@ interface PreparedScript {
     /** The language that produced this (the engine's `language`). */
     language: string;
     inputs: InputSchema[];
+    /**
+     * Declaration-property schema (a strategy's `initial_capital`, an indicator's
+     * `precision`, …) — the settings dialog renders these on a "Properties" tab.
+     * `defval` is the EFFECTIVE default: the value the script declares, else the
+     * engine's configured default, else the language's own. Absent ≡ the language
+     * has no declaration properties (`capabilities.props` false).
+     */
+    props?: InputSchema[];
     meta: IndicatorMeta;
     /**
      * Whether the script references a viewport built-in (e.g. Pine
@@ -109,6 +117,9 @@ interface EngineCapabilities {
     visibleRange: boolean;
     /** Exposes an inputs schema (drives the renderer's settings dialog). */
     inputs: boolean;
+    /** Exposes a declaration-props schema (`PreparedScript.props`) and honors prop
+     *  overrides on `execute`/`update`. Absent ≡ false. */
+    props?: boolean;
 }
 /** Market context an execution needs. Vela owns the bars; this is the metadata. */
 interface ExecutionMarket {
@@ -145,6 +156,9 @@ interface ExecutionRequest {
      */
     fetchSeries?: FetchSeries;
     inputs?: Record<string, InputValue>;
+    /** Declaration-prop overrides, keyed like `PreparedScript.props`. Only meaningful
+     *  when `capabilities.props`; other engines ignore it. */
+    props?: Record<string, InputValue>;
     visibleRange?: VisibleBarRange;
     mode: 'static' | 'live';
     /**
@@ -221,8 +235,10 @@ interface ExecutionSession {
     getContext?(select?: ContextSelect): Promise<EngineContextSnapshot | null>;
     /** Tear down (stops any streaming / incremental re-execution). */
     stop(): void;
-    /** Re-run / re-stream with merged input overrides. */
-    update(inputs: Record<string, InputValue>): void;
+    /** Re-run / re-stream with merged input overrides. `props` (when given) merges
+     *  declaration-prop overrides the same way — a props-capable engine re-runs with
+     *  both applied; others may ignore the second argument. */
+    update(inputs: Record<string, InputValue>, props?: Record<string, InputValue>): void;
     /** Update the viewport window (re-runs viewport-dependent scripts; no-op otherwise). */
     setVisibleRange(range: VisibleBarRange): void;
     /** Signal that Vela's bars changed. No reason = live tick; see {@link BarsChangeReason}. */
@@ -272,10 +288,18 @@ interface IndicatorHandle {
     readonly source?: string;
     /** Inputs parsed from the Pine source (populated once the script is prepared). */
     readonly inputs: readonly InputSchema[];
+    /** Declaration-props schema (a strategy's `initial_capital`, an indicator's
+     *  `precision`, …; populated once the script is prepared). Empty when the
+     *  engine exposes none. */
+    readonly props: readonly InputSchema[];
     /** Whether the indicator is currently shown (vs hidden). Hidden indicators stop computing. */
     readonly visible: boolean;
     setInput(key: string, value: InputValue): void;
     setInputs(values: Record<string, InputValue>): void;
+    /** Override one declaration prop and re-run (a prop change replays the whole script). */
+    setProp(key: string, value: InputValue): void;
+    /** Override several declaration props at once and re-run. */
+    setProps(values: Record<string, InputValue>): 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
@@ -459,8 +483,8 @@ interface NativeIndicatorDescriptor {
     /** Full display name (picker, settings header, handle title). */
     readonly title: string;
     /**
-     * Compact name for the on-chart legend chip. Absent ⇒ {@link title}. The picker and
-     * settings dialog keep the full title either way.
+     * Compact name for the on-chart legend chip and the settings-dialog header.
+     * Absent ⇒ {@link title}. The picker keeps the full title either way.
      */
     readonly shortTitle?: string;
     readonly paneHint: 'price' | 'new';
@@ -800,6 +824,8 @@ interface IndicatorSummary {
     barColors: number;
     trades: number;
     inputs: number;
+    /** Elements flagged `force_overlay` (routed to the price pane), across every kind. */
+    forcedOverlay: number;
 }
 /** A snapshot of everything the Vela core has generated for the mounted indicators. */
 interface SceneInspection {
@@ -819,6 +845,7 @@ interface SceneInspection {
         tables: number;
         barColors: number;
         trades: number;
+        forcedOverlay: number;
     };
 }
 
@@ -853,6 +880,13 @@ declare class RendererControl {
      * degradation as the sync ghost crosshair.
      */
     setLegendActions(provider: ((indicatorId: string) => LegendActionView[]) | null): void;
+    /**
+     * Wire the legend rows' HOST-CONTRIBUTED callout bubbles (the shells route the
+     * plugin registry through this; see `registerLegendCallout`). Silent on a renderer
+     * without the seam — contributed callouts simply never show there, same graceful
+     * degradation as {@link setLegendActions}.
+     */
+    setLegendCallouts(provider: ((indicatorId: string) => LegendCalloutView[]) | null): void;
     /**
      * Replace the indicator legend's fold toggle with a host action (or restore it with
      * `null`) — multi-chart shells point the chip at their indicator overview instead of
@@ -1439,6 +1473,10 @@ interface WidgetContext {
      *  a shell may replace its chart instance, and a captured one would be destroyed.
      *  (Symbol and timeframe switches are applied IN PLACE — the instance survives them.) */
     chart: Vela;
+    /** LIVE getters, like `chart` — they resolve the ACTIVE cell's market at every
+     *  read, so an attachment that holds its mount context keeps reading the truth
+     *  after a symbol/timeframe switch. Read them at the point of use; never copy
+     *  them into long-lived state. */
     symbol: string;
     timeframe: string;
     priceStyle: string;
@@ -1485,9 +1523,18 @@ interface WidgetActionDescriptor {
     /** Stable id — re-registering an id replaces it. */
     id: string;
     target: WidgetActionTarget;
+    /** Always required, even icon-only: it is the button's aria-label and tooltip, the
+     *  mobile drawer row's text, and the context-menu item's label. */
     label: string;
     /** Icon id from the `vela/ui` icon registry (register yours with `registerIcon`). */
     icon?: string;
+    /** Topbar only: render the DESKTOP button icon-only, like the built-in tools — the
+     *  `label` moves to the aria-label and a kit tooltip instead of button text (mobile
+     *  surfaces keep their text). The right cluster gets the native 32px tool look; the
+     *  left cluster keeps the primary chrome, minus the text. Requires `icon` — without
+     *  one the flag is ignored (with a console warning) and the label renders. The piece
+     *  that makes a `'screenshot'` slot override pixel-faithful to the native button. */
+    iconOnly?: boolean;
     /** Sort key within the contributed group (ascending; default 0). */
     order?: number;
     /** Topbar only: which cluster the button joins. `'right'` (default) is the
@@ -1635,6 +1682,64 @@ declare function registerLegendAction(desc: LegendActionDescriptor): () => void;
 declare function unregisterLegendAction(id: string): void;
 /** Every registered legend action, `order`-sorted (registration order breaks ties). */
 declare function legendActions(): LegendActionDescriptor[];
+/** One block of a legend callout's deployed panel, descriptor-side: plain text, or a
+ *  button whose `run` receives the shell's {@link WidgetContext} and the row's
+ *  indicator — the same signature as a legend action's `run`. */
+type LegendCalloutItem = {
+    type: 'text';
+    text: string;
+} | {
+    type: 'button';
+    label: string;
+    /** Emphasized (selection-colored) button — the panel's main action. */
+    primary?: boolean;
+    /** Close the panel after `run` (default true). */
+    close?: boolean;
+    run(ctx: WidgetContext, indicator: LegendIndicatorInfo): void;
+};
+/** The panel a clickable callout deploys: an optional heading over ordered blocks. */
+interface LegendCalloutContent {
+    title?: string;
+    items: LegendCalloutItem[];
+}
+/** A callout's resolved presentation for one row — what {@link LegendCalloutDescriptor.callout} returns. */
+interface LegendCalloutSpec {
+    /** Icon id from the `vela/ui` icon registry (register yours with `registerIcon`). */
+    icon: string;
+    /** Bubble fill — any CSS color (`color-mix` token washes match the built-in badges). */
+    background: string;
+    /** Icon ink (default: the legend row's text color). */
+    color?: string;
+    /** Hover text; also the bubble's accessible name. */
+    tooltip: string;
+    /** Deployed panel — presence makes the bubble clickable. */
+    content?: LegendCalloutContent;
+}
+/**
+ * A contributed LEGEND CALLOUT: a small tinted bubble with a centered icon, always
+ * visible right of the indicator's legend title (trailing the whole row while its
+ * hover controls are out). When the spec carries `content`, clicking the bubble
+ * deploys that panel — below it, flipping above near the bottom screen edge.
+ *
+ * Unlike a legend action's static icon, a callout's whole presentation is resolved
+ * per row through `callout` — return `null` to show none (the per-indicator gate),
+ * or a spec whose icon/tint/panel follow your own state (a market-status bubble
+ * changes dress as sessions roll). Late state changes re-project through the shells'
+ * `refreshActions()`, like every contribution.
+ */
+interface LegendCalloutDescriptor {
+    /** Stable id — re-registering an id replaces it. */
+    id: string;
+    /** Sort key within the contributed group (ascending; default 0). */
+    order?: number;
+    /** Resolve the row's bubble — `null`/`undefined` shows none. */
+    callout(indicator: LegendIndicatorInfo): LegendCalloutSpec | null | undefined;
+}
+/** Register (or replace) a legend callout. Returns an unregister disposer. */
+declare function registerLegendCallout(desc: LegendCalloutDescriptor): () => void;
+declare function unregisterLegendCallout(id: string): void;
+/** Every registered legend callout, `order`-sorted (registration order breaks ties). */
+declare function legendCallouts(): LegendCalloutDescriptor[];
 /**
  * The surface a `scope: 'cell'` persistence handler works against — bound to ONE cell
  * (never the active one by proxy), because serialize/restore run per cell, including
@@ -1729,4 +1834,4 @@ declare function unregisterDefaultEngine(language: string): void;
  *  language. The shell layers (widget, workspace cell) register exactly this result. */
 declare function resolveEngines(overrides?: Record<string, EngineFactory>): Record<string, EngineFactory>;
 
-export { type WidgetActionDescriptor as $, type SidePanelButton as A, type BarsChangeReason as B, type CellStateContext as C, type DrawingsDocument as D, type ExternalIndicatorEntry as E, type FetchSeries as F, type SidePanelDescriptor as G, type SidePanelHandle as H, type IndicatorHandle as I, type SidePanelHeader as J, type StatePersistenceHandler as K, type LegendActionDescriptor as L, type StrategyFill as M, type NativeIndicator as N, OVERRIDABLE_TOPBAR_IDS as O, type ParsedSymbol as P, type StrategyState as Q, type Resolved as R, type ScriptingEngine as S, type StrategyTrade as T, type SymbolRankingHook as U, Vela as V, type WidgetContext as W, TypedEventBus as X, type VelaDeps as Y, type VelaEventMap as Z, type VisibleBarRange as _, type ScriptRun as a, type WidgetActionTarget as a0, type WidgetAttachment as a1, getNativeIndicator as a2, legendActions as a3, nativeIndicatorDescriptors as a4, nativeIndicatorTypes as a5, registerDefaultEngine as a6, registerLegendAction as a7, registerNativeIndicator as a8, registerSidePanel as a9, registerStatePersistence as aa, registerSymbolRanking as ab, registerWidgetAction as ac, registerWidgetAttachment as ad, resolveEngines as ae, sidePanels as af, statePersistenceHandlers as ag, symbolRanking as ah, topbarActionOverride as ai, unregisterDefaultEngine as aj, unregisterLegendAction as ak, unregisterNativeIndicator as al, unregisterSidePanel as am, unregisterStatePersistence as an, unregisterWidgetAction as ao, unregisterWidgetAttachment as ap, widgetActions as aq, widgetAttachments as ar, DEFAULT_PANEL_ORDER as as, type ContextSelect as b, DataControl as c, DrawingsControl as d, type EngineAlert as e, type EngineCapabilities as f, type EngineContextSnapshot as g, type EngineFactory as h, type EngineWarning as i, type ExecutionHandlers as j, type ExecutionMarket as k, type ExecutionRequest as l, type ExecutionSession as m, type IndicatorEventMap as n, type IndicatorSummary as o, type LegendIndicatorInfo as p, type NativeIndicatorContext as q, type NativeIndicatorDescriptor as r, type NativeIndicatorInfo as s, type NativeIndicatorOutput as t, type PreparedScript as u, RendererControl as v, type RunIndicatorResult as w, type SceneInspection as x, type ScriptRunCause as y, type ScriptRunResult as z };
+export { TypedEventBus as $, type RunIndicatorResult as A, type BarsChangeReason as B, type CellStateContext as C, type DrawingsDocument as D, type ExternalIndicatorEntry as E, type FetchSeries as F, type SceneInspection as G, type ScriptRunCause as H, type IndicatorHandle as I, type ScriptRunResult as J, type SidePanelButton as K, type LegendActionDescriptor as L, type SidePanelDescriptor as M, type NativeIndicator as N, OVERRIDABLE_TOPBAR_IDS as O, type ParsedSymbol as P, type SidePanelHandle as Q, type Resolved as R, type ScriptingEngine as S, type SidePanelHeader as T, type StatePersistenceHandler as U, Vela as V, type WidgetContext as W, type StrategyFill as X, type StrategyState as Y, type StrategyTrade as Z, type SymbolRankingHook as _, type ScriptRun as a, type VelaDeps as a0, type VelaEventMap as a1, type VisibleBarRange as a2, type WidgetActionDescriptor as a3, type WidgetActionTarget as a4, type WidgetAttachment as a5, getNativeIndicator as a6, legendActions as a7, legendCallouts as a8, nativeIndicatorDescriptors as a9, nativeIndicatorTypes as aa, registerDefaultEngine as ab, registerLegendAction as ac, registerLegendCallout as ad, registerNativeIndicator as ae, registerSidePanel as af, registerStatePersistence as ag, registerSymbolRanking as ah, registerWidgetAction as ai, registerWidgetAttachment as aj, resolveEngines as ak, sidePanels as al, statePersistenceHandlers as am, symbolRanking as an, topbarActionOverride as ao, unregisterDefaultEngine as ap, unregisterLegendAction as aq, unregisterLegendCallout as ar, unregisterNativeIndicator as as, unregisterSidePanel as at, unregisterStatePersistence as au, unregisterWidgetAction as av, unregisterWidgetAttachment as aw, widgetActions as ax, widgetAttachments as ay, DEFAULT_PANEL_ORDER as az, type ContextSelect as b, DataControl as c, DrawingsControl as d, type EngineAlert as e, type EngineCapabilities as f, type EngineContextSnapshot as g, type EngineFactory as h, type EngineWarning as i, type ExecutionHandlers as j, type ExecutionMarket as k, type ExecutionRequest as l, type ExecutionSession as m, type IndicatorEventMap as n, type IndicatorSummary as o, type LegendCalloutContent as p, type LegendCalloutDescriptor as q, type LegendCalloutItem as r, type LegendCalloutSpec as s, type LegendIndicatorInfo as t, type NativeIndicatorContext as u, type NativeIndicatorDescriptor as v, type NativeIndicatorInfo as w, type NativeIndicatorOutput as x, type PreparedScript as y, RendererControl as z };

package/dist/{contributions-Hv4_cOJo.d.cts → contributions-D7PVZO2i.d.ts}

@@ -1,5 +1,5 @@
-import { t as Millis, ae as InputSchema, ac as IndicatorMeta, P as PriceStyle, O as OHLCV, m as InputValue, k as IndicatorModel, j as MoveTarget, aq as PaneAxis, aD as SeriesSpec, aa as Fill, B as Background, av as PriceLine, a0 as DrawingLine, Y as DrawingBox, $ as DrawingLabel, a4 as DrawingPolyline, a1 as DrawingLinefill, a6 as DrawingTable, g as IndicatorStatus, a as VisibleRange, c as VelaTheme, S as SerializedDrawing, v as DrawingTypeKey, u as SnapMode, a2 as DrawingMode, I as IChartRenderer, R as RendererCapabilities, o as LegendActionView, U as Unsubscribe, C as CrosshairEvent, A as AxisLongPressEvent, r as DataWindowReadout, n as SymbolPickerFn, aR as PaneInfo, a9 as DrawingsOption, D as Drawing, b as VelaOptions, x as AddIndicatorOptions, ap as MarketSwitch, ao as MarketSnapshot, V as VisibleRangePreset, T as ThemeName } from './options-BaVTMXaO.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-BsQM2WNH.cjs';
+import { u as Millis, af as InputSchema, ad as IndicatorMeta, P as PriceStyle, O as OHLCV, m as InputValue, k as IndicatorModel, j as MoveTarget, ar as PaneAxis, aE as SeriesSpec, ab as Fill, B as Background, aw as PriceLine, a1 as DrawingLine, Z as DrawingBox, a0 as DrawingLabel, a5 as DrawingPolyline, a2 as DrawingLinefill, a7 as DrawingTable, g as IndicatorStatus, a as VisibleRange, c as VelaTheme, S as SerializedDrawing, w as DrawingTypeKey, v as SnapMode, a3 as DrawingMode, I as IChartRenderer, R as RendererCapabilities, o as LegendActionView, p as LegendCalloutView, U as Unsubscribe, C as CrosshairEvent, A as AxisLongPressEvent, s as DataWindowReadout, n as SymbolPickerFn, aS as PaneInfo, aa as DrawingsOption, D as Drawing, b as VelaOptions, y as AddIndicatorOptions, aq as MarketSwitch, ap as MarketSnapshot, V as VisibleRangePreset, T as ThemeName } from './options-FM0peknS.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-DExJrfut.js';
 
 /**
  * A strategy's broker state at ONE bar — the flat summary a host reads while a script
@@ -92,6 +92,14 @@ interface PreparedScript {
     /** The language that produced this (the engine's `language`). */
     language: string;
     inputs: InputSchema[];
+    /**
+     * Declaration-property schema (a strategy's `initial_capital`, an indicator's
+     * `precision`, …) — the settings dialog renders these on a "Properties" tab.
+     * `defval` is the EFFECTIVE default: the value the script declares, else the
+     * engine's configured default, else the language's own. Absent ≡ the language
+     * has no declaration properties (`capabilities.props` false).
+     */
+    props?: InputSchema[];
     meta: IndicatorMeta;
     /**
      * Whether the script references a viewport built-in (e.g. Pine
@@ -109,6 +117,9 @@ interface EngineCapabilities {
     visibleRange: boolean;
     /** Exposes an inputs schema (drives the renderer's settings dialog). */
     inputs: boolean;
+    /** Exposes a declaration-props schema (`PreparedScript.props`) and honors prop
+     *  overrides on `execute`/`update`. Absent ≡ false. */
+    props?: boolean;
 }
 /** Market context an execution needs. Vela owns the bars; this is the metadata. */
 interface ExecutionMarket {
@@ -145,6 +156,9 @@ interface ExecutionRequest {
      */
     fetchSeries?: FetchSeries;
     inputs?: Record<string, InputValue>;
+    /** Declaration-prop overrides, keyed like `PreparedScript.props`. Only meaningful
+     *  when `capabilities.props`; other engines ignore it. */
+    props?: Record<string, InputValue>;
     visibleRange?: VisibleBarRange;
     mode: 'static' | 'live';
     /**
@@ -221,8 +235,10 @@ interface ExecutionSession {
     getContext?(select?: ContextSelect): Promise<EngineContextSnapshot | null>;
     /** Tear down (stops any streaming / incremental re-execution). */
     stop(): void;
-    /** Re-run / re-stream with merged input overrides. */
-    update(inputs: Record<string, InputValue>): void;
+    /** Re-run / re-stream with merged input overrides. `props` (when given) merges
+     *  declaration-prop overrides the same way — a props-capable engine re-runs with
+     *  both applied; others may ignore the second argument. */
+    update(inputs: Record<string, InputValue>, props?: Record<string, InputValue>): void;
     /** Update the viewport window (re-runs viewport-dependent scripts; no-op otherwise). */
     setVisibleRange(range: VisibleBarRange): void;
     /** Signal that Vela's bars changed. No reason = live tick; see {@link BarsChangeReason}. */
@@ -272,10 +288,18 @@ interface IndicatorHandle {
     readonly source?: string;
     /** Inputs parsed from the Pine source (populated once the script is prepared). */
     readonly inputs: readonly InputSchema[];
+    /** Declaration-props schema (a strategy's `initial_capital`, an indicator's
+     *  `precision`, …; populated once the script is prepared). Empty when the
+     *  engine exposes none. */
+    readonly props: readonly InputSchema[];
     /** Whether the indicator is currently shown (vs hidden). Hidden indicators stop computing. */
     readonly visible: boolean;
     setInput(key: string, value: InputValue): void;
     setInputs(values: Record<string, InputValue>): void;
+    /** Override one declaration prop and re-run (a prop change replays the whole script). */
+    setProp(key: string, value: InputValue): void;
+    /** Override several declaration props at once and re-run. */
+    setProps(values: Record<string, InputValue>): 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
@@ -459,8 +483,8 @@ interface NativeIndicatorDescriptor {
     /** Full display name (picker, settings header, handle title). */
     readonly title: string;
     /**
-     * Compact name for the on-chart legend chip. Absent ⇒ {@link title}. The picker and
-     * settings dialog keep the full title either way.
+     * Compact name for the on-chart legend chip and the settings-dialog header.
+     * Absent ⇒ {@link title}. The picker keeps the full title either way.
      */
     readonly shortTitle?: string;
     readonly paneHint: 'price' | 'new';
@@ -800,6 +824,8 @@ interface IndicatorSummary {
     barColors: number;
     trades: number;
     inputs: number;
+    /** Elements flagged `force_overlay` (routed to the price pane), across every kind. */
+    forcedOverlay: number;
 }
 /** A snapshot of everything the Vela core has generated for the mounted indicators. */
 interface SceneInspection {
@@ -819,6 +845,7 @@ interface SceneInspection {
         tables: number;
         barColors: number;
         trades: number;
+        forcedOverlay: number;
     };
 }
 
@@ -853,6 +880,13 @@ declare class RendererControl {
      * degradation as the sync ghost crosshair.
      */
     setLegendActions(provider: ((indicatorId: string) => LegendActionView[]) | null): void;
+    /**
+     * Wire the legend rows' HOST-CONTRIBUTED callout bubbles (the shells route the
+     * plugin registry through this; see `registerLegendCallout`). Silent on a renderer
+     * without the seam — contributed callouts simply never show there, same graceful
+     * degradation as {@link setLegendActions}.
+     */
+    setLegendCallouts(provider: ((indicatorId: string) => LegendCalloutView[]) | null): void;
     /**
      * Replace the indicator legend's fold toggle with a host action (or restore it with
      * `null`) — multi-chart shells point the chip at their indicator overview instead of
@@ -1439,6 +1473,10 @@ interface WidgetContext {
      *  a shell may replace its chart instance, and a captured one would be destroyed.
      *  (Symbol and timeframe switches are applied IN PLACE — the instance survives them.) */
     chart: Vela;
+    /** LIVE getters, like `chart` — they resolve the ACTIVE cell's market at every
+     *  read, so an attachment that holds its mount context keeps reading the truth
+     *  after a symbol/timeframe switch. Read them at the point of use; never copy
+     *  them into long-lived state. */
     symbol: string;
     timeframe: string;
     priceStyle: string;
@@ -1485,9 +1523,18 @@ interface WidgetActionDescriptor {
     /** Stable id — re-registering an id replaces it. */
     id: string;
     target: WidgetActionTarget;
+    /** Always required, even icon-only: it is the button's aria-label and tooltip, the
+     *  mobile drawer row's text, and the context-menu item's label. */
     label: string;
     /** Icon id from the `vela/ui` icon registry (register yours with `registerIcon`). */
     icon?: string;
+    /** Topbar only: render the DESKTOP button icon-only, like the built-in tools — the
+     *  `label` moves to the aria-label and a kit tooltip instead of button text (mobile
+     *  surfaces keep their text). The right cluster gets the native 32px tool look; the
+     *  left cluster keeps the primary chrome, minus the text. Requires `icon` — without
+     *  one the flag is ignored (with a console warning) and the label renders. The piece
+     *  that makes a `'screenshot'` slot override pixel-faithful to the native button. */
+    iconOnly?: boolean;
     /** Sort key within the contributed group (ascending; default 0). */
     order?: number;
     /** Topbar only: which cluster the button joins. `'right'` (default) is the
@@ -1635,6 +1682,64 @@ declare function registerLegendAction(desc: LegendActionDescriptor): () => void;
 declare function unregisterLegendAction(id: string): void;
 /** Every registered legend action, `order`-sorted (registration order breaks ties). */
 declare function legendActions(): LegendActionDescriptor[];
+/** One block of a legend callout's deployed panel, descriptor-side: plain text, or a
+ *  button whose `run` receives the shell's {@link WidgetContext} and the row's
+ *  indicator — the same signature as a legend action's `run`. */
+type LegendCalloutItem = {
+    type: 'text';
+    text: string;
+} | {
+    type: 'button';
+    label: string;
+    /** Emphasized (selection-colored) button — the panel's main action. */
+    primary?: boolean;
+    /** Close the panel after `run` (default true). */
+    close?: boolean;
+    run(ctx: WidgetContext, indicator: LegendIndicatorInfo): void;
+};
+/** The panel a clickable callout deploys: an optional heading over ordered blocks. */
+interface LegendCalloutContent {
+    title?: string;
+    items: LegendCalloutItem[];
+}
+/** A callout's resolved presentation for one row — what {@link LegendCalloutDescriptor.callout} returns. */
+interface LegendCalloutSpec {
+    /** Icon id from the `vela/ui` icon registry (register yours with `registerIcon`). */
+    icon: string;
+    /** Bubble fill — any CSS color (`color-mix` token washes match the built-in badges). */
+    background: string;
+    /** Icon ink (default: the legend row's text color). */
+    color?: string;
+    /** Hover text; also the bubble's accessible name. */
+    tooltip: string;
+    /** Deployed panel — presence makes the bubble clickable. */
+    content?: LegendCalloutContent;
+}
+/**
+ * A contributed LEGEND CALLOUT: a small tinted bubble with a centered icon, always
+ * visible right of the indicator's legend title (trailing the whole row while its
+ * hover controls are out). When the spec carries `content`, clicking the bubble
+ * deploys that panel — below it, flipping above near the bottom screen edge.
+ *
+ * Unlike a legend action's static icon, a callout's whole presentation is resolved
+ * per row through `callout` — return `null` to show none (the per-indicator gate),
+ * or a spec whose icon/tint/panel follow your own state (a market-status bubble
+ * changes dress as sessions roll). Late state changes re-project through the shells'
+ * `refreshActions()`, like every contribution.
+ */
+interface LegendCalloutDescriptor {
+    /** Stable id — re-registering an id replaces it. */
+    id: string;
+    /** Sort key within the contributed group (ascending; default 0). */
+    order?: number;
+    /** Resolve the row's bubble — `null`/`undefined` shows none. */
+    callout(indicator: LegendIndicatorInfo): LegendCalloutSpec | null | undefined;
+}
+/** Register (or replace) a legend callout. Returns an unregister disposer. */
+declare function registerLegendCallout(desc: LegendCalloutDescriptor): () => void;
+declare function unregisterLegendCallout(id: string): void;
+/** Every registered legend callout, `order`-sorted (registration order breaks ties). */
+declare function legendCallouts(): LegendCalloutDescriptor[];
 /**
  * The surface a `scope: 'cell'` persistence handler works against — bound to ONE cell
  * (never the active one by proxy), because serialize/restore run per cell, including
@@ -1729,4 +1834,4 @@ declare function unregisterDefaultEngine(language: string): void;
  *  language. The shell layers (widget, workspace cell) register exactly this result. */
 declare function resolveEngines(overrides?: Record<string, EngineFactory>): Record<string, EngineFactory>;
 
-export { type WidgetActionDescriptor as $, type SidePanelButton as A, type BarsChangeReason as B, type CellStateContext as C, type DrawingsDocument as D, type ExternalIndicatorEntry as E, type FetchSeries as F, type SidePanelDescriptor as G, type SidePanelHandle as H, type IndicatorHandle as I, type SidePanelHeader as J, type StatePersistenceHandler as K, type LegendActionDescriptor as L, type StrategyFill as M, type NativeIndicator as N, OVERRIDABLE_TOPBAR_IDS as O, type ParsedSymbol as P, type StrategyState as Q, type Resolved as R, type ScriptingEngine as S, type StrategyTrade as T, type SymbolRankingHook as U, Vela as V, type WidgetContext as W, TypedEventBus as X, type VelaDeps as Y, type VelaEventMap as Z, type VisibleBarRange as _, type ScriptRun as a, type WidgetActionTarget as a0, type WidgetAttachment as a1, getNativeIndicator as a2, legendActions as a3, nativeIndicatorDescriptors as a4, nativeIndicatorTypes as a5, registerDefaultEngine as a6, registerLegendAction as a7, registerNativeIndicator as a8, registerSidePanel as a9, registerStatePersistence as aa, registerSymbolRanking as ab, registerWidgetAction as ac, registerWidgetAttachment as ad, resolveEngines as ae, sidePanels as af, statePersistenceHandlers as ag, symbolRanking as ah, topbarActionOverride as ai, unregisterDefaultEngine as aj, unregisterLegendAction as ak, unregisterNativeIndicator as al, unregisterSidePanel as am, unregisterStatePersistence as an, unregisterWidgetAction as ao, unregisterWidgetAttachment as ap, widgetActions as aq, widgetAttachments as ar, DEFAULT_PANEL_ORDER as as, type ContextSelect as b, DataControl as c, DrawingsControl as d, type EngineAlert as e, type EngineCapabilities as f, type EngineContextSnapshot as g, type EngineFactory as h, type EngineWarning as i, type ExecutionHandlers as j, type ExecutionMarket as k, type ExecutionRequest as l, type ExecutionSession as m, type IndicatorEventMap as n, type IndicatorSummary as o, type LegendIndicatorInfo as p, type NativeIndicatorContext as q, type NativeIndicatorDescriptor as r, type NativeIndicatorInfo as s, type NativeIndicatorOutput as t, type PreparedScript as u, RendererControl as v, type RunIndicatorResult as w, type SceneInspection as x, type ScriptRunCause as y, type ScriptRunResult as z };
+export { TypedEventBus as $, type RunIndicatorResult as A, type BarsChangeReason as B, type CellStateContext as C, type DrawingsDocument as D, type ExternalIndicatorEntry as E, type FetchSeries as F, type SceneInspection as G, type ScriptRunCause as H, type IndicatorHandle as I, type ScriptRunResult as J, type SidePanelButton as K, type LegendActionDescriptor as L, type SidePanelDescriptor as M, type NativeIndicator as N, OVERRIDABLE_TOPBAR_IDS as O, type ParsedSymbol as P, type SidePanelHandle as Q, type Resolved as R, type ScriptingEngine as S, type SidePanelHeader as T, type StatePersistenceHandler as U, Vela as V, type WidgetContext as W, type StrategyFill as X, type StrategyState as Y, type StrategyTrade as Z, type SymbolRankingHook as _, type ScriptRun as a, type VelaDeps as a0, type VelaEventMap as a1, type VisibleBarRange as a2, type WidgetActionDescriptor as a3, type WidgetActionTarget as a4, type WidgetAttachment as a5, getNativeIndicator as a6, legendActions as a7, legendCallouts as a8, nativeIndicatorDescriptors as a9, nativeIndicatorTypes as aa, registerDefaultEngine as ab, registerLegendAction as ac, registerLegendCallout as ad, registerNativeIndicator as ae, registerSidePanel as af, registerStatePersistence as ag, registerSymbolRanking as ah, registerWidgetAction as ai, registerWidgetAttachment as aj, resolveEngines as ak, sidePanels as al, statePersistenceHandlers as am, symbolRanking as an, topbarActionOverride as ao, unregisterDefaultEngine as ap, unregisterLegendAction as aq, unregisterLegendCallout as ar, unregisterNativeIndicator as as, unregisterSidePanel as at, unregisterStatePersistence as au, unregisterWidgetAction as av, unregisterWidgetAttachment as aw, widgetActions as ax, widgetAttachments as ay, DEFAULT_PANEL_ORDER as az, type ContextSelect as b, DataControl as c, DrawingsControl as d, type EngineAlert as e, type EngineCapabilities as f, type EngineContextSnapshot as g, type EngineFactory as h, type EngineWarning as i, type ExecutionHandlers as j, type ExecutionMarket as k, type ExecutionRequest as l, type ExecutionSession as m, type IndicatorEventMap as n, type IndicatorSummary as o, type LegendCalloutContent as p, type LegendCalloutDescriptor as q, type LegendCalloutItem as r, type LegendCalloutSpec as s, type LegendIndicatorInfo as t, type NativeIndicatorContext as u, type NativeIndicatorDescriptor as v, type NativeIndicatorInfo as w, type NativeIndicatorOutput as x, type PreparedScript as y, RendererControl as z };