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,8 +1,10 @@
1
1
  import { useCallback, useEffect, useMemo, useRef, useState, type RefObject } from "react";
2
- import { Box, TextAttributes, type ScrollBoxRenderable } from "../../../ui";
2
+ import { Box, TextAttributes, useUiCapabilities, type ScrollBoxRenderable } from "../../../ui";
3
3
  import { usePaneInstance } from "../../../state/app/context";
4
4
  import {
5
5
  DataTableStackView,
6
+ DataTableView,
7
+ MarkdownText,
6
8
  PaneLinkMenu,
7
9
  PaneStatusBody,
8
10
  useExternalLinkFooter,
@@ -10,55 +12,135 @@ import {
10
12
  type DataTableColumn,
11
13
  } from "../../../components";
12
14
  import { DetailReader } from "../../../components/reader/detail-reader";
15
+ import { DESKTOP_LINE_HEIGHT, READER_COLUMN_FONT, READER_MEASURE } from "../../../components/reader/reader-text";
13
16
  import { loadingErrorFooterInfo, usePaneRefreshKey } from "../../../components/data-table/table-pane";
17
+ import { getReleaseSummaries } from "../../../api-client/release-summaries";
14
18
  import { createTtlCache } from "../../../data/ttl-cache";
15
- import { fetchChangelogReleases, type ChangelogRelease } from "../../../updater/github-releases";
19
+ import {
20
+ fetchChangelogReleases,
21
+ fetchChangelogSummaries,
22
+ type ChangelogRelease,
23
+ } from "../../../updater/github-releases";
16
24
  import { colors } from "../../../theme/colors";
17
25
  import type { PaneProps } from "../../../types/plugin";
18
26
  import type { PluginModule } from "../plugin-module";
19
27
  import { usePluginPaneState } from "../../runtime";
20
28
  import { formatShortDate } from "../../../utils/datetime-format";
29
+ import { logFailure } from "../../../utils/log-failure";
21
30
  import {
22
31
  DEFAULT_CHANGELOG_SORT,
23
32
  nextChangelogSortPreference,
24
33
  resolveSelectedReleaseIndex,
25
34
  sortChangelogReleases,
26
35
  type ChangelogColumnId,
36
+ type ChangelogSortPreference,
27
37
  } from "./model";
38
+ import {
39
+ DEFAULT_CHANGELOG_VERSION_SORT,
40
+ groupChangelogVersions,
41
+ highlightsMarkdown,
42
+ nextChangelogVersionSort,
43
+ parseVersionSummaries,
44
+ sortChangelogVersions,
45
+ versionOfRelease,
46
+ type ChangelogVersion,
47
+ type ChangelogVersionColumnId,
48
+ } from "./versions";
28
49
 
29
- const CHANGELOG_LIMIT = 40;
50
+ /**
51
+ * The releases read: one page of GitHub's list holds them beside the nightly
52
+ * builds, so a load is one request unless nightlies crowd the page. The
53
+ * oldest version, maybe cut short, is left out.
54
+ */
55
+ const CHANGELOG_LIMIT = 80;
30
56
  /** GitHub can hang or be blocked outright; the pane must still reach a verdict. */
31
57
  const CHANGELOG_TIMEOUT_MS = 5_000;
32
58
  const CHANGELOG_CACHE_TTL_MS = 10 * 60 * 1000;
33
59
 
60
+ interface ChangelogData {
61
+ releases: ChangelogRelease[];
62
+ /** CHANGELOG.md, or null when it is missing or could not be read. */
63
+ summaries: string | null;
64
+ }
65
+
34
66
  // Process-lifetime cache. Move it into the updater module if other
35
67
  // surfaces start reading releases too.
36
- const releaseCache = createTtlCache<ChangelogRelease[]>({ ttlMs: CHANGELOG_CACHE_TTL_MS });
37
- const RELEASES = "releases";
68
+ const changelogCache = createTtlCache<ChangelogData>({ ttlMs: CHANGELOG_CACHE_TTL_MS });
69
+ const CHANGELOG = "changelog";
70
+
71
+ /** Every test reads its own answers, whichever file ran first. */
72
+ export function resetChangelogCacheForTests(): void {
73
+ changelogCache.clear();
74
+ }
75
+
76
+ /**
77
+ * CHANGELOG.md from Gloom Cloud, which reads GitHub with its own credentials,
78
+ * else from GitHub itself; null when neither has it, and then each version
79
+ * shows its updates' own highlights.
80
+ */
81
+ async function readSummaries(signal: AbortSignal): Promise<string | null> {
82
+ try {
83
+ return await getReleaseSummaries(signal);
84
+ } catch (error) {
85
+ logFailure("changelog", "Read release summaries from Gloom Cloud failed")(error);
86
+ }
87
+ return fetchChangelogSummaries(signal).catch(logFailure("changelog", "Read CHANGELOG.md from GitHub failed", null));
88
+ }
38
89
 
39
- type ChangelogColumn = DataTableColumn & { id: ChangelogColumnId };
90
+ type VersionColumn = DataTableColumn & { id: ChangelogVersionColumnId };
91
+ type ReleaseColumn = DataTableColumn & { id: ChangelogColumnId };
40
92
  type LoadStatus = "loading" | "loaded" | "error";
41
93
 
42
- function buildColumns(releases: ChangelogRelease[]): ChangelogColumn[] {
43
- const dateWidth = 12;
44
- const versionWidth = Math.min(
45
- Math.max(7, ...releases.map((release) => release.version.length)),
46
- 14,
47
- );
94
+ const DATE_WIDTH = 12;
95
+
96
+ function buildVersionColumns(versions: ChangelogVersion[]): VersionColumn[] {
97
+ const versionWidth = Math.min(Math.max(7, ...versions.map((version) => version.id.length)), 14);
48
98
  return [
49
- { id: "date", label: "Date", width: dateWidth, align: "left" },
99
+ { id: "date", label: "Date", width: DATE_WIDTH, align: "left" },
50
100
  { id: "version", label: "Version", width: versionWidth, align: "left" },
51
101
  { id: "title", label: "Title", width: 18, align: "left", flexGrow: 1 },
102
+ { id: "updates", label: "Updates", width: 7, align: "right" },
52
103
  ];
53
104
  }
54
105
 
55
- function releaseDetailTitle(release: ChangelogRelease): string {
56
- return release.title === release.version
57
- ? release.version
58
- : `${release.version} ${release.title}`;
106
+ function buildReleaseColumns(releases: ChangelogRelease[]): ReleaseColumn[] {
107
+ const versionWidth = Math.min(Math.max(7, ...releases.map((release) => release.version.length)), 14);
108
+ return [
109
+ { id: "date", label: "Date", width: DATE_WIDTH, align: "left" },
110
+ { id: "version", label: "Version", width: versionWidth, align: "left" },
111
+ { id: "title", label: "Title", width: 18, align: "left", flexGrow: 1 },
112
+ ];
113
+ }
114
+
115
+ function detailTitle(version: string, title: string): string {
116
+ return title === version ? version : `${version} ${title}`;
59
117
  }
60
118
 
61
- function ChangelogDetail({
119
+ function renderVersionCell(version: ChangelogVersion, column: VersionColumn): DataTableCell {
120
+ switch (column.id) {
121
+ case "date":
122
+ return { text: formatShortDate(version.lastPublishedAt, { fallback: "" }), color: colors.textDim };
123
+ case "version":
124
+ return { text: version.id, color: colors.textBright, attributes: TextAttributes.BOLD };
125
+ case "title":
126
+ return { text: version.title, color: colors.text };
127
+ case "updates":
128
+ return { text: String(version.releases.length), color: colors.textDim };
129
+ }
130
+ }
131
+
132
+ function renderReleaseCell(release: ChangelogRelease, column: ReleaseColumn): DataTableCell {
133
+ switch (column.id) {
134
+ case "date":
135
+ return { text: formatShortDate(release.publishedAt, { fallback: "" }), color: colors.textDim };
136
+ case "version":
137
+ return { text: release.version, color: colors.textBright, attributes: TextAttributes.BOLD };
138
+ case "title":
139
+ return { text: release.title, color: colors.text };
140
+ }
141
+ }
142
+
143
+ function ReleaseNotes({
62
144
  release,
63
145
  width,
64
146
  scrollRef,
@@ -82,28 +164,127 @@ function ChangelogDetail({
82
164
  );
83
165
  }
84
166
 
85
- /** The Changelog, as its own pane (CHG) and as ROADMAP's Changelog view. */
167
+ /** The pane's inset around the highlights, as a detail reader has: 12px above, 16px below. */
168
+ const HIGHLIGHTS_BOX_STYLE = { padding: "var(--gloom-space-md) var(--gloom-inset) var(--gloom-space-lg)" } as const;
169
+ /** The reader's type and measure; markdown lines take the reader's line height (the host sets Text line height from --cell-h). */
170
+ const HIGHLIGHTS_COLUMN_STYLE = {
171
+ fontSize: READER_COLUMN_FONT,
172
+ lineHeight: DESKTOP_LINE_HEIGHT,
173
+ maxWidth: READER_MEASURE,
174
+ "--cell-h": `${DESKTOP_LINE_HEIGHT}em`,
175
+ } as const;
176
+
177
+ /**
178
+ * A version's highlights above its updates. The desktop and the web set them
179
+ * in the reader's type at the reading measure, as the notes an update opens
180
+ * are, lined up with the table's left edge; the terminal wraps them at `width`.
181
+ */
182
+ function VersionHighlights({ markdown, width }: { markdown: string; width: number }) {
183
+ const { nativePaneChrome } = useUiCapabilities();
184
+ if (nativePaneChrome) {
185
+ return (
186
+ <Box flexDirection="column" width="100%" flexShrink={0} style={HIGHLIGHTS_BOX_STYLE} data-gloom-ui="changelog-highlights">
187
+ <Box flexDirection="column" width="100%" style={HIGHLIGHTS_COLUMN_STYLE}>
188
+ <MarkdownText text={markdown} />
189
+ </Box>
190
+ </Box>
191
+ );
192
+ }
193
+ return (
194
+ <Box flexDirection="column" paddingX={1} paddingY={1} flexShrink={0}>
195
+ <MarkdownText text={markdown} lineWidth={Math.max(12, width - 2)} />
196
+ </Box>
197
+ );
198
+ }
199
+
200
+ /**
201
+ * An open version: its highlights, each naming the updates it shipped in,
202
+ * over the table of those updates. Enter opens an update's notes.
203
+ */
204
+ function VersionDetail({
205
+ version,
206
+ focused,
207
+ width,
208
+ selectedReleaseId,
209
+ onSelectRelease,
210
+ onOpenRelease,
211
+ sortPreference,
212
+ onSortChange,
213
+ }: {
214
+ version: ChangelogVersion;
215
+ focused: boolean;
216
+ width: number;
217
+ selectedReleaseId: string | null;
218
+ onSelectRelease: (id: string) => void;
219
+ onOpenRelease: (id: string) => void;
220
+ /** The pane's, so it outlasts an update's notes opened over the table. */
221
+ sortPreference: ChangelogSortPreference;
222
+ onSortChange: (update: (current: ChangelogSortPreference) => ChangelogSortPreference) => void;
223
+ }) {
224
+ const releases = useMemo(
225
+ () => sortChangelogReleases(version.releases, sortPreference),
226
+ [version.releases, sortPreference],
227
+ );
228
+ const selectedIndex = resolveSelectedReleaseIndex(releases, selectedReleaseId);
229
+ const columns = useMemo(() => buildReleaseColumns(version.releases), [version.releases]);
230
+ const highlights = useMemo(() => highlightsMarkdown(version), [version]);
231
+
232
+ return (
233
+ <DataTableView<ChangelogRelease, ReleaseColumn>
234
+ focused={focused}
235
+ rootBefore={highlights ? <VersionHighlights markdown={highlights} width={width} /> : undefined}
236
+ selection={{
237
+ kind: "id",
238
+ selectedId: releases[selectedIndex]?.id ?? null,
239
+ getId: (release) => release.id,
240
+ onChange: (id) => onSelectRelease(id),
241
+ }}
242
+ onActivate={(release) => onOpenRelease(release.id)}
243
+ rootWidth={width}
244
+ resetScrollKey={version.id}
245
+ columns={columns}
246
+ items={releases}
247
+ sortColumnId={sortPreference.columnId}
248
+ sortDirection={sortPreference.direction}
249
+ onHeaderClick={(columnId) => onSortChange((current) => nextChangelogSortPreference(current, columnId))}
250
+ getItemKey={(release) => release.id}
251
+ renderCell={renderReleaseCell}
252
+ selectedTextOverridesCellColor
253
+ emptyStateTitle="No updates."
254
+ showHorizontalScrollbar={false}
255
+ />
256
+ );
257
+ }
258
+
259
+ /**
260
+ * The Changelog, as its own pane (CHG) and as ROADMAP's Changelog view: one
261
+ * row per minor version, then a version's highlights and updates, then an
262
+ * update's notes, one Back at a time.
263
+ */
86
264
  export function ChangelogPane({ focused, width, height }: PaneProps) {
87
265
  const paneInstance = usePaneInstance();
88
266
  const requestedVersion = paneInstance?.params?.version ?? null;
89
- const [releases, setReleases] = useState<ChangelogRelease[]>(() => releaseCache.peek(RELEASES, { stale: true }) ?? []);
267
+ const [data, setData] = useState<ChangelogData | null>(() => changelogCache.peek(CHANGELOG, { stale: true }) ?? null);
90
268
  // The mount effect starts the request immediately, so the first paint is a
91
269
  // spinner and never "No changelog entries found".
92
- const [status, setStatus] = useState<LoadStatus>(() => (releaseCache.peek(RELEASES, { stale: true }) ? "loaded" : "loading"));
270
+ const [status, setStatus] = useState<LoadStatus>(() => (changelogCache.peek(CHANGELOG, { stale: true }) ? "loaded" : "loading"));
93
271
  const [error, setError] = useState<string | null>(null);
94
- // The selected row and the open release are pane state, so a reload or a
95
- // shared layout comes back to the same release.
272
+ // The selected rows and what is open are pane state, so a reload or a
273
+ // shared layout comes back to the same version and update.
274
+ const [selectedVersionId, setSelectedVersionId] = usePluginPaneState<string | null>("selectedVersionId", null);
275
+ const [openVersionId, setOpenVersionId] = usePluginPaneState<string | null>("openVersionId", null);
96
276
  const [selectedReleaseId, setSelectedReleaseId] = usePluginPaneState<string | null>("selectedReleaseId", null);
97
- const [sortPreference, setSortPreference] = useState(DEFAULT_CHANGELOG_SORT);
98
277
  const [openReleaseId, setOpenReleaseId] = usePluginPaneState<string | null>("openReleaseId", null);
278
+ const [sortPreference, setSortPreference] = useState(DEFAULT_CHANGELOG_VERSION_SORT);
279
+ const [updateSort, setUpdateSort] = useState<ChangelogSortPreference>(DEFAULT_CHANGELOG_SORT);
99
280
  const detailScrollRef = useRef<ScrollBoxRenderable>(null);
100
281
  const abortRef = useRef<AbortController | null>(null);
101
282
  const requestedVersionOpenedRef = useRef(false);
102
283
 
103
- const loadReleases = useCallback(async (force = false) => {
104
- const fresh = force ? undefined : releaseCache.peek(RELEASES);
284
+ const load = useCallback(async (force = false) => {
285
+ const fresh = force ? undefined : changelogCache.peek(CHANGELOG);
105
286
  if (fresh) {
106
- setReleases(fresh);
287
+ setData(fresh);
107
288
  setError(null);
108
289
  setStatus("loaded");
109
290
  return;
@@ -121,9 +302,13 @@ export function ChangelogPane({ focused, width, height }: PaneProps) {
121
302
  setError(null);
122
303
 
123
304
  try {
124
- const nextReleases = await fetchChangelogReleases(CHANGELOG_LIMIT, controller.signal);
125
- releaseCache.set(RELEASES, nextReleases);
126
- setReleases(nextReleases);
305
+ const [releases, summaries] = await Promise.all([
306
+ fetchChangelogReleases(CHANGELOG_LIMIT, controller.signal),
307
+ readSummaries(controller.signal),
308
+ ]);
309
+ const next = { releases, summaries };
310
+ changelogCache.set(CHANGELOG, next);
311
+ setData(next);
127
312
  setStatus("loaded");
128
313
  } catch (loadError) {
129
314
  // A newer load or an unmount owns the state now; a timeout does not.
@@ -141,85 +326,82 @@ export function ChangelogPane({ focused, width, height }: PaneProps) {
141
326
  }, []);
142
327
 
143
328
  useEffect(() => {
144
- void loadReleases();
329
+ void load();
145
330
  return () => {
146
331
  abortRef.current?.abort();
147
332
  abortRef.current = null;
148
333
  };
149
- }, [loadReleases]);
334
+ }, [load]);
150
335
 
151
- const sortedReleases = useMemo(
152
- () => sortChangelogReleases(releases, sortPreference),
153
- [releases, sortPreference],
336
+ const versions = useMemo(
337
+ () => data
338
+ ? groupChangelogVersions(data.releases, parseVersionSummaries(data.summaries), { cut: data.releases.length >= CHANGELOG_LIMIT })
339
+ : [],
340
+ [data],
154
341
  );
155
- const activeSelectedIdx = resolveSelectedReleaseIndex(sortedReleases, selectedReleaseId);
156
- const activeSelectedReleaseId = sortedReleases[activeSelectedIdx]?.id ?? null;
342
+ const sortedVersions = useMemo(() => sortChangelogVersions(versions, sortPreference), [versions, sortPreference]);
343
+ const activeSelectedVersionId = (sortedVersions.find((version) => version.id === selectedVersionId) ?? sortedVersions[0])?.id ?? null;
157
344
 
158
345
  useEffect(() => {
159
- if (activeSelectedReleaseId !== selectedReleaseId) {
160
- setSelectedReleaseId(activeSelectedReleaseId);
346
+ if (activeSelectedVersionId !== selectedVersionId) {
347
+ setSelectedVersionId(activeSelectedVersionId);
161
348
  }
162
- }, [activeSelectedReleaseId, selectedReleaseId]);
349
+ }, [activeSelectedVersionId, selectedVersionId]);
163
350
 
164
351
  const openRelease = useMemo(
165
- () =>
166
- openReleaseId
167
- ? releases.find((release) => release.id === openReleaseId) ?? null
168
- : null,
169
- [openReleaseId, releases],
352
+ () => (openReleaseId ? data?.releases.find((release) => release.id === openReleaseId) ?? null : null),
353
+ [data, openReleaseId],
354
+ );
355
+ // A layout saved with only an open release (before versions) opens its version too.
356
+ const openVersion = useMemo(
357
+ () => versions.find((version) => version.id === openVersionId) ?? versionOfRelease(versions, openReleaseId),
358
+ [openReleaseId, openVersionId, versions],
170
359
  );
171
360
 
172
361
  useEffect(() => {
173
- if (openReleaseId && !openRelease) {
174
- setOpenReleaseId(null);
175
- }
176
- }, [openRelease, openReleaseId]);
362
+ if (!data) return;
363
+ if (openReleaseId && (!openRelease || !openVersion?.releases.includes(openRelease))) setOpenReleaseId(null);
364
+ if (openVersionId && !openVersion) setOpenVersionId(null);
365
+ }, [data, openRelease, openReleaseId, openVersion, openVersionId]);
177
366
 
178
- // Opened via "what's new after update": jump straight to that release's notes.
367
+ // Opened via "what's new after update": straight to that release's notes, in its version.
179
368
  useEffect(() => {
180
369
  if (!requestedVersion || requestedVersionOpenedRef.current) return;
181
- const match = releases.find((release) => release.version.replace(/^v/, "") === requestedVersion.replace(/^v/, ""));
182
- if (!match) return;
370
+ const tag = requestedVersion.replace(/^v/, "");
371
+ const match = data?.releases.find((release) => release.version.replace(/^v/, "") === tag);
372
+ const version = match ? versionOfRelease(versions, match.id) : null;
373
+ if (!match || !version) return;
183
374
  requestedVersionOpenedRef.current = true;
375
+ setSelectedVersionId(version.id);
376
+ setOpenVersionId(version.id);
184
377
  setSelectedReleaseId(match.id);
185
378
  setOpenReleaseId(match.id);
186
- }, [releases, requestedVersion]);
187
-
188
- usePaneRefreshKey(() => void loadReleases(true), { focused });
189
-
190
- const columns = useMemo(() => buildColumns(releases), [releases]);
191
-
192
- const renderCell = useCallback((
193
- release: ChangelogRelease,
194
- column: ChangelogColumn,
195
- ): DataTableCell => {
196
- switch (column.id) {
197
- case "date":
198
- return {
199
- text: formatShortDate(release.publishedAt, { fallback: "" }),
200
- color: colors.textDim,
201
- };
202
- case "version":
203
- return {
204
- text: release.version,
205
- color: colors.textBright,
206
- attributes: TextAttributes.BOLD,
207
- };
208
- case "title":
209
- return {
210
- text: release.title,
211
- color: colors.text,
212
- };
213
- }
214
- }, []);
379
+ }, [data, requestedVersion, versions]);
380
+
381
+ usePaneRefreshKey(() => void load(true), { focused });
382
+
383
+ const columns = useMemo(() => buildVersionColumns(versions), [versions]);
215
384
 
216
385
  const handleHeaderClick = useCallback((columnId: string) => {
217
- setSortPreference((current) => nextChangelogSortPreference(current, columnId));
386
+ setSortPreference((current) => nextChangelogVersionSort(current, columnId));
218
387
  }, []);
219
388
 
220
- const selectRelease = useCallback((release: ChangelogRelease) => {
221
- setSelectedReleaseId(release.id);
222
- }, []);
389
+ const openVersionRow = useCallback((version: ChangelogVersion) => {
390
+ setOpenVersionId(version.id);
391
+ // The version opens on its newest update, or on the one last read in it.
392
+ if (!version.releases.some((release) => release.id === selectedReleaseId)) {
393
+ setSelectedReleaseId(version.releases[0]?.id ?? null);
394
+ }
395
+ }, [selectedReleaseId]);
396
+
397
+ const goBack = useCallback(() => {
398
+ if (openRelease) {
399
+ setOpenReleaseId(null);
400
+ return;
401
+ }
402
+ setOpenReleaseId(null);
403
+ setOpenVersionId(null);
404
+ }, [openRelease]);
223
405
 
224
406
  const footerInfo = useMemo(
225
407
  () => loadingErrorFooterInfo(status === "loading", status === "error" ? "error" : null),
@@ -234,7 +416,7 @@ export function ChangelogPane({ focused, width, height }: PaneProps) {
234
416
  info: footerInfo,
235
417
  });
236
418
 
237
- if (releases.length === 0 && (status === "loading" || status === "error")) {
419
+ if (versions.length === 0 && (status === "loading" || status === "error")) {
238
420
  return (
239
421
  <PaneStatusBody
240
422
  loading={status === "loading"}
@@ -245,37 +427,46 @@ export function ChangelogPane({ focused, width, height }: PaneProps) {
245
427
  }
246
428
 
247
429
  return (
248
- <DataTableStackView<ChangelogRelease, ChangelogColumn>
430
+ <DataTableStackView<ChangelogVersion, VersionColumn>
249
431
  focused={focused}
250
- detailOpen={!!openRelease}
251
- onBack={() => setOpenReleaseId(null)}
432
+ detailOpen={!!openVersion}
433
+ onBack={goBack}
252
434
  detailContent={openRelease ? (
253
- <ChangelogDetail
254
- release={openRelease}
435
+ <ReleaseNotes release={openRelease} width={width} scrollRef={detailScrollRef} />
436
+ ) : openVersion ? (
437
+ <VersionDetail
438
+ version={openVersion}
439
+ focused={focused}
255
440
  width={width}
256
- scrollRef={detailScrollRef}
441
+ selectedReleaseId={selectedReleaseId}
442
+ onSelectRelease={setSelectedReleaseId}
443
+ onOpenRelease={setOpenReleaseId}
444
+ sortPreference={updateSort}
445
+ onSortChange={setUpdateSort}
257
446
  />
258
447
  ) : (
259
448
  <Box flexGrow={1} />
260
449
  )}
261
- detailTitle={openRelease ? releaseDetailTitle(openRelease) : undefined}
450
+ detailTitle={openRelease
451
+ ? detailTitle(openRelease.version, openRelease.title)
452
+ : openVersion ? detailTitle(openVersion.id, openVersion.title) : undefined}
262
453
  selection={{
263
454
  kind: "id",
264
- selectedId: activeSelectedReleaseId,
265
- getId: (release) => release.id,
266
- onChange: (_id, release) => selectRelease(release),
455
+ selectedId: activeSelectedVersionId,
456
+ getId: (version) => version.id,
457
+ onChange: (id) => setSelectedVersionId(id),
267
458
  }}
268
- onActivate={(release) => setOpenReleaseId(release.id)}
269
- detailScrollRef={detailScrollRef}
459
+ onActivate={openVersionRow}
460
+ detailScrollRef={openRelease ? detailScrollRef : undefined}
270
461
  rootWidth={width}
271
462
  rootHeight={height}
272
463
  columns={columns}
273
- items={sortedReleases}
464
+ items={sortedVersions}
274
465
  sortColumnId={sortPreference.columnId}
275
466
  sortDirection={sortPreference.direction}
276
467
  onHeaderClick={handleHeaderClick}
277
- getItemKey={(release) => release.id}
278
- renderCell={renderCell}
468
+ getItemKey={(version) => version.id}
469
+ renderCell={renderVersionCell}
279
470
  selectedTextOverridesCellColor
280
471
  emptyStateTitle="No changelog entries."
281
472
  showHorizontalScrollbar={false}