gloomberb 0.20.1 → 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 (422) hide show
  1. package/README.md +16 -26
  2. package/README.zh-CN.md +21 -65
  3. package/package.json +1 -1
  4. package/src/account/auth-model.ts +20 -1
  5. package/src/account/upgrade-dialog.tsx +8 -4
  6. package/src/api-client/askg.ts +7 -1
  7. package/src/api-client/auth.ts +27 -0
  8. package/src/api-client/catalysts.ts +2 -0
  9. package/src/api-client/company-kpis.ts +2 -1
  10. package/src/api-client/cot.ts +14 -2
  11. package/src/api-client/data.ts +3 -2
  12. package/src/api-client/earnings.ts +46 -3
  13. package/src/api-client/futures-curve.ts +17 -0
  14. package/src/api-client/index.ts +4 -1
  15. package/src/api-client/one-tap-reasons.ts +42 -0
  16. package/src/api-client/perps.ts +2 -1
  17. package/src/api-client/request.ts +3 -1
  18. package/src/api-client/research-activity.ts +16 -3
  19. package/src/api-client/types/filings-and-calls.ts +3 -0
  20. package/src/api-client/types/search.ts +3 -0
  21. package/src/app/keybindings/chord.ts +153 -9
  22. package/src/app/keybindings/index.ts +1 -1
  23. package/src/app/keybindings/labels.ts +49 -6
  24. package/src/app/runtime/desktop-deeplink.ts +73 -8
  25. package/src/app.tsx +7 -1
  26. package/src/architecture/core-builtin-allowlist.json +1 -2
  27. package/src/architecture/pane-tabs-allowlist.json +2 -1
  28. package/src/architecture/shortcut-labels-allowlist.json +11 -0
  29. package/src/architecture/ui-literals-allowlist.json +8 -8
  30. package/src/brokers/broker-portfolio-sync.ts +1 -1
  31. package/src/cli/bank-section.ts +26 -12
  32. package/src/cli/commands/market.ts +266 -75
  33. package/src/cli/commands/ticker.ts +12 -7
  34. package/src/cli/desktop-pane-shot-browser.ts +47 -31
  35. package/src/cli/desktop-pane-shot.ts +15 -0
  36. package/src/cli/entry.ts +5 -0
  37. package/src/cli/export-source.ts +7 -1
  38. package/src/cli/freshness.ts +0 -16
  39. package/src/cli/fx-pair.ts +64 -12
  40. package/src/cli/fx-quote-rate.ts +144 -0
  41. package/src/cli/glossary.ts +5 -0
  42. package/src/cli/history-back-adjust.ts +122 -0
  43. package/src/cli/history-rows.ts +114 -10
  44. package/src/cli/index.ts +4 -1
  45. package/src/cli/known-gaps.ts +45 -3
  46. package/src/cli/listing-arg.ts +48 -4
  47. package/src/cli/name-entries.ts +25 -5
  48. package/src/cli/pane-functions/catalog.ts +12 -2
  49. package/src/cli/pane-functions/dom.ts +4 -2
  50. package/src/cli/pane-functions/headless.ts +8 -5
  51. package/src/cli/pane-functions/index.ts +3 -0
  52. package/src/cli/pane-functions/resolver.ts +4 -1
  53. package/src/cli/pane-functions/screenshot-assessment.ts +15 -3
  54. package/src/cli/pane-functions/screenshot-payload.ts +130 -66
  55. package/src/cli/pane-functions/screenshot-render.ts +14 -2
  56. package/src/cli/pane-functions/screenshot-types.ts +4 -0
  57. package/src/cli/symbol-rows.ts +22 -2
  58. package/src/cli/ticker-resolution.ts +74 -17
  59. package/src/components/chart/composite/axis-overlays.tsx +13 -3
  60. package/src/components/chart/composite/composite-chart.tsx +8 -1
  61. package/src/components/chart/composite/format.ts +16 -1
  62. package/src/components/chart/composite/legend.tsx +4 -3
  63. package/src/components/chart/composite/panel-labels.ts +2 -1
  64. package/src/components/chart/composite/panel-surface.tsx +33 -4
  65. package/src/components/chart/composite/time-scale.ts +1 -1
  66. package/src/components/chart/composite/toolbar.tsx +8 -4
  67. package/src/components/chart/composite/types.ts +17 -1
  68. package/src/components/chart/composite/use-composite-chart-keyboard.ts +15 -5
  69. package/src/components/chart/composite/use-composite-viewport.ts +31 -8
  70. package/src/components/chart/static/scatter-chart-surface.tsx +25 -9
  71. package/src/components/chart-table/axis.ts +11 -0
  72. package/src/components/command-bar/assist/inventory.ts +3 -2
  73. package/src/components/command-bar/commands/collection-list.ts +3 -2
  74. package/src/components/command-bar/panel/layout.ts +8 -1
  75. package/src/components/command-bar/panel/prompt-width.ts +34 -0
  76. package/src/components/command-bar/panel/state.ts +4 -0
  77. package/src/components/command-bar/routes/root/search-providers.ts +3 -2
  78. package/src/components/command-bar/routes/root/search-report.ts +2 -2
  79. package/src/components/command-bar/workflow/ticker-listing-picker.ts +1 -0
  80. package/src/components/company-logo.tsx +2 -2
  81. package/src/components/data-table/view.tsx +11 -2
  82. package/src/components/feed-data-table/stack-view.tsx +20 -6
  83. package/src/components/feedback-dialog.tsx +3 -1
  84. package/src/components/form-modal/field-row.tsx +1 -1
  85. package/src/components/form-modal/routes.ts +1 -0
  86. package/src/components/index.ts +1 -1
  87. package/src/components/layout/header.tsx +12 -3
  88. package/src/components/layout/market-summary.ts +2 -1
  89. package/src/components/layout/pane/footer/index.tsx +9 -5
  90. package/src/components/layout/pane/footer/model.ts +26 -10
  91. package/src/components/layout/pane/footer/registration.tsx +60 -1
  92. package/src/components/layout/pane/header-tabs.tsx +17 -3
  93. package/src/components/layout/pane/header.tsx +5 -2
  94. package/src/components/layout/pane/pane-tabs.tsx +57 -3
  95. package/src/components/layout/shell/active-drag.ts +38 -30
  96. package/src/components/layout/shell/drag/index.ts +51 -21
  97. package/src/components/layout/shell/menu.ts +3 -5
  98. package/src/components/layout/shell/pane/actions.ts +4 -1
  99. package/src/components/layout/shell/pane/ask.ts +5 -2
  100. package/src/components/layout/status-bar.tsx +59 -54
  101. package/src/components/markdown-text.tsx +35 -10
  102. package/src/components/onboarding/first-run-workspace.ts +25 -23
  103. package/src/components/onboarding/onboarding-keyboard.ts +6 -1
  104. package/src/components/onboarding/onboarding-wizard.tsx +12 -2
  105. package/src/components/onboarding/portfolio-step/positions-panel.tsx +3 -3
  106. package/src/components/onboarding/use-onboarding-broker-form.ts +2 -1
  107. package/src/components/onboarding/use-onboarding-progress.ts +11 -4
  108. package/src/components/onboarding/use-onboarding-upgrade.ts +3 -2
  109. package/src/components/onboarding/wizard-positions.ts +8 -1
  110. package/src/components/pane-notice-seen.ts +125 -0
  111. package/src/components/pane-settings-dialog/field-dialogs.tsx +2 -1
  112. package/src/components/pane-settings-dialog.tsx +7 -6
  113. package/src/components/sign-in-code-panel.tsx +3 -2
  114. package/src/components/speedometer-gauge/terminal.tsx +30 -9
  115. package/src/components/ticker/list-table-view.tsx +39 -3
  116. package/src/components/ui/confirm-dialog.tsx +2 -1
  117. package/src/components/ui/data-table/index.tsx +4 -2
  118. package/src/components/ui/data-table/opentui/index.tsx +15 -5
  119. package/src/components/ui/data-table/types.ts +8 -0
  120. package/src/components/ui/external-link.tsx +4 -1
  121. package/src/components/ui/field-grid.tsx +1 -1
  122. package/src/components/ui/index.ts +2 -0
  123. package/src/components/ui/inline-quick-add.tsx +5 -0
  124. package/src/components/ui/multi-select/dialog.tsx +10 -9
  125. package/src/components/ui/pane-link-chip.tsx +354 -0
  126. package/src/components/ui/query-bar.tsx +22 -13
  127. package/src/components/ui/ratio-bar.tsx +24 -1
  128. package/src/components/ui/select-button.tsx +2 -1
  129. package/src/components/ui/shortcut-hint.tsx +6 -3
  130. package/src/components/ui/table-layout.ts +81 -0
  131. package/src/components/ui/tabs.tsx +45 -6
  132. package/src/components/use-pane-notice-footer.tsx +12 -4
  133. package/src/core/app-service-ports.ts +1 -1
  134. package/src/data/plugin-state-store.ts +44 -8
  135. package/src/docs/snapshot.json +53 -32
  136. package/src/i18n/es.ts +25 -6
  137. package/src/i18n/ja.ts +25 -5
  138. package/src/i18n/ko.ts +25 -5
  139. package/src/i18n/zh-cn.ts +25 -5
  140. package/src/i18n/zh-tw.ts +25 -5
  141. package/src/layout/pane-manager/gridlock-inference.ts +2 -1
  142. package/src/layout/pane-manager/gridlock.ts +47 -2
  143. package/src/layout-marketplace/api.ts +1 -0
  144. package/src/layout-marketplace/gallery.tsx +4 -3
  145. package/src/layout-marketplace/linked.ts +6 -4
  146. package/src/layout-marketplace/model.ts +3 -2
  147. package/src/market-data/futures-contract.ts +77 -31
  148. package/src/market-data/fx-closes.ts +5 -2
  149. package/src/market-data/hooks.tsx +23 -0
  150. package/src/market-data/market/change-basis.ts +72 -14
  151. package/src/market-data/market/format.ts +19 -11
  152. package/src/market-data/market/globex-day.ts +73 -0
  153. package/src/market-data/market/index-level.ts +10 -1
  154. package/src/market-data/quotes/intraday-bar.ts +1 -1
  155. package/src/market-data/quotes/session-split.ts +28 -0
  156. package/src/plugins/builtin/account-management/pane.tsx +1 -1
  157. package/src/plugins/builtin/analytics/account-returns.ts +1 -1
  158. package/src/plugins/builtin/analytics/index.tsx +10 -3
  159. package/src/plugins/builtin/analytics/pane-model.ts +1 -1
  160. package/src/plugins/builtin/analytics/risk-client.ts +4 -1
  161. package/src/plugins/builtin/analytics/risk-episodes.ts +422 -0
  162. package/src/plugins/builtin/analytics/risk-fx.ts +1 -1
  163. package/src/plugins/builtin/analytics/risk-headless.ts +28 -10
  164. package/src/plugins/builtin/analytics/risk-math.ts +1 -1
  165. package/src/plugins/builtin/analytics/risk-model.ts +115 -26
  166. package/src/plugins/builtin/analytics/risk-pane.tsx +201 -23
  167. package/src/plugins/builtin/analytics/sharpe-cadence.ts +1 -1
  168. package/src/plugins/builtin/backtest/format.ts +14 -0
  169. package/src/plugins/builtin/backtest/pane.tsx +3 -3
  170. package/src/plugins/builtin/backtest/report.ts +5 -3
  171. package/src/plugins/builtin/broker-manager/add-request.ts +10 -1
  172. package/src/plugins/builtin/broker-trading/pane.tsx +20 -2
  173. package/src/plugins/builtin/buildout/company/flow.tsx +5 -5
  174. package/src/plugins/builtin/buildout/company/model.ts +14 -2
  175. package/src/plugins/builtin/catalysts/detail.tsx +2 -2
  176. package/src/plugins/builtin/catalysts/model.ts +7 -2
  177. package/src/plugins/builtin/catalysts/pane.tsx +2 -2
  178. package/src/plugins/builtin/chat/message/pane-chip.tsx +36 -208
  179. package/src/plugins/builtin/cloud/askg/answer-follow-ups.tsx +61 -0
  180. package/src/plugins/builtin/cloud/askg/answer-sources.tsx +102 -0
  181. package/src/plugins/builtin/cloud/askg/controller.ts +7 -1
  182. package/src/plugins/builtin/cloud/askg/host.ts +57 -0
  183. package/src/plugins/builtin/cloud/askg/model.ts +45 -5
  184. package/src/plugins/builtin/cloud/askg/pane.tsx +304 -25
  185. package/src/plugins/builtin/cloud/askg/protocol.ts +26 -1
  186. package/src/plugins/builtin/cloud/askg/sources.ts +466 -0
  187. package/src/plugins/builtin/cloud/one-tap/controller.ts +309 -0
  188. package/src/plugins/builtin/cloud/one-tap/google-identity.ts +142 -0
  189. package/src/plugins/builtin/cloud/one-tap/one-tap-prompt.tsx +101 -0
  190. package/src/plugins/builtin/cloud/plugin.tsx +7 -1
  191. package/src/plugins/builtin/company-kpis/client.ts +4 -3
  192. package/src/plugins/builtin/company-kpis/model.ts +34 -3
  193. package/src/plugins/builtin/correlation/index.tsx +39 -167
  194. package/src/plugins/builtin/correlation/matrix/grid.tsx +285 -0
  195. package/src/plugins/builtin/correlation/relationship/pane.tsx +6 -7
  196. package/src/plugins/builtin/correlation/relationship/view-model.ts +14 -5
  197. package/src/plugins/builtin/cot/client.ts +8 -3
  198. package/src/plugins/builtin/cot/headless.ts +65 -12
  199. package/src/plugins/builtin/cot/pane.tsx +11 -5
  200. package/src/plugins/builtin/earnings/client.ts +40 -6
  201. package/src/plugins/builtin/earnings/fiscal-quarter.ts +54 -0
  202. package/src/plugins/builtin/earnings/headless.ts +47 -11
  203. package/src/plugins/builtin/earnings/history-model.ts +136 -24
  204. package/src/plugins/builtin/earnings/history-table.ts +42 -10
  205. package/src/plugins/builtin/earnings/history.tsx +23 -8
  206. package/src/plugins/builtin/earnings-ripple/client.ts +5 -2
  207. package/src/plugins/builtin/earnings-ripple/headless.ts +8 -3
  208. package/src/plugins/builtin/earnings-ripple/model.ts +21 -0
  209. package/src/plugins/builtin/earnings-ripple/pane.tsx +2 -3
  210. package/src/plugins/builtin/econ/index.tsx +5 -4
  211. package/src/plugins/builtin/econ-statistics/stats.ts +13 -5
  212. package/src/plugins/builtin/equity-screener/headless.ts +2 -1
  213. package/src/plugins/builtin/filing-events/feed.ts +56 -18
  214. package/src/plugins/builtin/filing-events/pane.tsx +8 -2
  215. package/src/plugins/builtin/futures/index.tsx +32 -10
  216. package/src/plugins/builtin/futures/model.ts +93 -6
  217. package/src/plugins/builtin/futures/returns.ts +29 -7
  218. package/src/plugins/builtin/futures/table.tsx +59 -17
  219. package/src/plugins/builtin/futures/use-front-returns.ts +32 -6
  220. package/src/plugins/builtin/futures-curve/client.ts +12 -2
  221. package/src/plugins/builtin/futures-curve/headless.ts +58 -17
  222. package/src/plugins/builtin/futures-curve/model.ts +111 -15
  223. package/src/plugins/builtin/futures-curve/pane.tsx +11 -6
  224. package/src/plugins/builtin/fx-matrix/amount.ts +132 -0
  225. package/src/plugins/builtin/fx-matrix/headless.ts +53 -13
  226. package/src/plugins/builtin/fx-matrix/index.tsx +205 -42
  227. package/src/plugins/builtin/fx-matrix/pairs.ts +10 -8
  228. package/src/plugins/builtin/fx-matrix/settings.ts +22 -1
  229. package/src/plugins/builtin/help/index.tsx +68 -61
  230. package/src/plugins/builtin/holders/format.ts +7 -2
  231. package/src/plugins/builtin/holders/pane.tsx +11 -3
  232. package/src/plugins/builtin/holders/report-header.ts +5 -4
  233. package/src/plugins/builtin/holders/report-rows.ts +4 -1
  234. package/src/plugins/builtin/holders/treemap.tsx +5 -3
  235. package/src/plugins/builtin/insider/signals-model.ts +4 -5
  236. package/src/plugins/builtin/ipo-calendar/headless.ts +18 -7
  237. package/src/plugins/builtin/ipo-calendar/listing-ipo.ts +3 -1
  238. package/src/plugins/builtin/ipo-calendar/model.ts +28 -8
  239. package/src/plugins/builtin/ipo-calendar/pane.tsx +2 -1
  240. package/src/plugins/builtin/kelly-sizer/headless.ts +4 -0
  241. package/src/plugins/builtin/perps/headless.ts +73 -17
  242. package/src/plugins/builtin/perps/index.tsx +3 -1
  243. package/src/plugins/builtin/perps/model.ts +1 -1
  244. package/src/plugins/builtin/perps/pane.tsx +2 -0
  245. package/src/plugins/builtin/portfolio-list/cell-version.ts +1 -0
  246. package/src/plugins/builtin/portfolio-list/cli/bulk-symbols.ts +20 -1
  247. package/src/plugins/builtin/portfolio-list/cli/import-positions.ts +260 -0
  248. package/src/plugins/builtin/portfolio-list/cli/period-report.ts +154 -0
  249. package/src/plugins/builtin/portfolio-list/cli/portfolio-command.ts +64 -22
  250. package/src/plugins/builtin/portfolio-list/cli/render.ts +18 -7
  251. package/src/plugins/builtin/portfolio-list/cli/watchlist-command.ts +5 -3
  252. package/src/plugins/builtin/portfolio-list/grid.tsx +56 -12
  253. package/src/plugins/builtin/portfolio-list/headless.ts +128 -0
  254. package/src/plugins/builtin/portfolio-list/pane/index.tsx +42 -4
  255. package/src/plugins/builtin/portfolio-list/pane/period-pnl.ts +124 -0
  256. package/src/plugins/builtin/portfolio-list/period-pnl.ts +179 -0
  257. package/src/plugins/builtin/portfolio-list/positions-import/dialog.tsx +445 -0
  258. package/src/plugins/builtin/portfolio-list/positions-import/index.tsx +255 -0
  259. package/src/plugins/builtin/portfolio-list/positions-import/lookup.ts +78 -0
  260. package/src/plugins/builtin/portfolio-list/positions-import/read-file.ts +32 -0
  261. package/src/plugins/builtin/portfolio-list/quick-add/index.tsx +186 -50
  262. package/src/plugins/builtin/portfolio-list/quick-add/resolution.ts +118 -4
  263. package/src/plugins/builtin/portfolio-list/settings.ts +25 -0
  264. package/src/plugins/builtin/portfolio-list/summary/index.tsx +16 -1
  265. package/src/plugins/builtin/portfolio-list/summary/totals.ts +7 -5
  266. package/src/plugins/builtin/portfolio-list/table.tsx +105 -6
  267. package/src/plugins/builtin/power/headless.ts +47 -9
  268. package/src/plugins/builtin/research/relative-valuation-model.ts +8 -3
  269. package/src/plugins/builtin/research-search/article.ts +12 -2
  270. package/src/plugins/builtin/research-search/data.ts +5 -2
  271. package/src/plugins/builtin/research-search/document-view.tsx +1 -1
  272. package/src/plugins/builtin/research-search/model.ts +47 -3
  273. package/src/plugins/builtin/research-search/pane.tsx +3 -2
  274. package/src/plugins/builtin/reverse-dcf/model.ts +7 -4
  275. package/src/plugins/builtin/risk-factors/headless.ts +3 -2
  276. package/src/plugins/builtin/risk-factors/pane.tsx +5 -3
  277. package/src/plugins/builtin/scanner/flow-model.ts +17 -13
  278. package/src/plugins/builtin/scanner/flow-pane.tsx +8 -9
  279. package/src/plugins/builtin/scanner/flow-session.ts +2 -9
  280. package/src/plugins/builtin/sec/filing-display.tsx +0 -5
  281. package/src/plugins/builtin/sec/forms.ts +19 -0
  282. package/src/plugins/builtin/sec/headless.ts +7 -11
  283. package/src/plugins/builtin/sec/index.tsx +11 -3
  284. package/src/plugins/builtin/shared/earnings-calendar.ts +6 -3
  285. package/src/plugins/builtin/shared/earnings-report.ts +1 -1
  286. package/src/plugins/builtin/shared/fx-rate-freshness.ts +0 -35
  287. package/src/plugins/builtin/shared/use-quote-board.ts +42 -27
  288. package/src/plugins/builtin/supply-chain/graph-model.ts +7 -1
  289. package/src/plugins/builtin/supply-chain/headless.ts +20 -10
  290. package/src/plugins/builtin/supply-chain/model.ts +117 -20
  291. package/src/plugins/builtin/supply-chain/pane.tsx +22 -15
  292. package/src/plugins/builtin/supply-chain/row-evidence.tsx +1 -1
  293. package/src/plugins/builtin/ticker-detail/data-panes/returns-chart-model.ts +69 -0
  294. package/src/plugins/builtin/ticker-detail/data-panes/returns-chart.tsx +118 -0
  295. package/src/plugins/builtin/ticker-detail/data-panes/returns-model.ts +1 -1
  296. package/src/plugins/builtin/ticker-detail/data-panes/returns-pane.tsx +103 -40
  297. package/src/plugins/builtin/ticker-detail/headless-schema.ts +10 -1
  298. package/src/plugins/builtin/ticker-detail/headless.ts +8 -1
  299. package/src/plugins/builtin/ticker-detail/overview/components.tsx +2 -1
  300. package/src/plugins/builtin/ticker-detail/overview/model.ts +4 -2
  301. package/src/plugins/builtin/ticker-detail/overview-tab.tsx +11 -8
  302. package/src/plugins/builtin/ticker-detail/pane.tsx +95 -20
  303. package/src/plugins/builtin/ticker-detail/research-groups.ts +89 -0
  304. package/src/plugins/builtin/ticker-detail/settings.ts +4 -3
  305. package/src/plugins/builtin/volatility/charts.tsx +2 -2
  306. package/src/plugins/host-resolver.ts +3 -2
  307. package/src/portfolio/column-values.ts +42 -8
  308. package/src/portfolio/futures-positions.ts +10 -2
  309. package/src/portfolio/mutations.ts +4 -3
  310. package/src/portfolio/period-pnl.ts +119 -0
  311. package/src/portfolio/positions-import/describe.ts +89 -0
  312. package/src/portfolio/positions-import/parse.ts +682 -0
  313. package/src/portfolio/positions-import/plan.ts +295 -0
  314. package/src/{plugins/builtin/analytics/metrics.ts → portfolio/return-metrics.ts} +24 -11
  315. package/src/public/__snapshots__/public-api.test.ts.snap +1 -0
  316. package/src/react/jsx-dev-fallback.ts +62 -0
  317. package/src/renderers/browser/cloud-transport.ts +1 -1
  318. package/src/renderers/browser/config-host.ts +3 -1
  319. package/src/renderers/browser/deeplink-bridge.ts +8 -1
  320. package/src/renderers/browser/http-proxy-transport.ts +9 -2
  321. package/src/renderers/browser/main.tsx +2 -1
  322. package/src/renderers/browser/research-entry.ts +12 -0
  323. package/src/renderers/cloudflare/http-proxy.ts +8 -2
  324. package/src/renderers/cloudflare/proxy-session.ts +1 -0
  325. package/src/renderers/cloudflare/worker.ts +12 -3
  326. package/src/renderers/dom/desktop/audio-player.tsx +2 -2
  327. package/src/renderers/dom/desktop/controls.tsx +1 -1
  328. package/src/renderers/dom/desktop/dialog-actions.tsx +10 -24
  329. package/src/renderers/dom/desktop/icons.tsx +4 -2
  330. package/src/renderers/dom/desktop/query-bar.tsx +23 -19
  331. package/src/renderers/dom/dom-host-providers.tsx +7 -2
  332. package/src/renderers/dom/host/box.tsx +2 -2
  333. package/src/renderers/dom/host/input.tsx +13 -0
  334. package/src/renderers/dom/key-event.ts +1 -0
  335. package/src/renderers/dom/styles.css +3 -0
  336. package/src/renderers/electrobun/bun/context-menu/click.ts +1 -0
  337. package/src/renderers/electrobun/bun/desktop/backend.ts +1 -0
  338. package/src/renderers/electrobun/bun/desktop/capability-bridge.ts +5 -4
  339. package/src/renderers/electrobun/bun/desktop/host-requests.ts +5 -4
  340. package/src/renderers/electrobun/bun/desktop/http-fetch.ts +1 -0
  341. package/src/renderers/electrobun/bun/desktop/http-stream.ts +1 -1
  342. package/src/renderers/electrobun/bun/desktop/initialization.ts +3 -1
  343. package/src/renderers/electrobun/bun/desktop/install-records.ts +4 -1
  344. package/src/renderers/electrobun/bun/desktop/installer-folder.ts +5 -2
  345. package/src/renderers/electrobun/bun/desktop/macos-objc.ts +3 -1
  346. package/src/renderers/electrobun/bun/desktop/screen-setup-file.ts +9 -4
  347. package/src/renderers/electrobun/bun/desktop/update.ts +27 -13
  348. package/src/renderers/electrobun/bun/desktop/windows-script.ts +6 -2
  349. package/src/renderers/electrobun/bun/window/attention.ts +1 -0
  350. package/src/renderers/electrobun/bun/window/boot-frame.ts +1 -0
  351. package/src/renderers/electrobun/bun/window/create.ts +1 -0
  352. package/src/renderers/electrobun/bun/window/electrobun-window-host.ts +13 -8
  353. package/src/renderers/electrobun/bun/window/native-min-size.ts +1 -1
  354. package/src/renderers/electrobun/bun/window/remembered-frame.ts +1 -0
  355. package/src/renderers/electrobun/bun/window/windows-native.ts +3 -1
  356. package/src/renderers/electrobun/bun/window/windows-quit.ts +3 -1
  357. package/src/renderers/electrobun/view/app-badge-host.ts +2 -1
  358. package/src/renderers/electrobun/view/capability-subscription.ts +2 -1
  359. package/src/renderers/electrobun/view/cli-pane-shot-entry.tsx +7 -10
  360. package/src/renderers/electrobun/view/cli-pane-shot-mutations.ts +36 -0
  361. package/src/renderers/electrobun/view/http-fetch.ts +2 -1
  362. package/src/renderers/electrobun/view/main.tsx +9 -4
  363. package/src/renderers/electrobun/view/remote/capability-invoker.ts +6 -3
  364. package/src/renderers/electrobun/view/remote/persistence.ts +63 -27
  365. package/src/renderers/electrobun/view/rpc-timeout.ts +1 -0
  366. package/src/renderers/electrobun/view/ui-host.tsx +3 -2
  367. package/src/renderers/electrobun/view/window-fullscreen.ts +3 -1
  368. package/src/renderers/opentui/browser-open.ts +2 -1
  369. package/src/renderers/opentui/dialog-host.tsx +1 -1
  370. package/src/renderers/opentui/interaction-performance.ts +3 -1
  371. package/src/renderers/opentui/start.tsx +2 -1
  372. package/src/renderers/opentui/terminal-media.ts +11 -6
  373. package/src/renderers/opentui/ui-host.tsx +5 -8
  374. package/src/shares/open.ts +22 -1
  375. package/src/shares/pane.ts +2 -1
  376. package/src/sources/gloomberb-cloud/normalizers.ts +3 -0
  377. package/src/sync/analytics-payload.ts +194 -0
  378. package/src/sync/baseline.ts +19 -9
  379. package/src/sync/broker-identity.ts +171 -0
  380. package/src/sync/broker-instances.ts +137 -0
  381. package/src/sync/collections-contributor.ts +173 -0
  382. package/src/sync/config-contributor.ts +100 -0
  383. package/src/sync/config-merge.ts +229 -0
  384. package/src/sync/controller.ts +139 -28
  385. package/src/sync/core-contributors.ts +8 -1583
  386. package/src/sync/history-memo.ts +32 -0
  387. package/src/sync/layout-merge.ts +259 -0
  388. package/src/sync/sanitize.ts +114 -0
  389. package/src/sync/ticker-merge.ts +208 -0
  390. package/src/sync/ticker-payload.ts +81 -0
  391. package/src/sync/types.ts +15 -1
  392. package/src/telemetry/attention-setting.ts +1 -1
  393. package/src/telemetry/usage-counts.ts +16 -0
  394. package/src/test-support/preload.ts +5 -0
  395. package/src/theme/color-utils.ts +10 -0
  396. package/src/theme/font-scale.ts +34 -3
  397. package/src/theme/series-colors.ts +44 -0
  398. package/src/theme/themes.ts +2 -1
  399. package/src/tickers/batched-lookups.ts +263 -6
  400. package/src/tickers/company-name-listing.ts +44 -2
  401. package/src/tickers/company-name.ts +7 -2
  402. package/src/tickers/search/upsert.ts +16 -1
  403. package/src/time-series/base-series.ts +18 -4
  404. package/src/time-series/studies/indicators.ts +3 -1
  405. package/src/time-series/studies/resolve.ts +1 -1
  406. package/src/time-series/types.ts +6 -0
  407. package/src/types/financials.ts +18 -0
  408. package/src/types/headless.ts +11 -0
  409. package/src/ui/host.tsx +26 -3
  410. package/src/ui/index.tsx +1 -0
  411. package/src/utils/concurrency.ts +6 -0
  412. package/src/utils/currency-pair.ts +56 -4
  413. package/src/utils/datetime-format.ts +11 -0
  414. package/src/utils/decimal-comma.ts +9 -6
  415. package/src/utils/exchanges.ts +32 -0
  416. package/src/utils/fundamentals.ts +41 -0
  417. package/src/utils/markdown.ts +4 -2
  418. package/src/utils/pasted-lines.ts +14 -0
  419. package/src/utils/price-window.ts +2 -1
  420. package/src/utils/sec-filings.ts +17 -0
  421. package/src/utils/sec.ts +4 -23
  422. package/src/utils/shortcut-labels.ts +6 -30
@@ -20,6 +20,7 @@ function base(data: CotPayloadBase, family: CotFamily, positions: CotPositions)
20
20
  || !Array.isArray(data.gaps) || !data.gaps.every((gap) => typeof gap === "string")
21
21
  || !Array.isArray(data.classes) || data.classes.some((row) => !COT_CLASSES[family].some((option) => option.value === row.id))
22
22
  || data.asOf !== null && !date(data.asOf) || !Number.isFinite(Date.parse(data.generatedAt))
23
+ || data.publishedAt != null && !Number.isFinite(Date.parse(data.publishedAt))
23
24
  || !["available", "partial", "unavailable"].includes(data.status)) throw new Error("The server returned an invalid COT report");
24
25
  }
25
26
  function summary(row: CotClassSummary, family: CotFamily) {
@@ -27,7 +28,7 @@ function summary(row: CotClassSummary, family: CotFamily) {
27
28
  || ![row.long, row.short, row.spreading].every(count) || ![row.net, row.weeklyChange, row.netPercentOfOpenInterest].every(number)
28
29
  || row.net !== (row.long == null || row.short == null ? null : row.long - row.short)
29
30
  || row.previousReportDate !== null && !date(row.previousReportDate)) throw new Error("The server returned invalid COT positions");
30
- for (const rank of [row.percentile1Y, row.percentile3Y]) {
31
+ for (const rank of [row.percentile1Y, row.percentile3Y, ...(row.percentileAll === undefined ? [] : [row.percentileAll])]) {
31
32
  if (!rank || !Number.isSafeInteger(rank.sampleCount) || rank.sampleCount < 0 || typeof rank.completeWindow !== "boolean"
32
33
  || ![rank.min, rank.max, rank.mean, rank.rank].every(number) || !date(rank.windowStart) || !date(rank.windowEnd)
33
34
  || rank.value !== null && (!number(rank.value) || rank.value < 0 || rank.value > 100)
@@ -86,8 +87,12 @@ export async function loadCotBoard(family: CotFamily, traderClass: CotClass, for
86
87
  () => fetchCotBoard(family, traderClass, apiClient, positions), { force });
87
88
  return presentCotBoard(payload, stale, refreshError);
88
89
  }
89
- export async function fetchCotContract(contractCode: string, family: CotFamily, client: Pick<typeof apiClient, "getCloudCotContract"> = apiClient, positions: CotPositions = "futures-only") {
90
- try { return validateCotContract(await client.getCloudCotContract(contractCode, family, positions), family, contractCode, positions); }
90
+ export async function fetchCotContract(contractCode: string, family: CotFamily, client: Pick<typeof apiClient, "getCloudCotContract"> = apiClient,
91
+ positions: CotPositions = "futures-only", since?: string) {
92
+ try {
93
+ const payload = await client.getCloudCotContract(contractCode, family, positions, since);
94
+ return validateCotContract(payload, family, contractCode, positions);
95
+ }
91
96
  catch (error) { throw unavailable(error); }
92
97
  }
93
98
  export interface CotDetailData { payload: CotContractPayload; price: PricePoint[]; priceSymbol: string | null; priceAsOf: string | null; priceWarning: string | null }
@@ -4,6 +4,7 @@ import { fetchCotBoard, fetchCotContract } from "./client";
4
4
  import { COT_CLASSES, COT_FAMILIES, COT_MAJOR_CODES, COT_POSITIONS, COT_SCOPES, cotClass, cotContractCode, cotContractUnitText, cotFamily, cotInteger, cotMarketName, cotPositions, cotPositionsText, cotProxyFor, cotProxyNote, cotReleaseTime, cotScope, cotUnknownMarketMessage } from "./model";
5
5
  import { COMMODITIES_VIEW_STATE } from "../commodities-energy/view-state";
6
6
  import { REPORT_ROWS } from "../shared/headless-options";
7
+ import { DATE_OPTION_EXAMPLES, isoDateOption } from "../../../utils/calendar-date";
7
8
 
8
9
  const camelClass = (id: CotClass) => id.replace(/-(\w)/g, (_match, letter: string) => letter.toUpperCase());
9
10
  const rounded = (value: number | null, digits: number) => value == null ? null : Number(value.toFixed(digits));
@@ -12,17 +13,26 @@ const signed = (value: unknown) => cotInteger(typeof value === "number" ? value
12
13
  const percent = (value: unknown) => typeof value === "number" ? `${value > 0 ? "+" : ""}${value.toFixed(1)}%` : "--";
13
14
  const rank = (value: unknown) => typeof value === "number" ? value.toFixed(0) : "--";
14
15
 
15
- /** The report's release, by the CFTC's schedule, for an export's publication time; nothing outside the schedule. */
16
- function cotReleased(asOf: string | null) {
17
- const publishedAt = cotReleaseTime(asOf);
18
- return publishedAt ? { freshness: { publishedAt } } : {};
16
+ /**
17
+ * The report's release, by the CFTC's schedule, as Gloom Cloud states it (else
18
+ * the app's copy of the schedule): one time for the text, CSV and JSON, the
19
+ * export's publication time and the metadata's `publishedAt` alike.
20
+ */
21
+ function cotPublishedAt(data: Pick<CotContractPayload, "asOf" | "publishedAt">): string | null {
22
+ return data.publishedAt ?? cotReleaseTime(data.asOf);
23
+ }
24
+ /** Who published the report, cited by every export: the CFTC itself. */
25
+ const COT_PUBLISHER = "Commodity Futures Trading Commission (CFTC)";
26
+ function cotReleased(publishedAt: string | null) {
27
+ return { freshness: { publisher: COT_PUBLISHER, ...(publishedAt ? { publishedAt } : {}) } };
19
28
  }
20
29
 
21
30
  /** The pane's columns: percentiles as their rank value, net share of open interest to one decimal. */
22
31
  function cotPositionRow(row: CotClassSummary) {
23
32
  return { long: row.long, short: row.short, spreading: row.spreading, net: row.net,
24
33
  netPercentOfOpenInterest: rounded(row.netPercentOfOpenInterest, 1), weeklyChange: row.weeklyChange, previousReportDate: row.previousReportDate,
25
- oneYearPercentile: rounded(row.percentile1Y.value, 0), threeYearPercentile: rounded(row.percentile3Y.value, 0) };
34
+ oneYearPercentile: rounded(row.percentile1Y.value, 0), threeYearPercentile: rounded(row.percentile3Y.value, 0),
35
+ allHistoryPercentile: rounded(row.percentileAll?.value ?? null, 0) };
26
36
  }
27
37
  /**
28
38
  * A market's title line: its name, the report date (the Tuesday the positions
@@ -48,8 +58,40 @@ const POSITION_COLUMNS: HeadlessPaneColumn[] = [
48
58
  { key: "netPercentOfOpenInterest", header: "Net % OI", align: "right", format: percent },
49
59
  { key: "oneYearPercentile", header: "Pctl 1Y", align: "right", format: rank },
50
60
  { key: "threeYearPercentile", header: "Pctl 3Y", align: "right", format: rank },
61
+ // Every stored report of the market, from its first (back to 1986 for the oldest Legacy markets).
62
+ { key: "allHistoryPercentile", header: "Pctl All", align: "right", format: rank },
51
63
  ];
52
64
 
65
+ /**
66
+ * The grain markets the CFTC moved from thousands of bushels to contracts in
67
+ * January 1998, each under a new code: their Legacy reports before that are
68
+ * under the old code, a separate market here (not joined to the new one).
69
+ */
70
+ const COT_CODES_BEFORE_1998: Readonly<Record<string, string>> = {
71
+ "001602": "001601", // wheat, CBOT
72
+ "001612": "001611", // wheat, Kansas City
73
+ "001626": "001621", // wheat, Minneapolis
74
+ "001627": "001624", // white wheat, Minneapolis
75
+ "002602": "002601", // corn
76
+ "004603": "004601", // oats
77
+ "005602": "005601", // soybeans
78
+ };
79
+
80
+ /**
81
+ * What the weekly section says about how far back it reaches: the history
82
+ * `--since` asked for begins after the market's first report, or the server
83
+ * has none that old.
84
+ */
85
+ function cotHistoryNote(data: CotContractPayload, since: string | null): string | null {
86
+ const first = data.history[0]?.reportDate;
87
+ if (!since || !first || first <= since) return null;
88
+ if (!data.historyStart || data.historyStart <= since) return `Weekly positions before ${first} are not available yet.`;
89
+ const previous = data.reportFamily === "legacy" ? COT_CODES_BEFORE_1998[data.contract?.contractCode ?? ""] : undefined;
90
+ return previous
91
+ ? `Reports under CFTC code ${data.contract!.contractCode} start ${data.historyStart}, when the CFTC began counting this market in contracts; its earlier reports are under its previous code ${previous}, in thousands of bushels, and are not joined to these. --since ${since} lists from ${data.historyStart}.`
92
+ : `The CFTC's first report of this market in Gloom Cloud is ${data.historyStart}; --since ${since} lists from there.`;
93
+ }
94
+
53
95
  export const cotHeadless: HeadlessPaneDefinition<"bundle"> = {
54
96
  shape: "bundle",
55
97
  // Tuesday positions published the Friday after; two weeks without a new report means one was missed.
@@ -62,6 +104,9 @@ export const cotHeadless: HeadlessPaneDefinition<"bundle"> = {
62
104
  pluginState: { pluginId: COMMODITIES_VIEW_STATE.cot, key: "positions" } },
63
105
  { key: "scope", type: "enum", values: COT_SCOPES.map(({ value }) => ({ value })), defaultValue: "major", description: "Markets on the extremes board, as in the pane.",
64
106
  pluginState: { pluginId: COMMODITIES_VIEW_STATE.cot, key: "scope" } },
107
+ { key: "since", type: "string", placeholder: "date", example: "--since 2006-06-13",
108
+ description: `First report date a market lists, as ${DATE_OPTION_EXAMPLES}; three years by default. Ranks always read every report.`,
109
+ normalize: (value) => isoDateOption(value, "since") },
65
110
  // Weekly reports come newest first, so --tail asks for the same newest n as --limit.
66
111
  { key: "limit", type: "integer", aliases: ["tail", "weeks", "rows"], minimum: 1, maximum: 2000, shot: REPORT_ROWS,
67
112
  description: "Newest weekly reports a market lists; every one by default." }],
@@ -74,32 +119,40 @@ export const cotHeadless: HeadlessPaneDefinition<"bundle"> = {
74
119
  const code = cotContractCode(args.argument);
75
120
  if (!code) throw new Error(cotUnknownMarketMessage(args.argument));
76
121
  const proxy = cotProxyFor(args.argument);
77
- const data = await fetchCotContract(code, family, ctx.apiClient, positions);
122
+ const since = typeof args.options.since === "string" && args.options.since ? args.options.since : null;
123
+ const data = await fetchCotContract(code, family, ctx.apiClient, positions, since ?? undefined);
124
+ const publishedAt = cotPublishedAt(data);
125
+ const historyNote = cotHistoryNote(data, since);
78
126
  const classes = data.positions.map((row) => row.id);
79
127
  const limit = args.options.limit == null ? null : Number(args.options.limit);
80
128
  const weeks = cotWeeklyRows(data.history, limit);
129
+ const weeklyColumns: HeadlessPaneColumn[] = [{ key: "reportDate", header: "Report date" }, { key: "released", header: "Released" },
130
+ { key: "openInterest", header: "Open interest", align: "right", format: count },
131
+ ...classes.map((id) => ({ key: `${camelClass(id)}Net`, header: `${data.positions.find((row) => row.id === id)?.label ?? id} net`, align: "right" as const, format: signed }))];
81
132
  return { sections: [{ title: cotContractTitle(data, code),
82
133
  columns: [{ key: "class", header: "Class" }, { key: "long", header: "Long", align: "right", format: count },
83
134
  { key: "short", header: "Short", align: "right", format: count }, ...POSITION_COLUMNS],
84
135
  rows: data.positions.map((row) => ({ class: row.label, ...cotPositionRow(row) })) },
85
136
  { title: weeks.length < data.history.length ? `Weekly positions · newest ${weeks.length} of ${data.history.length}` : "Weekly positions",
86
- columns: [{ key: "reportDate", header: "Report date" }, { key: "openInterest", header: "Open interest", align: "right", format: count },
87
- ...classes.map((id) => ({ key: `${camelClass(id)}Net`, header: `${data.positions.find((row) => row.id === id)?.label ?? id} net`, align: "right" as const, format: signed }))],
88
- rows: weeks.map((row) => ({ reportDate: row.reportDate, openInterest: row.openInterest,
137
+ columns: weeklyColumns,
138
+ // Each report's scheduled release, for an export read as of a past week; the text keeps to the positions.
139
+ textColumns: weeklyColumns.filter((column) => column.key !== "released"),
140
+ rows: weeks.map((row) => ({ reportDate: row.reportDate, released: row.publishedAt ?? cotReleaseTime(row.reportDate), openInterest: row.openInterest,
89
141
  ...Object.fromEntries(row.positions.map((position) => [`${camelClass(position.id)}Net`, position.net])) })) }],
90
142
  // "jet fuel" reads heating oil's positions, and says so.
91
- ...(proxy ? { notes: [cotProxyNote(proxy)] } : {}),
92
- errors: data.gaps, metadata: { ...data, complete: data.status === "available" }, ...cotReleased(data.asOf) };
143
+ ...(proxy || historyNote ? { notes: [...(proxy ? [cotProxyNote(proxy)] : []), ...(historyNote ? [historyNote] : [])] } : {}),
144
+ errors: data.gaps, metadata: { ...data, publishedAt, complete: data.status === "available" }, ...cotReleased(publishedAt) };
93
145
  }
94
146
  const traderClass = cotClass(family, args.options.traderClass);
95
147
  if (args.options.traderClass && traderClass !== args.options.traderClass) throw new Error("Trader class does not belong to this report family");
96
148
  const scope = cotScope(args.options.scope);
97
149
  const data = await fetchCotBoard(family, traderClass, ctx.apiClient, positions);
98
150
  const rows = data.rows.filter((row) => scope === "all" || COT_MAJOR_CODES.has(row.contractCode));
151
+ const publishedAt = cotPublishedAt(data);
99
152
  return { sections: [{ title: positions === "combined" ? `Positioning extremes · ${cotPositionsText(positions)}` : "Positioning extremes",
100
153
  columns: [{ key: "marketName", header: "Market" }, { key: "contractCode", header: "Code" }, ...POSITION_COLUMNS,
101
154
  { key: "openInterest", header: "Open interest", align: "right", format: count }, { key: "reportDate", header: "As of" }],
102
155
  rows: rows.map((row) => ({ contractCode: row.contractCode, marketName: cotMarketName(row.marketName), reportDate: row.reportDate, openInterest: row.openInterest, ...cotPositionRow(row.position) })) }],
103
- errors: data.gaps, metadata: { ...data, scope, complete: data.status === "available" }, ...cotReleased(data.asOf) };
156
+ errors: data.gaps, metadata: { ...data, scope, publishedAt, complete: data.status === "available" }, ...cotReleased(publishedAt) };
104
157
  },
105
158
  };
@@ -22,6 +22,7 @@ const BOARD_COLUMNS: DataTableColumn[] = [
22
22
  { id: "change", label: "1W Δ", width: 11, align: "right" },
23
23
  { id: "one", label: "PCTL 1Y", width: 8, align: "right" },
24
24
  { id: "three", label: "PCTL 3Y", width: 8, align: "right" },
25
+ { id: "all", label: "PCTL ALL", width: 9, align: "right" },
25
26
  { id: "asOf", label: "AS OF", width: 10, align: "left" },
26
27
  ];
27
28
  const POSITION_COLUMNS: DataTableColumn[] = [
@@ -32,13 +33,17 @@ const POSITION_COLUMNS: DataTableColumn[] = [
32
33
  { id: "change", label: "1W Δ", width: 10, align: "right" },
33
34
  { id: "one", label: "PCTL 1Y", width: 8, align: "right" },
34
35
  { id: "three", label: "PCTL 3Y", width: 8, align: "right" },
36
+ { id: "all", label: "PCTL ALL", width: 9, align: "right" },
35
37
  ];
36
38
  /** Net positioning is the subject: two parts of the plot to the front price's one. */
37
39
  const NET_PRICE_PANELS = [{ id: "net", height: 2 }, { id: "price", height: 1 }];
38
40
  const NET_PANEL = [{ id: "net" }];
39
41
  /** Legend, four net rows, two price rows and the axis; a shorter band keeps the net alone. */
40
42
  const PRICE_PANEL_MIN_ROWS = 8;
41
- const rank = (value: number | null) => value == null ? "--" : value.toFixed(0);
43
+ const rank = (value: number | null | undefined) => value == null ? "--" : value.toFixed(0);
44
+ /** A class's rank in a percentile column: 1Y, 3Y, or against every stored report (`all`). */
45
+ const columnRank = (row: CotClassSummary, column: string) =>
46
+ (column === "one" ? row.percentile1Y : column === "three" ? row.percentile3Y : row.percentileAll)?.value ?? null;
42
47
  const cotDetailTitle = (name: string | undefined, code: string | null) => name ? cotMarketName(name) : code ?? undefined;
43
48
 
44
49
  export function CotPane(props: PaneProps) {
@@ -81,7 +86,8 @@ function CotBoard({ width, height, focused, family, initialCode }: PaneProps & {
81
86
  : scope === "all" || COT_MAJOR_CODES.has(row.contractCode));
82
87
  if (!sort.columnId) return result;
83
88
  const value = (row: CotBoardRow) => ({ name: cotMarketName(row.marketName), code: row.contractCode, net: row.position.net, change: row.position.weeklyChange,
84
- one: row.position.percentile1Y.value, three: row.position.percentile3Y.value, asOf: row.reportDate })[sort.columnId as "name"];
89
+ one: row.position.percentile1Y.value, three: row.position.percentile3Y.value, all: row.position.percentileAll?.value ?? null,
90
+ asOf: row.reportDate })[sort.columnId as "name"];
85
91
  return [...result].sort((a, b) => compareSortValues(value(a), value(b), sort.direction));
86
92
  }, [data, query, scope, sort]);
87
93
  useAutoRefresh(resource.updatedAt, resource.load);
@@ -116,7 +122,7 @@ function CotBoard({ width, height, focused, family, initialCode }: PaneProps & {
116
122
  if (column.id === "code") return { text: row.contractCode, color: colors.textMuted };
117
123
  if (column.id === "net") return { text: cotInteger(row.position.net, true) };
118
124
  if (column.id === "change") return { text: cotInteger(row.position.weeklyChange, true) };
119
- if (column.id === "one" || column.id === "three") return { text: rank(column.id === "one" ? row.position.percentile1Y.value : row.position.percentile3Y.value), color: colors.warning };
125
+ if (column.id === "one" || column.id === "three" || column.id === "all") return { text: rank(columnRank(row.position, column.id)), color: colors.warning };
120
126
  return { text: row.reportDate, color: colors.textMuted };
121
127
  }}
122
128
  rootBefore={<QueryBar width={width}
@@ -197,8 +203,8 @@ function CotDetail({ width, height, focused, code, family, positions, traderClas
197
203
  tableColumns={POSITION_COLUMNS} />}
198
204
  selection={{ kind: "id", selectedId: traderClass, getId: (row) => row.id, onChange: (id) => onClassChange(id as CotClass) }}
199
205
  onActivate={(row) => onClassChange(row.id)} getItemKey={(row) => row.id} sortColumnId={null} sortDirection="asc"
200
- renderCell={(row: CotClassSummary, column) => ({ text: column.id === "name" ? row.label : column.id === "one" ? rank(row.percentile1Y.value)
201
- : column.id === "three" ? rank(row.percentile3Y.value) : cotInteger(column.id === "change" ? row.weeklyChange : row[column.id as "long" | "short" | "net"], column.id === "net" || column.id === "change") })}
206
+ renderCell={(row: CotClassSummary, column) => ({ text: column.id === "name" ? row.label
207
+ : column.id === "one" || column.id === "three" || column.id === "all" ? rank(columnRank(row, column.id)) : cotInteger(column.id === "change" ? row.weeklyChange : row[column.id as "long" | "short" | "net"], column.id === "net" || column.id === "change") })}
202
208
  emptyStateTitle="Position classes unavailable." /> : null}
203
209
  </PaneStatusBody>;
204
210
  }
@@ -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
  };