gloomberb 0.20.1 → 0.20.2

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (422) hide show
  1. package/README.md +16 -26
  2. package/README.zh-CN.md +21 -65
  3. package/package.json +1 -1
  4. package/src/account/auth-model.ts +20 -1
  5. package/src/account/upgrade-dialog.tsx +8 -4
  6. package/src/api-client/askg.ts +7 -1
  7. package/src/api-client/auth.ts +27 -0
  8. package/src/api-client/catalysts.ts +2 -0
  9. package/src/api-client/company-kpis.ts +2 -1
  10. package/src/api-client/cot.ts +14 -2
  11. package/src/api-client/data.ts +3 -2
  12. package/src/api-client/earnings.ts +46 -3
  13. package/src/api-client/futures-curve.ts +17 -0
  14. package/src/api-client/index.ts +4 -1
  15. package/src/api-client/one-tap-reasons.ts +42 -0
  16. package/src/api-client/perps.ts +2 -1
  17. package/src/api-client/request.ts +3 -1
  18. package/src/api-client/research-activity.ts +16 -3
  19. package/src/api-client/types/filings-and-calls.ts +3 -0
  20. package/src/api-client/types/search.ts +3 -0
  21. package/src/app/keybindings/chord.ts +153 -9
  22. package/src/app/keybindings/index.ts +1 -1
  23. package/src/app/keybindings/labels.ts +49 -6
  24. package/src/app/runtime/desktop-deeplink.ts +73 -8
  25. package/src/app.tsx +7 -1
  26. package/src/architecture/core-builtin-allowlist.json +1 -2
  27. package/src/architecture/pane-tabs-allowlist.json +2 -1
  28. package/src/architecture/shortcut-labels-allowlist.json +11 -0
  29. package/src/architecture/ui-literals-allowlist.json +8 -8
  30. package/src/brokers/broker-portfolio-sync.ts +1 -1
  31. package/src/cli/bank-section.ts +26 -12
  32. package/src/cli/commands/market.ts +266 -75
  33. package/src/cli/commands/ticker.ts +12 -7
  34. package/src/cli/desktop-pane-shot-browser.ts +47 -31
  35. package/src/cli/desktop-pane-shot.ts +15 -0
  36. package/src/cli/entry.ts +5 -0
  37. package/src/cli/export-source.ts +7 -1
  38. package/src/cli/freshness.ts +0 -16
  39. package/src/cli/fx-pair.ts +64 -12
  40. package/src/cli/fx-quote-rate.ts +144 -0
  41. package/src/cli/glossary.ts +5 -0
  42. package/src/cli/history-back-adjust.ts +122 -0
  43. package/src/cli/history-rows.ts +114 -10
  44. package/src/cli/index.ts +4 -1
  45. package/src/cli/known-gaps.ts +45 -3
  46. package/src/cli/listing-arg.ts +48 -4
  47. package/src/cli/name-entries.ts +25 -5
  48. package/src/cli/pane-functions/catalog.ts +12 -2
  49. package/src/cli/pane-functions/dom.ts +4 -2
  50. package/src/cli/pane-functions/headless.ts +8 -5
  51. package/src/cli/pane-functions/index.ts +3 -0
  52. package/src/cli/pane-functions/resolver.ts +4 -1
  53. package/src/cli/pane-functions/screenshot-assessment.ts +15 -3
  54. package/src/cli/pane-functions/screenshot-payload.ts +130 -66
  55. package/src/cli/pane-functions/screenshot-render.ts +14 -2
  56. package/src/cli/pane-functions/screenshot-types.ts +4 -0
  57. package/src/cli/symbol-rows.ts +22 -2
  58. package/src/cli/ticker-resolution.ts +74 -17
  59. package/src/components/chart/composite/axis-overlays.tsx +13 -3
  60. package/src/components/chart/composite/composite-chart.tsx +8 -1
  61. package/src/components/chart/composite/format.ts +16 -1
  62. package/src/components/chart/composite/legend.tsx +4 -3
  63. package/src/components/chart/composite/panel-labels.ts +2 -1
  64. package/src/components/chart/composite/panel-surface.tsx +33 -4
  65. package/src/components/chart/composite/time-scale.ts +1 -1
  66. package/src/components/chart/composite/toolbar.tsx +8 -4
  67. package/src/components/chart/composite/types.ts +17 -1
  68. package/src/components/chart/composite/use-composite-chart-keyboard.ts +15 -5
  69. package/src/components/chart/composite/use-composite-viewport.ts +31 -8
  70. package/src/components/chart/static/scatter-chart-surface.tsx +25 -9
  71. package/src/components/chart-table/axis.ts +11 -0
  72. package/src/components/command-bar/assist/inventory.ts +3 -2
  73. package/src/components/command-bar/commands/collection-list.ts +3 -2
  74. package/src/components/command-bar/panel/layout.ts +8 -1
  75. package/src/components/command-bar/panel/prompt-width.ts +34 -0
  76. package/src/components/command-bar/panel/state.ts +4 -0
  77. package/src/components/command-bar/routes/root/search-providers.ts +3 -2
  78. package/src/components/command-bar/routes/root/search-report.ts +2 -2
  79. package/src/components/command-bar/workflow/ticker-listing-picker.ts +1 -0
  80. package/src/components/company-logo.tsx +2 -2
  81. package/src/components/data-table/view.tsx +11 -2
  82. package/src/components/feed-data-table/stack-view.tsx +20 -6
  83. package/src/components/feedback-dialog.tsx +3 -1
  84. package/src/components/form-modal/field-row.tsx +1 -1
  85. package/src/components/form-modal/routes.ts +1 -0
  86. package/src/components/index.ts +1 -1
  87. package/src/components/layout/header.tsx +12 -3
  88. package/src/components/layout/market-summary.ts +2 -1
  89. package/src/components/layout/pane/footer/index.tsx +9 -5
  90. package/src/components/layout/pane/footer/model.ts +26 -10
  91. package/src/components/layout/pane/footer/registration.tsx +60 -1
  92. package/src/components/layout/pane/header-tabs.tsx +17 -3
  93. package/src/components/layout/pane/header.tsx +5 -2
  94. package/src/components/layout/pane/pane-tabs.tsx +57 -3
  95. package/src/components/layout/shell/active-drag.ts +38 -30
  96. package/src/components/layout/shell/drag/index.ts +51 -21
  97. package/src/components/layout/shell/menu.ts +3 -5
  98. package/src/components/layout/shell/pane/actions.ts +4 -1
  99. package/src/components/layout/shell/pane/ask.ts +5 -2
  100. package/src/components/layout/status-bar.tsx +59 -54
  101. package/src/components/markdown-text.tsx +35 -10
  102. package/src/components/onboarding/first-run-workspace.ts +25 -23
  103. package/src/components/onboarding/onboarding-keyboard.ts +6 -1
  104. package/src/components/onboarding/onboarding-wizard.tsx +12 -2
  105. package/src/components/onboarding/portfolio-step/positions-panel.tsx +3 -3
  106. package/src/components/onboarding/use-onboarding-broker-form.ts +2 -1
  107. package/src/components/onboarding/use-onboarding-progress.ts +11 -4
  108. package/src/components/onboarding/use-onboarding-upgrade.ts +3 -2
  109. package/src/components/onboarding/wizard-positions.ts +8 -1
  110. package/src/components/pane-notice-seen.ts +125 -0
  111. package/src/components/pane-settings-dialog/field-dialogs.tsx +2 -1
  112. package/src/components/pane-settings-dialog.tsx +7 -6
  113. package/src/components/sign-in-code-panel.tsx +3 -2
  114. package/src/components/speedometer-gauge/terminal.tsx +30 -9
  115. package/src/components/ticker/list-table-view.tsx +39 -3
  116. package/src/components/ui/confirm-dialog.tsx +2 -1
  117. package/src/components/ui/data-table/index.tsx +4 -2
  118. package/src/components/ui/data-table/opentui/index.tsx +15 -5
  119. package/src/components/ui/data-table/types.ts +8 -0
  120. package/src/components/ui/external-link.tsx +4 -1
  121. package/src/components/ui/field-grid.tsx +1 -1
  122. package/src/components/ui/index.ts +2 -0
  123. package/src/components/ui/inline-quick-add.tsx +5 -0
  124. package/src/components/ui/multi-select/dialog.tsx +10 -9
  125. package/src/components/ui/pane-link-chip.tsx +354 -0
  126. package/src/components/ui/query-bar.tsx +22 -13
  127. package/src/components/ui/ratio-bar.tsx +24 -1
  128. package/src/components/ui/select-button.tsx +2 -1
  129. package/src/components/ui/shortcut-hint.tsx +6 -3
  130. package/src/components/ui/table-layout.ts +81 -0
  131. package/src/components/ui/tabs.tsx +45 -6
  132. package/src/components/use-pane-notice-footer.tsx +12 -4
  133. package/src/core/app-service-ports.ts +1 -1
  134. package/src/data/plugin-state-store.ts +44 -8
  135. package/src/docs/snapshot.json +53 -32
  136. package/src/i18n/es.ts +25 -6
  137. package/src/i18n/ja.ts +25 -5
  138. package/src/i18n/ko.ts +25 -5
  139. package/src/i18n/zh-cn.ts +25 -5
  140. package/src/i18n/zh-tw.ts +25 -5
  141. package/src/layout/pane-manager/gridlock-inference.ts +2 -1
  142. package/src/layout/pane-manager/gridlock.ts +47 -2
  143. package/src/layout-marketplace/api.ts +1 -0
  144. package/src/layout-marketplace/gallery.tsx +4 -3
  145. package/src/layout-marketplace/linked.ts +6 -4
  146. package/src/layout-marketplace/model.ts +3 -2
  147. package/src/market-data/futures-contract.ts +77 -31
  148. package/src/market-data/fx-closes.ts +5 -2
  149. package/src/market-data/hooks.tsx +23 -0
  150. package/src/market-data/market/change-basis.ts +72 -14
  151. package/src/market-data/market/format.ts +19 -11
  152. package/src/market-data/market/globex-day.ts +73 -0
  153. package/src/market-data/market/index-level.ts +10 -1
  154. package/src/market-data/quotes/intraday-bar.ts +1 -1
  155. package/src/market-data/quotes/session-split.ts +28 -0
  156. package/src/plugins/builtin/account-management/pane.tsx +1 -1
  157. package/src/plugins/builtin/analytics/account-returns.ts +1 -1
  158. package/src/plugins/builtin/analytics/index.tsx +10 -3
  159. package/src/plugins/builtin/analytics/pane-model.ts +1 -1
  160. package/src/plugins/builtin/analytics/risk-client.ts +4 -1
  161. package/src/plugins/builtin/analytics/risk-episodes.ts +422 -0
  162. package/src/plugins/builtin/analytics/risk-fx.ts +1 -1
  163. package/src/plugins/builtin/analytics/risk-headless.ts +28 -10
  164. package/src/plugins/builtin/analytics/risk-math.ts +1 -1
  165. package/src/plugins/builtin/analytics/risk-model.ts +115 -26
  166. package/src/plugins/builtin/analytics/risk-pane.tsx +201 -23
  167. package/src/plugins/builtin/analytics/sharpe-cadence.ts +1 -1
  168. package/src/plugins/builtin/backtest/format.ts +14 -0
  169. package/src/plugins/builtin/backtest/pane.tsx +3 -3
  170. package/src/plugins/builtin/backtest/report.ts +5 -3
  171. package/src/plugins/builtin/broker-manager/add-request.ts +10 -1
  172. package/src/plugins/builtin/broker-trading/pane.tsx +20 -2
  173. package/src/plugins/builtin/buildout/company/flow.tsx +5 -5
  174. package/src/plugins/builtin/buildout/company/model.ts +14 -2
  175. package/src/plugins/builtin/catalysts/detail.tsx +2 -2
  176. package/src/plugins/builtin/catalysts/model.ts +7 -2
  177. package/src/plugins/builtin/catalysts/pane.tsx +2 -2
  178. package/src/plugins/builtin/chat/message/pane-chip.tsx +36 -208
  179. package/src/plugins/builtin/cloud/askg/answer-follow-ups.tsx +61 -0
  180. package/src/plugins/builtin/cloud/askg/answer-sources.tsx +102 -0
  181. package/src/plugins/builtin/cloud/askg/controller.ts +7 -1
  182. package/src/plugins/builtin/cloud/askg/host.ts +57 -0
  183. package/src/plugins/builtin/cloud/askg/model.ts +45 -5
  184. package/src/plugins/builtin/cloud/askg/pane.tsx +304 -25
  185. package/src/plugins/builtin/cloud/askg/protocol.ts +26 -1
  186. package/src/plugins/builtin/cloud/askg/sources.ts +466 -0
  187. package/src/plugins/builtin/cloud/one-tap/controller.ts +309 -0
  188. package/src/plugins/builtin/cloud/one-tap/google-identity.ts +142 -0
  189. package/src/plugins/builtin/cloud/one-tap/one-tap-prompt.tsx +101 -0
  190. package/src/plugins/builtin/cloud/plugin.tsx +7 -1
  191. package/src/plugins/builtin/company-kpis/client.ts +4 -3
  192. package/src/plugins/builtin/company-kpis/model.ts +34 -3
  193. package/src/plugins/builtin/correlation/index.tsx +39 -167
  194. package/src/plugins/builtin/correlation/matrix/grid.tsx +285 -0
  195. package/src/plugins/builtin/correlation/relationship/pane.tsx +6 -7
  196. package/src/plugins/builtin/correlation/relationship/view-model.ts +14 -5
  197. package/src/plugins/builtin/cot/client.ts +8 -3
  198. package/src/plugins/builtin/cot/headless.ts +65 -12
  199. package/src/plugins/builtin/cot/pane.tsx +11 -5
  200. package/src/plugins/builtin/earnings/client.ts +40 -6
  201. package/src/plugins/builtin/earnings/fiscal-quarter.ts +54 -0
  202. package/src/plugins/builtin/earnings/headless.ts +47 -11
  203. package/src/plugins/builtin/earnings/history-model.ts +136 -24
  204. package/src/plugins/builtin/earnings/history-table.ts +42 -10
  205. package/src/plugins/builtin/earnings/history.tsx +23 -8
  206. package/src/plugins/builtin/earnings-ripple/client.ts +5 -2
  207. package/src/plugins/builtin/earnings-ripple/headless.ts +8 -3
  208. package/src/plugins/builtin/earnings-ripple/model.ts +21 -0
  209. package/src/plugins/builtin/earnings-ripple/pane.tsx +2 -3
  210. package/src/plugins/builtin/econ/index.tsx +5 -4
  211. package/src/plugins/builtin/econ-statistics/stats.ts +13 -5
  212. package/src/plugins/builtin/equity-screener/headless.ts +2 -1
  213. package/src/plugins/builtin/filing-events/feed.ts +56 -18
  214. package/src/plugins/builtin/filing-events/pane.tsx +8 -2
  215. package/src/plugins/builtin/futures/index.tsx +32 -10
  216. package/src/plugins/builtin/futures/model.ts +93 -6
  217. package/src/plugins/builtin/futures/returns.ts +29 -7
  218. package/src/plugins/builtin/futures/table.tsx +59 -17
  219. package/src/plugins/builtin/futures/use-front-returns.ts +32 -6
  220. package/src/plugins/builtin/futures-curve/client.ts +12 -2
  221. package/src/plugins/builtin/futures-curve/headless.ts +58 -17
  222. package/src/plugins/builtin/futures-curve/model.ts +111 -15
  223. package/src/plugins/builtin/futures-curve/pane.tsx +11 -6
  224. package/src/plugins/builtin/fx-matrix/amount.ts +132 -0
  225. package/src/plugins/builtin/fx-matrix/headless.ts +53 -13
  226. package/src/plugins/builtin/fx-matrix/index.tsx +205 -42
  227. package/src/plugins/builtin/fx-matrix/pairs.ts +10 -8
  228. package/src/plugins/builtin/fx-matrix/settings.ts +22 -1
  229. package/src/plugins/builtin/help/index.tsx +68 -61
  230. package/src/plugins/builtin/holders/format.ts +7 -2
  231. package/src/plugins/builtin/holders/pane.tsx +11 -3
  232. package/src/plugins/builtin/holders/report-header.ts +5 -4
  233. package/src/plugins/builtin/holders/report-rows.ts +4 -1
  234. package/src/plugins/builtin/holders/treemap.tsx +5 -3
  235. package/src/plugins/builtin/insider/signals-model.ts +4 -5
  236. package/src/plugins/builtin/ipo-calendar/headless.ts +18 -7
  237. package/src/plugins/builtin/ipo-calendar/listing-ipo.ts +3 -1
  238. package/src/plugins/builtin/ipo-calendar/model.ts +28 -8
  239. package/src/plugins/builtin/ipo-calendar/pane.tsx +2 -1
  240. package/src/plugins/builtin/kelly-sizer/headless.ts +4 -0
  241. package/src/plugins/builtin/perps/headless.ts +73 -17
  242. package/src/plugins/builtin/perps/index.tsx +3 -1
  243. package/src/plugins/builtin/perps/model.ts +1 -1
  244. package/src/plugins/builtin/perps/pane.tsx +2 -0
  245. package/src/plugins/builtin/portfolio-list/cell-version.ts +1 -0
  246. package/src/plugins/builtin/portfolio-list/cli/bulk-symbols.ts +20 -1
  247. package/src/plugins/builtin/portfolio-list/cli/import-positions.ts +260 -0
  248. package/src/plugins/builtin/portfolio-list/cli/period-report.ts +154 -0
  249. package/src/plugins/builtin/portfolio-list/cli/portfolio-command.ts +64 -22
  250. package/src/plugins/builtin/portfolio-list/cli/render.ts +18 -7
  251. package/src/plugins/builtin/portfolio-list/cli/watchlist-command.ts +5 -3
  252. package/src/plugins/builtin/portfolio-list/grid.tsx +56 -12
  253. package/src/plugins/builtin/portfolio-list/headless.ts +128 -0
  254. package/src/plugins/builtin/portfolio-list/pane/index.tsx +42 -4
  255. package/src/plugins/builtin/portfolio-list/pane/period-pnl.ts +124 -0
  256. package/src/plugins/builtin/portfolio-list/period-pnl.ts +179 -0
  257. package/src/plugins/builtin/portfolio-list/positions-import/dialog.tsx +445 -0
  258. package/src/plugins/builtin/portfolio-list/positions-import/index.tsx +255 -0
  259. package/src/plugins/builtin/portfolio-list/positions-import/lookup.ts +78 -0
  260. package/src/plugins/builtin/portfolio-list/positions-import/read-file.ts +32 -0
  261. package/src/plugins/builtin/portfolio-list/quick-add/index.tsx +186 -50
  262. package/src/plugins/builtin/portfolio-list/quick-add/resolution.ts +118 -4
  263. package/src/plugins/builtin/portfolio-list/settings.ts +25 -0
  264. package/src/plugins/builtin/portfolio-list/summary/index.tsx +16 -1
  265. package/src/plugins/builtin/portfolio-list/summary/totals.ts +7 -5
  266. package/src/plugins/builtin/portfolio-list/table.tsx +105 -6
  267. package/src/plugins/builtin/power/headless.ts +47 -9
  268. package/src/plugins/builtin/research/relative-valuation-model.ts +8 -3
  269. package/src/plugins/builtin/research-search/article.ts +12 -2
  270. package/src/plugins/builtin/research-search/data.ts +5 -2
  271. package/src/plugins/builtin/research-search/document-view.tsx +1 -1
  272. package/src/plugins/builtin/research-search/model.ts +47 -3
  273. package/src/plugins/builtin/research-search/pane.tsx +3 -2
  274. package/src/plugins/builtin/reverse-dcf/model.ts +7 -4
  275. package/src/plugins/builtin/risk-factors/headless.ts +3 -2
  276. package/src/plugins/builtin/risk-factors/pane.tsx +5 -3
  277. package/src/plugins/builtin/scanner/flow-model.ts +17 -13
  278. package/src/plugins/builtin/scanner/flow-pane.tsx +8 -9
  279. package/src/plugins/builtin/scanner/flow-session.ts +2 -9
  280. package/src/plugins/builtin/sec/filing-display.tsx +0 -5
  281. package/src/plugins/builtin/sec/forms.ts +19 -0
  282. package/src/plugins/builtin/sec/headless.ts +7 -11
  283. package/src/plugins/builtin/sec/index.tsx +11 -3
  284. package/src/plugins/builtin/shared/earnings-calendar.ts +6 -3
  285. package/src/plugins/builtin/shared/earnings-report.ts +1 -1
  286. package/src/plugins/builtin/shared/fx-rate-freshness.ts +0 -35
  287. package/src/plugins/builtin/shared/use-quote-board.ts +42 -27
  288. package/src/plugins/builtin/supply-chain/graph-model.ts +7 -1
  289. package/src/plugins/builtin/supply-chain/headless.ts +20 -10
  290. package/src/plugins/builtin/supply-chain/model.ts +117 -20
  291. package/src/plugins/builtin/supply-chain/pane.tsx +22 -15
  292. package/src/plugins/builtin/supply-chain/row-evidence.tsx +1 -1
  293. package/src/plugins/builtin/ticker-detail/data-panes/returns-chart-model.ts +69 -0
  294. package/src/plugins/builtin/ticker-detail/data-panes/returns-chart.tsx +118 -0
  295. package/src/plugins/builtin/ticker-detail/data-panes/returns-model.ts +1 -1
  296. package/src/plugins/builtin/ticker-detail/data-panes/returns-pane.tsx +103 -40
  297. package/src/plugins/builtin/ticker-detail/headless-schema.ts +10 -1
  298. package/src/plugins/builtin/ticker-detail/headless.ts +8 -1
  299. package/src/plugins/builtin/ticker-detail/overview/components.tsx +2 -1
  300. package/src/plugins/builtin/ticker-detail/overview/model.ts +4 -2
  301. package/src/plugins/builtin/ticker-detail/overview-tab.tsx +11 -8
  302. package/src/plugins/builtin/ticker-detail/pane.tsx +95 -20
  303. package/src/plugins/builtin/ticker-detail/research-groups.ts +89 -0
  304. package/src/plugins/builtin/ticker-detail/settings.ts +4 -3
  305. package/src/plugins/builtin/volatility/charts.tsx +2 -2
  306. package/src/plugins/host-resolver.ts +3 -2
  307. package/src/portfolio/column-values.ts +42 -8
  308. package/src/portfolio/futures-positions.ts +10 -2
  309. package/src/portfolio/mutations.ts +4 -3
  310. package/src/portfolio/period-pnl.ts +119 -0
  311. package/src/portfolio/positions-import/describe.ts +89 -0
  312. package/src/portfolio/positions-import/parse.ts +682 -0
  313. package/src/portfolio/positions-import/plan.ts +295 -0
  314. package/src/{plugins/builtin/analytics/metrics.ts → portfolio/return-metrics.ts} +24 -11
  315. package/src/public/__snapshots__/public-api.test.ts.snap +1 -0
  316. package/src/react/jsx-dev-fallback.ts +62 -0
  317. package/src/renderers/browser/cloud-transport.ts +1 -1
  318. package/src/renderers/browser/config-host.ts +3 -1
  319. package/src/renderers/browser/deeplink-bridge.ts +8 -1
  320. package/src/renderers/browser/http-proxy-transport.ts +9 -2
  321. package/src/renderers/browser/main.tsx +2 -1
  322. package/src/renderers/browser/research-entry.ts +12 -0
  323. package/src/renderers/cloudflare/http-proxy.ts +8 -2
  324. package/src/renderers/cloudflare/proxy-session.ts +1 -0
  325. package/src/renderers/cloudflare/worker.ts +12 -3
  326. package/src/renderers/dom/desktop/audio-player.tsx +2 -2
  327. package/src/renderers/dom/desktop/controls.tsx +1 -1
  328. package/src/renderers/dom/desktop/dialog-actions.tsx +10 -24
  329. package/src/renderers/dom/desktop/icons.tsx +4 -2
  330. package/src/renderers/dom/desktop/query-bar.tsx +23 -19
  331. package/src/renderers/dom/dom-host-providers.tsx +7 -2
  332. package/src/renderers/dom/host/box.tsx +2 -2
  333. package/src/renderers/dom/host/input.tsx +13 -0
  334. package/src/renderers/dom/key-event.ts +1 -0
  335. package/src/renderers/dom/styles.css +3 -0
  336. package/src/renderers/electrobun/bun/context-menu/click.ts +1 -0
  337. package/src/renderers/electrobun/bun/desktop/backend.ts +1 -0
  338. package/src/renderers/electrobun/bun/desktop/capability-bridge.ts +5 -4
  339. package/src/renderers/electrobun/bun/desktop/host-requests.ts +5 -4
  340. package/src/renderers/electrobun/bun/desktop/http-fetch.ts +1 -0
  341. package/src/renderers/electrobun/bun/desktop/http-stream.ts +1 -1
  342. package/src/renderers/electrobun/bun/desktop/initialization.ts +3 -1
  343. package/src/renderers/electrobun/bun/desktop/install-records.ts +4 -1
  344. package/src/renderers/electrobun/bun/desktop/installer-folder.ts +5 -2
  345. package/src/renderers/electrobun/bun/desktop/macos-objc.ts +3 -1
  346. package/src/renderers/electrobun/bun/desktop/screen-setup-file.ts +9 -4
  347. package/src/renderers/electrobun/bun/desktop/update.ts +27 -13
  348. package/src/renderers/electrobun/bun/desktop/windows-script.ts +6 -2
  349. package/src/renderers/electrobun/bun/window/attention.ts +1 -0
  350. package/src/renderers/electrobun/bun/window/boot-frame.ts +1 -0
  351. package/src/renderers/electrobun/bun/window/create.ts +1 -0
  352. package/src/renderers/electrobun/bun/window/electrobun-window-host.ts +13 -8
  353. package/src/renderers/electrobun/bun/window/native-min-size.ts +1 -1
  354. package/src/renderers/electrobun/bun/window/remembered-frame.ts +1 -0
  355. package/src/renderers/electrobun/bun/window/windows-native.ts +3 -1
  356. package/src/renderers/electrobun/bun/window/windows-quit.ts +3 -1
  357. package/src/renderers/electrobun/view/app-badge-host.ts +2 -1
  358. package/src/renderers/electrobun/view/capability-subscription.ts +2 -1
  359. package/src/renderers/electrobun/view/cli-pane-shot-entry.tsx +7 -10
  360. package/src/renderers/electrobun/view/cli-pane-shot-mutations.ts +36 -0
  361. package/src/renderers/electrobun/view/http-fetch.ts +2 -1
  362. package/src/renderers/electrobun/view/main.tsx +9 -4
  363. package/src/renderers/electrobun/view/remote/capability-invoker.ts +6 -3
  364. package/src/renderers/electrobun/view/remote/persistence.ts +63 -27
  365. package/src/renderers/electrobun/view/rpc-timeout.ts +1 -0
  366. package/src/renderers/electrobun/view/ui-host.tsx +3 -2
  367. package/src/renderers/electrobun/view/window-fullscreen.ts +3 -1
  368. package/src/renderers/opentui/browser-open.ts +2 -1
  369. package/src/renderers/opentui/dialog-host.tsx +1 -1
  370. package/src/renderers/opentui/interaction-performance.ts +3 -1
  371. package/src/renderers/opentui/start.tsx +2 -1
  372. package/src/renderers/opentui/terminal-media.ts +11 -6
  373. package/src/renderers/opentui/ui-host.tsx +5 -8
  374. package/src/shares/open.ts +22 -1
  375. package/src/shares/pane.ts +2 -1
  376. package/src/sources/gloomberb-cloud/normalizers.ts +3 -0
  377. package/src/sync/analytics-payload.ts +194 -0
  378. package/src/sync/baseline.ts +19 -9
  379. package/src/sync/broker-identity.ts +171 -0
  380. package/src/sync/broker-instances.ts +137 -0
  381. package/src/sync/collections-contributor.ts +173 -0
  382. package/src/sync/config-contributor.ts +100 -0
  383. package/src/sync/config-merge.ts +229 -0
  384. package/src/sync/controller.ts +139 -28
  385. package/src/sync/core-contributors.ts +8 -1583
  386. package/src/sync/history-memo.ts +32 -0
  387. package/src/sync/layout-merge.ts +259 -0
  388. package/src/sync/sanitize.ts +114 -0
  389. package/src/sync/ticker-merge.ts +208 -0
  390. package/src/sync/ticker-payload.ts +81 -0
  391. package/src/sync/types.ts +15 -1
  392. package/src/telemetry/attention-setting.ts +1 -1
  393. package/src/telemetry/usage-counts.ts +16 -0
  394. package/src/test-support/preload.ts +5 -0
  395. package/src/theme/color-utils.ts +10 -0
  396. package/src/theme/font-scale.ts +34 -3
  397. package/src/theme/series-colors.ts +44 -0
  398. package/src/theme/themes.ts +2 -1
  399. package/src/tickers/batched-lookups.ts +263 -6
  400. package/src/tickers/company-name-listing.ts +44 -2
  401. package/src/tickers/company-name.ts +7 -2
  402. package/src/tickers/search/upsert.ts +16 -1
  403. package/src/time-series/base-series.ts +18 -4
  404. package/src/time-series/studies/indicators.ts +3 -1
  405. package/src/time-series/studies/resolve.ts +1 -1
  406. package/src/time-series/types.ts +6 -0
  407. package/src/types/financials.ts +18 -0
  408. package/src/types/headless.ts +11 -0
  409. package/src/ui/host.tsx +26 -3
  410. package/src/ui/index.tsx +1 -0
  411. package/src/utils/concurrency.ts +6 -0
  412. package/src/utils/currency-pair.ts +56 -4
  413. package/src/utils/datetime-format.ts +11 -0
  414. package/src/utils/decimal-comma.ts +9 -6
  415. package/src/utils/exchanges.ts +32 -0
  416. package/src/utils/fundamentals.ts +41 -0
  417. package/src/utils/markdown.ts +4 -2
  418. package/src/utils/pasted-lines.ts +14 -0
  419. package/src/utils/price-window.ts +2 -1
  420. package/src/utils/sec-filings.ts +17 -0
  421. package/src/utils/sec.ts +4 -23
  422. package/src/utils/shortcut-labels.ts +6 -30
@@ -0,0 +1,89 @@
1
+ import { ADR_PAIR_TAB_ID } from "./adr-pair/model";
2
+
3
+ /** What the grouping reads of a research tab. */
4
+ export interface TickerResearchTabSummary {
5
+ id: string;
6
+ name: string;
7
+ order: number;
8
+ }
9
+
10
+ interface TickerResearchGroupDef {
11
+ id: string;
12
+ name: string;
13
+ /** Research tab ids, in the order the group offers them. */
14
+ views: readonly string[];
15
+ }
16
+
17
+ /**
18
+ * Ticker Research's top strip, in order. Each group offers its views as
19
+ * choices under the strip; a view is still known by its own tab id everywhere
20
+ * else (saved layouts, a locked pane, `?tab=`, `--tab`, links between tabs,
21
+ * the views people stay on), so the grouping is only how the strip reads.
22
+ *
23
+ * Trade is Chart with the ticket beside it, and closing the ticket goes back
24
+ * to Chart (`ResearchTradeWorkspace`), so it is Chart's second view. ADR vs
25
+ * Home, the receipt's price against its home line, is the last of
26
+ * Financials. Both show only for some tickers, so each comes after the views
27
+ * every ticker has. A plugin's own tab is in no group: it gets its own top
28
+ * tab after these (`groupTickerResearchTabs`).
29
+ */
30
+ const TICKER_RESEARCH_GROUPS: readonly TickerResearchGroupDef[] = [
31
+ { id: "overview", name: "Overview", views: ["overview"] },
32
+ { id: "chart", name: "Chart", views: ["chart", "broker-trade"] },
33
+ { id: "financials", name: "Financials", views: ["financials", "revenue", "equity-diagnostic", "dividend-yield", ADR_PAIR_TAB_ID] },
34
+ { id: "analysts", name: "Analysts", views: ["analyst-research", "earnings-calls"] },
35
+ { id: "options", name: "Options", views: ["options"] },
36
+ { id: "events", name: "Events", views: ["corporate-actions", "catalysts", "mna"] },
37
+ { id: "filings", name: "Filings", views: ["sec", "filing-events", "risk-factors"] },
38
+ { id: "ownership", name: "Ownership", views: ["holders", "insider", "thirteenf", "congress", "short-interest"] },
39
+ { id: "people", name: "People", views: ["executives", "jobs", "hiring-momentum"] },
40
+ { id: "buzz", name: "Buzz", views: ["news", "ticker-tweets", "app-attention"] },
41
+ { id: "notes", name: "Notes", views: ["thesis", "notes"] },
42
+ ];
43
+
44
+ /** One top tab: a group with the views this ticker has, or a view of its own. */
45
+ export interface TickerResearchTabGroup {
46
+ id: string;
47
+ name: string;
48
+ /** At least one; with more, the group shows them as choices. */
49
+ views: TickerResearchTabSummary[];
50
+ }
51
+
52
+ /** A plugin's tab id, kept apart from the group ids. */
53
+ const OWN_GROUP_PREFIX = "tab:";
54
+
55
+ /**
56
+ * The top tabs for the views a ticker has (`buildVisibleTickerResearchTabs`):
57
+ * a group with none of them is left out, and a plugin's tab that belongs to
58
+ * no group is a top tab of its own after the built-in ones, by its `order`.
59
+ */
60
+ export function groupTickerResearchTabs(tabs: readonly TickerResearchTabSummary[]): TickerResearchTabGroup[] {
61
+ const byId = new Map(tabs.map((tab) => [tab.id, tab]));
62
+ const grouped = new Set<string>();
63
+ const groups: TickerResearchTabGroup[] = [];
64
+ for (const group of TICKER_RESEARCH_GROUPS) {
65
+ const views = group.views.flatMap((id) => byId.get(id) ?? []);
66
+ for (const view of views) grouped.add(view.id);
67
+ if (views.length > 0) groups.push({ id: group.id, name: group.name, views });
68
+ }
69
+ const own = tabs.filter((tab) => !grouped.has(tab.id)).sort((left, right) => left.order - right.order);
70
+ for (const tab of own) groups.push({ id: `${OWN_GROUP_PREFIX}${tab.id}`, name: tab.name, views: [tab] });
71
+ return groups;
72
+ }
73
+
74
+ /** The group a view is shown in. */
75
+ export function findTickerResearchGroup(groups: readonly TickerResearchTabGroup[], viewId: string): TickerResearchTabGroup | undefined {
76
+ return groups.find((group) => group.views.some((view) => view.id === viewId));
77
+ }
78
+
79
+ /**
80
+ * Views a group never reopens on. Trade is the order ticket, opened on
81
+ * purpose (`b`/`s`, Overview's order links, choosing it), so coming back to
82
+ * Chart shows the chart.
83
+ */
84
+ const NOT_REOPENED = new Set(["broker-trade"]);
85
+
86
+ /** The view a group opens on: the one last chosen in it while it is there, else its first. */
87
+ export function tickerResearchGroupView(group: TickerResearchTabGroup, remembered: string | undefined): string {
88
+ return remembered && !NOT_REOPENED.has(remembered) && group.views.some((view) => view.id === remembered) ? remembered : group.views[0]!.id;
89
+ }
@@ -6,8 +6,7 @@ import type { PriceSparklinePeriod } from "../../../components/price-sparkline/v
6
6
  import { getSharedRegistry } from "../../registry";
7
7
  import { formatTickerListInput, MAX_TICKER_LIST_SIZE, parseTickerListInput } from "../../../tickers/list";
8
8
  import { resolveTickerInstrumentKind } from "../../../tickers/instrument-kind";
9
-
10
- type TickerResearchTabSummary = { id: string; name: string; order: number };
9
+ import { groupTickerResearchTabs, type TickerResearchTabSummary } from "./research-groups";
11
10
 
12
11
  export interface TickerResearchPaneSettings {
13
12
  hideTabs: boolean;
@@ -49,9 +48,11 @@ function getAvailableSettingsTabs(): TickerResearchTabSummary[] {
49
48
  ? [...registry.tickerResearchTabs.values()].map((tab) => ({ id: tab.id, name: tab.name, order: tab.order }))
50
49
  : [];
51
50
 
52
- return pluginTabs
51
+ const tabs = pluginTabs
53
52
  .sort((left, right) => left.order - right.order)
54
53
  .filter((tab, index, allTabs) => allTabs.findIndex((candidate) => candidate.id === tab.id) === index);
54
+ // In the order the strip shows them: group by group.
55
+ return groupTickerResearchTabs(tabs).flatMap((group) => group.views);
55
56
  }
56
57
 
57
58
  export function buildTickerResearchSettingsDef(settings: TickerResearchPaneSettings): PaneSettingsDef {
@@ -25,8 +25,8 @@ export function VolatilityHistoryChart({ term, width, height, focused = false }:
25
25
  }
26
26
  return <CompositeChart series={series} legendSeries={legendSeries} panels={HISTORY_PANELS} width={width} height={height}
27
27
  focused={focused} navigable={false} showLegend showTimeAxis remoteKind="vix-history"
28
- formatValue={(value, entry) => entry.unitGroup === "ratio" ? value.toFixed(2) : formatCompositeSeriesValue(value, entry)}
29
- formatAxisValue={(value, domain) => domain.unitGroup === "ratio" ? value.toFixed(2) : value.toFixed(0)}
28
+ formatValue={(value, entry) => entry.unitGroup === "ratio" ? `${value.toFixed(2)}x` : formatCompositeSeriesValue(value, entry)}
29
+ formatAxisValue={(value, domain) => domain.unitGroup === "ratio" ? `${value.toFixed(2)}x` : value.toFixed(0)}
30
30
  colors={{ background: palette.bgColor, grid: palette.gridColor, crosshair: palette.crosshairColor, text: colors.text,
31
31
  textDim: palette.axisColor, negative: colors.negative }} />;
32
32
  }
@@ -1,4 +1,5 @@
1
1
  import { PLUGIN_HOST_RESOLVER_IMPORTERS } from "./host-modules";
2
+ import { jsxDevFromJsx } from "../react/jsx-dev-fallback";
2
3
 
3
4
  /**
4
5
  * Serves `gloomberb/*` and `react` to external plugins from inside the
@@ -28,7 +29,7 @@ const JSX_RUNTIME = "react/jsx-runtime";
28
29
 
29
30
  let installed = false;
30
31
 
31
- type JsxFactory = (type: unknown, props: unknown, key?: unknown) => unknown;
32
+ type JsxFactory = Parameters<typeof jsxDevFromJsx>[0];
32
33
 
33
34
  /**
34
35
  * A packaged host is built with `--production`, so its React is the
@@ -42,7 +43,7 @@ async function jsxDevRuntimeExports(): Promise<Record<string, unknown>> {
42
43
  const dev = { ...(await PLUGIN_HOST_RESOLVER_IMPORTERS[JSX_DEV_RUNTIME]!()) } as Record<string, unknown>;
43
44
  if (typeof dev.jsxDEV === "function") return dev;
44
45
  const prod = (await PLUGIN_HOST_RESOLVER_IMPORTERS[JSX_RUNTIME]!()) as { jsx: JsxFactory };
45
- return { ...dev, jsxDEV: (type: unknown, props: unknown, key?: unknown) => prod.jsx(type, props, key) };
46
+ return { ...dev, jsxDEV: jsxDevFromJsx(prod.jsx) };
46
47
  }
47
48
 
48
49
  /** True when this process can register runtime resolvers. */
@@ -6,6 +6,7 @@ import type { ColumnConfig } from "../types/config";
6
6
  import type { AnalystResearchData, CorporateActionsData, MarketState, Quote, TickerFinancials } from "../types/financials";
7
7
  import type { EarningsEvent } from "../types/data-provider";
8
8
  import type { TickerRecord } from "../types/ticker";
9
+ import type { PeriodPnlRow } from "./period-pnl";
9
10
  import { colors, priceColor, shownPriceColor } from "../theme/colors";
10
11
  import { formatQuoteAgeWithSource, resolveQuoteAgeTimestamp } from "../market-data/quotes/time";
11
12
  import { delistingStateLabel } from "../market-data/quotes/delisting";
@@ -36,6 +37,7 @@ import { formatOptionTicker } from "../utils/options";
36
37
  import { distributionHistory, forwardYieldMayHaveLapsed, lapsedDividend } from "../utils/forward-dividend";
37
38
  import { classifyInstrumentType } from "../tickers/instrument-kind";
38
39
  import { isIndexLevel, reportedQuoteVolume } from "../market-data/market/index-level";
40
+ import { futuresQuoteFromSettle } from "../market-data/market/change-basis";
39
41
  import { perpetualDisplaySymbol, perpetualListing } from "../tickers/perpetual-listing";
40
42
  import { premiumToUnderlying, type PerpetualPremiumRow } from "../market-data/perpetual-premium";
41
43
  import { currentListingName } from "../tickers/listing-name";
@@ -115,6 +117,31 @@ export interface ColumnContext {
115
117
  futuresTerms?: ReadonlyMap<string, PortfolioFuturesTerms>;
116
118
  /** Moves whenever `futuresTerms` does. */
117
119
  futuresTermsVersion?: number;
120
+ /**
121
+ * P&L over a period instead of since cost (the pane's P&L From): P&L shows
122
+ * each row's P&L between the two closes and P&L% its contribution to the
123
+ * book. Rows are missing while the closes load (`pending`). `fx` is the
124
+ * currencies' move on the start values, the line under the rows that makes
125
+ * them add up to the header's total.
126
+ */
127
+ periodPnl?: { rows: ReadonlyMap<string, PeriodPnlRow>; pending: boolean; fx?: { currencies: string; pnl: number; contribution: number | null } | null };
128
+ /** Moves whenever `periodPnl` does. */
129
+ periodPnlVersion?: number;
130
+ }
131
+
132
+ /** A row's P&L or contribution over the pane's period: `…` while the closes load, `—` without both. */
133
+ function periodPnlCell(period: NonNullable<ColumnContext["periodPnl"]>, symbol: string, field: "pnl" | "contribution"): { text: string; color?: string } {
134
+ const row = period.rows.get(symbol);
135
+ if (!row) return { text: period.pending ? "…" : "—" };
136
+ return periodPnlFigure(row[field], field);
137
+ }
138
+
139
+ /** A period's P&L (`pnl`) or contribution figure as the P&L and P&L% cells show it, the FX line's included. */
140
+ export function periodPnlFigure(value: number | null | undefined, field: "pnl" | "contribution"): { text: string; color?: string; value?: number } {
141
+ if (value == null || !Number.isFinite(value)) return { text: "—" };
142
+ return field === "pnl"
143
+ ? { text: formatCompactAmount(value, { signed: true }), color: priceColor(value), value }
144
+ : { text: formatPercentRaw(value), color: shownPriceColor(value, 2), value };
118
145
  }
119
146
 
120
147
  /** A row's stock perpetual as PERP% and FUND 8H read it; rates are fractions. */
@@ -477,13 +504,15 @@ export function getColumnValue(
477
504
  financials: TickerFinancials | undefined,
478
505
  ctx: ColumnContext,
479
506
  ): { text: string; color?: string; value?: number | null; pnlBasis?: PortfolioPositionPnl["basis"] } {
480
- const quote = financials?.quote;
507
+ const sent = financials?.quote;
481
508
 
482
509
  const fundamentals = financials?.fundamentals;
483
- const quoteCurrency = quote?.currency || ticker.metadata.currency || "USD";
510
+ const quoteCurrency = sent?.currency || ticker.metadata.currency || "USD";
484
511
 
485
- const { position: positionMetrics, base: baseMetrics } = rowPositionMetrics(ticker, ctx, quoteCurrency, quote);
512
+ const { position: positionMetrics, base: baseMetrics } = rowPositionMetrics(ticker, ctx, quoteCurrency, sent);
486
513
  const futures = positionMetrics.isFuture ? ctx.futuresTerms?.get(ticker.metadata.ticker) : undefined;
514
+ // A future's move as FUT and `quote` measure it with its terms.
515
+ const quote = futuresQuoteFromSettle(sent, futures);
487
516
  // The latest print, which the quote columns read, and the price the position is valued at.
488
517
  const liveQuote = getPortfolioQuoteDisplay(positionMetrics, quote);
489
518
  const activeQuote = getPortfolioValuationDisplay(positionMetrics, quote, ctx.valuationBasis, futures?.settlement);
@@ -662,11 +691,13 @@ export function getColumnValue(
662
691
  }
663
692
  return { text: "—" };
664
693
  case "pnl": {
694
+ if (ctx.periodPnl) return periodPnlCell(ctx.periodPnl, ticker.metadata.ticker, "pnl");
665
695
  const pnl = positionPnl.value;
666
696
  return pnl === null ? { text: "—", pnlBasis: positionPnl.basis }
667
697
  : { text: formatCompactAmount(pnl, { signed: true }), color: priceColor(pnl), pnlBasis: positionPnl.basis };
668
698
  }
669
699
  case "pnl_pct": {
700
+ if (ctx.periodPnl) return periodPnlCell(ctx.periodPnl, ticker.metadata.ticker, "contribution");
670
701
  const percent = portfolioPnlPercent(positionPnl.value, baseMetrics.totalCost);
671
702
  return percent === null ? { text: "—" } : { text: formatPercentRaw(percent), color: shownPriceColor(percent, 2) };
672
703
  }
@@ -750,13 +781,15 @@ export function getSortValue(
750
781
  financials: TickerFinancials | undefined,
751
782
  ctx: ColumnContext,
752
783
  ): number | string | null {
753
- const quote = financials?.quote;
784
+ const sent = financials?.quote;
754
785
 
755
786
  const fundamentals = financials?.fundamentals;
756
- const quoteCurrency = quote?.currency || ticker.metadata.currency || "USD";
787
+ const quoteCurrency = sent?.currency || ticker.metadata.currency || "USD";
757
788
 
758
- const { position: positionMetrics, base: baseMetrics } = rowPositionMetrics(ticker, ctx, quoteCurrency, quote);
789
+ const { position: positionMetrics, base: baseMetrics } = rowPositionMetrics(ticker, ctx, quoteCurrency, sent);
759
790
  const futures = positionMetrics.isFuture ? ctx.futuresTerms?.get(ticker.metadata.ticker) : undefined;
791
+ // A future's move as FUT and `quote` measure it with its terms.
792
+ const quote = futuresQuoteFromSettle(sent, futures);
760
793
  const liveQuote = getPortfolioQuoteDisplay(positionMetrics, quote);
761
794
  const activeQuote = getPortfolioValuationDisplay(positionMetrics, quote, ctx.valuationBasis, futures?.settlement);
762
795
  const displayQuote = tradedQuoteDisplay(positionMetrics, liveQuote, quote);
@@ -860,9 +893,10 @@ export function getSortValue(
860
893
  }
861
894
  return null;
862
895
  case "pnl":
863
- return positionPnl.value;
896
+ return ctx.periodPnl ? ctx.periodPnl.rows.get(ticker.metadata.ticker)?.pnl ?? null : positionPnl.value;
864
897
  case "pnl_pct":
865
- return portfolioPnlPercent(positionPnl.value, baseMetrics.totalCost);
898
+ return ctx.periodPnl ? ctx.periodPnl.rows.get(ticker.metadata.ticker)?.contribution ?? null
899
+ : portfolioPnlPercent(positionPnl.value, baseMetrics.totalCost);
866
900
  case "mark_delta":
867
901
  return liveQuote && brokerMarkPrice != null && liveQuote.price !== 0 && positionMetrics.priceBasis === (quote?.priceBasis ?? "per-unit") && positionCurrency === quoteCurrency
868
902
  ? ((brokerMarkPrice - liveQuote.price) / Math.abs(liveQuote.price)) * 100
@@ -42,6 +42,9 @@ export interface PortfolioFuturesTerms {
42
42
  settlement: FuturesSettlement | null;
43
43
  /** A different contract that is currently front, when the terms name one. */
44
44
  front?: Pick<NonNullable<FuturesContractTermsPayload["front"]>, "contract" | "contractSymbol">;
45
+ /** The tick and the month the settlement is of, which a move is checked against (futuresQuoteFromSettle), as FUT and `quote` check it. */
46
+ spec?: { tick: number } | null;
47
+ deliveryMonth?: string | null;
45
48
  }
46
49
 
47
50
  /** A grain or a soft quotes in US cents, so a dollar point value is a hundred of its price units. */
@@ -169,7 +172,7 @@ export function previousFuturesSettlement(
169
172
 
170
173
  /** What a portfolio reads from a future's terms, with the settlement before the latest when the history has it. */
171
174
  export function portfolioFuturesTerms(
172
- terms: (Pick<FuturesContractTermsPayload, "spec" | "settlement"> & Partial<Pick<FuturesContractTermsPayload, "front" | "contract">>) | null | undefined,
175
+ terms: (Pick<FuturesContractTermsPayload, "spec" | "settlement"> & Partial<Pick<FuturesContractTermsPayload, "front" | "contract" | "deliveryMonth">>) | null | undefined,
173
176
  history?: readonly PricePoint[] | null,
174
177
  ): PortfolioFuturesTerms {
175
178
  const settlement = terms?.settlement && Number.isFinite(terms.settlement.price) && terms.settlement.price > 0
@@ -180,7 +183,12 @@ export function portfolioFuturesTerms(
180
183
  }
181
184
  : null;
182
185
  const front = terms?.front && terms.front.contract !== terms.contract ? terms.front : undefined;
183
- return { size: futuresContractSize(terms?.spec), settlement, ...(front ? { front } : {}) };
186
+ const tick = terms?.spec?.tick;
187
+ return {
188
+ size: futuresContractSize(terms?.spec), settlement, ...(front ? { front } : {}),
189
+ ...(tick != null && Number.isFinite(tick) && tick > 0 ? { spec: { tick } } : {}),
190
+ ...(terms?.deliveryMonth ? { deliveryMonth: terms.deliveryMonth } : {}),
191
+ };
184
192
  }
185
193
 
186
194
  /**
@@ -31,7 +31,8 @@ export interface RemoveTickerFromPortfolioResult {
31
31
  export interface SetManualPortfolioPositionInput {
32
32
  /** Signed: a negative number is a short. A future counts contracts. */
33
33
  shares: number;
34
- avgCost: number;
34
+ /** Null when the cost is not known (a broker export that gives none): the lot is saved without one. */
35
+ avgCost: number | null;
35
36
  currency: string;
36
37
  /**
37
38
  * A future's contract multiplier from its terms (futuresContractSize). Left
@@ -436,7 +437,7 @@ export function setManualPortfolioPosition(
436
437
  const nextCurrency = normalizeHeldCurrencyCode(input.currency);
437
438
  const sharesError = validatePositionShares(input.shares, positionQuantityLabel(ticker));
438
439
  if (sharesError) throw new Error(sharesError);
439
- if (!Number.isFinite(input.avgCost)) {
440
+ if (input.avgCost !== null && !Number.isFinite(input.avgCost)) {
440
441
  throw new Error("Average cost must be a valid number.");
441
442
  }
442
443
  if (!nextCurrency) {
@@ -469,7 +470,7 @@ export function setManualPortfolioPosition(
469
470
  nextPositions.push({
470
471
  portfolio: portfolioId,
471
472
  shares: input.shares,
472
- avgCost: input.avgCost,
473
+ ...(input.avgCost !== null ? { avgCost: input.avgCost } : {}),
473
474
  currency: nextCurrency,
474
475
  broker: "manual",
475
476
  ...(dateAcquired ? { dateAcquired } : {}),
@@ -0,0 +1,119 @@
1
+ /**
2
+ * A book's P&L between two closes, by position: what `portfolio show --from
3
+ * --to` prints and the PF pane's period P&L shows. Each holding is valued at
4
+ * the close before the window starts and at its last close in the window, as
5
+ * RETURN measures a ticker over the same dates, so the two always agree. A
6
+ * future's closes are its settlements, and a contract counts its size. A short
7
+ * gains when the price falls. A holding in another currency earns its price
8
+ * move at the end's FX rate, and the currency's own move on its start value
9
+ * is the separate FX line, so price and currency are never mixed in one figure.
10
+ * A price in a minor unit (pence, US cents) counts in its major currency.
11
+ */
12
+ import { sameCurrency } from "./position-metrics";
13
+ import { heldCurrencyUnit } from "../utils/currency-units";
14
+
15
+ /** A holding's close on a day: a share's regular close, a future's settlement. */
16
+ export interface PeriodClose {
17
+ /** The session's local date. */
18
+ day: string;
19
+ price: number;
20
+ }
21
+
22
+ export interface PeriodPnlHolding {
23
+ symbol: string;
24
+ /** Signed price units held: shares, or contracts times their size; negative for a short. */
25
+ priceUnits: number;
26
+ /** The currency the price is quoted in. */
27
+ currency: string;
28
+ /** The close before the window, and the last one in it; null when the history has none. */
29
+ start: PeriodClose | null;
30
+ end: PeriodClose | null;
31
+ /** The end is today's session still trading, not a close. */
32
+ partialEnd?: boolean;
33
+ }
34
+
35
+ /** One unit of a major currency (GBP, never GBp) in the book's currency on a day; null when no close of the pair could be read. */
36
+ export type PeriodFxRate = (currency: string, day: string) => number | null;
37
+
38
+ export interface PeriodPnlRow {
39
+ symbol: string;
40
+ priceUnits: number;
41
+ currency: string;
42
+ start: PeriodClose | null;
43
+ end: PeriodClose | null;
44
+ partialEnd: boolean;
45
+ /** The price's move over the window, in percent. */
46
+ changePercent: number | null;
47
+ /** The position's value at the start, signed, in the book's currency at the start's rate. */
48
+ startValue: number | null;
49
+ /** The price move times the units held, in the book's currency at the end's rate. */
50
+ pnl: number | null;
51
+ /** The currency's move on the start value; 0 for a holding in the book's currency. */
52
+ fx: number | null;
53
+ /** The start and end rates of a holding in another currency, and the major currency they convert (GBP for a price in pence). */
54
+ rates: { currency: string; start: number; end: number } | null;
55
+ /** The price P&L over the book's start value (`PeriodPnl.contributionBase`), in percent; the FX line carries the currency's. */
56
+ contribution: number | null;
57
+ }
58
+
59
+ export interface PeriodPnl {
60
+ rows: PeriodPnlRow[];
61
+ /** The FX line: every holding's currency move, together. */
62
+ fx: number;
63
+ fxContribution: number | null;
64
+ /** Price P&L and FX together, over the holdings that have both closes. */
65
+ total: number;
66
+ totalContribution: number | null;
67
+ /**
68
+ * What contribution divides by: the book's value at the start, as its
69
+ * weights are, net for a long-only book and gross (longs plus shorts at
70
+ * their absolute value) for one that holds a short.
71
+ */
72
+ contributionBase: number | null;
73
+ contributionBasis: "net" | "gross";
74
+ /** Holdings without a close at one end of the window, or without a rate for their currency. */
75
+ unpriced: string[];
76
+ }
77
+
78
+ const finite = (value: number | null | undefined): value is number => value != null && Number.isFinite(value);
79
+
80
+ /** The major currency a holding's price converts through, and what one unit of its price is worth in the book's currency's unit before FX. */
81
+ export function periodCurrency(currency: string, bookCurrency: string): { currency: string; own: boolean; scale: number } {
82
+ const unit = heldCurrencyUnit(currency);
83
+ const book = heldCurrencyUnit(bookCurrency);
84
+ return { currency: unit.currency || currency, own: sameCurrency(currency, bookCurrency), scale: (book.divisor || 1) / (unit.divisor || 1) };
85
+ }
86
+
87
+ export function periodPnl(holdings: readonly PeriodPnlHolding[], bookCurrency: string, rate: PeriodFxRate): PeriodPnl {
88
+ const unpriced: string[] = [];
89
+ const valued = holdings.map((holding) => {
90
+ const { start, end } = holding;
91
+ // A price in pence counts a hundredth of a pound, converted at GBP's rate.
92
+ const { currency: major, own, scale } = periodCurrency(holding.currency, bookCurrency);
93
+ const startRate = start ? (own ? 1 : rate(major, start.day)) : null;
94
+ const endRate = end ? (own ? 1 : rate(major, end.day)) : null;
95
+ const priced = !!start && !!end && finite(startRate) && finite(endRate);
96
+ if (!priced) unpriced.push(holding.symbol);
97
+ const startValue = start && finite(startRate) ? holding.priceUnits * start.price * scale * startRate : null;
98
+ return {
99
+ symbol: holding.symbol, priceUnits: holding.priceUnits, currency: holding.currency, start, end, partialEnd: !!holding.partialEnd,
100
+ changePercent: start && end && start.price !== 0 ? (end.price / start.price - 1) * 100 : null,
101
+ startValue,
102
+ pnl: priced ? holding.priceUnits * (end!.price - start!.price) * scale * endRate! : null,
103
+ fx: priced ? holding.priceUnits * start!.price * scale * (endRate! - startRate!) : null,
104
+ rates: priced && !own ? { currency: major, start: startRate!, end: endRate! } : null,
105
+ };
106
+ });
107
+ const starts = valued.flatMap((row) => finite(row.startValue) && finite(row.pnl) ? [row.startValue] : []);
108
+ const shorts = starts.some((value) => value < 0);
109
+ const base = starts.length ? starts.reduce((sum, value) => sum + (shorts ? Math.abs(value) : value), 0) : null;
110
+ const contributionBase = finite(base) && base > 0 ? base : null;
111
+ const rows = valued.map((row): PeriodPnlRow => ({
112
+ ...row,
113
+ contribution: contributionBase && finite(row.pnl) ? (row.pnl / contributionBase) * 100 : null,
114
+ }));
115
+ const fx = rows.reduce((sum, row) => sum + (finite(row.fx) ? row.fx : 0), 0);
116
+ const total = rows.reduce((sum, row) => sum + (finite(row.pnl) && finite(row.fx) ? row.pnl + row.fx : 0), 0);
117
+ const share = (value: number) => contributionBase ? (value / contributionBase) * 100 : null;
118
+ return { rows, fx, fxContribution: share(fx), total, totalContribution: share(total), contributionBase, contributionBasis: shorts ? "gross" : "net", unpriced };
119
+ }
@@ -0,0 +1,89 @@
1
+ /**
2
+ * The words a positions import is shown in, the same in `portfolio import`
3
+ * and in the app's preview: where the file comes from, the portfolio it
4
+ * makes, and each row's shares, cost and status.
5
+ */
6
+ import { formatMarketCost, formatMarketCostWithCurrency, formatMarketQuantity, withCurrencyMinorDigits } from "../../market-data/market/format";
7
+ import { POSITIONS_LAYOUT_NAMES, type PositionsLayoutId } from "./parse";
8
+ import { sameCost, type PositionsImportRow } from "./plan";
9
+
10
+ /** The rows a preview lists of each kind; past this many, a line counts the rest. */
11
+ export const PREVIEW_ROWS_SHOWN = 100;
12
+
13
+ /** The broker a recognised export comes from, which names the portfolio it makes. */
14
+ const LAYOUT_PORTFOLIO_NAMES: Readonly<Record<Exclude<PositionsLayoutId, "generic">, string>> = {
15
+ fidelity: "Fidelity",
16
+ schwab: "Schwab",
17
+ vanguard: "Vanguard",
18
+ etrade: "E*TRADE",
19
+ merrill: "Merrill",
20
+ };
21
+
22
+ /** The file's name without its folder; null for standard input. */
23
+ function fileBaseName(path: string | null): string | null {
24
+ if (!path || path === "-") return null;
25
+ return path.split(/[\\/]/).pop() || null;
26
+ }
27
+
28
+ /** The portfolio a file makes when none is named: the broker's name, else the file's. */
29
+ export function defaultImportPortfolioName(layout: PositionsLayoutId, path: string | null): string {
30
+ if (layout !== "generic") return LAYOUT_PORTFOLIO_NAMES[layout];
31
+ return fileBaseName(path)?.replace(/\.[^.]+$/, "").trim() || "Imported positions";
32
+ }
33
+
34
+ /** Where the positions come from, after "from": "the Fidelity positions export", "holdings.csv". */
35
+ export function positionsImportSource(layout: PositionsLayoutId, path: string | null): string {
36
+ if (layout !== "generic") return `the ${POSITIONS_LAYOUT_NAMES[layout]}`;
37
+ return fileBaseName(path) ?? "standard input";
38
+ }
39
+
40
+ export function positionsImportShares(row: PositionsImportRow): string {
41
+ return formatMarketQuantity(row.shares, { assetCategory: row.ticker.metadata.assetCategory });
42
+ }
43
+
44
+ /**
45
+ * Per share in the position's currency: as PF's Avg Cost prints it (158.57,
46
+ * the currency in its own column), or with the currency's sign as `portfolio
47
+ * show` prints it ($158.57). A cost the holding keeps says so, and none is a
48
+ * dash.
49
+ */
50
+ export function positionsImportCost(row: PositionsImportRow, { withCurrency = false }: { withCurrency?: boolean } = {}): string {
51
+ if (row.avgCost === null) return "—";
52
+ const options = { assetCategory: row.ticker.metadata.assetCategory };
53
+ const cost = withCurrency
54
+ ? formatMarketCostWithCurrency(row.avgCost, row.currency, options)
55
+ : formatMarketCost(row.avgCost, withCurrencyMinorDigits(options, row.currency));
56
+ return row.keptCost ? `${cost} (kept)` : cost;
57
+ }
58
+
59
+ /**
60
+ * Whether the rows need a currency column: some are in another currency
61
+ * than the portfolio totals in. A portfolio with no positions yet takes its
62
+ * first position's, so one currency across the rows needs none.
63
+ */
64
+ export function positionsImportShowsCurrency(rows: readonly PositionsImportRow[], portfolioCurrency: string | null): boolean {
65
+ const currencies = new Set(rows.map((row) => row.currency));
66
+ return currencies.size > 1 || (portfolioCurrency !== null && currencies.size === 1 && !currencies.has(portfolioCurrency));
67
+ }
68
+
69
+ /** What the import does to a holding: new, its lots made one, its shares, cost or date changed, or nothing. */
70
+ export function positionsImportStatus(row: PositionsImportRow): string {
71
+ if (row.heldShares === null) return "new";
72
+ if (row.heldLots > 1) return `${row.heldLots} lots → 1`;
73
+ if (row.heldShares !== row.shares) return `was ${formatMarketQuantity(row.heldShares)}`;
74
+ if (!row.keptCost && row.avgCost !== null && (row.heldAvgCost === null || !sameCost(row.heldAvgCost, row.avgCost))) return "new cost";
75
+ if (row.dateAcquired && row.dateAcquired !== row.heldDate) return "new date";
76
+ return "unchanged";
77
+ }
78
+
79
+ /** The line under a skipped list cut at `PREVIEW_ROWS_SHOWN`, or null when it lists them all. */
80
+ export function moreSkippedLine(total: number): string | null {
81
+ const more = total - PREVIEW_ROWS_SHOWN;
82
+ return more > 0 ? `and ${more.toLocaleString("en-US")} more row${more === 1 ? "" : "s"} skipped` : null;
83
+ }
84
+
85
+ /** The line under a positions list cut at `PREVIEW_ROWS_SHOWN`: the rest are imported all the same. */
86
+ export function morePositionsLine(total: number): string | null {
87
+ const more = total - PREVIEW_ROWS_SHOWN;
88
+ return more > 0 ? `and ${more.toLocaleString("en-US")} more position${more === 1 ? "" : "s"}, imported with these` : null;
89
+ }