gloomberb 0.20.0 → 0.20.2

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (481) hide show
  1. package/README.md +16 -26
  2. package/README.zh-CN.md +21 -65
  3. package/package.json +1 -1
  4. package/patches/electrobun-devkit@2.0.5.patch +268 -8
  5. package/src/account/auth-model.ts +20 -1
  6. package/src/account/upgrade-dialog.tsx +8 -4
  7. package/src/api-client/askg.ts +7 -1
  8. package/src/api-client/auth.ts +27 -0
  9. package/src/api-client/catalysts.ts +2 -0
  10. package/src/api-client/company-kpis.ts +2 -1
  11. package/src/api-client/cot.ts +14 -2
  12. package/src/api-client/crypto-markets.ts +20 -2
  13. package/src/api-client/data.ts +3 -2
  14. package/src/api-client/earnings.ts +46 -3
  15. package/src/api-client/fund-facts.ts +23 -1
  16. package/src/api-client/futures-curve.ts +17 -0
  17. package/src/api-client/index.ts +4 -1
  18. package/src/api-client/one-tap-reasons.ts +42 -0
  19. package/src/api-client/perps.ts +2 -1
  20. package/src/api-client/request.ts +3 -1
  21. package/src/api-client/research-activity.ts +16 -3
  22. package/src/api-client/types/filings-and-calls.ts +9 -0
  23. package/src/api-client/types/search.ts +3 -0
  24. package/src/app/keybindings/chord.ts +153 -9
  25. package/src/app/keybindings/index.ts +1 -1
  26. package/src/app/keybindings/labels.ts +49 -6
  27. package/src/app/runtime/desktop-deeplink.ts +73 -8
  28. package/src/app/runtime/plugin-seed.ts +119 -0
  29. package/src/app/runtime/startup.ts +45 -9
  30. package/src/app.tsx +8 -1
  31. package/src/architecture/core-builtin-allowlist.json +1 -2
  32. package/src/architecture/pane-tabs-allowlist.json +2 -1
  33. package/src/architecture/shortcut-labels-allowlist.json +11 -0
  34. package/src/architecture/ui-literals-allowlist.json +8 -8
  35. package/src/brokers/broker-portfolio-sync.ts +1 -1
  36. package/src/cli/bank-section.ts +26 -12
  37. package/src/cli/board-coins.ts +38 -5
  38. package/src/cli/commands/crypto-hints.ts +8 -1
  39. package/src/cli/commands/market.ts +294 -100
  40. package/src/cli/commands/overview.ts +13 -6
  41. package/src/cli/commands/ticker.ts +73 -21
  42. package/src/cli/company-name-hint.ts +19 -0
  43. package/src/cli/desktop-pane-shot-browser.ts +47 -31
  44. package/src/cli/desktop-pane-shot.ts +15 -0
  45. package/src/cli/entry.ts +15 -4
  46. package/src/cli/export-source.ts +7 -1
  47. package/src/cli/freshness.ts +0 -16
  48. package/src/cli/fx-pair.ts +64 -12
  49. package/src/cli/fx-quote-rate.ts +144 -0
  50. package/src/cli/glossary.ts +30 -0
  51. package/src/cli/helpers.ts +4 -2
  52. package/src/cli/history-back-adjust.ts +122 -0
  53. package/src/cli/history-rows.ts +114 -10
  54. package/src/cli/index.ts +4 -1
  55. package/src/cli/known-gaps.ts +45 -3
  56. package/src/cli/listing-arg.ts +48 -4
  57. package/src/cli/name-entries.ts +25 -5
  58. package/src/cli/not-a-ticker.ts +26 -1
  59. package/src/cli/pane-functions/catalog.ts +12 -2
  60. package/src/cli/pane-functions/dom.ts +4 -2
  61. package/src/cli/pane-functions/freshness.ts +45 -29
  62. package/src/cli/pane-functions/headless.ts +8 -5
  63. package/src/cli/pane-functions/index.ts +3 -0
  64. package/src/cli/pane-functions/market-session.ts +14 -5
  65. package/src/cli/pane-functions/resolver.ts +4 -1
  66. package/src/cli/pane-functions/screenshot-assessment.ts +15 -3
  67. package/src/cli/pane-functions/screenshot-payload.ts +130 -66
  68. package/src/cli/pane-functions/screenshot-render.ts +14 -2
  69. package/src/cli/pane-functions/screenshot-types.ts +4 -0
  70. package/src/cli/restore-plugins.ts +164 -51
  71. package/src/cli/symbol-rows.ts +22 -2
  72. package/src/cli/ticker-resolution.ts +74 -17
  73. package/src/components/chart/composite/axis-overlays.tsx +13 -3
  74. package/src/components/chart/composite/composite-chart.tsx +8 -1
  75. package/src/components/chart/composite/format.ts +16 -1
  76. package/src/components/chart/composite/legend.tsx +4 -3
  77. package/src/components/chart/composite/panel-labels.ts +2 -1
  78. package/src/components/chart/composite/panel-surface.tsx +33 -4
  79. package/src/components/chart/composite/time-scale.ts +1 -1
  80. package/src/components/chart/composite/toolbar.tsx +8 -4
  81. package/src/components/chart/composite/types.ts +17 -1
  82. package/src/components/chart/composite/use-composite-chart-keyboard.ts +15 -5
  83. package/src/components/chart/composite/use-composite-viewport.ts +31 -8
  84. package/src/components/chart/static/scatter-chart-surface.tsx +25 -9
  85. package/src/components/chart-table/axis.ts +11 -0
  86. package/src/components/chart-table/header.tsx +10 -1
  87. package/src/components/chart-table/layout.ts +14 -5
  88. package/src/components/command-bar/assist/inventory.ts +3 -2
  89. package/src/components/command-bar/commands/collection-list.ts +3 -2
  90. package/src/components/command-bar/panel/index.tsx +13 -0
  91. package/src/components/command-bar/panel/layout.ts +15 -1
  92. package/src/components/command-bar/panel/prompt-width.ts +34 -0
  93. package/src/components/command-bar/panel/runtime.ts +1 -0
  94. package/src/components/command-bar/panel/state.ts +4 -0
  95. package/src/components/command-bar/panel/types.ts +2 -0
  96. package/src/components/command-bar/routes/root/search-providers.ts +3 -2
  97. package/src/components/command-bar/routes/root/search-report.ts +2 -2
  98. package/src/components/command-bar/workflow/ticker-listing-picker.ts +1 -0
  99. package/src/components/company-logo.tsx +2 -2
  100. package/src/components/data-table/view.tsx +11 -2
  101. package/src/components/feed-data-table/stack-view.tsx +20 -6
  102. package/src/components/feedback-dialog.tsx +3 -1
  103. package/src/components/form-modal/field-row.tsx +1 -1
  104. package/src/components/form-modal/routes.ts +1 -0
  105. package/src/components/index.ts +1 -1
  106. package/src/components/layout/header.tsx +12 -3
  107. package/src/components/layout/market-summary.ts +2 -1
  108. package/src/components/layout/pane/footer/index.tsx +9 -5
  109. package/src/components/layout/pane/footer/model.ts +26 -10
  110. package/src/components/layout/pane/footer/registration.tsx +60 -1
  111. package/src/components/layout/pane/header-tabs.tsx +17 -3
  112. package/src/components/layout/pane/header.tsx +5 -2
  113. package/src/components/layout/pane/pane-tabs.tsx +57 -3
  114. package/src/components/layout/shell/active-drag.ts +38 -30
  115. package/src/components/layout/shell/drag/index.ts +51 -21
  116. package/src/components/layout/shell/menu.ts +3 -5
  117. package/src/components/layout/shell/pane/actions.ts +4 -1
  118. package/src/components/layout/shell/pane/ask.ts +5 -2
  119. package/src/components/layout/status-bar.tsx +59 -54
  120. package/src/components/markdown-text.tsx +35 -10
  121. package/src/components/onboarding/first-run-workspace.ts +25 -23
  122. package/src/components/onboarding/onboarding-keyboard.ts +6 -1
  123. package/src/components/onboarding/onboarding-wizard.tsx +12 -2
  124. package/src/components/onboarding/portfolio-step/positions-panel.tsx +3 -3
  125. package/src/components/onboarding/use-onboarding-broker-form.ts +2 -1
  126. package/src/components/onboarding/use-onboarding-progress.ts +11 -4
  127. package/src/components/onboarding/use-onboarding-upgrade.ts +3 -2
  128. package/src/components/onboarding/wizard-positions.ts +8 -1
  129. package/src/components/pane-notice-seen.ts +125 -0
  130. package/src/components/pane-settings-dialog/field-dialogs.tsx +2 -1
  131. package/src/components/pane-settings-dialog.tsx +7 -6
  132. package/src/components/sign-in-code-panel.tsx +3 -2
  133. package/src/components/speedometer-gauge/terminal.tsx +30 -9
  134. package/src/components/ticker/list-table-view.tsx +39 -3
  135. package/src/components/ui/confirm-dialog.tsx +2 -1
  136. package/src/components/ui/data-table/index.tsx +4 -2
  137. package/src/components/ui/data-table/opentui/index.tsx +15 -5
  138. package/src/components/ui/data-table/types.ts +8 -0
  139. package/src/components/ui/external-link.tsx +4 -1
  140. package/src/components/ui/field-grid.tsx +1 -1
  141. package/src/components/ui/index.ts +2 -0
  142. package/src/components/ui/inline-quick-add.tsx +5 -0
  143. package/src/components/ui/multi-select/dialog.tsx +10 -9
  144. package/src/components/ui/pane-link-chip.tsx +354 -0
  145. package/src/components/ui/query-bar.tsx +22 -13
  146. package/src/components/ui/ratio-bar.tsx +24 -1
  147. package/src/components/ui/select-button.tsx +2 -1
  148. package/src/components/ui/shortcut-hint.tsx +6 -3
  149. package/src/components/ui/table-layout.ts +81 -0
  150. package/src/components/ui/tabs.tsx +45 -6
  151. package/src/components/use-pane-notice-footer.tsx +12 -4
  152. package/src/core/app-service-ports.ts +1 -1
  153. package/src/data/plugin-state-store.ts +44 -8
  154. package/src/docs/snapshot.json +53 -32
  155. package/src/i18n/es.ts +28 -6
  156. package/src/i18n/ja.ts +28 -5
  157. package/src/i18n/ko.ts +28 -5
  158. package/src/i18n/zh-cn.ts +28 -5
  159. package/src/i18n/zh-tw.ts +28 -5
  160. package/src/layout/pane-manager/gridlock-inference.ts +2 -1
  161. package/src/layout/pane-manager/gridlock.ts +47 -2
  162. package/src/layout-marketplace/api.ts +1 -0
  163. package/src/layout-marketplace/gallery.tsx +4 -3
  164. package/src/layout-marketplace/linked.ts +6 -4
  165. package/src/layout-marketplace/model.ts +3 -2
  166. package/src/market-data/fund-facts.ts +7 -1
  167. package/src/market-data/futures-contract.ts +77 -31
  168. package/src/market-data/fx-closes.ts +5 -2
  169. package/src/market-data/hooks.tsx +23 -0
  170. package/src/market-data/market/change-basis.ts +92 -14
  171. package/src/market-data/market/format.ts +81 -13
  172. package/src/market-data/market/futures-week.ts +3 -1
  173. package/src/market-data/market/globex-day.ts +73 -0
  174. package/src/market-data/market/index-level.ts +10 -1
  175. package/src/market-data/quotes/intraday-bar.ts +1 -1
  176. package/src/market-data/quotes/session-split.ts +28 -0
  177. package/src/plugins/builtin/account-management/pane.tsx +1 -1
  178. package/src/plugins/builtin/analytics/account-returns.ts +1 -1
  179. package/src/plugins/builtin/analytics/index.tsx +10 -3
  180. package/src/plugins/builtin/analytics/pane-model.ts +1 -1
  181. package/src/plugins/builtin/analytics/risk-client.ts +4 -1
  182. package/src/plugins/builtin/analytics/risk-episodes.ts +422 -0
  183. package/src/plugins/builtin/analytics/risk-fx.ts +1 -1
  184. package/src/plugins/builtin/analytics/risk-headless.ts +28 -10
  185. package/src/plugins/builtin/analytics/risk-math.ts +1 -1
  186. package/src/plugins/builtin/analytics/risk-model.ts +115 -26
  187. package/src/plugins/builtin/analytics/risk-pane.tsx +201 -23
  188. package/src/plugins/builtin/analytics/sharpe-cadence.ts +1 -1
  189. package/src/plugins/builtin/backtest/format.ts +14 -0
  190. package/src/plugins/builtin/backtest/pane.tsx +3 -3
  191. package/src/plugins/builtin/backtest/report.ts +5 -3
  192. package/src/plugins/builtin/broker-manager/add-request.ts +10 -1
  193. package/src/plugins/builtin/broker-trading/pane.tsx +20 -2
  194. package/src/plugins/builtin/buildout/company/flow.tsx +5 -5
  195. package/src/plugins/builtin/buildout/company/model.ts +14 -2
  196. package/src/plugins/builtin/catalysts/detail.tsx +2 -2
  197. package/src/plugins/builtin/catalysts/model.ts +7 -2
  198. package/src/plugins/builtin/catalysts/pane.tsx +2 -2
  199. package/src/plugins/builtin/chart-composer/headless.ts +57 -17
  200. package/src/plugins/builtin/chart-composer/session-range.ts +82 -3
  201. package/src/plugins/builtin/chat/message/pane-chip.tsx +36 -208
  202. package/src/plugins/builtin/cloud/askg/answer-follow-ups.tsx +61 -0
  203. package/src/plugins/builtin/cloud/askg/answer-sources.tsx +102 -0
  204. package/src/plugins/builtin/cloud/askg/controller.ts +7 -1
  205. package/src/plugins/builtin/cloud/askg/host.ts +57 -0
  206. package/src/plugins/builtin/cloud/askg/model.ts +45 -5
  207. package/src/plugins/builtin/cloud/askg/pane.tsx +304 -25
  208. package/src/plugins/builtin/cloud/askg/protocol.ts +26 -1
  209. package/src/plugins/builtin/cloud/askg/sources.ts +466 -0
  210. package/src/plugins/builtin/cloud/one-tap/controller.ts +309 -0
  211. package/src/plugins/builtin/cloud/one-tap/google-identity.ts +142 -0
  212. package/src/plugins/builtin/cloud/one-tap/one-tap-prompt.tsx +101 -0
  213. package/src/plugins/builtin/cloud/plugin.tsx +7 -1
  214. package/src/plugins/builtin/company-kpis/client.ts +4 -3
  215. package/src/plugins/builtin/company-kpis/model.ts +34 -3
  216. package/src/plugins/builtin/correlation/compute.ts +8 -2
  217. package/src/plugins/builtin/correlation/headless.ts +10 -9
  218. package/src/plugins/builtin/correlation/history.ts +30 -0
  219. package/src/plugins/builtin/correlation/index.tsx +39 -167
  220. package/src/plugins/builtin/correlation/matrix/grid.tsx +285 -0
  221. package/src/plugins/builtin/correlation/matrix/model.ts +10 -10
  222. package/src/plugins/builtin/correlation/relationship/model.ts +3 -6
  223. package/src/plugins/builtin/correlation/relationship/pane.tsx +7 -9
  224. package/src/plugins/builtin/correlation/relationship/view-model.ts +14 -5
  225. package/src/plugins/builtin/cot/client.ts +8 -3
  226. package/src/plugins/builtin/cot/headless.ts +65 -12
  227. package/src/plugins/builtin/cot/pane.tsx +11 -5
  228. package/src/plugins/builtin/crypto-board/client.ts +6 -1
  229. package/src/plugins/builtin/crypto-board/defi-view.tsx +12 -1
  230. package/src/plugins/builtin/crypto-board/defi.ts +44 -7
  231. package/src/plugins/builtin/crypto-board/headless.ts +83 -12
  232. package/src/plugins/builtin/crypto-board/model.ts +30 -6
  233. package/src/plugins/builtin/crypto-board/pane.tsx +13 -2
  234. package/src/plugins/builtin/earnings/client.ts +40 -6
  235. package/src/plugins/builtin/earnings/fiscal-quarter.ts +54 -0
  236. package/src/plugins/builtin/earnings/headless.ts +47 -11
  237. package/src/plugins/builtin/earnings/history-model.ts +136 -24
  238. package/src/plugins/builtin/earnings/history-table.ts +42 -10
  239. package/src/plugins/builtin/earnings/history.tsx +23 -8
  240. package/src/plugins/builtin/earnings-ripple/client.ts +5 -2
  241. package/src/plugins/builtin/earnings-ripple/headless.ts +8 -3
  242. package/src/plugins/builtin/earnings-ripple/model.ts +21 -0
  243. package/src/plugins/builtin/earnings-ripple/pane.tsx +2 -3
  244. package/src/plugins/builtin/econ/index.tsx +5 -4
  245. package/src/plugins/builtin/econ-statistics/stats.ts +13 -5
  246. package/src/plugins/builtin/equity-screener/headless.ts +2 -1
  247. package/src/plugins/builtin/filing-events/feed.ts +56 -18
  248. package/src/plugins/builtin/filing-events/pane.tsx +8 -2
  249. package/src/plugins/builtin/futures/index.tsx +32 -10
  250. package/src/plugins/builtin/futures/model.ts +93 -6
  251. package/src/plugins/builtin/futures/returns.ts +29 -7
  252. package/src/plugins/builtin/futures/table.tsx +59 -17
  253. package/src/plugins/builtin/futures/use-front-returns.ts +32 -6
  254. package/src/plugins/builtin/futures-curve/client.ts +12 -2
  255. package/src/plugins/builtin/futures-curve/headless.ts +58 -17
  256. package/src/plugins/builtin/futures-curve/model.ts +111 -15
  257. package/src/plugins/builtin/futures-curve/pane.tsx +11 -6
  258. package/src/plugins/builtin/fx-matrix/amount.ts +132 -0
  259. package/src/plugins/builtin/fx-matrix/headless.ts +53 -13
  260. package/src/plugins/builtin/fx-matrix/index.tsx +205 -42
  261. package/src/plugins/builtin/fx-matrix/pairs.ts +10 -8
  262. package/src/plugins/builtin/fx-matrix/settings.ts +22 -1
  263. package/src/plugins/builtin/help/index.tsx +68 -61
  264. package/src/plugins/builtin/holders/format.ts +7 -2
  265. package/src/plugins/builtin/holders/pane.tsx +11 -3
  266. package/src/plugins/builtin/holders/report-header.ts +5 -4
  267. package/src/plugins/builtin/holders/report-rows.ts +4 -1
  268. package/src/plugins/builtin/holders/treemap.tsx +5 -3
  269. package/src/plugins/builtin/insider/signals-model.ts +4 -5
  270. package/src/plugins/builtin/ipo-calendar/headless.ts +18 -7
  271. package/src/plugins/builtin/ipo-calendar/listing-ipo.ts +3 -1
  272. package/src/plugins/builtin/ipo-calendar/model.ts +28 -8
  273. package/src/plugins/builtin/ipo-calendar/pane.tsx +2 -1
  274. package/src/plugins/builtin/kelly-sizer/headless.ts +4 -0
  275. package/src/plugins/builtin/perps/headless.ts +81 -19
  276. package/src/plugins/builtin/perps/index.tsx +3 -1
  277. package/src/plugins/builtin/perps/model.ts +1 -1
  278. package/src/plugins/builtin/perps/pane.tsx +2 -0
  279. package/src/plugins/builtin/portfolio-list/cell-version.ts +1 -0
  280. package/src/plugins/builtin/portfolio-list/cli/bulk-symbols.ts +20 -1
  281. package/src/plugins/builtin/portfolio-list/cli/import-positions.ts +260 -0
  282. package/src/plugins/builtin/portfolio-list/cli/period-report.ts +154 -0
  283. package/src/plugins/builtin/portfolio-list/cli/portfolio-command.ts +64 -22
  284. package/src/plugins/builtin/portfolio-list/cli/render.ts +18 -7
  285. package/src/plugins/builtin/portfolio-list/cli/watchlist-command.ts +5 -3
  286. package/src/plugins/builtin/portfolio-list/grid.tsx +56 -12
  287. package/src/plugins/builtin/portfolio-list/headless.ts +128 -0
  288. package/src/plugins/builtin/portfolio-list/pane/index.tsx +42 -4
  289. package/src/plugins/builtin/portfolio-list/pane/period-pnl.ts +124 -0
  290. package/src/plugins/builtin/portfolio-list/period-pnl.ts +179 -0
  291. package/src/plugins/builtin/portfolio-list/positions-import/dialog.tsx +445 -0
  292. package/src/plugins/builtin/portfolio-list/positions-import/index.tsx +255 -0
  293. package/src/plugins/builtin/portfolio-list/positions-import/lookup.ts +78 -0
  294. package/src/plugins/builtin/portfolio-list/positions-import/read-file.ts +32 -0
  295. package/src/plugins/builtin/portfolio-list/quick-add/index.tsx +186 -50
  296. package/src/plugins/builtin/portfolio-list/quick-add/resolution.ts +118 -4
  297. package/src/plugins/builtin/portfolio-list/settings.ts +25 -0
  298. package/src/plugins/builtin/portfolio-list/summary/index.tsx +16 -1
  299. package/src/plugins/builtin/portfolio-list/summary/totals.ts +7 -5
  300. package/src/plugins/builtin/portfolio-list/table.tsx +105 -6
  301. package/src/plugins/builtin/power/headless.ts +47 -9
  302. package/src/plugins/builtin/research/relative-valuation-model.ts +8 -3
  303. package/src/plugins/builtin/research-search/article.ts +12 -2
  304. package/src/plugins/builtin/research-search/data.ts +5 -2
  305. package/src/plugins/builtin/research-search/document-view.tsx +1 -1
  306. package/src/plugins/builtin/research-search/model.ts +47 -3
  307. package/src/plugins/builtin/research-search/pane.tsx +3 -2
  308. package/src/plugins/builtin/reverse-dcf/model.ts +7 -4
  309. package/src/plugins/builtin/risk-factors/headless.ts +3 -2
  310. package/src/plugins/builtin/risk-factors/index.tsx +2 -28
  311. package/src/plugins/builtin/risk-factors/lock-note.ts +58 -0
  312. package/src/plugins/builtin/risk-factors/pane.tsx +14 -5
  313. package/src/plugins/builtin/scanner/flow-model.ts +17 -13
  314. package/src/plugins/builtin/scanner/flow-pane.tsx +8 -9
  315. package/src/plugins/builtin/scanner/flow-session.ts +2 -9
  316. package/src/plugins/builtin/scanner/hilo-model.ts +4 -3
  317. package/src/plugins/builtin/sec/filing-display.tsx +0 -5
  318. package/src/plugins/builtin/sec/forms.ts +19 -0
  319. package/src/plugins/builtin/sec/fund-facts.ts +45 -11
  320. package/src/plugins/builtin/sec/headless.ts +37 -12
  321. package/src/plugins/builtin/sec/index.tsx +37 -8
  322. package/src/plugins/builtin/shared/earnings-calendar.ts +6 -3
  323. package/src/plugins/builtin/shared/earnings-report.ts +1 -1
  324. package/src/plugins/builtin/shared/fx-rate-freshness.ts +0 -35
  325. package/src/plugins/builtin/shared/pro-lock-note.ts +5 -1
  326. package/src/plugins/builtin/shared/use-quote-board.ts +42 -27
  327. package/src/plugins/builtin/supply-chain/graph-model.ts +7 -1
  328. package/src/plugins/builtin/supply-chain/headless.ts +20 -10
  329. package/src/plugins/builtin/supply-chain/model.ts +117 -20
  330. package/src/plugins/builtin/supply-chain/pane.tsx +22 -15
  331. package/src/plugins/builtin/supply-chain/row-evidence.tsx +1 -1
  332. package/src/plugins/builtin/ticker-detail/data-panes/returns-chart-model.ts +69 -0
  333. package/src/plugins/builtin/ticker-detail/data-panes/returns-chart.tsx +118 -0
  334. package/src/plugins/builtin/ticker-detail/data-panes/returns-model.ts +1 -1
  335. package/src/plugins/builtin/ticker-detail/data-panes/returns-pane.tsx +103 -40
  336. package/src/plugins/builtin/ticker-detail/headless-schema.ts +10 -1
  337. package/src/plugins/builtin/ticker-detail/headless.ts +8 -1
  338. package/src/plugins/builtin/ticker-detail/overview/components.tsx +2 -1
  339. package/src/plugins/builtin/ticker-detail/overview/model.ts +18 -8
  340. package/src/plugins/builtin/ticker-detail/overview-tab.tsx +11 -8
  341. package/src/plugins/builtin/ticker-detail/pane.tsx +95 -20
  342. package/src/plugins/builtin/ticker-detail/research-groups.ts +89 -0
  343. package/src/plugins/builtin/ticker-detail/settings.ts +4 -3
  344. package/src/plugins/builtin/time-sales/headless.ts +23 -7
  345. package/src/plugins/builtin/time-sales/index.tsx +2 -2
  346. package/src/plugins/builtin/volatility/charts.tsx +2 -2
  347. package/src/plugins/extracted-plugins.ts +49 -24
  348. package/src/plugins/host-resolver.ts +3 -2
  349. package/src/plugins/installer.ts +220 -31
  350. package/src/plugins/running-installs.ts +34 -0
  351. package/src/plugins/seed-progress.ts +72 -0
  352. package/src/portfolio/column-values.ts +42 -8
  353. package/src/portfolio/futures-positions.ts +10 -2
  354. package/src/portfolio/mutations.ts +4 -3
  355. package/src/portfolio/period-pnl.ts +119 -0
  356. package/src/portfolio/positions-import/describe.ts +89 -0
  357. package/src/portfolio/positions-import/parse.ts +682 -0
  358. package/src/portfolio/positions-import/plan.ts +295 -0
  359. package/src/{plugins/builtin/analytics/metrics.ts → portfolio/return-metrics.ts} +24 -11
  360. package/src/public/__snapshots__/public-api.test.ts.snap +1 -0
  361. package/src/react/jsx-dev-fallback.ts +62 -0
  362. package/src/renderers/browser/cloud-transport.ts +1 -1
  363. package/src/renderers/browser/config-host.ts +3 -1
  364. package/src/renderers/browser/deeplink-bridge.ts +8 -1
  365. package/src/renderers/browser/http-proxy-transport.ts +9 -2
  366. package/src/renderers/browser/main.tsx +2 -1
  367. package/src/renderers/browser/research-entry.ts +12 -0
  368. package/src/renderers/cloudflare/http-proxy.ts +8 -2
  369. package/src/renderers/cloudflare/proxy-session.ts +1 -0
  370. package/src/renderers/cloudflare/worker.ts +12 -3
  371. package/src/renderers/dom/desktop/audio-player.tsx +2 -2
  372. package/src/renderers/dom/desktop/controls.tsx +1 -1
  373. package/src/renderers/dom/desktop/dialog-actions.tsx +10 -24
  374. package/src/renderers/dom/desktop/icons.tsx +4 -2
  375. package/src/renderers/dom/desktop/query-bar.tsx +23 -19
  376. package/src/renderers/dom/dom-host-providers.tsx +7 -2
  377. package/src/renderers/dom/host/box.tsx +2 -2
  378. package/src/renderers/dom/host/input.tsx +13 -0
  379. package/src/renderers/dom/key-event.ts +1 -0
  380. package/src/renderers/dom/styles.css +3 -0
  381. package/src/renderers/electrobun/bun/context-menu/click.ts +1 -0
  382. package/src/renderers/electrobun/bun/desktop/backend.ts +15 -0
  383. package/src/renderers/electrobun/bun/desktop/capability-bridge.ts +5 -4
  384. package/src/renderers/electrobun/bun/desktop/host-requests.ts +19 -11
  385. package/src/renderers/electrobun/bun/desktop/http-fetch.ts +1 -0
  386. package/src/renderers/electrobun/bun/desktop/http-stream.ts +1 -1
  387. package/src/renderers/electrobun/bun/desktop/initialization.ts +27 -15
  388. package/src/renderers/electrobun/bun/desktop/install-records.ts +4 -1
  389. package/src/renderers/electrobun/bun/desktop/installer-folder.ts +5 -2
  390. package/src/renderers/electrobun/bun/desktop/macos-objc.ts +3 -1
  391. package/src/renderers/electrobun/bun/desktop/screen-setup-file.ts +9 -4
  392. package/src/renderers/electrobun/bun/desktop/update.ts +27 -13
  393. package/src/renderers/electrobun/bun/desktop/windows-script.ts +6 -2
  394. package/src/renderers/electrobun/bun/index.ts +5 -0
  395. package/src/renderers/electrobun/bun/window/attention.ts +1 -0
  396. package/src/renderers/electrobun/bun/window/boot-frame.ts +1 -0
  397. package/src/renderers/electrobun/bun/window/context-menu-thread.ts +84 -0
  398. package/src/renderers/electrobun/bun/window/create.ts +1 -0
  399. package/src/renderers/electrobun/bun/window/electrobun-window-host.ts +13 -8
  400. package/src/renderers/electrobun/bun/window/native-call-thread.ts +224 -0
  401. package/src/renderers/electrobun/bun/window/native-min-size.ts +1 -1
  402. package/src/renderers/electrobun/bun/window/native-timing.ts +10 -0
  403. package/src/renderers/electrobun/bun/window/remembered-frame.ts +1 -0
  404. package/src/renderers/electrobun/bun/window/script-for-webview.ts +15 -0
  405. package/src/renderers/electrobun/bun/window/webview-script-thread.ts +82 -0
  406. package/src/renderers/electrobun/bun/window/windows-native.ts +3 -1
  407. package/src/renderers/electrobun/bun/window/windows-quit.ts +3 -1
  408. package/src/renderers/electrobun/shared/protocol.ts +13 -2
  409. package/src/renderers/electrobun/view/app-badge-host.ts +2 -1
  410. package/src/renderers/electrobun/view/backend-rpc.ts +7 -0
  411. package/src/renderers/electrobun/view/capability-subscription.ts +2 -1
  412. package/src/renderers/electrobun/view/cli-pane-shot-entry.tsx +7 -10
  413. package/src/renderers/electrobun/view/cli-pane-shot-frame.tsx +1 -1
  414. package/src/renderers/electrobun/view/cli-pane-shot-mutations.ts +36 -0
  415. package/src/renderers/electrobun/view/http-fetch.ts +2 -1
  416. package/src/renderers/electrobun/view/main.tsx +13 -7
  417. package/src/renderers/electrobun/view/remote/capability-invoker.ts +6 -3
  418. package/src/renderers/electrobun/view/remote/persistence.ts +63 -27
  419. package/src/renderers/electrobun/view/rpc-timeout.ts +1 -0
  420. package/src/renderers/electrobun/view/ui-host.tsx +3 -2
  421. package/src/renderers/electrobun/view/window-fullscreen.ts +3 -1
  422. package/src/renderers/opentui/browser-open.ts +2 -1
  423. package/src/renderers/opentui/dialog-host.tsx +1 -1
  424. package/src/renderers/opentui/interaction-performance.ts +3 -1
  425. package/src/renderers/opentui/start.tsx +5 -1
  426. package/src/renderers/opentui/terminal-media.ts +11 -6
  427. package/src/renderers/opentui/ui-host.tsx +5 -8
  428. package/src/shares/open.ts +22 -1
  429. package/src/shares/pane.ts +2 -1
  430. package/src/sources/gloomberb-cloud/normalizers.ts +3 -0
  431. package/src/sync/analytics-payload.ts +194 -0
  432. package/src/sync/baseline.ts +19 -9
  433. package/src/sync/broker-identity.ts +171 -0
  434. package/src/sync/broker-instances.ts +137 -0
  435. package/src/sync/collections-contributor.ts +173 -0
  436. package/src/sync/config-contributor.ts +100 -0
  437. package/src/sync/config-merge.ts +229 -0
  438. package/src/sync/controller.ts +139 -28
  439. package/src/sync/core-contributors.ts +8 -1583
  440. package/src/sync/history-memo.ts +32 -0
  441. package/src/sync/layout-merge.ts +259 -0
  442. package/src/sync/sanitize.ts +114 -0
  443. package/src/sync/ticker-merge.ts +208 -0
  444. package/src/sync/ticker-payload.ts +81 -0
  445. package/src/sync/types.ts +15 -1
  446. package/src/telemetry/attention-setting.ts +1 -1
  447. package/src/telemetry/stall-reports.ts +21 -4
  448. package/src/telemetry/usage-counts.ts +16 -0
  449. package/src/test-support/preload.ts +5 -0
  450. package/src/theme/color-utils.ts +10 -0
  451. package/src/theme/font-scale.ts +34 -3
  452. package/src/theme/series-colors.ts +44 -0
  453. package/src/theme/themes.ts +2 -1
  454. package/src/tickers/batched-lookups.ts +263 -6
  455. package/src/tickers/company-name-listing.ts +44 -2
  456. package/src/tickers/company-name.ts +7 -2
  457. package/src/tickers/search/upsert.ts +16 -1
  458. package/src/time-series/base-series.ts +18 -4
  459. package/src/time-series/studies/indicators.ts +3 -1
  460. package/src/time-series/studies/resolve.ts +1 -1
  461. package/src/time-series/types.ts +6 -0
  462. package/src/types/financials.ts +18 -0
  463. package/src/types/headless.ts +11 -0
  464. package/src/ui/host.tsx +26 -3
  465. package/src/ui/index.tsx +1 -0
  466. package/src/utils/concurrency.ts +6 -0
  467. package/src/utils/currency-pair.ts +56 -4
  468. package/src/utils/datetime-format.ts +11 -0
  469. package/src/utils/decimal-comma.ts +9 -6
  470. package/src/utils/exchanges.ts +32 -0
  471. package/src/utils/fundamentals.ts +41 -0
  472. package/src/utils/main-thread-stall.ts +21 -5
  473. package/src/utils/markdown.ts +4 -2
  474. package/src/utils/pasted-lines.ts +14 -0
  475. package/src/utils/perf-marks.ts +88 -9
  476. package/src/utils/price-window.ts +2 -1
  477. package/src/utils/reported-money.ts +9 -2
  478. package/src/utils/sec-filings.ts +17 -0
  479. package/src/utils/sec.ts +37 -25
  480. package/src/utils/shortcut-labels.ts +6 -30
  481. package/src/plugins/seed-notice.ts +0 -20
@@ -0,0 +1,285 @@
1
+ import { useCallback, useEffect, useRef, useState } from "react";
2
+ import { Box, ScrollBox, Text, TextAttributes, type ScrollBoxRenderable } from "../../../../ui";
3
+ import { usePaneFooter } from "../../../../components";
4
+ import { usePaneArrowHold, usePaneHasTabStrip } from "../../../../components/layout/pane/footer/registration";
5
+ import { afterLayout } from "../../../../components/ui/reveal-in-scroll-box";
6
+ import { useShortcut } from "../../../../react/input";
7
+ import { isPlainKey } from "../../../../utils/keyboard";
8
+ import { colors } from "../../../../theme/colors";
9
+ import { resolveHeatCellColors } from "../../../../theme/heat-colors";
10
+ import { formatCorrelation } from "../compute";
11
+ import { displaySymbol, MATRIX_CELL_WIDTH, MIN_MATRIX_CELL_WIDTH, ROW_HEADER_WIDTH } from "./model";
12
+ import { clampMatrixCursor, matrixSelection, moveMatrixCursor, type MatrixCursor } from "./selection";
13
+ import { SymbolLabelCell } from "./symbol-cell";
14
+
15
+ export interface CorrelationMatrixLayout {
16
+ rowHeaderWidth: number;
17
+ cellWidth: number;
18
+ /** The header column and every cell after the one-cell inset. */
19
+ rowWidth: number;
20
+ }
21
+
22
+ /**
23
+ * Column widths of a matrix of these symbols in a pane this wide: cells grow
24
+ * with the pane up to MATRIX_CELL_WIDTH and keep room for the longest label
25
+ * (a map series' SUEZ.TANKER), and past the pane's width the matrix scrolls.
26
+ */
27
+ export function correlationMatrixLayout(symbols: readonly string[], width: number): CorrelationMatrixLayout {
28
+ const labelWidth = Math.max(0, ...symbols.map((symbol) => displaySymbol(symbol).length));
29
+ const rowHeaderWidth = Math.max(ROW_HEADER_WIDTH, Math.min(12, labelWidth + 2));
30
+ const minCellWidth = Math.max(MIN_MATRIX_CELL_WIDTH, labelWidth + 2);
31
+ const cellCount = Math.max(1, symbols.length);
32
+ const availableCellWidth = Math.floor((Math.max(width - rowHeaderWidth - 4, cellCount * minCellWidth)) / cellCount);
33
+ const cellWidth = Math.max(minCellWidth, Math.min(MATRIX_CELL_WIDTH, availableCellWidth));
34
+ // Rows are exactly as wide as the matrix, so the zebra and hover bands stop at the last column.
35
+ return { rowHeaderWidth, cellWidth, rowWidth: 1 + rowHeaderWidth + symbols.length * cellWidth };
36
+ }
37
+
38
+ /** Whether the whole matrix shows at once: every column in `width`, the header and every row in `height`. */
39
+ export function correlationMatrixFits(symbols: readonly string[], width: number, height: number): boolean {
40
+ return symbols.length >= 2
41
+ && correlationMatrixLayout(symbols, width).rowWidth <= width - 1
42
+ && symbols.length + 1 <= height;
43
+ }
44
+
45
+ export interface CorrelationMatrixNavigation {
46
+ cursor: MatrixCursor;
47
+ hoveredSymbol: string | null;
48
+ /** The cursor's pair, or one symbol from its row label; null without symbols. */
49
+ selection: [string, string] | null;
50
+ /** What the grid draws the cursor and hover from, and reports clicks and hovers to. */
51
+ grid: Pick<CorrelationMatrixGridProps, "cursor" | "hoveredSymbol" | "onSelectCell" | "onHoverSymbol" | "onLeaveSymbol">;
52
+ }
53
+
54
+ /**
55
+ * The matrix's cursor, hover and keys, the same in every pane that draws it
56
+ * (CORR, and Correlation in portfolio analytics). The arrows and h, j, k and
57
+ * l move the cell, starting from a hovered label's row when there is one;
58
+ * Enter opens the hovered symbol, else the cell's pair, else the row label's
59
+ * symbol. Under a tab strip the matrix sits one level down, as a chart does:
60
+ * the strip keeps Left, Right, h and l until Down, Enter or a click moves
61
+ * into it, and Esc, or Up from the top row, hands them back. Without a strip
62
+ * the matrix has its keys throughout.
63
+ */
64
+ export function useCorrelationMatrixNavigation({
65
+ symbols,
66
+ focused,
67
+ scope,
68
+ onOpenPair,
69
+ onOpenSymbol,
70
+ }: {
71
+ symbols: readonly string[];
72
+ /** Whether the matrix takes the keys: its pane is focused and nothing else in it holds them. */
73
+ focused: boolean;
74
+ scope: string;
75
+ onOpenPair: (pair: [string, string]) => void;
76
+ onOpenSymbol: (symbol: string) => void;
77
+ }): CorrelationMatrixNavigation {
78
+ const [state, setState] = useState<{ cursor: MatrixCursor; hoveredSymbol: string | null }>({
79
+ cursor: { row: 0, column: 1 },
80
+ hoveredSymbol: null,
81
+ });
82
+ const cursor = clampMatrixCursor(state.cursor, symbols.length);
83
+ const selection = matrixSelection(symbols, cursor);
84
+ const symbolsKey = symbols.join(",");
85
+ // Kept inside a new list; a matrix with nothing in it yet (still loading) keeps the cell it starts on.
86
+ useEffect(() => {
87
+ if (symbols.length) setState((current) => ({ ...current, cursor: clampMatrixCursor(current.cursor, symbols.length) }));
88
+ }, [symbolsKey]);
89
+ const zoned = usePaneHasTabStrip();
90
+ const [entered, setEntered] = useState(false);
91
+ const inside = !zoned || entered;
92
+ usePaneArrowHold(focused && zoned && entered);
93
+ // The next visit to the pane or the view starts at the strip.
94
+ useEffect(() => {
95
+ if (!focused) setEntered(false);
96
+ }, [focused]);
97
+ /** A hovered label stays the keyboard's starting point: Left reaches its row label. */
98
+ const moveCursor = (key: string) => {
99
+ setState((current) => {
100
+ const hoveredRow = current.hoveredSymbol ? symbols.indexOf(current.hoveredSymbol) : -1;
101
+ const start = hoveredRow >= 0 ? { row: hoveredRow, column: -1 } : clampMatrixCursor(current.cursor, symbols.length);
102
+ return { cursor: moveMatrixCursor(start, key, symbols.length), hoveredSymbol: null };
103
+ });
104
+ };
105
+ useShortcut((event) => {
106
+ if (event.defaultPrevented || event.targetEditable || event.ctrl || event.alt || event.meta) return;
107
+ if (!inside) {
108
+ if (!isPlainKey(event, "down", "return", "enter")) return;
109
+ event.preventDefault();
110
+ event.stopPropagation();
111
+ setEntered(true);
112
+ return;
113
+ }
114
+ if (zoned && (isPlainKey(event, "escape") || (cursor.row === 0 && !state.hoveredSymbol && isPlainKey(event, "up", "k")))) {
115
+ event.preventDefault();
116
+ event.stopPropagation();
117
+ setEntered(false);
118
+ return;
119
+ }
120
+ if (isPlainKey(event, "j", "down", "k", "up", "h", "left", "l", "right")) {
121
+ event.preventDefault();
122
+ event.stopPropagation();
123
+ moveCursor(event.name ?? event.key ?? "");
124
+ } else if (isPlainKey(event, "return", "enter") && selection) {
125
+ event.preventDefault();
126
+ event.stopPropagation();
127
+ if (state.hoveredSymbol && symbols.includes(state.hoveredSymbol)) onOpenSymbol(state.hoveredSymbol);
128
+ else if (selection[0] !== selection[1]) onOpenPair(selection);
129
+ else onOpenSymbol(selection[0]);
130
+ }
131
+ }, { enabled: focused && symbols.length > 0, phase: "before", scope });
132
+ // Inside, the footer names the way back first, as a chart under a strip does.
133
+ const leaveHint = focused && zoned && entered;
134
+ usePaneFooter(`${scope}:leave`, () => leaveHint
135
+ ? { order: -2, hints: [{ id: "matrix-leave", key: "Esc", label: "tabs", title: "Back to Tabs", onPress: () => setEntered(false) }] }
136
+ : null, [leaveHint]);
137
+ const onHoverSymbol = useCallback((symbol: string) => {
138
+ setState((current) => ({ ...current, hoveredSymbol: symbol }));
139
+ }, []);
140
+ const onLeaveSymbol = useCallback((symbol: string) => {
141
+ setState((current) => (current.hoveredSymbol === symbol ? { ...current, hoveredSymbol: null } : current));
142
+ }, []);
143
+ const onSelectCell = useCallback((next: MatrixCursor) => {
144
+ setState({ cursor: next, hoveredSymbol: null });
145
+ setEntered(true);
146
+ }, []);
147
+ return {
148
+ cursor,
149
+ hoveredSymbol: state.hoveredSymbol,
150
+ selection,
151
+ grid: { cursor, hoveredSymbol: state.hoveredSymbol, onSelectCell, onHoverSymbol, onLeaveSymbol },
152
+ };
153
+ }
154
+
155
+ export interface CorrelationMatrixGridProps {
156
+ symbols: readonly string[];
157
+ width: number;
158
+ height: number;
159
+ /** The correlation of a row's symbol with a column's, null where there is none. */
160
+ correlation: (row: string, column: string) => number | null;
161
+ cursor: MatrixCursor;
162
+ hoveredSymbol: string | null;
163
+ /** A row label's colour: how far its series loaded. Bright when left out. */
164
+ rowColor?: (symbol: string) => string;
165
+ onSelectCell: (cursor: MatrixCursor) => void;
166
+ onHoverSymbol: (symbol: string) => void;
167
+ onLeaveSymbol: (symbol: string) => void;
168
+ onOpenSymbol: (symbol: string) => void;
169
+ }
170
+
171
+ /**
172
+ * The heat-coloured correlation matrix: symbols down the side and across the
173
+ * top, each cell a pair's correlation on the heat scale, the diagonal quiet.
174
+ * A click picks a cell and a label opens its symbol; the owner moves the
175
+ * cursor from the keyboard. It scrolls both ways once the symbols outgrow the
176
+ * pane and keeps the cursor in view.
177
+ */
178
+ export function CorrelationMatrixGrid({
179
+ symbols,
180
+ width,
181
+ height,
182
+ correlation,
183
+ cursor,
184
+ hoveredSymbol,
185
+ rowColor = () => colors.textBright,
186
+ onSelectCell,
187
+ onHoverSymbol,
188
+ onLeaveSymbol,
189
+ onOpenSymbol,
190
+ }: CorrelationMatrixGridProps) {
191
+ const matrixScrollRef = useRef<ScrollBoxRenderable | null>(null);
192
+ const horizontalScrollRef = useRef<ScrollBoxRenderable | null>(null);
193
+ const { rowHeaderWidth, cellWidth, rowWidth } = correlationMatrixLayout(symbols, width);
194
+ const horizontalBarRows = rowWidth > width - 1 ? 1 : 0;
195
+ const selection = matrixSelection(symbols, cursor);
196
+
197
+ // Scroll after React commits a movement, including several keys in one input batch.
198
+ useEffect(() => afterLayout(() => {
199
+ const scroll = matrixScrollRef.current;
200
+ if (scroll) {
201
+ const viewportHeight = Math.max(1, scroll.viewport?.height ?? 1);
202
+ if (cursor.row < scroll.scrollTop) scroll.scrollTo(cursor.row);
203
+ else if (cursor.row + 1 > scroll.scrollTop + viewportHeight) scroll.scrollTo(cursor.row + 1 - viewportHeight);
204
+ }
205
+ const horizontal = horizontalScrollRef.current;
206
+ if (!horizontal) return;
207
+ const left = cursor.column < 0 ? 0 : 1 + rowHeaderWidth + cursor.column * cellWidth;
208
+ const right = left + (cursor.column < 0 ? rowHeaderWidth : cellWidth);
209
+ const scrollLeft = horizontal.scrollLeft ?? 0;
210
+ const viewportWidth = horizontal.viewport?.width || width;
211
+ if (left < scrollLeft) horizontal.scrollTo({ x: left, y: 0 });
212
+ else if (right > scrollLeft + viewportWidth) horizontal.scrollTo({ x: right - viewportWidth, y: 0 });
213
+ }), [cursor.row, cursor.column, height, rowHeaderWidth, cellWidth, width]);
214
+
215
+ return (
216
+ <ScrollBox ref={horizontalScrollRef} height={height} flexShrink={1} minHeight={Math.min(height, symbols.length + 1, 5)} scrollX scrollY={false} focusable={false}>
217
+ <Box flexDirection="column" width={Math.max(width - 1, rowWidth)} height={height - horizontalBarRows}>
218
+ {/* Column header row */}
219
+ <Box flexDirection="row" paddingLeft={1} height={1} flexShrink={0} width={rowWidth} backgroundColor={colors.panel}>
220
+ <Box width={rowHeaderWidth} flexShrink={0} />
221
+ {symbols.map((symbol) => (
222
+ <SymbolLabelCell
223
+ key={symbol}
224
+ symbol={symbol}
225
+ width={cellWidth}
226
+ align="flex-end"
227
+ color={colors.textDim}
228
+ hovered={hoveredSymbol === symbol || selection?.[1] === symbol}
229
+ onHover={onHoverSymbol}
230
+ onLeave={onLeaveSymbol}
231
+ onOpen={onOpenSymbol}
232
+ />
233
+ ))}
234
+ </Box>
235
+
236
+ {/* Matrix rows */}
237
+ <ScrollBox ref={matrixScrollRef} flexGrow={1} flexBasis={0} minHeight={0} scrollY scrollX={false} focusable={false}>
238
+ <Box flexDirection="column">
239
+ {symbols.map((rowSymbol, rowIndex) => (
240
+ <Box key={rowSymbol} flexDirection="row" paddingLeft={1} width={rowWidth} backgroundColor={rowIndex % 2 === 0 ? colors.bg : undefined}>
241
+ {/* Row header */}
242
+ <Box width={rowHeaderWidth} flexShrink={0} overflow="hidden">
243
+ <SymbolLabelCell
244
+ symbol={rowSymbol}
245
+ width={rowHeaderWidth}
246
+ color={rowColor(rowSymbol)}
247
+ hovered={hoveredSymbol === rowSymbol || selection?.[0] === rowSymbol}
248
+ onHover={onHoverSymbol}
249
+ onLeave={onLeaveSymbol}
250
+ onOpen={onOpenSymbol}
251
+ />
252
+ </Box>
253
+ {/* Cells */}
254
+ {symbols.map((columnSymbol, columnIndex) => {
255
+ const value = correlation(rowSymbol, columnSymbol);
256
+ const cellColors = resolveHeatCellColors(value, { quiet: rowSymbol === columnSymbol });
257
+ const selected = cursor.row === rowIndex && cursor.column === columnIndex;
258
+ return (
259
+ <Box
260
+ key={columnSymbol}
261
+ width={cellWidth}
262
+ flexShrink={0}
263
+ flexDirection="row"
264
+ justifyContent="flex-end"
265
+ paddingRight={1}
266
+ backgroundColor={cellColors.background}
267
+ style={{ cursor: "pointer" }}
268
+ onMouseDown={(event: any) => {
269
+ event.preventDefault?.();
270
+ event.stopPropagation?.();
271
+ onSelectCell({ row: rowIndex, column: columnIndex });
272
+ }}
273
+ >
274
+ <Text fg={cellColors.foreground} attributes={selected ? TextAttributes.BOLD | TextAttributes.UNDERLINE : TextAttributes.NONE}>{formatCorrelation(value)}</Text>
275
+ </Box>
276
+ );
277
+ })}
278
+ </Box>
279
+ ))}
280
+ </Box>
281
+ </ScrollBox>
282
+ </Box>
283
+ </ScrollBox>
284
+ );
285
+ }
@@ -13,7 +13,7 @@ export const MATRIX_CELL_WIDTH = 15;
13
13
  export const MIN_MATRIX_CELL_WIDTH = 7;
14
14
  const MIN_CORRELATION_OBSERVATIONS = 5;
15
15
 
16
- export type SeriesStatus = "loading" | "ready" | "insufficient" | "empty" | "error" | "invalid";
16
+ export type SeriesStatus = "loading" | "ready" | "insufficient" | "empty" | "error";
17
17
 
18
18
  export interface CorrelationSeries {
19
19
  symbol: string;
@@ -22,6 +22,7 @@ export interface CorrelationSeries {
22
22
  basis?: ChangeBasis;
23
23
  status: SeriesStatus;
24
24
  observationCount: number;
25
+ /** Bars left out because their prices contradict each other, kept as the source reported them. */
25
26
  integrity?: PriceHistoryIntegrity[];
26
27
  loading?: boolean;
27
28
  refreshError?: string;
@@ -82,14 +83,19 @@ export function getSeriesForEntry(
82
83
  };
83
84
  }
84
85
 
86
+ /**
87
+ * A ticker's daily closes as `history` reads them: a bar whose prices
88
+ * contradict each other is a gap (dailyCloses), not a reason to drop the
89
+ * whole series, and is kept in `integrity` as the source reported it.
90
+ */
85
91
  export function buildCorrelationSeries(symbol: string, history: readonly PricePoint[]): CorrelationSeries {
86
92
  const integrity = history.flatMap((point) => { const issue = pricePointIntegrity(point); return issue ? [issue] : []; });
87
- if (integrity.length) return { symbol, prices: [], observationCount: 0, status: "invalid", integrity };
88
93
  const prices = dailyCloses(history);
89
94
  const observationCount = Math.max(0, prices.length - 1);
90
95
  return {
91
96
  symbol, prices, observationCount,
92
97
  status: observationCount < MIN_CORRELATION_OBSERVATIONS ? "insufficient" : "ready",
98
+ ...(integrity.length ? { integrity } : {}),
93
99
  };
94
100
  }
95
101
 
@@ -106,7 +112,6 @@ export function rowHeaderColor(status: SeriesStatus): string {
106
112
  switch (status) {
107
113
  case "loading":
108
114
  return colors.textDim;
109
- case "invalid":
110
115
  case "error":
111
116
  case "empty":
112
117
  return colors.negative;
@@ -142,10 +147,7 @@ export function buildCorrelationMatrix(
142
147
  results.set(pairKey(rowSym, colSym), result);
143
148
  if (rowIndex < colIndex) {
144
149
  if (result.sampleSize > 0) sampleSizes.push(result.sampleSize);
145
- if (rowSeries?.status !== "invalid" && colSeries?.status !== "invalid"
146
- && result.correlation == null && result.sampleSize < MIN_CORRELATION_OBSERVATIONS) {
147
- hasThinPair = true;
148
- }
150
+ if (result.correlation == null && result.sampleSize < MIN_CORRELATION_OBSERVATIONS) hasThinPair = true;
149
151
  }
150
152
  }
151
153
  }
@@ -171,16 +173,14 @@ export function buildStatusSummary(
171
173
  const loading = symbols.filter((symbol) => seriesBySymbol.get(symbol)?.status === "loading" || seriesBySymbol.get(symbol)?.loading);
172
174
  const errors = [...byStatus("error"), ...byStatus("empty")];
173
175
  const insufficient = byStatus("insufficient");
174
- const invalid = byStatus("invalid");
175
176
 
176
- if (invalid.length > 0) parts.push(`Inconsistent OHLC: ${formatSeriesSymbolList(invalid, seriesBySymbol)}`);
177
177
  if (loading.length > 0) parts.push(`Loading: ${formatSeriesSymbolList(loading, seriesBySymbol)}`);
178
178
  if (errors.length > 0) parts.push(`No data: ${formatSeriesSymbolList(errors, seriesBySymbol)}`);
179
179
  if (insufficient.length > 0) parts.push(`Need history: ${formatSeriesSymbolList(insufficient, seriesBySymbol, true)}`);
180
180
 
181
181
  if (sampleMin != null && sampleMax != null) {
182
182
  parts.push(sampleMin === sampleMax ? `obs ${sampleMin}` : `obs ${sampleMin}-${sampleMax}`);
183
- } else if (symbols.length >= 2 && invalid.length === 0) {
183
+ } else if (symbols.length >= 2) {
184
184
  parts.push("No paired dates yet");
185
185
  }
186
186
 
@@ -40,8 +40,8 @@ export interface RelationshipRegressionStats {
40
40
  }
41
41
 
42
42
  export interface RelationshipAnalysis {
43
- unavailableReason?: string;
44
43
  correlationUnavailableReason?: string;
44
+ /** Bars left out of the window because their prices contradict each other, as the source reported them. */
45
45
  integrity?: { left: PriceHistoryIntegrity[]; right: PriceHistoryIntegrity[] };
46
46
  aligned: RelationshipAlignedPoint[];
47
47
  returns: RelationshipReturnPoint[];
@@ -156,12 +156,8 @@ export function buildRelationshipAnalysis(
156
156
  const issues = (points: PricePoint[]) => points.flatMap((point) => {
157
157
  const issue = pricePointIntegrity(point); return issue ? [issue] : [];
158
158
  });
159
+ // Bars whose prices contradict each other are gaps, as history leaves them blank (dailyCloses); kept for the export.
159
160
  const integrity = { left: issues(leftPoints), right: issues(rightPoints) };
160
- if (integrity.left.length || integrity.right.length) return {
161
- aligned: [], returns: [], ratioPoints: [], correlationPoints: [], scatterPoints: [],
162
- stats: null, latestRatio: null, latestCorrelation: null, integrity,
163
- unavailableReason: "Inconsistent OHLC history; relationship calculations are unavailable for this window.",
164
- };
165
161
  const aligned = alignRelationshipPrices(leftPoints, rightPoints);
166
162
  const returns = buildRelationshipReturns(aligned);
167
163
  const correlationPoints = buildRollingCorrelationPoints(returns, correlationWindow);
@@ -186,6 +182,7 @@ export function buildRelationshipAnalysis(
186
182
  latestRatio: aligned.at(-1)?.ratio ?? null,
187
183
  latestCorrelation,
188
184
  ...(correlationUnavailableReason ? { correlationUnavailableReason } : {}),
185
+ ...(integrity.left.length || integrity.right.length ? { integrity } : {}),
189
186
  };
190
187
  }
191
188
 
@@ -15,11 +15,10 @@ import { scalarPoint, staticSeries } from "../../../../components/chart/static/s
15
15
  import { usePaneRefreshKey } from "../../../../components/data-table/table-pane";
16
16
  import { useShortcut, type KeyEventLike } from "../../../../react/input";
17
17
  import { usePaneInstance } from "../../../../state/app/context";
18
- import { colors } from "../../../../theme/colors";
19
18
  import { formatTickerListInput } from "../../../../tickers/list";
20
19
  import type { ResolvedSeries } from "../../../../time-series/types";
21
20
  import type { PaneProps, PaneTemplateDef } from "../../../../types/plugin";
22
- import { Box, Text, useUiCapabilities } from "../../../../ui";
21
+ import { Box, useUiCapabilities } from "../../../../ui";
23
22
  import { formatNumber } from "../../../../utils/format";
24
23
  import { isPlainKey } from "../../../../utils/keyboard";
25
24
  import { usePluginPaneState } from "../../../runtime";
@@ -76,7 +75,7 @@ const REGRESSION_COLOR = "#ffd43b";
76
75
  const RATIO_COLOR = "#e599f7";
77
76
  /** Legend and time axis around the stacked panels. */
78
77
  const CHART_CHROME_ROWS = 2;
79
- /** The scatter's two label rows around a readable plot. */
78
+ /** The scatter's y-axis title row and x-axis row around a readable plot. */
80
79
  const MIN_SCATTER_ROWS = 8;
81
80
  const MIN_PANEL_ROWS = 3;
82
81
 
@@ -238,7 +237,6 @@ export function RelationshipGraphPane({ focused, width, height }: PaneProps) {
238
237
  registrationId: "relationship-warnings", focused,
239
238
  notices: [
240
239
  ...(error ? [`${error}${data && updatedAt ? ` Retained history retrieved ${new Date(updatedAt).toISOString()}.` : ""}`] : []),
241
- ...(analysis?.unavailableReason ? [analysis.unavailableReason] : []),
242
240
  ...(analysis?.correlationUnavailableReason ? [analysis.correlationUnavailableReason] : []),
243
241
  ],
244
242
  });
@@ -275,7 +273,7 @@ export function RelationshipGraphPane({ focused, width, height }: PaneProps) {
275
273
  return (
276
274
  <Box flexDirection="column" width={width} height={height}>
277
275
  {queryBar}
278
- <PaneStatusBody loading={loading} error={loading ? null : analysis?.unavailableReason ?? error} subject="relationship history" empty emptyTitle="No overlapping price history." />
276
+ <PaneStatusBody loading={loading} error={loading ? null : error} subject="relationship history" empty emptyTitle="No overlapping price history." />
279
277
  </Box>
280
278
  );
281
279
  }
@@ -303,15 +301,15 @@ export function RelationshipGraphPane({ focused, width, height }: PaneProps) {
303
301
  />
304
302
  </Box>
305
303
  {layout.scatterRows > 0 ? (
306
- <Box flexDirection="column" height={layout.scatterRows} flexShrink={0}>
307
- <Box paddingX={1} height={1}><Text fg={colors.textDim}>{`${leftSymbol} returns (%)`}</Text></Box>
304
+ <Box height={layout.scatterRows} flexShrink={0}>
308
305
  <StaticScatterChartSurface
309
306
  points={scatterPoints}
310
307
  width={width}
311
- height={layout.scatterRows - 2}
308
+ height={layout.scatterRows}
312
309
  regression={stats ? { slope: stats.beta, intercept: stats.alpha, color: REGRESSION_COLOR } : null}
310
+ xLabel={`${rightSymbol} returns (%)`}
311
+ yLabel={`${leftSymbol} returns (%)`}
313
312
  />
314
- <Box paddingX={1} height={1}><Text fg={colors.textDim}>{`${rightSymbol} returns (%)`}</Text></Box>
315
313
  </Box>
316
314
  ) : null}
317
315
  </Box>
@@ -21,18 +21,27 @@ function formatNullableNumber(value: number | null | undefined, decimals: number
21
21
  return typeof value === "number" && Number.isFinite(value) ? formatNumber(value, decimals) : "-";
22
22
  }
23
23
 
24
+ /** A figure in percentage points of daily return, as alpha reads: `1.997%`, or a bare dash when there is none. */
25
+ function formatNullablePercent(value: number | null | undefined, decimals: number): string {
26
+ const text = formatNullableNumber(value, decimals);
27
+ return text === "-" ? text : `${text}%`;
28
+ }
29
+
24
30
  /**
25
31
  * A ratio's legend value at four significant digits, so a ratio of 0.000566
26
32
  * does not read 0.001. Whole index points and correlations keep their own fixed decimals.
27
33
  */
28
- export const formatRatioValue = (value: number) => formatSignificant(value);
34
+ export const formatRatioValue = (value: number) => `${formatSignificant(value)}x`;
29
35
 
30
- /** Ratio axis ticks need decimals that tell neighbours apart: 0.00040, 0.00045, 0.00050 where 0.001 would repeat. */
36
+ /**
37
+ * Ratio axis ticks need decimals that tell neighbours apart: 0.00040, 0.00045, 0.00050 where 0.001 would repeat.
38
+ * They end in `x` as a ratio does everywhere else in the app, which also tells the panel from the prices over it.
39
+ */
31
40
  export function formatRatioAxisValue(value: number, domain: Pick<CompositeAxisDomain, "min" | "max">): string {
32
- if (Math.abs(value) >= 10) return formatNumber(value, 1);
41
+ if (Math.abs(value) >= 10) return `${formatNumber(value, 1)}x`;
33
42
  const span = Math.abs(domain.max - domain.min);
34
43
  const decimals = Number.isFinite(span) && span > 0 ? Math.min(10, Math.max(3, 1 - Math.floor(Math.log10(span)))) : 3;
35
- return formatNumber(value, decimals);
44
+ return `${formatNumber(value, decimals)}x`;
36
45
  }
37
46
 
38
47
  export function buildIndexedPriceSeries(
@@ -118,6 +127,6 @@ export function buildRelationshipStatItems(stats: RelationshipRegressionStats |
118
127
  { id: "beta", label: "Beta", value: formatNullableNumber(stats.beta, 3) },
119
128
  { id: "alpha", label: "Alpha", value: `${formatNullableNumber(stats.alpha, 3)}%`, detail: "daily" },
120
129
  { id: "r", label: "R", value: formatNullableNumber(stats.r, 3), detail: `R² ${formatNullableNumber(stats.rSquared, 3)}` },
121
- { id: "stdErr", label: "Std err", value: formatNullableNumber(stats.stdError, 3) },
130
+ { id: "stdErr", label: "Std err", value: formatNullablePercent(stats.stdError, 3), detail: "daily" },
122
131
  ];
123
132
  }
@@ -20,6 +20,7 @@ function base(data: CotPayloadBase, family: CotFamily, positions: CotPositions)
20
20
  || !Array.isArray(data.gaps) || !data.gaps.every((gap) => typeof gap === "string")
21
21
  || !Array.isArray(data.classes) || data.classes.some((row) => !COT_CLASSES[family].some((option) => option.value === row.id))
22
22
  || data.asOf !== null && !date(data.asOf) || !Number.isFinite(Date.parse(data.generatedAt))
23
+ || data.publishedAt != null && !Number.isFinite(Date.parse(data.publishedAt))
23
24
  || !["available", "partial", "unavailable"].includes(data.status)) throw new Error("The server returned an invalid COT report");
24
25
  }
25
26
  function summary(row: CotClassSummary, family: CotFamily) {
@@ -27,7 +28,7 @@ function summary(row: CotClassSummary, family: CotFamily) {
27
28
  || ![row.long, row.short, row.spreading].every(count) || ![row.net, row.weeklyChange, row.netPercentOfOpenInterest].every(number)
28
29
  || row.net !== (row.long == null || row.short == null ? null : row.long - row.short)
29
30
  || row.previousReportDate !== null && !date(row.previousReportDate)) throw new Error("The server returned invalid COT positions");
30
- for (const rank of [row.percentile1Y, row.percentile3Y]) {
31
+ for (const rank of [row.percentile1Y, row.percentile3Y, ...(row.percentileAll === undefined ? [] : [row.percentileAll])]) {
31
32
  if (!rank || !Number.isSafeInteger(rank.sampleCount) || rank.sampleCount < 0 || typeof rank.completeWindow !== "boolean"
32
33
  || ![rank.min, rank.max, rank.mean, rank.rank].every(number) || !date(rank.windowStart) || !date(rank.windowEnd)
33
34
  || rank.value !== null && (!number(rank.value) || rank.value < 0 || rank.value > 100)
@@ -86,8 +87,12 @@ export async function loadCotBoard(family: CotFamily, traderClass: CotClass, for
86
87
  () => fetchCotBoard(family, traderClass, apiClient, positions), { force });
87
88
  return presentCotBoard(payload, stale, refreshError);
88
89
  }
89
- export async function fetchCotContract(contractCode: string, family: CotFamily, client: Pick<typeof apiClient, "getCloudCotContract"> = apiClient, positions: CotPositions = "futures-only") {
90
- try { return validateCotContract(await client.getCloudCotContract(contractCode, family, positions), family, contractCode, positions); }
90
+ export async function fetchCotContract(contractCode: string, family: CotFamily, client: Pick<typeof apiClient, "getCloudCotContract"> = apiClient,
91
+ positions: CotPositions = "futures-only", since?: string) {
92
+ try {
93
+ const payload = await client.getCloudCotContract(contractCode, family, positions, since);
94
+ return validateCotContract(payload, family, contractCode, positions);
95
+ }
91
96
  catch (error) { throw unavailable(error); }
92
97
  }
93
98
  export interface CotDetailData { payload: CotContractPayload; price: PricePoint[]; priceSymbol: string | null; priceAsOf: string | null; priceWarning: string | null }