gloomberb 0.20.3 → 0.20.4

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (154) hide show
  1. package/package.json +1 -1
  2. package/src/account/auth-dialog.tsx +17 -0
  3. package/src/api-client/data.ts +6 -0
  4. package/src/api-client/fx-interventions.ts +64 -0
  5. package/src/api-client/index.ts +1 -0
  6. package/src/api-client/release-summaries.ts +21 -0
  7. package/src/app/keybindings/actions.ts +2 -2
  8. package/src/app/pane-runtime/ticker-open-runtime.ts +245 -66
  9. package/src/cli/commands/market.ts +77 -1
  10. package/src/cli/commands/news-search.ts +1 -3
  11. package/src/cli/commands/plugins.ts +27 -5
  12. package/src/cli/commands/system.ts +19 -3
  13. package/src/cli/commands/ticker.ts +60 -19
  14. package/src/cli/index.ts +8 -8
  15. package/src/cli/pane-functions/function-help.ts +3 -3
  16. package/src/cli/report-tables.ts +18 -6
  17. package/src/cli/result.ts +15 -7
  18. package/src/cli/types.ts +2 -0
  19. package/src/components/chart/composite/axis-overlays.tsx +22 -0
  20. package/src/components/chart/composite/composite-chart.tsx +54 -13
  21. package/src/components/chart/composite/event-captions.ts +109 -0
  22. package/src/components/chart/composite/event-guides.ts +74 -0
  23. package/src/components/chart/composite/rasterizer.ts +2 -0
  24. package/src/components/chart/composite/text-renderer.ts +2 -0
  25. package/src/components/chart/composite/types.ts +31 -0
  26. package/src/components/command-bar/layout-items/focused-pane.ts +5 -5
  27. package/src/components/command-bar/routes/root/provider-search.ts +5 -4
  28. package/src/components/command-bar/routes/ticker-search/results.ts +51 -0
  29. package/src/components/command-bar/routes/ticker-search/route.ts +3 -2
  30. package/src/components/layout/detached-pane-shell.tsx +1 -1
  31. package/src/components/layout/floating-pane.tsx +5 -1
  32. package/src/components/layout/pane/footer/index.tsx +21 -14
  33. package/src/components/layout/pane/footer/model.ts +6 -0
  34. package/src/components/layout/shell/action-menu-overlay.tsx +10 -5
  35. package/src/components/layout/shell/active-drag.ts +149 -105
  36. package/src/components/layout/shell/drag/drop-zones.ts +162 -0
  37. package/src/components/layout/shell/drag/index.ts +47 -218
  38. package/src/components/layout/shell/drag/live.ts +10 -3
  39. package/src/components/layout/shell/drag/overlays.tsx +182 -5
  40. package/src/components/layout/shell/drag/runtime.ts +29 -6
  41. package/src/components/layout/shell/drag/shared-edges.ts +156 -0
  42. package/src/components/layout/shell/index.tsx +11 -6
  43. package/src/components/layout/shell/menu.ts +11 -2
  44. package/src/components/layout/shell/native/pointer-runtime.ts +25 -0
  45. package/src/components/layout/shell/native/window-state.ts +2 -2
  46. package/src/components/layout/shell/pane/layers.tsx +71 -7
  47. package/src/components/layout/shell/terminal-pointer-runtime.ts +18 -9
  48. package/src/components/layout/shell/window-mode/index.ts +8 -10
  49. package/src/components/layout/window-edit/mode.ts +39 -7
  50. package/src/components/layout/window-edit/presentation.ts +1 -1
  51. package/src/components/onboarding/onboarding-keyboard.ts +4 -0
  52. package/src/components/onboarding/onboarding-wizard.tsx +8 -3
  53. package/src/components/ui/button.tsx +2 -0
  54. package/src/components/ui/choice-dialog.tsx +1 -0
  55. package/src/components/ui/data-table/index.tsx +4 -3
  56. package/src/components/ui/list-view.tsx +7 -12
  57. package/src/components/ui/loading.tsx +10 -3
  58. package/src/components/ui/menu.tsx +6 -2
  59. package/src/components/ui/quote.ts +14 -1
  60. package/src/data/config/layout.ts +5 -2
  61. package/src/docs/snapshot.json +29 -5
  62. package/src/i18n/es.ts +9 -8
  63. package/src/i18n/ja.ts +9 -8
  64. package/src/i18n/ko.ts +9 -8
  65. package/src/i18n/zh-cn.ts +9 -8
  66. package/src/i18n/zh-tw.ts +9 -8
  67. package/src/layout/pane-manager/floating-actions.ts +17 -0
  68. package/src/layout/pane-manager/floating-stack.ts +187 -0
  69. package/src/layout/pane-manager/floating.ts +4 -2
  70. package/src/layout/pane-manager/gridlock.ts +5 -1
  71. package/src/layout/pane-manager/index.ts +11 -0
  72. package/src/layout/pane-manager/layout-state.ts +10 -3
  73. package/src/market-data/futures-board.ts +46 -1
  74. package/src/market-data/futures-contract.ts +12 -3
  75. package/src/market-data/fx-interventions.ts +270 -0
  76. package/src/news/news-model.ts +44 -2
  77. package/src/plugins/builtin/alerts/cli.ts +4 -4
  78. package/src/plugins/builtin/alerts/format.ts +1 -2
  79. package/src/plugins/builtin/alerts/headless.ts +1 -2
  80. package/src/plugins/builtin/alerts/move-checks.ts +12 -6
  81. package/src/plugins/builtin/alerts/move.ts +30 -9
  82. package/src/plugins/builtin/alerts/pane.tsx +0 -2
  83. package/src/plugins/builtin/alerts/storage.ts +4 -2
  84. package/src/plugins/builtin/alerts/types.ts +12 -0
  85. package/src/plugins/builtin/changelog/index.tsx +292 -101
  86. package/src/plugins/builtin/changelog/versions.ts +293 -0
  87. package/src/plugins/builtin/chart-composer/intervention-events.ts +105 -0
  88. package/src/plugins/builtin/chart-composer/pane.tsx +21 -7
  89. package/src/plugins/builtin/chat/message/render-state.ts +2 -5
  90. package/src/plugins/builtin/cloud/askg/attached-pane.tsx +10 -5
  91. package/src/plugins/builtin/cloud/askg/controller.ts +141 -5
  92. package/src/plugins/builtin/cloud/askg/executor.ts +113 -4
  93. package/src/plugins/builtin/cloud/askg/manifest.ts +28 -13
  94. package/src/plugins/builtin/cloud/askg/model.ts +14 -4
  95. package/src/plugins/builtin/cloud/askg/pane.tsx +70 -46
  96. package/src/plugins/builtin/cloud/askg/turn-parts.tsx +70 -0
  97. package/src/plugins/builtin/cloud/terminal-relay/engine.ts +50 -130
  98. package/src/plugins/builtin/cloud/terminal-relay/policy.ts +327 -7
  99. package/src/plugins/builtin/cloud/terminal-relay/prompts.tsx +2 -1
  100. package/src/plugins/builtin/cloud/terminal-relay/redact.ts +47 -6
  101. package/src/plugins/builtin/commodities-energy/index.tsx +1 -3
  102. package/src/plugins/builtin/commodities-energy/view-state.ts +3 -0
  103. package/src/plugins/builtin/cot/headless.ts +14 -2
  104. package/src/plugins/builtin/earnings/index.tsx +2 -2
  105. package/src/plugins/builtin/futures/index.tsx +25 -4
  106. package/src/plugins/builtin/futures/model.ts +28 -32
  107. package/src/plugins/builtin/futures/series.ts +4 -3
  108. package/src/plugins/builtin/futures/table.tsx +16 -9
  109. package/src/plugins/builtin/futures/use-board-terms.ts +3 -3
  110. package/src/plugins/builtin/help/index.tsx +3 -3
  111. package/src/plugins/builtin/help/keybindings-editor.tsx +18 -4
  112. package/src/plugins/builtin/layout-manager/index.tsx +8 -8
  113. package/src/plugins/builtin/news/headless.ts +2 -2
  114. package/src/plugins/builtin/news/index.tsx +3 -3
  115. package/src/plugins/builtin/perps/markets-section.tsx +5 -2
  116. package/src/plugins/builtin/plugin-marketplace/pane.tsx +11 -11
  117. package/src/plugins/builtin/portfolio-list/summary/index.tsx +3 -1
  118. package/src/plugins/builtin/research/event-model.ts +9 -1
  119. package/src/plugins/builtin/research/event-sources.ts +22 -0
  120. package/src/plugins/builtin/research/headless.ts +3 -3
  121. package/src/plugins/builtin/shared/cloud-upgrade.ts +27 -3
  122. package/src/plugins/builtin/ticker-detail/overview/components.tsx +54 -5
  123. package/src/plugins/builtin/ticker-detail/overview-tab.tsx +28 -13
  124. package/src/plugins/builtin/ticker-detail/pane.tsx +7 -2
  125. package/src/plugins/installer.ts +45 -0
  126. package/src/remote/resources.ts +12 -1
  127. package/src/remote/schema.ts +1 -0
  128. package/src/remote/semantic-helpers.ts +29 -1
  129. package/src/remote/semantic-tree.tsx +32 -15
  130. package/src/renderers/cloudflare/worker.ts +16 -1
  131. package/src/renderers/dom/styles.css +40 -6
  132. package/src/renderers/share/layout-view.tsx +1 -1
  133. package/src/sources/gloomberb-cloud/news.ts +35 -12
  134. package/src/state/opening-ticker-panes.ts +47 -0
  135. package/src/test-support/cli-context.ts +2 -0
  136. package/src/test-support/preload.ts +4 -1
  137. package/src/tickers/instrument-kind.ts +23 -3
  138. package/src/types/config.ts +5 -0
  139. package/src/types/context-menu.ts +2 -0
  140. package/src/types/plugin-commands.ts +140 -0
  141. package/src/types/plugin-context.ts +125 -0
  142. package/src/types/plugin-contributions.ts +55 -0
  143. package/src/types/plugin-definition.ts +234 -0
  144. package/src/types/plugin-notifications.ts +38 -0
  145. package/src/types/plugin-pane-settings.ts +114 -0
  146. package/src/types/plugin-pane-templates.ts +160 -0
  147. package/src/types/plugin-panes.ts +221 -0
  148. package/src/types/plugin-reports.ts +35 -0
  149. package/src/types/plugin-shared.ts +14 -0
  150. package/src/types/plugin-state.ts +71 -0
  151. package/src/types/plugin.ts +14 -1169
  152. package/src/ui/index.tsx +14 -3
  153. package/src/updater/github-releases.ts +23 -0
  154. package/src/utils/cli-output.ts +22 -9
@@ -1,21 +1,38 @@
1
1
  import { useRef, type CSSProperties, type RefObject } from "react";
2
- import { Box, useUiCapabilities, type BoxRenderable, type LiveBoxFrame } from "../../../../ui";
2
+ import { Box, Text, useUiCapabilities, type BoxRenderable, type LiveBoxFrame } from "../../../../ui";
3
3
  import { colors } from "../../../../theme/colors";
4
+ import { blendHex } from "../../../../theme/color-utils";
4
5
  import { SHELL_DRAG_Z, type LayoutBounds } from "../../../../layout/pane-manager";
5
6
  import type { DragPreview } from "./index";
6
7
  import { useLiveBoxFrame, useLiveDrag, type LiveDragGeometry, type LiveDragStore } from "./live";
7
8
  import { placeStyle } from "./slide";
9
+ import {
10
+ dropStrips,
11
+ dropZoneSquares,
12
+ type DropStripEdge,
13
+ type DropZoneMetrics,
14
+ type DropZoneSide,
15
+ type DropZoneState,
16
+ } from "./drop-zones";
8
17
 
9
18
  /** Desktop: how opaque a pane on the move is while it is over somewhere to land, so the preview under it shows. */
10
19
  export const ARMED_DRAG_OPACITY = 0.7;
11
20
 
21
+ /** A pane of the layout, or a tab pulled out of a floating stack, moves as an outline. */
12
22
  function selectDockedOutline(geometry: LiveDragGeometry) {
13
23
  const { paneDrag, floating } = geometry;
14
- return paneDrag?.mode === "docked" && floating?.paneId === paneDrag.paneId ? floating.rect : null;
24
+ return paneDrag && paneDrag.mode !== "floating" && floating?.paneId === paneDrag.paneId ? floating.rect : null;
15
25
  }
16
26
 
17
27
  const selectDockPreview = (geometry: LiveDragGeometry) => geometry.dockPreview;
28
+ const selectZones = (geometry: LiveDragGeometry) => geometry.zones;
18
29
  const selectPaneDragActive = (geometry: LiveDragGeometry) => geometry.paneDrag !== null;
30
+ /**
31
+ * The targets show once the pane is on the move: past the drag threshold the
32
+ * drag always has a zone, if only "nowhere". A press that has not moved yet,
33
+ * a click to focus or to pick a tab, draws nothing.
34
+ */
35
+ const selectTargetsShown = (geometry: LiveDragGeometry) => geometry.paneDrag !== null && geometry.zones !== null;
19
36
  const selectOutlineWidth = (geometry: LiveDragGeometry) => selectDockedOutline(geometry)?.width ?? null;
20
37
  const selectOutlineHeight = (geometry: LiveDragGeometry) => selectDockedOutline(geometry)?.height ?? null;
21
38
 
@@ -23,12 +40,19 @@ export function ShellDragOverlays(props: {
23
40
  /** A pane from another window over this one's edge. */
24
41
  externalDockPreview: DragPreview | null;
25
42
  live: LiveDragStore;
43
+ /** The shell's content area, whose edges have the strips that put a pane along them. */
44
+ area: LayoutBounds;
45
+ /** The size of the targets, in cells. */
46
+ metrics: DropZoneMetrics;
26
47
  }) {
27
48
  const { nativePaneChrome } = useUiCapabilities();
28
49
  return nativePaneChrome ? <DesktopDragOverlays {...props} /> : <TerminalDragOverlays {...props} />;
29
50
  }
30
51
 
31
- /** A docked pane on the move is drawn as an outline at its floating size, until it is over a drop target. */
52
+ const ZONE_SIDES: readonly DropZoneSide[] = ["center", "left", "right", "top", "bottom"];
53
+ const STRIP_EDGES: readonly DropStripEdge[] = ["left", "right", "top", "bottom"];
54
+
55
+ /** A pane of the layout on the move is drawn as an outline at its floating size, until it is over a target. */
32
56
  function TerminalDockedDragOutline({ live }: { live: LiveDragStore }) {
33
57
  const rect = useLiveDrag(live, selectDockedOutline);
34
58
  if (!rect) return null;
@@ -50,19 +74,26 @@ function TerminalDockedDragOutline({ live }: { live: LiveDragStore }) {
50
74
 
51
75
  /**
52
76
  * Terminal: where the release would land is an outline with nothing filled
53
- * in, so what it is over stays readable.
77
+ * in, so what it is over stays readable; the targets sit over it.
54
78
  */
55
79
  function TerminalDragOverlays({
56
80
  externalDockPreview,
57
81
  live,
82
+ area,
83
+ metrics,
58
84
  }: {
59
85
  externalDockPreview: DragPreview | null;
60
86
  live: LiveDragStore;
87
+ area: LayoutBounds;
88
+ metrics: DropZoneMetrics;
61
89
  }) {
62
90
  const dockPreview = useLiveDrag(live, selectDockPreview);
91
+ const targetsShown = useLiveDrag(live, selectTargetsShown);
63
92
  const effectiveDockPreview = dockPreview ?? externalDockPreview;
64
93
  return (
65
94
  <>
95
+ {targetsShown && <TerminalDropTargets live={live} area={area} metrics={metrics} />}
96
+
66
97
  {!effectiveDockPreview && <TerminalDockedDragOutline live={live} />}
67
98
 
68
99
  {effectiveDockPreview && (
@@ -82,6 +113,91 @@ function TerminalDragOverlays({
82
113
  );
83
114
  }
84
115
 
116
+ /** What a square of the target shows of the pane it lands in: all of it for a tab, a half for a side. */
117
+ const TERMINAL_ZONE_GLYPHS: Record<DropZoneSide, string> = {
118
+ center: "█",
119
+ left: "▌",
120
+ right: "▐",
121
+ top: "▀",
122
+ bottom: "▄",
123
+ };
124
+
125
+ /**
126
+ * Terminal: how much of the accent tints a target, at rest and under the
127
+ * pointer. The desktop's tint is lighter (styles.css) because its targets
128
+ * also have an accent border; a strip here is a single cell with none.
129
+ */
130
+ const TERMINAL_TARGET_TINT = { rest: 0.25, lit: 0.55 } as const;
131
+
132
+ /** `hex` (#rrggbb) at `alpha`: the terminal blends it over the cells under it and keeps their text. */
133
+ function translucent(hex: string, alpha: number): string {
134
+ return `${hex.slice(0, 7)}${Math.round(alpha * 255).toString(16).padStart(2, "0")}`;
135
+ }
136
+
137
+ /**
138
+ * Terminal: the targets a pane on the move can land on, drawn in cells while
139
+ * it moves, as the desktop draws them: the window's outermost cells (a strip
140
+ * along each edge, tinted so what is under it still reads) and, on the pane
141
+ * under the pointer, the five squares of its target, each three cells wide.
142
+ * The one under the pointer is tinted stronger and its mark drawn full.
143
+ */
144
+ function TerminalDropTargets({ live, area, metrics }: { live: LiveDragStore; area: LayoutBounds; metrics: DropZoneMetrics }) {
145
+ const zones: DropZoneState | null = useLiveDrag(live, selectZones);
146
+ const strips = dropStrips(area, metrics);
147
+ const squares = zones?.host ? dropZoneSquares(zones.host.rect, metrics) : null;
148
+ const accent = colors.borderFocused;
149
+ const rest = blendHex(colors.bg, accent, TERMINAL_TARGET_TINT.rest);
150
+ const lit = blendHex(colors.bg, accent, TERMINAL_TARGET_TINT.lit);
151
+ return (
152
+ <>
153
+ {STRIP_EDGES.map((edge) => (
154
+ <Box
155
+ key={`strip:${edge}`}
156
+ position="absolute"
157
+ left={strips[edge].x}
158
+ top={strips[edge].y}
159
+ width={strips[edge].width}
160
+ height={strips[edge].height}
161
+ zIndex={SHELL_DRAG_Z.targets}
162
+ backgroundColor={translucent(accent, zones?.edge === edge ? TERMINAL_TARGET_TINT.lit : TERMINAL_TARGET_TINT.rest)}
163
+ />
164
+ ))}
165
+ {squares && (
166
+ // The cells between the squares across, so the target reads as one.
167
+ <Box
168
+ position="absolute"
169
+ left={squares.left.x}
170
+ top={squares.left.y}
171
+ width={squares.right.x + squares.right.width - squares.left.x}
172
+ height={squares.left.height}
173
+ zIndex={SHELL_DRAG_Z.targets}
174
+ backgroundColor={colors.bg}
175
+ />
176
+ )}
177
+ {squares && ZONE_SIDES.map((side) => {
178
+ const active = zones?.side === side;
179
+ return (
180
+ <Box
181
+ key={`zone:${side}`}
182
+ position="absolute"
183
+ left={squares[side].x}
184
+ top={squares[side].y}
185
+ width={squares[side].width}
186
+ height={squares[side].height}
187
+ zIndex={SHELL_DRAG_Z.targets}
188
+ flexDirection="row"
189
+ backgroundColor={active ? lit : rest}
190
+ >
191
+ <Text fg={accent} selectable={false}>[</Text>
192
+ <Text fg={active ? accent : colors.textDim} selectable={false}>{TERMINAL_ZONE_GLYPHS[side]}</Text>
193
+ <Text fg={accent} selectable={false}>]</Text>
194
+ </Box>
195
+ );
196
+ })}
197
+ </>
198
+ );
199
+ }
200
+
85
201
  /**
86
202
  * Desktop: an overlay laid out at the shell's corner and drawn at `rect` by a
87
203
  * transform, hidden by opacity, so a new drop target restyles it in place.
@@ -175,13 +291,74 @@ export function DesktopDropPreview({
175
291
  function DesktopDragOverlays({
176
292
  externalDockPreview,
177
293
  live,
294
+ area,
295
+ metrics,
178
296
  }: {
179
297
  externalDockPreview: DragPreview | null;
180
298
  live: LiveDragStore;
299
+ area: LayoutBounds;
300
+ metrics: DropZoneMetrics;
181
301
  }) {
182
302
  const dragging = useLiveDrag(live, selectPaneDragActive);
303
+ const targetsShown = useLiveDrag(live, selectTargetsShown);
183
304
  if (!dragging && !externalDockPreview) return null;
184
- return <DesktopDragOverlayLayers externalDockPreview={externalDockPreview} live={live} />;
305
+ return (
306
+ <>
307
+ <DesktopDragOverlayLayers externalDockPreview={externalDockPreview} live={live} />
308
+ {targetsShown && <DesktopDropTargets live={live} area={area} metrics={metrics} />}
309
+ </>
310
+ );
311
+ }
312
+
313
+ /** Desktop: one drop target, a square or a strip, at `rect` (cells) from the shell's corner. */
314
+ function DesktopDropTarget({ rect, role, attributes }: { rect: LayoutBounds; role: string; attributes: Record<string, string> }) {
315
+ return (
316
+ <Box
317
+ position="absolute"
318
+ left={0}
319
+ top={0}
320
+ width={rect.width}
321
+ height={rect.height}
322
+ zIndex={SHELL_DRAG_Z.targets}
323
+ data-gloom-role={role}
324
+ {...attributes}
325
+ style={{ ...placeStyle(rect.x, rect.y), pointerEvents: "none" }}
326
+ />
327
+ );
328
+ }
329
+
330
+ /**
331
+ * Desktop: the targets a pane on the move can land on, drawn while it moves.
332
+ * A strip along each edge of the window (along that whole edge of the
333
+ * layout), and on the pane under the pointer a target of five squares (its
334
+ * centre a tab there, a side a split of that pane on that side); the one
335
+ * under the pointer lit. They render when what the pointer is over changes,
336
+ * never on a move.
337
+ */
338
+ function DesktopDropTargets({ live, area, metrics }: { live: LiveDragStore; area: LayoutBounds; metrics: DropZoneMetrics }) {
339
+ const zones: DropZoneState | null = useLiveDrag(live, selectZones);
340
+ const strips = dropStrips(area, metrics);
341
+ const squares = zones?.host ? dropZoneSquares(zones.host.rect, metrics) : null;
342
+ return (
343
+ <>
344
+ {STRIP_EDGES.map((edge) => (
345
+ <DesktopDropTarget
346
+ key={`strip:${edge}`}
347
+ rect={strips[edge]}
348
+ role="drop-strip"
349
+ attributes={{ "data-edge": edge, "data-active": zones?.edge === edge ? "true" : "false" }}
350
+ />
351
+ ))}
352
+ {squares && ZONE_SIDES.map((side) => (
353
+ <DesktopDropTarget
354
+ key={`zone:${side}`}
355
+ rect={squares[side]}
356
+ role="drop-zone"
357
+ attributes={{ "data-side": side, "data-active": zones?.side === side ? "true" : "false" }}
358
+ />
359
+ ))}
360
+ </>
361
+ );
185
362
  }
186
363
 
187
364
  function DesktopDragOverlayLayers({
@@ -18,7 +18,6 @@ import {
18
18
  import type { LayoutConfig } from "../../../../types/config";
19
19
  import {
20
20
  constrainFloatingRectToBounds,
21
- makeSnapGuides,
22
21
  sameRect,
23
22
  type DragPreview,
24
23
  type PaneDragRectState,
@@ -28,6 +27,7 @@ import type { ActionMenuState } from "../action-menu-overlay";
28
27
  import type { DividerPreviewState } from "../native/window-state";
29
28
  import { createLiveDragStore, IDLE_DRAG, type LiveDockGeometry, type LiveDragStore } from "./live";
30
29
  import type { MagnetDistances } from "./magnets";
30
+ import { sameDropZone, type DropZoneMetrics, type DropZoneState } from "./drop-zones";
31
31
  import { beginLiveResize, createCatchUp } from "../../../../ui/live-resize";
32
32
  import type { WindowEditState } from "../../window-edit/mode";
33
33
  import { useShellActiveDrag } from "../active-drag";
@@ -93,13 +93,20 @@ export interface ShellDragRuntimeState {
93
93
  /** `dock`: on the desktop, the panes and dividers under the split, where the pointer has them. */
94
94
  updateDividerPreview: (next: DividerPreviewState | null, dock?: LiveDockGeometry | null) => void;
95
95
  updateDockPreview: (next: DragPreview | null) => void;
96
+ /** The targets a pane on the move is over: the one on a pane, a window-edge strip. */
97
+ updateDropZone: (next: DropZoneState | null) => void;
96
98
  updateDragFloatingRect: (next: { paneId: string; rect: FloatingRect } | null) => void;
99
+ /** The windows a resize moves with it (shared edges), where the pointer has them. */
100
+ updateDragPartners: (next: ReadonlyMap<string, FloatingRect> | null) => void;
97
101
  }
98
102
 
99
103
  function sameDragPreview(a: DragPreview | null, b: DragPreview | null): boolean {
100
104
  if (a === b) return true;
101
105
  if (!a || !b || a.kind !== b.kind || !sameRect(a.rect, b.rect)) return false;
102
- if (a.kind === "snap" && b.kind === "snap") return a.position === b.position;
106
+ if (a.kind === "float" && b.kind === "float") {
107
+ return a.drop.type === b.drop.type && a.drop.targetId === b.drop.targetId
108
+ && (a.drop.type !== "split" || (b.drop.type === "split" && a.drop.side === b.drop.side));
109
+ }
103
110
  if (a.kind === "dock" && b.kind === "dock") {
104
111
  const [x, y] = [a.target, b.target];
105
112
  if (x.kind === "frame" && y.kind === "frame") return x.edge === y.edge;
@@ -151,6 +158,13 @@ export function useShellDragRuntimeState({
151
158
  }
152
159
  }, [catchUp, contentHeight, live, nativePaneChrome, width]);
153
160
 
161
+ const updateDragPartners = useCallback((next: ReadonlyMap<string, FloatingRect> | null) => {
162
+ const current = live.get();
163
+ // Like the resized window: restyled on the desktop once they have started following.
164
+ if (nativePaneChrome && next && current.partners && current.paneResize) live.move({ partners: next });
165
+ else live.set({ partners: next });
166
+ }, [live, nativePaneChrome]);
167
+
154
168
  const updateDividerPreview = useCallback((next: DividerPreviewState | null, dock: LiveDockGeometry | null = null) => {
155
169
  const current = live.get().divider;
156
170
  // The desktop divider and the panes on both sides follow by restyling
@@ -170,6 +184,11 @@ export function useShellDragRuntimeState({
170
184
  live.set({ dockPreview: next });
171
185
  }, [live]);
172
186
 
187
+ const updateDropZone = useCallback((next: DropZoneState | null) => {
188
+ if (sameDropZone(live.get().zones, next)) return;
189
+ live.set({ zones: next });
190
+ }, [live]);
191
+
173
192
  const startDrag = useCallback((drag: DragMode) => {
174
193
  finishLiveResize();
175
194
  dragRef.current = drag;
@@ -182,7 +201,7 @@ export function useShellDragRuntimeState({
182
201
 
183
202
  const endDrag = useCallback(() => {
184
203
  dragRef.current = null;
185
- live.set({ paneDrag: null, paneResize: null });
204
+ live.set({ paneDrag: null, paneResize: null, partners: null, zones: null });
186
205
  finishLiveResize();
187
206
  }, [finishLiveResize, live]);
188
207
 
@@ -204,6 +223,8 @@ export function useShellDragRuntimeState({
204
223
  updateDividerPreview,
205
224
  updateDockPreview,
206
225
  updateDragFloatingRect,
226
+ updateDragPartners,
227
+ updateDropZone,
207
228
  };
208
229
  }
209
230
 
@@ -221,6 +242,8 @@ interface UseShellPointerRuntimeOptions {
221
242
  handleFloatingClose: (paneId: string) => void;
222
243
  /** How close a moving or resizing pane's edge comes to another before it sticks, in cells. */
223
244
  magnetDistances: MagnetDistances;
245
+ /** The size of the drop targets a moving pane is offered, in cells. */
246
+ dropZoneMetrics: DropZoneMetrics;
224
247
  restoreFullscreen: () => void;
225
248
  menuState: ActionMenuState | null;
226
249
  nativePaneChrome: boolean;
@@ -238,7 +261,6 @@ interface UseShellPointerRuntimeOptions {
238
261
  selectWindowModePane: (paneId: string) => void;
239
262
  setHoveredMenuItemId: Dispatch<SetStateAction<string | null>>;
240
263
  setMenuState: Dispatch<SetStateAction<ActionMenuState | null>>;
241
- snapGuides: ReturnType<typeof makeSnapGuides>;
242
264
  transientFocusActive: boolean;
243
265
  updateWindowModePreviewLayout: (nextLayout: LayoutConfig, paneId?: string) => void;
244
266
  visibleFloatingPanes: VisibleFloatingPane[];
@@ -261,6 +283,7 @@ export function useShellPointerRuntime({
261
283
  focusedPaneId,
262
284
  handleFloatingClose,
263
285
  magnetDistances,
286
+ dropZoneMetrics,
264
287
  restoreFullscreen,
265
288
  menuState,
266
289
  nativePaneChrome,
@@ -273,7 +296,6 @@ export function useShellPointerRuntime({
273
296
  selectWindowModePane,
274
297
  setHoveredMenuItemId,
275
298
  setMenuState,
276
- snapGuides,
277
299
  transientFocusActive,
278
300
  updateWindowModePreviewLayout,
279
301
  visibleFloatingPanes,
@@ -291,11 +313,11 @@ export function useShellPointerRuntime({
291
313
  focusPane,
292
314
  dragRuntime,
293
315
  magnetDistances,
316
+ dropZoneMetrics,
294
317
  nativePaneChrome,
295
318
  paneMap,
296
319
  persistLayout,
297
320
  precisePointer,
298
- snapGuides,
299
321
  updateWindowModePreviewLayout,
300
322
  visibleLayout,
301
323
  windowMode,
@@ -324,6 +346,7 @@ export function useShellPointerRuntime({
324
346
  setMenuState,
325
347
  transientFocusActive,
326
348
  visibleFloatingPanes,
349
+ floatingOrder: visibleLayout.floating,
327
350
  width,
328
351
  windowMode,
329
352
  });
@@ -0,0 +1,156 @@
1
+ import { MIN_FLOAT_HEIGHT, MIN_FLOAT_WIDTH, type FloatingRect } from "../../../../layout/pane-manager";
2
+ import type { ResizeEdges } from "./index";
3
+
4
+ /**
5
+ * Floating windows snapped edge to edge resize together: dragging the edge
6
+ * one shares with its neighbours moves that line for all of them, so the
7
+ * middle of two windows side by side resizes both, as a dock divider does.
8
+ */
9
+
10
+ /** How close two edges are to count as one line, and how far two spans overlap to count as neighbours, in cells. */
11
+ const SAME_LINE = 0.05;
12
+ const NEIGHBOUR_OVERLAP = 0.5;
13
+
14
+ interface Member {
15
+ id: string;
16
+ rect: FloatingRect;
17
+ }
18
+
19
+ /** The windows on one line of one axis: `near` have the dragged edge's side on it, `far` the other. */
20
+ interface AxisGroup {
21
+ axis: "x" | "y";
22
+ /** The dragged edge: -1 the left or top one, 1 the right or bottom one. */
23
+ edge: -1 | 1;
24
+ line: number;
25
+ near: Member[];
26
+ far: Member[];
27
+ }
28
+
29
+ export interface SharedEdgeGroups {
30
+ x: AxisGroup | null;
31
+ y: AxisGroup | null;
32
+ /** Every window that moves with the drag, the dragged one too. */
33
+ ids: ReadonlySet<string>;
34
+ }
35
+
36
+ export const NO_SHARED_EDGES: SharedEdgeGroups = { x: null, y: null, ids: new Set() };
37
+
38
+ function startOf(rect: FloatingRect, axis: "x" | "y") {
39
+ return axis === "x" ? rect.x : rect.y;
40
+ }
41
+
42
+ function lengthOf(rect: FloatingRect, axis: "x" | "y") {
43
+ return axis === "x" ? rect.width : rect.height;
44
+ }
45
+
46
+ function edgeOf(rect: FloatingRect, axis: "x" | "y", edge: -1 | 1) {
47
+ return edge === -1 ? startOf(rect, axis) : startOf(rect, axis) + lengthOf(rect, axis);
48
+ }
49
+
50
+ /** Whether two rects sit beside each other across `axis`: their spans on the other axis overlap. */
51
+ function neighbours(a: FloatingRect, b: FloatingRect, axis: "x" | "y") {
52
+ const [aStart, aLength, bStart, bLength] = axis === "x"
53
+ ? [a.y, a.height, b.y, b.height]
54
+ : [a.x, a.width, b.x, b.width];
55
+ return Math.min(aStart + aLength, bStart + bLength) - Math.max(aStart, bStart) > NEIGHBOUR_OVERLAP;
56
+ }
57
+
58
+ function groupOnAxis(windows: readonly Member[], dragged: Member, axis: "x" | "y", edge: -1 | 1): AxisGroup | null {
59
+ const line = edgeOf(dragged.rect, axis, edge);
60
+ const near: Member[] = [dragged];
61
+ const far: Member[] = [];
62
+ const placed = new Set([dragged.id]);
63
+ // Grown out from the dragged window: a window across the line from one in
64
+ // `near` is in `far`, and one on the near side of the line beside a window
65
+ // in `far` is in `near`, so a row of windows along one line moves as one.
66
+ for (let changed = true; changed;) {
67
+ changed = false;
68
+ for (const window of windows) {
69
+ if (placed.has(window.id)) continue;
70
+ const onFar = Math.abs(edgeOf(window.rect, axis, edge === 1 ? -1 : 1) - line) <= SAME_LINE;
71
+ const onNear = Math.abs(edgeOf(window.rect, axis, edge) - line) <= SAME_LINE;
72
+ if (onFar && near.some((member) => neighbours(member.rect, window.rect, axis))) {
73
+ far.push(window);
74
+ } else if (onNear && far.some((member) => neighbours(member.rect, window.rect, axis))) {
75
+ near.push(window);
76
+ } else {
77
+ continue;
78
+ }
79
+ placed.add(window.id);
80
+ changed = true;
81
+ }
82
+ }
83
+ return far.length > 0 ? { axis, edge, line, near, far } : null;
84
+ }
85
+
86
+ /**
87
+ * The windows a resize of `dragged` by `edges` moves with it: on each axis
88
+ * it resizes, those whose edge lies on the line of the dragged edge and that
89
+ * sit beside a window on the other side of it. None, when it is alone there.
90
+ */
91
+ export function resolveSharedEdges(windows: readonly Member[], dragged: Member, edges: ResizeEdges): SharedEdgeGroups {
92
+ const others = windows.filter((window) => window.id !== dragged.id);
93
+ const x = edges.x === 0 ? null : groupOnAxis(others, dragged, "x", edges.x);
94
+ const y = edges.y === 0 ? null : groupOnAxis(others, dragged, "y", edges.y);
95
+ if (!x && !y) return NO_SHARED_EDGES;
96
+ const ids = new Set<string>();
97
+ for (const group of [x, y]) for (const member of [...(group?.near ?? []), ...(group?.far ?? [])]) ids.add(member.id);
98
+ return { x, y, ids };
99
+ }
100
+
101
+ function minimumOf(axis: "x" | "y") {
102
+ return axis === "x" ? MIN_FLOAT_WIDTH : MIN_FLOAT_HEIGHT;
103
+ }
104
+
105
+ /** One axis of `rect` with the edge `side` moved by `delta`. */
106
+ function moveEdge(rect: FloatingRect, axis: "x" | "y", side: -1 | 1, delta: number): FloatingRect {
107
+ if (axis === "x") {
108
+ return side === 1 ? { ...rect, width: rect.width + delta } : { ...rect, x: rect.x + delta, width: rect.width - delta };
109
+ }
110
+ return side === 1 ? { ...rect, height: rect.height + delta } : { ...rect, y: rect.y + delta, height: rect.height - delta };
111
+ }
112
+
113
+ /**
114
+ * Where every window of the groups goes when the dragged one is resized to
115
+ * `resized`: the shared line follows the dragged edge, held where any window
116
+ * on it would go under its minimum size or past the area. `rects` has every
117
+ * window that moves, the dragged one too (its rect on that axis set by the
118
+ * line).
119
+ */
120
+ export function applySharedEdges(
121
+ groups: SharedEdgeGroups,
122
+ draggedId: string,
123
+ resized: FloatingRect,
124
+ area: { width: number; height: number },
125
+ ): Map<string, FloatingRect> {
126
+ const rects = new Map<string, FloatingRect>();
127
+ const rectOf = (member: Member) => rects.get(member.id) ?? member.rect;
128
+ for (const group of [groups.x, groups.y]) {
129
+ if (!group) continue;
130
+ const { axis, edge, line } = group;
131
+ const minimum = minimumOf(axis);
132
+ let low = -line;
133
+ let high = (axis === "x" ? area.width : area.height) - line;
134
+ const hold = (side: -1 | 1, length: number) => {
135
+ // The far edge grows with the line (delta >= minimum - length); the near one shrinks (delta <= length - minimum).
136
+ if (side === 1) low = Math.max(low, minimum - length);
137
+ else high = Math.min(high, length - minimum);
138
+ };
139
+ for (const member of group.near) hold(edge, lengthOf(member.rect, axis));
140
+ for (const member of group.far) hold(edge === 1 ? -1 : 1, lengthOf(member.rect, axis));
141
+ const wanted = edgeOf(resized, axis, edge) - line;
142
+ const delta = low > high ? 0 : Math.max(low, Math.min(high, wanted));
143
+ for (const member of group.near) rects.set(member.id, moveEdge(rectOf(member), axis, edge, delta));
144
+ for (const member of group.far) rects.set(member.id, moveEdge(rectOf(member), axis, edge === 1 ? -1 : 1, delta));
145
+ }
146
+ // An axis the dragged window resizes alone takes the resize as it is.
147
+ const dragged = rects.get(draggedId);
148
+ if (dragged) {
149
+ rects.set(draggedId, {
150
+ ...dragged,
151
+ ...(groups.x ? {} : { x: resized.x, width: resized.width }),
152
+ ...(groups.y ? {} : { y: resized.y, height: resized.height }),
153
+ });
154
+ }
155
+ return rects;
156
+ }
@@ -39,11 +39,9 @@ import {
39
39
  } from "./menu";
40
40
  import { tickerLinkMenuItems } from "./ticker-link-menu";
41
41
  import { resolveTickerRetargetPane } from "../../../layout/ticker-retarget";
42
- import {
43
- makeSnapGuides,
44
- resolveExternalDockPreview,
45
- } from "./drag";
42
+ import { resolveExternalDockPreview } from "./drag";
46
43
  import { magnetDistancesFor } from "./drag/magnets";
44
+ import { desktopDropZoneMetrics, TERMINAL_DROP_ZONE_METRICS } from "./drag/drop-zones";
47
45
  import { resolveAppHeaderHeightCells } from "./chrome";
48
46
  import { useAppChromeShown } from "../presentation";
49
47
  import { useShellWindowMode } from "./window-mode";
@@ -209,6 +207,10 @@ export function Shell({
209
207
  const magnetDistances = useMemo(() => magnetDistancesFor(
210
208
  nativePaneChrome ? { width: cellWidthPx ?? 8, height: cellHeightPx ?? 18 } : null,
211
209
  ), [cellHeightPx, cellWidthPx, nativePaneChrome]);
210
+ const dropZoneMetrics = useMemo(() => (nativePaneChrome
211
+ ? desktopDropZoneMetrics({ width: cellWidthPx ?? 8, height: cellHeightPx ?? 18 })
212
+ : TERMINAL_DROP_ZONE_METRICS
213
+ ), [cellHeightPx, cellWidthPx, nativePaneChrome]);
212
214
 
213
215
  // Every edit here starts from the visible layout, so the panes it hides go
214
216
  // back in before the layout is saved, rather than being deleted with it.
@@ -505,7 +507,6 @@ export function Shell({
505
507
  () => (transientFocusActive ? [] : dockDividerLayouts),
506
508
  [dockDividerLayouts, transientFocusActive],
507
509
  );
508
- const snapGuides = useMemo(() => makeSnapGuides(width, contentHeight), [contentHeight, width]);
509
510
  const externalDockPreview = useMemo(
510
511
  () => resolveExternalDockPreview(desktopDockPreview, bounds),
511
512
  [bounds, desktopDockPreview],
@@ -796,6 +797,7 @@ export function Shell({
796
797
  startNativeDockedDrag,
797
798
  startNativeFloatingDrag,
798
799
  startNativeFloatResize,
800
+ startNativeTabDrag,
799
801
  } = useShellPointerRuntime({
800
802
  appHeaderHeight,
801
803
  bounds,
@@ -811,6 +813,7 @@ export function Shell({
811
813
  focusedPaneId,
812
814
  handleFloatingClose,
813
815
  magnetDistances,
816
+ dropZoneMetrics,
814
817
  restoreFullscreen: exitTransientFocusLayout,
815
818
  menuState,
816
819
  nativePaneChrome,
@@ -823,7 +826,6 @@ export function Shell({
823
826
  selectWindowModePane,
824
827
  setHoveredMenuItemId,
825
828
  setMenuState,
826
- snapGuides,
827
829
  transientFocusActive,
828
830
  updateWindowModePreviewLayout,
829
831
  visibleFloatingPanes: screenFloatingPanes,
@@ -944,6 +946,7 @@ export function Shell({
944
946
  startNativeDockedDrag={startNativeDockedDrag}
945
947
  startNativeFloatingDrag={startNativeFloatingDrag}
946
948
  startNativeFloatResize={startNativeFloatResize}
949
+ startNativeTabDrag={startNativeTabDrag}
947
950
  transientFocusActive={transientFocusActive}
948
951
  transientFocusPaneId={transientFocusPaneId}
949
952
  visibleFloatingPanes={visibleFloatingPanes}
@@ -974,6 +977,8 @@ export function Shell({
974
977
  <ShellDragOverlays
975
978
  externalDockPreview={externalDockPreview}
976
979
  live={live}
980
+ area={bounds}
981
+ metrics={dropZoneMetrics}
977
982
  />
978
983
 
979
984
  <ShellActionMenuOverlay
@@ -34,6 +34,8 @@ export interface PaneMenuEntry {
34
34
  accelerator?: string;
35
35
  checked?: boolean;
36
36
  divider?: boolean;
37
+ /** See ContextMenuActionItem.remoteScope. */
38
+ remoteScope?: string;
37
39
  action: () => void;
38
40
  }
39
41
 
@@ -65,7 +67,13 @@ export function paneFooterMenuItems(footer: CombinedPaneFooter | undefined): Con
65
67
  for (const hint of footer.hints) {
66
68
  if (hint.disabled || !hint.onPress) continue;
67
69
  const onPress = hint.onPress;
68
- items.push({ id: `pane-hint:${hint.id}`, label: paneHintTitle(hint), accelerator: hint.key, onSelect: () => onPress() });
70
+ items.push({
71
+ id: `pane-hint:${hint.id}`,
72
+ label: paneHintTitle(hint),
73
+ accelerator: hint.key,
74
+ onSelect: () => onPress(),
75
+ ...(hint.remoteScope ? { remoteScope: hint.remoteScope } : {}),
76
+ });
69
77
  }
70
78
  for (const segment of footer.info) {
71
79
  if (segment.disabled || !segment.onPress || !segment.shortcut) continue;
@@ -197,7 +205,7 @@ export function menuForPane(
197
205
  if (pane.floating) {
198
206
  baseActions.push({
199
207
  id: "dock",
200
- label: "Dock Pane",
208
+ label: "Return to Layout",
201
209
  accelerator: accelerators.toggleFloating,
202
210
  onSelect: () => {
203
211
  persistLayout(applyDrop(layout, pane.instance.instanceId, { kind: "frame", edge: "right" }));
@@ -293,6 +301,7 @@ export function menuItemsForFallback(
293
301
  accelerator: item.accelerator
294
302
  ? formatShortcutForHost(item.accelerator, shortcutDisplayMode)
295
303
  : undefined,
304
+ ...(item.remoteScope ? { remoteScope: item.remoteScope } : {}),
296
305
  action: () => { void item.onSelect?.(); },
297
306
  }];
298
307
  });