gloomberb 0.16.4 → 0.16.6

package/src/i18n/zh-cn.ts

@@ -269,8 +269,6 @@ export const zhCN: Record<string, string> = {
   "Upcoming earnings, with the move options imply.": "即将发布的财报，以及期权隐含的波动。",
   "The economic calendar.": "经济日历。",
   "Ask Gloom: answers that cite filings, calls and news.": "Ask Gloom：引用文件、电话会议和新闻的回答。",
-  "Not sure of a code? Press {key} and type what you want in plain words, like \"apple earnings\". The Functions tab lists everything.": "不知道代码？按 {key}，用日常语言输入你想要的，比如 \"apple earnings\"。“功能”标签列出了全部功能。",
-  "Not sure of a code? Type what you want in plain words, like \"apple earnings\". The Functions tab lists everything.": "不知道代码？用日常语言输入你想要的，比如 \"apple earnings\"。“功能”标签列出了全部功能。",
   "Command Bar": "命令栏",
   "Manage Plugins...": "管理插件...",
   "Change Theme...": "更换主题...",
@@ -420,7 +418,7 @@ export const zhCN: Record<string, string> = {
   "Open a historical OHLCV table for a ticker.": "打开股票的历史 OHLCV 表格。",
   "Open financial statements for a ticker.": "打开股票的财务报表。",
   "Open a compact quote monitor for one or more tickers": "为一只或多只股票打开紧凑行情监控",
-  "Open another pane for the current portfolio or watchlist": "为当前组合或自选列表再开一个面板",
+  "Holdings, weights and P&L of a portfolio or watchlist; set target weights to see drift and the trades that rebalance": "组合或自选列表的持仓、权重与盈亏；设置目标权重，即可看到偏离与再平衡所需的交易",
   "Open another portfolio list pane": "再开一个组合列表面板",
   "Open another watchlist pane": "再开一个自选列表面板",
   "Open another research pane for the selected ticker or current collection": "为所选股票或当前集合再开一个研究面板",
@@ -504,7 +502,10 @@ export const zhCN: Record<string, string> = {
   // ── Help pane ────────────────────────────────────────────────
   "How To Use Gloomberb": "如何使用 Gloomberb",
   "Gloomberb is command-bar first.": "Gloomberb 以命令栏为核心。",
-  "Use the keyboard for speed, and the mouse for windows.": "键盘求快，鼠标管窗口。",
+  "Not sure of a code? Click the search bar at the top, or press {key}, and type what you want in plain words, like \"apple earnings\". The Functions tab lists everything.": "不知道代码？点击顶部的搜索栏，或按 {key}，用日常语言输入你想要的，比如 \"apple earnings\"。“功能”标签列出了全部功能。",
+  "Not sure of a code? Click the search bar at the top and type what you want in plain words, like \"apple earnings\". The Functions tab lists everything.": "不知道代码？点击顶部的搜索栏，用日常语言输入你想要的，比如 \"apple earnings\"。“功能”标签列出了全部功能。",
+  "Click anything to use it; the keys shown beside actions are shortcuts.": "点击任意内容即可使用；操作旁显示的按键是快捷键。",
+  "Open Help": "打开帮助",
   "Command Prefixes": "命令前缀",
   "Window Templates": "窗口模板",
   "No shortcut window templates are currently registered.": "当前没有已注册的快捷窗口模板。",
@@ -589,7 +590,6 @@ export const zhCN: Record<string, string> = {
   "Open the help window": "打开帮助窗口",
   "Set up a portfolio": "设置投资组合",
   "How would you like to get started?": "你想如何开始？",
-  "{shortcut} to get started.": "按 {shortcut} 开始。",
   "Edits later from the command bar.": "之后可在命令栏中修改。",
   "Create Manual Portfolio": "创建手动组合",
   "Add tickers and positions by hand": "手动添加股票与持仓",
@@ -839,6 +839,9 @@ export const zhCN: Record<string, string> = {
   "Reply to @{username}...": "回复 @{username}...",
   "Type a message...": "输入消息...",
   "Loading earlier messages...": "正在加载更早的消息...",
+  "1 new message": "1 条新消息",
+  "{count} new messages": "{count} 条新消息",
+  "Jump to the newest message": "跳到最新消息",
   "No messages yet. Be the first to say something!": "还没有消息。来发第一条吧！",
   "New DM": "新私信",
   "Recent users": "最近联系人",
@@ -1097,6 +1100,8 @@ export const zhCN: Record<string, string> = {
   "No tickers in {name}.": "{name} 中暂无股票。",
   "this collection": "此集合",
   "Press {shortcut} to add one.": "按 {shortcut} 添加。",
+  "Click {button} to add one, or press {shortcut}.": "点击 {button} 或按 {shortcut} 添加。",
+  "Add ticker": "添加代码",
   "PRE-MKT": "盘前",
   "OPEN": "盘中",
   "AFTER-HRS": "盘后",
@@ -1377,6 +1382,10 @@ export const zhCN: Record<string, string> = {
   "Continue to checkout": "前往结账",
   "{price}, billed today. Cancel anytime.": "{price}，今天扣款。随时取消。",
   "{price}. Cancel anytime.": "{price}。随时取消。",
+  "Start {days}-day free trial": "开始 {days} 天免费试用",
+  "$0 today, free for {days} days. Card required. Cancel anytime.": "今天 $0，免费 {days} 天。需要绑卡。随时取消。",
+  "Billed today. Cancel anytime.": "今天扣款。随时取消。",
+  "Card required. Cancel anytime.": "需要绑卡。随时取消。",
   "Real-time data": "实时数据",
   "Ask Gloom, MCP": "Ask Gloom、MCP",
   "Flow and X": "期权流与 X",
@@ -1465,4 +1474,55 @@ export const zhCN: Record<string, string> = {
   "Picked": "已选",
   "Follow {count} companies": "关注 {count} 家公司",
   "Following {count} companies. Alerts and your Monday brief will cover them.": "已关注 {count} 家公司。提醒和周一简报将涵盖它们。",
+
+  // ── Dialog keys on the desktop ───────────────────────────────
+  "newline": "换行",
+  "Denied in {seconds} s": "{seconds} 秒后拒绝",
+  "choose": "选择",
+  "select": "选定",
+  "confirm": "确认",
+  "presets": "预设",
+  "add": "添加",
+  "source": "来源",
+  "panel": "面板",
+  "log scale": "对数刻度",
+  "use {value}": "使用 {value}",
+  "keep the default": "保留默认值",
+  "continue": "继续",
+  "new code": "新代码",
+
+  // ── Plugins pane: starter packs ─────────────────────────────
+  "Apply a starter pack": "应用入门套装",
+  "{name} pack": "{name} 套装",
+  "Custom set": "自定义组合",
+  "{count} on": "开启 {count} 个",
+  "{count} off": "关闭 {count} 个",
+  "{count} back on": "重新开启 {count} 个",
+  "Turn off": "关闭",
+  "Turn on": "开启",
+  "Keep": "保留",
+  "Panes are hidden, not closed. Undo brings them back.": "面板只是隐藏，不会关闭。撤销即可恢复。",
+  "Apply {name}?": "应用 {name}？",
+  "{name} applied: {changes}.": "已应用 {name}：{changes}。",
+  "{name} is already what you have on.": "当前已经是 {name}。",
+  "Undo": "撤销",
+  // ── Docs (DOCS, the ? on a pane) ─────────────────────────────
+  "Docs for this pane": "本面板的文档",
+  "Docs": "文档",
+  "Open Docs": "打开文档",
+  "Read in Docs": "在文档中阅读",
+  "Read the docs and Academy lessons in the app. The ? on a pane opens its entry.": "在应用内阅读文档和学院课程。面板上的 ? 打开对应条目。",
+  "Open the focused pane's help card; Enter reads its docs.": "打开当前面板的帮助卡；按 Enter 阅读其文档。",
+  "function, page or lesson": "功能、页面或课程",
+  "Guides": "指南",
+  "Academy": "学院",
+  "offline, saved copy": "离线，已保存的副本",
+  "Open in Browser": "在浏览器中打开",
+  "No docs match \"{query}\".": "没有与“{query}”匹配的文档。",
+  "No docs for {name} yet.": "{name} 暂无文档。",
+  "Search the Docs": "搜索文档",
+  "This lesson is not saved for offline reading.": "此课程未保存以供离线阅读。",
+  "It is kept once it has been read with a connection.": "联网阅读过一次后即会保存。",
+  "Academy: {title}": "学院：{title}",
+  "{minutes} min": "{minutes} 分钟",
 };

package/src/i18n/zh-tw.ts

@@ -269,8 +269,6 @@ export const zhTW: Record<string, string> = {
   "Upcoming earnings, with the move options imply.": "即將公布的財報，以及選擇權隱含的波動。",
   "The economic calendar.": "經濟日曆。",
   "Ask Gloom: answers that cite filings, calls and news.": "Ask Gloom：引用文件、法說會和新聞的回答。",
-  "Not sure of a code? Press {key} and type what you want in plain words, like \"apple earnings\". The Functions tab lists everything.": "不知道代碼？按 {key}，用日常用語輸入你想要的，例如 \"apple earnings\"。「功能」標籤列出了全部功能。",
-  "Not sure of a code? Type what you want in plain words, like \"apple earnings\". The Functions tab lists everything.": "不知道代碼？用日常用語輸入你想要的，例如 \"apple earnings\"。「功能」標籤列出了全部功能。",
   "Command Bar": "命令列",
   "Manage Plugins...": "管理外掛...",
   "Change Theme...": "更換主題...",
@@ -420,7 +418,7 @@ export const zhTW: Record<string, string> = {
   "Open a historical OHLCV table for a ticker.": "開啟股票的歷史 OHLCV 表格。",
   "Open financial statements for a ticker.": "開啟股票的財務報表。",
   "Open a compact quote monitor for one or more tickers": "為一檔或多檔股票開啟精簡行情監控",
-  "Open another pane for the current portfolio or watchlist": "為目前組合或自選清單再開一個面板",
+  "Holdings, weights and P&L of a portfolio or watchlist; set target weights to see drift and the trades that rebalance": "組合或自選清單的持倉、權重與損益；設定目標權重，即可看到偏離與再平衡所需的交易",
   "Open another portfolio list pane": "再開一個投資組合清單面板",
   "Open another watchlist pane": "再開一個自選清單面板",
   "Open another research pane for the selected ticker or current collection": "為所選股票或目前清單再開一個研究面板",
@@ -504,7 +502,10 @@ export const zhTW: Record<string, string> = {
   // ── Help pane ────────────────────────────────────────────────
   "How To Use Gloomberb": "如何使用 Gloomberb",
   "Gloomberb is command-bar first.": "Gloomberb 以命令列為核心。",
-  "Use the keyboard for speed, and the mouse for windows.": "使用鍵盤快速操作，並用滑鼠管理視窗。",
+  "Not sure of a code? Click the search bar at the top, or press {key}, and type what you want in plain words, like \"apple earnings\". The Functions tab lists everything.": "不知道代碼？點擊頂部的搜尋列，或按 {key}，用日常用語輸入你想要的，例如 \"apple earnings\"。「功能」標籤列出了全部功能。",
+  "Not sure of a code? Click the search bar at the top and type what you want in plain words, like \"apple earnings\". The Functions tab lists everything.": "不知道代碼？點擊頂部的搜尋列，用日常用語輸入你想要的，例如 \"apple earnings\"。「功能」標籤列出了全部功能。",
+  "Click anything to use it; the keys shown beside actions are shortcuts.": "點擊任何內容即可使用；動作旁顯示的按鍵是快捷鍵。",
+  "Open Help": "開啟說明",
   "Command Prefixes": "命令字首",
   "Window Templates": "視窗範本",
   "No shortcut window templates are currently registered.": "目前沒有已註冊的快速視窗範本。",
@@ -589,7 +590,6 @@ export const zhTW: Record<string, string> = {
   "Open the help window": "開啟說明視窗",
   "Set up a portfolio": "設定投資組合",
   "How would you like to get started?": "你想如何開始？",
-  "{shortcut} to get started.": "按 {shortcut} 開始。",
   "Edits later from the command bar.": "之後可在命令列中修改。",
   "Create Manual Portfolio": "建立手動投資組合",
   "Add tickers and positions by hand": "手動新增股票與持倉",
@@ -839,6 +839,9 @@ export const zhTW: Record<string, string> = {
   "Reply to @{username}...": "回覆 @{username}...",
   "Type a message...": "輸入訊息...",
   "Loading earlier messages...": "正在載入更早的訊息...",
+  "1 new message": "1 則新訊息",
+  "{count} new messages": "{count} 則新訊息",
+  "Jump to the newest message": "跳到最新訊息",
   "No messages yet. Be the first to say something!": "還沒有訊息。來發第一條吧！",
   "New DM": "新私訊",
   "Recent users": "最近聯絡人",
@@ -1097,6 +1100,8 @@ export const zhTW: Record<string, string> = {
   "No tickers in {name}.": "{name} 中暫無股票。",
   "this collection": "此清單",
   "Press {shortcut} to add one.": "按 {shortcut} 新增。",
+  "Click {button} to add one, or press {shortcut}.": "點擊 {button} 或按 {shortcut} 新增。",
+  "Add ticker": "新增代號",
   "PRE-MKT": "盤前",
   "OPEN": "盤中",
   "AFTER-HRS": "盤後",
@@ -1377,6 +1382,10 @@ export const zhTW: Record<string, string> = {
   "Continue to checkout": "前往結帳",
   "{price}, billed today. Cancel anytime.": "{price}，今天扣款。隨時取消。",
   "{price}. Cancel anytime.": "{price}。隨時取消。",
+  "Start {days}-day free trial": "開始 {days} 天免費試用",
+  "$0 today, free for {days} days. Card required. Cancel anytime.": "今天 $0，免費 {days} 天。需要綁卡。隨時取消。",
+  "Billed today. Cancel anytime.": "今天扣款。隨時取消。",
+  "Card required. Cancel anytime.": "需要綁卡。隨時取消。",
   "Real-time data": "即時資料",
   "Ask Gloom, MCP": "Ask Gloom、MCP",
   "Flow and X": "選擇權流量與 X",
@@ -1465,4 +1474,55 @@ export const zhTW: Record<string, string> = {
   "Picked": "已選",
   "Follow {count} companies": "關注 {count} 家公司",
   "Following {count} companies. Alerts and your Monday brief will cover them.": "已關注 {count} 家公司。提醒和週一簡報將涵蓋它們。",
+
+  // ── Dialog keys on the desktop ───────────────────────────────
+  "newline": "換行",
+  "Denied in {seconds} s": "{seconds} 秒後拒絕",
+  "choose": "選擇",
+  "select": "選定",
+  "confirm": "確認",
+  "presets": "預設",
+  "add": "新增",
+  "source": "來源",
+  "panel": "面板",
+  "log scale": "對數刻度",
+  "use {value}": "使用 {value}",
+  "keep the default": "保留預設值",
+  "continue": "繼續",
+  "new code": "新代碼",
+
+  // ── Plugins pane: starter packs ─────────────────────────────
+  "Apply a starter pack": "套用入門套裝",
+  "{name} pack": "{name} 套裝",
+  "Custom set": "自訂組合",
+  "{count} on": "開啟 {count} 個",
+  "{count} off": "關閉 {count} 個",
+  "{count} back on": "重新開啟 {count} 個",
+  "Turn off": "關閉",
+  "Turn on": "開啟",
+  "Keep": "保留",
+  "Panes are hidden, not closed. Undo brings them back.": "面板只是隱藏，不會關閉。復原即可找回。",
+  "Apply {name}?": "套用 {name}？",
+  "{name} applied: {changes}.": "已套用 {name}：{changes}。",
+  "{name} is already what you have on.": "目前已經是 {name}。",
+  "Undo": "復原",
+  // ── Docs (DOCS, the ? on a pane) ─────────────────────────────
+  "Docs for this pane": "此面板的文件",
+  "Docs": "文件",
+  "Open Docs": "開啟文件",
+  "Read in Docs": "在文件中閱讀",
+  "Read the docs and Academy lessons in the app. The ? on a pane opens its entry.": "在應用程式內閱讀文件與學院課程。面板上的 ? 會開啟對應條目。",
+  "Open the focused pane's help card; Enter reads its docs.": "開啟目前面板的說明卡；按 Enter 閱讀其文件。",
+  "function, page or lesson": "功能、頁面或課程",
+  "Guides": "指南",
+  "Academy": "學院",
+  "offline, saved copy": "離線，已儲存的副本",
+  "Open in Browser": "在瀏覽器中開啟",
+  "No docs match \"{query}\".": "沒有符合「{query}」的文件。",
+  "No docs for {name} yet.": "{name} 尚無文件。",
+  "Search the Docs": "搜尋文件",
+  "This lesson is not saved for offline reading.": "此課程未儲存供離線閱讀。",
+  "It is kept once it has been read with a connection.": "連線閱讀過一次後就會儲存。",
+  "Academy: {title}": "學院：{title}",
+  "{minutes} min": "{minutes} 分鐘",
 };

package/src/layout/desks.ts

@@ -251,7 +251,7 @@ async function buildDeskPane(
     activeCollectionId: null,
   }, createOptions) ?? {};
   const capability = getPaneFunctionCapability(template, paneDef);
-  const options = normalizeCapabilityOptions(capability, { ...entry.options }, { strict: true });
+  const options = normalizeCapabilityOptions(capability, { ...entry.options }, { strict: true, code: template.shortcut?.prefix });
   const settings: Record<string, unknown> = { ...spec.settings, ...capabilityPaneSettings(capability, options) };
   const chartSpec = entry.studies?.length ? parseChartSpec(settings[CHART_SPEC_SETTING_KEY]) : null;
   if (chartSpec) {

package/src/layout/pane-manager/dock-tree.ts

@@ -261,6 +261,24 @@ export function getDockDividerLayouts(layout: LayoutConfig, bounds: LayoutBounds
   return collectDockGeometry(layout.dockRoot, bounds, [], [], [], options).dividers;
 }
 
+/**
+ * The leaves and dividers under the split at `path`, laid out in `bounds`
+ * (the split's own) as they will be once its ratio is `ratio`: what a divider
+ * drag moves, as `resizeSplitAtPath` will lay it out, without the rest of the
+ * tree. Null when no split is at `path`.
+ */
+export function getDockSplitGeometry(
+  layout: LayoutConfig,
+  path: Array<0 | 1>,
+  bounds: LayoutBounds,
+  ratio: number,
+  options?: DockGeometryOptions,
+): { leaves: DockLeafLayout[]; dividers: DockDividerLayout[] } | null {
+  const node = getNodeAtPath(layout.dockRoot, path);
+  if (!node || node.kind !== "split") return null;
+  return collectDockGeometry({ ...node, ratio: clampRatio(ratio) }, bounds, path, [], [], options);
+}
+
 function isPathPrefix(prefix: Array<0 | 1>, path: Array<0 | 1>): boolean {
   return prefix.length <= path.length && prefix.every((segment, index) => path[index] === segment);
 }

package/src/layout/pane-manager/index.ts

@@ -10,6 +10,7 @@ export {
   getDockedPaneIds,
   getDockLeafLayouts,
   getDockResizeTargets,
+  getDockSplitGeometry,
   type DockDividerLayout,
   type DockGeometryOptions,
   type DockLeafLayout,

package/src/layout-marketplace/gallery.tsx

@@ -14,7 +14,7 @@ import { apiClient, type TeamSummary } from "../api-client";
 import { requestAuthDialog } from "../plugins/builtin/cloud/auth-dialog";
 import { teamStore } from "../plugins/builtin/cloud/team/store";
 import { usePlanAccess } from "../api-client/plan-access";
-import { getMarketplaceHost } from "../plugins/builtin/plugin-marketplace/store";
+import { getMarketplaceHost } from "../plugins/marketplace/store";
 import { rememberLayoutRequirements } from "../components/layout/missing-pane";
 import type { PluginRegistry } from "../plugins/registry";
 import type { LayoutConfig } from "../types/config";

package/src/market-data/coordinator/chart.ts

@@ -45,8 +45,14 @@ function isIntradayChartRequest(request: ChartRequest, history?: QueryEntry<Pric
   return request.bufferRange === "1D" || request.bufferRange === "1W" || request.bufferRange === "1M" || request.bufferRange === "3M";
 }
 
+/**
+ * Held bars that still answer for the current window. `fetchedAt` is when
+ * they arrived: a copy received once its session had settled holds it however
+ * early its last bar, as the router judged it.
+ */
 export function normalizeFreshChartData(
   points: PricePoint[] | null | undefined, request: ChartRequest, history?: QueryEntry<PricePoint[]>["history"],
+  fetchedAt?: number | null,
 ): PricePoint[] {
   const normalized = normalizePriceHistory(points ?? []);
   const target = publicListingTarget(request.instrument.symbol, request.instrument.exchange);
@@ -58,7 +64,7 @@ export function normalizeFreshChartData(
   if (
     isIntradayChartRequest(request, history)
     && isPriceHistoryStaleForCurrentWindow(normalized, Date.now(), { symbol: target.symbol, exchange: target.exchange,
-      intervalMs: interval ? priceHistoryIntervalMs(interval) : undefined, session })
+      intervalMs: interval ? priceHistoryIntervalMs(interval) : undefined, session, fetchedAt: fetchedAt ?? undefined })
   ) {
     return [];
   }
@@ -67,7 +73,7 @@ export function normalizeFreshChartData(
 
 /** A request can cross a session/bar boundary while its upstream call is pending. */
 export function freshChartFallback(entry: QueryEntry<PricePoint[]>, request: ChartRequest): QueryEntry<PricePoint[]> {
-  const data = normalizeFreshChartData(entry.lastGoodData, request, entry.history);
+  const data = normalizeFreshChartData(entry.lastGoodData, request, entry.history, entry.fetchedAt);
   return data.length ? { ...entry, lastGoodData: data }
     : { ...entry, data: null, lastGoodData: null, history: undefined };
 }
@@ -105,7 +111,7 @@ function findChartSeedEntry({
     if (candidateKey === key) continue;
     if (!isSeedableChartRequest(request, candidateRequest)) continue;
     const entry = getEntry(candidateKey);
-    const data = normalizeFreshChartData(resolveEntryData(entry), request, entry.history);
+    const data = normalizeFreshChartData(resolveEntryData(entry), request, entry.history, entry.fetchedAt);
     if (!data?.length) continue;
     const score = getTimeRangeIndex(candidateRequest.bufferRange);
     if (!best || score > best.score) {
@@ -125,7 +131,7 @@ export function createChartLoadingEntry({
 }: ChartSeedLookupArgs & {
   current: QueryEntry<PricePoint[]>;
 }): QueryEntry<PricePoint[]> {
-  const currentData = normalizeFreshChartData(resolveEntryData(current), request, current.history);
+  const currentData = normalizeFreshChartData(resolveEntryData(current), request, current.history, current.fetchedAt);
   if (currentData.length) {
     return loadingEntry<PricePoint[]>({
       ...current,

package/src/market-data/coordinator/index.ts

@@ -22,7 +22,7 @@ import {
 import { resolveTickerFinancialsQuoteState } from "../quotes/resolution";
 import { measurePerf } from "../../utils/perf-marks";
 import { hasLikelyQuoteUnitMismatch } from "../../utils/currency-units";
-import { hasUsablePriceHistory } from "../../utils/price-history";
+import { hasUsablePriceHistory, normalizePriceHistory } from "../../utils/price-history";
 import { fxFreshUntil } from "../../utils/fx-market-hours";
 import {
   createBaselineChartRequest,
@@ -392,7 +392,7 @@ export class MarketDataCoordinator {
     const key = buildChartKey(request);
     this.chartRequests.set(key, request);
     const current = this.chartStore.get(key);
-    const currentData = normalizeFreshChartData(resolveEntryData(current), request, current.history);
+    const currentData = normalizeFreshChartData(resolveEntryData(current), request, current.history, current.fetchedAt);
     if (!options.forceRefresh && currentData.length > 0 && hasFreshEntryData(current, CHART_CACHE_TTL_MS)) {
       if (currentData !== resolveEntryData(current)) {
         return this.chartStore.update(key, (entry) =>
@@ -425,7 +425,9 @@ export class MarketDataCoordinator {
         const result = await load(requested) ?? await load({ kind: "range", range: request.bufferRange });
         if (!result) throw new Error("No chart history method is available");
         const { points, ...history } = result;
-        const data = normalizeFreshChartData(points, request, history);
+        // The router answers a copy short of the latest session only when a
+        // refetch failed, and that saved copy beats an empty chart.
+        const data = normalizePriceHistory(points);
         const source = result.sourceKey ?? this.dataProvider.id;
         const status = hasUsablePriceHistory(data) ? "success" : "empty";
         const attempts = [createAttempt(source, startedAt, status, status === "empty" ? "NO_DATA" : undefined)];
@@ -563,6 +565,7 @@ export class MarketDataCoordinator {
         fetchedAt: result?.fetchedAt ?? null,
         responseSequence: result?.responseSequence,
         asOf: result?.asOf,
+        delayMinutes: result?.delayMinutes,
         staleAt: result?.staleAt ?? null,
         error: classified ?? (!loading && empty ? { reasonCode: "NO_DATA", message: "No data available" } : null),
         attempts: result ? [createAttempt(result.source, result.fetchedAt, error ? "fatal_error" : empty ? "empty" : "success", classified?.reasonCode, classified?.message)] : [],

package/src/{plugins/builtin/futures/contracts.ts → market-data/futures-board.ts}

@@ -25,8 +25,22 @@ export interface FuturesContract {
   venue: "CME" | "CBT" | "NYM" | "CMX" | "NYB";
   /** Lists a contract for every calendar month. */
   everyMonth?: true;
-  /** False where the contract curve (CTM) does not cover the root yet. */
-  curve?: false;
+  /**
+   * What a price counts where the server sends no contract terms for the root:
+   * Dutch TTF gas quotes in euros per MWh, which a bare "EUR" does not say, and
+   * live cattle in US cents per pound, where the server's "USX" does not.
+   */
+  unit?: string;
+  /**
+   * No listed security answers to the code typed alone, so a bare TTF, ZN or 6E
+   * is this future wherever a symbol is typed. Codes a security also uses (NG
+   * is NovaGold, CL Colgate, ZM Zoom, GC several venues' listings) leave it
+   * unset: the security keeps the code and the future is its `=F` symbol.
+   * Checked with `gloomberb quote <code>` signed out on 2026-10-11: each of
+   * these was "Not a ticker", or for ZT and ZF a quote last updated in 2023 and
+   * 2021 that search no longer lists.
+   */
+  bareCode?: true;
 }
 
 /** 0.005 -> 3, 0.25 -> 2, 1 -> 0. Written for ticks, not general numbers. */
@@ -41,28 +55,28 @@ export function tickDecimals(tick: number): number {
  */
 export const FUTURES_CONTRACTS: FuturesContract[] = [
   { symbol: "ES=F", code: "ES", name: "E-Mini S&P 500", sector: "equity-index", venue: "CME", tick: 0.25 },
-  { symbol: "NQ=F", code: "NQ", name: "E-Mini Nasdaq 100", sector: "equity-index", venue: "CME", tick: 0.25 },
-  { symbol: "YM=F", code: "YM", name: "E-Mini Dow", sector: "equity-index", venue: "CBT", tick: 1 },
-  { symbol: "RTY=F", code: "RTY", name: "E-Mini Russell 2000", sector: "equity-index", venue: "CME", tick: 0.1 },
+  { symbol: "NQ=F", code: "NQ", name: "E-Mini Nasdaq 100", sector: "equity-index", venue: "CME", tick: 0.25, bareCode: true },
+  { symbol: "YM=F", code: "YM", name: "E-Mini Dow", sector: "equity-index", venue: "CBT", tick: 1, bareCode: true },
+  { symbol: "RTY=F", code: "RTY", name: "E-Mini Russell 2000", sector: "equity-index", venue: "CME", tick: 0.1, bareCode: true },
 
-  { symbol: "ZT=F", code: "ZT", name: "2-Year T-Note", sector: "rates", venue: "CBT" },
-  { symbol: "ZF=F", code: "ZF", name: "5-Year T-Note", sector: "rates", venue: "CBT" },
-  { symbol: "ZN=F", code: "ZN", name: "10-Year T-Note", sector: "rates", venue: "CBT" },
-  { symbol: "ZB=F", code: "ZB", name: "30-Year T-Bond", sector: "rates", venue: "CBT" },
-  { symbol: "UB=F", code: "UB", name: "Ultra T-Bond", sector: "rates", venue: "CBT" },
+  { symbol: "ZT=F", code: "ZT", name: "2-Year T-Note", sector: "rates", venue: "CBT", bareCode: true },
+  { symbol: "ZF=F", code: "ZF", name: "5-Year T-Note", sector: "rates", venue: "CBT", bareCode: true },
+  { symbol: "ZN=F", code: "ZN", name: "10-Year T-Note", sector: "rates", venue: "CBT", bareCode: true },
+  { symbol: "ZB=F", code: "ZB", name: "30-Year T-Bond", sector: "rates", venue: "CBT", bareCode: true },
+  { symbol: "UB=F", code: "UB", name: "Ultra T-Bond", sector: "rates", venue: "CBT", bareCode: true },
 
   { symbol: "CL=F", code: "CL", name: "WTI Crude Oil", sector: "energy", venue: "NYM", everyMonth: true, tick: 0.01 },
   { symbol: "BZ=F", code: "BZ", name: "Brent Crude Oil", sector: "energy", venue: "NYM", everyMonth: true, tick: 0.01 },
   { symbol: "NG=F", code: "NG", name: "Natural Gas", sector: "energy", venue: "NYM", everyMonth: true, tick: 0.001 },
   // Quoted in euros per MWh.
-  { symbol: "TTF=F", code: "TTF", name: "Dutch TTF Gas", sector: "energy", venue: "NYM", everyMonth: true, tick: 0.001, curve: false },
+  { symbol: "TTF=F", code: "TTF", name: "Dutch TTF Gas", sector: "energy", venue: "NYM", everyMonth: true, tick: 0.001, unit: "EUR / MWh", bareCode: true },
   { symbol: "RB=F", code: "RB", name: "RBOB Gasoline", sector: "energy", venue: "NYM", everyMonth: true, tick: 0.0001 },
   { symbol: "HO=F", code: "HO", name: "Heating Oil", sector: "energy", venue: "NYM", everyMonth: true, tick: 0.0001 },
 
   { symbol: "GC=F", code: "GC", name: "Gold", sector: "metals", venue: "CMX", tick: 0.1 },
   { symbol: "SI=F", code: "SI", name: "Silver", sector: "metals", venue: "CMX", tick: 0.005 },
   { symbol: "HG=F", code: "HG", name: "Copper", sector: "metals", venue: "CMX", tick: 0.0005 },
-  { symbol: "ALI=F", code: "ALI", name: "Aluminum", sector: "metals", venue: "CMX", tick: 0.25, curve: false },
+  { symbol: "ALI=F", code: "ALI", name: "Aluminum", sector: "metals", venue: "CMX", tick: 0.25, unit: "USD / metric ton" },
   { symbol: "PL=F", code: "PL", name: "Platinum", sector: "metals", venue: "NYM", tick: 0.1 },
   { symbol: "PA=F", code: "PA", name: "Palladium", sector: "metals", venue: "NYM", tick: 0.1 },
 
@@ -70,27 +84,27 @@ export const FUTURES_CONTRACTS: FuturesContract[] = [
   // dollars); a tick is in the quote's own units.
   { symbol: "ZC=F", code: "ZC", name: "Corn", sector: "agriculture", venue: "CBT", tick: 0.25 },
   { symbol: "ZS=F", code: "ZS", name: "Soybeans", sector: "agriculture", venue: "CBT", tick: 0.25 },
-  { symbol: "ZM=F", code: "ZM", name: "Soybean Meal", sector: "agriculture", venue: "CBT", tick: 0.1, curve: false },
-  { symbol: "ZL=F", code: "ZL", name: "Soybean Oil", sector: "agriculture", venue: "CBT", tick: 0.01, curve: false },
-  { symbol: "ZW=F", code: "ZW", name: "Chicago SRW Wheat", sector: "agriculture", venue: "CBT", tick: 0.25 },
-  { symbol: "KE=F", code: "KE", name: "KC HRW Wheat", sector: "agriculture", venue: "CBT", tick: 0.25, curve: false },
+  { symbol: "ZM=F", code: "ZM", name: "Soybean Meal", sector: "agriculture", venue: "CBT", tick: 0.1 },
+  { symbol: "ZL=F", code: "ZL", name: "Soybean Oil", sector: "agriculture", venue: "CBT", tick: 0.01, bareCode: true },
+  { symbol: "ZW=F", code: "ZW", name: "Chicago SRW Wheat", sector: "agriculture", venue: "CBT", tick: 0.25, bareCode: true },
+  { symbol: "KE=F", code: "KE", name: "KC HRW Wheat", sector: "agriculture", venue: "CBT", tick: 0.25 },
   { symbol: "KC=F", code: "KC", name: "Coffee", sector: "agriculture", venue: "NYB", tick: 0.05 },
   { symbol: "SB=F", code: "SB", name: "Sugar #11", sector: "agriculture", venue: "NYB", tick: 0.01 },
   { symbol: "CC=F", code: "CC", name: "Cocoa", sector: "agriculture", venue: "NYB", tick: 1 },
-  { symbol: "CT=F", code: "CT", name: "Cotton #2", sector: "agriculture", venue: "NYB", tick: 0.01 },
-  { symbol: "OJ=F", code: "OJ", name: "Orange Juice", sector: "agriculture", venue: "NYB", tick: 0.05, curve: false },
-  { symbol: "LBR=F", code: "LBR", name: "Lumber", sector: "agriculture", venue: "CME", tick: 0.5, curve: false },
+  { symbol: "CT=F", code: "CT", name: "Cotton #2", sector: "agriculture", venue: "NYB", tick: 0.01, bareCode: true },
+  { symbol: "OJ=F", code: "OJ", name: "Orange Juice", sector: "agriculture", venue: "NYB", tick: 0.05, unit: "US cents / lb", bareCode: true },
+  { symbol: "LBR=F", code: "LBR", name: "Lumber", sector: "agriculture", venue: "CME", tick: 0.5, unit: "USD / 1,000 board ft", bareCode: true },
 
   // Quoted in US cents per pound.
-  { symbol: "LE=F", code: "LE", name: "Live Cattle", sector: "livestock", venue: "CME", tick: 0.025, curve: false },
-  { symbol: "HE=F", code: "HE", name: "Lean Hogs", sector: "livestock", venue: "CME", tick: 0.025, curve: false },
-
-  { symbol: "6E=F", code: "6E", name: "Euro FX", sector: "currencies", venue: "CME", tick: 0.00005 },
-  { symbol: "6J=F", code: "6J", name: "Japanese Yen", sector: "currencies", venue: "CME", tick: 0.0000005 },
-  { symbol: "6B=F", code: "6B", name: "British Pound", sector: "currencies", venue: "CME", tick: 0.0001 },
-  { symbol: "6A=F", code: "6A", name: "Australian Dollar", sector: "currencies", venue: "CME", tick: 0.00005 },
-  { symbol: "6C=F", code: "6C", name: "Canadian Dollar", sector: "currencies", venue: "CME", tick: 0.00005 },
-  { symbol: "6S=F", code: "6S", name: "Swiss Franc", sector: "currencies", venue: "CME", tick: 0.00005 },
+  { symbol: "LE=F", code: "LE", name: "Live Cattle", sector: "livestock", venue: "CME", tick: 0.025, unit: "US cents / lb" },
+  { symbol: "HE=F", code: "HE", name: "Lean Hogs", sector: "livestock", venue: "CME", tick: 0.025, unit: "US cents / lb" },
+
+  { symbol: "6E=F", code: "6E", name: "Euro FX", sector: "currencies", venue: "CME", tick: 0.00005, bareCode: true },
+  { symbol: "6J=F", code: "6J", name: "Japanese Yen", sector: "currencies", venue: "CME", tick: 0.0000005, bareCode: true },
+  { symbol: "6B=F", code: "6B", name: "British Pound", sector: "currencies", venue: "CME", tick: 0.0001, bareCode: true },
+  { symbol: "6A=F", code: "6A", name: "Australian Dollar", sector: "currencies", venue: "CME", tick: 0.00005, bareCode: true },
+  { symbol: "6C=F", code: "6C", name: "Canadian Dollar", sector: "currencies", venue: "CME", tick: 0.00005, bareCode: true },
+  { symbol: "6S=F", code: "6S", name: "Swiss Franc", sector: "currencies", venue: "CME", tick: 0.00005, bareCode: true },
 ];
 
 export const FUTURES_SECTOR_LABELS: Record<FuturesSector, string> = {
@@ -120,3 +134,42 @@ export function getContractsBySector(): Map<FuturesSector, FuturesContract[]> {
   }
   return map;
 }
+
+const BY_CODE: ReadonlyMap<string, FuturesContract> = new Map(FUTURES_CONTRACTS.map((contract) => [contract.code, contract]));
+const BY_SYMBOL: ReadonlyMap<string, FuturesContract> = new Map(FUTURES_CONTRACTS.map((contract) => [contract.symbol, contract]));
+
+const typed = (value: unknown) => typeof value === "string" ? value.trim().toUpperCase() : "";
+
+/** The board row a bare code names, in any case: NG is Natural Gas whether or not a security also uses NG. */
+export function futuresContractByCode(code: unknown): FuturesContract | null {
+  return BY_CODE.get(typed(code)) ?? null;
+}
+
+/**
+ * The board row a futures function's typed argument names, by code or
+ * continuous symbol: ttf, TTF and TTF=F are Dutch TTF Gas. A typed argument
+ * always means the future, so NG here is natural gas, never NovaGold.
+ */
+export function futuresBoardContract(value: unknown): FuturesContract | null {
+  return BY_SYMBOL.get(typed(value)) ?? futuresContractByCode(value);
+}
+
+/**
+ * The future a bare symbol typed for a security stands for: a code no listed
+ * security answers to (TTF is TTF=F). Null for every other symbol, and for a
+ * code a security keeps (NG), whose future is NG=F.
+ */
+export function bareFuturesCode(symbol: unknown): FuturesContract | null {
+  const contract = futuresContractByCode(symbol);
+  return contract?.bareCode ? contract : null;
+}
+
+/**
+ * The board row the ticker under the cursor names, for a futures function
+ * opened without an argument: its continuous symbol (NG=F) or a code no
+ * security answers to (TTF). A bare code a security keeps (NG, ZM, PL) is that
+ * security's, never the future's.
+ */
+export function futuresBoardContractForTicker(ticker: unknown): FuturesContract | null {
+  return BY_SYMBOL.get(typed(ticker)) ?? bareFuturesCode(ticker);
+}