Method forceRedraw

src/ink/ink.tsx:948–975

* Clear the physical terminal and force a full redraw. * * The traditional readline ctrl+l — redraws the current content from home. * Also the recovery path when the terminal was cleared externally * (macOS Cmd+K) and Ink's diff engine thinks unchanged cells don't need * repainting. S

(options?: { clearBeforePaint?: boolean; forceHomeRepaint?: boolean })

   * repainting. Scrollback is preserved.
   */
  forceRedraw(options?: { clearBeforePaint?: boolean; forceHomeRepaint?: boolean }): void {
    if (!this.options.stdout.isTTY || this.isUnmounted || this.isPaused) return;
    if (this.altScreenActive) {
      // Alt-screen force redraw should not toggle mode 1049. Keep recovery
      // in-band with the next frame so terminals that treat ?1049h as a
      // clear while already in alt do not flash blank.
      const recoveryMode = getAltScreenRecoveryRepaintMode(
        SYNC_OUTPUT_SUPPORTED,
      );
      this.resetFramesForAltScreen();
      this.altScreenPendingRepaintMode = recoveryMode;
      if (this.altScreenMouseTracking) {
        this.options.stdout.write(ENABLE_MOUSE_TRACKING);
      }
    } else {
      // Main-screen force redraw should follow the same in-band repair path
      // as other recovery flows. Clearing first flashes blank on common
      // terminals even though the next frame can already repaint the
      // viewport from home.
      this.displayCursor = null;
      this.mainScreenPendingRepaintFromHome = true;
      this.mainScreenPendingClearBeforePaint = !!options?.clearBeforePaint;
      if (options?.forceHomeRepaint) {
        this.mainScreenPendingForceHomeRepaint = true;
      }
    }
    this.onRender();
  }

  /**
   * Mark the previous frame as untrustworthy for blit, forcing the next