gloomberb 0.20.7 → 0.20.8

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 (611) hide show
  1. package/README.ja.md +74 -0
  2. package/README.md +2 -0
  3. package/README.zh-CN.md +2 -0
  4. package/package.json +6 -1
  5. package/src/account/auth-model.ts +22 -0
  6. package/src/api-client/auth.ts +7 -2
  7. package/src/api-client/awards.ts +5 -0
  8. package/src/api-client/bond-trades.ts +22 -0
  9. package/src/api-client/catalysts.ts +11 -1
  10. package/src/api-client/data.ts +30 -6
  11. package/src/api-client/debt-maturities.ts +7 -0
  12. package/src/api-client/equity-screener.ts +17 -0
  13. package/src/api-client/errors.ts +2 -0
  14. package/src/api-client/exchange-announcements.ts +14 -7
  15. package/src/api-client/fund-facts.ts +21 -3
  16. package/src/api-client/futures-curve.ts +14 -1
  17. package/src/api-client/geo.ts +10 -0
  18. package/src/api-client/hiring.ts +2 -0
  19. package/src/api-client/index.ts +3 -0
  20. package/src/api-client/insider-signals.ts +14 -0
  21. package/src/api-client/members.ts +30 -2
  22. package/src/api-client/money-markets.ts +11 -1
  23. package/src/api-client/paths.ts +6 -1
  24. package/src/api-client/perps.ts +2 -0
  25. package/src/api-client/request.ts +2 -1
  26. package/src/api-client/socket.ts +7 -0
  27. package/src/api-client/types/econ.ts +2 -1
  28. package/src/api-client/types/filings-and-calls.ts +6 -0
  29. package/src/api-client/types/market.ts +4 -0
  30. package/src/api-client/web-experiments.ts +5 -6
  31. package/src/app/runtime/update.ts +2 -1
  32. package/src/architecture/floating-promise-allowlist.json +33 -106
  33. package/src/capabilities/asset-data-inputs.ts +183 -0
  34. package/src/capabilities/factories.ts +8 -2
  35. package/src/cli/base-converter.ts +36 -2
  36. package/src/cli/commands/api.ts +2 -2
  37. package/src/cli/commands/command-utils.ts +18 -0
  38. package/src/cli/commands/hong-kong-movers.ts +50 -0
  39. package/src/cli/commands/market.ts +539 -130
  40. package/src/cli/commands/options-chain.ts +7 -1
  41. package/src/cli/commands/overview.ts +74 -14
  42. package/src/cli/commands/plugins.ts +7 -6
  43. package/src/cli/commands/search.ts +52 -9
  44. package/src/cli/commands/system.ts +15 -10
  45. package/src/cli/commands/ticker.ts +97 -44
  46. package/src/cli/content-figures.ts +45 -0
  47. package/src/cli/context.ts +5 -0
  48. package/src/cli/desktop-pane-shot-routes.ts +13 -4
  49. package/src/cli/desktop-pane-shot.ts +86 -12
  50. package/src/cli/earnings-calendar.ts +36 -5
  51. package/src/cli/export-source.ts +17 -3
  52. package/src/cli/fx-pair.ts +111 -11
  53. package/src/cli/glossary.ts +36 -2
  54. package/src/cli/help.ts +1 -1
  55. package/src/cli/history-export.ts +29 -11
  56. package/src/cli/history-rows.ts +130 -21
  57. package/src/cli/index.ts +8 -5
  58. package/src/cli/known-gaps.ts +45 -1
  59. package/src/cli/listing-arg.ts +366 -19
  60. package/src/cli/pane-functions/capabilities.ts +2 -2
  61. package/src/cli/pane-functions/catalog.ts +105 -9
  62. package/src/cli/pane-functions/discovery.ts +2 -0
  63. package/src/cli/pane-functions/dom.ts +46 -9
  64. package/src/cli/pane-functions/freshness.ts +7 -3
  65. package/src/cli/pane-functions/function-help.ts +9 -6
  66. package/src/cli/pane-functions/headless.ts +77 -6
  67. package/src/cli/pane-functions/index.ts +141 -23
  68. package/src/cli/pane-functions/options.ts +1 -3
  69. package/src/cli/pane-functions/plugin-code.ts +169 -0
  70. package/src/cli/pane-functions/report.ts +10 -0
  71. package/src/cli/pane-functions/resolver.ts +69 -21
  72. package/src/cli/pane-functions/screenshot-assessment.ts +82 -3
  73. package/src/cli/pane-functions/screenshot-data-evidence.ts +3 -1
  74. package/src/cli/pane-functions/screenshot-types.ts +6 -0
  75. package/src/cli/quote-answer.ts +49 -2
  76. package/src/cli/registry.ts +42 -4
  77. package/src/cli/report-tables.ts +26 -6
  78. package/src/cli/result.ts +13 -2
  79. package/src/cli/series-search.ts +17 -7
  80. package/src/cli/statement-filings.ts +22 -8
  81. package/src/cli/symbol-args.ts +9 -0
  82. package/src/cli/ticker-resolution.ts +3 -2
  83. package/src/cli/unknown-command.ts +111 -14
  84. package/src/components/chart/composite/format.ts +15 -1
  85. package/src/components/chart/composite/legend.tsx +101 -47
  86. package/src/components/chart/composite/panel-labels.ts +4 -4
  87. package/src/components/chart/composite/panel-surface.tsx +4 -6
  88. package/src/components/chart/composite/scene/build.ts +180 -0
  89. package/src/components/chart/composite/scene/cursor.ts +226 -0
  90. package/src/components/chart/composite/scene/domain.ts +170 -0
  91. package/src/components/chart/composite/scene/markers.ts +115 -0
  92. package/src/components/chart/composite/scene/panels.ts +85 -0
  93. package/src/components/chart/composite/scene/points.ts +169 -0
  94. package/src/components/chart/composite/scene/projection.ts +105 -0
  95. package/src/components/chart/composite/scene/timeline.ts +71 -0
  96. package/src/components/chart/composite/scene.ts +12 -1066
  97. package/src/components/chart/composite/types.ts +4 -2
  98. package/src/components/chart/curve/model.ts +2 -2
  99. package/src/components/chart-table/axis.ts +18 -6
  100. package/src/components/command-bar/layout-items/focused-pane.ts +3 -0
  101. package/src/components/command-bar/list/model.ts +9 -0
  102. package/src/components/command-bar/pane-templates/items.ts +61 -15
  103. package/src/components/command-bar/pane-templates/workflow.ts +16 -5
  104. package/src/components/command-bar/routes/root/plugin-install.ts +7 -46
  105. package/src/components/command-bar/routes/root/provider-search.ts +8 -5
  106. package/src/components/command-bar/routes/root/results.ts +6 -1
  107. package/src/components/command-bar/routes/root/runtime.ts +1 -0
  108. package/src/components/command-bar/routes/root/shortcut-feedback.ts +4 -1
  109. package/src/components/command-bar/routes/ticker-search/actions.ts +7 -5
  110. package/src/components/command-bar/routes/ticker-search/results.ts +51 -3
  111. package/src/components/command-bar/view-model.ts +12 -0
  112. package/src/components/command-bar/workflow/ops.ts +21 -4
  113. package/src/components/command-bar/workflow/ticker-listing-picker.ts +3 -1
  114. package/src/components/command-bar/workflow/tickers.ts +6 -2
  115. package/src/components/data-table/view.tsx +46 -1
  116. package/src/components/form-modal/confirm.tsx +3 -2
  117. package/src/components/form-modal/content.tsx +3 -2
  118. package/src/components/form-modal/field-row.tsx +2 -0
  119. package/src/components/form-modal/host.tsx +18 -3
  120. package/src/components/form-modal/remote-reads.test-helpers.ts +34 -0
  121. package/src/components/index.ts +1 -1
  122. package/src/components/layout/pane/title.ts +21 -5
  123. package/src/components/layout/shell/pane/layers.tsx +20 -14
  124. package/src/components/layout/shell/pane-occlusion.ts +21 -0
  125. package/src/components/onboarding/desks-step.tsx +7 -1
  126. package/src/components/onboarding/onboarding-keyboard.ts +48 -6
  127. package/src/components/onboarding/onboarding-wizard.tsx +47 -8
  128. package/src/components/onboarding/portfolio-step/positions-panel.tsx +17 -3
  129. package/src/components/onboarding/use-onboarding-progress.ts +57 -14
  130. package/src/components/onboarding/wizard-positions.ts +2 -0
  131. package/src/components/paged-rows.ts +11 -5
  132. package/src/components/ticker/list-table-view.tsx +24 -5
  133. package/src/components/toggle-list.tsx +44 -1
  134. package/src/components/ui/data-table/opentui/index.tsx +7 -6
  135. package/src/components/ui/data-table/opentui/model.ts +7 -3
  136. package/src/components/ui/data-table/types.ts +13 -2
  137. package/src/components/ui/fields.tsx +16 -4
  138. package/src/components/ui/query-bar.tsx +43 -9
  139. package/src/components/ui/table-layout.ts +56 -2
  140. package/src/core/app-services.ts +7 -2
  141. package/src/core/connection-health.ts +26 -0
  142. package/src/core/state/app/layout.ts +12 -4
  143. package/src/data/config/layout.ts +3 -1
  144. package/src/data/config/store/node.ts +4 -2
  145. package/src/docs/snapshot.json +756 -216
  146. package/src/i18n/es.ts +4 -1
  147. package/src/i18n/ja.ts +4 -1
  148. package/src/i18n/ko.ts +4 -1
  149. package/src/i18n/zh-cn.ts +4 -1
  150. package/src/i18n/zh-tw.ts +4 -1
  151. package/src/layout/pane-follow.ts +1 -1
  152. package/src/layout/pane-manager/gridlock.ts +18 -5
  153. package/src/layout/pane-manager/index.ts +1 -0
  154. package/src/layout/pane-manager/transient.ts +56 -0
  155. package/src/layout-marketplace/gallery.tsx +2 -1
  156. package/src/layout-marketplace/model.ts +4 -10
  157. package/src/market-data/commodity-names.ts +24 -0
  158. package/src/market-data/connection-follow.ts +9 -7
  159. package/src/market-data/coordinator/auxiliary.ts +4 -3
  160. package/src/market-data/coordinator/entries.ts +22 -1
  161. package/src/market-data/coordinator/financials.ts +2 -3
  162. package/src/market-data/coordinator/index.ts +67 -12
  163. package/src/market-data/coordinator/quotes.ts +2 -3
  164. package/src/market-data/fund-facts.ts +7 -1
  165. package/src/market-data/futures-board.ts +38 -4
  166. package/src/market-data/futures-contract.ts +5 -2
  167. package/src/market-data/fx-closes.ts +4 -1
  168. package/src/market-data/market/bar-period.ts +15 -0
  169. package/src/market-data/market/format.ts +4 -2
  170. package/src/market-data/market/freshness.ts +4 -0
  171. package/src/market-data/market/status.ts +23 -3
  172. package/src/market-data/options-alternatives.ts +21 -9
  173. package/src/market-data/published-futures-sessions.ts +9 -0
  174. package/src/market-data/quotes/balance-sheet-rate.ts +34 -0
  175. package/src/market-data/quotes/delisting.ts +26 -2
  176. package/src/market-data/quotes/freshness.ts +62 -0
  177. package/src/market-data/quotes/listing-enterprise-value.ts +250 -19
  178. package/src/market-data/quotes/regular-session-valuation.ts +8 -0
  179. package/src/market-data/realized-volatility.ts +3 -1
  180. package/src/market-data/request-types.ts +2 -0
  181. package/src/market-data/selectors.ts +1 -0
  182. package/src/news/aggregator.ts +3 -3
  183. package/src/plugins/builtin/account-management/delete-account.ts +78 -0
  184. package/src/plugins/builtin/account-management/pane.tsx +22 -19
  185. package/src/plugins/builtin/account-management/password-dialog.tsx +75 -0
  186. package/src/plugins/builtin/alerts/alert-log.ts +3 -2
  187. package/src/plugins/builtin/alerts/cli-forms.ts +1 -1
  188. package/src/plugins/builtin/alerts/cli.ts +72 -4
  189. package/src/plugins/builtin/alerts/format.ts +8 -2
  190. package/src/plugins/builtin/alerts/index.tsx +8 -5
  191. package/src/plugins/builtin/alerts/pane.tsx +5 -3
  192. package/src/plugins/builtin/alerts/research-builder.ts +12 -0
  193. package/src/plugins/builtin/analytics/index.tsx +3 -3
  194. package/src/plugins/builtin/analytics/risk-client.ts +14 -3
  195. package/src/plugins/builtin/analytics/risk-pane.tsx +3 -3
  196. package/src/plugins/builtin/attention/pane.tsx +1 -1
  197. package/src/plugins/builtin/attention/trending.tsx +1 -1
  198. package/src/plugins/builtin/awards/detail.tsx +4 -1
  199. package/src/plugins/builtin/awards/headless.ts +7 -3
  200. package/src/plugins/builtin/awards/model.ts +11 -0
  201. package/src/plugins/builtin/awards/pane.tsx +12 -5
  202. package/src/plugins/builtin/backtest/client.ts +7 -2
  203. package/src/plugins/builtin/backtest/headless.ts +2 -1
  204. package/src/plugins/builtin/backtest/pane.tsx +4 -2
  205. package/src/plugins/builtin/bond-calculator/pane.tsx +1 -1
  206. package/src/plugins/builtin/broker-manager/sign-in-end.ts +1 -1
  207. package/src/plugins/builtin/broker-trading/orders.tsx +2 -2
  208. package/src/plugins/builtin/buildout/company/pane.tsx +1 -1
  209. package/src/plugins/builtin/buildout/model/index.ts +2 -2
  210. package/src/plugins/builtin/catalysts/headless.ts +9 -6
  211. package/src/plugins/builtin/catalysts/model.ts +72 -10
  212. package/src/plugins/builtin/catalysts/pane.tsx +10 -7
  213. package/src/plugins/builtin/cds/pane.tsx +5 -3
  214. package/src/plugins/builtin/central-bank-rates/pane.tsx +3 -2
  215. package/src/plugins/builtin/chart-composer/catalog-series.ts +59 -0
  216. package/src/plugins/builtin/chart-composer/headless-schema.ts +2 -1
  217. package/src/plugins/builtin/chart-composer/headless.ts +104 -23
  218. package/src/plugins/builtin/chart-composer/index.tsx +6 -3
  219. package/src/plugins/builtin/chart-composer/legend-names.ts +19 -0
  220. package/src/plugins/builtin/chart-composer/pane.tsx +37 -10
  221. package/src/plugins/builtin/chart-composer/presets.ts +63 -6
  222. package/src/plugins/builtin/chart-composer/roll-events.ts +38 -0
  223. package/src/plugins/builtin/chart-composer/series-catalog.ts +12 -5
  224. package/src/plugins/builtin/chart-composer/series-expression.ts +8 -4
  225. package/src/plugins/builtin/chart-composer/series-listings.ts +33 -9
  226. package/src/plugins/builtin/chart-composer/use-series-catalog.ts +2 -2
  227. package/src/plugins/builtin/clinical-trials/client.ts +13 -0
  228. package/src/plugins/builtin/clinical-trials/index.tsx +1 -1
  229. package/src/plugins/builtin/clinical-trials/pane.tsx +77 -27
  230. package/src/plugins/builtin/clinical-trials/search.ts +117 -0
  231. package/src/plugins/builtin/cloud/askg/conversation-store.ts +17 -6
  232. package/src/plugins/builtin/cloud/askg/lock-note.ts +4 -2
  233. package/src/plugins/builtin/cloud/askg/manifest.ts +3 -2
  234. package/src/plugins/builtin/cloud/askg/pane.tsx +2 -2
  235. package/src/plugins/builtin/cloud/askg/sources.ts +3 -3
  236. package/src/plugins/builtin/cloud/one-tap/one-tap-prompt.tsx +7 -3
  237. package/src/plugins/builtin/cloud/team/acm-tab.tsx +1 -1
  238. package/src/plugins/builtin/cloud/team/pane.tsx +17 -10
  239. package/src/plugins/builtin/cloud/team/views.ts +15 -3
  240. package/src/plugins/builtin/cloud/terminal-relay/redact.ts +105 -16
  241. package/src/plugins/builtin/cloud/thesis/board-pane.tsx +17 -2
  242. package/src/plugins/builtin/cloud/thesis/module.tsx +3 -2
  243. package/src/plugins/builtin/cloud/thesis/store.ts +17 -3
  244. package/src/plugins/builtin/commodities-energy/index.tsx +35 -3
  245. package/src/plugins/builtin/commodity-balances/index.tsx +1 -1
  246. package/src/plugins/builtin/company-attention/app-rank.tsx +1 -1
  247. package/src/plugins/builtin/company-attention/building.tsx +1 -1
  248. package/src/plugins/builtin/company-attention/model.ts +2 -1
  249. package/src/plugins/builtin/company-attention/moves.tsx +1 -1
  250. package/src/plugins/builtin/company-attention/pane.tsx +1 -1
  251. package/src/plugins/builtin/company-attention/signals.tsx +1 -1
  252. package/src/plugins/builtin/company-kpis/pane.tsx +1 -1
  253. package/src/plugins/builtin/correlation/headless.ts +7 -5
  254. package/src/plugins/builtin/correlation/history.ts +17 -6
  255. package/src/plugins/builtin/correlation/index.tsx +1 -1
  256. package/src/plugins/builtin/correlation/relationship/history.ts +1 -1
  257. package/src/plugins/builtin/correlation/relationship/pane.tsx +1 -1
  258. package/src/plugins/builtin/cot/headless.ts +10 -3
  259. package/src/plugins/builtin/cot/pane.tsx +2 -2
  260. package/src/plugins/builtin/cpi/pane.tsx +1 -1
  261. package/src/plugins/builtin/credit-boards/model.ts +1 -1
  262. package/src/plugins/builtin/credit-documents/pane.tsx +1 -1
  263. package/src/plugins/builtin/crypto-board/defi-view.tsx +2 -2
  264. package/src/plugins/builtin/crypto-board/defi.ts +9 -3
  265. package/src/plugins/builtin/crypto-board/headless.ts +19 -10
  266. package/src/plugins/builtin/crypto-board/model.ts +8 -0
  267. package/src/plugins/builtin/crypto-board/pane.tsx +11 -5
  268. package/src/plugins/builtin/crypto-board/series.ts +17 -3
  269. package/src/plugins/builtin/crypto-board/supply.ts +26 -3
  270. package/src/plugins/builtin/crypto-etf-flows/headless.ts +3 -2
  271. package/src/plugins/builtin/crypto-etf-flows/model.ts +13 -3
  272. package/src/plugins/builtin/crypto-etf-flows/pane.tsx +6 -3
  273. package/src/plugins/builtin/custom-view/pane.tsx +5 -5
  274. package/src/plugins/builtin/debt-maturities/client.ts +5 -0
  275. package/src/plugins/builtin/debt-maturities/headless.ts +3 -1
  276. package/src/plugins/builtin/debt-maturities/model.ts +1 -0
  277. package/src/plugins/builtin/debt-maturities/pane.tsx +1 -1
  278. package/src/plugins/builtin/dividend-yield/pane.tsx +1 -1
  279. package/src/plugins/builtin/doe/model.ts +1 -1
  280. package/src/plugins/builtin/doe/pane.tsx +1 -1
  281. package/src/plugins/builtin/earnings/board.tsx +2 -2
  282. package/src/plugins/builtin/earnings/history.tsx +1 -1
  283. package/src/plugins/builtin/earnings-calls/calendar.tsx +1 -1
  284. package/src/plugins/builtin/earnings-calls/data.ts +2 -1
  285. package/src/plugins/builtin/earnings-calls/headless.ts +15 -0
  286. package/src/plugins/builtin/earnings-calls/model.ts +68 -8
  287. package/src/plugins/builtin/earnings-calls/pane.tsx +29 -8
  288. package/src/plugins/builtin/earnings-calls/transcript-view.tsx +32 -2
  289. package/src/plugins/builtin/earnings-ripple/pane.tsx +1 -1
  290. package/src/plugins/builtin/econ/calendar-model.ts +94 -2
  291. package/src/plugins/builtin/econ/detail-view.tsx +15 -11
  292. package/src/plugins/builtin/econ/index.tsx +25 -9
  293. package/src/plugins/builtin/econ/types.ts +4 -1
  294. package/src/plugins/builtin/equity-screener/headless.ts +23 -7
  295. package/src/plugins/builtin/equity-screener/index.tsx +3 -0
  296. package/src/plugins/builtin/equity-screener/live.ts +39 -12
  297. package/src/plugins/builtin/equity-screener/model.ts +86 -5
  298. package/src/plugins/builtin/equity-screener/pane.tsx +20 -21
  299. package/src/plugins/builtin/equity-screener/results.ts +12 -3
  300. package/src/plugins/builtin/equity-screener/ticker-check.tsx +2 -2
  301. package/src/plugins/builtin/estimate-revisions/pane.tsx +2 -2
  302. package/src/plugins/builtin/executives/pane.tsx +2 -2
  303. package/src/plugins/builtin/exposure/pane.tsx +1 -1
  304. package/src/plugins/builtin/fear-greed/data.ts +3 -1
  305. package/src/plugins/builtin/fear-greed/headless.ts +8 -2
  306. package/src/plugins/builtin/fear-greed/pane.tsx +8 -4
  307. package/src/plugins/builtin/filing-events/pane.tsx +1 -1
  308. package/src/plugins/builtin/futures/index.tsx +5 -4
  309. package/src/plugins/builtin/futures/model.ts +17 -9
  310. package/src/plugins/builtin/futures/returns.ts +2 -0
  311. package/src/plugins/builtin/futures/series.ts +44 -8
  312. package/src/plugins/builtin/futures/table.tsx +3 -3
  313. package/src/plugins/builtin/futures-curve/client.ts +1 -0
  314. package/src/plugins/builtin/futures-curve/headless.ts +14 -12
  315. package/src/plugins/builtin/futures-curve/index.tsx +7 -4
  316. package/src/plugins/builtin/futures-curve/model.ts +93 -7
  317. package/src/plugins/builtin/futures-curve/pane.tsx +18 -7
  318. package/src/plugins/builtin/fx-matrix/amount.ts +2 -1
  319. package/src/plugins/builtin/fx-matrix/index.tsx +9 -0
  320. package/src/plugins/builtin/gpu/changes.tsx +1 -1
  321. package/src/plugins/builtin/gpu/equities.tsx +1 -1
  322. package/src/plugins/builtin/gpu/pane.tsx +2 -2
  323. package/src/plugins/builtin/help/function-card.tsx +4 -2
  324. package/src/plugins/builtin/help/function-index.ts +12 -6
  325. package/src/plugins/builtin/help/index.tsx +1 -1
  326. package/src/plugins/builtin/holders/beneficial-view.tsx +1 -1
  327. package/src/plugins/builtin/holders/pane.tsx +1 -1
  328. package/src/plugins/builtin/insider/base-values.ts +55 -0
  329. package/src/plugins/builtin/insider/headless.ts +307 -83
  330. package/src/plugins/builtin/insider/index.tsx +65 -23
  331. package/src/plugins/builtin/insider/insiders.tsx +26 -16
  332. package/src/plugins/builtin/insider/model.ts +2 -2
  333. package/src/plugins/builtin/insider/signals-cells.tsx +4 -1
  334. package/src/plugins/builtin/insider/signals-model.ts +13 -5
  335. package/src/plugins/builtin/insider/signals.tsx +5 -3
  336. package/src/plugins/builtin/insider/tickers.tsx +466 -0
  337. package/src/plugins/builtin/ipo-calendar/pane.tsx +1 -1
  338. package/src/plugins/builtin/iv-history/client.ts +35 -4
  339. package/src/plugins/builtin/iv-history/headless.ts +10 -4
  340. package/src/plugins/builtin/iv-history/model.ts +85 -16
  341. package/src/plugins/builtin/iv-history/pane.tsx +2 -2
  342. package/src/plugins/builtin/iv-history/screen-pane.tsx +6 -3
  343. package/src/plugins/builtin/jobs/pane.tsx +5 -5
  344. package/src/plugins/builtin/macro-day/pane.tsx +1 -1
  345. package/src/plugins/builtin/macro-day/release-table.ts +5 -5
  346. package/src/plugins/builtin/macro-day/releases.ts +11 -9
  347. package/src/plugins/builtin/market-movers/headless.ts +6 -2
  348. package/src/plugins/builtin/market-movers/screener.ts +18 -4
  349. package/src/plugins/builtin/members/breadth-pane.tsx +3 -3
  350. package/src/plugins/builtin/members/client.ts +24 -2
  351. package/src/plugins/builtin/members/headless.ts +66 -9
  352. package/src/plugins/builtin/members/index.tsx +7 -6
  353. package/src/plugins/builtin/members/model.ts +89 -5
  354. package/src/plugins/builtin/members/pane.tsx +70 -21
  355. package/src/plugins/builtin/mna/distress/pane.tsx +2 -1
  356. package/src/plugins/builtin/mna/pane.tsx +1 -1
  357. package/src/plugins/builtin/money-markets/client.ts +43 -15
  358. package/src/plugins/builtin/money-markets/headless.ts +18 -11
  359. package/src/plugins/builtin/money-markets/index.tsx +7 -6
  360. package/src/plugins/builtin/money-markets/model.ts +20 -5
  361. package/src/plugins/builtin/money-markets/pane.tsx +28 -17
  362. package/src/plugins/builtin/news/wire/news/footer.ts +11 -1
  363. package/src/plugins/builtin/news/wire/news/table.tsx +15 -5
  364. package/src/plugins/builtin/notes/headless.ts +94 -0
  365. package/src/plugins/builtin/notes/index.tsx +3 -1
  366. package/src/plugins/builtin/notes/store.ts +10 -3
  367. package/src/plugins/builtin/options/footer.ts +8 -2
  368. package/src/plugins/builtin/options/open-interest-as-of.ts +12 -3
  369. package/src/plugins/builtin/options/view.tsx +10 -1
  370. package/src/plugins/builtin/options-calculator/pane.tsx +1 -1
  371. package/src/plugins/builtin/options-positioning/client.ts +35 -8
  372. package/src/plugins/builtin/options-positioning/headless.ts +17 -7
  373. package/src/plugins/builtin/options-positioning/index.tsx +10 -0
  374. package/src/plugins/builtin/options-positioning/pane.tsx +16 -7
  375. package/src/plugins/builtin/options-scenario/csp-screen-pane.tsx +1 -1
  376. package/src/plugins/builtin/options-scenario/pane.tsx +1 -1
  377. package/src/plugins/builtin/pe-band/pane.tsx +2 -2
  378. package/src/plugins/builtin/perps/cascade-tabs.tsx +2 -2
  379. package/src/plugins/builtin/perps/client.ts +54 -15
  380. package/src/plugins/builtin/perps/headless.ts +39 -13
  381. package/src/plugins/builtin/perps/index.tsx +2 -1
  382. package/src/plugins/builtin/perps/model.ts +43 -1
  383. package/src/plugins/builtin/perps/pane.tsx +35 -18
  384. package/src/plugins/builtin/portfolio-list/allocation-rows.ts +74 -0
  385. package/src/plugins/builtin/portfolio-list/cell-version.ts +1 -0
  386. package/src/plugins/builtin/portfolio-list/cli/period-report.ts +7 -3
  387. package/src/plugins/builtin/portfolio-list/cli/portfolio-command.ts +33 -3
  388. package/src/plugins/builtin/portfolio-list/cli/render.ts +149 -24
  389. package/src/plugins/builtin/portfolio-list/headless.ts +30 -9
  390. package/src/plugins/builtin/portfolio-list/income.ts +17 -8
  391. package/src/plugins/builtin/portfolio-list/index.tsx +4 -4
  392. package/src/plugins/builtin/portfolio-list/pane/fx-day-moves.ts +52 -0
  393. package/src/plugins/builtin/portfolio-list/pane/index.tsx +76 -9
  394. package/src/plugins/builtin/portfolio-list/pane/target-weights.tsx +178 -0
  395. package/src/plugins/builtin/portfolio-list/period-pnl.ts +44 -5
  396. package/src/plugins/builtin/portfolio-list/settings.ts +12 -6
  397. package/src/plugins/builtin/portfolio-list/summary/index.tsx +9 -4
  398. package/src/plugins/builtin/portfolio-list/summary/totals.ts +21 -2
  399. package/src/plugins/builtin/portfolio-list/table.tsx +33 -25
  400. package/src/plugins/builtin/power/gas.tsx +2 -2
  401. package/src/plugins/builtin/power/prices.tsx +2 -2
  402. package/src/plugins/builtin/primary-dealers/pane.tsx +10 -11
  403. package/src/plugins/builtin/rate-path/model.ts +9 -0
  404. package/src/plugins/builtin/rate-path/pane.tsx +6 -5
  405. package/src/plugins/builtin/realized-vol/fx-proxy.ts +27 -0
  406. package/src/plugins/builtin/realized-vol/headless.ts +8 -6
  407. package/src/plugins/builtin/realized-vol/pane.tsx +13 -7
  408. package/src/plugins/builtin/relative-rotation/pane.tsx +1 -1
  409. package/src/plugins/builtin/research/analyst-headless.ts +5 -1
  410. package/src/plugins/builtin/research/analyst-model.ts +7 -1
  411. package/src/plugins/builtin/research/analyst-pane.tsx +1 -1
  412. package/src/plugins/builtin/research/relative-valuation-basis.ts +44 -4
  413. package/src/plugins/builtin/research/relative-valuation-headless.ts +59 -14
  414. package/src/plugins/builtin/research/relative-valuation-model.ts +65 -26
  415. package/src/plugins/builtin/research/relative-valuation-pane.tsx +42 -17
  416. package/src/plugins/builtin/revenue-breakdown/pane.tsx +1 -1
  417. package/src/plugins/builtin/reverse-dcf/client.ts +34 -4
  418. package/src/plugins/builtin/reverse-dcf/headless.ts +30 -15
  419. package/src/plugins/builtin/reverse-dcf/model.ts +190 -29
  420. package/src/plugins/builtin/reverse-dcf/pane.tsx +35 -13
  421. package/src/plugins/builtin/risk-factors/pane.tsx +2 -2
  422. package/src/plugins/builtin/roadmap/pane.tsx +2 -2
  423. package/src/plugins/builtin/scanner/flow-pane.tsx +4 -4
  424. package/src/plugins/builtin/scanner/headless.ts +15 -1
  425. package/src/plugins/builtin/seasonality/pane.tsx +1 -1
  426. package/src/plugins/builtin/sec/fund-facts-view.tsx +5 -2
  427. package/src/plugins/builtin/sec/fund-facts.ts +41 -1
  428. package/src/plugins/builtin/sec/headless.ts +8 -4
  429. package/src/plugins/builtin/sec/index.tsx +41 -13
  430. package/src/plugins/builtin/shared/ticker-company.ts +111 -0
  431. package/src/plugins/builtin/shared/use-quote-board.ts +37 -2
  432. package/src/plugins/builtin/shared/volatility/live-session.ts +23 -0
  433. package/src/plugins/builtin/shared/volatility-indices.ts +2 -0
  434. package/src/plugins/builtin/short-interest/publications-pane.tsx +1 -1
  435. package/src/plugins/builtin/short-volume/pane.tsx +1 -1
  436. package/src/plugins/builtin/social-mentions/outliers.tsx +3 -3
  437. package/src/plugins/builtin/social-mentions/pane.tsx +2 -2
  438. package/src/plugins/builtin/supply-chain/graph-pane.tsx +1 -1
  439. package/src/plugins/builtin/supply-chain/pane.tsx +1 -1
  440. package/src/plugins/builtin/themes/pane.tsx +4 -4
  441. package/src/plugins/builtin/thirteenf/api.ts +1 -0
  442. package/src/plugins/builtin/thirteenf/format.ts +5 -0
  443. package/src/plugins/builtin/thirteenf/headless.ts +2 -2
  444. package/src/plugins/builtin/thirteenf/model.ts +128 -5
  445. package/src/plugins/builtin/thirteenf/overlap-pane.tsx +1 -1
  446. package/src/plugins/builtin/thirteenf/report-notes.ts +10 -3
  447. package/src/plugins/builtin/thirteenf/signals-pane.tsx +1 -1
  448. package/src/plugins/builtin/thirteenf/table.ts +2 -2
  449. package/src/plugins/builtin/thirteenf/types.ts +12 -0
  450. package/src/plugins/builtin/ticker-detail/data-panes/historical-prices.tsx +27 -14
  451. package/src/plugins/builtin/ticker-detail/data-panes/returns-history.ts +6 -3
  452. package/src/plugins/builtin/ticker-detail/data-panes/returns-model.ts +14 -0
  453. package/src/plugins/builtin/ticker-detail/data-panes/returns-pane.tsx +4 -1
  454. package/src/plugins/builtin/ticker-detail/financials/aggregation.ts +87 -19
  455. package/src/plugins/builtin/ticker-detail/financials/exchange-results.ts +54 -0
  456. package/src/plugins/builtin/ticker-detail/financials/model.ts +114 -9
  457. package/src/plugins/builtin/ticker-detail/financials/ratios.ts +37 -20
  458. package/src/plugins/builtin/ticker-detail/financials/tab.tsx +42 -19
  459. package/src/plugins/builtin/ticker-detail/headless-schema.ts +3 -2
  460. package/src/plugins/builtin/ticker-detail/headless.ts +90 -31
  461. package/src/plugins/builtin/ticker-detail/overview/model.ts +22 -15
  462. package/src/plugins/builtin/ticker-detail/overview-tab.tsx +5 -2
  463. package/src/plugins/builtin/ticker-detail/quote-monitor/card.tsx +12 -7
  464. package/src/plugins/builtin/ticker-detail/quote-monitor/index.tsx +21 -0
  465. package/src/plugins/builtin/trace-bonds/client.ts +107 -10
  466. package/src/plugins/builtin/trace-bonds/detail.tsx +1 -1
  467. package/src/plugins/builtin/trace-bonds/headless.ts +20 -5
  468. package/src/plugins/builtin/trace-bonds/pane.tsx +15 -4
  469. package/src/plugins/builtin/treasury-auctions/hk-view.tsx +1 -1
  470. package/src/plugins/builtin/treasury-auctions/pane.tsx +1 -1
  471. package/src/plugins/builtin/treasury-daily/pane.tsx +2 -2
  472. package/src/plugins/builtin/vol-surface/charts.tsx +30 -5
  473. package/src/plugins/builtin/vol-surface/client.ts +40 -12
  474. package/src/plugins/builtin/vol-surface/events.ts +213 -0
  475. package/src/plugins/builtin/vol-surface/headless.ts +82 -13
  476. package/src/plugins/builtin/vol-surface/index.tsx +5 -1
  477. package/src/plugins/builtin/vol-surface/model.ts +42 -6
  478. package/src/plugins/builtin/vol-surface/pane.tsx +95 -23
  479. package/src/plugins/builtin/volatility/dvol.ts +14 -2
  480. package/src/plugins/builtin/volatility/headless.ts +3 -2
  481. package/src/plugins/builtin/volatility/index.tsx +1 -1
  482. package/src/plugins/builtin/volatility/pane.tsx +1 -1
  483. package/src/plugins/builtin/volatility/series.ts +7 -3
  484. package/src/plugins/builtin/world-venue-map/activity-series.ts +89 -0
  485. package/src/plugins/builtin/world-venue-map/chokepoint-report.ts +123 -0
  486. package/src/plugins/builtin/world-venue-map/evidence.ts +2 -0
  487. package/src/plugins/builtin/world-venue-map/geo-series.ts +35 -1
  488. package/src/plugins/builtin/world-venue-map/headless.ts +58 -9
  489. package/src/plugins/builtin/world-venue-map/index.ts +6 -3
  490. package/src/plugins/builtin/world-venue-map/layered-pane.tsx +6 -1
  491. package/src/plugins/builtin/world-venue-map/pane.tsx +4 -3
  492. package/src/plugins/builtin/yield-curve/index.tsx +12 -10
  493. package/src/plugins/builtin/yield-curve/swaps.tsx +1 -1
  494. package/src/plugins/extracted-plugins.ts +14 -10
  495. package/src/plugins/installer.ts +17 -1
  496. package/src/plugins/marketplace/feed.ts +14 -0
  497. package/src/plugins/marketplace/install-offer.ts +64 -0
  498. package/src/plugins/registry/contributions.ts +46 -8
  499. package/src/plugins/registry/index.ts +5 -0
  500. package/src/portfolio/collection-name.ts +38 -4
  501. package/src/portfolio/column-values.ts +32 -4
  502. package/src/portfolio/period-pnl.ts +4 -2
  503. package/src/react/async-resource.ts +24 -8
  504. package/src/remote/endpoint.ts +38 -12
  505. package/src/remote/secrets.ts +22 -6
  506. package/src/remote/server.ts +20 -4
  507. package/src/renderers/dom/data-table/index.tsx +2 -1
  508. package/src/renderers/dom/data-table/row.tsx +49 -7
  509. package/src/renderers/dom/desktop/controls.tsx +2 -0
  510. package/src/renderers/dom/desktop/query-bar.tsx +57 -7
  511. package/src/renderers/dom/host/surface-3d.tsx +46 -5
  512. package/src/renderers/dom/styles.css +17 -0
  513. package/src/renderers/electrobun/view/backend-rpc.ts +15 -21
  514. package/src/renderers/electrobun/view/cli-pane-shot-entry.tsx +16 -61
  515. package/src/renderers/electrobun/view/cli-pane-shot-socket.ts +134 -0
  516. package/src/renderers/electrobun/view/host-route.ts +119 -0
  517. package/src/renderers/electrobun/view/rpc-timeout.ts +6 -5
  518. package/src/renderers/opentui/toast-host.tsx +6 -3
  519. package/src/renderers/opentui/ui-host.tsx +29 -5
  520. package/src/series/registry.ts +1 -0
  521. package/src/series/standalone-catalog.ts +40 -0
  522. package/src/series/types.ts +10 -0
  523. package/src/series/validate.ts +5 -0
  524. package/src/shares/portable-layout.ts +2 -7
  525. package/src/sources/gloomberb-cloud/dated-chunks.ts +133 -0
  526. package/src/sources/gloomberb-cloud/index.ts +46 -5
  527. package/src/sources/gloomberb-cloud/news.ts +15 -9
  528. package/src/sources/gloomberb-cloud/normalizers.ts +17 -0
  529. package/src/sources/history-coverage.ts +13 -0
  530. package/src/sources/history-result.ts +1 -0
  531. package/src/sources/provider-errors.ts +9 -0
  532. package/src/sources/provider-router/batches.ts +7 -3
  533. package/src/sources/provider-router/financial-routes.ts +3 -1
  534. package/src/sources/provider-router/history.ts +6 -4
  535. package/src/sources/provider-router/index.ts +5 -1
  536. package/src/sources/provider-router/primary.ts +4 -3
  537. package/src/sources/provider-router/retrieved-at.ts +12 -0
  538. package/src/team/store.ts +17 -4
  539. package/src/telemetry/crash-reports.ts +3 -1
  540. package/src/test-support/cli-context.ts +3 -2
  541. package/src/test-support/test-env.ts +7 -0
  542. package/src/theme/themes.ts +16 -9
  543. package/src/theme/tone-contrast.ts +29 -5
  544. package/src/tickers/company-name-listing.ts +31 -3
  545. package/src/tickers/company-name.ts +9 -0
  546. package/src/tickers/index-roots.ts +56 -4
  547. package/src/tickers/listing-name.ts +7 -2
  548. package/src/tickers/listing-venues.ts +17 -2
  549. package/src/tickers/search/home-listing.ts +2 -0
  550. package/src/tickers/search/index.ts +64 -11
  551. package/src/tickers/search/major-listings.json +595 -592
  552. package/src/tickers/search/ranking.ts +19 -1
  553. package/src/tickers/terminal-codes.ts +5 -3
  554. package/src/time-series/bar-aggregation.ts +3 -2
  555. package/src/time-series/base-series.ts +18 -1
  556. package/src/time-series/chart-data.ts +9 -6
  557. package/src/time-series/chart-seed.ts +11 -3
  558. package/src/time-series/currency-conversion.ts +1 -0
  559. package/src/time-series/date-window.ts +8 -0
  560. package/src/time-series/formula-months.ts +57 -0
  561. package/src/time-series/fundamentals/period-points.ts +3 -3
  562. package/src/time-series/fundamentals/source-statements.ts +5 -4
  563. package/src/time-series/leverage.ts +12 -4
  564. package/src/time-series/live-bars.ts +12 -7
  565. package/src/time-series/live-quotes.ts +6 -2
  566. package/src/time-series/market.ts +10 -3
  567. package/src/time-series/price-comparison.ts +106 -0
  568. package/src/time-series/range.ts +10 -0
  569. package/src/time-series/resolve-context.ts +7 -2
  570. package/src/time-series/resolve.ts +61 -5
  571. package/src/time-series/series-name.ts +2 -2
  572. package/src/time-series/series-presentation.ts +91 -2
  573. package/src/time-series/session-bar.ts +13 -7
  574. package/src/time-series/spec.ts +21 -2
  575. package/src/time-series/studies/formula.ts +262 -36
  576. package/src/time-series/studies/leverage.ts +9 -3
  577. package/src/time-series/studies/resolve.ts +7 -2
  578. package/src/time-series/types.ts +34 -0
  579. package/src/time-series/use-chart-resolution.ts +18 -1
  580. package/src/types/data-provider.ts +7 -0
  581. package/src/types/financials.ts +103 -1
  582. package/src/types/headless.ts +64 -3
  583. package/src/types/instrument.ts +6 -0
  584. package/src/types/plugin-context.ts +9 -0
  585. package/src/types/plugin-pane-templates.ts +6 -0
  586. package/src/types/plugin-panes.ts +7 -0
  587. package/src/types/price-history.ts +6 -0
  588. package/src/ui/host.tsx +3 -1
  589. package/src/ui/index.tsx +7 -2
  590. package/src/utils/cli-output.ts +21 -1
  591. package/src/utils/currency-units.ts +14 -0
  592. package/src/utils/datetime-format.ts +11 -0
  593. package/src/utils/exchange-announcements.ts +26 -3
  594. package/src/utils/exchange-notation.generated.ts +3 -4
  595. package/src/utils/exchange-results.ts +144 -0
  596. package/src/utils/exchanges.ts +10 -0
  597. package/src/utils/financial-statements.ts +212 -22
  598. package/src/utils/fire-and-forget.ts +1 -1
  599. package/src/utils/fiscal-period.ts +41 -3
  600. package/src/utils/format.ts +10 -6
  601. package/src/utils/fundamentals.ts +179 -12
  602. package/src/utils/futures-generic.ts +26 -0
  603. package/src/utils/lease-liabilities.ts +15 -5
  604. package/src/utils/lookup-token.ts +22 -0
  605. package/src/utils/max-drawdown.ts +25 -4
  606. package/src/utils/price-history-integrity.ts +56 -8
  607. package/src/utils/price-history.ts +6 -2
  608. package/src/utils/price-window.ts +38 -2
  609. package/src/utils/replace-file.ts +47 -0
  610. package/src/utils/rpc-timeout-error.ts +16 -2
  611. package/src/utils/untrusted-text.ts +14 -0
@@ -24,19 +24,19 @@ import { sinceLastSeenTint, type SinceLastSeenRecap } from "./since-last-seen";
24
24
  import { portfolioPnlLabel } from "../../../portfolio/position-metrics";
25
25
  import { PORTFOLIO_ROW_MENU_KEYS } from "./row-actions";
26
26
  import { isFuturesTicker } from "../../../portfolio/futures-positions";
27
- import { resolveCurrencyUnit } from "../../../utils/currency-units";
28
27
 
29
28
  export type { QuoteFlashDirection };
30
29
 
30
+ /** Columns whose amounts read in the book's currency, whatever the listing's: market cap, cost, value, trade value, day and P&L. */
31
+ const BOOK_CURRENCY_COLUMN_IDS: ReadonlySet<string> = new Set(["market_cap", "cost_basis", "mkt_value", "trade_value", "day_pnl", "pnl"]);
32
+
31
33
  /**
32
- * The market cap column, whose caps read in the book's currency, under a
33
- * header that names it when a row's price is in another (`Mkt Cap TRY` beside
34
- * BRK.B's dollars), wide enough for it; as it was when every price is in that
35
- * currency, pence in pounds included.
34
+ * A column whose amounts read in the book's currency, under a header that
35
+ * names it as the CLI's do (`MKT VAL (CAD)`, `P&L (CAD)`, `MCAP (TRY)`),
36
+ * whatever currency the rows' prices are in, wide enough for it.
36
37
  */
37
- export function marketCapColumn(column: ColumnConfig, currency: string, listed: ReadonlyArray<string | null | undefined>): ColumnConfig {
38
- if (!listed.some((code) => !!code && resolveCurrencyUnit(code).currency !== currency)) return column;
39
- const label = `${column.label} ${currency}`;
38
+ export function bookCurrencyColumn(column: ColumnConfig, currency: string): ColumnConfig {
39
+ const label = `${column.label} (${currency})`;
40
40
  return { ...column, label, width: Math.max(column.width, displayWidth(label)) };
41
41
  }
42
42
 
@@ -200,6 +200,7 @@ export function PortfolioTickerTable({
200
200
  width,
201
201
  answeredSnapshots,
202
202
  exportName,
203
+ allocationRows,
203
204
  }: {
204
205
  columns: ColumnConfig[];
205
206
  focused?: boolean;
@@ -234,6 +235,8 @@ export function PortfolioTickerTable({
234
235
  answeredSnapshots?: ReadonlySet<string>;
235
236
  /** The list's name, which names its exported file. */
236
237
  exportName?: string;
238
+ /** The book's CASH and TOTAL rows under its holdings (`allocationSummaryRows`). */
239
+ allocationRows?: readonly TickerTableSummaryRow[];
237
240
  }) {
238
241
  const cellCacheRef = useRef(createRowValueCache<string, ReturnType<typeof getColumnValue> & TickerTableCell>(5000));
239
242
  const openPerpetualRef = useRef(onOpenPerpetual);
@@ -286,24 +289,19 @@ export function PortfolioTickerTable({
286
289
  )), [columnContext.homeMarket, sortedTickers]);
287
290
  // A book that holds a short weighs its positions against gross exposure, and the header says so.
288
291
  const grossWeights = columnContext.portfolioWeightBasis === "gross";
289
- // Market caps read in the book's currency: beside a price in another, the header names it (Mkt Cap TRY by a USD price).
292
+ // Market caps, values and P&L read in the book's currency, which their headers name (MKT VAL (CAD)), as the CLI's do.
290
293
  const capCurrency = columnContext.baseCurrency;
291
- // One code, the first other currency or none, so a quote's tick does not rebuild the columns.
292
- const otherListedCurrency = useMemo(() => columns.some((column) => column.id === "market_cap")
293
- ? sortedTickers.map((ticker) => tableFinancialsMap.get(ticker.metadata.ticker)?.quote?.currency ?? ticker.metadata.currency)
294
- .find((code) => !!code && resolveCurrencyUnit(code).currency !== capCurrency) ?? null
295
- : null, [capCurrency, columns, sortedTickers, tableFinancialsMap]);
296
294
  const sizedColumns = useMemo(() => columns.map((column) => column.id === "shares" && hasNonShareQuantity
297
295
  ? { ...column, label: "QTY", ...(sharesWidth > column.width ? { width: sharesWidth } : {}) }
298
- : column.id === "market_cap" ? marketCapColumn(column, capCurrency, [otherListedCurrency])
299
296
  : column.id === "weight" && grossWeights ? { ...column, label: GROSS_WEIGHT_LABEL }
300
297
  : column.id === "ticker" && tickerWidth > column.width ? { ...column, width: tickerWidth }
301
298
  : column.id === "pnl_pct" && period ? { ...column, label: CONTRIBUTION_LABEL }
302
299
  : pnlLabel !== "P&L" && (column.id === "pnl" || column.id === "pnl_pct") ? {
303
300
  ...column,
304
301
  label: column.id === "pnl_pct" ? pnlLabel.replace("P&L", "%") : pnlLabel,
305
- } : column).map((column) => hasFrontReference && column.id === noteColumnId ? { ...column, flexGrow: 1 } : column),
306
- [capCurrency, columns, grossWeights, hasFrontReference, hasNonShareQuantity, noteColumnId, otherListedCurrency, period, pnlLabel, sharesWidth, tickerWidth]);
302
+ } : column).map((column) => BOOK_CURRENCY_COLUMN_IDS.has(column.id) ? bookCurrencyColumn(column, capCurrency) : column)
303
+ .map((column) => hasFrontReference && column.id === noteColumnId ? { ...column, flexGrow: 1 } : column),
304
+ [capCurrency, columns, grossWeights, hasFrontReference, hasNonShareQuantity, noteColumnId, period, pnlLabel, sharesWidth, tickerWidth]);
307
305
  // Read again as the rows' data moves, from the cells the rows show; the columns change only when what is hidden does.
308
306
  // The company columns hidden last time, per list, stay hidden while a row added since settles.
309
307
  const hiddenCompanyRef = useRef<{ list: string | undefined; ids: ReadonlySet<string> }>({ list: undefined, ids: new Set() });
@@ -325,14 +323,24 @@ export function PortfolioTickerTable({
325
323
  }, [hiddenColumnIds, sizedColumns]);
326
324
  // Over a period, the FX line under the rows, so P&L adds up to the header's total as portfolio show --from prints it.
327
325
  const periodFx = columnContext.periodPnl?.fx ?? null;
328
- const summaryRows = useMemo<TickerTableSummaryRow[] | undefined>(() => periodFx ? [{
329
- id: "period-fx",
330
- cells: {
331
- [displayColumns.some((column) => column.id === "ticker") ? "ticker" : displayColumns[0]?.id ?? "ticker"]: { text: `FX (${periodFx.currencies})` },
332
- pnl: periodPnlFigure(periodFx.pnl, "pnl"),
333
- pnl_pct: periodPnlFigure(periodFx.contribution, "contribution"),
334
- },
335
- }] : undefined, [displayColumns, periodFx]);
326
+ const summaryRows = useMemo<TickerTableSummaryRow[] | undefined>(() => {
327
+ // A row's label goes in TICKER, or the first column when the pane shows none.
328
+ const labelColumn = displayColumns.some((column) => column.id === "ticker") ? "ticker" : displayColumns[0]?.id ?? "ticker";
329
+ const labelled = (row: TickerTableSummaryRow): TickerTableSummaryRow => labelColumn === "ticker" || !row.cells.ticker ? row
330
+ : { ...row, cells: { ...row.cells, [labelColumn]: row.cells.ticker } };
331
+ const rows = [
332
+ ...(periodFx ? [{
333
+ id: "period-fx",
334
+ cells: {
335
+ ticker: { text: `FX (${periodFx.currencies})` },
336
+ pnl: periodPnlFigure(periodFx.pnl, "pnl"),
337
+ pnl_pct: periodPnlFigure(periodFx.contribution, "contribution"),
338
+ },
339
+ }] : []),
340
+ ...(allocationRows ?? []),
341
+ ].map(labelled);
342
+ return rows.length > 0 ? rows : undefined;
343
+ }, [allocationRows, displayColumns, periodFx]);
336
344
  // The table offers "Sort by…" while it has a sort column. A watchlist starts
337
345
  // unsorted and a third header click turns sorting off, so the unsorted state
338
346
  // needs its own entry until TickerListTableView takes `sortable`.
@@ -20,7 +20,7 @@ import {
20
20
  import { useGasStorageEvidence, type GasStorageSnapshot } from "./evidence";
21
21
 
22
22
  const PANELS = [{ id: "main" }];
23
- const formatAxis = spanAxisFormatter((value, digits) => `${value.toFixed(digits)}%`);
23
+ const formatAxis = spanAxisFormatter((value, digits) => `${value.toFixed(digits)}%`, 2);
24
24
  /** One decimal in a legend, so this year, last year and the average fit a phone's width. */
25
25
  const formatLegend = (value: number) => `${value.toFixed(1)}%`;
26
26
  /** EU first, as the server lists it. */
@@ -116,7 +116,7 @@ export function GasStorageView({ width, height, focused, snapshot }: {
116
116
  const seasonalLoading = !frozen && loaded.loading;
117
117
  useGasStorageEvidence(board, useMemo(() => rows.map((row) => row.id), [rows]), (!frozen && resource.loading) || seasonalLoading);
118
118
  useAutoRefresh(resource.updatedAt, resource.load);
119
- usePaneRefreshKey(() => { void resource.reload(); void loaded.reload(); }, { focused });
119
+ usePaneRefreshKey(() => { resource.reload(); loaded.reload(); }, { focused });
120
120
  const open = rows.find((row) => row.id === openId);
121
121
  const series = useMemo(() => seasonal && seasonal.code === code ? gasSeasonalSeries(seasonal, colors, blendHex) : [], [seasonal, code, colors]);
122
122
  const year = seasonal?.code === code ? seasonal?.year : null;
@@ -24,7 +24,7 @@ const PANELS = [{ id: "main" }];
24
24
  const DAY_MS = 86_400_000;
25
25
  /** The board's chart: the selected market's year, as the 1Y figures read. */
26
26
  const CHART_DAYS = 366;
27
- const formatAxis = spanAxisFormatter((value, digits) => value.toFixed(digits));
27
+ const formatAxis = spanAxisFormatter((value, digits) => value.toFixed(digits), 2);
28
28
 
29
29
  interface PriceBoardRow extends MarketBoardRow { price: PowerPriceRow }
30
30
 
@@ -170,7 +170,7 @@ function PowerPriceBoard({ width, height, focused }: { width: number; height: nu
170
170
  usePowerPricesEvidence(board, carbon, useMemo(() => rows.map((row) => row.id), [rows]), resource.loading || history.loading || carbonResource.loading, snapshot?.carbonError);
171
171
  useAutoRefresh(resource.updatedAt, resource.load);
172
172
  useAutoRefresh(carbonResource.updatedAt, carbonResource.load);
173
- usePaneRefreshKey(() => { void resource.reload(); void history.reload(); void carbonResource.reload(); }, { focused });
173
+ usePaneRefreshKey(() => { resource.reload(); history.reload(); carbonResource.reload(); }, { focused });
174
174
  const notAvailable = !board && resource.error === POWER_PRICES_NOT_AVAILABLE;
175
175
  const open = rows.find((row) => row.id === openId);
176
176
  const charted = carbonCharted ? carbon!.row : selected?.price;
@@ -48,7 +48,7 @@ const RANGE_OPTIONS = DEALER_RANGES.map(({ value, label, hint }) => ({ value, la
48
48
  /** How long the selection rests before its history is read, so holding a key down the board reads one row, not all it passes. */
49
49
  const CHART_SETTLE_MS = 150;
50
50
  /** Ticks in the table's own figures (whole $mn), with decimals only where the plotted range is narrow. */
51
- const formatLevelAxis = spanAxisFormatter((value, digits) => formatNumber(value, digits));
51
+ const formatLevelAxis = spanAxisFormatter((value, digits) => formatNumber(value, digits), 0);
52
52
 
53
53
  function changeColor(value: number | null): string {
54
54
  if (value == null || value === 0) return colors.textMuted;
@@ -132,8 +132,8 @@ export function PrimaryDealersPane({ focused, width, height }: PaneProps) {
132
132
 
133
133
  const { reload: reloadHistory } = historyResource;
134
134
  const refresh = useCallback(() => {
135
- void load();
136
- void reloadHistory();
135
+ load();
136
+ reloadHistory();
137
137
  }, [load, reloadHistory]);
138
138
  const selectTab = useCallback((value: string) => setTab(value === "fails" ? "fails" : "positions"), [setTab]);
139
139
  const selectRange = useCallback((value: DealerRange) => setStoredRange(value), [setStoredRange]);
@@ -175,27 +175,25 @@ export function PrimaryDealersPane({ focused, width, height }: PaneProps) {
175
175
  const renderCell = useCallback((
176
176
  row: DealerRow,
177
177
  column: DealerColumn,
178
- _index: number,
179
- rowState: { selected: boolean },
180
178
  ): DataTableCell => {
181
- const selectedColor = rowState.selected ? colors.selectedText : undefined;
179
+ // The table draws the selected row in the selection's text colour; a change keeps its up or down tone.
182
180
  switch (column.id) {
183
181
  case "position":
184
182
  // A breakdown reads under its total, in plain weight.
185
183
  return {
186
184
  text: dealerRowLabel(row),
187
185
  value: row.label,
188
- color: selectedColor ?? (row.depth === 0 ? colors.textBright : colors.text),
186
+ color: row.depth === 0 ? colors.textBright : colors.text,
189
187
  attributes: row.depth === 0 ? TextAttributes.BOLD : undefined,
190
188
  };
191
189
  case "asOf":
192
- return { text: row.asOf ?? "—", color: selectedColor ?? colors.textMuted };
190
+ return { text: row.asOf ?? "—", color: colors.textMuted };
193
191
  case "latest":
194
- return { text: formatLevel(row.latest), value: row.latest, color: selectedColor ?? colors.text };
192
+ return { text: formatLevel(row.latest), value: row.latest, color: colors.text };
195
193
  case "previous":
196
- return { text: formatLevel(row.previous), value: row.previous, color: selectedColor ?? colors.textDim };
194
+ return { text: formatLevel(row.previous), value: row.previous, color: colors.textDim };
197
195
  case "change":
198
- return { text: formatChange(row.change), value: row.change, color: selectedColor ?? changeColor(row.change) };
196
+ return { text: formatChange(row.change), value: row.change, color: changeColor(row.change) };
199
197
  }
200
198
  }, []);
201
199
 
@@ -261,6 +259,7 @@ export function PrimaryDealersPane({ focused, width, height }: PaneProps) {
261
259
  sortDirection="asc"
262
260
  getItemKey={(row) => row.id}
263
261
  renderCell={renderCell}
262
+ selectedTextOverridesCellColor
264
263
  resetScrollKey={tab}
265
264
  emptyStateTitle={tab === "fails" ? "No fails in this release." : "No positions in this release."}
266
265
  />
@@ -9,6 +9,15 @@ export function percentileText(value: number | null): string {
9
9
  return value == null || !Number.isFinite(value) ? "pctl --" : `${value.toFixed(0)} pctl 1Y`;
10
10
  }
11
11
 
12
+ /**
13
+ * Whether the path's slope has a figure to show. A slope the server could not
14
+ * price (no settlement both legs share) is left out of the header, not shown
15
+ * as "-- pctl --".
16
+ */
17
+ export function slopeShown(slope: RatePathPayload["slope"] | null | undefined): slope is RatePathPayload["slope"] & { valueBps: number } {
18
+ return slope?.valueBps != null && Number.isFinite(slope.valueBps);
19
+ }
20
+
12
21
  /**
13
22
  * Ghosts drawn on the path chart. A path priced a year ago sits in a different
14
23
  * regime and drags the axis away from the current curve, the target band and
@@ -13,7 +13,7 @@ import { useAutoRefresh } from "../../../react/auto-refresh";
13
13
  import { futuresSessionRefreshInterval } from "../shared/futures-session";
14
14
  import { useResearchCloudSession } from "../shared/research-cloud-session";
15
15
  import { getCachedRatePath, loadRatePath } from "./client";
16
- import { meetingLabel, meetingMoves, meetingProbability, moveOddsText, movesPriced, movesText, percentileText, probabilityTargets, rateChangeText, ratePathCurves, rateText } from "./model";
16
+ import { meetingLabel, meetingMoves, meetingProbability, moveOddsText, movesPriced, movesText, percentileText, probabilityTargets, rateChangeText, ratePathCurves, rateText, slopeShown } from "./model";
17
17
 
18
18
  const TABS = [{ value: "path", label: "Path" }, { value: "probabilities", label: "Probabilities" }, { value: "contracts", label: "Contracts" }, { value: "projections", label: "Projections" }];
19
19
  // What is priced by and at each meeting leads, as on a rate probability monitor; the implied level follows.
@@ -134,10 +134,11 @@ export function RatePathPane({ width, height, focused }: PaneProps) {
134
134
  detail: [percentileText(data.current.effr.percentile), ownDate(data.current.effr.asOf)].filter(Boolean).join(" · ") },
135
135
  { id: "target", label: "Target range", value: `${rateText(data.current.targetLower.value)} to ${rateText(data.current.targetUpper.value)}`,
136
136
  detail: [percentileText(data.current.targetUpper.percentile), ownDate(data.current.targetUpper.asOf)].filter(Boolean).join(" · ") },
137
- // How far the path climbs or falls from the next meeting to the last one shown.
138
- ...(tab === "path" && data.slope && next && last && next !== last ? [{ id: "slope", label: `${meetingLabel(next.date)} to ${meetingLabel(last.date)}`,
137
+ // How far the path climbs or falls from the next meeting to the last one shown; nothing while there is no figure.
138
+ ...(tab === "path" && next && last && next !== last && slopeShown(data.slope) ? [{ id: "slope", label: `${meetingLabel(next.date)} to ${meetingLabel(last.date)}`,
139
139
  value: bpText(data.slope.valueBps),
140
- detail: [percentileText(data.slope.percentile), ownDate(data.slope.asOf) && timestamp(data.slope.asOf)].filter(Boolean).join(" · ") }] : []),
140
+ detail: [data.slope.percentile == null ? null : percentileText(data.slope.percentile),
141
+ ownDate(data.slope.asOf) && timestamp(data.slope.asOf)].filter(Boolean).join(" · ") }] : []),
141
142
  ] : [];
142
143
  const bodyHeight = Math.max(1, height - tabRows);
143
144
  // A rank or quote time every meeting shares says nothing per row; the
@@ -163,7 +164,7 @@ export function RatePathPane({ width, height, focused }: PaneProps) {
163
164
  // Delayed contract quotes move all session; the curve follows them once a
164
165
  // minute while Globex trades and on the research cadence otherwise.
165
166
  useAutoRefresh(resource.updatedAt, resource.load, { intervalMs: futuresSessionRefreshInterval() });
166
- usePaneRefreshKey(() => void resource.reload(), { focused });
167
+ usePaneRefreshKey(() => resource.reload(), { focused });
167
168
  usePaneNoticeFooter({ registrationId: "rate-path:notices", focused, notices: [
168
169
  ...(data?.gaps ?? []), ...(selectedMeeting?.reason ? [selectedMeeting.reason] : []),
169
170
  ] });
@@ -7,6 +7,7 @@ import { errorMessage } from "../../../utils/errors";
7
7
  import { loadIvHistory, type ImpliedVolatilityApi, type IvHistoryPayload, type IvMethod } from "../iv-history/client";
8
8
  import { staleness } from "../iv-history/model";
9
9
  import { realizedVolatilityResult } from "../shared/volatility";
10
+ import { optionsClosedNotice, usOptionsReopen } from "../shared/volatility/live-session";
10
11
  import { createSurfaceDependencies, loadVolatilitySurface, type SurfaceLoaderDependencies } from "../vol-surface/client";
11
12
  import type { SurfaceSnapshot } from "../vol-surface/model";
12
13
 
@@ -129,6 +130,32 @@ export function fxProxyIvLessRv(proxy: FxVolProxy | null, history: readonly Pric
129
130
  return { hv20, spread: hv20 == null ? null : proxy.iv30.value - hv20, stale: false, note: null };
130
131
  }
131
132
 
133
+ /**
134
+ * The fund's chain as its cell says it: how many of its expiries price an ATM
135
+ * IV now (`2 of 4`), or outside the options session with none priced, that it
136
+ * is closed and when its surface fills (`reopen`). A count of none beside the
137
+ * last close's IV30 reads as a proxy that is broken, not one that waits for
138
+ * the open. Null when its chains could not be read.
139
+ */
140
+ export function fxProxyChain(proxy: Pick<FxVolProxy, "expiries">, now: number):
141
+ { count: string; reopen: { at: string | null; short: string | null } | null } | null {
142
+ if (!proxy.expiries) return null;
143
+ const count = `${proxy.expiries.usable} of ${proxy.expiries.read}`;
144
+ return { count, reopen: proxy.expiries.usable === 0 ? usOptionsReopen(now) : null };
145
+ }
146
+
147
+ /** The report's line for the chain: `2 of 4 expiries with ATM IV`, or `Options closed until …. The surface fills at the open.` */
148
+ export function fxProxyChainText(proxy: Pick<FxVolProxy, "expiries">, now: number): string {
149
+ const chain = fxProxyChain(proxy, now);
150
+ if (!chain) return "--";
151
+ if (!chain.reopen) return `${chain.count} expiries with ATM IV`;
152
+ const { title, message } = optionsClosedNotice(chain.reopen);
153
+ return `${title} ${message}`;
154
+ }
155
+
156
+ /** "FXY chain", the label the fund's chain reads under. */
157
+ export const fxProxyChainLabel = (proxy: Pick<FxVolProxy, "fund">) => `${proxy.fund} chain`;
158
+
132
159
  /** "FXY IV30", the label the proxy reads under in the pane, the chart legend and the report. */
133
160
  export const fxProxyLabel = (proxy: Pick<FxVolProxy, "fund">) => `${proxy.fund} IV30`;
134
161
  /** What the proxy is, said once: "FXY options, a thin ETF proxy". */
@@ -8,15 +8,18 @@ import { ESTIMATOR_OPTIONS, selectedWindows } from "./settings";
8
8
  import { DAILY_CLOSES } from "../shared/report-freshness";
9
9
  import { listingAbroadVenue } from "../../../utils/sec";
10
10
  import { fxVolatilityPair } from "../../../market-data/options-alternatives";
11
- import { fxProxyIvLessRv, fxProxyLabel, fxProxyNote, loadFxVolProxy, type FxProxyReading, type FxVolProxy } from "./fx-proxy";
11
+ import {
12
+ fxProxyChainLabel, fxProxyChainText, fxProxyIvLessRv, fxProxyLabel, fxProxyNote, loadFxVolProxy, type FxProxyReading, type FxVolProxy,
13
+ } from "./fx-proxy";
12
14
  import type { HeadlessBundleSection } from "../../../types/headless";
13
15
 
14
16
  const percent = (value: number | null | undefined) => value == null ? "--" : `${(value * 100).toFixed(2)}%`;
15
17
 
16
18
  /**
17
19
  * An FX pair's IV section: the fund whose options stand in, its IV30 and the
18
- * close it is from, how many of its expiries price, and IV30 less the pair's
19
- * HV20 on that close. There is no ATM IV of the pair's own to show.
20
+ * close it is from, how many of its expiries price (or, outside the options
21
+ * session with none, when its surface fills), and IV30 less the pair's HV20
22
+ * on that close. There is no ATM IV of the pair's own to show.
20
23
  */
21
24
  function fxProxySection(proxy: FxVolProxy, reading: FxProxyReading): HeadlessBundleSection {
22
25
  const { hv20, spread, stale } = reading;
@@ -25,8 +28,7 @@ function fxProxySection(proxy: FxVolProxy, reading: FxProxyReading): HeadlessBun
25
28
  { label: fxProxyLabel(proxy), value: proxy.iv30?.value ?? null, formatted: percent(proxy.iv30?.value) },
26
29
  { label: "Close", value: proxy.iv30?.date ?? null,
27
30
  formatted: proxy.iv30 ? `${proxy.iv30.date}${proxy.iv30.method === "quote-mid" ? " (quote mid)" : ""}${stale ? ", stale" : ""}` : "--" },
28
- { label: "Expiries with ATM IV", value: proxy.expiries?.usable ?? null,
29
- formatted: proxy.expiries ? `${proxy.expiries.usable} of ${proxy.expiries.read}` : "--" },
31
+ { label: fxProxyChainLabel(proxy), value: proxy.expiries?.usable ?? null, formatted: fxProxyChainText(proxy, Date.now()) },
30
32
  { label: "Pair HV20", value: hv20, formatted: percent(hv20) },
31
33
  { label: "IV30 - HV20", value: spread, formatted: spread == null ? "--" : `${spread >= 0 ? "+" : ""}${(spread * 100).toFixed(2)} pts` },
32
34
  ] };
@@ -34,7 +36,7 @@ function fxProxySection(proxy: FxVolProxy, reading: FxProxyReading): HeadlessBun
34
36
 
35
37
  export function realizedVolHeadless(initialView: "graph" | "cone"): HeadlessPaneDefinition<"bundle"> {
36
38
  return {
37
- shape: "bundle", argument: { kind: "ticker", description: "Underlying ticker" },
39
+ shape: "bundle", argument: { kind: "ticker", description: "Underlying ticker" }, currencyPairs: true,
38
40
  freshness: { ...DAILY_CLOSES, observedKey: "date", oldest: null },
39
41
  describe: (args) => `${initialView === "graph" ? "HVG" : "HVT"} ${args.symbols[0] ?? ""}`,
40
42
  discovery: { screenshotReadiness: "live-dom", limitations: ["IV is a dated current observation; HIVG has the stored IV history."] },
@@ -25,7 +25,7 @@ import type { RealizedVolEvidenceStatus } from "./evidence";
25
25
  import { DEFAULT_WINDOWS, ESTIMATOR_OPTIONS, selectedWindows } from "./settings";
26
26
  import { priceSeriesUnit } from "../../../market-data/market/index-level";
27
27
  import { fxVolatilityPair } from "../../../market-data/options-alternatives";
28
- import { fxProxyIvLessRv, fxProxyLabel, fxProxyNote, loadFxVolProxy } from "./fx-proxy";
28
+ import { fxProxyChain, fxProxyChainLabel, fxProxyIvLessRv, fxProxyLabel, fxProxyNote, loadFxVolProxy } from "./fx-proxy";
29
29
 
30
30
  /** In session, while visible, the current ATM IV reference re-reads its expiry this often. */
31
31
  const ATM_IV_REFRESH_MS = 60_000;
@@ -152,8 +152,8 @@ export function RealizedVolPane({ width, height, focused }: PaneProps) {
152
152
  // The footer hints bind v, i and s in every view and state; only the reload
153
153
  // is the pane's own key.
154
154
  usePaneRefreshKey(() => {
155
- void history.reload();
156
- if (showIv) void (fxPair ? proxy.reload() : iv.reload());
155
+ history.reload();
156
+ if (showIv) (fxPair ? proxy : iv).reload();
157
157
  }, { focused });
158
158
  usePaneFooter("realized-vol", () => ({ info: [
159
159
  ...(history.loading ? [{ id: "loading", parts: [{ text: "loading history", tone: "muted" as const }] }] : []),
@@ -197,16 +197,22 @@ export function RealizedVolPane({ width, height, focused }: PaneProps) {
197
197
  };
198
198
  const { strip: tabStrip, rows: tabRows } = usePaneTabs({ tabs: TABS, activeValue: view, onSelect: setView, focused, dense: true });
199
199
  const reference = showIv ? iv.data?.reference ?? null : null;
200
+ // Outside the options session with none of the fund's expiries priced, its chain says when the surface fills.
201
+ const proxyChain = proxyData ? fxProxyChain(proxyData, Date.now()) : null;
200
202
  // The cone has no IV line of its own, so the dated ATM IV it is read against sits above it; for an FX pair,
201
- // the proxy fund's IV30 with its close, how many of the fund's expiries price at the money, and IV30 less the pair's HV20.
203
+ // the proxy fund's IV30 at its close (as OVDV dates it), how many of the fund's expiries price at the money,
204
+ // and IV30 less the pair's HV20.
202
205
  const coneStats: StatItem[] = view !== "cone" || !model ? []
203
206
  : reference ? [{ id: "atm-iv", label: "ATM IV", value: percent(reference.value), detail: `${Math.round(reference.daysToExpiry)}d` }]
204
207
  : proxyData ? [
205
208
  // A stale IV30 is marked here and said in the footer ("FXB has no IV30 since 2026-05-18").
206
- { id: "proxy-iv", label: fxProxyLabel(proxyData), value: percent(proxyData.iv30?.value), detail: proxyData.iv30?.date,
207
- tone: proxySpread.stale ? "warning" : undefined },
209
+ { id: "proxy-iv", label: fxProxyLabel(proxyData), value: percent(proxyData.iv30?.value),
210
+ detail: proxyData.iv30 ? `${proxyData.iv30.date.slice(5)} close` : undefined, tone: proxySpread.stale ? "warning" : undefined },
208
211
  { id: "proxy-spread", label: "IV30 - HV20", value: proxySpread.spread == null ? "--" : points(proxySpread.spread), detail: "pts" },
209
- { id: "proxy-expiries", label: "Expiries with ATM IV", value: proxyData.expiries ? `${proxyData.expiries.usable} of ${proxyData.expiries.read}` : "--" },
212
+ { id: "proxy-chain", label: fxProxyChainLabel(proxyData), ...(!proxyChain ? { value: "--" }
213
+ : proxyChain.reopen ? { value: "closed", detail: proxyChain.reopen.short ? `fills at the open, ${proxyChain.reopen.short}` : "fills at the open",
214
+ detailVariants: ["fills at the open"] }
215
+ : { value: proxyChain.count, detail: "expiries with ATM IV", detailVariants: ["with ATM IV"] }) },
210
216
  ] : [];
211
217
  const contentHeight = Math.max(4, height - 1 - tabRows - statGridRows(coneStats, width));
212
218
  // The table's selected window is the chart's cursor, so its legend reads that row's figures.
@@ -276,7 +276,7 @@ function RotationView({
276
276
  const selectedRowId = rows.find((row) => row.id === selectedId)?.id ?? rows[0]?.id ?? null;
277
277
  usePaneTitle(`RRG vs ${benchmark.symbol}`);
278
278
  useAutoRefresh(resource.updatedAt, resource.load);
279
- usePaneRefreshKey(() => void resource.reload(), { focused });
279
+ usePaneRefreshKey(() => resource.reload(), { focused });
280
280
  usePaneNoticeFooter({
281
281
  registrationId: "relative-rotation:notices",
282
282
  focused,
@@ -209,7 +209,11 @@ export function createAnalystResearchHeadless(
209
209
  return {
210
210
  sections,
211
211
  errors: data.stale ? ["Analyst research is stale"] : undefined,
212
- ...(data.stale ? { freshness: { status: "stale" as const } } : {}),
212
+ // When Gloom Cloud read the targets and the mix, which carry no date of their own.
213
+ ...(data.stale || data.fetchedAt ? { freshness: {
214
+ ...(data.stale ? { status: "stale" as const } : {}),
215
+ ...(data.fetchedAt ? { retrievedAt: data.fetchedAt } : {}),
216
+ } } : {}),
213
217
  metadata: {
214
218
  symbol: data.symbol || symbol,
215
219
  name: data.name ?? null,
@@ -168,11 +168,17 @@ export function ratingSplit(data: AnalystResearchData | null) {
168
168
  return { ...split, period: rec.period && !isCurrentMonthPeriod(rec.period) ? compactPeriod(rec.period) : null };
169
169
  }
170
170
 
171
+ /**
172
+ * The latest mix with each rating named, as the pane's Buy/Hold/Sell split
173
+ * names them: "4 Strong Buy · 9 Buy · 9 Hold · 4 Sell", strong sells in Sell.
174
+ * A missing count reads "-", so a partial mix never reads as a whole one.
175
+ */
171
176
  export function formatRecommendationMix(data: AnalystResearchData | null): string {
172
177
  const rec = recommendationMix(data);
173
178
  if (!rec) return "-";
174
179
  const sells = rec.sell != null && rec.strongSell != null ? rec.sell + rec.strongSell : null;
175
- return `SB ${rec.strongBuy ?? "-"} B ${rec.buy ?? "-"} H ${rec.hold ?? "-"} S ${sells ?? "-"}`;
180
+ return [[rec.strongBuy, "Strong Buy"], [rec.buy, "Buy"], [rec.hold, "Hold"], [sells, "Sell"]]
181
+ .map(([count, label]) => `${count ?? "-"} ${label}`).join(" · ");
176
182
  }
177
183
 
178
184
  export function formatRatingLabel(value: number | undefined): string {
@@ -100,7 +100,7 @@ function AnalystHeader({ data, history, series, currency, width, height, tableRo
100
100
  const upside = targetUpside(target, analystReferencePrice(data, financials?.quote).price);
101
101
  const formatValue = useCallback(() => "", []);
102
102
  const formatAxisValue = useMemo(
103
- () => spanAxisFormatter((value, digits) => formatPriceTarget(Number(value.toFixed(digits)), currency)),
103
+ () => spanAxisFormatter((value, digits) => formatPriceTarget(Number(value.toFixed(digits)), currency), 2),
104
104
  [currency],
105
105
  );
106
106
  // The terminal grid gives a label half its cell, so two columns under 44
@@ -28,6 +28,11 @@ interface BasisRow {
28
28
  fundamentalsThrough?: string | null;
29
29
  revenueGrowth?: number | null;
30
30
  revenueGrowthQuarter?: string | null;
31
+ /** A half-year reporter's halves the growth compares: "H1 2026 vs H1 2025". */
32
+ revenueGrowthHalf?: string | null;
33
+ fcfYield?: number | null;
34
+ /** The quarter end the filed quarters' free cash flow runs through, where the yield is theirs and not the served TTM. */
35
+ fcfYieldThrough?: string | null;
31
36
  }
32
37
 
33
38
  /** `fundamentals through 2026-06-30`, the newest statement period of each peer's trailing figures; null when none is dated. */
@@ -42,17 +47,52 @@ export function fundamentalsThroughText(rows: readonly BasisRow[]): string | nul
42
47
  * is read: `, Q REV% for that quarter` when it is the one the fundamentals run
43
48
  * through for every peer, else on its own (`Q REV%: quarter to 2026-03-31`).
44
49
  * P/E, EV/S, FCF yield and the operating margin are trailing twelve months
45
- * through that date; the forward P/E says forward in its own header.
50
+ * through that date; the forward P/E says forward in its own header. An FCF
51
+ * yield summed from the filed quarters, where none was served, says so by the
52
+ * column's header (filedFreeCashFlowText).
46
53
  */
47
- export function fundamentalsBasisParts(rows: readonly BasisRow[], revenueGrowthHeader: string): string[] {
54
+ export function fundamentalsBasisParts(rows: readonly BasisRow[], revenueGrowthHeader: string, fcfYieldHeader = "FCF Yield"): string[] {
48
55
  const through = fundamentalsThroughText(rows);
49
56
  const growing = rows.filter((row) => row.revenueGrowth != null);
50
57
  const quarter = peerDatesText(growing.map(({ symbol, revenueGrowthQuarter }) => ({ symbol, date: revenueGrowthQuarter })));
58
+ const filed = filedFreeCashFlowText(rows, fcfYieldHeader);
59
+ // A half-year reporter's growth is its latest half's, named by its halves: "9992:HKEX H1 2026 vs H1 2025".
60
+ const halves = growing.filter((row) => row.revenueGrowthHalf).map((row) => `${row.symbol} ${row.revenueGrowthHalf}`);
61
+ const period = halves.length ? "period" : "quarter";
62
+ const named = halves.length ? ` (${halves.join(", ")})` : "";
51
63
  if (through && quarter && growing.every((row) => row.revenueGrowthQuarter === row.fundamentalsThrough)) {
52
- return [`${through}, ${revenueGrowthHeader} for that quarter`];
64
+ return [`${through}, ${revenueGrowthHeader} for that ${period}${named}`, ...(filed ? [filed] : [])];
53
65
  }
54
66
  return [
55
67
  ...(through ? [through] : []),
56
- ...(quarter ? [`${revenueGrowthHeader}: quarter to ${quarter}`] : []),
68
+ ...(quarter ? [`${revenueGrowthHeader}: ${period} to ${quarter}${named}`] : []),
69
+ ...(filed ? [filed] : []),
57
70
  ];
58
71
  }
72
+
73
+ /** "H1": what a growth cell adds for a half-year reporter, whose figure is a half's, not a quarter's. */
74
+ export function revenueGrowthHalfTag(half: string | null | undefined): string | null {
75
+ return half ? half.split(" ")[0] ?? null : null;
76
+ }
77
+
78
+ /**
79
+ * The growth column's header: the quarter's (`quarterHeader`) unless a row
80
+ * is a half-year reporter's, when the column holds both kinds of period and
81
+ * is named for neither (`periodHeader`).
82
+ */
83
+ export function revenueGrowthHeader(rows: readonly BasisRow[], quarterHeader: string, periodHeader: string): string {
84
+ return rows.some((row) => row.revenueGrowth != null && row.revenueGrowthHalf) ? periodHeader : quarterHeader;
85
+ }
86
+
87
+ /**
88
+ * `FCF Yield: filed quarters to 2026-06-30` when every yield shown sums the
89
+ * filed quarters, else `FCF Yield of 8058:JPX, 8001:JPX: filed quarters to
90
+ * 2026-06-30` naming those that do; null when none does.
91
+ */
92
+ function filedFreeCashFlowText(rows: readonly BasisRow[], header: string): string | null {
93
+ const filed = rows.filter((row) => row.fcfYield != null && row.fcfYieldThrough);
94
+ const dates = peerDatesText(filed.map(({ symbol, fcfYieldThrough }) => ({ symbol, date: fcfYieldThrough })));
95
+ if (!dates) return null;
96
+ const every = filed.length === rows.filter((row) => row.fcfYield != null).length;
97
+ return `${header}${every ? "" : ` of ${filed.map((row) => row.symbol).join(", ")}`}: filed quarters to ${dates}`;
98
+ }