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,187 @@
1
+ import type { FloatingPaneEntry, LayoutConfig } from "../../types/config";
2
+ import { compactFloatingZ, maxFloatingZ } from "./floating";
3
+ import { detachPane, finalizeLayout } from "./layout-state";
4
+
5
+ /**
6
+ * Floating windows stacked as tabs: the members share a `stack` key and one
7
+ * rect, in the order the layout lists them, and the one in front (highest z,
8
+ * the later one of equals) is the tab shown. Raising a member (a click on its
9
+ * tab, focus) shows it; moving or resizing the stack moves every member
10
+ * (`floatAtRect`). A key with one member left is dropped when the layout is
11
+ * finalized.
12
+ */
13
+
14
+ /** The members of the stack `instanceId` floats in, in tab order; empty when it floats alone. */
15
+ export function floatingStackMembers(floating: readonly FloatingPaneEntry[], instanceId: string): FloatingPaneEntry[] {
16
+ const entry = floating.find((candidate) => candidate.instanceId === instanceId);
17
+ if (!entry?.stack) return [];
18
+ const members = floating.filter((candidate) => candidate.stack === entry.stack);
19
+ return members.length > 1 ? members : [];
20
+ }
21
+
22
+ /** The member a stack shows: the one in front. */
23
+ function shownStackMember(members: readonly FloatingPaneEntry[]): FloatingPaneEntry | undefined {
24
+ let shown: FloatingPaneEntry | undefined;
25
+ for (const member of members) {
26
+ if (!shown || (member.zIndex ?? 50) >= (shown.zIndex ?? 50)) shown = member;
27
+ }
28
+ return shown;
29
+ }
30
+
31
+ /**
32
+ * Every floating stack, by the pane it shows, with its tabs in order. A list
33
+ * sorted some other way (front to back) takes the layout's list as `order`.
34
+ */
35
+ export function floatingStacks(
36
+ floating: readonly FloatingPaneEntry[],
37
+ order?: readonly { instanceId: string }[],
38
+ ): Map<string, string[]> {
39
+ const rank = order ? new Map(order.map((entry, index) => [entry.instanceId, index])) : null;
40
+ const byKey = new Map<string, FloatingPaneEntry[]>();
41
+ for (const entry of floating) {
42
+ if (!entry.stack) continue;
43
+ const members = byKey.get(entry.stack) ?? [];
44
+ members.push(entry);
45
+ byKey.set(entry.stack, members);
46
+ }
47
+ const stacks = new Map<string, string[]>();
48
+ for (const members of byKey.values()) {
49
+ if (members.length < 2) continue;
50
+ const tabs = rank ? [...members].sort((a, b) => (rank.get(a.instanceId) ?? 0) - (rank.get(b.instanceId) ?? 0)) : members;
51
+ stacks.set(shownStackMember(members)!.instanceId, tabs.map((member) => member.instanceId));
52
+ }
53
+ return stacks;
54
+ }
55
+
56
+ /**
57
+ * Floating entries as a saved layout may hold them, made whole: a `stack`
58
+ * key that is not a non-empty string, or that one entry alone has, is
59
+ * dropped, and every member of a stack takes the rect of the tab it shows.
60
+ * A client that does not know stacks keeps the key but draws each member as
61
+ * a window of its own, so it may have moved them apart.
62
+ */
63
+ export function alignFloatingStacks<T extends FloatingPaneEntry>(floating: readonly T[]): T[] {
64
+ const byKey = new Map<string, T[]>();
65
+ for (const entry of floating) {
66
+ if (typeof entry.stack !== "string" || entry.stack.length === 0) continue;
67
+ byKey.set(entry.stack, [...(byKey.get(entry.stack) ?? []), entry]);
68
+ }
69
+ const rects = new Map<string, Pick<FloatingPaneEntry, "x" | "y" | "width" | "height">>();
70
+ for (const [key, members] of byKey) {
71
+ if (members.length < 2) continue;
72
+ const { x, y, width, height } = shownStackMember(members)!;
73
+ rects.set(key, { x, y, width, height });
74
+ }
75
+ return floating.map((entry) => {
76
+ const rect = typeof entry.stack === "string" ? rects.get(entry.stack) : undefined;
77
+ if (rect) return { ...entry, ...rect };
78
+ if (!("stack" in entry)) return entry;
79
+ const { stack: _stack, ...rest } = entry;
80
+ return rest as T;
81
+ });
82
+ }
83
+
84
+ /** The floating panes behind the tab their stack shows. */
85
+ export function hiddenFloatingTabIds(floating: readonly FloatingPaneEntry[]): Set<string> {
86
+ const hidden = new Set<string>();
87
+ for (const [shown, members] of floatingStacks(floating)) {
88
+ for (const id of members) if (id !== shown) hidden.add(id);
89
+ }
90
+ return hidden;
91
+ }
92
+
93
+ /**
94
+ * A key no stack has yet, for a stack `instanceId` starts: its own id unless
95
+ * that is taken. A tab pulled out of a stack leaves the key with the tabs
96
+ * that stay, so the id of the window that started a stack may still name it.
97
+ */
98
+ function newStackKey(floating: readonly FloatingPaneEntry[], instanceId: string): string {
99
+ const taken = new Set(floating.flatMap((entry) => (entry.stack ? [entry.stack] : [])));
100
+ let key = instanceId;
101
+ for (let n = 2; taken.has(key); n += 1) key = `${instanceId}#${n}`;
102
+ return key;
103
+ }
104
+
105
+ /**
106
+ * `draggedId` as the last tab of the floating window `targetId` (or its
107
+ * stack), shown, at its rect. The dragged pane leaves wherever it was: the
108
+ * dock, another stack, a floating spot of its own.
109
+ */
110
+ export function stackFloatingOnto(layout: LayoutConfig, draggedId: string, targetId: string): LayoutConfig {
111
+ if (draggedId === targetId) return layout;
112
+ const target = layout.floating.find((entry) => entry.instanceId === targetId);
113
+ if (!target) return layout;
114
+ const key = target.stack ?? newStackKey(layout.floating, target.instanceId);
115
+ const base = detachPane(layout, draggedId);
116
+ const floating = base.floating.map((entry) => (entry.instanceId === targetId ? { ...entry, stack: key } : entry));
117
+ floating.push({
118
+ instanceId: draggedId,
119
+ x: target.x,
120
+ y: target.y,
121
+ width: target.width,
122
+ height: target.height,
123
+ zIndex: maxFloatingZ(layout) + 1,
124
+ stack: key,
125
+ });
126
+ return finalizeLayout({ ...base, floating: compactFloatingZ(floating) });
127
+ }
128
+
129
+ /** `instanceId` out of its floating stack, where it is, the others left as they are. */
130
+ export function unstackFloating(layout: LayoutConfig, instanceId: string): LayoutConfig {
131
+ const entry = layout.floating.find((candidate) => candidate.instanceId === instanceId);
132
+ if (!entry?.stack) return layout;
133
+ return finalizeLayout({
134
+ ...layout,
135
+ floating: layout.floating.map((candidate) => {
136
+ if (candidate.instanceId !== instanceId) return candidate;
137
+ const { stack: _stack, ...rest } = candidate;
138
+ return rest;
139
+ }),
140
+ });
141
+ }
142
+
143
+ export type FloatingSplitSide = "left" | "right" | "top" | "bottom";
144
+
145
+ /** The two halves of `rect` a split on `side` makes: the dropped window's, then the target's. */
146
+ export function floatingSplitRects(
147
+ rect: { x: number; y: number; width: number; height: number },
148
+ side: FloatingSplitSide,
149
+ ): [{ x: number; y: number; width: number; height: number }, { x: number; y: number; width: number; height: number }] {
150
+ const { x, y, width, height } = rect;
151
+ if (side === "left" || side === "right") {
152
+ const half = width / 2;
153
+ const left = { x, y, width: half, height };
154
+ const right = { x: x + half, y, width: width - half, height };
155
+ return side === "left" ? [left, right] : [right, left];
156
+ }
157
+ const half = height / 2;
158
+ const top = { x, y, width, height: half };
159
+ const bottom = { x, y: y + half, width, height: height - half };
160
+ return side === "top" ? [top, bottom] : [bottom, top];
161
+ }
162
+
163
+ /**
164
+ * `draggedId` beside the floating window `targetId` on `side`, sharing its
165
+ * rect: each takes half, edge to edge, so their shared edge resizes both.
166
+ * The target's stack, if it is one, keeps its tabs and takes its half whole.
167
+ */
168
+ export function splitFloating(layout: LayoutConfig, draggedId: string, targetId: string, side: FloatingSplitSide): LayoutConfig {
169
+ if (draggedId === targetId) return layout;
170
+ const target = layout.floating.find((entry) => entry.instanceId === targetId);
171
+ if (!target) return layout;
172
+ const [dropped, kept] = floatingSplitRects(target, side);
173
+ const base = finalizeLayout(detachPane(layout, draggedId));
174
+ const resized = finalizeLayout({
175
+ ...base,
176
+ floating: base.floating.map((entry) => (
177
+ entry.instanceId === targetId || (target.stack && entry.stack === target.stack) ? { ...entry, ...kept } : entry
178
+ )),
179
+ });
180
+ return finalizeLayout({
181
+ ...resized,
182
+ floating: compactFloatingZ([
183
+ ...resized.floating,
184
+ { instanceId: draggedId, ...dropped, zIndex: maxFloatingZ(resized) + 1 },
185
+ ]),
186
+ });
187
+ }
@@ -89,9 +89,11 @@ const FLOATING_PANE_BASE_Z = 50;
89
89
  * pair at `under` and `over`: on the desktop the landing preview under the
90
90
  * pane on the move (lifted to `over` while it is over a target, or its outline
91
91
  * when it was docked); in the terminal, which cannot see through a pane, the
92
- * docked pane's outline under the landing outline.
92
+ * docked pane's outline under the landing outline. The drop targets a move
93
+ * offers (the target on the pane under the pointer, the strips along the
94
+ * window's edges) sit over both, at `targets`.
93
95
  */
94
- export const SHELL_DRAG_Z = { under: 95, over: 96 } as const;
96
+ export const SHELL_DRAG_Z = { under: 95, over: 96, targets: 97 } as const;
95
97
 
96
98
  /** The lowest of the shell's fixed overlays over every pane. */
97
99
  const SHELL_PREVIEW_Z = SHELL_DRAG_Z.under;
@@ -1,5 +1,6 @@
1
1
  import type { DockLayoutNode, FloatingPaneEntry, LayoutConfig } from "../../types/config";
2
2
  import { buildDockStack, isDockStack } from "./dock-stack";
3
+ import { floatingStacks, hiddenFloatingTabIds } from "./floating-stack";
3
4
  import type { AppNotificationRequest } from "../../types/plugin";
4
5
  import {
5
6
  boundsForRects,
@@ -97,6 +98,17 @@ export function shouldShowTidyWindows(layout: LayoutConfig): boolean {
97
98
  || analyzeFloatingPaneVisibility(layout).some((pane) => pane.buried);
98
99
  }
99
100
 
101
+ /**
102
+ * Whether a screen of `size` cells holds panes side by side and one above
103
+ * another: as wide as Tidy tiles a grid at, and as tall as two rows of panes
104
+ * that each show a screen of rows. A phone holds no grid, upright or on its
105
+ * side, so a workspace made for one (the web's first visit) comes there as
106
+ * one stack of tabs instead.
107
+ */
108
+ export function holdsPaneGrid(size: { width: number; height: number }): boolean {
109
+ return size.width >= NARROW_TIDY_WIDTH && size.height >= NARROW_TIDY_MIN_ROWS * 2;
110
+ }
111
+
100
112
  function withStacks(node: DockLayoutNode | null, stacks: ReadonlyMap<string, readonly string[]>): DockLayoutNode | null {
101
113
  if (!node || stacks.size === 0) return node;
102
114
  if (node.kind === "pane") {
@@ -154,7 +166,10 @@ export function gridlockAllPanes(
154
166
  const dockedRects: GridlockRect[] = leaves.map((leaf) => ({ instanceId: leaf.instanceId, ...leaf.rect }));
155
167
  // A stack is tiled as the tab it shows and keeps its other tabs.
156
168
  const stacks = new Map(leaves.flatMap((leaf) => (leaf.stack ? [[leaf.instanceId, leaf.stack] as const] : [])));
157
- const floatingRects: GridlockRect[] = visibleLayout.floating.map((entry) => ({
169
+ // A floating stack is tiled as the tab it shows, and keeps its tabs as a docked stack.
170
+ for (const [shown, members] of floatingStacks(visibleLayout.floating)) stacks.set(shown, members);
171
+ const hiddenTabs = hiddenFloatingTabIds(visibleLayout.floating);
172
+ const floatingRects: GridlockRect[] = visibleLayout.floating.filter((entry) => !hiddenTabs.has(entry.instanceId)).map((entry) => ({
158
173
  instanceId: entry.instanceId,
159
174
  x: entry.x,
160
175
  y: entry.y,
@@ -54,6 +54,17 @@ export {
54
54
  swapPanes,
55
55
  } from "./docking";
56
56
 
57
+ export {
58
+ floatingSplitRects,
59
+ floatingStackMembers,
60
+ floatingStacks,
61
+ hiddenFloatingTabIds,
62
+ splitFloating,
63
+ stackFloatingOnto,
64
+ unstackFloating,
65
+ type FloatingSplitSide,
66
+ } from "./floating-stack";
67
+
57
68
  export { restoreHiddenPanes } from "./hidden-panes";
58
69
  export {
59
70
  removeFloatingPanes,
@@ -27,14 +27,21 @@ function normalizeFloatingEntries(layout: LayoutConfig): FloatingPaneEntry[] {
27
27
  const dockedIds = new Set(getDockedInstanceIds(layout.dockRoot));
28
28
  const detachedIds = new Set((layout.detached ?? []).map((entry) => entry.instanceId));
29
29
  const seen = new Set<string>();
30
- return layout.floating
30
+ const kept = layout.floating
31
31
  .filter((entry) => !dockedIds.has(entry.instanceId) && !detachedIds.has(entry.instanceId))
32
32
  .filter((entry) => {
33
33
  if (seen.has(entry.instanceId)) return false;
34
34
  seen.add(entry.instanceId);
35
35
  return true;
36
- })
37
- .map((entry) => ({ ...entry }));
36
+ });
37
+ // A floating stack left with one tab is a window of its own again.
38
+ const stackSizes = new Map<string, number>();
39
+ for (const entry of kept) if (entry.stack) stackSizes.set(entry.stack, (stackSizes.get(entry.stack) ?? 0) + 1);
40
+ return kept.map((entry) => {
41
+ if (!entry.stack || (stackSizes.get(entry.stack) ?? 0) > 1) return { ...entry };
42
+ const { stack: _stack, ...rest } = entry;
43
+ return rest;
44
+ });
38
45
  }
39
46
 
40
47
  function normalizeDetachedEntries(layout: LayoutConfig) {
@@ -1,5 +1,9 @@
1
+ import { isCurrencyPairListing } from "../utils/fx-market-hours";
2
+
1
3
  /** Daily bars in a year for an exchange: one per trading session. */
2
4
  const SESSION_BARS_PER_YEAR = 252;
5
+ /** Daily bars in a year for a currency pair, which trades every weekday, holidays included: 52 weeks of 5. */
6
+ const WEEKDAY_BARS_PER_YEAR = 260;
3
7
  /** Daily bars in a year for an asset that trades every day, such as crypto. */
4
8
  const CALENDAR_BARS_PER_YEAR = 365;
5
9
  /**
@@ -10,17 +14,30 @@ const CALENDAR_BARS_PER_YEAR = 365;
10
14
  const MIN_WEEKEND_DAY_SHARE = 0.05;
11
15
  const DAY_MS = 86_400_000;
12
16
 
13
- export type BarsPerYear = typeof SESSION_BARS_PER_YEAR | typeof CALENDAR_BARS_PER_YEAR;
17
+ export type BarsPerYear = typeof SESSION_BARS_PER_YEAR | typeof WEEKDAY_BARS_PER_YEAR | typeof CALENDAR_BARS_PER_YEAR;
18
+
19
+ /** What the series is a history of, where that sets its year rather than its dates. */
20
+ export interface BarsPerYearInstrument {
21
+ /** A currency pair (USDJPY=X), whose year is every weekday whatever range of it is loaded. */
22
+ currencyPair?: boolean;
23
+ }
24
+
25
+ /** Whether a listing is a currency pair, for `barsPerYear`: USDJPY=X or a CCY listing, not a currency future (6J=F). */
26
+ export function currencyPairInstrument(symbol: string | undefined, exchange?: string): BarsPerYearInstrument {
27
+ return { currencyPair: isCurrencyPairListing(symbol, exchange) };
28
+ }
14
29
 
15
30
  /**
16
- * Daily bars the series holds in a year, read from its own dates: 365 when it
17
- * has both Saturday and Sunday observations (24/7 assets), 252 otherwise
18
- * (exchange sessions). Both days are required so a venue that trades Sunday
19
- * to Thursday, or whose bars start late on the previous evening in UTC, is not
20
- * read as trading every day. Annualised volatility and Sharpe scale with the
21
- * square root of this, and a one-year window is this many bars.
31
+ * Daily bars the series holds in a year: 365 when it has both Saturday and
32
+ * Sunday observations (24/7 assets), 260 for a currency pair, which trades on
33
+ * every weekday with no exchange holidays, and 252 otherwise (exchange
34
+ * sessions). A pair is told by what it is, not by its dates, so a month of it
35
+ * is annualised as a year is. Both weekend days are required so a venue that
36
+ * trades Sunday to Thursday, or whose bars start late on the previous evening
37
+ * in UTC, is not read as trading every day. Annualised volatility and Sharpe
38
+ * scale with the square root of this, and a one-year window is this many bars.
22
39
  */
23
- export function barsPerYear(times: Iterable<Date | string | number>): BarsPerYear {
40
+ export function barsPerYear(times: Iterable<Date | string | number>, instrument: BarsPerYearInstrument = {}): BarsPerYear {
24
41
  const days = new Set<number>();
25
42
  for (const value of times) {
26
43
  const time = value instanceof Date ? value.getTime() : typeof value === "number" ? value : Date.parse(value);
@@ -34,7 +51,8 @@ export function barsPerYear(times: Iterable<Date | string | number>): BarsPerYea
34
51
  else if (weekday === 0) sundays += 1;
35
52
  }
36
53
  const minimum = Math.max(1, days.size * MIN_WEEKEND_DAY_SHARE);
37
- return saturdays >= minimum && sundays >= minimum ? CALENDAR_BARS_PER_YEAR : SESSION_BARS_PER_YEAR;
54
+ if (saturdays >= minimum && sundays >= minimum) return CALENDAR_BARS_PER_YEAR;
55
+ return instrument.currencyPair ? WEEKDAY_BARS_PER_YEAR : SESSION_BARS_PER_YEAR;
38
56
  }
39
57
 
40
58
  /** The one line every report that annualises states its convention in. */
@@ -1,7 +1,7 @@
1
1
  import type { DataProvider, QuoteSubscriptionTarget } from "../../types/data-provider";
2
2
  import type { Quote } from "../../types/financials";
3
3
  import type { InstrumentRef } from "../request-types";
4
- import { marketDataFrames, type DataFrameScheduler } from "../frame-scheduler";
4
+ import { marketDataFrames, type DataFrameRequest, type DataFrameScheduler } from "../frame-scheduler";
5
5
  import { mergeQuoteSubscriptionTargets } from "../quote-subscription-target";
6
6
  import { QueryStore } from "../query-store";
7
7
  import type { QueryEntry } from "../result-types";
@@ -51,6 +51,8 @@ export const QUOTE_SUBSCRIPTION_REMOVE_GRACE_MS = 250;
51
51
  export const QUOTE_SUBSCRIPTION_PRIORITY_UPDATE_DELAY_MS = 100;
52
52
  /** Keys nobody is looking at still feed totals and alerts, just not every frame. */
53
53
  const BACKGROUND_QUOTE_APPLY_INTERVAL_MS = 1_000;
54
+ /** How long past its interval an off-screen key waits for a frame that carries visible quotes. */
55
+ const BACKGROUND_QUOTE_RIDE_MS = 250;
54
56
 
55
57
  /**
56
58
  * Visible and selected keys apply every data frame; every other key waits for
@@ -417,7 +419,24 @@ export class QuoteSubscriptionManager {
417
419
 
418
420
  // Latest tick per key wins; the frame applies whatever is newest.
419
421
  this.pendingStreamQuotes.set(key, { instrument, quote });
420
- this.frames.request(this.streamQuoteFrame, { notBefore: this.streamQuoteDueAt(key, subscription.target) });
422
+ this.frames.request(this.streamQuoteFrame, this.streamQuoteRequest(
423
+ this.streamQuoteDueAt(key, subscription.target),
424
+ isForegroundQuoteTarget(subscription.target),
425
+ ));
426
+ }
427
+
428
+ /**
429
+ * A visible or selected key, and the first tick of any key, sets a frame
430
+ * off itself. An off-screen key held for its interval applies with the next
431
+ * frame that carries visible quotes, and sets a frame off only when none
432
+ * came within BACKGROUND_QUOTE_RIDE_MS of it falling due. A frame of its own
433
+ * spaces the next one: with a list longer than the screen the off-screen
434
+ * keys came due all second long, each held the next visible quote back for a
435
+ * frame interval, and every visible row updated twice as late.
436
+ */
437
+ private streamQuoteRequest(dueAt: number, foreground: boolean): DataFrameRequest {
438
+ if (foreground || dueAt === Number.NEGATIVE_INFINITY) return { notBefore: dueAt };
439
+ return { notBefore: dueAt, rideUntil: Math.max(dueAt, this.frames.now()) + BACKGROUND_QUOTE_RIDE_MS };
421
440
  }
422
441
 
423
442
  private streamQuoteDueAt(key: string, target: QuoteSubscriptionTarget): number {
@@ -447,7 +466,7 @@ export class QuoteSubscriptionManager {
447
466
  due.push(pending);
448
467
  }
449
468
  if (nextDueAt !== Number.POSITIVE_INFINITY) {
450
- this.frames.request(this.streamQuoteFrame, { notBefore: nextDueAt });
469
+ this.frames.request(this.streamQuoteFrame, this.streamQuoteRequest(nextDueAt, false));
451
470
  }
452
471
  if (due.length === 0) return;
453
472
 
@@ -173,6 +173,41 @@ export const FUTURES_SECTOR_ORDER: FuturesSector[] = [
173
173
  "currencies",
174
174
  ];
175
175
 
176
+ /**
177
+ * The board's groups a reader names by a word: its sectors in any of their
178
+ * forms, and the two the Agriculture sector holds that traders name apart,
179
+ * the softs (grown, not mined, and traded in New York) and the grains with
180
+ * their soybean products.
181
+ */
182
+ const FUTURES_GROUP_WORDS: ReadonlyArray<{ words: readonly string[]; label: string; matches: (contract: FuturesContract) => boolean }> = [
183
+ { words: ["softs", "soft", "soft commodities"], label: "softs", matches: (contract) => ["KC", "SB", "CC", "CT", "OJ"].includes(contract.code) },
184
+ { words: ["grains", "grain", "grains and oilseeds"], label: "grains", matches: (contract) => ["ZC", "ZS", "ZM", "ZL", "ZW", "KE"].includes(contract.code) },
185
+ { words: ["agriculture", "agricultural", "ags", "ag", "agri"], label: "agriculture", matches: (contract) => contract.sector === "agriculture" },
186
+ { words: ["metals", "metal"], label: "metals", matches: (contract) => contract.sector === "metals" },
187
+ { words: ["energy", "energies"], label: "energy", matches: (contract) => contract.sector === "energy" },
188
+ { words: ["livestock", "meats"], label: "livestock", matches: (contract) => contract.sector === "livestock" },
189
+ { words: ["currencies", "currency", "fx"], label: "currencies", matches: (contract) => contract.sector === "currencies" },
190
+ { words: ["rates", "interest rates", "treasuries"], label: "rates", matches: (contract) => contract.sector === "rates" },
191
+ { words: ["equity index", "equity indices", "indices", "stock index", "stock indices"], label: "equity index",
192
+ matches: (contract) => contract.sector === "equity-index" },
193
+ { words: ["equity sectors", "sector futures"], label: "equity sectors", matches: (contract) => contract.sector === "equity-sectors" },
194
+ ];
195
+
196
+ /**
197
+ * The rows a group word stands for (`FUT softs`, `FUT agriculture`), or null
198
+ * for any other search. A sector's word lists that sector alone: "energy"
199
+ * is the energy futures, not the S&P Energy sector future beside them.
200
+ */
201
+ export function futuresGroupFilter(query: string): ((contract: FuturesContract) => boolean) | null {
202
+ const typed = query.trim().toLowerCase().replace(/\s+/g, " ");
203
+ return FUTURES_GROUP_WORDS.find((group) => group.words.includes(typed))?.matches ?? null;
204
+ }
205
+
206
+ /** The group words a contract is found by, as a catalog search reads them: KC is softs and agriculture. */
207
+ export function futuresGroupTags(contract: FuturesContract): string[] {
208
+ return FUTURES_GROUP_WORDS.filter((group) => group.matches(contract)).map((group) => group.label);
209
+ }
210
+
176
211
  export function getContractsBySector(): Map<FuturesSector, FuturesContract[]> {
177
212
  const map = new Map<FuturesSector, FuturesContract[]>();
178
213
  for (const sector of FUTURES_SECTOR_ORDER) {
@@ -186,6 +221,41 @@ const BY_SYMBOL: ReadonlyMap<string, FuturesContract> = new Map(FUTURES_CONTRACT
186
221
 
187
222
  const typed = (value: unknown) => typeof value === "string" ? value.trim().toUpperCase() : "";
188
223
 
224
+ /**
225
+ * CME's crypto futures, which have a curve (CTM) but no board row, so their
226
+ * name and tick live here. Outright ticks: BTC $5, ETH $0.50, SOL $0.05, XRP
227
+ * $0.0005 (each $25 a contract). Their contracts are listed as ETHX26.CME.
228
+ */
229
+ export const CME_CRYPTO_FUTURES: readonly { code: string; name: string; tick: number }[] = [
230
+ { code: "BTC", name: "Bitcoin", tick: 5 }, { code: "ETH", name: "Ether", tick: 0.5 },
231
+ { code: "SOL", name: "Solana", tick: 0.05 }, { code: "XRP", name: "XRP", tick: 0.0005 },
232
+ ];
233
+
234
+ /**
235
+ * CME's micro crypto futures (Micro Bitcoin, Micro Ether, Micro SOL, Micro
236
+ * XRP): listed as MBTX26.CME, with no curve or board row, so only their codes
237
+ * live here.
238
+ */
239
+ const CME_MICRO_CRYPTO_ROOTS: ReadonlySet<string> = new Set(["MBT", "MET", "MSL", "MXP"]);
240
+
241
+ /** A root, a month letter and a two-digit year: CLZ26, ETHX26, 6EH27. */
242
+ const LISTED_CONTRACT_CODE = /^([A-Z0-9]{1,4})([FGHJKMNQUVXZ])(\d{2})$/;
243
+
244
+ /**
245
+ * A listed contract's code as CTM prints it (ETHX26, CLZ26), as the symbol
246
+ * its quote has (ETHX26.CME, CLZ26.NYM): the code with its root's venue.
247
+ * Null for any other text, and for a root neither the board nor CME crypto,
248
+ * micros included, has.
249
+ */
250
+ export function listedFuturesSymbol(code: unknown): string | null {
251
+ const match = LISTED_CONTRACT_CODE.exec(typed(code));
252
+ if (!match) return null;
253
+ const root = match[1]!;
254
+ const venue = BY_CODE.get(root)?.venue
255
+ ?? (CME_CRYPTO_FUTURES.some((row) => row.code === root) || CME_MICRO_CRYPTO_ROOTS.has(root) ? "CME" : null);
256
+ return venue ? `${match[0]}.${venue}` : null;
257
+ }
258
+
189
259
  /** The board row a bare code names, in any case: NG is Natural Gas whether or not a security also uses NG. */
190
260
  export function futuresContractByCode(code: unknown): FuturesContract | null {
191
261
  return BY_CODE.get(typed(code)) ?? null;
@@ -200,7 +270,17 @@ export function futuresBoardContract(value: unknown): FuturesContract | null {
200
270
  return BY_SYMBOL.get(typed(value)) ?? futuresContractByCode(value);
201
271
  }
202
272
 
203
- const nameWords = (text: string) => text.toLowerCase().split(/[^a-z0-9]+/).filter(Boolean);
273
+ /**
274
+ * A contract's name as a reader may type it, with its number marked any way:
275
+ * "SUGAR NO. 11", the CFTC's name, and "Sugar #11", the board's, are both
276
+ * "sugar 11". Lower case, "No."/"Nr." before a number and "#" dropped,
277
+ * spaces collapsed.
278
+ */
279
+ export function futuresNameKey(text: string): string {
280
+ return text.toLowerCase().replace(/\b(?:no|nr)\.?\s*(?=\d)/g, " ").replace(/#/g, " ").replace(/\s+/g, " ").trim();
281
+ }
282
+
283
+ const nameWords = (text: string) => futuresNameKey(text).split(/[^a-z0-9]+/).filter(Boolean);
204
284
 
205
285
  /**
206
286
  * The item a typed name means: every word of it starts a word of the item's
@@ -235,6 +315,51 @@ export function futuresContractByName(value: unknown): FuturesContract | null {
235
315
  return bestNameMatch(FUTURES_CONTRACTS, (contract) => [contract.name, ...contract.aliases ?? []], value);
236
316
  }
237
317
 
318
+ /**
319
+ * The commodity words that name a board row when typed as a symbol, and the
320
+ * future each stands for: energy, metals, grains and softs, livestock. A list,
321
+ * not the words of every row's name, so DOW, NOTE, BOND, DOLLAR, NAT and LIVE,
322
+ * words of index, rate, currency and livestock rows, name none.
323
+ */
324
+ const COMMODITY_WORDS: Readonly<Record<string, string>> = {
325
+ BRENT: "BZ=F",
326
+ WTI: "CL=F",
327
+ OIL: "CL=F",
328
+ CRUDE: "CL=F",
329
+ NATGAS: "NG=F",
330
+ GASOLINE: "RB=F",
331
+ RBOB: "RB=F",
332
+ GOLD: "GC=F",
333
+ SILVER: "SI=F",
334
+ COPPER: "HG=F",
335
+ ALUMINUM: "ALI=F",
336
+ ALUMINIUM: "ALI=F",
337
+ PLATINUM: "PL=F",
338
+ PALLADIUM: "PA=F",
339
+ CORN: "ZC=F",
340
+ WHEAT: "ZW=F",
341
+ SOYBEANS: "ZS=F",
342
+ SOYBEAN: "ZS=F",
343
+ SOY: "ZS=F",
344
+ COFFEE: "KC=F",
345
+ SUGAR: "SB=F",
346
+ COCOA: "CC=F",
347
+ COTTON: "CT=F",
348
+ LUMBER: "LBR=F",
349
+ CATTLE: "LE=F",
350
+ HOGS: "HE=F",
351
+ };
352
+
353
+ /**
354
+ * The board row a commodity's word names when typed as a symbol (BRENT is
355
+ * Brent Crude Oil, BZ=F; WTI, OIL and CRUDE are WTI Crude Oil, CL=F; GOLD is
356
+ * GC=F), from COMMODITY_WORDS alone. Null for any other word.
357
+ */
358
+ export function futuresContractByWord(symbol: unknown): FuturesContract | null {
359
+ const future = COMMODITY_WORDS[typed(symbol).toUpperCase()];
360
+ return future ? FUTURES_CONTRACTS.find((contract) => contract.symbol === future) ?? null : null;
361
+ }
362
+
238
363
  /**
239
364
  * The future a bare symbol typed for a security stands for: a code no listed
240
365
  * security answers to (TTF is TTF=F). Null for every other symbol, and for a
@@ -122,7 +122,7 @@ export function fitFuturesContractLines(lines: readonly FuturesContractLine[], m
122
122
  /**
123
123
  * The exchange settlement dated by its session, `$4,216.30 (2026-10-09)`, as
124
124
  * `ticker` prints a futures price: in the quote's currency, padded to its minor
125
- * unit and at the contract's own precision, with or without a quote to hand.
125
+ * unit and at the contract's own precision (its tick's decimals), with or without a quote to hand.
126
126
  * Without a quote currency the price is a bare number, never a guessed `$`: a
127
127
  * grain settles in cents. A contract without a confirmed settlement reads
128
128
  * `--`: never an older settlement, and never the last trade.
@@ -135,15 +135,21 @@ export function fitFuturesContractLines(lines: readonly FuturesContractLine[], m
135
135
  * session is not confirmed yet. A settlement of that session or a later one
136
136
  * is shown: the same session, or the one the move itself belongs to.
137
137
  */
138
+ /** The contract's tick for a price format (`MarketFormatOptions.tick`), so its prices print to it; none without terms. */
139
+ export function futuresTickOption(terms: { spec?: Pick<FuturesContractSpec, "tick"> | null } | null | undefined): { tick?: number } {
140
+ const tick = terms?.spec?.tick;
141
+ return tick != null && Number.isFinite(tick) && tick > 0 ? { tick } : {};
142
+ }
143
+
138
144
  export function futuresSettleText(
139
- terms: Pick<FuturesContractTermsPayload, "settlement">,
145
+ terms: Pick<FuturesContractTermsPayload, "settlement"> & { spec?: Pick<FuturesContractSpec, "tick"> | null },
140
146
  quote: Pick<Quote, "currency" | "instrumentType" | "priceBasis" | "providerPriceDivisor"> | null | undefined,
141
147
  movesFrom?: string | null,
142
148
  ): string {
143
149
  if (!terms.settlement) return FUTURES_MISSING;
144
150
  if (movesFrom && terms.settlement.date < movesFrom) return `${FUTURES_MISSING} (${movesFrom} not confirmed yet)`;
145
151
  const currency = quote?.currency;
146
- const options = withCurrencyMinorDigits(quoteFormatOptions(quote, "FUTURE"), currency);
152
+ const options = { ...withCurrencyMinorDigits(quoteFormatOptions(quote, "FUTURE"), currency), ...futuresTickOption(terms) };
147
153
  const price = currency ? formatMarketPriceWithCurrency(terms.settlement.price, currency, options) : formatMarketPrice(terms.settlement.price, options);
148
154
  return `${price} (${terms.settlement.date})`;
149
155
  }
@@ -319,8 +325,12 @@ export type FuturesChangeTerms = Pick<FuturesContractTermsPayload, "settlement">
319
325
  * is confirmed: Wednesday's 7,720.50 close at 23:18 UTC, "+14 vs Wed 4 Nov
320
326
  * close", never +137.75 from Tuesday's settlement, two sessions. At any
321
327
  * other time the terms are behind and nothing dates it (null);
322
- * - without a settlement in the terms, or once the move's own session has
323
- * settled, is the session before's close, which nothing else checks.
328
+ * - once the move's own session has settled, is the session before's
329
+ * settlement when the quote closes on its own (Gloom Cloud then measures
330
+ * it from the one before: CC=F's 5,155 on Fri 6 Nov 2026, "-26 vs Thu 5
331
+ * Nov settle"), and otherwise the session before's close;
332
+ * - without a settlement in the terms, is the session before's close, which
333
+ * nothing else checks.
324
334
  * On a venue without a calendar only a settlement is named. Null without a
325
335
  * session date, a move or terms.
326
336
  */
@@ -344,10 +354,15 @@ export function futuresChangeBasis(
344
354
  if (settled && settled.date <= session && Math.abs(reference - settled.price) <= settlementTolerance(terms.spec?.tick, settled.price)) {
345
355
  return { kind: "settle", session: settled.date };
346
356
  }
357
+ const sameContract = !!move.month && terms.deliveryMonth?.slice(0, 7) === move.month;
347
358
  if (settled && previous && settled.date === previous) {
348
- const sameContract = !!move.month && terms.deliveryMonth?.slice(0, 7) === move.month;
349
359
  return sameContract && Number.isFinite(move.price) ? { kind: "settle", session: previous, from: settled.price } : null;
350
360
  }
361
+ // The move's own session settled, and the quote closes on that settlement: Gloom Cloud measures it from the one before.
362
+ if (settled && previous && settled.date === session && sameContract
363
+ && Math.abs(move.price - settled.price) <= settlementTolerance(terms.spec?.tick, settled.price)) {
364
+ return { kind: "settle", session: previous };
365
+ }
351
366
  if (settled && previous && settled.date < previous) return print?.overnight && print.tradeDate === moveDate ? { kind: "close", session: previous } : null;
352
367
  return previous ? { kind: "close", session: previous } : null;
353
368
  }