From a17bc94788372aba1b269b91031438945e2684b4 Mon Sep 17 00:00:00 2001
From: Zackary Lowery <zlowery@xcjs.com>
Date: Sat, 3 Oct 2026 09:03:21 -0400
Subject: [PATCH 1/3] feat(os): Aero-style window snap zones (NEXT.md 3.2)

Drag to the left/right edge tiles halves, to the top edge maximizes,
to a corner tiles quarters; a translucent preview shows the target
rect while a zone is active. os.ts gains snapWindow/unsnapWindow/
setWindowRect with pre-snap geometry stored on the window record, so
dragging a snapped window away restores its previous rect. Desktop
only: drag stays disabled below 768px. E2e covers half snap, restore,
quarter, and maximize.
---
 app/features/os/components/WindowFrame.vue | 92 +++++++++++++++++++++-
 app/features/os/stores/os.ts               | 68 ++++++++++++++++
 tests/e2e/window-snap.spec.ts              | 89 +++++++++++++++++++++
 3 files changed, 245 insertions(+), 4 deletions(-)
 create mode 100644 tests/e2e/window-snap.spec.ts

diff --git a/app/features/os/components/WindowFrame.vue b/app/features/os/components/WindowFrame.vue
index 47acab6..d05e161 100644
--- a/app/features/os/components/WindowFrame.vue
+++ b/app/features/os/components/WindowFrame.vue
@@ -1,7 +1,7 @@
 <script setup lang="ts">
-import { computed, ref, watch } from "vue";
+import { computed, onUnmounted, ref, watch } from "vue";
 import { useMediaQuery } from "@vueuse/core";
-import { useOsStore, type OsWindow } from "../stores/os";
+import { useOsStore, type OsWindow, type SnapZone } from "../stores/os";
 
 const props = defineProps<{ win: OsWindow }>();
 
@@ -27,6 +27,10 @@ watch(
   },
 );
 
+const snapZone = ref<SnapZone | null>(null);
+const TASKBAR = 48;
+const EDGE = 24; // px from a viewport edge that activates a snap zone
+
 const style = computed(() => {
   if (props.win.state === "maximized") {
     return {
@@ -45,11 +49,55 @@ const style = computed(() => {
     zIndex: props.win.z,
   };
 });
-
 function clamp(x: number, min: number, max: number): number {
   return Math.min(Math.max(x, min), max);
 }
 
+function zoneAt(pointerX: number, pointerY: number): SnapZone | null {
+  const vw = window.innerWidth;
+  const vh = window.innerHeight;
+  const atLeft = pointerX <= EDGE;
+  const atRight = pointerX >= vw - EDGE;
+  const atTop = pointerY <= EDGE;
+  const atBottom = pointerY >= vh - TASKBAR - EDGE - 8;
+  const upperHalf = pointerY < (vh - TASKBAR) / 2;
+  if (atTop && atLeft) return "tl";
+  if (atTop && atRight) return "tr";
+  if (atBottom && atLeft) return "bl";
+  if (atBottom && atRight) return "br";
+  if (atTop) return "max";
+  if (atLeft) return "left";
+  if (atRight) return "right";
+  return null;
+}
+
+const zoneRect = computed(() => {
+  const zone = snapZone.value;
+  if (!zone) return null;
+  const vw = window.innerWidth;
+  const vh = window.innerHeight - TASKBAR;
+  const half = { left: 0, top: 0, width: vw / 2, height: vh };
+  const quarterH = vw / 2;
+  const quarterV = vh / 2;
+  switch (zone) {
+    case "left":
+      return half;
+    case "right":
+      return { ...half, left: vw / 2 };
+    case "tl":
+      return { ...half, width: quarterH, height: quarterV };
+    case "tr":
+      return { left: vw / 2, top: 0, width: quarterH, height: quarterV };
+    case "bl":
+      return { left: 0, top: quarterV, width: quarterH, height: quarterV };
+    case "br":
+      return { left: vw / 2, top: quarterV, width: quarterH, height: quarterV };
+    case "max":
+      return { left: 0, top: 0, width: vw, height: vh };
+  }
+  return null;
+});
+
 function onPointerDown(event: PointerEvent): void {
   if (props.win.state === "maximized") return;
   if (isPhone.value) return;
@@ -59,22 +107,58 @@ function onPointerDown(event: PointerEvent): void {
 }
 
 function onPointerMove(event: PointerEvent): void {
-  if (!dragging.value) return;
+  if (!dragging.value) {
+    // A single move while holding the grab affords unsnapping, but the
+    // real restore happens on the first move after a snapped state.
+    return;
+  }
+  if (props.win.preSnap) {
+    store.unsnapWindow(props.win.id);
+  }
   const handle = dragHandle.value;
   if (!handle) return;
   const rect = handle.getBoundingClientRect();
   const nx = clamp(props.win.x + event.movementX, -rect.width + 80, window.innerWidth - 80);
   const ny = clamp(props.win.y + event.movementY, 0, window.innerHeight - 48 - 40);
   store.moveWindow(props.win.id, nx, ny);
+  snapZone.value = zoneAt(event.clientX, event.clientY);
 }
 
 function onPointerUp(event: PointerEvent): void {
   dragging.value = false;
+  const zone = snapZone.value;
+  snapZone.value = null;
+  if (zone) {
+    store.snapWindow(props.win.id, zone);
+  }
   (event.currentTarget as HTMLElement).releasePointerCapture(event.pointerId);
 }
+
+onUnmounted(() => {
+  dragging.value = false;
+  snapZone.value = null;
+});
+
+// A dragged pointer leaving the window still updates the zone highlight.
+watch(dragging, (active) => {
+  if (!active) snapZone.value = null;
+});
 </script>
 
 <template>
+  <Teleport to="body">
+    <div
+      v-if="zoneRect"
+      class="pointer-events-none fixed z-[999] rounded-lg border-2 border-indigo-400 bg-indigo-400/15 transition-all duration-100"
+      :style="{
+        left: `${zoneRect.left}px`,
+        top: `${zoneRect.top}px`,
+        width: `${zoneRect.width}px`,
+        height: `${zoneRect.height}px`,
+      }"
+      aria-hidden="true"
+    />
+  </Teleport>
   <section
     ref="el"
     v-show="!win.minimized"
diff --git a/app/features/os/stores/os.ts b/app/features/os/stores/os.ts
index e562dc8..358c73c 100644
--- a/app/features/os/stores/os.ts
+++ b/app/features/os/stores/os.ts
@@ -3,6 +3,8 @@ import { computed, ref } from "vue";
 
 export type WindowState = "normal" | "minimized" | "maximized";
 
+export type SnapZone = "left" | "right" | "max" | "tl" | "tr" | "bl" | "br";
+
 export interface OsWindow {
   id: string;
   appId?: string;
@@ -14,6 +16,8 @@ export interface OsWindow {
   z: number;
   state: WindowState;
   minimized: boolean;
+  // Geometry to restore when a snapped window is dragged away (NEXT.md 3.2).
+  preSnap?: { x: number; y: number; width: number; height: number } | null;
 }
 
 let nextId = 1;
@@ -72,6 +76,67 @@ export const useOsStore = defineStore("os", () => {
     win.y = y;
   }
 
+  function setWindowRect(
+    id: string,
+    rect: { x: number; y: number; width: number; height: number },
+  ): void {
+    const win = windows.value.find((w) => w.id === id);
+    if (!win) return;
+    win.x = rect.x;
+    win.y = rect.y;
+    win.width = rect.width;
+    win.height = rect.height;
+    win.state = "normal";
+    win.minimized = false;
+  }
+
+  // Aero-style snap (NEXT.md 3.2): the original rect is remembered so a
+  // later drag away from the snapped position restores it.
+  function snapWindow(id: string, zone: SnapZone): void {
+    const win = windows.value.find((w) => w.id === id);
+    if (!win) return;
+    const vw = window.innerWidth;
+    const vh = window.innerHeight - 48; // taskbar height
+    const gap = 8;
+    const half = {
+      x: zone === "right" ? vw / 2 : 0,
+      y: 0,
+      width: vw / 2,
+      height: vh,
+    };
+    const quarter = {
+      x: zone === "tr" || zone === "br" ? vw / 2 : 0,
+      y: zone === "bl" || zone === "br" ? vh / 2 : 0,
+      width: vw / 2,
+      height: vh / 2,
+    };
+    const snapped = zone === "max" ? null : zone === "left" || zone === "right" ? half : quarter;
+    if (zone === "max") {
+      if (win.state !== "maximized") win.preSnap = { x: win.x, y: win.y, width: win.width, height: win.height };
+      win.state = "maximized";
+    } else if (snapped) {
+      if (!win.preSnap) {
+        win.preSnap = {
+          x: win.state === "maximized" ? (window.innerWidth - win.width) / 2 : win.x,
+          y: 0,
+          width: win.state === "maximized" ? win.width : win.width,
+          height: win.state === "maximized" ? vh : win.height,
+        };
+      }
+      setWindowRect(id, { ...snapped, y: snapped.y + gap / 2, height: snapped.height - gap });
+    }
+    focusWindow(id);
+  }
+
+  // Dragging a snapped window away from its zone restores the stored rect.
+  function unsnapWindow(id: string): void {
+    const win = windows.value.find((w) => w.id === id);
+    if (!win || !win.preSnap) return;
+    const pre = win.preSnap;
+    win.preSnap = null;
+    setWindowRect(id, pre);
+  }
+
   function toggleMaximize(id: string): void {
     const win = windows.value.find((w) => w.id === id);
     if (!win) return;
@@ -95,6 +160,9 @@ export const useOsStore = defineStore("os", () => {
     closeWindow,
     focusWindow,
     moveWindow,
+    setWindowRect,
+    snapWindow,
+    unsnapWindow,
     toggleMaximize,
     toggleMinimize,
   };
diff --git a/tests/e2e/window-snap.spec.ts b/tests/e2e/window-snap.spec.ts
new file mode 100644
index 0000000..bd54ad7
--- /dev/null
+++ b/tests/e2e/window-snap.spec.ts
@@ -0,0 +1,89 @@
+import { expect, test, type Page } from '@playwright/test'
+import { openDesktop } from './support/desktop'
+
+// NEXT.md step 3.2: Aero-style snap zones while dragging a window - the
+// left/right edges tile halves, the top edge maximizes, and corners tile
+// quarters. Dragging a snapped window away restores its previous geometry.
+
+test.use({ viewport: { width: 1280, height: 800 } })
+
+/** Drag the chat window's title bar to an absolute viewport point. */
+async function dragTitleTo(page: Page, targetX: number, targetY: number): Promise<void> {
+  const handle = page
+    .locator('section')
+    .filter({ has: page.locator('header').getByText('Agent Chat', { exact: true }) })
+    .locator('header')
+  const box = await handle.boundingBox()
+  expect(box).toBeTruthy()
+  await page.mouse.move(box!.x + box!.width / 2, box!.y + box!.height / 2)
+  await page.mouse.down()
+  await page.mouse.move(targetX, targetY, { steps: 6 })
+  await page.mouse.up()
+}
+
+test('drag to edges snaps halves, corners, top; drag away restores', async ({ page }) => {
+  await openDesktop(page)
+  const taskbarHeight = 48
+  const vh = 800 - taskbarHeight
+  const vw = 1280
+
+  await test.step('drag to the left edge snaps the left half', async () => {
+    await dragTitleTo(page, 4, 400)
+    const win = page
+      .locator('section')
+      .filter({ has: page.locator('header').getByText('Agent Chat', { exact: true }) })
+    const box = await win.boundingBox()
+    expect(box).toBeTruthy()
+    expect(box!.x).toBe(0)
+    expect(box!.width).toBe(vw / 2)
+    expect(box!.height).toBe(vh - 8)
+  })
+
+  await test.step('drag the snapped window away restores its old rect', async () => {
+    const win = page
+      .locator('section')
+      .filter({ has: page.locator('header').getByText('Agent Chat', { exact: true }) })
+    const restored = { x: 120, y: 90, width: 520, height: 560 } // openWindow defaults
+    const before = await win.boundingBox()
+    expect(before!.x).toBe(0) // still snapped
+
+    const handle = win.locator('header')
+    const box = await handle.boundingBox()
+    await page.mouse.move(box!.x + box!.width / 2, box!.y + box!.height / 2)
+    await page.mouse.down()
+    await page.mouse.move(box!.x + box!.width / 2 + 200, box!.y + 200, { steps: 6 })
+    await page.mouse.up()
+
+    const after = await win.boundingBox()
+    expect(after, `after=${JSON.stringify(after)} before=${JSON.stringify(before)}`).toBeTruthy()
+    // The pre-snap geometry (the rect the window had mid-drag when the
+    // zone fired) comes back: full original size, no longer at x=0.
+    expect(after!.width).toBe(restored.width)
+    expect(after!.height).toBe(restored.height)
+    expect(after!.x).not.toBe(0)
+  })
+
+  await test.step('drag to the top-left corner snaps a quarter', async () => {
+    await dragTitleTo(page, 4, 4)
+    const win = page
+      .locator('section')
+      .filter({ has: page.locator('header').getByText('Agent Chat', { exact: true }) })
+    const box = await win.boundingBox()
+    expect(box).toBeTruthy()
+    expect(box!.x).toBe(0)
+    expect(box!.y).toBe(4) // quarter.y + gap/2
+    expect(box!.width).toBe(vw / 2)
+    expect(box!.height).toBeCloseTo(vh / 2 - 8, 0)
+  })
+
+  await test.step('drag to the top edge maximizes', async () => {
+    await dragTitleTo(page, vw / 2, 4)
+    const win = page
+      .locator('section')
+      .filter({ has: page.locator('header').getByText('Agent Chat', { exact: true }) })
+    const box = await win.boundingBox()
+    expect(box).toBeTruthy()
+    expect(box!.width).toBe(vw)
+    expect(box!.height).toBe(vh)
+  })
+})

From d9df3bdd2984ec6b7841577078aa457c84ae0a1b Mon Sep 17 00:00:00 2001
From: Zackary Lowery <zlowery@xcjs.com>
Date: Sat, 3 Oct 2026 10:17:55 -0400
Subject: [PATCH 2/3] fix(os): thin top snap trigger, arm threshold, preSnap y
 restore (review)

---
 app/features/os/components/WindowFrame.vue | 19 ++++++-
 app/features/os/stores/os.ts               |  4 +-
 tests/e2e/window-snap.spec.ts              | 58 ++++++++++++++++++++++
 3 files changed, 77 insertions(+), 4 deletions(-)

diff --git a/app/features/os/components/WindowFrame.vue b/app/features/os/components/WindowFrame.vue
index d05e161..8b32fdd 100644
--- a/app/features/os/components/WindowFrame.vue
+++ b/app/features/os/components/WindowFrame.vue
@@ -28,8 +28,12 @@ watch(
 );
 
 const snapZone = ref<SnapZone | null>(null);
+const armed = ref(false);
+const downPoint = ref<{ x: number; y: number } | null>(null);
 const TASKBAR = 48;
 const EDGE = 24; // px from a viewport edge that activates a snap zone
+const TOP = 6; // thin maximize trigger near the screen edge, Windows-style
+const ARM = 8; // travel px that arms zones; below it, clicks are jitter
 
 const style = computed(() => {
   if (props.win.state === "maximized") {
@@ -58,9 +62,8 @@ function zoneAt(pointerX: number, pointerY: number): SnapZone | null {
   const vh = window.innerHeight;
   const atLeft = pointerX <= EDGE;
   const atRight = pointerX >= vw - EDGE;
-  const atTop = pointerY <= EDGE;
+  const atTop = pointerY <= TOP;
   const atBottom = pointerY >= vh - TASKBAR - EDGE - 8;
-  const upperHalf = pointerY < (vh - TASKBAR) / 2;
   if (atTop && atLeft) return "tl";
   if (atTop && atRight) return "tr";
   if (atBottom && atLeft) return "bl";
@@ -103,6 +106,8 @@ function onPointerDown(event: PointerEvent): void {
   if (isPhone.value) return;
   store.focusWindow(props.win.id);
   dragging.value = true;
+  armed.value = false;
+  downPoint.value = { x: event.clientX, y: event.clientY };
   (event.currentTarget as HTMLElement).setPointerCapture(event.pointerId);
 }
 
@@ -112,6 +117,14 @@ function onPointerMove(event: PointerEvent): void {
     // real restore happens on the first move after a snapped state.
     return;
   }
+  if (!armed.value) {
+    const start = downPoint.value;
+    if (!start) return;
+    const dx = Math.abs(event.clientX - start.x);
+    const dy = Math.abs(event.clientY - start.y);
+    if (dx < ARM && dy < ARM) return; // click jitter guard
+    armed.value = true;
+  }
   if (props.win.preSnap) {
     store.unsnapWindow(props.win.id);
   }
@@ -126,6 +139,8 @@ function onPointerMove(event: PointerEvent): void {
 
 function onPointerUp(event: PointerEvent): void {
   dragging.value = false;
+  armed.value = false;
+  downPoint.value = null;
   const zone = snapZone.value;
   snapZone.value = null;
   if (zone) {
diff --git a/app/features/os/stores/os.ts b/app/features/os/stores/os.ts
index 358c73c..54b1e04 100644
--- a/app/features/os/stores/os.ts
+++ b/app/features/os/stores/os.ts
@@ -118,8 +118,8 @@ export const useOsStore = defineStore("os", () => {
       if (!win.preSnap) {
         win.preSnap = {
           x: win.state === "maximized" ? (window.innerWidth - win.width) / 2 : win.x,
-          y: 0,
-          width: win.state === "maximized" ? win.width : win.width,
+          y: win.y,
+          width: win.width,
           height: win.state === "maximized" ? vh : win.height,
         };
       }
diff --git a/tests/e2e/window-snap.spec.ts b/tests/e2e/window-snap.spec.ts
index bd54ad7..e9d5896 100644
--- a/tests/e2e/window-snap.spec.ts
+++ b/tests/e2e/window-snap.spec.ts
@@ -87,3 +87,61 @@ test('drag to edges snaps halves, corners, top; drag away restores', async ({ pa
     expect(box!.height).toBe(vh)
   })
 })
+
+test('snapped windows ignore in-band grabs and jitter', async ({ page }) => {
+  await openDesktop(page)
+  await dragTitleTo(page, 4, 400) // snap the left half first
+
+  const win = page
+    .locator('section')
+    .filter({ has: page.locator('header').getByText('Agent Chat', { exact: true }) })
+
+  await test.step('a sideways drag inside the top band never maximizes', async () => {
+    // A left-snapped header (y 4-40) starts near the top band; a small
+    // sideways drag must unsnap-restore and follow the pointer, never
+    // maximize (the regression m-vawter measured).
+    const handle = win.locator('header')
+    const box = await handle.boundingBox()
+    await page.mouse.move(box!.x + box!.width / 2, box!.y + box!.height / 2)
+    await page.mouse.down()
+    await page.mouse.move(box!.x + box!.width / 2 + 40, box!.y + box!.height / 2 + 1, {
+      steps: 4,
+    })
+    await page.mouse.up()
+
+    const after = await win.boundingBox()
+    expect(after!.width).toBe(520) // pre-snap width, not 1280
+    expect(after!.height).toBe(560)
+    expect(after!.x).not.toBe(0) // no longer snapped
+  })
+
+  await test.step('a 1px jitter click keeps the snap', async () => {
+    const before = await win.boundingBox()
+    const handle = win.locator('header')
+    const box = await handle.boundingBox()
+    await page.mouse.move(box!.x + box!.width / 2, box!.y + box!.height / 2)
+    await page.mouse.down()
+    await page.mouse.move(box!.x + box!.width / 2 + 1, box!.y + box!.height / 2, { steps: 2 })
+    await page.mouse.up()
+
+    const after = await win.boundingBox()
+    expect(after!.x).toBe(before!.x)
+    expect(after!.width).toBe(before!.width)
+  })
+
+  await test.step('dragging away restores the pre-snap rect including y', async () => {
+    const handle = win.locator('header')
+    const box = await handle.boundingBox()
+    await page.mouse.move(box!.x + box!.width / 2, box!.y + box!.height / 2)
+    await page.mouse.down()
+    await page.mouse.move(box!.x + box!.width / 2 + 200, box!.y + 200, { steps: 6 })
+    await page.mouse.up()
+
+    const after = await win.boundingBox()
+    expect(after!.width).toBe(520)
+    expect(after!.height).toBe(560)
+    // Pre-snap y (382 here) + pointer travel delta: the preSnap.y=0 bug
+    // m-vawter measured would land near y=200 instead of y=582.
+    expect(after!.y).toBeGreaterThan(500)
+  })
+})

From 3f27ada646f10943d49f73086caa19b82c7990aa Mon Sep 17 00:00:00 2001
From: Zackary Lowery <zlowery@xcjs.com>
Date: Sat, 3 Oct 2026 20:49:27 -0400
Subject: [PATCH 3/3] fix(os): unsnap keeps the title bar under the pointer
 (review)

---
 app/features/os/components/WindowFrame.vue | 13 +++++++++
 app/features/os/stores/os.ts               |  2 +-
 tests/e2e/window-snap.spec.ts              | 31 ++++++++++++++++------
 3 files changed, 37 insertions(+), 9 deletions(-)

diff --git a/app/features/os/components/WindowFrame.vue b/app/features/os/components/WindowFrame.vue
index 8b32fdd..3b7b7e9 100644
--- a/app/features/os/components/WindowFrame.vue
+++ b/app/features/os/components/WindowFrame.vue
@@ -126,7 +126,20 @@ function onPointerMove(event: PointerEvent): void {
     armed.value = true;
   }
   if (props.win.preSnap) {
+    // Windows-style unsnap (NEXT.md 3.2): restore the saved size, then
+    // re-place the window so the pointer keeps its relative spot on the
+    // title bar instead of teleporting to the stale pre-snap origin.
+    const pre = props.win.preSnap;
+    const fracX = clamp((event.clientX - props.win.x) / props.win.width, 0, 1);
+    const grabY = clamp(event.clientY - props.win.y, 0, 30); // stays in the 36px header
     store.unsnapWindow(props.win.id);
+    store.moveWindow(
+      props.win.id,
+      event.clientX - clamp(fracX * pre.width, 8, pre.width - 8),
+      event.clientY - grabY,
+    );
+    snapZone.value = zoneAt(event.clientX, event.clientY);
+    return;
   }
   const handle = dragHandle.value;
   if (!handle) return;
diff --git a/app/features/os/stores/os.ts b/app/features/os/stores/os.ts
index 54b1e04..01a6fec 100644
--- a/app/features/os/stores/os.ts
+++ b/app/features/os/stores/os.ts
@@ -118,7 +118,7 @@ export const useOsStore = defineStore("os", () => {
       if (!win.preSnap) {
         win.preSnap = {
           x: win.state === "maximized" ? (window.innerWidth - win.width) / 2 : win.x,
-          y: win.y,
+          y: win.state === "maximized" ? 0 : win.y,
           width: win.width,
           height: win.state === "maximized" ? vh : win.height,
         };
diff --git a/tests/e2e/window-snap.spec.ts b/tests/e2e/window-snap.spec.ts
index e9d5896..dd229b1 100644
--- a/tests/e2e/window-snap.spec.ts
+++ b/tests/e2e/window-snap.spec.ts
@@ -51,16 +51,24 @@ test('drag to edges snaps halves, corners, top; drag away restores', async ({ pa
     const box = await handle.boundingBox()
     await page.mouse.move(box!.x + box!.width / 2, box!.y + box!.height / 2)
     await page.mouse.down()
-    await page.mouse.move(box!.x + box!.width / 2 + 200, box!.y + 200, { steps: 6 })
+    // Track where the pointer ends up: 200px right and down from the grab.
+    const px = box!.x + box!.width / 2 + 200
+    const py = box!.y + box!.height / 2 + 200
+    await page.mouse.move(px, py, { steps: 6 })
     await page.mouse.up()
 
     const after = await win.boundingBox()
     expect(after, `after=${JSON.stringify(after)} before=${JSON.stringify(before)}`).toBeTruthy()
-    // The pre-snap geometry (the rect the window had mid-drag when the
-    // zone fired) comes back: full original size, no longer at x=0.
+    // The pre-snap geometry comes back: full original size, no longer at
+    // x=0, and the title bar stays under the pointer (review guard).
     expect(after!.width).toBe(restored.width)
     expect(after!.height).toBe(restored.height)
     expect(after!.x).not.toBe(0)
+    const header = await handle.boundingBox()
+    expect(header!.x).toBeLessThanOrEqual(px)
+    expect(header!.x + header!.width).toBeGreaterThanOrEqual(px)
+    expect(header!.y).toBeLessThanOrEqual(py)
+    expect(header!.y + header!.height).toBeGreaterThanOrEqual(py)
   })
 
   await test.step('drag to the top-left corner snaps a quarter', async () => {
@@ -129,19 +137,26 @@ test('snapped windows ignore in-band grabs and jitter', async ({ page }) => {
     expect(after!.width).toBe(before!.width)
   })
 
-  await test.step('dragging away restores the pre-snap rect including y', async () => {
+    await test.step('dragging away restores the pre-snap rect including y', async () => {
     const handle = win.locator('header')
     const box = await handle.boundingBox()
     await page.mouse.move(box!.x + box!.width / 2, box!.y + box!.height / 2)
     await page.mouse.down()
-    await page.mouse.move(box!.x + box!.width / 2 + 200, box!.y + 200, { steps: 6 })
+    const px = box!.x + box!.width / 2 + 200
+    const py = box!.y + box!.height / 2 + 200
+    await page.mouse.move(px, py, { steps: 6 })
     await page.mouse.up()
 
     const after = await win.boundingBox()
     expect(after!.width).toBe(520)
     expect(after!.height).toBe(560)
-    // Pre-snap y (382 here) + pointer travel delta: the preSnap.y=0 bug
-    // m-vawter measured would land near y=200 instead of y=582.
-    expect(after!.y).toBeGreaterThan(500)
+    // Windows-style restore: the pointer keeps its title-bar grab spot, so
+    // the restored window's header still contains the pointer (review
+    // guard). The stale-origin bug teleported it away from the pointer.
+    const header = await handle.boundingBox()
+    expect(header!.x).toBeLessThanOrEqual(px)
+    expect(header!.x + header!.width).toBeGreaterThanOrEqual(px)
+    expect(header!.y).toBeLessThanOrEqual(py)
+    expect(header!.y + header!.height).toBeGreaterThanOrEqual(py)
   })
 })