@luxalgo/vela 0.6.6 → 0.6.8

package/dist/{bottombar-COnL2Sk4.d.ts → statusline-CGkB2EOo.d.ts}

@@ -1,5 +1,5 @@
-import { D as DataProvider } from './DataProvider-JJq7M2it.js';
-import { S as ScriptingEngine, V as Vela } from './contributions-BqCIsbaP.js';
+import { D as DataProvider } from './DataProvider-BSLlBpB9.js';
+import { S as ScriptingEngine, V as Vela } from './contributions-DLLdV9jD.js';
 import { V as VisibleRangePreset } from './options-BaVTMXaO.js';
 
 /** The linkable dimensions. `crosshair` mirrors the pointer time onto same-group
@@ -8,8 +8,10 @@ import { V as VisibleRangePreset } from './options-BaVTMXaO.js';
  *  same-group cells and keeps the set linked: edits and removals of any member
  *  follow. Link membership is session-scoped and survives a toggle-off (re-enabling
  *  resumes edit/delete for drawings paired earlier; drawings created while off stay
- *  independent). After a reload, every drawing is unpaired again. */
-type SyncKind = 'viewport' | 'symbol' | 'timeframe' | 'crosshair' | 'drawings';
+ *  independent). After a reload, every drawing is unpaired again. `style` mirrors
+ *  the chart's presentation settings — the Canvas and Scales-and-lines slice of the
+ *  renderer config plus the status-line display prefs — onto same-group cells. */
+type SyncKind = 'viewport' | 'symbol' | 'timeframe' | 'crosshair' | 'drawings' | 'style';
 /**
  * One link's configuration: `false`/absent = off; `true` = ALL cells linked (one
  * implicit group); a record maps cell id → group name, and only cells sharing a group
@@ -22,6 +24,7 @@ interface SyncOptions {
     timeframe?: SyncSetting;
     crosshair?: SyncSetting;
     drawings?: SyncSetting;
+    style?: SyncSetting;
 }
 /** Splitter track weights along each grid axis. */
 interface TrackSizes {
@@ -172,6 +175,37 @@ type WidgetStorage = VelaStorage;
  */
 declare function localStorageAdapter(storageKey?: string): WidgetStorage;
 
+/** The host-facing option: visible entries per side, in render order. An undeclared
+ *  side falls back to its default list. */
+interface TopbarComposition {
+    left?: readonly string[];
+    right?: readonly string[];
+}
+/** The built-in entry vocabulary (everything else in a list is a contributed-action id).
+ *  `'layout'` renders only on multi-chart shells and `'indicators'` only while an
+ *  indicator surface exists — the built-in picker (the deprecated `indicatorPicker:
+ *  false` still removes it) or a slot OVERRIDE replacing it — so listing them is
+ *  necessary but not sufficient. */
+declare const TOPBAR_BUILTIN_IDS: readonly ["symbol", "timeframes", "style", "layout", "indicators", "actions", "undo-redo", "alerts", "panels", "screenshot"];
+/** The default left side — the current shell composition, verbatim. */
+declare const TOPBAR_DEFAULT_LEFT: readonly string[];
+/** The default right side (the `margin-left: auto` cluster). */
+declare const TOPBAR_DEFAULT_RIGHT: readonly string[];
+/** A composition with both sides resolved (defaults applied, duplicates dropped). */
+interface ResolvedTopbarComposition {
+    left: string[];
+    right: string[];
+}
+/** Resolve the host option: absent side ⇒ its default list; a duplicated id keeps its
+ *  FIRST occurrence (left before right) so an entry never renders twice. `'actions'`
+ *  is the exception — it is a flow SLOT each side legitimately owns (the defaults
+ *  carry one on both), so it dedupes per side only. */
+declare function resolveTopbarComposition(opt?: TopbarComposition): ResolvedTopbarComposition;
+/** Whether an entry id is visible anywhere in the resolved composition. */
+declare function topbarHas(comp: ResolvedTopbarComposition, id: string): boolean;
+/** The non-built-in entries — contributed-action ids PINNED to a list position. */
+declare function pinnedTopbarActionIds(comp: ResolvedTopbarComposition): string[];
+
 /** What a shell (widget or workspace) accepts BEYOND the chart options themselves. */
 interface VelaShellOptions {
     /** Provider factories, keyed by provider name. The shell owns the call cycle: the
@@ -197,10 +231,25 @@ interface VelaShellOptions {
     statusline?: boolean;
     watermark?: boolean;
     bottombar?: boolean;
+    /** Declarative topbar composition: `{ left, right }` lists of the VISIBLE entries,
+     *  in render order — built-in ids (`'symbol'`, `'timeframes'`, `'style'`,
+     *  `'layout'`, `'indicators'`, `'actions'`, `'undo-redo'`, `'alerts'`, `'panels'`,
+     *  `'screenshot'`) and/or contributed-action ids (naming one PINS it there,
+     *  overriding its `align`/`order`; `'actions'` is where the unlisted ones flow).
+     *  An undeclared side keeps its default. An explicit list is that side's complete
+     *  contract — it also FREEZES it: chrome a future release adds will not appear.
+     *  Hiding a built-in removes its mobile entry and keyboard chord too (`mod+alt+S`
+     *  for `'screenshot'`); Ctrl+Z / Ctrl+Y stay — they belong to editing, not to the
+     *  `'undo-redo'` buttons. */
+    topbar?: TopbarComposition;
     /** The built-in indicator picker's entry points — the topbar button, the mobile-bar
-     *  item, and the `/` shortcut. `false` removes them, for hosts that replace the
-     *  picker with their own indicator UI (e.g. a contributed topbar action opening a
-     *  custom dialog). The `indicators` manifest still resolves and auto-adds. */
+     *  item, and the `/` shortcut. `false` removes them. The `indicators` manifest
+     *  still resolves and auto-adds.
+     *  @deprecated Removed in 0.7.0. To HIDE the built-in surface, omit `'indicators'`
+     *  from `topbar.left` (same effect: no button, no mobile stop, no `/`, no dialog).
+     *  To REPLACE it, a plugin registers its action under the id `'indicators'`
+     *  (`registerWidgetAction`) — the override takes the slot's whole surface and
+     *  needs no shell option at all. */
     indicatorPicker?: boolean;
     /** Chrome size class. `'auto'` (default) follows the CONTAINER width plus a
      *  coarse-pointer heuristic; `'mobile'` / `'desktop'` pin it. Mobile swaps the
@@ -315,4 +364,84 @@ declare class Bottombar {
     private tick;
 }
 
-export { Bottombar as B, type CellState as C, type IndicatorLoader as I, type PanelsState as P, type ResolvedIndicator as R, type SyncSetting as S, type TrackSizes as T, type VelaStorage as V, WidgetHistory as W, type RangePreset as a, type VelaShellOptions as b, type SyncOptions as c, type SyncKind as d, type WorkspaceState as e, type ChartState as f, decodeState as g, encodeState as h, type BottombarOptions as i, type IndicatorManifest as j, type IndicatorManifestEntry as k, RANGE_PRESETS as l, type WidgetStorage as m, localStorageAdapter as n, resolveIndicators as r, sanitizeState as s };
+/** How the status line reads a bar out: the four O/H/L/C values (bar-shaped styles),
+ *  or the single plotted value — the close — for one-line styles (line/area/baseline). */
+type StatuslineReadout = 'ohlc' | 'value';
+/** The market session states the status badge can wear. Crypto venues trade
+ *  continuously and stay 'open'; the full vocabulary is ready for providers that
+ *  carry a session model (equities RTH/ETH, exchange holidays). */
+type MarketStatus = 'open' | 'pre' | 'post' | 'closed' | 'holiday';
+/** The status line's toggleable segments (the settings dialog's Status line tab). */
+type StatuslinePart = 'name' | 'market' | 'ohlc' | 'change';
+declare class Statusline {
+    private readonly host;
+    /** The avatar's icon URL for a raw symbol — the shell routes it to the owning
+     *  provider's `resolveSymbolIcon`. Absent ⇒ the initials badge. */
+    private readonly iconFor?;
+    readonly el: HTMLElement;
+    private readonly ohlcEl;
+    private readonly changeEl;
+    private readonly symbolEl;
+    private readonly marketEl;
+    private marketTip;
+    private avatarEl;
+    private metaEl;
+    private readonly parts;
+    private lastBar;
+    private hoverBar;
+    private unsubs;
+    /** Up/down ink for the OHLC + change values — the ACTIVE price style's configured
+     *  colors (candle bodies, bar ticks, the line color, …); null falls back to the theme
+     *  tokens. `isUp` overrides the close-vs-open direction rule where the style paints by
+     *  something else (baseline: position against the baseline price). */
+    private upColor;
+    private downColor;
+    private isUp;
+    /** 'ohlc' for bar-shaped styles; 'value' (the single plotted close) for line styles. */
+    private readout;
+    /** Fit mode (multi-chart cells): one row, overflowing segments hidden — see {@link setFitMode}. */
+    private fitMode;
+    private fitRO;
+    constructor(host: HTMLElement, symbol: string, 
+    /** The avatar's icon URL for a raw symbol — the shell routes it to the owning
+     *  provider's `resolveSymbolIcon`. Absent ⇒ the initials badge. */
+    iconFor?: ((symbol: string) => string | undefined) | undefined);
+    setSymbol(symbol: string): void;
+    /**
+     * Multi-chart cells: keep the line on ONE row whatever the cell width — never wrap.
+     * Segments that don't fit are hidden outright rather than clipped mid-glyph, least
+     * important first: OHLC, then the bar change, the venue/timeframe meta, and the
+     * market badge; the logo + ticker always stay. Re-fits live on host resizes.
+     */
+    setFitMode(on: boolean): void;
+    /** Project the parts config onto the segments (the baseline fit() prunes from). */
+    private syncParts;
+    /** Hide overflowing segments until the row fits its max-width (fit mode only). */
+    private fit;
+    /** Shape + color the value readout after the active price style: its own up/down
+     *  colors (candle bodies, bar ticks, the line color, …), the direction rule that
+     *  picks between them (`isUp` replaces close-vs-open where the style paints by
+     *  something else — baseline by position), and whether the readout is the four
+     *  O/H/L/C values or the single plotted value (one-line styles). Null colors fall
+     *  back to the theme's up/down tokens. See {@link statuslineInkOf}, which derives
+     *  all of it from the live renderer. */
+    setDirectionColors(up: string | null, down: string | null, isUp?: ((bar: {
+        open: number;
+        close: number;
+    }) => boolean) | null, readout?: StatuslineReadout): void;
+    /** Show/hide one part (the settings dialog's Status line tab drives these). */
+    /** The "· BINANCE · 1h" segment after the symbol — venue first, then resolution. */
+    setMeta(timeframe: string, provider: string): void;
+    /** Dress the market badge for a session state: its icon, tinted circle, and the
+     *  hover label. Callers with no session model leave the constructor's 'open'. */
+    setMarketStatus(status: MarketStatus): void;
+    setPartVisible(part: StatuslinePart, visible: boolean): void;
+    partVisible(part: StatuslinePart): boolean;
+    /** (Re)bind to a chart instance — called after every widget rebuild. */
+    onChart(chart: Vela): void;
+    destroy(): void;
+    private detach;
+    private render;
+}
+
+export { Bottombar as B, type CellState as C, type IndicatorLoader as I, type PanelsState as P, type ResolvedIndicator as R, type SyncSetting as S, type TrackSizes as T, type VelaStorage as V, WidgetHistory as W, type StatuslinePart as a, type RangePreset as b, type VelaShellOptions as c, type SyncOptions as d, type SyncKind as e, type WorkspaceState as f, type ChartState as g, decodeState as h, encodeState as i, type TopbarComposition as j, type BottombarOptions as k, type IndicatorManifest as l, type IndicatorManifestEntry as m, RANGE_PRESETS as n, type ResolvedTopbarComposition as o, Statusline as p, TOPBAR_BUILTIN_IDS as q, TOPBAR_DEFAULT_LEFT as r, sanitizeState as s, TOPBAR_DEFAULT_RIGHT as t, type WidgetStorage as u, localStorageAdapter as v, pinnedTopbarActionIds as w, resolveIndicators as x, resolveTopbarComposition as y, topbarHas as z };

package/dist/{bottombar-DeDXbF_K.d.cts → statusline-DqzBqy42.d.cts}

@@ -1,5 +1,5 @@
-import { D as DataProvider } from './DataProvider-DDUYw2qP.cjs';
-import { S as ScriptingEngine, V as Vela } from './contributions-DNMqrAuw.cjs';
+import { D as DataProvider } from './DataProvider-BsQM2WNH.cjs';
+import { S as ScriptingEngine, V as Vela } from './contributions-Vw-Hm58R.cjs';
 import { V as VisibleRangePreset } from './options-BaVTMXaO.cjs';
 
 /** The linkable dimensions. `crosshair` mirrors the pointer time onto same-group
@@ -8,8 +8,10 @@ import { V as VisibleRangePreset } from './options-BaVTMXaO.cjs';
  *  same-group cells and keeps the set linked: edits and removals of any member
  *  follow. Link membership is session-scoped and survives a toggle-off (re-enabling
  *  resumes edit/delete for drawings paired earlier; drawings created while off stay
- *  independent). After a reload, every drawing is unpaired again. */
-type SyncKind = 'viewport' | 'symbol' | 'timeframe' | 'crosshair' | 'drawings';
+ *  independent). After a reload, every drawing is unpaired again. `style` mirrors
+ *  the chart's presentation settings — the Canvas and Scales-and-lines slice of the
+ *  renderer config plus the status-line display prefs — onto same-group cells. */
+type SyncKind = 'viewport' | 'symbol' | 'timeframe' | 'crosshair' | 'drawings' | 'style';
 /**
  * One link's configuration: `false`/absent = off; `true` = ALL cells linked (one
  * implicit group); a record maps cell id → group name, and only cells sharing a group
@@ -22,6 +24,7 @@ interface SyncOptions {
     timeframe?: SyncSetting;
     crosshair?: SyncSetting;
     drawings?: SyncSetting;
+    style?: SyncSetting;
 }
 /** Splitter track weights along each grid axis. */
 interface TrackSizes {
@@ -172,6 +175,37 @@ type WidgetStorage = VelaStorage;
  */
 declare function localStorageAdapter(storageKey?: string): WidgetStorage;
 
+/** The host-facing option: visible entries per side, in render order. An undeclared
+ *  side falls back to its default list. */
+interface TopbarComposition {
+    left?: readonly string[];
+    right?: readonly string[];
+}
+/** The built-in entry vocabulary (everything else in a list is a contributed-action id).
+ *  `'layout'` renders only on multi-chart shells and `'indicators'` only while an
+ *  indicator surface exists — the built-in picker (the deprecated `indicatorPicker:
+ *  false` still removes it) or a slot OVERRIDE replacing it — so listing them is
+ *  necessary but not sufficient. */
+declare const TOPBAR_BUILTIN_IDS: readonly ["symbol", "timeframes", "style", "layout", "indicators", "actions", "undo-redo", "alerts", "panels", "screenshot"];
+/** The default left side — the current shell composition, verbatim. */
+declare const TOPBAR_DEFAULT_LEFT: readonly string[];
+/** The default right side (the `margin-left: auto` cluster). */
+declare const TOPBAR_DEFAULT_RIGHT: readonly string[];
+/** A composition with both sides resolved (defaults applied, duplicates dropped). */
+interface ResolvedTopbarComposition {
+    left: string[];
+    right: string[];
+}
+/** Resolve the host option: absent side ⇒ its default list; a duplicated id keeps its
+ *  FIRST occurrence (left before right) so an entry never renders twice. `'actions'`
+ *  is the exception — it is a flow SLOT each side legitimately owns (the defaults
+ *  carry one on both), so it dedupes per side only. */
+declare function resolveTopbarComposition(opt?: TopbarComposition): ResolvedTopbarComposition;
+/** Whether an entry id is visible anywhere in the resolved composition. */
+declare function topbarHas(comp: ResolvedTopbarComposition, id: string): boolean;
+/** The non-built-in entries — contributed-action ids PINNED to a list position. */
+declare function pinnedTopbarActionIds(comp: ResolvedTopbarComposition): string[];
+
 /** What a shell (widget or workspace) accepts BEYOND the chart options themselves. */
 interface VelaShellOptions {
     /** Provider factories, keyed by provider name. The shell owns the call cycle: the
@@ -197,10 +231,25 @@ interface VelaShellOptions {
     statusline?: boolean;
     watermark?: boolean;
     bottombar?: boolean;
+    /** Declarative topbar composition: `{ left, right }` lists of the VISIBLE entries,
+     *  in render order — built-in ids (`'symbol'`, `'timeframes'`, `'style'`,
+     *  `'layout'`, `'indicators'`, `'actions'`, `'undo-redo'`, `'alerts'`, `'panels'`,
+     *  `'screenshot'`) and/or contributed-action ids (naming one PINS it there,
+     *  overriding its `align`/`order`; `'actions'` is where the unlisted ones flow).
+     *  An undeclared side keeps its default. An explicit list is that side's complete
+     *  contract — it also FREEZES it: chrome a future release adds will not appear.
+     *  Hiding a built-in removes its mobile entry and keyboard chord too (`mod+alt+S`
+     *  for `'screenshot'`); Ctrl+Z / Ctrl+Y stay — they belong to editing, not to the
+     *  `'undo-redo'` buttons. */
+    topbar?: TopbarComposition;
     /** The built-in indicator picker's entry points — the topbar button, the mobile-bar
-     *  item, and the `/` shortcut. `false` removes them, for hosts that replace the
-     *  picker with their own indicator UI (e.g. a contributed topbar action opening a
-     *  custom dialog). The `indicators` manifest still resolves and auto-adds. */
+     *  item, and the `/` shortcut. `false` removes them. The `indicators` manifest
+     *  still resolves and auto-adds.
+     *  @deprecated Removed in 0.7.0. To HIDE the built-in surface, omit `'indicators'`
+     *  from `topbar.left` (same effect: no button, no mobile stop, no `/`, no dialog).
+     *  To REPLACE it, a plugin registers its action under the id `'indicators'`
+     *  (`registerWidgetAction`) — the override takes the slot's whole surface and
+     *  needs no shell option at all. */
     indicatorPicker?: boolean;
     /** Chrome size class. `'auto'` (default) follows the CONTAINER width plus a
      *  coarse-pointer heuristic; `'mobile'` / `'desktop'` pin it. Mobile swaps the
@@ -315,4 +364,84 @@ declare class Bottombar {
     private tick;
 }
 
-export { Bottombar as B, type CellState as C, type IndicatorLoader as I, type PanelsState as P, type ResolvedIndicator as R, type SyncSetting as S, type TrackSizes as T, type VelaStorage as V, WidgetHistory as W, type RangePreset as a, type VelaShellOptions as b, type SyncOptions as c, type SyncKind as d, type WorkspaceState as e, type ChartState as f, decodeState as g, encodeState as h, type BottombarOptions as i, type IndicatorManifest as j, type IndicatorManifestEntry as k, RANGE_PRESETS as l, type WidgetStorage as m, localStorageAdapter as n, resolveIndicators as r, sanitizeState as s };
+/** How the status line reads a bar out: the four O/H/L/C values (bar-shaped styles),
+ *  or the single plotted value — the close — for one-line styles (line/area/baseline). */
+type StatuslineReadout = 'ohlc' | 'value';
+/** The market session states the status badge can wear. Crypto venues trade
+ *  continuously and stay 'open'; the full vocabulary is ready for providers that
+ *  carry a session model (equities RTH/ETH, exchange holidays). */
+type MarketStatus = 'open' | 'pre' | 'post' | 'closed' | 'holiday';
+/** The status line's toggleable segments (the settings dialog's Status line tab). */
+type StatuslinePart = 'name' | 'market' | 'ohlc' | 'change';
+declare class Statusline {
+    private readonly host;
+    /** The avatar's icon URL for a raw symbol — the shell routes it to the owning
+     *  provider's `resolveSymbolIcon`. Absent ⇒ the initials badge. */
+    private readonly iconFor?;
+    readonly el: HTMLElement;
+    private readonly ohlcEl;
+    private readonly changeEl;
+    private readonly symbolEl;
+    private readonly marketEl;
+    private marketTip;
+    private avatarEl;
+    private metaEl;
+    private readonly parts;
+    private lastBar;
+    private hoverBar;
+    private unsubs;
+    /** Up/down ink for the OHLC + change values — the ACTIVE price style's configured
+     *  colors (candle bodies, bar ticks, the line color, …); null falls back to the theme
+     *  tokens. `isUp` overrides the close-vs-open direction rule where the style paints by
+     *  something else (baseline: position against the baseline price). */
+    private upColor;
+    private downColor;
+    private isUp;
+    /** 'ohlc' for bar-shaped styles; 'value' (the single plotted close) for line styles. */
+    private readout;
+    /** Fit mode (multi-chart cells): one row, overflowing segments hidden — see {@link setFitMode}. */
+    private fitMode;
+    private fitRO;
+    constructor(host: HTMLElement, symbol: string, 
+    /** The avatar's icon URL for a raw symbol — the shell routes it to the owning
+     *  provider's `resolveSymbolIcon`. Absent ⇒ the initials badge. */
+    iconFor?: ((symbol: string) => string | undefined) | undefined);
+    setSymbol(symbol: string): void;
+    /**
+     * Multi-chart cells: keep the line on ONE row whatever the cell width — never wrap.
+     * Segments that don't fit are hidden outright rather than clipped mid-glyph, least
+     * important first: OHLC, then the bar change, the venue/timeframe meta, and the
+     * market badge; the logo + ticker always stay. Re-fits live on host resizes.
+     */
+    setFitMode(on: boolean): void;
+    /** Project the parts config onto the segments (the baseline fit() prunes from). */
+    private syncParts;
+    /** Hide overflowing segments until the row fits its max-width (fit mode only). */
+    private fit;
+    /** Shape + color the value readout after the active price style: its own up/down
+     *  colors (candle bodies, bar ticks, the line color, …), the direction rule that
+     *  picks between them (`isUp` replaces close-vs-open where the style paints by
+     *  something else — baseline by position), and whether the readout is the four
+     *  O/H/L/C values or the single plotted value (one-line styles). Null colors fall
+     *  back to the theme's up/down tokens. See {@link statuslineInkOf}, which derives
+     *  all of it from the live renderer. */
+    setDirectionColors(up: string | null, down: string | null, isUp?: ((bar: {
+        open: number;
+        close: number;
+    }) => boolean) | null, readout?: StatuslineReadout): void;
+    /** Show/hide one part (the settings dialog's Status line tab drives these). */
+    /** The "· BINANCE · 1h" segment after the symbol — venue first, then resolution. */
+    setMeta(timeframe: string, provider: string): void;
+    /** Dress the market badge for a session state: its icon, tinted circle, and the
+     *  hover label. Callers with no session model leave the constructor's 'open'. */
+    setMarketStatus(status: MarketStatus): void;
+    setPartVisible(part: StatuslinePart, visible: boolean): void;
+    partVisible(part: StatuslinePart): boolean;
+    /** (Re)bind to a chart instance — called after every widget rebuild. */
+    onChart(chart: Vela): void;
+    destroy(): void;
+    private detach;
+    private render;
+}
+
+export { Bottombar as B, type CellState as C, type IndicatorLoader as I, type PanelsState as P, type ResolvedIndicator as R, type SyncSetting as S, type TrackSizes as T, type VelaStorage as V, WidgetHistory as W, type StatuslinePart as a, type RangePreset as b, type VelaShellOptions as c, type SyncOptions as d, type SyncKind as e, type WorkspaceState as f, type ChartState as g, decodeState as h, encodeState as i, type TopbarComposition as j, type BottombarOptions as k, type IndicatorManifest as l, type IndicatorManifestEntry as m, RANGE_PRESETS as n, type ResolvedTopbarComposition as o, Statusline as p, TOPBAR_BUILTIN_IDS as q, TOPBAR_DEFAULT_LEFT as r, sanitizeState as s, TOPBAR_DEFAULT_RIGHT as t, type WidgetStorage as u, localStorageAdapter as v, pinnedTopbarActionIds as w, resolveIndicators as x, resolveTopbarComposition as y, topbarHas as z };

package/dist/vela.global.js

@@ -7067,6 +7067,28 @@ var Vela = (function (exports) {
       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 ?? [];
@@ -9287,6 +9309,14 @@ var Vela = (function (exports) {
     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);
     }
@@ -9513,6 +9543,12 @@ var Vela = (function (exports) {
     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);
@@ -19980,12 +20016,16 @@ ${overlayScrollbarCss(".vela-dialog *")}
         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);
@@ -20116,6 +20156,30 @@ ${overlayScrollbarCss(".vela-dialog *")}
       }
       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;
@@ -32546,6 +32610,11 @@ ${overlayScrollbarCss(".vela-sd-pane")}
   }
 
   // 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;
@@ -32578,17 +32647,22 @@ ${overlayScrollbarCss(".vela-sd-pane")}
     /** 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
@@ -37004,6 +37078,9 @@ ${overlayScrollbarCss(".vela-sd-pane")}
     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();
@@ -37033,7 +37110,18 @@ ${overlayScrollbarCss(".vela-sd-pane")}
   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);
@@ -37073,6 +37161,16 @@ ${overlayScrollbarCss(".vela-sd-pane")}
   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);
@@ -37104,6 +37202,17 @@ ${overlayScrollbarCss(".vela-sd-pane")}
     return `${parts3.instanceId}:${parts3.kind}:${normTitle}#${parts3.ordinal}`;
   }
 
+  // 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;
+  }
+
   // src/data/providers/binance/BinanceProvider.ts
   var SPOT_BASE = "https://api.binance.com/api/v3";
   var SPOT_BASE_US = "https://api.binance.us/api/v3";
@@ -37290,6 +37399,11 @@ ${overlayScrollbarCss(".vela-sd-pane")}
       }
       return this.symbolsPromise;
     }
+    /** Predefined icon source for a crypto venue: the Ledger crypto-icon CDN, keyed by
+     *  the BASE asset (the description's first segment, else the de-suffixed ticker). */
+    resolveSymbolIcon(symbol) {
+      return ledgerCryptoIconUrl(baseOf(symbol));
+    }
     subscribe(ticker, timeframe, onBar) {
       const { apiSymbol, isFutures } = parseTicker(ticker);
       const interval = TF_TO_INTERVAL[normalizeTf(timeframe)];
@@ -37663,6 +37777,11 @@ ${overlayScrollbarCss(".vela-sd-pane")}
       }
       return this.symbolsPromise;
     }
+    /** Predefined icon source for a crypto venue: the Ledger crypto-icon CDN, keyed by
+     *  the BASE asset (the description's first segment, else the de-suffixed ticker). */
+    resolveSymbolIcon(symbol) {
+      return ledgerCryptoIconUrl(baseOf(symbol));
+    }
     subscribe(ticker, timeframe, onBar) {
       const coin = parseCoin(ticker);
       const interval = TF_TO_INTERVAL2[normalizeTf2(timeframe)];
@@ -38083,6 +38202,11 @@ ${overlayScrollbarCss(".vela-sd-pane")}
       }
       return this.symbolsPromise;
     }
+    /** Predefined icon source for a crypto venue: the Ledger crypto-icon CDN, keyed by
+     *  the BASE asset (the description's first segment, else the de-suffixed ticker). */
+    resolveSymbolIcon(symbol) {
+      return ledgerCryptoIconUrl(baseOf(symbol));
+    }
     subscribe(ticker, timeframe, onBar) {
       const gran = TF_TO_GRAN[normalizeTf3(timeframe)];
       if (gran && typeof WebSocket !== "undefined") return this.streamTicker(ticker, timeframe, gran, onBar);
@@ -38336,6 +38460,7 @@ ${overlayScrollbarCss(".vela-sd-pane")}
   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;
@@ -38379,6 +38504,7 @@ ${overlayScrollbarCss(".vela-sd-pane")}
   exports.registerRendererLayer = registerRendererLayer;
   exports.registerSidePanel = registerSidePanel;
   exports.registerStatePersistence = registerStatePersistence;
+  exports.registerSymbolRanking = registerSymbolRanking;
   exports.registerWidgetAction = registerWidgetAction;
   exports.registerWidgetAttachment = registerWidgetAttachment;
   exports.rendererDefaults = rendererDefaults;
@@ -38391,8 +38517,10 @@ ${overlayScrollbarCss(".vela-sd-pane")}
   exports.splitColor = splitColor;
   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;