gloomberb 0.20.0 → 0.20.2

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (481) hide show
  1. package/README.md +16 -26
  2. package/README.zh-CN.md +21 -65
  3. package/package.json +1 -1
  4. package/patches/electrobun-devkit@2.0.5.patch +268 -8
  5. package/src/account/auth-model.ts +20 -1
  6. package/src/account/upgrade-dialog.tsx +8 -4
  7. package/src/api-client/askg.ts +7 -1
  8. package/src/api-client/auth.ts +27 -0
  9. package/src/api-client/catalysts.ts +2 -0
  10. package/src/api-client/company-kpis.ts +2 -1
  11. package/src/api-client/cot.ts +14 -2
  12. package/src/api-client/crypto-markets.ts +20 -2
  13. package/src/api-client/data.ts +3 -2
  14. package/src/api-client/earnings.ts +46 -3
  15. package/src/api-client/fund-facts.ts +23 -1
  16. package/src/api-client/futures-curve.ts +17 -0
  17. package/src/api-client/index.ts +4 -1
  18. package/src/api-client/one-tap-reasons.ts +42 -0
  19. package/src/api-client/perps.ts +2 -1
  20. package/src/api-client/request.ts +3 -1
  21. package/src/api-client/research-activity.ts +16 -3
  22. package/src/api-client/types/filings-and-calls.ts +9 -0
  23. package/src/api-client/types/search.ts +3 -0
  24. package/src/app/keybindings/chord.ts +153 -9
  25. package/src/app/keybindings/index.ts +1 -1
  26. package/src/app/keybindings/labels.ts +49 -6
  27. package/src/app/runtime/desktop-deeplink.ts +73 -8
  28. package/src/app/runtime/plugin-seed.ts +119 -0
  29. package/src/app/runtime/startup.ts +45 -9
  30. package/src/app.tsx +8 -1
  31. package/src/architecture/core-builtin-allowlist.json +1 -2
  32. package/src/architecture/pane-tabs-allowlist.json +2 -1
  33. package/src/architecture/shortcut-labels-allowlist.json +11 -0
  34. package/src/architecture/ui-literals-allowlist.json +8 -8
  35. package/src/brokers/broker-portfolio-sync.ts +1 -1
  36. package/src/cli/bank-section.ts +26 -12
  37. package/src/cli/board-coins.ts +38 -5
  38. package/src/cli/commands/crypto-hints.ts +8 -1
  39. package/src/cli/commands/market.ts +294 -100
  40. package/src/cli/commands/overview.ts +13 -6
  41. package/src/cli/commands/ticker.ts +73 -21
  42. package/src/cli/company-name-hint.ts +19 -0
  43. package/src/cli/desktop-pane-shot-browser.ts +47 -31
  44. package/src/cli/desktop-pane-shot.ts +15 -0
  45. package/src/cli/entry.ts +15 -4
  46. package/src/cli/export-source.ts +7 -1
  47. package/src/cli/freshness.ts +0 -16
  48. package/src/cli/fx-pair.ts +64 -12
  49. package/src/cli/fx-quote-rate.ts +144 -0
  50. package/src/cli/glossary.ts +30 -0
  51. package/src/cli/helpers.ts +4 -2
  52. package/src/cli/history-back-adjust.ts +122 -0
  53. package/src/cli/history-rows.ts +114 -10
  54. package/src/cli/index.ts +4 -1
  55. package/src/cli/known-gaps.ts +45 -3
  56. package/src/cli/listing-arg.ts +48 -4
  57. package/src/cli/name-entries.ts +25 -5
  58. package/src/cli/not-a-ticker.ts +26 -1
  59. package/src/cli/pane-functions/catalog.ts +12 -2
  60. package/src/cli/pane-functions/dom.ts +4 -2
  61. package/src/cli/pane-functions/freshness.ts +45 -29
  62. package/src/cli/pane-functions/headless.ts +8 -5
  63. package/src/cli/pane-functions/index.ts +3 -0
  64. package/src/cli/pane-functions/market-session.ts +14 -5
  65. package/src/cli/pane-functions/resolver.ts +4 -1
  66. package/src/cli/pane-functions/screenshot-assessment.ts +15 -3
  67. package/src/cli/pane-functions/screenshot-payload.ts +130 -66
  68. package/src/cli/pane-functions/screenshot-render.ts +14 -2
  69. package/src/cli/pane-functions/screenshot-types.ts +4 -0
  70. package/src/cli/restore-plugins.ts +164 -51
  71. package/src/cli/symbol-rows.ts +22 -2
  72. package/src/cli/ticker-resolution.ts +74 -17
  73. package/src/components/chart/composite/axis-overlays.tsx +13 -3
  74. package/src/components/chart/composite/composite-chart.tsx +8 -1
  75. package/src/components/chart/composite/format.ts +16 -1
  76. package/src/components/chart/composite/legend.tsx +4 -3
  77. package/src/components/chart/composite/panel-labels.ts +2 -1
  78. package/src/components/chart/composite/panel-surface.tsx +33 -4
  79. package/src/components/chart/composite/time-scale.ts +1 -1
  80. package/src/components/chart/composite/toolbar.tsx +8 -4
  81. package/src/components/chart/composite/types.ts +17 -1
  82. package/src/components/chart/composite/use-composite-chart-keyboard.ts +15 -5
  83. package/src/components/chart/composite/use-composite-viewport.ts +31 -8
  84. package/src/components/chart/static/scatter-chart-surface.tsx +25 -9
  85. package/src/components/chart-table/axis.ts +11 -0
  86. package/src/components/chart-table/header.tsx +10 -1
  87. package/src/components/chart-table/layout.ts +14 -5
  88. package/src/components/command-bar/assist/inventory.ts +3 -2
  89. package/src/components/command-bar/commands/collection-list.ts +3 -2
  90. package/src/components/command-bar/panel/index.tsx +13 -0
  91. package/src/components/command-bar/panel/layout.ts +15 -1
  92. package/src/components/command-bar/panel/prompt-width.ts +34 -0
  93. package/src/components/command-bar/panel/runtime.ts +1 -0
  94. package/src/components/command-bar/panel/state.ts +4 -0
  95. package/src/components/command-bar/panel/types.ts +2 -0
  96. package/src/components/command-bar/routes/root/search-providers.ts +3 -2
  97. package/src/components/command-bar/routes/root/search-report.ts +2 -2
  98. package/src/components/command-bar/workflow/ticker-listing-picker.ts +1 -0
  99. package/src/components/company-logo.tsx +2 -2
  100. package/src/components/data-table/view.tsx +11 -2
  101. package/src/components/feed-data-table/stack-view.tsx +20 -6
  102. package/src/components/feedback-dialog.tsx +3 -1
  103. package/src/components/form-modal/field-row.tsx +1 -1
  104. package/src/components/form-modal/routes.ts +1 -0
  105. package/src/components/index.ts +1 -1
  106. package/src/components/layout/header.tsx +12 -3
  107. package/src/components/layout/market-summary.ts +2 -1
  108. package/src/components/layout/pane/footer/index.tsx +9 -5
  109. package/src/components/layout/pane/footer/model.ts +26 -10
  110. package/src/components/layout/pane/footer/registration.tsx +60 -1
  111. package/src/components/layout/pane/header-tabs.tsx +17 -3
  112. package/src/components/layout/pane/header.tsx +5 -2
  113. package/src/components/layout/pane/pane-tabs.tsx +57 -3
  114. package/src/components/layout/shell/active-drag.ts +38 -30
  115. package/src/components/layout/shell/drag/index.ts +51 -21
  116. package/src/components/layout/shell/menu.ts +3 -5
  117. package/src/components/layout/shell/pane/actions.ts +4 -1
  118. package/src/components/layout/shell/pane/ask.ts +5 -2
  119. package/src/components/layout/status-bar.tsx +59 -54
  120. package/src/components/markdown-text.tsx +35 -10
  121. package/src/components/onboarding/first-run-workspace.ts +25 -23
  122. package/src/components/onboarding/onboarding-keyboard.ts +6 -1
  123. package/src/components/onboarding/onboarding-wizard.tsx +12 -2
  124. package/src/components/onboarding/portfolio-step/positions-panel.tsx +3 -3
  125. package/src/components/onboarding/use-onboarding-broker-form.ts +2 -1
  126. package/src/components/onboarding/use-onboarding-progress.ts +11 -4
  127. package/src/components/onboarding/use-onboarding-upgrade.ts +3 -2
  128. package/src/components/onboarding/wizard-positions.ts +8 -1
  129. package/src/components/pane-notice-seen.ts +125 -0
  130. package/src/components/pane-settings-dialog/field-dialogs.tsx +2 -1
  131. package/src/components/pane-settings-dialog.tsx +7 -6
  132. package/src/components/sign-in-code-panel.tsx +3 -2
  133. package/src/components/speedometer-gauge/terminal.tsx +30 -9
  134. package/src/components/ticker/list-table-view.tsx +39 -3
  135. package/src/components/ui/confirm-dialog.tsx +2 -1
  136. package/src/components/ui/data-table/index.tsx +4 -2
  137. package/src/components/ui/data-table/opentui/index.tsx +15 -5
  138. package/src/components/ui/data-table/types.ts +8 -0
  139. package/src/components/ui/external-link.tsx +4 -1
  140. package/src/components/ui/field-grid.tsx +1 -1
  141. package/src/components/ui/index.ts +2 -0
  142. package/src/components/ui/inline-quick-add.tsx +5 -0
  143. package/src/components/ui/multi-select/dialog.tsx +10 -9
  144. package/src/components/ui/pane-link-chip.tsx +354 -0
  145. package/src/components/ui/query-bar.tsx +22 -13
  146. package/src/components/ui/ratio-bar.tsx +24 -1
  147. package/src/components/ui/select-button.tsx +2 -1
  148. package/src/components/ui/shortcut-hint.tsx +6 -3
  149. package/src/components/ui/table-layout.ts +81 -0
  150. package/src/components/ui/tabs.tsx +45 -6
  151. package/src/components/use-pane-notice-footer.tsx +12 -4
  152. package/src/core/app-service-ports.ts +1 -1
  153. package/src/data/plugin-state-store.ts +44 -8
  154. package/src/docs/snapshot.json +53 -32
  155. package/src/i18n/es.ts +28 -6
  156. package/src/i18n/ja.ts +28 -5
  157. package/src/i18n/ko.ts +28 -5
  158. package/src/i18n/zh-cn.ts +28 -5
  159. package/src/i18n/zh-tw.ts +28 -5
  160. package/src/layout/pane-manager/gridlock-inference.ts +2 -1
  161. package/src/layout/pane-manager/gridlock.ts +47 -2
  162. package/src/layout-marketplace/api.ts +1 -0
  163. package/src/layout-marketplace/gallery.tsx +4 -3
  164. package/src/layout-marketplace/linked.ts +6 -4
  165. package/src/layout-marketplace/model.ts +3 -2
  166. package/src/market-data/fund-facts.ts +7 -1
  167. package/src/market-data/futures-contract.ts +77 -31
  168. package/src/market-data/fx-closes.ts +5 -2
  169. package/src/market-data/hooks.tsx +23 -0
  170. package/src/market-data/market/change-basis.ts +92 -14
  171. package/src/market-data/market/format.ts +81 -13
  172. package/src/market-data/market/futures-week.ts +3 -1
  173. package/src/market-data/market/globex-day.ts +73 -0
  174. package/src/market-data/market/index-level.ts +10 -1
  175. package/src/market-data/quotes/intraday-bar.ts +1 -1
  176. package/src/market-data/quotes/session-split.ts +28 -0
  177. package/src/plugins/builtin/account-management/pane.tsx +1 -1
  178. package/src/plugins/builtin/analytics/account-returns.ts +1 -1
  179. package/src/plugins/builtin/analytics/index.tsx +10 -3
  180. package/src/plugins/builtin/analytics/pane-model.ts +1 -1
  181. package/src/plugins/builtin/analytics/risk-client.ts +4 -1
  182. package/src/plugins/builtin/analytics/risk-episodes.ts +422 -0
  183. package/src/plugins/builtin/analytics/risk-fx.ts +1 -1
  184. package/src/plugins/builtin/analytics/risk-headless.ts +28 -10
  185. package/src/plugins/builtin/analytics/risk-math.ts +1 -1
  186. package/src/plugins/builtin/analytics/risk-model.ts +115 -26
  187. package/src/plugins/builtin/analytics/risk-pane.tsx +201 -23
  188. package/src/plugins/builtin/analytics/sharpe-cadence.ts +1 -1
  189. package/src/plugins/builtin/backtest/format.ts +14 -0
  190. package/src/plugins/builtin/backtest/pane.tsx +3 -3
  191. package/src/plugins/builtin/backtest/report.ts +5 -3
  192. package/src/plugins/builtin/broker-manager/add-request.ts +10 -1
  193. package/src/plugins/builtin/broker-trading/pane.tsx +20 -2
  194. package/src/plugins/builtin/buildout/company/flow.tsx +5 -5
  195. package/src/plugins/builtin/buildout/company/model.ts +14 -2
  196. package/src/plugins/builtin/catalysts/detail.tsx +2 -2
  197. package/src/plugins/builtin/catalysts/model.ts +7 -2
  198. package/src/plugins/builtin/catalysts/pane.tsx +2 -2
  199. package/src/plugins/builtin/chart-composer/headless.ts +57 -17
  200. package/src/plugins/builtin/chart-composer/session-range.ts +82 -3
  201. package/src/plugins/builtin/chat/message/pane-chip.tsx +36 -208
  202. package/src/plugins/builtin/cloud/askg/answer-follow-ups.tsx +61 -0
  203. package/src/plugins/builtin/cloud/askg/answer-sources.tsx +102 -0
  204. package/src/plugins/builtin/cloud/askg/controller.ts +7 -1
  205. package/src/plugins/builtin/cloud/askg/host.ts +57 -0
  206. package/src/plugins/builtin/cloud/askg/model.ts +45 -5
  207. package/src/plugins/builtin/cloud/askg/pane.tsx +304 -25
  208. package/src/plugins/builtin/cloud/askg/protocol.ts +26 -1
  209. package/src/plugins/builtin/cloud/askg/sources.ts +466 -0
  210. package/src/plugins/builtin/cloud/one-tap/controller.ts +309 -0
  211. package/src/plugins/builtin/cloud/one-tap/google-identity.ts +142 -0
  212. package/src/plugins/builtin/cloud/one-tap/one-tap-prompt.tsx +101 -0
  213. package/src/plugins/builtin/cloud/plugin.tsx +7 -1
  214. package/src/plugins/builtin/company-kpis/client.ts +4 -3
  215. package/src/plugins/builtin/company-kpis/model.ts +34 -3
  216. package/src/plugins/builtin/correlation/compute.ts +8 -2
  217. package/src/plugins/builtin/correlation/headless.ts +10 -9
  218. package/src/plugins/builtin/correlation/history.ts +30 -0
  219. package/src/plugins/builtin/correlation/index.tsx +39 -167
  220. package/src/plugins/builtin/correlation/matrix/grid.tsx +285 -0
  221. package/src/plugins/builtin/correlation/matrix/model.ts +10 -10
  222. package/src/plugins/builtin/correlation/relationship/model.ts +3 -6
  223. package/src/plugins/builtin/correlation/relationship/pane.tsx +7 -9
  224. package/src/plugins/builtin/correlation/relationship/view-model.ts +14 -5
  225. package/src/plugins/builtin/cot/client.ts +8 -3
  226. package/src/plugins/builtin/cot/headless.ts +65 -12
  227. package/src/plugins/builtin/cot/pane.tsx +11 -5
  228. package/src/plugins/builtin/crypto-board/client.ts +6 -1
  229. package/src/plugins/builtin/crypto-board/defi-view.tsx +12 -1
  230. package/src/plugins/builtin/crypto-board/defi.ts +44 -7
  231. package/src/plugins/builtin/crypto-board/headless.ts +83 -12
  232. package/src/plugins/builtin/crypto-board/model.ts +30 -6
  233. package/src/plugins/builtin/crypto-board/pane.tsx +13 -2
  234. package/src/plugins/builtin/earnings/client.ts +40 -6
  235. package/src/plugins/builtin/earnings/fiscal-quarter.ts +54 -0
  236. package/src/plugins/builtin/earnings/headless.ts +47 -11
  237. package/src/plugins/builtin/earnings/history-model.ts +136 -24
  238. package/src/plugins/builtin/earnings/history-table.ts +42 -10
  239. package/src/plugins/builtin/earnings/history.tsx +23 -8
  240. package/src/plugins/builtin/earnings-ripple/client.ts +5 -2
  241. package/src/plugins/builtin/earnings-ripple/headless.ts +8 -3
  242. package/src/plugins/builtin/earnings-ripple/model.ts +21 -0
  243. package/src/plugins/builtin/earnings-ripple/pane.tsx +2 -3
  244. package/src/plugins/builtin/econ/index.tsx +5 -4
  245. package/src/plugins/builtin/econ-statistics/stats.ts +13 -5
  246. package/src/plugins/builtin/equity-screener/headless.ts +2 -1
  247. package/src/plugins/builtin/filing-events/feed.ts +56 -18
  248. package/src/plugins/builtin/filing-events/pane.tsx +8 -2
  249. package/src/plugins/builtin/futures/index.tsx +32 -10
  250. package/src/plugins/builtin/futures/model.ts +93 -6
  251. package/src/plugins/builtin/futures/returns.ts +29 -7
  252. package/src/plugins/builtin/futures/table.tsx +59 -17
  253. package/src/plugins/builtin/futures/use-front-returns.ts +32 -6
  254. package/src/plugins/builtin/futures-curve/client.ts +12 -2
  255. package/src/plugins/builtin/futures-curve/headless.ts +58 -17
  256. package/src/plugins/builtin/futures-curve/model.ts +111 -15
  257. package/src/plugins/builtin/futures-curve/pane.tsx +11 -6
  258. package/src/plugins/builtin/fx-matrix/amount.ts +132 -0
  259. package/src/plugins/builtin/fx-matrix/headless.ts +53 -13
  260. package/src/plugins/builtin/fx-matrix/index.tsx +205 -42
  261. package/src/plugins/builtin/fx-matrix/pairs.ts +10 -8
  262. package/src/plugins/builtin/fx-matrix/settings.ts +22 -1
  263. package/src/plugins/builtin/help/index.tsx +68 -61
  264. package/src/plugins/builtin/holders/format.ts +7 -2
  265. package/src/plugins/builtin/holders/pane.tsx +11 -3
  266. package/src/plugins/builtin/holders/report-header.ts +5 -4
  267. package/src/plugins/builtin/holders/report-rows.ts +4 -1
  268. package/src/plugins/builtin/holders/treemap.tsx +5 -3
  269. package/src/plugins/builtin/insider/signals-model.ts +4 -5
  270. package/src/plugins/builtin/ipo-calendar/headless.ts +18 -7
  271. package/src/plugins/builtin/ipo-calendar/listing-ipo.ts +3 -1
  272. package/src/plugins/builtin/ipo-calendar/model.ts +28 -8
  273. package/src/plugins/builtin/ipo-calendar/pane.tsx +2 -1
  274. package/src/plugins/builtin/kelly-sizer/headless.ts +4 -0
  275. package/src/plugins/builtin/perps/headless.ts +81 -19
  276. package/src/plugins/builtin/perps/index.tsx +3 -1
  277. package/src/plugins/builtin/perps/model.ts +1 -1
  278. package/src/plugins/builtin/perps/pane.tsx +2 -0
  279. package/src/plugins/builtin/portfolio-list/cell-version.ts +1 -0
  280. package/src/plugins/builtin/portfolio-list/cli/bulk-symbols.ts +20 -1
  281. package/src/plugins/builtin/portfolio-list/cli/import-positions.ts +260 -0
  282. package/src/plugins/builtin/portfolio-list/cli/period-report.ts +154 -0
  283. package/src/plugins/builtin/portfolio-list/cli/portfolio-command.ts +64 -22
  284. package/src/plugins/builtin/portfolio-list/cli/render.ts +18 -7
  285. package/src/plugins/builtin/portfolio-list/cli/watchlist-command.ts +5 -3
  286. package/src/plugins/builtin/portfolio-list/grid.tsx +56 -12
  287. package/src/plugins/builtin/portfolio-list/headless.ts +128 -0
  288. package/src/plugins/builtin/portfolio-list/pane/index.tsx +42 -4
  289. package/src/plugins/builtin/portfolio-list/pane/period-pnl.ts +124 -0
  290. package/src/plugins/builtin/portfolio-list/period-pnl.ts +179 -0
  291. package/src/plugins/builtin/portfolio-list/positions-import/dialog.tsx +445 -0
  292. package/src/plugins/builtin/portfolio-list/positions-import/index.tsx +255 -0
  293. package/src/plugins/builtin/portfolio-list/positions-import/lookup.ts +78 -0
  294. package/src/plugins/builtin/portfolio-list/positions-import/read-file.ts +32 -0
  295. package/src/plugins/builtin/portfolio-list/quick-add/index.tsx +186 -50
  296. package/src/plugins/builtin/portfolio-list/quick-add/resolution.ts +118 -4
  297. package/src/plugins/builtin/portfolio-list/settings.ts +25 -0
  298. package/src/plugins/builtin/portfolio-list/summary/index.tsx +16 -1
  299. package/src/plugins/builtin/portfolio-list/summary/totals.ts +7 -5
  300. package/src/plugins/builtin/portfolio-list/table.tsx +105 -6
  301. package/src/plugins/builtin/power/headless.ts +47 -9
  302. package/src/plugins/builtin/research/relative-valuation-model.ts +8 -3
  303. package/src/plugins/builtin/research-search/article.ts +12 -2
  304. package/src/plugins/builtin/research-search/data.ts +5 -2
  305. package/src/plugins/builtin/research-search/document-view.tsx +1 -1
  306. package/src/plugins/builtin/research-search/model.ts +47 -3
  307. package/src/plugins/builtin/research-search/pane.tsx +3 -2
  308. package/src/plugins/builtin/reverse-dcf/model.ts +7 -4
  309. package/src/plugins/builtin/risk-factors/headless.ts +3 -2
  310. package/src/plugins/builtin/risk-factors/index.tsx +2 -28
  311. package/src/plugins/builtin/risk-factors/lock-note.ts +58 -0
  312. package/src/plugins/builtin/risk-factors/pane.tsx +14 -5
  313. package/src/plugins/builtin/scanner/flow-model.ts +17 -13
  314. package/src/plugins/builtin/scanner/flow-pane.tsx +8 -9
  315. package/src/plugins/builtin/scanner/flow-session.ts +2 -9
  316. package/src/plugins/builtin/scanner/hilo-model.ts +4 -3
  317. package/src/plugins/builtin/sec/filing-display.tsx +0 -5
  318. package/src/plugins/builtin/sec/forms.ts +19 -0
  319. package/src/plugins/builtin/sec/fund-facts.ts +45 -11
  320. package/src/plugins/builtin/sec/headless.ts +37 -12
  321. package/src/plugins/builtin/sec/index.tsx +37 -8
  322. package/src/plugins/builtin/shared/earnings-calendar.ts +6 -3
  323. package/src/plugins/builtin/shared/earnings-report.ts +1 -1
  324. package/src/plugins/builtin/shared/fx-rate-freshness.ts +0 -35
  325. package/src/plugins/builtin/shared/pro-lock-note.ts +5 -1
  326. package/src/plugins/builtin/shared/use-quote-board.ts +42 -27
  327. package/src/plugins/builtin/supply-chain/graph-model.ts +7 -1
  328. package/src/plugins/builtin/supply-chain/headless.ts +20 -10
  329. package/src/plugins/builtin/supply-chain/model.ts +117 -20
  330. package/src/plugins/builtin/supply-chain/pane.tsx +22 -15
  331. package/src/plugins/builtin/supply-chain/row-evidence.tsx +1 -1
  332. package/src/plugins/builtin/ticker-detail/data-panes/returns-chart-model.ts +69 -0
  333. package/src/plugins/builtin/ticker-detail/data-panes/returns-chart.tsx +118 -0
  334. package/src/plugins/builtin/ticker-detail/data-panes/returns-model.ts +1 -1
  335. package/src/plugins/builtin/ticker-detail/data-panes/returns-pane.tsx +103 -40
  336. package/src/plugins/builtin/ticker-detail/headless-schema.ts +10 -1
  337. package/src/plugins/builtin/ticker-detail/headless.ts +8 -1
  338. package/src/plugins/builtin/ticker-detail/overview/components.tsx +2 -1
  339. package/src/plugins/builtin/ticker-detail/overview/model.ts +18 -8
  340. package/src/plugins/builtin/ticker-detail/overview-tab.tsx +11 -8
  341. package/src/plugins/builtin/ticker-detail/pane.tsx +95 -20
  342. package/src/plugins/builtin/ticker-detail/research-groups.ts +89 -0
  343. package/src/plugins/builtin/ticker-detail/settings.ts +4 -3
  344. package/src/plugins/builtin/time-sales/headless.ts +23 -7
  345. package/src/plugins/builtin/time-sales/index.tsx +2 -2
  346. package/src/plugins/builtin/volatility/charts.tsx +2 -2
  347. package/src/plugins/extracted-plugins.ts +49 -24
  348. package/src/plugins/host-resolver.ts +3 -2
  349. package/src/plugins/installer.ts +220 -31
  350. package/src/plugins/running-installs.ts +34 -0
  351. package/src/plugins/seed-progress.ts +72 -0
  352. package/src/portfolio/column-values.ts +42 -8
  353. package/src/portfolio/futures-positions.ts +10 -2
  354. package/src/portfolio/mutations.ts +4 -3
  355. package/src/portfolio/period-pnl.ts +119 -0
  356. package/src/portfolio/positions-import/describe.ts +89 -0
  357. package/src/portfolio/positions-import/parse.ts +682 -0
  358. package/src/portfolio/positions-import/plan.ts +295 -0
  359. package/src/{plugins/builtin/analytics/metrics.ts → portfolio/return-metrics.ts} +24 -11
  360. package/src/public/__snapshots__/public-api.test.ts.snap +1 -0
  361. package/src/react/jsx-dev-fallback.ts +62 -0
  362. package/src/renderers/browser/cloud-transport.ts +1 -1
  363. package/src/renderers/browser/config-host.ts +3 -1
  364. package/src/renderers/browser/deeplink-bridge.ts +8 -1
  365. package/src/renderers/browser/http-proxy-transport.ts +9 -2
  366. package/src/renderers/browser/main.tsx +2 -1
  367. package/src/renderers/browser/research-entry.ts +12 -0
  368. package/src/renderers/cloudflare/http-proxy.ts +8 -2
  369. package/src/renderers/cloudflare/proxy-session.ts +1 -0
  370. package/src/renderers/cloudflare/worker.ts +12 -3
  371. package/src/renderers/dom/desktop/audio-player.tsx +2 -2
  372. package/src/renderers/dom/desktop/controls.tsx +1 -1
  373. package/src/renderers/dom/desktop/dialog-actions.tsx +10 -24
  374. package/src/renderers/dom/desktop/icons.tsx +4 -2
  375. package/src/renderers/dom/desktop/query-bar.tsx +23 -19
  376. package/src/renderers/dom/dom-host-providers.tsx +7 -2
  377. package/src/renderers/dom/host/box.tsx +2 -2
  378. package/src/renderers/dom/host/input.tsx +13 -0
  379. package/src/renderers/dom/key-event.ts +1 -0
  380. package/src/renderers/dom/styles.css +3 -0
  381. package/src/renderers/electrobun/bun/context-menu/click.ts +1 -0
  382. package/src/renderers/electrobun/bun/desktop/backend.ts +15 -0
  383. package/src/renderers/electrobun/bun/desktop/capability-bridge.ts +5 -4
  384. package/src/renderers/electrobun/bun/desktop/host-requests.ts +19 -11
  385. package/src/renderers/electrobun/bun/desktop/http-fetch.ts +1 -0
  386. package/src/renderers/electrobun/bun/desktop/http-stream.ts +1 -1
  387. package/src/renderers/electrobun/bun/desktop/initialization.ts +27 -15
  388. package/src/renderers/electrobun/bun/desktop/install-records.ts +4 -1
  389. package/src/renderers/electrobun/bun/desktop/installer-folder.ts +5 -2
  390. package/src/renderers/electrobun/bun/desktop/macos-objc.ts +3 -1
  391. package/src/renderers/electrobun/bun/desktop/screen-setup-file.ts +9 -4
  392. package/src/renderers/electrobun/bun/desktop/update.ts +27 -13
  393. package/src/renderers/electrobun/bun/desktop/windows-script.ts +6 -2
  394. package/src/renderers/electrobun/bun/index.ts +5 -0
  395. package/src/renderers/electrobun/bun/window/attention.ts +1 -0
  396. package/src/renderers/electrobun/bun/window/boot-frame.ts +1 -0
  397. package/src/renderers/electrobun/bun/window/context-menu-thread.ts +84 -0
  398. package/src/renderers/electrobun/bun/window/create.ts +1 -0
  399. package/src/renderers/electrobun/bun/window/electrobun-window-host.ts +13 -8
  400. package/src/renderers/electrobun/bun/window/native-call-thread.ts +224 -0
  401. package/src/renderers/electrobun/bun/window/native-min-size.ts +1 -1
  402. package/src/renderers/electrobun/bun/window/native-timing.ts +10 -0
  403. package/src/renderers/electrobun/bun/window/remembered-frame.ts +1 -0
  404. package/src/renderers/electrobun/bun/window/script-for-webview.ts +15 -0
  405. package/src/renderers/electrobun/bun/window/webview-script-thread.ts +82 -0
  406. package/src/renderers/electrobun/bun/window/windows-native.ts +3 -1
  407. package/src/renderers/electrobun/bun/window/windows-quit.ts +3 -1
  408. package/src/renderers/electrobun/shared/protocol.ts +13 -2
  409. package/src/renderers/electrobun/view/app-badge-host.ts +2 -1
  410. package/src/renderers/electrobun/view/backend-rpc.ts +7 -0
  411. package/src/renderers/electrobun/view/capability-subscription.ts +2 -1
  412. package/src/renderers/electrobun/view/cli-pane-shot-entry.tsx +7 -10
  413. package/src/renderers/electrobun/view/cli-pane-shot-frame.tsx +1 -1
  414. package/src/renderers/electrobun/view/cli-pane-shot-mutations.ts +36 -0
  415. package/src/renderers/electrobun/view/http-fetch.ts +2 -1
  416. package/src/renderers/electrobun/view/main.tsx +13 -7
  417. package/src/renderers/electrobun/view/remote/capability-invoker.ts +6 -3
  418. package/src/renderers/electrobun/view/remote/persistence.ts +63 -27
  419. package/src/renderers/electrobun/view/rpc-timeout.ts +1 -0
  420. package/src/renderers/electrobun/view/ui-host.tsx +3 -2
  421. package/src/renderers/electrobun/view/window-fullscreen.ts +3 -1
  422. package/src/renderers/opentui/browser-open.ts +2 -1
  423. package/src/renderers/opentui/dialog-host.tsx +1 -1
  424. package/src/renderers/opentui/interaction-performance.ts +3 -1
  425. package/src/renderers/opentui/start.tsx +5 -1
  426. package/src/renderers/opentui/terminal-media.ts +11 -6
  427. package/src/renderers/opentui/ui-host.tsx +5 -8
  428. package/src/shares/open.ts +22 -1
  429. package/src/shares/pane.ts +2 -1
  430. package/src/sources/gloomberb-cloud/normalizers.ts +3 -0
  431. package/src/sync/analytics-payload.ts +194 -0
  432. package/src/sync/baseline.ts +19 -9
  433. package/src/sync/broker-identity.ts +171 -0
  434. package/src/sync/broker-instances.ts +137 -0
  435. package/src/sync/collections-contributor.ts +173 -0
  436. package/src/sync/config-contributor.ts +100 -0
  437. package/src/sync/config-merge.ts +229 -0
  438. package/src/sync/controller.ts +139 -28
  439. package/src/sync/core-contributors.ts +8 -1583
  440. package/src/sync/history-memo.ts +32 -0
  441. package/src/sync/layout-merge.ts +259 -0
  442. package/src/sync/sanitize.ts +114 -0
  443. package/src/sync/ticker-merge.ts +208 -0
  444. package/src/sync/ticker-payload.ts +81 -0
  445. package/src/sync/types.ts +15 -1
  446. package/src/telemetry/attention-setting.ts +1 -1
  447. package/src/telemetry/stall-reports.ts +21 -4
  448. package/src/telemetry/usage-counts.ts +16 -0
  449. package/src/test-support/preload.ts +5 -0
  450. package/src/theme/color-utils.ts +10 -0
  451. package/src/theme/font-scale.ts +34 -3
  452. package/src/theme/series-colors.ts +44 -0
  453. package/src/theme/themes.ts +2 -1
  454. package/src/tickers/batched-lookups.ts +263 -6
  455. package/src/tickers/company-name-listing.ts +44 -2
  456. package/src/tickers/company-name.ts +7 -2
  457. package/src/tickers/search/upsert.ts +16 -1
  458. package/src/time-series/base-series.ts +18 -4
  459. package/src/time-series/studies/indicators.ts +3 -1
  460. package/src/time-series/studies/resolve.ts +1 -1
  461. package/src/time-series/types.ts +6 -0
  462. package/src/types/financials.ts +18 -0
  463. package/src/types/headless.ts +11 -0
  464. package/src/ui/host.tsx +26 -3
  465. package/src/ui/index.tsx +1 -0
  466. package/src/utils/concurrency.ts +6 -0
  467. package/src/utils/currency-pair.ts +56 -4
  468. package/src/utils/datetime-format.ts +11 -0
  469. package/src/utils/decimal-comma.ts +9 -6
  470. package/src/utils/exchanges.ts +32 -0
  471. package/src/utils/fundamentals.ts +41 -0
  472. package/src/utils/main-thread-stall.ts +21 -5
  473. package/src/utils/markdown.ts +4 -2
  474. package/src/utils/pasted-lines.ts +14 -0
  475. package/src/utils/perf-marks.ts +88 -9
  476. package/src/utils/price-window.ts +2 -1
  477. package/src/utils/reported-money.ts +9 -2
  478. package/src/utils/sec-filings.ts +17 -0
  479. package/src/utils/sec.ts +37 -25
  480. package/src/utils/shortcut-labels.ts +6 -30
  481. package/src/plugins/seed-notice.ts +0 -20
@@ -0,0 +1,58 @@
1
+ import { getWallSummary, type WallSummary } from "../../../api-client/wall-summary";
2
+ import type { PaneLock } from "../../../types/plugin";
3
+ import { filesForm } from "../shared/free-routes";
4
+ import { resolveHeadlessInstrument } from "../shared/headless-market-data";
5
+ import { proLockNote, type FreeRoute } from "../shared/pro-lock-note";
6
+
7
+ type ReadSummary = (wall: string, symbol: string, exchange?: string) => Promise<WallSummary | null>;
8
+
9
+ /**
10
+ * How gloom.sh spells a US ticker in a page's address: lower case, a share
11
+ * class after a dash (`brk-b`), as its canonical link does. The venue is no
12
+ * part of it: `aapl:nasdaq` is no page.
13
+ */
14
+ const pageTicker = (symbol: string) => symbol.trim().toLowerCase().replace(/[./]/g, "-");
15
+
16
+ /**
17
+ * The company's risk factor page on gloom.sh, which needs no account: each
18
+ * 10-K's risks with what was added, dropped or reworded. It is there for a
19
+ * company RISK has read a 10-K of, which the public wall summary counts, and
20
+ * named by the listing that check resolved, not the argument as typed.
21
+ */
22
+ function webRoute(readSummary: ReadSummary): FreeRoute {
23
+ let resolved: string | null = null;
24
+ return {
25
+ text: (ticker, company) => `gloom.sh/stocks/${pageTicker(resolved ?? ticker)}/risk-factors has ${company}'s risk factors from each 10-K, with what was added, dropped or reworded since the year before.`,
26
+ answers: async (symbol, context) => {
27
+ const { symbol: ticker, exchange } = await resolveHeadlessInstrument(context, symbol);
28
+ const summary = await readSummary("risk-wall", ticker, exchange);
29
+ const has = summary?.items.some((item) => item.label === "risk_count" && Number(item.value) > 0) ?? false;
30
+ if (has) resolved = ticker;
31
+ return has;
32
+ },
33
+ };
34
+ }
35
+
36
+ /**
37
+ * RISK is Pro whole (`useProFeatureWall`). Its reports are open on gloom.sh,
38
+ * one page per company, and the 10-Ks it reads are in the SEC filing list,
39
+ * which needs no account either: `filings` lists them with a link to each,
40
+ * where Item 1A is the risk factors as written. A foreign issuer files a 20-F
41
+ * instead (ASML), whose Item 3.D holds them. A company that files neither
42
+ * (IAG on LSE) has nothing in RISK either, and the note says so.
43
+ */
44
+ export function riskFactorsLockNote(lock: PaneLock, readSummary: ReadSummary = getWallSummary): Promise<string> {
45
+ return proLockNote(lock, {
46
+ token: "RISK",
47
+ does: "it groups a 10-K's risk factors by theme and shows what was added, dropped or reworded since the year before",
48
+ shows: "it",
49
+ free: [webRoute(readSummary), {
50
+ text: (ticker, company) => `gloom filings ${ticker} --form 10-K lists ${company}'s annual reports, each with its filing date and a link to the filing, whose Item 1A holds the risk factors as written.`,
51
+ answers: (symbol, context) => filesForm(symbol, "10-K", context),
52
+ }, {
53
+ text: (ticker, company) => `gloom filings ${ticker} --form 20-F lists ${company}'s annual reports, each with its filing date and a link to the filing, whose Item 3.D holds the risk factors as written.`,
54
+ answers: (symbol, context) => filesForm(symbol, "20-F", context),
55
+ }],
56
+ noneFor: (ticker) => `${ticker}'s company files no 10-K or 20-F with the SEC, so RISK has no risk factors for it.`,
57
+ });
58
+ }
@@ -19,6 +19,7 @@ import {
19
19
  useUiCapabilities,
20
20
  } from "../../../ui";
21
21
  import { isPermanentClientError } from "../../../api-client/errors";
22
+ import { formatFilingDate, formatShortDate } from "../../../utils/datetime-format";
22
23
  import { usePluginPaneState } from "../../runtime";
23
24
  import { useFilingYearReader } from "../shared/filing-year-reader";
24
25
  import { useProFeatureWall, type ProFeatureWallCopy, type ReadGuard } from "../shared/pro-feature-wall";
@@ -71,6 +72,8 @@ function RiskLine({
71
72
  );
72
73
  }
73
74
 
75
+ const NO_RISK_FACTORS = "This 10-K lists no risk factors.";
76
+
74
77
  const RISK_WALL: ProFeatureWallCopy = {
75
78
  placement: "risk-wall",
76
79
  action: "read risk factors",
@@ -170,14 +173,17 @@ function RiskFactorsReader({
170
173
  if (year === null) return <EmptyState title={`No 10-K risk factors on file for ${ticker}.`} />;
171
174
 
172
175
  const diff = report?.diff ?? null;
176
+ // A smaller reporting company's 10-K need not list risk factors. Its report
177
+ // has none to read or compare, only the filing to open.
178
+ const listsNone = report ? report.listsNoRiskFactors === true || report.riskCount === 0 : false;
173
179
  // A choice of years names the year in the tabs or the filter; a single
174
180
  // report says which one it is here.
175
181
  const meta = report
176
182
  ? [
177
183
  years.length > 1 ? null : `${report.reportYear} 10-K`,
178
- `Filed ${report.filedAt?.slice(0, 10) || "unavailable"}`,
179
- `updated ${report.updatedAt?.slice(0, 10) || "unavailable"}`,
180
- diff ? null : "no prior year on file",
184
+ `Filed ${formatFilingDate(report.filingDate || report.filedAt?.slice(0, 10), "unavailable")}`,
185
+ listsNone ? null : `updated ${formatShortDate(report.updatedAt, { day: "2-digit", fallback: "unavailable" })}`,
186
+ diff || listsNone ? null : "no prior year on file",
181
187
  ].filter(Boolean).join(" · ")
182
188
  : "";
183
189
 
@@ -208,7 +214,9 @@ function RiskFactorsReader({
208
214
  scrollY
209
215
  paddingX={1}
210
216
  >
211
- {report ? (
217
+ {report && listsNone ? (
218
+ <PaneStatusBody empty emptyTitle={report.overview || NO_RISK_FACTORS} />
219
+ ) : report ? (
212
220
  <Box
213
221
  flexDirection="column"
214
222
  width={nativePaneChrome ? "100%" : bodyWidth}
@@ -256,7 +264,8 @@ function RiskFactorsReader({
256
264
  {diff.reworded.map((item) => (
257
265
  <RiskLine
258
266
  key={`reworded-${item.index}`}
259
- tag={`${Math.round((1 - item.similarity) * 100)}% REWRITTEN`}
267
+ // Named as the count over the list names them.
268
+ tag={`${Math.round((1 - item.similarity) * 100)}% REWORDED`}
260
269
  group={report.risks[item.index]?.group ?? null}
261
270
  heading={report.risks[item.index]?.heading ?? ""}
262
271
  note={noteFor(report.notes.reworded, item.index)}
@@ -185,19 +185,24 @@ export function formatFlowVolOi(volOi: number | null | undefined): string {
185
185
  return volOi >= 10 ? `${Math.round(volOi)}x` : `${volOi.toFixed(1)}x`;
186
186
  }
187
187
 
188
- export function formatFlowExpiry(expiry: string): string {
189
- const parts = expiry.split("-");
190
- return parts.length === 3 ? `${parts[1]}/${parts[2]}` : expiry;
188
+ /** An expiry as the tape prints it, `06/16`, with its year when it is not this one: `06/16/27`. */
189
+ export function formatFlowExpiry(expiry: string, now = Date.now()): string {
190
+ const [year, month, day] = expiry.split("-");
191
+ if (!year || !month || !day) return expiry;
192
+ return year === String(new Date(now).getUTCFullYear()) ? `${month}/${day}` : `${month}/${day}/${year.slice(2)}`;
191
193
  }
192
194
 
193
- /** Today's prints to the second; earlier days carry their date. */
195
+ /**
196
+ * A print's time in UTC, as the TIME UTC header says (formatFeedTime's
197
+ * `utc`): today's to the second, an earlier day's with its date.
198
+ */
194
199
  export function formatFlowTime(at: number, now = Date.now()): string {
195
200
  const date = new Date(at);
196
201
  const pad = (value: number) => String(value).padStart(2, "0");
197
- if (localDay(at) !== localDay(now)) {
198
- return `${pad(date.getMonth() + 1)}/${pad(date.getDate())} ${pad(date.getHours())}:${pad(date.getMinutes())}`;
202
+ if (utcDay(at) !== utcDay(now)) {
203
+ return `${pad(date.getUTCMonth() + 1)}/${pad(date.getUTCDate())} ${pad(date.getUTCHours())}:${pad(date.getUTCMinutes())}`;
199
204
  }
200
- return `${pad(date.getHours())}:${pad(date.getMinutes())}:${pad(date.getSeconds())}`;
205
+ return `${pad(date.getUTCHours())}:${pad(date.getUTCMinutes())}:${pad(date.getUTCSeconds())}`;
201
206
  }
202
207
 
203
208
  /** Rows per page of recorded prints below the live tape. */
@@ -281,15 +286,14 @@ export function flowSessionSearch(filters: FlowFilters, scope: FlowScope): strin
281
286
  return params.toString();
282
287
  }
283
288
 
284
- function localDay(at: number): string {
285
- const date = new Date(at);
286
- return `${date.getFullYear()}-${date.getMonth()}-${date.getDate()}`;
289
+ function utcDay(at: number): string {
290
+ return new Date(at).toISOString().slice(0, 10);
287
291
  }
288
292
 
289
- /** True when any row is from an earlier day, so the time column needs its date. */
293
+ /** True when any row is from an earlier day in UTC, so the time column needs its date. */
290
294
  export function flowRowsSpanDays(events: readonly ScannerFlowEvent[], now = Date.now()): boolean {
291
- const today = localDay(now);
292
- return events.some((event) => localDay(event.at) !== today);
295
+ const today = utcDay(now);
296
+ return events.some((event) => utcDay(event.at) !== today);
293
297
  }
294
298
 
295
299
  /** The recorded-print query as the Cloud route reads it. */
@@ -66,7 +66,6 @@ import {
66
66
  flowTideRows,
67
67
  formatFlowSessionDate,
68
68
  formatSignedFlowPremium,
69
- formatStrikeExpiry,
70
69
  formatTideTime,
71
70
  loadFlowSession,
72
71
  sortFlowStrikes,
@@ -88,14 +87,15 @@ function flowTabs(symbol: string | null): Array<{ label: string; value: FlowTab
88
87
 
89
88
  function buildColumns(width: number, dated: boolean, ticker: boolean): DataTableColumn[] {
90
89
  // Prints from earlier days carry their date ("09/22 15:04"), so the time
91
- // column widens for them. One name's pane names it in its title, not a column.
92
- const fixed = { time: dated ? 11 : 8, ticker: ticker ? 7 : 0, type: 8, strike: 8, exp: 6, side: 5, size: 7, prem: 7, volOi: 6 };
90
+ // column widens for them; an expiry past this year carries its year
91
+ // ("06/16/27"). One name's pane names it in its title, not a column.
92
+ const fixed = { time: dated ? 11 : 8, ticker: ticker ? 7 : 0, type: 8, strike: 8, exp: 8, side: 5, size: 7, prem: 7, volOi: 6 };
93
93
  const total = Object.values(fixed).reduce((sum, value) => sum + value, 0);
94
94
  // Table chrome is one gap per column, the table's extra gutter where
95
95
  // right-aligned EXP meets left-aligned SIDE, two cells of padding, and the scrollbar.
96
96
  const slack = Math.max(0, width - total - (ticker ? 9 : 8) - 1 - 2 - 1);
97
97
  return [
98
- { id: "time", label: "TIME", width: fixed.time, align: "left" },
98
+ { id: "time", label: "TIME UTC", width: fixed.time, align: "left" },
99
99
  ...(ticker ? [{ id: "ticker", label: "TICKER", width: fixed.ticker + Math.min(4, slack), align: "left" as const }] : []),
100
100
  { id: "type", label: "TYPE", width: fixed.type + (ticker ? 0 : Math.min(4, slack)), align: "left" },
101
101
  { id: "strike", label: "STRIKE", width: fixed.strike, align: "right" },
@@ -108,7 +108,7 @@ function buildColumns(width: number, dated: boolean, ticker: boolean): DataTable
108
108
  }
109
109
 
110
110
  const TIDE_COLUMNS: DataTableColumn[] = [
111
- { id: "time", label: "TIME", width: 6, align: "left" },
111
+ { id: "time", label: "TIME UTC", width: 8, align: "left" },
112
112
  { id: "netCalls", label: "NET CALLS", width: 10, align: "right" },
113
113
  { id: "netPuts", label: "NET PUTS", width: 10, align: "right" },
114
114
  { id: "net", label: "NET PREM", width: 10, align: "right" },
@@ -196,7 +196,7 @@ function renderTideCell(row: FlowTideRow, column: DataTableColumn): DataTableCel
196
196
  function renderStrikeCell(row: FlowStrikeRow, column: DataTableColumn): DataTableCell {
197
197
  switch (column.id) {
198
198
  case "expiry":
199
- return { text: formatStrikeExpiry(row.expiry), value: row.expiry, color: colors.textDim };
199
+ return { text: formatFlowExpiry(row.expiry), value: row.expiry, color: colors.textDim };
200
200
  case "strike":
201
201
  return { text: formatNumber(row.strike, row.strike % 1 === 0 ? 0 : 2), value: row.strike, color: colors.textBright };
202
202
  case "net":
@@ -221,14 +221,13 @@ function formatPremiumAxis(value: number, domain: CompositeAxisDomain): string {
221
221
  return text.startsWith("-") ? `-$${text.slice(1)}` : `$${text}`;
222
222
  }
223
223
 
224
- /** The tide's lines read in the user's own clock, as the TIME columns do. */
225
- const LOCAL_TIME_ZONE = Intl.DateTimeFormat().resolvedOptions().timeZone || "UTC";
226
224
 
227
225
  function tideSeries(rows: readonly FlowTideRow[], bucketMs: number): ResolvedSeries[] {
228
226
  const points = flowTidePoints(rows, bucketMs);
229
227
  const line = (id: string, label: string, color: string, value: (point: (typeof points)[number]) => number): ResolvedSeries => ({
230
228
  ...staticSeries(points.map((point) => scalarPoint(new Date(point.at), value(point))), { id, label, color }),
231
- timeBasis: { kind: "market", timeZone: LOCAL_TIME_ZONE, cadenceMs: bucketMs },
229
+ // In UTC, as the TIME UTC columns read.
230
+ timeBasis: { kind: "market", timeZone: "UTC", cadenceMs: bucketMs },
232
231
  observationKind: "market",
233
232
  });
234
233
  // Named as the table's columns are; the net line is the tide itself.
@@ -123,17 +123,10 @@ export function formatSignedFlowPremium(value: number): string {
123
123
  return `${value > 0 ? "+" : "-"}${formatFlowPremium(Math.abs(value))}`;
124
124
  }
125
125
 
126
- /** An expiry as the table reads it: `10/30`, with the year when it is not this one. */
127
- export function formatStrikeExpiry(expiry: string, now = Date.now()): string {
128
- const [year, month, day] = expiry.split("-");
129
- if (!year || !month || !day) return expiry;
130
- return year === String(new Date(now).getFullYear()) ? `${month}/${day}` : `${month}/${day}/${year.slice(2)}`;
131
- }
132
-
133
- /** A bucket's start as the local wall clock, `10:35`. */
126
+ /** A bucket's start in UTC, `14:35`, as the prints' TIME UTC column reads. */
134
127
  export function formatTideTime(at: number): string {
135
128
  const date = new Date(at);
136
- return `${String(date.getHours()).padStart(2, "0")}:${String(date.getMinutes()).padStart(2, "0")}`;
129
+ return `${String(date.getUTCHours()).padStart(2, "0")}:${String(date.getUTCMinutes()).padStart(2, "0")}`;
137
130
  }
138
131
 
139
132
  /** The session's date as the chart's legend names it: `Mon 26 Oct`. */
@@ -98,8 +98,9 @@ export function filterHiloRows(
98
98
 
99
99
  /**
100
100
  * What an empty table says. The price filter when rows came in and it hid them all, or when the market is open and
101
- * nothing has printed a new extreme yet. A closed market says so and when it reopens, in the status line's words
102
- * (`Markets closed until Mon.`), as SCAN says its own close: its session has no new highs or lows to count.
101
+ * nothing has printed a new extreme yet. A closed market says so and when it reopens, on the status line's clocks
102
+ * (`Markets closed until Mon 13:30 UTC, 09:30 ET.`), as SCAN says its own close: its session has no new highs or lows
103
+ * to count.
103
104
  */
104
105
  export function hiloEmptyState(
105
106
  { filtered, status, now }: { filtered: boolean; status: ScannerStatus | undefined; now: number },
@@ -107,7 +108,7 @@ export function hiloEmptyState(
107
108
  if (filtered || status !== "closed") return { title: "Nothing above the price filter yet." };
108
109
  const line = venueMarketLine("NYSE", now);
109
110
  return {
110
- title: line?.state === "closed" ? `${line.text[0]!.toUpperCase()}${line.text.slice(1)}.` : "Market closed.",
111
+ title: line?.state !== "closed" ? "Market closed." : line.reopens ? `Markets closed until ${line.reopens}.` : "Markets closed.",
111
112
  hint: "New highs and lows resume at the open.",
112
113
  };
113
114
  }
@@ -1,5 +1,4 @@
1
1
  import { EmptyState } from "../../../components";
2
- import { formatShortDate } from "../../../utils/datetime-format";
3
2
  import { formatCompact, formatCurrency, formatNumber } from "../../../utils/format";
4
3
  import { transactionTypeLabel, type InsiderTransaction } from "../insider/insider-data";
5
4
 
@@ -11,10 +10,6 @@ export function formatFilingShortDate(value: Date | string | number): string {
11
10
  return `${MONTH_NAMES[date.getUTCMonth()]} ${String(date.getUTCDate()).padStart(2, " ")} ${date.getUTCFullYear()}`;
12
11
  }
13
12
 
14
- export function formatFilingMetaDate(value: Date): string {
15
- return formatShortDate(value, { utc: true });
16
- }
17
-
18
13
  export function formatFilingFormLabel(form: string, fallback = "FORM 4"): string {
19
14
  const value = form.trim();
20
15
  return value ? `FORM ${value}` : fallback;
@@ -1,4 +1,5 @@
1
1
  import type { SecFilingItem } from "../../../types/data-provider";
2
+ import { loadLatestFilings, SEC_FILING_FETCH_LIMIT, type HiddenFilings } from "../../../utils/sec-filings";
2
3
 
3
4
  /**
4
5
  * Registered fund forms: registration statements and their post-effective
@@ -73,3 +74,21 @@ export function filingFormMatches(form: string, wanted: string): boolean {
73
74
  const actual = compactFilingForm(form);
74
75
  return !!target && (actual === target || actual === `${target}A`);
75
76
  }
77
+
78
+ /**
79
+ * The filings a list of an issuer's filings shows, `fn SEC` and `filings`
80
+ * alike. With `form`, the latest `limit` of that form and its amendments from
81
+ * every filing listed for the issuer, supplements included when it names
82
+ * them. With `all`, the latest `limit` as filed. Otherwise the latest `limit`
83
+ * without what `loadLatestFilings` leaves out (a bank's pricing supplements,
84
+ * a fund trust's filings for its other funds), with how many it left out.
85
+ */
86
+ export async function loadShownSecFilings(
87
+ load: (count: number) => Promise<SecFilingItem[]>,
88
+ limit: number,
89
+ { form = null, all = false }: { form?: string | null; all?: boolean } = {},
90
+ ): Promise<{ filings: SecFilingItem[]; hidden: HiddenFilings | null }> {
91
+ if (form) return { filings: (await load(SEC_FILING_FETCH_LIMIT)).filter((filing) => filingFormMatches(filing.form, form)).slice(0, limit), hidden: null };
92
+ if (all) return { filings: (await load(limit)).slice(0, limit), hidden: null };
93
+ return loadLatestFilings(load, limit);
94
+ }
@@ -1,12 +1,12 @@
1
1
  import { apiClient } from "../../../api-client";
2
- import type { FundFactsPayload, FundLeverage, FundMetalHoldings, FundStructure } from "../../../api-client/fund-facts";
2
+ import type { FundCoinHoldings, FundFactsPayload, FundLeverage, FundMetalHoldings, FundStructure } from "../../../api-client/fund-facts";
3
3
  import type { StatItem } from "../../../components/ui/stat-grid";
4
4
  import { leverageFactorLabel } from "../../../time-series/leverage";
5
5
  import { t, tf } from "../../../i18n";
6
6
  import { createPluginCache } from "../../../data/plugin-cache";
7
7
  import type { HeadlessPaneEntry } from "../../../types/plugin";
8
8
  import { errorMessage } from "../../../utils/errors";
9
- import { formatCompact } from "../../../utils/format";
9
+ import { formatCompact, formatCurrency } from "../../../utils/format";
10
10
  import { bondClassText, bondFigures, DV01_FROM_DURATION, durationDv01PerShare, formatDv01PerShare } from "../../../market-data/bond-funds";
11
11
  import { readFundFacts, validateFundFacts } from "../../../market-data/fund-facts";
12
12
  import { cachedCloudResource, loadCloudResource, unavailableOnServer } from "../shared/cloud-resource";
@@ -55,6 +55,25 @@ function formatNav(value: number): string {
55
55
  return `$${value.toFixed(value < 1 ? 4 : 2)}`;
56
56
  }
57
57
 
58
+ /**
59
+ * A NAV or closing price in the fund's own currency: a Hong Kong counter's
60
+ * (HK$5.2842, $0.6736) to the four decimals its issuer states, a US fund's
61
+ * as before.
62
+ */
63
+ function fundPrice(facts: Pick<FundFactsPayload, "currency">, value: number): string {
64
+ return facts.currency ? formatCurrency(value, facts.currency, 4) : formatNav(value);
65
+ }
66
+
67
+ /** Units in issue per coin held, whole (`3,262`), under the label that names the coin. */
68
+ const unitsPerCoinText = (holdings: FundCoinHoldings) => Math.round(holdings.unitsPerCoin).toLocaleString("en-US");
69
+
70
+ /** `Units per ETH`, `Units per BTC`. */
71
+ const unitsPerCoinLabel = (holdings: FundCoinHoldings) => tf("Units per {asset}", { asset: holdings.asset });
72
+
73
+ /** Coins held as the issuer states them: `18,453 ETH`. */
74
+ const coinsText = (holdings: FundCoinHoldings) =>
75
+ `${holdings.coins.toLocaleString("en-US", { maximumFractionDigits: 4 })} ${holdings.asset}`;
76
+
58
77
  function formatNetAssets(value: number): string {
59
78
  return `$${formatCompact(value)}`;
60
79
  }
@@ -107,7 +126,8 @@ const metalLabel = (holdings: FundMetalHoldings) => holdings.metal === "gold" ?
107
126
  * call a fee a sponsor fee.
108
127
  */
109
128
  function expenseRatioLabel(facts: Pick<FundFactsPayload, "expenseRatio">): string {
110
- return facts.expenseRatio?.kind === "sponsor-fee" ? "Sponsor fee" : "Expense ratio";
129
+ const kind = facts.expenseRatio?.kind;
130
+ return kind === "sponsor-fee" ? "Sponsor fee" : kind === "management-fee" ? "Management fee" : "Expense ratio";
111
131
  }
112
132
 
113
133
  function feeBasis(facts: FundFactsPayload): "net" | "gross" | null {
@@ -220,7 +240,7 @@ export function fundFactItems(facts: FundFactsPayload): StatItem[] {
220
240
  const estimate = facts.nav.estimate;
221
241
  const nav = estimate && dated.nav.detail
222
242
  ? { ...dated.nav, detail: `${dated.nav.detail} · ${tf("est. {range}", { range: estimateRange(estimate) })}` } : dated.nav;
223
- items.push(cell("nav", "NAV", formatNav(facts.nav.value), nav));
243
+ items.push(cell("nav", "NAV", fundPrice(facts, facts.nav.value), nav));
224
244
  }
225
245
  if (facts.premiumDiscount) items.push(cell("premium", "Premium/discount", formatPremiumPercent(facts.premiumDiscount.value), dated.premium));
226
246
  if (facts.expenseRatio) items.push(cell("fee", expenseRatioLabel(facts), formatFeePercent(facts.expenseRatio.value), dated.fee));
@@ -230,6 +250,12 @@ export function fundFactItems(facts: FundFactsPayload): StatItem[] {
230
250
  items.push(cell("shares", "Shares outstanding", formatCompact(facts.sharesOutstanding.value),
231
251
  { detail: facts.sharesOutstanding.asOf ?? undefined, marked: facts.stale }));
232
252
  }
253
+ // A spot coin fund's units per coin, with the coins it holds that day.
254
+ const coins = facts.coinHoldings;
255
+ if (coins) {
256
+ items.push(cell("units-per-coin", unitsPerCoinLabel(coins), unitsPerCoinText(coins),
257
+ { detail: `${coinsText(coins)} · ${coins.asOf}`, marked: facts.stale }));
258
+ }
233
259
  if (facts.flows) {
234
260
  // In dollars with the shares beside them; in shares alone when a day had no NAV to value them at.
235
261
  const flows = facts.flows;
@@ -305,7 +331,7 @@ export function fundFactOverviewFields(facts: FundFactsPayload): FundFactOvervie
305
331
  const forms = figure.detail ? [figure.detail, withoutYear(figure.detail), ...(short ? [short, withoutYear(short)] : [])] : [];
306
332
  return { label, value, ...(forms.length ? { detail: [...new Set(forms)] } : {}), ...(figure.marked ? { warn: true } : {}) };
307
333
  };
308
- if (facts.nav) fields.push(field("NAV", formatNav(facts.nav.value), dated.nav));
334
+ if (facts.nav) fields.push(field("NAV", fundPrice(facts, facts.nav.value), dated.nav));
309
335
  if (facts.premiumDiscount) fields.push(field("Prem/Disc", formatPremiumPercent(facts.premiumDiscount.value), dated.premium, facts.premiumDiscount.asOf ?? undefined));
310
336
  if (facts.netAssets) {
311
337
  // N-PORT's long form gives way to the month end alone before the bare date.
@@ -313,8 +339,9 @@ export function fundFactOverviewFields(facts: FundFactsPayload): FundFactOvervie
313
339
  fields.push(field(wholeFund(facts) ? "Fund Assets" : "Net Assets", formatNetAssets(facts.netAssets.value), dated.netAssets, monthEnd));
314
340
  }
315
341
  if (facts.expenseRatio) {
316
- const fee = facts.expenseRatio.kind === "sponsor-fee";
317
- fields.push(field(fee ? "Sponsor Fee" : "Exp Ratio", formatFeePercent(facts.expenseRatio.value), dated.fee, facts.expenseRatio.asOf ?? undefined));
342
+ const kind = facts.expenseRatio.kind;
343
+ const label = kind === "sponsor-fee" ? "Sponsor Fee" : kind === "management-fee" ? "Mgmt Fee" : "Exp Ratio";
344
+ fields.push(field(label, formatFeePercent(facts.expenseRatio.value), dated.fee, facts.expenseRatio.asOf ?? undefined));
318
345
  }
319
346
  if (facts.inception) fields.push({ label: "Inception", value: facts.inception.value });
320
347
  return fields;
@@ -345,10 +372,10 @@ export function fundFactEntries(facts: FundFactsPayload): HeadlessPaneEntry[] {
345
372
  if (facts.nav) {
346
373
  const date = facts.nav.asOf && monthEndNav(facts) ? `${facts.nav.asOf} month-end` : facts.nav.asOf;
347
374
  const estimate = facts.nav.estimate ? `estimate ${estimateRange(facts.nav.estimate)}` : null;
348
- add("nav", "NAV", facts.nav.value, provenance(formatNav(facts.nav.value), date, estimate, facts.nav.source), "USD");
375
+ add("nav", "NAV", facts.nav.value, provenance(fundPrice(facts, facts.nav.value), date, estimate, facts.nav.source), facts.currency ?? "USD");
349
376
  }
350
377
  if (facts.closingPrice) add("closingPrice", "Closing price", facts.closingPrice.value,
351
- provenance(formatNav(facts.closingPrice.value), facts.closingPrice.asOf, facts.closingPrice.source), "USD");
378
+ provenance(fundPrice(facts, facts.closingPrice.value), facts.closingPrice.asOf, facts.closingPrice.source), facts.currency ?? "USD");
352
379
  if (facts.premiumDiscount) {
353
380
  const basis = facts.premiumDiscount.basis !== "computed" ? null
354
381
  : facts.premiumDiscount.estimate ? "closing price vs NAV estimate midpoint" : "closing price vs NAV";
@@ -365,6 +392,12 @@ export function fundFactEntries(facts: FundFactsPayload): HeadlessPaneEntry[] {
365
392
  add("sharesOutstanding", "Shares outstanding", facts.sharesOutstanding.value,
366
393
  provenance(facts.sharesOutstanding.value.toLocaleString("en-US"), facts.sharesOutstanding.asOf, facts.sharesOutstanding.source), "shares");
367
394
  }
395
+ if (facts.coinHoldings) {
396
+ const holdings = facts.coinHoldings;
397
+ add("unitsPerCoin", `Units per ${holdings.asset}`, holdings.unitsPerCoin,
398
+ provenance(unitsPerCoinText(holdings), holdings.asOf, holdings.source), `units per ${holdings.asset}`);
399
+ add("coinsHeld", "Coins held", holdings.coins, provenance(coinsText(holdings), holdings.asOf, holdings.source), holdings.asset);
400
+ }
368
401
  if (facts.flows) {
369
402
  // JSON keeps the dollar figure (null when a day had no NAV); `fundFacts.flows` has the shares.
370
403
  const flows = facts.flows;
@@ -399,7 +432,7 @@ export function fundFactEntries(facts: FundFactsPayload): HeadlessPaneEntry[] {
399
432
  if (facts.index) add("index", BENCHMARK_LABEL, facts.index.value, provenance(facts.index.value, facts.index.source));
400
433
  const url = facts.nav?.url ?? facts.expenseRatio?.url ?? facts.netAssets?.url;
401
434
  // The figures' own page: the sponsor's, or the SEC filing they were read from (a prospectus, an N-PORT, an 8-K).
402
- if (url) add("url", /^https:\/\/www\.sec\.gov\//.test(url) ? "SEC filing" : "Sponsor page", url, url);
435
+ if (url) add("url", /^https:\/\/www\.sec\.gov\//.test(url) ? "SEC filing" : facts.expenseRatio?.kind === "management-fee" ? "Issuer page" : "Sponsor page", url, url);
403
436
  return entries;
404
437
  }
405
438
 
@@ -415,7 +448,8 @@ export function listNames(names: readonly string[]): string {
415
448
  */
416
449
  export function fundFactPublishers(facts: FundFactsPayload): string[] {
417
450
  return [...new Set([...[facts.nav, facts.expenseRatio, facts.netAssets, facts.sharesOutstanding, facts.flows, facts.leverage, facts.index, facts.bond?.secYield, facts.bond?.yieldToWorst, facts.bond?.duration]
418
- .flatMap((value) => value ? [value.source] : []), ...facts.metalHoldings ? [facts.metalHoldings.source.publisher] : []])];
451
+ .flatMap((value) => value ? [value.source] : []), ...facts.metalHoldings ? [facts.metalHoldings.source.publisher] : [],
452
+ ...facts.coinHoldings ? [facts.coinHoldings.source] : []])];
419
453
  }
420
454
 
421
455
  /** The newest NAV is stale: one line saying since when, as the report's note says it. */
@@ -7,13 +7,14 @@ import type {
7
7
  HeadlessPaneRow,
8
8
  } from "../../../types/plugin";
9
9
  import { parsePublicTickerKey } from "../../../utils/exchanges";
10
- import { US_FUND_FACTS_ONLY } from "../../../utils/sec";
10
+ import { hasFundFactsAbroad, US_FUND_FACTS_ONLY } from "../../../utils/sec";
11
11
  import type { SecFilingItem } from "../../../types/data-provider";
12
12
  import type { FundFactsPayload } from "../../../api-client/fund-facts";
13
13
  import { errorMessage } from "../../../utils/errors";
14
+ import { logFailure } from "../../../utils/log-failure";
14
15
  import { loadSecFilings } from "./client";
15
- import { ETF_FILING_FORMS, filingFormMatches, filterFilingsByForms, fundSeriesFilings, SEC_FILING_FETCH_LIMIT } from "./forms";
16
- import { hiddenFilingsNote, loadLatestFilings } from "../../../utils/sec-filings";
16
+ import { ETF_FILING_FORMS, filterFilingsByForms, fundSeriesFilings, loadShownSecFilings, SEC_FILING_FETCH_LIMIT } from "./forms";
17
+ import { hiddenFilingsMetadata, hiddenFilingsNote } from "../../../utils/sec-filings";
17
18
  import { buildSecFilingRows, secFilingIssuers, SEC_ACCEPTANCE_NOTE } from "./model";
18
19
  import { SEC_FILINGS } from "../shared/report-freshness";
19
20
  import { fetchFundFacts, fundFactEntries, fundFactPublishers, fundFactsEmpty, fundFactsErrorText, fundFactsStaleNote, listNames } from "./fund-facts";
@@ -118,7 +119,7 @@ export function createSecHeadless(dependencies: SecHeadlessDependencies = defaul
118
119
  },
119
120
  {
120
121
  key: "all",
121
- description: "Also list the pricing supplements and term sheets (424B2, FWP, and a 424B3 filed among them) a bank files for each structured note, which are left out by default.",
122
+ description: "Also list what is left out by default: the pricing supplements and term sheets (424B2, FWP, and a 424B3 filed among them) a bank files for each structured note, and a fund trust's filings for its other funds.",
122
123
  type: "boolean",
123
124
  defaultValue: false,
124
125
  pluginState: { pluginId: "ticker-research", key: "pricingSupplements" },
@@ -131,13 +132,9 @@ export function createSecHeadless(dependencies: SecHeadlessDependencies = defaul
131
132
  const limit = Number(args.options.limit);
132
133
  const form = typeof args.options.form === "string" ? args.options.form.trim() : "";
133
134
  const load = (count: number) => dependencies.loadFilings(symbol, count, args, ctx);
134
- // A form filter searches every filing listed for the issuer, as `filings --form` does, and keeps
135
- // the supplements it names; without one, a bank's pricing supplements stay out unless --all.
136
- const { filings, hidden } = form
137
- ? { filings: (await load(SEC_FILING_FETCH_LIMIT)).filter((filing) => filingFormMatches(filing.form, form)).slice(0, limit), hidden: null }
138
- : args.options.all === true
139
- ? { filings: (await load(limit)).slice(0, limit), hidden: null }
140
- : await loadLatestFilings(load, limit);
135
+ // A form filter searches every filing listed for the issuer and keeps the supplements it names; without
136
+ // one, a bank's pricing supplements and a trust's other funds stay out unless --all, as in `filings`.
137
+ const { filings, hidden } = await loadShownSecFilings(load, limit, { form: form || null, all: args.options.all === true });
141
138
  const note = hidden && hiddenFilingsNote(hidden);
142
139
  const rows = buildSecFilingRows(filings);
143
140
  // A listing abroad whose company files nothing with the SEC says where its exchange publishes its announcements.
@@ -154,7 +151,7 @@ export function createSecHeadless(dependencies: SecHeadlessDependencies = defaul
154
151
  returned: filings.length,
155
152
  issuers: secFilingIssuers(filings),
156
153
  ...(form ? { form } : {}),
157
- pricingSupplementsHidden: hidden?.pricingSupplements ?? 0,
154
+ ...hiddenFilingsMetadata(hidden),
158
155
  },
159
156
  };
160
157
  },
@@ -202,6 +199,29 @@ function fundAbroadResult(symbol: string, venue: string, profile: FundAbroadProf
202
199
  };
203
200
  }
204
201
 
202
+ /**
203
+ * ETF for a Hong Kong spot bitcoin or ether fund's counter (3046:HKEX): its
204
+ * issuer's figures, the NAV in the counter's own currency, and the units per
205
+ * coin. It files nothing with the SEC, so there is no filings section.
206
+ */
207
+ function fundAbroadFactsResult(symbol: string, venue: string, facts: FundFactsPayload): HeadlessBundleResult {
208
+ const publishers = fundFactPublishers(facts);
209
+ const stale = fundFactsStaleNote(symbol, facts);
210
+ return {
211
+ sections: [{ title: "Fund facts", entries: fundFactEntries(facts) }],
212
+ complete: true,
213
+ ...(stale ? { notes: [stale] } : {}),
214
+ freshness: {
215
+ source: listNames(publishers) || "Fund issuer",
216
+ ...(publishers.length ? { publisher: listNames(publishers) } : {}),
217
+ status: "not-a-feed",
218
+ basis: "published fund data",
219
+ ...(facts.nav?.asOf ? { asOf: facts.nav.asOf } : {}),
220
+ },
221
+ metadata: { symbol, venue, fundFacts: facts },
222
+ };
223
+ }
224
+
205
225
  /**
206
226
  * ETF: a US-listed fund's facts (fee, NAV, premium or discount, net assets,
207
227
  * sponsor, inception, index) as its sponsor publishes them, then its fund
@@ -229,6 +249,11 @@ export function createFundHeadless(dependencies: FundHeadlessDependencies = defa
229
249
  const symbol = args.symbols[0]!;
230
250
  const abroad = venueAbroad(symbol);
231
251
  if (abroad) {
252
+ // A Hong Kong spot coin fund has its issuer's figures; any other fund abroad, or a server without them, keeps the issuer link.
253
+ const facts = hasFundFactsAbroad(abroad)
254
+ ? await dependencies.loadFacts(symbol, ctx).catch(logFailure("sec.fund-headless", "Read fund facts abroad failed", null))
255
+ : null;
256
+ if (facts?.covered) return fundAbroadFactsResult(symbol, abroad, facts);
232
257
  try {
233
258
  const profile = await (dependencies.loadAbroadProfile ?? defaultFundDependencies.loadAbroadProfile)(symbol, ctx);
234
259
  return fundAbroadResult(symbol, abroad, profile);