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
@@ -36,6 +36,12 @@ export interface MarketFormatOptions extends AssetDisplayContext {
36
36
  quotedUnitDivisor?: number;
37
37
  /** Write the currency's code after a money price (259.36 USD) instead of its sign ($259.36): a report for a base currency other than USD. */
38
38
  currencyCode?: boolean;
39
+ /**
40
+ * A futures contract's tick, the smallest move its price makes: the price
41
+ * prints to the tick's decimals, 0.0063535 for the yen's 0.0000005 and
42
+ * 1.11570 for the euro's 0.00005, never fewer.
43
+ */
44
+ tick?: number;
39
45
  /** A price that holds still for the session, such as the previous close. With
40
46
  * `fixedFractionDigits`, the kind's decimal ceiling is read at this price
41
47
  * instead of at the value, so a live price keeps its decimals as it moves. */
@@ -389,6 +395,11 @@ export function formatThirtySeconds(value: number): string {
389
395
  return `${sign}${points}-${String(Math.floor(rest / 8)).padStart(2, "0")}${EIGHTHS[rest % 8]}`;
390
396
  }
391
397
 
398
+ /** The decimals a contract's tick is written with (0.0000005 is 7, 0.25 is 2); undefined without one. */
399
+ function tickFractionDigits(tick: number | undefined): number | undefined {
400
+ return tick != null && Number.isFinite(tick) && tick > 0 ? writtenFractionDigits(tick, 10) : undefined;
401
+ }
402
+
392
403
  export function formatMarketPrice(value: number | undefined, options: MarketFormatOptions = {}): string {
393
404
  if (value === undefined || value === null || Number.isNaN(value)) return "—";
394
405
  const basis = resolvePriceBasis(options.priceBasis, options.assetCategory);
@@ -410,7 +421,7 @@ export function formatMarketPrice(value: number | undefined, options: MarketForm
410
421
  ? getBasePriceMaxFractionDigits(kind, value, options.currency) + quotedUnitDigits
411
422
  : marketPriceFractionDigitCeiling(reference, options) + quotedUnitDigits;
412
423
  let digits = Math.max(0, Math.min(fixedFractionDigits, maxFractionDigits));
413
- const tick = kind === "equity" || kind === "other" ? listingTickDigits(options.listingTickTable, reference ?? value) : undefined;
424
+ const tick = kind === "equity" || kind === "other" ? listingTickDigits(options.listingTickTable, reference ?? value) : tickFractionDigits(options.tick);
414
425
  if (tick !== undefined) digits = Math.max(digits, tick);
415
426
  // A live price keeps its instrument's decimals, but a trade finer than the
416
427
  // session prices showed (a half-yen print after whole-yen closes) is not
@@ -422,8 +433,8 @@ export function formatMarketPrice(value: number | undefined, options: MarketForm
422
433
  ? fitted
423
434
  : scientificPrice(value, options.maxWidth);
424
435
  }
425
- // A listing whose tick is finer than its currency's minor unit keeps the tick's decimals (an HKEX ETF's 5.325).
426
- const tick = kind === "equity" || kind === "other" ? listingTickDigits(options.listingTickTable, value) : undefined;
436
+ // A listing whose tick is finer than its currency's minor unit keeps the tick's decimals (an HKEX ETF's 5.325), as a contract does its own.
437
+ const tick = kind === "equity" || kind === "other" ? listingTickDigits(options.listingTickTable, value) : tickFractionDigits(options.tick);
427
438
  const baseFractionDigits = getBasePriceMaxFractionDigits(kind, value, options.currency);
428
439
  const minimumFractionDigits = Math.max(
429
440
  0,
@@ -1,6 +1,6 @@
1
1
  import type { MarketState, QuoteIndexSession } from "../../types/financials";
2
2
  import { canonicalExchange, EXCHANGE_TIME_ZONES, isUsListingExchange } from "../../utils/exchanges";
3
- import { hasPublishedApacCalendar, isPublishedApacClosure } from "../published-apac-sessions";
3
+ import { hasPublishedApacCalendar, isPublishedApacClosure, publishedApacEarlyClose } from "../published-apac-sessions";
4
4
  import { hasPublishedCnCalendar, isPublishedCnClosure } from "../published-cn-sessions";
5
5
  import { hasPublishedFuturesCalendar, isPublishedFuturesClosure, isPublishedFuturesVenue } from "../published-futures-sessions";
6
6
  import { hasPublishedJpxCalendar, isPublishedJpxClosure } from "../published-jpx-sessions";
@@ -343,8 +343,10 @@ function localWeekday(date: string): number | null {
343
343
  return day == null ? null : new Date(day * MS_PER_DAY).getUTCDay();
344
344
  }
345
345
 
346
- /** The local close of the venue's regular session on `date`, in minutes of the day. */
346
+ /** The local close of the venue's regular session on `date`, in minutes of the day, a published half day's included. */
347
347
  function regularCloseMinutes(exchange: string, date: string): number | undefined {
348
+ const early = publishedApacEarlyClose(exchange, date);
349
+ if (early !== undefined) return early;
348
350
  const weekday = localWeekday(date);
349
351
  return (weekday == null ? undefined : WEEKDAY_CLOSE_MINUTES[exchange]?.[weekday]) ?? REGULAR_CLOSE_MINUTES[exchange];
350
352
  }
@@ -602,18 +604,33 @@ export function isMiddayBreakPrint(
602
604
  now: number,
603
605
  feedLagMs: number,
604
606
  ): boolean {
607
+ if (!Number.isFinite(timestampMs) || timestampMs > now) return false;
608
+ const pause = middayBreakOn(exchange, now);
609
+ if (!pause) return false;
610
+ return now >= pause.start && now <= pause.end + feedLagMs + MIDDAY_BREAK_MARGIN_MS
611
+ && timestampMs >= pause.start - MIDDAY_BREAK_MARGIN_MS;
612
+ }
613
+
614
+ /**
615
+ * The venue's midday break on the local day `now` falls in (HKEX pauses
616
+ * 12:00 to 13:00), whatever the time of day: when it starts and when the
617
+ * afternoon session opens. Null for a venue that trades through the day, on a
618
+ * day outside its trading week, and on a half day that closes before the
619
+ * afternoon session would open (HKEX's Christmas Eve).
620
+ */
621
+ export function middayBreakOn(exchange: string | undefined, now: number): { start: number; end: number } | null {
605
622
  const canonical = canonicalExchange(exchange);
606
623
  const pause = MIDDAY_BREAKS[canonical];
607
624
  const timeZone = pause?.timeZone ?? EXCHANGE_TIME_ZONES[canonical];
608
- if (!pause || !timeZone || !Number.isFinite(timestampMs) || !Number.isFinite(now) || timestampMs > now) return false;
625
+ if (!pause || !timeZone || !Number.isFinite(now)) return null;
609
626
  const { year, month, day } = zonedDateTimeParts(now, timeZone);
610
627
  const weekday = new Date(Date.UTC(year, month - 1, day)).getUTCDay();
611
- if (!isTradingWeekday(canonical, weekday)) return false;
628
+ if (!isTradingWeekday(canonical, weekday)) return null;
612
629
  const [start, end] = weekday === 5 && pause.friday ? pause.friday : pause.weekdays;
630
+ const close = regularCloseMinutes(canonical, `${year}-${String(month).padStart(2, "0")}-${String(day).padStart(2, "0")}`);
631
+ if (close !== undefined && close <= end) return null;
613
632
  const at = (minutes: number) => zonedWallClockToUtcMs(timeZone, year, month, day, Math.floor(minutes / 60), minutes % 60, 0);
614
- const breakStart = at(start);
615
- return now >= breakStart && now <= at(end) + feedLagMs + MIDDAY_BREAK_MARGIN_MS
616
- && timestampMs >= breakStart - MIDDAY_BREAK_MARGIN_MS;
633
+ return { start: at(start), end: at(end) };
617
634
  }
618
635
 
619
636
  function usSessionState(timestampMs: number): UsSessionState {
@@ -0,0 +1,154 @@
1
+ import type { HeaderMarketChoice } from "../../types/config";
2
+ import { isRecord } from "../../utils/guards";
3
+
4
+ /** A market the header strip offers by name. */
5
+ export interface HeaderBenchmark {
6
+ id: string;
7
+ /** What the strip calls it: `S&P 500`, never its ETF. */
8
+ name: string;
9
+ symbol: string;
10
+ /** The venue whose hours and holidays the strip's market state follows. */
11
+ venue: string;
12
+ /**
13
+ * A listing that tracks it, shown under its own symbol when the benchmark
14
+ * itself has no usable quote for this account or source.
15
+ */
16
+ fallback?: string;
17
+ /** Other names the picker finds it by. */
18
+ keywords: string;
19
+ }
20
+
21
+ export const HEADER_BENCHMARKS: readonly HeaderBenchmark[] = [
22
+ { id: "sp500", name: "S&P 500", symbol: "^GSPC", venue: "NYSE", fallback: "SPY", keywords: "SPX US" },
23
+ { id: "nasdaq100", name: "Nasdaq 100", symbol: "^NDX", venue: "NASDAQ", fallback: "QQQ", keywords: "NDX US" },
24
+ { id: "dow", name: "Dow", symbol: "^DJI", venue: "NYSE", fallback: "DIA", keywords: "Dow Jones DJIA US" },
25
+ { id: "hang-seng", name: "Hang Seng", symbol: "^HSI", venue: "HKEX", fallback: "2800.HK", keywords: "HSI Hong Kong" },
26
+ { id: "csi300", name: "CSI 300", symbol: "000300.SS", venue: "SSE", fallback: "510300.SS", keywords: "China Shanghai Shenzhen" },
27
+ { id: "nikkei225", name: "Nikkei 225", symbol: "^N225", venue: "JPX", fallback: "1321.T", keywords: "NKY Japan Tokyo" },
28
+ { id: "sti", name: "STI", symbol: "^STI", venue: "SGX", fallback: "ES3.SI", keywords: "Straits Times Singapore" },
29
+ { id: "ftse100", name: "FTSE 100", symbol: "^FTSE", venue: "LSE", fallback: "ISF.L", keywords: "UKX UK London" },
30
+ { id: "dax", name: "DAX", symbol: "^GDAXI", venue: "XETRA", fallback: "EXS1.DE", keywords: "Germany Frankfurt Europe" },
31
+ { id: "btc", name: "BTC", symbol: "BTC-USD", venue: "CCC", keywords: "Bitcoin crypto" },
32
+ ];
33
+
34
+ const DEFAULT_BENCHMARK_ID = "sp500";
35
+ const BENCHMARKS_BY_ID = new Map(HEADER_BENCHMARKS.map((benchmark) => [benchmark.id, benchmark]));
36
+
37
+ /** Zones of continental Europe, whose default is the DAX. */
38
+ const DAX_ZONES = [
39
+ "Amsterdam", "Andorra", "Athens", "Belgrade", "Berlin", "Bratislava", "Brussels", "Bucharest", "Budapest", "Busingen",
40
+ "Chisinau", "Copenhagen", "Gibraltar", "Helsinki", "Kiev", "Kyiv", "Lisbon", "Ljubljana", "Luxembourg", "Madrid", "Malta",
41
+ "Mariehamn", "Monaco", "Oslo", "Paris", "Podgorica", "Prague", "Riga", "Rome", "San_Marino", "Sarajevo", "Skopje", "Sofia",
42
+ "Stockholm", "Tallinn", "Tirane", "Vaduz", "Vatican", "Vienna", "Vilnius", "Warsaw", "Zagreb", "Zurich",
43
+ ].map((city) => `Europe/${city}`);
44
+
45
+ /** The benchmark a machine's time zone starts the header on; every other zone gets the S&P 500. */
46
+ const ZONE_BENCHMARKS: Readonly<Record<string, string>> = {
47
+ "Asia/Hong_Kong": "hang-seng",
48
+ Hongkong: "hang-seng",
49
+ "Asia/Macau": "hang-seng",
50
+ "Asia/Singapore": "sti",
51
+ Singapore: "sti",
52
+ "Asia/Shanghai": "csi300",
53
+ "Asia/Chongqing": "csi300",
54
+ "Asia/Harbin": "csi300",
55
+ "Asia/Urumqi": "csi300",
56
+ PRC: "csi300",
57
+ "Asia/Tokyo": "nikkei225",
58
+ Japan: "nikkei225",
59
+ "Europe/London": "ftse100",
60
+ "Europe/Belfast": "ftse100",
61
+ "Europe/Guernsey": "ftse100",
62
+ "Europe/Isle_of_Man": "ftse100",
63
+ "Europe/Jersey": "ftse100",
64
+ GB: "ftse100",
65
+ ...Object.fromEntries(DAX_ZONES.map((zone) => [zone, "dax"])),
66
+ };
67
+
68
+ /** The benchmark the header shows before the user picks one, from the machine's time zone. */
69
+ export function defaultHeaderBenchmark(timeZone: string | null | undefined): HeaderBenchmark {
70
+ const id = (timeZone && ZONE_BENCHMARKS[timeZone]) || DEFAULT_BENCHMARK_ID;
71
+ return BENCHMARKS_BY_ID.get(id)!;
72
+ }
73
+
74
+ /** The zone this machine (or browser) reads local times in, as the header's default market follows it. */
75
+ export function systemTimeZone(): string | undefined {
76
+ try {
77
+ return Intl.DateTimeFormat().resolvedOptions().timeZone || undefined;
78
+ } catch { /* Intentional ignore: a runtime without a zone database starts on the default benchmark. */ return undefined; }
79
+ }
80
+
81
+ /** What the header shows, resolved from the saved choice. */
82
+ export interface HeaderMarketTarget {
83
+ /** Identifies the target for effects keyed on it. */
84
+ key: string;
85
+ /** What the strip calls the quote: a benchmark's name, or a listing's symbol. */
86
+ label: string;
87
+ symbol: string;
88
+ exchange: string;
89
+ /** The venue whose hours the market state follows; null for a listing, whose quote names its own. */
90
+ venue: string | null;
91
+ /** The listing shown when the benchmark itself has no usable quote. */
92
+ fallback: { label: string; symbol: string; exchange: string } | null;
93
+ /** The benchmark, when the target is one. */
94
+ benchmarkId: string | null;
95
+ }
96
+
97
+ function benchmarkTarget(benchmark: HeaderBenchmark): HeaderMarketTarget {
98
+ return {
99
+ key: `benchmark:${benchmark.id}`,
100
+ label: benchmark.name,
101
+ symbol: benchmark.symbol,
102
+ exchange: "",
103
+ venue: benchmark.venue,
104
+ fallback: benchmark.fallback ? { label: benchmark.fallback, symbol: benchmark.fallback, exchange: "" } : null,
105
+ benchmarkId: benchmark.id,
106
+ };
107
+ }
108
+
109
+ /**
110
+ * The benchmark a listing is, when it is one the header offers: `^HSI`
111
+ * searched for is the Hang Seng, on whichever venue its search row named.
112
+ */
113
+ export function headerBenchmarkForListing(symbol: string): HeaderBenchmark | null {
114
+ const normalized = symbol.trim().toUpperCase();
115
+ return HEADER_BENCHMARKS.find((benchmark) => benchmark.symbol === normalized) ?? null;
116
+ }
117
+
118
+ /** The header's market: the user's choice, or the benchmark of `timeZone` while they have made none. */
119
+ export function resolveHeaderMarket(choice: HeaderMarketChoice | undefined, timeZone: string | null | undefined): HeaderMarketTarget {
120
+ if (choice && "benchmark" in choice) {
121
+ const benchmark = BENCHMARKS_BY_ID.get(choice.benchmark);
122
+ if (benchmark) return benchmarkTarget(benchmark);
123
+ } else if (choice?.symbol) {
124
+ const benchmark = headerBenchmarkForListing(choice.symbol);
125
+ if (benchmark) return benchmarkTarget(benchmark);
126
+ const exchange = choice.exchange ?? "";
127
+ return {
128
+ key: `listing:${choice.symbol}:${exchange}`,
129
+ label: choice.symbol,
130
+ symbol: choice.symbol,
131
+ exchange,
132
+ venue: null,
133
+ fallback: null,
134
+ benchmarkId: null,
135
+ };
136
+ }
137
+ return benchmarkTarget(defaultHeaderBenchmark(timeZone));
138
+ }
139
+
140
+ /**
141
+ * A saved choice as this build reads it: a benchmark it offers, or a listing
142
+ * with a symbol. Anything else is no choice, and the header starts on the
143
+ * time zone's benchmark again.
144
+ */
145
+ export function sanitizeHeaderMarketChoice(value: unknown): HeaderMarketChoice | undefined {
146
+ if (!isRecord(value)) return undefined;
147
+ if (typeof value.benchmark === "string") {
148
+ return BENCHMARKS_BY_ID.has(value.benchmark) ? { benchmark: value.benchmark } : undefined;
149
+ }
150
+ const symbol = typeof value.symbol === "string" ? value.symbol.trim() : "";
151
+ if (!symbol) return undefined;
152
+ const exchange = typeof value.exchange === "string" ? value.exchange.trim() : "";
153
+ return exchange ? { symbol, exchange } : { symbol };
154
+ }
@@ -1,5 +1,6 @@
1
1
  import { classifyInstrumentType, isCryptoVenuePerpetual } from "../../tickers/instrument-kind";
2
2
  import type { PriceBasis } from "../../types/instrument";
3
+ import type { MarketState, Quote } from "../../types/financials";
3
4
 
4
5
  /**
5
6
  * The unit an index level is in, as a chart's axis and series name it. A
@@ -19,6 +20,9 @@ export const INDEX_POINTS_LABEL = "Index points";
19
20
  /** How an export names it, in `currency_or_unit` and a `unit` field. */
20
21
  export const INDEX_POINTS_EXPORT_UNIT = "index points";
21
22
 
23
+ /** How an export names a Cboe yield index's unit (^TNX at 4.859 is a yield in percent), in `quote` and `history` alike. */
24
+ export const YIELD_INDEX_EXPORT_UNIT = "pct";
25
+
22
26
  /**
23
27
  * An index level is points, not money: ^GSPC at 7,805.45 or ^VIX at 19.99 has
24
28
  * no currency to name, wherever it is shown, though its quote names the
@@ -28,6 +32,31 @@ export function isIndexLevel(instrumentType: string | null | undefined): boolean
28
32
  return classifyInstrumentType(instrumentType) === "index";
29
33
  }
30
34
 
35
+ /**
36
+ * A bar's volume as an index level reports it. An index's 0 is a volume its
37
+ * source does not count (^HSI's hourly bars, a day built from its quote),
38
+ * never a session without trades: none, as `quote` leaves it blank. An index
39
+ * whose source sums its members' volume (^GSPC) keeps it, as any other bar does.
40
+ */
41
+ export function indexBarVolume(volume: number | null | undefined, instrumentType: string | null | undefined): number | null {
42
+ if (volume == null || !Number.isFinite(volume)) return null;
43
+ return volume === 0 && isIndexLevel(instrumentType) ? null : volume;
44
+ }
45
+
46
+ /**
47
+ * The market state an index level's quote is read in. An index is computed in
48
+ * its regular session only: a source's POST beside no after-hours print is that
49
+ * session's final close (^VIX and ^TNX after Cboe's close), so it reads CLOSED,
50
+ * as the status cell and the source line say it. Any other quote keeps its state.
51
+ */
52
+ export function indexLevelMarketState(quote: Pick<Quote, "marketState" | "instrumentType" | "postMarketPrice">): MarketState | undefined {
53
+ const state = quote.marketState;
54
+ if ((state === "POST" || state === "POSTPOST") && isIndexLevel(quote.instrumentType) && !(quote.postMarketPrice != null && quote.postMarketPrice > 0)) {
55
+ return "CLOSED";
56
+ }
57
+ return state;
58
+ }
59
+
31
60
  /** The currency a quote's price is in: none for an index level, nor for a quote that names none. */
32
61
  export function quotePriceCurrency(quote: { currency?: string | null; instrumentType?: string | null } | null | undefined): string | null {
33
62
  if (!quote || isIndexLevel(quote.instrumentType)) return null;
@@ -0,0 +1,44 @@
1
+ /**
2
+ * The venue whose trading days and hours an index's bars follow, for the
3
+ * bare index symbols quoted outside the US. A bare symbol is otherwise read
4
+ * as its US listing, so the Hang Seng's hourly bars, which end at 16:10 Hong
5
+ * Kong time, were judged against New York's close and refused as behind:
6
+ * `history ^HSI --range 1W` answered "No history provider available".
7
+ * Venues are the ones the session tables know (freshness.ts).
8
+ */
9
+ const INDEX_SESSION_VENUES: Readonly<Record<string, string>> = {
10
+ "^HSI": "HKEX",
11
+ "^HSCE": "HKEX",
12
+ "^HSTECH": "HKEX",
13
+ "^N225": "JPX",
14
+ "^KS11": "KRX",
15
+ "^KQ11": "KOSDAQ",
16
+ "^TWII": "TWSE",
17
+ "^AXJO": "ASX",
18
+ "^AORD": "ASX",
19
+ "^NSEI": "NSE",
20
+ "^NSEBANK": "NSE",
21
+ "^BSESN": "BSE",
22
+ "^STI": "SGX",
23
+ "^NZ50": "NZX",
24
+ "^FTSE": "LSE",
25
+ "^FTMC": "LSE",
26
+ "^GDAXI": "XETRA",
27
+ "^STOXX50E": "XETRA",
28
+ "^FCHI": "EPA",
29
+ "^AEX": "AMS",
30
+ "^BFX": "BRU",
31
+ "^SSMI": "SWX",
32
+ "^ATX": "VIE",
33
+ "^OMX": "SFB",
34
+ "^OMXH25": "HEL",
35
+ "^OMXC25": "CPH",
36
+ "^PSI20": "LIS",
37
+ "^GSPTSE": "TSX",
38
+ "^MXX": "BMV",
39
+ };
40
+
41
+ /** The venue a bare index symbol's sessions follow; null for any other symbol and for US indices. */
42
+ export function indexSessionVenue(symbol: string | null | undefined): string | null {
43
+ return symbol ? INDEX_SESSION_VENUES[symbol.trim().toUpperCase()] ?? null : null;
44
+ }
@@ -3,10 +3,11 @@ import { blendHex, colors, priceColor, type ThemeColors } from "../../theme/colo
3
3
  import { isFiniteNumber } from "../../utils/guards";
4
4
  import { canonicalExchange, isKnownExchangeCode } from "../../utils/exchanges";
5
5
  import { quoteTradingDay } from "../quotes/day-range";
6
- import { isQuoteBeforeLatestSession } from "../quotes/freshness";
6
+ import { awaitingFirstDelayedPrint, isQuoteBeforeLatestSession } from "../quotes/freshness";
7
7
  import { delistingLabel, delistingStateLabel } from "../quotes/delisting";
8
8
  import { preMarketOpenOn, regularSessionCloseOn, venueSessionOnOrBefore } from "./freshness";
9
9
  import { futuresWeekendClosure } from "./futures-week";
10
+ import { indexLevelMarketState } from "./index-level";
10
11
 
11
12
  const CLOSED_CHANGE_MUTING_RATIO = 0.55;
12
13
  const US_SESSION_TIME = new Intl.DateTimeFormat("en-US", {
@@ -106,7 +107,11 @@ function closeLabel(date: string): string {
106
107
  */
107
108
  function quoteMarketState(quote: Quote | null | undefined, now = Date.now()): MarketState | undefined {
108
109
  if (!quote?.marketState) return undefined;
109
- return futuresWeekendClosure(quote.listingExchangeName || quote.exchangeName, now) ? "CLOSED" : quote.marketState;
110
+ if (futuresWeekendClosure(quote.listingExchangeName || quote.exchangeName, now)) return "CLOSED";
111
+ // The session follows the venue's calendar: LSE is open at 08:09, though its delayed feed has not printed in it yet.
112
+ if (quote.marketState !== "REGULAR" && awaitingFirstDelayedPrint(quote, now)) return "REGULAR";
113
+ // An index's final close is a close, not an after-hours session.
114
+ return indexLevelMarketState(quote);
110
115
  }
111
116
 
112
117
  /**
@@ -0,0 +1,72 @@
1
+ import { canonicalExchange, isUsListingExchange } from "../../utils/exchanges";
2
+ import { zonedDateKey } from "../../utils/zoned-date-time";
3
+ import {
4
+ hasPublishedSessionCalendar,
5
+ isAlwaysOpenExchange,
6
+ isRegularSessionTime,
7
+ isTradingWeekday,
8
+ isVenueTradingDay,
9
+ middayBreakOn,
10
+ nextRegularSessionOpen,
11
+ regularSessionCloseOn,
12
+ } from "./freshness";
13
+
14
+ /**
15
+ * Where a venue's trading day stands: in its regular session, paused for
16
+ * lunch, in a US listing's pre-market or after-hours, closed for the night
17
+ * or a weekend, or closed on a weekday for a published holiday.
18
+ */
19
+ export type VenueSessionPhase = "open" | "lunch" | "pre-market" | "after-hours" | "closed" | "holiday";
20
+
21
+ export interface VenueSessionNow {
22
+ phase: VenueSessionPhase;
23
+ /** The venue's own zone, which its hours are read in. */
24
+ timeZone: string;
25
+ /** While open: when the regular session closes, a published early close included. */
26
+ closesAt?: number;
27
+ /** Otherwise: when the regular session opens next, or the afternoon session after a lunch break. */
28
+ opensAt?: number;
29
+ }
30
+
31
+ /** A US listing's after-hours session runs four hours past the regular close (to 20:00, 17:00 after a 13:00 close). */
32
+ const US_AFTER_HOURS_MS = 4 * 60 * 60_000;
33
+ /** The US pre-market opens at 04:00 New York, five and a half hours before the regular open. */
34
+ const US_PRE_MARKET_MS = 5.5 * 60 * 60_000;
35
+
36
+ /**
37
+ * A venue's session at `now`, from its own hours and published calendar
38
+ * (`freshness`): its regular open and close, its midday break and half
39
+ * days, its weekend and holidays, and for a US listing the pre-market and
40
+ * after-hours around the regular session. Null for a venue whose hours the
41
+ * app does not know, for one that trades around the clock, and on a day of a
42
+ * year whose closures the venue has not published: a holiday there would
43
+ * read as a session (LSE and XETRA publish none here). When the next open
44
+ * falls in such a year, it is left out.
45
+ */
46
+ export function venueSessionNow(exchange: string | undefined, now: number): VenueSessionNow | null {
47
+ const venue = canonicalExchange(exchange);
48
+ if (!venue || isAlwaysOpenExchange(venue) || !Number.isFinite(now)) return null;
49
+ const next = nextRegularSessionOpen(venue, now);
50
+ if (!next) return null;
51
+ const { timeZone } = next;
52
+ const today = zonedDateKey(now, timeZone);
53
+ if (!hasPublishedSessionCalendar(venue, today)) return null;
54
+ if (isRegularSessionTime(venue, now)) {
55
+ const pause = middayBreakOn(venue, now);
56
+ if (pause && now >= pause.start && now < pause.end) return { phase: "lunch", timeZone, opensAt: pause.end };
57
+ const closesAt = regularSessionCloseOn(venue, today);
58
+ return { phase: "open", timeZone, ...(closesAt != null && closesAt > now ? { closesAt } : {}) };
59
+ }
60
+ // The walk to the next open never spans more than two years, so both ends published covers every day between.
61
+ const opening = hasPublishedSessionCalendar(venue, next.date) ? { opensAt: next.open } : {};
62
+ if (!isVenueTradingDay(venue, today)) {
63
+ const weekday = new Date(`${today}T00:00:00Z`).getUTCDay();
64
+ return { phase: isTradingWeekday(venue, weekday) ? "holiday" : "closed", timeZone, ...opening };
65
+ }
66
+ if (isUsListingExchange(venue)) {
67
+ if (next.date === today && now >= next.open - US_PRE_MARKET_MS) return { phase: "pre-market", timeZone, ...opening };
68
+ const closed = regularSessionCloseOn(venue, today);
69
+ if (closed != null && now >= closed && now < closed + US_AFTER_HOURS_MS) return { phase: "after-hours", timeZone, ...opening };
70
+ }
71
+ return { phase: "closed", timeZone, ...opening };
72
+ }
@@ -1,6 +1,6 @@
1
1
  import type { CorporateActionsData, Fundamentals } from "../types/financials";
2
2
  import { abortable, settleWithin } from "../utils/async-deadline";
3
- import { distributionHistory, forwardYieldMayHaveLapsed, lapsedDividend, lastPaidNote, NO_CURRENT_DIVIDEND } from "../utils/forward-dividend";
3
+ import { distributionHistory, forwardYieldMayHaveLapsed, historyEndsText, lapsedDividend, lastPaidNote, NO_CURRENT_DIVIDEND } from "../utils/forward-dividend";
4
4
 
5
5
  /**
6
6
  * How long a distribution history must go without a dividend before it says a
@@ -29,6 +29,10 @@ const HISTORY_DEADLINE_MS = 5_000;
29
29
  * paid 2026-02-27, whose stated 12.91% annualized a payment that did not
30
30
  * recur. `lastPaid` dates it.
31
31
  *
32
+ * A monthly payer's history that ends (lapsedDividend's `historyEnds`) says
33
+ * nothing of whether it still pays: a stated yield stands, with `historyEnds`
34
+ * the last ex-date its history holds, and none stated stays unknown.
35
+ *
32
36
  * Null when none says: an unknown yield is never taken as 0.
33
37
  */
34
38
  export interface ModelDividendYield {
@@ -37,6 +41,8 @@ export interface ModelDividendYield {
37
41
  basis: "stated" | "none-paid" | "stopped";
38
42
  /** The last distribution's ex-date (YYYY-MM-DD) of a `stopped` dividend; null when unknown. */
39
43
  lastPaid?: string | null;
44
+ /** A `stated` yield's last ex-date (YYYY-MM-DD) in a monthly payer's history that ends there. */
45
+ historyEnds?: string | null;
40
46
  }
41
47
 
42
48
  /** What the yield is read from: the fundamentals' yield, its basis, and the ex-date of the distribution it annualizes. */
@@ -61,10 +67,16 @@ function paysNoDividend(actions: CorporateActionsData, now: number): boolean {
61
67
  && !(actions.declaredDividends ?? []).some((dividend) => recent(dividend.exDate));
62
68
  }
63
69
 
64
- /** 0, dated by the last distribution, when the current history shows the dividend dated `asOf` stopped (lapsedDividend). */
65
- function stoppedDividend(asOf: string | undefined, actions: CorporateActionsData, now: number): ModelDividendYield | null {
70
+ /**
71
+ * 0, dated by the last distribution, when the current history shows the
72
+ * dividend dated `asOf` stopped (lapsedDividend); `stated`, with the day it
73
+ * ends, when a monthly payer's history ends; else `stated`.
74
+ */
75
+ function checkedDividend(stated: ModelDividendYield | null, asOf: string | undefined, actions: CorporateActionsData, now: number): ModelDividendYield | null {
66
76
  const lapse = lapsedDividend(asOf, distributionHistory(actions, new Date(now)), new Date(now));
67
- return lapse ? { value: 0, basis: "stopped", lastPaid: lapse.lastPaid } : null;
77
+ if (!lapse) return stated;
78
+ if (lapse.historyEnds) return stated ? { ...stated, historyEnds: lapse.lastPaid } : null;
79
+ return { value: 0, basis: "stopped", lastPaid: lapse.lastPaid };
68
80
  }
69
81
 
70
82
  interface DividendHistoryOptions {
@@ -96,9 +108,9 @@ export async function loadModelDividendYield(
96
108
  const read = await abortable(settleWithin(Promise.resolve().then(loadActions), timeoutMs), signal, "Dividend history read was cancelled");
97
109
  const actions = currentHistory(read, symbol) ? read : null;
98
110
  if (!actions) return statedYield;
99
- if (statedYield) return stoppedDividend(stated?.exDividendDate, actions, now) ?? statedYield;
111
+ if (statedYield) return checkedDividend(statedYield, stated?.exDividendDate, actions, now);
100
112
  if (paysNoDividend(actions, now)) return { value: 0, basis: "none-paid" };
101
- return stoppedDividend(stated?.exDividendDate, actions, now);
113
+ return checkedDividend(null, stated?.exDividendDate, actions, now);
102
114
  }
103
115
 
104
116
  /** What a yield the history shows none paid is, beside the 0%: `no dividend in the last 15 months`. */
@@ -107,9 +119,12 @@ const NO_DIVIDEND_PAID = "no dividend in the last 15 months";
107
119
  /**
108
120
  * What a yield read as 0 is, beside the 0%: `no dividend in the last 15
109
121
  * months`, or `no current dividend, last paid 2026-02-27` in the words every
110
- * pane reads a stopped dividend in. Null for a stated yield.
122
+ * pane reads a stopped dividend in; beside a stated yield whose monthly
123
+ * history ends, `distribution history ends 2026-09-01`. Null for any other
124
+ * stated yield.
111
125
  */
112
- export function modelDividendYieldNote(dividend: Pick<ModelDividendYield, "basis" | "lastPaid"> | null | undefined): string | null {
126
+ export function modelDividendYieldNote(dividend: Pick<ModelDividendYield, "basis" | "lastPaid" | "historyEnds"> | null | undefined): string | null {
127
+ if (dividend?.basis === "stated" && dividend.historyEnds) return historyEndsText(dividend.historyEnds);
113
128
  if (dividend?.basis === "none-paid") return NO_DIVIDEND_PAID;
114
129
  if (dividend?.basis !== "stopped") return null;
115
130
  const lastPaid = lastPaidNote({ lastPaid: dividend.lastPaid ?? null });
@@ -67,9 +67,14 @@ export function isOptionsUnavailableError(error: unknown): boolean {
67
67
  return /\boptions provider available for\b/i.test(message);
68
68
  }
69
69
 
70
- /** "Options are not available for GC=F.": the dead end itself, before any follow-up. */
70
+ /**
71
+ * "Options are not available for GC=F.": the dead end itself, before any
72
+ * follow-up. A CME currency future says what is not served: "Options on CME
73
+ * yen futures (6J=F) are not served." CME lists them; this app does not.
74
+ */
71
75
  export function optionsUnavailableTitle(symbol: string): string {
72
- return `Options are not available for ${symbol.trim().toUpperCase()}.`;
76
+ const typed = symbol.trim().toUpperCase();
77
+ return currencyFutureName(typed) ? fxVolatilityLead(typed) : `Options are not available for ${typed}.`;
73
78
  }
74
79
 
75
80
  /**
@@ -139,6 +144,19 @@ const FX_FUTURES_PAIRS: Readonly<Record<string, string>> = {
139
144
  "6E": "EURUSD", "6J": "USDJPY", "6B": "GBPUSD", "6A": "AUDUSD", "6C": "USDCAD", "6S": "USDCHF", "6N": "NZDUSD", "6M": "USDMXN",
140
145
  };
141
146
 
147
+ /** What each CME currency future is a future on, as a sentence names it. */
148
+ const FX_FUTURES_CURRENCIES: Readonly<Record<string, string>> = {
149
+ "6E": "euro", "6J": "yen", "6B": "pound", "6A": "Australian dollar", "6C": "Canadian dollar", "6S": "Swiss franc",
150
+ "6N": "New Zealand dollar", "6M": "Mexican peso",
151
+ };
152
+
153
+ /** "yen" for a CME currency future (6J=F, 6JZ26, 6J1); null for anything else. */
154
+ function currencyFutureName(symbol: string): string | null {
155
+ if (currencyPairCode(symbol)) return null;
156
+ const root = futuresRoot(symbol, (candidate) => !!FX_FUTURES_PAIRS[candidate]);
157
+ return root ? FX_FUTURES_CURRENCIES[root] ?? null : null;
158
+ }
159
+
142
160
  /** The US-listed currency funds whose options stand in for an FX pair's volatility, by the currency they hold. */
143
161
  const FX_VOL_FUNDS: Readonly<Record<string, string>> = { EUR: "FXE", JPY: "FXY", GBP: "FXB" };
144
162
  /** The fund that holds the dollar against a basket, for a pair none of the single-currency funds holds. */
@@ -163,6 +181,17 @@ function fxVolatilityFunds(pair: string): string[] {
163
181
  return held.length > 0 ? held : FX_VOL_FUND_LIST;
164
182
  }
165
183
 
184
+ /**
185
+ * The one fund whose options stand in for a pair's volatility: the fund that
186
+ * holds its euro, yen or pound (USDJPY: FXY), else the dollar fund for a
187
+ * dollar pair (AUDUSD: UUP). Null for a cross two funds hold, or none.
188
+ */
189
+ export function fxVolatilityProxyFund(pair: string): string | null {
190
+ const funds = fxVolatilityFunds(pair);
191
+ if (funds === FX_VOL_FUND_LIST) return pair.includes("USD") ? DOLLAR_FUND : null;
192
+ return funds.length === 1 ? funds[0]! : null;
193
+ }
194
+
166
195
  /**
167
196
  * What exists instead for the volatility of an FX pair or currency future,
168
197
  * worded as one line for the CLI: OTC FX volatility is not served, the
@@ -178,10 +207,16 @@ function fxVolatilityAnswer(code: string, symbol: string): string | null {
178
207
  const funds = fxVolatilityFunds(pair);
179
208
  // VCA screens every fund; the others read the pair's own, or the dollar's when it has none.
180
209
  const read = code === "VCA" ? funds.join(",") : funds === FX_VOL_FUND_LIST ? DOLLAR_FUND : funds[0]!;
181
- return `OTC FX volatility is not covered for ${typed}. Currency-ETF options are the listed proxy: `
210
+ return `${fxVolatilityLead(typed)} Currency-ETF options are the listed proxy: `
182
211
  + `${funds.join(", ")} (gloom fn ${code} ${read}). Realized volatility: gloom fn HVT ${typed}.`;
183
212
  }
184
213
 
214
+ /** What is not served: options on a CME currency future, which CME lists, or OTC volatility for a spot pair. */
215
+ function fxVolatilityLead(typed: string): string {
216
+ const currency = currencyFutureName(typed);
217
+ return currency ? `Options on CME ${currency} futures (${typed}) are not served.` : `OTC FX volatility is not covered for ${typed}.`;
218
+ }
219
+
185
220
  /**
186
221
  * The same for a pane, which has no commands to give: what is not covered,
187
222
  * the funds whose options stand in, and HVT for realized volatility.
@@ -189,7 +224,7 @@ function fxVolatilityAnswer(code: string, symbol: string): string | null {
189
224
  export function fxVolatilityNote(symbol: string, exchange?: string): string | null {
190
225
  const pair = fxVolatilityPair(symbol, exchange);
191
226
  if (!pair) return null;
192
- return `OTC FX volatility is not covered for ${symbol.trim().toUpperCase()}. Currency-ETF options are the listed proxy: `
227
+ return `${fxVolatilityLead(symbol.trim().toUpperCase())} Currency-ETF options are the listed proxy: `
193
228
  + `${fxVolatilityFunds(pair).join(", ")}. HVT shows the pair's realized volatility.`;
194
229
  }
195
230