gloomberb 0.20.2 → 0.20.4

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 (471) hide show
  1. package/README.md +1 -1
  2. package/README.zh-CN.md +1 -1
  3. package/package.json +2 -1
  4. package/src/account/auth-dialog.tsx +17 -0
  5. package/src/account/auth-form.tsx +13 -8
  6. package/src/account/upgrade-dialog.tsx +1 -1
  7. package/src/api-client/central-bank-rates.ts +5 -0
  8. package/src/api-client/data.ts +23 -4
  9. package/src/api-client/debt-maturities.ts +45 -2
  10. package/src/api-client/earnings.ts +4 -2
  11. package/src/api-client/errors.ts +21 -11
  12. package/src/api-client/fx-interventions.ts +64 -0
  13. package/src/api-client/index.ts +2 -0
  14. package/src/api-client/paths.ts +9 -1
  15. package/src/api-client/release-summaries.ts +21 -0
  16. package/src/api-client/social-mentions.ts +47 -0
  17. package/src/api-client/types/econ.ts +4 -0
  18. package/src/app/keybindings/actions.ts +2 -2
  19. package/src/app/pane-runtime/ticker-open-runtime.ts +245 -66
  20. package/src/app.tsx +11 -1
  21. package/src/cli/command-options.ts +2 -1
  22. package/src/cli/commands/market.ts +188 -30
  23. package/src/cli/commands/news-search.ts +1 -3
  24. package/src/cli/commands/options-chain.ts +23 -6
  25. package/src/cli/commands/overview.ts +13 -5
  26. package/src/cli/commands/plugins.ts +76 -23
  27. package/src/cli/commands/search.ts +25 -6
  28. package/src/cli/commands/system.ts +19 -3
  29. package/src/cli/commands/ticker.ts +64 -21
  30. package/src/cli/fx-quote-rate.ts +49 -1
  31. package/src/cli/glossary.ts +95 -15
  32. package/src/cli/history-rows.ts +9 -25
  33. package/src/cli/index.ts +14 -46
  34. package/src/cli/known-gaps.ts +3 -3
  35. package/src/cli/listing-arg.ts +78 -18
  36. package/src/cli/name-entries.ts +3 -2
  37. package/src/cli/not-a-ticker.ts +6 -2
  38. package/src/cli/pane-functions/capabilities.ts +12 -1
  39. package/src/cli/pane-functions/function-help.ts +26 -14
  40. package/src/cli/pane-functions/headless.ts +3 -1
  41. package/src/cli/pane-functions/index.ts +32 -4
  42. package/src/cli/pane-functions/market-session.ts +8 -3
  43. package/src/cli/pane-functions/resolver.ts +18 -11
  44. package/src/cli/pane-functions/screenshot-payload.ts +36 -6
  45. package/src/cli/pane-functions/screenshot-render.ts +4 -0
  46. package/src/cli/quote-answer.ts +10 -0
  47. package/src/cli/report-tables.ts +40 -8
  48. package/src/cli/result.ts +21 -9
  49. package/src/cli/spreadsheet-hint.ts +43 -0
  50. package/src/cli/symbol-list.ts +58 -4
  51. package/src/cli/symbol-rows.ts +49 -2
  52. package/src/cli/ticker-resolution.ts +98 -5
  53. package/src/cli/types.ts +2 -0
  54. package/src/cli/unknown-command.ts +88 -0
  55. package/src/components/chart/composite/axis-overlays.tsx +22 -0
  56. package/src/components/chart/composite/composite-chart.tsx +54 -13
  57. package/src/components/chart/composite/event-captions.ts +109 -0
  58. package/src/components/chart/composite/event-guides.ts +74 -0
  59. package/src/components/chart/composite/rasterizer.ts +2 -0
  60. package/src/components/chart/composite/text-renderer.ts +2 -0
  61. package/src/components/chart/composite/types.ts +31 -0
  62. package/src/components/command-bar/assist/model.ts +6 -1
  63. package/src/components/command-bar/commands/direct/index.ts +9 -1
  64. package/src/components/command-bar/commands/registry.ts +18 -0
  65. package/src/components/command-bar/layout-items/focused-pane.ts +5 -5
  66. package/src/components/command-bar/pane-actions.ts +30 -13
  67. package/src/components/command-bar/panel/index.tsx +6 -3
  68. package/src/components/command-bar/panel/prompt-binding.ts +4 -0
  69. package/src/components/command-bar/panel/types.ts +3 -0
  70. package/src/components/command-bar/routes/header-market.ts +108 -0
  71. package/src/components/command-bar/routes/root/command-items.ts +5 -0
  72. package/src/components/command-bar/routes/root/provider-search.ts +192 -33
  73. package/src/components/command-bar/routes/root/results.ts +3 -0
  74. package/src/components/command-bar/routes/root/runtime.ts +28 -5
  75. package/src/components/command-bar/routes/ticker-search/results.ts +104 -6
  76. package/src/components/command-bar/routes/ticker-search/route.ts +3 -2
  77. package/src/components/command-bar/routing/list-state.ts +38 -0
  78. package/src/components/command-bar/selection-hint.ts +28 -0
  79. package/src/components/command-bar/surface/index.tsx +41 -3
  80. package/src/components/command-bar/view-model.ts +15 -0
  81. package/src/components/command-bar/workflow/tickers.ts +3 -2
  82. package/src/components/company-logo.tsx +20 -2
  83. package/src/components/data-table/export.ts +13 -8
  84. package/src/components/feedback-dialog.tsx +2 -1
  85. package/src/components/form-modal/field-row.tsx +2 -1
  86. package/src/components/input-search-bar.tsx +2 -2
  87. package/src/components/layout/detached-pane-shell.tsx +1 -1
  88. package/src/components/layout/double-escape-close.ts +8 -5
  89. package/src/components/layout/floating-pane.tsx +5 -1
  90. package/src/components/layout/header.tsx +75 -44
  91. package/src/components/layout/market-summary.ts +322 -116
  92. package/src/components/layout/pane/footer/index.tsx +44 -19
  93. package/src/components/layout/pane/footer/model.ts +52 -20
  94. package/src/components/layout/pane/header.tsx +3 -2
  95. package/src/components/layout/shell/action-menu-overlay.tsx +10 -5
  96. package/src/components/layout/shell/active-drag.ts +149 -105
  97. package/src/components/layout/shell/chrome.ts +15 -15
  98. package/src/components/layout/shell/drag/drop-zones.ts +162 -0
  99. package/src/components/layout/shell/drag/index.ts +47 -218
  100. package/src/components/layout/shell/drag/live.ts +10 -3
  101. package/src/components/layout/shell/drag/overlays.tsx +182 -5
  102. package/src/components/layout/shell/drag/runtime.ts +29 -6
  103. package/src/components/layout/shell/drag/shared-edges.ts +156 -0
  104. package/src/components/layout/shell/index.tsx +11 -6
  105. package/src/components/layout/shell/menu.ts +11 -2
  106. package/src/components/layout/shell/native/pointer-runtime.ts +25 -0
  107. package/src/components/layout/shell/native/window-state.ts +2 -2
  108. package/src/components/layout/shell/pane/layers.tsx +71 -7
  109. package/src/components/layout/shell/terminal-pointer-runtime.ts +18 -9
  110. package/src/components/layout/shell/window-mode/index.ts +8 -10
  111. package/src/components/layout/status-bar.tsx +8 -7
  112. package/src/components/layout/status-widget-space.ts +8 -0
  113. package/src/components/layout/window-edit/mode.ts +39 -7
  114. package/src/components/layout/window-edit/presentation.ts +1 -1
  115. package/src/components/markdown-editor.tsx +2 -2
  116. package/src/components/onboarding/account-step/form-panel.tsx +0 -3
  117. package/src/components/onboarding/onboarding-keyboard.ts +19 -6
  118. package/src/components/onboarding/onboarding-wizard.tsx +69 -14
  119. package/src/components/onboarding/portfolio-step/broker-fields-panel.tsx +0 -1
  120. package/src/components/onboarding/portfolio-step/positions-panel.tsx +0 -2
  121. package/src/components/price-sparkline/model.ts +26 -10
  122. package/src/components/ticker/list-table-view.tsx +29 -4
  123. package/src/components/ui/button.tsx +15 -2
  124. package/src/components/ui/choice-dialog.tsx +1 -0
  125. package/src/components/ui/column-grid.tsx +18 -9
  126. package/src/components/ui/data-table/index.tsx +5 -4
  127. package/src/components/ui/data-table/opentui/index.tsx +2 -1
  128. package/src/components/ui/data-table/types.ts +18 -0
  129. package/src/components/ui/delayed-mark.tsx +3 -2
  130. package/src/components/ui/field-grid.tsx +0 -2
  131. package/src/components/ui/fields.tsx +7 -4
  132. package/src/components/ui/inline-quick-add.tsx +2 -2
  133. package/src/components/ui/key-hint-words.ts +153 -0
  134. package/src/components/ui/key-hints.tsx +73 -0
  135. package/src/components/ui/list-view.tsx +7 -12
  136. package/src/components/ui/loading.tsx +10 -3
  137. package/src/components/ui/menu.tsx +9 -3
  138. package/src/components/ui/message-composer.tsx +2 -2
  139. package/src/components/ui/quote.ts +14 -1
  140. package/src/components/ui/shortcut-hint.tsx +28 -3
  141. package/src/components/ui/tabs.tsx +7 -0
  142. package/src/components/ui/text-prompt-dialog.tsx +2 -1
  143. package/src/core/state/app/command-bar-launch.ts +3 -0
  144. package/src/data/config/layout.ts +5 -2
  145. package/src/data/config/store/normalize.ts +6 -0
  146. package/src/docs/snapshot.json +149 -74
  147. package/src/i18n/es.ts +33 -9
  148. package/src/i18n/ja.ts +33 -9
  149. package/src/i18n/ko.ts +33 -9
  150. package/src/i18n/zh-cn.ts +33 -9
  151. package/src/i18n/zh-tw.ts +33 -9
  152. package/src/layout/pane-manager/floating-actions.ts +17 -0
  153. package/src/layout/pane-manager/floating-stack.ts +187 -0
  154. package/src/layout/pane-manager/floating.ts +4 -2
  155. package/src/layout/pane-manager/gridlock.ts +16 -1
  156. package/src/layout/pane-manager/index.ts +11 -0
  157. package/src/layout/pane-manager/layout-state.ts +10 -3
  158. package/src/market-data/bars-per-year.ts +27 -9
  159. package/src/market-data/coordinator/quotes.ts +22 -3
  160. package/src/market-data/futures-board.ts +126 -1
  161. package/src/market-data/futures-contract.ts +21 -6
  162. package/src/market-data/fx-interventions.ts +270 -0
  163. package/src/market-data/market/change-basis.ts +2 -2
  164. package/src/market-data/market/dated-previous-close.ts +163 -47
  165. package/src/market-data/market/format.ts +14 -3
  166. package/src/market-data/market/freshness.ts +24 -7
  167. package/src/market-data/market/header-market.ts +154 -0
  168. package/src/market-data/market/index-level.ts +29 -0
  169. package/src/market-data/market/index-session-venues.ts +44 -0
  170. package/src/market-data/market/status.ts +7 -2
  171. package/src/market-data/market/venue-session.ts +72 -0
  172. package/src/market-data/model-dividend-yield.ts +23 -8
  173. package/src/market-data/options-alternatives.ts +39 -4
  174. package/src/market-data/published-apac-sessions.ts +40 -2
  175. package/src/market-data/quotes/export-identity.ts +76 -0
  176. package/src/market-data/quotes/freshness.ts +22 -0
  177. package/src/market-data/quotes/time.ts +42 -1
  178. package/src/market-data/realized-volatility.ts +11 -7
  179. package/src/market-data/tax-equivalent.ts +145 -27
  180. package/src/news/news-model.ts +44 -2
  181. package/src/plugins/builtin/account-management/pane.tsx +2 -2
  182. package/src/plugins/builtin/alerts/alert-engine.ts +12 -6
  183. package/src/plugins/builtin/alerts/alert-log.ts +6 -2
  184. package/src/plugins/builtin/alerts/calendar-events.ts +74 -12
  185. package/src/plugins/builtin/alerts/cli-forms.ts +11 -1
  186. package/src/plugins/builtin/alerts/cli-move.ts +234 -0
  187. package/src/plugins/builtin/alerts/cli.ts +223 -32
  188. package/src/plugins/builtin/alerts/command.ts +33 -6
  189. package/src/plugins/builtin/alerts/event-rows.ts +18 -4
  190. package/src/plugins/builtin/alerts/events-pane.tsx +6 -2
  191. package/src/plugins/builtin/alerts/events.ts +9 -0
  192. package/src/plugins/builtin/alerts/format.ts +39 -15
  193. package/src/plugins/builtin/alerts/headless.ts +30 -18
  194. package/src/plugins/builtin/alerts/history.ts +1 -0
  195. package/src/plugins/builtin/alerts/index.tsx +86 -12
  196. package/src/plugins/builtin/alerts/live.ts +2 -1
  197. package/src/plugins/builtin/alerts/move-checks.ts +161 -0
  198. package/src/plugins/builtin/alerts/move.ts +181 -0
  199. package/src/plugins/builtin/alerts/pane.tsx +50 -22
  200. package/src/plugins/builtin/alerts/price-text.ts +62 -0
  201. package/src/plugins/builtin/alerts/price.ts +17 -0
  202. package/src/plugins/builtin/alerts/quotes.ts +84 -3
  203. package/src/plugins/builtin/alerts/scheduled-check.ts +7 -1
  204. package/src/plugins/builtin/alerts/storage.ts +22 -7
  205. package/src/plugins/builtin/alerts/types.ts +25 -0
  206. package/src/plugins/builtin/analytics/risk-client.ts +60 -39
  207. package/src/plugins/builtin/analytics/risk-episodes.ts +18 -0
  208. package/src/plugins/builtin/analytics/risk-headless.ts +20 -4
  209. package/src/plugins/builtin/analytics/risk-model.ts +68 -1
  210. package/src/plugins/builtin/analytics/risk-pane.tsx +15 -3
  211. package/src/plugins/builtin/backtest/engine.ts +4 -2
  212. package/src/plugins/builtin/backtest/window.ts +3 -1
  213. package/src/plugins/builtin/broker-manager/sign-in-end.ts +1 -1
  214. package/src/plugins/builtin/central-bank-rates/client.ts +4 -0
  215. package/src/plugins/builtin/central-bank-rates/headless.ts +1 -1
  216. package/src/plugins/builtin/central-bank-rates/model.ts +18 -8
  217. package/src/plugins/builtin/central-bank-rates/pane.tsx +6 -3
  218. package/src/plugins/builtin/changelog/index.tsx +292 -101
  219. package/src/plugins/builtin/changelog/versions.ts +293 -0
  220. package/src/plugins/builtin/chart-composer/cli-options.ts +5 -0
  221. package/src/plugins/builtin/chart-composer/headless-schema.ts +17 -1
  222. package/src/plugins/builtin/chart-composer/headless.ts +2 -0
  223. package/src/plugins/builtin/chart-composer/intervention-events.ts +105 -0
  224. package/src/plugins/builtin/chart-composer/pane.tsx +21 -7
  225. package/src/plugins/builtin/chat/message/render-state.ts +2 -5
  226. package/src/plugins/builtin/cloud/askg/attached-pane.tsx +10 -5
  227. package/src/plugins/builtin/cloud/askg/controller.ts +141 -5
  228. package/src/plugins/builtin/cloud/askg/executor.ts +113 -4
  229. package/src/plugins/builtin/cloud/askg/manifest.ts +28 -13
  230. package/src/plugins/builtin/cloud/askg/model.ts +14 -4
  231. package/src/plugins/builtin/cloud/askg/pane.tsx +70 -46
  232. package/src/plugins/builtin/cloud/askg/turn-parts.tsx +70 -0
  233. package/src/plugins/builtin/cloud/terminal-relay/engine.ts +50 -130
  234. package/src/plugins/builtin/cloud/terminal-relay/policy.ts +327 -7
  235. package/src/plugins/builtin/cloud/terminal-relay/prompts.tsx +2 -1
  236. package/src/plugins/builtin/cloud/terminal-relay/redact.ts +47 -6
  237. package/src/plugins/builtin/cloud/upgrade-status-widget.tsx +9 -2
  238. package/src/plugins/builtin/commodities-energy/index.tsx +1 -3
  239. package/src/plugins/builtin/commodities-energy/view-state.ts +3 -0
  240. package/src/plugins/builtin/cot/headless.ts +14 -2
  241. package/src/plugins/builtin/crypto-board/headless.ts +82 -17
  242. package/src/plugins/builtin/crypto-board/index.tsx +24 -2
  243. package/src/plugins/builtin/crypto-board/model.ts +5 -2
  244. package/src/plugins/builtin/crypto-board/pane.tsx +4 -1
  245. package/src/plugins/builtin/debt-maturities/client.ts +111 -6
  246. package/src/plugins/builtin/debt-maturities/headless.ts +84 -1
  247. package/src/plugins/builtin/debt-maturities/model.ts +97 -14
  248. package/src/plugins/builtin/debt-maturities/pane.tsx +165 -15
  249. package/src/plugins/builtin/debt-maturities/series.ts +3 -1
  250. package/src/plugins/builtin/dividend-yield/client.ts +22 -6
  251. package/src/plugins/builtin/dividend-yield/headless.ts +113 -46
  252. package/src/plugins/builtin/dividend-yield/model.ts +5 -2
  253. package/src/plugins/builtin/dividend-yield/pane.tsx +6 -3
  254. package/src/plugins/builtin/dividend-yield/ranking-reads.ts +11 -4
  255. package/src/plugins/builtin/dividend-yield/ranking.ts +113 -18
  256. package/src/plugins/builtin/dividend-yield/types.ts +2 -0
  257. package/src/plugins/builtin/dividend-yield/view.ts +3 -0
  258. package/src/plugins/builtin/earnings/index.tsx +2 -2
  259. package/src/plugins/builtin/econ/calendar-model.ts +21 -3
  260. package/src/plugins/builtin/econ/detail-view.tsx +5 -3
  261. package/src/plugins/builtin/econ/figures.ts +13 -0
  262. package/src/plugins/builtin/econ/fred-catalog.ts +6 -3
  263. package/src/plugins/builtin/econ/index.tsx +5 -3
  264. package/src/plugins/builtin/econ/types.ts +5 -0
  265. package/src/plugins/builtin/equity-screener/footer.ts +45 -0
  266. package/src/plugins/builtin/equity-screener/pane.tsx +4 -18
  267. package/src/plugins/builtin/equity-screener/ticker-check.tsx +2 -1
  268. package/src/plugins/builtin/fixed-income/model.ts +1 -0
  269. package/src/plugins/builtin/futures/index.tsx +25 -4
  270. package/src/plugins/builtin/futures/model.ts +28 -32
  271. package/src/plugins/builtin/futures/series.ts +4 -3
  272. package/src/plugins/builtin/futures/table.tsx +17 -10
  273. package/src/plugins/builtin/futures/use-board-terms.ts +3 -3
  274. package/src/plugins/builtin/futures-curve/model.ts +3 -10
  275. package/src/plugins/builtin/help/function-card.tsx +2 -1
  276. package/src/plugins/builtin/help/function-index.ts +1 -0
  277. package/src/plugins/builtin/help/index.tsx +3 -3
  278. package/src/plugins/builtin/help/keybindings-editor.tsx +18 -4
  279. package/src/plugins/builtin/insider/client.ts +31 -14
  280. package/src/plugins/builtin/insider/signals-model.ts +2 -7
  281. package/src/plugins/builtin/iv-history/headless.ts +1 -2
  282. package/src/plugins/builtin/iv-history/model.ts +33 -23
  283. package/src/plugins/builtin/iv-history/screen-pane.tsx +0 -3
  284. package/src/plugins/builtin/kelly-sizer/headless.ts +64 -16
  285. package/src/plugins/builtin/kelly-sizer/history.ts +37 -28
  286. package/src/plugins/builtin/kelly-sizer/pane.tsx +43 -10
  287. package/src/plugins/builtin/kelly-sizer/sections.tsx +7 -2
  288. package/src/plugins/builtin/kelly-sizer/units.ts +29 -0
  289. package/src/plugins/builtin/layout-manager/index.tsx +8 -8
  290. package/src/plugins/builtin/news/headless.ts +2 -2
  291. package/src/plugins/builtin/news/index.tsx +10 -16
  292. package/src/plugins/builtin/news/overview-headlines.tsx +117 -0
  293. package/src/plugins/builtin/news/ticker-news.ts +35 -0
  294. package/src/plugins/builtin/news/wire/news/detail-view.tsx +8 -6
  295. package/src/plugins/builtin/news/wire/news/row.ts +49 -0
  296. package/src/plugins/builtin/news/wire/news/table.tsx +9 -20
  297. package/src/plugins/builtin/options/analytics.ts +7 -2
  298. package/src/plugins/builtin/options/live-quotes.ts +6 -1
  299. package/src/plugins/builtin/options/table.ts +3 -2
  300. package/src/plugins/builtin/options/view.tsx +11 -9
  301. package/src/plugins/builtin/options-scenario/client.ts +3 -0
  302. package/src/plugins/builtin/options-scenario/headless.ts +1 -1
  303. package/src/plugins/builtin/perps/client.ts +5 -4
  304. package/src/plugins/builtin/perps/headless.ts +134 -124
  305. package/src/plugins/builtin/perps/markets-section.tsx +7 -4
  306. package/src/plugins/builtin/perps/model.ts +8 -4
  307. package/src/plugins/builtin/perps/open-market.ts +4 -4
  308. package/src/plugins/builtin/perps/venue-markets.ts +3 -6
  309. package/src/plugins/builtin/plugin-marketplace/pane.tsx +11 -11
  310. package/src/plugins/builtin/portfolio-list/cell-version.ts +1 -0
  311. package/src/plugins/builtin/portfolio-list/cli/bulk-symbols.ts +34 -10
  312. package/src/plugins/builtin/portfolio-list/cli/period-report.ts +28 -2
  313. package/src/plugins/builtin/portfolio-list/cli/portfolio-command.ts +7 -3
  314. package/src/plugins/builtin/portfolio-list/cli/render.ts +66 -22
  315. package/src/plugins/builtin/portfolio-list/grid.tsx +5 -3
  316. package/src/plugins/builtin/portfolio-list/pane/data.ts +34 -1
  317. package/src/plugins/builtin/portfolio-list/pane/index.tsx +6 -0
  318. package/src/plugins/builtin/portfolio-list/pane/streaming.ts +15 -6
  319. package/src/plugins/builtin/portfolio-list/quick-add/resolution.ts +19 -7
  320. package/src/plugins/builtin/portfolio-list/summary/index.tsx +3 -1
  321. package/src/plugins/builtin/portfolio-list/table.tsx +30 -4
  322. package/src/plugins/builtin/realized-vol/evidence.ts +33 -6
  323. package/src/plugins/builtin/realized-vol/fx-proxy.ts +135 -0
  324. package/src/plugins/builtin/realized-vol/headless.ts +44 -8
  325. package/src/plugins/builtin/realized-vol/model.ts +9 -5
  326. package/src/plugins/builtin/realized-vol/pane.tsx +49 -15
  327. package/src/plugins/builtin/research/event-model.ts +9 -1
  328. package/src/plugins/builtin/research/event-sources.ts +22 -0
  329. package/src/plugins/builtin/research/headless.ts +3 -3
  330. package/src/plugins/builtin/sec/headless.ts +48 -6
  331. package/src/plugins/builtin/sec/index.tsx +6 -4
  332. package/src/plugins/builtin/sec/model.ts +4 -1
  333. package/src/plugins/builtin/shared/cloud-upgrade.ts +27 -3
  334. package/src/plugins/builtin/shared/earnings-calendar.ts +2 -0
  335. package/src/plugins/builtin/shared/market-cap-bands.ts +12 -0
  336. package/src/plugins/builtin/shared/report-freshness.ts +3 -1
  337. package/src/plugins/builtin/shared/use-quote-board.ts +5 -3
  338. package/src/plugins/builtin/shared/volatility/options.ts +63 -2
  339. package/src/plugins/builtin/social-mentions/headless.ts +72 -3
  340. package/src/plugins/builtin/social-mentions/index.tsx +8 -4
  341. package/src/plugins/builtin/social-mentions/lock-note.ts +6 -2
  342. package/src/plugins/builtin/social-mentions/outliers-client.ts +101 -0
  343. package/src/plugins/builtin/social-mentions/outliers-model.ts +162 -0
  344. package/src/plugins/builtin/social-mentions/outliers-names.ts +51 -0
  345. package/src/plugins/builtin/social-mentions/outliers.tsx +276 -0
  346. package/src/plugins/builtin/social-mentions/pane.tsx +32 -3
  347. package/src/plugins/builtin/supply-chain/graph-pane.tsx +2 -2
  348. package/src/plugins/builtin/thirteenf/api.ts +36 -2
  349. package/src/plugins/builtin/thirteenf/data.ts +4 -1
  350. package/src/plugins/builtin/thirteenf/headless.ts +14 -6
  351. package/src/plugins/builtin/thirteenf/model.ts +56 -1
  352. package/src/plugins/builtin/thirteenf/pane.tsx +8 -8
  353. package/src/plugins/builtin/thirteenf/report-notes.ts +11 -0
  354. package/src/plugins/builtin/thirteenf/table.ts +2 -1
  355. package/src/plugins/builtin/thirteenf/types.ts +6 -0
  356. package/src/plugins/builtin/ticker-detail/data-panes/historical-prices.tsx +23 -3
  357. package/src/plugins/builtin/ticker-detail/financials/model.ts +5 -0
  358. package/src/plugins/builtin/ticker-detail/headless-schema.ts +2 -1
  359. package/src/plugins/builtin/ticker-detail/headless.ts +21 -66
  360. package/src/plugins/builtin/ticker-detail/index.tsx +5 -0
  361. package/src/plugins/builtin/ticker-detail/overview/components.tsx +67 -6
  362. package/src/plugins/builtin/ticker-detail/overview/model.ts +6 -4
  363. package/src/plugins/builtin/ticker-detail/overview/pane.tsx +15 -0
  364. package/src/plugins/builtin/ticker-detail/overview/tax-equivalent.ts +69 -0
  365. package/src/plugins/builtin/ticker-detail/overview-tab.tsx +69 -19
  366. package/src/plugins/builtin/ticker-detail/pane.tsx +7 -2
  367. package/src/plugins/builtin/ticker-detail/quote-monitor/card.tsx +47 -24
  368. package/src/plugins/builtin/ticker-detail/quote-monitor/export.ts +46 -0
  369. package/src/plugins/builtin/ticker-detail/quote-monitor/index.tsx +20 -1
  370. package/src/plugins/builtin/ticker-detail/quote-monitor/rows.ts +120 -0
  371. package/src/plugins/builtin/ticker-detail/research-tabs.ts +1 -5
  372. package/src/plugins/builtin/ticker-detail/settings.ts +6 -6
  373. package/src/plugins/builtin/treasury-auctions/cache.ts +85 -19
  374. package/src/plugins/builtin/treasury-auctions/index.tsx +22 -11
  375. package/src/plugins/builtin/treasury-auctions/model.ts +23 -0
  376. package/src/plugins/builtin/treasury-auctions/treasury-direct.ts +128 -0
  377. package/src/plugins/builtin/world-indices/client.ts +2 -0
  378. package/src/plugins/compat.ts +15 -0
  379. package/src/plugins/host-link.ts +6 -1
  380. package/src/plugins/installer.ts +53 -3
  381. package/src/portfolio/column-values.ts +14 -4
  382. package/src/portfolio/listed-symbol.ts +78 -0
  383. package/src/portfolio/real-return.ts +172 -0
  384. package/src/public/__snapshots__/public-api.test.ts.snap +1 -0
  385. package/src/remote/resources.ts +12 -1
  386. package/src/remote/schema.ts +1 -0
  387. package/src/remote/semantic-helpers.ts +29 -1
  388. package/src/remote/semantic-tree.tsx +32 -15
  389. package/src/renderers/browser/config-host.ts +56 -15
  390. package/src/renderers/browser/main.tsx +3 -1
  391. package/src/renderers/browser/ui-host.tsx +1 -0
  392. package/src/renderers/cloudflare/http-proxy.ts +1 -0
  393. package/src/renderers/cloudflare/worker.ts +16 -1
  394. package/src/renderers/dom/boot-frame.ts +2 -2
  395. package/src/renderers/dom/data-table/row.tsx +4 -1
  396. package/src/renderers/dom/desktop/controls.tsx +4 -4
  397. package/src/renderers/dom/desktop/dialog-actions.tsx +60 -41
  398. package/src/renderers/dom/dom-ui-host.tsx +3 -1
  399. package/src/renderers/dom/host/input.tsx +4 -1
  400. package/src/renderers/dom/host/tabs.tsx +10 -1
  401. package/src/renderers/dom/styles.css +73 -19
  402. package/src/renderers/electrobun/bun/desktop/app-name.ts +1 -1
  403. package/src/renderers/opentui/host.tsx +2 -1
  404. package/src/renderers/share/layout-view.tsx +1 -1
  405. package/src/sources/gloomberb-cloud/fred-series.ts +12 -0
  406. package/src/sources/gloomberb-cloud/index.ts +31 -2
  407. package/src/sources/gloomberb-cloud/news.ts +35 -12
  408. package/src/sources/gloomberb-cloud/normalizers.ts +29 -3
  409. package/src/sources/provider-router/cached-routes.ts +19 -7
  410. package/src/state/opening-ticker-panes.ts +47 -0
  411. package/src/state/pane-table-export-registry.ts +19 -6
  412. package/src/test-support/cli-context.ts +2 -0
  413. package/src/test-support/preload.ts +8 -1
  414. package/src/theme/colors.ts +9 -1
  415. package/src/theme/themes.ts +62 -15
  416. package/src/theme/tone-contrast.ts +40 -0
  417. package/src/theme/ui-tokens.ts +23 -3
  418. package/src/tickers/batched-lookups.ts +57 -8
  419. package/src/tickers/company-name-listing.ts +156 -14
  420. package/src/tickers/company-name.ts +30 -6
  421. package/src/tickers/instrument-kind.ts +23 -3
  422. package/src/tickers/list.ts +7 -0
  423. package/src/tickers/search/home-listing.ts +31 -9
  424. package/src/tickers/search/index.ts +13 -3
  425. package/src/tickers/search/listing-index.ts +558 -0
  426. package/src/tickers/search/major-listings.chunk.ts +10 -0
  427. package/src/tickers/search/major-listings.json +3346 -0
  428. package/src/tickers/search/ranking.ts +68 -1
  429. package/src/tickers/search/types.ts +4 -0
  430. package/src/tickers/terminal-codes.ts +26 -1
  431. package/src/time-series/calendar-month-returns.ts +47 -0
  432. package/src/time-series/currency-conversion.ts +130 -0
  433. package/src/time-series/hooks.ts +2 -0
  434. package/src/time-series/price-comparison.ts +34 -11
  435. package/src/time-series/resolve-context.ts +3 -0
  436. package/src/time-series/resolve.ts +14 -2
  437. package/src/time-series/spec.ts +1 -0
  438. package/src/time-series/studies/indicators.ts +4 -1
  439. package/src/time-series/types.ts +8 -0
  440. package/src/types/config.ts +13 -0
  441. package/src/types/context-menu.ts +2 -0
  442. package/src/types/data-provider.ts +28 -0
  443. package/src/types/financials.ts +20 -2
  444. package/src/types/headless.ts +12 -0
  445. package/src/types/plugin-commands.ts +140 -0
  446. package/src/types/plugin-context.ts +125 -0
  447. package/src/types/plugin-contributions.ts +55 -0
  448. package/src/types/plugin-definition.ts +234 -0
  449. package/src/types/plugin-notifications.ts +38 -0
  450. package/src/types/plugin-pane-settings.ts +114 -0
  451. package/src/types/plugin-pane-templates.ts +160 -0
  452. package/src/types/plugin-panes.ts +221 -0
  453. package/src/types/plugin-reports.ts +35 -0
  454. package/src/types/plugin-shared.ts +14 -0
  455. package/src/types/plugin-state.ts +71 -0
  456. package/src/types/plugin.ts +14 -1169
  457. package/src/ui/host.tsx +8 -0
  458. package/src/ui/index.tsx +14 -3
  459. package/src/updater/github-releases.ts +23 -0
  460. package/src/utils/cli-output.ts +22 -9
  461. package/src/utils/datetime-format.ts +17 -3
  462. package/src/utils/display-number.ts +15 -0
  463. package/src/utils/double-escape-close.ts +61 -16
  464. package/src/utils/float32-price.ts +24 -0
  465. package/src/utils/forward-dividend.ts +81 -16
  466. package/src/utils/fx-market-hours.ts +11 -0
  467. package/src/utils/plugin-proxy-hosts.json +2 -1
  468. package/src/utils/price-history.ts +7 -6
  469. package/src/utils/report-timing.ts +62 -0
  470. package/src/utils/sec-filings.ts +32 -0
  471. package/src/utils/utc-time.ts +5 -0
@@ -579,6 +579,12 @@ export interface AnalystResearchData {
579
579
  export interface DividendAction {
580
580
  exDate: string;
581
581
  amount: number;
582
+ /**
583
+ * Who published the row when it is not the listing's own history: a fund's
584
+ * sponsor, for a distribution the history lacks (iShares, SPDR, J.P. Morgan,
585
+ * VanEck), and the page it is published on. Absent elsewhere and from older servers.
586
+ */
587
+ source?: { publisher: string; url: string };
582
588
  }
583
589
 
584
590
  /**
@@ -700,8 +706,8 @@ export interface NextEarnings {
700
706
  date: string;
701
707
  /** Before the open, during market hours, after the close. */
702
708
  timing: "bmo" | "dmh" | "amc" | null;
703
- /** "history" when the timing is predicted from the last two reports. */
704
- timingSource: "filing" | "calendar" | "history" | null;
709
+ /** "history" when the timing is predicted from the last two reports; "company" when the company announced the date itself. */
710
+ timingSource: "filing" | "calendar" | "history" | "company" | null;
705
711
  }
706
712
 
707
713
  export type IncomeStatementField = "netIncome" | "netIncomeIncludingNoncontrollingInterests" | "netIncomeCommonStockholders";
@@ -1153,6 +1159,18 @@ export interface OptionContract {
1153
1159
  lastTradeDate: number;
1154
1160
  /** Millisecond timestamp for the latest streamed quote applied to this snapshot. */
1155
1161
  lastUpdated?: number;
1162
+ /**
1163
+ * The quote cannot be priced: it is from before the chain's session, or its
1164
+ * ask is under intrinsic value. Its bid and ask are shown, marked stale; no
1165
+ * implied volatility, greek or surface point is read from it.
1166
+ */
1167
+ quoteStale?: boolean;
1168
+ /**
1169
+ * A contract adjusted for a corporate action (root ETHA1 beside ETHA): it
1170
+ * prices another deliverable, so a chain lists it only when asked to, with
1171
+ * what it delivers ("15 ETHA + 120.5 USD cash"; null when the source does not say).
1172
+ */
1173
+ adjusted?: { root: string; deliverable: string | null };
1156
1174
  /**
1157
1175
  * A venue's own mark, for a venue that marks every contract (Deribit): the
1158
1176
  * premium in `currency`, its implied volatility (a decimal) and Black-76
@@ -219,6 +219,11 @@ export interface HeadlessPaneColumn {
219
219
  unitKey?: string;
220
220
  /** With `unitKey`: always a `<header> unit` column, so the header is the same whichever rows loaded. */
221
221
  unitColumn?: boolean;
222
+ /**
223
+ * CSV and NDJSON write the figure to the digits `format` draws (-315.12 for -315.12046875), as it is read on
224
+ * screen; JSON keeps the row's figure whole.
225
+ */
226
+ exportAsShown?: boolean;
222
227
  /**
223
228
  * The text report prints the value on its own lines under the row instead
224
229
  * of in a column, for a footnote that belongs to that row; an empty value
@@ -240,6 +245,13 @@ export interface HeadlessPaneEntry {
240
245
  * rather than read back the number `formatted` draws.
241
246
  */
242
247
  unit?: string;
248
+ /**
249
+ * The unit an export names in `currency_or_unit` for a figure written as
250
+ * `formatted` draws it, where `value` is not in that unit and `unit` would
251
+ * rescale what JSON keeps: a ratio drawn as a percent (`pct`). Named only
252
+ * beside a number; a figure missing with its reason has no unit.
253
+ */
254
+ exportUnit?: string;
243
255
  /**
244
256
  * In a report with `exportDated`, where this line is not of the section's own period and release (a previous
245
257
  * reading, a year ago): the period it covers, when it was released and what it is as of. A null `released`
@@ -0,0 +1,140 @@
1
+ import type { AppConfig, LayoutConfig } from "./config";
2
+ import type { WizardStep } from "./plugin-shared";
3
+
4
+ export interface CommandShortcutArgContext {
5
+ activeTicker: string | null;
6
+ }
7
+
8
+ interface CommandShortcutArgDef {
9
+ placeholder?: string;
10
+ kind?: "text" | "ticker" | "ticker-list";
11
+ parse?: (
12
+ arg: string,
13
+ context: CommandShortcutArgContext,
14
+ ) => Record<string, string>;
15
+ }
16
+
17
+ export interface CommandResultDef {
18
+ id: string;
19
+ label: string;
20
+ detail?: string;
21
+ category?: string;
22
+ /** Short tag drawn left of the label, as on a search provider's row. Six characters at most. */
23
+ badge?: string;
24
+ /** Drawn muted after the label, e.g. a person's full name after their @username. */
25
+ name?: string;
26
+ right?: string;
27
+ keywords?: string[];
28
+ current?: boolean;
29
+ disabled?: boolean;
30
+ execute: () => void | Promise<void>;
31
+ }
32
+
33
+ export interface CommandBarResultLineSegment {
34
+ text: string;
35
+ emphasis?: "match" | "muted";
36
+ }
37
+
38
+ export interface CommandBarResultLine {
39
+ segments: CommandBarResultLineSegment[];
40
+ }
41
+
42
+ export interface CommandBarResultDef {
43
+ id: string;
44
+ label: string;
45
+ detail?: string;
46
+ /** Rendered under the label. Each entry is one additional row. */
47
+ lines?: CommandBarResultLine[];
48
+ category?: string;
49
+ /** Short tag drawn left of the label, e.g. a document type. Six characters at most. */
50
+ badge?: string;
51
+ /** Drawn muted after the label, e.g. a person's full name after their @username. */
52
+ name?: string;
53
+ right?: string;
54
+ keywords?: string[];
55
+ disabled?: boolean;
56
+ execute: () => void | Promise<void>;
57
+ }
58
+
59
+ export interface CommandBarSearchContext {
60
+ activeTicker: string | null;
61
+ activeCollectionId: string | null;
62
+ }
63
+
64
+ export interface CommandBarSearchProvider {
65
+ id: string;
66
+ /** Section heading for these rows, e.g. "Documents". */
67
+ category: string;
68
+ /** Sort position of the section. Higher sinks. Navigation sections are negative; use a positive value to sit below them. */
69
+ priority?: number;
70
+ /** Skip the provider below this length. Default 3. */
71
+ minQueryLength?: number;
72
+ /** Default 300. Ignored by `match`. */
73
+ debounceMs?: number;
74
+ /**
75
+ * How long `provide` may take once it starts, in ms. Default 8000. Past it
76
+ * the bar aborts `signal`, drops a late answer and stops showing Searching.
77
+ * Ignored by `match`.
78
+ */
79
+ timeoutMs?: number;
80
+ /**
81
+ * Codes (`CHAT`) after which the provider is still asked, typed alone or
82
+ * with text after them, with the whole query. Every other provider stays
83
+ * quiet once a code claims the text.
84
+ */
85
+ shortcuts?: readonly string[];
86
+ provide(
87
+ query: string,
88
+ context: CommandBarSearchContext,
89
+ signal: AbortSignal,
90
+ ): Promise<CommandBarResultDef[]>;
91
+ /**
92
+ * Rows from what the app already holds in memory. When set, the bar calls
93
+ * this instead of `provide`, as it renders and on every keystroke, so it
94
+ * must be cheap: no request, no waiting. Its rows are ranked with the bar's
95
+ * own matches as they are typed and sit under Suggested in the empty bar.
96
+ * Keep `provide` answering the same rows for older versions of the app.
97
+ */
98
+ match?(query: string, context: CommandBarSearchContext): CommandBarResultDef[];
99
+ }
100
+
101
+ export interface CommandDef {
102
+ id: string;
103
+ label: string;
104
+ keywords: string[];
105
+ shortcut?: string;
106
+ shortcutArg?: CommandShortcutArgDef;
107
+ buildResults?: (arg: string) => CommandResultDef[];
108
+ execute: (values?: Record<string, string>) => void | Promise<void>;
109
+ category: "navigation" | "data" | "portfolio" | "config";
110
+ description?: string;
111
+ wizard?: WizardStep[];
112
+ confirm?: CommandConfirmDef | ((context: CommandConfirmContext) => CommandConfirmDef | null);
113
+ /** @deprecated Ignored: a wizard always opens as one form with every step at once. */
114
+ wizardLayout?: "steps" | "form";
115
+ hidden?: () => boolean;
116
+ }
117
+
118
+ interface CommandConfirmContext {
119
+ config: AppConfig;
120
+ layout: LayoutConfig;
121
+ activeTicker: string | null;
122
+ activeCollectionId: string | null;
123
+ }
124
+
125
+ interface CommandConfirmDef {
126
+ title: string;
127
+ body: string[];
128
+ confirmLabel?: string;
129
+ cancelLabel?: string;
130
+ tone?: "default" | "danger";
131
+ }
132
+
133
+ export interface KeyboardShortcut {
134
+ id: string;
135
+ key: string;
136
+ ctrl?: boolean;
137
+ shift?: boolean;
138
+ description: string;
139
+ execute: () => void;
140
+ }
@@ -0,0 +1,125 @@
1
+ import type { PluginCapability } from "../capabilities";
2
+ import type { AppTickerRepositoryPort } from "../core/app-service-ports";
3
+ import type { ConnectionHealthRegistry } from "../core/connection-health";
4
+ import type { PluginEvents } from "../plugins/event-bus";
5
+ import type { SeriesDefinition } from "../series/types";
6
+ import type { SyncContributor, SyncTransport } from "../sync/types";
7
+ import type { PluginLogger } from "../utils/debug-log";
8
+ import type { BrokerAdapter } from "./broker";
9
+ import type { BrokerInstanceConfig } from "./config";
10
+ import type { DataProvider } from "./data-provider";
11
+ import type { TickerFinancials } from "./financials";
12
+ import type { BrokerContractRef, TickerListingRef } from "./instrument";
13
+ import type { CommandBarSearchProvider, CommandDef, KeyboardShortcut } from "./plugin-commands";
14
+ import type {
15
+ ContextMenuProviderDef,
16
+ CustomColumnDef,
17
+ TickerAction,
18
+ TickerResearchTabDef,
19
+ } from "./plugin-contributions";
20
+ import type { AppNotificationDelivery, AppNotificationRequest } from "./plugin-notifications";
21
+ import type { PaneTemplateCreateOptions, PaneTemplateDef } from "./plugin-pane-templates";
22
+ import type { PaneDef } from "./plugin-panes";
23
+ import type {
24
+ PluginConfigState,
25
+ PluginPaneSettingsState,
26
+ PluginPersistence,
27
+ PluginResumeState,
28
+ PluginTeamState,
29
+ } from "./plugin-state";
30
+ import type { TickerRecord } from "./ticker";
31
+
32
+ export interface BrokerInstanceUpdateOptions {
33
+ label?: string;
34
+ enabled?: boolean;
35
+ replaceConfig?: boolean;
36
+ /** Keep this connection's data on this device, out of Gloom Cloud sync (`BrokerInstanceConfig.localOnly`). */
37
+ localOnly?: boolean;
38
+ }
39
+
40
+ export interface BrokerInstanceCreateOptions {
41
+ /** Keep the new connection's data on this device from the start, before its first import. */
42
+ localOnly?: boolean;
43
+ }
44
+
45
+ export interface PinTickerOptions {
46
+ floating?: boolean;
47
+ paneType?: string;
48
+ forceNewPane?: boolean;
49
+ /** Preserve a contract explicitly selected from instrument search. */
50
+ instrument?: BrokerContractRef | null;
51
+ listing?: TickerListingRef;
52
+ /** Select this research tab once the requested ticker has resolved. */
53
+ tabId?: string;
54
+ /** Merge this state into the resolved research pane when selecting `tabId`. */
55
+ tabState?: Record<string, unknown>;
56
+ }
57
+
58
+ export interface GloomPluginContext {
59
+ registerPane(pane: PaneDef): void;
60
+ /** Returns a disposer; templates added after setup (team views) use it. */
61
+ registerPaneTemplate(template: PaneTemplateDef): () => void;
62
+ registerCommand(command: CommandDef): void;
63
+ registerCommandBarSearchProvider(provider: CommandBarSearchProvider): () => void;
64
+ registerColumn(column: CustomColumnDef): void;
65
+ registerBroker(broker: BrokerAdapter): void;
66
+ registerCapability(capability: PluginCapability): void;
67
+ registerTickerResearchTab(tab: TickerResearchTabDef): void;
68
+ registerShortcut(shortcut: KeyboardShortcut): void;
69
+ registerTickerAction(action: TickerAction): void;
70
+ registerContextMenuProvider(provider: ContextMenuProviderDef): void;
71
+ /**
72
+ * Adds a series to the data catalog and the chart composer, at any time
73
+ * after setup starts (after loading a list, say). Throws when the definition
74
+ * is invalid or its id is taken; the returned function removes it again.
75
+ */
76
+ registerSeries(series: SeriesDefinition): () => void;
77
+ registerSyncContributor(contributor: SyncContributor): () => void;
78
+ registerSyncTransport(transport: SyncTransport): () => void;
79
+ watchNewsQuery?(
80
+ query: import("./news-source").NewsQuery,
81
+ listener: (state: import("./news-source").NewsQueryState) => void,
82
+ ): () => void;
83
+
84
+ getData(ticker: string): TickerFinancials | null;
85
+ getTicker(ticker: string): TickerRecord | null;
86
+ getConfig(): import("./config").AppConfig;
87
+ /** Resolve a broker registered by another plugin, without connecting it. */
88
+ getBrokerAdapter?(brokerType: string): BrokerAdapter | null;
89
+ getPaneDef(paneId: string): PaneDef | undefined;
90
+
91
+ readonly marketData: DataProvider;
92
+ readonly connectionHealth: ConnectionHealthRegistry;
93
+ readonly tickerRepository: AppTickerRepositoryPort;
94
+ readonly persistence: PluginPersistence;
95
+ readonly log: PluginLogger;
96
+ readonly resume: PluginResumeState;
97
+ readonly configState: PluginConfigState;
98
+ readonly paneSettings: PluginPaneSettingsState;
99
+ readonly teamState: PluginTeamState;
100
+
101
+ createBrokerInstance(brokerType: string, label: string, values: Record<string, unknown>, options?: BrokerInstanceCreateOptions): Promise<BrokerInstanceConfig>;
102
+ updateBrokerInstance(instanceId: string, values: Record<string, unknown>, options?: BrokerInstanceUpdateOptions): Promise<void>;
103
+ syncBrokerInstance(instanceId: string): Promise<void>;
104
+ removeBrokerInstance(instanceId: string): Promise<void>;
105
+
106
+ selectTicker(symbol: string, paneId?: string): void;
107
+ /** Focus the leftmost or rightmost docked pane. */
108
+ switchPanel(panel: "left" | "right"): void;
109
+ switchTab(tabId: string, paneId?: string): void;
110
+ openCommandBar(query?: string): void;
111
+ showPane(paneId: string): void;
112
+ createPaneFromTemplate(templateId: string, options?: PaneTemplateCreateOptions): void;
113
+ hidePane(paneId: string): void;
114
+ focusPane(paneId: string): void;
115
+ pinTicker(symbol: string, options?: PinTickerOptions): void;
116
+ navigateTicker(symbol: string, options?: { sourcePaneId?: string | null }): void;
117
+ openPaneSettings(paneId?: string): void;
118
+ /** Shares a pane instance (the focused pane when omitted): copies a live link to it. */
119
+ sharePane(paneId?: string): void;
120
+
121
+ on<K extends keyof PluginEvents>(event: K, handler: (payload: PluginEvents[K]) => void): () => void;
122
+ emit<K extends keyof PluginEvents>(event: K, payload: PluginEvents[K]): void;
123
+
124
+ notify(notification: AppNotificationRequest): AppNotificationDelivery | void;
125
+ }
@@ -0,0 +1,55 @@
1
+ import type { ReactNode } from "react";
2
+ import type { AppConfig, ColumnConfig } from "./config";
3
+ import type { ContextMenuContext, ContextMenuItem } from "./context-menu";
4
+ import type { TickerFinancials } from "./financials";
5
+ import type { TickerInstrumentKind } from "./instrument";
6
+ import type { TickerRecord } from "./ticker";
7
+
8
+ export interface CustomColumnDef extends ColumnConfig {
9
+ render: (ticker: TickerRecord, financials: TickerFinancials | null) => string;
10
+ }
11
+
12
+ export interface TickerResearchTabProps {
13
+ width: number;
14
+ height: number;
15
+ focused: boolean;
16
+ onCapture: (capturing: boolean) => void;
17
+ }
18
+
19
+ interface TickerResearchTabVisibilityContext {
20
+ config: AppConfig;
21
+ ticker: TickerRecord | null;
22
+ financials: TickerFinancials | null | undefined;
23
+ hasOptionsChain: boolean;
24
+ /** Resolved from the quote, broker contract and saved type; `equity` when nothing says otherwise. */
25
+ instrumentKind: TickerInstrumentKind;
26
+ }
27
+
28
+ export interface TickerResearchTabDef {
29
+ id: string;
30
+ name: string;
31
+ order: number;
32
+ component: (props: TickerResearchTabProps) => ReactNode;
33
+ /**
34
+ * Instrument kinds this tab has data for, such as `["equity"]` for company
35
+ * filings. Omit when every ticker has it (chart, news, notes).
36
+ */
37
+ instruments?: readonly TickerInstrumentKind[];
38
+ /** Narrower checks than `instruments`: a US listing, an options chain, a connected broker. */
39
+ isVisible?: (context: TickerResearchTabVisibilityContext) => boolean;
40
+ }
41
+
42
+ export interface TickerAction {
43
+ id: string;
44
+ label: string;
45
+ keywords: string[];
46
+ filter?: (ticker: TickerRecord) => boolean;
47
+ execute: (ticker: TickerRecord, financials: TickerFinancials | null) => void | Promise<void>;
48
+ }
49
+
50
+ export interface ContextMenuProviderDef {
51
+ id: string;
52
+ order?: number;
53
+ contexts?: ContextMenuContext["kind"][];
54
+ getItems(context: ContextMenuContext): ContextMenuItem[] | null | undefined;
55
+ }
@@ -0,0 +1,234 @@
1
+ import type { ReactNode } from "react";
2
+ import type { PluginCapability } from "../capabilities";
3
+ import type { CliGlobalOptions } from "../cli/options";
4
+ import type { CliResult, CliResultRenderOptions } from "../cli/result";
5
+ import type { SeriesDefinition } from "../series/types";
6
+ import type { PluginLogger } from "../utils/debug-log";
7
+ import type { BrokerAdapter } from "./broker";
8
+ import type { AppConfig } from "./config";
9
+ import type { TickerFinancials } from "./financials";
10
+ import type { GloomPluginContext } from "./plugin-context";
11
+ import type { PaneTemplateDef } from "./plugin-pane-templates";
12
+ import type { PaneDef } from "./plugin-panes";
13
+ import type { TickerRecord } from "./ticker";
14
+
15
+ /**
16
+ * Named render slots. The host renders only `status:widget`; the other names
17
+ * are never drawn and are kept so existing plugins still type-check.
18
+ */
19
+ export interface GloomSlots {
20
+ /** @deprecated Never rendered. Use `ctx.registerTickerResearchTab`. */
21
+ "ticker-research:tab": { ticker: TickerRecord; financials: TickerFinancials | null };
22
+ /** @deprecated Never rendered. Use `ctx.registerTickerResearchTab`. */
23
+ "ticker-research:section": { ticker: TickerRecord; financials: TickerFinancials | null };
24
+ /** @deprecated Never rendered. Use `ctx.registerColumn`. */
25
+ "list:column": { ticker: TickerRecord; financials: TickerFinancials | null };
26
+ /** @deprecated Never rendered. Use `ctx.registerCommandBarSearchProvider`. */
27
+ "command:extra": { query: string };
28
+ /** @deprecated Never rendered. Use `ctx.registerCommand`. */
29
+ "command:preset": Record<string, never>;
30
+ "status:widget": Record<string, never>;
31
+ /** @deprecated Never rendered. Declare settings with `configSchema`. */
32
+ "config:section": Record<string, never>;
33
+ /** @deprecated Never called. Subscribe with `ctx.on("ticker:refreshed")`. */
34
+ "data:post-refresh": { ticker: string; financials: TickerFinancials };
35
+ /** @deprecated Never called. Contribute data with an `asset-data` capability. */
36
+ "data:enricher": { ticker: TickerRecord };
37
+ }
38
+
39
+ interface CliHelpColumn {
40
+ header: string;
41
+ align?: "left" | "right" | "center";
42
+ width?: number;
43
+ }
44
+
45
+ interface CliCommandHelpSection {
46
+ title: string;
47
+ columns?: CliHelpColumn[];
48
+ rows?: string[][];
49
+ lines?: string[];
50
+ }
51
+
52
+ interface CliCommandHelpOption {
53
+ /** Flag spelling with its value, e.g. `--range <range>`. */
54
+ flags: string;
55
+ description: string;
56
+ }
57
+
58
+ interface CliCommandHelp {
59
+ /** Heading `gloom help` lists the command under. Plugin commands without one share a plugin heading. */
60
+ group?: string;
61
+ /** Invocations without the leading `gloomberb`, e.g. `quote <symbol...>`. */
62
+ usage?: string[];
63
+ options?: CliCommandHelpOption[];
64
+ /** Complete invocations without the leading `gloomberb`. */
65
+ examples?: string[];
66
+ /** Extra blocks shown only in the command's own help (`gloom help <command>`). */
67
+ sections?: CliCommandHelpSection[];
68
+ }
69
+
70
+ interface CliLaunchEnvironment {
71
+ terminalWidth: number;
72
+ terminalHeight: number;
73
+ }
74
+
75
+ /**
76
+ * The resume state the app writes at exit and reads at startup. A plugin whose
77
+ * CLI command launches the UI seeds it so the pane opens on what was asked for
78
+ * rather than on what the last session left behind.
79
+ */
80
+ export type { AppSessionSnapshot } from "../core/state/session-persistence";
81
+
82
+ export interface CliLaunchConfigResult<TLaunchState = unknown> {
83
+ config: AppConfig;
84
+ launchState?: TLaunchState;
85
+ }
86
+
87
+ export interface CliLaunchRequest<TLaunchState = unknown> {
88
+ applyConfig(config: AppConfig, env: CliLaunchEnvironment): CliLaunchConfigResult<TLaunchState>;
89
+ applySessionSnapshot?(
90
+ config: AppConfig,
91
+ snapshot: import("../core/state/session-persistence").AppSessionSnapshot | null,
92
+ launchState: TLaunchState | undefined,
93
+ ): import("../core/state/session-persistence").AppSessionSnapshot;
94
+ }
95
+
96
+ export type CliDispatchResult =
97
+ | { kind: "handled" }
98
+ | { kind: "launch-ui"; request: CliLaunchRequest }
99
+ | { kind: "unhandled" };
100
+
101
+ export interface CliCommandContext {
102
+ initConfigData(): Promise<import("../cli/types").ConfigContext>;
103
+ initMarketData(): Promise<import("../cli/types").MarketContext>;
104
+ initServices(): Promise<import("../cli/types").CliServicesContext>;
105
+ cliOptions: CliGlobalOptions;
106
+ plugins: GloomPlugin[];
107
+ fail(message: string, details?: string): never;
108
+ closeAndFail(
109
+ persistence: import("../data/app-persistence").AppPersistence,
110
+ message: string,
111
+ details?: string,
112
+ ): never;
113
+ output: {
114
+ cliStyles: typeof import("../utils/cli-output").cliStyles;
115
+ colorBySign: typeof import("../utils/cli-output").colorBySign;
116
+ renderSection: typeof import("../utils/cli-output").renderSection;
117
+ renderStat: typeof import("../utils/cli-output").renderStat;
118
+ renderStats: typeof import("../utils/cli-output").renderStats;
119
+ renderTable: typeof import("../utils/cli-output").renderTable;
120
+ };
121
+ printResult<T, Row extends Record<string, unknown> = Record<string, unknown>>(
122
+ result: CliResult<T>,
123
+ options?: CliResultRenderOptions<T, Row>,
124
+ ): void;
125
+ log: PluginLogger;
126
+ }
127
+
128
+ export interface CliCommandDef {
129
+ name: string;
130
+ aliases?: string[];
131
+ description: string;
132
+ help?: CliCommandHelp;
133
+ execute(args: string[], ctx: CliCommandContext): void | CliDispatchResult | Promise<void | CliDispatchResult>;
134
+ }
135
+
136
+ /**
137
+ * Where a plugin can actually run.
138
+ *
139
+ * `cli` and `tui` run in Bun and may use Node APIs. `desktop` runs in the
140
+ * Electrobun view. `web` runs in the browser at term.gloom.sh, which rules out
141
+ * Node builtins entirely — a plugin opening a TCP socket (IBKR Gateway) can
142
+ * never be web-capable, no matter what it declares.
143
+ *
144
+ * Plugins may declare this, but the registry derives it from a static import
145
+ * scan and overwrites the declaration. Treat an author-supplied value as a hint.
146
+ */
147
+ export type PluginTarget = "cli" | "tui" | "desktop" | "web";
148
+
149
+ export const ALL_PLUGIN_TARGETS: readonly PluginTarget[] = ["cli", "tui", "desktop", "web"];
150
+
151
+ /**
152
+ * One setting a plugin needs from the user before it is useful, such as an API
153
+ * key. Values are stored in the plugin's `configState` under `key`.
154
+ */
155
+ export interface PluginConfigField {
156
+ key: string;
157
+ label: string;
158
+ type?: "text" | "password" | "number" | "select";
159
+ /** Shown under the field. Say where to get the value, not what the plugin does. */
160
+ description?: string;
161
+ placeholder?: string;
162
+ defaultValue?: string;
163
+ /** The plugin counts as "needs setup" while a required field is empty. Default true. */
164
+ required?: boolean;
165
+ options?: Array<{ label: string; value: string }>;
166
+ }
167
+
168
+ export interface GloomPlugin {
169
+ id: string;
170
+ /**
171
+ * Where this plugin's saved state lives: its `pluginConfig` entry, its resume
172
+ * state, and the per-pane state its panes write. Defaults to `id`.
173
+ *
174
+ * Set it when a plugin is renamed, or moves out of this repository under a
175
+ * new id, so the threads, tabs, and defaults a user already has stay theirs.
176
+ * Everything else (the toggle, the marketplace, seeding) keys off `id`.
177
+ */
178
+ stateId?: string;
179
+ name: string;
180
+ version: string;
181
+ description?: string;
182
+ toggleable?: boolean;
183
+ order?: number;
184
+ cliCommands?: CliCommandDef[];
185
+ /** Defaults to every target when omitted. */
186
+ targets?: readonly PluginTarget[];
187
+ /**
188
+ * Third-party hosts the plugin fetches from, as bare domains
189
+ * (`"api.example.com"`; a parent domain also covers its subdomains).
190
+ *
191
+ * Terminal and desktop reach anything, so this is informational there and
192
+ * is what the plugin directory shows under "Network access". On the web the
193
+ * browser cannot call a host that sends no CORS headers, so the hosted app
194
+ * proxies exactly the hosts the bundled plugins declare here and refuses
195
+ * the rest. A plugin that leaves a host out works on the desktop and fails
196
+ * on the web.
197
+ *
198
+ * Hosts reached by a plugin's dependencies count too: declare every host
199
+ * contacted on the plugin's behalf, including authentication endpoints.
200
+ */
201
+ hosts?: readonly string[];
202
+ /** Shown in the marketplace pane and on the website. */
203
+ homepage?: string;
204
+ /**
205
+ * Settings the plugin cannot work without. Declaring them gives the plugin a
206
+ * "Set up <name>" command, a form the marketplace opens from its `s` key, and
207
+ * a `needs setup` status until every required field has a value. Read the
208
+ * values back with `ctx.configState.get(key)`.
209
+ */
210
+ configSchema?: PluginConfigField[];
211
+ /**
212
+ * Overrides the default readiness rule (every required `configSchema` field
213
+ * has a value) for plugins whose setup is not a plain form, such as a broker
214
+ * login or a file that must exist.
215
+ */
216
+ isConfigured?(values: Record<string, unknown>): boolean;
217
+
218
+ setup?(ctx: GloomPluginContext): void | Promise<void>;
219
+ dispose?(): void;
220
+
221
+ panes?: PaneDef[];
222
+ paneTemplates?: PaneTemplateDef[];
223
+ broker?: BrokerAdapter;
224
+ capabilities?: PluginCapability[];
225
+ /**
226
+ * Series the plugin adds to the data catalog, chartable against any other
227
+ * catalog entry. A definition that fails validation is skipped and logged;
228
+ * `ctx.registerSeries` adds series later and throws instead.
229
+ */
230
+ series?: readonly SeriesDefinition[];
231
+ slots?: Partial<{
232
+ [K in keyof GloomSlots]: (props: GloomSlots[K]) => ReactNode;
233
+ }>;
234
+ }
@@ -0,0 +1,38 @@
1
+ export type AppNotificationType = "info" | "success" | "error";
2
+ type AppDesktopNotificationMode = "never" | "when-inactive" | "always";
3
+
4
+ export interface AppNotificationDelivery {
5
+ toastVisible: boolean;
6
+ desktopRequested: boolean;
7
+ }
8
+
9
+ export interface AppNotificationRequest {
10
+ title?: string;
11
+ body: string;
12
+ subtitle?: string;
13
+ duration?: number;
14
+ type?: AppNotificationType;
15
+ toast?: boolean;
16
+ /** If true, in-app toast stays visible until user dismisses it */
17
+ persistent?: boolean;
18
+ desktop?: AppDesktopNotificationMode;
19
+ /** macOS sound name (e.g., "Glass", "Ping", "Hero"). Ignored on other platforms. */
20
+ sound?: string;
21
+ action?: {
22
+ label: string;
23
+ onClick: () => void;
24
+ };
25
+ /**
26
+ * What a built-in notice is about, so the Unread list can keep it after the
27
+ * toast is gone and open it again: `price:<alertId>`, `catalyst:<eventId>`,
28
+ * `econ:<eventId>`, `team:<cardId>` or `scan:<paneId>`. Other values are not kept.
29
+ */
30
+ refId?: string;
31
+ /** Rendered next to `action`. Use for a dismissing counterpart such as snooze. */
32
+ secondaryAction?: {
33
+ label: string;
34
+ onClick: () => void;
35
+ };
36
+ /** Runs once, when the in-app toast is first drawn. Not called when `toast` is false. */
37
+ onShown?: () => void;
38
+ }