Merge branch 'main' into feat/soft-todo-leaky-bucket

Author: nedtwigg

docs/specs/layout.md

@@ -297,14 +297,14 @@ When a pane is added, its dockview group element gets a directional `.pane-spawn
 
 The direction is carried via `FreshlySpawnedContext` — a `Map<paneId, SpawnDirection>` written by the spawn call site and consumed once by `TerminalPanel`'s `useLayoutEffect` on first mount.
 
-### Kill (ghost fade + FLIP reclaim)
+### Kill (in-place fade + FLIP reclaim)
 
-`orchestrateKill(api, killedId)` in `Pond.tsx` runs on kill confirmation:
+`orchestrateKill(api, killedId)` in `Pond.tsx` runs on kill confirmation. It fades the real pane element in place (its content dissolves against the same-colored background), then removes the panel and FLIP-reveals the survivors:
 
-1. Snapshot `getBoundingClientRect` for every other panel's group element.
-2. `destroyTerminal` + `api.removePanel`; dockview snaps the layout.
-3. Measure post-rects. Any panel whose rect grew is a "grower."
-4. Mount a solid `var(--color-surface)` ghost overlay at the killed rect (`position: fixed`, `z-index: 55`) with the `.pane-fading-out` class; it removes itself on `animationend` with a 1s timeout safety net. A uniform fade works for every case (edge/middle/last-pane kill) because the directional cue is already carried by the grower's FLIP reveal.
+1. Add `.pane-fading-out` (or `.pane-fading-and-shrinking-to-br` for a last-pane kill) to the killed pane's group element. Block pointer events during the fade.
+2. On `animationend`, snapshot `getBoundingClientRect` for every surviving panel's group element.
+3. `destroyTerminal` + `api.removePanel`; dockview snaps the layout.
+4. Measure post-rects. Any panel whose rect grew is a "grower."
 5. For each grower, apply an inline `clip-path: inset(...)` with the newly-claimed territory clipped off, force a reflow, then transition to `inset(0)`. This reveals the grower into the vacated space without affecting `getBoundingClientRect`. Clears on `transitionend`.
 
 Case handling is purely rect-based (measure before and after removal), so 2-pane splits, linear 3+ rows/columns, and nested splits all fall through the same code path with no per-case branching.
@@ -326,7 +326,7 @@ The deferred spawn also only calls `selectPanel` if selection is null. The kill
 7. **Asymmetric back-navigation**: breadcrumb tracks last direction + origin for opposite-direction return.
 8. **Center drop merges panels**: intercepted at group-level `model.onWillDrop` and converted to a swap.
 9. **Group drag has null panelId**: falls back to `api.getGroup(groupId).activePanel.id`.
-10. **Auto-spawn on empty**: `onDidRemovePanel` creates a new session whenever the last visible pane is removed, whether or not doors exist — there is always a pane visible. The new pane receives the just-removed pane's id as `paneToCopy` for future cwd/terminal-kind inheritance. The `addPanel` call is delayed 440ms (see "Auto-spawn delay" under Animations) so the outgoing kill/detach animation finishes first.
+10. **Auto-spawn on empty**: `onDidRemovePanel` creates a new session whenever the last visible pane is removed, whether or not doors exist — there is always a pane visible. The `addPanel` call is delayed 440ms (see "Auto-spawn delay" under Animations) so the outgoing kill/detach animation finishes first.
 11. **Door focus survives auto-spawn**: `api.addPanel` auto-activates the new panel, firing `onDidActivePanelChange`. When the current selection is a door (e.g., just-detached last pane), that listener must not flip `selectedId` to the new pane — otherwise `selectedType === 'door'` + `selectedId === newPaneId` desyncs and the door loses its highlight while the SelectionOverlay is stuck on the stale door rect. The listener early-returns when `selectedType === 'door'`.
 
 ## Files

lib/src/components/Pond.tsx

@@ -1142,10 +1142,6 @@ export function Pond({
     return `pane-${(++paneCounterRef.current).toString(36)}-${Math.random().toString(36).substring(2, 7)}`;
   }, []);
 
-  // newPaneId -> sourcePaneId for panes born from a split or the empty-state auto-spawn.
-  // Nothing reads this yet; it exists so future work can copy cwd / terminal kind from the source.
-  const paneToCopyByIdRef = useRef(new Map<string, string>());
-
   // Ids of panes that were just spawned, keyed by id with the direction the spawn
   // should reveal from. TerminalPanel consumes its id on first mount to play the
   // matching directional entrance animation.
@@ -1484,9 +1480,7 @@ export function Pond({
     });
 
     // Always keep one pane visible: when the last visible pane is removed (killed
-    // or detached), spawn a fresh one — regardless of whether doors exist. Carry
-    // the just-removed pane's id forward as paneToCopy so future work can copy
-    // cwd / terminal kind from it.
+    // or detached), spawn a fresh one — regardless of whether doors exist.
     //
     // Delay the spawn by the kill/detach animation duration so the two animations
     // don't overlap — the outgoing pane crushes/fades first, then the new pane
@@ -1501,7 +1495,6 @@ export function Pond({
       const spawn = () => {
         if (e.api.totalPanels > 0) return;
         const id = generatePaneId();
-        paneToCopyByIdRef.current.set(id, removed.id);
         freshlySpawnedRef.current.set(id, 'top-left');
         e.api.addPanel({ id, component: 'terminal', tabComponent: 'terminal', title: '<unnamed>' });
         // Only steal focus if nothing is selected (i.e., the kill path, which
@@ -1950,7 +1943,6 @@ export function Pond({
     if (!api) return;
     const newId = generatePaneId();
     const ref = id && api.getPanel(id) ? id : null;
-    if (ref) paneToCopyByIdRef.current.set(newId, ref);
     // Horizontal split places the new pane to the right → reveal from its left edge.
     // Vertical split places it below → reveal from its top edge.
     freshlySpawnedRef.current.set(newId, direction === 'right' ? 'left' : 'top');