gloomberb 0.20.13 → 0.20.16

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 (275) hide show
  1. package/package.json +2 -1
  2. package/patches/@opentui%2Fcore@0.3.2.patch +22 -4
  3. package/src/account/auth-dialog.tsx +22 -4
  4. package/src/account/auth-form.tsx +6 -1
  5. package/src/account/checkout-handoff.tsx +7 -14
  6. package/src/account/device-signin-dialog.tsx +35 -24
  7. package/src/api-client/crypto-markets.ts +10 -0
  8. package/src/api-client/errors.ts +3 -1
  9. package/src/api-client/index.ts +54 -0
  10. package/src/api-client/install-experiments.ts +8 -7
  11. package/src/api-client/money-markets.ts +7 -0
  12. package/src/api-client/paths.ts +2 -1
  13. package/src/api-client/product-waitlist.ts +63 -0
  14. package/src/api-client/request.ts +16 -4
  15. package/src/api-client/types/billing.ts +45 -0
  16. package/src/api-client/yearly-plan.ts +132 -0
  17. package/src/app/global-shortcuts.ts +5 -3
  18. package/src/app/pane-runtime/index.tsx +2 -2
  19. package/src/app/pane-runtime/plugin-bindings.ts +3 -1
  20. package/src/app/pane-runtime/ticker-open-runtime.ts +6 -1
  21. package/src/app/since-last-visit/keys.ts +26 -0
  22. package/src/app/since-last-visit/model.ts +266 -0
  23. package/src/app/since-last-visit/strip.tsx +193 -0
  24. package/src/app/since-last-visit/use-since-last-visit.ts +289 -0
  25. package/src/app/since-last-visit/visit-tracker.ts +191 -0
  26. package/src/app.tsx +15 -0
  27. package/src/architecture/floating-promise-allowlist.json +0 -1
  28. package/src/brokers/signed-in/sign-in-dialog.tsx +38 -38
  29. package/src/cli/commands/market.ts +103 -27
  30. package/src/cli/commands/overview.ts +18 -4
  31. package/src/cli/commands/system.ts +29 -1
  32. package/src/cli/commands/ticker.ts +12 -5
  33. package/src/cli/desktop-pane-shot-api-policy.ts +4 -1
  34. package/src/cli/desktop-pane-shot-browser.ts +2 -1
  35. package/src/cli/desktop-pane-shot-view.ts +3 -7
  36. package/src/cli/desktop-pane-shot.ts +26 -28
  37. package/src/cli/errors.ts +3 -1
  38. package/src/cli/freshness.ts +7 -2
  39. package/src/cli/glossary.ts +10 -5
  40. package/src/cli/help.ts +1 -0
  41. package/src/cli/helpers.ts +8 -16
  42. package/src/cli/history-export.ts +4 -0
  43. package/src/cli/history-rows.ts +24 -0
  44. package/src/cli/index.ts +4 -0
  45. package/src/cli/known-gaps.ts +2 -2
  46. package/src/cli/listing-arg.ts +79 -11
  47. package/src/cli/not-a-ticker.ts +4 -0
  48. package/src/cli/options.ts +29 -1
  49. package/src/cli/pane-functions/catalog.ts +70 -12
  50. package/src/cli/pane-functions/function-help.ts +1 -1
  51. package/src/cli/pane-functions/headless.ts +68 -3
  52. package/src/cli/pane-functions/index.ts +2 -2
  53. package/src/cli/pane-functions/options.ts +7 -0
  54. package/src/cli/pane-functions/resolver.ts +104 -15
  55. package/src/cli/pane-functions/screenshot-payload.ts +3 -0
  56. package/src/cli/report-tables.ts +20 -5
  57. package/src/cli/result.ts +22 -4
  58. package/src/cli/shot-temp-dir.ts +30 -0
  59. package/src/cli/suffixed-listing-rows.ts +11 -0
  60. package/src/cli/symbol-args.ts +5 -3
  61. package/src/cli/symbol-list.ts +23 -10
  62. package/src/cli/symbol-rows.ts +135 -3
  63. package/src/cli/treasury-yields.ts +15 -1
  64. package/src/components/chart/composite/composite-chart.tsx +3 -3
  65. package/src/components/chart/composite/format.ts +2 -1
  66. package/src/components/chart/composite/panel-surface/axis-markers.ts +133 -0
  67. package/src/components/chart/composite/panel-surface/level-labels.tsx +78 -0
  68. package/src/components/chart/composite/panel-surface/overlays.ts +108 -0
  69. package/src/components/chart/composite/panel-surface/pan-coast.ts +54 -0
  70. package/src/components/chart/composite/panel-surface/panel-cursor.tsx +138 -0
  71. package/src/components/chart/composite/panel-surface/panel-levels.ts +47 -0
  72. package/src/components/chart/composite/panel-surface/plot-gestures.ts +403 -0
  73. package/src/components/chart/composite/panel-surface/plot-pointer.ts +65 -0
  74. package/src/components/chart/composite/panel-surface/plot-wheel.ts +102 -0
  75. package/src/components/chart/composite/panel-surface/pointer.ts +12 -0
  76. package/src/components/chart/composite/panel-surface/props.ts +79 -0
  77. package/src/components/chart/composite/panel-surface/tool-readout.ts +151 -0
  78. package/src/components/chart/composite/panel-surface/value-axis-gestures.ts +152 -0
  79. package/src/components/chart/composite/panel-surface.tsx +81 -1177
  80. package/src/components/command-bar/commands/collection-list.ts +1 -0
  81. package/src/components/command-bar/commands/direct/index.ts +31 -8
  82. package/src/components/command-bar/commands/registry.ts +7 -0
  83. package/src/components/command-bar/routes/root/command-items.ts +8 -0
  84. package/src/components/command-bar/routes/root/results.ts +19 -2
  85. package/src/components/command-bar/routes/root/runtime.ts +3 -2
  86. package/src/components/command-bar/routes/root/selection.ts +3 -2
  87. package/src/components/command-bar/routes/root/shortcuts.ts +15 -0
  88. package/src/components/company-logo.tsx +10 -3
  89. package/src/components/data-table/sections.ts +6 -1
  90. package/src/components/layout/pane/title.ts +16 -6
  91. package/src/components/layout/shell/index.tsx +5 -1
  92. package/src/components/layout/shell/ticker-link-menu.ts +12 -9
  93. package/src/components/pane-settings-dialog/tui.tsx +6 -3
  94. package/src/components/pane-settings-dialog.tsx +2 -1
  95. package/src/components/pane-template-wizard.tsx +2 -0
  96. package/src/components/ticker/badge/format.ts +12 -3
  97. package/src/components/ticker/badge/index.tsx +9 -3
  98. package/src/components/ticker/list-table-view.tsx +119 -17
  99. package/src/components/ui/choice-dialog.tsx +1 -1
  100. package/src/components/ui/confirm-dialog.tsx +3 -2
  101. package/src/components/ui/data-table/display-columns.ts +16 -0
  102. package/src/components/ui/data-table/index.tsx +40 -9
  103. package/src/components/ui/data-table/types.ts +14 -0
  104. package/src/components/ui/frame.tsx +7 -3
  105. package/src/components/ui/icon.tsx +4 -2
  106. package/src/components/ui/list-view.tsx +8 -0
  107. package/src/components/ui/number-prompt-dialog.tsx +2 -1
  108. package/src/components/use-pane-notice-footer.tsx +3 -1
  109. package/src/core/state/app/layout-reducer.ts +3 -1
  110. package/src/core/state/app/layout.ts +2 -2
  111. package/src/data/config/layout.ts +14 -0
  112. package/src/data/config/store/normalize.ts +11 -1
  113. package/src/docs/snapshot.json +2 -2
  114. package/src/i18n/es.ts +39 -0
  115. package/src/i18n/ja.ts +39 -0
  116. package/src/i18n/ko.ts +39 -0
  117. package/src/i18n/zh-cn.ts +39 -0
  118. package/src/i18n/zh-tw.ts +39 -0
  119. package/src/layout/pane-follow.ts +141 -4
  120. package/src/layout/pane-layout-move.ts +10 -7
  121. package/src/layout/ticker-navigation.ts +13 -19
  122. package/src/layout/ticker-retarget.ts +3 -2
  123. package/src/market-data/market/format.ts +35 -1
  124. package/src/market-data/market/index-level.ts +19 -0
  125. package/src/market-data/quotes/contributions.ts +13 -0
  126. package/src/market-data/quotes/export-identity.ts +36 -1
  127. package/src/market-data/quotes/resolution.ts +16 -0
  128. package/src/plugins/builtin/account-management/keyboard.ts +14 -0
  129. package/src/plugins/builtin/account-management/model.ts +2 -0
  130. package/src/plugins/builtin/account-management/pane.tsx +79 -7
  131. package/src/plugins/builtin/account-management/password-dialog.tsx +2 -2
  132. package/src/plugins/builtin/account-management/payment-recovery-row.tsx +97 -0
  133. package/src/plugins/builtin/account-management/yearly-plan-row.tsx +359 -0
  134. package/src/plugins/builtin/analytics/risk-client.ts +12 -2
  135. package/src/plugins/builtin/analytics/risk-headless.ts +66 -6
  136. package/src/plugins/builtin/analytics/risk-math.ts +23 -6
  137. package/src/plugins/builtin/analytics/risk-model.ts +20 -9
  138. package/src/plugins/builtin/analytics/risk-pane.tsx +2 -2
  139. package/src/plugins/builtin/awards/pane.tsx +6 -8
  140. package/src/plugins/builtin/changelog/index.tsx +6 -44
  141. package/src/plugins/builtin/changelog/versions.ts +17 -68
  142. package/src/plugins/builtin/chart-composer/catalog-inventory.ts +5 -2
  143. package/src/plugins/builtin/chart-composer/editor.tsx +1 -0
  144. package/src/plugins/builtin/chart-composer/pane.tsx +1 -1
  145. package/src/plugins/builtin/chart-composer/quick-add.tsx +4 -1
  146. package/src/plugins/builtin/chart-composer/series-catalog.ts +17 -1
  147. package/src/plugins/builtin/cloud/askg/executor.ts +2 -1
  148. package/src/plugins/builtin/cloud/askg/sources.ts +2 -1
  149. package/src/plugins/builtin/cloud/plugin.tsx +2 -0
  150. package/src/plugins/builtin/cloud/thesis/module.tsx +2 -0
  151. package/src/plugins/builtin/cloud/upgrade-status-widget.tsx +6 -2
  152. package/src/plugins/builtin/cpi/headless.ts +6 -1
  153. package/src/plugins/builtin/cpi/model.ts +17 -0
  154. package/src/plugins/builtin/cpi/pane.tsx +4 -2
  155. package/src/plugins/builtin/crypto-board/client.ts +6 -1
  156. package/src/plugins/builtin/crypto-board/headless.ts +10 -2
  157. package/src/plugins/builtin/crypto-board/model.ts +89 -11
  158. package/src/plugins/builtin/crypto-board/pane.tsx +20 -5
  159. package/src/plugins/builtin/debt-maturities/model.ts +1 -1
  160. package/src/plugins/builtin/dividend-yield/client.ts +24 -2
  161. package/src/plugins/builtin/dividend-yield/headless.ts +4 -2
  162. package/src/plugins/builtin/dividend-yield/ranking.ts +2 -1
  163. package/src/plugins/builtin/dividend-yield/view.ts +5 -1
  164. package/src/plugins/builtin/earnings/board-table.ts +1 -1
  165. package/src/plugins/builtin/earnings/board.tsx +36 -16
  166. package/src/plugins/builtin/earnings/highlight.ts +47 -0
  167. package/src/plugins/builtin/earnings/history-table.ts +9 -1
  168. package/src/plugins/builtin/earnings/index.tsx +1 -1
  169. package/src/plugins/builtin/earnings-calls/pane.tsx +2 -2
  170. package/src/plugins/builtin/earnings-ripple/index.tsx +2 -0
  171. package/src/plugins/builtin/econ/calendar-model.ts +17 -1
  172. package/src/plugins/builtin/econ/fred-catalog.ts +33 -4
  173. package/src/plugins/builtin/econ-statistics/headless.ts +21 -0
  174. package/src/plugins/builtin/estimate-revisions/model.ts +1 -1
  175. package/src/plugins/builtin/exposure/index.tsx +1 -1
  176. package/src/plugins/builtin/macro-day/headless.ts +21 -10
  177. package/src/plugins/builtin/macro-day/model.ts +42 -3
  178. package/src/plugins/builtin/macro-day/pane.tsx +26 -8
  179. package/src/plugins/builtin/macro-day/releases.ts +24 -1
  180. package/src/plugins/builtin/market-valuation/detail.tsx +3 -3
  181. package/src/plugins/builtin/market-valuation/headless.ts +11 -4
  182. package/src/plugins/builtin/market-valuation/pane.tsx +3 -1
  183. package/src/plugins/builtin/market-valuation/view.ts +14 -0
  184. package/src/plugins/builtin/money-markets/client.ts +4 -1
  185. package/src/plugins/builtin/money-markets/headless.ts +15 -4
  186. package/src/plugins/builtin/money-markets/index.tsx +1 -1
  187. package/src/plugins/builtin/money-markets/pane.tsx +7 -1
  188. package/src/plugins/builtin/news/wire/news/detail-view.tsx +20 -8
  189. package/src/plugins/builtin/pe-band/pane.tsx +1 -1
  190. package/src/plugins/builtin/portfolio-list/cli/bulk-symbols.ts +4 -2
  191. package/src/plugins/builtin/portfolio-list/cli/period-report.ts +61 -11
  192. package/src/plugins/builtin/portfolio-list/cli/portfolio-command.ts +11 -3
  193. package/src/plugins/builtin/portfolio-list/cli/render.ts +8 -1
  194. package/src/plugins/builtin/portfolio-list/cli/watchlist-command.ts +178 -17
  195. package/src/plugins/builtin/portfolio-list/headless.ts +33 -6
  196. package/src/plugins/builtin/portfolio-list/pane/groups.tsx +220 -0
  197. package/src/plugins/builtin/portfolio-list/pane/index.tsx +95 -18
  198. package/src/plugins/builtin/portfolio-list/pane/period-pnl.ts +24 -6
  199. package/src/plugins/builtin/portfolio-list/period-pnl.ts +16 -1
  200. package/src/plugins/builtin/portfolio-list/summary/index.tsx +4 -1
  201. package/src/plugins/builtin/portfolio-list/summary/totals.ts +6 -4
  202. package/src/plugins/builtin/portfolio-list/table.tsx +38 -16
  203. package/src/plugins/builtin/research/corporate-actions-pane.tsx +4 -2
  204. package/src/plugins/builtin/research/relative-valuation-headless.ts +15 -5
  205. package/src/plugins/builtin/research/relative-valuation-model.ts +7 -1
  206. package/src/plugins/builtin/research/relative-valuation-pane.tsx +7 -4
  207. package/src/plugins/builtin/shared/cloud-upgrade.ts +4 -2
  208. package/src/plugins/builtin/shared/cpi-year-gap.ts +67 -0
  209. package/src/plugins/builtin/shared/headless-options.ts +1 -1
  210. package/src/plugins/builtin/social-mentions/model.ts +2 -2
  211. package/src/plugins/builtin/thirteenf/pane.tsx +1 -1
  212. package/src/plugins/builtin/ticker-detail/adr-pair/headless.ts +45 -2
  213. package/src/plugins/builtin/ticker-detail/financials/model.ts +51 -16
  214. package/src/plugins/builtin/ticker-detail/financials/nopat.ts +16 -0
  215. package/src/plugins/builtin/ticker-detail/financials/ratios.ts +44 -13
  216. package/src/plugins/builtin/ticker-detail/financials/schema.ts +33 -2
  217. package/src/plugins/builtin/ticker-detail/financials/tab.tsx +4 -2
  218. package/src/plugins/builtin/ticker-detail/headless-schema.ts +30 -4
  219. package/src/plugins/builtin/ticker-detail/headless.ts +280 -35
  220. package/src/plugins/builtin/ticker-detail/overview/components.tsx +4 -5
  221. package/src/plugins/builtin/ticker-detail/overview/model.ts +9 -2
  222. package/src/plugins/builtin/ticker-detail/overview-tab.tsx +10 -2
  223. package/src/plugins/builtin/ticker-detail/pharma-signals/eligibility.ts +32 -0
  224. package/src/plugins/builtin/ticker-detail/pharma-signals/tab.tsx +162 -0
  225. package/src/plugins/builtin/ticker-detail/pharma-signals/waitlist.ts +126 -0
  226. package/src/plugins/builtin/ticker-detail/research-groups.ts +6 -4
  227. package/src/plugins/builtin/ticker-detail/research-tabs.ts +11 -0
  228. package/src/portfolio/collection-name.ts +2 -1
  229. package/src/portfolio/column-values.ts +34 -12
  230. package/src/portfolio/listed-symbol.ts +4 -2
  231. package/src/portfolio/period-pnl.ts +51 -1
  232. package/src/portfolio/suffixed-listings.ts +3 -1
  233. package/src/portfolio/watchlist-groups.ts +212 -0
  234. package/src/react/ticker-source.ts +3 -1
  235. package/src/renderers/dom/dialog-host.tsx +5 -5
  236. package/src/renderers/dom/styles.css +7 -0
  237. package/src/renderers/electrobun/view/remote/capability-invoker.ts +1 -1
  238. package/src/renderers/opentui/dialog-host.tsx +3 -4
  239. package/src/sources/gloomberb-cloud/normalizers.ts +5 -0
  240. package/src/sources/provider-router/history.ts +5 -2
  241. package/src/state/app/bootstrap.ts +11 -0
  242. package/src/state/app/context/index.tsx +6 -0
  243. package/src/sync/collections-contributor.ts +5 -2
  244. package/src/sync/config-merge.ts +10 -2
  245. package/src/sync/sanitize.ts +28 -0
  246. package/src/telemetry/usage-counts.ts +17 -0
  247. package/src/test-support/plugin-persistence.ts +12 -0
  248. package/src/tickers/company-name-listing.ts +4 -3
  249. package/src/tickers/company-name.ts +19 -1
  250. package/src/tickers/instrument-coverage.ts +27 -0
  251. package/src/tickers/search/home-listing.ts +38 -1
  252. package/src/tickers/search/index.ts +3 -2
  253. package/src/tickers/search/ranking.ts +21 -2
  254. package/src/time-series/base-series.ts +4 -0
  255. package/src/time-series/chart-seed.ts +1 -1
  256. package/src/time-series/financial-period-coverage.ts +4 -12
  257. package/src/time-series/parsed-history-cache.ts +1 -1
  258. package/src/time-series/resolve.ts +1 -1
  259. package/src/time-series/types.ts +5 -2
  260. package/src/time-series/use-chart-resolution.ts +6 -1
  261. package/src/types/config.ts +32 -0
  262. package/src/types/financials.ts +13 -0
  263. package/src/types/headless.ts +7 -0
  264. package/src/types/plugin-context.ts +5 -0
  265. package/src/types/ticker.ts +14 -0
  266. package/src/ui/ascii-font.ts +1 -4
  267. package/src/ui/dialog-stack.ts +17 -0
  268. package/src/ui/dialog.tsx +6 -2
  269. package/src/utils/async-deadline.ts +2 -2
  270. package/src/utils/crypto-pair.ts +9 -0
  271. package/src/utils/csv.ts +44 -5
  272. package/src/utils/exchanges.ts +13 -0
  273. package/src/utils/financial-statements.ts +60 -3
  274. package/src/utils/futures-generic.ts +17 -0
  275. package/src/utils/trailing-dividend.ts +13 -3
@@ -21,7 +21,10 @@ import { isVenueAbroad } from "../tickers/listing-fate";
21
21
  import { serviceMarkedOtherListing } from "../tickers/company-name-listing";
22
22
  import { companyNameCase, sameCompany, shortCompanyName } from "../tickers/company-name";
23
23
  import { tickerHasListingSuffix } from "../sources/listing-symbols";
24
- import { canonicalExchange, exchangeLabel, isUsListingExchange, resolveExchangeTimeZone } from "../utils/exchanges";
24
+ import { canonicalExchange, exchangeLabel, isUsListingExchange, parsePublicTickerKey, resolveExchangeTimeZone, storedKeyListing } from "../utils/exchanges";
25
+ import { resolveTickerInstrumentKind } from "../tickers/instrument-kind";
26
+ import { futuresGenericListing, parseFuturesGeneric } from "../utils/futures-generic";
27
+ import { isProviderBusy, isRateLimited, isSourceFailure, isTransientServiceFailure } from "../sources/provider-errors";
25
28
  import { isCurrencyPairListing } from "../utils/fx-market-hours";
26
29
  import { isCurrencyCode } from "../utils/currency-pair";
27
30
  import { logFailure } from "../utils/log-failure";
@@ -412,6 +415,109 @@ export interface BulkSymbolsOptions {
412
415
  symbols: readonly string[];
413
416
  exchange: string | undefined;
414
417
  store: TickerSource;
418
+ /** Whether a saved row is in the list added to: its venues are where a bare symbol that read as a future is looked for first. */
419
+ member?: (ticker: TickerRecord) => boolean;
420
+ /** How long the list's venues have to answer for such a symbol; `LOOKUP_TIMEOUT_MS` (5 s) unless set. */
421
+ venueWaitMs?: number;
422
+ }
423
+
424
+ /** A row that is a futures contract: a generic (ES3 on CME, the E-mini's third) or a dated or continuous one. */
425
+ function isFutureRow(ticker: TickerRecord): boolean {
426
+ return resolveTickerInstrumentKind(ticker) === "future" || !!futuresGenericListing(ticker.metadata.ticker, ticker.metadata.exchange);
427
+ }
428
+
429
+ /**
430
+ * The venues a list's listings trade on (its `members`, and the securities
431
+ * `added` beside), other than the US's: SGX and HKEX for a book of DBS and
432
+ * Tencent. Empty when the list holds a future, which makes a bare symbol's
433
+ * future a fair reading.
434
+ */
435
+ function listVenues(members: readonly TickerRecord[], added: readonly TickerRecord[] = []): string[] {
436
+ if (members.some(isFutureRow)) return [];
437
+ const venues = [...members, ...added.filter((ticker) => !isFutureRow(ticker))].flatMap((ticker) => {
438
+ const { exchange } = storedKeyListing(ticker.metadata.ticker, ticker.metadata.exchange);
439
+ const venue = canonicalExchange(exchange);
440
+ return venue && !isUsListingExchange(venue) && !UNVENUED.has(venue) && !isCurrencyPairListing(ticker.metadata.ticker, venue) ? [venue] : [];
441
+ });
442
+ return [...new Set(venues)];
443
+ }
444
+
445
+ /**
446
+ * A bare symbol a security could be listed as (ES3, D05), not a future's own
447
+ * spelling: never a continuous symbol (ES=F), a dated contract (ESZ6, CLZ26),
448
+ * a front generic (NQ1, ES1, how a future is typed) or a generic with a roll
449
+ * or an adjustment (CL2F5, ES3R).
450
+ */
451
+ function securityShaped(symbol: string): boolean {
452
+ if (!/^[A-Z0-9]{1,6}$/.test(symbol)) return false;
453
+ if (/^[A-Z0-9]{1,4}[FGHJKMNQUVXZ]\d{1,2}$/.test(symbol) && !/^\d+$/.test(symbol)) return false;
454
+ const generic = parseFuturesGeneric(symbol);
455
+ return !generic || (generic.position > 1 && generic.ticker === `${generic.prefix}${generic.position}`);
456
+ }
457
+
458
+ /** A lookup that did not answer (busy, timed out, at its request limit), which says nothing of whether the venue lists it. */
459
+ function unansweredLookup(error: unknown): boolean {
460
+ return isProviderBusy(error) || isTransientServiceFailure(error) || isSourceFailure(error) || isRateLimited(error);
461
+ }
462
+
463
+ /**
464
+ * A bare symbol that read as a future while the list's listings trade on a
465
+ * venue that lists the symbol as a security is that listing: ES3 in a book
466
+ * of DBS and OCBC on SGX is the Straits Times fund there, not the E-mini's
467
+ * third generic on CME. The list's venues are asked at once, under one
468
+ * deadline; one that is busy or does not answer in time makes the add ask
469
+ * which is meant (`ListingChoiceError`) rather than guess another asset class.
470
+ * Each venue's lookup is staged on its own and only the one kept is staged
471
+ * for the commit, so a lookup that finishes late saves nothing.
472
+ */
473
+ async function keepListVenue(
474
+ lookup: CliTickerResolution,
475
+ venues: readonly string[],
476
+ { exchange, staged, dataProvider, retry, waitMs = LOOKUP_TIMEOUT_MS }: {
477
+ exchange: string | undefined; staged: StagedTickerRepository; dataProvider: DataProvider; retry?: CliTickerOptions["retry"]; waitMs?: number;
478
+ },
479
+ ): Promise<CliTickerResolution> {
480
+ if (lookup.error || exchange || venues.length === 0) return lookup;
481
+ const typed = parsePublicTickerKey(symbolInputKey(lookup.input));
482
+ if (typed.exchange || !securityShaped(typed.symbol.toUpperCase()) || !isFutureRow(lookup.ticker)) return lookup;
483
+ const future = savedListingName(lookup.ticker);
484
+ // Dropped first, so the venue's listing is saved under its own symbol (ES3:SGX as ES3, not ES3:XSES); an add of
485
+ // the future after all saves it again.
486
+ staged.discard(lookup.ticker.metadata.ticker);
487
+ let timer: ReturnType<typeof setTimeout> | undefined;
488
+ const deadline = new Promise<"late">((resolve) => { timer = setTimeout(() => resolve("late"), waitMs); });
489
+ type Answer = { venue: string; key: string; layer: StagedTickerRepository; found: CliTicker | null; unanswered: boolean };
490
+ const answers = await Promise.all(venues.map(async (venue): Promise<Answer> => {
491
+ const key = `${typed.symbol}:${venue}`;
492
+ const layer = new StagedTickerRepository(staged);
493
+ const asked = resolveCliTicker(key, layer, dataProvider, undefined, { retry, changes: false }).then(
494
+ (found) => ({ venue, key, layer, found, unanswered: false }),
495
+ // Not listed there: the future stands. Busy or failed: the venue did not answer.
496
+ (error: unknown) => ({ venue, key, layer, found: null, unanswered: unansweredLookup(error) }),
497
+ );
498
+ const answer = await Promise.race([asked, deadline]);
499
+ return answer === "late" ? { venue, key, layer, found: null, unanswered: true } : answer;
500
+ })).finally(() => clearTimeout(timer));
501
+ const listed = answers.find((answer) => answer.found && !isFutureRow(answer.found.ticker));
502
+ if (listed?.found) {
503
+ // Only the listing kept is staged; the other venues' lookups, late ones included, are dropped.
504
+ await listed.layer.commit();
505
+ const note = `${typed.symbol} -> ${listed.venue}, the list's venue (not the ${future.exchange || "futures"} future)`;
506
+ return { input: lookup.input, ...listed.found, notes: [note, ...listed.found.notes] };
507
+ }
508
+ const unanswered = answers.filter((answer) => answer.unanswered).map((answer) => answer.key);
509
+ if (unanswered.length === 0) return lookup;
510
+ const choices = [...unanswered.map((key) => ({ key, name: null })), { key: future.key, name: future.name }];
511
+ return {
512
+ input: lookup.input,
513
+ error: new ListingChoiceError(
514
+ `${typed.symbol} may be ${unanswered.join(" or ")}, on the list's venue, which did not answer, or the ${future.exchange || "futures"} future ${future.key}; name the listing`,
515
+ choices.map((choice) => ` ${choice.key}${choice.name ? ` ${choice.name}` : ""}`).join("\n"),
516
+ choices,
517
+ choices.length,
518
+ null,
519
+ ),
520
+ };
415
521
  }
416
522
 
417
523
  type AddTicker = (ticker: TickerRecord) => { changed: boolean; ticker: TickerRecord };
@@ -493,6 +599,8 @@ export async function addSymbols({
493
599
  failure,
494
600
  suggest,
495
601
  dryRun = false,
602
+ member,
603
+ venueWaitMs,
496
604
  }: BulkSymbolsOptions & {
497
605
  dataProvider: DataProvider;
498
606
  /** Told when requests failed and the symbols that failed are about to be looked up again. */
@@ -516,7 +624,11 @@ export async function addSymbols({
516
624
  }): Promise<SymbolRow[]> {
517
625
  const staged = new StagedTickerRepository(store);
518
626
  const rejected = new Map(symbols.map((input) => [input, reject?.(input) ?? null] as const));
519
- const resolutions = await resolveTickersForCli(symbols.filter((input) => !rejected.get(input)), staged, dataProvider, exchange, { onRetry, onProgress, retry, askWhenAmbiguous });
627
+ const members = member ? (await store.loadAllTickers()).filter(member) : [];
628
+ const looked = await resolveTickersForCli(symbols.filter((input) => !rejected.get(input)), staged, dataProvider, exchange, { onRetry, onProgress, retry, askWhenAmbiguous });
629
+ // The list's venues, with those of the symbols added beside: a US, HKEX and SGX add keeps a bare ES3 on SGX.
630
+ const venues = listVenues(members, looked.flatMap((resolution) => resolution.error ? [] : [resolution.ticker]));
631
+ const resolutions = await Promise.all(looked.map((resolution) => keepListVenue(resolution, venues, { exchange, staged, dataProvider, retry, waitMs: venueWaitMs })));
520
632
  const resolved = new Map(resolutions.map((resolution) => [resolution.input, resolution] as const));
521
633
  const rows: SymbolRow[] = [];
522
634
  // Listings a symbol of this list was added to, which a later symbol's choice must not drop.
@@ -535,6 +647,24 @@ export async function addSymbols({
535
647
  return suggest ? withSuggestions(rows, staged, dataProvider) : rows;
536
648
  }
537
649
 
650
+ /**
651
+ * `resolveCliTicker` for a symbol a list takes outside an add (`portfolio
652
+ * position set`): a bare symbol that read as a future keeps the list's venue,
653
+ * or asks, as an add does (`keepListVenue`). Saves the listing it settles on.
654
+ */
655
+ export async function resolveListTicker(
656
+ symbol: string,
657
+ { store, dataProvider, exchange, member }: { store: TickerSource; dataProvider: DataProvider; exchange: string | undefined; member: BulkSymbolsOptions["member"] },
658
+ ): Promise<CliTicker> {
659
+ const staged = new StagedTickerRepository(store);
660
+ const looked: CliTickerResolution = { input: symbol, ...await resolveCliTicker(symbol, staged, dataProvider, exchange) };
661
+ const members = member ? (await store.loadAllTickers()).filter(member) : [];
662
+ const kept = await keepListVenue(looked, listVenues(members), { exchange, staged, dataProvider });
663
+ if (kept.error) throw kept.error;
664
+ await staged.commit();
665
+ return kept;
666
+ }
667
+
538
668
  /**
539
669
  * One symbol added as a symbol of a list is (`settleAdd`), for `watchlist add`
540
670
  * and `portfolio add` given one: a match a list would leave for a choice is
@@ -545,7 +675,7 @@ export async function addSymbols({
545
675
  */
546
676
  export async function addSymbol(
547
677
  input: string,
548
- { exchange, store, dataProvider, reject, retry, dryRun = false, add }: {
678
+ { exchange, store, dataProvider, reject, retry, dryRun = false, add, member }: {
549
679
  exchange: string | undefined;
550
680
  store: TickerSource;
551
681
  dataProvider: DataProvider;
@@ -553,6 +683,7 @@ export async function addSymbol(
553
683
  retry?: CliTickerOptions["retry"];
554
684
  dryRun?: boolean;
555
685
  add: AddTicker;
686
+ member?: BulkSymbolsOptions["member"];
556
687
  },
557
688
  ): Promise<AddOutcome & { lookup: CliTicker | null }> {
558
689
  const refusal = reject?.(input);
@@ -565,6 +696,7 @@ export async function addSymbol(
565
696
  } catch (caught) {
566
697
  lookup = { input, error: caught instanceof Error ? caught : new Error(String(caught)) };
567
698
  }
699
+ if (member) lookup = await keepListVenue(lookup, listVenues((await store.loadAllTickers()).filter(member)), { exchange, staged, dataProvider, retry });
568
700
  const outcome = await settleAdd(input, lookup, staged, dataProvider, add, new Set());
569
701
  if (!dryRun) await staged.commit();
570
702
  return { ...outcome, lookup: lookup.error ? null : lookup };
@@ -37,7 +37,7 @@ const YEAR_UNITS = new Set(["y", "yr", "yrs", "year", "years", "yt"]);
37
37
  const MONTH_UNITS = new Set(["m", "mo", "mos", "month", "months"]);
38
38
  /** Words that make a tenor a US Treasury yield: "US", "treasury", "yield". */
39
39
  const NAMING_WORDS = new Set(["us", "u", "s", "usa", "ust", "usgg", "treasury", "treasuries", "tsy", "yield", "yields", "rate", "rates",
40
- "note", "notes", "bill", "bills", "t"]);
40
+ "note", "notes", "bill", "bills", "tbill", "tbills", "t"]);
41
41
  /** Words that may sit beside it and say nothing more. */
42
42
  const FILLER_WORDS = new Set(["the", "on", "of", "par", "cmt", "constant", "maturity", "govt", "government"]);
43
43
 
@@ -86,6 +86,20 @@ export function treasuryYieldLine(tenor: TreasuryYieldTenor): string {
86
86
  return `US ${tenor.label} Treasury yield: ${yieldCommands(tenor).map(([command, gives]) => `${command} (${gives})`).join(", ")}.`;
87
87
  }
88
88
 
89
+ /** FRED's daily bill rate of a tenor Treasury sells bills at (the 4-week has no constant-maturity twin here). */
90
+ const BILL_RATES: ReadonlyMap<string, string> = new Map([["3-month", "DTB3"], ["6-month", "DTB6"], ["1-year", "DTB1YR"]]);
91
+
92
+ /**
93
+ * `US 3-month Treasury bill: gloom fn BTMM --tab bills ...` for a query that says a bill ("3 month t-bill"): the bill
94
+ * rates first, then the constant-maturity yield the curve reads, which is a different number. Null when it says no bill.
95
+ */
96
+ export function treasuryBillLine(text: string, tenor: TreasuryYieldTenor): string | null {
97
+ const bill = BILL_RATES.get(tenor.label);
98
+ if (!bill || !/(^|[^a-z])(t-?bills?|bills?)([^a-z]|$)/i.test(text)) return null;
99
+ return `US ${tenor.label} Treasury bill: gloom fn BTMM --tab bills (bill rates), gloom fred ${bill} (daily). `
100
+ + `Constant-maturity yield, the curve's basis: gloom fred ${tenor.fred}.`;
101
+ }
102
+
89
103
  /** "Try `gloom quote \"^TNX\"`, ... for the US 10-year Treasury yield.", after "Not a ticker: US10Y." */
90
104
  export function treasuryYieldHint(tenor: TreasuryYieldTenor): string {
91
105
  const commands = yieldCommands(tenor).map(([command]) => `\`${command}\``);
@@ -84,8 +84,8 @@ import type {
84
84
  CompositePanelScene,
85
85
  } from "./types";
86
86
 
87
- // Wordmark cell grid at scale 1 (27 columns of 8px, 4 rows of 12px).
88
- const WATERMARK_BASE_WIDTH_PX = 216;
87
+ // Wordmark cell grid at scale 1 (15 columns of 8px, 4 rows of 12px).
88
+ const WATERMARK_BASE_WIDTH_PX = 120;
89
89
  const WATERMARK_BASE_HEIGHT_PX = 48;
90
90
 
91
91
  /** The most lines a legend wraps to, and the plot rows each panel keeps when it does. */
@@ -1232,7 +1232,7 @@ function ThemedCompositeChart({
1232
1232
  style={plotInsetStyle}
1233
1233
  data-gloom-role={CHART_WATERMARK_ROLE}
1234
1234
  >
1235
- <AsciiText text="Gloomberb" font="wordmark" scale={watermarkScale} color={resolvedColors.textDim} />
1235
+ <AsciiText text="Gloom" font="wordmark" scale={watermarkScale} color={resolvedColors.textDim} />
1236
1236
  </Box>
1237
1237
  ) : null}
1238
1238
  {axisMarkers.length > 0 ? (
@@ -465,7 +465,8 @@ export function formatChartLegendValue(
465
465
  ...(referencePrice === undefined ? {} : stablePriceOptions("USD", assetCategory, referencePrice)) });
466
466
  }
467
467
  if (group.startsWith("derived-unit:")) return `${compact} ${trimmed}`;
468
- if (group.split(":")[0] === "currency-total") {
468
+ // A total in a currency reads at its scale ($223.4B), as a coin's volume, the value it traded, does too.
469
+ if (group.split(":")[0] === "currency-total" || (group === "volume" && unitCurrencyCode(trimmed))) {
469
470
  const scale = ([[1e12, "T"], [1e9, "B"], [1e6, "M"], [1e3, "K"]] as const)
470
471
  .find(([divisor]) => Math.abs(value) >= divisor);
471
472
  if (scale) {
@@ -0,0 +1,133 @@
1
+ import { useMemo } from "react";
2
+ import { compositeAxisTagFormatter } from "../format";
3
+ import { fitAxisLabels, type ProjectedLevel } from "../levels";
4
+ import { axisLabelRows } from "../panel-labels";
5
+ import { placeAxisTicks } from "../price-axis-labels";
6
+ import { compositeAxisTickLabels, renderCompositeAxisText } from "../text-renderer";
7
+ import type { CompositeAxisDomain } from "../types";
8
+ import type { CompositePanelSurfaceProps } from "./props";
9
+ import type { ToolAnchorMarker } from "./tool-readout";
10
+
11
+ /**
12
+ * Each value axis' grid labels, and the values tagged on it: the last price,
13
+ * the prior close, the levels and a measure's anchor, fitted around each
14
+ * other so no two labels share a row.
15
+ */
16
+ export function usePanelAxisMarkers({
17
+ panel,
18
+ colors,
19
+ formatAxisValue,
20
+ leftAxisWidth,
21
+ rightAxisWidth,
22
+ selectedLevelId,
23
+ levelDomain,
24
+ projectedLevels,
25
+ anchorMarker,
26
+ cellHeightPx,
27
+ fractionalViewport,
28
+ }: Pick<CompositePanelSurfaceProps, "panel" | "colors" | "formatAxisValue" | "leftAxisWidth" | "rightAxisWidth" | "selectedLevelId"> & {
29
+ levelDomain: CompositeAxisDomain | null;
30
+ projectedLevels: readonly ProjectedLevel[];
31
+ anchorMarker: ToolAnchorMarker | null;
32
+ cellHeightPx: number;
33
+ fractionalViewport: boolean;
34
+ }) {
35
+ const leftAxisLabels = useMemo(
36
+ () => axisLabelRows(
37
+ renderCompositeAxisText(panel.axes.left, panel.height, leftAxisWidth, "left", formatAxisValue),
38
+ ),
39
+ [formatAxisValue, leftAxisWidth, panel],
40
+ );
41
+ const rightAxisLabels = useMemo(
42
+ () => axisLabelRows(
43
+ renderCompositeAxisText(panel.axes.right, panel.height, rightAxisWidth, "right", formatAxisValue),
44
+ ),
45
+ [formatAxisValue, panel, rightAxisWidth],
46
+ );
47
+ const leftAxisTicks = useMemo(
48
+ () => compositeAxisTickLabels(panel.axes.left, leftAxisWidth, formatAxisValue),
49
+ [formatAxisValue, leftAxisWidth, panel],
50
+ );
51
+ const rightAxisTicks = useMemo(
52
+ () => compositeAxisTickLabels(panel.axes.right, rightAxisWidth, formatAxisValue),
53
+ [formatAxisValue, panel, rightAxisWidth],
54
+ );
55
+ const lastPriceMarker = useMemo(() => {
56
+ const marker = panel.lastPrice;
57
+ const domain = marker ? panel.axes[marker.axis] : undefined;
58
+ if (!marker || !domain) return null;
59
+ return {
60
+ side: marker.axis,
61
+ yRatio: marker.yRatio,
62
+ label: compositeAxisTagFormatter(formatAxisValue)(marker.value, domain),
63
+ color: marker.color,
64
+ };
65
+ }, [formatAxisValue, panel]);
66
+ const priorCloseMarker = useMemo(() => {
67
+ const marker = panel.priorClose;
68
+ const domain = marker ? panel.axes[marker.axis] : undefined;
69
+ if (!marker || !domain) return null;
70
+ return {
71
+ side: marker.axis,
72
+ yRatio: marker.yRatio,
73
+ label: compositeAxisTagFormatter(formatAxisValue)(marker.value, domain),
74
+ color: colors.textDim,
75
+ };
76
+ }, [colors.textDim, formatAxisValue, panel]);
77
+ const levelMarkers = useMemo(() => levelDomain ? [...projectedLevels]
78
+ // The picked level's label first, then alerts', when they compete for room.
79
+ .sort((left, right) => Number(right.level.id === selectedLevelId) - Number(left.level.id === selectedLevelId)
80
+ || Number(left.level.editable) - Number(right.level.editable))
81
+ .map(({ level, yRatio }) => ({
82
+ id: level.id,
83
+ side: levelDomain.side,
84
+ yRatio,
85
+ label: level.axisLabel ?? compositeAxisTagFormatter(formatAxisValue)(level.value, levelDomain),
86
+ color: level.color,
87
+ prioritizeAxisLabel: level.prioritizeAxisLabel,
88
+ })) : [], [formatAxisValue, levelDomain, projectedLevels, selectedLevelId]);
89
+ const buildAxisMarkers = (side: "left" | "right") => {
90
+ if (!panel.axes[side]) return undefined;
91
+ const toAxisMarker = (marker: { id?: string; yRatio: number; label: string; color: string }) => ({
92
+ id: marker.id,
93
+ row: Math.round(marker.yRatio * Math.max(panel.height - 1, 0)),
94
+ pixelY: marker.yRatio * Math.max(panel.height * cellHeightPx - 1, 0),
95
+ label: marker.label,
96
+ color: marker.color,
97
+ });
98
+ const onSide = <T extends { side: string | null }>(marker: T | null): marker is T => (
99
+ !!marker && (marker.side === null || marker.side === side)
100
+ );
101
+ const fixed = [lastPriceMarker, anchorMarker].filter(onSide).map(toAxisMarker);
102
+ // The prior close's label yields to every level's.
103
+ const referenceLabels = levelMarkers.filter((marker) => marker.prioritizeAxisLabel && onSide(marker)).map(toAxisMarker);
104
+ const levelLabels = [...levelMarkers.filter((marker) => !marker.prioritizeAxisLabel), priorCloseMarker].filter(onSide).map(toAxisMarker);
105
+ // A label is a row tall, so close levels would stack into an unreadable
106
+ // pile and hide the last price: each keeps its line, and only the labels
107
+ // with a row to themselves show. Desktop badges sit between rows.
108
+ const grid = fractionalViewport
109
+ ? placeAxisTicks({ ticks: side === "left" ? leftAxisTicks : rightAxisTicks, height: panel.height, cellHeightPx }).map((tick) => ({
110
+ ...toAxisMarker({ yRatio: tick.ratio, label: tick.label, color: colors.textDim }),
111
+ pixelY: tick.topPercent / 100 * Math.max(panel.height * cellHeightPx - 1, 1),
112
+ }))
113
+ : [...(side === "left" ? leftAxisLabels : rightAxisLabels)].map(([row, label]) => ({ id: undefined, row, pixelY: row * cellHeightPx, label, color: colors.textDim }));
114
+ const rowOf = (marker: ReturnType<typeof toAxisMarker>) => fractionalViewport ? marker.pixelY / cellHeightPx : marker.row;
115
+ // Named guides are part of the chart's readout: ordinary ticks yield to
116
+ // them, while a live price or cursor still keeps its place.
117
+ const references = fitAxisLabels(referenceLabels, fixed, rowOf);
118
+ const markers = [
119
+ ...references,
120
+ ...fitAxisLabels(levelLabels, [...references, ...fixed, ...grid], rowOf),
121
+ ...fixed,
122
+ ];
123
+ return markers.length > 0 ? markers : undefined;
124
+ };
125
+ return {
126
+ leftAxisLabels,
127
+ rightAxisLabels,
128
+ leftAxisTicks,
129
+ rightAxisTicks,
130
+ leftAxisMarkers: buildAxisMarkers("left"),
131
+ rightAxisMarkers: buildAxisMarkers("right"),
132
+ };
133
+ }
@@ -0,0 +1,78 @@
1
+ import { Box, Text } from "../../../../ui";
2
+ import { layoutLevelLabels, levelLabelStyle, levelLabelText } from "../level-labels";
3
+ import { fitAxisLabels, type CompositeChartLevels, type ProjectedLevel } from "../levels";
4
+ import type { CompositeAxisDomain } from "../types";
5
+ import { usePanelCursor, type PanelCursorView } from "./panel-cursor";
6
+
7
+ /**
8
+ * A panel's level labels at the plot's right edge, which step aside where the
9
+ * cursor's label covers theirs on the axis. A level's label leaves its value
10
+ * to the axis, unless the cursor's covers it there.
11
+ */
12
+ export function PanelLevelLabels({
13
+ view,
14
+ projectedLevels,
15
+ levels,
16
+ levelDomain,
17
+ plotWidth,
18
+ leftAxisWidth,
19
+ rightAxisWidth,
20
+ axisGap,
21
+ leftAxisMarkers,
22
+ rightAxisMarkers,
23
+ measuredPixelHeight,
24
+ background,
25
+ isDesktopWeb,
26
+ cellHeightPx,
27
+ cellWidthPx,
28
+ }: {
29
+ view: PanelCursorView;
30
+ projectedLevels: readonly ProjectedLevel[];
31
+ levels: CompositeChartLevels | null;
32
+ levelDomain: CompositeAxisDomain | null;
33
+ plotWidth: number;
34
+ leftAxisWidth: number;
35
+ rightAxisWidth: number;
36
+ axisGap: number;
37
+ leftAxisMarkers: readonly { id?: string }[] | undefined;
38
+ rightAxisMarkers: readonly { id?: string }[] | undefined;
39
+ /** The plot's measured height in px. */
40
+ measuredPixelHeight: number;
41
+ background: string;
42
+ isDesktopWeb: boolean;
43
+ cellHeightPx: number;
44
+ cellWidthPx: number;
45
+ }) {
46
+ const { panel } = view;
47
+ const { activeCursorYRatio, scene } = usePanelCursor(view);
48
+ const cursorValues = scene.cursorValues;
49
+ return (
50
+ <>
51
+ {(isDesktopWeb
52
+ ? layoutLevelLabels(projectedLevels, measuredPixelHeight, cellHeightPx)
53
+ : fitAxisLabels(projectedLevels.filter((entry) => entry.level.label), [], (entry) => entry.yRatio * Math.max(1, panel.height - 1))
54
+ ).map((entry) => {
55
+ const { level, yRatio } = entry;
56
+ const axisWidth = levelDomain?.side === "left" ? leftAxisWidth : rightAxisWidth;
57
+ const axisMarkers = levelDomain?.side === "left" ? leftAxisMarkers : rightAxisMarkers;
58
+ const cursorCovers = activeCursorYRatio !== null && Math.abs(activeCursorYRatio - yRatio) * panel.height < 1;
59
+ const axisVisible = !cursorCovers && (level.axisLabel?.length ?? 0) <= axisWidth && !!axisMarkers?.some((marker) => marker.id === level.id);
60
+ // A cursor on a bar at the level's own value (RETURN's on its best
61
+ // day) reads that value on the axis already: the label does not repeat it.
62
+ const cursorReadsLevel = cursorCovers && !!levels
63
+ && cursorValues.some((entry) => entry.seriesId === levels.seriesId && entry.value === level.value);
64
+ const label = levelLabelText(level, axisVisible || cursorReadsLevel);
65
+ const labelStyle = isDesktopWeb ? {
66
+ ...levelLabelStyle(entry, background), left: "auto", right: (rightAxisWidth + (rightAxisWidth ? axisGap : 0) + 1) * cellWidthPx,
67
+ maxWidth: Math.max(1, plotWidth - 2) * cellWidthPx,
68
+ } : undefined;
69
+ const labelWidth = Math.min(plotWidth - 2, label.length + 2);
70
+ return <Box key={`annotation:${level.id}`} position="absolute" left={leftAxisWidth + (leftAxisWidth ? axisGap : 0) + plotWidth - labelWidth - 1} top={yRatio * Math.max(0, panel.height - 1)} height={1}
71
+ width={labelWidth} flexDirection="row" justifyContent="flex-end" backgroundColor={background} zIndex={20}
72
+ style={labelStyle} data-gloom-role="chart-level-label">
73
+ <Text fg={labelStyle?.color ?? level.color} wrapMode="none" style={isDesktopWeb ? { lineHeight: 1 } : undefined}>{label}</Text>
74
+ </Box>;
75
+ })}
76
+ </>
77
+ );
78
+ }
@@ -0,0 +1,108 @@
1
+ import { useMemo } from "react";
2
+ import type { ChartSurfaceProps } from "../../../../ui";
3
+ import { colors as themeColors } from "../../../../theme/colors";
4
+ import { levelVectors, paintLevels, type ProjectedLevel } from "../levels";
5
+ import type { useCompositePanelBitmap } from "../panel-bitmap";
6
+ import { buildChartToolVectors, drawChartToolOverlay, type ChartToolDrag } from "../tools";
7
+ import type { CompositePanelSurfaceProps } from "./props";
8
+
9
+ /**
10
+ * What draws over the plot's raster: the panel's drawings, the tool in hand
11
+ * and the levels. The terminal paints them into the raster's layers; the
12
+ * desktop and the web draw them as vectors over it.
13
+ */
14
+ export function usePanelOverlays({
15
+ bitmap,
16
+ isDesktopWeb,
17
+ panel,
18
+ scene,
19
+ colors,
20
+ drawings,
21
+ selectedDrawingId,
22
+ drawColor,
23
+ selectedLevelId,
24
+ activeDrag,
25
+ toolDirection,
26
+ projectedLevels,
27
+ }: Pick<CompositePanelSurfaceProps, "panel" | "scene" | "colors" | "drawings" | "selectedDrawingId" | "drawColor" | "selectedLevelId"> & {
28
+ bitmap: ReturnType<typeof useCompositePanelBitmap>;
29
+ isDesktopWeb: boolean;
30
+ activeDrag: ChartToolDrag | null;
31
+ toolDirection: "up" | "down" | undefined;
32
+ projectedLevels: readonly ProjectedLevel[];
33
+ }) {
34
+ const panelDrawings = useMemo(
35
+ () => drawings.filter((drawing) => drawing.panelId === panel.id),
36
+ [drawings, panel.id],
37
+ );
38
+ // Drawings project through the time scale alone: the crosshair moving,
39
+ // here or on a linked chart, must not repaint the plot, which the terminal's
40
+ // kitty surface would upload whole again.
41
+ const drawingProjection = useMemo(() => ({ timeScale: scene.timeScale }), [scene.timeScale]);
42
+ const bitmapLayers = useMemo(() => {
43
+ if (!bitmap) return null;
44
+ // The desktop composites overlays as vectors, so the plot raster stays put
45
+ // while a tool drags. Copying and reblending it per frame is what made the
46
+ // ruler feel heavy.
47
+ if (isDesktopWeb) return [bitmap];
48
+ const base = !activeDrag && panelDrawings.length === 0 ? bitmap : drawChartToolOverlay(
49
+ bitmap,
50
+ activeDrag,
51
+ {
52
+ positive: themeColors.positive,
53
+ negative: colors.negative,
54
+ zoom: colors.crosshair,
55
+ draw: drawColor,
56
+ },
57
+ toolDirection ?? "up",
58
+ { scene: drawingProjection, panel, items: panelDrawings, selectedId: selectedDrawingId },
59
+ );
60
+ return [projectedLevels.length > 0 ? paintLevels(base, projectedLevels, selectedLevelId) : base];
61
+ }, [
62
+ activeDrag,
63
+ bitmap,
64
+ colors.crosshair,
65
+ colors.negative,
66
+ drawColor,
67
+ drawingProjection,
68
+ isDesktopWeb,
69
+ panel,
70
+ panelDrawings,
71
+ projectedLevels,
72
+ selectedDrawingId,
73
+ selectedLevelId,
74
+ toolDirection,
75
+ ]);
76
+ const vectors = useMemo<ChartSurfaceProps["vectors"]>(() => {
77
+ if (!isDesktopWeb) return null;
78
+ const shapes = [...levelVectors(projectedLevels, selectedLevelId), ...buildChartToolVectors({
79
+ scene,
80
+ panel,
81
+ drawings: panelDrawings,
82
+ selectedId: selectedDrawingId,
83
+ drag: activeDrag,
84
+ colors: {
85
+ positive: themeColors.positive,
86
+ negative: colors.negative,
87
+ zoom: colors.crosshair,
88
+ draw: drawColor,
89
+ },
90
+ direction: toolDirection ?? "up",
91
+ })];
92
+ return shapes.length > 0 ? shapes : null;
93
+ }, [
94
+ activeDrag,
95
+ colors.crosshair,
96
+ colors.negative,
97
+ drawColor,
98
+ isDesktopWeb,
99
+ panel,
100
+ panelDrawings,
101
+ projectedLevels,
102
+ scene,
103
+ selectedDrawingId,
104
+ selectedLevelId,
105
+ toolDirection,
106
+ ]);
107
+ return { bitmapLayers, vectors };
108
+ }
@@ -0,0 +1,54 @@
1
+ import { useCallback, useEffect, useRef } from "react";
2
+ import { PAN_COAST_START_SPEED, PAN_COAST_STOP_SPEED, panCoastStep } from "../panel-gestures";
3
+ import type { CompositePanelSurfaceProps } from "./props";
4
+ import { webFrame } from "./pointer";
5
+
6
+ /**
7
+ * A pan let go while still moving keeps going and slows down, on the
8
+ * desktop and web only: in a terminal every frame would upload the plot again.
9
+ */
10
+ export function usePanCoast({
11
+ isDesktopWeb,
12
+ plotWidth,
13
+ onPanViewport,
14
+ }: Pick<CompositePanelSurfaceProps, "onPanViewport"> & {
15
+ isDesktopWeb: boolean;
16
+ /** The plot's measured width in cells, which the speed is read against. */
17
+ plotWidth: number;
18
+ }) {
19
+ const coastFrameRef = useRef<number | null>(null);
20
+ const coastPanRef = useRef(onPanViewport);
21
+ coastPanRef.current = onPanViewport;
22
+ const stopCoast = useCallback(() => {
23
+ if (coastFrameRef.current === null) return;
24
+ webFrame.cancelAnimationFrame?.(coastFrameRef.current);
25
+ coastFrameRef.current = null;
26
+ globalThis.removeEventListener?.("pointerdown", stopCoast, true);
27
+ globalThis.removeEventListener?.("keydown", stopCoast, true);
28
+ }, []);
29
+ const startCoast = useCallback((velocity: number, positionsPerCell: number) => {
30
+ stopCoast();
31
+ const requestFrame = webFrame.requestAnimationFrame;
32
+ const widthCells = Math.max(plotWidth, 1);
33
+ const plotWidthsPerSecond = (speed: number) => Math.abs(speed) * 1000 / widthCells;
34
+ if (!isDesktopWeb || !requestFrame || plotWidthsPerSecond(velocity) < PAN_COAST_START_SPEED) return;
35
+ if (globalThis.matchMedia?.("(prefers-reduced-motion: reduce)").matches) return;
36
+ let speed = velocity;
37
+ let last = performance.now();
38
+ const step = () => {
39
+ const now = performance.now();
40
+ const next = panCoastStep(speed, now - last);
41
+ last = now;
42
+ speed = next.velocity;
43
+ coastPanRef.current(next.cells * positionsPerCell);
44
+ if (plotWidthsPerSecond(speed) < PAN_COAST_STOP_SPEED) stopCoast();
45
+ else coastFrameRef.current = requestFrame(step);
46
+ };
47
+ coastFrameRef.current = requestFrame(step);
48
+ // Any press or key anywhere, a range button or a reset, takes the view back from the coast.
49
+ globalThis.addEventListener?.("pointerdown", stopCoast, true);
50
+ globalThis.addEventListener?.("keydown", stopCoast, true);
51
+ }, [isDesktopWeb, plotWidth, stopCoast]);
52
+ useEffect(() => stopCoast, [stopCoast]);
53
+ return { stopCoast, startCoast };
54
+ }