gloomberb 0.20.2 → 0.20.4

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 (471) 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-dialog.tsx +17 -0
  5. package/src/account/auth-form.tsx +13 -8
  6. package/src/account/upgrade-dialog.tsx +1 -1
  7. package/src/api-client/central-bank-rates.ts +5 -0
  8. package/src/api-client/data.ts +23 -4
  9. package/src/api-client/debt-maturities.ts +45 -2
  10. package/src/api-client/earnings.ts +4 -2
  11. package/src/api-client/errors.ts +21 -11
  12. package/src/api-client/fx-interventions.ts +64 -0
  13. package/src/api-client/index.ts +2 -0
  14. package/src/api-client/paths.ts +9 -1
  15. package/src/api-client/release-summaries.ts +21 -0
  16. package/src/api-client/social-mentions.ts +47 -0
  17. package/src/api-client/types/econ.ts +4 -0
  18. package/src/app/keybindings/actions.ts +2 -2
  19. package/src/app/pane-runtime/ticker-open-runtime.ts +245 -66
  20. package/src/app.tsx +11 -1
  21. package/src/cli/command-options.ts +2 -1
  22. package/src/cli/commands/market.ts +188 -30
  23. package/src/cli/commands/news-search.ts +1 -3
  24. package/src/cli/commands/options-chain.ts +23 -6
  25. package/src/cli/commands/overview.ts +13 -5
  26. package/src/cli/commands/plugins.ts +76 -23
  27. package/src/cli/commands/search.ts +25 -6
  28. package/src/cli/commands/system.ts +19 -3
  29. package/src/cli/commands/ticker.ts +64 -21
  30. package/src/cli/fx-quote-rate.ts +49 -1
  31. package/src/cli/glossary.ts +95 -15
  32. package/src/cli/history-rows.ts +9 -25
  33. package/src/cli/index.ts +14 -46
  34. package/src/cli/known-gaps.ts +3 -3
  35. package/src/cli/listing-arg.ts +78 -18
  36. package/src/cli/name-entries.ts +3 -2
  37. package/src/cli/not-a-ticker.ts +6 -2
  38. package/src/cli/pane-functions/capabilities.ts +12 -1
  39. package/src/cli/pane-functions/function-help.ts +26 -14
  40. package/src/cli/pane-functions/headless.ts +3 -1
  41. package/src/cli/pane-functions/index.ts +32 -4
  42. package/src/cli/pane-functions/market-session.ts +8 -3
  43. package/src/cli/pane-functions/resolver.ts +18 -11
  44. package/src/cli/pane-functions/screenshot-payload.ts +36 -6
  45. package/src/cli/pane-functions/screenshot-render.ts +4 -0
  46. package/src/cli/quote-answer.ts +10 -0
  47. package/src/cli/report-tables.ts +40 -8
  48. package/src/cli/result.ts +21 -9
  49. package/src/cli/spreadsheet-hint.ts +43 -0
  50. package/src/cli/symbol-list.ts +58 -4
  51. package/src/cli/symbol-rows.ts +49 -2
  52. package/src/cli/ticker-resolution.ts +98 -5
  53. package/src/cli/types.ts +2 -0
  54. package/src/cli/unknown-command.ts +88 -0
  55. package/src/components/chart/composite/axis-overlays.tsx +22 -0
  56. package/src/components/chart/composite/composite-chart.tsx +54 -13
  57. package/src/components/chart/composite/event-captions.ts +109 -0
  58. package/src/components/chart/composite/event-guides.ts +74 -0
  59. package/src/components/chart/composite/rasterizer.ts +2 -0
  60. package/src/components/chart/composite/text-renderer.ts +2 -0
  61. package/src/components/chart/composite/types.ts +31 -0
  62. package/src/components/command-bar/assist/model.ts +6 -1
  63. package/src/components/command-bar/commands/direct/index.ts +9 -1
  64. package/src/components/command-bar/commands/registry.ts +18 -0
  65. package/src/components/command-bar/layout-items/focused-pane.ts +5 -5
  66. package/src/components/command-bar/pane-actions.ts +30 -13
  67. package/src/components/command-bar/panel/index.tsx +6 -3
  68. package/src/components/command-bar/panel/prompt-binding.ts +4 -0
  69. package/src/components/command-bar/panel/types.ts +3 -0
  70. package/src/components/command-bar/routes/header-market.ts +108 -0
  71. package/src/components/command-bar/routes/root/command-items.ts +5 -0
  72. package/src/components/command-bar/routes/root/provider-search.ts +192 -33
  73. package/src/components/command-bar/routes/root/results.ts +3 -0
  74. package/src/components/command-bar/routes/root/runtime.ts +28 -5
  75. package/src/components/command-bar/routes/ticker-search/results.ts +104 -6
  76. package/src/components/command-bar/routes/ticker-search/route.ts +3 -2
  77. package/src/components/command-bar/routing/list-state.ts +38 -0
  78. package/src/components/command-bar/selection-hint.ts +28 -0
  79. package/src/components/command-bar/surface/index.tsx +41 -3
  80. package/src/components/command-bar/view-model.ts +15 -0
  81. package/src/components/command-bar/workflow/tickers.ts +3 -2
  82. package/src/components/company-logo.tsx +20 -2
  83. package/src/components/data-table/export.ts +13 -8
  84. package/src/components/feedback-dialog.tsx +2 -1
  85. package/src/components/form-modal/field-row.tsx +2 -1
  86. package/src/components/input-search-bar.tsx +2 -2
  87. package/src/components/layout/detached-pane-shell.tsx +1 -1
  88. package/src/components/layout/double-escape-close.ts +8 -5
  89. package/src/components/layout/floating-pane.tsx +5 -1
  90. package/src/components/layout/header.tsx +75 -44
  91. package/src/components/layout/market-summary.ts +322 -116
  92. package/src/components/layout/pane/footer/index.tsx +44 -19
  93. package/src/components/layout/pane/footer/model.ts +52 -20
  94. package/src/components/layout/pane/header.tsx +3 -2
  95. package/src/components/layout/shell/action-menu-overlay.tsx +10 -5
  96. package/src/components/layout/shell/active-drag.ts +149 -105
  97. package/src/components/layout/shell/chrome.ts +15 -15
  98. package/src/components/layout/shell/drag/drop-zones.ts +162 -0
  99. package/src/components/layout/shell/drag/index.ts +47 -218
  100. package/src/components/layout/shell/drag/live.ts +10 -3
  101. package/src/components/layout/shell/drag/overlays.tsx +182 -5
  102. package/src/components/layout/shell/drag/runtime.ts +29 -6
  103. package/src/components/layout/shell/drag/shared-edges.ts +156 -0
  104. package/src/components/layout/shell/index.tsx +11 -6
  105. package/src/components/layout/shell/menu.ts +11 -2
  106. package/src/components/layout/shell/native/pointer-runtime.ts +25 -0
  107. package/src/components/layout/shell/native/window-state.ts +2 -2
  108. package/src/components/layout/shell/pane/layers.tsx +71 -7
  109. package/src/components/layout/shell/terminal-pointer-runtime.ts +18 -9
  110. package/src/components/layout/shell/window-mode/index.ts +8 -10
  111. package/src/components/layout/status-bar.tsx +8 -7
  112. package/src/components/layout/status-widget-space.ts +8 -0
  113. package/src/components/layout/window-edit/mode.ts +39 -7
  114. package/src/components/layout/window-edit/presentation.ts +1 -1
  115. package/src/components/markdown-editor.tsx +2 -2
  116. package/src/components/onboarding/account-step/form-panel.tsx +0 -3
  117. package/src/components/onboarding/onboarding-keyboard.ts +19 -6
  118. package/src/components/onboarding/onboarding-wizard.tsx +69 -14
  119. package/src/components/onboarding/portfolio-step/broker-fields-panel.tsx +0 -1
  120. package/src/components/onboarding/portfolio-step/positions-panel.tsx +0 -2
  121. package/src/components/price-sparkline/model.ts +26 -10
  122. package/src/components/ticker/list-table-view.tsx +29 -4
  123. package/src/components/ui/button.tsx +15 -2
  124. package/src/components/ui/choice-dialog.tsx +1 -0
  125. package/src/components/ui/column-grid.tsx +18 -9
  126. package/src/components/ui/data-table/index.tsx +5 -4
  127. package/src/components/ui/data-table/opentui/index.tsx +2 -1
  128. package/src/components/ui/data-table/types.ts +18 -0
  129. package/src/components/ui/delayed-mark.tsx +3 -2
  130. package/src/components/ui/field-grid.tsx +0 -2
  131. package/src/components/ui/fields.tsx +7 -4
  132. package/src/components/ui/inline-quick-add.tsx +2 -2
  133. package/src/components/ui/key-hint-words.ts +153 -0
  134. package/src/components/ui/key-hints.tsx +73 -0
  135. package/src/components/ui/list-view.tsx +7 -12
  136. package/src/components/ui/loading.tsx +10 -3
  137. package/src/components/ui/menu.tsx +9 -3
  138. package/src/components/ui/message-composer.tsx +2 -2
  139. package/src/components/ui/quote.ts +14 -1
  140. package/src/components/ui/shortcut-hint.tsx +28 -3
  141. package/src/components/ui/tabs.tsx +7 -0
  142. package/src/components/ui/text-prompt-dialog.tsx +2 -1
  143. package/src/core/state/app/command-bar-launch.ts +3 -0
  144. package/src/data/config/layout.ts +5 -2
  145. package/src/data/config/store/normalize.ts +6 -0
  146. package/src/docs/snapshot.json +149 -74
  147. package/src/i18n/es.ts +33 -9
  148. package/src/i18n/ja.ts +33 -9
  149. package/src/i18n/ko.ts +33 -9
  150. package/src/i18n/zh-cn.ts +33 -9
  151. package/src/i18n/zh-tw.ts +33 -9
  152. package/src/layout/pane-manager/floating-actions.ts +17 -0
  153. package/src/layout/pane-manager/floating-stack.ts +187 -0
  154. package/src/layout/pane-manager/floating.ts +4 -2
  155. package/src/layout/pane-manager/gridlock.ts +16 -1
  156. package/src/layout/pane-manager/index.ts +11 -0
  157. package/src/layout/pane-manager/layout-state.ts +10 -3
  158. package/src/market-data/bars-per-year.ts +27 -9
  159. package/src/market-data/coordinator/quotes.ts +22 -3
  160. package/src/market-data/futures-board.ts +126 -1
  161. package/src/market-data/futures-contract.ts +21 -6
  162. package/src/market-data/fx-interventions.ts +270 -0
  163. package/src/market-data/market/change-basis.ts +2 -2
  164. package/src/market-data/market/dated-previous-close.ts +163 -47
  165. package/src/market-data/market/format.ts +14 -3
  166. package/src/market-data/market/freshness.ts +24 -7
  167. package/src/market-data/market/header-market.ts +154 -0
  168. package/src/market-data/market/index-level.ts +29 -0
  169. package/src/market-data/market/index-session-venues.ts +44 -0
  170. package/src/market-data/market/status.ts +7 -2
  171. package/src/market-data/market/venue-session.ts +72 -0
  172. package/src/market-data/model-dividend-yield.ts +23 -8
  173. package/src/market-data/options-alternatives.ts +39 -4
  174. package/src/market-data/published-apac-sessions.ts +40 -2
  175. package/src/market-data/quotes/export-identity.ts +76 -0
  176. package/src/market-data/quotes/freshness.ts +22 -0
  177. package/src/market-data/quotes/time.ts +42 -1
  178. package/src/market-data/realized-volatility.ts +11 -7
  179. package/src/market-data/tax-equivalent.ts +145 -27
  180. package/src/news/news-model.ts +44 -2
  181. package/src/plugins/builtin/account-management/pane.tsx +2 -2
  182. package/src/plugins/builtin/alerts/alert-engine.ts +12 -6
  183. package/src/plugins/builtin/alerts/alert-log.ts +6 -2
  184. package/src/plugins/builtin/alerts/calendar-events.ts +74 -12
  185. package/src/plugins/builtin/alerts/cli-forms.ts +11 -1
  186. package/src/plugins/builtin/alerts/cli-move.ts +234 -0
  187. package/src/plugins/builtin/alerts/cli.ts +223 -32
  188. package/src/plugins/builtin/alerts/command.ts +33 -6
  189. package/src/plugins/builtin/alerts/event-rows.ts +18 -4
  190. package/src/plugins/builtin/alerts/events-pane.tsx +6 -2
  191. package/src/plugins/builtin/alerts/events.ts +9 -0
  192. package/src/plugins/builtin/alerts/format.ts +39 -15
  193. package/src/plugins/builtin/alerts/headless.ts +30 -18
  194. package/src/plugins/builtin/alerts/history.ts +1 -0
  195. package/src/plugins/builtin/alerts/index.tsx +86 -12
  196. package/src/plugins/builtin/alerts/live.ts +2 -1
  197. package/src/plugins/builtin/alerts/move-checks.ts +161 -0
  198. package/src/plugins/builtin/alerts/move.ts +181 -0
  199. package/src/plugins/builtin/alerts/pane.tsx +50 -22
  200. package/src/plugins/builtin/alerts/price-text.ts +62 -0
  201. package/src/plugins/builtin/alerts/price.ts +17 -0
  202. package/src/plugins/builtin/alerts/quotes.ts +84 -3
  203. package/src/plugins/builtin/alerts/scheduled-check.ts +7 -1
  204. package/src/plugins/builtin/alerts/storage.ts +22 -7
  205. package/src/plugins/builtin/alerts/types.ts +25 -0
  206. package/src/plugins/builtin/analytics/risk-client.ts +60 -39
  207. package/src/plugins/builtin/analytics/risk-episodes.ts +18 -0
  208. package/src/plugins/builtin/analytics/risk-headless.ts +20 -4
  209. package/src/plugins/builtin/analytics/risk-model.ts +68 -1
  210. package/src/plugins/builtin/analytics/risk-pane.tsx +15 -3
  211. package/src/plugins/builtin/backtest/engine.ts +4 -2
  212. package/src/plugins/builtin/backtest/window.ts +3 -1
  213. package/src/plugins/builtin/broker-manager/sign-in-end.ts +1 -1
  214. package/src/plugins/builtin/central-bank-rates/client.ts +4 -0
  215. package/src/plugins/builtin/central-bank-rates/headless.ts +1 -1
  216. package/src/plugins/builtin/central-bank-rates/model.ts +18 -8
  217. package/src/plugins/builtin/central-bank-rates/pane.tsx +6 -3
  218. package/src/plugins/builtin/changelog/index.tsx +292 -101
  219. package/src/plugins/builtin/changelog/versions.ts +293 -0
  220. package/src/plugins/builtin/chart-composer/cli-options.ts +5 -0
  221. package/src/plugins/builtin/chart-composer/headless-schema.ts +17 -1
  222. package/src/plugins/builtin/chart-composer/headless.ts +2 -0
  223. package/src/plugins/builtin/chart-composer/intervention-events.ts +105 -0
  224. package/src/plugins/builtin/chart-composer/pane.tsx +21 -7
  225. package/src/plugins/builtin/chat/message/render-state.ts +2 -5
  226. package/src/plugins/builtin/cloud/askg/attached-pane.tsx +10 -5
  227. package/src/plugins/builtin/cloud/askg/controller.ts +141 -5
  228. package/src/plugins/builtin/cloud/askg/executor.ts +113 -4
  229. package/src/plugins/builtin/cloud/askg/manifest.ts +28 -13
  230. package/src/plugins/builtin/cloud/askg/model.ts +14 -4
  231. package/src/plugins/builtin/cloud/askg/pane.tsx +70 -46
  232. package/src/plugins/builtin/cloud/askg/turn-parts.tsx +70 -0
  233. package/src/plugins/builtin/cloud/terminal-relay/engine.ts +50 -130
  234. package/src/plugins/builtin/cloud/terminal-relay/policy.ts +327 -7
  235. package/src/plugins/builtin/cloud/terminal-relay/prompts.tsx +2 -1
  236. package/src/plugins/builtin/cloud/terminal-relay/redact.ts +47 -6
  237. package/src/plugins/builtin/cloud/upgrade-status-widget.tsx +9 -2
  238. package/src/plugins/builtin/commodities-energy/index.tsx +1 -3
  239. package/src/plugins/builtin/commodities-energy/view-state.ts +3 -0
  240. package/src/plugins/builtin/cot/headless.ts +14 -2
  241. package/src/plugins/builtin/crypto-board/headless.ts +82 -17
  242. package/src/plugins/builtin/crypto-board/index.tsx +24 -2
  243. package/src/plugins/builtin/crypto-board/model.ts +5 -2
  244. package/src/plugins/builtin/crypto-board/pane.tsx +4 -1
  245. package/src/plugins/builtin/debt-maturities/client.ts +111 -6
  246. package/src/plugins/builtin/debt-maturities/headless.ts +84 -1
  247. package/src/plugins/builtin/debt-maturities/model.ts +97 -14
  248. package/src/plugins/builtin/debt-maturities/pane.tsx +165 -15
  249. package/src/plugins/builtin/debt-maturities/series.ts +3 -1
  250. package/src/plugins/builtin/dividend-yield/client.ts +22 -6
  251. package/src/plugins/builtin/dividend-yield/headless.ts +113 -46
  252. package/src/plugins/builtin/dividend-yield/model.ts +5 -2
  253. package/src/plugins/builtin/dividend-yield/pane.tsx +6 -3
  254. package/src/plugins/builtin/dividend-yield/ranking-reads.ts +11 -4
  255. package/src/plugins/builtin/dividend-yield/ranking.ts +113 -18
  256. package/src/plugins/builtin/dividend-yield/types.ts +2 -0
  257. package/src/plugins/builtin/dividend-yield/view.ts +3 -0
  258. package/src/plugins/builtin/earnings/index.tsx +2 -2
  259. package/src/plugins/builtin/econ/calendar-model.ts +21 -3
  260. package/src/plugins/builtin/econ/detail-view.tsx +5 -3
  261. package/src/plugins/builtin/econ/figures.ts +13 -0
  262. package/src/plugins/builtin/econ/fred-catalog.ts +6 -3
  263. package/src/plugins/builtin/econ/index.tsx +5 -3
  264. package/src/plugins/builtin/econ/types.ts +5 -0
  265. package/src/plugins/builtin/equity-screener/footer.ts +45 -0
  266. package/src/plugins/builtin/equity-screener/pane.tsx +4 -18
  267. package/src/plugins/builtin/equity-screener/ticker-check.tsx +2 -1
  268. package/src/plugins/builtin/fixed-income/model.ts +1 -0
  269. package/src/plugins/builtin/futures/index.tsx +25 -4
  270. package/src/plugins/builtin/futures/model.ts +28 -32
  271. package/src/plugins/builtin/futures/series.ts +4 -3
  272. package/src/plugins/builtin/futures/table.tsx +17 -10
  273. package/src/plugins/builtin/futures/use-board-terms.ts +3 -3
  274. package/src/plugins/builtin/futures-curve/model.ts +3 -10
  275. package/src/plugins/builtin/help/function-card.tsx +2 -1
  276. package/src/plugins/builtin/help/function-index.ts +1 -0
  277. package/src/plugins/builtin/help/index.tsx +3 -3
  278. package/src/plugins/builtin/help/keybindings-editor.tsx +18 -4
  279. package/src/plugins/builtin/insider/client.ts +31 -14
  280. package/src/plugins/builtin/insider/signals-model.ts +2 -7
  281. package/src/plugins/builtin/iv-history/headless.ts +1 -2
  282. package/src/plugins/builtin/iv-history/model.ts +33 -23
  283. package/src/plugins/builtin/iv-history/screen-pane.tsx +0 -3
  284. package/src/plugins/builtin/kelly-sizer/headless.ts +64 -16
  285. package/src/plugins/builtin/kelly-sizer/history.ts +37 -28
  286. package/src/plugins/builtin/kelly-sizer/pane.tsx +43 -10
  287. package/src/plugins/builtin/kelly-sizer/sections.tsx +7 -2
  288. package/src/plugins/builtin/kelly-sizer/units.ts +29 -0
  289. package/src/plugins/builtin/layout-manager/index.tsx +8 -8
  290. package/src/plugins/builtin/news/headless.ts +2 -2
  291. package/src/plugins/builtin/news/index.tsx +10 -16
  292. package/src/plugins/builtin/news/overview-headlines.tsx +117 -0
  293. package/src/plugins/builtin/news/ticker-news.ts +35 -0
  294. package/src/plugins/builtin/news/wire/news/detail-view.tsx +8 -6
  295. package/src/plugins/builtin/news/wire/news/row.ts +49 -0
  296. package/src/plugins/builtin/news/wire/news/table.tsx +9 -20
  297. package/src/plugins/builtin/options/analytics.ts +7 -2
  298. package/src/plugins/builtin/options/live-quotes.ts +6 -1
  299. package/src/plugins/builtin/options/table.ts +3 -2
  300. package/src/plugins/builtin/options/view.tsx +11 -9
  301. package/src/plugins/builtin/options-scenario/client.ts +3 -0
  302. package/src/plugins/builtin/options-scenario/headless.ts +1 -1
  303. package/src/plugins/builtin/perps/client.ts +5 -4
  304. package/src/plugins/builtin/perps/headless.ts +134 -124
  305. package/src/plugins/builtin/perps/markets-section.tsx +7 -4
  306. package/src/plugins/builtin/perps/model.ts +8 -4
  307. package/src/plugins/builtin/perps/open-market.ts +4 -4
  308. package/src/plugins/builtin/perps/venue-markets.ts +3 -6
  309. package/src/plugins/builtin/plugin-marketplace/pane.tsx +11 -11
  310. package/src/plugins/builtin/portfolio-list/cell-version.ts +1 -0
  311. package/src/plugins/builtin/portfolio-list/cli/bulk-symbols.ts +34 -10
  312. package/src/plugins/builtin/portfolio-list/cli/period-report.ts +28 -2
  313. package/src/plugins/builtin/portfolio-list/cli/portfolio-command.ts +7 -3
  314. package/src/plugins/builtin/portfolio-list/cli/render.ts +66 -22
  315. package/src/plugins/builtin/portfolio-list/grid.tsx +5 -3
  316. package/src/plugins/builtin/portfolio-list/pane/data.ts +34 -1
  317. package/src/plugins/builtin/portfolio-list/pane/index.tsx +6 -0
  318. package/src/plugins/builtin/portfolio-list/pane/streaming.ts +15 -6
  319. package/src/plugins/builtin/portfolio-list/quick-add/resolution.ts +19 -7
  320. package/src/plugins/builtin/portfolio-list/summary/index.tsx +3 -1
  321. package/src/plugins/builtin/portfolio-list/table.tsx +30 -4
  322. package/src/plugins/builtin/realized-vol/evidence.ts +33 -6
  323. package/src/plugins/builtin/realized-vol/fx-proxy.ts +135 -0
  324. package/src/plugins/builtin/realized-vol/headless.ts +44 -8
  325. package/src/plugins/builtin/realized-vol/model.ts +9 -5
  326. package/src/plugins/builtin/realized-vol/pane.tsx +49 -15
  327. package/src/plugins/builtin/research/event-model.ts +9 -1
  328. package/src/plugins/builtin/research/event-sources.ts +22 -0
  329. package/src/plugins/builtin/research/headless.ts +3 -3
  330. package/src/plugins/builtin/sec/headless.ts +48 -6
  331. package/src/plugins/builtin/sec/index.tsx +6 -4
  332. package/src/plugins/builtin/sec/model.ts +4 -1
  333. package/src/plugins/builtin/shared/cloud-upgrade.ts +27 -3
  334. package/src/plugins/builtin/shared/earnings-calendar.ts +2 -0
  335. package/src/plugins/builtin/shared/market-cap-bands.ts +12 -0
  336. package/src/plugins/builtin/shared/report-freshness.ts +3 -1
  337. package/src/plugins/builtin/shared/use-quote-board.ts +5 -3
  338. package/src/plugins/builtin/shared/volatility/options.ts +63 -2
  339. package/src/plugins/builtin/social-mentions/headless.ts +72 -3
  340. package/src/plugins/builtin/social-mentions/index.tsx +8 -4
  341. package/src/plugins/builtin/social-mentions/lock-note.ts +6 -2
  342. package/src/plugins/builtin/social-mentions/outliers-client.ts +101 -0
  343. package/src/plugins/builtin/social-mentions/outliers-model.ts +162 -0
  344. package/src/plugins/builtin/social-mentions/outliers-names.ts +51 -0
  345. package/src/plugins/builtin/social-mentions/outliers.tsx +276 -0
  346. package/src/plugins/builtin/social-mentions/pane.tsx +32 -3
  347. package/src/plugins/builtin/supply-chain/graph-pane.tsx +2 -2
  348. package/src/plugins/builtin/thirteenf/api.ts +36 -2
  349. package/src/plugins/builtin/thirteenf/data.ts +4 -1
  350. package/src/plugins/builtin/thirteenf/headless.ts +14 -6
  351. package/src/plugins/builtin/thirteenf/model.ts +56 -1
  352. package/src/plugins/builtin/thirteenf/pane.tsx +8 -8
  353. package/src/plugins/builtin/thirteenf/report-notes.ts +11 -0
  354. package/src/plugins/builtin/thirteenf/table.ts +2 -1
  355. package/src/plugins/builtin/thirteenf/types.ts +6 -0
  356. package/src/plugins/builtin/ticker-detail/data-panes/historical-prices.tsx +23 -3
  357. package/src/plugins/builtin/ticker-detail/financials/model.ts +5 -0
  358. package/src/plugins/builtin/ticker-detail/headless-schema.ts +2 -1
  359. package/src/plugins/builtin/ticker-detail/headless.ts +21 -66
  360. package/src/plugins/builtin/ticker-detail/index.tsx +5 -0
  361. package/src/plugins/builtin/ticker-detail/overview/components.tsx +67 -6
  362. package/src/plugins/builtin/ticker-detail/overview/model.ts +6 -4
  363. package/src/plugins/builtin/ticker-detail/overview/pane.tsx +15 -0
  364. package/src/plugins/builtin/ticker-detail/overview/tax-equivalent.ts +69 -0
  365. package/src/plugins/builtin/ticker-detail/overview-tab.tsx +69 -19
  366. package/src/plugins/builtin/ticker-detail/pane.tsx +7 -2
  367. package/src/plugins/builtin/ticker-detail/quote-monitor/card.tsx +47 -24
  368. package/src/plugins/builtin/ticker-detail/quote-monitor/export.ts +46 -0
  369. package/src/plugins/builtin/ticker-detail/quote-monitor/index.tsx +20 -1
  370. package/src/plugins/builtin/ticker-detail/quote-monitor/rows.ts +120 -0
  371. package/src/plugins/builtin/ticker-detail/research-tabs.ts +1 -5
  372. package/src/plugins/builtin/ticker-detail/settings.ts +6 -6
  373. package/src/plugins/builtin/treasury-auctions/cache.ts +85 -19
  374. package/src/plugins/builtin/treasury-auctions/index.tsx +22 -11
  375. package/src/plugins/builtin/treasury-auctions/model.ts +23 -0
  376. package/src/plugins/builtin/treasury-auctions/treasury-direct.ts +128 -0
  377. package/src/plugins/builtin/world-indices/client.ts +2 -0
  378. package/src/plugins/compat.ts +15 -0
  379. package/src/plugins/host-link.ts +6 -1
  380. package/src/plugins/installer.ts +53 -3
  381. package/src/portfolio/column-values.ts +14 -4
  382. package/src/portfolio/listed-symbol.ts +78 -0
  383. package/src/portfolio/real-return.ts +172 -0
  384. package/src/public/__snapshots__/public-api.test.ts.snap +1 -0
  385. package/src/remote/resources.ts +12 -1
  386. package/src/remote/schema.ts +1 -0
  387. package/src/remote/semantic-helpers.ts +29 -1
  388. package/src/remote/semantic-tree.tsx +32 -15
  389. package/src/renderers/browser/config-host.ts +56 -15
  390. package/src/renderers/browser/main.tsx +3 -1
  391. package/src/renderers/browser/ui-host.tsx +1 -0
  392. package/src/renderers/cloudflare/http-proxy.ts +1 -0
  393. package/src/renderers/cloudflare/worker.ts +16 -1
  394. package/src/renderers/dom/boot-frame.ts +2 -2
  395. package/src/renderers/dom/data-table/row.tsx +4 -1
  396. package/src/renderers/dom/desktop/controls.tsx +4 -4
  397. package/src/renderers/dom/desktop/dialog-actions.tsx +60 -41
  398. package/src/renderers/dom/dom-ui-host.tsx +3 -1
  399. package/src/renderers/dom/host/input.tsx +4 -1
  400. package/src/renderers/dom/host/tabs.tsx +10 -1
  401. package/src/renderers/dom/styles.css +73 -19
  402. package/src/renderers/electrobun/bun/desktop/app-name.ts +1 -1
  403. package/src/renderers/opentui/host.tsx +2 -1
  404. package/src/renderers/share/layout-view.tsx +1 -1
  405. package/src/sources/gloomberb-cloud/fred-series.ts +12 -0
  406. package/src/sources/gloomberb-cloud/index.ts +31 -2
  407. package/src/sources/gloomberb-cloud/news.ts +35 -12
  408. package/src/sources/gloomberb-cloud/normalizers.ts +29 -3
  409. package/src/sources/provider-router/cached-routes.ts +19 -7
  410. package/src/state/opening-ticker-panes.ts +47 -0
  411. package/src/state/pane-table-export-registry.ts +19 -6
  412. package/src/test-support/cli-context.ts +2 -0
  413. package/src/test-support/preload.ts +8 -1
  414. package/src/theme/colors.ts +9 -1
  415. package/src/theme/themes.ts +62 -15
  416. package/src/theme/tone-contrast.ts +40 -0
  417. package/src/theme/ui-tokens.ts +23 -3
  418. package/src/tickers/batched-lookups.ts +57 -8
  419. package/src/tickers/company-name-listing.ts +156 -14
  420. package/src/tickers/company-name.ts +30 -6
  421. package/src/tickers/instrument-kind.ts +23 -3
  422. package/src/tickers/list.ts +7 -0
  423. package/src/tickers/search/home-listing.ts +31 -9
  424. package/src/tickers/search/index.ts +13 -3
  425. package/src/tickers/search/listing-index.ts +558 -0
  426. package/src/tickers/search/major-listings.chunk.ts +10 -0
  427. package/src/tickers/search/major-listings.json +3346 -0
  428. package/src/tickers/search/ranking.ts +68 -1
  429. package/src/tickers/search/types.ts +4 -0
  430. package/src/tickers/terminal-codes.ts +26 -1
  431. package/src/time-series/calendar-month-returns.ts +47 -0
  432. package/src/time-series/currency-conversion.ts +130 -0
  433. package/src/time-series/hooks.ts +2 -0
  434. package/src/time-series/price-comparison.ts +34 -11
  435. package/src/time-series/resolve-context.ts +3 -0
  436. package/src/time-series/resolve.ts +14 -2
  437. package/src/time-series/spec.ts +1 -0
  438. package/src/time-series/studies/indicators.ts +4 -1
  439. package/src/time-series/types.ts +8 -0
  440. package/src/types/config.ts +13 -0
  441. package/src/types/context-menu.ts +2 -0
  442. package/src/types/data-provider.ts +28 -0
  443. package/src/types/financials.ts +20 -2
  444. package/src/types/headless.ts +12 -0
  445. package/src/types/plugin-commands.ts +140 -0
  446. package/src/types/plugin-context.ts +125 -0
  447. package/src/types/plugin-contributions.ts +55 -0
  448. package/src/types/plugin-definition.ts +234 -0
  449. package/src/types/plugin-notifications.ts +38 -0
  450. package/src/types/plugin-pane-settings.ts +114 -0
  451. package/src/types/plugin-pane-templates.ts +160 -0
  452. package/src/types/plugin-panes.ts +221 -0
  453. package/src/types/plugin-reports.ts +35 -0
  454. package/src/types/plugin-shared.ts +14 -0
  455. package/src/types/plugin-state.ts +71 -0
  456. package/src/types/plugin.ts +14 -1169
  457. package/src/ui/host.tsx +8 -0
  458. package/src/ui/index.tsx +14 -3
  459. package/src/updater/github-releases.ts +23 -0
  460. package/src/utils/cli-output.ts +22 -9
  461. package/src/utils/datetime-format.ts +17 -3
  462. package/src/utils/display-number.ts +15 -0
  463. package/src/utils/double-escape-close.ts +61 -16
  464. package/src/utils/float32-price.ts +24 -0
  465. package/src/utils/forward-dividend.ts +81 -16
  466. package/src/utils/fx-market-hours.ts +11 -0
  467. package/src/utils/plugin-proxy-hosts.json +2 -1
  468. package/src/utils/price-history.ts +7 -6
  469. package/src/utils/report-timing.ts +62 -0
  470. package/src/utils/sec-filings.ts +32 -0
  471. package/src/utils/utc-time.ts +5 -0
@@ -74,6 +74,7 @@ export function buildHelpFunctionIndex(sources: HelpFunctionSources): HelpFuncti
74
74
  aliases,
75
75
  paneId: COMMAND_PANES[command.id],
76
76
  argPlaceholder: command.hasArg ? command.argPlaceholder : undefined,
77
+ ...(command.listed === false ? { unlisted: true as const } : {}),
77
78
  }));
78
79
  }
79
80
  for (const command of sources.pluginCommands) {
@@ -357,7 +357,7 @@ function HelpPane({ focused, width, height }: PaneProps) {
357
357
  ],
358
358
  },
359
359
  {
360
- // Docked panes keep the saved layout and floating ones follow the pointer; the keyboard's way is Window Mode below.
360
+ // Panes in the layout keep the saved layout and floating ones follow the pointer; the keyboard's way is Window Mode below.
361
361
  label: "Layout",
362
362
  items: [
363
363
  keyEntry("layout-drag", ["Drag"], "Floating panes can be dragged by the title bar and resized from the lower-right corner."),
@@ -374,8 +374,8 @@ function HelpPane({ focused, width, height }: PaneProps) {
374
374
  ? [entry("enter-resize", windowResizeBadges, "Enter window mode to resize the focused window.")]
375
375
  : []),
376
376
  keyEntry("mode", ["m", "r"], "Switch between move and resize."),
377
- keyEntry("dock", ["d"], "Dock or float the selected window."),
378
- keyEntry("move", ["Arrows", "h/j/k/l"], "Move, resize, or choose a dock target."),
377
+ keyEntry("float", ["d"], "Float the selected window, or return it to the layout."),
378
+ keyEntry("move", ["Arrows", "h/j/k/l"], "Move, resize, or choose where it goes in the layout."),
379
379
  keyEntry("step", ["Shift"], "Use larger move and resize steps with direction keys."),
380
380
  keyEntry("cycle", ["Tab", "w"], "Cycle windows or resize handles."),
381
381
  keyEntry("commit", ["Enter", "Esc"], "Commit pending changes or exit window mode."),
@@ -61,8 +61,19 @@ import { badgeCell, badgeColumnWidth, mutedCell } from "./table-cells";
61
61
  const CAPTURE_SCOPE = "help-keybinding-capture";
62
62
  const FOOTER_ID = "help-keybindings";
63
63
  const NOTE_COLUMN_WIDTH = 26;
64
- /** Below this the note column is dropped; the footer still carries the detail. */
65
- const NOTE_COLUMN_MIN_TABLE_WIDTH = 76;
64
+ /** What the table takes besides its columns: its side padding, the gaps between columns and the scrollbar. */
65
+ const TABLE_CHROME = 5;
66
+ /** ACTION keeps at least this beside NOTE; narrower, NOTE is dropped and the footer carries the selected row's. */
67
+ const ACTION_MIN_WIDTH = 30;
68
+
69
+ /**
70
+ * Whether the NOTE column shows: only while some row has a note, and ACTION
71
+ * keeps ACTION_MIN_WIDTH cells beside it. At 80 cells an empty NOTE took 26
72
+ * while ACTION read "Change the focused pa…".
73
+ */
74
+ function showsKeybindingNotes(width: number, keyColumnWidth: number, anyNote: boolean): boolean {
75
+ return anyNote && width - TABLE_CHROME - keyColumnWidth - NOTE_COLUMN_WIDTH >= ACTION_MIN_WIDTH;
76
+ }
66
77
 
67
78
  type KeybindingColumnId = "key" | "action" | "note";
68
79
  type KeybindingColumn = DataTableColumn & { id: KeybindingColumnId };
@@ -371,13 +382,16 @@ export function KeybindingsEditor({
371
382
  () => badgeColumnWidth([...bindableRows.map((row) => row.chords), [t("Press a key")]]),
372
383
  [bindableRows],
373
384
  );
385
+ // Decided from every row, not the rows on screen, so ACTION's width holds while the table scrolls.
386
+ const anyNote = useMemo(() => bindableRows.some((row) => !!row.note), [bindableRows]);
387
+ const showNotes = showsKeybindingNotes(width, keyColumnWidth, anyNote);
374
388
  const columns = useMemo<KeybindingColumn[]>(() => [
375
389
  { id: "key", label: "KEY", width: keyColumnWidth, align: "left" },
376
390
  { id: "action", label: "ACTION", width: 20, align: "left", flexGrow: 1 },
377
- ...(width >= NOTE_COLUMN_MIN_TABLE_WIDTH
391
+ ...(showNotes
378
392
  ? [{ id: "note" as const, label: "NOTE", width: NOTE_COLUMN_WIDTH, align: "left" as const }]
379
393
  : []),
380
- ], [keyColumnWidth, width]);
394
+ ], [keyColumnWidth, showNotes]);
381
395
 
382
396
  const renderCell = useCallback((
383
397
  row: EditorRow,
@@ -25,10 +25,18 @@ function throwIfAborted(signal: AbortSignal | undefined): void {
25
25
  }
26
26
 
27
27
  /**
28
- * Reads the company's Form 4 filings newest first, one at a time, until
29
- * `limit` of them are its own. A form it filed as an owner of another
30
- * company's shares is read and left out, so a list of only those is read to
31
- * the end before it can say there are none.
28
+ * Form 4 documents read at once: a list is read in a few round trips, not one
29
+ * per filing, and never more than the service reads from the SEC at once.
30
+ */
31
+ const CONTENT_READS_AT_ONCE = 4;
32
+
33
+ /**
34
+ * Reads the company's Form 4 filings newest first until `limit` of them are
35
+ * its own, up to four documents at a time ahead of the one being looked at
36
+ * and never more than are still wanted (one at a time, `insider OXY` took
37
+ * 6-8 s for its 20). A form it filed as an
38
+ * owner of another company's shares is read and left out, so a list of only
39
+ * those is read to the end before it can say there are none.
32
40
  */
33
41
  export async function loadParsedInsiderFilings(
34
42
  provider: DataProvider,
@@ -37,25 +45,34 @@ export async function loadParsedInsiderFilings(
37
45
  ): Promise<InsiderFilingsLoad> {
38
46
  if (!provider.getSecFilings) throw new Error("Insider filing data unavailable");
39
47
  if (!provider.getSecFilingContent) throw new Error("Insider filing content unavailable");
48
+ const readContent = provider.getSecFilingContent.bind(provider);
40
49
  const filings = await provider.getSecFilings(symbol, SEC_FILING_SCAN_LIMIT, options.exchange ?? "");
50
+ const forms = filings.filter((filing) => isInsiderForm(filing.form));
51
+ const reads: Array<Promise<{ content: string | null } | null>> = [];
52
+ const read = (index: number) => reads[index] ??= readContent(forms[index]!).then(
53
+ (content) => ({ content }),
54
+ () => {
55
+ // Intentional ignore: an unread filing may be the company's own, so it stays as a row that says it was not read.
56
+ return null;
57
+ },
58
+ );
41
59
 
42
60
  const parsed: ParsedInsiderFiling[] = [];
43
61
  let own = 0;
44
- for (const filing of filings) {
45
- if (own >= options.limit) break;
46
- if (!isInsiderForm(filing.form)) continue;
62
+ for (let index = 0; index < forms.length && own < options.limit; index += 1) {
63
+ throwIfAborted(options.signal);
64
+ // Never more in flight than filings still wanted: each read is at most one of them.
65
+ const window = Math.min(CONTENT_READS_AT_ONCE, options.limit - own);
66
+ for (let ahead = index; ahead < Math.min(forms.length, index + window); ahead += 1) read(ahead);
67
+ const filing = forms[index]!;
68
+ const result = await read(index);
47
69
  throwIfAborted(options.signal);
48
- let content: string | null;
49
- try {
50
- content = await provider.getSecFilingContent(filing);
51
- } catch {
52
- throwIfAborted(options.signal);
53
- // An unread filing may be the company's own; it stays as a row that says so.
70
+ if (!result) {
54
71
  parsed.push({ filing, transaction: null, isLoading: false });
55
72
  own += 1;
56
73
  continue;
57
74
  }
58
- const entries = parseInsiderFiling(filing, content);
75
+ const entries = parseInsiderFiling(filing, result.content);
59
76
  if (entries.length === 0) continue;
60
77
  parsed.push(...entries);
61
78
  own += 1;
@@ -13,6 +13,7 @@ import { formatShortDate } from "../../../utils/datetime-format";
13
13
  import { displayWidth, formatCompact } from "../../../utils/format";
14
14
  import type { SortComparableValue } from "../../../utils/sort-values";
15
15
  import { formatInsiderName } from "./display";
16
+ import { MARKET_CAP_BAND_OPTIONS } from "../shared/market-cap-bands";
16
17
  import { DEFAULT_INSIDER_SIGNAL_WINDOW, DEFAULT_INSIDER_SIGNALS_QUERY, INSIDER_SIGNAL_WINDOWS, type InsiderSignalsQuery } from "./signals-client";
17
18
 
18
19
  export type InsiderSignalColumnId =
@@ -56,13 +57,7 @@ export const INSIDER_SIGNAL_MIN_OPTIONS: SelectButtonOption[] = [
56
57
  { value: "10000000", label: "$10M+" },
57
58
  ];
58
59
 
59
- export const INSIDER_SIGNAL_CAP_OPTIONS: SelectButtonOption<InsiderSignalCap | "all">[] = [
60
- { value: "all", label: "All" },
61
- { value: "micro", label: "Micro", description: "Under $300M" },
62
- { value: "small", label: "Small", description: "$300M to $2B" },
63
- { value: "mid", label: "Mid", description: "$2B to $10B" },
64
- { value: "large", label: "Large", description: "Over $10B" },
65
- ];
60
+ export const INSIDER_SIGNAL_CAP_OPTIONS: SelectButtonOption<InsiderSignalCap | "all">[] = MARKET_CAP_BAND_OPTIONS;
66
61
 
67
62
  /** The words a side changes: the column headers, the position filter, the empty and coverage lines. */
68
63
  export interface InsiderSideWords {
@@ -202,9 +202,8 @@ export const ivScreenHeadless: HeadlessPaneDefinition<"bundle"> = {
202
202
  ...(dates.reading ? [] : [{ key: "date", header: "As of", format: (value: unknown, row?: unknown) =>
203
203
  typeof value === "string" ? readingLabel(value, (row as RichCheapRow).method, false,
204
204
  { basis: (row as RichCheapRow).basis, stale: (row as RichCheapRow).stale }) : "--" }]),
205
- // The underlying price each reading was taken at, on the date the title or the As of column gives.
205
+ // The underlying's price on the row's own date, the title's or the As of column's; blank when no capture of it is that day's.
206
206
  { key: "spot", header: "Spot", format: (value: unknown) => typeof value === "number" ? formatSpot(value) : "--" },
207
- ...(dates.rankApart ? [{ key: "rankDate", header: "Rank as of", format: (value: unknown) => typeof value === "string" ? `${value} close` : "--" }] : []),
208
207
  { key: "rank", header: "IVR", format: (value: unknown) => formatRank(value as number | null) },
209
208
  { key: "percentile", header: "IVP", format: (value: unknown) => formatRank(value as number | null) },
210
209
  { key: "verdict", header: "Rich/Cheap", format: (value: unknown) => verdictLabel(value as never) },
@@ -46,8 +46,8 @@ function newestSession(...dates: ReadonlyArray<string | null | undefined>): stri
46
46
  return dates.filter((date): date is string => !!date).map((date) => date.slice(0, 10)).sort().at(-1) ?? null;
47
47
  }
48
48
 
49
- /** How many sessions a reading is behind the newest, and whether that makes it stale. */
50
- function staleness(date: string | null | undefined, newest: string | null): { sessionsBehind: number | null; stale: boolean } {
49
+ /** How many sessions a reading is behind the newest, and whether that makes it stale (over `STALE_AFTER_SESSIONS`). */
50
+ export function staleness(date: string | null | undefined, newest: string | null): { sessionsBehind: number | null; stale: boolean } {
51
51
  const behind = date && newest ? sessionsBehind(date.slice(0, 10), newest) : null;
52
52
  return { sessionsBehind: behind, stale: behind != null && behind > STALE_AFTER_SESSIONS };
53
53
  }
@@ -356,14 +356,14 @@ export interface RichCheapRow {
356
356
  stale: boolean;
357
357
  /** Sessions between the reading and the symbol's newest session. */
358
358
  sessionsBehind: number | null;
359
- /** The underlying price the reading was taken at: the session's close, or the spot at the quote capture. */
359
+ /** The underlying's price at the newest reading: the session's close, or the spot at the quote capture. */
360
360
  spot: number | null;
361
361
  rank: number | null;
362
362
  percentile: number | null;
363
- /** Trade close the rank is measured on: the newest trade-close session, which a newer quote reading can be ahead of. */
363
+ /** Trade close the rank is measured on: the session of the IV30 shown, which IVR, IVP and the verdict are read from with it. */
364
364
  rankDate: string | null;
365
365
  termSlope: number | null;
366
- /** The latest reading's one-year IV, dated with IV30. */
366
+ /** The one-year IV of the IV30's own session. */
367
367
  iv1y: number | null;
368
368
  /**
369
369
  * IV1Y percentile on the close IVR and IVP are ranked on. Empty when the 1Y
@@ -388,16 +388,15 @@ export interface RichCheapRow {
388
388
 
389
389
  /**
390
390
  * The dates the screened rows agree on, so each is said once instead of per
391
- * row. The reading (IV30, term slope, IV/HV) and the rank (IVR, IVP) are dated
392
- * apart: a quote reading can be a session ahead of the trade close its rank
393
- * is measured on. A group the rows disagree on gets its own column.
391
+ * row. The reading (IV30, term slope, IV/HV) and the rank (IVR, IVP) are one
392
+ * ranked close where a symbol has one, so a rank is dated as its row is; an
393
+ * unranked reading is dated alone. A group the rows disagree on gets its own
394
+ * column.
394
395
  */
395
396
  export interface RichCheapDates {
396
397
  reading: { date: string; method: IvMethod; basis: IvCloseBasis | null } | null;
397
398
  /** The trade close every ranked row is ranked on. */
398
399
  rank: string | null;
399
- /** Ranked rows are ranked on different closes. */
400
- rankApart: boolean;
401
400
  /** Some risk reversal comes from a different session than its row's reading. */
402
401
  skewApart: boolean;
403
402
  /** Some HV is dated on a different session than the IV it sits beside. */
@@ -413,7 +412,6 @@ export function richCheapDates(rows: readonly RichCheapRow[]): RichCheapDates {
413
412
  reading: first && read.every((row) => row.date === first.date && readingSource(row.method, row.basis) === readingSource(first.method, first.basis) && !row.stale)
414
413
  ? { date: first.date!, method: first.method!, basis: first.basis } : null,
415
414
  rank: firstRanked && ranked.every((row) => row.rankDate === firstRanked.rankDate) ? firstRanked.rankDate : null,
416
- rankApart: !!firstRanked && ranked.some((row) => row.rankDate !== firstRanked.rankDate),
417
415
  skewApart: rows.some((row) => row.riskReversal != null && row.skewDate !== row.date),
418
416
  hvApart: rows.some((row) => row.hv != null && row.hvDate != null && row.hvDate !== row.date),
419
417
  };
@@ -428,28 +426,40 @@ export function verdictFor(percentile: number | null): RichCheap {
428
426
  export function projectRichCheap(rows: readonly IvScreenRow[], hv: ReadonlyMap<string, ScreenHv | null> = new Map()): RichCheapRow[] {
429
427
  return rows.map((row) => {
430
428
  const latest = row.latest;
431
- const iv30 = latest?.iv30 ?? null;
432
429
  const series = hv.get(row.symbol) ?? null;
430
+ // One dated row: IV30, its rank and the verdict all come from the ranked close when there is one,
431
+ // never a newer reading's IV30 beside an older close's rank, nor a rank beside a reading with no IV30.
432
+ const ranked = row.iv30 && Number.isFinite(row.iv30.value) && row.iv30.date ? row.iv30 : null;
433
+ const reading = ranked ? { iv30: ranked.value, date: ranked.date, method: ranked.method, basis: ranked.basis ?? null }
434
+ : latest ? { iv30: latest.iv30, date: latest.date, method: latest.method, basis: latest.basis ?? null } : null;
435
+ const iv30 = reading?.iv30 ?? null;
436
+ const date = reading?.date ?? null;
437
+ // A figure of the reading itself: the series ranked on its session, else the newest reading's when it is that reading.
438
+ const sameSession = (fromLatest: number | null | undefined, stats: IvStats | null | undefined) =>
439
+ date == null ? null : stats?.date === date && Number.isFinite(stats.value) ? stats.value
440
+ : latest?.date === date && latest.method === reading?.method ? fromLatest ?? null : null;
433
441
  // The newest session the symbol reaches: its prices, its backfill and every reading it has.
434
442
  const newest = newestSession(row.coverage?.backfilledThrough, latest?.date, row.iv30?.date, row.iv90?.date, row.iv365?.date,
435
443
  row.skew?.date, series?.date);
436
- const { stale, sessionsBehind: behind } = staleness(latest?.date, newest);
437
- // A rank on a close that old ranks an old figure; so does a skew.
438
- const rankStale = stale || staleness(row.iv30?.date, newest).stale;
444
+ const { stale, sessionsBehind: behind } = staleness(date, newest);
439
445
  const skewStale = row.skew ? staleness(row.skew.date, newest).stale : false;
440
- const percentile = rankStale ? null : row.iv30?.percentile ?? null;
446
+ const rankedNow = !stale && ranked != null && iv30 != null;
447
+ const percentile = rankedNow ? ranked.percentile ?? null : null;
441
448
  // HV on the reading's own date: today's HV beside an old IV says nothing about it.
442
- const atReading = series && !stale && latest?.date ? hvOn(series, latest.date) : null;
449
+ const atReading = series && !stale && date ? hvOn(series, date) : null;
443
450
  const shown = atReading ?? (series?.value != null && series.date ? { date: series.date, value: series.value } : null);
451
+ const iv90 = sameSession(latest?.iv90, row.iv90);
452
+ const iv1y = sameSession(latest?.iv365, row.iv365);
444
453
  return {
445
454
  symbol: row.symbol, status: row.coverageStatus ?? row.status, queuedAt: row.coverage?.addedAt ?? null,
446
455
  backfilledThrough: row.coverage?.backfilledThrough ?? null, warning: row.warnings?.[0] ?? null,
447
- iv30, date: latest?.date ?? null, method: latest?.method ?? null, basis: latest?.basis ?? null,
448
- stale, sessionsBehind: behind, spot: latest?.spot ?? null,
449
- rank: rankStale ? null : row.iv30?.rank ?? null, percentile, rankDate: rankStale ? null : row.iv30?.date ?? null,
450
- termSlope: iv30 != null && latest?.iv90 != null ? iv30 - latest.iv90 : null,
451
- iv1y: latest?.iv365 ?? null,
452
- iv1yPercentile: !rankStale && latest?.iv365 != null && row.iv365 && row.iv365.date === row.iv30?.date ? row.iv365.percentile : null,
456
+ iv30, date, method: reading?.method ?? null, basis: reading?.basis ?? null,
457
+ // The underlying's price on the row's own date: the newest capture's when it is of that session, else none.
458
+ stale, sessionsBehind: behind, spot: latest && date != null && latest.date === date ? latest.spot ?? null : null,
459
+ rank: rankedNow ? ranked.rank ?? null : null, percentile, rankDate: rankedNow ? ranked.date : null,
460
+ termSlope: iv30 != null && iv90 != null ? iv30 - iv90 : null,
461
+ iv1y,
462
+ iv1yPercentile: rankedNow && iv1y != null && row.iv365?.date === date ? row.iv365.percentile : null,
453
463
  riskReversal: skewStale || !row.skew ? null : row.skew.call25 - row.skew.put25, skewDate: skewStale ? null : row.skew?.date ?? null,
454
464
  hv: shown?.value ?? null, hvDate: shown?.date ?? null,
455
465
  ivHv: iv30 != null && atReading != null && atReading.value > 0 ? iv30 / atReading.value : null,
@@ -24,7 +24,6 @@ const COLUMNS: DataTableColumn[] = [
24
24
  { id: "iv30", label: "IV30", width: 7, align: "right" },
25
25
  { id: "date", label: "As of", width: 11, align: "right" },
26
26
  { id: "spot", label: "Spot", width: 9, align: "right" },
27
- { id: "rankDate", label: "Rank as of", width: 11, align: "right" },
28
27
  { id: "rank", label: "IVR", width: 5, align: "right" },
29
28
  { id: "percentile", label: "IVP", width: 5, align: "right" },
30
29
  { id: "verdict", label: "Rich/Cheap", width: 11, align: "left" },
@@ -90,7 +89,6 @@ export function IvScreenPane({ paneId, width, height, focused }: PaneProps) {
90
89
  const columns = useMemo(() => COLUMNS.filter((column) => {
91
90
  switch (column.id) {
92
91
  case "date": return !dates.reading;
93
- case "rankDate": return dates.rankApart;
94
92
  case "iv1y": return rows.some((row) => row.iv1y != null);
95
93
  case "iv1yPercentile": return rows.some((row) => row.iv1yPercentile != null);
96
94
  case "riskReversal": return hasSkew;
@@ -126,7 +124,6 @@ export function IvScreenPane({ paneId, width, height, focused }: PaneProps) {
126
124
  case "spot": return { text: formatSpot(row.spot), color: colors.textDim };
127
125
  case "date": return { text: row.date ? readingLabel(row.date, row.method, true, { basis: row.basis, stale: row.stale })
128
126
  : row.status === "queued" || row.status === "backfilling" ? row.status : "--", color: row.stale ? colors.warning : colors.textDim };
129
- case "rankDate": return { text: row.rankDate ? `${shortDate(row.rankDate)} close` : "--", color: colors.textDim };
130
127
  case "rank": return { text: formatRank(row.rank) };
131
128
  case "percentile": return { text: formatRank(row.percentile) };
132
129
  case "verdict": return { text: verdictLabel(row.verdict), color: row.verdict === "rich" ? colors.negative : row.verdict === "cheap" ? colors.positive : colors.textDim };
@@ -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
  }