gloomberb 0.20.1 → 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 (422) hide show
  1. package/README.md +16 -26
  2. package/README.zh-CN.md +21 -65
  3. package/package.json +1 -1
  4. package/src/account/auth-model.ts +20 -1
  5. package/src/account/upgrade-dialog.tsx +8 -4
  6. package/src/api-client/askg.ts +7 -1
  7. package/src/api-client/auth.ts +27 -0
  8. package/src/api-client/catalysts.ts +2 -0
  9. package/src/api-client/company-kpis.ts +2 -1
  10. package/src/api-client/cot.ts +14 -2
  11. package/src/api-client/data.ts +3 -2
  12. package/src/api-client/earnings.ts +46 -3
  13. package/src/api-client/futures-curve.ts +17 -0
  14. package/src/api-client/index.ts +4 -1
  15. package/src/api-client/one-tap-reasons.ts +42 -0
  16. package/src/api-client/perps.ts +2 -1
  17. package/src/api-client/request.ts +3 -1
  18. package/src/api-client/research-activity.ts +16 -3
  19. package/src/api-client/types/filings-and-calls.ts +3 -0
  20. package/src/api-client/types/search.ts +3 -0
  21. package/src/app/keybindings/chord.ts +153 -9
  22. package/src/app/keybindings/index.ts +1 -1
  23. package/src/app/keybindings/labels.ts +49 -6
  24. package/src/app/runtime/desktop-deeplink.ts +73 -8
  25. package/src/app.tsx +7 -1
  26. package/src/architecture/core-builtin-allowlist.json +1 -2
  27. package/src/architecture/pane-tabs-allowlist.json +2 -1
  28. package/src/architecture/shortcut-labels-allowlist.json +11 -0
  29. package/src/architecture/ui-literals-allowlist.json +8 -8
  30. package/src/brokers/broker-portfolio-sync.ts +1 -1
  31. package/src/cli/bank-section.ts +26 -12
  32. package/src/cli/commands/market.ts +266 -75
  33. package/src/cli/commands/ticker.ts +12 -7
  34. package/src/cli/desktop-pane-shot-browser.ts +47 -31
  35. package/src/cli/desktop-pane-shot.ts +15 -0
  36. package/src/cli/entry.ts +5 -0
  37. package/src/cli/export-source.ts +7 -1
  38. package/src/cli/freshness.ts +0 -16
  39. package/src/cli/fx-pair.ts +64 -12
  40. package/src/cli/fx-quote-rate.ts +144 -0
  41. package/src/cli/glossary.ts +5 -0
  42. package/src/cli/history-back-adjust.ts +122 -0
  43. package/src/cli/history-rows.ts +114 -10
  44. package/src/cli/index.ts +4 -1
  45. package/src/cli/known-gaps.ts +45 -3
  46. package/src/cli/listing-arg.ts +48 -4
  47. package/src/cli/name-entries.ts +25 -5
  48. package/src/cli/pane-functions/catalog.ts +12 -2
  49. package/src/cli/pane-functions/dom.ts +4 -2
  50. package/src/cli/pane-functions/headless.ts +8 -5
  51. package/src/cli/pane-functions/index.ts +3 -0
  52. package/src/cli/pane-functions/resolver.ts +4 -1
  53. package/src/cli/pane-functions/screenshot-assessment.ts +15 -3
  54. package/src/cli/pane-functions/screenshot-payload.ts +130 -66
  55. package/src/cli/pane-functions/screenshot-render.ts +14 -2
  56. package/src/cli/pane-functions/screenshot-types.ts +4 -0
  57. package/src/cli/symbol-rows.ts +22 -2
  58. package/src/cli/ticker-resolution.ts +74 -17
  59. package/src/components/chart/composite/axis-overlays.tsx +13 -3
  60. package/src/components/chart/composite/composite-chart.tsx +8 -1
  61. package/src/components/chart/composite/format.ts +16 -1
  62. package/src/components/chart/composite/legend.tsx +4 -3
  63. package/src/components/chart/composite/panel-labels.ts +2 -1
  64. package/src/components/chart/composite/panel-surface.tsx +33 -4
  65. package/src/components/chart/composite/time-scale.ts +1 -1
  66. package/src/components/chart/composite/toolbar.tsx +8 -4
  67. package/src/components/chart/composite/types.ts +17 -1
  68. package/src/components/chart/composite/use-composite-chart-keyboard.ts +15 -5
  69. package/src/components/chart/composite/use-composite-viewport.ts +31 -8
  70. package/src/components/chart/static/scatter-chart-surface.tsx +25 -9
  71. package/src/components/chart-table/axis.ts +11 -0
  72. package/src/components/command-bar/assist/inventory.ts +3 -2
  73. package/src/components/command-bar/commands/collection-list.ts +3 -2
  74. package/src/components/command-bar/panel/layout.ts +8 -1
  75. package/src/components/command-bar/panel/prompt-width.ts +34 -0
  76. package/src/components/command-bar/panel/state.ts +4 -0
  77. package/src/components/command-bar/routes/root/search-providers.ts +3 -2
  78. package/src/components/command-bar/routes/root/search-report.ts +2 -2
  79. package/src/components/command-bar/workflow/ticker-listing-picker.ts +1 -0
  80. package/src/components/company-logo.tsx +2 -2
  81. package/src/components/data-table/view.tsx +11 -2
  82. package/src/components/feed-data-table/stack-view.tsx +20 -6
  83. package/src/components/feedback-dialog.tsx +3 -1
  84. package/src/components/form-modal/field-row.tsx +1 -1
  85. package/src/components/form-modal/routes.ts +1 -0
  86. package/src/components/index.ts +1 -1
  87. package/src/components/layout/header.tsx +12 -3
  88. package/src/components/layout/market-summary.ts +2 -1
  89. package/src/components/layout/pane/footer/index.tsx +9 -5
  90. package/src/components/layout/pane/footer/model.ts +26 -10
  91. package/src/components/layout/pane/footer/registration.tsx +60 -1
  92. package/src/components/layout/pane/header-tabs.tsx +17 -3
  93. package/src/components/layout/pane/header.tsx +5 -2
  94. package/src/components/layout/pane/pane-tabs.tsx +57 -3
  95. package/src/components/layout/shell/active-drag.ts +38 -30
  96. package/src/components/layout/shell/drag/index.ts +51 -21
  97. package/src/components/layout/shell/menu.ts +3 -5
  98. package/src/components/layout/shell/pane/actions.ts +4 -1
  99. package/src/components/layout/shell/pane/ask.ts +5 -2
  100. package/src/components/layout/status-bar.tsx +59 -54
  101. package/src/components/markdown-text.tsx +35 -10
  102. package/src/components/onboarding/first-run-workspace.ts +25 -23
  103. package/src/components/onboarding/onboarding-keyboard.ts +6 -1
  104. package/src/components/onboarding/onboarding-wizard.tsx +12 -2
  105. package/src/components/onboarding/portfolio-step/positions-panel.tsx +3 -3
  106. package/src/components/onboarding/use-onboarding-broker-form.ts +2 -1
  107. package/src/components/onboarding/use-onboarding-progress.ts +11 -4
  108. package/src/components/onboarding/use-onboarding-upgrade.ts +3 -2
  109. package/src/components/onboarding/wizard-positions.ts +8 -1
  110. package/src/components/pane-notice-seen.ts +125 -0
  111. package/src/components/pane-settings-dialog/field-dialogs.tsx +2 -1
  112. package/src/components/pane-settings-dialog.tsx +7 -6
  113. package/src/components/sign-in-code-panel.tsx +3 -2
  114. package/src/components/speedometer-gauge/terminal.tsx +30 -9
  115. package/src/components/ticker/list-table-view.tsx +39 -3
  116. package/src/components/ui/confirm-dialog.tsx +2 -1
  117. package/src/components/ui/data-table/index.tsx +4 -2
  118. package/src/components/ui/data-table/opentui/index.tsx +15 -5
  119. package/src/components/ui/data-table/types.ts +8 -0
  120. package/src/components/ui/external-link.tsx +4 -1
  121. package/src/components/ui/field-grid.tsx +1 -1
  122. package/src/components/ui/index.ts +2 -0
  123. package/src/components/ui/inline-quick-add.tsx +5 -0
  124. package/src/components/ui/multi-select/dialog.tsx +10 -9
  125. package/src/components/ui/pane-link-chip.tsx +354 -0
  126. package/src/components/ui/query-bar.tsx +22 -13
  127. package/src/components/ui/ratio-bar.tsx +24 -1
  128. package/src/components/ui/select-button.tsx +2 -1
  129. package/src/components/ui/shortcut-hint.tsx +6 -3
  130. package/src/components/ui/table-layout.ts +81 -0
  131. package/src/components/ui/tabs.tsx +45 -6
  132. package/src/components/use-pane-notice-footer.tsx +12 -4
  133. package/src/core/app-service-ports.ts +1 -1
  134. package/src/data/plugin-state-store.ts +44 -8
  135. package/src/docs/snapshot.json +53 -32
  136. package/src/i18n/es.ts +25 -6
  137. package/src/i18n/ja.ts +25 -5
  138. package/src/i18n/ko.ts +25 -5
  139. package/src/i18n/zh-cn.ts +25 -5
  140. package/src/i18n/zh-tw.ts +25 -5
  141. package/src/layout/pane-manager/gridlock-inference.ts +2 -1
  142. package/src/layout/pane-manager/gridlock.ts +47 -2
  143. package/src/layout-marketplace/api.ts +1 -0
  144. package/src/layout-marketplace/gallery.tsx +4 -3
  145. package/src/layout-marketplace/linked.ts +6 -4
  146. package/src/layout-marketplace/model.ts +3 -2
  147. package/src/market-data/futures-contract.ts +77 -31
  148. package/src/market-data/fx-closes.ts +5 -2
  149. package/src/market-data/hooks.tsx +23 -0
  150. package/src/market-data/market/change-basis.ts +72 -14
  151. package/src/market-data/market/format.ts +19 -11
  152. package/src/market-data/market/globex-day.ts +73 -0
  153. package/src/market-data/market/index-level.ts +10 -1
  154. package/src/market-data/quotes/intraday-bar.ts +1 -1
  155. package/src/market-data/quotes/session-split.ts +28 -0
  156. package/src/plugins/builtin/account-management/pane.tsx +1 -1
  157. package/src/plugins/builtin/analytics/account-returns.ts +1 -1
  158. package/src/plugins/builtin/analytics/index.tsx +10 -3
  159. package/src/plugins/builtin/analytics/pane-model.ts +1 -1
  160. package/src/plugins/builtin/analytics/risk-client.ts +4 -1
  161. package/src/plugins/builtin/analytics/risk-episodes.ts +422 -0
  162. package/src/plugins/builtin/analytics/risk-fx.ts +1 -1
  163. package/src/plugins/builtin/analytics/risk-headless.ts +28 -10
  164. package/src/plugins/builtin/analytics/risk-math.ts +1 -1
  165. package/src/plugins/builtin/analytics/risk-model.ts +115 -26
  166. package/src/plugins/builtin/analytics/risk-pane.tsx +201 -23
  167. package/src/plugins/builtin/analytics/sharpe-cadence.ts +1 -1
  168. package/src/plugins/builtin/backtest/format.ts +14 -0
  169. package/src/plugins/builtin/backtest/pane.tsx +3 -3
  170. package/src/plugins/builtin/backtest/report.ts +5 -3
  171. package/src/plugins/builtin/broker-manager/add-request.ts +10 -1
  172. package/src/plugins/builtin/broker-trading/pane.tsx +20 -2
  173. package/src/plugins/builtin/buildout/company/flow.tsx +5 -5
  174. package/src/plugins/builtin/buildout/company/model.ts +14 -2
  175. package/src/plugins/builtin/catalysts/detail.tsx +2 -2
  176. package/src/plugins/builtin/catalysts/model.ts +7 -2
  177. package/src/plugins/builtin/catalysts/pane.tsx +2 -2
  178. package/src/plugins/builtin/chat/message/pane-chip.tsx +36 -208
  179. package/src/plugins/builtin/cloud/askg/answer-follow-ups.tsx +61 -0
  180. package/src/plugins/builtin/cloud/askg/answer-sources.tsx +102 -0
  181. package/src/plugins/builtin/cloud/askg/controller.ts +7 -1
  182. package/src/plugins/builtin/cloud/askg/host.ts +57 -0
  183. package/src/plugins/builtin/cloud/askg/model.ts +45 -5
  184. package/src/plugins/builtin/cloud/askg/pane.tsx +304 -25
  185. package/src/plugins/builtin/cloud/askg/protocol.ts +26 -1
  186. package/src/plugins/builtin/cloud/askg/sources.ts +466 -0
  187. package/src/plugins/builtin/cloud/one-tap/controller.ts +309 -0
  188. package/src/plugins/builtin/cloud/one-tap/google-identity.ts +142 -0
  189. package/src/plugins/builtin/cloud/one-tap/one-tap-prompt.tsx +101 -0
  190. package/src/plugins/builtin/cloud/plugin.tsx +7 -1
  191. package/src/plugins/builtin/company-kpis/client.ts +4 -3
  192. package/src/plugins/builtin/company-kpis/model.ts +34 -3
  193. package/src/plugins/builtin/correlation/index.tsx +39 -167
  194. package/src/plugins/builtin/correlation/matrix/grid.tsx +285 -0
  195. package/src/plugins/builtin/correlation/relationship/pane.tsx +6 -7
  196. package/src/plugins/builtin/correlation/relationship/view-model.ts +14 -5
  197. package/src/plugins/builtin/cot/client.ts +8 -3
  198. package/src/plugins/builtin/cot/headless.ts +65 -12
  199. package/src/plugins/builtin/cot/pane.tsx +11 -5
  200. package/src/plugins/builtin/earnings/client.ts +40 -6
  201. package/src/plugins/builtin/earnings/fiscal-quarter.ts +54 -0
  202. package/src/plugins/builtin/earnings/headless.ts +47 -11
  203. package/src/plugins/builtin/earnings/history-model.ts +136 -24
  204. package/src/plugins/builtin/earnings/history-table.ts +42 -10
  205. package/src/plugins/builtin/earnings/history.tsx +23 -8
  206. package/src/plugins/builtin/earnings-ripple/client.ts +5 -2
  207. package/src/plugins/builtin/earnings-ripple/headless.ts +8 -3
  208. package/src/plugins/builtin/earnings-ripple/model.ts +21 -0
  209. package/src/plugins/builtin/earnings-ripple/pane.tsx +2 -3
  210. package/src/plugins/builtin/econ/index.tsx +5 -4
  211. package/src/plugins/builtin/econ-statistics/stats.ts +13 -5
  212. package/src/plugins/builtin/equity-screener/headless.ts +2 -1
  213. package/src/plugins/builtin/filing-events/feed.ts +56 -18
  214. package/src/plugins/builtin/filing-events/pane.tsx +8 -2
  215. package/src/plugins/builtin/futures/index.tsx +32 -10
  216. package/src/plugins/builtin/futures/model.ts +93 -6
  217. package/src/plugins/builtin/futures/returns.ts +29 -7
  218. package/src/plugins/builtin/futures/table.tsx +59 -17
  219. package/src/plugins/builtin/futures/use-front-returns.ts +32 -6
  220. package/src/plugins/builtin/futures-curve/client.ts +12 -2
  221. package/src/plugins/builtin/futures-curve/headless.ts +58 -17
  222. package/src/plugins/builtin/futures-curve/model.ts +111 -15
  223. package/src/plugins/builtin/futures-curve/pane.tsx +11 -6
  224. package/src/plugins/builtin/fx-matrix/amount.ts +132 -0
  225. package/src/plugins/builtin/fx-matrix/headless.ts +53 -13
  226. package/src/plugins/builtin/fx-matrix/index.tsx +205 -42
  227. package/src/plugins/builtin/fx-matrix/pairs.ts +10 -8
  228. package/src/plugins/builtin/fx-matrix/settings.ts +22 -1
  229. package/src/plugins/builtin/help/index.tsx +68 -61
  230. package/src/plugins/builtin/holders/format.ts +7 -2
  231. package/src/plugins/builtin/holders/pane.tsx +11 -3
  232. package/src/plugins/builtin/holders/report-header.ts +5 -4
  233. package/src/plugins/builtin/holders/report-rows.ts +4 -1
  234. package/src/plugins/builtin/holders/treemap.tsx +5 -3
  235. package/src/plugins/builtin/insider/signals-model.ts +4 -5
  236. package/src/plugins/builtin/ipo-calendar/headless.ts +18 -7
  237. package/src/plugins/builtin/ipo-calendar/listing-ipo.ts +3 -1
  238. package/src/plugins/builtin/ipo-calendar/model.ts +28 -8
  239. package/src/plugins/builtin/ipo-calendar/pane.tsx +2 -1
  240. package/src/plugins/builtin/kelly-sizer/headless.ts +4 -0
  241. package/src/plugins/builtin/perps/headless.ts +73 -17
  242. package/src/plugins/builtin/perps/index.tsx +3 -1
  243. package/src/plugins/builtin/perps/model.ts +1 -1
  244. package/src/plugins/builtin/perps/pane.tsx +2 -0
  245. package/src/plugins/builtin/portfolio-list/cell-version.ts +1 -0
  246. package/src/plugins/builtin/portfolio-list/cli/bulk-symbols.ts +20 -1
  247. package/src/plugins/builtin/portfolio-list/cli/import-positions.ts +260 -0
  248. package/src/plugins/builtin/portfolio-list/cli/period-report.ts +154 -0
  249. package/src/plugins/builtin/portfolio-list/cli/portfolio-command.ts +64 -22
  250. package/src/plugins/builtin/portfolio-list/cli/render.ts +18 -7
  251. package/src/plugins/builtin/portfolio-list/cli/watchlist-command.ts +5 -3
  252. package/src/plugins/builtin/portfolio-list/grid.tsx +56 -12
  253. package/src/plugins/builtin/portfolio-list/headless.ts +128 -0
  254. package/src/plugins/builtin/portfolio-list/pane/index.tsx +42 -4
  255. package/src/plugins/builtin/portfolio-list/pane/period-pnl.ts +124 -0
  256. package/src/plugins/builtin/portfolio-list/period-pnl.ts +179 -0
  257. package/src/plugins/builtin/portfolio-list/positions-import/dialog.tsx +445 -0
  258. package/src/plugins/builtin/portfolio-list/positions-import/index.tsx +255 -0
  259. package/src/plugins/builtin/portfolio-list/positions-import/lookup.ts +78 -0
  260. package/src/plugins/builtin/portfolio-list/positions-import/read-file.ts +32 -0
  261. package/src/plugins/builtin/portfolio-list/quick-add/index.tsx +186 -50
  262. package/src/plugins/builtin/portfolio-list/quick-add/resolution.ts +118 -4
  263. package/src/plugins/builtin/portfolio-list/settings.ts +25 -0
  264. package/src/plugins/builtin/portfolio-list/summary/index.tsx +16 -1
  265. package/src/plugins/builtin/portfolio-list/summary/totals.ts +7 -5
  266. package/src/plugins/builtin/portfolio-list/table.tsx +105 -6
  267. package/src/plugins/builtin/power/headless.ts +47 -9
  268. package/src/plugins/builtin/research/relative-valuation-model.ts +8 -3
  269. package/src/plugins/builtin/research-search/article.ts +12 -2
  270. package/src/plugins/builtin/research-search/data.ts +5 -2
  271. package/src/plugins/builtin/research-search/document-view.tsx +1 -1
  272. package/src/plugins/builtin/research-search/model.ts +47 -3
  273. package/src/plugins/builtin/research-search/pane.tsx +3 -2
  274. package/src/plugins/builtin/reverse-dcf/model.ts +7 -4
  275. package/src/plugins/builtin/risk-factors/headless.ts +3 -2
  276. package/src/plugins/builtin/risk-factors/pane.tsx +5 -3
  277. package/src/plugins/builtin/scanner/flow-model.ts +17 -13
  278. package/src/plugins/builtin/scanner/flow-pane.tsx +8 -9
  279. package/src/plugins/builtin/scanner/flow-session.ts +2 -9
  280. package/src/plugins/builtin/sec/filing-display.tsx +0 -5
  281. package/src/plugins/builtin/sec/forms.ts +19 -0
  282. package/src/plugins/builtin/sec/headless.ts +7 -11
  283. package/src/plugins/builtin/sec/index.tsx +11 -3
  284. package/src/plugins/builtin/shared/earnings-calendar.ts +6 -3
  285. package/src/plugins/builtin/shared/earnings-report.ts +1 -1
  286. package/src/plugins/builtin/shared/fx-rate-freshness.ts +0 -35
  287. package/src/plugins/builtin/shared/use-quote-board.ts +42 -27
  288. package/src/plugins/builtin/supply-chain/graph-model.ts +7 -1
  289. package/src/plugins/builtin/supply-chain/headless.ts +20 -10
  290. package/src/plugins/builtin/supply-chain/model.ts +117 -20
  291. package/src/plugins/builtin/supply-chain/pane.tsx +22 -15
  292. package/src/plugins/builtin/supply-chain/row-evidence.tsx +1 -1
  293. package/src/plugins/builtin/ticker-detail/data-panes/returns-chart-model.ts +69 -0
  294. package/src/plugins/builtin/ticker-detail/data-panes/returns-chart.tsx +118 -0
  295. package/src/plugins/builtin/ticker-detail/data-panes/returns-model.ts +1 -1
  296. package/src/plugins/builtin/ticker-detail/data-panes/returns-pane.tsx +103 -40
  297. package/src/plugins/builtin/ticker-detail/headless-schema.ts +10 -1
  298. package/src/plugins/builtin/ticker-detail/headless.ts +8 -1
  299. package/src/plugins/builtin/ticker-detail/overview/components.tsx +2 -1
  300. package/src/plugins/builtin/ticker-detail/overview/model.ts +4 -2
  301. package/src/plugins/builtin/ticker-detail/overview-tab.tsx +11 -8
  302. package/src/plugins/builtin/ticker-detail/pane.tsx +95 -20
  303. package/src/plugins/builtin/ticker-detail/research-groups.ts +89 -0
  304. package/src/plugins/builtin/ticker-detail/settings.ts +4 -3
  305. package/src/plugins/builtin/volatility/charts.tsx +2 -2
  306. package/src/plugins/host-resolver.ts +3 -2
  307. package/src/portfolio/column-values.ts +42 -8
  308. package/src/portfolio/futures-positions.ts +10 -2
  309. package/src/portfolio/mutations.ts +4 -3
  310. package/src/portfolio/period-pnl.ts +119 -0
  311. package/src/portfolio/positions-import/describe.ts +89 -0
  312. package/src/portfolio/positions-import/parse.ts +682 -0
  313. package/src/portfolio/positions-import/plan.ts +295 -0
  314. package/src/{plugins/builtin/analytics/metrics.ts → portfolio/return-metrics.ts} +24 -11
  315. package/src/public/__snapshots__/public-api.test.ts.snap +1 -0
  316. package/src/react/jsx-dev-fallback.ts +62 -0
  317. package/src/renderers/browser/cloud-transport.ts +1 -1
  318. package/src/renderers/browser/config-host.ts +3 -1
  319. package/src/renderers/browser/deeplink-bridge.ts +8 -1
  320. package/src/renderers/browser/http-proxy-transport.ts +9 -2
  321. package/src/renderers/browser/main.tsx +2 -1
  322. package/src/renderers/browser/research-entry.ts +12 -0
  323. package/src/renderers/cloudflare/http-proxy.ts +8 -2
  324. package/src/renderers/cloudflare/proxy-session.ts +1 -0
  325. package/src/renderers/cloudflare/worker.ts +12 -3
  326. package/src/renderers/dom/desktop/audio-player.tsx +2 -2
  327. package/src/renderers/dom/desktop/controls.tsx +1 -1
  328. package/src/renderers/dom/desktop/dialog-actions.tsx +10 -24
  329. package/src/renderers/dom/desktop/icons.tsx +4 -2
  330. package/src/renderers/dom/desktop/query-bar.tsx +23 -19
  331. package/src/renderers/dom/dom-host-providers.tsx +7 -2
  332. package/src/renderers/dom/host/box.tsx +2 -2
  333. package/src/renderers/dom/host/input.tsx +13 -0
  334. package/src/renderers/dom/key-event.ts +1 -0
  335. package/src/renderers/dom/styles.css +3 -0
  336. package/src/renderers/electrobun/bun/context-menu/click.ts +1 -0
  337. package/src/renderers/electrobun/bun/desktop/backend.ts +1 -0
  338. package/src/renderers/electrobun/bun/desktop/capability-bridge.ts +5 -4
  339. package/src/renderers/electrobun/bun/desktop/host-requests.ts +5 -4
  340. package/src/renderers/electrobun/bun/desktop/http-fetch.ts +1 -0
  341. package/src/renderers/electrobun/bun/desktop/http-stream.ts +1 -1
  342. package/src/renderers/electrobun/bun/desktop/initialization.ts +3 -1
  343. package/src/renderers/electrobun/bun/desktop/install-records.ts +4 -1
  344. package/src/renderers/electrobun/bun/desktop/installer-folder.ts +5 -2
  345. package/src/renderers/electrobun/bun/desktop/macos-objc.ts +3 -1
  346. package/src/renderers/electrobun/bun/desktop/screen-setup-file.ts +9 -4
  347. package/src/renderers/electrobun/bun/desktop/update.ts +27 -13
  348. package/src/renderers/electrobun/bun/desktop/windows-script.ts +6 -2
  349. package/src/renderers/electrobun/bun/window/attention.ts +1 -0
  350. package/src/renderers/electrobun/bun/window/boot-frame.ts +1 -0
  351. package/src/renderers/electrobun/bun/window/create.ts +1 -0
  352. package/src/renderers/electrobun/bun/window/electrobun-window-host.ts +13 -8
  353. package/src/renderers/electrobun/bun/window/native-min-size.ts +1 -1
  354. package/src/renderers/electrobun/bun/window/remembered-frame.ts +1 -0
  355. package/src/renderers/electrobun/bun/window/windows-native.ts +3 -1
  356. package/src/renderers/electrobun/bun/window/windows-quit.ts +3 -1
  357. package/src/renderers/electrobun/view/app-badge-host.ts +2 -1
  358. package/src/renderers/electrobun/view/capability-subscription.ts +2 -1
  359. package/src/renderers/electrobun/view/cli-pane-shot-entry.tsx +7 -10
  360. package/src/renderers/electrobun/view/cli-pane-shot-mutations.ts +36 -0
  361. package/src/renderers/electrobun/view/http-fetch.ts +2 -1
  362. package/src/renderers/electrobun/view/main.tsx +9 -4
  363. package/src/renderers/electrobun/view/remote/capability-invoker.ts +6 -3
  364. package/src/renderers/electrobun/view/remote/persistence.ts +63 -27
  365. package/src/renderers/electrobun/view/rpc-timeout.ts +1 -0
  366. package/src/renderers/electrobun/view/ui-host.tsx +3 -2
  367. package/src/renderers/electrobun/view/window-fullscreen.ts +3 -1
  368. package/src/renderers/opentui/browser-open.ts +2 -1
  369. package/src/renderers/opentui/dialog-host.tsx +1 -1
  370. package/src/renderers/opentui/interaction-performance.ts +3 -1
  371. package/src/renderers/opentui/start.tsx +2 -1
  372. package/src/renderers/opentui/terminal-media.ts +11 -6
  373. package/src/renderers/opentui/ui-host.tsx +5 -8
  374. package/src/shares/open.ts +22 -1
  375. package/src/shares/pane.ts +2 -1
  376. package/src/sources/gloomberb-cloud/normalizers.ts +3 -0
  377. package/src/sync/analytics-payload.ts +194 -0
  378. package/src/sync/baseline.ts +19 -9
  379. package/src/sync/broker-identity.ts +171 -0
  380. package/src/sync/broker-instances.ts +137 -0
  381. package/src/sync/collections-contributor.ts +173 -0
  382. package/src/sync/config-contributor.ts +100 -0
  383. package/src/sync/config-merge.ts +229 -0
  384. package/src/sync/controller.ts +139 -28
  385. package/src/sync/core-contributors.ts +8 -1583
  386. package/src/sync/history-memo.ts +32 -0
  387. package/src/sync/layout-merge.ts +259 -0
  388. package/src/sync/sanitize.ts +114 -0
  389. package/src/sync/ticker-merge.ts +208 -0
  390. package/src/sync/ticker-payload.ts +81 -0
  391. package/src/sync/types.ts +15 -1
  392. package/src/telemetry/attention-setting.ts +1 -1
  393. package/src/telemetry/usage-counts.ts +16 -0
  394. package/src/test-support/preload.ts +5 -0
  395. package/src/theme/color-utils.ts +10 -0
  396. package/src/theme/font-scale.ts +34 -3
  397. package/src/theme/series-colors.ts +44 -0
  398. package/src/theme/themes.ts +2 -1
  399. package/src/tickers/batched-lookups.ts +263 -6
  400. package/src/tickers/company-name-listing.ts +44 -2
  401. package/src/tickers/company-name.ts +7 -2
  402. package/src/tickers/search/upsert.ts +16 -1
  403. package/src/time-series/base-series.ts +18 -4
  404. package/src/time-series/studies/indicators.ts +3 -1
  405. package/src/time-series/studies/resolve.ts +1 -1
  406. package/src/time-series/types.ts +6 -0
  407. package/src/types/financials.ts +18 -0
  408. package/src/types/headless.ts +11 -0
  409. package/src/ui/host.tsx +26 -3
  410. package/src/ui/index.tsx +1 -0
  411. package/src/utils/concurrency.ts +6 -0
  412. package/src/utils/currency-pair.ts +56 -4
  413. package/src/utils/datetime-format.ts +11 -0
  414. package/src/utils/decimal-comma.ts +9 -6
  415. package/src/utils/exchanges.ts +32 -0
  416. package/src/utils/fundamentals.ts +41 -0
  417. package/src/utils/markdown.ts +4 -2
  418. package/src/utils/pasted-lines.ts +14 -0
  419. package/src/utils/price-window.ts +2 -1
  420. package/src/utils/sec-filings.ts +17 -0
  421. package/src/utils/sec.ts +4 -23
  422. package/src/utils/shortcut-labels.ts +6 -30
@@ -1,5 +1,5 @@
1
1
  import type { CloudFilingEventPayload } from "../../../api-client";
2
- import { formatShortDate } from "../../../utils/datetime-format";
2
+ import { formatFilingDate } from "../../../utils/datetime-format";
3
3
  import { wrapTextLines } from "../../../utils/text-wrap";
4
4
 
5
5
  /** Every 8-K carries exhibits, so the label says nothing beside another one. */
@@ -16,12 +16,19 @@ export interface FilingEventPerson {
16
16
  export interface FilingEventEntry {
17
17
  id: string;
18
18
  filedLabel: string;
19
+ /** "8-K", or "8-K/A" for an amendment, on every entry as a filing list names its forms. */
20
+ form: string;
19
21
  itemsLabel: string;
20
22
  docUrl: string;
21
23
  material: boolean;
22
24
  headline: string | null;
23
25
  points: string[];
24
26
  people: FilingEventPerson[];
27
+ /**
28
+ * A blank row above it: an entry with a read under its row does, a filing
29
+ * listed under ALSO FILED is one row of a table and does not.
30
+ */
31
+ spaced: boolean;
25
32
  /** Lines the entry occupies in the feed, its leading blank row included. */
26
33
  lines: number;
27
34
  /** First line of the entry in the feed, its leading blank row included. */
@@ -44,28 +51,59 @@ function formatCalendarDate(value: string | null | undefined): string | null {
44
51
  if (!value || !/^\d{4}-\d{2}-\d{2}$/.test(value)) return null;
45
52
  const date = new Date(`${value}T00:00:00Z`);
46
53
  if (!Number.isFinite(date.getTime()) || date.toISOString().slice(0, 10) !== value) return null;
47
- return formatShortDate(date, { day: "2-digit", year: "2-digit", utc: true });
54
+ return formatFilingDate(date);
48
55
  }
49
56
 
57
+ /** The day EDGAR dated it; without one, the day of the acceptance instant, in UTC as filing days are. */
50
58
  function formatFiled(event: CloudFilingEventPayload): string {
51
- return formatCalendarDate(event.filingDate)
52
- ?? formatShortDate(event.filedAt, { day: "2-digit", year: "2-digit", fallback: "\u2014" });
59
+ return formatCalendarDate(event.filingDate) ?? formatFilingDate(event.filedAt);
53
60
  }
54
61
 
55
62
  function itemsLabel(event: CloudFilingEventPayload): string {
56
63
  const named = event.labels.filter((label) => label !== EXHIBITS_LABEL);
57
64
  const labels = named.length > 0 ? named : event.labels;
58
- const items = labels.join(" · ") || UNCLASSIFIED_LABEL;
59
- // An amendment restates or completes an earlier 8-K; say so before its items.
60
- return event.form?.trim().toUpperCase() === "8-K/A" ? `8-K/A · ${items}` : items;
65
+ return labels.join(" · ") || UNCLASSIFIED_LABEL;
61
66
  }
62
67
 
63
- function personDetail(person: CloudFilingEventPayload["people"][number]): string {
64
- return [
65
- person.role,
66
- person.action,
67
- person.effective ? `effective ${formatCalendarDate(person.effective) ?? "—"}` : null,
68
- ].filter(Boolean).join(", ");
68
+ type FilingPerson = CloudFilingEventPayload["people"][number];
69
+
70
+ /** Actions that end a role: what a move between two roles goes from. */
71
+ const LEAVING_ACTIONS = new Set(["left", "resigned", "resigned as director"]);
72
+
73
+ const effectiveLabel = (effective: string | null) => `effective ${formatCalendarDate(effective) ?? "—"}`;
74
+
75
+ /**
76
+ * What happened to one person, on one line: a move from one role to another
77
+ * reads `Chief Executive Officer → Executive Chair`, roles taken or left at
78
+ * once are listed together, and a date every role shares is said once.
79
+ */
80
+ function personDetail(changes: FilingPerson[]): string {
81
+ const dates = new Set(changes.map((change) => change.effective ?? ""));
82
+ const shared = dates.size === 1 ? changes[0]!.effective : null;
83
+ const dated = (text: string, effective: string | null) =>
84
+ dates.size > 1 && effective ? `${text}, ${effectiveLabel(effective)}` : text;
85
+ const leaving = changes.filter((change) => LEAVING_ACTIONS.has(change.action));
86
+ const taking = changes.filter((change) => !LEAVING_ACTIONS.has(change.action) && change.action !== "other");
87
+ const other = changes.filter((change) => change.action === "other");
88
+ const roles = (list: FilingPerson[]) => list.map((change) => dated(change.role, change.effective)).join(", ");
89
+ const withAction = (list: FilingPerson[]) => list.map((change) => dated(`${change.role}, ${change.action}`, change.effective));
90
+ const parts = leaving.length > 0 && taking.length > 0
91
+ ? [`${roles(leaving)} → ${roles(taking)}`, ...withAction(other)]
92
+ : withAction([...leaving, ...taking, ...other]);
93
+ const text = parts.join("; ");
94
+ return shared ? `${text}, ${effectiveLabel(shared)}` : text;
95
+ }
96
+
97
+ /** Each person named once, in the order the filing first names them. */
98
+ function filingPeople(people: FilingPerson[]): FilingEventPerson[] {
99
+ const byName = new Map<string, { name: string; changes: FilingPerson[] }>();
100
+ for (const person of people) {
101
+ const key = person.name.trim().replace(/\s+/g, " ").toLowerCase();
102
+ const entry = byName.get(key) ?? { name: person.name.trim(), changes: [] };
103
+ entry.changes.push(person);
104
+ byName.set(key, entry);
105
+ }
106
+ return [...byName.values()].map((entry) => ({ name: entry.name, detail: personDetail(entry.changes) }));
69
107
  }
70
108
 
71
109
  /** A filing the model read and had something to say about. */
@@ -86,23 +124,23 @@ function buildEntry(
86
124
  const points = detailed && event.summary
87
125
  ? event.summary.split("\n").map((point) => point.trim()).filter(Boolean)
88
126
  : [];
89
- const people = detailed
90
- ? event.people.map((person) => ({ name: person.name, detail: personDetail(person) }))
91
- : [];
92
- // One blank row above, then the filed-and-items row, then whatever was read.
93
- let lines = 2;
127
+ const people = detailed ? filingPeople(event.people) : [];
128
+ // One blank row above a read entry, then the filed-and-items row, then whatever was read.
129
+ let lines = detailed ? 2 : 1;
94
130
  if (headline) lines += proseLines(headline, proseWidth);
95
131
  for (const point of points) lines += proseLines(point, proseWidth, BULLET_PREFIX);
96
132
  for (const person of people) lines += proseLines(person.detail, proseWidth, `${person.name} `);
97
133
  return {
98
134
  id: event.id,
99
135
  filedLabel: formatFiled(event),
136
+ form: event.form?.trim().toUpperCase() || "8-K",
100
137
  itemsLabel: itemsLabel(event),
101
138
  docUrl: event.docUrl,
102
139
  material: event.material,
103
140
  headline,
104
141
  points,
105
142
  people,
143
+ spaced: detailed,
106
144
  lines,
107
145
  };
108
146
  }
@@ -42,6 +42,9 @@ const EK_WALL: ProFeatureWallCopy = {
42
42
  message: "Every 8-K classified by item and read: agreements, executive changes, auditor changes, restructurings, and what each one said.",
43
43
  };
44
44
 
45
+ /** Cells "8-K/A" takes, so the items of every row start in one column. */
46
+ const FORM_WIDTH = 5;
47
+
45
48
  /** One filing: when it was filed, what it was about, and what it said. */
46
49
  function FilingEntry({
47
50
  entry,
@@ -62,11 +65,11 @@ function FilingEntry({
62
65
  // row ends, or a third item label runs off it mid-word.
63
66
  const items = nativePaneChrome
64
67
  ? entry.itemsLabel
65
- : truncateToDisplayWidth(entry.itemsLabel, Math.max(4, proseWidth - entry.filedLabel.length - 2));
68
+ : truncateToDisplayWidth(entry.itemsLabel, Math.max(4, proseWidth - entry.filedLabel.length - FORM_WIDTH - 4));
66
69
  return (
67
70
  <Box
68
71
  flexDirection="column"
69
- marginTop={1}
72
+ marginTop={entry.spaced ? 1 : 0}
70
73
  backgroundColor={selected ? hoverBg(colors) : undefined}
71
74
  data-gloom-role="filing-event"
72
75
  data-gloom-row="true"
@@ -80,6 +83,9 @@ function FilingEntry({
80
83
  color={selected ? colors.selectedText : colors.textDim}
81
84
  onOpen={onOpen}
82
85
  />
86
+ <Box width={FORM_WIDTH} flexShrink={0}>
87
+ <Text fg={selected ? colors.selectedText : colors.textMuted}>{entry.form}</Text>
88
+ </Box>
83
89
  <Text fg={selected ? colors.selectedText : entry.material ? colors.warning : colors.textDim}>
84
90
  {items}
85
91
  </Text>
@@ -48,8 +48,11 @@ import {
48
48
  DEFAULT_FUTURES_SORT,
49
49
  effectiveCollapsedSectors,
50
50
  FUTURES_RETURN_COLUMNS,
51
+ futuresBoardQuotes,
51
52
  futuresNoMatchFailure,
53
+ futuresReturnBaseText,
52
54
  futuresRowId,
55
+ futuresSessionQuote,
53
56
  type FuturesColumnId,
54
57
  type FuturesSortPreference,
55
58
  type FuturesTableRow,
@@ -57,6 +60,7 @@ import {
57
60
  import {
58
61
  createFuturesColumns,
59
62
  FUTURES_COLUMN_DEFS,
63
+ FUTURES_REPORT_COLUMNS,
60
64
  renderFuturesCell,
61
65
  resolveFuturesColumnIds,
62
66
  usesSessionText,
@@ -138,47 +142,64 @@ export function FuturesPane({ focused, width, height }: PaneProps) {
138
142
  const paneVisible = usePaneVisible();
139
143
  const showsReturns = columns.some((column) => FUTURES_RETURN_COLUMNS[column.id]);
140
144
  const returns = useFrontContractReturns(listedContracts, quotes, dataProvider, showsReturns && paneVisible);
145
+ // What each drawn return runs from (`1M from Mon 5 Oct close`): the report says it, the desktop header's hover too.
146
+ const returnBases = useMemo(() => new Map(columns.flatMap((column) => {
147
+ const horizon = FUTURES_RETURN_COLUMNS[column.id];
148
+ const text = horizon ? futuresReturnBaseText(horizon, returns) : null;
149
+ return text ? [[column.id, text] as const] : [];
150
+ })), [columns, returns]);
151
+ const titledColumns = useMemo(() => returnBases.size === 0 ? columns
152
+ : columns.map((column) => returnBases.has(column.id) ? { ...column, title: returnBases.get(column.id) } : column), [columns, returnBases]);
153
+ useRemoteUiNode(returnBases.size > 0 ? {
154
+ role: "report-notice",
155
+ label: "Return base dates",
156
+ getMetadata: () => ({ text: `Returns: ${[...returnBases.values()].join("; ")}.` }),
157
+ } : null);
141
158
  // The unit a price counts and the month a symbol rolled past, as `quote` reads them.
142
159
  const terms = useFuturesBoardTerms(listedContracts, !!dataProvider && paneVisible);
160
+ // Each move measured as `quote` measures it with the row's terms, so a row never flips between references at the reopen.
161
+ const shownQuotes = useMemo(() => futuresBoardQuotes(quotes, terms), [quotes, terms]);
143
162
 
144
163
  const visibleCollapsed = effectiveCollapsedSectors(collapsedSectors, searchQuery);
145
164
  const rows = useMemo(
146
- () => buildFuturesRows(contractsBySector, sortPreference, quotes, {
165
+ () => buildFuturesRows(contractsBySector, sortPreference, shownQuotes, {
147
166
  query: searchQuery,
148
167
  collapsed: collapsedSectors,
149
168
  returns,
150
169
  terms,
151
170
  }),
152
- [collapsedSectors, contractsBySector, quotes, returns, searchQuery, sortPreference, terms],
171
+ [collapsedSectors, contractsBySector, returns, searchQuery, shownQuotes, sortPreference, terms],
153
172
  );
154
173
 
155
174
  const sessionText = usesSessionText(width);
156
- const quotesRef = useRef(quotes);
175
+ const quotesRef = useRef(shownQuotes);
157
176
  const returnsRef = useRef(returns);
158
177
  const termsRef = useRef(terms);
159
- quotesRef.current = quotes;
178
+ quotesRef.current = shownQuotes;
160
179
  returnsRef.current = returns;
161
180
  termsRef.current = terms;
162
181
  const renderCell = useCallback((
163
182
  row: FuturesTableRow,
164
183
  column: FuturesColumn,
165
- ) => renderFuturesCell(row, column, quotesRef.current, { sessionText, returns: returnsRef.current, terms: termsRef.current }), [sessionText]);
184
+ ) => renderFuturesCell(row, column, quotesRef.current, { sessionText, returns: returnsRef.current, terms: termsRef.current, now: Date.now() }),
185
+ [sessionText]);
166
186
  // Everything a cell reads: the headline figures the board shows, the quote's
167
187
  // other fields, whether the last good quote is held over, and the returns.
168
188
  const getRowVersion = useCallback((row: FuturesTableRow) => {
169
189
  if (row.type !== "row") return row.sector;
170
- const state = quotes.get(row.contract.symbol);
190
+ const state = shownQuotes.get(row.contract.symbol);
171
191
  const quote = state?.quote ? boardHeadlineQuote(state.quote) : null;
172
192
  const values = returns.get(row.contract.symbol);
173
193
  const contract = terms.get(row.contract.symbol);
174
194
  return [
175
195
  state?.loading, state?.stale,
176
- quote?.price, quote?.change, quote?.changePercent, quote?.previousClose, quote?.volume, quote?.lastUpdated, quote?.marketState, quote?.symbol, quote?.name,
177
- values?.loading, values?.values["1W"], values?.values["1M"], values?.values.YTD,
196
+ quote?.price, quote?.change, quote?.changePercent, quote?.previousClose, quote?.volume, quote?.lastUpdated, quote?.symbol, quote?.name,
197
+ futuresSessionQuote(row.contract, quote)?.marketState,
198
+ values?.loading, ...Object.values(values?.values ?? {}),
178
199
  contract?.loading, contract?.terms?.spec?.unit, contract?.terms?.deliveryMonth, contract?.terms?.nearest?.contract,
179
200
  contract?.terms?.nearest?.lastTrade, contract?.terms?.mostActive?.contract,
180
201
  ].join(":");
181
- }, [quotes, returns, terms]);
202
+ }, [returns, shownQuotes, terms]);
182
203
 
183
204
  const toggleSector = useCallback((sector: FuturesSector) => {
184
205
  setCollapsedSectors((current) => {
@@ -325,7 +346,7 @@ export function FuturesPane({ focused, width, height }: PaneProps) {
325
346
  }}
326
347
  rootWidth={width}
327
348
  rootHeight={height}
328
- columns={columns}
349
+ columns={titledColumns}
329
350
  items={dataProvider ? rows : []}
330
351
  sortable
331
352
  sortColumnId={sortPreference.columnId}
@@ -342,6 +363,7 @@ export function FuturesPane({ focused, width, height }: PaneProps) {
342
363
  getRowVersion={getRowVersion}
343
364
  selectedTextOverridesCellColor
344
365
  reportEveryRow
366
+ reportColumns={showsReturns ? FUTURES_REPORT_COLUMNS : undefined}
345
367
  emptyStateTitle={searchQuery.trim()
346
368
  ? "No matching contracts."
347
369
  : "No market data provider connected."}
@@ -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,