gloomberb 0.20.6 → 0.20.8

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 (639) 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 +41 -7
  16. package/src/api-client/futures-curve.ts +14 -1
  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 +11 -4
  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/architecture/shortcut-labels-allowlist.json +1 -0
  34. package/src/capabilities/asset-data-inputs.ts +183 -0
  35. package/src/capabilities/factories.ts +8 -2
  36. package/src/cli/base-converter.ts +36 -2
  37. package/src/cli/commands/api.ts +2 -2
  38. package/src/cli/commands/command-utils.ts +18 -0
  39. package/src/cli/commands/hong-kong-movers.ts +50 -0
  40. package/src/cli/commands/market.ts +568 -143
  41. package/src/cli/commands/options-chain.ts +7 -1
  42. package/src/cli/commands/overview.ts +74 -14
  43. package/src/cli/commands/plugins.ts +7 -6
  44. package/src/cli/commands/search.ts +71 -12
  45. package/src/cli/commands/system.ts +15 -10
  46. package/src/cli/commands/ticker.ts +97 -44
  47. package/src/cli/content-figures.ts +45 -0
  48. package/src/cli/context.ts +5 -0
  49. package/src/cli/desktop-pane-shot-routes.ts +13 -4
  50. package/src/cli/desktop-pane-shot.ts +147 -12
  51. package/src/cli/earnings-calendar.ts +36 -5
  52. package/src/cli/export-source.ts +17 -3
  53. package/src/cli/fx-pair.ts +111 -11
  54. package/src/cli/glossary.ts +36 -2
  55. package/src/cli/help.ts +1 -1
  56. package/src/cli/history-export.ts +29 -11
  57. package/src/cli/history-rows.ts +130 -21
  58. package/src/cli/index.ts +8 -5
  59. package/src/cli/known-gaps.ts +45 -1
  60. package/src/cli/listing-arg.ts +366 -19
  61. package/src/cli/pane-functions/capabilities.ts +2 -2
  62. package/src/cli/pane-functions/catalog.ts +105 -9
  63. package/src/cli/pane-functions/discovery.ts +2 -0
  64. package/src/cli/pane-functions/dom.ts +50 -13
  65. package/src/cli/pane-functions/freshness.ts +45 -8
  66. package/src/cli/pane-functions/function-help.ts +9 -6
  67. package/src/cli/pane-functions/headless.ts +77 -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 +98 -7
  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 +106 -3
  77. package/src/cli/registry.ts +42 -4
  78. package/src/cli/report-tables.ts +26 -6
  79. package/src/cli/result.ts +30 -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/ticker-resolution.ts +3 -2
  84. package/src/cli/unknown-command.ts +111 -14
  85. package/src/components/chart/composite/format.ts +15 -1
  86. package/src/components/chart/composite/legend.tsx +101 -47
  87. package/src/components/chart/composite/panel-labels.ts +4 -4
  88. package/src/components/chart/composite/panel-surface.tsx +4 -6
  89. package/src/components/chart/composite/scene/build.ts +180 -0
  90. package/src/components/chart/composite/scene/cursor.ts +226 -0
  91. package/src/components/chart/composite/scene/domain.ts +170 -0
  92. package/src/components/chart/composite/scene/markers.ts +115 -0
  93. package/src/components/chart/composite/scene/panels.ts +85 -0
  94. package/src/components/chart/composite/scene/points.ts +169 -0
  95. package/src/components/chart/composite/scene/projection.ts +105 -0
  96. package/src/components/chart/composite/scene/timeline.ts +71 -0
  97. package/src/components/chart/composite/scene.ts +12 -1066
  98. package/src/components/chart/composite/types.ts +4 -2
  99. package/src/components/chart/curve/model.ts +2 -2
  100. package/src/components/chart-table/axis.ts +18 -6
  101. package/src/components/command-bar/layout-items/focused-pane.ts +3 -0
  102. package/src/components/command-bar/list/model.ts +9 -0
  103. package/src/components/command-bar/pane-templates/items.ts +61 -15
  104. package/src/components/command-bar/pane-templates/workflow.ts +16 -5
  105. package/src/components/command-bar/routes/root/plugin-install.ts +7 -46
  106. package/src/components/command-bar/routes/root/provider-search.ts +8 -5
  107. package/src/components/command-bar/routes/root/results.ts +6 -1
  108. package/src/components/command-bar/routes/root/runtime.ts +1 -0
  109. package/src/components/command-bar/routes/root/shortcut-feedback.ts +4 -1
  110. package/src/components/command-bar/routes/ticker-search/actions.ts +7 -5
  111. package/src/components/command-bar/routes/ticker-search/results.ts +51 -3
  112. package/src/components/command-bar/view-model.ts +12 -0
  113. package/src/components/command-bar/workflow/ops.ts +21 -4
  114. package/src/components/command-bar/workflow/ticker-listing-picker.ts +3 -1
  115. package/src/components/command-bar/workflow/tickers.ts +6 -2
  116. package/src/components/data-table/view.tsx +46 -1
  117. package/src/components/form-modal/confirm.tsx +3 -2
  118. package/src/components/form-modal/content.tsx +3 -2
  119. package/src/components/form-modal/field-row.tsx +2 -0
  120. package/src/components/form-modal/host.tsx +18 -3
  121. package/src/components/form-modal/remote-reads.test-helpers.ts +34 -0
  122. package/src/components/index.ts +1 -1
  123. package/src/components/layout/pane/title.ts +21 -5
  124. package/src/components/layout/shell/pane/layers.tsx +20 -14
  125. package/src/components/layout/shell/pane-occlusion.ts +21 -0
  126. package/src/components/onboarding/desks-step.tsx +7 -1
  127. package/src/components/onboarding/onboarding-keyboard.ts +48 -6
  128. package/src/components/onboarding/onboarding-wizard.tsx +47 -8
  129. package/src/components/onboarding/portfolio-step/positions-panel.tsx +17 -3
  130. package/src/components/onboarding/use-onboarding-progress.ts +57 -14
  131. package/src/components/onboarding/wizard-positions.ts +2 -0
  132. package/src/components/paged-rows.ts +11 -5
  133. package/src/components/ticker/list-table-view.tsx +24 -5
  134. package/src/components/toggle-list.tsx +44 -1
  135. package/src/components/ui/data-table/opentui/index.tsx +7 -6
  136. package/src/components/ui/data-table/opentui/model.ts +7 -3
  137. package/src/components/ui/data-table/types.ts +13 -2
  138. package/src/components/ui/fields.tsx +16 -4
  139. package/src/components/ui/query-bar.tsx +43 -9
  140. package/src/components/ui/table-layout.ts +56 -2
  141. package/src/core/app-services.ts +7 -2
  142. package/src/core/connection-health.ts +26 -0
  143. package/src/core/state/app/layout.ts +12 -4
  144. package/src/data/config/layout.ts +3 -1
  145. package/src/data/config/store/node.ts +4 -2
  146. package/src/docs/snapshot.json +794 -215
  147. package/src/i18n/es.ts +6 -1
  148. package/src/i18n/ja.ts +6 -1
  149. package/src/i18n/ko.ts +6 -1
  150. package/src/i18n/zh-cn.ts +6 -1
  151. package/src/i18n/zh-tw.ts +6 -1
  152. package/src/layout/pane-follow.ts +1 -1
  153. package/src/layout/pane-manager/gridlock.ts +18 -5
  154. package/src/layout/pane-manager/index.ts +1 -0
  155. package/src/layout/pane-manager/transient.ts +56 -0
  156. package/src/layout-marketplace/gallery.tsx +2 -1
  157. package/src/layout-marketplace/model.ts +4 -10
  158. package/src/market-data/commodity-names.ts +24 -0
  159. package/src/market-data/connection-follow.ts +9 -7
  160. package/src/market-data/coordinator/auxiliary.ts +4 -3
  161. package/src/market-data/coordinator/entries.ts +22 -1
  162. package/src/market-data/coordinator/financials.ts +2 -3
  163. package/src/market-data/coordinator/index.ts +67 -12
  164. package/src/market-data/coordinator/quotes.ts +2 -3
  165. package/src/market-data/fund-facts.ts +7 -1
  166. package/src/market-data/futures-board.ts +38 -4
  167. package/src/market-data/futures-contract.ts +5 -2
  168. package/src/market-data/fx-closes.ts +4 -1
  169. package/src/market-data/market/bar-period.ts +15 -0
  170. package/src/market-data/market/change-basis.ts +49 -8
  171. package/src/market-data/market/dated-previous-close.ts +133 -10
  172. package/src/market-data/market/format.ts +4 -2
  173. package/src/market-data/market/freshness.ts +22 -6
  174. package/src/market-data/market/status.ts +32 -4
  175. package/src/market-data/options-alternatives.ts +21 -9
  176. package/src/market-data/published-futures-sessions.ts +9 -0
  177. package/src/market-data/published-nse-sessions.ts +16 -1
  178. package/src/market-data/quotes/balance-sheet-rate.ts +34 -0
  179. package/src/market-data/quotes/delisting.ts +26 -2
  180. package/src/market-data/quotes/freshness.ts +77 -0
  181. package/src/market-data/quotes/listing-enterprise-value.ts +250 -19
  182. package/src/market-data/quotes/regular-session-valuation.ts +8 -0
  183. package/src/market-data/realized-volatility.ts +3 -1
  184. package/src/market-data/request-types.ts +2 -0
  185. package/src/market-data/selectors.ts +1 -0
  186. package/src/news/aggregator.ts +3 -3
  187. package/src/plugins/builtin/account-management/delete-account.ts +78 -0
  188. package/src/plugins/builtin/account-management/pane.tsx +22 -19
  189. package/src/plugins/builtin/account-management/password-dialog.tsx +75 -0
  190. package/src/plugins/builtin/alerts/alert-engine.ts +15 -0
  191. package/src/plugins/builtin/alerts/alert-log.ts +3 -2
  192. package/src/plugins/builtin/alerts/cli-forms.ts +1 -1
  193. package/src/plugins/builtin/alerts/cli.ts +94 -13
  194. package/src/plugins/builtin/alerts/format.ts +8 -2
  195. package/src/plugins/builtin/alerts/headless.ts +1 -1
  196. package/src/plugins/builtin/alerts/index.tsx +13 -6
  197. package/src/plugins/builtin/alerts/metric-command.ts +1 -1
  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 +7 -2
  210. package/src/plugins/builtin/backtest/headless.ts +2 -1
  211. package/src/plugins/builtin/backtest/pane.tsx +4 -2
  212. package/src/plugins/builtin/bond-calculator/pane.tsx +1 -1
  213. package/src/plugins/builtin/broker-manager/sign-in-end.ts +1 -1
  214. package/src/plugins/builtin/broker-trading/orders.tsx +2 -2
  215. package/src/plugins/builtin/buildout/company/pane.tsx +1 -1
  216. package/src/plugins/builtin/buildout/model/index.ts +2 -2
  217. package/src/plugins/builtin/catalysts/headless.ts +9 -6
  218. package/src/plugins/builtin/catalysts/model.ts +72 -10
  219. package/src/plugins/builtin/catalysts/pane.tsx +10 -7
  220. package/src/plugins/builtin/cds/pane.tsx +5 -3
  221. package/src/plugins/builtin/central-bank-rates/pane.tsx +3 -2
  222. package/src/plugins/builtin/chart-composer/catalog-series.ts +59 -0
  223. package/src/plugins/builtin/chart-composer/headless-schema.ts +2 -1
  224. package/src/plugins/builtin/chart-composer/headless.ts +104 -23
  225. package/src/plugins/builtin/chart-composer/index.tsx +6 -3
  226. package/src/plugins/builtin/chart-composer/legend-names.ts +19 -0
  227. package/src/plugins/builtin/chart-composer/pane.tsx +37 -10
  228. package/src/plugins/builtin/chart-composer/presets.ts +63 -6
  229. package/src/plugins/builtin/chart-composer/roll-events.ts +38 -0
  230. package/src/plugins/builtin/chart-composer/series-catalog.ts +12 -5
  231. package/src/plugins/builtin/chart-composer/series-expression.ts +8 -4
  232. package/src/plugins/builtin/chart-composer/series-listings.ts +33 -9
  233. package/src/plugins/builtin/chart-composer/use-series-catalog.ts +2 -2
  234. package/src/plugins/builtin/clinical-trials/client.ts +13 -0
  235. package/src/plugins/builtin/clinical-trials/index.tsx +1 -1
  236. package/src/plugins/builtin/clinical-trials/pane.tsx +77 -27
  237. package/src/plugins/builtin/clinical-trials/search.ts +117 -0
  238. package/src/plugins/builtin/cloud/askg/conversation-store.ts +17 -6
  239. package/src/plugins/builtin/cloud/askg/lock-note.ts +4 -2
  240. package/src/plugins/builtin/cloud/askg/manifest.ts +3 -2
  241. package/src/plugins/builtin/cloud/askg/pane.tsx +2 -2
  242. package/src/plugins/builtin/cloud/askg/sources.ts +3 -3
  243. package/src/plugins/builtin/cloud/one-tap/one-tap-prompt.tsx +7 -3
  244. package/src/plugins/builtin/cloud/team/acm-tab.tsx +1 -1
  245. package/src/plugins/builtin/cloud/team/pane.tsx +17 -10
  246. package/src/plugins/builtin/cloud/team/views.ts +15 -3
  247. package/src/plugins/builtin/cloud/terminal-relay/redact.ts +105 -16
  248. package/src/plugins/builtin/cloud/thesis/board-pane.tsx +17 -2
  249. package/src/plugins/builtin/cloud/thesis/module.tsx +3 -2
  250. package/src/plugins/builtin/cloud/thesis/store.ts +17 -3
  251. package/src/plugins/builtin/commodities-energy/index.tsx +35 -3
  252. package/src/plugins/builtin/commodity-balances/index.tsx +1 -1
  253. package/src/plugins/builtin/company-attention/app-rank.tsx +1 -1
  254. package/src/plugins/builtin/company-attention/building.tsx +1 -1
  255. package/src/plugins/builtin/company-attention/model.ts +2 -1
  256. package/src/plugins/builtin/company-attention/moves.tsx +1 -1
  257. package/src/plugins/builtin/company-attention/pane.tsx +1 -1
  258. package/src/plugins/builtin/company-attention/signals.tsx +1 -1
  259. package/src/plugins/builtin/company-kpis/pane.tsx +1 -1
  260. package/src/plugins/builtin/correlation/headless.ts +7 -5
  261. package/src/plugins/builtin/correlation/history.ts +17 -6
  262. package/src/plugins/builtin/correlation/index.tsx +1 -1
  263. package/src/plugins/builtin/correlation/relationship/history.ts +1 -1
  264. package/src/plugins/builtin/correlation/relationship/pane.tsx +1 -1
  265. package/src/plugins/builtin/cot/headless.ts +10 -3
  266. package/src/plugins/builtin/cot/pane.tsx +2 -2
  267. package/src/plugins/builtin/cpi/pane.tsx +1 -1
  268. package/src/plugins/builtin/credit-boards/model.ts +1 -1
  269. package/src/plugins/builtin/credit-documents/pane.tsx +1 -1
  270. package/src/plugins/builtin/crypto-board/defi-view.tsx +2 -2
  271. package/src/plugins/builtin/crypto-board/defi.ts +9 -3
  272. package/src/plugins/builtin/crypto-board/headless.ts +19 -10
  273. package/src/plugins/builtin/crypto-board/model.ts +8 -0
  274. package/src/plugins/builtin/crypto-board/pane.tsx +11 -5
  275. package/src/plugins/builtin/crypto-board/series.ts +17 -3
  276. package/src/plugins/builtin/crypto-board/supply.ts +26 -3
  277. package/src/plugins/builtin/crypto-etf-flows/headless.ts +3 -2
  278. package/src/plugins/builtin/crypto-etf-flows/model.ts +13 -3
  279. package/src/plugins/builtin/crypto-etf-flows/pane.tsx +6 -3
  280. package/src/plugins/builtin/custom-view/pane.tsx +5 -5
  281. package/src/plugins/builtin/debt-maturities/client.ts +5 -0
  282. package/src/plugins/builtin/debt-maturities/headless.ts +3 -1
  283. package/src/plugins/builtin/debt-maturities/model.ts +1 -0
  284. package/src/plugins/builtin/debt-maturities/pane.tsx +1 -1
  285. package/src/plugins/builtin/dividend-yield/pane.tsx +1 -1
  286. package/src/plugins/builtin/doe/model.ts +1 -1
  287. package/src/plugins/builtin/doe/pane.tsx +1 -1
  288. package/src/plugins/builtin/earnings/board.tsx +2 -2
  289. package/src/plugins/builtin/earnings/history.tsx +1 -1
  290. package/src/plugins/builtin/earnings-calls/calendar.tsx +1 -1
  291. package/src/plugins/builtin/earnings-calls/data.ts +2 -1
  292. package/src/plugins/builtin/earnings-calls/headless.ts +15 -0
  293. package/src/plugins/builtin/earnings-calls/model.ts +68 -8
  294. package/src/plugins/builtin/earnings-calls/pane.tsx +29 -8
  295. package/src/plugins/builtin/earnings-calls/transcript-view.tsx +32 -2
  296. package/src/plugins/builtin/earnings-ripple/pane.tsx +1 -1
  297. package/src/plugins/builtin/econ/calendar-model.ts +94 -2
  298. package/src/plugins/builtin/econ/detail-view.tsx +15 -11
  299. package/src/plugins/builtin/econ/index.tsx +25 -9
  300. package/src/plugins/builtin/econ/types.ts +4 -1
  301. package/src/plugins/builtin/equity-screener/headless.ts +23 -7
  302. package/src/plugins/builtin/equity-screener/index.tsx +3 -0
  303. package/src/plugins/builtin/equity-screener/live.ts +39 -12
  304. package/src/plugins/builtin/equity-screener/model.ts +86 -5
  305. package/src/plugins/builtin/equity-screener/pane.tsx +20 -21
  306. package/src/plugins/builtin/equity-screener/results.ts +12 -3
  307. package/src/plugins/builtin/equity-screener/ticker-check.tsx +2 -2
  308. package/src/plugins/builtin/estimate-revisions/pane.tsx +2 -2
  309. package/src/plugins/builtin/executives/pane.tsx +2 -2
  310. package/src/plugins/builtin/exposure/pane.tsx +1 -1
  311. package/src/plugins/builtin/fear-greed/data.ts +3 -1
  312. package/src/plugins/builtin/fear-greed/headless.ts +8 -2
  313. package/src/plugins/builtin/fear-greed/pane.tsx +8 -4
  314. package/src/plugins/builtin/filing-events/pane.tsx +1 -1
  315. package/src/plugins/builtin/futures/index.tsx +5 -4
  316. package/src/plugins/builtin/futures/model.ts +17 -9
  317. package/src/plugins/builtin/futures/returns.ts +2 -0
  318. package/src/plugins/builtin/futures/series.ts +44 -8
  319. package/src/plugins/builtin/futures/table.tsx +3 -3
  320. package/src/plugins/builtin/futures-curve/client.ts +1 -0
  321. package/src/plugins/builtin/futures-curve/headless.ts +14 -12
  322. package/src/plugins/builtin/futures-curve/index.tsx +7 -4
  323. package/src/plugins/builtin/futures-curve/model.ts +93 -7
  324. package/src/plugins/builtin/futures-curve/pane.tsx +18 -7
  325. package/src/plugins/builtin/fx-matrix/amount.ts +2 -1
  326. package/src/plugins/builtin/fx-matrix/index.tsx +9 -0
  327. package/src/plugins/builtin/gpu/changes.tsx +1 -1
  328. package/src/plugins/builtin/gpu/equities.tsx +1 -1
  329. package/src/plugins/builtin/gpu/pane.tsx +2 -2
  330. package/src/plugins/builtin/help/function-card.tsx +4 -2
  331. package/src/plugins/builtin/help/function-index.ts +12 -6
  332. package/src/plugins/builtin/help/index.tsx +1 -1
  333. package/src/plugins/builtin/holders/beneficial-view.tsx +1 -1
  334. package/src/plugins/builtin/holders/fund-holders.ts +22 -1
  335. package/src/plugins/builtin/holders/headless.ts +5 -4
  336. package/src/plugins/builtin/holders/pane.tsx +8 -4
  337. package/src/plugins/builtin/holders/report-header.ts +23 -0
  338. package/src/plugins/builtin/insider/base-values.ts +55 -0
  339. package/src/plugins/builtin/insider/headless.ts +307 -83
  340. package/src/plugins/builtin/insider/index.tsx +65 -23
  341. package/src/plugins/builtin/insider/insiders.tsx +26 -16
  342. package/src/plugins/builtin/insider/model.ts +2 -2
  343. package/src/plugins/builtin/insider/signals-cells.tsx +4 -1
  344. package/src/plugins/builtin/insider/signals-model.ts +13 -5
  345. package/src/plugins/builtin/insider/signals.tsx +5 -3
  346. package/src/plugins/builtin/insider/tickers.tsx +466 -0
  347. package/src/plugins/builtin/ipo-calendar/pane.tsx +1 -1
  348. package/src/plugins/builtin/iv-history/client.ts +35 -4
  349. package/src/plugins/builtin/iv-history/headless.ts +10 -4
  350. package/src/plugins/builtin/iv-history/model.ts +85 -16
  351. package/src/plugins/builtin/iv-history/pane.tsx +2 -2
  352. package/src/plugins/builtin/iv-history/screen-pane.tsx +6 -3
  353. package/src/plugins/builtin/jobs/pane.tsx +5 -5
  354. package/src/plugins/builtin/macro-day/pane.tsx +1 -1
  355. package/src/plugins/builtin/macro-day/release-table.ts +5 -5
  356. package/src/plugins/builtin/macro-day/releases.ts +11 -9
  357. package/src/plugins/builtin/market-movers/headless.ts +6 -2
  358. package/src/plugins/builtin/market-movers/screener.ts +18 -4
  359. package/src/plugins/builtin/members/breadth-pane.tsx +3 -3
  360. package/src/plugins/builtin/members/client.ts +24 -2
  361. package/src/plugins/builtin/members/headless.ts +68 -9
  362. package/src/plugins/builtin/members/index.tsx +7 -6
  363. package/src/plugins/builtin/members/model.ts +99 -13
  364. package/src/plugins/builtin/members/pane.tsx +72 -20
  365. package/src/plugins/builtin/mna/distress/pane.tsx +2 -1
  366. package/src/plugins/builtin/mna/pane.tsx +1 -1
  367. package/src/plugins/builtin/money-markets/client.ts +43 -15
  368. package/src/plugins/builtin/money-markets/headless.ts +18 -11
  369. package/src/plugins/builtin/money-markets/index.tsx +7 -6
  370. package/src/plugins/builtin/money-markets/model.ts +20 -5
  371. package/src/plugins/builtin/money-markets/pane.tsx +28 -17
  372. package/src/plugins/builtin/news/wire/news/footer.ts +11 -1
  373. package/src/plugins/builtin/news/wire/news/table.tsx +15 -5
  374. package/src/plugins/builtin/notes/headless.ts +94 -0
  375. package/src/plugins/builtin/notes/index.tsx +3 -1
  376. package/src/plugins/builtin/notes/store.ts +10 -3
  377. package/src/plugins/builtin/options/footer.ts +8 -2
  378. package/src/plugins/builtin/options/open-interest-as-of.ts +12 -3
  379. package/src/plugins/builtin/options/view.tsx +10 -1
  380. package/src/plugins/builtin/options-calculator/pane.tsx +1 -1
  381. package/src/plugins/builtin/options-positioning/client.ts +35 -8
  382. package/src/plugins/builtin/options-positioning/headless.ts +17 -7
  383. package/src/plugins/builtin/options-positioning/index.tsx +10 -0
  384. package/src/plugins/builtin/options-positioning/pane.tsx +16 -7
  385. package/src/plugins/builtin/options-scenario/csp-screen-pane.tsx +1 -1
  386. package/src/plugins/builtin/options-scenario/pane.tsx +1 -1
  387. package/src/plugins/builtin/pe-band/pane.tsx +2 -2
  388. package/src/plugins/builtin/perps/cascade-tabs.tsx +2 -2
  389. package/src/plugins/builtin/perps/client.ts +54 -15
  390. package/src/plugins/builtin/perps/headless.ts +39 -13
  391. package/src/plugins/builtin/perps/index.tsx +2 -1
  392. package/src/plugins/builtin/perps/model.ts +43 -1
  393. package/src/plugins/builtin/perps/pane.tsx +35 -18
  394. package/src/plugins/builtin/portfolio-list/allocation-rows.ts +74 -0
  395. package/src/plugins/builtin/portfolio-list/cell-version.ts +1 -0
  396. package/src/plugins/builtin/portfolio-list/cli/period-report.ts +7 -3
  397. package/src/plugins/builtin/portfolio-list/cli/portfolio-command.ts +37 -4
  398. package/src/plugins/builtin/portfolio-list/cli/render.ts +214 -46
  399. package/src/plugins/builtin/portfolio-list/headless.ts +32 -10
  400. package/src/plugins/builtin/portfolio-list/income.ts +63 -30
  401. package/src/plugins/builtin/portfolio-list/index.tsx +4 -4
  402. package/src/plugins/builtin/portfolio-list/pane/data.ts +16 -6
  403. package/src/plugins/builtin/portfolio-list/pane/fx-day-moves.ts +52 -0
  404. package/src/plugins/builtin/portfolio-list/pane/index.tsx +81 -13
  405. package/src/plugins/builtin/portfolio-list/pane/target-weights.tsx +178 -0
  406. package/src/plugins/builtin/portfolio-list/period-pnl.ts +44 -5
  407. package/src/plugins/builtin/portfolio-list/settings.ts +12 -6
  408. package/src/plugins/builtin/portfolio-list/summary/index.tsx +9 -4
  409. package/src/plugins/builtin/portfolio-list/summary/totals.ts +21 -2
  410. package/src/plugins/builtin/portfolio-list/table.tsx +33 -25
  411. package/src/plugins/builtin/portfolio-list/use-throttled-ticker-order.ts +40 -3
  412. package/src/plugins/builtin/power/gas.tsx +2 -2
  413. package/src/plugins/builtin/power/prices.tsx +2 -2
  414. package/src/plugins/builtin/primary-dealers/pane.tsx +10 -11
  415. package/src/plugins/builtin/rate-path/model.ts +9 -0
  416. package/src/plugins/builtin/rate-path/pane.tsx +6 -5
  417. package/src/plugins/builtin/realized-vol/fx-proxy.ts +27 -0
  418. package/src/plugins/builtin/realized-vol/headless.ts +8 -6
  419. package/src/plugins/builtin/realized-vol/pane.tsx +13 -7
  420. package/src/plugins/builtin/relative-rotation/pane.tsx +1 -1
  421. package/src/plugins/builtin/research/analyst-headless.ts +5 -1
  422. package/src/plugins/builtin/research/analyst-model.ts +7 -1
  423. package/src/plugins/builtin/research/analyst-pane.tsx +1 -1
  424. package/src/plugins/builtin/research/relative-valuation-basis.ts +44 -4
  425. package/src/plugins/builtin/research/relative-valuation-headless.ts +59 -14
  426. package/src/plugins/builtin/research/relative-valuation-model.ts +65 -26
  427. package/src/plugins/builtin/research/relative-valuation-pane.tsx +42 -17
  428. package/src/plugins/builtin/revenue-breakdown/pane.tsx +1 -1
  429. package/src/plugins/builtin/reverse-dcf/client.ts +34 -4
  430. package/src/plugins/builtin/reverse-dcf/headless.ts +30 -15
  431. package/src/plugins/builtin/reverse-dcf/model.ts +190 -29
  432. package/src/plugins/builtin/reverse-dcf/pane.tsx +35 -13
  433. package/src/plugins/builtin/risk-factors/pane.tsx +2 -2
  434. package/src/plugins/builtin/roadmap/pane.tsx +2 -2
  435. package/src/plugins/builtin/scanner/flow-pane.tsx +4 -4
  436. package/src/plugins/builtin/scanner/headless.ts +15 -1
  437. package/src/plugins/builtin/seasonality/pane.tsx +1 -1
  438. package/src/plugins/builtin/sec/fund-facts-view.tsx +5 -2
  439. package/src/plugins/builtin/sec/fund-facts.ts +66 -6
  440. package/src/plugins/builtin/sec/headless.ts +8 -4
  441. package/src/plugins/builtin/sec/index.tsx +41 -13
  442. package/src/plugins/builtin/shared/report-freshness.ts +15 -6
  443. package/src/plugins/builtin/shared/ticker-company.ts +111 -0
  444. package/src/plugins/builtin/shared/use-quote-board.ts +37 -2
  445. package/src/plugins/builtin/shared/volatility/live-session.ts +23 -0
  446. package/src/plugins/builtin/shared/volatility-indices.ts +2 -0
  447. package/src/plugins/builtin/short-interest/publications-pane.tsx +1 -1
  448. package/src/plugins/builtin/short-volume/pane.tsx +1 -1
  449. package/src/plugins/builtin/social-mentions/outliers.tsx +3 -3
  450. package/src/plugins/builtin/social-mentions/pane.tsx +2 -2
  451. package/src/plugins/builtin/supply-chain/graph-pane.tsx +1 -1
  452. package/src/plugins/builtin/supply-chain/model.ts +18 -6
  453. package/src/plugins/builtin/supply-chain/pane.tsx +1 -1
  454. package/src/plugins/builtin/themes/pane.tsx +4 -4
  455. package/src/plugins/builtin/thirteenf/api.ts +1 -0
  456. package/src/plugins/builtin/thirteenf/format.ts +5 -0
  457. package/src/plugins/builtin/thirteenf/headless.ts +2 -2
  458. package/src/plugins/builtin/thirteenf/model.ts +128 -5
  459. package/src/plugins/builtin/thirteenf/overlap-pane.tsx +1 -1
  460. package/src/plugins/builtin/thirteenf/report-notes.ts +10 -3
  461. package/src/plugins/builtin/thirteenf/signals-pane.tsx +1 -1
  462. package/src/plugins/builtin/thirteenf/table.ts +2 -2
  463. package/src/plugins/builtin/thirteenf/types.ts +12 -0
  464. package/src/plugins/builtin/ticker-detail/data-panes/historical-prices.tsx +27 -14
  465. package/src/plugins/builtin/ticker-detail/data-panes/returns-history.ts +6 -3
  466. package/src/plugins/builtin/ticker-detail/data-panes/returns-model.ts +14 -0
  467. package/src/plugins/builtin/ticker-detail/data-panes/returns-pane.tsx +4 -1
  468. package/src/plugins/builtin/ticker-detail/financials/aggregation.ts +87 -19
  469. package/src/plugins/builtin/ticker-detail/financials/exchange-results.ts +54 -0
  470. package/src/plugins/builtin/ticker-detail/financials/model.ts +114 -9
  471. package/src/plugins/builtin/ticker-detail/financials/ratios.ts +37 -20
  472. package/src/plugins/builtin/ticker-detail/financials/tab.tsx +42 -19
  473. package/src/plugins/builtin/ticker-detail/headless-schema.ts +3 -2
  474. package/src/plugins/builtin/ticker-detail/headless.ts +90 -31
  475. package/src/plugins/builtin/ticker-detail/overview/model.ts +22 -15
  476. package/src/plugins/builtin/ticker-detail/overview-tab.tsx +5 -2
  477. package/src/plugins/builtin/ticker-detail/quote-monitor/card.tsx +12 -7
  478. package/src/plugins/builtin/ticker-detail/quote-monitor/index.tsx +21 -0
  479. package/src/plugins/builtin/trace-bonds/client.ts +107 -10
  480. package/src/plugins/builtin/trace-bonds/detail.tsx +1 -1
  481. package/src/plugins/builtin/trace-bonds/headless.ts +20 -5
  482. package/src/plugins/builtin/trace-bonds/pane.tsx +15 -4
  483. package/src/plugins/builtin/treasury-auctions/hk-view.tsx +1 -1
  484. package/src/plugins/builtin/treasury-auctions/pane.tsx +1 -1
  485. package/src/plugins/builtin/treasury-daily/pane.tsx +2 -2
  486. package/src/plugins/builtin/vol-surface/charts.tsx +30 -5
  487. package/src/plugins/builtin/vol-surface/client.ts +40 -12
  488. package/src/plugins/builtin/vol-surface/events.ts +213 -0
  489. package/src/plugins/builtin/vol-surface/headless.ts +82 -13
  490. package/src/plugins/builtin/vol-surface/index.tsx +5 -1
  491. package/src/plugins/builtin/vol-surface/model.ts +42 -6
  492. package/src/plugins/builtin/vol-surface/pane.tsx +95 -23
  493. package/src/plugins/builtin/volatility/dvol.ts +14 -2
  494. package/src/plugins/builtin/volatility/headless.ts +3 -2
  495. package/src/plugins/builtin/volatility/index.tsx +1 -1
  496. package/src/plugins/builtin/volatility/pane.tsx +1 -1
  497. package/src/plugins/builtin/volatility/series.ts +7 -3
  498. package/src/plugins/builtin/world-venue-map/activity-series.ts +89 -0
  499. package/src/plugins/builtin/world-venue-map/chokepoint-report.ts +123 -0
  500. package/src/plugins/builtin/world-venue-map/evidence.ts +2 -0
  501. package/src/plugins/builtin/world-venue-map/geo-series.ts +35 -1
  502. package/src/plugins/builtin/world-venue-map/headless.ts +58 -9
  503. package/src/plugins/builtin/world-venue-map/index.ts +6 -3
  504. package/src/plugins/builtin/world-venue-map/layered-pane.tsx +6 -1
  505. package/src/plugins/builtin/world-venue-map/pane.tsx +4 -3
  506. package/src/plugins/builtin/yield-curve/index.tsx +12 -10
  507. package/src/plugins/builtin/yield-curve/swaps.tsx +1 -1
  508. package/src/plugins/extracted-plugins.ts +14 -10
  509. package/src/plugins/installer.ts +17 -1
  510. package/src/plugins/marketplace/feed.ts +14 -0
  511. package/src/plugins/marketplace/install-offer.ts +64 -0
  512. package/src/plugins/registry/contributions.ts +46 -8
  513. package/src/plugins/registry/index.ts +5 -0
  514. package/src/portfolio/collection-name.ts +38 -4
  515. package/src/portfolio/column-values.ts +35 -4
  516. package/src/portfolio/period-pnl.ts +4 -2
  517. package/src/portfolio/valuation-basis.ts +23 -1
  518. package/src/react/async-resource.ts +24 -8
  519. package/src/remote/endpoint.ts +38 -12
  520. package/src/remote/secrets.ts +22 -6
  521. package/src/remote/server.ts +20 -4
  522. package/src/renderers/dom/data-table/index.tsx +2 -1
  523. package/src/renderers/dom/data-table/row.tsx +49 -7
  524. package/src/renderers/dom/desktop/controls.tsx +2 -0
  525. package/src/renderers/dom/desktop/query-bar.tsx +57 -7
  526. package/src/renderers/dom/host/surface-3d.tsx +46 -5
  527. package/src/renderers/dom/styles.css +17 -0
  528. package/src/renderers/electrobun/view/backend-rpc.ts +15 -21
  529. package/src/renderers/electrobun/view/cli-pane-shot-entry.tsx +16 -61
  530. package/src/renderers/electrobun/view/cli-pane-shot-socket.ts +134 -0
  531. package/src/renderers/electrobun/view/host-route.ts +119 -0
  532. package/src/renderers/electrobun/view/rpc-timeout.ts +6 -5
  533. package/src/renderers/opentui/toast-host.tsx +6 -3
  534. package/src/renderers/opentui/ui-host.tsx +29 -5
  535. package/src/series/registry.ts +1 -0
  536. package/src/series/standalone-catalog.ts +40 -0
  537. package/src/series/types.ts +10 -0
  538. package/src/series/validate.ts +5 -0
  539. package/src/shares/portable-layout.ts +2 -7
  540. package/src/sources/gloomberb-cloud/dated-chunks.ts +133 -0
  541. package/src/sources/gloomberb-cloud/index.ts +46 -5
  542. package/src/sources/gloomberb-cloud/news.ts +15 -9
  543. package/src/sources/gloomberb-cloud/normalizers.ts +17 -0
  544. package/src/sources/history-coverage.ts +13 -0
  545. package/src/sources/history-result.ts +1 -0
  546. package/src/sources/provider-errors.ts +9 -0
  547. package/src/sources/provider-router/batches.ts +7 -3
  548. package/src/sources/provider-router/financial-routes.ts +3 -1
  549. package/src/sources/provider-router/history.ts +6 -4
  550. package/src/sources/provider-router/index.ts +5 -1
  551. package/src/sources/provider-router/primary.ts +4 -3
  552. package/src/sources/provider-router/retrieved-at.ts +12 -0
  553. package/src/state/hooks/quote-streaming.ts +14 -6
  554. package/src/team/store.ts +17 -4
  555. package/src/telemetry/crash-reports.ts +3 -1
  556. package/src/test-support/cli-context.ts +3 -2
  557. package/src/test-support/test-env.ts +7 -0
  558. package/src/theme/themes.ts +16 -9
  559. package/src/theme/tone-contrast.ts +29 -5
  560. package/src/tickers/company-name-listing.ts +31 -3
  561. package/src/tickers/company-name.ts +9 -0
  562. package/src/tickers/index-roots.ts +56 -4
  563. package/src/tickers/instrument-kind.ts +22 -1
  564. package/src/tickers/listing-name.ts +7 -2
  565. package/src/tickers/listing-venues.ts +17 -2
  566. package/src/tickers/search/home-listing.ts +2 -0
  567. package/src/tickers/search/index.ts +69 -11
  568. package/src/tickers/search/major-listings.json +595 -592
  569. package/src/tickers/search/ranking.ts +19 -1
  570. package/src/tickers/terminal-codes.ts +20 -6
  571. package/src/time-series/bar-aggregation.ts +3 -2
  572. package/src/time-series/base-series.ts +18 -1
  573. package/src/time-series/chart-data.ts +9 -6
  574. package/src/time-series/chart-seed.ts +11 -3
  575. package/src/time-series/currency-conversion.ts +1 -0
  576. package/src/time-series/date-window.ts +8 -0
  577. package/src/time-series/formula-months.ts +57 -0
  578. package/src/time-series/fundamentals/current-valuation.ts +244 -0
  579. package/src/time-series/fundamentals/historical-valuation.ts +99 -0
  580. package/src/time-series/fundamentals/metric-ids.ts +61 -0
  581. package/src/time-series/fundamentals/period-points.ts +104 -0
  582. package/src/time-series/fundamentals/quarterly-ttm.ts +220 -0
  583. package/src/time-series/fundamentals/series.ts +164 -0
  584. package/src/time-series/fundamentals/source-statements.ts +178 -0
  585. package/src/time-series/fundamentals/statement-fields.ts +154 -0
  586. package/src/time-series/fundamentals/statement-merge.ts +124 -0
  587. package/src/time-series/fundamentals/statement.ts +114 -0
  588. package/src/time-series/fundamentals/valuation-multiples.ts +50 -0
  589. package/src/time-series/fundamentals.ts +18 -1407
  590. package/src/time-series/leverage.ts +12 -4
  591. package/src/time-series/live-bars.ts +12 -7
  592. package/src/time-series/live-quotes.ts +6 -2
  593. package/src/time-series/market.ts +10 -3
  594. package/src/time-series/price-comparison.ts +106 -0
  595. package/src/time-series/range.ts +10 -0
  596. package/src/time-series/resolve-context.ts +7 -2
  597. package/src/time-series/resolve.ts +61 -5
  598. package/src/time-series/series-name.ts +2 -2
  599. package/src/time-series/series-presentation.ts +91 -2
  600. package/src/time-series/session-bar.ts +13 -7
  601. package/src/time-series/spec.ts +21 -2
  602. package/src/time-series/studies/formula.ts +262 -36
  603. package/src/time-series/studies/leverage.ts +9 -3
  604. package/src/time-series/studies/resolve.ts +7 -2
  605. package/src/time-series/types.ts +34 -0
  606. package/src/time-series/use-chart-resolution.ts +18 -1
  607. package/src/types/data-provider.ts +7 -0
  608. package/src/types/financials.ts +112 -1
  609. package/src/types/headless.ts +64 -3
  610. package/src/types/instrument.ts +6 -0
  611. package/src/types/plugin-context.ts +9 -0
  612. package/src/types/plugin-pane-templates.ts +6 -0
  613. package/src/types/plugin-panes.ts +7 -0
  614. package/src/types/price-history.ts +6 -0
  615. package/src/ui/host.tsx +3 -1
  616. package/src/ui/index.tsx +7 -2
  617. package/src/utils/cli-output.ts +21 -1
  618. package/src/utils/currency-units.ts +14 -0
  619. package/src/utils/datetime-format.ts +11 -0
  620. package/src/utils/debug-log.ts +29 -0
  621. package/src/utils/exchange-announcements.ts +26 -3
  622. package/src/utils/exchange-notation.generated.ts +3 -4
  623. package/src/utils/exchange-results.ts +144 -0
  624. package/src/utils/exchanges.ts +10 -0
  625. package/src/utils/financial-statements.ts +212 -22
  626. package/src/utils/fire-and-forget.ts +1 -1
  627. package/src/utils/fiscal-period.ts +41 -3
  628. package/src/utils/format.ts +10 -6
  629. package/src/utils/fundamentals.ts +179 -12
  630. package/src/utils/futures-generic.ts +26 -0
  631. package/src/utils/lease-liabilities.ts +15 -5
  632. package/src/utils/lookup-token.ts +22 -0
  633. package/src/utils/max-drawdown.ts +25 -4
  634. package/src/utils/price-history-integrity.ts +56 -8
  635. package/src/utils/price-history.ts +6 -2
  636. package/src/utils/price-window.ts +38 -2
  637. package/src/utils/replace-file.ts +47 -0
  638. package/src/utils/rpc-timeout-error.ts +16 -2
  639. package/src/utils/untrusted-text.ts +14 -0
@@ -188,7 +188,7 @@ function CorrelationMatrixPane({ focused, width, height }: PaneProps) {
188
188
  const refresh = useCallback(() => {
189
189
  const coordinator = getSharedMarketDataCoordinator();
190
190
  for (const request of chartRequests) void coordinator?.loadChart(request, { forceRefresh: true });
191
- if (geoKey) void geoHistory.reload();
191
+ if (geoKey) geoHistory.reload();
192
192
  }, [chartRequests, geoKey, geoHistory.reload]);
193
193
 
194
194
  useShortcut((event) => {
@@ -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
  }
@@ -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)) {
@@ -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
 
@@ -50,8 +50,9 @@ function summaryLine(payload: CryptoEtfFlowsPayload): string {
50
50
  `Net flows of the US spot ${cryptoEtfFlowAssetLabel(payload.asset).toLowerCase()} ETFs in US$ millions.`,
51
51
  `${summary.latest?.date ?? payload.asOf}: ${formatFlowAmount(summary.latest?.total)}${pending ? ` (${pending})` : ""};`,
52
52
  [
53
- summary.week != null ? `5 days ${formatFlowAmount(summary.week)}` : null,
54
- summary.month != null ? `20 days ${formatFlowAmount(summary.month)}` : null,
53
+ // A day still pending is left out of the rolling sums, which say the day they end on.
54
+ summary.week != null ? `5 days${summary.through ? ` through ${summary.through}` : ""} ${formatFlowAmount(summary.week)}` : null,
55
+ summary.month != null ? `20 days${summary.through ? ` through ${summary.through}` : ""} ${formatFlowAmount(summary.month)}` : null,
55
56
  summary.firstDate ? `since ${summary.firstDate} ${formatFlowAmount(summary.sinceLaunch)}` : null,
56
57
  ].filter(Boolean).join(", ") + ".",
57
58
  ].join(" ");
@@ -63,9 +63,14 @@ export const flowColor = (value: number | null | undefined, colors: { positive:
63
63
 
64
64
  export interface CryptoEtfFlowSummary {
65
65
  latest: CryptoEtfFlowDay | null;
66
- /** Sums of the published daily totals over the newest days listed. */
66
+ /**
67
+ * Sums of the published daily totals over the newest days, from the newest complete one: a day at the
68
+ * newest end still waiting on a fund is left out; an older day still waiting on one is counted as published.
69
+ */
67
70
  week: number | null;
68
71
  month: number | null;
72
+ /** The day those sums end on when newer days are still pending, which they leave out; null when they end on the newest. */
73
+ through: string | null;
69
74
  /** Every listed day's total: the net flow since the first fund launched. */
70
75
  sinceLaunch: number | null;
71
76
  firstDate: string | null;
@@ -78,10 +83,15 @@ const sumTotals = (days: readonly CryptoEtfFlowDay[]) => days.some((day) => day.
78
83
  /** The figures over the table: the newest day, the last 5 and 20 trading days, and since launch. */
79
84
  export function cryptoEtfFlowSummary(payload: CryptoEtfFlowsPayload): CryptoEtfFlowSummary {
80
85
  const days = payload.days;
86
+ // The newest days a fund has not reported yet are not complete days' flows: the rolling sums start at the newest
87
+ // complete day. An older day a fund never reported stays counted, as published, so the window stays 5 and 20 days.
88
+ const first = days.findIndex((day) => day.pending.length === 0);
89
+ const complete = first < 0 ? [] : days.slice(first);
81
90
  return {
82
91
  latest: days[0] ?? null,
83
- week: days.length >= 5 ? sumTotals(days.slice(0, 5)) : null,
84
- month: days.length >= 20 ? sumTotals(days.slice(0, 20)) : null,
92
+ week: complete.length >= 5 ? sumTotals(complete.slice(0, 5)) : null,
93
+ month: complete.length >= 20 ? sumTotals(complete.slice(0, 20)) : null,
94
+ through: complete[0] && complete[0] !== days[0] ? complete[0].date : null,
85
95
  sinceLaunch: sumTotals(days),
86
96
  firstDate: days.at(-1)?.date ?? null,
87
97
  };
@@ -95,8 +95,11 @@ export function CryptoEtfFlowsPane({ focused, width, height }: PaneProps) {
95
95
  const figures: StatItem[] = summary ? [
96
96
  { id: "latest", label: "Latest day", value: formatFlowAmount(latest?.total), color: flowColor(latest?.total, colors),
97
97
  detail: [latest?.date, pending].filter(Boolean).join(" · ") || undefined },
98
- { id: "week", label: "5 days", value: formatFlowAmount(summary.week), color: flowColor(summary.week, colors) },
99
- { id: "month", label: "20 days", value: formatFlowAmount(summary.month), color: flowColor(summary.month, colors) },
98
+ // The rolling sums leave out a day still pending, and say the day they end on.
99
+ { id: "week", label: "5 days", value: formatFlowAmount(summary.week), color: flowColor(summary.week, colors),
100
+ ...summary.through ? { detail: `through ${summary.through}` } : {} },
101
+ { id: "month", label: "20 days", value: formatFlowAmount(summary.month), color: flowColor(summary.month, colors),
102
+ ...summary.through ? { detail: `through ${summary.through}` } : {} },
100
103
  ] : [];
101
104
 
102
105
  const updatedAgo = useUpdatedAgo(resource.updatedAt);
@@ -105,7 +108,7 @@ export function CryptoEtfFlowsPane({ focused, width, height }: PaneProps) {
105
108
  ...(updatedAgo ? [ageFooterSegment(updatedAgo)] : []),
106
109
  ] : [], [data, updatedAgo]);
107
110
  useAutoRefresh(resource.updatedAt, resource.load);
108
- const refresh = useCallback(() => void resource.reload(), [resource.reload]);
111
+ const refresh = useCallback(() => resource.reload(), [resource.reload]);
109
112
  usePaneRefreshKey(refresh, { focused });
110
113
  usePaneStatusLinkFooter({
111
114
  registrationId: CRYPTO_ETF_FLOWS_PANE_ID, focused, loading: resource.loading, error: data ? null : resource.error,
@@ -114,7 +114,7 @@ export function CustomViewPane({ focused, width, height }: PaneProps) {
114
114
  const controller = new AbortController();
115
115
  return loadViewSource(spec, config, controller.signal);
116
116
  }, [config, spec, specError]);
117
- const { data, loading, error, reload, updatedAt } = useAsyncResource(spec ? loader : null);
117
+ const { data, loading, error, reload, reloadAndWait, updatedAt } = useAsyncResource(spec ? loader : null);
118
118
  useAutoRefresh(updatedAt, reload);
119
119
 
120
120
  useEffect(() => {
@@ -253,7 +253,7 @@ export function CustomViewPane({ focused, width, height }: PaneProps) {
253
253
  });
254
254
  teamViewsStore.upsert(published);
255
255
  notify({ body: `Published ${published.name} r${published.revision}.`, type: "success" });
256
- void reload();
256
+ reload();
257
257
  } catch (error) {
258
258
  if (!(error instanceof TeamRevisionConflictError)) throw error;
259
259
  const choice = await dialog.prompt<string>({
@@ -278,7 +278,7 @@ export function CustomViewPane({ focused, width, height }: PaneProps) {
278
278
  teamViewsStore.upsert(published);
279
279
  notify({ body: `Published ${published.name} r${published.revision}.`, type: "success" });
280
280
  }
281
- void reload();
281
+ reload();
282
282
  }
283
283
  return;
284
284
  }
@@ -341,7 +341,7 @@ export function CustomViewPane({ focused, width, height }: PaneProps) {
341
341
  if (!focused) return;
342
342
  if (event.name === "r" && !event.ctrl && !event.meta) {
343
343
  event.preventDefault?.();
344
- void reload();
344
+ reload();
345
345
  } else if (isPlainKey(event, "t") && spec) {
346
346
  event.preventDefault?.();
347
347
  void publishToTeam();
@@ -371,7 +371,7 @@ export function CustomViewPane({ focused, width, height }: PaneProps) {
371
371
  <PaneStatusBody
372
372
  error={error}
373
373
  errorTitle="This view could not load."
374
- retry={{ onRetry: reload }}
374
+ retry={{ onRetry: reloadAndWait }}
375
375
  />
376
376
  );
377
377
  }
@@ -68,6 +68,9 @@ const httpsUrl = (value: unknown) =>
68
68
  typeof value === "string" && URL.canParse(value) && new URL(value).protocol === "https:";
69
69
  /** SEC's annual forms a schedule by year is read from. */
70
70
  const ANNUAL_FORM = /^(10-K|20-F|40-F)(\/A)?$/;
71
+ /** Absent on older servers; else text alone. */
72
+ const optionalTexts = (value: unknown) =>
73
+ value === undefined || (Array.isArray(value) && value.every((entry) => typeof entry === "string"));
71
74
  const near = (a: number | null, b: number | null) =>
72
75
  a === b ||
73
76
  (a !== null &&
@@ -211,6 +214,7 @@ function validateSchedule(
211
214
  typeof data.source.cadence !== "string" ||
212
215
  !Array.isArray(data.warnings) ||
213
216
  data.warnings.some((value) => typeof value !== "string") ||
217
+ !optionalTexts(data.notes) ||
214
218
  !Array.isArray(data.history)
215
219
  )
216
220
  return invalid();
@@ -456,6 +460,7 @@ function validateBands(data: DebtMaturitiesPayload, symbol: string): DebtMaturit
456
460
  typeof data.source.cadence !== "string" ||
457
461
  !Array.isArray(data.warnings) ||
458
462
  data.warnings.some((value) => typeof value !== "string") ||
463
+ !optionalTexts(data.notes) ||
459
464
  !Array.isArray(data.history) ||
460
465
  !day(latest.asOf) ||
461
466
  latest.asOf !== data.asOf ||
@@ -121,6 +121,8 @@ export const debtMaturitiesHeadless: HeadlessPaneDefinition<"bundle"> = {
121
121
  return {
122
122
  complete: data.status === "available",
123
123
  errors: debtNotices(data),
124
+ // What the schedule covers and how it was read, beside it: never a failure.
125
+ ...(data.notes?.length ? { notes: data.notes } : {}),
124
126
  sections: bandSections(data, latest),
125
127
  metadata: { ...data },
126
128
  // Dated by the report's balance sheet: an SEC filing named by its form, a report outside SEC cited
@@ -208,7 +210,7 @@ export const debtMaturitiesHeadless: HeadlessPaneDefinition<"bundle"> = {
208
210
  rows: debtHistoryRows(data.history).map((row) => ({ ...row })),
209
211
  },
210
212
  ],
211
- ...(costNote ? { notes: [costNote] } : {}),
213
+ ...(costNote || data.notes?.length ? { notes: [...(data.notes ?? []), ...(costNote ? [costNote] : [])] } : {}),
212
214
  metadata: { ...data },
213
215
  // The latest filing dates the report (a newer 10-Q's balance date), named by its form so the date is
214
216
  // not read as the schedule's; the history rows are past years, not stale data.
@@ -349,6 +349,7 @@ export function debtCostProxyNote(history: readonly DebtHistoryPoint[]): string
349
349
  return missing.length > 0 ? `Cost proxy %: none for ${missing.join(", ")}.` : null;
350
350
  }
351
351
 
352
+ /** What a schedule could not read; a newer server sends what it covers apart, as `notes`. */
352
353
  export function debtNotices(data: DebtMaturitiesPayload): string[] {
353
354
  // Standing scope and open-ended bucket methodology are documented, not repeated as
354
355
  // active failures. The backend stops sending them; this covers older servers and caches.
@@ -617,7 +617,7 @@ export function DebtMaturitiesPane({ width, height, focused }: PaneProps) {
617
617
  ];
618
618
  }, [data, updatedAgo]);
619
619
  useAutoRefresh(resource.updatedAt, resource.load);
620
- usePaneRefreshKey(() => void resource.reload(), { focused });
620
+ usePaneRefreshKey(() => resource.reload(), { focused });
621
621
  usePaneNoticeFooter({
622
622
  registrationId: "debt-maturities:notices",
623
623
  focused,