gloomberb 0.20.1 → 0.20.2

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (422) hide show
  1. package/README.md +16 -26
  2. package/README.zh-CN.md +21 -65
  3. package/package.json +1 -1
  4. package/src/account/auth-model.ts +20 -1
  5. package/src/account/upgrade-dialog.tsx +8 -4
  6. package/src/api-client/askg.ts +7 -1
  7. package/src/api-client/auth.ts +27 -0
  8. package/src/api-client/catalysts.ts +2 -0
  9. package/src/api-client/company-kpis.ts +2 -1
  10. package/src/api-client/cot.ts +14 -2
  11. package/src/api-client/data.ts +3 -2
  12. package/src/api-client/earnings.ts +46 -3
  13. package/src/api-client/futures-curve.ts +17 -0
  14. package/src/api-client/index.ts +4 -1
  15. package/src/api-client/one-tap-reasons.ts +42 -0
  16. package/src/api-client/perps.ts +2 -1
  17. package/src/api-client/request.ts +3 -1
  18. package/src/api-client/research-activity.ts +16 -3
  19. package/src/api-client/types/filings-and-calls.ts +3 -0
  20. package/src/api-client/types/search.ts +3 -0
  21. package/src/app/keybindings/chord.ts +153 -9
  22. package/src/app/keybindings/index.ts +1 -1
  23. package/src/app/keybindings/labels.ts +49 -6
  24. package/src/app/runtime/desktop-deeplink.ts +73 -8
  25. package/src/app.tsx +7 -1
  26. package/src/architecture/core-builtin-allowlist.json +1 -2
  27. package/src/architecture/pane-tabs-allowlist.json +2 -1
  28. package/src/architecture/shortcut-labels-allowlist.json +11 -0
  29. package/src/architecture/ui-literals-allowlist.json +8 -8
  30. package/src/brokers/broker-portfolio-sync.ts +1 -1
  31. package/src/cli/bank-section.ts +26 -12
  32. package/src/cli/commands/market.ts +266 -75
  33. package/src/cli/commands/ticker.ts +12 -7
  34. package/src/cli/desktop-pane-shot-browser.ts +47 -31
  35. package/src/cli/desktop-pane-shot.ts +15 -0
  36. package/src/cli/entry.ts +5 -0
  37. package/src/cli/export-source.ts +7 -1
  38. package/src/cli/freshness.ts +0 -16
  39. package/src/cli/fx-pair.ts +64 -12
  40. package/src/cli/fx-quote-rate.ts +144 -0
  41. package/src/cli/glossary.ts +5 -0
  42. package/src/cli/history-back-adjust.ts +122 -0
  43. package/src/cli/history-rows.ts +114 -10
  44. package/src/cli/index.ts +4 -1
  45. package/src/cli/known-gaps.ts +45 -3
  46. package/src/cli/listing-arg.ts +48 -4
  47. package/src/cli/name-entries.ts +25 -5
  48. package/src/cli/pane-functions/catalog.ts +12 -2
  49. package/src/cli/pane-functions/dom.ts +4 -2
  50. package/src/cli/pane-functions/headless.ts +8 -5
  51. package/src/cli/pane-functions/index.ts +3 -0
  52. package/src/cli/pane-functions/resolver.ts +4 -1
  53. package/src/cli/pane-functions/screenshot-assessment.ts +15 -3
  54. package/src/cli/pane-functions/screenshot-payload.ts +130 -66
  55. package/src/cli/pane-functions/screenshot-render.ts +14 -2
  56. package/src/cli/pane-functions/screenshot-types.ts +4 -0
  57. package/src/cli/symbol-rows.ts +22 -2
  58. package/src/cli/ticker-resolution.ts +74 -17
  59. package/src/components/chart/composite/axis-overlays.tsx +13 -3
  60. package/src/components/chart/composite/composite-chart.tsx +8 -1
  61. package/src/components/chart/composite/format.ts +16 -1
  62. package/src/components/chart/composite/legend.tsx +4 -3
  63. package/src/components/chart/composite/panel-labels.ts +2 -1
  64. package/src/components/chart/composite/panel-surface.tsx +33 -4
  65. package/src/components/chart/composite/time-scale.ts +1 -1
  66. package/src/components/chart/composite/toolbar.tsx +8 -4
  67. package/src/components/chart/composite/types.ts +17 -1
  68. package/src/components/chart/composite/use-composite-chart-keyboard.ts +15 -5
  69. package/src/components/chart/composite/use-composite-viewport.ts +31 -8
  70. package/src/components/chart/static/scatter-chart-surface.tsx +25 -9
  71. package/src/components/chart-table/axis.ts +11 -0
  72. package/src/components/command-bar/assist/inventory.ts +3 -2
  73. package/src/components/command-bar/commands/collection-list.ts +3 -2
  74. package/src/components/command-bar/panel/layout.ts +8 -1
  75. package/src/components/command-bar/panel/prompt-width.ts +34 -0
  76. package/src/components/command-bar/panel/state.ts +4 -0
  77. package/src/components/command-bar/routes/root/search-providers.ts +3 -2
  78. package/src/components/command-bar/routes/root/search-report.ts +2 -2
  79. package/src/components/command-bar/workflow/ticker-listing-picker.ts +1 -0
  80. package/src/components/company-logo.tsx +2 -2
  81. package/src/components/data-table/view.tsx +11 -2
  82. package/src/components/feed-data-table/stack-view.tsx +20 -6
  83. package/src/components/feedback-dialog.tsx +3 -1
  84. package/src/components/form-modal/field-row.tsx +1 -1
  85. package/src/components/form-modal/routes.ts +1 -0
  86. package/src/components/index.ts +1 -1
  87. package/src/components/layout/header.tsx +12 -3
  88. package/src/components/layout/market-summary.ts +2 -1
  89. package/src/components/layout/pane/footer/index.tsx +9 -5
  90. package/src/components/layout/pane/footer/model.ts +26 -10
  91. package/src/components/layout/pane/footer/registration.tsx +60 -1
  92. package/src/components/layout/pane/header-tabs.tsx +17 -3
  93. package/src/components/layout/pane/header.tsx +5 -2
  94. package/src/components/layout/pane/pane-tabs.tsx +57 -3
  95. package/src/components/layout/shell/active-drag.ts +38 -30
  96. package/src/components/layout/shell/drag/index.ts +51 -21
  97. package/src/components/layout/shell/menu.ts +3 -5
  98. package/src/components/layout/shell/pane/actions.ts +4 -1
  99. package/src/components/layout/shell/pane/ask.ts +5 -2
  100. package/src/components/layout/status-bar.tsx +59 -54
  101. package/src/components/markdown-text.tsx +35 -10
  102. package/src/components/onboarding/first-run-workspace.ts +25 -23
  103. package/src/components/onboarding/onboarding-keyboard.ts +6 -1
  104. package/src/components/onboarding/onboarding-wizard.tsx +12 -2
  105. package/src/components/onboarding/portfolio-step/positions-panel.tsx +3 -3
  106. package/src/components/onboarding/use-onboarding-broker-form.ts +2 -1
  107. package/src/components/onboarding/use-onboarding-progress.ts +11 -4
  108. package/src/components/onboarding/use-onboarding-upgrade.ts +3 -2
  109. package/src/components/onboarding/wizard-positions.ts +8 -1
  110. package/src/components/pane-notice-seen.ts +125 -0
  111. package/src/components/pane-settings-dialog/field-dialogs.tsx +2 -1
  112. package/src/components/pane-settings-dialog.tsx +7 -6
  113. package/src/components/sign-in-code-panel.tsx +3 -2
  114. package/src/components/speedometer-gauge/terminal.tsx +30 -9
  115. package/src/components/ticker/list-table-view.tsx +39 -3
  116. package/src/components/ui/confirm-dialog.tsx +2 -1
  117. package/src/components/ui/data-table/index.tsx +4 -2
  118. package/src/components/ui/data-table/opentui/index.tsx +15 -5
  119. package/src/components/ui/data-table/types.ts +8 -0
  120. package/src/components/ui/external-link.tsx +4 -1
  121. package/src/components/ui/field-grid.tsx +1 -1
  122. package/src/components/ui/index.ts +2 -0
  123. package/src/components/ui/inline-quick-add.tsx +5 -0
  124. package/src/components/ui/multi-select/dialog.tsx +10 -9
  125. package/src/components/ui/pane-link-chip.tsx +354 -0
  126. package/src/components/ui/query-bar.tsx +22 -13
  127. package/src/components/ui/ratio-bar.tsx +24 -1
  128. package/src/components/ui/select-button.tsx +2 -1
  129. package/src/components/ui/shortcut-hint.tsx +6 -3
  130. package/src/components/ui/table-layout.ts +81 -0
  131. package/src/components/ui/tabs.tsx +45 -6
  132. package/src/components/use-pane-notice-footer.tsx +12 -4
  133. package/src/core/app-service-ports.ts +1 -1
  134. package/src/data/plugin-state-store.ts +44 -8
  135. package/src/docs/snapshot.json +53 -32
  136. package/src/i18n/es.ts +25 -6
  137. package/src/i18n/ja.ts +25 -5
  138. package/src/i18n/ko.ts +25 -5
  139. package/src/i18n/zh-cn.ts +25 -5
  140. package/src/i18n/zh-tw.ts +25 -5
  141. package/src/layout/pane-manager/gridlock-inference.ts +2 -1
  142. package/src/layout/pane-manager/gridlock.ts +47 -2
  143. package/src/layout-marketplace/api.ts +1 -0
  144. package/src/layout-marketplace/gallery.tsx +4 -3
  145. package/src/layout-marketplace/linked.ts +6 -4
  146. package/src/layout-marketplace/model.ts +3 -2
  147. package/src/market-data/futures-contract.ts +77 -31
  148. package/src/market-data/fx-closes.ts +5 -2
  149. package/src/market-data/hooks.tsx +23 -0
  150. package/src/market-data/market/change-basis.ts +72 -14
  151. package/src/market-data/market/format.ts +19 -11
  152. package/src/market-data/market/globex-day.ts +73 -0
  153. package/src/market-data/market/index-level.ts +10 -1
  154. package/src/market-data/quotes/intraday-bar.ts +1 -1
  155. package/src/market-data/quotes/session-split.ts +28 -0
  156. package/src/plugins/builtin/account-management/pane.tsx +1 -1
  157. package/src/plugins/builtin/analytics/account-returns.ts +1 -1
  158. package/src/plugins/builtin/analytics/index.tsx +10 -3
  159. package/src/plugins/builtin/analytics/pane-model.ts +1 -1
  160. package/src/plugins/builtin/analytics/risk-client.ts +4 -1
  161. package/src/plugins/builtin/analytics/risk-episodes.ts +422 -0
  162. package/src/plugins/builtin/analytics/risk-fx.ts +1 -1
  163. package/src/plugins/builtin/analytics/risk-headless.ts +28 -10
  164. package/src/plugins/builtin/analytics/risk-math.ts +1 -1
  165. package/src/plugins/builtin/analytics/risk-model.ts +115 -26
  166. package/src/plugins/builtin/analytics/risk-pane.tsx +201 -23
  167. package/src/plugins/builtin/analytics/sharpe-cadence.ts +1 -1
  168. package/src/plugins/builtin/backtest/format.ts +14 -0
  169. package/src/plugins/builtin/backtest/pane.tsx +3 -3
  170. package/src/plugins/builtin/backtest/report.ts +5 -3
  171. package/src/plugins/builtin/broker-manager/add-request.ts +10 -1
  172. package/src/plugins/builtin/broker-trading/pane.tsx +20 -2
  173. package/src/plugins/builtin/buildout/company/flow.tsx +5 -5
  174. package/src/plugins/builtin/buildout/company/model.ts +14 -2
  175. package/src/plugins/builtin/catalysts/detail.tsx +2 -2
  176. package/src/plugins/builtin/catalysts/model.ts +7 -2
  177. package/src/plugins/builtin/catalysts/pane.tsx +2 -2
  178. package/src/plugins/builtin/chat/message/pane-chip.tsx +36 -208
  179. package/src/plugins/builtin/cloud/askg/answer-follow-ups.tsx +61 -0
  180. package/src/plugins/builtin/cloud/askg/answer-sources.tsx +102 -0
  181. package/src/plugins/builtin/cloud/askg/controller.ts +7 -1
  182. package/src/plugins/builtin/cloud/askg/host.ts +57 -0
  183. package/src/plugins/builtin/cloud/askg/model.ts +45 -5
  184. package/src/plugins/builtin/cloud/askg/pane.tsx +304 -25
  185. package/src/plugins/builtin/cloud/askg/protocol.ts +26 -1
  186. package/src/plugins/builtin/cloud/askg/sources.ts +466 -0
  187. package/src/plugins/builtin/cloud/one-tap/controller.ts +309 -0
  188. package/src/plugins/builtin/cloud/one-tap/google-identity.ts +142 -0
  189. package/src/plugins/builtin/cloud/one-tap/one-tap-prompt.tsx +101 -0
  190. package/src/plugins/builtin/cloud/plugin.tsx +7 -1
  191. package/src/plugins/builtin/company-kpis/client.ts +4 -3
  192. package/src/plugins/builtin/company-kpis/model.ts +34 -3
  193. package/src/plugins/builtin/correlation/index.tsx +39 -167
  194. package/src/plugins/builtin/correlation/matrix/grid.tsx +285 -0
  195. package/src/plugins/builtin/correlation/relationship/pane.tsx +6 -7
  196. package/src/plugins/builtin/correlation/relationship/view-model.ts +14 -5
  197. package/src/plugins/builtin/cot/client.ts +8 -3
  198. package/src/plugins/builtin/cot/headless.ts +65 -12
  199. package/src/plugins/builtin/cot/pane.tsx +11 -5
  200. package/src/plugins/builtin/earnings/client.ts +40 -6
  201. package/src/plugins/builtin/earnings/fiscal-quarter.ts +54 -0
  202. package/src/plugins/builtin/earnings/headless.ts +47 -11
  203. package/src/plugins/builtin/earnings/history-model.ts +136 -24
  204. package/src/plugins/builtin/earnings/history-table.ts +42 -10
  205. package/src/plugins/builtin/earnings/history.tsx +23 -8
  206. package/src/plugins/builtin/earnings-ripple/client.ts +5 -2
  207. package/src/plugins/builtin/earnings-ripple/headless.ts +8 -3
  208. package/src/plugins/builtin/earnings-ripple/model.ts +21 -0
  209. package/src/plugins/builtin/earnings-ripple/pane.tsx +2 -3
  210. package/src/plugins/builtin/econ/index.tsx +5 -4
  211. package/src/plugins/builtin/econ-statistics/stats.ts +13 -5
  212. package/src/plugins/builtin/equity-screener/headless.ts +2 -1
  213. package/src/plugins/builtin/filing-events/feed.ts +56 -18
  214. package/src/plugins/builtin/filing-events/pane.tsx +8 -2
  215. package/src/plugins/builtin/futures/index.tsx +32 -10
  216. package/src/plugins/builtin/futures/model.ts +93 -6
  217. package/src/plugins/builtin/futures/returns.ts +29 -7
  218. package/src/plugins/builtin/futures/table.tsx +59 -17
  219. package/src/plugins/builtin/futures/use-front-returns.ts +32 -6
  220. package/src/plugins/builtin/futures-curve/client.ts +12 -2
  221. package/src/plugins/builtin/futures-curve/headless.ts +58 -17
  222. package/src/plugins/builtin/futures-curve/model.ts +111 -15
  223. package/src/plugins/builtin/futures-curve/pane.tsx +11 -6
  224. package/src/plugins/builtin/fx-matrix/amount.ts +132 -0
  225. package/src/plugins/builtin/fx-matrix/headless.ts +53 -13
  226. package/src/plugins/builtin/fx-matrix/index.tsx +205 -42
  227. package/src/plugins/builtin/fx-matrix/pairs.ts +10 -8
  228. package/src/plugins/builtin/fx-matrix/settings.ts +22 -1
  229. package/src/plugins/builtin/help/index.tsx +68 -61
  230. package/src/plugins/builtin/holders/format.ts +7 -2
  231. package/src/plugins/builtin/holders/pane.tsx +11 -3
  232. package/src/plugins/builtin/holders/report-header.ts +5 -4
  233. package/src/plugins/builtin/holders/report-rows.ts +4 -1
  234. package/src/plugins/builtin/holders/treemap.tsx +5 -3
  235. package/src/plugins/builtin/insider/signals-model.ts +4 -5
  236. package/src/plugins/builtin/ipo-calendar/headless.ts +18 -7
  237. package/src/plugins/builtin/ipo-calendar/listing-ipo.ts +3 -1
  238. package/src/plugins/builtin/ipo-calendar/model.ts +28 -8
  239. package/src/plugins/builtin/ipo-calendar/pane.tsx +2 -1
  240. package/src/plugins/builtin/kelly-sizer/headless.ts +4 -0
  241. package/src/plugins/builtin/perps/headless.ts +73 -17
  242. package/src/plugins/builtin/perps/index.tsx +3 -1
  243. package/src/plugins/builtin/perps/model.ts +1 -1
  244. package/src/plugins/builtin/perps/pane.tsx +2 -0
  245. package/src/plugins/builtin/portfolio-list/cell-version.ts +1 -0
  246. package/src/plugins/builtin/portfolio-list/cli/bulk-symbols.ts +20 -1
  247. package/src/plugins/builtin/portfolio-list/cli/import-positions.ts +260 -0
  248. package/src/plugins/builtin/portfolio-list/cli/period-report.ts +154 -0
  249. package/src/plugins/builtin/portfolio-list/cli/portfolio-command.ts +64 -22
  250. package/src/plugins/builtin/portfolio-list/cli/render.ts +18 -7
  251. package/src/plugins/builtin/portfolio-list/cli/watchlist-command.ts +5 -3
  252. package/src/plugins/builtin/portfolio-list/grid.tsx +56 -12
  253. package/src/plugins/builtin/portfolio-list/headless.ts +128 -0
  254. package/src/plugins/builtin/portfolio-list/pane/index.tsx +42 -4
  255. package/src/plugins/builtin/portfolio-list/pane/period-pnl.ts +124 -0
  256. package/src/plugins/builtin/portfolio-list/period-pnl.ts +179 -0
  257. package/src/plugins/builtin/portfolio-list/positions-import/dialog.tsx +445 -0
  258. package/src/plugins/builtin/portfolio-list/positions-import/index.tsx +255 -0
  259. package/src/plugins/builtin/portfolio-list/positions-import/lookup.ts +78 -0
  260. package/src/plugins/builtin/portfolio-list/positions-import/read-file.ts +32 -0
  261. package/src/plugins/builtin/portfolio-list/quick-add/index.tsx +186 -50
  262. package/src/plugins/builtin/portfolio-list/quick-add/resolution.ts +118 -4
  263. package/src/plugins/builtin/portfolio-list/settings.ts +25 -0
  264. package/src/plugins/builtin/portfolio-list/summary/index.tsx +16 -1
  265. package/src/plugins/builtin/portfolio-list/summary/totals.ts +7 -5
  266. package/src/plugins/builtin/portfolio-list/table.tsx +105 -6
  267. package/src/plugins/builtin/power/headless.ts +47 -9
  268. package/src/plugins/builtin/research/relative-valuation-model.ts +8 -3
  269. package/src/plugins/builtin/research-search/article.ts +12 -2
  270. package/src/plugins/builtin/research-search/data.ts +5 -2
  271. package/src/plugins/builtin/research-search/document-view.tsx +1 -1
  272. package/src/plugins/builtin/research-search/model.ts +47 -3
  273. package/src/plugins/builtin/research-search/pane.tsx +3 -2
  274. package/src/plugins/builtin/reverse-dcf/model.ts +7 -4
  275. package/src/plugins/builtin/risk-factors/headless.ts +3 -2
  276. package/src/plugins/builtin/risk-factors/pane.tsx +5 -3
  277. package/src/plugins/builtin/scanner/flow-model.ts +17 -13
  278. package/src/plugins/builtin/scanner/flow-pane.tsx +8 -9
  279. package/src/plugins/builtin/scanner/flow-session.ts +2 -9
  280. package/src/plugins/builtin/sec/filing-display.tsx +0 -5
  281. package/src/plugins/builtin/sec/forms.ts +19 -0
  282. package/src/plugins/builtin/sec/headless.ts +7 -11
  283. package/src/plugins/builtin/sec/index.tsx +11 -3
  284. package/src/plugins/builtin/shared/earnings-calendar.ts +6 -3
  285. package/src/plugins/builtin/shared/earnings-report.ts +1 -1
  286. package/src/plugins/builtin/shared/fx-rate-freshness.ts +0 -35
  287. package/src/plugins/builtin/shared/use-quote-board.ts +42 -27
  288. package/src/plugins/builtin/supply-chain/graph-model.ts +7 -1
  289. package/src/plugins/builtin/supply-chain/headless.ts +20 -10
  290. package/src/plugins/builtin/supply-chain/model.ts +117 -20
  291. package/src/plugins/builtin/supply-chain/pane.tsx +22 -15
  292. package/src/plugins/builtin/supply-chain/row-evidence.tsx +1 -1
  293. package/src/plugins/builtin/ticker-detail/data-panes/returns-chart-model.ts +69 -0
  294. package/src/plugins/builtin/ticker-detail/data-panes/returns-chart.tsx +118 -0
  295. package/src/plugins/builtin/ticker-detail/data-panes/returns-model.ts +1 -1
  296. package/src/plugins/builtin/ticker-detail/data-panes/returns-pane.tsx +103 -40
  297. package/src/plugins/builtin/ticker-detail/headless-schema.ts +10 -1
  298. package/src/plugins/builtin/ticker-detail/headless.ts +8 -1
  299. package/src/plugins/builtin/ticker-detail/overview/components.tsx +2 -1
  300. package/src/plugins/builtin/ticker-detail/overview/model.ts +4 -2
  301. package/src/plugins/builtin/ticker-detail/overview-tab.tsx +11 -8
  302. package/src/plugins/builtin/ticker-detail/pane.tsx +95 -20
  303. package/src/plugins/builtin/ticker-detail/research-groups.ts +89 -0
  304. package/src/plugins/builtin/ticker-detail/settings.ts +4 -3
  305. package/src/plugins/builtin/volatility/charts.tsx +2 -2
  306. package/src/plugins/host-resolver.ts +3 -2
  307. package/src/portfolio/column-values.ts +42 -8
  308. package/src/portfolio/futures-positions.ts +10 -2
  309. package/src/portfolio/mutations.ts +4 -3
  310. package/src/portfolio/period-pnl.ts +119 -0
  311. package/src/portfolio/positions-import/describe.ts +89 -0
  312. package/src/portfolio/positions-import/parse.ts +682 -0
  313. package/src/portfolio/positions-import/plan.ts +295 -0
  314. package/src/{plugins/builtin/analytics/metrics.ts → portfolio/return-metrics.ts} +24 -11
  315. package/src/public/__snapshots__/public-api.test.ts.snap +1 -0
  316. package/src/react/jsx-dev-fallback.ts +62 -0
  317. package/src/renderers/browser/cloud-transport.ts +1 -1
  318. package/src/renderers/browser/config-host.ts +3 -1
  319. package/src/renderers/browser/deeplink-bridge.ts +8 -1
  320. package/src/renderers/browser/http-proxy-transport.ts +9 -2
  321. package/src/renderers/browser/main.tsx +2 -1
  322. package/src/renderers/browser/research-entry.ts +12 -0
  323. package/src/renderers/cloudflare/http-proxy.ts +8 -2
  324. package/src/renderers/cloudflare/proxy-session.ts +1 -0
  325. package/src/renderers/cloudflare/worker.ts +12 -3
  326. package/src/renderers/dom/desktop/audio-player.tsx +2 -2
  327. package/src/renderers/dom/desktop/controls.tsx +1 -1
  328. package/src/renderers/dom/desktop/dialog-actions.tsx +10 -24
  329. package/src/renderers/dom/desktop/icons.tsx +4 -2
  330. package/src/renderers/dom/desktop/query-bar.tsx +23 -19
  331. package/src/renderers/dom/dom-host-providers.tsx +7 -2
  332. package/src/renderers/dom/host/box.tsx +2 -2
  333. package/src/renderers/dom/host/input.tsx +13 -0
  334. package/src/renderers/dom/key-event.ts +1 -0
  335. package/src/renderers/dom/styles.css +3 -0
  336. package/src/renderers/electrobun/bun/context-menu/click.ts +1 -0
  337. package/src/renderers/electrobun/bun/desktop/backend.ts +1 -0
  338. package/src/renderers/electrobun/bun/desktop/capability-bridge.ts +5 -4
  339. package/src/renderers/electrobun/bun/desktop/host-requests.ts +5 -4
  340. package/src/renderers/electrobun/bun/desktop/http-fetch.ts +1 -0
  341. package/src/renderers/electrobun/bun/desktop/http-stream.ts +1 -1
  342. package/src/renderers/electrobun/bun/desktop/initialization.ts +3 -1
  343. package/src/renderers/electrobun/bun/desktop/install-records.ts +4 -1
  344. package/src/renderers/electrobun/bun/desktop/installer-folder.ts +5 -2
  345. package/src/renderers/electrobun/bun/desktop/macos-objc.ts +3 -1
  346. package/src/renderers/electrobun/bun/desktop/screen-setup-file.ts +9 -4
  347. package/src/renderers/electrobun/bun/desktop/update.ts +27 -13
  348. package/src/renderers/electrobun/bun/desktop/windows-script.ts +6 -2
  349. package/src/renderers/electrobun/bun/window/attention.ts +1 -0
  350. package/src/renderers/electrobun/bun/window/boot-frame.ts +1 -0
  351. package/src/renderers/electrobun/bun/window/create.ts +1 -0
  352. package/src/renderers/electrobun/bun/window/electrobun-window-host.ts +13 -8
  353. package/src/renderers/electrobun/bun/window/native-min-size.ts +1 -1
  354. package/src/renderers/electrobun/bun/window/remembered-frame.ts +1 -0
  355. package/src/renderers/electrobun/bun/window/windows-native.ts +3 -1
  356. package/src/renderers/electrobun/bun/window/windows-quit.ts +3 -1
  357. package/src/renderers/electrobun/view/app-badge-host.ts +2 -1
  358. package/src/renderers/electrobun/view/capability-subscription.ts +2 -1
  359. package/src/renderers/electrobun/view/cli-pane-shot-entry.tsx +7 -10
  360. package/src/renderers/electrobun/view/cli-pane-shot-mutations.ts +36 -0
  361. package/src/renderers/electrobun/view/http-fetch.ts +2 -1
  362. package/src/renderers/electrobun/view/main.tsx +9 -4
  363. package/src/renderers/electrobun/view/remote/capability-invoker.ts +6 -3
  364. package/src/renderers/electrobun/view/remote/persistence.ts +63 -27
  365. package/src/renderers/electrobun/view/rpc-timeout.ts +1 -0
  366. package/src/renderers/electrobun/view/ui-host.tsx +3 -2
  367. package/src/renderers/electrobun/view/window-fullscreen.ts +3 -1
  368. package/src/renderers/opentui/browser-open.ts +2 -1
  369. package/src/renderers/opentui/dialog-host.tsx +1 -1
  370. package/src/renderers/opentui/interaction-performance.ts +3 -1
  371. package/src/renderers/opentui/start.tsx +2 -1
  372. package/src/renderers/opentui/terminal-media.ts +11 -6
  373. package/src/renderers/opentui/ui-host.tsx +5 -8
  374. package/src/shares/open.ts +22 -1
  375. package/src/shares/pane.ts +2 -1
  376. package/src/sources/gloomberb-cloud/normalizers.ts +3 -0
  377. package/src/sync/analytics-payload.ts +194 -0
  378. package/src/sync/baseline.ts +19 -9
  379. package/src/sync/broker-identity.ts +171 -0
  380. package/src/sync/broker-instances.ts +137 -0
  381. package/src/sync/collections-contributor.ts +173 -0
  382. package/src/sync/config-contributor.ts +100 -0
  383. package/src/sync/config-merge.ts +229 -0
  384. package/src/sync/controller.ts +139 -28
  385. package/src/sync/core-contributors.ts +8 -1583
  386. package/src/sync/history-memo.ts +32 -0
  387. package/src/sync/layout-merge.ts +259 -0
  388. package/src/sync/sanitize.ts +114 -0
  389. package/src/sync/ticker-merge.ts +208 -0
  390. package/src/sync/ticker-payload.ts +81 -0
  391. package/src/sync/types.ts +15 -1
  392. package/src/telemetry/attention-setting.ts +1 -1
  393. package/src/telemetry/usage-counts.ts +16 -0
  394. package/src/test-support/preload.ts +5 -0
  395. package/src/theme/color-utils.ts +10 -0
  396. package/src/theme/font-scale.ts +34 -3
  397. package/src/theme/series-colors.ts +44 -0
  398. package/src/theme/themes.ts +2 -1
  399. package/src/tickers/batched-lookups.ts +263 -6
  400. package/src/tickers/company-name-listing.ts +44 -2
  401. package/src/tickers/company-name.ts +7 -2
  402. package/src/tickers/search/upsert.ts +16 -1
  403. package/src/time-series/base-series.ts +18 -4
  404. package/src/time-series/studies/indicators.ts +3 -1
  405. package/src/time-series/studies/resolve.ts +1 -1
  406. package/src/time-series/types.ts +6 -0
  407. package/src/types/financials.ts +18 -0
  408. package/src/types/headless.ts +11 -0
  409. package/src/ui/host.tsx +26 -3
  410. package/src/ui/index.tsx +1 -0
  411. package/src/utils/concurrency.ts +6 -0
  412. package/src/utils/currency-pair.ts +56 -4
  413. package/src/utils/datetime-format.ts +11 -0
  414. package/src/utils/decimal-comma.ts +9 -6
  415. package/src/utils/exchanges.ts +32 -0
  416. package/src/utils/fundamentals.ts +41 -0
  417. package/src/utils/markdown.ts +4 -2
  418. package/src/utils/pasted-lines.ts +14 -0
  419. package/src/utils/price-window.ts +2 -1
  420. package/src/utils/sec-filings.ts +17 -0
  421. package/src/utils/sec.ts +4 -23
  422. package/src/utils/shortcut-labels.ts +6 -30
@@ -1,12 +1,10 @@
1
- import { Box, ScrollBox, Text, TextAttributes, type InputRenderable, type ScrollBoxRenderable } from "../../../ui";
2
- import { useCallback, useEffect, useMemo, useRef, useState } from "react";
1
+ import { Box, type InputRenderable } from "../../../ui";
2
+ import { useCallback, useMemo, useRef, useState } from "react";
3
3
  import { PaneStatusBody, QueryBar, usePaneFooter, usePaneNoticeFooter } from "../../../components";
4
4
  import { handleRefreshKey } from "../../../components/data-table/table-pane";
5
- import { afterLayout } from "../../../components/ui/reveal-in-scroll-box";
6
5
  import type { PaneProps } from "../../../types/plugin";
7
6
  import type { PluginModule } from "../plugin-module";
8
7
  import { TICKER_RESEARCH_PANE_ID } from "../../../types/config";
9
- import { colors } from "../../../theme/colors";
10
8
  import { usePluginAppActions, usePluginTickerActions } from "../../runtime";
11
9
  import { useAppSelector, usePaneInstance, usePaneSettingValue } from "../../../state/app/context";
12
10
  import { useChartQueries } from "../../../market-data/hooks";
@@ -18,7 +16,7 @@ import { isPlainKey } from "../../../utils/keyboard";
18
16
  import { useAsyncResource } from "../../../react/async-resource";
19
17
  import { cloudGeoRequest } from "../world-venue-map/client";
20
18
  import { geoSeriesToken, loadGeoCorrelationHistory } from "./geo";
21
- import { formatCorrelation, type DailyClose } from "./compute";
19
+ import type { DailyClose } from "./compute";
22
20
  import {
23
21
  CORRELATION_RANGE_OPTIONS,
24
22
  DEFAULT_CORRELATION_SYMBOLS,
@@ -27,7 +25,6 @@ import {
27
25
  getCorrelationPaneSettings,
28
26
  type CorrelationRangePreset,
29
27
  } from "./settings";
30
- import { resolveHeatCellColors } from "../../../theme/heat-colors";
31
28
  import {
32
29
  buildRelationshipGraphSettingsDef,
33
30
  createRelationshipPaneTemplate,
@@ -35,23 +32,19 @@ import {
35
32
  RelationshipGraphPane,
36
33
  } from "./relationship/pane";
37
34
  import {
38
- MATRIX_CELL_WIDTH,
39
- MIN_MATRIX_CELL_WIDTH,
40
- ROW_HEADER_WIDTH,
41
35
  buildCorrelationMatrix,
42
36
  buildCorrelationPaneTitle,
43
37
  buildGeoCorrelationSeries,
44
38
  buildStatusSummary,
45
39
  type CorrelationSeries,
46
- displaySymbol,
47
40
  getSeriesForEntry,
48
41
  pairKey,
49
42
  rowHeaderColor,
50
43
  } from "./matrix/model";
51
- import { SymbolLabelCell } from "./matrix/symbol-cell";
44
+ import { CorrelationMatrixGrid, correlationMatrixLayout, useCorrelationMatrixNavigation } from "./matrix/grid";
52
45
  import { correlationHeadless, relationshipHeadless } from "./headless";
53
46
  import { CORRELATION_HISTORY_RESOLUTION } from "./history";
54
- import { buildMatrixPairHistory, clampMatrixCursor, matrixChartRows, matrixSelection, moveMatrixCursor, type MatrixCursor } from "./matrix/selection";
47
+ import { buildMatrixPairHistory, matrixChartRows } from "./matrix/selection";
55
48
  import { MatrixPairChart } from "./matrix/pair-chart";
56
49
 
57
50
  /** A map series' values and when they arrived; after a failed load, the error and any values kept from before. */
@@ -66,12 +59,6 @@ function CorrelationMatrixPane({ focused, width, height }: PaneProps) {
66
59
  const { navigateTicker, pinTicker } = usePluginTickerActions();
67
60
  const { createPaneFromTemplate } = usePluginAppActions();
68
61
  const tickers = useAppSelector((state) => state.tickers);
69
- const [{ cursor: cellCursor, hoveredSymbol }, setCursorState] = useState<{ cursor: MatrixCursor; hoveredSymbol: string | null }>({
70
- cursor: { row: 0, column: 1 }, hoveredSymbol: null,
71
- });
72
- const hoverSymbol = useCallback((symbol: string) => {
73
- setCursorState((current) => ({ ...current, hoveredSymbol: symbol }));
74
- }, []);
75
62
  const settings = useMemo(() => getCorrelationPaneSettings(pane?.settings), [pane?.settings]);
76
63
  const [rangePreset, setRangePreset] = usePaneSettingValue<CorrelationRangePreset>("rangePreset", settings.rangePreset);
77
64
  const [symbolsText, setSymbolsText] = usePaneSettingValue<string>("symbolsText", settings.symbolsText);
@@ -83,8 +70,6 @@ function CorrelationMatrixPane({ focused, width, height }: PaneProps) {
83
70
  const symbolsBeforeEditRef = useRef(symbolsText);
84
71
  // Remounts the query bar so the field drops the draft Esc threw away.
85
72
  const [queryBarRevision, setQueryBarRevision] = useState(0);
86
- const matrixScrollRef = useRef<ScrollBoxRenderable | null>(null);
87
- const horizontalScrollRef = useRef<ScrollBoxRenderable | null>(null);
88
73
 
89
74
  const entries = settings.symbolsError ? [] : settings.symbols;
90
75
  const geoEntries = entries.filter((entry) => geoSeriesToken(entry));
@@ -164,12 +149,29 @@ function CorrelationMatrixPane({ focused, width, height }: PaneProps) {
164
149
 
165
150
  const symbols = entries;
166
151
  const symbolsKey = symbols.join(",");
167
- const cursor = clampMatrixCursor(cellCursor, symbols.length);
168
- const selection = matrixSelection(symbols, cursor);
152
+ const openSymbol = useCallback((symbol: string) => {
153
+ if (geoSeriesToken(symbol)) {
154
+ createPaneFromTemplate("chart-composer-pane", { arg: symbol });
155
+ return;
156
+ }
157
+ if (tickers.has(symbol)) {
158
+ pinTicker(symbol, { floating: true, paneType: TICKER_RESEARCH_PANE_ID });
159
+ return;
160
+ }
161
+ navigateTicker(symbol);
162
+ }, [createPaneFromTemplate, navigateTicker, pinTicker, tickers]);
163
+ const navigation = useCorrelationMatrixNavigation({
164
+ symbols,
165
+ focused: focused && !symbolsEditing,
166
+ scope: "correlation:matrix",
167
+ // Ratio and beta are price measures, so a pair with a map series charts both in G instead.
168
+ onOpenPair: (pair) => pair.some((entry) => geoSeriesToken(entry))
169
+ ? createPaneFromTemplate("chart-composer-pane", { arg: formatTickerListInput(pair) })
170
+ : createPaneFromTemplate("relationship-graph-pane", { symbols: pair, arg: formatTickerListInput(pair) }),
171
+ onOpenSymbol: openSymbol,
172
+ });
173
+ const { selection } = navigation;
169
174
  const pair = selection && selection[0] !== selection[1] ? selection : null;
170
- useEffect(() => {
171
- setCursorState((current) => ({ ...current, cursor: clampMatrixCursor(current.cursor, symbols.length) }));
172
- }, [symbolsKey]);
173
175
  const pairHistory = useMemo(() => pair ? buildMatrixPairHistory(
174
176
  seriesBySymbol.get(pair[0]), seriesBySymbol.get(pair[1]), settings.rangePreset,
175
177
  ) : null, [pair?.[0], pair?.[1], seriesBySymbol, settings.rangePreset]);
@@ -189,45 +191,10 @@ function CorrelationMatrixPane({ focused, width, height }: PaneProps) {
189
191
  if (geoKey) void geoHistory.reload();
190
192
  }, [chartRequests, geoKey, geoHistory.reload]);
191
193
 
192
- const openSymbol = useCallback((symbol: string) => {
193
- if (geoSeriesToken(symbol)) {
194
- createPaneFromTemplate("chart-composer-pane", { arg: symbol });
195
- return;
196
- }
197
- if (tickers.has(symbol)) {
198
- pinTicker(symbol, { floating: true, paneType: TICKER_RESEARCH_PANE_ID });
199
- return;
200
- }
201
- navigateTicker(symbol);
202
- }, [createPaneFromTemplate, navigateTicker, pinTicker, tickers]);
203
-
204
- /** Hovered symbols remain a keyboard starting point; Left reaches their row cursor. */
205
- const moveCursor = (key: string) => {
206
- if (symbols.length === 0) return;
207
- setCursorState((current) => {
208
- const hoveredRow = current.hoveredSymbol ? symbols.indexOf(current.hoveredSymbol) : -1;
209
- const start = hoveredRow >= 0 ? { row: hoveredRow, column: -1 } : current.cursor;
210
- return { cursor: moveMatrixCursor(start, key, symbols.length), hoveredSymbol: null };
211
- });
212
- };
213
-
214
194
  useShortcut((event) => {
215
195
  if (!focused || symbolsEditing || event.defaultPrevented) return;
216
- if (handleRefreshKey(event, refresh, { stopPropagation: true })) return;
217
- if (isPlainKey(event, "j", "down", "k", "up", "h", "left", "l", "right")) {
218
- event.preventDefault();
219
- event.stopPropagation();
220
- moveCursor(event.name ?? event.key ?? "");
221
- } else if (isPlainKey(event, "return", "enter") && selection) {
222
- event.preventDefault();
223
- event.stopPropagation();
224
- if (hoveredSymbol && symbols.includes(hoveredSymbol)) openSymbol(hoveredSymbol);
225
- // Ratio and beta are price measures, so a pair with a map series charts both in G instead.
226
- else if (pair && pair.some((entry) => geoSeriesToken(entry))) createPaneFromTemplate("chart-composer-pane", { arg: formatTickerListInput(pair) });
227
- else if (pair) createPaneFromTemplate("relationship-graph-pane", { symbols: pair, arg: formatTickerListInput(pair) });
228
- else openSymbol(selection[0]);
229
- }
230
- }, { phase: "before", scope: "correlation:matrix" });
196
+ handleRefreshKey(event, refresh, { stopPropagation: true });
197
+ }, { phase: "before", scope: "correlation:refresh" });
231
198
 
232
199
  // Esc cancels an edit of the list instead of clearing it: the field's own
233
200
  // Esc empties the draft, which would fall back to the default tickers.
@@ -259,42 +226,11 @@ function CorrelationMatrixPane({ focused, width, height }: PaneProps) {
259
226
  : [],
260
227
  }), [settings.symbolsError, statusSummary, symbols.length]);
261
228
 
262
- const clearHoveredSymbol = useCallback((symbol: string) => {
263
- setCursorState((current) => current.hoveredSymbol === symbol ? { ...current, hoveredSymbol: null } : current);
264
- }, []);
265
-
266
- const headerBg = colors.panel;
267
- const labelWidth = Math.max(0, ...symbols.map((symbol) => displaySymbol(symbol).length));
268
- const rowHeaderWidth = Math.max(ROW_HEADER_WIDTH, Math.min(12, labelWidth + 2));
269
- // A map series label (SUEZ.TANKER) is wider than a ticker's: columns keep room for it and the matrix scrolls instead.
270
- const minCellWidth = Math.max(MIN_MATRIX_CELL_WIDTH, labelWidth + 2);
271
- const cellCount = Math.max(1, symbols.length);
272
- const availableCellWidth = Math.floor((Math.max(width - rowHeaderWidth - 4, cellCount * minCellWidth)) / cellCount);
273
- const cellWidth = Math.max(minCellWidth, Math.min(MATRIX_CELL_WIDTH, availableCellWidth));
274
229
  // Rows are exactly as wide as the matrix (after the one-cell inset), so the
275
230
  // zebra and hover bands stop at the last column instead of running on.
276
- const matrixRowWidth = 1 + rowHeaderWidth + symbols.length * cellWidth;
231
+ const matrixRowWidth = correlationMatrixLayout(symbols, width).rowWidth;
277
232
  const chartRows = pair ? matrixChartRows(width, height, symbols.length, matrixRowWidth) : 0;
278
233
  const matrixHeight = Math.max(1, height - 1 - (chartRows > 0 ? chartRows + 1 : 0));
279
- const horizontalBarRows = matrixRowWidth > width - 1 ? 1 : 0;
280
-
281
- // Scroll after React commits a movement, including several keys in one input batch.
282
- useEffect(() => afterLayout(() => {
283
- const scroll = matrixScrollRef.current;
284
- if (scroll) {
285
- const viewportHeight = Math.max(1, scroll.viewport?.height ?? 1);
286
- if (cursor.row < scroll.scrollTop) scroll.scrollTo(cursor.row);
287
- else if (cursor.row + 1 > scroll.scrollTop + viewportHeight) scroll.scrollTo(cursor.row + 1 - viewportHeight);
288
- }
289
- const horizontal = horizontalScrollRef.current;
290
- if (!horizontal) return;
291
- const left = cursor.column < 0 ? 0 : 1 + rowHeaderWidth + cursor.column * cellWidth;
292
- const right = left + (cursor.column < 0 ? rowHeaderWidth : cellWidth);
293
- const scrollLeft = horizontal.scrollLeft ?? 0;
294
- const viewportWidth = horizontal.viewport?.width || width;
295
- if (left < scrollLeft) horizontal.scrollTo({ x: left, y: 0 });
296
- else if (right > scrollLeft + viewportWidth) horizontal.scrollTo({ x: right - viewportWidth, y: 0 });
297
- }), [cursor.row, cursor.column, matrixHeight, rowHeaderWidth, cellWidth, width]);
298
234
  const bodyStatus = settings.symbolsError
299
235
  ? <PaneStatusBody error={settings.symbolsError} />
300
236
  : symbols.length < 2
@@ -335,79 +271,15 @@ function CorrelationMatrixPane({ focused, width, height }: PaneProps) {
335
271
  />
336
272
  {bodyStatus ?? (
337
273
  <>
338
- <ScrollBox ref={horizontalScrollRef} height={matrixHeight} flexShrink={1} minHeight={Math.min(matrixHeight, symbols.length + 1, 5)} scrollX scrollY={false} focusable={false}>
339
- <Box flexDirection="column" width={Math.max(width - 1, matrixRowWidth)} height={matrixHeight - horizontalBarRows}>
340
- {/* Column header row */}
341
- <Box flexDirection="row" paddingLeft={1} height={1} flexShrink={0} width={matrixRowWidth} backgroundColor={headerBg}>
342
- <Box width={rowHeaderWidth} flexShrink={0} />
343
- {symbols.map((sym) => (
344
- <SymbolLabelCell
345
- key={sym}
346
- symbol={sym}
347
- width={cellWidth}
348
- align="flex-end"
349
- color={colors.textDim}
350
- hovered={hoveredSymbol === sym || selection?.[1] === sym}
351
- onHover={hoverSymbol}
352
- onLeave={clearHoveredSymbol}
353
- onOpen={openSymbol}
354
- />
355
- ))}
356
- </Box>
357
-
358
- {/* Matrix rows */}
359
- <ScrollBox ref={matrixScrollRef} flexGrow={1} flexBasis={0} minHeight={0} scrollY scrollX={false} focusable={false}>
360
- <Box flexDirection="column">
361
- {symbols.map((rowSym, rowIndex) => (
362
- <Box key={rowSym} flexDirection="row" paddingLeft={1} width={matrixRowWidth} backgroundColor={rowIndex % 2 === 0 ? colors.bg : undefined}>
363
- {/* Row header */}
364
- <Box
365
- width={rowHeaderWidth}
366
- flexShrink={0}
367
- overflow="hidden"
368
- >
369
- <SymbolLabelCell
370
- symbol={rowSym}
371
- width={rowHeaderWidth}
372
- color={rowHeaderColor(seriesBySymbol.get(rowSym)?.status ?? "loading")}
373
- hovered={hoveredSymbol === rowSym || selection?.[0] === rowSym}
374
- onHover={hoverSymbol}
375
- onLeave={clearHoveredSymbol}
376
- onOpen={openSymbol}
377
- />
378
- </Box>
379
- {/* Cells */}
380
- {symbols.map((colSym, colIndex) => {
381
- const r = matrix.results.get(pairKey(rowSym, colSym))?.correlation ?? null;
382
- const cellColors = resolveHeatCellColors(r, { quiet: rowSym === colSym });
383
- const text = formatCorrelation(r);
384
- const selected = cursor.row === rowIndex && cursor.column === colIndex;
385
- return (
386
- <Box
387
- key={colSym}
388
- width={cellWidth}
389
- flexShrink={0}
390
- flexDirection="row"
391
- justifyContent="flex-end"
392
- paddingRight={1}
393
- backgroundColor={cellColors.background}
394
- style={{ cursor: "pointer" }}
395
- onMouseDown={(event: any) => {
396
- event.preventDefault?.();
397
- event.stopPropagation?.();
398
- setCursorState({ cursor: { row: rowIndex, column: colIndex }, hoveredSymbol: null });
399
- }}
400
- >
401
- <Text fg={cellColors.foreground} attributes={selected ? TextAttributes.BOLD | TextAttributes.UNDERLINE : TextAttributes.NONE}>{text}</Text>
402
- </Box>
403
- );
404
- })}
405
- </Box>
406
- ))}
407
- </Box>
408
- </ScrollBox>
409
- </Box>
410
- </ScrollBox>
274
+ <CorrelationMatrixGrid
275
+ symbols={symbols}
276
+ width={width}
277
+ height={matrixHeight}
278
+ correlation={(row, column) => matrix.results.get(pairKey(row, column))?.correlation ?? null}
279
+ {...navigation.grid}
280
+ rowColor={(symbol) => rowHeaderColor(seriesBySymbol.get(symbol)?.status ?? "loading")}
281
+ onOpenSymbol={openSymbol}
282
+ />
411
283
  {chartRows > 0 && pair && pairHistory ? (
412
284
  <MatrixPairChart
413
285
  pair={pair}
@@ -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
+ }
@@ -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
 
@@ -302,15 +301,15 @@ export function RelationshipGraphPane({ focused, width, height }: PaneProps) {
302
301
  />
303
302
  </Box>
304
303
  {layout.scatterRows > 0 ? (
305
- <Box flexDirection="column" height={layout.scatterRows} flexShrink={0}>
306
- <Box paddingX={1} height={1}><Text fg={colors.textDim}>{`${leftSymbol} returns (%)`}</Text></Box>
304
+ <Box height={layout.scatterRows} flexShrink={0}>
307
305
  <StaticScatterChartSurface
308
306
  points={scatterPoints}
309
307
  width={width}
310
- height={layout.scatterRows - 2}
308
+ height={layout.scatterRows}
311
309
  regression={stats ? { slope: stats.beta, intercept: stats.alpha, color: REGRESSION_COLOR } : null}
310
+ xLabel={`${rightSymbol} returns (%)`}
311
+ yLabel={`${leftSymbol} returns (%)`}
312
312
  />
313
- <Box paddingX={1} height={1}><Text fg={colors.textDim}>{`${rightSymbol} returns (%)`}</Text></Box>
314
313
  </Box>
315
314
  ) : null}
316
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
  }