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
@@ -0,0 +1,102 @@
1
+ import { useCallback, useEffect, useRef } from "react";
2
+ import { consumeChartMouseEvent, type ChartMouseEvent, type LocalPlotPointer } from "../../core/pointer";
3
+ import { compositeViewportPositions, resolveCompositeWheelPan, resolveCompositeWheelZoom } from "../interactions";
4
+ import { isVerticalWheelDirection, type PendingWheel } from "../panel-gestures";
5
+ import type { CompositePanelSurfaceProps } from "./props";
6
+ import { webFrame } from "./pointer";
7
+
8
+ /**
9
+ * The wheel over the plot pans it, and with Ctrl zooms it around the pointer.
10
+ * Trackpads fire wheel events faster than the plot can paint, so one frame
11
+ * absorbs every event that arrived since the last one.
12
+ */
13
+ export function usePlotWheel({
14
+ frame,
15
+ viewport,
16
+ onPanViewport,
17
+ onZoomViewport,
18
+ onActivate,
19
+ plotWidth,
20
+ plotSpanFactor,
21
+ measuredPlotWidth,
22
+ cellWidthPx,
23
+ isDesktopWeb,
24
+ stopCoast,
25
+ plotPointer,
26
+ updateCursor,
27
+ }: Pick<CompositePanelSurfaceProps, "frame" | "viewport" | "onPanViewport" | "onZoomViewport" | "onActivate" | "plotWidth"> & {
28
+ plotSpanFactor: number;
29
+ /** The plot's measured width in cells. */
30
+ measuredPlotWidth: number;
31
+ cellWidthPx: number;
32
+ isDesktopWeb: boolean;
33
+ stopCoast: () => void;
34
+ plotPointer: (event: ChartMouseEvent) => LocalPlotPointer | null;
35
+ updateCursor: (event: ChartMouseEvent) => boolean;
36
+ }) {
37
+ const pendingWheelRef = useRef<PendingWheel | null>(null);
38
+ const wheelFrameRef = useRef<number | null>(null);
39
+ const latestWheelStateRef = useRef({ frame, viewport, onPanViewport, onZoomViewport, plotSpanFactor });
40
+ latestWheelStateRef.current = { frame, viewport, onPanViewport, onZoomViewport, plotSpanFactor };
41
+ const flushWheel = useCallback(() => {
42
+ wheelFrameRef.current = null;
43
+ const pending = pendingWheelRef.current;
44
+ pendingWheelRef.current = null;
45
+ if (!pending) return;
46
+ const latest = latestWheelStateRef.current;
47
+ if (pending.panRatio !== 0) {
48
+ const positions = compositeViewportPositions(latest.frame, latest.viewport);
49
+ const span = positions ? Math.max(positions.end - positions.start, Number.EPSILON) : 0;
50
+ latest.onPanViewport(pending.panRatio * span * latest.plotSpanFactor);
51
+ }
52
+ if (pending.zoomLog !== 0) {
53
+ latest.onZoomViewport(Math.exp(pending.zoomLog), pending.anchorRatio);
54
+ }
55
+ }, []);
56
+ useEffect(() => () => {
57
+ pendingWheelRef.current = null;
58
+ if (wheelFrameRef.current !== null) {
59
+ webFrame.cancelAnimationFrame?.(wheelFrameRef.current);
60
+ wheelFrameRef.current = null;
61
+ }
62
+ }, []);
63
+ return useCallback((event: ChartMouseEvent) => {
64
+ const scroll = event.scroll;
65
+ if (!scroll) return;
66
+ stopCoast();
67
+ onActivate?.();
68
+ consumeChartMouseEvent(event);
69
+ const pointer = plotPointer(event);
70
+ updateCursor(event);
71
+ const pending = pendingWheelRef.current ?? { panRatio: 0, zoomLog: 0, anchorRatio: 0.5 };
72
+ if (event.modifiers.ctrl && pointer && isVerticalWheelDirection(scroll.direction)) {
73
+ pending.zoomLog += Math.log(resolveCompositeWheelZoom(scroll));
74
+ // The anchor is a fraction of the viewport, so a pointer over the empty
75
+ // right offset anchors on the newest observation instead of past it.
76
+ pending.anchorRatio = Math.min(
77
+ 1,
78
+ pointer.cellX / Math.max(plotWidth - 1, 1) * plotSpanFactor,
79
+ );
80
+ } else {
81
+ pending.panRatio += resolveCompositeWheelPan(scroll, measuredPlotWidth * cellWidthPx);
82
+ }
83
+ pendingWheelRef.current = pending;
84
+ if (!isDesktopWeb || typeof webFrame.requestAnimationFrame !== "function") {
85
+ flushWheel();
86
+ return;
87
+ }
88
+ if (wheelFrameRef.current === null) {
89
+ wheelFrameRef.current = webFrame.requestAnimationFrame(flushWheel);
90
+ }
91
+ }, [
92
+ cellWidthPx,
93
+ flushWheel,
94
+ isDesktopWeb,
95
+ onActivate,
96
+ plotPointer,
97
+ measuredPlotWidth,
98
+ plotSpanFactor,
99
+ plotWidth,
100
+ updateCursor,
101
+ ]);
102
+ }
@@ -0,0 +1,12 @@
1
+ import type { ChartMouseEvent } from "../../core/pointer";
2
+
3
+ /** The host's animation frames, where it has them: the desktop and the web. */
4
+ export const webFrame = globalThis as typeof globalThis & {
5
+ requestAnimationFrame?: (callback: () => void) => number;
6
+ cancelAnimationFrame?: (handle: number) => void;
7
+ };
8
+
9
+ /** The pointer's height in rows, to a fraction of one where the host reports it. */
10
+ export function pointerRow(event: ChartMouseEvent): number {
11
+ return typeof event.preciseY === "number" ? event.preciseY : event.y;
12
+ }
@@ -0,0 +1,79 @@
1
+ import type { ChartMouseEvent } from "../../core/pointer";
2
+ import type { CompositeCursorSource } from "../cursor-source";
3
+ import type { CompositeAxisValueFormatter } from "../format";
4
+ import type { CompositeNavigationFrame, CompositeViewportRange } from "../interactions";
5
+ import type { CompositeChartLevels } from "../levels";
6
+ import type { ChartDrawing, ChartToolKind, ChartToolSpan } from "../tools";
7
+ import type { CompositeAxisSide, CompositeChartColors, CompositeChartScene, CompositePanelScene } from "../types";
8
+ import type { KeyboardToolDrag } from "../use-composite-chart-keyboard";
9
+ import type { CompositeValueRange } from "../value-scale";
10
+
11
+ export interface CompositePanelSurfaceProps {
12
+ panel: CompositePanelScene;
13
+ /** The chart's scene, without its cursor: the crosshair comes from `cursor`. */
14
+ scene: CompositeChartScene;
15
+ cursor: CompositeCursorSource;
16
+ plotWidth: number;
17
+ leftAxisWidth: number;
18
+ rightAxisWidth: number;
19
+ axisGap: number;
20
+ colors: CompositeChartColors;
21
+ interactive: boolean;
22
+ /** False keeps the hover cursor but removes pan, zoom, and the tools. */
23
+ navigable: boolean;
24
+ formatAxisValue?: CompositeAxisValueFormatter;
25
+ remoteKind?: string;
26
+ viewport: CompositeViewportRange;
27
+ frame: CompositeNavigationFrame;
28
+ armedTool: ChartToolKind | null;
29
+ drawings: readonly ChartDrawing[];
30
+ selectedDrawingId: string | null;
31
+ drawColor: string;
32
+ onDraw: (drawing: ChartDrawing) => void;
33
+ onEditDrawing: (id: string, update: (drawing: ChartDrawing) => ChartDrawing) => void;
34
+ onSelectDrawing: (id: string | null) => void;
35
+ onActivate?: () => void;
36
+ onCursorDateChange: (date: Date | null) => void;
37
+ /** The cursor shown is another chart's, so the pointer's level is not part of it. */
38
+ sharedCursor: boolean;
39
+ /** Positive positions move toward older observations. A gesture supplies the frame and origin it started from. */
40
+ onPanViewport: (
41
+ deltaPositions: number,
42
+ gesture?: { frame: CompositeNavigationFrame; from: CompositeViewportRange },
43
+ ) => void;
44
+ onZoomViewport: (zoomFactor: number, anchorRatio: number) => void;
45
+ onSetViewport: (range: CompositeViewportRange) => void;
46
+ onToolSpanChange: (span: ChartToolSpan | null) => void;
47
+ /** A press on the plot started (true) or stopped (false) dragging: a pan, a tool, a drawing or a level. */
48
+ onDragActiveChange?: (dragging: boolean) => void;
49
+ /** The tool being placed from the keyboard, when it lives in this panel. */
50
+ keyboardToolDrag: KeyboardToolDrag | null;
51
+ /** A press on the plot: the pointer takes over from a keyboard placement. */
52
+ onPointerPress: () => void;
53
+ showTextFallback: boolean;
54
+ /** Set while the owner is picking a bar: a press picks instead of panning. */
55
+ onPickTime?: (date: Date) => void;
56
+ /** Set while the owner is picking a price on the levels' series: a press picks the one under it. */
57
+ onPickPrice?: (value: number) => void;
58
+ /** The chart's levels when they draw on this panel. */
59
+ levels: CompositeChartLevels | null;
60
+ selectedLevelId: string | null;
61
+ onSelectLevel: (id: string | null) => void;
62
+ /** The value axes stretch and squeeze under a drag or the wheel, and a double click fits them again. */
63
+ valueScalable: boolean;
64
+ onSetValueScale: (panelId: string, side: CompositeAxisSide, key: string, range: CompositeValueRange) => void;
65
+ onResetValueScale: (panelId: string) => void;
66
+ /** A hairline on the line above this panel (desktop and web), as the chart's `panelRules` asks. */
67
+ ruleAbove?: boolean;
68
+ /** The line above this panel, which a drag moves (desktop and web): null for the top panel. */
69
+ dividerAbove?: { active: boolean; gestures: PanelDividerGestures } | null;
70
+ /** A double click on bare plot gives this panel the whole chart, or gives the others back. */
71
+ onToggleMaximized?: () => void;
72
+ }
73
+
74
+ interface PanelDividerGestures {
75
+ onMouseDown: (event: ChartMouseEvent) => void;
76
+ onMouseDrag: (event: ChartMouseEvent) => void;
77
+ onMouseUp: (event: ChartMouseEvent) => void;
78
+ onMouseDragEnd: (event: ChartMouseEvent) => void;
79
+ }
@@ -0,0 +1,151 @@
1
+ import { useEffect, useMemo } from "react";
2
+ import { colors as themeColors } from "../../../../theme/colors";
3
+ import { formatCompositeCursorValue } from "../format";
4
+ import { unprojectCompositeValue } from "../scene";
5
+ import { unprojectCompositeTimestamp } from "../time-scale";
6
+ import {
7
+ countMeasureBars,
8
+ resolveMeasureAxisDomain,
9
+ resolveMeasureDirection,
10
+ summarizeMeasure,
11
+ summarizeZoomRange,
12
+ summarizeZoomSelection,
13
+ type ChartToolDrag,
14
+ } from "../tools";
15
+ import type { KeyboardToolDrag } from "../use-composite-chart-keyboard";
16
+ import type { CompositePanelSurfaceProps } from "./props";
17
+
18
+ /** Where a measure started, marked on the value axes. */
19
+ export interface ToolAnchorMarker {
20
+ side: null;
21
+ yRatio: number;
22
+ label: string;
23
+ color: string;
24
+ }
25
+
26
+ /**
27
+ * What a tool in hand reads out while it drags, or while it is placed from
28
+ * the keyboard: the summary over the plot, the span it covers (told to the
29
+ * chart, which marks it on the time axis), and the value it started from.
30
+ */
31
+ export function usePanelToolReadout({
32
+ panel,
33
+ scene,
34
+ colors,
35
+ activeDrag,
36
+ keyboardDrag,
37
+ onToolSpanChange,
38
+ plotWidth,
39
+ leftAxisWidth,
40
+ axisGap,
41
+ }: Pick<CompositePanelSurfaceProps, "panel" | "scene" | "colors" | "onToolSpanChange" | "plotWidth" | "leftAxisWidth" | "axisGap"> & {
42
+ activeDrag: ChartToolDrag | null;
43
+ keyboardDrag: KeyboardToolDrag | null;
44
+ }) {
45
+ const measureDomain = useMemo(() => resolveMeasureAxisDomain(panel), [panel]);
46
+ const toolReadout = useMemo(() => {
47
+ if (!activeDrag) return null;
48
+ // A keyboard placement knows its data points exactly, even off screen; a
49
+ // pointer drag reads them back from the plot.
50
+ const startTime = keyboardDrag?.start.time
51
+ ?? unprojectCompositeTimestamp(scene.timeScale, activeDrag.startXRatio);
52
+ const endTime = keyboardDrag?.end.time
53
+ ?? unprojectCompositeTimestamp(scene.timeScale, activeDrag.endXRatio);
54
+ if (activeDrag.kind === "zoom") {
55
+ return {
56
+ direction: "up" as const,
57
+ summary: keyboardDrag
58
+ ? summarizeZoomRange(scene, startTime, endTime)
59
+ : summarizeZoomSelection(scene, activeDrag),
60
+ startTime,
61
+ startValueLabel: null,
62
+ endValueLabel: null,
63
+ };
64
+ }
65
+ const startValue = keyboardDrag
66
+ ? keyboardDrag.start.value
67
+ : measureDomain ? unprojectCompositeValue(activeDrag.startYRatio, measureDomain) : null;
68
+ const endValue = keyboardDrag
69
+ ? keyboardDrag.end.value
70
+ : measureDomain ? unprojectCompositeValue(activeDrag.endYRatio, measureDomain) : null;
71
+ return {
72
+ direction: resolveMeasureDirection(startValue, endValue),
73
+ summary: summarizeMeasure({
74
+ startValue,
75
+ endValue,
76
+ startTime,
77
+ endTime,
78
+ // Cross-market cursor stops include every listing's observations;
79
+ // measured bars still follow the primary market's session scale.
80
+ bars: countMeasureBars(scene.timeScale.kind === "market"
81
+ ? scene.timeScale.anchors.map(({ timestamp }) => new Date(timestamp))
82
+ : scene.dates, startTime, endTime),
83
+ domain: measureDomain,
84
+ }),
85
+ startTime,
86
+ startValueLabel: measureDomain && startValue !== null
87
+ ? formatCompositeCursorValue(startValue, measureDomain)
88
+ : null,
89
+ endValueLabel: measureDomain && endValue !== null
90
+ ? formatCompositeCursorValue(endValue, measureDomain)
91
+ : null,
92
+ };
93
+ }, [activeDrag, keyboardDrag, measureDomain, scene]);
94
+ const toolSummary = toolReadout?.summary ?? null;
95
+ const toolStartTime = toolReadout?.startTime ?? null;
96
+ const toolSpan = useMemo(() => {
97
+ if (!activeDrag || !toolSummary || toolStartTime === null) return null;
98
+ return {
99
+ startXRatio: activeDrag.startXRatio,
100
+ endXRatio: activeDrag.endXRatio,
101
+ startTime: toolStartTime,
102
+ color: activeDrag.kind === "zoom"
103
+ ? colors.crosshair
104
+ : toolReadout?.direction === "down" ? colors.negative : themeColors.positive,
105
+ };
106
+ }, [activeDrag, colors.crosshair, colors.negative, toolReadout?.direction, toolStartTime, toolSummary]);
107
+ useEffect(() => {
108
+ onToolSpanChange(toolSpan);
109
+ }, [onToolSpanChange, toolSpan]);
110
+ const measureReadout = useMemo(() => {
111
+ if (!activeDrag || !toolReadout?.summary) return null;
112
+ const text = toolReadout.summary;
113
+ const centreX = (activeDrag.startXRatio + activeDrag.endXRatio) / 2;
114
+ const centreY = activeDrag.kind === "zoom"
115
+ ? 0.5
116
+ : (activeDrag.startYRatio + activeDrag.endYRatio) / 2;
117
+ const width = Math.min([...text].length, plotWidth);
118
+ return {
119
+ text,
120
+ width,
121
+ color: activeDrag.kind === "zoom"
122
+ ? colors.text
123
+ : toolReadout.direction === "down" ? colors.negative : themeColors.positive,
124
+ left: leftAxisWidth + (leftAxisWidth ? axisGap : 0)
125
+ + Math.max(0, Math.min(plotWidth - width, Math.round(centreX * plotWidth - width / 2))),
126
+ top: Math.max(0, Math.min(panel.height - 1, Math.round(centreY * (panel.height - 1)))),
127
+ };
128
+ }, [
129
+ activeDrag,
130
+ axisGap,
131
+ colors.negative,
132
+ colors.text,
133
+ leftAxisWidth,
134
+ panel.height,
135
+ plotWidth,
136
+ toolReadout,
137
+ ]);
138
+ const anchorMarker = useMemo((): ToolAnchorMarker | null => {
139
+ // The crosshair already marks the moving end, so the axes only need the
140
+ // anchor the drag started from.
141
+ if (!activeDrag || activeDrag.kind === "zoom" || !toolReadout?.startValueLabel) return null;
142
+ return {
143
+ side: null,
144
+ // A keyboard anchor can leave the value range once the view moves.
145
+ yRatio: Math.max(0, Math.min(1, activeDrag.startYRatio)),
146
+ label: toolReadout.startValueLabel,
147
+ color: toolReadout.direction === "down" ? colors.negative : themeColors.positive,
148
+ };
149
+ }, [activeDrag, colors.negative, toolReadout]);
150
+ return { toolDirection: toolReadout?.direction, measureReadout, anchorMarker };
151
+ }
@@ -0,0 +1,152 @@
1
+ import { useCallback, useEffect, useMemo, useRef, type RefObject } from "react";
2
+ import type { BoxRenderable } from "../../../../ui";
3
+ import { clamp } from "../../../../utils/math";
4
+ import { consumeChartMouseEvent, type ChartMouseEvent } from "../../core/pointer";
5
+ import { resolveCompositeWheelZoom } from "../interactions";
6
+ import { AXIS_DOUBLE_PRESS_MS, isVerticalWheelDirection, type PendingAxisWheel, type ValueAxisStart } from "../panel-gestures";
7
+ import type { CompositeAxisSide } from "../types";
8
+ import { resolveAxisDragSpanFactor, zoomValueRange } from "../value-scale";
9
+ import { pointerRow, webFrame } from "./pointer";
10
+ import type { CompositePanelSurfaceProps } from "./props";
11
+
12
+ /**
13
+ * A value axis under the pointer: a drag stretches (up) or squeezes (down)
14
+ * it around its middle, the wheel around the pointer, and a double click
15
+ * fits it to the data again. Read through refs, so the handlers stay put.
16
+ */
17
+ export function useValueAxisGestures({
18
+ plotRef,
19
+ panel,
20
+ valueScalable,
21
+ onSetValueScale,
22
+ onResetValueScale,
23
+ onActivate,
24
+ isDesktopWeb,
25
+ cellHeightPx,
26
+ fractionalViewport,
27
+ }: Pick<CompositePanelSurfaceProps, "panel" | "valueScalable" | "onSetValueScale" | "onResetValueScale" | "onActivate"> & {
28
+ plotRef: RefObject<BoxRenderable | null>;
29
+ isDesktopWeb: boolean;
30
+ cellHeightPx: number;
31
+ fractionalViewport: boolean;
32
+ }) {
33
+ const axisGestureRef = useRef<(ValueAxisStart & { startRow: number; moved: boolean }) | null>(null);
34
+ const lastAxisPressRef = useRef<{ side: CompositeAxisSide; at: number } | null>(null);
35
+ const latestAxesRef = useRef({ panel, onSetValueScale, onResetValueScale, onActivate });
36
+ latestAxesRef.current = { panel, onSetValueScale, onResetValueScale, onActivate };
37
+ /** The pointer's height down the panel, 0 at the top and 1 at the bottom. */
38
+ const axisPointerRatio = useCallback((event: ChartMouseEvent): number => {
39
+ const plot = plotRef.current as unknown as { absoluteY?: number; y?: number; height?: number } | null;
40
+ const top = plot?.absoluteY ?? plot?.y;
41
+ const height = plot?.height ?? 0;
42
+ if (top === undefined || height <= 1) return 0.5;
43
+ return clamp((pointerRow(event) - top) / (fractionalViewport ? height : height - 1), 0, 1);
44
+ }, [fractionalViewport]);
45
+ const pressAxis = useCallback((side: CompositeAxisSide, event: ChartMouseEvent) => {
46
+ const latest = latestAxesRef.current;
47
+ const domain = latest.panel.axes[side];
48
+ if (!domain?.scaleKey) return;
49
+ latest.onActivate?.();
50
+ consumeChartMouseEvent(event);
51
+ // The desktop counts clicks; the terminal has two presses close together.
52
+ const now = Date.now();
53
+ const last = lastAxisPressRef.current;
54
+ const double = typeof event.detail === "number"
55
+ ? event.detail >= 2
56
+ : !!last && last.side === side && now - last.at < AXIS_DOUBLE_PRESS_MS;
57
+ if (double) {
58
+ lastAxisPressRef.current = null;
59
+ axisGestureRef.current = null;
60
+ latest.onResetValueScale(latest.panel.id);
61
+ return;
62
+ }
63
+ lastAxisPressRef.current = { side, at: now };
64
+ axisGestureRef.current = {
65
+ side,
66
+ key: domain.scaleKey,
67
+ scale: domain.scale,
68
+ start: { min: domain.min, max: domain.max },
69
+ startRow: pointerRow(event),
70
+ moved: false,
71
+ };
72
+ }, []);
73
+ const dragAxis = useCallback((event: ChartMouseEvent) => {
74
+ const gesture = axisGestureRef.current;
75
+ if (!gesture) return;
76
+ consumeChartMouseEvent(event);
77
+ const deltaPx = (pointerRow(event) - gesture.startRow) * cellHeightPx;
78
+ if (!gesture.moved && Math.abs(deltaPx) < 1) return;
79
+ // A drag is not the first half of a double click.
80
+ gesture.moved = true;
81
+ lastAxisPressRef.current = null;
82
+ const latest = latestAxesRef.current;
83
+ latest.onSetValueScale(
84
+ latest.panel.id,
85
+ gesture.side,
86
+ gesture.key,
87
+ zoomValueRange(gesture.start, gesture.scale, resolveAxisDragSpanFactor(deltaPx), 0.5),
88
+ );
89
+ }, [cellHeightPx]);
90
+ const releaseAxis = useCallback(() => {
91
+ axisGestureRef.current = null;
92
+ }, []);
93
+ const pendingAxisWheelRef = useRef<PendingAxisWheel | null>(null);
94
+ const axisWheelFrameRef = useRef<number | null>(null);
95
+ const flushAxisWheel = useCallback(() => {
96
+ axisWheelFrameRef.current = null;
97
+ const pending = pendingAxisWheelRef.current;
98
+ pendingAxisWheelRef.current = null;
99
+ const latest = latestAxesRef.current;
100
+ const domain = pending ? latest.panel.axes[pending.side] : undefined;
101
+ if (!pending || !domain?.scaleKey || pending.spanLog === 0) return;
102
+ latest.onSetValueScale(
103
+ latest.panel.id,
104
+ pending.side,
105
+ domain.scaleKey,
106
+ zoomValueRange({ min: domain.min, max: domain.max }, domain.scale, Math.exp(pending.spanLog), pending.anchorRatio),
107
+ );
108
+ }, []);
109
+ useEffect(() => () => {
110
+ pendingAxisWheelRef.current = null;
111
+ if (axisWheelFrameRef.current !== null) {
112
+ webFrame.cancelAnimationFrame?.(axisWheelFrameRef.current);
113
+ axisWheelFrameRef.current = null;
114
+ }
115
+ }, []);
116
+ const wheelAxis = useCallback((side: CompositeAxisSide, event: ChartMouseEvent) => {
117
+ const scroll = event.scroll;
118
+ if (!scroll || !latestAxesRef.current.panel.axes[side]?.scaleKey) return;
119
+ latestAxesRef.current.onActivate?.();
120
+ consumeChartMouseEvent(event);
121
+ if (!isVerticalWheelDirection(scroll.direction)) return;
122
+ const pending = pendingAxisWheelRef.current?.side === side
123
+ ? pendingAxisWheelRef.current
124
+ : { side, spanLog: 0, anchorRatio: 0.5 };
125
+ // Up stretches, as Ctrl and the wheel zoom the plot in.
126
+ pending.spanLog -= Math.log(resolveCompositeWheelZoom(scroll));
127
+ pending.anchorRatio = axisPointerRatio(event);
128
+ pendingAxisWheelRef.current = pending;
129
+ if (!isDesktopWeb || typeof webFrame.requestAnimationFrame !== "function") {
130
+ flushAxisWheel();
131
+ return;
132
+ }
133
+ if (axisWheelFrameRef.current === null) {
134
+ axisWheelFrameRef.current = webFrame.requestAnimationFrame(flushAxisWheel);
135
+ }
136
+ }, [axisPointerRatio, flushAxisWheel, isDesktopWeb]);
137
+ const leftAxisGestures = useMemo(() => valueScalable ? {
138
+ onMouseDown: (event: ChartMouseEvent) => pressAxis("left", event),
139
+ onMouseDrag: dragAxis,
140
+ onMouseUp: releaseAxis,
141
+ onMouseDragEnd: releaseAxis,
142
+ onMouseScroll: (event: ChartMouseEvent) => wheelAxis("left", event),
143
+ } : undefined, [dragAxis, pressAxis, releaseAxis, valueScalable, wheelAxis]);
144
+ const rightAxisGestures = useMemo(() => valueScalable ? {
145
+ onMouseDown: (event: ChartMouseEvent) => pressAxis("right", event),
146
+ onMouseDrag: dragAxis,
147
+ onMouseUp: releaseAxis,
148
+ onMouseDragEnd: releaseAxis,
149
+ onMouseScroll: (event: ChartMouseEvent) => wheelAxis("right", event),
150
+ } : undefined, [dragAxis, pressAxis, releaseAxis, valueScalable, wheelAxis]);
151
+ return { leftAxisGestures, rightAxisGestures };
152
+ }