gloomberb 0.20.2 → 0.20.3

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (362) hide show
  1. package/README.md +1 -1
  2. package/README.zh-CN.md +1 -1
  3. package/package.json +2 -1
  4. package/src/account/auth-form.tsx +13 -8
  5. package/src/account/upgrade-dialog.tsx +1 -1
  6. package/src/api-client/central-bank-rates.ts +5 -0
  7. package/src/api-client/data.ts +17 -4
  8. package/src/api-client/debt-maturities.ts +45 -2
  9. package/src/api-client/earnings.ts +4 -2
  10. package/src/api-client/errors.ts +21 -11
  11. package/src/api-client/index.ts +1 -0
  12. package/src/api-client/paths.ts +9 -1
  13. package/src/api-client/social-mentions.ts +47 -0
  14. package/src/api-client/types/econ.ts +4 -0
  15. package/src/app.tsx +11 -1
  16. package/src/cli/command-options.ts +2 -1
  17. package/src/cli/commands/market.ts +111 -29
  18. package/src/cli/commands/options-chain.ts +23 -6
  19. package/src/cli/commands/overview.ts +13 -5
  20. package/src/cli/commands/plugins.ts +49 -18
  21. package/src/cli/commands/search.ts +25 -6
  22. package/src/cli/commands/ticker.ts +4 -2
  23. package/src/cli/fx-quote-rate.ts +49 -1
  24. package/src/cli/glossary.ts +95 -15
  25. package/src/cli/history-rows.ts +9 -25
  26. package/src/cli/index.ts +6 -38
  27. package/src/cli/known-gaps.ts +3 -3
  28. package/src/cli/listing-arg.ts +78 -18
  29. package/src/cli/name-entries.ts +3 -2
  30. package/src/cli/not-a-ticker.ts +6 -2
  31. package/src/cli/pane-functions/capabilities.ts +12 -1
  32. package/src/cli/pane-functions/function-help.ts +23 -11
  33. package/src/cli/pane-functions/headless.ts +3 -1
  34. package/src/cli/pane-functions/index.ts +32 -4
  35. package/src/cli/pane-functions/market-session.ts +8 -3
  36. package/src/cli/pane-functions/resolver.ts +18 -11
  37. package/src/cli/pane-functions/screenshot-payload.ts +36 -6
  38. package/src/cli/pane-functions/screenshot-render.ts +4 -0
  39. package/src/cli/quote-answer.ts +10 -0
  40. package/src/cli/report-tables.ts +22 -2
  41. package/src/cli/result.ts +7 -3
  42. package/src/cli/spreadsheet-hint.ts +43 -0
  43. package/src/cli/symbol-list.ts +58 -4
  44. package/src/cli/symbol-rows.ts +49 -2
  45. package/src/cli/ticker-resolution.ts +98 -5
  46. package/src/cli/unknown-command.ts +88 -0
  47. package/src/components/command-bar/assist/model.ts +6 -1
  48. package/src/components/command-bar/commands/direct/index.ts +9 -1
  49. package/src/components/command-bar/commands/registry.ts +18 -0
  50. package/src/components/command-bar/pane-actions.ts +30 -13
  51. package/src/components/command-bar/panel/index.tsx +6 -3
  52. package/src/components/command-bar/panel/prompt-binding.ts +4 -0
  53. package/src/components/command-bar/panel/types.ts +3 -0
  54. package/src/components/command-bar/routes/header-market.ts +108 -0
  55. package/src/components/command-bar/routes/root/command-items.ts +5 -0
  56. package/src/components/command-bar/routes/root/provider-search.ts +190 -32
  57. package/src/components/command-bar/routes/root/results.ts +3 -0
  58. package/src/components/command-bar/routes/root/runtime.ts +28 -5
  59. package/src/components/command-bar/routes/ticker-search/results.ts +53 -6
  60. package/src/components/command-bar/routing/list-state.ts +38 -0
  61. package/src/components/command-bar/selection-hint.ts +28 -0
  62. package/src/components/command-bar/surface/index.tsx +41 -3
  63. package/src/components/command-bar/view-model.ts +15 -0
  64. package/src/components/command-bar/workflow/tickers.ts +3 -2
  65. package/src/components/company-logo.tsx +20 -2
  66. package/src/components/data-table/export.ts +13 -8
  67. package/src/components/feedback-dialog.tsx +2 -1
  68. package/src/components/form-modal/field-row.tsx +2 -1
  69. package/src/components/input-search-bar.tsx +2 -2
  70. package/src/components/layout/double-escape-close.ts +8 -5
  71. package/src/components/layout/header.tsx +75 -44
  72. package/src/components/layout/market-summary.ts +322 -116
  73. package/src/components/layout/pane/footer/index.tsx +26 -8
  74. package/src/components/layout/pane/footer/model.ts +46 -20
  75. package/src/components/layout/pane/header.tsx +3 -2
  76. package/src/components/layout/shell/chrome.ts +15 -15
  77. package/src/components/layout/status-bar.tsx +8 -7
  78. package/src/components/layout/status-widget-space.ts +8 -0
  79. package/src/components/markdown-editor.tsx +2 -2
  80. package/src/components/onboarding/account-step/form-panel.tsx +0 -3
  81. package/src/components/onboarding/onboarding-keyboard.ts +15 -6
  82. package/src/components/onboarding/onboarding-wizard.tsx +61 -11
  83. package/src/components/onboarding/portfolio-step/broker-fields-panel.tsx +0 -1
  84. package/src/components/onboarding/portfolio-step/positions-panel.tsx +0 -2
  85. package/src/components/price-sparkline/model.ts +26 -10
  86. package/src/components/ticker/list-table-view.tsx +29 -4
  87. package/src/components/ui/button.tsx +13 -2
  88. package/src/components/ui/column-grid.tsx +18 -9
  89. package/src/components/ui/data-table/index.tsx +1 -1
  90. package/src/components/ui/data-table/opentui/index.tsx +2 -1
  91. package/src/components/ui/data-table/types.ts +18 -0
  92. package/src/components/ui/delayed-mark.tsx +3 -2
  93. package/src/components/ui/field-grid.tsx +0 -2
  94. package/src/components/ui/fields.tsx +7 -4
  95. package/src/components/ui/inline-quick-add.tsx +2 -2
  96. package/src/components/ui/key-hint-words.ts +153 -0
  97. package/src/components/ui/key-hints.tsx +73 -0
  98. package/src/components/ui/menu.tsx +3 -1
  99. package/src/components/ui/message-composer.tsx +2 -2
  100. package/src/components/ui/shortcut-hint.tsx +28 -3
  101. package/src/components/ui/tabs.tsx +7 -0
  102. package/src/components/ui/text-prompt-dialog.tsx +2 -1
  103. package/src/core/state/app/command-bar-launch.ts +3 -0
  104. package/src/data/config/store/normalize.ts +6 -0
  105. package/src/docs/snapshot.json +120 -69
  106. package/src/i18n/es.ts +24 -1
  107. package/src/i18n/ja.ts +24 -1
  108. package/src/i18n/ko.ts +24 -1
  109. package/src/i18n/zh-cn.ts +24 -1
  110. package/src/i18n/zh-tw.ts +24 -1
  111. package/src/layout/pane-manager/gridlock.ts +11 -0
  112. package/src/market-data/bars-per-year.ts +27 -9
  113. package/src/market-data/coordinator/quotes.ts +22 -3
  114. package/src/market-data/futures-board.ts +80 -0
  115. package/src/market-data/futures-contract.ts +9 -3
  116. package/src/market-data/market/change-basis.ts +2 -2
  117. package/src/market-data/market/dated-previous-close.ts +163 -47
  118. package/src/market-data/market/format.ts +14 -3
  119. package/src/market-data/market/freshness.ts +24 -7
  120. package/src/market-data/market/header-market.ts +154 -0
  121. package/src/market-data/market/index-level.ts +29 -0
  122. package/src/market-data/market/index-session-venues.ts +44 -0
  123. package/src/market-data/market/status.ts +7 -2
  124. package/src/market-data/market/venue-session.ts +72 -0
  125. package/src/market-data/model-dividend-yield.ts +23 -8
  126. package/src/market-data/options-alternatives.ts +39 -4
  127. package/src/market-data/published-apac-sessions.ts +40 -2
  128. package/src/market-data/quotes/export-identity.ts +76 -0
  129. package/src/market-data/quotes/freshness.ts +22 -0
  130. package/src/market-data/quotes/time.ts +42 -1
  131. package/src/market-data/realized-volatility.ts +11 -7
  132. package/src/market-data/tax-equivalent.ts +145 -27
  133. package/src/plugins/builtin/account-management/pane.tsx +2 -2
  134. package/src/plugins/builtin/alerts/alert-engine.ts +12 -6
  135. package/src/plugins/builtin/alerts/alert-log.ts +6 -2
  136. package/src/plugins/builtin/alerts/calendar-events.ts +74 -12
  137. package/src/plugins/builtin/alerts/cli-forms.ts +11 -1
  138. package/src/plugins/builtin/alerts/cli-move.ts +234 -0
  139. package/src/plugins/builtin/alerts/cli.ts +224 -33
  140. package/src/plugins/builtin/alerts/command.ts +33 -6
  141. package/src/plugins/builtin/alerts/event-rows.ts +18 -4
  142. package/src/plugins/builtin/alerts/events-pane.tsx +6 -2
  143. package/src/plugins/builtin/alerts/events.ts +9 -0
  144. package/src/plugins/builtin/alerts/format.ts +40 -15
  145. package/src/plugins/builtin/alerts/headless.ts +31 -18
  146. package/src/plugins/builtin/alerts/history.ts +1 -0
  147. package/src/plugins/builtin/alerts/index.tsx +86 -12
  148. package/src/plugins/builtin/alerts/live.ts +2 -1
  149. package/src/plugins/builtin/alerts/move-checks.ts +155 -0
  150. package/src/plugins/builtin/alerts/move.ts +160 -0
  151. package/src/plugins/builtin/alerts/pane.tsx +52 -22
  152. package/src/plugins/builtin/alerts/price-text.ts +62 -0
  153. package/src/plugins/builtin/alerts/price.ts +17 -0
  154. package/src/plugins/builtin/alerts/quotes.ts +84 -3
  155. package/src/plugins/builtin/alerts/scheduled-check.ts +7 -1
  156. package/src/plugins/builtin/alerts/storage.ts +20 -7
  157. package/src/plugins/builtin/alerts/types.ts +13 -0
  158. package/src/plugins/builtin/analytics/risk-client.ts +60 -39
  159. package/src/plugins/builtin/analytics/risk-episodes.ts +18 -0
  160. package/src/plugins/builtin/analytics/risk-headless.ts +20 -4
  161. package/src/plugins/builtin/analytics/risk-model.ts +68 -1
  162. package/src/plugins/builtin/analytics/risk-pane.tsx +15 -3
  163. package/src/plugins/builtin/backtest/engine.ts +4 -2
  164. package/src/plugins/builtin/backtest/window.ts +3 -1
  165. package/src/plugins/builtin/broker-manager/sign-in-end.ts +1 -1
  166. package/src/plugins/builtin/central-bank-rates/client.ts +4 -0
  167. package/src/plugins/builtin/central-bank-rates/headless.ts +1 -1
  168. package/src/plugins/builtin/central-bank-rates/model.ts +18 -8
  169. package/src/plugins/builtin/central-bank-rates/pane.tsx +6 -3
  170. package/src/plugins/builtin/chart-composer/cli-options.ts +5 -0
  171. package/src/plugins/builtin/chart-composer/headless-schema.ts +17 -1
  172. package/src/plugins/builtin/chart-composer/headless.ts +2 -0
  173. package/src/plugins/builtin/cloud/upgrade-status-widget.tsx +9 -2
  174. package/src/plugins/builtin/crypto-board/headless.ts +82 -17
  175. package/src/plugins/builtin/crypto-board/index.tsx +24 -2
  176. package/src/plugins/builtin/crypto-board/model.ts +5 -2
  177. package/src/plugins/builtin/crypto-board/pane.tsx +4 -1
  178. package/src/plugins/builtin/debt-maturities/client.ts +111 -6
  179. package/src/plugins/builtin/debt-maturities/headless.ts +84 -1
  180. package/src/plugins/builtin/debt-maturities/model.ts +97 -14
  181. package/src/plugins/builtin/debt-maturities/pane.tsx +165 -15
  182. package/src/plugins/builtin/debt-maturities/series.ts +3 -1
  183. package/src/plugins/builtin/dividend-yield/client.ts +22 -6
  184. package/src/plugins/builtin/dividend-yield/headless.ts +113 -46
  185. package/src/plugins/builtin/dividend-yield/model.ts +5 -2
  186. package/src/plugins/builtin/dividend-yield/pane.tsx +6 -3
  187. package/src/plugins/builtin/dividend-yield/ranking-reads.ts +11 -4
  188. package/src/plugins/builtin/dividend-yield/ranking.ts +113 -18
  189. package/src/plugins/builtin/dividend-yield/types.ts +2 -0
  190. package/src/plugins/builtin/dividend-yield/view.ts +3 -0
  191. package/src/plugins/builtin/econ/calendar-model.ts +21 -3
  192. package/src/plugins/builtin/econ/detail-view.tsx +5 -3
  193. package/src/plugins/builtin/econ/figures.ts +13 -0
  194. package/src/plugins/builtin/econ/fred-catalog.ts +6 -3
  195. package/src/plugins/builtin/econ/index.tsx +5 -3
  196. package/src/plugins/builtin/econ/types.ts +5 -0
  197. package/src/plugins/builtin/equity-screener/footer.ts +45 -0
  198. package/src/plugins/builtin/equity-screener/pane.tsx +4 -18
  199. package/src/plugins/builtin/equity-screener/ticker-check.tsx +2 -1
  200. package/src/plugins/builtin/fixed-income/model.ts +1 -0
  201. package/src/plugins/builtin/futures/table.tsx +1 -1
  202. package/src/plugins/builtin/futures-curve/model.ts +3 -10
  203. package/src/plugins/builtin/help/function-card.tsx +2 -1
  204. package/src/plugins/builtin/help/function-index.ts +1 -0
  205. package/src/plugins/builtin/insider/client.ts +31 -14
  206. package/src/plugins/builtin/insider/signals-model.ts +2 -7
  207. package/src/plugins/builtin/iv-history/headless.ts +1 -2
  208. package/src/plugins/builtin/iv-history/model.ts +33 -23
  209. package/src/plugins/builtin/iv-history/screen-pane.tsx +0 -3
  210. package/src/plugins/builtin/kelly-sizer/headless.ts +64 -16
  211. package/src/plugins/builtin/kelly-sizer/history.ts +37 -28
  212. package/src/plugins/builtin/kelly-sizer/pane.tsx +43 -10
  213. package/src/plugins/builtin/kelly-sizer/sections.tsx +7 -2
  214. package/src/plugins/builtin/kelly-sizer/units.ts +29 -0
  215. package/src/plugins/builtin/news/index.tsx +7 -13
  216. package/src/plugins/builtin/news/overview-headlines.tsx +117 -0
  217. package/src/plugins/builtin/news/ticker-news.ts +35 -0
  218. package/src/plugins/builtin/news/wire/news/detail-view.tsx +8 -6
  219. package/src/plugins/builtin/news/wire/news/row.ts +49 -0
  220. package/src/plugins/builtin/news/wire/news/table.tsx +9 -20
  221. package/src/plugins/builtin/options/analytics.ts +7 -2
  222. package/src/plugins/builtin/options/live-quotes.ts +6 -1
  223. package/src/plugins/builtin/options/table.ts +3 -2
  224. package/src/plugins/builtin/options/view.tsx +11 -9
  225. package/src/plugins/builtin/options-scenario/client.ts +3 -0
  226. package/src/plugins/builtin/options-scenario/headless.ts +1 -1
  227. package/src/plugins/builtin/perps/client.ts +5 -4
  228. package/src/plugins/builtin/perps/headless.ts +134 -124
  229. package/src/plugins/builtin/perps/markets-section.tsx +2 -2
  230. package/src/plugins/builtin/perps/model.ts +8 -4
  231. package/src/plugins/builtin/perps/open-market.ts +4 -4
  232. package/src/plugins/builtin/perps/venue-markets.ts +3 -6
  233. package/src/plugins/builtin/portfolio-list/cell-version.ts +1 -0
  234. package/src/plugins/builtin/portfolio-list/cli/bulk-symbols.ts +34 -10
  235. package/src/plugins/builtin/portfolio-list/cli/period-report.ts +28 -2
  236. package/src/plugins/builtin/portfolio-list/cli/portfolio-command.ts +7 -3
  237. package/src/plugins/builtin/portfolio-list/cli/render.ts +66 -22
  238. package/src/plugins/builtin/portfolio-list/grid.tsx +5 -3
  239. package/src/plugins/builtin/portfolio-list/pane/data.ts +34 -1
  240. package/src/plugins/builtin/portfolio-list/pane/index.tsx +6 -0
  241. package/src/plugins/builtin/portfolio-list/pane/streaming.ts +15 -6
  242. package/src/plugins/builtin/portfolio-list/quick-add/resolution.ts +19 -7
  243. package/src/plugins/builtin/portfolio-list/table.tsx +30 -4
  244. package/src/plugins/builtin/realized-vol/evidence.ts +33 -6
  245. package/src/plugins/builtin/realized-vol/fx-proxy.ts +135 -0
  246. package/src/plugins/builtin/realized-vol/headless.ts +44 -8
  247. package/src/plugins/builtin/realized-vol/model.ts +9 -5
  248. package/src/plugins/builtin/realized-vol/pane.tsx +49 -15
  249. package/src/plugins/builtin/sec/headless.ts +48 -6
  250. package/src/plugins/builtin/sec/index.tsx +6 -4
  251. package/src/plugins/builtin/sec/model.ts +4 -1
  252. package/src/plugins/builtin/shared/earnings-calendar.ts +2 -0
  253. package/src/plugins/builtin/shared/market-cap-bands.ts +12 -0
  254. package/src/plugins/builtin/shared/report-freshness.ts +3 -1
  255. package/src/plugins/builtin/shared/use-quote-board.ts +5 -3
  256. package/src/plugins/builtin/shared/volatility/options.ts +63 -2
  257. package/src/plugins/builtin/social-mentions/headless.ts +72 -3
  258. package/src/plugins/builtin/social-mentions/index.tsx +8 -4
  259. package/src/plugins/builtin/social-mentions/lock-note.ts +6 -2
  260. package/src/plugins/builtin/social-mentions/outliers-client.ts +101 -0
  261. package/src/plugins/builtin/social-mentions/outliers-model.ts +162 -0
  262. package/src/plugins/builtin/social-mentions/outliers-names.ts +51 -0
  263. package/src/plugins/builtin/social-mentions/outliers.tsx +276 -0
  264. package/src/plugins/builtin/social-mentions/pane.tsx +32 -3
  265. package/src/plugins/builtin/supply-chain/graph-pane.tsx +2 -2
  266. package/src/plugins/builtin/thirteenf/api.ts +36 -2
  267. package/src/plugins/builtin/thirteenf/data.ts +4 -1
  268. package/src/plugins/builtin/thirteenf/headless.ts +14 -6
  269. package/src/plugins/builtin/thirteenf/model.ts +56 -1
  270. package/src/plugins/builtin/thirteenf/pane.tsx +8 -8
  271. package/src/plugins/builtin/thirteenf/report-notes.ts +11 -0
  272. package/src/plugins/builtin/thirteenf/table.ts +2 -1
  273. package/src/plugins/builtin/thirteenf/types.ts +6 -0
  274. package/src/plugins/builtin/ticker-detail/data-panes/historical-prices.tsx +23 -3
  275. package/src/plugins/builtin/ticker-detail/financials/model.ts +5 -0
  276. package/src/plugins/builtin/ticker-detail/headless-schema.ts +2 -1
  277. package/src/plugins/builtin/ticker-detail/headless.ts +21 -66
  278. package/src/plugins/builtin/ticker-detail/index.tsx +5 -0
  279. package/src/plugins/builtin/ticker-detail/overview/components.tsx +13 -1
  280. package/src/plugins/builtin/ticker-detail/overview/model.ts +6 -4
  281. package/src/plugins/builtin/ticker-detail/overview/pane.tsx +15 -0
  282. package/src/plugins/builtin/ticker-detail/overview/tax-equivalent.ts +69 -0
  283. package/src/plugins/builtin/ticker-detail/overview-tab.tsx +41 -6
  284. package/src/plugins/builtin/ticker-detail/quote-monitor/card.tsx +47 -24
  285. package/src/plugins/builtin/ticker-detail/quote-monitor/export.ts +46 -0
  286. package/src/plugins/builtin/ticker-detail/quote-monitor/index.tsx +20 -1
  287. package/src/plugins/builtin/ticker-detail/quote-monitor/rows.ts +120 -0
  288. package/src/plugins/builtin/ticker-detail/research-tabs.ts +1 -5
  289. package/src/plugins/builtin/ticker-detail/settings.ts +6 -6
  290. package/src/plugins/builtin/treasury-auctions/cache.ts +85 -19
  291. package/src/plugins/builtin/treasury-auctions/index.tsx +22 -11
  292. package/src/plugins/builtin/treasury-auctions/model.ts +23 -0
  293. package/src/plugins/builtin/treasury-auctions/treasury-direct.ts +128 -0
  294. package/src/plugins/builtin/world-indices/client.ts +2 -0
  295. package/src/plugins/compat.ts +15 -0
  296. package/src/plugins/host-link.ts +6 -1
  297. package/src/plugins/installer.ts +8 -3
  298. package/src/portfolio/column-values.ts +14 -4
  299. package/src/portfolio/listed-symbol.ts +78 -0
  300. package/src/portfolio/real-return.ts +172 -0
  301. package/src/public/__snapshots__/public-api.test.ts.snap +1 -0
  302. package/src/renderers/browser/config-host.ts +56 -15
  303. package/src/renderers/browser/main.tsx +3 -1
  304. package/src/renderers/browser/ui-host.tsx +1 -0
  305. package/src/renderers/cloudflare/http-proxy.ts +1 -0
  306. package/src/renderers/dom/boot-frame.ts +2 -2
  307. package/src/renderers/dom/data-table/row.tsx +4 -1
  308. package/src/renderers/dom/desktop/controls.tsx +4 -4
  309. package/src/renderers/dom/desktop/dialog-actions.tsx +60 -41
  310. package/src/renderers/dom/dom-ui-host.tsx +3 -1
  311. package/src/renderers/dom/host/input.tsx +4 -1
  312. package/src/renderers/dom/host/tabs.tsx +10 -1
  313. package/src/renderers/dom/styles.css +33 -13
  314. package/src/renderers/electrobun/bun/desktop/app-name.ts +1 -1
  315. package/src/renderers/opentui/host.tsx +2 -1
  316. package/src/sources/gloomberb-cloud/fred-series.ts +12 -0
  317. package/src/sources/gloomberb-cloud/index.ts +31 -2
  318. package/src/sources/gloomberb-cloud/normalizers.ts +29 -3
  319. package/src/sources/provider-router/cached-routes.ts +19 -7
  320. package/src/state/pane-table-export-registry.ts +19 -6
  321. package/src/test-support/preload.ts +5 -1
  322. package/src/theme/colors.ts +9 -1
  323. package/src/theme/themes.ts +62 -15
  324. package/src/theme/tone-contrast.ts +40 -0
  325. package/src/theme/ui-tokens.ts +23 -3
  326. package/src/tickers/batched-lookups.ts +57 -8
  327. package/src/tickers/company-name-listing.ts +156 -14
  328. package/src/tickers/company-name.ts +30 -6
  329. package/src/tickers/list.ts +7 -0
  330. package/src/tickers/search/home-listing.ts +31 -9
  331. package/src/tickers/search/index.ts +13 -3
  332. package/src/tickers/search/listing-index.ts +558 -0
  333. package/src/tickers/search/major-listings.chunk.ts +10 -0
  334. package/src/tickers/search/major-listings.json +3346 -0
  335. package/src/tickers/search/ranking.ts +68 -1
  336. package/src/tickers/search/types.ts +4 -0
  337. package/src/tickers/terminal-codes.ts +26 -1
  338. package/src/time-series/calendar-month-returns.ts +47 -0
  339. package/src/time-series/currency-conversion.ts +130 -0
  340. package/src/time-series/hooks.ts +2 -0
  341. package/src/time-series/price-comparison.ts +34 -11
  342. package/src/time-series/resolve-context.ts +3 -0
  343. package/src/time-series/resolve.ts +14 -2
  344. package/src/time-series/spec.ts +1 -0
  345. package/src/time-series/studies/indicators.ts +4 -1
  346. package/src/time-series/types.ts +8 -0
  347. package/src/types/config.ts +8 -0
  348. package/src/types/data-provider.ts +28 -0
  349. package/src/types/financials.ts +20 -2
  350. package/src/types/headless.ts +12 -0
  351. package/src/ui/host.tsx +8 -0
  352. package/src/utils/datetime-format.ts +17 -3
  353. package/src/utils/display-number.ts +15 -0
  354. package/src/utils/double-escape-close.ts +61 -16
  355. package/src/utils/float32-price.ts +24 -0
  356. package/src/utils/forward-dividend.ts +81 -16
  357. package/src/utils/fx-market-hours.ts +11 -0
  358. package/src/utils/plugin-proxy-hosts.json +2 -1
  359. package/src/utils/price-history.ts +7 -6
  360. package/src/utils/report-timing.ts +62 -0
  361. package/src/utils/sec-filings.ts +32 -0
  362. package/src/utils/utc-time.ts +5 -0
@@ -1,4 +1,5 @@
1
1
  import { parsePublicTickerKey } from "../../../utils/exchanges";
2
+ import { currencyPairInstrument } from "../../../market-data/bars-per-year";
2
3
  import { futuresGenericCaption, futuresGenericListing } from "../../../utils/futures-generic";
3
4
  import type { BacktestHistory } from "./client";
4
5
  import { runBacktest, type BacktestOptions, type BacktestResult } from "./engine";
@@ -100,7 +101,8 @@ export function runHistoryBacktest(
100
101
  options: BacktestOptions & BacktestWindowOptions,
101
102
  ): HistoryBacktestResult {
102
103
  const window = backtestWindow(history, options);
103
- const result = runBacktest(window.bars, entry, exit, options);
104
+ // A currency pair's year is every weekday, however short the run.
105
+ const result = runBacktest(window.bars, entry, exit, { ...options, instrument: options.instrument ?? currencyPairInstrument(history.symbol) });
104
106
  return { ...result, warnings: [...window.warnings, ...result.warnings], repeatable: window.repeatable };
105
107
  }
106
108
 
@@ -27,7 +27,7 @@ export function signInEndStatus(endsAt: number, now = Date.now()): string {
27
27
  return endsAt > now ? tf("Ends {date}", { date }) : tf("Ended {date}", { date });
28
28
  }
29
29
 
30
- /** The profile detail's note: "Sign-in ends Oct 10, 2026 at 3:00 PM". */
30
+ /** The profile detail's note: "Sign-in ends Oct 10, 2026 at 3:00 PM EDT". */
31
31
  export function signInEndNote(endsAt: number, now = Date.now()): string {
32
32
  const when = formatDetailDate(endsAt);
33
33
  return endsAt > now ? tf("Sign-in ends {when}", { when }) : tf("Sign-in ended {when}", { when });
@@ -54,6 +54,10 @@ export function validateCentralBankRates(payload: CentralBankRatesPayload): Cent
54
54
  if (decision !== undefined && decision !== null && (typeof decision !== "object" || decision.date == null || !dateOrNull(decision.date)
55
55
  || row.lastChangeDate == null || decision.date > row.lastChangeDate || decision.sourceUrl == null || !urlOrNull(decision.sourceUrl)
56
56
  || !Number.isFinite(Date.parse(decision.verifiedAt)) || decision.kind !== undefined && decision.kind !== "decision" && decision.kind !== "fixing")) delete row.lastDecision;
57
+ const latest = row.latestDecision;
58
+ if (latest !== undefined && latest !== null && (typeof latest !== "object" || latest.date == null || !dateOrNull(latest.date)
59
+ || latest.sourceUrl == null || !urlOrNull(latest.sourceUrl) || !Number.isFinite(Date.parse(latest.verifiedAt))
60
+ || latest.kind !== undefined && latest.kind !== "decision" && latest.kind !== "fixing")) delete row.latestDecision;
57
61
  }
58
62
  return payload;
59
63
  }
@@ -17,7 +17,7 @@ const CITATION_FIELDS = [
17
17
 
18
18
  const BOARD_COLUMNS: HeadlessPaneColumn[] = [
19
19
  { key: "label", header: "Jurisdiction", shrink: false }, { key: "valueText", header: "Rate", align: "right" },
20
- { key: "changeText", header: "Last move", align: "right" }, { key: "lastChangeDate", header: "Change observed", shrink: false },
20
+ { key: "changeText", header: "Last change", align: "right" }, { key: "changeDate", header: "Changed", shrink: false },
21
21
  { key: "percentileValue", header: "Pctl 1Y", align: "right", stackPriority: 1, format: (value) => value == null ? "--" : Number(value).toFixed(0) },
22
22
  // A narrow terminal moves the instrument, status and percentile under each row first.
23
23
  { key: "asOf", header: "As of", shrink: false }, { key: "status", header: "Status", stackPriority: 2 }, { key: "instrument", header: "Instrument", stackPriority: 3 },
@@ -7,6 +7,12 @@ export const policyRate = (value: number | null) => value == null ? "--" : `${pe
7
7
  export const policyLevel = (row: CentralBankRow) => row.range ? `${percentText(row.range.lower)}-${percentText(row.range.upper)}%` : policyRate(row.value);
8
8
  export const policyChange = (row: CentralBankRow) => row.changeBps == null ? "--"
9
9
  : `${row.changeBps > 0 ? "+" : ""}${Number(row.changeBps.toFixed(1))}bp ${row.direction === "hike" ? "↑" : row.direction === "cut" ? "↓" : ""}`.trim();
10
+ /**
11
+ * The one date of the last change: the decision it came from, when the server
12
+ * credits one (the BoJ's 18 Sep hike, which BIS observed 24 Sep), or the day
13
+ * the new level was first observed.
14
+ */
15
+ export const policyChangeDate = (row: CentralBankRow) => row.lastDecision?.date ?? row.lastChangeDate;
10
16
  /** Members with no policy rate to publish, kept out of the board and the notices; docs/research-data.md explains them. */
11
17
  export const hasNoPolicyRate = (row: CentralBankRow) => row.status === "unavailable"
12
18
  && (row.unavailableReason === "no-policy-rate" || row.unavailableReason === "no-unified-rate");
@@ -23,7 +29,7 @@ export function policyBoardRow(row: CentralBankRow): PolicyBoardRow {
23
29
  // One country's bank leads with its flag; the euro area's with the EU's.
24
30
  const country = row.countryCodes.length === 1 ? row.countryCodes[0]! : row.label;
25
31
  return { id: row.id, label: row.label, labelDetail: row.instrument, country, value: row.value, valueText: policyLevel(row),
26
- change: row.changeBps, changeText: policyChange(row), changeAsOf: row.lastChangeDate,
32
+ change: row.changeBps, changeText: policyChange(row), changeAsOf: policyChangeDate(row),
27
33
  percentile: row.percentile.value, asOf: row.asOf, status: row.status, observation: row,
28
34
  history: policyHistory(row).flatMap((point) => point.value == null ? [] : [{ date: new Date(point.date), close: point.value }]) };
29
35
  }
@@ -99,11 +105,13 @@ export function policyNextMeetingText(row: CentralBankRow): string {
99
105
  }
100
106
 
101
107
  /**
102
- * `last decision 2026-09-18 · ` (or `last LPR fixing`) before the next
103
- * meeting on a row's detail line; nothing when the server gives no date.
108
+ * `last decision 2026-10-30 · ` (or `last LPR fixing`) before the next
109
+ * meeting on a row's detail line: the bank's latest meeting, a hold as much
110
+ * as a move, never the one its last change came from; nothing when the
111
+ * server gives no date.
104
112
  */
105
113
  export function policyLastDecisionText(row: CentralBankRow): string {
106
- const decision = row.lastDecision;
114
+ const decision = row.latestDecision;
107
115
  if (!decision) return "";
108
116
  return `last ${decision.kind === "fixing" ? "LPR fixing" : "decision"} ${decision.date} · `;
109
117
  }
@@ -112,8 +120,10 @@ export function policyLastDecisionText(row: CentralBankRow): string {
112
120
  * What an export says about one row, history aside: the board's figures, a
113
121
  * target range's bounds as numbers (`rangeLower`, `rangeUpper`; the rate is
114
122
  * its midpoint) and a citation block, `central_bank` to `citation`, named as
115
- * CSV heads them. `last_decision` is the bank's latest kept decision on or
116
- * before the observed change. Notes keep the caveats on the latest rate; the
123
+ * CSV heads them. `last_decision` is the bank's latest meeting, a hold as
124
+ * much as a move, and `changeDate` the one date of the last change (the
125
+ * decision it came from, else when it was observed; `lastChangeDate` stays the
126
+ * observation). Notes keep the caveats on the latest rate; the
117
127
  * BIS series definition goes with the history (`--history`).
118
128
  */
119
129
  export function policyExportRow(row: CentralBankRow) {
@@ -122,11 +132,11 @@ export function policyExportRow(row: CentralBankRow) {
122
132
  return {
123
133
  id: row.id, label: row.label, instrument: row.instrument, central_bank: row.centralBank,
124
134
  value: row.value, unit: row.unit, range: row.range, rangeLower: row.range?.lower ?? null, rangeUpper: row.range?.upper ?? null,
125
- valueText: board.valueText, changeBps: row.changeBps, changeText: board.changeText, lastChangeDate: row.lastChangeDate,
135
+ valueText: board.valueText, changeBps: row.changeBps, changeText: board.changeText, changeDate: policyChangeDate(row), lastChangeDate: row.lastChangeDate,
126
136
  previousValue: row.previousValue, percentileValue: row.percentile.value,
127
137
  asOf: row.asOf, lagDays: row.lagDays, status: row.status, unavailableReason: row.unavailableReason,
128
138
  source: policySource(row), series_id: row.sourceSeriesIds.join(", ") || null, source_url: policySeriesUrls(row).join(" ") || null,
129
- as_of: row.asOf, last_decision: row.lastDecision?.date ?? null, next_meeting: meeting.text, next_meeting_kind: meeting.kind,
139
+ as_of: row.asOf, last_decision: row.latestDecision?.date ?? null, next_meeting: meeting.text, next_meeting_kind: meeting.kind,
130
140
  next_meeting_source_url: meeting.sourceUrl, next_meeting_verified_at: meeting.verifiedAt,
131
141
  citation: policyCitation(row), notes: row.notes.filter((note) => !row.seriesNotes?.includes(note)),
132
142
  };
@@ -13,7 +13,7 @@ import { formatPercentileRank } from "../../../utils/format";
13
13
  import { usePaneRefreshKey } from "../../../components/data-table/table-pane";
14
14
  import { useResearchCloudSession } from "../shared/research-cloud-session";
15
15
  import { getCachedCentralBankRates, loadCentralBankRates } from "./client";
16
- import { hasNoPolicyRate, policyBoardRow, policyChange, policyHistory, policyLevel, policyNotices, policyRate } from "./model";
16
+ import { hasNoPolicyRate, policyBoardRow, policyChange, policyChangeDate, policyHistory, policyLevel, policyNotices, policyRate } from "./model";
17
17
 
18
18
  const PANELS = [{ id: "main" }];
19
19
 
@@ -27,13 +27,16 @@ function PolicyDetail({ row, width, height, focused }: { row: CentralBankRow; wi
27
27
  const items: StatItem[] = [
28
28
  { id: "level", label: row.range ? "Target range" : "Policy rate", value: policyLevel(row),
29
29
  detail: formatPercentileRank(p.value, "1Y") },
30
- { id: "move", label: "Last move", value: policyChange(row), detail: row.lastChangeDate ?? undefined },
30
+ { id: "move", label: "Last change", value: policyChange(row), detail: policyChangeDate(row) ?? undefined },
31
31
  // A target range ranks and charts its midpoint, which the band's range would not say.
32
32
  { id: "range", label: "1Y range", value: `${policyRate(p.min)} to ${policyRate(p.max)}`, detail: row.range ? "midpoint" : undefined },
33
33
  { id: "asOf", label: "As of", value: row.asOf ?? "--", tone: row.status === "stale" ? "warning" : undefined,
34
34
  detail: [row.publicationFrequency, row.lagDays == null ? null : `${row.lagDays}d lag`,
35
35
  row.confirmedAt ? `confirmed ${row.confirmedAt.slice(0, 10)}` : null, row.status === "stale" ? "stale" : null]
36
36
  .filter(Boolean).join(" · ") || undefined },
37
+ // An older server does not say which meeting was the latest: the field is left out rather than read as none.
38
+ ...row.latestDecision === undefined ? [] : [{ id: "decided", label: row.latestDecision?.kind === "fixing" ? "Last fixing" : "Last decision",
39
+ value: row.latestDecision?.date ?? "--" }],
37
40
  { id: "meeting", label: row.nextMeeting?.kind === "fixing" ? "Next fixing" : "Next meeting", value: row.nextMeeting?.date ?? "--" },
38
41
  { id: "source", label: "Source", value: row.source?.toUpperCase() ?? "--", detail: row.sourceSeriesIds.join(", ") || undefined },
39
42
  { id: "instrument", label: "Instrument", value: row.instrument, detail: row.centralBank ?? undefined, wide: true },
@@ -68,7 +71,7 @@ export function CentralBankRatesPane({ width, height, focused }: PaneProps) {
68
71
  empty={!resource.loading && !resource.error && !data} subject="central bank rates">
69
72
  {data ? <MarketBoardStack rows={rows} width={width} height={height} focused={focused}
70
73
  selectedId={selectedId} onSelectedIdChange={setSelectedId} openId={openId} onOpenIdChange={setOpenId}
71
- valueWidth={14} changeLabel="LAST MOVE" labelHeader="JURISDICTION" labelWidth={14} labelDetailHeader="INSTRUMENT" renderDetail={(row) => <PolicyDetail row={row.observation} width={width} height={Math.max(5, height - 2)} focused={focused} />} /> : null}
74
+ valueWidth={14} changeLabel="LAST CHANGE" labelHeader="JURISDICTION" labelWidth={14} labelDetailHeader="INSTRUMENT" renderDetail={(row) => <PolicyDetail row={row.observation} width={width} height={Math.max(5, height - 2)} focused={focused} />} /> : null}
72
75
  </PaneStatusBody>
73
76
  </Box>;
74
77
  }
@@ -101,6 +101,11 @@ export function applyChartComposerCapabilityOptions(
101
101
  next = { ...next, viewport: { ...next.viewport, totalReturn: true } };
102
102
  }
103
103
 
104
+ // --currency USD: every leg converted into it at each day's FX close.
105
+ if (capabilityId === "price-comparison" && typeof options.currency === "string" && /^[A-Z]{3}$/.test(options.currency)) {
106
+ next = { ...next, viewport: { ...next.viewport, currency: options.currency } };
107
+ }
108
+
104
109
  if (PRICE_CAPABILITIES.has(capabilityId) && options.axisMode) {
105
110
  const transform = options.axisMode === "percent" ? "percent" : "raw";
106
111
  next = {
@@ -4,6 +4,7 @@ import { CHART_BAR_SIZE_PRESETS, parseChartBarSize } from "../../../time-series/
4
4
  import { FINANCIAL_PERIOD_OPTION, FINANCIAL_PERIOD_COUNT_OPTION, HISTORY_RANGE_VALUES, RETURN_RANGE_VALUES } from "../shared/headless-options";
5
5
  import { DATE_OPTION_EXAMPLES } from "../../../utils/calendar-date";
6
6
  import { PRICE_WINDOW_FROM_HELP, PRICE_WINDOW_TO_HELP } from "../../../utils/price-window";
7
+ import { isCurrencyCode } from "../../../utils/currency-pair";
7
8
 
8
9
  type PaneSchema = Pick<HeadlessPaneDefinition, "argument" | "options" | "discovery">;
9
10
 
@@ -33,6 +34,13 @@ function normalizeBarSize(value: string, auto: boolean): string {
33
34
  : `Invalid --chart-resolution value "${value}". Use ${auto ? "auto, or " : ""}a count and a unit: 10m, 4h, 2d, 1wk, 3mo (up to a day of minutes or hours, a year of days or weeks, 12 months).`);
34
35
  }
35
36
 
37
+ /** `usd` as USD; anything but a three-letter currency code is refused with the form it takes. */
38
+ function normalizeCurrencyCode(value: string): string {
39
+ const code = value.trim().toUpperCase();
40
+ if (!isCurrencyCode(code)) throw new Error(`Invalid --currency value "${value}". Use a three-letter currency code: USD, EUR, TRY.`);
41
+ return code;
42
+ }
43
+
36
44
  export const paneSchemas = {
37
45
  "chart-composer-pane": {
38
46
  argument: { kind: "free-text", optional: true },
@@ -154,6 +162,14 @@ export const paneSchemas = {
154
162
  type: "boolean",
155
163
  defaultValue: false,
156
164
  },
165
+ {
166
+ key: "currency",
167
+ type: "string",
168
+ placeholder: "code",
169
+ description: "Convert every ticker into this currency at each day's FX close, so the returns carry its move against theirs",
170
+ example: "--currency USD",
171
+ normalize: normalizeCurrencyCode,
172
+ },
157
173
  {
158
174
  key: "chartResolution",
159
175
  description: BAR_SIZE_DESCRIPTION,
@@ -167,7 +183,7 @@ export const paneSchemas = {
167
183
  discovery: {
168
184
  id: "price-comparison",
169
185
  aliases: ["stock comparison", "price performance comparison", "returns comparison", "compare stock prices"],
170
- limitations: ["Compares closing-price changes in each listing's currency over shared observation dates. Cash distributions and FX conversion are excluded unless totalReturn is set, which reinvests each distribution at its ex-date close; FX conversion is never applied."],
186
+ limitations: ["Compares closing-price changes over shared observation dates, in each listing's currency unless currency is set, which converts each close at that day's FX close. Cash distributions are excluded unless totalReturn is set, which reinvests each distribution at its ex-date close."],
171
187
  screenshotReadiness: "ready",
172
188
  },
173
189
  },
@@ -31,6 +31,7 @@ import type { TickerFinancials, PricePoint, Quote } from "../../../types/financi
31
31
  import { chartQuoteOverrideKeyForTarget, getLiveChartQuoteTargets } from "../../../time-series/live-quotes";
32
32
  import { createChartSeriesResolver } from "../../../capabilities";
33
33
  import { loadFuturesContractTerms, loadFuturesPriceUnit } from "../../../market-data/futures-contract";
34
+ import { loadDailyFxCloses } from "../../../time-series/currency-conversion";
34
35
  import { canonicalExchange, isKnownExchangeCode, isUsListingExchange, parsePublicTickerKey, publicTickerKey } from "../../../utils/exchanges";
35
36
  import { zonedDateKey, zonedDateTimeParts } from "../../../utils/zoned-date-time";
36
37
  import { futuresSessionOpenMinute } from "../../../market-data/market/trading-sessions";
@@ -157,6 +158,7 @@ export async function loadChartPaneModel(
157
158
  resolveCapabilitySeries: headlessCapabilityResolver(context),
158
159
  loadFuturesPriceUnit: (symbol) => loadFuturesPriceUnit(symbol, (key) => loadFuturesContractTerms(key, context.apiClient)),
159
160
  loadEarningsHistory: (symbol) => context.apiClient.getCloudEarningsHistory(symbol, 100),
161
+ loadFxCloses: (currency, startDate) => loadDailyFxCloses(currency, startDate, context.apiClient),
160
162
  loadFredSeries: async (request) => ({
161
163
  data: await context.apiClient.getCloudFredSeries(request.seriesId, {
162
164
  startDate: request.startDate,
@@ -5,12 +5,14 @@ import { useAppLanguage } from "../../../i18n/react";
5
5
  import { Button } from "../../../components/ui/button";
6
6
  import { DelayedMark, delayedMarkWidth, useStateQuoteDelay } from "../../../components/ui/delayed-mark";
7
7
  import { Box, Text, useCommandBarShortcut, useUiCapabilities } from "../../../ui";
8
+ import { useViewport } from "../../../react/input";
8
9
  import { useThemeColors } from "../../../theme/theme-context";
9
10
  import { chatController, type ChatController } from "../chat/controller";
10
11
  import { useCloudPlanAction, useCloudUpgradeAction } from "../shared/cloud-upgrade";
11
12
  import { CLOUD_QUOTE_DELAY_MINUTES, resolvePlanAccess } from "../../../api-client/plan-access";
12
13
  import { useTrialOfferShowing } from "./trial-offer-status-widget";
13
14
  import {
15
+ NARROW_STATUS_BAR_COLUMNS,
14
16
  STATUS_WIDGET_COLUMNS,
15
17
  useOtherStatusWidgetClaims,
16
18
  useStatusWidgetClaim,
@@ -46,14 +48,19 @@ export function CloudUpgradeStatusWidget({ controller = chatController }: CloudU
46
48
  // The bar holds back its usual columns for the widgets' own text, which
47
49
  // this one shares with the account chip beside it: half of them are its
48
50
  // own. The note says "delayed" where the row has room for what it draws
49
- // past that half, and claims it, else it is the mark alone.
51
+ // past that half, and claims it, else it is the mark alone. The desktop
52
+ // and the web say it on any bar wider than a phone's, the layout tabs
53
+ // giving way; on a phone the word would cut the layout tab in front.
50
54
  const room = useStatusWidgetRoom();
55
+ const { width: barColumns } = useViewport();
51
56
  const othersClaimed = useOtherStatusWidgetClaims(CLAIM_ID);
52
57
  const word = t("delayed");
53
58
  // The mark, the space before the word, the word and the space after the note.
54
59
  const noteColumns = delayedMarkWidth(CLOUD_QUOTE_DELAY_MINUTES, false) + 1 + displayWidth(word) + 1;
55
60
  const overflow = Math.max(0, noteColumns - STATUS_WIDGET_COLUMNS / 2);
56
- const spelled = !offerShowing && (nativePaneChrome || room - STATUS_WIDGET_COLUMNS - othersClaimed >= overflow);
61
+ const spelled = !offerShowing && (nativePaneChrome
62
+ ? barColumns >= NARROW_STATUS_BAR_COLUMNS
63
+ : room - STATUS_WIDGET_COLUMNS - othersClaimed >= overflow);
57
64
  useStatusWidgetClaim(CLAIM_ID, delayed && spelled && !nativePaneChrome ? overflow : 0);
58
65
  useStateQuoteDelay(delayed);
59
66
 
@@ -17,6 +17,7 @@ import {
17
17
  withCryptoSupply,
18
18
  } from "./model";
19
19
  import { stackedSupply, supplyByCode, supplyFailure, supplyHistoryRows, supplySummaryLine } from "./supply";
20
+ import { REPORT_ROWS } from "../shared/headless-options";
20
21
 
21
22
  const NO_QUOTES = new Map();
22
23
  const number = (value: unknown) => (typeof value === "number" ? value : null);
@@ -200,15 +201,18 @@ function defiExportTables(payload: DefiTvlPayload, list: DefiList): HeadlessExpo
200
201
  ];
201
202
  }
202
203
 
204
+ /** A day's close dated `YYYY-MM-DD` reads from that day's 00:00 UTC; it is stale 36 hours after the day ends. */
205
+ const DEFI_CLOSE_STALE_MINUTES = (24 + 36) * 60;
206
+
203
207
  /**
204
208
  * `--list defi`: the largest protocols (or chains, `--by chain`) by TVL with
205
209
  * their 7D and 30D change, under the total's line. Dated by the total's day,
206
210
  * from a source that publishes it daily.
207
211
  */
208
- async function loadDefi(list: DefiList, ctx: Parameters<HeadlessPaneDefinition<"rows">["load"]>[1]) {
212
+ async function loadDefi(list: DefiList, limit: number | null, ctx: Parameters<HeadlessPaneDefinition<"rows">["load"]>[1]) {
209
213
  const payload = await fetchDefiTvl(ctx.apiClient);
210
214
  const income = defiHasIncome(payload);
211
- const rows = buildDefiRows(payload, list).map((row) => defiRecord(row, list, income));
215
+ const rows = limitRows(buildDefiRows(payload, list).map((row) => defiRecord(row, list, income)), limit);
212
216
  const summary = defiSummaryLine(payload);
213
217
  const exportTables = defiExportTables(payload, list);
214
218
  return {
@@ -225,7 +229,8 @@ async function loadDefi(list: DefiList, ctx: Parameters<HeadlessPaneDefinition<"
225
229
  status: "not-a-feed" as const,
226
230
  basis: "daily TVL",
227
231
  asOf: payload.asOf,
228
- maxAgeMinutes: 36 * 60,
232
+ // The as-of day is a close: it is aged from the day's end, not its start, and stale 36 hours after it.
233
+ maxAgeMinutes: DEFI_CLOSE_STALE_MINUTES,
229
234
  },
230
235
  metadata: {
231
236
  list: "defi",
@@ -244,18 +249,57 @@ async function loadDefi(list: DefiList, ctx: Parameters<HeadlessPaneDefinition<"
244
249
  };
245
250
  }
246
251
 
252
+ /**
253
+ * The supply columns, the supply headed with its day when that is older than
254
+ * the prices beside it (`Supply 11-04` on a board priced on the 5th): a daily
255
+ * supply figure says its date, as the prices say theirs.
256
+ */
257
+ function datedSupplyColumns(supplyAsOf: string | null | undefined, pricesAsOf: string | null | undefined): HeadlessPaneColumn[] {
258
+ const supplyDay = supplyAsOf?.slice(0, 10);
259
+ const pricesDay = pricesAsOf?.slice(0, 10);
260
+ if (!supplyDay || !pricesDay || supplyDay >= pricesDay) return STABLECOIN_SUPPLY_COLUMNS;
261
+ return STABLECOIN_SUPPLY_COLUMNS.map((column) => column.key === "supply" ? { ...column, textHeader: `Supply ${supplyDay.slice(5)}` } : column);
262
+ }
263
+
264
+ /** The first `limit` rows, in the list's order; every row without one. */
265
+ function limitRows<T>(rows: T[], limit: number | null): T[] {
266
+ return limit == null ? rows : rows.slice(0, limit);
267
+ }
268
+
269
+ /** The board's lists, as `--list` and the word after CRYP name them. */
270
+ const CRYPTO_LISTS = [
271
+ { value: "coin", aliases: ["coins"] },
272
+ { value: "stablecoin", aliases: ["stablecoins", "stable", "stables"] },
273
+ { value: "defi", aliases: ["tvl"] },
274
+ ] as const;
275
+ export type CryptoList = (typeof CRYPTO_LISTS)[number]["value"];
276
+
277
+ /**
278
+ * The list a word after CRYP names (`stablecoins`, `tvl`, `--list defi`),
279
+ * null for none typed; any other word is refused with the lists there are.
280
+ */
281
+ export function cryptoListOf(typed: string | null | undefined): CryptoList | null {
282
+ const word = (typed ?? "").trim().replace(/^--list(?:\s+|=)/i, "").trim().toLowerCase();
283
+ if (!word) return null;
284
+ const list = CRYPTO_LISTS.find((entry) => entry.value === word || (entry.aliases as readonly string[]).includes(word));
285
+ if (list) return list.value;
286
+ throw new Error(`No list "${typed!.trim()}". CRYP lists: coin, stablecoin, defi (or tvl).`);
287
+ }
288
+
289
+ /** The list a run asked for: the word after CRYP, else --list. */
290
+ function requestedList(args: { argument: string | string[] | null; options: Record<string, unknown> }): CryptoList {
291
+ const typed = Array.isArray(args.argument) ? args.argument.join(" ") : args.argument;
292
+ return cryptoListOf(typed) ?? (args.options.list === "defi" || args.options.list === "stablecoin" ? args.options.list : "coin");
293
+ }
294
+
247
295
  export const cryptoBoardHeadless: HeadlessPaneDefinition<"rows"> = {
248
296
  shape: "rows",
249
- argument: { kind: "none" },
297
+ argument: { kind: "free-text", optional: true, placeholder: "list", description: "The list to open, as --list names it: coin, stablecoin, or defi (tvl).", examples: ["stablecoin", "tvl"] },
250
298
  options: [{
251
299
  key: "list",
252
300
  description: "Coins, stablecoins, or DeFi TVL.",
253
301
  type: "enum",
254
- values: [
255
- { value: "coin", aliases: ["coins"] },
256
- { value: "stablecoin", aliases: ["stablecoins", "stable", "stables"] },
257
- { value: "defi", aliases: ["tvl"] },
258
- ],
302
+ values: CRYPTO_LISTS.map((entry) => ({ value: entry.value, aliases: [...entry.aliases] })),
259
303
  defaultValue: "coin",
260
304
  example: "--list stablecoin",
261
305
  pluginState: { pluginId: "market-overview", key: "activeTab" },
@@ -280,28 +324,48 @@ export const cryptoBoardHeadless: HeadlessPaneDefinition<"rows"> = {
280
324
  { value: "offpeg", aliases: ["off-peg", "peg", "depeg"] },
281
325
  ],
282
326
  example: "--list stablecoin --sort offpeg",
327
+ }, {
328
+ key: "limit",
329
+ shot: REPORT_ROWS,
330
+ description: "Rows to list, in the list's order: every row unless given.",
331
+ type: "integer",
332
+ minimum: 1,
333
+ maximum: 1000,
334
+ example: "--limit 10",
283
335
  }],
284
336
  columns: COIN_COLUMNS,
285
- describe: (args) => `Crypto | ${args.options.list === "defi" ? `DeFi TVL by ${args.options.by === "chain" ? "chain" : "protocol"}` : args.options.list === "stablecoin" ? "Stablecoins" : "Coins"}`,
337
+ describe: (args) => {
338
+ const list = requestedList(args);
339
+ return `Crypto | ${list === "defi" ? `DeFi TVL by ${args.options.by === "chain" ? "chain" : "protocol"}` : list === "stablecoin" ? "Stablecoins" : "Coins"}`;
340
+ },
286
341
  discovery: {
287
342
  aliases: ["CRYP"],
343
+ // `fn TVL` is the DeFi list and `fn STABLECOINS` the stablecoins, not the coins.
344
+ opens: [
345
+ { words: ["TVL", "defi", "defi tvl", "total value locked"], argument: "defi" },
346
+ { words: ["stablecoin", "stablecoins", "stables", "stablecoin supply"], argument: "stablecoin" },
347
+ ],
288
348
  dataRequirements: ["Gloom Cloud crypto markets"],
289
349
  },
290
350
  // The pane opens on the order asked for, as its header sorts it.
291
351
  shotState: (args, _load, given) => {
292
352
  const sort = given.has("sort") ? CRYPTO_SORT_OPTIONS[String(args.options.sort)] : undefined;
293
- return sort ? { pluginState: { "market-overview": { sort } } } : {};
353
+ const typed = cryptoListOf(Array.isArray(args.argument) ? args.argument.join(" ") : args.argument);
354
+ const state = { ...(sort ? { sort } : {}), ...(typed ? { activeTab: typed } : {}) };
355
+ return Object.keys(state).length ? { pluginState: { "market-overview": state } } : {};
294
356
  },
295
357
  // The board as the server read it, at most 15 seconds before; the pane streams, the report does not.
296
358
  // Each row keeps the time of its own last trade, so a coin that has not traded lately reads its age.
297
359
  freshness: CRYPTO_BOARD_FRESHNESS,
298
360
  async load(args, ctx) {
361
+ const list = requestedList(args);
299
362
  const offPeg = args.options.sort === "offpeg";
300
- if (offPeg && args.options.list !== "stablecoin") {
363
+ if (offPeg && list !== "stablecoin") {
301
364
  throw new Error("--sort offpeg orders the stablecoins by how far each is off its peg: add --list stablecoin.");
302
365
  }
303
- if (args.options.list === "defi") return loadDefi(args.options.by === "chain" ? "chain" : "protocol", ctx);
304
- const kind = args.options.list === "stablecoin" ? "stablecoin" : "coin" satisfies CryptoAssetKind;
366
+ const limit = args.options.limit == null ? null : Number(args.options.limit);
367
+ if (list === "defi") return loadDefi(args.options.by === "chain" ? "chain" : "protocol", limit, ctx);
368
+ const kind = list === "stablecoin" ? "stablecoin" : "coin" satisfies CryptoAssetKind;
305
369
  // Supply is its own request: a failure there leaves the prices whole.
306
370
  const [data, supplyResult] = await Promise.all([
307
371
  fetchCryptoMarkets(ctx.apiClient),
@@ -311,7 +375,7 @@ export const cryptoBoardHeadless: HeadlessPaneDefinition<"rows"> = {
311
375
  ]);
312
376
  const supply = supplyResult && "payload" in supplyResult ? supplyResult.payload : null;
313
377
  const built = withCryptoSupply(buildCryptoRows(data.assets, kind, NO_QUOTES), supplyByCode(supply));
314
- const rows = sortCryptoRows(built, CRYPTO_SORT_OPTIONS[String(args.options.sort ?? "mcap")] ?? { columnId: null, direction: "asc" }).map((row) => ({
378
+ const rows = limitRows(sortCryptoRows(built, CRYPTO_SORT_OPTIONS[String(args.options.sort ?? "mcap")] ?? { columnId: null, direction: "asc" }), limit).map((row) => ({
315
379
  rank: row.rank,
316
380
  symbol: row.asset.symbol,
317
381
  code: row.code,
@@ -358,7 +422,8 @@ export const cryptoBoardHeadless: HeadlessPaneDefinition<"rows"> = {
358
422
  const history = supply ? supplyHistoryTable(supply) : null;
359
423
  // A supply outage is a caveat, not a failure: the prices are the report, and they are complete.
360
424
  const notes = [
361
- ...capNote,
425
+ // A coin with a supply is valued on it, so its row counts one supply.
426
+ ...(supply?.coins.length ? ["Market cap is price times the supply shown, else times circulating supply."] : capNote),
362
427
  ...(supply?.warnings ?? []),
363
428
  ...(supplyResult && "error" in supplyResult
364
429
  ? [`${supplyFailure(errorMessage(supplyResult.error)).replace(/\.$/, "")}; the prices are complete without it.`]
@@ -366,7 +431,7 @@ export const cryptoBoardHeadless: HeadlessPaneDefinition<"rows"> = {
366
431
  ];
367
432
  return {
368
433
  rows,
369
- columns: supply?.coins.length ? STABLECOIN_SUPPLY_COLUMNS : STABLECOIN_COLUMNS,
434
+ columns: supply?.coins.length ? datedSupplyColumns(supply.asOf, data.asOf) : STABLECOIN_COLUMNS,
370
435
  ...(history ? { exportTables: [history] } : {}),
371
436
  errors: data.warnings,
372
437
  ...(notes.length ? { notes } : {}),
@@ -2,7 +2,9 @@ import type { PluginModule } from "../plugin-module";
2
2
  import { LIVE_STREAMING_QUICK_SETTING, withLiveStreamingSetting } from "../../../state/hooks/live-streaming";
3
3
  import { cryptoMarketsCache, DEFI_TVL_CACHES, STABLECOIN_SUPPLY_CACHES } from "./client";
4
4
  import { BITCOIN_NETWORK_CACHES } from "./bitcoin-network";
5
- import { cryptoBoardHeadless } from "./headless";
5
+ import { cryptoBoardHeadless, cryptoListOf } from "./headless";
6
+ import { errorMessage } from "../../../utils/errors";
7
+ import { commandTabParams } from "../shared/command-tab";
6
8
  import { CRYPTO_SERIES } from "./series";
7
9
 
8
10
  export const cryptoBoardModule: PluginModule = {
@@ -32,8 +34,28 @@ export const cryptoBoardModule: PluginModule = {
32
34
  "crypto", "cryp", "bitcoin", "ethereum", "coins", "stablecoins", "stablecoin supply", "digital", "currency",
33
35
  "defi", "tvl", "total value locked", "defi tvl", "on-chain", "onchain", "aave", "lido", "protocols", "chains",
34
36
  ],
35
- shortcut: { prefix: "CRYP" },
37
+ // `CRYP stablecoin` and `CRYP tvl` open those lists; CRYP alone opens on the list the pane was last on.
38
+ shortcut: {
39
+ prefix: "CRYP", argKind: "text", argPlaceholder: "list", argOptional: true, openWithoutArg: true,
40
+ argOptions: () => [
41
+ { value: "coin", label: "Coins" },
42
+ { value: "stablecoin", label: "Stablecoins" },
43
+ { value: "defi", label: "DeFi TVL" },
44
+ ],
45
+ argError: (arg) => {
46
+ try {
47
+ cryptoListOf(arg);
48
+ return null;
49
+ } catch (error) {
50
+ return { message: errorMessage(error), detail: "Type CRYP coin, CRYP stablecoin or CRYP tvl." };
51
+ }
52
+ },
53
+ },
36
54
  headless: cryptoBoardHeadless,
55
+ createInstance: (_context, options) => {
56
+ const list = cryptoListOf(options?.arg);
57
+ return { placement: "floating", ...(list ? { params: commandTabParams(list) } : {}) };
58
+ },
37
59
  },
38
60
  ],
39
61
  setup(ctx) {
@@ -313,7 +313,10 @@ const suppliedRows = new WeakMap<CryptoRow, { supply: CryptoRowSupply; row: Cryp
313
313
 
314
314
  /**
315
315
  * Each row with its coin's supply, matched by code. A row keeps its identity
316
- * while its price and its supply hold, so the table still skips it.
316
+ * while its price and its supply hold, so the table still skips it. A row with
317
+ * a supply is valued on it: its market cap is its price times the supply it
318
+ * shows, so the row counts one supply (USDT's Supply 178.16B at 0.9984 read
319
+ * beside a market cap on another supply, 177.42B).
317
320
  */
318
321
  export function withCryptoSupply(rows: readonly CryptoRow[], supply: ReadonlyMap<string, CryptoRowSupply>): CryptoRow[] {
319
322
  if (supply.size === 0) return rows as CryptoRow[];
@@ -322,7 +325,7 @@ export function withCryptoSupply(rows: readonly CryptoRow[], supply: ReadonlyMap
322
325
  if (!own) return row;
323
326
  const cached = suppliedRows.get(row);
324
327
  if (cached && cached.supply === own) return cached.row;
325
- const supplied = { ...row, ...own };
328
+ const supplied = { ...row, ...own, ...(own.supply != null && own.supply > 0 ? { marketCap: own.supply * row.price } : {}) };
326
329
  suppliedRows.set(row, { supply: own, row: supplied });
327
330
  return supplied;
328
331
  });
@@ -36,6 +36,7 @@ import { publicTickerKey } from "../../../utils/exchanges";
36
36
  import { formatCompact, formatCompactAmount } from "../../../utils/format";
37
37
  import { SERIES_COLORS } from "../../../theme/series-colors";
38
38
  import { usePluginPaneState, usePluginTickerActions } from "../../runtime";
39
+ import { useCommandTab } from "../shared/command-tab";
39
40
  import { useLiveStreamingSetting } from "../../../state/hooks/live-streaming";
40
41
  import { useResearchCloudSession } from "../shared/research-cloud-session";
41
42
  import { INITIAL_STREAM_RANGE, streamWindowRows } from "../shared/use-quote-board";
@@ -74,6 +75,7 @@ const CRYPTO_BOARD_REFRESH_MS = 15_000;
74
75
  const CRYPTO_BOARD_STREAMING_REFRESH_MS = 60_000;
75
76
 
76
77
  const NO_QUOTES = new Map<string, QueryEntry<Quote>>();
78
+ const CRYPTO_TAB_VALUES = CRYPTO_TABS.map((tab) => tab.value);
77
79
 
78
80
  /** Supply moves once a day; the server reads its source daily, so half-hourly is plenty. */
79
81
  const SUPPLY_REFRESH_MS = 30 * 60_000;
@@ -192,7 +194,8 @@ export function CryptoBoardPane({ width, height, focused }: PaneProps) {
192
194
  const data = resource.data?.payload;
193
195
  const { pinTicker } = usePluginTickerActions();
194
196
  const liveStreaming = useLiveStreamingSetting();
195
- const [activeTab, setActiveTab] = usePluginPaneState<CryptoTab>("activeTab", "coin");
197
+ // `CRYP stablecoin` and `CRYP tvl` open on that list, again each time either is typed.
198
+ const [activeTab, setActiveTab] = useCommandTab<CryptoTab>("crypto-board", "activeTab", CRYPTO_TAB_VALUES, "coin");
196
199
  const [selectedId, setSelectedId] = usePluginPaneState<string | null>("selected", null);
197
200
  // Kept with the pane, so `shot CRYP --sort offpeg` opens on the order it asked for.
198
201
  const [savedSort, setSavedSort] = usePluginPaneState<unknown>("sort", DEFAULT_CRYPTO_SORT);