@luxalgo/vela 0.6.6 → 0.6.7

package/dist/providers/binance.d.cts

@@ -1,5 +1,5 @@
 import { O as OHLCV, U as Unsubscribe } from '../options-BaVTMXaO.cjs';
-import { D as DataProvider, P as ProviderInfo, B as BarRange, S as SymbolInfo, a as SymbolDescriptor } from '../DataProvider-DDUYw2qP.cjs';
+import { D as DataProvider, P as ProviderInfo, B as BarRange, S as SymbolInfo, a as SymbolDescriptor } from '../DataProvider-BsQM2WNH.cjs';
 
 /**
  * Binance market-data provider, built from scratch on the public REST + WebSocket
@@ -23,6 +23,9 @@ declare class BinanceProvider implements DataProvider {
     getBars(ticker: string, timeframe: string, range: BarRange): Promise<OHLCV[]>;
     getSymbolInfo(ticker: string): Promise<SymbolInfo | undefined>;
     listSymbols(): Promise<SymbolDescriptor[]>;
+    /** 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: SymbolDescriptor): string | undefined;
     subscribe(ticker: string, timeframe: string, onBar: (bar: OHLCV) => void): Unsubscribe;
     /**
      * Open a Binance kline WebSocket (single-stream URL form — the stream is in the

package/dist/providers/binance.d.ts

@@ -1,5 +1,5 @@
 import { O as OHLCV, U as Unsubscribe } from '../options-BaVTMXaO.js';
-import { D as DataProvider, P as ProviderInfo, B as BarRange, S as SymbolInfo, a as SymbolDescriptor } from '../DataProvider-JJq7M2it.js';
+import { D as DataProvider, P as ProviderInfo, B as BarRange, S as SymbolInfo, a as SymbolDescriptor } from '../DataProvider-BSLlBpB9.js';
 
 /**
  * Binance market-data provider, built from scratch on the public REST + WebSocket
@@ -23,6 +23,9 @@ declare class BinanceProvider implements DataProvider {
     getBars(ticker: string, timeframe: string, range: BarRange): Promise<OHLCV[]>;
     getSymbolInfo(ticker: string): Promise<SymbolInfo | undefined>;
     listSymbols(): Promise<SymbolDescriptor[]>;
+    /** 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: SymbolDescriptor): string | undefined;
     subscribe(ticker: string, timeframe: string, onBar: (bar: OHLCV) => void): Unsubscribe;
     /**
      * Open a Binance kline WebSocket (single-stream URL form — the stream is in the

package/dist/providers/binance.js

@@ -1,3 +1,5 @@
+import { ledgerCryptoIconUrl, baseOf } from '../chunk-W4EJWLEO.js';
+
 // 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";
@@ -184,6 +186,11 @@ var BinanceProvider = class {
     }
     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)];

package/dist/providers/coinbase.cjs

@@ -1,5 +1,16 @@
 'use strict';
 
+// 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/coinbase/RequestGate.ts
 var REAL_CLOCK = {
   now: () => Date.now(),
@@ -234,6 +245,11 @@ var CoinbaseProvider = class {
     }
     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[normalizeTf(timeframe)];
     if (gran && typeof WebSocket !== "undefined") return this.streamTicker(ticker, timeframe, gran, onBar);

package/dist/providers/coinbase.d.cts

@@ -1,5 +1,5 @@
 import { O as OHLCV, U as Unsubscribe } from '../options-BaVTMXaO.cjs';
-import { D as DataProvider, P as ProviderInfo, B as BarRange, S as SymbolInfo, a as SymbolDescriptor } from '../DataProvider-DDUYw2qP.cjs';
+import { D as DataProvider, P as ProviderInfo, B as BarRange, S as SymbolInfo, a as SymbolDescriptor } from '../DataProvider-BsQM2WNH.cjs';
 
 /**
  * Coinbase market-data provider, built from scratch on the public Exchange REST + WebSocket APIs
@@ -24,6 +24,9 @@ declare class CoinbaseProvider implements DataProvider {
     getBars(ticker: string, timeframe: string, range: BarRange): Promise<OHLCV[]>;
     getSymbolInfo(ticker: string): Promise<SymbolInfo | undefined>;
     listSymbols(): Promise<SymbolDescriptor[]>;
+    /** 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: SymbolDescriptor): string | undefined;
     subscribe(ticker: string, timeframe: string, onBar: (bar: OHLCV) => void): Unsubscribe;
     private fetchProducts;
     /**

package/dist/providers/coinbase.d.ts

@@ -1,5 +1,5 @@
 import { O as OHLCV, U as Unsubscribe } from '../options-BaVTMXaO.js';
-import { D as DataProvider, P as ProviderInfo, B as BarRange, S as SymbolInfo, a as SymbolDescriptor } from '../DataProvider-JJq7M2it.js';
+import { D as DataProvider, P as ProviderInfo, B as BarRange, S as SymbolInfo, a as SymbolDescriptor } from '../DataProvider-BSLlBpB9.js';
 
 /**
  * Coinbase market-data provider, built from scratch on the public Exchange REST + WebSocket APIs
@@ -24,6 +24,9 @@ declare class CoinbaseProvider implements DataProvider {
     getBars(ticker: string, timeframe: string, range: BarRange): Promise<OHLCV[]>;
     getSymbolInfo(ticker: string): Promise<SymbolInfo | undefined>;
     listSymbols(): Promise<SymbolDescriptor[]>;
+    /** 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: SymbolDescriptor): string | undefined;
     subscribe(ticker: string, timeframe: string, onBar: (bar: OHLCV) => void): Unsubscribe;
     private fetchProducts;
     /**

package/dist/providers/coinbase.js

@@ -1,3 +1,5 @@
+import { ledgerCryptoIconUrl, baseOf } from '../chunk-W4EJWLEO.js';
+
 // src/data/providers/coinbase/RequestGate.ts
 var REAL_CLOCK = {
   now: () => Date.now(),
@@ -232,6 +234,11 @@ var CoinbaseProvider = class {
     }
     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[normalizeTf(timeframe)];
     if (gran && typeof WebSocket !== "undefined") return this.streamTicker(ticker, timeframe, gran, onBar);

package/dist/providers/hyperliquid.cjs

@@ -1,5 +1,16 @@
 'use strict';
 
+// 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/hyperliquid/HyperliquidProvider.ts
 var INFO_URL = "https://api.hyperliquid.xyz/info";
 var WS_URL = "wss://api.hyperliquid.xyz/ws";
@@ -172,6 +183,11 @@ var HyperliquidProvider = class {
     }
     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_INTERVAL[normalizeTf(timeframe)];

package/dist/providers/hyperliquid.d.cts

@@ -1,5 +1,5 @@
 import { O as OHLCV, U as Unsubscribe } from '../options-BaVTMXaO.cjs';
-import { D as DataProvider, P as ProviderInfo, B as BarRange, S as SymbolInfo, a as SymbolDescriptor } from '../DataProvider-DDUYw2qP.cjs';
+import { D as DataProvider, P as ProviderInfo, B as BarRange, S as SymbolInfo, a as SymbolDescriptor } from '../DataProvider-BsQM2WNH.cjs';
 
 /**
  * Hyperliquid market-data provider, built from scratch on the public info API — no
@@ -26,6 +26,9 @@ declare class HyperliquidProvider implements DataProvider {
     getBars(ticker: string, timeframe: string, range: BarRange): Promise<OHLCV[]>;
     getSymbolInfo(ticker: string): Promise<SymbolInfo | undefined>;
     listSymbols(): Promise<SymbolDescriptor[]>;
+    /** 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: SymbolDescriptor): string | undefined;
     subscribe(ticker: string, timeframe: string, onBar: (bar: OHLCV) => void): Unsubscribe;
     private listPerps;
     private listSpot;

package/dist/providers/hyperliquid.d.ts

@@ -1,5 +1,5 @@
 import { O as OHLCV, U as Unsubscribe } from '../options-BaVTMXaO.js';
-import { D as DataProvider, P as ProviderInfo, B as BarRange, S as SymbolInfo, a as SymbolDescriptor } from '../DataProvider-JJq7M2it.js';
+import { D as DataProvider, P as ProviderInfo, B as BarRange, S as SymbolInfo, a as SymbolDescriptor } from '../DataProvider-BSLlBpB9.js';
 
 /**
  * Hyperliquid market-data provider, built from scratch on the public info API — no
@@ -26,6 +26,9 @@ declare class HyperliquidProvider implements DataProvider {
     getBars(ticker: string, timeframe: string, range: BarRange): Promise<OHLCV[]>;
     getSymbolInfo(ticker: string): Promise<SymbolInfo | undefined>;
     listSymbols(): Promise<SymbolDescriptor[]>;
+    /** 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: SymbolDescriptor): string | undefined;
     subscribe(ticker: string, timeframe: string, onBar: (bar: OHLCV) => void): Unsubscribe;
     private listPerps;
     private listSpot;

package/dist/providers/hyperliquid.js

@@ -1,3 +1,5 @@
+import { ledgerCryptoIconUrl, baseOf } from '../chunk-W4EJWLEO.js';
+
 // src/data/providers/hyperliquid/HyperliquidProvider.ts
 var INFO_URL = "https://api.hyperliquid.xyz/info";
 var WS_URL = "wss://api.hyperliquid.xyz/ws";
@@ -170,6 +172,11 @@ var HyperliquidProvider = class {
     }
     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_INTERVAL[normalizeTf(timeframe)];

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);
@@ -37004,6 +37040,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 +37072,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 +37123,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 +37164,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 +37361,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 +37739,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 +38164,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 +38422,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 +38466,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 +38479,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;