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
@@ -213,6 +213,10 @@ export interface ShowCollectionOptions {
213
213
  costFxHistory?: CostFxHistoryClient;
214
214
  /** `--from`/`--to`: P&L and contribution by position between two closes, in place of the valuation. */
215
215
  period?: PriceWindow;
216
+ /** `--real`: the period's return after the book currency's consumer prices too. */
217
+ real?: boolean;
218
+ /** Where `--real` reads the CPI; Gloom Cloud by default. */
219
+ cpi?: Parameters<typeof showPeriodPnl>[0]["cpi"];
216
220
  }
217
221
 
218
222
  export async function showCollection(name: string, ctx: CliCommandContext, options: ShowCollectionOptions = {}) {
@@ -241,35 +245,65 @@ export function findCollection(config: AppConfig, name: string): CollectionMatch
241
245
 
242
246
  type CollectionQuote = Awaited<ReturnType<DataProvider["getQuote"]>>;
243
247
 
248
+ /** Listings of a watchlist quoted in one request: as many as a signed-out caller's batch may read. */
249
+ const QUOTE_BATCH_SIZE = 100;
250
+
244
251
  /**
245
252
  * Current quotes for a collection's tickers, keyed by symbol. A portfolio
246
253
  * quotes each holding's own contract; a failed quote leaves its ticker out so
247
- * the rest still values.
254
+ * the rest still values. A watchlist's tickers, which name no contract, are
255
+ * asked in batch requests where the source takes them: a list of two hundred
256
+ * names is a couple of requests, not two hundred at once.
248
257
  */
249
258
  export async function loadCollectionQuotes(
250
259
  tickers: readonly TickerRecord[],
251
260
  collection: Pick<CollectionMatch, "kind" | "id">,
252
- dataProvider: Pick<DataProvider, "getQuote">,
261
+ dataProvider: Pick<DataProvider, "getQuote"> & Partial<Pick<DataProvider, "getQuotesBatch">>,
253
262
  /** The report prints what the day's move is from (`Day's move ... vs Thu 22 Oct close`). */
254
263
  { datesChangeBasis = false }: { datesChangeBasis?: boolean } = {},
255
264
  ): Promise<Map<string, CollectionQuote>> {
256
265
  const isPortfolio = collection.kind === "portfolio";
257
266
  const quotes = new Map<string, CollectionQuote>();
258
- await Promise.all(
259
- tickers.map(async (ticker) => {
260
- try {
261
- const instrument = isPortfolio ? instrumentFromTicker(ticker, ticker.metadata.ticker, { portfolioId: collection.id }) : null;
262
- if (isPortfolio && !instrument) return;
263
- const context = instrument ? toMarketDataContext(instrument) : undefined;
264
- const quote = await dataProvider.getQuote(ticker.metadata.ticker, ticker.metadata.exchange,
265
- datesChangeBasis ? { ...context, datesChangeBasis } : context);
266
- quotes.set(ticker.metadata.ticker, quote);
267
- } catch (error) {
268
- // A partial quote failure leaves the rest of the table rendering.
269
- logFailure("portfolio-list.cli.render", "Load collection quote failed")(error);
270
- }
271
- }),
272
- );
267
+ const failed = logFailure("portfolio-list.cli.render", "Load collection quote failed");
268
+ const quoteOne = async (ticker: TickerRecord) => {
269
+ try {
270
+ const instrument = isPortfolio ? instrumentFromTicker(ticker, ticker.metadata.ticker, { portfolioId: collection.id }) : null;
271
+ if (isPortfolio && !instrument) return;
272
+ const context = instrument ? toMarketDataContext(instrument) : undefined;
273
+ const quote = await dataProvider.getQuote(ticker.metadata.ticker, ticker.metadata.exchange,
274
+ datesChangeBasis ? { ...context, datesChangeBasis } : context);
275
+ quotes.set(ticker.metadata.ticker, quote);
276
+ } catch (error) {
277
+ // A partial quote failure leaves the rest of the table rendering.
278
+ failed(error);
279
+ }
280
+ };
281
+ const batch = !isPortfolio && tickers.length > 1 ? dataProvider.getQuotesBatch : undefined;
282
+ if (!batch) {
283
+ await Promise.all(tickers.map(quoteOne));
284
+ return quotes;
285
+ }
286
+ const targets = tickers.map((ticker) => ({ symbol: ticker.metadata.ticker, exchange: ticker.metadata.exchange ?? "", surface: "watchlist" as const }));
287
+ // A hundred listings a request, as many as the service reads in one for a signed-out caller.
288
+ const results = (await Promise.all(chunked(targets, QUOTE_BATCH_SIZE).map((chunk) =>
289
+ batch.call(dataProvider, chunk, datesChangeBasis ? { datesChangeBasis } : undefined).catch((error: unknown) => {
290
+ failed(error);
291
+ return [];
292
+ })))).flat();
293
+ // A batch that failed, or left a ticker without a quote or a reason, asks those one at a time.
294
+ // Each answer by the listing it names, never by its place: a source may answer in another order.
295
+ const key = (target: { symbol: string; exchange?: string }) => `${target.symbol.toUpperCase()}|${(target.exchange ?? "").toUpperCase()}`;
296
+ const answered = new Map(results.map((result) => [result.target, result] as const));
297
+ const byListing = new Map(results.map((result) => [key(result.target), result] as const));
298
+ const retry: TickerRecord[] = [];
299
+ tickers.forEach((ticker, index) => {
300
+ const target = targets[index]!;
301
+ const result = answered.get(target) ?? byListing.get(key(target));
302
+ if (result?.quote) quotes.set(ticker.metadata.ticker, result.quote);
303
+ else if (result?.error) failed(result.error);
304
+ else retry.push(ticker);
305
+ });
306
+ await Promise.all(retry.map(quoteOne));
273
307
  return quotes;
274
308
  }
275
309
 
@@ -757,7 +791,7 @@ async function showCollectionWithMarketData(
757
791
  name: string,
758
792
  ctx: CliCommandContext,
759
793
  { config, store, dataProvider, persistence }: MarketContext,
760
- { explain = false, basis = "latest-print", drip, dividendDeadlineMs = DIVIDEND_READ_DEADLINE_MS, futuresSources, costFxHistory = apiClient, period }: ShowCollectionOptions,
794
+ { explain = false, basis = "latest-print", drip, dividendDeadlineMs = DIVIDEND_READ_DEADLINE_MS, futuresSources, costFxHistory = apiClient, period, real = false, cpi }: ShowCollectionOptions,
761
795
  ) {
762
796
  const tickers = (await store.loadAllTickers()).sort((left, right) =>
763
797
  left.metadata.ticker.localeCompare(right.metadata.ticker)
@@ -819,7 +853,7 @@ async function showCollectionWithMarketData(
819
853
  : broker ? "Your broker account and Gloom Cloud" : "Local portfolio and Gloom Cloud";
820
854
  if (matchedPortfolio && period) {
821
855
  await showPeriodPnl({ ctx, portfolio: matchedPortfolio, name: displayName, tickers: filtered, currency, window: period, provider: dataProvider,
822
- fxHistory: costFxHistory, quotes, futures: futures ?? new Map(), source, listingLabel, explain });
856
+ fxHistory: costFxHistory, quotes, futures: futures ?? new Map(), source, listingLabel, explain, real, ...(cpi ? { cpi } : {}) });
823
857
  return;
824
858
  }
825
859
  let freshness = isPortfolio ? undefined : quotesFreshness(quotes.values(), { source });
@@ -1378,22 +1412,32 @@ async function valueWatchlistRows({
1378
1412
  quotes: ReadonlyMap<string, CollectionQuote>;
1379
1413
  dataProvider: Pick<DataProvider, "getTickerFinancials" | "getTickerFinancialsBatch">;
1380
1414
  currency: string;
1381
- toBase: (value: number, fromCurrency: string) => Promise<number>;
1415
+ toBase: ((value: number, fromCurrency: string) => Promise<number>) & { usdRate?: (currency: string) => Promise<unknown> };
1382
1416
  }): Promise<WatchlistRowValue[]> {
1417
+ // Every currency's rate asked at once, beside the financials, not one after another as the rows reach a new
1418
+ // one: a list across five currencies waited a second and more for them.
1419
+ const warmRates = (codes: readonly string[]) => toBase.usdRate ? Promise.all([...new Set(codes)].map((code) => toBase.usdRate!(code))) : null;
1383
1420
  const [financials, perpetualFunding] = await Promise.all([
1384
1421
  loadMarketCapFinancials(tickers, quotes, dataProvider),
1385
1422
  loadPerpetualFunding(tickers),
1423
+ warmRates([currency, ...[...quotes.values()].flatMap((quote) => quote?.currency ? [quote.currency] : [])]),
1386
1424
  ]);
1387
1425
  const known = (value: number | null | undefined): number | null => value != null && Number.isFinite(value) ? value : null;
1388
1426
  // The export carries funding on the table's terms: only for a list that holds perpetual markets.
1389
1427
  const hasPerpetuals = perpetualFunding.size > 0;
1428
+ const caps = tickers.map((ticker) => {
1429
+ const quote = quotes.get(ticker.metadata.ticker);
1430
+ const snapshot = financials.get(ticker.metadata.ticker);
1431
+ return liveMarketCapitalization(quote, snapshot?.fundamentals) ?? liveMarketCapitalization(snapshot?.quote, snapshot?.fundamentals);
1432
+ });
1433
+ await warmRates(caps.flatMap((cap) => cap ? [cap.currency] : []));
1390
1434
  const values: WatchlistRowValue[] = [];
1391
- for (const ticker of tickers) {
1435
+ for (const [index, ticker] of tickers.entries()) {
1392
1436
  const symbol = ticker.metadata.ticker;
1393
1437
  const quote = quotes.get(symbol);
1394
1438
  const snapshot = financials.get(symbol);
1395
1439
  const { headline, extended } = collectionQuoteHeadline(quote);
1396
- const cap = liveMarketCapitalization(quote, snapshot?.fundamentals) ?? liveMarketCapitalization(snapshot?.quote, snapshot?.fundamentals);
1440
+ const cap = caps[index];
1397
1441
  const marketCap = cap ? listedMarketCapitalization(known(await toBase(cap.value, cap.currency))) : null;
1398
1442
  const kind = resolveTickerInstrumentKind(ticker, { quote: quote ?? snapshot?.quote });
1399
1443
  const venue = exchangeShortName(quote?.tradingExchangeName || quote?.exchangeName, quote?.fullExchangeName) || ticker.metadata.exchange || null;
@@ -22,6 +22,7 @@ import { tickerDisplayName } from "../../../portfolio/column-values";
22
22
  import { PORTFOLIO_ROW_MENU_KEYS } from "./row-actions";
23
23
  import { PORTFOLIO_REORDER_THROTTLE_MS } from "./use-throttled-ticker-order";
24
24
  import { useThrottledMemo } from "./use-throttled-memo";
25
+ import { listedSymbol } from "../../../portfolio/listed-symbol";
25
26
 
26
27
  // Tile text and colour follow quotes a few times a second; tile areas only
27
28
  // move on the reorder cadence, so a tick does not reshuffle the layout.
@@ -128,7 +129,8 @@ function tileVersion(
128
129
  isPortfolioTab: boolean,
129
130
  weight: number | undefined,
130
131
  ): string {
131
- return `${isPortfolioTab}|${weight ?? ""}|${objectVersion(ticker)}|${objectVersion(financials)}|${
132
+ // The label names the venue by the list's home market (BA:LSE in a US list), so a tile is rebuilt when it changes.
133
+ return `${isPortfolioTab}|${weight ?? ""}|${context.homeMarket ?? ""}|${objectVersion(ticker)}|${objectVersion(financials)}|${
132
134
  TILE_COLUMN_IDS.map((columnId) => columnContextVersion(columnId, context)).join("|")}`;
133
135
  }
134
136
 
@@ -173,8 +175,8 @@ function buildPortfolioGridItem(
173
175
 
174
176
  return {
175
177
  id: symbol,
176
- // As the table's Ticker column names it: an option reads as its contract, not its OCC code.
177
- label: tickerDisplayName(ticker),
178
+ // As the table's Ticker column names it: an option reads as its contract, not its OCC code, BA on LSE in a US list as BA:LSE.
179
+ label: listedSymbol(ticker, tickerDisplayName(ticker), context.homeMarket),
178
180
  weight: layoutWeight ?? tileWeight(ticker, financials, context, isPortfolioTab),
179
181
  colorValue: positionAdjustedChangePercent(ticker, financials, context, held),
180
182
  primaryText: primary,
@@ -8,6 +8,7 @@ import type { TickerRecord } from "../../../../types/ticker";
8
8
  import { selectMarketCapitalization } from "../../../../utils/market-capitalization";
9
9
  import type { CollectionSortPreference } from "../../../../state/app/context";
10
10
  import { isQuoteStaleForCurrentSession } from "../../../../market-data/quotes/freshness";
11
+ import { instrumentFromTicker, type TickerInstrumentOptions } from "../../../../market-data/request-types";
11
12
  import { resolveQuoteAgeTimestamp } from "../../../../market-data/quotes/time";
12
13
  import { compareSortValues } from "../../../../utils/sort-values";
13
14
  import { getSortValue, type ColumnContext } from "../metrics";
@@ -20,7 +21,18 @@ export const VISIBLE_QUOTE_STREAM_MAX_AGE_MS = 15_000;
20
21
  export const VISIBLE_QUOTE_STREAM_WATCHDOG_MS = 5_000;
21
22
  export const VISIBLE_SNAPSHOT_REFRESH_COOLDOWN_MS = 5 * 60_000;
22
23
  export const VISIBLE_FINANCIAL_WARMUP_DELAY_MS = 350;
23
- export const VISIBLE_SNAPSHOT_WARMUP_BATCH_LIMIT = 3;
24
+ /** A warmup batch whose rows keep changing is sent at the latest this long after it was first scheduled. */
25
+ export const VISIBLE_FINANCIAL_WARMUP_MAX_WAIT_MS = 1_000;
26
+ /**
27
+ * Visible rows whose financials are missing go out as one batch, up to what
28
+ * the service takes in one request (100 targets). A signed-out reader gets
29
+ * 300 targets a minute, so one batch is a third of that and the rows past it
30
+ * follow in the next one. Asked three at a time, a 60-row list took eight
31
+ * seconds to show its market caps.
32
+ */
33
+ const VISIBLE_SNAPSHOT_WARMUP_BATCH_LIMIT = 100;
34
+ /** A row on a broker contract is read from the broker one request at a time, so those still trickle in. */
35
+ const VISIBLE_BROKER_SNAPSHOT_WARMUP_BATCH_LIMIT = 3;
24
36
  export const SORT_QUOTE_WARMUP_BATCH_LIMIT = 64;
25
37
 
26
38
  const STREAM_OVERSCAN_ROWS = 6;
@@ -110,6 +122,27 @@ export function needsVisibleSnapshotWarmup(
110
122
  return requirements.priceHistory && financials.priceHistory.length === 0;
111
123
  }
112
124
 
125
+ /** The rows the next visible warmup asks the financials batch for: the batch limit, with broker rows kept to a few. */
126
+ export function selectVisibleSnapshotBatch(
127
+ queue: readonly TickerRecord[],
128
+ instrumentOptions: TickerInstrumentOptions,
129
+ ): TickerRecord[] {
130
+ const batch: TickerRecord[] = [];
131
+ let providerRows = 0;
132
+ let brokerRows = 0;
133
+ for (const ticker of queue) {
134
+ if (instrumentFromTicker(ticker, ticker.metadata.ticker, instrumentOptions)?.brokerId) {
135
+ if (brokerRows >= VISIBLE_BROKER_SNAPSHOT_WARMUP_BATCH_LIMIT) continue;
136
+ brokerRows += 1;
137
+ } else {
138
+ if (providerRows >= VISIBLE_SNAPSHOT_WARMUP_BATCH_LIMIT) continue;
139
+ providerRows += 1;
140
+ }
141
+ batch.push(ticker);
142
+ }
143
+ return batch;
144
+ }
145
+
113
146
  export function selectStreamTickers(
114
147
  tickers: TickerRecord[],
115
148
  visibleRange: { start: number; end: number },
@@ -1,3 +1,4 @@
1
+ import { listHomeMarket } from "../../../../portfolio/listed-symbol";
1
2
  import { Box, useUiCapabilities } from "../../../../ui";
2
3
  import { brokerPortfolioLogo } from "../../../../brokers/logos";
3
4
  import { LogoMark } from "../../../../components/ui/logo-mark";
@@ -315,8 +316,11 @@ export function PortfolioListPane({ focused, width, height }: PaneProps) {
315
316
  );
316
317
 
317
318
  const now = useColumnClock(columns, appActive && viewMode === "table");
319
+ // A row outside the list's home market shows its venue (BA:LSE in a US list).
320
+ const homeMarket = useMemo(() => listHomeMarket(collectionTickers), [collectionTickers]);
318
321
  const baseColumnContext = useMemo(() => ({
319
322
  activeTab: isPortfolioTab ? activeCollectionId : undefined,
323
+ homeMarket,
320
324
  baseCurrency: totalsCurrency,
321
325
  exchangeRates,
322
326
  valuationBasis,
@@ -336,6 +340,7 @@ export function PortfolioListPane({ focused, width, height }: PaneProps) {
336
340
  activeCollectionId,
337
341
  exchangeRates,
338
342
  futuresTerms,
343
+ homeMarket,
339
344
  isPortfolioTab,
340
345
  periodColumns,
341
346
  perpetuals,
@@ -853,6 +858,7 @@ export function PortfolioListPane({ focused, width, height }: PaneProps) {
853
858
  rootHeight={contentHeight}
854
859
  width={width}
855
860
  answeredSnapshots={answeredSnapshots}
861
+ exportName={activeCollectionEntry?.name}
856
862
  />
857
863
  ) : (
858
864
  <PortfolioGrid
@@ -8,9 +8,9 @@ import type { TickerRecord } from "../../../../types/ticker";
8
8
  import type { CollectionSortPreference } from "../../../../state/app/context";
9
9
  import {
10
10
  VISIBLE_FINANCIAL_WARMUP_DELAY_MS,
11
+ VISIBLE_FINANCIAL_WARMUP_MAX_WAIT_MS,
11
12
  VISIBLE_QUOTE_REFRESH_COOLDOWN_MS,
12
13
  VISIBLE_QUOTE_STREAM_WATCHDOG_MS,
13
- VISIBLE_SNAPSHOT_WARMUP_BATCH_LIMIT,
14
14
  VISIBLE_SNAPSHOT_REFRESH_COOLDOWN_MS,
15
15
  SORT_QUOTE_WARMUP_BATCH_LIMIT,
16
16
  needsVisibleQuoteWarmup,
@@ -19,6 +19,7 @@ import {
19
19
  selectQuoteWarmupRoute,
20
20
  selectQuoteWarmupTickers,
21
21
  selectStreamTickers,
22
+ selectVisibleSnapshotBatch,
22
23
  sortPreferenceUsesQuote,
23
24
  visibleWarmupKey,
24
25
  type VisibleWarmupRequirements,
@@ -54,8 +55,14 @@ export function usePortfolioPaneStreaming({
54
55
  // The scheduled warmup batch, keyed by what it will fetch. Quote ticks and
55
56
  // prefetches replace the financials map many times a second; a batch that
56
57
  // still fetches the same rows keeps its timer instead of restarting it, or
57
- // it would never fire while the tape is busy.
58
- const pendingWarmupRef = useRef<{ key: string; timeoutId: ReturnType<typeof setTimeout> } | null>(null);
58
+ // it would never fire while the tape is busy. One that keeps changing, as
59
+ // first quotes arrive row by row, is sent after VISIBLE_FINANCIAL_WARMUP_MAX_WAIT_MS.
60
+ const pendingWarmupRef = useRef<{
61
+ key: string;
62
+ timeoutId: ReturnType<typeof setTimeout>;
63
+ /** When the first batch of this wait was scheduled. */
64
+ since: number;
65
+ } | null>(null);
59
66
  // What the warmup currently asks for, re-run when a tick may have changed it.
60
67
  const evaluateWarmupRef = useRef<() => void>(() => {});
61
68
  const warmupRecheckRef = useRef<ReturnType<typeof setTimeout> | null>(null);
@@ -193,7 +200,7 @@ export function usePortfolioPaneStreaming({
193
200
  }
194
201
  }
195
202
  const limitedQuoteSnapshotQueue = quoteSnapshotQueue.slice(0, SORT_QUOTE_WARMUP_BATCH_LIMIT);
196
- const limitedSnapshotQueue = snapshotQueue.slice(0, VISIBLE_SNAPSHOT_WARMUP_BATCH_LIMIT);
203
+ const limitedSnapshotQueue = selectVisibleSnapshotBatch(snapshotQueue, instrumentOptions);
197
204
  if (quoteQueue.length === 0 && limitedQuoteSnapshotQueue.length === 0 && limitedSnapshotQueue.length === 0) {
198
205
  if (pendingWarmupRef.current) clearTimeout(pendingWarmupRef.current.timeoutId);
199
206
  pendingWarmupRef.current = null;
@@ -262,12 +269,14 @@ export function usePortfolioPaneStreaming({
262
269
  }
263
270
  };
264
271
 
272
+ const since = pendingWarmupRef.current?.since ?? Date.now();
265
273
  if (pendingWarmupRef.current) clearTimeout(pendingWarmupRef.current.timeoutId);
274
+ const delay = Math.min(VISIBLE_FINANCIAL_WARMUP_DELAY_MS, Math.max(0, since + VISIBLE_FINANCIAL_WARMUP_MAX_WAIT_MS - Date.now()));
266
275
  const timeoutId = setTimeout(() => {
267
276
  pendingWarmupRef.current = null;
268
277
  if (mountedRef.current) void runBatch();
269
- }, VISIBLE_FINANCIAL_WARMUP_DELAY_MS);
270
- pendingWarmupRef.current = { key: batchKey, timeoutId };
278
+ }, delay);
279
+ pendingWarmupRef.current = { key: batchKey, timeoutId, since };
271
280
  };
272
281
 
273
282
  evaluateWarmupRef.current = evaluate;
@@ -13,6 +13,7 @@ import { isProviderBusy } from "../../../../sources/provider-errors";
13
13
  import { splitSymbolArgs } from "../../../../cli/symbol-args";
14
14
  import { readNameEntryGroups } from "../../../../cli/name-entries";
15
15
  import { mapWithConcurrency } from "../../../../utils/concurrency";
16
+ import { quotedListingName } from "../../../../tickers/listing-name";
16
17
  import {
17
18
  describeFormerIssuer,
18
19
  describeTickerChange,
@@ -166,6 +167,14 @@ function exchangeFromResolved(resolved: ResolvedTickerSearch): string | undefine
166
167
  : resolved.ticker.metadata.exchange;
167
168
  }
168
169
 
170
+ /** A search row named as its listing's own quote names it, when the quote prices that listing and names it otherwise. */
171
+ function withQuotedListingName(resolved: ResolvedTickerSearch, quote: Quote | null): ResolvedTickerSearch {
172
+ if (resolved.kind !== "provider") return resolved;
173
+ const result = resolved.result;
174
+ const name = quotedListingName(result.exchange === "SMART" ? result.primaryExchange || result.exchange : result.exchange, quote);
175
+ return name && name !== result.name ? { ...resolved, result: { ...result, name } } : resolved;
176
+ }
177
+
169
178
  export function tickerNameFromValidation(
170
179
  validation: Extract<QuickAddValidation, { status: "ready" | "duplicate" }>,
171
180
  ): string {
@@ -231,35 +240,38 @@ export async function resolveQuickAddValidation({
231
240
  const changes = startTickerChangeLookup(registry.marketData, query);
232
241
 
233
242
  try {
234
- const resolved = await resolveTickerSearch({
243
+ const found = await resolveTickerSearch({
235
244
  query,
236
245
  activeTicker: null,
237
246
  tickers,
238
247
  dataProvider: registry.marketData,
239
248
  });
240
- if (!resolved) {
249
+ if (!found) {
241
250
  const payload = await changes.settle();
242
251
  const line = tickerChangeLine(describeTickerChange(query, payload, null)) ?? describeFormerIssuer(query, payload, null)?.note;
243
252
  return { status: "missing", query, message: line ?? "No exact ticker match" };
244
253
  }
245
254
 
246
- const symbol = resolved.symbol;
247
- const ticker = tickerForResolved(resolved, tickers);
255
+ const symbol = found.symbol;
256
+ const ticker = tickerForResolved(found, tickers);
248
257
  const cachedQuote = ticker ? financials.get(ticker.metadata.ticker)?.quote ?? null : null;
249
258
  // A listing its own quote vouched for comes with it.
250
- let quote = cachedQuote ?? (resolved.kind === "provider" ? resolved.quote ?? null : null);
259
+ let quote = cachedQuote ?? (found.kind === "provider" ? found.quote ?? null : null);
251
260
  if (!quote) {
252
261
  try {
253
262
  quote = await registry.marketData.getQuote(
254
263
  symbol,
255
- exchangeFromResolved(resolved),
256
- quoteContextFromResolved(resolved),
264
+ exchangeFromResolved(found),
265
+ quoteContextFromResolved(found),
257
266
  );
258
267
  } catch (error) {
259
268
  logFailure("portfolio-list.quick-add.resolution", "Read quick-add quote failed")(error);
260
269
  quote = null;
261
270
  }
262
271
  }
272
+ // The listing's own quote names it, over a search row that names another listing's company:
273
+ // search's BA on LSE read "The Boeing Company" while its quote is BAE Systems, and the row was saved so.
274
+ const resolved = withQuotedListingName(found, quote);
263
275
 
264
276
  // A listing abroad is not the US symbol the changes are of.
265
277
  const venue = resolved.kind === "provider" && resolved.result.exchange === "SMART"
@@ -17,15 +17,29 @@ import { objectVersion } from "../../../utils/object-version";
17
17
  import { columnContextVersion, PERPETUAL_COLUMN_IDS } from "./cell-version";
18
18
  import { getColumnValue, type ColumnContext } from "./metrics";
19
19
  import { periodPnlFigure, tickerDisplayName } from "../../../portfolio/column-values";
20
+ import { listedSymbol } from "../../../portfolio/listed-symbol";
20
21
  import { displayWidth } from "../../../utils/format";
21
22
  import { dropColumnsToFit } from "../../../components/ui/table-layout";
22
23
  import { sinceLastSeenTint, type SinceLastSeenRecap } from "./since-last-seen";
23
24
  import { portfolioPnlLabel } from "../../../portfolio/position-metrics";
24
25
  import { PORTFOLIO_ROW_MENU_KEYS } from "./row-actions";
25
26
  import { isFuturesTicker } from "../../../portfolio/futures-positions";
27
+ import { resolveCurrencyUnit } from "../../../utils/currency-units";
26
28
 
27
29
  export type { QuoteFlashDirection };
28
30
 
31
+ /**
32
+ * The market cap column, whose caps read in the book's currency, under a
33
+ * header that names it when a row's price is in another (`Mkt Cap TRY` beside
34
+ * BRK.B's dollars), wide enough for it; as it was when every price is in that
35
+ * currency, pence in pounds included.
36
+ */
37
+ export function marketCapColumn(column: ColumnConfig, currency: string, listed: ReadonlyArray<string | null | undefined>): ColumnConfig {
38
+ if (!listed.some((code) => !!code && resolveCurrencyUnit(code).currency !== currency)) return column;
39
+ const label = `${column.label} ${currency}`;
40
+ return { ...column, label, width: Math.max(column.width, displayWidth(label)) };
41
+ }
42
+
29
43
  /** The market-state dot and the space after it, before each symbol in the Ticker column. */
30
44
  const TICKER_DOT_WIDTH = 2;
31
45
  /**
@@ -185,6 +199,7 @@ export function PortfolioTickerTable({
185
199
  rootHeight,
186
200
  width,
187
201
  answeredSnapshots,
202
+ exportName,
188
203
  }: {
189
204
  columns: ColumnConfig[];
190
205
  focused?: boolean;
@@ -217,6 +232,8 @@ export function PortfolioTickerTable({
217
232
  width?: number;
218
233
  /** Rows whose financial snapshot answered: until then a company column's dash may still fill in. */
219
234
  answeredSnapshots?: ReadonlySet<string>;
235
+ /** The list's name, which names its exported file. */
236
+ exportName?: string;
220
237
  }) {
221
238
  const cellCacheRef = useRef(createRowValueCache<string, ReturnType<typeof getColumnValue> & TickerTableCell>(5000));
222
239
  const openPerpetualRef = useRef(onOpenPerpetual);
@@ -262,15 +279,23 @@ export function PortfolioTickerTable({
262
279
  (widest, ticker) => Math.max(widest, displayWidth(resolveCell(sharesColumn, ticker, tableFinancialsMap.get(ticker.metadata.ticker)).text)),
263
280
  sharesColumn.width,
264
281
  )) : 0;
265
- // The Ticker column grows to its longest symbol, so ETH-USD shows whole beside its market-state dot.
282
+ // The Ticker column grows to its longest symbol, so ETH-USD and BA:LSE show whole beside their market-state dot.
266
283
  const tickerWidth = useMemo(() => Math.min(MAX_TICKER_COLUMN_WIDTH, sortedTickers.reduce(
267
- (widest, ticker) => Math.max(widest, TICKER_DOT_WIDTH + displayWidth(tickerDisplayName(ticker))),
284
+ (widest, ticker) => Math.max(widest, TICKER_DOT_WIDTH + displayWidth(listedSymbol(ticker, tickerDisplayName(ticker), columnContext.homeMarket))),
268
285
  0,
269
- )), [sortedTickers]);
286
+ )), [columnContext.homeMarket, sortedTickers]);
270
287
  // A book that holds a short weighs its positions against gross exposure, and the header says so.
271
288
  const grossWeights = columnContext.portfolioWeightBasis === "gross";
289
+ // Market caps read in the book's currency: beside a price in another, the header names it (Mkt Cap TRY by a USD price).
290
+ const capCurrency = columnContext.baseCurrency;
291
+ // One code, the first other currency or none, so a quote's tick does not rebuild the columns.
292
+ const otherListedCurrency = useMemo(() => columns.some((column) => column.id === "market_cap")
293
+ ? sortedTickers.map((ticker) => tableFinancialsMap.get(ticker.metadata.ticker)?.quote?.currency ?? ticker.metadata.currency)
294
+ .find((code) => !!code && resolveCurrencyUnit(code).currency !== capCurrency) ?? null
295
+ : null, [capCurrency, columns, sortedTickers, tableFinancialsMap]);
272
296
  const sizedColumns = useMemo(() => columns.map((column) => column.id === "shares" && hasNonShareQuantity
273
297
  ? { ...column, label: "QTY", ...(sharesWidth > column.width ? { width: sharesWidth } : {}) }
298
+ : column.id === "market_cap" ? marketCapColumn(column, capCurrency, [otherListedCurrency])
274
299
  : column.id === "weight" && grossWeights ? { ...column, label: GROSS_WEIGHT_LABEL }
275
300
  : column.id === "ticker" && tickerWidth > column.width ? { ...column, width: tickerWidth }
276
301
  : column.id === "pnl_pct" && period ? { ...column, label: CONTRIBUTION_LABEL }
@@ -278,7 +303,7 @@ export function PortfolioTickerTable({
278
303
  ...column,
279
304
  label: column.id === "pnl_pct" ? pnlLabel.replace("P&L", "%") : pnlLabel,
280
305
  } : column).map((column) => hasFrontReference && column.id === noteColumnId ? { ...column, flexGrow: 1 } : column),
281
- [columns, grossWeights, hasFrontReference, hasNonShareQuantity, noteColumnId, period, pnlLabel, sharesWidth, tickerWidth]);
306
+ [capCurrency, columns, grossWeights, hasFrontReference, hasNonShareQuantity, noteColumnId, otherListedCurrency, period, pnlLabel, sharesWidth, tickerWidth]);
282
307
  // Read again as the rows' data moves, from the cells the rows show; the columns change only when what is hidden does.
283
308
  // The company columns hidden last time, per list, stay hidden while a row added since settles.
284
309
  const hiddenCompanyRef = useRef<{ list: string | undefined; ids: ReadonlySet<string> }>({ list: undefined, ids: new Set() });
@@ -343,6 +368,7 @@ export function PortfolioTickerTable({
343
368
  addTickerShortcut={addTickerShortcut}
344
369
  summaryRows={summaryRows}
345
370
  rootHeight={rootHeight}
371
+ exportName={exportName}
346
372
  />
347
373
  );
348
374
  }
@@ -24,8 +24,26 @@ export interface RealizedVolEvidenceStatus {
24
24
  /** The windows the history is too short for: their series have no values, and the capture is whole without them. */
25
25
  shortWindows?: number[];
26
26
  currentIv: { value: number; date: string; label: string; source: string | null; expiration: number } | null;
27
+ /**
28
+ * An FX pair or currency future: it has no option chain, so no ATM IV is
29
+ * missing from a whole capture. The currency fund's IV30 that stands in is
30
+ * the IV point drawn, when there is one (`proxyIv`, in percent).
31
+ */
32
+ fxPair?: boolean;
33
+ proxyIv?: { fund: string; value: number; date: string } | null;
34
+ /** The proxy's IV30 is over 5 sessions behind the pair's last bar: no current IV, so the capture is not whole. */
35
+ proxyStale?: boolean;
27
36
  }
28
37
 
38
+ /** The IV point the history view draws: the ATM IV, or for an FX pair the proxy fund's IV30. */
39
+ function ivPoint(status: Pick<RealizedVolEvidenceStatus, "showIv" | "currentIv" | "proxyIv">): { value: number; date: string } | null {
40
+ return status.showIv ? status.currentIv ?? status.proxyIv ?? null : null;
41
+ }
42
+
43
+ /** Whether a capture still needs an ATM IV it does not have; an FX pair never has one. */
44
+ const missingIv = (status: Pick<RealizedVolEvidenceStatus, "showIv" | "currentIv" | "fxPair">) =>
45
+ status.showIv && status.currentIv == null && status.fxPair !== true;
46
+
29
47
  /** A series a short history leaves without values: a selected window it is too short for. */
30
48
  function shortSeries(id: string, shortWindows: readonly number[] | undefined): boolean {
31
49
  return /^hv-\d+$/.test(id) && (shortWindows ?? []).includes(Number(id.slice(3)));
@@ -49,7 +67,7 @@ export function realizedVolSemanticEvidence(series: readonly ResolvedSeries[], s
49
67
  complete: !status.loading && !status.stale && status.errors.length === 0 && !!status.asOf
50
68
  && plotted.length > 0 && plotted.some((entry) => entry.points.some((point) => isFiniteNumber(point.value)))
51
69
  && plotted.every((entry) => shortSeries(entry.id, status.shortWindows) || entry.points.some((point) => isFiniteNumber(point.value)))
52
- && (!status.showIv || status.currentIv != null),
70
+ && !missingIv(status) && status.proxyStale !== true,
53
71
  };
54
72
  }
55
73
 
@@ -68,13 +86,18 @@ function readRealizedVolEvidence(value: unknown): RealizedVolEvidence | null {
68
86
  || !isStringArray(value.errors)
69
87
  || (value.shortWindows !== undefined && (!Array.isArray(value.shortWindows) || !value.shortWindows.every(isFiniteNumber)))
70
88
  || (value.ivErrors !== undefined && !isStringArray(value.ivErrors))
89
+ || (value.fxPair !== undefined && typeof value.fxPair !== "boolean")
90
+ || (value.proxyStale !== undefined && typeof value.proxyStale !== "boolean")
91
+ || (value.proxyIv != null && (!isRecord(value.proxyIv) || typeof value.proxyIv.fund !== "string"
92
+ || !isFiniteNumber(value.proxyIv.value) || !isDateString(value.proxyIv.date)))
71
93
  || !Array.isArray(value.series) || !value.series.every((entry) => isRecord(entry) && typeof entry.id === "string"
72
94
  && typeof entry.unit === "string" && Array.isArray(entry.points) && entry.points.every((point) => isRecord(point)
73
95
  && isDateString(point.date) && (point.value === null || isFiniteNumber(point.value))))) return null;
74
96
  const evidence = value as unknown as RealizedVolEvidence;
75
97
  // The IV point is drawn only when there is one: a chart without it matches its data, and is incomplete for it.
98
+ const point = ivPoint(evidence);
76
99
  const required = evidence.view === "graph" ? [...evidence.windows.map((window) => `hv-${window}`), "price",
77
- ...(evidence.showIv && evidence.currentIv != null ? ["current-iv"] : [])] : ["min", "max", "mean", "current"];
100
+ ...(point ? ["current-iv"] : [])] : ["min", "max", "mean", "current"];
78
101
  if (!required.length || (evidence.view === "graph" && !evidence.windows.length)
79
102
  || evidence.series.length !== required.length || new Set(evidence.series.map((entry) => entry.id)).size !== required.length
80
103
  || required.some((id) => !evidence.series.some((entry) => entry.id === id))) return null;
@@ -82,12 +105,12 @@ function readRealizedVolEvidence(value: unknown): RealizedVolEvidence | null {
82
105
  if (count <= 0 || count !== evidence.plottedValueCount) return null;
83
106
  if (evidence.currentIv != null && (!isRecord(evidence.currentIv) || !isFiniteNumber(evidence.currentIv.value)
84
107
  || !isDateString(evidence.currentIv.date) || !isFiniteNumber(evidence.currentIv.expiration))) return null;
85
- if (evidence.view === "graph" && evidence.showIv && evidence.currentIv) {
108
+ if (evidence.view === "graph" && point) {
86
109
  const points = evidence.series.find((entry) => entry.id === "current-iv")!.points;
87
- if (points.length !== 1 || points[0]!.date !== evidence.currentIv.date || points[0]!.value !== evidence.currentIv.value) return null;
110
+ if (points.length !== 1 || points[0]!.date !== point.date || points[0]!.value !== point.value) return null;
88
111
  }
89
112
  if (evidence.complete && (evidence.loading || evidence.stale || evidence.errors.length > 0
90
- || (evidence.showIv && !evidence.currentIv)
113
+ || missingIv(evidence) || evidence.proxyStale === true
91
114
  || evidence.series.some((entry) => !shortSeries(entry.id, evidence.shortWindows) && !entry.points.some((point) => isFiniteNumber(point.value))))) return null;
92
115
  return evidence;
93
116
  }
@@ -95,7 +118,7 @@ function readRealizedVolEvidence(value: unknown): RealizedVolEvidence | null {
95
118
  /** Drawn, current and whole but for the current IV, whose errors are the only ones. */
96
119
  function missingOnlyIv(evidence: RealizedVolEvidence): boolean {
97
120
  const ivErrors = new Set(evidence.ivErrors ?? []);
98
- return evidence.view === "graph" && evidence.showIv && evidence.currentIv == null
121
+ return evidence.view === "graph" && missingIv(evidence)
99
122
  && !evidence.loading && !evidence.stale && evidence.plottedValueCount > 0
100
123
  && evidence.errors.every((error) => ivErrors.has(error))
101
124
  && evidence.series.every((entry) => shortSeries(entry.id, evidence.shortWindows) || entry.points.some((point) => isFiniteNumber(point.value)));
@@ -123,6 +146,10 @@ export const realizedVolScreenshotEvidence: PaneScreenshotEvidenceHook<RealizedV
123
146
  if (evidence?.complete && !evidence.loading) return [];
124
147
  // The volatility drawn whole and only the IV point missing: the capture names the IV, not the symbol.
125
148
  if (evidence && missingOnlyIv(evidence)) return [`${symbol ?? evidence.symbol} current ATM IV`];
149
+ // An FX pair whose proxy IV30 is stale: what is missing is a current IV30 of the fund.
150
+ if (evidence?.proxyStale && evidence.proxyIv && !evidence.loading && !evidence.stale && evidence.errors.length === 0) {
151
+ return [`${evidence.proxyIv.fund} current IV30`];
152
+ }
126
153
  return [symbol ?? "realized volatility"];
127
154
  },
128
155
  };