gloomberb 0.20.0 → 0.20.2

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 (481) hide show
  1. package/README.md +16 -26
  2. package/README.zh-CN.md +21 -65
  3. package/package.json +1 -1
  4. package/patches/electrobun-devkit@2.0.5.patch +268 -8
  5. package/src/account/auth-model.ts +20 -1
  6. package/src/account/upgrade-dialog.tsx +8 -4
  7. package/src/api-client/askg.ts +7 -1
  8. package/src/api-client/auth.ts +27 -0
  9. package/src/api-client/catalysts.ts +2 -0
  10. package/src/api-client/company-kpis.ts +2 -1
  11. package/src/api-client/cot.ts +14 -2
  12. package/src/api-client/crypto-markets.ts +20 -2
  13. package/src/api-client/data.ts +3 -2
  14. package/src/api-client/earnings.ts +46 -3
  15. package/src/api-client/fund-facts.ts +23 -1
  16. package/src/api-client/futures-curve.ts +17 -0
  17. package/src/api-client/index.ts +4 -1
  18. package/src/api-client/one-tap-reasons.ts +42 -0
  19. package/src/api-client/perps.ts +2 -1
  20. package/src/api-client/request.ts +3 -1
  21. package/src/api-client/research-activity.ts +16 -3
  22. package/src/api-client/types/filings-and-calls.ts +9 -0
  23. package/src/api-client/types/search.ts +3 -0
  24. package/src/app/keybindings/chord.ts +153 -9
  25. package/src/app/keybindings/index.ts +1 -1
  26. package/src/app/keybindings/labels.ts +49 -6
  27. package/src/app/runtime/desktop-deeplink.ts +73 -8
  28. package/src/app/runtime/plugin-seed.ts +119 -0
  29. package/src/app/runtime/startup.ts +45 -9
  30. package/src/app.tsx +8 -1
  31. package/src/architecture/core-builtin-allowlist.json +1 -2
  32. package/src/architecture/pane-tabs-allowlist.json +2 -1
  33. package/src/architecture/shortcut-labels-allowlist.json +11 -0
  34. package/src/architecture/ui-literals-allowlist.json +8 -8
  35. package/src/brokers/broker-portfolio-sync.ts +1 -1
  36. package/src/cli/bank-section.ts +26 -12
  37. package/src/cli/board-coins.ts +38 -5
  38. package/src/cli/commands/crypto-hints.ts +8 -1
  39. package/src/cli/commands/market.ts +294 -100
  40. package/src/cli/commands/overview.ts +13 -6
  41. package/src/cli/commands/ticker.ts +73 -21
  42. package/src/cli/company-name-hint.ts +19 -0
  43. package/src/cli/desktop-pane-shot-browser.ts +47 -31
  44. package/src/cli/desktop-pane-shot.ts +15 -0
  45. package/src/cli/entry.ts +15 -4
  46. package/src/cli/export-source.ts +7 -1
  47. package/src/cli/freshness.ts +0 -16
  48. package/src/cli/fx-pair.ts +64 -12
  49. package/src/cli/fx-quote-rate.ts +144 -0
  50. package/src/cli/glossary.ts +30 -0
  51. package/src/cli/helpers.ts +4 -2
  52. package/src/cli/history-back-adjust.ts +122 -0
  53. package/src/cli/history-rows.ts +114 -10
  54. package/src/cli/index.ts +4 -1
  55. package/src/cli/known-gaps.ts +45 -3
  56. package/src/cli/listing-arg.ts +48 -4
  57. package/src/cli/name-entries.ts +25 -5
  58. package/src/cli/not-a-ticker.ts +26 -1
  59. package/src/cli/pane-functions/catalog.ts +12 -2
  60. package/src/cli/pane-functions/dom.ts +4 -2
  61. package/src/cli/pane-functions/freshness.ts +45 -29
  62. package/src/cli/pane-functions/headless.ts +8 -5
  63. package/src/cli/pane-functions/index.ts +3 -0
  64. package/src/cli/pane-functions/market-session.ts +14 -5
  65. package/src/cli/pane-functions/resolver.ts +4 -1
  66. package/src/cli/pane-functions/screenshot-assessment.ts +15 -3
  67. package/src/cli/pane-functions/screenshot-payload.ts +130 -66
  68. package/src/cli/pane-functions/screenshot-render.ts +14 -2
  69. package/src/cli/pane-functions/screenshot-types.ts +4 -0
  70. package/src/cli/restore-plugins.ts +164 -51
  71. package/src/cli/symbol-rows.ts +22 -2
  72. package/src/cli/ticker-resolution.ts +74 -17
  73. package/src/components/chart/composite/axis-overlays.tsx +13 -3
  74. package/src/components/chart/composite/composite-chart.tsx +8 -1
  75. package/src/components/chart/composite/format.ts +16 -1
  76. package/src/components/chart/composite/legend.tsx +4 -3
  77. package/src/components/chart/composite/panel-labels.ts +2 -1
  78. package/src/components/chart/composite/panel-surface.tsx +33 -4
  79. package/src/components/chart/composite/time-scale.ts +1 -1
  80. package/src/components/chart/composite/toolbar.tsx +8 -4
  81. package/src/components/chart/composite/types.ts +17 -1
  82. package/src/components/chart/composite/use-composite-chart-keyboard.ts +15 -5
  83. package/src/components/chart/composite/use-composite-viewport.ts +31 -8
  84. package/src/components/chart/static/scatter-chart-surface.tsx +25 -9
  85. package/src/components/chart-table/axis.ts +11 -0
  86. package/src/components/chart-table/header.tsx +10 -1
  87. package/src/components/chart-table/layout.ts +14 -5
  88. package/src/components/command-bar/assist/inventory.ts +3 -2
  89. package/src/components/command-bar/commands/collection-list.ts +3 -2
  90. package/src/components/command-bar/panel/index.tsx +13 -0
  91. package/src/components/command-bar/panel/layout.ts +15 -1
  92. package/src/components/command-bar/panel/prompt-width.ts +34 -0
  93. package/src/components/command-bar/panel/runtime.ts +1 -0
  94. package/src/components/command-bar/panel/state.ts +4 -0
  95. package/src/components/command-bar/panel/types.ts +2 -0
  96. package/src/components/command-bar/routes/root/search-providers.ts +3 -2
  97. package/src/components/command-bar/routes/root/search-report.ts +2 -2
  98. package/src/components/command-bar/workflow/ticker-listing-picker.ts +1 -0
  99. package/src/components/company-logo.tsx +2 -2
  100. package/src/components/data-table/view.tsx +11 -2
  101. package/src/components/feed-data-table/stack-view.tsx +20 -6
  102. package/src/components/feedback-dialog.tsx +3 -1
  103. package/src/components/form-modal/field-row.tsx +1 -1
  104. package/src/components/form-modal/routes.ts +1 -0
  105. package/src/components/index.ts +1 -1
  106. package/src/components/layout/header.tsx +12 -3
  107. package/src/components/layout/market-summary.ts +2 -1
  108. package/src/components/layout/pane/footer/index.tsx +9 -5
  109. package/src/components/layout/pane/footer/model.ts +26 -10
  110. package/src/components/layout/pane/footer/registration.tsx +60 -1
  111. package/src/components/layout/pane/header-tabs.tsx +17 -3
  112. package/src/components/layout/pane/header.tsx +5 -2
  113. package/src/components/layout/pane/pane-tabs.tsx +57 -3
  114. package/src/components/layout/shell/active-drag.ts +38 -30
  115. package/src/components/layout/shell/drag/index.ts +51 -21
  116. package/src/components/layout/shell/menu.ts +3 -5
  117. package/src/components/layout/shell/pane/actions.ts +4 -1
  118. package/src/components/layout/shell/pane/ask.ts +5 -2
  119. package/src/components/layout/status-bar.tsx +59 -54
  120. package/src/components/markdown-text.tsx +35 -10
  121. package/src/components/onboarding/first-run-workspace.ts +25 -23
  122. package/src/components/onboarding/onboarding-keyboard.ts +6 -1
  123. package/src/components/onboarding/onboarding-wizard.tsx +12 -2
  124. package/src/components/onboarding/portfolio-step/positions-panel.tsx +3 -3
  125. package/src/components/onboarding/use-onboarding-broker-form.ts +2 -1
  126. package/src/components/onboarding/use-onboarding-progress.ts +11 -4
  127. package/src/components/onboarding/use-onboarding-upgrade.ts +3 -2
  128. package/src/components/onboarding/wizard-positions.ts +8 -1
  129. package/src/components/pane-notice-seen.ts +125 -0
  130. package/src/components/pane-settings-dialog/field-dialogs.tsx +2 -1
  131. package/src/components/pane-settings-dialog.tsx +7 -6
  132. package/src/components/sign-in-code-panel.tsx +3 -2
  133. package/src/components/speedometer-gauge/terminal.tsx +30 -9
  134. package/src/components/ticker/list-table-view.tsx +39 -3
  135. package/src/components/ui/confirm-dialog.tsx +2 -1
  136. package/src/components/ui/data-table/index.tsx +4 -2
  137. package/src/components/ui/data-table/opentui/index.tsx +15 -5
  138. package/src/components/ui/data-table/types.ts +8 -0
  139. package/src/components/ui/external-link.tsx +4 -1
  140. package/src/components/ui/field-grid.tsx +1 -1
  141. package/src/components/ui/index.ts +2 -0
  142. package/src/components/ui/inline-quick-add.tsx +5 -0
  143. package/src/components/ui/multi-select/dialog.tsx +10 -9
  144. package/src/components/ui/pane-link-chip.tsx +354 -0
  145. package/src/components/ui/query-bar.tsx +22 -13
  146. package/src/components/ui/ratio-bar.tsx +24 -1
  147. package/src/components/ui/select-button.tsx +2 -1
  148. package/src/components/ui/shortcut-hint.tsx +6 -3
  149. package/src/components/ui/table-layout.ts +81 -0
  150. package/src/components/ui/tabs.tsx +45 -6
  151. package/src/components/use-pane-notice-footer.tsx +12 -4
  152. package/src/core/app-service-ports.ts +1 -1
  153. package/src/data/plugin-state-store.ts +44 -8
  154. package/src/docs/snapshot.json +53 -32
  155. package/src/i18n/es.ts +28 -6
  156. package/src/i18n/ja.ts +28 -5
  157. package/src/i18n/ko.ts +28 -5
  158. package/src/i18n/zh-cn.ts +28 -5
  159. package/src/i18n/zh-tw.ts +28 -5
  160. package/src/layout/pane-manager/gridlock-inference.ts +2 -1
  161. package/src/layout/pane-manager/gridlock.ts +47 -2
  162. package/src/layout-marketplace/api.ts +1 -0
  163. package/src/layout-marketplace/gallery.tsx +4 -3
  164. package/src/layout-marketplace/linked.ts +6 -4
  165. package/src/layout-marketplace/model.ts +3 -2
  166. package/src/market-data/fund-facts.ts +7 -1
  167. package/src/market-data/futures-contract.ts +77 -31
  168. package/src/market-data/fx-closes.ts +5 -2
  169. package/src/market-data/hooks.tsx +23 -0
  170. package/src/market-data/market/change-basis.ts +92 -14
  171. package/src/market-data/market/format.ts +81 -13
  172. package/src/market-data/market/futures-week.ts +3 -1
  173. package/src/market-data/market/globex-day.ts +73 -0
  174. package/src/market-data/market/index-level.ts +10 -1
  175. package/src/market-data/quotes/intraday-bar.ts +1 -1
  176. package/src/market-data/quotes/session-split.ts +28 -0
  177. package/src/plugins/builtin/account-management/pane.tsx +1 -1
  178. package/src/plugins/builtin/analytics/account-returns.ts +1 -1
  179. package/src/plugins/builtin/analytics/index.tsx +10 -3
  180. package/src/plugins/builtin/analytics/pane-model.ts +1 -1
  181. package/src/plugins/builtin/analytics/risk-client.ts +4 -1
  182. package/src/plugins/builtin/analytics/risk-episodes.ts +422 -0
  183. package/src/plugins/builtin/analytics/risk-fx.ts +1 -1
  184. package/src/plugins/builtin/analytics/risk-headless.ts +28 -10
  185. package/src/plugins/builtin/analytics/risk-math.ts +1 -1
  186. package/src/plugins/builtin/analytics/risk-model.ts +115 -26
  187. package/src/plugins/builtin/analytics/risk-pane.tsx +201 -23
  188. package/src/plugins/builtin/analytics/sharpe-cadence.ts +1 -1
  189. package/src/plugins/builtin/backtest/format.ts +14 -0
  190. package/src/plugins/builtin/backtest/pane.tsx +3 -3
  191. package/src/plugins/builtin/backtest/report.ts +5 -3
  192. package/src/plugins/builtin/broker-manager/add-request.ts +10 -1
  193. package/src/plugins/builtin/broker-trading/pane.tsx +20 -2
  194. package/src/plugins/builtin/buildout/company/flow.tsx +5 -5
  195. package/src/plugins/builtin/buildout/company/model.ts +14 -2
  196. package/src/plugins/builtin/catalysts/detail.tsx +2 -2
  197. package/src/plugins/builtin/catalysts/model.ts +7 -2
  198. package/src/plugins/builtin/catalysts/pane.tsx +2 -2
  199. package/src/plugins/builtin/chart-composer/headless.ts +57 -17
  200. package/src/plugins/builtin/chart-composer/session-range.ts +82 -3
  201. package/src/plugins/builtin/chat/message/pane-chip.tsx +36 -208
  202. package/src/plugins/builtin/cloud/askg/answer-follow-ups.tsx +61 -0
  203. package/src/plugins/builtin/cloud/askg/answer-sources.tsx +102 -0
  204. package/src/plugins/builtin/cloud/askg/controller.ts +7 -1
  205. package/src/plugins/builtin/cloud/askg/host.ts +57 -0
  206. package/src/plugins/builtin/cloud/askg/model.ts +45 -5
  207. package/src/plugins/builtin/cloud/askg/pane.tsx +304 -25
  208. package/src/plugins/builtin/cloud/askg/protocol.ts +26 -1
  209. package/src/plugins/builtin/cloud/askg/sources.ts +466 -0
  210. package/src/plugins/builtin/cloud/one-tap/controller.ts +309 -0
  211. package/src/plugins/builtin/cloud/one-tap/google-identity.ts +142 -0
  212. package/src/plugins/builtin/cloud/one-tap/one-tap-prompt.tsx +101 -0
  213. package/src/plugins/builtin/cloud/plugin.tsx +7 -1
  214. package/src/plugins/builtin/company-kpis/client.ts +4 -3
  215. package/src/plugins/builtin/company-kpis/model.ts +34 -3
  216. package/src/plugins/builtin/correlation/compute.ts +8 -2
  217. package/src/plugins/builtin/correlation/headless.ts +10 -9
  218. package/src/plugins/builtin/correlation/history.ts +30 -0
  219. package/src/plugins/builtin/correlation/index.tsx +39 -167
  220. package/src/plugins/builtin/correlation/matrix/grid.tsx +285 -0
  221. package/src/plugins/builtin/correlation/matrix/model.ts +10 -10
  222. package/src/plugins/builtin/correlation/relationship/model.ts +3 -6
  223. package/src/plugins/builtin/correlation/relationship/pane.tsx +7 -9
  224. package/src/plugins/builtin/correlation/relationship/view-model.ts +14 -5
  225. package/src/plugins/builtin/cot/client.ts +8 -3
  226. package/src/plugins/builtin/cot/headless.ts +65 -12
  227. package/src/plugins/builtin/cot/pane.tsx +11 -5
  228. package/src/plugins/builtin/crypto-board/client.ts +6 -1
  229. package/src/plugins/builtin/crypto-board/defi-view.tsx +12 -1
  230. package/src/plugins/builtin/crypto-board/defi.ts +44 -7
  231. package/src/plugins/builtin/crypto-board/headless.ts +83 -12
  232. package/src/plugins/builtin/crypto-board/model.ts +30 -6
  233. package/src/plugins/builtin/crypto-board/pane.tsx +13 -2
  234. package/src/plugins/builtin/earnings/client.ts +40 -6
  235. package/src/plugins/builtin/earnings/fiscal-quarter.ts +54 -0
  236. package/src/plugins/builtin/earnings/headless.ts +47 -11
  237. package/src/plugins/builtin/earnings/history-model.ts +136 -24
  238. package/src/plugins/builtin/earnings/history-table.ts +42 -10
  239. package/src/plugins/builtin/earnings/history.tsx +23 -8
  240. package/src/plugins/builtin/earnings-ripple/client.ts +5 -2
  241. package/src/plugins/builtin/earnings-ripple/headless.ts +8 -3
  242. package/src/plugins/builtin/earnings-ripple/model.ts +21 -0
  243. package/src/plugins/builtin/earnings-ripple/pane.tsx +2 -3
  244. package/src/plugins/builtin/econ/index.tsx +5 -4
  245. package/src/plugins/builtin/econ-statistics/stats.ts +13 -5
  246. package/src/plugins/builtin/equity-screener/headless.ts +2 -1
  247. package/src/plugins/builtin/filing-events/feed.ts +56 -18
  248. package/src/plugins/builtin/filing-events/pane.tsx +8 -2
  249. package/src/plugins/builtin/futures/index.tsx +32 -10
  250. package/src/plugins/builtin/futures/model.ts +93 -6
  251. package/src/plugins/builtin/futures/returns.ts +29 -7
  252. package/src/plugins/builtin/futures/table.tsx +59 -17
  253. package/src/plugins/builtin/futures/use-front-returns.ts +32 -6
  254. package/src/plugins/builtin/futures-curve/client.ts +12 -2
  255. package/src/plugins/builtin/futures-curve/headless.ts +58 -17
  256. package/src/plugins/builtin/futures-curve/model.ts +111 -15
  257. package/src/plugins/builtin/futures-curve/pane.tsx +11 -6
  258. package/src/plugins/builtin/fx-matrix/amount.ts +132 -0
  259. package/src/plugins/builtin/fx-matrix/headless.ts +53 -13
  260. package/src/plugins/builtin/fx-matrix/index.tsx +205 -42
  261. package/src/plugins/builtin/fx-matrix/pairs.ts +10 -8
  262. package/src/plugins/builtin/fx-matrix/settings.ts +22 -1
  263. package/src/plugins/builtin/help/index.tsx +68 -61
  264. package/src/plugins/builtin/holders/format.ts +7 -2
  265. package/src/plugins/builtin/holders/pane.tsx +11 -3
  266. package/src/plugins/builtin/holders/report-header.ts +5 -4
  267. package/src/plugins/builtin/holders/report-rows.ts +4 -1
  268. package/src/plugins/builtin/holders/treemap.tsx +5 -3
  269. package/src/plugins/builtin/insider/signals-model.ts +4 -5
  270. package/src/plugins/builtin/ipo-calendar/headless.ts +18 -7
  271. package/src/plugins/builtin/ipo-calendar/listing-ipo.ts +3 -1
  272. package/src/plugins/builtin/ipo-calendar/model.ts +28 -8
  273. package/src/plugins/builtin/ipo-calendar/pane.tsx +2 -1
  274. package/src/plugins/builtin/kelly-sizer/headless.ts +4 -0
  275. package/src/plugins/builtin/perps/headless.ts +81 -19
  276. package/src/plugins/builtin/perps/index.tsx +3 -1
  277. package/src/plugins/builtin/perps/model.ts +1 -1
  278. package/src/plugins/builtin/perps/pane.tsx +2 -0
  279. package/src/plugins/builtin/portfolio-list/cell-version.ts +1 -0
  280. package/src/plugins/builtin/portfolio-list/cli/bulk-symbols.ts +20 -1
  281. package/src/plugins/builtin/portfolio-list/cli/import-positions.ts +260 -0
  282. package/src/plugins/builtin/portfolio-list/cli/period-report.ts +154 -0
  283. package/src/plugins/builtin/portfolio-list/cli/portfolio-command.ts +64 -22
  284. package/src/plugins/builtin/portfolio-list/cli/render.ts +18 -7
  285. package/src/plugins/builtin/portfolio-list/cli/watchlist-command.ts +5 -3
  286. package/src/plugins/builtin/portfolio-list/grid.tsx +56 -12
  287. package/src/plugins/builtin/portfolio-list/headless.ts +128 -0
  288. package/src/plugins/builtin/portfolio-list/pane/index.tsx +42 -4
  289. package/src/plugins/builtin/portfolio-list/pane/period-pnl.ts +124 -0
  290. package/src/plugins/builtin/portfolio-list/period-pnl.ts +179 -0
  291. package/src/plugins/builtin/portfolio-list/positions-import/dialog.tsx +445 -0
  292. package/src/plugins/builtin/portfolio-list/positions-import/index.tsx +255 -0
  293. package/src/plugins/builtin/portfolio-list/positions-import/lookup.ts +78 -0
  294. package/src/plugins/builtin/portfolio-list/positions-import/read-file.ts +32 -0
  295. package/src/plugins/builtin/portfolio-list/quick-add/index.tsx +186 -50
  296. package/src/plugins/builtin/portfolio-list/quick-add/resolution.ts +118 -4
  297. package/src/plugins/builtin/portfolio-list/settings.ts +25 -0
  298. package/src/plugins/builtin/portfolio-list/summary/index.tsx +16 -1
  299. package/src/plugins/builtin/portfolio-list/summary/totals.ts +7 -5
  300. package/src/plugins/builtin/portfolio-list/table.tsx +105 -6
  301. package/src/plugins/builtin/power/headless.ts +47 -9
  302. package/src/plugins/builtin/research/relative-valuation-model.ts +8 -3
  303. package/src/plugins/builtin/research-search/article.ts +12 -2
  304. package/src/plugins/builtin/research-search/data.ts +5 -2
  305. package/src/plugins/builtin/research-search/document-view.tsx +1 -1
  306. package/src/plugins/builtin/research-search/model.ts +47 -3
  307. package/src/plugins/builtin/research-search/pane.tsx +3 -2
  308. package/src/plugins/builtin/reverse-dcf/model.ts +7 -4
  309. package/src/plugins/builtin/risk-factors/headless.ts +3 -2
  310. package/src/plugins/builtin/risk-factors/index.tsx +2 -28
  311. package/src/plugins/builtin/risk-factors/lock-note.ts +58 -0
  312. package/src/plugins/builtin/risk-factors/pane.tsx +14 -5
  313. package/src/plugins/builtin/scanner/flow-model.ts +17 -13
  314. package/src/plugins/builtin/scanner/flow-pane.tsx +8 -9
  315. package/src/plugins/builtin/scanner/flow-session.ts +2 -9
  316. package/src/plugins/builtin/scanner/hilo-model.ts +4 -3
  317. package/src/plugins/builtin/sec/filing-display.tsx +0 -5
  318. package/src/plugins/builtin/sec/forms.ts +19 -0
  319. package/src/plugins/builtin/sec/fund-facts.ts +45 -11
  320. package/src/plugins/builtin/sec/headless.ts +37 -12
  321. package/src/plugins/builtin/sec/index.tsx +37 -8
  322. package/src/plugins/builtin/shared/earnings-calendar.ts +6 -3
  323. package/src/plugins/builtin/shared/earnings-report.ts +1 -1
  324. package/src/plugins/builtin/shared/fx-rate-freshness.ts +0 -35
  325. package/src/plugins/builtin/shared/pro-lock-note.ts +5 -1
  326. package/src/plugins/builtin/shared/use-quote-board.ts +42 -27
  327. package/src/plugins/builtin/supply-chain/graph-model.ts +7 -1
  328. package/src/plugins/builtin/supply-chain/headless.ts +20 -10
  329. package/src/plugins/builtin/supply-chain/model.ts +117 -20
  330. package/src/plugins/builtin/supply-chain/pane.tsx +22 -15
  331. package/src/plugins/builtin/supply-chain/row-evidence.tsx +1 -1
  332. package/src/plugins/builtin/ticker-detail/data-panes/returns-chart-model.ts +69 -0
  333. package/src/plugins/builtin/ticker-detail/data-panes/returns-chart.tsx +118 -0
  334. package/src/plugins/builtin/ticker-detail/data-panes/returns-model.ts +1 -1
  335. package/src/plugins/builtin/ticker-detail/data-panes/returns-pane.tsx +103 -40
  336. package/src/plugins/builtin/ticker-detail/headless-schema.ts +10 -1
  337. package/src/plugins/builtin/ticker-detail/headless.ts +8 -1
  338. package/src/plugins/builtin/ticker-detail/overview/components.tsx +2 -1
  339. package/src/plugins/builtin/ticker-detail/overview/model.ts +18 -8
  340. package/src/plugins/builtin/ticker-detail/overview-tab.tsx +11 -8
  341. package/src/plugins/builtin/ticker-detail/pane.tsx +95 -20
  342. package/src/plugins/builtin/ticker-detail/research-groups.ts +89 -0
  343. package/src/plugins/builtin/ticker-detail/settings.ts +4 -3
  344. package/src/plugins/builtin/time-sales/headless.ts +23 -7
  345. package/src/plugins/builtin/time-sales/index.tsx +2 -2
  346. package/src/plugins/builtin/volatility/charts.tsx +2 -2
  347. package/src/plugins/extracted-plugins.ts +49 -24
  348. package/src/plugins/host-resolver.ts +3 -2
  349. package/src/plugins/installer.ts +220 -31
  350. package/src/plugins/running-installs.ts +34 -0
  351. package/src/plugins/seed-progress.ts +72 -0
  352. package/src/portfolio/column-values.ts +42 -8
  353. package/src/portfolio/futures-positions.ts +10 -2
  354. package/src/portfolio/mutations.ts +4 -3
  355. package/src/portfolio/period-pnl.ts +119 -0
  356. package/src/portfolio/positions-import/describe.ts +89 -0
  357. package/src/portfolio/positions-import/parse.ts +682 -0
  358. package/src/portfolio/positions-import/plan.ts +295 -0
  359. package/src/{plugins/builtin/analytics/metrics.ts → portfolio/return-metrics.ts} +24 -11
  360. package/src/public/__snapshots__/public-api.test.ts.snap +1 -0
  361. package/src/react/jsx-dev-fallback.ts +62 -0
  362. package/src/renderers/browser/cloud-transport.ts +1 -1
  363. package/src/renderers/browser/config-host.ts +3 -1
  364. package/src/renderers/browser/deeplink-bridge.ts +8 -1
  365. package/src/renderers/browser/http-proxy-transport.ts +9 -2
  366. package/src/renderers/browser/main.tsx +2 -1
  367. package/src/renderers/browser/research-entry.ts +12 -0
  368. package/src/renderers/cloudflare/http-proxy.ts +8 -2
  369. package/src/renderers/cloudflare/proxy-session.ts +1 -0
  370. package/src/renderers/cloudflare/worker.ts +12 -3
  371. package/src/renderers/dom/desktop/audio-player.tsx +2 -2
  372. package/src/renderers/dom/desktop/controls.tsx +1 -1
  373. package/src/renderers/dom/desktop/dialog-actions.tsx +10 -24
  374. package/src/renderers/dom/desktop/icons.tsx +4 -2
  375. package/src/renderers/dom/desktop/query-bar.tsx +23 -19
  376. package/src/renderers/dom/dom-host-providers.tsx +7 -2
  377. package/src/renderers/dom/host/box.tsx +2 -2
  378. package/src/renderers/dom/host/input.tsx +13 -0
  379. package/src/renderers/dom/key-event.ts +1 -0
  380. package/src/renderers/dom/styles.css +3 -0
  381. package/src/renderers/electrobun/bun/context-menu/click.ts +1 -0
  382. package/src/renderers/electrobun/bun/desktop/backend.ts +15 -0
  383. package/src/renderers/electrobun/bun/desktop/capability-bridge.ts +5 -4
  384. package/src/renderers/electrobun/bun/desktop/host-requests.ts +19 -11
  385. package/src/renderers/electrobun/bun/desktop/http-fetch.ts +1 -0
  386. package/src/renderers/electrobun/bun/desktop/http-stream.ts +1 -1
  387. package/src/renderers/electrobun/bun/desktop/initialization.ts +27 -15
  388. package/src/renderers/electrobun/bun/desktop/install-records.ts +4 -1
  389. package/src/renderers/electrobun/bun/desktop/installer-folder.ts +5 -2
  390. package/src/renderers/electrobun/bun/desktop/macos-objc.ts +3 -1
  391. package/src/renderers/electrobun/bun/desktop/screen-setup-file.ts +9 -4
  392. package/src/renderers/electrobun/bun/desktop/update.ts +27 -13
  393. package/src/renderers/electrobun/bun/desktop/windows-script.ts +6 -2
  394. package/src/renderers/electrobun/bun/index.ts +5 -0
  395. package/src/renderers/electrobun/bun/window/attention.ts +1 -0
  396. package/src/renderers/electrobun/bun/window/boot-frame.ts +1 -0
  397. package/src/renderers/electrobun/bun/window/context-menu-thread.ts +84 -0
  398. package/src/renderers/electrobun/bun/window/create.ts +1 -0
  399. package/src/renderers/electrobun/bun/window/electrobun-window-host.ts +13 -8
  400. package/src/renderers/electrobun/bun/window/native-call-thread.ts +224 -0
  401. package/src/renderers/electrobun/bun/window/native-min-size.ts +1 -1
  402. package/src/renderers/electrobun/bun/window/native-timing.ts +10 -0
  403. package/src/renderers/electrobun/bun/window/remembered-frame.ts +1 -0
  404. package/src/renderers/electrobun/bun/window/script-for-webview.ts +15 -0
  405. package/src/renderers/electrobun/bun/window/webview-script-thread.ts +82 -0
  406. package/src/renderers/electrobun/bun/window/windows-native.ts +3 -1
  407. package/src/renderers/electrobun/bun/window/windows-quit.ts +3 -1
  408. package/src/renderers/electrobun/shared/protocol.ts +13 -2
  409. package/src/renderers/electrobun/view/app-badge-host.ts +2 -1
  410. package/src/renderers/electrobun/view/backend-rpc.ts +7 -0
  411. package/src/renderers/electrobun/view/capability-subscription.ts +2 -1
  412. package/src/renderers/electrobun/view/cli-pane-shot-entry.tsx +7 -10
  413. package/src/renderers/electrobun/view/cli-pane-shot-frame.tsx +1 -1
  414. package/src/renderers/electrobun/view/cli-pane-shot-mutations.ts +36 -0
  415. package/src/renderers/electrobun/view/http-fetch.ts +2 -1
  416. package/src/renderers/electrobun/view/main.tsx +13 -7
  417. package/src/renderers/electrobun/view/remote/capability-invoker.ts +6 -3
  418. package/src/renderers/electrobun/view/remote/persistence.ts +63 -27
  419. package/src/renderers/electrobun/view/rpc-timeout.ts +1 -0
  420. package/src/renderers/electrobun/view/ui-host.tsx +3 -2
  421. package/src/renderers/electrobun/view/window-fullscreen.ts +3 -1
  422. package/src/renderers/opentui/browser-open.ts +2 -1
  423. package/src/renderers/opentui/dialog-host.tsx +1 -1
  424. package/src/renderers/opentui/interaction-performance.ts +3 -1
  425. package/src/renderers/opentui/start.tsx +5 -1
  426. package/src/renderers/opentui/terminal-media.ts +11 -6
  427. package/src/renderers/opentui/ui-host.tsx +5 -8
  428. package/src/shares/open.ts +22 -1
  429. package/src/shares/pane.ts +2 -1
  430. package/src/sources/gloomberb-cloud/normalizers.ts +3 -0
  431. package/src/sync/analytics-payload.ts +194 -0
  432. package/src/sync/baseline.ts +19 -9
  433. package/src/sync/broker-identity.ts +171 -0
  434. package/src/sync/broker-instances.ts +137 -0
  435. package/src/sync/collections-contributor.ts +173 -0
  436. package/src/sync/config-contributor.ts +100 -0
  437. package/src/sync/config-merge.ts +229 -0
  438. package/src/sync/controller.ts +139 -28
  439. package/src/sync/core-contributors.ts +8 -1583
  440. package/src/sync/history-memo.ts +32 -0
  441. package/src/sync/layout-merge.ts +259 -0
  442. package/src/sync/sanitize.ts +114 -0
  443. package/src/sync/ticker-merge.ts +208 -0
  444. package/src/sync/ticker-payload.ts +81 -0
  445. package/src/sync/types.ts +15 -1
  446. package/src/telemetry/attention-setting.ts +1 -1
  447. package/src/telemetry/stall-reports.ts +21 -4
  448. package/src/telemetry/usage-counts.ts +16 -0
  449. package/src/test-support/preload.ts +5 -0
  450. package/src/theme/color-utils.ts +10 -0
  451. package/src/theme/font-scale.ts +34 -3
  452. package/src/theme/series-colors.ts +44 -0
  453. package/src/theme/themes.ts +2 -1
  454. package/src/tickers/batched-lookups.ts +263 -6
  455. package/src/tickers/company-name-listing.ts +44 -2
  456. package/src/tickers/company-name.ts +7 -2
  457. package/src/tickers/search/upsert.ts +16 -1
  458. package/src/time-series/base-series.ts +18 -4
  459. package/src/time-series/studies/indicators.ts +3 -1
  460. package/src/time-series/studies/resolve.ts +1 -1
  461. package/src/time-series/types.ts +6 -0
  462. package/src/types/financials.ts +18 -0
  463. package/src/types/headless.ts +11 -0
  464. package/src/ui/host.tsx +26 -3
  465. package/src/ui/index.tsx +1 -0
  466. package/src/utils/concurrency.ts +6 -0
  467. package/src/utils/currency-pair.ts +56 -4
  468. package/src/utils/datetime-format.ts +11 -0
  469. package/src/utils/decimal-comma.ts +9 -6
  470. package/src/utils/exchanges.ts +32 -0
  471. package/src/utils/fundamentals.ts +41 -0
  472. package/src/utils/main-thread-stall.ts +21 -5
  473. package/src/utils/markdown.ts +4 -2
  474. package/src/utils/pasted-lines.ts +14 -0
  475. package/src/utils/perf-marks.ts +88 -9
  476. package/src/utils/price-window.ts +2 -1
  477. package/src/utils/reported-money.ts +9 -2
  478. package/src/utils/sec-filings.ts +17 -0
  479. package/src/utils/sec.ts +37 -25
  480. package/src/utils/shortcut-labels.ts +6 -30
  481. package/src/plugins/seed-notice.ts +0 -20
@@ -54,6 +54,7 @@ import {
54
54
  formatOffPeg,
55
55
  nextCryptoSort,
56
56
  offPegSeverity,
57
+ readCryptoSort,
57
58
  sortCryptoRows,
58
59
  withCryptoSupply,
59
60
  type CryptoColumn,
@@ -79,6 +80,9 @@ const SUPPLY_REFRESH_MS = 30 * 60_000;
79
80
 
80
81
  const SUPPLY_RANGE_OPTIONS = SUPPLY_RANGES.map(({ value, label }) => ({ value, label }));
81
82
 
83
+ /** The most of the stablecoin tab the supply chart takes, under the rows. */
84
+ const STABLECOIN_SUPPLY_CHART_SHARE = 1 / 3;
85
+
82
86
  const cryptoTickerKey = (row: CryptoRow) => publicTickerKey(row.asset.symbol, "CCC");
83
87
 
84
88
  function quoteTargets(
@@ -190,7 +194,12 @@ export function CryptoBoardPane({ width, height, focused }: PaneProps) {
190
194
  const liveStreaming = useLiveStreamingSetting();
191
195
  const [activeTab, setActiveTab] = usePluginPaneState<CryptoTab>("activeTab", "coin");
192
196
  const [selectedId, setSelectedId] = usePluginPaneState<string | null>("selected", null);
193
- const [sort, setSort] = useState<CryptoSortPreference>(DEFAULT_CRYPTO_SORT);
197
+ // Kept with the pane, so `shot CRYP --sort offpeg` opens on the order it asked for.
198
+ const [savedSort, setSavedSort] = usePluginPaneState<unknown>("sort", DEFAULT_CRYPTO_SORT);
199
+ const sort = useMemo(() => readCryptoSort(savedSort), [savedSort]);
200
+ const setSort = useCallback((update: (current: CryptoSortPreference) => CryptoSortPreference) => (
201
+ setSavedSort((current: unknown) => update(readCryptoSort(current)))
202
+ ), [setSavedSort]);
194
203
  const [visibleRange, setVisibleRange] = useState(INITIAL_STREAM_RANGE);
195
204
  const paneVisible = usePaneVisible();
196
205
  const reloadBoard = resource.load;
@@ -395,7 +404,8 @@ export function CryptoBoardPane({ width, height, focused }: PaneProps) {
395
404
  renderCell={renderCell}
396
405
  selectedTextOverridesCellColor
397
406
  emptyStateTitle="No crypto assets returned."
398
- rootBefore={stablecoins ? (
407
+ // The pegs are what the tab is read for: the rows come first, the supply under them in at most a third.
408
+ rootAfter={stablecoins ? (
399
409
  <ChartTableHeader
400
410
  width={width}
401
411
  height={bodyHeight}
@@ -410,6 +420,7 @@ export function CryptoBoardPane({ width, height, focused }: PaneProps) {
410
420
  remoteKind: "stablecoin-supply-history",
411
421
  loading: supplyResource.loading && !supply,
412
422
  empty: supplyError ? "Stablecoin supply is unavailable right now." : "No stablecoin supply history yet.",
423
+ maxShare: STABLECOIN_SUPPLY_CHART_SHARE,
413
424
  }}
414
425
  />
415
426
  ) : undefined}
@@ -5,6 +5,7 @@ import type {
5
5
  EarningsHistoryPayload,
6
6
  EarningsReport,
7
7
  } from "../../../api-client/earnings";
8
+ import { ApiRequestError } from "../../../api-client/errors";
8
9
  import { createPluginCache } from "../../../data/plugin-cache";
9
10
  import type { PluginPersistence } from "../../../types/plugin";
10
11
  import { cachedCloudResource, loadCloudResource, unavailableOnServer } from "../shared/cloud-resource";
@@ -48,8 +49,15 @@ function validateEarningsCalendar(payload: EarningsCalendarPayload): EarningsCal
48
49
  return payload;
49
50
  }
50
51
 
52
+ /** The listing asked for: a Hong Kong code reads the same with or without its leading zeros (700:HKEX is 0700:HKEX). */
53
+ export function sameHistoryListing(served: unknown, asked: string): boolean {
54
+ if (served === asked) return true;
55
+ const code = (value: string) => /^(\d+):HKEX$/i.exec(value)?.[1]?.replace(/^0+(?=\d)/, "") ?? null;
56
+ return typeof served === "string" && code(asked) != null && code(served) === code(asked);
57
+ }
58
+
51
59
  function validateEarningsHistory(payload: EarningsHistoryPayload, symbol: string): EarningsHistoryPayload {
52
- if (!payload || payload.symbol !== symbol || !Array.isArray(payload.reports)
60
+ if (!payload || !sameHistoryListing(payload.symbol, symbol) || !Array.isArray(payload.reports)
53
61
  || payload.reports.some((report) => !validReport(report) || !numberOrNull(report.revenueActual))) {
54
62
  throw new Error("The server returned an invalid earnings history");
55
63
  }
@@ -88,12 +96,38 @@ export function loadEarningsBoard(query: EarningsCalendarQuery, force = false) {
88
96
  { force, validate: validateEarningsCalendar });
89
97
  }
90
98
 
91
- export function cachedEarningsHistory(symbol: string) {
92
- return cachedCloudResource(historyCache, symbol, (payload) => validateEarningsHistory(payload, symbol));
99
+ /**
100
+ * A history's cache key. A listing abroad's history differs by plan (Gloom
101
+ * Cloud adds its announcements' figures for Pro), so `accessKey` (the session
102
+ * and plan) keeps one account's apart from another's, and from the next
103
+ * sign-in's.
104
+ */
105
+ const historyKey = (symbol: string, limit?: number, accessKey?: string) => {
106
+ const key = limit == null ? symbol : `${symbol}:${limit}`;
107
+ return accessKey ? `${key}|${accessKey}` : key;
108
+ };
109
+
110
+ export function cachedEarningsHistory(symbol: string, accessKey?: string) {
111
+ return cachedCloudResource(historyCache, historyKey(symbol, undefined, accessKey), (payload) => validateEarningsHistory(payload, symbol));
112
+ }
113
+
114
+ /**
115
+ * Whether ERN reads a listing's own past reports: every US listing, and of
116
+ * the listings abroad Hong Kong's, which Gloom Cloud reads from their
117
+ * results announcements. Any other listing abroad shows its next report.
118
+ */
119
+ export function hasEarningsHistory(venueAbroad: string | null): boolean {
120
+ return venueAbroad == null || venueAbroad === "HKEX";
121
+ }
122
+
123
+ /** A server that does not read a listing abroad's history yet refuses it (400): the next report stands alone, as before. */
124
+ export function noHistoryAbroad(error: unknown): null {
125
+ if (error instanceof ApiRequestError && error.status === 400) return null;
126
+ throw error;
93
127
  }
94
128
 
95
- /** `limit` asks for more reports than the pane's default and is cached apart from it. */
96
- export function loadEarningsHistory(symbol: string, force = false, limit?: number) {
97
- return loadCloudResource(historyCache, limit == null ? symbol : `${symbol}:${limit}`, () => fetchEarningsHistory(symbol, apiClient, limit),
129
+ /** `limit` asks for more reports than the pane's default and is cached apart from it; `accessKey` as `cachedEarningsHistory`. */
130
+ export function loadEarningsHistory(symbol: string, force = false, limit?: number, accessKey?: string) {
131
+ return loadCloudResource(historyCache, historyKey(symbol, limit, accessKey), () => fetchEarningsHistory(symbol, apiClient, limit),
98
132
  { force, validate: (payload) => validateEarningsHistory(payload, symbol) });
99
133
  }
@@ -0,0 +1,54 @@
1
+ import type { EarningsFiscalAnchor } from "../../../api-client/earnings";
2
+ import { addDays } from "./board-model";
3
+
4
+ /** A quarter as the company names it: NVIDIA's October 2026 quarter is Q3 of fiscal 2027. */
5
+ export interface FiscalQuarter {
6
+ fiscalYear: number;
7
+ fiscalQuarter: number;
8
+ }
9
+
10
+ const MONTH = /^(\d{4})-(\d{2})$/;
11
+
12
+ function monthIndex(period: string | null | undefined): number | null {
13
+ const found = period ? MONTH.exec(period) : null;
14
+ if (!found) return null;
15
+ const month = Number(found[2]);
16
+ return month >= 1 && month <= 12 ? Number(found[1]) * 12 + month - 1 : null;
17
+ }
18
+
19
+ const monthOf = (index: number) => `${Math.floor(index / 12)}-${String((index % 12) + 1).padStart(2, "0")}`;
20
+ const monthEnd = (index: number) => addDays(`${monthOf(index + 1)}-01`, -1);
21
+
22
+ /** The quarter ending in `period` (YYYY-MM), stepped from the one the company's calls name. */
23
+ export function fiscalQuarterOf(period: string | null | undefined, anchor: EarningsFiscalAnchor | null | undefined): FiscalQuarter | null {
24
+ const month = monthIndex(period);
25
+ const from = monthIndex(anchor?.fiscalPeriod);
26
+ if (month == null || from == null || !anchor) return null;
27
+ const index = anchor.fiscalYear * 4 + anchor.fiscalQuarter - 1 + Math.round((month - from) / 3);
28
+ return { fiscalYear: Math.floor(index / 4), fiscalQuarter: (index % 4) + 1 };
29
+ }
30
+
31
+ /**
32
+ * The quarter-end month a report with none on record announces: the last on
33
+ * the company's cycle that ended 5 to 100 days before it, as Gloom Cloud
34
+ * places its own such reports. Null without the company's calendar.
35
+ */
36
+ export function placedPeriod(date: string, anchor: EarningsFiscalAnchor | null | undefined): string | null {
37
+ const cycle = monthIndex(anchor?.fiscalPeriod);
38
+ const day = monthIndex(date.slice(0, 7));
39
+ if (cycle == null || day == null) return null;
40
+ const latest = addDays(date, -5);
41
+ const earliest = addDays(date, -100);
42
+ for (let month = day; month > day - 5; month -= 1) {
43
+ if ((month - cycle) % 3 !== 0) continue;
44
+ const end = monthEnd(month);
45
+ if (end <= latest && end >= earliest) return monthOf(month);
46
+ }
47
+ return null;
48
+ }
49
+
50
+ /** "Q3 FY2027", or "Q3 FY27" where a column is narrow. */
51
+ export function fiscalQuarterText(quarter: FiscalQuarter | null | undefined, short = false): string | null {
52
+ if (!quarter) return null;
53
+ return `Q${quarter.fiscalQuarter} FY${short ? String(quarter.fiscalYear).slice(-2) : quarter.fiscalYear}`;
54
+ }
@@ -11,10 +11,11 @@ import type {
11
11
  import type { EarningsEvent } from "../../../types/data-provider";
12
12
  import { addDays, boardReport, fallbackReport, MIN_AVERAGE_REPORTS, newYorkToday, type BoardReport } from "./board-model";
13
13
  import { BOARD_WEEKS, boardRangeDays, boardRangeLabel, isBoardWeek, requestedBoardRange, type BoardRange } from "./calendar-model";
14
- import { fetchEarningsCalendar, fetchEarningsHistory } from "./client";
14
+ import { fetchEarningsCalendar, fetchEarningsHistory, hasEarningsHistory, noHistoryAbroad } from "./client";
15
15
  import { loadEarningsCalendar } from "./data/cache";
16
16
  import { epsText, impliedText, moneyText, moveSize, signedPercent, TIMING_LABEL } from "./format";
17
- import { historyRows } from "./history-model";
17
+ import { historyRows, periodText } from "./history-model";
18
+ import { fiscalQuarterText } from "./fiscal-quarter";
18
19
  import { loadNoEarningsText } from "./no-earnings";
19
20
  import { EPS_BASIS_NOTE, epsBasisName, PROVISIONAL_NOTE, showsEpsBasis } from "../shared/earnings-report";
20
21
  import { isUsListingExchange } from "../../../utils/exchanges";
@@ -52,6 +53,12 @@ const BOARD_COLUMNS: HeadlessPaneColumn[] = [
52
53
  { key: "averageMove", header: "Avg move", align: right, format: (value) => moveSize(num(value)) },
53
54
  ];
54
55
 
56
+ /** What an ERN <ticker> report's quarter is, in its metadata. */
57
+ const FISCAL_QUARTER_NOTE = "fiscalQuarter is the quarter as the company names it (Q3 FY2027), from its earnings calls on record; fiscalPeriod is the month the quarter ended. A company whose calls do not name its quarters has fiscalQuarter null.";
58
+
59
+ /** When an upcoming report has an implied move, in an ERN <ticker> report's metadata. */
60
+ const IMPLIED_NOTE = "An upcoming report's implied move is read from its options' prices from 8 days before the report, for companies worth $2 billion or more. Before then, or for a smaller company, impliedMove is null: it is never estimated.";
61
+
55
62
  /** Where the board's caps come from and how old they can be, in its metadata. */
56
63
  const MARKET_CAP_NOTE = "Each company's market cap as RV shows it: its latest financials snapshot at the regular session's price (the close outside the session), from the newest quote Gloom Cloud holds for it. A company with no snapshot shows the earnings calendar's figure.";
57
64
 
@@ -59,7 +66,8 @@ const HISTORY_COLUMNS: HeadlessPaneColumn[] = [
59
66
  { key: "date", header: "Date" },
60
67
  { key: "dateStatus", header: "Status" },
61
68
  { key: "timing", header: "When" },
62
- { key: "fiscalPeriod", header: "Quarter" },
69
+ // The quarter as the company names it; its end month where the company's calls do not say. Exports keep both.
70
+ { key: "fiscalQuarter", header: "Quarter", format: (value, row) => typeof value === "string" ? value : typeof row.fiscalPeriod === "string" ? row.fiscalPeriod : "-" },
63
71
  { key: "epsEstimate", header: "EPS est", align: right, format: (value) => epsText(num(value)) },
64
72
  { key: "epsAnalysts", header: "Ests", align: right },
65
73
  { key: "epsActual", header: "EPS act", align: right, format: (value) => epsText(num(value)) },
@@ -73,6 +81,20 @@ const HISTORY_COLUMNS: HeadlessPaneColumn[] = [
73
81
  { key: "move", header: "Move", align: right, format: (value) => signedPercent(num(value)) },
74
82
  ];
75
83
 
84
+ /** A Hong Kong listing's report: what its figures cover, their currency and its results announcement; no options or moves are read for it. */
85
+ const LISTING_HISTORY_COLUMNS: HeadlessPaneColumn[] = [
86
+ { key: "date", header: "Date" },
87
+ { key: "dateStatus", header: "Status" },
88
+ { key: "timing", header: "When" },
89
+ { key: "period", header: "Period" },
90
+ { key: "currency", header: "Ccy" },
91
+ ...HISTORY_COLUMNS.filter((column) => ["epsEstimate", "epsAnalysts", "epsActual", "epsBasis", "epsSurprise", "revenueEstimate", "revenueActual", "revenueSurprise"].includes(column.key)),
92
+ { key: "filing", header: "Filing" },
93
+ ];
94
+
95
+ /** What a Hong Kong listing's ERN report's period, currency and filing are, in its metadata. */
96
+ const LISTING_PERIOD_NOTE = "period is what the figures cover: a quarter (Q3 FY2026, or its end month), a half (H1 FY2026), a year (FY2025) or a year to date (9M FY2026), a fiscal year named by the calendar year it ends in. A half-yearly reporter's half is never a quarter. currency is the ISO currency of every amount on the row, estimates included. EPS estimates and actuals are the street's quarter figures, compared only in one currency and on one basis; a period the street has no quarter for shows the company's reported EPS and revenue from its results announcement (filing) with no estimate, its EPS diluted (basis GAAP) where the filing gives one, else basic (basis basic). The announcements' figures and links come with Gloom Pro, as KPIS has them; the street's quarters are everyone's.";
97
+
76
98
  interface EarningsHeadlessDependencies {
77
99
  calendar(query: { from: string; to: string; perDay: number; symbols: string[] }, context: HeadlessPaneContext): Promise<EarningsCalendarPayload>;
78
100
  history(symbol: string, context: HeadlessPaneContext): Promise<EarningsHistoryPayload>;
@@ -206,20 +228,24 @@ async function boardRows(args: HeadlessPaneLoadArgs, context: HeadlessPaneContex
206
228
 
207
229
  /**
208
230
  * What ERN says for a listing abroad, whose next report is its own but whose
209
- * past reports, surprises and implied moves only the US board has: that, and
210
- * the company's US listing to read them on (Sanofi's SNY for SAN:EPA).
231
+ * past reports, surprises and implied moves only the US board and Hong Kong's
232
+ * results announcements have: that, and the company's US listing to read
233
+ * them on (Sanofi's SNY for SAN:EPA).
211
234
  */
212
235
  async function abroadHistoryNotice(symbol: string, company: string | null, context: HeadlessPaneContext): Promise<string> {
213
- const lead = `Past reports, surprises and implied moves cover US listings only, so ${symbol} shows its next report.`;
236
+ const lead = `Past reports, surprises and implied moves cover US and Hong Kong listings only, so ${symbol} shows its next report.`;
214
237
  const us = await findUsListingOfCompany(context.marketData, company);
215
238
  return us ? `${lead} ${shortCompanyName(company!)}'s US listing is ${us.symbol}: ERN ${us.symbol} has them.` : lead;
216
239
  }
217
240
 
218
241
  async function historyReport(symbol: string, context: HeadlessPaneContext, deps: EarningsHeadlessDependencies): Promise<HeadlessRowsResult> {
219
242
  // The board is US listings'; SAN:EPA's past reports are not on it, and bare SAN there is another company.
220
- const abroad = listingAbroadVenue(symbol) != null;
243
+ // A Hong Kong listing has its own, from its results announcements.
244
+ const venueAbroad = listingAbroadVenue(symbol);
245
+ const abroad = !hasEarningsHistory(venueAbroad);
246
+ const ownAbroad = venueAbroad != null && !abroad;
221
247
  const [history, upcoming] = await Promise.allSettled([
222
- abroad ? Promise.resolve(null) : deps.history(symbol, context),
248
+ abroad ? Promise.resolve(null) : ownAbroad ? deps.history(symbol, context).catch(noHistoryAbroad) : deps.history(symbol, context),
223
249
  deps.upcoming([symbol], context),
224
250
  ]);
225
251
  if (history.status === "rejected" && upcoming.status === "rejected") throw history.reason;
@@ -228,18 +254,26 @@ async function historyReport(symbol: string, context: HeadlessPaneContext, deps:
228
254
  const notice = abroad
229
255
  ? await abroadHistoryNotice(symbol, next?.name ?? await context.marketData.getQuote(symbol, "").then((quote) => quote.name ?? null, logFailure("earnings.headless", "Load earnings company name failed", null)), context)
230
256
  : null;
231
- const rows = historyRows(payload, newYorkToday(), next).map((row) => ({
257
+ const rows = historyRows(payload, newYorkToday(), next, { abroad: ownAbroad }).map((row) => ({
232
258
  date: row.date,
233
259
  upcoming: row.upcoming,
234
260
  dateStatus: row.dateStatus,
235
261
  timing: row.timing ? TIMING_LABEL[row.timing] : null,
236
262
  timingExpected: row.expectedTiming,
237
263
  fiscalPeriod: row.fiscalPeriod,
264
+ fiscalQuarter: fiscalQuarterText(row.fiscalQuarter),
265
+ ...(ownAbroad ? {
266
+ period: periodText(row, false),
267
+ periodKind: row.periodKind,
268
+ periodMonths: row.periodMonths,
269
+ currency: row.currency,
270
+ filing: row.filingUrl,
271
+ } : {}),
238
272
  epsEstimate: row.epsEstimate,
239
273
  epsAnalysts: row.epsAnalysts,
240
274
  epsActual: row.epsActual,
241
275
  epsActualProvisional: row.provisional,
242
- epsBasis: showsEpsBasis(row) ? epsBasisName(row.epsBasis) : null,
276
+ epsBasis: !showsEpsBasis(row) ? null : !row.epsBasis && row.epsDilution === "basic" ? "basic" : epsBasisName(row.epsBasis),
243
277
  epsSurprise: row.epsSurprise,
244
278
  revenueEstimate: row.revenueEstimate,
245
279
  revenueActual: row.revenueActual,
@@ -253,7 +287,7 @@ async function historyReport(symbol: string, context: HeadlessPaneContext, deps:
253
287
  // and a history that failed for one (a coin is no US ticker) is no error.
254
288
  const noEarnings = rows.length === 0 && !abroad ? await loadNoEarningsText(context.marketData, symbol, "cli") : null;
255
289
  return {
256
- columns: HISTORY_COLUMNS,
290
+ columns: ownAbroad ? LISTING_HISTORY_COLUMNS : HISTORY_COLUMNS,
257
291
  rows,
258
292
  ...(noEarnings ? { empty: noEarnings, complete: true, unavailableSymbols: [] } : {}),
259
293
  errors: history.status === "rejected" && !noEarnings ? [String(history.reason instanceof Error ? history.reason.message : history.reason)] : undefined,
@@ -261,6 +295,8 @@ async function historyReport(symbol: string, context: HeadlessPaneContext, deps:
261
295
  symbol, name: payload?.name ?? next?.name ?? null, asOf: payload?.asOf ?? null,
262
296
  epsBasis: EPS_BASIS_NOTE,
263
297
  provisional: PROVISIONAL_NOTE,
298
+ fiscalQuarter: FISCAL_QUARTER_NOTE,
299
+ ...(ownAbroad ? { period: LISTING_PERIOD_NOTE } : { impliedMove: IMPLIED_NOTE }),
264
300
  ...(notice ? { notices: [notice] } : {}),
265
301
  },
266
302
  };
@@ -1,4 +1,4 @@
1
- import type { EarningsHistoryPayload, EarningsTiming } from "../../../api-client/earnings";
1
+ import type { EarningsHistoryPayload, EarningsPeriodKind, EarningsTiming } from "../../../api-client/earnings";
2
2
  import type { StatItem } from "../../../components";
3
3
  import { scalarPoint } from "../../../components/chart/static/series";
4
4
  import type { TimeSeriesPoint } from "../../../time-series/types";
@@ -7,7 +7,8 @@ import type { EarningsDateStatus, EarningsEpsBasis } from "../../../types/financ
7
7
  import { earningsDateStatus, earningsEpsBasis, isProvisionalActual } from "../shared/earnings-report";
8
8
  import { resolveReportRows, type ReportRowAdapter } from "../shared/earnings-calendar";
9
9
  import { addDays, MIN_AVERAGE_REPORTS } from "./board-model";
10
- import { datedYear, impliedText, moveSize, shortDate, surprise, TIMING_LABEL } from "./format";
10
+ import { fiscalQuarterOf, fiscalQuarterText, placedPeriod, type FiscalQuarter } from "./fiscal-quarter";
11
+ import { datedYear, fiscalMonth, impliedText, moveSize, shortDate, surprise, TIMING_LABEL } from "./format";
11
12
 
12
13
  export interface HistoryRow {
13
14
  key: string;
@@ -15,6 +16,18 @@ export interface HistoryRow {
15
16
  timing: EarningsTiming | null;
16
17
  expectedTiming: boolean;
17
18
  fiscalPeriod: string | null;
19
+ /** The quarter as the company names it (Q3 FY2027), null when its calls do not say. */
20
+ fiscalQuarter: FiscalQuarter | null;
21
+ /** What the figures cover: a quarter, or a listing abroad's half, year or year to date. */
22
+ periodKind: EarningsPeriodKind;
23
+ periodMonths: number;
24
+ /** A half's, year's or year to date's fiscal year (named by the calendar year it ends in) and a half's number; null for a quarter. */
25
+ periodFiscalYear: number | null;
26
+ fiscalHalf: number | null;
27
+ /** ISO currency of every amount on the row, a listing abroad's; null for a US listing's dollars. */
28
+ currency: string | null;
29
+ /** The results announcement the figures were read from, a listing abroad's. */
30
+ filingUrl: string | null;
18
31
  upcoming: boolean;
19
32
  /** Whether the date is out, announced or projected; null when the source does not say. */
20
33
  dateStatus: EarningsDateStatus | null;
@@ -26,6 +39,8 @@ export interface HistoryRow {
26
39
  provisional: boolean;
27
40
  /** Null when the reported figure's basis cannot be determined. */
28
41
  epsBasis: EarningsEpsBasis | null;
42
+ /** A listing abroad's filed EPS that is basic: not the statements' diluted figure, so it has no basis and says so. */
43
+ epsDilution: "diluted" | "basic" | null;
29
44
  epsSurprise: number | null;
30
45
  revenueEstimate: number | null;
31
46
  revenueActual: number | null;
@@ -41,41 +56,96 @@ export interface HistoryRow {
41
56
  moveRatio: number | null;
42
57
  }
43
58
 
59
+ /**
60
+ * A row's period: the quarter as the company names it (Q3 FY27) or by its
61
+ * end month (Sep '26); a listing abroad's half, year or year to date by its
62
+ * fiscal year (H1 FY26, FY25, 9M FY26), or by its months and end month where
63
+ * its year end is not known (6M Jun '26). `short` years fit a table column.
64
+ */
65
+ export function periodText(
66
+ row: Pick<HistoryRow, "periodKind" | "periodMonths" | "periodFiscalYear" | "fiscalHalf" | "fiscalQuarter" | "fiscalPeriod">,
67
+ short = true,
68
+ ): string {
69
+ if (row.periodKind === "quarter") return fiscalQuarterText(row.fiscalQuarter, short) ?? fiscalMonth(row.fiscalPeriod);
70
+ const year = row.periodFiscalYear == null ? null : `FY${short ? String(row.periodFiscalYear).slice(-2) : row.periodFiscalYear}`;
71
+ if (row.periodKind === "year" && year) return year;
72
+ if (row.periodKind === "half" && year && row.fiscalHalf != null) return `H${row.fiscalHalf} ${year}`;
73
+ return `${row.periodMonths}M ${row.periodKind === "ytd" && year ? year : fiscalMonth(row.fiscalPeriod)}`;
74
+ }
75
+
44
76
  /** Past quarters shown, beside the upcoming report. */
45
77
  const HISTORY_QUARTERS = 12;
46
78
  const AVERAGE_OVER = 8;
47
79
 
48
- /** A report today stays upcoming until its first close after the report prices a move. */
49
- const isUpcoming = (date: string, move: number | null, today: string) => date >= today && move == null;
80
+ /**
81
+ * A report today stays upcoming until its first close after the report
82
+ * prices a move; a listing abroad's moves are not priced, so it is upcoming
83
+ * until it is out.
84
+ */
85
+ const isUpcoming = (row: { date: string; move: number | null; dateStatus?: EarningsDateStatus | null; epsActual?: number | null }, today: string, abroad: boolean) =>
86
+ row.date >= today && row.move == null && (!abroad || (row.dateStatus !== "reported" && row.epsActual == null));
87
+
88
+ const PERIOD_KINDS: ReadonlySet<string> = new Set<EarningsPeriodKind>(["quarter", "half", "ytd", "year"]);
89
+ const PERIOD_MONTHS: Record<EarningsPeriodKind, number | null> = { quarter: 3, half: 6, year: 12, ytd: null };
90
+
91
+ /** A report's period as the server names it; absent is a quarter, anything unknown cannot be labelled and is null. */
92
+ function reportPeriod(report: { periodKind?: unknown; periodMonths?: unknown }): { kind: EarningsPeriodKind; months: number } | null {
93
+ if (report.periodKind == null) return { kind: "quarter", months: 3 };
94
+ if (typeof report.periodKind !== "string" || !PERIOD_KINDS.has(report.periodKind)) return null;
95
+ const kind = report.periodKind as EarningsPeriodKind;
96
+ const months = PERIOD_MONTHS[kind] ?? (typeof report.periodMonths === "number" && Number.isInteger(report.periodMonths) ? report.periodMonths : null);
97
+ return months && months > 0 && months <= 12 ? { kind, months } : null;
98
+ }
99
+
100
+ const isoCurrency = (value: unknown) => (typeof value === "string" && /^[A-Z]{3}$/.test(value) ? value : null);
101
+ const wholeOrNull = (value: unknown) => (typeof value === "number" && Number.isInteger(value) ? value : null);
50
102
 
51
103
  /** ERN's rows as the shared calendar resolver reads and rebuilds them. */
52
- const historyAdapter = (today: string): ReportRowAdapter<HistoryRow> => ({
104
+ const historyAdapter = (today: string, abroad: boolean): ReportRowAdapter<HistoryRow> => ({
53
105
  slot: (row) => ({ date: row.date, dateStatus: row.dateStatus, epsActual: row.epsActual }),
54
- reported: (row, epsActual) => {
55
- const actual = row.epsActual ?? epsActual;
106
+ reported: (row, epsActual, report) => {
107
+ // A listing abroad's row takes the calendar's figure only as a quarter's, in the currency its own figures are in.
108
+ const fits = !abroad || (row.periodKind === "quarter" && row.currency != null && report?.currency === row.currency);
109
+ const actual = row.epsActual ?? (fits ? epsActual : null);
56
110
  return { ...row, dateStatus: "reported", epsActual: actual, epsSurprise: surprise(actual, row.epsEstimate) };
57
111
  },
58
112
  fromCalendar(report, row) {
59
- // The calendar's consensus goes with its date; without one, the record's stays.
60
- const estimate = report.epsEstimate != null;
113
+ // A listing abroad's consensus goes with its date only in the currency its figures are in: an unlabelled figure would read as dollars.
114
+ // The calendar's figures are a quarter's: a half's or a year's row keeps its own.
115
+ const currency = abroad ? row?.currency ?? report.currency : null;
116
+ const quarter = !row || row.periodKind === "quarter";
117
+ const inCurrency = !abroad || (report.currency != null && report.currency === currency);
118
+ const estimate = report.epsEstimate != null && quarter && inCurrency;
61
119
  const epsEstimate = estimate ? report.epsEstimate : row?.epsEstimate ?? null;
62
- const epsActual = report.epsActual ?? row?.epsActual ?? null;
120
+ const epsActual = (quarter && inCurrency ? report.epsActual : null) ?? row?.epsActual ?? null;
63
121
  const move = row?.move ?? null;
122
+ const dateStatus = report.dateStatus;
123
+ const revenueEstimate = quarter && (!abroad || (report.revenueCurrency != null && report.revenueCurrency === currency)) ? report.revenueEstimate : null;
64
124
  return {
65
125
  key: report.date,
66
126
  date: report.date,
67
- timing: report.timing ?? row?.timing ?? null,
68
- expectedTiming: report.timing == null && !!row?.expectedTiming,
127
+ // The calendar's pre-market and after-hours are New York's, not a listing abroad's session.
128
+ timing: (abroad ? null : report.timing) ?? row?.timing ?? null,
129
+ expectedTiming: (abroad || report.timing == null) && !!row?.expectedTiming,
69
130
  fiscalPeriod: row?.fiscalPeriod ?? report.fiscalPeriod,
70
- upcoming: isUpcoming(report.date, move, today),
71
- dateStatus: report.dateStatus,
131
+ fiscalQuarter: row?.fiscalQuarter ?? null,
132
+ periodKind: row?.periodKind ?? "quarter",
133
+ periodMonths: row?.periodMonths ?? 3,
134
+ periodFiscalYear: row?.periodFiscalYear ?? null,
135
+ fiscalHalf: row?.fiscalHalf ?? null,
136
+ currency,
137
+ filingUrl: row?.filingUrl ?? null,
138
+ upcoming: isUpcoming({ date: report.date, move, dateStatus, epsActual }, today, abroad),
139
+ dateStatus,
72
140
  epsEstimate,
73
141
  epsAnalysts: estimate ? report.epsAnalysts : row?.epsAnalysts ?? null,
74
142
  epsActual,
75
143
  provisional: row?.provisional ?? false,
76
- epsBasis: estimate ? report.epsBasis : row?.epsBasis ?? null,
144
+ // The consensus's basis is the company's (Gloom Cloud names it from the reports it was measured against).
145
+ epsBasis: estimate ? report.epsBasis ?? row?.epsBasis ?? null : row?.epsBasis ?? null,
146
+ epsDilution: row?.epsDilution ?? null,
77
147
  epsSurprise: surprise(epsActual, epsEstimate),
78
- revenueEstimate: report.revenueEstimate ?? row?.revenueEstimate ?? null,
148
+ revenueEstimate: revenueEstimate ?? row?.revenueEstimate ?? null,
79
149
  revenueActual: row?.revenueActual ?? null,
80
150
  revenueProvisional: row?.revenueProvisional ?? false,
81
151
  revenueSurprise: row?.revenueSurprise ?? null,
@@ -94,23 +164,46 @@ const historyAdapter = (today: string): ReportRowAdapter<HistoryRow> => ({
94
164
  * (shared/earnings-calendar): a confirmed date beats a projected one, a date
95
165
  * gone by is reported, and a date past the stored calendar's horizon is added.
96
166
  */
97
- export function historyRows(payload: EarningsHistoryPayload | null, today: string, upcoming: EarningsEvent | null): HistoryRow[] {
98
- const recorded: HistoryRow[] = (payload?.reports ?? []).map((report) => {
167
+ export function historyRows(
168
+ payload: EarningsHistoryPayload | null,
169
+ today: string,
170
+ upcoming: EarningsEvent | null,
171
+ /** A listing abroad (Hong Kong's): every amount is labelled with its currency, and no move is priced. */
172
+ options: { abroad?: boolean } = {},
173
+ ): HistoryRow[] {
174
+ const abroad = options.abroad === true;
175
+ const recorded: HistoryRow[] = (payload?.reports ?? []).flatMap((report) => {
176
+ const period = reportPeriod(report);
177
+ // A listing abroad's amount with no currency could be any: it is not shown.
178
+ const currency = abroad ? isoCurrency(report.currency) : null;
179
+ if (!period || (abroad && !currency)) return [];
99
180
  const move = report.realized?.move ?? null;
100
181
  const implied = report.implied?.move ?? null;
101
- return {
102
- key: report.date,
182
+ const dateStatus = earningsDateStatus(report.dateStatus);
183
+ const quarter = period.kind === "quarter";
184
+ return [{
185
+ // A listing abroad's half and quarter can share a day.
186
+ key: quarter ? report.date : `${report.date}:${period.kind}`,
103
187
  date: report.date,
104
188
  timing: report.timing,
105
189
  expectedTiming: report.timingSource === "history",
106
190
  fiscalPeriod: report.fiscalPeriod,
107
- upcoming: isUpcoming(report.date, move, today),
108
- dateStatus: earningsDateStatus(report.dateStatus),
191
+ fiscalQuarter: quarter && report.fiscalYear != null && report.fiscalQuarter != null
192
+ ? { fiscalYear: report.fiscalYear, fiscalQuarter: report.fiscalQuarter } : null,
193
+ periodKind: period.kind,
194
+ periodMonths: period.months,
195
+ periodFiscalYear: quarter ? null : wholeOrNull(report.fiscalYear),
196
+ fiscalHalf: period.kind === "half" ? wholeOrNull(report.fiscalHalf) : null,
197
+ currency,
198
+ filingUrl: abroad && typeof report.filing?.url === "string" ? report.filing.url : null,
199
+ upcoming: isUpcoming({ date: report.date, move, dateStatus, epsActual: report.epsActual }, today, abroad),
200
+ dateStatus,
109
201
  epsEstimate: report.epsEstimate,
110
202
  epsAnalysts: report.epsAnalysts,
111
203
  epsActual: report.epsActual,
112
204
  provisional: isProvisionalActual(report),
113
205
  epsBasis: earningsEpsBasis(report.epsBasis),
206
+ epsDilution: abroad && report.epsDilution === "basic" ? "basic" : null,
114
207
  epsSurprise: surprise(report.epsActual, report.epsEstimate),
115
208
  revenueEstimate: report.revenueEstimate,
116
209
  revenueActual: report.revenueActual,
@@ -121,14 +214,33 @@ export function historyRows(payload: EarningsHistoryPayload | null, today: strin
121
214
  impliedExpiry: report.implied?.expiry ?? null,
122
215
  move,
123
216
  moveRatio: move != null && implied ? Math.abs(move) / implied : null,
124
- };
217
+ }];
125
218
  });
126
- const rows = resolveReportRows(recorded, upcoming, today, historyAdapter(today))
219
+ const anchor = payload?.fiscalAnchor ?? null;
220
+ const basis = earningsEpsBasis(payload?.consensusBasis);
221
+ const rows = resolveReportRows(recorded, upcoming, today, historyAdapter(today, abroad))
222
+ // The calendar's next report past the stored horizon is on the basis the company's reports were measured on.
223
+ .map((row) => (basis && row.upcoming && row.epsEstimate != null && row.epsBasis == null ? { ...row, epsBasis: basis } : row))
224
+ .map((row) => withFiscalQuarter(row, anchor))
127
225
  .sort((left, right) => right.date.localeCompare(left.date));
128
226
  const upcomingRows = rows.filter((row) => row.upcoming).slice(-1);
129
227
  return [...upcomingRows, ...rows.filter((row) => !row.upcoming).slice(0, HISTORY_QUARTERS)];
130
228
  }
131
229
 
230
+ /**
231
+ * A row with the quarter the company names it, on the calendar its calls
232
+ * give: the calendar's next report, past the stored horizon, has none of its
233
+ * own, and one with no quarter-end month either is placed as Gloom Cloud
234
+ * places its own (the last on the company's cycle 5 to 100 days before it).
235
+ */
236
+ function withFiscalQuarter(row: HistoryRow, anchor: EarningsHistoryPayload["fiscalAnchor"]): HistoryRow {
237
+ // A half's or year's end month is no quarter's: H1 is not Q2.
238
+ if (row.fiscalQuarter || !anchor || row.periodKind !== "quarter") return row;
239
+ const fiscalPeriod = row.fiscalPeriod ?? (row.upcoming ? placedPeriod(row.date, anchor) : null);
240
+ const fiscalQuarter = fiscalQuarterOf(fiscalPeriod, anchor);
241
+ return fiscalQuarter ? { ...row, fiscalPeriod, fiscalQuarter } : row;
242
+ }
243
+
132
244
  function mean(values: readonly number[]): number | null {
133
245
  return values.length ? values.reduce((sum, value) => sum + value, 0) / values.length : null;
134
246
  }
@@ -2,9 +2,9 @@ import type { DataTableCell, DataTableColumn } from "../../../components";
2
2
  import { TABLE_COLUMN_GAP, tableColumnWidth } from "../../../components/ui/table-layout";
3
3
  import { colors } from "../../../theme/colors";
4
4
  import { TextAttributes } from "../../../ui";
5
- import { datedYear, epsText, fiscalMonth, impliedText, moneyText, signedPercent, TIMING_LABEL } from "./format";
5
+ import { datedYear, epsText, impliedText, moneyText, signedPercent, TIMING_LABEL } from "./format";
6
6
  import { epsBasisShort, showsEpsBasis } from "../shared/earnings-report";
7
- import type { HistoryRow } from "./history-model";
7
+ import { periodText, type HistoryRow } from "./history-model";
8
8
 
9
9
  type HistoryColumnId =
10
10
  | "date" | "when" | "period" | "epsEstimate" | "analysts" | "epsActual" | "basis" | "epsSurprise"
@@ -41,10 +41,39 @@ const SALES_COLUMNS: Partial<Record<HistoryColumnId, (row: HistoryRow) => number
41
41
  revenueSurprise: (row) => row.revenueSurprise,
42
42
  };
43
43
 
44
- export function historyColumns(width: number, rows: readonly HistoryRow[]): HistoryColumn[] {
44
+ /** What fills the move columns: a listing abroad has no options or moves read, so it shows none of them. */
45
+ const MOVE_COLUMNS: Partial<Record<HistoryColumnId, (row: HistoryRow) => number | null>> = {
46
+ implied: (row) => row.implied,
47
+ move: (row) => row.move,
48
+ ratio: (row) => row.moveRatio,
49
+ };
50
+
51
+ /** Amount columns that carry a listing abroad's currency after each figure ("7.22 CNY"), and the room it takes. */
52
+ const AMOUNT_COLUMNS: ReadonlySet<HistoryColumnId> = new Set(["epsEstimate", "epsActual", "revenueEstimate", "revenueActual"]);
53
+ const CURRENCY_WIDTH = 4;
54
+
55
+ /** A listing abroad's figure with its currency; a US listing's dollars stay bare. */
56
+ const inCurrency = (text: string, row: HistoryRow) => (row.currency && text !== "--" ? `${text} ${row.currency}` : text);
57
+
58
+ /**
59
+ * The columns that fit `width`. A listing abroad's (`abroad`, Hong Kong's)
60
+ * read the same whatever its rows hold: PERIOD, since its rows may be halves
61
+ * or years, a currency after every amount, and no move columns.
62
+ */
63
+ export function historyColumns(width: number, rows: readonly HistoryRow[], options: { abroad?: boolean } = {}): HistoryColumn[] {
64
+ const abroad = options.abroad === true;
65
+ const labelled = abroad || rows.some((row) => row.currency != null);
66
+ const periods = abroad || rows.some((row) => row.periodKind !== "quarter");
45
67
  let columns = ALL_COLUMNS.filter((column) => {
46
- const value = SALES_COLUMNS[column.id];
68
+ const value = SALES_COLUMNS[column.id] ?? (labelled ? MOVE_COLUMNS[column.id] : undefined);
47
69
  return !value || rows.some((row) => value(row) != null);
70
+ }).map((column): HistoryColumn => {
71
+ if (labelled && AMOUNT_COLUMNS.has(column.id)) return { ...column, width: column.width + CURRENCY_WIDTH };
72
+ // A half or a year is no quarter: the column names what it holds.
73
+ if (periods && column.id === "period") {
74
+ return { ...column, label: "PERIOD", width: Math.max(column.width, "PERIOD".length, ...rows.map((row) => periodText(row).length)) };
75
+ }
76
+ return column;
48
77
  });
49
78
  const used = (list: HistoryColumn[]) => list.reduce((sum, column) => sum + tableColumnWidth(column) + TABLE_COLUMN_GAP, 2);
50
79
  for (const id of DROP_ORDER) {
@@ -73,24 +102,27 @@ export function renderHistoryCell(row: HistoryRow, column: HistoryColumn, liveMo
73
102
  case "when":
74
103
  return { text: row.timing ? TIMING_LABEL[row.timing] : "--", color: row.expectedTiming ? colors.textMuted : dim };
75
104
  case "period":
76
- return { text: fiscalMonth(row.fiscalPeriod), color: dim };
105
+ return { text: periodText(row), color: dim };
77
106
  case "epsEstimate":
78
- return { text: epsText(row.epsEstimate), color: dim };
107
+ return { text: inCurrency(epsText(row.epsEstimate), row), color: dim };
79
108
  case "analysts":
80
109
  return { text: row.epsAnalysts == null ? "--" : String(row.epsAnalysts), color: dim };
81
110
  case "epsActual":
82
111
  // The company's press release's figure reads quieter until the calendar's replaces it.
83
- return { text: epsText(row.epsActual), color: row.provisional ? colors.textMuted : colors.text };
112
+ return { text: inCurrency(epsText(row.epsActual), row), color: row.provisional ? colors.textMuted : colors.text };
84
113
  case "basis":
114
+ // A listing abroad's basic EPS is not the statements' diluted figure: it says what it is.
85
115
  return !showsEpsBasis(row)
86
116
  ? { text: "--", color: dim }
87
- : { text: epsBasisShort(row.epsBasis), color: row.epsBasis ? colors.textMuted : dim };
117
+ : !row.epsBasis && row.epsDilution === "basic"
118
+ ? { text: "basic", color: colors.textMuted }
119
+ : { text: epsBasisShort(row.epsBasis), color: row.epsBasis ? colors.textMuted : dim };
88
120
  case "epsSurprise":
89
121
  return signed(row.epsSurprise);
90
122
  case "revenueEstimate":
91
- return { text: moneyText(row.revenueEstimate), color: dim };
123
+ return { text: inCurrency(moneyText(row.revenueEstimate), row), color: dim };
92
124
  case "revenueActual":
93
- return { text: moneyText(row.revenueActual), color: row.revenueProvisional ? colors.textMuted : colors.text };
125
+ return { text: inCurrency(moneyText(row.revenueActual), row), color: row.revenueProvisional ? colors.textMuted : colors.text };
94
126
  case "revenueSurprise":
95
127
  return signed(row.revenueSurprise);
96
128
  case "implied":