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
@@ -1,5 +1,5 @@
1
1
  import { useCallback, useEffect, useMemo, useRef, type ReactNode, type RefObject } from "react";
2
- import { TextAttributes, type ScrollBoxRenderable } from "../../../../../ui";
2
+ import type { ScrollBoxRenderable } from "../../../../../ui";
3
3
  import {
4
4
  DataTableStackView,
5
5
  TickerBadgeList,
@@ -14,12 +14,12 @@ import type { MarketNewsItem } from "../../../../../types/news-source";
14
14
  import { colors } from "../../../../../theme/colors";
15
15
  import { collectNewsDisplayTickers } from "../../../../../news/ticker-symbols";
16
16
  import { useLoadNewsStory } from "../../../../../news/hooks";
17
- import { formatFeedTime } from "../../../../../utils/datetime-format";
18
17
  import { logFailure } from "../../../../../utils/log-failure";
19
18
  import { nextHeaderSort } from "../../../../../utils/sort-values";
20
19
  import { formatNewsCategoryForColumn } from "../categories";
21
20
  import { useOpenTickerChoice } from "../../../shared/ticker-choice";
22
21
  import { usePinnedMoment } from "../../../../../components/use-pinned-moment";
22
+ import { MIN_HEADLINE_WIDTH, NEWS_SOURCE_WIDTH, NEWS_TIME_WIDTH, newsHeadlineCell, newsSourceCell, newsTimeCell } from "./row";
23
23
 
24
24
  export type NewsColumnId =
25
25
  | "rank"
@@ -114,10 +114,8 @@ function sortNewsArticles(
114
114
 
115
115
  const FIXED_COLUMN_WIDTHS: Record<Exclude<NewsColumnId, "title">, number> = {
116
116
  rank: 4,
117
- // "Mon 09:10", or "Sep 18, 25" for a story from another year.
118
- time: 10,
119
- // Publishers and X handles: "GlobeNewswire", "@unusual_whales".
120
- source: 15,
117
+ time: NEWS_TIME_WIDTH,
118
+ source: NEWS_SOURCE_WIDTH,
121
119
  tickers: 18,
122
120
  categories: 10,
123
121
  sentiment: 4,
@@ -147,9 +145,6 @@ const SPELLED_SENTIMENT_MIN_HEADLINE_WIDTH = 60;
147
145
  const columnAlign = (id: NewsColumnId): "left" | "right" =>
148
146
  id === "rank" || id === "importance" ? "right" : "left";
149
147
 
150
- /** Below this the headline takes room back from the other columns. */
151
- const MIN_HEADLINE_WIDTH = 40;
152
-
153
148
  /**
154
149
  * What a narrowing pane gives up, in order, to keep the headline readable: a
155
150
  * step with a width shrinks that column, one without drops it. Time and rank
@@ -330,19 +325,13 @@ export function NewsArticleStackView({
330
325
  case "rank":
331
326
  return { text: String(index + 1), color: tone(colors.textDim) };
332
327
  case "time":
333
- return { text: formatFeedTime(item.publishedAt), value: item.publishedAt, color: tone(colors.textDim) };
328
+ return { ...newsTimeCell(item, { later }), value: item.publishedAt };
334
329
  case "source":
335
- return { text: item.source, color: colors.textMuted };
330
+ return newsSourceCell(item);
336
331
  case "title":
337
- return {
338
- // Unclipped: the table fits it to the width the column really gets,
339
- // which on desktop is wider than the width it was laid out at.
340
- text: titleForArticle?.(item) ?? item.title,
341
- color: tone(colors.text),
342
- attributes: later || readArticleIds?.has(item.id)
343
- ? TextAttributes.NONE
344
- : TextAttributes.BOLD,
345
- };
332
+ // Unclipped: the table fits it to the width the column really gets,
333
+ // which on desktop is wider than the width it was laid out at.
334
+ return newsHeadlineCell(item, { later, read: readArticleIds?.has(item.id), title: titleForArticle?.(item) });
346
335
  case "tickers": {
347
336
  const tickers = fitTickerSymbols(collectNewsDisplayTickers(item.tickers), column.width);
348
337
  return {
@@ -5,10 +5,12 @@ import {
5
5
  extractImpliedForward,
6
6
  forwardFromCarry,
7
7
  optionMid,
8
+ quoteUnderIntrinsic,
8
9
  realizedVolatilityCadenceIssue,
9
10
  realizedVolatilityResult,
10
11
  solveImpliedVolatility,
11
12
  valueOption,
13
+ withQuotesUnderIntrinsicMarked,
12
14
  type OptionSide,
13
15
  type OptionValuation,
14
16
  } from "../shared/volatility";
@@ -110,6 +112,8 @@ export function solveChainVolatilities(
110
112
  return { valuationTime, byStrike, filled };
111
113
  }
112
114
  if (!positive(spot)) return { valuationTime, byStrike, filled };
115
+ // A quote under intrinsic is no market: no midpoint, forward or IV is read from it.
116
+ chain = withQuotesUnderIntrinsicMarked(chain, spot);
113
117
  const rate = optionChainRate(chain);
114
118
  const carry = Number.isFinite(dividendYield) ? dividendYield! : 0;
115
119
  const expirations = new Set([...chain.calls, ...chain.puts].map((contract) => contract.expiration));
@@ -242,8 +246,9 @@ export function calculateOptionGreeks(
242
246
  return { price, delta, gamma, thetaPerDay: theta, vegaPerPoint: vega, rhoPerPoint: 0 };
243
247
  }
244
248
  const volatility = contract ? volatilities.byStrike.get(contract.strike) : undefined;
245
- // A side nobody bids has no market to measure sensitivity against.
246
- if (!contract || optionMid(contract) == null || !positive(spot) || !positive(contract.strike) || volatility == null || !(volatility >= 0)) {
249
+ // A side nobody bids, or a stale quote, has no market to measure sensitivity against.
250
+ if (!contract || optionMid(contract) == null || quoteUnderIntrinsic(contract, side, spot) || !positive(spot) || !positive(contract.strike)
251
+ || volatility == null || !(volatility >= 0)) {
247
252
  return undefined;
248
253
  }
249
254
  return valueOption({
@@ -155,8 +155,13 @@ export function overlayOptionContractQuote(
155
155
  const volume = isFiniteNumber(quote.volume) && quote.volume >= 0
156
156
  && (contract.volume == null || !Number.isFinite(contract.volume) || quote.volume >= contract.volume)
157
157
  ? quote.volume : contract.volume;
158
+ // A streamed bid and ask newer than the snapshot are a market now: the snapshot's stale mark (quoted before the
159
+ // session, or under intrinsic) no longer applies. The pane checks the new quote against intrinsic again.
160
+ const { quoteStale, ...snapshot } = contract;
161
+ const freshBook = isFiniteNumber(quote.bid) && isFiniteNumber(quote.ask);
158
162
  return {
159
- ...contract,
163
+ ...snapshot,
164
+ ...(quoteStale && !freshBook ? { quoteStale } : {}),
160
165
  // Generic quote.price may itself be a midpoint. LAST must remain an
161
166
  // executed trade, with its own timestamp, even while the bid/ask updates.
162
167
  lastPrice: hasNewTrade ? quote.lastTradePrice! : contract.lastPrice,
@@ -308,7 +308,8 @@ function formatOptionContractCell(
308
308
  case "openInterest":
309
309
  return formatCompact(contract.openInterest, { fixedDecimals: true });
310
310
  case "iv":
311
- return formatIv(row.impliedVolatility, row.impliedVolatilityFilled);
311
+ // A stale quote (from before the session, or under intrinsic) is shown, but no IV or greek is read from it.
312
+ return contract.quoteStale ? "stale" : formatIv(row.impliedVolatility, row.impliedVolatilityFilled);
312
313
  case "delta":
313
314
  return formatGreek(greeks?.delta);
314
315
  case "gamma":
@@ -358,7 +359,7 @@ export function renderOptionCell(
358
359
  const surface = backgroundColor ?? rowSurface;
359
360
  return {
360
361
  text: formatOptionContractCell(row, contract, column),
361
- color: contract ? optionRoleColor(optionColumnRole(column), surface) : optionMutedColor(surface),
362
+ color: contract && !contract.quoteStale ? optionRoleColor(optionColumnRole(column), surface) : optionMutedColor(surface),
362
363
  keepColorWhenSelected: otherHalf,
363
364
  backgroundColor,
364
365
  };
@@ -72,7 +72,7 @@ import { signedPositionDirection } from "../../../portfolio/position-metrics";
72
72
  import { optionMarketReference } from "./market-reference";
73
73
  import { useOptionsEnrichment } from "./enrichment";
74
74
  import type { OptionsEnrichmentSnapshot } from "./enrichment-model";
75
- import { optionMid, type OptionSide } from "../shared/volatility";
75
+ import { optionMid, withQuotesUnderIntrinsicMarked, type OptionSide } from "../shared/volatility";
76
76
  import type { TickerRecord } from "../../../types/ticker";
77
77
  import type { TickerFinancials } from "../../../types/financials";
78
78
  import type { IvStats } from "../iv-history/client";
@@ -551,14 +551,6 @@ export function OptionsView({ width, height, focused, nestedInTabs = false, ivRa
551
551
  () => strikeChain ? overlayOptionChainQuotes(strikeChain, optionQuoteEntries, optionQuoteFreshness, optionQuoteBroker).chain : null,
552
552
  [optionQuoteEntries, optionQuoteFreshness, strikeChain, optionQuoteBroker],
553
553
  );
554
- const callsByStrike = useMemo(
555
- () => new Map(liveChain?.calls.map((c) => [c.strike, c]) ?? []),
556
- [liveChain],
557
- );
558
- const putsByStrike = useMemo(
559
- () => new Map(liveChain?.puts.map((p) => [p.strike, p]) ?? []),
560
- [liveChain],
561
- );
562
554
  // IV and the Greeks are valued at one spot and instant, which the footer
563
555
  // names: the close a chain from the close was quoted against, else the
564
556
  // latest price (docs/research-data.md#greeks-spot-and-time).
@@ -566,6 +558,16 @@ export function OptionsView({ width, height, focused, nestedInTabs = false, ivRa
566
558
  const modelSpot = useMemo(() => liveChain ? optionModelSpot(underlyingQuote, liveChain, Date.now(), effectiveExchange) : null,
567
559
  [liveChain, underlyingQuote, effectiveExchange]);
568
560
  const greeksSpot = modelSpot?.price;
561
+ // A quote under intrinsic at that spot is shown stale, as the server marks one from before the session.
562
+ const pricedChain = useMemo(() => liveChain ? withQuotesUnderIntrinsicMarked(liveChain, greeksSpot) : null, [greeksSpot, liveChain]);
563
+ const callsByStrike = useMemo(
564
+ () => new Map(pricedChain?.calls.map((c) => [c.strike, c]) ?? []),
565
+ [pricedChain],
566
+ );
567
+ const putsByStrike = useMemo(
568
+ () => new Map(pricedChain?.puts.map((p) => [p.strike, p]) ?? []),
569
+ [pricedChain],
570
+ );
569
571
  // One solve per applied batch: a streamed contract's IV comes from its live
570
572
  // midpoint, the rest from the snapshot, all against the same forward.
571
573
  const volatilities = useMemo(
@@ -34,6 +34,8 @@ export interface ScenarioMarketSnapshot {
34
34
  dividendYieldBasis?: ModelDividendYield["basis"] | null;
35
35
  /** The last distribution's ex-date of a dividend that stopped (basis `stopped`). */
36
36
  dividendLastPaid?: string | null;
37
+ /** The last ex-date of a monthly payer's history that ends there, beside a stated yield (ModelDividendYield.historyEnds). */
38
+ dividendHistoryEnds?: string | null;
37
39
  source: string | null;
38
40
  underlyingQuote: Quote | null;
39
41
  rateAsOf: string[];
@@ -180,6 +182,7 @@ export async function loadScenarioMarket(
180
182
  asOf: quoteCurrent && positive(quote!.lastUpdated) ? quote!.lastUpdated : now,
181
183
  chain, expirationDates, rate: rate.rate, dividendYield: dividend?.value ?? null, dividendYieldBasis: dividend?.basis ?? null,
182
184
  ...(dividend?.basis === "stopped" ? { dividendLastPaid: dividend.lastPaid ?? null } : {}),
185
+ ...(dividend?.historyEnds ? { dividendHistoryEnds: dividend.historyEnds } : {}),
183
186
  source: quoteCurrent ? quoteEntry?.source ?? quote!.providerId ?? null : null,
184
187
  underlyingQuote: quoteCurrent ? quote : null, rateAsOf: rate.asOf, warnings: [...new Set(warnings)],
185
188
  ...(missingExpiry ? { missingExpiry } : {}),
@@ -141,7 +141,7 @@ export const optionsScenarioHeadless: HeadlessPaneDefinition<"bundle"> = {
141
141
  ? scenarioSpotBasis({}, { spot: market.spot!, legs: [] }, market) : null;
142
142
  const currency = position ? currencyLabel(position.currency) : null;
143
143
  const dividendNote = supplied(settings.dividendYield) ? null
144
- : modelDividendYieldNote({ basis: market.dividendYieldBasis ?? "stated", lastPaid: market.dividendLastPaid });
144
+ : modelDividendYieldNote({ basis: market.dividendYieldBasis ?? "stated", lastPaid: market.dividendLastPaid, historyEnds: market.dividendHistoryEnds });
145
145
  // Value, P&L, risk and the grid add every contract; entry prices and spot are per share.
146
146
  const valueUnit = position ? scenarioValueUnit(position) : null;
147
147
  const per = `${currency} ${valueUnit}`;
@@ -211,8 +211,9 @@ function validatePerpsMarket<T extends PerpMarketPayload>(data: T): T {
211
211
  const fetchPerpsMarket = async (marketId: string, client: Pick<typeof apiClient, "getCloudPerpsMarket"> = apiClient) => validatePerpsMarket(await client.getCloudPerpsMarket(marketId));
212
212
 
213
213
  /**
214
- * The Market column's label for a market on a Hyperliquid builder dex (`SP500 · XYZ`) read back as the `xyz:SP500`
215
- * identity the board search and the venue know it by; anything else is returned as typed.
214
+ * The label the Market column wrote for a market on a Hyperliquid builder dex before it wrote Hyperliquid's own name
215
+ * (`SP500 · XYZ`), read back as that name, `xyz:SP500`, so a market typed or saved that way still opens; anything
216
+ * else is returned as typed.
216
217
  */
217
218
  export const marketQuery = (input: string) => {
218
219
  const label = /^([^\s·]+)\s*·\s*([^\s·]+)$/.exec(input.trim());
@@ -246,7 +247,7 @@ const QUOTE_WORDS = new Set(["USD", "USDT", "USDC", "PERP", "SWAP"]);
246
247
 
247
248
  /**
248
249
  * The board names nearest an input nothing matched: markets whose symbol, base asset or name carry a word of it
249
- * (or all but its last letters), the biggest first, written as the Market column writes them (`BZ`, `BRENTOIL · XYZ`). Free text with several
250
+ * (or all but its last letters), the biggest first, written as the Market column writes them (`BZ`, `xyz:BRENTOIL`). Free text with several
250
251
  * words is no market name and gets none. A board that cannot be read leaves the caller its own examples.
251
252
  */
252
253
  export async function nearestPerpMarkets(input: string, client: Pick<typeof apiClient, "getCloudPerpsBoard"> = apiClient): Promise<string[]> {
@@ -270,7 +271,7 @@ export async function nearestPerpMarkets(input: string, client: Pick<typeof apiC
270
271
  }
271
272
 
272
273
  /**
273
- * One market by base asset, underlying, symbol, canonical identity or the Market column's label (`SP500 · XYZ`), or by
274
+ * One market by base asset, underlying, symbol, canonical identity or the Market column's label (`xyz:SP500`), or by
274
275
  * a name the board does not spell: a pair (BTC-USD, BTC/USD, BTCUSD) or a plain name (bitcoin, brent), read as the
275
276
  * base asset it stands for once the input names no market as typed. An input that names none comes back with no
276
277
  * rows and the board names nearest to it.
@@ -1,5 +1,5 @@
1
1
  import type { PerpBoardPayload, PerpBoardRow, PerpDepthRow, PerpLiquidationMarket, PerpLiquidationPrint, PerpLiquidationsPayload } from "../../../api-client/perps";
2
- import type { HeadlessBundleSection, HeadlessPaneColumn, HeadlessPaneLoadArgs, HeadlessPaneRow } from "../../../types/headless";
2
+ import type { HeadlessBundleResult, HeadlessBundleSection, HeadlessPaneColumn, HeadlessPaneContext, HeadlessPaneLoadArgs, HeadlessPaneRow } from "../../../types/headless";
3
3
  import type { HeadlessPaneDefinition } from "../../../types/plugin";
4
4
  import { DEPTH_COLUMN_IDS, depthBandTotals, depthCellText, depthColumnLabel, depthFreshness, depthStaleNote, downStreams, LIQUIDATION_COLUMN_IDS, liquidationCellText, liquidationColumnLabel, liquidationFreshness,
5
5
  PRINT_COLUMN_IDS, printCellText, printColumnLabel, type DepthColumnId, type LiquidationColumnId, type PrintColumnId } from "./cascade";
@@ -8,6 +8,7 @@ import { perpFreshness } from "./freshness";
8
8
  import { aprFootnote, ASSET_FILTERS, BOARD_COLUMNS, BOARD_SORTS, collectedVenueCount, COMPARE_COLUMNS, compact, fundingSpread, HISTORY_METRICS, label, marketLabel, observed, openingTab, PERP_TABS, perpCellText,
9
9
  perpColumnLabel, percent, perpHistoryProText, positioningFields, price, RANKING_COLUMNS, rankingRows, RANKINGS, ratioText, share, time, uncoveredVenueNote, VENUES, venueName, venuesOf, IDENTITY_VENUES, type PerpColumnId } from "./model";
10
10
  import { freePreviewNote } from "../shared/free-preview";
11
+ import { REPORT_ROWS } from "../shared/headless-options";
11
12
  import { basisSpotSymbol } from "../futures-curve/model";
12
13
 
13
14
  // Text columns only: the text report shows these, JSON keeps every field of every row. Rates, premiums and
@@ -183,7 +184,7 @@ const listMetadata = (data: Pick<PerpBoardPayload, "asOf" | "access" | "status">
183
184
 
184
185
  export const perpsHeadless: HeadlessPaneDefinition<"bundle"> = {
185
186
  shape: "bundle", argument: { kind: "free-text", optional: true, placeholder: "market",
186
- description: "A base asset, underlying, canonical market identity or Market column label, such as BTC, hyperliquid:xyz:TSLA or SP500 · XYZ. Opens its history; with --tab board it searches the board, with --tab compare, liquidations or depth it is the base asset. Without one, the board." },
187
+ description: "A base asset, underlying, canonical market identity or Market column label, such as BTC, hyperliquid:xyz:TSLA or xyz:TSLA. Opens its history; with --tab board it searches the board, with --tab compare, liquidations or depth it is the base asset. Without one, the board." },
187
188
  options: [
188
189
  { key: "tab", type: "enum", settingKey: "tab", values: PERP_TABS.map((value) => ({ value })), description: "Board, rankings, compare, liquidations, depth, history or evidence. Board without a market, history with one." },
189
190
  { key: "asset-class", type: "enum", settingKey: "assetClass", values: ASSET_FILTERS.map((value) => ({ value })), defaultValue: "all", description: "Board asset class." },
@@ -192,6 +193,7 @@ export const perpsHeadless: HeadlessPaneDefinition<"bundle"> = {
192
193
  { key: "sort", type: "enum", settingKey: "sort", values: BOARD_SORTS.map((value) => ({ value })), defaultValue: "oi", description: "Board order: open interest, funding, open-interest change, premium or long share of accounts." },
193
194
  { key: "days", type: "enum", settingKey: "days", values: ["1", "7", "30", "90", "365"].map((value) => ({ value })), defaultValue: "7", description: "History lookback in days." },
194
195
  { key: "metric", type: "enum", settingKey: "metric", values: HISTORY_METRICS.map((value) => ({ value })), defaultValue: "funding", description: "Displayed history chart; JSON retains every series." },
196
+ { key: "limit", type: "integer", shot: REPORT_ROWS, minimum: 1, maximum: 5000, description: "Rows to list in each table, in its order: every row unless given.", example: "--limit 10" },
195
197
  ],
196
198
  discovery: { aliases: ["PERP"], dataRequirements: ["Perpetual market observations"], limitations: ["Free accounts see a fixed preview of the board, rankings and comparisons, and latest values for one market.", "Pro unlocks every market, full rankings and history.", "Rankings list up to ten markets each.", "Rates, premiums and changes are fractions in JSON.", "Open-interest history begins at first collection.", "Funding APR is a simple annualization, not a forecast.",
197
199
  "Long/short account shares: venue definitions differ; history begins at first collection.",
@@ -199,127 +201,135 @@ export const perpsHeadless: HeadlessPaneDefinition<"bundle"> = {
199
201
  "Order book depth is read hourly for each venue's 50 largest markets; a band wider than the book a venue returns is a floor (≥). Free shows the latest; Pro the week's history."] },
200
202
  describe: (args) => TITLES[tabOf(args)],
201
203
  async load(args, ctx) {
202
- const requested = requestedOf(args);
203
- const tab = tabOf(args);
204
- if (tab === "board") {
205
- const assetClass = String(args.options["asset-class"] ?? "all"), venue = String(args.options.venue ?? "all"), sort = String(args.options.sort ?? "oi");
206
- const board = await fetchPerpsBoard({ ...(assetClass !== "all" ? { assetClass } : {}), ...(venue !== "all" ? { venue } : {}),
207
- ...(requested ? { search: boardSearchText(requested) } : {}), sort }, ctx.apiClient);
208
- // The server answers a venue with its own markets; a server that does not filter by venue answers every venue's.
209
- const rows = venue === "all" ? board.rows : board.rows.filter((row) => row.venue === venue);
210
- const lock = venue === "all" ? more(board.locked, "markets") : venuePreviewLine(venue, rows, board.rows);
211
- return { sections: [{ ...marketSection("Markets", BOARD_TEXT_COLUMNS, rows), ...lockedTable(board.locked && !rows.length) }], complete: !board.locked && board.status === "ok",
212
- errors: board.locked ? [lock] : [], ...aprNote(rows), freshness: perpFreshness(rows, { funding: rows, venue }),
213
- metadata: { ...listMetadata(board), total: board.total, assetClass, venue, sort, ...(requested ? { search: requested } : {}) } };
214
- }
215
- if (tab === "rankings") {
216
- const rankings = await fetchPerpsRankings(ctx.apiClient);
217
- // A ranking the free view leaves empty is locked, left out and said on the Pro line; one that has none to rank says so.
218
- const sections: HeadlessBundleSection[] = RANKINGS.map((ranking) => {
219
- const rows = rankingRows(rankings, ranking.key);
220
- return { ...marketSection(ranking.label, rankingTextColumns(ranking), rows), ...lockedTable(rankings.locked && !rows.length) };
221
- });
222
- const notices = venueUnused(String(args.options.venue ?? "all"), "rankings");
223
- // Only the funding lists show funding.
224
- const funding = RANKINGS.filter((ranking) => ranking.field === "fundingRate8h").flatMap((ranking) => rankingRows(rankings, ranking.key));
225
- // The rankings show neither APR % nor Long %, only OI USD.
226
- const ranked = RANKINGS.flatMap((ranking) => rankingRows(rankings, ranking.key));
227
- return { sections, complete: !rankings.locked && rankings.status === "ok", errors: rankings.locked ? ["Full rankings need Gloom Pro"] : [],
228
- ...aprNote(ranked, { apr: false, longShare: false }),
229
- freshness: perpFreshness(RANKINGS.flatMap((ranking) => rankingRows(rankings, ranking.key)), { funding }), metadata: { ...(notices.length ? { notices } : {}), ...listMetadata(rankings) } };
230
- }
231
- if (tab === "compare") {
232
- // A canonical identity names one contract; its base asset is what the venues share.
233
- const identity = marketQuery(requested);
234
- const asked = identity.includes(":") ? (await fetchPerpSelection(identity, ctx.apiClient)).rows[0]?.baseAsset ?? identity : (requested || DEFAULT_MARKET).toUpperCase();
235
- // A pair or plain name (BTC-USD, bitcoin) compares the base asset it stands for; the rows say which.
236
- const compare = await fetchPerpsCompare(asked, ctx.apiClient);
237
- if (!compare.rows.length && !compare.locked) throw noMarket(requested || asked, await nearestPerpMarkets(requested || asked, ctx.apiClient));
238
- const base = compare.rows[0]?.baseAsset ?? asked;
239
- const spread = fundingSpread(compare.rows);
240
- const notices = [...(requested ? [] : [`Showing ${DEFAULT_MARKET}. Try fn PERP ${EXAMPLE_MARKETS[1]} --tab compare.`]),
241
- ...requested && !identity.includes(":") && base.toUpperCase() !== asked ? readAs(base, requested) : [], ...venueUnused(String(args.options.venue ?? "all"), "compare")];
242
- return { sections: [{ ...marketSection("Contracts", COMPARE_TEXT_COLUMNS, compare.rows), ...lockedTable(compare.locked) },
243
- ...(spread ? [{ title: "Funding spread", entries: [{ key: "fundingSpread8h", label: "Funding spread 8h", value: spread.value, formatted: `${spread.text} ${spread.detail}` }] }] : [])],
244
- complete: !compare.locked && compare.status === "ok", errors: compare.locked ? [more(compare.locked, compare.locked === 1 ? "contract" : "contracts")] : [],
245
- ...aprNote(compare.rows), freshness: perpFreshness(compare.rows, { funding: compare.rows }),
246
- metadata: { ...(requested ? {} : { defaultArgument: DEFAULT_MARKET }), ...(notices.length ? { notices } : {}),
247
- ...listMetadata(compare), total: compare.total, baseAsset: base,
248
- ...(spread ? { fundingSpread8h: spread.value, fundingSpreadHigh: spread.high.marketId, fundingSpreadLow: spread.low.marketId } : {}) } };
249
- }
250
- if (tab === "liquidations" || tab === "depth") {
251
- // A canonical identity names one contract; its base asset is what the venues share. A pair or plain name reads as its base asset.
252
- const identity = marketQuery(requested);
253
- const asked = identity.includes(":") ? (await fetchPerpSelection(identity, ctx.apiClient)).rows[0]?.baseAsset ?? identity : (requested || DEFAULT_MARKET).toUpperCase();
254
- const notices = (base: string) => [...(requested ? [] : [`Showing ${DEFAULT_MARKET}. Try fn PERP ${EXAMPLE_MARKETS[1]} --tab ${tab}.`]),
255
- ...requested && !identity.includes(":") && base.toUpperCase() !== asked ? readAs(base, requested) : [], ...venueUnused(String(args.options.venue ?? "all"), tab)];
256
- if (tab === "liquidations") {
257
- const data = await fetchPerpsLiquidations(asked, ctx.apiClient);
258
- if (!data.markets.length && data.status !== "unavailable") throw noMarket(requested || asked, await nearestPerpMarkets(requested || asked, ctx.apiClient));
259
- const told = notices(data.baseAsset);
260
- const locked = lockedTable(data.locked);
261
- const entries = (["long24h", "short24h", "long7d", "short7d"] as const).map((key) => ({ key, label: `${key.startsWith("long") ? "Longs" : "Shorts"} liquidated ${key.endsWith("24h") ? "24h" : "7d"}`,
262
- value: data.totals[key], formatted: `${compact(data.totals[key])} USD` }));
263
- return { sections: [{ title: "Totals", entries: [...entries, { key: "collectingSince", label: "Collecting since", value: data.collectingSince, formatted: time(data.collectingSince) }] },
264
- { title: "By contract", columns: LIQUIDATION_TEXT_COLUMNS, rows: data.markets.map((row) => ({ ...row })) },
265
- { title: "Hourly", columns: HOURLY_COLUMNS, rows: data.hourly.map((row) => ({ ...row })), ...locked },
266
- // The prints are the window's, not the 24 hours beside them: the heading says which.
267
- { title: "Largest prints", textTitle: windowDays(data) ? `Largest prints, ${windowDays(data)}` : "Largest prints", columns: printTextColumns(data.baseAsset), rows: data.largest.map((row) => ({ ...row })) }],
268
- complete: !data.locked && data.status === "ok" && !downStreams(data).length, notes: data.notes,
269
- errors: data.locked ? [freePreviewNote({ shows: "liquidation totals and the three largest prints", adds: "the hourly series and the twenty largest prints" })] : [],
270
- freshness: liquidationFreshness(data),
271
- metadata: { ...(requested ? {} : { defaultArgument: DEFAULT_MARKET }), ...(told.length ? { notices: told } : {}), baseAsset: data.baseAsset, asOf: data.asOf, from: data.from,
272
- access: data.access, locked: data.locked, status: data.status, collectingSince: data.collectingSince, streams: data.streams, notionalCurrency: "USD" } };
273
- }
274
- const data = await fetchPerpsDepth(asked, ctx.apiClient);
275
- if (!data.rows.length && data.status !== "unavailable") throw noMarket(requested || asked, await nearestPerpMarkets(requested || asked, ctx.apiClient));
276
- const told = notices(data.baseAsset);
277
- const staleNote = depthStaleNote(data.rows);
278
- // The band totals over the current books, as the tab's figures show them; a floor (≥) when a book ends inside the band.
279
- const bands = depthBandTotals(data.rows).map((band) => ({ key: `band${band.key}`, label: band.label, value: band.bids + band.asks,
280
- formatted: `${band.floor ? "≥" : ""}${compact(band.bids + band.asks)} USD (bids ${compact(band.bids)} · asks ${compact(band.asks)}, ${band.books} ${band.books === 1 ? "book" : "books"})` }));
281
- return { sections: [...bands.length ? [{ title: "Band totals", entries: bands }] : [],
282
- { title: "Order books", columns: DEPTH_TEXT_COLUMNS, rows: data.rows.map((row) => ({ ...row })) },
283
- { title: "Hourly depth", columns: DEPTH_HISTORY_COLUMNS, rows: data.history.map((row) => ({ ...row })), ...lockedTable(data.locked) }],
284
- complete: !data.locked && data.status === "ok" && !staleNote, notes: [...staleNote ? [staleNote] : [], ...data.notes],
285
- errors: data.locked ? [freePreviewNote({ shows: "each book's latest depth", adds: "the week's hourly depth" })] : [],
286
- freshness: depthFreshness(data),
287
- metadata: { ...(requested ? {} : { defaultArgument: DEFAULT_MARKET }), ...(told.length ? { notices: told } : {}), baseAsset: data.baseAsset, asOf: data.asOf,
288
- access: data.access, locked: data.locked, status: data.status, sources: data.sources, notionalCurrency: "USD", reach: "fraction of mid" } };
289
- }
290
- const search = requested || DEFAULT_MARKET, venue = String(args.options.venue ?? "all");
291
- const market = await fetchPerpSelection(search, ctx.apiClient, venue !== "all" ? venue : undefined);
292
- const selected = market.rows[0];
293
- if (!selected) throw noMarket(search, market.suggestions);
294
- const notices = [...(requested ? [] : [`Showing ${DEFAULT_MARKET}. Try fn PERP ${EXAMPLE_MARKETS[1]}.`]),
295
- ...market.resolved ? readAs(marketLabel(selected), requested, market.resolved.others) : [], ...venueNotice(venue, selected, requested, market.access)];
296
- const metadata = { ...(requested ? {} : { defaultArgument: DEFAULT_MARKET }), ...(notices.length ? { notices } : {}), marketId: selected.marketId, sourceUrl: selected.sourceUrl, observedAt: selected.observedAt, sourceAsOf: selected.sourceAsOf,
297
- rates: "fraction", quoteCurrency: selected.quoteCurrency, oiCurrency: "USD", fundingIntervalHours: selected.fundingIntervalHours };
298
- // The venue's market as last polled, with the funding its latest row shows.
299
- const freshness = perpFreshness([selected], { funding: [selected] });
300
- // The same Positioning lines the pane's Evidence shows; JSON keeps the raw reading on the market row.
301
- const positioning = positioningFields(selected);
302
- if (tab === "evidence") return {
303
- sections: [marketSection("Market evidence", MARKET_COLUMNS, market.rows),
304
- // Where the figures were read, as the pane's Evidence names it: the venue's own endpoint and its time.
305
- { title: "Source", entries: [{ key: "sourceUrl", label: "URL", value: selected.sourceUrl },
306
- { key: "sourceAsOf", label: "Venue as of", value: selected.sourceAsOf, formatted: time(selected.sourceAsOf) }] },
307
- ...(positioning ? [{ title: "Positioning", entries: positioning.map((field) => ({ key: field.key, label: field.label, value: field.value,
308
- formatted: field.detail ? `${field.text} · ${field.detail}` : field.text })) }] : []),
309
- { title: "Observation revisions", columns: REVISION_COLUMNS, rows: market.evidence.map((row) => ({ ...row })), ...lockedTable(market.access !== "pro") }],
310
- // Positioning dates the long share itself.
311
- complete: market.access === "pro" && market.status === "ok", ...aprNote(market.rows, { longShare: false }), freshness,
312
- errors: market.access !== "pro" ? [freePreviewNote({ shows: `${marketLabel(selected)}'s latest evidence and positioning`, adds: "its observation revisions" })] : [],
313
- metadata: { ...metadata, asOf: market.asOf, access: market.access, locked: market.locked, status: market.status },
314
- };
315
- const history = await fetchPerpsHistory({ marketId: selected.marketId, from: new Date(Date.now() - Number(args.options.days ?? 7) * 86_400_000).toISOString(), resolution: "auto", limit: 5000 }, ctx.apiClient);
316
- const locked = lockedTable(history.locked);
317
- return { sections: [marketSection("Latest market", MARKET_COLUMNS, [selected]), { title: "Own observations", columns: observationColumns(selected.quoteCurrency), rows: history.rows.map((row) => ({ ...row })), ...locked },
318
- { title: "Paid funding", columns: FUNDING_COLUMNS, rows: history.funding.map((row) => ({ ...row })), ...locked }, { title: "Hourly candles", columns: candleColumns(selected.quoteCurrency), rows: history.candles.map((row) => ({ ...row })), ...locked },
319
- { title: "Long/short history", columns: LONG_SHORT_COLUMNS, rows: (history.longShortRatio ?? []).map((row) => ({ ...row })), ...locked }],
320
- complete: !history.locked && !history.truncated && history.status === "ok", ...aprNote([selected]), freshness,
321
- errors: history.locked ? [historyLock(selected, collectedVenueCount(market.sources))] : history.truncated ? ["History reached the 5,000-observation limit; narrow the range"] : [],
322
- metadata: { ...metadata, asOf: history.asOf, access: history.access, locked: history.locked, status: history.status, from: history.from, to: history.to, resolution: history.resolution, truncated: history.truncated ?? false },
323
- };
204
+ const result = await loadPerpTab(args, ctx);
205
+ // `--limit` lists the first rows of each table, in its own order.
206
+ const limit = args.options.limit == null ? null : Number(args.options.limit);
207
+ return limit == null ? result : { ...result, sections: result.sections.map((section) => section.rows ? { ...section, rows: section.rows.slice(0, limit) } : section) };
324
208
  },
325
209
  };
210
+
211
+ /** One tab of PERP, every row the server sent. */
212
+ async function loadPerpTab(args: HeadlessPaneLoadArgs, ctx: HeadlessPaneContext): Promise<HeadlessBundleResult> {
213
+ const requested = requestedOf(args);
214
+ const tab = tabOf(args);
215
+ if (tab === "board") {
216
+ const assetClass = String(args.options["asset-class"] ?? "all"), venue = String(args.options.venue ?? "all"), sort = String(args.options.sort ?? "oi");
217
+ const board = await fetchPerpsBoard({ ...(assetClass !== "all" ? { assetClass } : {}), ...(venue !== "all" ? { venue } : {}),
218
+ ...(requested ? { search: boardSearchText(requested) } : {}), sort }, ctx.apiClient);
219
+ // The server answers a venue with its own markets; a server that does not filter by venue answers every venue's.
220
+ const rows = venue === "all" ? board.rows : board.rows.filter((row) => row.venue === venue);
221
+ const lock = venue === "all" ? more(board.locked, "markets") : venuePreviewLine(venue, rows, board.rows);
222
+ return { sections: [{ ...marketSection("Markets", BOARD_TEXT_COLUMNS, rows), ...lockedTable(board.locked && !rows.length) }], complete: !board.locked && board.status === "ok",
223
+ errors: board.locked ? [lock] : [], ...aprNote(rows), freshness: perpFreshness(rows, { funding: rows, venue }),
224
+ metadata: { ...listMetadata(board), total: board.total, assetClass, venue, sort, ...(requested ? { search: requested } : {}) } };
225
+ }
226
+ if (tab === "rankings") {
227
+ const rankings = await fetchPerpsRankings(ctx.apiClient);
228
+ // A ranking the free view leaves empty is locked, left out and said on the Pro line; one that has none to rank says so.
229
+ const sections: HeadlessBundleSection[] = RANKINGS.map((ranking) => {
230
+ const rows = rankingRows(rankings, ranking.key);
231
+ return { ...marketSection(ranking.label, rankingTextColumns(ranking), rows), ...lockedTable(rankings.locked && !rows.length) };
232
+ });
233
+ const notices = venueUnused(String(args.options.venue ?? "all"), "rankings");
234
+ // Only the funding lists show funding.
235
+ const funding = RANKINGS.filter((ranking) => ranking.field === "fundingRate8h").flatMap((ranking) => rankingRows(rankings, ranking.key));
236
+ // The rankings show neither APR % nor Long %, only OI USD.
237
+ const ranked = RANKINGS.flatMap((ranking) => rankingRows(rankings, ranking.key));
238
+ return { sections, complete: !rankings.locked && rankings.status === "ok", errors: rankings.locked ? ["Full rankings need Gloom Pro"] : [],
239
+ ...aprNote(ranked, { apr: false, longShare: false }),
240
+ freshness: perpFreshness(RANKINGS.flatMap((ranking) => rankingRows(rankings, ranking.key)), { funding }), metadata: { ...(notices.length ? { notices } : {}), ...listMetadata(rankings) } };
241
+ }
242
+ if (tab === "compare") {
243
+ // A canonical identity names one contract; its base asset is what the venues share.
244
+ const identity = marketQuery(requested);
245
+ const asked = identity.includes(":") ? (await fetchPerpSelection(identity, ctx.apiClient)).rows[0]?.baseAsset ?? identity : (requested || DEFAULT_MARKET).toUpperCase();
246
+ // A pair or plain name (BTC-USD, bitcoin) compares the base asset it stands for; the rows say which.
247
+ const compare = await fetchPerpsCompare(asked, ctx.apiClient);
248
+ if (!compare.rows.length && !compare.locked) throw noMarket(requested || asked, await nearestPerpMarkets(requested || asked, ctx.apiClient));
249
+ const base = compare.rows[0]?.baseAsset ?? asked;
250
+ const spread = fundingSpread(compare.rows);
251
+ const notices = [...(requested ? [] : [`Showing ${DEFAULT_MARKET}. Try fn PERP ${EXAMPLE_MARKETS[1]} --tab compare.`]),
252
+ ...requested && !identity.includes(":") && base.toUpperCase() !== asked ? readAs(base, requested) : [], ...venueUnused(String(args.options.venue ?? "all"), "compare")];
253
+ return { sections: [{ ...marketSection("Contracts", COMPARE_TEXT_COLUMNS, compare.rows), ...lockedTable(compare.locked) },
254
+ ...(spread ? [{ title: "Funding spread", entries: [{ key: "fundingSpread8h", label: "Funding spread 8h", value: spread.value, formatted: `${spread.text} ${spread.detail}` }] }] : [])],
255
+ complete: !compare.locked && compare.status === "ok", errors: compare.locked ? [more(compare.locked, compare.locked === 1 ? "contract" : "contracts")] : [],
256
+ ...aprNote(compare.rows), freshness: perpFreshness(compare.rows, { funding: compare.rows }),
257
+ metadata: { ...(requested ? {} : { defaultArgument: DEFAULT_MARKET }), ...(notices.length ? { notices } : {}),
258
+ ...listMetadata(compare), total: compare.total, baseAsset: base,
259
+ ...(spread ? { fundingSpread8h: spread.value, fundingSpreadHigh: spread.high.marketId, fundingSpreadLow: spread.low.marketId } : {}) } };
260
+ }
261
+ if (tab === "liquidations" || tab === "depth") {
262
+ // A canonical identity names one contract; its base asset is what the venues share. A pair or plain name reads as its base asset.
263
+ const identity = marketQuery(requested);
264
+ const asked = identity.includes(":") ? (await fetchPerpSelection(identity, ctx.apiClient)).rows[0]?.baseAsset ?? identity : (requested || DEFAULT_MARKET).toUpperCase();
265
+ const notices = (base: string) => [...(requested ? [] : [`Showing ${DEFAULT_MARKET}. Try fn PERP ${EXAMPLE_MARKETS[1]} --tab ${tab}.`]),
266
+ ...requested && !identity.includes(":") && base.toUpperCase() !== asked ? readAs(base, requested) : [], ...venueUnused(String(args.options.venue ?? "all"), tab)];
267
+ if (tab === "liquidations") {
268
+ const data = await fetchPerpsLiquidations(asked, ctx.apiClient);
269
+ if (!data.markets.length && data.status !== "unavailable") throw noMarket(requested || asked, await nearestPerpMarkets(requested || asked, ctx.apiClient));
270
+ const told = notices(data.baseAsset);
271
+ const locked = lockedTable(data.locked);
272
+ const entries = (["long24h", "short24h", "long7d", "short7d"] as const).map((key) => ({ key, label: `${key.startsWith("long") ? "Longs" : "Shorts"} liquidated ${key.endsWith("24h") ? "24h" : "7d"}`,
273
+ value: data.totals[key], formatted: `${compact(data.totals[key])} USD` }));
274
+ return { sections: [{ title: "Totals", entries: [...entries, { key: "collectingSince", label: "Collecting since", value: data.collectingSince, formatted: time(data.collectingSince) }] },
275
+ { title: "By contract", columns: LIQUIDATION_TEXT_COLUMNS, rows: data.markets.map((row) => ({ ...row })) },
276
+ { title: "Hourly", columns: HOURLY_COLUMNS, rows: data.hourly.map((row) => ({ ...row })), ...locked },
277
+ // The prints are the window's, not the 24 hours beside them: the heading says which.
278
+ { title: "Largest prints", textTitle: windowDays(data) ? `Largest prints, ${windowDays(data)}` : "Largest prints", columns: printTextColumns(data.baseAsset), rows: data.largest.map((row) => ({ ...row })) }],
279
+ complete: !data.locked && data.status === "ok" && !downStreams(data).length, notes: data.notes,
280
+ errors: data.locked ? [freePreviewNote({ shows: "liquidation totals and the three largest prints", adds: "the hourly series and the twenty largest prints" })] : [],
281
+ freshness: liquidationFreshness(data),
282
+ metadata: { ...(requested ? {} : { defaultArgument: DEFAULT_MARKET }), ...(told.length ? { notices: told } : {}), baseAsset: data.baseAsset, asOf: data.asOf, from: data.from,
283
+ access: data.access, locked: data.locked, status: data.status, collectingSince: data.collectingSince, streams: data.streams, notionalCurrency: "USD" } };
284
+ }
285
+ const data = await fetchPerpsDepth(asked, ctx.apiClient);
286
+ if (!data.rows.length && data.status !== "unavailable") throw noMarket(requested || asked, await nearestPerpMarkets(requested || asked, ctx.apiClient));
287
+ const told = notices(data.baseAsset);
288
+ const staleNote = depthStaleNote(data.rows);
289
+ // The band totals over the current books, as the tab's figures show them; a floor (≥) when a book ends inside the band.
290
+ const bands = depthBandTotals(data.rows).map((band) => ({ key: `band${band.key}`, label: band.label, value: band.bids + band.asks,
291
+ formatted: `${band.floor ? "≥" : ""}${compact(band.bids + band.asks)} USD (bids ${compact(band.bids)} · asks ${compact(band.asks)}, ${band.books} ${band.books === 1 ? "book" : "books"})` }));
292
+ return { sections: [...bands.length ? [{ title: "Band totals", entries: bands }] : [],
293
+ { title: "Order books", columns: DEPTH_TEXT_COLUMNS, rows: data.rows.map((row) => ({ ...row })) },
294
+ { title: "Hourly depth", columns: DEPTH_HISTORY_COLUMNS, rows: data.history.map((row) => ({ ...row })), ...lockedTable(data.locked) }],
295
+ complete: !data.locked && data.status === "ok" && !staleNote, notes: [...staleNote ? [staleNote] : [], ...data.notes],
296
+ errors: data.locked ? [freePreviewNote({ shows: "each book's latest depth", adds: "the week's hourly depth" })] : [],
297
+ freshness: depthFreshness(data),
298
+ metadata: { ...(requested ? {} : { defaultArgument: DEFAULT_MARKET }), ...(told.length ? { notices: told } : {}), baseAsset: data.baseAsset, asOf: data.asOf,
299
+ access: data.access, locked: data.locked, status: data.status, sources: data.sources, notionalCurrency: "USD", reach: "fraction of mid" } };
300
+ }
301
+ const search = requested || DEFAULT_MARKET, venue = String(args.options.venue ?? "all");
302
+ const market = await fetchPerpSelection(search, ctx.apiClient, venue !== "all" ? venue : undefined);
303
+ const selected = market.rows[0];
304
+ if (!selected) throw noMarket(search, market.suggestions);
305
+ const notices = [...(requested ? [] : [`Showing ${DEFAULT_MARKET}. Try fn PERP ${EXAMPLE_MARKETS[1]}.`]),
306
+ ...market.resolved ? readAs(marketLabel(selected), requested, market.resolved.others) : [], ...venueNotice(venue, selected, requested, market.access)];
307
+ const metadata = { ...(requested ? {} : { defaultArgument: DEFAULT_MARKET }), ...(notices.length ? { notices } : {}), marketId: selected.marketId, sourceUrl: selected.sourceUrl, observedAt: selected.observedAt, sourceAsOf: selected.sourceAsOf,
308
+ rates: "fraction", quoteCurrency: selected.quoteCurrency, oiCurrency: "USD", fundingIntervalHours: selected.fundingIntervalHours };
309
+ // The venue's market as last polled, with the funding its latest row shows.
310
+ const freshness = perpFreshness([selected], { funding: [selected] });
311
+ // The same Positioning lines the pane's Evidence shows; JSON keeps the raw reading on the market row.
312
+ const positioning = positioningFields(selected);
313
+ if (tab === "evidence") return {
314
+ sections: [marketSection("Market evidence", MARKET_COLUMNS, market.rows),
315
+ // Where the figures were read, as the pane's Evidence names it: the venue's own endpoint and its time.
316
+ { title: "Source", entries: [{ key: "sourceUrl", label: "URL", value: selected.sourceUrl },
317
+ { key: "sourceAsOf", label: "Venue as of", value: selected.sourceAsOf, formatted: time(selected.sourceAsOf) }] },
318
+ ...(positioning ? [{ title: "Positioning", entries: positioning.map((field) => ({ key: field.key, label: field.label, value: field.value,
319
+ formatted: field.detail ? `${field.text} · ${field.detail}` : field.text })) }] : []),
320
+ { title: "Observation revisions", columns: REVISION_COLUMNS, rows: market.evidence.map((row) => ({ ...row })), ...lockedTable(market.access !== "pro") }],
321
+ // Positioning dates the long share itself.
322
+ complete: market.access === "pro" && market.status === "ok", ...aprNote(market.rows, { longShare: false }), freshness,
323
+ errors: market.access !== "pro" ? [freePreviewNote({ shows: `${marketLabel(selected)}'s latest evidence and positioning`, adds: "its observation revisions" })] : [],
324
+ metadata: { ...metadata, asOf: market.asOf, access: market.access, locked: market.locked, status: market.status },
325
+ };
326
+ const history = await fetchPerpsHistory({ marketId: selected.marketId, from: new Date(Date.now() - Number(args.options.days ?? 7) * 86_400_000).toISOString(), resolution: "auto", limit: 5000 }, ctx.apiClient);
327
+ const locked = lockedTable(history.locked);
328
+ return { sections: [marketSection("Latest market", MARKET_COLUMNS, [selected]), { title: "Own observations", columns: observationColumns(selected.quoteCurrency), rows: history.rows.map((row) => ({ ...row })), ...locked },
329
+ { title: "Paid funding", columns: FUNDING_COLUMNS, rows: history.funding.map((row) => ({ ...row })), ...locked }, { title: "Hourly candles", columns: candleColumns(selected.quoteCurrency), rows: history.candles.map((row) => ({ ...row })), ...locked },
330
+ { title: "Long/short history", columns: LONG_SHORT_COLUMNS, rows: (history.longShortRatio ?? []).map((row) => ({ ...row })), ...locked }],
331
+ complete: !history.locked && !history.truncated && history.status === "ok", ...aprNote([selected]), freshness,
332
+ errors: history.locked ? [historyLock(selected, collectedVenueCount(market.sources))] : history.truncated ? ["History reached the 5,000-observation limit; narrow the range"] : [],
333
+ metadata: { ...metadata, asOf: history.asOf, access: history.access, locked: history.locked, status: history.status, from: history.from, to: history.to, resolution: history.resolution, truncated: history.truncated ?? false },
334
+ };
335
+ }
@@ -18,7 +18,7 @@ import { loadPerpsCompare, loadPerpsEquity } from "./client";
18
18
  import { perpEquityIdentity } from "./equity-identity";
19
19
  import { useLivePerpRows } from "./live-rows";
20
20
  import { compact, perpCell, percent, price, readingTime, venueName } from "./model";
21
- import { useOpenPerpMarket } from "./open-market";
21
+ import { openPerpLabel, useOpenPerpMarket } from "./open-market";
22
22
  import { contractText, foldSmallMarkets, mergeVenueMarkets, type PerpVenueMarket } from "./venue-markets";
23
23
 
24
24
  const STOCK_TYPES = new Set(["STK", "EQUITY", "STOCK", "COMMON STOCK"]);
@@ -52,8 +52,11 @@ const COLUMNS: readonly Column[] = [
52
52
  { id: "oi", label: "OI USD", width: 7, align: "right" },
53
53
  { id: "volume", label: "Vol 24h", width: 7, align: "right" },
54
54
  ];
55
- /** What a narrow overview gives up first: the volume, then the contract, then the premium. */
56
- const DROP_ORDER: readonly Column["id"][] = ["volume", "contract", "premium"];
55
+ /**
56
+ * What a narrow overview gives up first: the volume, then the contract, the premium, the open interest and the
57
+ * funding, so the columns left fit whole rather than squeezed into cut figures ("+0." for +0.0050%).
58
+ */
59
+ const DROP_ORDER: readonly Column["id"][] = ["volume", "contract", "premium", "oi", "funding"];
57
60
  const GAP = 2;
58
61
  const span = (columns: readonly Column[]) => columns.reduce((sum, column) => sum + column.width, 0) + GAP * (columns.length - 1);
59
62
 
@@ -119,7 +122,7 @@ export function PerpMarketsSection({ symbol, exchange, instrumentType, quote, wi
119
122
  const cell = (column: Column, market: PerpVenueMarket, row: PerpBoardRow): ColumnGridCell => {
120
123
  if (column.id === "venue") {
121
124
  return { text: venueName(market.venue), color: row.stale ? colors.textDim : colors.textBright,
122
- link: { label: tf("Open {label}", { label: `PERP ${row.baseAsset} · ${venueName(market.venue)}` }), onOpen: () => openMarket(row.marketId) } };
125
+ link: { label: openPerpLabel(row), onOpen: () => openMarket(row.marketId) } };
123
126
  }
124
127
  if (column.id === "contract") return { text: contractText(market), color: colors.textMuted };
125
128
  if (column.id === "mark") return { text: price(row.markPrice ?? row.lastPrice), color: colors.text };
@@ -49,7 +49,11 @@ export function underlyingTicker(row: Pick<PerpBoardRow, "underlyingSymbol" | "u
49
49
  : row.underlying?.symbol.toUpperCase() === symbol ? row.underlying.listingExchange : undefined;
50
50
  return !listing || isUsListingExchange(listing) ? symbol : publicTickerKey(symbol, listing);
51
51
  }
52
- export const marketLabel = (row: Pick<PerpBoardRow, "dex" | "baseAsset">) => row.dex && row.dex !== "default" ? `${row.baseAsset} · ${row.dex.toUpperCase()}` : row.baseAsset;
52
+ /**
53
+ * A market as the Market column, the pane title and the CLI name it: its base asset, or for a market on a Hyperliquid
54
+ * builder dex Hyperliquid's own name for it, the dex before a colon (`xyz:NVDA`), which is also its contract symbol.
55
+ */
56
+ export const marketLabel = (row: Pick<PerpBoardRow, "dex" | "baseAsset">) => row.dex && row.dex !== "default" ? `${row.dex.toLowerCase()}:${row.baseAsset}` : row.baseAsset;
53
57
 
54
58
  /**
55
59
  * Plain names for markets, as the Market column writes the contracts to try, nearest first. A name the board does
@@ -58,7 +62,7 @@ export const marketLabel = (row: Pick<PerpBoardRow, "dex" | "baseAsset">) => row
58
62
  */
59
63
  const PLAIN_NAMES: Readonly<Record<string, readonly string[]>> = {
60
64
  bitcoin: ["BTC"], ethereum: ["ETH"], ether: ["ETH"], solana: ["SOL"], dogecoin: ["DOGE"], ripple: ["XRP"],
61
- brent: ["BZ", "BRENTOIL · XYZ"], brentcrude: ["BZ", "BRENTOIL · XYZ"], wti: ["CL"], wticrude: ["CL"], naturalgas: ["NATGAS · XYZ"],
65
+ brent: ["BZ", "xyz:BRENTOIL"], brentcrude: ["BZ", "xyz:BRENTOIL"], wti: ["CL"], wticrude: ["CL"], naturalgas: ["xyz:NATGAS"],
62
66
  };
63
67
  /** A pair as exchanges and charts write it: BTC-USD, BTC/USD, BTCUSD, BTCUSDT, BTC-PERP, BTC/USDT:USDT. */
64
68
  const QUOTED_PAIR = /^([A-Z0-9]{1,15}?)([-/_ ]?)(?:USDT|USDC|USD|PERP)(?::[A-Z]{3,4})?$/;
@@ -73,8 +77,8 @@ export function perpBaseCandidates(input: string): string[] {
73
77
  const pair = QUOTED_PAIR.exec(input.trim().toUpperCase());
74
78
  return pair ? [pair[1]!] : [];
75
79
  }
76
- /** The base asset a Market column label names: `BRENTOIL · XYZ` is BRENTOIL. */
77
- export const baseOfLabel = (label: string) => label.split("·")[0]!.trim();
80
+ /** The base asset a Market column label names: `xyz:BRENTOIL` is BRENTOIL. */
81
+ export const baseOfLabel = (label: string) => label.replace(/^[a-z][a-z0-9]*:/, "");
78
82
  /** The base asset of a pair written with a separator (BTC-USD, BTC/USD), which no board symbol spells; null for anything else. */
79
83
  export function separatedPairBase(input: string): string | null {
80
84
  const pair = QUOTED_PAIR.exec(input.trim().toUpperCase());