gloomberb 0.20.2 → 0.20.3

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 (362) 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-form.tsx +13 -8
  5. package/src/account/upgrade-dialog.tsx +1 -1
  6. package/src/api-client/central-bank-rates.ts +5 -0
  7. package/src/api-client/data.ts +17 -4
  8. package/src/api-client/debt-maturities.ts +45 -2
  9. package/src/api-client/earnings.ts +4 -2
  10. package/src/api-client/errors.ts +21 -11
  11. package/src/api-client/index.ts +1 -0
  12. package/src/api-client/paths.ts +9 -1
  13. package/src/api-client/social-mentions.ts +47 -0
  14. package/src/api-client/types/econ.ts +4 -0
  15. package/src/app.tsx +11 -1
  16. package/src/cli/command-options.ts +2 -1
  17. package/src/cli/commands/market.ts +111 -29
  18. package/src/cli/commands/options-chain.ts +23 -6
  19. package/src/cli/commands/overview.ts +13 -5
  20. package/src/cli/commands/plugins.ts +49 -18
  21. package/src/cli/commands/search.ts +25 -6
  22. package/src/cli/commands/ticker.ts +4 -2
  23. package/src/cli/fx-quote-rate.ts +49 -1
  24. package/src/cli/glossary.ts +95 -15
  25. package/src/cli/history-rows.ts +9 -25
  26. package/src/cli/index.ts +6 -38
  27. package/src/cli/known-gaps.ts +3 -3
  28. package/src/cli/listing-arg.ts +78 -18
  29. package/src/cli/name-entries.ts +3 -2
  30. package/src/cli/not-a-ticker.ts +6 -2
  31. package/src/cli/pane-functions/capabilities.ts +12 -1
  32. package/src/cli/pane-functions/function-help.ts +23 -11
  33. package/src/cli/pane-functions/headless.ts +3 -1
  34. package/src/cli/pane-functions/index.ts +32 -4
  35. package/src/cli/pane-functions/market-session.ts +8 -3
  36. package/src/cli/pane-functions/resolver.ts +18 -11
  37. package/src/cli/pane-functions/screenshot-payload.ts +36 -6
  38. package/src/cli/pane-functions/screenshot-render.ts +4 -0
  39. package/src/cli/quote-answer.ts +10 -0
  40. package/src/cli/report-tables.ts +22 -2
  41. package/src/cli/result.ts +7 -3
  42. package/src/cli/spreadsheet-hint.ts +43 -0
  43. package/src/cli/symbol-list.ts +58 -4
  44. package/src/cli/symbol-rows.ts +49 -2
  45. package/src/cli/ticker-resolution.ts +98 -5
  46. package/src/cli/unknown-command.ts +88 -0
  47. package/src/components/command-bar/assist/model.ts +6 -1
  48. package/src/components/command-bar/commands/direct/index.ts +9 -1
  49. package/src/components/command-bar/commands/registry.ts +18 -0
  50. package/src/components/command-bar/pane-actions.ts +30 -13
  51. package/src/components/command-bar/panel/index.tsx +6 -3
  52. package/src/components/command-bar/panel/prompt-binding.ts +4 -0
  53. package/src/components/command-bar/panel/types.ts +3 -0
  54. package/src/components/command-bar/routes/header-market.ts +108 -0
  55. package/src/components/command-bar/routes/root/command-items.ts +5 -0
  56. package/src/components/command-bar/routes/root/provider-search.ts +190 -32
  57. package/src/components/command-bar/routes/root/results.ts +3 -0
  58. package/src/components/command-bar/routes/root/runtime.ts +28 -5
  59. package/src/components/command-bar/routes/ticker-search/results.ts +53 -6
  60. package/src/components/command-bar/routing/list-state.ts +38 -0
  61. package/src/components/command-bar/selection-hint.ts +28 -0
  62. package/src/components/command-bar/surface/index.tsx +41 -3
  63. package/src/components/command-bar/view-model.ts +15 -0
  64. package/src/components/command-bar/workflow/tickers.ts +3 -2
  65. package/src/components/company-logo.tsx +20 -2
  66. package/src/components/data-table/export.ts +13 -8
  67. package/src/components/feedback-dialog.tsx +2 -1
  68. package/src/components/form-modal/field-row.tsx +2 -1
  69. package/src/components/input-search-bar.tsx +2 -2
  70. package/src/components/layout/double-escape-close.ts +8 -5
  71. package/src/components/layout/header.tsx +75 -44
  72. package/src/components/layout/market-summary.ts +322 -116
  73. package/src/components/layout/pane/footer/index.tsx +26 -8
  74. package/src/components/layout/pane/footer/model.ts +46 -20
  75. package/src/components/layout/pane/header.tsx +3 -2
  76. package/src/components/layout/shell/chrome.ts +15 -15
  77. package/src/components/layout/status-bar.tsx +8 -7
  78. package/src/components/layout/status-widget-space.ts +8 -0
  79. package/src/components/markdown-editor.tsx +2 -2
  80. package/src/components/onboarding/account-step/form-panel.tsx +0 -3
  81. package/src/components/onboarding/onboarding-keyboard.ts +15 -6
  82. package/src/components/onboarding/onboarding-wizard.tsx +61 -11
  83. package/src/components/onboarding/portfolio-step/broker-fields-panel.tsx +0 -1
  84. package/src/components/onboarding/portfolio-step/positions-panel.tsx +0 -2
  85. package/src/components/price-sparkline/model.ts +26 -10
  86. package/src/components/ticker/list-table-view.tsx +29 -4
  87. package/src/components/ui/button.tsx +13 -2
  88. package/src/components/ui/column-grid.tsx +18 -9
  89. package/src/components/ui/data-table/index.tsx +1 -1
  90. package/src/components/ui/data-table/opentui/index.tsx +2 -1
  91. package/src/components/ui/data-table/types.ts +18 -0
  92. package/src/components/ui/delayed-mark.tsx +3 -2
  93. package/src/components/ui/field-grid.tsx +0 -2
  94. package/src/components/ui/fields.tsx +7 -4
  95. package/src/components/ui/inline-quick-add.tsx +2 -2
  96. package/src/components/ui/key-hint-words.ts +153 -0
  97. package/src/components/ui/key-hints.tsx +73 -0
  98. package/src/components/ui/menu.tsx +3 -1
  99. package/src/components/ui/message-composer.tsx +2 -2
  100. package/src/components/ui/shortcut-hint.tsx +28 -3
  101. package/src/components/ui/tabs.tsx +7 -0
  102. package/src/components/ui/text-prompt-dialog.tsx +2 -1
  103. package/src/core/state/app/command-bar-launch.ts +3 -0
  104. package/src/data/config/store/normalize.ts +6 -0
  105. package/src/docs/snapshot.json +120 -69
  106. package/src/i18n/es.ts +24 -1
  107. package/src/i18n/ja.ts +24 -1
  108. package/src/i18n/ko.ts +24 -1
  109. package/src/i18n/zh-cn.ts +24 -1
  110. package/src/i18n/zh-tw.ts +24 -1
  111. package/src/layout/pane-manager/gridlock.ts +11 -0
  112. package/src/market-data/bars-per-year.ts +27 -9
  113. package/src/market-data/coordinator/quotes.ts +22 -3
  114. package/src/market-data/futures-board.ts +80 -0
  115. package/src/market-data/futures-contract.ts +9 -3
  116. package/src/market-data/market/change-basis.ts +2 -2
  117. package/src/market-data/market/dated-previous-close.ts +163 -47
  118. package/src/market-data/market/format.ts +14 -3
  119. package/src/market-data/market/freshness.ts +24 -7
  120. package/src/market-data/market/header-market.ts +154 -0
  121. package/src/market-data/market/index-level.ts +29 -0
  122. package/src/market-data/market/index-session-venues.ts +44 -0
  123. package/src/market-data/market/status.ts +7 -2
  124. package/src/market-data/market/venue-session.ts +72 -0
  125. package/src/market-data/model-dividend-yield.ts +23 -8
  126. package/src/market-data/options-alternatives.ts +39 -4
  127. package/src/market-data/published-apac-sessions.ts +40 -2
  128. package/src/market-data/quotes/export-identity.ts +76 -0
  129. package/src/market-data/quotes/freshness.ts +22 -0
  130. package/src/market-data/quotes/time.ts +42 -1
  131. package/src/market-data/realized-volatility.ts +11 -7
  132. package/src/market-data/tax-equivalent.ts +145 -27
  133. package/src/plugins/builtin/account-management/pane.tsx +2 -2
  134. package/src/plugins/builtin/alerts/alert-engine.ts +12 -6
  135. package/src/plugins/builtin/alerts/alert-log.ts +6 -2
  136. package/src/plugins/builtin/alerts/calendar-events.ts +74 -12
  137. package/src/plugins/builtin/alerts/cli-forms.ts +11 -1
  138. package/src/plugins/builtin/alerts/cli-move.ts +234 -0
  139. package/src/plugins/builtin/alerts/cli.ts +224 -33
  140. package/src/plugins/builtin/alerts/command.ts +33 -6
  141. package/src/plugins/builtin/alerts/event-rows.ts +18 -4
  142. package/src/plugins/builtin/alerts/events-pane.tsx +6 -2
  143. package/src/plugins/builtin/alerts/events.ts +9 -0
  144. package/src/plugins/builtin/alerts/format.ts +40 -15
  145. package/src/plugins/builtin/alerts/headless.ts +31 -18
  146. package/src/plugins/builtin/alerts/history.ts +1 -0
  147. package/src/plugins/builtin/alerts/index.tsx +86 -12
  148. package/src/plugins/builtin/alerts/live.ts +2 -1
  149. package/src/plugins/builtin/alerts/move-checks.ts +155 -0
  150. package/src/plugins/builtin/alerts/move.ts +160 -0
  151. package/src/plugins/builtin/alerts/pane.tsx +52 -22
  152. package/src/plugins/builtin/alerts/price-text.ts +62 -0
  153. package/src/plugins/builtin/alerts/price.ts +17 -0
  154. package/src/plugins/builtin/alerts/quotes.ts +84 -3
  155. package/src/plugins/builtin/alerts/scheduled-check.ts +7 -1
  156. package/src/plugins/builtin/alerts/storage.ts +20 -7
  157. package/src/plugins/builtin/alerts/types.ts +13 -0
  158. package/src/plugins/builtin/analytics/risk-client.ts +60 -39
  159. package/src/plugins/builtin/analytics/risk-episodes.ts +18 -0
  160. package/src/plugins/builtin/analytics/risk-headless.ts +20 -4
  161. package/src/plugins/builtin/analytics/risk-model.ts +68 -1
  162. package/src/plugins/builtin/analytics/risk-pane.tsx +15 -3
  163. package/src/plugins/builtin/backtest/engine.ts +4 -2
  164. package/src/plugins/builtin/backtest/window.ts +3 -1
  165. package/src/plugins/builtin/broker-manager/sign-in-end.ts +1 -1
  166. package/src/plugins/builtin/central-bank-rates/client.ts +4 -0
  167. package/src/plugins/builtin/central-bank-rates/headless.ts +1 -1
  168. package/src/plugins/builtin/central-bank-rates/model.ts +18 -8
  169. package/src/plugins/builtin/central-bank-rates/pane.tsx +6 -3
  170. package/src/plugins/builtin/chart-composer/cli-options.ts +5 -0
  171. package/src/plugins/builtin/chart-composer/headless-schema.ts +17 -1
  172. package/src/plugins/builtin/chart-composer/headless.ts +2 -0
  173. package/src/plugins/builtin/cloud/upgrade-status-widget.tsx +9 -2
  174. package/src/plugins/builtin/crypto-board/headless.ts +82 -17
  175. package/src/plugins/builtin/crypto-board/index.tsx +24 -2
  176. package/src/plugins/builtin/crypto-board/model.ts +5 -2
  177. package/src/plugins/builtin/crypto-board/pane.tsx +4 -1
  178. package/src/plugins/builtin/debt-maturities/client.ts +111 -6
  179. package/src/plugins/builtin/debt-maturities/headless.ts +84 -1
  180. package/src/plugins/builtin/debt-maturities/model.ts +97 -14
  181. package/src/plugins/builtin/debt-maturities/pane.tsx +165 -15
  182. package/src/plugins/builtin/debt-maturities/series.ts +3 -1
  183. package/src/plugins/builtin/dividend-yield/client.ts +22 -6
  184. package/src/plugins/builtin/dividend-yield/headless.ts +113 -46
  185. package/src/plugins/builtin/dividend-yield/model.ts +5 -2
  186. package/src/plugins/builtin/dividend-yield/pane.tsx +6 -3
  187. package/src/plugins/builtin/dividend-yield/ranking-reads.ts +11 -4
  188. package/src/plugins/builtin/dividend-yield/ranking.ts +113 -18
  189. package/src/plugins/builtin/dividend-yield/types.ts +2 -0
  190. package/src/plugins/builtin/dividend-yield/view.ts +3 -0
  191. package/src/plugins/builtin/econ/calendar-model.ts +21 -3
  192. package/src/plugins/builtin/econ/detail-view.tsx +5 -3
  193. package/src/plugins/builtin/econ/figures.ts +13 -0
  194. package/src/plugins/builtin/econ/fred-catalog.ts +6 -3
  195. package/src/plugins/builtin/econ/index.tsx +5 -3
  196. package/src/plugins/builtin/econ/types.ts +5 -0
  197. package/src/plugins/builtin/equity-screener/footer.ts +45 -0
  198. package/src/plugins/builtin/equity-screener/pane.tsx +4 -18
  199. package/src/plugins/builtin/equity-screener/ticker-check.tsx +2 -1
  200. package/src/plugins/builtin/fixed-income/model.ts +1 -0
  201. package/src/plugins/builtin/futures/table.tsx +1 -1
  202. package/src/plugins/builtin/futures-curve/model.ts +3 -10
  203. package/src/plugins/builtin/help/function-card.tsx +2 -1
  204. package/src/plugins/builtin/help/function-index.ts +1 -0
  205. package/src/plugins/builtin/insider/client.ts +31 -14
  206. package/src/plugins/builtin/insider/signals-model.ts +2 -7
  207. package/src/plugins/builtin/iv-history/headless.ts +1 -2
  208. package/src/plugins/builtin/iv-history/model.ts +33 -23
  209. package/src/plugins/builtin/iv-history/screen-pane.tsx +0 -3
  210. package/src/plugins/builtin/kelly-sizer/headless.ts +64 -16
  211. package/src/plugins/builtin/kelly-sizer/history.ts +37 -28
  212. package/src/plugins/builtin/kelly-sizer/pane.tsx +43 -10
  213. package/src/plugins/builtin/kelly-sizer/sections.tsx +7 -2
  214. package/src/plugins/builtin/kelly-sizer/units.ts +29 -0
  215. package/src/plugins/builtin/news/index.tsx +7 -13
  216. package/src/plugins/builtin/news/overview-headlines.tsx +117 -0
  217. package/src/plugins/builtin/news/ticker-news.ts +35 -0
  218. package/src/plugins/builtin/news/wire/news/detail-view.tsx +8 -6
  219. package/src/plugins/builtin/news/wire/news/row.ts +49 -0
  220. package/src/plugins/builtin/news/wire/news/table.tsx +9 -20
  221. package/src/plugins/builtin/options/analytics.ts +7 -2
  222. package/src/plugins/builtin/options/live-quotes.ts +6 -1
  223. package/src/plugins/builtin/options/table.ts +3 -2
  224. package/src/plugins/builtin/options/view.tsx +11 -9
  225. package/src/plugins/builtin/options-scenario/client.ts +3 -0
  226. package/src/plugins/builtin/options-scenario/headless.ts +1 -1
  227. package/src/plugins/builtin/perps/client.ts +5 -4
  228. package/src/plugins/builtin/perps/headless.ts +134 -124
  229. package/src/plugins/builtin/perps/markets-section.tsx +2 -2
  230. package/src/plugins/builtin/perps/model.ts +8 -4
  231. package/src/plugins/builtin/perps/open-market.ts +4 -4
  232. package/src/plugins/builtin/perps/venue-markets.ts +3 -6
  233. package/src/plugins/builtin/portfolio-list/cell-version.ts +1 -0
  234. package/src/plugins/builtin/portfolio-list/cli/bulk-symbols.ts +34 -10
  235. package/src/plugins/builtin/portfolio-list/cli/period-report.ts +28 -2
  236. package/src/plugins/builtin/portfolio-list/cli/portfolio-command.ts +7 -3
  237. package/src/plugins/builtin/portfolio-list/cli/render.ts +66 -22
  238. package/src/plugins/builtin/portfolio-list/grid.tsx +5 -3
  239. package/src/plugins/builtin/portfolio-list/pane/data.ts +34 -1
  240. package/src/plugins/builtin/portfolio-list/pane/index.tsx +6 -0
  241. package/src/plugins/builtin/portfolio-list/pane/streaming.ts +15 -6
  242. package/src/plugins/builtin/portfolio-list/quick-add/resolution.ts +19 -7
  243. package/src/plugins/builtin/portfolio-list/table.tsx +30 -4
  244. package/src/plugins/builtin/realized-vol/evidence.ts +33 -6
  245. package/src/plugins/builtin/realized-vol/fx-proxy.ts +135 -0
  246. package/src/plugins/builtin/realized-vol/headless.ts +44 -8
  247. package/src/plugins/builtin/realized-vol/model.ts +9 -5
  248. package/src/plugins/builtin/realized-vol/pane.tsx +49 -15
  249. package/src/plugins/builtin/sec/headless.ts +48 -6
  250. package/src/plugins/builtin/sec/index.tsx +6 -4
  251. package/src/plugins/builtin/sec/model.ts +4 -1
  252. package/src/plugins/builtin/shared/earnings-calendar.ts +2 -0
  253. package/src/plugins/builtin/shared/market-cap-bands.ts +12 -0
  254. package/src/plugins/builtin/shared/report-freshness.ts +3 -1
  255. package/src/plugins/builtin/shared/use-quote-board.ts +5 -3
  256. package/src/plugins/builtin/shared/volatility/options.ts +63 -2
  257. package/src/plugins/builtin/social-mentions/headless.ts +72 -3
  258. package/src/plugins/builtin/social-mentions/index.tsx +8 -4
  259. package/src/plugins/builtin/social-mentions/lock-note.ts +6 -2
  260. package/src/plugins/builtin/social-mentions/outliers-client.ts +101 -0
  261. package/src/plugins/builtin/social-mentions/outliers-model.ts +162 -0
  262. package/src/plugins/builtin/social-mentions/outliers-names.ts +51 -0
  263. package/src/plugins/builtin/social-mentions/outliers.tsx +276 -0
  264. package/src/plugins/builtin/social-mentions/pane.tsx +32 -3
  265. package/src/plugins/builtin/supply-chain/graph-pane.tsx +2 -2
  266. package/src/plugins/builtin/thirteenf/api.ts +36 -2
  267. package/src/plugins/builtin/thirteenf/data.ts +4 -1
  268. package/src/plugins/builtin/thirteenf/headless.ts +14 -6
  269. package/src/plugins/builtin/thirteenf/model.ts +56 -1
  270. package/src/plugins/builtin/thirteenf/pane.tsx +8 -8
  271. package/src/plugins/builtin/thirteenf/report-notes.ts +11 -0
  272. package/src/plugins/builtin/thirteenf/table.ts +2 -1
  273. package/src/plugins/builtin/thirteenf/types.ts +6 -0
  274. package/src/plugins/builtin/ticker-detail/data-panes/historical-prices.tsx +23 -3
  275. package/src/plugins/builtin/ticker-detail/financials/model.ts +5 -0
  276. package/src/plugins/builtin/ticker-detail/headless-schema.ts +2 -1
  277. package/src/plugins/builtin/ticker-detail/headless.ts +21 -66
  278. package/src/plugins/builtin/ticker-detail/index.tsx +5 -0
  279. package/src/plugins/builtin/ticker-detail/overview/components.tsx +13 -1
  280. package/src/plugins/builtin/ticker-detail/overview/model.ts +6 -4
  281. package/src/plugins/builtin/ticker-detail/overview/pane.tsx +15 -0
  282. package/src/plugins/builtin/ticker-detail/overview/tax-equivalent.ts +69 -0
  283. package/src/plugins/builtin/ticker-detail/overview-tab.tsx +41 -6
  284. package/src/plugins/builtin/ticker-detail/quote-monitor/card.tsx +47 -24
  285. package/src/plugins/builtin/ticker-detail/quote-monitor/export.ts +46 -0
  286. package/src/plugins/builtin/ticker-detail/quote-monitor/index.tsx +20 -1
  287. package/src/plugins/builtin/ticker-detail/quote-monitor/rows.ts +120 -0
  288. package/src/plugins/builtin/ticker-detail/research-tabs.ts +1 -5
  289. package/src/plugins/builtin/ticker-detail/settings.ts +6 -6
  290. package/src/plugins/builtin/treasury-auctions/cache.ts +85 -19
  291. package/src/plugins/builtin/treasury-auctions/index.tsx +22 -11
  292. package/src/plugins/builtin/treasury-auctions/model.ts +23 -0
  293. package/src/plugins/builtin/treasury-auctions/treasury-direct.ts +128 -0
  294. package/src/plugins/builtin/world-indices/client.ts +2 -0
  295. package/src/plugins/compat.ts +15 -0
  296. package/src/plugins/host-link.ts +6 -1
  297. package/src/plugins/installer.ts +8 -3
  298. package/src/portfolio/column-values.ts +14 -4
  299. package/src/portfolio/listed-symbol.ts +78 -0
  300. package/src/portfolio/real-return.ts +172 -0
  301. package/src/public/__snapshots__/public-api.test.ts.snap +1 -0
  302. package/src/renderers/browser/config-host.ts +56 -15
  303. package/src/renderers/browser/main.tsx +3 -1
  304. package/src/renderers/browser/ui-host.tsx +1 -0
  305. package/src/renderers/cloudflare/http-proxy.ts +1 -0
  306. package/src/renderers/dom/boot-frame.ts +2 -2
  307. package/src/renderers/dom/data-table/row.tsx +4 -1
  308. package/src/renderers/dom/desktop/controls.tsx +4 -4
  309. package/src/renderers/dom/desktop/dialog-actions.tsx +60 -41
  310. package/src/renderers/dom/dom-ui-host.tsx +3 -1
  311. package/src/renderers/dom/host/input.tsx +4 -1
  312. package/src/renderers/dom/host/tabs.tsx +10 -1
  313. package/src/renderers/dom/styles.css +33 -13
  314. package/src/renderers/electrobun/bun/desktop/app-name.ts +1 -1
  315. package/src/renderers/opentui/host.tsx +2 -1
  316. package/src/sources/gloomberb-cloud/fred-series.ts +12 -0
  317. package/src/sources/gloomberb-cloud/index.ts +31 -2
  318. package/src/sources/gloomberb-cloud/normalizers.ts +29 -3
  319. package/src/sources/provider-router/cached-routes.ts +19 -7
  320. package/src/state/pane-table-export-registry.ts +19 -6
  321. package/src/test-support/preload.ts +5 -1
  322. package/src/theme/colors.ts +9 -1
  323. package/src/theme/themes.ts +62 -15
  324. package/src/theme/tone-contrast.ts +40 -0
  325. package/src/theme/ui-tokens.ts +23 -3
  326. package/src/tickers/batched-lookups.ts +57 -8
  327. package/src/tickers/company-name-listing.ts +156 -14
  328. package/src/tickers/company-name.ts +30 -6
  329. package/src/tickers/list.ts +7 -0
  330. package/src/tickers/search/home-listing.ts +31 -9
  331. package/src/tickers/search/index.ts +13 -3
  332. package/src/tickers/search/listing-index.ts +558 -0
  333. package/src/tickers/search/major-listings.chunk.ts +10 -0
  334. package/src/tickers/search/major-listings.json +3346 -0
  335. package/src/tickers/search/ranking.ts +68 -1
  336. package/src/tickers/search/types.ts +4 -0
  337. package/src/tickers/terminal-codes.ts +26 -1
  338. package/src/time-series/calendar-month-returns.ts +47 -0
  339. package/src/time-series/currency-conversion.ts +130 -0
  340. package/src/time-series/hooks.ts +2 -0
  341. package/src/time-series/price-comparison.ts +34 -11
  342. package/src/time-series/resolve-context.ts +3 -0
  343. package/src/time-series/resolve.ts +14 -2
  344. package/src/time-series/spec.ts +1 -0
  345. package/src/time-series/studies/indicators.ts +4 -1
  346. package/src/time-series/types.ts +8 -0
  347. package/src/types/config.ts +8 -0
  348. package/src/types/data-provider.ts +28 -0
  349. package/src/types/financials.ts +20 -2
  350. package/src/types/headless.ts +12 -0
  351. package/src/ui/host.tsx +8 -0
  352. package/src/utils/datetime-format.ts +17 -3
  353. package/src/utils/display-number.ts +15 -0
  354. package/src/utils/double-escape-close.ts +61 -16
  355. package/src/utils/float32-price.ts +24 -0
  356. package/src/utils/forward-dividend.ts +81 -16
  357. package/src/utils/fx-market-hours.ts +11 -0
  358. package/src/utils/plugin-proxy-hosts.json +2 -1
  359. package/src/utils/price-history.ts +7 -6
  360. package/src/utils/report-timing.ts +62 -0
  361. package/src/utils/sec-filings.ts +32 -0
  362. package/src/utils/utc-time.ts +5 -0
@@ -5,19 +5,38 @@ import { canonicalExchange } from "../../utils/exchanges";
5
5
  import { logFailure } from "../../utils/log-failure";
6
6
  import { dailyBarDate } from "../../utils/price-history";
7
7
  import { classifyInstrumentType } from "../../tickers/instrument-kind";
8
- import { changeBasisSessionDate, isChangeBasisDatedWithoutCloses, quoteChangeBasis } from "./change-basis";
8
+ import { calendarVenue, changeBasisSessionDate, isChangeBasisDatedWithoutCloses, quoteChangeBasis } from "./change-basis";
9
+ import { cleanFloat32Price } from "../../utils/float32-price";
9
10
 
10
11
  /** History closes come as float32 (30.93000030517578) where the quote says 30.93: one close. */
11
12
  const SAME_CLOSE_RELATIVE = 1e-5;
12
13
  /**
13
- * How long a reading that named no day stands before the closes are read
14
- * again: a history a session behind catches up, a failed read is retried.
14
+ * An index's previous close and its daily close of that day closer than this,
15
+ * as a share of the close, are one close told twice (a feed that rounds to a
16
+ * decimal): a hundredth of a percent, the precision a day change is shown to.
17
+ */
18
+ const SAME_INDEX_CLOSE_RELATIVE = 1e-4;
19
+ /**
20
+ * How long a reading that named no day, or corrected an index's close,
21
+ * stands before the closes are read again: a history a session behind
22
+ * catches up, a failed read is retried, a correction is checked again.
15
23
  */
16
24
  const UNDATED_RETRY_MS = 10 * 60_000;
17
25
  /** Readings kept at once; the oldest goes first. */
18
26
  const MAX_READINGS = 2_000;
19
27
  /** Daily histories read at once. */
20
28
  const MAX_READS_IN_FLIGHT = 6;
29
+ /**
30
+ * Index checks read at once, in a pool of their own: a board of the world's
31
+ * indices (`fn WEI`) checks two dozen at the same time, each one small read.
32
+ */
33
+ const MAX_INDEX_READS_IN_FLIGHT = 32;
34
+ /**
35
+ * The longest a caller waits for an index check. Gloom Cloud measures an
36
+ * index's move from its previous session's bar already: this check stands
37
+ * behind it, so it must never make a board of indices slow.
38
+ */
39
+ const INDEX_CHECK_WAIT_MS = 300;
21
40
  /** How long one read may take before its slot goes to the next: a hung read must not stall the rest. */
22
41
  const READ_DEADLINE_MS = 10_000;
23
42
 
@@ -28,8 +47,9 @@ export interface DatedCloseListing {
28
47
  context?: MarketDataRequestContext;
29
48
  }
30
49
 
31
- /** A listing's recent daily closes (a month is enough). */
32
- export type ReadDailyCloses = (listing: DatedCloseListing) => Promise<readonly Pick<PricePoint, "date" | "close">[]>;
50
+ /** A listing's recent daily closes (a month is enough), with the flags that say a bar had not closed yet. */
51
+ export type ReadDailyCloses = (listing: DatedCloseListing) => Promise<readonly DailyClose[]>;
52
+ type DailyClose = Pick<PricePoint, "date" | "close" | "partial" | "unsettled">;
33
53
 
34
54
  export interface PreviousCloseDatesOptions {
35
55
  /** Called with the latest copy of a quote, dated, when a read lands that names its day. */
@@ -37,10 +57,17 @@ export interface PreviousCloseDatesOptions {
37
57
  now?: () => number;
38
58
  maxReadsInFlight?: number;
39
59
  readDeadlineMs?: number;
60
+ /** The longest `settle` waits for index checks (INDEX_CHECK_WAIT_MS). */
61
+ indexWaitMs?: number;
40
62
  }
41
63
 
42
64
  interface Reading {
43
65
  date: string | null;
66
+ /**
67
+ * The listing's daily close on `date`, when the quote's own previous close
68
+ * disagrees with it: an index's, whose move is then measured from it.
69
+ */
70
+ close?: number;
44
71
  at: number;
45
72
  }
46
73
 
@@ -54,74 +81,153 @@ function sameClose(left: number, right: number): boolean {
54
81
  }
55
82
 
56
83
  /**
57
- * What dates a quote's previous close by its listing's daily closes: the
58
- * listing, the session the move is dated to and the close itself. Null for a
59
- * quote something else dates (its venue's calendar, a coin's UTC day, a
60
- * future's terms, a close the source dated), one with no move from a previous
61
- * close, and an option, whose chain would read a history per contract. The
62
- * venue's calendar is checked first, since this runs on every tick.
84
+ * What dates a quote's previous close by its listing's daily closes, or
85
+ * checks an index's dated one against them: the listing, the session the
86
+ * move is dated to and the close itself. Null for any other quote something
87
+ * else dates (its venue's calendar, a coin's UTC day, a future's terms, a
88
+ * close the source dated), one with no move from a previous close, and an
89
+ * option, whose chain would read a history per contract. The instrument type
90
+ * and the venue's calendar are checked first, since this runs on every tick.
63
91
  */
64
92
  function readingKey(quote: Quote | null | undefined, listing: DatedCloseListing, now: number): string | null {
65
- if (!quote || isChangeBasisDatedWithoutCloses(quote, now) || classifyInstrumentType(quote.instrumentType) === "option") return null;
93
+ if (!quote || classifyInstrumentType(quote.instrumentType) === "option") return null;
94
+ // An index's dated close is checked against its daily close of that day as well (indexCloseOn), but for a Cboe
95
+ // index's, which Gloom Cloud checks against Cboe's own closes.
96
+ if (datedIndexClose(quote)) return calendarVenue(quote) === "CBOE" ? null : datedReadingKey(quote, listing);
97
+ if (isChangeBasisDatedWithoutCloses(quote, now)) return null;
66
98
  if (quoteChangeBasis(quote)?.kind !== "previous close") return null;
99
+ return datedReadingKey(quote, listing);
100
+ }
101
+
102
+ function datedReadingKey(quote: Quote, listing: DatedCloseListing): string | null {
67
103
  const previousClose = quote.previousClose;
68
104
  const sessionDate = changeBasisSessionDate(quote);
69
105
  if (previousClose == null || !Number.isFinite(previousClose) || !sessionDate) return null;
70
106
  return `${datedCloseListingKey(listing)}|${sessionDate}|${previousClose}`;
71
107
  }
72
108
 
109
+ /**
110
+ * The closed daily bars of a history, dated where the listing trades: by the
111
+ * venue whose calendar its sessions follow (HKSE's bars by HKEX's zone, not
112
+ * UTC). A bar whose period had not ended when it was served (`partial`), or a
113
+ * future's session awaiting settlement, is no close: a copy kept from the
114
+ * session before (a US holiday) must never stand for that session's close.
115
+ */
116
+ function closedBars(points: readonly DailyClose[], quote: Quote): Array<{ date: string; close: number }> {
117
+ const venue = calendarVenue(quote);
118
+ return points.flatMap((point) => {
119
+ const time = new Date(point.date).getTime();
120
+ if (point.partial || point.unsettled || !Number.isFinite(time) || !Number.isFinite(point.close)) return [];
121
+ return [{ date: dailyBarDate(time, venue), close: point.close }];
122
+ });
123
+ }
124
+
73
125
  /**
74
126
  * The day of the latest daily close before the move's session, when that
75
127
  * close is the quote's previous close; null otherwise, so a gap in the
76
128
  * history never names the wrong day.
77
129
  */
78
- function latestCloseBefore(points: readonly Pick<PricePoint, "date" | "close">[], quote: Quote): string | null {
130
+ function latestCloseBefore(points: readonly DailyClose[], quote: Quote): string | null {
79
131
  const sessionDate = changeBasisSessionDate(quote)!;
80
- const exchange = quote.listingExchangeName ?? quote.exchangeName ?? "";
81
- const before = points
82
- .map((point) => ({ time: new Date(point.date).getTime(), close: point.close }))
83
- .filter((point) => Number.isFinite(point.time) && Number.isFinite(point.close))
84
- .map((point) => ({ date: dailyBarDate(point.time, exchange), close: point.close }))
132
+ const before = closedBars(points, quote)
85
133
  .filter((point) => point.date < sessionDate)
86
134
  .sort((left, right) => left.date.localeCompare(right.date))
87
135
  .at(-1);
88
136
  return before && sameClose(before.close, quote.previousClose!) ? before.date : null;
89
137
  }
90
138
 
139
+ /**
140
+ * The day an index quote's move is measured from, when something dates it
141
+ * (its venue's calendar, the sessions its source sent): the day whose close
142
+ * its previous close must be. Null for any other quote.
143
+ */
144
+ function datedIndexClose(quote: Quote): string | null {
145
+ if (classifyInstrumentType(quote.instrumentType) !== "index") return null;
146
+ const basis = quoteChangeBasis(quote);
147
+ return basis?.kind === "close" ? basis.date : null;
148
+ }
149
+
150
+ /**
151
+ * An index's previous close is its previous session's
152
+ * close: the listing's daily close on the day its move is dated from, when
153
+ * the closes hold that day. On Fri 6 Nov 2026 a source's quote of the Hang
154
+ * Seng said 23,919.5, Wed 4 Nov's close, "vs Thu 5 Nov close", while its daily
155
+ * close of Thu 5 Nov, the one HP charts, was 24,796.98: +2.35% beside -1.27%.
156
+ * The reading names the day either way, and the close when it disagrees.
157
+ */
158
+ function indexCloseOn(points: readonly DailyClose[], quote: Quote, date: string): { date: string | null; close?: number } {
159
+ const bar = closedBars(points, quote).findLast((point) => point.close > 0 && point.date === date);
160
+ if (!bar) return { date: null };
161
+ // Bars come as float32 (24796.98046875): the close is the decimal it is, as Gloom Cloud serves it.
162
+ const close = cleanFloat32Price(bar.close);
163
+ const previousClose = quote.previousClose!;
164
+ return Math.abs(previousClose - close) <= close * SAME_INDEX_CLOSE_RELATIVE ? { date } : { date, close };
165
+ }
166
+
167
+ function readingOf(points: readonly DailyClose[], quote: Quote): { date: string | null; close?: number } {
168
+ const indexDate = datedIndexClose(quote);
169
+ return indexDate ? indexCloseOn(points, quote, indexDate) : { date: latestCloseBefore(points, quote) };
170
+ }
171
+
91
172
  function withDate<T extends Quote | null | undefined>(quote: T, date: string | null | undefined): T {
92
173
  return date && quote ? { ...quote, previousCloseDate: date } : quote;
93
174
  }
94
175
 
176
+ /** The quote as a reading has it: dated, and for an index measured from that day's close when its own disagrees. */
177
+ function withReading<T extends Quote | null | undefined>(quote: T, reading: Pick<Reading, "date" | "close"> | undefined): T {
178
+ if (!quote || !reading?.date) return quote;
179
+ if (reading.close == null) return withDate(quote, reading.date);
180
+ const close = reading.close;
181
+ const change = quote.price - close;
182
+ // A completed session's move of the same day is measured from it too: getRegularSessionDisplay rebuilds it.
183
+ const sameSession = quote.regularCloseSessionDate != null && quote.regularCloseSessionDate === quote.changeSessionDate;
184
+ return {
185
+ ...quote,
186
+ previousClose: close,
187
+ previousCloseDate: reading.date,
188
+ change,
189
+ changePercent: (change / close) * 100,
190
+ ...(sameSession ? { regularChange: undefined, regularChangePercent: undefined } : {}),
191
+ };
192
+ }
193
+
95
194
  /**
96
195
  * Dates the previous close a quote's move is from where the venue's calendar
97
196
  * cannot (LSE and Helsinki publish none the app carries), by the listing's
98
197
  * own daily closes, so every surface that reads quotes through the app's
99
- * quote router names the day (`quoteChangeBasis`). The closes are read once
198
+ * quote router names the day (`quoteChangeBasis`), and an index's move is
199
+ * measured from its previous session's close (indexCloseOn). The closes are read once
100
200
  * per listing, session and close, and the answer is kept: a refresh, a tick
101
201
  * or a cached read of the same quote is dated without another read. A few
102
- * reads run at once, each for at most ten seconds.
202
+ * reads run at once, each for at most ten seconds; index checks run in a
203
+ * wider pool of their own.
103
204
  */
104
205
  export class PreviousCloseDates {
105
206
  private readonly readings = new Map<string, Reading>();
106
- private readonly pending = new Map<string, Promise<string | null>>();
207
+ private readonly pending = new Map<string, Promise<Pick<Reading, "date" | "close">>>();
107
208
  /** The latest copy of each quote a read is pending for, which the read dates when it lands. */
108
209
  private readonly latestCopies = new Map<string, { quote: Quote; listing: DatedCloseListing }>();
109
- private readonly waiting: Array<() => void> = [];
110
- private active = 0;
210
+ /** Dating reads and index checks queue apart, so neither waits behind the other. */
211
+ private readonly pools: Record<"dating" | "index", { active: number; waiting: Array<() => void>; max: number }>;
111
212
  private readonly now: () => number;
112
- private readonly maxReadsInFlight: number;
113
213
  private readonly readDeadlineMs: number;
214
+ private readonly indexWaitMs: number;
114
215
 
115
216
  constructor(private readonly readCloses: ReadDailyCloses, private readonly options: PreviousCloseDatesOptions = {}) {
116
217
  this.now = options.now ?? (() => Date.now());
117
- this.maxReadsInFlight = options.maxReadsInFlight ?? MAX_READS_IN_FLIGHT;
218
+ const max = options.maxReadsInFlight ?? MAX_READS_IN_FLIGHT;
219
+ this.pools = {
220
+ dating: { active: 0, waiting: [], max },
221
+ index: { active: 0, waiting: [], max: Math.max(max, MAX_INDEX_READS_IN_FLIGHT) },
222
+ };
118
223
  this.readDeadlineMs = options.readDeadlineMs ?? READ_DEADLINE_MS;
224
+ this.indexWaitMs = options.indexWaitMs ?? INDEX_CHECK_WAIT_MS;
119
225
  }
120
226
 
121
227
  /** The quote dated by what was already read for it; as it was when nothing was. Never reads. */
122
228
  known<T extends Quote | null | undefined>(quote: T, listing: DatedCloseListing): T {
123
229
  const key = readingKey(quote, listing, this.now());
124
- return key ? withDate(quote, this.readings.get(key)?.date) : quote;
230
+ return key ? withReading(quote, this.readings.get(key)) : quote;
125
231
  }
126
232
 
127
233
  /**
@@ -134,70 +240,80 @@ export class PreviousCloseDates {
134
240
  if (!key) return quote;
135
241
  const reading = this.readings.get(key);
136
242
  if (!this.stands(reading)) void this.start(key, quote!, listing);
137
- return withDate(quote, reading?.date);
243
+ return withReading(quote, reading);
138
244
  }
139
245
 
140
246
  /**
141
247
  * Starts the reads these quotes need and waits for them, at most `waitMs`
142
248
  * in all and no longer than `signal` lets it; `known` then dates them.
249
+ * Index checks run side by side and are waited for at most `indexWaitMs`.
143
250
  */
144
251
  async settle(
145
252
  entries: ReadonlyArray<{ quote: Quote; listing: DatedCloseListing }>,
146
253
  { waitMs, signal }: { waitMs: number; signal?: AbortSignal },
147
254
  ): Promise<void> {
148
255
  if (signal?.aborted) return;
149
- const reads: Promise<string | null>[] = [];
256
+ const reads: Promise<unknown>[] = [];
257
+ const checks: Promise<unknown>[] = [];
150
258
  for (const { quote, listing } of entries) {
151
259
  const key = readingKey(quote, listing, this.now());
152
- if (key && !this.stands(this.readings.get(key))) reads.push(this.start(key, quote, listing));
260
+ if (key && !this.stands(this.readings.get(key))) (datedIndexClose(quote) ? checks : reads).push(this.start(key, quote, listing));
153
261
  }
154
- if (reads.length) await settleWithin(abortable(Promise.all(reads), signal, "Stopped waiting for daily closes"), waitMs);
262
+ const within = (all: Promise<unknown>[], ms: number) => all.length
263
+ ? settleWithin(abortable(Promise.all(all), signal, "Stopped waiting for daily closes"), ms) : null;
264
+ await Promise.all([within(reads, waitMs), within(checks, Math.min(waitMs, this.indexWaitMs))]);
155
265
  }
156
266
 
157
- /** Whether a reading answers without another read: a day it named, or no day named lately. */
267
+ /**
268
+ * Whether a reading answers without another read: a day it named that
269
+ * agreed with the quote's close, or any other reading taken lately. A
270
+ * correction (an index's close the quote disagreed with) is read again as
271
+ * an undated one is, so a wrong close cannot stand for the session.
272
+ */
158
273
  private stands(reading: Reading | undefined): boolean {
159
- return !!reading && (!!reading.date || this.now() - reading.at < UNDATED_RETRY_MS);
274
+ return !!reading && ((!!reading.date && reading.close == null) || this.now() - reading.at < UNDATED_RETRY_MS);
160
275
  }
161
276
 
162
- private start(key: string, quote: Quote, listing: DatedCloseListing): Promise<string | null> {
277
+ private start(key: string, quote: Quote, listing: DatedCloseListing): Promise<Pick<Reading, "date" | "close">> {
163
278
  this.latestCopies.set(key, { quote, listing });
164
279
  return this.pending.get(key) ?? this.read(key, quote, listing);
165
280
  }
166
281
 
167
- private read(key: string, quote: Quote, listing: DatedCloseListing): Promise<string | null> {
168
- const read = this.inSlot(() => withDeadline(Promise.resolve().then(() => this.readCloses(listing)), this.readDeadlineMs, "Reading daily closes timed out"))
169
- .then((points) => latestCloseBefore(points, quote))
170
- .catch(logFailure("market-data.dated-previous-close", "Read daily closes failed", null))
171
- .then((date) => {
282
+ private read(key: string, quote: Quote, listing: DatedCloseListing): Promise<Pick<Reading, "date" | "close">> {
283
+ const read = this.inSlot(datedIndexClose(quote) ? "index" : "dating", () => withDeadline(Promise.resolve().then(() => this.readCloses(listing)), this.readDeadlineMs, "Reading daily closes timed out"))
284
+ .then((points) => readingOf(points, quote))
285
+ .catch(logFailure("market-data.dated-previous-close", "Read daily closes failed", { date: null }))
286
+ .then((reading) => {
172
287
  this.pending.delete(key);
173
288
  this.readings.delete(key);
174
289
  if (this.readings.size >= MAX_READINGS) this.readings.delete(this.readings.keys().next().value!);
175
- this.readings.set(key, { date, at: this.now() });
290
+ this.readings.set(key, { ...reading, at: this.now() });
176
291
  const latest = this.latestCopies.get(key);
177
292
  this.latestCopies.delete(key);
178
- if (date && latest && this.options.onDated) {
293
+ if (reading.date && latest && this.options.onDated) {
179
294
  try {
180
- this.options.onDated(latest.listing, withDate(latest.quote, date));
295
+ this.options.onDated(latest.listing, withReading(latest.quote, reading));
181
296
  } catch (error) {
182
297
  logFailure("market-data.dated-previous-close", "Passing on a dated quote failed")(error);
183
298
  }
184
299
  }
185
- return date;
300
+ return reading;
186
301
  });
187
302
  this.pending.set(key, read);
188
303
  return read;
189
304
  }
190
305
 
191
- private async inSlot<T>(work: () => Promise<T>): Promise<T> {
192
- if (this.active < this.maxReadsInFlight) this.active += 1;
193
- else await new Promise<void>((resolve) => this.waiting.push(resolve));
306
+ private async inSlot<T>(kind: "dating" | "index", work: () => Promise<T>): Promise<T> {
307
+ const pool = this.pools[kind];
308
+ if (pool.active < pool.max) pool.active += 1;
309
+ else await new Promise<void>((resolve) => pool.waiting.push(resolve));
194
310
  try {
195
311
  return await work();
196
312
  } finally {
197
313
  // A finished read hands its slot to the next one waiting.
198
- const next = this.waiting.shift();
314
+ const next = pool.waiting.shift();
199
315
  if (next) next();
200
- else this.active -= 1;
316
+ else pool.active -= 1;
201
317
  }
202
318
  }
203
319
  }
@@ -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
+ }