gloomberb 0.20.1 → 0.20.3

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (675) hide show
  1. package/README.md +16 -26
  2. package/README.zh-CN.md +21 -65
  3. package/package.json +2 -1
  4. package/src/account/auth-form.tsx +13 -8
  5. package/src/account/auth-model.ts +20 -1
  6. package/src/account/upgrade-dialog.tsx +8 -4
  7. package/src/api-client/askg.ts +7 -1
  8. package/src/api-client/auth.ts +27 -0
  9. package/src/api-client/catalysts.ts +2 -0
  10. package/src/api-client/central-bank-rates.ts +5 -0
  11. package/src/api-client/company-kpis.ts +2 -1
  12. package/src/api-client/cot.ts +14 -2
  13. package/src/api-client/data.ts +20 -6
  14. package/src/api-client/debt-maturities.ts +45 -2
  15. package/src/api-client/earnings.ts +50 -5
  16. package/src/api-client/errors.ts +21 -11
  17. package/src/api-client/futures-curve.ts +17 -0
  18. package/src/api-client/index.ts +5 -1
  19. package/src/api-client/one-tap-reasons.ts +42 -0
  20. package/src/api-client/paths.ts +9 -1
  21. package/src/api-client/perps.ts +2 -1
  22. package/src/api-client/request.ts +3 -1
  23. package/src/api-client/research-activity.ts +16 -3
  24. package/src/api-client/social-mentions.ts +47 -0
  25. package/src/api-client/types/econ.ts +4 -0
  26. package/src/api-client/types/filings-and-calls.ts +3 -0
  27. package/src/api-client/types/search.ts +3 -0
  28. package/src/app/keybindings/chord.ts +153 -9
  29. package/src/app/keybindings/index.ts +1 -1
  30. package/src/app/keybindings/labels.ts +49 -6
  31. package/src/app/runtime/desktop-deeplink.ts +73 -8
  32. package/src/app.tsx +18 -2
  33. package/src/architecture/core-builtin-allowlist.json +1 -2
  34. package/src/architecture/pane-tabs-allowlist.json +2 -1
  35. package/src/architecture/shortcut-labels-allowlist.json +11 -0
  36. package/src/architecture/ui-literals-allowlist.json +8 -8
  37. package/src/brokers/broker-portfolio-sync.ts +1 -1
  38. package/src/cli/bank-section.ts +26 -12
  39. package/src/cli/command-options.ts +2 -1
  40. package/src/cli/commands/market.ts +372 -99
  41. package/src/cli/commands/options-chain.ts +23 -6
  42. package/src/cli/commands/overview.ts +13 -5
  43. package/src/cli/commands/plugins.ts +49 -18
  44. package/src/cli/commands/search.ts +25 -6
  45. package/src/cli/commands/ticker.ts +16 -9
  46. package/src/cli/desktop-pane-shot-browser.ts +47 -31
  47. package/src/cli/desktop-pane-shot.ts +15 -0
  48. package/src/cli/entry.ts +5 -0
  49. package/src/cli/export-source.ts +7 -1
  50. package/src/cli/freshness.ts +0 -16
  51. package/src/cli/fx-pair.ts +64 -12
  52. package/src/cli/fx-quote-rate.ts +192 -0
  53. package/src/cli/glossary.ts +100 -15
  54. package/src/cli/history-back-adjust.ts +122 -0
  55. package/src/cli/history-rows.ts +122 -34
  56. package/src/cli/index.ts +6 -35
  57. package/src/cli/known-gaps.ts +48 -6
  58. package/src/cli/listing-arg.ts +125 -21
  59. package/src/cli/name-entries.ts +26 -5
  60. package/src/cli/not-a-ticker.ts +6 -2
  61. package/src/cli/pane-functions/capabilities.ts +12 -1
  62. package/src/cli/pane-functions/catalog.ts +12 -2
  63. package/src/cli/pane-functions/dom.ts +4 -2
  64. package/src/cli/pane-functions/function-help.ts +23 -11
  65. package/src/cli/pane-functions/headless.ts +11 -6
  66. package/src/cli/pane-functions/index.ts +35 -4
  67. package/src/cli/pane-functions/market-session.ts +8 -3
  68. package/src/cli/pane-functions/resolver.ts +22 -12
  69. package/src/cli/pane-functions/screenshot-assessment.ts +15 -3
  70. package/src/cli/pane-functions/screenshot-payload.ts +166 -72
  71. package/src/cli/pane-functions/screenshot-render.ts +18 -2
  72. package/src/cli/pane-functions/screenshot-types.ts +4 -0
  73. package/src/cli/quote-answer.ts +10 -0
  74. package/src/cli/report-tables.ts +22 -2
  75. package/src/cli/result.ts +7 -3
  76. package/src/cli/spreadsheet-hint.ts +43 -0
  77. package/src/cli/symbol-list.ts +58 -4
  78. package/src/cli/symbol-rows.ts +71 -4
  79. package/src/cli/ticker-resolution.ts +171 -21
  80. package/src/cli/unknown-command.ts +88 -0
  81. package/src/components/chart/composite/axis-overlays.tsx +13 -3
  82. package/src/components/chart/composite/composite-chart.tsx +8 -1
  83. package/src/components/chart/composite/format.ts +16 -1
  84. package/src/components/chart/composite/legend.tsx +4 -3
  85. package/src/components/chart/composite/panel-labels.ts +2 -1
  86. package/src/components/chart/composite/panel-surface.tsx +33 -4
  87. package/src/components/chart/composite/time-scale.ts +1 -1
  88. package/src/components/chart/composite/toolbar.tsx +8 -4
  89. package/src/components/chart/composite/types.ts +17 -1
  90. package/src/components/chart/composite/use-composite-chart-keyboard.ts +15 -5
  91. package/src/components/chart/composite/use-composite-viewport.ts +31 -8
  92. package/src/components/chart/static/scatter-chart-surface.tsx +25 -9
  93. package/src/components/chart-table/axis.ts +11 -0
  94. package/src/components/command-bar/assist/inventory.ts +3 -2
  95. package/src/components/command-bar/assist/model.ts +6 -1
  96. package/src/components/command-bar/commands/collection-list.ts +3 -2
  97. package/src/components/command-bar/commands/direct/index.ts +9 -1
  98. package/src/components/command-bar/commands/registry.ts +18 -0
  99. package/src/components/command-bar/pane-actions.ts +30 -13
  100. package/src/components/command-bar/panel/index.tsx +6 -3
  101. package/src/components/command-bar/panel/layout.ts +8 -1
  102. package/src/components/command-bar/panel/prompt-binding.ts +4 -0
  103. package/src/components/command-bar/panel/prompt-width.ts +34 -0
  104. package/src/components/command-bar/panel/state.ts +4 -0
  105. package/src/components/command-bar/panel/types.ts +3 -0
  106. package/src/components/command-bar/routes/header-market.ts +108 -0
  107. package/src/components/command-bar/routes/root/command-items.ts +5 -0
  108. package/src/components/command-bar/routes/root/provider-search.ts +190 -32
  109. package/src/components/command-bar/routes/root/results.ts +3 -0
  110. package/src/components/command-bar/routes/root/runtime.ts +28 -5
  111. package/src/components/command-bar/routes/root/search-providers.ts +3 -2
  112. package/src/components/command-bar/routes/root/search-report.ts +2 -2
  113. package/src/components/command-bar/routes/ticker-search/results.ts +53 -6
  114. package/src/components/command-bar/routing/list-state.ts +38 -0
  115. package/src/components/command-bar/selection-hint.ts +28 -0
  116. package/src/components/command-bar/surface/index.tsx +41 -3
  117. package/src/components/command-bar/view-model.ts +15 -0
  118. package/src/components/command-bar/workflow/ticker-listing-picker.ts +1 -0
  119. package/src/components/command-bar/workflow/tickers.ts +3 -2
  120. package/src/components/company-logo.tsx +22 -4
  121. package/src/components/data-table/export.ts +13 -8
  122. package/src/components/data-table/view.tsx +11 -2
  123. package/src/components/feed-data-table/stack-view.tsx +20 -6
  124. package/src/components/feedback-dialog.tsx +5 -2
  125. package/src/components/form-modal/field-row.tsx +3 -2
  126. package/src/components/form-modal/routes.ts +1 -0
  127. package/src/components/index.ts +1 -1
  128. package/src/components/input-search-bar.tsx +2 -2
  129. package/src/components/layout/double-escape-close.ts +8 -5
  130. package/src/components/layout/header.tsx +87 -47
  131. package/src/components/layout/market-summary.ts +323 -116
  132. package/src/components/layout/pane/footer/index.tsx +31 -9
  133. package/src/components/layout/pane/footer/model.ts +63 -21
  134. package/src/components/layout/pane/footer/registration.tsx +60 -1
  135. package/src/components/layout/pane/header-tabs.tsx +17 -3
  136. package/src/components/layout/pane/header.tsx +8 -4
  137. package/src/components/layout/pane/pane-tabs.tsx +57 -3
  138. package/src/components/layout/shell/active-drag.ts +38 -30
  139. package/src/components/layout/shell/chrome.ts +15 -15
  140. package/src/components/layout/shell/drag/index.ts +51 -21
  141. package/src/components/layout/shell/menu.ts +3 -5
  142. package/src/components/layout/shell/pane/actions.ts +4 -1
  143. package/src/components/layout/shell/pane/ask.ts +5 -2
  144. package/src/components/layout/status-bar.tsx +63 -57
  145. package/src/components/layout/status-widget-space.ts +8 -0
  146. package/src/components/markdown-editor.tsx +2 -2
  147. package/src/components/markdown-text.tsx +35 -10
  148. package/src/components/onboarding/account-step/form-panel.tsx +0 -3
  149. package/src/components/onboarding/first-run-workspace.ts +25 -23
  150. package/src/components/onboarding/onboarding-keyboard.ts +21 -7
  151. package/src/components/onboarding/onboarding-wizard.tsx +73 -13
  152. package/src/components/onboarding/portfolio-step/broker-fields-panel.tsx +0 -1
  153. package/src/components/onboarding/portfolio-step/positions-panel.tsx +3 -5
  154. package/src/components/onboarding/use-onboarding-broker-form.ts +2 -1
  155. package/src/components/onboarding/use-onboarding-progress.ts +11 -4
  156. package/src/components/onboarding/use-onboarding-upgrade.ts +3 -2
  157. package/src/components/onboarding/wizard-positions.ts +8 -1
  158. package/src/components/pane-notice-seen.ts +125 -0
  159. package/src/components/pane-settings-dialog/field-dialogs.tsx +2 -1
  160. package/src/components/pane-settings-dialog.tsx +7 -6
  161. package/src/components/price-sparkline/model.ts +26 -10
  162. package/src/components/sign-in-code-panel.tsx +3 -2
  163. package/src/components/speedometer-gauge/terminal.tsx +30 -9
  164. package/src/components/ticker/list-table-view.tsx +68 -7
  165. package/src/components/ui/button.tsx +13 -2
  166. package/src/components/ui/column-grid.tsx +18 -9
  167. package/src/components/ui/confirm-dialog.tsx +2 -1
  168. package/src/components/ui/data-table/index.tsx +5 -3
  169. package/src/components/ui/data-table/opentui/index.tsx +17 -6
  170. package/src/components/ui/data-table/types.ts +26 -0
  171. package/src/components/ui/delayed-mark.tsx +3 -2
  172. package/src/components/ui/external-link.tsx +4 -1
  173. package/src/components/ui/field-grid.tsx +1 -3
  174. package/src/components/ui/fields.tsx +7 -4
  175. package/src/components/ui/index.ts +2 -0
  176. package/src/components/ui/inline-quick-add.tsx +7 -2
  177. package/src/components/ui/key-hint-words.ts +153 -0
  178. package/src/components/ui/key-hints.tsx +73 -0
  179. package/src/components/ui/menu.tsx +3 -1
  180. package/src/components/ui/message-composer.tsx +2 -2
  181. package/src/components/ui/multi-select/dialog.tsx +10 -9
  182. package/src/components/ui/pane-link-chip.tsx +354 -0
  183. package/src/components/ui/query-bar.tsx +22 -13
  184. package/src/components/ui/ratio-bar.tsx +24 -1
  185. package/src/components/ui/select-button.tsx +2 -1
  186. package/src/components/ui/shortcut-hint.tsx +32 -4
  187. package/src/components/ui/table-layout.ts +81 -0
  188. package/src/components/ui/tabs.tsx +52 -6
  189. package/src/components/ui/text-prompt-dialog.tsx +2 -1
  190. package/src/components/use-pane-notice-footer.tsx +12 -4
  191. package/src/core/app-service-ports.ts +1 -1
  192. package/src/core/state/app/command-bar-launch.ts +3 -0
  193. package/src/data/config/store/normalize.ts +6 -0
  194. package/src/data/plugin-state-store.ts +44 -8
  195. package/src/docs/snapshot.json +172 -100
  196. package/src/i18n/es.ts +48 -6
  197. package/src/i18n/ja.ts +48 -5
  198. package/src/i18n/ko.ts +48 -5
  199. package/src/i18n/zh-cn.ts +48 -5
  200. package/src/i18n/zh-tw.ts +48 -5
  201. package/src/layout/pane-manager/gridlock-inference.ts +2 -1
  202. package/src/layout/pane-manager/gridlock.ts +58 -2
  203. package/src/layout-marketplace/api.ts +1 -0
  204. package/src/layout-marketplace/gallery.tsx +4 -3
  205. package/src/layout-marketplace/linked.ts +6 -4
  206. package/src/layout-marketplace/model.ts +3 -2
  207. package/src/market-data/bars-per-year.ts +27 -9
  208. package/src/market-data/coordinator/quotes.ts +22 -3
  209. package/src/market-data/futures-board.ts +80 -0
  210. package/src/market-data/futures-contract.ts +86 -34
  211. package/src/market-data/fx-closes.ts +5 -2
  212. package/src/market-data/hooks.tsx +23 -0
  213. package/src/market-data/market/change-basis.ts +74 -16
  214. package/src/market-data/market/dated-previous-close.ts +163 -47
  215. package/src/market-data/market/format.ts +33 -14
  216. package/src/market-data/market/freshness.ts +24 -7
  217. package/src/market-data/market/globex-day.ts +73 -0
  218. package/src/market-data/market/header-market.ts +154 -0
  219. package/src/market-data/market/index-level.ts +39 -1
  220. package/src/market-data/market/index-session-venues.ts +44 -0
  221. package/src/market-data/market/status.ts +7 -2
  222. package/src/market-data/market/venue-session.ts +72 -0
  223. package/src/market-data/model-dividend-yield.ts +23 -8
  224. package/src/market-data/options-alternatives.ts +39 -4
  225. package/src/market-data/published-apac-sessions.ts +40 -2
  226. package/src/market-data/quotes/export-identity.ts +76 -0
  227. package/src/market-data/quotes/freshness.ts +22 -0
  228. package/src/market-data/quotes/intraday-bar.ts +1 -1
  229. package/src/market-data/quotes/session-split.ts +28 -0
  230. package/src/market-data/quotes/time.ts +42 -1
  231. package/src/market-data/realized-volatility.ts +11 -7
  232. package/src/market-data/tax-equivalent.ts +145 -27
  233. package/src/plugins/builtin/account-management/pane.tsx +3 -3
  234. package/src/plugins/builtin/alerts/alert-engine.ts +12 -6
  235. package/src/plugins/builtin/alerts/alert-log.ts +6 -2
  236. package/src/plugins/builtin/alerts/calendar-events.ts +74 -12
  237. package/src/plugins/builtin/alerts/cli-forms.ts +11 -1
  238. package/src/plugins/builtin/alerts/cli-move.ts +234 -0
  239. package/src/plugins/builtin/alerts/cli.ts +224 -33
  240. package/src/plugins/builtin/alerts/command.ts +33 -6
  241. package/src/plugins/builtin/alerts/event-rows.ts +18 -4
  242. package/src/plugins/builtin/alerts/events-pane.tsx +6 -2
  243. package/src/plugins/builtin/alerts/events.ts +9 -0
  244. package/src/plugins/builtin/alerts/format.ts +40 -15
  245. package/src/plugins/builtin/alerts/headless.ts +31 -18
  246. package/src/plugins/builtin/alerts/history.ts +1 -0
  247. package/src/plugins/builtin/alerts/index.tsx +86 -12
  248. package/src/plugins/builtin/alerts/live.ts +2 -1
  249. package/src/plugins/builtin/alerts/move-checks.ts +155 -0
  250. package/src/plugins/builtin/alerts/move.ts +160 -0
  251. package/src/plugins/builtin/alerts/pane.tsx +52 -22
  252. package/src/plugins/builtin/alerts/price-text.ts +62 -0
  253. package/src/plugins/builtin/alerts/price.ts +17 -0
  254. package/src/plugins/builtin/alerts/quotes.ts +84 -3
  255. package/src/plugins/builtin/alerts/scheduled-check.ts +7 -1
  256. package/src/plugins/builtin/alerts/storage.ts +20 -7
  257. package/src/plugins/builtin/alerts/types.ts +13 -0
  258. package/src/plugins/builtin/analytics/account-returns.ts +1 -1
  259. package/src/plugins/builtin/analytics/index.tsx +10 -3
  260. package/src/plugins/builtin/analytics/pane-model.ts +1 -1
  261. package/src/plugins/builtin/analytics/risk-client.ts +64 -40
  262. package/src/plugins/builtin/analytics/risk-episodes.ts +440 -0
  263. package/src/plugins/builtin/analytics/risk-fx.ts +1 -1
  264. package/src/plugins/builtin/analytics/risk-headless.ts +44 -10
  265. package/src/plugins/builtin/analytics/risk-math.ts +1 -1
  266. package/src/plugins/builtin/analytics/risk-model.ts +183 -27
  267. package/src/plugins/builtin/analytics/risk-pane.tsx +216 -26
  268. package/src/plugins/builtin/analytics/sharpe-cadence.ts +1 -1
  269. package/src/plugins/builtin/backtest/engine.ts +4 -2
  270. package/src/plugins/builtin/backtest/format.ts +14 -0
  271. package/src/plugins/builtin/backtest/pane.tsx +3 -3
  272. package/src/plugins/builtin/backtest/report.ts +5 -3
  273. package/src/plugins/builtin/backtest/window.ts +3 -1
  274. package/src/plugins/builtin/broker-manager/add-request.ts +10 -1
  275. package/src/plugins/builtin/broker-manager/sign-in-end.ts +1 -1
  276. package/src/plugins/builtin/broker-trading/pane.tsx +20 -2
  277. package/src/plugins/builtin/buildout/company/flow.tsx +5 -5
  278. package/src/plugins/builtin/buildout/company/model.ts +14 -2
  279. package/src/plugins/builtin/catalysts/detail.tsx +2 -2
  280. package/src/plugins/builtin/catalysts/model.ts +7 -2
  281. package/src/plugins/builtin/catalysts/pane.tsx +2 -2
  282. package/src/plugins/builtin/central-bank-rates/client.ts +4 -0
  283. package/src/plugins/builtin/central-bank-rates/headless.ts +1 -1
  284. package/src/plugins/builtin/central-bank-rates/model.ts +18 -8
  285. package/src/plugins/builtin/central-bank-rates/pane.tsx +6 -3
  286. package/src/plugins/builtin/chart-composer/cli-options.ts +5 -0
  287. package/src/plugins/builtin/chart-composer/headless-schema.ts +17 -1
  288. package/src/plugins/builtin/chart-composer/headless.ts +2 -0
  289. package/src/plugins/builtin/chat/message/pane-chip.tsx +36 -208
  290. package/src/plugins/builtin/cloud/askg/answer-follow-ups.tsx +61 -0
  291. package/src/plugins/builtin/cloud/askg/answer-sources.tsx +102 -0
  292. package/src/plugins/builtin/cloud/askg/controller.ts +7 -1
  293. package/src/plugins/builtin/cloud/askg/host.ts +57 -0
  294. package/src/plugins/builtin/cloud/askg/model.ts +45 -5
  295. package/src/plugins/builtin/cloud/askg/pane.tsx +304 -25
  296. package/src/plugins/builtin/cloud/askg/protocol.ts +26 -1
  297. package/src/plugins/builtin/cloud/askg/sources.ts +466 -0
  298. package/src/plugins/builtin/cloud/one-tap/controller.ts +309 -0
  299. package/src/plugins/builtin/cloud/one-tap/google-identity.ts +142 -0
  300. package/src/plugins/builtin/cloud/one-tap/one-tap-prompt.tsx +101 -0
  301. package/src/plugins/builtin/cloud/plugin.tsx +7 -1
  302. package/src/plugins/builtin/cloud/upgrade-status-widget.tsx +9 -2
  303. package/src/plugins/builtin/company-kpis/client.ts +4 -3
  304. package/src/plugins/builtin/company-kpis/model.ts +34 -3
  305. package/src/plugins/builtin/correlation/index.tsx +39 -167
  306. package/src/plugins/builtin/correlation/matrix/grid.tsx +285 -0
  307. package/src/plugins/builtin/correlation/relationship/pane.tsx +6 -7
  308. package/src/plugins/builtin/correlation/relationship/view-model.ts +14 -5
  309. package/src/plugins/builtin/cot/client.ts +8 -3
  310. package/src/plugins/builtin/cot/headless.ts +65 -12
  311. package/src/plugins/builtin/cot/pane.tsx +11 -5
  312. package/src/plugins/builtin/crypto-board/headless.ts +82 -17
  313. package/src/plugins/builtin/crypto-board/index.tsx +24 -2
  314. package/src/plugins/builtin/crypto-board/model.ts +5 -2
  315. package/src/plugins/builtin/crypto-board/pane.tsx +4 -1
  316. package/src/plugins/builtin/debt-maturities/client.ts +111 -6
  317. package/src/plugins/builtin/debt-maturities/headless.ts +84 -1
  318. package/src/plugins/builtin/debt-maturities/model.ts +97 -14
  319. package/src/plugins/builtin/debt-maturities/pane.tsx +165 -15
  320. package/src/plugins/builtin/debt-maturities/series.ts +3 -1
  321. package/src/plugins/builtin/dividend-yield/client.ts +22 -6
  322. package/src/plugins/builtin/dividend-yield/headless.ts +113 -46
  323. package/src/plugins/builtin/dividend-yield/model.ts +5 -2
  324. package/src/plugins/builtin/dividend-yield/pane.tsx +6 -3
  325. package/src/plugins/builtin/dividend-yield/ranking-reads.ts +11 -4
  326. package/src/plugins/builtin/dividend-yield/ranking.ts +113 -18
  327. package/src/plugins/builtin/dividend-yield/types.ts +2 -0
  328. package/src/plugins/builtin/dividend-yield/view.ts +3 -0
  329. package/src/plugins/builtin/earnings/client.ts +40 -6
  330. package/src/plugins/builtin/earnings/fiscal-quarter.ts +54 -0
  331. package/src/plugins/builtin/earnings/headless.ts +47 -11
  332. package/src/plugins/builtin/earnings/history-model.ts +136 -24
  333. package/src/plugins/builtin/earnings/history-table.ts +42 -10
  334. package/src/plugins/builtin/earnings/history.tsx +23 -8
  335. package/src/plugins/builtin/earnings-ripple/client.ts +5 -2
  336. package/src/plugins/builtin/earnings-ripple/headless.ts +8 -3
  337. package/src/plugins/builtin/earnings-ripple/model.ts +21 -0
  338. package/src/plugins/builtin/earnings-ripple/pane.tsx +2 -3
  339. package/src/plugins/builtin/econ/calendar-model.ts +21 -3
  340. package/src/plugins/builtin/econ/detail-view.tsx +5 -3
  341. package/src/plugins/builtin/econ/figures.ts +13 -0
  342. package/src/plugins/builtin/econ/fred-catalog.ts +6 -3
  343. package/src/plugins/builtin/econ/index.tsx +10 -7
  344. package/src/plugins/builtin/econ/types.ts +5 -0
  345. package/src/plugins/builtin/econ-statistics/stats.ts +13 -5
  346. package/src/plugins/builtin/equity-screener/footer.ts +45 -0
  347. package/src/plugins/builtin/equity-screener/headless.ts +2 -1
  348. package/src/plugins/builtin/equity-screener/pane.tsx +4 -18
  349. package/src/plugins/builtin/equity-screener/ticker-check.tsx +2 -1
  350. package/src/plugins/builtin/filing-events/feed.ts +56 -18
  351. package/src/plugins/builtin/filing-events/pane.tsx +8 -2
  352. package/src/plugins/builtin/fixed-income/model.ts +1 -0
  353. package/src/plugins/builtin/futures/index.tsx +32 -10
  354. package/src/plugins/builtin/futures/model.ts +93 -6
  355. package/src/plugins/builtin/futures/returns.ts +29 -7
  356. package/src/plugins/builtin/futures/table.tsx +59 -17
  357. package/src/plugins/builtin/futures/use-front-returns.ts +32 -6
  358. package/src/plugins/builtin/futures-curve/client.ts +12 -2
  359. package/src/plugins/builtin/futures-curve/headless.ts +58 -17
  360. package/src/plugins/builtin/futures-curve/model.ts +114 -25
  361. package/src/plugins/builtin/futures-curve/pane.tsx +11 -6
  362. package/src/plugins/builtin/fx-matrix/amount.ts +132 -0
  363. package/src/plugins/builtin/fx-matrix/headless.ts +53 -13
  364. package/src/plugins/builtin/fx-matrix/index.tsx +205 -42
  365. package/src/plugins/builtin/fx-matrix/pairs.ts +10 -8
  366. package/src/plugins/builtin/fx-matrix/settings.ts +22 -1
  367. package/src/plugins/builtin/help/function-card.tsx +2 -1
  368. package/src/plugins/builtin/help/function-index.ts +1 -0
  369. package/src/plugins/builtin/help/index.tsx +68 -61
  370. package/src/plugins/builtin/holders/format.ts +7 -2
  371. package/src/plugins/builtin/holders/pane.tsx +11 -3
  372. package/src/plugins/builtin/holders/report-header.ts +5 -4
  373. package/src/plugins/builtin/holders/report-rows.ts +4 -1
  374. package/src/plugins/builtin/holders/treemap.tsx +5 -3
  375. package/src/plugins/builtin/insider/client.ts +31 -14
  376. package/src/plugins/builtin/insider/signals-model.ts +6 -12
  377. package/src/plugins/builtin/ipo-calendar/headless.ts +18 -7
  378. package/src/plugins/builtin/ipo-calendar/listing-ipo.ts +3 -1
  379. package/src/plugins/builtin/ipo-calendar/model.ts +28 -8
  380. package/src/plugins/builtin/ipo-calendar/pane.tsx +2 -1
  381. package/src/plugins/builtin/iv-history/headless.ts +1 -2
  382. package/src/plugins/builtin/iv-history/model.ts +33 -23
  383. package/src/plugins/builtin/iv-history/screen-pane.tsx +0 -3
  384. package/src/plugins/builtin/kelly-sizer/headless.ts +68 -16
  385. package/src/plugins/builtin/kelly-sizer/history.ts +37 -28
  386. package/src/plugins/builtin/kelly-sizer/pane.tsx +43 -10
  387. package/src/plugins/builtin/kelly-sizer/sections.tsx +7 -2
  388. package/src/plugins/builtin/kelly-sizer/units.ts +29 -0
  389. package/src/plugins/builtin/news/index.tsx +7 -13
  390. package/src/plugins/builtin/news/overview-headlines.tsx +117 -0
  391. package/src/plugins/builtin/news/ticker-news.ts +35 -0
  392. package/src/plugins/builtin/news/wire/news/detail-view.tsx +8 -6
  393. package/src/plugins/builtin/news/wire/news/row.ts +49 -0
  394. package/src/plugins/builtin/news/wire/news/table.tsx +9 -20
  395. package/src/plugins/builtin/options/analytics.ts +7 -2
  396. package/src/plugins/builtin/options/live-quotes.ts +6 -1
  397. package/src/plugins/builtin/options/table.ts +3 -2
  398. package/src/plugins/builtin/options/view.tsx +11 -9
  399. package/src/plugins/builtin/options-scenario/client.ts +3 -0
  400. package/src/plugins/builtin/options-scenario/headless.ts +1 -1
  401. package/src/plugins/builtin/perps/client.ts +5 -4
  402. package/src/plugins/builtin/perps/headless.ts +189 -123
  403. package/src/plugins/builtin/perps/index.tsx +3 -1
  404. package/src/plugins/builtin/perps/markets-section.tsx +2 -2
  405. package/src/plugins/builtin/perps/model.ts +9 -5
  406. package/src/plugins/builtin/perps/open-market.ts +4 -4
  407. package/src/plugins/builtin/perps/pane.tsx +2 -0
  408. package/src/plugins/builtin/perps/venue-markets.ts +3 -6
  409. package/src/plugins/builtin/portfolio-list/cell-version.ts +2 -0
  410. package/src/plugins/builtin/portfolio-list/cli/bulk-symbols.ts +54 -11
  411. package/src/plugins/builtin/portfolio-list/cli/import-positions.ts +260 -0
  412. package/src/plugins/builtin/portfolio-list/cli/period-report.ts +180 -0
  413. package/src/plugins/builtin/portfolio-list/cli/portfolio-command.ts +68 -22
  414. package/src/plugins/builtin/portfolio-list/cli/render.ts +82 -27
  415. package/src/plugins/builtin/portfolio-list/cli/watchlist-command.ts +5 -3
  416. package/src/plugins/builtin/portfolio-list/grid.tsx +61 -15
  417. package/src/plugins/builtin/portfolio-list/headless.ts +128 -0
  418. package/src/plugins/builtin/portfolio-list/pane/data.ts +34 -1
  419. package/src/plugins/builtin/portfolio-list/pane/index.tsx +48 -4
  420. package/src/plugins/builtin/portfolio-list/pane/period-pnl.ts +124 -0
  421. package/src/plugins/builtin/portfolio-list/pane/streaming.ts +15 -6
  422. package/src/plugins/builtin/portfolio-list/period-pnl.ts +179 -0
  423. package/src/plugins/builtin/portfolio-list/positions-import/dialog.tsx +445 -0
  424. package/src/plugins/builtin/portfolio-list/positions-import/index.tsx +255 -0
  425. package/src/plugins/builtin/portfolio-list/positions-import/lookup.ts +78 -0
  426. package/src/plugins/builtin/portfolio-list/positions-import/read-file.ts +32 -0
  427. package/src/plugins/builtin/portfolio-list/quick-add/index.tsx +186 -50
  428. package/src/plugins/builtin/portfolio-list/quick-add/resolution.ts +137 -11
  429. package/src/plugins/builtin/portfolio-list/settings.ts +25 -0
  430. package/src/plugins/builtin/portfolio-list/summary/index.tsx +16 -1
  431. package/src/plugins/builtin/portfolio-list/summary/totals.ts +7 -5
  432. package/src/plugins/builtin/portfolio-list/table.tsx +134 -9
  433. package/src/plugins/builtin/power/headless.ts +47 -9
  434. package/src/plugins/builtin/realized-vol/evidence.ts +33 -6
  435. package/src/plugins/builtin/realized-vol/fx-proxy.ts +135 -0
  436. package/src/plugins/builtin/realized-vol/headless.ts +44 -8
  437. package/src/plugins/builtin/realized-vol/model.ts +9 -5
  438. package/src/plugins/builtin/realized-vol/pane.tsx +49 -15
  439. package/src/plugins/builtin/research/relative-valuation-model.ts +8 -3
  440. package/src/plugins/builtin/research-search/article.ts +12 -2
  441. package/src/plugins/builtin/research-search/data.ts +5 -2
  442. package/src/plugins/builtin/research-search/document-view.tsx +1 -1
  443. package/src/plugins/builtin/research-search/model.ts +47 -3
  444. package/src/plugins/builtin/research-search/pane.tsx +3 -2
  445. package/src/plugins/builtin/reverse-dcf/model.ts +7 -4
  446. package/src/plugins/builtin/risk-factors/headless.ts +3 -2
  447. package/src/plugins/builtin/risk-factors/pane.tsx +5 -3
  448. package/src/plugins/builtin/scanner/flow-model.ts +17 -13
  449. package/src/plugins/builtin/scanner/flow-pane.tsx +8 -9
  450. package/src/plugins/builtin/scanner/flow-session.ts +2 -9
  451. package/src/plugins/builtin/sec/filing-display.tsx +0 -5
  452. package/src/plugins/builtin/sec/forms.ts +19 -0
  453. package/src/plugins/builtin/sec/headless.ts +55 -17
  454. package/src/plugins/builtin/sec/index.tsx +17 -7
  455. package/src/plugins/builtin/sec/model.ts +4 -1
  456. package/src/plugins/builtin/shared/earnings-calendar.ts +8 -3
  457. package/src/plugins/builtin/shared/earnings-report.ts +1 -1
  458. package/src/plugins/builtin/shared/fx-rate-freshness.ts +0 -35
  459. package/src/plugins/builtin/shared/market-cap-bands.ts +12 -0
  460. package/src/plugins/builtin/shared/report-freshness.ts +3 -1
  461. package/src/plugins/builtin/shared/use-quote-board.ts +47 -30
  462. package/src/plugins/builtin/shared/volatility/options.ts +63 -2
  463. package/src/plugins/builtin/social-mentions/headless.ts +72 -3
  464. package/src/plugins/builtin/social-mentions/index.tsx +8 -4
  465. package/src/plugins/builtin/social-mentions/lock-note.ts +6 -2
  466. package/src/plugins/builtin/social-mentions/outliers-client.ts +101 -0
  467. package/src/plugins/builtin/social-mentions/outliers-model.ts +162 -0
  468. package/src/plugins/builtin/social-mentions/outliers-names.ts +51 -0
  469. package/src/plugins/builtin/social-mentions/outliers.tsx +276 -0
  470. package/src/plugins/builtin/social-mentions/pane.tsx +32 -3
  471. package/src/plugins/builtin/supply-chain/graph-model.ts +7 -1
  472. package/src/plugins/builtin/supply-chain/graph-pane.tsx +2 -2
  473. package/src/plugins/builtin/supply-chain/headless.ts +20 -10
  474. package/src/plugins/builtin/supply-chain/model.ts +117 -20
  475. package/src/plugins/builtin/supply-chain/pane.tsx +22 -15
  476. package/src/plugins/builtin/supply-chain/row-evidence.tsx +1 -1
  477. package/src/plugins/builtin/thirteenf/api.ts +36 -2
  478. package/src/plugins/builtin/thirteenf/data.ts +4 -1
  479. package/src/plugins/builtin/thirteenf/headless.ts +14 -6
  480. package/src/plugins/builtin/thirteenf/model.ts +56 -1
  481. package/src/plugins/builtin/thirteenf/pane.tsx +8 -8
  482. package/src/plugins/builtin/thirteenf/report-notes.ts +11 -0
  483. package/src/plugins/builtin/thirteenf/table.ts +2 -1
  484. package/src/plugins/builtin/thirteenf/types.ts +6 -0
  485. package/src/plugins/builtin/ticker-detail/data-panes/historical-prices.tsx +23 -3
  486. package/src/plugins/builtin/ticker-detail/data-panes/returns-chart-model.ts +69 -0
  487. package/src/plugins/builtin/ticker-detail/data-panes/returns-chart.tsx +118 -0
  488. package/src/plugins/builtin/ticker-detail/data-panes/returns-model.ts +1 -1
  489. package/src/plugins/builtin/ticker-detail/data-panes/returns-pane.tsx +103 -40
  490. package/src/plugins/builtin/ticker-detail/financials/model.ts +5 -0
  491. package/src/plugins/builtin/ticker-detail/headless-schema.ts +12 -2
  492. package/src/plugins/builtin/ticker-detail/headless.ts +21 -59
  493. package/src/plugins/builtin/ticker-detail/index.tsx +5 -0
  494. package/src/plugins/builtin/ticker-detail/overview/components.tsx +15 -2
  495. package/src/plugins/builtin/ticker-detail/overview/model.ts +10 -6
  496. package/src/plugins/builtin/ticker-detail/overview/pane.tsx +15 -0
  497. package/src/plugins/builtin/ticker-detail/overview/tax-equivalent.ts +69 -0
  498. package/src/plugins/builtin/ticker-detail/overview-tab.tsx +52 -14
  499. package/src/plugins/builtin/ticker-detail/pane.tsx +95 -20
  500. package/src/plugins/builtin/ticker-detail/quote-monitor/card.tsx +47 -24
  501. package/src/plugins/builtin/ticker-detail/quote-monitor/export.ts +46 -0
  502. package/src/plugins/builtin/ticker-detail/quote-monitor/index.tsx +20 -1
  503. package/src/plugins/builtin/ticker-detail/quote-monitor/rows.ts +120 -0
  504. package/src/plugins/builtin/ticker-detail/research-groups.ts +89 -0
  505. package/src/plugins/builtin/ticker-detail/research-tabs.ts +1 -5
  506. package/src/plugins/builtin/ticker-detail/settings.ts +10 -9
  507. package/src/plugins/builtin/treasury-auctions/cache.ts +85 -19
  508. package/src/plugins/builtin/treasury-auctions/index.tsx +22 -11
  509. package/src/plugins/builtin/treasury-auctions/model.ts +23 -0
  510. package/src/plugins/builtin/treasury-auctions/treasury-direct.ts +128 -0
  511. package/src/plugins/builtin/volatility/charts.tsx +2 -2
  512. package/src/plugins/builtin/world-indices/client.ts +2 -0
  513. package/src/plugins/compat.ts +15 -0
  514. package/src/plugins/host-link.ts +6 -1
  515. package/src/plugins/host-resolver.ts +3 -2
  516. package/src/plugins/installer.ts +8 -3
  517. package/src/portfolio/column-values.ts +56 -12
  518. package/src/portfolio/futures-positions.ts +10 -2
  519. package/src/portfolio/listed-symbol.ts +78 -0
  520. package/src/portfolio/mutations.ts +4 -3
  521. package/src/portfolio/period-pnl.ts +119 -0
  522. package/src/portfolio/positions-import/describe.ts +89 -0
  523. package/src/portfolio/positions-import/parse.ts +682 -0
  524. package/src/portfolio/positions-import/plan.ts +295 -0
  525. package/src/portfolio/real-return.ts +172 -0
  526. package/src/{plugins/builtin/analytics/metrics.ts → portfolio/return-metrics.ts} +24 -11
  527. package/src/public/__snapshots__/public-api.test.ts.snap +2 -0
  528. package/src/react/jsx-dev-fallback.ts +62 -0
  529. package/src/renderers/browser/cloud-transport.ts +1 -1
  530. package/src/renderers/browser/config-host.ts +59 -16
  531. package/src/renderers/browser/deeplink-bridge.ts +8 -1
  532. package/src/renderers/browser/http-proxy-transport.ts +9 -2
  533. package/src/renderers/browser/main.tsx +5 -2
  534. package/src/renderers/browser/research-entry.ts +12 -0
  535. package/src/renderers/browser/ui-host.tsx +1 -0
  536. package/src/renderers/cloudflare/http-proxy.ts +9 -2
  537. package/src/renderers/cloudflare/proxy-session.ts +1 -0
  538. package/src/renderers/cloudflare/worker.ts +12 -3
  539. package/src/renderers/dom/boot-frame.ts +2 -2
  540. package/src/renderers/dom/data-table/row.tsx +4 -1
  541. package/src/renderers/dom/desktop/audio-player.tsx +2 -2
  542. package/src/renderers/dom/desktop/controls.tsx +5 -5
  543. package/src/renderers/dom/desktop/dialog-actions.tsx +62 -57
  544. package/src/renderers/dom/desktop/icons.tsx +4 -2
  545. package/src/renderers/dom/desktop/query-bar.tsx +23 -19
  546. package/src/renderers/dom/dom-host-providers.tsx +7 -2
  547. package/src/renderers/dom/dom-ui-host.tsx +3 -1
  548. package/src/renderers/dom/host/box.tsx +2 -2
  549. package/src/renderers/dom/host/input.tsx +17 -1
  550. package/src/renderers/dom/host/tabs.tsx +10 -1
  551. package/src/renderers/dom/key-event.ts +1 -0
  552. package/src/renderers/dom/styles.css +36 -13
  553. package/src/renderers/electrobun/bun/context-menu/click.ts +1 -0
  554. package/src/renderers/electrobun/bun/desktop/app-name.ts +1 -1
  555. package/src/renderers/electrobun/bun/desktop/backend.ts +1 -0
  556. package/src/renderers/electrobun/bun/desktop/capability-bridge.ts +5 -4
  557. package/src/renderers/electrobun/bun/desktop/host-requests.ts +5 -4
  558. package/src/renderers/electrobun/bun/desktop/http-fetch.ts +1 -0
  559. package/src/renderers/electrobun/bun/desktop/http-stream.ts +1 -1
  560. package/src/renderers/electrobun/bun/desktop/initialization.ts +3 -1
  561. package/src/renderers/electrobun/bun/desktop/install-records.ts +4 -1
  562. package/src/renderers/electrobun/bun/desktop/installer-folder.ts +5 -2
  563. package/src/renderers/electrobun/bun/desktop/macos-objc.ts +3 -1
  564. package/src/renderers/electrobun/bun/desktop/screen-setup-file.ts +9 -4
  565. package/src/renderers/electrobun/bun/desktop/update.ts +27 -13
  566. package/src/renderers/electrobun/bun/desktop/windows-script.ts +6 -2
  567. package/src/renderers/electrobun/bun/window/attention.ts +1 -0
  568. package/src/renderers/electrobun/bun/window/boot-frame.ts +1 -0
  569. package/src/renderers/electrobun/bun/window/create.ts +1 -0
  570. package/src/renderers/electrobun/bun/window/electrobun-window-host.ts +13 -8
  571. package/src/renderers/electrobun/bun/window/native-min-size.ts +1 -1
  572. package/src/renderers/electrobun/bun/window/remembered-frame.ts +1 -0
  573. package/src/renderers/electrobun/bun/window/windows-native.ts +3 -1
  574. package/src/renderers/electrobun/bun/window/windows-quit.ts +3 -1
  575. package/src/renderers/electrobun/view/app-badge-host.ts +2 -1
  576. package/src/renderers/electrobun/view/capability-subscription.ts +2 -1
  577. package/src/renderers/electrobun/view/cli-pane-shot-entry.tsx +7 -10
  578. package/src/renderers/electrobun/view/cli-pane-shot-mutations.ts +36 -0
  579. package/src/renderers/electrobun/view/http-fetch.ts +2 -1
  580. package/src/renderers/electrobun/view/main.tsx +9 -4
  581. package/src/renderers/electrobun/view/remote/capability-invoker.ts +6 -3
  582. package/src/renderers/electrobun/view/remote/persistence.ts +63 -27
  583. package/src/renderers/electrobun/view/rpc-timeout.ts +1 -0
  584. package/src/renderers/electrobun/view/ui-host.tsx +3 -2
  585. package/src/renderers/electrobun/view/window-fullscreen.ts +3 -1
  586. package/src/renderers/opentui/browser-open.ts +2 -1
  587. package/src/renderers/opentui/dialog-host.tsx +1 -1
  588. package/src/renderers/opentui/host.tsx +2 -1
  589. package/src/renderers/opentui/interaction-performance.ts +3 -1
  590. package/src/renderers/opentui/start.tsx +2 -1
  591. package/src/renderers/opentui/terminal-media.ts +11 -6
  592. package/src/renderers/opentui/ui-host.tsx +5 -8
  593. package/src/shares/open.ts +22 -1
  594. package/src/shares/pane.ts +2 -1
  595. package/src/sources/gloomberb-cloud/fred-series.ts +12 -0
  596. package/src/sources/gloomberb-cloud/index.ts +31 -2
  597. package/src/sources/gloomberb-cloud/normalizers.ts +32 -3
  598. package/src/sources/provider-router/cached-routes.ts +19 -7
  599. package/src/state/pane-table-export-registry.ts +19 -6
  600. package/src/sync/analytics-payload.ts +194 -0
  601. package/src/sync/baseline.ts +19 -9
  602. package/src/sync/broker-identity.ts +171 -0
  603. package/src/sync/broker-instances.ts +137 -0
  604. package/src/sync/collections-contributor.ts +173 -0
  605. package/src/sync/config-contributor.ts +100 -0
  606. package/src/sync/config-merge.ts +229 -0
  607. package/src/sync/controller.ts +139 -28
  608. package/src/sync/core-contributors.ts +8 -1583
  609. package/src/sync/history-memo.ts +32 -0
  610. package/src/sync/layout-merge.ts +259 -0
  611. package/src/sync/sanitize.ts +114 -0
  612. package/src/sync/ticker-merge.ts +208 -0
  613. package/src/sync/ticker-payload.ts +81 -0
  614. package/src/sync/types.ts +15 -1
  615. package/src/telemetry/attention-setting.ts +1 -1
  616. package/src/telemetry/usage-counts.ts +16 -0
  617. package/src/test-support/preload.ts +9 -0
  618. package/src/theme/color-utils.ts +10 -0
  619. package/src/theme/colors.ts +9 -1
  620. package/src/theme/font-scale.ts +34 -3
  621. package/src/theme/series-colors.ts +44 -0
  622. package/src/theme/themes.ts +64 -16
  623. package/src/theme/tone-contrast.ts +40 -0
  624. package/src/theme/ui-tokens.ts +23 -3
  625. package/src/tickers/batched-lookups.ts +314 -8
  626. package/src/tickers/company-name-listing.ts +198 -14
  627. package/src/tickers/company-name.ts +37 -8
  628. package/src/tickers/list.ts +7 -0
  629. package/src/tickers/search/home-listing.ts +31 -9
  630. package/src/tickers/search/index.ts +13 -3
  631. package/src/tickers/search/listing-index.ts +558 -0
  632. package/src/tickers/search/major-listings.chunk.ts +10 -0
  633. package/src/tickers/search/major-listings.json +3346 -0
  634. package/src/tickers/search/ranking.ts +68 -1
  635. package/src/tickers/search/types.ts +4 -0
  636. package/src/tickers/search/upsert.ts +16 -1
  637. package/src/tickers/terminal-codes.ts +26 -1
  638. package/src/time-series/base-series.ts +18 -4
  639. package/src/time-series/calendar-month-returns.ts +47 -0
  640. package/src/time-series/currency-conversion.ts +130 -0
  641. package/src/time-series/hooks.ts +2 -0
  642. package/src/time-series/price-comparison.ts +34 -11
  643. package/src/time-series/resolve-context.ts +3 -0
  644. package/src/time-series/resolve.ts +14 -2
  645. package/src/time-series/spec.ts +1 -0
  646. package/src/time-series/studies/indicators.ts +7 -2
  647. package/src/time-series/studies/resolve.ts +1 -1
  648. package/src/time-series/types.ts +14 -0
  649. package/src/types/config.ts +8 -0
  650. package/src/types/data-provider.ts +28 -0
  651. package/src/types/financials.ts +38 -2
  652. package/src/types/headless.ts +23 -0
  653. package/src/ui/host.tsx +34 -3
  654. package/src/ui/index.tsx +1 -0
  655. package/src/utils/concurrency.ts +6 -0
  656. package/src/utils/currency-pair.ts +56 -4
  657. package/src/utils/datetime-format.ts +28 -3
  658. package/src/utils/decimal-comma.ts +9 -6
  659. package/src/utils/display-number.ts +15 -0
  660. package/src/utils/double-escape-close.ts +61 -16
  661. package/src/utils/exchanges.ts +32 -0
  662. package/src/utils/float32-price.ts +24 -0
  663. package/src/utils/forward-dividend.ts +81 -16
  664. package/src/utils/fundamentals.ts +41 -0
  665. package/src/utils/fx-market-hours.ts +11 -0
  666. package/src/utils/markdown.ts +4 -2
  667. package/src/utils/pasted-lines.ts +14 -0
  668. package/src/utils/plugin-proxy-hosts.json +2 -1
  669. package/src/utils/price-history.ts +7 -6
  670. package/src/utils/price-window.ts +2 -1
  671. package/src/utils/report-timing.ts +62 -0
  672. package/src/utils/sec-filings.ts +49 -0
  673. package/src/utils/sec.ts +4 -23
  674. package/src/utils/shortcut-labels.ts +6 -30
  675. package/src/utils/utc-time.ts +5 -0
@@ -1,4 +1,5 @@
1
- import { INDEX_POINTS_EXPORT_UNIT, INDEX_POINTS_LABEL, isIndexLevel } from "../market-data/market/index-level";
1
+ import { INDEX_POINTS_EXPORT_UNIT, INDEX_POINTS_LABEL, isIndexLevel, YIELD_INDEX_EXPORT_UNIT } from "../market-data/market/index-level";
2
+ import { isYieldIndexSymbol } from "../tickers/index-roots";
2
3
  import type { PricePoint } from "../types/financials";
3
4
  import { formatPriceObservation, marketPriceFractionDigitCeiling, resolveAssetDisplayKind } from "../market-data/market/format";
4
5
  import { TIME_RANGES, type TimeRange } from "../time-series/range";
@@ -13,7 +14,7 @@ import { classifyInstrumentType } from "../tickers/instrument-kind";
13
14
  import { isRoundTheClockCoin } from "../utils/crypto-pair";
14
15
  import { currencyPairCode } from "../utils/currency-pair";
15
16
  import { currencyUnitLabel, resolveCurrencyUnit } from "../utils/currency-units";
16
- import { getPricePointTimestamp } from "../utils/price-history";
17
+ import { dailyBarDate, getPricePointTimestamp } from "../utils/price-history";
17
18
  import {
18
19
  isWickFlag, latestTradeIndex, missingVolumeNotice, pricePointIntegrityFlags, pricePointValues, pricePointWickFlags,
19
20
  } from "../utils/price-history-integrity";
@@ -24,6 +25,13 @@ import { barLastSession, barPeriodToDate, type BarPeriodToDate } from "../market
24
25
  import { barSizeFromGap, medianBarGap } from "../time-series/bar-spacing";
25
26
  import { isRegularSessionTime, sessionCalendarTimeZone } from "../market-data/market/freshness";
26
27
  import { zonedDateKey } from "../utils/zoned-date-time";
28
+ import { cleanFloat32Price, decimalPlaces } from "../utils/float32-price";
29
+ import { futuresBoardContract } from "../market-data/futures-board";
30
+ import { isFuturesInstrument } from "../market-data/futures-contract";
31
+ import { contractPriceUnit } from "../time-series/price-units";
32
+
33
+ /** A float32 price as the decimal it is, which a quote's dated close is cleaned with too (utils/float32-price). */
34
+ export { cleanFloat32Price };
27
35
 
28
36
  const PRICE_KEYS = ["open", "high", "low", "close"] as const;
29
37
  const DAY_MS = 24 * 60 * 60 * 1000;
@@ -93,6 +101,12 @@ export interface HistoryRow {
93
101
  roll?: true;
94
102
  /** The bar traded far below the bars around it (THIN_VOLUME_SHARE of their median): a price on few trades. */
95
103
  thin?: true;
104
+ /**
105
+ * A monthly bar whose prices contradict each other (`flag`) keeps its close;
106
+ * its open, high and low were rebuilt from the month's daily bars
107
+ * (withDailyRebuiltBars), else they are blank.
108
+ */
109
+ rebuilt?: "daily bars";
96
110
  }
97
111
 
98
112
  /** A coin's volume: traded value in its quote currency, per UTC day on daily bars. */
@@ -100,29 +114,6 @@ export interface HistoryVolume {
100
114
  unit: string;
101
115
  }
102
116
 
103
- function decimalPlaces(value: number): number {
104
- const [mantissa = "", exponent = "0"] = Math.abs(value).toString().split("e");
105
- return Math.max(0, (mantissa.split(".")[1]?.length ?? 0) - Number(exponent));
106
- }
107
-
108
- /**
109
- * Providers serve prices as float32: The feed sends the exact float
110
- * (340.33 arrives as 340.3299865722656) and the cloud a float already rounded
111
- * to a few decimals (254.42999). Return the shortest decimal that is the same
112
- * float32. Values with fewer than five decimals are left alone, and a precise
113
- * double only moves within float32 precision (about seven significant digits).
114
- */
115
- export function cleanFloat32Price(value: number): number {
116
- if (!Number.isFinite(value) || value === 0 || decimalPlaces(value) < 5) return value;
117
- const target = Math.fround(value);
118
- for (let digits = 1; digits <= 9; digits++) {
119
- const candidate = Number(value.toPrecision(digits));
120
- if (Math.fround(candidate) !== target) continue;
121
- return candidate.toString().length < value.toString().length ? candidate : value;
122
- }
123
- return value;
124
- }
125
-
126
117
  /**
127
118
  * The finest step a venue that quotes in a sub-unit prices in, in decimals of
128
119
  * that unit: a ten-thousandth of a penny, the smallest tick London's tick
@@ -267,6 +258,77 @@ function flagCodes(row: Pick<HistoryRow, "flag">): string[] {
267
258
  return row.flag ? row.flag.split(",") : [];
268
259
  }
269
260
 
261
+ const finiteOrNull = (value: number | undefined | null) => typeof value === "number" && Number.isFinite(value) ? value : null;
262
+
263
+ /** Whether a contradictory monthly bar's close can stand: a positive number. */
264
+ function keptMonthlyClose(point: PricePoint): boolean {
265
+ return typeof point.close === "number" && Number.isFinite(point.close) && point.close > 0;
266
+ }
267
+
268
+ /** Days a month's daily bars may leave out at either end or between two of them and still say its range: a week. */
269
+ const REBUILD_MAX_HOLE_DAYS = 7;
270
+
271
+ /** Flagged months a few apart are read in one span of daily bars: the months between cost less than another read. */
272
+ const REBUILD_SPAN_GAP_MONTHS = 3;
273
+ /** The longest span one read of daily bars covers: a year. */
274
+ const REBUILD_SPAN_MONTHS = 12;
275
+
276
+ const monthIndex = (month: string) => Number(month.slice(0, 4)) * 12 + Number(month.slice(5, 7)) - 1;
277
+
278
+ /**
279
+ * The spans of daily bars that rebuild the flagged `months` (YYYY-MM), each
280
+ * read once: neighbouring months, up to REBUILD_SPAN_GAP_MONTHS apart, share
281
+ * a span of at most a year, so ZC=F's twelve flagged months since 2000 take
282
+ * six reads rather than twelve.
283
+ */
284
+ export function dailyRebuildSpans(months: readonly string[]): Array<{ from: string; to: string }> {
285
+ const spans: Array<{ from: string; to: string }> = [];
286
+ for (const month of [...new Set(months)].filter((value) => /^\d{4}-\d{2}$/.test(value)).sort()) {
287
+ const span = spans.at(-1);
288
+ if (span && monthIndex(month) - monthIndex(span.to) <= REBUILD_SPAN_GAP_MONTHS
289
+ && monthIndex(month) - monthIndex(span.from) < REBUILD_SPAN_MONTHS) span.to = month;
290
+ else spans.push({ from: month, to: month });
291
+ }
292
+ return spans;
293
+ }
294
+
295
+ /**
296
+ * Monthly bars whose prices contradict each other, their close kept
297
+ * (historyRows), with open, high and low rebuilt from the month's daily bars:
298
+ * the first open, the highest high and the lowest low. A month is rebuilt
299
+ * only when its daily bars cover it, no week of it without one, and their
300
+ * range holds the kept close; otherwise its open, high and low stay blank.
301
+ * Daily bars whose own prices contradict each other are not read. A daily
302
+ * bar's day is the one the listing's `exchange` trades it on (dailyBarDate):
303
+ * a Sydney session stamped 23:00 UTC the evening before is still the 1st.
304
+ */
305
+ export function withDailyRebuiltBars(rows: readonly HistoryRow[], daily: readonly PricePoint[], priceDivisor = 1, exchange = ""): HistoryRow[] {
306
+ const byMonth = new Map<string, Array<{ day: number; open: number | null; high: number; low: number }>>();
307
+ for (const point of daily) {
308
+ const time = getPricePointTimestamp(point);
309
+ const values = pricePointValues(point);
310
+ if (!Number.isFinite(time) || values.high == null || values.low == null) continue;
311
+ const date = dailyBarDate(time, exchange);
312
+ const days = byMonth.get(date.slice(0, 7)) ?? [];
313
+ days.push({ day: Date.parse(`${date}T00:00:00Z`) / DAY_MS, open: values.open, high: values.high, low: values.low });
314
+ byMonth.set(date.slice(0, 7), days);
315
+ }
316
+ return rows.map((row) => {
317
+ if (row.interval !== "1mo" || row.close == null || row.open != null || blankingCodes(row).length === 0) return row;
318
+ const days = [...(byMonth.get(row.date.slice(0, 7)) ?? [])].sort((left, right) => left.day - right.day);
319
+ const first = Date.parse(`${row.date.slice(0, 7)}-01T00:00:00Z`) / DAY_MS;
320
+ const start = new Date(first * DAY_MS);
321
+ const last = Date.UTC(start.getUTCFullYear(), start.getUTCMonth() + 1, 0) / DAY_MS;
322
+ const stops = [first - 1, ...days.map((entry) => entry.day), last + 1];
323
+ if (days.length === 0 || stops.slice(1).some((day, index) => day - stops[index]! > REBUILD_MAX_HOLE_DAYS)) return row;
324
+ const open = days[0]!.open;
325
+ const high = cleanBarPrice(Math.max(...days.map((entry) => entry.high)), priceDivisor);
326
+ const low = cleanBarPrice(Math.min(...days.map((entry) => entry.low)), priceDivisor);
327
+ if (open == null || row.close > high || row.close < low) return row;
328
+ return { ...row, open: cleanBarPrice(open, priceDivisor), high, low, rebuilt: "daily bars" as const };
329
+ });
330
+ }
331
+
270
332
  /** The codes of a bar left blank for prices that contradict each other: not a break before it, nor a withheld wick. */
271
333
  function blankingCodes(row: Pick<HistoryRow, "flag">): string[] {
272
334
  return flagCodes(row).filter((code) => !BREAK_FLAGS.has(code) && !isWickFlag(code));
@@ -297,8 +359,11 @@ export function historyRows(
297
359
  const rows = points.map((point, index) => {
298
360
  const time = times[index]!;
299
361
  const iso = Number.isFinite(time) ? new Date(time).toISOString() : "";
300
- const values = pricePointValues(point);
301
362
  const flags = [...pricePointIntegrityFlags(point), ...pricePointWickFlags(point)];
363
+ // A monthly bar whose prices contradict each other keeps its close and volume: a continuous future's month
364
+ // (ZC=F's September 2000) can join one contract's open to another's range. Every other bar is blanked whole.
365
+ const kept = interval === "1mo" && pricePointIntegrityFlags(point).length > 0 && keptMonthlyClose(point);
366
+ const values = kept ? { ...pricePointValues(point), close: point.close!, volume: finiteOrNull(point.volume) } : pricePointValues(point);
302
367
  const price = (value: number | null) => value == null ? null : cleanBarPrice(value, priceDivisor);
303
368
  return {
304
369
  date: intraday ? iso.replace(".000Z", "Z") : iso.slice(0, 10),
@@ -378,14 +443,14 @@ function thinVolumeBars(rows: readonly (Pick<HistoryRow, "volume" | "partial"> &
378
443
  }
379
444
 
380
445
  /** A roll of a continuous future: the bar it rolled at, and the contracts either side. */
381
- interface HistoryRoll {
446
+ export interface HistoryRoll {
382
447
  date: string;
383
448
  from: string;
384
449
  to: string;
385
450
  }
386
451
 
387
452
  /** Every roll in a history's bars (`roll`), oldest first. */
388
- function historyRolls(rows: readonly Pick<HistoryRow, "date" | "contract" | "roll">[]): HistoryRoll[] {
453
+ export function historyRolls(rows: readonly Pick<HistoryRow, "date" | "contract" | "roll">[]): HistoryRoll[] {
389
454
  let contract: string | null = null;
390
455
  const rolls: HistoryRoll[] = [];
391
456
  for (const row of rows) {
@@ -723,7 +788,8 @@ export function historyIntervalsByRange(): string {
723
788
  }
724
789
 
725
790
  export interface HistoryUnit {
726
- kind: "currency" | "pair" | "points" | "unknown";
791
+ /** `contract`: a future's price in its contract's unit, `US cents / bushel`, the spelling FUT and G use. */
792
+ kind: "currency" | "pair" | "points" | "contract" | "unknown";
727
793
  /** Currency code of the prices; null for index points or when no source says. */
728
794
  currency: string | null;
729
795
  /** What one price is: "USD", "ILA (agorot, 1/100 ILS)", "ZAR per USD", "index points"; null when unknown. */
@@ -737,14 +803,25 @@ export interface HistoryUnit {
737
803
  * named as such. Without one the unit is unknown rather than guessed from the
738
804
  * exchange.
739
805
  */
740
- export function historyUnit(listing: string, quote: { currency?: string; instrumentType?: string } | null | undefined): HistoryUnit {
806
+ export function historyUnit(
807
+ listing: string,
808
+ quote: { currency?: string; instrumentType?: string } | null | undefined,
809
+ /** A future's unit from its contract terms (`US cents / bushel`), else the futures catalog's. */
810
+ priceUnit?: string | null,
811
+ ): HistoryUnit {
741
812
  const pair = currencyPairCode(listing.trim().toUpperCase());
742
813
  if (pair) {
743
814
  const [base, counter] = [pair.slice(0, 3), pair.slice(3)];
744
815
  return { kind: "pair", currency: counter, unit: `${counter} per ${base}` };
745
816
  }
817
+ // A Cboe yield index is a yield in percent, the unit `quote` exports it in, not index points.
818
+ if (isYieldIndexSymbol(listing)) return { kind: "points", currency: null, unit: YIELD_INDEX_EXPORT_UNIT };
746
819
  if (isIndexLevel(quote?.instrumentType)) return { kind: "points", currency: null, unit: INDEX_POINTS_EXPORT_UNIT };
747
820
  const code = quote?.currency?.trim();
821
+ // A future is priced in its contract's unit, spelled one way in the text, CSV and JSON.
822
+ const future = !!code && isFuturesInstrument(listing, quote?.instrumentType);
823
+ const contractUnit = future ? contractPriceUnit(priceUnit ?? futuresBoardContract(listing.trim().toUpperCase())?.unit, code) : null;
824
+ if (code && contractUnit) return { kind: "contract", currency: code, unit: contractUnit };
748
825
  return code
749
826
  ? { kind: "currency", currency: code, unit: currencyUnitLabel(code, { ofMajor: true }) }
750
827
  : { kind: "unknown", currency: null, unit: null };
@@ -752,7 +829,7 @@ export function historyUnit(listing: string, quote: { currency?: string; instrum
752
829
 
753
830
  /** The unit an export names for a history's prices: a pair's quote currency per base (`JPY per USD`), else its currency or unit. */
754
831
  export function historyExportUnit(unit: HistoryUnit): string | null {
755
- return unit.kind === "pair" ? unit.unit : unit.currency ?? unit.unit;
832
+ return unit.kind === "pair" || unit.kind === "contract" ? unit.unit : unit.currency ?? unit.unit;
756
833
  }
757
834
 
758
835
  function historyDate(value: string): string {
@@ -776,7 +853,8 @@ export function historyFacts(unit: HistoryUnit, rows: readonly Pick<HistoryRow,
776
853
  const interval = rows[0]?.interval;
777
854
  const unbroken = historyUnbrokenFrom(rows);
778
855
  return [
779
- unit.kind === "pair" ? unit.unit! : unit.kind === "points" ? INDEX_POINTS_LABEL : `Currency ${unit.unit ?? "unknown"}`,
856
+ unit.kind === "pair" ? unit.unit! : unit.kind === "points" ? unit.unit === YIELD_INDEX_EXPORT_UNIT ? "Yield, percent" : INDEX_POINTS_LABEL
857
+ : unit.kind === "contract" ? `Unit ${unit.unit}` : `Currency ${unit.unit ?? "unknown"}`,
780
858
  interval ? `${BAR_INTERVAL_LABELS[interval]} bars` : "",
781
859
  first && last ? (first === last ? historyDate(first) : `${historyDate(first)} to ${historyDate(last)}`) : "",
782
860
  `${rows.length} ${rows.length === 1 ? "bar" : "bars"}`,
@@ -1008,7 +1086,7 @@ export function historyGapNote(
1008
1086
  * null when every bar agrees. Bars flagged only for a gap or jump before them
1009
1087
  * keep their prices and are not counted.
1010
1088
  */
1011
- export function historyFlagNote(rows: readonly Pick<HistoryRow, "flag">[]): string | null {
1089
+ export function historyFlagNote(rows: readonly Pick<HistoryRow, "flag" | "close" | "rebuilt">[]): string | null {
1012
1090
  const flagged = rows.filter((row) => blankingCodes(row).length > 0);
1013
1091
  if (flagged.length === 0) return null;
1014
1092
  const codes = new Set(flagged.flatMap(blankingCodes));
@@ -1018,7 +1096,17 @@ export function historyFlagNote(rows: readonly Pick<HistoryRow, "flag">[]): stri
1018
1096
  codes.has("low>high") ? "low above high" : "",
1019
1097
  ].filter(Boolean);
1020
1098
  const count = `${flagged.length} of ${rows.length} ${flagged.length === 1 && rows.length === 1 ? "bar" : "bars"}`;
1021
- return `${count} ${flagged.length === 1 ? "has" : "have"} ${kinds.join(", or ")} in the source data; their prices are left blank`;
1099
+ const said = `${count} ${flagged.length === 1 ? "has" : "have"} ${kinds.join(", or ")} in the source data`;
1100
+ // A monthly bar keeps its close; its open, high and low come from the month's daily bars where they cover it.
1101
+ const kept = flagged.filter((row) => row.close != null);
1102
+ if (kept.length === 0) return `${said}; their prices are left blank`;
1103
+ const rebuilt = kept.filter((row) => row.rebuilt).length;
1104
+ const blank = flagged.length - kept.length;
1105
+ const keep = blank > 0 ? `${kept.length} keep their close` : flagged.length === 1 ? "it keeps its close" : "they keep their close";
1106
+ const ohl = rebuilt === kept.length ? ", with open, high and low from the month's daily bars"
1107
+ : rebuilt > 0 ? `; open, high and low come from the month's daily bars for ${rebuilt} and are blank for ${kept.length - rebuilt}, whose daily bars do not cover the month without contradiction`
1108
+ : `; open, high and low are blank, the month's daily bars not covering ${kept.length === 1 ? "it" : "them"} without contradiction`;
1109
+ return `${said}; ${keep}${ohl}${blank > 0 ? `; ${blank} ${blank === 1 ? "is" : "are"} left blank` : ""}`;
1022
1110
  }
1023
1111
 
1024
1112
  /**
package/src/cli/index.ts CHANGED
@@ -48,8 +48,7 @@ import {
48
48
  runPaneFunctionHelp,
49
49
  runPaneScreenshot,
50
50
  } from "./pane-functions";
51
- import { catalogPointer, tickerPointer, type CatalogCommandHit } from "./unknown-command";
52
- import { exportCommandPointer } from "./known-gaps";
51
+ import { type UnknownCommandPointers, unknownCommandReply } from "./unknown-command";
53
52
  import { catalogFredSeriesIds } from "./series-search";
54
53
  import { primeBoardCoins } from "./board-coins";
55
54
 
@@ -353,17 +352,6 @@ function nearCommand(token: string, commands: CliCommandDef[]): string | null {
353
352
  );
354
353
  }
355
354
 
356
- interface UnknownCommandPointers {
357
- /** The word is a function's code: the command that runs it. */
358
- fn: { code: string; command: string } | null;
359
- /** The word is a slip from one function's code (RCDF for RDCF), read only when it is no code, no command is close to it and the catalog finds nothing for it. */
360
- nearFn: { code: string; label: string; command: string } | null;
361
- /** Functions the catalog finds for the word, read only when it is no code and no command is close to it. */
362
- hits: CatalogCommandHit[];
363
- /** What the reader typed after the word, which a pointer runs the function with. */
364
- args: readonly string[];
365
- }
366
-
367
355
  /** What an unknown command word may point at: a function's code first, then what the catalog finds for it. */
368
356
  async function unknownCommandPointers(
369
357
  ctx: CliCommandContext,
@@ -379,29 +367,12 @@ async function unknownCommandPointers(
379
367
  return { fn, nearFn, hits, args };
380
368
  }
381
369
 
382
- /**
383
- * A function's code is pointed at `fn`; a typo of a command at the command;
384
- * a typo of a function's code (`RCDF`) at that function; a word the catalog
385
- * knows (`comps`, `peers`) at the functions it finds. A word written as a
386
- * ticker (`PLTR`) is also pointed at `quote` and `search`.
387
- */
370
+ /** An unknown command word, answered as unknownCommandReply says. */
388
371
  function failUnknownCommand(token: string, commands: CliCommandDef[], pointers: UnknownCommandPointers): never {
389
- if (pointers.fn) fail(`${pointers.fn.code} is a function: ${pointers.fn.command}`);
390
- const ticker = tickerPointer(token);
391
- const suggestion = nearCommand(token, commands);
392
- if (!suggestion && pointers.nearFn) {
393
- fail(
394
- `Unknown command "${token}". Did you mean the function ${pointers.nearFn.code} (${pointers.nearFn.label})?`,
395
- [`Run: ${pointers.nearFn.command}`, ticker].filter(Boolean).join("\n"),
396
- );
397
- }
398
- // Exporting is a flag, not a command: `export LMT` says how, rather than listing functions that mention exports.
399
- const exported = suggestion ? null : exportCommandPointer(token, pointers.args);
400
- const catalog = suggestion ? null : exported ?? catalogPointer(token, pointers.hits, pointers.args);
401
- const help = suggestion
402
- ? `Did you mean ${suggestion}? Run gloom help to see every command.`
403
- : catalog ? `${catalog}\nRun gloom help to see every command.` : "Run gloom help to see every command.";
404
- fail(`Unknown command "${token}".`, ticker ? `${ticker}\n${help}` : help);
372
+ const reply = unknownCommandReply(token,
373
+ commands.map((command) => ({ name: command.name, usage: command.help?.usage ?? [] })),
374
+ pointers, nearCommand(token, commands));
375
+ fail(reply.message, reply.details);
405
376
  }
406
377
 
407
378
  const CLI_DESCRIPTION = "Market research and portfolio tracker for the terminal";
@@ -73,9 +73,9 @@ export function isSubMinuteInterval(value: string): boolean {
73
73
  * (checked 2026-10-19).
74
74
  */
75
75
  export const MUNI_LINE = "Municipal bonds: no AAA muni curve (MMD and BVAL are licensed). Muni bond funds: MUB, VTEB, TFI (national), SUB (short-term), "
76
- + "CMF, VTEC (California), NYF, MUNY (New York). SEC yield, distribution yield, yield to worst and duration: gloom fn DVD <fund> or "
77
- + "gloom fundamentals <fund>; tax-equivalent yield and muni/Treasury ratio: add --tax-rate 40.8 (with --state-rate 13.3 --state CA for a "
78
- + "single-state fund).";
76
+ + "CMF, VTEC (California), NYF, MUNY (New York). SEC yield, distribution yield, yield to worst and duration: gloom fn DVD <fund>, fn ETF <fund>, "
77
+ + "fn DES <fund> or gloom fundamentals <fund>; tax-equivalent yield and muni/Treasury ratio: add --tax-rate 40.8, as in gloom fn DVD MUB --tax-rate 40.8 "
78
+ + "(with --state-rate 13.3 --state CA for a single-state fund), and gloom fn DVD MUB VTEB SUB LQD --tax-rate 40.8 ranks several.";
79
79
 
80
80
  /**
81
81
  * Data people look for under a name search cannot find: where the app has it,
@@ -358,9 +358,36 @@ const COMMAND_POINTERS: ReadonlyArray<{
358
358
  },
359
359
  ];
360
360
 
361
- /** The command for a query that names a setting ("light theme"), a portfolio report ("drip") or a currency ("yen"), else null. */
361
+ /** The command for a query that names a setting ("light theme"), a portfolio report ("drip"), a currency ("yen") or a perpetual ("btc perp"), else null. */
362
362
  export function commandPointer(query: string): string | null {
363
- return findCommandPointer(query)?.line ?? currencyPointer(query);
363
+ return findCommandPointer(query)?.line ?? currencyPointer(query) ?? perpPointer(query);
364
+ }
365
+
366
+ const PERP_WORDS = new Set(["perp", "perps", "perpetual", "perpetuals"]);
367
+ /** Words a perpetual query says about the contract, not which coin: "btc perpetual funding rate on binance". */
368
+ const PERP_FILLER = new Set(["futures", "future", "contract", "contracts", "swap", "swaps", "funding", "rate", "rates", "open", "interest", "oi",
369
+ "premium", "basis", "price", "prices", "on", "venue", "venues", "binance", "bybit", "okx", "hyperliquid", "usdt", "usdc", "usd", "crypto"]);
370
+
371
+ /** A perpetual that is no futures contract: a perpetual bond or preferred share has a coupon, not funding. */
372
+ const PERPETUAL_SECURITIES = new Set(["bond", "bonds", "preferred", "preferreds", "pref", "prefs", "preference", "note", "notes", "coco", "cocos", "at1",
373
+ "debt", "capital", "annuity", "annuities", "subordinated", "hybrid", "hybrids"]);
374
+
375
+ /**
376
+ * `fn PERP` for a query that asks for a perpetual contract: with the market it names, "btc perpetual" reads
377
+ * `fn PERP BTC`; with none ("perpetual funding rates"), the board. A query that names several things besides, or a
378
+ * perpetual bond or preferred, is left to search.
379
+ */
380
+ function perpPointer(query: string): string | null {
381
+ const asked = words(query);
382
+ if (!asked.some((word) => PERP_WORDS.has(word)) || asked.some((word) => PERPETUAL_SECURITIES.has(word))) return null;
383
+ const named = asked.filter((word) => !PERP_WORDS.has(word) && !PERP_FILLER.has(word));
384
+ if (named.length > 1) return null;
385
+ // A symbol reads in capitals; a name (bitcoin) as typed, which PERP reads as the market it stands for.
386
+ const word = named[0];
387
+ const market = word && word.length <= 5 ? word.toUpperCase() : word;
388
+ const title = market && `${market[0]!.toUpperCase()}${market.slice(1)}`;
389
+ return market ? `${title} perpetuals by venue, with funding, open interest and premium: gloom fn PERP ${market}`
390
+ : "Perpetual markets by venue, with funding, open interest and premium: gloom fn PERP";
364
391
  }
365
392
 
366
393
  /**
@@ -415,9 +442,24 @@ function findCommandPointer(query: string): (typeof COMMAND_POINTERS)[number] |
415
442
  */
416
443
  export function bankFigurePointer(name: string, arg: string): { message: string; details: string } | null {
417
444
  if (findTopicPointer(name) !== BANK_FIGURES_TOPIC && findCommandPointer(name) !== BANK_FIGURES_POINTER) return null;
445
+ return bankFiguresAnswer(`${name} is not a function: a bank's figures are in the Bank section of fundamentals.`, arg);
446
+ }
447
+
448
+ /**
449
+ * The answer to `fn BANK JPM`: BANK opens CBR, the central banks' rates, which
450
+ * takes no ticker; with one it asks for that bank's figures, which the Bank
451
+ * section of `fundamentals` has. Null for any other name, and with no ticker.
452
+ */
453
+ export function bankWordPointer(name: string, arg: string | null | undefined): { message: string; details: string } | null {
454
+ const ticker = arg?.trim() ?? "";
455
+ if (!/^banks?$/i.test(name.trim()) || !/^[A-Za-z0-9.:^-]+$/.test(ticker)) return null;
456
+ return bankFiguresAnswer(`${name.trim().toUpperCase()} opens central bank rates; a bank's own figures are in the Bank section of fundamentals.`, ticker);
457
+ }
458
+
459
+ function bankFiguresAnswer(message: string, arg: string): { message: string; details: string } {
418
460
  const symbol = /^[A-Za-z0-9.:^-]+$/.test(arg.trim()) ? arg.trim().toUpperCase() : "";
419
461
  return {
420
- message: `${name} is not a function: a bank's figures are in the Bank section of fundamentals.`,
462
+ message,
421
463
  details: [
422
464
  `Deposits, uninsured share, CRE / capital and the lead bank: gloom fundamentals ${symbol || "<ticker>"}`,
423
465
  `Net interest margin (Pro): ${symbol ? nimCommand(symbol) : "gloom fn EQS --metric kpiNimPercent"}`,