gloomberb 0.20.7 → 0.20.8

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (611) hide show
  1. package/README.ja.md +74 -0
  2. package/README.md +2 -0
  3. package/README.zh-CN.md +2 -0
  4. package/package.json +6 -1
  5. package/src/account/auth-model.ts +22 -0
  6. package/src/api-client/auth.ts +7 -2
  7. package/src/api-client/awards.ts +5 -0
  8. package/src/api-client/bond-trades.ts +22 -0
  9. package/src/api-client/catalysts.ts +11 -1
  10. package/src/api-client/data.ts +30 -6
  11. package/src/api-client/debt-maturities.ts +7 -0
  12. package/src/api-client/equity-screener.ts +17 -0
  13. package/src/api-client/errors.ts +2 -0
  14. package/src/api-client/exchange-announcements.ts +14 -7
  15. package/src/api-client/fund-facts.ts +21 -3
  16. package/src/api-client/futures-curve.ts +14 -1
  17. package/src/api-client/geo.ts +10 -0
  18. package/src/api-client/hiring.ts +2 -0
  19. package/src/api-client/index.ts +3 -0
  20. package/src/api-client/insider-signals.ts +14 -0
  21. package/src/api-client/members.ts +30 -2
  22. package/src/api-client/money-markets.ts +11 -1
  23. package/src/api-client/paths.ts +6 -1
  24. package/src/api-client/perps.ts +2 -0
  25. package/src/api-client/request.ts +2 -1
  26. package/src/api-client/socket.ts +7 -0
  27. package/src/api-client/types/econ.ts +2 -1
  28. package/src/api-client/types/filings-and-calls.ts +6 -0
  29. package/src/api-client/types/market.ts +4 -0
  30. package/src/api-client/web-experiments.ts +5 -6
  31. package/src/app/runtime/update.ts +2 -1
  32. package/src/architecture/floating-promise-allowlist.json +33 -106
  33. package/src/capabilities/asset-data-inputs.ts +183 -0
  34. package/src/capabilities/factories.ts +8 -2
  35. package/src/cli/base-converter.ts +36 -2
  36. package/src/cli/commands/api.ts +2 -2
  37. package/src/cli/commands/command-utils.ts +18 -0
  38. package/src/cli/commands/hong-kong-movers.ts +50 -0
  39. package/src/cli/commands/market.ts +539 -130
  40. package/src/cli/commands/options-chain.ts +7 -1
  41. package/src/cli/commands/overview.ts +74 -14
  42. package/src/cli/commands/plugins.ts +7 -6
  43. package/src/cli/commands/search.ts +52 -9
  44. package/src/cli/commands/system.ts +15 -10
  45. package/src/cli/commands/ticker.ts +97 -44
  46. package/src/cli/content-figures.ts +45 -0
  47. package/src/cli/context.ts +5 -0
  48. package/src/cli/desktop-pane-shot-routes.ts +13 -4
  49. package/src/cli/desktop-pane-shot.ts +86 -12
  50. package/src/cli/earnings-calendar.ts +36 -5
  51. package/src/cli/export-source.ts +17 -3
  52. package/src/cli/fx-pair.ts +111 -11
  53. package/src/cli/glossary.ts +36 -2
  54. package/src/cli/help.ts +1 -1
  55. package/src/cli/history-export.ts +29 -11
  56. package/src/cli/history-rows.ts +130 -21
  57. package/src/cli/index.ts +8 -5
  58. package/src/cli/known-gaps.ts +45 -1
  59. package/src/cli/listing-arg.ts +366 -19
  60. package/src/cli/pane-functions/capabilities.ts +2 -2
  61. package/src/cli/pane-functions/catalog.ts +105 -9
  62. package/src/cli/pane-functions/discovery.ts +2 -0
  63. package/src/cli/pane-functions/dom.ts +46 -9
  64. package/src/cli/pane-functions/freshness.ts +7 -3
  65. package/src/cli/pane-functions/function-help.ts +9 -6
  66. package/src/cli/pane-functions/headless.ts +77 -6
  67. package/src/cli/pane-functions/index.ts +141 -23
  68. package/src/cli/pane-functions/options.ts +1 -3
  69. package/src/cli/pane-functions/plugin-code.ts +169 -0
  70. package/src/cli/pane-functions/report.ts +10 -0
  71. package/src/cli/pane-functions/resolver.ts +69 -21
  72. package/src/cli/pane-functions/screenshot-assessment.ts +82 -3
  73. package/src/cli/pane-functions/screenshot-data-evidence.ts +3 -1
  74. package/src/cli/pane-functions/screenshot-types.ts +6 -0
  75. package/src/cli/quote-answer.ts +49 -2
  76. package/src/cli/registry.ts +42 -4
  77. package/src/cli/report-tables.ts +26 -6
  78. package/src/cli/result.ts +13 -2
  79. package/src/cli/series-search.ts +17 -7
  80. package/src/cli/statement-filings.ts +22 -8
  81. package/src/cli/symbol-args.ts +9 -0
  82. package/src/cli/ticker-resolution.ts +3 -2
  83. package/src/cli/unknown-command.ts +111 -14
  84. package/src/components/chart/composite/format.ts +15 -1
  85. package/src/components/chart/composite/legend.tsx +101 -47
  86. package/src/components/chart/composite/panel-labels.ts +4 -4
  87. package/src/components/chart/composite/panel-surface.tsx +4 -6
  88. package/src/components/chart/composite/scene/build.ts +180 -0
  89. package/src/components/chart/composite/scene/cursor.ts +226 -0
  90. package/src/components/chart/composite/scene/domain.ts +170 -0
  91. package/src/components/chart/composite/scene/markers.ts +115 -0
  92. package/src/components/chart/composite/scene/panels.ts +85 -0
  93. package/src/components/chart/composite/scene/points.ts +169 -0
  94. package/src/components/chart/composite/scene/projection.ts +105 -0
  95. package/src/components/chart/composite/scene/timeline.ts +71 -0
  96. package/src/components/chart/composite/scene.ts +12 -1066
  97. package/src/components/chart/composite/types.ts +4 -2
  98. package/src/components/chart/curve/model.ts +2 -2
  99. package/src/components/chart-table/axis.ts +18 -6
  100. package/src/components/command-bar/layout-items/focused-pane.ts +3 -0
  101. package/src/components/command-bar/list/model.ts +9 -0
  102. package/src/components/command-bar/pane-templates/items.ts +61 -15
  103. package/src/components/command-bar/pane-templates/workflow.ts +16 -5
  104. package/src/components/command-bar/routes/root/plugin-install.ts +7 -46
  105. package/src/components/command-bar/routes/root/provider-search.ts +8 -5
  106. package/src/components/command-bar/routes/root/results.ts +6 -1
  107. package/src/components/command-bar/routes/root/runtime.ts +1 -0
  108. package/src/components/command-bar/routes/root/shortcut-feedback.ts +4 -1
  109. package/src/components/command-bar/routes/ticker-search/actions.ts +7 -5
  110. package/src/components/command-bar/routes/ticker-search/results.ts +51 -3
  111. package/src/components/command-bar/view-model.ts +12 -0
  112. package/src/components/command-bar/workflow/ops.ts +21 -4
  113. package/src/components/command-bar/workflow/ticker-listing-picker.ts +3 -1
  114. package/src/components/command-bar/workflow/tickers.ts +6 -2
  115. package/src/components/data-table/view.tsx +46 -1
  116. package/src/components/form-modal/confirm.tsx +3 -2
  117. package/src/components/form-modal/content.tsx +3 -2
  118. package/src/components/form-modal/field-row.tsx +2 -0
  119. package/src/components/form-modal/host.tsx +18 -3
  120. package/src/components/form-modal/remote-reads.test-helpers.ts +34 -0
  121. package/src/components/index.ts +1 -1
  122. package/src/components/layout/pane/title.ts +21 -5
  123. package/src/components/layout/shell/pane/layers.tsx +20 -14
  124. package/src/components/layout/shell/pane-occlusion.ts +21 -0
  125. package/src/components/onboarding/desks-step.tsx +7 -1
  126. package/src/components/onboarding/onboarding-keyboard.ts +48 -6
  127. package/src/components/onboarding/onboarding-wizard.tsx +47 -8
  128. package/src/components/onboarding/portfolio-step/positions-panel.tsx +17 -3
  129. package/src/components/onboarding/use-onboarding-progress.ts +57 -14
  130. package/src/components/onboarding/wizard-positions.ts +2 -0
  131. package/src/components/paged-rows.ts +11 -5
  132. package/src/components/ticker/list-table-view.tsx +24 -5
  133. package/src/components/toggle-list.tsx +44 -1
  134. package/src/components/ui/data-table/opentui/index.tsx +7 -6
  135. package/src/components/ui/data-table/opentui/model.ts +7 -3
  136. package/src/components/ui/data-table/types.ts +13 -2
  137. package/src/components/ui/fields.tsx +16 -4
  138. package/src/components/ui/query-bar.tsx +43 -9
  139. package/src/components/ui/table-layout.ts +56 -2
  140. package/src/core/app-services.ts +7 -2
  141. package/src/core/connection-health.ts +26 -0
  142. package/src/core/state/app/layout.ts +12 -4
  143. package/src/data/config/layout.ts +3 -1
  144. package/src/data/config/store/node.ts +4 -2
  145. package/src/docs/snapshot.json +756 -216
  146. package/src/i18n/es.ts +4 -1
  147. package/src/i18n/ja.ts +4 -1
  148. package/src/i18n/ko.ts +4 -1
  149. package/src/i18n/zh-cn.ts +4 -1
  150. package/src/i18n/zh-tw.ts +4 -1
  151. package/src/layout/pane-follow.ts +1 -1
  152. package/src/layout/pane-manager/gridlock.ts +18 -5
  153. package/src/layout/pane-manager/index.ts +1 -0
  154. package/src/layout/pane-manager/transient.ts +56 -0
  155. package/src/layout-marketplace/gallery.tsx +2 -1
  156. package/src/layout-marketplace/model.ts +4 -10
  157. package/src/market-data/commodity-names.ts +24 -0
  158. package/src/market-data/connection-follow.ts +9 -7
  159. package/src/market-data/coordinator/auxiliary.ts +4 -3
  160. package/src/market-data/coordinator/entries.ts +22 -1
  161. package/src/market-data/coordinator/financials.ts +2 -3
  162. package/src/market-data/coordinator/index.ts +67 -12
  163. package/src/market-data/coordinator/quotes.ts +2 -3
  164. package/src/market-data/fund-facts.ts +7 -1
  165. package/src/market-data/futures-board.ts +38 -4
  166. package/src/market-data/futures-contract.ts +5 -2
  167. package/src/market-data/fx-closes.ts +4 -1
  168. package/src/market-data/market/bar-period.ts +15 -0
  169. package/src/market-data/market/format.ts +4 -2
  170. package/src/market-data/market/freshness.ts +4 -0
  171. package/src/market-data/market/status.ts +23 -3
  172. package/src/market-data/options-alternatives.ts +21 -9
  173. package/src/market-data/published-futures-sessions.ts +9 -0
  174. package/src/market-data/quotes/balance-sheet-rate.ts +34 -0
  175. package/src/market-data/quotes/delisting.ts +26 -2
  176. package/src/market-data/quotes/freshness.ts +62 -0
  177. package/src/market-data/quotes/listing-enterprise-value.ts +250 -19
  178. package/src/market-data/quotes/regular-session-valuation.ts +8 -0
  179. package/src/market-data/realized-volatility.ts +3 -1
  180. package/src/market-data/request-types.ts +2 -0
  181. package/src/market-data/selectors.ts +1 -0
  182. package/src/news/aggregator.ts +3 -3
  183. package/src/plugins/builtin/account-management/delete-account.ts +78 -0
  184. package/src/plugins/builtin/account-management/pane.tsx +22 -19
  185. package/src/plugins/builtin/account-management/password-dialog.tsx +75 -0
  186. package/src/plugins/builtin/alerts/alert-log.ts +3 -2
  187. package/src/plugins/builtin/alerts/cli-forms.ts +1 -1
  188. package/src/plugins/builtin/alerts/cli.ts +72 -4
  189. package/src/plugins/builtin/alerts/format.ts +8 -2
  190. package/src/plugins/builtin/alerts/index.tsx +8 -5
  191. package/src/plugins/builtin/alerts/pane.tsx +5 -3
  192. package/src/plugins/builtin/alerts/research-builder.ts +12 -0
  193. package/src/plugins/builtin/analytics/index.tsx +3 -3
  194. package/src/plugins/builtin/analytics/risk-client.ts +14 -3
  195. package/src/plugins/builtin/analytics/risk-pane.tsx +3 -3
  196. package/src/plugins/builtin/attention/pane.tsx +1 -1
  197. package/src/plugins/builtin/attention/trending.tsx +1 -1
  198. package/src/plugins/builtin/awards/detail.tsx +4 -1
  199. package/src/plugins/builtin/awards/headless.ts +7 -3
  200. package/src/plugins/builtin/awards/model.ts +11 -0
  201. package/src/plugins/builtin/awards/pane.tsx +12 -5
  202. package/src/plugins/builtin/backtest/client.ts +7 -2
  203. package/src/plugins/builtin/backtest/headless.ts +2 -1
  204. package/src/plugins/builtin/backtest/pane.tsx +4 -2
  205. package/src/plugins/builtin/bond-calculator/pane.tsx +1 -1
  206. package/src/plugins/builtin/broker-manager/sign-in-end.ts +1 -1
  207. package/src/plugins/builtin/broker-trading/orders.tsx +2 -2
  208. package/src/plugins/builtin/buildout/company/pane.tsx +1 -1
  209. package/src/plugins/builtin/buildout/model/index.ts +2 -2
  210. package/src/plugins/builtin/catalysts/headless.ts +9 -6
  211. package/src/plugins/builtin/catalysts/model.ts +72 -10
  212. package/src/plugins/builtin/catalysts/pane.tsx +10 -7
  213. package/src/plugins/builtin/cds/pane.tsx +5 -3
  214. package/src/plugins/builtin/central-bank-rates/pane.tsx +3 -2
  215. package/src/plugins/builtin/chart-composer/catalog-series.ts +59 -0
  216. package/src/plugins/builtin/chart-composer/headless-schema.ts +2 -1
  217. package/src/plugins/builtin/chart-composer/headless.ts +104 -23
  218. package/src/plugins/builtin/chart-composer/index.tsx +6 -3
  219. package/src/plugins/builtin/chart-composer/legend-names.ts +19 -0
  220. package/src/plugins/builtin/chart-composer/pane.tsx +37 -10
  221. package/src/plugins/builtin/chart-composer/presets.ts +63 -6
  222. package/src/plugins/builtin/chart-composer/roll-events.ts +38 -0
  223. package/src/plugins/builtin/chart-composer/series-catalog.ts +12 -5
  224. package/src/plugins/builtin/chart-composer/series-expression.ts +8 -4
  225. package/src/plugins/builtin/chart-composer/series-listings.ts +33 -9
  226. package/src/plugins/builtin/chart-composer/use-series-catalog.ts +2 -2
  227. package/src/plugins/builtin/clinical-trials/client.ts +13 -0
  228. package/src/plugins/builtin/clinical-trials/index.tsx +1 -1
  229. package/src/plugins/builtin/clinical-trials/pane.tsx +77 -27
  230. package/src/plugins/builtin/clinical-trials/search.ts +117 -0
  231. package/src/plugins/builtin/cloud/askg/conversation-store.ts +17 -6
  232. package/src/plugins/builtin/cloud/askg/lock-note.ts +4 -2
  233. package/src/plugins/builtin/cloud/askg/manifest.ts +3 -2
  234. package/src/plugins/builtin/cloud/askg/pane.tsx +2 -2
  235. package/src/plugins/builtin/cloud/askg/sources.ts +3 -3
  236. package/src/plugins/builtin/cloud/one-tap/one-tap-prompt.tsx +7 -3
  237. package/src/plugins/builtin/cloud/team/acm-tab.tsx +1 -1
  238. package/src/plugins/builtin/cloud/team/pane.tsx +17 -10
  239. package/src/plugins/builtin/cloud/team/views.ts +15 -3
  240. package/src/plugins/builtin/cloud/terminal-relay/redact.ts +105 -16
  241. package/src/plugins/builtin/cloud/thesis/board-pane.tsx +17 -2
  242. package/src/plugins/builtin/cloud/thesis/module.tsx +3 -2
  243. package/src/plugins/builtin/cloud/thesis/store.ts +17 -3
  244. package/src/plugins/builtin/commodities-energy/index.tsx +35 -3
  245. package/src/plugins/builtin/commodity-balances/index.tsx +1 -1
  246. package/src/plugins/builtin/company-attention/app-rank.tsx +1 -1
  247. package/src/plugins/builtin/company-attention/building.tsx +1 -1
  248. package/src/plugins/builtin/company-attention/model.ts +2 -1
  249. package/src/plugins/builtin/company-attention/moves.tsx +1 -1
  250. package/src/plugins/builtin/company-attention/pane.tsx +1 -1
  251. package/src/plugins/builtin/company-attention/signals.tsx +1 -1
  252. package/src/plugins/builtin/company-kpis/pane.tsx +1 -1
  253. package/src/plugins/builtin/correlation/headless.ts +7 -5
  254. package/src/plugins/builtin/correlation/history.ts +17 -6
  255. package/src/plugins/builtin/correlation/index.tsx +1 -1
  256. package/src/plugins/builtin/correlation/relationship/history.ts +1 -1
  257. package/src/plugins/builtin/correlation/relationship/pane.tsx +1 -1
  258. package/src/plugins/builtin/cot/headless.ts +10 -3
  259. package/src/plugins/builtin/cot/pane.tsx +2 -2
  260. package/src/plugins/builtin/cpi/pane.tsx +1 -1
  261. package/src/plugins/builtin/credit-boards/model.ts +1 -1
  262. package/src/plugins/builtin/credit-documents/pane.tsx +1 -1
  263. package/src/plugins/builtin/crypto-board/defi-view.tsx +2 -2
  264. package/src/plugins/builtin/crypto-board/defi.ts +9 -3
  265. package/src/plugins/builtin/crypto-board/headless.ts +19 -10
  266. package/src/plugins/builtin/crypto-board/model.ts +8 -0
  267. package/src/plugins/builtin/crypto-board/pane.tsx +11 -5
  268. package/src/plugins/builtin/crypto-board/series.ts +17 -3
  269. package/src/plugins/builtin/crypto-board/supply.ts +26 -3
  270. package/src/plugins/builtin/crypto-etf-flows/headless.ts +3 -2
  271. package/src/plugins/builtin/crypto-etf-flows/model.ts +13 -3
  272. package/src/plugins/builtin/crypto-etf-flows/pane.tsx +6 -3
  273. package/src/plugins/builtin/custom-view/pane.tsx +5 -5
  274. package/src/plugins/builtin/debt-maturities/client.ts +5 -0
  275. package/src/plugins/builtin/debt-maturities/headless.ts +3 -1
  276. package/src/plugins/builtin/debt-maturities/model.ts +1 -0
  277. package/src/plugins/builtin/debt-maturities/pane.tsx +1 -1
  278. package/src/plugins/builtin/dividend-yield/pane.tsx +1 -1
  279. package/src/plugins/builtin/doe/model.ts +1 -1
  280. package/src/plugins/builtin/doe/pane.tsx +1 -1
  281. package/src/plugins/builtin/earnings/board.tsx +2 -2
  282. package/src/plugins/builtin/earnings/history.tsx +1 -1
  283. package/src/plugins/builtin/earnings-calls/calendar.tsx +1 -1
  284. package/src/plugins/builtin/earnings-calls/data.ts +2 -1
  285. package/src/plugins/builtin/earnings-calls/headless.ts +15 -0
  286. package/src/plugins/builtin/earnings-calls/model.ts +68 -8
  287. package/src/plugins/builtin/earnings-calls/pane.tsx +29 -8
  288. package/src/plugins/builtin/earnings-calls/transcript-view.tsx +32 -2
  289. package/src/plugins/builtin/earnings-ripple/pane.tsx +1 -1
  290. package/src/plugins/builtin/econ/calendar-model.ts +94 -2
  291. package/src/plugins/builtin/econ/detail-view.tsx +15 -11
  292. package/src/plugins/builtin/econ/index.tsx +25 -9
  293. package/src/plugins/builtin/econ/types.ts +4 -1
  294. package/src/plugins/builtin/equity-screener/headless.ts +23 -7
  295. package/src/plugins/builtin/equity-screener/index.tsx +3 -0
  296. package/src/plugins/builtin/equity-screener/live.ts +39 -12
  297. package/src/plugins/builtin/equity-screener/model.ts +86 -5
  298. package/src/plugins/builtin/equity-screener/pane.tsx +20 -21
  299. package/src/plugins/builtin/equity-screener/results.ts +12 -3
  300. package/src/plugins/builtin/equity-screener/ticker-check.tsx +2 -2
  301. package/src/plugins/builtin/estimate-revisions/pane.tsx +2 -2
  302. package/src/plugins/builtin/executives/pane.tsx +2 -2
  303. package/src/plugins/builtin/exposure/pane.tsx +1 -1
  304. package/src/plugins/builtin/fear-greed/data.ts +3 -1
  305. package/src/plugins/builtin/fear-greed/headless.ts +8 -2
  306. package/src/plugins/builtin/fear-greed/pane.tsx +8 -4
  307. package/src/plugins/builtin/filing-events/pane.tsx +1 -1
  308. package/src/plugins/builtin/futures/index.tsx +5 -4
  309. package/src/plugins/builtin/futures/model.ts +17 -9
  310. package/src/plugins/builtin/futures/returns.ts +2 -0
  311. package/src/plugins/builtin/futures/series.ts +44 -8
  312. package/src/plugins/builtin/futures/table.tsx +3 -3
  313. package/src/plugins/builtin/futures-curve/client.ts +1 -0
  314. package/src/plugins/builtin/futures-curve/headless.ts +14 -12
  315. package/src/plugins/builtin/futures-curve/index.tsx +7 -4
  316. package/src/plugins/builtin/futures-curve/model.ts +93 -7
  317. package/src/plugins/builtin/futures-curve/pane.tsx +18 -7
  318. package/src/plugins/builtin/fx-matrix/amount.ts +2 -1
  319. package/src/plugins/builtin/fx-matrix/index.tsx +9 -0
  320. package/src/plugins/builtin/gpu/changes.tsx +1 -1
  321. package/src/plugins/builtin/gpu/equities.tsx +1 -1
  322. package/src/plugins/builtin/gpu/pane.tsx +2 -2
  323. package/src/plugins/builtin/help/function-card.tsx +4 -2
  324. package/src/plugins/builtin/help/function-index.ts +12 -6
  325. package/src/plugins/builtin/help/index.tsx +1 -1
  326. package/src/plugins/builtin/holders/beneficial-view.tsx +1 -1
  327. package/src/plugins/builtin/holders/pane.tsx +1 -1
  328. package/src/plugins/builtin/insider/base-values.ts +55 -0
  329. package/src/plugins/builtin/insider/headless.ts +307 -83
  330. package/src/plugins/builtin/insider/index.tsx +65 -23
  331. package/src/plugins/builtin/insider/insiders.tsx +26 -16
  332. package/src/plugins/builtin/insider/model.ts +2 -2
  333. package/src/plugins/builtin/insider/signals-cells.tsx +4 -1
  334. package/src/plugins/builtin/insider/signals-model.ts +13 -5
  335. package/src/plugins/builtin/insider/signals.tsx +5 -3
  336. package/src/plugins/builtin/insider/tickers.tsx +466 -0
  337. package/src/plugins/builtin/ipo-calendar/pane.tsx +1 -1
  338. package/src/plugins/builtin/iv-history/client.ts +35 -4
  339. package/src/plugins/builtin/iv-history/headless.ts +10 -4
  340. package/src/plugins/builtin/iv-history/model.ts +85 -16
  341. package/src/plugins/builtin/iv-history/pane.tsx +2 -2
  342. package/src/plugins/builtin/iv-history/screen-pane.tsx +6 -3
  343. package/src/plugins/builtin/jobs/pane.tsx +5 -5
  344. package/src/plugins/builtin/macro-day/pane.tsx +1 -1
  345. package/src/plugins/builtin/macro-day/release-table.ts +5 -5
  346. package/src/plugins/builtin/macro-day/releases.ts +11 -9
  347. package/src/plugins/builtin/market-movers/headless.ts +6 -2
  348. package/src/plugins/builtin/market-movers/screener.ts +18 -4
  349. package/src/plugins/builtin/members/breadth-pane.tsx +3 -3
  350. package/src/plugins/builtin/members/client.ts +24 -2
  351. package/src/plugins/builtin/members/headless.ts +66 -9
  352. package/src/plugins/builtin/members/index.tsx +7 -6
  353. package/src/plugins/builtin/members/model.ts +89 -5
  354. package/src/plugins/builtin/members/pane.tsx +70 -21
  355. package/src/plugins/builtin/mna/distress/pane.tsx +2 -1
  356. package/src/plugins/builtin/mna/pane.tsx +1 -1
  357. package/src/plugins/builtin/money-markets/client.ts +43 -15
  358. package/src/plugins/builtin/money-markets/headless.ts +18 -11
  359. package/src/plugins/builtin/money-markets/index.tsx +7 -6
  360. package/src/plugins/builtin/money-markets/model.ts +20 -5
  361. package/src/plugins/builtin/money-markets/pane.tsx +28 -17
  362. package/src/plugins/builtin/news/wire/news/footer.ts +11 -1
  363. package/src/plugins/builtin/news/wire/news/table.tsx +15 -5
  364. package/src/plugins/builtin/notes/headless.ts +94 -0
  365. package/src/plugins/builtin/notes/index.tsx +3 -1
  366. package/src/plugins/builtin/notes/store.ts +10 -3
  367. package/src/plugins/builtin/options/footer.ts +8 -2
  368. package/src/plugins/builtin/options/open-interest-as-of.ts +12 -3
  369. package/src/plugins/builtin/options/view.tsx +10 -1
  370. package/src/plugins/builtin/options-calculator/pane.tsx +1 -1
  371. package/src/plugins/builtin/options-positioning/client.ts +35 -8
  372. package/src/plugins/builtin/options-positioning/headless.ts +17 -7
  373. package/src/plugins/builtin/options-positioning/index.tsx +10 -0
  374. package/src/plugins/builtin/options-positioning/pane.tsx +16 -7
  375. package/src/plugins/builtin/options-scenario/csp-screen-pane.tsx +1 -1
  376. package/src/plugins/builtin/options-scenario/pane.tsx +1 -1
  377. package/src/plugins/builtin/pe-band/pane.tsx +2 -2
  378. package/src/plugins/builtin/perps/cascade-tabs.tsx +2 -2
  379. package/src/plugins/builtin/perps/client.ts +54 -15
  380. package/src/plugins/builtin/perps/headless.ts +39 -13
  381. package/src/plugins/builtin/perps/index.tsx +2 -1
  382. package/src/plugins/builtin/perps/model.ts +43 -1
  383. package/src/plugins/builtin/perps/pane.tsx +35 -18
  384. package/src/plugins/builtin/portfolio-list/allocation-rows.ts +74 -0
  385. package/src/plugins/builtin/portfolio-list/cell-version.ts +1 -0
  386. package/src/plugins/builtin/portfolio-list/cli/period-report.ts +7 -3
  387. package/src/plugins/builtin/portfolio-list/cli/portfolio-command.ts +33 -3
  388. package/src/plugins/builtin/portfolio-list/cli/render.ts +149 -24
  389. package/src/plugins/builtin/portfolio-list/headless.ts +30 -9
  390. package/src/plugins/builtin/portfolio-list/income.ts +17 -8
  391. package/src/plugins/builtin/portfolio-list/index.tsx +4 -4
  392. package/src/plugins/builtin/portfolio-list/pane/fx-day-moves.ts +52 -0
  393. package/src/plugins/builtin/portfolio-list/pane/index.tsx +76 -9
  394. package/src/plugins/builtin/portfolio-list/pane/target-weights.tsx +178 -0
  395. package/src/plugins/builtin/portfolio-list/period-pnl.ts +44 -5
  396. package/src/plugins/builtin/portfolio-list/settings.ts +12 -6
  397. package/src/plugins/builtin/portfolio-list/summary/index.tsx +9 -4
  398. package/src/plugins/builtin/portfolio-list/summary/totals.ts +21 -2
  399. package/src/plugins/builtin/portfolio-list/table.tsx +33 -25
  400. package/src/plugins/builtin/power/gas.tsx +2 -2
  401. package/src/plugins/builtin/power/prices.tsx +2 -2
  402. package/src/plugins/builtin/primary-dealers/pane.tsx +10 -11
  403. package/src/plugins/builtin/rate-path/model.ts +9 -0
  404. package/src/plugins/builtin/rate-path/pane.tsx +6 -5
  405. package/src/plugins/builtin/realized-vol/fx-proxy.ts +27 -0
  406. package/src/plugins/builtin/realized-vol/headless.ts +8 -6
  407. package/src/plugins/builtin/realized-vol/pane.tsx +13 -7
  408. package/src/plugins/builtin/relative-rotation/pane.tsx +1 -1
  409. package/src/plugins/builtin/research/analyst-headless.ts +5 -1
  410. package/src/plugins/builtin/research/analyst-model.ts +7 -1
  411. package/src/plugins/builtin/research/analyst-pane.tsx +1 -1
  412. package/src/plugins/builtin/research/relative-valuation-basis.ts +44 -4
  413. package/src/plugins/builtin/research/relative-valuation-headless.ts +59 -14
  414. package/src/plugins/builtin/research/relative-valuation-model.ts +65 -26
  415. package/src/plugins/builtin/research/relative-valuation-pane.tsx +42 -17
  416. package/src/plugins/builtin/revenue-breakdown/pane.tsx +1 -1
  417. package/src/plugins/builtin/reverse-dcf/client.ts +34 -4
  418. package/src/plugins/builtin/reverse-dcf/headless.ts +30 -15
  419. package/src/plugins/builtin/reverse-dcf/model.ts +190 -29
  420. package/src/plugins/builtin/reverse-dcf/pane.tsx +35 -13
  421. package/src/plugins/builtin/risk-factors/pane.tsx +2 -2
  422. package/src/plugins/builtin/roadmap/pane.tsx +2 -2
  423. package/src/plugins/builtin/scanner/flow-pane.tsx +4 -4
  424. package/src/plugins/builtin/scanner/headless.ts +15 -1
  425. package/src/plugins/builtin/seasonality/pane.tsx +1 -1
  426. package/src/plugins/builtin/sec/fund-facts-view.tsx +5 -2
  427. package/src/plugins/builtin/sec/fund-facts.ts +41 -1
  428. package/src/plugins/builtin/sec/headless.ts +8 -4
  429. package/src/plugins/builtin/sec/index.tsx +41 -13
  430. package/src/plugins/builtin/shared/ticker-company.ts +111 -0
  431. package/src/plugins/builtin/shared/use-quote-board.ts +37 -2
  432. package/src/plugins/builtin/shared/volatility/live-session.ts +23 -0
  433. package/src/plugins/builtin/shared/volatility-indices.ts +2 -0
  434. package/src/plugins/builtin/short-interest/publications-pane.tsx +1 -1
  435. package/src/plugins/builtin/short-volume/pane.tsx +1 -1
  436. package/src/plugins/builtin/social-mentions/outliers.tsx +3 -3
  437. package/src/plugins/builtin/social-mentions/pane.tsx +2 -2
  438. package/src/plugins/builtin/supply-chain/graph-pane.tsx +1 -1
  439. package/src/plugins/builtin/supply-chain/pane.tsx +1 -1
  440. package/src/plugins/builtin/themes/pane.tsx +4 -4
  441. package/src/plugins/builtin/thirteenf/api.ts +1 -0
  442. package/src/plugins/builtin/thirteenf/format.ts +5 -0
  443. package/src/plugins/builtin/thirteenf/headless.ts +2 -2
  444. package/src/plugins/builtin/thirteenf/model.ts +128 -5
  445. package/src/plugins/builtin/thirteenf/overlap-pane.tsx +1 -1
  446. package/src/plugins/builtin/thirteenf/report-notes.ts +10 -3
  447. package/src/plugins/builtin/thirteenf/signals-pane.tsx +1 -1
  448. package/src/plugins/builtin/thirteenf/table.ts +2 -2
  449. package/src/plugins/builtin/thirteenf/types.ts +12 -0
  450. package/src/plugins/builtin/ticker-detail/data-panes/historical-prices.tsx +27 -14
  451. package/src/plugins/builtin/ticker-detail/data-panes/returns-history.ts +6 -3
  452. package/src/plugins/builtin/ticker-detail/data-panes/returns-model.ts +14 -0
  453. package/src/plugins/builtin/ticker-detail/data-panes/returns-pane.tsx +4 -1
  454. package/src/plugins/builtin/ticker-detail/financials/aggregation.ts +87 -19
  455. package/src/plugins/builtin/ticker-detail/financials/exchange-results.ts +54 -0
  456. package/src/plugins/builtin/ticker-detail/financials/model.ts +114 -9
  457. package/src/plugins/builtin/ticker-detail/financials/ratios.ts +37 -20
  458. package/src/plugins/builtin/ticker-detail/financials/tab.tsx +42 -19
  459. package/src/plugins/builtin/ticker-detail/headless-schema.ts +3 -2
  460. package/src/plugins/builtin/ticker-detail/headless.ts +90 -31
  461. package/src/plugins/builtin/ticker-detail/overview/model.ts +22 -15
  462. package/src/plugins/builtin/ticker-detail/overview-tab.tsx +5 -2
  463. package/src/plugins/builtin/ticker-detail/quote-monitor/card.tsx +12 -7
  464. package/src/plugins/builtin/ticker-detail/quote-monitor/index.tsx +21 -0
  465. package/src/plugins/builtin/trace-bonds/client.ts +107 -10
  466. package/src/plugins/builtin/trace-bonds/detail.tsx +1 -1
  467. package/src/plugins/builtin/trace-bonds/headless.ts +20 -5
  468. package/src/plugins/builtin/trace-bonds/pane.tsx +15 -4
  469. package/src/plugins/builtin/treasury-auctions/hk-view.tsx +1 -1
  470. package/src/plugins/builtin/treasury-auctions/pane.tsx +1 -1
  471. package/src/plugins/builtin/treasury-daily/pane.tsx +2 -2
  472. package/src/plugins/builtin/vol-surface/charts.tsx +30 -5
  473. package/src/plugins/builtin/vol-surface/client.ts +40 -12
  474. package/src/plugins/builtin/vol-surface/events.ts +213 -0
  475. package/src/plugins/builtin/vol-surface/headless.ts +82 -13
  476. package/src/plugins/builtin/vol-surface/index.tsx +5 -1
  477. package/src/plugins/builtin/vol-surface/model.ts +42 -6
  478. package/src/plugins/builtin/vol-surface/pane.tsx +95 -23
  479. package/src/plugins/builtin/volatility/dvol.ts +14 -2
  480. package/src/plugins/builtin/volatility/headless.ts +3 -2
  481. package/src/plugins/builtin/volatility/index.tsx +1 -1
  482. package/src/plugins/builtin/volatility/pane.tsx +1 -1
  483. package/src/plugins/builtin/volatility/series.ts +7 -3
  484. package/src/plugins/builtin/world-venue-map/activity-series.ts +89 -0
  485. package/src/plugins/builtin/world-venue-map/chokepoint-report.ts +123 -0
  486. package/src/plugins/builtin/world-venue-map/evidence.ts +2 -0
  487. package/src/plugins/builtin/world-venue-map/geo-series.ts +35 -1
  488. package/src/plugins/builtin/world-venue-map/headless.ts +58 -9
  489. package/src/plugins/builtin/world-venue-map/index.ts +6 -3
  490. package/src/plugins/builtin/world-venue-map/layered-pane.tsx +6 -1
  491. package/src/plugins/builtin/world-venue-map/pane.tsx +4 -3
  492. package/src/plugins/builtin/yield-curve/index.tsx +12 -10
  493. package/src/plugins/builtin/yield-curve/swaps.tsx +1 -1
  494. package/src/plugins/extracted-plugins.ts +14 -10
  495. package/src/plugins/installer.ts +17 -1
  496. package/src/plugins/marketplace/feed.ts +14 -0
  497. package/src/plugins/marketplace/install-offer.ts +64 -0
  498. package/src/plugins/registry/contributions.ts +46 -8
  499. package/src/plugins/registry/index.ts +5 -0
  500. package/src/portfolio/collection-name.ts +38 -4
  501. package/src/portfolio/column-values.ts +32 -4
  502. package/src/portfolio/period-pnl.ts +4 -2
  503. package/src/react/async-resource.ts +24 -8
  504. package/src/remote/endpoint.ts +38 -12
  505. package/src/remote/secrets.ts +22 -6
  506. package/src/remote/server.ts +20 -4
  507. package/src/renderers/dom/data-table/index.tsx +2 -1
  508. package/src/renderers/dom/data-table/row.tsx +49 -7
  509. package/src/renderers/dom/desktop/controls.tsx +2 -0
  510. package/src/renderers/dom/desktop/query-bar.tsx +57 -7
  511. package/src/renderers/dom/host/surface-3d.tsx +46 -5
  512. package/src/renderers/dom/styles.css +17 -0
  513. package/src/renderers/electrobun/view/backend-rpc.ts +15 -21
  514. package/src/renderers/electrobun/view/cli-pane-shot-entry.tsx +16 -61
  515. package/src/renderers/electrobun/view/cli-pane-shot-socket.ts +134 -0
  516. package/src/renderers/electrobun/view/host-route.ts +119 -0
  517. package/src/renderers/electrobun/view/rpc-timeout.ts +6 -5
  518. package/src/renderers/opentui/toast-host.tsx +6 -3
  519. package/src/renderers/opentui/ui-host.tsx +29 -5
  520. package/src/series/registry.ts +1 -0
  521. package/src/series/standalone-catalog.ts +40 -0
  522. package/src/series/types.ts +10 -0
  523. package/src/series/validate.ts +5 -0
  524. package/src/shares/portable-layout.ts +2 -7
  525. package/src/sources/gloomberb-cloud/dated-chunks.ts +133 -0
  526. package/src/sources/gloomberb-cloud/index.ts +46 -5
  527. package/src/sources/gloomberb-cloud/news.ts +15 -9
  528. package/src/sources/gloomberb-cloud/normalizers.ts +17 -0
  529. package/src/sources/history-coverage.ts +13 -0
  530. package/src/sources/history-result.ts +1 -0
  531. package/src/sources/provider-errors.ts +9 -0
  532. package/src/sources/provider-router/batches.ts +7 -3
  533. package/src/sources/provider-router/financial-routes.ts +3 -1
  534. package/src/sources/provider-router/history.ts +6 -4
  535. package/src/sources/provider-router/index.ts +5 -1
  536. package/src/sources/provider-router/primary.ts +4 -3
  537. package/src/sources/provider-router/retrieved-at.ts +12 -0
  538. package/src/team/store.ts +17 -4
  539. package/src/telemetry/crash-reports.ts +3 -1
  540. package/src/test-support/cli-context.ts +3 -2
  541. package/src/test-support/test-env.ts +7 -0
  542. package/src/theme/themes.ts +16 -9
  543. package/src/theme/tone-contrast.ts +29 -5
  544. package/src/tickers/company-name-listing.ts +31 -3
  545. package/src/tickers/company-name.ts +9 -0
  546. package/src/tickers/index-roots.ts +56 -4
  547. package/src/tickers/listing-name.ts +7 -2
  548. package/src/tickers/listing-venues.ts +17 -2
  549. package/src/tickers/search/home-listing.ts +2 -0
  550. package/src/tickers/search/index.ts +64 -11
  551. package/src/tickers/search/major-listings.json +595 -592
  552. package/src/tickers/search/ranking.ts +19 -1
  553. package/src/tickers/terminal-codes.ts +5 -3
  554. package/src/time-series/bar-aggregation.ts +3 -2
  555. package/src/time-series/base-series.ts +18 -1
  556. package/src/time-series/chart-data.ts +9 -6
  557. package/src/time-series/chart-seed.ts +11 -3
  558. package/src/time-series/currency-conversion.ts +1 -0
  559. package/src/time-series/date-window.ts +8 -0
  560. package/src/time-series/formula-months.ts +57 -0
  561. package/src/time-series/fundamentals/period-points.ts +3 -3
  562. package/src/time-series/fundamentals/source-statements.ts +5 -4
  563. package/src/time-series/leverage.ts +12 -4
  564. package/src/time-series/live-bars.ts +12 -7
  565. package/src/time-series/live-quotes.ts +6 -2
  566. package/src/time-series/market.ts +10 -3
  567. package/src/time-series/price-comparison.ts +106 -0
  568. package/src/time-series/range.ts +10 -0
  569. package/src/time-series/resolve-context.ts +7 -2
  570. package/src/time-series/resolve.ts +61 -5
  571. package/src/time-series/series-name.ts +2 -2
  572. package/src/time-series/series-presentation.ts +91 -2
  573. package/src/time-series/session-bar.ts +13 -7
  574. package/src/time-series/spec.ts +21 -2
  575. package/src/time-series/studies/formula.ts +262 -36
  576. package/src/time-series/studies/leverage.ts +9 -3
  577. package/src/time-series/studies/resolve.ts +7 -2
  578. package/src/time-series/types.ts +34 -0
  579. package/src/time-series/use-chart-resolution.ts +18 -1
  580. package/src/types/data-provider.ts +7 -0
  581. package/src/types/financials.ts +103 -1
  582. package/src/types/headless.ts +64 -3
  583. package/src/types/instrument.ts +6 -0
  584. package/src/types/plugin-context.ts +9 -0
  585. package/src/types/plugin-pane-templates.ts +6 -0
  586. package/src/types/plugin-panes.ts +7 -0
  587. package/src/types/price-history.ts +6 -0
  588. package/src/ui/host.tsx +3 -1
  589. package/src/ui/index.tsx +7 -2
  590. package/src/utils/cli-output.ts +21 -1
  591. package/src/utils/currency-units.ts +14 -0
  592. package/src/utils/datetime-format.ts +11 -0
  593. package/src/utils/exchange-announcements.ts +26 -3
  594. package/src/utils/exchange-notation.generated.ts +3 -4
  595. package/src/utils/exchange-results.ts +144 -0
  596. package/src/utils/exchanges.ts +10 -0
  597. package/src/utils/financial-statements.ts +212 -22
  598. package/src/utils/fire-and-forget.ts +1 -1
  599. package/src/utils/fiscal-period.ts +41 -3
  600. package/src/utils/format.ts +10 -6
  601. package/src/utils/fundamentals.ts +179 -12
  602. package/src/utils/futures-generic.ts +26 -0
  603. package/src/utils/lease-liabilities.ts +15 -5
  604. package/src/utils/lookup-token.ts +22 -0
  605. package/src/utils/max-drawdown.ts +25 -4
  606. package/src/utils/price-history-integrity.ts +56 -8
  607. package/src/utils/price-history.ts +6 -2
  608. package/src/utils/price-window.ts +38 -2
  609. package/src/utils/replace-file.ts +47 -0
  610. package/src/utils/rpc-timeout-error.ts +16 -2
  611. package/src/utils/untrusted-text.ts +14 -0
@@ -552,7 +552,25 @@ export function rankTickerSearchItems<T extends Pick<TickerSearchRankableItem, "
552
552
  if (boardFuture && futureIndex >= 0) {
553
553
  deduped.splice(boardFuture.bareCode ? 0 : Math.min(1, futureIndex), 0, ...deduped.splice(futureIndex, 1));
554
554
  }
555
- return deduped;
555
+ return withHeadlineIndexFirst(deduped, rawQuery);
556
+ }
557
+
558
+ /**
559
+ * An index named as typed leads the indices whose names only add to it:
560
+ * "BIST 100" is the BIST 100 (XU100.IS) before the BIST 100-30 and BIST 100
561
+ * (EURO), whatever order search sent them in. Any other list keeps its order.
562
+ */
563
+ function withHeadlineIndexFirst<T extends Pick<TickerSearchRankableItem, "detail"> & Partial<TickerSearchRankableItem>>(items: T[], query: string): T[] {
564
+ const name = normalizeSearchText(query);
565
+ const isIndex = (item: T) => /^\s*index\s*$/i.test(item.instrumentType ?? "");
566
+ const indexName = (item: T) => normalizeSearchText(item.detail.split("|")[0] ?? "");
567
+ const headline = items.findIndex((item) => isIndex(item) && indexName(item) === name);
568
+ if (!name || headline < 0) return items;
569
+ const first = items.findIndex((item, index) => index < headline && isIndex(item) && indexName(item).startsWith(`${name} `));
570
+ if (first < 0) return items;
571
+ const ordered = [...items];
572
+ ordered.splice(first, 0, ...ordered.splice(headline, 1));
573
+ return ordered;
556
574
  }
557
575
 
558
576
  // Folding accents keeps "Nestlé" matchable as "nestle" instead of "NESTL".
@@ -142,7 +142,7 @@ const BLOOMBERG_INDICES: Readonly<Record<string, string>> = {
142
142
  SPX: "^GSPC", INDU: "^DJI", CCMP: "^IXIC", NDX: "^NDX", RTY: "^RUT", VIX: "^VIX",
143
143
  UKX: "^FTSE", DAX: "^GDAXI", CAC: "^FCHI", SX5E: "^STOXX50E", SMI: "^SSMI", AEX: "^AEX", IBEX: "^IBEX",
144
144
  NKY: "^N225", HSI: "^HSI", KOSPI: "^KS11", TWSE: "^TWII", SENSEX: "^BSESN", NIFTY: "^NSEI", FSSTI: "^STI",
145
- AS51: "^AXJO", SPTSX: "^GSPTSE", MEXBOL: "^MXX", IBOV: "^BVSP", DXY: "DX-Y.NYB",
145
+ AS51: "^AXJO", SPTSX: "^GSPTSE", MEXBOL: "^MXX", IBOV: "^BVSP", XU100: "XU100.IS", DXY: "DX-Y.NYB",
146
146
  USGG5YR: "^FVX", USGG10YR: "^TNX", USGG30YR: "^TYX",
147
147
  };
148
148
 
@@ -441,8 +441,9 @@ const SLASH_CLASS = /^([A-Z]{2,5})\/([A-Z])$/;
441
441
  /**
442
442
  * `700.HK`, `03042.HK`, `00700:HKEX`: a Hong Kong code without its leading
443
443
  * zeros, or with the five digits HKEXnews and the Product Key Facts print.
444
+ * `3042.HKG` is the suffix some data vendors write for HKEX.
444
445
  */
445
- const HONG_KONG_CODE = /^(\d{1,5})(\.HK|:HKEX)$/;
446
+ const HONG_KONG_CODE = /^(\d{1,5})(\.HKG?|:HKEX)$/;
446
447
 
447
448
  /** A Hong Kong code as the app keys it: four digits at least (0700, 3042, 83042). */
448
449
  function hongKongWorkingCode(digits: string): string | null {
@@ -477,7 +478,8 @@ export function readNearMissListing(raw: string): NearMissListing | null {
477
478
  if (slash) return { typed, symbol: `${slash[1]}-${slash[2]}` };
478
479
  const hongKong = HONG_KONG_CODE.exec(upper);
479
480
  const code = hongKong ? hongKongWorkingCode(hongKong[1]!) : null;
480
- if (hongKong) return code && code !== hongKong[1] ? { typed, symbol: `${code}${hongKong[2]}` } : null;
481
+ const suffix = hongKong?.[2] === ".HKG" ? ".HK" : hongKong?.[2];
482
+ if (hongKong) return code && (code !== hongKong[1] || suffix !== hongKong[2]) ? { typed, symbol: `${code}${suffix}` } : null;
481
483
  const suffixed = MARKET_SUFFIX.exec(upper);
482
484
  if (!suffixed || !MARKET_SUFFIX_CODES.has(suffixed[2]!) || tickerHasListingSuffix(upper)) return null;
483
485
  const venue = BLOOMBERG_MARKETS[suffixed[2]!]!.venues[0]!;
@@ -4,7 +4,7 @@ import { futuresSessionOpenMinute, latestSessionStart, listingTimeZone } from ".
4
4
  import { isRoundTheClockCoin } from "../utils/crypto-pair";
5
5
  import { canonicalExchange } from "../utils/exchanges";
6
6
  import { futuresListingVenue } from "../utils/futures-generic";
7
- import { mergePriceHistoryIntegrity, pricePointIntegrity, type PriceHistoryIntegrity } from "../utils/price-history-integrity";
7
+ import { mergePriceHistoryIntegrity, pricePointIntegrity, pricePointOpenWithheld, type PriceHistoryIntegrity } from "../utils/price-history-integrity";
8
8
  import { getPricePointTimestamp } from "../utils/price-history";
9
9
  import { zonedDateTimeParts } from "../utils/zoned-date-time";
10
10
  import { isFiniteNumber } from "../utils/guards";
@@ -207,7 +207,8 @@ function buildBar(bucket: Bucket, intraday: boolean): AggregatedPricePoint {
207
207
  }
208
208
  return {
209
209
  date,
210
- open: isFiniteNumber(first.open) ? first.open : first.close,
210
+ // An open withheld as outside its bar's range (pricePointOpenWithheld) opens no longer bar either.
211
+ open: isFiniteNumber(first.open) && !pricePointOpenWithheld(first) ? first.open : first.close,
211
212
  high,
212
213
  low,
213
214
  close: last.close,
@@ -110,6 +110,23 @@ export function mergeHistory(
110
110
  return { ...base, quote, priceHistory };
111
111
  }
112
112
 
113
+ /**
114
+ * The listing a security series' label names: an index charted on the venue
115
+ * its own quote gave it, which is the name of its publisher (^NDX on NASDAQ
116
+ * GIDS, ^VIX on CBOE INDICES), is its symbol alone, as `quote ^NDX` names it.
117
+ */
118
+ function quotedInstrumentLabel(
119
+ source: Extract<ChartSeriesSpec["source"], { kind: "security" }>,
120
+ quote: Pick<Quote, "instrumentType" | "listingExchangeName" | "exchangeName"> | undefined,
121
+ quoteMetadata: Pick<QuoteMetadata, "instrumentType" | "listingExchangeName"> | null | undefined,
122
+ ): string {
123
+ const exchange = source.instrument.exchange?.trim().toUpperCase();
124
+ const index = isIndexLevel(quote?.instrumentType || quoteMetadata?.instrumentType);
125
+ const quoted = [quote?.listingExchangeName, quote?.exchangeName, quoteMetadata?.listingExchangeName]
126
+ .some((venue) => !!exchange && venue?.trim().toUpperCase() === exchange);
127
+ return index && quoted && !source.instrument.instrument ? source.instrument.symbol.trim() : instrumentLabel(source);
128
+ }
129
+
113
130
  export function baseSecuritySeries(
114
131
  spec: ChartSeriesSpec,
115
132
  financials: TickerFinancials,
@@ -126,7 +143,7 @@ export function baseSecuritySeries(
126
143
  const valuationFallback = dailyValuationFallbackPeriod(financials, spec.source);
127
144
  const unreportedPeriod = points.length === 0 ? unreportedStatementPeriod(financials, spec.source) : null;
128
145
  const notMeaningful = valuationNotMeaningful(financials, spec.source);
129
- const symbol = instrumentLabel(spec.source);
146
+ const symbol = quotedInstrumentLabel(spec.source, financials.quote, quoteMetadata);
130
147
  const statementCurrency = field.id.startsWith("fundamental.") && field.unit.startsWith("currency")
131
148
  ? reportingCurrencySeries(points, financials.financialCurrency) : null;
132
149
  // A broker contract names its currency even before (or without) a quote.
@@ -1,5 +1,5 @@
1
1
  import type { PricePoint, Quote } from "../types/financials";
2
- import { pricePointIntegrity } from "../utils/price-history-integrity";
2
+ import { pricePointIntegrity, pricePointOpenWithheld } from "../utils/price-history-integrity";
3
3
  import { isQuoteStaleForCurrentSession } from "../market-data/quotes/freshness";
4
4
  import { getRegularSessionBarClose } from "../market-data/market/status";
5
5
  import { latestRegularSessionClose, sessionCalendarTimeZone } from "../market-data/market/freshness";
@@ -103,20 +103,23 @@ function finiteOrFallback(value: number | undefined, fallback: number): number {
103
103
  }
104
104
 
105
105
  function mergeQuoteIntoLatestBar(latest: PricePoint, quotePrice: number, range?: QuoteSessionRange | null): PricePoint {
106
- if (pricePointIntegrity(latest)) {
106
+ // An open alone outside the bar's range is withheld (pricePointOpenWithheld): it sets no range of the merged bar.
107
+ const openWithheld = pricePointOpenWithheld(latest);
108
+ if (pricePointIntegrity(latest) || (openWithheld && range?.open !== undefined)) {
107
109
  // A later quote cannot establish which reported OHLC field was wrong, unless it names the bar's whole session: its
108
110
  // open, range and price are the bar (GOGL's 2026-10-30 daily bar, served with a high under its open).
109
111
  return range?.open === undefined ? latest : { ...latest, open: range.open, high: range.high, low: range.low, close: quotePrice };
110
112
  }
111
113
  const open = finiteOrFallback(latest.open, latest.close);
112
- const high = finiteOrFallback(latest.high, Math.max(open, latest.close));
113
- const low = finiteOrFallback(latest.low, Math.min(open, latest.close));
114
+ const body = openWithheld ? latest.close : open;
115
+ const high = finiteOrFallback(latest.high, Math.max(body, latest.close));
116
+ const low = finiteOrFallback(latest.low, Math.min(body, latest.close));
114
117
  // The bar keeps its own open: a weekly or monthly bar opened on an earlier day than the quote's session.
115
118
  return {
116
119
  ...latest,
117
120
  open,
118
- high: Math.max(high, open, latest.close, quotePrice, range?.high ?? quotePrice),
119
- low: Math.min(low, open, latest.close, quotePrice, range?.low ?? quotePrice),
121
+ high: Math.max(high, body, latest.close, quotePrice, range?.high ?? quotePrice),
122
+ low: Math.min(low, body, latest.close, quotePrice, range?.low ?? quotePrice),
120
123
  close: quotePrice,
121
124
  };
122
125
  }
@@ -10,7 +10,7 @@ import { aggregatePriceBars, futuresOpenMinuteOf, withBuiltBarSize } from "./bar
10
10
  import type { TickerFinancials } from "../types/financials";
11
11
  import { isMarketFieldId } from "./field-catalog";
12
12
  import { chartPriceHistoryIntegrityNotices } from "./market";
13
- import { resolveStudies } from "./studies/resolve";
13
+ import { activeStudyInputSeriesIds, resolveStudies } from "./studies/resolve";
14
14
  import { clipSeriesToWindow } from "./alignment";
15
15
  import { bufferPriceComparison, clipPriceComparison, priceComparisonBoundsForSeries, resolvePriceComparison } from "./price-comparison";
16
16
  import { readSeedListingFacts } from "./parsed-history-cache";
@@ -73,8 +73,12 @@ export function seedChartResolutionResult(
73
73
  // the swap changes no label and moves no plot.
74
74
  const support: ChartResolutionSupport[][] = [];
75
75
  const series: ResolvedSeries[] = [];
76
+ // A hidden series a study reads (a formula's next month) is the study's input alone, never drawn.
77
+ const studyInputs = activeStudyInputSeriesIds(spec.studies);
78
+ const hiddenInputs: ResolvedSeries[] = [];
76
79
  spec.series.forEach((seriesSpec, index) => {
77
- if (seriesSpec.visible === false || seriesSpec.source.kind !== "security") return;
80
+ const hidden = seriesSpec.visible === false;
81
+ if ((hidden && !studyInputs.has(seriesSpec.id)) || seriesSpec.source.kind !== "security") return;
78
82
  if (!isMarketFieldId(seriesSpec.source.fieldId)) return;
79
83
  const history = historyByInstrument.get(instrumentKey(seriesSpec.source));
80
84
  if (!history?.length) return;
@@ -84,6 +88,10 @@ export function seedChartResolutionResult(
84
88
  const base = baseSecuritySeries(seriesSpec, emptyFinancials(bars), index, resolution, facts?.quoteMetadata, facts?.contractUnit);
85
89
  const resolved = base && builtBarSize ? withBuiltBarSize(base, builtBarSize) : base;
86
90
  if (!resolved?.points.length) return;
91
+ if (hidden) {
92
+ hiddenInputs.push(resolved);
93
+ return;
94
+ }
87
95
  series.push(resolved);
88
96
  if (facts?.resolutionSupport?.length) support.push(facts.resolutionSupport);
89
97
  });
@@ -109,7 +117,7 @@ export function seedChartResolutionResult(
109
117
  const baseSeries = series.map((entry) => prepareBaseSeriesForStudies(entry, priceComparisonBoundsForSeries(entry, priceComparison) ?? comparisonBounds));
110
118
  // Calculate studies from raw buffered inputs, then use the same presentation
111
119
  // and visible-window rules as the network result.
112
- const studies = resolveStudies(series, spec.studies, resolution, undefined, studyAnchors(series, priceComparison, comparisonBounds));
120
+ const studies = resolveStudies([...series, ...hiddenInputs], spec.studies, resolution, undefined, studyAnchors(series, priceComparison, comparisonBounds));
113
121
  const axisWarnings: string[] = [];
114
122
  const bufferedSeries = assignAxes([
115
123
  ...baseSeries,
@@ -68,6 +68,7 @@ function convertPricePoints(
68
68
  ...point.high !== undefined ? { high: scaled(point.high, factor) } : {},
69
69
  ...point.low !== undefined ? { low: scaled(point.low, factor) } : {},
70
70
  ...point.close !== undefined ? { close: scaled(point.close, factor) } : {},
71
+ conversionFactor: (point.conversionFactor ?? 1) * factor,
71
72
  });
72
73
  }
73
74
  return { points: converted, missing };
@@ -3,6 +3,14 @@ import { calendarMonthsBefore } from "../utils/calendar-date";
3
3
 
4
4
  export interface DateWindowRange extends ChartDateWindow {}
5
5
 
6
+ /**
7
+ * How far back a read of ALL follows a history whose bars reach the start of
8
+ * ALL's own window (fifty years): 125 years, past the first bar any source
9
+ * keeps (the S&P 500's daily closes start in 1927), so ALL is the whole
10
+ * stored history. The window ALL asks for first stays fifty years.
11
+ */
12
+ export const ALL_HISTORY_REACH_MONTHS = 1_500;
13
+
6
14
  export function subtractTimeRange(endDate: Date, range: TimeRange): Date {
7
15
  // Research bounds follow source instants and UTC date keys, independently
8
16
  // of the viewing computer's timezone and daylight-saving transitions.
@@ -0,0 +1,57 @@
1
+ import { futuresContractByCode } from "../market-data/futures-board";
2
+ import { continuousFuturesRoot } from "../utils/futures-generic";
3
+ import { isFiniteNumber } from "../utils/guards";
4
+ import { FORMULA_NEXT_MONTH_OF, FORMULA_ROLLS_WITH } from "./studies/formula";
5
+ import type { ChartResolutionResult, ChartSeriesSpec, ChartSpec } from "./types";
6
+
7
+ /** The id of a formula leg's next listed month, which no saved chart holds: it is added to a chart as it resolves. */
8
+ const NEXT_MONTH_ID = ":next-month:";
9
+
10
+ /**
11
+ * A chart whose formulas price their legs in one delivery month (`rollsWith`,
12
+ * the 3-2-1 crack), with each continuous leg besides the one it rolls with
13
+ * read in its second generic too: RB2 beside RB=F. Between crude's roll and
14
+ * the products' (CLZ26 beside RBX26), the products' second month is the
15
+ * month crude holds. RB2 is the month after RB1, which can be another than
16
+ * the month after RB=F, so the formula takes it only where it is the
17
+ * leader's month (formulaLegPricer). Hidden inputs of the formula alone,
18
+ * never saved or drawn. A root that does not list every month has no next
19
+ * month to take; its leg stays as served.
20
+ */
21
+ export function withFormulaNextMonths(spec: ChartSpec): ChartSpec {
22
+ const added: ChartSeriesSpec[] = [];
23
+ const studies = spec.studies.map((study) => {
24
+ const rollsWith = study.parameters[FORMULA_ROLLS_WITH];
25
+ if (study.kind !== "formula" || study.visible === false || !isFiniteNumber(rollsWith)) return study;
26
+ const inputSeriesIds = [...study.inputSeriesIds];
27
+ const parameters = { ...study.parameters };
28
+ const before = added.length;
29
+ study.inputSeriesIds.forEach((id, index) => {
30
+ if (index === rollsWith - 1 || !isFiniteNumber(study.parameters[`weight${index + 1}`])) return;
31
+ const series = spec.series.find((entry) => entry.id === id);
32
+ if (series?.source.kind !== "security" || series.source.instrument.instrument || series.source.instrument.brokerId) return;
33
+ const root = continuousFuturesRoot(series.source.instrument.symbol);
34
+ if (!root || !futuresContractByCode(root)?.everyMonth) return;
35
+ const nextId = `${study.id}${NEXT_MONTH_ID}${index + 1}`;
36
+ added.push({
37
+ ...series, id: nextId, label: `${root}2`, visible: false,
38
+ source: { ...series.source, instrument: { symbol: `${root}2`, exchange: "" } },
39
+ });
40
+ inputSeriesIds.push(nextId);
41
+ parameters[`${FORMULA_NEXT_MONTH_OF}${inputSeriesIds.length}`] = index + 1;
42
+ });
43
+ return added.length > before ? { ...study, inputSeriesIds, parameters } : study;
44
+ });
45
+ return added.length ? { ...spec, series: [...spec.series, ...added], studies } : spec;
46
+ }
47
+
48
+ /** A series `withFormulaNextMonths` added: a formula's hidden input, which no message, coverage or integrity notice names. */
49
+ export function isFormulaNextMonth(seriesId: string): boolean {
50
+ return seriesId.includes(NEXT_MONTH_ID);
51
+ }
52
+
53
+ /** A resolved chart without the next months `withFormulaNextMonths` added: they are a formula's inputs, not the chart's series. */
54
+ export function withoutFormulaNextMonths(result: ChartResolutionResult): ChartResolutionResult {
55
+ if (!result.legendSeries?.some((entry) => isFormulaNextMonth(entry.id))) return result;
56
+ return { ...result, legendSeries: result.legendSeries.filter((entry) => !isFormulaNextMonth(entry.id)) };
57
+ }
@@ -1,7 +1,7 @@
1
1
  // Turns a statement into a dated series point, and keeps one point per financial period.
2
2
  import type { FinancialStatement } from "../../types/financials";
3
3
  import { areNearbyFinancialPeriodEnds } from "../../utils/financial-statements";
4
- import { fiscalPeriodLabel, ttmPeriodLabel } from "../../utils/fiscal-period";
4
+ import { statementPeriodLabel, ttmPeriodLabel } from "../../utils/fiscal-period";
5
5
  import { hasStatementGap } from "../../utils/statement-gaps";
6
6
  import type { SecuritySeriesSource, TimeSeriesPoint } from "../types";
7
7
  import { validDate } from "./statement";
@@ -33,8 +33,8 @@ export function pointForStatement(
33
33
  // Providers do not supply a reliable issuer fiscal-year/quarter identity.
34
34
  // Calendar-month numbering would mislabel non-calendar fiscal years.
35
35
  periodLabel: `${period === "annual" ? "Year" : period === "ttm" ? "TTM" : "Quarter"} ended ${statement.date}`,
36
- // The period as FA's columns name it (`Q3 FY26`), which the legend prints beside the value.
37
- fiscalPeriod: period === "ttm" ? ttmPeriodLabel(statement.date, yearEndMonth) : fiscalPeriodLabel(statement.date, period, yearEndMonth),
36
+ // The period as FA's columns name it (`Q3 FY26`, a filled half `H1 FY26`), which the legend prints beside the value.
37
+ fiscalPeriod: period === "ttm" ? ttmPeriodLabel(statement.date, yearEndMonth) : statementPeriodLabel(statement, period, yearEndMonth),
38
38
  provenance: {
39
39
  quality: derived || (metric === "eps" && statement.epsBasis?.factor !== undefined && statement.epsBasis.factor !== 1) ? "derived" : "reported",
40
40
  ...((metric === "eps" || metric === "trailingPE") && statement.epsBasis ? { secEpsBasis: statement.epsBasis } : {}),
@@ -1,6 +1,6 @@
1
1
  // Chooses the statements a series is read from for a period and metric: annual, quarterly, trailing, or dated at release.
2
2
  import type { FinancialStatement, TickerFinancials } from "../../types/financials";
3
- import { areNearbyFinancialPeriodEnds, statementFieldAvailability } from "../../utils/financial-statements";
3
+ import { areNearbyFinancialPeriodEnds, quarterRows, statementFieldAvailability } from "../../utils/financial-statements";
4
4
  import { hasStatementGap } from "../../utils/statement-gaps";
5
5
  import { statementAtRelease } from "../valuation-releases";
6
6
  import type { SeriesPeriod } from "../types";
@@ -32,9 +32,9 @@ export function knownWhenFiled(row: FinancialStatement): FinancialStatement {
32
32
  return { ...row, fieldAvailability: { ...row.fieldAvailability, eps: filed } };
33
33
  }
34
34
 
35
- /** The statements a multiple is priced from, each restated EPS dated by its first filing. */
35
+ /** The statements a multiple is priced from, each restated EPS dated by its first filing. A half filled into the quarterly list is no quarter. */
36
36
  export function valuationStatements(financials: TickerFinancials): { quarterly: FinancialStatement[]; annual: FinancialStatement[] } {
37
- return { quarterly: financials.quarterlyStatements.map(knownWhenFiled), annual: financials.annualStatements.map(knownWhenFiled) };
37
+ return { quarterly: quarterRows(financials.quarterlyStatements).map(knownWhenFiled), annual: financials.annualStatements.map(knownWhenFiled) };
38
38
  }
39
39
 
40
40
  /**
@@ -100,7 +100,8 @@ export function sourceStatements(
100
100
  const normalized = normalizeFundamentalPeriod(period);
101
101
  let known = valuationMetric
102
102
  ? valuationStatements(financials)
103
- : { quarterly: financials.quarterlyStatements, annual: financials.annualStatements };
103
+ // A half filled into the quarterly list is no quarter: never a quarterly point, a fourth quarter's input or a TTM's.
104
+ : { quarterly: quarterRows(financials.quarterlyStatements), annual: financials.annualStatements };
104
105
  if (period === "daily" && valuationMetric) {
105
106
  const releases = financials.earningsReleases ?? [];
106
107
  const venue = financials.quote?.listingExchangeName || financials.quote?.exchangeName || exchange;
@@ -30,19 +30,27 @@ export function leverageSymbol(series: Pick<ResolvedSeries, "listing" | "label">
30
30
  interface SessionClose {
31
31
  day: string;
32
32
  point: TimeSeriesPoint;
33
+ /** In the listing's own currency, whatever currency the chart is in. */
33
34
  close: number;
35
+ /** What the chart's currency multiplied the close by that day (1 when it is the listing's own). */
36
+ fx: number;
34
37
  }
35
38
 
36
- /** A series' closes from its anchor to its end, one per session, oldest first. */
39
+ /**
40
+ * A series' closes from its anchor to its end, one per session, oldest first,
41
+ * in its listing's own currency: a daily objective is the fund's own-currency
42
+ * return, so a chart in euros must not compound EUR/USD into it.
43
+ */
37
44
  export function sessionCloses(series: ResolvedSeries, anchor: StudyAnchor | undefined): SessionClose[] {
38
45
  const closes = new Map<string, SessionClose>();
39
46
  for (const point of series.points) {
40
47
  const time = point.date.getTime();
41
- const close = scalarPointValue(point);
42
- if (close === null || !Number.isFinite(close) || close <= 0) continue;
48
+ const value = scalarPointValue(point);
49
+ const fx = point.conversionFactor ?? 1;
50
+ if (value === null || !Number.isFinite(value) || value <= 0 || !(fx > 0)) continue;
43
51
  if (anchor?.start != null && time < anchor.start) continue;
44
52
  if (anchor?.end != null && time > anchor.end) continue;
45
- closes.set(observationDate(time, series), { day: observationDate(time, series), point, close });
53
+ closes.set(observationDate(time, series), { day: observationDate(time, series), point, close: value / fx, fx });
46
54
  }
47
55
  return [...closes.values()].sort((left, right) => left.day.localeCompare(right.day));
48
56
  }
@@ -1,7 +1,7 @@
1
1
  import type { PricePoint, Quote } from "../types/financials";
2
2
  import type { HistorySession } from "../types/price-history";
3
3
  import { hasLikelyQuoteUnitMismatch } from "../utils/currency-units";
4
- import { pricePointIntegrity } from "../utils/price-history-integrity";
4
+ import { pricePointIntegrity, pricePointOpenWithheld } from "../utils/price-history-integrity";
5
5
  import {
6
6
  calendarBarStart,
7
7
  isCalendarResolution,
@@ -77,7 +77,8 @@ function anchorKey(point: PricePoint, time: number): string {
77
77
  }
78
78
 
79
79
  function foldIntoBar(bar: PricePoint, observation: PricePoint): PricePoint {
80
- const open = isFiniteNumber(bar.open) ? bar.open : bar.close;
80
+ // A withheld open (pricePointOpenWithheld) sets no range of the bar a print folds into.
81
+ const open = isFiniteNumber(bar.open) && !pricePointOpenWithheld(bar) ? bar.open : bar.close;
81
82
  const extremes = pricePointIntegrity(observation) ? [] : [observation.high, observation.low];
82
83
  const prices = [bar.high, bar.low, open, bar.close, observation.close, ...extremes].filter(isFiniteNumber);
83
84
  const volume = isFiniteNumber(bar.volume) || isFiniteNumber(observation.volume)
@@ -368,7 +369,10 @@ export class LiveBarAccumulator {
368
369
  const anchor = this.anchor!;
369
370
  if (anchor.point?.source === latest && anchor.point.version === this.version) return anchor.point.value;
370
371
  let value = latest;
371
- if (pricePointIntegrity(latest)) {
372
+ // An open alone outside the bar's range is withheld (pricePointOpenWithheld): a quote that names the whole session
373
+ // says which field was wrong (GOGL's high, not its open), else the rest of the bar stands and the open sets no range.
374
+ const openWithheld = pricePointOpenWithheld(latest);
375
+ if (pricePointIntegrity(latest) || (openWithheld && anchor.open !== null && anchor.close !== null)) {
372
376
  // A later quote cannot establish which reported OHLC field was wrong, unless it names the bar's whole session:
373
377
  // its open, range, price and count are the bar (mergeQuoteIntoLatestBar).
374
378
  if (anchor.open !== null && anchor.close !== null) {
@@ -385,13 +389,14 @@ export class LiveBarAccumulator {
385
389
  if (anchor.close !== null) {
386
390
  const close = anchor.close;
387
391
  const open = isFiniteNumber(latest.open) ? latest.open : latest.close;
388
- const high = isFiniteNumber(latest.high) ? latest.high : Math.max(open, latest.close);
389
- const low = isFiniteNumber(latest.low) ? latest.low : Math.min(open, latest.close);
392
+ const body = openWithheld ? latest.close : open;
393
+ const high = isFiniteNumber(latest.high) ? latest.high : Math.max(body, latest.close);
394
+ const low = isFiniteNumber(latest.low) ? latest.low : Math.min(body, latest.close);
390
395
  value = {
391
396
  ...latest,
392
397
  open,
393
- high: Math.max(high, open, latest.close, anchor.high ?? close, close),
394
- low: Math.min(low, open, latest.close, anchor.low ?? close, close),
398
+ high: Math.max(high, body, latest.close, anchor.high ?? close, close),
399
+ low: Math.min(low, body, latest.close, anchor.low ?? close, close),
395
400
  close,
396
401
  ...(volume !== latest.volume ? { volume } : {}),
397
402
  };
@@ -4,6 +4,7 @@ import type { QuoteSubscriptionTarget } from "../types/data-provider";
4
4
  import type { Quote } from "../types/financials";
5
5
  import type { ChartSeriesSpec, ChartSpec, SecuritySeriesSource } from "./types";
6
6
  import { activeStudyInputSeriesIds } from "./studies/resolve";
7
+ import { withFormulaNextMonths } from "./formula-months";
7
8
  import { valuationSeriesUsesLiveQuote } from "./fundamentals";
8
9
  import { hasValidQuoteObservationTime } from "../market-data/quotes/freshness";
9
10
  import type { InstrumentRef } from "../market-data/request-types";
@@ -41,12 +42,15 @@ function supportsLiveQuote(
41
42
  /**
42
43
  * Displayed or study-required quote-sensitive instruments, deduplicated by
43
44
  * routing identity. `visible: false` marks a chart that is not on screen, so
44
- * its quotes arrive at the off-screen cadence.
45
+ * its quotes arrive at the off-screen cadence. A formula priced in one
46
+ * delivery month follows its legs' next months too (RB2 beside RB=F), so its
47
+ * latest value is in one month between the rolls, as its settled ones are.
45
48
  */
46
49
  export function getLiveChartQuoteTargets(
47
- spec: ChartSpec,
50
+ chart: ChartSpec,
48
51
  priority: { selected?: boolean; visible?: boolean } = {},
49
52
  ): QuoteSubscriptionTarget[] {
53
+ const spec = withFormulaNextMonths(chart);
50
54
  const targets = new Map<string, QuoteSubscriptionTarget>();
51
55
  const activeStudyInputs = activeStudyInputSeriesIds(spec.studies);
52
56
  for (const series of spec.series) {
@@ -1,5 +1,5 @@
1
1
  import type { PricePoint, TickerFinancials } from "../types/financials";
2
- import { pricePointIntegrity, pricePointValues, pricePointWicks, priceHistoryIntegrityNotice, mergePriceHistoryIntegrity, type PriceHistoryIntegrity } from "../utils/price-history-integrity";
2
+ import { pricePointIntegrity, pricePointOpenWithheld, pricePointValues, pricePointWicks, priceHistoryIntegrityNotice, mergePriceHistoryIntegrity, type PriceHistoryIntegrity } from "../utils/price-history-integrity";
3
3
  import { canonicalTimeSeriesFieldId, isFundamentalFieldId, isMarketFieldId } from "./field-catalog";
4
4
  import { extractFundamentalSeries } from "./fundamentals";
5
5
  import type { ChartSeriesPriceHistoryIntegrity, ResolvedSeries, SecuritySeriesSource, SeriesPeriod, TimeSeriesPoint } from "./types";
@@ -72,7 +72,8 @@ function aggregatePriceHistory(
72
72
  const buckets = new Map<string, AggregatedPricePoint>();
73
73
  for (const point of sorted) {
74
74
  const key = periodKey(point.date, period);
75
- const open = isFiniteNumber(point.open) ? point.open : point.close;
75
+ // An open withheld as outside its bar's range (pricePointOpenWithheld) opens no week or month either.
76
+ const open = isFiniteNumber(point.open) && !pricePointOpenWithheld(point) ? point.open : point.close;
76
77
  // A wick too far from its bar's body to have traded does not set the week's or month's range.
77
78
  const wicks = pricePointWicks(point);
78
79
  const high = isFiniteNumber(wicks.high) ? wicks.high : isFiniteNumber(point.high) ? Math.max(open, point.close) : point.close;
@@ -108,7 +109,9 @@ export function extractPriceSeries(
108
109
  const fieldId = canonicalTimeSeriesFieldId(source.fieldId);
109
110
  if (!isMarketFieldId(fieldId)) return [];
110
111
  const aggregated = aggregatePriceHistory(priceHistory, source.period ?? "auto");
111
- return aggregated.map((point) => {
112
+ return aggregated.map((point, index) => {
113
+ // A roll is the contract changing from the bar before, which a window's first bar knows from the bars before it.
114
+ const before = index > 0 ? aggregated[index - 1]!.contract : undefined;
112
115
  const { integrity, ...values } = pricePointValues(point, point.integrity);
113
116
  const value = fieldId === "market.open"
114
117
  ? values.open
@@ -125,6 +128,10 @@ export function extractPriceSeries(
125
128
  availableAt: new Date(point.date),
126
129
  value,
127
130
  ...values,
131
+ // A continuous future's bar names its contract, and the source marks a bar still forming.
132
+ ...(point.contract ? { contract: point.contract } : {}),
133
+ ...(point.contract && before && point.contract !== before ? { roll: true } : {}),
134
+ ...(point.partial ? { partial: true } : {}),
128
135
  provenance: { quality: "reported" as const, ...(integrity ? { priceHistoryIntegrity: integrity } : {}) },
129
136
  };
130
137
  });
@@ -1,9 +1,11 @@
1
1
  import { scalarPointValue } from "./alignment";
2
2
  import { getTimeSeriesField } from "./field-catalog";
3
3
  import type { ChartSpec, ResolvedSeries, TimeSeriesPoint } from "./types";
4
+ import type { SplitAction } from "../types/financials";
4
5
  import { CHART_RESOLUTION_STEP_MS, chartBarSizeSource, getChartResolutionLabel, isIntradayResolution, type ManualChartResolution } from "./resolution";
5
6
  import type { TimeRange } from "./range";
6
7
  import { zonedDateTimeParts } from "../utils/zoned-date-time";
8
+ import { isCurrencyCode } from "../utils/currency-pair";
7
9
  import { priceComparisonCloseTimes } from "./coin-session-close";
8
10
  import { barLastSession } from "../market-data/market/bar-period";
9
11
  import {
@@ -165,6 +167,28 @@ export function priceComparisonSeriesIds(spec: ChartSpec): string[] | null {
165
167
  return visible.map((entry) => entry.id);
166
168
  }
167
169
 
170
+ /**
171
+ * The currency each compared leg's return is in, by series id, where the
172
+ * chart would not say it otherwise: every leg's own currency when
173
+ * they are in more than one (GUBRF.IS in TRY beside NTR in USD), or the
174
+ * chart's `viewport.currency` for every leg it converts. Empty for legs all in
175
+ * one currency, the chart's own, or a currency their unit does not name.
176
+ */
177
+ export function comparisonLegCurrencies(
178
+ series: readonly Pick<ResolvedSeries, "id" | "unit" | "rawUnit" | "convertedFrom">[],
179
+ seriesIds: readonly string[] | null | undefined,
180
+ target?: string,
181
+ ): Map<string, string> {
182
+ const compared = new Set(seriesIds ?? []);
183
+ const legs = series.flatMap((entry) => {
184
+ // The currency the price unit leads with: `TRY`, `TRY/share`, `USD / gallon`.
185
+ const unit = /^([A-Za-z]{3})(?![A-Za-z])/.exec((entry.rawUnit ?? entry.unit).trim())?.[1]?.toUpperCase();
186
+ return compared.has(entry.id) && unit && isCurrencyCode(unit) ? [{ id: entry.id, currency: unit, converted: !!entry.convertedFrom }] : [];
187
+ });
188
+ if (target ? !legs.some((leg) => leg.converted) : new Set(legs.map((leg) => leg.currency)).size < 2) return new Map();
189
+ return new Map(legs.map((leg) => [leg.id, leg.currency] as const));
190
+ }
191
+
168
192
  /**
169
193
  * What a total-return chart's price levels are when it is not a comparison (the
170
194
  * raw price axis): prices with cash distributions reinvested, not what the
@@ -184,6 +208,88 @@ export function priceLevelsNotice(spec: ChartSpec, series: readonly ResolvedSeri
184
208
  priceOnly.length ? ` Price only for ${priceOnly.join(", ")}: distribution history unavailable.` : ""}`;
185
209
  }
186
210
 
211
+ /** `10-for-1` or `1-for-20 reverse`: a split by whole share counts, as its source states it; null for anything else (a spinoff's price adjustment). */
212
+ function splitTerms(split: SplitAction): string | null {
213
+ const { fromFactor: from, toFactor: to } = split;
214
+ if (!Number.isInteger(from) || !Number.isInteger(to) || from! <= 0 || to! <= 0 || from === to) return null;
215
+ return `${to}-for-${from}${to! < from! ? " reverse" : ""}`;
216
+ }
217
+
218
+ /** A close more than this many times the one before it, or less than its fraction, is no day a split-adjusted series moves by. */
219
+ const UNEXPLAINED_JUMP = 5;
220
+
221
+ /** `18.4`, `20`, `5.23`: a jump's factor in three digits. */
222
+ function jumpFactorText(ratio: number): string {
223
+ return String(Number(Math.max(ratio, 1 / ratio).toPrecision(3)));
224
+ }
225
+
226
+ /**
227
+ * Each jump of a leg's closes inside its window: a close over UNEXPLAINED_JUMP
228
+ * times the one before it or under its fraction. "SOXS falls 18.4× on Tue 26
229
+ * May with no split recorded that day", or on a split's own day, "the day of
230
+ * its 1-for-20 reverse split, unadjusted".
231
+ */
232
+ function legJumps(
233
+ label: string,
234
+ points: ReadonlyArray<{ date: Date; value: number | null }>,
235
+ window: { baseDay: string; endDay: string },
236
+ splits: readonly SplitAction[],
237
+ currentYear: number,
238
+ ): string[] {
239
+ const jumps: string[] = [];
240
+ let previous: number | null = null;
241
+ for (const point of points) {
242
+ const value = point.value;
243
+ if (typeof value !== "number" || !Number.isFinite(value) || value <= 0) continue;
244
+ const day = point.date.toISOString().slice(0, 10);
245
+ const ratio = previous === null ? 1 : value / previous;
246
+ previous = value;
247
+ if (day <= window.baseDay || day > window.endDay || (ratio <= UNEXPLAINED_JUMP && ratio >= 1 / UNEXPLAINED_JUMP)) continue;
248
+ const split = splits.find((entry) => entry.date.slice(0, 10) === day);
249
+ const terms = split ? splitTerms(split) : null;
250
+ jumps.push(`${label} ${ratio < 1 ? "falls" : "rises"} ${jumpFactorText(ratio)}× on ${periodDayText(day, currentYear)}${
251
+ terms ? `, the day of its ${terms} split, unadjusted` : " with no split recorded that day"}`);
252
+ }
253
+ return jumps;
254
+ }
255
+
256
+ /**
257
+ * The splits a comparison's returns run across, by leg: one that took effect
258
+ * after a leg's base close and by its end (its `PriceComparison.legs` days).
259
+ * The closes compared are split-adjusted, so a fund that reverse-split twice
260
+ * reads its return, not its share price: "Splits in range: SOXS 1-for-20
261
+ * reverse on Thu 5 Mar and 1-for-10 reverse on Wed 15 Jul; returns are
262
+ * split-adjusted." That is said only when no leg's closes jump inside its
263
+ * window (legJumps): a jump is named instead, a split or not, and the returns
264
+ * across it called unreliable. Null when no leg has a split or a jump.
265
+ */
266
+ export function comparisonSplitNotice(
267
+ comparison: Pick<PriceComparison, "legs">,
268
+ legs: ReadonlyArray<{ id: string; label: string; splits: readonly SplitAction[]; points?: ReadonlyArray<{ date: Date; value: number | null }> }>,
269
+ now = Date.now(),
270
+ ): string | null {
271
+ const currentYear = new Date(now).getUTCFullYear();
272
+ const named: string[] = [];
273
+ const jumps: string[] = [];
274
+ for (const { id, label, splits, points } of legs) {
275
+ const window = comparison.legs?.[id];
276
+ if (!window) continue;
277
+ const inside = splits
278
+ .filter((split) => /^\d{4}-\d{2}-\d{2}/.test(split.date) && split.date.slice(0, 10) > window.baseDay && split.date.slice(0, 10) <= window.endDay)
279
+ .sort((left, right) => left.date.localeCompare(right.date))
280
+ .flatMap((split) => {
281
+ const terms = splitTerms(split);
282
+ return terms ? [`${terms} on ${periodDayText(split.date, currentYear)}`] : [];
283
+ });
284
+ if (inside.length) named.push(`${label} ${listLabels(inside)}`);
285
+ if (points) jumps.push(...legJumps(label, points, window, splits, currentYear));
286
+ }
287
+ const splitsLine = named.length ? `Splits in range: ${named.join("; ")}` : null;
288
+ if (!jumps.length) return splitsLine && `${splitsLine}; returns are split-adjusted.`;
289
+ const jumpsLine = `${jumps.join("; ")}, so the returns across ${jumps.length === 1 ? "it" : "them"} are unreliable.`;
290
+ return splitsLine ? `${splitsLine}. ${jumpsLine}` : jumpsLine;
291
+ }
292
+
187
293
  /**
188
294
  * The bar size intraday legs are matched in: the chart's, or when it has none
189
295
  * the coarsest the legs were served in. Null when neither is intraday.
@@ -15,6 +15,16 @@ export interface ChartDateWindow {
15
15
  }
16
16
 
17
17
  export const TIME_RANGES: TimeRange[] = ["1D", "1W", "1M", "3M", "6M", "1Y", "5Y", "ALL"];
18
+
19
+ /**
20
+ * Throws for a range that is none of TIME_RANGES: a plugin asking for "20Y"
21
+ * hears which ranges there are rather than getting another range's bars.
22
+ */
23
+ export function assertTimeRange(range: unknown): asserts range is TimeRange {
24
+ if (typeof range === "string" && (TIME_RANGES as string[]).includes(range)) return;
25
+ const shown = typeof range === "string" ? `"${range}"` : String(range);
26
+ throw new Error(`Unknown range ${shown}: use one of ${TIME_RANGES.join(", ")}, or a dated request (getDetailedPriceHistoryWithMetadata) for any other window.`);
27
+ }
18
28
  export const CHART_RESOLUTIONS: ChartResolution[] = [
19
29
  "auto",
20
30
  "1m",