gloomberb 0.20.2 → 0.20.3

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 (362) hide show
  1. package/README.md +1 -1
  2. package/README.zh-CN.md +1 -1
  3. package/package.json +2 -1
  4. package/src/account/auth-form.tsx +13 -8
  5. package/src/account/upgrade-dialog.tsx +1 -1
  6. package/src/api-client/central-bank-rates.ts +5 -0
  7. package/src/api-client/data.ts +17 -4
  8. package/src/api-client/debt-maturities.ts +45 -2
  9. package/src/api-client/earnings.ts +4 -2
  10. package/src/api-client/errors.ts +21 -11
  11. package/src/api-client/index.ts +1 -0
  12. package/src/api-client/paths.ts +9 -1
  13. package/src/api-client/social-mentions.ts +47 -0
  14. package/src/api-client/types/econ.ts +4 -0
  15. package/src/app.tsx +11 -1
  16. package/src/cli/command-options.ts +2 -1
  17. package/src/cli/commands/market.ts +111 -29
  18. package/src/cli/commands/options-chain.ts +23 -6
  19. package/src/cli/commands/overview.ts +13 -5
  20. package/src/cli/commands/plugins.ts +49 -18
  21. package/src/cli/commands/search.ts +25 -6
  22. package/src/cli/commands/ticker.ts +4 -2
  23. package/src/cli/fx-quote-rate.ts +49 -1
  24. package/src/cli/glossary.ts +95 -15
  25. package/src/cli/history-rows.ts +9 -25
  26. package/src/cli/index.ts +6 -38
  27. package/src/cli/known-gaps.ts +3 -3
  28. package/src/cli/listing-arg.ts +78 -18
  29. package/src/cli/name-entries.ts +3 -2
  30. package/src/cli/not-a-ticker.ts +6 -2
  31. package/src/cli/pane-functions/capabilities.ts +12 -1
  32. package/src/cli/pane-functions/function-help.ts +23 -11
  33. package/src/cli/pane-functions/headless.ts +3 -1
  34. package/src/cli/pane-functions/index.ts +32 -4
  35. package/src/cli/pane-functions/market-session.ts +8 -3
  36. package/src/cli/pane-functions/resolver.ts +18 -11
  37. package/src/cli/pane-functions/screenshot-payload.ts +36 -6
  38. package/src/cli/pane-functions/screenshot-render.ts +4 -0
  39. package/src/cli/quote-answer.ts +10 -0
  40. package/src/cli/report-tables.ts +22 -2
  41. package/src/cli/result.ts +7 -3
  42. package/src/cli/spreadsheet-hint.ts +43 -0
  43. package/src/cli/symbol-list.ts +58 -4
  44. package/src/cli/symbol-rows.ts +49 -2
  45. package/src/cli/ticker-resolution.ts +98 -5
  46. package/src/cli/unknown-command.ts +88 -0
  47. package/src/components/command-bar/assist/model.ts +6 -1
  48. package/src/components/command-bar/commands/direct/index.ts +9 -1
  49. package/src/components/command-bar/commands/registry.ts +18 -0
  50. package/src/components/command-bar/pane-actions.ts +30 -13
  51. package/src/components/command-bar/panel/index.tsx +6 -3
  52. package/src/components/command-bar/panel/prompt-binding.ts +4 -0
  53. package/src/components/command-bar/panel/types.ts +3 -0
  54. package/src/components/command-bar/routes/header-market.ts +108 -0
  55. package/src/components/command-bar/routes/root/command-items.ts +5 -0
  56. package/src/components/command-bar/routes/root/provider-search.ts +190 -32
  57. package/src/components/command-bar/routes/root/results.ts +3 -0
  58. package/src/components/command-bar/routes/root/runtime.ts +28 -5
  59. package/src/components/command-bar/routes/ticker-search/results.ts +53 -6
  60. package/src/components/command-bar/routing/list-state.ts +38 -0
  61. package/src/components/command-bar/selection-hint.ts +28 -0
  62. package/src/components/command-bar/surface/index.tsx +41 -3
  63. package/src/components/command-bar/view-model.ts +15 -0
  64. package/src/components/command-bar/workflow/tickers.ts +3 -2
  65. package/src/components/company-logo.tsx +20 -2
  66. package/src/components/data-table/export.ts +13 -8
  67. package/src/components/feedback-dialog.tsx +2 -1
  68. package/src/components/form-modal/field-row.tsx +2 -1
  69. package/src/components/input-search-bar.tsx +2 -2
  70. package/src/components/layout/double-escape-close.ts +8 -5
  71. package/src/components/layout/header.tsx +75 -44
  72. package/src/components/layout/market-summary.ts +322 -116
  73. package/src/components/layout/pane/footer/index.tsx +26 -8
  74. package/src/components/layout/pane/footer/model.ts +46 -20
  75. package/src/components/layout/pane/header.tsx +3 -2
  76. package/src/components/layout/shell/chrome.ts +15 -15
  77. package/src/components/layout/status-bar.tsx +8 -7
  78. package/src/components/layout/status-widget-space.ts +8 -0
  79. package/src/components/markdown-editor.tsx +2 -2
  80. package/src/components/onboarding/account-step/form-panel.tsx +0 -3
  81. package/src/components/onboarding/onboarding-keyboard.ts +15 -6
  82. package/src/components/onboarding/onboarding-wizard.tsx +61 -11
  83. package/src/components/onboarding/portfolio-step/broker-fields-panel.tsx +0 -1
  84. package/src/components/onboarding/portfolio-step/positions-panel.tsx +0 -2
  85. package/src/components/price-sparkline/model.ts +26 -10
  86. package/src/components/ticker/list-table-view.tsx +29 -4
  87. package/src/components/ui/button.tsx +13 -2
  88. package/src/components/ui/column-grid.tsx +18 -9
  89. package/src/components/ui/data-table/index.tsx +1 -1
  90. package/src/components/ui/data-table/opentui/index.tsx +2 -1
  91. package/src/components/ui/data-table/types.ts +18 -0
  92. package/src/components/ui/delayed-mark.tsx +3 -2
  93. package/src/components/ui/field-grid.tsx +0 -2
  94. package/src/components/ui/fields.tsx +7 -4
  95. package/src/components/ui/inline-quick-add.tsx +2 -2
  96. package/src/components/ui/key-hint-words.ts +153 -0
  97. package/src/components/ui/key-hints.tsx +73 -0
  98. package/src/components/ui/menu.tsx +3 -1
  99. package/src/components/ui/message-composer.tsx +2 -2
  100. package/src/components/ui/shortcut-hint.tsx +28 -3
  101. package/src/components/ui/tabs.tsx +7 -0
  102. package/src/components/ui/text-prompt-dialog.tsx +2 -1
  103. package/src/core/state/app/command-bar-launch.ts +3 -0
  104. package/src/data/config/store/normalize.ts +6 -0
  105. package/src/docs/snapshot.json +120 -69
  106. package/src/i18n/es.ts +24 -1
  107. package/src/i18n/ja.ts +24 -1
  108. package/src/i18n/ko.ts +24 -1
  109. package/src/i18n/zh-cn.ts +24 -1
  110. package/src/i18n/zh-tw.ts +24 -1
  111. package/src/layout/pane-manager/gridlock.ts +11 -0
  112. package/src/market-data/bars-per-year.ts +27 -9
  113. package/src/market-data/coordinator/quotes.ts +22 -3
  114. package/src/market-data/futures-board.ts +80 -0
  115. package/src/market-data/futures-contract.ts +9 -3
  116. package/src/market-data/market/change-basis.ts +2 -2
  117. package/src/market-data/market/dated-previous-close.ts +163 -47
  118. package/src/market-data/market/format.ts +14 -3
  119. package/src/market-data/market/freshness.ts +24 -7
  120. package/src/market-data/market/header-market.ts +154 -0
  121. package/src/market-data/market/index-level.ts +29 -0
  122. package/src/market-data/market/index-session-venues.ts +44 -0
  123. package/src/market-data/market/status.ts +7 -2
  124. package/src/market-data/market/venue-session.ts +72 -0
  125. package/src/market-data/model-dividend-yield.ts +23 -8
  126. package/src/market-data/options-alternatives.ts +39 -4
  127. package/src/market-data/published-apac-sessions.ts +40 -2
  128. package/src/market-data/quotes/export-identity.ts +76 -0
  129. package/src/market-data/quotes/freshness.ts +22 -0
  130. package/src/market-data/quotes/time.ts +42 -1
  131. package/src/market-data/realized-volatility.ts +11 -7
  132. package/src/market-data/tax-equivalent.ts +145 -27
  133. package/src/plugins/builtin/account-management/pane.tsx +2 -2
  134. package/src/plugins/builtin/alerts/alert-engine.ts +12 -6
  135. package/src/plugins/builtin/alerts/alert-log.ts +6 -2
  136. package/src/plugins/builtin/alerts/calendar-events.ts +74 -12
  137. package/src/plugins/builtin/alerts/cli-forms.ts +11 -1
  138. package/src/plugins/builtin/alerts/cli-move.ts +234 -0
  139. package/src/plugins/builtin/alerts/cli.ts +224 -33
  140. package/src/plugins/builtin/alerts/command.ts +33 -6
  141. package/src/plugins/builtin/alerts/event-rows.ts +18 -4
  142. package/src/plugins/builtin/alerts/events-pane.tsx +6 -2
  143. package/src/plugins/builtin/alerts/events.ts +9 -0
  144. package/src/plugins/builtin/alerts/format.ts +40 -15
  145. package/src/plugins/builtin/alerts/headless.ts +31 -18
  146. package/src/plugins/builtin/alerts/history.ts +1 -0
  147. package/src/plugins/builtin/alerts/index.tsx +86 -12
  148. package/src/plugins/builtin/alerts/live.ts +2 -1
  149. package/src/plugins/builtin/alerts/move-checks.ts +155 -0
  150. package/src/plugins/builtin/alerts/move.ts +160 -0
  151. package/src/plugins/builtin/alerts/pane.tsx +52 -22
  152. package/src/plugins/builtin/alerts/price-text.ts +62 -0
  153. package/src/plugins/builtin/alerts/price.ts +17 -0
  154. package/src/plugins/builtin/alerts/quotes.ts +84 -3
  155. package/src/plugins/builtin/alerts/scheduled-check.ts +7 -1
  156. package/src/plugins/builtin/alerts/storage.ts +20 -7
  157. package/src/plugins/builtin/alerts/types.ts +13 -0
  158. package/src/plugins/builtin/analytics/risk-client.ts +60 -39
  159. package/src/plugins/builtin/analytics/risk-episodes.ts +18 -0
  160. package/src/plugins/builtin/analytics/risk-headless.ts +20 -4
  161. package/src/plugins/builtin/analytics/risk-model.ts +68 -1
  162. package/src/plugins/builtin/analytics/risk-pane.tsx +15 -3
  163. package/src/plugins/builtin/backtest/engine.ts +4 -2
  164. package/src/plugins/builtin/backtest/window.ts +3 -1
  165. package/src/plugins/builtin/broker-manager/sign-in-end.ts +1 -1
  166. package/src/plugins/builtin/central-bank-rates/client.ts +4 -0
  167. package/src/plugins/builtin/central-bank-rates/headless.ts +1 -1
  168. package/src/plugins/builtin/central-bank-rates/model.ts +18 -8
  169. package/src/plugins/builtin/central-bank-rates/pane.tsx +6 -3
  170. package/src/plugins/builtin/chart-composer/cli-options.ts +5 -0
  171. package/src/plugins/builtin/chart-composer/headless-schema.ts +17 -1
  172. package/src/plugins/builtin/chart-composer/headless.ts +2 -0
  173. package/src/plugins/builtin/cloud/upgrade-status-widget.tsx +9 -2
  174. package/src/plugins/builtin/crypto-board/headless.ts +82 -17
  175. package/src/plugins/builtin/crypto-board/index.tsx +24 -2
  176. package/src/plugins/builtin/crypto-board/model.ts +5 -2
  177. package/src/plugins/builtin/crypto-board/pane.tsx +4 -1
  178. package/src/plugins/builtin/debt-maturities/client.ts +111 -6
  179. package/src/plugins/builtin/debt-maturities/headless.ts +84 -1
  180. package/src/plugins/builtin/debt-maturities/model.ts +97 -14
  181. package/src/plugins/builtin/debt-maturities/pane.tsx +165 -15
  182. package/src/plugins/builtin/debt-maturities/series.ts +3 -1
  183. package/src/plugins/builtin/dividend-yield/client.ts +22 -6
  184. package/src/plugins/builtin/dividend-yield/headless.ts +113 -46
  185. package/src/plugins/builtin/dividend-yield/model.ts +5 -2
  186. package/src/plugins/builtin/dividend-yield/pane.tsx +6 -3
  187. package/src/plugins/builtin/dividend-yield/ranking-reads.ts +11 -4
  188. package/src/plugins/builtin/dividend-yield/ranking.ts +113 -18
  189. package/src/plugins/builtin/dividend-yield/types.ts +2 -0
  190. package/src/plugins/builtin/dividend-yield/view.ts +3 -0
  191. package/src/plugins/builtin/econ/calendar-model.ts +21 -3
  192. package/src/plugins/builtin/econ/detail-view.tsx +5 -3
  193. package/src/plugins/builtin/econ/figures.ts +13 -0
  194. package/src/plugins/builtin/econ/fred-catalog.ts +6 -3
  195. package/src/plugins/builtin/econ/index.tsx +5 -3
  196. package/src/plugins/builtin/econ/types.ts +5 -0
  197. package/src/plugins/builtin/equity-screener/footer.ts +45 -0
  198. package/src/plugins/builtin/equity-screener/pane.tsx +4 -18
  199. package/src/plugins/builtin/equity-screener/ticker-check.tsx +2 -1
  200. package/src/plugins/builtin/fixed-income/model.ts +1 -0
  201. package/src/plugins/builtin/futures/table.tsx +1 -1
  202. package/src/plugins/builtin/futures-curve/model.ts +3 -10
  203. package/src/plugins/builtin/help/function-card.tsx +2 -1
  204. package/src/plugins/builtin/help/function-index.ts +1 -0
  205. package/src/plugins/builtin/insider/client.ts +31 -14
  206. package/src/plugins/builtin/insider/signals-model.ts +2 -7
  207. package/src/plugins/builtin/iv-history/headless.ts +1 -2
  208. package/src/plugins/builtin/iv-history/model.ts +33 -23
  209. package/src/plugins/builtin/iv-history/screen-pane.tsx +0 -3
  210. package/src/plugins/builtin/kelly-sizer/headless.ts +64 -16
  211. package/src/plugins/builtin/kelly-sizer/history.ts +37 -28
  212. package/src/plugins/builtin/kelly-sizer/pane.tsx +43 -10
  213. package/src/plugins/builtin/kelly-sizer/sections.tsx +7 -2
  214. package/src/plugins/builtin/kelly-sizer/units.ts +29 -0
  215. package/src/plugins/builtin/news/index.tsx +7 -13
  216. package/src/plugins/builtin/news/overview-headlines.tsx +117 -0
  217. package/src/plugins/builtin/news/ticker-news.ts +35 -0
  218. package/src/plugins/builtin/news/wire/news/detail-view.tsx +8 -6
  219. package/src/plugins/builtin/news/wire/news/row.ts +49 -0
  220. package/src/plugins/builtin/news/wire/news/table.tsx +9 -20
  221. package/src/plugins/builtin/options/analytics.ts +7 -2
  222. package/src/plugins/builtin/options/live-quotes.ts +6 -1
  223. package/src/plugins/builtin/options/table.ts +3 -2
  224. package/src/plugins/builtin/options/view.tsx +11 -9
  225. package/src/plugins/builtin/options-scenario/client.ts +3 -0
  226. package/src/plugins/builtin/options-scenario/headless.ts +1 -1
  227. package/src/plugins/builtin/perps/client.ts +5 -4
  228. package/src/plugins/builtin/perps/headless.ts +134 -124
  229. package/src/plugins/builtin/perps/markets-section.tsx +2 -2
  230. package/src/plugins/builtin/perps/model.ts +8 -4
  231. package/src/plugins/builtin/perps/open-market.ts +4 -4
  232. package/src/plugins/builtin/perps/venue-markets.ts +3 -6
  233. package/src/plugins/builtin/portfolio-list/cell-version.ts +1 -0
  234. package/src/plugins/builtin/portfolio-list/cli/bulk-symbols.ts +34 -10
  235. package/src/plugins/builtin/portfolio-list/cli/period-report.ts +28 -2
  236. package/src/plugins/builtin/portfolio-list/cli/portfolio-command.ts +7 -3
  237. package/src/plugins/builtin/portfolio-list/cli/render.ts +66 -22
  238. package/src/plugins/builtin/portfolio-list/grid.tsx +5 -3
  239. package/src/plugins/builtin/portfolio-list/pane/data.ts +34 -1
  240. package/src/plugins/builtin/portfolio-list/pane/index.tsx +6 -0
  241. package/src/plugins/builtin/portfolio-list/pane/streaming.ts +15 -6
  242. package/src/plugins/builtin/portfolio-list/quick-add/resolution.ts +19 -7
  243. package/src/plugins/builtin/portfolio-list/table.tsx +30 -4
  244. package/src/plugins/builtin/realized-vol/evidence.ts +33 -6
  245. package/src/plugins/builtin/realized-vol/fx-proxy.ts +135 -0
  246. package/src/plugins/builtin/realized-vol/headless.ts +44 -8
  247. package/src/plugins/builtin/realized-vol/model.ts +9 -5
  248. package/src/plugins/builtin/realized-vol/pane.tsx +49 -15
  249. package/src/plugins/builtin/sec/headless.ts +48 -6
  250. package/src/plugins/builtin/sec/index.tsx +6 -4
  251. package/src/plugins/builtin/sec/model.ts +4 -1
  252. package/src/plugins/builtin/shared/earnings-calendar.ts +2 -0
  253. package/src/plugins/builtin/shared/market-cap-bands.ts +12 -0
  254. package/src/plugins/builtin/shared/report-freshness.ts +3 -1
  255. package/src/plugins/builtin/shared/use-quote-board.ts +5 -3
  256. package/src/plugins/builtin/shared/volatility/options.ts +63 -2
  257. package/src/plugins/builtin/social-mentions/headless.ts +72 -3
  258. package/src/plugins/builtin/social-mentions/index.tsx +8 -4
  259. package/src/plugins/builtin/social-mentions/lock-note.ts +6 -2
  260. package/src/plugins/builtin/social-mentions/outliers-client.ts +101 -0
  261. package/src/plugins/builtin/social-mentions/outliers-model.ts +162 -0
  262. package/src/plugins/builtin/social-mentions/outliers-names.ts +51 -0
  263. package/src/plugins/builtin/social-mentions/outliers.tsx +276 -0
  264. package/src/plugins/builtin/social-mentions/pane.tsx +32 -3
  265. package/src/plugins/builtin/supply-chain/graph-pane.tsx +2 -2
  266. package/src/plugins/builtin/thirteenf/api.ts +36 -2
  267. package/src/plugins/builtin/thirteenf/data.ts +4 -1
  268. package/src/plugins/builtin/thirteenf/headless.ts +14 -6
  269. package/src/plugins/builtin/thirteenf/model.ts +56 -1
  270. package/src/plugins/builtin/thirteenf/pane.tsx +8 -8
  271. package/src/plugins/builtin/thirteenf/report-notes.ts +11 -0
  272. package/src/plugins/builtin/thirteenf/table.ts +2 -1
  273. package/src/plugins/builtin/thirteenf/types.ts +6 -0
  274. package/src/plugins/builtin/ticker-detail/data-panes/historical-prices.tsx +23 -3
  275. package/src/plugins/builtin/ticker-detail/financials/model.ts +5 -0
  276. package/src/plugins/builtin/ticker-detail/headless-schema.ts +2 -1
  277. package/src/plugins/builtin/ticker-detail/headless.ts +21 -66
  278. package/src/plugins/builtin/ticker-detail/index.tsx +5 -0
  279. package/src/plugins/builtin/ticker-detail/overview/components.tsx +13 -1
  280. package/src/plugins/builtin/ticker-detail/overview/model.ts +6 -4
  281. package/src/plugins/builtin/ticker-detail/overview/pane.tsx +15 -0
  282. package/src/plugins/builtin/ticker-detail/overview/tax-equivalent.ts +69 -0
  283. package/src/plugins/builtin/ticker-detail/overview-tab.tsx +41 -6
  284. package/src/plugins/builtin/ticker-detail/quote-monitor/card.tsx +47 -24
  285. package/src/plugins/builtin/ticker-detail/quote-monitor/export.ts +46 -0
  286. package/src/plugins/builtin/ticker-detail/quote-monitor/index.tsx +20 -1
  287. package/src/plugins/builtin/ticker-detail/quote-monitor/rows.ts +120 -0
  288. package/src/plugins/builtin/ticker-detail/research-tabs.ts +1 -5
  289. package/src/plugins/builtin/ticker-detail/settings.ts +6 -6
  290. package/src/plugins/builtin/treasury-auctions/cache.ts +85 -19
  291. package/src/plugins/builtin/treasury-auctions/index.tsx +22 -11
  292. package/src/plugins/builtin/treasury-auctions/model.ts +23 -0
  293. package/src/plugins/builtin/treasury-auctions/treasury-direct.ts +128 -0
  294. package/src/plugins/builtin/world-indices/client.ts +2 -0
  295. package/src/plugins/compat.ts +15 -0
  296. package/src/plugins/host-link.ts +6 -1
  297. package/src/plugins/installer.ts +8 -3
  298. package/src/portfolio/column-values.ts +14 -4
  299. package/src/portfolio/listed-symbol.ts +78 -0
  300. package/src/portfolio/real-return.ts +172 -0
  301. package/src/public/__snapshots__/public-api.test.ts.snap +1 -0
  302. package/src/renderers/browser/config-host.ts +56 -15
  303. package/src/renderers/browser/main.tsx +3 -1
  304. package/src/renderers/browser/ui-host.tsx +1 -0
  305. package/src/renderers/cloudflare/http-proxy.ts +1 -0
  306. package/src/renderers/dom/boot-frame.ts +2 -2
  307. package/src/renderers/dom/data-table/row.tsx +4 -1
  308. package/src/renderers/dom/desktop/controls.tsx +4 -4
  309. package/src/renderers/dom/desktop/dialog-actions.tsx +60 -41
  310. package/src/renderers/dom/dom-ui-host.tsx +3 -1
  311. package/src/renderers/dom/host/input.tsx +4 -1
  312. package/src/renderers/dom/host/tabs.tsx +10 -1
  313. package/src/renderers/dom/styles.css +33 -13
  314. package/src/renderers/electrobun/bun/desktop/app-name.ts +1 -1
  315. package/src/renderers/opentui/host.tsx +2 -1
  316. package/src/sources/gloomberb-cloud/fred-series.ts +12 -0
  317. package/src/sources/gloomberb-cloud/index.ts +31 -2
  318. package/src/sources/gloomberb-cloud/normalizers.ts +29 -3
  319. package/src/sources/provider-router/cached-routes.ts +19 -7
  320. package/src/state/pane-table-export-registry.ts +19 -6
  321. package/src/test-support/preload.ts +5 -1
  322. package/src/theme/colors.ts +9 -1
  323. package/src/theme/themes.ts +62 -15
  324. package/src/theme/tone-contrast.ts +40 -0
  325. package/src/theme/ui-tokens.ts +23 -3
  326. package/src/tickers/batched-lookups.ts +57 -8
  327. package/src/tickers/company-name-listing.ts +156 -14
  328. package/src/tickers/company-name.ts +30 -6
  329. package/src/tickers/list.ts +7 -0
  330. package/src/tickers/search/home-listing.ts +31 -9
  331. package/src/tickers/search/index.ts +13 -3
  332. package/src/tickers/search/listing-index.ts +558 -0
  333. package/src/tickers/search/major-listings.chunk.ts +10 -0
  334. package/src/tickers/search/major-listings.json +3346 -0
  335. package/src/tickers/search/ranking.ts +68 -1
  336. package/src/tickers/search/types.ts +4 -0
  337. package/src/tickers/terminal-codes.ts +26 -1
  338. package/src/time-series/calendar-month-returns.ts +47 -0
  339. package/src/time-series/currency-conversion.ts +130 -0
  340. package/src/time-series/hooks.ts +2 -0
  341. package/src/time-series/price-comparison.ts +34 -11
  342. package/src/time-series/resolve-context.ts +3 -0
  343. package/src/time-series/resolve.ts +14 -2
  344. package/src/time-series/spec.ts +1 -0
  345. package/src/time-series/studies/indicators.ts +4 -1
  346. package/src/time-series/types.ts +8 -0
  347. package/src/types/config.ts +8 -0
  348. package/src/types/data-provider.ts +28 -0
  349. package/src/types/financials.ts +20 -2
  350. package/src/types/headless.ts +12 -0
  351. package/src/ui/host.tsx +8 -0
  352. package/src/utils/datetime-format.ts +17 -3
  353. package/src/utils/display-number.ts +15 -0
  354. package/src/utils/double-escape-close.ts +61 -16
  355. package/src/utils/float32-price.ts +24 -0
  356. package/src/utils/forward-dividend.ts +81 -16
  357. package/src/utils/fx-market-hours.ts +11 -0
  358. package/src/utils/plugin-proxy-hosts.json +2 -1
  359. package/src/utils/price-history.ts +7 -6
  360. package/src/utils/report-timing.ts +62 -0
  361. package/src/utils/sec-filings.ts +32 -0
  362. package/src/utils/utc-time.ts +5 -0
@@ -2,8 +2,8 @@ import type { HeadlessPaneDefinition, HeadlessPaneRow } from "../../../types/hea
2
2
  import { resolveHeadlessInstrument } from "../shared/headless-market-data";
3
3
  import { MarketDataCoordinator, resolveEntryValue } from "../../../market-data/coordinator";
4
4
  import { parseHedgeAmount } from "../options-scenario/hedge";
5
- import { clipPriceHistoryToRange } from "../../../time-series/history-window";
6
- import { formatNumber } from "../../../utils/format";
5
+ import { convertCurrency, formatNumber } from "../../../utils/format";
6
+ import { fxRateCurrencies } from "../../../utils/currency-units";
7
7
  import { buildBinaryOutcomes, solveKellyFraction } from "./model";
8
8
  import {
9
9
  clampKellyHistoryYears,
@@ -11,12 +11,15 @@ import {
11
11
  KELLY_HISTORY_DEFAULT_YEARS,
12
12
  KELLY_HISTORY_MAX_YEARS,
13
13
  KELLY_HISTORY_MIN_PERIODS,
14
- kellyHistoryRange,
15
14
  kellyHistoryRequest,
15
+ kellyTrailingHistoryRequest,
16
16
  type KellyHistoryInputs,
17
17
  } from "./history";
18
+ import { historyReadUnanswered } from "../../../time-series/calendar-month-returns";
18
19
  import { formatPct, formatSignedPct } from "./view";
19
20
  import { logFailure } from "../../../utils/log-failure";
21
+ import { loadFuturesContractTerms } from "../../../market-data/futures-contract";
22
+ import { kellyCount, kellyCountMultiplier, type KellyCount } from "./units";
20
23
 
21
24
  /** The fractions of full Kelly a report sizes, largest first. */
22
25
  const KELLY_FRACTIONS = [
@@ -40,6 +43,25 @@ function inputEntries(inputs: KellyHistoryInputs, edge: number) {
40
43
  ];
41
44
  }
42
45
 
46
+ const COUNT_HEADER: Record<KellyCount, string> = { shares: "Shares", units: "Units", contracts: "Contracts" };
47
+
48
+ /**
49
+ * `price` in the base currency at the rates the portfolio values holdings at
50
+ * (USD per unit, from the same FX store); null when either rate is missing.
51
+ */
52
+ async function priceInBase(price: number, currency: string | undefined, baseCurrency: string, coordinator: MarketDataCoordinator): Promise<number | null> {
53
+ if (!currency) return null;
54
+ if (currency === baseCurrency) return price;
55
+ const rates = new Map([["USD", 1]]);
56
+ await Promise.all(fxRateCurrencies([currency, baseCurrency]).filter((code) => code !== "USD").map(async (code) => {
57
+ const entry = await coordinator.loadFxRate(code).catch(logFailure("kelly-sizer.headless", "Load the exchange rate for Kelly units failed", null));
58
+ const rate = entry ? resolveEntryValue(entry) : null;
59
+ if (rate != null) rates.set(code, rate);
60
+ }));
61
+ const converted = convertCurrency(price, currency, baseCurrency, rates);
62
+ return Number.isFinite(converted) && converted > 0 ? converted : null;
63
+ }
64
+
43
65
  export const kellyHeadless: HeadlessPaneDefinition<"bundle"> = {
44
66
  shape: "bundle",
45
67
  argument: { kind: "ticker", description: "Ticker to size" },
@@ -47,8 +69,8 @@ export const kellyHeadless: HeadlessPaneDefinition<"bundle"> = {
47
69
  description: "Kelly sizing for a ticker from its own monthly returns: win rate, payoff ratio and edge over a lookback, then full, half and quarter Kelly as a share of a bankroll.",
48
70
  describe: (args) => `Kelly sizing | ${args.symbols[0] ?? ""}`,
49
71
  discovery: {
50
- dataRequirements: ["Gloom Cloud daily closes over the lookback, and the latest quote for share counts"],
51
- limitations: ["Win rate, gain and loss are the ticker's own non-overlapping 21-session returns; past months are not a forecast."],
72
+ dataRequirements: ["Gloom Cloud daily closes over the lookback, the latest quote for share or unit counts, and the exchange rate to the base currency"],
73
+ limitations: ["Win rate, gain and loss are the ticker's own calendar-month returns, month-end close to month-end close; past months are not a forecast."],
52
74
  },
53
75
  options: [
54
76
  {
@@ -73,16 +95,23 @@ export const kellyHeadless: HeadlessPaneDefinition<"bundle"> = {
73
95
  async load(args, ctx) {
74
96
  const { symbol, exchange = "" } = await resolveHeadlessInstrument(ctx, args.symbols[0]!);
75
97
  const years = clampKellyHistoryYears(args.options.years);
76
- const range = kellyHistoryRange(years);
77
98
  // The quote and the one history window the lookback needs load together, through the
78
99
  // coordinator every chart reads daily closes from (the History tab's request, cache included).
100
+ const coordinator = new MarketDataCoordinator(ctx.marketData);
101
+ const loadHistory = async () => {
102
+ const dated = await coordinator.loadChart(kellyHistoryRequest({ symbol, exchange }, years), { forceRefresh: ctx.refresh });
103
+ // A source with no dated history answers from its trailing range, as the History tab does.
104
+ return historyReadUnanswered(dated)
105
+ ? coordinator.loadChart(kellyTrailingHistoryRequest({ symbol, exchange }, years), { forceRefresh: ctx.refresh })
106
+ : dated;
107
+ };
79
108
  const [entry, quote] = await Promise.all([
80
- new MarketDataCoordinator(ctx.marketData).loadChart(kellyHistoryRequest({ symbol, exchange }, years), { forceRefresh: ctx.refresh }),
109
+ loadHistory(),
81
110
  ctx.marketData.getQuote(symbol, exchange, ctx.refresh ? { cacheMode: "refresh" } : undefined).catch(logFailure("kelly-sizer.headless", "Load Kelly sizing quote failed", null)),
82
111
  ]);
83
- const history = clipPriceHistoryToRange(resolveEntryValue(entry) ?? [], range);
112
+ const history = resolveEntryValue(entry) ?? [];
84
113
  ctx.signal.throwIfAborted();
85
- const inputs = estimateKellyHistoryInputs(history, years);
114
+ const inputs = estimateKellyHistoryInputs(history, years, { exchange });
86
115
  if (!inputs) {
87
116
  return {
88
117
  complete: false,
@@ -96,17 +125,27 @@ export const kellyHeadless: HeadlessPaneDefinition<"bundle"> = {
96
125
  const bankroll = typeof bankrollValue === "number" && bankrollValue > 0 ? bankrollValue : null;
97
126
  const baseCurrency = ctx.config.baseCurrency || "USD";
98
127
  const price = quote && quote.price > 0 && Number.isFinite(quote.price) ? quote.price : null;
99
- // Shares only when the bankroll and the price are in one currency.
100
- const sharePrice = price != null && quote?.currency === baseCurrency ? price : null;
128
+ // A future is counted in contracts, each its price times the contract's multiplier.
129
+ const count = kellyCount(symbol, exchange, quote?.instrumentType);
130
+ const [multiplier, basePrice] = bankroll == null || price == null ? [null, null] : await Promise.all([
131
+ kellyCountMultiplier(symbol, count, (key) => loadFuturesContractTerms(key, ctx.apiClient)),
132
+ // The price in the bankroll's currency, at the rate the portfolio values holdings at; null without one.
133
+ priceInBase(price, quote?.currency, baseCurrency, coordinator),
134
+ ]);
135
+ const unitPrice = basePrice == null || multiplier == null ? null : basePrice * multiplier;
136
+ // A coin is divisible and sized to a hundredth; shares and contracts whole.
137
+ const coin = count === "units";
138
+ const units = COUNT_HEADER[count];
101
139
  const rows: HeadlessPaneRow[] = KELLY_FRACTIONS.map(({ id, label, fraction }) => {
102
140
  const share = solve.fraction * fraction;
103
141
  const position = bankroll == null ? null : share * bankroll;
142
+ const held = position != null && unitPrice != null ? position / unitPrice : null;
104
143
  return {
105
144
  id,
106
145
  kelly: label,
107
146
  fraction: share,
108
147
  position,
109
- shares: position != null && sharePrice != null ? Math.floor(position / sharePrice) : null,
148
+ shares: held == null ? null : coin ? Math.floor(held * 100) / 100 : Math.floor(held),
110
149
  };
111
150
  });
112
151
  // A fraction over the whole bankroll is a levered position.
@@ -117,10 +156,16 @@ export const kellyHeadless: HeadlessPaneDefinition<"bundle"> = {
117
156
  ...(levered.length ? [`Over 100% of bankroll means leverage, borrowing or margin beyond what you hold: ${levered.join(", ")}.`] : []),
118
157
  ...(solve.fraction === 0 ? ["No positive edge over this window: every Kelly fraction sizes nothing."] : []),
119
158
  ...(bankroll == null ? [`Add --bankroll <amount> to size each fraction in ${baseCurrency}.`] : []),
159
+ ...(bankroll != null && price != null && multiplier == null
160
+ ? [`No contract size for ${symbol} to count contracts in: each position is in ${baseCurrency} only.`]
161
+ : bankroll != null && price != null && basePrice == null
162
+ ? [`No ${quote?.currency || "quote"} to ${baseCurrency} rate to count ${count} in: each position is in ${baseCurrency} only.`]
163
+ : []),
120
164
  ];
121
165
  return {
122
166
  complete: true,
123
- freshness: { asOf: inputs.end },
167
+ // Dated by the newest close read: the months stop at the last one that has ended.
168
+ freshness: { asOf: inputs.latest },
124
169
  notes,
125
170
  sections: [
126
171
  { title: "Inputs", entries: inputEntries(inputs, solve.expectedReturn) },
@@ -132,8 +177,8 @@ export const kellyHeadless: HeadlessPaneDefinition<"bundle"> = {
132
177
  ...(bankroll == null ? [] : [
133
178
  { key: "position", header: `Position ${baseCurrency}`, align: "right" as const,
134
179
  format: (value: unknown) => typeof value === "number" ? formatNumber(value, 0) : "--" },
135
- ...(sharePrice == null ? [] : [{ key: "shares", header: "Shares", align: "right" as const,
136
- format: (value: unknown) => typeof value === "number" ? formatNumber(value, 0) : "--" }]),
180
+ ...(unitPrice == null ? [] : [{ key: "shares", header: units, align: "right" as const,
181
+ format: (value: unknown) => typeof value === "number" ? formatNumber(value, coin ? 2 : 0) : "--" }]),
137
182
  ]),
138
183
  ],
139
184
  rows,
@@ -147,7 +192,10 @@ export const kellyHeadless: HeadlessPaneDefinition<"bundle"> = {
147
192
  bankroll,
148
193
  currency: baseCurrency,
149
194
  price: price == null ? null : { value: price, currency: quote?.currency ?? null, asOf: quote?.lastUpdated ?? null },
150
- method: "Binary Kelly on non-overlapping 21-session returns: win rate, mean gain and mean loss.",
195
+ ...(basePrice != null && quote?.currency !== baseCurrency ? { priceInBase: { value: basePrice, currency: baseCurrency } } : {}),
196
+ ...(count === "contracts" && multiplier != null ? { contractMultiplier: multiplier } : {}),
197
+ units: count,
198
+ method: "Binary Kelly on calendar-month returns, month-end close to month-end close: win rate, mean gain and mean loss.",
151
199
  },
152
200
  };
153
201
  },
@@ -1,17 +1,13 @@
1
1
  import type { PricePoint } from "../../../types/financials";
2
- import type { TimeRange } from "../../../time-series/range";
3
2
  import type { ChartRequest, InstrumentRef } from "../../../market-data/request-types";
4
- import { getPricePointTimestamp } from "../../../utils/price-history";
3
+ import { dailyBarDate, getPricePointTimestamp } from "../../../utils/price-history";
4
+ import { calendarMonthReturnsRequest, trailingDailyClosesRequest, venueMonth } from "../../../time-series/calendar-month-returns";
5
5
 
6
- /** Sessions in one holding period: a month of trading days. */
7
- export const KELLY_HISTORY_PERIOD_SESSIONS = 21;
8
6
  export const KELLY_HISTORY_DEFAULT_YEARS = 5;
9
7
  export const KELLY_HISTORY_MAX_YEARS = 5;
10
8
  /** Fewer monthly returns than this say too little about a win rate to size on. */
11
9
  export const KELLY_HISTORY_MIN_PERIODS = 6;
12
10
 
13
- const YEAR_MS = 365.25 * 24 * 60 * 60_000;
14
-
15
11
  /** The binary inputs a ticker's own monthly returns imply over a lookback window. */
16
12
  export interface KellyHistoryInputs {
17
13
  winProbability: number;
@@ -22,9 +18,11 @@ export interface KellyHistoryInputs {
22
18
  /** Up months over all months. */
23
19
  wins: number;
24
20
  periods: number;
25
- /** Close the first return starts from, and the last bar, as YYYY-MM-DD. */
21
+ /** The month-end close the first return starts from, and the one the last return ends on, as YYYY-MM-DD. */
26
22
  start: string;
27
23
  end: string;
24
+ /** The newest daily close read, which a month in progress may follow, as YYYY-MM-DD. */
25
+ latest: string;
28
26
  years: number;
29
27
  }
30
28
 
@@ -33,36 +31,46 @@ export function clampKellyHistoryYears(value: unknown): number {
33
31
  return Number.isFinite(years) ? Math.min(KELLY_HISTORY_MAX_YEARS, Math.max(1, years)) : KELLY_HISTORY_DEFAULT_YEARS;
34
32
  }
35
33
 
36
- /** The shortest history range that covers the lookback, so a one-year window never loads five. */
37
- export function kellyHistoryRange(years: number): TimeRange {
38
- return clampKellyHistoryYears(years) <= 1 ? "1Y" : "5Y";
34
+ /** KELLY's dated daily closes (`calendarMonthReturnsRequest`) over a lookback clamped to its one to five years. */
35
+ export function kellyHistoryRequest(instrument: InstrumentRef, years: number, now = Date.now()): ChartRequest {
36
+ return calendarMonthReturnsRequest(instrument, clampKellyHistoryYears(years), now);
39
37
  }
40
38
 
41
- /** The daily closes the History tab and the KELLY report both read. */
42
- export function kellyHistoryRequest(instrument: InstrumentRef, years: number): ChartRequest {
43
- return { instrument, bufferRange: kellyHistoryRange(years), granularity: "resolution", resolution: "1d" };
39
+ /** The trailing range the History tab and the KELLY report both fall back to without dated closes. */
40
+ export function kellyTrailingHistoryRequest(instrument: InstrumentRef, years: number): ChartRequest {
41
+ return trailingDailyClosesRequest(instrument, clampKellyHistoryYears(years));
44
42
  }
45
43
 
46
- const dateKey = (time: number) => new Date(time).toISOString().slice(0, 10);
47
-
48
44
  /**
49
- * Win rate, mean gain and mean loss of non-overlapping 21-session returns,
50
- * counted back from the last daily close so the newest month is complete.
51
- * Null when the window holds fewer than `KELLY_HISTORY_MIN_PERIODS` of them,
52
- * or every one of them is a gain, or every one of them is a loss.
45
+ * Win rate, mean gain and mean loss of calendar-month returns: each month's
46
+ * last close against the month before's, for every asset, so a coin that
47
+ * trades every day and a stock that trades on weekdays are sized on the same
48
+ * months. A month counts once it has ended (`now` is in a later month), so a
49
+ * month in progress is never a return; the newest `years` × 12 complete
50
+ * months are used. Days and the month now are the venue's (`exchange`), a
51
+ * coin's UTC, so a month that has ended in Tokyo counts before it has in UTC. Null
52
+ * when that leaves fewer than `KELLY_HISTORY_MIN_PERIODS` returns, or every
53
+ * one of them is a gain, or every one of them is a loss.
53
54
  */
54
- export function estimateKellyHistoryInputs(points: readonly PricePoint[], yearsInput: number): KellyHistoryInputs | null {
55
+ export function estimateKellyHistoryInputs(
56
+ points: readonly PricePoint[],
57
+ yearsInput: number,
58
+ options: { exchange?: string; now?: number } = {},
59
+ ): KellyHistoryInputs | null {
55
60
  const years = clampKellyHistoryYears(yearsInput);
61
+ const now = venueMonth(options.now ?? Date.now(), options.exchange ?? "");
62
+ const thisMonth = `${now.year}-${String(now.month).padStart(2, "0")}`;
63
+ const monthEnds = new Map<string, { day: string; close: number }>();
56
64
  const closes = points
57
65
  .map((point) => ({ time: getPricePointTimestamp(point), close: point.close }))
58
66
  .filter((point) => Number.isFinite(point.time) && Number.isFinite(point.close) && point.close > 0)
59
67
  .sort((left, right) => left.time - right.time);
60
- const last = closes.at(-1);
61
- if (!last) return null;
62
- const cutoff = last.time - years * YEAR_MS;
63
- const window = closes.filter((point) => point.time >= cutoff);
64
- const picks: typeof window = [];
65
- for (let index = window.length - 1; index >= 0; index -= KELLY_HISTORY_PERIOD_SESSIONS) picks.unshift(window[index]!);
68
+ for (const point of closes) {
69
+ const day = dailyBarDate(point.time, options.exchange ?? "");
70
+ // Sorted oldest first, so each month keeps its last close.
71
+ if (day.slice(0, 7) < thisMonth) monthEnds.set(day.slice(0, 7), { day, close: point.close });
72
+ }
73
+ const picks = [...monthEnds.values()].slice(-(years * 12 + 1));
66
74
  const returns = picks.slice(1).map((point, index) => point.close / picks[index]!.close - 1);
67
75
  if (returns.length < KELLY_HISTORY_MIN_PERIODS) return null;
68
76
  const gains = returns.filter((value) => value > 0);
@@ -75,8 +83,9 @@ export function estimateKellyHistoryInputs(points: readonly PricePoint[], yearsI
75
83
  downsideReturn: mean(losses),
76
84
  wins: gains.length,
77
85
  periods: returns.length,
78
- start: dateKey(picks[0]!.time),
79
- end: dateKey(last.time),
86
+ start: picks[0]!.day,
87
+ end: picks.at(-1)!.day,
88
+ latest: dailyBarDate(closes.at(-1)!.time, options.exchange ?? ""),
80
89
  years,
81
90
  };
82
91
  }
@@ -20,7 +20,6 @@ import {
20
20
  import type { PaneProps } from "../../../types/plugin";
21
21
  import { useChartQueries, useFxRatesMap, useResolvedEntryValue } from "../../../market-data/hooks";
22
22
  import { buildChartKey } from "../../../market-data/selectors";
23
- import { clipPriceHistoryToRange } from "../../../time-series/history-window";
24
23
  import { useLiveTickerFinancials, useLiveTickerFinancialsMap } from "../../../state/hooks/live-ticker-financials";
25
24
  import { buildPortfolioFinancialsMap } from "../../../market-data/portfolio-financials";
26
25
  import { convertCurrency, formatCurrency } from "../../../utils/format";
@@ -66,9 +65,11 @@ import {
66
65
  estimateKellyHistoryInputs,
67
66
  KELLY_HISTORY_DEFAULT_YEARS,
68
67
  KELLY_HISTORY_MIN_PERIODS,
69
- kellyHistoryRange,
70
68
  kellyHistoryRequest,
69
+ kellyTrailingHistoryRequest,
71
70
  } from "./history";
71
+ import { historyReadUnanswered } from "../../../time-series/calendar-month-returns";
72
+ import { kellyCount, kellyCountMultiplier } from "./units";
72
73
  import { KELLY_PANE_ID } from "./constants";
73
74
  import {
74
75
  buildKellyCurveXAxisLabels,
@@ -240,9 +241,11 @@ export function KellySizerPane({ focused, width, height }: PaneProps) {
240
241
  const { accountState } = usePortfolioAccountState(activePortfolio, { brokerAccounts, config });
241
242
  // Cash entered by hand counts toward a manual portfolio's bankroll; a broker's is in its Net Liq.
242
243
  const manualCash = accountState ? null : resolvePortfolioCash(activePortfolio, null);
244
+ // The sized ticker's own currency too: its units are counted at the base currency's rate to it.
245
+ const sizedCurrency = financials?.quote?.currency || ticker?.metadata.currency || null;
243
246
  const trackedCurrencies = useMemo(
244
- () => buildTrackedCurrencies(portfolioTickers, portfolioFinancials, accountState, config.baseCurrency, manualCash?.currency),
245
- [accountState, config.baseCurrency, manualCash?.currency, portfolioFinancials, portfolioTickers],
247
+ () => [...buildTrackedCurrencies(portfolioTickers, portfolioFinancials, accountState, config.baseCurrency, manualCash?.currency), sizedCurrency],
248
+ [accountState, config.baseCurrency, manualCash?.currency, portfolioFinancials, portfolioTickers, sizedCurrency],
246
249
  );
247
250
  const exchangeRates = useFxRatesMap(trackedCurrencies);
248
251
  const portfolioSummary = useMemo(
@@ -279,6 +282,25 @@ export function KellySizerPane({ focused, width, height }: PaneProps) {
279
282
  const bankroll = bankrollOverride ?? sourceBankroll;
280
283
  const currentValue = currentValueOverride ?? sourceCurrentValue;
281
284
  const price = positionFinancials?.quote?.price ?? null;
285
+ const priceCurrency = positionFinancials?.quote?.currency || ticker?.metadata.currency || config.baseCurrency;
286
+ // A future is counted in contracts, each worth its price times the contract's multiplier from its terms.
287
+ const count = ticker
288
+ ? kellyCount(ticker.metadata.ticker, ticker.metadata.exchange ?? "", positionFinancials?.quote?.instrumentType ?? ticker.metadata.assetCategory)
289
+ : "shares";
290
+ const [contractMultiplier, setContractMultiplier] = useState<{ symbol: string; value: number | null } | null>(null);
291
+ const tickerSymbol = ticker?.metadata.ticker ?? null;
292
+ useEffect(() => {
293
+ if (count !== "contracts" || !tickerSymbol) return;
294
+ let cancelled = false;
295
+ void kellyCountMultiplier(tickerSymbol, count).then((value) => {
296
+ if (!cancelled) setContractMultiplier({ symbol: tickerSymbol, value });
297
+ });
298
+ return () => { cancelled = true; };
299
+ }, [count, tickerSymbol]);
300
+ const multiplier = count !== "contracts" ? 1 : contractMultiplier?.symbol === tickerSymbol ? contractMultiplier.value : null;
301
+ // Counts divide a base-currency size by one count's value in that currency, at the rate the portfolio values holdings at.
302
+ const basePrice = price == null || multiplier == null ? null : convertCurrency(price, priceCurrency, config.baseCurrency, exchangeRates) * multiplier;
303
+ const unitPrice = basePrice != null && Number.isFinite(basePrice) && basePrice > 0 ? basePrice : null;
282
304
  // The same daily closes, through the same request, as the KELLY report reads.
283
305
  const historyRequest = useMemo(
284
306
  () => mode === "history" && ticker
@@ -287,13 +309,23 @@ export function KellySizerPane({ focused, width, height }: PaneProps) {
287
309
  [historyYears, mode, ticker?.metadata.exchange, ticker?.metadata.ticker],
288
310
  );
289
311
  const historyEntries = useChartQueries(historyRequest ? [historyRequest] : []);
290
- const historyEntry = historyRequest ? historyEntries.get(buildChartKey(historyRequest)) ?? null : null;
312
+ const datedEntry = historyRequest ? historyEntries.get(buildChartKey(historyRequest)) ?? null : null;
313
+ // A source with no dated history answers from its trailing range, as the KELLY report does.
314
+ const datedUnanswered = historyReadUnanswered(datedEntry);
315
+ const trailingRequest = useMemo(
316
+ () => datedUnanswered && ticker
317
+ ? kellyTrailingHistoryRequest({ symbol: ticker.metadata.ticker, exchange: ticker.metadata.exchange ?? "" }, historyYears)
318
+ : null,
319
+ [datedUnanswered, historyYears, ticker?.metadata.exchange, ticker?.metadata.ticker],
320
+ );
321
+ const trailingEntries = useChartQueries(trailingRequest ? [trailingRequest] : []);
322
+ const historyEntry = trailingRequest ? trailingEntries.get(buildChartKey(trailingRequest)) ?? null : datedEntry;
291
323
  const historyPoints = useResolvedEntryValue(historyEntry);
292
324
  const historyInputs = useMemo(
293
325
  () => historyPoints
294
- ? estimateKellyHistoryInputs(clipPriceHistoryToRange(historyPoints, kellyHistoryRange(historyYears)), historyYears)
326
+ ? estimateKellyHistoryInputs(historyPoints, historyYears, { exchange: ticker?.metadata.exchange ?? "" })
295
327
  : null,
296
- [historyPoints, historyYears],
328
+ [historyPoints, historyYears, ticker?.metadata.exchange],
297
329
  );
298
330
  const rawActiveDraft = drafts[sizingMode] ?? DEFAULT_KELLY_DRAFTS[sizingMode];
299
331
  const { commonAssumptions, updateCommon } = useKellyCommonAssumptions(rawActiveDraft);
@@ -365,9 +397,9 @@ export function KellySizerPane({ focused, width, height }: PaneProps) {
365
397
  draft: activeDraft,
366
398
  bankroll,
367
399
  currentValue,
368
- price,
400
+ price: unitPrice,
369
401
  }),
370
- [activeDraft, bankroll, currentValue, price, sizingMode],
402
+ [activeDraft, bankroll, currentValue, unitPrice, sizingMode],
371
403
  );
372
404
  const sensitivity = useMemo(() => buildSensitivityGrid(sizingMode, activeDraft), [activeDraft, sizingMode]);
373
405
  const curveMaxFraction = useMemo(
@@ -467,7 +499,7 @@ export function KellySizerPane({ focused, width, height }: PaneProps) {
467
499
  useRemoteUiNode(mode === "history" && historyInputs ? {
468
500
  role: "report-freshness",
469
501
  label: "History freshness",
470
- getMetadata: () => ({ asOf: historyInputs.end }),
502
+ getMetadata: () => ({ asOf: historyInputs.latest }),
471
503
  } : null);
472
504
  // History mode says what it is waiting for, or why it has no inputs, before any sizing warning.
473
505
  const historyStatus = mode !== "history" || historyInputs ? null
@@ -514,6 +546,7 @@ export function KellySizerPane({ focused, width, height }: PaneProps) {
514
546
  ...(mode === "history" && historyInputs ? buildKellyHistoryItems(historyInputs) : []),
515
547
  ...buildKellyResultItems({
516
548
  result,
549
+ count,
517
550
  baseCurrency: config.baseCurrency,
518
551
  currentGrowth,
519
552
  targetGrowth,
@@ -14,6 +14,7 @@ import { Box } from "../../../ui";
14
14
  import { displayWidth, formatCurrency, formatNumber, MISSING_VALUE } from "../../../utils/format";
15
15
  import type { KellySizingResult, SensitivityGrid } from "./types";
16
16
  import type { KellyHistoryInputs } from "./history";
17
+ import type { KellyCount } from "./units";
17
18
  import { formatPct, formatSignedPct } from "./view";
18
19
 
19
20
  /** The longest result label ("Full growth"), which sets the band's label column. */
@@ -34,6 +35,7 @@ export function buildKellyHistoryItems(inputs: KellyHistoryInputs): StatItem[] {
34
35
 
35
36
  /** What the first money figure says while there is no bankroll to size in. */
36
37
  const BANKROLL_HINT = "Set a bankroll";
38
+ const COUNT_LABEL: Record<KellyCount, string> = { shares: "Shares", units: "Units", contracts: "Contracts" };
37
39
 
38
40
  /**
39
41
  * The sizing result as one band under the inputs, laid out in the FieldGrid's
@@ -44,6 +46,7 @@ const BANKROLL_HINT = "Set a bankroll";
44
46
  */
45
47
  export function buildKellyResultItems({
46
48
  result,
49
+ count = "units",
47
50
  baseCurrency,
48
51
  currentGrowth,
49
52
  targetGrowth,
@@ -51,6 +54,8 @@ export function buildKellyResultItems({
51
54
  columns,
52
55
  }: {
53
56
  result: KellySizingResult;
57
+ /** What the add or trim is counted in: a future's contracts, a coin's units, a stock's shares. */
58
+ count?: KellyCount;
54
59
  baseCurrency: string;
55
60
  /** Null when the holding is not a share of any bankroll. */
56
61
  currentGrowth: number | null;
@@ -59,7 +64,7 @@ export function buildKellyResultItems({
59
64
  columns: number;
60
65
  }): StatItem[] {
61
66
  const addTrim = result.addTrimValue == null ? MISSING_VALUE : formatCurrency(result.addTrimValue, baseCurrency);
62
- const units = result.estimatedUnits == null ? null : `${formatNumber(result.estimatedUnits, 1)} units`;
67
+ const units = result.estimatedUnits == null ? null : `${formatNumber(result.estimatedUnits, 1)} ${count}`;
63
68
  // The units ride beside the amount when the column has room for label,
64
69
  // amount and units (plus the cell inset and gaps); otherwise they take a
65
70
  // cell of their own rather than being cut off at the column edge.
@@ -86,7 +91,7 @@ export function buildKellyResultItems({
86
91
  color: result.addTrimValue == null ? undefined : priceColor(result.addTrimValue),
87
92
  },
88
93
  ...(units != null && !unitsInline
89
- ? [{ id: "units", label: "Units", value: formatNumber(result.estimatedUnits!, 1) }]
94
+ ? [{ id: "units", label: COUNT_LABEL[count], value: formatNumber(result.estimatedUnits!, 1) }]
90
95
  : []),
91
96
  {
92
97
  id: "risk",
@@ -0,0 +1,29 @@
1
+ import type { FuturesContractTermsPayload } from "../../../api-client/futures-curve";
2
+ import { isFuturesInstrument, loadFuturesContractTermsCached } from "../../../market-data/futures-contract";
3
+ import { futuresContractSize } from "../../../portfolio/futures-positions";
4
+ import { isRoundTheClockCoin } from "../../../utils/crypto-pair";
5
+ import { logFailure } from "../../../utils/log-failure";
6
+
7
+ /** What a Kelly position is counted in: shares of a stock or fund, units of a coin, contracts of a future. */
8
+ export type KellyCount = "shares" | "units" | "contracts";
9
+
10
+ export function kellyCount(symbol: string, exchange: string, instrumentType: string | null | undefined): KellyCount {
11
+ if (isFuturesInstrument(symbol, instrumentType)) return "contracts";
12
+ return isRoundTheClockCoin(symbol, exchange) ? "units" : "shares";
13
+ }
14
+
15
+ /**
16
+ * What one of the count is worth per unit of price: a future's contract
17
+ * multiplier from the exchange's terms (ES's $50 a point, ZC's 5,000 bushels
18
+ * on a price in cents), 1 for a share or a coin. Null for a future whose terms
19
+ * cannot be read, so a position is never counted in price points.
20
+ */
21
+ export async function kellyCountMultiplier(
22
+ symbol: string,
23
+ count: KellyCount,
24
+ load: (symbol: string) => Promise<FuturesContractTermsPayload | null> = loadFuturesContractTermsCached,
25
+ ): Promise<number | null> {
26
+ if (count !== "contracts") return 1;
27
+ const terms = await load(symbol).catch(logFailure("kelly-sizer.units", "Read futures contract terms failed", null));
28
+ return futuresContractSize(terms?.spec)?.multiplier ?? null;
29
+ }
@@ -25,15 +25,16 @@ import { useNewsReadState } from "./wire/read-state";
25
25
  import { createTickerSurfacePaneTemplate } from "../shared/ticker-surface";
26
26
  import { tickerNewsHeadless } from "./headless";
27
27
  import { usePaneTickerIdentity } from "../../../state/hooks/pane-ticker";
28
+ import { TICKER_NEWS_TAB_ID, TICKER_NEWS_TEMPLATE_ID, tickerNewsQuery, tickerNewsStateKeys } from "./ticker-news";
28
29
 
29
- const NEWS_ITEM_LIMIT = 50;
30
30
  const DEFAULT_SORT: NewsSortPreference = { columnId: "time", direction: "desc" };
31
31
 
32
32
  function TickerNewsView({ width, height, focused }: { width: number; height: number; focused: boolean }) {
33
33
  const { ticker } = usePaneTickerIdentity();
34
34
  const symbol = ticker?.metadata.ticker ?? "none";
35
+ const stateKeys = tickerNewsStateKeys(symbol);
35
36
  const [selectedArticleId, setSelectedArticleId] = useDebouncedPluginPaneState<string | null>(
36
- `selectedArticleId:${symbol}`,
37
+ stateKeys.selectedArticleId,
37
38
  null,
38
39
  );
39
40
  const [sortPreference, setSortPreference] = usePluginPaneState<NewsSortPreference>(
@@ -41,14 +42,7 @@ function TickerNewsView({ width, height, focused }: { width: number; height: num
41
42
  DEFAULT_SORT,
42
43
  );
43
44
  const instrument = instrumentFromTicker(ticker, ticker?.metadata.ticker ?? null);
44
- const newsQuery = instrument ? {
45
- feed: "ticker" as const,
46
- ticker: instrument.symbol,
47
- exchange: instrument.exchange,
48
- tickerTier: "primary" as const,
49
- limit: NEWS_ITEM_LIMIT,
50
- ...(ticker?.metadata.name ? { listingName: ticker.metadata.name } : {}),
51
- } : null;
45
+ const newsQuery = tickerNewsQuery(ticker);
52
46
  const newsState = useNewsArticles(newsQuery);
53
47
  const loaded = usePersistedNewsArticles(
54
48
  `articles:${instrument?.symbol ?? "none"}:${instrument?.exchange ?? ""}`,
@@ -64,7 +58,7 @@ function TickerNewsView({ width, height, focused }: { width: number; height: num
64
58
  const { detailArticle, detailLoading, detailError, openArticle, closeDetail } = useNewsArticleDetail(
65
59
  visibleArticles,
66
60
  loadNewsStory,
67
- `openArticleId:${symbol}`,
61
+ stateKeys.openArticleId,
68
62
  );
69
63
  const popOutArticle = usePopOutNewsArticle(closeDetail);
70
64
  const openListedArticle = useCallback((article: typeof visibleArticles[number]) => {
@@ -209,7 +203,7 @@ export const tickerNewsModule: PluginModule = {
209
203
  paneTemplates: [
210
204
  {
211
205
  ...createTickerSurfacePaneTemplate({
212
- id: "ticker-news-pane",
206
+ id: TICKER_NEWS_TEMPLATE_ID,
213
207
  paneId: "ticker-news",
214
208
  label: "Ticker News",
215
209
  description: "Company news for the selected ticker.",
@@ -223,7 +217,7 @@ export const tickerNewsModule: PluginModule = {
223
217
 
224
218
  setup(ctx) {
225
219
  ctx.registerTickerResearchTab({
226
- id: "news",
220
+ id: TICKER_NEWS_TAB_ID,
227
221
  name: "News",
228
222
  order: 40,
229
223
  component: TickerNewsView,