@luxalgo/vela 0.5.4 → 0.6.1

package/dist/widget.cjs

@@ -6936,7 +6936,7 @@ var ProviderRegistry = class {
   /** Register (or replace) a provider; returns a promise that settles when its index is built. */
   register(rawName, provider) {
     const name = normName(rawName);
-    const entry = { name, provider, index: null, descriptors: [], settled: false, settle: Promise.resolve() };
+    const entry = { name, provider, index: null, prefixIndex: null, byTicker: null, descriptors: [], settled: false, settle: Promise.resolve() };
     this.entries.set(name, entry);
     entry.settle = this.buildIndex(entry);
     queueMicrotask(() => this.notify(false));
@@ -6949,6 +6949,9 @@ var ProviderRegistry = class {
         const symbols = await entry.provider.listSymbols();
         entry.descriptors = symbols;
         entry.index = new Set(symbols.map((s) => normTicker(s.ticker)));
+        entry.byTicker = new Map(symbols.map((s) => [normTicker(s.ticker), s]));
+        entry.prefixIndex = /* @__PURE__ */ new Map();
+        for (const s of symbols) if (s.prefix) entry.prefixIndex.set(`${normName(s.prefix)}:${normTicker(s.ticker)}`, s);
       }
     } catch {
       entry.index = null;
@@ -6984,14 +6987,25 @@ var ProviderRegistry = class {
   }
   /**
    * Resolve a symbol to `{ provider, ticker }`, or null when nothing can serve it
-   * yet. Explicit prefix → that provider (must be registered). Bare → first
-   * indexed provider (registration order, `opts.default` first) that contains the
-   * ticker; `opts.lenient` additionally allows a sole registered provider before
-   * its index exists.
+   * yet. Explicit prefix → that provider (must be registered), else a provider whose
+   * index declares that LISTING prefix for that ticker (`NASDAQ:AAPL` routes to the
+   * provider serving Nasdaq-listed AAPL — TradingView-strict, so `NYSE:AAPL` resolves
+   * to nothing rather than auto-correcting). Bare → first indexed provider
+   * (registration order, `opts.default` first) that contains the ticker;
+   * `opts.lenient` additionally allows a sole registered provider before its index
+   * exists.
    */
   resolve(raw, opts = {}) {
     const { provider, ticker } = this.parse(raw);
-    if (provider) return this.entries.has(provider) ? { provider, ticker } : null;
+    if (provider) {
+      if (this.entries.has(provider)) return { provider, ticker };
+      const key = `${provider}:${normTicker(ticker)}`;
+      for (const name of this.candidateOrder(opts.default)) {
+        const d = this.entries.get(name).prefixIndex?.get(key);
+        if (d) return { provider: name, ticker: d.ticker };
+      }
+      return null;
+    }
     const norm = normTicker(ticker);
     for (const name of this.candidateOrder(opts.default)) {
       if (this.entries.get(name).index?.has(norm)) return { provider: name, ticker };
@@ -7057,6 +7071,22 @@ var ProviderRegistry = class {
     }
     return names;
   }
+  /**
+   * The DISPLAY prefix for a resolved symbol — the descriptor's LISTING prefix when the
+   * data declares one, else the provider name. This is the single seam every label
+   * (legend chip, committed/persisted `PREFIX:TICKER` strings) derives from, which is
+   * what makes a non-canonical spelling impossible to display: the form always comes
+   * from the data, never from what was typed.
+   */
+  displayPrefixOf(resolved) {
+    const d = this.entries.get(resolved.provider)?.byTicker?.get(normTicker(resolved.ticker));
+    return d?.prefix ?? resolved.provider;
+  }
+  /** The canonical `PREFIX:TICKER` string for a resolved symbol (descriptor spellings). */
+  canonicalSymbol(resolved) {
+    const d = this.entries.get(resolved.provider)?.byTicker?.get(normTicker(resolved.ticker));
+    return `${d?.prefix ?? resolved.provider}:${d?.ticker ?? resolved.ticker}`;
+  }
   /** Indexed symbols for one provider (or all, concatenated) — for autocomplete. */
   symbolsOf(rawName) {
     if (rawName != null) return this.entries.get(normName(rawName))?.descriptors ?? [];
@@ -7516,7 +7546,7 @@ var EngineOrchestrator = class _EngineOrchestrator {
    *  an in-flight `setMarket` immediately (the config mutates before the load). */
   marketSnapshot() {
     const m = this.config.market;
-    return { symbol: m.symbol, provider: parseSymbol(m.symbol ?? "").provider ?? void 0, timeframe: m.timeframe, bars: m.bars, offline: m.data !== void 0 };
+    return { symbol: m.symbol, provider: parseSymbol(m.symbol ?? "").provider ?? void 0, timeframe: m.timeframe, bars: m.bars, session: m.session, offline: m.data !== void 0 };
   }
   /**
    * Switch the chart's market IN PLACE — no destroy/recreate. The renderer stays
@@ -7535,7 +7565,9 @@ var EngineOrchestrator = class _EngineOrchestrator {
    */
   async setMarket(next) {
     const m = this.config.market;
-    const identityChanged = next.symbol !== void 0 && next.symbol !== m.symbol || next.timeframe !== void 0 && next.timeframe !== m.timeframe || next.data !== void 0;
+    const identityChanged = next.symbol !== void 0 && next.symbol !== m.symbol || next.timeframe !== void 0 && next.timeframe !== m.timeframe || // A session switch changes WHICH bars exist (RTH vs ETH) — a full reload,
+    // exactly like a timeframe change; the cache keys the sessions apart.
+    next.session !== void 0 && next.session !== m.session || next.data !== void 0;
     const depthChanged = next.bars !== void 0 && next.bars !== m.bars;
     const depthOnly = depthChanged && !identityChanged && this.rawBars.length > 0 && !m.data?.length && ((next.bars ?? 0) <= this.rawBars.length || typeof this.feed.loadRange === "function");
     if (!identityChanged && !depthChanged) {
@@ -7557,6 +7589,7 @@ var EngineOrchestrator = class _EngineOrchestrator {
       if (next.symbol !== void 0) m.symbol = next.symbol;
       if (next.timeframe !== void 0) m.timeframe = next.timeframe;
       if (next.bars !== void 0) m.bars = next.bars;
+      if (next.session !== void 0) m.session = next.session;
       if (next.data !== void 0) m.data = next.data;
       else if (next.symbol !== void 0) delete m.data;
       m.visibleRange = next.visibleRange;
@@ -8910,8 +8943,8 @@ var PanesControl = class {
 };
 
 // src/data/BarStore.ts
-function seriesKey(provider, symbol, timeframe) {
-  return `${provider}|${symbol}|${timeframe}`;
+function seriesKey(provider, symbol, timeframe, session) {
+  return `${provider}|${symbol}|${timeframe}${session && session !== "regular" ? `|${session}` : ""}`;
 }
 function symbolOf(key) {
   return key.split("|")[1] ?? "";
@@ -8994,9 +9027,9 @@ var BarStore = class {
 var sharedBarStore = new BarStore();
 
 // src/data/CachingDataFeed.ts
-function cacheKey(symbol, timeframe) {
+function cacheKey(symbol, timeframe, session) {
   const { provider, ticker } = parseSymbol(symbol);
-  return seriesKey(provider ?? "", ticker, timeframe);
+  return seriesKey(provider ?? "", ticker, timeframe, session);
 }
 var PAGE_BARS = 1e4;
 var SINGLE_FETCH_BARS = PAGE_BARS + 1;
@@ -9008,7 +9041,7 @@ var CachingDataFeed = class {
   async load(cfg) {
     if (cfg.data && cfg.data.length > 0) return this.inner.load(cfg);
     const symbol = cfg.symbol ?? "TEST";
-    const key = cacheKey(symbol, cfg.timeframe ?? "60");
+    const key = cacheKey(symbol, cfg.timeframe ?? "60", cfg.session);
     this.store.retainSymbol(symbol);
     const cached = this.store.get(key);
     const n = cfg.bars ?? 500;
@@ -9037,7 +9070,7 @@ var CachingDataFeed = class {
    */
   async loadRange(cfg, range) {
     if (!this.inner.loadRange) return this.inner.load(cfg);
-    const key = cacheKey(cfg.symbol ?? "TEST", cfg.timeframe ?? "60");
+    const key = cacheKey(cfg.symbol ?? "TEST", cfg.timeframe ?? "60", cfg.session);
     let cached = this.store.get(key);
     let newest = cached?.[cached.length - 1];
     if (range.to != null && newest && range.to < newest.time) {
@@ -9195,6 +9228,20 @@ var MultiProviderFeed = class {
   resolveSymbol(raw) {
     return this.registry.resolve(raw, { default: this.primaryProvider });
   }
+  /**
+   * The DISPLAY prefix for `raw` — the descriptor's LISTING prefix when the data
+   * declares one (`NASDAQ` for AAPL), else the resolved provider name. Null while
+   * nothing resolves the symbol.
+   */
+  displayPrefix(raw) {
+    const resolved = this.resolveSymbol(raw);
+    return resolved ? this.registry.displayPrefixOf(resolved) : null;
+  }
+  /** The canonical `PREFIX:TICKER` form of `raw`, or null while unresolvable. */
+  canonicalSymbol(raw) {
+    const resolved = this.resolveSymbol(raw);
+    return resolved ? this.registry.canonicalSymbol(resolved) : null;
+  }
   /** The registered provider INSTANCE under `name` (undefined if unknown). */
   providerInstance(name) {
     return this.registry.get(name);
@@ -9330,13 +9377,13 @@ var RegistryFetchFeed = class {
     const { provider: name, ticker } = parseSymbol(cfg.symbol ?? "");
     const provider = this.registry.get(name ?? "");
     if (!provider) return Promise.resolve([]);
-    return safeBars(provider, ticker, cfg.timeframe ?? "60", { limit: cfg.bars ?? 500 });
+    return safeBars(provider, ticker, cfg.timeframe ?? "60", { limit: cfg.bars ?? 500, session: cfg.session });
   }
   loadRange(cfg, range) {
     const { provider: name, ticker } = parseSymbol(cfg.symbol ?? "");
     const provider = this.registry.get(name ?? "");
     if (!provider) return Promise.resolve([]);
-    return safeBars(provider, ticker, cfg.timeframe ?? "60", range);
+    return safeBars(provider, ticker, cfg.timeframe ?? "60", { ...range, session: cfg.session });
   }
   subscribe(cfg, onBar) {
     const { provider: name, ticker } = parseSymbol(cfg.symbol ?? "");
@@ -9344,13 +9391,13 @@ var RegistryFetchFeed = class {
     if (!provider) return () => {
     };
     const tf = cfg.timeframe ?? "60";
-    if (provider.subscribe) return provider.subscribe(ticker, tf, onBar);
+    if (provider.subscribe) return provider.subscribe(ticker, tf, onBar, cfg.session ? { session: cfg.session } : void 0);
     let stopped = false;
     let timer = null;
     const poll = async () => {
       if (stopped) return;
       try {
-        const bars = await provider.getBars(ticker, tf, { limit: 2 });
+        const bars = await provider.getBars(ticker, tf, { limit: 2, session: cfg.session });
         if (stopped) return;
         for (const b of bars) onBar(b);
       } catch {
@@ -9400,6 +9447,17 @@ var DataControl = class {
   resolve(symbol) {
     return this.registry?.resolveSymbol(symbol) ?? null;
   }
+  /**
+   * The DISPLAY prefix for `symbol` — the listing venue its descriptor declares
+   * (`NASDAQ` for AAPL) or the resolved provider name. Null while unresolvable.
+   */
+  displayPrefix(symbol) {
+    return this.registry?.displayPrefix(symbol) ?? null;
+  }
+  /** The canonical `PREFIX:TICKER` form of `symbol`, or null while unresolvable. */
+  canonicalSymbol(symbol) {
+    return this.registry?.canonicalSymbol(symbol) ?? null;
+  }
   /**
    * The registered provider INSTANCE under `name` — the seam for EXTENDED provider
    * surfaces: a provider may implement interfaces beyond the `DataProvider` port
@@ -27623,6 +27681,7 @@ var Vela = class {
         symbol: options.symbol,
         timeframe: options.timeframe,
         bars: options.bars,
+        session: options.session,
         visibleRange: options.visibleRange,
         data: options.data
       },
@@ -27912,6 +27971,9 @@ function resolveElement(container) {
   if (!element) throw new Error(`[vela] container not found for selector "${container}"`);
   return element;
 }
+
+// src/core/options.ts
+var normalizeSession = (v) => v === "regular" || v === "extended" ? v : void 0;
 function runMachine(machine5, props, render) {
   const m = new vanilla.VanillaMachine(machine5, props);
   const unsub = m.subscribe(render);
@@ -30471,10 +30533,12 @@ var CSS7 = `
     color: var(--vela-fg-muted);
     font-size: 11px;
     font-weight: 600;
-    cursor: not-allowed;
-    opacity: 0.55;
+    cursor: pointer;
 }
-.vela-bb-session-btn.is-active { color: var(--vela-fg); background: var(--vela-surface-elev); opacity: 0.8; }
+.vela-bb-session-btn:disabled { cursor: not-allowed; opacity: 0.55; }
+.vela-bb-session-btn:not(:disabled):hover { background: var(--vela-hover); color: var(--vela-fg-bright); }
+.vela-bb-session-btn.is-active { color: var(--vela-fg); background: var(--vela-surface-elev); }
+.vela-bb-session-btn.is-active:disabled { opacity: 0.8; }
 .vela-bb-settings {
     all: unset;
     display: inline-flex;
@@ -30494,6 +30558,8 @@ var Bottombar = class {
   constructor(host, opts) {
     this.settingsTip = null;
     this.rangeButtons = /* @__PURE__ */ new Map();
+    this.sessionButtons = /* @__PURE__ */ new Map();
+    this.sessionEl = null;
     this.timer = null;
     this.timezone = opts.timezone;
     const doc = host.ownerDocument;
@@ -30523,12 +30589,19 @@ var Bottombar = class {
     this.tzButton.append(this.clockEl, this.tzLabelEl);
     const session = doc.createElement("span");
     session.className = "vela-bb-session";
+    this.sessionEl = session;
     session.title = "Session \u2014 stocks & ETFs only";
-    for (const [label, active] of [["RTH", true], ["ETH", false]]) {
+    for (const [key, label] of [["regular", "RTH"], ["extended", "ETH"]]) {
       const b = doc.createElement("button");
-      b.className = "vela-bb-session-btn" + (active ? " is-active" : "");
+      b.className = "vela-bb-session-btn" + (key === "regular" ? " is-active" : "");
       b.textContent = label;
       b.disabled = true;
+      b.addEventListener("click", () => {
+        if (b.disabled) return;
+        this.setSession({ session: key, enabled: true });
+        opts.onSession?.(key);
+      });
+      this.sessionButtons.set(key, b);
       session.appendChild(b);
     }
     const settingsBtn = doc.createElement("button");
@@ -30566,6 +30639,19 @@ var Bottombar = class {
       else delete b.dataset.active;
     }
   }
+  /**
+   * Reflect the ACTIVE chart's session posture. `enabled: false` (a continuous
+   * market, or metadata not landed yet) shows the disabled RTH-active stub — the
+   * pre-session-model look, byte-for-byte. Enabled, the chips become clickable and
+   * the active one tracks the chart's current session.
+   */
+  setSession(state) {
+    if (this.sessionEl) this.sessionEl.title = state.enabled ? "Session \u2014 regular (RTH) vs extended (ETH) hours" : "Session \u2014 stocks & ETFs only";
+    for (const [key, b] of this.sessionButtons) {
+      b.disabled = !state.enabled;
+      b.classList.toggle("is-active", state.enabled ? key === state.session : key === "regular");
+    }
+  }
   destroy() {
     if (this.timer !== null) clearInterval(this.timer);
     this.tzMenu.destroy();
@@ -30608,10 +30694,11 @@ function parseQuery(raw, venues) {
 function onlyOne(matches) {
   return matches.length === 1 ? matches[0] : null;
 }
+var venueOf = (s) => s.prefix ?? s.provider;
 function filterSymbols(list, query, limit = 100) {
-  const venues = [...new Set(list.map((s) => s.provider?.toLowerCase()).filter((p) => !!p))];
+  const venues = [...new Set(list.flatMap((s) => [venueOf(s)?.toLowerCase(), s.provider?.toLowerCase()]).filter((p) => !!p))];
   const { scope, term } = parseQuery(query, venues);
-  const pool = scope ? list.filter((s) => s.provider?.toLowerCase() === scope) : list;
+  const pool = scope ? list.filter((s) => venueOf(s)?.toLowerCase() === scope || s.provider?.toLowerCase() === scope) : list;
   const q = term.toUpperCase();
   if (!q) {
     if (scope) return [...pool].sort((a, b) => a.ticker.localeCompare(b.ticker)).slice(0, limit);
@@ -30630,7 +30717,7 @@ function filterSymbols(list, query, limit = 100) {
     if (t.startsWith(q)) prefix.push(s);
     else if (t.includes(q)) substr.push(s);
     else if ((s.description ?? "").toUpperCase().includes(q)) desc.push(s);
-    else if (!scope && s.provider?.toLowerCase().includes(qLower)) venue.push(s);
+    else if (!scope && (venueOf(s)?.toLowerCase().includes(qLower) || s.provider?.toLowerCase().includes(qLower))) venue.push(s);
     if (prefix.length >= limit) break;
   }
   return [...prefix, ...substr, ...desc, ...venue].slice(0, limit);
@@ -30782,14 +30869,14 @@ var SymbolPicker = class {
       else if (e.key === "ArrowUp") this.moveHighlight(-1);
       else if (e.key === "Enter") {
         const pick = this.rows[this.highlighted];
-        if (pick) this.select(pick.ticker, pick.provider, opts.onSelect);
+        if (pick) this.select(pick.ticker, pick.prefix ?? pick.provider, opts.onSelect);
         return;
       } else return;
       e.preventDefault();
     });
     this.list.addEventListener("click", (e) => {
       const row = e.target.closest(".vela-sp-row");
-      if (row?.dataset.ticker) this.select(row.dataset.ticker, row.dataset.provider, opts.onSelect);
+      if (row?.dataset.ticker) this.select(row.dataset.ticker, row.dataset.venue, opts.onSelect);
     });
   }
   /** Wire where symbols come from (re-called on every widget rebuild). */
@@ -30806,9 +30893,9 @@ var SymbolPicker = class {
   destroy() {
     this.dialog.destroy();
   }
-  select(ticker, provider, onSelect) {
+  select(ticker, venue, onSelect) {
     this.close();
-    onSelect(provider ? `${provider.toLowerCase()}:${ticker}` : ticker);
+    onSelect(venue ? `${venue}:${ticker}` : ticker);
   }
   moveHighlight(delta) {
     if (!this.rows.length) return;
@@ -30841,7 +30928,8 @@ var SymbolPicker = class {
       const row = doc.createElement("div");
       row.className = "vela-sp-row";
       row.dataset.ticker = s.ticker;
-      if (s.provider) row.dataset.provider = s.provider;
+      const venue = s.prefix ?? s.provider;
+      if (venue) row.dataset.venue = venue;
       const av = tickerIconEl(doc, baseOf(s), s.ticker, "vela-sp-avatar");
       const main = doc.createElement("span");
       main.className = "vela-sp-main";
@@ -30853,11 +30941,11 @@ var SymbolPicker = class {
       d.textContent = s.description ?? (s.type ?? "");
       main.append(t, d);
       row.append(av, main);
-      if (s.provider) {
+      if (venue) {
         const badge = doc.createElement("span");
         badge.className = "vela-sp-badge";
-        badge.dataset.p = s.provider;
-        badge.textContent = s.provider;
+        badge.dataset.p = s.provider ?? venue;
+        badge.textContent = venue;
         row.appendChild(badge);
       }
       this.list.appendChild(row);
@@ -34630,6 +34718,7 @@ function sanitizeCell(raw) {
   if (typeof c.timeframe === "string") out.timeframe = c.timeframe;
   if (typeof c.priceStyle === "string") out.priceStyle = c.priceStyle;
   if (typeof c.bars === "number" && Number.isFinite(c.bars) && c.bars > 0) out.bars = c.bars;
+  if (c.session === "regular" || c.session === "extended") out.session = c.session;
   if (typeof c.watermark === "boolean") out.watermark = c.watermark;
   if (typeof c.indicatorTitles === "boolean") out.indicatorTitles = c.indicatorTitles;
   if (typeof c.indicatorValues === "boolean") out.indicatorValues = c.indicatorValues;
@@ -34696,7 +34785,8 @@ var PARAMS = [
   ["timeframe", "interval"],
   ["priceStyle", "style"],
   ["timezone", "tz"],
-  ["bars", "bars"]
+  ["bars", "bars"],
+  ["session", "session"]
 ];
 function readUrlState(search) {
   const out = {};
@@ -35093,6 +35183,7 @@ var VelaWidget = class {
     this.priceStyle = fromUrl.priceStyle ?? bootCell?.priceStyle ?? opts.priceStyle ?? "candles";
     this.timezone = fromUrl.timezone ?? boot?.timezone ?? opts.timezone ?? "Etc/UTC";
     this.bars = Number(fromUrl.bars ?? bootCell?.bars ?? opts.bars ?? 1e3);
+    this.session = normalizeSession(fromUrl.session ?? bootCell?.session ?? opts.session);
     this.watermarkOn = bootCell?.watermark !== void 0 ? bootCell.watermark : opts.watermark !== false;
     this.indicatorTitlesOn = bootCell?.indicatorTitles ?? true;
     this.indicatorValuesOn = bootCell?.indicatorValues ?? true;
@@ -35199,6 +35290,7 @@ var VelaWidget = class {
       timezone: this.timezone,
       onRange: (preset) => this.applyRange(preset),
       onTimezone: (zone) => this.setTimezone(zone),
+      onSession: (session) => this.setSession(session),
       onSettingsClick: () => this.inner?.renderer.openSettings()
     }) : null;
     this.mobileBar = opts.bottombar !== false ? new MobileBar(this.root, {
@@ -35428,13 +35520,15 @@ var VelaWidget = class {
     this.statusline?.setMeta(tf, this.providerLabel());
   }
   /**
-   * The provider name to show: the one that RESOLVED the symbol, not the one configured.
-   * They differ whenever the `provider` option is just a default (or names something that
-   * isn't registered) — the status line must not claim a venue that served nothing.
+   * The venue label to show: the LISTING prefix the resolved symbol's data declares
+   * (`NASDAQ` for AAPL), else the provider that RESOLVED the symbol — never the one
+   * configured or typed. They differ whenever the `provider` option is just a default,
+   * the prefix was a listing venue, or the spelling isn't registered — the status line
+   * must not claim a venue that served nothing.
    */
   providerLabel() {
-    const resolved = this.inner?.data.resolve(this.symbol)?.provider;
-    return resolved ?? parseSymbol(this.symbol).provider ?? "";
+    const display = this.inner?.data.displayPrefix(this.symbol);
+    return display ?? parseSymbol(this.symbol).provider ?? "";
   }
   setTimeframe(tf) {
     if (tf === this.timeframe || this.destroyed) return;
@@ -35445,6 +35539,30 @@ var VelaWidget = class {
     this.markStateDirty();
     void this.inner?.setMarket({ timeframe: tf, bars: this.bars });
   }
+  /**
+   * Switch the shown trading session (RTH/ETH) in place — a full reload, like a
+   * timeframe change (the two sessions are different bar series). No-op on a chart
+   * already showing that session; meaningless on continuous markets (the toggle is
+   * disabled there, but the API tolerates the call — the provider ignores the flag).
+   */
+  setSession(session) {
+    if (session === this.session || session === "regular" && this.session === void 0 || this.destroyed) return;
+    this.session = session;
+    this.refreshSessionToggle();
+    this.markStateDirty();
+    void this.inner?.setMarket({ session });
+  }
+  /** Re-derive the RTH/ETH toggle's posture from the ACTIVE symbol's metadata: enabled
+   *  iff the resolved symbol declares a real session vocabulary (not `24x7`). */
+  refreshSessionToggle() {
+    const chart = this.inner;
+    if (!chart || !this.bottombar) return;
+    void chart.data.symbolInfo(this.symbol).then((si) => {
+      if (this.destroyed || this.inner !== chart) return;
+      const enabled = typeof si?.session === "string" && si.session !== "" && si.session !== "24x7";
+      this.bottombar?.setSession({ session: this.session ?? "regular", enabled });
+    });
+  }
   /** Star/unstar a timeframe — the topbar chips and dropdown stars follow, and the
    *  set persists with the rest of the shell state. */
   setTimeframeFavorite(tf, on) {
@@ -35491,6 +35609,8 @@ var VelaWidget = class {
     cell.timeframe = live?.timeframe ?? this.timeframe;
     cell.priceStyle = this.priceStyle;
     if (this.bars > 0) cell.bars = this.bars;
+    const session = normalizeSession(live?.session ?? this.session);
+    if (session === "extended") cell.session = session;
     cell.watermark = this.watermarkOn;
     cell.indicatorTitles = this.indicatorTitlesOn;
     cell.indicatorValues = this.indicatorValuesOn;
@@ -35557,9 +35677,15 @@ var VelaWidget = class {
       const symbol = fromUrl.symbol ?? prefixedSymbol(cell);
       const timeframe = fromUrl.timeframe ?? cell.timeframe;
       const bars = Number(fromUrl.bars ?? cell.bars ?? 0);
+      const session = normalizeSession(fromUrl.session ?? cell.session);
       const next = {};
       if (symbol && symbol !== this.symbol) next.symbol = symbol;
       if (timeframe && timeframe !== this.timeframe) next.timeframe = timeframe;
+      if (session && session !== (this.session ?? "regular")) {
+        this.session = session;
+        next.session = session;
+        this.refreshSessionToggle();
+      }
       if (bars > 0 && bars !== this.bars) {
         this.bars = bars;
         next.bars = Math.max(bars, this.rangeBars);
@@ -35786,6 +35912,7 @@ var VelaWidget = class {
       symbol: this.symbol,
       timeframe: this.timeframe,
       bars: Math.max(this.bars, this.rangeBars),
+      session: this.session,
       volume: this.ledgerVolume ?? chartOpts.volume,
       // A pending range chip frames the FIRST paint (no preview flash, no re-frame).
       ...this.pendingRange ? { visibleRange: this.pendingRange.preset } : {}
@@ -35794,6 +35921,11 @@ var VelaWidget = class {
     for (const [language, make] of Object.entries(resolveEngines(engines))) chart.registerEngine(language, make());
     this.inner = chart;
     this.symbolPicker.setSource(() => chart.data.symbols());
+    void chart.data.ready().then(() => {
+      if (this.inner !== chart) return;
+      this.statusline?.setMeta(this.timeframe, this.providerLabel());
+      this.refreshSessionToggle();
+    });
     if (this.layoutCtl !== void 0) chart.renderer.setLayoutMode(this.layoutCtl.current);
     this.objectTree.setSymbol(this.symbol);
     chart.renderer.setLegendActions(legendActionsProviderFor(chart, () => this.context()));
@@ -35869,6 +36001,7 @@ var VelaWidget = class {
         this.statusline?.setSymbol(symbol);
         this.objectTree.setSymbol(symbol);
         this.watermark?.update(symbol, this.timeframe);
+        this.refreshSessionToggle();
       }
       if (timeframe !== this.timeframe) this.syncTimeframeChrome(timeframe);
     });
@@ -36166,6 +36299,8 @@ var VelaWidget = class {
         priceStyle: this.priceStyle,
         timezone: this.timezone,
         bars: String(this.bars),
+        // Empty clears the param — the default (regular) keeps links lean.
+        session: this.session === "extended" ? "extended" : "",
         watermark: this.watermarkOn ? "1" : "0",
         favorites: this.favs.join(",")
       });

package/dist/widget.d.cts

@@ -1,10 +1,10 @@
-import { W as WidgetContext, V as Vela, y as SidePanelButton } from './contributions-4Nh1jbvb.cjs';
-export { ah as DEFAULT_PANEL_ORDER, z as SidePanelDescriptor, A as SidePanelHandle, U as WidgetActionDescriptor, X as WidgetActionTarget, Y as WidgetAttachment, a4 as registerSidePanel, a5 as registerWidgetAction, a6 as registerWidgetAttachment, a8 as sidePanels, ac as unregisterSidePanel, ad as unregisterWidgetAction, ae as unregisterWidgetAttachment, af as widgetActions, ag as widgetAttachments } from './contributions-4Nh1jbvb.cjs';
-import { b as VelaOptions, q as DataWindowReadout } from './options-BlQ00Fju.cjs';
+import { W as WidgetContext, V as Vela, y as SidePanelButton } from './contributions-D64UA74H.cjs';
+export { ah as DEFAULT_PANEL_ORDER, z as SidePanelDescriptor, A as SidePanelHandle, U as WidgetActionDescriptor, X as WidgetActionTarget, Y as WidgetAttachment, a4 as registerSidePanel, a5 as registerWidgetAction, a6 as registerWidgetAttachment, a8 as sidePanels, ac as unregisterSidePanel, ad as unregisterWidgetAction, ae as unregisterWidgetAttachment, af as widgetActions, ag as widgetAttachments } from './contributions-D64UA74H.cjs';
+import { b as VelaOptions, d as MarketSession, r as DataWindowReadout } from './options-BqGeFHtp.cjs';
 import { K as KeymapManager } from './keymap-CGOz5F5f.cjs';
-import { W as WidgetHistory, b as VelaShellOptions, e as WorkspaceState, a as RangePreset, i as PersistedState, P as PanelsState } from './history-HofqYEh2.cjs';
-export { B as Bottombar, j as BottombarOptions, C as CellState, f as ChartState, I as IndicatorLoader, k as IndicatorManifest, l as IndicatorManifestEntry, m as RANGE_PRESETS, R as ResolvedIndicator, V as VelaStorage, n as WidgetStorage, g as decodeState, h as encodeState, o as legacyWidgetState, p as loadPersisted, q as localStorageAdapter, r as parsePersisted, t as resolveIndicators, s as sanitizeState, u as savePersisted } from './history-HofqYEh2.cjs';
-import { a as SymbolDescriptor } from './DataProvider-DgS2UyMc.cjs';
+import { W as WidgetHistory, b as VelaShellOptions, e as WorkspaceState, a as RangePreset, i as PersistedState, P as PanelsState } from './history-fSMXVLt1.cjs';
+export { B as Bottombar, j as BottombarOptions, C as CellState, f as ChartState, I as IndicatorLoader, k as IndicatorManifest, l as IndicatorManifestEntry, m as RANGE_PRESETS, R as ResolvedIndicator, V as VelaStorage, n as WidgetStorage, g as decodeState, h as encodeState, o as legacyWidgetState, p as loadPersisted, q as localStorageAdapter, r as parsePersisted, t as resolveIndicators, s as sanitizeState, u as savePersisted } from './history-fSMXVLt1.cjs';
+import { a as SymbolDescriptor } from './DataProvider-BNKtYU5V.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';
 
@@ -51,6 +51,8 @@ declare class VelaWidget {
     private priceStyle;
     private timezone;
     private bars;
+    /** The shown trading session — undefined = the provider default (regular). */
+    private session;
     private watermarkOn;
     /** Indicator titles (the in-chart legend rows) shown — reapplied across rebuilds. */
     private indicatorTitlesOn;
@@ -141,12 +143,24 @@ declare class VelaWidget {
      *  drifting out of sync with the topbar. */
     private syncTimeframeChrome;
     /**
-     * The provider name to show: the one that RESOLVED the symbol, not the one configured.
-     * They differ whenever the `provider` option is just a default (or names something that
-     * isn't registered) — the status line must not claim a venue that served nothing.
+     * The venue label to show: the LISTING prefix the resolved symbol's data declares
+     * (`NASDAQ` for AAPL), else the provider that RESOLVED the symbol — never the one
+     * configured or typed. They differ whenever the `provider` option is just a default,
+     * the prefix was a listing venue, or the spelling isn't registered — the status line
+     * must not claim a venue that served nothing.
      */
     private providerLabel;
     setTimeframe(tf: string): void;
+    /**
+     * Switch the shown trading session (RTH/ETH) in place — a full reload, like a
+     * timeframe change (the two sessions are different bar series). No-op on a chart
+     * already showing that session; meaningless on continuous markets (the toggle is
+     * disabled there, but the API tolerates the call — the provider ignores the flag).
+     */
+    setSession(session: MarketSession): void;
+    /** Re-derive the RTH/ETH toggle's posture from the ACTIVE symbol's metadata: enabled
+     *  iff the resolved symbol declares a real session vocabulary (not `24x7`). */
+    private refreshSessionToggle;
     /** Star/unstar a timeframe — the topbar chips and dropdown stars follow, and the
      *  set persists with the rest of the shell state. */
     private setTimeframeFavorite;
@@ -465,12 +479,6 @@ declare class Watermark {
     destroy(): void;
 }
 
-/**
- * Rank: ticker prefix > ticker substring > description substring > venue-name substring (typing
- * `binance` surfaces that venue's symbols after any literal matches). An optional venue prefix
- * (see {@link parseQuery}) scopes the pool first — venue alone browses it whole, alphabetically.
- * Pure — unit-tested.
- */
 declare function filterSymbols(list: readonly SymbolDescriptor[], query: string, limit?: number): SymbolDescriptor[];
 interface SymbolPickerOptions {
     /** `provider` is the venue of the chosen row — absent only for a source that has none. */

package/dist/widget.d.ts

@@ -1,10 +1,10 @@
-import { W as WidgetContext, V as Vela, y as SidePanelButton } from './contributions-DuIxJWeH.js';
-export { ah as DEFAULT_PANEL_ORDER, z as SidePanelDescriptor, A as SidePanelHandle, U as WidgetActionDescriptor, X as WidgetActionTarget, Y as WidgetAttachment, a4 as registerSidePanel, a5 as registerWidgetAction, a6 as registerWidgetAttachment, a8 as sidePanels, ac as unregisterSidePanel, ad as unregisterWidgetAction, ae as unregisterWidgetAttachment, af as widgetActions, ag as widgetAttachments } from './contributions-DuIxJWeH.js';
-import { b as VelaOptions, q as DataWindowReadout } from './options-BlQ00Fju.js';
+import { W as WidgetContext, V as Vela, y as SidePanelButton } from './contributions-lPAgo9Cu.js';
+export { ah as DEFAULT_PANEL_ORDER, z as SidePanelDescriptor, A as SidePanelHandle, U as WidgetActionDescriptor, X as WidgetActionTarget, Y as WidgetAttachment, a4 as registerSidePanel, a5 as registerWidgetAction, a6 as registerWidgetAttachment, a8 as sidePanels, ac as unregisterSidePanel, ad as unregisterWidgetAction, ae as unregisterWidgetAttachment, af as widgetActions, ag as widgetAttachments } from './contributions-lPAgo9Cu.js';
+import { b as VelaOptions, d as MarketSession, r as DataWindowReadout } from './options-BqGeFHtp.js';
 import { K as KeymapManager } from './keymap-CGOz5F5f.js';
-import { W as WidgetHistory, b as VelaShellOptions, e as WorkspaceState, a as RangePreset, i as PersistedState, P as PanelsState } from './history-FsmvCIo4.js';
-export { B as Bottombar, j as BottombarOptions, C as CellState, f as ChartState, I as IndicatorLoader, k as IndicatorManifest, l as IndicatorManifestEntry, m as RANGE_PRESETS, R as ResolvedIndicator, V as VelaStorage, n as WidgetStorage, g as decodeState, h as encodeState, o as legacyWidgetState, p as loadPersisted, q as localStorageAdapter, r as parsePersisted, t as resolveIndicators, s as sanitizeState, u as savePersisted } from './history-FsmvCIo4.js';
-import { a as SymbolDescriptor } from './DataProvider-Cqc_BaJ9.js';
+import { W as WidgetHistory, b as VelaShellOptions, e as WorkspaceState, a as RangePreset, i as PersistedState, P as PanelsState } from './history-CVoFDJ2D.js';
+export { B as Bottombar, j as BottombarOptions, C as CellState, f as ChartState, I as IndicatorLoader, k as IndicatorManifest, l as IndicatorManifestEntry, m as RANGE_PRESETS, R as ResolvedIndicator, V as VelaStorage, n as WidgetStorage, g as decodeState, h as encodeState, o as legacyWidgetState, p as loadPersisted, q as localStorageAdapter, r as parsePersisted, t as resolveIndicators, s as sanitizeState, u as savePersisted } from './history-CVoFDJ2D.js';
+import { a as SymbolDescriptor } from './DataProvider-gJjN_0eh.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';
 
@@ -51,6 +51,8 @@ declare class VelaWidget {
     private priceStyle;
     private timezone;
     private bars;
+    /** The shown trading session — undefined = the provider default (regular). */
+    private session;
     private watermarkOn;
     /** Indicator titles (the in-chart legend rows) shown — reapplied across rebuilds. */
     private indicatorTitlesOn;
@@ -141,12 +143,24 @@ declare class VelaWidget {
      *  drifting out of sync with the topbar. */
     private syncTimeframeChrome;
     /**
-     * The provider name to show: the one that RESOLVED the symbol, not the one configured.
-     * They differ whenever the `provider` option is just a default (or names something that
-     * isn't registered) — the status line must not claim a venue that served nothing.
+     * The venue label to show: the LISTING prefix the resolved symbol's data declares
+     * (`NASDAQ` for AAPL), else the provider that RESOLVED the symbol — never the one
+     * configured or typed. They differ whenever the `provider` option is just a default,
+     * the prefix was a listing venue, or the spelling isn't registered — the status line
+     * must not claim a venue that served nothing.
      */
     private providerLabel;
     setTimeframe(tf: string): void;
+    /**
+     * Switch the shown trading session (RTH/ETH) in place — a full reload, like a
+     * timeframe change (the two sessions are different bar series). No-op on a chart
+     * already showing that session; meaningless on continuous markets (the toggle is
+     * disabled there, but the API tolerates the call — the provider ignores the flag).
+     */
+    setSession(session: MarketSession): void;
+    /** Re-derive the RTH/ETH toggle's posture from the ACTIVE symbol's metadata: enabled
+     *  iff the resolved symbol declares a real session vocabulary (not `24x7`). */
+    private refreshSessionToggle;
     /** Star/unstar a timeframe — the topbar chips and dropdown stars follow, and the
      *  set persists with the rest of the shell state. */
     private setTimeframeFavorite;
@@ -465,12 +479,6 @@ declare class Watermark {
     destroy(): void;
 }
 
-/**
- * Rank: ticker prefix > ticker substring > description substring > venue-name substring (typing
- * `binance` surfaces that venue's symbols after any literal matches). An optional venue prefix
- * (see {@link parseQuery}) scopes the pool first — venue alone browses it whole, alphabetically.
- * Pure — unit-tested.
- */
 declare function filterSymbols(list: readonly SymbolDescriptor[], query: string, limit?: number): SymbolDescriptor[];
 interface SymbolPickerOptions {
     /** `provider` is the venue of the chosen row — absent only for a source that has none. */