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
@@ -0,0 +1,270 @@
1
+ import { apiClient } from "../api-client";
2
+ import type { FxInterventionDay, FxInterventionMonth, FxInterventionRun, FxInterventionsPayload } from "../api-client/fx-interventions";
3
+ import { currencyPairSpelling } from "../utils/currency-pair";
4
+ import { logFailure } from "../utils/log-failure";
5
+
6
+ /**
7
+ * Japan's foreign exchange interventions as its Ministry of Finance publishes
8
+ * them: each intervention, from the quarterly releases, and each monthly
9
+ * total, which names no day and no pair until its quarter is released. Shown
10
+ * in `fx` and `history` notes for a yen pair, and on a yen pair's chart.
11
+ */
12
+
13
+ /** The two currencies of a yen pair, as the listing writes them: USD and JPY for USDJPY=X. */
14
+ export interface FxInterventionPair {
15
+ base: string;
16
+ quote: string;
17
+ }
18
+
19
+ /** The side Japan took: it bought yen to hold it up, or sold yen to hold it down. */
20
+ type FxInterventionSide = "yen bought" | "yen sold";
21
+
22
+ /** A total the ministry has reported whose days are not published yet. */
23
+ interface UndatedTotal {
24
+ from: string;
25
+ to: string;
26
+ amountJpy: number;
27
+ releasedOn: string;
28
+ }
29
+
30
+ const DAY_MS = 86_400_000;
31
+ const MONTHS = ["Jan", "Feb", "Mar", "Apr", "May", "Jun", "Jul", "Aug", "Sep", "Oct", "Nov", "Dec"];
32
+ const CURRENCY_WORDS: Record<string, string> = { USD: "dollars", JPY: "yen", EUR: "euros", DEM: "marks", IDR: "rupiah" };
33
+ const DAYS_KNOWN: ReadonlySet<unknown> = new Set(["all", "partial", "none"]);
34
+
35
+ const isDay = (value: unknown): value is string => typeof value === "string" && /^\d{4}-\d{2}-\d{2}$/.test(value)
36
+ && Number.isFinite(Date.parse(`${value}T00:00:00Z`)) && new Date(`${value}T00:00:00Z`).toISOString().slice(0, 10) === value;
37
+ const isCode = (value: unknown) => value === null || typeof value === "string" && /^[A-Z]{3}$/.test(value);
38
+ const isAmount = (value: unknown): value is number => typeof value === "number" && Number.isFinite(value) && value >= 0;
39
+ const nextDay = (date: string) => new Date(Date.parse(`${date}T00:00:00Z`) + DAY_MS).toISOString().slice(0, 10);
40
+
41
+ function readsAsDay(day: FxInterventionDay | undefined): boolean {
42
+ return !!day && isDay(day.date) && isAmount(day.amountJpy) && isCode(day.sold) && isCode(day.bought) && typeof day.pair === "string";
43
+ }
44
+
45
+ function readsAsRun(run: FxInterventionRun | undefined): boolean {
46
+ return !!run && isDay(run.from) && isDay(run.to) && run.to >= run.from && Number.isInteger(run.days) && run.days >= 1
47
+ && isAmount(run.amountJpy) && isCode(run.sold) && isCode(run.bought) && typeof run.pair === "string";
48
+ }
49
+
50
+ function readsAsMonth(month: FxInterventionMonth | undefined): boolean {
51
+ return !!month && isDay(month.from) && isDay(month.to) && month.to >= month.from && isAmount(month.amountJpy) && isDay(month.releasedOn)
52
+ && DAYS_KNOWN.has(month.daysKnown) && isAmount(month.undatedAmountJpy) && month.undatedAmountJpy <= month.amountJpy;
53
+ }
54
+
55
+ /**
56
+ * The reply as this app reads it, or null: a reply with a day out of order, a
57
+ * negative or missing amount or a period that ends before it starts is no
58
+ * record, never a guessed one. A server without the route answers 404, which
59
+ * the loader also reads as none.
60
+ */
61
+ export function readFxInterventions(payload: unknown): FxInterventionsPayload | null {
62
+ if (!payload || typeof payload !== "object") return null;
63
+ const record = payload as FxInterventionsPayload;
64
+ if (record.status !== "available" || !Array.isArray(record.days) || !Array.isArray(record.interventions) || !Array.isArray(record.months)
65
+ || !(record.dailyThrough === null || isDay(record.dailyThrough))) return null;
66
+ const inOrder = <T>(entries: readonly T[], date: (entry: T) => string) => entries.every((entry, index) => index === 0 || date(entries[index - 1]!) <= date(entry));
67
+ if (!record.days.every(readsAsDay) || !inOrder(record.days, (day) => day.date)) return null;
68
+ if (!record.interventions.every(readsAsRun) || !inOrder(record.interventions, (run) => run.from)) return null;
69
+ return record.months.every(readsAsMonth) ? record : null;
70
+ }
71
+
72
+ type FxInterventionsClient = Pick<typeof apiClient, "getCloudFxInterventions">;
73
+ const FRESH_MS = 10 * 60_000;
74
+ const RETRY_MS = 60_000;
75
+
76
+ /**
77
+ * A loader of the record from Gloom Cloud: null when it has none (not read
78
+ * yet, an older server) or could not be reached, so a note or a chart marker
79
+ * is left out, never the rate or the chart it goes with. One request serves
80
+ * every caller for ten minutes, a failed one for a minute.
81
+ */
82
+ export function createFxInterventionsLoader(
83
+ client: FxInterventionsClient,
84
+ now: () => number = Date.now,
85
+ ): () => Promise<FxInterventionsPayload | null> {
86
+ let held: { at: number; ttl: number; promise: Promise<FxInterventionsPayload | null> } | null = null;
87
+ return () => {
88
+ const at = now();
89
+ if (held && at - held.at < held.ttl) return held.promise;
90
+ const promise = client.getCloudFxInterventions()
91
+ .then(readFxInterventions, logFailure("market-data.fx-interventions", "Japan's intervention record could not be read", null));
92
+ const entry = { at, ttl: FRESH_MS, promise };
93
+ held = entry;
94
+ void promise.then((payload) => { if (!payload) entry.ttl = RETRY_MS; });
95
+ return promise;
96
+ };
97
+ }
98
+
99
+ /** The record from Gloom Cloud, shared by every caller in the app. */
100
+ export const loadFxInterventions = createFxInterventionsLoader(apiClient);
101
+
102
+ /** The pair a listing is, when one side is the yen: USD and JPY for USDJPY=X or JPY=X. */
103
+ export function fxInterventionPair(symbol: string, exchange?: string): FxInterventionPair | null {
104
+ const spelling = currencyPairSpelling(symbol, exchange);
105
+ if (!spelling || spelling.ambiguous) return null;
106
+ const base = spelling.symbol.slice(0, 3), quote = spelling.symbol.slice(3, 6);
107
+ return base === "JPY" || quote === "JPY" ? { base, quote } : null;
108
+ }
109
+
110
+ const inPair = (run: Pick<FxInterventionRun, "sold" | "bought">, pair: FxInterventionPair) => (
111
+ run.sold === pair.base && run.bought === pair.quote || run.sold === pair.quote && run.bought === pair.base
112
+ );
113
+ /** USD/JPY either way round: the only pair a monthly total, which names none, is shown for. */
114
+ const isDollarYen = (pair: FxInterventionPair) => inPair({ sold: "USD", bought: "JPY" }, pair);
115
+
116
+ /** The pair's interventions, oldest first. */
117
+ function fxInterventionsIn(payload: FxInterventionsPayload, pair: FxInterventionPair): FxInterventionRun[] {
118
+ return payload.interventions.filter((run) => inPair(run, pair));
119
+ }
120
+
121
+ /** Which way the ministry went. */
122
+ function fxInterventionSide(run: Pick<FxInterventionRun, "sold" | "bought">): FxInterventionSide | null {
123
+ return run.bought === "JPY" ? "yen bought" : run.sold === "JPY" ? "yen sold" : null;
124
+ }
125
+
126
+ /**
127
+ * Monthly totals, or the part of one, no published day accounts for yet: for
128
+ * USD/JPY only, since a total names no pair and nearly every intervention
129
+ * since 2004 has been in it. A month that runs past the daily record counts
130
+ * from the day after it.
131
+ */
132
+ function undatedTotals(payload: FxInterventionsPayload, pair: FxInterventionPair): UndatedTotal[] {
133
+ if (!isDollarYen(pair)) return [];
134
+ return payload.months.filter((month) => month.undatedAmountJpy > 0).map((month) => {
135
+ const after = month.daysKnown === "partial" && payload.dailyThrough ? nextDay(payload.dailyThrough) : month.from;
136
+ return { from: after > month.from && after <= month.to ? after : month.from, to: month.to, amountJpy: month.undatedAmountJpy, releasedOn: month.releasedOn };
137
+ });
138
+ }
139
+
140
+ function dayText(date: string, withYear = true): string {
141
+ const [year, month, day] = date.split("-").map(Number);
142
+ return `${day} ${MONTHS[month! - 1]}${withYear ? ` ${year}` : ""}`;
143
+ }
144
+
145
+ /** 22 Sep 2022, 21–24 Oct 2022, 29 Apr–1 May 2024, 29 Dec 2003–16 Jan 2004. */
146
+ function spanText(from: string, to: string, withYear = true): string {
147
+ if (from === to) return dayText(from, withYear);
148
+ if (from.slice(0, 7) === to.slice(0, 7)) return `${Number(from.slice(8))}–${dayText(to, withYear)}`;
149
+ return `${dayText(from, withYear && from.slice(0, 4) !== to.slice(0, 4))}–${dayText(to, withYear)}`;
150
+ }
151
+
152
+ /** ¥11,734.9 billion: the ministry's own unit and precision. */
153
+ function yenText(amountJpy: number): string {
154
+ return `¥${(amountJpy / 1e9).toLocaleString("en-US", { minimumFractionDigits: 1, maximumFractionDigits: 1 })} billion`;
155
+ }
156
+
157
+ /** ¥11.7tn, ¥780bn: short enough for a list or a chart caption. */
158
+ function yenShort(amountJpy: number): string {
159
+ return amountJpy >= 1e12 ? `¥${(amountJpy / 1e12).toFixed(1)}tn` : `¥${Math.round(amountJpy / 1e9).toLocaleString("en-US")}bn`;
160
+ }
161
+
162
+ /** Dollars sold for yen; the ministry's words when a side has no code. */
163
+ function directionText(run: Pick<FxInterventionRun, "sold" | "bought" | "pair">): string {
164
+ const sold = run.sold && CURRENCY_WORDS[run.sold], bought = run.bought && CURRENCY_WORDS[run.bought];
165
+ return sold && bought ? `${sold} sold for ${bought}` : run.pair;
166
+ }
167
+
168
+ const pairText = (pair: FxInterventionPair) => `${pair.base}/${pair.quote}`;
169
+ const runText = (run: FxInterventionRun) => (
170
+ `${spanText(run.from, run.to)}, ${yenText(run.amountJpy)} of ${directionText(run)}${run.days > 1 ? ` on ${run.days} days` : ""}`
171
+ );
172
+ const periodText = (total: UndatedTotal) => `from ${dayText(total.from, total.from.slice(0, 4) !== total.to.slice(0, 4))} to ${dayText(total.to)}`;
173
+ const releasedText = (total: UndatedTotal) => `a monthly total released ${dayText(total.releasedOn)}: its days and pair come with the quarterly release`;
174
+ /** The last day any release covers, a monthly one included. */
175
+ function recordsThrough(payload: FxInterventionsPayload): string | null {
176
+ return [payload.dailyThrough, ...payload.months.map((month) => month.to)].filter((date): date is string => !!date).sort().at(-1) ?? null;
177
+ }
178
+
179
+ /**
180
+ * `fx`'s note for a yen pair: the ministry's latest intervention in it, and
181
+ * for USD/JPY any monthly total its days have not been published for yet.
182
+ * Nothing for a pair it never intervened in and no undated total.
183
+ */
184
+ export function fxInterventionLatestNote(payload: FxInterventionsPayload, pair: FxInterventionPair): string | null {
185
+ const last = fxInterventionsIn(payload, pair).at(-1);
186
+ const undated = undatedTotals(payload, pair).at(-1);
187
+ if (!last && !undated) return null;
188
+ const through = recordsThrough(payload);
189
+ const sentences = [
190
+ ...undated ? [`Japan's Ministry of Finance reported ${yenText(undated.amountJpy)} of intervention ${periodText(undated)}, ${releasedText(undated)}.`] : [],
191
+ ...last ? [`${undated ? "Its last dated intervention" : "Japan's Ministry of Finance last intervened"} in ${pairText(pair)}: ${runText(last)}.`] : [],
192
+ ];
193
+ return `${sentences.join(" ")}${through ? ` Records through ${dayText(through)}.` : ""}`;
194
+ }
195
+
196
+ /** At most this many interventions are named in a window; older ones are counted. */
197
+ const NAMED_INTERVENTIONS = 6;
198
+
199
+ /**
200
+ * `history`'s note: the ministry's interventions in the pair between the
201
+ * first bar shown and the end of the last one's period, newest last, in short
202
+ * amounts, and for USD/JPY a monthly total in it whose days are not published
203
+ * yet. Nothing when the bars span none.
204
+ */
205
+ export function fxInterventionWindowNote(payload: FxInterventionsPayload, pair: FxInterventionPair, from: string, to: string): string | null {
206
+ const runs = fxInterventionsIn(payload, pair).filter((run) => run.to >= from && run.from <= to);
207
+ const undated = undatedTotals(payload, pair).filter((total) => total.to >= from && total.from <= to);
208
+ if (runs.length === 0 && undated.length === 0) return null;
209
+ const named = runs.slice(-NAMED_INTERVENTIONS);
210
+ const earlier = runs.length - named.length;
211
+ const sides = new Set(runs.map(fxInterventionSide));
212
+ const side = sides.size === 1 ? [...sides][0] : null;
213
+ const lead = side === "yen bought" ? "bought yen" : side === "yen sold" ? "sold yen" : "intervened";
214
+ const entry = (run: FxInterventionRun) => {
215
+ const own = side ? null : fxInterventionSide(run);
216
+ return `${spanText(run.from, run.to)} ${yenShort(run.amountJpy)}${own ? ` ${own}` : ""}`;
217
+ };
218
+ const sentences = [
219
+ ...named.length > 0 ? [`Japan's Ministry of Finance ${lead} in ${pairText(pair)} in these bars: ${named.map(entry).join("; ")}${
220
+ earlier > 0 ? `; and ${earlier} earlier from ${dayText(runs[0]!.from)}` : ""}.`] : [],
221
+ ...undated.map((total) => `${named.length > 0 ? "It also" : "Japan's Ministry of Finance"} reported ${yenShort(total.amountJpy)} ${periodText(total)}, ${releasedText(total)}.`),
222
+ ];
223
+ return sentences.join(" ");
224
+ }
225
+
226
+ /** A chart marker for one intervention, or for a total its days are not published for yet. */
227
+ export interface FxInterventionMarker {
228
+ id: string;
229
+ date: string;
230
+ /** A total's last day: it is drawn from its first day to here. */
231
+ endDate?: string;
232
+ /** Its caption, longest first: the `MoF` prefix goes first when room is short, never the dates. */
233
+ captions: string[];
234
+ /** A total with no day yet: drawn dotted across its period. */
235
+ undated: boolean;
236
+ amountJpy: number;
237
+ side: FxInterventionSide | null;
238
+ }
239
+
240
+ const PAIR_NOT_PUBLISHED = "pair not yet published";
241
+
242
+ /** The pair's interventions, then for USD/JPY any total without days, as chart markers. */
243
+ export function fxInterventionMarkers(payload: FxInterventionsPayload, pair: FxInterventionPair): FxInterventionMarker[] {
244
+ return [
245
+ ...fxInterventionsIn(payload, pair).map((run): FxInterventionMarker => {
246
+ const amount = yenShort(run.amountJpy), side = fxInterventionSide(run);
247
+ const told = side ? `${amount} ${side}` : amount;
248
+ return {
249
+ id: `mof:${run.from}:${run.sold}:${run.bought}`, date: run.from, captions: [...new Set([`MoF ${told}`, told, amount])],
250
+ undated: false, amountJpy: run.amountJpy, side,
251
+ };
252
+ }),
253
+ ...undatedTotals(payload, pair).map((total): FxInterventionMarker => {
254
+ const dated = `${yenShort(total.amountJpy)} ${spanText(total.from, total.to, false)}`;
255
+ return {
256
+ id: `mof:${total.from}:${total.to}`, date: total.from, endDate: total.to,
257
+ captions: [`MoF ${dated}, ${PAIR_NOT_PUBLISHED}`, `${dated}, ${PAIR_NOT_PUBLISHED}`, dated],
258
+ undated: true, amountJpy: total.amountJpy, side: null,
259
+ };
260
+ }),
261
+ ];
262
+ }
263
+
264
+ /** One caption for markers too close to caption apart: their sum and count, and the side when they share one. */
265
+ export function fxInterventionSharedCaptions(markers: readonly FxInterventionMarker[]): string[] {
266
+ const total = `${yenShort(markers.reduce((sum, marker) => sum + marker.amountJpy, 0))} ×${markers.length}`;
267
+ const sides = new Set(markers.map((marker) => marker.side));
268
+ const side = sides.size === 1 ? [...sides][0] : null;
269
+ return side ? [`MoF ${total} ${side}`, `${total} ${side}`, total] : [`MoF ${total}`, total];
270
+ }
@@ -89,8 +89,8 @@ const INDEX_CALENDAR_VENUES: Readonly<Record<string, string>> = {
89
89
  "CHICAGO OPTIONS": "CBOE",
90
90
  };
91
91
 
92
- /** The venue whose published calendar dates the quote's sessions. */
93
- function calendarVenue(quote: Quote): string {
92
+ /** The venue whose published calendar dates the quote's sessions, and whose zone dates its daily bars. */
93
+ export function calendarVenue(quote: Quote): string {
94
94
  const venue = quoteVenue(quote);
95
95
  const index = classifyInstrumentType(quote.instrumentType) === "index" || kindFromListingSyntax(quote.symbol) === "index";
96
96
  return (index && INDEX_CALENDAR_VENUES[venue]) || venue;
@@ -5,19 +5,38 @@ import { canonicalExchange } from "../../utils/exchanges";
5
5
  import { logFailure } from "../../utils/log-failure";
6
6
  import { dailyBarDate } from "../../utils/price-history";
7
7
  import { classifyInstrumentType } from "../../tickers/instrument-kind";
8
- import { changeBasisSessionDate, isChangeBasisDatedWithoutCloses, quoteChangeBasis } from "./change-basis";
8
+ import { calendarVenue, changeBasisSessionDate, isChangeBasisDatedWithoutCloses, quoteChangeBasis } from "./change-basis";
9
+ import { cleanFloat32Price } from "../../utils/float32-price";
9
10
 
10
11
  /** History closes come as float32 (30.93000030517578) where the quote says 30.93: one close. */
11
12
  const SAME_CLOSE_RELATIVE = 1e-5;
12
13
  /**
13
- * How long a reading that named no day stands before the closes are read
14
- * again: a history a session behind catches up, a failed read is retried.
14
+ * An index's previous close and its daily close of that day closer than this,
15
+ * as a share of the close, are one close told twice (a feed that rounds to a
16
+ * decimal): a hundredth of a percent, the precision a day change is shown to.
17
+ */
18
+ const SAME_INDEX_CLOSE_RELATIVE = 1e-4;
19
+ /**
20
+ * How long a reading that named no day, or corrected an index's close,
21
+ * stands before the closes are read again: a history a session behind
22
+ * catches up, a failed read is retried, a correction is checked again.
15
23
  */
16
24
  const UNDATED_RETRY_MS = 10 * 60_000;
17
25
  /** Readings kept at once; the oldest goes first. */
18
26
  const MAX_READINGS = 2_000;
19
27
  /** Daily histories read at once. */
20
28
  const MAX_READS_IN_FLIGHT = 6;
29
+ /**
30
+ * Index checks read at once, in a pool of their own: a board of the world's
31
+ * indices (`fn WEI`) checks two dozen at the same time, each one small read.
32
+ */
33
+ const MAX_INDEX_READS_IN_FLIGHT = 32;
34
+ /**
35
+ * The longest a caller waits for an index check. Gloom Cloud measures an
36
+ * index's move from its previous session's bar already: this check stands
37
+ * behind it, so it must never make a board of indices slow.
38
+ */
39
+ const INDEX_CHECK_WAIT_MS = 300;
21
40
  /** How long one read may take before its slot goes to the next: a hung read must not stall the rest. */
22
41
  const READ_DEADLINE_MS = 10_000;
23
42
 
@@ -28,8 +47,9 @@ export interface DatedCloseListing {
28
47
  context?: MarketDataRequestContext;
29
48
  }
30
49
 
31
- /** A listing's recent daily closes (a month is enough). */
32
- export type ReadDailyCloses = (listing: DatedCloseListing) => Promise<readonly Pick<PricePoint, "date" | "close">[]>;
50
+ /** A listing's recent daily closes (a month is enough), with the flags that say a bar had not closed yet. */
51
+ export type ReadDailyCloses = (listing: DatedCloseListing) => Promise<readonly DailyClose[]>;
52
+ type DailyClose = Pick<PricePoint, "date" | "close" | "partial" | "unsettled">;
33
53
 
34
54
  export interface PreviousCloseDatesOptions {
35
55
  /** Called with the latest copy of a quote, dated, when a read lands that names its day. */
@@ -37,10 +57,17 @@ export interface PreviousCloseDatesOptions {
37
57
  now?: () => number;
38
58
  maxReadsInFlight?: number;
39
59
  readDeadlineMs?: number;
60
+ /** The longest `settle` waits for index checks (INDEX_CHECK_WAIT_MS). */
61
+ indexWaitMs?: number;
40
62
  }
41
63
 
42
64
  interface Reading {
43
65
  date: string | null;
66
+ /**
67
+ * The listing's daily close on `date`, when the quote's own previous close
68
+ * disagrees with it: an index's, whose move is then measured from it.
69
+ */
70
+ close?: number;
44
71
  at: number;
45
72
  }
46
73
 
@@ -54,74 +81,153 @@ function sameClose(left: number, right: number): boolean {
54
81
  }
55
82
 
56
83
  /**
57
- * What dates a quote's previous close by its listing's daily closes: the
58
- * listing, the session the move is dated to and the close itself. Null for a
59
- * quote something else dates (its venue's calendar, a coin's UTC day, a
60
- * future's terms, a close the source dated), one with no move from a previous
61
- * close, and an option, whose chain would read a history per contract. The
62
- * venue's calendar is checked first, since this runs on every tick.
84
+ * What dates a quote's previous close by its listing's daily closes, or
85
+ * checks an index's dated one against them: the listing, the session the
86
+ * move is dated to and the close itself. Null for any other quote something
87
+ * else dates (its venue's calendar, a coin's UTC day, a future's terms, a
88
+ * close the source dated), one with no move from a previous close, and an
89
+ * option, whose chain would read a history per contract. The instrument type
90
+ * and the venue's calendar are checked first, since this runs on every tick.
63
91
  */
64
92
  function readingKey(quote: Quote | null | undefined, listing: DatedCloseListing, now: number): string | null {
65
- if (!quote || isChangeBasisDatedWithoutCloses(quote, now) || classifyInstrumentType(quote.instrumentType) === "option") return null;
93
+ if (!quote || classifyInstrumentType(quote.instrumentType) === "option") return null;
94
+ // An index's dated close is checked against its daily close of that day as well (indexCloseOn), but for a Cboe
95
+ // index's, which Gloom Cloud checks against Cboe's own closes.
96
+ if (datedIndexClose(quote)) return calendarVenue(quote) === "CBOE" ? null : datedReadingKey(quote, listing);
97
+ if (isChangeBasisDatedWithoutCloses(quote, now)) return null;
66
98
  if (quoteChangeBasis(quote)?.kind !== "previous close") return null;
99
+ return datedReadingKey(quote, listing);
100
+ }
101
+
102
+ function datedReadingKey(quote: Quote, listing: DatedCloseListing): string | null {
67
103
  const previousClose = quote.previousClose;
68
104
  const sessionDate = changeBasisSessionDate(quote);
69
105
  if (previousClose == null || !Number.isFinite(previousClose) || !sessionDate) return null;
70
106
  return `${datedCloseListingKey(listing)}|${sessionDate}|${previousClose}`;
71
107
  }
72
108
 
109
+ /**
110
+ * The closed daily bars of a history, dated where the listing trades: by the
111
+ * venue whose calendar its sessions follow (HKSE's bars by HKEX's zone, not
112
+ * UTC). A bar whose period had not ended when it was served (`partial`), or a
113
+ * future's session awaiting settlement, is no close: a copy kept from the
114
+ * session before (a US holiday) must never stand for that session's close.
115
+ */
116
+ function closedBars(points: readonly DailyClose[], quote: Quote): Array<{ date: string; close: number }> {
117
+ const venue = calendarVenue(quote);
118
+ return points.flatMap((point) => {
119
+ const time = new Date(point.date).getTime();
120
+ if (point.partial || point.unsettled || !Number.isFinite(time) || !Number.isFinite(point.close)) return [];
121
+ return [{ date: dailyBarDate(time, venue), close: point.close }];
122
+ });
123
+ }
124
+
73
125
  /**
74
126
  * The day of the latest daily close before the move's session, when that
75
127
  * close is the quote's previous close; null otherwise, so a gap in the
76
128
  * history never names the wrong day.
77
129
  */
78
- function latestCloseBefore(points: readonly Pick<PricePoint, "date" | "close">[], quote: Quote): string | null {
130
+ function latestCloseBefore(points: readonly DailyClose[], quote: Quote): string | null {
79
131
  const sessionDate = changeBasisSessionDate(quote)!;
80
- const exchange = quote.listingExchangeName ?? quote.exchangeName ?? "";
81
- const before = points
82
- .map((point) => ({ time: new Date(point.date).getTime(), close: point.close }))
83
- .filter((point) => Number.isFinite(point.time) && Number.isFinite(point.close))
84
- .map((point) => ({ date: dailyBarDate(point.time, exchange), close: point.close }))
132
+ const before = closedBars(points, quote)
85
133
  .filter((point) => point.date < sessionDate)
86
134
  .sort((left, right) => left.date.localeCompare(right.date))
87
135
  .at(-1);
88
136
  return before && sameClose(before.close, quote.previousClose!) ? before.date : null;
89
137
  }
90
138
 
139
+ /**
140
+ * The day an index quote's move is measured from, when something dates it
141
+ * (its venue's calendar, the sessions its source sent): the day whose close
142
+ * its previous close must be. Null for any other quote.
143
+ */
144
+ function datedIndexClose(quote: Quote): string | null {
145
+ if (classifyInstrumentType(quote.instrumentType) !== "index") return null;
146
+ const basis = quoteChangeBasis(quote);
147
+ return basis?.kind === "close" ? basis.date : null;
148
+ }
149
+
150
+ /**
151
+ * An index's previous close is its previous session's
152
+ * close: the listing's daily close on the day its move is dated from, when
153
+ * the closes hold that day. On Fri 6 Nov 2026 a source's quote of the Hang
154
+ * Seng said 23,919.5, Wed 4 Nov's close, "vs Thu 5 Nov close", while its daily
155
+ * close of Thu 5 Nov, the one HP charts, was 24,796.98: +2.35% beside -1.27%.
156
+ * The reading names the day either way, and the close when it disagrees.
157
+ */
158
+ function indexCloseOn(points: readonly DailyClose[], quote: Quote, date: string): { date: string | null; close?: number } {
159
+ const bar = closedBars(points, quote).findLast((point) => point.close > 0 && point.date === date);
160
+ if (!bar) return { date: null };
161
+ // Bars come as float32 (24796.98046875): the close is the decimal it is, as Gloom Cloud serves it.
162
+ const close = cleanFloat32Price(bar.close);
163
+ const previousClose = quote.previousClose!;
164
+ return Math.abs(previousClose - close) <= close * SAME_INDEX_CLOSE_RELATIVE ? { date } : { date, close };
165
+ }
166
+
167
+ function readingOf(points: readonly DailyClose[], quote: Quote): { date: string | null; close?: number } {
168
+ const indexDate = datedIndexClose(quote);
169
+ return indexDate ? indexCloseOn(points, quote, indexDate) : { date: latestCloseBefore(points, quote) };
170
+ }
171
+
91
172
  function withDate<T extends Quote | null | undefined>(quote: T, date: string | null | undefined): T {
92
173
  return date && quote ? { ...quote, previousCloseDate: date } : quote;
93
174
  }
94
175
 
176
+ /** The quote as a reading has it: dated, and for an index measured from that day's close when its own disagrees. */
177
+ function withReading<T extends Quote | null | undefined>(quote: T, reading: Pick<Reading, "date" | "close"> | undefined): T {
178
+ if (!quote || !reading?.date) return quote;
179
+ if (reading.close == null) return withDate(quote, reading.date);
180
+ const close = reading.close;
181
+ const change = quote.price - close;
182
+ // A completed session's move of the same day is measured from it too: getRegularSessionDisplay rebuilds it.
183
+ const sameSession = quote.regularCloseSessionDate != null && quote.regularCloseSessionDate === quote.changeSessionDate;
184
+ return {
185
+ ...quote,
186
+ previousClose: close,
187
+ previousCloseDate: reading.date,
188
+ change,
189
+ changePercent: (change / close) * 100,
190
+ ...(sameSession ? { regularChange: undefined, regularChangePercent: undefined } : {}),
191
+ };
192
+ }
193
+
95
194
  /**
96
195
  * Dates the previous close a quote's move is from where the venue's calendar
97
196
  * cannot (LSE and Helsinki publish none the app carries), by the listing's
98
197
  * own daily closes, so every surface that reads quotes through the app's
99
- * quote router names the day (`quoteChangeBasis`). The closes are read once
198
+ * quote router names the day (`quoteChangeBasis`), and an index's move is
199
+ * measured from its previous session's close (indexCloseOn). The closes are read once
100
200
  * per listing, session and close, and the answer is kept: a refresh, a tick
101
201
  * or a cached read of the same quote is dated without another read. A few
102
- * reads run at once, each for at most ten seconds.
202
+ * reads run at once, each for at most ten seconds; index checks run in a
203
+ * wider pool of their own.
103
204
  */
104
205
  export class PreviousCloseDates {
105
206
  private readonly readings = new Map<string, Reading>();
106
- private readonly pending = new Map<string, Promise<string | null>>();
207
+ private readonly pending = new Map<string, Promise<Pick<Reading, "date" | "close">>>();
107
208
  /** The latest copy of each quote a read is pending for, which the read dates when it lands. */
108
209
  private readonly latestCopies = new Map<string, { quote: Quote; listing: DatedCloseListing }>();
109
- private readonly waiting: Array<() => void> = [];
110
- private active = 0;
210
+ /** Dating reads and index checks queue apart, so neither waits behind the other. */
211
+ private readonly pools: Record<"dating" | "index", { active: number; waiting: Array<() => void>; max: number }>;
111
212
  private readonly now: () => number;
112
- private readonly maxReadsInFlight: number;
113
213
  private readonly readDeadlineMs: number;
214
+ private readonly indexWaitMs: number;
114
215
 
115
216
  constructor(private readonly readCloses: ReadDailyCloses, private readonly options: PreviousCloseDatesOptions = {}) {
116
217
  this.now = options.now ?? (() => Date.now());
117
- this.maxReadsInFlight = options.maxReadsInFlight ?? MAX_READS_IN_FLIGHT;
218
+ const max = options.maxReadsInFlight ?? MAX_READS_IN_FLIGHT;
219
+ this.pools = {
220
+ dating: { active: 0, waiting: [], max },
221
+ index: { active: 0, waiting: [], max: Math.max(max, MAX_INDEX_READS_IN_FLIGHT) },
222
+ };
118
223
  this.readDeadlineMs = options.readDeadlineMs ?? READ_DEADLINE_MS;
224
+ this.indexWaitMs = options.indexWaitMs ?? INDEX_CHECK_WAIT_MS;
119
225
  }
120
226
 
121
227
  /** The quote dated by what was already read for it; as it was when nothing was. Never reads. */
122
228
  known<T extends Quote | null | undefined>(quote: T, listing: DatedCloseListing): T {
123
229
  const key = readingKey(quote, listing, this.now());
124
- return key ? withDate(quote, this.readings.get(key)?.date) : quote;
230
+ return key ? withReading(quote, this.readings.get(key)) : quote;
125
231
  }
126
232
 
127
233
  /**
@@ -134,70 +240,80 @@ export class PreviousCloseDates {
134
240
  if (!key) return quote;
135
241
  const reading = this.readings.get(key);
136
242
  if (!this.stands(reading)) void this.start(key, quote!, listing);
137
- return withDate(quote, reading?.date);
243
+ return withReading(quote, reading);
138
244
  }
139
245
 
140
246
  /**
141
247
  * Starts the reads these quotes need and waits for them, at most `waitMs`
142
248
  * in all and no longer than `signal` lets it; `known` then dates them.
249
+ * Index checks run side by side and are waited for at most `indexWaitMs`.
143
250
  */
144
251
  async settle(
145
252
  entries: ReadonlyArray<{ quote: Quote; listing: DatedCloseListing }>,
146
253
  { waitMs, signal }: { waitMs: number; signal?: AbortSignal },
147
254
  ): Promise<void> {
148
255
  if (signal?.aborted) return;
149
- const reads: Promise<string | null>[] = [];
256
+ const reads: Promise<unknown>[] = [];
257
+ const checks: Promise<unknown>[] = [];
150
258
  for (const { quote, listing } of entries) {
151
259
  const key = readingKey(quote, listing, this.now());
152
- if (key && !this.stands(this.readings.get(key))) reads.push(this.start(key, quote, listing));
260
+ if (key && !this.stands(this.readings.get(key))) (datedIndexClose(quote) ? checks : reads).push(this.start(key, quote, listing));
153
261
  }
154
- if (reads.length) await settleWithin(abortable(Promise.all(reads), signal, "Stopped waiting for daily closes"), waitMs);
262
+ const within = (all: Promise<unknown>[], ms: number) => all.length
263
+ ? settleWithin(abortable(Promise.all(all), signal, "Stopped waiting for daily closes"), ms) : null;
264
+ await Promise.all([within(reads, waitMs), within(checks, Math.min(waitMs, this.indexWaitMs))]);
155
265
  }
156
266
 
157
- /** Whether a reading answers without another read: a day it named, or no day named lately. */
267
+ /**
268
+ * Whether a reading answers without another read: a day it named that
269
+ * agreed with the quote's close, or any other reading taken lately. A
270
+ * correction (an index's close the quote disagreed with) is read again as
271
+ * an undated one is, so a wrong close cannot stand for the session.
272
+ */
158
273
  private stands(reading: Reading | undefined): boolean {
159
- return !!reading && (!!reading.date || this.now() - reading.at < UNDATED_RETRY_MS);
274
+ return !!reading && ((!!reading.date && reading.close == null) || this.now() - reading.at < UNDATED_RETRY_MS);
160
275
  }
161
276
 
162
- private start(key: string, quote: Quote, listing: DatedCloseListing): Promise<string | null> {
277
+ private start(key: string, quote: Quote, listing: DatedCloseListing): Promise<Pick<Reading, "date" | "close">> {
163
278
  this.latestCopies.set(key, { quote, listing });
164
279
  return this.pending.get(key) ?? this.read(key, quote, listing);
165
280
  }
166
281
 
167
- private read(key: string, quote: Quote, listing: DatedCloseListing): Promise<string | null> {
168
- const read = this.inSlot(() => withDeadline(Promise.resolve().then(() => this.readCloses(listing)), this.readDeadlineMs, "Reading daily closes timed out"))
169
- .then((points) => latestCloseBefore(points, quote))
170
- .catch(logFailure("market-data.dated-previous-close", "Read daily closes failed", null))
171
- .then((date) => {
282
+ private read(key: string, quote: Quote, listing: DatedCloseListing): Promise<Pick<Reading, "date" | "close">> {
283
+ const read = this.inSlot(datedIndexClose(quote) ? "index" : "dating", () => withDeadline(Promise.resolve().then(() => this.readCloses(listing)), this.readDeadlineMs, "Reading daily closes timed out"))
284
+ .then((points) => readingOf(points, quote))
285
+ .catch(logFailure("market-data.dated-previous-close", "Read daily closes failed", { date: null }))
286
+ .then((reading) => {
172
287
  this.pending.delete(key);
173
288
  this.readings.delete(key);
174
289
  if (this.readings.size >= MAX_READINGS) this.readings.delete(this.readings.keys().next().value!);
175
- this.readings.set(key, { date, at: this.now() });
290
+ this.readings.set(key, { ...reading, at: this.now() });
176
291
  const latest = this.latestCopies.get(key);
177
292
  this.latestCopies.delete(key);
178
- if (date && latest && this.options.onDated) {
293
+ if (reading.date && latest && this.options.onDated) {
179
294
  try {
180
- this.options.onDated(latest.listing, withDate(latest.quote, date));
295
+ this.options.onDated(latest.listing, withReading(latest.quote, reading));
181
296
  } catch (error) {
182
297
  logFailure("market-data.dated-previous-close", "Passing on a dated quote failed")(error);
183
298
  }
184
299
  }
185
- return date;
300
+ return reading;
186
301
  });
187
302
  this.pending.set(key, read);
188
303
  return read;
189
304
  }
190
305
 
191
- private async inSlot<T>(work: () => Promise<T>): Promise<T> {
192
- if (this.active < this.maxReadsInFlight) this.active += 1;
193
- else await new Promise<void>((resolve) => this.waiting.push(resolve));
306
+ private async inSlot<T>(kind: "dating" | "index", work: () => Promise<T>): Promise<T> {
307
+ const pool = this.pools[kind];
308
+ if (pool.active < pool.max) pool.active += 1;
309
+ else await new Promise<void>((resolve) => pool.waiting.push(resolve));
194
310
  try {
195
311
  return await work();
196
312
  } finally {
197
313
  // A finished read hands its slot to the next one waiting.
198
- const next = this.waiting.shift();
314
+ const next = pool.waiting.shift();
199
315
  if (next) next();
200
- else this.active -= 1;
316
+ else pool.active -= 1;
201
317
  }
202
318
  }
203
319
  }