gloomberb 0.20.7 → 0.20.9

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 (632) hide show
  1. package/README.ja.md +74 -0
  2. package/README.md +2 -0
  3. package/README.zh-CN.md +2 -0
  4. package/package.json +6 -1
  5. package/src/account/auth-model.ts +22 -0
  6. package/src/api-client/auth.ts +7 -2
  7. package/src/api-client/awards.ts +5 -0
  8. package/src/api-client/bond-trades.ts +22 -0
  9. package/src/api-client/catalysts.ts +11 -1
  10. package/src/api-client/data.ts +30 -6
  11. package/src/api-client/debt-maturities.ts +7 -0
  12. package/src/api-client/equity-screener.ts +17 -0
  13. package/src/api-client/errors.ts +2 -0
  14. package/src/api-client/exchange-announcements.ts +14 -7
  15. package/src/api-client/fund-facts.ts +21 -3
  16. package/src/api-client/futures-curve.ts +19 -2
  17. package/src/api-client/geo.ts +10 -0
  18. package/src/api-client/hiring.ts +2 -0
  19. package/src/api-client/index.ts +3 -0
  20. package/src/api-client/insider-signals.ts +14 -0
  21. package/src/api-client/members.ts +30 -2
  22. package/src/api-client/money-markets.ts +11 -1
  23. package/src/api-client/paths.ts +6 -1
  24. package/src/api-client/perps.ts +2 -0
  25. package/src/api-client/request.ts +2 -1
  26. package/src/api-client/socket.ts +7 -0
  27. package/src/api-client/types/econ.ts +2 -1
  28. package/src/api-client/types/filings-and-calls.ts +6 -0
  29. package/src/api-client/types/market.ts +4 -0
  30. package/src/api-client/web-experiments.ts +5 -6
  31. package/src/app/runtime/update.ts +2 -1
  32. package/src/architecture/floating-promise-allowlist.json +33 -106
  33. package/src/capabilities/asset-data-inputs.ts +183 -0
  34. package/src/capabilities/factories.ts +8 -2
  35. package/src/cli/base-converter.ts +36 -2
  36. package/src/cli/commands/api.ts +2 -2
  37. package/src/cli/commands/command-utils.ts +18 -0
  38. package/src/cli/commands/hong-kong-movers.ts +50 -0
  39. package/src/cli/commands/market.ts +539 -130
  40. package/src/cli/commands/options-chain.ts +7 -1
  41. package/src/cli/commands/overview.ts +76 -14
  42. package/src/cli/commands/plugins.ts +7 -6
  43. package/src/cli/commands/search.ts +52 -9
  44. package/src/cli/commands/system.ts +15 -10
  45. package/src/cli/commands/ticker.ts +97 -44
  46. package/src/cli/content-figures.ts +45 -0
  47. package/src/cli/context.ts +5 -0
  48. package/src/cli/desktop-pane-shot-routes.ts +13 -4
  49. package/src/cli/desktop-pane-shot.ts +86 -12
  50. package/src/cli/earnings-calendar.ts +36 -5
  51. package/src/cli/export-source.ts +17 -3
  52. package/src/cli/fx-pair.ts +111 -11
  53. package/src/cli/glossary.ts +36 -2
  54. package/src/cli/help.ts +1 -1
  55. package/src/cli/history-export.ts +29 -11
  56. package/src/cli/history-rows.ts +130 -21
  57. package/src/cli/index.ts +8 -5
  58. package/src/cli/known-gaps.ts +45 -1
  59. package/src/cli/listing-arg.ts +366 -19
  60. package/src/cli/pane-functions/capabilities.ts +2 -2
  61. package/src/cli/pane-functions/catalog.ts +105 -9
  62. package/src/cli/pane-functions/data.ts +3 -2
  63. package/src/cli/pane-functions/discovery.ts +2 -0
  64. package/src/cli/pane-functions/dom.ts +46 -9
  65. package/src/cli/pane-functions/freshness.ts +7 -3
  66. package/src/cli/pane-functions/function-help.ts +9 -6
  67. package/src/cli/pane-functions/headless.ts +78 -6
  68. package/src/cli/pane-functions/index.ts +141 -23
  69. package/src/cli/pane-functions/options.ts +1 -3
  70. package/src/cli/pane-functions/plugin-code.ts +169 -0
  71. package/src/cli/pane-functions/report.ts +10 -0
  72. package/src/cli/pane-functions/resolver.ts +69 -21
  73. package/src/cli/pane-functions/screenshot-assessment.ts +82 -3
  74. package/src/cli/pane-functions/screenshot-data-evidence.ts +3 -1
  75. package/src/cli/pane-functions/screenshot-types.ts +6 -0
  76. package/src/cli/quote-answer.ts +49 -2
  77. package/src/cli/registry.ts +42 -4
  78. package/src/cli/report-tables.ts +26 -6
  79. package/src/cli/result.ts +13 -2
  80. package/src/cli/series-search.ts +17 -7
  81. package/src/cli/statement-filings.ts +22 -8
  82. package/src/cli/symbol-args.ts +9 -0
  83. package/src/cli/symbol-cells.ts +6 -0
  84. package/src/cli/symbol-list.ts +14 -6
  85. package/src/cli/symbol-rows.ts +12 -5
  86. package/src/cli/ticker-resolution.ts +3 -2
  87. package/src/cli/unknown-command.ts +111 -14
  88. package/src/components/chart/composite/format.ts +15 -1
  89. package/src/components/chart/composite/legend.tsx +101 -47
  90. package/src/components/chart/composite/panel-labels.ts +4 -4
  91. package/src/components/chart/composite/panel-surface.tsx +4 -6
  92. package/src/components/chart/composite/scene/build.ts +180 -0
  93. package/src/components/chart/composite/scene/cursor.ts +226 -0
  94. package/src/components/chart/composite/scene/domain.ts +170 -0
  95. package/src/components/chart/composite/scene/markers.ts +115 -0
  96. package/src/components/chart/composite/scene/panels.ts +85 -0
  97. package/src/components/chart/composite/scene/points.ts +169 -0
  98. package/src/components/chart/composite/scene/projection.ts +105 -0
  99. package/src/components/chart/composite/scene/timeline.ts +71 -0
  100. package/src/components/chart/composite/scene.ts +12 -1066
  101. package/src/components/chart/composite/types.ts +4 -2
  102. package/src/components/chart/curve/model.ts +2 -2
  103. package/src/components/chart-table/axis.ts +18 -6
  104. package/src/components/command-bar/layout-items/focused-pane.ts +3 -0
  105. package/src/components/command-bar/list/model.ts +9 -0
  106. package/src/components/command-bar/pane-templates/items.ts +61 -15
  107. package/src/components/command-bar/pane-templates/workflow.ts +16 -5
  108. package/src/components/command-bar/routes/root/plugin-install.ts +7 -46
  109. package/src/components/command-bar/routes/root/provider-search.ts +8 -5
  110. package/src/components/command-bar/routes/root/results.ts +6 -1
  111. package/src/components/command-bar/routes/root/runtime.ts +1 -0
  112. package/src/components/command-bar/routes/root/shortcut-feedback.ts +4 -1
  113. package/src/components/command-bar/routes/ticker-search/actions.ts +7 -5
  114. package/src/components/command-bar/routes/ticker-search/results.ts +51 -3
  115. package/src/components/command-bar/view-model.ts +12 -0
  116. package/src/components/command-bar/workflow/ops.ts +21 -4
  117. package/src/components/command-bar/workflow/ticker-listing-picker.ts +3 -1
  118. package/src/components/command-bar/workflow/tickers.ts +6 -2
  119. package/src/components/data-table/view.tsx +46 -1
  120. package/src/components/form-modal/confirm.tsx +3 -2
  121. package/src/components/form-modal/content.tsx +3 -2
  122. package/src/components/form-modal/field-row.tsx +2 -0
  123. package/src/components/form-modal/host.tsx +18 -3
  124. package/src/components/form-modal/remote-reads.test-helpers.ts +34 -0
  125. package/src/components/index.ts +1 -1
  126. package/src/components/layout/pane/title.ts +21 -5
  127. package/src/components/layout/shell/pane/layers.tsx +20 -14
  128. package/src/components/layout/shell/pane-occlusion.ts +21 -0
  129. package/src/components/onboarding/desks-step.tsx +7 -1
  130. package/src/components/onboarding/onboarding-keyboard.ts +48 -6
  131. package/src/components/onboarding/onboarding-wizard.tsx +47 -8
  132. package/src/components/onboarding/portfolio-step/positions-panel.tsx +17 -3
  133. package/src/components/onboarding/use-onboarding-progress.ts +57 -14
  134. package/src/components/onboarding/wizard-positions.ts +2 -0
  135. package/src/components/paged-rows.ts +11 -5
  136. package/src/components/ticker/list-table-view.tsx +24 -5
  137. package/src/components/toggle-list.tsx +44 -1
  138. package/src/components/ui/data-table/opentui/index.tsx +7 -6
  139. package/src/components/ui/data-table/opentui/model.ts +7 -3
  140. package/src/components/ui/data-table/types.ts +13 -2
  141. package/src/components/ui/fields.tsx +16 -4
  142. package/src/components/ui/page-stack-view.tsx +24 -6
  143. package/src/components/ui/query-bar.tsx +43 -9
  144. package/src/components/ui/table-layout.ts +56 -2
  145. package/src/core/app-services.ts +7 -2
  146. package/src/core/connection-health.ts +26 -0
  147. package/src/core/state/app/layout.ts +12 -4
  148. package/src/data/config/layout.ts +3 -1
  149. package/src/data/config/store/node.ts +4 -2
  150. package/src/docs/snapshot.json +756 -216
  151. package/src/i18n/es.ts +4 -1
  152. package/src/i18n/ja.ts +4 -1
  153. package/src/i18n/ko.ts +4 -1
  154. package/src/i18n/zh-cn.ts +4 -1
  155. package/src/i18n/zh-tw.ts +4 -1
  156. package/src/layout/pane-follow.ts +1 -1
  157. package/src/layout/pane-manager/gridlock.ts +18 -5
  158. package/src/layout/pane-manager/index.ts +1 -0
  159. package/src/layout/pane-manager/transient.ts +56 -0
  160. package/src/layout-marketplace/gallery.tsx +2 -1
  161. package/src/layout-marketplace/model.ts +4 -10
  162. package/src/market-data/commodity-names.ts +24 -0
  163. package/src/market-data/connection-follow.ts +9 -7
  164. package/src/market-data/coordinator/auxiliary.ts +4 -3
  165. package/src/market-data/coordinator/entries.ts +22 -1
  166. package/src/market-data/coordinator/financials.ts +2 -3
  167. package/src/market-data/coordinator/index.ts +67 -12
  168. package/src/market-data/coordinator/quotes.ts +2 -3
  169. package/src/market-data/fund-facts.ts +7 -1
  170. package/src/market-data/futures-board.ts +38 -4
  171. package/src/market-data/futures-contract.ts +5 -2
  172. package/src/market-data/futures-roll-returns.ts +226 -0
  173. package/src/market-data/fx-closes.ts +4 -1
  174. package/src/market-data/market/bar-period.ts +15 -0
  175. package/src/market-data/market/format.ts +4 -2
  176. package/src/market-data/market/freshness.ts +4 -0
  177. package/src/market-data/market/session-close-note.ts +41 -4
  178. package/src/market-data/market/status.ts +23 -3
  179. package/src/market-data/options-alternatives.ts +21 -9
  180. package/src/market-data/published-futures-sessions.ts +9 -0
  181. package/src/market-data/quotes/balance-sheet-rate.ts +34 -0
  182. package/src/market-data/quotes/delisting.ts +26 -2
  183. package/src/market-data/quotes/freshness.ts +62 -0
  184. package/src/market-data/quotes/listing-enterprise-value.ts +254 -19
  185. package/src/market-data/quotes/regular-session-valuation.ts +8 -0
  186. package/src/market-data/realized-volatility.ts +3 -1
  187. package/src/market-data/request-types.ts +2 -0
  188. package/src/market-data/selectors.ts +1 -0
  189. package/src/news/aggregator.ts +3 -3
  190. package/src/plugins/builtin/account-management/delete-account.ts +78 -0
  191. package/src/plugins/builtin/account-management/pane.tsx +22 -19
  192. package/src/plugins/builtin/account-management/password-dialog.tsx +75 -0
  193. package/src/plugins/builtin/alerts/alert-log.ts +3 -2
  194. package/src/plugins/builtin/alerts/cli-forms.ts +1 -1
  195. package/src/plugins/builtin/alerts/cli.ts +72 -4
  196. package/src/plugins/builtin/alerts/format.ts +8 -2
  197. package/src/plugins/builtin/alerts/index.tsx +8 -5
  198. package/src/plugins/builtin/alerts/pane.tsx +5 -3
  199. package/src/plugins/builtin/alerts/research-builder.ts +12 -0
  200. package/src/plugins/builtin/analytics/index.tsx +3 -3
  201. package/src/plugins/builtin/analytics/risk-client.ts +14 -3
  202. package/src/plugins/builtin/analytics/risk-pane.tsx +3 -3
  203. package/src/plugins/builtin/attention/pane.tsx +1 -1
  204. package/src/plugins/builtin/attention/trending.tsx +1 -1
  205. package/src/plugins/builtin/awards/detail.tsx +4 -1
  206. package/src/plugins/builtin/awards/headless.ts +7 -3
  207. package/src/plugins/builtin/awards/model.ts +11 -0
  208. package/src/plugins/builtin/awards/pane.tsx +12 -5
  209. package/src/plugins/builtin/backtest/client.ts +16 -4
  210. package/src/plugins/builtin/backtest/headless.ts +2 -1
  211. package/src/plugins/builtin/backtest/pane.tsx +5 -3
  212. package/src/plugins/builtin/backtest/report.ts +22 -6
  213. package/src/plugins/builtin/backtest/window.ts +17 -9
  214. package/src/plugins/builtin/bond-calculator/pane.tsx +1 -1
  215. package/src/plugins/builtin/broker-manager/sign-in-end.ts +1 -1
  216. package/src/plugins/builtin/broker-trading/orders.tsx +2 -2
  217. package/src/plugins/builtin/buildout/company/pane.tsx +1 -1
  218. package/src/plugins/builtin/buildout/model/index.ts +2 -2
  219. package/src/plugins/builtin/catalysts/headless.ts +9 -6
  220. package/src/plugins/builtin/catalysts/model.ts +72 -10
  221. package/src/plugins/builtin/catalysts/pane.tsx +10 -7
  222. package/src/plugins/builtin/cds/pane.tsx +5 -3
  223. package/src/plugins/builtin/central-bank-rates/pane.tsx +3 -2
  224. package/src/plugins/builtin/chart-composer/catalog-series.ts +59 -0
  225. package/src/plugins/builtin/chart-composer/headless-schema.ts +2 -1
  226. package/src/plugins/builtin/chart-composer/headless.ts +104 -23
  227. package/src/plugins/builtin/chart-composer/index.tsx +6 -3
  228. package/src/plugins/builtin/chart-composer/legend-names.ts +19 -0
  229. package/src/plugins/builtin/chart-composer/pane.tsx +37 -10
  230. package/src/plugins/builtin/chart-composer/presets.ts +63 -6
  231. package/src/plugins/builtin/chart-composer/roll-events.ts +38 -0
  232. package/src/plugins/builtin/chart-composer/series-catalog.ts +12 -5
  233. package/src/plugins/builtin/chart-composer/series-expression.ts +8 -4
  234. package/src/plugins/builtin/chart-composer/series-listings.ts +33 -9
  235. package/src/plugins/builtin/chart-composer/use-series-catalog.ts +2 -2
  236. package/src/plugins/builtin/clinical-trials/client.ts +13 -0
  237. package/src/plugins/builtin/clinical-trials/index.tsx +1 -1
  238. package/src/plugins/builtin/clinical-trials/pane.tsx +77 -27
  239. package/src/plugins/builtin/clinical-trials/search.ts +117 -0
  240. package/src/plugins/builtin/cloud/askg/conversation-store.ts +17 -6
  241. package/src/plugins/builtin/cloud/askg/lock-note.ts +4 -2
  242. package/src/plugins/builtin/cloud/askg/manifest.ts +3 -2
  243. package/src/plugins/builtin/cloud/askg/pane.tsx +2 -2
  244. package/src/plugins/builtin/cloud/askg/sources.ts +3 -3
  245. package/src/plugins/builtin/cloud/one-tap/one-tap-prompt.tsx +7 -3
  246. package/src/plugins/builtin/cloud/team/acm-tab.tsx +1 -1
  247. package/src/plugins/builtin/cloud/team/pane.tsx +17 -10
  248. package/src/plugins/builtin/cloud/team/views.ts +15 -3
  249. package/src/plugins/builtin/cloud/terminal-relay/redact.ts +105 -16
  250. package/src/plugins/builtin/cloud/thesis/board-pane.tsx +17 -2
  251. package/src/plugins/builtin/cloud/thesis/module.tsx +3 -2
  252. package/src/plugins/builtin/cloud/thesis/store.ts +17 -3
  253. package/src/plugins/builtin/commodities-energy/index.tsx +35 -3
  254. package/src/plugins/builtin/commodity-balances/index.tsx +1 -1
  255. package/src/plugins/builtin/company-attention/app-rank.tsx +1 -1
  256. package/src/plugins/builtin/company-attention/building.tsx +1 -1
  257. package/src/plugins/builtin/company-attention/model.ts +2 -1
  258. package/src/plugins/builtin/company-attention/moves.tsx +1 -1
  259. package/src/plugins/builtin/company-attention/pane.tsx +1 -1
  260. package/src/plugins/builtin/company-attention/signals.tsx +1 -1
  261. package/src/plugins/builtin/company-kpis/pane.tsx +1 -1
  262. package/src/plugins/builtin/correlation/headless.ts +13 -7
  263. package/src/plugins/builtin/correlation/history.ts +17 -6
  264. package/src/plugins/builtin/correlation/index.tsx +8 -4
  265. package/src/plugins/builtin/correlation/matrix/model.ts +15 -1
  266. package/src/plugins/builtin/correlation/relationship/history.ts +1 -1
  267. package/src/plugins/builtin/correlation/relationship/model.ts +15 -1
  268. package/src/plugins/builtin/correlation/relationship/pane.tsx +5 -3
  269. package/src/plugins/builtin/cot/headless.ts +10 -3
  270. package/src/plugins/builtin/cot/pane.tsx +2 -2
  271. package/src/plugins/builtin/cpi/pane.tsx +1 -1
  272. package/src/plugins/builtin/credit-boards/model.ts +1 -1
  273. package/src/plugins/builtin/credit-documents/pane.tsx +1 -1
  274. package/src/plugins/builtin/crypto-board/defi-view.tsx +2 -2
  275. package/src/plugins/builtin/crypto-board/defi.ts +9 -3
  276. package/src/plugins/builtin/crypto-board/headless.ts +19 -10
  277. package/src/plugins/builtin/crypto-board/model.ts +8 -0
  278. package/src/plugins/builtin/crypto-board/pane.tsx +11 -5
  279. package/src/plugins/builtin/crypto-board/series.ts +17 -3
  280. package/src/plugins/builtin/crypto-board/supply.ts +26 -3
  281. package/src/plugins/builtin/crypto-etf-flows/headless.ts +3 -2
  282. package/src/plugins/builtin/crypto-etf-flows/model.ts +13 -3
  283. package/src/plugins/builtin/crypto-etf-flows/pane.tsx +6 -3
  284. package/src/plugins/builtin/custom-view/pane.tsx +5 -5
  285. package/src/plugins/builtin/debt-maturities/client.ts +5 -0
  286. package/src/plugins/builtin/debt-maturities/headless.ts +3 -1
  287. package/src/plugins/builtin/debt-maturities/model.ts +1 -0
  288. package/src/plugins/builtin/debt-maturities/pane.tsx +1 -1
  289. package/src/plugins/builtin/dividend-yield/pane.tsx +1 -1
  290. package/src/plugins/builtin/doe/model.ts +1 -1
  291. package/src/plugins/builtin/doe/pane.tsx +1 -1
  292. package/src/plugins/builtin/earnings/board.tsx +2 -2
  293. package/src/plugins/builtin/earnings/history.tsx +1 -1
  294. package/src/plugins/builtin/earnings-calls/calendar.tsx +1 -1
  295. package/src/plugins/builtin/earnings-calls/data.ts +2 -1
  296. package/src/plugins/builtin/earnings-calls/headless.ts +15 -0
  297. package/src/plugins/builtin/earnings-calls/model.ts +68 -8
  298. package/src/plugins/builtin/earnings-calls/pane.tsx +29 -8
  299. package/src/plugins/builtin/earnings-calls/transcript-view.tsx +32 -2
  300. package/src/plugins/builtin/earnings-ripple/pane.tsx +1 -1
  301. package/src/plugins/builtin/econ/calendar-model.ts +94 -2
  302. package/src/plugins/builtin/econ/detail-view.tsx +15 -11
  303. package/src/plugins/builtin/econ/index.tsx +25 -9
  304. package/src/plugins/builtin/econ/types.ts +4 -1
  305. package/src/plugins/builtin/equity-screener/headless.ts +23 -7
  306. package/src/plugins/builtin/equity-screener/index.tsx +3 -0
  307. package/src/plugins/builtin/equity-screener/live.ts +39 -12
  308. package/src/plugins/builtin/equity-screener/model.ts +86 -5
  309. package/src/plugins/builtin/equity-screener/pane.tsx +20 -21
  310. package/src/plugins/builtin/equity-screener/results.ts +12 -3
  311. package/src/plugins/builtin/equity-screener/ticker-check.tsx +2 -2
  312. package/src/plugins/builtin/estimate-revisions/pane.tsx +2 -2
  313. package/src/plugins/builtin/executives/pane.tsx +2 -2
  314. package/src/plugins/builtin/exposure/pane.tsx +1 -1
  315. package/src/plugins/builtin/fear-greed/data.ts +3 -1
  316. package/src/plugins/builtin/fear-greed/headless.ts +8 -2
  317. package/src/plugins/builtin/fear-greed/pane.tsx +8 -4
  318. package/src/plugins/builtin/filing-events/pane.tsx +1 -1
  319. package/src/plugins/builtin/futures/index.tsx +5 -4
  320. package/src/plugins/builtin/futures/model.ts +17 -9
  321. package/src/plugins/builtin/futures/returns.ts +2 -0
  322. package/src/plugins/builtin/futures/series.ts +44 -8
  323. package/src/plugins/builtin/futures/table.tsx +3 -3
  324. package/src/plugins/builtin/futures-curve/client.ts +1 -0
  325. package/src/plugins/builtin/futures-curve/headless.ts +17 -12
  326. package/src/plugins/builtin/futures-curve/index.tsx +7 -4
  327. package/src/plugins/builtin/futures-curve/model.ts +117 -7
  328. package/src/plugins/builtin/futures-curve/pane.tsx +18 -7
  329. package/src/plugins/builtin/fx-matrix/amount.ts +2 -1
  330. package/src/plugins/builtin/fx-matrix/index.tsx +9 -0
  331. package/src/plugins/builtin/gpu/changes.tsx +1 -1
  332. package/src/plugins/builtin/gpu/equities.tsx +1 -1
  333. package/src/plugins/builtin/gpu/pane.tsx +2 -2
  334. package/src/plugins/builtin/help/function-card.tsx +4 -2
  335. package/src/plugins/builtin/help/function-index.ts +12 -6
  336. package/src/plugins/builtin/help/index.tsx +1 -1
  337. package/src/plugins/builtin/holders/beneficial-view.tsx +1 -1
  338. package/src/plugins/builtin/holders/pane.tsx +1 -1
  339. package/src/plugins/builtin/insider/base-values.ts +55 -0
  340. package/src/plugins/builtin/insider/headless.ts +307 -83
  341. package/src/plugins/builtin/insider/index.tsx +65 -23
  342. package/src/plugins/builtin/insider/insiders.tsx +26 -16
  343. package/src/plugins/builtin/insider/model.ts +2 -2
  344. package/src/plugins/builtin/insider/signals-cells.tsx +4 -1
  345. package/src/plugins/builtin/insider/signals-model.ts +13 -5
  346. package/src/plugins/builtin/insider/signals.tsx +5 -3
  347. package/src/plugins/builtin/insider/tickers.tsx +466 -0
  348. package/src/plugins/builtin/ipo-calendar/pane.tsx +1 -1
  349. package/src/plugins/builtin/iv-history/client.ts +35 -4
  350. package/src/plugins/builtin/iv-history/headless.ts +10 -4
  351. package/src/plugins/builtin/iv-history/model.ts +85 -16
  352. package/src/plugins/builtin/iv-history/pane.tsx +2 -2
  353. package/src/plugins/builtin/iv-history/screen-pane.tsx +6 -3
  354. package/src/plugins/builtin/jobs/pane.tsx +5 -5
  355. package/src/plugins/builtin/kelly-sizer/headless.ts +2 -2
  356. package/src/plugins/builtin/kelly-sizer/history.ts +10 -3
  357. package/src/plugins/builtin/kelly-sizer/pane.tsx +2 -2
  358. package/src/plugins/builtin/kelly-sizer/sections.tsx +1 -1
  359. package/src/plugins/builtin/macro-day/pane.tsx +1 -1
  360. package/src/plugins/builtin/macro-day/release-table.ts +5 -5
  361. package/src/plugins/builtin/macro-day/releases.ts +11 -9
  362. package/src/plugins/builtin/market-movers/headless.ts +6 -2
  363. package/src/plugins/builtin/market-movers/screener.ts +18 -4
  364. package/src/plugins/builtin/members/breadth-pane.tsx +3 -3
  365. package/src/plugins/builtin/members/client.ts +24 -2
  366. package/src/plugins/builtin/members/headless.ts +66 -9
  367. package/src/plugins/builtin/members/index.tsx +7 -6
  368. package/src/plugins/builtin/members/model.ts +89 -5
  369. package/src/plugins/builtin/members/pane.tsx +70 -21
  370. package/src/plugins/builtin/mna/distress/pane.tsx +2 -1
  371. package/src/plugins/builtin/mna/pane.tsx +1 -1
  372. package/src/plugins/builtin/money-markets/client.ts +43 -15
  373. package/src/plugins/builtin/money-markets/headless.ts +18 -11
  374. package/src/plugins/builtin/money-markets/index.tsx +7 -6
  375. package/src/plugins/builtin/money-markets/model.ts +20 -5
  376. package/src/plugins/builtin/money-markets/pane.tsx +28 -17
  377. package/src/plugins/builtin/news/wire/news/footer.ts +11 -1
  378. package/src/plugins/builtin/news/wire/news/table.tsx +15 -5
  379. package/src/plugins/builtin/notes/headless.ts +94 -0
  380. package/src/plugins/builtin/notes/index.tsx +3 -1
  381. package/src/plugins/builtin/notes/store.ts +10 -3
  382. package/src/plugins/builtin/options/footer.ts +8 -2
  383. package/src/plugins/builtin/options/open-interest-as-of.ts +12 -3
  384. package/src/plugins/builtin/options/view.tsx +10 -1
  385. package/src/plugins/builtin/options-calculator/pane.tsx +1 -1
  386. package/src/plugins/builtin/options-positioning/client.ts +35 -8
  387. package/src/plugins/builtin/options-positioning/headless.ts +17 -7
  388. package/src/plugins/builtin/options-positioning/index.tsx +10 -0
  389. package/src/plugins/builtin/options-positioning/pane.tsx +16 -7
  390. package/src/plugins/builtin/options-scenario/csp-screen-pane.tsx +1 -1
  391. package/src/plugins/builtin/options-scenario/pane.tsx +1 -1
  392. package/src/plugins/builtin/pe-band/pane.tsx +2 -2
  393. package/src/plugins/builtin/perps/cascade-tabs.tsx +2 -2
  394. package/src/plugins/builtin/perps/client.ts +54 -15
  395. package/src/plugins/builtin/perps/headless.ts +39 -13
  396. package/src/plugins/builtin/perps/index.tsx +2 -1
  397. package/src/plugins/builtin/perps/model.ts +43 -1
  398. package/src/plugins/builtin/perps/pane.tsx +35 -18
  399. package/src/plugins/builtin/portfolio-list/allocation-rows.ts +74 -0
  400. package/src/plugins/builtin/portfolio-list/cell-version.ts +1 -0
  401. package/src/plugins/builtin/portfolio-list/cli/period-report.ts +7 -3
  402. package/src/plugins/builtin/portfolio-list/cli/portfolio-command.ts +33 -3
  403. package/src/plugins/builtin/portfolio-list/cli/render.ts +149 -24
  404. package/src/plugins/builtin/portfolio-list/headless.ts +30 -9
  405. package/src/plugins/builtin/portfolio-list/income.ts +17 -8
  406. package/src/plugins/builtin/portfolio-list/index.tsx +4 -4
  407. package/src/plugins/builtin/portfolio-list/pane/fx-day-moves.ts +52 -0
  408. package/src/plugins/builtin/portfolio-list/pane/index.tsx +76 -9
  409. package/src/plugins/builtin/portfolio-list/pane/target-weights.tsx +178 -0
  410. package/src/plugins/builtin/portfolio-list/period-pnl.ts +44 -5
  411. package/src/plugins/builtin/portfolio-list/settings.ts +12 -6
  412. package/src/plugins/builtin/portfolio-list/summary/index.tsx +9 -4
  413. package/src/plugins/builtin/portfolio-list/summary/totals.ts +21 -2
  414. package/src/plugins/builtin/portfolio-list/table.tsx +33 -25
  415. package/src/plugins/builtin/power/gas.tsx +2 -2
  416. package/src/plugins/builtin/power/prices.tsx +2 -2
  417. package/src/plugins/builtin/primary-dealers/pane.tsx +10 -11
  418. package/src/plugins/builtin/rate-path/model.ts +9 -0
  419. package/src/plugins/builtin/rate-path/pane.tsx +6 -5
  420. package/src/plugins/builtin/realized-vol/fx-proxy.ts +27 -0
  421. package/src/plugins/builtin/realized-vol/headless.ts +19 -12
  422. package/src/plugins/builtin/realized-vol/model.ts +14 -6
  423. package/src/plugins/builtin/realized-vol/pane.tsx +15 -8
  424. package/src/plugins/builtin/realized-vol/settings.ts +2 -1
  425. package/src/plugins/builtin/relative-rotation/pane.tsx +1 -1
  426. package/src/plugins/builtin/research/analyst-headless.ts +5 -1
  427. package/src/plugins/builtin/research/analyst-model.ts +7 -1
  428. package/src/plugins/builtin/research/analyst-pane.tsx +1 -1
  429. package/src/plugins/builtin/research/relative-valuation-basis.ts +44 -4
  430. package/src/plugins/builtin/research/relative-valuation-headless.ts +59 -14
  431. package/src/plugins/builtin/research/relative-valuation-model.ts +65 -26
  432. package/src/plugins/builtin/research/relative-valuation-pane.tsx +42 -17
  433. package/src/plugins/builtin/revenue-breakdown/pane.tsx +1 -1
  434. package/src/plugins/builtin/reverse-dcf/client.ts +34 -4
  435. package/src/plugins/builtin/reverse-dcf/headless.ts +30 -15
  436. package/src/plugins/builtin/reverse-dcf/model.ts +190 -29
  437. package/src/plugins/builtin/reverse-dcf/pane.tsx +35 -13
  438. package/src/plugins/builtin/risk-factors/pane.tsx +2 -2
  439. package/src/plugins/builtin/roadmap/pane.tsx +2 -2
  440. package/src/plugins/builtin/scanner/flow-pane.tsx +4 -4
  441. package/src/plugins/builtin/scanner/headless.ts +15 -1
  442. package/src/plugins/builtin/seasonality/client.ts +66 -17
  443. package/src/plugins/builtin/seasonality/headless.ts +7 -2
  444. package/src/plugins/builtin/seasonality/model.ts +12 -3
  445. package/src/plugins/builtin/seasonality/pane.tsx +5 -3
  446. package/src/plugins/builtin/sec/fund-facts-view.tsx +5 -2
  447. package/src/plugins/builtin/sec/fund-facts.ts +41 -1
  448. package/src/plugins/builtin/sec/headless.ts +8 -4
  449. package/src/plugins/builtin/sec/index.tsx +41 -13
  450. package/src/plugins/builtin/shared/ticker-company.ts +111 -0
  451. package/src/plugins/builtin/shared/use-quote-board.ts +65 -8
  452. package/src/plugins/builtin/shared/volatility/live-session.ts +23 -0
  453. package/src/plugins/builtin/shared/volatility-indices.ts +2 -0
  454. package/src/plugins/builtin/short-interest/publications-pane.tsx +1 -1
  455. package/src/plugins/builtin/short-volume/pane.tsx +1 -1
  456. package/src/plugins/builtin/social-mentions/outliers.tsx +3 -3
  457. package/src/plugins/builtin/social-mentions/pane.tsx +2 -2
  458. package/src/plugins/builtin/supply-chain/graph-pane.tsx +1 -1
  459. package/src/plugins/builtin/supply-chain/pane.tsx +1 -1
  460. package/src/plugins/builtin/themes/pane.tsx +4 -4
  461. package/src/plugins/builtin/thirteenf/api.ts +1 -0
  462. package/src/plugins/builtin/thirteenf/format.ts +5 -0
  463. package/src/plugins/builtin/thirteenf/headless.ts +2 -2
  464. package/src/plugins/builtin/thirteenf/model.ts +128 -5
  465. package/src/plugins/builtin/thirteenf/overlap-pane.tsx +1 -1
  466. package/src/plugins/builtin/thirteenf/report-notes.ts +10 -3
  467. package/src/plugins/builtin/thirteenf/signals-pane.tsx +1 -1
  468. package/src/plugins/builtin/thirteenf/table.ts +2 -2
  469. package/src/plugins/builtin/thirteenf/types.ts +12 -0
  470. package/src/plugins/builtin/ticker-detail/data-panes/historical-prices.tsx +27 -14
  471. package/src/plugins/builtin/ticker-detail/data-panes/returns-history.ts +6 -3
  472. package/src/plugins/builtin/ticker-detail/data-panes/returns-model.ts +14 -0
  473. package/src/plugins/builtin/ticker-detail/data-panes/returns-pane.tsx +4 -1
  474. package/src/plugins/builtin/ticker-detail/financials/aggregation.ts +87 -19
  475. package/src/plugins/builtin/ticker-detail/financials/exchange-results.ts +54 -0
  476. package/src/plugins/builtin/ticker-detail/financials/model.ts +114 -9
  477. package/src/plugins/builtin/ticker-detail/financials/ratios.ts +37 -20
  478. package/src/plugins/builtin/ticker-detail/financials/tab.tsx +42 -19
  479. package/src/plugins/builtin/ticker-detail/headless-schema.ts +3 -2
  480. package/src/plugins/builtin/ticker-detail/headless.ts +90 -31
  481. package/src/plugins/builtin/ticker-detail/overview/model.ts +22 -15
  482. package/src/plugins/builtin/ticker-detail/overview-tab.tsx +5 -2
  483. package/src/plugins/builtin/ticker-detail/quote-monitor/card.tsx +12 -7
  484. package/src/plugins/builtin/ticker-detail/quote-monitor/index.tsx +21 -0
  485. package/src/plugins/builtin/trace-bonds/client.ts +107 -10
  486. package/src/plugins/builtin/trace-bonds/detail.tsx +1 -1
  487. package/src/plugins/builtin/trace-bonds/headless.ts +20 -5
  488. package/src/plugins/builtin/trace-bonds/pane.tsx +15 -4
  489. package/src/plugins/builtin/treasury-auctions/hk-view.tsx +1 -1
  490. package/src/plugins/builtin/treasury-auctions/pane.tsx +1 -1
  491. package/src/plugins/builtin/treasury-daily/pane.tsx +2 -2
  492. package/src/plugins/builtin/vol-surface/charts.tsx +30 -5
  493. package/src/plugins/builtin/vol-surface/client.ts +40 -12
  494. package/src/plugins/builtin/vol-surface/events.ts +213 -0
  495. package/src/plugins/builtin/vol-surface/headless.ts +82 -13
  496. package/src/plugins/builtin/vol-surface/index.tsx +5 -1
  497. package/src/plugins/builtin/vol-surface/model.ts +42 -6
  498. package/src/plugins/builtin/vol-surface/pane.tsx +95 -23
  499. package/src/plugins/builtin/volatility/dvol.ts +14 -2
  500. package/src/plugins/builtin/volatility/headless.ts +3 -2
  501. package/src/plugins/builtin/volatility/index.tsx +1 -1
  502. package/src/plugins/builtin/volatility/pane.tsx +1 -1
  503. package/src/plugins/builtin/volatility/series.ts +7 -3
  504. package/src/plugins/builtin/world-venue-map/activity-series.ts +89 -0
  505. package/src/plugins/builtin/world-venue-map/chokepoint-report.ts +123 -0
  506. package/src/plugins/builtin/world-venue-map/evidence.ts +2 -0
  507. package/src/plugins/builtin/world-venue-map/geo-series.ts +35 -1
  508. package/src/plugins/builtin/world-venue-map/headless.ts +58 -9
  509. package/src/plugins/builtin/world-venue-map/index.ts +6 -3
  510. package/src/plugins/builtin/world-venue-map/layered-pane.tsx +6 -1
  511. package/src/plugins/builtin/world-venue-map/pane.tsx +4 -3
  512. package/src/plugins/builtin/yield-curve/index.tsx +12 -10
  513. package/src/plugins/builtin/yield-curve/swaps.tsx +1 -1
  514. package/src/plugins/extracted-plugins.ts +14 -10
  515. package/src/plugins/installer.ts +17 -1
  516. package/src/plugins/marketplace/feed.ts +14 -0
  517. package/src/plugins/marketplace/install-offer.ts +64 -0
  518. package/src/plugins/registry/contributions.ts +46 -8
  519. package/src/plugins/registry/index.ts +5 -0
  520. package/src/portfolio/collection-name.ts +38 -4
  521. package/src/portfolio/column-values.ts +32 -4
  522. package/src/portfolio/period-pnl.ts +4 -2
  523. package/src/react/async-resource.ts +24 -8
  524. package/src/remote/endpoint.ts +38 -12
  525. package/src/remote/secrets.ts +22 -6
  526. package/src/remote/server.ts +20 -4
  527. package/src/renderers/dom/data-table/index.tsx +2 -1
  528. package/src/renderers/dom/data-table/row.tsx +49 -7
  529. package/src/renderers/dom/desktop/controls.tsx +3 -1
  530. package/src/renderers/dom/desktop/query-bar.tsx +57 -7
  531. package/src/renderers/dom/host/surface-3d.tsx +46 -5
  532. package/src/renderers/dom/styles.css +24 -4
  533. package/src/renderers/electrobun/view/backend-rpc.ts +15 -21
  534. package/src/renderers/electrobun/view/cli-pane-shot-entry.tsx +16 -61
  535. package/src/renderers/electrobun/view/cli-pane-shot-socket.ts +134 -0
  536. package/src/renderers/electrobun/view/host-route.ts +119 -0
  537. package/src/renderers/electrobun/view/rpc-timeout.ts +6 -5
  538. package/src/renderers/opentui/box-width.ts +30 -0
  539. package/src/renderers/opentui/toast-host.tsx +6 -3
  540. package/src/renderers/opentui/ui-host.tsx +29 -5
  541. package/src/series/registry.ts +1 -0
  542. package/src/series/standalone-catalog.ts +40 -0
  543. package/src/series/types.ts +10 -0
  544. package/src/series/validate.ts +5 -0
  545. package/src/shares/portable-layout.ts +2 -7
  546. package/src/sources/gloomberb-cloud/dated-chunks.ts +133 -0
  547. package/src/sources/gloomberb-cloud/index.ts +46 -5
  548. package/src/sources/gloomberb-cloud/news.ts +15 -9
  549. package/src/sources/gloomberb-cloud/normalizers.ts +17 -0
  550. package/src/sources/history-coverage.ts +13 -0
  551. package/src/sources/history-result.ts +1 -0
  552. package/src/sources/provider-errors.ts +9 -0
  553. package/src/sources/provider-router/batches.ts +7 -3
  554. package/src/sources/provider-router/financial-routes.ts +3 -1
  555. package/src/sources/provider-router/history.ts +6 -4
  556. package/src/sources/provider-router/index.ts +5 -1
  557. package/src/sources/provider-router/primary.ts +4 -3
  558. package/src/sources/provider-router/retrieved-at.ts +12 -0
  559. package/src/team/store.ts +17 -4
  560. package/src/telemetry/crash-reports.ts +3 -1
  561. package/src/test-support/cli-context.ts +3 -2
  562. package/src/test-support/test-env.ts +7 -0
  563. package/src/theme/themes.ts +16 -9
  564. package/src/theme/tone-contrast.ts +29 -5
  565. package/src/tickers/company-name-listing.ts +31 -3
  566. package/src/tickers/company-name.ts +9 -0
  567. package/src/tickers/index-roots.ts +56 -4
  568. package/src/tickers/listing-name.ts +7 -2
  569. package/src/tickers/listing-venues.ts +17 -2
  570. package/src/tickers/search/home-listing.ts +2 -0
  571. package/src/tickers/search/index.ts +64 -11
  572. package/src/tickers/search/major-listings.json +595 -592
  573. package/src/tickers/search/ranking.ts +19 -1
  574. package/src/tickers/terminal-codes.ts +5 -3
  575. package/src/time-series/bar-aggregation.ts +3 -2
  576. package/src/time-series/base-series.ts +18 -1
  577. package/src/time-series/chart-data.ts +9 -6
  578. package/src/time-series/chart-seed.ts +11 -3
  579. package/src/time-series/currency-conversion.ts +1 -0
  580. package/src/time-series/date-window.ts +8 -0
  581. package/src/time-series/formula-months.ts +57 -0
  582. package/src/time-series/fundamentals/period-points.ts +3 -3
  583. package/src/time-series/fundamentals/source-statements.ts +5 -4
  584. package/src/time-series/leverage.ts +12 -4
  585. package/src/time-series/live-bars.ts +12 -7
  586. package/src/time-series/live-quotes.ts +6 -2
  587. package/src/time-series/market.ts +10 -3
  588. package/src/time-series/price-comparison.ts +106 -0
  589. package/src/time-series/range.ts +10 -0
  590. package/src/time-series/resolve-context.ts +7 -2
  591. package/src/time-series/resolve.ts +61 -5
  592. package/src/time-series/series-name.ts +2 -2
  593. package/src/time-series/series-presentation.ts +91 -2
  594. package/src/time-series/session-bar.ts +13 -7
  595. package/src/time-series/spec.ts +21 -2
  596. package/src/time-series/studies/formula.ts +262 -36
  597. package/src/time-series/studies/leverage.ts +9 -3
  598. package/src/time-series/studies/resolve.ts +7 -2
  599. package/src/time-series/types.ts +34 -0
  600. package/src/time-series/use-chart-resolution.ts +18 -1
  601. package/src/types/data-provider.ts +7 -0
  602. package/src/types/financials.ts +117 -2
  603. package/src/types/headless.ts +70 -3
  604. package/src/types/instrument.ts +6 -0
  605. package/src/types/plugin-context.ts +9 -0
  606. package/src/types/plugin-pane-templates.ts +6 -0
  607. package/src/types/plugin-panes.ts +7 -0
  608. package/src/types/price-history.ts +6 -0
  609. package/src/ui/host.tsx +3 -1
  610. package/src/ui/index.tsx +7 -2
  611. package/src/utils/cli-output.ts +21 -1
  612. package/src/utils/currency-units.ts +14 -0
  613. package/src/utils/datetime-format.ts +11 -0
  614. package/src/utils/exchange-announcements.ts +26 -3
  615. package/src/utils/exchange-notation.generated.ts +3 -4
  616. package/src/utils/exchange-results.ts +144 -0
  617. package/src/utils/exchanges.ts +10 -0
  618. package/src/utils/financial-statements.ts +212 -22
  619. package/src/utils/fire-and-forget.ts +1 -1
  620. package/src/utils/fiscal-period.ts +41 -3
  621. package/src/utils/format.ts +10 -6
  622. package/src/utils/fundamentals.ts +223 -15
  623. package/src/utils/futures-generic.ts +26 -0
  624. package/src/utils/lease-liabilities.ts +15 -5
  625. package/src/utils/lookup-token.ts +22 -0
  626. package/src/utils/max-drawdown.ts +25 -4
  627. package/src/utils/price-history-integrity.ts +56 -8
  628. package/src/utils/price-history.ts +6 -2
  629. package/src/utils/price-window.ts +38 -2
  630. package/src/utils/replace-file.ts +47 -0
  631. package/src/utils/rpc-timeout-error.ts +16 -2
  632. package/src/utils/untrusted-text.ts +14 -0
@@ -24,20 +24,31 @@ export async function loadCorrelationHistory(
24
24
  * has not finished: a coin's UTC day or a future's session under way
25
25
  * (`partial`), or a future's last trade before its settlement (`unsettled`).
26
26
  * That day is no close, so the line calls the bars daily bars and says so, as
27
- * `history` does, instead of dating a close by it. Nothing when `day` (the
28
- * newest date the analysis uses) is a finished bar in every history.
27
+ * `history` does, instead of dating a close by it, and dates it by the newest
28
+ * of `quotedAt` (its listings' quote times) on that day. Nothing when `day`
29
+ * (the newest date the analysis uses) is a finished bar in every history.
29
30
  */
30
31
  export function unfinishedBarFreshness(
31
32
  histories: ReadonlyArray<ReadonlyArray<Pick<PricePoint, "date" | "partial" | "unsettled">> | undefined>,
32
33
  day: string | null | undefined,
33
- ): Pick<HeadlessPaneFreshness, "basis" | "note"> | null {
34
+ quotedAt: ReadonlyArray<number | null | undefined> = [],
35
+ now = Date.now(),
36
+ ): Pick<HeadlessPaneFreshness, "basis" | "note" | "asOf"> | null {
34
37
  if (!day) return null;
35
38
  const bars = histories.flatMap((history) => history?.filter((point) => new Date(point.date).toISOString().slice(0, 10) === day) ?? []);
36
- if (bars.some((bar) => bar.partial)) return { basis: "daily bars", note: `the newest bar is ${DAY_SO_FAR_TEXT}` };
37
- if (bars.some((bar) => bar.unsettled)) return { basis: "daily bars", note: "the newest bar is not yet settled" };
38
- return null;
39
+ const note = bars.some((bar) => bar.partial) ? `the newest bar is ${DAY_SO_FAR_TEXT}`
40
+ : bars.some((bar) => bar.unsettled) ? "the newest bar is not yet settled" : null;
41
+ if (!note) return null;
42
+ // The bar is as of its last update, the newest quote of its day, as G dates one (not its midnight).
43
+ const dayStart = Date.parse(`${day}T00:00:00Z`);
44
+ const updates = quotedAt.filter((time): time is number => typeof time === "number" && Number.isFinite(time)
45
+ && time >= dayStart && time <= now + QUOTE_CLOCK_SKEW_MS);
46
+ return { basis: "daily bars", note, ...(updates.length ? { asOf: new Date(Math.max(...updates)).toISOString() } : {}) };
39
47
  }
40
48
 
49
+ /** How far ahead of this clock a quote's time may read and still be taken as now. */
50
+ const QUOTE_CLOCK_SKEW_MS = 10 * 60_000;
51
+
41
52
  /** Below this many shared daily returns a correlation says why it has so few. */
42
53
  const CORRELATION_EXPLAINED_RETURNS = 20;
43
54
 
@@ -36,6 +36,7 @@ import {
36
36
  buildCorrelationPaneTitle,
37
37
  buildGeoCorrelationSeries,
38
38
  buildStatusSummary,
39
+ correlationRollNotes,
39
40
  type CorrelationSeries,
40
41
  getSeriesForEntry,
41
42
  pairKey,
@@ -188,7 +189,7 @@ function CorrelationMatrixPane({ focused, width, height }: PaneProps) {
188
189
  const refresh = useCallback(() => {
189
190
  const coordinator = getSharedMarketDataCoordinator();
190
191
  for (const request of chartRequests) void coordinator?.loadChart(request, { forceRefresh: true });
191
- if (geoKey) void geoHistory.reload();
192
+ if (geoKey) geoHistory.reload();
192
193
  }, [chartRequests, geoKey, geoHistory.reload]);
193
194
 
194
195
  useShortcut((event) => {
@@ -219,12 +220,15 @@ function CorrelationMatrixPane({ focused, width, height }: PaneProps) {
219
220
  });
220
221
 
221
222
  // The ticker set and range are visible in-pane and an invalid list shows in
222
- // the body, so the footer only carries load state. `r` is global: no hint.
223
+ // the body, so the footer carries load state, and a future's rolls as GR
224
+ // says them. `r` is global: no hint.
225
+ const rollNotes = correlationRollNotes(symbols, seriesBySymbol).join(" · ");
223
226
  usePaneFooter("correlation", () => ({
224
227
  info: !settings.symbolsError && symbols.length >= 2 && statusSummary
225
- ? [{ id: "status", parts: [{ text: statusSummary, tone: "muted" as const }] }]
228
+ ? [{ id: "status", parts: [{ text: statusSummary, tone: "muted" as const }] },
229
+ ...(rollNotes ? [{ id: "rolls", parts: [{ text: rollNotes, tone: "muted" as const }] }] : [])]
226
230
  : [],
227
- }), [settings.symbolsError, statusSummary, symbols.length]);
231
+ }), [rollNotes, settings.symbolsError, statusSummary, symbols.length]);
228
232
 
229
233
  // Rows are exactly as wide as the matrix (after the one-cell inset), so the
230
234
  // zebra and hover bands stop at the last column instead of running on.
@@ -1,3 +1,4 @@
1
+ import { rollAdjustedHistory } from "../../../../market-data/futures-roll-returns";
1
2
  import { pricePointIntegrity, type PriceHistoryIntegrity } from "../../../../utils/price-history-integrity";
2
3
  import type { QueryEntry } from "../../../../market-data/result-types";
3
4
  import { colors } from "../../../../theme/colors";
@@ -24,6 +25,8 @@ export interface CorrelationSeries {
24
25
  observationCount: number;
25
26
  /** Bars left out because their prices contradict each other, kept as the source reported them. */
26
27
  integrity?: PriceHistoryIntegrity[];
28
+ /** A continuous future's returns, read within one contract at each roll: "rolls back-adjusted" (rollAdjustedHistory). */
29
+ rollNote?: string;
27
30
  loading?: boolean;
28
31
  refreshError?: string;
29
32
  fetchedAt?: number | null;
@@ -90,12 +93,15 @@ export function getSeriesForEntry(
90
93
  */
91
94
  export function buildCorrelationSeries(symbol: string, history: readonly PricePoint[]): CorrelationSeries {
92
95
  const integrity = history.flatMap((point) => { const issue = pricePointIntegrity(point); return issue ? [issue] : []; });
93
- const prices = dailyCloses(history);
96
+ // The closes are read for returns alone: a continuous future's are each one contract's.
97
+ const returns = rollAdjustedHistory(history, symbol);
98
+ const prices = dailyCloses(returns.points);
94
99
  const observationCount = Math.max(0, prices.length - 1);
95
100
  return {
96
101
  symbol, prices, observationCount,
97
102
  status: observationCount < MIN_CORRELATION_OBSERVATIONS ? "insufficient" : "ready",
98
103
  ...(integrity.length ? { integrity } : {}),
104
+ ...(returns.note ? { rollNote: returns.note } : {}),
99
105
  };
100
106
  }
101
107
 
@@ -190,6 +196,14 @@ export function buildStatusSummary(
190
196
  return parts.join(" · ");
191
197
  }
192
198
 
199
+ /** "NG=F: rolls back-adjusted" for each listed continuous future, as GR says it: the pane's footer and `fn CORR`'s notes. */
200
+ export function correlationRollNotes(symbols: readonly string[], seriesBySymbol: ReadonlyMap<string, CorrelationSeries>): string[] {
201
+ return symbols.flatMap((symbol) => {
202
+ const note = seriesBySymbol.get(symbol)?.rollNote;
203
+ return note ? [`${symbol}: ${note}`] : [];
204
+ });
205
+ }
206
+
193
207
  /**
194
208
  * The matrix already labels every symbol on both axes and the pane now carries
195
209
  * its own range control, so the title stays generic instead of repeating them.
@@ -42,5 +42,5 @@ export function useRelationshipHistories(pair: [string, string] | null, range: R
42
42
  const error = leftSymbol && rightSymbol && !dataProvider
43
43
  ? "Market data unavailable"
44
44
  : resource.error;
45
- return { data: resource.data, loading: resource.loading, error, reload: resource.reload, updatedAt: resource.updatedAt };
45
+ return { data: resource.data, loading: resource.loading, error, reload: resource.reload, reloadAndWait: resource.reloadAndWait, updatedAt: resource.updatedAt };
46
46
  }
@@ -6,6 +6,7 @@ import type { PaneSettingsDef, PaneTemplateCreateOptions } from "../../../../typ
6
6
  import type { PricePoint } from "../../../../types/financials";
7
7
  import { formatTickerListInput, parseTickerListInput } from "../../../../tickers/list";
8
8
  import { alignDailyCloses, dailyCloses, pearsonCorrelation } from "../compute";
9
+ import { rollAdjustedHistory } from "../../../../market-data/futures-roll-returns";
9
10
 
10
11
  export type RelationshipRange = Extract<TimeRange, "1M" | "3M" | "6M" | "1Y" | "5Y" | "ALL">;
11
12
 
@@ -51,6 +52,8 @@ export interface RelationshipAnalysis {
51
52
  stats: RelationshipRegressionStats | null;
52
53
  latestRatio: number | null;
53
54
  latestCorrelation: number | null;
55
+ /** A continuous future's returns read within one contract at each roll: "NG=F: rolls back-adjusted". */
56
+ rollNotes: string[];
54
57
  }
55
58
 
56
59
  function syntheticChartPoint(date: Date, value: number): ProjectedChartPoint {
@@ -148,10 +151,16 @@ function computeRelationshipRegression(returns: RelationshipReturnPoint[]): Rela
148
151
  };
149
152
  }
150
153
 
154
+ /**
155
+ * The pair's ratio from the prices as traded, and its returns, rolling
156
+ * correlation and regression from each side's returns, a continuous future's
157
+ * within one contract at each roll (rollAdjustedHistory) when `symbols` names it.
158
+ */
151
159
  export function buildRelationshipAnalysis(
152
160
  leftPoints: PricePoint[],
153
161
  rightPoints: PricePoint[],
154
162
  correlationWindow = DEFAULT_RELATIONSHIP_CORRELATION_WINDOW,
163
+ symbols?: readonly [string, string],
155
164
  ): RelationshipAnalysis {
156
165
  const issues = (points: PricePoint[]) => points.flatMap((point) => {
157
166
  const issue = pricePointIntegrity(point); return issue ? [issue] : [];
@@ -159,7 +168,11 @@ export function buildRelationshipAnalysis(
159
168
  // Bars whose prices contradict each other are gaps, as history leaves them blank (dailyCloses); kept for the export.
160
169
  const integrity = { left: issues(leftPoints), right: issues(rightPoints) };
161
170
  const aligned = alignRelationshipPrices(leftPoints, rightPoints);
162
- const returns = buildRelationshipReturns(aligned);
171
+ const [left, right] = symbols
172
+ ? [rollAdjustedHistory(leftPoints, symbols[0]), rollAdjustedHistory(rightPoints, symbols[1])]
173
+ : [{ points: leftPoints, note: null }, { points: rightPoints, note: null }];
174
+ const returns = buildRelationshipReturns(left.note || right.note ? alignRelationshipPrices(left.points, right.points) : aligned);
175
+ const rollNotes = symbols ? [[symbols[0], left.note], [symbols[1], right.note]].flatMap(([symbol, note]) => note ? [`${symbol}: ${note}`] : []) : [];
163
176
  const correlationPoints = buildRollingCorrelationPoints(returns, correlationWindow);
164
177
  const scatterPoints = returns.map((entry, index) => ({
165
178
  x: entry.rightReturn * 100,
@@ -181,6 +194,7 @@ export function buildRelationshipAnalysis(
181
194
  stats,
182
195
  latestRatio: aligned.at(-1)?.ratio ?? null,
183
196
  latestCorrelation,
197
+ rollNotes,
184
198
  ...(correlationUnavailableReason ? { correlationUnavailableReason } : {}),
185
199
  ...(integrity.left.length || integrity.right.length ? { integrity } : {}),
186
200
  };
@@ -144,7 +144,7 @@ export function RelationshipGraphPane({ focused, width, height }: PaneProps) {
144
144
  const left = data?.[0] ?? null;
145
145
  const right = data?.[1] ?? null;
146
146
  const analysis = useMemo(() => (
147
- left && right ? buildRelationshipAnalysis(left.points, right.points, correlationWindow) : null
147
+ left && right ? buildRelationshipAnalysis(left.points, right.points, correlationWindow, [left.symbol, right.symbol]) : null
148
148
  ), [correlationWindow, left, right]);
149
149
  const cycleRange = useCallback(() => setRange((current) => nextRelationshipRange(current)), [setRange]);
150
150
  const cycleWindow = useCallback(() => setCorrelationWindow((current) => nextRelationshipWindow(current)), [setCorrelationWindow]);
@@ -212,7 +212,7 @@ export function RelationshipGraphPane({ focused, width, height }: PaneProps) {
212
212
  return true;
213
213
  }, [alignedDates]);
214
214
 
215
- usePaneRefreshKey(() => { void reload(); }, { focused });
215
+ usePaneRefreshKey(() => { reload(); }, { focused });
216
216
  useShortcut((event) => {
217
217
  if (!focused) return;
218
218
  if (isPlainKey(event, "home", "end") && jumpCursor(event.name)) {
@@ -243,7 +243,9 @@ export function RelationshipGraphPane({ focused, width, height }: PaneProps) {
243
243
 
244
244
  // The legend reads the values at the cursor and the axis carries its date,
245
245
  // so the footer only reports loading.
246
- usePaneStatusFooter({ registrationId: "relationship-graph", loading });
246
+ const rollInfo = useMemo(() => analysis?.rollNotes.length
247
+ ? [{ id: "rolls", parts: [{ text: analysis.rollNotes.join(" · "), tone: "muted" as const }] }] : undefined, [analysis]);
248
+ usePaneStatusFooter({ registrationId: "relationship-graph", loading, ...(rollInfo ? { info: rollInfo } : {}) });
247
249
 
248
250
  if (!pair) {
249
251
  return (
@@ -1,7 +1,7 @@
1
1
  import type { CotClass, CotClassSummary, CotContractPayload, CotFamily, CotHistoryPoint } from "../../../api-client/cot";
2
2
  import type { HeadlessPaneColumn, HeadlessPaneDefinition } from "../../../types/plugin";
3
3
  import { fetchCotBoard, fetchCotContract } from "./client";
4
- import { COT_CLASSES, COT_FAMILIES, COT_MAJOR_CODES, COT_POSITIONS, COT_SCOPES, cotClass, cotContractCode, cotContractUnitText, cotFamily, cotInteger, cotMarketName, cotPositions, cotPositionsText, cotProxyFor, cotProxyNote, cotReleaseTime, cotScope, cotUnknownMarketMessage } from "./model";
4
+ import { COT_CLASSES, COT_FAMILIES, COT_MAJOR_CODES, COT_POSITIONS, COT_SCOPES, cotClass, cotContractCode, cotContractUnitText, cotFamily, cotInteger, cotMarketName, cotPositions, cotPositionsText, cotProxyFor, cotProxyNote, cotReleaseTime, cotRoot, cotScope, cotUnknownMarketMessage } from "./model";
5
5
  import { COMMODITIES_VIEW_STATE } from "../commodities-energy/view-state";
6
6
  import { REPORT_ROWS } from "../shared/headless-options";
7
7
  import { DATE_OPTION_EXAMPLES, isoDateOption } from "../../../utils/calendar-date";
@@ -43,6 +43,9 @@ function cotContractTitle(data: CotContractPayload, code: string): string {
43
43
  return [data.contract ? cotMarketName(data.contract.marketName) : code, data.asOf ? `report date ${data.asOf}` : null, units,
44
44
  data.scope === "combined" ? cotPositionsText(data.scope) : null].filter(Boolean).join(" · ");
45
45
  }
46
+ /** What every position counts, and how often the CFTC reports them: an export's `currency_or_unit` and `interval`. */
47
+ const COT_UNIT = "contracts";
48
+ const COT_INTERVAL = "weekly";
46
49
  /** Every trader class of every report, each once, in the reports' order. */
47
50
  const TRADER_CLASSES = [...new Set(Object.values(COT_CLASSES).flat().map(({ value }) => value))];
48
51
 
@@ -140,11 +143,14 @@ export const cotHeadless: HeadlessPaneDefinition<"bundle"> = {
140
143
  const weeklyColumns: HeadlessPaneColumn[] = [{ key: "reportDate", header: "Report date" }, { key: "released", header: "Released" },
141
144
  { key: "openInterest", header: "Open interest", align: "right", format: count },
142
145
  ...classes.map((id) => ({ key: `${camelClass(id)}Net`, header: `${data.positions.find((row) => row.id === id)?.label ?? id} net`, align: "right" as const, format: signed }))];
143
- return { sections: [{ title: cotContractTitle(data, code),
146
+ // Every exported row names the market by the root a reader knows it by (GC), counts in contracts, and is a weekly report.
147
+ const identity = { symbol: cotRoot(data.contract?.contractCode ?? code) ?? code, unit: COT_UNIT, interval: COT_INTERVAL };
148
+ return { sections: [{ title: cotContractTitle(data, code), ...identity,
144
149
  columns: [{ key: "class", header: "Class" }, { key: "long", header: "Long", align: "right", format: count },
145
150
  { key: "short", header: "Short", align: "right", format: count }, ...POSITION_COLUMNS],
146
151
  rows: data.positions.map((row) => ({ class: row.label, ...cotPositionRow(row) })) },
147
152
  { title: weeks.length < data.history.length ? `Weekly positions · newest ${weeks.length} of ${data.history.length}` : "Weekly positions",
153
+ ...identity, rowAsOfKey: "reportDate",
148
154
  columns: weeklyColumns,
149
155
  // Each report's scheduled release, for an export read as of a past week; the text keeps to the positions.
150
156
  textColumns: weeklyColumns.filter((column) => column.key !== "released"),
@@ -161,10 +167,11 @@ export const cotHeadless: HeadlessPaneDefinition<"bundle"> = {
161
167
  const rows = data.rows.filter((row) => scope === "all" || COT_MAJOR_CODES.has(row.contractCode));
162
168
  const publishedAt = cotPublishedAt(data);
163
169
  return { sections: [{ title: positions === "combined" ? `Positioning extremes · ${cotPositionsText(positions)}` : "Positioning extremes",
170
+ unit: COT_UNIT, interval: COT_INTERVAL, rowSymbolKey: "root", rowAsOfKey: "reportDate",
164
171
  columns: [{ key: "marketName", header: "Market" }, { key: "contractCode", header: "Code" },
165
172
  ...POSITION_COLUMNS.map((column) => column.key === "net" ? { ...column, textHeader: cotBoardNetHeader(family, traderClass) } : column),
166
173
  { key: "openInterest", header: "Open interest", align: "right", format: count }, { key: "reportDate", header: "As of" }],
167
- rows: rows.map((row) => ({ contractCode: row.contractCode, marketName: cotMarketName(row.marketName), reportDate: row.reportDate, openInterest: row.openInterest, ...cotPositionRow(row.position) })) }],
174
+ rows: rows.map((row) => ({ contractCode: row.contractCode, root: cotRoot(row.contractCode) ?? row.contractCode, marketName: cotMarketName(row.marketName), reportDate: row.reportDate, openInterest: row.openInterest, ...cotPositionRow(row.position) })) }],
168
175
  errors: data.gaps, metadata: { ...data, scope, publishedAt, complete: data.status === "available" }, ...cotReleased(publishedAt) };
169
176
  },
170
177
  };
@@ -96,7 +96,7 @@ function CotBoard({ width, height, focused, family, initialCode }: PaneProps & {
96
96
  const boardShown = !open;
97
97
  useShortcut((event) => {
98
98
  if (!focused || open || event.targetEditable || event.ctrl || event.meta || event.alt || event.super) return;
99
- if (event.name === "r") { event.preventDefault(); void resource.reload(); }
99
+ if (event.name === "r") { event.preventDefault(); resource.reload(); }
100
100
  if (!boardShown) return;
101
101
  if (event.name === "c") { event.preventDefault(); control.current?.open(); }
102
102
  if (event.name === "s") { event.preventDefault(); scopeControl.current?.open(); }
@@ -189,7 +189,7 @@ function CotDetail({ width, height, focused, code, family, positions, traderClas
189
189
  useAutoRefresh(resource.updatedAt, resource.load);
190
190
  useShortcut((event) => {
191
191
  if (focused && !event.targetEditable && !event.ctrl && !event.meta && !event.alt && !event.super && event.name === "r") {
192
- event.preventDefault(); void resource.reload();
192
+ event.preventDefault(); resource.reload();
193
193
  }
194
194
  });
195
195
  usePaneNoticeFooter({ registrationId: "cot:detail-notices", focused, notices: [...(payload?.gaps ?? []), ...(data?.priceWarning ? [data.priceWarning] : []), ...partialRanks] });
@@ -144,7 +144,7 @@ export function CpiPane({ width, height, focused }: PaneProps) {
144
144
  // The server not serving the board yet is a state of the data, not a failure.
145
145
  const notAvailable = !data && resource.error === CPI_NOT_AVAILABLE;
146
146
  useAutoRefresh(resource.updatedAt, resource.load);
147
- usePaneRefreshKey(() => void resource.reload(), { focused });
147
+ usePaneRefreshKey(() => resource.reload(), { focused });
148
148
  usePaneNoticeFooter({ registrationId: "cpi:notices", focused,
149
149
  notices: [...(data?.gaps ?? []), ...(resource.data?.refreshError ? [resource.data.refreshError] : [])] });
150
150
  usePaneStatusFooter({ registrationId: "cpi", loading: resource.loading, error: notAvailable ? null : resource.error,
@@ -162,7 +162,7 @@ function adverseMove(quote: CreditIndexQuote): "up" | "down" {
162
162
  return quote === "spread" ? "up" : "down";
163
163
  }
164
164
 
165
- const formatPriceAxis = spanAxisFormatter((value, digits) => value.toFixed(digits));
165
+ const formatPriceAxis = spanAxisFormatter((value, digits) => value.toFixed(digits), 2);
166
166
 
167
167
  export function axisFormatter(quote: CreditIndexQuote) {
168
168
  return quote === "spread" ? formatBpAxis : formatPriceAxis;
@@ -105,7 +105,7 @@ function CreditView({ symbol, width, height, focused, accessKey, needsVerificati
105
105
  const link = useChartTableSelection({ rows: rows.filter((row) => row.year !== undefined), getId: rowId, getDate: (row) => new Date(Date.UTC(row.year!, 0, 1)), selectedId: selected?.id ?? null, onSelect: setSelected, focused: focused && !openInstrument, enabled: tab === "maturities" });
106
106
  useAutoRefresh(resource.updatedAt, resource.load);
107
107
  useAutoRefresh(screen.updatedAt, screen.load);
108
- usePaneRefreshKey(() => { void resource.reload(); if (tab === "screen") void screen.reload(); }, { focused });
108
+ usePaneRefreshKey(() => { resource.reload(); if (tab === "screen") screen.reload(); }, { focused });
109
109
  const currentError = tab === "screen" ? screen.error : resource.error;
110
110
  const available = tab === "screen" ? !!screenData : !!data;
111
111
  const loading = tab === "screen" ? screen.loading : resource.loading;
@@ -33,7 +33,7 @@ import {
33
33
  type DefiRow,
34
34
  type DefiSortPreference,
35
35
  } from "./defi";
36
- import { formatCryptoPercent } from "./model";
36
+ import { formatCryptoPercent, utcCloseAsOfText } from "./model";
37
37
  import { SUPPLY_RANGES, type SupplyRangeId } from "./supply";
38
38
 
39
39
  const RANGE_OPTIONS = SUPPLY_RANGES.map(({ value, label }) => ({ value, label }));
@@ -143,7 +143,7 @@ export function DefiTvlView({
143
143
  if (!payload || !total) return [];
144
144
  const since = defiHistoryStart(payload);
145
145
  return [
146
- { id: "total", label: "Total DeFi TVL", value: formatTvl(total.tvl), ...(payload.asOf ? { detail: `as of ${payload.asOf}` } : {}) },
146
+ { id: "total", label: "Total DeFi TVL", value: formatTvl(total.tvl), ...(payload.asOf ? { detail: utcCloseAsOfText(payload.asOf) } : {}) },
147
147
  changeFigure("change-7d", "7D change", total.change7d, total.change7dPercent),
148
148
  changeFigure("change-30d", "30D change", total.change30d, total.change30dPercent),
149
149
  { id: "source", label: "Source", value: payload.source.name, ...(since ? { detail: `daily since ${since}` } : {}) },
@@ -4,7 +4,7 @@ import { getTableWidth } from "../../../components/ui/table-layout";
4
4
  import { formatCompact, formatCompactAmount } from "../../../utils/format";
5
5
  import { compareSortValues, nextHeaderSort, type SortDirection } from "../../../utils/sort-values";
6
6
  import { formatUtcTime } from "../../../utils/utc-time";
7
- import { formatCryptoPercent } from "./model";
7
+ import { formatCryptoPercent, utcCloseAsOfText } from "./model";
8
8
  import { SUPPLY_RANGES, type SupplyRangeId } from "./supply";
9
9
 
10
10
  const DAY_MS = 86_400_000;
@@ -141,9 +141,15 @@ export function defiHistoryRows(payload: DefiTvlPayload): Array<{ date: string;
141
141
  const change = (amount: number | null, percent: number | null) =>
142
142
  amount == null ? "—" : `${formatCompactAmount(amount, { signed: true })} (${formatCryptoPercent(percent)})`;
143
143
 
144
+ /**
145
+ * How the total's days are dated: each by the UTC day it closes, which
146
+ * DefiLlama stamps 00:00 UTC the day after (Gloom's 4 Nov is its 5 Nov).
147
+ */
148
+ export const DEFI_DAY_CONVENTION = "UTC daily closes";
149
+
144
150
  /**
145
151
  * `Total DeFi TVL 92.39B · 7D +2.01B (+2.23%) · 30D -1.06B (-1.14%) · as of
146
- * 2026-10-21 · DefiLlama, daily since 2018-02-12`, as the CLI states it.
152
+ * 2026-10-21 UTC close · DefiLlama, daily since 2018-02-12`, as the CLI states it.
147
153
  */
148
154
  export function defiSummaryLine(payload: DefiTvlPayload): string | null {
149
155
  const total = payload.total;
@@ -153,7 +159,7 @@ export function defiSummaryLine(payload: DefiTvlPayload): string | null {
153
159
  `Total DeFi TVL ${formatCompact(total.tvl, { fixedDecimals: true })}`,
154
160
  `7D ${change(total.change7d, total.change7dPercent)}`,
155
161
  `30D ${change(total.change30d, total.change30dPercent)}`,
156
- ...(payload.asOf ? [`as of ${payload.asOf}`] : []),
162
+ ...(payload.asOf ? [utcCloseAsOfText(payload.asOf)] : []),
157
163
  `${payload.source.name}${since ? `, daily since ${since}` : ""}`,
158
164
  ].join(" · ");
159
165
  }
@@ -78,10 +78,10 @@ const STABLECOIN_SUPPLY_COLUMNS: HeadlessPaneColumn[] = [
78
78
  { key: "supplyShare", header: "Share", align: "right", format: share, stackPriority: 0.4, stackRows: 0 },
79
79
  ];
80
80
 
81
- /** Daily supply in USD, oldest first: the total, the charted coins and the rest, for `--csv`. */
82
- function supplyHistoryTable(payload: StablecoinSupplyPayload): HeadlessExportTable | null {
81
+ /** Daily supply in USD, oldest first: the total, the charted coins and the rest, for `--csv`; the newest `limit` days with one. */
82
+ function supplyHistoryTable(payload: StablecoinSupplyPayload, limit: number | null): HeadlessExportTable | null {
83
83
  const layers = stackedSupply(payload, "ALL")?.layers;
84
- const rows = supplyHistoryRows(payload);
84
+ const rows = newestRows(supplyHistoryRows(payload), limit);
85
85
  if (!layers || !rows.length) return null;
86
86
  return {
87
87
  title: "Stablecoin supply",
@@ -183,12 +183,16 @@ function protocolsNote(payload: DefiTvlPayload): string {
183
183
  return `Protocols as of ${isoMinute(payload.protocolsAsOf)}, the source's latest; their versions are counted together.`;
184
184
  }
185
185
 
186
- /** The other list and the total's daily history, for `--csv`: one file carries the whole tab. */
187
- function defiExportTables(payload: DefiTvlPayload, list: DefiList): HeadlessExportTable[] {
186
+ /**
187
+ * The other list and the total's daily history, for `--csv`: one file carries
188
+ * the whole tab, each table capped by `--limit` as the list is (the history's
189
+ * newest days).
190
+ */
191
+ function defiExportTables(payload: DefiTvlPayload, list: DefiList, limit: number | null): HeadlessExportTable[] {
188
192
  const other: DefiList = list === "chain" ? "protocol" : "chain";
189
193
  const income = defiHasIncome(payload);
190
- const otherRows = buildDefiRows(payload, other).map((row) => defiRecord(row, other, income));
191
- const history = defiHistoryRows(payload);
194
+ const otherRows = limitRows(buildDefiRows(payload, other).map((row) => defiRecord(row, other, income)), limit);
195
+ const history = newestRows(defiHistoryRows(payload), limit);
192
196
  return [
193
197
  ...(otherRows.length ? [{ title: other === "chain" ? "DeFi TVL by chain" : "DeFi TVL by protocol", unit: "USD", columns: defiColumns(other, income), rows: otherRows }] : []),
194
198
  ...(history.length ? [{
@@ -214,7 +218,7 @@ async function loadDefi(list: DefiList, limit: number | null, ctx: Parameters<He
214
218
  const income = defiHasIncome(payload);
215
219
  const rows = limitRows(buildDefiRows(payload, list).map((row) => defiRecord(row, list, income)), limit);
216
220
  const summary = defiSummaryLine(payload);
217
- const exportTables = defiExportTables(payload, list);
221
+ const exportTables = defiExportTables(payload, list, limit);
218
222
  return {
219
223
  rows,
220
224
  columns: defiColumns(list, income),
@@ -266,6 +270,11 @@ function limitRows<T>(rows: T[], limit: number | null): T[] {
266
270
  return limit == null ? rows : rows.slice(0, limit);
267
271
  }
268
272
 
273
+ /** A history's newest `limit` rows, still oldest first; every row without one. */
274
+ function newestRows<T>(rows: T[], limit: number | null): T[] {
275
+ return limit == null ? rows : rows.slice(-limit);
276
+ }
277
+
269
278
  /** The board's lists, as `--list` and the word after CRYP name them. */
270
279
  const CRYPTO_LISTS = [
271
280
  { value: "coin", aliases: ["coins"] },
@@ -327,7 +336,7 @@ export const cryptoBoardHeadless: HeadlessPaneDefinition<"rows"> = {
327
336
  }, {
328
337
  key: "limit",
329
338
  shot: REPORT_ROWS,
330
- description: "Rows to list, in the list's order: every row unless given.",
339
+ description: "Rows to list, in the list's order, and of each table --csv adds (a history's newest days): every row unless given.",
331
340
  type: "integer",
332
341
  minimum: 1,
333
342
  maximum: 1000,
@@ -419,7 +428,7 @@ export const cryptoBoardHeadless: HeadlessPaneDefinition<"rows"> = {
419
428
  const capNote = data.marketCapBasis === "circulating" ? ["Market cap is price times circulating supply."] : [];
420
429
  if (kind !== "stablecoin") return { rows, errors: data.warnings, ...(capNote.length ? { notes: capNote } : {}), metadata };
421
430
  const summary = supply ? supplySummaryLine(supply) : null;
422
- const history = supply ? supplyHistoryTable(supply) : null;
431
+ const history = supply ? supplyHistoryTable(supply, limit) : null;
423
432
  // A supply outage is a caveat, not a failure: the prices are the report, and they are complete.
424
433
  const notes = [
425
434
  // A coin with a supply is valued on it, so its row counts one supply.
@@ -377,6 +377,14 @@ export function formatCryptoPercent(value: number | null): string {
377
377
  return `${value > 0 ? "+" : ""}${text}%`;
378
378
  }
379
379
 
380
+ /**
381
+ * "as of 2026-10-21 UTC close": a daily total's newest day, which is that UTC
382
+ * day's close. The DeFi and stablecoin tabs date theirs the same way.
383
+ */
384
+ export function utcCloseAsOfText(asOf: string): string {
385
+ return `as of ${asOf} UTC close`;
386
+ }
387
+
380
388
  // Sorting ---------------------------------------------------------------------
381
389
 
382
390
  type CryptoColumnId =
@@ -62,8 +62,11 @@ import {
62
62
  type CryptoRow,
63
63
  type CryptoSortPreference,
64
64
  type CryptoTab,
65
+ utcCloseAsOfText,
65
66
  } from "./model";
66
- import { stackedSupply, SUPPLY_RANGES, supplyByCode, supplyFailure, type SupplyRangeId } from "./supply";
67
+ import {
68
+ STABLECOIN_SUPPLY_PUBLISHER, stackedSupply, SUPPLY_RANGES, supplyByCode, supplyFailure, supplyHistoryStart, type SupplyRangeId,
69
+ } from "./supply";
67
70
 
68
71
  /**
69
72
  * The board is the price for every row without a live stream: coins the live
@@ -262,7 +265,7 @@ export function CryptoBoardPane({ width, height, focused }: PaneProps) {
262
265
  const boardRefreshMs = allStreamedLive ? CRYPTO_BOARD_STREAMING_REFRESH_MS : CRYPTO_BOARD_REFRESH_MS;
263
266
  useEffect(() => {
264
267
  if (!paneVisible || defi) return;
265
- const timer = setInterval(() => void reloadBoard(false), boardRefreshMs);
268
+ const timer = setInterval(() => reloadBoard(false), boardRefreshMs);
266
269
  return () => clearInterval(timer);
267
270
  }, [boardRefreshMs, defi, paneVisible, reloadBoard]);
268
271
  useEffect(() => {
@@ -299,10 +302,13 @@ export function CryptoBoardPane({ width, height, focused }: PaneProps) {
299
302
  const supplyFigures = useMemo<StatItem[]>(() => {
300
303
  const total = supply?.total;
301
304
  if (!stablecoins || !total) return [];
305
+ const since = supplyHistoryStart(supply);
302
306
  return [
303
- { id: "total", label: "Total supply", value: formatSupply(total.supply), ...(supply.asOf ? { detail: `as of ${supply.asOf}` } : {}) },
307
+ { id: "total", label: "Total supply", value: formatSupply(total.supply), ...(supply.asOf ? { detail: utcCloseAsOfText(supply.asOf) } : {}) },
304
308
  supplyChangeFigure("change-7d", "7D change", total.change7d, total.change7dPercent),
305
309
  supplyChangeFigure("change-30d", "30D change", total.change30d, total.change30dPercent),
310
+ // Its publisher and where the count starts, as the DeFi tab's source says them: ALL draws from that day's few coins.
311
+ { id: "source", label: "Source", value: STABLECOIN_SUPPLY_PUBLISHER, ...(since ? { detail: `daily since ${since}` } : {}) },
306
312
  ];
307
313
  }, [stablecoins, supply]);
308
314
  const supplyError = !supply && supplyResource.error ? supplyResource.error : null;
@@ -354,8 +360,8 @@ export function CryptoBoardPane({ width, height, focused }: PaneProps) {
354
360
  const renderCell = useCallback((row: CryptoRow, column: CryptoColumn) => renderCryptoCell(row, column, logos), [logos]);
355
361
  const handleKeyDown = useCallback((event: DataTableKeyEvent) => (
356
362
  handleRefreshKey(event, () => {
357
- void resource.reload();
358
- if (stablecoins) void reloadSupply();
363
+ resource.reload();
364
+ if (stablecoins) reloadSupply();
359
365
  }, { stopPropagation: true })
360
366
  ), [reloadSupply, resource.reload, stablecoins]);
361
367
 
@@ -1,6 +1,8 @@
1
1
  import type { SeriesDefinition, SeriesPoint } from "../../../series/types";
2
2
  import { cachedSeriesNote } from "../shared/series-warning";
3
3
  import { loadDefiTvl, loadStablecoinSupply, loadStablecoinSupplyHistory } from "./client";
4
+ import { DEFI_DAY_CONVENTION } from "./defi";
5
+ import { STABLECOIN_SUPPLY_PUBLISHER } from "./supply";
4
6
  import { BITCOIN_NETWORK_SERIES } from "./bitcoin-network";
5
7
 
6
8
  const DAY_MS = 86_400_000;
@@ -16,6 +18,11 @@ function stablecoinSymbol(ticker: string): string {
16
18
  return ticker.trim().toUpperCase().split(/[-/]/)[0] ?? ticker;
17
19
  }
18
20
 
21
+ /** What a chart of a supply cites: its publisher, each day dated as the DeFi total's, by the UTC day it closes. */
22
+ const STABLECOIN_SUPPLY_ATTRIBUTION = {
23
+ source: `${STABLECOIN_SUPPLY_PUBLISHER} stablecoin supply, ${DEFI_DAY_CONVENTION}`, publisher: STABLECOIN_SUPPLY_PUBLISHER,
24
+ } as const;
25
+
19
26
  /** Total stablecoin supply and any listed coin's, as CRYP's stablecoin list shows them. */
20
27
  const STABLECOIN_SUPPLY_SERIES: readonly SeriesDefinition[] = [
21
28
  {
@@ -26,11 +33,12 @@ const STABLECOIN_SUPPLY_SERIES: readonly SeriesDefinition[] = [
26
33
  group: "Crypto",
27
34
  tags: ["stablecoin", "stablecoins", "supply", "USDT", "USDC", "liquidity"],
28
35
  description: "Total supply of all stablecoins, valued in USD, daily since 2017, as CRYP's stablecoin list totals it.",
36
+ publisher: STABLECOIN_SUPPLY_PUBLISHER,
29
37
  load: async () => {
30
38
  const resource = await loadStablecoinSupply();
31
39
  const history = resource.payload.history;
32
40
  if (!history) throw new Error("Stablecoin supply is not available yet.");
33
- return { points: dailyPoints(history.start, history.total), ...cachedSeriesNote(resource) };
41
+ return { points: dailyPoints(history.start, history.total), attribution: STABLECOIN_SUPPLY_ATTRIBUTION, ...cachedSeriesNote(resource) };
34
42
  },
35
43
  },
36
44
  {
@@ -42,15 +50,19 @@ const STABLECOIN_SUPPLY_SERIES: readonly SeriesDefinition[] = [
42
50
  tags: ["stablecoin", "stablecoins", "supply", "circulating"],
43
51
  description: "One stablecoin's supply across chains, valued in USD, daily, for a coin on CRYP's stablecoin list (USDT-USD).",
44
52
  input: "crypto",
53
+ publisher: STABLECOIN_SUPPLY_PUBLISHER,
45
54
  load: async ({ ticker }) => {
46
55
  const resource = await loadStablecoinSupplyHistory(stablecoinSymbol(ticker!));
47
56
  const history = resource.payload.history;
48
57
  if (!history) throw new Error(`${resource.payload.symbol} supply history is not available yet.`);
49
- return { points: dailyPoints(history.start, history.values), ...cachedSeriesNote(resource) };
58
+ return { points: dailyPoints(history.start, history.values), attribution: STABLECOIN_SUPPLY_ATTRIBUTION, ...cachedSeriesNote(resource) };
50
59
  },
51
60
  },
52
61
  ];
53
62
 
63
+ /** What a chart of the total cites: DefiLlama's measure, each day dated by the UTC day it closes. */
64
+ const DEFI_TVL_ATTRIBUTION = { source: `DefiLlama total DeFi TVL, ${DEFI_DAY_CONVENTION}`, publisher: "DefiLlama" } as const;
65
+
54
66
  /** Total value locked in DeFi, as CRYP's DeFi tab charts it. */
55
67
  const DEFI_TVL_SERIES: SeriesDefinition = {
56
68
  id: "crypto:defi-tvl",
@@ -60,11 +72,13 @@ const DEFI_TVL_SERIES: SeriesDefinition = {
60
72
  group: "Crypto",
61
73
  tags: ["defi", "tvl", "total value locked", "on-chain", "protocols", "chains"],
62
74
  description: "Total value locked in DeFi protocols across every chain, valued in USD, daily since 2018, as DefiLlama measures it and CRYP's DeFi tab charts it.",
75
+ publisher: "DefiLlama",
63
76
  load: async () => {
64
77
  const resource = await loadDefiTvl();
65
78
  const history = resource.payload.history;
66
79
  if (!history) throw new Error("DeFi TVL is not available yet.");
67
- return { points: dailyPoints(history.start, history.total), ...cachedSeriesNote(resource) };
80
+ // Each day is that UTC day's close, which DefiLlama stamps 00:00 UTC the day after: the source line says which.
81
+ return { points: dailyPoints(history.start, history.total), attribution: DEFI_TVL_ATTRIBUTION, ...cachedSeriesNote(resource) };
68
82
  },
69
83
  };
70
84
 
@@ -1,6 +1,14 @@
1
1
  import type { StablecoinSupplyCoin, StablecoinSupplyPayload } from "../../../api-client/crypto-markets";
2
2
  import { formatCompact, formatCompactAmount } from "../../../utils/format";
3
- import { formatCryptoPercent, type CryptoRowSupply } from "./model";
3
+ import { formatCryptoPercent, utcCloseAsOfText, type CryptoRowSupply } from "./model";
4
+
5
+ /**
6
+ * Who publishes the supply the service reads: DefiLlama's stablecoin charts,
7
+ * each day that UTC day's close, dated as the DeFi total is. The payload names
8
+ * the service that serves it, so the board names the publisher, as the DeFi
9
+ * tab names its own.
10
+ */
11
+ export const STABLECOIN_SUPPLY_PUBLISHER = "DefiLlama";
4
12
 
5
13
  const DAY_MS = 86_400_000;
6
14
 
@@ -102,18 +110,33 @@ export function supplyHistoryRows(payload: StablecoinSupplyPayload): Array<Recor
102
110
  }));
103
111
  }
104
112
 
105
- /** `Total supply 306.33B · 7D -1.45B (-0.47%) · 30D +1.75B (+0.57%) · as of 2026-10-18`, as the CLI states it. */
113
+ /**
114
+ * The first day of the total's history, `YYYY-MM-DD`: where the count starts
115
+ * (2017-11-28, with a few coins' $110K), which ALL draws from. Null with none.
116
+ */
117
+ export function supplyHistoryStart(payload: StablecoinSupplyPayload | null | undefined): string | null {
118
+ const history = payload?.history;
119
+ const first = history ? history.total.findIndex((value) => value != null) : -1;
120
+ return first < 0 ? null : new Date(Date.parse(`${history!.start}T00:00:00Z`) + first * DAY_MS).toISOString().slice(0, 10);
121
+ }
122
+
123
+ /**
124
+ * `Total supply 306.33B · 7D -1.45B (-0.47%) · 30D +1.75B (+0.57%) · as of 2026-10-18 UTC close · DefiLlama, daily since 2017-11-28`,
125
+ * as the CLI states it and as it states the DeFi total: the start says where the count, and a chart of ALL, begins.
126
+ */
106
127
  export function supplySummaryLine(payload: StablecoinSupplyPayload): string | null {
107
128
  const total = payload.total;
108
129
  if (!total) return null;
109
130
  const change = (amount: number | null, percent: number | null) => (
110
131
  amount == null ? "—" : `${formatCompactAmount(amount, { signed: true })} (${formatCryptoPercent(percent)})`
111
132
  );
133
+ const since = supplyHistoryStart(payload);
112
134
  return [
113
135
  `Total supply ${formatCompact(total.supply, { fixedDecimals: true })}`,
114
136
  `7D ${change(total.change7d, total.change7dPercent)}`,
115
137
  `30D ${change(total.change30d, total.change30dPercent)}`,
116
- ...(payload.asOf ? [`as of ${payload.asOf}`] : []),
138
+ ...(payload.asOf ? [utcCloseAsOfText(payload.asOf)] : []),
139
+ `${STABLECOIN_SUPPLY_PUBLISHER}${since ? `, daily since ${since}` : ""}`,
117
140
  ].join(" · ");
118
141
  }
119
142