@luxalgo/vela 0.6.6 → 0.6.8

package/dist/{chunk-JQFO2WMU.js → chunk-SQETIBFU.js}

@@ -1,4 +1,4 @@
-import { deserializeDrawing, chartTypes, rendererLayers, foldBaseModulation, registerChartType, rendererDefaults, getDrawingType, settingsRowVisible, normalizeSettingsRow, TextLabel, Callout, resetDrawingSettings, registerNativeIndicator, chartType, getNativeIndicator, nativeIndicatorDescriptors, drawingTypes, settingsRowValueKeys, formatDuration, RegressionChannel, FixedRangeVolumeProfile, SegmentDrawing, ArrowMark, GlyphStamp, RadialFib, FibSpiral, DedekindTessellation, MachFigure, GannSquare, FibRatios, MeasureBox, PositionTool, AnchoredVwap, PatternDrawing, Comment, PriceNote, Signpost, Note, PriceLabel, GANN_SQUARE_ARCS, lineSegmentIntersection, DEFAULT_DRAWING_COLOR, GLYPH_OPTIONS, STAMP_SIZE_OPTIONS, LINE_STYLE_OPTIONS, DEDEKIND_CURVATURE_OPTIONS, MACH_NUMBER_OPTIONS, MACH_WAVE_COUNT_OPTIONS, TEXT_SIZE_OPTIONS, createDrawing, inputVisible, tickerModifierIds, CalloutBase, DIRECTION_OPTIONS } from './chunk-OEUGUXL7.js';
+import { deserializeDrawing, chartTypes, rendererLayers, foldBaseModulation, registerChartType, rendererDefaults, getDrawingType, settingsRowVisible, normalizeSettingsRow, TextLabel, Callout, resetDrawingSettings, registerNativeIndicator, chartType, getNativeIndicator, nativeIndicatorDescriptors, drawingTypes, settingsRowValueKeys, formatDuration, RegressionChannel, FixedRangeVolumeProfile, SegmentDrawing, ArrowMark, GlyphStamp, RadialFib, FibSpiral, DedekindTessellation, MachFigure, GannSquare, FibRatios, MeasureBox, PositionTool, AnchoredVwap, PatternDrawing, Comment, PriceNote, Signpost, Note, PriceLabel, GANN_SQUARE_ARCS, lineSegmentIntersection, DEFAULT_DRAWING_COLOR, GLYPH_OPTIONS, STAMP_SIZE_OPTIONS, LINE_STYLE_OPTIONS, DEDEKIND_CURVATURE_OPTIONS, MACH_NUMBER_OPTIONS, MACH_WAVE_COUNT_OPTIONS, TEXT_SIZE_OPTIONS, createDrawing, inputVisible, tickerModifierIds, CalloutBase, DIRECTION_OPTIONS } from './chunk-L3I2CCYO.js';
 import { themeTokens, Dialog, closeOpenPopovers, closeWidthPopover, fieldSection, buildFieldControl, fieldSeparator, fieldGrid, fieldRow, blendOver, splitColor, Menu, TextArea, Popover, NumberInput, buildColorPicker, isPopoverOpen, eventDismissedPopover, toggleSelectList, openPopoverTrigger, fieldGridColumns, FIELD_GAP_PX, STATIC_TOKENS } from './chunk-OICPLNU7.js';
 import { icon, iconAt, withAlpha, WARNING, ACCENT, NEUTRAL, BEARISH, BULLISH, isDarkColor, SERIES_LINE, SLATE, CROSSHAIR, TRADE_EXIT, TRADE_SHORT, TRADE_LONG, overlayScrollbarCss, SLATE_DEEP, VALID, INVALID, FIELD_FOCUS_CSS, FIELD_FOCUS_RING, svg24, svg24Solid } from './chunk-PN5KWFZ4.js';
 
@@ -865,6 +865,28 @@ var ProviderRegistry = class {
     const d = this.entries.get(resolved.provider)?.byTicker?.get(normTicker(resolved.ticker));
     return `${d?.prefix ?? resolved.provider}:${d?.ticker ?? resolved.ticker}`;
   }
+  /** The icon URL for a DESCRIPTOR — routed to its OWNING provider's resolver (the
+   *  provider owns the knowledge of where its asset class's icons live). A missing
+   *  provider, an absent resolver, or a resolver that throws all mean "no icon" —
+   *  the shells' initials badge takes over, never an error. */
+  symbolIconOf(d) {
+    const name = d.provider ? normName(d.provider) : [...this.entries.keys()][0];
+    const entry = name !== void 0 ? this.entries.get(name) : void 0;
+    try {
+      return entry?.provider.resolveSymbolIcon?.(d) ?? void 0;
+    } catch {
+      return void 0;
+    }
+  }
+  /** The icon URL for a raw SYMBOL string (the statusline/object-tree path): resolve
+   *  to the owning provider, find its descriptor, route to the resolver. Before the
+   *  index settles (or for a lenient sole-provider resolution) a minimal synthetic
+   *  descriptor is offered — crypto resolvers can answer from the ticker alone. */
+  symbolIcon(resolved) {
+    if (!resolved) return void 0;
+    const d = this.entries.get(resolved.provider)?.byTicker?.get(normTicker(resolved.ticker));
+    return this.symbolIconOf({ ...d ?? { ticker: resolved.ticker }, provider: d?.provider ?? resolved.provider });
+  }
   /** Indexed symbols for one provider (or all, concatenated) — for autocomplete. */
   symbolsOf(rawName) {
     if (rawName != null) return this.entries.get(normName(rawName))?.descriptors ?? [];
@@ -1107,6 +1129,14 @@ var MultiProviderFeed = class {
   providerInstance(name) {
     return this.registry.get(name);
   }
+  /** The icon URL for a DESCRIPTOR — its owning provider's `resolveSymbolIcon` (picker rows). */
+  symbolIconOf(d) {
+    return this.registry.symbolIconOf(d);
+  }
+  /** The icon URL for a raw SYMBOL string — resolve, then route (statusline, object tree). */
+  symbolIcon(raw) {
+    return this.registry.symbolIcon(this.resolveSymbol(raw));
+  }
   symbols(name) {
     return this.registry.symbolsOf(name);
   }
@@ -1333,6 +1363,12 @@ var DataControl = class {
   symbols(provider) {
     return this.registry?.symbols(provider) ?? [];
   }
+  /** The icon URL for `symbol` — its owning provider's `resolveSymbolIcon`, routed
+   *  through resolution. Undefined while unresolvable, when the provider declares no
+   *  resolver, or on a custom `deps.dataFeed` — the shells then show initials. */
+  symbolIcon(symbol) {
+    return this.registry?.symbolIcon(symbol);
+  }
   /** Per-symbol metadata (Pine `syminfo.*`), resolved through the owning provider. */
   symbolInfo(symbol) {
     return this.registry?.symbolInfoFor(symbol) ?? Promise.resolve(void 0);
@@ -2917,12 +2953,16 @@ var IndicatorInputsDialog = class {
       closeOnEscape: false,
       footer: (foot) => {
         foot.append(
+          this.resetAction(),
           this.dialogButton("Cancel", false, () => this.revertAndClose()),
           this.dialogButton("Ok", true, () => this.close())
         );
       },
+      // Stale-guard: destroying a dialog fires its machine's onOpenChange(false)
+      // asynchronously — after a reset rebuild that notification must not close
+      // the replacement dialog.
       onOpenChange: (open) => {
-        if (!open) this.close();
+        if (!open && this.uiDialog === ui) this.close();
       }
     });
     applyChromeTokens(ui.panel, t);
@@ -3053,6 +3093,30 @@ var IndicatorInputsDialog = class {
     }
     this.close();
   }
+  /** The footer's reset button — same chip as Cancel, pinned to the LEFT edge
+   *  (`margin-right:auto` against the footer's flex-end keeps Cancel/Ok right). */
+  resetAction() {
+    const b = this.dialogButton("Reset defaults", false, () => this.resetToDefaults());
+    b.style.marginRight = "auto";
+    return b;
+  }
+  /** Restore every input to its declared default (re-running the indicator), then
+   *  re-open the form so each control re-reads the restored values — the same
+   *  rebuild-after-reset move as the chart-settings dialog. The open-time snapshot
+   *  survives the rebuild, so Cancel after a reset still reverts the whole session. */
+  resetToDefaults() {
+    const row = this.row;
+    if (!row) return;
+    const snap = this.snapshot;
+    for (const inp of row.inputs) {
+      if (row.values[inp.key] !== inp.defval) {
+        row.values[inp.key] = inp.defval;
+        this.host.onChange?.({ indicatorId: row.id, key: inp.key, value: inp.defval });
+      }
+    }
+    this.open(row);
+    if (snap) this.snapshot = snap;
+  }
   /** Write one edit through: store it, notify the host, and re-apply the `when` gates. */
   commit(row, key, value) {
     row.values[key] = value;
@@ -14769,6 +14833,11 @@ function resizeSplit(split, dyTotal, minPx = MIN_PANE_PX) {
 }
 
 // src/renderers/native/backdrop/BackdropRenderer.ts
+function clipHighlightRect(x1, x2, left, right) {
+  const x = Math.max(left, x1);
+  const end = Math.min(right, x2);
+  return end > x ? { x, width: end - x } : null;
+}
 var BackdropRenderer = class {
   constructor() {
     this.canvas = null;
@@ -14801,17 +14870,22 @@ var BackdropRenderer = class {
   /** Renderer-owned session highlight bands: full-height (all panes), behind the grid.
    *  Session-zone washes (pre/post-market) paint first, host highlights on top. */
   drawHighlights(ctx, scene, coords) {
-    const bands = [...scene.sessionHighlightBands(), ...scene.highlights];
-    if (bands.length === 0) return;
+    const sessions = scene.sessionHighlightBands();
+    if (sessions.length > 0) {
+      const left = Math.max(0, coords.logicalToX(-0.5));
+      const right = Math.min(coords.width, coords.logicalToX(coords.barCount - 0.5));
+      this.drawHighlightSet(ctx, sessions, coords, left, right);
+    }
+    this.drawHighlightSet(ctx, scene.highlights, coords, 0, coords.width);
+  }
+  drawHighlightSet(ctx, bands, coords, left, right) {
     for (const band of bands) {
       const x1 = coords.timeToX(band.from);
       const x2 = coords.timeToX(band.to);
-      if (x2 < 0 || x1 > coords.width || x2 <= x1) continue;
-      const cx = Math.max(0, x1);
-      const cw = Math.min(coords.width, x2) - cx;
-      if (cw <= 0) continue;
+      const rect = clipHighlightRect(x1, x2, left, right);
+      if (!rect) continue;
       ctx.fillStyle = band.color;
-      ctx.fillRect(cx, 0, cw, coords.height);
+      ctx.fillRect(rect.x, 0, rect.width, coords.height);
     }
   }
   // ── grid ── vert/horz gate on `scene.showGrid` AND their own per-axis visibility

package/dist/chunk-W4EJWLEO.js

@@ -0,0 +1,12 @@
+// src/data/symbol-base.ts
+function baseOf(d) {
+  const fromDesc = d.description?.split("/")[0]?.trim();
+  if (fromDesc) return fromDesc.replace(/\s+Perpetual$/i, "");
+  return d.ticker.replace(/[-_/]?(USDT|USDC|USD1|USDS|BUSD|USD|EUR|PERP)$/i, "") || d.ticker;
+}
+function ledgerCryptoIconUrl(base) {
+  const key = base.trim().toUpperCase();
+  return key ? `https://crypto-icons.ledger.com/${encodeURIComponent(key)}.png` : void 0;
+}
+
+export { baseOf, ledgerCryptoIconUrl };

package/dist/{contributions-BqCIsbaP.d.ts → contributions-DLLdV9jD.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.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-JJq7M2it.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';
 
 /**
  * A strategy's broker state at ONE bar — the flat summary a host reads while a script
@@ -361,6 +361,10 @@ declare class DataControl {
     providerInstance(name: string): DataProvider | undefined;
     /** Indexed symbols for one provider (or all) — for autocomplete. */
     symbols(provider?: string): SymbolDescriptor[];
+    /** The icon URL for `symbol` — its owning provider's `resolveSymbolIcon`, routed
+     *  through resolution. Undefined while unresolvable, when the provider declares no
+     *  resolver, or on a custom `deps.dataFeed` — the shells then show initials. */
+    symbolIcon(symbol: string): string | undefined;
     /** Per-symbol metadata (Pine `syminfo.*`), resolved through the owning provider. */
     symbolInfo(symbol: string): Promise<SymbolInfo | undefined>;
     /**
@@ -1435,6 +1439,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;
@@ -1481,9 +1489,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
@@ -1577,7 +1594,24 @@ declare function registerSidePanel(desc: SidePanelDescriptor): () => void;
 declare function unregisterSidePanel(id: string): void;
 /** Every registered side panel, `order`-sorted (registration order breaks ties). */
 declare function sidePanels(): SidePanelDescriptor[];
-/** Register (or replace) a widget action. Widgets read the registry live. */
+/** The built-in topbar slots a contributed action may TAKE OVER by registering under
+ *  their id — the "simple button" slots. The composites (symbol, timeframes, style,
+ *  layout, undo-redo, alerts, panels) are stateful controls the shell pushes state
+ *  into; a plain `{label, icon, run}` descriptor cannot stand in for them. */
+declare const OVERRIDABLE_TOPBAR_IDS: readonly ["indicators", "screenshot"];
+/**
+ * The action OVERRIDING a built-in topbar slot, if one is registered — an action whose
+ * `id` IS the built-in id. An override takes the slot's WHOLE surface: the desktop
+ * button (at the slot's position), the mobile counterpart, and the keyboard chord all
+ * route to `run`, and the native machinery behind the slot (the built-in indicator
+ * picker) is not constructed. Shells resolve this at construction — register at import
+ * time, like every contribution.
+ */
+declare function topbarActionOverride(id: string): WidgetActionDescriptor | undefined;
+/** Register (or replace) a widget action. Widgets read the registry live.
+ *  Registering under a RESERVED built-in topbar id (`'indicators'`, `'screenshot'`)
+ *  OVERRIDES that slot — see {@link topbarActionOverride}. Built-in ids that are
+ *  stateful composites cannot be overridden and the registration is refused. */
 declare function registerWidgetAction(desc: WidgetActionDescriptor): () => void;
 declare function unregisterWidgetAction(id: string): void;
 /** Actions for one target, `order`-sorted, `when`-filtered when a context is given. */
@@ -1669,6 +1703,28 @@ declare function unregisterStatePersistence(key: string): void;
 declare function statePersistenceHandlers<S extends StatePersistenceHandler['scope']>(scope: S): Array<Extract<StatePersistenceHandler, {
     scope: S;
 }>>;
+/**
+ * Reorder the symbol picker's AGGREGATED pool — every source combined, exactly what
+ * the search dialog displays. Called when the pool changes (a provider's index lands
+ * or refreshes), NOT per keystroke: the picker caches the result. May be async (a
+ * server-fetched top list) — the picker shows the current order and refreshes when
+ * the promise resolves.
+ *
+ * The returned list may INJECT descriptors absent from the pool (they must carry
+ * their `provider` and be genuinely servable, or selecting them parks the load) and
+ * may OMIT entries (hiding them). The picker dedupes by venue+ticker, FIRST
+ * occurrence winning — injecting at the head fixes both position and display data.
+ *
+ * While a ranking is registered, the picker's built-in empty-query pin (the hardcoded
+ * majors) stands down: the head of YOUR list is the dialog's opening screen. Under a
+ * typed query the relevance tiers still lead — the ranking orders within each tier.
+ */
+type SymbolRankingHook = (pool: SymbolDescriptor[]) => SymbolDescriptor[] | Promise<SymbolDescriptor[]>;
+/** Register (or replace — ONE ranking at a time, last wins) the symbol ranking.
+ *  Returns an unregister disposer. Register at import time, like every contribution. */
+declare function registerSymbolRanking(hook: SymbolRankingHook): () => void;
+/** The registered ranking, if any — what the shells' symbol picker consults. */
+declare function symbolRanking(): SymbolRankingHook | undefined;
 /** Makes ONE engine instance for ONE chart — engines hold per-chart sessions (and
  *  possibly a worker), so the shell calls the factory per chart build, never shares. */
 type EngineFactory = () => ScriptingEngine;
@@ -1686,4 +1742,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 WidgetAttachment 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, type StrategyState as O, type ParsedSymbol as P, type StrategyTrade as Q, type Resolved as R, type ScriptingEngine as S, TypedEventBus as T, type VelaDeps as U, Vela as V, type WidgetContext as W, type VelaEventMap as X, type VisibleBarRange as Y, type WidgetActionDescriptor as Z, type WidgetActionTarget as _, type ScriptRun as a, getNativeIndicator as a0, legendActions as a1, nativeIndicatorDescriptors as a2, nativeIndicatorTypes as a3, registerDefaultEngine as a4, registerLegendAction as a5, registerNativeIndicator as a6, registerSidePanel as a7, registerStatePersistence as a8, registerWidgetAction as a9, registerWidgetAttachment as aa, resolveEngines as ab, sidePanels as ac, statePersistenceHandlers as ad, unregisterDefaultEngine as ae, unregisterLegendAction as af, unregisterNativeIndicator as ag, unregisterSidePanel as ah, unregisterStatePersistence as ai, unregisterWidgetAction as aj, unregisterWidgetAttachment as ak, widgetActions as al, widgetAttachments as am, DEFAULT_PANEL_ORDER as an, 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 { 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 };

package/dist/{contributions-DNMqrAuw.d.cts → contributions-Vw-Hm58R.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.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-DDUYw2qP.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';
 
 /**
  * A strategy's broker state at ONE bar — the flat summary a host reads while a script
@@ -361,6 +361,10 @@ declare class DataControl {
     providerInstance(name: string): DataProvider | undefined;
     /** Indexed symbols for one provider (or all) — for autocomplete. */
     symbols(provider?: string): SymbolDescriptor[];
+    /** The icon URL for `symbol` — its owning provider's `resolveSymbolIcon`, routed
+     *  through resolution. Undefined while unresolvable, when the provider declares no
+     *  resolver, or on a custom `deps.dataFeed` — the shells then show initials. */
+    symbolIcon(symbol: string): string | undefined;
     /** Per-symbol metadata (Pine `syminfo.*`), resolved through the owning provider. */
     symbolInfo(symbol: string): Promise<SymbolInfo | undefined>;
     /**
@@ -1435,6 +1439,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;
@@ -1481,9 +1489,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
@@ -1577,7 +1594,24 @@ declare function registerSidePanel(desc: SidePanelDescriptor): () => void;
 declare function unregisterSidePanel(id: string): void;
 /** Every registered side panel, `order`-sorted (registration order breaks ties). */
 declare function sidePanels(): SidePanelDescriptor[];
-/** Register (or replace) a widget action. Widgets read the registry live. */
+/** The built-in topbar slots a contributed action may TAKE OVER by registering under
+ *  their id — the "simple button" slots. The composites (symbol, timeframes, style,
+ *  layout, undo-redo, alerts, panels) are stateful controls the shell pushes state
+ *  into; a plain `{label, icon, run}` descriptor cannot stand in for them. */
+declare const OVERRIDABLE_TOPBAR_IDS: readonly ["indicators", "screenshot"];
+/**
+ * The action OVERRIDING a built-in topbar slot, if one is registered — an action whose
+ * `id` IS the built-in id. An override takes the slot's WHOLE surface: the desktop
+ * button (at the slot's position), the mobile counterpart, and the keyboard chord all
+ * route to `run`, and the native machinery behind the slot (the built-in indicator
+ * picker) is not constructed. Shells resolve this at construction — register at import
+ * time, like every contribution.
+ */
+declare function topbarActionOverride(id: string): WidgetActionDescriptor | undefined;
+/** Register (or replace) a widget action. Widgets read the registry live.
+ *  Registering under a RESERVED built-in topbar id (`'indicators'`, `'screenshot'`)
+ *  OVERRIDES that slot — see {@link topbarActionOverride}. Built-in ids that are
+ *  stateful composites cannot be overridden and the registration is refused. */
 declare function registerWidgetAction(desc: WidgetActionDescriptor): () => void;
 declare function unregisterWidgetAction(id: string): void;
 /** Actions for one target, `order`-sorted, `when`-filtered when a context is given. */
@@ -1669,6 +1703,28 @@ declare function unregisterStatePersistence(key: string): void;
 declare function statePersistenceHandlers<S extends StatePersistenceHandler['scope']>(scope: S): Array<Extract<StatePersistenceHandler, {
     scope: S;
 }>>;
+/**
+ * Reorder the symbol picker's AGGREGATED pool — every source combined, exactly what
+ * the search dialog displays. Called when the pool changes (a provider's index lands
+ * or refreshes), NOT per keystroke: the picker caches the result. May be async (a
+ * server-fetched top list) — the picker shows the current order and refreshes when
+ * the promise resolves.
+ *
+ * The returned list may INJECT descriptors absent from the pool (they must carry
+ * their `provider` and be genuinely servable, or selecting them parks the load) and
+ * may OMIT entries (hiding them). The picker dedupes by venue+ticker, FIRST
+ * occurrence winning — injecting at the head fixes both position and display data.
+ *
+ * While a ranking is registered, the picker's built-in empty-query pin (the hardcoded
+ * majors) stands down: the head of YOUR list is the dialog's opening screen. Under a
+ * typed query the relevance tiers still lead — the ranking orders within each tier.
+ */
+type SymbolRankingHook = (pool: SymbolDescriptor[]) => SymbolDescriptor[] | Promise<SymbolDescriptor[]>;
+/** Register (or replace — ONE ranking at a time, last wins) the symbol ranking.
+ *  Returns an unregister disposer. Register at import time, like every contribution. */
+declare function registerSymbolRanking(hook: SymbolRankingHook): () => void;
+/** The registered ranking, if any — what the shells' symbol picker consults. */
+declare function symbolRanking(): SymbolRankingHook | undefined;
 /** Makes ONE engine instance for ONE chart — engines hold per-chart sessions (and
  *  possibly a worker), so the shell calls the factory per chart build, never shares. */
 type EngineFactory = () => ScriptingEngine;
@@ -1686,4 +1742,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 WidgetAttachment 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, type StrategyState as O, type ParsedSymbol as P, type StrategyTrade as Q, type Resolved as R, type ScriptingEngine as S, TypedEventBus as T, type VelaDeps as U, Vela as V, type WidgetContext as W, type VelaEventMap as X, type VisibleBarRange as Y, type WidgetActionDescriptor as Z, type WidgetActionTarget as _, type ScriptRun as a, getNativeIndicator as a0, legendActions as a1, nativeIndicatorDescriptors as a2, nativeIndicatorTypes as a3, registerDefaultEngine as a4, registerLegendAction as a5, registerNativeIndicator as a6, registerSidePanel as a7, registerStatePersistence as a8, registerWidgetAction as a9, registerWidgetAttachment as aa, resolveEngines as ab, sidePanels as ac, statePersistenceHandlers as ad, unregisterDefaultEngine as ae, unregisterLegendAction as af, unregisterNativeIndicator as ag, unregisterSidePanel as ah, unregisterStatePersistence as ai, unregisterWidgetAction as aj, unregisterWidgetAttachment as ak, widgetActions as al, widgetAttachments as am, DEFAULT_PANEL_ORDER as an, 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 { 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 };

package/dist/index.cjs

@@ -7091,6 +7091,28 @@ var ProviderRegistry = class {
     const d = this.entries.get(resolved.provider)?.byTicker?.get(normTicker(resolved.ticker));
     return `${d?.prefix ?? resolved.provider}:${d?.ticker ?? resolved.ticker}`;
   }
+  /** The icon URL for a DESCRIPTOR — routed to its OWNING provider's resolver (the
+   *  provider owns the knowledge of where its asset class's icons live). A missing
+   *  provider, an absent resolver, or a resolver that throws all mean "no icon" —
+   *  the shells' initials badge takes over, never an error. */
+  symbolIconOf(d) {
+    const name = d.provider ? normName(d.provider) : [...this.entries.keys()][0];
+    const entry = name !== void 0 ? this.entries.get(name) : void 0;
+    try {
+      return entry?.provider.resolveSymbolIcon?.(d) ?? void 0;
+    } catch {
+      return void 0;
+    }
+  }
+  /** The icon URL for a raw SYMBOL string (the statusline/object-tree path): resolve
+   *  to the owning provider, find its descriptor, route to the resolver. Before the
+   *  index settles (or for a lenient sole-provider resolution) a minimal synthetic
+   *  descriptor is offered — crypto resolvers can answer from the ticker alone. */
+  symbolIcon(resolved) {
+    if (!resolved) return void 0;
+    const d = this.entries.get(resolved.provider)?.byTicker?.get(normTicker(resolved.ticker));
+    return this.symbolIconOf({ ...d ?? { ticker: resolved.ticker }, provider: d?.provider ?? resolved.provider });
+  }
   /** Indexed symbols for one provider (or all, concatenated) — for autocomplete. */
   symbolsOf(rawName) {
     if (rawName != null) return this.entries.get(normName(rawName))?.descriptors ?? [];
@@ -9311,6 +9333,14 @@ var MultiProviderFeed = class {
   providerInstance(name) {
     return this.registry.get(name);
   }
+  /** The icon URL for a DESCRIPTOR — its owning provider's `resolveSymbolIcon` (picker rows). */
+  symbolIconOf(d) {
+    return this.registry.symbolIconOf(d);
+  }
+  /** The icon URL for a raw SYMBOL string — resolve, then route (statusline, object tree). */
+  symbolIcon(raw) {
+    return this.registry.symbolIcon(this.resolveSymbol(raw));
+  }
   symbols(name) {
     return this.registry.symbolsOf(name);
   }
@@ -9537,6 +9567,12 @@ var DataControl = class {
   symbols(provider) {
     return this.registry?.symbols(provider) ?? [];
   }
+  /** The icon URL for `symbol` — its owning provider's `resolveSymbolIcon`, routed
+   *  through resolution. Undefined while unresolvable, when the provider declares no
+   *  resolver, or on a custom `deps.dataFeed` — the shells then show initials. */
+  symbolIcon(symbol) {
+    return this.registry?.symbolIcon(symbol);
+  }
   /** Per-symbol metadata (Pine `syminfo.*`), resolved through the owning provider. */
   symbolInfo(symbol) {
     return this.registry?.symbolInfoFor(symbol) ?? Promise.resolve(void 0);
@@ -12564,12 +12600,16 @@ var IndicatorInputsDialog = class {
       closeOnEscape: false,
       footer: (foot) => {
         foot.append(
+          this.resetAction(),
           this.dialogButton("Cancel", false, () => this.revertAndClose()),
           this.dialogButton("Ok", true, () => this.close())
         );
       },
+      // Stale-guard: destroying a dialog fires its machine's onOpenChange(false)
+      // asynchronously — after a reset rebuild that notification must not close
+      // the replacement dialog.
       onOpenChange: (open2) => {
-        if (!open2) this.close();
+        if (!open2 && this.uiDialog === ui) this.close();
       }
     });
     applyChromeTokens(ui.panel, t);
@@ -12700,6 +12740,30 @@ var IndicatorInputsDialog = class {
     }
     this.close();
   }
+  /** The footer's reset button — same chip as Cancel, pinned to the LEFT edge
+   *  (`margin-right:auto` against the footer's flex-end keeps Cancel/Ok right). */
+  resetAction() {
+    const b = this.dialogButton("Reset defaults", false, () => this.resetToDefaults());
+    b.style.marginRight = "auto";
+    return b;
+  }
+  /** Restore every input to its declared default (re-running the indicator), then
+   *  re-open the form so each control re-reads the restored values — the same
+   *  rebuild-after-reset move as the chart-settings dialog. The open-time snapshot
+   *  survives the rebuild, so Cancel after a reset still reverts the whole session. */
+  resetToDefaults() {
+    const row = this.row;
+    if (!row) return;
+    const snap = this.snapshot;
+    for (const inp of row.inputs) {
+      if (row.values[inp.key] !== inp.defval) {
+        row.values[inp.key] = inp.defval;
+        this.host.onChange?.({ indicatorId: row.id, key: inp.key, value: inp.defval });
+      }
+    }
+    this.open(row);
+    if (snap) this.snapshot = snap;
+  }
   /** Write one edit through: store it, notify the host, and re-apply the `when` gates. */
   commit(row, key, value) {
     row.values[key] = value;
@@ -25130,6 +25194,11 @@ function resizeSplit(split, dyTotal, minPx = MIN_PANE_PX) {
 }
 
 // src/renderers/native/backdrop/BackdropRenderer.ts
+function clipHighlightRect(x1, x2, left, right) {
+  const x = Math.max(left, x1);
+  const end = Math.min(right, x2);
+  return end > x ? { x, width: end - x } : null;
+}
 var BackdropRenderer = class {
   constructor() {
     this.canvas = null;
@@ -25162,17 +25231,22 @@ var BackdropRenderer = class {
   /** Renderer-owned session highlight bands: full-height (all panes), behind the grid.
    *  Session-zone washes (pre/post-market) paint first, host highlights on top. */
   drawHighlights(ctx, scene, coords) {
-    const bands = [...scene.sessionHighlightBands(), ...scene.highlights];
-    if (bands.length === 0) return;
+    const sessions = scene.sessionHighlightBands();
+    if (sessions.length > 0) {
+      const left = Math.max(0, coords.logicalToX(-0.5));
+      const right = Math.min(coords.width, coords.logicalToX(coords.barCount - 0.5));
+      this.drawHighlightSet(ctx, sessions, coords, left, right);
+    }
+    this.drawHighlightSet(ctx, scene.highlights, coords, 0, coords.width);
+  }
+  drawHighlightSet(ctx, bands, coords, left, right) {
     for (const band of bands) {
       const x1 = coords.timeToX(band.from);
       const x2 = coords.timeToX(band.to);
-      if (x2 < 0 || x1 > coords.width || x2 <= x1) continue;
-      const cx = Math.max(0, x1);
-      const cw = Math.min(coords.width, x2) - cx;
-      if (cw <= 0) continue;
+      const rect = clipHighlightRect(x1, x2, left, right);
+      if (!rect) continue;
       ctx.fillStyle = band.color;
-      ctx.fillRect(cx, 0, cw, coords.height);
+      ctx.fillRect(rect.x, 0, rect.width, coords.height);
     }
   }
   // ── grid ── vert/horz gate on `scene.showGrid` AND their own per-axis visibility
@@ -29588,6 +29662,9 @@ function resolveElement(container) {
   return element;
 }
 
+// src/widget/topbar-composition.ts
+var TOPBAR_BUILTIN_IDS = ["symbol", "timeframes", "style", "layout", "indicators", "actions", "undo-redo", "alerts", "panels", "screenshot"];
+
 // src/widget/contributions.ts
 var registry4 = /* @__PURE__ */ new Map();
 var attachments = /* @__PURE__ */ new Map();
@@ -29617,7 +29694,18 @@ function unregisterSidePanel(id) {
 function sidePanels() {
   return [...panels.values()].sort((a, b) => (a.order ?? DEFAULT_PANEL_ORDER) - (b.order ?? DEFAULT_PANEL_ORDER));
 }
+var OVERRIDABLE_TOPBAR_IDS = ["indicators", "screenshot"];
+var overridableSet = new Set(OVERRIDABLE_TOPBAR_IDS);
+var builtinTopbarSet = new Set(TOPBAR_BUILTIN_IDS);
+function topbarActionOverride(id) {
+  if (!overridableSet.has(id)) return void 0;
+  return registry4.get(id);
+}
 function registerWidgetAction(desc) {
+  if (builtinTopbarSet.has(desc.id) && !overridableSet.has(desc.id)) {
+    console.warn(`[vela] widget action "${desc.id}": this built-in topbar slot is a stateful control and cannot be overridden \u2014 ignored. Overridable slots: ${OVERRIDABLE_TOPBAR_IDS.join(", ")}.`);
+    return () => void 0;
+  }
   registry4.set(desc.id, desc);
   return () => {
     if (registry4.get(desc.id) === desc) registry4.delete(desc.id);
@@ -29657,6 +29745,16 @@ function unregisterStatePersistence(key) {
 function statePersistenceHandlers(scope) {
   return [...stateHandlers.values()].filter((h) => h.scope === scope);
 }
+var symbolRankingHook;
+function registerSymbolRanking(hook) {
+  symbolRankingHook = hook;
+  return () => {
+    if (symbolRankingHook === hook) symbolRankingHook = void 0;
+  };
+}
+function symbolRanking() {
+  return symbolRankingHook;
+}
 var defaultEngines = /* @__PURE__ */ new Map();
 function registerDefaultEngine(language, make) {
   defaultEngines.set(language, make);
@@ -29713,6 +29811,7 @@ exports.MARKER = MARKER;
 exports.MultiProviderFeed = MultiProviderFeed;
 exports.NEUTRAL = NEUTRAL;
 exports.NativeRenderer = NativeRenderer;
+exports.OVERRIDABLE_TOPBAR_IDS = OVERRIDABLE_TOPBAR_IDS;
 exports.RendererControl = RendererControl;
 exports.SERIES_LINE = SERIES_LINE;
 exports.SESSION_OFF = SESSION_OFF;
@@ -29754,6 +29853,7 @@ exports.registerRendererDefaults = registerRendererDefaults;
 exports.registerRendererLayer = registerRendererLayer;
 exports.registerSidePanel = registerSidePanel;
 exports.registerStatePersistence = registerStatePersistence;
+exports.registerSymbolRanking = registerSymbolRanking;
 exports.registerWidgetAction = registerWidgetAction;
 exports.registerWidgetAttachment = registerWidgetAttachment;
 exports.rendererDefaults = rendererDefaults;
@@ -29765,8 +29865,10 @@ exports.sharedBarStore = sharedBarStore;
 exports.sidePanels = sidePanels;
 exports.stableSeriesId = stableSeriesId;
 exports.statePersistenceHandlers = statePersistenceHandlers;
+exports.symbolRanking = symbolRanking;
 exports.tickerModifierIds = tickerModifierIds;
 exports.timeframeToMs = timeframeToMs;
+exports.topbarActionOverride = topbarActionOverride;
 exports.unregisterChartType = unregisterChartType;
 exports.unregisterDefaultEngine = unregisterDefaultEngine;
 exports.unregisterLegendAction = unregisterLegendAction;