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
@@ -3,9 +3,12 @@ import type { Quote } from "../../../types/financials";
3
3
  import { compareSortValues, type SortDirection } from "../../../utils/sort-values";
4
4
  import type { BoardQuoteMap } from "../shared/use-quote-board";
5
5
  import { FUTURES_SECTOR_ORDER, type FuturesContract, type FuturesSector } from "../../../market-data/futures-board";
6
- import { futuresPriceUnit } from "../../../market-data/futures-contract";
6
+ import { CONTRACT_MONTH_NAME, futuresPriceUnit } from "../../../market-data/futures-contract";
7
7
  import { contractMonthLabel } from "../../../utils/contract-month";
8
8
  import { quoteDotMarketState } from "../../../market-data/market/status";
9
+ import { futuresQuoteFromSettle } from "../../../market-data/market/change-basis";
10
+ import { globexDayOpen } from "../../../market-data/market/globex-day";
11
+ import { periodBaseDay, periodBaseText, periodDayText } from "../../../market-data/market/period-return";
9
12
  import type { FuturesReturnHorizon } from "./returns";
10
13
  import type { FuturesTermsMap } from "./use-board-terms";
11
14
  import type { FrontReturnsMap } from "./use-front-returns";
@@ -25,10 +28,17 @@ export type FuturesColumnId =
25
28
  | "return1w"
26
29
  | "return1m"
27
30
  | "returnYtd"
31
+ | "return3m"
32
+ | "return6m"
33
+ | "return1y"
34
+ | FuturesReturnBaseColumnId
28
35
  | "volume"
29
36
  | "prevClose"
30
37
  | "time";
31
38
 
39
+ /** The exports' column of the day a return's base close is from: `return1mFrom` beside `return1m`. */
40
+ export type FuturesReturnBaseColumnId = "return1wFrom" | "return1mFrom" | "returnYtdFrom" | "return3mFrom" | "return6mFrom" | "return1yFrom";
41
+
32
42
  export interface FuturesSortPreference {
33
43
  columnId: FuturesColumnId | null;
34
44
  direction: SortDirection;
@@ -43,9 +53,6 @@ export function futuresRowId(row: FuturesTableRow): string {
43
53
  return row.type === "header" ? `header-${row.sector}` : row.contract.symbol;
44
54
  }
45
55
 
46
- /** "Nov 2026", "Nov 26" or "Futures,Nov-2026"; a hyphen takes only a whole year, since "Futures,Nov-20" is 2026 cut short. */
47
- const CONTRACT_MONTH = /\b(Jan|Feb|Mar|Apr|May|Jun|Jul|Aug|Sep|Oct|Nov|Dec)(?: (\d{4}|\d{2})|-(\d{4}))$/i;
48
-
49
56
  /**
50
57
  * The alias stays the row identity while its quoted contract rolls, so the
51
58
  * label is the catalog name plus the quoted contract's month ("30-Year T-Bond
@@ -67,7 +74,7 @@ export function quotedContractMonth(
67
74
  quote?: Quote | null,
68
75
  ): { year: number; month: number } | null {
69
76
  if (quote?.symbol?.trim().toUpperCase() !== contract.symbol.toUpperCase()) return null;
70
- const match = CONTRACT_MONTH.exec(quote.name?.trim() ?? "");
77
+ const match = CONTRACT_MONTH_NAME.exec(quote.name?.trim() ?? "");
71
78
  if (!match) return null;
72
79
  const month = MONTH_NAMES.findIndex((name) => name.toLowerCase() === match[1]!.toLowerCase());
73
80
  const written = match[2] ?? match[3]!;
@@ -166,12 +173,82 @@ export function futuresNoMatchFailure(query: string): { message: string; details
166
173
  };
167
174
  }
168
175
 
176
+ export const FUTURES_RETURN_BASE_COLUMNS: Readonly<Record<FuturesReturnBaseColumnId, FuturesReturnHorizon>> = {
177
+ return1wFrom: "1W",
178
+ return1mFrom: "1M",
179
+ returnYtdFrom: "YTD",
180
+ return3mFrom: "3M",
181
+ return6mFrom: "6M",
182
+ return1yFrom: "1Y",
183
+ };
184
+
169
185
  export const FUTURES_RETURN_COLUMNS: Readonly<Partial<Record<FuturesColumnId, FuturesReturnHorizon>>> = {
170
186
  return1w: "1W",
171
187
  return1m: "1M",
172
188
  returnYtd: "YTD",
189
+ return3m: "3M",
190
+ return6m: "6M",
191
+ return1y: "1Y",
173
192
  };
174
193
 
194
+ /**
195
+ * What each drawn return is measured from, as the report and the column's
196
+ * hover name it: `1M from Mon 5 Oct close`, the day every row's base close
197
+ * is from, or the day each row's close is on or before when rows differ (a
198
+ * venue closed on it). Null for a horizon no row has a return for.
199
+ */
200
+ export function futuresReturnBaseText(
201
+ horizon: FuturesReturnHorizon,
202
+ returns: FrontReturnsMap,
203
+ now = Date.now(),
204
+ ): string | null {
205
+ const days = new Set<string>();
206
+ for (const state of returns.values()) {
207
+ const day = state.bases?.[horizon];
208
+ if (day) days.add(day);
209
+ }
210
+ if (days.size === 0) return null;
211
+ if (days.size === 1) return `${horizon} ${periodBaseText([...days][0]!, now)}`;
212
+ const asked = periodBaseDay(new Date(now).toISOString().slice(0, 10), horizon);
213
+ return `${horizon} from each contract's close on or before ${periodDayText(asked, new Date(now).getUTCFullYear())}`;
214
+ }
215
+
216
+ /** Sectors whose contracts trade CME Globex's whole day, 17:00 to 16:00 Central; grains, softs, lumber and livestock keep shorter hours. */
217
+ const GLOBEX_DAY_SECTORS: ReadonlySet<FuturesSector> = new Set(["equity-index", "equity-sectors", "rates", "energy", "metals", "currencies"]);
218
+
219
+ /**
220
+ * The row's quote in the session CME Globex's clock gives a contract that
221
+ * trades its whole day (globexDayOpen): open from the 17:00 reopen, before a
222
+ * delayed feed shows a trade of it, and closed in the daily break, whatever
223
+ * its last print says. Any other row, and a day the calendar cannot vouch
224
+ * for, keeps the state its quote reports.
225
+ */
226
+ export function futuresSessionQuote(contract: FuturesContract, quote: Quote | null | undefined, now = Date.now()): Quote | null | undefined {
227
+ if (!quote?.marketState || quote.delisting || !GLOBEX_DAY_SECTORS.has(contract.sector)) return quote;
228
+ const open = globexDayOpen(contract.venue, now);
229
+ if (open == null) return quote;
230
+ const state = open ? "REGULAR" : "CLOSED";
231
+ return quote.marketState === state ? quote : { ...quote, marketState: state };
232
+ }
233
+
234
+ /**
235
+ * The board's quotes with each row's move measured as `quote` measures it
236
+ * with the row's terms (futuresQuoteFromSettle): from the last confirmed
237
+ * settlement while nothing confirms the source's reference, so a row never
238
+ * flips between two references at the reopen. The same map while no row
239
+ * changes.
240
+ */
241
+ export function futuresBoardQuotes(quotes: BoardQuoteMap, terms: FuturesTermsMap): BoardQuoteMap {
242
+ let next: BoardQuoteMap | null = null;
243
+ for (const [symbol, state] of quotes) {
244
+ const quote = futuresQuoteFromSettle(state.quote, terms.get(symbol)?.terms);
245
+ if (quote === state.quote) continue;
246
+ next ??= new Map(quotes);
247
+ next.set(symbol, { ...state, quote });
248
+ }
249
+ return next ?? quotes;
250
+ }
251
+
175
252
  function getSortValue(
176
253
  columnId: FuturesColumnId,
177
254
  contract: FuturesContract,
@@ -184,7 +261,7 @@ function getSortValue(
184
261
  case "unit":
185
262
  return futuresUnitLabel(contract, terms?.get(contract.symbol)?.terms);
186
263
  case "status":
187
- return quoteDotMarketState(quote) === "REGULAR" ? 0 : 1;
264
+ return quoteDotMarketState(futuresSessionQuote(contract, quote)) === "REGULAR" ? 0 : 1;
188
265
  case "code":
189
266
  return contract.code;
190
267
  case "name":
@@ -198,7 +275,17 @@ function getSortValue(
198
275
  case "return1w":
199
276
  case "return1m":
200
277
  case "returnYtd":
278
+ case "return3m":
279
+ case "return6m":
280
+ case "return1y":
201
281
  return returns?.get(contract.symbol)?.values[FUTURES_RETURN_COLUMNS[columnId]!] ?? null;
282
+ case "return1wFrom":
283
+ case "return1mFrom":
284
+ case "returnYtdFrom":
285
+ case "return3mFrom":
286
+ case "return6mFrom":
287
+ case "return1yFrom":
288
+ return returns?.get(contract.symbol)?.bases?.[FUTURES_RETURN_BASE_COLUMNS[columnId]] ?? null;
202
289
  case "volume":
203
290
  return quote?.volume ?? null;
204
291
  case "prevClose":
@@ -3,10 +3,16 @@ import { periodReturn } from "../../../market-data/market/period-return";
3
3
  import type { FuturesContract } from "../../../market-data/futures-board";
4
4
  import { quotedContractMonth } from "./model";
5
5
 
6
- export type FuturesReturnHorizon = "1W" | "1M" | "YTD";
6
+ /** The board draws 1W, 1M and YTD; its JSON and CSV add 3M, 6M and 1Y. */
7
+ export type FuturesReturnHorizon = "1W" | "1M" | "3M" | "6M" | "1Y" | "YTD";
7
8
  export type FuturesReturnValues = Readonly<Record<FuturesReturnHorizon, number | null>>;
8
9
 
9
- export const NO_FUTURES_RETURNS: FuturesReturnValues = { "1W": null, "1M": null, YTD: null };
10
+ const HORIZONS: readonly FuturesReturnHorizon[] = ["1W", "1M", "3M", "6M", "1Y", "YTD"];
11
+
12
+ export const NO_FUTURES_RETURNS: FuturesReturnValues = { "1W": null, "1M": null, "3M": null, "6M": null, "1Y": null, YTD: null };
13
+
14
+ /** The day of the close each return is measured from (`YYYY-MM-DD`), null where it has none. */
15
+ export type FuturesReturnBases = Readonly<Record<FuturesReturnHorizon, string | null>>;
10
16
 
11
17
  const MONTH_CODES = "FGHJKMNQUVXZ";
12
18
 
@@ -83,8 +89,8 @@ export function pickFrontContract(
83
89
 
84
90
  /**
85
91
  * One contract's returns: the latest price against that same contract's close
86
- * on or before the same date a week and a calendar month earlier, and its
87
- * last close of the year before (periodReturn). The continuous alias's own
92
+ * on or before the same date a week and one, three, six and twelve calendar
93
+ * months earlier, and its last close of the year before (periodReturn). The continuous alias's own
88
94
  * series jumps at every roll (LE=F fell 6.3% on a July roll day), so its
89
95
  * history is never the baseline. `price` is the live quote, dated `asOf`;
90
96
  * without one the contract's last close stands in.
@@ -94,11 +100,27 @@ export function frontContractReturns(
94
100
  price: number | null | undefined,
95
101
  asOf: number | null | undefined,
96
102
  ): FuturesReturnValues {
103
+ return frontContractPeriodReturns(history, price, asOf).values;
104
+ }
105
+
106
+ /**
107
+ * frontContractReturns with the day of each return's base close, which the
108
+ * board's JSON and CSV carry and its report names: `fn FUT ZC`'s
109
+ * 1M on Thu 5 Nov runs from Mon 5 Oct's close, as CTM's 1M curve and RETURN do.
110
+ */
111
+ export function frontContractPeriodReturns(
112
+ history: readonly PricePoint[],
113
+ price: number | null | undefined,
114
+ asOf: number | null | undefined,
115
+ ): { values: FuturesReturnValues; bases: FuturesReturnBases } {
97
116
  const closes = dailyCloses(history);
98
117
  const live = price != null && Number.isFinite(price) && asOf != null && Number.isFinite(asOf);
99
118
  const liveDay = live ? utcDay(asOf) : null;
100
119
  const latest = live && liveDay ? { day: liveDay, close: price } : closes.at(-1);
101
- if (!latest) return NO_FUTURES_RETURNS;
102
- const change = (period: FuturesReturnHorizon) => periodReturn(closes, period, latest)?.percent ?? null;
103
- return { "1W": change("1W"), "1M": change("1M"), YTD: change("YTD") };
120
+ if (!latest) return { values: NO_FUTURES_RETURNS, bases: { "1W": null, "1M": null, "3M": null, "6M": null, "1Y": null, YTD: null } };
121
+ const periods = HORIZONS.map((period) => [period, periodReturn(closes, period, latest)] as const);
122
+ return {
123
+ values: Object.fromEntries(periods.map(([period, result]) => [period, result?.percent ?? null])) as FuturesReturnValues,
124
+ bases: Object.fromEntries(periods.map(([period, result]) => [period, result?.base.day ?? null])) as FuturesReturnBases,
125
+ };
104
126
  }
@@ -4,16 +4,19 @@ import type { Quote } from "../../../types/financials";
4
4
  import { TextAttributes } from "../../../ui";
5
5
  import { formatCompact, formatNumber, formatPercentRaw } from "../../../utils/format";
6
6
  import { minorUnitSign } from "../../../utils/currency-units";
7
- import { isBoardRowLoading, renderQuoteBoardCell, type BoardQuoteMap } from "../shared/use-quote-board";
7
+ import { boardHeadlineQuote, isBoardRowLoading, renderQuoteBoardCell, type BoardQuoteMap } from "../shared/use-quote-board";
8
8
  import { tickDecimals, type FuturesContract } from "../../../market-data/futures-board";
9
- import { FUTURES_RETURN_COLUMNS, futuresContractHeadline, futuresUnitLabel, type FuturesColumnId, type FuturesTableRow } from "./model";
9
+ import { FUTURES_RETURN_BASE_COLUMNS, FUTURES_RETURN_COLUMNS, futuresContractHeadline, futuresSessionQuote, futuresUnitLabel, type FuturesColumnId, type FuturesTableRow } from "./model";
10
10
  import type { FuturesTermsMap } from "./use-board-terms";
11
11
  import type { FrontReturnsMap } from "./use-front-returns";
12
12
 
13
13
  export type FuturesColumn = DataTableColumn & { id: FuturesColumnId };
14
14
 
15
+ /** The columns the board can draw; the 3M, 6M and 1Y returns are only the exports' (FUTURES_REPORT_COLUMNS). */
16
+ type DrawnColumnId = Exclude<FuturesColumnId, "return3m" | "return6m" | "return1y" | keyof typeof FUTURES_RETURN_BASE_COLUMNS>;
17
+
15
18
  export interface FuturesColumnDef {
16
- id: FuturesColumnId;
19
+ id: DrawnColumnId;
17
20
  label: string;
18
21
  description: string;
19
22
  }
@@ -58,7 +61,7 @@ const COLUMN_MIN_PANE_WIDTH: Partial<Record<FuturesColumnId, number>> = {
58
61
  const WIDE_UNIT_MIN_WIDTH = 200;
59
62
  const SESSION_TEXT_MIN_WIDTH = 100;
60
63
 
61
- const COLUMN_WIDTHS: Record<Exclude<FuturesColumnId, "name">, number> = {
64
+ const COLUMN_WIDTHS: Record<Exclude<DrawnColumnId, "name">, number> = {
62
65
  status: 1,
63
66
  code: 5,
64
67
  price: 12,
@@ -81,7 +84,7 @@ export function usesSessionText(width: number): boolean {
81
84
  return width >= SESSION_TEXT_MIN_WIDTH;
82
85
  }
83
86
 
84
- function columnWidth(id: Exclude<FuturesColumnId, "name">, paneWidth: number): number {
87
+ function columnWidth(id: Exclude<DrawnColumnId, "name">, paneWidth: number): number {
85
88
  if (id === "status") return usesSessionText(paneWidth) ? 9 : 1;
86
89
  if (id === "unit" && paneWidth >= WIDE_UNIT_MIN_WIDTH) return 20;
87
90
  return COLUMN_WIDTHS[id];
@@ -91,7 +94,7 @@ export function createFuturesColumns(width: number, visibleIds?: readonly string
91
94
  const ids = resolveFuturesColumnIds(visibleIds)
92
95
  .filter((id) => width >= (COLUMN_MIN_PANE_WIDTH[id] ?? 0));
93
96
  const fixed = ids
94
- .filter((id): id is Exclude<FuturesColumnId, "name"> => id !== "name")
97
+ .filter((id): id is Exclude<DrawnColumnId, "name"> => id !== "name")
95
98
  .reduce((total, id) => total + columnWidth(id, width), 0);
96
99
  // Leaves room for the pane border and scrollbar gutter; the name column grows
97
100
  // back into any slack because it is the flexible one.
@@ -114,7 +117,7 @@ export function createFuturesColumns(width: number, visibleIds?: readonly string
114
117
  });
115
118
  }
116
119
 
117
- const FUTURES_HEADER_LABELS: Record<FuturesColumnId, string> = {
120
+ const FUTURES_HEADER_LABELS: Record<DrawnColumnId, string> = {
118
121
  status: "",
119
122
  code: "SYM",
120
123
  name: "CONTRACT",
@@ -130,10 +133,23 @@ const FUTURES_HEADER_LABELS: Record<FuturesColumnId, string> = {
130
133
  time: "TIME UTC",
131
134
  };
132
135
 
136
+ /**
137
+ * Returns a script reads that the board has no room to draw: its JSON and CSV
138
+ * carry them beside the drawn 1W, 1M and YTD (DataTable `reportColumns`), and
139
+ * the day each return's base close is from, `1M from 2026-10-05`.
140
+ */
141
+ export const FUTURES_REPORT_COLUMNS: readonly FuturesColumn[] = [
142
+ { id: "return3m", label: "3M", width: 8, align: "right" },
143
+ { id: "return6m", label: "6M", width: 8, align: "right" },
144
+ { id: "return1y", label: "1Y", width: 8, align: "right" },
145
+ ...(Object.entries(FUTURES_RETURN_BASE_COLUMNS) as Array<[keyof typeof FUTURES_RETURN_BASE_COLUMNS, string]>)
146
+ .map(([id, horizon]) => ({ id, label: `${horizon} from`, width: 10, align: "left" as const })),
147
+ ];
148
+
133
149
  /** Falls back to the full column set when the saved selection is empty or unknown. */
134
- export function resolveFuturesColumnIds(visibleIds?: readonly string[]): FuturesColumnId[] {
150
+ export function resolveFuturesColumnIds(visibleIds?: readonly string[]): DrawnColumnId[] {
135
151
  const resolved = (visibleIds ?? [])
136
- .filter((id): id is FuturesColumnId => DEFAULT_FUTURES_COLUMN_IDS.includes(id as FuturesColumnId));
152
+ .filter((id): id is DrawnColumnId => DEFAULT_FUTURES_COLUMN_IDS.includes(id as DrawnColumnId));
137
153
  return resolved.length > 0 ? resolved : [...DEFAULT_FUTURES_COLUMN_IDS];
138
154
  }
139
155
 
@@ -203,12 +219,13 @@ function formatContractPrice(quote: Quote, contract: FuturesContract): string {
203
219
  * magnitude, otherwise a four-tick move on an index future renders with six
204
220
  * decimals next to a price showing two.
205
221
  */
222
+ function changeDecimals(quote: Quote, contract: FuturesContract): number {
223
+ return contract.tick || Number.isFinite(quote.price) ? priceDecimals(quote.previousClose ?? quote.price, contract) : 2;
224
+ }
225
+
206
226
  function formatContractChange(quote: Quote, contract: FuturesContract): string {
207
227
  if (!Number.isFinite(quote.change)) return "—";
208
- const decimals = contract.tick || Number.isFinite(quote.price)
209
- ? priceDecimals(quote.previousClose ?? quote.price, contract)
210
- : 2;
211
- const text = formatNumber(Math.abs(quote.change), decimals);
228
+ const text = formatNumber(Math.abs(quote.change), changeDecimals(quote, contract));
212
229
  const { prefix, suffix } = currencyMarks(quote.currency);
213
230
  return `${quote.change >= 0 ? "+" : "-"}${prefix}${text}${suffix}`;
214
231
  }
@@ -217,7 +234,7 @@ export function renderFuturesCell(
217
234
  row: FuturesTableRow,
218
235
  column: FuturesColumn,
219
236
  quotes: BoardQuoteMap,
220
- options?: { sessionText?: boolean; returns?: FrontReturnsMap; terms?: FuturesTermsMap },
237
+ options?: { sessionText?: boolean; returns?: FrontReturnsMap; terms?: FuturesTermsMap; now?: number },
221
238
  ): DataTableCell {
222
239
  if (row.type === "header") return { text: "" };
223
240
 
@@ -245,15 +262,27 @@ export function renderFuturesCell(
245
262
  if (!quote || quote.volume == null || !Number.isFinite(quote.volume)) {
246
263
  return { text: "—", color: colors.textDim };
247
264
  }
248
- return { text: formatCompact(quote.volume, { fixedDecimals: true }), color: colors.textDim };
265
+ return { text: formatCompact(quote.volume, { fixedDecimals: true }), value: quote.volume, color: colors.textDim };
249
266
  case "return1w":
250
267
  case "return1m":
251
- case "returnYtd": {
268
+ case "returnYtd":
269
+ case "return3m":
270
+ case "return6m":
271
+ case "return1y": {
252
272
  const returns = options?.returns?.get(contract.symbol);
253
273
  if (isBoardRowLoading(state) || returns?.loading) return { text: "…", color: colors.textDim };
254
274
  const value = returns?.values[FUTURES_RETURN_COLUMNS[column.id]!];
255
275
  if (value == null || !Number.isFinite(value)) return { text: "—", color: colors.textDim };
256
- return { text: formatPercentRaw(value), color: shownPriceColor(value, 2) };
276
+ return { text: formatPercentRaw(value), value, color: shownPriceColor(value, 2) };
277
+ }
278
+ case "return1wFrom":
279
+ case "return1mFrom":
280
+ case "returnYtdFrom":
281
+ case "return3mFrom":
282
+ case "return6mFrom":
283
+ case "return1yFrom": {
284
+ const base = options?.returns?.get(contract.symbol)?.bases?.[FUTURES_RETURN_BASE_COLUMNS[column.id]];
285
+ return { text: base ?? "—", color: colors.textDim };
257
286
  }
258
287
  case "prevClose":
259
288
  if (isBoardRowLoading(state)) return { text: "…", color: colors.textDim };
@@ -262,8 +291,21 @@ export function renderFuturesCell(
262
291
  }
263
292
  return {
264
293
  text: formatContractPrice({ ...quote, price: quote.previousClose }, contract),
294
+ value: quote.previousClose,
265
295
  color: colors.textDim,
266
296
  };
297
+ case "change": {
298
+ const cell = renderQuoteBoardCell("change", state, { formatPrice: (quoted) => formatContractPrice(quoted, contract),
299
+ formatChange: (quoted) => formatContractChange(quoted, contract) });
300
+ // The JSON and CSV carry the move at the precision the cell shows it, never a difference's float noise.
301
+ const shown = state?.quote && !isBoardRowLoading(state) ? boardHeadlineQuote(state.quote) : null;
302
+ return shown && Number.isFinite(shown.change) ? { ...cell, value: Number(shown.change.toFixed(changeDecimals(shown, contract))) } : cell;
303
+ }
304
+ case "status":
305
+ // A contract that trades Globex's whole day reads open from the reopen, not from the first print its feed shows.
306
+ return renderQuoteBoardCell("status", state?.quote ? { ...state, quote: futuresSessionQuote(contract, state.quote, options?.now) ?? null } : state,
307
+ { sessionText: options?.sessionText, formatPrice: (quoted) => formatContractPrice(quoted, contract),
308
+ formatChange: (quoted) => formatContractChange(quoted, contract) });
267
309
  default:
268
310
  return renderQuoteBoardCell(column.id, state, {
269
311
  sessionText: options?.sessionText,
@@ -4,6 +4,7 @@ import type { DataProvider } from "../../../types/data-provider";
4
4
  import { isNoSourceAnswer } from "../../../sources/provider-errors";
5
5
  import type { PricePoint } from "../../../types/financials";
6
6
  import { logFailure } from "../../../utils/log-failure";
7
+ import { PERIOD_BASE_MAX_GAP_DAYS, periodBaseDay } from "../../../market-data/market/period-return";
7
8
  import { coalescedBump } from "./coalesced-bump";
8
9
  import { readsInBatches } from "../../../market-data/batched-reads";
9
10
  import { boardReadGate } from "./board-reads";
@@ -11,9 +12,10 @@ import type { BoardQuoteMap } from "../shared/use-quote-board";
11
12
  import type { FuturesContract } from "../../../market-data/futures-board";
12
13
  import {
13
14
  frontContractCandidates,
14
- frontContractReturns,
15
+ frontContractPeriodReturns,
15
16
  NO_FUTURES_RETURNS,
16
17
  pickFrontContract,
18
+ type FuturesReturnBases,
17
19
  type FuturesReturnValues,
18
20
  } from "./returns";
19
21
 
@@ -21,6 +23,8 @@ interface FrontReturnsState {
21
23
  /** A candidate contract's history is still loading. */
22
24
  loading: boolean;
23
25
  values: FuturesReturnValues;
26
+ /** The day each return's base close is from, once the contract's history is read. */
27
+ bases?: FuturesReturnBases;
24
28
  }
25
29
 
26
30
  export type FrontReturnsMap = ReadonlyMap<string, FrontReturnsState>;
@@ -44,9 +48,32 @@ const HISTORY_RETRY_MS = 60_000;
44
48
  */
45
49
  const historyCache = createTtlCache<readonly PricePoint[] | null>({ ttlMs: HISTORY_TTL_MS, rejectionMs: HISTORY_RETRY_MS });
46
50
 
51
+ const DAY_MS = 86_400_000;
52
+ function dayOf(point: PricePoint): string | null {
53
+ const time = new Date(point.date as Date | string | number).getTime();
54
+ return Number.isFinite(time) ? new Date(time).toISOString().slice(0, 10) : null;
55
+ }
56
+
57
+ /**
58
+ * A year's read starts on the day a year back, so when that day did not trade
59
+ * (a weekend, a holiday) it holds no close on or before it, and the 1Y return
60
+ * has no base. The weeks before it are read too, for a contract that traded
61
+ * from the start of the year; one listed since has no close a year back to find.
62
+ */
63
+ async function withYearBackClose(provider: DataProvider, symbol: string, points: PricePoint[]): Promise<PricePoint[]> {
64
+ const read = provider.getDetailedPriceHistoryWithMetadata;
65
+ const first = points[0] ? dayOf(points[0]) : null;
66
+ const yearBack = periodBaseDay(new Date().toISOString().slice(0, 10), "1Y");
67
+ if (!read || !first || first <= yearBack || Date.parse(`${first}T00:00:00Z`) - Date.parse(`${yearBack}T00:00:00Z`) > 7 * DAY_MS) return points;
68
+ const start = new Date(Date.parse(`${yearBack}T00:00:00Z`) - PERIOD_BASE_MAX_GAP_DAYS * DAY_MS);
69
+ const earlier = await read.call(provider, symbol, "", start, new Date(`${first}T00:00:00Z`), "1d")
70
+ .then((result) => result.points.filter((point) => (dayOf(point) ?? first) < first), logFailure("futures", "Read a futures contract's close a year back failed", []));
71
+ return earlier.length > 0 ? [...earlier, ...points] : points;
72
+ }
73
+
47
74
  /** `batch`: asked with every other row's, from a source that batches them (`DataProvider.batchesReads`). */
48
75
  function readHistory(provider: DataProvider, symbol: string, batch: boolean): Promise<readonly PricePoint[] | null> {
49
- return provider.getPriceHistory(symbol, "", "1Y", batch ? { batch } : undefined).then((points) => points.length > 0 ? points : null, (error: unknown) => {
76
+ return provider.getPriceHistory(symbol, "", "1Y", batch ? { batch } : undefined).then(async (points) => points.length > 0 ? withYearBackClose(provider, symbol, points) : null, (error: unknown) => {
50
77
  if (isNoSourceAnswer(error)) return null;
51
78
  throw error;
52
79
  });
@@ -127,10 +154,9 @@ export function useFrontContractReturns(
127
154
  const available = loaded.flatMap((entry) => entry.history ? [{ symbol: entry.symbol, history: entry.history }] : []);
128
155
  const front = pickFrontContract(available, quote?.price);
129
156
  const history = available.find((entry) => entry.symbol === front)?.history;
130
- result.set(contract.symbol, {
131
- loading: false,
132
- values: history ? frontContractReturns(history, quote?.price, quote?.lastUpdated) : NO_FUTURES_RETURNS,
133
- });
157
+ result.set(contract.symbol, history
158
+ ? { loading: false, ...frontContractPeriodReturns(history, quote?.price, quote?.lastUpdated) }
159
+ : { loading: false, values: NO_FUTURES_RETURNS });
134
160
  }
135
161
  return result;
136
162
  // `version` re-reads the history cache as loads land.
@@ -19,6 +19,13 @@ const rank = (value: unknown) => value === null || typeof value === "number" &&
19
19
  const optionalDate = (value: unknown) => value === undefined || value === null || date(value);
20
20
  /** Contract terms the pane computes with; a curve from before the server sent them has none. */
21
21
  const validSpec = (spec: unknown) => spec === undefined || spec === null || isFuturesContractSpec(spec);
22
+ /** A contract's spot in its print's minute; absent from other roots and older servers. */
23
+ function validContractSpot(spot: unknown): boolean {
24
+ if (spot === undefined || spot === null) return true;
25
+ if (typeof spot !== "object") return false;
26
+ const { symbol, price, minute } = spot as Record<string, unknown>;
27
+ return typeof symbol === "string" && typeof price === "number" && Number.isFinite(price) && price > 0 && timestamp(minute);
28
+ }
22
29
 
23
30
  export function validateFuturesCurve(data: FuturesCurvePayload, root: string): FuturesCurvePayload {
24
31
  if (!data || data.root !== root || !Array.isArray(data.contracts) || !Array.isArray(data.ghosts)
@@ -39,7 +46,7 @@ export function validateFuturesCurve(data: FuturesCurvePayload, root: string): F
39
46
  || row.asOf !== null && !timestamp(row.asOf)
40
47
  || ![row.volume, row.openInterest, row.delayMinutes].every((value) => finiteOrNull(value) && (value === null || value >= 0))
41
48
  || row.settlement !== undefined && !finiteOrNull(row.settlement) || !optionalDate(row.lastTrade) || !optionalDate(row.firstNotice)
42
- || row.inDelivery !== undefined && typeof row.inDelivery !== "boolean") {
49
+ || row.inDelivery !== undefined && typeof row.inDelivery !== "boolean" || !validContractSpot(row.spot)) {
43
50
  throw new Error("The server returned an invalid futures contract");
44
51
  }
45
52
  symbols.add(row.symbol);
@@ -57,7 +64,10 @@ export function validateFuturesCurve(data: FuturesCurvePayload, root: string): F
57
64
  || ![slope.percentile, slope.rollPercentile].every(rank) || !Number.isInteger(slope.samples) || slope.samples < 0
58
65
  || slope.asOf !== null && !timestamp(slope.asOf)
59
66
  || slope.basis != null && slope.basis !== "last" && slope.basis !== "settle"
60
- || slope.thinSymbol != null && typeof slope.thinSymbol !== "string") throw new Error("The server returned an invalid futures spread");
67
+ || slope.thinSymbol != null && typeof slope.thinSymbol !== "string"
68
+ || slope.skippedSymbols != null && !(Array.isArray(slope.skippedSymbols) && slope.skippedSymbols.every((symbol) => typeof symbol === "string"))) {
69
+ throw new Error("The server returned an invalid futures spread");
70
+ }
61
71
  return data;
62
72
  }
63
73