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
@@ -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
 
@@ -5,7 +5,7 @@ import { formatPercentRaw } from "../../../utils/format";
5
5
  import { DATE_OPTION_EXAMPLES } from "../../../utils/calendar-date";
6
6
  import { newestReportTime, oldestReportTime } from "../../../utils/utc-time";
7
7
  import { fetchFuturesCurve, loadCurveSpot, loadCurveSpotBars, loadCurveSpotCloses, loadFuturesCurveAsOf } from "./client";
8
- import { basisSpotSymbol, BASIS_CONVENTION, blankBasisNote, catalogueCurveUnit, curveAsOfDate, curveBasisPercent, curveBasisRows, curveChangeText, curveContractCode, curvePrice, curveReadsThirtySeconds, curveRoundedPrice, curveSpotSource, curveSpotPremium, curveSpreadLabel, curveTimestamp, curveNoTradeSince, curveUnitLabel, noTradeChangeNote, normalizeCurveRoot, shortDatedBasisNote, spotIndexSymbol, thinSpreadNotice, unpairedContractCount, unsupportedCurveRootMessage, type ContractBasis, type CurveSpotPremium } from "./model";
8
+ import { basisSpotSymbol, BASIS_CONVENTION, blankBasisNote, catalogueCurveUnit, curveAsOfDate, curveCache, curveSpotBars, curveBasisPercent, curveBasisRows, curveChangeText, curveContractCode, curvePrice, curveReadsThirtySeconds, curveRoundedPrice, curveSpotSource, curveSpotPremium, curveSpreadLabel, curveTimestamp, curveNoTradeSince, curveSettleShown, curveUnitLabel, noTradeChangeNote, normalizeCurveRoot, shortDatedBasisNote, skippedSpreadNotice, spotIndexSymbol, thinSpreadNotice, unpairedContractCount, unsupportedCurveRootMessage, type ContractBasis, type CurveSpotPremium } from "./model";
9
9
  import { COMMODITIES_VIEW_STATE } from "../commodities-energy/view-state";
10
10
  import { knownGapMessage } from "../../../cli/known-gaps";
11
11
 
@@ -24,7 +24,9 @@ const basisValue = (value: number | null) => value == null ? null : Number(value
24
24
  * the latest trade and `settlement` the exchange settlement for the curve's
25
25
  * settlement session (a past curve's settled rows have no separate trade).
26
26
  * `change` is `price` less `settlement`; `noTradeSince` dates the settlement
27
- * a contract has not traded since, whose change is therefore blank. A crypto
27
+ * a contract has not traded since, whose change is therefore blank, and
28
+ * `settleShown` the one it is shown and plotted at (no trade since, or none
29
+ * at all). A crypto
28
30
  * root adds the basis: the spot in the minute of `price`'s trade and that
29
31
  * minute (`spot`, `spotTime`), the fractional days from the trade to final
30
32
  * settlement, and the premium and its yearly rate.
@@ -37,6 +39,8 @@ function contractRow(row: FuturesContract, data: FuturesCurvePayload, root: stri
37
39
  settlement: price(row.settlement), settlementDate: row.settlement != null ? data.settlementDate ?? null : null,
38
40
  price: past && row.settlement != null ? null : price(row.price), change: price(row.change),
39
41
  noTradeSince: past ? null : curveNoTradeSince(row, data),
42
+ // The settlement session a live contract is shown at, when it has no trade since (or none at all): its curve point is that settlement.
43
+ settleShown: past ? null : curveSettleShown(row, data),
40
44
  asOf: row.asOf, stale: row.stale, volume: row.volume, openInterest: row.openInterest, percentile: rank(row.percentile),
41
45
  samples: row.samples, historyStart: row.historyStart, historyEnd: row.historyEnd,
42
46
  currency: row.currency, quoteUnit: curveUnitLabel(data) ?? row.quoteUnit, delayMinutes: row.delayMinutes,
@@ -53,22 +57,30 @@ function contractRow(row: FuturesContract, data: FuturesCurvePayload, root: stri
53
57
  function contractColumns(root: string, settlementDate: string | null, options: { basis: boolean; last: boolean; notice: boolean; text?: boolean }): HeadlessPaneColumn[] {
54
58
  const price = (value: unknown) => typeof value === "number" ? curvePrice(value, root) : "--";
55
59
  const date = (value: unknown) => typeof value === "string" ? value : "--";
60
+ // An export has every column whatever the root, so CL's and GC's headers are the same; the text drops the ones a root leaves blank.
61
+ const exported = !options.text;
56
62
  return [
57
63
  { key: "symbol", header: "Contract", shrink: false, format: (value) => curveContractCode(String(value)) },
58
64
  { key: "lastTrade", header: "Last Trade", shrink: false, format: date },
59
65
  // Cash-settled roots have no first notice day.
60
- ...options.notice ? [{ key: "firstNotice", header: "1st Notice", shrink: false,
66
+ ...options.notice || exported ? [{ key: "firstNotice", header: "1st Notice", shrink: false,
61
67
  format: (value: unknown, row: Record<string, unknown>) => typeof value === "string" ? `${value}${row.inDelivery ? " passed" : ""}` : "--" }] : [],
62
- { key: "settlement", header: settlementDate ? `Settle ${settlementDate}` : "Settle", align: "right", format: price },
63
- // A Cboe price is the settlement itself, with no separate last trade.
64
- ...options.last ? [{ key: "price", header: "Last", align: "right" as const, format: price }] : [],
68
+ // One header whatever the session: an export dates each settlement in its own column, the text in the header.
69
+ { key: "settlement", header: "Settle", ...settlementDate ? { textHeader: `Settle ${settlementDate}` } : {}, align: "right", format: price },
70
+ ...options.text ? [] : [{ key: "settlementDate", header: "settle_date", literalHeader: true, shrink: false, format: date }],
71
+ // A Cboe price is the settlement itself, with no separate last trade: an export leaves its Last blank.
72
+ ...options.last || exported ? [{ key: "price", header: "Last", align: "right" as const, format: options.last ? price : () => "--" }] : [],
65
73
  { key: "change", header: "Change", align: "right", format: (value) => typeof value === "number" ? curveChangeText(value, root) : "--" },
66
- ...options.basis ? [{ key: "spot", header: "Spot", align: "right" as const, format: price },
74
+ ...options.basis || exported ? [{ key: "spot", header: "Spot", align: "right" as const, format: price },
67
75
  ...options.text ? [] : [{ key: "spotTime", header: "Spot Time UTC", shrink: false, format: (value: unknown) => typeof value === "string" ? curveTimestamp(value) : "--" }],
68
76
  { key: "vsSpotPct", header: "Vs Spot", align: "right" as const, format: (value: unknown) => curveBasisPercent(typeof value === "number" ? value : null, 2) },
69
77
  { key: "daysToExpiry", header: "Days to Expiry", textHeader: "Days", align: "right" as const, format: (value: unknown) => typeof value === "number" ? value.toFixed(1) : "--" },
70
78
  { key: "annualisedBasisPct", header: "Ann Basis", align: "right" as const, format: (value: unknown) => curveBasisPercent(typeof value === "number" ? value : null, 1) }] : [],
71
- { key: "asOf", header: "As Of UTC", shrink: false, format: (value) => typeof value === "string" ? curveTimestamp(value) : "--" },
79
+ // A month with no trade since the settlement it shows is dated by that settlement, never read as an old print:
80
+ // the text says so, an export leaves the cell empty (settle_date dates it).
81
+ { key: "asOf", header: "As Of UTC", shrink: false,
82
+ format: (value, row) => typeof row.settleShown === "string" ? "--" : typeof value === "string" ? curveTimestamp(value) : "--",
83
+ textFormat: (value, row) => typeof row.settleShown === "string" ? `settle ${row.settleShown}` : typeof value === "string" ? curveTimestamp(value) : "--" },
72
84
  { key: "openInterest", header: "Open Int", align: "right", format: (value) => typeof value === "number" ? value.toLocaleString("en-US") : "--" },
73
85
  { key: "volume", header: "Volume", align: "right", format: (value) => typeof value === "number" ? value.toLocaleString("en-US") : "--" },
74
86
  { key: "percentile", header: "Pctl", align: "right", format: (value) => typeof value === "number" ? String(value) : "--" },
@@ -82,12 +94,29 @@ function contractColumns(root: string, settlementDate: string | null, options: {
82
94
  */
83
95
  function fieldColumns(order: readonly string[], fields: object, formats: Record<string, HeadlessPaneColumn["textFormat"]> = {}): HeadlessPaneColumn[] {
84
96
  return [...order, ...Object.keys(fields).filter((key) => !order.includes(key))]
85
- .map((key) => ({ key, header: key, ...formats[key] ? { textFormat: formats[key] } : {} }));
97
+ .map((key) => ({ key, header: key, ...SYMBOL_FIELDS.has(key) ? { format: contractCodeFormat } : {}, ...formats[key] ? { textFormat: formats[key] } : {} }));
86
98
  }
87
99
 
100
+ /**
101
+ * The front spread's columns: every field in one order, the skipped months
102
+ * last as one cell (`GCF27`), which the text names in a note instead.
103
+ */
104
+ function spreadColumns(row: Record<string, unknown>, formats: Record<string, HeadlessPaneColumn["textFormat"]>, text: boolean): HeadlessPaneColumn[] {
105
+ const fields = Object.fromEntries(Object.entries(row).filter(([key]) => key !== SKIPPED_FIELD));
106
+ return [...fieldColumns(FRONT_SPREAD_FIELDS, fields, formats),
107
+ ...text ? [] : [{ key: SKIPPED_FIELD, header: SKIPPED_FIELD, format: (value: unknown) => Array.isArray(value)
108
+ ? value.filter((entry): entry is string => typeof entry === "string").map(curveContractCode).join(" ") : "" }]];
109
+ }
110
+
111
+ /** The fields naming a contract, written in every section as the Contracts table writes it: CLZ26, never CLZ26.NYM. */
112
+ const SYMBOL_FIELDS: ReadonlySet<string> = new Set(["symbol", "frontSymbol", "nextSymbol", "thinSymbol"]);
113
+ const contractCodeFormat = (value: unknown) => typeof value === "string" && value ? curveContractCode(value) : "-";
114
+
88
115
  // `basis` says which prices the value subtracts: two last trades made together, or the settlements of the session in `asOf`.
89
116
  const FRONT_SPREAD_FIELDS = ["label", "frontSymbol", "nextSymbol", "value", "annualizedRollYield", "percentile", "rollPercentile",
90
117
  "samples", "historyStart", "historyEnd", "asOf", "basis", "state", "thinSymbol"];
118
+ /** The months the spread passed over for their thin open interest: an export keeps them, the text names them in a note. */
119
+ const SKIPPED_FIELD = "skippedSymbols";
91
120
  const GHOST_FIELDS = ["symbol", "expiration", "price", "asOf"];
92
121
  /** The annualized roll yield reads as the percent it is (+32.36%); an export keeps the number. */
93
122
  const ROLL_YIELD_FORMAT = { annualizedRollYield: (value: unknown) => typeof value === "number" ? formatPercentRaw(value) : "--" };
@@ -172,19 +201,22 @@ export const futuresCurveHeadless: HeadlessPaneDefinition<"bundle"> = {
172
201
  indexSymbol ? loadCurveSpotCloses(indexSymbol, ctx.marketData, ctx.refresh === true) : null,
173
202
  ]);
174
203
  const spotPremium = closes ? curveSpotPremium(data, closes) : null;
175
- const bases = spot && bars ? curveBasisRows(data.contracts, bars) : null;
204
+ // The server's spot in each print's own minute fills what the reader's bars do not reach yet.
205
+ const spotBars = curveSpotBars(bars, data.contracts);
206
+ const bases = spot && spotBars ? curveBasisRows(data.contracts, spotBars) : null;
176
207
  const unit = curveUnitLabel(data);
177
208
  const terms = specEntries(data);
178
209
  const source = spot ? curveSpotSource(spot) : null;
179
210
  const notices = [...args.argument ? [] : [`Showing ${DEFAULT_ROOT}. Try fn CTM ${EXAMPLE_ROOT}.`],
180
211
  ...spot ? [`Basis against ${spot.symbol} spot in each last trade's own minute${source ? ` (${source})` : ""}; not the CME reference rate.`] : []];
181
212
  // The footnotes under the table: the convention, why a cell is blank, and where a short-dated rate is not to be trusted.
182
- const basisNotes = bases ? [BASIS_CONVENTION, blankBasisNote(data.contracts, bases), shortDatedBasisNote(data.contracts, bases)]
213
+ const basisNotes = bases ? [BASIS_CONVENTION, blankBasisNote(data.contracts, bases, curveCache(data, now)), shortDatedBasisNote(data.contracts, bases)]
183
214
  .filter((note): note is string => !!note) : [];
184
215
  // A blank Change says why, as a blank basis does; a past curve has no session change to blank.
185
216
  const changeNote = date ? null : noTradeChangeNote(data.contracts, data);
186
217
  const thinSpread = thinSpreadNotice(data);
187
- const notes = [...thinSpread ? [`${thinSpread}.`] : [], ...changeNote ? [changeNote] : [], ...basisNotes,
218
+ const skipped = skippedSpreadNotice(data);
219
+ const notes = [...thinSpread ? [`${thinSpread}.`] : [], ...skipped ? [`${skipped}.`] : [], ...changeNote ? [changeNote] : [], ...basisNotes,
188
220
  ...spotPremium?.reason ? [`Front premium blank: ${spotPremium.reason}.`] : []];
189
221
  const columnOptions = { basis: !!bases, last: data.source !== "cboe", notice: data.contracts.some((row) => row.firstNotice) };
190
222
  // Dated by the contracts' own quotes; the same-contract history rows are a year of context, not observations.
@@ -193,19 +225,28 @@ export const futuresCurveHeadless: HeadlessPaneDefinition<"bundle"> = {
193
225
  ? { status: "not-a-feed", basis: "settlement archive", asOf: date }
194
226
  : { ...(data.source === "cboe" ? { source: "Cboe", status: "not-a-feed", basis: "daily settlement", cadence: "daily" } as const : {}),
195
227
  asOf: newestReportTime(quoted), oldest: oldestReportTime(quoted) };
228
+ // No contract to list is no curve: the report says why once and fails, as `help fn` says an empty one does.
229
+ if (!data.contracts.length) {
230
+ return { freshness, sections: [], empty: `No ${root} contracts from the source.`, errors: data.gaps,
231
+ metadata: { ...data, quoteUnit: unit, complete: false, ...(args.argument ? {} : { defaultArgument: DEFAULT_ROOT }) } };
232
+ }
233
+ const spreadRow = { label: curveSpreadLabel(data.slope), ...data.slope, value: curveRoundedPrice(data.slope.value, root),
234
+ annualizedRollYield: data.slope.annualizedRollYield == null ? null : Number(data.slope.annualizedRollYield.toFixed(2)),
235
+ percentile: rank(data.slope.percentile), rollPercentile: rank(data.slope.rollPercentile), [SKIPPED_FIELD]: data.slope.skippedSymbols ?? [] };
236
+ const spreadFormats = { ...ROLL_YIELD_FORMAT, ...thirtySecondsFormat(root, "value") };
196
237
  return {
197
238
  freshness,
198
239
  sections: [
199
240
  { title: "Contracts", columns: contractColumns(root, data.settlementDate ?? null, columnOptions),
200
- ...bases ? { textColumns: contractColumns(root, data.settlementDate ?? null, { ...columnOptions, text: true }) } : {},
241
+ textColumns: contractColumns(root, data.settlementDate ?? null, { ...columnOptions, text: true }),
242
+ ...unit ? { unit } : {},
201
243
  rows: data.contracts.map((row) => contractRow(row, data, root, !!date, bases?.get(row.symbol))) },
202
- { title: "Front spread", columns: fieldColumns(FRONT_SPREAD_FIELDS, data.slope, { ...ROLL_YIELD_FORMAT, ...thirtySecondsFormat(root, "value") }), rows: [{ label: curveSpreadLabel(data.slope), ...data.slope, value: curveRoundedPrice(data.slope.value, root),
203
- annualizedRollYield: data.slope.annualizedRollYield == null ? null : Number(data.slope.annualizedRollYield.toFixed(2)),
204
- percentile: rank(data.slope.percentile), rollPercentile: rank(data.slope.rollPercentile) }] },
244
+ { title: "Front spread", columns: spreadColumns(spreadRow, spreadFormats, false), textColumns: spreadColumns(spreadRow, spreadFormats, true),
245
+ rows: [spreadRow] },
205
246
  ...spotPremium ? [{ title: "Front vs spot", entries: spotPremiumEntries(spotPremium, root) }] : [],
206
247
  ...terms.length ? [{ title: "Contract terms", entries: terms }] : [],
207
248
  ...data.ghosts.map((ghost) => ({ title: `${ghost.label} same-contract history`, columns: fieldColumns(GHOST_FIELDS, ghost.points[0] ?? {}, thirtySecondsFormat(root, "price")),
208
- rows: ghost.points.map((point) => ({ ...point })) })),
249
+ ...unit ? { unit } : {}, rows: ghost.points.map((point) => ({ ...point })) })),
209
250
  ],
210
251
  errors: data.gaps,
211
252
  ...(notes.length ? { notes } : {}),
@@ -10,7 +10,7 @@ import { formatPercentileRank } from "../../../utils/format";
10
10
  import { formatThirtySeconds } from "../../../market-data/market/format";
11
11
  import { cryptoPairCoin, isFuturesSymbol } from "../shared/crypto-pair";
12
12
  import { parseReportTime } from "../../../utils/utc-time";
13
- import { zonedWallClockToUtcMs } from "../../../utils/zoned-date-time";
13
+ import { zonedDateKey, zonedWallClockToUtcMs } from "../../../utils/zoned-date-time";
14
14
  import { dateOptionError, dateOptionFormatsOr, readCalendarDate } from "../../../utils/calendar-date";
15
15
  import { compareSortValues, type SortDirection } from "../../../utils/sort-values";
16
16
 
@@ -186,6 +186,24 @@ function thinSpreadReason(data: Pick<FuturesCurvePayload, "slope" | "contracts">
186
186
  return leg.asOf ? `${code} last traded ${leg.asOf.slice(0, 10)}` : `${code} has not traded`;
187
187
  }
188
188
 
189
+ /**
190
+ * The months the front spread passed over for the next one a roll goes to,
191
+ * with the open interest each holds: "Front spread pairs GCZ26 with GCG27
192
+ * (77,624 open interest), skipping GCF27 (799)". Null when it skipped none.
193
+ */
194
+ export function skippedSpreadNotice(data: Pick<FuturesCurvePayload, "slope" | "contracts">): string | null {
195
+ const skipped = data.slope.skippedSymbols ?? [];
196
+ if (!skipped.length || !data.slope.frontSymbol || !data.slope.nextSymbol) return null;
197
+ const held = (symbol: string) => {
198
+ const interest = data.contracts.find((row) => row.symbol === symbol)?.openInterest;
199
+ return interest == null ? "" : interest.toLocaleString("en-US");
200
+ };
201
+ const next = held(data.slope.nextSymbol);
202
+ const months = skipped.map((symbol) => `${curveContractCode(symbol)}${held(symbol) ? ` (${held(symbol)})` : ""}`).join(", ");
203
+ return `Front spread pairs ${curveContractCode(data.slope.frontSymbol)} with ${curveContractCode(data.slope.nextSymbol)}`
204
+ + `${next ? ` (${next} open interest)` : ""}, skipping ${months}`;
205
+ }
206
+
189
207
  /** The warning a thin front spread carries: why, and that its sign is no slope call. */
190
208
  export function thinSpreadNotice(data: Pick<FuturesCurvePayload, "slope" | "contracts">): string | null {
191
209
  const reason = thinSpreadReason(data);
@@ -270,13 +288,21 @@ function charted<T extends { expiration: string }>(rows: readonly T[], horizon:
270
288
  return rows.filter((row) => Date.parse(row.expiration) <= end.getTime());
271
289
  }
272
290
 
273
- export function futuresCurveSeries(data: FuturesCurvePayload, palette?: CurvePalette, horizon = DEFAULT_CURVE_HORIZON, now = Date.now(),
291
+ export function futuresCurveSeries(data: FuturesCurvePayload, palette?: CurvePalette & { settle?: string }, horizon = DEFAULT_CURVE_HORIZON, now = Date.now(),
274
292
  currentLabel = data.source === "cboe" ? "Settlement" : "Latest"): CurveSeries[] {
275
293
  const contracts = charted(data.contracts, horizon, now);
294
+ const point = (row: FuturesContract) => ({ id: row.symbol, label: curveContractMonth(row.symbol, row.expiration), x: Date.parse(row.expiration),
295
+ value: curveShownPrice(row, data), asOf: curveSettleShown(row, data) ?? row.asOf });
296
+ // The months shown at a settlement beside months that traded since are marked on the line, which keeps their
297
+ // values for the cursor and the readout. A curve of settlements alone (a past date, a weekend) has nothing to tell apart.
298
+ const shownAtSettle = contracts.filter((row) => curveSettleShown(row, data));
299
+ const settled = shownAtSettle.length < contracts.length ? shownAtSettle : [];
276
300
  return [{
277
301
  id: "current", label: currentLabel, asOf: newestQuote(contracts), color: palette?.current,
278
- points: contracts.map((row) => ({ id: row.symbol, label: curveContractMonth(row.symbol, row.expiration), x: Date.parse(row.expiration), value: row.price, asOf: row.asOf })),
279
- }, ...data.ghosts.map((ghost) => {
302
+ points: contracts.map(point),
303
+ }, ...settled.length ? [{ id: "settle", label: `Settle ${data.settlementDate!.slice(5)}, no trade since`, role: "marker" as const,
304
+ color: palette?.settle, points: settled.map(point) }] : [],
305
+ ...data.ghosts.map((ghost) => {
280
306
  // The payload dates a ghost by its oldest point, which can be a contract beyond the charted horizon.
281
307
  const points = charted(ghost.points, horizon, now);
282
308
  const asOf = newestQuote(points);
@@ -292,15 +318,17 @@ export type CurveContractChanges = ReadonlyMap<string, Readonly<Record<CurveLook
292
318
 
293
319
  /**
294
320
  * How far each contract moved since the week- and month-back curves, by
295
- * symbol: the latest price less the price then. A leg missing either side
296
- * stays null rather than reading as no move.
321
+ * symbol: the price it is shown at less its close then, a settlement against
322
+ * a settlement for a month with no trade since (curveShownPrice). A leg
323
+ * missing either side stays null rather than reading as no move.
297
324
  */
298
325
  export function curveContractChanges(data: FuturesCurvePayload): CurveContractChanges {
299
326
  const past = new Map(data.ghosts.map((ghost) => [ghost.label, new Map(ghost.points.map((point) => [point.symbol, point.price]))]));
300
327
  return new Map(data.contracts.map((row) => {
328
+ const shown = curveShownPrice(row, data);
301
329
  const change = (label: CurveLookback) => {
302
330
  const then = past.get(label)?.get(row.symbol);
303
- return row.price == null || then == null ? null : row.price - then;
331
+ return shown == null || then == null ? null : shown - then;
304
332
  };
305
333
  return [row.symbol, { "1W": change("1W"), "1M": change("1M") }];
306
334
  }));
@@ -418,6 +446,24 @@ export interface SpotBar {
418
446
  price: number;
419
447
  }
420
448
 
449
+ /**
450
+ * The spot bars a basis is read from: the pair's one-minute bars as the
451
+ * reader's history serves them, and the spot the server read for each
452
+ * contract's own print minute, which a delayed reader's bars do not reach
453
+ * yet (a front month prints ten minutes behind, delayed spot fifteen). The
454
+ * server's wins where both have a minute. Null while the reader's bars are
455
+ * unknown, so a blank is never explained before they answer.
456
+ */
457
+ export function curveSpotBars(bars: readonly SpotBar[] | null, contracts: readonly Pick<FuturesContract, "spot">[]): SpotBar[] | null {
458
+ if (!bars) return null;
459
+ const byMinute = new Map(bars.map((bar) => [bar.minute, bar.price]));
460
+ for (const { spot } of contracts) {
461
+ const time = spot ? Date.parse(spot.minute) : Number.NaN;
462
+ if (spot && Number.isFinite(time) && positive(spot.price)) byMinute.set(minuteOf(time), spot.price);
463
+ }
464
+ return [...byMinute].sort((a, b) => a[0] - b[0]).map(([minute, price]) => ({ minute, price }));
465
+ }
466
+
421
467
  /** One-minute bars as the spot by minute, oldest first; a bar with no usable time or close is left out. */
422
468
  export function spotBarsFromHistory(points: readonly { date: Date | string | number; close: number }[]): SpotBar[] {
423
469
  const byMinute = new Map<number, number>();
@@ -624,11 +670,35 @@ function pairTimes(print: number, spot: number): string {
624
670
  return printDate === spotDate ? `print ${printTime}, nearest spot ${spotTime} UTC` : `print ${printDate} ${printTime}, nearest spot ${spotDate} ${spotTime} UTC`;
625
671
  }
626
672
 
673
+ /**
674
+ * A curve the server served from a copy it kept, because its source failed:
675
+ * when that copy was read, and the clock its age is measured against.
676
+ */
677
+ export interface CurveCache {
678
+ fetchedAt: string;
679
+ now: number;
680
+ }
681
+
682
+ /** The cache a curve was served from, when the server says it was; null for a curve read now. */
683
+ export function curveCache(data: Pick<FuturesCurvePayload, "cached" | "fetchedAt">, now: number): CurveCache | null {
684
+ return data.cached === true && Number.isFinite(Date.parse(data.fetchedAt)) ? { fetchedAt: data.fetchedAt, now } : null;
685
+ }
686
+
687
+ /** `cached curve read 21:55 UTC, 9 h old`, with the date when the copy is not from the clock's day. */
688
+ function cachedCurveReason(cache: CurveCache): string {
689
+ const read = Date.parse(cache.fetchedAt);
690
+ const stamp = curveTimestamp(new Date(read).toISOString());
691
+ const today = new Date(cache.now).toISOString().slice(0, 10);
692
+ const minutes = Math.max(0, Math.floor((cache.now - read) / MINUTE_MS));
693
+ return `cached curve read ${stamp.startsWith(today) ? stamp.slice(11) : stamp} UTC, ${gapText(minutes)} old`;
694
+ }
695
+
627
696
  /** Why one priced-or-not contract has no basis against known spot bars, in the order `contractBasis` decides it. */
628
- function blankReason(row: Pick<FuturesContract, "price" | "stale">, basis: ContractBasis): string | null {
697
+ function blankReason(row: Pick<FuturesContract, "price" | "stale">, basis: ContractBasis, cache: CurveCache | null): string | null {
629
698
  if (basis.vsSpotPct != null) return null;
630
699
  if (!positive(row.price)) return "no price";
631
- if (row.stale) return "price over two sessions old";
700
+ // A cached copy marks every contract stale for being a copy, not for its prices' age.
701
+ if (row.stale) return cache ? cachedCurveReason(cache) : "price over two sessions old";
632
702
  const unpaired = basis.unpaired;
633
703
  if (!unpaired) return null;
634
704
  if (unpaired.print == null) return "last trade has no time of day";
@@ -641,11 +711,12 @@ function blankReason(row: Pick<FuturesContract, "price" | "stale">, basis: Contr
641
711
  * The contracts whose basis cells are blank against known spot bars, grouped by cause and named, so a blank is
642
712
  * never unexplained: the far months of a curve print rarely, and a trade no spot bar shares a minute with is not read.
643
713
  */
644
- export function blankBasisNote(rows: readonly Pick<FuturesContract, "symbol" | "price" | "stale">[], basis: CurveBasisRows): string | null {
714
+ export function blankBasisNote(rows: readonly Pick<FuturesContract, "symbol" | "price" | "stale">[], basis: CurveBasisRows,
715
+ cache: CurveCache | null = null): string | null {
645
716
  const groups = new Map<string, string[]>();
646
717
  for (const row of rows) {
647
718
  const cell = basis.get(row.symbol);
648
- const reason = cell ? blankReason(row, cell) : null;
719
+ const reason = cell ? blankReason(row, cell, cache) : null;
649
720
  if (reason) groups.set(reason, [...groups.get(reason) ?? [], curveContractCode(row.symbol)]);
650
721
  }
651
722
  return groups.size ? `Basis blank for ${[...groups].map(([reason, codes]) => `${codes.join(", ")} (${reason})`).join("; ")}.` : null;
@@ -733,14 +804,19 @@ export function withTradedExpirations(data: FuturesCurvePayload): FuturesCurvePa
733
804
  };
734
805
  }
735
806
 
807
+ /** From 18:00 New York a print belongs to the next trade date: six hours later it is that date there. */
808
+ const NEXT_SESSION_SHIFT_MS = 6 * 3_600_000;
809
+
736
810
  /**
737
811
  * The trading date a print belongs to, as the server dates sessions: CME's
738
- * session for a date opens at 18:00 New York the evening before (22:00 or
739
- * 23:00 UTC), so a two-hour shift puts those evening trades on the next date
740
- * and leaves day-only venues as they are. A settlement's date is its session.
812
+ * session for a date opens at 18:00 New York the evening before, so a print
813
+ * from then on is the next date's, read on New York's clock. The session's
814
+ * close at 17:00 New York (22:00 UTC in winter, when a two-hour shift of UTC
815
+ * carried it into the next date) stays on its own date, and day-only venues
816
+ * are as they are. A settlement's date is its session.
741
817
  */
742
818
  function curveSessionDate(asOf: string): string {
743
- return asOf.length === 10 ? asOf : new Date(Date.parse(asOf) + 2 * 3_600_000).toISOString().slice(0, 10);
819
+ return asOf.length === 10 ? asOf : zonedDateKey(Date.parse(asOf) + NEXT_SESSION_SHIFT_MS, "America/New_York");
744
820
  }
745
821
 
746
822
  /**
@@ -756,6 +832,26 @@ export function curveNoTradeSince(row: Pick<FuturesContract, "price" | "settleme
756
832
  return curveSessionDate(row.asOf) <= session ? session : null;
757
833
  }
758
834
 
835
+ /**
836
+ * The session whose settlement a live contract is shown at: it has no trade
837
+ * since that settlement (curveNoTradeSince), or no last trade at all, as in a
838
+ * session that has just opened. Its row, its point on the curve and its 1W
839
+ * and 1M moves read the settlement, so a month with no trade today is never
840
+ * read as an old print beside months that traded. Null for a contract shown
841
+ * at its last trade, and on a Cboe curve, whose prices are settlements.
842
+ */
843
+ export function curveSettleShown(row: Pick<FuturesContract, "price" | "settlement" | "asOf">,
844
+ data: Pick<FuturesCurvePayload, "source" | "settlementDate">): string | null {
845
+ if (data.source === "cboe" || !data.settlementDate || row.settlement == null) return null;
846
+ return row.price == null ? data.settlementDate : curveNoTradeSince(row, data);
847
+ }
848
+
849
+ /** The price a live contract is plotted and measured at: its settlement when it has not traded since (curveSettleShown), else its last trade. */
850
+ function curveShownPrice(row: Pick<FuturesContract, "price" | "settlement" | "asOf">,
851
+ data: Pick<FuturesCurvePayload, "source" | "settlementDate">): number | null {
852
+ return curveSettleShown(row, data) ? row.settlement ?? null : row.price;
853
+ }
854
+
759
855
  /**
760
856
  * The live curve with every Change on the basis its table states: the last
761
857
  * trade less the settlement in the Settle column. The source's session change
@@ -17,7 +17,7 @@ import { futuresSessionRefreshInterval } from "../shared/futures-session";
17
17
  import { useResearchCloudSession } from "../shared/research-cloud-session";
18
18
  import { useQuoteBoard } from "../shared/use-quote-board";
19
19
  import { getCachedFuturesCurve, loadCurveSpotBars, loadCurveSpotCloses, loadFuturesCurve, loadFuturesCurveAsOf } from "./client";
20
- import { BASIS_CONVENTION, basisSpotSymbol, blankBasisNote, curveAsOfDate, curveAxisGrid, curveAxisPrice, curveBasisPercent, curveBasisRows, curveChangeText, curveContractChanges, curveContractCode, curvePrice, curveRank, curveSpot, curveSpotLabel, curveSpotPremium, curveSpotSource, curveSpreadBasis, curveSpreadLabel, curveTimestamp, curveTitle, curveUnitLabel, DEFAULT_CURVE_HORIZON, futuresCurveSeries, newestQuote, noTradeChangeNote, normalizeCurveRoot, paneCurveRoot, shortDatedBasis, shortDatedBasisNote, sortCurveContracts, spotIndexSymbol, thinSpreadNotice, unsupportedCurveRootMessage, type CurveContractChanges, type CurveSpot } from "./model";
20
+ import { BASIS_CONVENTION, basisSpotSymbol, blankBasisNote, curveAsOfDate, curveAxisGrid, curveAxisPrice, curveBasisPercent, curveBasisRows, curveCache, curveChangeText, curveContractChanges, curveContractCode, curvePrice, curveRank, curveSettleShown, curveSpot, curveSpotBars, curveSpotLabel, curveSpotPremium, curveSpotSource, curveSpreadBasis, curveSpreadLabel, curveTimestamp, curveTitle, curveUnitLabel, DEFAULT_CURVE_HORIZON, futuresCurveSeries, newestQuote, noTradeChangeNote, normalizeCurveRoot, paneCurveRoot, shortDatedBasis, shortDatedBasisNote, skippedSpreadNotice, sortCurveContracts, spotIndexSymbol, thinSpreadNotice, unsupportedCurveRootMessage, type CurveContractChanges, type CurveSpot } from "./model";
21
21
 
22
22
  const TABS = [{ value: "curve", label: "Curve" }, { value: "contracts", label: "Contracts" }];
23
23
  // One column order for every root. SETTLE is the exchange settlement for the
@@ -152,12 +152,13 @@ function FuturesCurveView({ width, height, focused, root, ownsTitle }: PaneProps
152
152
  const staleCount = data?.contracts.filter((row) => row.stale).length ?? 0;
153
153
  const newest = data ? newestQuote(data.contracts) : null;
154
154
  // A past curve is named by the session it holds: a weekend or holiday date shows the session before it.
155
- const curves = useMemo(() => data ? futuresCurveSeries(data, { current: colors.positive, ghosts: curveGhostColors(colors) }, horizon,
155
+ const curves = useMemo(() => data ? futuresCurveSeries(data, { current: colors.positive, settle: colors.text, ghosts: curveGhostColors(colors) }, horizon,
156
156
  requestedDate ? Date.parse(`${requestedDate}T00:00:00Z`) : Date.now(), requestedDate ? data.asOf ?? requestedDate : undefined) : [],
157
157
  [data, colors, horizon, requestedDate]);
158
158
  const changes = useMemo<CurveContractChanges>(() => data ? curveContractChanges(data) : new Map(), [data]);
159
159
  // Until the bars first answer there is nothing to say: no reason, only blank cells.
160
- const bars = basisActive ? spotBars.data : null;
160
+ // The server's spot in each print's own minute fills what the bars a delayed reader gets do not reach yet.
161
+ const bars = useMemo(() => basisActive ? curveSpotBars(spotBars.data ?? null, data?.contracts ?? []) : null, [basisActive, spotBars.data, data]);
161
162
  const basis = useMemo(() => curveBasisRows(basisActive ? data?.contracts ?? [] : [], bars), [basisActive, bars, data]);
162
163
  const rows = useMemo(() => sortCurveContracts(data?.contracts ?? [], sort.columnId, sort.direction, changes, basis), [data, sort, changes, basis]);
163
164
  // The curve tab lists the contracts the chart plots; Contracts keeps every one.
@@ -177,6 +178,7 @@ function FuturesCurveView({ width, height, focused, root, ownsTitle }: PaneProps
177
178
  const thin = data?.slope.state === "thin";
178
179
  const spreadRank = data && !thin ? curveRank(data.slope.percentile, data.slope.samples) : null;
179
180
  const thinSpread = data ? thinSpreadNotice(data) : null;
181
+ const skippedSpread = data ? skippedSpreadNotice(data) : null;
180
182
  // Until the closes first answer there is nothing to say.
181
183
  const spotPremium = useMemo(() => data && indexSymbol && spotCloses.data ? curveSpotPremium(data, spotCloses.data) : null,
182
184
  [data, indexSymbol, spotCloses.data]);
@@ -250,7 +252,7 @@ function FuturesCurveView({ width, height, focused, root, ownsTitle }: PaneProps
250
252
  // A past date with no archived curve says why in the body, not behind the warning.
251
253
  const emptyPast = !!requestedDate && !!data && !data.contracts.length;
252
254
  // The basis notes the report prints under its table: the convention, why a cell is blank, and which rates spot noise swamps.
253
- const basisNotes = basisActive && bars ? [BASIS_CONVENTION, blankBasisNote(tableRows, basis), shortDatedBasisNote(tableRows, basis)]
255
+ const basisNotes = basisActive && bars ? [BASIS_CONVENTION, blankBasisNote(tableRows, basis, data ? curveCache(data, clock) : null), shortDatedBasisNote(tableRows, basis)]
254
256
  .filter((note): note is string => !!note) : [];
255
257
  // A long in these can be assigned delivery: the hedge a trader rolls before first notice.
256
258
  const delivering = data?.contracts.filter((row) => row.inDelivery).map((row) => curveContractCode(row.symbol)) ?? [];
@@ -258,7 +260,7 @@ function FuturesCurveView({ width, height, focused, root, ownsTitle }: PaneProps
258
260
  const untraded = data && !requestedDate && columns.some((entry) => entry.id === "change")
259
261
  ? noTradeChangeNote(tableRows, data, { count: true }) : null;
260
262
  usePaneNoticeFooter({ registrationId: "futures-curve:notices", focused,
261
- notices: emptyPast ? [] : [...data?.gaps ?? [], ...thinSpread ? [thinSpread] : [], ...basisNotes, ...untraded ? [untraded] : [],
263
+ notices: emptyPast ? [] : [...data?.gaps ?? [], ...thinSpread ? [thinSpread] : [], ...skippedSpread ? [skippedSpread] : [], ...basisNotes, ...untraded ? [untraded] : [],
262
264
  ...delivering.length ? [`${delivering.join(", ")} ${delivering.length === 1 ? "is" : "are"} past first notice.`] : []] });
263
265
  const delay = Math.max(0, ...(data?.contracts.map((row) => row.delayMinutes ?? 0) ?? []));
264
266
  usePaneStatusFooter({ registrationId: "futures-curve", loading: resource.loading, error: resource.error,
@@ -313,8 +315,11 @@ function FuturesCurveView({ width, height, focused, root, ownsTitle }: PaneProps
313
315
  if (column.id === "percentile") return { text: row.samples < 2 || row.percentile == null ? "--" : row.percentile.toFixed(0) };
314
316
  if (column.id === "oi") return { text: integer(row.openInterest) };
315
317
  if (column.id === "volume") return { text: integer(row.volume) };
318
+ // A month with no trade since the settlement it shows is dated by that settlement, as the curve marks it.
319
+ const settled = data && !requestedDate ? curveSettleShown(row, data) : null;
320
+ if (settled) return { text: `settle ${settled}`, color: colors.textMuted };
316
321
  return { text: curveTimestamp(row.asOf), color: row.stale ? colors.warning : colors.textMuted };
317
- }, [basis, changes, colors, curveTab, requestedDate, root]);
322
+ }, [basis, changes, colors, curveTab, data, requestedDate, root]);
318
323
  return <Box width={width} height={height} flexDirection="column">
319
324
  {tabStrip}
320
325
  <QueryBar width={width} filters={[{