@luxalgo/vela 0.6.6 → 0.6.8

package/dist/widget.d.cts

@@ -1,10 +1,10 @@
-import { V as Vela, W as WidgetContext, A as SidePanelButton } from './contributions-DNMqrAuw.cjs';
-export { C as CellStateContext, an as DEFAULT_PANEL_ORDER, E as ExternalIndicatorEntry, G as SidePanelDescriptor, H as SidePanelHandle, K as StatePersistenceHandler, Z as WidgetActionDescriptor, _ as WidgetActionTarget, $ as WidgetAttachment, a7 as registerSidePanel, a8 as registerStatePersistence, a9 as registerWidgetAction, aa as registerWidgetAttachment, ac as sidePanels, ad as statePersistenceHandlers, ah as unregisterSidePanel, ai as unregisterStatePersistence, aj as unregisterWidgetAction, ak as unregisterWidgetAttachment, al as widgetActions, am as widgetAttachments } from './contributions-DNMqrAuw.cjs';
+import { V as Vela, W as WidgetContext, A as SidePanelButton } from './contributions-Vw-Hm58R.cjs';
+export { C as CellStateContext, as as DEFAULT_PANEL_ORDER, E as ExternalIndicatorEntry, O as OVERRIDABLE_TOPBAR_IDS, G as SidePanelDescriptor, H as SidePanelHandle, K as StatePersistenceHandler, U as SymbolRankingHook, $ as WidgetActionDescriptor, a0 as WidgetActionTarget, a1 as WidgetAttachment, a9 as registerSidePanel, aa as registerStatePersistence, ab as registerSymbolRanking, ac as registerWidgetAction, ad as registerWidgetAttachment, af as sidePanels, ag as statePersistenceHandlers, ah as symbolRanking, ai as topbarActionOverride, am as unregisterSidePanel, an as unregisterStatePersistence, ao as unregisterWidgetAction, ap as unregisterWidgetAttachment, aq as widgetActions, ar as widgetAttachments } from './contributions-Vw-Hm58R.cjs';
 import { b as VelaOptions, d as MarketSession, T as ThemeName, c as VelaTheme, r as DataWindowReadout } from './options-BaVTMXaO.cjs';
-import { b as VelaShellOptions, W as WidgetHistory, a as RangePreset, e as WorkspaceState, P as PanelsState } from './bottombar-DeDXbF_K.cjs';
-export { B as Bottombar, i as BottombarOptions, C as CellState, f as ChartState, I as IndicatorLoader, j as IndicatorManifest, k as IndicatorManifestEntry, l as RANGE_PRESETS, R as ResolvedIndicator, V as VelaStorage, m as WidgetStorage, g as decodeState, h as encodeState, n as localStorageAdapter, r as resolveIndicators, s as sanitizeState } from './bottombar-DeDXbF_K.cjs';
+import { c as VelaShellOptions, W as WidgetHistory, b as RangePreset, f as WorkspaceState, j as TopbarComposition, P as PanelsState } from './statusline-DqzBqy42.cjs';
+export { B as Bottombar, k as BottombarOptions, C as CellState, g as ChartState, I as IndicatorLoader, l as IndicatorManifest, m as IndicatorManifestEntry, n as RANGE_PRESETS, R as ResolvedIndicator, o as ResolvedTopbarComposition, p as Statusline, q as TOPBAR_BUILTIN_IDS, r as TOPBAR_DEFAULT_LEFT, t as TOPBAR_DEFAULT_RIGHT, V as VelaStorage, u as WidgetStorage, h as decodeState, i as encodeState, v as localStorageAdapter, w as pinnedTopbarActionIds, x as resolveIndicators, y as resolveTopbarComposition, s as sanitizeState, z as topbarHas } from './statusline-DqzBqy42.cjs';
 import { K as KeymapManager } from './keymap-CGOz5F5f.cjs';
-import { a as SymbolDescriptor } from './DataProvider-DDUYw2qP.cjs';
+import { a as SymbolDescriptor } from './DataProvider-BsQM2WNH.cjs';
 import { d as SidePanel } from './side-panel-CT9ZwIGz.cjs';
 export { D as DEFAULT_PANEL_MAX_WIDTH, a as DEFAULT_PANEL_MIN_WIDTH, b as DEFAULT_PANEL_WIDTH, S as SidePanelOptions, c as clampPanelWidth } from './side-panel-CT9ZwIGz.cjs';
 
@@ -104,6 +104,11 @@ interface TopbarOptions {
     onAlertsClick?: (anchor: HTMLElement) => void;
     /** Live widget context for contributed actions (topbar target). */
     getContext?: () => WidgetContext;
+    /** The host's declarative composition (see {@link TopbarComposition}) — which
+     *  entries render, per side, in list order. An undeclared side keeps its default.
+     *  The shell that owns this bar also gates the matching mobile entries and
+     *  keyboard chords on the same composition — the bar only handles its own DOM. */
+    composition?: TopbarComposition;
 }
 declare class Topbar {
     readonly el: HTMLElement;
@@ -133,6 +138,19 @@ declare class Topbar {
     private panelTooltips;
     private readonly host;
     private alertsBadge;
+    /** The resolved composition (defaults applied) — what renders, where, in order. */
+    private readonly comp;
+    /** Pinned contributed-action slots, by action id (composition entries that name one,
+     *  plus built-in slots taken over by an override). */
+    private readonly pinned;
+    /** Overrides that LEFT their native slot (default side + a declared `order`) — they
+     *  render through the flow cluster like ordinary actions. */
+    private readonly flowingOverrides;
+    /** Tooltips of the CURRENT icon-only action buttons — rebuilt with every
+     *  renderActions pass (contributed buttons are replaceChildren'd away). */
+    private actionTooltips;
+    /** `iconOnly` misuse warned once per action id (renderActions re-runs freely). */
+    private readonly warnedIconless;
     private readonly opts;
     private timeframe;
     private priceStyle;
@@ -151,7 +169,10 @@ declare class Topbar {
     setLayout(id: string): void;
     private renderLayoutButton;
     private renderStyleButton;
-    /** Re-project the contributed topbar actions (call after registrations change). */
+    /** Re-project the contributed topbar actions (call after registrations change).
+     *  An action PINNED by the composition renders into its named slot (list position
+     *  wins over `align`/`order`); the rest flow into the side's `actions` slot — or
+     *  not at all when an explicit list omits it (the list is the side's contract). */
     renderActions(): void;
     setIndicatorCount(_n: number): void;
     /** Enable/disable the undo and redo tools from the host's unified history. */
@@ -175,78 +196,6 @@ declare class Topbar {
     private styleItems;
 }
 
-/** 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';
-declare class Statusline {
-    private readonly host;
-    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);
-    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: 'name' | 'market' | 'ohlc' | 'change', visible: boolean): void;
-    partVisible(part: 'name' | 'market' | 'ohlc' | 'change'): boolean;
-    /** (Re)bind to a chart instance — called after every widget rebuild. */
-    onChart(chart: Vela): void;
-    destroy(): void;
-    private detach;
-    private render;
-}
-
 declare class Watermark {
     readonly el: HTMLElement;
     private readonly text;
@@ -268,7 +217,7 @@ declare class Watermark {
     destroy(): void;
 }
 
-declare function filterSymbols(list: readonly SymbolDescriptor[], query: string, limit?: number): SymbolDescriptor[];
+declare function filterSymbols(list: readonly SymbolDescriptor[], query: string, limit?: number, top?: readonly string[] | false): SymbolDescriptor[];
 interface SymbolPickerOptions {
     /** `provider` is the venue of the chosen row — absent only for a source that has none. */
     /** Called with the CHOSEN symbol — `EXCHANGE:`-prefixed when the row named a venue,
@@ -276,8 +225,12 @@ interface SymbolPickerOptions {
     onSelect: (symbol: string) => void;
     onOpenChange?: (open: boolean) => void;
     host?: HTMLElement;
+    /** The row's icon URL — routed to the descriptor's OWNING provider
+     *  (`resolveSymbolIcon`). Absent or `undefined` per row ⇒ the initials badge. */
+    iconFor?: (d: SymbolDescriptor) => string | undefined;
 }
 declare class SymbolPicker {
+    private readonly opts;
     private readonly dialog;
     private readonly input;
     private readonly list;
@@ -288,6 +241,9 @@ declare class SymbolPicker {
     private activeTab;
     private tabs;
     private visible;
+    /** The ranked pool cache — `key` fingerprints the raw pool the ranking ran on. */
+    private ranked;
+    private ranking;
     constructor(opts: SymbolPickerOptions);
     /** Wire where symbols come from (re-called on every widget rebuild). */
     setSource(source: () => readonly SymbolDescriptor[]): void;
@@ -297,6 +253,11 @@ declare class SymbolPicker {
     private select;
     private moveHighlight;
     private renderHighlight;
+    /** The picker's pool: the source, shaped by the registered symbol ranking. Cached —
+     *  the hook runs when the pool CHANGES (an index lands or refreshes), never per
+     *  keystroke; an async hook resolves onto the next repaint (stale-while-revalidate
+     *  in between, the raw pool before the first resolve). */
+    private pool;
     private computeRows;
     private refresh;
     /** Append the page the grown `visible` just uncovered — rows already on screen stay put. */
@@ -428,9 +389,14 @@ declare class PanelDock {
 }
 
 declare class ObjectTree extends SidePanel {
+    /** The price row's avatar icon URL for a raw symbol — routed by the shell to the
+     *  owning provider's `resolveSymbolIcon`. Absent ⇒ the initials badge. */
+    private readonly iconFor?;
     private chart;
     private selectedDrawing;
     private symbolName;
+    /** The raw (possibly venue-prefixed) symbol — what icon resolution routes on. */
+    private symbolRaw;
     /** Drawing bundles — a view-side grouping, held for the panel's lifetime and never persisted.
      *  Kept per chart because a workspace points this one panel at whichever chart is active, and
      *  each chart's bundles have to survive the switch. */
@@ -454,7 +420,10 @@ declare class ObjectTree extends SidePanel {
     private menu;
     private menuActions;
     private drag;
-    constructor(host: HTMLElement);
+    constructor(host: HTMLElement, 
+    /** The price row's avatar icon URL for a raw symbol — routed by the shell to the
+     *  owning provider's `resolveSymbolIcon`. Absent ⇒ the initials badge. */
+    iconFor?: ((symbol: string) => string | undefined) | undefined);
     toggle(open?: boolean): void;
     setSymbol(symbol: string): void;
     /** (Re)bind to a chart instance — called after every widget rebuild. */
@@ -685,4 +654,4 @@ declare function fmtPrice(n: number | null | undefined, dp?: number): string;
 /** Signed change + percent ("+123.45 (+1.23%)") from open→close; `''` when unavailable. */
 declare function fmtChange(open: number | null | undefined, close: number | null | undefined): string;
 
-export { type BuiltInPanel, ChartContextMenu, type ContextMenuCallbacks, DataWindow, type DataWindowLine, type DataWindowSection, IndicatorPicker, type IndicatorPickerOptions, type IndicatorRow, ObjectTree, type PanelChrome, PanelDock, type PanelDockDeps, PanelsState, type ParsedTimeframe, RangePreset, ShortcutsHelp, SidePanel, SidePanelButton, Statusline, SymbolPicker, type SymbolPickerOptions, TIMEZONES, TimeframeQuick, type TimeframeQuickOptions, type TimezoneEntry, Topbar, type TopbarOptions, VelaShellOptions, VelaWidget, type VelaWidgetOptions, Watermark, WidgetContext, WorkspaceState, dataWindowSections, decimalsFor, filterSymbols, fmtChange, fmtPrice, normalizeTimezone, parseTimeframe, priceStyleLabel, timeframeLabel, timeframeMs, tzButtonLabel, tzMenuLabel, tzOffset };
+export { type BuiltInPanel, ChartContextMenu, type ContextMenuCallbacks, DataWindow, type DataWindowLine, type DataWindowSection, IndicatorPicker, type IndicatorPickerOptions, type IndicatorRow, ObjectTree, type PanelChrome, PanelDock, type PanelDockDeps, PanelsState, type ParsedTimeframe, RangePreset, ShortcutsHelp, SidePanel, SidePanelButton, SymbolPicker, type SymbolPickerOptions, TIMEZONES, TimeframeQuick, type TimeframeQuickOptions, type TimezoneEntry, Topbar, TopbarComposition, type TopbarOptions, VelaShellOptions, VelaWidget, type VelaWidgetOptions, Watermark, WidgetContext, WorkspaceState, dataWindowSections, decimalsFor, filterSymbols, fmtChange, fmtPrice, normalizeTimezone, parseTimeframe, priceStyleLabel, timeframeLabel, timeframeMs, tzButtonLabel, tzMenuLabel, tzOffset };

package/dist/widget.d.ts

@@ -1,10 +1,10 @@
-import { V as Vela, W as WidgetContext, A as SidePanelButton } from './contributions-BqCIsbaP.js';
-export { C as CellStateContext, an as DEFAULT_PANEL_ORDER, E as ExternalIndicatorEntry, G as SidePanelDescriptor, H as SidePanelHandle, K as StatePersistenceHandler, Z as WidgetActionDescriptor, _ as WidgetActionTarget, $ as WidgetAttachment, a7 as registerSidePanel, a8 as registerStatePersistence, a9 as registerWidgetAction, aa as registerWidgetAttachment, ac as sidePanels, ad as statePersistenceHandlers, ah as unregisterSidePanel, ai as unregisterStatePersistence, aj as unregisterWidgetAction, ak as unregisterWidgetAttachment, al as widgetActions, am as widgetAttachments } from './contributions-BqCIsbaP.js';
+import { V as Vela, W as WidgetContext, A as SidePanelButton } from './contributions-DLLdV9jD.js';
+export { C as CellStateContext, as as DEFAULT_PANEL_ORDER, E as ExternalIndicatorEntry, O as OVERRIDABLE_TOPBAR_IDS, G as SidePanelDescriptor, H as SidePanelHandle, K as StatePersistenceHandler, U as SymbolRankingHook, $ as WidgetActionDescriptor, a0 as WidgetActionTarget, a1 as WidgetAttachment, a9 as registerSidePanel, aa as registerStatePersistence, ab as registerSymbolRanking, ac as registerWidgetAction, ad as registerWidgetAttachment, af as sidePanels, ag as statePersistenceHandlers, ah as symbolRanking, ai as topbarActionOverride, am as unregisterSidePanel, an as unregisterStatePersistence, ao as unregisterWidgetAction, ap as unregisterWidgetAttachment, aq as widgetActions, ar as widgetAttachments } from './contributions-DLLdV9jD.js';
 import { b as VelaOptions, d as MarketSession, T as ThemeName, c as VelaTheme, r as DataWindowReadout } from './options-BaVTMXaO.js';
-import { b as VelaShellOptions, W as WidgetHistory, a as RangePreset, e as WorkspaceState, P as PanelsState } from './bottombar-COnL2Sk4.js';
-export { B as Bottombar, i as BottombarOptions, C as CellState, f as ChartState, I as IndicatorLoader, j as IndicatorManifest, k as IndicatorManifestEntry, l as RANGE_PRESETS, R as ResolvedIndicator, V as VelaStorage, m as WidgetStorage, g as decodeState, h as encodeState, n as localStorageAdapter, r as resolveIndicators, s as sanitizeState } from './bottombar-COnL2Sk4.js';
+import { c as VelaShellOptions, W as WidgetHistory, b as RangePreset, f as WorkspaceState, j as TopbarComposition, P as PanelsState } from './statusline-CGkB2EOo.js';
+export { B as Bottombar, k as BottombarOptions, C as CellState, g as ChartState, I as IndicatorLoader, l as IndicatorManifest, m as IndicatorManifestEntry, n as RANGE_PRESETS, R as ResolvedIndicator, o as ResolvedTopbarComposition, p as Statusline, q as TOPBAR_BUILTIN_IDS, r as TOPBAR_DEFAULT_LEFT, t as TOPBAR_DEFAULT_RIGHT, V as VelaStorage, u as WidgetStorage, h as decodeState, i as encodeState, v as localStorageAdapter, w as pinnedTopbarActionIds, x as resolveIndicators, y as resolveTopbarComposition, s as sanitizeState, z as topbarHas } from './statusline-CGkB2EOo.js';
 import { K as KeymapManager } from './keymap-CGOz5F5f.js';
-import { a as SymbolDescriptor } from './DataProvider-JJq7M2it.js';
+import { a as SymbolDescriptor } from './DataProvider-BSLlBpB9.js';
 import { d as SidePanel } from './side-panel-CT9ZwIGz.js';
 export { D as DEFAULT_PANEL_MAX_WIDTH, a as DEFAULT_PANEL_MIN_WIDTH, b as DEFAULT_PANEL_WIDTH, S as SidePanelOptions, c as clampPanelWidth } from './side-panel-CT9ZwIGz.js';
 
@@ -104,6 +104,11 @@ interface TopbarOptions {
     onAlertsClick?: (anchor: HTMLElement) => void;
     /** Live widget context for contributed actions (topbar target). */
     getContext?: () => WidgetContext;
+    /** The host's declarative composition (see {@link TopbarComposition}) — which
+     *  entries render, per side, in list order. An undeclared side keeps its default.
+     *  The shell that owns this bar also gates the matching mobile entries and
+     *  keyboard chords on the same composition — the bar only handles its own DOM. */
+    composition?: TopbarComposition;
 }
 declare class Topbar {
     readonly el: HTMLElement;
@@ -133,6 +138,19 @@ declare class Topbar {
     private panelTooltips;
     private readonly host;
     private alertsBadge;
+    /** The resolved composition (defaults applied) — what renders, where, in order. */
+    private readonly comp;
+    /** Pinned contributed-action slots, by action id (composition entries that name one,
+     *  plus built-in slots taken over by an override). */
+    private readonly pinned;
+    /** Overrides that LEFT their native slot (default side + a declared `order`) — they
+     *  render through the flow cluster like ordinary actions. */
+    private readonly flowingOverrides;
+    /** Tooltips of the CURRENT icon-only action buttons — rebuilt with every
+     *  renderActions pass (contributed buttons are replaceChildren'd away). */
+    private actionTooltips;
+    /** `iconOnly` misuse warned once per action id (renderActions re-runs freely). */
+    private readonly warnedIconless;
     private readonly opts;
     private timeframe;
     private priceStyle;
@@ -151,7 +169,10 @@ declare class Topbar {
     setLayout(id: string): void;
     private renderLayoutButton;
     private renderStyleButton;
-    /** Re-project the contributed topbar actions (call after registrations change). */
+    /** Re-project the contributed topbar actions (call after registrations change).
+     *  An action PINNED by the composition renders into its named slot (list position
+     *  wins over `align`/`order`); the rest flow into the side's `actions` slot — or
+     *  not at all when an explicit list omits it (the list is the side's contract). */
     renderActions(): void;
     setIndicatorCount(_n: number): void;
     /** Enable/disable the undo and redo tools from the host's unified history. */
@@ -175,78 +196,6 @@ declare class Topbar {
     private styleItems;
 }
 
-/** 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';
-declare class Statusline {
-    private readonly host;
-    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);
-    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: 'name' | 'market' | 'ohlc' | 'change', visible: boolean): void;
-    partVisible(part: 'name' | 'market' | 'ohlc' | 'change'): boolean;
-    /** (Re)bind to a chart instance — called after every widget rebuild. */
-    onChart(chart: Vela): void;
-    destroy(): void;
-    private detach;
-    private render;
-}
-
 declare class Watermark {
     readonly el: HTMLElement;
     private readonly text;
@@ -268,7 +217,7 @@ declare class Watermark {
     destroy(): void;
 }
 
-declare function filterSymbols(list: readonly SymbolDescriptor[], query: string, limit?: number): SymbolDescriptor[];
+declare function filterSymbols(list: readonly SymbolDescriptor[], query: string, limit?: number, top?: readonly string[] | false): SymbolDescriptor[];
 interface SymbolPickerOptions {
     /** `provider` is the venue of the chosen row — absent only for a source that has none. */
     /** Called with the CHOSEN symbol — `EXCHANGE:`-prefixed when the row named a venue,
@@ -276,8 +225,12 @@ interface SymbolPickerOptions {
     onSelect: (symbol: string) => void;
     onOpenChange?: (open: boolean) => void;
     host?: HTMLElement;
+    /** The row's icon URL — routed to the descriptor's OWNING provider
+     *  (`resolveSymbolIcon`). Absent or `undefined` per row ⇒ the initials badge. */
+    iconFor?: (d: SymbolDescriptor) => string | undefined;
 }
 declare class SymbolPicker {
+    private readonly opts;
     private readonly dialog;
     private readonly input;
     private readonly list;
@@ -288,6 +241,9 @@ declare class SymbolPicker {
     private activeTab;
     private tabs;
     private visible;
+    /** The ranked pool cache — `key` fingerprints the raw pool the ranking ran on. */
+    private ranked;
+    private ranking;
     constructor(opts: SymbolPickerOptions);
     /** Wire where symbols come from (re-called on every widget rebuild). */
     setSource(source: () => readonly SymbolDescriptor[]): void;
@@ -297,6 +253,11 @@ declare class SymbolPicker {
     private select;
     private moveHighlight;
     private renderHighlight;
+    /** The picker's pool: the source, shaped by the registered symbol ranking. Cached —
+     *  the hook runs when the pool CHANGES (an index lands or refreshes), never per
+     *  keystroke; an async hook resolves onto the next repaint (stale-while-revalidate
+     *  in between, the raw pool before the first resolve). */
+    private pool;
     private computeRows;
     private refresh;
     /** Append the page the grown `visible` just uncovered — rows already on screen stay put. */
@@ -428,9 +389,14 @@ declare class PanelDock {
 }
 
 declare class ObjectTree extends SidePanel {
+    /** The price row's avatar icon URL for a raw symbol — routed by the shell to the
+     *  owning provider's `resolveSymbolIcon`. Absent ⇒ the initials badge. */
+    private readonly iconFor?;
     private chart;
     private selectedDrawing;
     private symbolName;
+    /** The raw (possibly venue-prefixed) symbol — what icon resolution routes on. */
+    private symbolRaw;
     /** Drawing bundles — a view-side grouping, held for the panel's lifetime and never persisted.
      *  Kept per chart because a workspace points this one panel at whichever chart is active, and
      *  each chart's bundles have to survive the switch. */
@@ -454,7 +420,10 @@ declare class ObjectTree extends SidePanel {
     private menu;
     private menuActions;
     private drag;
-    constructor(host: HTMLElement);
+    constructor(host: HTMLElement, 
+    /** The price row's avatar icon URL for a raw symbol — routed by the shell to the
+     *  owning provider's `resolveSymbolIcon`. Absent ⇒ the initials badge. */
+    iconFor?: ((symbol: string) => string | undefined) | undefined);
     toggle(open?: boolean): void;
     setSymbol(symbol: string): void;
     /** (Re)bind to a chart instance — called after every widget rebuild. */
@@ -685,4 +654,4 @@ declare function fmtPrice(n: number | null | undefined, dp?: number): string;
 /** Signed change + percent ("+123.45 (+1.23%)") from open→close; `''` when unavailable. */
 declare function fmtChange(open: number | null | undefined, close: number | null | undefined): string;
 
-export { type BuiltInPanel, ChartContextMenu, type ContextMenuCallbacks, DataWindow, type DataWindowLine, type DataWindowSection, IndicatorPicker, type IndicatorPickerOptions, type IndicatorRow, ObjectTree, type PanelChrome, PanelDock, type PanelDockDeps, PanelsState, type ParsedTimeframe, RangePreset, ShortcutsHelp, SidePanel, SidePanelButton, Statusline, SymbolPicker, type SymbolPickerOptions, TIMEZONES, TimeframeQuick, type TimeframeQuickOptions, type TimezoneEntry, Topbar, type TopbarOptions, VelaShellOptions, VelaWidget, type VelaWidgetOptions, Watermark, WidgetContext, WorkspaceState, dataWindowSections, decimalsFor, filterSymbols, fmtChange, fmtPrice, normalizeTimezone, parseTimeframe, priceStyleLabel, timeframeLabel, timeframeMs, tzButtonLabel, tzMenuLabel, tzOffset };
+export { type BuiltInPanel, ChartContextMenu, type ContextMenuCallbacks, DataWindow, type DataWindowLine, type DataWindowSection, IndicatorPicker, type IndicatorPickerOptions, type IndicatorRow, ObjectTree, type PanelChrome, PanelDock, type PanelDockDeps, PanelsState, type ParsedTimeframe, RangePreset, ShortcutsHelp, SidePanel, SidePanelButton, SymbolPicker, type SymbolPickerOptions, TIMEZONES, TimeframeQuick, type TimeframeQuickOptions, type TimezoneEntry, Topbar, TopbarComposition, type TopbarOptions, VelaShellOptions, VelaWidget, type VelaWidgetOptions, Watermark, WidgetContext, WorkspaceState, dataWindowSections, decimalsFor, filterSymbols, fmtChange, fmtPrice, normalizeTimezone, parseTimeframe, priceStyleLabel, timeframeLabel, timeframeMs, tzButtonLabel, tzMenuLabel, tzOffset };

package/dist/widget.js

@@ -1,10 +1,11 @@
-import { VelaWorkspace } from './chunk-TMXK2SJR.js';
-export { Bottombar, ChartContextMenu, DataWindow, IndicatorPicker, ObjectTree, PanelDock, RANGE_PRESETS, ShortcutsHelp, Statusline, SymbolPicker, TimeframeQuick, Topbar, Watermark, dataWindowSections, decimalsFor, decodeState, encodeState, filterSymbols, fmtChange, fmtPrice, localStorageAdapter, parseTimeframe, priceStyleLabel, resolveIndicators, sanitizeState, timeframeLabel, timeframeMs } from './chunk-TMXK2SJR.js';
-export { TIMEZONES, normalizeTimezone, tzButtonLabel, tzMenuLabel, tzOffset } from './chunk-JQFO2WMU.js';
-export { DEFAULT_PANEL_MAX_WIDTH, DEFAULT_PANEL_MIN_WIDTH, DEFAULT_PANEL_ORDER, DEFAULT_PANEL_WIDTH, SidePanel, clampPanelWidth, registerSidePanel, registerStatePersistence, registerWidgetAction, registerWidgetAttachment, sidePanels, statePersistenceHandlers, unregisterSidePanel, unregisterStatePersistence, unregisterWidgetAction, unregisterWidgetAttachment, widgetActions, widgetAttachments } from './chunk-OEUGUXL7.js';
+import { VelaWorkspace } from './chunk-N7LGMKCE.js';
+export { Bottombar, ChartContextMenu, DataWindow, IndicatorPicker, ObjectTree, PanelDock, RANGE_PRESETS, ShortcutsHelp, Statusline, SymbolPicker, TimeframeQuick, Topbar, Watermark, dataWindowSections, decimalsFor, decodeState, encodeState, filterSymbols, fmtChange, fmtPrice, localStorageAdapter, parseTimeframe, priceStyleLabel, resolveIndicators, sanitizeState, timeframeLabel, timeframeMs } from './chunk-N7LGMKCE.js';
+export { TIMEZONES, normalizeTimezone, tzButtonLabel, tzMenuLabel, tzOffset } from './chunk-SQETIBFU.js';
+export { DEFAULT_PANEL_MAX_WIDTH, DEFAULT_PANEL_MIN_WIDTH, DEFAULT_PANEL_ORDER, DEFAULT_PANEL_WIDTH, OVERRIDABLE_TOPBAR_IDS, SidePanel, TOPBAR_BUILTIN_IDS, TOPBAR_DEFAULT_LEFT, TOPBAR_DEFAULT_RIGHT, clampPanelWidth, pinnedTopbarActionIds, registerSidePanel, registerStatePersistence, registerSymbolRanking, registerWidgetAction, registerWidgetAttachment, resolveTopbarComposition, sidePanels, statePersistenceHandlers, symbolRanking, topbarActionOverride, topbarHas, unregisterSidePanel, unregisterStatePersistence, unregisterWidgetAction, unregisterWidgetAttachment, widgetActions, widgetAttachments } from './chunk-L3I2CCYO.js';
 import './chunk-2R7BANEM.js';
 import './chunk-OICPLNU7.js';
 import './chunk-PN5KWFZ4.js';
+import './chunk-W4EJWLEO.js';
 
 // src/widget/VelaWidget.ts
 var deprecationWarned = false;