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,4 +1,6 @@
1
1
  import type {
2
+ DebtAmountBasis,
3
+ DebtBand,
2
4
  DebtHistoryPoint,
3
5
  DebtMaturitiesPayload,
4
6
  DebtMetric,
@@ -30,6 +32,79 @@ export function bucketShare(
30
32
  ? (100 * bucket.value) / total
31
33
  : null;
32
34
  }
35
+ /**
36
+ * The bands of a schedule read in its filing's own bands (within 1 year,
37
+ * 1 to 2 years, 2 to 5 years, after 5 years), exactly as reported; null for
38
+ * a schedule by fiscal year.
39
+ */
40
+ export function debtBands(latest: DebtLatest | null | undefined): DebtBand[] | null {
41
+ return latest?.sourceBuckets?.length ? latest.sourceBuckets : null;
42
+ }
43
+ /** What a schedule's amounts are, as its table header, its total and its filing detail name them. */
44
+ const BASIS: Record<DebtAmountBasis, { column: string; amount: string; total: string; words: string; detail?: string }> = {
45
+ principal: { column: "PRINCIPAL", amount: "Principal", total: "Principal total", words: "Principal" },
46
+ carrying: { column: "CARRYING", amount: "Carrying amount", total: "Carrying total", words: "Carrying amounts" },
47
+ contractual_undiscounted: {
48
+ column: "CASH FLOWS",
49
+ amount: "Cash flows",
50
+ total: "Cash flows total",
51
+ words: "Contractual undiscounted cash flows",
52
+ detail: "principal and interest",
53
+ },
54
+ };
55
+ export const debtBasis = (latest: DebtLatest) => BASIS[latest.amountBasis ?? "principal"];
56
+ const STANDARDS: Record<string, string> = { "us-gaap": "US GAAP", "ifrs-full": "IFRS", "cn-cas": "China CAS" };
57
+ /** The accounting standard a schedule is drawn up under: `IFRS`, `China CAS`. */
58
+ export const debtStandard = (taxonomy: string | null | undefined) =>
59
+ taxonomy ? (STANDARDS[taxonomy] ?? taxonomy) : null;
60
+ /** The bands' sum: the schedule's total in its own basis. */
61
+ export const bandTotal = (bands: readonly DebtBand[]) => bands.reduce((sum, band) => sum + band.value, 0);
62
+ /**
63
+ * The share of the bands' total due within `months` of the balance-sheet
64
+ * date, only when the bands from the first end exactly there: a band that
65
+ * spans the point is never split, so there is then no share.
66
+ */
67
+ export function bandsDueWithin(bands: readonly DebtBand[], months: number): number | null {
68
+ const end = bands.findIndex((band) => band.toMonths === months);
69
+ const total = bandTotal(bands);
70
+ if (end < 0 || bands[0]?.fromMonths !== 0 || total <= 0) return null;
71
+ return (100 * bandTotal(bands.slice(0, end + 1))) / total;
72
+ }
73
+ /** How the report states its amounts: `HKD millions`, `TWD`; `HKD millions, scale not stated` when the table did not say. */
74
+ export function bandScaleText(currency: string, scale: number | undefined, stated = true): string {
75
+ const unit = scale === 1e9 ? " billions" : scale === 1e6 ? " millions" : scale === 1e3 ? " thousands"
76
+ : scale && scale !== 1 ? ` × ${scale.toLocaleString("en-US")}` : "";
77
+ return `${currency}${unit}${stated ? "" : ", scale not stated"}`;
78
+ }
79
+ /**
80
+ * One row of the maturity table: a fiscal year of a schedule by year, or a
81
+ * band of one in its filing's own bands, as reported. `dated` rows share the
82
+ * wall's scale; the open-ended last one is capped past it.
83
+ */
84
+ export interface MaturityRow {
85
+ id: string;
86
+ label: string;
87
+ value: number | null;
88
+ /** Share of the schedule's total, in percent; null without a total. */
89
+ share: number | null;
90
+ dated: boolean;
91
+ bucket?: DebtBucket;
92
+ band?: DebtBand;
93
+ }
94
+ export function maturityRows(latest: DebtLatest): MaturityRow[] {
95
+ const bands = debtBands(latest);
96
+ if (!bands) {
97
+ return latest.buckets.map((bucket) => ({
98
+ id: bucket.id, label: bucket.label, value: bucket.value, share: bucketShare(bucket, latest),
99
+ dated: bucket.year !== null, bucket,
100
+ }));
101
+ }
102
+ const total = bandTotal(bands);
103
+ return bands.map((band) => ({
104
+ id: `${band.fromMonths}-${band.toMonths ?? "on"}`, label: band.label, value: band.value,
105
+ share: total > 0 ? (100 * band.value) / total : null, dated: band.toMonths !== null, band,
106
+ }));
107
+ }
33
108
  /**
34
109
  * The wall's scale: the largest dated bucket. Thereafter is open ended and
35
110
  * usually dwarfs every dated year, so scaling to it would flatten them.
@@ -37,8 +112,8 @@ export function bucketShare(
37
112
  export function datedBucketScale(latest: DebtLatest): number {
38
113
  return Math.max(
39
114
  0,
40
- ...latest.buckets.flatMap((row) =>
41
- row.year !== null && row.value !== null ? [row.value] : [],
115
+ ...maturityRows(latest).flatMap((row) =>
116
+ row.dated && row.value !== null ? [row.value] : [],
42
117
  ),
43
118
  );
44
119
  }
@@ -48,15 +123,20 @@ export interface BucketBar {
48
123
  /** Past the dated scale: drawn to the end and labelled with its value. */
49
124
  capped: boolean;
50
125
  }
51
- export function bucketBar(bucket: DebtBucket, scale: number): BucketBar | null {
126
+ export function bucketBar(bucket: Pick<MaturityRow, "value">, scale: number): BucketBar | null {
52
127
  if (bucket.value === null) return null;
53
128
  if (scale <= 0) return { ratio: bucket.value > 0 ? 1 : 0, capped: bucket.value > 0 };
54
129
  const ratio = bucket.value / scale;
55
130
  return ratio > 1 ? { ratio: 1, capped: true } : { ratio, capped: false };
56
131
  }
132
+ /**
133
+ * The comparable filings: the ten-year window of a schedule by year. A
134
+ * schedule in its filing's own bands has no principal by year to compare.
135
+ */
57
136
  function recentDebtHistory(
58
137
  data: DebtMaturitiesPayload,
59
138
  ): DebtHistoryPoint[] {
139
+ if (debtBands(data.latest)) return [];
60
140
  const start = data.latest?.totalPrincipal.percentile.windowStart;
61
141
  return start ? data.history.filter((point) => point.asOf >= start) : [];
62
142
  }
@@ -128,15 +208,17 @@ const MAX_WALL_WIDTH = 48;
128
208
  /**
129
209
  * The maturity table with the wall drawn inline: the bar column takes what
130
210
  * the text columns leave, and a pane too narrow for it keeps the numbers.
211
+ * `amount` heads the amounts column (`CARRYING` for carrying amounts).
131
212
  */
132
- export function bucketColumns(width: number): BucketColumn[] {
213
+ export function bucketColumns(width: number, amount = "PRINCIPAL"): BucketColumn[] {
214
+ const text = BUCKET_TEXT_COLUMNS.map((column) => column.id === "value" ? { ...column, label: amount } : column);
133
215
  // Each column is followed by a one-cell gap and the table pads both edges;
134
216
  // the body's scrollbar gutter takes the rest, so the wall never scrolls.
135
- const textWidth = BUCKET_TEXT_COLUMNS.reduce((sum, column) => sum + column.width + 1, 2);
217
+ const textWidth = text.reduce((sum, column) => sum + column.width + 1, 2);
136
218
  const wall = Math.min(MAX_WALL_WIDTH, width - textWidth - 3);
137
- if (wall < MIN_WALL_WIDTH) return BUCKET_TEXT_COLUMNS;
219
+ if (wall < MIN_WALL_WIDTH) return text;
138
220
  return [
139
- ...BUCKET_TEXT_COLUMNS,
221
+ ...text,
140
222
  { id: "wall", label: "WALL", width: wall, align: "left" },
141
223
  ];
142
224
  }
@@ -176,18 +258,19 @@ function compare(
176
258
  export function sortedBuckets(
177
259
  latest: DebtLatest,
178
260
  sort: DebtSort<BucketColumnId>,
179
- ): DebtBucket[] {
180
- // The wall bar draws the principal, so it sorts with it.
181
- const value = (row: DebtBucket) =>
261
+ ): MaturityRow[] {
262
+ const rows = maturityRows(latest);
263
+ // The wall bar draws the amount, so it sorts with it.
264
+ const value = (row: MaturityRow) =>
182
265
  sort.column === "label"
183
- ? latest.buckets.indexOf(row)
266
+ ? rows.indexOf(row)
184
267
  : sort.column === "share"
185
- ? bucketShare(row, latest)
268
+ ? row.share
186
269
  : row.value;
187
- return latest.buckets.toSorted(
270
+ return rows.toSorted(
188
271
  (a, b) =>
189
272
  compare(value(a), value(b), sort.direction) ||
190
- latest.buckets.indexOf(a) - latest.buckets.indexOf(b),
273
+ rows.indexOf(a) - rows.indexOf(b),
191
274
  );
192
275
  }
193
276
  export function sortedDebtHistory(
@@ -27,6 +27,7 @@ import {
27
27
  import { ageFooterSegment } from "../../../components/layout/pane/footer";
28
28
  import { colors } from "../../../theme/colors";
29
29
  import type {
30
+ DebtBand,
30
31
  DebtFact,
31
32
  DebtHistoryPoint,
32
33
  DebtMetric,
@@ -46,11 +47,16 @@ import {
46
47
  import { cachedDebtMaturities, loadDebtMaturities } from "./client";
47
48
  import {
48
49
  HISTORY_COLUMNS,
50
+ bandScaleText,
51
+ bandTotal,
52
+ bandsDueWithin,
49
53
  bucketBar,
50
54
  bucketColumns,
51
- bucketShare,
52
55
  datedBucketScale,
53
56
  debtAmount,
57
+ debtBands,
58
+ debtBasis,
59
+ debtStandard,
54
60
  debtCostProxy,
55
61
  debtFilingUrl,
56
62
  debtMetricCaption,
@@ -67,11 +73,11 @@ import {
67
73
  sortedDebtHistory,
68
74
  type BucketColumn,
69
75
  type BucketColumnId,
70
- type DebtBucket,
71
76
  type DebtLatest,
72
77
  type DebtSort,
73
78
  type HistoryColumn,
74
79
  type HistoryColumnId,
80
+ type MaturityRow,
75
81
  } from "./model";
76
82
  import { usePaneTickerIdentity } from "../../../state/hooks/pane-ticker";
77
83
  import { WALL_CAP_RESERVE, WallBar } from "./wall-bar";
@@ -82,6 +88,8 @@ const TABS = [
82
88
  { value: "history", label: "History" },
83
89
  { value: "filing", label: "Filing" },
84
90
  ];
91
+ /** A schedule in its filing's own bands has no principal by year to compare across filings. */
92
+ const BAND_TABS = TABS.filter((entry) => entry.value !== "history");
85
93
  /** The near-term lines run edge to edge, one filing a slot. */
86
94
  const LINE_SLOTS = { edges: false };
87
95
  /** Legend, four plot rows and the year axis. */
@@ -164,6 +172,120 @@ function QuarterFactRow({ label, fact }: { label: string; fact: DebtFact | null
164
172
  />
165
173
  );
166
174
  }
175
+ /** A band as the filing reports it: its amount, the rows or members it was read from, and the filing. */
176
+ function BandDetail({
177
+ band,
178
+ latest,
179
+ width,
180
+ height,
181
+ }: {
182
+ band: DebtBand;
183
+ latest: DebtLatest;
184
+ width: number;
185
+ height: number;
186
+ }) {
187
+ return (
188
+ <DetailScroll width={width} height={height}>
189
+ <KeyValueRow
190
+ labelWidth={20}
191
+ label={debtBasis(latest).amount}
192
+ value={`${band.value.toLocaleString("en-US")} ${latest.currency}`}
193
+ detail={latest.asOf}
194
+ />
195
+ <KeyValueRow
196
+ labelWidth={20}
197
+ label="Filed"
198
+ value={latest.filed}
199
+ detail={latest.form}
200
+ />
201
+ <KeyValueRow labelWidth={20} label="Accession" value={latest.accession} />
202
+ {band.members.length ? (
203
+ <KeyValueRow labelWidth={20} label="Read from" value={band.members.join(" + ")} />
204
+ ) : null}
205
+ {latest.source ? (
206
+ <KeyValueRow labelWidth={20} label="Table" value={latest.source.concept} />
207
+ ) : null}
208
+ </DetailScroll>
209
+ );
210
+ }
211
+ /**
212
+ * The filing of a schedule in its own bands: its standard, what the amounts
213
+ * are, how the report states them and what they were checked against.
214
+ */
215
+ function BandFilingDetail({
216
+ latest,
217
+ bands,
218
+ width,
219
+ height,
220
+ }: {
221
+ latest: DebtLatest;
222
+ bands: readonly DebtBand[];
223
+ width: number;
224
+ height: number;
225
+ }) {
226
+ const basis = debtBasis(latest);
227
+ const expense = latest.interestExpenseFact,
228
+ source = latest.source,
229
+ check = source?.reconciledTo;
230
+ return (
231
+ <DetailScroll width={width} height={height}>
232
+ <KeyValueRow
233
+ labelWidth={20}
234
+ label="As of"
235
+ value={latest.asOf}
236
+ detail={latest.currency}
237
+ />
238
+ <KeyValueRow
239
+ labelWidth={20}
240
+ label="Filed"
241
+ value={latest.filed}
242
+ detail={latest.form}
243
+ />
244
+ <KeyValueRow labelWidth={20} label="Accession" value={latest.accession} />
245
+ <KeyValueRow labelWidth={20} label="Standard" value={debtStandard(latest.taxonomy) ?? "Not stated"} />
246
+ <KeyValueRow labelWidth={20} label="Basis" value={basis.words} detail={basis.detail} />
247
+ <KeyValueRow
248
+ labelWidth={20}
249
+ label={basis.total}
250
+ value={`${debtAmount(bandTotal(bands))} ${latest.currency}`}
251
+ />
252
+ {source ? (
253
+ <>
254
+ <KeyValueRow
255
+ labelWidth={20}
256
+ label="Reported in"
257
+ value={bandScaleText(latest.currency, source.scale, source.scaleStated)}
258
+ />
259
+ <KeyValueRow labelWidth={20} label="Table" value={source.concept} />
260
+ </>
261
+ ) : null}
262
+ {check ? (
263
+ <KeyValueRow
264
+ labelWidth={20}
265
+ label="Checked against"
266
+ value={check.concept}
267
+ detail={`${check.ratio.toFixed(2)}x`}
268
+ />
269
+ ) : null}
270
+ {latest.includesLeases ? (
271
+ <KeyValueRow labelWidth={20} label="Lease liabilities" value="Included" />
272
+ ) : null}
273
+ <KeyValueRow
274
+ labelWidth={20}
275
+ label="Annual interest"
276
+ value={expense ? `${debtAmount(expense.value)} ${expense.unit}` : "Not reported"}
277
+ detail={expense?.tag}
278
+ />
279
+ {expense?.start ? (
280
+ <KeyValueRow
281
+ labelWidth={20}
282
+ label="Expense period"
283
+ value={`${expense.start} to ${expense.end}`}
284
+ />
285
+ ) : null}
286
+ </DetailScroll>
287
+ );
288
+ }
167
289
  function FilingDetail({
168
290
  latest,
169
291
  history,
@@ -337,9 +459,6 @@ export function DebtMaturitiesPane({ width, height, focused }: PaneProps) {
337
459
  });
338
460
  const [initialTab] = usePaneSettingValue("tab", "maturities");
339
461
  const [savedTab, setTab] = usePluginPaneState<string>("debt:tab", initialTab);
340
- const tab = TABS.some((entry) => entry.value === savedTab)
341
- ? savedTab
342
- : "maturities";
343
462
  const [bucketSort, setBucketSort] = usePluginPaneState<
344
463
  DebtSort<BucketColumnId>
345
464
  >("debt:bucketSort", { column: "label", direction: "asc" });
@@ -363,8 +482,14 @@ export function DebtMaturitiesPane({ width, height, focused }: PaneProps) {
363
482
  );
364
483
  const data = resource.data?.payload,
365
484
  latest = data?.latest;
485
+ // A schedule in its filing's own bands: its bands as reported, no history.
486
+ const bands = debtBands(latest);
487
+ const tabs = bands ? BAND_TABS : TABS;
488
+ const tab = tabs.some((entry) => entry.value === savedTab)
489
+ ? savedTab
490
+ : "maturities";
366
491
  const quarter = data ? newerQuarter(data) : null;
367
- const bucketKey = (bucket: DebtBucket) =>
492
+ const bucketKey = (bucket: MaturityRow) =>
368
493
  `${symbol}:${latest?.accession}:${latest?.asOf}:${bucket.id}`;
369
494
  const historyKey = useCallback(
370
495
  (point: DebtHistoryPoint) => `${symbol}:${point.accession}:${point.asOf}`,
@@ -424,7 +549,8 @@ export function DebtMaturitiesPane({ width, height, focused }: PaneProps) {
424
549
  const wallScale = latest ? datedBucketScale(latest) : 0;
425
550
  // A bucket past the dated scale keeps room at the end for its value.
426
551
  const wallReserve = buckets.some((row) => bucketBar(row, wallScale)?.capped) ? WALL_CAP_RESERVE : 0;
427
- const bucketColumnList = useMemo(() => bucketColumns(width), [width]);
552
+ const amountColumn = bands && latest ? debtBasis(latest).column : undefined;
553
+ const bucketColumnList = useMemo(() => bucketColumns(width, amountColumn), [width, amountColumn]);
428
554
  const updatedAgo = useUpdatedAgo(resource.updatedAt);
429
555
  // An open bucket or filing covers its tab; the tab keys wait until it closes.
430
556
  const detailOpen =
@@ -433,7 +559,7 @@ export function DebtMaturitiesPane({ width, height, focused }: PaneProps) {
433
559
  const signInWall = !data && isCloudSessionRequired(resource.error);
434
560
  const { strip: tabStrip, rows: tabRows } = usePaneTabs(
435
561
  symbol && !signInWall
436
- ? { tabs: TABS, activeValue: tab, onSelect: setTab, focused: tabsFocused, dense: true }
562
+ ? { tabs, activeValue: tab, onSelect: setTab, focused: tabsFocused, dense: true }
437
563
  : null,
438
564
  );
439
565
  // `height` is the pane body: the footer is chrome outside it on both targets.
@@ -442,6 +568,19 @@ export function DebtMaturitiesPane({ width, height, focused }: PaneProps) {
442
568
  // Most important first: a short pane keeps the leading figures.
443
569
  const statItems = useMemo<StatItem[]>(() => {
444
570
  if (!latest) return [];
571
+ if (bands) {
572
+ // The bands' own total and standard; a share of it only where the bands end exactly at that horizon.
573
+ const shares = ([["next12", "Due next 12 months", 12], ["next3", "Due next 3 years", 36]] as const).flatMap(([id, label, months]) => {
574
+ const share = bandsDueWithin(bands, months);
575
+ return share === null ? [] : [{ id, label, value: debtPercent(share) }];
576
+ });
577
+ return [
578
+ { id: "total", label: debtBasis(latest).total, value: `${debtAmount(bandTotal(bands))} ${latest.currency}`,
579
+ detail: debtStandard(latest.taxonomy) ?? undefined },
580
+ ...shares,
581
+ { id: "as-of", label: "As of", value: latest.asOf },
582
+ ];
583
+ }
445
584
  const metric = (id: string, label: string, value: DebtMetric): StatItem => ({
446
585
  id, label, value: debtMetricValue(value),
447
586
  detail: `${formatPercentileRank(value.percentile.value, "10Y")}${value.asOf === latest.asOf ? "" : ` · ${value.asOf}`}`,
@@ -460,7 +599,7 @@ export function DebtMaturitiesPane({ width, height, focused }: PaneProps) {
460
599
  detail: `filed ${quarter.filed}`, detailVariants: [""], wide: true,
461
600
  }] : []),
462
601
  ];
463
- }, [latest, quarter]);
602
+ }, [latest, bands, quarter]);
464
603
  const historyStrip = useMemo(() => {
465
604
  const values = bars.flatMap((row) => row.totalPrincipal === null ? [] : [row.totalPrincipal]);
466
605
  const last = values.at(-1);
@@ -501,7 +640,7 @@ export function DebtMaturitiesPane({ width, height, focused }: PaneProps) {
501
640
  stale: !!data && resource.data?.stale,
502
641
  });
503
642
  const renderBucket = (
504
- row: DebtBucket,
643
+ row: MaturityRow,
505
644
  column: BucketColumn,
506
645
  _index: number,
507
646
  state: { selected: boolean },
@@ -521,7 +660,7 @@ export function DebtMaturitiesPane({ width, height, focused }: PaneProps) {
521
660
  ? row.label
522
661
  : column.id === "value"
523
662
  ? debtAmount(row.value)
524
- : debtPercent(bucketShare(row, latest!)),
663
+ : debtPercent(row.share),
525
664
  color: state.selected
526
665
  ? colors.selectedText
527
666
  : row.value === null
@@ -577,9 +716,13 @@ export function DebtMaturitiesPane({ width, height, focused }: PaneProps) {
577
716
  {latest ? (
578
717
  <>
579
718
  {tab === "filing" ? (
580
- <FilingDetail latest={latest} history={data?.history ?? []} quarter={quarter} width={width} height={bodyHeight} />
719
+ bands ? (
720
+ <BandFilingDetail latest={latest} bands={bands} width={width} height={bodyHeight} />
721
+ ) : (
722
+ <FilingDetail latest={latest} history={data?.history ?? []} quarter={quarter} width={width} height={bodyHeight} />
723
+ )
581
724
  ) : tab === "maturities" ? (
582
- <DataTableStackView<DebtBucket, BucketColumn>
725
+ <DataTableStackView<MaturityRow, BucketColumn>
583
726
  emptyStateTitle="No maturity buckets available."
584
727
  focused={focused}
585
728
  rootWidth={width}
@@ -620,9 +763,16 @@ export function DebtMaturitiesPane({ width, height, focused }: PaneProps) {
620
763
  onBack={() => setOpenBucket(null)}
621
764
  detailTitle={openBucketRow?.label}
622
765
  detailContent={
623
- openBucketRow ? (
766
+ openBucketRow?.band ? (
767
+ <BandDetail
768
+ band={openBucketRow.band}
769
+ latest={latest}
770
+ width={width}
771
+ height={bodyHeight - 2}
772
+ />
773
+ ) : openBucketRow ? (
624
774
  <FactDetail
625
- fact={openBucketRow.fact}
775
+ fact={openBucketRow.bucket?.fact ?? null}
626
776
  width={width}
627
777
  height={bodyHeight - 2}
628
778
  />
@@ -2,6 +2,7 @@ import type { DebtHistoryPoint } from "../../../api-client/debt-maturities";
2
2
  import type { SeriesDefinition } from "../../../series/types";
3
3
  import { cachedSeriesNote } from "../shared/series-warning";
4
4
  import { loadDebtMaturities } from "./client";
5
+ import { debtBands } from "./model";
5
6
 
6
7
  type HistoryField = "totalPrincipal" | "next12MonthsShare" | "next3YearsShare";
7
8
 
@@ -32,7 +33,8 @@ export const DEBT_MATURITY_SERIES: readonly SeriesDefinition[] = FIELDS.map(({ i
32
33
  style: "step",
33
34
  load: async ({ ticker }) => {
34
35
  const resource = await loadDebtMaturities(ticker!);
35
- if (!resource.payload.history.length) throw new Error(`No maturity schedule reported for ${ticker}.`);
36
+ // A schedule in its filing's own bands has no principal by year to chart.
37
+ if (!resource.payload.history.length || debtBands(resource.payload.latest)) throw new Error(`No maturity schedule reported for ${ticker}.`);
36
38
  // An amount stays in the unit it is listed in: a filing in another currency is a gap, not a converted figure.
37
39
  const listed = (point: DebtHistoryPoint) => unit !== "USD" || point.currency === "USD";
38
40
  const other = resource.payload.history.find((point) => !listed(point))?.currency;
@@ -10,7 +10,7 @@ import { mapQuote } from "../../../sources/gloomberb-cloud/normalizers";
10
10
  import { regularSessionValuationPrice } from "../../../market-data/quotes/regular-session-valuation";
11
11
  import { declaredDividends } from "../../../utils/declared-dividends";
12
12
  import { cashInMajorUnits } from "../../../utils/dividend-cash";
13
- import { lapsedDividend } from "../../../utils/forward-dividend";
13
+ import { lapsedDividend, monthlyHistoryEnd } from "../../../utils/forward-dividend";
14
14
  import type { DeclaredCash, DeclaredDividendAction, TickerFinancials } from "../../../types/financials";
15
15
  import { logFailure } from "../../../utils/log-failure";
16
16
 
@@ -126,6 +126,13 @@ export function toDividendPayment(
126
126
  };
127
127
  }
128
128
 
129
+ /** A row's publisher when the server names one (a fund's sponsor), else null. */
130
+ function distributionSource(value: unknown): { publisher: string; url: string } | null {
131
+ const source = value as { publisher?: unknown; url?: unknown } | null | undefined;
132
+ return typeof source?.publisher === "string" && source.publisher.trim() && typeof source.url === "string"
133
+ ? { publisher: source.publisher.trim(), url: source.url } : null;
134
+ }
135
+
129
136
  /**
130
137
  * The declared amount of each paid row by its ex-date: a company declaring in
131
138
  * another currency than the listing pays. Rows in the listing's own currency,
@@ -213,7 +220,8 @@ export async function fetchDividendData(
213
220
  const payments = actions && cashCurrency ? actions.dividends.flatMap(action => {
214
221
  const payment = toDividendPayment(action.exDate, action.amount, cashCurrency);
215
222
  const declared = declaredCash.get(action.exDate);
216
- return payment ? [declared ? { ...payment, declared } : payment] : [];
223
+ const source = distributionSource(action.source);
224
+ return payment ? [{ ...payment, ...(declared ? { declared } : {}), ...(source ? { source } : {}) }] : [];
217
225
  }).sort((a, b) => b.exDate.getTime() - a.exDate.getTime()) : [];
218
226
  if (!historyError && actions && (actions.coverage?.dividends === "unavailable" || payments.length !== actions.dividends.length)) {
219
227
  // A read with no rows is not an incomplete one.
@@ -273,7 +281,7 @@ export function buildDividendMetrics(
273
281
  const reportedExDate = reportedDividendDate(quoteFields?.exDividendDate ?? null);
274
282
  const pastExDates = payments.filter((payment) => payment.exDate <= now).map((payment) => payment.exDate.getTime());
275
283
  if (reportedExDate && reportedExDate <= now) pastExDates.push(reportedExDate.getTime());
276
- const lastExDividendDate = pastExDates.length > 0 ? new Date(Math.max(...pastExDates)) : null;
284
+ const latestExDate = pastExDates.length > 0 ? new Date(Math.max(...pastExDates)) : null;
277
285
  const upcomingExDates = payments.filter((payment) => payment.exDate > now).map((payment) => payment.exDate.getTime());
278
286
  if (reportedExDate && reportedExDate > now) upcomingExDates.push(reportedExDate.getTime());
279
287
  const nextExDividendDate = upcomingExDates.length > 0 ? new Date(Math.min(...upcomingExDates)) : null;
@@ -285,10 +293,18 @@ export function buildDividendMetrics(
285
293
  // A dividend that has stopped has no forward rate, whatever is still stated for it.
286
294
  // Without a usable history only the latest date known says it, on the annual window.
287
295
  const declared = options.declared ?? [];
288
- const lapse = options.historyAvailable !== false
296
+ // A monthly payer's history that stops short says so, and its forward rate, trailing yield and last ex-date stop with it:
297
+ // a rate stated for a distribution the history does not hold (IEF's as of 2026-11-02 beside its 2026-09-01) is not shown.
298
+ const historyEnd = options.historyAvailable !== false
299
+ ? monthlyHistoryEnd({ exDates: eligible.map((payment) => payment.exDate), declared: [
300
+ ...declared, ...payments.filter((payment) => payment.exDate > now).map((payment) => ({ exDate: payment.exDate.toISOString().slice(0, 10) })),
301
+ ] }, now)
302
+ : null;
303
+ const lastExDividendDate = historyEnd ? new Date(historyEnd) : latestExDate;
304
+ const lapse = historyEnd ? { lastPaid: historyEnd, historyEnds: true as const } : options.historyAvailable !== false
289
305
  ? lapsedDividend(statedAsOf, {
290
- exDates: [...payments.map((payment) => payment.exDate), ...lastExDividendDate ? [lastExDividendDate] : []], declared }, now)
291
- : lapsedDividend([statedAsOf, lastExDividendDate?.toISOString().slice(0, 10)]
306
+ exDates: [...payments.map((payment) => payment.exDate), ...latestExDate ? [latestExDate] : []], declared }, now)
307
+ : lapsedDividend([statedAsOf, latestExDate?.toISOString().slice(0, 10)]
292
308
  .filter((day): day is string => !!day).sort().at(-1), { exDates: null, declared }, now);
293
309
  // A year whose regular payments differ widely (HSBC's final beside its interims) has no one payment to annualize: its total stands.
294
310
  const uneven = statedRate != null && !lapse && options.historyAvailable !== false ? unevenRegularPayments(eligible, now) : null;