gloomberb 0.20.3 → 0.20.5

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 (348) hide show
  1. package/README.md +2 -0
  2. package/bin/gloom +9 -0
  3. package/bin/without-bun.cjs +98 -0
  4. package/package.json +3 -1
  5. package/src/account/auth-dialog.tsx +17 -0
  6. package/src/api-client/data.ts +144 -35
  7. package/src/api-client/fx-interventions.ts +64 -0
  8. package/src/api-client/index.ts +1 -0
  9. package/src/api-client/release-summaries.ts +21 -0
  10. package/src/api-client/types/econ.ts +12 -0
  11. package/src/api-client/yield-curves.ts +1 -1
  12. package/src/app/global-shortcuts.ts +4 -1
  13. package/src/app/keybindings/actions.ts +8 -2
  14. package/src/app/keybindings/config.ts +2 -1
  15. package/src/app/keybindings/index.ts +1 -0
  16. package/src/app/keybindings/labels.ts +6 -1
  17. package/src/app/keybindings/resolve.ts +23 -4
  18. package/src/app/keybindings/terminal-keys.ts +35 -0
  19. package/src/app/pane-runtime/index.tsx +2 -2
  20. package/src/app/pane-runtime/ticker-open-runtime.ts +274 -67
  21. package/src/architecture/ui-literals-allowlist.json +1 -1
  22. package/src/capabilities/chart-series.ts +27 -1
  23. package/src/cli/commands/keybindings.ts +5 -5
  24. package/src/cli/commands/market.ts +154 -21
  25. package/src/cli/commands/news-search.ts +60 -10
  26. package/src/cli/commands/overview.ts +16 -1
  27. package/src/cli/commands/plugins.ts +27 -5
  28. package/src/cli/commands/remote.ts +16 -17
  29. package/src/cli/commands/system.ts +20 -4
  30. package/src/cli/commands/ticker.ts +60 -19
  31. package/src/cli/fx-forward.ts +25 -7
  32. package/src/cli/glossary.ts +19 -5
  33. package/src/cli/history-rows.ts +5 -3
  34. package/src/cli/index.ts +8 -8
  35. package/src/cli/known-gaps.ts +27 -1
  36. package/src/cli/listing-arg.ts +11 -1
  37. package/src/cli/name-entries.ts +5 -1
  38. package/src/cli/not-a-ticker.ts +4 -0
  39. package/src/cli/pane-functions/function-help.ts +5 -5
  40. package/src/cli/report-tables.ts +18 -6
  41. package/src/cli/result.ts +15 -7
  42. package/src/cli/types.ts +2 -0
  43. package/src/components/chart/composite/axis-overlays.tsx +22 -0
  44. package/src/components/chart/composite/composite-chart.tsx +54 -13
  45. package/src/components/chart/composite/event-captions.ts +109 -0
  46. package/src/components/chart/composite/event-guides.ts +74 -0
  47. package/src/components/chart/composite/rasterizer.ts +2 -0
  48. package/src/components/chart/composite/text-renderer.ts +2 -0
  49. package/src/components/chart/composite/types.ts +31 -0
  50. package/src/components/command-bar/layout-items/focused-pane.ts +5 -5
  51. package/src/components/command-bar/pane-settings.ts +2 -2
  52. package/src/components/command-bar/routes/root/provider-search.ts +5 -4
  53. package/src/components/command-bar/routes/root/results.ts +6 -2
  54. package/src/components/command-bar/routes/ticker-search/results.ts +51 -0
  55. package/src/components/command-bar/routes/ticker-search/route.ts +3 -2
  56. package/src/components/input-search-bar.tsx +9 -2
  57. package/src/components/layout/detached-pane-shell.tsx +1 -1
  58. package/src/components/layout/floating-pane.tsx +5 -1
  59. package/src/components/layout/pane/footer/index.tsx +21 -14
  60. package/src/components/layout/pane/footer/model.ts +6 -0
  61. package/src/components/layout/pane/header.tsx +2 -0
  62. package/src/components/layout/shell/action-menu-overlay.tsx +10 -5
  63. package/src/components/layout/shell/active-drag.ts +149 -105
  64. package/src/components/layout/shell/drag/drop-zones.ts +162 -0
  65. package/src/components/layout/shell/drag/index.ts +47 -218
  66. package/src/components/layout/shell/drag/live.ts +10 -3
  67. package/src/components/layout/shell/drag/overlays.tsx +182 -5
  68. package/src/components/layout/shell/drag/runtime.ts +29 -6
  69. package/src/components/layout/shell/drag/shared-edges.ts +156 -0
  70. package/src/components/layout/shell/index.tsx +11 -6
  71. package/src/components/layout/shell/menu.ts +11 -2
  72. package/src/components/layout/shell/native/pointer-runtime.ts +25 -0
  73. package/src/components/layout/shell/native/window-state.ts +2 -2
  74. package/src/components/layout/shell/pane/capture.ts +4 -1
  75. package/src/components/layout/shell/pane/layers.tsx +71 -7
  76. package/src/components/layout/shell/terminal-pointer-runtime.ts +18 -9
  77. package/src/components/layout/shell/window-mode/index.ts +8 -10
  78. package/src/components/layout/status-bar.tsx +6 -1
  79. package/src/components/layout/window-edit/mode.ts +39 -7
  80. package/src/components/layout/window-edit/presentation.ts +1 -1
  81. package/src/components/onboarding/first-run-workspace.ts +44 -2
  82. package/src/components/onboarding/onboarding-frame.tsx +11 -2
  83. package/src/components/onboarding/onboarding-keyboard.ts +20 -0
  84. package/src/components/onboarding/onboarding-wizard.tsx +16 -11
  85. package/src/components/onboarding/portfolio-step/positions-panel.tsx +62 -1
  86. package/src/components/onboarding/use-onboarding-progress.ts +12 -4
  87. package/src/components/pane-settings-dialog/desktop.tsx +2 -2
  88. package/src/components/pane-settings-dialog/tui.tsx +2 -2
  89. package/src/components/pane-settings-dialog/value.ts +6 -0
  90. package/src/components/pane-settings-dialog.tsx +3 -3
  91. package/src/components/reader/detail-reader.tsx +4 -0
  92. package/src/components/ui/button.tsx +2 -0
  93. package/src/components/ui/choice-dialog.tsx +1 -0
  94. package/src/components/ui/data-table/index.tsx +4 -3
  95. package/src/components/ui/index.ts +1 -1
  96. package/src/components/ui/list-view.tsx +7 -12
  97. package/src/components/ui/loading.tsx +10 -3
  98. package/src/components/ui/menu.tsx +6 -2
  99. package/src/components/ui/page-stack-view.tsx +3 -0
  100. package/src/components/ui/pane-link-chip.tsx +269 -54
  101. package/src/components/ui/query-bar.tsx +2 -1
  102. package/src/components/ui/quote.ts +14 -1
  103. package/src/components/ui/tabs.tsx +97 -19
  104. package/src/core/state/app/layout-reducer.ts +7 -0
  105. package/src/core/state/app/layout.ts +44 -7
  106. package/src/core/state/app/state.ts +1 -1
  107. package/src/core/state/app/types.ts +22 -2
  108. package/src/data/config/layout.ts +5 -2
  109. package/src/docs/snapshot.json +54 -13
  110. package/src/i18n/es.ts +9 -8
  111. package/src/i18n/ja.ts +9 -8
  112. package/src/i18n/ko.ts +9 -8
  113. package/src/i18n/zh-cn.ts +9 -8
  114. package/src/i18n/zh-tw.ts +9 -8
  115. package/src/layout/pane-manager/floating-actions.ts +17 -0
  116. package/src/layout/pane-manager/floating-stack.ts +187 -0
  117. package/src/layout/pane-manager/floating.ts +4 -2
  118. package/src/layout/pane-manager/gridlock.ts +5 -1
  119. package/src/layout/pane-manager/index.ts +11 -0
  120. package/src/layout/pane-manager/layout-state.ts +10 -3
  121. package/src/market-data/depositary-pair.ts +5 -3
  122. package/src/market-data/futures-board.ts +46 -1
  123. package/src/market-data/futures-contract.ts +12 -3
  124. package/src/market-data/fx-interventions.ts +270 -0
  125. package/src/market-data/market/dated-previous-close.ts +94 -15
  126. package/src/market-data/market/status.ts +17 -1
  127. package/src/news/news-model.ts +44 -2
  128. package/src/plugins/builtin/alerts/cli.ts +4 -4
  129. package/src/plugins/builtin/alerts/format.ts +1 -2
  130. package/src/plugins/builtin/alerts/headless.ts +1 -2
  131. package/src/plugins/builtin/alerts/move-checks.ts +12 -6
  132. package/src/plugins/builtin/alerts/move.ts +30 -9
  133. package/src/plugins/builtin/alerts/pane.tsx +0 -2
  134. package/src/plugins/builtin/alerts/storage.ts +4 -2
  135. package/src/plugins/builtin/alerts/types.ts +12 -0
  136. package/src/plugins/builtin/analytics/risk-client.ts +10 -4
  137. package/src/plugins/builtin/analytics/risk-episodes.ts +5 -4
  138. package/src/plugins/builtin/analytics/risk-headless.ts +4 -2
  139. package/src/plugins/builtin/analytics/risk-sectors.ts +91 -0
  140. package/src/plugins/builtin/awards/index.tsx +1 -1
  141. package/src/plugins/builtin/buildout/index.tsx +1 -0
  142. package/src/plugins/builtin/catalysts/index.tsx +2 -2
  143. package/src/plugins/builtin/cds/headless.ts +4 -0
  144. package/src/plugins/builtin/changelog/index.tsx +292 -101
  145. package/src/plugins/builtin/changelog/versions.ts +293 -0
  146. package/src/plugins/builtin/chart-composer/headless.ts +2 -1
  147. package/src/plugins/builtin/chart-composer/index.tsx +1 -0
  148. package/src/plugins/builtin/chart-composer/intervention-events.ts +105 -0
  149. package/src/plugins/builtin/chart-composer/pane.tsx +21 -7
  150. package/src/plugins/builtin/chat/content/composer.tsx +5 -4
  151. package/src/plugins/builtin/chat/content/index.tsx +12 -2
  152. package/src/plugins/builtin/chat/content/layout-metrics.ts +3 -3
  153. package/src/plugins/builtin/chat/content/open-targets.ts +3 -3
  154. package/src/plugins/builtin/chat/layout.ts +5 -2
  155. package/src/plugins/builtin/chat/message/pane-chip.tsx +61 -40
  156. package/src/plugins/builtin/chat/message/render-state.ts +2 -5
  157. package/src/plugins/builtin/chat/message/terminal.tsx +13 -15
  158. package/src/plugins/builtin/chat/pane-links/previews.ts +51 -5
  159. package/src/plugins/builtin/chat/pane-links/share-card.ts +36 -0
  160. package/src/plugins/builtin/cloud/askg/attached-pane.tsx +10 -5
  161. package/src/plugins/builtin/cloud/askg/controller.ts +141 -5
  162. package/src/plugins/builtin/cloud/askg/executor.ts +113 -4
  163. package/src/plugins/builtin/cloud/askg/manifest.ts +28 -13
  164. package/src/plugins/builtin/cloud/askg/model.ts +14 -4
  165. package/src/plugins/builtin/cloud/askg/pane.tsx +70 -46
  166. package/src/plugins/builtin/cloud/askg/tool-display.ts +1 -0
  167. package/src/plugins/builtin/cloud/askg/turn-parts.tsx +70 -0
  168. package/src/plugins/builtin/cloud/terminal-relay/engine.ts +50 -130
  169. package/src/plugins/builtin/cloud/terminal-relay/policy.ts +327 -7
  170. package/src/plugins/builtin/cloud/terminal-relay/prompts.tsx +2 -1
  171. package/src/plugins/builtin/cloud/terminal-relay/redact.ts +52 -9
  172. package/src/plugins/builtin/commodities-energy/index.tsx +1 -3
  173. package/src/plugins/builtin/commodities-energy/view-state.ts +3 -0
  174. package/src/plugins/builtin/commodity-balances/index.tsx +1 -0
  175. package/src/plugins/builtin/company-attention/index.tsx +1 -1
  176. package/src/plugins/builtin/company-kpis/headless.ts +3 -1
  177. package/src/plugins/builtin/company-kpis/index.tsx +2 -2
  178. package/src/plugins/builtin/cot/headless.ts +14 -2
  179. package/src/plugins/builtin/cot/index.tsx +1 -1
  180. package/src/plugins/builtin/cpi/index.tsx +1 -1
  181. package/src/plugins/builtin/crypto-board/index.tsx +1 -0
  182. package/src/plugins/builtin/dividend-yield/index.tsx +1 -0
  183. package/src/plugins/builtin/doe/index.tsx +1 -1
  184. package/src/plugins/builtin/earnings/index.tsx +2 -2
  185. package/src/plugins/builtin/earnings-calls/headless.ts +5 -1
  186. package/src/plugins/builtin/earnings-calls/index.tsx +1 -0
  187. package/src/plugins/builtin/econ/calendar-model.ts +74 -1
  188. package/src/plugins/builtin/econ/fred-catalog.ts +3 -1
  189. package/src/plugins/builtin/econ/index.tsx +1 -0
  190. package/src/plugins/builtin/econ-statistics/index.tsx +1 -0
  191. package/src/plugins/builtin/econ-statistics/pane.tsx +6 -0
  192. package/src/plugins/builtin/estimate-revisions/index.tsx +1 -0
  193. package/src/plugins/builtin/executives/index.tsx +1 -0
  194. package/src/plugins/builtin/filing-events/index.tsx +1 -0
  195. package/src/plugins/builtin/fixed-income/index.tsx +1 -0
  196. package/src/plugins/builtin/futures/index.tsx +25 -4
  197. package/src/plugins/builtin/futures/model.ts +28 -32
  198. package/src/plugins/builtin/futures/series.ts +4 -3
  199. package/src/plugins/builtin/futures/table.tsx +16 -9
  200. package/src/plugins/builtin/futures/use-board-terms.ts +3 -3
  201. package/src/plugins/builtin/futures-curve/headless.ts +3 -3
  202. package/src/plugins/builtin/futures-curve/index.tsx +1 -1
  203. package/src/plugins/builtin/futures-curve/model.ts +18 -0
  204. package/src/plugins/builtin/gpu/index.tsx +1 -1
  205. package/src/plugins/builtin/help/functions-table.tsx +1 -1
  206. package/src/plugins/builtin/help/index.tsx +14 -4
  207. package/src/plugins/builtin/help/keybindings-editor.tsx +19 -5
  208. package/src/plugins/builtin/holders/index.tsx +1 -0
  209. package/src/plugins/builtin/holders/report-header.ts +2 -2
  210. package/src/plugins/builtin/insider/index.tsx +1 -0
  211. package/src/plugins/builtin/iv-history/index.tsx +1 -1
  212. package/src/plugins/builtin/jobs/index.tsx +1 -0
  213. package/src/plugins/builtin/layout-manager/index.tsx +8 -8
  214. package/src/plugins/builtin/macro-day/headless.ts +27 -8
  215. package/src/plugins/builtin/macro-day/index.tsx +1 -1
  216. package/src/plugins/builtin/macro-day/model.ts +19 -3
  217. package/src/plugins/builtin/macro-day/pane.tsx +14 -9
  218. package/src/plugins/builtin/macro-day/releases.ts +25 -7
  219. package/src/plugins/builtin/market-valuation/index.tsx +1 -0
  220. package/src/plugins/builtin/market-valuation/pane.tsx +8 -0
  221. package/src/plugins/builtin/members/index.tsx +1 -1
  222. package/src/plugins/builtin/mna/index.tsx +1 -0
  223. package/src/plugins/builtin/news/headless.ts +2 -2
  224. package/src/plugins/builtin/news/index.tsx +4 -3
  225. package/src/plugins/builtin/news/wire/index.tsx +5 -1
  226. package/src/plugins/builtin/news/wire/news/detail-view.tsx +4 -0
  227. package/src/plugins/builtin/news/wire/news/list-search.ts +5 -2
  228. package/src/plugins/builtin/options/index.tsx +1 -0
  229. package/src/plugins/builtin/options-positioning/index.tsx +1 -0
  230. package/src/plugins/builtin/pe-band/index.tsx +1 -1
  231. package/src/plugins/builtin/perps/markets-section.tsx +5 -2
  232. package/src/plugins/builtin/plugin-marketplace/pane.tsx +11 -11
  233. package/src/plugins/builtin/portfolio-list/cli/portfolio-command.ts +25 -0
  234. package/src/plugins/builtin/portfolio-list/headless.ts +15 -6
  235. package/src/plugins/builtin/portfolio-list/summary/index.tsx +3 -1
  236. package/src/plugins/builtin/power/index.tsx +1 -1
  237. package/src/plugins/builtin/realized-vol/index.tsx +1 -1
  238. package/src/plugins/builtin/research/event-model.ts +9 -1
  239. package/src/plugins/builtin/research/event-sources.ts +22 -0
  240. package/src/plugins/builtin/research/headless.ts +11 -5
  241. package/src/plugins/builtin/research/index.tsx +4 -0
  242. package/src/plugins/builtin/research-search/index.tsx +1 -0
  243. package/src/plugins/builtin/research-search/pane.tsx +8 -0
  244. package/src/plugins/builtin/revenue-breakdown/index.tsx +1 -0
  245. package/src/plugins/builtin/reverse-dcf/index.tsx +1 -1
  246. package/src/plugins/builtin/risk-factors/index.tsx +1 -0
  247. package/src/plugins/builtin/scanner/headless.ts +52 -13
  248. package/src/plugins/builtin/seasonality/index.tsx +1 -1
  249. package/src/plugins/builtin/sec/index.tsx +1 -0
  250. package/src/plugins/builtin/series-inventory.ts +1 -1
  251. package/src/plugins/builtin/shared/cloud-upgrade.ts +27 -3
  252. package/src/plugins/builtin/shared/scanner-capture.ts +11 -3
  253. package/src/plugins/builtin/shared/series-list-detail.tsx +5 -0
  254. package/src/plugins/builtin/short-interest/index.tsx +1 -0
  255. package/src/plugins/builtin/social-mentions/index.tsx +1 -1
  256. package/src/plugins/builtin/supply-chain/index.tsx +1 -0
  257. package/src/plugins/builtin/thirteenf/data.ts +43 -10
  258. package/src/plugins/builtin/thirteenf/headless.ts +55 -11
  259. package/src/plugins/builtin/thirteenf/model.ts +25 -9
  260. package/src/plugins/builtin/thirteenf/report-notes.ts +27 -6
  261. package/src/plugins/builtin/thirteenf/types.ts +2 -0
  262. package/src/plugins/builtin/ticker-detail/adr-pair/model.ts +1 -1
  263. package/src/plugins/builtin/ticker-detail/financials/model.ts +12 -0
  264. package/src/plugins/builtin/ticker-detail/financials/ratio-table.tsx +3 -3
  265. package/src/plugins/builtin/ticker-detail/financials/tab.tsx +5 -5
  266. package/src/plugins/builtin/ticker-detail/headless.ts +18 -13
  267. package/src/plugins/builtin/ticker-detail/index.tsx +4 -0
  268. package/src/plugins/builtin/ticker-detail/overview/components.tsx +54 -5
  269. package/src/plugins/builtin/ticker-detail/overview/model.ts +6 -4
  270. package/src/plugins/builtin/ticker-detail/overview-tab.tsx +34 -17
  271. package/src/plugins/builtin/ticker-detail/pane.tsx +7 -2
  272. package/src/plugins/builtin/time-sales/client.ts +9 -11
  273. package/src/plugins/builtin/time-sales/index.tsx +1 -1
  274. package/src/plugins/builtin/treasury-auctions/after.ts +267 -0
  275. package/src/plugins/builtin/treasury-auctions/cache.ts +18 -3
  276. package/src/plugins/builtin/treasury-auctions/client.ts +33 -2
  277. package/src/plugins/builtin/treasury-auctions/headless.ts +109 -19
  278. package/src/plugins/builtin/treasury-auctions/index.tsx +14 -4
  279. package/src/plugins/builtin/treasury-auctions/model.ts +256 -28
  280. package/src/plugins/builtin/treasury-auctions/pane.tsx +139 -28
  281. package/src/plugins/builtin/treasury-auctions/treasury-direct.ts +5 -2
  282. package/src/plugins/builtin/treasury-auctions/types.ts +7 -1
  283. package/src/plugins/builtin/vol-surface/index.tsx +1 -1
  284. package/src/plugins/builtin/world-venue-map/index.ts +1 -0
  285. package/src/plugins/builtin/yield-curve/curves.ts +10 -4
  286. package/src/plugins/builtin/yield-curve/headless.ts +6 -2
  287. package/src/plugins/builtin/yield-curve/index.tsx +3 -3
  288. package/src/plugins/builtin/yield-curve/series.ts +10 -0
  289. package/src/plugins/builtin/yield-curve/world.ts +3 -1
  290. package/src/plugins/installer.ts +45 -0
  291. package/src/portfolio/column-values.ts +2 -1
  292. package/src/public/__snapshots__/public-api.test.ts.snap +4 -0
  293. package/src/public/remote.ts +7 -1
  294. package/src/remote/client.ts +191 -11
  295. package/src/remote/controller-utils.ts +13 -1
  296. package/src/remote/controller.ts +88 -26
  297. package/src/remote/endpoint.ts +24 -0
  298. package/src/remote/form.ts +59 -4
  299. package/src/remote/resources.ts +56 -19
  300. package/src/remote/schema.ts +22 -9
  301. package/src/remote/secrets.ts +12 -0
  302. package/src/remote/semantic-helpers.ts +29 -1
  303. package/src/remote/semantic-tree.tsx +44 -15
  304. package/src/remote/server.ts +2 -1
  305. package/src/remote/surface.tsx +192 -0
  306. package/src/remote/types.ts +5 -0
  307. package/src/renderers/cloudflare/worker.ts +16 -1
  308. package/src/renderers/dom/styles.css +40 -6
  309. package/src/renderers/opentui/host.tsx +6 -0
  310. package/src/renderers/share/layout-view.tsx +1 -1
  311. package/src/series/standalone.ts +2 -2
  312. package/src/shares/api.ts +21 -4
  313. package/src/shares/item.ts +73 -0
  314. package/src/shares/pane-item.ts +205 -0
  315. package/src/shares/pane.ts +4 -0
  316. package/src/shares/payload.ts +9 -5
  317. package/src/sources/gloomberb-cloud/news.ts +37 -12
  318. package/src/state/opening-ticker-panes.ts +47 -0
  319. package/src/test-support/cli-context.ts +2 -0
  320. package/src/test-support/preload.ts +4 -1
  321. package/src/tickers/instrument-kind.ts +23 -3
  322. package/src/tickers/renamed-listings.ts +105 -0
  323. package/src/tickers/search/index.ts +103 -16
  324. package/src/time-series/resolve.ts +2 -2
  325. package/src/types/config.ts +5 -0
  326. package/src/types/context-menu.ts +2 -0
  327. package/src/types/financials.ts +1 -0
  328. package/src/types/plugin-commands.ts +140 -0
  329. package/src/types/plugin-context.ts +125 -0
  330. package/src/types/plugin-contributions.ts +55 -0
  331. package/src/types/plugin-definition.ts +234 -0
  332. package/src/types/plugin-notifications.ts +38 -0
  333. package/src/types/plugin-pane-settings.ts +116 -0
  334. package/src/types/plugin-pane-templates.ts +160 -0
  335. package/src/types/plugin-panes.ts +243 -0
  336. package/src/types/plugin-reports.ts +35 -0
  337. package/src/types/plugin-shared.ts +14 -0
  338. package/src/types/plugin-state.ts +71 -0
  339. package/src/types/plugin.ts +14 -1169
  340. package/src/ui/index.tsx +14 -3
  341. package/src/updater/github-releases.ts +23 -0
  342. package/src/utils/central-banks.ts +86 -1
  343. package/src/utils/cli-output.ts +22 -9
  344. package/src/utils/datetime-format.ts +12 -3
  345. package/src/utils/depositary-receipt.ts +28 -3
  346. package/src/utils/fundamentals.ts +14 -0
  347. package/src/utils/max-drawdown.ts +97 -16
  348. package/src/utils/untrusted-text.ts +29 -0
@@ -1,10 +1,13 @@
1
1
  import { useCallback, useEffect, useRef } from "react";
2
2
  import {
3
3
  floatAtRect,
4
+ floatingSplitRects,
5
+ floatingStackMembers,
4
6
  getDockSplitGeometry,
7
+ getRememberedFloatingRect,
8
+ hiddenFloatingTabIds,
5
9
  MIN_FLOAT_HEIGHT,
6
10
  MIN_FLOAT_WIDTH,
7
- getRememberedFloatingRect,
8
11
  resizeSplitAtPath,
9
12
  simulateDrop,
10
13
  type DockGeometryOptions,
@@ -16,19 +19,16 @@ import {
16
19
  } from "../../../layout/pane-manager";
17
20
  import type { LayoutConfig } from "../../../types/config";
18
21
  import {
22
+ constrainFloatingRectToBounds,
19
23
  finalizePaneDragRelease,
20
- freePaneDragRect,
21
24
  isMeaningfulPaneDrag,
22
- JOIN_DWELL_MS,
23
- makeSnapGuides,
24
25
  PANE_DRAG_THRESHOLD,
25
26
  PRECISE_PANE_DRAG_THRESHOLD,
26
27
  resolveDividerPreviewRect,
27
28
  resolveFloatResizeRect,
28
29
  resolvePaneDragFloatingRect,
29
- resolvePaneDropTarget,
30
- resolveSnapGuide,
31
30
  type DragPreview,
31
+ type PaneDragMode,
32
32
  } from "./drag";
33
33
  import type { ShellDragRuntimeState, ShellMouseEvent } from "./drag/runtime";
34
34
  import type { WindowEditState } from "../window-edit/mode";
@@ -44,21 +44,8 @@ import {
44
44
  type MagnetLatch,
45
45
  type MagnetPace,
46
46
  } from "./drag/magnets";
47
- import { paneHeaderRows } from "../pane/sizing";
48
-
49
- /** A join the pointer has lined up: armed once it has held for JOIN_DWELL_MS. */
50
- interface PendingJoin {
51
- key: string;
52
- armed: boolean;
53
- timer: ReturnType<typeof setTimeout> | null;
54
- /** Where the pointer began to hold it, when that was over a title bar. */
55
- at: { x: number; y: number } | null;
56
- }
57
-
58
- function dropPendingJoin(memo: { join: PendingJoin | null }) {
59
- if (memo.join?.timer) clearTimeout(memo.join.timer);
60
- memo.join = null;
61
- }
47
+ import { applySharedEdges, NO_SHARED_EDGES, resolveSharedEdges, type SharedEdgeGroups } from "./drag/shared-edges";
48
+ import { resolveDropZone, type DropZoneHost, type DropZoneMetrics, type DropZoneState } from "./drag/drop-zones";
62
49
 
63
50
  /** A resize without edges is the bottom-right corner's (the terminal's only one). */
64
51
  const CORNER_EDGES = { x: 1, y: 1 } as const;
@@ -73,11 +60,12 @@ interface UseShellActiveDragOptions {
73
60
  focusPane: (paneId: string) => void;
74
61
  /** How close a moving or resizing pane's edge comes to another before it sticks, in cells. */
75
62
  magnetDistances: MagnetDistances;
63
+ /** The size of the drop targets a moving pane is offered, in cells. */
64
+ dropZoneMetrics: DropZoneMetrics;
76
65
  nativePaneChrome: boolean;
77
66
  paneMap: Map<string, ResolvedPane>;
78
67
  persistLayout: (nextLayout: LayoutConfig, options?: { pushHistory?: boolean }) => void;
79
68
  precisePointer: boolean | undefined;
80
- snapGuides: ReturnType<typeof makeSnapGuides>;
81
69
  updateWindowModePreviewLayout: (nextLayout: LayoutConfig, paneId?: string) => void;
82
70
  visibleLayout: LayoutConfig;
83
71
  width: number;
@@ -93,11 +81,11 @@ export function useShellActiveDrag({
93
81
  dragRuntime,
94
82
  focusPane,
95
83
  magnetDistances,
84
+ dropZoneMetrics,
96
85
  nativePaneChrome,
97
86
  paneMap,
98
87
  persistLayout,
99
88
  precisePointer,
100
- snapGuides,
101
89
  updateWindowModePreviewLayout,
102
90
  visibleLayout,
103
91
  width,
@@ -111,31 +99,33 @@ export function useShellActiveDrag({
111
99
  updateDividerPreview,
112
100
  updateDockPreview,
113
101
  updateDragFloatingRect,
102
+ updateDragPartners,
103
+ updateDropZone,
114
104
  } = dragRuntime;
115
- // What one drag keeps between moves: a docked pane's floating size, the
116
- // last drop it simulated, so a move over the same target computes nothing,
117
- // the edges its magnets hold, with the other panes' rects they hold to, the
118
- // join it is holding still for, and on the desktop where the pointer has
119
- // been lately (the magnets wait for it to slow down) with the check that
120
- // catches once it rests, and where the pane is drawn against where the
121
- // pointer puts it, with the frame that moves it there while the pointer is
122
- // still.
105
+ // What one drag keeps between moves: a layout pane's floating size, the
106
+ // panes it can land on and the last target it laid out, so a move over the
107
+ // same target computes nothing, the edges its magnets hold, with the other
108
+ // panes' rects they hold to, a resize's windows snapped edge to edge with
109
+ // it, and on the desktop where the pointer has been lately (the magnets wait
110
+ // for it to slow down) with the check that catches once it rests, and where
111
+ // the pane is drawn against where the pointer puts it, with the frame that
112
+ // moves it there while the pointer is still.
123
113
  const memoRef = useRef<{
124
114
  drag: unknown;
125
115
  baseRect: FloatingRect | null;
116
+ hosts: DropZoneHost[] | null;
126
117
  dropKey: string | null;
127
118
  drop: DragPreview | null;
128
119
  latch: MagnetLatch;
129
120
  magnetTargets: LayoutBounds[] | null;
130
- join: PendingJoin | null;
121
+ shared: SharedEdgeGroups | null;
131
122
  pace: MagnetPace;
132
123
  glide: MagnetGlide;
133
124
  }>({
134
- drag: null, baseRect: null, dropKey: null, drop: null, latch: NO_LATCH, magnetTargets: null, join: null,
135
- pace: createMagnetPace(), glide: createMagnetGlide(),
125
+ drag: null, baseRect: null, hosts: null, dropKey: null, drop: null, latch: NO_LATCH, magnetTargets: null,
126
+ shared: null, pace: createMagnetPace(), glide: createMagnetGlide(),
136
127
  });
137
128
  useEffect(() => () => {
138
- dropPendingJoin(memoRef.current);
139
129
  memoRef.current.pace.reset();
140
130
  memoRef.current.glide.reset();
141
131
  }, []);
@@ -164,24 +154,54 @@ export function useShellActiveDrag({
164
154
  memo.drop = null;
165
155
  memo.latch = NO_LATCH;
166
156
  memo.magnetTargets = null;
157
+ memo.shared = null;
158
+ memo.hosts = null;
167
159
  memo.pace.reset();
168
160
  memo.glide.reset();
169
- dropPendingJoin(memo);
170
161
  }
171
162
  // Any later event supersedes the rest check of an earlier move.
172
163
  memo.pace.cancel();
173
164
  // Every other pane on screen, docked or floating, whose edges a floating
174
165
  // pane's edges stick to. Alt (Option) lets it go anywhere.
166
+ // A resize leaves out the windows it moves along a shared edge. A stack
167
+ // counts once, as the tab it shows, and the pane's own stack not at all:
168
+ // its tabs sit where it started, and would hold it there.
175
169
  const magnetTargets = (paneId: string) => {
176
- memo.magnetTargets ??= [
170
+ if (memo.magnetTargets) return memo.magnetTargets;
171
+ const moving = memo.shared?.ids;
172
+ const hidden = hiddenFloatingTabIds(baseLayout.floating);
173
+ const own = baseLayout.floating.find((entry) => entry.instanceId === paneId)?.stack;
174
+ memo.magnetTargets = [
177
175
  ...dockLeafLayouts.filter((leaf) => leaf.instanceId !== paneId).map((leaf) => leaf.rect),
178
176
  ...baseLayout.floating
179
- .filter((entry) => entry.instanceId !== paneId && paneMap.has(entry.instanceId))
177
+ .filter((entry) => entry.instanceId !== paneId && paneMap.has(entry.instanceId) && !moving?.has(entry.instanceId))
178
+ .filter((entry) => !hidden.has(entry.instanceId) && (!own || entry.stack !== own))
180
179
  .map(({ x, y, width: w, height: h }) => ({ x, y, width: w, height: h })),
181
180
  ];
182
181
  return memo.magnetTargets;
183
182
  };
183
+ // The windows on screen a resize can share an edge with: each stack once, as the tab it shows.
184
+ const sharedEdgesOf = (paneId: string, origRect: FloatingRect, edges: { x: -1 | 0 | 1; y: -1 | 0 | 1 }) => {
185
+ if (memo.shared) return memo.shared;
186
+ const hidden = hiddenFloatingTabIds(baseLayout.floating);
187
+ const own = baseLayout.floating.find((entry) => entry.instanceId === paneId)?.stack;
188
+ const windows = baseLayout.floating
189
+ .filter((entry) => paneMap.has(entry.instanceId) && !hidden.has(entry.instanceId) && (!own || entry.stack !== own))
190
+ .map((entry) => ({ id: entry.instanceId, rect: { x: entry.x, y: entry.y, width: entry.width, height: entry.height, zIndex: entry.zIndex } }));
191
+ memo.shared = resolveSharedEdges(windows, { id: paneId, rect: origRect }, edges);
192
+ return memo.shared;
193
+ };
184
194
  const magnetsOff = event.modifiers?.alt === true;
195
+ // A resize as the pointer has it: the window, and those it moves along a
196
+ // shared edge. Alt (Option) resizes the window alone.
197
+ const resizeWithShared = (paneId: string, origRect: FloatingRect, resized: FloatingRect, edges: { x: -1 | 0 | 1; y: -1 | 0 | 1 }) => {
198
+ const shared = sharedEdgesOf(paneId, origRect, edges);
199
+ if (shared === NO_SHARED_EDGES || magnetsOff) return { rect: resized, partners: null };
200
+ const rects = applySharedEdges(shared, paneId, resized, { width, height: contentHeight });
201
+ const rect = { ...(rects.get(paneId) ?? resized), zIndex: resized.zIndex };
202
+ rects.delete(paneId);
203
+ return { rect, partners: rects };
204
+ };
185
205
  const magnetArea = { x: 0, y: 0, width, height: contentHeight };
186
206
  // Desktop: past the travel speed a release lands the pane where the
187
207
  // pointer puts it, its magnets left out (the rest check runs the last move
@@ -251,16 +271,68 @@ export function useShellActiveDrag({
251
271
  const delta = drag.axis === "horizontal" ? x - drag.startX : y - drag.startY;
252
272
  return Math.max(0.1, Math.min(0.9, drag.startRatio + (delta / Math.max(1, total))));
253
273
  };
274
+ // The panes a moving pane can land on, front to back, each once: floating
275
+ // windows (a stack as the tab it shows), then the spots of the layout.
276
+ // Its own window or spot is no target, but the other tabs of its stack are.
277
+ const dropHostsOf = (paneId: string, mode: PaneDragMode): DropZoneHost[] => {
278
+ if (memo.hosts) return memo.hosts;
279
+ const hidden = hiddenFloatingTabIds(baseLayout.floating);
280
+ const ownStack = baseLayout.floating.find((entry) => entry.instanceId === paneId)?.stack;
281
+ const floatingHosts = baseLayout.floating
282
+ .filter((entry) => paneMap.has(entry.instanceId) && !hidden.has(entry.instanceId))
283
+ .filter((entry) => (mode === "floating" ? entry.instanceId !== paneId && (!ownStack || entry.stack !== ownStack) : true))
284
+ .sort((a, b) => (b.zIndex ?? 50) - (a.zIndex ?? 50))
285
+ .flatMap((entry): DropZoneHost[] => {
286
+ const rect = constrainFloatingRectToBounds(entry, width, contentHeight);
287
+ if (entry.instanceId !== paneId) return [{ id: entry.instanceId, rect, docked: false }];
288
+ // A tab dragged out of the stack it shows: the stack is still there, as its other tabs.
289
+ const other = floatingStackMembers(baseLayout.floating, paneId).find((member) => member.instanceId !== paneId);
290
+ return other ? [{ id: other.instanceId, rect, docked: false }] : [];
291
+ });
292
+ const dockedHosts = dockLeafLayouts.flatMap((leaf): DropZoneHost[] => {
293
+ const own = leaf.instanceId === paneId || (leaf.stack?.includes(paneId) ?? false);
294
+ const id = !own ? leaf.instanceId : leaf.stack?.find((member) => member !== paneId);
295
+ return id ? [{ id, rect: leaf.rect, docked: true }] : [];
296
+ });
297
+ memo.hosts = [...floatingHosts, ...dockedHosts];
298
+ return memo.hosts;
299
+ };
300
+ // What a release over `zone` lays out, as the preview shows it: its place
301
+ // in the layout, or the floating window's rect or half.
302
+ const previewOfZone = (paneId: string, zone: DropZoneState): DragPreview | null => {
303
+ const key = zone.edge ? `edge:${zone.edge}` : zone.host && zone.side ? `${zone.host.id}:${zone.side}` : null;
304
+ if (!key) return null;
305
+ if (memo.dropKey === key) return memo.drop;
306
+ memo.dropKey = key;
307
+ const dock = (target: DropTarget): DragPreview | null => {
308
+ const simulation = simulateDrop(baseLayout, paneId, target, bounds, dockGeometryOptions);
309
+ return simulation.previewRect ? { kind: "dock", target, rect: simulation.previewRect } : null;
310
+ };
311
+ if (zone.edge) {
312
+ memo.drop = dock({ kind: "frame", edge: zone.edge });
313
+ } else if (zone.host && zone.side) {
314
+ const { host, side } = zone;
315
+ if (host.docked) {
316
+ memo.drop = dock(side === "center" ? { kind: "tab", targetId: host.id } : { kind: "leaf", targetId: host.id, position: side });
317
+ } else if (side === "center") {
318
+ memo.drop = { kind: "float", drop: { type: "tab", targetId: host.id }, rect: host.rect };
319
+ } else {
320
+ memo.drop = { kind: "float", drop: { type: "split", targetId: host.id, side }, rect: floatingSplitRects(host.rect, side)[0] };
321
+ }
322
+ }
323
+ return memo.drop;
324
+ };
254
325
  const dragBaseRect = () => {
255
326
  if (drag.type !== "pane-drag") return null;
256
327
  if (drag.mode === "floating") return drag.origRect;
328
+ // A tab pulled out of a floating stack keeps the stack's size.
329
+ if (drag.mode === "tab") return drag.origRect;
257
330
  memo.baseRect ??= getRememberedFloatingRect(baseLayout, drag.paneId, width, contentHeight, paneMap.get(drag.paneId)?.def);
258
331
  return memo.baseRect;
259
332
  };
260
333
 
261
334
  if (event.type === "drag-cancel") {
262
335
  // The window lost focus or the system took the pointer: put everything back.
263
- dropPendingJoin(memo);
264
336
  memo.glide.reset();
265
337
  cancelActiveDrag();
266
338
  event.stopPropagation();
@@ -291,6 +363,7 @@ export function useShellActiveDrag({
291
363
  if (!isMeaningfulPaneDrag(drag.startX, drag.startY, preciseX, preciseShellY, dragThreshold)) {
292
364
  memo.glide.reset();
293
365
  updateDockPreview(null);
366
+ updateDropZone(null);
294
367
  if (drag.mode === "floating") {
295
368
  updateDragFloatingRect({ paneId: drag.paneId, rect: drag.origRect });
296
369
  }
@@ -300,72 +373,31 @@ export function useShellActiveDrag({
300
373
  }
301
374
 
302
375
  const freeRect = resolvePaneDragFloatingRect(drag, dragBaseRect()!, drawX, drawShellY, width, contentHeight);
303
- const moved = snapMove(drag.paneId, freeRect);
304
- const nextRect = moved.rect;
305
- drawMove(drag.paneId, freeRect, moved);
376
+ drawMove(drag.paneId, freeRect, snapMove(drag.paneId, freeRect));
306
377
 
307
- // Over a title bar it would be a tab there; pushed against a docked
308
- // pane's edge it would join the dock on that side once that has held,
309
- // over the title bar too.
310
- const { tab, join } = resolvePaneDropTarget({
378
+ // The targets in sight decide, and nothing else: over a pane, the
379
+ // square of its target under the pointer; along the window's edge,
380
+ // its strip; anywhere else the pane floats where it is drawn.
381
+ const zone = resolveDropZone({
311
382
  x: hitX,
312
383
  y: hitShellY,
313
- rect: nextRect,
314
- free: freePaneDragRect(drag, dragBaseRect()!, drawX, drawShellY, width, contentHeight),
315
- leaves: dockLeafLayouts,
316
- paneId: drag.paneId,
384
+ hosts: dropHostsOf(drag.paneId, drag.mode),
317
385
  area: bounds,
318
- flush: { x: magnetDistances.catchX, y: magnetDistances.catchY },
319
- headerRows: paneHeaderRows(nativePaneChrome),
320
- join: !magnetsOff,
386
+ metrics: dropZoneMetrics,
321
387
  });
322
- const showSnapGuide = () => {
323
- const snapGuide = resolveSnapGuide(hitX, hitShellY, snapGuides);
324
- updateDockPreview(snapGuide ? { kind: "snap", position: snapGuide.position, rect: snapGuide.previewRect } : null);
325
- };
326
- const showDrop = (target: DropTarget) => {
327
- const dropKey = target.kind === "tab" ? `tab:${target.targetId}` : target.kind === "leaf" ? `${target.targetId}:${target.position}` : target.edge;
328
- if (memo.dropKey !== dropKey) {
329
- const simulation = simulateDrop(baseLayout, drag.paneId, target, bounds, dockGeometryOptions);
330
- memo.dropKey = dropKey;
331
- memo.drop = simulation.previewRect ? { kind: "dock", target, rect: simulation.previewRect } : null;
332
- }
333
- updateDockPreview(memo.drop);
334
- };
335
- // Before a join arms, a release on a title bar makes a tab there and
336
- // anywhere else leaves the pane where it is drawn.
337
- const showUnarmed = () => (tab ? showDrop(tab) : showSnapGuide());
338
- if (join) {
339
- // A join arms once the edge has held, and shows its preview then.
340
- // Over a title bar the pane must hold still there too: one moved
341
- // along the bar, on its way to a drop there, stays a tab.
342
- const joinKey = `${join.targetId}:${join.position}`;
343
- const since = memo.join?.key === joinKey ? memo.join.at : null;
344
- const movedOn = !!tab && !!since && (
345
- Math.abs(hitX - since.x) > magnetDistances.catchX || Math.abs(hitShellY - since.y) > magnetDistances.catchY
346
- );
347
- if (memo.join?.key !== joinKey || movedOn) {
348
- dropPendingJoin(memo);
349
- const pending: PendingJoin = { key: joinKey, armed: false, timer: null, at: tab ? { x: hitX, y: hitShellY } : null };
350
- pending.timer = setTimeout(() => {
351
- if (memo.join !== pending || dragRef.current !== drag) return;
352
- pending.armed = true;
353
- pending.timer = null;
354
- showDrop(join);
355
- }, JOIN_DWELL_MS);
356
- memo.join = pending;
357
- }
358
- if (memo.join?.armed) showDrop(join);
359
- else showUnarmed();
360
- } else {
361
- dropPendingJoin(memo);
362
- showUnarmed();
363
- }
388
+ updateDropZone(zone);
389
+ updateDockPreview(previewOfZone(drag.paneId, zone));
364
390
  } else if (drag.type === "float-resize") {
365
- updateDragFloatingRect({
366
- paneId: drag.paneId,
367
- rect: snapResize(drag.paneId, resolveFloatResizeRect(drag, preciseX, preciseShellY, width, contentHeight), drag.edges ?? CORNER_EDGES),
368
- });
391
+ const edges = drag.edges ?? CORNER_EDGES;
392
+ sharedEdgesOf(drag.paneId, drag.origRect, edges);
393
+ const resized = resizeWithShared(
394
+ drag.paneId,
395
+ drag.origRect,
396
+ snapResize(drag.paneId, resolveFloatResizeRect(drag, preciseX, preciseShellY, width, contentHeight), edges),
397
+ edges,
398
+ );
399
+ updateDragFloatingRect({ paneId: drag.paneId, rect: resized.rect });
400
+ updateDragPartners(resized.partners);
369
401
  }
370
402
  event.stopPropagation();
371
403
  event.preventDefault();
@@ -373,7 +405,6 @@ export function useShellActiveDrag({
373
405
  }
374
406
 
375
407
  if (event.type === "up" || event.type === "drag-end") {
376
- dropPendingJoin(memo);
377
408
  memo.glide.reset();
378
409
  if (drag.type === "divider") {
379
410
  if (live.get().divider) {
@@ -389,12 +420,13 @@ export function useShellActiveDrag({
389
420
  const movedEnough = isMeaningfulPaneDrag(drag.startX, drag.startY, preciseX, preciseShellY, dragThreshold);
390
421
  if (!movedEnough) {
391
422
  updateDockPreview(null);
423
+ updateDropZone(null);
392
424
  updateDragFloatingRect(null);
393
425
  // A click on a stack's tab shows that pane.
394
- if (drag.mode === "docked") focusPane(drag.paneId);
426
+ if (drag.mode !== "floating") focusPane(drag.paneId);
395
427
  } else {
396
428
  const releaseRect = snapMove(drag.paneId, resolvePaneDragFloatingRect(drag, dragBaseRect()!, preciseX, preciseShellY, width, contentHeight)).rect;
397
- const nextLayout = finalizePaneDragRelease(baseLayout, drag.paneId, releaseRect, live.get().dockPreview);
429
+ const nextLayout = finalizePaneDragRelease(baseLayout, drag.paneId, releaseRect, live.get().dockPreview, drag.mode);
398
430
  if (windowMode) {
399
431
  updateWindowModePreviewLayout(nextLayout, drag.paneId);
400
432
  } else {
@@ -402,17 +434,27 @@ export function useShellActiveDrag({
402
434
  }
403
435
  focusPane(drag.paneId);
404
436
  updateDockPreview(null);
437
+ updateDropZone(null);
405
438
  updateDragFloatingRect(null);
406
439
  }
407
440
  } else if (drag.type === "float-resize") {
408
- const releaseRect = snapResize(drag.paneId, resolveFloatResizeRect(drag, preciseX, preciseShellY, width, contentHeight), drag.edges ?? CORNER_EDGES);
409
- const nextLayout = floatAtRect(baseLayout, drag.paneId, releaseRect);
441
+ const edges = drag.edges ?? CORNER_EDGES;
442
+ sharedEdgesOf(drag.paneId, drag.origRect, edges);
443
+ const released = resizeWithShared(
444
+ drag.paneId,
445
+ drag.origRect,
446
+ snapResize(drag.paneId, resolveFloatResizeRect(drag, preciseX, preciseShellY, width, contentHeight), edges),
447
+ edges,
448
+ );
449
+ let nextLayout = floatAtRect(baseLayout, drag.paneId, released.rect);
450
+ for (const [partnerId, rect] of released.partners ?? []) nextLayout = floatAtRect(nextLayout, partnerId, rect);
410
451
  if (windowMode) {
411
452
  updateWindowModePreviewLayout(nextLayout, drag.paneId);
412
453
  } else {
413
454
  persistLayout(nextLayout);
414
455
  }
415
456
  updateDragFloatingRect(null);
457
+ updateDragPartners(null);
416
458
  }
417
459
  endDrag();
418
460
  event.stopPropagation();
@@ -426,6 +468,7 @@ export function useShellActiveDrag({
426
468
  dockGeometryOptions,
427
469
  dockLeafLayouts,
428
470
  dragRef,
471
+ dropZoneMetrics,
429
472
  endDrag,
430
473
  focusPane,
431
474
  live,
@@ -434,10 +477,11 @@ export function useShellActiveDrag({
434
477
  paneMap,
435
478
  persistLayout,
436
479
  precisePointer,
437
- snapGuides,
438
480
  updateDividerPreview,
439
481
  updateDockPreview,
440
482
  updateDragFloatingRect,
483
+ updateDragPartners,
484
+ updateDropZone,
441
485
  updateWindowModePreviewLayout,
442
486
  visibleLayout,
443
487
  windowMode,
@@ -0,0 +1,162 @@
1
+ import type { LayoutBounds } from "../../../../layout/pane-manager";
2
+ import { pointInRect } from "./index";
3
+
4
+ /**
5
+ * Where a pane on the move can land, as targets in sight, the same on the
6
+ * desktop, the web and in the terminal. Over any pane, in the layout or
7
+ * floating, a small target shows on that pane: its centre stacks the moving
8
+ * pane there as a tab, its four sides split that pane on that side. Thin
9
+ * strips along the window's outer edges put it along that whole edge of the
10
+ * layout. Anywhere else it floats where it is let go. Nothing waits on time:
11
+ * the target under the pointer is what a release does.
12
+ */
13
+
14
+ export type DropZoneSide = "center" | "left" | "right" | "top" | "bottom";
15
+ export type DropStripEdge = "left" | "right" | "top" | "bottom";
16
+
17
+ /** A pane a moving pane is over: the one its target is drawn on. */
18
+ export interface DropZoneHost {
19
+ /** The pane the target acts on: a stack's shown tab, or another tab of the moving pane's own stack. */
20
+ id: string;
21
+ rect: LayoutBounds;
22
+ /** In the layout (a split or tab there); otherwise a floating window. */
23
+ docked: boolean;
24
+ }
25
+
26
+ /** What the pointer is over, and so what a release does. */
27
+ export interface DropZoneState {
28
+ host: DropZoneHost | null;
29
+ /** The square of the host's target under the pointer, if any. */
30
+ side: DropZoneSide | null;
31
+ /** The strip along the window's edge under the pointer, if any. */
32
+ edge: DropStripEdge | null;
33
+ }
34
+
35
+ /** The size of the targets, in shell cells. */
36
+ export interface DropZoneMetrics {
37
+ /** One square of a pane's target. */
38
+ square: { width: number; height: number };
39
+ /** Between two squares. */
40
+ gap: { x: number; y: number };
41
+ /** How far a strip reaches in from the window's edge. */
42
+ strip: { x: number; y: number };
43
+ /** The terminal: squares sit on whole cells. */
44
+ wholeCells: boolean;
45
+ }
46
+
47
+ /** Desktop and web, in px: a square of the target, the gap between two, a strip's depth. */
48
+ const SQUARE_PX = 36;
49
+ const GAP_PX = 6;
50
+ const STRIP_PX = 12;
51
+
52
+ /** The desktop's targets for cells of `cell` px. */
53
+ export function desktopDropZoneMetrics(cell: { width: number; height: number }): DropZoneMetrics {
54
+ return {
55
+ square: { width: SQUARE_PX / cell.width, height: SQUARE_PX / cell.height },
56
+ gap: { x: GAP_PX / cell.width, y: GAP_PX / cell.height },
57
+ strip: { x: STRIP_PX / cell.width, y: STRIP_PX / cell.height },
58
+ wholeCells: false,
59
+ };
60
+ }
61
+
62
+ /**
63
+ * The terminal's: a square is three cells by one row (a cell is about half
64
+ * as wide as it is tall), a cell apart across and touching up and down; a
65
+ * strip is the outermost cell.
66
+ */
67
+ export const TERMINAL_DROP_ZONE_METRICS: DropZoneMetrics = {
68
+ square: { width: 3, height: 1 },
69
+ gap: { x: 1, y: 0 },
70
+ strip: { x: 1, y: 1 },
71
+ wholeCells: true,
72
+ };
73
+
74
+ const SIDES: readonly DropZoneSide[] = ["center", "left", "right", "top", "bottom"];
75
+
76
+ /** Each square of the target drawn on a pane at `rect`, around its middle. */
77
+ export function dropZoneSquares(rect: LayoutBounds, metrics: DropZoneMetrics): Record<DropZoneSide, LayoutBounds> {
78
+ const { width, height } = metrics.square;
79
+ const stepX = width + metrics.gap.x;
80
+ const stepY = height + metrics.gap.y;
81
+ const place = (value: number) => (metrics.wholeCells ? Math.floor(value) : value);
82
+ const cx = place(rect.x + (rect.width - width) / 2);
83
+ const cy = place(rect.y + (rect.height - height) / 2);
84
+ const at = (dx: number, dy: number) => ({ x: cx + dx * stepX, y: cy + dy * stepY, width, height });
85
+ return {
86
+ center: at(0, 0),
87
+ left: at(-1, 0),
88
+ right: at(1, 0),
89
+ top: at(0, -1),
90
+ bottom: at(0, 1),
91
+ };
92
+ }
93
+
94
+ /** The strip along each edge of `area`. */
95
+ export function dropStrips(area: LayoutBounds, metrics: DropZoneMetrics): Record<DropStripEdge, LayoutBounds> {
96
+ const { x: across, y: down } = metrics.strip;
97
+ return {
98
+ left: { x: area.x, y: area.y, width: across, height: area.height },
99
+ right: { x: area.x + area.width - across, y: area.y, width: across, height: area.height },
100
+ top: { x: area.x, y: area.y, width: area.width, height: down },
101
+ bottom: { x: area.x, y: area.y + area.height - down, width: area.width, height: down },
102
+ };
103
+ }
104
+
105
+ const NO_DROP_ZONE: DropZoneState = { host: null, side: null, edge: null };
106
+
107
+ /**
108
+ * What the pointer at (`x`, `y`), in shell cells, is over. A strip first: the
109
+ * pointer past the window's edge (over the header or the status bar) is in
110
+ * its strip, and in a corner the nearer edge wins. Then the first of `hosts`
111
+ * (front to back) under the pointer, and the square of its target there.
112
+ */
113
+ export function resolveDropZone({
114
+ x,
115
+ y,
116
+ hosts,
117
+ area,
118
+ metrics,
119
+ }: {
120
+ x: number;
121
+ y: number;
122
+ hosts: readonly DropZoneHost[];
123
+ area: LayoutBounds;
124
+ metrics: DropZoneMetrics;
125
+ }): DropZoneState {
126
+ // How far into each strip the pointer is, in strip depths: under 1 is in it.
127
+ const { strip } = metrics;
128
+ const depths: Array<[DropStripEdge, number]> = [
129
+ ["left", (x - area.x) / strip.x],
130
+ ["right", (area.x + area.width - x) / strip.x],
131
+ ["top", (y - area.y) / strip.y],
132
+ ["bottom", (area.y + area.height - y) / strip.y],
133
+ ];
134
+ let edge: DropStripEdge | null = null;
135
+ let nearest = 1;
136
+ for (const [candidate, depth] of depths) {
137
+ // The terminal's pointer is a cell: its far side is a cell on.
138
+ const reach = metrics.wholeCells && (candidate === "right" || candidate === "bottom") ? depth - 1 : depth;
139
+ if (reach < nearest) {
140
+ edge = candidate;
141
+ nearest = reach;
142
+ }
143
+ }
144
+ if (edge) return { host: null, side: null, edge };
145
+ const host = hosts.find((candidate) => pointInRect(candidate.rect, x, y)) ?? null;
146
+ if (!host) return NO_DROP_ZONE;
147
+ const squares = dropZoneSquares(host.rect, metrics);
148
+ const side = SIDES.find((candidate) => pointInRect(squares[candidate], x, y)) ?? null;
149
+ return { host, side, edge: null };
150
+ }
151
+
152
+ function sameBounds(a: LayoutBounds, b: LayoutBounds): boolean {
153
+ return a.x === b.x && a.y === b.y && a.width === b.width && a.height === b.height;
154
+ }
155
+
156
+ export function sameDropZone(a: DropZoneState | null, b: DropZoneState | null): boolean {
157
+ if (a === b) return true;
158
+ if (!a || !b) return false;
159
+ if (a.side !== b.side || a.edge !== b.edge) return false;
160
+ if (!a.host || !b.host) return a.host === b.host;
161
+ return a.host.id === b.host.id && a.host.docked === b.host.docked && sameBounds(a.host.rect, b.host.rect);
162
+ }