gloomberb 0.20.11 → 0.20.13

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 (677) hide show
  1. package/package.json +2 -1
  2. package/src/account/billing.ts +3 -2
  3. package/src/account/upgrade-dialog.tsx +8 -8
  4. package/src/api-client/awards.ts +16 -0
  5. package/src/api-client/central-bank-rates.ts +5 -0
  6. package/src/api-client/data.ts +55 -2
  7. package/src/api-client/index.ts +28 -3
  8. package/src/api-client/install-experiments.ts +146 -0
  9. package/src/api-client/request.ts +86 -3
  10. package/src/api-client/socket-connection.ts +12 -1
  11. package/src/api-client/socket.ts +21 -3
  12. package/src/api-client/supply-chain-graph.ts +4 -2
  13. package/src/api-client/supply-chain.ts +8 -0
  14. package/src/api-client/telemetry.ts +47 -0
  15. package/src/api-client/types/econ.ts +10 -7
  16. package/src/api-client/types/filings-and-calls.ts +8 -0
  17. package/src/api-client/types/market.ts +4 -0
  18. package/src/api-client/types/news.ts +16 -0
  19. package/src/app/global-shortcuts.ts +2 -1
  20. package/src/app/keybindings/actions.ts +19 -0
  21. package/src/app/pane-runtime/index.tsx +18 -3
  22. package/src/app/pane-runtime/layout-placement.ts +63 -0
  23. package/src/app/pane-runtime/ticker-open-runtime.ts +10 -2
  24. package/src/architecture/floating-promise-allowlist.json +17 -33
  25. package/src/brokers/signed-in/adapter.ts +2 -2
  26. package/src/brokers/signed-in/catalog.ts +13 -4
  27. package/src/capabilities/chart-series.ts +4 -1
  28. package/src/cli/board-coins.ts +10 -1
  29. package/src/cli/commands/crypto-hints.ts +3 -2
  30. package/src/cli/commands/fred-series.ts +0 -54
  31. package/src/cli/commands/market.ts +260 -63
  32. package/src/cli/commands/overview.ts +50 -17
  33. package/src/cli/commands/search.ts +140 -17
  34. package/src/cli/commands/ticker.ts +37 -17
  35. package/src/cli/desktop-pane-shot.ts +27 -2
  36. package/src/cli/earnings-calendar.ts +33 -53
  37. package/src/cli/fx-quote-rate.ts +1 -1
  38. package/src/cli/glossary.ts +14 -5
  39. package/src/cli/history-catalog-series.ts +85 -0
  40. package/src/cli/history-rows.ts +18 -1
  41. package/src/cli/index.ts +1 -1
  42. package/src/cli/known-gaps.ts +9 -0
  43. package/src/cli/list-progress.ts +45 -0
  44. package/src/cli/listing-arg.ts +176 -25
  45. package/src/cli/name-entries.ts +8 -4
  46. package/src/cli/not-a-ticker.ts +2 -2
  47. package/src/cli/pane-functions/catalog.ts +55 -7
  48. package/src/cli/pane-functions/dom.ts +8 -1
  49. package/src/cli/pane-functions/freshness.ts +52 -5
  50. package/src/cli/pane-functions/headless.ts +8 -8
  51. package/src/cli/pane-functions/index.ts +8 -5
  52. package/src/cli/pane-functions/market-session.ts +66 -14
  53. package/src/cli/pane-functions/options.ts +5 -0
  54. package/src/cli/pane-functions/report.ts +4 -1
  55. package/src/cli/pane-functions/resolver.ts +9 -2
  56. package/src/cli/pane-functions/screenshot-assessment.ts +28 -3
  57. package/src/cli/pane-functions/screenshot-types.ts +6 -0
  58. package/src/cli/perpetual-contract.ts +4 -4
  59. package/src/cli/quote-answer.ts +55 -12
  60. package/src/cli/quote-list-reads.ts +87 -0
  61. package/src/cli/report-tables.ts +70 -13
  62. package/src/cli/result.ts +26 -3
  63. package/src/cli/symbol-list.ts +31 -4
  64. package/src/cli/terminal-code-hints.ts +83 -0
  65. package/src/cli/ticker-resolution.ts +2 -1
  66. package/src/cli/treasury-yields.ts +5 -0
  67. package/src/components/chart/composite/axis-overlays.tsx +5 -2
  68. package/src/components/chart/composite/composite-chart.tsx +1 -0
  69. package/src/components/chart/composite/format.ts +101 -15
  70. package/src/components/chart/composite/legend.tsx +60 -25
  71. package/src/components/chart/composite/time-axis.ts +51 -29
  72. package/src/components/chart/composite/toolbar.tsx +42 -6
  73. package/src/components/chart/curve/curve-surface.tsx +5 -5
  74. package/src/components/command-bar/action-runtime.ts +2 -0
  75. package/src/components/command-bar/list/badge.ts +8 -5
  76. package/src/components/command-bar/list/model.ts +0 -5
  77. package/src/components/command-bar/list/view.tsx +39 -2
  78. package/src/components/command-bar/routes/root/plugin-install.ts +4 -2
  79. package/src/components/command-bar/routes/root/provider-search.ts +23 -3
  80. package/src/components/command-bar/routes/root/results.ts +20 -9
  81. package/src/components/command-bar/routes/root/start-here.ts +1 -2
  82. package/src/components/command-bar/routes/ticker-search/actions.ts +2 -3
  83. package/src/components/command-bar/routes/ticker-search/results.ts +23 -4
  84. package/src/components/command-bar/routing/launch-request.ts +2 -1
  85. package/src/components/command-bar/routing/navigation-state.ts +4 -2
  86. package/src/components/command-bar/workflow/types.ts +6 -0
  87. package/src/components/data-table/view.tsx +29 -6
  88. package/src/components/form-modal/host.tsx +1 -1
  89. package/src/components/layout/detached-pane-shell.tsx +3 -0
  90. package/src/components/layout/double-escape-close.ts +34 -3
  91. package/src/components/layout/floating-pane.tsx +10 -4
  92. package/src/components/layout/header.tsx +3 -2
  93. package/src/components/layout/market-summary.ts +3 -3
  94. package/src/components/layout/pane/cycle-order.ts +66 -2
  95. package/src/components/layout/pane/error-boundary.tsx +2 -1
  96. package/src/components/layout/pane/header.tsx +140 -31
  97. package/src/components/layout/pane/sidebar.tsx +13 -5
  98. package/src/components/layout/pane/status-footer.ts +3 -1
  99. package/src/components/layout/shell/drag/runtime.ts +5 -0
  100. package/src/components/layout/shell/index.tsx +25 -0
  101. package/src/components/layout/shell/menu.ts +9 -0
  102. package/src/components/layout/shell/pane/actions.ts +36 -0
  103. package/src/components/layout/shell/pane/management-shortcuts.ts +27 -3
  104. package/src/components/layout/shell/pane-occlusion.ts +40 -0
  105. package/src/components/layout/shell/shortcuts.ts +17 -1
  106. package/src/components/layout/shell/terminal-pointer-runtime.ts +39 -6
  107. package/src/components/layout/shell/window-mode/index.ts +5 -16
  108. package/src/components/layout/shell/window-mode/overlays.tsx +3 -1
  109. package/src/components/markdown-text.tsx +36 -0
  110. package/src/components/market-board/index.tsx +18 -8
  111. package/src/components/metric-treemap/index.tsx +3 -1
  112. package/src/components/onboarding/first-run-workspace.ts +46 -11
  113. package/src/components/onboarding/onboarding-keyboard.ts +57 -5
  114. package/src/components/onboarding/onboarding-wizard.tsx +91 -24
  115. package/src/components/onboarding/portfolio-step/index.tsx +1 -0
  116. package/src/components/onboarding/portfolio-step/positions-panel.tsx +36 -9
  117. package/src/components/onboarding/portfolio-step/types.ts +2 -0
  118. package/src/components/onboarding/tickers-step-model.ts +140 -0
  119. package/src/components/onboarding/tickers-step.tsx +116 -0
  120. package/src/components/onboarding/use-onboarding-broker-form.ts +1 -1
  121. package/src/components/onboarding/use-onboarding-progress.ts +100 -11
  122. package/src/components/onboarding/use-onboarding-upgrade.ts +3 -2
  123. package/src/components/onboarding/wizard-model.ts +3 -1
  124. package/src/components/onboarding/wizard-tickers.ts +139 -0
  125. package/src/components/price-performance.tsx +2 -2
  126. package/src/components/speedometer-gauge/model.ts +2 -1
  127. package/src/components/speedometer-gauge/terminal.tsx +13 -8
  128. package/src/components/ui/button.tsx +48 -4
  129. package/src/components/ui/choice-dialog.tsx +101 -32
  130. package/src/components/ui/data-table/opentui/index.tsx +24 -9
  131. package/src/components/ui/data-table/types.ts +7 -0
  132. package/src/components/ui/inline-quick-add.tsx +19 -3
  133. package/src/components/ui/list-view.tsx +11 -5
  134. package/src/components/ui/multi-select/dialog.tsx +1 -7
  135. package/src/components/ui/not-meaningful.ts +16 -0
  136. package/src/components/ui/query-bar.tsx +32 -5
  137. package/src/components/ui/selection-fill.ts +39 -0
  138. package/src/components/ui/stat-grid.tsx +27 -6
  139. package/src/core/state/app/layout-reducer.ts +2 -1
  140. package/src/core/state/app/pane-choices.ts +68 -0
  141. package/src/core/state/app/state.ts +14 -6
  142. package/src/core/state/app/types.ts +8 -0
  143. package/src/data/config/store/normalize.ts +2 -0
  144. package/src/docs/snapshot.json +1 -1
  145. package/src/i18n/es.ts +5 -2
  146. package/src/i18n/ja.ts +5 -2
  147. package/src/i18n/ko.ts +5 -2
  148. package/src/i18n/zh-cn.ts +5 -2
  149. package/src/i18n/zh-tw.ts +5 -2
  150. package/src/layout/pane-manager/dock-tree.ts +19 -0
  151. package/src/layout/pane-manager/index.ts +3 -0
  152. package/src/layout-marketplace/model.ts +2 -1
  153. package/src/market-data/futures-contract.ts +2 -1
  154. package/src/market-data/hooks.tsx +1 -1
  155. package/src/market-data/market/change-basis.ts +27 -5
  156. package/src/market-data/market/format.ts +13 -13
  157. package/src/market-data/market/freshness.ts +33 -0
  158. package/src/market-data/market/status.ts +5 -1
  159. package/src/market-data/quotes/contributions.ts +10 -0
  160. package/src/market-data/quotes/freshness.ts +19 -0
  161. package/src/market-data/quotes/listing-enterprise-value.ts +3 -3
  162. package/src/market-data/quotes/live-valuation.ts +31 -4
  163. package/src/market-data/quotes/resolution.ts +4 -0
  164. package/src/market-data/quotes/time.ts +17 -24
  165. package/src/market-data/tax-equivalent.ts +3 -2
  166. package/src/news/aggregator.ts +19 -8
  167. package/src/news/hooks.ts +1 -1
  168. package/src/news/news-model.ts +49 -0
  169. package/src/news/types.ts +9 -0
  170. package/src/plugins/builtin/account-management/calendar-tab.tsx +8 -3
  171. package/src/plugins/builtin/account-management/index.tsx +1 -0
  172. package/src/plugins/builtin/account-management/pane.tsx +9 -8
  173. package/src/plugins/builtin/alerts/calendar-events.ts +4 -5
  174. package/src/plugins/builtin/alerts/format.ts +6 -5
  175. package/src/plugins/builtin/alerts/headless.ts +3 -2
  176. package/src/plugins/builtin/alerts/history.ts +2 -1
  177. package/src/plugins/builtin/alerts/pane.tsx +2 -1
  178. package/src/plugins/builtin/alerts/price-text.ts +2 -1
  179. package/src/plugins/builtin/alerts/scheduled.ts +6 -5
  180. package/src/plugins/builtin/analytics/account-returns.ts +6 -7
  181. package/src/plugins/builtin/analytics/display.ts +2 -1
  182. package/src/plugins/builtin/analytics/pane-model.ts +5 -9
  183. package/src/plugins/builtin/analytics/risk-model.ts +6 -6
  184. package/src/plugins/builtin/analytics/risk-pane.tsx +6 -5
  185. package/src/plugins/builtin/analytics/view.tsx +5 -5
  186. package/src/plugins/builtin/attention/model.ts +6 -5
  187. package/src/plugins/builtin/attention/pane.tsx +5 -4
  188. package/src/plugins/builtin/awards/detail.tsx +17 -8
  189. package/src/plugins/builtin/awards/headless.ts +37 -15
  190. package/src/plugins/builtin/awards/model.ts +40 -5
  191. package/src/plugins/builtin/awards/pane.tsx +11 -8
  192. package/src/plugins/builtin/backtest/format.ts +3 -2
  193. package/src/plugins/builtin/backtest/report.ts +3 -2
  194. package/src/plugins/builtin/bond-calculator/headless.ts +2 -1
  195. package/src/plugins/builtin/bond-calculator/pane.tsx +2 -1
  196. package/src/plugins/builtin/broker-manager/add-flow.tsx +1 -1
  197. package/src/plugins/builtin/broker-manager/index.tsx +1 -0
  198. package/src/plugins/builtin/broker-trading/index.tsx +1 -1
  199. package/src/plugins/builtin/broker-trading/orders-data.ts +3 -3
  200. package/src/plugins/builtin/broker-trading/orders.tsx +3 -2
  201. package/src/plugins/builtin/broker-trading/ticket.tsx +2 -2
  202. package/src/plugins/builtin/buildout/cells.tsx +2 -1
  203. package/src/plugins/builtin/buildout/company/pane.tsx +4 -3
  204. package/src/plugins/builtin/buildout/data-runtime.ts +21 -23
  205. package/src/plugins/builtin/buildout/detail/values.ts +2 -1
  206. package/src/plugins/builtin/buildout/format.ts +4 -3
  207. package/src/plugins/builtin/buildout/pane/index.tsx +3 -3
  208. package/src/plugins/builtin/catalysts/detail.tsx +2 -1
  209. package/src/plugins/builtin/catalysts/model.ts +6 -5
  210. package/src/plugins/builtin/catalysts/pane.tsx +2 -1
  211. package/src/plugins/builtin/cds/headless.ts +3 -2
  212. package/src/plugins/builtin/cds/model.ts +8 -8
  213. package/src/plugins/builtin/cds/pane.tsx +3 -2
  214. package/src/plugins/builtin/central-bank-rates/headless.ts +8 -7
  215. package/src/plugins/builtin/central-bank-rates/index.tsx +1 -1
  216. package/src/plugins/builtin/central-bank-rates/model.ts +24 -5
  217. package/src/plugins/builtin/central-bank-rates/pane.tsx +19 -9
  218. package/src/plugins/builtin/changelog/index.tsx +2 -2
  219. package/src/plugins/builtin/chart-composer/headless.ts +5 -1
  220. package/src/plugins/builtin/chart-composer/index.tsx +4 -2
  221. package/src/plugins/builtin/chart-composer/pane.tsx +8 -3
  222. package/src/plugins/builtin/chart-composer/use-series-catalog.ts +3 -1
  223. package/src/plugins/builtin/chart-composer/user-series.ts +3 -1
  224. package/src/plugins/builtin/chat/attachments/desktop.tsx +2 -1
  225. package/src/plugins/builtin/chat/content/handle-prompt.tsx +4 -0
  226. package/src/plugins/builtin/chat/controller/realtime.ts +17 -1
  227. package/src/plugins/builtin/chat/controller/utils.ts +2 -1
  228. package/src/plugins/builtin/chat/message/terminal.tsx +4 -1
  229. package/src/plugins/builtin/chat/sidebar.tsx +3 -4
  230. package/src/plugins/builtin/clinical-trials/model.ts +4 -3
  231. package/src/plugins/builtin/clinical-trials/sponsor-tickers.ts +4 -2
  232. package/src/plugins/builtin/cloud/askg/lock-note.ts +16 -4
  233. package/src/plugins/builtin/cloud/askg/model.ts +2 -1
  234. package/src/plugins/builtin/cloud/askg/pane.tsx +39 -1
  235. package/src/plugins/builtin/cloud/company-picker.tsx +1 -3
  236. package/src/plugins/builtin/cloud/plugin.tsx +1 -0
  237. package/src/plugins/builtin/cloud/team/module.tsx +1 -0
  238. package/src/plugins/builtin/cloud/team/pane.tsx +12 -12
  239. package/src/plugins/builtin/cloud/thesis/detail.tsx +22 -12
  240. package/src/plugins/builtin/cloud-tweets/model.ts +2 -2
  241. package/src/plugins/builtin/comment-letters/pane.tsx +2 -1
  242. package/src/plugins/builtin/commodity-balances/headless.ts +3 -2
  243. package/src/plugins/builtin/commodity-balances/pane.tsx +13 -5
  244. package/src/plugins/builtin/company-attention/app-rank.tsx +5 -4
  245. package/src/plugins/builtin/company-attention/building-model.ts +7 -7
  246. package/src/plugins/builtin/company-attention/headless.ts +6 -5
  247. package/src/plugins/builtin/company-attention/model.ts +4 -4
  248. package/src/plugins/builtin/company-attention/moves-model.ts +9 -9
  249. package/src/plugins/builtin/company-attention/signals-model.ts +9 -9
  250. package/src/plugins/builtin/company-kpis/headless.ts +2 -1
  251. package/src/plugins/builtin/company-kpis/model.ts +18 -13
  252. package/src/plugins/builtin/company-kpis/pane.tsx +2 -2
  253. package/src/plugins/builtin/congress-trades/detail.tsx +6 -5
  254. package/src/plugins/builtin/congress-trades/headless.ts +2 -1
  255. package/src/plugins/builtin/congress-trades/model.ts +6 -6
  256. package/src/plugins/builtin/congress-trades/table.tsx +7 -6
  257. package/src/plugins/builtin/connections/index.ts +1 -0
  258. package/src/plugins/builtin/connections/pane.tsx +5 -5
  259. package/src/plugins/builtin/correlation/headless.ts +2 -2
  260. package/src/plugins/builtin/correlation/index.tsx +4 -1
  261. package/src/plugins/builtin/correlation/matrix/selection.ts +2 -1
  262. package/src/plugins/builtin/correlation/relationship/view-model.ts +3 -3
  263. package/src/plugins/builtin/cot/headless.ts +3 -2
  264. package/src/plugins/builtin/cot/model.ts +2 -1
  265. package/src/plugins/builtin/cot/pane.tsx +4 -3
  266. package/src/plugins/builtin/cpi/headless.ts +4 -3
  267. package/src/plugins/builtin/cpi/model.ts +8 -7
  268. package/src/plugins/builtin/credit-boards/cdx-pane.tsx +14 -9
  269. package/src/plugins/builtin/credit-boards/client.ts +5 -0
  270. package/src/plugins/builtin/credit-boards/headless.ts +3 -7
  271. package/src/plugins/builtin/credit-boards/model.ts +5 -11
  272. package/src/plugins/builtin/credit-boards/series.ts +19 -8
  273. package/src/plugins/builtin/credit-boards/sovr-pane.tsx +9 -5
  274. package/src/plugins/builtin/credit-conditions/headless.ts +2 -1
  275. package/src/plugins/builtin/credit-conditions/index.tsx +2 -2
  276. package/src/plugins/builtin/credit-documents/model.ts +2 -2
  277. package/src/plugins/builtin/crypto-board/defi-view.tsx +7 -7
  278. package/src/plugins/builtin/crypto-board/defi.ts +2 -2
  279. package/src/plugins/builtin/crypto-board/model.ts +4 -3
  280. package/src/plugins/builtin/crypto-board/pane.tsx +8 -8
  281. package/src/plugins/builtin/crypto-board/supply.ts +2 -2
  282. package/src/plugins/builtin/crypto-etf-flows/headless.ts +23 -13
  283. package/src/plugins/builtin/crypto-etf-flows/model.ts +4 -4
  284. package/src/plugins/builtin/crypto-etf-flows/pane.tsx +8 -3
  285. package/src/plugins/builtin/custom-view/index.tsx +3 -1
  286. package/src/plugins/builtin/custom-view/pane.tsx +5 -1
  287. package/src/plugins/builtin/custom-view/view-spec.ts +11 -0
  288. package/src/plugins/builtin/debt-maturities/headless.ts +16 -7
  289. package/src/plugins/builtin/debt-maturities/model.ts +12 -18
  290. package/src/plugins/builtin/debt-maturities/pane.tsx +11 -12
  291. package/src/plugins/builtin/dividend-yield/client.ts +7 -3
  292. package/src/plugins/builtin/dividend-yield/headless.ts +16 -11
  293. package/src/plugins/builtin/dividend-yield/pane.tsx +12 -10
  294. package/src/plugins/builtin/dividend-yield/ranking-view.tsx +4 -1
  295. package/src/plugins/builtin/dividend-yield/ranking.ts +19 -11
  296. package/src/plugins/builtin/dividend-yield/types.ts +4 -0
  297. package/src/plugins/builtin/dividend-yield/view.ts +3 -3
  298. package/src/plugins/builtin/docs/use-docs.ts +4 -2
  299. package/src/plugins/builtin/doe/headless.ts +2 -1
  300. package/src/plugins/builtin/doe/model.ts +12 -11
  301. package/src/plugins/builtin/earnings/board-model.ts +42 -7
  302. package/src/plugins/builtin/earnings/board-table.ts +13 -8
  303. package/src/plugins/builtin/earnings/board.tsx +15 -3
  304. package/src/plugins/builtin/earnings/calendar-model.ts +5 -5
  305. package/src/plugins/builtin/earnings/calendar.tsx +11 -6
  306. package/src/plugins/builtin/earnings/client.ts +0 -9
  307. package/src/plugins/builtin/earnings/format.ts +16 -14
  308. package/src/plugins/builtin/earnings/headless.ts +64 -23
  309. package/src/plugins/builtin/earnings/history-model.ts +11 -7
  310. package/src/plugins/builtin/earnings/history-table.ts +14 -9
  311. package/src/plugins/builtin/earnings/history.tsx +22 -14
  312. package/src/plugins/builtin/earnings-calls/calendar.tsx +2 -1
  313. package/src/plugins/builtin/earnings-calls/data.ts +24 -4
  314. package/src/plugins/builtin/earnings-calls/format.ts +29 -10
  315. package/src/plugins/builtin/earnings-calls/headless.ts +23 -3
  316. package/src/plugins/builtin/earnings-calls/index.tsx +1 -0
  317. package/src/plugins/builtin/earnings-calls/model.ts +11 -1
  318. package/src/plugins/builtin/earnings-calls/pane.tsx +2 -5
  319. package/src/plugins/builtin/earnings-calls/upcoming.ts +5 -5
  320. package/src/plugins/builtin/earnings-ripple/headless.ts +2 -1
  321. package/src/plugins/builtin/earnings-ripple/model.ts +3 -2
  322. package/src/plugins/builtin/earnings-ripple/pane.tsx +6 -6
  323. package/src/plugins/builtin/econ/calendar-model.ts +29 -2
  324. package/src/plugins/builtin/econ/detail-view.tsx +2 -2
  325. package/src/plugins/builtin/econ/fred-catalog.ts +3 -0
  326. package/src/plugins/builtin/econ/index.tsx +16 -8
  327. package/src/plugins/builtin/econ-statistics/detail.tsx +2 -1
  328. package/src/plugins/builtin/econ-statistics/headless.ts +7 -5
  329. package/src/plugins/builtin/econ-statistics/index.tsx +1 -1
  330. package/src/plugins/builtin/econ-statistics/pane.tsx +2 -2
  331. package/src/plugins/builtin/equity-screener/headless.ts +5 -5
  332. package/src/plugins/builtin/equity-screener/model.ts +6 -4
  333. package/src/plugins/builtin/equity-screener/pane.tsx +7 -7
  334. package/src/plugins/builtin/equity-screener/screen-check.ts +2 -1
  335. package/src/plugins/builtin/equity-screener/ticker-check.tsx +2 -1
  336. package/src/plugins/builtin/estimate-revisions/model.ts +3 -2
  337. package/src/plugins/builtin/estimate-revisions/pane.tsx +8 -8
  338. package/src/plugins/builtin/executives/format.ts +4 -4
  339. package/src/plugins/builtin/exposure/headless.ts +8 -8
  340. package/src/plugins/builtin/exposure/model.ts +4 -3
  341. package/src/plugins/builtin/exposure/pane.tsx +6 -5
  342. package/src/plugins/builtin/fear-greed/format.ts +7 -7
  343. package/src/plugins/builtin/fear-greed/headless.ts +18 -14
  344. package/src/plugins/builtin/fear-greed/pane.tsx +12 -4
  345. package/src/plugins/builtin/filing-events/feed.ts +2 -1
  346. package/src/plugins/builtin/filing-events/index.tsx +1 -0
  347. package/src/plugins/builtin/futures/table.tsx +8 -8
  348. package/src/plugins/builtin/futures-curve/headless.ts +18 -18
  349. package/src/plugins/builtin/futures-curve/model.ts +5 -5
  350. package/src/plugins/builtin/futures-curve/pane.tsx +8 -8
  351. package/src/plugins/builtin/fx-matrix/index.tsx +32 -21
  352. package/src/plugins/builtin/fx-matrix/pairs.ts +2 -1
  353. package/src/plugins/builtin/gpu/board.tsx +6 -5
  354. package/src/plugins/builtin/gpu/changes.tsx +2 -1
  355. package/src/plugins/builtin/gpu/equities.tsx +2 -2
  356. package/src/plugins/builtin/gpu/headless.ts +4 -3
  357. package/src/plugins/builtin/gpu/model.ts +8 -7
  358. package/src/plugins/builtin/help/functions-table.tsx +41 -9
  359. package/src/plugins/builtin/help/index.tsx +6 -3
  360. package/src/plugins/builtin/help/keybindings-editor.tsx +35 -7
  361. package/src/plugins/builtin/help/shortcut-table.tsx +19 -7
  362. package/src/plugins/builtin/help/table-cells.tsx +51 -0
  363. package/src/plugins/builtin/holders/pane.tsx +4 -1
  364. package/src/plugins/builtin/insider/base-values.ts +2 -2
  365. package/src/plugins/builtin/insider/display.ts +2 -1
  366. package/src/plugins/builtin/insider/headless.ts +16 -16
  367. package/src/plugins/builtin/insider/insider-data.ts +2 -1
  368. package/src/plugins/builtin/insider/signals-model.ts +3 -3
  369. package/src/plugins/builtin/insider/table-model.ts +27 -13
  370. package/src/plugins/builtin/insider/table.tsx +11 -8
  371. package/src/plugins/builtin/insider/tickers.tsx +1 -1
  372. package/src/plugins/builtin/ipo-calendar/model.ts +4 -4
  373. package/src/plugins/builtin/iv-history/format.ts +8 -7
  374. package/src/plugins/builtin/iv-history/headless.ts +18 -16
  375. package/src/plugins/builtin/iv-history/pane.tsx +3 -2
  376. package/src/plugins/builtin/iv-history/screen-pane.tsx +5 -4
  377. package/src/plugins/builtin/jobs/headless.ts +11 -11
  378. package/src/plugins/builtin/jobs/index.tsx +1 -0
  379. package/src/plugins/builtin/jobs/model.ts +2 -2
  380. package/src/plugins/builtin/jobs/pane.tsx +5 -5
  381. package/src/plugins/builtin/jodi/model.ts +2 -2
  382. package/src/plugins/builtin/jodi/pane.tsx +2 -1
  383. package/src/plugins/builtin/kelly-sizer/headless.ts +4 -4
  384. package/src/plugins/builtin/kelly-sizer/model.ts +2 -1
  385. package/src/plugins/builtin/kelly-sizer/sections.tsx +2 -2
  386. package/src/plugins/builtin/macro-day/headless.ts +9 -8
  387. package/src/plugins/builtin/macro-day/model.ts +3 -2
  388. package/src/plugins/builtin/macro-day/pane.tsx +4 -4
  389. package/src/plugins/builtin/macro-day/releases.ts +25 -16
  390. package/src/plugins/builtin/market-halts/model.ts +11 -10
  391. package/src/plugins/builtin/market-halts/pane.tsx +2 -1
  392. package/src/plugins/builtin/market-heatmap/index.tsx +4 -4
  393. package/src/plugins/builtin/market-movers/index.tsx +20 -8
  394. package/src/plugins/builtin/market-movers/model.ts +5 -0
  395. package/src/plugins/builtin/market-movers/session-body.tsx +2 -1
  396. package/src/plugins/builtin/market-movers/session-table.ts +3 -3
  397. package/src/plugins/builtin/market-movers/session.ts +2 -1
  398. package/src/plugins/builtin/market-movers/table.ts +5 -5
  399. package/src/plugins/builtin/market-valuation/detail.tsx +2 -2
  400. package/src/plugins/builtin/market-valuation/headless.ts +7 -7
  401. package/src/plugins/builtin/market-valuation/pane.tsx +7 -7
  402. package/src/plugins/builtin/members/breadth-pane.tsx +5 -4
  403. package/src/plugins/builtin/members/headless.ts +2 -1
  404. package/src/plugins/builtin/members/model.ts +3 -2
  405. package/src/plugins/builtin/members/pane.tsx +10 -9
  406. package/src/plugins/builtin/mna/distress/model.ts +2 -1
  407. package/src/plugins/builtin/mna/model.ts +5 -5
  408. package/src/plugins/builtin/money-markets/headless.ts +14 -3
  409. package/src/plugins/builtin/money-markets/model.ts +3 -2
  410. package/src/plugins/builtin/money-markets/pane.tsx +14 -5
  411. package/src/plugins/builtin/news/headless.ts +5 -2
  412. package/src/plugins/builtin/news/wire/breaking/notifications.ts +21 -19
  413. package/src/plugins/builtin/news/wire/news/row.ts +3 -1
  414. package/src/plugins/builtin/news/wire/news/table.tsx +3 -2
  415. package/src/plugins/builtin/news/wire/persisted-articles.ts +28 -3
  416. package/src/plugins/builtin/notes/headless.ts +2 -1
  417. package/src/plugins/builtin/notes/model.ts +2 -1
  418. package/src/plugins/builtin/openfda/pane.tsx +4 -3
  419. package/src/plugins/builtin/options/carry.ts +3 -2
  420. package/src/plugins/builtin/options/market-reference.ts +2 -1
  421. package/src/plugins/builtin/options/table.ts +48 -9
  422. package/src/plugins/builtin/options/view.tsx +48 -17
  423. package/src/plugins/builtin/options-calculator/headless.ts +3 -2
  424. package/src/plugins/builtin/options-calculator/pane.tsx +7 -7
  425. package/src/plugins/builtin/options-positioning/headless.ts +8 -7
  426. package/src/plugins/builtin/options-positioning/model.ts +10 -10
  427. package/src/plugins/builtin/options-positioning/pane.tsx +6 -6
  428. package/src/plugins/builtin/options-scenario/collar.ts +5 -4
  429. package/src/plugins/builtin/options-scenario/csp-screen-headless.ts +11 -10
  430. package/src/plugins/builtin/options-scenario/csp-screen-pane.tsx +15 -14
  431. package/src/plugins/builtin/options-scenario/csp-screen.ts +2 -1
  432. package/src/plugins/builtin/options-scenario/csp.ts +6 -5
  433. package/src/plugins/builtin/options-scenario/headless.ts +6 -5
  434. package/src/plugins/builtin/options-scenario/hedge.ts +3 -3
  435. package/src/plugins/builtin/options-scenario/pane.tsx +7 -6
  436. package/src/plugins/builtin/options-scenario/strategy-screen.ts +1 -1
  437. package/src/plugins/builtin/pe-band/headless.ts +9 -8
  438. package/src/plugins/builtin/pe-band/pane.tsx +7 -7
  439. package/src/plugins/builtin/perps/cascade.ts +3 -2
  440. package/src/plugins/builtin/perps/headless.ts +10 -9
  441. package/src/plugins/builtin/perps/model.ts +14 -14
  442. package/src/plugins/builtin/perps/pane.tsx +3 -2
  443. package/src/plugins/builtin/portfolio-list/cli/bulk-symbols.ts +4 -31
  444. package/src/plugins/builtin/portfolio-list/header.tsx +2 -2
  445. package/src/plugins/builtin/portfolio-list/index.tsx +3 -2
  446. package/src/plugins/builtin/portfolio-list/pane/futures-terms.ts +4 -2
  447. package/src/plugins/builtin/portfolio-list/pane/index.tsx +6 -1
  448. package/src/plugins/builtin/portfolio-list/pane/period-pnl.ts +2 -1
  449. package/src/plugins/builtin/portfolio-list/pane/purchase-date-fx.ts +4 -2
  450. package/src/plugins/builtin/portfolio-list/quick-add/index.tsx +24 -10
  451. package/src/plugins/builtin/portfolio-list/settings.ts +4 -1
  452. package/src/plugins/builtin/portfolio-list/summary/index.tsx +9 -11
  453. package/src/plugins/builtin/portfolio-list/table.tsx +10 -1
  454. package/src/plugins/builtin/power/detail.tsx +6 -5
  455. package/src/plugins/builtin/power/gas-model.ts +8 -7
  456. package/src/plugins/builtin/power/gas.tsx +2 -1
  457. package/src/plugins/builtin/power/headless.ts +7 -6
  458. package/src/plugins/builtin/power/model.ts +3 -2
  459. package/src/plugins/builtin/power/prices-headless.ts +10 -9
  460. package/src/plugins/builtin/power/prices-model.ts +3 -2
  461. package/src/plugins/builtin/power/prices.tsx +2 -1
  462. package/src/plugins/builtin/primary-dealers/model.ts +3 -3
  463. package/src/plugins/builtin/primary-dealers/pane.tsx +2 -2
  464. package/src/plugins/builtin/rate-path/headless.ts +8 -7
  465. package/src/plugins/builtin/rate-path/model.ts +6 -5
  466. package/src/plugins/builtin/rate-path/pane.tsx +6 -5
  467. package/src/plugins/builtin/realized-vol/fx-proxy.ts +2 -1
  468. package/src/plugins/builtin/realized-vol/headless.ts +37 -10
  469. package/src/plugins/builtin/realized-vol/pane.tsx +5 -4
  470. package/src/plugins/builtin/relative-rotation/headless.ts +2 -1
  471. package/src/plugins/builtin/relative-rotation/pane.tsx +6 -6
  472. package/src/plugins/builtin/research/analyst-headless.ts +5 -5
  473. package/src/plugins/builtin/research/analyst-model.ts +7 -7
  474. package/src/plugins/builtin/research/analyst-pane.tsx +7 -7
  475. package/src/plugins/builtin/research/client.ts +14 -0
  476. package/src/plugins/builtin/research/corporate-actions-pane.tsx +40 -30
  477. package/src/plugins/builtin/research/event-model.ts +55 -22
  478. package/src/plugins/builtin/research/event-sources.ts +26 -8
  479. package/src/plugins/builtin/research/relative-valuation-columns.ts +20 -12
  480. package/src/plugins/builtin/research/relative-valuation-currency.ts +16 -0
  481. package/src/plugins/builtin/research/relative-valuation-headless.ts +33 -21
  482. package/src/plugins/builtin/research/relative-valuation-model.ts +31 -17
  483. package/src/plugins/builtin/research/relative-valuation-pane.tsx +29 -14
  484. package/src/plugins/builtin/research-search/model.ts +2 -1
  485. package/src/plugins/builtin/research-search/saved-view.tsx +4 -3
  486. package/src/plugins/builtin/revenue-breakdown/model.ts +4 -4
  487. package/src/plugins/builtin/reverse-dcf/headless.ts +7 -7
  488. package/src/plugins/builtin/reverse-dcf/model.ts +4 -4
  489. package/src/plugins/builtin/reverse-dcf/pane.tsx +2 -2
  490. package/src/plugins/builtin/risk-factors/index.tsx +1 -0
  491. package/src/plugins/builtin/scanner/flow-model.ts +7 -4
  492. package/src/plugins/builtin/scanner/flow-pane.tsx +1 -1
  493. package/src/plugins/builtin/scanner/headless.ts +3 -2
  494. package/src/plugins/builtin/scanner/hilo-model.ts +2 -1
  495. package/src/plugins/builtin/scanner/live-headless.ts +2 -2
  496. package/src/plugins/builtin/scanner/live-model.ts +3 -2
  497. package/src/plugins/builtin/scanner/live-pane.tsx +5 -5
  498. package/src/plugins/builtin/seasonality/headless.ts +2 -1
  499. package/src/plugins/builtin/seasonality/pane.tsx +4 -3
  500. package/src/plugins/builtin/sec/filing-display.tsx +12 -15
  501. package/src/plugins/builtin/sec/fund-facts.ts +2 -2
  502. package/src/plugins/builtin/sec/headless.ts +2 -1
  503. package/src/plugins/builtin/sec/index.tsx +6 -2
  504. package/src/plugins/builtin/sectors/headless.ts +4 -4
  505. package/src/plugins/builtin/sectors/index.tsx +7 -7
  506. package/src/plugins/builtin/shared/earnings-calendar.ts +90 -6
  507. package/src/plugins/builtin/shared/earnings-report.ts +13 -6
  508. package/src/plugins/builtin/shared/research-cells.tsx +2 -2
  509. package/src/plugins/builtin/shared/source-footer.ts +71 -0
  510. package/src/plugins/builtin/shared/trend.ts +2 -2
  511. package/src/plugins/builtin/shared/use-quote-board.ts +9 -8
  512. package/src/plugins/builtin/short-interest/headless.ts +6 -6
  513. package/src/plugins/builtin/short-interest/model.ts +9 -9
  514. package/src/plugins/builtin/short-interest/publications-model.ts +5 -5
  515. package/src/plugins/builtin/short-interest/publications-pane.tsx +8 -3
  516. package/src/plugins/builtin/short-interest/watch-headless.ts +5 -5
  517. package/src/plugins/builtin/short-interest/watch-pane.tsx +6 -6
  518. package/src/plugins/builtin/short-volume/model.ts +5 -5
  519. package/src/plugins/builtin/short-volume/pane.tsx +9 -5
  520. package/src/plugins/builtin/social-mentions/headless.ts +2 -1
  521. package/src/plugins/builtin/social-mentions/model.ts +4 -4
  522. package/src/plugins/builtin/social-mentions/outliers.tsx +10 -1
  523. package/src/plugins/builtin/social-mentions/pane.tsx +7 -0
  524. package/src/plugins/builtin/supply-chain/client.ts +3 -1
  525. package/src/plugins/builtin/supply-chain/flow.tsx +25 -8
  526. package/src/plugins/builtin/supply-chain/graph-client.ts +1 -1
  527. package/src/plugins/builtin/supply-chain/graph-evidence.ts +1 -1
  528. package/src/plugins/builtin/supply-chain/graph-model.ts +14 -2
  529. package/src/plugins/builtin/supply-chain/graph-pane.tsx +11 -10
  530. package/src/plugins/builtin/supply-chain/graph.tsx +12 -6
  531. package/src/plugins/builtin/supply-chain/headless.ts +15 -8
  532. package/src/plugins/builtin/supply-chain/model.ts +72 -15
  533. package/src/plugins/builtin/supply-chain/pane.tsx +11 -8
  534. package/src/plugins/builtin/supply-chain/row-evidence.tsx +7 -6
  535. package/src/plugins/builtin/themes/headless.ts +2 -1
  536. package/src/plugins/builtin/themes/model.ts +3 -2
  537. package/src/plugins/builtin/themes/pane.tsx +3 -2
  538. package/src/plugins/builtin/thirteenf/format.ts +9 -9
  539. package/src/plugins/builtin/thirteenf/headless.ts +3 -2
  540. package/src/plugins/builtin/thirteenf/model.ts +2 -1
  541. package/src/plugins/builtin/thirteenf/overlap-pane.tsx +2 -1
  542. package/src/plugins/builtin/thirteenf/pane.tsx +5 -4
  543. package/src/plugins/builtin/thirteenf/report-notes.ts +2 -1
  544. package/src/plugins/builtin/thirteenf/signals-pane.tsx +3 -2
  545. package/src/plugins/builtin/thirteenf/table.ts +6 -5
  546. package/src/plugins/builtin/ticker-detail/adr-pair/model.ts +4 -3
  547. package/src/plugins/builtin/ticker-detail/data-panes/historical-prices.tsx +4 -4
  548. package/src/plugins/builtin/ticker-detail/data-panes/returns-pane.tsx +3 -3
  549. package/src/plugins/builtin/ticker-detail/financials/model.ts +83 -35
  550. package/src/plugins/builtin/ticker-detail/financials/ratio-table.tsx +3 -1
  551. package/src/plugins/builtin/ticker-detail/financials/ratios.ts +2 -2
  552. package/src/plugins/builtin/ticker-detail/financials/schema.ts +14 -18
  553. package/src/plugins/builtin/ticker-detail/financials/tab.tsx +8 -13
  554. package/src/plugins/builtin/ticker-detail/headless.ts +7 -5
  555. package/src/plugins/builtin/ticker-detail/overview/chart-scale.ts +52 -0
  556. package/src/plugins/builtin/ticker-detail/overview/components.tsx +18 -5
  557. package/src/plugins/builtin/ticker-detail/overview/model.ts +24 -13
  558. package/src/plugins/builtin/ticker-detail/overview/pane.tsx +6 -0
  559. package/src/plugins/builtin/ticker-detail/overview/tax-equivalent.ts +2 -1
  560. package/src/plugins/builtin/ticker-detail/overview-tab.tsx +35 -7
  561. package/src/plugins/builtin/ticker-detail/pane.tsx +48 -24
  562. package/src/plugins/builtin/ticker-detail/quote-footer.ts +5 -0
  563. package/src/plugins/builtin/ticker-detail/quote-monitor/card.tsx +13 -8
  564. package/src/plugins/builtin/ticker-detail/quote-monitor/rows.ts +4 -4
  565. package/src/plugins/builtin/ticker-detail/settings.ts +17 -0
  566. package/src/plugins/builtin/time-sales/headless.ts +3 -2
  567. package/src/plugins/builtin/time-sales/model.ts +7 -5
  568. package/src/plugins/builtin/time-sales/pane.tsx +7 -6
  569. package/src/plugins/builtin/trace-bonds/model.ts +3 -2
  570. package/src/plugins/builtin/trace-bonds/pane.tsx +3 -2
  571. package/src/plugins/builtin/treasury-auctions/after.ts +50 -23
  572. package/src/plugins/builtin/treasury-auctions/cache.ts +23 -5
  573. package/src/plugins/builtin/treasury-auctions/client.ts +2 -1
  574. package/src/plugins/builtin/treasury-auctions/headless.ts +231 -42
  575. package/src/plugins/builtin/treasury-auctions/hk-headless.ts +14 -7
  576. package/src/plugins/builtin/treasury-auctions/hk-view.tsx +37 -34
  577. package/src/plugins/builtin/treasury-auctions/hk.ts +65 -13
  578. package/src/plugins/builtin/treasury-auctions/index.tsx +3 -0
  579. package/src/plugins/builtin/treasury-auctions/keys.ts +27 -0
  580. package/src/plugins/builtin/treasury-auctions/like.ts +137 -0
  581. package/src/plugins/builtin/treasury-auctions/model.ts +101 -23
  582. package/src/plugins/builtin/treasury-auctions/pane.tsx +56 -28
  583. package/src/plugins/builtin/treasury-auctions/treasury-direct.ts +2 -1
  584. package/src/plugins/builtin/treasury-daily/model.ts +2 -2
  585. package/src/plugins/builtin/vol-surface/events.ts +5 -4
  586. package/src/plugins/builtin/vol-surface/headless.ts +19 -18
  587. package/src/plugins/builtin/vol-surface/heat-grid.tsx +6 -3
  588. package/src/plugins/builtin/vol-surface/pane.tsx +13 -9
  589. package/src/plugins/builtin/vol-surface/stored.ts +2 -1
  590. package/src/plugins/builtin/vol-surface/tables.ts +4 -3
  591. package/src/plugins/builtin/volatility/headless.ts +5 -4
  592. package/src/plugins/builtin/volatility/pane.tsx +6 -6
  593. package/src/plugins/builtin/world-indices/headless.ts +7 -7
  594. package/src/plugins/builtin/world-indices/index.tsx +3 -1
  595. package/src/plugins/builtin/world-venue-map/headless.ts +2 -1
  596. package/src/plugins/builtin/world-venue-map/layered-pane.tsx +2 -1
  597. package/src/plugins/builtin/world-venue-map/layers.ts +3 -2
  598. package/src/plugins/builtin/world-venue-map/use-geo.ts +4 -2
  599. package/src/plugins/builtin/yield-curve/curves.ts +3 -3
  600. package/src/plugins/builtin/yield-curve/headless.ts +7 -6
  601. package/src/plugins/builtin/yield-curve/index.tsx +5 -4
  602. package/src/plugins/builtin/yield-curve/swaps.tsx +2 -1
  603. package/src/plugins/runtime/index.tsx +1 -0
  604. package/src/plugins/runtime/state.ts +20 -0
  605. package/src/portfolio/allocation.ts +5 -5
  606. package/src/portfolio/column-values.ts +54 -42
  607. package/src/portfolio/futures-positions.ts +2 -1
  608. package/src/public/__snapshots__/public-api.test.ts.snap +5 -0
  609. package/src/public/react.ts +7 -0
  610. package/src/react/auto-refresh.ts +29 -0
  611. package/src/renderers/browser/deeplink-bridge.ts +24 -3
  612. package/src/renderers/dom/desktop/query-bar.tsx +229 -60
  613. package/src/renderers/dom/host/overflow-fade-px.ts +2 -0
  614. package/src/renderers/dom/host/overflow-fade.ts +1 -2
  615. package/src/renderers/dom/styles.css +25 -5
  616. package/src/renderers/electrobun/bun/desktop/backend-requests.ts +7 -1
  617. package/src/renderers/electrobun/view/cli-pane-shot-entry.tsx +2 -1
  618. package/src/renderers/opentui/ui-host.tsx +32 -2
  619. package/src/renderers/share/layout-view.tsx +2 -1
  620. package/src/series/types.ts +2 -0
  621. package/src/sources/gloomberb-cloud/fred-attribution.ts +86 -0
  622. package/src/sources/gloomberb-cloud/index.ts +25 -1
  623. package/src/sources/gloomberb-cloud/news.ts +9 -0
  624. package/src/sources/gloomberb-cloud/normalizers.ts +24 -3
  625. package/src/sources/provider-errors.ts +64 -1
  626. package/src/sources/provider-router/batches.ts +19 -0
  627. package/src/sources/provider-router/index.ts +7 -1
  628. package/src/sources/provider-router/search.ts +15 -10
  629. package/src/state/app/context/index.tsx +24 -1
  630. package/src/state/hooks/inline-tickers.ts +3 -2
  631. package/src/state/hooks/quote-streaming.ts +9 -10
  632. package/src/state/pane-unsent-work.ts +47 -0
  633. package/src/team/collections-sync.ts +8 -3
  634. package/src/telemetry/usage-counts.ts +26 -0
  635. package/src/test-support/shell-pane-keys.tsx +5 -0
  636. package/src/test-support/telemetry-guard.ts +83 -0
  637. package/src/test-support/test-env.ts +12 -0
  638. package/src/theme/colors.ts +17 -1
  639. package/src/theme/ui-tokens.ts +50 -1
  640. package/src/tickers/company-name-listing.ts +2 -2
  641. package/src/tickers/company-name.ts +17 -1
  642. package/src/tickers/listing-venues.ts +37 -2
  643. package/src/tickers/renamed-listings.ts +2 -1
  644. package/src/tickers/search/index.ts +19 -0
  645. package/src/tickers/search/japanese-names.json +1 -0
  646. package/src/tickers/search/japanese-names.ts +152 -0
  647. package/src/tickers/starter-symbols.ts +7 -0
  648. package/src/tickers/terminal-codes.ts +55 -6
  649. package/src/time-series/base-series.ts +3 -0
  650. package/src/time-series/fundamentals/statement-fields.ts +11 -14
  651. package/src/time-series/history-acquisition.ts +1 -1
  652. package/src/time-series/log-scale.ts +9 -0
  653. package/src/time-series/reporting.ts +3 -3
  654. package/src/time-series/resolve.ts +6 -4
  655. package/src/time-series/transforms.ts +10 -5
  656. package/src/types/config.ts +9 -0
  657. package/src/types/data-provider.ts +9 -2
  658. package/src/types/financials.ts +26 -0
  659. package/src/types/instrument.ts +6 -0
  660. package/src/types/plugin-contributions.ts +7 -0
  661. package/src/types/plugin-panes.ts +8 -1
  662. package/src/types/plugin-reports.ts +8 -0
  663. package/src/ui/host.tsx +6 -0
  664. package/src/utils/datetime-format.ts +74 -33
  665. package/src/utils/double-escape-close.ts +42 -0
  666. package/src/utils/financial-statements.ts +39 -15
  667. package/src/utils/format.ts +4 -9
  668. package/src/utils/fundamentals.ts +38 -16
  669. package/src/utils/fx-status.ts +30 -7
  670. package/src/utils/growth.ts +67 -0
  671. package/src/utils/keyboard.ts +6 -0
  672. package/src/utils/network-failure.ts +23 -0
  673. package/src/utils/options.ts +1 -1
  674. package/src/utils/report-timing.ts +2 -2
  675. package/src/utils/served-rates.ts +45 -0
  676. package/src/utils/text-wrap.ts +84 -3
  677. package/src/utils/zoned-date-time.ts +47 -22
@@ -660,7 +660,7 @@ export function useFxRateObservations(currencies: Array<string | null | undefine
660
660
  if (!coordinator) return;
661
661
  for (const currency of normalizedCurrencies) {
662
662
  if (currency === "USD") continue;
663
- void coordinator.loadFxRate(currency);
663
+ void coordinator.loadFxRate(currency).catch(logFailure("market-data.hooks", "Loading an exchange rate failed"));
664
664
  }
665
665
  }, [normalizedCurrencyKey]);
666
666
 
@@ -140,21 +140,43 @@ function isCboeYieldIndex(quote: Quote): boolean {
140
140
  * its published calendar has a session that day and the print came after it
141
141
  * opened. The S&P 500's closing print at 16:37 New York on Fri 6 Nov 2026 is
142
142
  * Friday's, so its move is from Thursday's close. A print before the day's
143
- * open, on a day the calendar has no session for, or on a venue with no
144
- * published calendar, names none; nor does a Cboe index's, whose days are
145
- * Cboe's own (a yield index skips the bond market's holidays).
143
+ * open, or on a day the calendar has no session for, names none. An index
144
+ * on a venue with no published calendar, or on Cboe's, whose days are Cboe's
145
+ * own, is dated by its own sessions (`ownIndexSession`); a Cboe yield index,
146
+ * which skips the bond market's holidays, by none.
146
147
  */
147
148
  function indexPrintSession(quote: Quote): string | null {
148
149
  const venue = calendarVenue(quote);
149
- if (venue === "CBOE") return null;
150
+ // A Cboe index's days are Cboe's own: one with its own sessions (the Russell 2000, quoted under CHICAGO OPTIONS) is
151
+ // dated by them; a yield index, which skips the bond market's holidays, is not dated here.
152
+ if (venue === "CBOE") {
153
+ const zone = isCboeYieldIndex(quote) ? null : quote.indexSession?.timeZone;
154
+ const date = zone ? zonedDateKey(quote.lastUpdated, zone) : null;
155
+ return date ? ownIndexSession(quote, date) : null;
156
+ }
150
157
  const zone = sessionCalendarTimeZone(venue) ?? quote.indexSession?.timeZone;
151
158
  if (!zone) return null;
152
159
  const date = zonedDateKey(quote.lastUpdated, zone);
153
- if (!date || !hasPublishedSessionCalendar(venue, date) || !isVenueTradingDay(venue, date)) return null;
160
+ if (!date) return null;
161
+ if (!hasPublishedSessionCalendar(venue, date)) return ownIndexSession(quote, date);
162
+ if (!isVenueTradingDay(venue, date)) return null;
154
163
  const open = latestRegularSessionOpen(venue, quote.lastUpdated);
155
164
  return open != null && zonedDateKey(open, zone) === date ? date : null;
156
165
  }
157
166
 
167
+ /**
168
+ * For an index whose venue publishes no calendar (the Euro Stoxx 50 and the
169
+ * FTSE 100, quoted under their publishers' ZURICH and FTSE INDEX), the
170
+ * session of the index's own calendar (indexSession) its print sits in: one
171
+ * that opened on `date`, at or before the print. Null when none did.
172
+ */
173
+ function ownIndexSession(quote: Quote, date: string): string | null {
174
+ const session = quote.indexSession;
175
+ if (!session?.timeZone) return null;
176
+ const windows = [...session.regular, ...(session.current ? [session.current] : [])];
177
+ return windows.some((window) => window.start <= quote.lastUpdated && zonedDateKey(window.start, session.timeZone) === date) ? date : null;
178
+ }
179
+
158
180
  /** A coin on the spot crypto venue: its day is the UTC day. */
159
181
  function isSpotCoin(quote: Quote): boolean {
160
182
  return quoteVenue(quote) === "CCC";
@@ -2,7 +2,7 @@ import type { PriceBasis } from "../../types/instrument";
2
2
  import type { Quote } from "../../types/financials";
3
3
  import { resolvePriceBasis } from "./price-basis";
4
4
  import { isIndexLevel } from "./index-level";
5
- import { currencyPriceDigits, formatCompact, formatCurrency, formatCurrencyCode } from "../../utils/format";
5
+ import { MISSING_VALUE, currencyPriceDigits, formatCompact, formatCurrency, formatCurrencyCode } from "../../utils/format";
6
6
  import { BIDI_MARKS, isDrawableCurrencySign, minorUnitSign } from "../../utils/currency-units";
7
7
  import { fxRateDigits } from "../../utils/currency-pair";
8
8
 
@@ -283,7 +283,7 @@ export function formatPriceObservation(
283
283
  value: number,
284
284
  options: Pick<MarketFormatOptions, "maxWidth" | "minimumFractionDigits"> = {},
285
285
  ): string {
286
- if (!Number.isFinite(value)) return "—";
286
+ if (!Number.isFinite(value)) return MISSING_VALUE;
287
287
  return formatPriceNumber(value, 8, options.maxWidth, Math.max(0, Math.min(8, options.minimumFractionDigits ?? 0)));
288
288
  }
289
289
 
@@ -362,7 +362,7 @@ export function resolveAssetDisplayKind({
362
362
  }
363
363
 
364
364
  export function formatMarketQuantity(value: number | undefined, options: MarketFormatOptions = {}): string {
365
- if (value === undefined || value === null || Number.isNaN(value)) return "—";
365
+ if (value === undefined || value === null || Number.isNaN(value)) return MISSING_VALUE;
366
366
  if (options.priceBasis === "percent-of-par") {
367
367
  const suffix = `${options.quantityCurrency ? ` ${options.quantityCurrency}` : ""} face`;
368
368
  const maxWidth = options.maxWidth == null ? undefined : Math.max(1, options.maxWidth - suffix.length);
@@ -403,9 +403,9 @@ function tickFractionDigits(tick: number | undefined): number | undefined {
403
403
  }
404
404
 
405
405
  export function formatMarketPrice(value: number | undefined, options: MarketFormatOptions = {}): string {
406
- if (value === undefined || value === null || Number.isNaN(value)) return "—";
406
+ if (value === undefined || value === null || Number.isNaN(value)) return MISSING_VALUE;
407
407
  const basis = resolvePriceBasis(options.priceBasis, options.assetCategory);
408
- if (basis === null) return "—";
408
+ if (basis === null) return MISSING_VALUE;
409
409
  if (basis === "thirty-seconds") return formatThirtySeconds(value);
410
410
  if (basis === "points") return formatMarketPrice(value, { ...options, priceBasis: "per-unit" });
411
411
  if (basis === "percent-of-par") {
@@ -453,9 +453,9 @@ export function formatMarketPrice(value: number | undefined, options: MarketForm
453
453
  }
454
454
 
455
455
  export function formatMarketCost(value: number | undefined, options: MarketFormatOptions = {}): string {
456
- if (value === undefined || value === null || Number.isNaN(value)) return "—";
456
+ if (value === undefined || value === null || Number.isNaN(value)) return MISSING_VALUE;
457
457
  const basis = resolvePriceBasis(options.priceBasis, options.assetCategory);
458
- if (basis === null) return "—";
458
+ if (basis === null) return MISSING_VALUE;
459
459
  if (basis === "thirty-seconds") return formatThirtySeconds(value);
460
460
  if (basis === "points") return formatMarketCost(value, { ...options, priceBasis: "per-unit" });
461
461
  if (basis === "percent-of-par") {
@@ -469,8 +469,8 @@ export function formatMarketCost(value: number | undefined, options: MarketForma
469
469
  }
470
470
 
471
471
  export function formatSignedMarketPrice(value: number | undefined, options: MarketFormatOptions = {}): string {
472
- if (value === undefined || value === null || Number.isNaN(value)) return "—";
473
- if (resolvePriceBasis(options.priceBasis, options.assetCategory) === null) return "—";
472
+ if (value === undefined || value === null || Number.isNaN(value)) return MISSING_VALUE;
473
+ if (resolvePriceBasis(options.priceBasis, options.assetCategory) === null) return MISSING_VALUE;
474
474
  if (options.fixedFractionDigits !== undefined) {
475
475
  // A move at the instrument's fixed decimals: the sign always has its column,
476
476
  // and a move that rounds to zero is unsigned (0.00, never +0.00 or -0.00).
@@ -495,7 +495,7 @@ export function formatMarketChangeWithCurrency(
495
495
  options: MarketFormatOptions = {},
496
496
  referencePrice?: number,
497
497
  ): string {
498
- if (value == null || !Number.isFinite(value)) return "—";
498
+ if (value == null || !Number.isFinite(value)) return MISSING_VALUE;
499
499
  if (isIndexLevel(options.assetCategory) || resolvePriceBasis(options.priceBasis, options.assetCategory) !== "per-unit") return formatSignedMarketPrice(value, options);
500
500
  if (options.fixedFractionDigits !== undefined) {
501
501
  const maxWidth = options.maxWidth == null ? undefined : Math.max(1, options.maxWidth - 1);
@@ -739,7 +739,7 @@ export function formatMarketPriceWithCurrency(
739
739
  currency = "USD",
740
740
  options: MarketFormatOptions = {},
741
741
  ): string {
742
- if (value === undefined || value === null || Number.isNaN(value)) return "—";
742
+ if (value === undefined || value === null || Number.isNaN(value)) return MISSING_VALUE;
743
743
  if (isIndexLevel(options.assetCategory) || resolvePriceBasis(options.priceBasis, options.assetCategory) !== "per-unit") return formatMarketPrice(value, options);
744
744
  const normalizedCurrency = currency.trim().toUpperCase() || "USD";
745
745
  const sign = value < 0 ? "-" : "";
@@ -756,7 +756,7 @@ export function formatMarketCostWithCurrency(
756
756
  currency = "USD",
757
757
  options: MarketFormatOptions = {},
758
758
  ): string {
759
- if (value === undefined || value === null || Number.isNaN(value)) return "—";
759
+ if (value === undefined || value === null || Number.isNaN(value)) return MISSING_VALUE;
760
760
  if (resolvePriceBasis(options.priceBasis, options.assetCategory) !== "per-unit") return formatMarketCost(value, options);
761
761
  const normalizedCurrency = currency.trim().toUpperCase() || "USD";
762
762
  const sign = value < 0 ? "-" : "";
@@ -780,7 +780,7 @@ export function formatCompactMarketPriceWithCurrency(
780
780
  currency = "USD",
781
781
  options: MarketFormatOptions = {},
782
782
  ): string {
783
- if (value === undefined || value === null || Number.isNaN(value)) return "—";
783
+ if (value === undefined || value === null || Number.isNaN(value)) return MISSING_VALUE;
784
784
  const abs = Math.abs(value);
785
785
 
786
786
  if (abs >= 1e6) {
@@ -128,6 +128,39 @@ const REGULAR_CLOSE_MINUTES: Record<string, number> = {
128
128
  // Borsa Istanbul: continuous trading to 18:00, then the closing auction and trading at the close to 18:10.
129
129
  BIST: 18 * 60 + 10,
130
130
  };
131
+ // How long before its calendar's close (REGULAR_CLOSE_MINUTES, rounded up and
132
+ // running through any trading at the close, or the after-hours session the
133
+ // calendar keeps) a venue's closing price is set: the end of its closing
134
+ // auction, or of regular trading where the calendar runs on (TWSE's close is
135
+ // 13:30, its calendar 14:30 for after-hours fixed-price trading). A venue not
136
+ // listed sets its close at the calendar's. Rounded early, never late: a print
137
+ // is only called the close from this time on (closingPriceTime).
138
+ const CLOSING_PRICE_LEAD_MINUTES: Record<string, number> = {
139
+ // The closing auctions: Xetra, Vienna, Euronext and London to 17:35 (16:35), SIX and Milan to 17:30 and 17:35,
140
+ // Nasdaq Stockholm and Helsinki to 17:30 and 18:30, Copenhagen to 17:00, Oslo to 16:25, Iceland to 15:35, Warsaw to 17:00.
141
+ XETRA: 5, VIE: 5, EPA: 5, AMS: 5, BRU: 5, LIS: 5, LSE: 5, SWX: 10, BIT: 10,
142
+ SFB: 10, HEL: 10, CPH: 10, OSL: 5, ICEX: 5, WSE: 10, PSE: 5,
143
+ // Hong Kong's auction ends at random from 16:08, Sydney's from 16:10, Singapore's at 17:06, Wellington's by 16:50.
144
+ HKEX: 2, ASX: 5, SGX: 15, NZX: 10,
145
+ // Regular trading ends 13:30 in Taipei, 15:30 in Mumbai and Seoul and 15:00 in Shanghai and Shenzhen;
146
+ // the calendars run on through after-hours or closing-price sessions.
147
+ TWSE: 60, TPEX: 60, NSE: 30, BSE: 30, KRX: 30, KOSDAQ: 30, SSE: 30, SZSE: 30,
148
+ // Mexico, Buenos Aires and Johannesburg close at 15:00, 17:00 and 17:00; B3's close is 17:00 or 18:00 with New
149
+ // York's clocks, and the earlier is taken.
150
+ BMV: 10, BYMA: 10, JSE: 15, B3: 90,
151
+ // The Gulf and Tel Aviv: the closing auction's end, before trading at last.
152
+ TASE: 6, TADAWUL: 10, QE: 5, DFM: 5, MSX: 5, BIST: 5,
153
+ };
154
+
155
+ /**
156
+ * When a venue's closing price was set for the session its calendar closes at
157
+ * `close` (latestRegularSessionClose's): the closing auction's end or the end
158
+ * of regular trading, before any trading at the close or after-hours session
159
+ * the calendar runs through (CLOSING_PRICE_LEAD_MINUTES).
160
+ */
161
+ export function closingPriceTime(exchange: string | undefined, close: number): number {
162
+ return close - (CLOSING_PRICE_LEAD_MINUTES[canonicalExchange(exchange)] ?? 0) * 60_000;
163
+ }
131
164
  // Venues whose week is not Monday to Friday, as their days off (0 is Sunday).
132
165
  // Tadawul, Qatar, Boursa Kuwait and the Egyptian Exchange trade Sunday to
133
166
  // Thursday. Dubai's DFM has traded Monday to Friday since 2022, like the
@@ -74,6 +74,8 @@ const STALE_SESSION_LABEL = "STALE";
74
74
  * one (Quote.nominalPrice).
75
75
  */
76
76
  const NO_TRADES_SESSION_LABEL = "NO TRADES";
77
+ /** What a quote's session reads as when no live quote prices it: the close of its latest daily bar (Quote.dailyClose). */
78
+ const DAILY_CLOSE_SESSION_LABEL = "DAILY CLOSE";
77
79
 
78
80
  const WEEKDAYS = ["Sun", "Mon", "Tue", "Wed", "Thu", "Fri", "Sat"] as const;
79
81
  const MONTHS = ["Jan", "Feb", "Mar", "Apr", "May", "Jun", "Jul", "Aug", "Sep", "Oct", "Nov", "Dec"] as const;
@@ -147,6 +149,7 @@ function quoteMarketState(quote: Quote | null | undefined, now = Date.now()): Ma
147
149
  export function quoteMarketStateLabel(quote: Quote | null | undefined, now = Date.now()): string | null {
148
150
  if (quote?.delisting) return delistingLabel(quote.delisting);
149
151
  if (quote?.nominalPrice) return NO_TRADES_SESSION_LABEL;
152
+ if (quote?.dailyClose) return DAILY_CLOSE_SESSION_LABEL;
150
153
  if (!quote?.marketState) return null;
151
154
  if (isQuoteBeforeLatestSession(quote, now)) return STALE_SESSION_LABEL;
152
155
  const awaiting = preMarketCloseAwaitingPrint(quote);
@@ -254,6 +257,7 @@ export function quoteSessionStateLabel(quote: Quote | null | undefined, now = Da
254
257
  function sessionLabel(quote: Quote | null | undefined, now: number, standingClose: boolean): string | null {
255
258
  if (quote?.delisting) return standingClose ? delistingLabel(quote.delisting) : delistingStateLabel(quote.delisting);
256
259
  if (quote?.nominalPrice) return NO_TRADES_SESSION_LABEL;
260
+ if (quote?.dailyClose) return DAILY_CLOSE_SESSION_LABEL;
257
261
  if (!quote?.marketState) return null;
258
262
  if (isQuoteBeforeLatestSession(quote, now)) return STALE_SESSION_LABEL;
259
263
  if (overnightSessionDisplay(quote)) return "OVERNIGHT";
@@ -268,7 +272,7 @@ function sessionLabel(quote: Quote | null | undefined, now: number, standingClos
268
272
  * pre-market still stands at.
269
273
  */
270
274
  export function quoteSessionColor(quote: Quote | null | undefined, palette: ThemeColors = colors, now = Date.now()): string {
271
- if (quote?.delisting || quote?.nominalPrice) return palette.warning;
275
+ if (quote?.delisting || quote?.nominalPrice || quote?.dailyClose) return palette.warning;
272
276
  if (!quote?.marketState) return palette.textDim;
273
277
  if (isQuoteBeforeLatestSession(quote, now)) return palette.warning;
274
278
  if (overnightSessionDisplay(quote)) return marketStateColor("POST", palette);
@@ -230,6 +230,16 @@ export function mergeQuoteContribution(
230
230
  regularChangePercent: next.regularClose != null ? next.regularChangePercent : undefined,
231
231
  };
232
232
 
233
+ // Where a 52-week range comes from is said of that range: it goes with the range the merge keeps. A tick that
234
+ // relays the same range without saying (a stream's quote built on the served one) keeps the word; one with
235
+ // another range, or a copy saved before the word existed, says its own, or none.
236
+ if (next.high52w !== undefined || next.low52w !== undefined) {
237
+ const relayed = next.yearRangeBasis === undefined && next.high52w === current.high52w && next.low52w === current.low52w;
238
+ const basis = relayed ? current.yearRangeBasis : next.yearRangeBasis;
239
+ if (basis) merged.yearRangeBasis = basis;
240
+ else delete merged.yearRangeBasis;
241
+ }
242
+
233
243
  // What this observation's move is from, when not its previous close (a coin's
234
244
  // 24 hours), is said with each one: a quote back on its
235
245
  // previous close drops an earlier "24h", and one on 24 hours drops the
@@ -224,6 +224,25 @@ export function nominalSessionLabel(quote: Pick<Quote, "nominalPrice"> | null |
224
224
  return day && Number.isFinite(day.getTime()) ? `${day.getUTCDate()} ${PRINT_MONTHS[day.getUTCMonth()]} close` : null;
225
225
  }
226
226
 
227
+ /**
228
+ * What a quote with no live price says beside it (Quote.dailyClose): "no live
229
+ * quote, daily close of Wed 11 Nov". Null for any other quote.
230
+ */
231
+ export function dailyCloseText(quote: Pick<Quote, "dailyClose"> | null | undefined): string | null {
232
+ const session = quote?.dailyClose?.session;
233
+ const day = session ? new Date(`${session}T00:00:00Z`) : null;
234
+ return day && Number.isFinite(day.getTime())
235
+ ? `no live quote, daily close of ${PRINT_WEEKDAYS[day.getUTCDay()]} ${day.getUTCDate()} ${PRINT_MONTHS[day.getUTCMonth()]}`
236
+ : null;
237
+ }
238
+
239
+ /** When a daily close is from, as an Updated cell names it: "11 Nov daily close" (Quote.dailyClose). Null for any other quote. */
240
+ export function dailyCloseSessionLabel(quote: Pick<Quote, "dailyClose"> | null | undefined): string | null {
241
+ const session = quote?.dailyClose?.session;
242
+ const day = session ? new Date(`${session}T00:00:00Z`) : null;
243
+ return day && Number.isFinite(day.getTime()) ? `${day.getUTCDate()} ${PRINT_MONTHS[day.getUTCMonth()]} daily close` : null;
244
+ }
245
+
227
246
  /** A US listing's after-hours session ends four hours past its regular close (17:00 New York after an early close). */
228
247
  const US_AFTER_HOURS_MS = 4 * 60 * 60_000;
229
248
 
@@ -3,7 +3,7 @@ import { cashAndShortTermInvestments } from "../../utils/cash-runway";
3
3
  import { formatShortDate } from "../../utils/datetime-format";
4
4
  import { formatCompact } from "../../utils/format";
5
5
  import {
6
- checkCashBasis, enterpriseValueCheck, enterpriseValueNotMeaningful, enterpriseValueWithdrawn, reportedEnterpriseValue, withBankEnterpriseValue,
6
+ checkCashBasis, enterpriseValueCheck, enterpriseValueNotMeaningful, enterpriseValueWithdrawn, reportedEnterpriseValue, withFinancialEnterpriseValue,
7
7
  } from "../../utils/fundamentals";
8
8
  import { debtAndLeases, leaseBasis } from "../../utils/lease-liabilities";
9
9
  import { viewMarketCapitalization } from "../../utils/market-capitalization";
@@ -91,7 +91,7 @@ export const balanceSheetDay = (date: string) => formatShortDate(`${date.slice(0
91
91
  * meaningful at or below zero and for a bank.
92
92
  */
93
93
  export function listingEnterpriseValue(financials: EnterpriseValueInputs, now = Date.now()): ListingEnterpriseValue {
94
- const priced = atRegularSessionPrice({ quote: financials.quote, fundamentals: withBankEnterpriseValue(financials.fundamentals, financials.profile) });
94
+ const priced = atRegularSessionPrice({ quote: financials.quote, fundamentals: withFinancialEnterpriseValue(financials.fundamentals, financials.profile) });
95
95
  const fundamentals = priced.fundamentals;
96
96
  const notMeaningful = enterpriseValueNotMeaningful(fundamentals);
97
97
  if (notMeaningful) return { kind: "not-meaningful", reason: notMeaningful };
@@ -230,7 +230,7 @@ function statementBridge(
230
230
  export function balanceSheetRateWanted(financials: EnterpriseValueInputs, now = Date.now()): Omit<BalanceSheetRate, "rate" | "closeDate"> | null {
231
231
  const { annualStatements, quarterlyStatements } = financials;
232
232
  if (!annualStatements || !quarterlyStatements) return null;
233
- const priced = atRegularSessionPrice({ quote: financials.quote, fundamentals: withBankEnterpriseValue(financials.fundamentals, financials.profile) });
233
+ const priced = atRegularSessionPrice({ quote: financials.quote, fundamentals: withFinancialEnterpriseValue(financials.fundamentals, financials.profile) });
234
234
  const fundamentals = priced.fundamentals;
235
235
  if (enterpriseValueNotMeaningful(fundamentals) || reportedEnterpriseValue(fundamentals) != null || !enterpriseValueWithdrawn(fundamentals)) return null;
236
236
  const check = enterpriseValueCheck(fundamentals);
@@ -1,5 +1,7 @@
1
1
  import type { AnalystResearchData, CorporateActionsData, Fundamentals, Quote, TickerFinancials } from "../../types/financials";
2
2
  import { atRegularSessionPrice, regularSessionValuationPrice } from "./regular-session-valuation";
3
+ import { isIndexLevel } from "../market/index-level";
4
+ import { isYieldIndexSymbol } from "../../tickers/index-roots";
3
5
  import { hasLikelyQuoteUnitMismatch, resolveCurrencyUnit } from "../../utils/currency-units";
4
6
  import { cashInMajorUnits } from "../../utils/dividend-cash";
5
7
  import { cashDistribution, dividendReferencePrice, trailingDividendYield, type CashDistribution } from "../../utils/trailing-dividend";
@@ -196,6 +198,30 @@ export function liveMarketCapitalization(
196
198
  return { ...stored, value: shares * price, live: true };
197
199
  }
198
200
 
201
+ /** Whether a value is one of the quote's levels: above 0, or any finite yield for a Treasury yield index (^IRX can read 0). */
202
+ function quoteLevel(quote: Quote): (value: number | null | undefined) => value is number {
203
+ return isYieldIndexSymbol(quote.symbol)
204
+ ? (value: number | null | undefined): value is number => value != null && Number.isFinite(value)
205
+ : positive;
206
+ }
207
+
208
+ /**
209
+ * The 52-week range a quote states, when it is one: both bounds above 0 (a
210
+ * Treasury yield index's at any level, 0 and below included), and for an index
211
+ * not its day's range again (a source that repeats the session's low and high
212
+ * as the year's: the EGX 30's 52,691.30 high on a day its bars spanned 39,537
213
+ * to 56,931). A range the service read from the stored daily bars instead
214
+ * (Quote.yearRangeBasis) is one whatever it equals.
215
+ */
216
+ export function statedYearRange(quote: Quote | null | undefined): { low: number; high: number } | null {
217
+ if (!quote) return null;
218
+ const level = quoteLevel(quote);
219
+ if (!level(quote.low52w) || !level(quote.high52w) || quote.high52w < quote.low52w) return null;
220
+ const repeatsDay = quote.low52w === quote.low && quote.high52w === quote.high;
221
+ if (repeatsDay && quote.yearRangeBasis !== "daily-bars" && isIndexLevel(quote.instrumentType)) return null;
222
+ return { low: quote.low52w, high: quote.high52w };
223
+ }
224
+
199
225
  /**
200
226
  * The 52-week extremes with today's session folded in, so a new high or low
201
227
  * reads 100% or 0% instead of pinning against a stale bound. A caller that
@@ -205,10 +231,11 @@ export function liveFiftyTwoWeekRange(
205
231
  quote: Quote | null | undefined,
206
232
  displayedPrice?: number | null,
207
233
  ): { low: number; high: number } | null {
208
- if (!quote || !positive(quote.low52w) || !positive(quote.high52w)) return null;
209
- const session = [quote.price, quote.high, quote.low, displayedPrice].filter(positive);
210
- const low = Math.min(quote.low52w, ...session);
211
- const high = Math.max(quote.high52w, ...session);
234
+ const stated = statedYearRange(quote);
235
+ if (!quote || !stated) return null;
236
+ const session = [quote.price, quote.high, quote.low, displayedPrice].filter(quoteLevel(quote));
237
+ const low = Math.min(stated.low, ...session);
238
+ const high = Math.max(stated.high, ...session);
212
239
  return high > low ? { low, high } : null;
213
240
  }
214
241
 
@@ -510,6 +510,10 @@ export function resolveCanonicalQuote(
510
510
  changeSessionDate: resolved.changeSessionDate as Quote["changeSessionDate"],
511
511
  high52w: resolved.high52w as Quote["high52w"],
512
512
  low52w: resolved.low52w as Quote["low52w"],
513
+ // Said of the range, so it comes with the provider whose range it is.
514
+ yearRangeBasis: contributions.find((quote) => quote.high52w === resolved.high52w && quote.low52w === resolved.low52w)?.yearRangeBasis,
515
+ // Said of the price, so it comes with it.
516
+ dailyClose: priceProvider?.dailyClose,
513
517
  marketCap: resolved.marketCap as Quote["marketCap"],
514
518
  volume: resolved.volume as Quote["volume"],
515
519
  name: resolved.name as Quote["name"],
@@ -1,7 +1,9 @@
1
+ import { MISSING_VALUE } from "../../utils/format";
1
2
  import type { Quote } from "../../types/financials";
2
3
  import { getLanguage, tf } from "../../i18n";
3
4
  import { isPerpetualExchange } from "../../tickers/perpetual-listing";
4
5
  import { formatUtcDayTime, formatUtcWeekdayTime } from "../../utils/utc-time";
6
+ import { formatShortDate } from "../../utils/datetime-format";
5
7
  import { delayedFeedLagMs } from "../market/freshness";
6
8
  import { quoteHeadlineTime, quoteSessionStateLabel } from "../market/status";
7
9
  import { dailyNavDate, isQuoteStaleForCurrentSession } from "./freshness";
@@ -11,12 +13,17 @@ export function formatQuoteNavAsOf(quote: Quote | null | undefined, now = Date.n
11
13
  const date = quote && dailyNavDate(quote, now);
12
14
  if (!date) return null;
13
15
  const sourceDate = new Date(`${date}T00:00:00Z`);
14
- const dateText = new Intl.DateTimeFormat(getLanguage(), {
15
- timeZone: "UTC",
16
- month: "short",
17
- day: "numeric",
18
- ...(sourceDate.getUTCFullYear() !== new Date(now).getUTCFullYear() ? { year: "numeric" as const } : {}),
19
- }).format(sourceDate);
16
+ const otherYear = sourceDate.getUTCFullYear() !== new Date(now).getUTCFullYear();
17
+ // English reads the day first, as every other date does; another language writes the day its own way.
18
+ const language = getLanguage();
19
+ const dateText = language === "en"
20
+ ? formatShortDate(sourceDate, { utc: true, year: otherYear ? "numeric" : false })
21
+ : new Intl.DateTimeFormat(language, {
22
+ timeZone: "UTC",
23
+ month: "short",
24
+ day: "numeric",
25
+ ...(otherYear ? { year: "numeric" as const } : {}),
26
+ }).format(sourceDate);
20
27
  return tf("NAV · as of {date}", { date: dateText });
21
28
  }
22
29
 
@@ -72,7 +79,7 @@ export interface QuoteAgeFormatOptions {
72
79
 
73
80
  export function formatQuoteAge(lastUpdated: number | undefined, now = Date.now(), options: QuoteAgeFormatOptions = {}): string {
74
81
  const clamped = clampQuoteTimestamp(lastUpdated, now);
75
- if (clamped == null) return "—";
82
+ if (clamped == null) return MISSING_VALUE;
76
83
 
77
84
  // A receipt or source time ahead of the clock is fresh, never negative.
78
85
  const ageMs = Math.max(0, now - clamped);
@@ -99,26 +106,12 @@ export function formatQuoteAgeWithSource(
99
106
  now = Date.now(),
100
107
  options: QuoteAgeFormatOptions = {},
101
108
  ): string {
102
- if (!quote) return "—";
109
+ if (!quote) return MISSING_VALUE;
103
110
 
104
111
  const timestamp = resolveQuoteAgeTimestamp(quote, now);
105
- const age = timestamp == null ? "—" : formatQuoteAge(timestamp, now, options);
106
- if (age === "—") return age;
112
+ const age = timestamp == null ? MISSING_VALUE : formatQuoteAge(timestamp, now, options);
113
+ if (age === MISSING_VALUE) return age;
107
114
 
108
115
  const prefix = quote.dataSource === "delayed" ? "◷" : "";
109
116
  return prefix ? `${prefix}${age}` : age;
110
117
  }
111
-
112
- export function getMostRecentQuoteUpdate(
113
- quotes: Iterable<Pick<Quote, "lastUpdated" | "receivedAt"> | null | undefined>,
114
- now = Date.now(),
115
- ): number | null {
116
- let latest: number | null = null;
117
- for (const quote of quotes) {
118
- const timestamp = resolveQuoteAgeTimestamp(quote, now);
119
- if (timestamp != null && (latest == null || timestamp > latest)) {
120
- latest = timestamp;
121
- }
122
- }
123
- return latest;
124
- }
@@ -1,3 +1,4 @@
1
+ import { MISSING_VALUE } from "../utils/format";
1
2
  import { apiClient } from "../api-client";
2
3
  import type { FundBondFacts } from "../api-client/fund-facts";
3
4
  import type { HeadlessPaneEntry, HeadlessPaneOptionDef } from "../types/headless";
@@ -368,7 +369,7 @@ export function taxEquivalentLines(analysis: TaxEquivalentAnalysis): TaxEquivale
368
369
  { key: "taxRate", label: "Tax rate", text: `${formatRate(combined)} (${stateText})`, value: combined, unit: "%", export: exportPercent(formatRate(combined), null) },
369
370
  ];
370
371
  if (analysis.notApplicable || !analysis.basis || analysis.taxEquivalentYield == null) {
371
- const reason = analysis.notApplicable ?? "—";
372
+ const reason = analysis.notApplicable ?? MISSING_VALUE;
372
373
  lines.push({ key: "taxEquivalentYield", label: "Tax-equivalent yield", text: reason, value: null, export: { formatted: reason, asOf: null } });
373
374
  return lines;
374
375
  }
@@ -394,7 +395,7 @@ export function taxEquivalentLines(analysis: TaxEquivalentAnalysis): TaxEquivale
394
395
  value: Math.round(ratio.value * 10_000) / 10_000,
395
396
  export: exportPercent(ratioText, ratioAsOf),
396
397
  }
397
- : { key: "muniTreasuryRatio", label: "Muni/Treasury ratio", text: analysis.ratioNote ?? "—", value: null, export: { formatted: analysis.ratioNote ?? "—", asOf: null } });
398
+ : { key: "muniTreasuryRatio", label: "Muni/Treasury ratio", text: analysis.ratioNote ?? MISSING_VALUE, value: null, export: { formatted: analysis.ratioNote ?? "—", asOf: null } });
398
399
  return lines;
399
400
  }
400
401
 
@@ -170,7 +170,7 @@ export class NewsService {
170
170
  if (!recoversDataRequests(sourceId) || !this.polling) return;
171
171
  for (const entry of this.queries.values()) {
172
172
  // A list missing some of its sources is read again too, keeping what it shows meanwhile.
173
- if (entry.refs > 0 && entry.state.error != null) void this.refreshQuery(entry.query, entry.state.phase === "error");
173
+ if (entry.refs > 0 && entry.state.error != null) this.refreshQuery(entry.query, entry.state.phase === "error");
174
174
  }
175
175
  }) ?? null;
176
176
  this.scheduleNextPoll();
@@ -217,7 +217,7 @@ export class NewsService {
217
217
  this.notify();
218
218
  }
219
219
  for (const entry of this.queries.values()) {
220
- void this.refreshQuery(entry.query, true);
220
+ this.refreshQuery(entry.query, true);
221
221
  }
222
222
  });
223
223
  }
@@ -263,7 +263,7 @@ export class NewsService {
263
263
  const unsubscribe = this.subscribe(emit);
264
264
  // Show loading before emitting: the fetch below starts immediately, and an
265
265
  // idle first frame paints an empty pane instead of a loading one.
266
- void this.refreshQuery(normalized, true);
266
+ this.refreshQuery(normalized, true);
267
267
  emit();
268
268
 
269
269
  let disposed = false;
@@ -300,10 +300,16 @@ export class NewsService {
300
300
  }
301
301
 
302
302
  async load(query: NewsQuery): Promise<NewsQueryState> {
303
- return this.refreshQuery(normalizeNewsQuery(query), true);
303
+ return this.refreshQueryAndWait(normalizeNewsQuery(query), true);
304
304
  }
305
305
 
306
- async loadMore(query: NewsQuery): Promise<void> {
306
+ /** Asks for the next page. A failed page clears `loadingMore`; anything else is logged. */
307
+ loadMore(query: NewsQuery): void {
308
+ this.loadMoreAndWait(query).catch(logFailure("news.aggregator", "Loading more news failed"));
309
+ }
310
+
311
+ /** `loadMore` for a caller that waits until the page or its failure is in state. */
312
+ async loadMoreAndWait(query: NewsQuery): Promise<void> {
307
313
  const normalized = normalizeNewsQuery(query);
308
314
  const entry = this.queries.get(buildNewsQueryKey(normalized));
309
315
  if (!entry || entry.loadMoreInFlight || !entry.state.nextCursor || entry.state.loadingMore) return;
@@ -398,7 +404,7 @@ export class NewsService {
398
404
  }
399
405
 
400
406
  async poll(query: NewsQuery = DEFAULT_GLOBAL_QUERY): Promise<void> {
401
- await this.refreshQuery(normalizeNewsQuery(query), false);
407
+ await this.refreshQueryAndWait(normalizeNewsQuery(query), false);
402
408
  }
403
409
 
404
410
  private async pollActiveQueries(): Promise<void> {
@@ -407,10 +413,15 @@ export class NewsService {
407
413
  .filter((entry) => entry.refs > 0)
408
414
  .map((entry) => entry.query);
409
415
  if (queries.length === 0) return;
410
- await Promise.allSettled(queries.map((query) => this.refreshQuery(query, false)));
416
+ await Promise.allSettled(queries.map((query) => this.refreshQueryAndWait(query, false)));
417
+ }
418
+
419
+ /** A read nobody waits on. A failed read lands in the query's state; anything else is logged. */
420
+ private refreshQuery(query: NewsQuery, showLoading: boolean): void {
421
+ this.refreshQueryAndWait(query, showLoading).catch(logFailure("news.aggregator", "Refreshing a news query failed"));
411
422
  }
412
423
 
413
- private async refreshQuery(
424
+ private async refreshQueryAndWait(
414
425
  query: NewsQuery,
415
426
  showLoading: boolean,
416
427
  ): Promise<NewsQueryState> {
package/src/news/hooks.ts CHANGED
@@ -48,7 +48,7 @@ function useNewsLoadMore(query: NewsQuery | null | undefined): () => void {
48
48
  const key = query ? buildNewsQueryKey(query) : null;
49
49
  return useCallback(() => {
50
50
  if (!query) return;
51
- void sharedService?.loadMore(query);
51
+ sharedService?.loadMore(query);
52
52
  }, [key]);
53
53
  }
54
54
 
@@ -1,4 +1,5 @@
1
1
  import { coinSearchName } from "../utils/crypto-pair";
2
+ import { formatShortDate } from "../utils/datetime-format";
2
3
  import { canonicalExchange, normalizeSymbol } from "../utils/exchanges";
3
4
  import type { NewsCapability } from "../capabilities";
4
5
  import type { NewsArticle, NewsFeed, NewsQuery, NewsQueryState } from "./types";
@@ -288,6 +289,54 @@ export function summaryRestatesHeadline(title: string, summary: string): boolean
288
289
  return words.filter((word) => !known(word)).length <= words.length * RESTATED_NEW_WORDS;
289
290
  }
290
291
 
292
+ /**
293
+ * What a company feed's row of routine notices stands for, after its headline: "8 notices since 30 Oct"
294
+ * (a buy-back's daily "Transaction in own shares", folded into its latest). Null for any other row.
295
+ */
296
+ function routineNoticesText(article: Pick<NewsArticle, "routine" | "publishedAt">): string | null {
297
+ const routine = article.routine;
298
+ if (!routine || routine.notices < 2) return null;
299
+ // A day kept as text (a pane's state restored from disk) is read as one; an unreadable one names none.
300
+ const since = routine.since instanceof Date ? routine.since : new Date(String(routine.since));
301
+ if (Number.isNaN(since.getTime())) return `${routine.notices} notices`;
302
+ // The year is named only when the run began in another year than its latest notice.
303
+ const latest = article.publishedAt instanceof Date ? article.publishedAt : new Date(String(article.publishedAt));
304
+ const sameYear = since.getUTCFullYear() === latest.getUTCFullYear();
305
+ return `${routine.notices} notices since ${formatShortDate(since, { year: sameYear ? false : "numeric", utc: true })}`;
306
+ }
307
+
308
+ /** The headline a list shows: with the notices a folded row stands for ("Transaction in own shares (8 notices since 30 Oct)"). */
309
+ export function listedHeadline(article: Pick<NewsArticle, "title" | "routine" | "publishedAt">): string {
310
+ const notices = routineNoticesText(article);
311
+ return notices ? `${article.title} (${notices})` : article.title;
312
+ }
313
+
314
+ /** The fields an exported row keeps of the notices a folded row stands for: none for any other row. */
315
+ export function routineNoticeFields(article: Pick<NewsArticle, "routine">) {
316
+ const routine = article.routine;
317
+ const since = routine ? (routine.since instanceof Date ? routine.since : new Date(String(routine.since))) : null;
318
+ return routine && since && !Number.isNaN(since.getTime()) ? {
319
+ routineKind: routine.kind,
320
+ routineNotices: routine.notices,
321
+ routineSince: since.toISOString(),
322
+ routineProgramme: routine.programme,
323
+ } : {};
324
+ }
325
+
326
+ /**
327
+ * A text table's headline from an exported row: its title, with the notices a folded row stands for
328
+ * (`routineNoticeFields`) after it. Exports keep the title and the count apart.
329
+ */
330
+ export function listedRowHeadline(title: unknown, row: Record<string, unknown>): string {
331
+ const text = String(title ?? "");
332
+ if (typeof row.routineNotices !== "number" || typeof row.routineSince !== "string") return text;
333
+ return listedHeadline({
334
+ title: text,
335
+ routine: { kind: String(row.routineKind ?? ""), notices: row.routineNotices, since: new Date(row.routineSince), programme: null },
336
+ publishedAt: new Date(String(row.publishedAt ?? row.routineSince)),
337
+ });
338
+ }
339
+
291
340
  /**
292
341
  * A story's summary as one line under its row in a text list (`news`,
293
342
  * `fn CN`): its whitespace and line breaks run together, null when it has
package/src/news/types.ts CHANGED
@@ -42,6 +42,8 @@ export interface NewsArticle {
42
42
  isDeveloping: boolean;
43
43
  sourceCount?: number;
44
44
  items?: NewsStoryItem[];
45
+ /** The routine notices the story stands for in a company's feed (a buy-back's daily notices), its own included. */
46
+ routine?: NewsRoutineNotices;
45
47
  /**
46
48
  * The text this story was found by, when it stands in for a coin pair's feed
47
49
  * no story is filed under: the stories that mention "bitcoin" for BTC-USD.
@@ -52,6 +54,13 @@ export interface NewsArticle {
52
54
  importance: number;
53
55
  }
54
56
 
57
+ interface NewsRoutineNotices {
58
+ kind: string;
59
+ notices: number;
60
+ since: Date;
61
+ programme: string | null;
62
+ }
63
+
55
64
  export interface NewsQuery {
56
65
  feed?: NewsFeed;
57
66
  /** @deprecated Set `feed: "ticker"` instead. */