gloomberb 0.20.2 → 0.20.4

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 (471) hide show
  1. package/README.md +1 -1
  2. package/README.zh-CN.md +1 -1
  3. package/package.json +2 -1
  4. package/src/account/auth-dialog.tsx +17 -0
  5. package/src/account/auth-form.tsx +13 -8
  6. package/src/account/upgrade-dialog.tsx +1 -1
  7. package/src/api-client/central-bank-rates.ts +5 -0
  8. package/src/api-client/data.ts +23 -4
  9. package/src/api-client/debt-maturities.ts +45 -2
  10. package/src/api-client/earnings.ts +4 -2
  11. package/src/api-client/errors.ts +21 -11
  12. package/src/api-client/fx-interventions.ts +64 -0
  13. package/src/api-client/index.ts +2 -0
  14. package/src/api-client/paths.ts +9 -1
  15. package/src/api-client/release-summaries.ts +21 -0
  16. package/src/api-client/social-mentions.ts +47 -0
  17. package/src/api-client/types/econ.ts +4 -0
  18. package/src/app/keybindings/actions.ts +2 -2
  19. package/src/app/pane-runtime/ticker-open-runtime.ts +245 -66
  20. package/src/app.tsx +11 -1
  21. package/src/cli/command-options.ts +2 -1
  22. package/src/cli/commands/market.ts +188 -30
  23. package/src/cli/commands/news-search.ts +1 -3
  24. package/src/cli/commands/options-chain.ts +23 -6
  25. package/src/cli/commands/overview.ts +13 -5
  26. package/src/cli/commands/plugins.ts +76 -23
  27. package/src/cli/commands/search.ts +25 -6
  28. package/src/cli/commands/system.ts +19 -3
  29. package/src/cli/commands/ticker.ts +64 -21
  30. package/src/cli/fx-quote-rate.ts +49 -1
  31. package/src/cli/glossary.ts +95 -15
  32. package/src/cli/history-rows.ts +9 -25
  33. package/src/cli/index.ts +14 -46
  34. package/src/cli/known-gaps.ts +3 -3
  35. package/src/cli/listing-arg.ts +78 -18
  36. package/src/cli/name-entries.ts +3 -2
  37. package/src/cli/not-a-ticker.ts +6 -2
  38. package/src/cli/pane-functions/capabilities.ts +12 -1
  39. package/src/cli/pane-functions/function-help.ts +26 -14
  40. package/src/cli/pane-functions/headless.ts +3 -1
  41. package/src/cli/pane-functions/index.ts +32 -4
  42. package/src/cli/pane-functions/market-session.ts +8 -3
  43. package/src/cli/pane-functions/resolver.ts +18 -11
  44. package/src/cli/pane-functions/screenshot-payload.ts +36 -6
  45. package/src/cli/pane-functions/screenshot-render.ts +4 -0
  46. package/src/cli/quote-answer.ts +10 -0
  47. package/src/cli/report-tables.ts +40 -8
  48. package/src/cli/result.ts +21 -9
  49. package/src/cli/spreadsheet-hint.ts +43 -0
  50. package/src/cli/symbol-list.ts +58 -4
  51. package/src/cli/symbol-rows.ts +49 -2
  52. package/src/cli/ticker-resolution.ts +98 -5
  53. package/src/cli/types.ts +2 -0
  54. package/src/cli/unknown-command.ts +88 -0
  55. package/src/components/chart/composite/axis-overlays.tsx +22 -0
  56. package/src/components/chart/composite/composite-chart.tsx +54 -13
  57. package/src/components/chart/composite/event-captions.ts +109 -0
  58. package/src/components/chart/composite/event-guides.ts +74 -0
  59. package/src/components/chart/composite/rasterizer.ts +2 -0
  60. package/src/components/chart/composite/text-renderer.ts +2 -0
  61. package/src/components/chart/composite/types.ts +31 -0
  62. package/src/components/command-bar/assist/model.ts +6 -1
  63. package/src/components/command-bar/commands/direct/index.ts +9 -1
  64. package/src/components/command-bar/commands/registry.ts +18 -0
  65. package/src/components/command-bar/layout-items/focused-pane.ts +5 -5
  66. package/src/components/command-bar/pane-actions.ts +30 -13
  67. package/src/components/command-bar/panel/index.tsx +6 -3
  68. package/src/components/command-bar/panel/prompt-binding.ts +4 -0
  69. package/src/components/command-bar/panel/types.ts +3 -0
  70. package/src/components/command-bar/routes/header-market.ts +108 -0
  71. package/src/components/command-bar/routes/root/command-items.ts +5 -0
  72. package/src/components/command-bar/routes/root/provider-search.ts +192 -33
  73. package/src/components/command-bar/routes/root/results.ts +3 -0
  74. package/src/components/command-bar/routes/root/runtime.ts +28 -5
  75. package/src/components/command-bar/routes/ticker-search/results.ts +104 -6
  76. package/src/components/command-bar/routes/ticker-search/route.ts +3 -2
  77. package/src/components/command-bar/routing/list-state.ts +38 -0
  78. package/src/components/command-bar/selection-hint.ts +28 -0
  79. package/src/components/command-bar/surface/index.tsx +41 -3
  80. package/src/components/command-bar/view-model.ts +15 -0
  81. package/src/components/command-bar/workflow/tickers.ts +3 -2
  82. package/src/components/company-logo.tsx +20 -2
  83. package/src/components/data-table/export.ts +13 -8
  84. package/src/components/feedback-dialog.tsx +2 -1
  85. package/src/components/form-modal/field-row.tsx +2 -1
  86. package/src/components/input-search-bar.tsx +2 -2
  87. package/src/components/layout/detached-pane-shell.tsx +1 -1
  88. package/src/components/layout/double-escape-close.ts +8 -5
  89. package/src/components/layout/floating-pane.tsx +5 -1
  90. package/src/components/layout/header.tsx +75 -44
  91. package/src/components/layout/market-summary.ts +322 -116
  92. package/src/components/layout/pane/footer/index.tsx +44 -19
  93. package/src/components/layout/pane/footer/model.ts +52 -20
  94. package/src/components/layout/pane/header.tsx +3 -2
  95. package/src/components/layout/shell/action-menu-overlay.tsx +10 -5
  96. package/src/components/layout/shell/active-drag.ts +149 -105
  97. package/src/components/layout/shell/chrome.ts +15 -15
  98. package/src/components/layout/shell/drag/drop-zones.ts +162 -0
  99. package/src/components/layout/shell/drag/index.ts +47 -218
  100. package/src/components/layout/shell/drag/live.ts +10 -3
  101. package/src/components/layout/shell/drag/overlays.tsx +182 -5
  102. package/src/components/layout/shell/drag/runtime.ts +29 -6
  103. package/src/components/layout/shell/drag/shared-edges.ts +156 -0
  104. package/src/components/layout/shell/index.tsx +11 -6
  105. package/src/components/layout/shell/menu.ts +11 -2
  106. package/src/components/layout/shell/native/pointer-runtime.ts +25 -0
  107. package/src/components/layout/shell/native/window-state.ts +2 -2
  108. package/src/components/layout/shell/pane/layers.tsx +71 -7
  109. package/src/components/layout/shell/terminal-pointer-runtime.ts +18 -9
  110. package/src/components/layout/shell/window-mode/index.ts +8 -10
  111. package/src/components/layout/status-bar.tsx +8 -7
  112. package/src/components/layout/status-widget-space.ts +8 -0
  113. package/src/components/layout/window-edit/mode.ts +39 -7
  114. package/src/components/layout/window-edit/presentation.ts +1 -1
  115. package/src/components/markdown-editor.tsx +2 -2
  116. package/src/components/onboarding/account-step/form-panel.tsx +0 -3
  117. package/src/components/onboarding/onboarding-keyboard.ts +19 -6
  118. package/src/components/onboarding/onboarding-wizard.tsx +69 -14
  119. package/src/components/onboarding/portfolio-step/broker-fields-panel.tsx +0 -1
  120. package/src/components/onboarding/portfolio-step/positions-panel.tsx +0 -2
  121. package/src/components/price-sparkline/model.ts +26 -10
  122. package/src/components/ticker/list-table-view.tsx +29 -4
  123. package/src/components/ui/button.tsx +15 -2
  124. package/src/components/ui/choice-dialog.tsx +1 -0
  125. package/src/components/ui/column-grid.tsx +18 -9
  126. package/src/components/ui/data-table/index.tsx +5 -4
  127. package/src/components/ui/data-table/opentui/index.tsx +2 -1
  128. package/src/components/ui/data-table/types.ts +18 -0
  129. package/src/components/ui/delayed-mark.tsx +3 -2
  130. package/src/components/ui/field-grid.tsx +0 -2
  131. package/src/components/ui/fields.tsx +7 -4
  132. package/src/components/ui/inline-quick-add.tsx +2 -2
  133. package/src/components/ui/key-hint-words.ts +153 -0
  134. package/src/components/ui/key-hints.tsx +73 -0
  135. package/src/components/ui/list-view.tsx +7 -12
  136. package/src/components/ui/loading.tsx +10 -3
  137. package/src/components/ui/menu.tsx +9 -3
  138. package/src/components/ui/message-composer.tsx +2 -2
  139. package/src/components/ui/quote.ts +14 -1
  140. package/src/components/ui/shortcut-hint.tsx +28 -3
  141. package/src/components/ui/tabs.tsx +7 -0
  142. package/src/components/ui/text-prompt-dialog.tsx +2 -1
  143. package/src/core/state/app/command-bar-launch.ts +3 -0
  144. package/src/data/config/layout.ts +5 -2
  145. package/src/data/config/store/normalize.ts +6 -0
  146. package/src/docs/snapshot.json +149 -74
  147. package/src/i18n/es.ts +33 -9
  148. package/src/i18n/ja.ts +33 -9
  149. package/src/i18n/ko.ts +33 -9
  150. package/src/i18n/zh-cn.ts +33 -9
  151. package/src/i18n/zh-tw.ts +33 -9
  152. package/src/layout/pane-manager/floating-actions.ts +17 -0
  153. package/src/layout/pane-manager/floating-stack.ts +187 -0
  154. package/src/layout/pane-manager/floating.ts +4 -2
  155. package/src/layout/pane-manager/gridlock.ts +16 -1
  156. package/src/layout/pane-manager/index.ts +11 -0
  157. package/src/layout/pane-manager/layout-state.ts +10 -3
  158. package/src/market-data/bars-per-year.ts +27 -9
  159. package/src/market-data/coordinator/quotes.ts +22 -3
  160. package/src/market-data/futures-board.ts +126 -1
  161. package/src/market-data/futures-contract.ts +21 -6
  162. package/src/market-data/fx-interventions.ts +270 -0
  163. package/src/market-data/market/change-basis.ts +2 -2
  164. package/src/market-data/market/dated-previous-close.ts +163 -47
  165. package/src/market-data/market/format.ts +14 -3
  166. package/src/market-data/market/freshness.ts +24 -7
  167. package/src/market-data/market/header-market.ts +154 -0
  168. package/src/market-data/market/index-level.ts +29 -0
  169. package/src/market-data/market/index-session-venues.ts +44 -0
  170. package/src/market-data/market/status.ts +7 -2
  171. package/src/market-data/market/venue-session.ts +72 -0
  172. package/src/market-data/model-dividend-yield.ts +23 -8
  173. package/src/market-data/options-alternatives.ts +39 -4
  174. package/src/market-data/published-apac-sessions.ts +40 -2
  175. package/src/market-data/quotes/export-identity.ts +76 -0
  176. package/src/market-data/quotes/freshness.ts +22 -0
  177. package/src/market-data/quotes/time.ts +42 -1
  178. package/src/market-data/realized-volatility.ts +11 -7
  179. package/src/market-data/tax-equivalent.ts +145 -27
  180. package/src/news/news-model.ts +44 -2
  181. package/src/plugins/builtin/account-management/pane.tsx +2 -2
  182. package/src/plugins/builtin/alerts/alert-engine.ts +12 -6
  183. package/src/plugins/builtin/alerts/alert-log.ts +6 -2
  184. package/src/plugins/builtin/alerts/calendar-events.ts +74 -12
  185. package/src/plugins/builtin/alerts/cli-forms.ts +11 -1
  186. package/src/plugins/builtin/alerts/cli-move.ts +234 -0
  187. package/src/plugins/builtin/alerts/cli.ts +223 -32
  188. package/src/plugins/builtin/alerts/command.ts +33 -6
  189. package/src/plugins/builtin/alerts/event-rows.ts +18 -4
  190. package/src/plugins/builtin/alerts/events-pane.tsx +6 -2
  191. package/src/plugins/builtin/alerts/events.ts +9 -0
  192. package/src/plugins/builtin/alerts/format.ts +39 -15
  193. package/src/plugins/builtin/alerts/headless.ts +30 -18
  194. package/src/plugins/builtin/alerts/history.ts +1 -0
  195. package/src/plugins/builtin/alerts/index.tsx +86 -12
  196. package/src/plugins/builtin/alerts/live.ts +2 -1
  197. package/src/plugins/builtin/alerts/move-checks.ts +161 -0
  198. package/src/plugins/builtin/alerts/move.ts +181 -0
  199. package/src/plugins/builtin/alerts/pane.tsx +50 -22
  200. package/src/plugins/builtin/alerts/price-text.ts +62 -0
  201. package/src/plugins/builtin/alerts/price.ts +17 -0
  202. package/src/plugins/builtin/alerts/quotes.ts +84 -3
  203. package/src/plugins/builtin/alerts/scheduled-check.ts +7 -1
  204. package/src/plugins/builtin/alerts/storage.ts +22 -7
  205. package/src/plugins/builtin/alerts/types.ts +25 -0
  206. package/src/plugins/builtin/analytics/risk-client.ts +60 -39
  207. package/src/plugins/builtin/analytics/risk-episodes.ts +18 -0
  208. package/src/plugins/builtin/analytics/risk-headless.ts +20 -4
  209. package/src/plugins/builtin/analytics/risk-model.ts +68 -1
  210. package/src/plugins/builtin/analytics/risk-pane.tsx +15 -3
  211. package/src/plugins/builtin/backtest/engine.ts +4 -2
  212. package/src/plugins/builtin/backtest/window.ts +3 -1
  213. package/src/plugins/builtin/broker-manager/sign-in-end.ts +1 -1
  214. package/src/plugins/builtin/central-bank-rates/client.ts +4 -0
  215. package/src/plugins/builtin/central-bank-rates/headless.ts +1 -1
  216. package/src/plugins/builtin/central-bank-rates/model.ts +18 -8
  217. package/src/plugins/builtin/central-bank-rates/pane.tsx +6 -3
  218. package/src/plugins/builtin/changelog/index.tsx +292 -101
  219. package/src/plugins/builtin/changelog/versions.ts +293 -0
  220. package/src/plugins/builtin/chart-composer/cli-options.ts +5 -0
  221. package/src/plugins/builtin/chart-composer/headless-schema.ts +17 -1
  222. package/src/plugins/builtin/chart-composer/headless.ts +2 -0
  223. package/src/plugins/builtin/chart-composer/intervention-events.ts +105 -0
  224. package/src/plugins/builtin/chart-composer/pane.tsx +21 -7
  225. package/src/plugins/builtin/chat/message/render-state.ts +2 -5
  226. package/src/plugins/builtin/cloud/askg/attached-pane.tsx +10 -5
  227. package/src/plugins/builtin/cloud/askg/controller.ts +141 -5
  228. package/src/plugins/builtin/cloud/askg/executor.ts +113 -4
  229. package/src/plugins/builtin/cloud/askg/manifest.ts +28 -13
  230. package/src/plugins/builtin/cloud/askg/model.ts +14 -4
  231. package/src/plugins/builtin/cloud/askg/pane.tsx +70 -46
  232. package/src/plugins/builtin/cloud/askg/turn-parts.tsx +70 -0
  233. package/src/plugins/builtin/cloud/terminal-relay/engine.ts +50 -130
  234. package/src/plugins/builtin/cloud/terminal-relay/policy.ts +327 -7
  235. package/src/plugins/builtin/cloud/terminal-relay/prompts.tsx +2 -1
  236. package/src/plugins/builtin/cloud/terminal-relay/redact.ts +47 -6
  237. package/src/plugins/builtin/cloud/upgrade-status-widget.tsx +9 -2
  238. package/src/plugins/builtin/commodities-energy/index.tsx +1 -3
  239. package/src/plugins/builtin/commodities-energy/view-state.ts +3 -0
  240. package/src/plugins/builtin/cot/headless.ts +14 -2
  241. package/src/plugins/builtin/crypto-board/headless.ts +82 -17
  242. package/src/plugins/builtin/crypto-board/index.tsx +24 -2
  243. package/src/plugins/builtin/crypto-board/model.ts +5 -2
  244. package/src/plugins/builtin/crypto-board/pane.tsx +4 -1
  245. package/src/plugins/builtin/debt-maturities/client.ts +111 -6
  246. package/src/plugins/builtin/debt-maturities/headless.ts +84 -1
  247. package/src/plugins/builtin/debt-maturities/model.ts +97 -14
  248. package/src/plugins/builtin/debt-maturities/pane.tsx +165 -15
  249. package/src/plugins/builtin/debt-maturities/series.ts +3 -1
  250. package/src/plugins/builtin/dividend-yield/client.ts +22 -6
  251. package/src/plugins/builtin/dividend-yield/headless.ts +113 -46
  252. package/src/plugins/builtin/dividend-yield/model.ts +5 -2
  253. package/src/plugins/builtin/dividend-yield/pane.tsx +6 -3
  254. package/src/plugins/builtin/dividend-yield/ranking-reads.ts +11 -4
  255. package/src/plugins/builtin/dividend-yield/ranking.ts +113 -18
  256. package/src/plugins/builtin/dividend-yield/types.ts +2 -0
  257. package/src/plugins/builtin/dividend-yield/view.ts +3 -0
  258. package/src/plugins/builtin/earnings/index.tsx +2 -2
  259. package/src/plugins/builtin/econ/calendar-model.ts +21 -3
  260. package/src/plugins/builtin/econ/detail-view.tsx +5 -3
  261. package/src/plugins/builtin/econ/figures.ts +13 -0
  262. package/src/plugins/builtin/econ/fred-catalog.ts +6 -3
  263. package/src/plugins/builtin/econ/index.tsx +5 -3
  264. package/src/plugins/builtin/econ/types.ts +5 -0
  265. package/src/plugins/builtin/equity-screener/footer.ts +45 -0
  266. package/src/plugins/builtin/equity-screener/pane.tsx +4 -18
  267. package/src/plugins/builtin/equity-screener/ticker-check.tsx +2 -1
  268. package/src/plugins/builtin/fixed-income/model.ts +1 -0
  269. package/src/plugins/builtin/futures/index.tsx +25 -4
  270. package/src/plugins/builtin/futures/model.ts +28 -32
  271. package/src/plugins/builtin/futures/series.ts +4 -3
  272. package/src/plugins/builtin/futures/table.tsx +17 -10
  273. package/src/plugins/builtin/futures/use-board-terms.ts +3 -3
  274. package/src/plugins/builtin/futures-curve/model.ts +3 -10
  275. package/src/plugins/builtin/help/function-card.tsx +2 -1
  276. package/src/plugins/builtin/help/function-index.ts +1 -0
  277. package/src/plugins/builtin/help/index.tsx +3 -3
  278. package/src/plugins/builtin/help/keybindings-editor.tsx +18 -4
  279. package/src/plugins/builtin/insider/client.ts +31 -14
  280. package/src/plugins/builtin/insider/signals-model.ts +2 -7
  281. package/src/plugins/builtin/iv-history/headless.ts +1 -2
  282. package/src/plugins/builtin/iv-history/model.ts +33 -23
  283. package/src/plugins/builtin/iv-history/screen-pane.tsx +0 -3
  284. package/src/plugins/builtin/kelly-sizer/headless.ts +64 -16
  285. package/src/plugins/builtin/kelly-sizer/history.ts +37 -28
  286. package/src/plugins/builtin/kelly-sizer/pane.tsx +43 -10
  287. package/src/plugins/builtin/kelly-sizer/sections.tsx +7 -2
  288. package/src/plugins/builtin/kelly-sizer/units.ts +29 -0
  289. package/src/plugins/builtin/layout-manager/index.tsx +8 -8
  290. package/src/plugins/builtin/news/headless.ts +2 -2
  291. package/src/plugins/builtin/news/index.tsx +10 -16
  292. package/src/plugins/builtin/news/overview-headlines.tsx +117 -0
  293. package/src/plugins/builtin/news/ticker-news.ts +35 -0
  294. package/src/plugins/builtin/news/wire/news/detail-view.tsx +8 -6
  295. package/src/plugins/builtin/news/wire/news/row.ts +49 -0
  296. package/src/plugins/builtin/news/wire/news/table.tsx +9 -20
  297. package/src/plugins/builtin/options/analytics.ts +7 -2
  298. package/src/plugins/builtin/options/live-quotes.ts +6 -1
  299. package/src/plugins/builtin/options/table.ts +3 -2
  300. package/src/plugins/builtin/options/view.tsx +11 -9
  301. package/src/plugins/builtin/options-scenario/client.ts +3 -0
  302. package/src/plugins/builtin/options-scenario/headless.ts +1 -1
  303. package/src/plugins/builtin/perps/client.ts +5 -4
  304. package/src/plugins/builtin/perps/headless.ts +134 -124
  305. package/src/plugins/builtin/perps/markets-section.tsx +7 -4
  306. package/src/plugins/builtin/perps/model.ts +8 -4
  307. package/src/plugins/builtin/perps/open-market.ts +4 -4
  308. package/src/plugins/builtin/perps/venue-markets.ts +3 -6
  309. package/src/plugins/builtin/plugin-marketplace/pane.tsx +11 -11
  310. package/src/plugins/builtin/portfolio-list/cell-version.ts +1 -0
  311. package/src/plugins/builtin/portfolio-list/cli/bulk-symbols.ts +34 -10
  312. package/src/plugins/builtin/portfolio-list/cli/period-report.ts +28 -2
  313. package/src/plugins/builtin/portfolio-list/cli/portfolio-command.ts +7 -3
  314. package/src/plugins/builtin/portfolio-list/cli/render.ts +66 -22
  315. package/src/plugins/builtin/portfolio-list/grid.tsx +5 -3
  316. package/src/plugins/builtin/portfolio-list/pane/data.ts +34 -1
  317. package/src/plugins/builtin/portfolio-list/pane/index.tsx +6 -0
  318. package/src/plugins/builtin/portfolio-list/pane/streaming.ts +15 -6
  319. package/src/plugins/builtin/portfolio-list/quick-add/resolution.ts +19 -7
  320. package/src/plugins/builtin/portfolio-list/summary/index.tsx +3 -1
  321. package/src/plugins/builtin/portfolio-list/table.tsx +30 -4
  322. package/src/plugins/builtin/realized-vol/evidence.ts +33 -6
  323. package/src/plugins/builtin/realized-vol/fx-proxy.ts +135 -0
  324. package/src/plugins/builtin/realized-vol/headless.ts +44 -8
  325. package/src/plugins/builtin/realized-vol/model.ts +9 -5
  326. package/src/plugins/builtin/realized-vol/pane.tsx +49 -15
  327. package/src/plugins/builtin/research/event-model.ts +9 -1
  328. package/src/plugins/builtin/research/event-sources.ts +22 -0
  329. package/src/plugins/builtin/research/headless.ts +3 -3
  330. package/src/plugins/builtin/sec/headless.ts +48 -6
  331. package/src/plugins/builtin/sec/index.tsx +6 -4
  332. package/src/plugins/builtin/sec/model.ts +4 -1
  333. package/src/plugins/builtin/shared/cloud-upgrade.ts +27 -3
  334. package/src/plugins/builtin/shared/earnings-calendar.ts +2 -0
  335. package/src/plugins/builtin/shared/market-cap-bands.ts +12 -0
  336. package/src/plugins/builtin/shared/report-freshness.ts +3 -1
  337. package/src/plugins/builtin/shared/use-quote-board.ts +5 -3
  338. package/src/plugins/builtin/shared/volatility/options.ts +63 -2
  339. package/src/plugins/builtin/social-mentions/headless.ts +72 -3
  340. package/src/plugins/builtin/social-mentions/index.tsx +8 -4
  341. package/src/plugins/builtin/social-mentions/lock-note.ts +6 -2
  342. package/src/plugins/builtin/social-mentions/outliers-client.ts +101 -0
  343. package/src/plugins/builtin/social-mentions/outliers-model.ts +162 -0
  344. package/src/plugins/builtin/social-mentions/outliers-names.ts +51 -0
  345. package/src/plugins/builtin/social-mentions/outliers.tsx +276 -0
  346. package/src/plugins/builtin/social-mentions/pane.tsx +32 -3
  347. package/src/plugins/builtin/supply-chain/graph-pane.tsx +2 -2
  348. package/src/plugins/builtin/thirteenf/api.ts +36 -2
  349. package/src/plugins/builtin/thirteenf/data.ts +4 -1
  350. package/src/plugins/builtin/thirteenf/headless.ts +14 -6
  351. package/src/plugins/builtin/thirteenf/model.ts +56 -1
  352. package/src/plugins/builtin/thirteenf/pane.tsx +8 -8
  353. package/src/plugins/builtin/thirteenf/report-notes.ts +11 -0
  354. package/src/plugins/builtin/thirteenf/table.ts +2 -1
  355. package/src/plugins/builtin/thirteenf/types.ts +6 -0
  356. package/src/plugins/builtin/ticker-detail/data-panes/historical-prices.tsx +23 -3
  357. package/src/plugins/builtin/ticker-detail/financials/model.ts +5 -0
  358. package/src/plugins/builtin/ticker-detail/headless-schema.ts +2 -1
  359. package/src/plugins/builtin/ticker-detail/headless.ts +21 -66
  360. package/src/plugins/builtin/ticker-detail/index.tsx +5 -0
  361. package/src/plugins/builtin/ticker-detail/overview/components.tsx +67 -6
  362. package/src/plugins/builtin/ticker-detail/overview/model.ts +6 -4
  363. package/src/plugins/builtin/ticker-detail/overview/pane.tsx +15 -0
  364. package/src/plugins/builtin/ticker-detail/overview/tax-equivalent.ts +69 -0
  365. package/src/plugins/builtin/ticker-detail/overview-tab.tsx +69 -19
  366. package/src/plugins/builtin/ticker-detail/pane.tsx +7 -2
  367. package/src/plugins/builtin/ticker-detail/quote-monitor/card.tsx +47 -24
  368. package/src/plugins/builtin/ticker-detail/quote-monitor/export.ts +46 -0
  369. package/src/plugins/builtin/ticker-detail/quote-monitor/index.tsx +20 -1
  370. package/src/plugins/builtin/ticker-detail/quote-monitor/rows.ts +120 -0
  371. package/src/plugins/builtin/ticker-detail/research-tabs.ts +1 -5
  372. package/src/plugins/builtin/ticker-detail/settings.ts +6 -6
  373. package/src/plugins/builtin/treasury-auctions/cache.ts +85 -19
  374. package/src/plugins/builtin/treasury-auctions/index.tsx +22 -11
  375. package/src/plugins/builtin/treasury-auctions/model.ts +23 -0
  376. package/src/plugins/builtin/treasury-auctions/treasury-direct.ts +128 -0
  377. package/src/plugins/builtin/world-indices/client.ts +2 -0
  378. package/src/plugins/compat.ts +15 -0
  379. package/src/plugins/host-link.ts +6 -1
  380. package/src/plugins/installer.ts +53 -3
  381. package/src/portfolio/column-values.ts +14 -4
  382. package/src/portfolio/listed-symbol.ts +78 -0
  383. package/src/portfolio/real-return.ts +172 -0
  384. package/src/public/__snapshots__/public-api.test.ts.snap +1 -0
  385. package/src/remote/resources.ts +12 -1
  386. package/src/remote/schema.ts +1 -0
  387. package/src/remote/semantic-helpers.ts +29 -1
  388. package/src/remote/semantic-tree.tsx +32 -15
  389. package/src/renderers/browser/config-host.ts +56 -15
  390. package/src/renderers/browser/main.tsx +3 -1
  391. package/src/renderers/browser/ui-host.tsx +1 -0
  392. package/src/renderers/cloudflare/http-proxy.ts +1 -0
  393. package/src/renderers/cloudflare/worker.ts +16 -1
  394. package/src/renderers/dom/boot-frame.ts +2 -2
  395. package/src/renderers/dom/data-table/row.tsx +4 -1
  396. package/src/renderers/dom/desktop/controls.tsx +4 -4
  397. package/src/renderers/dom/desktop/dialog-actions.tsx +60 -41
  398. package/src/renderers/dom/dom-ui-host.tsx +3 -1
  399. package/src/renderers/dom/host/input.tsx +4 -1
  400. package/src/renderers/dom/host/tabs.tsx +10 -1
  401. package/src/renderers/dom/styles.css +73 -19
  402. package/src/renderers/electrobun/bun/desktop/app-name.ts +1 -1
  403. package/src/renderers/opentui/host.tsx +2 -1
  404. package/src/renderers/share/layout-view.tsx +1 -1
  405. package/src/sources/gloomberb-cloud/fred-series.ts +12 -0
  406. package/src/sources/gloomberb-cloud/index.ts +31 -2
  407. package/src/sources/gloomberb-cloud/news.ts +35 -12
  408. package/src/sources/gloomberb-cloud/normalizers.ts +29 -3
  409. package/src/sources/provider-router/cached-routes.ts +19 -7
  410. package/src/state/opening-ticker-panes.ts +47 -0
  411. package/src/state/pane-table-export-registry.ts +19 -6
  412. package/src/test-support/cli-context.ts +2 -0
  413. package/src/test-support/preload.ts +8 -1
  414. package/src/theme/colors.ts +9 -1
  415. package/src/theme/themes.ts +62 -15
  416. package/src/theme/tone-contrast.ts +40 -0
  417. package/src/theme/ui-tokens.ts +23 -3
  418. package/src/tickers/batched-lookups.ts +57 -8
  419. package/src/tickers/company-name-listing.ts +156 -14
  420. package/src/tickers/company-name.ts +30 -6
  421. package/src/tickers/instrument-kind.ts +23 -3
  422. package/src/tickers/list.ts +7 -0
  423. package/src/tickers/search/home-listing.ts +31 -9
  424. package/src/tickers/search/index.ts +13 -3
  425. package/src/tickers/search/listing-index.ts +558 -0
  426. package/src/tickers/search/major-listings.chunk.ts +10 -0
  427. package/src/tickers/search/major-listings.json +3346 -0
  428. package/src/tickers/search/ranking.ts +68 -1
  429. package/src/tickers/search/types.ts +4 -0
  430. package/src/tickers/terminal-codes.ts +26 -1
  431. package/src/time-series/calendar-month-returns.ts +47 -0
  432. package/src/time-series/currency-conversion.ts +130 -0
  433. package/src/time-series/hooks.ts +2 -0
  434. package/src/time-series/price-comparison.ts +34 -11
  435. package/src/time-series/resolve-context.ts +3 -0
  436. package/src/time-series/resolve.ts +14 -2
  437. package/src/time-series/spec.ts +1 -0
  438. package/src/time-series/studies/indicators.ts +4 -1
  439. package/src/time-series/types.ts +8 -0
  440. package/src/types/config.ts +13 -0
  441. package/src/types/context-menu.ts +2 -0
  442. package/src/types/data-provider.ts +28 -0
  443. package/src/types/financials.ts +20 -2
  444. package/src/types/headless.ts +12 -0
  445. package/src/types/plugin-commands.ts +140 -0
  446. package/src/types/plugin-context.ts +125 -0
  447. package/src/types/plugin-contributions.ts +55 -0
  448. package/src/types/plugin-definition.ts +234 -0
  449. package/src/types/plugin-notifications.ts +38 -0
  450. package/src/types/plugin-pane-settings.ts +114 -0
  451. package/src/types/plugin-pane-templates.ts +160 -0
  452. package/src/types/plugin-panes.ts +221 -0
  453. package/src/types/plugin-reports.ts +35 -0
  454. package/src/types/plugin-shared.ts +14 -0
  455. package/src/types/plugin-state.ts +71 -0
  456. package/src/types/plugin.ts +14 -1169
  457. package/src/ui/host.tsx +8 -0
  458. package/src/ui/index.tsx +14 -3
  459. package/src/updater/github-releases.ts +23 -0
  460. package/src/utils/cli-output.ts +22 -9
  461. package/src/utils/datetime-format.ts +17 -3
  462. package/src/utils/display-number.ts +15 -0
  463. package/src/utils/double-escape-close.ts +61 -16
  464. package/src/utils/float32-price.ts +24 -0
  465. package/src/utils/forward-dividend.ts +81 -16
  466. package/src/utils/fx-market-hours.ts +11 -0
  467. package/src/utils/plugin-proxy-hosts.json +2 -1
  468. package/src/utils/price-history.ts +7 -6
  469. package/src/utils/report-timing.ts +62 -0
  470. package/src/utils/sec-filings.ts +32 -0
  471. package/src/utils/utc-time.ts +5 -0
@@ -1,7 +1,7 @@
1
1
  import { useCallback, useEffect, useMemo, useRef, useState } from "react";
2
2
  import { DataTableView, EmptyState, PaneStatusBody, QueryBar, StatGrid, statGridRows, useChartTableSelection, usePaneFooter, usePaneNoticeFooter, usePaneTabs,
3
3
  usePaneTicker, type DataTableColumn, type StatItem } from "../../../components";
4
- import { barsPerYearLabel } from "../../../market-data/bars-per-year";
4
+ import { barsPerYearLabel, currencyPairInstrument } from "../../../market-data/bars-per-year";
5
5
  import { instrumentFromTicker, quoteSubscriptionTargetFromTicker } from "../../../market-data/request-types";
6
6
  import { useQuoteUpdates } from "../../../state/hooks/quote-streaming";
7
7
  import { useAsyncResource } from "../../../react/async-resource";
@@ -24,11 +24,14 @@ import { coneWindowDate } from "./chart-model";
24
24
  import type { RealizedVolEvidenceStatus } from "./evidence";
25
25
  import { DEFAULT_WINDOWS, ESTIMATOR_OPTIONS, selectedWindows } from "./settings";
26
26
  import { priceSeriesUnit } from "../../../market-data/market/index-level";
27
+ import { fxVolatilityPair } from "../../../market-data/options-alternatives";
28
+ import { fxProxyIvLessRv, fxProxyLabel, fxProxyNote, loadFxVolProxy } from "./fx-proxy";
27
29
 
28
30
  /** In session, while visible, the current ATM IV reference re-reads its expiry this often. */
29
31
  const ATM_IV_REFRESH_MS = 60_000;
30
32
  const TABS = [{ value: "graph", label: "History" }, { value: "cone", label: "Cone" }];
31
33
  const percent = (value: number | null | undefined) => value == null ? "--" : `${(value * 100).toFixed(2)}%`;
34
+ const points = (value: number) => `${value >= 0 ? "+" : ""}${(value * 100).toFixed(2)}`;
32
35
  const NO_CONE: VolatilityConeStatistics[] = [];
33
36
  const coneRowId = (row: VolatilityConeStatistics) => String(row.window);
34
37
  const coneRowDate = (row: VolatilityConeStatistics) => coneWindowDate(row.window);
@@ -56,6 +59,8 @@ export function RealizedVolPane({ width, height, focused }: PaneProps) {
56
59
  const windows = useMemo(() => selectedWindows(windowValue), [windowValue]);
57
60
  const instrument = instrumentFromTicker(ticker, symbol);
58
61
  const instrumentKey = JSON.stringify(instrument);
62
+ // An FX pair or currency future has no chain: a currency fund's IV30 stands in for its ATM IV, labelled as a thin proxy.
63
+ const fxPair = !!symbol && fxVolatilityPair(symbol, instrument?.exchange) != null;
59
64
  const historyController = useRef<AbortController | null>(null);
60
65
  const ivController = useRef<AbortController | null>(null);
61
66
  const historyLoader = useCallback(async (force: boolean) => {
@@ -78,12 +83,22 @@ export function RealizedVolPane({ width, height, focused }: PaneProps) {
78
83
  return loadCurrentAtmIv({ instrument: instrument!, spot: currentQuote.price, spotAsOf: currentQuote.lastUpdated,
79
84
  forceRefresh: force, signal: controller.signal });
80
85
  }, [instrumentKey, spotAvailable]);
86
+ const proxyController = useRef<AbortController | null>(null);
87
+ const proxyLoader = useCallback(async () => {
88
+ proxyController.current?.abort();
89
+ const controller = new AbortController();
90
+ proxyController.current = controller;
91
+ return loadFxVolProxy({ symbol: instrument!.symbol, exchange: instrument!.exchange, signal: controller.signal });
92
+ }, [instrumentKey]);
81
93
  const history = useAsyncResource(instrument ? historyLoader : null);
82
- const loadedIv = useAsyncResource(instrument && showIv && spotAvailable ? ivLoader : null);
94
+ const loadedIv = useAsyncResource(instrument && showIv && spotAvailable && !fxPair ? ivLoader : null);
95
+ const proxy = useAsyncResource(instrument && showIv && fxPair ? proxyLoader : null);
83
96
  useEffect(() => () => historyController.current?.abort(), [historyLoader]);
84
97
  useEffect(() => () => ivController.current?.abort(), [ivLoader, showIv]);
98
+ useEffect(() => () => proxyController.current?.abort(), [proxyLoader, showIv]);
85
99
  useAutoRefresh(history.updatedAt, history.load);
86
100
  useAutoRefresh(loadedIv.updatedAt, loadedIv.load);
101
+ useAutoRefresh(proxy.updatedAt, proxy.load);
87
102
  // The pane subscribes its own quote: the IV reference is fitted at the live
88
103
  // price even when no other pane streams this ticker. The price is only
89
104
  // sampled at each refresh, so the slow off-screen cadence is enough.
@@ -109,17 +124,24 @@ export function RealizedVolPane({ width, height, focused }: PaneProps) {
109
124
  const refreshedCurrent = refreshedIv?.owner === ivLoader && refreshedIv.at > (loadedIv.updatedAt ?? 0) ? refreshedIv.data : null;
110
125
  const iv = { ...loadedIv, data: refreshedCurrent ?? loadedIv.data };
111
126
  ivDataRef.current = iv.data;
112
- const ivRefresh = useLiveSessionRefresh(refreshIv, ATM_IV_REFRESH_MS, showIv && spotAvailable && !!iv.data?.reference && !loadedIv.loading,
127
+ const ivRefresh = useLiveSessionRefresh(refreshIv, ATM_IV_REFRESH_MS, showIv && spotAvailable && !fxPair && !!iv.data?.reference && !loadedIv.loading,
113
128
  loadedIv.updatedAt);
129
+ const proxyData = showIv && fxPair ? proxy.data ?? null : null;
130
+ // The proxy's IV30 is a dated close: drawn on its session, as the ATM IV is on its observation.
131
+ const proxyPoint = proxyData?.iv30
132
+ ? { value: proxyData.iv30.value, date: new Date(`${proxyData.iv30.date}T00:00:00Z`), label: fxProxyLabel(proxyData) } : null;
133
+ const proxySpread = useMemo(() => fxProxyIvLessRv(proxyData, history.data?.history ?? [],
134
+ currencyPairInstrument(instrument?.symbol, instrument?.exchange)), [proxyData, history.data, instrumentKey]);
114
135
  const model = useMemo(() => history.data ? projectRealizedVolatility(history.data.history, {
115
- symbol: history.data.symbol, estimator, windows, lookbackYears: Number(lookback) === 2 ? 2 : 1,
136
+ symbol: history.data.symbol, exchange: instrument?.exchange, estimator, windows, lookbackYears: Number(lookback) === 2 ? 2 : 1,
116
137
  }) : null, [history.data, estimator, windows, lookback]);
117
138
  const chartInput = useMemo(() => model ? { history: model.history, rolling: model.series, windows: model.windows,
118
- priceUnit: priceSeriesUnit(quote?.currency ?? "", quote?.instrumentType, quote?.priceBasis), iv: showIv ? iv.data?.reference ?? null : null } : null,
119
- [model, quote?.currency, quote?.instrumentType, quote?.priceBasis, showIv, iv.data]);
139
+ priceUnit: priceSeriesUnit(quote?.currency ?? "", quote?.instrumentType, quote?.priceBasis), iv: showIv ? iv.data?.reference ?? proxyPoint : null } : null,
140
+ [model, quote?.currency, quote?.instrumentType, quote?.priceBasis, showIv, iv.data, proxyPoint?.value, proxyPoint?.label, proxyPoint?.date.getTime()]);
120
141
  const notices = [identityError, history.error, history.data?.error, iv.error, ivRefresh.error, iv.data?.error,
121
142
  ...(model?.warnings ?? []), model?.historyNote, model?.formingNote, ...(showIv ? iv.data?.warnings ?? [] : []),
122
- ...(showIv && symbol && !spotAvailable ? ["Current ATM IV unavailable: underlying quote is missing or stale"] : []),
143
+ ...(showIv && symbol && !spotAvailable && !fxPair ? ["Current ATM IV unavailable: underlying quote is missing or stale"] : []),
144
+ proxy.error, proxyData?.error, proxySpread.note,
123
145
  ].filter((value): value is string => !!value);
124
146
  usePaneNoticeFooter({ registrationId: "realized-vol-notices", notices: [...new Set(notices)], focused });
125
147
  const cycleView = () => setView(view === "graph" ? "cone" : "graph");
@@ -131,7 +153,7 @@ export function RealizedVolPane({ width, height, focused }: PaneProps) {
131
153
  // is the pane's own key.
132
154
  usePaneRefreshKey(() => {
133
155
  void history.reload();
134
- if (showIv) void iv.reload();
156
+ if (showIv) void (fxPair ? proxy.reload() : iv.reload());
135
157
  }, { focused });
136
158
  usePaneFooter("realized-vol", () => ({ info: [
137
159
  ...(history.loading ? [{ id: "loading", parts: [{ text: "loading history", tone: "muted" as const }] }] : []),
@@ -141,11 +163,12 @@ export function RealizedVolPane({ width, height, focused }: PaneProps) {
141
163
  }] }] : []),
142
164
  ...(model?.asOf ? [{ id: "date", parts: [{ text: model.asOf.toISOString().slice(0, 10), tone: "muted" as const }] }] : []),
143
165
  ...(showIv && iv.loading ? [{ id: "iv-loading", parts: [{ text: "loading ATM IV", tone: "muted" as const }] }] : []),
166
+ ...(showIv && proxy.loading ? [{ id: "proxy-loading", parts: [{ text: "loading FX vol proxy", tone: "muted" as const }] }] : []),
144
167
  ], hints: [
145
168
  { id: "view", key: "v", label: "iew", onPress: cycleView },
146
169
  { id: "iv", key: "i", label: showIv ? "v off" : "v on", onPress: () => setShowIv(!showIv) },
147
170
  ...(symbol ? [{ id: "surface", key: "s", label: "urface", onPress: openSurface }] : []),
148
- ] }), [history.loading, history.data, model?.asOf, model?.barsPerYear, iv.loading, showIv, view, symbol, iv.data]);
171
+ ] }), [history.loading, history.data, model?.asOf, model?.barsPerYear, iv.loading, proxy.loading, showIv, view, symbol, iv.data]);
149
172
  // The cone's legend reads the selected row, or the last one when that window has none.
150
173
  const legendWindow = view === "cone" && model?.cone.length
151
174
  ? (model.cone.find((row) => row.window === selected) ?? model.cone.at(-1)!).window : null;
@@ -154,12 +177,12 @@ export function RealizedVolPane({ width, height, focused }: PaneProps) {
154
177
  role: "report-notice", label: "Chart window",
155
178
  getMetadata: () => ({ text: `Chart legend: ${legendWindow}-bar window`, key: "legendWindow", value: legendWindow }),
156
179
  } : null);
157
- const ivErrors = showIv ? [...new Set([iv.error, ivRefresh.error, iv.data?.error, !iv.data?.reference ? "Current ATM IV unavailable" : null]
180
+ const ivErrors = showIv && !fxPair ? [...new Set([iv.error, ivRefresh.error, iv.data?.error, !iv.data?.reference ? "Current ATM IV unavailable" : null]
158
181
  .filter((value): value is string => !!value))] : [];
159
182
  const evidence: RealizedVolEvidenceStatus = {
160
183
  symbol: model?.symbol ?? symbol ?? "", view: view === "cone" ? "cone" : "graph", estimator, legendWindow,
161
184
  windows, lookbackYears: Number(lookback) === 2 ? 2 : 1, showIv, shortWindows: model?.shortWindows ?? [],
162
- loading: history.loading || (showIv && iv.loading),
185
+ loading: history.loading || (showIv && (iv.loading || proxy.loading)),
163
186
  stale: history.data?.stale ?? false, source: history.data?.source ?? null,
164
187
  asOf: model?.asOf?.toISOString() ?? null,
165
188
  errors: [...new Set([history.error, history.data?.error, ...(model?.warnings ?? []), ...ivErrors]
@@ -168,12 +191,23 @@ export function RealizedVolPane({ width, height, focused }: PaneProps) {
168
191
  currentIv: showIv && iv.data?.reference ? { value: iv.data.reference.value * 100,
169
192
  date: iv.data.reference.date.toISOString(), label: iv.data.reference.label,
170
193
  source: iv.data.reference.source, expiration: iv.data.reference.expiration } : null,
194
+ ...(fxPair ? { fxPair, proxyIv: showIv && proxyPoint && proxyData
195
+ ? { fund: proxyData.fund, value: proxyPoint.value * 100, date: proxyPoint.date.toISOString() } : null,
196
+ proxyStale: showIv && proxySpread.stale } : {}),
171
197
  };
172
198
  const { strip: tabStrip, rows: tabRows } = usePaneTabs({ tabs: TABS, activeValue: view, onSelect: setView, focused, dense: true });
173
199
  const reference = showIv ? iv.data?.reference ?? null : null;
174
- // The cone has no IV line of its own, so the dated ATM IV it is read against sits above it.
175
- const coneStats: StatItem[] = view === "cone" && model && reference
176
- ? [{ id: "atm-iv", label: "ATM IV", value: percent(reference.value), detail: `${Math.round(reference.daysToExpiry)}d` }] : [];
200
+ // The cone has no IV line of its own, so the dated ATM IV it is read against sits above it; for an FX pair,
201
+ // the proxy fund's IV30 with its close, how many of the fund's expiries price at the money, and IV30 less the pair's HV20.
202
+ const coneStats: StatItem[] = view !== "cone" || !model ? []
203
+ : reference ? [{ id: "atm-iv", label: "ATM IV", value: percent(reference.value), detail: `${Math.round(reference.daysToExpiry)}d` }]
204
+ : proxyData ? [
205
+ // A stale IV30 is marked here and said in the footer ("FXB has no IV30 since 2026-05-18").
206
+ { id: "proxy-iv", label: fxProxyLabel(proxyData), value: percent(proxyData.iv30?.value), detail: proxyData.iv30?.date,
207
+ tone: proxySpread.stale ? "warning" : undefined },
208
+ { id: "proxy-spread", label: "IV30 - HV20", value: proxySpread.spread == null ? "--" : points(proxySpread.spread), detail: "pts" },
209
+ { id: "proxy-expiries", label: "Expiries with ATM IV", value: proxyData.expiries ? `${proxyData.expiries.usable} of ${proxyData.expiries.read}` : "--" },
210
+ ] : [];
177
211
  const contentHeight = Math.max(4, height - 1 - tabRows - statGridRows(coneStats, width));
178
212
  // The table's selected window is the chart's cursor, so its legend reads that row's figures.
179
213
  const coneSelection = useChartTableSelection({ rows: model?.cone ?? NO_CONE, getId: coneRowId, getDate: coneRowDate,
@@ -185,7 +219,7 @@ export function RealizedVolPane({ width, height, focused }: PaneProps) {
185
219
  <QueryBar width={width} filters={[
186
220
  { id: "estimator", label: "Estimator", value: estimator, options: ESTIMATOR_OPTIONS, onChange: (value: string) => setEstimator(value as RealizedVolatilityEstimator) },
187
221
  { id: "lookback", label: "Lookback", value: String(lookback), options: [{ value: "1", label: "1Y" }, { value: "2", label: "2Y" }], onChange: setLookback },
188
- ]} meta={reference ? `ATM IV observed ${atmIvObservedLabel(reference.date)}` : "Annualized %"} />
222
+ ]} meta={reference ? `ATM IV observed ${atmIvObservedLabel(reference.date)}` : proxyData ? fxProxyNote(proxyData) : "Annualized %"} />
189
223
  {!symbol ? <EmptyState title="Select a ticker." /> : <PaneStatusBody subject="realized volatility" loading={history.loading && !model}
190
224
  error={!model ? history.error ?? identityError ?? null : null} empty={!!model && !model.history.length}>
191
225
  {model && view === "cone" ? <>
@@ -69,6 +69,8 @@ export interface EventRow {
69
69
  /** Keep the supplied ranges and comparison inputs available in detail/export. */
70
70
  estimateInputs?: { eps?: AnalystEstimateRecord; revenue?: AnalystEstimateRecord };
71
71
  estimateGrowthMetric?: "eps" | "revenue";
72
+ /** An estimate row's growth over the year-ago figure, as a fraction, of `estimateGrowthMetric`. */
73
+ estimateGrowth?: number;
72
74
  fiscalPeriodEnd?: string;
73
75
  periodDateSource?: FinancialStatement["dateSource"];
74
76
  providerPeriodDate?: string;
@@ -341,6 +343,10 @@ export function buildEventRows(
341
343
  // quarters give it when they all agree on one.
342
344
  const feedCurrencies = new Set(earnings.map((earning) => earning.currency).filter(Boolean));
343
345
  const feedCurrency = feedCurrencies.size === 1 ? [...feedCurrencies][0] : undefined;
346
+ // So do the oldest reported quarters (before 2024), which the feed leaves unlabelled, but only where the
347
+ // company's own EPS is in that currency too: one company's EPS then reads in one unit down the table, and an
348
+ // unlabelled figure nothing else vouches for stays unlabelled.
349
+ const reportedCurrency = feedCurrency && fundamentalsEpsCurrency(financials) === feedCurrency ? feedCurrency : undefined;
344
350
  for (const [index, earning] of earnings.entries()) {
345
351
  // A pending announcement must never inherit the previous report's actuals.
346
352
  const statement = earning.epsActual == null ? undefined : statementForEarningsDate(quarterlyStatements, earning);
@@ -357,7 +363,7 @@ export function buildEventRows(
357
363
  period: statement ? quarterLabel(statement.date) : earning.fiscalPeriod ? quarterLabel(earning.fiscalPeriod) : "-",
358
364
  ...(earning.time?.trim() ? { reportTime: earning.time.trim() } : {}),
359
365
  detail: upcomingEarningsDetail(earning),
360
- epsCurrency: earning.currency ?? (earning.epsActual == null ? feedCurrency : undefined),
366
+ epsCurrency: earning.currency ?? (earning.epsActual == null ? feedCurrency : reportedCurrency),
361
367
  revenueCurrency: statement ? statement.currency ?? financials?.financialCurrency : undefined,
362
368
  qEps: earning.epsActual ?? earning.epsEstimate,
363
369
  qRevenue: statement?.totalRevenue,
@@ -386,6 +392,7 @@ export function buildEventRows(
386
392
  for (const pair of buildEstimatePairs(estimates)) {
387
393
  const isFiscal = isFiscalEstimatePeriod(pair.period);
388
394
  if (!isFiscal && isReportedQuarter(pair.date, reportedPeriodEnds)) continue;
395
+ const growth = pair.eps?.growth ?? pair.revenue?.growth;
389
396
  rows.push({
390
397
  id: `estimate:${pair.date}:${pair.period}`,
391
398
  date: pair.date,
@@ -399,6 +406,7 @@ export function buildEventRows(
399
406
  ...(pair.revenue ? { revenue: { ...pair.revenue } } : {}),
400
407
  },
401
408
  estimateGrowthMetric: pair.eps?.growth != null ? "eps" : pair.revenue?.growth != null ? "revenue" : undefined,
409
+ ...growth != null ? { estimateGrowth: growth } : {},
402
410
  epsCurrency: pair.eps?.currency,
403
411
  revenueCurrency: pair.revenue?.currency,
404
412
  qEps: isFiscal ? undefined : pair.eps?.average,
@@ -5,6 +5,7 @@ import type {
5
5
  TickerFinancials,
6
6
  } from "../../../types/financials";
7
7
  import { formatEventMetric } from "./event-model";
8
+ import { formatPercent, formatPercentRaw } from "../../../utils/format";
8
9
  import { loadEarningsCalendar } from "../earnings/data/cache";
9
10
  import { calendarEventOf, newYorkDay, withResolvedEarnings } from "../shared/earnings-calendar";
10
11
 
@@ -28,6 +29,27 @@ export const EVENT_COLUMNS = [
28
29
  { key: "detail", header: "Detail" },
29
30
  ];
30
31
 
32
+ /**
33
+ * The columns of the earnings estimates report, as its pane heads them: what corporate actions
34
+ * call Value is a reported quarter's EPS surprise or an estimate's growth over the year-ago
35
+ * figure, each in a column of its own.
36
+ */
37
+ export const EARNINGS_ESTIMATE_COLUMNS = [
38
+ ...EVENT_COLUMNS.filter((column) => column.key !== "value" && column.key !== "detail"),
39
+ {
40
+ key: "surprisePercent", header: "EPS surp", align: "right" as const,
41
+ format: (value: unknown) => value == null ? "-" : formatPercentRaw(Number(value)),
42
+ },
43
+ {
44
+ key: "estimateGrowth", header: "YoY growth", align: "right" as const,
45
+ format: (value: unknown) => value == null ? "-" : formatPercent(Number(value)),
46
+ // The text says which figure grew, as the pane does; exports keep the percent a number.
47
+ textFormat: (value: unknown, row: Record<string, unknown>) => value == null ? "-"
48
+ : `${formatPercent(Number(value))} ${row.estimateGrowthMetric === "revenue" ? "rev" : "EPS"}`,
49
+ },
50
+ { key: "detail", header: "Detail" },
51
+ ];
52
+
31
53
  export interface EventSources {
32
54
  actions: CorporateActionsData | null;
33
55
  estimates: AnalystResearchData | null;
@@ -10,7 +10,7 @@ import type {
10
10
  HeadlessRowsResult,
11
11
  } from "../../../types/plugin";
12
12
  import { buildEventRows, eventSourceNotice, type EventRow } from "./event-model";
13
- import { EVENT_COLUMNS, loadEventSources } from "./event-sources";
13
+ import { EARNINGS_ESTIMATE_COLUMNS, loadEventSources } from "./event-sources";
14
14
  import { REPORTED_DATA } from "../shared/report-freshness";
15
15
  import { EPS_BASIS_NOTE } from "../shared/earnings-report";
16
16
  import { REPORT_FILTER, REPORT_ROWS } from "../shared/headless-options";
@@ -73,7 +73,7 @@ function projectEarningsEstimatesHeadless(
73
73
  if (unmatchedReportedPeriods.length) errors.push(`No statement period identified for ${unmatchedReportedPeriods.length} reported earnings row(s); quarterly revenue is unavailable.`);
74
74
 
75
75
  return {
76
- columns: EVENT_COLUMNS,
76
+ columns: EARNINGS_ESTIMATE_COLUMNS,
77
77
  rows,
78
78
  errors: errors.length ? errors : undefined,
79
79
  metadata: {
@@ -124,7 +124,7 @@ export function createEarningsEstimatesHeadless(
124
124
  maximum: 200,
125
125
  },
126
126
  ],
127
- columns: EVENT_COLUMNS,
127
+ columns: EARNINGS_ESTIMATE_COLUMNS,
128
128
  describe: (args) => `Earnings Estimates | ${String(args.argument)}`,
129
129
  async load(args, context) {
130
130
  return projectEarningsEstimatesHeadless(
@@ -22,6 +22,10 @@ import { REPORT_ROWS } from "../shared/headless-options";
22
22
  import { fundAbroadProfile, venueAbroad, type FundAbroadProfile } from "./fund-abroad";
23
23
  import { listingAnnouncementsPage } from "../../../utils/exchange-announcements";
24
24
  import { companyDataNotes } from "../../../types/company-from";
25
+ import {
26
+ analyzeTaxEquivalent, distributionBasis, loadTreasuryTenors, parseTaxRates, TAX_RATE_EXAMPLES, TAX_RATE_OPTIONS, taxEquivalentJson, taxEquivalentSection,
27
+ type TaxEquivalentAnalysis, type TreasuryTenor, type YieldBasis,
28
+ } from "../../../market-data/tax-equivalent";
25
29
 
26
30
  const SEC_COLUMNS: HeadlessPaneColumn[] = [
27
31
  {
@@ -163,11 +167,20 @@ export const secHeadless = createSecHeadless();
163
167
  export interface FundHeadlessDependencies extends SecHeadlessDependencies {
164
168
  loadFacts(symbol: string, ctx: HeadlessPaneContext): Promise<FundFactsPayload>;
165
169
  loadAbroadProfile?(key: string, ctx: HeadlessPaneContext): Promise<FundAbroadProfile | null>;
170
+ /** With `--tax-rate`: the Treasury par curve GC shows, for the muni/Treasury ratio; null when it cannot be read. */
171
+ loadTreasury?(ctx: HeadlessPaneContext): Promise<TreasuryTenor[] | null>;
172
+ /** With `--tax-rate`, for a muni fund whose sponsor publishes no SEC yield: its distribution yield, as `fundamentals` states it. */
173
+ loadDistribution?(symbol: string, ctx: HeadlessPaneContext): Promise<YieldBasis | null>;
166
174
  }
167
175
 
168
176
  const defaultFundDependencies = {
169
177
  ...defaultDependencies,
170
178
  loadFacts: (symbol: string, ctx: HeadlessPaneContext) => fetchFundFacts(symbol, ctx.apiClient),
179
+ loadTreasury: (ctx: HeadlessPaneContext) => loadTreasuryTenors(ctx.apiClient),
180
+ async loadDistribution(symbol: string, ctx: HeadlessPaneContext): Promise<YieldBasis | null> {
181
+ const fundamentals = (await ctx.marketData.getTickerFinancials(symbol, "")).fundamentals;
182
+ return distributionBasis(fundamentals?.dividendYield, fundamentals?.dividendYieldBasis === "trailing" ? "trailing" : "forward");
183
+ },
171
184
  async loadAbroadProfile(key: string, ctx: HeadlessPaneContext): Promise<FundAbroadProfile | null> {
172
185
  const { symbol, exchange } = parsePublicTickerKey(key);
173
186
  return fundAbroadProfile(await ctx.marketData.getTickerFinancials(symbol, exchange));
@@ -232,7 +245,8 @@ export function createFundHeadless(dependencies: FundHeadlessDependencies = defa
232
245
  return {
233
246
  shape: "bundle",
234
247
  freshness: { source: "Fund sponsors and SEC EDGAR", status: "not-a-feed", basis: "published fund data" },
235
- argument: { kind: "ticker", placeholder: "ticker", description: "US-listed fund ticker. A fund listed abroad gets its issuer's page." },
248
+ argument: { kind: "ticker", placeholder: "ticker", description: "US-listed fund ticker. A fund listed abroad gets its issuer's page.",
249
+ examples: TAX_RATE_EXAMPLES.slice(0, 2) },
236
250
  options: [{
237
251
  key: "limit",
238
252
  shot: REPORT_ROWS,
@@ -242,30 +256,41 @@ export function createFundHeadless(dependencies: FundHeadlessDependencies = defa
242
256
  defaultValue: 50,
243
257
  minimum: 1,
244
258
  maximum: 200,
245
- }],
259
+ }, ...TAX_RATE_OPTIONS],
246
260
  discovery: { limitations: ["Fund facts cover the sponsors Gloom collects; other funds point to their SEC filings."] },
247
261
  describe: (args) => `ETF | ${args.symbols[0]}`,
248
262
  async load(args, ctx) {
249
263
  const symbol = args.symbols[0]!;
264
+ // Checked before anything is read: a state rate without its state is refused, not ignored.
265
+ const rates = parseTaxRates({ taxRate: args.options["tax-rate"], stateRate: args.options["state-rate"], state: args.options.state });
250
266
  const abroad = venueAbroad(symbol);
251
267
  if (abroad) {
268
+ // --tax-rate reads US tax on a US fund's income: a fund listed abroad says it does not apply rather than drop it.
269
+ const taxed = (result: HeadlessBundleResult): HeadlessBundleResult => {
270
+ if (!rates) return result;
271
+ const tax = analyzeTaxEquivalent({ symbol: symbol.toUpperCase(), bond: null, rates, noBondFigures: "listed-abroad" });
272
+ return { ...result, sections: [...result.sections, taxEquivalentSection(tax)],
273
+ metadata: { ...result.metadata, taxEquivalent: taxEquivalentJson(tax) } };
274
+ };
252
275
  // A Hong Kong spot coin fund has its issuer's figures; any other fund abroad, or a server without them, keeps the issuer link.
253
276
  const facts = hasFundFactsAbroad(abroad)
254
277
  ? await dependencies.loadFacts(symbol, ctx).catch(logFailure("sec.fund-headless", "Read fund facts abroad failed", null))
255
278
  : null;
256
- if (facts?.covered) return fundAbroadFactsResult(symbol, abroad, facts);
279
+ if (facts?.covered) return taxed(fundAbroadFactsResult(symbol, abroad, facts));
257
280
  try {
258
281
  const profile = await (dependencies.loadAbroadProfile ?? defaultFundDependencies.loadAbroadProfile)(symbol, ctx);
259
- return fundAbroadResult(symbol, abroad, profile);
282
+ return taxed(fundAbroadResult(symbol, abroad, profile));
260
283
  } catch (error) {
261
- return {
284
+ return taxed({
262
285
  ...fundAbroadResult(symbol, abroad, null),
263
286
  complete: false,
264
287
  errors: [`Fund profile unavailable: ${errorMessage(error)}`],
265
- };
288
+ });
266
289
  }
267
290
  }
268
291
  const limit = Number(args.options.limit);
292
+ const treasury = rates ? (dependencies.loadTreasury ?? defaultFundDependencies.loadTreasury)(ctx)
293
+ .catch(logFailure("sec.fund-headless", "Read Treasury curve for tax-equivalent yield failed", null)) : null;
269
294
  const [factsResult, filingsResult] = await Promise.allSettled([
270
295
  dependencies.loadFacts(symbol, ctx),
271
296
  dependencies.loadFilings(symbol, SEC_FILING_FETCH_LIMIT, args, ctx),
@@ -288,9 +313,25 @@ export function createFundHeadless(dependencies: FundHeadlessDependencies = defa
288
313
  : fundFactsEmpty(symbol, facts, !filingsPointToSec) };
289
314
  const publishers = facts?.covered ? fundFactPublishers(facts) : [];
290
315
  const filingRows = buildSecFilingRows(filings);
316
+ // With --tax-rate, the section DVD and fundamentals show, on the sponsor's SEC yield (else the distribution yield).
317
+ let tax: TaxEquivalentAnalysis | null = null;
318
+ if (rates) {
319
+ const bond = facts?.covered ? facts.bond ?? null : null;
320
+ const distribution = bond?.kind === "municipal" && !bond.secYield
321
+ ? await (dependencies.loadDistribution ?? defaultFundDependencies.loadDistribution)(symbol, ctx)
322
+ .catch(logFailure("sec.fund-headless", "Read distribution yield for tax-equivalent yield failed", null))
323
+ : null;
324
+ tax = analyzeTaxEquivalent({
325
+ symbol: symbol.toUpperCase(), bond, rates, distribution, treasury: await treasury,
326
+ ...factsResult.status === "rejected" ? { checkError: `no tax-equivalent yield: ${fundFactsErrorText(factsResult.reason)}` } : {},
327
+ // A stock (fn ETF KO) is not on the SEC's lists of funds, and says so rather than that no bond figures are loaded.
328
+ noBondFigures: facts?.status === "not-a-fund" ? "not-a-fund" : null,
329
+ });
330
+ }
291
331
  return {
292
332
  sections: [
293
333
  factsSection,
334
+ ...tax ? [taxEquivalentSection(tax)] : [],
294
335
  { title: "Fund filings", columns: SEC_COLUMNS, textColumns: fundFilingTextColumns(filingRows), rows: filingRows, ...(filings.length === 0 ? { empty: filingsEmpty } : {}) },
295
336
  ],
296
337
  complete: !!facts?.covered && filingsResult.status === "fulfilled" && searchedAll,
@@ -316,6 +357,7 @@ export function createFundHeadless(dependencies: FundHeadlessDependencies = defa
316
357
  forms: [...ETF_FILING_FORMS],
317
358
  searchedFilings: issuerFilings.length,
318
359
  issuers: secFilingIssuers(filings),
360
+ ...tax ? { taxEquivalent: taxEquivalentJson(tax) } : {},
319
361
  },
320
362
  };
321
363
  },
@@ -24,7 +24,7 @@ import { publicTickerKey } from "../../../utils/exchanges";
24
24
  import { fundFactsAbroadKey, hasFundFactsAbroad, mayBeFundViewTicker, mayBeUsEquityOrFundTicker, mayBeUsEquityTicker, secFilingItemCodes, US_FUND_FACTS_ONLY } from "../../../utils/sec";
25
25
  import { fundAbroadProfile, venueAbroad, type FundAbroadProfile } from "./fund-abroad";
26
26
  import { listingAnnouncementsPage } from "../../../utils/exchange-announcements";
27
- import { pricingSupplementTest } from "../../../utils/sec-filings";
27
+ import { form4TradeText, isOtherIssuerForm4, pricingSupplementTest } from "../../../utils/sec-filings";
28
28
  import { formatInsiderName } from "../insider/display";
29
29
  import { parseForm4Xml } from "../insider/insider-data";
30
30
  import { createTickerSurfacePaneTemplate } from "../shared/ticker-surface";
@@ -217,13 +217,15 @@ function toFeedItems(
217
217
  const enrichedTitle = formDesc
218
218
  ? `${displayTitle} — ${formDesc}`
219
219
  : displayTitle;
220
- const summary = readSummary?.title ?? getFilingColumnText(filing);
220
+ // A Form 4 the company filed as an owner of another company's shares names that company only in its trade.
221
+ const summary = (isOtherIssuerForm4(filing) ? form4TradeText(filing) : null) ?? readSummary?.title ?? getFilingColumnText(filing);
222
+ const direction = readSummary?.direction ?? (filing.form4?.side === "buy" || filing.form4?.side === "sell" ? filing.form4.side : null);
221
223
  const items = secFilingItemCodes(filing.items);
222
224
  const facts: DetailFact[] = [
223
225
  { label: "Issuer", value: filing.companyName || "Name unavailable" },
224
226
  ...(issuerTicker ? [{ label: "Ticker", value: issuerTicker.symbol, link: { label: `Open ${issuerTicker.symbol}`, onOpen: issuerTicker.open } }] : []),
225
227
  { label: "CIK", value: filing.cik },
226
- { label: "Form", value: formDesc ? `${filing.form} · ${formDesc}` : filing.form, color: toneColor(filingTone(filing, readSummary?.direction), colors) },
228
+ { label: "Form", value: formDesc ? `${filing.form} · ${formDesc}` : filing.form, color: toneColor(filingTone(filing, direction), colors) },
227
229
  { label: "Filed", value: formatFiledAt(filing) },
228
230
  ...(acceptedAt ? [{ label: "SEC-reported acceptance", value: acceptedAt }] : []),
229
231
  ...(items ? [{ label: "Items", value: items }] : []),
@@ -233,7 +235,7 @@ function toFeedItems(
233
235
  return {
234
236
  id: filing.accessionNumber,
235
237
  eyebrow: filing.form,
236
- eyebrowColor: toneColor(filingTone(filing, readSummary?.direction), colors),
238
+ eyebrowColor: toneColor(filingTone(filing, direction), colors),
237
239
  // A ticker shared by several filers names the filer on each row.
238
240
  title: showIssuer && filing.companyName ? `${filing.companyName}: ${summary}` : summary,
239
241
  timestamp: filing.filingDate,
@@ -1,6 +1,6 @@
1
1
  import type { SecFilingItem } from "../../../types/data-provider";
2
2
  import { secFilingItemCodes } from "../../../utils/sec";
3
- import { currentReportItemNames, isCurrentReportForm as isCurrentReport } from "../../../utils/sec-filings";
3
+ import { currentReportItemNames, form4TradeText, isCurrentReportForm as isCurrentReport } from "../../../utils/sec-filings";
4
4
 
5
5
  function getDisplayFormLabel(form: string): string {
6
6
  const trimmed = form.trim();
@@ -66,6 +66,9 @@ function periodicReportPeriod(filing: Pick<SecFilingItem, "form" | "primaryDocum
66
66
 
67
67
  /** The adjacent FORM column already identifies the form. Keep its meaning here: what the filing reports. */
68
68
  export function getFilingColumnText(filing: SecFilingItem): string {
69
+ // A Form 4 Gloom Cloud read says its trade, and whose shares when they are another company's.
70
+ const trade = form4TradeText(filing);
71
+ if (trade) return trade;
69
72
  const description = getMeaningfulPrimaryDescription(filing);
70
73
  const meaning = getFormDescription(filing.form);
71
74
  if (!description) {
@@ -15,6 +15,7 @@ import { freeQuotesDelayMinutes, resolvePlanAccess, usePlanAccess, type PlanAcce
15
15
  import { useViewport } from "../../../react/input";
16
16
  import { type DialogApi, useOptionalDialog } from "../../../ui/dialog";
17
17
  import { promptCloudUpgrade } from "../../../account/upgrade-dialog";
18
+ import { isAuthDialogOpen, requestAuthDialog } from "../../../account/auth-dialog";
18
19
  import { type CheckoutHandoffTarget, promptCheckoutHandoff } from "../../../account/checkout-handoff";
19
20
 
20
21
  const CLOUD_UPGRADE_URL = "https://gloom.sh/cloud?upgrade=pro";
@@ -195,8 +196,14 @@ function isCloudUpgradeOptions(value: unknown): value is CloudUpgradeOptions {
195
196
  *
196
197
  * A signed-in account without Pro sees the upgrade sheet first (what Pro adds,
197
198
  * what today costs), and checkout opens only once they choose to go on, with
198
- * the checkout hand-off over the app until Pro arrives. Signed-out users get
199
- * the public Cloud page and Pro accounts the billing portal, as before.
199
+ * the checkout hand-off over the app until Pro arrives. Signed out, the
200
+ * sign-up dialog opens first, as the UPGRADE command's does, and the upgrade
201
+ * goes on once signed in, to the sheet for an account without Pro and to
202
+ * nothing for one that has it: the Cloud page it opened before left a
203
+ * terminal over SSH with no browser looking as if `$` did nothing. A press
204
+ * while the dialog is up does nothing. Only with no dialog host (an isolated
205
+ * render) does it open the public Cloud page. Pro accounts get the billing
206
+ * portal.
200
207
  */
201
208
  export function useCloudUpgradeAction(placement: string): (options?: unknown) => Promise<void> {
202
209
  const rendererHost = useRendererHost();
@@ -227,6 +234,20 @@ export function useCloudUpgradeAction(placement: string): (options?: unknown) =>
227
234
  })
228
235
  )).catch(logFailure("shared.cloud-upgrade", "Open Cloud upgrade page failed"));
229
236
  };
237
+ if (checkout.sheet !== false && !apiClient.isSignedIn()) {
238
+ // A press while the sign-up dialog is up asks for nothing new, and counts nothing.
239
+ if (isAuthDialogOpen()) return;
240
+ // Counted once, on this press: the upgrade that goes on after sign-up does not count it again. An account that
241
+ // signs in with Pro already has what the press was for, so nothing more opens.
242
+ const continueSignedIn = () => {
243
+ if (resolvePlanAccess(apiClient.getCurrentUser()).hasProAccess) return;
244
+ void openUpgradeRef.current({ ...checkout, recordIntent: false });
245
+ };
246
+ if (requestAuthDialog({ mode: "signup", onSignedIn: continueSignedIn })) {
247
+ if (checkout.recordIntent !== false) recordUpgradeIntent(checkout.placement);
248
+ return;
249
+ }
250
+ }
230
251
  if (
231
252
  checkout.sheet === false ||
232
253
  !dialog ||
@@ -236,7 +257,7 @@ export function useCloudUpgradeAction(placement: string): (options?: unknown) =>
236
257
  await openCheckout(checkout);
237
258
  return;
238
259
  }
239
- recordUpgradeIntent(checkout.placement);
260
+ if (checkout.recordIntent !== false) recordUpgradeIntent(checkout.placement);
240
261
  // Checkout is opening or just opened: a second sheet would lead nowhere.
241
262
  if (isCloudUpgradeBlocked("checkout")) return;
242
263
  const interval = await promptCloudUpgrade(dialog, {
@@ -245,6 +266,9 @@ export function useCloudUpgradeAction(placement: string): (options?: unknown) =>
245
266
  });
246
267
  if (interval) await openCheckout({ ...checkout, interval, recordIntent: false });
247
268
  }, [dialog, placement, rendererHost]);
269
+ // The sign-up dialog's continuation runs the newest action, after the sign-in re-rendered it.
270
+ const openUpgradeRef = useRef(openUpgrade);
271
+ openUpgradeRef.current = openUpgrade;
248
272
  useEffect(() => {
249
273
  cloudUpgradeOpeners.add(openUpgrade);
250
274
  return () => {
@@ -291,6 +291,8 @@ function eventOfRow(event: EarningsEvent, row: EarningsAction, report: CalendarR
291
291
  ...base,
292
292
  earningsDate,
293
293
  earningsCallDate: ownDate ? event.earningsCallDate ?? null : null,
294
+ // The company's time is for its own date, never another the record places the report on.
295
+ releaseAt: ownDate ? event.releaseAt ?? null : null,
294
296
  isDateEstimate: statusFlag(dateStatus) ?? (dateStatus === "reported" ? base.isDateEstimate ?? null : null),
295
297
  epsEstimate: recordFigures ? row.epsEstimate ?? null : base.epsEstimate ?? row.epsEstimate ?? null,
296
298
  epsAnalysts: recordFigures ? row.epsAnalysts ?? null : base.epsAnalysts ?? row.epsAnalysts ?? null,
@@ -0,0 +1,12 @@
1
+ import type { SelectButtonOption } from "../../../components/ui/select-button";
2
+
3
+ /** Market value bands in US dollars, as the rankings that filter by size draw them (INS, BUZZ). */
4
+ export type MarketCapBand = "micro" | "small" | "mid" | "large";
5
+
6
+ export const MARKET_CAP_BAND_OPTIONS: SelectButtonOption<MarketCapBand | "all">[] = [
7
+ { value: "all", label: "All" },
8
+ { value: "micro", label: "Micro", description: "Under $300M" },
9
+ { value: "small", label: "Small", description: "$300M to $2B" },
10
+ { value: "mid", label: "Mid", description: "$2B to $10B" },
11
+ { value: "large", label: "Large", description: "Over $10B" },
12
+ ];
@@ -4,6 +4,7 @@ import type { Quote, QuoteIndexSession } from "../../../types/financials";
4
4
  import { isQuoteBeforeLatestSession, isQuoteStaleForCurrentSession } from "../../../market-data/quotes/freshness";
5
5
  import { delayedFeedLagMs, readIndexSession } from "../../../market-data/market/freshness";
6
6
  import { quoteHeadlineTime } from "../../../market-data/market/status";
7
+ import { indexLevelMarketState } from "../../../market-data/market/index-level";
7
8
  import { barSizeFromGap, medianBarGap } from "../../../time-series/bar-spacing";
8
9
  import { apiClient } from "../../../api-client";
9
10
  import { isPerpetualExchange } from "../../../tickers/perpetual-listing";
@@ -113,7 +114,8 @@ export function quoteFreshnessFields(
113
114
  stale: isQuoteStaleForCurrentSession(quote, now),
114
115
  ...(delayed ? { delayMinutes: delayedFeedLagMs(exchange) / 60_000 } : {}),
115
116
  ...(exchange && session ? { sessionExchange: exchange } : {}),
116
- ...(quote.marketState && session ? { marketState: quote.marketState } : {}),
117
+ // An index's final close reads as a close, not after hours.
118
+ ...(quote.marketState && session ? { marketState: indexLevelMarketState(quote) } : {}),
117
119
  ...(sessionCalendar && session ? { sessionCalendar } : {}),
118
120
  };
119
121
  }
@@ -673,6 +673,8 @@ export type QuoteBoardCellKind = "status" | "price" | "change" | "changePercent"
673
673
  export interface QuoteBoardCellFormat {
674
674
  /** Spell out the session instead of a colored dot. */
675
675
  sessionText?: boolean;
676
+ /** The moment the status cell reads the venue's session at, in ms; the current time when omitted. */
677
+ now?: number;
676
678
  /** Called with the quote at its headline: a finite price. */
677
679
  formatPrice: (quote: Quote) => string;
678
680
  /** Called with the quote at its headline: a finite change; the text carries its sign. */
@@ -722,11 +724,11 @@ export function renderQuoteBoardCell(
722
724
  switch (kind) {
723
725
  case "status": {
724
726
  if (format.sessionText) {
725
- return { text: quoteSessionLabel(quote) ?? "—", color: quoteSessionColor(quote) };
727
+ return { text: quoteSessionLabel(quote, format.now) ?? "—", color: quoteSessionColor(quote, colors, format.now) };
726
728
  }
727
- const dot = marketStatusDot(quoteDotMarketState(quote));
729
+ const dot = marketStatusDot(quoteDotMarketState(quote, format.now));
728
730
  // The dot is a picture; the export says which session it means.
729
- return { text: dot.char, value: quoteSessionLabel(quote), color: dot.color };
731
+ return { text: dot.char, value: quoteSessionLabel(quote, format.now), color: dot.color };
730
732
  }
731
733
  case "price":
732
734
  if (!quote || !Number.isFinite(quote.price)) return { text: "—", color: colors.textDim };