/** * Session switch logic for dockview layout management. * * Handles both a "fast path" (skip fromJSON when layout structure matches) * and a "slow path" (full layout rebuild via fromJSON). */ import type { DockviewApi, SerializedDockview } from "dockview-react"; import { getSessionLayout } from "@/lib/local-storage"; import { applyLayoutFixups } from "./dockview-layout-builders"; import { fromDockviewApi, savedLayoutMatchesLive, layoutStructuresMatch } from "./layout-manager"; import type { LayoutState, LayoutGroupIds } from "./layout-manager"; export type SessionSwitchParams = { api: DockviewApi; oldSessionId: string | null; newSessionId: string; safeWidth: number; safeHeight: number; buildDefault: (api: DockviewApi) => void; getDefaultLayout: () => LayoutState; }; /** * Remove ephemeral panels (file-editors, diffs, commit-details) from the * live layout. These are session-specific panels that shouldn't carry over. */ function removeEphemeralPanels(api: DockviewApi): void { const toRemove = api.panels.filter((p) => { const comp = p.api.component; return ( comp === "file-editor" || comp === "diff-viewer" || comp === "commit-detail" || comp === "pr-detail" ); }); for (const p of toRemove) { try { p.api.close(); } catch { /* panel may already be gone */ } } } /** * Fast path: check if we can skip `api.fromJSON()` because the layout * structure hasn't changed. Returns group IDs if the fast path was taken, * or null if a full rebuild is needed. */ function tryFastSessionSwitch(params: SessionSwitchParams): LayoutGroupIds | null { const { api, newSessionId, getDefaultLayout } = params; const currentLayout = fromDockviewApi(api); const saved = getSessionLayout(newSessionId); let structuresMatch = false; if (saved) { // Compare live layout against saved layout by structural component set structuresMatch = savedLayoutMatchesLive(currentLayout, saved as SerializedDockview); } else { // No saved layout — target is the default; compare LayoutState structures structuresMatch = layoutStructuresMatch(currentLayout, getDefaultLayout()); } if (!structuresMatch) return null; // Fast path: keep the grid structure, just clean up ephemeral panels. // Session-scoped portals (terminal, browser, etc.) will be re-acquired // via usePortalSlot's sessionId dependency change. removeEphemeralPanels(api); return applyLayoutFixups(api); } /** * Switch the dockview layout between sessions. * * Uses a fast path when layouts are structurally identical (common case), * falling back to a full `api.fromJSON()` rebuild when they differ. * * The caller is responsible for saving the old session layout and releasing * session-scoped portals before calling this function. */ export function performSessionSwitch(params: SessionSwitchParams): LayoutGroupIds { const { api, newSessionId, safeWidth, safeHeight, buildDefault } = params; // Try fast path: skip fromJSON when layout structure hasn't changed const fastResult = tryFastSessionSwitch(params); if (fastResult) return fastResult; // Slow path: full layout rebuild via fromJSON const saved = getSessionLayout(newSessionId); if (saved) { try { api.fromJSON(saved as SerializedDockview); api.layout(safeWidth, safeHeight); return applyLayoutFixups(api); } catch { /* fall through */ } } buildDefault(api); api.layout(safeWidth, safeHeight); return applyLayoutFixups(api); }