NetMesh/components/terminal/terminalContinuousRendering.test.ts

import assert from "node:assert/strict";
import { readFileSync } from "node:fs";
import test from "node:test";

const terminalSource = readFileSync(new URL("../Terminal.tsx", import.meta.url), "utf8");
const effectsSource = readFileSync(new URL("./useTerminalEffects.ts", import.meta.url), "utf8");
const supportSource = readFileSync(new URL("../terminalLayer/TerminalLayerSupport.tsx", import.meta.url), "utf8");
const viewSource = readFileSync(new URL("../terminalLayer/TerminalLayerView.tsx", import.meta.url), "utf8");
const tabBridgeSource = readFileSync(new URL("../terminalLayer/TerminalLayerTabBridge.tsx", import.meta.url), "utf8");
const workspaceLayoutSource = readFileSync(new URL("../terminalLayer/useTerminalWorkspaceLayout.ts", import.meta.url), "utf8");
const layerEffectsSource = readFileSync(new URL("../terminalLayer/useTerminalLayerEffects.ts", import.meta.url), "utf8");

test("renderer activity follows the hibernate setting instead of active-tab visibility", () => {
  assert.match(
    terminalSource,
    /const isRendererActive = isVisible \|\| !hibernateEnabled/,
  );
  assert.match(terminalSource, /isPaneVisibleRef: isVisibleRef/);
  assert.match(terminalSource, /isVisibleRef: isRendererActiveRef/);
  assert.match(terminalSource, /if \(!isRendererActiveRef\.current && !options\?\.allowHidden\)/);
  assert.match(
    effectsSource,
    /const isRendererActive = isVisible \|\| !hibernateHiddenTabs;[\s\S]*const isRendererActiveRef = useRef\(isRendererActive\)/,
  );
});

test("inactive terminal surfaces remain mounted and non-interactive without hibernate", () => {
  assert.match(supportSource, /resolveTerminalHibernateEnabledForProtocol\(terminalSettings, host\.protocol\)/);
  assert.match(
    supportSource,
    /inert=\{isVisible && !isCoveredByMagnification \? undefined : true\}/,
  );
  assert.match(viewSource, /ctx\.hibernateHiddenTabs/);
  assert.match(viewSource, /inert=\{ctx\.isTerminalLayerVisible \? undefined : true\}/);
});

test("background split workspaces keep their live geometry without hibernate", () => {
  assert.match(
    tabBridgeSource,
    /shouldKeepHiddenWorkspaceLaidOut/,
  );
  assert.match(
    workspaceLayoutSource,
    /if \(shouldKeepHiddenWorkspaceLaidOut\(workspace\)\) \{[\s\S]*cachedSizeIsUsable[\s\S]*computeWorkspaceRects\(layoutWorkspace, layoutSize\)/,
  );
  assert.match(
    supportSource,
    /const layoutWorkspaceId = activeWorkspaceId \?\? \(!hibernateHiddenTabs \? session\.workspaceId : undefined\)/,
  );
  assert.match(supportSource, /inWorkspace=\{keepsWorkspacePresentation\}/);
  assert.match(
    supportSource,
    /isWorkspaceComposeBarOpen=\{inActiveWorkspace \? isComposeBarOpen : undefined\}/,
  );
  assert.match(
    supportSource,
    /shouldUseTerminalPaneSplitLayout\(\{[\s\S]*workspace: layoutWorkspace,[\s\S]*sessionId: session\.id,[\s\S]*isVisible,[\s\S]*hibernateHiddenTabs/,
  );
  assert.match(
    supportSource,
    /const initializeHiddenFullSize = !hibernateHiddenTabs[\s\S]*&& !rect[\s\S]*&& !lastVisiblePaneSizeRef\.current;[\s\S]*bumpHiddenPaneSizeVersion/,
  );
  // Split rects must never feed the hidden-pane pinned size, or a
  // split -> focus viewMode switch pins hidden panes (and their PTYs) at the
  // cached fragment width (#3046).
  assert.match(
    supportSource,
    /if \(isVisible && !rect\) \{[\s\S]*const observer = new ResizeObserver\(\(\) => \{[\s\S]*capturePaneSize\(\)/,
  );
  // A split-visible pane must drop the cached full-size measurement so a later
  // hidden full-size layout re-measures the current area instead of pinning
  // stale pixels (#3046).
  assert.match(
    supportSource,
    /if \(isVisible\) \{[\s\S]{0,400}lastVisiblePaneSizeRef\.current = null;[\s\S]{0,20}return;/,
  );
  assert.match(
    layerEffectsSource,
    /if \(!shouldMeasureTerminalLayerLayout\) return;[\s\S]*?remeasureWorkspaceArea\(\)/,
  );
  assert.match(
    tabBridgeSource,
    /const keepHiddenLayoutActive = !hibernateHiddenTabs \|\| localWorkspaceIds\.size > 0/,
  );
  assert.match(
    tabBridgeSource,
    /shouldMeasureTerminalLayerLayout: shouldMeasureTerminalLayerLayout\(\{[\s\S]*keepHiddenLayoutActive,[\s\S]*workspaceArea/,
  );
  assert.doesNotMatch(tabBridgeSource, /isTerminalLayerRendererActive/);
});