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
@@ -103,6 +103,12 @@ export interface FundDetailData {
103
103
  savedAt?: number;
104
104
  /** The parts still loading, while the fund fills in (loadFundDetail's `onProgress`); absent once whole. */
105
105
  loading?: ThirteenFDetailLoading;
106
+ /**
107
+ * The prior quarter is on file but its holdings did not load: the header
108
+ * says so rather than "No prior quarter". `retryAfterSeconds` when the
109
+ * service said how long to wait.
110
+ */
111
+ comparisonFailed?: { retryAfterSeconds: number | null };
106
112
  }
107
113
 
108
114
  /** Parts of a fund's detail still loading. */
@@ -19,6 +19,9 @@ import { colors, priceColor } from "../../../../theme/colors";
19
19
  import { displayWidth, formatCompact, formatPercent } from "../../../../utils/format";
20
20
  import { isPlainKeyboardEvent } from "../../../../utils/keyboard";
21
21
  import { publicTickerKey } from "../../../../utils/exchanges";
22
+ import { exportedListingSymbol } from "../../../../portfolio/listed-symbol";
23
+ import { indexBarVolume } from "../../../../market-data/market/index-level";
24
+ import { quoteExportUnit } from "../../../../market-data/quotes/export-identity";
22
25
  import { isPenceQuotedLine, penceFigure, quoteFormatOptions } from "../../../../market-data/market/format";
23
26
  import {
24
27
  barPriceDecimals, formatBarPrice, historyAllStart, historyBarsAfterHole, historyChangeBaseNote, historyMissingPeriodsNote, quotedPriceDivisor,
@@ -239,6 +242,9 @@ function nextHistoryRange(current: TimeRange): TimeRange {
239
242
  return TIME_RANGES[(index + 1) % TIME_RANGES.length] ?? "1Y";
240
243
  }
241
244
 
245
+ /** The columns each exported bar ends with, as `fn HP --csv` ends a row. */
246
+ const HISTORY_EXPORT_IDENTITY_HEADERS = ["status", "symbol_or_series", "currency_or_unit", "interval", "source", "as_of"] as const;
247
+
242
248
  export function HistoricalPricesPane({ focused, width, height }: PaneProps) {
243
249
  const dataProvider = useAssetData();
244
250
  const { symbol, exchange, ticker } = useBoundTicker();
@@ -262,9 +268,15 @@ export function HistoricalPricesPane({ focused, width, height }: PaneProps) {
262
268
  // While the session trades the day's bar is the quote's: the history keeps a
263
269
  // snapshot of it from whenever it was last fetched (withSessionBar).
264
270
  const quote = financials?.quote;
271
+ // An index's uncounted 0 volume (^HSI's day built from its quote) is no volume, as `history` and HP's CSV leave it.
272
+ const instrumentType = quote?.instrumentType ?? financials?.quoteMetadata?.instrumentType;
265
273
  const points = useMemo(
266
- () => withSessionBar(data ?? [], quote, { now: Date.now(), venue }),
267
- [data, quote, venue],
274
+ () => withSessionBar(data ?? [], quote, { now: Date.now(), venue }).map((point) => {
275
+ if (point.volume == null) return point;
276
+ const volume = indexBarVolume(point.volume, instrumentType);
277
+ return volume === point.volume ? point : { ...point, volume: undefined };
278
+ }),
279
+ [data, instrumentType, quote, venue],
268
280
  );
269
281
  const { rows, size, forming, dayToDate, newestDate, gapNotices } = useMemo(
270
282
  () => buildHistoricalPriceRows(points, venue, Date.now()),
@@ -360,6 +372,12 @@ export function HistoricalPricesPane({ focused, width, height }: PaneProps) {
360
372
  // The range is picked in the query bar; t still steps through it. The range
361
373
  // sets the bar size, which the footer says, and a week or month still
362
374
  // running says how far the newest bar goes.
375
+ const listing = symbol ? exportedListingSymbol(symbol, exchange, instrumentType) : "";
376
+ const priceUnit = listing && quote ? quoteExportUnit(listing, quote) : null;
377
+ const exportIdentityCells = [
378
+ "", listing, priceUnit ?? "", rows.length > 0 && size !== "intraday" ? size : "",
379
+ quote && (!quote.providerId || quote.providerId === "gloomberb-cloud") ? "Gloom Cloud" : "", newestRowDate.slice(0, 10),
380
+ ];
363
381
  const barInfo = useMemo<PaneFooterSegment[]>(() => [
364
382
  ...rows.length > 0 ? [{ id: "bars", parts: [{
365
383
  text: allStart ? `${historyBarSizeText(size)} from ${allStart}` : historyBarSizeText(size), tone: "muted" as const,
@@ -407,6 +425,8 @@ export function HistoricalPricesPane({ focused, width, height }: PaneProps) {
407
425
  )}
408
426
  renderCell={renderCell}
409
427
  selectedTextOverridesCellColor
428
+ // Each bar says what it is a bar of, as `fn HP --csv` and `history --csv` end a row, so it survives a paste.
429
+ exportIdentity={{ headers: HISTORY_EXPORT_IDENTITY_HEADERS, cells: () => exportIdentityCells }}
410
430
  getExportMetadata={() => [
411
431
  ["Ticker", symbol ? publicTickerKey(symbol, exchange) : ""],
412
432
  ["Requested range", range],
@@ -414,7 +434,7 @@ export function HistoricalPricesPane({ focused, width, height }: PaneProps) {
414
434
  ["Time zone", "UTC"],
415
435
  ...(forming && newestDate ? [["Partial bar", `${newestDate}, ${formingHistoryBarText(forming, newestDate)}`]] : []),
416
436
  ...(dayToDate && newestDate ? [["Partial bar", `${newestDate}, ${DAY_SO_FAR_TEXT}`]] : []),
417
- ["Price units", "As served in the history; currency and price-basis metadata are unavailable"],
437
+ ["Price units", priceUnit ?? "As served in the history; currency and price-basis metadata are unavailable"],
418
438
  ["Status", error ? (rows.length ? "Retained after refresh failure" : "Unavailable")
419
439
  : loading ? (rows.length ? "Refreshing" : "Loading") : rows.length ? "Available" : "Empty"],
420
440
  ...(allStart ? [["Source starts", allStart]] : []),
@@ -21,6 +21,11 @@ export { computeTTM } from "./aggregation";
21
21
  export { FINANCIAL_SUB_TABS } from "./schema";
22
22
  export type { FinancialPeriod } from "./aggregation";
23
23
 
24
+ /** A ticker with statements to show: what the Financials view needs, and what Overview's way into it asks for. */
25
+ export function hasStatementFinancials(financials: TickerFinancials | null | undefined): boolean {
26
+ return (financials?.annualStatements.length ?? 0) > 0 || (financials?.quarterlyStatements.length ?? 0) > 0;
27
+ }
28
+
24
29
  type FinancialMetricFormat = "compact" | "eps" | "percent";
25
30
  export type FinancialGrowthDirection = "higher" | "lower" | "neutral";
26
31
 
@@ -5,6 +5,7 @@ import { HISTORY_DEFAULT_RANGE } from "./data-panes/history-bars";
5
5
  import { RETURN_INTERVAL_VALUES, RETURN_RANGES } from "./data-panes/returns-model";
6
6
  import { PRICE_WINDOW_FROM_HELP, PRICE_WINDOW_TO_HELP } from "../../../utils/price-window";
7
7
  import type { HeadlessPaneOptionDef } from "../../../types/headless";
8
+ import { QUOTE_MONITOR_MAX_TICKERS } from "../../../tickers/list";
8
9
 
9
10
  /** `--from 2007 --to 2009`: the report's bars for those dates. The pane keeps its range, so a capture refuses them. */
10
11
  const WINDOW_OPTIONS: HeadlessPaneOptionDef[] = [
@@ -50,7 +51,7 @@ export const paneSchemas = {
50
51
  },
51
52
  },
52
53
  "quote-monitor-pane": {
53
- argument: { kind: "tickers" },
54
+ argument: { kind: "tickers", maximum: QUOTE_MONITOR_MAX_TICKERS },
54
55
  options: [],
55
56
  discovery: {
56
57
  id: "quote-comparison",
@@ -3,18 +3,16 @@ import {
3
3
  } from "../../../utils/financial-statements";
4
4
  import { canonicalExchange } from "../../../utils/exchanges";
5
5
  import { hasValidQuoteObservationTime } from "../../../market-data/quotes/freshness";
6
- import { EXTENDED_SESSION_LABELS, getQuoteSessionFields, quoteHeadlineTime, type ExtendedSession } from "../../../market-data/market/status";
6
+ import { quoteMonitorColumns, quoteMonitorRow, QUOTE_MONITOR_BASE_COLUMNS, QUOTE_MONITOR_ROW_KEYS } from "./quote-monitor/rows";
7
7
  import type { HeadlessPaneColumn, HeadlessPaneDefinition, HeadlessPaneFreshness, HeadlessPaneOptionValues } from "../../../types/headless";
8
8
  import type { TimeRange } from "../../../time-series/range";
9
- import { formatNumber, formatPercentRaw } from "../../../utils/format";
10
- import {
11
- formatMarketChangeWithCurrency, formatMarketPrice, formatMarketPriceWithCurrency, formatPriceObservation, penceFigure, quoteFormatOptions,
12
- resolveAssetDisplayKind, withCurrencyMinorDigits, type MarketFormatOptions,
13
- } from "../../../market-data/market/format";
9
+ import { formatNumber } from "../../../utils/format";
10
+ import { formatPriceObservation, penceFigure, quoteFormatOptions } from "../../../market-data/market/format";
14
11
  import {
15
12
  MISSING_VOLUME_TEXT, missingVolumeCount, missingVolumeNotice, pricePointValues, pricePointWickFlags, priceHistoryIntegrityNotice,
16
13
  priceHistoryWickNotice,
17
14
  } from "../../../utils/price-history-integrity";
15
+ import { indexBarVolume } from "../../../market-data/market/index-level";
18
16
  import {
19
17
  buildFinancialTableModel, financialStatementCurrency, financialStatementDateNotice, financialStatementLimitations,
20
18
  financialStatementPeriods, financialSubTabFields, formatFinancialHeader, isPerShareFinancialRow, receiptShareCountLabel,
@@ -41,7 +39,7 @@ import {
41
39
  import {
42
40
  loadHeadlessFinancials, loadHeadlessPriceHistory, loadHeadlessSymbols, resolveHeadlessInstrument,
43
41
  } from "../shared/headless-market-data";
44
- import { barHistoryFreshness, quoteFreshnessFields, REPORTED_DATA } from "../shared/report-freshness";
42
+ import { barHistoryFreshness, REPORTED_DATA } from "../shared/report-freshness";
45
43
  import {
46
44
  BAR_INTERVAL_LABELS, barPriceDecimals, cleanBarPrice, cleanFloat32Price, formatBarPrice, historyAllStart, historyAllStartNote, historyMissingPeriodsNote, historyPriceDecimals,
47
45
  quotedPriceDivisor,
@@ -314,78 +312,34 @@ async function loadRatioReport(
314
312
  };
315
313
  }
316
314
 
317
- function quoteAmount(value: unknown, row: Record<string, unknown>, signed = false): string {
318
- if (typeof value !== "number" || !Number.isFinite(value)) return "—";
319
- const currency = typeof row.currency === "string" && row.currency.trim() ? row.currency : undefined;
320
- const base: MarketFormatOptions = { assetCategory: typeof row.instrumentType === "string" ? row.instrumentType : undefined,
321
- priceBasis: row.priceBasis === "per-unit" || row.priceBasis === "percent-of-par" ? row.priceBasis : undefined };
322
- // Par quotes keep two decimals; money pads to its currency's minor unit (none for JPY).
323
- const options = base.priceBasis === "percent-of-par" ? { ...base, minimumFractionDigits: 2 } : withCurrencyMinorDigits(base, currency);
324
- // A currency pair's move is written at the pair's precision, as its price is (-$0.00108 on EUR/USD 1.16023).
325
- if (signed && currency && typeof row.price === "number" && resolveAssetDisplayKind(options) === "cash") {
326
- return formatMarketChangeWithCurrency(value, currency, options, row.price);
327
- }
328
- const amount = currency
329
- ? formatMarketPriceWithCurrency(value, currency, options)
330
- : formatMarketPrice(value, options);
331
- return amount === "—" ? amount : `${signed && value >= 0 ? "+" : ""}${amount}`;
332
- }
333
-
334
- function percentCell(value: unknown): string {
335
- return formatPercentRaw(typeof value === "number" && Number.isFinite(value) ? value : undefined);
336
- }
337
-
338
- const QUOTE_MONITOR_COLUMNS: HeadlessPaneColumn[] = [
339
- { key: "symbol", header: "Ticker" },
340
- { key: "name", header: "Name" },
341
- { key: "price", header: "Last", align: "right", format: (value, row) => quoteAmount(value, row) },
342
- { key: "change", header: "Change", align: "right", format: (value, row) => quoteAmount(value, row, true) },
343
- { key: "changePercent", header: "Change %", align: "right", format: percentCell },
344
- ];
345
-
346
- /** The pre-market, after-hours or overnight print and its move from the regular close, for the rows that have one. */
347
- function extendedSessionColumn(session: ExtendedSession): HeadlessPaneColumn {
348
- return {
349
- key: "extendedPrice", header: EXTENDED_SESSION_LABELS[session], align: "right",
350
- format: (value, row) => row.extendedSession === session
351
- ? `${quoteAmount(value, row)} ${percentCell(row.extendedChangePercent)}`
352
- : "—",
353
- };
354
- }
355
-
356
315
  export const quoteComparisonHeadless: HeadlessPaneDefinition<"rows"> = {
357
316
  ...paneSchemas["quote-monitor-pane"],
358
317
  shape: "rows",
359
318
  description: "Current quotes for one or more tickers: name, the regular session's last price, change and percent change, and any pre-market or after-hours print.",
360
319
  describe: ({ symbols }) => `Quote Monitor | ${symbols.join(", ")}`,
361
- columns: QUOTE_MONITOR_COLUMNS,
320
+ columns: QUOTE_MONITOR_BASE_COLUMNS,
321
+ // A board across markets (Hong Kong beside New York) dates each market's session and says when each opens.
322
+ freshness: { datesEachVenue: true },
362
323
  async load({ symbols }, ctx) {
363
324
  const loaded = await loadHeadlessSymbols(symbols, ctx, async (key) => {
364
325
  const { symbol, exchange } = await resolveHeadlessInstrument(ctx, key);
365
- const quote = await ctx.marketData.getQuote(symbol, exchange);
326
+ // Each move is printed with the close it is from, so the close is checked against its date first.
327
+ const quote = await ctx.marketData.getQuote(symbol, exchange, { datesChangeBasis: true });
366
328
  if (!quote) throw new Error(`Quote is unavailable for ${key}`);
367
329
  if (!hasValidQuoteObservationTime(quote)) throw new Error(`Quote observation time is unavailable for ${key}`);
368
330
  return quote;
369
331
  });
370
- const rows = loaded.entries.map(({ symbol, data: quote }) => {
371
- // As the pane's cards show them: the regular session, then any extended print from its close.
372
- const { price, change, changePercent, ...extended } = getQuoteSessionFields(quote);
373
- return {
374
- symbol, name: quote.name ?? "", price, currency: quote.currency,
375
- ...(quote.instrumentType ? { instrumentType: quote.instrumentType } : {}),
376
- ...(quote.priceBasis ? { priceBasis: quote.priceBasis } : {}),
377
- change, changePercent, ...extended,
378
- marketCap: quote.marketCap ?? null, updatedAt: quoteHeadlineTime(quote),
379
- ...quoteFreshnessFields(quote),
380
- };
381
- });
382
- // An extended column only when a row has a print for it, so a closed board stays as narrow as before.
383
- const extendedColumns = (["PRE", "POST", "OVERNIGHT"] as const)
384
- .filter((session) => rows.some((row) => row.extendedSession === session))
385
- .map(extendedSessionColumn);
332
+ const now = Date.now();
333
+ // A broker's quote names the broker as its source.
334
+ const brokerName = (providerId: string) => ctx.resolveBroker?.(providerId)?.name;
335
+ const rows = loaded.entries.map(({ symbol, data: quote }) => quoteMonitorRow(symbol, quote, now, brokerName));
336
+ const columns = quoteMonitorColumns(rows);
386
337
  return {
387
338
  rows,
388
- ...(extendedColumns.length > 0 ? { columns: [...QUOTE_MONITOR_COLUMNS, ...extendedColumns] } : {}),
339
+ // An extended column or Chg bp only when a row has one, so a closed board stays as narrow as before.
340
+ ...(columns.length > QUOTE_MONITOR_BASE_COLUMNS.length ? { columns } : {}),
341
+ // Each exported row names its ticker, its unit, its source and when its own price was observed.
342
+ ...QUOTE_MONITOR_ROW_KEYS,
389
343
  unavailableSymbols: loaded.unavailableSymbols, errors: loaded.errors,
390
344
  };
391
345
  },
@@ -470,7 +424,8 @@ export const historicalPricesHeadless: HeadlessPaneDefinition<"rows"> = {
470
424
  const values = pricePointValues(point);
471
425
  return {
472
426
  date: Number.isFinite(date.getTime()) ? date.toISOString() : String(point.date),
473
- open: clean(values.open), high: clean(values.high), low: clean(values.low), close: clean(values.close), volume: values.volume,
427
+ open: clean(values.open), high: clean(values.high), low: clean(values.low), close: clean(values.close),
428
+ volume: indexBarVolume(values.volume, quote?.instrumentType),
474
429
  ...(values.integrity ? { integrity: values.integrity } : {}),
475
430
  ...(point.partial ? { partial: true } : {}),
476
431
  // A coin's day Gloom Cloud rebuilt from hourly bars has no volume of its own, as `history` marks it.
@@ -1,4 +1,5 @@
1
1
  import { publicTickerBindingSymbol } from "../../../tickers/selection";
2
+ import { TAX_RATE_PANE_OPTIONS } from "../../../market-data/tax-equivalent";
2
3
  import type { PluginModule } from "../plugin-module";
3
4
  import { holdsActiveTicker } from "../../../shares/pane-image";
4
5
  import { TICKER_RESEARCH_PANE_ID } from "../../../types/config";
@@ -55,6 +56,8 @@ export const tickerDetailModule: PluginModule = {
55
56
  return tab === "thesis" || holdsActiveTicker(context) ? "holdings" : null;
56
57
  },
57
58
  defaultMode: "floating",
59
+ // `fn DES MUB --tax-rate 40.8`: a muni fund's tax-equivalent yield and muni/Treasury ratio under its fundamentals.
60
+ reportOptions: TAX_RATE_PANE_OPTIONS,
58
61
  quickSettings: [LIVE_STREAMING_QUICK_SETTING],
59
62
  settings: (context) => withLiveStreamingSetting(
60
63
  buildTickerResearchSettingsDef(getTickerResearchPaneSettings(context.settings)),
@@ -82,6 +85,8 @@ export const tickerDetailModule: PluginModule = {
82
85
  defaultPosition: "right",
83
86
  defaultMode: "floating",
84
87
  defaultFloatingSize: { width: 72, height: 10 },
88
+ // The board's quotes as `fn QQ --csv` writes them.
89
+ tableExport: true,
85
90
  quickSettings: [LIVE_STREAMING_QUICK_SETTING],
86
91
  settings: (context) => withLiveStreamingSetting(
87
92
  buildQuoteMonitorSettingsDef(context.settings),
@@ -1,5 +1,5 @@
1
1
  import type { ReactNode } from "react";
2
- import { ColumnGrid, ColumnGridPair, RangeTrack, usePaneLinkMenuEntry, type ColumnGridCell, type ColumnGridColumn } from "../../../../components";
2
+ import { ActionRow, ColumnGrid, ColumnGridPair, RangeTrack, usePaneLinkMenuEntry, type ColumnGridCell, type ColumnGridColumn } from "../../../../components";
3
3
  import { t, tf } from "../../../../i18n";
4
4
  import { formatMarketPriceWithCurrency, liveQuoteFormatOptions, type MarketFormatOptions } from "../../../../market-data/market/format";
5
5
  import { colors, hoverBg, priceColor } from "../../../../theme/colors";
@@ -245,6 +245,18 @@ function LinkedStatCell({
245
245
  );
246
246
  }
247
247
 
248
+ /**
249
+ * The way from a section into the function that has all of it ("Open
250
+ * Financials" under Fundamentals), as Trending's row opens Research Attention.
251
+ * Inside a `PaneLinkMenu` the pane menu lists it once with the section's
252
+ * figures that open the same function.
253
+ */
254
+ export function FunctionLinkRow({ link, onOpen }: { link: OverviewFunctionLink; onOpen: (link: OverviewFunctionLink) => void }) {
255
+ const label = tf("Open {label}", { label: t(link.name) });
256
+ usePaneLinkMenuEntry(`function:${link.templateId}`, label, () => onOpen(link));
257
+ return <ActionRow label={label} onPress={() => onOpen(link)} />;
258
+ }
259
+
248
260
  export function FundamentalsGrid({
249
261
  fields,
250
262
  width,
@@ -26,7 +26,7 @@ import {
26
26
  import { reportedQuoteVolume } from "../../../../market-data/market/index-level";
27
27
  import type { OverviewFunctionLink, PositionTableRow, StatField } from "./types";
28
28
  import type { OverviewDividendState } from "./dividend";
29
- import { NO_CURRENT_DIVIDEND } from "../../../../utils/forward-dividend";
29
+ import { lapseValue } from "../../../../utils/forward-dividend";
30
30
  import { getPortfolioPositionMetrics, getPortfolioQuoteDisplay, resolvePortfolioMarketValue, resolvePortfolioPositionPnl, portfolioPnlPercent, signedPositionDirection } from "../../../../portfolio/position-metrics";
31
31
  import { listingDividendYield, liveForwardPE, liveMarketCapitalization, liveTrailingPE } from "../../../../market-data/quotes/live-valuation";
32
32
  import { atRegularSessionPrice } from "../../../../market-data/quotes/regular-session-valuation";
@@ -46,7 +46,8 @@ const SHORT_INTEREST: OverviewFunctionLink = { name: "Short Interest", tabId: "s
46
46
  const EARNINGS: OverviewFunctionLink = { name: "Earnings", templateId: "earnings-calendar-pane" };
47
47
  const DIVIDENDS: OverviewFunctionLink = { name: "Dividends", tabId: "dividend-yield", templateId: "dividend-yield-pane" };
48
48
  const FUND_FACTS: OverviewFunctionLink = { name: "Fund Facts", templateId: "sec-etf-pane" };
49
- const FINANCIALS: OverviewFunctionLink = { name: "Financials", tabId: "financials", templateId: "financial-analysis-pane" };
49
+ /** The company's statements: Financials' first view in this pane, otherwise FA. */
50
+ export const FINANCIALS: OverviewFunctionLink = { name: "Financials", tabId: "financials", templateId: "financial-analysis-pane" };
50
51
  const ADR_PAIR: OverviewFunctionLink = { name: "ADR vs Home", tabId: ADR_PAIR_TAB_ID, templateId: ADR_PAIR_TEMPLATE_ID };
51
52
 
52
53
  /** A bond fund's sponsor figures in a narrow grid: `SEC Yield 4.04% 2026-10-15`. */
@@ -273,7 +274,8 @@ export function buildOverviewStats({
273
274
  const kind = bond ? "Dist" : "Div";
274
275
  const notSec = bond ? { detail: ["not SEC yield", "not SEC"] } : {};
275
276
  if (fundamentals && lapse) {
276
- stats.push({ label: `Fwd ${kind} Yld`, value: NO_CURRENT_DIVIDEND });
277
+ // A monthly payer's history that ends early (MUB's at 2026-09-01) says so, beside the last ex-date it holds.
278
+ stats.push({ label: `Fwd ${kind} Yld`, value: lapseValue(lapse) });
277
279
  } else if (fundamentals && dividendYield != null && !dividend?.pending) {
278
280
  const basis = fundamentals.dividendYieldBasis;
279
281
  const label = basis === "forward" ? `Fwd ${kind} Yld` : basis === "trailing" ? `TTM ${kind} Yld` : `${kind} Yield`;
@@ -291,7 +293,7 @@ export function buildOverviewStats({
291
293
  if (exDividendDate && ISO_DATE.test(exDividendDate)) {
292
294
  const days = today ? daysUntil(exDividendDate, today) : -1;
293
295
  stats.push({
294
- label: lapse ? "Last Paid" : "Ex-Dividend",
296
+ label: lapse ? (lapse.historyEnds ? "Last Ex" : "Last Paid") : "Ex-Dividend",
295
297
  value: calendarDate(exDividendDate, today ?? exDividendDate),
296
298
  detail: days >= 0 ? daysAhead(days) : undefined,
297
299
  link: DIVIDENDS,
@@ -1,5 +1,7 @@
1
1
  import { PerpEquityRow } from "../../perps/equity-row";
2
2
  import { PerpMarketsSection } from "../../perps/markets-section";
3
+ import { TickerNewsHeadlines } from "../../news/overview-headlines";
4
+ import { TICKER_NEWS_TAB_ID, TICKER_NEWS_TEMPLATE_ID } from "../../news/ticker-news";
3
5
  import { perpetualListing } from "../../../../tickers/perpetual-listing";
4
6
  import { useCallback } from "react";
5
7
  import type { TickerResearchTabProps } from "../../../../types/plugin";
@@ -16,9 +18,14 @@ import { useOpenResearchTab } from "../research-tab-navigation";
16
18
  import type { OverviewFunctionLink } from "./types";
17
19
  import { useOverviewDividend } from "./dividend";
18
20
  import { useTickerSnapshotState } from "../../../../market-data/hooks";
21
+ import { taxRatesFromSettings } from "../../../../market-data/tax-equivalent";
22
+ import { PaneLinkMenu } from "../../../../components";
23
+ import { FunctionLinkRow } from "./components";
19
24
 
20
25
  /** Registered by the chart composer, in the same plugin as this tab. */
21
26
  const CHART_TAB_ID = "chart";
27
+ /** The ticker's news: Buzz's News view in this pane, otherwise CN. */
28
+ const NEWS: OverviewFunctionLink = { name: "News", tabId: TICKER_NEWS_TAB_ID, templateId: TICKER_NEWS_TEMPLATE_ID };
22
29
 
23
30
  export function OverviewResearchTab({ width, height, focused }: TickerResearchTabProps) {
24
31
  const { symbol, ticker, financials } = usePaneTicker();
@@ -40,6 +47,8 @@ export function OverviewResearchTab({ width, height, focused }: TickerResearchTa
40
47
  const symbol = ticker?.metadata.ticker;
41
48
  if (symbol) createPaneFromTemplate(link.templateId, { symbol, symbols: [symbol], ticker });
42
49
  }, [createPaneFromTemplate, openResearchTab, ticker]);
50
+ // A headline opens its story in this pane's News view when it has one.
51
+ const openNewsView = useCallback(() => !!openResearchTab?.(TICKER_NEWS_TAB_ID), [openResearchTab]);
43
52
  return (
44
53
  <OverviewTab
45
54
  width={width}
@@ -51,6 +60,12 @@ export function OverviewResearchTab({ width, height, focused }: TickerResearchTa
51
60
  onOpenFunction={openFunction}
52
61
  dividend={dividend}
53
62
  snapshot={snapshot}
63
+ tax={taxRatesFromSettings(paneInstance?.settings)}
64
+ news={ticker ? (contentWidth: number) => (
65
+ <TickerNewsHeadlines ticker={ticker} width={contentWidth} openNewsView={openNewsView}>
66
+ <PaneLinkMenu><FunctionLinkRow link={NEWS} onOpen={openFunction} /></PaneLinkMenu>
67
+ </TickerNewsHeadlines>
68
+ ) : undefined}
54
69
  perpetuals={ticker ? (contentWidth: number) => {
55
70
  const instrumentType = financials?.quote?.instrumentType ?? ticker.metadata.assetCategory;
56
71
  // A contract's own DES shows its funding and premium; a stock or a coin lists its markets across venues.
@@ -0,0 +1,69 @@
1
+ import { useCallback } from "react";
2
+ import type { FundBondFacts } from "../../../../api-client/fund-facts";
3
+ import {
4
+ analyzeTaxEquivalent, formatMuniTreasuryRatio, loadTreasuryTenors, taxEquivalentLines,
5
+ type NoBondFigures, type TaxEquivalentAnalysis, type TaxRates, type YieldBasis,
6
+ } from "../../../../market-data/tax-equivalent";
7
+ import { useAsyncResource } from "../../../../react/async-resource";
8
+ import { formatFundYield } from "../../../../market-data/bond-funds";
9
+ import type { StatField } from "./types";
10
+
11
+ /**
12
+ * A fund's tax-equivalent yield and muni/Treasury ratio for the overview, at
13
+ * the rates `fn DES MUB --tax-rate 40.8` set on the pane: the same analysis
14
+ * DVD, ETF and fundamentals show. Null without rates, and while the fund's
15
+ * facts or the Treasury curve are still read, so a section is never drawn
16
+ * and then withdrawn.
17
+ */
18
+ export function useOverviewTaxEquivalent(input: {
19
+ symbol: string;
20
+ tax: { rates: TaxRates } | { error: string } | null;
21
+ /** The fund's bond facts once read: null for a fund without them, undefined while they are read. */
22
+ bond: FundBondFacts | null | undefined;
23
+ distribution: YieldBasis | null;
24
+ /** Why the listing has no bond figures to read: not a fund, or a fund listed abroad. */
25
+ noBondFigures?: NoBondFigures | null;
26
+ }): TaxEquivalentAnalysis | { error: string } | null {
27
+ const rates = input.tax && "rates" in input.tax ? input.tax.rates : null;
28
+ const loader = useCallback(() => loadTreasuryTenors(), []);
29
+ // A listing with no bond figures to read has no ratio to divide either.
30
+ const treasury = useAsyncResource(rates && !input.noBondFigures ? loader : null);
31
+ if (!input.tax) return null;
32
+ if ("error" in input.tax) return input.tax;
33
+ if (input.bond === undefined || (treasury.loading && !treasury.data)) return null;
34
+ return analyzeTaxEquivalent({
35
+ symbol: input.symbol, bond: input.bond, rates: input.tax.rates, distribution: input.distribution, treasury: treasury.data ?? null,
36
+ noBondFigures: input.noBondFigures ?? null,
37
+ });
38
+ }
39
+
40
+ /**
41
+ * The analysis as overview figures, as narrow as the bond figures beside
42
+ * them: the rate, the tax-equivalent yield and what it is on, the ratio and
43
+ * the Treasury it divides by. A figure that is missing reads `—` with why,
44
+ * cut to fit; DVD and fundamentals give the formulas whole.
45
+ */
46
+ export function taxEquivalentFields(analysis: TaxEquivalentAnalysis | { error: string }): StatField[] {
47
+ const missing = (label: string, why: string): StatField => ({ label, value: "—", detail: why, clipDetail: true });
48
+ if ("error" in analysis) return [missing("Tax-Eq Yld", analysis.error)];
49
+ const lines = taxEquivalentLines(analysis);
50
+ const line = (key: string) => lines.find((entry) => entry.key === key);
51
+ const fields: StatField[] = [];
52
+ const rate = line("taxRate");
53
+ if (rate) fields.push({ label: "Tax Rate", value: rate.export.formatted, detail: analysis.stateApplied && analysis.rates.state ? `federal + ${analysis.rates.state.code}` : "federal" });
54
+ const basis = analysis.basis;
55
+ if (analysis.checkError || analysis.notApplicable || analysis.taxEquivalentYield == null || !basis) {
56
+ fields.push(missing("Tax-Eq Yld", (analysis.checkError ?? analysis.notApplicable ?? "").replace(/^no tax-equivalent yield: /, "")));
57
+ return fields;
58
+ }
59
+ fields.push({ label: "Tax-Eq Yld", value: formatFundYield(analysis.taxEquivalentYield),
60
+ detail: basis.kind === "sec"
61
+ ? [`on SEC yield${basis.asOf ? ` ${basis.asOf}` : ""}`, "on SEC yield", "SEC"]
62
+ : [`on ${basis.label}`, "on dist yield", "dist"] });
63
+ const ratio = analysis.ratio;
64
+ fields.push(ratio
65
+ ? { label: "Muni/Tsy", value: formatMuniTreasuryRatio(ratio.value),
66
+ detail: [`vs ${ratio.treasury.tenor} ${formatFundYield(ratio.treasury.yield)}${ratio.treasury.asOf ? ` ${ratio.treasury.asOf}` : ""}`, `vs ${ratio.treasury.tenor} ${formatFundYield(ratio.treasury.yield)}`, `vs ${ratio.treasury.tenor}`] }
67
+ : missing("Muni/Tsy", (analysis.ratioNote ?? "").replace(/^no ratio: /, "")));
68
+ return fields;
69
+ }
@@ -46,6 +46,7 @@ import { isReceiptSide, listingCedearRatio, listingDepositaryPair } from "../../
46
46
  import {
47
47
  CompactRangeBar,
48
48
  FundamentalsGrid,
49
+ FunctionLinkRow,
49
50
  PositionTable,
50
51
  QuoteBook,
51
52
  rangeEndpointWidth,
@@ -56,7 +57,8 @@ import { useFuturesContractTerms } from "./overview/futures-contract";
56
57
  import type { OverviewDividendState } from "./overview/dividend";
57
58
  import { optionContractFields, useOptionContractRow } from "./overview/option-contract";
58
59
  import { resolveOptionsTarget } from "../../../utils/options";
59
- import { buildOverviewStats, buildPositionRows, buildProfileFields } from "./overview/model";
60
+ import { buildOverviewStats, buildPositionRows, buildProfileFields, FINANCIALS } from "./overview/model";
61
+ import { hasStatementFinancials } from "./financials/model";
60
62
  import type { OverviewFunctionLink, StatField } from "./overview/types";
61
63
  import { describeFundamentalMarketCap } from "../../../utils/market-capitalization";
62
64
  import { liveFiftyTwoWeekRange, liveMarketCapitalization } from "../../../market-data/quotes/live-valuation";
@@ -66,6 +68,9 @@ import { DelayedMark, delayedMarkWidth, useDelayedMarkMinutes } from "../../../c
66
68
  import { safeExternalUrl } from "../../../utils/external-url";
67
69
  import { cashRunway, SHORT_RUNWAY_HISTORY } from "../../../utils/cash-runway";
68
70
  import { useOfferingNote } from "./financials/offerings";
71
+ import { taxEquivalentFields, useOverviewTaxEquivalent } from "./overview/tax-equivalent";
72
+ import { distributionBasis, type TaxRates } from "../../../market-data/tax-equivalent";
73
+ import { currentListingName } from "../../../tickers/listing-name";
69
74
 
70
75
  /** Cells between the Day and 52W ranges when they share a row. */
71
76
  const RANGE_PAIR_GAP = 4;
@@ -90,6 +95,8 @@ function contractField(line: FuturesContractLine): StatField {
90
95
  interface OverviewTabProps {
91
96
  /** The contracts on the security, given the width of the overview's content. */
92
97
  perpetuals?: ReactNode | ((contentWidth: number) => ReactNode);
98
+ /** The company's latest news, given the width of the overview's content; it draws nothing while there is none. */
99
+ news?: ReactNode | ((contentWidth: number) => ReactNode);
93
100
  width?: number;
94
101
  /** The tab's height; a short one keeps fewer futures contract terms. */
95
102
  height?: number;
@@ -104,6 +111,8 @@ interface OverviewTabProps {
104
111
  dividend?: OverviewDividendState;
105
112
  /** Where the ticker's snapshot load stands (useTickerSnapshotState), for the state shown before anything of it is in. */
106
113
  snapshot?: TickerSnapshotState;
114
+ /** The rates `fn DES --tax-rate` set (taxRatesFromSettings): a fund's tax-equivalent yield and muni/Treasury ratio follow its facts. */
115
+ tax?: { rates: TaxRates } | { error: string } | null;
107
116
  }
108
117
 
109
118
  /** Nothing of the ticker is in yet: no quote, profile, figures or history. */
@@ -135,7 +144,7 @@ export function OverviewTab(props: OverviewTabProps) {
135
144
  /** Where a fund's facts open: the ETF function, its facts over its filings. */
136
145
  const FUND_FACTS_LINK: OverviewFunctionLink = { name: "Fund Facts", templateId: "sec-etf-pane" };
137
146
 
138
- function ResolvedOverviewTab({ width, height, focused = false, ticker, financials, onOpenChart, onOpenFunction, perpetuals, dividend }: OverviewTabProps & { ticker: TickerRecord }) {
147
+ function ResolvedOverviewTab({ width, height, focused = false, ticker, financials, onOpenChart, onOpenFunction, perpetuals, news, dividend, tax = null }: OverviewTabProps & { ticker: TickerRecord }) {
139
148
  const trade = useResearchTrading();
140
149
  const baseCurrency = useAppSelector((state) => state.config.baseCurrency);
141
150
  const portfolios = useAppSelector((state) => state.config.portfolios);
@@ -200,8 +209,21 @@ function ResolvedOverviewTab({ width, height, focused = false, ticker, financial
200
209
  ].filter((part) => part.length > 0);
201
210
 
202
211
  // A US-listed fund's facts (fee, NAV, premium, net assets) stand where a company's fundamentals would; each opens ETF.
203
- const fundFactsSymbol = resolveTickerInstrumentKind(ticker, financials) === "fund" && mayBeUsEquityOrFundTicker(ticker) ? ticker.metadata.ticker : null;
204
- const fundFacts = useFundFacts(fundFactsSymbol).data?.payload;
212
+ const instrumentKind = resolveTickerInstrumentKind(ticker, financials);
213
+ const fundFactsSymbol = instrumentKind === "fund" && mayBeUsEquityOrFundTicker(ticker) ? ticker.metadata.ticker : null;
214
+ const fundFactsResource = useFundFacts(fundFactsSymbol);
215
+ const fundFacts = fundFactsResource.data?.payload;
216
+ // With --tax-rate: on the sponsor's SEC yield, else the distribution yield fundamentals states, as `fundamentals` reads it.
217
+ const taxEquivalent = useOverviewTaxEquivalent({
218
+ symbol: ticker.metadata.ticker,
219
+ tax,
220
+ bond: !fundFactsSymbol ? null : fundFacts ? (fundFacts.covered ? fundFacts.bond ?? null : null)
221
+ : fundFactsResource.loading ? undefined : null,
222
+ // A stock, or a fund listed abroad, has no bond figures to read, and says why once its quote says what it is.
223
+ noBondFigures: !financials?.quote ? null : instrumentKind !== "fund" ? "not-a-fund" : !fundFactsSymbol ? "listed-abroad" : null,
224
+ distribution: distributionBasis(financials?.fundamentals?.dividendYield, financials?.fundamentals?.dividendYieldBasis === "trailing" ? "trailing" : "forward"),
225
+ });
226
+ const taxFields = taxEquivalent ? taxEquivalentFields(taxEquivalent) : [];
205
227
  // Each figure dated; one older than it looks takes the warning colour, as in ETF.
206
228
  const fundFactFields: StatField[] = fundFacts?.covered
207
229
  ? fundFactOverviewFields(fundFacts).map(({ warn, ...field }) => ({ ...field, ...(warn ? { valueColor: colors.warning } : {}), link: FUND_FACTS_LINK }))
@@ -274,7 +296,8 @@ function ResolvedOverviewTab({ width, height, focused = false, ticker, financial
274
296
  // The days the venue was closed since that close, under the move: "HKEX closed Mon 19 Oct, holiday".
275
297
  const changeBasisNoteText = changeBasisNote(changeBasis);
276
298
  // The pane title already names the ticker, so the line leads with the company and drops a name that only repeats it.
277
- const companyName = [ticker.metadata.name, quote?.name].find((name) => name && name !== ticker.metadata.ticker) ?? "";
299
+ // The listing's own quote names it first: BA on LSE is BAE Systems, whatever name a search gave the row it was saved from.
300
+ const companyName = currentListingName(ticker, quote) ?? "";
278
301
  const venueText = listingVenue ? (companyName ? ` (${listingVenue})` : listingVenue) : "";
279
302
  const sessionLabel = quoteSessionLabel(quote);
280
303
  const marketStateText = sessionLabel ? t(sessionLabel) : "";
@@ -288,7 +311,7 @@ function ResolvedOverviewTab({ width, height, focused = false, ticker, financial
288
311
  // extended-hours line hangs below, as it comes and goes with the session. Without a
289
312
  // price the logo keeps two rows.
290
313
  const hasLogo = nativePaneChrome === true
291
- && resolveCompanyLogoSrc({ symbol: ticker.metadata.ticker, assetCategory: ticker.metadata.assetCategory }) != null;
314
+ && resolveCompanyLogoSrc({ symbol: ticker.metadata.ticker, assetCategory: ticker.metadata.assetCategory, exchange: ticker.metadata.exchange }) != null;
292
315
  const priceInk = figureLineInk();
293
316
  // The top snaps up to a whole px so it never starts below the capitals; the bottom lands
294
317
  // on the device pixel nearest the baseline.
@@ -426,6 +449,7 @@ function ResolvedOverviewTab({ width, height, focused = false, ticker, financial
426
449
  <CompanyLogo
427
450
  symbol={ticker.metadata.ticker}
428
451
  assetCategory={ticker.metadata.assetCategory}
452
+ exchange={ticker.metadata.exchange}
429
453
  name={ticker.metadata.name || quote?.name}
430
454
  width={logoPx / cellWidthPx}
431
455
  height={logoPx / cellHeightPx}
@@ -609,10 +633,19 @@ function ResolvedOverviewTab({ width, height, focused = false, ticker, financial
609
633
  <SectionHeading title={t("Fundamentals")} />
610
634
  <PaneLinkMenu>
611
635
  <FundamentalsGrid fields={stats} width={contentWidth} onOpenLink={onOpenFunction} />
636
+ {/* The statements behind the figures, for a company that has them. */}
637
+ {onOpenFunction && hasStatementFinancials(financials) ? <FunctionLinkRow link={FINANCIALS} onOpen={onOpenFunction} /> : null}
612
638
  </PaneLinkMenu>
613
639
  </Box>
614
640
  )}
615
641
 
642
+ {taxFields.length > 0 && (
643
+ <Box flexDirection="column">
644
+ <SectionHeading title={t("Tax-Equivalent Yield")} />
645
+ <FundamentalsGrid fields={taxFields} width={contentWidth} />
646
+ </Box>
647
+ )}
648
+
616
649
  {positionRows.length > 0 && (
617
650
  <Box flexDirection="column">
618
651
  <SectionHeading title={t("Positions")} />
@@ -622,6 +655,8 @@ function ResolvedOverviewTab({ width, height, focused = false, ticker, financial
622
655
 
623
656
  {trade?.orders?.(contentWidth)}
624
657
 
658
+ {typeof news === "function" ? news(contentWidth) : news}
659
+
625
660
  {profileFields.length > 0 && (
626
661
  <Box flexDirection="column">
627
662
  <SectionHeading title={t("Profile")} />