gloomberb 0.20.0 → 0.20.2

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (481) hide show
  1. package/README.md +16 -26
  2. package/README.zh-CN.md +21 -65
  3. package/package.json +1 -1
  4. package/patches/electrobun-devkit@2.0.5.patch +268 -8
  5. package/src/account/auth-model.ts +20 -1
  6. package/src/account/upgrade-dialog.tsx +8 -4
  7. package/src/api-client/askg.ts +7 -1
  8. package/src/api-client/auth.ts +27 -0
  9. package/src/api-client/catalysts.ts +2 -0
  10. package/src/api-client/company-kpis.ts +2 -1
  11. package/src/api-client/cot.ts +14 -2
  12. package/src/api-client/crypto-markets.ts +20 -2
  13. package/src/api-client/data.ts +3 -2
  14. package/src/api-client/earnings.ts +46 -3
  15. package/src/api-client/fund-facts.ts +23 -1
  16. package/src/api-client/futures-curve.ts +17 -0
  17. package/src/api-client/index.ts +4 -1
  18. package/src/api-client/one-tap-reasons.ts +42 -0
  19. package/src/api-client/perps.ts +2 -1
  20. package/src/api-client/request.ts +3 -1
  21. package/src/api-client/research-activity.ts +16 -3
  22. package/src/api-client/types/filings-and-calls.ts +9 -0
  23. package/src/api-client/types/search.ts +3 -0
  24. package/src/app/keybindings/chord.ts +153 -9
  25. package/src/app/keybindings/index.ts +1 -1
  26. package/src/app/keybindings/labels.ts +49 -6
  27. package/src/app/runtime/desktop-deeplink.ts +73 -8
  28. package/src/app/runtime/plugin-seed.ts +119 -0
  29. package/src/app/runtime/startup.ts +45 -9
  30. package/src/app.tsx +8 -1
  31. package/src/architecture/core-builtin-allowlist.json +1 -2
  32. package/src/architecture/pane-tabs-allowlist.json +2 -1
  33. package/src/architecture/shortcut-labels-allowlist.json +11 -0
  34. package/src/architecture/ui-literals-allowlist.json +8 -8
  35. package/src/brokers/broker-portfolio-sync.ts +1 -1
  36. package/src/cli/bank-section.ts +26 -12
  37. package/src/cli/board-coins.ts +38 -5
  38. package/src/cli/commands/crypto-hints.ts +8 -1
  39. package/src/cli/commands/market.ts +294 -100
  40. package/src/cli/commands/overview.ts +13 -6
  41. package/src/cli/commands/ticker.ts +73 -21
  42. package/src/cli/company-name-hint.ts +19 -0
  43. package/src/cli/desktop-pane-shot-browser.ts +47 -31
  44. package/src/cli/desktop-pane-shot.ts +15 -0
  45. package/src/cli/entry.ts +15 -4
  46. package/src/cli/export-source.ts +7 -1
  47. package/src/cli/freshness.ts +0 -16
  48. package/src/cli/fx-pair.ts +64 -12
  49. package/src/cli/fx-quote-rate.ts +144 -0
  50. package/src/cli/glossary.ts +30 -0
  51. package/src/cli/helpers.ts +4 -2
  52. package/src/cli/history-back-adjust.ts +122 -0
  53. package/src/cli/history-rows.ts +114 -10
  54. package/src/cli/index.ts +4 -1
  55. package/src/cli/known-gaps.ts +45 -3
  56. package/src/cli/listing-arg.ts +48 -4
  57. package/src/cli/name-entries.ts +25 -5
  58. package/src/cli/not-a-ticker.ts +26 -1
  59. package/src/cli/pane-functions/catalog.ts +12 -2
  60. package/src/cli/pane-functions/dom.ts +4 -2
  61. package/src/cli/pane-functions/freshness.ts +45 -29
  62. package/src/cli/pane-functions/headless.ts +8 -5
  63. package/src/cli/pane-functions/index.ts +3 -0
  64. package/src/cli/pane-functions/market-session.ts +14 -5
  65. package/src/cli/pane-functions/resolver.ts +4 -1
  66. package/src/cli/pane-functions/screenshot-assessment.ts +15 -3
  67. package/src/cli/pane-functions/screenshot-payload.ts +130 -66
  68. package/src/cli/pane-functions/screenshot-render.ts +14 -2
  69. package/src/cli/pane-functions/screenshot-types.ts +4 -0
  70. package/src/cli/restore-plugins.ts +164 -51
  71. package/src/cli/symbol-rows.ts +22 -2
  72. package/src/cli/ticker-resolution.ts +74 -17
  73. package/src/components/chart/composite/axis-overlays.tsx +13 -3
  74. package/src/components/chart/composite/composite-chart.tsx +8 -1
  75. package/src/components/chart/composite/format.ts +16 -1
  76. package/src/components/chart/composite/legend.tsx +4 -3
  77. package/src/components/chart/composite/panel-labels.ts +2 -1
  78. package/src/components/chart/composite/panel-surface.tsx +33 -4
  79. package/src/components/chart/composite/time-scale.ts +1 -1
  80. package/src/components/chart/composite/toolbar.tsx +8 -4
  81. package/src/components/chart/composite/types.ts +17 -1
  82. package/src/components/chart/composite/use-composite-chart-keyboard.ts +15 -5
  83. package/src/components/chart/composite/use-composite-viewport.ts +31 -8
  84. package/src/components/chart/static/scatter-chart-surface.tsx +25 -9
  85. package/src/components/chart-table/axis.ts +11 -0
  86. package/src/components/chart-table/header.tsx +10 -1
  87. package/src/components/chart-table/layout.ts +14 -5
  88. package/src/components/command-bar/assist/inventory.ts +3 -2
  89. package/src/components/command-bar/commands/collection-list.ts +3 -2
  90. package/src/components/command-bar/panel/index.tsx +13 -0
  91. package/src/components/command-bar/panel/layout.ts +15 -1
  92. package/src/components/command-bar/panel/prompt-width.ts +34 -0
  93. package/src/components/command-bar/panel/runtime.ts +1 -0
  94. package/src/components/command-bar/panel/state.ts +4 -0
  95. package/src/components/command-bar/panel/types.ts +2 -0
  96. package/src/components/command-bar/routes/root/search-providers.ts +3 -2
  97. package/src/components/command-bar/routes/root/search-report.ts +2 -2
  98. package/src/components/command-bar/workflow/ticker-listing-picker.ts +1 -0
  99. package/src/components/company-logo.tsx +2 -2
  100. package/src/components/data-table/view.tsx +11 -2
  101. package/src/components/feed-data-table/stack-view.tsx +20 -6
  102. package/src/components/feedback-dialog.tsx +3 -1
  103. package/src/components/form-modal/field-row.tsx +1 -1
  104. package/src/components/form-modal/routes.ts +1 -0
  105. package/src/components/index.ts +1 -1
  106. package/src/components/layout/header.tsx +12 -3
  107. package/src/components/layout/market-summary.ts +2 -1
  108. package/src/components/layout/pane/footer/index.tsx +9 -5
  109. package/src/components/layout/pane/footer/model.ts +26 -10
  110. package/src/components/layout/pane/footer/registration.tsx +60 -1
  111. package/src/components/layout/pane/header-tabs.tsx +17 -3
  112. package/src/components/layout/pane/header.tsx +5 -2
  113. package/src/components/layout/pane/pane-tabs.tsx +57 -3
  114. package/src/components/layout/shell/active-drag.ts +38 -30
  115. package/src/components/layout/shell/drag/index.ts +51 -21
  116. package/src/components/layout/shell/menu.ts +3 -5
  117. package/src/components/layout/shell/pane/actions.ts +4 -1
  118. package/src/components/layout/shell/pane/ask.ts +5 -2
  119. package/src/components/layout/status-bar.tsx +59 -54
  120. package/src/components/markdown-text.tsx +35 -10
  121. package/src/components/onboarding/first-run-workspace.ts +25 -23
  122. package/src/components/onboarding/onboarding-keyboard.ts +6 -1
  123. package/src/components/onboarding/onboarding-wizard.tsx +12 -2
  124. package/src/components/onboarding/portfolio-step/positions-panel.tsx +3 -3
  125. package/src/components/onboarding/use-onboarding-broker-form.ts +2 -1
  126. package/src/components/onboarding/use-onboarding-progress.ts +11 -4
  127. package/src/components/onboarding/use-onboarding-upgrade.ts +3 -2
  128. package/src/components/onboarding/wizard-positions.ts +8 -1
  129. package/src/components/pane-notice-seen.ts +125 -0
  130. package/src/components/pane-settings-dialog/field-dialogs.tsx +2 -1
  131. package/src/components/pane-settings-dialog.tsx +7 -6
  132. package/src/components/sign-in-code-panel.tsx +3 -2
  133. package/src/components/speedometer-gauge/terminal.tsx +30 -9
  134. package/src/components/ticker/list-table-view.tsx +39 -3
  135. package/src/components/ui/confirm-dialog.tsx +2 -1
  136. package/src/components/ui/data-table/index.tsx +4 -2
  137. package/src/components/ui/data-table/opentui/index.tsx +15 -5
  138. package/src/components/ui/data-table/types.ts +8 -0
  139. package/src/components/ui/external-link.tsx +4 -1
  140. package/src/components/ui/field-grid.tsx +1 -1
  141. package/src/components/ui/index.ts +2 -0
  142. package/src/components/ui/inline-quick-add.tsx +5 -0
  143. package/src/components/ui/multi-select/dialog.tsx +10 -9
  144. package/src/components/ui/pane-link-chip.tsx +354 -0
  145. package/src/components/ui/query-bar.tsx +22 -13
  146. package/src/components/ui/ratio-bar.tsx +24 -1
  147. package/src/components/ui/select-button.tsx +2 -1
  148. package/src/components/ui/shortcut-hint.tsx +6 -3
  149. package/src/components/ui/table-layout.ts +81 -0
  150. package/src/components/ui/tabs.tsx +45 -6
  151. package/src/components/use-pane-notice-footer.tsx +12 -4
  152. package/src/core/app-service-ports.ts +1 -1
  153. package/src/data/plugin-state-store.ts +44 -8
  154. package/src/docs/snapshot.json +53 -32
  155. package/src/i18n/es.ts +28 -6
  156. package/src/i18n/ja.ts +28 -5
  157. package/src/i18n/ko.ts +28 -5
  158. package/src/i18n/zh-cn.ts +28 -5
  159. package/src/i18n/zh-tw.ts +28 -5
  160. package/src/layout/pane-manager/gridlock-inference.ts +2 -1
  161. package/src/layout/pane-manager/gridlock.ts +47 -2
  162. package/src/layout-marketplace/api.ts +1 -0
  163. package/src/layout-marketplace/gallery.tsx +4 -3
  164. package/src/layout-marketplace/linked.ts +6 -4
  165. package/src/layout-marketplace/model.ts +3 -2
  166. package/src/market-data/fund-facts.ts +7 -1
  167. package/src/market-data/futures-contract.ts +77 -31
  168. package/src/market-data/fx-closes.ts +5 -2
  169. package/src/market-data/hooks.tsx +23 -0
  170. package/src/market-data/market/change-basis.ts +92 -14
  171. package/src/market-data/market/format.ts +81 -13
  172. package/src/market-data/market/futures-week.ts +3 -1
  173. package/src/market-data/market/globex-day.ts +73 -0
  174. package/src/market-data/market/index-level.ts +10 -1
  175. package/src/market-data/quotes/intraday-bar.ts +1 -1
  176. package/src/market-data/quotes/session-split.ts +28 -0
  177. package/src/plugins/builtin/account-management/pane.tsx +1 -1
  178. package/src/plugins/builtin/analytics/account-returns.ts +1 -1
  179. package/src/plugins/builtin/analytics/index.tsx +10 -3
  180. package/src/plugins/builtin/analytics/pane-model.ts +1 -1
  181. package/src/plugins/builtin/analytics/risk-client.ts +4 -1
  182. package/src/plugins/builtin/analytics/risk-episodes.ts +422 -0
  183. package/src/plugins/builtin/analytics/risk-fx.ts +1 -1
  184. package/src/plugins/builtin/analytics/risk-headless.ts +28 -10
  185. package/src/plugins/builtin/analytics/risk-math.ts +1 -1
  186. package/src/plugins/builtin/analytics/risk-model.ts +115 -26
  187. package/src/plugins/builtin/analytics/risk-pane.tsx +201 -23
  188. package/src/plugins/builtin/analytics/sharpe-cadence.ts +1 -1
  189. package/src/plugins/builtin/backtest/format.ts +14 -0
  190. package/src/plugins/builtin/backtest/pane.tsx +3 -3
  191. package/src/plugins/builtin/backtest/report.ts +5 -3
  192. package/src/plugins/builtin/broker-manager/add-request.ts +10 -1
  193. package/src/plugins/builtin/broker-trading/pane.tsx +20 -2
  194. package/src/plugins/builtin/buildout/company/flow.tsx +5 -5
  195. package/src/plugins/builtin/buildout/company/model.ts +14 -2
  196. package/src/plugins/builtin/catalysts/detail.tsx +2 -2
  197. package/src/plugins/builtin/catalysts/model.ts +7 -2
  198. package/src/plugins/builtin/catalysts/pane.tsx +2 -2
  199. package/src/plugins/builtin/chart-composer/headless.ts +57 -17
  200. package/src/plugins/builtin/chart-composer/session-range.ts +82 -3
  201. package/src/plugins/builtin/chat/message/pane-chip.tsx +36 -208
  202. package/src/plugins/builtin/cloud/askg/answer-follow-ups.tsx +61 -0
  203. package/src/plugins/builtin/cloud/askg/answer-sources.tsx +102 -0
  204. package/src/plugins/builtin/cloud/askg/controller.ts +7 -1
  205. package/src/plugins/builtin/cloud/askg/host.ts +57 -0
  206. package/src/plugins/builtin/cloud/askg/model.ts +45 -5
  207. package/src/plugins/builtin/cloud/askg/pane.tsx +304 -25
  208. package/src/plugins/builtin/cloud/askg/protocol.ts +26 -1
  209. package/src/plugins/builtin/cloud/askg/sources.ts +466 -0
  210. package/src/plugins/builtin/cloud/one-tap/controller.ts +309 -0
  211. package/src/plugins/builtin/cloud/one-tap/google-identity.ts +142 -0
  212. package/src/plugins/builtin/cloud/one-tap/one-tap-prompt.tsx +101 -0
  213. package/src/plugins/builtin/cloud/plugin.tsx +7 -1
  214. package/src/plugins/builtin/company-kpis/client.ts +4 -3
  215. package/src/plugins/builtin/company-kpis/model.ts +34 -3
  216. package/src/plugins/builtin/correlation/compute.ts +8 -2
  217. package/src/plugins/builtin/correlation/headless.ts +10 -9
  218. package/src/plugins/builtin/correlation/history.ts +30 -0
  219. package/src/plugins/builtin/correlation/index.tsx +39 -167
  220. package/src/plugins/builtin/correlation/matrix/grid.tsx +285 -0
  221. package/src/plugins/builtin/correlation/matrix/model.ts +10 -10
  222. package/src/plugins/builtin/correlation/relationship/model.ts +3 -6
  223. package/src/plugins/builtin/correlation/relationship/pane.tsx +7 -9
  224. package/src/plugins/builtin/correlation/relationship/view-model.ts +14 -5
  225. package/src/plugins/builtin/cot/client.ts +8 -3
  226. package/src/plugins/builtin/cot/headless.ts +65 -12
  227. package/src/plugins/builtin/cot/pane.tsx +11 -5
  228. package/src/plugins/builtin/crypto-board/client.ts +6 -1
  229. package/src/plugins/builtin/crypto-board/defi-view.tsx +12 -1
  230. package/src/plugins/builtin/crypto-board/defi.ts +44 -7
  231. package/src/plugins/builtin/crypto-board/headless.ts +83 -12
  232. package/src/plugins/builtin/crypto-board/model.ts +30 -6
  233. package/src/plugins/builtin/crypto-board/pane.tsx +13 -2
  234. package/src/plugins/builtin/earnings/client.ts +40 -6
  235. package/src/plugins/builtin/earnings/fiscal-quarter.ts +54 -0
  236. package/src/plugins/builtin/earnings/headless.ts +47 -11
  237. package/src/plugins/builtin/earnings/history-model.ts +136 -24
  238. package/src/plugins/builtin/earnings/history-table.ts +42 -10
  239. package/src/plugins/builtin/earnings/history.tsx +23 -8
  240. package/src/plugins/builtin/earnings-ripple/client.ts +5 -2
  241. package/src/plugins/builtin/earnings-ripple/headless.ts +8 -3
  242. package/src/plugins/builtin/earnings-ripple/model.ts +21 -0
  243. package/src/plugins/builtin/earnings-ripple/pane.tsx +2 -3
  244. package/src/plugins/builtin/econ/index.tsx +5 -4
  245. package/src/plugins/builtin/econ-statistics/stats.ts +13 -5
  246. package/src/plugins/builtin/equity-screener/headless.ts +2 -1
  247. package/src/plugins/builtin/filing-events/feed.ts +56 -18
  248. package/src/plugins/builtin/filing-events/pane.tsx +8 -2
  249. package/src/plugins/builtin/futures/index.tsx +32 -10
  250. package/src/plugins/builtin/futures/model.ts +93 -6
  251. package/src/plugins/builtin/futures/returns.ts +29 -7
  252. package/src/plugins/builtin/futures/table.tsx +59 -17
  253. package/src/plugins/builtin/futures/use-front-returns.ts +32 -6
  254. package/src/plugins/builtin/futures-curve/client.ts +12 -2
  255. package/src/plugins/builtin/futures-curve/headless.ts +58 -17
  256. package/src/plugins/builtin/futures-curve/model.ts +111 -15
  257. package/src/plugins/builtin/futures-curve/pane.tsx +11 -6
  258. package/src/plugins/builtin/fx-matrix/amount.ts +132 -0
  259. package/src/plugins/builtin/fx-matrix/headless.ts +53 -13
  260. package/src/plugins/builtin/fx-matrix/index.tsx +205 -42
  261. package/src/plugins/builtin/fx-matrix/pairs.ts +10 -8
  262. package/src/plugins/builtin/fx-matrix/settings.ts +22 -1
  263. package/src/plugins/builtin/help/index.tsx +68 -61
  264. package/src/plugins/builtin/holders/format.ts +7 -2
  265. package/src/plugins/builtin/holders/pane.tsx +11 -3
  266. package/src/plugins/builtin/holders/report-header.ts +5 -4
  267. package/src/plugins/builtin/holders/report-rows.ts +4 -1
  268. package/src/plugins/builtin/holders/treemap.tsx +5 -3
  269. package/src/plugins/builtin/insider/signals-model.ts +4 -5
  270. package/src/plugins/builtin/ipo-calendar/headless.ts +18 -7
  271. package/src/plugins/builtin/ipo-calendar/listing-ipo.ts +3 -1
  272. package/src/plugins/builtin/ipo-calendar/model.ts +28 -8
  273. package/src/plugins/builtin/ipo-calendar/pane.tsx +2 -1
  274. package/src/plugins/builtin/kelly-sizer/headless.ts +4 -0
  275. package/src/plugins/builtin/perps/headless.ts +81 -19
  276. package/src/plugins/builtin/perps/index.tsx +3 -1
  277. package/src/plugins/builtin/perps/model.ts +1 -1
  278. package/src/plugins/builtin/perps/pane.tsx +2 -0
  279. package/src/plugins/builtin/portfolio-list/cell-version.ts +1 -0
  280. package/src/plugins/builtin/portfolio-list/cli/bulk-symbols.ts +20 -1
  281. package/src/plugins/builtin/portfolio-list/cli/import-positions.ts +260 -0
  282. package/src/plugins/builtin/portfolio-list/cli/period-report.ts +154 -0
  283. package/src/plugins/builtin/portfolio-list/cli/portfolio-command.ts +64 -22
  284. package/src/plugins/builtin/portfolio-list/cli/render.ts +18 -7
  285. package/src/plugins/builtin/portfolio-list/cli/watchlist-command.ts +5 -3
  286. package/src/plugins/builtin/portfolio-list/grid.tsx +56 -12
  287. package/src/plugins/builtin/portfolio-list/headless.ts +128 -0
  288. package/src/plugins/builtin/portfolio-list/pane/index.tsx +42 -4
  289. package/src/plugins/builtin/portfolio-list/pane/period-pnl.ts +124 -0
  290. package/src/plugins/builtin/portfolio-list/period-pnl.ts +179 -0
  291. package/src/plugins/builtin/portfolio-list/positions-import/dialog.tsx +445 -0
  292. package/src/plugins/builtin/portfolio-list/positions-import/index.tsx +255 -0
  293. package/src/plugins/builtin/portfolio-list/positions-import/lookup.ts +78 -0
  294. package/src/plugins/builtin/portfolio-list/positions-import/read-file.ts +32 -0
  295. package/src/plugins/builtin/portfolio-list/quick-add/index.tsx +186 -50
  296. package/src/plugins/builtin/portfolio-list/quick-add/resolution.ts +118 -4
  297. package/src/plugins/builtin/portfolio-list/settings.ts +25 -0
  298. package/src/plugins/builtin/portfolio-list/summary/index.tsx +16 -1
  299. package/src/plugins/builtin/portfolio-list/summary/totals.ts +7 -5
  300. package/src/plugins/builtin/portfolio-list/table.tsx +105 -6
  301. package/src/plugins/builtin/power/headless.ts +47 -9
  302. package/src/plugins/builtin/research/relative-valuation-model.ts +8 -3
  303. package/src/plugins/builtin/research-search/article.ts +12 -2
  304. package/src/plugins/builtin/research-search/data.ts +5 -2
  305. package/src/plugins/builtin/research-search/document-view.tsx +1 -1
  306. package/src/plugins/builtin/research-search/model.ts +47 -3
  307. package/src/plugins/builtin/research-search/pane.tsx +3 -2
  308. package/src/plugins/builtin/reverse-dcf/model.ts +7 -4
  309. package/src/plugins/builtin/risk-factors/headless.ts +3 -2
  310. package/src/plugins/builtin/risk-factors/index.tsx +2 -28
  311. package/src/plugins/builtin/risk-factors/lock-note.ts +58 -0
  312. package/src/plugins/builtin/risk-factors/pane.tsx +14 -5
  313. package/src/plugins/builtin/scanner/flow-model.ts +17 -13
  314. package/src/plugins/builtin/scanner/flow-pane.tsx +8 -9
  315. package/src/plugins/builtin/scanner/flow-session.ts +2 -9
  316. package/src/plugins/builtin/scanner/hilo-model.ts +4 -3
  317. package/src/plugins/builtin/sec/filing-display.tsx +0 -5
  318. package/src/plugins/builtin/sec/forms.ts +19 -0
  319. package/src/plugins/builtin/sec/fund-facts.ts +45 -11
  320. package/src/plugins/builtin/sec/headless.ts +37 -12
  321. package/src/plugins/builtin/sec/index.tsx +37 -8
  322. package/src/plugins/builtin/shared/earnings-calendar.ts +6 -3
  323. package/src/plugins/builtin/shared/earnings-report.ts +1 -1
  324. package/src/plugins/builtin/shared/fx-rate-freshness.ts +0 -35
  325. package/src/plugins/builtin/shared/pro-lock-note.ts +5 -1
  326. package/src/plugins/builtin/shared/use-quote-board.ts +42 -27
  327. package/src/plugins/builtin/supply-chain/graph-model.ts +7 -1
  328. package/src/plugins/builtin/supply-chain/headless.ts +20 -10
  329. package/src/plugins/builtin/supply-chain/model.ts +117 -20
  330. package/src/plugins/builtin/supply-chain/pane.tsx +22 -15
  331. package/src/plugins/builtin/supply-chain/row-evidence.tsx +1 -1
  332. package/src/plugins/builtin/ticker-detail/data-panes/returns-chart-model.ts +69 -0
  333. package/src/plugins/builtin/ticker-detail/data-panes/returns-chart.tsx +118 -0
  334. package/src/plugins/builtin/ticker-detail/data-panes/returns-model.ts +1 -1
  335. package/src/plugins/builtin/ticker-detail/data-panes/returns-pane.tsx +103 -40
  336. package/src/plugins/builtin/ticker-detail/headless-schema.ts +10 -1
  337. package/src/plugins/builtin/ticker-detail/headless.ts +8 -1
  338. package/src/plugins/builtin/ticker-detail/overview/components.tsx +2 -1
  339. package/src/plugins/builtin/ticker-detail/overview/model.ts +18 -8
  340. package/src/plugins/builtin/ticker-detail/overview-tab.tsx +11 -8
  341. package/src/plugins/builtin/ticker-detail/pane.tsx +95 -20
  342. package/src/plugins/builtin/ticker-detail/research-groups.ts +89 -0
  343. package/src/plugins/builtin/ticker-detail/settings.ts +4 -3
  344. package/src/plugins/builtin/time-sales/headless.ts +23 -7
  345. package/src/plugins/builtin/time-sales/index.tsx +2 -2
  346. package/src/plugins/builtin/volatility/charts.tsx +2 -2
  347. package/src/plugins/extracted-plugins.ts +49 -24
  348. package/src/plugins/host-resolver.ts +3 -2
  349. package/src/plugins/installer.ts +220 -31
  350. package/src/plugins/running-installs.ts +34 -0
  351. package/src/plugins/seed-progress.ts +72 -0
  352. package/src/portfolio/column-values.ts +42 -8
  353. package/src/portfolio/futures-positions.ts +10 -2
  354. package/src/portfolio/mutations.ts +4 -3
  355. package/src/portfolio/period-pnl.ts +119 -0
  356. package/src/portfolio/positions-import/describe.ts +89 -0
  357. package/src/portfolio/positions-import/parse.ts +682 -0
  358. package/src/portfolio/positions-import/plan.ts +295 -0
  359. package/src/{plugins/builtin/analytics/metrics.ts → portfolio/return-metrics.ts} +24 -11
  360. package/src/public/__snapshots__/public-api.test.ts.snap +1 -0
  361. package/src/react/jsx-dev-fallback.ts +62 -0
  362. package/src/renderers/browser/cloud-transport.ts +1 -1
  363. package/src/renderers/browser/config-host.ts +3 -1
  364. package/src/renderers/browser/deeplink-bridge.ts +8 -1
  365. package/src/renderers/browser/http-proxy-transport.ts +9 -2
  366. package/src/renderers/browser/main.tsx +2 -1
  367. package/src/renderers/browser/research-entry.ts +12 -0
  368. package/src/renderers/cloudflare/http-proxy.ts +8 -2
  369. package/src/renderers/cloudflare/proxy-session.ts +1 -0
  370. package/src/renderers/cloudflare/worker.ts +12 -3
  371. package/src/renderers/dom/desktop/audio-player.tsx +2 -2
  372. package/src/renderers/dom/desktop/controls.tsx +1 -1
  373. package/src/renderers/dom/desktop/dialog-actions.tsx +10 -24
  374. package/src/renderers/dom/desktop/icons.tsx +4 -2
  375. package/src/renderers/dom/desktop/query-bar.tsx +23 -19
  376. package/src/renderers/dom/dom-host-providers.tsx +7 -2
  377. package/src/renderers/dom/host/box.tsx +2 -2
  378. package/src/renderers/dom/host/input.tsx +13 -0
  379. package/src/renderers/dom/key-event.ts +1 -0
  380. package/src/renderers/dom/styles.css +3 -0
  381. package/src/renderers/electrobun/bun/context-menu/click.ts +1 -0
  382. package/src/renderers/electrobun/bun/desktop/backend.ts +15 -0
  383. package/src/renderers/electrobun/bun/desktop/capability-bridge.ts +5 -4
  384. package/src/renderers/electrobun/bun/desktop/host-requests.ts +19 -11
  385. package/src/renderers/electrobun/bun/desktop/http-fetch.ts +1 -0
  386. package/src/renderers/electrobun/bun/desktop/http-stream.ts +1 -1
  387. package/src/renderers/electrobun/bun/desktop/initialization.ts +27 -15
  388. package/src/renderers/electrobun/bun/desktop/install-records.ts +4 -1
  389. package/src/renderers/electrobun/bun/desktop/installer-folder.ts +5 -2
  390. package/src/renderers/electrobun/bun/desktop/macos-objc.ts +3 -1
  391. package/src/renderers/electrobun/bun/desktop/screen-setup-file.ts +9 -4
  392. package/src/renderers/electrobun/bun/desktop/update.ts +27 -13
  393. package/src/renderers/electrobun/bun/desktop/windows-script.ts +6 -2
  394. package/src/renderers/electrobun/bun/index.ts +5 -0
  395. package/src/renderers/electrobun/bun/window/attention.ts +1 -0
  396. package/src/renderers/electrobun/bun/window/boot-frame.ts +1 -0
  397. package/src/renderers/electrobun/bun/window/context-menu-thread.ts +84 -0
  398. package/src/renderers/electrobun/bun/window/create.ts +1 -0
  399. package/src/renderers/electrobun/bun/window/electrobun-window-host.ts +13 -8
  400. package/src/renderers/electrobun/bun/window/native-call-thread.ts +224 -0
  401. package/src/renderers/electrobun/bun/window/native-min-size.ts +1 -1
  402. package/src/renderers/electrobun/bun/window/native-timing.ts +10 -0
  403. package/src/renderers/electrobun/bun/window/remembered-frame.ts +1 -0
  404. package/src/renderers/electrobun/bun/window/script-for-webview.ts +15 -0
  405. package/src/renderers/electrobun/bun/window/webview-script-thread.ts +82 -0
  406. package/src/renderers/electrobun/bun/window/windows-native.ts +3 -1
  407. package/src/renderers/electrobun/bun/window/windows-quit.ts +3 -1
  408. package/src/renderers/electrobun/shared/protocol.ts +13 -2
  409. package/src/renderers/electrobun/view/app-badge-host.ts +2 -1
  410. package/src/renderers/electrobun/view/backend-rpc.ts +7 -0
  411. package/src/renderers/electrobun/view/capability-subscription.ts +2 -1
  412. package/src/renderers/electrobun/view/cli-pane-shot-entry.tsx +7 -10
  413. package/src/renderers/electrobun/view/cli-pane-shot-frame.tsx +1 -1
  414. package/src/renderers/electrobun/view/cli-pane-shot-mutations.ts +36 -0
  415. package/src/renderers/electrobun/view/http-fetch.ts +2 -1
  416. package/src/renderers/electrobun/view/main.tsx +13 -7
  417. package/src/renderers/electrobun/view/remote/capability-invoker.ts +6 -3
  418. package/src/renderers/electrobun/view/remote/persistence.ts +63 -27
  419. package/src/renderers/electrobun/view/rpc-timeout.ts +1 -0
  420. package/src/renderers/electrobun/view/ui-host.tsx +3 -2
  421. package/src/renderers/electrobun/view/window-fullscreen.ts +3 -1
  422. package/src/renderers/opentui/browser-open.ts +2 -1
  423. package/src/renderers/opentui/dialog-host.tsx +1 -1
  424. package/src/renderers/opentui/interaction-performance.ts +3 -1
  425. package/src/renderers/opentui/start.tsx +5 -1
  426. package/src/renderers/opentui/terminal-media.ts +11 -6
  427. package/src/renderers/opentui/ui-host.tsx +5 -8
  428. package/src/shares/open.ts +22 -1
  429. package/src/shares/pane.ts +2 -1
  430. package/src/sources/gloomberb-cloud/normalizers.ts +3 -0
  431. package/src/sync/analytics-payload.ts +194 -0
  432. package/src/sync/baseline.ts +19 -9
  433. package/src/sync/broker-identity.ts +171 -0
  434. package/src/sync/broker-instances.ts +137 -0
  435. package/src/sync/collections-contributor.ts +173 -0
  436. package/src/sync/config-contributor.ts +100 -0
  437. package/src/sync/config-merge.ts +229 -0
  438. package/src/sync/controller.ts +139 -28
  439. package/src/sync/core-contributors.ts +8 -1583
  440. package/src/sync/history-memo.ts +32 -0
  441. package/src/sync/layout-merge.ts +259 -0
  442. package/src/sync/sanitize.ts +114 -0
  443. package/src/sync/ticker-merge.ts +208 -0
  444. package/src/sync/ticker-payload.ts +81 -0
  445. package/src/sync/types.ts +15 -1
  446. package/src/telemetry/attention-setting.ts +1 -1
  447. package/src/telemetry/stall-reports.ts +21 -4
  448. package/src/telemetry/usage-counts.ts +16 -0
  449. package/src/test-support/preload.ts +5 -0
  450. package/src/theme/color-utils.ts +10 -0
  451. package/src/theme/font-scale.ts +34 -3
  452. package/src/theme/series-colors.ts +44 -0
  453. package/src/theme/themes.ts +2 -1
  454. package/src/tickers/batched-lookups.ts +263 -6
  455. package/src/tickers/company-name-listing.ts +44 -2
  456. package/src/tickers/company-name.ts +7 -2
  457. package/src/tickers/search/upsert.ts +16 -1
  458. package/src/time-series/base-series.ts +18 -4
  459. package/src/time-series/studies/indicators.ts +3 -1
  460. package/src/time-series/studies/resolve.ts +1 -1
  461. package/src/time-series/types.ts +6 -0
  462. package/src/types/financials.ts +18 -0
  463. package/src/types/headless.ts +11 -0
  464. package/src/ui/host.tsx +26 -3
  465. package/src/ui/index.tsx +1 -0
  466. package/src/utils/concurrency.ts +6 -0
  467. package/src/utils/currency-pair.ts +56 -4
  468. package/src/utils/datetime-format.ts +11 -0
  469. package/src/utils/decimal-comma.ts +9 -6
  470. package/src/utils/exchanges.ts +32 -0
  471. package/src/utils/fundamentals.ts +41 -0
  472. package/src/utils/main-thread-stall.ts +21 -5
  473. package/src/utils/markdown.ts +4 -2
  474. package/src/utils/pasted-lines.ts +14 -0
  475. package/src/utils/perf-marks.ts +88 -9
  476. package/src/utils/price-window.ts +2 -1
  477. package/src/utils/reported-money.ts +9 -2
  478. package/src/utils/sec-filings.ts +17 -0
  479. package/src/utils/sec.ts +37 -25
  480. package/src/utils/shortcut-labels.ts +6 -30
  481. package/src/plugins/seed-notice.ts +0 -20
@@ -4,6 +4,7 @@ import { fetchCotBoard, fetchCotContract } from "./client";
4
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";
5
5
  import { COMMODITIES_VIEW_STATE } from "../commodities-energy/view-state";
6
6
  import { REPORT_ROWS } from "../shared/headless-options";
7
+ import { DATE_OPTION_EXAMPLES, isoDateOption } from "../../../utils/calendar-date";
7
8
 
8
9
  const camelClass = (id: CotClass) => id.replace(/-(\w)/g, (_match, letter: string) => letter.toUpperCase());
9
10
  const rounded = (value: number | null, digits: number) => value == null ? null : Number(value.toFixed(digits));
@@ -12,17 +13,26 @@ const signed = (value: unknown) => cotInteger(typeof value === "number" ? value
12
13
  const percent = (value: unknown) => typeof value === "number" ? `${value > 0 ? "+" : ""}${value.toFixed(1)}%` : "--";
13
14
  const rank = (value: unknown) => typeof value === "number" ? value.toFixed(0) : "--";
14
15
 
15
- /** The report's release, by the CFTC's schedule, for an export's publication time; nothing outside the schedule. */
16
- function cotReleased(asOf: string | null) {
17
- const publishedAt = cotReleaseTime(asOf);
18
- return publishedAt ? { freshness: { publishedAt } } : {};
16
+ /**
17
+ * The report's release, by the CFTC's schedule, as Gloom Cloud states it (else
18
+ * the app's copy of the schedule): one time for the text, CSV and JSON, the
19
+ * export's publication time and the metadata's `publishedAt` alike.
20
+ */
21
+ function cotPublishedAt(data: Pick<CotContractPayload, "asOf" | "publishedAt">): string | null {
22
+ return data.publishedAt ?? cotReleaseTime(data.asOf);
23
+ }
24
+ /** Who published the report, cited by every export: the CFTC itself. */
25
+ const COT_PUBLISHER = "Commodity Futures Trading Commission (CFTC)";
26
+ function cotReleased(publishedAt: string | null) {
27
+ return { freshness: { publisher: COT_PUBLISHER, ...(publishedAt ? { publishedAt } : {}) } };
19
28
  }
20
29
 
21
30
  /** The pane's columns: percentiles as their rank value, net share of open interest to one decimal. */
22
31
  function cotPositionRow(row: CotClassSummary) {
23
32
  return { long: row.long, short: row.short, spreading: row.spreading, net: row.net,
24
33
  netPercentOfOpenInterest: rounded(row.netPercentOfOpenInterest, 1), weeklyChange: row.weeklyChange, previousReportDate: row.previousReportDate,
25
- oneYearPercentile: rounded(row.percentile1Y.value, 0), threeYearPercentile: rounded(row.percentile3Y.value, 0) };
34
+ oneYearPercentile: rounded(row.percentile1Y.value, 0), threeYearPercentile: rounded(row.percentile3Y.value, 0),
35
+ allHistoryPercentile: rounded(row.percentileAll?.value ?? null, 0) };
26
36
  }
27
37
  /**
28
38
  * A market's title line: its name, the report date (the Tuesday the positions
@@ -48,8 +58,40 @@ const POSITION_COLUMNS: HeadlessPaneColumn[] = [
48
58
  { key: "netPercentOfOpenInterest", header: "Net % OI", align: "right", format: percent },
49
59
  { key: "oneYearPercentile", header: "Pctl 1Y", align: "right", format: rank },
50
60
  { key: "threeYearPercentile", header: "Pctl 3Y", align: "right", format: rank },
61
+ // Every stored report of the market, from its first (back to 1986 for the oldest Legacy markets).
62
+ { key: "allHistoryPercentile", header: "Pctl All", align: "right", format: rank },
51
63
  ];
52
64
 
65
+ /**
66
+ * The grain markets the CFTC moved from thousands of bushels to contracts in
67
+ * January 1998, each under a new code: their Legacy reports before that are
68
+ * under the old code, a separate market here (not joined to the new one).
69
+ */
70
+ const COT_CODES_BEFORE_1998: Readonly<Record<string, string>> = {
71
+ "001602": "001601", // wheat, CBOT
72
+ "001612": "001611", // wheat, Kansas City
73
+ "001626": "001621", // wheat, Minneapolis
74
+ "001627": "001624", // white wheat, Minneapolis
75
+ "002602": "002601", // corn
76
+ "004603": "004601", // oats
77
+ "005602": "005601", // soybeans
78
+ };
79
+
80
+ /**
81
+ * What the weekly section says about how far back it reaches: the history
82
+ * `--since` asked for begins after the market's first report, or the server
83
+ * has none that old.
84
+ */
85
+ function cotHistoryNote(data: CotContractPayload, since: string | null): string | null {
86
+ const first = data.history[0]?.reportDate;
87
+ if (!since || !first || first <= since) return null;
88
+ if (!data.historyStart || data.historyStart <= since) return `Weekly positions before ${first} are not available yet.`;
89
+ const previous = data.reportFamily === "legacy" ? COT_CODES_BEFORE_1998[data.contract?.contractCode ?? ""] : undefined;
90
+ return previous
91
+ ? `Reports under CFTC code ${data.contract!.contractCode} start ${data.historyStart}, when the CFTC began counting this market in contracts; its earlier reports are under its previous code ${previous}, in thousands of bushels, and are not joined to these. --since ${since} lists from ${data.historyStart}.`
92
+ : `The CFTC's first report of this market in Gloom Cloud is ${data.historyStart}; --since ${since} lists from there.`;
93
+ }
94
+
53
95
  export const cotHeadless: HeadlessPaneDefinition<"bundle"> = {
54
96
  shape: "bundle",
55
97
  // Tuesday positions published the Friday after; two weeks without a new report means one was missed.
@@ -62,6 +104,9 @@ export const cotHeadless: HeadlessPaneDefinition<"bundle"> = {
62
104
  pluginState: { pluginId: COMMODITIES_VIEW_STATE.cot, key: "positions" } },
63
105
  { key: "scope", type: "enum", values: COT_SCOPES.map(({ value }) => ({ value })), defaultValue: "major", description: "Markets on the extremes board, as in the pane.",
64
106
  pluginState: { pluginId: COMMODITIES_VIEW_STATE.cot, key: "scope" } },
107
+ { key: "since", type: "string", placeholder: "date", example: "--since 2006-06-13",
108
+ description: `First report date a market lists, as ${DATE_OPTION_EXAMPLES}; three years by default. Ranks always read every report.`,
109
+ normalize: (value) => isoDateOption(value, "since") },
65
110
  // Weekly reports come newest first, so --tail asks for the same newest n as --limit.
66
111
  { key: "limit", type: "integer", aliases: ["tail", "weeks", "rows"], minimum: 1, maximum: 2000, shot: REPORT_ROWS,
67
112
  description: "Newest weekly reports a market lists; every one by default." }],
@@ -74,32 +119,40 @@ export const cotHeadless: HeadlessPaneDefinition<"bundle"> = {
74
119
  const code = cotContractCode(args.argument);
75
120
  if (!code) throw new Error(cotUnknownMarketMessage(args.argument));
76
121
  const proxy = cotProxyFor(args.argument);
77
- const data = await fetchCotContract(code, family, ctx.apiClient, positions);
122
+ const since = typeof args.options.since === "string" && args.options.since ? args.options.since : null;
123
+ const data = await fetchCotContract(code, family, ctx.apiClient, positions, since ?? undefined);
124
+ const publishedAt = cotPublishedAt(data);
125
+ const historyNote = cotHistoryNote(data, since);
78
126
  const classes = data.positions.map((row) => row.id);
79
127
  const limit = args.options.limit == null ? null : Number(args.options.limit);
80
128
  const weeks = cotWeeklyRows(data.history, limit);
129
+ const weeklyColumns: HeadlessPaneColumn[] = [{ key: "reportDate", header: "Report date" }, { key: "released", header: "Released" },
130
+ { key: "openInterest", header: "Open interest", align: "right", format: count },
131
+ ...classes.map((id) => ({ key: `${camelClass(id)}Net`, header: `${data.positions.find((row) => row.id === id)?.label ?? id} net`, align: "right" as const, format: signed }))];
81
132
  return { sections: [{ title: cotContractTitle(data, code),
82
133
  columns: [{ key: "class", header: "Class" }, { key: "long", header: "Long", align: "right", format: count },
83
134
  { key: "short", header: "Short", align: "right", format: count }, ...POSITION_COLUMNS],
84
135
  rows: data.positions.map((row) => ({ class: row.label, ...cotPositionRow(row) })) },
85
136
  { title: weeks.length < data.history.length ? `Weekly positions · newest ${weeks.length} of ${data.history.length}` : "Weekly positions",
86
- columns: [{ key: "reportDate", header: "Report date" }, { key: "openInterest", header: "Open interest", align: "right", format: count },
87
- ...classes.map((id) => ({ key: `${camelClass(id)}Net`, header: `${data.positions.find((row) => row.id === id)?.label ?? id} net`, align: "right" as const, format: signed }))],
88
- rows: weeks.map((row) => ({ reportDate: row.reportDate, openInterest: row.openInterest,
137
+ columns: weeklyColumns,
138
+ // Each report's scheduled release, for an export read as of a past week; the text keeps to the positions.
139
+ textColumns: weeklyColumns.filter((column) => column.key !== "released"),
140
+ rows: weeks.map((row) => ({ reportDate: row.reportDate, released: row.publishedAt ?? cotReleaseTime(row.reportDate), openInterest: row.openInterest,
89
141
  ...Object.fromEntries(row.positions.map((position) => [`${camelClass(position.id)}Net`, position.net])) })) }],
90
142
  // "jet fuel" reads heating oil's positions, and says so.
91
- ...(proxy ? { notes: [cotProxyNote(proxy)] } : {}),
92
- errors: data.gaps, metadata: { ...data, complete: data.status === "available" }, ...cotReleased(data.asOf) };
143
+ ...(proxy || historyNote ? { notes: [...(proxy ? [cotProxyNote(proxy)] : []), ...(historyNote ? [historyNote] : [])] } : {}),
144
+ errors: data.gaps, metadata: { ...data, publishedAt, complete: data.status === "available" }, ...cotReleased(publishedAt) };
93
145
  }
94
146
  const traderClass = cotClass(family, args.options.traderClass);
95
147
  if (args.options.traderClass && traderClass !== args.options.traderClass) throw new Error("Trader class does not belong to this report family");
96
148
  const scope = cotScope(args.options.scope);
97
149
  const data = await fetchCotBoard(family, traderClass, ctx.apiClient, positions);
98
150
  const rows = data.rows.filter((row) => scope === "all" || COT_MAJOR_CODES.has(row.contractCode));
151
+ const publishedAt = cotPublishedAt(data);
99
152
  return { sections: [{ title: positions === "combined" ? `Positioning extremes · ${cotPositionsText(positions)}` : "Positioning extremes",
100
153
  columns: [{ key: "marketName", header: "Market" }, { key: "contractCode", header: "Code" }, ...POSITION_COLUMNS,
101
154
  { key: "openInterest", header: "Open interest", align: "right", format: count }, { key: "reportDate", header: "As of" }],
102
155
  rows: rows.map((row) => ({ contractCode: row.contractCode, marketName: cotMarketName(row.marketName), reportDate: row.reportDate, openInterest: row.openInterest, ...cotPositionRow(row.position) })) }],
103
- errors: data.gaps, metadata: { ...data, scope, complete: data.status === "available" }, ...cotReleased(data.asOf) };
156
+ errors: data.gaps, metadata: { ...data, scope, publishedAt, complete: data.status === "available" }, ...cotReleased(publishedAt) };
104
157
  },
105
158
  };
@@ -22,6 +22,7 @@ const BOARD_COLUMNS: DataTableColumn[] = [
22
22
  { id: "change", label: "1W Δ", width: 11, align: "right" },
23
23
  { id: "one", label: "PCTL 1Y", width: 8, align: "right" },
24
24
  { id: "three", label: "PCTL 3Y", width: 8, align: "right" },
25
+ { id: "all", label: "PCTL ALL", width: 9, align: "right" },
25
26
  { id: "asOf", label: "AS OF", width: 10, align: "left" },
26
27
  ];
27
28
  const POSITION_COLUMNS: DataTableColumn[] = [
@@ -32,13 +33,17 @@ const POSITION_COLUMNS: DataTableColumn[] = [
32
33
  { id: "change", label: "1W Δ", width: 10, align: "right" },
33
34
  { id: "one", label: "PCTL 1Y", width: 8, align: "right" },
34
35
  { id: "three", label: "PCTL 3Y", width: 8, align: "right" },
36
+ { id: "all", label: "PCTL ALL", width: 9, align: "right" },
35
37
  ];
36
38
  /** Net positioning is the subject: two parts of the plot to the front price's one. */
37
39
  const NET_PRICE_PANELS = [{ id: "net", height: 2 }, { id: "price", height: 1 }];
38
40
  const NET_PANEL = [{ id: "net" }];
39
41
  /** Legend, four net rows, two price rows and the axis; a shorter band keeps the net alone. */
40
42
  const PRICE_PANEL_MIN_ROWS = 8;
41
- const rank = (value: number | null) => value == null ? "--" : value.toFixed(0);
43
+ const rank = (value: number | null | undefined) => value == null ? "--" : value.toFixed(0);
44
+ /** A class's rank in a percentile column: 1Y, 3Y, or against every stored report (`all`). */
45
+ const columnRank = (row: CotClassSummary, column: string) =>
46
+ (column === "one" ? row.percentile1Y : column === "three" ? row.percentile3Y : row.percentileAll)?.value ?? null;
42
47
  const cotDetailTitle = (name: string | undefined, code: string | null) => name ? cotMarketName(name) : code ?? undefined;
43
48
 
44
49
  export function CotPane(props: PaneProps) {
@@ -81,7 +86,8 @@ function CotBoard({ width, height, focused, family, initialCode }: PaneProps & {
81
86
  : scope === "all" || COT_MAJOR_CODES.has(row.contractCode));
82
87
  if (!sort.columnId) return result;
83
88
  const value = (row: CotBoardRow) => ({ name: cotMarketName(row.marketName), code: row.contractCode, net: row.position.net, change: row.position.weeklyChange,
84
- one: row.position.percentile1Y.value, three: row.position.percentile3Y.value, asOf: row.reportDate })[sort.columnId as "name"];
89
+ one: row.position.percentile1Y.value, three: row.position.percentile3Y.value, all: row.position.percentileAll?.value ?? null,
90
+ asOf: row.reportDate })[sort.columnId as "name"];
85
91
  return [...result].sort((a, b) => compareSortValues(value(a), value(b), sort.direction));
86
92
  }, [data, query, scope, sort]);
87
93
  useAutoRefresh(resource.updatedAt, resource.load);
@@ -116,7 +122,7 @@ function CotBoard({ width, height, focused, family, initialCode }: PaneProps & {
116
122
  if (column.id === "code") return { text: row.contractCode, color: colors.textMuted };
117
123
  if (column.id === "net") return { text: cotInteger(row.position.net, true) };
118
124
  if (column.id === "change") return { text: cotInteger(row.position.weeklyChange, true) };
119
- if (column.id === "one" || column.id === "three") return { text: rank(column.id === "one" ? row.position.percentile1Y.value : row.position.percentile3Y.value), color: colors.warning };
125
+ if (column.id === "one" || column.id === "three" || column.id === "all") return { text: rank(columnRank(row.position, column.id)), color: colors.warning };
120
126
  return { text: row.reportDate, color: colors.textMuted };
121
127
  }}
122
128
  rootBefore={<QueryBar width={width}
@@ -197,8 +203,8 @@ function CotDetail({ width, height, focused, code, family, positions, traderClas
197
203
  tableColumns={POSITION_COLUMNS} />}
198
204
  selection={{ kind: "id", selectedId: traderClass, getId: (row) => row.id, onChange: (id) => onClassChange(id as CotClass) }}
199
205
  onActivate={(row) => onClassChange(row.id)} getItemKey={(row) => row.id} sortColumnId={null} sortDirection="asc"
200
- renderCell={(row: CotClassSummary, column) => ({ text: column.id === "name" ? row.label : column.id === "one" ? rank(row.percentile1Y.value)
201
- : column.id === "three" ? rank(row.percentile3Y.value) : cotInteger(column.id === "change" ? row.weeklyChange : row[column.id as "long" | "short" | "net"], column.id === "net" || column.id === "change") })}
206
+ renderCell={(row: CotClassSummary, column) => ({ text: column.id === "name" ? row.label
207
+ : column.id === "one" || column.id === "three" || column.id === "all" ? rank(columnRank(row, column.id)) : cotInteger(column.id === "change" ? row.weeklyChange : row[column.id as "long" | "short" | "net"], column.id === "net" || column.id === "change") })}
202
208
  emptyStateTitle="Position classes unavailable." /> : null}
203
209
  </PaneStatusBody>;
204
210
  }
@@ -300,6 +300,8 @@ const tvlValue = (value: unknown) => value === null || (isFiniteNumber(value) &&
300
300
  const changes = (entry: { change7d: unknown; change7dPercent: unknown; change30d: unknown; change30dPercent: unknown }) =>
301
301
  [entry.change7d, entry.change7dPercent, entry.change30d, entry.change30dPercent].every(nullableNumber);
302
302
 
303
+ const INCOME_FIELDS = ["fees24h", "fees7d", "fees30d", "revenue24h", "revenue7d", "revenue30d"] as const;
304
+
303
305
  export function validateDefiTvl(data: DefiTvlPayload): DefiTvlPayload {
304
306
  const history = data?.history;
305
307
  if (
@@ -323,8 +325,11 @@ export function validateDefiTvl(data: DefiTvlPayload): DefiTvlPayload {
323
325
  && isFiniteNumber(protocol.tvl)
324
326
  && protocol.tvl >= 0
325
327
  && nullableNumber(protocol.change1dPercent)
326
- && changes(protocol))
328
+ && changes(protocol)
329
+ // Fees and revenue: absent from servers before them, otherwise USD or null.
330
+ && INCOME_FIELDS.every((field) => protocol[field] === undefined || (nullableNumber(protocol[field]) && !((protocol[field] ?? 0) < 0))))
327
331
  || !nullableInstant(data.protocolsAsOf)
332
+ || !(data.incomeAsOf === undefined || nullableInstant(data.incomeAsOf))
328
333
  || !Array.isArray(data.chains)
329
334
  || data.chains.length > 500
330
335
  || !data.chains.every((chain) => !!chain
@@ -18,6 +18,7 @@ import { formatCompact, formatCompactAmount } from "../../../utils/format";
18
18
  import { usePluginPaneState } from "../../runtime";
19
19
  import {
20
20
  buildDefiColumns,
21
+ defiHasIncome,
21
22
  buildDefiRows,
22
23
  DEFAULT_DEFI_SORT,
23
24
  DEFI_LISTS,
@@ -75,6 +76,15 @@ function renderDefiCell(row: DefiRow, column: DefiColumn): DataTableCell {
75
76
  return { text: row.share == null ? "—" : `${row.share.toFixed(2)}%`, color: colors.textDim };
76
77
  case "chains":
77
78
  return { text: row.chains == null ? "—" : String(row.chains), color: colors.textDim };
79
+ case "fees24h":
80
+ case "fees7d":
81
+ case "fees30d":
82
+ case "revenue24h":
83
+ case "revenue7d":
84
+ case "revenue30d": {
85
+ const value = row[column.id];
86
+ return value == null ? { text: "—", color: colors.textDim } : { text: formatTvl(value) };
87
+ }
78
88
  }
79
89
  }
80
90
 
@@ -118,7 +128,8 @@ export function DefiTvlView({
118
128
  const [selectedId, setSelectedId] = usePluginPaneState<string | null>("defiSelected", null);
119
129
  const [sort, setSort] = useState<DefiSortPreference>(DEFAULT_DEFI_SORT);
120
130
  const rows = useMemo(() => sortDefiRows(buildDefiRows(payload, list), sort), [list, payload, sort]);
121
- const columns = useMemo(() => buildDefiColumns(width, list), [list, width]);
131
+ const income = defiHasIncome(payload);
132
+ const columns = useMemo(() => buildDefiColumns(width, list, income), [income, list, width]);
122
133
  // A chain's figures are the total's day, which its figure dates; protocols are read live, so they say when.
123
134
  const listAsOf = list === "protocol" ? defiListAsOf(payload, list) : null;
124
135
 
@@ -34,8 +34,17 @@ export interface DefiRow {
34
34
  share: number | null;
35
35
  /** How many chains a protocol is on; null for a chain. */
36
36
  chains: number | null;
37
+ /** A protocol's fees and revenue, USD over 24 hours, 7 and 30 days; null for a chain and where the source has none. */
38
+ fees24h: number | null;
39
+ fees7d: number | null;
40
+ fees30d: number | null;
41
+ revenue24h: number | null;
42
+ revenue7d: number | null;
43
+ revenue30d: number | null;
37
44
  }
38
45
 
46
+ const NO_INCOME = { fees24h: null, fees7d: null, fees30d: null, revenue24h: null, revenue7d: null, revenue30d: null } as const;
47
+
39
48
  const protocolRow = (protocol: DefiTvlProtocol, index: number): DefiRow => ({
40
49
  id: `protocol:${protocol.name}`,
41
50
  rank: index + 1,
@@ -49,6 +58,12 @@ const protocolRow = (protocol: DefiTvlProtocol, index: number): DefiRow => ({
49
58
  change30dPercent: protocol.change30dPercent,
50
59
  share: null,
51
60
  chains: protocol.chains,
61
+ fees24h: protocol.fees24h ?? null,
62
+ fees7d: protocol.fees7d ?? null,
63
+ fees30d: protocol.fees30d ?? null,
64
+ revenue24h: protocol.revenue24h ?? null,
65
+ revenue7d: protocol.revenue7d ?? null,
66
+ revenue30d: protocol.revenue30d ?? null,
52
67
  });
53
68
 
54
69
  const chainRow = (chain: DefiTvlChain, index: number): DefiRow => ({
@@ -64,6 +79,7 @@ const chainRow = (chain: DefiTvlChain, index: number): DefiRow => ({
64
79
  change30dPercent: chain.change30dPercent,
65
80
  share: chain.share,
66
81
  chains: null,
82
+ ...NO_INCOME,
67
83
  });
68
84
 
69
85
  const rowsByPayload = new WeakMap<DefiTvlPayload, Record<DefiList, DefiRow[]>>();
@@ -161,7 +177,13 @@ type DefiColumnId =
161
177
  | "change30d"
162
178
  | "change30dPercent"
163
179
  | "share"
164
- | "chains";
180
+ | "chains"
181
+ | "fees24h"
182
+ | "fees7d"
183
+ | "fees30d"
184
+ | "revenue24h"
185
+ | "revenue7d"
186
+ | "revenue30d";
165
187
 
166
188
  export type DefiColumn = DataTableColumn & { id: DefiColumnId };
167
189
 
@@ -201,6 +223,13 @@ const PROTOCOL_COLUMNS: DefiColumnSpec[] = [
201
223
  { id: "change30d", label: "30D", width: 8, align: "right", optional: 4 },
202
224
  { id: "change30dPercent", label: "30D%", width: 8, align: "right", optional: 1 },
203
225
  { id: "chains", label: "CHAINS", width: 6, align: "right", optional: 6 },
226
+ // Fees and revenue, USD, in pairs: the 30-day figures stay longest, the 7-day ones leave first.
227
+ { id: "fees24h", label: "FEES 24H", width: 8, align: "right", optional: 8 },
228
+ { id: "fees7d", label: "FEES 7D", width: 8, align: "right", optional: 9 },
229
+ { id: "fees30d", label: "FEES 30D", width: 8, align: "right", optional: 7 },
230
+ { id: "revenue24h", label: "REV 24H", width: 8, align: "right", optional: 8 },
231
+ { id: "revenue7d", label: "REV 7D", width: 8, align: "right", optional: 9 },
232
+ { id: "revenue30d", label: "REV 30D", width: 8, align: "right", optional: 7 },
204
233
  ];
205
234
 
206
235
  const CHAIN_COLUMNS: DefiColumnSpec[] = [
@@ -217,14 +246,22 @@ const CHAIN_COLUMNS: DefiColumnSpec[] = [
217
246
 
218
247
  const MAX_NAME_WIDTH = 26;
219
248
 
249
+ const INCOME_COLUMNS = new Set<DefiColumnId>(["fees24h", "fees7d", "fees30d", "revenue24h", "revenue7d", "revenue30d"]);
250
+
251
+ /** Whether the board carries the protocols' fees and revenue: a server before them, or a read that failed, has none to show. */
252
+ export function defiHasIncome(payload: DefiTvlPayload | null | undefined): boolean {
253
+ return !!payload?.incomeAsOf;
254
+ }
255
+
220
256
  /**
221
- * Optional columns leave in a fixed order as the pane narrows, dollar changes
222
- * before percents as on the stablecoin list (the chain count and the day's
223
- * move, the 30D then 7D dollar change, the category, the 30D percent); the
224
- * name takes what width is left.
257
+ * Optional columns leave in a fixed order as the pane narrows: a protocol's
258
+ * fees and revenue first, in pairs (7D, 24H, then 30D), then dollar changes before
259
+ * percents as on the stablecoin list (the chain count and the day's move, the
260
+ * 30D then 7D dollar change, the category, the 30D percent); the name takes
261
+ * what width is left.
225
262
  */
226
- export function buildDefiColumns(width: number, list: DefiList): DefiColumn[] {
227
- const specs = list === "chain" ? CHAIN_COLUMNS : PROTOCOL_COLUMNS;
263
+ export function buildDefiColumns(width: number, list: DefiList, income = false): DefiColumn[] {
264
+ const specs = list === "chain" ? CHAIN_COLUMNS : income ? PROTOCOL_COLUMNS : PROTOCOL_COLUMNS.filter((column) => !INCOME_COLUMNS.has(column.id));
228
265
  const optional = specs.flatMap((column) => column.optional ?? []).sort((a, b) => b - a);
229
266
  const dropped = new Set<number>();
230
267
  const visible = () => specs.filter((column) => !column.optional || !dropped.has(column.optional));
@@ -4,14 +4,16 @@ import type { HeadlessPaneDefinition } from "../../../types/plugin";
4
4
  import { formatCompact, formatCompactAmount } from "../../../utils/format";
5
5
  import { errorMessage } from "../../../utils/errors";
6
6
  import { fetchCryptoMarkets, fetchDefiTvl, fetchStablecoinSupply } from "./client";
7
- import { buildDefiRows, defiHistoryRows, defiHistoryStart, defiSummaryLine, type DefiList, type DefiRow } from "./defi";
7
+ import { buildDefiRows, defiHasIncome, defiHistoryRows, defiHistoryStart, defiSummaryLine, type DefiList, type DefiRow } from "./defi";
8
8
  import {
9
9
  buildCryptoRows,
10
10
  CRYPTO_BOARD_FRESHNESS,
11
11
  CRYPTO_CHANGE_BASIS_LABEL,
12
+ CRYPTO_SORT_OPTIONS,
12
13
  formatCryptoPercent,
13
14
  formatDayRangeTime,
14
15
  formatOffPeg,
16
+ sortCryptoRows,
15
17
  withCryptoSupply,
16
18
  } from "./model";
17
19
  import { stackedSupply, supplyByCode, supplyFailure, supplyHistoryRows, supplySummaryLine } from "./supply";
@@ -104,11 +106,24 @@ function supplyMetadata(payload: StablecoinSupplyPayload) {
104
106
  };
105
107
  }
106
108
 
109
+ // Every DeFi figure is in US dollars: the text header says so beside TVL, and each exported row names USD.
110
+ const TVL_COLUMN: HeadlessPaneColumn = { key: "tvl", header: "TVL", textHeader: "TVL USD", align: "right", format: compact };
111
+
112
+ /** A protocol's fees and revenue, USD: the 30-day figures stay in a narrow table longest, the 24-hour and 7-day ones only where they fit. */
113
+ const INCOME_COLUMNS: HeadlessPaneColumn[] = [
114
+ { key: "fees24h", header: "Fees 24h", literalHeader: true, align: "right", format: compact, stackPriority: 6, stackRows: 0 },
115
+ { key: "fees7d", header: "Fees 7D", literalHeader: true, align: "right", format: compact, stackPriority: 7, stackRows: 0 },
116
+ { key: "fees30d", header: "Fees 30D", literalHeader: true, align: "right", format: compact, stackPriority: 5, stackRows: 0 },
117
+ { key: "revenue24h", header: "Revenue 24h", literalHeader: true, align: "right", format: compact, stackPriority: 6, stackRows: 0 },
118
+ { key: "revenue7d", header: "Revenue 7D", literalHeader: true, align: "right", format: compact, stackPriority: 7, stackRows: 0 },
119
+ { key: "revenue30d", header: "Revenue 30D", literalHeader: true, align: "right", format: compact, stackPriority: 5, stackRows: 0 },
120
+ ];
121
+
107
122
  const PROTOCOL_COLUMNS: HeadlessPaneColumn[] = [
108
123
  { key: "rank", header: "#", align: "right" },
109
124
  { key: "name", header: "Protocol" },
110
125
  { key: "category", header: "Category", stackPriority: 2, stackRows: 0 },
111
- { key: "tvl", header: "TVL", align: "right", format: compact },
126
+ TVL_COLUMN,
112
127
  { key: "change1dPercent", header: "1D %", align: "right", format: percent, stackPriority: 3, stackRows: 0 },
113
128
  { key: "change7d", header: "7D", align: "right", format: signedCompact, stackPriority: 1, stackRows: 0 },
114
129
  { key: "change7dPercent", header: "7D %", align: "right", format: percent },
@@ -117,11 +132,13 @@ const PROTOCOL_COLUMNS: HeadlessPaneColumn[] = [
117
132
  { key: "chains", header: "Chains", align: "right", stackPriority: 4, stackRows: 0 },
118
133
  ];
119
134
 
135
+ const PROTOCOL_INCOME_COLUMNS: HeadlessPaneColumn[] = [...PROTOCOL_COLUMNS, ...INCOME_COLUMNS];
136
+
120
137
  const CHAIN_COLUMNS: HeadlessPaneColumn[] = [
121
138
  { key: "rank", header: "#", align: "right" },
122
139
  { key: "name", header: "Chain" },
123
140
  { key: "token", header: "Token", stackPriority: 2, stackRows: 0 },
124
- { key: "tvl", header: "TVL", align: "right", format: compact },
141
+ TVL_COLUMN,
125
142
  { key: "change7d", header: "7D", align: "right", format: signedCompact, stackPriority: 1, stackRows: 0 },
126
143
  { key: "change7dPercent", header: "7D %", align: "right", format: percent },
127
144
  { key: "change30d", header: "30D", align: "right", format: signedCompact, stackPriority: 0.5, stackRows: 0 },
@@ -129,7 +146,7 @@ const CHAIN_COLUMNS: HeadlessPaneColumn[] = [
129
146
  { key: "share", header: "Share", align: "right", format: share },
130
147
  ];
131
148
 
132
- function defiRecord(row: DefiRow, list: DefiList) {
149
+ function defiRecord(row: DefiRow, list: DefiList, income: boolean) {
133
150
  return {
134
151
  rank: row.rank,
135
152
  name: row.name,
@@ -140,16 +157,39 @@ function defiRecord(row: DefiRow, list: DefiList) {
140
157
  change30d: row.change30d,
141
158
  change30dPercent: row.change30dPercent,
142
159
  ...(list === "chain" ? { share: row.share } : {}),
160
+ ...(list === "protocol" && income ? {
161
+ fees24h: row.fees24h, fees7d: row.fees7d, fees30d: row.fees30d,
162
+ revenue24h: row.revenue24h, revenue7d: row.revenue7d, revenue30d: row.revenue30d,
163
+ } : {}),
164
+ unit: "USD",
143
165
  };
144
166
  }
145
167
 
168
+ const defiColumns = (list: DefiList, income: boolean) =>
169
+ list === "chain" ? CHAIN_COLUMNS : income ? PROTOCOL_INCOME_COLUMNS : PROTOCOL_COLUMNS;
170
+
171
+ /**
172
+ * The note under a protocol list: one as-of date for the whole list. Read
173
+ * within an hour of the board's day closing (the daily read, 00:00 UTC), the
174
+ * protocols' figures are that day's close and the source line dates them; a
175
+ * later read (a retry) says when it was.
176
+ */
177
+ function protocolsNote(payload: DefiTvlPayload): string {
178
+ const counted = "Protocols are read at the day's close; their versions are counted together.";
179
+ const read = payload.protocolsAsOf ? Date.parse(payload.protocolsAsOf) : Number.NaN;
180
+ const closed = payload.asOf ? Date.parse(`${payload.asOf}T00:00:00Z`) + 86_400_000 : Number.NaN;
181
+ if (!Number.isFinite(read) || (Number.isFinite(closed) && read >= closed && read - closed <= 3_600_000)) return counted;
182
+ return `Protocols as of ${isoMinute(payload.protocolsAsOf)}, the source's latest; their versions are counted together.`;
183
+ }
184
+
146
185
  /** The other list and the total's daily history, for `--csv`: one file carries the whole tab. */
147
186
  function defiExportTables(payload: DefiTvlPayload, list: DefiList): HeadlessExportTable[] {
148
187
  const other: DefiList = list === "chain" ? "protocol" : "chain";
149
- const otherRows = buildDefiRows(payload, other).map((row) => defiRecord(row, other));
188
+ const income = defiHasIncome(payload);
189
+ const otherRows = buildDefiRows(payload, other).map((row) => defiRecord(row, other, income));
150
190
  const history = defiHistoryRows(payload);
151
191
  return [
152
- ...(otherRows.length ? [{ title: other === "chain" ? "DeFi TVL by chain" : "DeFi TVL by protocol", unit: "USD", columns: other === "chain" ? CHAIN_COLUMNS : PROTOCOL_COLUMNS, rows: otherRows }] : []),
192
+ ...(otherRows.length ? [{ title: other === "chain" ? "DeFi TVL by chain" : "DeFi TVL by protocol", unit: "USD", columns: defiColumns(other, income), rows: otherRows }] : []),
153
193
  ...(history.length ? [{
154
194
  title: "Total DeFi TVL",
155
195
  unit: "USD",
@@ -167,15 +207,17 @@ function defiExportTables(payload: DefiTvlPayload, list: DefiList): HeadlessExpo
167
207
  */
168
208
  async function loadDefi(list: DefiList, ctx: Parameters<HeadlessPaneDefinition<"rows">["load"]>[1]) {
169
209
  const payload = await fetchDefiTvl(ctx.apiClient);
170
- const rows = buildDefiRows(payload, list).map((row) => defiRecord(row, list));
210
+ const income = defiHasIncome(payload);
211
+ const rows = buildDefiRows(payload, list).map((row) => defiRecord(row, list, income));
171
212
  const summary = defiSummaryLine(payload);
172
213
  const exportTables = defiExportTables(payload, list);
173
214
  return {
174
215
  rows,
175
- columns: list === "chain" ? CHAIN_COLUMNS : PROTOCOL_COLUMNS,
216
+ columns: defiColumns(list, income),
217
+ rowUnitKey: "unit",
176
218
  ...(exportTables.length ? { exportTables } : {}),
177
219
  errors: payload.warnings,
178
- ...(list === "protocol" && payload.protocolsAsOf ? { notes: [`Protocols as of ${isoMinute(payload.protocolsAsOf)}, the source's latest; their versions are counted together.`] } : {}),
220
+ ...(list === "protocol" && payload.protocolsAsOf ? { notes: [protocolsNote(payload)] } : {}),
179
221
  empty: list === "chain" ? "No chains returned." : "No protocols returned.",
180
222
  freshness: {
181
223
  source: "Gloom Cloud",
@@ -192,6 +234,8 @@ async function loadDefi(list: DefiList, ctx: Parameters<HeadlessPaneDefinition<"
192
234
  asOf: payload.asOf,
193
235
  fetchedAt: payload.fetchedAt,
194
236
  protocolsAsOf: payload.protocolsAsOf,
237
+ ...(payload.incomeAsOf !== undefined ? { incomeAsOf: payload.incomeAsOf } : {}),
238
+ unit: "USD",
195
239
  source: payload.source,
196
240
  total: payload.total,
197
241
  historyStart: defiHistoryStart(payload),
@@ -226,6 +270,16 @@ export const cryptoBoardHeadless: HeadlessPaneDefinition<"rows"> = {
226
270
  ],
227
271
  example: "--list defi --by chain",
228
272
  pluginState: { pluginId: "market-overview", key: "defiList" },
273
+ }, {
274
+ key: "sort",
275
+ // No default: a missing one is the board's market-cap order, which every list keeps.
276
+ description: "Row order: market cap (the default), or offpeg for the stablecoins furthest off their peg first, either way, with --list stablecoin.",
277
+ type: "enum",
278
+ values: [
279
+ { value: "mcap", aliases: ["cap", "marketcap", "rank"] },
280
+ { value: "offpeg", aliases: ["off-peg", "peg", "depeg"] },
281
+ ],
282
+ example: "--list stablecoin --sort offpeg",
229
283
  }],
230
284
  columns: COIN_COLUMNS,
231
285
  describe: (args) => `Crypto | ${args.options.list === "defi" ? `DeFi TVL by ${args.options.by === "chain" ? "chain" : "protocol"}` : args.options.list === "stablecoin" ? "Stablecoins" : "Coins"}`,
@@ -233,10 +287,19 @@ export const cryptoBoardHeadless: HeadlessPaneDefinition<"rows"> = {
233
287
  aliases: ["CRYP"],
234
288
  dataRequirements: ["Gloom Cloud crypto markets"],
235
289
  },
290
+ // The pane opens on the order asked for, as its header sorts it.
291
+ shotState: (args, _load, given) => {
292
+ const sort = given.has("sort") ? CRYPTO_SORT_OPTIONS[String(args.options.sort)] : undefined;
293
+ return sort ? { pluginState: { "market-overview": { sort } } } : {};
294
+ },
236
295
  // The board as the server read it, at most 15 seconds before; the pane streams, the report does not.
237
296
  // Each row keeps the time of its own last trade, so a coin that has not traded lately reads its age.
238
297
  freshness: CRYPTO_BOARD_FRESHNESS,
239
298
  async load(args, ctx) {
299
+ const offPeg = args.options.sort === "offpeg";
300
+ if (offPeg && args.options.list !== "stablecoin") {
301
+ throw new Error("--sort offpeg orders the stablecoins by how far each is off its peg: add --list stablecoin.");
302
+ }
240
303
  if (args.options.list === "defi") return loadDefi(args.options.by === "chain" ? "chain" : "protocol", ctx);
241
304
  const kind = args.options.list === "stablecoin" ? "stablecoin" : "coin" satisfies CryptoAssetKind;
242
305
  // Supply is its own request: a failure there leaves the prices whole.
@@ -247,7 +310,8 @@ export const cryptoBoardHeadless: HeadlessPaneDefinition<"rows"> = {
247
310
  : null,
248
311
  ]);
249
312
  const supply = supplyResult && "payload" in supplyResult ? supplyResult.payload : null;
250
- const rows = withCryptoSupply(buildCryptoRows(data.assets, kind, NO_QUOTES), supplyByCode(supply)).map((row) => ({
313
+ const built = withCryptoSupply(buildCryptoRows(data.assets, kind, NO_QUOTES), supplyByCode(supply));
314
+ const rows = sortCryptoRows(built, CRYPTO_SORT_OPTIONS[String(args.options.sort ?? "mcap")] ?? { columnId: null, direction: "asc" }).map((row) => ({
251
315
  rank: row.rank,
252
316
  symbol: row.asset.symbol,
253
317
  code: row.code,
@@ -282,12 +346,19 @@ export const cryptoBoardHeadless: HeadlessPaneDefinition<"rows"> = {
282
346
  pegType: row.pegType,
283
347
  } : {}),
284
348
  }));
285
- const metadata = { list: kind, status: data.status, asOf: data.asOf, generatedAt: data.generatedAt, changeBasis: CRYPTO_CHANGE_BASIS_LABEL };
286
- if (kind !== "stablecoin") return { rows, errors: data.warnings, metadata };
349
+ const metadata = {
350
+ list: kind, status: data.status, asOf: data.asOf, generatedAt: data.generatedAt, changeBasis: CRYPTO_CHANGE_BASIS_LABEL,
351
+ ...(data.marketCapBasis ? { marketCapBasis: data.marketCapBasis } : {}),
352
+ ...(offPeg ? { sort: "offpeg" } : {}),
353
+ };
354
+ // The source's own market cap can be on another supply (Toncoin's was 1.5 times price by circulating supply): the server's is circulating, and says so.
355
+ const capNote = data.marketCapBasis === "circulating" ? ["Market cap is price times circulating supply."] : [];
356
+ if (kind !== "stablecoin") return { rows, errors: data.warnings, ...(capNote.length ? { notes: capNote } : {}), metadata };
287
357
  const summary = supply ? supplySummaryLine(supply) : null;
288
358
  const history = supply ? supplyHistoryTable(supply) : null;
289
359
  // A supply outage is a caveat, not a failure: the prices are the report, and they are complete.
290
360
  const notes = [
361
+ ...capNote,
291
362
  ...(supply?.warnings ?? []),
292
363
  ...(supplyResult && "error" in supplyResult
293
364
  ? [`${supplyFailure(errorMessage(supplyResult.error)).replace(/\.$/, "")}; the prices are complete without it.`]
@@ -88,9 +88,9 @@ export interface CryptoRow extends CryptoRowSupply {
88
88
  delayed: boolean;
89
89
  /** A stablecoin's peg; null for a coin, or a server that does not send it. */
90
90
  peg: CryptoPeg | null;
91
- /** `USD`, `EUR 1.1242` (the target in dollars), `USD yield`; empty without a peg. */
91
+ /** `USD`, `EUR 1.1242` (the target in dollars), `USD yield`, `USD bond`; empty without a peg. */
92
92
  pegText: string;
93
- /** How far the price is off its target, in basis points; null when it accrues yield or the target is unknown. */
93
+ /** How far the price is off its target, in basis points; null when it accrues (yield, a bond) or the target is unknown. */
94
94
  offPegBp: number | null;
95
95
  /** The 24-hour low and high, the price shown included, and when each traded (epoch ms). */
96
96
  low24h: number | null;
@@ -227,17 +227,18 @@ function buildCryptoRow(
227
227
  /**
228
228
  * What a stablecoin's price is measured against: `USD`; a coin on another
229
229
  * currency by its target in dollars, `EUR 1.1242`, so EURC at 1.1234 does not
230
- * read as a 12% premium; a coin whose yield accrues into its price (USDY) is
231
- * marked so and has no par to be off.
230
+ * read as a 12% premium; a coin whose yield accrues into its price (USDY) or a
231
+ * bond token priced toward par at maturity (BUSD0) is marked by its kind and
232
+ * has no par to be off.
232
233
  */
233
234
  export function formatPegTarget(peg: CryptoPeg | null | undefined): string {
234
235
  if (!peg) return "";
235
- if (peg.accrues) return `${peg.currency} yield`;
236
+ if (peg.accrues) return `${peg.currency} ${peg.kind === "bond" ? "bond" : "yield"}`;
236
237
  if (peg.currency === "USD") return "USD";
237
238
  return peg.price == null ? peg.currency : `${peg.currency} ${peg.price.toFixed(4)}`;
238
239
  }
239
240
 
240
- /** Basis points off the peg, to a tenth: (price / target - 1) x 10,000. Null when the coin accrues yield or the target is unknown. */
241
+ /** Basis points off the peg, to a tenth: (price / target - 1) x 10,000. Null when the coin accrues (yield, a bond) or the target is unknown. */
241
242
  export function offPegBasisPoints(price: number, peg: CryptoPeg | null | undefined): number | null {
242
243
  if (!peg || peg.accrues || peg.price == null || !(peg.price > 0) || !(price > 0)) return null;
243
244
  return toBasisPoints((price / peg.price - 1) * 100, 1);
@@ -409,6 +410,25 @@ export interface CryptoSortPreference {
409
410
 
410
411
  export const DEFAULT_CRYPTO_SORT: CryptoSortPreference = { columnId: null, direction: "asc" };
411
412
 
413
+ /**
414
+ * `--sort` of `fn CRYP` and `shot CRYP` as the pane's header sorts it: the
415
+ * board's market-cap order, or off peg largest first, either side of par.
416
+ */
417
+ export const CRYPTO_SORT_OPTIONS: Readonly<Record<string, CryptoSortPreference>> = {
418
+ mcap: DEFAULT_CRYPTO_SORT,
419
+ offpeg: { columnId: "offPegBp", direction: "desc" },
420
+ };
421
+
422
+ /** A saved sort as the pane reads it back; anything else is the board's order. */
423
+ export function readCryptoSort(value: unknown): CryptoSortPreference {
424
+ if (!value || typeof value !== "object") return DEFAULT_CRYPTO_SORT;
425
+ const { columnId, direction } = value as Partial<CryptoSortPreference>;
426
+ return (columnId === null || (typeof columnId === "string" && SORTABLE_COLUMNS.has(columnId)))
427
+ && (direction === "asc" || direction === "desc")
428
+ ? { columnId: columnId as CryptoColumnId | null, direction }
429
+ : DEFAULT_CRYPTO_SORT;
430
+ }
431
+
412
432
  const TEXT_COLUMNS = new Set<CryptoColumnId>(["rank", "code", "name", "pegText"]);
413
433
 
414
434
  /** Numbers open largest-first (top gainers, biggest caps); names open A-Z. */
@@ -492,6 +512,10 @@ const STABLECOIN_SUPPLY_COLUMN_SPECS: CryptoColumnSpec[] = [
492
512
  { id: "supplyShare", label: "SHARE", width: 7, align: "right", optional: 3.8 },
493
513
  ];
494
514
 
515
+ /** Every column a header click sorts by: all but the sparkline. */
516
+ const SORTABLE_COLUMNS = new Set<string>([...COLUMN_SPECS, ...STABLECOIN_COLUMN_SPECS, ...STABLECOIN_SUPPLY_COLUMN_SPECS]
517
+ .map((column) => column.id).filter((id) => id !== "trend"));
518
+
495
519
  const MAX_NAME_WIDTH = 24;
496
520
 
497
521
  /**