gloomberb 0.20.11 → 0.20.13

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 (677) hide show
  1. package/package.json +2 -1
  2. package/src/account/billing.ts +3 -2
  3. package/src/account/upgrade-dialog.tsx +8 -8
  4. package/src/api-client/awards.ts +16 -0
  5. package/src/api-client/central-bank-rates.ts +5 -0
  6. package/src/api-client/data.ts +55 -2
  7. package/src/api-client/index.ts +28 -3
  8. package/src/api-client/install-experiments.ts +146 -0
  9. package/src/api-client/request.ts +86 -3
  10. package/src/api-client/socket-connection.ts +12 -1
  11. package/src/api-client/socket.ts +21 -3
  12. package/src/api-client/supply-chain-graph.ts +4 -2
  13. package/src/api-client/supply-chain.ts +8 -0
  14. package/src/api-client/telemetry.ts +47 -0
  15. package/src/api-client/types/econ.ts +10 -7
  16. package/src/api-client/types/filings-and-calls.ts +8 -0
  17. package/src/api-client/types/market.ts +4 -0
  18. package/src/api-client/types/news.ts +16 -0
  19. package/src/app/global-shortcuts.ts +2 -1
  20. package/src/app/keybindings/actions.ts +19 -0
  21. package/src/app/pane-runtime/index.tsx +18 -3
  22. package/src/app/pane-runtime/layout-placement.ts +63 -0
  23. package/src/app/pane-runtime/ticker-open-runtime.ts +10 -2
  24. package/src/architecture/floating-promise-allowlist.json +17 -33
  25. package/src/brokers/signed-in/adapter.ts +2 -2
  26. package/src/brokers/signed-in/catalog.ts +13 -4
  27. package/src/capabilities/chart-series.ts +4 -1
  28. package/src/cli/board-coins.ts +10 -1
  29. package/src/cli/commands/crypto-hints.ts +3 -2
  30. package/src/cli/commands/fred-series.ts +0 -54
  31. package/src/cli/commands/market.ts +260 -63
  32. package/src/cli/commands/overview.ts +50 -17
  33. package/src/cli/commands/search.ts +140 -17
  34. package/src/cli/commands/ticker.ts +37 -17
  35. package/src/cli/desktop-pane-shot.ts +27 -2
  36. package/src/cli/earnings-calendar.ts +33 -53
  37. package/src/cli/fx-quote-rate.ts +1 -1
  38. package/src/cli/glossary.ts +14 -5
  39. package/src/cli/history-catalog-series.ts +85 -0
  40. package/src/cli/history-rows.ts +18 -1
  41. package/src/cli/index.ts +1 -1
  42. package/src/cli/known-gaps.ts +9 -0
  43. package/src/cli/list-progress.ts +45 -0
  44. package/src/cli/listing-arg.ts +176 -25
  45. package/src/cli/name-entries.ts +8 -4
  46. package/src/cli/not-a-ticker.ts +2 -2
  47. package/src/cli/pane-functions/catalog.ts +55 -7
  48. package/src/cli/pane-functions/dom.ts +8 -1
  49. package/src/cli/pane-functions/freshness.ts +52 -5
  50. package/src/cli/pane-functions/headless.ts +8 -8
  51. package/src/cli/pane-functions/index.ts +8 -5
  52. package/src/cli/pane-functions/market-session.ts +66 -14
  53. package/src/cli/pane-functions/options.ts +5 -0
  54. package/src/cli/pane-functions/report.ts +4 -1
  55. package/src/cli/pane-functions/resolver.ts +9 -2
  56. package/src/cli/pane-functions/screenshot-assessment.ts +28 -3
  57. package/src/cli/pane-functions/screenshot-types.ts +6 -0
  58. package/src/cli/perpetual-contract.ts +4 -4
  59. package/src/cli/quote-answer.ts +55 -12
  60. package/src/cli/quote-list-reads.ts +87 -0
  61. package/src/cli/report-tables.ts +70 -13
  62. package/src/cli/result.ts +26 -3
  63. package/src/cli/symbol-list.ts +31 -4
  64. package/src/cli/terminal-code-hints.ts +83 -0
  65. package/src/cli/ticker-resolution.ts +2 -1
  66. package/src/cli/treasury-yields.ts +5 -0
  67. package/src/components/chart/composite/axis-overlays.tsx +5 -2
  68. package/src/components/chart/composite/composite-chart.tsx +1 -0
  69. package/src/components/chart/composite/format.ts +101 -15
  70. package/src/components/chart/composite/legend.tsx +60 -25
  71. package/src/components/chart/composite/time-axis.ts +51 -29
  72. package/src/components/chart/composite/toolbar.tsx +42 -6
  73. package/src/components/chart/curve/curve-surface.tsx +5 -5
  74. package/src/components/command-bar/action-runtime.ts +2 -0
  75. package/src/components/command-bar/list/badge.ts +8 -5
  76. package/src/components/command-bar/list/model.ts +0 -5
  77. package/src/components/command-bar/list/view.tsx +39 -2
  78. package/src/components/command-bar/routes/root/plugin-install.ts +4 -2
  79. package/src/components/command-bar/routes/root/provider-search.ts +23 -3
  80. package/src/components/command-bar/routes/root/results.ts +20 -9
  81. package/src/components/command-bar/routes/root/start-here.ts +1 -2
  82. package/src/components/command-bar/routes/ticker-search/actions.ts +2 -3
  83. package/src/components/command-bar/routes/ticker-search/results.ts +23 -4
  84. package/src/components/command-bar/routing/launch-request.ts +2 -1
  85. package/src/components/command-bar/routing/navigation-state.ts +4 -2
  86. package/src/components/command-bar/workflow/types.ts +6 -0
  87. package/src/components/data-table/view.tsx +29 -6
  88. package/src/components/form-modal/host.tsx +1 -1
  89. package/src/components/layout/detached-pane-shell.tsx +3 -0
  90. package/src/components/layout/double-escape-close.ts +34 -3
  91. package/src/components/layout/floating-pane.tsx +10 -4
  92. package/src/components/layout/header.tsx +3 -2
  93. package/src/components/layout/market-summary.ts +3 -3
  94. package/src/components/layout/pane/cycle-order.ts +66 -2
  95. package/src/components/layout/pane/error-boundary.tsx +2 -1
  96. package/src/components/layout/pane/header.tsx +140 -31
  97. package/src/components/layout/pane/sidebar.tsx +13 -5
  98. package/src/components/layout/pane/status-footer.ts +3 -1
  99. package/src/components/layout/shell/drag/runtime.ts +5 -0
  100. package/src/components/layout/shell/index.tsx +25 -0
  101. package/src/components/layout/shell/menu.ts +9 -0
  102. package/src/components/layout/shell/pane/actions.ts +36 -0
  103. package/src/components/layout/shell/pane/management-shortcuts.ts +27 -3
  104. package/src/components/layout/shell/pane-occlusion.ts +40 -0
  105. package/src/components/layout/shell/shortcuts.ts +17 -1
  106. package/src/components/layout/shell/terminal-pointer-runtime.ts +39 -6
  107. package/src/components/layout/shell/window-mode/index.ts +5 -16
  108. package/src/components/layout/shell/window-mode/overlays.tsx +3 -1
  109. package/src/components/markdown-text.tsx +36 -0
  110. package/src/components/market-board/index.tsx +18 -8
  111. package/src/components/metric-treemap/index.tsx +3 -1
  112. package/src/components/onboarding/first-run-workspace.ts +46 -11
  113. package/src/components/onboarding/onboarding-keyboard.ts +57 -5
  114. package/src/components/onboarding/onboarding-wizard.tsx +91 -24
  115. package/src/components/onboarding/portfolio-step/index.tsx +1 -0
  116. package/src/components/onboarding/portfolio-step/positions-panel.tsx +36 -9
  117. package/src/components/onboarding/portfolio-step/types.ts +2 -0
  118. package/src/components/onboarding/tickers-step-model.ts +140 -0
  119. package/src/components/onboarding/tickers-step.tsx +116 -0
  120. package/src/components/onboarding/use-onboarding-broker-form.ts +1 -1
  121. package/src/components/onboarding/use-onboarding-progress.ts +100 -11
  122. package/src/components/onboarding/use-onboarding-upgrade.ts +3 -2
  123. package/src/components/onboarding/wizard-model.ts +3 -1
  124. package/src/components/onboarding/wizard-tickers.ts +139 -0
  125. package/src/components/price-performance.tsx +2 -2
  126. package/src/components/speedometer-gauge/model.ts +2 -1
  127. package/src/components/speedometer-gauge/terminal.tsx +13 -8
  128. package/src/components/ui/button.tsx +48 -4
  129. package/src/components/ui/choice-dialog.tsx +101 -32
  130. package/src/components/ui/data-table/opentui/index.tsx +24 -9
  131. package/src/components/ui/data-table/types.ts +7 -0
  132. package/src/components/ui/inline-quick-add.tsx +19 -3
  133. package/src/components/ui/list-view.tsx +11 -5
  134. package/src/components/ui/multi-select/dialog.tsx +1 -7
  135. package/src/components/ui/not-meaningful.ts +16 -0
  136. package/src/components/ui/query-bar.tsx +32 -5
  137. package/src/components/ui/selection-fill.ts +39 -0
  138. package/src/components/ui/stat-grid.tsx +27 -6
  139. package/src/core/state/app/layout-reducer.ts +2 -1
  140. package/src/core/state/app/pane-choices.ts +68 -0
  141. package/src/core/state/app/state.ts +14 -6
  142. package/src/core/state/app/types.ts +8 -0
  143. package/src/data/config/store/normalize.ts +2 -0
  144. package/src/docs/snapshot.json +1 -1
  145. package/src/i18n/es.ts +5 -2
  146. package/src/i18n/ja.ts +5 -2
  147. package/src/i18n/ko.ts +5 -2
  148. package/src/i18n/zh-cn.ts +5 -2
  149. package/src/i18n/zh-tw.ts +5 -2
  150. package/src/layout/pane-manager/dock-tree.ts +19 -0
  151. package/src/layout/pane-manager/index.ts +3 -0
  152. package/src/layout-marketplace/model.ts +2 -1
  153. package/src/market-data/futures-contract.ts +2 -1
  154. package/src/market-data/hooks.tsx +1 -1
  155. package/src/market-data/market/change-basis.ts +27 -5
  156. package/src/market-data/market/format.ts +13 -13
  157. package/src/market-data/market/freshness.ts +33 -0
  158. package/src/market-data/market/status.ts +5 -1
  159. package/src/market-data/quotes/contributions.ts +10 -0
  160. package/src/market-data/quotes/freshness.ts +19 -0
  161. package/src/market-data/quotes/listing-enterprise-value.ts +3 -3
  162. package/src/market-data/quotes/live-valuation.ts +31 -4
  163. package/src/market-data/quotes/resolution.ts +4 -0
  164. package/src/market-data/quotes/time.ts +17 -24
  165. package/src/market-data/tax-equivalent.ts +3 -2
  166. package/src/news/aggregator.ts +19 -8
  167. package/src/news/hooks.ts +1 -1
  168. package/src/news/news-model.ts +49 -0
  169. package/src/news/types.ts +9 -0
  170. package/src/plugins/builtin/account-management/calendar-tab.tsx +8 -3
  171. package/src/plugins/builtin/account-management/index.tsx +1 -0
  172. package/src/plugins/builtin/account-management/pane.tsx +9 -8
  173. package/src/plugins/builtin/alerts/calendar-events.ts +4 -5
  174. package/src/plugins/builtin/alerts/format.ts +6 -5
  175. package/src/plugins/builtin/alerts/headless.ts +3 -2
  176. package/src/plugins/builtin/alerts/history.ts +2 -1
  177. package/src/plugins/builtin/alerts/pane.tsx +2 -1
  178. package/src/plugins/builtin/alerts/price-text.ts +2 -1
  179. package/src/plugins/builtin/alerts/scheduled.ts +6 -5
  180. package/src/plugins/builtin/analytics/account-returns.ts +6 -7
  181. package/src/plugins/builtin/analytics/display.ts +2 -1
  182. package/src/plugins/builtin/analytics/pane-model.ts +5 -9
  183. package/src/plugins/builtin/analytics/risk-model.ts +6 -6
  184. package/src/plugins/builtin/analytics/risk-pane.tsx +6 -5
  185. package/src/plugins/builtin/analytics/view.tsx +5 -5
  186. package/src/plugins/builtin/attention/model.ts +6 -5
  187. package/src/plugins/builtin/attention/pane.tsx +5 -4
  188. package/src/plugins/builtin/awards/detail.tsx +17 -8
  189. package/src/plugins/builtin/awards/headless.ts +37 -15
  190. package/src/plugins/builtin/awards/model.ts +40 -5
  191. package/src/plugins/builtin/awards/pane.tsx +11 -8
  192. package/src/plugins/builtin/backtest/format.ts +3 -2
  193. package/src/plugins/builtin/backtest/report.ts +3 -2
  194. package/src/plugins/builtin/bond-calculator/headless.ts +2 -1
  195. package/src/plugins/builtin/bond-calculator/pane.tsx +2 -1
  196. package/src/plugins/builtin/broker-manager/add-flow.tsx +1 -1
  197. package/src/plugins/builtin/broker-manager/index.tsx +1 -0
  198. package/src/plugins/builtin/broker-trading/index.tsx +1 -1
  199. package/src/plugins/builtin/broker-trading/orders-data.ts +3 -3
  200. package/src/plugins/builtin/broker-trading/orders.tsx +3 -2
  201. package/src/plugins/builtin/broker-trading/ticket.tsx +2 -2
  202. package/src/plugins/builtin/buildout/cells.tsx +2 -1
  203. package/src/plugins/builtin/buildout/company/pane.tsx +4 -3
  204. package/src/plugins/builtin/buildout/data-runtime.ts +21 -23
  205. package/src/plugins/builtin/buildout/detail/values.ts +2 -1
  206. package/src/plugins/builtin/buildout/format.ts +4 -3
  207. package/src/plugins/builtin/buildout/pane/index.tsx +3 -3
  208. package/src/plugins/builtin/catalysts/detail.tsx +2 -1
  209. package/src/plugins/builtin/catalysts/model.ts +6 -5
  210. package/src/plugins/builtin/catalysts/pane.tsx +2 -1
  211. package/src/plugins/builtin/cds/headless.ts +3 -2
  212. package/src/plugins/builtin/cds/model.ts +8 -8
  213. package/src/plugins/builtin/cds/pane.tsx +3 -2
  214. package/src/plugins/builtin/central-bank-rates/headless.ts +8 -7
  215. package/src/plugins/builtin/central-bank-rates/index.tsx +1 -1
  216. package/src/plugins/builtin/central-bank-rates/model.ts +24 -5
  217. package/src/plugins/builtin/central-bank-rates/pane.tsx +19 -9
  218. package/src/plugins/builtin/changelog/index.tsx +2 -2
  219. package/src/plugins/builtin/chart-composer/headless.ts +5 -1
  220. package/src/plugins/builtin/chart-composer/index.tsx +4 -2
  221. package/src/plugins/builtin/chart-composer/pane.tsx +8 -3
  222. package/src/plugins/builtin/chart-composer/use-series-catalog.ts +3 -1
  223. package/src/plugins/builtin/chart-composer/user-series.ts +3 -1
  224. package/src/plugins/builtin/chat/attachments/desktop.tsx +2 -1
  225. package/src/plugins/builtin/chat/content/handle-prompt.tsx +4 -0
  226. package/src/plugins/builtin/chat/controller/realtime.ts +17 -1
  227. package/src/plugins/builtin/chat/controller/utils.ts +2 -1
  228. package/src/plugins/builtin/chat/message/terminal.tsx +4 -1
  229. package/src/plugins/builtin/chat/sidebar.tsx +3 -4
  230. package/src/plugins/builtin/clinical-trials/model.ts +4 -3
  231. package/src/plugins/builtin/clinical-trials/sponsor-tickers.ts +4 -2
  232. package/src/plugins/builtin/cloud/askg/lock-note.ts +16 -4
  233. package/src/plugins/builtin/cloud/askg/model.ts +2 -1
  234. package/src/plugins/builtin/cloud/askg/pane.tsx +39 -1
  235. package/src/plugins/builtin/cloud/company-picker.tsx +1 -3
  236. package/src/plugins/builtin/cloud/plugin.tsx +1 -0
  237. package/src/plugins/builtin/cloud/team/module.tsx +1 -0
  238. package/src/plugins/builtin/cloud/team/pane.tsx +12 -12
  239. package/src/plugins/builtin/cloud/thesis/detail.tsx +22 -12
  240. package/src/plugins/builtin/cloud-tweets/model.ts +2 -2
  241. package/src/plugins/builtin/comment-letters/pane.tsx +2 -1
  242. package/src/plugins/builtin/commodity-balances/headless.ts +3 -2
  243. package/src/plugins/builtin/commodity-balances/pane.tsx +13 -5
  244. package/src/plugins/builtin/company-attention/app-rank.tsx +5 -4
  245. package/src/plugins/builtin/company-attention/building-model.ts +7 -7
  246. package/src/plugins/builtin/company-attention/headless.ts +6 -5
  247. package/src/plugins/builtin/company-attention/model.ts +4 -4
  248. package/src/plugins/builtin/company-attention/moves-model.ts +9 -9
  249. package/src/plugins/builtin/company-attention/signals-model.ts +9 -9
  250. package/src/plugins/builtin/company-kpis/headless.ts +2 -1
  251. package/src/plugins/builtin/company-kpis/model.ts +18 -13
  252. package/src/plugins/builtin/company-kpis/pane.tsx +2 -2
  253. package/src/plugins/builtin/congress-trades/detail.tsx +6 -5
  254. package/src/plugins/builtin/congress-trades/headless.ts +2 -1
  255. package/src/plugins/builtin/congress-trades/model.ts +6 -6
  256. package/src/plugins/builtin/congress-trades/table.tsx +7 -6
  257. package/src/plugins/builtin/connections/index.ts +1 -0
  258. package/src/plugins/builtin/connections/pane.tsx +5 -5
  259. package/src/plugins/builtin/correlation/headless.ts +2 -2
  260. package/src/plugins/builtin/correlation/index.tsx +4 -1
  261. package/src/plugins/builtin/correlation/matrix/selection.ts +2 -1
  262. package/src/plugins/builtin/correlation/relationship/view-model.ts +3 -3
  263. package/src/plugins/builtin/cot/headless.ts +3 -2
  264. package/src/plugins/builtin/cot/model.ts +2 -1
  265. package/src/plugins/builtin/cot/pane.tsx +4 -3
  266. package/src/plugins/builtin/cpi/headless.ts +4 -3
  267. package/src/plugins/builtin/cpi/model.ts +8 -7
  268. package/src/plugins/builtin/credit-boards/cdx-pane.tsx +14 -9
  269. package/src/plugins/builtin/credit-boards/client.ts +5 -0
  270. package/src/plugins/builtin/credit-boards/headless.ts +3 -7
  271. package/src/plugins/builtin/credit-boards/model.ts +5 -11
  272. package/src/plugins/builtin/credit-boards/series.ts +19 -8
  273. package/src/plugins/builtin/credit-boards/sovr-pane.tsx +9 -5
  274. package/src/plugins/builtin/credit-conditions/headless.ts +2 -1
  275. package/src/plugins/builtin/credit-conditions/index.tsx +2 -2
  276. package/src/plugins/builtin/credit-documents/model.ts +2 -2
  277. package/src/plugins/builtin/crypto-board/defi-view.tsx +7 -7
  278. package/src/plugins/builtin/crypto-board/defi.ts +2 -2
  279. package/src/plugins/builtin/crypto-board/model.ts +4 -3
  280. package/src/plugins/builtin/crypto-board/pane.tsx +8 -8
  281. package/src/plugins/builtin/crypto-board/supply.ts +2 -2
  282. package/src/plugins/builtin/crypto-etf-flows/headless.ts +23 -13
  283. package/src/plugins/builtin/crypto-etf-flows/model.ts +4 -4
  284. package/src/plugins/builtin/crypto-etf-flows/pane.tsx +8 -3
  285. package/src/plugins/builtin/custom-view/index.tsx +3 -1
  286. package/src/plugins/builtin/custom-view/pane.tsx +5 -1
  287. package/src/plugins/builtin/custom-view/view-spec.ts +11 -0
  288. package/src/plugins/builtin/debt-maturities/headless.ts +16 -7
  289. package/src/plugins/builtin/debt-maturities/model.ts +12 -18
  290. package/src/plugins/builtin/debt-maturities/pane.tsx +11 -12
  291. package/src/plugins/builtin/dividend-yield/client.ts +7 -3
  292. package/src/plugins/builtin/dividend-yield/headless.ts +16 -11
  293. package/src/plugins/builtin/dividend-yield/pane.tsx +12 -10
  294. package/src/plugins/builtin/dividend-yield/ranking-view.tsx +4 -1
  295. package/src/plugins/builtin/dividend-yield/ranking.ts +19 -11
  296. package/src/plugins/builtin/dividend-yield/types.ts +4 -0
  297. package/src/plugins/builtin/dividend-yield/view.ts +3 -3
  298. package/src/plugins/builtin/docs/use-docs.ts +4 -2
  299. package/src/plugins/builtin/doe/headless.ts +2 -1
  300. package/src/plugins/builtin/doe/model.ts +12 -11
  301. package/src/plugins/builtin/earnings/board-model.ts +42 -7
  302. package/src/plugins/builtin/earnings/board-table.ts +13 -8
  303. package/src/plugins/builtin/earnings/board.tsx +15 -3
  304. package/src/plugins/builtin/earnings/calendar-model.ts +5 -5
  305. package/src/plugins/builtin/earnings/calendar.tsx +11 -6
  306. package/src/plugins/builtin/earnings/client.ts +0 -9
  307. package/src/plugins/builtin/earnings/format.ts +16 -14
  308. package/src/plugins/builtin/earnings/headless.ts +64 -23
  309. package/src/plugins/builtin/earnings/history-model.ts +11 -7
  310. package/src/plugins/builtin/earnings/history-table.ts +14 -9
  311. package/src/plugins/builtin/earnings/history.tsx +22 -14
  312. package/src/plugins/builtin/earnings-calls/calendar.tsx +2 -1
  313. package/src/plugins/builtin/earnings-calls/data.ts +24 -4
  314. package/src/plugins/builtin/earnings-calls/format.ts +29 -10
  315. package/src/plugins/builtin/earnings-calls/headless.ts +23 -3
  316. package/src/plugins/builtin/earnings-calls/index.tsx +1 -0
  317. package/src/plugins/builtin/earnings-calls/model.ts +11 -1
  318. package/src/plugins/builtin/earnings-calls/pane.tsx +2 -5
  319. package/src/plugins/builtin/earnings-calls/upcoming.ts +5 -5
  320. package/src/plugins/builtin/earnings-ripple/headless.ts +2 -1
  321. package/src/plugins/builtin/earnings-ripple/model.ts +3 -2
  322. package/src/plugins/builtin/earnings-ripple/pane.tsx +6 -6
  323. package/src/plugins/builtin/econ/calendar-model.ts +29 -2
  324. package/src/plugins/builtin/econ/detail-view.tsx +2 -2
  325. package/src/plugins/builtin/econ/fred-catalog.ts +3 -0
  326. package/src/plugins/builtin/econ/index.tsx +16 -8
  327. package/src/plugins/builtin/econ-statistics/detail.tsx +2 -1
  328. package/src/plugins/builtin/econ-statistics/headless.ts +7 -5
  329. package/src/plugins/builtin/econ-statistics/index.tsx +1 -1
  330. package/src/plugins/builtin/econ-statistics/pane.tsx +2 -2
  331. package/src/plugins/builtin/equity-screener/headless.ts +5 -5
  332. package/src/plugins/builtin/equity-screener/model.ts +6 -4
  333. package/src/plugins/builtin/equity-screener/pane.tsx +7 -7
  334. package/src/plugins/builtin/equity-screener/screen-check.ts +2 -1
  335. package/src/plugins/builtin/equity-screener/ticker-check.tsx +2 -1
  336. package/src/plugins/builtin/estimate-revisions/model.ts +3 -2
  337. package/src/plugins/builtin/estimate-revisions/pane.tsx +8 -8
  338. package/src/plugins/builtin/executives/format.ts +4 -4
  339. package/src/plugins/builtin/exposure/headless.ts +8 -8
  340. package/src/plugins/builtin/exposure/model.ts +4 -3
  341. package/src/plugins/builtin/exposure/pane.tsx +6 -5
  342. package/src/plugins/builtin/fear-greed/format.ts +7 -7
  343. package/src/plugins/builtin/fear-greed/headless.ts +18 -14
  344. package/src/plugins/builtin/fear-greed/pane.tsx +12 -4
  345. package/src/plugins/builtin/filing-events/feed.ts +2 -1
  346. package/src/plugins/builtin/filing-events/index.tsx +1 -0
  347. package/src/plugins/builtin/futures/table.tsx +8 -8
  348. package/src/plugins/builtin/futures-curve/headless.ts +18 -18
  349. package/src/plugins/builtin/futures-curve/model.ts +5 -5
  350. package/src/plugins/builtin/futures-curve/pane.tsx +8 -8
  351. package/src/plugins/builtin/fx-matrix/index.tsx +32 -21
  352. package/src/plugins/builtin/fx-matrix/pairs.ts +2 -1
  353. package/src/plugins/builtin/gpu/board.tsx +6 -5
  354. package/src/plugins/builtin/gpu/changes.tsx +2 -1
  355. package/src/plugins/builtin/gpu/equities.tsx +2 -2
  356. package/src/plugins/builtin/gpu/headless.ts +4 -3
  357. package/src/plugins/builtin/gpu/model.ts +8 -7
  358. package/src/plugins/builtin/help/functions-table.tsx +41 -9
  359. package/src/plugins/builtin/help/index.tsx +6 -3
  360. package/src/plugins/builtin/help/keybindings-editor.tsx +35 -7
  361. package/src/plugins/builtin/help/shortcut-table.tsx +19 -7
  362. package/src/plugins/builtin/help/table-cells.tsx +51 -0
  363. package/src/plugins/builtin/holders/pane.tsx +4 -1
  364. package/src/plugins/builtin/insider/base-values.ts +2 -2
  365. package/src/plugins/builtin/insider/display.ts +2 -1
  366. package/src/plugins/builtin/insider/headless.ts +16 -16
  367. package/src/plugins/builtin/insider/insider-data.ts +2 -1
  368. package/src/plugins/builtin/insider/signals-model.ts +3 -3
  369. package/src/plugins/builtin/insider/table-model.ts +27 -13
  370. package/src/plugins/builtin/insider/table.tsx +11 -8
  371. package/src/plugins/builtin/insider/tickers.tsx +1 -1
  372. package/src/plugins/builtin/ipo-calendar/model.ts +4 -4
  373. package/src/plugins/builtin/iv-history/format.ts +8 -7
  374. package/src/plugins/builtin/iv-history/headless.ts +18 -16
  375. package/src/plugins/builtin/iv-history/pane.tsx +3 -2
  376. package/src/plugins/builtin/iv-history/screen-pane.tsx +5 -4
  377. package/src/plugins/builtin/jobs/headless.ts +11 -11
  378. package/src/plugins/builtin/jobs/index.tsx +1 -0
  379. package/src/plugins/builtin/jobs/model.ts +2 -2
  380. package/src/plugins/builtin/jobs/pane.tsx +5 -5
  381. package/src/plugins/builtin/jodi/model.ts +2 -2
  382. package/src/plugins/builtin/jodi/pane.tsx +2 -1
  383. package/src/plugins/builtin/kelly-sizer/headless.ts +4 -4
  384. package/src/plugins/builtin/kelly-sizer/model.ts +2 -1
  385. package/src/plugins/builtin/kelly-sizer/sections.tsx +2 -2
  386. package/src/plugins/builtin/macro-day/headless.ts +9 -8
  387. package/src/plugins/builtin/macro-day/model.ts +3 -2
  388. package/src/plugins/builtin/macro-day/pane.tsx +4 -4
  389. package/src/plugins/builtin/macro-day/releases.ts +25 -16
  390. package/src/plugins/builtin/market-halts/model.ts +11 -10
  391. package/src/plugins/builtin/market-halts/pane.tsx +2 -1
  392. package/src/plugins/builtin/market-heatmap/index.tsx +4 -4
  393. package/src/plugins/builtin/market-movers/index.tsx +20 -8
  394. package/src/plugins/builtin/market-movers/model.ts +5 -0
  395. package/src/plugins/builtin/market-movers/session-body.tsx +2 -1
  396. package/src/plugins/builtin/market-movers/session-table.ts +3 -3
  397. package/src/plugins/builtin/market-movers/session.ts +2 -1
  398. package/src/plugins/builtin/market-movers/table.ts +5 -5
  399. package/src/plugins/builtin/market-valuation/detail.tsx +2 -2
  400. package/src/plugins/builtin/market-valuation/headless.ts +7 -7
  401. package/src/plugins/builtin/market-valuation/pane.tsx +7 -7
  402. package/src/plugins/builtin/members/breadth-pane.tsx +5 -4
  403. package/src/plugins/builtin/members/headless.ts +2 -1
  404. package/src/plugins/builtin/members/model.ts +3 -2
  405. package/src/plugins/builtin/members/pane.tsx +10 -9
  406. package/src/plugins/builtin/mna/distress/model.ts +2 -1
  407. package/src/plugins/builtin/mna/model.ts +5 -5
  408. package/src/plugins/builtin/money-markets/headless.ts +14 -3
  409. package/src/plugins/builtin/money-markets/model.ts +3 -2
  410. package/src/plugins/builtin/money-markets/pane.tsx +14 -5
  411. package/src/plugins/builtin/news/headless.ts +5 -2
  412. package/src/plugins/builtin/news/wire/breaking/notifications.ts +21 -19
  413. package/src/plugins/builtin/news/wire/news/row.ts +3 -1
  414. package/src/plugins/builtin/news/wire/news/table.tsx +3 -2
  415. package/src/plugins/builtin/news/wire/persisted-articles.ts +28 -3
  416. package/src/plugins/builtin/notes/headless.ts +2 -1
  417. package/src/plugins/builtin/notes/model.ts +2 -1
  418. package/src/plugins/builtin/openfda/pane.tsx +4 -3
  419. package/src/plugins/builtin/options/carry.ts +3 -2
  420. package/src/plugins/builtin/options/market-reference.ts +2 -1
  421. package/src/plugins/builtin/options/table.ts +48 -9
  422. package/src/plugins/builtin/options/view.tsx +48 -17
  423. package/src/plugins/builtin/options-calculator/headless.ts +3 -2
  424. package/src/plugins/builtin/options-calculator/pane.tsx +7 -7
  425. package/src/plugins/builtin/options-positioning/headless.ts +8 -7
  426. package/src/plugins/builtin/options-positioning/model.ts +10 -10
  427. package/src/plugins/builtin/options-positioning/pane.tsx +6 -6
  428. package/src/plugins/builtin/options-scenario/collar.ts +5 -4
  429. package/src/plugins/builtin/options-scenario/csp-screen-headless.ts +11 -10
  430. package/src/plugins/builtin/options-scenario/csp-screen-pane.tsx +15 -14
  431. package/src/plugins/builtin/options-scenario/csp-screen.ts +2 -1
  432. package/src/plugins/builtin/options-scenario/csp.ts +6 -5
  433. package/src/plugins/builtin/options-scenario/headless.ts +6 -5
  434. package/src/plugins/builtin/options-scenario/hedge.ts +3 -3
  435. package/src/plugins/builtin/options-scenario/pane.tsx +7 -6
  436. package/src/plugins/builtin/options-scenario/strategy-screen.ts +1 -1
  437. package/src/plugins/builtin/pe-band/headless.ts +9 -8
  438. package/src/plugins/builtin/pe-band/pane.tsx +7 -7
  439. package/src/plugins/builtin/perps/cascade.ts +3 -2
  440. package/src/plugins/builtin/perps/headless.ts +10 -9
  441. package/src/plugins/builtin/perps/model.ts +14 -14
  442. package/src/plugins/builtin/perps/pane.tsx +3 -2
  443. package/src/plugins/builtin/portfolio-list/cli/bulk-symbols.ts +4 -31
  444. package/src/plugins/builtin/portfolio-list/header.tsx +2 -2
  445. package/src/plugins/builtin/portfolio-list/index.tsx +3 -2
  446. package/src/plugins/builtin/portfolio-list/pane/futures-terms.ts +4 -2
  447. package/src/plugins/builtin/portfolio-list/pane/index.tsx +6 -1
  448. package/src/plugins/builtin/portfolio-list/pane/period-pnl.ts +2 -1
  449. package/src/plugins/builtin/portfolio-list/pane/purchase-date-fx.ts +4 -2
  450. package/src/plugins/builtin/portfolio-list/quick-add/index.tsx +24 -10
  451. package/src/plugins/builtin/portfolio-list/settings.ts +4 -1
  452. package/src/plugins/builtin/portfolio-list/summary/index.tsx +9 -11
  453. package/src/plugins/builtin/portfolio-list/table.tsx +10 -1
  454. package/src/plugins/builtin/power/detail.tsx +6 -5
  455. package/src/plugins/builtin/power/gas-model.ts +8 -7
  456. package/src/plugins/builtin/power/gas.tsx +2 -1
  457. package/src/plugins/builtin/power/headless.ts +7 -6
  458. package/src/plugins/builtin/power/model.ts +3 -2
  459. package/src/plugins/builtin/power/prices-headless.ts +10 -9
  460. package/src/plugins/builtin/power/prices-model.ts +3 -2
  461. package/src/plugins/builtin/power/prices.tsx +2 -1
  462. package/src/plugins/builtin/primary-dealers/model.ts +3 -3
  463. package/src/plugins/builtin/primary-dealers/pane.tsx +2 -2
  464. package/src/plugins/builtin/rate-path/headless.ts +8 -7
  465. package/src/plugins/builtin/rate-path/model.ts +6 -5
  466. package/src/plugins/builtin/rate-path/pane.tsx +6 -5
  467. package/src/plugins/builtin/realized-vol/fx-proxy.ts +2 -1
  468. package/src/plugins/builtin/realized-vol/headless.ts +37 -10
  469. package/src/plugins/builtin/realized-vol/pane.tsx +5 -4
  470. package/src/plugins/builtin/relative-rotation/headless.ts +2 -1
  471. package/src/plugins/builtin/relative-rotation/pane.tsx +6 -6
  472. package/src/plugins/builtin/research/analyst-headless.ts +5 -5
  473. package/src/plugins/builtin/research/analyst-model.ts +7 -7
  474. package/src/plugins/builtin/research/analyst-pane.tsx +7 -7
  475. package/src/plugins/builtin/research/client.ts +14 -0
  476. package/src/plugins/builtin/research/corporate-actions-pane.tsx +40 -30
  477. package/src/plugins/builtin/research/event-model.ts +55 -22
  478. package/src/plugins/builtin/research/event-sources.ts +26 -8
  479. package/src/plugins/builtin/research/relative-valuation-columns.ts +20 -12
  480. package/src/plugins/builtin/research/relative-valuation-currency.ts +16 -0
  481. package/src/plugins/builtin/research/relative-valuation-headless.ts +33 -21
  482. package/src/plugins/builtin/research/relative-valuation-model.ts +31 -17
  483. package/src/plugins/builtin/research/relative-valuation-pane.tsx +29 -14
  484. package/src/plugins/builtin/research-search/model.ts +2 -1
  485. package/src/plugins/builtin/research-search/saved-view.tsx +4 -3
  486. package/src/plugins/builtin/revenue-breakdown/model.ts +4 -4
  487. package/src/plugins/builtin/reverse-dcf/headless.ts +7 -7
  488. package/src/plugins/builtin/reverse-dcf/model.ts +4 -4
  489. package/src/plugins/builtin/reverse-dcf/pane.tsx +2 -2
  490. package/src/plugins/builtin/risk-factors/index.tsx +1 -0
  491. package/src/plugins/builtin/scanner/flow-model.ts +7 -4
  492. package/src/plugins/builtin/scanner/flow-pane.tsx +1 -1
  493. package/src/plugins/builtin/scanner/headless.ts +3 -2
  494. package/src/plugins/builtin/scanner/hilo-model.ts +2 -1
  495. package/src/plugins/builtin/scanner/live-headless.ts +2 -2
  496. package/src/plugins/builtin/scanner/live-model.ts +3 -2
  497. package/src/plugins/builtin/scanner/live-pane.tsx +5 -5
  498. package/src/plugins/builtin/seasonality/headless.ts +2 -1
  499. package/src/plugins/builtin/seasonality/pane.tsx +4 -3
  500. package/src/plugins/builtin/sec/filing-display.tsx +12 -15
  501. package/src/plugins/builtin/sec/fund-facts.ts +2 -2
  502. package/src/plugins/builtin/sec/headless.ts +2 -1
  503. package/src/plugins/builtin/sec/index.tsx +6 -2
  504. package/src/plugins/builtin/sectors/headless.ts +4 -4
  505. package/src/plugins/builtin/sectors/index.tsx +7 -7
  506. package/src/plugins/builtin/shared/earnings-calendar.ts +90 -6
  507. package/src/plugins/builtin/shared/earnings-report.ts +13 -6
  508. package/src/plugins/builtin/shared/research-cells.tsx +2 -2
  509. package/src/plugins/builtin/shared/source-footer.ts +71 -0
  510. package/src/plugins/builtin/shared/trend.ts +2 -2
  511. package/src/plugins/builtin/shared/use-quote-board.ts +9 -8
  512. package/src/plugins/builtin/short-interest/headless.ts +6 -6
  513. package/src/plugins/builtin/short-interest/model.ts +9 -9
  514. package/src/plugins/builtin/short-interest/publications-model.ts +5 -5
  515. package/src/plugins/builtin/short-interest/publications-pane.tsx +8 -3
  516. package/src/plugins/builtin/short-interest/watch-headless.ts +5 -5
  517. package/src/plugins/builtin/short-interest/watch-pane.tsx +6 -6
  518. package/src/plugins/builtin/short-volume/model.ts +5 -5
  519. package/src/plugins/builtin/short-volume/pane.tsx +9 -5
  520. package/src/plugins/builtin/social-mentions/headless.ts +2 -1
  521. package/src/plugins/builtin/social-mentions/model.ts +4 -4
  522. package/src/plugins/builtin/social-mentions/outliers.tsx +10 -1
  523. package/src/plugins/builtin/social-mentions/pane.tsx +7 -0
  524. package/src/plugins/builtin/supply-chain/client.ts +3 -1
  525. package/src/plugins/builtin/supply-chain/flow.tsx +25 -8
  526. package/src/plugins/builtin/supply-chain/graph-client.ts +1 -1
  527. package/src/plugins/builtin/supply-chain/graph-evidence.ts +1 -1
  528. package/src/plugins/builtin/supply-chain/graph-model.ts +14 -2
  529. package/src/plugins/builtin/supply-chain/graph-pane.tsx +11 -10
  530. package/src/plugins/builtin/supply-chain/graph.tsx +12 -6
  531. package/src/plugins/builtin/supply-chain/headless.ts +15 -8
  532. package/src/plugins/builtin/supply-chain/model.ts +72 -15
  533. package/src/plugins/builtin/supply-chain/pane.tsx +11 -8
  534. package/src/plugins/builtin/supply-chain/row-evidence.tsx +7 -6
  535. package/src/plugins/builtin/themes/headless.ts +2 -1
  536. package/src/plugins/builtin/themes/model.ts +3 -2
  537. package/src/plugins/builtin/themes/pane.tsx +3 -2
  538. package/src/plugins/builtin/thirteenf/format.ts +9 -9
  539. package/src/plugins/builtin/thirteenf/headless.ts +3 -2
  540. package/src/plugins/builtin/thirteenf/model.ts +2 -1
  541. package/src/plugins/builtin/thirteenf/overlap-pane.tsx +2 -1
  542. package/src/plugins/builtin/thirteenf/pane.tsx +5 -4
  543. package/src/plugins/builtin/thirteenf/report-notes.ts +2 -1
  544. package/src/plugins/builtin/thirteenf/signals-pane.tsx +3 -2
  545. package/src/plugins/builtin/thirteenf/table.ts +6 -5
  546. package/src/plugins/builtin/ticker-detail/adr-pair/model.ts +4 -3
  547. package/src/plugins/builtin/ticker-detail/data-panes/historical-prices.tsx +4 -4
  548. package/src/plugins/builtin/ticker-detail/data-panes/returns-pane.tsx +3 -3
  549. package/src/plugins/builtin/ticker-detail/financials/model.ts +83 -35
  550. package/src/plugins/builtin/ticker-detail/financials/ratio-table.tsx +3 -1
  551. package/src/plugins/builtin/ticker-detail/financials/ratios.ts +2 -2
  552. package/src/plugins/builtin/ticker-detail/financials/schema.ts +14 -18
  553. package/src/plugins/builtin/ticker-detail/financials/tab.tsx +8 -13
  554. package/src/plugins/builtin/ticker-detail/headless.ts +7 -5
  555. package/src/plugins/builtin/ticker-detail/overview/chart-scale.ts +52 -0
  556. package/src/plugins/builtin/ticker-detail/overview/components.tsx +18 -5
  557. package/src/plugins/builtin/ticker-detail/overview/model.ts +24 -13
  558. package/src/plugins/builtin/ticker-detail/overview/pane.tsx +6 -0
  559. package/src/plugins/builtin/ticker-detail/overview/tax-equivalent.ts +2 -1
  560. package/src/plugins/builtin/ticker-detail/overview-tab.tsx +35 -7
  561. package/src/plugins/builtin/ticker-detail/pane.tsx +48 -24
  562. package/src/plugins/builtin/ticker-detail/quote-footer.ts +5 -0
  563. package/src/plugins/builtin/ticker-detail/quote-monitor/card.tsx +13 -8
  564. package/src/plugins/builtin/ticker-detail/quote-monitor/rows.ts +4 -4
  565. package/src/plugins/builtin/ticker-detail/settings.ts +17 -0
  566. package/src/plugins/builtin/time-sales/headless.ts +3 -2
  567. package/src/plugins/builtin/time-sales/model.ts +7 -5
  568. package/src/plugins/builtin/time-sales/pane.tsx +7 -6
  569. package/src/plugins/builtin/trace-bonds/model.ts +3 -2
  570. package/src/plugins/builtin/trace-bonds/pane.tsx +3 -2
  571. package/src/plugins/builtin/treasury-auctions/after.ts +50 -23
  572. package/src/plugins/builtin/treasury-auctions/cache.ts +23 -5
  573. package/src/plugins/builtin/treasury-auctions/client.ts +2 -1
  574. package/src/plugins/builtin/treasury-auctions/headless.ts +231 -42
  575. package/src/plugins/builtin/treasury-auctions/hk-headless.ts +14 -7
  576. package/src/plugins/builtin/treasury-auctions/hk-view.tsx +37 -34
  577. package/src/plugins/builtin/treasury-auctions/hk.ts +65 -13
  578. package/src/plugins/builtin/treasury-auctions/index.tsx +3 -0
  579. package/src/plugins/builtin/treasury-auctions/keys.ts +27 -0
  580. package/src/plugins/builtin/treasury-auctions/like.ts +137 -0
  581. package/src/plugins/builtin/treasury-auctions/model.ts +101 -23
  582. package/src/plugins/builtin/treasury-auctions/pane.tsx +56 -28
  583. package/src/plugins/builtin/treasury-auctions/treasury-direct.ts +2 -1
  584. package/src/plugins/builtin/treasury-daily/model.ts +2 -2
  585. package/src/plugins/builtin/vol-surface/events.ts +5 -4
  586. package/src/plugins/builtin/vol-surface/headless.ts +19 -18
  587. package/src/plugins/builtin/vol-surface/heat-grid.tsx +6 -3
  588. package/src/plugins/builtin/vol-surface/pane.tsx +13 -9
  589. package/src/plugins/builtin/vol-surface/stored.ts +2 -1
  590. package/src/plugins/builtin/vol-surface/tables.ts +4 -3
  591. package/src/plugins/builtin/volatility/headless.ts +5 -4
  592. package/src/plugins/builtin/volatility/pane.tsx +6 -6
  593. package/src/plugins/builtin/world-indices/headless.ts +7 -7
  594. package/src/plugins/builtin/world-indices/index.tsx +3 -1
  595. package/src/plugins/builtin/world-venue-map/headless.ts +2 -1
  596. package/src/plugins/builtin/world-venue-map/layered-pane.tsx +2 -1
  597. package/src/plugins/builtin/world-venue-map/layers.ts +3 -2
  598. package/src/plugins/builtin/world-venue-map/use-geo.ts +4 -2
  599. package/src/plugins/builtin/yield-curve/curves.ts +3 -3
  600. package/src/plugins/builtin/yield-curve/headless.ts +7 -6
  601. package/src/plugins/builtin/yield-curve/index.tsx +5 -4
  602. package/src/plugins/builtin/yield-curve/swaps.tsx +2 -1
  603. package/src/plugins/runtime/index.tsx +1 -0
  604. package/src/plugins/runtime/state.ts +20 -0
  605. package/src/portfolio/allocation.ts +5 -5
  606. package/src/portfolio/column-values.ts +54 -42
  607. package/src/portfolio/futures-positions.ts +2 -1
  608. package/src/public/__snapshots__/public-api.test.ts.snap +5 -0
  609. package/src/public/react.ts +7 -0
  610. package/src/react/auto-refresh.ts +29 -0
  611. package/src/renderers/browser/deeplink-bridge.ts +24 -3
  612. package/src/renderers/dom/desktop/query-bar.tsx +229 -60
  613. package/src/renderers/dom/host/overflow-fade-px.ts +2 -0
  614. package/src/renderers/dom/host/overflow-fade.ts +1 -2
  615. package/src/renderers/dom/styles.css +25 -5
  616. package/src/renderers/electrobun/bun/desktop/backend-requests.ts +7 -1
  617. package/src/renderers/electrobun/view/cli-pane-shot-entry.tsx +2 -1
  618. package/src/renderers/opentui/ui-host.tsx +32 -2
  619. package/src/renderers/share/layout-view.tsx +2 -1
  620. package/src/series/types.ts +2 -0
  621. package/src/sources/gloomberb-cloud/fred-attribution.ts +86 -0
  622. package/src/sources/gloomberb-cloud/index.ts +25 -1
  623. package/src/sources/gloomberb-cloud/news.ts +9 -0
  624. package/src/sources/gloomberb-cloud/normalizers.ts +24 -3
  625. package/src/sources/provider-errors.ts +64 -1
  626. package/src/sources/provider-router/batches.ts +19 -0
  627. package/src/sources/provider-router/index.ts +7 -1
  628. package/src/sources/provider-router/search.ts +15 -10
  629. package/src/state/app/context/index.tsx +24 -1
  630. package/src/state/hooks/inline-tickers.ts +3 -2
  631. package/src/state/hooks/quote-streaming.ts +9 -10
  632. package/src/state/pane-unsent-work.ts +47 -0
  633. package/src/team/collections-sync.ts +8 -3
  634. package/src/telemetry/usage-counts.ts +26 -0
  635. package/src/test-support/shell-pane-keys.tsx +5 -0
  636. package/src/test-support/telemetry-guard.ts +83 -0
  637. package/src/test-support/test-env.ts +12 -0
  638. package/src/theme/colors.ts +17 -1
  639. package/src/theme/ui-tokens.ts +50 -1
  640. package/src/tickers/company-name-listing.ts +2 -2
  641. package/src/tickers/company-name.ts +17 -1
  642. package/src/tickers/listing-venues.ts +37 -2
  643. package/src/tickers/renamed-listings.ts +2 -1
  644. package/src/tickers/search/index.ts +19 -0
  645. package/src/tickers/search/japanese-names.json +1 -0
  646. package/src/tickers/search/japanese-names.ts +152 -0
  647. package/src/tickers/starter-symbols.ts +7 -0
  648. package/src/tickers/terminal-codes.ts +55 -6
  649. package/src/time-series/base-series.ts +3 -0
  650. package/src/time-series/fundamentals/statement-fields.ts +11 -14
  651. package/src/time-series/history-acquisition.ts +1 -1
  652. package/src/time-series/log-scale.ts +9 -0
  653. package/src/time-series/reporting.ts +3 -3
  654. package/src/time-series/resolve.ts +6 -4
  655. package/src/time-series/transforms.ts +10 -5
  656. package/src/types/config.ts +9 -0
  657. package/src/types/data-provider.ts +9 -2
  658. package/src/types/financials.ts +26 -0
  659. package/src/types/instrument.ts +6 -0
  660. package/src/types/plugin-contributions.ts +7 -0
  661. package/src/types/plugin-panes.ts +8 -1
  662. package/src/types/plugin-reports.ts +8 -0
  663. package/src/ui/host.tsx +6 -0
  664. package/src/utils/datetime-format.ts +74 -33
  665. package/src/utils/double-escape-close.ts +42 -0
  666. package/src/utils/financial-statements.ts +39 -15
  667. package/src/utils/format.ts +4 -9
  668. package/src/utils/fundamentals.ts +38 -16
  669. package/src/utils/fx-status.ts +30 -7
  670. package/src/utils/growth.ts +67 -0
  671. package/src/utils/keyboard.ts +6 -0
  672. package/src/utils/network-failure.ts +23 -0
  673. package/src/utils/options.ts +1 -1
  674. package/src/utils/report-timing.ts +2 -2
  675. package/src/utils/served-rates.ts +45 -0
  676. package/src/utils/text-wrap.ts +84 -3
  677. package/src/utils/zoned-date-time.ts +47 -22
@@ -14,7 +14,7 @@ import { handleRefreshKey } from "../../../components/data-table/table-pane";
14
14
  import type { DefiTvlPayload } from "../../../api-client/crypto-markets";
15
15
  import { colors, priceColor } from "../../../theme/colors";
16
16
  import { SERIES_COLORS } from "../../../theme/series-colors";
17
- import { formatCompact, formatCompactAmount } from "../../../utils/format";
17
+ import { MISSING_VALUE, formatCompact, formatCompactAmount } from "../../../utils/format";
18
18
  import { usePluginPaneState } from "../../runtime";
19
19
  import {
20
20
  buildDefiColumns,
@@ -47,7 +47,7 @@ function signedPercent(value: number | null): DataTableCell {
47
47
 
48
48
  function signedAmount(value: number | null): DataTableCell {
49
49
  return {
50
- text: value == null ? "—" : formatCompactAmount(value, { signed: true }),
50
+ text: value == null ? MISSING_VALUE : formatCompactAmount(value, { signed: true }),
51
51
  color: value == null ? colors.textDim : priceColor(value),
52
52
  };
53
53
  }
@@ -59,7 +59,7 @@ function renderDefiCell(row: DefiRow, column: DefiColumn): DataTableCell {
59
59
  case "name":
60
60
  return { text: row.name, color: colors.textBright };
61
61
  case "detail":
62
- return { text: row.detail ?? "—", color: colors.textDim };
62
+ return { text: row.detail ?? MISSING_VALUE, color: colors.textDim };
63
63
  case "tvl":
64
64
  return { text: formatTvl(row.tvl) };
65
65
  case "change1dPercent":
@@ -73,9 +73,9 @@ function renderDefiCell(row: DefiRow, column: DefiColumn): DataTableCell {
73
73
  case "change30dPercent":
74
74
  return signedPercent(row.change30dPercent);
75
75
  case "share":
76
- return { text: row.share == null ? "—" : `${row.share.toFixed(2)}%`, color: colors.textDim };
76
+ return { text: row.share == null ? MISSING_VALUE : `${row.share.toFixed(2)}%`, color: colors.textDim };
77
77
  case "chains":
78
- return { text: row.chains == null ? "—" : String(row.chains), color: colors.textDim };
78
+ return { text: row.chains == null ? MISSING_VALUE : String(row.chains), color: colors.textDim };
79
79
  case "fees24h":
80
80
  case "fees7d":
81
81
  case "fees30d":
@@ -83,7 +83,7 @@ function renderDefiCell(row: DefiRow, column: DefiColumn): DataTableCell {
83
83
  case "revenue7d":
84
84
  case "revenue30d": {
85
85
  const value = row[column.id];
86
- return value == null ? { text: "—", color: colors.textDim } : { text: formatTvl(value) };
86
+ return value == null ? { text: MISSING_VALUE, color: colors.textDim } : { text: formatTvl(value) };
87
87
  }
88
88
  }
89
89
  }
@@ -93,7 +93,7 @@ function changeFigure(id: string, label: string, amount: number | null, percent:
93
93
  return {
94
94
  id,
95
95
  label,
96
- value: amount == null ? "—" : formatCompactAmount(amount, { signed: true }),
96
+ value: amount == null ? MISSING_VALUE : formatCompactAmount(amount, { signed: true }),
97
97
  detail: formatCryptoPercent(percent),
98
98
  ...(amount == null ? {} : { color: priceColor(amount) }),
99
99
  };
@@ -1,7 +1,7 @@
1
1
  import type { DefiTvlChain, DefiTvlPayload, DefiTvlProtocol } from "../../../api-client/crypto-markets";
2
2
  import type { DataTableColumn } from "../../../components";
3
3
  import { getTableWidth } from "../../../components/ui/table-layout";
4
- import { formatCompact, formatCompactAmount } from "../../../utils/format";
4
+ import { MISSING_VALUE, formatCompact, formatCompactAmount } from "../../../utils/format";
5
5
  import { compareSortValues, nextHeaderSort, type SortDirection } from "../../../utils/sort-values";
6
6
  import { formatUtcTime } from "../../../utils/utc-time";
7
7
  import { formatCryptoPercent, utcCloseAsOfText } from "./model";
@@ -139,7 +139,7 @@ export function defiHistoryRows(payload: DefiTvlPayload): Array<{ date: string;
139
139
  }
140
140
 
141
141
  const change = (amount: number | null, percent: number | null) =>
142
- amount == null ? "—" : `${formatCompactAmount(amount, { signed: true })} (${formatCryptoPercent(percent)})`;
142
+ amount == null ? MISSING_VALUE : `${formatCompactAmount(amount, { signed: true })} (${formatCryptoPercent(percent)})`;
143
143
 
144
144
  /**
145
145
  * How the total's days are dated: each by the UTC day it closes, which
@@ -1,3 +1,4 @@
1
+ import { MISSING_VALUE } from "../../../utils/format";
1
2
  import type { CryptoAssetKind, CryptoMarketAsset, CryptoPeg } from "../../../api-client/crypto-markets";
2
3
  import type { DataTableColumn } from "../../../components";
3
4
  import { getTableWidth } from "../../../components/ui/table-layout";
@@ -283,7 +284,7 @@ function dayRange(asset: CryptoMarketAsset, price: number, updatedAt: number | n
283
284
 
284
285
  /** `Sat 11:30` UTC; a dash when unknown. */
285
286
  export function formatDayRangeTime(ms: number | null): string {
286
- return ms == null ? "—" : formatUtcWeekdayTime(ms) || "—";
287
+ return ms == null ? MISSING_VALUE : formatUtcWeekdayTime(ms) || MISSING_VALUE;
287
288
  }
288
289
 
289
290
  const rowsByAsset = new WeakMap<CryptoMarketAsset, { quote: Quote | null; day: number; row: CryptoRow }>();
@@ -363,14 +364,14 @@ export function cryptoRowObservations(rows: readonly CryptoRow[]): CryptoRowObse
363
364
  * keeps its decimals.
364
365
  */
365
366
  export function formatCryptoPrice(value: number | null, minimumDecimals = 2, referencePrice?: number | null): string {
366
- if (value == null || !Number.isFinite(value) || value <= 0) return "—";
367
+ if (value == null || !Number.isFinite(value) || value <= 0) return MISSING_VALUE;
367
368
  const magnitude = Math.floor(Math.log10(positive(referencePrice) ? referencePrice : value));
368
369
  const decimals = Math.min(12, Math.max(minimumDecimals, 3 - magnitude));
369
370
  return value.toLocaleString("en-US", { minimumFractionDigits: decimals, maximumFractionDigits: decimals });
370
371
  }
371
372
 
372
373
  export function formatCryptoPercent(value: number | null): string {
373
- if (value == null || !Number.isFinite(value)) return "—";
374
+ if (value == null || !Number.isFinite(value)) return MISSING_VALUE;
374
375
  const text = value.toFixed(2);
375
376
  // A move that rounds to zero carries no sign.
376
377
  if (Number(text) === 0) return "0.00%";
@@ -33,7 +33,7 @@ import type { Quote } from "../../../types/financials";
33
33
  import type { QueryEntry } from "../../../market-data/result-types";
34
34
  import type { PaneProps } from "../../../types/plugin";
35
35
  import { publicTickerKey } from "../../../utils/exchanges";
36
- import { formatCompact, formatCompactAmount } from "../../../utils/format";
36
+ import { MISSING_VALUE, formatCompact, formatCompactAmount } from "../../../utils/format";
37
37
  import { SERIES_COLORS } from "../../../theme/series-colors";
38
38
  import { usePluginPaneState, usePluginTickerActions } from "../../runtime";
39
39
  import { useCommandTab } from "../shared/command-tab";
@@ -133,11 +133,11 @@ function renderCryptoCell(row: CryptoRow, column: CryptoColumn, logos: boolean):
133
133
  content: <PriceSparkline priceHistory={row.history} width={column.width} period="1M" />,
134
134
  };
135
135
  case "volume24h":
136
- return { text: row.volume24h == null ? "—" : formatCompact(row.volume24h, { fixedDecimals: true }), color: colors.textDim };
136
+ return { text: row.volume24h == null ? MISSING_VALUE : formatCompact(row.volume24h, { fixedDecimals: true }), color: colors.textDim };
137
137
  case "marketCap":
138
- return { text: row.marketCap == null ? "—" : formatCompact(row.marketCap, { fixedDecimals: true }), color: colors.textDim };
138
+ return { text: row.marketCap == null ? MISSING_VALUE : formatCompact(row.marketCap, { fixedDecimals: true }), color: colors.textDim };
139
139
  case "pegText":
140
- return { text: row.pegText || "—", color: row.peg?.accrues || (row.peg && row.peg.currency !== "USD") ? colors.text : colors.textDim };
140
+ return { text: row.pegText || MISSING_VALUE, color: row.peg?.accrues || (row.peg && row.peg.currency !== "USD") ? colors.text : colors.textDim };
141
141
  case "offPegBp": {
142
142
  const severity = offPegSeverity(row.offPegBp);
143
143
  return {
@@ -156,7 +156,7 @@ function renderCryptoCell(row: CryptoRow, column: CryptoColumn, logos: boolean):
156
156
  case "high24hAt":
157
157
  return { text: formatDayRangeTime(row.high24hAt), value: row.high24hAt == null ? null : new Date(row.high24hAt), color: colors.textDim };
158
158
  case "supply":
159
- return { text: row.supply == null ? "—" : formatCompact(row.supply, { fixedDecimals: true }) };
159
+ return { text: row.supply == null ? MISSING_VALUE : formatCompact(row.supply, { fixedDecimals: true }) };
160
160
  case "supply7dPercent":
161
161
  return signed(row.supply7dPercent);
162
162
  case "supply30dPercent":
@@ -166,13 +166,13 @@ function renderCryptoCell(row: CryptoRow, column: CryptoColumn, logos: boolean):
166
166
  case "supply30d":
167
167
  return signedAmount(row.supply30d);
168
168
  case "supplyShare":
169
- return { text: row.supplyShare == null ? "—" : `${row.supplyShare.toFixed(2)}%`, color: colors.textDim };
169
+ return { text: row.supplyShare == null ? MISSING_VALUE : `${row.supplyShare.toFixed(2)}%`, color: colors.textDim };
170
170
  }
171
171
  }
172
172
 
173
173
  function signedAmount(value: number | null): DataTableCell {
174
174
  return {
175
- text: value == null ? "—" : formatCompactAmount(value, { signed: true }),
175
+ text: value == null ? MISSING_VALUE : formatCompactAmount(value, { signed: true }),
176
176
  color: value == null ? colors.textDim : priceColor(value),
177
177
  };
178
178
  }
@@ -184,7 +184,7 @@ function supplyChangeFigure(id: string, label: string, amount: number | null, pe
184
184
  return {
185
185
  id,
186
186
  label,
187
- value: amount == null ? "—" : formatCompactAmount(amount, { signed: true }),
187
+ value: amount == null ? MISSING_VALUE : formatCompactAmount(amount, { signed: true }),
188
188
  detail: formatCryptoPercent(percent),
189
189
  ...(amount == null ? {} : { color: priceColor(amount) }),
190
190
  };
@@ -1,5 +1,5 @@
1
1
  import type { StablecoinSupplyCoin, StablecoinSupplyPayload } from "../../../api-client/crypto-markets";
2
- import { formatCompact, formatCompactAmount } from "../../../utils/format";
2
+ import { MISSING_VALUE, formatCompact, formatCompactAmount } from "../../../utils/format";
3
3
  import { formatCryptoPercent, utcCloseAsOfText, type CryptoRowSupply } from "./model";
4
4
 
5
5
  /**
@@ -128,7 +128,7 @@ export function supplySummaryLine(payload: StablecoinSupplyPayload): string | nu
128
128
  const total = payload.total;
129
129
  if (!total) return null;
130
130
  const change = (amount: number | null, percent: number | null) => (
131
- amount == null ? "—" : `${formatCompactAmount(amount, { signed: true })} (${formatCryptoPercent(percent)})`
131
+ amount == null ? MISSING_VALUE : `${formatCompactAmount(amount, { signed: true })} (${formatCryptoPercent(percent)})`
132
132
  );
133
133
  const since = supplyHistoryStart(payload);
134
134
  return [
@@ -1,5 +1,5 @@
1
1
  import type { CryptoEtfFlowsPayload } from "../../../api-client/crypto-etf-flows";
2
- import type { HeadlessPaneColumn } from "../../../types/headless";
2
+ import type { HeadlessPaneColumn, HeadlessPaneFreshness } from "../../../types/headless";
3
3
  import type { HeadlessPaneDefinition } from "../../../types/plugin";
4
4
  import { REPORT_ROWS } from "../shared/headless-options";
5
5
  import { readPriceWindow, type PriceWindow } from "../../../utils/price-window";
@@ -67,6 +67,27 @@ function fundsLine(payload: CryptoEtfFlowsPayload): string | null {
67
67
  return named.length ? `Funds: ${named.join(", ")}.` : null;
68
68
  }
69
69
 
70
+ /**
71
+ * What dates the flows, as `fn ETFF` ends and the pane's footer says it: the
72
+ * publisher, the day (`asOf`, the newest unless a window ends before it) and
73
+ * when the server last read the publisher's table. `daily` says a missing
74
+ * trading day makes them stale.
75
+ */
76
+ export function cryptoEtfFlowFreshness(payload: CryptoEtfFlowsPayload, asOf: string | null, daily = true): HeadlessPaneFreshness {
77
+ return {
78
+ source: payload.source.publisher,
79
+ publisher: payload.source.publisher,
80
+ status: "not-a-feed",
81
+ basis: "daily fund flows",
82
+ ...(daily ? { cadence: "daily" as const } : {}),
83
+ tradingDayMarket: "US",
84
+ ...(asOf ? { asOf } : {}),
85
+ oldest: null,
86
+ // When the server last read the publisher's table, which is what this report retrieved.
87
+ retrievedAt: payload.fetchedAt,
88
+ };
89
+ }
90
+
70
91
  export const cryptoEtfFlowsHeadless: HeadlessPaneDefinition<"rows"> = {
71
92
  shape: "rows",
72
93
  argument: { kind: "none" },
@@ -153,18 +174,7 @@ export const cryptoEtfFlowsHeadless: HeadlessPaneDefinition<"rows"> = {
153
174
  notes: [window ? windowSummaryLine(payload, window, days) : summaryLine(payload), ...funds ? [funds] : [], `Source: ${payload.source.publisher}, ${payload.source.url}`],
154
175
  complete: !payload.stale,
155
176
  ...(payload.stale ? { warnings: [`The flows were last read ${payload.fetchedAt.slice(0, 10)}; newer days may be missing.`] } : {}),
156
- freshness: {
157
- source: payload.source.publisher,
158
- publisher: payload.source.publisher,
159
- status: "not-a-feed",
160
- basis: "daily fund flows",
161
- ...(window && asOf !== payload.asOf ? {} : { cadence: "daily" as const }),
162
- tradingDayMarket: "US",
163
- ...(asOf ? { asOf } : {}),
164
- oldest: null,
165
- // When the server last read the publisher's table, which is what this report retrieved.
166
- retrievedAt: payload.fetchedAt,
167
- },
177
+ freshness: cryptoEtfFlowFreshness(payload, asOf, !(window && asOf !== payload.asOf)),
168
178
  metadata: {
169
179
  asset,
170
180
  unit: payload.unit,
@@ -1,7 +1,7 @@
1
1
  import type { CryptoEtfFlowAsset, CryptoEtfFlowDay, CryptoEtfFlowsPayload } from "../../../api-client/crypto-etf-flows";
2
2
  import type { DataTableColumn } from "../../../components";
3
3
  import { calendarMonthsBefore } from "../../../utils/calendar-date";
4
- import { formatCompactAmount, formatNumber } from "../../../utils/format";
4
+ import { MISSING_VALUE, formatCompactAmount, formatNumber } from "../../../utils/format";
5
5
 
6
6
  export const CRYPTO_ETF_FLOWS_PANE_ID = "crypto-etf-flows";
7
7
 
@@ -45,14 +45,14 @@ export const cryptoEtfFlowAssetLabel = (asset: CryptoEtfFlowAsset) => asset ===
45
45
 
46
46
  /** A day's flow in US$ millions as the table shows it: `+665.2`, `-83.6`, `0.0`, `—` for none. */
47
47
  export function formatFlow(value: number | null | undefined): string {
48
- if (value == null || !Number.isFinite(value)) return "—";
48
+ if (value == null || !Number.isFinite(value)) return MISSING_VALUE;
49
49
  const text = formatNumber(Math.abs(value), 1);
50
50
  return value > 0 && text !== "0.0" ? `+${text}` : value < 0 && text !== "0.0" ? `-${text}` : text;
51
51
  }
52
52
 
53
53
  /** A sum of flows in US$ millions as a figure reads it: `+$526.7M`, `-$1.13B`, `$0`. */
54
54
  export function formatFlowAmount(millions: number | null | undefined): string {
55
- if (millions == null || !Number.isFinite(millions)) return "—";
55
+ if (millions == null || !Number.isFinite(millions)) return MISSING_VALUE;
56
56
  const text = formatCompactAmount(millions * 1_000_000, { signed: true });
57
57
  return text.replace(/^([+-]?)/, "$1$");
58
58
  }
@@ -119,7 +119,7 @@ export const hasFundPriceChanges = (payload: CryptoEtfFlowsPayload | null | unde
119
119
 
120
120
  /** A day's price move as the table shows it: `+2.15%`, `-0.40%`, `—` for none. */
121
121
  export function formatPriceChange(value: number | null | undefined): string {
122
- if (value == null || !Number.isFinite(value)) return "—";
122
+ if (value == null || !Number.isFinite(value)) return MISSING_VALUE;
123
123
  return `${value > 0 ? "+" : ""}${value.toFixed(2)}%`;
124
124
  }
125
125
 
@@ -18,11 +18,14 @@ import { useChartViewReset } from "../../../components/chart/core/view-reset";
18
18
  import { scalarPoint, staticSeries } from "../../../components/chart/static/series";
19
19
  import { handleRefreshKey, usePaneRefreshKey } from "../../../components/data-table/table-pane";
20
20
  import { useAsyncResource, useAutoRefresh, usePaneSettingValue, usePluginPaneState, useUpdatedAgo } from "../../../public/react";
21
+ import { useUtcDay } from "../../../react/auto-refresh";
21
22
  import { colors } from "../../../theme/colors";
22
23
  import type { PaneProps } from "../../../types/plugin";
23
24
  import { Box } from "../../../ui";
24
25
  import { isPlainKeyboardEvent } from "../../../utils/keyboard";
25
26
  import { cachedCryptoEtfFlows, loadCryptoEtfFlows } from "./client";
27
+ import { cryptoEtfFlowFreshness, cryptoEtfFlowsHeadless } from "./headless";
28
+ import { reportFooterSegment } from "../shared/source-footer";
26
29
  import {
27
30
  CRYPTO_ETF_FLOW_ASSETS,
28
31
  CRYPTO_ETF_FLOW_RANGES,
@@ -103,16 +106,18 @@ export function CryptoEtfFlowsPane({ focused, width, height }: PaneProps) {
103
106
  ] : [];
104
107
 
105
108
  const updatedAgo = useUpdatedAgo(resource.updatedAt);
109
+ const utcDay = useUtcDay();
110
+ // The publisher and the flows' day, as `fn ETFF` ends; how long ago it loaded goes first on a narrow row.
106
111
  const footerInfo = useMemo(() => data ? [
107
- { id: "as-of", parts: [{ text: `as of ${data.asOf}`, tone: "muted" as const }] },
112
+ reportFooterSegment(cryptoEtfFlowsHeadless, { rows: [], freshness: cryptoEtfFlowFreshness(data, data.asOf) }),
108
113
  ...(updatedAgo ? [ageFooterSegment(updatedAgo)] : []),
109
- ] : [], [data, updatedAgo]);
114
+ ] : [], [data, updatedAgo, utcDay]);
110
115
  useAutoRefresh(resource.updatedAt, resource.load);
111
116
  const refresh = useCallback(() => resource.reload(), [resource.reload]);
112
117
  usePaneRefreshKey(refresh, { focused });
113
118
  usePaneStatusLinkFooter({
114
119
  registrationId: CRYPTO_ETF_FLOWS_PANE_ID, focused, loading: resource.loading, error: data ? null : resource.error,
115
- url: data?.source.url ?? null, source: data?.source.publisher ?? null, label: "publisher", showOpenHint: true,
120
+ url: data?.source.url ?? null, showOpenHint: true,
116
121
  info: footerInfo, stale: !!data && (data.stale || !!current?.stale),
117
122
  });
118
123
  usePaneNoticeFooter({
@@ -1,6 +1,6 @@
1
1
  import type { GloomPlugin, PaneTemplateCreateOptions } from "../../../types/plugin";
2
2
  import { CUSTOM_VIEW_PANE_ID, CUSTOM_VIEW_SPEC_SETTING, CustomViewPane } from "./pane";
3
- import { parseViewSpec, serializeViewSpec, type ViewSpec } from "./view-spec";
3
+ import { EXAMPLE_VIEW_SPEC, parseViewSpec, serializeViewSpec, type ViewSpec } from "./view-spec";
4
4
 
5
5
  export { CUSTOM_VIEW_PANE_ID } from "./pane";
6
6
  export { setViewRefResolver, trialLoadViewSource, UnknownViewKeysError } from "./loader";
@@ -39,6 +39,8 @@ export const customViewPlugin: GloomPlugin = {
39
39
  defaultMode: "floating",
40
40
  defaultFloatingSize: { width: 100, height: 28 },
41
41
  tableExport: true,
42
+ // The catalog's example is a spec that runs as typed (`catalog VIEW` showed only `<spec JSON or empty>`).
43
+ reportArgument: { kind: "free-text", placeholder: "spec JSON or empty", optional: true, examples: [`'${EXAMPLE_VIEW_SPEC}'`] },
42
44
  settings: {
43
45
  fields: [{
44
46
  key: CUSTOM_VIEW_SPEC_SETTING,
@@ -39,6 +39,7 @@ import {
39
39
  import { loadViewSource, type LoadedView } from "./loader";
40
40
  import {
41
41
  applyViewProjection,
42
+ EXAMPLE_VIEW_SPEC,
42
43
  formatViewValue,
43
44
  growViewColumnDecimals,
44
45
  parseViewSpecOr,
@@ -91,6 +92,9 @@ function columnsFor(spec: ViewSpec, loaded: LoadedView | null): Column[] {
91
92
  });
92
93
  }
93
94
 
95
+ /** What an empty view says: ask for one, or open one from a spec that works as typed. */
96
+ const EMPTY_VIEW_MESSAGE = `Ask Gloom: "make a view of the top S&P movers", or open one from a spec: VIEW ${EXAMPLE_VIEW_SPEC}`;
97
+
94
98
  export function CustomViewPane({ focused, width, height }: PaneProps) {
95
99
  const instance = usePaneInstance();
96
100
  const config = usePaneAppConfig();
@@ -360,7 +364,7 @@ export function CustomViewPane({ focused, width, height }: PaneProps) {
360
364
  if (!spec) {
361
365
  return specError
362
366
  ? <PaneStatusBody error={specError} errorTitle="This view's spec is invalid." />
363
- : <PaneStatusBody empty emptyTitle="This view is empty." emptyMessage={'Ask Gloom: "make a view of the top S&P movers"'} />;
367
+ : <PaneStatusBody empty emptyTitle="This view is empty." emptyMessage={EMPTY_VIEW_MESSAGE} />;
364
368
  }
365
369
 
366
370
  if (loading && !data) {
@@ -84,6 +84,17 @@ export interface ViewSpecValidationResult {
84
84
  warnings: ViewSpecIssue[];
85
85
  }
86
86
 
87
+ /**
88
+ * A spec that works as typed, signed out too: Europe's indices from WEI's
89
+ * board, their names, last and move. The catalog's example and the empty
90
+ * view's both show it.
91
+ */
92
+ export const EXAMPLE_VIEW_SPEC = JSON.stringify({
93
+ version: VIEW_SPEC_VERSION,
94
+ source: { kind: "inline", pane: "WEI" },
95
+ projection: { columns: ["name", "price", "changePercent"], filters: [{ key: "region", op: "eq", value: "europe" }] },
96
+ });
97
+
87
98
  const TRANSFORMS = new Set<ViewTransform>(["raw", "percent", "compact", "abs", "index100"]);
88
99
  const FILTER_OPS = new Set<ViewFilterOp>(["eq", "neq", "gt", "gte", "lt", "lte", "contains", "in", "exists"]);
89
100
  const KEY_PATTERN = /^[A-Za-z0-9_.\-:]{1,80}$/;
@@ -1,5 +1,5 @@
1
1
  import type { DebtMaturitiesPayload } from "../../../api-client/debt-maturities";
2
- import type { HeadlessBundleSection } from "../../../types/headless";
2
+ import type { HeadlessBundleSection, HeadlessPaneFreshness } from "../../../types/headless";
3
3
  import type { HeadlessPaneDefinition } from "../../../types/plugin";
4
4
  import { fetchDebtMaturities } from "./client";
5
5
  import {
@@ -79,6 +79,19 @@ function bandSections(data: DebtMaturitiesPayload, latest: DebtLatest): Headless
79
79
  ];
80
80
  }
81
81
 
82
+ /** What dates a DDIS report, as `fn DDIS` ends and the pane's footer says it. */
83
+ export function debtReportFreshness(data: DebtMaturitiesPayload): HeadlessPaneFreshness {
84
+ const latest = data.latest;
85
+ if (latest && debtBands(latest)) {
86
+ // Dated by the report's balance sheet: an SEC filing named by its form, a report outside SEC cited
87
+ // as the server names it (its form, HKEX or CNINFO, would repeat that name).
88
+ return data.cik ? { asOf: latest.asOf, asOfLabel: latest.form } : { asOf: latest.asOf, source: data.source.name };
89
+ }
90
+ // The latest filing dates the report (a newer 10-Q's balance date), named by its form so the date is
91
+ // not read as the schedule's; the history rows are past years, not stale data.
92
+ return { asOf: debtNewestAsOf(data), asOfLabel: debtNewestForm(data) ?? undefined };
93
+ }
94
+
82
95
  export const debtMaturitiesHeadless: HeadlessPaneDefinition<"bundle"> = {
83
96
  shape: "bundle",
84
97
  freshness: SEC_FILINGS,
@@ -125,9 +138,7 @@ export const debtMaturitiesHeadless: HeadlessPaneDefinition<"bundle"> = {
125
138
  ...(data.notes?.length ? { notes: data.notes } : {}),
126
139
  sections: bandSections(data, latest),
127
140
  metadata: { ...data },
128
- // Dated by the report's balance sheet: an SEC filing named by its form, a report outside SEC cited
129
- // as the server names it (its form, HKEX or CNINFO, would repeat that name).
130
- freshness: data.cik ? { asOf: latest.asOf, asOfLabel: latest.form } : { asOf: latest.asOf, source: data.source.name },
141
+ freshness: debtReportFreshness(data),
131
142
  };
132
143
  }
133
144
  const quarter = newerQuarter(data);
@@ -212,9 +223,7 @@ export const debtMaturitiesHeadless: HeadlessPaneDefinition<"bundle"> = {
212
223
  ],
213
224
  ...(costNote || data.notes?.length ? { notes: [...(data.notes ?? []), ...(costNote ? [costNote] : [])] } : {}),
214
225
  metadata: { ...data },
215
- // The latest filing dates the report (a newer 10-Q's balance date), named by its form so the date is
216
- // not read as the schedule's; the history rows are past years, not stale data.
217
- freshness: { asOf: debtNewestAsOf(data), asOfLabel: debtNewestForm(data) ?? undefined },
226
+ freshness: debtReportFreshness(data),
218
227
  };
219
228
  },
220
229
  };
@@ -9,14 +9,14 @@ import type {
9
9
  import type { DataTableColumn } from "../../../components";
10
10
  import { scalarPoint } from "../../../components/chart/static/series";
11
11
  import type { TimeSeriesPoint } from "../../../time-series/types";
12
- import { formatCompact, formatPercentileRank } from "../../../utils/format";
12
+ import { MISSING_VALUE, formatCompact, formatPercentileRank } from "../../../utils/format";
13
13
 
14
14
  export type DebtLatest = NonNullable<DebtMaturitiesPayload["latest"]>;
15
15
  export type DebtBucket = DebtLatest["buckets"][number];
16
16
  export const debtAmount = (value: number | null) =>
17
- value === null ? "--" : formatCompact(value, { fixedDecimals: true });
17
+ value === null ? MISSING_VALUE : formatCompact(value, { fixedDecimals: true });
18
18
  export const debtPercent = (value: number | null) =>
19
- value === null ? "--" : `${value.toFixed(1)}%`;
19
+ value === null ? MISSING_VALUE : `${value.toFixed(1)}%`;
20
20
  export const debtMetricValue = (metric: DebtMetric) =>
21
21
  metric.unit === "%"
22
22
  ? debtPercent(metric.value)
@@ -107,15 +107,17 @@ export function maturityRows(latest: DebtLatest): MaturityRow[] {
107
107
  }
108
108
  /**
109
109
  * The wall's scale: the largest dated bucket. Thereafter is open ended and
110
- * usually dwarfs every dated year, so scaling to it would flatten them.
110
+ * usually dwarfs every dated year, so scaling to it would flatten them. A
111
+ * ladder of exactly two bands in its filing's own terms (a balance sheet's
112
+ * within one year and after it) has no years to flatten: both share the
113
+ * larger, so 528M within the year never reads as long as 1.76B after it. A
114
+ * schedule by year keeps its dated scale however few of its years have a
115
+ * value, and its Thereafter stays capped.
111
116
  */
112
117
  export function datedBucketScale(latest: DebtLatest): number {
113
- return Math.max(
114
- 0,
115
- ...maturityRows(latest).flatMap((row) =>
116
- row.dated && row.value !== null ? [row.value] : [],
117
- ),
118
- );
118
+ const rows = maturityRows(latest);
119
+ const scaled = debtBands(latest)?.length === 2 ? rows : rows.filter((row) => row.dated);
120
+ return Math.max(0, ...scaled.flatMap((row) => row.value === null ? [] : [row.value]));
119
121
  }
120
122
  export interface BucketBar {
121
123
  /** Share of the bar column, 0 to 1. */
@@ -381,14 +383,6 @@ export function debtNewestAsOf(data: DebtMaturitiesPayload): string | null {
381
383
  export function debtNewestForm(data: DebtMaturitiesPayload): string | null {
382
384
  return newestDebtFiling(data)?.form ?? null;
383
385
  }
384
- /**
385
- * Which filing the pane's date is, as its footer says it, longest first:
386
- * `10-Q 2026-09-30, filed 2026-10-27`, then `10-Q 2026-09-30`.
387
- */
388
- export function debtNewestFilingText(data: DebtMaturitiesPayload): string[] {
389
- const filing = newestDebtFiling(data);
390
- return filing ? [`${filing.form} ${filing.asOf}, filed ${filing.filed}`, `${filing.form} ${filing.asOf}`] : [];
391
- }
392
386
  /** The 10-Q's debt in one line, `Current 212.00M · Non-current 6.84B USD`. */
393
387
  export function quarterDebtText(quarter: DebtQuarter): string {
394
388
  return `Current ${debtAmount(quarter.current?.value ?? null)} · Non-current ${debtAmount(quarter.noncurrent?.value ?? null)} ${quarter.currency}`;
@@ -37,7 +37,7 @@ import { isAccessDenied } from "../../../api-client/errors";
37
37
  import { formatCompactAxis } from "../../../components/chart-table";
38
38
  import { staticSeries } from "../../../components/chart/static/series";
39
39
  import type { PaneProps } from "../../../types/plugin";
40
- import { formatPercentileRank } from "../../../utils/format";
40
+ import { MISSING_VALUE, formatPercentileRank } from "../../../utils/format";
41
41
  import { usePaneRefreshKey } from "../../../components/data-table/table-pane";
42
42
  import { SignInWall } from "../cloud/auth-actions";
43
43
  import {
@@ -45,6 +45,9 @@ import {
45
45
  useResearchCloudSession,
46
46
  } from "../shared/research-cloud-session";
47
47
  import { cachedDebtMaturities, loadDebtMaturities } from "./client";
48
+ import { debtMaturitiesHeadless, debtReportFreshness } from "./headless";
49
+ import { reportFooterSegment } from "../shared/source-footer";
50
+ import { useUtcDay } from "../../../react/auto-refresh";
48
51
  import {
49
52
  HISTORY_COLUMNS,
50
53
  bandScaleText,
@@ -61,7 +64,6 @@ import {
61
64
  debtFilingUrl,
62
65
  debtMetricCaption,
63
66
  debtMetricValue,
64
- debtNewestFilingText,
65
67
  debtNotices,
66
68
  debtPercent,
67
69
  historyAxis,
@@ -367,7 +369,7 @@ function FilingDetail({
367
369
  labelWidth={20}
368
370
  label="Comparable filings"
369
371
  value={String(latest.totalPrincipal.percentile.sampleCount)}
370
- detail={`${latest.totalPrincipal.percentile.historyStart ?? "--"} to ${latest.totalPrincipal.percentile.historyEnd ?? "--"}`}
372
+ detail={`${latest.totalPrincipal.percentile.historyStart ?? MISSING_VALUE} to ${latest.totalPrincipal.percentile.historyEnd ?? MISSING_VALUE}`}
371
373
  />
372
374
  {quarter ? (
373
375
  <>
@@ -607,15 +609,12 @@ export function DebtMaturitiesPane({ width, height, focused }: PaneProps) {
607
609
  label: "Principal total", values, value: debtAmount(last), color: colors.warning,
608
610
  };
609
611
  }, [bars]);
610
- // Which filing the pane's date is, then how long ago it loaded: the age goes first in a narrow footer.
611
- const filingFooter = useMemo(() => {
612
- const [filing, ...shorter] = data ? debtNewestFilingText(data) : [];
613
- return [
614
- ...(filing ? [{ id: "filing", asOf: true, parts: [{ text: filing, tone: "muted" as const }],
615
- variants: shorter.map((text) => [{ text, tone: "muted" as const }]) }] : []),
616
- ...(data && updatedAgo ? [ageFooterSegment(updatedAgo)] : []),
617
- ];
618
- }, [data, updatedAgo]);
612
+ const utcDay = useUtcDay();
613
+ // Its source and which filing dates it, as `fn DDIS` ends, then how long ago it loaded: the age goes first in a narrow footer.
614
+ const filingFooter = useMemo(() => data ? [
615
+ reportFooterSegment(debtMaturitiesHeadless, { sections: [], freshness: debtReportFreshness(data) }),
616
+ ...(updatedAgo ? [ageFooterSegment(updatedAgo)] : []),
617
+ ] : [], [data, updatedAgo, utcDay]);
619
618
  useAutoRefresh(resource.updatedAt, resource.load);
620
619
  usePaneRefreshKey(() => resource.reload(), { focused });
621
620
  usePaneNoticeFooter({
@@ -333,6 +333,8 @@ export function buildDividendMetrics(
333
333
  growth3Y: growth3Y?.growth ?? null,
334
334
  ...(growth1Y?.shortfall ? { growth1YPayments: growth1Y.shortfall } : {}),
335
335
  ...(growth3Y?.shortfall ? { growth3YPayments: growth3Y.shortfall } : {}),
336
+ ...(growth1Y?.notMeaningful ? { growth1YNotMeaningful: true } : {}),
337
+ ...(growth3Y?.notMeaningful ? { growth3YNotMeaningful: true } : {}),
336
338
  paymentFrequency: options.historyAvailable !== false ? inferFrequency(eligible, now) : null,
337
339
  lastExDividendDate,
338
340
  nextExDividendDate,
@@ -353,9 +355,10 @@ export function repriceDividendMetrics(metrics: DividendMetrics, price: number |
353
355
  * when each holds every payment the cadence pays: a year with a hole in its
354
356
  * history (AZN's missing August interim) measures the hole, not a cut, so it
355
357
  * has no growth and says how many payments it holds. A year with none is a
356
- * suspension, which still reads as a full decline.
358
+ * suspension, which still reads as a full decline. Cash paid after a year of
359
+ * none is growth off zero: not meaningful, never a number.
357
360
  */
358
- function computeGrowth(payments: DividendPayment[], years: number, now: Date): { growth: number | null; shortfall?: GrowthPayments } | null {
361
+ function computeGrowth(payments: DividendPayment[], years: number, now: Date): { growth: number | null; shortfall?: GrowthPayments; notMeaningful?: true } | null {
359
362
  const priorEnd = calendarMonthsBefore(now, 12 * years);
360
363
  const priorStart = calendarMonthsBefore(priorEnd, 12);
361
364
  // A new fund's partial first year is not a full-year growth baseline.
@@ -368,7 +371,8 @@ function computeGrowth(payments: DividendPayment[], years: number, now: Date): {
368
371
  }
369
372
  const recent = trailingCashAt(payments, now);
370
373
  const prior = trailingCashAt(payments, priorEnd);
371
- return { growth: prior > 0 ? Math.pow(recent / prior, 1 / years) - 1 : null };
374
+ if (!(prior > 0)) return recent > 0 ? { growth: null, notMeaningful: true } : { growth: null };
375
+ return { growth: Math.pow(recent / prior, 1 / years) - 1 };
372
376
  }
373
377
 
374
378
  function inferFrequency(payments: DividendPayment[], now: Date): DividendMetrics["paymentFrequency"] {