gloomberb 0.20.2 → 0.20.4

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 (471) hide show
  1. package/README.md +1 -1
  2. package/README.zh-CN.md +1 -1
  3. package/package.json +2 -1
  4. package/src/account/auth-dialog.tsx +17 -0
  5. package/src/account/auth-form.tsx +13 -8
  6. package/src/account/upgrade-dialog.tsx +1 -1
  7. package/src/api-client/central-bank-rates.ts +5 -0
  8. package/src/api-client/data.ts +23 -4
  9. package/src/api-client/debt-maturities.ts +45 -2
  10. package/src/api-client/earnings.ts +4 -2
  11. package/src/api-client/errors.ts +21 -11
  12. package/src/api-client/fx-interventions.ts +64 -0
  13. package/src/api-client/index.ts +2 -0
  14. package/src/api-client/paths.ts +9 -1
  15. package/src/api-client/release-summaries.ts +21 -0
  16. package/src/api-client/social-mentions.ts +47 -0
  17. package/src/api-client/types/econ.ts +4 -0
  18. package/src/app/keybindings/actions.ts +2 -2
  19. package/src/app/pane-runtime/ticker-open-runtime.ts +245 -66
  20. package/src/app.tsx +11 -1
  21. package/src/cli/command-options.ts +2 -1
  22. package/src/cli/commands/market.ts +188 -30
  23. package/src/cli/commands/news-search.ts +1 -3
  24. package/src/cli/commands/options-chain.ts +23 -6
  25. package/src/cli/commands/overview.ts +13 -5
  26. package/src/cli/commands/plugins.ts +76 -23
  27. package/src/cli/commands/search.ts +25 -6
  28. package/src/cli/commands/system.ts +19 -3
  29. package/src/cli/commands/ticker.ts +64 -21
  30. package/src/cli/fx-quote-rate.ts +49 -1
  31. package/src/cli/glossary.ts +95 -15
  32. package/src/cli/history-rows.ts +9 -25
  33. package/src/cli/index.ts +14 -46
  34. package/src/cli/known-gaps.ts +3 -3
  35. package/src/cli/listing-arg.ts +78 -18
  36. package/src/cli/name-entries.ts +3 -2
  37. package/src/cli/not-a-ticker.ts +6 -2
  38. package/src/cli/pane-functions/capabilities.ts +12 -1
  39. package/src/cli/pane-functions/function-help.ts +26 -14
  40. package/src/cli/pane-functions/headless.ts +3 -1
  41. package/src/cli/pane-functions/index.ts +32 -4
  42. package/src/cli/pane-functions/market-session.ts +8 -3
  43. package/src/cli/pane-functions/resolver.ts +18 -11
  44. package/src/cli/pane-functions/screenshot-payload.ts +36 -6
  45. package/src/cli/pane-functions/screenshot-render.ts +4 -0
  46. package/src/cli/quote-answer.ts +10 -0
  47. package/src/cli/report-tables.ts +40 -8
  48. package/src/cli/result.ts +21 -9
  49. package/src/cli/spreadsheet-hint.ts +43 -0
  50. package/src/cli/symbol-list.ts +58 -4
  51. package/src/cli/symbol-rows.ts +49 -2
  52. package/src/cli/ticker-resolution.ts +98 -5
  53. package/src/cli/types.ts +2 -0
  54. package/src/cli/unknown-command.ts +88 -0
  55. package/src/components/chart/composite/axis-overlays.tsx +22 -0
  56. package/src/components/chart/composite/composite-chart.tsx +54 -13
  57. package/src/components/chart/composite/event-captions.ts +109 -0
  58. package/src/components/chart/composite/event-guides.ts +74 -0
  59. package/src/components/chart/composite/rasterizer.ts +2 -0
  60. package/src/components/chart/composite/text-renderer.ts +2 -0
  61. package/src/components/chart/composite/types.ts +31 -0
  62. package/src/components/command-bar/assist/model.ts +6 -1
  63. package/src/components/command-bar/commands/direct/index.ts +9 -1
  64. package/src/components/command-bar/commands/registry.ts +18 -0
  65. package/src/components/command-bar/layout-items/focused-pane.ts +5 -5
  66. package/src/components/command-bar/pane-actions.ts +30 -13
  67. package/src/components/command-bar/panel/index.tsx +6 -3
  68. package/src/components/command-bar/panel/prompt-binding.ts +4 -0
  69. package/src/components/command-bar/panel/types.ts +3 -0
  70. package/src/components/command-bar/routes/header-market.ts +108 -0
  71. package/src/components/command-bar/routes/root/command-items.ts +5 -0
  72. package/src/components/command-bar/routes/root/provider-search.ts +192 -33
  73. package/src/components/command-bar/routes/root/results.ts +3 -0
  74. package/src/components/command-bar/routes/root/runtime.ts +28 -5
  75. package/src/components/command-bar/routes/ticker-search/results.ts +104 -6
  76. package/src/components/command-bar/routes/ticker-search/route.ts +3 -2
  77. package/src/components/command-bar/routing/list-state.ts +38 -0
  78. package/src/components/command-bar/selection-hint.ts +28 -0
  79. package/src/components/command-bar/surface/index.tsx +41 -3
  80. package/src/components/command-bar/view-model.ts +15 -0
  81. package/src/components/command-bar/workflow/tickers.ts +3 -2
  82. package/src/components/company-logo.tsx +20 -2
  83. package/src/components/data-table/export.ts +13 -8
  84. package/src/components/feedback-dialog.tsx +2 -1
  85. package/src/components/form-modal/field-row.tsx +2 -1
  86. package/src/components/input-search-bar.tsx +2 -2
  87. package/src/components/layout/detached-pane-shell.tsx +1 -1
  88. package/src/components/layout/double-escape-close.ts +8 -5
  89. package/src/components/layout/floating-pane.tsx +5 -1
  90. package/src/components/layout/header.tsx +75 -44
  91. package/src/components/layout/market-summary.ts +322 -116
  92. package/src/components/layout/pane/footer/index.tsx +44 -19
  93. package/src/components/layout/pane/footer/model.ts +52 -20
  94. package/src/components/layout/pane/header.tsx +3 -2
  95. package/src/components/layout/shell/action-menu-overlay.tsx +10 -5
  96. package/src/components/layout/shell/active-drag.ts +149 -105
  97. package/src/components/layout/shell/chrome.ts +15 -15
  98. package/src/components/layout/shell/drag/drop-zones.ts +162 -0
  99. package/src/components/layout/shell/drag/index.ts +47 -218
  100. package/src/components/layout/shell/drag/live.ts +10 -3
  101. package/src/components/layout/shell/drag/overlays.tsx +182 -5
  102. package/src/components/layout/shell/drag/runtime.ts +29 -6
  103. package/src/components/layout/shell/drag/shared-edges.ts +156 -0
  104. package/src/components/layout/shell/index.tsx +11 -6
  105. package/src/components/layout/shell/menu.ts +11 -2
  106. package/src/components/layout/shell/native/pointer-runtime.ts +25 -0
  107. package/src/components/layout/shell/native/window-state.ts +2 -2
  108. package/src/components/layout/shell/pane/layers.tsx +71 -7
  109. package/src/components/layout/shell/terminal-pointer-runtime.ts +18 -9
  110. package/src/components/layout/shell/window-mode/index.ts +8 -10
  111. package/src/components/layout/status-bar.tsx +8 -7
  112. package/src/components/layout/status-widget-space.ts +8 -0
  113. package/src/components/layout/window-edit/mode.ts +39 -7
  114. package/src/components/layout/window-edit/presentation.ts +1 -1
  115. package/src/components/markdown-editor.tsx +2 -2
  116. package/src/components/onboarding/account-step/form-panel.tsx +0 -3
  117. package/src/components/onboarding/onboarding-keyboard.ts +19 -6
  118. package/src/components/onboarding/onboarding-wizard.tsx +69 -14
  119. package/src/components/onboarding/portfolio-step/broker-fields-panel.tsx +0 -1
  120. package/src/components/onboarding/portfolio-step/positions-panel.tsx +0 -2
  121. package/src/components/price-sparkline/model.ts +26 -10
  122. package/src/components/ticker/list-table-view.tsx +29 -4
  123. package/src/components/ui/button.tsx +15 -2
  124. package/src/components/ui/choice-dialog.tsx +1 -0
  125. package/src/components/ui/column-grid.tsx +18 -9
  126. package/src/components/ui/data-table/index.tsx +5 -4
  127. package/src/components/ui/data-table/opentui/index.tsx +2 -1
  128. package/src/components/ui/data-table/types.ts +18 -0
  129. package/src/components/ui/delayed-mark.tsx +3 -2
  130. package/src/components/ui/field-grid.tsx +0 -2
  131. package/src/components/ui/fields.tsx +7 -4
  132. package/src/components/ui/inline-quick-add.tsx +2 -2
  133. package/src/components/ui/key-hint-words.ts +153 -0
  134. package/src/components/ui/key-hints.tsx +73 -0
  135. package/src/components/ui/list-view.tsx +7 -12
  136. package/src/components/ui/loading.tsx +10 -3
  137. package/src/components/ui/menu.tsx +9 -3
  138. package/src/components/ui/message-composer.tsx +2 -2
  139. package/src/components/ui/quote.ts +14 -1
  140. package/src/components/ui/shortcut-hint.tsx +28 -3
  141. package/src/components/ui/tabs.tsx +7 -0
  142. package/src/components/ui/text-prompt-dialog.tsx +2 -1
  143. package/src/core/state/app/command-bar-launch.ts +3 -0
  144. package/src/data/config/layout.ts +5 -2
  145. package/src/data/config/store/normalize.ts +6 -0
  146. package/src/docs/snapshot.json +149 -74
  147. package/src/i18n/es.ts +33 -9
  148. package/src/i18n/ja.ts +33 -9
  149. package/src/i18n/ko.ts +33 -9
  150. package/src/i18n/zh-cn.ts +33 -9
  151. package/src/i18n/zh-tw.ts +33 -9
  152. package/src/layout/pane-manager/floating-actions.ts +17 -0
  153. package/src/layout/pane-manager/floating-stack.ts +187 -0
  154. package/src/layout/pane-manager/floating.ts +4 -2
  155. package/src/layout/pane-manager/gridlock.ts +16 -1
  156. package/src/layout/pane-manager/index.ts +11 -0
  157. package/src/layout/pane-manager/layout-state.ts +10 -3
  158. package/src/market-data/bars-per-year.ts +27 -9
  159. package/src/market-data/coordinator/quotes.ts +22 -3
  160. package/src/market-data/futures-board.ts +126 -1
  161. package/src/market-data/futures-contract.ts +21 -6
  162. package/src/market-data/fx-interventions.ts +270 -0
  163. package/src/market-data/market/change-basis.ts +2 -2
  164. package/src/market-data/market/dated-previous-close.ts +163 -47
  165. package/src/market-data/market/format.ts +14 -3
  166. package/src/market-data/market/freshness.ts +24 -7
  167. package/src/market-data/market/header-market.ts +154 -0
  168. package/src/market-data/market/index-level.ts +29 -0
  169. package/src/market-data/market/index-session-venues.ts +44 -0
  170. package/src/market-data/market/status.ts +7 -2
  171. package/src/market-data/market/venue-session.ts +72 -0
  172. package/src/market-data/model-dividend-yield.ts +23 -8
  173. package/src/market-data/options-alternatives.ts +39 -4
  174. package/src/market-data/published-apac-sessions.ts +40 -2
  175. package/src/market-data/quotes/export-identity.ts +76 -0
  176. package/src/market-data/quotes/freshness.ts +22 -0
  177. package/src/market-data/quotes/time.ts +42 -1
  178. package/src/market-data/realized-volatility.ts +11 -7
  179. package/src/market-data/tax-equivalent.ts +145 -27
  180. package/src/news/news-model.ts +44 -2
  181. package/src/plugins/builtin/account-management/pane.tsx +2 -2
  182. package/src/plugins/builtin/alerts/alert-engine.ts +12 -6
  183. package/src/plugins/builtin/alerts/alert-log.ts +6 -2
  184. package/src/plugins/builtin/alerts/calendar-events.ts +74 -12
  185. package/src/plugins/builtin/alerts/cli-forms.ts +11 -1
  186. package/src/plugins/builtin/alerts/cli-move.ts +234 -0
  187. package/src/plugins/builtin/alerts/cli.ts +223 -32
  188. package/src/plugins/builtin/alerts/command.ts +33 -6
  189. package/src/plugins/builtin/alerts/event-rows.ts +18 -4
  190. package/src/plugins/builtin/alerts/events-pane.tsx +6 -2
  191. package/src/plugins/builtin/alerts/events.ts +9 -0
  192. package/src/plugins/builtin/alerts/format.ts +39 -15
  193. package/src/plugins/builtin/alerts/headless.ts +30 -18
  194. package/src/plugins/builtin/alerts/history.ts +1 -0
  195. package/src/plugins/builtin/alerts/index.tsx +86 -12
  196. package/src/plugins/builtin/alerts/live.ts +2 -1
  197. package/src/plugins/builtin/alerts/move-checks.ts +161 -0
  198. package/src/plugins/builtin/alerts/move.ts +181 -0
  199. package/src/plugins/builtin/alerts/pane.tsx +50 -22
  200. package/src/plugins/builtin/alerts/price-text.ts +62 -0
  201. package/src/plugins/builtin/alerts/price.ts +17 -0
  202. package/src/plugins/builtin/alerts/quotes.ts +84 -3
  203. package/src/plugins/builtin/alerts/scheduled-check.ts +7 -1
  204. package/src/plugins/builtin/alerts/storage.ts +22 -7
  205. package/src/plugins/builtin/alerts/types.ts +25 -0
  206. package/src/plugins/builtin/analytics/risk-client.ts +60 -39
  207. package/src/plugins/builtin/analytics/risk-episodes.ts +18 -0
  208. package/src/plugins/builtin/analytics/risk-headless.ts +20 -4
  209. package/src/plugins/builtin/analytics/risk-model.ts +68 -1
  210. package/src/plugins/builtin/analytics/risk-pane.tsx +15 -3
  211. package/src/plugins/builtin/backtest/engine.ts +4 -2
  212. package/src/plugins/builtin/backtest/window.ts +3 -1
  213. package/src/plugins/builtin/broker-manager/sign-in-end.ts +1 -1
  214. package/src/plugins/builtin/central-bank-rates/client.ts +4 -0
  215. package/src/plugins/builtin/central-bank-rates/headless.ts +1 -1
  216. package/src/plugins/builtin/central-bank-rates/model.ts +18 -8
  217. package/src/plugins/builtin/central-bank-rates/pane.tsx +6 -3
  218. package/src/plugins/builtin/changelog/index.tsx +292 -101
  219. package/src/plugins/builtin/changelog/versions.ts +293 -0
  220. package/src/plugins/builtin/chart-composer/cli-options.ts +5 -0
  221. package/src/plugins/builtin/chart-composer/headless-schema.ts +17 -1
  222. package/src/plugins/builtin/chart-composer/headless.ts +2 -0
  223. package/src/plugins/builtin/chart-composer/intervention-events.ts +105 -0
  224. package/src/plugins/builtin/chart-composer/pane.tsx +21 -7
  225. package/src/plugins/builtin/chat/message/render-state.ts +2 -5
  226. package/src/plugins/builtin/cloud/askg/attached-pane.tsx +10 -5
  227. package/src/plugins/builtin/cloud/askg/controller.ts +141 -5
  228. package/src/plugins/builtin/cloud/askg/executor.ts +113 -4
  229. package/src/plugins/builtin/cloud/askg/manifest.ts +28 -13
  230. package/src/plugins/builtin/cloud/askg/model.ts +14 -4
  231. package/src/plugins/builtin/cloud/askg/pane.tsx +70 -46
  232. package/src/plugins/builtin/cloud/askg/turn-parts.tsx +70 -0
  233. package/src/plugins/builtin/cloud/terminal-relay/engine.ts +50 -130
  234. package/src/plugins/builtin/cloud/terminal-relay/policy.ts +327 -7
  235. package/src/plugins/builtin/cloud/terminal-relay/prompts.tsx +2 -1
  236. package/src/plugins/builtin/cloud/terminal-relay/redact.ts +47 -6
  237. package/src/plugins/builtin/cloud/upgrade-status-widget.tsx +9 -2
  238. package/src/plugins/builtin/commodities-energy/index.tsx +1 -3
  239. package/src/plugins/builtin/commodities-energy/view-state.ts +3 -0
  240. package/src/plugins/builtin/cot/headless.ts +14 -2
  241. package/src/plugins/builtin/crypto-board/headless.ts +82 -17
  242. package/src/plugins/builtin/crypto-board/index.tsx +24 -2
  243. package/src/plugins/builtin/crypto-board/model.ts +5 -2
  244. package/src/plugins/builtin/crypto-board/pane.tsx +4 -1
  245. package/src/plugins/builtin/debt-maturities/client.ts +111 -6
  246. package/src/plugins/builtin/debt-maturities/headless.ts +84 -1
  247. package/src/plugins/builtin/debt-maturities/model.ts +97 -14
  248. package/src/plugins/builtin/debt-maturities/pane.tsx +165 -15
  249. package/src/plugins/builtin/debt-maturities/series.ts +3 -1
  250. package/src/plugins/builtin/dividend-yield/client.ts +22 -6
  251. package/src/plugins/builtin/dividend-yield/headless.ts +113 -46
  252. package/src/plugins/builtin/dividend-yield/model.ts +5 -2
  253. package/src/plugins/builtin/dividend-yield/pane.tsx +6 -3
  254. package/src/plugins/builtin/dividend-yield/ranking-reads.ts +11 -4
  255. package/src/plugins/builtin/dividend-yield/ranking.ts +113 -18
  256. package/src/plugins/builtin/dividend-yield/types.ts +2 -0
  257. package/src/plugins/builtin/dividend-yield/view.ts +3 -0
  258. package/src/plugins/builtin/earnings/index.tsx +2 -2
  259. package/src/plugins/builtin/econ/calendar-model.ts +21 -3
  260. package/src/plugins/builtin/econ/detail-view.tsx +5 -3
  261. package/src/plugins/builtin/econ/figures.ts +13 -0
  262. package/src/plugins/builtin/econ/fred-catalog.ts +6 -3
  263. package/src/plugins/builtin/econ/index.tsx +5 -3
  264. package/src/plugins/builtin/econ/types.ts +5 -0
  265. package/src/plugins/builtin/equity-screener/footer.ts +45 -0
  266. package/src/plugins/builtin/equity-screener/pane.tsx +4 -18
  267. package/src/plugins/builtin/equity-screener/ticker-check.tsx +2 -1
  268. package/src/plugins/builtin/fixed-income/model.ts +1 -0
  269. package/src/plugins/builtin/futures/index.tsx +25 -4
  270. package/src/plugins/builtin/futures/model.ts +28 -32
  271. package/src/plugins/builtin/futures/series.ts +4 -3
  272. package/src/plugins/builtin/futures/table.tsx +17 -10
  273. package/src/plugins/builtin/futures/use-board-terms.ts +3 -3
  274. package/src/plugins/builtin/futures-curve/model.ts +3 -10
  275. package/src/plugins/builtin/help/function-card.tsx +2 -1
  276. package/src/plugins/builtin/help/function-index.ts +1 -0
  277. package/src/plugins/builtin/help/index.tsx +3 -3
  278. package/src/plugins/builtin/help/keybindings-editor.tsx +18 -4
  279. package/src/plugins/builtin/insider/client.ts +31 -14
  280. package/src/plugins/builtin/insider/signals-model.ts +2 -7
  281. package/src/plugins/builtin/iv-history/headless.ts +1 -2
  282. package/src/plugins/builtin/iv-history/model.ts +33 -23
  283. package/src/plugins/builtin/iv-history/screen-pane.tsx +0 -3
  284. package/src/plugins/builtin/kelly-sizer/headless.ts +64 -16
  285. package/src/plugins/builtin/kelly-sizer/history.ts +37 -28
  286. package/src/plugins/builtin/kelly-sizer/pane.tsx +43 -10
  287. package/src/plugins/builtin/kelly-sizer/sections.tsx +7 -2
  288. package/src/plugins/builtin/kelly-sizer/units.ts +29 -0
  289. package/src/plugins/builtin/layout-manager/index.tsx +8 -8
  290. package/src/plugins/builtin/news/headless.ts +2 -2
  291. package/src/plugins/builtin/news/index.tsx +10 -16
  292. package/src/plugins/builtin/news/overview-headlines.tsx +117 -0
  293. package/src/plugins/builtin/news/ticker-news.ts +35 -0
  294. package/src/plugins/builtin/news/wire/news/detail-view.tsx +8 -6
  295. package/src/plugins/builtin/news/wire/news/row.ts +49 -0
  296. package/src/plugins/builtin/news/wire/news/table.tsx +9 -20
  297. package/src/plugins/builtin/options/analytics.ts +7 -2
  298. package/src/plugins/builtin/options/live-quotes.ts +6 -1
  299. package/src/plugins/builtin/options/table.ts +3 -2
  300. package/src/plugins/builtin/options/view.tsx +11 -9
  301. package/src/plugins/builtin/options-scenario/client.ts +3 -0
  302. package/src/plugins/builtin/options-scenario/headless.ts +1 -1
  303. package/src/plugins/builtin/perps/client.ts +5 -4
  304. package/src/plugins/builtin/perps/headless.ts +134 -124
  305. package/src/plugins/builtin/perps/markets-section.tsx +7 -4
  306. package/src/plugins/builtin/perps/model.ts +8 -4
  307. package/src/plugins/builtin/perps/open-market.ts +4 -4
  308. package/src/plugins/builtin/perps/venue-markets.ts +3 -6
  309. package/src/plugins/builtin/plugin-marketplace/pane.tsx +11 -11
  310. package/src/plugins/builtin/portfolio-list/cell-version.ts +1 -0
  311. package/src/plugins/builtin/portfolio-list/cli/bulk-symbols.ts +34 -10
  312. package/src/plugins/builtin/portfolio-list/cli/period-report.ts +28 -2
  313. package/src/plugins/builtin/portfolio-list/cli/portfolio-command.ts +7 -3
  314. package/src/plugins/builtin/portfolio-list/cli/render.ts +66 -22
  315. package/src/plugins/builtin/portfolio-list/grid.tsx +5 -3
  316. package/src/plugins/builtin/portfolio-list/pane/data.ts +34 -1
  317. package/src/plugins/builtin/portfolio-list/pane/index.tsx +6 -0
  318. package/src/plugins/builtin/portfolio-list/pane/streaming.ts +15 -6
  319. package/src/plugins/builtin/portfolio-list/quick-add/resolution.ts +19 -7
  320. package/src/plugins/builtin/portfolio-list/summary/index.tsx +3 -1
  321. package/src/plugins/builtin/portfolio-list/table.tsx +30 -4
  322. package/src/plugins/builtin/realized-vol/evidence.ts +33 -6
  323. package/src/plugins/builtin/realized-vol/fx-proxy.ts +135 -0
  324. package/src/plugins/builtin/realized-vol/headless.ts +44 -8
  325. package/src/plugins/builtin/realized-vol/model.ts +9 -5
  326. package/src/plugins/builtin/realized-vol/pane.tsx +49 -15
  327. package/src/plugins/builtin/research/event-model.ts +9 -1
  328. package/src/plugins/builtin/research/event-sources.ts +22 -0
  329. package/src/plugins/builtin/research/headless.ts +3 -3
  330. package/src/plugins/builtin/sec/headless.ts +48 -6
  331. package/src/plugins/builtin/sec/index.tsx +6 -4
  332. package/src/plugins/builtin/sec/model.ts +4 -1
  333. package/src/plugins/builtin/shared/cloud-upgrade.ts +27 -3
  334. package/src/plugins/builtin/shared/earnings-calendar.ts +2 -0
  335. package/src/plugins/builtin/shared/market-cap-bands.ts +12 -0
  336. package/src/plugins/builtin/shared/report-freshness.ts +3 -1
  337. package/src/plugins/builtin/shared/use-quote-board.ts +5 -3
  338. package/src/plugins/builtin/shared/volatility/options.ts +63 -2
  339. package/src/plugins/builtin/social-mentions/headless.ts +72 -3
  340. package/src/plugins/builtin/social-mentions/index.tsx +8 -4
  341. package/src/plugins/builtin/social-mentions/lock-note.ts +6 -2
  342. package/src/plugins/builtin/social-mentions/outliers-client.ts +101 -0
  343. package/src/plugins/builtin/social-mentions/outliers-model.ts +162 -0
  344. package/src/plugins/builtin/social-mentions/outliers-names.ts +51 -0
  345. package/src/plugins/builtin/social-mentions/outliers.tsx +276 -0
  346. package/src/plugins/builtin/social-mentions/pane.tsx +32 -3
  347. package/src/plugins/builtin/supply-chain/graph-pane.tsx +2 -2
  348. package/src/plugins/builtin/thirteenf/api.ts +36 -2
  349. package/src/plugins/builtin/thirteenf/data.ts +4 -1
  350. package/src/plugins/builtin/thirteenf/headless.ts +14 -6
  351. package/src/plugins/builtin/thirteenf/model.ts +56 -1
  352. package/src/plugins/builtin/thirteenf/pane.tsx +8 -8
  353. package/src/plugins/builtin/thirteenf/report-notes.ts +11 -0
  354. package/src/plugins/builtin/thirteenf/table.ts +2 -1
  355. package/src/plugins/builtin/thirteenf/types.ts +6 -0
  356. package/src/plugins/builtin/ticker-detail/data-panes/historical-prices.tsx +23 -3
  357. package/src/plugins/builtin/ticker-detail/financials/model.ts +5 -0
  358. package/src/plugins/builtin/ticker-detail/headless-schema.ts +2 -1
  359. package/src/plugins/builtin/ticker-detail/headless.ts +21 -66
  360. package/src/plugins/builtin/ticker-detail/index.tsx +5 -0
  361. package/src/plugins/builtin/ticker-detail/overview/components.tsx +67 -6
  362. package/src/plugins/builtin/ticker-detail/overview/model.ts +6 -4
  363. package/src/plugins/builtin/ticker-detail/overview/pane.tsx +15 -0
  364. package/src/plugins/builtin/ticker-detail/overview/tax-equivalent.ts +69 -0
  365. package/src/plugins/builtin/ticker-detail/overview-tab.tsx +69 -19
  366. package/src/plugins/builtin/ticker-detail/pane.tsx +7 -2
  367. package/src/plugins/builtin/ticker-detail/quote-monitor/card.tsx +47 -24
  368. package/src/plugins/builtin/ticker-detail/quote-monitor/export.ts +46 -0
  369. package/src/plugins/builtin/ticker-detail/quote-monitor/index.tsx +20 -1
  370. package/src/plugins/builtin/ticker-detail/quote-monitor/rows.ts +120 -0
  371. package/src/plugins/builtin/ticker-detail/research-tabs.ts +1 -5
  372. package/src/plugins/builtin/ticker-detail/settings.ts +6 -6
  373. package/src/plugins/builtin/treasury-auctions/cache.ts +85 -19
  374. package/src/plugins/builtin/treasury-auctions/index.tsx +22 -11
  375. package/src/plugins/builtin/treasury-auctions/model.ts +23 -0
  376. package/src/plugins/builtin/treasury-auctions/treasury-direct.ts +128 -0
  377. package/src/plugins/builtin/world-indices/client.ts +2 -0
  378. package/src/plugins/compat.ts +15 -0
  379. package/src/plugins/host-link.ts +6 -1
  380. package/src/plugins/installer.ts +53 -3
  381. package/src/portfolio/column-values.ts +14 -4
  382. package/src/portfolio/listed-symbol.ts +78 -0
  383. package/src/portfolio/real-return.ts +172 -0
  384. package/src/public/__snapshots__/public-api.test.ts.snap +1 -0
  385. package/src/remote/resources.ts +12 -1
  386. package/src/remote/schema.ts +1 -0
  387. package/src/remote/semantic-helpers.ts +29 -1
  388. package/src/remote/semantic-tree.tsx +32 -15
  389. package/src/renderers/browser/config-host.ts +56 -15
  390. package/src/renderers/browser/main.tsx +3 -1
  391. package/src/renderers/browser/ui-host.tsx +1 -0
  392. package/src/renderers/cloudflare/http-proxy.ts +1 -0
  393. package/src/renderers/cloudflare/worker.ts +16 -1
  394. package/src/renderers/dom/boot-frame.ts +2 -2
  395. package/src/renderers/dom/data-table/row.tsx +4 -1
  396. package/src/renderers/dom/desktop/controls.tsx +4 -4
  397. package/src/renderers/dom/desktop/dialog-actions.tsx +60 -41
  398. package/src/renderers/dom/dom-ui-host.tsx +3 -1
  399. package/src/renderers/dom/host/input.tsx +4 -1
  400. package/src/renderers/dom/host/tabs.tsx +10 -1
  401. package/src/renderers/dom/styles.css +73 -19
  402. package/src/renderers/electrobun/bun/desktop/app-name.ts +1 -1
  403. package/src/renderers/opentui/host.tsx +2 -1
  404. package/src/renderers/share/layout-view.tsx +1 -1
  405. package/src/sources/gloomberb-cloud/fred-series.ts +12 -0
  406. package/src/sources/gloomberb-cloud/index.ts +31 -2
  407. package/src/sources/gloomberb-cloud/news.ts +35 -12
  408. package/src/sources/gloomberb-cloud/normalizers.ts +29 -3
  409. package/src/sources/provider-router/cached-routes.ts +19 -7
  410. package/src/state/opening-ticker-panes.ts +47 -0
  411. package/src/state/pane-table-export-registry.ts +19 -6
  412. package/src/test-support/cli-context.ts +2 -0
  413. package/src/test-support/preload.ts +8 -1
  414. package/src/theme/colors.ts +9 -1
  415. package/src/theme/themes.ts +62 -15
  416. package/src/theme/tone-contrast.ts +40 -0
  417. package/src/theme/ui-tokens.ts +23 -3
  418. package/src/tickers/batched-lookups.ts +57 -8
  419. package/src/tickers/company-name-listing.ts +156 -14
  420. package/src/tickers/company-name.ts +30 -6
  421. package/src/tickers/instrument-kind.ts +23 -3
  422. package/src/tickers/list.ts +7 -0
  423. package/src/tickers/search/home-listing.ts +31 -9
  424. package/src/tickers/search/index.ts +13 -3
  425. package/src/tickers/search/listing-index.ts +558 -0
  426. package/src/tickers/search/major-listings.chunk.ts +10 -0
  427. package/src/tickers/search/major-listings.json +3346 -0
  428. package/src/tickers/search/ranking.ts +68 -1
  429. package/src/tickers/search/types.ts +4 -0
  430. package/src/tickers/terminal-codes.ts +26 -1
  431. package/src/time-series/calendar-month-returns.ts +47 -0
  432. package/src/time-series/currency-conversion.ts +130 -0
  433. package/src/time-series/hooks.ts +2 -0
  434. package/src/time-series/price-comparison.ts +34 -11
  435. package/src/time-series/resolve-context.ts +3 -0
  436. package/src/time-series/resolve.ts +14 -2
  437. package/src/time-series/spec.ts +1 -0
  438. package/src/time-series/studies/indicators.ts +4 -1
  439. package/src/time-series/types.ts +8 -0
  440. package/src/types/config.ts +13 -0
  441. package/src/types/context-menu.ts +2 -0
  442. package/src/types/data-provider.ts +28 -0
  443. package/src/types/financials.ts +20 -2
  444. package/src/types/headless.ts +12 -0
  445. package/src/types/plugin-commands.ts +140 -0
  446. package/src/types/plugin-context.ts +125 -0
  447. package/src/types/plugin-contributions.ts +55 -0
  448. package/src/types/plugin-definition.ts +234 -0
  449. package/src/types/plugin-notifications.ts +38 -0
  450. package/src/types/plugin-pane-settings.ts +114 -0
  451. package/src/types/plugin-pane-templates.ts +160 -0
  452. package/src/types/plugin-panes.ts +221 -0
  453. package/src/types/plugin-reports.ts +35 -0
  454. package/src/types/plugin-shared.ts +14 -0
  455. package/src/types/plugin-state.ts +71 -0
  456. package/src/types/plugin.ts +14 -1169
  457. package/src/ui/host.tsx +8 -0
  458. package/src/ui/index.tsx +14 -3
  459. package/src/updater/github-releases.ts +23 -0
  460. package/src/utils/cli-output.ts +22 -9
  461. package/src/utils/datetime-format.ts +17 -3
  462. package/src/utils/display-number.ts +15 -0
  463. package/src/utils/double-escape-close.ts +61 -16
  464. package/src/utils/float32-price.ts +24 -0
  465. package/src/utils/forward-dividend.ts +81 -16
  466. package/src/utils/fx-market-hours.ts +11 -0
  467. package/src/utils/plugin-proxy-hosts.json +2 -1
  468. package/src/utils/price-history.ts +7 -6
  469. package/src/utils/report-timing.ts +62 -0
  470. package/src/utils/sec-filings.ts +32 -0
  471. package/src/utils/utc-time.ts +5 -0
@@ -17,6 +17,7 @@ import {
17
17
  withCryptoSupply,
18
18
  } from "./model";
19
19
  import { stackedSupply, supplyByCode, supplyFailure, supplyHistoryRows, supplySummaryLine } from "./supply";
20
+ import { REPORT_ROWS } from "../shared/headless-options";
20
21
 
21
22
  const NO_QUOTES = new Map();
22
23
  const number = (value: unknown) => (typeof value === "number" ? value : null);
@@ -200,15 +201,18 @@ function defiExportTables(payload: DefiTvlPayload, list: DefiList): HeadlessExpo
200
201
  ];
201
202
  }
202
203
 
204
+ /** A day's close dated `YYYY-MM-DD` reads from that day's 00:00 UTC; it is stale 36 hours after the day ends. */
205
+ const DEFI_CLOSE_STALE_MINUTES = (24 + 36) * 60;
206
+
203
207
  /**
204
208
  * `--list defi`: the largest protocols (or chains, `--by chain`) by TVL with
205
209
  * their 7D and 30D change, under the total's line. Dated by the total's day,
206
210
  * from a source that publishes it daily.
207
211
  */
208
- async function loadDefi(list: DefiList, ctx: Parameters<HeadlessPaneDefinition<"rows">["load"]>[1]) {
212
+ async function loadDefi(list: DefiList, limit: number | null, ctx: Parameters<HeadlessPaneDefinition<"rows">["load"]>[1]) {
209
213
  const payload = await fetchDefiTvl(ctx.apiClient);
210
214
  const income = defiHasIncome(payload);
211
- const rows = buildDefiRows(payload, list).map((row) => defiRecord(row, list, income));
215
+ const rows = limitRows(buildDefiRows(payload, list).map((row) => defiRecord(row, list, income)), limit);
212
216
  const summary = defiSummaryLine(payload);
213
217
  const exportTables = defiExportTables(payload, list);
214
218
  return {
@@ -225,7 +229,8 @@ async function loadDefi(list: DefiList, ctx: Parameters<HeadlessPaneDefinition<"
225
229
  status: "not-a-feed" as const,
226
230
  basis: "daily TVL",
227
231
  asOf: payload.asOf,
228
- maxAgeMinutes: 36 * 60,
232
+ // The as-of day is a close: it is aged from the day's end, not its start, and stale 36 hours after it.
233
+ maxAgeMinutes: DEFI_CLOSE_STALE_MINUTES,
229
234
  },
230
235
  metadata: {
231
236
  list: "defi",
@@ -244,18 +249,57 @@ async function loadDefi(list: DefiList, ctx: Parameters<HeadlessPaneDefinition<"
244
249
  };
245
250
  }
246
251
 
252
+ /**
253
+ * The supply columns, the supply headed with its day when that is older than
254
+ * the prices beside it (`Supply 11-04` on a board priced on the 5th): a daily
255
+ * supply figure says its date, as the prices say theirs.
256
+ */
257
+ function datedSupplyColumns(supplyAsOf: string | null | undefined, pricesAsOf: string | null | undefined): HeadlessPaneColumn[] {
258
+ const supplyDay = supplyAsOf?.slice(0, 10);
259
+ const pricesDay = pricesAsOf?.slice(0, 10);
260
+ if (!supplyDay || !pricesDay || supplyDay >= pricesDay) return STABLECOIN_SUPPLY_COLUMNS;
261
+ return STABLECOIN_SUPPLY_COLUMNS.map((column) => column.key === "supply" ? { ...column, textHeader: `Supply ${supplyDay.slice(5)}` } : column);
262
+ }
263
+
264
+ /** The first `limit` rows, in the list's order; every row without one. */
265
+ function limitRows<T>(rows: T[], limit: number | null): T[] {
266
+ return limit == null ? rows : rows.slice(0, limit);
267
+ }
268
+
269
+ /** The board's lists, as `--list` and the word after CRYP name them. */
270
+ const CRYPTO_LISTS = [
271
+ { value: "coin", aliases: ["coins"] },
272
+ { value: "stablecoin", aliases: ["stablecoins", "stable", "stables"] },
273
+ { value: "defi", aliases: ["tvl"] },
274
+ ] as const;
275
+ export type CryptoList = (typeof CRYPTO_LISTS)[number]["value"];
276
+
277
+ /**
278
+ * The list a word after CRYP names (`stablecoins`, `tvl`, `--list defi`),
279
+ * null for none typed; any other word is refused with the lists there are.
280
+ */
281
+ export function cryptoListOf(typed: string | null | undefined): CryptoList | null {
282
+ const word = (typed ?? "").trim().replace(/^--list(?:\s+|=)/i, "").trim().toLowerCase();
283
+ if (!word) return null;
284
+ const list = CRYPTO_LISTS.find((entry) => entry.value === word || (entry.aliases as readonly string[]).includes(word));
285
+ if (list) return list.value;
286
+ throw new Error(`No list "${typed!.trim()}". CRYP lists: coin, stablecoin, defi (or tvl).`);
287
+ }
288
+
289
+ /** The list a run asked for: the word after CRYP, else --list. */
290
+ function requestedList(args: { argument: string | string[] | null; options: Record<string, unknown> }): CryptoList {
291
+ const typed = Array.isArray(args.argument) ? args.argument.join(" ") : args.argument;
292
+ return cryptoListOf(typed) ?? (args.options.list === "defi" || args.options.list === "stablecoin" ? args.options.list : "coin");
293
+ }
294
+
247
295
  export const cryptoBoardHeadless: HeadlessPaneDefinition<"rows"> = {
248
296
  shape: "rows",
249
- argument: { kind: "none" },
297
+ argument: { kind: "free-text", optional: true, placeholder: "list", description: "The list to open, as --list names it: coin, stablecoin, or defi (tvl).", examples: ["stablecoin", "tvl"] },
250
298
  options: [{
251
299
  key: "list",
252
300
  description: "Coins, stablecoins, or DeFi TVL.",
253
301
  type: "enum",
254
- values: [
255
- { value: "coin", aliases: ["coins"] },
256
- { value: "stablecoin", aliases: ["stablecoins", "stable", "stables"] },
257
- { value: "defi", aliases: ["tvl"] },
258
- ],
302
+ values: CRYPTO_LISTS.map((entry) => ({ value: entry.value, aliases: [...entry.aliases] })),
259
303
  defaultValue: "coin",
260
304
  example: "--list stablecoin",
261
305
  pluginState: { pluginId: "market-overview", key: "activeTab" },
@@ -280,28 +324,48 @@ export const cryptoBoardHeadless: HeadlessPaneDefinition<"rows"> = {
280
324
  { value: "offpeg", aliases: ["off-peg", "peg", "depeg"] },
281
325
  ],
282
326
  example: "--list stablecoin --sort offpeg",
327
+ }, {
328
+ key: "limit",
329
+ shot: REPORT_ROWS,
330
+ description: "Rows to list, in the list's order: every row unless given.",
331
+ type: "integer",
332
+ minimum: 1,
333
+ maximum: 1000,
334
+ example: "--limit 10",
283
335
  }],
284
336
  columns: COIN_COLUMNS,
285
- describe: (args) => `Crypto | ${args.options.list === "defi" ? `DeFi TVL by ${args.options.by === "chain" ? "chain" : "protocol"}` : args.options.list === "stablecoin" ? "Stablecoins" : "Coins"}`,
337
+ describe: (args) => {
338
+ const list = requestedList(args);
339
+ return `Crypto | ${list === "defi" ? `DeFi TVL by ${args.options.by === "chain" ? "chain" : "protocol"}` : list === "stablecoin" ? "Stablecoins" : "Coins"}`;
340
+ },
286
341
  discovery: {
287
342
  aliases: ["CRYP"],
343
+ // `fn TVL` is the DeFi list and `fn STABLECOINS` the stablecoins, not the coins.
344
+ opens: [
345
+ { words: ["TVL", "defi", "defi tvl", "total value locked"], argument: "defi" },
346
+ { words: ["stablecoin", "stablecoins", "stables", "stablecoin supply"], argument: "stablecoin" },
347
+ ],
288
348
  dataRequirements: ["Gloom Cloud crypto markets"],
289
349
  },
290
350
  // The pane opens on the order asked for, as its header sorts it.
291
351
  shotState: (args, _load, given) => {
292
352
  const sort = given.has("sort") ? CRYPTO_SORT_OPTIONS[String(args.options.sort)] : undefined;
293
- return sort ? { pluginState: { "market-overview": { sort } } } : {};
353
+ const typed = cryptoListOf(Array.isArray(args.argument) ? args.argument.join(" ") : args.argument);
354
+ const state = { ...(sort ? { sort } : {}), ...(typed ? { activeTab: typed } : {}) };
355
+ return Object.keys(state).length ? { pluginState: { "market-overview": state } } : {};
294
356
  },
295
357
  // The board as the server read it, at most 15 seconds before; the pane streams, the report does not.
296
358
  // Each row keeps the time of its own last trade, so a coin that has not traded lately reads its age.
297
359
  freshness: CRYPTO_BOARD_FRESHNESS,
298
360
  async load(args, ctx) {
361
+ const list = requestedList(args);
299
362
  const offPeg = args.options.sort === "offpeg";
300
- if (offPeg && args.options.list !== "stablecoin") {
363
+ if (offPeg && list !== "stablecoin") {
301
364
  throw new Error("--sort offpeg orders the stablecoins by how far each is off its peg: add --list stablecoin.");
302
365
  }
303
- if (args.options.list === "defi") return loadDefi(args.options.by === "chain" ? "chain" : "protocol", ctx);
304
- const kind = args.options.list === "stablecoin" ? "stablecoin" : "coin" satisfies CryptoAssetKind;
366
+ const limit = args.options.limit == null ? null : Number(args.options.limit);
367
+ if (list === "defi") return loadDefi(args.options.by === "chain" ? "chain" : "protocol", limit, ctx);
368
+ const kind = list === "stablecoin" ? "stablecoin" : "coin" satisfies CryptoAssetKind;
305
369
  // Supply is its own request: a failure there leaves the prices whole.
306
370
  const [data, supplyResult] = await Promise.all([
307
371
  fetchCryptoMarkets(ctx.apiClient),
@@ -311,7 +375,7 @@ export const cryptoBoardHeadless: HeadlessPaneDefinition<"rows"> = {
311
375
  ]);
312
376
  const supply = supplyResult && "payload" in supplyResult ? supplyResult.payload : null;
313
377
  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) => ({
378
+ const rows = limitRows(sortCryptoRows(built, CRYPTO_SORT_OPTIONS[String(args.options.sort ?? "mcap")] ?? { columnId: null, direction: "asc" }), limit).map((row) => ({
315
379
  rank: row.rank,
316
380
  symbol: row.asset.symbol,
317
381
  code: row.code,
@@ -358,7 +422,8 @@ export const cryptoBoardHeadless: HeadlessPaneDefinition<"rows"> = {
358
422
  const history = supply ? supplyHistoryTable(supply) : null;
359
423
  // A supply outage is a caveat, not a failure: the prices are the report, and they are complete.
360
424
  const notes = [
361
- ...capNote,
425
+ // A coin with a supply is valued on it, so its row counts one supply.
426
+ ...(supply?.coins.length ? ["Market cap is price times the supply shown, else times circulating supply."] : capNote),
362
427
  ...(supply?.warnings ?? []),
363
428
  ...(supplyResult && "error" in supplyResult
364
429
  ? [`${supplyFailure(errorMessage(supplyResult.error)).replace(/\.$/, "")}; the prices are complete without it.`]
@@ -366,7 +431,7 @@ export const cryptoBoardHeadless: HeadlessPaneDefinition<"rows"> = {
366
431
  ];
367
432
  return {
368
433
  rows,
369
- columns: supply?.coins.length ? STABLECOIN_SUPPLY_COLUMNS : STABLECOIN_COLUMNS,
434
+ columns: supply?.coins.length ? datedSupplyColumns(supply.asOf, data.asOf) : STABLECOIN_COLUMNS,
370
435
  ...(history ? { exportTables: [history] } : {}),
371
436
  errors: data.warnings,
372
437
  ...(notes.length ? { notes } : {}),
@@ -2,7 +2,9 @@ import type { PluginModule } from "../plugin-module";
2
2
  import { LIVE_STREAMING_QUICK_SETTING, withLiveStreamingSetting } from "../../../state/hooks/live-streaming";
3
3
  import { cryptoMarketsCache, DEFI_TVL_CACHES, STABLECOIN_SUPPLY_CACHES } from "./client";
4
4
  import { BITCOIN_NETWORK_CACHES } from "./bitcoin-network";
5
- import { cryptoBoardHeadless } from "./headless";
5
+ import { cryptoBoardHeadless, cryptoListOf } from "./headless";
6
+ import { errorMessage } from "../../../utils/errors";
7
+ import { commandTabParams } from "../shared/command-tab";
6
8
  import { CRYPTO_SERIES } from "./series";
7
9
 
8
10
  export const cryptoBoardModule: PluginModule = {
@@ -32,8 +34,28 @@ export const cryptoBoardModule: PluginModule = {
32
34
  "crypto", "cryp", "bitcoin", "ethereum", "coins", "stablecoins", "stablecoin supply", "digital", "currency",
33
35
  "defi", "tvl", "total value locked", "defi tvl", "on-chain", "onchain", "aave", "lido", "protocols", "chains",
34
36
  ],
35
- shortcut: { prefix: "CRYP" },
37
+ // `CRYP stablecoin` and `CRYP tvl` open those lists; CRYP alone opens on the list the pane was last on.
38
+ shortcut: {
39
+ prefix: "CRYP", argKind: "text", argPlaceholder: "list", argOptional: true, openWithoutArg: true,
40
+ argOptions: () => [
41
+ { value: "coin", label: "Coins" },
42
+ { value: "stablecoin", label: "Stablecoins" },
43
+ { value: "defi", label: "DeFi TVL" },
44
+ ],
45
+ argError: (arg) => {
46
+ try {
47
+ cryptoListOf(arg);
48
+ return null;
49
+ } catch (error) {
50
+ return { message: errorMessage(error), detail: "Type CRYP coin, CRYP stablecoin or CRYP tvl." };
51
+ }
52
+ },
53
+ },
36
54
  headless: cryptoBoardHeadless,
55
+ createInstance: (_context, options) => {
56
+ const list = cryptoListOf(options?.arg);
57
+ return { placement: "floating", ...(list ? { params: commandTabParams(list) } : {}) };
58
+ },
37
59
  },
38
60
  ],
39
61
  setup(ctx) {
@@ -313,7 +313,10 @@ const suppliedRows = new WeakMap<CryptoRow, { supply: CryptoRowSupply; row: Cryp
313
313
 
314
314
  /**
315
315
  * Each row with its coin's supply, matched by code. A row keeps its identity
316
- * while its price and its supply hold, so the table still skips it.
316
+ * while its price and its supply hold, so the table still skips it. A row with
317
+ * a supply is valued on it: its market cap is its price times the supply it
318
+ * shows, so the row counts one supply (USDT's Supply 178.16B at 0.9984 read
319
+ * beside a market cap on another supply, 177.42B).
317
320
  */
318
321
  export function withCryptoSupply(rows: readonly CryptoRow[], supply: ReadonlyMap<string, CryptoRowSupply>): CryptoRow[] {
319
322
  if (supply.size === 0) return rows as CryptoRow[];
@@ -322,7 +325,7 @@ export function withCryptoSupply(rows: readonly CryptoRow[], supply: ReadonlyMap
322
325
  if (!own) return row;
323
326
  const cached = suppliedRows.get(row);
324
327
  if (cached && cached.supply === own) return cached.row;
325
- const supplied = { ...row, ...own };
328
+ const supplied = { ...row, ...own, ...(own.supply != null && own.supply > 0 ? { marketCap: own.supply * row.price } : {}) };
326
329
  suppliedRows.set(row, { supply: own, row: supplied });
327
330
  return supplied;
328
331
  });
@@ -36,6 +36,7 @@ import { publicTickerKey } from "../../../utils/exchanges";
36
36
  import { formatCompact, formatCompactAmount } from "../../../utils/format";
37
37
  import { SERIES_COLORS } from "../../../theme/series-colors";
38
38
  import { usePluginPaneState, usePluginTickerActions } from "../../runtime";
39
+ import { useCommandTab } from "../shared/command-tab";
39
40
  import { useLiveStreamingSetting } from "../../../state/hooks/live-streaming";
40
41
  import { useResearchCloudSession } from "../shared/research-cloud-session";
41
42
  import { INITIAL_STREAM_RANGE, streamWindowRows } from "../shared/use-quote-board";
@@ -74,6 +75,7 @@ const CRYPTO_BOARD_REFRESH_MS = 15_000;
74
75
  const CRYPTO_BOARD_STREAMING_REFRESH_MS = 60_000;
75
76
 
76
77
  const NO_QUOTES = new Map<string, QueryEntry<Quote>>();
78
+ const CRYPTO_TAB_VALUES = CRYPTO_TABS.map((tab) => tab.value);
77
79
 
78
80
  /** Supply moves once a day; the server reads its source daily, so half-hourly is plenty. */
79
81
  const SUPPLY_REFRESH_MS = 30 * 60_000;
@@ -192,7 +194,8 @@ export function CryptoBoardPane({ width, height, focused }: PaneProps) {
192
194
  const data = resource.data?.payload;
193
195
  const { pinTicker } = usePluginTickerActions();
194
196
  const liveStreaming = useLiveStreamingSetting();
195
- const [activeTab, setActiveTab] = usePluginPaneState<CryptoTab>("activeTab", "coin");
197
+ // `CRYP stablecoin` and `CRYP tvl` open on that list, again each time either is typed.
198
+ const [activeTab, setActiveTab] = useCommandTab<CryptoTab>("crypto-board", "activeTab", CRYPTO_TAB_VALUES, "coin");
196
199
  const [selectedId, setSelectedId] = usePluginPaneState<string | null>("selected", null);
197
200
  // Kept with the pane, so `shot CRYP --sort offpeg` opens on the order it asked for.
198
201
  const [savedSort, setSavedSort] = usePluginPaneState<unknown>("sort", DEFAULT_CRYPTO_SORT);
@@ -1,5 +1,6 @@
1
1
  import { apiClient } from "../../../api-client";
2
2
  import type {
3
+ DebtBand,
3
4
  DebtFact,
4
5
  DebtMaturitiesPayload,
5
6
  DebtMetric,
@@ -18,7 +19,9 @@ import {
18
19
  export const debtMaturitiesCache = createPluginCache<DebtMaturitiesPayload>({
19
20
  kind: "debt-maturities",
20
21
  source: "gloom-cloud",
21
- schemaVersion: 1,
22
+ // 2: payloads that can hold a schedule in its filing's own bands, so an
23
+ // answer cached before them (one that left the schedule out) is asked again.
24
+ schemaVersion: 2,
22
25
  policy: { staleMs: 6 * 60 * 60_000, expireMs: 14 * 24 * 60 * 60_000 },
23
26
  });
24
27
  export const BUCKET_IDS = [
@@ -60,6 +63,11 @@ const currency = (value: unknown) =>
60
63
  const sourceUrl = (value: unknown) =>
61
64
  typeof value === "string" &&
62
65
  /^https:\/\/(?:www\.|data\.)?sec\.gov\//.test(value);
66
+ /** A report's own page or document, wherever it is published. */
67
+ const httpsUrl = (value: unknown) =>
68
+ typeof value === "string" && URL.canParse(value) && new URL(value).protocol === "https:";
69
+ /** SEC's annual forms a schedule by year is read from. */
70
+ const ANNUAL_FORM = /^(10-K|20-F|40-F)(\/A)?$/;
63
71
  const near = (a: number | null, b: number | null) =>
64
72
  a === b ||
65
73
  (a !== null &&
@@ -79,7 +87,7 @@ function validFact(fact: DebtFact): boolean {
79
87
  fact.end <= fact.filed &&
80
88
  (fact.start === null || fact.start <= fact.end) &&
81
89
  accession(fact.accession) &&
82
- /^(10-K|20-F)(\/A)?$/.test(fact.form)
90
+ ANNUAL_FORM.test(fact.form)
83
91
  );
84
92
  }
85
93
  function validMetric(
@@ -164,6 +172,8 @@ export function validateDebtMaturities(
164
172
  data: DebtMaturitiesPayload,
165
173
  symbol: string,
166
174
  ): DebtMaturitiesPayload {
175
+ if (data?.version === 2 && typeof data.latest === "object" && data.latest !== null && "sourceBuckets" in data.latest)
176
+ return validateBands(data, symbol);
167
177
  if (!data || typeof data !== "object" || !("latestQuarter" in data)) return validateSchedule(data, symbol);
168
178
  const { latestQuarter, ...schedule } = data;
169
179
  const valid = validateSchedule(schedule, symbol);
@@ -177,13 +187,17 @@ function validateSchedule(
177
187
  const invalid = (): never => {
178
188
  throw new Error("The server returned an invalid debt maturity schedule");
179
189
  };
190
+ // Version 2 answers a schedule in its filing's own bands (validateBands),
191
+ // and a company with none as version 1 does, under any standard and with
192
+ // the report's link, or none.
193
+ const v2 = data?.version === 2;
180
194
  if (
181
195
  !data ||
182
- data.version !== 1 ||
196
+ (data.version !== 1 && !v2) ||
183
197
  data.symbol !== symbol ||
184
198
  !["available", "partial", "unavailable"].includes(data.status) ||
185
199
  !textOrNull(data.entityName) ||
186
- !["us-gaap", null].includes(data.taxonomy) ||
200
+ !(v2 && data.latest === null ? ["us-gaap", "ifrs-full", "cn-cas", null] : ["us-gaap", null]).includes(data.taxonomy) ||
187
201
  !(
188
202
  data.cik === null ||
189
203
  (typeof data.cik === "string" && /^\d{10}$/.test(data.cik))
@@ -193,7 +207,7 @@ function validateSchedule(
193
207
  !nullableDay(data.asOf) ||
194
208
  !data.source ||
195
209
  typeof data.source.name !== "string" ||
196
- !sourceUrl(data.source.url) ||
210
+ !(sourceUrl(data.source.url) || (v2 && data.latest === null && (data.source.url === "" || httpsUrl(data.source.url)))) ||
197
211
  typeof data.source.cadence !== "string" ||
198
212
  !Array.isArray(data.warnings) ||
199
213
  data.warnings.some((value) => typeof value !== "string") ||
@@ -220,7 +234,7 @@ function validateSchedule(
220
234
  !day(latest.filed) ||
221
235
  latest.asOf > latest.filed ||
222
236
  !accession(latest.accession) ||
223
- !/^(10-K|20-F)(\/A)?$/.test(latest.form) ||
237
+ !ANNUAL_FORM.test(latest.form) ||
224
238
  !currency(latest.currency) ||
225
239
  !sourceUrl(latest.filingUrl) ||
226
240
  typeof latest.complete !== "boolean" ||
@@ -385,6 +399,91 @@ function validateSchedule(
385
399
  return data;
386
400
  }
387
401
 
402
+ /** A report's accession (an SEC one, HKEX-2026040800985, a receipt number) and form (20-F, HKEX, ESEF). */
403
+ const reportAccession = (value: unknown) => typeof value === "string" && /^[A-Za-z0-9][A-Za-z0-9-]{0,79}$/.test(value);
404
+ const reportForm = (value: unknown) => typeof value === "string" && /^[A-Z0-9][A-Z0-9/-]{1,11}$/.test(value);
405
+ const BAND_TAXONOMIES: readonly unknown[] = ["ifrs-full", "cn-cas"];
406
+ const AMOUNT_BASES: readonly unknown[] = ["principal", "carrying", "contractual_undiscounted"];
407
+
408
+ /**
409
+ * Bands that cover the schedule from the balance-sheet date on, in order,
410
+ * each starting where the last ended; only the last may be open ended.
411
+ */
412
+ function validBands(bands: readonly DebtBand[]): boolean {
413
+ let from = 0;
414
+ for (const [index, band] of bands.entries()) {
415
+ if (
416
+ !band ||
417
+ typeof band.label !== "string" ||
418
+ !band.label.trim() ||
419
+ !number(band.value) ||
420
+ band.fromMonths !== from ||
421
+ !Array.isArray(band.members) ||
422
+ band.members.some((member) => typeof member !== "string") ||
423
+ (band.toMonths === null
424
+ ? index !== bands.length - 1
425
+ : !Number.isInteger(band.toMonths) || band.toMonths <= band.fromMonths)
426
+ )
427
+ return false;
428
+ from = band.toMonths ?? from;
429
+ }
430
+ return bands.length > 0;
431
+ }
432
+
433
+ /**
434
+ * A schedule in its filing's own bands (version 2): an IFRS or China CAS
435
+ * ladder, as reported, with what its amounts are and the report it came
436
+ * from. Its yearly buckets and principal figures are not read, so they are
437
+ * not checked; a 10-Q beside it is not read either.
438
+ */
439
+ function validateBands(data: DebtMaturitiesPayload, symbol: string): DebtMaturitiesPayload {
440
+ const latest = data.latest!;
441
+ const bands = latest.sourceBuckets;
442
+ const interest = latest.interestExpenseFact;
443
+ const source = latest.source;
444
+ if (
445
+ data.symbol !== symbol ||
446
+ !["available", "partial"].includes(data.status) ||
447
+ !textOrNull(data.entityName) ||
448
+ !BAND_TAXONOMIES.includes(data.taxonomy) ||
449
+ latest.taxonomy !== data.taxonomy ||
450
+ !(data.cik === null || (typeof data.cik === "string" && /^\d{10}$/.test(data.cik))) ||
451
+ typeof data.fetchedAt !== "string" ||
452
+ !Number.isFinite(Date.parse(data.fetchedAt)) ||
453
+ !data.source ||
454
+ typeof data.source.name !== "string" ||
455
+ !httpsUrl(data.source.url) ||
456
+ typeof data.source.cadence !== "string" ||
457
+ !Array.isArray(data.warnings) ||
458
+ data.warnings.some((value) => typeof value !== "string") ||
459
+ !Array.isArray(data.history) ||
460
+ !day(latest.asOf) ||
461
+ latest.asOf !== data.asOf ||
462
+ !day(latest.filed) ||
463
+ latest.asOf > latest.filed ||
464
+ !reportAccession(latest.accession) ||
465
+ !reportForm(latest.form) ||
466
+ !currency(latest.currency) ||
467
+ !httpsUrl(latest.filingUrl) ||
468
+ !AMOUNT_BASES.includes(latest.amountBasis) ||
469
+ !Array.isArray(bands) ||
470
+ !validBands(bands) ||
471
+ !near(latest.sourceTotal ?? null, bands.reduce((sum, band) => sum + band.value, 0)) ||
472
+ (interest !== null &&
473
+ !(interest && number(interest.value) && typeof interest.tag === "string" && interest.unit === latest.currency &&
474
+ nullableDay(interest.start) && day(interest.end))) ||
475
+ (source != null &&
476
+ !(httpsUrl(source.url) && typeof source.concept === "string" && number(source.scale) && source.scale > 0 &&
477
+ typeof source.scaleStated === "boolean" &&
478
+ (source.reconciledTo == null ||
479
+ (typeof source.reconciledTo.concept === "string" && number(source.reconciledTo.value) &&
480
+ number(source.reconciledTo.ratio)))))
481
+ )
482
+ throw new Error("The server returned an invalid debt maturity schedule");
483
+ const { latestQuarter: _quarter, ...schedule } = data;
484
+ return schedule;
485
+ }
486
+
388
487
  /** The symbol the server answers with: a listing abroad's bare symbol, otherwise the one sent. */
389
488
  const answeredSymbol = (symbol: string, listing?: IssuerListingParams) =>
390
489
  listingAbroad(symbol, listing?.exchange)?.symbol ?? symbol;
@@ -409,9 +508,15 @@ export async function fetchDebtMaturities(
409
508
  );
410
509
  } catch (error) {
411
510
  if (abroad && error instanceof ApiRequestError && error.status === 404) return noSchedule(answered);
511
+ // The server sends its own payload with a 503 when no schedule could be
512
+ // read (SEC or the store failing): said in one line, its status kept so a
513
+ // saved copy still answers for it.
514
+ if (error instanceof ApiRequestError && (error.status ?? 0) >= 500)
515
+ throw new ApiRequestError(NOT_READ, error.status, error.retryAfterMs, error.code, error.details);
412
516
  throw unavailableOnServer(error, "Debt maturities are not available yet.");
413
517
  }
414
518
  }
519
+ const NOT_READ = "No maturity schedule could be read for this listing.";
415
520
 
416
521
  function noSchedule(symbol: string): DebtMaturitiesPayload {
417
522
  return {
@@ -1,6 +1,11 @@
1
+ import type { DebtMaturitiesPayload } from "../../../api-client/debt-maturities";
2
+ import type { HeadlessBundleSection } from "../../../types/headless";
1
3
  import type { HeadlessPaneDefinition } from "../../../types/plugin";
2
4
  import { fetchDebtMaturities } from "./client";
3
- import { bucketShare, debtAmount, debtCostProxyNote, debtHistoryRows, debtNewestAsOf, debtNewestForm, debtNotices, debtPercent, newerQuarter } from "./model";
5
+ import {
6
+ bandScaleText, bandTotal, bucketShare, debtAmount, debtBands, debtBasis, debtCostProxyNote, debtHistoryRows, debtNewestAsOf,
7
+ debtNewestForm, debtNotices, debtPercent, debtStandard, maturityRows, newerQuarter, type DebtLatest,
8
+ } from "./model";
4
9
  import { SEC_FILINGS } from "../shared/report-freshness";
5
10
  import { resolveHeadlessIssuerListing } from "../shared/headless-market-data";
6
11
 
@@ -8,6 +13,72 @@ import { resolveHeadlessIssuerListing } from "../shared/headless-market-data";
8
13
  const amount = (value: unknown) => debtAmount(typeof value === "number" ? value : null);
9
14
  const percent = (value: unknown) => debtPercent(typeof value === "number" ? value : null);
10
15
 
16
+ /**
17
+ * A schedule in its filing's own bands, as the pane shows it: each band as
18
+ * reported with its share of their total, then the filing (standard, what the
19
+ * amounts are, how the report states them, the report's link). Exports name
20
+ * the basis on every row, so the amount column reads the same for every
21
+ * company; the text report heads it with the basis.
22
+ */
23
+ function bandSections(data: DebtMaturitiesPayload, latest: DebtLatest): HeadlessBundleSection[] {
24
+ const basis = debtBasis(latest);
25
+ const standard = debtStandard(latest.taxonomy);
26
+ const columns = [
27
+ { key: "label", header: "Maturity" },
28
+ { key: "value", header: "Amount", align: "right" as const, textFormat: amount },
29
+ { key: "currency", header: "Currency" },
30
+ { key: "share", header: "% total", align: "right" as const, textFormat: percent },
31
+ { key: "asOf", header: "As of" },
32
+ { key: "filed", header: "Filed" },
33
+ ];
34
+ const source = latest.source;
35
+ const check = source?.reconciledTo;
36
+ const filing: Array<[string, string | null | undefined]> = [
37
+ ["Standard", standard],
38
+ ["Basis", basis.detail ? `${basis.words} (${basis.detail})` : basis.words],
39
+ [basis.total, `${debtAmount(bandTotal(debtBands(latest)!))} ${latest.currency}`],
40
+ ["Reported in", source ? bandScaleText(latest.currency, source.scale, source.scaleStated) : latest.currency],
41
+ ["Form", latest.form],
42
+ ["Accession", latest.accession],
43
+ ["Table", source?.concept],
44
+ ["Checked against", check ? `${check.concept} (${check.ratio.toFixed(2)}x)` : null],
45
+ ["Lease liabilities", latest.includesLeases ? "Included" : null],
46
+ ["Report", latest.filingUrl],
47
+ ];
48
+ return [
49
+ {
50
+ title: "Maturity schedule as reported",
51
+ textTitle: `Maturity schedule as reported (${[basis.words, standard].filter(Boolean).join(", ")})`,
52
+ columns: [
53
+ ...columns.slice(0, 2),
54
+ { key: "basis", header: "Basis" },
55
+ { key: "fromMonths", header: "From month" },
56
+ { key: "toMonths", header: "To month" },
57
+ ...columns.slice(2),
58
+ { key: "readFrom", header: "Read from" },
59
+ ],
60
+ textColumns: [columns[0]!, { ...columns[1]!, header: basis.amount }, ...columns.slice(2)],
61
+ rows: maturityRows(latest).map((row) => ({
62
+ label: row.label,
63
+ value: row.value,
64
+ basis: latest.amountBasis ?? "principal",
65
+ fromMonths: row.band!.fromMonths,
66
+ toMonths: row.band!.toMonths,
67
+ currency: latest.currency,
68
+ share: row.share,
69
+ asOf: latest.asOf,
70
+ filed: latest.filed,
71
+ readFrom: row.band!.members.join(" + "),
72
+ })),
73
+ },
74
+ {
75
+ title: "Filing",
76
+ columns: [{ key: "field", header: "Field" }, { key: "value", header: "Value" }],
77
+ rows: filing.flatMap(([field, value]) => (value ? [{ field, value }] : [])),
78
+ },
79
+ ];
80
+ }
81
+
11
82
  export const debtMaturitiesHeadless: HeadlessPaneDefinition<"bundle"> = {
12
83
  shape: "bundle",
13
84
  freshness: SEC_FILINGS,
@@ -45,6 +116,18 @@ export const debtMaturitiesHeadless: HeadlessPaneDefinition<"bundle"> = {
45
116
  async load(args, ctx) {
46
117
  const symbol = args.symbols[0]!;
47
118
  const data = await fetchDebtMaturities(symbol, ctx.apiClient, await resolveHeadlessIssuerListing(ctx, symbol));
119
+ const latest = data.latest;
120
+ if (latest && debtBands(latest)) {
121
+ return {
122
+ complete: data.status === "available",
123
+ errors: debtNotices(data),
124
+ sections: bandSections(data, latest),
125
+ metadata: { ...data },
126
+ // Dated by the report's balance sheet: an SEC filing named by its form, a report outside SEC cited
127
+ // as the server names it (its form, HKEX or CNINFO, would repeat that name).
128
+ freshness: data.cik ? { asOf: latest.asOf, asOfLabel: latest.form } : { asOf: latest.asOf, source: data.source.name },
129
+ };
130
+ }
48
131
  const quarter = newerQuarter(data);
49
132
  const costNote = debtCostProxyNote(data.history);
50
133
  return {