gloomberb 0.20.2 → 0.20.4

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (471) hide show
  1. package/README.md +1 -1
  2. package/README.zh-CN.md +1 -1
  3. package/package.json +2 -1
  4. package/src/account/auth-dialog.tsx +17 -0
  5. package/src/account/auth-form.tsx +13 -8
  6. package/src/account/upgrade-dialog.tsx +1 -1
  7. package/src/api-client/central-bank-rates.ts +5 -0
  8. package/src/api-client/data.ts +23 -4
  9. package/src/api-client/debt-maturities.ts +45 -2
  10. package/src/api-client/earnings.ts +4 -2
  11. package/src/api-client/errors.ts +21 -11
  12. package/src/api-client/fx-interventions.ts +64 -0
  13. package/src/api-client/index.ts +2 -0
  14. package/src/api-client/paths.ts +9 -1
  15. package/src/api-client/release-summaries.ts +21 -0
  16. package/src/api-client/social-mentions.ts +47 -0
  17. package/src/api-client/types/econ.ts +4 -0
  18. package/src/app/keybindings/actions.ts +2 -2
  19. package/src/app/pane-runtime/ticker-open-runtime.ts +245 -66
  20. package/src/app.tsx +11 -1
  21. package/src/cli/command-options.ts +2 -1
  22. package/src/cli/commands/market.ts +188 -30
  23. package/src/cli/commands/news-search.ts +1 -3
  24. package/src/cli/commands/options-chain.ts +23 -6
  25. package/src/cli/commands/overview.ts +13 -5
  26. package/src/cli/commands/plugins.ts +76 -23
  27. package/src/cli/commands/search.ts +25 -6
  28. package/src/cli/commands/system.ts +19 -3
  29. package/src/cli/commands/ticker.ts +64 -21
  30. package/src/cli/fx-quote-rate.ts +49 -1
  31. package/src/cli/glossary.ts +95 -15
  32. package/src/cli/history-rows.ts +9 -25
  33. package/src/cli/index.ts +14 -46
  34. package/src/cli/known-gaps.ts +3 -3
  35. package/src/cli/listing-arg.ts +78 -18
  36. package/src/cli/name-entries.ts +3 -2
  37. package/src/cli/not-a-ticker.ts +6 -2
  38. package/src/cli/pane-functions/capabilities.ts +12 -1
  39. package/src/cli/pane-functions/function-help.ts +26 -14
  40. package/src/cli/pane-functions/headless.ts +3 -1
  41. package/src/cli/pane-functions/index.ts +32 -4
  42. package/src/cli/pane-functions/market-session.ts +8 -3
  43. package/src/cli/pane-functions/resolver.ts +18 -11
  44. package/src/cli/pane-functions/screenshot-payload.ts +36 -6
  45. package/src/cli/pane-functions/screenshot-render.ts +4 -0
  46. package/src/cli/quote-answer.ts +10 -0
  47. package/src/cli/report-tables.ts +40 -8
  48. package/src/cli/result.ts +21 -9
  49. package/src/cli/spreadsheet-hint.ts +43 -0
  50. package/src/cli/symbol-list.ts +58 -4
  51. package/src/cli/symbol-rows.ts +49 -2
  52. package/src/cli/ticker-resolution.ts +98 -5
  53. package/src/cli/types.ts +2 -0
  54. package/src/cli/unknown-command.ts +88 -0
  55. package/src/components/chart/composite/axis-overlays.tsx +22 -0
  56. package/src/components/chart/composite/composite-chart.tsx +54 -13
  57. package/src/components/chart/composite/event-captions.ts +109 -0
  58. package/src/components/chart/composite/event-guides.ts +74 -0
  59. package/src/components/chart/composite/rasterizer.ts +2 -0
  60. package/src/components/chart/composite/text-renderer.ts +2 -0
  61. package/src/components/chart/composite/types.ts +31 -0
  62. package/src/components/command-bar/assist/model.ts +6 -1
  63. package/src/components/command-bar/commands/direct/index.ts +9 -1
  64. package/src/components/command-bar/commands/registry.ts +18 -0
  65. package/src/components/command-bar/layout-items/focused-pane.ts +5 -5
  66. package/src/components/command-bar/pane-actions.ts +30 -13
  67. package/src/components/command-bar/panel/index.tsx +6 -3
  68. package/src/components/command-bar/panel/prompt-binding.ts +4 -0
  69. package/src/components/command-bar/panel/types.ts +3 -0
  70. package/src/components/command-bar/routes/header-market.ts +108 -0
  71. package/src/components/command-bar/routes/root/command-items.ts +5 -0
  72. package/src/components/command-bar/routes/root/provider-search.ts +192 -33
  73. package/src/components/command-bar/routes/root/results.ts +3 -0
  74. package/src/components/command-bar/routes/root/runtime.ts +28 -5
  75. package/src/components/command-bar/routes/ticker-search/results.ts +104 -6
  76. package/src/components/command-bar/routes/ticker-search/route.ts +3 -2
  77. package/src/components/command-bar/routing/list-state.ts +38 -0
  78. package/src/components/command-bar/selection-hint.ts +28 -0
  79. package/src/components/command-bar/surface/index.tsx +41 -3
  80. package/src/components/command-bar/view-model.ts +15 -0
  81. package/src/components/command-bar/workflow/tickers.ts +3 -2
  82. package/src/components/company-logo.tsx +20 -2
  83. package/src/components/data-table/export.ts +13 -8
  84. package/src/components/feedback-dialog.tsx +2 -1
  85. package/src/components/form-modal/field-row.tsx +2 -1
  86. package/src/components/input-search-bar.tsx +2 -2
  87. package/src/components/layout/detached-pane-shell.tsx +1 -1
  88. package/src/components/layout/double-escape-close.ts +8 -5
  89. package/src/components/layout/floating-pane.tsx +5 -1
  90. package/src/components/layout/header.tsx +75 -44
  91. package/src/components/layout/market-summary.ts +322 -116
  92. package/src/components/layout/pane/footer/index.tsx +44 -19
  93. package/src/components/layout/pane/footer/model.ts +52 -20
  94. package/src/components/layout/pane/header.tsx +3 -2
  95. package/src/components/layout/shell/action-menu-overlay.tsx +10 -5
  96. package/src/components/layout/shell/active-drag.ts +149 -105
  97. package/src/components/layout/shell/chrome.ts +15 -15
  98. package/src/components/layout/shell/drag/drop-zones.ts +162 -0
  99. package/src/components/layout/shell/drag/index.ts +47 -218
  100. package/src/components/layout/shell/drag/live.ts +10 -3
  101. package/src/components/layout/shell/drag/overlays.tsx +182 -5
  102. package/src/components/layout/shell/drag/runtime.ts +29 -6
  103. package/src/components/layout/shell/drag/shared-edges.ts +156 -0
  104. package/src/components/layout/shell/index.tsx +11 -6
  105. package/src/components/layout/shell/menu.ts +11 -2
  106. package/src/components/layout/shell/native/pointer-runtime.ts +25 -0
  107. package/src/components/layout/shell/native/window-state.ts +2 -2
  108. package/src/components/layout/shell/pane/layers.tsx +71 -7
  109. package/src/components/layout/shell/terminal-pointer-runtime.ts +18 -9
  110. package/src/components/layout/shell/window-mode/index.ts +8 -10
  111. package/src/components/layout/status-bar.tsx +8 -7
  112. package/src/components/layout/status-widget-space.ts +8 -0
  113. package/src/components/layout/window-edit/mode.ts +39 -7
  114. package/src/components/layout/window-edit/presentation.ts +1 -1
  115. package/src/components/markdown-editor.tsx +2 -2
  116. package/src/components/onboarding/account-step/form-panel.tsx +0 -3
  117. package/src/components/onboarding/onboarding-keyboard.ts +19 -6
  118. package/src/components/onboarding/onboarding-wizard.tsx +69 -14
  119. package/src/components/onboarding/portfolio-step/broker-fields-panel.tsx +0 -1
  120. package/src/components/onboarding/portfolio-step/positions-panel.tsx +0 -2
  121. package/src/components/price-sparkline/model.ts +26 -10
  122. package/src/components/ticker/list-table-view.tsx +29 -4
  123. package/src/components/ui/button.tsx +15 -2
  124. package/src/components/ui/choice-dialog.tsx +1 -0
  125. package/src/components/ui/column-grid.tsx +18 -9
  126. package/src/components/ui/data-table/index.tsx +5 -4
  127. package/src/components/ui/data-table/opentui/index.tsx +2 -1
  128. package/src/components/ui/data-table/types.ts +18 -0
  129. package/src/components/ui/delayed-mark.tsx +3 -2
  130. package/src/components/ui/field-grid.tsx +0 -2
  131. package/src/components/ui/fields.tsx +7 -4
  132. package/src/components/ui/inline-quick-add.tsx +2 -2
  133. package/src/components/ui/key-hint-words.ts +153 -0
  134. package/src/components/ui/key-hints.tsx +73 -0
  135. package/src/components/ui/list-view.tsx +7 -12
  136. package/src/components/ui/loading.tsx +10 -3
  137. package/src/components/ui/menu.tsx +9 -3
  138. package/src/components/ui/message-composer.tsx +2 -2
  139. package/src/components/ui/quote.ts +14 -1
  140. package/src/components/ui/shortcut-hint.tsx +28 -3
  141. package/src/components/ui/tabs.tsx +7 -0
  142. package/src/components/ui/text-prompt-dialog.tsx +2 -1
  143. package/src/core/state/app/command-bar-launch.ts +3 -0
  144. package/src/data/config/layout.ts +5 -2
  145. package/src/data/config/store/normalize.ts +6 -0
  146. package/src/docs/snapshot.json +149 -74
  147. package/src/i18n/es.ts +33 -9
  148. package/src/i18n/ja.ts +33 -9
  149. package/src/i18n/ko.ts +33 -9
  150. package/src/i18n/zh-cn.ts +33 -9
  151. package/src/i18n/zh-tw.ts +33 -9
  152. package/src/layout/pane-manager/floating-actions.ts +17 -0
  153. package/src/layout/pane-manager/floating-stack.ts +187 -0
  154. package/src/layout/pane-manager/floating.ts +4 -2
  155. package/src/layout/pane-manager/gridlock.ts +16 -1
  156. package/src/layout/pane-manager/index.ts +11 -0
  157. package/src/layout/pane-manager/layout-state.ts +10 -3
  158. package/src/market-data/bars-per-year.ts +27 -9
  159. package/src/market-data/coordinator/quotes.ts +22 -3
  160. package/src/market-data/futures-board.ts +126 -1
  161. package/src/market-data/futures-contract.ts +21 -6
  162. package/src/market-data/fx-interventions.ts +270 -0
  163. package/src/market-data/market/change-basis.ts +2 -2
  164. package/src/market-data/market/dated-previous-close.ts +163 -47
  165. package/src/market-data/market/format.ts +14 -3
  166. package/src/market-data/market/freshness.ts +24 -7
  167. package/src/market-data/market/header-market.ts +154 -0
  168. package/src/market-data/market/index-level.ts +29 -0
  169. package/src/market-data/market/index-session-venues.ts +44 -0
  170. package/src/market-data/market/status.ts +7 -2
  171. package/src/market-data/market/venue-session.ts +72 -0
  172. package/src/market-data/model-dividend-yield.ts +23 -8
  173. package/src/market-data/options-alternatives.ts +39 -4
  174. package/src/market-data/published-apac-sessions.ts +40 -2
  175. package/src/market-data/quotes/export-identity.ts +76 -0
  176. package/src/market-data/quotes/freshness.ts +22 -0
  177. package/src/market-data/quotes/time.ts +42 -1
  178. package/src/market-data/realized-volatility.ts +11 -7
  179. package/src/market-data/tax-equivalent.ts +145 -27
  180. package/src/news/news-model.ts +44 -2
  181. package/src/plugins/builtin/account-management/pane.tsx +2 -2
  182. package/src/plugins/builtin/alerts/alert-engine.ts +12 -6
  183. package/src/plugins/builtin/alerts/alert-log.ts +6 -2
  184. package/src/plugins/builtin/alerts/calendar-events.ts +74 -12
  185. package/src/plugins/builtin/alerts/cli-forms.ts +11 -1
  186. package/src/plugins/builtin/alerts/cli-move.ts +234 -0
  187. package/src/plugins/builtin/alerts/cli.ts +223 -32
  188. package/src/plugins/builtin/alerts/command.ts +33 -6
  189. package/src/plugins/builtin/alerts/event-rows.ts +18 -4
  190. package/src/plugins/builtin/alerts/events-pane.tsx +6 -2
  191. package/src/plugins/builtin/alerts/events.ts +9 -0
  192. package/src/plugins/builtin/alerts/format.ts +39 -15
  193. package/src/plugins/builtin/alerts/headless.ts +30 -18
  194. package/src/plugins/builtin/alerts/history.ts +1 -0
  195. package/src/plugins/builtin/alerts/index.tsx +86 -12
  196. package/src/plugins/builtin/alerts/live.ts +2 -1
  197. package/src/plugins/builtin/alerts/move-checks.ts +161 -0
  198. package/src/plugins/builtin/alerts/move.ts +181 -0
  199. package/src/plugins/builtin/alerts/pane.tsx +50 -22
  200. package/src/plugins/builtin/alerts/price-text.ts +62 -0
  201. package/src/plugins/builtin/alerts/price.ts +17 -0
  202. package/src/plugins/builtin/alerts/quotes.ts +84 -3
  203. package/src/plugins/builtin/alerts/scheduled-check.ts +7 -1
  204. package/src/plugins/builtin/alerts/storage.ts +22 -7
  205. package/src/plugins/builtin/alerts/types.ts +25 -0
  206. package/src/plugins/builtin/analytics/risk-client.ts +60 -39
  207. package/src/plugins/builtin/analytics/risk-episodes.ts +18 -0
  208. package/src/plugins/builtin/analytics/risk-headless.ts +20 -4
  209. package/src/plugins/builtin/analytics/risk-model.ts +68 -1
  210. package/src/plugins/builtin/analytics/risk-pane.tsx +15 -3
  211. package/src/plugins/builtin/backtest/engine.ts +4 -2
  212. package/src/plugins/builtin/backtest/window.ts +3 -1
  213. package/src/plugins/builtin/broker-manager/sign-in-end.ts +1 -1
  214. package/src/plugins/builtin/central-bank-rates/client.ts +4 -0
  215. package/src/plugins/builtin/central-bank-rates/headless.ts +1 -1
  216. package/src/plugins/builtin/central-bank-rates/model.ts +18 -8
  217. package/src/plugins/builtin/central-bank-rates/pane.tsx +6 -3
  218. package/src/plugins/builtin/changelog/index.tsx +292 -101
  219. package/src/plugins/builtin/changelog/versions.ts +293 -0
  220. package/src/plugins/builtin/chart-composer/cli-options.ts +5 -0
  221. package/src/plugins/builtin/chart-composer/headless-schema.ts +17 -1
  222. package/src/plugins/builtin/chart-composer/headless.ts +2 -0
  223. package/src/plugins/builtin/chart-composer/intervention-events.ts +105 -0
  224. package/src/plugins/builtin/chart-composer/pane.tsx +21 -7
  225. package/src/plugins/builtin/chat/message/render-state.ts +2 -5
  226. package/src/plugins/builtin/cloud/askg/attached-pane.tsx +10 -5
  227. package/src/plugins/builtin/cloud/askg/controller.ts +141 -5
  228. package/src/plugins/builtin/cloud/askg/executor.ts +113 -4
  229. package/src/plugins/builtin/cloud/askg/manifest.ts +28 -13
  230. package/src/plugins/builtin/cloud/askg/model.ts +14 -4
  231. package/src/plugins/builtin/cloud/askg/pane.tsx +70 -46
  232. package/src/plugins/builtin/cloud/askg/turn-parts.tsx +70 -0
  233. package/src/plugins/builtin/cloud/terminal-relay/engine.ts +50 -130
  234. package/src/plugins/builtin/cloud/terminal-relay/policy.ts +327 -7
  235. package/src/plugins/builtin/cloud/terminal-relay/prompts.tsx +2 -1
  236. package/src/plugins/builtin/cloud/terminal-relay/redact.ts +47 -6
  237. package/src/plugins/builtin/cloud/upgrade-status-widget.tsx +9 -2
  238. package/src/plugins/builtin/commodities-energy/index.tsx +1 -3
  239. package/src/plugins/builtin/commodities-energy/view-state.ts +3 -0
  240. package/src/plugins/builtin/cot/headless.ts +14 -2
  241. package/src/plugins/builtin/crypto-board/headless.ts +82 -17
  242. package/src/plugins/builtin/crypto-board/index.tsx +24 -2
  243. package/src/plugins/builtin/crypto-board/model.ts +5 -2
  244. package/src/plugins/builtin/crypto-board/pane.tsx +4 -1
  245. package/src/plugins/builtin/debt-maturities/client.ts +111 -6
  246. package/src/plugins/builtin/debt-maturities/headless.ts +84 -1
  247. package/src/plugins/builtin/debt-maturities/model.ts +97 -14
  248. package/src/plugins/builtin/debt-maturities/pane.tsx +165 -15
  249. package/src/plugins/builtin/debt-maturities/series.ts +3 -1
  250. package/src/plugins/builtin/dividend-yield/client.ts +22 -6
  251. package/src/plugins/builtin/dividend-yield/headless.ts +113 -46
  252. package/src/plugins/builtin/dividend-yield/model.ts +5 -2
  253. package/src/plugins/builtin/dividend-yield/pane.tsx +6 -3
  254. package/src/plugins/builtin/dividend-yield/ranking-reads.ts +11 -4
  255. package/src/plugins/builtin/dividend-yield/ranking.ts +113 -18
  256. package/src/plugins/builtin/dividend-yield/types.ts +2 -0
  257. package/src/plugins/builtin/dividend-yield/view.ts +3 -0
  258. package/src/plugins/builtin/earnings/index.tsx +2 -2
  259. package/src/plugins/builtin/econ/calendar-model.ts +21 -3
  260. package/src/plugins/builtin/econ/detail-view.tsx +5 -3
  261. package/src/plugins/builtin/econ/figures.ts +13 -0
  262. package/src/plugins/builtin/econ/fred-catalog.ts +6 -3
  263. package/src/plugins/builtin/econ/index.tsx +5 -3
  264. package/src/plugins/builtin/econ/types.ts +5 -0
  265. package/src/plugins/builtin/equity-screener/footer.ts +45 -0
  266. package/src/plugins/builtin/equity-screener/pane.tsx +4 -18
  267. package/src/plugins/builtin/equity-screener/ticker-check.tsx +2 -1
  268. package/src/plugins/builtin/fixed-income/model.ts +1 -0
  269. package/src/plugins/builtin/futures/index.tsx +25 -4
  270. package/src/plugins/builtin/futures/model.ts +28 -32
  271. package/src/plugins/builtin/futures/series.ts +4 -3
  272. package/src/plugins/builtin/futures/table.tsx +17 -10
  273. package/src/plugins/builtin/futures/use-board-terms.ts +3 -3
  274. package/src/plugins/builtin/futures-curve/model.ts +3 -10
  275. package/src/plugins/builtin/help/function-card.tsx +2 -1
  276. package/src/plugins/builtin/help/function-index.ts +1 -0
  277. package/src/plugins/builtin/help/index.tsx +3 -3
  278. package/src/plugins/builtin/help/keybindings-editor.tsx +18 -4
  279. package/src/plugins/builtin/insider/client.ts +31 -14
  280. package/src/plugins/builtin/insider/signals-model.ts +2 -7
  281. package/src/plugins/builtin/iv-history/headless.ts +1 -2
  282. package/src/plugins/builtin/iv-history/model.ts +33 -23
  283. package/src/plugins/builtin/iv-history/screen-pane.tsx +0 -3
  284. package/src/plugins/builtin/kelly-sizer/headless.ts +64 -16
  285. package/src/plugins/builtin/kelly-sizer/history.ts +37 -28
  286. package/src/plugins/builtin/kelly-sizer/pane.tsx +43 -10
  287. package/src/plugins/builtin/kelly-sizer/sections.tsx +7 -2
  288. package/src/plugins/builtin/kelly-sizer/units.ts +29 -0
  289. package/src/plugins/builtin/layout-manager/index.tsx +8 -8
  290. package/src/plugins/builtin/news/headless.ts +2 -2
  291. package/src/plugins/builtin/news/index.tsx +10 -16
  292. package/src/plugins/builtin/news/overview-headlines.tsx +117 -0
  293. package/src/plugins/builtin/news/ticker-news.ts +35 -0
  294. package/src/plugins/builtin/news/wire/news/detail-view.tsx +8 -6
  295. package/src/plugins/builtin/news/wire/news/row.ts +49 -0
  296. package/src/plugins/builtin/news/wire/news/table.tsx +9 -20
  297. package/src/plugins/builtin/options/analytics.ts +7 -2
  298. package/src/plugins/builtin/options/live-quotes.ts +6 -1
  299. package/src/plugins/builtin/options/table.ts +3 -2
  300. package/src/plugins/builtin/options/view.tsx +11 -9
  301. package/src/plugins/builtin/options-scenario/client.ts +3 -0
  302. package/src/plugins/builtin/options-scenario/headless.ts +1 -1
  303. package/src/plugins/builtin/perps/client.ts +5 -4
  304. package/src/plugins/builtin/perps/headless.ts +134 -124
  305. package/src/plugins/builtin/perps/markets-section.tsx +7 -4
  306. package/src/plugins/builtin/perps/model.ts +8 -4
  307. package/src/plugins/builtin/perps/open-market.ts +4 -4
  308. package/src/plugins/builtin/perps/venue-markets.ts +3 -6
  309. package/src/plugins/builtin/plugin-marketplace/pane.tsx +11 -11
  310. package/src/plugins/builtin/portfolio-list/cell-version.ts +1 -0
  311. package/src/plugins/builtin/portfolio-list/cli/bulk-symbols.ts +34 -10
  312. package/src/plugins/builtin/portfolio-list/cli/period-report.ts +28 -2
  313. package/src/plugins/builtin/portfolio-list/cli/portfolio-command.ts +7 -3
  314. package/src/plugins/builtin/portfolio-list/cli/render.ts +66 -22
  315. package/src/plugins/builtin/portfolio-list/grid.tsx +5 -3
  316. package/src/plugins/builtin/portfolio-list/pane/data.ts +34 -1
  317. package/src/plugins/builtin/portfolio-list/pane/index.tsx +6 -0
  318. package/src/plugins/builtin/portfolio-list/pane/streaming.ts +15 -6
  319. package/src/plugins/builtin/portfolio-list/quick-add/resolution.ts +19 -7
  320. package/src/plugins/builtin/portfolio-list/summary/index.tsx +3 -1
  321. package/src/plugins/builtin/portfolio-list/table.tsx +30 -4
  322. package/src/plugins/builtin/realized-vol/evidence.ts +33 -6
  323. package/src/plugins/builtin/realized-vol/fx-proxy.ts +135 -0
  324. package/src/plugins/builtin/realized-vol/headless.ts +44 -8
  325. package/src/plugins/builtin/realized-vol/model.ts +9 -5
  326. package/src/plugins/builtin/realized-vol/pane.tsx +49 -15
  327. package/src/plugins/builtin/research/event-model.ts +9 -1
  328. package/src/plugins/builtin/research/event-sources.ts +22 -0
  329. package/src/plugins/builtin/research/headless.ts +3 -3
  330. package/src/plugins/builtin/sec/headless.ts +48 -6
  331. package/src/plugins/builtin/sec/index.tsx +6 -4
  332. package/src/plugins/builtin/sec/model.ts +4 -1
  333. package/src/plugins/builtin/shared/cloud-upgrade.ts +27 -3
  334. package/src/plugins/builtin/shared/earnings-calendar.ts +2 -0
  335. package/src/plugins/builtin/shared/market-cap-bands.ts +12 -0
  336. package/src/plugins/builtin/shared/report-freshness.ts +3 -1
  337. package/src/plugins/builtin/shared/use-quote-board.ts +5 -3
  338. package/src/plugins/builtin/shared/volatility/options.ts +63 -2
  339. package/src/plugins/builtin/social-mentions/headless.ts +72 -3
  340. package/src/plugins/builtin/social-mentions/index.tsx +8 -4
  341. package/src/plugins/builtin/social-mentions/lock-note.ts +6 -2
  342. package/src/plugins/builtin/social-mentions/outliers-client.ts +101 -0
  343. package/src/plugins/builtin/social-mentions/outliers-model.ts +162 -0
  344. package/src/plugins/builtin/social-mentions/outliers-names.ts +51 -0
  345. package/src/plugins/builtin/social-mentions/outliers.tsx +276 -0
  346. package/src/plugins/builtin/social-mentions/pane.tsx +32 -3
  347. package/src/plugins/builtin/supply-chain/graph-pane.tsx +2 -2
  348. package/src/plugins/builtin/thirteenf/api.ts +36 -2
  349. package/src/plugins/builtin/thirteenf/data.ts +4 -1
  350. package/src/plugins/builtin/thirteenf/headless.ts +14 -6
  351. package/src/plugins/builtin/thirteenf/model.ts +56 -1
  352. package/src/plugins/builtin/thirteenf/pane.tsx +8 -8
  353. package/src/plugins/builtin/thirteenf/report-notes.ts +11 -0
  354. package/src/plugins/builtin/thirteenf/table.ts +2 -1
  355. package/src/plugins/builtin/thirteenf/types.ts +6 -0
  356. package/src/plugins/builtin/ticker-detail/data-panes/historical-prices.tsx +23 -3
  357. package/src/plugins/builtin/ticker-detail/financials/model.ts +5 -0
  358. package/src/plugins/builtin/ticker-detail/headless-schema.ts +2 -1
  359. package/src/plugins/builtin/ticker-detail/headless.ts +21 -66
  360. package/src/plugins/builtin/ticker-detail/index.tsx +5 -0
  361. package/src/plugins/builtin/ticker-detail/overview/components.tsx +67 -6
  362. package/src/plugins/builtin/ticker-detail/overview/model.ts +6 -4
  363. package/src/plugins/builtin/ticker-detail/overview/pane.tsx +15 -0
  364. package/src/plugins/builtin/ticker-detail/overview/tax-equivalent.ts +69 -0
  365. package/src/plugins/builtin/ticker-detail/overview-tab.tsx +69 -19
  366. package/src/plugins/builtin/ticker-detail/pane.tsx +7 -2
  367. package/src/plugins/builtin/ticker-detail/quote-monitor/card.tsx +47 -24
  368. package/src/plugins/builtin/ticker-detail/quote-monitor/export.ts +46 -0
  369. package/src/plugins/builtin/ticker-detail/quote-monitor/index.tsx +20 -1
  370. package/src/plugins/builtin/ticker-detail/quote-monitor/rows.ts +120 -0
  371. package/src/plugins/builtin/ticker-detail/research-tabs.ts +1 -5
  372. package/src/plugins/builtin/ticker-detail/settings.ts +6 -6
  373. package/src/plugins/builtin/treasury-auctions/cache.ts +85 -19
  374. package/src/plugins/builtin/treasury-auctions/index.tsx +22 -11
  375. package/src/plugins/builtin/treasury-auctions/model.ts +23 -0
  376. package/src/plugins/builtin/treasury-auctions/treasury-direct.ts +128 -0
  377. package/src/plugins/builtin/world-indices/client.ts +2 -0
  378. package/src/plugins/compat.ts +15 -0
  379. package/src/plugins/host-link.ts +6 -1
  380. package/src/plugins/installer.ts +53 -3
  381. package/src/portfolio/column-values.ts +14 -4
  382. package/src/portfolio/listed-symbol.ts +78 -0
  383. package/src/portfolio/real-return.ts +172 -0
  384. package/src/public/__snapshots__/public-api.test.ts.snap +1 -0
  385. package/src/remote/resources.ts +12 -1
  386. package/src/remote/schema.ts +1 -0
  387. package/src/remote/semantic-helpers.ts +29 -1
  388. package/src/remote/semantic-tree.tsx +32 -15
  389. package/src/renderers/browser/config-host.ts +56 -15
  390. package/src/renderers/browser/main.tsx +3 -1
  391. package/src/renderers/browser/ui-host.tsx +1 -0
  392. package/src/renderers/cloudflare/http-proxy.ts +1 -0
  393. package/src/renderers/cloudflare/worker.ts +16 -1
  394. package/src/renderers/dom/boot-frame.ts +2 -2
  395. package/src/renderers/dom/data-table/row.tsx +4 -1
  396. package/src/renderers/dom/desktop/controls.tsx +4 -4
  397. package/src/renderers/dom/desktop/dialog-actions.tsx +60 -41
  398. package/src/renderers/dom/dom-ui-host.tsx +3 -1
  399. package/src/renderers/dom/host/input.tsx +4 -1
  400. package/src/renderers/dom/host/tabs.tsx +10 -1
  401. package/src/renderers/dom/styles.css +73 -19
  402. package/src/renderers/electrobun/bun/desktop/app-name.ts +1 -1
  403. package/src/renderers/opentui/host.tsx +2 -1
  404. package/src/renderers/share/layout-view.tsx +1 -1
  405. package/src/sources/gloomberb-cloud/fred-series.ts +12 -0
  406. package/src/sources/gloomberb-cloud/index.ts +31 -2
  407. package/src/sources/gloomberb-cloud/news.ts +35 -12
  408. package/src/sources/gloomberb-cloud/normalizers.ts +29 -3
  409. package/src/sources/provider-router/cached-routes.ts +19 -7
  410. package/src/state/opening-ticker-panes.ts +47 -0
  411. package/src/state/pane-table-export-registry.ts +19 -6
  412. package/src/test-support/cli-context.ts +2 -0
  413. package/src/test-support/preload.ts +8 -1
  414. package/src/theme/colors.ts +9 -1
  415. package/src/theme/themes.ts +62 -15
  416. package/src/theme/tone-contrast.ts +40 -0
  417. package/src/theme/ui-tokens.ts +23 -3
  418. package/src/tickers/batched-lookups.ts +57 -8
  419. package/src/tickers/company-name-listing.ts +156 -14
  420. package/src/tickers/company-name.ts +30 -6
  421. package/src/tickers/instrument-kind.ts +23 -3
  422. package/src/tickers/list.ts +7 -0
  423. package/src/tickers/search/home-listing.ts +31 -9
  424. package/src/tickers/search/index.ts +13 -3
  425. package/src/tickers/search/listing-index.ts +558 -0
  426. package/src/tickers/search/major-listings.chunk.ts +10 -0
  427. package/src/tickers/search/major-listings.json +3346 -0
  428. package/src/tickers/search/ranking.ts +68 -1
  429. package/src/tickers/search/types.ts +4 -0
  430. package/src/tickers/terminal-codes.ts +26 -1
  431. package/src/time-series/calendar-month-returns.ts +47 -0
  432. package/src/time-series/currency-conversion.ts +130 -0
  433. package/src/time-series/hooks.ts +2 -0
  434. package/src/time-series/price-comparison.ts +34 -11
  435. package/src/time-series/resolve-context.ts +3 -0
  436. package/src/time-series/resolve.ts +14 -2
  437. package/src/time-series/spec.ts +1 -0
  438. package/src/time-series/studies/indicators.ts +4 -1
  439. package/src/time-series/types.ts +8 -0
  440. package/src/types/config.ts +13 -0
  441. package/src/types/context-menu.ts +2 -0
  442. package/src/types/data-provider.ts +28 -0
  443. package/src/types/financials.ts +20 -2
  444. package/src/types/headless.ts +12 -0
  445. package/src/types/plugin-commands.ts +140 -0
  446. package/src/types/plugin-context.ts +125 -0
  447. package/src/types/plugin-contributions.ts +55 -0
  448. package/src/types/plugin-definition.ts +234 -0
  449. package/src/types/plugin-notifications.ts +38 -0
  450. package/src/types/plugin-pane-settings.ts +114 -0
  451. package/src/types/plugin-pane-templates.ts +160 -0
  452. package/src/types/plugin-panes.ts +221 -0
  453. package/src/types/plugin-reports.ts +35 -0
  454. package/src/types/plugin-shared.ts +14 -0
  455. package/src/types/plugin-state.ts +71 -0
  456. package/src/types/plugin.ts +14 -1169
  457. package/src/ui/host.tsx +8 -0
  458. package/src/ui/index.tsx +14 -3
  459. package/src/updater/github-releases.ts +23 -0
  460. package/src/utils/cli-output.ts +22 -9
  461. package/src/utils/datetime-format.ts +17 -3
  462. package/src/utils/display-number.ts +15 -0
  463. package/src/utils/double-escape-close.ts +61 -16
  464. package/src/utils/float32-price.ts +24 -0
  465. package/src/utils/forward-dividend.ts +81 -16
  466. package/src/utils/fx-market-hours.ts +11 -0
  467. package/src/utils/plugin-proxy-hosts.json +2 -1
  468. package/src/utils/price-history.ts +7 -6
  469. package/src/utils/report-timing.ts +62 -0
  470. package/src/utils/sec-filings.ts +32 -0
  471. package/src/utils/utc-time.ts +5 -0
@@ -13,6 +13,7 @@ import { isProviderBusy } from "../../../../sources/provider-errors";
13
13
  import { splitSymbolArgs } from "../../../../cli/symbol-args";
14
14
  import { readNameEntryGroups } from "../../../../cli/name-entries";
15
15
  import { mapWithConcurrency } from "../../../../utils/concurrency";
16
+ import { quotedListingName } from "../../../../tickers/listing-name";
16
17
  import {
17
18
  describeFormerIssuer,
18
19
  describeTickerChange,
@@ -166,6 +167,14 @@ function exchangeFromResolved(resolved: ResolvedTickerSearch): string | undefine
166
167
  : resolved.ticker.metadata.exchange;
167
168
  }
168
169
 
170
+ /** A search row named as its listing's own quote names it, when the quote prices that listing and names it otherwise. */
171
+ function withQuotedListingName(resolved: ResolvedTickerSearch, quote: Quote | null): ResolvedTickerSearch {
172
+ if (resolved.kind !== "provider") return resolved;
173
+ const result = resolved.result;
174
+ const name = quotedListingName(result.exchange === "SMART" ? result.primaryExchange || result.exchange : result.exchange, quote);
175
+ return name && name !== result.name ? { ...resolved, result: { ...result, name } } : resolved;
176
+ }
177
+
169
178
  export function tickerNameFromValidation(
170
179
  validation: Extract<QuickAddValidation, { status: "ready" | "duplicate" }>,
171
180
  ): string {
@@ -231,35 +240,38 @@ export async function resolveQuickAddValidation({
231
240
  const changes = startTickerChangeLookup(registry.marketData, query);
232
241
 
233
242
  try {
234
- const resolved = await resolveTickerSearch({
243
+ const found = await resolveTickerSearch({
235
244
  query,
236
245
  activeTicker: null,
237
246
  tickers,
238
247
  dataProvider: registry.marketData,
239
248
  });
240
- if (!resolved) {
249
+ if (!found) {
241
250
  const payload = await changes.settle();
242
251
  const line = tickerChangeLine(describeTickerChange(query, payload, null)) ?? describeFormerIssuer(query, payload, null)?.note;
243
252
  return { status: "missing", query, message: line ?? "No exact ticker match" };
244
253
  }
245
254
 
246
- const symbol = resolved.symbol;
247
- const ticker = tickerForResolved(resolved, tickers);
255
+ const symbol = found.symbol;
256
+ const ticker = tickerForResolved(found, tickers);
248
257
  const cachedQuote = ticker ? financials.get(ticker.metadata.ticker)?.quote ?? null : null;
249
258
  // A listing its own quote vouched for comes with it.
250
- let quote = cachedQuote ?? (resolved.kind === "provider" ? resolved.quote ?? null : null);
259
+ let quote = cachedQuote ?? (found.kind === "provider" ? found.quote ?? null : null);
251
260
  if (!quote) {
252
261
  try {
253
262
  quote = await registry.marketData.getQuote(
254
263
  symbol,
255
- exchangeFromResolved(resolved),
256
- quoteContextFromResolved(resolved),
264
+ exchangeFromResolved(found),
265
+ quoteContextFromResolved(found),
257
266
  );
258
267
  } catch (error) {
259
268
  logFailure("portfolio-list.quick-add.resolution", "Read quick-add quote failed")(error);
260
269
  quote = null;
261
270
  }
262
271
  }
272
+ // The listing's own quote names it, over a search row that names another listing's company:
273
+ // search's BA on LSE read "The Boeing Company" while its quote is BAE Systems, and the row was saved so.
274
+ const resolved = withQuotedListingName(found, quote);
263
275
 
264
276
  // A listing abroad is not the US symbol the changes are of.
265
277
  const venue = resolved.kind === "provider" && resolved.result.exchange === "SMART"
@@ -528,7 +528,9 @@ export function renderSummarySegments(segments: PortfolioSummarySegment[], width
528
528
  <Box key={segment.id} flexDirection="row">
529
529
  {segmentIndex > 0 && <Text fg={colors.textDim}>{" "}</Text>}
530
530
  {segment.parts.map((part, partIndex) => (
531
- <Box key={`${segment.id}:${partIndex}`} flexDirection="row">
531
+ // A row too narrow for its segment cuts the muted basis ("vs Thu 5 Nov close"), never the
532
+ // label or the figure: "Avg +1." read as a different number than +1.02%.
533
+ <Box key={`${segment.id}:${partIndex}`} flexDirection="row" flexShrink={part.tone === "muted" ? 1 : 0}>
532
534
  {partIndex > 0 && <Text fg={colors.textDim}>{" "}</Text>}
533
535
  <Text
534
536
  fg={part.color ?? (part.tone === "label" || part.tone === "muted" ? colors.textDim : colors.text)}
@@ -17,15 +17,29 @@ import { objectVersion } from "../../../utils/object-version";
17
17
  import { columnContextVersion, PERPETUAL_COLUMN_IDS } from "./cell-version";
18
18
  import { getColumnValue, type ColumnContext } from "./metrics";
19
19
  import { periodPnlFigure, tickerDisplayName } from "../../../portfolio/column-values";
20
+ import { listedSymbol } from "../../../portfolio/listed-symbol";
20
21
  import { displayWidth } from "../../../utils/format";
21
22
  import { dropColumnsToFit } from "../../../components/ui/table-layout";
22
23
  import { sinceLastSeenTint, type SinceLastSeenRecap } from "./since-last-seen";
23
24
  import { portfolioPnlLabel } from "../../../portfolio/position-metrics";
24
25
  import { PORTFOLIO_ROW_MENU_KEYS } from "./row-actions";
25
26
  import { isFuturesTicker } from "../../../portfolio/futures-positions";
27
+ import { resolveCurrencyUnit } from "../../../utils/currency-units";
26
28
 
27
29
  export type { QuoteFlashDirection };
28
30
 
31
+ /**
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.
36
+ */
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}`;
40
+ return { ...column, label, width: Math.max(column.width, displayWidth(label)) };
41
+ }
42
+
29
43
  /** The market-state dot and the space after it, before each symbol in the Ticker column. */
30
44
  const TICKER_DOT_WIDTH = 2;
31
45
  /**
@@ -185,6 +199,7 @@ export function PortfolioTickerTable({
185
199
  rootHeight,
186
200
  width,
187
201
  answeredSnapshots,
202
+ exportName,
188
203
  }: {
189
204
  columns: ColumnConfig[];
190
205
  focused?: boolean;
@@ -217,6 +232,8 @@ export function PortfolioTickerTable({
217
232
  width?: number;
218
233
  /** Rows whose financial snapshot answered: until then a company column's dash may still fill in. */
219
234
  answeredSnapshots?: ReadonlySet<string>;
235
+ /** The list's name, which names its exported file. */
236
+ exportName?: string;
220
237
  }) {
221
238
  const cellCacheRef = useRef(createRowValueCache<string, ReturnType<typeof getColumnValue> & TickerTableCell>(5000));
222
239
  const openPerpetualRef = useRef(onOpenPerpetual);
@@ -262,15 +279,23 @@ export function PortfolioTickerTable({
262
279
  (widest, ticker) => Math.max(widest, displayWidth(resolveCell(sharesColumn, ticker, tableFinancialsMap.get(ticker.metadata.ticker)).text)),
263
280
  sharesColumn.width,
264
281
  )) : 0;
265
- // The Ticker column grows to its longest symbol, so ETH-USD shows whole beside its market-state dot.
282
+ // The Ticker column grows to its longest symbol, so ETH-USD and BA:LSE show whole beside their market-state dot.
266
283
  const tickerWidth = useMemo(() => Math.min(MAX_TICKER_COLUMN_WIDTH, sortedTickers.reduce(
267
- (widest, ticker) => Math.max(widest, TICKER_DOT_WIDTH + displayWidth(tickerDisplayName(ticker))),
284
+ (widest, ticker) => Math.max(widest, TICKER_DOT_WIDTH + displayWidth(listedSymbol(ticker, tickerDisplayName(ticker), columnContext.homeMarket))),
268
285
  0,
269
- )), [sortedTickers]);
286
+ )), [columnContext.homeMarket, sortedTickers]);
270
287
  // A book that holds a short weighs its positions against gross exposure, and the header says so.
271
288
  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).
290
+ 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]);
272
296
  const sizedColumns = useMemo(() => columns.map((column) => column.id === "shares" && hasNonShareQuantity
273
297
  ? { ...column, label: "QTY", ...(sharesWidth > column.width ? { width: sharesWidth } : {}) }
298
+ : column.id === "market_cap" ? marketCapColumn(column, capCurrency, [otherListedCurrency])
274
299
  : column.id === "weight" && grossWeights ? { ...column, label: GROSS_WEIGHT_LABEL }
275
300
  : column.id === "ticker" && tickerWidth > column.width ? { ...column, width: tickerWidth }
276
301
  : column.id === "pnl_pct" && period ? { ...column, label: CONTRIBUTION_LABEL }
@@ -278,7 +303,7 @@ export function PortfolioTickerTable({
278
303
  ...column,
279
304
  label: column.id === "pnl_pct" ? pnlLabel.replace("P&L", "%") : pnlLabel,
280
305
  } : column).map((column) => hasFrontReference && column.id === noteColumnId ? { ...column, flexGrow: 1 } : column),
281
- [columns, grossWeights, hasFrontReference, hasNonShareQuantity, noteColumnId, period, pnlLabel, sharesWidth, tickerWidth]);
306
+ [capCurrency, columns, grossWeights, hasFrontReference, hasNonShareQuantity, noteColumnId, otherListedCurrency, period, pnlLabel, sharesWidth, tickerWidth]);
282
307
  // Read again as the rows' data moves, from the cells the rows show; the columns change only when what is hidden does.
283
308
  // The company columns hidden last time, per list, stay hidden while a row added since settles.
284
309
  const hiddenCompanyRef = useRef<{ list: string | undefined; ids: ReadonlySet<string> }>({ list: undefined, ids: new Set() });
@@ -343,6 +368,7 @@ export function PortfolioTickerTable({
343
368
  addTickerShortcut={addTickerShortcut}
344
369
  summaryRows={summaryRows}
345
370
  rootHeight={rootHeight}
371
+ exportName={exportName}
346
372
  />
347
373
  );
348
374
  }
@@ -24,8 +24,26 @@ export interface RealizedVolEvidenceStatus {
24
24
  /** The windows the history is too short for: their series have no values, and the capture is whole without them. */
25
25
  shortWindows?: number[];
26
26
  currentIv: { value: number; date: string; label: string; source: string | null; expiration: number } | null;
27
+ /**
28
+ * An FX pair or currency future: it has no option chain, so no ATM IV is
29
+ * missing from a whole capture. The currency fund's IV30 that stands in is
30
+ * the IV point drawn, when there is one (`proxyIv`, in percent).
31
+ */
32
+ fxPair?: boolean;
33
+ proxyIv?: { fund: string; value: number; date: string } | null;
34
+ /** The proxy's IV30 is over 5 sessions behind the pair's last bar: no current IV, so the capture is not whole. */
35
+ proxyStale?: boolean;
27
36
  }
28
37
 
38
+ /** The IV point the history view draws: the ATM IV, or for an FX pair the proxy fund's IV30. */
39
+ function ivPoint(status: Pick<RealizedVolEvidenceStatus, "showIv" | "currentIv" | "proxyIv">): { value: number; date: string } | null {
40
+ return status.showIv ? status.currentIv ?? status.proxyIv ?? null : null;
41
+ }
42
+
43
+ /** Whether a capture still needs an ATM IV it does not have; an FX pair never has one. */
44
+ const missingIv = (status: Pick<RealizedVolEvidenceStatus, "showIv" | "currentIv" | "fxPair">) =>
45
+ status.showIv && status.currentIv == null && status.fxPair !== true;
46
+
29
47
  /** A series a short history leaves without values: a selected window it is too short for. */
30
48
  function shortSeries(id: string, shortWindows: readonly number[] | undefined): boolean {
31
49
  return /^hv-\d+$/.test(id) && (shortWindows ?? []).includes(Number(id.slice(3)));
@@ -49,7 +67,7 @@ export function realizedVolSemanticEvidence(series: readonly ResolvedSeries[], s
49
67
  complete: !status.loading && !status.stale && status.errors.length === 0 && !!status.asOf
50
68
  && plotted.length > 0 && plotted.some((entry) => entry.points.some((point) => isFiniteNumber(point.value)))
51
69
  && plotted.every((entry) => shortSeries(entry.id, status.shortWindows) || entry.points.some((point) => isFiniteNumber(point.value)))
52
- && (!status.showIv || status.currentIv != null),
70
+ && !missingIv(status) && status.proxyStale !== true,
53
71
  };
54
72
  }
55
73
 
@@ -68,13 +86,18 @@ function readRealizedVolEvidence(value: unknown): RealizedVolEvidence | null {
68
86
  || !isStringArray(value.errors)
69
87
  || (value.shortWindows !== undefined && (!Array.isArray(value.shortWindows) || !value.shortWindows.every(isFiniteNumber)))
70
88
  || (value.ivErrors !== undefined && !isStringArray(value.ivErrors))
89
+ || (value.fxPair !== undefined && typeof value.fxPair !== "boolean")
90
+ || (value.proxyStale !== undefined && typeof value.proxyStale !== "boolean")
91
+ || (value.proxyIv != null && (!isRecord(value.proxyIv) || typeof value.proxyIv.fund !== "string"
92
+ || !isFiniteNumber(value.proxyIv.value) || !isDateString(value.proxyIv.date)))
71
93
  || !Array.isArray(value.series) || !value.series.every((entry) => isRecord(entry) && typeof entry.id === "string"
72
94
  && typeof entry.unit === "string" && Array.isArray(entry.points) && entry.points.every((point) => isRecord(point)
73
95
  && isDateString(point.date) && (point.value === null || isFiniteNumber(point.value))))) return null;
74
96
  const evidence = value as unknown as RealizedVolEvidence;
75
97
  // The IV point is drawn only when there is one: a chart without it matches its data, and is incomplete for it.
98
+ const point = ivPoint(evidence);
76
99
  const required = evidence.view === "graph" ? [...evidence.windows.map((window) => `hv-${window}`), "price",
77
- ...(evidence.showIv && evidence.currentIv != null ? ["current-iv"] : [])] : ["min", "max", "mean", "current"];
100
+ ...(point ? ["current-iv"] : [])] : ["min", "max", "mean", "current"];
78
101
  if (!required.length || (evidence.view === "graph" && !evidence.windows.length)
79
102
  || evidence.series.length !== required.length || new Set(evidence.series.map((entry) => entry.id)).size !== required.length
80
103
  || required.some((id) => !evidence.series.some((entry) => entry.id === id))) return null;
@@ -82,12 +105,12 @@ function readRealizedVolEvidence(value: unknown): RealizedVolEvidence | null {
82
105
  if (count <= 0 || count !== evidence.plottedValueCount) return null;
83
106
  if (evidence.currentIv != null && (!isRecord(evidence.currentIv) || !isFiniteNumber(evidence.currentIv.value)
84
107
  || !isDateString(evidence.currentIv.date) || !isFiniteNumber(evidence.currentIv.expiration))) return null;
85
- if (evidence.view === "graph" && evidence.showIv && evidence.currentIv) {
108
+ if (evidence.view === "graph" && point) {
86
109
  const points = evidence.series.find((entry) => entry.id === "current-iv")!.points;
87
- if (points.length !== 1 || points[0]!.date !== evidence.currentIv.date || points[0]!.value !== evidence.currentIv.value) return null;
110
+ if (points.length !== 1 || points[0]!.date !== point.date || points[0]!.value !== point.value) return null;
88
111
  }
89
112
  if (evidence.complete && (evidence.loading || evidence.stale || evidence.errors.length > 0
90
- || (evidence.showIv && !evidence.currentIv)
113
+ || missingIv(evidence) || evidence.proxyStale === true
91
114
  || evidence.series.some((entry) => !shortSeries(entry.id, evidence.shortWindows) && !entry.points.some((point) => isFiniteNumber(point.value))))) return null;
92
115
  return evidence;
93
116
  }
@@ -95,7 +118,7 @@ function readRealizedVolEvidence(value: unknown): RealizedVolEvidence | null {
95
118
  /** Drawn, current and whole but for the current IV, whose errors are the only ones. */
96
119
  function missingOnlyIv(evidence: RealizedVolEvidence): boolean {
97
120
  const ivErrors = new Set(evidence.ivErrors ?? []);
98
- return evidence.view === "graph" && evidence.showIv && evidence.currentIv == null
121
+ return evidence.view === "graph" && missingIv(evidence)
99
122
  && !evidence.loading && !evidence.stale && evidence.plottedValueCount > 0
100
123
  && evidence.errors.every((error) => ivErrors.has(error))
101
124
  && evidence.series.every((entry) => shortSeries(entry.id, evidence.shortWindows) || entry.points.some((point) => isFiniteNumber(point.value)));
@@ -123,6 +146,10 @@ export const realizedVolScreenshotEvidence: PaneScreenshotEvidenceHook<RealizedV
123
146
  if (evidence?.complete && !evidence.loading) return [];
124
147
  // The volatility drawn whole and only the IV point missing: the capture names the IV, not the symbol.
125
148
  if (evidence && missingOnlyIv(evidence)) return [`${symbol ?? evidence.symbol} current ATM IV`];
149
+ // An FX pair whose proxy IV30 is stale: what is missing is a current IV30 of the fund.
150
+ if (evidence?.proxyStale && evidence.proxyIv && !evidence.loading && !evidence.stale && evidence.errors.length === 0) {
151
+ return [`${evidence.proxyIv.fund} current IV30`];
152
+ }
126
153
  return [symbol ?? "realized volatility"];
127
154
  },
128
155
  };
@@ -0,0 +1,135 @@
1
+ import { apiClient } from "../../../api-client";
2
+ import type { BarsPerYearInstrument } from "../../../market-data/bars-per-year";
3
+ import { fxVolatilityPair, fxVolatilityProxyFund } from "../../../market-data/options-alternatives";
4
+ import type { PricePoint } from "../../../types/financials";
5
+ import { abortError } from "../../../utils/async-deadline";
6
+ import { errorMessage } from "../../../utils/errors";
7
+ import { loadIvHistory, type ImpliedVolatilityApi, type IvHistoryPayload, type IvMethod } from "../iv-history/client";
8
+ import { staleness } from "../iv-history/model";
9
+ import { realizedVolatilityResult } from "../shared/volatility";
10
+ import { createSurfaceDependencies, loadVolatilitySurface, type SurfaceLoaderDependencies } from "../vol-surface/client";
11
+ import type { SurfaceSnapshot } from "../vol-surface/model";
12
+
13
+ /**
14
+ * An FX pair has no option chain here, and OTC FX volatility is not served:
15
+ * the options of a currency fund that holds one side of it (USDJPY: FXY) are
16
+ * the listed proxy. A thin one: the fund's chains often price an ATM level on
17
+ * one or two expiries, and its IV reads above interbank FX volatility. So the
18
+ * proxy is shown with its date, how many of the fund's expiries priced, and
19
+ * how far its IV30 sits above the pair's own realized volatility.
20
+ */
21
+ export interface FxVolProxy {
22
+ /** The pair the symbol is (USDJPY for USDJPY=X or 6J=F). */
23
+ pair: string;
24
+ /** The fund whose options stand in (FXY). */
25
+ fund: string;
26
+ /** The fund's stored 30-day IV on its latest ranked close; null when there is none. */
27
+ iv30: { value: number; date: string; method: IvMethod } | null;
28
+ /** The fund's listed expiries that price an ATM IV now, of those read; null when its chains could not be read. */
29
+ expiries: { usable: number; read: number } | null;
30
+ /** What could not be read, said once: the proxy's history or its chains. */
31
+ error: string | null;
32
+ }
33
+
34
+ export interface FxVolProxyDependencies {
35
+ iv: ImpliedVolatilityApi;
36
+ surface: SurfaceLoaderDependencies;
37
+ }
38
+
39
+ const CANCELLED = "FX volatility proxy load was cancelled";
40
+ const usableAtm = (value: number | null) => value != null && Number.isFinite(value) && value > 0;
41
+
42
+ /** The fund's 30-day IV on the close its rank is read on, else its newest reading with one. */
43
+ function proxyIv30(payload: IvHistoryPayload): FxVolProxy["iv30"] {
44
+ const ranked = payload.stats?.iv30;
45
+ if (ranked && Number.isFinite(ranked.value) && ranked.value > 0) return { value: ranked.value, date: ranked.date, method: ranked.method };
46
+ const row = [...payload.series ?? []].reverse().find((point) => usableAtm(point.iv30));
47
+ return row ? { value: row.iv30!, date: row.sessionDate, method: row.method } : null;
48
+ }
49
+
50
+ /** The fund's spot for its chains: the newest stored reading's. */
51
+ function proxySpot(payload: IvHistoryPayload): number | null {
52
+ if (payload.latest?.spot && payload.latest.spot > 0) return payload.latest.spot;
53
+ return [...payload.series ?? []].reverse().find((point) => point.spot != null && point.spot > 0)?.spot ?? null;
54
+ }
55
+
56
+ /** How many expiries read price an ATM IV that is not stale or failed. */
57
+ function usableExpiries(surface: SurfaceSnapshot): FxVolProxy["expiries"] {
58
+ if (!surface.expiries.length) return null;
59
+ return { usable: surface.expiries.filter((expiry) => usableAtm(expiry.atmIV) && !expiry.stale && !expiry.error).length,
60
+ read: surface.expiries.length };
61
+ }
62
+
63
+ /** Null for a symbol that is no FX pair or currency future, or a pair no single fund stands in for. */
64
+ export async function loadFxVolProxy(
65
+ request: { symbol: string; exchange?: string; signal?: AbortSignal },
66
+ dependencies: FxVolProxyDependencies = { iv: apiClient, surface: createSurfaceDependencies() },
67
+ ): Promise<FxVolProxy | null> {
68
+ const pair = fxVolatilityPair(request.symbol, request.exchange);
69
+ const fund = pair ? fxVolatilityProxyFund(pair) : null;
70
+ if (!pair || !fund) return null;
71
+ if (request.signal?.aborted) throw abortError(CANCELLED);
72
+ let payload: IvHistoryPayload;
73
+ try {
74
+ payload = await loadIvHistory(fund, { signal: request.signal, days: 40 }, dependencies.iv);
75
+ } catch (error) {
76
+ if (request.signal?.aborted) throw abortError(CANCELLED);
77
+ return { pair, fund, iv30: null, expiries: null, error: `${fund} IV history: ${errorMessage(error)}` };
78
+ }
79
+ const iv30 = proxyIv30(payload);
80
+ const spot = proxySpot(payload);
81
+ let expiries: FxVolProxy["expiries"] = null;
82
+ let error: string | null = null;
83
+ if (spot != null) {
84
+ try {
85
+ expiries = usableExpiries(await loadVolatilitySurface({ instrument: { symbol: fund }, spot, signal: request.signal }, dependencies.surface));
86
+ } catch (failure) {
87
+ if (request.signal?.aborted) throw abortError(CANCELLED);
88
+ error = `${fund} options: ${errorMessage(failure)}`;
89
+ }
90
+ }
91
+ return { pair, fund, iv30, expiries, error: error ?? (iv30 ? null : `${fund} has no IV30 yet`) };
92
+ }
93
+
94
+ /** The day of a bar, UTC. */
95
+ const barDay = (point: PricePoint) => new Date(point.date).toISOString().slice(0, 10);
96
+
97
+ export interface FxProxyReading {
98
+ /** The pair's close-to-close HV20 on the proxy's IV30 close; null when the IV30 is stale or missing. */
99
+ hv20: number | null;
100
+ /** IV30 less that HV20; null as HV20 is. */
101
+ spread: number | null;
102
+ /**
103
+ * The IV30 is over 5 of the fund's sessions behind the pair's last bar, as HIVG
104
+ * counts a stale reading: FXB's IV30 of 18 May beside a November cone.
105
+ */
106
+ stale: boolean;
107
+ /** What a stale IV30 says: "FXB has no IV30 since 2026-05-18". */
108
+ note: string | null;
109
+ }
110
+
111
+ /**
112
+ * The proxy's IV30 read against the pair: its age against the pair's last bar
113
+ * (stale over 5 sessions, iv-history's `staleness`), and while it is current,
114
+ * the pair's 20-bar realized volatility on the IV30's close and the IV30 less
115
+ * it, HIVG's IV30 - HV20 with the fund's IV against the pair's own moves.
116
+ * Close to close, whatever the pane's estimator, as HIVG reads it, and over
117
+ * the pair's year (`instrument`: 260 bars for USDJPY=X, 252 for 6J=F). A stale
118
+ * IV30 is no reading of the pair now: IV30 - HV20 is left out.
119
+ */
120
+ export function fxProxyIvLessRv(proxy: FxVolProxy | null, history: readonly PricePoint[], instrument: BarsPerYearInstrument = {}): FxProxyReading {
121
+ if (!proxy?.iv30) return { hv20: null, spread: null, stale: false, note: null };
122
+ const through = proxy.iv30.date;
123
+ const lastBar = history.length ? history.map(barDay).sort().at(-1)! : null;
124
+ if (staleness(through, lastBar).stale) {
125
+ return { hv20: null, spread: null, stale: true, note: `${proxy.fund} has no IV30 since ${through}` };
126
+ }
127
+ const upTo = history.filter((point) => barDay(point) <= through);
128
+ const hv20 = upTo.length ? realizedVolatilityResult(upTo, 20, "close-to-close", instrument).value : null;
129
+ return { hv20, spread: hv20 == null ? null : proxy.iv30.value - hv20, stale: false, note: null };
130
+ }
131
+
132
+ /** "FXY IV30", the label the proxy reads under in the pane, the chart legend and the report. */
133
+ export const fxProxyLabel = (proxy: Pick<FxVolProxy, "fund">) => `${proxy.fund} IV30`;
134
+ /** What the proxy is, said once: "FXY options, a thin ETF proxy". */
135
+ export const fxProxyNote = (proxy: Pick<FxVolProxy, "fund">) => `${proxy.fund} options, a thin ETF proxy`;
@@ -1,4 +1,4 @@
1
- import { barsPerYearLabel } from "../../../market-data/bars-per-year";
1
+ import { barsPerYearLabel, currencyPairInstrument } from "../../../market-data/bars-per-year";
2
2
  import type { HeadlessPaneDefinition } from "../../../types/plugin";
3
3
  import { createSurfaceDependencies } from "../vol-surface/client";
4
4
  import { resolveHeadlessInstrument } from "../shared/headless-market-data";
@@ -7,6 +7,30 @@ import { atmIvObservedLabel, projectRealizedVolatility, type CurrentAtmIvSnapsho
7
7
  import { ESTIMATOR_OPTIONS, selectedWindows } from "./settings";
8
8
  import { DAILY_CLOSES } from "../shared/report-freshness";
9
9
  import { listingAbroadVenue } from "../../../utils/sec";
10
+ import { fxVolatilityPair } from "../../../market-data/options-alternatives";
11
+ import { fxProxyIvLessRv, fxProxyLabel, fxProxyNote, loadFxVolProxy, type FxProxyReading, type FxVolProxy } from "./fx-proxy";
12
+ import type { HeadlessBundleSection } from "../../../types/headless";
13
+
14
+ const percent = (value: number | null | undefined) => value == null ? "--" : `${(value * 100).toFixed(2)}%`;
15
+
16
+ /**
17
+ * 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
+ */
21
+ function fxProxySection(proxy: FxVolProxy, reading: FxProxyReading): HeadlessBundleSection {
22
+ const { hv20, spread, stale } = reading;
23
+ return { title: "FX vol proxy", entries: [
24
+ { label: "Proxy", value: proxy.fund, formatted: fxProxyNote(proxy) },
25
+ { label: fxProxyLabel(proxy), value: proxy.iv30?.value ?? null, formatted: percent(proxy.iv30?.value) },
26
+ { label: "Close", value: proxy.iv30?.date ?? null,
27
+ 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}` : "--" },
30
+ { label: "Pair HV20", value: hv20, formatted: percent(hv20) },
31
+ { label: "IV30 - HV20", value: spread, formatted: spread == null ? "--" : `${spread >= 0 ? "+" : ""}${(spread * 100).toFixed(2)} pts` },
32
+ ] };
33
+ }
10
34
 
11
35
  export function realizedVolHeadless(initialView: "graph" | "cone"): HeadlessPaneDefinition<"bundle"> {
12
36
  return {
@@ -30,8 +54,10 @@ export function realizedVolHeadless(initialView: "graph" | "cone"): HeadlessPane
30
54
  const instrument = await resolveHeadlessInstrument(ctx, args.symbols[0]!);
31
55
  // Options are US listings'; SAN:EPA has none, and bare SAN's chain is another company's.
32
56
  const abroad = listingAbroadVenue(args.symbols[0]!) != null;
57
+ // An FX pair or currency future has no chain of its own: a currency fund's options stand in, labelled so.
58
+ const fx = fxVolatilityPair(instrument.symbol, instrument.exchange) != null;
33
59
  const currentIv = async (): Promise<CurrentAtmIvSnapshot | null> => {
34
- if (!args.options.showIv) return null;
60
+ if (!args.options.showIv || fx) return null;
35
61
  if (abroad) return { reference: null, error: null, warnings: [], noOptionChain: true };
36
62
  try {
37
63
  const quote = await ctx.marketData.getQuote(instrument.symbol, instrument.exchange);
@@ -43,14 +69,19 @@ export function realizedVolHeadless(initialView: "graph" | "cone"): HeadlessPane
43
69
  return { reference: null, warnings: [], error: `Current ATM IV: ${error instanceof Error ? error.message : String(error)}` };
44
70
  }
45
71
  };
46
- const [history, iv] = await Promise.all([
72
+ const fxProxy = async (): Promise<FxVolProxy | null> => !args.options.showIv || !fx ? null
73
+ : loadFxVolProxy({ symbol: instrument.symbol, exchange: instrument.exchange, signal: ctx.signal },
74
+ { iv: ctx.apiClient, surface: createSurfaceDependencies(ctx.marketData, ctx.apiClient) });
75
+ const [history, iv, proxy] = await Promise.all([
47
76
  loadRealizedVolatilityHistory({ instrument, signal: ctx.signal }, createRealizedVolatilityDependencies(ctx.marketData)), currentIv(),
77
+ fxProxy(),
48
78
  ]);
49
79
  ctx.signal.throwIfAborted();
50
- const model = projectRealizedVolatility(history.history, { symbol: instrument.symbol,
80
+ const model = projectRealizedVolatility(history.history, { symbol: instrument.symbol, exchange: instrument.exchange,
51
81
  estimator: ESTIMATOR_OPTIONS.find(({ value }) => value === args.options.estimator)?.value,
52
82
  windows, lookbackYears: Number(args.options.lookbackYears) === 2 ? 2 : 1 });
53
83
  const errors = [history.error, iv?.error].filter((value): value is string => !!value);
84
+ const proxyReading = proxy ? fxProxyIvLessRv(proxy, history.history, currencyPairInstrument(instrument.symbol, instrument.exchange)) : null;
54
85
  // The cone rows are as of the last daily bar, not of when the report ran.
55
86
  const lastBar = model.asOf && Number.isFinite(model.asOf.getTime()) ? model.asOf.toISOString().slice(0, 10) : null;
56
87
  return {
@@ -65,7 +96,7 @@ export function realizedVolHeadless(initialView: "graph" | "cone"): HeadlessPane
65
96
  { key: "percentile", header: "Percentile", format: (value) => typeof value === "number" ? `${value.toFixed(1)}%` : "--" },
66
97
  { key: "sampleSize", header: "Samples" },
67
98
  ], rows: model.cone.map((row) => ({ ...row })) },
68
- { title: "Current IV", entries: [
99
+ ...proxy && proxyReading ? [fxProxySection(proxy, proxyReading)] : fx ? [] : [{ title: "Current IV", entries: [
69
100
  { label: "ATM IV", value: iv?.reference?.value ?? null, formatted: iv?.reference ? `${(iv.reference.value * 100).toFixed(2)}%` : "--" },
70
101
  { label: "Expiry", value: iv?.reference?.expiration ?? null,
71
102
  formatted: iv?.reference ? new Date(iv.reference.expiration * 1000).toISOString().slice(0, 10) : "--" },
@@ -74,15 +105,20 @@ export function realizedVolHeadless(initialView: "graph" | "cone"): HeadlessPane
74
105
  // To the minute, as the pane reads it; the JSON keeps the chain's read time whole.
75
106
  { label: "Observed", value: iv?.reference?.date.toISOString() ?? null,
76
107
  formatted: iv?.reference ? atmIvObservedLabel(iv.reference.date) : "--" },
77
- ] },
108
+ ] }],
78
109
  ],
79
110
  // A short history is whole: the windows it is too short for have no estimate yet, and the note says when it starts.
80
111
  complete: model.cone.every((row) => row.current != null || model.shortWindows.includes(row.window))
81
112
  && model.warnings.length === 0 && !history.stale && errors.length === 0
82
- && (!args.options.showIv || iv?.reference != null || iv?.noOptionChain === true),
113
+ && (!args.options.showIv || fx || iv?.reference != null || iv?.noOptionChain === true)
114
+ // A proxy IV30 over 5 sessions old is no current IV for the pair.
115
+ && !proxyReading?.stale,
83
116
  unavailableSymbols: model.history.length ? [] : [instrument.symbol], errors,
84
- notes: [barsPerYearLabel(model.barsPerYear), ...model.historyNote ? [model.historyNote] : []],
117
+ // A proxy that could not be read leaves the pair's own volatility whole: said, not failed.
118
+ notes: [barsPerYearLabel(model.barsPerYear), ...model.historyNote ? [model.historyNote] : [], ...proxy?.error ? [proxy.error] : [],
119
+ ...proxyReading?.note ? [proxyReading.note] : []],
85
120
  metadata: { unit: "decimal annualized volatility", annualization: model.barsPerYear, model, currentIv: iv,
121
+ ...proxy ? { fxVolProxy: { ...proxy, ...proxyReading } } : {},
86
122
  ...(abroad && args.options.showIv ? { notices: [`Options data covers US listings only, so ${args.symbols[0]} has no current IV.`] } : {}),
87
123
  source: history.source, stale: history.stale, fetchedAt: history.fetchedAt,
88
124
  methodology: "docs/research-data.md#shared-volatility-calculations" },
@@ -1,4 +1,4 @@
1
- import { barsPerYear, type BarsPerYear } from "../../../market-data/bars-per-year";
1
+ import { barsPerYear, currencyPairInstrument, type BarsPerYear } from "../../../market-data/bars-per-year";
2
2
  import type { PricePoint } from "../../../types/financials";
3
3
  import {
4
4
  REALIZED_VOLATILITY_WINDOWS, realizedVolatilityCadenceIssue, realizedVolatilityResult, rollingRealizedVolatility, volatilityCone,
@@ -48,6 +48,8 @@ function windowsText(windows: readonly number[]): string {
48
48
 
49
49
  export interface RealizedVolatilityProjectionOptions {
50
50
  symbol: string;
51
+ /** The listing's exchange: a CCY listing is a currency pair, annualised at 260 bars as USDJPY=X is. */
52
+ exchange?: string;
51
53
  estimator?: RealizedVolatilityEstimator;
52
54
  lookbackYears?: 1 | 2;
53
55
  windows?: readonly number[];
@@ -67,6 +69,8 @@ export function projectRealizedVolatility(
67
69
  ): RealizedVolatilityModel {
68
70
  const estimator = options.estimator ?? "close-to-close";
69
71
  const lookbackYears = options.lookbackYears === 2 ? 2 : 1;
72
+ // A currency pair's year is every weekday, however much of its history is loaded.
73
+ const instrument = currencyPairInstrument(options.symbol, options.exchange);
70
74
  const windows = [...new Set(options.windows ?? REALIZED_VOLATILITY_WINDOWS)]
71
75
  .filter((window) => REALIZED_VOLATILITY_WINDOWS.some((standard) => standard === window));
72
76
  const warnings: string[] = [];
@@ -98,13 +102,13 @@ export function projectRealizedVolatility(
98
102
  if (cadenceIssue) warnings.push(cadenceIssue);
99
103
  const series = cadenceIssue
100
104
  ? history.map((point) => ({ date: point.date, values: Object.fromEntries(windows.map((window) => [window, null])) }))
101
- : rollingRealizedVolatility(history, { windows, estimator });
102
- const cone = volatilityCone(cadenceIssue ? [] : history, { estimator, lookbackYears });
105
+ : rollingRealizedVolatility(history, { windows, estimator, instrument });
106
+ const cone = volatilityCone(cadenceIssue ? [] : history, { estimator, lookbackYears, instrument });
103
107
  const visible = history.filter((point) => point.date.getTime() > cutoff);
104
108
  const visibleSeries = series.filter((point) => point.date.getTime() > cutoff);
105
109
  if (history.length > 0 && history[0]!.date.getTime() > cutoff) shortLookback = true;
106
110
  for (const window of history.length > 0 && !cadenceIssue ? REALIZED_VOLATILITY_WINDOWS : []) {
107
- const result = realizedVolatilityResult(history, window, estimator);
111
+ const result = realizedVolatilityResult(history, window, estimator, instrument);
108
112
  if (result.reason === "insufficient-history") shortWindows.push(window);
109
113
  else if (result.reason) warnings.push(`HV${window} unavailable: ${result.reason.replaceAll("-", " ")}`);
110
114
  }
@@ -122,7 +126,7 @@ export function projectRealizedVolatility(
122
126
  ? `${windowsText(shortWindows)} need${shortWindows.length === 1 ? "s" : ""} more`
123
127
  : "the long windows' cone covers part of the lookback"}`;
124
128
  return { symbol: options.symbol.trim().toUpperCase(), estimator, lookbackYears, windows,
125
- history: visible, series: visibleSeries, cone, asOf, barsPerYear: barsPerYear(history.map((point) => point.date)),
129
+ history: visible, series: visibleSeries, cone, asOf, barsPerYear: barsPerYear(history.map((point) => point.date), instrument),
126
130
  warnings: [...new Set(warnings)], shortWindows, historyNote, formingNote };
127
131
  }
128
132