gloomberb 0.20.0 → 0.20.2

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 (481) hide show
  1. package/README.md +16 -26
  2. package/README.zh-CN.md +21 -65
  3. package/package.json +1 -1
  4. package/patches/electrobun-devkit@2.0.5.patch +268 -8
  5. package/src/account/auth-model.ts +20 -1
  6. package/src/account/upgrade-dialog.tsx +8 -4
  7. package/src/api-client/askg.ts +7 -1
  8. package/src/api-client/auth.ts +27 -0
  9. package/src/api-client/catalysts.ts +2 -0
  10. package/src/api-client/company-kpis.ts +2 -1
  11. package/src/api-client/cot.ts +14 -2
  12. package/src/api-client/crypto-markets.ts +20 -2
  13. package/src/api-client/data.ts +3 -2
  14. package/src/api-client/earnings.ts +46 -3
  15. package/src/api-client/fund-facts.ts +23 -1
  16. package/src/api-client/futures-curve.ts +17 -0
  17. package/src/api-client/index.ts +4 -1
  18. package/src/api-client/one-tap-reasons.ts +42 -0
  19. package/src/api-client/perps.ts +2 -1
  20. package/src/api-client/request.ts +3 -1
  21. package/src/api-client/research-activity.ts +16 -3
  22. package/src/api-client/types/filings-and-calls.ts +9 -0
  23. package/src/api-client/types/search.ts +3 -0
  24. package/src/app/keybindings/chord.ts +153 -9
  25. package/src/app/keybindings/index.ts +1 -1
  26. package/src/app/keybindings/labels.ts +49 -6
  27. package/src/app/runtime/desktop-deeplink.ts +73 -8
  28. package/src/app/runtime/plugin-seed.ts +119 -0
  29. package/src/app/runtime/startup.ts +45 -9
  30. package/src/app.tsx +8 -1
  31. package/src/architecture/core-builtin-allowlist.json +1 -2
  32. package/src/architecture/pane-tabs-allowlist.json +2 -1
  33. package/src/architecture/shortcut-labels-allowlist.json +11 -0
  34. package/src/architecture/ui-literals-allowlist.json +8 -8
  35. package/src/brokers/broker-portfolio-sync.ts +1 -1
  36. package/src/cli/bank-section.ts +26 -12
  37. package/src/cli/board-coins.ts +38 -5
  38. package/src/cli/commands/crypto-hints.ts +8 -1
  39. package/src/cli/commands/market.ts +294 -100
  40. package/src/cli/commands/overview.ts +13 -6
  41. package/src/cli/commands/ticker.ts +73 -21
  42. package/src/cli/company-name-hint.ts +19 -0
  43. package/src/cli/desktop-pane-shot-browser.ts +47 -31
  44. package/src/cli/desktop-pane-shot.ts +15 -0
  45. package/src/cli/entry.ts +15 -4
  46. package/src/cli/export-source.ts +7 -1
  47. package/src/cli/freshness.ts +0 -16
  48. package/src/cli/fx-pair.ts +64 -12
  49. package/src/cli/fx-quote-rate.ts +144 -0
  50. package/src/cli/glossary.ts +30 -0
  51. package/src/cli/helpers.ts +4 -2
  52. package/src/cli/history-back-adjust.ts +122 -0
  53. package/src/cli/history-rows.ts +114 -10
  54. package/src/cli/index.ts +4 -1
  55. package/src/cli/known-gaps.ts +45 -3
  56. package/src/cli/listing-arg.ts +48 -4
  57. package/src/cli/name-entries.ts +25 -5
  58. package/src/cli/not-a-ticker.ts +26 -1
  59. package/src/cli/pane-functions/catalog.ts +12 -2
  60. package/src/cli/pane-functions/dom.ts +4 -2
  61. package/src/cli/pane-functions/freshness.ts +45 -29
  62. package/src/cli/pane-functions/headless.ts +8 -5
  63. package/src/cli/pane-functions/index.ts +3 -0
  64. package/src/cli/pane-functions/market-session.ts +14 -5
  65. package/src/cli/pane-functions/resolver.ts +4 -1
  66. package/src/cli/pane-functions/screenshot-assessment.ts +15 -3
  67. package/src/cli/pane-functions/screenshot-payload.ts +130 -66
  68. package/src/cli/pane-functions/screenshot-render.ts +14 -2
  69. package/src/cli/pane-functions/screenshot-types.ts +4 -0
  70. package/src/cli/restore-plugins.ts +164 -51
  71. package/src/cli/symbol-rows.ts +22 -2
  72. package/src/cli/ticker-resolution.ts +74 -17
  73. package/src/components/chart/composite/axis-overlays.tsx +13 -3
  74. package/src/components/chart/composite/composite-chart.tsx +8 -1
  75. package/src/components/chart/composite/format.ts +16 -1
  76. package/src/components/chart/composite/legend.tsx +4 -3
  77. package/src/components/chart/composite/panel-labels.ts +2 -1
  78. package/src/components/chart/composite/panel-surface.tsx +33 -4
  79. package/src/components/chart/composite/time-scale.ts +1 -1
  80. package/src/components/chart/composite/toolbar.tsx +8 -4
  81. package/src/components/chart/composite/types.ts +17 -1
  82. package/src/components/chart/composite/use-composite-chart-keyboard.ts +15 -5
  83. package/src/components/chart/composite/use-composite-viewport.ts +31 -8
  84. package/src/components/chart/static/scatter-chart-surface.tsx +25 -9
  85. package/src/components/chart-table/axis.ts +11 -0
  86. package/src/components/chart-table/header.tsx +10 -1
  87. package/src/components/chart-table/layout.ts +14 -5
  88. package/src/components/command-bar/assist/inventory.ts +3 -2
  89. package/src/components/command-bar/commands/collection-list.ts +3 -2
  90. package/src/components/command-bar/panel/index.tsx +13 -0
  91. package/src/components/command-bar/panel/layout.ts +15 -1
  92. package/src/components/command-bar/panel/prompt-width.ts +34 -0
  93. package/src/components/command-bar/panel/runtime.ts +1 -0
  94. package/src/components/command-bar/panel/state.ts +4 -0
  95. package/src/components/command-bar/panel/types.ts +2 -0
  96. package/src/components/command-bar/routes/root/search-providers.ts +3 -2
  97. package/src/components/command-bar/routes/root/search-report.ts +2 -2
  98. package/src/components/command-bar/workflow/ticker-listing-picker.ts +1 -0
  99. package/src/components/company-logo.tsx +2 -2
  100. package/src/components/data-table/view.tsx +11 -2
  101. package/src/components/feed-data-table/stack-view.tsx +20 -6
  102. package/src/components/feedback-dialog.tsx +3 -1
  103. package/src/components/form-modal/field-row.tsx +1 -1
  104. package/src/components/form-modal/routes.ts +1 -0
  105. package/src/components/index.ts +1 -1
  106. package/src/components/layout/header.tsx +12 -3
  107. package/src/components/layout/market-summary.ts +2 -1
  108. package/src/components/layout/pane/footer/index.tsx +9 -5
  109. package/src/components/layout/pane/footer/model.ts +26 -10
  110. package/src/components/layout/pane/footer/registration.tsx +60 -1
  111. package/src/components/layout/pane/header-tabs.tsx +17 -3
  112. package/src/components/layout/pane/header.tsx +5 -2
  113. package/src/components/layout/pane/pane-tabs.tsx +57 -3
  114. package/src/components/layout/shell/active-drag.ts +38 -30
  115. package/src/components/layout/shell/drag/index.ts +51 -21
  116. package/src/components/layout/shell/menu.ts +3 -5
  117. package/src/components/layout/shell/pane/actions.ts +4 -1
  118. package/src/components/layout/shell/pane/ask.ts +5 -2
  119. package/src/components/layout/status-bar.tsx +59 -54
  120. package/src/components/markdown-text.tsx +35 -10
  121. package/src/components/onboarding/first-run-workspace.ts +25 -23
  122. package/src/components/onboarding/onboarding-keyboard.ts +6 -1
  123. package/src/components/onboarding/onboarding-wizard.tsx +12 -2
  124. package/src/components/onboarding/portfolio-step/positions-panel.tsx +3 -3
  125. package/src/components/onboarding/use-onboarding-broker-form.ts +2 -1
  126. package/src/components/onboarding/use-onboarding-progress.ts +11 -4
  127. package/src/components/onboarding/use-onboarding-upgrade.ts +3 -2
  128. package/src/components/onboarding/wizard-positions.ts +8 -1
  129. package/src/components/pane-notice-seen.ts +125 -0
  130. package/src/components/pane-settings-dialog/field-dialogs.tsx +2 -1
  131. package/src/components/pane-settings-dialog.tsx +7 -6
  132. package/src/components/sign-in-code-panel.tsx +3 -2
  133. package/src/components/speedometer-gauge/terminal.tsx +30 -9
  134. package/src/components/ticker/list-table-view.tsx +39 -3
  135. package/src/components/ui/confirm-dialog.tsx +2 -1
  136. package/src/components/ui/data-table/index.tsx +4 -2
  137. package/src/components/ui/data-table/opentui/index.tsx +15 -5
  138. package/src/components/ui/data-table/types.ts +8 -0
  139. package/src/components/ui/external-link.tsx +4 -1
  140. package/src/components/ui/field-grid.tsx +1 -1
  141. package/src/components/ui/index.ts +2 -0
  142. package/src/components/ui/inline-quick-add.tsx +5 -0
  143. package/src/components/ui/multi-select/dialog.tsx +10 -9
  144. package/src/components/ui/pane-link-chip.tsx +354 -0
  145. package/src/components/ui/query-bar.tsx +22 -13
  146. package/src/components/ui/ratio-bar.tsx +24 -1
  147. package/src/components/ui/select-button.tsx +2 -1
  148. package/src/components/ui/shortcut-hint.tsx +6 -3
  149. package/src/components/ui/table-layout.ts +81 -0
  150. package/src/components/ui/tabs.tsx +45 -6
  151. package/src/components/use-pane-notice-footer.tsx +12 -4
  152. package/src/core/app-service-ports.ts +1 -1
  153. package/src/data/plugin-state-store.ts +44 -8
  154. package/src/docs/snapshot.json +53 -32
  155. package/src/i18n/es.ts +28 -6
  156. package/src/i18n/ja.ts +28 -5
  157. package/src/i18n/ko.ts +28 -5
  158. package/src/i18n/zh-cn.ts +28 -5
  159. package/src/i18n/zh-tw.ts +28 -5
  160. package/src/layout/pane-manager/gridlock-inference.ts +2 -1
  161. package/src/layout/pane-manager/gridlock.ts +47 -2
  162. package/src/layout-marketplace/api.ts +1 -0
  163. package/src/layout-marketplace/gallery.tsx +4 -3
  164. package/src/layout-marketplace/linked.ts +6 -4
  165. package/src/layout-marketplace/model.ts +3 -2
  166. package/src/market-data/fund-facts.ts +7 -1
  167. package/src/market-data/futures-contract.ts +77 -31
  168. package/src/market-data/fx-closes.ts +5 -2
  169. package/src/market-data/hooks.tsx +23 -0
  170. package/src/market-data/market/change-basis.ts +92 -14
  171. package/src/market-data/market/format.ts +81 -13
  172. package/src/market-data/market/futures-week.ts +3 -1
  173. package/src/market-data/market/globex-day.ts +73 -0
  174. package/src/market-data/market/index-level.ts +10 -1
  175. package/src/market-data/quotes/intraday-bar.ts +1 -1
  176. package/src/market-data/quotes/session-split.ts +28 -0
  177. package/src/plugins/builtin/account-management/pane.tsx +1 -1
  178. package/src/plugins/builtin/analytics/account-returns.ts +1 -1
  179. package/src/plugins/builtin/analytics/index.tsx +10 -3
  180. package/src/plugins/builtin/analytics/pane-model.ts +1 -1
  181. package/src/plugins/builtin/analytics/risk-client.ts +4 -1
  182. package/src/plugins/builtin/analytics/risk-episodes.ts +422 -0
  183. package/src/plugins/builtin/analytics/risk-fx.ts +1 -1
  184. package/src/plugins/builtin/analytics/risk-headless.ts +28 -10
  185. package/src/plugins/builtin/analytics/risk-math.ts +1 -1
  186. package/src/plugins/builtin/analytics/risk-model.ts +115 -26
  187. package/src/plugins/builtin/analytics/risk-pane.tsx +201 -23
  188. package/src/plugins/builtin/analytics/sharpe-cadence.ts +1 -1
  189. package/src/plugins/builtin/backtest/format.ts +14 -0
  190. package/src/plugins/builtin/backtest/pane.tsx +3 -3
  191. package/src/plugins/builtin/backtest/report.ts +5 -3
  192. package/src/plugins/builtin/broker-manager/add-request.ts +10 -1
  193. package/src/plugins/builtin/broker-trading/pane.tsx +20 -2
  194. package/src/plugins/builtin/buildout/company/flow.tsx +5 -5
  195. package/src/plugins/builtin/buildout/company/model.ts +14 -2
  196. package/src/plugins/builtin/catalysts/detail.tsx +2 -2
  197. package/src/plugins/builtin/catalysts/model.ts +7 -2
  198. package/src/plugins/builtin/catalysts/pane.tsx +2 -2
  199. package/src/plugins/builtin/chart-composer/headless.ts +57 -17
  200. package/src/plugins/builtin/chart-composer/session-range.ts +82 -3
  201. package/src/plugins/builtin/chat/message/pane-chip.tsx +36 -208
  202. package/src/plugins/builtin/cloud/askg/answer-follow-ups.tsx +61 -0
  203. package/src/plugins/builtin/cloud/askg/answer-sources.tsx +102 -0
  204. package/src/plugins/builtin/cloud/askg/controller.ts +7 -1
  205. package/src/plugins/builtin/cloud/askg/host.ts +57 -0
  206. package/src/plugins/builtin/cloud/askg/model.ts +45 -5
  207. package/src/plugins/builtin/cloud/askg/pane.tsx +304 -25
  208. package/src/plugins/builtin/cloud/askg/protocol.ts +26 -1
  209. package/src/plugins/builtin/cloud/askg/sources.ts +466 -0
  210. package/src/plugins/builtin/cloud/one-tap/controller.ts +309 -0
  211. package/src/plugins/builtin/cloud/one-tap/google-identity.ts +142 -0
  212. package/src/plugins/builtin/cloud/one-tap/one-tap-prompt.tsx +101 -0
  213. package/src/plugins/builtin/cloud/plugin.tsx +7 -1
  214. package/src/plugins/builtin/company-kpis/client.ts +4 -3
  215. package/src/plugins/builtin/company-kpis/model.ts +34 -3
  216. package/src/plugins/builtin/correlation/compute.ts +8 -2
  217. package/src/plugins/builtin/correlation/headless.ts +10 -9
  218. package/src/plugins/builtin/correlation/history.ts +30 -0
  219. package/src/plugins/builtin/correlation/index.tsx +39 -167
  220. package/src/plugins/builtin/correlation/matrix/grid.tsx +285 -0
  221. package/src/plugins/builtin/correlation/matrix/model.ts +10 -10
  222. package/src/plugins/builtin/correlation/relationship/model.ts +3 -6
  223. package/src/plugins/builtin/correlation/relationship/pane.tsx +7 -9
  224. package/src/plugins/builtin/correlation/relationship/view-model.ts +14 -5
  225. package/src/plugins/builtin/cot/client.ts +8 -3
  226. package/src/plugins/builtin/cot/headless.ts +65 -12
  227. package/src/plugins/builtin/cot/pane.tsx +11 -5
  228. package/src/plugins/builtin/crypto-board/client.ts +6 -1
  229. package/src/plugins/builtin/crypto-board/defi-view.tsx +12 -1
  230. package/src/plugins/builtin/crypto-board/defi.ts +44 -7
  231. package/src/plugins/builtin/crypto-board/headless.ts +83 -12
  232. package/src/plugins/builtin/crypto-board/model.ts +30 -6
  233. package/src/plugins/builtin/crypto-board/pane.tsx +13 -2
  234. package/src/plugins/builtin/earnings/client.ts +40 -6
  235. package/src/plugins/builtin/earnings/fiscal-quarter.ts +54 -0
  236. package/src/plugins/builtin/earnings/headless.ts +47 -11
  237. package/src/plugins/builtin/earnings/history-model.ts +136 -24
  238. package/src/plugins/builtin/earnings/history-table.ts +42 -10
  239. package/src/plugins/builtin/earnings/history.tsx +23 -8
  240. package/src/plugins/builtin/earnings-ripple/client.ts +5 -2
  241. package/src/plugins/builtin/earnings-ripple/headless.ts +8 -3
  242. package/src/plugins/builtin/earnings-ripple/model.ts +21 -0
  243. package/src/plugins/builtin/earnings-ripple/pane.tsx +2 -3
  244. package/src/plugins/builtin/econ/index.tsx +5 -4
  245. package/src/plugins/builtin/econ-statistics/stats.ts +13 -5
  246. package/src/plugins/builtin/equity-screener/headless.ts +2 -1
  247. package/src/plugins/builtin/filing-events/feed.ts +56 -18
  248. package/src/plugins/builtin/filing-events/pane.tsx +8 -2
  249. package/src/plugins/builtin/futures/index.tsx +32 -10
  250. package/src/plugins/builtin/futures/model.ts +93 -6
  251. package/src/plugins/builtin/futures/returns.ts +29 -7
  252. package/src/plugins/builtin/futures/table.tsx +59 -17
  253. package/src/plugins/builtin/futures/use-front-returns.ts +32 -6
  254. package/src/plugins/builtin/futures-curve/client.ts +12 -2
  255. package/src/plugins/builtin/futures-curve/headless.ts +58 -17
  256. package/src/plugins/builtin/futures-curve/model.ts +111 -15
  257. package/src/plugins/builtin/futures-curve/pane.tsx +11 -6
  258. package/src/plugins/builtin/fx-matrix/amount.ts +132 -0
  259. package/src/plugins/builtin/fx-matrix/headless.ts +53 -13
  260. package/src/plugins/builtin/fx-matrix/index.tsx +205 -42
  261. package/src/plugins/builtin/fx-matrix/pairs.ts +10 -8
  262. package/src/plugins/builtin/fx-matrix/settings.ts +22 -1
  263. package/src/plugins/builtin/help/index.tsx +68 -61
  264. package/src/plugins/builtin/holders/format.ts +7 -2
  265. package/src/plugins/builtin/holders/pane.tsx +11 -3
  266. package/src/plugins/builtin/holders/report-header.ts +5 -4
  267. package/src/plugins/builtin/holders/report-rows.ts +4 -1
  268. package/src/plugins/builtin/holders/treemap.tsx +5 -3
  269. package/src/plugins/builtin/insider/signals-model.ts +4 -5
  270. package/src/plugins/builtin/ipo-calendar/headless.ts +18 -7
  271. package/src/plugins/builtin/ipo-calendar/listing-ipo.ts +3 -1
  272. package/src/plugins/builtin/ipo-calendar/model.ts +28 -8
  273. package/src/plugins/builtin/ipo-calendar/pane.tsx +2 -1
  274. package/src/plugins/builtin/kelly-sizer/headless.ts +4 -0
  275. package/src/plugins/builtin/perps/headless.ts +81 -19
  276. package/src/plugins/builtin/perps/index.tsx +3 -1
  277. package/src/plugins/builtin/perps/model.ts +1 -1
  278. package/src/plugins/builtin/perps/pane.tsx +2 -0
  279. package/src/plugins/builtin/portfolio-list/cell-version.ts +1 -0
  280. package/src/plugins/builtin/portfolio-list/cli/bulk-symbols.ts +20 -1
  281. package/src/plugins/builtin/portfolio-list/cli/import-positions.ts +260 -0
  282. package/src/plugins/builtin/portfolio-list/cli/period-report.ts +154 -0
  283. package/src/plugins/builtin/portfolio-list/cli/portfolio-command.ts +64 -22
  284. package/src/plugins/builtin/portfolio-list/cli/render.ts +18 -7
  285. package/src/plugins/builtin/portfolio-list/cli/watchlist-command.ts +5 -3
  286. package/src/plugins/builtin/portfolio-list/grid.tsx +56 -12
  287. package/src/plugins/builtin/portfolio-list/headless.ts +128 -0
  288. package/src/plugins/builtin/portfolio-list/pane/index.tsx +42 -4
  289. package/src/plugins/builtin/portfolio-list/pane/period-pnl.ts +124 -0
  290. package/src/plugins/builtin/portfolio-list/period-pnl.ts +179 -0
  291. package/src/plugins/builtin/portfolio-list/positions-import/dialog.tsx +445 -0
  292. package/src/plugins/builtin/portfolio-list/positions-import/index.tsx +255 -0
  293. package/src/plugins/builtin/portfolio-list/positions-import/lookup.ts +78 -0
  294. package/src/plugins/builtin/portfolio-list/positions-import/read-file.ts +32 -0
  295. package/src/plugins/builtin/portfolio-list/quick-add/index.tsx +186 -50
  296. package/src/plugins/builtin/portfolio-list/quick-add/resolution.ts +118 -4
  297. package/src/plugins/builtin/portfolio-list/settings.ts +25 -0
  298. package/src/plugins/builtin/portfolio-list/summary/index.tsx +16 -1
  299. package/src/plugins/builtin/portfolio-list/summary/totals.ts +7 -5
  300. package/src/plugins/builtin/portfolio-list/table.tsx +105 -6
  301. package/src/plugins/builtin/power/headless.ts +47 -9
  302. package/src/plugins/builtin/research/relative-valuation-model.ts +8 -3
  303. package/src/plugins/builtin/research-search/article.ts +12 -2
  304. package/src/plugins/builtin/research-search/data.ts +5 -2
  305. package/src/plugins/builtin/research-search/document-view.tsx +1 -1
  306. package/src/plugins/builtin/research-search/model.ts +47 -3
  307. package/src/plugins/builtin/research-search/pane.tsx +3 -2
  308. package/src/plugins/builtin/reverse-dcf/model.ts +7 -4
  309. package/src/plugins/builtin/risk-factors/headless.ts +3 -2
  310. package/src/plugins/builtin/risk-factors/index.tsx +2 -28
  311. package/src/plugins/builtin/risk-factors/lock-note.ts +58 -0
  312. package/src/plugins/builtin/risk-factors/pane.tsx +14 -5
  313. package/src/plugins/builtin/scanner/flow-model.ts +17 -13
  314. package/src/plugins/builtin/scanner/flow-pane.tsx +8 -9
  315. package/src/plugins/builtin/scanner/flow-session.ts +2 -9
  316. package/src/plugins/builtin/scanner/hilo-model.ts +4 -3
  317. package/src/plugins/builtin/sec/filing-display.tsx +0 -5
  318. package/src/plugins/builtin/sec/forms.ts +19 -0
  319. package/src/plugins/builtin/sec/fund-facts.ts +45 -11
  320. package/src/plugins/builtin/sec/headless.ts +37 -12
  321. package/src/plugins/builtin/sec/index.tsx +37 -8
  322. package/src/plugins/builtin/shared/earnings-calendar.ts +6 -3
  323. package/src/plugins/builtin/shared/earnings-report.ts +1 -1
  324. package/src/plugins/builtin/shared/fx-rate-freshness.ts +0 -35
  325. package/src/plugins/builtin/shared/pro-lock-note.ts +5 -1
  326. package/src/plugins/builtin/shared/use-quote-board.ts +42 -27
  327. package/src/plugins/builtin/supply-chain/graph-model.ts +7 -1
  328. package/src/plugins/builtin/supply-chain/headless.ts +20 -10
  329. package/src/plugins/builtin/supply-chain/model.ts +117 -20
  330. package/src/plugins/builtin/supply-chain/pane.tsx +22 -15
  331. package/src/plugins/builtin/supply-chain/row-evidence.tsx +1 -1
  332. package/src/plugins/builtin/ticker-detail/data-panes/returns-chart-model.ts +69 -0
  333. package/src/plugins/builtin/ticker-detail/data-panes/returns-chart.tsx +118 -0
  334. package/src/plugins/builtin/ticker-detail/data-panes/returns-model.ts +1 -1
  335. package/src/plugins/builtin/ticker-detail/data-panes/returns-pane.tsx +103 -40
  336. package/src/plugins/builtin/ticker-detail/headless-schema.ts +10 -1
  337. package/src/plugins/builtin/ticker-detail/headless.ts +8 -1
  338. package/src/plugins/builtin/ticker-detail/overview/components.tsx +2 -1
  339. package/src/plugins/builtin/ticker-detail/overview/model.ts +18 -8
  340. package/src/plugins/builtin/ticker-detail/overview-tab.tsx +11 -8
  341. package/src/plugins/builtin/ticker-detail/pane.tsx +95 -20
  342. package/src/plugins/builtin/ticker-detail/research-groups.ts +89 -0
  343. package/src/plugins/builtin/ticker-detail/settings.ts +4 -3
  344. package/src/plugins/builtin/time-sales/headless.ts +23 -7
  345. package/src/plugins/builtin/time-sales/index.tsx +2 -2
  346. package/src/plugins/builtin/volatility/charts.tsx +2 -2
  347. package/src/plugins/extracted-plugins.ts +49 -24
  348. package/src/plugins/host-resolver.ts +3 -2
  349. package/src/plugins/installer.ts +220 -31
  350. package/src/plugins/running-installs.ts +34 -0
  351. package/src/plugins/seed-progress.ts +72 -0
  352. package/src/portfolio/column-values.ts +42 -8
  353. package/src/portfolio/futures-positions.ts +10 -2
  354. package/src/portfolio/mutations.ts +4 -3
  355. package/src/portfolio/period-pnl.ts +119 -0
  356. package/src/portfolio/positions-import/describe.ts +89 -0
  357. package/src/portfolio/positions-import/parse.ts +682 -0
  358. package/src/portfolio/positions-import/plan.ts +295 -0
  359. package/src/{plugins/builtin/analytics/metrics.ts → portfolio/return-metrics.ts} +24 -11
  360. package/src/public/__snapshots__/public-api.test.ts.snap +1 -0
  361. package/src/react/jsx-dev-fallback.ts +62 -0
  362. package/src/renderers/browser/cloud-transport.ts +1 -1
  363. package/src/renderers/browser/config-host.ts +3 -1
  364. package/src/renderers/browser/deeplink-bridge.ts +8 -1
  365. package/src/renderers/browser/http-proxy-transport.ts +9 -2
  366. package/src/renderers/browser/main.tsx +2 -1
  367. package/src/renderers/browser/research-entry.ts +12 -0
  368. package/src/renderers/cloudflare/http-proxy.ts +8 -2
  369. package/src/renderers/cloudflare/proxy-session.ts +1 -0
  370. package/src/renderers/cloudflare/worker.ts +12 -3
  371. package/src/renderers/dom/desktop/audio-player.tsx +2 -2
  372. package/src/renderers/dom/desktop/controls.tsx +1 -1
  373. package/src/renderers/dom/desktop/dialog-actions.tsx +10 -24
  374. package/src/renderers/dom/desktop/icons.tsx +4 -2
  375. package/src/renderers/dom/desktop/query-bar.tsx +23 -19
  376. package/src/renderers/dom/dom-host-providers.tsx +7 -2
  377. package/src/renderers/dom/host/box.tsx +2 -2
  378. package/src/renderers/dom/host/input.tsx +13 -0
  379. package/src/renderers/dom/key-event.ts +1 -0
  380. package/src/renderers/dom/styles.css +3 -0
  381. package/src/renderers/electrobun/bun/context-menu/click.ts +1 -0
  382. package/src/renderers/electrobun/bun/desktop/backend.ts +15 -0
  383. package/src/renderers/electrobun/bun/desktop/capability-bridge.ts +5 -4
  384. package/src/renderers/electrobun/bun/desktop/host-requests.ts +19 -11
  385. package/src/renderers/electrobun/bun/desktop/http-fetch.ts +1 -0
  386. package/src/renderers/electrobun/bun/desktop/http-stream.ts +1 -1
  387. package/src/renderers/electrobun/bun/desktop/initialization.ts +27 -15
  388. package/src/renderers/electrobun/bun/desktop/install-records.ts +4 -1
  389. package/src/renderers/electrobun/bun/desktop/installer-folder.ts +5 -2
  390. package/src/renderers/electrobun/bun/desktop/macos-objc.ts +3 -1
  391. package/src/renderers/electrobun/bun/desktop/screen-setup-file.ts +9 -4
  392. package/src/renderers/electrobun/bun/desktop/update.ts +27 -13
  393. package/src/renderers/electrobun/bun/desktop/windows-script.ts +6 -2
  394. package/src/renderers/electrobun/bun/index.ts +5 -0
  395. package/src/renderers/electrobun/bun/window/attention.ts +1 -0
  396. package/src/renderers/electrobun/bun/window/boot-frame.ts +1 -0
  397. package/src/renderers/electrobun/bun/window/context-menu-thread.ts +84 -0
  398. package/src/renderers/electrobun/bun/window/create.ts +1 -0
  399. package/src/renderers/electrobun/bun/window/electrobun-window-host.ts +13 -8
  400. package/src/renderers/electrobun/bun/window/native-call-thread.ts +224 -0
  401. package/src/renderers/electrobun/bun/window/native-min-size.ts +1 -1
  402. package/src/renderers/electrobun/bun/window/native-timing.ts +10 -0
  403. package/src/renderers/electrobun/bun/window/remembered-frame.ts +1 -0
  404. package/src/renderers/electrobun/bun/window/script-for-webview.ts +15 -0
  405. package/src/renderers/electrobun/bun/window/webview-script-thread.ts +82 -0
  406. package/src/renderers/electrobun/bun/window/windows-native.ts +3 -1
  407. package/src/renderers/electrobun/bun/window/windows-quit.ts +3 -1
  408. package/src/renderers/electrobun/shared/protocol.ts +13 -2
  409. package/src/renderers/electrobun/view/app-badge-host.ts +2 -1
  410. package/src/renderers/electrobun/view/backend-rpc.ts +7 -0
  411. package/src/renderers/electrobun/view/capability-subscription.ts +2 -1
  412. package/src/renderers/electrobun/view/cli-pane-shot-entry.tsx +7 -10
  413. package/src/renderers/electrobun/view/cli-pane-shot-frame.tsx +1 -1
  414. package/src/renderers/electrobun/view/cli-pane-shot-mutations.ts +36 -0
  415. package/src/renderers/electrobun/view/http-fetch.ts +2 -1
  416. package/src/renderers/electrobun/view/main.tsx +13 -7
  417. package/src/renderers/electrobun/view/remote/capability-invoker.ts +6 -3
  418. package/src/renderers/electrobun/view/remote/persistence.ts +63 -27
  419. package/src/renderers/electrobun/view/rpc-timeout.ts +1 -0
  420. package/src/renderers/electrobun/view/ui-host.tsx +3 -2
  421. package/src/renderers/electrobun/view/window-fullscreen.ts +3 -1
  422. package/src/renderers/opentui/browser-open.ts +2 -1
  423. package/src/renderers/opentui/dialog-host.tsx +1 -1
  424. package/src/renderers/opentui/interaction-performance.ts +3 -1
  425. package/src/renderers/opentui/start.tsx +5 -1
  426. package/src/renderers/opentui/terminal-media.ts +11 -6
  427. package/src/renderers/opentui/ui-host.tsx +5 -8
  428. package/src/shares/open.ts +22 -1
  429. package/src/shares/pane.ts +2 -1
  430. package/src/sources/gloomberb-cloud/normalizers.ts +3 -0
  431. package/src/sync/analytics-payload.ts +194 -0
  432. package/src/sync/baseline.ts +19 -9
  433. package/src/sync/broker-identity.ts +171 -0
  434. package/src/sync/broker-instances.ts +137 -0
  435. package/src/sync/collections-contributor.ts +173 -0
  436. package/src/sync/config-contributor.ts +100 -0
  437. package/src/sync/config-merge.ts +229 -0
  438. package/src/sync/controller.ts +139 -28
  439. package/src/sync/core-contributors.ts +8 -1583
  440. package/src/sync/history-memo.ts +32 -0
  441. package/src/sync/layout-merge.ts +259 -0
  442. package/src/sync/sanitize.ts +114 -0
  443. package/src/sync/ticker-merge.ts +208 -0
  444. package/src/sync/ticker-payload.ts +81 -0
  445. package/src/sync/types.ts +15 -1
  446. package/src/telemetry/attention-setting.ts +1 -1
  447. package/src/telemetry/stall-reports.ts +21 -4
  448. package/src/telemetry/usage-counts.ts +16 -0
  449. package/src/test-support/preload.ts +5 -0
  450. package/src/theme/color-utils.ts +10 -0
  451. package/src/theme/font-scale.ts +34 -3
  452. package/src/theme/series-colors.ts +44 -0
  453. package/src/theme/themes.ts +2 -1
  454. package/src/tickers/batched-lookups.ts +263 -6
  455. package/src/tickers/company-name-listing.ts +44 -2
  456. package/src/tickers/company-name.ts +7 -2
  457. package/src/tickers/search/upsert.ts +16 -1
  458. package/src/time-series/base-series.ts +18 -4
  459. package/src/time-series/studies/indicators.ts +3 -1
  460. package/src/time-series/studies/resolve.ts +1 -1
  461. package/src/time-series/types.ts +6 -0
  462. package/src/types/financials.ts +18 -0
  463. package/src/types/headless.ts +11 -0
  464. package/src/ui/host.tsx +26 -3
  465. package/src/ui/index.tsx +1 -0
  466. package/src/utils/concurrency.ts +6 -0
  467. package/src/utils/currency-pair.ts +56 -4
  468. package/src/utils/datetime-format.ts +11 -0
  469. package/src/utils/decimal-comma.ts +9 -6
  470. package/src/utils/exchanges.ts +32 -0
  471. package/src/utils/fundamentals.ts +41 -0
  472. package/src/utils/main-thread-stall.ts +21 -5
  473. package/src/utils/markdown.ts +4 -2
  474. package/src/utils/pasted-lines.ts +14 -0
  475. package/src/utils/perf-marks.ts +88 -9
  476. package/src/utils/price-window.ts +2 -1
  477. package/src/utils/reported-money.ts +9 -2
  478. package/src/utils/sec-filings.ts +17 -0
  479. package/src/utils/sec.ts +37 -25
  480. package/src/utils/shortcut-labels.ts +6 -30
  481. package/src/plugins/seed-notice.ts +0 -20
@@ -7,6 +7,7 @@ import { logFailure } from "../utils/log-failure";
7
7
  import { futuresBoardContract, futuresContractByCode, type FuturesContract } from "./futures-board";
8
8
  import { formatMarketPrice, formatMarketPriceWithCurrency, quoteFormatOptions, withCurrencyMinorDigits } from "./market/format";
9
9
  import { previousPublishedSession } from "./market/freshness";
10
+ import { globexPrintSession } from "./market/globex-day";
10
11
  import { minorUnitSign } from "../utils/currency-units";
11
12
  import { contractPriceUnit } from "../time-series/price-units";
12
13
  import { deliveryMonthLabel } from "../utils/contract-month";
@@ -255,54 +256,99 @@ function settlementTolerance(tick: number | null | undefined, price: number): nu
255
256
  }
256
257
 
257
258
  /**
258
- * What a futures move is measured from: a session's settlement, the last
259
- * trade of a session that settled elsewhere, or a session's close that the
260
- * settlement in the contract terms cannot confirm either way. `session` is
261
- * the date of that reference.
259
+ * What a futures move is measured from: a session's settlement or close.
260
+ * `session` is the date of that reference. `from` is set when the move is to
261
+ * be measured again from that session's settlement, at that price
262
+ * (futuresQuoteFromSettle): the source measured it from something else.
262
263
  */
263
264
  export interface FuturesChangeBasis {
264
- kind: "settle" | "last trade" | "close";
265
+ kind: "settle" | "close";
265
266
  session: string;
267
+ from?: number;
266
268
  }
267
269
 
270
+ /** "Nov 2026", "Nov 26" or "Futures,Nov-2026"; a hyphen takes only a whole year, since "Futures,Nov-20" is 2026 cut short. */
271
+ export const CONTRACT_MONTH_NAME = /\b(Jan|Feb|Mar|Apr|May|Jun|Jul|Aug|Sep|Oct|Nov|Dec)(?: (\d{4}|\d{2})|-(\d{4}))$/i;
272
+ const MONTH_ABBREVIATIONS = ["jan", "feb", "mar", "apr", "may", "jun", "jul", "aug", "sep", "oct", "nov", "dec"];
273
+ const CONTRACT_SYMBOL = /^[A-Z0-9]+?([FGHJKMNQUVXZ])(\d{2})(?:\.[A-Z]+)?$/i;
274
+ const MONTH_CODES = "FGHJKMNQUVXZ";
275
+
276
+ /**
277
+ * The delivery month a futures quote prices, `YYYY-MM`: from a listed
278
+ * contract's code (ESZ26.CME), else from the month a continuous symbol's name
279
+ * carries ("E-Mini S&P 500 Dec 26"). Null when neither says.
280
+ */
281
+ export function futuresQuoteMonth(quote: Pick<Quote, "symbol" | "name"> | null | undefined): string | null {
282
+ const coded = CONTRACT_SYMBOL.exec(quote?.symbol?.trim() ?? "");
283
+ if (coded) return `20${coded[2]}-${String(MONTH_CODES.indexOf(coded[1]!.toUpperCase()) + 1).padStart(2, "0")}`;
284
+ const named = CONTRACT_MONTH_NAME.exec(quote?.name?.trim() ?? "");
285
+ if (!named) return null;
286
+ const written = named[2] ?? named[3]!;
287
+ const year = written.length === 2 ? 2000 + Number(written) : Number(written);
288
+ return `${year}-${String(MONTH_ABBREVIATIONS.indexOf(named[1]!.toLowerCase()) + 1).padStart(2, "0")}`;
289
+ }
290
+
291
+ /** The terms a futures move is checked against: the settlement, the tick it is rounded to and the contract's month. */
292
+ export type FuturesChangeTerms = Pick<FuturesContractTermsPayload, "settlement"> & {
293
+ spec?: Pick<FuturesContractSpec, "tick"> | null;
294
+ deliveryMonth?: string | null;
295
+ };
296
+
268
297
  /**
269
298
  * What the move a futures quote headlines is measured from, for the words
270
- * after it ("vs Fri 16 Oct settle", quoteChangeBasis). `sessionDate` is the
271
- * session the move belongs to (regularSessionDisplayDate); a Saturday or
272
- * Sunday is Friday's, as no session is dated on one, and a holiday CME Globex
273
- * traded is the next trade date's. The basis is only what the numbers show,
274
- * against the one settlement the contract terms carry: a reference (the price
275
- * less the move) within half a tick of it is that settlement, of whichever
276
- * session it is. A reference that is not the settlement of the session just
277
- * before the move's is that session's last trade. Otherwise, when the terms
278
- * carry no settlement that old or one the reference can be checked against
279
- * (the move's own session has settled, and the one before is not in the
280
- * terms), it is the session before's close, left unnamed. The session before
281
- * is the trade date before the move's on the `exchange`'s published holiday
282
- * calendar (previousPublishedSession), so the Tuesday after Memorial Day
283
- * moves from Friday. On a venue without one, only a matching settlement is
284
- * named, by the date the terms give it. Null without a session date, a move
285
- * or terms, or when nothing but the calendar could date the reference and
286
- * there is none.
299
+ * after it ("vs Fri 16 Oct settle", quoteChangeBasis). The move covers one
300
+ * session, the one before its own, and is labelled by it. Its session is
301
+ * `sessionDate` (regularSessionDisplayDate), a Saturday or Sunday being
302
+ * Friday's, unless the print (`tradedAt`) was made after the CME Globex
303
+ * reopen that opened a later trade date (globexPrintSession), whose move it
304
+ * then is, whatever date the source still gives it. The session before is
305
+ * the trade date before on the `exchange`'s published holiday calendar
306
+ * (previousPublishedSession), so the Tuesday after Memorial Day moves from
307
+ * Friday; a holiday Globex traded is the next trade date's.
308
+ *
309
+ * A reference (the price less the move) within half a tick of the settlement
310
+ * in the terms is that settlement. Any other reference:
311
+ * - with the session before's settlement in the terms, for the contract the
312
+ * quote prices (`month` is the terms' `deliveryMonth`), is measured again
313
+ * from it (`from`); around a roll the terms can name the month before, and
314
+ * the gap between the two would read as the day's move, so for another
315
+ * contract, or one the quote does not name, the source's move stands with
316
+ * no session named (null, "vs prev close");
317
+ * - with an older settlement in the terms, is the session before's close in
318
+ * the overnight hours after the reopen, before that session's settlement
319
+ * is confirmed: Wednesday's 7,720.50 close at 23:18 UTC, "+14 vs Wed 4 Nov
320
+ * close", never +137.75 from Tuesday's settlement, two sessions. At any
321
+ * other time the terms are behind and nothing dates it (null);
322
+ * - without a settlement in the terms, or once the move's own session has
323
+ * settled, is the session before's close, which nothing else checks.
324
+ * On a venue without a calendar only a settlement is named. Null without a
325
+ * session date, a move or terms.
287
326
  */
288
327
  export function futuresChangeBasis(
289
- terms: Pick<FuturesContractTermsPayload, "settlement"> & { spec?: Pick<FuturesContractSpec, "tick"> | null } | null | undefined,
290
- move: { price: number; change?: number | null; sessionDate?: string | null } | null | undefined,
328
+ terms: FuturesChangeTerms | null | undefined,
329
+ move: { price: number; change?: number | null; sessionDate?: string | null; tradedAt?: number | null; month?: string | null } | null | undefined,
291
330
  exchange: string | null | undefined,
292
331
  ): FuturesChangeBasis | null {
293
332
  const dated = move?.sessionDate;
294
333
  if (!terms || !move || !dated || !isoDate.test(dated) || move.change == null) return null;
295
334
  const reference = move.price - move.change;
296
335
  if (!Number.isFinite(reference)) return null;
297
- const session = weekdayOnOrBefore(dated);
298
- const previous = previousPublishedSession(exchange ?? undefined, dated, { closedDayRollsForward: true })?.date ?? null;
336
+ const sessionBefore = (date: string) => previousPublishedSession(exchange ?? undefined, date, { closedDayRollsForward: true })?.date ?? null;
337
+ // A print in the night after the session the source dates the move by opened the next trade date.
338
+ const print = globexPrintSession(exchange, move.tradedAt);
339
+ const reopened = !!print?.overnight && print.tradeDate > dated && (sessionBefore(print.tradeDate) ?? "") >= weekdayOnOrBefore(dated);
340
+ const moveDate = reopened ? print!.tradeDate : dated;
341
+ const session = weekdayOnOrBefore(moveDate);
342
+ const previous = sessionBefore(moveDate);
299
343
  const settled = terms.settlement;
300
- if (settled && settled.date <= session) {
301
- if (Math.abs(reference - settled.price) <= settlementTolerance(terms.spec?.tick, settled.price)) {
302
- return { kind: "settle", session: settled.date };
303
- }
304
- if (settled.date === previous) return { kind: "last trade", session: settled.date };
344
+ if (settled && settled.date <= session && Math.abs(reference - settled.price) <= settlementTolerance(terms.spec?.tick, settled.price)) {
345
+ return { kind: "settle", session: settled.date };
346
+ }
347
+ if (settled && previous && settled.date === previous) {
348
+ const sameContract = !!move.month && terms.deliveryMonth?.slice(0, 7) === move.month;
349
+ return sameContract && Number.isFinite(move.price) ? { kind: "settle", session: previous, from: settled.price } : null;
305
350
  }
351
+ if (settled && previous && settled.date < previous) return print?.overnight && print.tradeDate === moveDate ? { kind: "close", session: previous } : null;
306
352
  return previous ? { kind: "close", session: previous } : null;
307
353
  }
308
354
 
@@ -1,6 +1,6 @@
1
1
  import type { CloudHistoryParams } from "../api-client/paths";
2
2
  import type { CloudMarketResponse, CloudPricePointPayload } from "../api-client/types";
3
- import { isCurrencyCode } from "../utils/currency-pair";
3
+ import { fxFigureAsSent, isCurrencyCode } from "../utils/currency-pair";
4
4
  import { fxLegForCurrency, type FxLeg } from "./coordinator/fx-legs";
5
5
 
6
6
  /** USD per unit of one currency at each completed daily FX close, by date. */
@@ -82,6 +82,8 @@ export interface FxHistoryClient {
82
82
  export interface FxCloseReading {
83
83
  /** USD per unit. */
84
84
  rate: number;
85
+ /** The pair's close as the service sent it (USD/JPY 157.848 for the yen), the figure `rate` is or is the inverse of. */
86
+ close?: number;
85
87
  /** The UTC day of the close: the day asked for, or the last trading day before it. */
86
88
  date: string;
87
89
  }
@@ -135,7 +137,8 @@ export async function readFxCloseOnDate(
135
137
  if (!Number.isFinite(at) || !Number.isFinite(row.close) || row.close <= 0) continue;
136
138
  const rowDay = isoDay(at);
137
139
  if (rowDay > date || rowDay >= today || Date.parse(`${rowDay}T00:00:00Z`) < day - FX_MAX_AGE_DAYS * DAY_MS) continue;
138
- if (!best || rowDay > best.date) best = { rate: leg.invert ? 1 / row.close : row.close, date: rowDay };
140
+ const close = fxFigureAsSent(row.close);
141
+ if (!best || rowDay > best.date) best = { rate: leg.invert ? 1 / close : close, close, date: rowDay };
139
142
  }
140
143
  return { reading: best, served };
141
144
  }
@@ -330,6 +330,29 @@ export function useTickerFinancialsMap(
330
330
  );
331
331
  }
332
332
 
333
+ /**
334
+ * The rows whose financial snapshot has answered, with figures or without:
335
+ * until it has, a dash in a company column (P/E, market cap) may still fill
336
+ * in, so a list does not yet say no row has one.
337
+ */
338
+ export function useAnsweredSnapshots(
339
+ tickers: TickerRecord[],
340
+ options: TickerInstrumentOptions = {},
341
+ ): ReadonlySet<string> {
342
+ const coordinator = getSharedMarketDataCoordinator();
343
+ const optionsKey = options.portfolioId ?? "";
344
+ const instruments = useMemo(() => tickers.flatMap((ticker) => {
345
+ const instrument = instrumentFromTicker(ticker, ticker.metadata.ticker, options);
346
+ return instrument ? [{ symbol: ticker.metadata.ticker, instrument }] : [];
347
+ }), [optionsKey, tickers]);
348
+ const keys = useMemo(() => instruments.map(({ instrument }) => buildSnapshotKey(instrument)), [instruments]);
349
+ const version = useCoordinatorKeysVersion(keys);
350
+ return useMemo(() => new Set(coordinator ? instruments.flatMap(({ symbol, instrument }) => {
351
+ const phase = coordinator.getSnapshotEntry(instrument).phase;
352
+ return phase === "ready" || phase === "error" || phase === "refreshing" ? [symbol] : [];
353
+ }) : []), [coordinator, instruments, version]);
354
+ }
355
+
333
356
  export function useQuoteEntry(symbol: string | null | undefined, ticker: TickerRecord | null | undefined): QueryEntry<Quote> | null {
334
357
  const instrument = useTickerInstrument(symbol, ticker);
335
358
  const instrumentKey = instrument ? instrumentIdentityKey(instrument) : null;
@@ -6,8 +6,9 @@ import { isFiniteNumber } from "../../utils/guards";
6
6
  import { formatUtcDayTime } from "../../utils/utc-time";
7
7
  import { fxPrintTradingDay } from "../../utils/fx-market-hours";
8
8
  import { zonedDateKey } from "../../utils/zoned-date-time";
9
- import { futuresChangeBasis, futuresSettleText, isFuturesInstrument } from "../futures-contract";
9
+ import { futuresChangeBasis, futuresQuoteMonth, futuresSettleText, isFuturesInstrument } from "../futures-contract";
10
10
  import { quoteTradingDay } from "../quotes/day-range";
11
+ import { splitRatioText } from "../quotes/session-split";
11
12
  import { hasPublishedSessionCalendar, previousPublishedSession } from "./freshness";
12
13
  import { getActiveQuoteDisplay, getRegularSessionDisplay, regularSessionDisplayDate } from "./status";
13
14
 
@@ -26,15 +27,20 @@ export type QuoteChangeBasis =
26
27
  | { kind: "utc day" }
27
28
  | { kind: "24h" };
28
29
 
29
- /** A move from a dated session's close, settlement or last trade. */
30
+ /** A move from a dated session's close or settlement. */
30
31
  interface DatedChangeBasis {
31
- kind: "close" | "settle" | "last trade";
32
+ kind: "close" | "settle";
32
33
  /** The exchange-local date of the session the move is measured from. */
33
34
  date: string;
34
35
  /** The venue, when its calendar dated the close. */
35
36
  venue?: string;
36
37
  /** Days of the venue's trading week it was closed between that session and the move's (holidays). */
37
38
  closed?: readonly string[];
39
+ /**
40
+ * A split took effect in the move's session (Quote.sessionSplit): the close
41
+ * it is measured from is on the new share basis.
42
+ */
43
+ split?: { exDate: string; priceFactor: number };
38
44
  }
39
45
 
40
46
  export interface QuoteChangeBasisOptions {
@@ -194,11 +200,54 @@ export function quoteChangeBasis(
194
200
  if (isSpotCoin(quote)) return { kind: "utc day" };
195
201
  const sessionDate = (session === "active" ? quote.changeSessionDate : regularSessionDisplayDate(quote)) ?? tradingDayOf(quote);
196
202
  if (isFuturesInstrument(quote.symbol, quote.instrumentType)) {
197
- const basis = futuresChangeBasis(terms ?? { settlement: null }, { ...display, sessionDate }, quoteVenue(quote));
198
- return basis ? { kind: basis.kind, date: basis.session } : { kind: "previous close" };
203
+ const basis = futuresChangeBasis(terms ?? { settlement: null }, futuresMove(quote, display, sessionDate), quoteVenue(quote));
204
+ // A move to measure again (futuresQuoteFromSettle does), or one nothing dates, names no session.
205
+ return basis && basis.from == null ? { kind: basis.kind, date: basis.session } : { kind: "previous close" };
199
206
  }
200
207
  if (!sessionDate || !ISO_DATE.test(sessionDate)) return { kind: "previous close" };
201
- return previousSession(quote, sessionDate) ?? { kind: "previous close" };
208
+ const previous = previousSession(quote, sessionDate);
209
+ if (!previous) return { kind: "previous close" };
210
+ // The split of the move's own session is said beside it, on every surface.
211
+ const split = quote.sessionSplit;
212
+ return split?.exDate === sessionDate ? { ...previous, split: { exDate: split.exDate, priceFactor: split.priceFactor } } : previous;
213
+ }
214
+
215
+ /**
216
+ * A futures move as futuresChangeBasis reads it: the print's own time when
217
+ * the move shown is the latest print's (not a completed session's close), so
218
+ * a print after the Globex reopen dates it, and the month the quote prices.
219
+ */
220
+ function futuresMove(quote: Quote, display: { price: number; change?: number | null }, sessionDate: string | null) {
221
+ const live = display.price === quote.price && Number.isFinite(quote.lastUpdated) && quote.lastUpdated > 0;
222
+ return { ...display, sessionDate, tradedAt: live ? quote.lastUpdated : null, month: futuresQuoteMonth(quote) };
223
+ }
224
+
225
+ const roundMove = (value: number) => Math.round(value * 1e10) / 1e10;
226
+
227
+ /**
228
+ * A futures quote whose move is measured again from the settlement of the
229
+ * session before when the source measured it from something else, for the
230
+ * same contract (futuresChangeBasis): that settlement becomes its previous
231
+ * close, its session the date. Every surface that shows a futures move with
232
+ * its terms (quote, ticker, the Overview, FUT and the portfolio) reads it
233
+ * through this, so they never disagree. The move still covers one session;
234
+ * a reference the terms cannot pair with that session's settlement, around a
235
+ * roll or while they lag, is left as the source measured it. Any other quote
236
+ * is returned as it is, as is one whose headline is a completed session's
237
+ * close rather than its price.
238
+ */
239
+ export function futuresQuoteFromSettle<Q extends Quote | null | undefined>(
240
+ quote: Q,
241
+ terms: QuoteChangeBasisOptions["terms"],
242
+ ): Q {
243
+ if (!quote || !terms || quote.delisting || quote.changeBasis === "none" || !isFuturesInstrument(quote.symbol, quote.instrumentType)) return quote;
244
+ const display = getRegularSessionDisplay(quote);
245
+ if (!display || display.price !== quote.price || display.change !== quote.change) return quote;
246
+ const sessionDate = regularSessionDisplayDate(quote) ?? tradingDayOf(quote);
247
+ const basis = futuresChangeBasis(terms, futuresMove(quote, display, sessionDate), quoteVenue(quote));
248
+ if (basis?.from == null || !(basis.from > 0)) return quote;
249
+ const change = roundMove(quote.price - basis.from);
250
+ return { ...quote, change, changePercent: (change / basis.from) * 100, previousClose: basis.from, previousCloseDate: basis.session };
202
251
  }
203
252
 
204
253
  /**
@@ -228,11 +277,31 @@ export function quotePreviousCloseDate(quote: Quote | null | undefined): string
228
277
  if (!sessionDate || !ISO_DATE.test(sessionDate)) return null;
229
278
  if (isSpotCoin(quote)) return dayBefore(sessionDate);
230
279
  if (isFuturesInstrument(quote.symbol, quote.instrumentType)) {
231
- return futuresChangeBasis({ settlement: null }, { price: quote.price, change: 0, sessionDate }, quoteVenue(quote))?.session ?? null;
280
+ return futuresChangeBasis({ settlement: null }, futuresMove(quote, { price: quote.price, change: 0 }, sessionDate), quoteVenue(quote))?.session ?? null;
232
281
  }
233
282
  return previousSession(quote, sessionDate)?.date ?? null;
234
283
  }
235
284
 
285
+ /**
286
+ * Whether the quote's print is older than what its move is measured from, so
287
+ * the move, labelled as of now, is not one: a coin whose last print is
288
+ * before today's 00:00 UTC (TUSD-USD's 29 Oct print read on 3 Nov, "0.00%
289
+ * since 00:00 UTC"), or a move over 24 hours whose print is older than that.
290
+ * A move from a dated close is measured from the print's own session, so it
291
+ * never is.
292
+ */
293
+ export function printPredatesChangeBasis(
294
+ quote: Pick<Quote, "lastUpdated"> | null | undefined,
295
+ basis: QuoteChangeBasis | null | undefined,
296
+ now = Date.now(),
297
+ ): boolean {
298
+ const printed = quote?.lastUpdated;
299
+ if (!basis || !isFiniteNumber(printed) || printed <= 0 || printed > now) return false;
300
+ if (basis.kind === "utc day") return printed < Math.floor(now / DAY_MS) * DAY_MS;
301
+ if (basis.kind === "24h") return printed < now - DAY_MS;
302
+ return false;
303
+ }
304
+
236
305
  /** `Fri 16 Oct`, with the year when it is not `now`'s. */
237
306
  function sessionDay(date: string, now: number): string {
238
307
  return formatUtcDayTime({ time: Date.parse(`${date}T00:00:00Z`), dateOnly: true }, now);
@@ -257,15 +326,23 @@ export function changeBasisLabel(basis: QuoteChangeBasis, now = Date.now()): str
257
326
  }
258
327
 
259
328
  /**
260
- * The days a venue was closed since the close a move is measured from, when
261
- * there were any: "HKEX closed Mon 19 Oct, holiday"; three or more read as a
262
- * span, "TWSE closed Thu 12 Feb to Fri 20 Feb, holidays". Null otherwise.
329
+ * What a reader needs beside the close a move is measured from: a split in
330
+ * the move's session, "3-for-1 split Thu 5 Nov, close adjusted" (the close is
331
+ * on the new share basis), and the days a venue was closed since that close,
332
+ * "HKEX closed Mon 19 Oct, holiday"; three or more read as a span, "TWSE
333
+ * closed Thu 12 Feb to Fri 20 Feb, holidays". Null when there is neither.
263
334
  */
264
335
  export function changeBasisNote(basis: QuoteChangeBasis | null | undefined, now = Date.now()): string | null {
265
- if (!basis || basis.kind !== "close" || !basis.venue || !basis.closed?.length) return null;
266
- const days = basis.closed.map((date) => sessionDay(date, now));
267
- const span = days.length === 1 ? days[0] : days.length === 2 ? `${days[0]} and ${days[1]}` : `${days[0]} to ${days.at(-1)}`;
268
- return `${basis.venue} closed ${span}, ${days.length === 1 ? "holiday" : "holidays"}`;
336
+ if (!basis || basis.kind !== "close") return null;
337
+ const notes: string[] = [];
338
+ const ratio = basis.split ? splitRatioText(basis.split.priceFactor) : null;
339
+ if (basis.split && ratio) notes.push(`${ratio} split ${sessionDay(basis.split.exDate, now)}, close adjusted`);
340
+ if (basis.venue && basis.closed?.length) {
341
+ const days = basis.closed.map((date) => sessionDay(date, now));
342
+ const span = days.length === 1 ? days[0] : days.length === 2 ? `${days[0]} and ${days[1]}` : `${days[0]} to ${days.at(-1)}`;
343
+ notes.push(`${basis.venue} closed ${span}, ${days.length === 1 ? "holiday" : "holidays"}`);
344
+ }
345
+ return notes.length ? notes.join("; ") : null;
269
346
  }
270
347
 
271
348
  /** What several moves summed into one (a portfolio's day) are measured from, when they say. */
@@ -296,6 +373,7 @@ export function changeBasisJson(basis: QuoteChangeBasis | null, now = Date.now()
296
373
  kind: basis.kind,
297
374
  date: "date" in basis ? basis.date : null,
298
375
  ...("closed" in basis && basis.closed?.length ? { closed: [...basis.closed] } : {}),
376
+ ...("split" in basis && basis.split ? { split: { ...basis.split } } : {}),
299
377
  label: changeBasisLabel(basis, now),
300
378
  ...(note ? { note } : {}),
301
379
  };
@@ -4,6 +4,7 @@ import { resolvePriceBasis } from "./price-basis";
4
4
  import { isIndexLevel } from "./index-level";
5
5
  import { currencyPriceDigits, formatCompact, formatCurrency, formatCurrencyCode } from "../../utils/format";
6
6
  import { minorUnitSign } from "../../utils/currency-units";
7
+ import { fxRateDigits } from "../../utils/currency-pair";
7
8
 
8
9
  export type AssetDisplayKind = "cash" | "crypto" | "equity" | "contract" | "other";
9
10
 
@@ -16,6 +17,13 @@ export interface AssetDisplayContext {
16
17
  multiplier?: number;
17
18
  priceBasis?: PriceBasis | null;
18
19
  quantityCurrency?: string;
20
+ /**
21
+ * The tick table the listing trades on, when its tick is finer than its
22
+ * currency's minor unit: `hkex-reduced`, the spread table Hong Kong's
23
+ * exchange traded products trade on (0.002 from 1 to 5, 0.005 from 5 to 10),
24
+ * whose prices under 10 print to three decimals (5.325, not 5.33).
25
+ */
26
+ listingTickTable?: "hkex-reduced";
19
27
  }
20
28
 
21
29
  export interface MarketFormatOptions extends AssetDisplayContext {
@@ -34,10 +42,28 @@ export interface MarketFormatOptions extends AssetDisplayContext {
34
42
  referencePrice?: number;
35
43
  }
36
44
 
45
+ /** Hong Kong's exchange traded products (ETFs, leveraged and inverse products) trade on its reduced spread table. */
46
+ const HKEX_REDUCED_SPREAD_TYPES = new Set(["ETF", "ETN", "ETP", "FUND"]);
47
+ const HKEX_VENUES = new Set(["HKEX", "HKG", "HKSE", "SEHK"]);
48
+
49
+ /** The tick table a quote's listing trades on, when its tick is finer than its currency's minor unit (see `listingTickTable`). */
50
+ function quoteListingTickTable(
51
+ quote: Partial<Pick<Quote, "instrumentType" | "exchangeName" | "listingExchangeName">> | null | undefined,
52
+ ): AssetDisplayContext["listingTickTable"] {
53
+ const venue = (quote?.listingExchangeName || quote?.exchangeName || "").trim().toUpperCase();
54
+ return HKEX_VENUES.has(venue) && HKEX_REDUCED_SPREAD_TYPES.has(normalizeType(quote?.instrumentType)) ? "hkex-reduced" : undefined;
55
+ }
56
+
57
+ /** The decimals a listing's tick asks for at a price, beyond its currency's; undefined when the currency's are enough. */
58
+ function listingTickDigits(table: AssetDisplayContext["listingTickTable"], price: number | undefined): number | undefined {
59
+ if (table !== "hkex-reduced" || price === undefined || !Number.isFinite(price)) return undefined;
60
+ return Math.abs(price) < 10 ? 3 : undefined;
61
+ }
62
+
37
63
  /** Current price fields use the quote's source metadata; stored cost/mark
38
64
  * conventions and independent history must not supply its missing basis. */
39
65
  export function quoteFormatOptions(
40
- quote: Pick<Quote, "instrumentType" | "priceBasis" | "providerPriceDivisor"> | null | undefined,
66
+ quote: (Pick<Quote, "instrumentType" | "priceBasis" | "providerPriceDivisor"> & Partial<Pick<Quote, "exchangeName" | "listingExchangeName">>) | null | undefined,
41
67
  fallbackAssetCategory?: string,
42
68
  metadataInstrumentType?: string,
43
69
  ): MarketFormatOptions {
@@ -45,13 +71,34 @@ export function quoteFormatOptions(
45
71
  // never turn a saved bond into a monetary quote or supply a par declaration.
46
72
  const fallback = metadataInstrumentType?.trim().toUpperCase() === "BOND" ? "BOND" : fallbackAssetCategory;
47
73
  const divisor = quote?.providerPriceDivisor;
74
+ const tickTable = quoteListingTickTable(quote);
48
75
  return {
49
76
  assetCategory: quote?.instrumentType?.trim() || fallback,
50
77
  priceBasis: quote?.priceBasis,
51
78
  ...(divisor != null && Number.isFinite(divisor) && divisor > 1 ? { quotedUnitDivisor: divisor } : {}),
79
+ ...(tickTable ? { listingTickTable: tickTable } : {}),
52
80
  };
53
81
  }
54
82
 
83
+ /** A hundredth of a cent, one basis point of a dollar peg: the decimals CRYP prints a stablecoin to. */
84
+ const NEAR_PAR_COIN_PRICE_DIGITS = 4;
85
+
86
+ /**
87
+ * The decimals a coin trading near a dollar prints to, a dollar stablecoin's
88
+ * 0.9989 and 1.0003 and a bond token's 0.9762, whatever digits its source sent
89
+ * (0.99886, 0.97619265): four either side of par, as CRYP prints them, so
90
+ * `quote`, `ticker` and `G` read one price. Undefined for any other price,
91
+ * which keeps its kind's own decimals (a sub-cent coin's eight).
92
+ */
93
+ export function nearParCoinPriceDigits(
94
+ quote: Pick<Quote, "instrumentType" | "currency" | "previousClose" | "price"> | null | undefined,
95
+ ): number | undefined {
96
+ if (!quote || resolveAssetDisplayKind({ assetCategory: quote.instrumentType }) !== "crypto") return undefined;
97
+ if ((quote.currency ?? "USD").trim().toUpperCase() !== "USD") return undefined;
98
+ const reference = [quote.previousClose, quote.price].find((value) => typeof value === "number" && Number.isFinite(value) && value > 0);
99
+ return reference != null && reference >= 0.9 && reference < 1.1 ? NEAR_PAR_COIN_PRICE_DIGITS : undefined;
100
+ }
101
+
55
102
  /** Decimals a sub-unit quote adds in the major unit: two for pence shown in pounds. */
56
103
  function quotedUnitFractionDigits(divisor: number | undefined): number {
57
104
  return divisor != null && Number.isFinite(divisor) && divisor > 1 ? Math.min(3, Math.round(Math.log10(divisor))) : 0;
@@ -160,17 +207,12 @@ function getQuantityMaxFractionDigits(kind: AssetDisplayKind, value: number): nu
160
207
  }
161
208
  }
162
209
 
163
- function integerDigits(value: number): number {
164
- const absolute = Math.abs(value);
165
- return absolute >= 1 && Number.isFinite(absolute) ? Math.floor(Math.log10(absolute)) + 1 : 0;
166
- }
167
-
168
210
  function getBasePriceMaxFractionDigits(kind: AssetDisplayKind, value: number, currency?: string): number {
169
211
  switch (kind) {
170
212
  case "cash":
171
- // Six decimals, but no more than seven significant digits: providers send
172
- // float32 rates, so 157.8800048828125 must not print as 157.880005.
173
- return Math.max(2, Math.min(6, 7 - integerDigits(value)));
213
+ // A currency pair's precision (EUR/USD 1.12625, USD/JPY 157.880), which
214
+ // also keeps a provider's float32 tail (157.8800048828125) out.
215
+ return fxRateDigits(currency, value);
174
216
  case "crypto":
175
217
  // Sub-cent coins need eight decimals to stay distinguishable from zero,
176
218
  // but a four-figure coin does not. Scaling the ceiling by magnitude keeps
@@ -368,18 +410,27 @@ export function formatMarketPrice(value: number | undefined, options: MarketForm
368
410
  ? getBasePriceMaxFractionDigits(kind, value, options.currency) + quotedUnitDigits
369
411
  : marketPriceFractionDigitCeiling(reference, options) + quotedUnitDigits;
370
412
  let digits = Math.max(0, Math.min(fixedFractionDigits, maxFractionDigits));
413
+ const tick = kind === "equity" || kind === "other" ? listingTickDigits(options.listingTickTable, reference ?? value) : undefined;
414
+ if (tick !== undefined) digits = Math.max(digits, tick);
371
415
  // A live price keeps its instrument's decimals, but a trade finer than the
372
416
  // session prices showed (a half-yen print after whole-yen closes) is not
373
417
  // rounded to a price that never traded.
374
- if (reference !== undefined) digits = Math.max(digits, writtenFractionDigits(Math.abs(value), maxFractionDigits));
418
+ // A currency pair prints to its precision whatever a print carries (1.1270145 is 1.12701).
419
+ if (reference !== undefined && kind !== "cash") digits = Math.max(digits, writtenFractionDigits(Math.abs(value), maxFractionDigits));
375
420
  const fitted = formatVariableNumber(value, digits, options.maxWidth, digits);
376
421
  return hasNonZeroDigit(fitted) || Number(Math.abs(value).toFixed(digits)) === 0
377
422
  ? fitted
378
423
  : scientificPrice(value, options.maxWidth);
379
424
  }
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;
427
+ const baseFractionDigits = getBasePriceMaxFractionDigits(kind, value, options.currency);
380
428
  const minimumFractionDigits = Math.max(
381
429
  0,
382
- Math.min(options.minimumFractionDigits ?? 0, getBasePriceMaxFractionDigits(kind, value, options.currency)),
430
+ Math.min(options.minimumFractionDigits ?? 0, baseFractionDigits),
431
+ tick ?? 0,
432
+ // A currency pair keeps its precision's trailing zeros (6.66800), except on a chart's axis.
433
+ kind === "cash" && options.priceRange === undefined ? baseFractionDigits : 0,
383
434
  );
384
435
  const maxFractionDigits = Math.max(
385
436
  getPriceMaxFractionDigits(kind, value, options.priceRange, options.precisionOffset ?? 0, quotedUnitDigits, options.currency),
@@ -443,6 +494,20 @@ export function formatMarketChangeWithCurrency(
443
494
  ...options, minimumFractionDigits: Math.max(2, options.minimumFractionDigits ?? 0),
444
495
  })}`;
445
496
  }
497
+ // A currency pair's move is written at the pair's precision (+$0.00345 on EUR/USD 1.12638), never its float tail.
498
+ if (resolveAssetDisplayKind(options) === "cash" && referencePrice != null && Number.isFinite(referencePrice) && referencePrice > 0) {
499
+ const digits = fxRateDigits(currency, referencePrice);
500
+ const rounded = Math.abs(value) < 0.5 * 10 ** -digits;
501
+ const body = formatMarketPriceWithCurrency(rounded ? 0 : Math.abs(value), currency, { ...options, fixedFractionDigits: digits });
502
+ return rounded ? body : `${value > 0 ? "+" : "-"}${body}`;
503
+ }
504
+ // A move on a listing whose tick is finer than cents is written to the tick's decimals (+HK$0.030 on an HKEX ETF).
505
+ const tick = listingTickDigits(options.listingTickTable, referencePrice);
506
+ if (tick !== undefined && resolveAssetDisplayKind(options) !== "crypto") {
507
+ const rounded = Math.abs(value) < 0.5 * 10 ** -tick;
508
+ const body = formatMarketPriceWithCurrency(rounded ? 0 : Math.abs(value), currency, { ...options, minimumFractionDigits: tick });
509
+ return rounded ? body : `${value > 0 ? "+" : "-"}${body}`;
510
+ }
446
511
  // Cents hide the whole move of a sub-cent asset (-$0.00 for a SHIB day change).
447
512
  const unitDigits = currencyPriceDigits(currency);
448
513
  const smallestMove = 0.5 / 10 ** unitDigits;
@@ -551,9 +616,12 @@ export function stablePriceFractionDigits(context: StablePriceContext): number {
551
616
  } else if (kind === "equity" || kind === "other") {
552
617
  // A sub-unit price keeps four decimals of the major unit, pence lines
553
618
  // included; above one unit the currency's minor unit (and pence) apply.
554
- digits = below(1) ? 4 : currencyPriceMinDigits(context.currency) + unitDigits;
619
+ // A listing whose tick is finer than its currency's minor unit prints to the tick (an HKEX ETF's 5.325 and 0.676).
620
+ digits = listingTickDigits(context.listingTickTable, reference)
621
+ ?? (below(1) ? 4 : currencyPriceMinDigits(context.currency) + unitDigits);
555
622
  } else if (kind === "cash") {
556
- digits = below(10) ? 4 : 2;
623
+ // A currency pair's precision, never the digits a feed wrote its closes with.
624
+ return fxRateDigits(context.currency, reference);
557
625
  } else if (kind === "crypto") {
558
626
  digits = below(1) ? subUnitDigits : below(100) ? 4 : 2;
559
627
  } else if (kind === "contract") {
@@ -35,6 +35,8 @@ export interface FuturesWeekendClosure {
35
35
  closedAt: number;
36
36
  /** The Sunday open that ends it, when the venue's contracts all open then or later. */
37
37
  reopensAt?: number;
38
+ /** The zone that open is kept in, beside it. */
39
+ timeZone?: string;
38
40
  /** That open's local date, `YYYY-MM-DD` (always a Sunday). */
39
41
  reopensOn?: string;
40
42
  }
@@ -63,6 +65,6 @@ export function futuresWeekendClosure(exchange: string | undefined, time: number
63
65
  if (time < closedAt || time >= reopensAt) return null;
64
66
  return {
65
67
  closedAt,
66
- ...(venue.reopens ? { reopensAt, reopensOn: new Date((friday + 2) * MS_PER_DAY).toISOString().slice(0, 10) } : {}),
68
+ ...(venue.reopens ? { reopensAt, timeZone: WEEK_ZONE, reopensOn: new Date((friday + 2) * MS_PER_DAY).toISOString().slice(0, 10) } : {}),
67
69
  };
68
70
  }
@@ -0,0 +1,73 @@
1
+ import { canonicalExchange } from "../../utils/exchanges";
2
+ import { zonedDateTimeParts } from "../../utils/zoned-date-time";
3
+ import { hasPublishedFuturesCalendar, isPublishedFuturesClosure } from "../published-futures-sessions";
4
+ import { getPublishedUsEquitySession } from "../published-us-sessions";
5
+ import { futuresWeekendClosure } from "./futures-week";
6
+
7
+ const MS_PER_DAY = 86_400_000;
8
+ const ZONE = "America/Chicago";
9
+ /** CME Globex's day runs from 17:00 Central to 16:00 the next day; the hour between is its daily break. */
10
+ const BREAK_START_MINUTES = 16 * 60;
11
+ const BREAK_END_MINUTES = 17 * 60;
12
+ const GLOBEX_VENUES = new Set(["CME", "CBT", "NYM", "CMX"]);
13
+
14
+ const isoDay = (day: number) => new Date(day * MS_PER_DAY).toISOString().slice(0, 10);
15
+
16
+ /** A weekday US equities close or close early on: Globex's hours around it vary by contract. */
17
+ function isUsHolidayOrEarlyClose(date: string): boolean | null {
18
+ const weekday = new Date(`${date}T00:00:00Z`).getUTCDay();
19
+ if (weekday === 0 || weekday === 6) return false;
20
+ const session = getPublishedUsEquitySession("NYSE", date);
21
+ if (!session) return null;
22
+ return session.kind === "closed" || zonedDateTimeParts(session.close, "America/New_York").hour < 16;
23
+ }
24
+
25
+ /**
26
+ * Whether CME Globex is open at `time` for a contract that trades its whole
27
+ * day, 17:00 Central to 16:00 the next day from Sunday evening to Friday
28
+ * afternoon (equity index, rates, energy, metals and FX: cmegroup.com
29
+ * /trading-hours), by the clock and not by the contract's latest print, which
30
+ * a delayed feed only shows a quarter of an hour after the 17:00 reopen.
31
+ * False in the daily break and over the weekend. Null for a venue that is not
32
+ * Globex, and on a day the calendar cannot vouch for: a trade date CME Group
33
+ * has not published or holds no session on, and a US holiday or early close,
34
+ * whose Globex hours vary by contract; the quote's own state says those.
35
+ */
36
+ export function globexDayOpen(exchange: string | undefined, time: number): boolean | null {
37
+ const venue = canonicalExchange(exchange);
38
+ if (!GLOBEX_VENUES.has(venue) || !Number.isFinite(time)) return null;
39
+ if (futuresWeekendClosure(venue, time)) return false;
40
+ const { year, month, day, hour, minute } = zonedDateTimeParts(time, ZONE);
41
+ const minutes = hour * 60 + minute;
42
+ if (minutes >= BREAK_START_MINUTES && minutes < BREAK_END_MINUTES) return false;
43
+ const local = Date.UTC(year, month - 1, day) / MS_PER_DAY;
44
+ // From 17:00 the trades are booked on the next trade date.
45
+ const tradeDate = isoDay(minutes >= BREAK_END_MINUTES ? local + 1 : local);
46
+ if (!hasPublishedFuturesCalendar(venue, tradeDate) || isPublishedFuturesClosure(venue, tradeDate)) return null;
47
+ for (const date of new Set([isoDay(local), tradeDate])) {
48
+ const unusual = isUsHolidayOrEarlyClose(date);
49
+ if (unusual !== false) return null;
50
+ }
51
+ return true;
52
+ }
53
+
54
+ /** Central time the day session opens (08:30): until then the night that opened the trade date is still trading. */
55
+ const DAY_SESSION_MINUTES = 8 * 60 + 30;
56
+
57
+ /**
58
+ * The CME Globex trade date a print at `time` is booked on, and whether it
59
+ * came in the overnight hours that opened that date: from 17:00 Central the
60
+ * day before (Sunday's for Monday's) to the 08:30 day open, before the
61
+ * previous session's settlement is confirmed. Null off Globex or without a
62
+ * time. Weekends roll forward; holidays are the caller's calendar to apply.
63
+ */
64
+ export function globexPrintSession(exchange: string | null | undefined, time: number | null | undefined): { tradeDate: string; overnight: boolean } | null {
65
+ const venue = canonicalExchange(exchange ?? undefined);
66
+ if (!GLOBEX_VENUES.has(venue) || time == null || !Number.isFinite(time) || time <= 0) return null;
67
+ const { year, month, day, hour, minute } = zonedDateTimeParts(time, ZONE);
68
+ const local = Date.UTC(year, month - 1, day) / MS_PER_DAY;
69
+ const minutes = hour * 60 + minute;
70
+ let trade = minutes >= BREAK_END_MINUTES ? local + 1 : local;
71
+ while (new Date(trade * MS_PER_DAY).getUTCDay() % 6 === 0) trade += 1;
72
+ return { tradeDate: isoDay(trade), overnight: trade > local || minutes < DAY_SESSION_MINUTES };
73
+ }