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
@@ -1,4 +1,6 @@
1
+ import { MISSING_VALUE } from "./format";
1
2
  import { toTimestampMillis } from "./timestamp";
3
+ import { timeZoneLabel } from "./zoned-date-time";
2
4
 
3
5
  export type DisplayDateValue = Date | string | number | null | undefined;
4
6
 
@@ -22,7 +24,7 @@ function elapsedUnits(ageMs: number): { count: number; unit: "m" | "h" | "d" } |
22
24
  }
23
25
 
24
26
  /** Age for a narrow column: "<1m", "5m", "3h", "2d". */
25
- export function formatRelativeTime(value: DisplayDateValue, now = Date.now(), fallback = "-"): string {
27
+ export function formatRelativeTime(value: DisplayDateValue, now = Date.now(), fallback = MISSING_VALUE): string {
26
28
  const date = parseDisplayDate(value);
27
29
  if (!date) return fallback;
28
30
 
@@ -51,9 +53,6 @@ export function formatCountdown(ms: number): string {
51
53
 
52
54
  // Reuse the locale formatter when a feed contains older items. Constructing
53
55
  // one for every row dominates opening a long transcript, even without edits.
54
- const olderRelativeDateFormatter = new Intl.DateTimeFormat("en-US", {
55
- month: "numeric", day: "numeric", year: "2-digit",
56
- });
57
56
 
58
57
  /**
59
58
  * Relative time that turns into a date ("1/5/26") after a week, for feeds read
@@ -66,15 +65,17 @@ export function formatTimeAgo(date: Date | string, { short = false }: { short?:
66
65
  const elapsed = elapsedUnits(Date.now() - ts);
67
66
  if (!elapsed) return short ? "<1m" : "just now";
68
67
  if (elapsed.unit === "d" && elapsed.count >= 7) {
69
- return olderRelativeDateFormatter.format(ts);
68
+ // As a feed writes a day past the week: "5 Nov", "5 Nov '25" in another year, never "11/5/26".
69
+ const date = new Date(ts);
70
+ return formatShortDate(date, { year: date.getFullYear() === new Date().getFullYear() ? false : "2-digit" });
70
71
  }
71
72
  return `${elapsed.count}${elapsed.unit}${short ? "" : " ago"}`;
72
73
  }
73
74
 
74
75
  export interface ShortDateOptions {
75
- /** "Jan 5, 2026" (the default), "Jan 5, 26", or no year at all ("Jan 5"). */
76
+ /** "5 Jan 2026" (the default), "5 Jan '26" as option expiries write it, or no year at all ("5 Jan"). */
76
77
  year?: "numeric" | "2-digit" | false;
77
- /** "2-digit" pads the day so dates line up in a column ("Jan 05"). */
78
+ /** "2-digit" pads the day so dates line up in a column ("05 Jan"). */
78
79
  day?: "numeric" | "2-digit";
79
80
  /** Read the day in UTC, for date-only values that name a calendar day rather than an instant. */
80
81
  utc?: boolean;
@@ -84,10 +85,20 @@ export interface ShortDateOptions {
84
85
 
85
86
  const shortDateFormatters = new Map<string, Intl.DateTimeFormat>();
86
87
 
87
- /** A month-name date such as "Jan 5, 2026", in local time unless `utc` is set. */
88
+ /**
89
+ * A formatter's date written day first ("Fri 5 Jan 2026"). A two-digit year
90
+ * takes an apostrophe ("5 Jan '26"), so it never reads as another day.
91
+ */
92
+ export function dayFirstParts(formatter: Intl.DateTimeFormat, date: Date): string {
93
+ const parts = Object.fromEntries(formatter.formatToParts(date).map((part) => [part.type, part.value]));
94
+ const year = parts.year ? ` ${parts.year.length === 2 ? `'${parts.year}` : parts.year}` : "";
95
+ return `${parts.weekday ? `${parts.weekday} ` : ""}${parts.day} ${parts.month}${year}`;
96
+ }
97
+
98
+ /** A day-first month-name date such as "5 Jan 2026", in local time unless `utc` is set. */
88
99
  export function formatShortDate(value: DisplayDateValue, options: ShortDateOptions = {}): string {
89
100
  const date = parseDisplayDate(value);
90
- if (!date) return options.fallback ?? "-";
101
+ if (!date) return options.fallback ?? MISSING_VALUE;
91
102
  const { year = "numeric", day = "numeric", utc = false } = options;
92
103
  const key = `${year}:${day}:${utc}`;
93
104
  let formatter = shortDateFormatters.get(key);
@@ -100,11 +111,26 @@ export function formatShortDate(value: DisplayDateValue, options: ShortDateOptio
100
111
  });
101
112
  shortDateFormatters.set(key, formatter);
102
113
  }
103
- return formatter.format(date);
114
+ return dayFirstParts(formatter, date);
115
+ }
116
+
117
+ const weekdayDayFormatters = new Map<string, Intl.DateTimeFormat>();
118
+
119
+ /** A weekday and day-first date ("Fri 16 Oct"), with a year only when asked for. */
120
+ export function formatWeekdayDay(value: DisplayDateValue, { timeZone, year = false }: { timeZone?: string; year?: boolean } = {}): string {
121
+ const date = parseDisplayDate(value);
122
+ if (!date) return MISSING_VALUE;
123
+ const key = `${timeZone ?? ""}:${year}`;
124
+ let formatter = weekdayDayFormatters.get(key);
125
+ if (!formatter) {
126
+ formatter = new Intl.DateTimeFormat("en-US", { weekday: "short", day: "numeric", month: "short", year: year ? "numeric" : undefined, timeZone });
127
+ weekdayDayFormatters.set(key, formatter);
128
+ }
129
+ return dayFirstParts(formatter, date);
104
130
  }
105
131
 
106
132
  /**
107
- * The day a filing is dated, as the agency and the filer write it: "Nov 04,
133
+ * The day a filing is dated, as the agency and the filer write it: "04 Nov
108
134
  * 2026", the day padded so a column of them lines up. A calendar day, read in
109
135
  * UTC, so it never moves with the viewer's zone: give it the filing date
110
136
  * (`2026-11-04`, or that day at midnight UTC), not an acceptance instant,
@@ -151,14 +177,14 @@ function utcMidnight(date: Date): number {
151
177
  /**
152
178
  * When a feed item was published, in local time, as a newswire prints it:
153
179
  * the time today ("14:32"), the weekday and time over the six days before
154
- * ("Mon 09:10"), and the date for anything older ("Sep 18", or "Sep 18, 25"
180
+ * ("Mon 09:10"), and the date for anything older ("18 Sep", or "18 Sep '25"
155
181
  * in another year). A weekday never names a day a week or more back. With
156
182
  * `utc`, the same in UTC, for a column whose header names the zone.
157
183
  */
158
184
  export function formatFeedTime(
159
185
  value: DisplayDateValue,
160
186
  now = Date.now(),
161
- fallback = "-",
187
+ fallback = MISSING_VALUE,
162
188
  { utc = false, dayToday = false }: {
163
189
  utc?: boolean;
164
190
  /** Today's time carries its weekday too ("Sat 00:47"), for a column whose other rows name theirs ("Fri 21:00"). */
@@ -178,42 +204,57 @@ export function formatFeedTime(
178
204
  }
179
205
 
180
206
  /**
181
- * A date and time in the host's zone, with the zone named: "Oct 7, 2026 at
182
- * 11:38 PM GMT+2", "... 5:38 PM EDT", "... 9:38 PM UTC". Without the zone a
207
+ * A date and time in the host's zone, with the zone named: "7 Oct 2026,
208
+ * 23:38 CET", "... 17:38 ET", "... 21:38 UTC". Without the zone a
183
209
  * time read beside a list in UTC looks two hours off.
184
210
  */
185
- export function formatDetailDate(value: DisplayDateValue, fallback = "-", timeZone?: string): string {
211
+ export function formatDetailDate(value: DisplayDateValue, fallback = MISSING_VALUE, timeZone?: string): string {
186
212
  const date = parseDisplayDate(value);
187
213
  if (!date) return fallback;
188
214
 
189
- const datePart = date.toLocaleDateString("en-US", {
215
+ const datePart = dayFirstParts(new Intl.DateTimeFormat("en-US", {
190
216
  month: "short",
191
217
  day: "numeric",
192
218
  year: "numeric",
193
219
  timeZone,
194
- });
195
- return `${datePart} at ${formatDetailTime(date, fallback, timeZone)}`;
220
+ }), date);
221
+ return `${datePart}, ${formatDetailTime(date, fallback, timeZone)}`;
196
222
  }
197
223
 
198
224
  /**
199
- * The host's zone as a time beside it names it ("GMT+8", "EDT", "UTC"), for a
200
- * column header over times in that zone ("TIME GMT+8"), as `formatDetailTime`
201
- * names it after one time.
225
+ * The host's zone as a time beside it names it, for a column header over times
226
+ * in that zone ("TIME CET"), as `formatDetailTime` names it after one time:
227
+ * the name the charts and session lines give it at that time ("UTC", "ET",
228
+ * "CET" or "CEST", "JST", else the city). News read "TIME GMT+1" over a
229
+ * chart's "CET" (review, 12 Nov 2026).
202
230
  */
203
231
  export function localTimeZoneShortName(now: DisplayDateValue = Date.now(), timeZone?: string): string {
204
- const date = parseDisplayDate(now) ?? new Date();
205
- return new Intl.DateTimeFormat("en-US", { timeZoneName: "short", timeZone }).formatToParts(date)
206
- .find((part) => part.type === "timeZoneName")?.value ?? "UTC";
232
+ const zone = timeZone ?? new Intl.DateTimeFormat().resolvedOptions().timeZone ?? "UTC";
233
+ return timeZoneLabel(zone, (parseDisplayDate(now) ?? new Date()).getTime());
207
234
  }
208
235
 
209
- /** The time of `formatDetailDate` alone, its zone named: "11:38 PM GMT+2", for a day stated beside it. */
210
- export function formatDetailTime(value: DisplayDateValue, fallback = "-", timeZone?: string): string {
236
+ const zonedClockFormatters = new Map<string, Intl.DateTimeFormat>();
237
+
238
+ /**
239
+ * A time of day on the 24-hour clock every pane reads ("09:05", "23:38"), in
240
+ * the host's zone unless `timeZone` is given. Never AM/PM: one footer read
241
+ * "8:30 AM" beside another's "14:32" (review, 12 Nov 2026).
242
+ */
243
+ export function formatClockTime(value: DisplayDateValue, fallback = MISSING_VALUE, timeZone?: string): string {
211
244
  const date = parseDisplayDate(value);
212
245
  if (!date) return fallback;
213
- return date.toLocaleTimeString("en-US", {
214
- hour: "numeric",
215
- minute: "2-digit",
216
- timeZoneName: "short",
217
- timeZone,
218
- });
246
+ if (!timeZone) return clockFormatter.format(date);
247
+ let formatter = zonedClockFormatters.get(timeZone);
248
+ if (!formatter) {
249
+ formatter = new Intl.DateTimeFormat("en-US", { hour: "2-digit", minute: "2-digit", hourCycle: "h23", timeZone });
250
+ zonedClockFormatters.set(timeZone, formatter);
251
+ }
252
+ return formatter.format(date);
253
+ }
254
+
255
+ /** The time of `formatDetailDate` alone, its zone named: "23:38 CET", for a day stated beside it. */
256
+ export function formatDetailTime(value: DisplayDateValue, fallback = MISSING_VALUE, timeZone?: string): string {
257
+ const date = parseDisplayDate(value);
258
+ if (!date) return fallback;
259
+ return `${formatClockTime(date, fallback, timeZone)} ${localTimeZoneShortName(date, timeZone)}`;
219
260
  }
@@ -31,6 +31,8 @@ export interface DoubleEscapeCloseState {
31
31
  streamAt: number;
32
32
  /** The last Esc that armed, closed or looked like a repeat. */
33
33
  pressAt: number;
34
+ /** The last Esc that closed a window on its own (`takeSingleEscapeClose`), until the Esc after it. */
35
+ singleClosedAt: number;
34
36
  }
35
37
 
36
38
  export function createDoubleEscapeCloseState(): DoubleEscapeCloseState {
@@ -39,12 +41,14 @@ export function createDoubleEscapeCloseState(): DoubleEscapeCloseState {
39
41
  targetId: null,
40
42
  streamAt: Number.NEGATIVE_INFINITY,
41
43
  pressAt: Number.NEGATIVE_INFINITY,
44
+ singleClosedAt: Number.NEGATIVE_INFINITY,
42
45
  };
43
46
  }
44
47
 
45
48
  export function resetDoubleEscapeClose(state: DoubleEscapeCloseState) {
46
49
  state.lastAt = 0;
47
50
  state.targetId = null;
51
+ state.singleClosedAt = Number.NEGATIVE_INFINITY;
48
52
  }
49
53
 
50
54
  /**
@@ -81,6 +85,44 @@ function isHeldEscape(state: DoubleEscapeCloseState, now: number, repeat: boolea
81
85
  && now - state.streamAt < HELD_ESCAPE_STALL_MS;
82
86
  }
83
87
 
88
+ /**
89
+ * Whether an Esc is a held key rather than a press: the host's repeat, or one
90
+ * that comes as fast as a held key's while a stream is live. Read before the
91
+ * Esc arms anything, since arming moves the last press to it.
92
+ */
93
+ export function isHeldEscapePress(state: DoubleEscapeCloseState, now: number, repeat?: boolean): boolean {
94
+ return repeat === true || isHeldEscape(state, now, repeat);
95
+ }
96
+
97
+ /**
98
+ * One Esc nothing else took closes a floating window on its own. Call it once
99
+ * the window closed, for a press that was not held (`isHeldEscapePress`): the
100
+ * Esc a double press sends after it closes nothing more
101
+ * (`swallowEscapeAfterSingleClose`), so Esc Esc still closes one window, and
102
+ * a held key, as after a double close, goes on closing nothing.
103
+ */
104
+ export function takeSingleEscapeClose(state: DoubleEscapeCloseState, now: number) {
105
+ resetDoubleEscapeClose(state);
106
+ state.streamAt = now;
107
+ state.pressAt = now;
108
+ state.singleClosedAt = now;
109
+ }
110
+
111
+ /**
112
+ * The Esc right after one that closed a window on its own, at a double
113
+ * press's pace: the second half of a pair whose first half already closed.
114
+ * It is taken, and reaches nothing. A host's repeat is left to the held-key
115
+ * rules.
116
+ */
117
+ export function swallowEscapeAfterSingleClose(state: DoubleEscapeCloseState, now: number, repeat?: boolean): boolean {
118
+ if (repeat === true || now - state.singleClosedAt > DOUBLE_ESCAPE_CLOSE_MS) return false;
119
+ state.singleClosedAt = Number.NEGATIVE_INFINITY;
120
+ resetDoubleEscapeClose(state);
121
+ state.streamAt = now;
122
+ state.pressAt = now;
123
+ return true;
124
+ }
125
+
84
126
  interface EscapeOffer {
85
127
  count(): void;
86
128
  keep(): void;
@@ -214,15 +214,16 @@ const yearAfter = (day: string) => `${Number(day.slice(0, 4)) + 1}${day.slice(4,
214
214
  * When a filled row's figures were published or read: ASX's read, or for a
215
215
  * row from the company's results announcements:
216
216
  * - its own results: the first of its documents published after its period
217
- * ended and before the same period a year on did (a trailing twelve months
218
- * to a half also lists the year's documents, which came out before the half
219
- * did: it is dated by the half's results);
220
- * - a comparative: every document came out after the same period a year on
221
- * ended, so the lines are that later period's comparative column (H1 FY25
222
- * in the 2026 interim report). It is dated by the later period's first
223
- * announcement: the row a year on in `rows` where there is one, else the
224
- * first results announcement among its documents, never a report published
225
- * after them (null when there is neither).
217
+ * ended and before the next period did: the next row of `rows`, else the
218
+ * same period a year on (a trailing twelve months to a half also lists the
219
+ * year's documents, which came out before the half did: it is dated by the
220
+ * half's results);
221
+ * - a comparative: every document came out after that next period ended, so
222
+ * the lines are its comparative column (H1 FY25 in the 2026 interim report,
223
+ * HSBC's 2Q25 in its 3Q25 earnings release). It is dated by the later
224
+ * period's first announcement: that row in `rows` where there is one, else
225
+ * the first results announcement among its documents, never a report
226
+ * published after them (null when there is neither).
226
227
  */
227
228
  export function fillDate(row: FilledRow, rows: readonly FilledRow[] = []): FillDate | null {
228
229
  const fill = row.filledFrom;
@@ -231,17 +232,24 @@ export function fillDate(row: FilledRow, rows: readonly FilledRow[] = []): FillD
231
232
  if (fill.fields.length === 0) return null;
232
233
  const periodEnd = (row.aggregation?.periodEnd ?? row.date).slice(0, 10);
233
234
  const dates = fill.documents.map((document) => document.publishedAt.slice(0, 10)).sort();
234
- const later = yearAfter(periodEnd);
235
+ // A quarter's announcement also gives the quarter before: the next period is the list's next row where it
236
+ // has one before the same period a year on. A quarter derived from two years to date ends with the later
237
+ // one, which its own announcement gives, however late it came out.
238
+ const yearOn = yearAfter(periodEnd);
239
+ const next = rows.map((candidate) => candidate.date.slice(0, 10))
240
+ .filter((end) => /^\d{4}-\d{2}-\d{2}$/.test(end) && end > periodEnd && !areNearbyFinancialPeriodEnds(end, periodEnd))
241
+ .sort()[0];
242
+ const later = next && next < yearOn && !(fill.source === "results" && fill.derived) ? next : yearOn;
235
243
  const own = dates.find((date) => date >= periodEnd && date <= later);
236
244
  if (own || row.aggregation || dates.length === 0 || !dates.every((date) => date > later)) {
237
245
  return { label: "published", date: own ?? dates.find((date) => date >= periodEnd) ?? dates[0] ?? null };
238
246
  }
239
247
  const months = statementPeriodMonths(row);
240
- const next = rows.find((candidate) => candidate !== row && !candidate.aggregation
248
+ const laterRow = rows.find((candidate) => candidate !== row && !candidate.aggregation
241
249
  && candidate.filledFrom?.source === "results"
242
250
  && areNearbyFinancialPeriodEnds(candidate.date.slice(0, 10), later)
243
251
  && statementPeriodMonths(candidate) === months);
244
- const nextDate = next ? fillDate(next) : null;
252
+ const nextDate = laterRow ? fillDate(laterRow, rows) : null;
245
253
  const announcement = fill.documents.filter((document) => document.kind.endsWith("_results"))
246
254
  .map((document) => document.publishedAt.slice(0, 10)).sort()[0];
247
255
  return {
@@ -293,8 +301,9 @@ export function filledPeriodPublications(
293
301
  * does not have them yet, newest first, with the lines taken. A period read
294
302
  * from the company's results announcement is dated by its publication ("6
295
303
  * months to 2026-06-30 revenue, net income (published 2026-08-20)"), each
296
- * day said once for the periods it dates. `shown` keeps the lines the table
297
- * has a row for. Null when no shown line was filled.
304
+ * day said once for the periods it dates. A line left blank because the
305
+ * announcements count it otherwise (`omitted`) says so. `shown` keeps the
306
+ * lines the table has a row for. Null when no shown line was filled.
298
307
  */
299
308
  export function filledPeriodsNote(
300
309
  statements: readonly FilledRow[],
@@ -318,7 +327,22 @@ export function filledPeriodsNote(
318
327
  const read = filled.map(({ stamp }) => stamp.date).sort().at(-1);
319
328
  note = `From ${sources.join(" and ")} (read ${read}): ${filled.map(({ period, fields }) => `${period} ${fields.join(", ")}`).join("; ")}.`;
320
329
  }
321
- return trailing ? `${note} ${trailing}` : note;
330
+ return [note, omittedLinesNote(statements, shown), trailing].filter(Boolean).join(" ");
331
+ }
332
+
333
+ /** "2026-09-30, 2026-06-30 revenue left blank: the company's results announcements count it otherwise than the statements source." */
334
+ function omittedLinesNote(statements: readonly FilledRow[], shown?: ReadonlySet<string>): string | null {
335
+ const ends = new Map<string, string[]>();
336
+ for (const { date, filledFrom } of statements) {
337
+ if (filledFrom?.source !== "results" || date === "TTM") continue;
338
+ for (const field of filledFrom.omitted ?? []) {
339
+ if (!FILL_FIELDS[field] || (shown && !shown.has(field))) continue;
340
+ ends.set(FILL_FIELDS[field], [...ends.get(FILL_FIELDS[field]) ?? [], date.slice(0, 10)]);
341
+ }
342
+ }
343
+ if (ends.size === 0) return null;
344
+ const lines = [...ends].map(([line, dates]) => `${[...new Set(dates)].sort().reverse().join(", ")} ${line}`).join("; ");
345
+ return `${lines} left blank: the company's results announcements count ${ends.size > 1 ? "them" : "it"} otherwise than the statements source.`;
322
346
  }
323
347
 
324
348
  /**
@@ -240,7 +240,7 @@ export function significantDecimals(value: number, digits = 4): number {
240
240
 
241
241
  /** A percentile rank with its window: "73 pctl 1Y", "-- pctl 1Y" when unranked, "73 pctl" without a window. */
242
242
  export function formatPercentileRank(value: number | null | undefined, window?: string): string {
243
- const rank = value == null || !Number.isFinite(value) ? "--" : value.toFixed(0);
243
+ const rank = value == null || !Number.isFinite(value) ? MISSING_VALUE : value.toFixed(0);
244
244
  return window ? `${rank} pctl ${window}` : `${rank} pctl`;
245
245
  }
246
246
 
@@ -371,17 +371,12 @@ function truncateToWidth(value: string, width: number): string {
371
371
  return output;
372
372
  }
373
373
 
374
+ /** Cuts to a display width behind one `…`, as clipToDisplayWidth does: every cut text ends the same way. */
374
375
  export function truncateToDisplayWidth(value: string, width: number): string {
375
- if (width <= 0) return "";
376
- if (displayWidth(value) <= width) return value;
377
- if (width <= 3) return ".".repeat(width);
378
- return `${truncateToWidth(value, width - 3)}...`;
376
+ return clipToDisplayWidth(value, width);
379
377
  }
380
378
 
381
- /**
382
- * Clips to a display width behind a single `…`, which gives a narrow cell back
383
- * two characters that `...` would spend on the marker.
384
- */
379
+ /** Clips to a display width behind a single `…`, the one cell every cut text ends with. */
385
380
  export function clipToDisplayWidth(value: string, width: number): string {
386
381
  if (width <= 0) return "";
387
382
  if (displayWidth(value) <= width) return value;
@@ -29,37 +29,59 @@ export function redactUnavailableFundamentals(value: Fundamentals | undefined):
29
29
  * Its reported cash flow stays as reported.
30
30
  */
31
31
  export const BANK_ENTERPRISE_VALUE = "n/m for banks";
32
+ /**
33
+ * An insurer's: its float (the policyholders' money it invests) is its business, not debt or spare cash, so market
34
+ * cap + debt - cash says nothing of what the business is worth.
35
+ */
36
+ export const INSURER_ENTERPRISE_VALUE = "n/m for insurers";
37
+ const FINANCIAL_ENTERPRISE_VALUES: ReadonlySet<string> = new Set([BANK_ENTERPRISE_VALUE, INSURER_ENTERPRISE_VALUE]);
38
+
39
+ /**
40
+ * Why a financial company's EV is not meaningful, by its industry: a bank ("Banks - Diversified") or an insurer
41
+ * ("Insurance - Life", "Insurance - Property & Casualty", "Insurance - Reinsurance"; not an insurance broker). Null
42
+ * for any other industry. "Capital Markets" is no test: beside dealers (Goldman Sachs, CITIC Securities) it holds
43
+ * advisers, trading venues and bitcoin miners whose EV measures their business (Evercore, Houlihan Lokey,
44
+ * MarketAxess, Tradeweb, Riot Platforms), so their EV is shown as the source serves it.
45
+ */
46
+ export function financialEnterpriseValueReason(industry: string | null | undefined): string | null {
47
+ const text = industry ?? "";
48
+ if (/\bbanks?\b/i.test(text)) return BANK_ENTERPRISE_VALUE;
49
+ if (/\b(?:insurance|reinsurance|insurers?)\b/i.test(text) && !/\bbrokers?\b/i.test(text)) return INSURER_ENTERPRISE_VALUE;
50
+ return null;
51
+ }
32
52
 
33
- /** A bank by its industry ("Banks - Diversified", "Banks - Regional"), as the Bank section and its EV read one. */
34
- function isBankIndustry(industry: string | null | undefined): boolean {
35
- return /\bbanks?\b/i.test(industry ?? "");
53
+ /** Whether a reason is a financial company's (financialEnterpriseValueReason). */
54
+ export function isFinancialEnterpriseValueReason(reason: string | null | undefined): boolean {
55
+ return FINANCIAL_ENTERPRISE_VALUES.has(reason ?? "");
36
56
  }
37
57
 
38
58
  /**
39
- * A bank's fundamentals with its EV and EV/revenue not meaningful
40
- * (`BANK_ENTERPRISE_VALUE`), the source's figure kept on the check: every view
41
- * that reads an EV then reads N/M. Any other company's as they are.
59
+ * A bank's or an insurer's fundamentals with its EV and EV/revenue not meaningful
60
+ * (financialEnterpriseValueReason), the source's figure kept on the check: every view that reads an EV then reads
61
+ * N/M. Where the source gave one, or withdrew the one it had (an EV line is shown either way); a company the source
62
+ * gave none for shows no line, as before. Any other company's as they are.
42
63
  */
43
- export function withBankEnterpriseValue<F extends Fundamentals | undefined>(
64
+ export function withFinancialEnterpriseValue<F extends Fundamentals | undefined>(
44
65
  fundamentals: F,
45
66
  profile: { industry?: string | null } | null | undefined,
46
67
  ): F {
47
- if (!fundamentals || !isBankIndustry(profile?.industry)) return fundamentals;
68
+ const reason = financialEnterpriseValueReason(profile?.industry);
69
+ if (!fundamentals || !reason) return fundamentals;
48
70
  const { enterpriseValue: _value, enterpriseToRevenue: _ratio, ...rest } = fundamentals;
49
71
  const source = servedEnterpriseValue(fundamentals) ?? fundamentals.enterpriseValueCheck?.source;
50
- // Only where an EV would be shown: a bank the source gave none for shows no line, as before.
51
- if (!finiteNumber(source)) return fundamentals;
72
+ if (!finiteNumber(source) && !fundamentals.unavailableFields?.includes("enterpriseValue")) return fundamentals;
52
73
  const withdrawn = new Set([...fundamentals.unavailableFields ?? [], "enterpriseValue" as const, "enterpriseToRevenue" as const]);
53
74
  return {
54
75
  ...rest,
55
76
  unavailableFields: [...withdrawn],
56
- enterpriseValueCheck: { status: "not-meaningful", ...finiteNumber(source) ? { source } : {}, reason: BANK_ENTERPRISE_VALUE },
77
+ enterpriseValueCheck: { status: "not-meaningful", ...finiteNumber(source) ? { source } : {}, reason },
57
78
  } as F;
58
79
  }
59
80
 
60
- /** Whether a not meaningful EV is so because the company is a bank (`withBankEnterpriseValue`). */
61
- export function isBankEnterpriseValue(fundamentals: Parameters<typeof enterpriseValueCheck>[0]): boolean {
62
- return enterpriseValueNotMeaningful(fundamentals) === BANK_ENTERPRISE_VALUE;
81
+ /** Why a not meaningful EV is so because of what the company is (withFinancialEnterpriseValue): a bank or an insurer; null otherwise. */
82
+ export function financialEnterpriseValue(fundamentals: Parameters<typeof enterpriseValueCheck>[0]): string | null {
83
+ const reason = enterpriseValueNotMeaningful(fundamentals);
84
+ return reason && isFinancialEnterpriseValueReason(reason) ? reason : null;
63
85
  }
64
86
 
65
87
  /** The enterprise value as served, or undefined when it has none: banks and insurers come back as 0, which is a gap, not a value. */
@@ -242,8 +264,8 @@ export function enterpriseValueReconciliationNote(
242
264
  statements?: BalanceSheets,
243
265
  ): string | undefined {
244
266
  const notMeaningful = enterpriseValueNotMeaningful(fundamentals);
245
- // A bank's EV line says it all: "n/m for banks".
246
- if (notMeaningful === BANK_ENTERPRISE_VALUE) return undefined;
267
+ // A bank's or an insurer's EV line says it all: "n/m for banks".
268
+ if (isFinancialEnterpriseValueReason(notMeaningful)) return undefined;
247
269
  if (notMeaningful) return `EV N/M: ${notMeaningful.charAt(0).toLowerCase()}${notMeaningful.slice(1)}.`;
248
270
  const check = enterpriseValueCheck(fundamentals);
249
271
  if (!check && enterpriseValueWithdrawn(fundamentals)) return "EV unavailable: the provider's figure failed validation.";
@@ -7,8 +7,19 @@ export interface FxRateStatus {
7
7
  unknownTime: number;
8
8
  oldestAsOf: number | null;
9
9
  latestFetchedAt: number | null;
10
+ /** The pairs counted as unavailable and as stale (`TRY/USD`), so a label names them. */
11
+ unavailablePairs?: string[];
12
+ stalePairs?: string[];
13
+ /** The pair whose rate is the oldest (`oldestAsOf`). */
14
+ oldestPair?: string | null;
10
15
  }
11
16
 
17
+ /** A currency's rate as the pair it is read as: every rate is against the US dollar. */
18
+ const usdPair = (currency: string) => `${currency}/USD`;
19
+
20
+ /** Up to this many pairs are named; more are counted. */
21
+ const NAMED_PAIRS = 3;
22
+
12
23
  /** A rate whose last load failed, or whose observation is past its stale time. */
13
24
  export function isFxRateStale(entry: QueryEntry<number> | null | undefined, now = Date.now()): boolean {
14
25
  return Boolean(entry?.error || (entry?.staleAt != null && entry.staleAt <= now));
@@ -21,27 +32,39 @@ export function summarizeFxRates(
21
32
  read: (currency: string) => QueryEntry<number> | null | undefined,
22
33
  now = Date.now(),
23
34
  ): FxRateStatus {
24
- const status: FxRateStatus = { loading: 0, unavailable: 0, stale: 0, unknownTime: 0, oldestAsOf: null, latestFetchedAt: null };
35
+ const status: FxRateStatus = { loading: 0, unavailable: 0, stale: 0, unknownTime: 0, oldestAsOf: null, latestFetchedAt: null,
36
+ unavailablePairs: [], stalePairs: [], oldestPair: null };
25
37
  for (const currency of new Set(currencies.map((value) => value.trim().toUpperCase()))) {
26
38
  if (currency === "USD") continue;
27
39
  const entry = read(currency);
28
40
  if (entry?.phase === "loading" || entry?.phase === "refreshing") status.loading++;
29
41
  const rate = rates.get(currency);
30
- if (rate == null || !Number.isFinite(rate) || rate <= 0) { status.unavailable++; continue; }
42
+ if (rate == null || !Number.isFinite(rate) || rate <= 0) { status.unavailable++; status.unavailablePairs!.push(usdPair(currency)); continue; }
31
43
  // A legacy persisted numeric rate may be present without a dated query.
32
44
  if (!entry || entry.asOf == null || !Number.isFinite(entry.asOf)) status.unknownTime++;
33
- else status.oldestAsOf = Math.min(status.oldestAsOf ?? Infinity, entry.asOf);
34
- if (isFxRateStale(entry, now)) status.stale++;
45
+ else if (status.oldestAsOf == null || entry.asOf < status.oldestAsOf) {
46
+ status.oldestAsOf = entry.asOf;
47
+ status.oldestPair = usdPair(currency);
48
+ }
49
+ if (isFxRateStale(entry, now)) { status.stale++; status.stalePairs!.push(usdPair(currency)); }
35
50
  if (entry?.fetchedAt != null) status.latestFetchedAt = Math.max(status.latestFetchedAt ?? 0, entry.fetchedAt);
36
51
  }
37
52
  return status;
38
53
  }
39
54
 
55
+ /** `TRY/USD` or `TRY/USD, EGP/USD` when few enough are named, else their count. */
56
+ function pairsText(count: number, pairs: readonly string[] | undefined): string {
57
+ return pairs && pairs.length === count && count <= NAMED_PAIRS ? pairs.join(", ") : String(count);
58
+ }
59
+
60
+ /** `TRY/USD stale · oldest rate TRY/USD 2026-11-12 03:49 UTC`: each pair named, as a footer has room for, else counted. */
40
61
  export function fxStatusLabel(status: FxRateStatus): string {
41
62
  const parts: string[] = [];
42
- if (status.unavailable) parts.push(`${status.unavailable} unavailable`);
43
- if (status.stale) parts.push(`${status.stale} stale`);
63
+ if (status.unavailable) parts.push(`${pairsText(status.unavailable, status.unavailablePairs)} unavailable`);
64
+ if (status.stale) parts.push(`${pairsText(status.stale, status.stalePairs)} stale`);
44
65
  if (status.unknownTime) parts.push(`${status.unknownTime} rate ${status.unknownTime === 1 ? "time" : "times"} unknown`);
45
- if (status.oldestAsOf != null) parts.push(`oldest rate ${new Date(status.oldestAsOf).toISOString().slice(0, 16).replace("T", " ")} UTC`);
66
+ if (status.oldestAsOf != null) {
67
+ parts.push(`oldest rate ${status.oldestPair ? `${status.oldestPair} ` : ""}${new Date(status.oldestAsOf).toISOString().slice(0, 16).replace("T", " ")} UTC`);
68
+ }
46
69
  return parts.join(" · ");
47
70
  }
@@ -0,0 +1,67 @@
1
+ import { NOT_MEANINGFUL } from "./price-earnings";
2
+
3
+ export { NOT_MEANINGFUL };
4
+ export type NotMeaningful = typeof NOT_MEANINGFUL;
5
+ /** A growth rate or margin as a fraction (0.25 for 25%), or not meaningful. */
6
+ export type Rate = number | NotMeaningful;
7
+
8
+ function finite(value: number | null | undefined): value is number {
9
+ return typeof value === "number" && Number.isFinite(value);
10
+ }
11
+
12
+ /**
13
+ * The change from `previous` to `current` as a fraction of `previous` (0.25 for +25%).
14
+ *
15
+ * Off a zero or negative base it is not meaningful: a loss of 10 narrowing to a loss of 5,
16
+ * or turning into a profit of 5, is no percentage of the loss, whatever arithmetic gives
17
+ * (+50% and +150% against its size). Undefined where either figure is missing, or the
18
+ * change overflows a number.
19
+ */
20
+ export function growthRate(current: number | null | undefined, previous: number | null | undefined): Rate | undefined {
21
+ if (!finite(current) || !finite(previous)) return undefined;
22
+ if (previous <= 0) return NOT_MEANINGFUL;
23
+ const direct = (current - previous) / previous;
24
+ const growth = Number.isFinite(direct) ? direct : current / previous - 1;
25
+ return Number.isFinite(growth) ? growth : undefined;
26
+ }
27
+
28
+ /**
29
+ * The change in the size of an outflow, a line kept as a negative number (capex, dividends paid):
30
+ * -10 to -12 is +20%, a fifth more spent. A base that is not an outflow (zero or positive) is not
31
+ * meaningful, as it is for growthRate; nor is a period that took money in.
32
+ */
33
+ export function outflowGrowthRate(current: number | null | undefined, previous: number | null | undefined): Rate | undefined {
34
+ if (!finite(current) || !finite(previous)) return undefined;
35
+ if (previous >= 0 || current > 0) return NOT_MEANINGFUL;
36
+ return growthRate(-current, -previous);
37
+ }
38
+
39
+ /**
40
+ * `numerator` over `revenue`: a margin, or a cost's share of revenue. Over zero or negative
41
+ * revenue it is not meaningful (a loss over negative revenue would read as a positive margin).
42
+ * Undefined where either figure is missing.
43
+ */
44
+ export function revenueMargin(numerator: number | null | undefined, revenue: number | null | undefined): Rate | undefined {
45
+ if (!finite(numerator) || !finite(revenue)) return undefined;
46
+ if (revenue <= 0) return NOT_MEANINGFUL;
47
+ const margin = numerator / revenue;
48
+ return Number.isFinite(margin) ? margin : undefined;
49
+ }
50
+
51
+ /** The number in a rate, or null where it is missing or not meaningful. */
52
+ export function rateValue(rate: Rate | null | undefined): number | null {
53
+ return typeof rate === "number" && Number.isFinite(rate) ? rate : null;
54
+ }
55
+
56
+ export function isNotMeaningful(value: unknown): value is NotMeaningful {
57
+ return value === NOT_MEANINGFUL;
58
+ }
59
+
60
+ /** How a not-meaningful rate reads, as a P/E over a loss does. */
61
+ export const NOT_MEANINGFUL_TEXT = "N/M";
62
+
63
+ /**
64
+ * The tone N/M takes where a pane colours by tone (EVTS's rows, KPIS's changes): the text's own, the colour RV draws a
65
+ * P/E over a loss in (components/ui/not-meaningful). Never muted, positive or negative.
66
+ */
67
+ export const NOT_MEANINGFUL_TONE = "text" as const;
@@ -23,6 +23,12 @@ export function isPlainKeyboardEvent(event: KeyboardModifierEventLike): boolean
23
23
  return !hasKeyboardModifier(event);
24
24
  }
25
25
 
26
+ /** A key that types a character, which a filter box takes rather than the list under it. */
27
+ export function isTextKey(event: { sequence?: string; ctrl?: boolean; meta?: boolean; alt?: boolean }): boolean {
28
+ return event.sequence?.length === 1 && event.sequence >= " " && event.sequence !== "\u007f"
29
+ && !event.ctrl && !event.meta && !event.alt;
30
+ }
31
+
26
32
  export function isPlainKey(
27
33
  event: KeyboardModifierEventLike,
28
34
  ...names: string[]