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
@@ -10,7 +10,8 @@ import type { DividendPayment, GrowthPayments } from "./types";
10
10
  import {
11
11
  convertedFromText, formatConvertedAmount, formatDividendYield, growthPaymentsText, PAYOUT_NOT_MEANINGFUL, staleHistoryText, toDividendRows, trailingPaymentsText,
12
12
  } from "./view";
13
- import { formatDistributionAmount, formatPercent } from "../../../utils/format";
13
+ import { MISSING_VALUE, formatDistributionAmount, formatPercent } from "../../../utils/format";
14
+ import { NOT_MEANINGFUL_TEXT } from "../../../utils/growth";
14
15
  import { forwardDividendBasis, historyEndsText, noCurrentDividend, TRAILING_DIVIDEND_BASIS, UNEVEN_REGULAR_PAYMENTS } from "../../../utils/forward-dividend";
15
16
  import { currencyPriceMinDigits, formatMarketPriceWithCurrency } from "../../../market-data/market/format";
16
17
  import type { Quote } from "../../../types/financials";
@@ -39,7 +40,7 @@ function paymentColumns(converted: boolean, subUnit?: string) {
39
40
  { key: "exDate", header: "Ex-date" },
40
41
  { key: "amount", header: "Amount", align: "right" as const,
41
42
  format: (value: unknown, row: Record<string, unknown>) => typeof value === "number" && typeof row.currency === "string" && row.currency
42
- ? amount(value, row.currency) : value == null ? "-" : String(value) },
43
+ ? amount(value, row.currency) : value == null ? MISSING_VALUE : String(value) },
43
44
  { key: "currency", header: "CCY" },
44
45
  { key: "type", header: "Type" },
45
46
  ];
@@ -52,7 +53,7 @@ const SOURCE_COLUMN = { key: "source", header: "Source",
52
53
  /** After the amount, for a company declaring in another currency than the listing pays: what it declared. */
53
54
  const DECLARED_COLUMN = { key: "declared", header: "Declared", align: "right" as const,
54
55
  format: (value: unknown, row: Record<string, unknown>) => typeof value === "number" && typeof row.declaredCurrency === "string"
55
- ? formatDistributionAmount(value, row.declaredCurrency) : "-" };
56
+ ? formatDistributionAmount(value, row.declaredCurrency) : MISSING_VALUE };
56
57
 
57
58
  /** What a ticker's read needs: the market data, Gloom Cloud, and the listing a typed key stands for. */
58
59
  export type DividendReadContext = Pick<HeadlessPaneContext, "marketData" | "apiClient" | "resolveInstrument">;
@@ -145,8 +146,9 @@ export function dividendRankingReads(
145
146
  };
146
147
  }
147
148
 
148
- /** A growth figure, or what its short year holds: "n/a: 1 of 2 payments". */
149
- function growthText(growth: number | null, payments: GrowthPayments | null | undefined): string {
149
+ /** A growth figure, N/M off a year that paid nothing, or what its short year holds: "n/a: 1 of 2 payments". */
150
+ function growthText(growth: number | null, payments: GrowthPayments | null | undefined, notMeaningful?: boolean): string {
151
+ if (growth == null && notMeaningful) return NOT_MEANINGFUL_TEXT;
150
152
  return growth == null && payments ? growthPaymentsText(payments) : formatPercent(growth ?? undefined);
151
153
  }
152
154
 
@@ -219,8 +221,8 @@ export function projectDividendYieldHeadless(
219
221
  const forwardLabel = bond ? `Forward distribution yield (${NOT_SEC_YIELD})` : "Forward yield";
220
222
  const forwardText = metrics.lapse ? noCurrentDividend(metrics.lapse) : null;
221
223
  const lastEx = isoDay(metrics.lastExDividendDate);
222
- const growthEntry = (label: string, value: number | null, payments: GrowthPayments | null | undefined) =>
223
- ({ label, value: roundedRatio(value), formatted: growthText(value, payments) });
224
+ const growthEntry = (label: string, value: number | null, payments: GrowthPayments | null | undefined, notMeaningful?: boolean) =>
225
+ ({ label, value: roundedRatio(value), formatted: growthText(value, payments, notMeaningful) });
224
226
  const datesAndCash = [
225
227
  dateEntry("Last ex-dividend", metrics.lastExDividendDate),
226
228
  dateEntry("Next ex-dividend", metrics.nextExDividendDate),
@@ -258,8 +260,8 @@ export function projectDividendYieldHeadless(
258
260
  { label: "Trailing rate", value: metrics.trailingRate, formatted: cashRate(metrics.trailingRate) },
259
261
  { label: "Forward rate", value: metrics.forwardRate, formatted: cashRate(metrics.forwardRate) },
260
262
  { label: "Earnings Payout", value: roundedRatio(metrics.payoutRatio), formatted: metrics.payoutNotMeaningful ? PAYOUT_NOT_MEANINGFUL : formatDividendYield(metrics.payoutRatio) },
261
- growthEntry("1Y Cash Growth", metrics.growth1Y, metrics.growth1YPayments),
262
- growthEntry("3Y Cash CAGR", metrics.growth3Y, metrics.growth3YPayments),
263
+ growthEntry("1Y Cash Growth", metrics.growth1Y, metrics.growth1YPayments, metrics.growth1YNotMeaningful),
264
+ growthEntry("3Y Cash CAGR", metrics.growth3Y, metrics.growth3YPayments, metrics.growth3YNotMeaningful),
263
265
  { label: "Frequency", value: metrics.paymentFrequency },
264
266
  ...datesAndCash,
265
267
  ],
@@ -282,8 +284,8 @@ export function projectDividendYieldHeadless(
282
284
  asOf: metrics.forwardRate == null ? null : metrics.forwardRateAsOf },
283
285
  { label: "Earnings Payout", value: roundedRatio(metrics.payoutRatio), formatted: metrics.payoutNotMeaningful ? PAYOUT_NOT_MEANINGFUL : formatDividendYield(metrics.payoutRatio),
284
286
  exportUnit: "pct", asOf: null },
285
- { ...growthEntry("1Y Cash Growth", metrics.growth1Y, metrics.growth1YPayments), exportUnit: "pct", asOf: metrics.growth1Y == null ? null : lastEx },
286
- { ...growthEntry("3Y Cash CAGR", metrics.growth3Y, metrics.growth3YPayments), exportUnit: "pct", asOf: metrics.growth3Y == null ? null : lastEx },
287
+ { ...growthEntry("1Y Cash Growth", metrics.growth1Y, metrics.growth1YPayments, metrics.growth1YNotMeaningful), exportUnit: "pct", asOf: metrics.growth1Y == null ? null : lastEx },
288
+ { ...growthEntry("3Y Cash CAGR", metrics.growth3Y, metrics.growth3YPayments, metrics.growth3YNotMeaningful), exportUnit: "pct", asOf: metrics.growth3Y == null ? null : lastEx },
287
289
  { label: "Frequency", value: metrics.paymentFrequency, asOf: null },
288
290
  ...datesAndCash.map((entry) => ({ ...entry, asOf: null })),
289
291
  ],
@@ -320,6 +322,9 @@ export function projectDividendYieldHeadless(
320
322
  // Set when a year a growth figure compares holds fewer payments than the cadence pays: that figure is null.
321
323
  growth1YPayments: metrics.growth1YPayments ?? null,
322
324
  growth3YPayments: metrics.growth3YPayments ?? null,
325
+ // Set when the earlier year a growth figure compares paid nothing and the later one paid: that figure is null, N/M.
326
+ growth1YNotMeaningful: metrics.growth1YNotMeaningful === true,
327
+ growth3YNotMeaningful: metrics.growth3YNotMeaningful === true,
323
328
  forwardRateAsOf: metrics.forwardRateAsOf,
324
329
  // Set when a monthly payer's history stops more than 40 days ago: its forward yield is withheld and its trailing yield counts the history to then.
325
330
  historyEnds: metrics.lapse?.historyEnds ? metrics.lapse.lastPaid : null,
@@ -20,7 +20,8 @@ import {
20
20
  import { useAsyncResource } from "../../../react/async-resource";
21
21
  import { colors, priceColor } from "../../../theme/colors";
22
22
  import { TextAttributes, useUiCapabilities } from "../../../ui";
23
- import { displayWidth, formatCurrency, formatDistributionAmount, formatPercentRaw } from "../../../utils/format";
23
+ import { MISSING_VALUE, displayWidth, formatCurrency, formatDistributionAmount, formatPercentRaw } from "../../../utils/format";
24
+ import { NOT_MEANINGFUL_TEXT } from "../../../utils/growth";
24
25
  import { resolveCurrencyUnit } from "../../../utils/currency-units";
25
26
  import { parsePublicTickerKey } from "../../../utils/exchanges";
26
27
  import { forwardDividendNote, lapseValue, lastPaidNote, UNEVEN_REGULAR_PAYMENTS } from "../../../utils/forward-dividend";
@@ -52,17 +53,18 @@ import { bondFigures } from "../../../market-data/bond-funds";
52
53
 
53
54
  /** A per-share rate; one converted from the currency the company declares in goes to two decimals of its source's unit. */
54
55
  function formatRate(value: number | null, currency: string, converted = false, subUnit?: string): string {
55
- if (value == null) return "—";
56
+ if (value == null) return MISSING_VALUE;
56
57
  return converted ? formatConvertedAmount(value, currency, subUnit) : formatDistributionAmount(value, currency);
57
58
  }
58
59
 
59
60
  function formatGrowth(value: number | null): string {
60
- if (value == null) return "—";
61
+ if (value == null) return MISSING_VALUE;
61
62
  return formatPercentRaw(value * 100);
62
63
  }
63
64
 
64
- /** A growth figure, or "n/a" with how many payments its short year holds. */
65
- function growthItem(id: string, label: string, growth: number | null, payments: GrowthPayments | null | undefined): StatItem {
65
+ /** A growth figure, "N/M" off a year that paid nothing, or "n/a" with how many payments its short year holds. */
66
+ function growthItem(id: string, label: string, growth: number | null, payments: GrowthPayments | null | undefined, notMeaningful?: boolean): StatItem {
67
+ if (growth == null && notMeaningful) return { id, label, value: NOT_MEANINGFUL_TEXT };
66
68
  if (growth == null && payments) {
67
69
  return { id, label, value: "n/a", detail: growthPaymentsDetail(payments) };
68
70
  }
@@ -70,12 +72,12 @@ function growthItem(id: string, label: string, growth: number | null, payments:
70
72
  }
71
73
 
72
74
  function formatDate(date: Date | null): string {
73
- if (!date) return "—";
75
+ if (!date) return MISSING_VALUE;
74
76
  return date.toISOString().slice(0, 10);
75
77
  }
76
78
 
77
79
  function formatFrequency(freq: DividendMetrics["paymentFrequency"]): string {
78
- if (!freq) return "—";
80
+ if (!freq) return MISSING_VALUE;
79
81
  switch (freq) {
80
82
  case "monthly": return "Monthly";
81
83
  case "quarterly": return "Quarterly";
@@ -126,9 +128,9 @@ function buildMetricItems(metrics: DividendMetrics, currency: string, hasHistory
126
128
  ...metrics.trailingRate != null ? converted : {} },
127
129
  { id: "forward-rate", label: short ? "Fwd/sh" : "Fwd/share", value: formatRate(metrics.forwardRate, currency, !!convertedFrom, convertedSubUnit),
128
130
  ...metrics.forwardRate != null ? converted : {} },
129
- growthItem("growth-1y", short ? "1Y chg" : "1Y growth", metrics.growth1Y, metrics.growth1YPayments),
130
- growthItem("cagr-3y", "3Y CAGR", metrics.growth3Y, metrics.growth3YPayments),
131
- { id: "payout", label: "Payout", value: metrics.payoutNotMeaningful ? PAYOUT_NOT_MEANINGFUL : metrics.payoutRatio != null ? `${(metrics.payoutRatio * 100).toFixed(1)}%` : "—" },
131
+ growthItem("growth-1y", short ? "1Y chg" : "1Y growth", metrics.growth1Y, metrics.growth1YPayments, metrics.growth1YNotMeaningful),
132
+ growthItem("cagr-3y", "3Y CAGR", metrics.growth3Y, metrics.growth3YPayments, metrics.growth3YNotMeaningful),
133
+ { id: "payout", label: "Payout", value: metrics.payoutNotMeaningful ? PAYOUT_NOT_MEANINGFUL : metrics.payoutRatio != null ? `${(metrics.payoutRatio * 100).toFixed(1)}%` : MISSING_VALUE },
132
134
  { id: "cadence", label: "Cadence", value: formatFrequency(metrics.paymentFrequency) },
133
135
  ...exDate,
134
136
  { id: "next-pay", label: "Next pay", value: formatDate(metrics.nextPayDate) },
@@ -16,6 +16,7 @@ import { colors } from "../../../theme/colors";
16
16
  import type { HeadlessPaneColumn } from "../../../types/headless";
17
17
  import { TextAttributes } from "../../../ui";
18
18
  import { compareSortValues, nextHeaderSort, type SortComparableValue, type SortPreference } from "../../../utils/sort-values";
19
+ import { displayWidth } from "../../../utils/format";
19
20
  import { SignInWall } from "../cloud/auth-actions";
20
21
  import { isCloudSessionRequired, useResearchCloudSession } from "../shared/research-cloud-session";
21
22
  import { fetchDividendData } from "./client";
@@ -106,7 +107,9 @@ export function DividendRankingView({ symbols, focused, width, height, loadData
106
107
  const columns = useMemo<RankingColumn[]>(() => (section?.columns ?? []).map((column) => ({
107
108
  id: column.key,
108
109
  label: column.header,
109
- width: Math.max(column.header.length, COLUMN_WIDTHS[column.key] ?? 0),
110
+ // The ticker column grows to its longest key, so a listing abroad shows whole.
111
+ width: Math.max(column.header.length, COLUMN_WIDTHS[column.key] ?? 0,
112
+ ...column.key === "symbol" ? (section?.rows ?? []).map((row) => displayWidth(String(row.symbol ?? ""))) : []),
110
113
  align: column.align === "right" ? "right" : "left",
111
114
  source: column,
112
115
  })), [section]);
@@ -1,5 +1,6 @@
1
1
  import type { HeadlessBundleResult, HeadlessPaneColumn } from "../../../types/headless";
2
- import { formatPercent } from "../../../utils/format";
2
+ import { MISSING_VALUE, formatPercent } from "../../../utils/format";
3
+ import { NOT_MEANINGFUL_TEXT } from "../../../utils/growth";
3
4
  import type { DividendData } from "./client";
4
5
  import { formatDividendYield, growthPaymentsDetail, PAYOUT_NOT_MEANINGFUL, trailingPaymentsText } from "./view";
5
6
  import type { FundBondFacts } from "../../../api-client/fund-facts";
@@ -172,6 +173,9 @@ function rankDividendEntries(entries: readonly DividendRankingEntry[], now = new
172
173
  // Set when a year the figure compares is short of the cadence's payments: the figure is then n/a.
173
174
  ...metrics.growth1YPayments ? { growth1YPayments: growthPaymentsDetail(metrics.growth1YPayments) } : {},
174
175
  ...metrics.growth3YPayments ? { growth3YPayments: growthPaymentsDetail(metrics.growth3YPayments) } : {},
176
+ // Set when the earlier year paid nothing and the later one paid: the figure is then N/M.
177
+ ...metrics.growth1YNotMeaningful ? { growth1YNotMeaningful: true } : {},
178
+ ...metrics.growth3YNotMeaningful ? { growth3YNotMeaningful: true } : {},
175
179
  lastExDate: isoDay(metrics.lastExDividendDate),
176
180
  payDate: declaredPayDate(data, now),
177
181
  frequency: metrics.paymentFrequency,
@@ -192,10 +196,14 @@ function rankDividendEntries(entries: readonly DividendRankingEntry[], now = new
192
196
  }
193
197
 
194
198
  const ratio = (value: unknown) => formatDividendYield(typeof value === "number" ? value : null);
195
- /** A growth figure, or n/a when one of its years is short (the row's `<key>Payments`). */
196
- const growth = (key: "growth1Y" | "growth3Y") => (value: unknown, row: Record<string, unknown>) =>
197
- typeof value !== "number" && typeof row[`${key}Payments`] === "string" ? "n/a" : formatPercent(typeof value === "number" ? value : undefined);
198
- const day = (value: unknown) => typeof value === "string" && value ? value : "—";
199
+ /**
200
+ * A growth figure; n/m off a year that paid nothing (the row's `<key>NotMeaningful`; the text report draws N/M);
201
+ * or n/a when one of its years is short (the row's `<key>Payments`).
202
+ */
203
+ const growth = (key: "growth1Y" | "growth3Y", notMeaningful = NOT_MEANINGFUL_TEXT.toLowerCase()) => (value: unknown, row: Record<string, unknown>) =>
204
+ typeof value !== "number" && row[`${key}NotMeaningful`] === true ? notMeaningful
205
+ : typeof value !== "number" && typeof row[`${key}Payments`] === "string" ? "n/a" : formatPercent(typeof value === "number" ? value : undefined);
206
+ const day = (value: unknown) => typeof value === "string" && value ? value : MISSING_VALUE;
199
207
 
200
208
  const RANKING_COLUMNS: HeadlessPaneColumn[] = [
201
209
  { key: "symbol", header: "Ticker", shrink: false },
@@ -208,10 +216,10 @@ const RANKING_COLUMNS: HeadlessPaneColumn[] = [
208
216
  format: (value, row) => row.payoutNotMeaningful === true ? PAYOUT_NOT_MEANINGFUL.toLowerCase() : ratio(value),
209
217
  textFormat: (value, row) => row.payoutNotMeaningful === true ? PAYOUT_NOT_MEANINGFUL : ratio(value),
210
218
  description: "Trailing twelve-month dividends over trailing twelve-month diluted EPS; N/M when that EPS is zero or negative." },
211
- { key: "growth1Y", header: "1Y growth", align: "right", format: growth("growth1Y"),
212
- description: "Trailing twelve-month cash per share against a year earlier; n/a when either year holds fewer payments than the cadence pays." },
213
- { key: "growth3Y", header: "3Y CAGR", align: "right", format: growth("growth3Y"),
214
- description: "Compound annual growth of trailing twelve-month cash per share over three years; n/a when either year holds fewer payments than the cadence pays." },
219
+ { key: "growth1Y", header: "1Y growth", align: "right", format: growth("growth1Y"), textFormat: growth("growth1Y", NOT_MEANINGFUL_TEXT),
220
+ description: "Trailing twelve-month cash per share against a year earlier; N/M when the year earlier paid nothing; n/a when either year holds fewer payments than the cadence pays." },
221
+ { key: "growth3Y", header: "3Y CAGR", align: "right", format: growth("growth3Y"), textFormat: growth("growth3Y", NOT_MEANINGFUL_TEXT),
222
+ description: "Compound annual growth of trailing twelve-month cash per share over three years; N/M when the year three years earlier paid nothing; n/a when either year holds fewer payments than the cadence pays." },
215
223
  { key: "lastExDate", header: "Last ex", format: day, shrink: false },
216
224
  { key: "payDate", header: "Next pay", format: day, shrink: false, stackPriority: 2,
217
225
  description: "Pay date of the next declared distribution; past distributions carry ex-dates only." },
@@ -225,7 +233,7 @@ const SEC_YIELD_COLUMNS: HeadlessPaneColumn[] = [
225
233
  description: "The date the sponsor gives its SEC yield as of." },
226
234
  ];
227
235
 
228
- const years = (value: unknown) => typeof value === "number" && Number.isFinite(value) ? `${value.toFixed(2)} yrs` : "—";
236
+ const years = (value: unknown) => typeof value === "number" && Number.isFinite(value) ? `${value.toFixed(2)} yrs` : MISSING_VALUE;
229
237
 
230
238
  /** Shown after the SEC yield with `--tax-rate`: the rest of a bond fund's sponsor figures, then what the tax rate makes of its yield. */
231
239
  const TAX_COLUMNS: HeadlessPaneColumn[] = [
@@ -237,7 +245,7 @@ const TAX_COLUMNS: HeadlessPaneColumn[] = [
237
245
  description: "A muni fund's tax-equivalent yield at --tax-rate: its SEC yield (else its distribution yield) / (1 - the rate). Blank for a taxable fund." },
238
246
  // To one decimal, as single-ticker DVD and DES draw it.
239
247
  { key: "muniTreasuryRatio", header: "Muni/Tsy", align: "right",
240
- format: (value) => typeof value === "number" && Number.isFinite(value) ? formatMuniTreasuryRatio(value) : "—",
248
+ format: (value) => typeof value === "number" && Number.isFinite(value) ? formatMuniTreasuryRatio(value) : MISSING_VALUE,
241
249
  description: "A muni fund's yield over the Treasury par yield at the tenor nearest its duration (treasuryTenor)." },
242
250
  { key: "treasuryTenor", header: "Tenor", format: day, shrink: false, stackPriority: 4,
243
251
  description: "The Treasury tenor the muni/Treasury ratio divides by." },
@@ -43,6 +43,10 @@ export interface DividendMetrics {
43
43
  growth1YPayments?: GrowthPayments | null;
44
44
  /** The same for the two years the 3Y rate compares. */
45
45
  growth3YPayments?: GrowthPayments | null;
46
+ /** Set when the earlier year 1Y growth compares paid no cash and the trailing year did (a resumed dividend): growth off zero, N/M. */
47
+ growth1YNotMeaningful?: boolean;
48
+ /** The same for the 3Y rate. */
49
+ growth3YNotMeaningful?: boolean;
46
50
  paymentFrequency: DistributionCadence | null;
47
51
  lastExDividendDate: Date | null;
48
52
  /** Announced ex-date after now, from the summary or a future-dated history record. */
@@ -1,5 +1,5 @@
1
1
  import type { DividendPayment, GrowthPayments } from "./types";
2
- import { formatCurrency } from "../../../utils/format";
2
+ import { MISSING_VALUE, formatCurrency } from "../../../utils/format";
3
3
  import { currencyMinorDigits } from "../../../market-data/market/format";
4
4
  import { resolveCurrencyUnit } from "../../../utils/currency-units";
5
5
  import type { ProjectedChartPoint } from "../../../components/chart/core/data";
@@ -17,7 +17,7 @@ const DAY = 24 * 60 * 60 * 1000;
17
17
  * `ZAR 0.866087`), as the conversion gives it no more.
18
18
  */
19
19
  export function formatConvertedAmount(value: number | null | undefined, currency: string, subUnit?: string): string {
20
- if (value == null || !Number.isFinite(value)) return "—";
20
+ if (value == null || !Number.isFinite(value)) return MISSING_VALUE;
21
21
  const unit = subUnit ? resolveCurrencyUnit(subUnit) : null;
22
22
  return unit && unit.divisor !== 1 && unit.currency === currency
23
23
  ? formatCurrency(value * unit.divisor, subUnit!, 2)
@@ -28,7 +28,7 @@ export function formatConvertedAmount(value: number | null | undefined, currency
28
28
  export const convertedFromText = (currency: string) => `converted from ${currency}`;
29
29
 
30
30
  export function formatDividendYield(value: number | null): string {
31
- return value != null && Number.isFinite(value) ? `${(value * 100).toFixed(2)}%` : "—";
31
+ return value != null && Number.isFinite(value) ? `${(value * 100).toFixed(2)}%` : MISSING_VALUE;
32
32
  }
33
33
 
34
34
  /** A payout over zero or negative earnings, written as a P/E over a loss is. */
@@ -1,6 +1,7 @@
1
1
  import { useCallback, useEffect, useState } from "react";
2
2
  import type { DocsFeed, DocsLesson } from "../../../docs/content";
3
3
  import { loadDocsFeed, loadDocsLesson, savedDocsFeed, savedDocsLesson } from "../../../docs/load";
4
+ import { logFailure } from "../../../utils/log-failure";
4
5
 
5
6
  export interface DocsFeedState {
6
7
  /** Null only until the shipped copy has loaded, a moment on first open. */
@@ -15,9 +16,10 @@ export function useDocsFeed(): DocsFeedState {
15
16
  const [request, setRequest] = useState({ force: false, token: 0 });
16
17
  useEffect(() => {
17
18
  let live = true;
18
- void loadDocsFeed({ force: request.force }).then((result) => {
19
+ // Only a shipped copy that cannot be read rejects; the site's failures answer offline.
20
+ loadDocsFeed({ force: request.force }).then((result) => {
19
21
  if (live) setState(result);
20
- });
22
+ }, logFailure("docs.feed", "Loading the docs index failed"));
21
23
  return () => {
22
24
  live = false;
23
25
  };
@@ -1,3 +1,4 @@
1
+ import { MISSING_VALUE } from "../../../utils/format";
1
2
  import type { DoeSeriesRow, DoeTab } from "../../../api-client/doe";
2
3
  import type { HeadlessPaneDefinition } from "../../../types/plugin";
3
4
  import { loadDoeBoard } from "./client";
@@ -18,7 +19,7 @@ import {
18
19
  } from "./model";
19
20
  import { newestReportTime, oldestReportTime } from "../../../utils/utc-time";
20
21
 
21
- const text = (value: unknown) => typeof value === "string" ? value : "--";
22
+ const text = (value: unknown) => typeof value === "string" ? value : MISSING_VALUE;
22
23
 
23
24
  /** One row per series, in the pane's words and units; numbers keep their published precision. */
24
25
  function reportRow(row: DoeSeriesRow) {
@@ -1,3 +1,4 @@
1
+ import { MISSING_VALUE } from "../../../utils/format";
1
2
  import type { DoeBoardPayload, DoeReport, DoeReportStatus, DoeSeriesRow, DoeTab, DoeUnit } from "../../../api-client/doe";
2
3
  import { spanAxisFormatter } from "../../../components/chart-table/axis";
3
4
  import type { ChartStripSpec } from "../../../components/chart-table/header";
@@ -74,33 +75,33 @@ function signed(value: number, decimals: number, suffix = ""): string {
74
75
  }
75
76
 
76
77
  export function formatDoeLevel(unit: DoeUnit, value: number | null): string {
77
- return value == null ? "--" : grouped(doeDisplayValue(unit, value), DECIMALS[unit]);
78
+ return value == null ? MISSING_VALUE : grouped(doeDisplayValue(unit, value), DECIMALS[unit]);
78
79
  }
79
80
 
80
81
  export function formatDoeChange(unit: DoeUnit, value: number | null): string {
81
- return value == null ? "--" : signed(doeDisplayValue(unit, value), DECIMALS[unit]);
82
+ return value == null ? MISSING_VALUE : signed(doeDisplayValue(unit, value), DECIMALS[unit]);
82
83
  }
83
84
 
84
85
  /** Against a year ago: a percentage, or points for a rate already in percent. */
85
86
  export function formatDoeVsYear(row: DoeSeriesRow): string {
86
87
  const ago = row.yearAgo;
87
- if (!ago) return "--";
88
+ if (!ago) return MISSING_VALUE;
88
89
  if (row.unit === "pct") return signed(ago.change, 1, "pt");
89
- return ago.changePercent == null ? "--" : signed(ago.changePercent, 1, "%");
90
+ return ago.changePercent == null ? MISSING_VALUE : signed(ago.changePercent, 1, "%");
90
91
  }
91
92
 
92
93
  /** Against the five-year average for the week, the same way. */
93
94
  export function formatDoeVsFive(row: DoeSeriesRow): string {
94
95
  const five = row.fiveYear;
95
- if (!five) return "--";
96
+ if (!five) return MISSING_VALUE;
96
97
  if (row.unit === "pct") return signed(five.vsAverage, 1, "pt");
97
- return five.vsAveragePercent == null ? "--" : signed(five.vsAveragePercent, 1, "%");
98
+ return five.vsAveragePercent == null ? MISSING_VALUE : signed(five.vsAveragePercent, 1, "%");
98
99
  }
99
100
 
100
101
  /** The figure a range bar stands for, for its export and its title. */
101
102
  export function formatDoePosition(row: DoeSeriesRow): string {
102
103
  const position = row.fiveYear?.position;
103
- if (position == null) return "--";
104
+ if (position == null) return MISSING_VALUE;
104
105
  if (position < 0) return "below range";
105
106
  if (position > 100) return "above range";
106
107
  return `${Math.round(position)}%`;
@@ -116,19 +117,19 @@ export function doeReport(payload: DoeBoardPayload, tab: DoeTab): DoeReportStatu
116
117
 
117
118
  const MONTHS = ["Jan", "Feb", "Mar", "Apr", "May", "Jun", "Jul", "Aug", "Sep", "Oct", "Nov", "Dec"];
118
119
 
119
- /** "Sep 25" from a calendar date. */
120
+ /** "25 Sep" from a calendar date. */
120
121
  function doeDay(date: string): string {
121
122
  const [, month, day] = date.split("-").map(Number) as [number, number, number];
122
- return `${MONTHS[month - 1]} ${day}`;
123
+ return `${day} ${MONTHS[month - 1]}`;
123
124
  }
124
125
 
125
- /** A release instant on the EIA's own clock: "Wed Sep 30 10:30 ET". */
126
+ /** A release instant on the EIA's own clock: "Wed 30 Sep 10:30 ET". */
126
127
  function doeReleaseTime(iso: string): string {
127
128
  const parts = Object.fromEntries(new Intl.DateTimeFormat("en-US", {
128
129
  timeZone: "America/New_York", weekday: "short", month: "short", day: "numeric",
129
130
  hour: "2-digit", minute: "2-digit", hourCycle: "h23",
130
131
  }).formatToParts(new Date(iso)).map((part) => [part.type, part.value]));
131
- return `${parts.weekday} ${parts.month} ${parts.day} ${parts.hour}:${parts.minute} ET`;
132
+ return `${parts.weekday} ${parts.day} ${parts.month} ${parts.hour}:${parts.minute} ET`;
132
133
  }
133
134
 
134
135
  /** The calendar's expectation for the next gas release, as the 1W change column reads it: "consensus +80 Bcf, prior +77 Bcf". */
@@ -7,9 +7,10 @@ import type { TickerRecord } from "../../../types/ticker";
7
7
  import { earningsDateStatus, earningsEpsBasis, isProvisionalActual } from "../shared/earnings-report";
8
8
  import { calendarReport } from "../shared/earnings-calendar";
9
9
  import { listingSuffixCandidate } from "../../../sources/listing-symbols";
10
- import { isUsListingExchange } from "../../../utils/exchanges";
10
+ import { isUsListingExchange, parsePublicTickerKey } from "../../../utils/exchanges";
11
+ import { listingAbroadVenue } from "../../../utils/sec";
11
12
  import { sameHistoryListing } from "./client";
12
- import { shortDate, surprise, weekday } from "./format";
13
+ import { shortDate, surprise, weekday, type Surprise } from "./format";
13
14
 
14
15
  /** A held name is in a portfolio; a watched one only in watchlists. */
15
16
  export type Ownership = "held" | "watched";
@@ -33,8 +34,8 @@ export interface BoardReport {
33
34
  provisional: boolean;
34
35
  /** Null when the reported figure's basis cannot be determined. */
35
36
  epsBasis: EarningsEpsBasis | null;
36
- /** Actual over estimate minus one. */
37
- epsSurprise: number | null;
37
+ /** Actual over estimate minus one: N/M against a loss or zero estimate. */
38
+ epsSurprise: Surprise;
38
39
  revenueEstimate: number | null;
39
40
  impliedMove: number | null;
40
41
  averageMove: number | null;
@@ -162,10 +163,44 @@ export function boardReport(report: EarningsCalendarReport, owned: ReadonlyMap<s
162
163
  };
163
164
  }
164
165
 
165
- /** A listing as the board keys it: 0700.HK, as typed where its quote could not be read, is 0700:HKEX. */
166
+ /**
167
+ * A listing as the board and Gloom Cloud's earnings history key it, however it
168
+ * was typed: a vendor's suffix as the venue it names (0700.HK, 700.HK and
169
+ * 00700.HK are 0700:HKEX, VOD.L is VOD:LSE), a venue by its own code
170
+ * (0700:XHKG is 0700:HKEX), a Hong Kong code by its four digits, and a US
171
+ * listing by its ticker (AAPL:NASDAQ is AAPL). Any other key stays as typed.
172
+ */
166
173
  export function boardKey(symbol: string): string {
167
- const suffixed = listingSuffixCandidate(symbol);
168
- return (suffixed ? `${suffixed.symbol}:${suffixed.exchange}` : symbol).toUpperCase();
174
+ const typed = symbol.trim().toUpperCase();
175
+ const suffixed = listingSuffixCandidate(typed);
176
+ const key = suffixed ? `${suffixed.symbol}:${suffixed.exchange}` : typed;
177
+ const parsed = parsePublicTickerKey(key);
178
+ if (parsed.exchange && isUsListingExchange(parsed.exchange)) return parsed.symbol;
179
+ const venue = listingAbroadVenue(key);
180
+ if (!venue) return key;
181
+ const code = venue === "HKEX" && /^\d{1,5}$/.test(parsed.symbol) && Number(parsed.symbol) > 0
182
+ ? String(Number(parsed.symbol)).padStart(4, "0") : parsed.symbol;
183
+ return `${code}:${venue}`;
184
+ }
185
+
186
+ /** The venues abroad whose listings' own reports Gloom Cloud reads: their exchange's results calendar and announcements. */
187
+ const HISTORY_VENUES_ABROAD: ReadonlySet<string> = new Set(["HKEX", "SGX", "SSE", "SZSE"]);
188
+
189
+ /**
190
+ * How ERN reads a symbol's past reports: by its listing's key, however it was
191
+ * typed (`boardKey`: 0700.HK is 0700:HKEX). A US listing's are the US
192
+ * board's, where SAN is not SAN:EPA's company; a Hong Kong, Singapore or
193
+ * China A listing has its own (`ownAbroad`), which Gloom Cloud reads from its
194
+ * exchange's results calendar and announcements, in their currency. Any other
195
+ * listing abroad has none (`abroad`) and shows its next report. A server that
196
+ * reads only Hong Kong's refuses the others (`noHistoryAbroad`), which then
197
+ * show their next report as before.
198
+ */
199
+ export function historyListing(symbol: string): { listing: string; abroad: boolean; ownAbroad: boolean } {
200
+ const listing = boardKey(symbol);
201
+ const venue = listingAbroadVenue(listing);
202
+ const own = venue != null && HISTORY_VENUES_ABROAD.has(venue);
203
+ return { listing, abroad: venue != null && !own, ownAbroad: own };
169
204
  }
170
205
 
171
206
  /**
@@ -1,11 +1,14 @@
1
+ import { MISSING_VALUE } from "../../../utils/format";
1
2
  import type { DataTableCell, DataTableColumn } from "../../../components";
2
3
  import { withCompanyLogo } from "../../../components/company-logo";
3
4
  import { TABLE_COLUMN_GAP, tableColumnLeadGap, tableColumnWidth } from "../../../components/ui/table-layout";
4
5
  import { colors } from "../../../theme/colors";
6
+ import { notMeaningfulCell } from "../../../components/ui/not-meaningful";
7
+ import { isNotMeaningful } from "../../../utils/growth";
5
8
  import { TextAttributes } from "../../../ui";
6
9
  import { epsBasisShort, showsEpsBasis } from "../shared/earnings-report";
7
10
  import type { BoardReport, BoardRow, BoardSort } from "./board-model";
8
- import { epsText, impliedText, moneyText, moveSize, signedPercent, TIMING_LABEL, weekday } from "./format";
11
+ import { epsText, impliedText, moneyText, moveSize, signedPercent, TIMING_LABEL, weekday, type Surprise } from "./format";
9
12
 
10
13
  type BoardColumnId =
11
14
  | "owned" | "symbol" | "name" | "when" | "status" | "cap" | "ccy" | "epsEstimate" | "analysts" | "epsActual" | "basis"
@@ -126,8 +129,10 @@ export interface BoardCellContext {
126
129
  const NO_CONTEXT: BoardCellContext = { statusShown: true, move: () => null };
127
130
 
128
131
  /** A signed move or surprise, as ERN draws one. */
129
- function signed(value: number | null): DataTableCell {
130
- return { text: signedPercent(value), color: value == null || value === 0 ? colors.textDim : value > 0 ? colors.positive : colors.negative };
132
+ function signed(value: Surprise): DataTableCell {
133
+ // N/M (a surprise against a loss or zero estimate) as every pane draws it; a missing figure dim.
134
+ if (isNotMeaningful(value)) return notMeaningfulCell();
135
+ return { text: signedPercent(value), color: typeof value !== "number" || value === 0 ? colors.textDim : value > 0 ? colors.positive : colors.negative };
131
136
  }
132
137
 
133
138
  export function renderBoardCell(row: BoardRow, column: BoardColumn, context: BoardCellContext = NO_CONTEXT): DataTableCell {
@@ -143,7 +148,7 @@ export function renderBoardCell(row: BoardRow, column: BoardColumn, context: Boa
143
148
  case "name":
144
149
  return withCompanyLogo({ text: report.name, color: colors.text }, report, context.logos === true);
145
150
  case "when": {
146
- const timing = report.timing ? TIMING_LABEL[report.timing] : "--";
151
+ const timing = report.timing ? TIMING_LABEL[report.timing] : MISSING_VALUE;
147
152
  const text = row.showDay ? `${weekday(report.date)} ${timing}` : timing;
148
153
  // An expected time, from the company's last reports, reads quieter than an announced one.
149
154
  if (context.statusShown) return { text, color: report.expectedTiming ? colors.textMuted : dim };
@@ -154,21 +159,21 @@ export function renderBoardCell(row: BoardRow, column: BoardColumn, context: Boa
154
159
  }
155
160
  case "status":
156
161
  // A projected date reads quieter than an announced one, as an expected time does.
157
- return { text: report.dateStatus ?? "--", color: report.dateStatus === "projected" ? colors.textMuted : dim };
162
+ return { text: report.dateStatus ?? MISSING_VALUE, color: report.dateStatus === "projected" ? colors.textMuted : dim };
158
163
  case "cap":
159
164
  return { text: moneyText(report.marketCap), color: dim };
160
165
  case "ccy":
161
- return { text: report.currency ?? "--", color: dim };
166
+ return { text: report.currency ?? MISSING_VALUE, color: dim };
162
167
  case "epsEstimate":
163
168
  return { text: epsText(report.epsEstimate), color: dim };
164
169
  case "analysts":
165
- return { text: report.epsAnalysts == null ? "--" : String(report.epsAnalysts), color: dim };
170
+ return { text: report.epsAnalysts == null ? MISSING_VALUE : String(report.epsAnalysts), color: dim };
166
171
  case "epsActual":
167
172
  // The company's press release's figure reads quieter until the calendar's replaces it.
168
173
  return { text: epsText(report.epsActual), color: report.epsActual == null ? dim : report.provisional ? colors.textMuted : colors.text };
169
174
  case "basis":
170
175
  return !showsEpsBasis(report)
171
- ? { text: "--", color: dim }
176
+ ? { text: MISSING_VALUE, color: dim }
172
177
  : { text: epsBasisShort(report.epsBasis), color: report.epsBasis ? colors.textMuted : dim };
173
178
  case "epsSurprise":
174
179
  return signed(report.epsSurprise);
@@ -18,6 +18,9 @@ import type { EarningsCalendarQuery } from "../../../api-client/earnings";
18
18
  import { useAppSelector, usePaneAppConfig, usePaneSettingValue } from "../../../state/app/context";
19
19
  import { useLiveStreamingSetting } from "../../../state/hooks/live-streaming";
20
20
  import { useAsyncResource, useAutoRefresh, usePluginPaneState, useUpdatedAgo } from "../../../public/react";
21
+ import { useUtcDay } from "../../../react/auto-refresh";
22
+ import { reportFooterSegment } from "../shared/source-footer";
23
+ import { earningsBoardHeadless } from "./headless";
21
24
  import type { EarningsEvent } from "../../../types/data-provider";
22
25
  import { getSharedRegistry } from "../../registry/shared";
23
26
  import { Box, useUiCapabilities } from "../../../ui";
@@ -94,6 +97,8 @@ interface BoardData {
94
97
  /** The query read, by `earningsCalendarKey`: kept data from another week is not this week's. */
95
98
  queryKey: string;
96
99
  reports: BoardReport[];
100
+ /** When the service built the calendar read, which dates the board; null without one. */
101
+ asOf: string | null;
97
102
  stale: boolean;
98
103
  refreshError: string | null;
99
104
  }
@@ -208,7 +213,7 @@ export function EarningsBoard({ focused, width, height, scopedSymbols, highlight
208
213
  const loader = useCallback(async (force: boolean): Promise<BoardData> => {
209
214
  const holdings = fund ? await loadMembers(fund.etf, force) : null;
210
215
  const names = holdings ? fundNames(holdings.payload.members) : named;
211
- if (!market && names.length === 0) return { queryKey, reports: [], stale: !!holdings && (holdings.stale || holdings.payload.stale), refreshError: holdings?.refreshError ?? null };
216
+ if (!market && names.length === 0) return { queryKey, reports: [], asOf: null, stale: !!holdings && (holdings.stale || holdings.payload.stale), refreshError: holdings?.refreshError ?? null };
212
217
  const read = fund ? { ...query, symbols: names } : query;
213
218
  const [cloud, fallback] = await Promise.allSettled([
214
219
  loadEarningsBoard(read, force),
@@ -226,6 +231,7 @@ export function EarningsBoard({ focused, width, height, scopedSymbols, highlight
226
231
  return {
227
232
  queryKey,
228
233
  reports: [...reports, ...extra],
234
+ asOf: cloud.status === "fulfilled" ? cloud.value.payload.asOf : null,
229
235
  stale: (!!holdings && (holdings.stale || holdings.payload.stale)) || (cloud.status === "fulfilled" && cloud.value.stale),
230
236
  refreshError: cloud.status === "rejected"
231
237
  ? (cloud.reason instanceof Error ? cloud.reason.message : String(cloud.reason))
@@ -238,7 +244,7 @@ export function EarningsBoard({ focused, width, height, scopedSymbols, highlight
238
244
  const holdings = fund ? cachedMembers(fund.etf) : null;
239
245
  if (fund && !holdings) return null;
240
246
  const cached = cachedEarningsCalendar(holdings ? { ...query, symbols: fundNames(holdings.payload.members) } : query);
241
- return cached ? { queryKey, reports: cached.payload.reports.map((report) => boardReport(report, owned)), stale: !!holdings?.payload.stale, refreshError: null } : null;
247
+ return cached ? { queryKey, reports: cached.payload.reports.map((report) => boardReport(report, owned)), asOf: cached.payload.asOf, stale: !!holdings?.payload.stale, refreshError: null } : null;
242
248
  },
243
249
  });
244
250
  // A new fund or range never shows the previous scope while its holdings load or fail.
@@ -316,13 +322,19 @@ export function EarningsBoard({ focused, width, height, scopedSymbols, highlight
316
322
 
317
323
  useAutoRefresh(resource.updatedAt, resource.load);
318
324
  const updatedAgo = useUpdatedAgo(resource.updatedAt);
325
+ const utcDay = useUtcDay();
326
+ // Its source and when the calendar was read, as `fn EVTS` ends; how long ago it loaded goes first on a narrow row.
327
+ const footerInfo = useMemo(() => data ? [
328
+ reportFooterSegment(earningsBoardHeadless, { rows: [], metadata: { asOf: data.asOf } }),
329
+ ...(updatedAgo ? [ageFooterSegment(updatedAgo)] : []),
330
+ ] : [], [data, updatedAgo, utcDay]);
319
331
  usePaneStatusFooter({
320
332
  registrationId: "earnings-board",
321
333
  enabled: !open,
322
334
  loading: resource.loading,
323
335
  error: resource.error ?? data?.refreshError ?? null,
324
336
  stale: !!data?.stale,
325
- info: data && updatedAgo ? [ageFooterSegment(updatedAgo)] : [],
337
+ info: footerInfo,
326
338
  });
327
339
  const symbol = open?.symbol ?? selectedReport?.symbol ?? null;
328
340
  // The desktop and the web only: the terminal's footer stays as it was.
@@ -32,7 +32,7 @@ export interface CalendarDay {
32
32
  date: string;
33
33
  /** "Mon" */
34
34
  weekday: string;
35
- /** "Oct 20" */
35
+ /** "20 Oct" */
36
36
  label: string;
37
37
  today: boolean;
38
38
  /** No NYSE session that day. */
@@ -54,7 +54,7 @@ export function calendarWeekDates(today: string, offset: number): string[] {
54
54
  return [0, 1, 2, 3, 4].map((index) => addDays(start, index));
55
55
  }
56
56
 
57
- /** "Last week", "This week", "Next week", then "Week of Nov 3". */
57
+ /** "Last week", "This week", "Next week", then "Week of 3 Nov". */
58
58
  export function calendarWeekLabel(today: string, offset: number): string {
59
59
  if (offset === -1) return "Last week";
60
60
  if (offset === 0) return "This week";
@@ -104,7 +104,7 @@ export function boardRangeWeek(range: BoardRange, today: string): number {
104
104
  return Math.round((Date.parse(mondayOf(range)) - Date.parse(mondayOf(today))) / (7 * 86_400_000));
105
105
  }
106
106
 
107
- /** A day of a week or the day asked for: "Today" for today, otherwise "Thu Oct 15". */
107
+ /** A day of a week or the day asked for: "Today" for today, otherwise "Thu 15 Oct". */
108
108
  function dayLabel(date: string, today: string): string {
109
109
  return date === today ? "Today" : `${weekday(date)} ${shortDate(date)}`;
110
110
  }
@@ -120,13 +120,13 @@ export function boardRangeDays(range: BoardRange, today: string): MarketDay[] {
120
120
  return calendarWeekDates(today, Number(range)).map((date) => ({ label: dayLabel(date, today), from: date, to: date }));
121
121
  }
122
122
 
123
- /** What the range reads as: "Last week", "Week of Nov 2", "Thu Oct 15", or null for the days ahead. */
123
+ /** What the range reads as: "Last week", "Week of 2 Nov", "Thu 15 Oct", or null for the days ahead. */
124
124
  export function boardRangeLabel(range: BoardRange, today: string): string | null {
125
125
  if (ISO_DAY.test(range)) return dayLabel(range, today);
126
126
  return WEEK_OFFSET.test(range) ? calendarWeekLabel(today, Number(range)) : null;
127
127
  }
128
128
 
129
- /** The range in a sentence ("No reports … last week"): "today", "on Thu Oct 15", "in the week of Nov 2"; null for the days ahead. */
129
+ /** The range in a sentence ("No reports … last week"): "today", "on Thu 15 Oct", "in the week of 2 Nov"; null for the days ahead. */
130
130
  export function boardRangeWords(range: BoardRange, today: string): string | null {
131
131
  if (ISO_DAY.test(range)) return range === today ? "today" : `on ${dayLabel(range, today)}`;
132
132
  if (!WEEK_OFFSET.test(range)) return null;