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
@@ -16,7 +16,7 @@ import {
16
16
  import { colors, priceColor } from "../../../../theme/colors";
17
17
  import { fiscalYearEndMonth } from "../../../../utils/fiscal-period";
18
18
  import { padTo } from "../../../../utils/format";
19
- import { filledPeriodsNote, stalePeriodNote } from "../../../../utils/financial-statements";
19
+ import { filledPeriodPublications, filledPeriodsNote, stalePeriodNote } from "../../../../utils/financial-statements";
20
20
  import {
21
21
  FINANCIAL_COL_W,
22
22
  financialLabelWidth,
@@ -34,11 +34,13 @@ import {
34
34
  financialSubTabFields,
35
35
  formatFinancialValue,
36
36
  latestFinancialPeriodEnd,
37
+ notInYetNote,
37
38
  resolveFinancialPeriod,
38
39
  resolveFinancialPeriodOption,
39
40
  semanticGrowthValue,
40
41
  selectFinancialStatements,
41
42
  shareFinancialUnit,
43
+ splitPeriodsNotInYet,
42
44
  statementMetricValue,
43
45
  type FinancialPeriod,
44
46
  type FinancialTableRow,
@@ -58,6 +60,7 @@ import {
58
60
  type RatioAmount,
59
61
  } from "./ratios";
60
62
  import { PeriodEndHistoryLoader, RatioTable, ratioMetricColumn, type PeriodEndHistoryState, type RatioTableColumn } from "./ratio-table";
63
+ import { useExchangeResultsNotes } from "./exchange-results";
61
64
  import { latestBalanceSheetDate, useOfferingNote } from "./offerings";
62
65
  import { useBoundTicker } from "../../shared/ticker-request";
63
66
  import { createValuationCurrencyContext } from "../../../../time-series/valuation-currency";
@@ -291,20 +294,35 @@ export function ResolvedFinancialsTab({
291
294
 
292
295
  const resolvedPeriod = resolveFinancialPeriod(period, hasAnnualStatements, hasQuarterlyStatements);
293
296
  const isAnnual = resolvedPeriod === "annual";
294
- const { statements: displayStatements, previousStatementMap } = useMemo(
295
- () => selectFinancialStatements(resolvedPeriod, subTab.key, annualStatements, quarterlyStatements),
296
- [annualStatements, quarterlyStatements, resolvedPeriod, subTab.key],
297
+ const selected = useMemo(
298
+ () => selectFinancialStatements(resolvedPeriod, subTab.key, annualStatements, quarterlyStatements, undefined, financials?.trailingStatement),
299
+ [annualStatements, quarterlyStatements, resolvedPeriod, subTab.key, financials?.trailingStatement],
297
300
  );
301
+ // A newest period with only some figures (an EPS alone) is left out of a statement table, and a line says so.
302
+ const { shown: displayStatements, notInYet } = useMemo(
303
+ () => ratioTab ? { shown: selected.statements, notInYet: [] } : splitPeriodsNotInYet(selected.statements, subTab),
304
+ [ratioTab, selected.statements, subTab],
305
+ );
306
+ const previousStatementMap = selected.previousStatementMap;
298
307
  // One currency for every column goes in the query bar with the growth basis;
299
308
  // a column in a different currency (or none) says so in its own header.
300
309
  const growthBasis = isAnnual ? "YoY" : "QoQ";
301
310
  const yearEndMonth = useMemo(() => fiscalYearEndMonth(annualStatements), [annualStatements]);
302
311
  const annualDates = useMemo(() => new Set(annualStatements.map(({ date }) => date)), [annualStatements]);
312
+ const { rows, unit } = useMemo(
313
+ () => shareFinancialUnit(buildFinancialRows(subTab.rows, displayStatements, collapsedGroups)),
314
+ [collapsedGroups, displayStatements, subTab.rows],
315
+ );
316
+ // The money unit most rows share heads the line names, so it is never cut with the query bar's text; rows in
317
+ // another unit say theirs ("Interest Exp (mn)"), which the header says it leaves to them.
318
+ const moneyUnit = [comparisonCurrency, unit].filter(Boolean).join(" ");
319
+ const unitMarked = !!unit && rows.some((row) => row.unitLabel !== row.label);
320
+ const metricHeader = moneyUnit ? `${moneyUnit}${unitMarked ? " unless marked" : ""}` : "Metric";
303
321
  const columns = useMemo<FinancialTableColumn[]>(() => [
304
322
  {
305
323
  id: "metric",
306
324
  kind: "metric",
307
- label: "Metric",
325
+ label: metricHeader,
308
326
  width: financialLabelWidth(width),
309
327
  align: "left",
310
328
  },
@@ -323,12 +341,7 @@ export function ResolvedFinancialsTab({
323
341
  align: "right",
324
342
  headerColor: statement.date === "TTM" ? colors.textBright : colors.textDim,
325
343
  })),
326
- ], [annualDates, comparisonCurrency, displayStatements, isAnnual, width, yearEndMonth]);
327
- const { rows, unit } = useMemo(
328
- () => shareFinancialUnit(buildFinancialRows(subTab.rows, displayStatements, collapsedGroups)),
329
- [collapsedGroups, displayStatements, subTab.rows],
330
- );
331
- const moneyUnit = [comparisonCurrency, unit].filter(Boolean).join(" ");
344
+ ], [annualDates, comparisonCurrency, displayStatements, isAnnual, metricHeader, width, yearEndMonth]);
332
345
  const periodEnd = latestFinancialPeriodEnd(displayStatements);
333
346
  const renderCell = useCallback((
334
347
  row: FinancialTableRow,
@@ -446,6 +459,13 @@ export function ResolvedFinancialsTab({
446
459
 
447
460
  // The Balance Sheet and Liquidity show cash, which an offering filed since the latest balance sheet is not in yet.
448
461
  const { symbol: boundSymbol, exchange: boundExchange } = useBoundTicker();
462
+ // Years filled from the listing's exchange, with the lines this table shows.
463
+ const filledFields = useMemo(() => ratioTab ? undefined : financialSubTabFields(subTab), [ratioTab, subTab]);
464
+ const filledPeriods = useMemo(() => filledPeriodsNote(displayStatements, filledFields), [displayStatements, filledFields]);
465
+ const filledDates = useMemo(() => filledPeriodPublications(displayStatements, filledFields), [displayStatements, filledFields]);
466
+ // An HKEX company's latest period dated by its results announcement, unless the filled periods already date it, and
467
+ // what was announced after it.
468
+ const exchangeResults = useExchangeResultsNotes(boundSymbol, boundExchange, latestBalanceSheetDate(financials), filledDates);
449
469
  const offeringNote = useOfferingNote(boundSymbol, boundExchange, latestBalanceSheetDate(financials),
450
470
  !!financials && (section.key === "balance" || section.key === "liquidity"));
451
471
 
@@ -454,14 +474,15 @@ export function ResolvedFinancialsTab({
454
474
  () => stalePeriodNote(financialStatementPeriods(displayStatements, subTab)),
455
475
  [displayStatements, subTab],
456
476
  );
457
- // Years filled from the listing's exchange, with the lines this table shows.
458
- const filledPeriods = useMemo(
459
- () => filledPeriodsNote(displayStatements, ratioTab ? undefined : financialSubTabFields(subTab)),
460
- [displayStatements, ratioTab, subTab],
477
+ const notInYetLine = useMemo(
478
+ () => notInYetNote(notInYet, subTab, resolvedPeriod, yearEndMonth),
479
+ [notInYet, resolvedPeriod, subTab, yearEndMonth],
461
480
  );
462
481
  usePaneNoticeFooter({
463
482
  registrationId: "financials-notices",
464
483
  notices: [
484
+ ...(notInYetLine ? [notInYetLine] : []),
485
+ ...exchangeResults,
465
486
  ...(stalePeriod ? [stalePeriod] : []),
466
487
  ...(filledPeriods ? [filledPeriods] : []),
467
488
  ...financialStatementLimitations(financials),
@@ -485,6 +506,8 @@ export function ResolvedFinancialsTab({
485
506
  );
486
507
  }
487
508
 
509
+ const asOf = periodEnd ? `as of ${periodEnd}` : undefined;
510
+ // The as-of is the bar's own segment, which keeps its place when the pane is narrow; the context after it gives way.
488
511
  const queryBar = (meta: string) => (
489
512
  <QueryBar
490
513
  width={Math.max(1, width - 2)}
@@ -511,10 +534,10 @@ export function ResolvedFinancialsTab({
511
534
  ],
512
535
  onChange: (value: string) => setPeriod(value as FinancialPeriod),
513
536
  }}
514
- meta={meta}
537
+ asOf={asOf}
538
+ meta={meta || undefined}
515
539
  />
516
540
  );
517
- const asOf = periodEnd ? `as of ${periodEnd}` : "";
518
541
 
519
542
  return (
520
543
  <Box
@@ -544,7 +567,7 @@ export function ResolvedFinancialsTab({
544
567
  ...(periodEnd ? [["As of", periodEnd]] : []),
545
568
  ]}
546
569
  resetScrollKey={`${resolvedPeriod}:${section.key}:${displayStatements.length}`}
547
- rootBefore={queryBar([comparisonCurrency, asOf].filter(Boolean).join(" · "))}
570
+ rootBefore={queryBar(comparisonCurrency ?? "")}
548
571
  />
549
572
  ) : (
550
573
  <DataTableView<FinancialTableRow, FinancialTableColumn>
@@ -584,7 +607,7 @@ export function ResolvedFinancialsTab({
584
607
  ]}
585
608
  showHorizontalScrollbar
586
609
  resetScrollKey={`${resolvedPeriod}:${subTab.key}:${displayStatements.length}`}
587
- rootBefore={queryBar([moneyUnit, growthBasis, asOf].filter(Boolean).join(" · "))}
610
+ rootBefore={queryBar(growthBasis ?? "")}
588
611
  />
589
612
  )}
590
613
  </Box>
@@ -43,6 +43,8 @@ export const paneSchemas = {
43
43
  discovery: {
44
44
  id: "financial-statements",
45
45
  aliases: ["financials", "financial statement", "income statement", "balance sheet", "cash flow statement", "financial ratios"],
46
+ // `fn runway VKTX` is the liquidity view, where cash + ST investments, burn and runway are.
47
+ opens: [{ words: ["runway", "cash runway", "burn", "cash burn", "months of cash"], argument: "", options: { statement: "liquidity" } }],
46
48
  limitations: [
47
49
  "One company per invocation; use GF for cross-company metric comparisons.",
48
50
  "Excludes bank regulatory capital (CET1, risk-weighted assets) and REIT FFO/AFFO.",
@@ -93,11 +95,10 @@ export const paneSchemas = {
93
95
  },
94
96
  {
95
97
  key: "interval",
96
- description: "Bar size of each return; a range it does not reach uses the nearest longer bar the source keeps.",
98
+ description: "Bar size of each return; a range it does not reach uses the nearest longer bar the source keeps. Default: hourly to 1W, daily to 1Y, weekly for 5Y, monthly for ALL.",
97
99
  type: "enum",
98
100
  aliases: ["bar", "granularity", "resolution"],
99
101
  values: RETURN_INTERVAL_VALUES,
100
- defaultValue: "1h",
101
102
  pluginState: { pluginId: "ticker-research" },
102
103
  },
103
104
  {
@@ -1,5 +1,6 @@
1
1
  import {
2
- FINANCIAL_VINTAGE_NOTICE, filledPeriodsNote, hasOlderStatements, reportsHalfYearly, stalePeriodNote, statementHistoryNotes,
2
+ FINANCIAL_VINTAGE_NOTICE, fillDate, filledPeriodPublications, filledPeriodsNote, hasOlderStatements, reportsHalfYearly, stalePeriodNote,
3
+ statementHistoryNotes, statementPeriodMonths,
3
4
  } from "../../../utils/financial-statements";
4
5
  import { canonicalExchange } from "../../../utils/exchanges";
5
6
  import { hasValidQuoteObservationTime } from "../../../market-data/quotes/freshness";
@@ -9,17 +10,20 @@ import type { TimeRange } from "../../../time-series/range";
9
10
  import { formatNumber } from "../../../utils/format";
10
11
  import { formatPriceObservation, penceFigure, quoteFormatOptions } from "../../../market-data/market/format";
11
12
  import {
12
- MISSING_VOLUME_TEXT, missingVolumeCount, missingVolumeNotice, pricePointValues, pricePointWickFlags, priceHistoryIntegrityNotice,
13
- priceHistoryWickNotice,
13
+ MISSING_VOLUME_TEXT, missingVolumeCount, missingVolumeNotice, pricePointOpenWithheld, pricePointWickFlags, priceHistoryIntegrityNotice,
14
+ priceHistoryOpenNotice, priceHistoryRescaleNotice, priceHistoryWickNotice,
14
15
  } from "../../../utils/price-history-integrity";
15
16
  import { indexBarVolume } from "../../../market-data/market/index-level";
16
17
  import {
17
18
  buildFinancialTableModel, financialStatementCurrency, financialStatementDateNotice, financialStatementLimitations,
18
- financialStatementPeriods, financialSubTabFields, formatFinancialHeader, isPerShareFinancialRow, receiptShareCountLabel,
19
+ financialReportHeader, financialStatementPeriods, financialSubTabFields, isPerShareFinancialRow, receiptShareCountLabel,
19
20
  } from "./financials/model";
21
+ import { fiscalYearEndMonth } from "../../../utils/fiscal-period";
22
+ import type { FinancialStatement } from "../../../types/financials";
20
23
  import { adrRatioText } from "../../../utils/depositary-receipt";
21
24
  import { paneSchemas } from "./headless-schema";
22
25
  import { loadPeriodEndHistory } from "./financials/period-end-history";
26
+ import { loadExchangeResultsNotes } from "./financials/exchange-results";
23
27
  import { latestBalanceSheetDate, loadOfferingNote } from "./financials/offerings";
24
28
  import { reportsShortTermTotal, runwayMethod } from "../../../utils/cash-runway";
25
29
  import { logFailure } from "../../../utils/log-failure";
@@ -41,8 +45,8 @@ import {
41
45
  } from "../shared/headless-market-data";
42
46
  import { barHistoryFreshness, REPORTED_DATA } from "../shared/report-freshness";
43
47
  import {
44
- BAR_INTERVAL_LABELS, barPriceDecimals, cleanBarPrice, cleanFloat32Price, formatBarPrice, historyAllStart, historyAllStartNote, historyMissingPeriodsNote, historyPriceDecimals,
45
- quotedPriceDivisor,
48
+ BAR_INTERVAL_LABELS, barPriceDecimals, cleanBarPrice, cleanFloat32Price, formatBarPrice, historyAllStart, historyAllStartNote, historyBarFlags,
49
+ historyBarValues, historyMissingPeriodsNote, historyPriceDecimals, priceTableIntegrityNotice, quotedPriceDivisor,
46
50
  } from "../../../cli/history-rows";
47
51
  import { formatUtcTime } from "../../../utils/utc-time";
48
52
  import { closeMoves } from "../../../utils/max-drawdown";
@@ -52,7 +56,8 @@ import { isPastPriceWindow, loadPriceWindowHistory, priceWindowInterval, priceWi
52
56
  import { historyCoverageNotice } from "../../../sources/history-coverage";
53
57
  import { getChartResolutionLabel, isIntradayResolution, RANGE_HISTORY_RESOLUTION, type ManualChartResolution } from "../../../time-series/resolution";
54
58
  import { DAY_SO_FAR_TEXT, requestedSessionBarSize, withSessionBar } from "../../../time-series/session-bar";
55
- import { buildReturnRows, closedMarketNote, isTodayReturnRow, returnBaseCloseDay, type ReturnRange } from "./data-panes/returns-model";
59
+ import { buildReturnRows, closedMarketNote, defaultReturnInterval, isTodayReturnRow, returnBaseCloseDay, type ReturnRange } from "./data-panes/returns-model";
60
+ import { barCloseSession } from "../../../market-data/market/bar-period";
56
61
  import { periodBaseText } from "../../../market-data/market/period-return";
57
62
  import { loadReturnSeries } from "./data-panes/returns-history";
58
63
  import { CLOSING_PRINT_PENDING_TEXT } from "../../../time-series/official-close";
@@ -119,13 +124,23 @@ export const financialStatementsHeadless: HeadlessPaneDefinition<"rows"> = {
119
124
  : allReceipts
120
125
  ? `Share counts are in ADRs and EPS is per ADR${ratio ? `; ${ratio}` : ""}.`
121
126
  : `Share counts are in ADRs and EPS is per ADR for ${receiptPeriods.join(", ")}${ratio ? ` (${ratio})` : ""}; other periods as reported.`;
122
- const dates = table?.statements.map(({ date, currency, dateSource, providerDate, dateEvidence, availableAt, fieldAvailability, fieldSources, unavailableFields, epsBasis, unavailableEarnings, aggregation, shareBasis, filledFrom }) => ({
127
+ const yearEndMonth = fiscalYearEndMonth(financials.annualStatements);
128
+ // The list a column comes from: a comparative column is dated by the row a year on in it.
129
+ const listRows = requestedPeriod === "quarterly" ? financials.quarterlyStatements : financials.annualStatements;
130
+ const dates = table?.statements.map((statement) => {
131
+ const { date, currency, dateSource, providerDate, dateEvidence, availableAt, fieldAvailability, fieldSources, unavailableFields, epsBasis, unavailableEarnings, aggregation, shareBasis, filledFrom } = statement;
132
+ const filled = date === "TTM" || filledFrom?.source !== "results" ? null : fillDate(statement, listRows);
133
+ return {
123
134
  date, currency: currency ?? statementCurrency ?? null,
124
135
  shareBasis: shareBasis ?? null,
125
136
  availableAt: availableAt ?? null,
126
137
  fieldAvailability: fieldAvailability ? { ...fieldAvailability } : null,
127
138
  ...(fieldSources ? { fieldSources } : {}),
128
139
  ...(filledFrom ? { filledFrom } : {}),
140
+ // The day the company's results announcement published the period's filled lines, or, for a later
141
+ // period's comparative column, that period's first announcement.
142
+ ...(filled?.label === "published" && filled.date ? { announced: filled.date } : {}),
143
+ ...(filled?.label === "comparative" ? { comparativeIn: filled.date } : {}),
129
144
  ...(unavailableFields ? { unavailableFields } : {}),
130
145
  ...(epsBasis ? { epsBasis } : {}),
131
146
  ...(unavailableEarnings ? { unavailableEarnings } : {}),
@@ -134,8 +149,9 @@ export const financialStatementsHeadless: HeadlessPaneDefinition<"rows"> = {
134
149
  providerDate: date === "TTM" ? null : providerDate ?? null,
135
150
  dateEvidence: date === "TTM" || dateSource !== "sec" ? null : dateEvidence ?? null,
136
151
  // Rows in the shared money unit no longer name it, so the header does.
137
- label: formatFinancialHeader(date, [currency ?? statementCurrency, table.unit].filter(Boolean).join(" ") || undefined, dateSource, false, aggregation?.periodEnd).trim(),
138
- })) ?? [];
152
+ label: financialReportHeader(statement, [currency ?? statementCurrency, table.unit].filter(Boolean).join(" ") || undefined, requestedPeriod, yearEndMonth, listRows),
153
+ };
154
+ }) ?? [];
139
155
  const rows = table?.rows.map((row) => ({
140
156
  id: row.id, kind: row.kind, metric: allReceipts ? receiptShareCountLabel(row) : row.unitLabel,
141
157
  cells: row.cells.map((cell, index) => ({
@@ -156,17 +172,20 @@ export const financialStatementsHeadless: HeadlessPaneDefinition<"rows"> = {
156
172
  ];
157
173
  // The balance sheet's cash, when an offering since is not in it yet.
158
174
  const offering = table?.subTab.key === "balance" ? await reportOfferingNote(ctx, symbol, financials) : null;
159
- // A latest period over 15 months old says how old it is.
175
+ // A latest period over 15 months old says how old it is; an HKEX company's, the announcement its results came in.
160
176
  const stale = table ? stalePeriodNote(financialStatementPeriods(table.statements, table.subTab)) : null;
161
- // Years filled from the listing's exchange, with the lines this table shows.
162
- const filled = table ? filledPeriodsNote(table.statements, financialSubTabFields(table.subTab)) : null;
177
+ // Years filled from the listing's exchange, with the lines this table shows; an announcement that dates one is not
178
+ // said again in the results line.
179
+ const shownFields = table ? financialSubTabFields(table.subTab) : undefined;
180
+ const filled = table ? filledPeriodsNote(table.statements, shownFields) : null;
181
+ const announced = table ? await reportExchangeResults(ctx, symbol, financials, filledPeriodPublications(table.statements, shownFields)) : [];
163
182
  const periodDates = dates.map(({ date }) => date);
164
183
  const missing = rows.length ? null : await missingPeriodsError(ctx, symbol, financials, requestedPeriod, hasRequestedStatements, options.statement);
165
184
  return {
166
185
  rows, columns, unavailableSymbols: rows.length ? [] : [symbol],
167
186
  ...(missing ? { errors: [missing] } : {}),
168
187
  // The report closes with how old its latest period is, how far back its periods go, and how to read further.
169
- notes: [...stale ? [stale] : [], ...filled ? [filled] : [], ...offering ? [offering] : [],
188
+ notes: [...announced, ...stale ? [stale] : [], ...filled ? [filled] : [], ...offering ? [offering] : [],
170
189
  ...statementHistoryNotes(requestedPeriod, periodDates, symbol, await reportOlderStatements(ctx, symbol, requestedPeriod, periodDates))],
171
190
  metadata: {
172
191
  symbol, name: financials.quote?.name ?? symbol, currency: statementCurrency ?? null, unit: table?.unit ?? null, quoteCurrency: financials.quote?.currency ?? null,
@@ -175,7 +194,7 @@ export const financialStatementsHeadless: HeadlessPaneDefinition<"rows"> = {
175
194
  shareBasis: shareBases.size === 1 ? [...shareBases][0] ?? null : null,
176
195
  ...(receiptPeriods.length > 0 ? { adrRatio: financials.fundamentals?.adrRatio ?? financials.quote?.adrRatio ?? null } : {}),
177
196
  // A quarter's change is against the quarter before it, which a reader of a table of quarters must be told.
178
- notices: rows.length ? [FINANCIAL_VINTAGE_NOTICE, ...requestedPeriod === "quarterly" ? [QUARTERLY_GROWTH_NOTICE] : [],
197
+ notices: rows.length ? [FINANCIAL_VINTAGE_NOTICE, ...requestedPeriod === "quarterly" ? [quarterlyGrowthNotice(table?.statements ?? [])] : [],
179
198
  ...(shareBasisNotice ? [shareBasisNotice] : [])] : [],
180
199
  limitations: financialStatementLimitations(financials),
181
200
  dateProvenance: financialStatementDateNotice(table?.statements ?? []),
@@ -186,8 +205,15 @@ export const financialStatementsHeadless: HeadlessPaneDefinition<"rows"> = {
186
205
 
187
206
  const reportAmount = (amount: RatioAmount) => (typeof amount === "number" ? amount : null);
188
207
 
189
- /** What a table of quarters says its growth is measured against. */
190
- const QUARTERLY_GROWTH_NOTICE = "Growth is vs prior quarter.";
208
+ /**
209
+ * What a table of quarters says its growth is measured against; a half filled
210
+ * from a results announcement is measured against the same half a year earlier.
211
+ */
212
+ function quarterlyGrowthNotice(statements: readonly FinancialStatement[]): string {
213
+ return statements.some((statement) => statement.date !== "TTM" && (statementPeriodMonths(statement) ?? 3) > 3)
214
+ ? "Growth is vs prior quarter; a half's is vs the same half a year earlier."
215
+ : "Growth is vs prior quarter.";
216
+ }
191
217
 
192
218
  type HeadlessContext = Parameters<typeof financialStatementsHeadless.load>[1];
193
219
 
@@ -217,7 +243,7 @@ async function missingPeriodsError(
217
243
  if (period === "annual" || !hasYears) return hasRequestedStatements ? null : `${symbol}: No ${period} financial statement coverage.`;
218
244
  const exchange = await resolveHeadlessInstrument(ctx, symbol).then(({ exchange }) => canonicalExchange(exchange ?? ""))
219
245
  .catch(logFailure("ticker-detail.headless", "Resolving the listing of a statements report failed", ""));
220
- const halfYearly = reportsHalfYearly(exchange, financials.quarterlyStatements);
246
+ const halfYearly = reportsHalfYearly(exchange, financials.quarterlyStatements, financials.annualStatements);
221
247
  if (hasRequestedStatements && !halfYearly) return null;
222
248
  const tab = typeof statement === "string" && statement && statement !== "income" ? ` --statement ${statement}` : "";
223
249
  const years = `For its years: gloom fn FA ${symbol} --period annual${tab}`;
@@ -237,6 +263,18 @@ async function reportOfferingNote(
237
263
  .catch(logFailure("ticker-detail.headless", "Reading the offering filings failed", null));
238
264
  }
239
265
 
266
+ /** An HKEX company's latest period and its results announcement (exchangeResultsNotes); a failed read leaves them out. */
267
+ async function reportExchangeResults(
268
+ ctx: Parameters<typeof financialStatementsHeadless.load>[1],
269
+ symbol: string,
270
+ financials: Awaited<ReturnType<typeof loadHeadlessFinancials>>,
271
+ dated: ReturnType<typeof filledPeriodPublications>,
272
+ ): Promise<string[]> {
273
+ return resolveHeadlessInstrument(ctx, symbol)
274
+ .then((listing) => loadExchangeResultsNotes(ctx.apiClient, listing, latestBalanceSheetDate(financials), dated))
275
+ .catch(logFailure("ticker-detail.headless", "Reading the HKEXnews results announcements failed", [] as string[]));
276
+ }
277
+
240
278
  /** A ratio tab as a report: each ratio, then its inputs, per period. */
241
279
  async function loadRatioReport(
242
280
  ctx: Parameters<typeof financialStatementsHeadless.load>[1],
@@ -256,11 +294,13 @@ async function loadRatioReport(
256
294
  const statementCurrency = financialStatementCurrency(financials, [
257
295
  ...financials.annualStatements, ...financials.quarterlyStatements,
258
296
  ]);
297
+ const yearEndMonth = fiscalYearEndMonth(financials.annualStatements);
259
298
  const dates = table?.periods.map(({ statement }) => ({
260
299
  date: statement.date,
261
300
  periodEnd: ratioPeriodEnd(statement),
262
301
  currency: statement.currency ?? statementCurrency ?? null,
263
- label: formatFinancialHeader(statement.date, statement.currency ?? statementCurrency, statement.dateSource, false, statement.aggregation?.periodEnd).trim(),
302
+ label: financialReportHeader(statement, statement.currency ?? statementCurrency, period, yearEndMonth,
303
+ period === "quarterly" ? financials.quarterlyStatements : financials.annualStatements),
264
304
  })) ?? [];
265
305
  const rows = table?.rows.map((row) => {
266
306
  const cells = table.cells.get(row.def.id)!.map((cell, index) => {
@@ -379,6 +419,8 @@ function historyColumns(
379
419
  volumeMissing = false,
380
420
  decimals?: number,
381
421
  pence?: (close: number) => string | null,
422
+ /** A bar is flagged (`high<close`, `low<close/2`): the Flag column says how, as `history`'s does. */
423
+ flagged = false,
382
424
  ): HeadlessPaneColumn[] {
383
425
  const daily = isDailyOrLongerBar(size);
384
426
  const date: HeadlessPaneColumn = {
@@ -391,12 +433,14 @@ function historyColumns(
391
433
  const marked: HeadlessPaneColumn[] = partial && !text
392
434
  ? [{ key: "partial", header: "Partial", format: (value) => value === true ? "true" : "" }]
393
435
  : [];
394
- return [date, ...historyPriceColumns(volumeMissing, decimals, text ? pence : undefined), ...marked];
436
+ const flag: HeadlessPaneColumn[] = flagged ? [{ key: "flag", header: "Flag", format: (value) => typeof value === "string" ? value : "" }] : [];
437
+ return [date, ...historyPriceColumns(volumeMissing, decimals, text ? pence : undefined), ...flag, ...marked];
395
438
  }
396
439
 
397
440
  export const historicalPricesHeadless: HeadlessPaneDefinition<"rows"> = {
398
441
  ...paneSchemas["historical-prices-pane"],
399
442
  shape: "rows",
443
+ currencyPairs: true,
400
444
  description: "OHLCV bars (date, open, high, low, close, volume) for one ticker over a range: daily to start, weekly for 5Y and monthly for ALL. The newest bar is marked partial while its day, week or month runs on; a day's bar then comes from the live quote.",
401
445
  describe: ({ symbols, options }) => `Historical Prices | ${symbols[0]} | ${reportWindowText(options) ?? options.range ?? HISTORY_DEFAULT_RANGE}`,
402
446
  columns: historyColumns("1d", false, false),
@@ -424,20 +468,24 @@ export const historicalPricesHeadless: HeadlessPaneDefinition<"rows"> = {
424
468
  // a London line's cleaned in the pence it was priced in.
425
469
  const priceDivisor = quotedPriceDivisor(quote);
426
470
  const clean = (value: number | null) => value == null ? null : cleanBarPrice(value, priceDivisor);
471
+ // A monthly bar whose prices contradict each other keeps its close, flagged, as `history` keeps it.
472
+ const monthly = historyBarSize(points.map((point) => new Date(point.date).getTime()), requested) === "1mo";
427
473
  const rows = points.map((point) => {
428
474
  const date = new Date(point.date);
429
- const values = pricePointValues(point);
475
+ const values = historyBarValues(point, monthly);
476
+ const flags = historyBarFlags(point);
430
477
  return {
431
478
  date: Number.isFinite(date.getTime()) ? date.toISOString() : String(point.date),
432
479
  open: clean(values.open), high: clean(values.high), low: clean(values.low), close: clean(values.close),
433
480
  volume: indexBarVolume(values.volume, quote?.instrumentType),
481
+ ...(flags.length ? { flag: flags.join(",") } : {}),
434
482
  ...(values.integrity ? { integrity: values.integrity } : {}),
435
483
  ...(point.partial ? { partial: true } : {}),
436
484
  // A coin's day Gloom Cloud rebuilt from hourly bars has no volume of its own, as `history` marks it.
437
485
  ...(point.filled ? { filled: true } : {}),
438
486
  };
439
487
  }).sort((left, right) => left.date.localeCompare(right.date));
440
- const notice = priceHistoryIntegrityNotice(rows.filter((row) => row.integrity).length);
488
+ const notice = priceTableIntegrityNotice(rows);
441
489
  const size = historyBarSize(rows.map((row) => Date.parse(row.date)), requested);
442
490
  // A weekly or monthly bar whose period runs on is dated by how far it runs, as `history` dates it.
443
491
  const forming = formingHistoryBar(size, rows.at(-1)?.date, venue, now);
@@ -467,16 +515,22 @@ export const historicalPricesHeadless: HeadlessPaneDefinition<"rows"> = {
467
515
  ...(dayToDate ? { basis: "daily bars", note: `the newest bar is ${DAY_SO_FAR_TEXT}`, ...(quote ? { asOf: new Date(quote.lastUpdated).toISOString() } : {}) } : {}),
468
516
  };
469
517
  // The largest fall from a close to a later one in the bars shown, said under the title; a yield's in bp, with its largest rise.
470
- const { drawdown, runUp, lines: moveLines } = closeMoves(shown, drawdownScaleOf(symbol), { basis: `${historyBarSizeWord(size)} closes`,
471
- price: (value) => formatBarPrice(value, decimals), date: (value) => isDailyOrLongerBar(size) ? value.slice(0, 10) : formatUtcTime(value) });
518
+ // A week's or month's close is dated by its last session, not the 1st its bar is dated by.
519
+ const closes = shown.map((row) => ({ date: isDailyOrLongerBar(size) ? barCloseSession(size, row.date, venue, now) : row.date, close: row.close }));
520
+ // A window's last week can close after the dates asked for: the fall is measured to its end.
521
+ const { drawdown, runUp, lines: moveLines } = closeMoves(closes, drawdownScaleOf(symbol), { basis: `${historyBarSizeWord(size)} closes`,
522
+ price: (value) => formatBarPrice(value, decimals), date: (value) => isDailyOrLongerBar(size) ? value.slice(0, 10) : formatUtcTime(value) }, window?.to);
472
523
  // A wick left out of the range is said, though the bar's close still counts.
473
524
  const wickNotice = priceHistoryWickNotice(points.filter((point) => pricePointWickFlags(point).length > 0).length);
474
- const reportNotices = [...moveLines, notice, wickNotice].filter((line): line is string => line != null);
525
+ // As are bars the source served in the wrong unit, shown scaled back.
526
+ const openNotice = priceHistoryOpenNotice(points.filter(pricePointOpenWithheld).length);
527
+ const reportNotices = [...moveLines, notice, openNotice, wickNotice, priceHistoryRescaleNotice(points)].filter((line): line is string => line != null);
528
+ const flagged = rows.some((row) => row.flag);
475
529
  return {
476
530
  rows: shown,
477
- columns: historyColumns(size, marked, false, false, decimals),
531
+ columns: historyColumns(size, marked, false, false, decimals, undefined, flagged),
478
532
  textColumns: historyColumns(size, marked, true, volumeMissing > 0, decimals,
479
- (close) => penceFigure(Number(close.toFixed(Math.min(20, decimals))), quote, decimals)),
533
+ (close) => penceFigure(Number(close.toFixed(Math.min(20, decimals))), quote, decimals), flagged),
480
534
  freshness,
481
535
  ...(notes.length > 0 ? { notes } : {}),
482
536
  ...(notice ? { complete: false } : {}),
@@ -498,14 +552,16 @@ export const returnsHeadless: HeadlessPaneDefinition<"rows"> = {
498
552
  ...paneSchemas["returns-pane"],
499
553
  shape: "rows",
500
554
  description: "Interval and cumulative price returns of one ticker's bars over a range: each bar's close, its move from the bar before, and its move from the bar before the window.",
501
- describe: ({ symbols, options }) => `Returns | ${symbols[0]} | ${reportWindowText(options) ?? options.range ?? "5D"} | ${options.interval ?? "1h"}`,
555
+ describe: ({ symbols, options }) => `Returns | ${symbols[0]} | ${reportWindowText(options) ?? options.range ?? "5D"} | ${
556
+ options.interval ?? defaultReturnInterval((options.range ?? "5D") as ReturnRange, readReportWindow(options))}`,
502
557
  async load({ symbols, options }, ctx) {
503
558
  const key = symbols[0]!;
504
559
  const { symbol, exchange } = await resolveHeadlessInstrument(ctx, key);
505
560
  const range = (options.range ?? "5D") as ReturnRange;
506
- const requested = (options.interval ?? "1h") as ManualChartResolution;
507
561
  // --from 2007 --to 2009 measures those dates' returns in place of the range.
508
562
  const window = readReportWindow(options);
563
+ // No --interval: the bars grow with the range, daily to 1Y.
564
+ const requested = (options.interval ?? defaultReturnInterval(range, window)) as ManualChartResolution;
509
565
  const pastWindow = !!window && isPastPriceWindow(window);
510
566
  const support = await Promise.resolve(ctx.marketData.getChartResolutionSupport?.(symbol, exchange ?? "") ?? []).catch(logFailure("ticker-detail.headless", "Read return interval support failed", []));
511
567
  const now = Date.now();
@@ -540,8 +596,11 @@ export const returnsHeadless: HeadlessPaneDefinition<"rows"> = {
540
596
  const rows = forming || dayToDate ? [...unmarked.slice(0, -1), { ...unmarked.at(-1)!, partial: true }] : unmarked;
541
597
  const price = (value: unknown) => typeof value === "number" && Number.isFinite(value) ? value.toFixed(decimals) : "-";
542
598
  // The largest fall from a close to a later one in the window, said under the title; a yield's in bp, with its largest rise.
543
- const { drawdown, runUp, lines: moveLines } = closeMoves(unmarked.map((row) => ({ date: row.time, close: row.close })), drawdownScaleOf(symbol),
544
- { basis: `${BAR_INTERVAL_LABELS[series.resolution]} closes`, price, date: (value) => intraday ? formatUtcTime(value) : value.slice(0, 10) });
599
+ // A week's or month's close is dated by its last session, not the 1st its bar is dated by ("peak 35.70 on 2026-03-31").
600
+ const closes = unmarked.map((row) => ({ date: intraday ? row.time : barCloseSession(series.resolution, row.time, venue, now), close: row.close }));
601
+ // A week still forming runs to today, and a window's last week can close after the dates asked for: the fall is measured to their end.
602
+ const { drawdown, runUp, lines: moveLines } = closeMoves(closes, drawdownScaleOf(symbol),
603
+ { basis: `${BAR_INTERVAL_LABELS[series.resolution]} closes`, price, date: (value) => intraday ? formatUtcTime(value) : value.slice(0, 10) }, window?.to);
545
604
  const figures: HeadlessPaneColumn[] = [
546
605
  { key: "close", header: "Price", align: "right", format: price },
547
606
  { key: "intervalChange", header: "Int $", align: "right", format: price },
@@ -31,7 +31,7 @@ import { getPortfolioPositionMetrics, getPortfolioQuoteDisplay, resolvePortfolio
31
31
  import { listingDividendYield, liveForwardPE, liveMarketCapitalization, liveTrailingPE } from "../../../../market-data/quotes/live-valuation";
32
32
  import { atRegularSessionPrice } from "../../../../market-data/quotes/regular-session-valuation";
33
33
  import { formatReportedMoney, REPORTING_CURRENCY_NOT_SOURCED } from "../../../../utils/reported-money";
34
- import { enterpriseValueCheck, enterpriseValueGapIsLarge, enterpriseValueNotMeaningful, fundamentalsCurrency, isBankEnterpriseValue, fundamentalsEpsCurrency, reportedEnterpriseValue } from "../../../../utils/fundamentals";
34
+ import { enterpriseValueCheck, enterpriseValueComputed, enterpriseValueNotMeaningful, fundamentalsCurrency, isBankEnterpriseValue, fundamentalsEpsCurrency, reportedEnterpriseValue } from "../../../../utils/fundamentals";
35
35
  import { formatShortDate } from "../../../../utils/datetime-format";
36
36
  import { safeExternalUrl } from "../../../../utils/external-url";
37
37
  import type { FundBondFacts } from "../../../../api-client/fund-facts";
@@ -157,6 +157,7 @@ export function buildOverviewStats({
157
157
  dividend,
158
158
  bond = null,
159
159
  runway = null,
160
+ trailingEpsYear,
160
161
  }: {
161
162
  quote: Quote | undefined;
162
163
  fundamentals: TickerFinancials["fundamentals"] | undefined;
@@ -184,6 +185,8 @@ export function buildOverviewStats({
184
185
  bond?: FundBondFacts | null;
185
186
  /** Months of cash at the latest balance sheet (utils/cash-runway); shown when the company burns cash. */
186
187
  runway?: CashRunway | null;
188
+ /** The fiscal year the trailing EPS is ("FY Mar-26"), when it is a year's a quarter or more old (trailingEpsFiscalYear). */
189
+ trailingEpsYear?: string;
187
190
  }): StatField[] {
188
191
  const stats: StatField[] = [];
189
192
  // Amounts no source names the currency of are bare; the first says so after it, once for all of them.
@@ -203,16 +206,19 @@ export function buildOverviewStats({
203
206
  stats.push({ label: "Volume", value: formatCompact(volume, { fixedDecimals: true }) });
204
207
  }
205
208
  // Price-derived statistics follow the quote; see live-valuation for when a stored figure is kept.
209
+ // Market cap and EV read in the currency they are reported in, as the revenue and income beside them do, with
210
+ // the base currency's figure after them where it differs and a rate is held: 19.46T JPY 123.05B USD.
211
+ const inBase = (value: number, currency: string) => {
212
+ if (currency === baseCurrency) return undefined;
213
+ const converted = convertMarketCapitalization(value, currency, baseCurrency, marketCapExchangeRates);
214
+ return converted == null ? undefined : formatCompactCurrency(converted, baseCurrency, { fixedDecimals: true });
215
+ };
206
216
  const capitalization = liveMarketCapitalization(quote, fundamentals);
207
217
  if (capitalization) {
208
- const converted = convertMarketCapitalization(capitalization.value, capitalization.currency, baseCurrency, marketCapExchangeRates);
209
218
  stats.push({
210
219
  label: "Market Cap",
211
- value: formatCompactCurrency(
212
- converted ?? capitalization.value,
213
- converted == null ? capitalization.currency : baseCurrency,
214
- { fixedDecimals: true },
215
- ),
220
+ value: formatCompactCurrency(capitalization.value, capitalization.currency, { fixedDecimals: true }),
221
+ detail: inBase(capitalization.value, capitalization.currency),
216
222
  });
217
223
  }
218
224
  // A count read off a 10-K or 10-Q cover says when it was counted; the source's own is undated.
@@ -242,7 +248,7 @@ export function buildOverviewStats({
242
248
  }
243
249
  const trailingPE = liveTrailingPE(quote, fundamentals);
244
250
  if (trailingPE != null) {
245
- stats.push({ label: "P/E (TTM)", value: formatPriceEarnings(trailingPE) });
251
+ stats.push({ label: trailingEpsYear ? `P/E ${trailingEpsYear}` : "P/E (TTM)", value: formatPriceEarnings(trailingPE) });
246
252
  }
247
253
  // Next fiscal year's consensus, and the year it is for: N/M over a loss, a dash when there is none.
248
254
  const forwardPE = liveForwardPE(quote, fundamentals);
@@ -251,7 +257,7 @@ export function buildOverviewStats({
251
257
  stats.push({ label: year ? `Fwd P/E ${year}` : "Fwd P/E", value: formatPriceEarnings(forwardPE) });
252
258
  }
253
259
  if (fundamentals?.eps != null) {
254
- stats.push({ label: "EPS", ...reported(fundamentals.eps, fundamentalsEpsCurrency({ fundamentals, financialCurrency, quote }), true) });
260
+ stats.push({ label: trailingEpsYear ? `EPS ${trailingEpsYear}` : "EPS", ...reported(fundamentals.eps, fundamentalsEpsCurrency({ fundamentals, financialCurrency, quote }), true) });
255
261
  }
256
262
  if (fundamentals?.pegRatio != null) {
257
263
  stats.push({ label: "PEG", value: formatPriceEarnings(fundamentals.pegRatio, 2) });
@@ -334,16 +340,17 @@ export function buildOverviewStats({
334
340
  } else if (fundamentals?.unavailableFields?.includes("enterpriseValue")) {
335
341
  stats.push({ label: "EV", value: "—" });
336
342
  } else if (enterpriseValue != null) {
337
- // More than 10% from market cap + debt - cash: the provider's, with the computed figure where it fits.
338
- // Closer than that it is the valuation panes' detail (enterpriseValueGapIsLarge).
343
+ // Market cap + debt - cash (+ minority interest) where the provider's is more than 5% from it, as every view
344
+ // shows it; the notice under the pane gives its inputs where the provider's is far off (enterpriseValueGapIsLarge).
339
345
  const check = enterpriseValueCheck(priced);
340
- const computed = check?.status === "differs" && check.computed != null && enterpriseValueGapIsLarge(priced)
341
- ? formatCompact(check.computed) : undefined;
346
+ const minority = (check?.minorityAndPreferred ?? 0) > 0 ? " + minority" : "";
342
347
  stats.push({
343
348
  label: "EV",
344
349
  value: formatCompactCurrency(enterpriseValue, quoteCurrency),
345
- // An insurer's: its investment book is not netted as cash.
346
- detail: computed ? [`provider vs ${computed}`, "provider"] : check?.investmentsKept ? ["investments in", "inv. in"] : undefined,
350
+ // An insurer's: its investment book is not netted as cash. How it was reached comes before the base figure.
351
+ detail: enterpriseValueComputed(priced)
352
+ ? [`cap + debt - cash${minority}`, "computed"]
353
+ : check?.investmentsKept ? ["investments in", "inv. in"] : inBase(enterpriseValue, quoteCurrency),
347
354
  });
348
355
  }
349
356
  if (finite(fundamentals?.beta)) {
@@ -38,7 +38,9 @@ import type { TickerRecord } from "../../../types/ticker";
38
38
  import { Box, ScrollBox, Text, useUiCapabilities } from "../../../ui";
39
39
  import { publicTickerKey, resolveExchangeTimeZone } from "../../../utils/exchanges";
40
40
  import { convertCurrency, displayWidth, formatPercentRaw, truncateToDisplayWidth } from "../../../utils/format";
41
- import { appTtmRate, enterpriseValueGapIsLarge, enterpriseValueReconciliationNote, ttmAtAppRate, ttmConversionNote, withBankEnterpriseValue } from "../../../utils/fundamentals";
41
+ import {
42
+ appTtmRate, enterpriseValueGapIsLarge, enterpriseValueReconciliationNote, trailingEpsFiscalYear, ttmAtAppRate, ttmConversionNote, withBankEnterpriseValue,
43
+ } from "../../../utils/fundamentals";
42
44
  import { atRegularSessionPrice } from "../../../market-data/quotes/regular-session-valuation";
43
45
  import { zonedDateKey } from "../../../utils/zoned-date-time";
44
46
  import { sharesOutstandingInReceipts } from "../../../utils/depositary-receipt";
@@ -254,7 +256,7 @@ function ResolvedOverviewTab({ width, height, focused = false, ticker, financial
254
256
  // regular session price the EV beside it is shown at. A gap of a few percent is the valuation panes' detail.
255
257
  const pricedForEnterpriseValue = atRegularSessionPrice({ quote, fundamentals: withBankEnterpriseValue(fundamentals, profile) }).fundamentals;
256
258
  const enterpriseValueNote = enterpriseValueGapIsLarge(pricedForEnterpriseValue)
257
- ? enterpriseValueReconciliationNote(pricedForEnterpriseValue) : undefined;
259
+ ? enterpriseValueReconciliationNote(pricedForEnterpriseValue, undefined, financials ?? undefined) : undefined;
258
260
  // Months of cash, for a company that burns it, and an offering since its balance sheet that the cash is not in yet.
259
261
  const runway = useMemo(() => financials ? cashRunway(financials) : null, [financials]);
260
262
  const runwayOfferingNote = useOfferingNote(ticker.metadata.ticker, ticker.metadata.exchange, runway?.periodEnd ?? null, runway?.trailing?.kind === "months");
@@ -415,6 +417,7 @@ function ResolvedOverviewTab({ width, height, focused = false, ticker, financial
415
417
  dividend,
416
418
  bond: fundFacts?.bond ?? null,
417
419
  runway,
420
+ trailingEpsYear: financials ? trailingEpsFiscalYear(financials) : undefined,
418
421
  });
419
422
  const profileFields = buildProfileFields({
420
423
  // The contract section names an option's type.