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
@@ -7,6 +7,7 @@ import { servedFromSavedCopy } from "../../../data/saved-copies";
7
7
  import { fxPairObservation, fxRateObservations } from "../shared/fx-rate-freshness";
8
8
  import { loadFxBoard, type FxLegReading } from "./client";
9
9
  import { crossMovePercent } from "./direction";
10
+ import { formatAmountFigure, formatFxBoardAmount, parseFxBoardAmount, withAmountCurrencies, type FxBoardAmount } from "./amount";
10
11
  import { FX_CURRENCY_KEYWORDS, formatRate, resolveCurrencies, type FxCurrency } from "./pairs";
11
12
  import { FX_MATRIX_REPORT_OPTIONS, fxMatrixReportNotices } from "./settings";
12
13
 
@@ -15,7 +16,7 @@ const iso = (time: number | null | undefined) => time != null && Number.isFinite
15
16
  const MOVE_COLUMN: HeadlessPaneColumn = { key: "movePercent", header: "Move", align: "right", format: (value) => typeof value === "number" ? formatPercentRaw(value) : "—" };
16
17
  const CROSS_COLUMNS: HeadlessPaneColumn[] = [
17
18
  { key: "pair", header: "Pair" },
18
- { key: "rate", header: "Rate", align: "right", format: (value) => typeof value === "number" ? formatRate(value) : "—" },
19
+ { key: "rate", header: "Rate", align: "right", format: (value, row) => typeof value === "number" ? formatRate(value, String(row.quote)) : "—" },
19
20
  MOVE_COLUMN,
20
21
  { key: "asOf", header: "As of", shrink: false, format: (value) => typeof value === "string" ? formatUtcTime(value) : "—" },
21
22
  { key: "stale", header: "Status", format: (value, row) => (
@@ -23,13 +24,36 @@ const CROSS_COLUMNS: HeadlessPaneColumn[] = [
23
24
  ) },
24
25
  ];
25
26
 
27
+ /** The amount a report was asked to convert (`fn FXC 2500000 EUR`), in the quote currency of each of its crosses. */
28
+ const AMOUNT_COLUMN: HeadlessPaneColumn = {
29
+ key: "converted", header: "Amount", align: "right",
30
+ format: (value, row) => typeof value === "number" ? `${formatAmountFigure(value, String(row.quote))} ${String(row.quote)}` : "",
31
+ };
32
+
26
33
  /**
27
34
  * The columns with the move's header naming its close, as `quote` names a
28
35
  * pair's (`Move vs Wed 21 Oct close`), in the text report; exports keep
29
- * `Move`, so a column read by its name stays where it was.
36
+ * `Move`, so a column read by its name stays where it was. With an amount,
37
+ * its column follows the rate.
30
38
  */
31
- function crossColumns(basis: string | null): HeadlessPaneColumn[] {
32
- return basis ? CROSS_COLUMNS.map((column) => column === MOVE_COLUMN ? { ...column, textHeader: `Move ${basis}` } : column) : CROSS_COLUMNS;
39
+ function crossColumns(basis: string | null, amount: boolean): HeadlessPaneColumn[] {
40
+ const columns = amount ? CROSS_COLUMNS.flatMap((column) => column.key === "rate" ? [column, AMOUNT_COLUMN] : [column]) : CROSS_COLUMNS;
41
+ return basis ? columns.map((column) => column === MOVE_COLUMN ? { ...column, textHeader: `Move ${basis}` } : column) : columns;
42
+ }
43
+
44
+ /** `fn FXC 2500000 EUR`: the amount typed after the function, as the pane's Amount field reads it; null for none. */
45
+ function reportAmount(argument: string | string[] | null | undefined): FxBoardAmount & { to: FxCurrency | null } | null {
46
+ const typed = Array.isArray(argument) ? argument.join(" ") : argument ?? "";
47
+ const request = parseFxBoardAmount(typed);
48
+ if (request && "error" in request) throw new Error(request.error);
49
+ return request;
50
+ }
51
+
52
+ /** The board a report reads: its currencies, with the ones its amount names added at the end as the pane adds them. */
53
+ function reportCurrencies(args: { argument?: string | string[] | null; options: Record<string, unknown> }): FxCurrency[] {
54
+ const currencies = resolveCurrencies(args.options.currencies);
55
+ const amount = reportAmount(args.argument);
56
+ return amount ? withAmountCurrencies(currencies, amount) : currencies;
33
57
  }
34
58
 
35
59
  /** USD per unit, USD itself as 1; null for a leg with no usable rate. */
@@ -52,7 +76,7 @@ function usdPerUnit(readings: ReadonlyMap<string, FxLegReading>, currency: strin
52
76
  export function projectFxCrosses(
53
77
  currencies: readonly FxCurrency[],
54
78
  readings: ReadonlyMap<string, FxLegReading>,
55
- options: { notices?: string[]; now?: number } = {},
79
+ options: { notices?: string[]; now?: number; amount?: FxBoardAmount | null } = {},
56
80
  ): HeadlessRowsResult {
57
81
  const now = options.now ?? Date.now();
58
82
  const rates = new Map(currencies.flatMap((currency) => {
@@ -66,12 +90,18 @@ export function projectFxCrosses(
66
90
  const observed = new Map(observations.map((observation) => [observation.currency, observation]));
67
91
  const reference = (currency: string) => currency === "USD" ? 1 : readings.get(currency)?.reference ?? null;
68
92
 
69
- const rows = currencies.flatMap((base) => currencies.filter((quote) => quote !== base).map((quote) => {
93
+ // With an amount, its crosses come first, each with the amount in its quote currency at the board's rate.
94
+ const amount = options.amount ?? null;
95
+ const bases = amount ? [amount.currency, ...currencies.filter((currency) => currency !== amount.currency)] : currencies;
96
+ const converted = (base: string, rate: number | null) => (
97
+ amount ? { converted: base === amount.currency && rate != null ? amount.amount * rate : null } : {}
98
+ );
99
+ const rows = bases.flatMap((base) => currencies.filter((quote) => quote !== base).map((quote) => {
70
100
  const pair = `${base}/${quote}`;
71
101
  const baseRate = rates.get(base);
72
102
  const quoteRate = rates.get(quote);
73
103
  // A missing leg leaves the cross unavailable, never at parity.
74
- if (baseRate == null || quoteRate == null) return { pair, base, quote, rate: null, movePercent: null, asOf: null };
104
+ if (baseRate == null || quoteRate == null) return { pair, base, quote, rate: null, ...converted(base, null), movePercent: null, asOf: null };
75
105
  // A cross drawn from a leg's saved copy, its refresh having failed, is as old as that copy.
76
106
  const saved = [base, quote].flatMap((currency) => readings.get(currency)?.savedAt ?? []);
77
107
  const legs = [base, quote].flatMap((currency) => observed.get(currency) ?? []);
@@ -83,6 +113,7 @@ export function projectFxCrosses(
83
113
  base,
84
114
  quote,
85
115
  rate: baseRate / quoteRate,
116
+ ...converted(base, baseRate / quoteRate),
86
117
  movePercent: baseReference != null && quoteReference != null
87
118
  ? crossMovePercent(baseRate, baseReference, quoteRate, quoteReference)
88
119
  : null,
@@ -102,7 +133,7 @@ export function projectFxCrosses(
102
133
  return error ? [`${currency}: ${error}`] : [];
103
134
  });
104
135
  return {
105
- columns: crossColumns(moveBasis),
136
+ columns: crossColumns(moveBasis, amount != null),
106
137
  rows,
107
138
  ...(rows.length === 0 ? { empty: "One currency has no crosses. Add another, such as --currencies USD,EUR." } : {}),
108
139
  complete: unavailable.length === 0,
@@ -112,6 +143,7 @@ export function projectFxCrosses(
112
143
  metadata: {
113
144
  ...(options.notices?.length ? { notices: options.notices } : {}),
114
145
  currencies,
146
+ ...(amount ? { amount: { amount: amount.amount, currency: amount.currency } } : {}),
115
147
  unit: "quote currency per one unit of the base currency",
116
148
  method: "the base currency's USD rate divided by the quote currency's; the two legs' observation times can differ",
117
149
  movePercent: "the cross against both legs' previous daily closes, from each pair's quote; empty where a leg has no current pair quote",
@@ -138,10 +170,16 @@ export function projectFxCrosses(
138
170
 
139
171
  export const fxMatrixHeadless: HeadlessPaneDefinition<"rows"> = {
140
172
  shape: "rows",
141
- argument: { kind: "none" },
173
+ argument: {
174
+ kind: "free-text", optional: true, placeholder: "amount",
175
+ description: "An amount to convert into each currency, as the pane's Amount field takes it: 2500000 EUR, 2,500,000 EUR/USD.",
176
+ },
142
177
  description: "Cross rates between currencies, one row per ordered pair, each with its move since the previous close, observation time and stale flag.",
143
178
  freshness: { source: "Gloom Cloud" },
144
- describe: (args) => `FX Cross Rates | ${resolveCurrencies(args.options.currencies).join(" ")}`,
179
+ describe: (args) => {
180
+ const amount = reportAmount(args.argument);
181
+ return `FX Cross Rates | ${reportCurrencies(args).join(" ")}${amount ? ` | ${formatFxBoardAmount(amount)}` : ""}`;
182
+ },
145
183
  discovery: {
146
184
  // A currency's code or name finds the board (`catalog yen`, `catalog chf`), and so do the safe havens it
147
185
  // carries, the yen and the franc. Searched, never listed: the catalog's Keywords line stays short.
@@ -155,16 +193,18 @@ export const fxMatrixHeadless: HeadlessPaneDefinition<"rows"> = {
155
193
  // the pair names both codes, and each leg's feed and delay are in metadata.
156
194
  compact: (result) => ({
157
195
  ...result,
158
- rows: result.rows.map(({ pair, rate, movePercent, asOf, stale }) => ({
196
+ rows: result.rows.map(({ pair, rate, converted, movePercent, asOf, stale }) => ({
159
197
  pair,
160
198
  rate: typeof rate === "number" ? Number(rate.toPrecision(6)) : null,
199
+ ...(converted === undefined ? {} : { converted: typeof converted === "number" ? Number(converted.toFixed(2)) : null }),
161
200
  movePercent: typeof movePercent === "number" ? Number(movePercent.toFixed(3)) : null,
162
201
  asOf,
163
202
  ...(stale === undefined ? {} : { stale }),
164
203
  })),
165
204
  }),
166
205
  async load(args, ctx) {
167
- const currencies = resolveCurrencies(args.options.currencies);
206
+ const amount = reportAmount(args.argument);
207
+ const currencies = reportCurrencies(args);
168
208
  const readings = await loadFxBoard(currencies, ctx.marketData, { forceRefresh: ctx.refresh });
169
209
  ctx.signal.throwIfAborted();
170
210
  const legs = [...readings.values()];
@@ -172,6 +212,6 @@ export const fxMatrixHeadless: HeadlessPaneDefinition<"rows"> = {
172
212
  if (legs.length > 0 && legs.every((reading) => reading.entry == null)) {
173
213
  throw new Error(`Exchange rates unavailable for ${legs.map(({ leg }) => leg.currency).join(", ")}: ${legs[0]!.error}`);
174
214
  }
175
- return projectFxCrosses(currencies, readings, { notices: fxMatrixReportNotices(args.options) });
215
+ return projectFxCrosses(currencies, readings, { notices: fxMatrixReportNotices(args.options), amount });
176
216
  },
177
217
  };
@@ -1,7 +1,9 @@
1
1
  import { logFailure } from "../../../utils/log-failure";
2
- import { useCallback, useMemo, useRef, useState, type ReactNode } from "react";
2
+ import { t, tf } from "../../../i18n";
3
+ import { useCallback, useEffect, useMemo, useRef, useState, type ReactNode } from "react";
3
4
  import {
4
5
  DataTableView,
6
+ QueryBar,
5
7
  usePaneFooter,
6
8
  type DataTableCell,
7
9
  type DataTableColumn,
@@ -10,17 +12,20 @@ import {
10
12
  } from "../../../components";
11
13
  import { handleRefreshKey } from "../../../components/data-table/table-pane";
12
14
  import { createDataTableCsv } from "../../../components/data-table/export";
13
- import { dropColumnsToFit } from "../../../components/ui/table-layout";
14
15
  import { ageFooterSegment, savedCopyFooterSegment } from "../../../components/layout/pane/footer";
15
16
  import { CountryFlag } from "../../../components/ui/country-flag";
16
17
  import { getSharedMarketDataCoordinator } from "../../../market-data/coordinator";
17
18
  import { useFxRatesMap } from "../../../market-data/hooks";
18
19
  import { resolveEntryData } from "../../../market-data/selectors";
19
20
  import { useRemoteUiNode } from "../../../remote/semantic-tree";
20
- import { usePaneSettingValue } from "../../../state/app/context";
21
+ import { usePaneSettingValue, useUpdatePaneSettings } from "../../../state/app/context";
21
22
  import { colors } from "../../../theme/colors";
22
- import type { PaneProps } from "../../../types/plugin";
23
- import { TextAttributes, useUiCapabilities } from "../../../ui";
23
+ import type {
24
+ CommandBarResultDef, CommandBarSearchProvider, GloomPluginContext, PaneProps, PaneTemplateContext, PaneTemplateCreateOptions,
25
+ PaneTemplateInstanceConfig,
26
+ } from "../../../types/plugin";
27
+ import { TextAttributes, useUiCapabilities, type InputRenderable } from "../../../ui";
28
+ import { isPaneInLayout } from "../../../layout/pane-manager";
24
29
  import { useAssetData } from "../../runtime";
25
30
  import { summarizeFxRates, fxStatusLabel } from "../../../utils/fx-status";
26
31
  import type { PluginModule } from "../plugin-module";
@@ -34,8 +39,13 @@ import { crossMovePercent, directionTint, nextTintLevel } from "./direction";
34
39
  import { fxMatrixSettings } from "./settings";
35
40
  import { createFxExportMetadata } from "./export";
36
41
  import { fxMatrixHeadless } from "./headless";
42
+ import {
43
+ formatAmountFigure, formatFxBoardAmount, parseFxBoardAmount, parseFxBoardAmountEdit, readFxBoardAmount, storedFxBoardAmount, withAmountCurrencies,
44
+ type FxBoardAmount,
45
+ } from "./amount";
37
46
 
38
47
  const FX_MATRIX_PANE_ID = "fx-matrix";
48
+ const FX_MATRIX_TEMPLATE_ID = "fx-matrix-pane";
39
49
  /** Stable identity: a fresh literal here would reload the board every render. */
40
50
  const NO_SAVED_CURRENCIES: string[] = [];
41
51
  const BASE_COLUMN_WIDTH = 5;
@@ -48,29 +58,25 @@ const RATE_COLUMN_WIDTH = 10;
48
58
  /** Snapshot rates reload at this pace while the feed is not carrying every leg. */
49
59
  const FX_FALLBACK_REFRESH_MS = 60_000;
50
60
 
61
+ /** Room for `e.g. 2,500,000 EUR`, and for `2,500,000 EUR` and the cursor after it. */
62
+ const AMOUNT_FIELD_WIDTH = 18;
63
+
51
64
  /**
52
- * The board's columns for a pane `width` cells wide: whole currency columns
53
- * give way from the right until the rest fit (`dropColumnsToFit`), the first
54
- * currency always kept. A board with more rows than `height` holds keeps a
55
- * cell for its scrollbar.
65
+ * The amount field: it shows the amount grouped (`5,000 EUR`), and is edited
66
+ * as the board saves it (`5000 EUR`), which reads back as itself where `5,000`
67
+ * would ask which was meant. Typing edits a draft, Enter applies it to the
68
+ * board, and leaving it without Enter puts back the amount the board shows.
56
69
  */
57
- function fxMatrixColumnsToFit<C extends DataTableColumn>(
58
- columns: readonly C[], currencies: readonly string[], width: number, height: number,
59
- ): C[] {
60
- const scrollbar = currencies.length + 1 > height ? 1 : 0;
61
- return dropColumnsToFit(columns, Math.floor(width) - scrollbar, currencies.slice(1).reverse());
62
- }
63
-
64
- /** "1 column hidden" in the footer, the codes in its title, for a pane too narrow for every currency. */
65
- export function fxHiddenColumnsSegment(hidden: readonly string[]): PaneFooterSegment {
66
- const count = hidden.length;
67
- return {
68
- id: "hidden-columns",
69
- // A capture keeps it, as a picture cannot scroll to the columns it left out.
70
- capture: true,
71
- title: `${hidden.join(", ")} ${count === 1 ? "is" : "are"} not shown as ${count === 1 ? "a column" : "columns"}: widen the pane`,
72
- parts: [{ text: `${count} ${count === 1 ? "column" : "columns"} hidden`, tone: "muted" }],
73
- };
70
+ function useAmountField(shown: string, edited: string) {
71
+ const [draft, setDraft] = useState(shown);
72
+ const [active, setActiveState] = useState(false);
73
+ const inputRef = useRef<InputRenderable>(null);
74
+ useEffect(() => { if (!active) setDraft(shown); }, [active, shown]);
75
+ const setActive = useCallback((next: boolean) => {
76
+ setActiveState(next);
77
+ if (next) setDraft(edited);
78
+ }, [edited]);
79
+ return { draft, setDraft, active, setActive, inputRef };
74
80
  }
75
81
 
76
82
  function FxMatrixPane({ focused, width, height }: PaneProps) {
@@ -79,6 +85,29 @@ function FxMatrixPane({ focused, width, height }: PaneProps) {
79
85
  const [savedCurrencies] = usePaneSettingValue<string[]>("currencies", NO_SAVED_CURRENCIES);
80
86
  const currencies = useMemo(() => resolveCurrencies(savedCurrencies), [savedCurrencies]);
81
87
  const [selectedCurrency, setSelectedCurrency] = useState<string | null>(null);
88
+ // An amount (2,500,000 EUR) is shown in every currency the board lists, at the board's rates.
89
+ const [savedAmount] = usePaneSettingValue<string>("amount", "");
90
+ const updateSettings = useUpdatePaneSettings();
91
+ const typedAmount = useMemo(() => readFxBoardAmount(savedAmount), [savedAmount]);
92
+ const amount: FxBoardAmount | null = typedAmount && !("error" in typedAmount) ? typedAmount : null;
93
+ const amountField = useAmountField(
94
+ amount ? formatFxBoardAmount(amount) : String(savedAmount ?? ""),
95
+ amount ? storedFxBoardAmount(amount) : String(savedAmount ?? ""),
96
+ );
97
+ const [amountError, setAmountError] = useState<string | null>(null);
98
+ const applyAmount = useCallback((text: string) => {
99
+ const request = parseFxBoardAmountEdit(text, savedAmount);
100
+ if (request && "error" in request) {
101
+ setAmountError(request.error);
102
+ return;
103
+ }
104
+ setAmountError(null);
105
+ amountField.setActive(false);
106
+ // A currency the board does not list yet joins it, as `fx 100 ZAR/NGN` opens it on ZAR and NGN.
107
+ updateSettings(request
108
+ ? { amount: storedFxBoardAmount(request), currencies: withAmountCurrencies(currencies, request) }
109
+ : { amount: undefined });
110
+ }, [amountField.setActive, currencies, savedAmount, updateSettings]);
82
111
 
83
112
  const snapshotRates = useFxRatesMap(currencies);
84
113
  // Each non-USD currency streams its USD pair; the 28 crosses derive from
@@ -208,8 +237,24 @@ function FxMatrixPane({ focused, width, height }: PaneProps) {
208
237
  intervalMs: allLegsLive ? null : FX_FALLBACK_REFRESH_MS,
209
238
  });
210
239
 
240
+ // The amount in each row's currency, at the cross the row reads against the amount's currency.
241
+ const convertedAmount = useCallback((row: string): number | null => {
242
+ if (!amount) return null;
243
+ if (row === amount.currency) return amount.amount;
244
+ const from = rates.get(amount.currency);
245
+ const to = rates.get(row);
246
+ if (from == null || to == null || !Number.isFinite(from) || !Number.isFinite(to) || from <= 0 || to <= 0) return null;
247
+ return amount.amount * (from / to);
248
+ }, [amount, rates]);
249
+ // As wide as its widest figure, so a pane scrolls to the rates beside it instead of cutting one. The field
250
+ // above says what amount it is.
251
+ const amountWidth = amount ? Math.max(RATE_COLUMN_WIDTH, ...currencies.map((currency) => {
252
+ const value = convertedAmount(currency);
253
+ return value == null ? 1 : formatAmountFigure(value, currency).length;
254
+ })) : 0;
211
255
  const allColumns = useMemo<DataTableColumn[]>(() => [
212
256
  { id: "base", label: "", width: flagged ? FLAGGED_BASE_COLUMN_WIDTH : BASE_COLUMN_WIDTH, align: "left" },
257
+ ...amount ? [{ id: "amount", label: "Amount", width: amountWidth, align: "right" as const }] : [],
213
258
  ...currencies.map((currency) => ({
214
259
  id: currency,
215
260
  label: currency,
@@ -217,11 +262,7 @@ function FxMatrixPane({ focused, width, height }: PaneProps) {
217
262
  align: "right" as const,
218
263
  headerLeading: flagged ? CURRENCY_FLAGS.get(currency) : undefined,
219
264
  })),
220
- ], [currencies, flagged]);
221
- // A pane too narrow for every currency drops whole columns from the right, never cutting a rate at its edge, and
222
- // the footer says how many (a capture keeps it): each one's rates still read along its row. The first stays.
223
- const columns = useMemo(() => fxMatrixColumnsToFit(allColumns, currencies, width, height), [allColumns, currencies, height, width]);
224
- const hiddenCurrencies = currencies.length - (columns.length - 1);
265
+ ], [amount != null, amountWidth, currencies, flagged]);
225
266
 
226
267
  const renderCell = useCallback((
227
268
  row: FxCurrency,
@@ -238,8 +279,14 @@ function FxMatrixPane({ focused, width, height }: PaneProps) {
238
279
  };
239
280
  }
240
281
 
282
+ if (column.id === "amount") {
283
+ const value = convertedAmount(row);
284
+ if (value == null) return { text: status.loading > 0 ? "…" : "—", color: colors.textDim };
285
+ return { text: formatAmountFigure(value, row), value, color: row === amount?.currency ? colors.textDim : colors.text };
286
+ }
287
+
241
288
  const quoteCurrency = column.id as FxCurrency;
242
- if (row === quoteCurrency) return { text: formatRate(1), color: colors.textDim };
289
+ if (row === quoteCurrency) return { text: formatRate(1, quoteCurrency), color: colors.textDim };
243
290
 
244
291
  const base = rates.get(row);
245
292
  const quote = rates.get(quoteCurrency);
@@ -263,21 +310,46 @@ function FxMatrixPane({ focused, width, height }: PaneProps) {
263
310
  const backgroundColor = rowState.selected
264
311
  ? directionTint(level, { background: colors.selected, text: colors.selectedText })
265
312
  : directionTint(level, { background: colors.bg, text: colors.text });
266
- return { text: formatRate(base / quote, reference), color: colors.text, backgroundColor };
267
- }, [directionReferences, flagged, rates, referenceRates, status.loading]);
313
+ return { text: formatRate(base / quote, quoteCurrency, reference), color: colors.text, backgroundColor };
314
+ }, [amount?.currency, convertedAmount, directionReferences, flagged, rates, referenceRates, status.loading]);
268
315
 
269
316
  const handleKeyDown = useCallback((event: DataTableKeyEvent) => handleRefreshKey(event, refresh), [refresh]);
270
317
 
271
318
  const updatedAgo = useUpdatedAgo(status.latestFetchedAt || null);
272
319
 
273
320
  usePaneFooter(FX_MATRIX_PANE_ID, () => {
274
- const info: PaneFooterSegment[] = hiddenCurrencies > 0 ? [fxHiddenColumnsSegment(currencies.slice(columns.length - 1))] : [];
321
+ const info: PaneFooterSegment[] = [];
322
+ // An amount the board cannot read: the one typed, else the one saved.
323
+ const unreadAmount = amountError ?? (typedAmount && "error" in typedAmount ? typedAmount.error : null);
324
+ if (unreadAmount) info.push({ id: "amount", parts: [{ text: unreadAmount, tone: "warning" }] });
275
325
  if (status.loading > 0) info.push({ id: "loading", parts: [{ text: "loading", tone: "muted" }] });
276
326
  if (statusText) info.push({ id: "rates", parts: [{ text: statusText, tone: status.stale || status.unknownTime || status.unavailable ? "warning" : "muted" }] });
327
+ // Every cross is read through each currency's dollar pair, the amount column too; `fx` reads a pair's own quote.
328
+ info.push({ id: "cross", parts: [{ text: "via USD", tone: "muted" }] });
277
329
  if (savedAt != null) info.push(savedCopyFooterSegment("updated", savedAt));
278
330
  else if (updatedAgo) info.push(ageFooterSegment(updatedAgo, { verb: "fetched" }));
279
331
  return { info };
280
- }, [columns.length, currencies, hiddenCurrencies, savedAt, status.loading, statusText, updatedAgo]);
332
+ }, [amountError, savedAt, status.loading, statusText, typedAmount, updatedAgo]);
333
+
334
+ const queryBar = (
335
+ <QueryBar
336
+ width={width}
337
+ filters={[{
338
+ // Read as an example, not a value, even where a narrow pane cuts it.
339
+ id: "amount", kind: "text", label: "Amount", value: amountField.draft, placeholder: "e.g. 2,500,000 EUR",
340
+ width: AMOUNT_FIELD_WIDTH, debounceMs: 0, focused, active: amountField.active, inputRef: amountField.inputRef,
341
+ // An amount the board could not read stays in the footer, the field back on the board's, until the next edit.
342
+ onActiveChange: amountField.setActive,
343
+ // Typing edits the draft and Enter applies it; clearing the chip (outside the field) clears the amount.
344
+ onChange: (value: string) => {
345
+ amountField.setDraft(value);
346
+ if (amountField.active) setAmountError(null);
347
+ else if (!value.trim() && savedAmount) applyAmount("");
348
+ },
349
+ onSubmit: applyAmount,
350
+ }]}
351
+ />
352
+ );
281
353
 
282
354
  return (
283
355
  <DataTableView<FxCurrency>
@@ -290,11 +362,14 @@ function FxMatrixPane({ focused, width, height }: PaneProps) {
290
362
  }}
291
363
  rootWidth={width}
292
364
  rootHeight={height}
293
- columns={columns}
365
+ rootBefore={queryBar}
366
+ // A new amount brings its column, the first after the codes, into view.
367
+ resetScrollKey={amount ? storedFxBoardAmount(amount) : ""}
368
+ // A pane too narrow for every currency scrolls to the rest, as other wide tables do; the row's code stays.
369
+ columns={allColumns}
294
370
  freezeFirstColumn
295
371
  getExportMetadata={() => createFxExportMetadata(currencies, rates,
296
372
  (currency) => rateEntries.get(currency))}
297
- // An export carries every currency, the columns a narrow pane leaves out too.
298
373
  exportCsv={() => createDataTableCsv({ columns: allColumns, items: dataProvider ? currencies : [], renderCell,
299
374
  getExportMetadata: () => createFxExportMetadata(currencies, rates, (currency) => rateEntries.get(currency)) })}
300
375
  items={dataProvider ? currencies : []}
@@ -309,7 +384,83 @@ function FxMatrixPane({ focused, width, height }: PaneProps) {
309
384
  );
310
385
  }
311
386
 
387
+ /** The board an amount opens on: the focused one, else the one in front, else none and a new one opens. */
388
+ function openFxBoard(context: PaneTemplateContext) {
389
+ const boards = context.layout.instances.filter((instance) => (
390
+ instance.paneId === FX_MATRIX_PANE_ID && isPaneInLayout(context.layout, instance.instanceId)
391
+ ));
392
+ const focused = boards.find((instance) => instance.instanceId === context.focusedPaneId);
393
+ if (focused) return focused;
394
+ // A floating pane without a stacking order sits at the default of 50; docked panes sit below every one.
395
+ const zIndexOf = (instanceId: string) => {
396
+ const entry = context.layout.floating.find((floating) => floating.instanceId === instanceId);
397
+ return entry ? entry.zIndex ?? 50 : -1;
398
+ };
399
+ return [...boards].sort((left, right) => zIndexOf(right.instanceId) - zIndexOf(left.instanceId))[0] ?? null;
400
+ }
401
+
402
+ /**
403
+ * `FXC 2,500,000 EUR`, `fx 2500000 EUR/USD`, `convert 100 eur to usd`: the
404
+ * board open already takes the amount (one board, switched in place), with
405
+ * the currencies it names added when it does not list them; with none open a
406
+ * board opens on it. Without an amount the board opens as it is.
407
+ */
408
+ function createFxBoardInstance(context: PaneTemplateContext, options?: PaneTemplateCreateOptions): PaneTemplateInstanceConfig {
409
+ const request = parseFxBoardAmount(options?.arg ?? "");
410
+ if (!request || "error" in request) return {};
411
+ const open = openFxBoard(context);
412
+ return {
413
+ ...(open ? { instanceId: open.instanceId } : {}),
414
+ settings: {
415
+ amount: storedFxBoardAmount(request),
416
+ currencies: withAmountCurrencies(resolveCurrencies(open?.settings?.currencies), request),
417
+ },
418
+ };
419
+ }
420
+
421
+ /** The words a conversion is asked with in the command bar: `fx 2500000 EUR/USD`, `convert 100 eur to usd`. */
422
+ const CONVERT_WORDS = /^(?:fx|convert|converter|conversion)\s+(.+)$/i;
423
+ /** The converter asked for by name, with no amount yet. */
424
+ const CONVERTER_WORDS = /^(?:convert|converter|currency converter)$/i;
425
+
426
+ /**
427
+ * The command bar's conversions: `fx 2500000 EUR/USD`, `convert 100 eur to
428
+ * usd` and `converter 2,500,000 EUR` open the board on the amount (FXC takes
429
+ * it as its argument too), and `convert` or `converter` alone opens the
430
+ * board to type one. Only a figure is an amount: `fx EUR`, `fx usd/jpy`,
431
+ * `convert yen` and `fx forwards` are left to the bar's own search.
432
+ */
433
+ export function fxConvertRows(query: string, open: (options: PaneTemplateCreateOptions) => void): CommandBarResultDef[] {
434
+ if (CONVERTER_WORDS.test(query.trim())) {
435
+ return [{
436
+ id: "convert", label: t("Convert an amount"), detail: t("In every currency on FX Cross Rates"), right: "FXC",
437
+ keywords: ["fx", "convert", "converter"], execute: () => open({}),
438
+ }];
439
+ }
440
+ const arg = CONVERT_WORDS.exec(query.trim())?.[1];
441
+ const request = arg && /\d/.test(arg) ? parseFxBoardAmount(arg) : null;
442
+ if (!arg || !request || "error" in request) return [];
443
+ const amount = formatFxBoardAmount(request);
444
+ return [{
445
+ id: `convert:${amount}`,
446
+ label: request.to ? tf("Convert {amount} to {currency}", { amount, currency: request.to }) : tf("Convert {amount}", { amount }),
447
+ detail: t("In every currency on FX Cross Rates"),
448
+ right: "FXC",
449
+ keywords: ["fx", "convert", "converter"],
450
+ execute: () => open({ arg }),
451
+ }];
452
+ }
453
+
454
+ function createFxConvertSearchProvider(ctx: Pick<GloomPluginContext, "createPaneFromTemplate">): CommandBarSearchProvider {
455
+ const match = (query: string) => fxConvertRows(query, (options) => ctx.createPaneFromTemplate(FX_MATRIX_TEMPLATE_ID, options));
456
+ return { id: "fx-convert", category: "Convert", minQueryLength: 0, match, provide: async (query) => match(query) };
457
+ }
458
+
312
459
  export const fxMatrixModule: PluginModule = {
460
+ setup(ctx) {
461
+ ctx.registerCommandBarSearchProvider(createFxConvertSearchProvider(ctx));
462
+ },
463
+
313
464
  panes: [
314
465
  {
315
466
  id: FX_MATRIX_PANE_ID,
@@ -326,12 +477,24 @@ export const fxMatrixModule: PluginModule = {
326
477
 
327
478
  paneTemplates: [
328
479
  {
329
- id: "fx-matrix-pane",
480
+ id: FX_MATRIX_TEMPLATE_ID,
330
481
  paneId: FX_MATRIX_PANE_ID,
331
482
  label: "FX Cross Rates",
332
- description: "Currency cross-rate matrix for major FX pairs.",
333
- keywords: ["fx", "forex", "currency", "exchange", "rates", "cross", "matrix"],
334
- shortcut: { prefix: "FXC" },
483
+ description: "Currency cross-rate matrix for major FX pairs, and an amount converted into each currency.",
484
+ keywords: ["fx", "forex", "currency", "exchange", "rates", "cross", "matrix", "convert", "converter", "conversion", "calculator"],
485
+ // `FXC 2,500,000 EUR` opens the board on the amount, as `fx 2500000 EUR/USD` converts it (fxConvertRows).
486
+ shortcut: {
487
+ prefix: "FXC",
488
+ argKind: "text",
489
+ argPlaceholder: "amount",
490
+ argOptional: true,
491
+ openWithoutArg: true,
492
+ argError: (arg) => {
493
+ const request = parseFxBoardAmount(arg);
494
+ return request && "error" in request ? { message: `${arg.trim()} is no amount to convert`, detail: request.error.replace(/\.$/, "") } : null;
495
+ },
496
+ },
497
+ createInstance: createFxBoardInstance,
335
498
  headless: fxMatrixHeadless,
336
499
  },
337
500
  ],
@@ -1,3 +1,4 @@
1
+ import { fxRateDigits } from "../../../utils/currency-pair";
1
2
  import { WORD_CURRENCY_CODES } from "../../../utils/currency-names";
2
3
 
3
4
  /** The default board, in its default order. */
@@ -62,17 +63,18 @@ export const CURRENCY_SETS: readonly { id: string; label: string; currencies: re
62
63
  ];
63
64
 
64
65
  /**
65
- * Decimals follow the rate's size, counted at `referenceRate` (the cross at a
66
- * rate that holds still) when there is one, so a live rate ticking across a
67
- * power of ten, such as JPY/AUD near 0.0100, keeps its decimals. From 50 up a
68
- * rate reads two decimals (149.25, 1340.50, 33000.12); below 0.1 it keeps five
69
- * significant digits, to eight decimals; everything between reads four.
66
+ * A cross at its pair's precision (`fxRateDigits`), as `fx` and `quote` print
67
+ * it: a rate in yen from 1 up to three decimals, from 1000 up to two, from 50
68
+ * up to three, from 1 up to five, and below 1 five significant digits (KRW/JPY
69
+ * 0.10712, VND/GBP 0.000030400). `currency` is the one the rate is in, the
70
+ * cross's quote currency. Decimals are counted at `referenceRate` (the cross at
71
+ * a rate that holds still) when there is one, so a live rate ticking across a
72
+ * power of ten, such as JPY/AUD near 0.0100, keeps its decimals.
70
73
  */
71
- export function formatRate(rate: number, referenceRate = rate): string {
74
+ export function formatRate(rate: number, currency: string, referenceRate = rate): string {
72
75
  if (!Number.isFinite(rate) || rate <= 0) return "—";
73
76
  const basis = Number.isFinite(referenceRate) && referenceRate > 0 ? referenceRate : rate;
74
- const decimals = basis < 0.1 ? Math.min(8, 4 - Math.floor(Math.log10(basis))) : basis >= 50 ? 2 : 4;
75
- return rate.toFixed(decimals);
77
+ return rate.toFixed(fxRateDigits(currency, basis));
76
78
  }
77
79
 
78
80
  export function isFxCurrency(code: unknown): code is FxCurrency {
@@ -1,5 +1,6 @@
1
1
  import type { PaneReportOptionDef, PaneSettingsContext, PaneSettingsDef } from "../../../types/plugin";
2
2
  import { CURRENCY_SETS, FX_CURRENCIES, MAJOR_CURRENCIES, isFxCurrency, resolveCurrencies } from "./pairs";
3
+ import { parseFxBoardAmountEdit, storedFxBoardAmount, withAmountCurrencies } from "./amount";
3
4
 
4
5
  const CUSTOM_SET = "custom";
5
6
 
@@ -33,7 +34,11 @@ export function fxMatrixSettings(context: PaneSettingsContext): PaneSettingsDef
33
34
  ));
34
35
  return {
35
36
  title: "FX Cross Rates Settings",
36
- values: { currencies, currencySet: matching?.id ?? CUSTOM_SET },
37
+ values: {
38
+ currencies,
39
+ currencySet: matching?.id ?? CUSTOM_SET,
40
+ ...(typeof context.settings.amount === "string" ? { amount: context.settings.amount } : {}),
41
+ },
37
42
  fields: [
38
43
  {
39
44
  key: "currencySet",
@@ -51,8 +56,24 @@ export function fxMatrixSettings(context: PaneSettingsContext): PaneSettingsDef
51
56
  searchable: true,
52
57
  options: FX_CURRENCIES.map((code) => ({ value: code, label: code, description: currencyName(code) ?? undefined })),
53
58
  },
59
+ {
60
+ key: "amount",
61
+ label: "Amount",
62
+ type: "text",
63
+ placeholder: "2,500,000 EUR",
64
+ description: "Shown in every listed currency at the board's rates. Empty for none.",
65
+ },
54
66
  ],
55
67
  applyValue: (settings, field, value) => {
68
+ if (field.key === "amount") {
69
+ // Saved ungrouped (`storedFxBoardAmount`), so it reads back as itself; shown grouped on the board.
70
+ const request = parseFxBoardAmountEdit(String(value ?? ""), settings.amount);
71
+ if (request && "error" in request) throw new Error(request.error);
72
+ const { amount: _cleared, ...rest } = settings;
73
+ return request
74
+ ? { ...rest, amount: storedFxBoardAmount(request), currencies: withAmountCurrencies(resolveCurrencies(settings.currencies), request) }
75
+ : rest;
76
+ }
56
77
  if (field.key !== "currencySet") return { ...settings, [field.key]: value };
57
78
  // The set is a way to fill the list, never a setting of its own.
58
79
  const { currencySet: _unused, ...rest } = settings;