NetMesh/components/terminalPaneVisibility.ts

import { activeTabStore } from "../application/state/activeTabStore";
import type { Workspace } from "../types";

export const HIDDEN_TERMINAL_PANE_SNAPSHOT = "hidden";

export type TerminalPaneSnapshot =
  | typeof HIDDEN_TERMINAL_PANE_SNAPSHOT
  | `solo|${string}`
  | `workspace|split|${string}`
  | `workspace|focus|${string}|${string}`;

export type TerminalPaneFocusSnapshot = "na" | "focused" | "unfocused";

export type TerminalPaneHiddenSize = {
  width: number;
  height: number;
};

export type TerminalPaneStyle = {
  left?: string | number;
  top?: string | number;
  width?: string | number;
  height?: string | number;
  visibility?: string;
  transform?: string;
  pointerEvents?: string;
  zIndex?: number;
};

export function shouldUseTerminalPaneSplitLayout({
  workspace,
}: {
  workspace: Workspace | undefined;
  sessionId: string;
  isVisible: boolean;
  hibernateHiddenTabs: boolean;
}): boolean {
  if (!workspace) return false;
  // Default viewMode is tiled split (including undefined from createWorkspaceFromSessions).
  // Focus mode never uses split geometry: every pane is viewed full-size, so hidden
  // panes must keep full-size geometry too. Laying continuously rendered background
  // panes out at their split rects shrank the live xterm and the remote PTY to a
  // 1/N-width fragment, so \r-refresh progress output (e.g. rsync --info=progress2)
  // soft-wrapped and left one scrollback line per refresh (#3046).
  return workspace.viewMode !== "focus";
}

export function shouldMeasureTerminalLayerLayout({
  isTerminalLayerVisible,
  keepHiddenLayoutActive,
  workspaceArea,
}: {
  isTerminalLayerVisible: boolean;
  keepHiddenLayoutActive: boolean;
  workspaceArea: TerminalPaneHiddenSize;
}): boolean {
  return isTerminalLayerVisible
    || (keepHiddenLayoutActive && (workspaceArea.width <= 0 || workspaceArea.height <= 0));
}

export function resolveInactiveTerminalPaneStyle<T extends TerminalPaneStyle>(
  layoutStyle: T,
  lastVisibleSize: TerminalPaneHiddenSize | null,
  hibernateHiddenTabs: boolean,
  preserveLastVisibleSize = false,
): T {
  return {
    ...layoutStyle,
    // Keep the measured box and live parser, but move the screen outside the
    // viewport so xterm's IntersectionObserver pauses rendering. Occlusion and
    // visibility:hidden alone do not stop xterm's WebGL refreshes.
    // Reset cached split offsets before translating: they can exceed the current
    // viewport after a window shrinks. Translate by both pane and viewport width,
    // including pinned panes wider than a window resized in the background.
    left: 0,
    transform: "translateX(calc(-100vw - 100%))",
    visibility: hibernateHiddenTabs ? "hidden" : "visible",
    pointerEvents: "none",
    zIndex: 0,
    ...((hibernateHiddenTabs || preserveLastVisibleSize) && lastVisibleSize
      ? {
        width: `${lastVisibleSize.width}px`,
        height: `${lastVisibleSize.height}px`,
      }
      : {}),
  };
}

export function resolveTerminalLayerSurfaceStyle(
  isActive: boolean,
  hibernateHiddenTabs: boolean,
): { visibility: "visible" | "hidden"; pointerEvents: "auto" | "none"; zIndex: number } {
  return {
    visibility: isActive || !hibernateHiddenTabs ? "visible" : "hidden",
    pointerEvents: isActive ? "auto" : "none",
    zIndex: isActive ? 10 : 0,
  };
}

interface GetTerminalPaneSnapshotOptions {
  activeTabId: string | null;
  sessionId: string;
  sessionWorkspaceId?: string;
  workspaceById: Map<string, Workspace>;
  isTerminalLayerVisible: boolean;
}

export function getTerminalPaneSnapshot({
  activeTabId,
  sessionId,
  sessionWorkspaceId,
  workspaceById,
  isTerminalLayerVisible,
}: GetTerminalPaneSnapshotOptions): TerminalPaneSnapshot {
  if (!isTerminalLayerVisible || !activeTabId) {
    return HIDDEN_TERMINAL_PANE_SNAPSHOT;
  }

  const activeWorkspace = workspaceById.get(activeTabId);
  if (activeWorkspace) {
    if (sessionWorkspaceId !== activeWorkspace.id) {
      return HIDDEN_TERMINAL_PANE_SNAPSHOT;
    }

    const focusedSessionId = activeWorkspace.focusedSessionId ?? "";
    if (activeWorkspace.viewMode === "focus") {
      return sessionId === focusedSessionId
        ? `workspace|focus|${activeWorkspace.id}|${focusedSessionId}`
        : HIDDEN_TERMINAL_PANE_SNAPSHOT;
    }

    return `workspace|split|${activeWorkspace.id}`;
  }

  return activeTabId === sessionId
    ? `solo|${sessionId}`
    : HIDDEN_TERMINAL_PANE_SNAPSHOT;
}

export function parseTerminalPaneSnapshot(snapshot: TerminalPaneSnapshot): {
  isVisible: boolean;
  mode: "hidden" | "solo" | "split" | "focus";
  workspaceId: string | null;
  focusedSessionId: string | null;
} {
  if (snapshot === HIDDEN_TERMINAL_PANE_SNAPSHOT) {
    return {
      isVisible: false,
      mode: "hidden",
      workspaceId: null,
      focusedSessionId: null,
    };
  }

  const parts = snapshot.split("|");
  if (parts[0] === "solo") {
    return {
      isVisible: true,
      mode: "solo",
      workspaceId: null,
      focusedSessionId: null,
    };
  }

  if (parts[1] === "focus") {
    return {
      isVisible: true,
      mode: "focus",
      workspaceId: parts[2] || null,
      focusedSessionId: parts[3] || null,
    };
  }

  return {
    isVisible: true,
    mode: "split",
    workspaceId: parts[2] || null,
    focusedSessionId: null,
  };
}

export function getTerminalPaneFocusSnapshot({
  activeTabId: activeTabIdOverride,
  sessionId,
  sessionWorkspaceId,
  workspaceById,
}: {
  activeTabId?: string | null;
  sessionId: string;
  sessionWorkspaceId?: string;
  workspaceById: Map<string, Workspace>;
}): TerminalPaneFocusSnapshot {
  const activeTabId = activeTabIdOverride ?? activeTabStore.getActiveTabId();
  if (!activeTabId) return "na";

  const activeWorkspace = workspaceById.get(activeTabId);
  if (!activeWorkspace || activeWorkspace.viewMode === "focus") return "na";
  if (sessionWorkspaceId !== activeWorkspace.id) return "na";

  return activeWorkspace.focusedSessionId === sessionId ? "focused" : "unfocused";
}

/** Combined visibility + focus snapshot for a single useSyncExternalStore subscription. */
export function getTerminalPaneRenderSnapshot(
  options: GetTerminalPaneSnapshotOptions,
): string {
  const pane = getTerminalPaneSnapshot(options);
  if (pane === HIDDEN_TERMINAL_PANE_SNAPSHOT) {
    return HIDDEN_TERMINAL_PANE_SNAPSHOT;
  }
  const focus = getTerminalPaneFocusSnapshot({
    activeTabId: options.activeTabId,
    sessionId: options.sessionId,
    sessionWorkspaceId: options.sessionWorkspaceId,
    workspaceById: options.workspaceById,
  });
  return `${pane}|${focus}`;
}

export function parseTerminalPaneRenderSnapshot(snapshot: string): {
  paneState: ReturnType<typeof parseTerminalPaneSnapshot>;
  isFocusedPane: boolean;
} {
  if (snapshot === HIDDEN_TERMINAL_PANE_SNAPSHOT) {
    return {
      paneState: parseTerminalPaneSnapshot(HIDDEN_TERMINAL_PANE_SNAPSHOT),
      isFocusedPane: false,
    };
  }

  const focusSep = snapshot.lastIndexOf("|");
  const focusToken = snapshot.slice(focusSep + 1);
  const paneSnapshot = snapshot.slice(0, focusSep) as TerminalPaneSnapshot;
  const paneState = parseTerminalPaneSnapshot(paneSnapshot);

  return {
    paneState,
    isFocusedPane: focusToken === "focused",
  };
}