gloomberb 0.20.1 → 0.20.3

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (675) hide show
  1. package/README.md +16 -26
  2. package/README.zh-CN.md +21 -65
  3. package/package.json +2 -1
  4. package/src/account/auth-form.tsx +13 -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/central-bank-rates.ts +5 -0
  11. package/src/api-client/company-kpis.ts +2 -1
  12. package/src/api-client/cot.ts +14 -2
  13. package/src/api-client/data.ts +20 -6
  14. package/src/api-client/debt-maturities.ts +45 -2
  15. package/src/api-client/earnings.ts +50 -5
  16. package/src/api-client/errors.ts +21 -11
  17. package/src/api-client/futures-curve.ts +17 -0
  18. package/src/api-client/index.ts +5 -1
  19. package/src/api-client/one-tap-reasons.ts +42 -0
  20. package/src/api-client/paths.ts +9 -1
  21. package/src/api-client/perps.ts +2 -1
  22. package/src/api-client/request.ts +3 -1
  23. package/src/api-client/research-activity.ts +16 -3
  24. package/src/api-client/social-mentions.ts +47 -0
  25. package/src/api-client/types/econ.ts +4 -0
  26. package/src/api-client/types/filings-and-calls.ts +3 -0
  27. package/src/api-client/types/search.ts +3 -0
  28. package/src/app/keybindings/chord.ts +153 -9
  29. package/src/app/keybindings/index.ts +1 -1
  30. package/src/app/keybindings/labels.ts +49 -6
  31. package/src/app/runtime/desktop-deeplink.ts +73 -8
  32. package/src/app.tsx +18 -2
  33. package/src/architecture/core-builtin-allowlist.json +1 -2
  34. package/src/architecture/pane-tabs-allowlist.json +2 -1
  35. package/src/architecture/shortcut-labels-allowlist.json +11 -0
  36. package/src/architecture/ui-literals-allowlist.json +8 -8
  37. package/src/brokers/broker-portfolio-sync.ts +1 -1
  38. package/src/cli/bank-section.ts +26 -12
  39. package/src/cli/command-options.ts +2 -1
  40. package/src/cli/commands/market.ts +372 -99
  41. package/src/cli/commands/options-chain.ts +23 -6
  42. package/src/cli/commands/overview.ts +13 -5
  43. package/src/cli/commands/plugins.ts +49 -18
  44. package/src/cli/commands/search.ts +25 -6
  45. package/src/cli/commands/ticker.ts +16 -9
  46. package/src/cli/desktop-pane-shot-browser.ts +47 -31
  47. package/src/cli/desktop-pane-shot.ts +15 -0
  48. package/src/cli/entry.ts +5 -0
  49. package/src/cli/export-source.ts +7 -1
  50. package/src/cli/freshness.ts +0 -16
  51. package/src/cli/fx-pair.ts +64 -12
  52. package/src/cli/fx-quote-rate.ts +192 -0
  53. package/src/cli/glossary.ts +100 -15
  54. package/src/cli/history-back-adjust.ts +122 -0
  55. package/src/cli/history-rows.ts +122 -34
  56. package/src/cli/index.ts +6 -35
  57. package/src/cli/known-gaps.ts +48 -6
  58. package/src/cli/listing-arg.ts +125 -21
  59. package/src/cli/name-entries.ts +26 -5
  60. package/src/cli/not-a-ticker.ts +6 -2
  61. package/src/cli/pane-functions/capabilities.ts +12 -1
  62. package/src/cli/pane-functions/catalog.ts +12 -2
  63. package/src/cli/pane-functions/dom.ts +4 -2
  64. package/src/cli/pane-functions/function-help.ts +23 -11
  65. package/src/cli/pane-functions/headless.ts +11 -6
  66. package/src/cli/pane-functions/index.ts +35 -4
  67. package/src/cli/pane-functions/market-session.ts +8 -3
  68. package/src/cli/pane-functions/resolver.ts +22 -12
  69. package/src/cli/pane-functions/screenshot-assessment.ts +15 -3
  70. package/src/cli/pane-functions/screenshot-payload.ts +166 -72
  71. package/src/cli/pane-functions/screenshot-render.ts +18 -2
  72. package/src/cli/pane-functions/screenshot-types.ts +4 -0
  73. package/src/cli/quote-answer.ts +10 -0
  74. package/src/cli/report-tables.ts +22 -2
  75. package/src/cli/result.ts +7 -3
  76. package/src/cli/spreadsheet-hint.ts +43 -0
  77. package/src/cli/symbol-list.ts +58 -4
  78. package/src/cli/symbol-rows.ts +71 -4
  79. package/src/cli/ticker-resolution.ts +171 -21
  80. package/src/cli/unknown-command.ts +88 -0
  81. package/src/components/chart/composite/axis-overlays.tsx +13 -3
  82. package/src/components/chart/composite/composite-chart.tsx +8 -1
  83. package/src/components/chart/composite/format.ts +16 -1
  84. package/src/components/chart/composite/legend.tsx +4 -3
  85. package/src/components/chart/composite/panel-labels.ts +2 -1
  86. package/src/components/chart/composite/panel-surface.tsx +33 -4
  87. package/src/components/chart/composite/time-scale.ts +1 -1
  88. package/src/components/chart/composite/toolbar.tsx +8 -4
  89. package/src/components/chart/composite/types.ts +17 -1
  90. package/src/components/chart/composite/use-composite-chart-keyboard.ts +15 -5
  91. package/src/components/chart/composite/use-composite-viewport.ts +31 -8
  92. package/src/components/chart/static/scatter-chart-surface.tsx +25 -9
  93. package/src/components/chart-table/axis.ts +11 -0
  94. package/src/components/command-bar/assist/inventory.ts +3 -2
  95. package/src/components/command-bar/assist/model.ts +6 -1
  96. package/src/components/command-bar/commands/collection-list.ts +3 -2
  97. package/src/components/command-bar/commands/direct/index.ts +9 -1
  98. package/src/components/command-bar/commands/registry.ts +18 -0
  99. package/src/components/command-bar/pane-actions.ts +30 -13
  100. package/src/components/command-bar/panel/index.tsx +6 -3
  101. package/src/components/command-bar/panel/layout.ts +8 -1
  102. package/src/components/command-bar/panel/prompt-binding.ts +4 -0
  103. package/src/components/command-bar/panel/prompt-width.ts +34 -0
  104. package/src/components/command-bar/panel/state.ts +4 -0
  105. package/src/components/command-bar/panel/types.ts +3 -0
  106. package/src/components/command-bar/routes/header-market.ts +108 -0
  107. package/src/components/command-bar/routes/root/command-items.ts +5 -0
  108. package/src/components/command-bar/routes/root/provider-search.ts +190 -32
  109. package/src/components/command-bar/routes/root/results.ts +3 -0
  110. package/src/components/command-bar/routes/root/runtime.ts +28 -5
  111. package/src/components/command-bar/routes/root/search-providers.ts +3 -2
  112. package/src/components/command-bar/routes/root/search-report.ts +2 -2
  113. package/src/components/command-bar/routes/ticker-search/results.ts +53 -6
  114. package/src/components/command-bar/routing/list-state.ts +38 -0
  115. package/src/components/command-bar/selection-hint.ts +28 -0
  116. package/src/components/command-bar/surface/index.tsx +41 -3
  117. package/src/components/command-bar/view-model.ts +15 -0
  118. package/src/components/command-bar/workflow/ticker-listing-picker.ts +1 -0
  119. package/src/components/command-bar/workflow/tickers.ts +3 -2
  120. package/src/components/company-logo.tsx +22 -4
  121. package/src/components/data-table/export.ts +13 -8
  122. package/src/components/data-table/view.tsx +11 -2
  123. package/src/components/feed-data-table/stack-view.tsx +20 -6
  124. package/src/components/feedback-dialog.tsx +5 -2
  125. package/src/components/form-modal/field-row.tsx +3 -2
  126. package/src/components/form-modal/routes.ts +1 -0
  127. package/src/components/index.ts +1 -1
  128. package/src/components/input-search-bar.tsx +2 -2
  129. package/src/components/layout/double-escape-close.ts +8 -5
  130. package/src/components/layout/header.tsx +87 -47
  131. package/src/components/layout/market-summary.ts +323 -116
  132. package/src/components/layout/pane/footer/index.tsx +31 -9
  133. package/src/components/layout/pane/footer/model.ts +63 -21
  134. package/src/components/layout/pane/footer/registration.tsx +60 -1
  135. package/src/components/layout/pane/header-tabs.tsx +17 -3
  136. package/src/components/layout/pane/header.tsx +8 -4
  137. package/src/components/layout/pane/pane-tabs.tsx +57 -3
  138. package/src/components/layout/shell/active-drag.ts +38 -30
  139. package/src/components/layout/shell/chrome.ts +15 -15
  140. package/src/components/layout/shell/drag/index.ts +51 -21
  141. package/src/components/layout/shell/menu.ts +3 -5
  142. package/src/components/layout/shell/pane/actions.ts +4 -1
  143. package/src/components/layout/shell/pane/ask.ts +5 -2
  144. package/src/components/layout/status-bar.tsx +63 -57
  145. package/src/components/layout/status-widget-space.ts +8 -0
  146. package/src/components/markdown-editor.tsx +2 -2
  147. package/src/components/markdown-text.tsx +35 -10
  148. package/src/components/onboarding/account-step/form-panel.tsx +0 -3
  149. package/src/components/onboarding/first-run-workspace.ts +25 -23
  150. package/src/components/onboarding/onboarding-keyboard.ts +21 -7
  151. package/src/components/onboarding/onboarding-wizard.tsx +73 -13
  152. package/src/components/onboarding/portfolio-step/broker-fields-panel.tsx +0 -1
  153. package/src/components/onboarding/portfolio-step/positions-panel.tsx +3 -5
  154. package/src/components/onboarding/use-onboarding-broker-form.ts +2 -1
  155. package/src/components/onboarding/use-onboarding-progress.ts +11 -4
  156. package/src/components/onboarding/use-onboarding-upgrade.ts +3 -2
  157. package/src/components/onboarding/wizard-positions.ts +8 -1
  158. package/src/components/pane-notice-seen.ts +125 -0
  159. package/src/components/pane-settings-dialog/field-dialogs.tsx +2 -1
  160. package/src/components/pane-settings-dialog.tsx +7 -6
  161. package/src/components/price-sparkline/model.ts +26 -10
  162. package/src/components/sign-in-code-panel.tsx +3 -2
  163. package/src/components/speedometer-gauge/terminal.tsx +30 -9
  164. package/src/components/ticker/list-table-view.tsx +68 -7
  165. package/src/components/ui/button.tsx +13 -2
  166. package/src/components/ui/column-grid.tsx +18 -9
  167. package/src/components/ui/confirm-dialog.tsx +2 -1
  168. package/src/components/ui/data-table/index.tsx +5 -3
  169. package/src/components/ui/data-table/opentui/index.tsx +17 -6
  170. package/src/components/ui/data-table/types.ts +26 -0
  171. package/src/components/ui/delayed-mark.tsx +3 -2
  172. package/src/components/ui/external-link.tsx +4 -1
  173. package/src/components/ui/field-grid.tsx +1 -3
  174. package/src/components/ui/fields.tsx +7 -4
  175. package/src/components/ui/index.ts +2 -0
  176. package/src/components/ui/inline-quick-add.tsx +7 -2
  177. package/src/components/ui/key-hint-words.ts +153 -0
  178. package/src/components/ui/key-hints.tsx +73 -0
  179. package/src/components/ui/menu.tsx +3 -1
  180. package/src/components/ui/message-composer.tsx +2 -2
  181. package/src/components/ui/multi-select/dialog.tsx +10 -9
  182. package/src/components/ui/pane-link-chip.tsx +354 -0
  183. package/src/components/ui/query-bar.tsx +22 -13
  184. package/src/components/ui/ratio-bar.tsx +24 -1
  185. package/src/components/ui/select-button.tsx +2 -1
  186. package/src/components/ui/shortcut-hint.tsx +32 -4
  187. package/src/components/ui/table-layout.ts +81 -0
  188. package/src/components/ui/tabs.tsx +52 -6
  189. package/src/components/ui/text-prompt-dialog.tsx +2 -1
  190. package/src/components/use-pane-notice-footer.tsx +12 -4
  191. package/src/core/app-service-ports.ts +1 -1
  192. package/src/core/state/app/command-bar-launch.ts +3 -0
  193. package/src/data/config/store/normalize.ts +6 -0
  194. package/src/data/plugin-state-store.ts +44 -8
  195. package/src/docs/snapshot.json +172 -100
  196. package/src/i18n/es.ts +48 -6
  197. package/src/i18n/ja.ts +48 -5
  198. package/src/i18n/ko.ts +48 -5
  199. package/src/i18n/zh-cn.ts +48 -5
  200. package/src/i18n/zh-tw.ts +48 -5
  201. package/src/layout/pane-manager/gridlock-inference.ts +2 -1
  202. package/src/layout/pane-manager/gridlock.ts +58 -2
  203. package/src/layout-marketplace/api.ts +1 -0
  204. package/src/layout-marketplace/gallery.tsx +4 -3
  205. package/src/layout-marketplace/linked.ts +6 -4
  206. package/src/layout-marketplace/model.ts +3 -2
  207. package/src/market-data/bars-per-year.ts +27 -9
  208. package/src/market-data/coordinator/quotes.ts +22 -3
  209. package/src/market-data/futures-board.ts +80 -0
  210. package/src/market-data/futures-contract.ts +86 -34
  211. package/src/market-data/fx-closes.ts +5 -2
  212. package/src/market-data/hooks.tsx +23 -0
  213. package/src/market-data/market/change-basis.ts +74 -16
  214. package/src/market-data/market/dated-previous-close.ts +163 -47
  215. package/src/market-data/market/format.ts +33 -14
  216. package/src/market-data/market/freshness.ts +24 -7
  217. package/src/market-data/market/globex-day.ts +73 -0
  218. package/src/market-data/market/header-market.ts +154 -0
  219. package/src/market-data/market/index-level.ts +39 -1
  220. package/src/market-data/market/index-session-venues.ts +44 -0
  221. package/src/market-data/market/status.ts +7 -2
  222. package/src/market-data/market/venue-session.ts +72 -0
  223. package/src/market-data/model-dividend-yield.ts +23 -8
  224. package/src/market-data/options-alternatives.ts +39 -4
  225. package/src/market-data/published-apac-sessions.ts +40 -2
  226. package/src/market-data/quotes/export-identity.ts +76 -0
  227. package/src/market-data/quotes/freshness.ts +22 -0
  228. package/src/market-data/quotes/intraday-bar.ts +1 -1
  229. package/src/market-data/quotes/session-split.ts +28 -0
  230. package/src/market-data/quotes/time.ts +42 -1
  231. package/src/market-data/realized-volatility.ts +11 -7
  232. package/src/market-data/tax-equivalent.ts +145 -27
  233. package/src/plugins/builtin/account-management/pane.tsx +3 -3
  234. package/src/plugins/builtin/alerts/alert-engine.ts +12 -6
  235. package/src/plugins/builtin/alerts/alert-log.ts +6 -2
  236. package/src/plugins/builtin/alerts/calendar-events.ts +74 -12
  237. package/src/plugins/builtin/alerts/cli-forms.ts +11 -1
  238. package/src/plugins/builtin/alerts/cli-move.ts +234 -0
  239. package/src/plugins/builtin/alerts/cli.ts +224 -33
  240. package/src/plugins/builtin/alerts/command.ts +33 -6
  241. package/src/plugins/builtin/alerts/event-rows.ts +18 -4
  242. package/src/plugins/builtin/alerts/events-pane.tsx +6 -2
  243. package/src/plugins/builtin/alerts/events.ts +9 -0
  244. package/src/plugins/builtin/alerts/format.ts +40 -15
  245. package/src/plugins/builtin/alerts/headless.ts +31 -18
  246. package/src/plugins/builtin/alerts/history.ts +1 -0
  247. package/src/plugins/builtin/alerts/index.tsx +86 -12
  248. package/src/plugins/builtin/alerts/live.ts +2 -1
  249. package/src/plugins/builtin/alerts/move-checks.ts +155 -0
  250. package/src/plugins/builtin/alerts/move.ts +160 -0
  251. package/src/plugins/builtin/alerts/pane.tsx +52 -22
  252. package/src/plugins/builtin/alerts/price-text.ts +62 -0
  253. package/src/plugins/builtin/alerts/price.ts +17 -0
  254. package/src/plugins/builtin/alerts/quotes.ts +84 -3
  255. package/src/plugins/builtin/alerts/scheduled-check.ts +7 -1
  256. package/src/plugins/builtin/alerts/storage.ts +20 -7
  257. package/src/plugins/builtin/alerts/types.ts +13 -0
  258. package/src/plugins/builtin/analytics/account-returns.ts +1 -1
  259. package/src/plugins/builtin/analytics/index.tsx +10 -3
  260. package/src/plugins/builtin/analytics/pane-model.ts +1 -1
  261. package/src/plugins/builtin/analytics/risk-client.ts +64 -40
  262. package/src/plugins/builtin/analytics/risk-episodes.ts +440 -0
  263. package/src/plugins/builtin/analytics/risk-fx.ts +1 -1
  264. package/src/plugins/builtin/analytics/risk-headless.ts +44 -10
  265. package/src/plugins/builtin/analytics/risk-math.ts +1 -1
  266. package/src/plugins/builtin/analytics/risk-model.ts +183 -27
  267. package/src/plugins/builtin/analytics/risk-pane.tsx +216 -26
  268. package/src/plugins/builtin/analytics/sharpe-cadence.ts +1 -1
  269. package/src/plugins/builtin/backtest/engine.ts +4 -2
  270. package/src/plugins/builtin/backtest/format.ts +14 -0
  271. package/src/plugins/builtin/backtest/pane.tsx +3 -3
  272. package/src/plugins/builtin/backtest/report.ts +5 -3
  273. package/src/plugins/builtin/backtest/window.ts +3 -1
  274. package/src/plugins/builtin/broker-manager/add-request.ts +10 -1
  275. package/src/plugins/builtin/broker-manager/sign-in-end.ts +1 -1
  276. package/src/plugins/builtin/broker-trading/pane.tsx +20 -2
  277. package/src/plugins/builtin/buildout/company/flow.tsx +5 -5
  278. package/src/plugins/builtin/buildout/company/model.ts +14 -2
  279. package/src/plugins/builtin/catalysts/detail.tsx +2 -2
  280. package/src/plugins/builtin/catalysts/model.ts +7 -2
  281. package/src/plugins/builtin/catalysts/pane.tsx +2 -2
  282. package/src/plugins/builtin/central-bank-rates/client.ts +4 -0
  283. package/src/plugins/builtin/central-bank-rates/headless.ts +1 -1
  284. package/src/plugins/builtin/central-bank-rates/model.ts +18 -8
  285. package/src/plugins/builtin/central-bank-rates/pane.tsx +6 -3
  286. package/src/plugins/builtin/chart-composer/cli-options.ts +5 -0
  287. package/src/plugins/builtin/chart-composer/headless-schema.ts +17 -1
  288. package/src/plugins/builtin/chart-composer/headless.ts +2 -0
  289. package/src/plugins/builtin/chat/message/pane-chip.tsx +36 -208
  290. package/src/plugins/builtin/cloud/askg/answer-follow-ups.tsx +61 -0
  291. package/src/plugins/builtin/cloud/askg/answer-sources.tsx +102 -0
  292. package/src/plugins/builtin/cloud/askg/controller.ts +7 -1
  293. package/src/plugins/builtin/cloud/askg/host.ts +57 -0
  294. package/src/plugins/builtin/cloud/askg/model.ts +45 -5
  295. package/src/plugins/builtin/cloud/askg/pane.tsx +304 -25
  296. package/src/plugins/builtin/cloud/askg/protocol.ts +26 -1
  297. package/src/plugins/builtin/cloud/askg/sources.ts +466 -0
  298. package/src/plugins/builtin/cloud/one-tap/controller.ts +309 -0
  299. package/src/plugins/builtin/cloud/one-tap/google-identity.ts +142 -0
  300. package/src/plugins/builtin/cloud/one-tap/one-tap-prompt.tsx +101 -0
  301. package/src/plugins/builtin/cloud/plugin.tsx +7 -1
  302. package/src/plugins/builtin/cloud/upgrade-status-widget.tsx +9 -2
  303. package/src/plugins/builtin/company-kpis/client.ts +4 -3
  304. package/src/plugins/builtin/company-kpis/model.ts +34 -3
  305. package/src/plugins/builtin/correlation/index.tsx +39 -167
  306. package/src/plugins/builtin/correlation/matrix/grid.tsx +285 -0
  307. package/src/plugins/builtin/correlation/relationship/pane.tsx +6 -7
  308. package/src/plugins/builtin/correlation/relationship/view-model.ts +14 -5
  309. package/src/plugins/builtin/cot/client.ts +8 -3
  310. package/src/plugins/builtin/cot/headless.ts +65 -12
  311. package/src/plugins/builtin/cot/pane.tsx +11 -5
  312. package/src/plugins/builtin/crypto-board/headless.ts +82 -17
  313. package/src/plugins/builtin/crypto-board/index.tsx +24 -2
  314. package/src/plugins/builtin/crypto-board/model.ts +5 -2
  315. package/src/plugins/builtin/crypto-board/pane.tsx +4 -1
  316. package/src/plugins/builtin/debt-maturities/client.ts +111 -6
  317. package/src/plugins/builtin/debt-maturities/headless.ts +84 -1
  318. package/src/plugins/builtin/debt-maturities/model.ts +97 -14
  319. package/src/plugins/builtin/debt-maturities/pane.tsx +165 -15
  320. package/src/plugins/builtin/debt-maturities/series.ts +3 -1
  321. package/src/plugins/builtin/dividend-yield/client.ts +22 -6
  322. package/src/plugins/builtin/dividend-yield/headless.ts +113 -46
  323. package/src/plugins/builtin/dividend-yield/model.ts +5 -2
  324. package/src/plugins/builtin/dividend-yield/pane.tsx +6 -3
  325. package/src/plugins/builtin/dividend-yield/ranking-reads.ts +11 -4
  326. package/src/plugins/builtin/dividend-yield/ranking.ts +113 -18
  327. package/src/plugins/builtin/dividend-yield/types.ts +2 -0
  328. package/src/plugins/builtin/dividend-yield/view.ts +3 -0
  329. package/src/plugins/builtin/earnings/client.ts +40 -6
  330. package/src/plugins/builtin/earnings/fiscal-quarter.ts +54 -0
  331. package/src/plugins/builtin/earnings/headless.ts +47 -11
  332. package/src/plugins/builtin/earnings/history-model.ts +136 -24
  333. package/src/plugins/builtin/earnings/history-table.ts +42 -10
  334. package/src/plugins/builtin/earnings/history.tsx +23 -8
  335. package/src/plugins/builtin/earnings-ripple/client.ts +5 -2
  336. package/src/plugins/builtin/earnings-ripple/headless.ts +8 -3
  337. package/src/plugins/builtin/earnings-ripple/model.ts +21 -0
  338. package/src/plugins/builtin/earnings-ripple/pane.tsx +2 -3
  339. package/src/plugins/builtin/econ/calendar-model.ts +21 -3
  340. package/src/plugins/builtin/econ/detail-view.tsx +5 -3
  341. package/src/plugins/builtin/econ/figures.ts +13 -0
  342. package/src/plugins/builtin/econ/fred-catalog.ts +6 -3
  343. package/src/plugins/builtin/econ/index.tsx +10 -7
  344. package/src/plugins/builtin/econ/types.ts +5 -0
  345. package/src/plugins/builtin/econ-statistics/stats.ts +13 -5
  346. package/src/plugins/builtin/equity-screener/footer.ts +45 -0
  347. package/src/plugins/builtin/equity-screener/headless.ts +2 -1
  348. package/src/plugins/builtin/equity-screener/pane.tsx +4 -18
  349. package/src/plugins/builtin/equity-screener/ticker-check.tsx +2 -1
  350. package/src/plugins/builtin/filing-events/feed.ts +56 -18
  351. package/src/plugins/builtin/filing-events/pane.tsx +8 -2
  352. package/src/plugins/builtin/fixed-income/model.ts +1 -0
  353. package/src/plugins/builtin/futures/index.tsx +32 -10
  354. package/src/plugins/builtin/futures/model.ts +93 -6
  355. package/src/plugins/builtin/futures/returns.ts +29 -7
  356. package/src/plugins/builtin/futures/table.tsx +59 -17
  357. package/src/plugins/builtin/futures/use-front-returns.ts +32 -6
  358. package/src/plugins/builtin/futures-curve/client.ts +12 -2
  359. package/src/plugins/builtin/futures-curve/headless.ts +58 -17
  360. package/src/plugins/builtin/futures-curve/model.ts +114 -25
  361. package/src/plugins/builtin/futures-curve/pane.tsx +11 -6
  362. package/src/plugins/builtin/fx-matrix/amount.ts +132 -0
  363. package/src/plugins/builtin/fx-matrix/headless.ts +53 -13
  364. package/src/plugins/builtin/fx-matrix/index.tsx +205 -42
  365. package/src/plugins/builtin/fx-matrix/pairs.ts +10 -8
  366. package/src/plugins/builtin/fx-matrix/settings.ts +22 -1
  367. package/src/plugins/builtin/help/function-card.tsx +2 -1
  368. package/src/plugins/builtin/help/function-index.ts +1 -0
  369. package/src/plugins/builtin/help/index.tsx +68 -61
  370. package/src/plugins/builtin/holders/format.ts +7 -2
  371. package/src/plugins/builtin/holders/pane.tsx +11 -3
  372. package/src/plugins/builtin/holders/report-header.ts +5 -4
  373. package/src/plugins/builtin/holders/report-rows.ts +4 -1
  374. package/src/plugins/builtin/holders/treemap.tsx +5 -3
  375. package/src/plugins/builtin/insider/client.ts +31 -14
  376. package/src/plugins/builtin/insider/signals-model.ts +6 -12
  377. package/src/plugins/builtin/ipo-calendar/headless.ts +18 -7
  378. package/src/plugins/builtin/ipo-calendar/listing-ipo.ts +3 -1
  379. package/src/plugins/builtin/ipo-calendar/model.ts +28 -8
  380. package/src/plugins/builtin/ipo-calendar/pane.tsx +2 -1
  381. package/src/plugins/builtin/iv-history/headless.ts +1 -2
  382. package/src/plugins/builtin/iv-history/model.ts +33 -23
  383. package/src/plugins/builtin/iv-history/screen-pane.tsx +0 -3
  384. package/src/plugins/builtin/kelly-sizer/headless.ts +68 -16
  385. package/src/plugins/builtin/kelly-sizer/history.ts +37 -28
  386. package/src/plugins/builtin/kelly-sizer/pane.tsx +43 -10
  387. package/src/plugins/builtin/kelly-sizer/sections.tsx +7 -2
  388. package/src/plugins/builtin/kelly-sizer/units.ts +29 -0
  389. package/src/plugins/builtin/news/index.tsx +7 -13
  390. package/src/plugins/builtin/news/overview-headlines.tsx +117 -0
  391. package/src/plugins/builtin/news/ticker-news.ts +35 -0
  392. package/src/plugins/builtin/news/wire/news/detail-view.tsx +8 -6
  393. package/src/plugins/builtin/news/wire/news/row.ts +49 -0
  394. package/src/plugins/builtin/news/wire/news/table.tsx +9 -20
  395. package/src/plugins/builtin/options/analytics.ts +7 -2
  396. package/src/plugins/builtin/options/live-quotes.ts +6 -1
  397. package/src/plugins/builtin/options/table.ts +3 -2
  398. package/src/plugins/builtin/options/view.tsx +11 -9
  399. package/src/plugins/builtin/options-scenario/client.ts +3 -0
  400. package/src/plugins/builtin/options-scenario/headless.ts +1 -1
  401. package/src/plugins/builtin/perps/client.ts +5 -4
  402. package/src/plugins/builtin/perps/headless.ts +189 -123
  403. package/src/plugins/builtin/perps/index.tsx +3 -1
  404. package/src/plugins/builtin/perps/markets-section.tsx +2 -2
  405. package/src/plugins/builtin/perps/model.ts +9 -5
  406. package/src/plugins/builtin/perps/open-market.ts +4 -4
  407. package/src/plugins/builtin/perps/pane.tsx +2 -0
  408. package/src/plugins/builtin/perps/venue-markets.ts +3 -6
  409. package/src/plugins/builtin/portfolio-list/cell-version.ts +2 -0
  410. package/src/plugins/builtin/portfolio-list/cli/bulk-symbols.ts +54 -11
  411. package/src/plugins/builtin/portfolio-list/cli/import-positions.ts +260 -0
  412. package/src/plugins/builtin/portfolio-list/cli/period-report.ts +180 -0
  413. package/src/plugins/builtin/portfolio-list/cli/portfolio-command.ts +68 -22
  414. package/src/plugins/builtin/portfolio-list/cli/render.ts +82 -27
  415. package/src/plugins/builtin/portfolio-list/cli/watchlist-command.ts +5 -3
  416. package/src/plugins/builtin/portfolio-list/grid.tsx +61 -15
  417. package/src/plugins/builtin/portfolio-list/headless.ts +128 -0
  418. package/src/plugins/builtin/portfolio-list/pane/data.ts +34 -1
  419. package/src/plugins/builtin/portfolio-list/pane/index.tsx +48 -4
  420. package/src/plugins/builtin/portfolio-list/pane/period-pnl.ts +124 -0
  421. package/src/plugins/builtin/portfolio-list/pane/streaming.ts +15 -6
  422. package/src/plugins/builtin/portfolio-list/period-pnl.ts +179 -0
  423. package/src/plugins/builtin/portfolio-list/positions-import/dialog.tsx +445 -0
  424. package/src/plugins/builtin/portfolio-list/positions-import/index.tsx +255 -0
  425. package/src/plugins/builtin/portfolio-list/positions-import/lookup.ts +78 -0
  426. package/src/plugins/builtin/portfolio-list/positions-import/read-file.ts +32 -0
  427. package/src/plugins/builtin/portfolio-list/quick-add/index.tsx +186 -50
  428. package/src/plugins/builtin/portfolio-list/quick-add/resolution.ts +137 -11
  429. package/src/plugins/builtin/portfolio-list/settings.ts +25 -0
  430. package/src/plugins/builtin/portfolio-list/summary/index.tsx +16 -1
  431. package/src/plugins/builtin/portfolio-list/summary/totals.ts +7 -5
  432. package/src/plugins/builtin/portfolio-list/table.tsx +134 -9
  433. package/src/plugins/builtin/power/headless.ts +47 -9
  434. package/src/plugins/builtin/realized-vol/evidence.ts +33 -6
  435. package/src/plugins/builtin/realized-vol/fx-proxy.ts +135 -0
  436. package/src/plugins/builtin/realized-vol/headless.ts +44 -8
  437. package/src/plugins/builtin/realized-vol/model.ts +9 -5
  438. package/src/plugins/builtin/realized-vol/pane.tsx +49 -15
  439. package/src/plugins/builtin/research/relative-valuation-model.ts +8 -3
  440. package/src/plugins/builtin/research-search/article.ts +12 -2
  441. package/src/plugins/builtin/research-search/data.ts +5 -2
  442. package/src/plugins/builtin/research-search/document-view.tsx +1 -1
  443. package/src/plugins/builtin/research-search/model.ts +47 -3
  444. package/src/plugins/builtin/research-search/pane.tsx +3 -2
  445. package/src/plugins/builtin/reverse-dcf/model.ts +7 -4
  446. package/src/plugins/builtin/risk-factors/headless.ts +3 -2
  447. package/src/plugins/builtin/risk-factors/pane.tsx +5 -3
  448. package/src/plugins/builtin/scanner/flow-model.ts +17 -13
  449. package/src/plugins/builtin/scanner/flow-pane.tsx +8 -9
  450. package/src/plugins/builtin/scanner/flow-session.ts +2 -9
  451. package/src/plugins/builtin/sec/filing-display.tsx +0 -5
  452. package/src/plugins/builtin/sec/forms.ts +19 -0
  453. package/src/plugins/builtin/sec/headless.ts +55 -17
  454. package/src/plugins/builtin/sec/index.tsx +17 -7
  455. package/src/plugins/builtin/sec/model.ts +4 -1
  456. package/src/plugins/builtin/shared/earnings-calendar.ts +8 -3
  457. package/src/plugins/builtin/shared/earnings-report.ts +1 -1
  458. package/src/plugins/builtin/shared/fx-rate-freshness.ts +0 -35
  459. package/src/plugins/builtin/shared/market-cap-bands.ts +12 -0
  460. package/src/plugins/builtin/shared/report-freshness.ts +3 -1
  461. package/src/plugins/builtin/shared/use-quote-board.ts +47 -30
  462. package/src/plugins/builtin/shared/volatility/options.ts +63 -2
  463. package/src/plugins/builtin/social-mentions/headless.ts +72 -3
  464. package/src/plugins/builtin/social-mentions/index.tsx +8 -4
  465. package/src/plugins/builtin/social-mentions/lock-note.ts +6 -2
  466. package/src/plugins/builtin/social-mentions/outliers-client.ts +101 -0
  467. package/src/plugins/builtin/social-mentions/outliers-model.ts +162 -0
  468. package/src/plugins/builtin/social-mentions/outliers-names.ts +51 -0
  469. package/src/plugins/builtin/social-mentions/outliers.tsx +276 -0
  470. package/src/plugins/builtin/social-mentions/pane.tsx +32 -3
  471. package/src/plugins/builtin/supply-chain/graph-model.ts +7 -1
  472. package/src/plugins/builtin/supply-chain/graph-pane.tsx +2 -2
  473. package/src/plugins/builtin/supply-chain/headless.ts +20 -10
  474. package/src/plugins/builtin/supply-chain/model.ts +117 -20
  475. package/src/plugins/builtin/supply-chain/pane.tsx +22 -15
  476. package/src/plugins/builtin/supply-chain/row-evidence.tsx +1 -1
  477. package/src/plugins/builtin/thirteenf/api.ts +36 -2
  478. package/src/plugins/builtin/thirteenf/data.ts +4 -1
  479. package/src/plugins/builtin/thirteenf/headless.ts +14 -6
  480. package/src/plugins/builtin/thirteenf/model.ts +56 -1
  481. package/src/plugins/builtin/thirteenf/pane.tsx +8 -8
  482. package/src/plugins/builtin/thirteenf/report-notes.ts +11 -0
  483. package/src/plugins/builtin/thirteenf/table.ts +2 -1
  484. package/src/plugins/builtin/thirteenf/types.ts +6 -0
  485. package/src/plugins/builtin/ticker-detail/data-panes/historical-prices.tsx +23 -3
  486. package/src/plugins/builtin/ticker-detail/data-panes/returns-chart-model.ts +69 -0
  487. package/src/plugins/builtin/ticker-detail/data-panes/returns-chart.tsx +118 -0
  488. package/src/plugins/builtin/ticker-detail/data-panes/returns-model.ts +1 -1
  489. package/src/plugins/builtin/ticker-detail/data-panes/returns-pane.tsx +103 -40
  490. package/src/plugins/builtin/ticker-detail/financials/model.ts +5 -0
  491. package/src/plugins/builtin/ticker-detail/headless-schema.ts +12 -2
  492. package/src/plugins/builtin/ticker-detail/headless.ts +21 -59
  493. package/src/plugins/builtin/ticker-detail/index.tsx +5 -0
  494. package/src/plugins/builtin/ticker-detail/overview/components.tsx +15 -2
  495. package/src/plugins/builtin/ticker-detail/overview/model.ts +10 -6
  496. package/src/plugins/builtin/ticker-detail/overview/pane.tsx +15 -0
  497. package/src/plugins/builtin/ticker-detail/overview/tax-equivalent.ts +69 -0
  498. package/src/plugins/builtin/ticker-detail/overview-tab.tsx +52 -14
  499. package/src/plugins/builtin/ticker-detail/pane.tsx +95 -20
  500. package/src/plugins/builtin/ticker-detail/quote-monitor/card.tsx +47 -24
  501. package/src/plugins/builtin/ticker-detail/quote-monitor/export.ts +46 -0
  502. package/src/plugins/builtin/ticker-detail/quote-monitor/index.tsx +20 -1
  503. package/src/plugins/builtin/ticker-detail/quote-monitor/rows.ts +120 -0
  504. package/src/plugins/builtin/ticker-detail/research-groups.ts +89 -0
  505. package/src/plugins/builtin/ticker-detail/research-tabs.ts +1 -5
  506. package/src/plugins/builtin/ticker-detail/settings.ts +10 -9
  507. package/src/plugins/builtin/treasury-auctions/cache.ts +85 -19
  508. package/src/plugins/builtin/treasury-auctions/index.tsx +22 -11
  509. package/src/plugins/builtin/treasury-auctions/model.ts +23 -0
  510. package/src/plugins/builtin/treasury-auctions/treasury-direct.ts +128 -0
  511. package/src/plugins/builtin/volatility/charts.tsx +2 -2
  512. package/src/plugins/builtin/world-indices/client.ts +2 -0
  513. package/src/plugins/compat.ts +15 -0
  514. package/src/plugins/host-link.ts +6 -1
  515. package/src/plugins/host-resolver.ts +3 -2
  516. package/src/plugins/installer.ts +8 -3
  517. package/src/portfolio/column-values.ts +56 -12
  518. package/src/portfolio/futures-positions.ts +10 -2
  519. package/src/portfolio/listed-symbol.ts +78 -0
  520. package/src/portfolio/mutations.ts +4 -3
  521. package/src/portfolio/period-pnl.ts +119 -0
  522. package/src/portfolio/positions-import/describe.ts +89 -0
  523. package/src/portfolio/positions-import/parse.ts +682 -0
  524. package/src/portfolio/positions-import/plan.ts +295 -0
  525. package/src/portfolio/real-return.ts +172 -0
  526. package/src/{plugins/builtin/analytics/metrics.ts → portfolio/return-metrics.ts} +24 -11
  527. package/src/public/__snapshots__/public-api.test.ts.snap +2 -0
  528. package/src/react/jsx-dev-fallback.ts +62 -0
  529. package/src/renderers/browser/cloud-transport.ts +1 -1
  530. package/src/renderers/browser/config-host.ts +59 -16
  531. package/src/renderers/browser/deeplink-bridge.ts +8 -1
  532. package/src/renderers/browser/http-proxy-transport.ts +9 -2
  533. package/src/renderers/browser/main.tsx +5 -2
  534. package/src/renderers/browser/research-entry.ts +12 -0
  535. package/src/renderers/browser/ui-host.tsx +1 -0
  536. package/src/renderers/cloudflare/http-proxy.ts +9 -2
  537. package/src/renderers/cloudflare/proxy-session.ts +1 -0
  538. package/src/renderers/cloudflare/worker.ts +12 -3
  539. package/src/renderers/dom/boot-frame.ts +2 -2
  540. package/src/renderers/dom/data-table/row.tsx +4 -1
  541. package/src/renderers/dom/desktop/audio-player.tsx +2 -2
  542. package/src/renderers/dom/desktop/controls.tsx +5 -5
  543. package/src/renderers/dom/desktop/dialog-actions.tsx +62 -57
  544. package/src/renderers/dom/desktop/icons.tsx +4 -2
  545. package/src/renderers/dom/desktop/query-bar.tsx +23 -19
  546. package/src/renderers/dom/dom-host-providers.tsx +7 -2
  547. package/src/renderers/dom/dom-ui-host.tsx +3 -1
  548. package/src/renderers/dom/host/box.tsx +2 -2
  549. package/src/renderers/dom/host/input.tsx +17 -1
  550. package/src/renderers/dom/host/tabs.tsx +10 -1
  551. package/src/renderers/dom/key-event.ts +1 -0
  552. package/src/renderers/dom/styles.css +36 -13
  553. package/src/renderers/electrobun/bun/context-menu/click.ts +1 -0
  554. package/src/renderers/electrobun/bun/desktop/app-name.ts +1 -1
  555. package/src/renderers/electrobun/bun/desktop/backend.ts +1 -0
  556. package/src/renderers/electrobun/bun/desktop/capability-bridge.ts +5 -4
  557. package/src/renderers/electrobun/bun/desktop/host-requests.ts +5 -4
  558. package/src/renderers/electrobun/bun/desktop/http-fetch.ts +1 -0
  559. package/src/renderers/electrobun/bun/desktop/http-stream.ts +1 -1
  560. package/src/renderers/electrobun/bun/desktop/initialization.ts +3 -1
  561. package/src/renderers/electrobun/bun/desktop/install-records.ts +4 -1
  562. package/src/renderers/electrobun/bun/desktop/installer-folder.ts +5 -2
  563. package/src/renderers/electrobun/bun/desktop/macos-objc.ts +3 -1
  564. package/src/renderers/electrobun/bun/desktop/screen-setup-file.ts +9 -4
  565. package/src/renderers/electrobun/bun/desktop/update.ts +27 -13
  566. package/src/renderers/electrobun/bun/desktop/windows-script.ts +6 -2
  567. package/src/renderers/electrobun/bun/window/attention.ts +1 -0
  568. package/src/renderers/electrobun/bun/window/boot-frame.ts +1 -0
  569. package/src/renderers/electrobun/bun/window/create.ts +1 -0
  570. package/src/renderers/electrobun/bun/window/electrobun-window-host.ts +13 -8
  571. package/src/renderers/electrobun/bun/window/native-min-size.ts +1 -1
  572. package/src/renderers/electrobun/bun/window/remembered-frame.ts +1 -0
  573. package/src/renderers/electrobun/bun/window/windows-native.ts +3 -1
  574. package/src/renderers/electrobun/bun/window/windows-quit.ts +3 -1
  575. package/src/renderers/electrobun/view/app-badge-host.ts +2 -1
  576. package/src/renderers/electrobun/view/capability-subscription.ts +2 -1
  577. package/src/renderers/electrobun/view/cli-pane-shot-entry.tsx +7 -10
  578. package/src/renderers/electrobun/view/cli-pane-shot-mutations.ts +36 -0
  579. package/src/renderers/electrobun/view/http-fetch.ts +2 -1
  580. package/src/renderers/electrobun/view/main.tsx +9 -4
  581. package/src/renderers/electrobun/view/remote/capability-invoker.ts +6 -3
  582. package/src/renderers/electrobun/view/remote/persistence.ts +63 -27
  583. package/src/renderers/electrobun/view/rpc-timeout.ts +1 -0
  584. package/src/renderers/electrobun/view/ui-host.tsx +3 -2
  585. package/src/renderers/electrobun/view/window-fullscreen.ts +3 -1
  586. package/src/renderers/opentui/browser-open.ts +2 -1
  587. package/src/renderers/opentui/dialog-host.tsx +1 -1
  588. package/src/renderers/opentui/host.tsx +2 -1
  589. package/src/renderers/opentui/interaction-performance.ts +3 -1
  590. package/src/renderers/opentui/start.tsx +2 -1
  591. package/src/renderers/opentui/terminal-media.ts +11 -6
  592. package/src/renderers/opentui/ui-host.tsx +5 -8
  593. package/src/shares/open.ts +22 -1
  594. package/src/shares/pane.ts +2 -1
  595. package/src/sources/gloomberb-cloud/fred-series.ts +12 -0
  596. package/src/sources/gloomberb-cloud/index.ts +31 -2
  597. package/src/sources/gloomberb-cloud/normalizers.ts +32 -3
  598. package/src/sources/provider-router/cached-routes.ts +19 -7
  599. package/src/state/pane-table-export-registry.ts +19 -6
  600. package/src/sync/analytics-payload.ts +194 -0
  601. package/src/sync/baseline.ts +19 -9
  602. package/src/sync/broker-identity.ts +171 -0
  603. package/src/sync/broker-instances.ts +137 -0
  604. package/src/sync/collections-contributor.ts +173 -0
  605. package/src/sync/config-contributor.ts +100 -0
  606. package/src/sync/config-merge.ts +229 -0
  607. package/src/sync/controller.ts +139 -28
  608. package/src/sync/core-contributors.ts +8 -1583
  609. package/src/sync/history-memo.ts +32 -0
  610. package/src/sync/layout-merge.ts +259 -0
  611. package/src/sync/sanitize.ts +114 -0
  612. package/src/sync/ticker-merge.ts +208 -0
  613. package/src/sync/ticker-payload.ts +81 -0
  614. package/src/sync/types.ts +15 -1
  615. package/src/telemetry/attention-setting.ts +1 -1
  616. package/src/telemetry/usage-counts.ts +16 -0
  617. package/src/test-support/preload.ts +9 -0
  618. package/src/theme/color-utils.ts +10 -0
  619. package/src/theme/colors.ts +9 -1
  620. package/src/theme/font-scale.ts +34 -3
  621. package/src/theme/series-colors.ts +44 -0
  622. package/src/theme/themes.ts +64 -16
  623. package/src/theme/tone-contrast.ts +40 -0
  624. package/src/theme/ui-tokens.ts +23 -3
  625. package/src/tickers/batched-lookups.ts +314 -8
  626. package/src/tickers/company-name-listing.ts +198 -14
  627. package/src/tickers/company-name.ts +37 -8
  628. package/src/tickers/list.ts +7 -0
  629. package/src/tickers/search/home-listing.ts +31 -9
  630. package/src/tickers/search/index.ts +13 -3
  631. package/src/tickers/search/listing-index.ts +558 -0
  632. package/src/tickers/search/major-listings.chunk.ts +10 -0
  633. package/src/tickers/search/major-listings.json +3346 -0
  634. package/src/tickers/search/ranking.ts +68 -1
  635. package/src/tickers/search/types.ts +4 -0
  636. package/src/tickers/search/upsert.ts +16 -1
  637. package/src/tickers/terminal-codes.ts +26 -1
  638. package/src/time-series/base-series.ts +18 -4
  639. package/src/time-series/calendar-month-returns.ts +47 -0
  640. package/src/time-series/currency-conversion.ts +130 -0
  641. package/src/time-series/hooks.ts +2 -0
  642. package/src/time-series/price-comparison.ts +34 -11
  643. package/src/time-series/resolve-context.ts +3 -0
  644. package/src/time-series/resolve.ts +14 -2
  645. package/src/time-series/spec.ts +1 -0
  646. package/src/time-series/studies/indicators.ts +7 -2
  647. package/src/time-series/studies/resolve.ts +1 -1
  648. package/src/time-series/types.ts +14 -0
  649. package/src/types/config.ts +8 -0
  650. package/src/types/data-provider.ts +28 -0
  651. package/src/types/financials.ts +38 -2
  652. package/src/types/headless.ts +23 -0
  653. package/src/ui/host.tsx +34 -3
  654. package/src/ui/index.tsx +1 -0
  655. package/src/utils/concurrency.ts +6 -0
  656. package/src/utils/currency-pair.ts +56 -4
  657. package/src/utils/datetime-format.ts +28 -3
  658. package/src/utils/decimal-comma.ts +9 -6
  659. package/src/utils/display-number.ts +15 -0
  660. package/src/utils/double-escape-close.ts +61 -16
  661. package/src/utils/exchanges.ts +32 -0
  662. package/src/utils/float32-price.ts +24 -0
  663. package/src/utils/forward-dividend.ts +81 -16
  664. package/src/utils/fundamentals.ts +41 -0
  665. package/src/utils/fx-market-hours.ts +11 -0
  666. package/src/utils/markdown.ts +4 -2
  667. package/src/utils/pasted-lines.ts +14 -0
  668. package/src/utils/plugin-proxy-hosts.json +2 -1
  669. package/src/utils/price-history.ts +7 -6
  670. package/src/utils/price-window.ts +2 -1
  671. package/src/utils/report-timing.ts +62 -0
  672. package/src/utils/sec-filings.ts +49 -0
  673. package/src/utils/sec.ts +4 -23
  674. package/src/utils/shortcut-labels.ts +6 -30
  675. package/src/utils/utc-time.ts +5 -0
@@ -3,7 +3,7 @@ import { Box } from "../../../ui";
3
3
  import { getCurrentPluginTarget } from "../../current-target";
4
4
  import { recordResearchActivity, recordResearchTabView } from "../../../api-client/research-activity";
5
5
  import { listExternalPlugins } from "../../external-runtime";
6
- import { useCallback, useEffect, useMemo, useState, useSyncExternalStore } from "react";
6
+ import { useCallback, useEffect, useMemo, useState, useSyncExternalStore, type ReactNode } from "react";
7
7
  import type { PaneProps, TickerResearchTabDef } from "../../../types/plugin";
8
8
  import { t, tf } from "../../../i18n";
9
9
  import { quoteSubscriptionTargetFromTicker } from "../../../market-data/request-types";
@@ -29,6 +29,8 @@ import {
29
29
  resolveLockedTabId,
30
30
  } from "./settings";
31
31
  import { TICKER_RESEARCH_BUILTIN_TABS } from "./research-tabs";
32
+ import { findTickerResearchGroup, groupTickerResearchTabs, tickerResearchGroupView } from "./research-groups";
33
+ import { isRecord } from "../../../utils/guards";
32
34
  import { useLiveStreamingSetting } from "../../../state/hooks/live-streaming";
33
35
  import { useCloudAccessFooter } from "../shared/cloud-upgrade";
34
36
  import { CLOUD_QUOTE_DELAY_MINUTES } from "../../../api-client/plan-access";
@@ -45,6 +47,9 @@ import { ResearchTradeWorkspace } from "../broker-trading/dock";
45
47
  const TICKER_RESEARCH_TAB_COMMIT_DELAY_MS = 120;
46
48
  /** A tab counts as viewed once it stays open this long, not when h/l passes over it. */
47
49
  const TICKER_RESEARCH_TAB_VIEW_DWELL_MS = 2_000;
50
+ /** Pane state: the view last chosen in each group, by group id. */
51
+ const GROUP_VIEWS_STATE_KEY = "groupViews";
52
+ const NO_GROUP_VIEWS: Record<string, unknown> = {};
48
53
 
49
54
  const COMPANY_RESEARCH = [
50
55
  { id: "supply-chain-pane", label: "Supply Chain (SPLC)" },
@@ -114,6 +119,37 @@ function getCollectionName(state: AppState, collectionId: string | null): string
114
119
  return collectionId;
115
120
  }
116
121
 
122
+ /**
123
+ * The shown group's views, under the groups: a compact second row in the
124
+ * terminal and query-bar choices on the desktop, as Fixed Income's views of a
125
+ * section. h/l stay with the groups. Drawn inside `NestedPaneTabs`, so the
126
+ * chrome keeps the groups in the title bar.
127
+ */
128
+ function ResearchGroupViews({ views, activeValue, onSelect, focused, width, height, children }: {
129
+ /** Null for a group with one view, which opens it with no choices. */
130
+ views: { value: string; label: string }[] | null;
131
+ activeValue: string;
132
+ onSelect(value: string): void;
133
+ focused: boolean;
134
+ width: number;
135
+ height: number;
136
+ children(contentHeight: number): ReactNode;
137
+ }) {
138
+ const { strip, rows } = usePaneTabs(views ? {
139
+ tabs: views,
140
+ activeValue,
141
+ onSelect,
142
+ focused,
143
+ keyboardNavigation: false,
144
+ dense: true,
145
+ queryBarWidth: width,
146
+ } : null);
147
+ return <>
148
+ {strip}
149
+ {children(Math.max(1, height - rows))}
150
+ </>;
151
+ }
152
+
117
153
  export function TickerResearchPane({ focused, width, height }: PaneProps) {
118
154
  const dispatch = useAppDispatch();
119
155
  const { createPaneFromTemplate } = usePluginAppActions();
@@ -239,13 +275,28 @@ export function TickerResearchPane({ focused, width, height }: PaneProps) {
239
275
  setConsumedTabAt(requestedTabAt);
240
276
  setActiveTabId(requestedTabId);
241
277
  }, [consumedTabAt, requestedTabAt, requestedTabId, setActiveTabId, setConsumedTabAt, visibleTabIdKey]);
242
- // A quote tick re-renders this pane; the tab strip only has to re-render
278
+ // A quote tick re-renders this pane; the strips only have to re-render
243
279
  // when a tab appears, disappears, or is renamed.
244
- const tabItemsKey = allTabs.map((tab) => `${tab.id}:${tab.name}`).join("\0");
245
- const tabItems = useMemo(
246
- () => allTabs.map((tab) => ({ label: t(tab.name), value: tab.id })),
247
- [tabItemsKey],
280
+ const tabItemsKey = allTabs.map((tab) => `${tab.id}:${tab.name}:${tab.order}`).join("\0");
281
+ // The top strip is the groups; a view keeps its own tab id everywhere else.
282
+ const groups = useMemo(() => groupTickerResearchTabs(allTabs), [tabItemsKey]);
283
+ const groupItems = useMemo(
284
+ () => groups.map((group) => ({ label: t(group.name), value: group.id })),
285
+ [groups],
248
286
  );
287
+ const activeGroup = findTickerResearchGroup(groups, resolvedTabId);
288
+ const groupViewItems = useMemo(
289
+ () => activeGroup && activeGroup.views.length > 1
290
+ ? activeGroup.views.map((view) => ({ label: t(view.name), value: view.id }))
291
+ : null,
292
+ [activeGroup],
293
+ );
294
+ const [storedGroupViews, setGroupViews] = usePaneStateValue<Record<string, unknown>>(GROUP_VIEWS_STATE_KEY, NO_GROUP_VIEWS);
295
+ const groupViews = isRecord(storedGroupViews) ? storedGroupViews : NO_GROUP_VIEWS;
296
+ const rememberedView = useCallback((groupId: string) => {
297
+ const value = groupViews[groupId];
298
+ return typeof value === "string" ? value : undefined;
299
+ }, [groupViews]);
249
300
  // A tab's detail that moves with h/l itself (a 13F fund's sections) takes
250
301
  // those keys while it is open; Esc gives them back to the strip.
251
302
  const researchTabKeys = useResearchTabKeysHost();
@@ -257,15 +308,32 @@ export function TickerResearchPane({ focused, width, height }: PaneProps) {
257
308
  }
258
309
  setActiveTabId(tabId);
259
310
  }, [resolvedTabId, setActiveTabId, ticker]);
311
+ // A group opens on the view last chosen in it, as Fixed Income's sections do.
312
+ const selectResearchGroup = useCallback((groupId: string) => {
313
+ const group = groups.find((entry) => entry.id === groupId);
314
+ if (group) selectResearchTab(tickerResearchGroupView(group, rememberedView(group.id)));
315
+ }, [groups, rememberedView, selectResearchTab]);
260
316
  const { strip: tabStrip, rows: tabBarHeight } = usePaneTabs(!paneSettings.hideTabs && ticker ? {
261
- tabs: tabItems,
262
- activeValue: resolvedTabId,
263
- onSelect: selectResearchTab,
317
+ tabs: groupItems,
318
+ activeValue: activeGroup?.id ?? null,
319
+ onSelect: selectResearchGroup,
264
320
  focused: stripFocused,
321
+ // Compact, as Fixed Income's: the views' row under it starts where it does.
322
+ dense: true,
265
323
  } : null);
266
- // h/l step one tab at a time; with twenty tabs the pane menu jumps straight to one.
324
+ // h/l step one group at a time; the pane menu jumps straight to any view.
267
325
  const dialog = useOptionalDialog();
268
326
  const showTabs = !paneSettings.hideTabs && !!ticker;
327
+ // Remember a view shown by any route (a choice, a link from Overview, the
328
+ // pane menu, `--tab`) when it is not the one its group would open on, so the
329
+ // group opens on it again. Landing on a group's own choice writes nothing.
330
+ useEffect(() => {
331
+ if (!showTabs || !activeGroup || activeGroup.views.length < 2) return;
332
+ if (tickerResearchGroupView(activeGroup, rememberedView(activeGroup.id)) === resolvedTabId) return;
333
+ // One the group never reopens on (Trade) leaves the remembered view as it was.
334
+ if (tickerResearchGroupView(activeGroup, resolvedTabId) !== resolvedTabId) return;
335
+ setGroupViews((current) => ({ ...(isRecord(current) ? current : {}), [activeGroup.id]: resolvedTabId }));
336
+ }, [activeGroup, rememberedView, resolvedTabId, setGroupViews, showTabs]);
269
337
  const companySymbol = ticker && resolveTickerInstrumentKind(ticker, financials) === "equity"
270
338
  ? tickerHasListingSuffix(ticker.metadata.ticker) ? ticker.metadata.ticker : publicTickerKey(ticker.metadata.ticker, ticker.metadata.exchange)
271
339
  : null;
@@ -288,7 +356,7 @@ export function TickerResearchPane({ focused, width, height }: PaneProps) {
288
356
  } }];
289
357
  }, [companySymbol, createPaneFromTemplate, dialog, disabledPlugins, registry, tickerResearchTabsSnapshot]);
290
358
  usePaneMenuItems("ticker-research:go-to-tab", () => {
291
- if (!showTabs || !dialog || tabItems.length < 2) return null;
359
+ if (!showTabs || !dialog || allTabs.length < 2) return null;
292
360
  return [{
293
361
  id: "go-to-tab",
294
362
  label: t("Go to Tab…"),
@@ -300,7 +368,7 @@ export function TickerResearchPane({ focused, width, height }: PaneProps) {
300
368
  {...context}
301
369
  title={t("Go to Tab")}
302
370
  selectedChoiceId={resolvedTabId}
303
- choices={tabItems.map((tab) => ({ id: tab.value, label: tab.label }))}
371
+ choices={groups.flatMap((group) => group.views.map((view) => ({ id: view.id, label: t(view.name), group: t(group.name) })))}
304
372
  />
305
373
  ),
306
374
  }).then((tabId) => {
@@ -308,7 +376,7 @@ export function TickerResearchPane({ focused, width, height }: PaneProps) {
308
376
  }).catch(logFailure("ticker-detail.pane", "Open research tab choices failed"));
309
377
  },
310
378
  }];
311
- }, [dialog, resolvedTabId, selectResearchTab, showTabs, tabItems]);
379
+ }, [allTabs.length, dialog, groups, resolvedTabId, selectResearchTab, showTabs]);
312
380
  // Which tabs people stay on. A pane pinned to one tab has no strip; opening
313
381
  // it is a function open, counted with those.
314
382
  useEffect(() => {
@@ -318,7 +386,7 @@ export function TickerResearchPane({ focused, width, height }: PaneProps) {
318
386
  const timer = setTimeout(() => recordResearchTabView(resolvedTabId, fromExternalPlugin), TICKER_RESEARCH_TAB_VIEW_DWELL_MS);
319
387
  return () => clearTimeout(timer);
320
388
  }, [focused, registry, resolvedTabId, showTabs]);
321
- const contentHeight = Math.max(1, height - tabBarHeight);
389
+ const bodyHeight = Math.max(1, height - tabBarHeight);
322
390
  const visibleTabIds = useMemo(() => new Set(allTabs.map((tab) => tab.id)), [visibleTabIdKey]);
323
391
  // A figure on one tab can open the tab that explains it (holders, short interest).
324
392
  const openResearchTab = useCallback((tabId: string) => {
@@ -381,7 +449,7 @@ export function TickerResearchPane({ focused, width, height }: PaneProps) {
381
449
 
382
450
  const tradeAvailable = visibleTabIds.has("broker-trade");
383
451
  // Trade shows Chart beside its ticket: the workspace names the tab it shows.
384
- const renderTabs = (contentWidth: number, contentFocused: boolean, shownTabId = resolvedTabId) => (
452
+ const renderTabs = (contentHeight: number) => (contentWidth: number, contentFocused: boolean, shownTabId = resolvedTabId) => (
385
453
  <ResearchTabKeysProvider value={showTabs ? researchTabKeys.value : null}>
386
454
  {tickerResearchTabs.map((tab) => {
387
455
  if (tradeAvailable && tab.id === "broker-trade" || !(renderedTabIds.has(tab.id) || tab.id === shownTabId) || !visibleTabIds.has(tab.id)) return null;
@@ -416,10 +484,17 @@ export function TickerResearchPane({ focused, width, height }: PaneProps) {
416
484
  );
417
485
  return <Box flexDirection="column" flexGrow={1} flexBasis={0} overflow="hidden">
418
486
  {tabStrip}
419
- <Box height={contentHeight} flexGrow={1} flexBasis={0} overflow="hidden">
420
- {tradeAvailable ? <ResearchTradeWorkspace width={width} height={contentHeight} focused={focused} symbol={ticker.metadata.ticker}
421
- tabId={resolvedTabId} selectTab={selectResearchTab} onCapture={handlePluginCapture} locked={!!paneSettings.hideTabs}>{renderTabs}</ResearchTradeWorkspace>
422
- : renderTabs(width, focused)}
423
- </Box>
487
+ <NestedPaneTabs>
488
+ <ResearchGroupViews views={showTabs ? groupViewItems : null} activeValue={resolvedTabId} onSelect={selectResearchTab}
489
+ focused={focused} width={width} height={bodyHeight}>
490
+ {(contentHeight) => (
491
+ <Box height={contentHeight} flexGrow={1} flexBasis={0} overflow="hidden">
492
+ {tradeAvailable ? <ResearchTradeWorkspace width={width} height={contentHeight} focused={focused} symbol={ticker.metadata.ticker}
493
+ tabId={resolvedTabId} selectTab={selectResearchTab} onCapture={handlePluginCapture} locked={!!paneSettings.hideTabs}>{renderTabs(contentHeight)}</ResearchTradeWorkspace>
494
+ : renderTabs(contentHeight)(width, focused)}
495
+ </Box>
496
+ )}
497
+ </ResearchGroupViews>
498
+ </NestedPaneTabs>
424
499
  </Box>;
425
500
  }
@@ -21,7 +21,8 @@ import {
21
21
  import { t } from "../../../../i18n";
22
22
  import { isQuoteStaleForCurrentSession } from "../../../../market-data/quotes/freshness";
23
23
  import { delistingLabel, delistingStateLabel } from "../../../../market-data/quotes/delisting";
24
- import { formatQuoteNavAsOf } from "../../../../market-data/quotes/time";
24
+ import { formatQuoteNavAsOf, formatQuoteSessionAsOf } from "../../../../market-data/quotes/time";
25
+ import { ClippedText } from "../../../../components/ui/display";
25
26
  import { useQuoteFlashDirection } from "../../../../components/quote-flash";
26
27
  import { followLiveSparklinePrice } from "../../../../components/price-sparkline/model";
27
28
  import {
@@ -62,6 +63,21 @@ function extendedLineParts(
62
63
 
63
64
  const DESKTOP_DETAIL_TEXT_STYLE = { fontSize: "var(--gloom-type-ui)", lineHeight: "14px", whiteSpace: "nowrap" };
64
65
 
66
+ /** The desktop card's muted lines: the name under its symbol, and what the price is as of. */
67
+ /** A line set over the sparkline, backed in the card's colour (the theme's, as drawn) so the line does not run through it. */
68
+ function backedLineStyle() {
69
+ return { alignSelf: "start", maxWidth: "100%", backgroundColor: colors.bg, boxShadow: `0 0 0 2px ${colors.bg}`, paddingRight: 2 };
70
+ }
71
+
72
+ const DESKTOP_META_LINE_STYLE = {
73
+ fontSize: "var(--gloom-type-ui)",
74
+ lineHeight: "14px",
75
+ maxWidth: "100%",
76
+ overflow: "hidden",
77
+ textOverflow: "ellipsis",
78
+ whiteSpace: "nowrap",
79
+ };
80
+
65
81
  function ExtendedSessionLine({
66
82
  parts,
67
83
  color,
@@ -170,6 +186,10 @@ export function QuoteMonitorCard({
170
186
  const quoteStatus = resolveQuoteStatus(quoteEntry, symbol, quote);
171
187
  const quoteFailed = quoteStatus.failed && !!display;
172
188
  const navAsOf = formatQuoteNavAsOf(quote);
189
+ // Each card says what its own price is as of (`CLOSED · 08:09 UTC` beside `15 min delayed · 21:20 UTC`);
190
+ // a fund says its NAV's date instead.
191
+ const sessionAsOf = quoteStatus.ended ? null : formatQuoteSessionAsOf(quote);
192
+ const desktopAsOf = nativePaneChrome ? navAsOf ?? sessionAsOf : null;
173
193
  const changeColor = quoteFailed ? colors.textDim : priceColor(display?.change ?? 0);
174
194
  const flashing = !!flashDirection && !headlineHolds;
175
195
  const currency = quote?.currency || ticker?.metadata.currency || "USD";
@@ -206,8 +226,12 @@ export function QuoteMonitorCard({
206
226
  const trend = quoteTrend(display?.change);
207
227
  const terminalSparklineHeight = !nativePaneChrome && !stacked && height >= 4 ? 2 : 1;
208
228
  const statusRows = (quoteFailed && !compactQuoteFailure ? 1 : 0) + (navAsOf && !compactNavAsOf ? 1 : 0);
229
+ const headerRows = stacked ? 3 : 2;
209
230
  const showTerminalSparkline = (!quoteFailed && !navAsOf)
210
- || height >= (stacked ? 3 : 2) + statusRows + terminalSparklineHeight;
231
+ || height >= headerRows + statusRows + terminalSparklineHeight;
232
+ // The terminal gives the as-of line a row only where the card has one to spare: the sparkline keeps its rows.
233
+ const showTerminalSessionAsOf = !!sessionAsOf
234
+ && height >= headerRows + statusRows + (perpetuals ? 1 : 0) + (showTerminalSparkline ? terminalSparklineHeight : 0) + 1;
211
235
  // Figures sit over the sparkline, so the desktop rings them in the card colour.
212
236
  const figureHalo = { textShadow: `0 1px 2px ${colors.bg}` };
213
237
  // The card's title: a heading over the app's 12px name, under the 20px price.
@@ -272,7 +296,8 @@ export function QuoteMonitorCard({
272
296
  display: "grid",
273
297
  // The name gives way first; the price keeps its natural width.
274
298
  gridTemplateColumns: "minmax(0, 1fr) auto",
275
- gridTemplateRows: "auto 1fr auto auto",
299
+ // The symbol and price, what the price is as of, an extended print, the range, a perpetual.
300
+ gridTemplateRows: "auto auto 1fr auto auto",
276
301
  columnGap: "var(--gloom-space-md)",
277
302
  width: "100%",
278
303
  height: "100%",
@@ -283,7 +308,7 @@ export function QuoteMonitorCard({
283
308
  minWidth={0}
284
309
  style={{
285
310
  gridColumn: "1",
286
- gridRow: extendedParts || endedRow ? "1" : "1 / span 2",
311
+ gridRow: extendedParts || endedRow || desktopAsOf ? "1" : "1 / span 3",
287
312
  minWidth: 0,
288
313
  overflow: "hidden",
289
314
  }}
@@ -297,25 +322,10 @@ export function QuoteMonitorCard({
297
322
  </Text>
298
323
  )}
299
324
  {!quoteFailed && ticker?.metadata.name && (
300
- <Text
301
- fg={colors.textDim}
302
- style={{
303
- fontSize: "var(--gloom-type-ui)",
304
- lineHeight: "14px",
305
- maxWidth: "100%",
306
- overflow: "hidden",
307
- textOverflow: "ellipsis",
308
- whiteSpace: "nowrap",
309
- }}
310
- >
325
+ <Text fg={colors.textDim} style={DESKTOP_META_LINE_STYLE}>
311
326
  {ticker.metadata.name}
312
327
  </Text>
313
328
  )}
314
- {navAsOf && (
315
- <Text fg={colors.textDim} style={{ fontSize: "var(--gloom-type-ui)", lineHeight: "14px" }}>
316
- {navAsOf}
317
- </Text>
318
- )}
319
329
  </Box>
320
330
 
321
331
  <Box
@@ -339,6 +349,16 @@ export function QuoteMonitorCard({
339
349
  </Box>
340
350
  </Box>
341
351
 
352
+ {desktopAsOf && (
353
+ // Across the card under the name and the price, so the time is never cut beside a wide price.
354
+ <Text
355
+ fg={colors.textDim}
356
+ style={{ ...DESKTOP_META_LINE_STYLE, gridColumn: "1 / -1", gridRow: "2", justifySelf: "start", ...backedLineStyle() }}
357
+ >
358
+ {desktopAsOf}
359
+ </Text>
360
+ )}
361
+
342
362
  {endedRow && (
343
363
  // Under the price, across the card, so the date is never cut on a narrow card;
344
364
  // backed like the price so the sparkline does not run through it.
@@ -346,7 +366,7 @@ export function QuoteMonitorCard({
346
366
  fg={colors.warning}
347
367
  style={{
348
368
  gridColumn: "1 / -1",
349
- gridRow: "2",
369
+ gridRow: "3",
350
370
  justifySelf: "start",
351
371
  alignSelf: "start",
352
372
  fontSize: "var(--gloom-type-ui)",
@@ -368,7 +388,7 @@ export function QuoteMonitorCard({
368
388
  dim={extendedDim}
369
389
  desktopStyle={{
370
390
  gridColumn: "1 / -1",
371
- gridRow: "2",
391
+ gridRow: "3",
372
392
  justifySelf: "start",
373
393
  alignSelf: "start",
374
394
  maxWidth: "100%",
@@ -380,13 +400,13 @@ export function QuoteMonitorCard({
380
400
  />
381
401
  )}
382
402
 
383
- {perpetuals && <Box style={{ gridColumn: "1 / -1", gridRow: "4", alignSelf: "end" }}>{perpetuals}</Box>}
403
+ {perpetuals && <Box style={{ gridColumn: "1 / -1", gridRow: "5", alignSelf: "end" }}>{perpetuals}</Box>}
384
404
  {rangeLabel && (
385
405
  <Text
386
406
  fg={colors.textDim}
387
407
  style={{
388
408
  gridColumn: "2",
389
- gridRow: "3",
409
+ gridRow: "4",
390
410
  justifySelf: "end",
391
411
  alignSelf: "end",
392
412
  fontSize: "var(--gloom-type-ui)",
@@ -466,6 +486,9 @@ export function QuoteMonitorCard({
466
486
  {navAsOf && !compactNavAsOf && (
467
487
  <Box height={1} overflow="hidden"><Text fg={colors.textDim}>{navAsOf}</Text></Box>
468
488
  )}
489
+ {showTerminalSessionAsOf && (
490
+ <Box height={1} overflow="hidden"><ClippedText text={sessionAsOf!} width={Math.max(1, width - 2)} fg={colors.textDim} /></Box>
491
+ )}
469
492
  {perpetuals}
470
493
  {showTerminalSparkline && <Box height={terminalSparklineHeight} flexDirection="row" alignItems="center" gap={1}>
471
494
  <PriceSparkline
@@ -0,0 +1,46 @@
1
+ import type { Quote } from "../../../../types/financials";
2
+ import type { HeadlessPaneRow } from "../../../../types/headless";
3
+ import { EXCEL_CSV_BOM } from "../../../../utils/csv";
4
+ import { exportedListingSymbol } from "../../../../portfolio/listed-symbol";
5
+ import type { BrokerNameOf } from "../../../../market-data/quotes/export-identity";
6
+ import { exportRowsTable, renderReportCsv } from "../../../../cli/report-tables";
7
+ import { deriveHeadlessFreshness } from "../../../../cli/pane-functions/freshness";
8
+ import { quoteMonitorColumns, quoteMonitorRow } from "./rows";
9
+
10
+ export interface QuoteMonitorExportEntry {
11
+ /** The symbol as the board shows it (0005.HK). */
12
+ symbol: string;
13
+ /** The listing it was read as, when the board knows its venue. */
14
+ instrument: { symbol: string; exchange?: string } | null;
15
+ quote: Quote | null | undefined;
16
+ }
17
+
18
+ /** A card with no quote: its ticker and why the row is empty, as `fn QQ` names a symbol it found nothing for. */
19
+ function unquotedRow(symbol: string): HeadlessPaneRow {
20
+ return { symbol, name: "", price: null, change: null, changePercent: null, unit: null, updatedAt: null, source: "" };
21
+ }
22
+
23
+ /**
24
+ * The board's Export CSV, the file `fn QQ --csv` writes for the same tickers:
25
+ * each card's listing with its venue (0005:HKEX), name, Last, the change and
26
+ * percent change to the digits the board shows, what the move is from, its
27
+ * session and feed, a yield's move in bp, then its unit, source and the time
28
+ * its own price was observed. The closing source lines are left out, as every
29
+ * pane export leaves them.
30
+ */
31
+ export function quoteMonitorCsv(entries: readonly QuoteMonitorExportEntry[], now = Date.now(), brokerName?: BrokerNameOf): string {
32
+ const rows = entries.map(({ symbol, instrument, quote }) => {
33
+ const listing = instrument ? exportedListingSymbol(instrument.symbol, instrument.exchange, quote?.instrumentType) : symbol;
34
+ return quote ? quoteMonitorRow(listing, quote, now, brokerName) : unquotedRow(listing);
35
+ });
36
+ const table = exportRowsTable("Quote Monitor", quoteMonitorColumns(rows), rows, { status: true, rowUnitKey: "unit" });
37
+ const text = (value: unknown) => typeof value === "string" ? value : null;
38
+ const rowIdentities = rows.map((row) => ({
39
+ symbolOrSeries: text(row.symbol),
40
+ currencyOrUnit: text(row.unit),
41
+ asOf: typeof row.updatedAt === "number" && Number.isFinite(row.updatedAt) ? new Date(row.updatedAt).toISOString() : null,
42
+ source: text(row.source),
43
+ }));
44
+ const freshness = deriveHeadlessFreshness({ shape: "rows", freshness: { datesEachVenue: true } }, { rows }, now);
45
+ return `${EXCEL_CSV_BOM}${renderReportCsv({ tables: [{ ...table, rowIdentities }], footer: [] }, freshness)}`;
46
+ }
@@ -1,7 +1,7 @@
1
1
  import { logFailure } from "../../../../utils/log-failure";
2
2
  import { PerpEquityRow } from "../../perps/equity-row";
3
3
  import { useCallback, useEffect, useMemo, useRef, useState } from "react";
4
- import { Box, useUiCapabilities } from "../../../../ui";
4
+ import { Box, useRendererHost, useUiCapabilities } from "../../../../ui";
5
5
  import type { PaneProps } from "../../../../types/plugin";
6
6
  import { TICKER_RESEARCH_PANE_ID } from "../../../../types/config";
7
7
  import type { QuoteSubscriptionTarget } from "../../../../types/data-provider";
@@ -21,6 +21,9 @@ import { useShortcut, type KeyEventLike } from "../../../../react/input";
21
21
  import { isPlainKey } from "../../../../utils/keyboard";
22
22
  import { QuoteMonitorCard } from "./card";
23
23
  import { useLiveStreamingSetting } from "../../../../state/hooks/live-streaming";
24
+ import { registerPaneTableExporter } from "../../../../state/pane-table-export-registry";
25
+ import { quoteMonitorCsv } from "./export";
26
+ import { getSharedRegistry } from "../../../registry";
24
27
 
25
28
  interface BoardEntry {
26
29
  symbol: string;
@@ -176,6 +179,22 @@ export function QuoteMonitorPane({ paneId, focused, width, height }: PaneProps)
176
179
  if (!coordinator || !liveStreaming || boardInstruments.length === 0) return;
177
180
  void coordinator.loadQuotesBatch(boardInstruments).catch(logFailure("ticker-detail.quote-monitor", "Warm quote monitor board failed"));
178
181
  }, [boardInstrumentKey, liveStreaming]);
182
+ // Export CSV writes the board's quotes as `fn QQ --csv` does, each card its own as-of and session.
183
+ const renderer = useRendererHost();
184
+ const exportCsvRef = useRef<() => string>(() => "");
185
+ exportCsvRef.current = () => quoteMonitorCsv(boardEntries.map((entry) => ({
186
+ symbol: entry.symbol,
187
+ instrument: entry.instrument,
188
+ quote: (entry.quoteKey ? resolveEntryData(quoteEntries.get(entry.quoteKey)) : null) ?? financialsBySymbol.get(entry.symbol)?.quote,
189
+ })), Date.now(), (providerId) => getSharedRegistry()?.getBrokerAdapter(providerId)?.name);
190
+ useEffect(() => {
191
+ if (!renderer.saveTextFile) return;
192
+ return registerPaneTableExporter(paneId, (filename) => renderer.saveTextFile!({
193
+ name: filename,
194
+ text: exportCsvRef.current(),
195
+ mimeType: "text/csv;charset=utf-8",
196
+ }));
197
+ }, [paneId, renderer]);
179
198
  const { pinTicker } = usePluginTickerActions();
180
199
  const { openPaneSettings } = usePluginAppActions();
181
200
  const { nativePaneChrome } = useUiCapabilities();
@@ -0,0 +1,120 @@
1
+ import type { Quote } from "../../../../types/financials";
2
+ import type { HeadlessPaneColumn, HeadlessPaneRow } from "../../../../types/headless";
3
+ import { EXTENDED_SESSION_LABELS, getQuoteSessionFields, quoteHeadlineTime, quoteSessionStateLabel, type ExtendedSession } from "../../../../market-data/market/status";
4
+ import { changeBasisLabel, quoteChangeBasis } from "../../../../market-data/market/change-basis";
5
+ import {
6
+ formatMarketChangeWithCurrency, formatMarketPrice, formatMarketPriceWithCurrency, resolveAssetDisplayKind, withCurrencyMinorDigits,
7
+ type MarketFormatOptions,
8
+ } from "../../../../market-data/market/format";
9
+ import { quoteExportFeed, quoteExportUnit, quoteSourceName, type BrokerNameOf } from "../../../../market-data/quotes/export-identity";
10
+ import { isYieldIndexSymbol } from "../../../../tickers/index-roots";
11
+ import { toBasisPoints } from "../../../../utils/basis-points";
12
+ import { formatPercentRaw } from "../../../../utils/format";
13
+ import { parsePublicTickerKey } from "../../../../utils/exchanges";
14
+ import { quoteFreshnessFields } from "../../shared/report-freshness";
15
+
16
+ /**
17
+ * The Quote Monitor's rows as `fn QQ` reports them and the pane's Export CSV
18
+ * writes them: one model, so the board's file and the CLI's agree cell for cell.
19
+ */
20
+
21
+ /** A price or move in the row's own currency, as the cards draw it. */
22
+ function quoteAmount(value: unknown, row: Record<string, unknown>, signed = false): string {
23
+ if (typeof value !== "number" || !Number.isFinite(value)) return "—";
24
+ const currency = typeof row.currency === "string" && row.currency.trim() ? row.currency : undefined;
25
+ const base: MarketFormatOptions = { assetCategory: typeof row.instrumentType === "string" ? row.instrumentType : undefined,
26
+ priceBasis: row.priceBasis === "per-unit" || row.priceBasis === "percent-of-par" ? row.priceBasis : undefined };
27
+ // Par quotes keep two decimals; money pads to its currency's minor unit (none for JPY).
28
+ const options = base.priceBasis === "percent-of-par" ? { ...base, minimumFractionDigits: 2 } : withCurrencyMinorDigits(base, currency);
29
+ // A currency pair's move is written at the pair's precision, as its price is (-$0.00108 on EUR/USD 1.16023).
30
+ if (signed && currency && typeof row.price === "number" && resolveAssetDisplayKind(options) === "cash") {
31
+ return formatMarketChangeWithCurrency(value, currency, options, row.price);
32
+ }
33
+ const amount = currency
34
+ ? formatMarketPriceWithCurrency(value, currency, options)
35
+ : formatMarketPrice(value, options);
36
+ return amount === "—" ? amount : `${signed && value >= 0 ? "+" : ""}${amount}`;
37
+ }
38
+
39
+ function percentCell(value: unknown): string {
40
+ return formatPercentRaw(typeof value === "number" && Number.isFinite(value) ? value : undefined);
41
+ }
42
+
43
+ // Last and Change are in each row's own unit, which an export names in `currency_or_unit` and leaves out of the figures.
44
+ // An export writes the move to the digits the board shows (-315.12, -1.27), and Last whole, as `quote --csv` does
45
+ // (a yield's 4.859, which the board draws 4.86); JSON keeps every figure whole.
46
+ const QUOTE_MONITOR_COLUMNS: HeadlessPaneColumn[] = [
47
+ { key: "symbol", header: "Ticker" },
48
+ { key: "name", header: "Name" },
49
+ { key: "price", header: "Last", align: "right", unitKey: "unit", format: (value, row) => quoteAmount(value, row) },
50
+ { key: "change", header: "Change", align: "right", unitKey: "unit", exportAsShown: true, format: (value, row) => quoteAmount(value, row, true) },
51
+ { key: "changePercent", header: "Change %", align: "right", exportAsShown: true, format: percentCell },
52
+ ];
53
+
54
+ /**
55
+ * What each row's figures are as of, as `quote --csv` says it: the session
56
+ * (CLOSED, REGULAR, PRE-MKT), whether the feed is live, delayed or stale, and
57
+ * what the move is from. A narrow terminal drops them before it cuts a name.
58
+ */
59
+ const QUOTE_MONITOR_SESSION_COLUMNS: HeadlessPaneColumn[] = [
60
+ { key: "changeBasis", header: "Chg Basis", optional: true, dropPriority: 1 },
61
+ { key: "session", header: "Session", optional: true, dropPriority: 3 },
62
+ { key: "feed", header: "Feed", optional: true, dropPriority: 2 },
63
+ ];
64
+
65
+ /** A Cboe yield's move in basis points, the figure its card reads (+2.2bp), as `quote --csv` exports it. */
66
+ const CHANGE_BP_COLUMN: HeadlessPaneColumn = {
67
+ key: "changeBasisPoints", header: "Chg bp", align: "right", optional: true, dropPriority: 0,
68
+ format: (value) => typeof value === "number" && Number.isFinite(value) ? `${value >= 0 ? "+" : ""}${value.toFixed(1)}` : "",
69
+ };
70
+
71
+ /** The pre-market, after-hours or overnight print and its move from the regular close, for the rows that have one. */
72
+ function extendedSessionColumn(session: ExtendedSession): HeadlessPaneColumn {
73
+ return {
74
+ key: "extendedPrice", header: EXTENDED_SESSION_LABELS[session], align: "right",
75
+ format: (value, row) => row.extendedSession === session
76
+ ? `${quoteAmount(value, row)} ${percentCell(row.extendedChangePercent)}`
77
+ : "—",
78
+ };
79
+ }
80
+
81
+ /** Every column a board's rows draw: an extended session's only when a row has its print, Chg bp only beside a yield. */
82
+ export function quoteMonitorColumns(rows: readonly HeadlessPaneRow[]): HeadlessPaneColumn[] {
83
+ const extended = (["PRE", "POST", "OVERNIGHT"] as const)
84
+ .filter((session) => rows.some((row) => row.extendedSession === session))
85
+ .map(extendedSessionColumn);
86
+ const yields = rows.some((row) => row.changeBasisPoints != null);
87
+ return [...QUOTE_MONITOR_COLUMNS, ...extended, ...QUOTE_MONITOR_SESSION_COLUMNS, ...yields ? [CHANGE_BP_COLUMN] : []];
88
+ }
89
+
90
+ /** The columns a board starts with, before its rows say which sessions and yields it holds. */
91
+ export const QUOTE_MONITOR_BASE_COLUMNS: HeadlessPaneColumn[] = [...QUOTE_MONITOR_COLUMNS, ...QUOTE_MONITOR_SESSION_COLUMNS];
92
+
93
+ /** The row fields an export reads each row's identity from: its listing, unit, source and as-of. */
94
+ export const QUOTE_MONITOR_ROW_KEYS = { rowSymbolKey: "symbol", rowUnitKey: "unit", rowAsOfKey: "updatedAt", rowSourceKey: "source" } as const;
95
+
96
+ /**
97
+ * One card as a row: the regular session's Last, change and percent change,
98
+ * any extended print, what the move is from, the session and feed, and each
99
+ * row's own as-of (Hong Kong's close beside New York's), its unit and source.
100
+ * `symbol` is the listing with its venue (0005:HKEX).
101
+ */
102
+ export function quoteMonitorRow(symbol: string, quote: Quote, now = Date.now(), brokerName?: BrokerNameOf): HeadlessPaneRow {
103
+ // As the pane's cards show them: the regular session, then any extended print from its close.
104
+ const { price, change, changePercent, ...extended } = getQuoteSessionFields(quote);
105
+ const basis = quoteChangeBasis(quote);
106
+ const yieldIndex = isYieldIndexSymbol(parsePublicTickerKey(symbol).symbol);
107
+ return {
108
+ symbol, name: quote.name ?? "", price, currency: quote.currency, unit: quoteExportUnit(symbol, quote),
109
+ ...(quote.instrumentType ? { instrumentType: quote.instrumentType } : {}),
110
+ ...(quote.priceBasis ? { priceBasis: quote.priceBasis } : {}),
111
+ change, changePercent, ...extended,
112
+ ...(yieldIndex && change != null && Number.isFinite(change) ? { changeBasisPoints: toBasisPoints(change, 1) } : {}),
113
+ session: quoteSessionStateLabel(quote, now) ?? "",
114
+ feed: quoteExportFeed(quote, now),
115
+ changeBasis: basis ? changeBasisLabel(basis, now) : "",
116
+ source: quoteSourceName(quote, brokerName),
117
+ marketCap: quote.marketCap ?? null, updatedAt: quoteHeadlineTime(quote),
118
+ ...quoteFreshnessFields(quote, now),
119
+ };
120
+ }