@opentui/core 0.2.3 → 0.2.5

package/{index-hmk8xzt3.js → index-s460mpf9.js}

@@ -7140,6 +7140,9 @@ function canStillBeExplicitWidthCpr(state) {
 function canStillBeStartupCursorCpr(state) {
   return state.semicolons === 1;
 }
+function canStillBeStartupCursorCprPrefix(state) {
+  return state.segments === 1 && state.semicolons <= 1;
+}
 function canStillBePixelResolution(state) {
   return state.firstParamValue === 4 && state.semicolons === 2;
 }
@@ -7290,6 +7293,61 @@ class StdinParser {
     this.reconcileDeferredStateWithProtocolContext();
     this.reconcileTimeoutState();
   }
+  getAbortableStartupCursorCprState() {
+    if (this.pending.length === 0) {
+      return null;
+    }
+    switch (this.state.tag) {
+      case "csi": {
+        const bytes = this.pending.view();
+        const firstParamStart = this.unitStart + 2;
+        if (this.cursor < firstParamStart) {
+          return null;
+        }
+        let firstParamValue = null;
+        for (let index = firstParamStart;index < this.cursor; index += 1) {
+          const byte = bytes[index];
+          if (!isAsciiDigit(byte)) {
+            return null;
+          }
+          firstParamValue = (firstParamValue ?? 0) * 10 + (byte - 48);
+        }
+        return {
+          tag: "csi_parametric_ignored",
+          semicolons: 0,
+          segments: 1,
+          hasDigit: this.cursor > firstParamStart,
+          firstParamValue
+        };
+      }
+      case "csi_parametric":
+      case "csi_parametric_deferred":
+        if (!canStillBeStartupCursorCprPrefix(this.state) || this.protocolContext.explicitWidthCprActive && canStillBeExplicitWidthCpr(this.state)) {
+          return null;
+        }
+        return {
+          tag: "csi_parametric_ignored",
+          semicolons: this.state.semicolons,
+          segments: this.state.segments,
+          hasDigit: this.state.hasDigit,
+          firstParamValue: this.state.firstParamValue
+        };
+    }
+    return null;
+  }
+  abortPendingStartupCursorCpr() {
+    this.ensureAlive();
+    const nextState = this.getAbortableStartupCursorCprState();
+    if (!nextState) {
+      return;
+    }
+    this.state = nextState;
+    if (this.pendingSinceMs === null) {
+      this.markPending();
+    }
+    this.forceFlush = false;
+    this.reconcileTimeoutState();
+  }
   push(data) {
     this.ensureAlive();
     if (data.length === 0) {
@@ -7826,6 +7884,61 @@ class StdinParser {
           this.consumePrefix(this.cursor);
           continue;
         }
+        case "csi_parametric_ignored": {
+          if (this.cursor >= bytes.length) {
+            if (!this.forceFlush) {
+              this.markPending();
+              return;
+            }
+            this.state = { tag: "ground" };
+            this.consumePrefix(this.cursor);
+            continue;
+          }
+          if (byte === ESC) {
+            this.state = { tag: "ground" };
+            this.consumePrefix(this.cursor);
+            continue;
+          }
+          if (isAsciiDigit(byte)) {
+            this.cursor += 1;
+            this.state = {
+              tag: "csi_parametric_ignored",
+              semicolons: this.state.semicolons,
+              segments: this.state.segments,
+              hasDigit: true,
+              firstParamValue: this.state.semicolons === 0 ? (this.state.firstParamValue ?? 0) * 10 + (byte - 48) : this.state.firstParamValue
+            };
+            continue;
+          }
+          if (byte === 59 && this.state.semicolons === 0 && this.state.hasDigit) {
+            if (this.protocolContext.explicitWidthCprActive && this.state.firstParamValue === 1) {
+              this.state = { tag: "csi" };
+              continue;
+            }
+            this.cursor += 1;
+            this.state = {
+              tag: "csi_parametric_ignored",
+              semicolons: 1,
+              segments: 1,
+              hasDigit: false,
+              firstParamValue: this.state.firstParamValue
+            };
+            continue;
+          }
+          if (byte === 82 && this.state.semicolons === 1 && this.state.hasDigit) {
+            const end = this.cursor + 1;
+            this.state = { tag: "ground" };
+            this.consumePrefix(end);
+            continue;
+          }
+          if (this.state.semicolons === 0) {
+            this.state = { tag: "csi" };
+            continue;
+          }
+          this.state = { tag: "ground" };
+          this.consumePrefix(this.cursor);
+          continue;
+        }
         case "csi_private_reply": {
           if (this.cursor >= bytes.length) {
             if (!this.forceFlush) {
@@ -12615,8 +12728,12 @@ function getOpenTUILib(libPath) {
       args: ["ptr", "u32"],
       returns: "u32"
     },
+    getSplitOutputOffset: {
+      args: ["ptr", "u32"],
+      returns: "u32"
+    },
     setPendingSplitFooterTransition: {
-      args: ["ptr", "u8", "u32", "u32", "u32", "u32"],
+      args: ["ptr", "u8", "u32", "u32", "u32", "u32", "u32"],
       returns: "void"
     },
     clearPendingSplitFooterTransition: {
@@ -13882,8 +13999,11 @@ class FFIRenderLib {
   syncSplitScrollback(renderer, pinnedRenderOffset) {
     return this.opentui.symbols.syncSplitScrollback(renderer, pinnedRenderOffset);
   }
-  setPendingSplitFooterTransition(renderer, mode, sourceTopLine, sourceHeight, targetTopLine, targetHeight) {
-    this.opentui.symbols.setPendingSplitFooterTransition(renderer, mode, sourceTopLine, sourceHeight, targetTopLine, targetHeight);
+  getSplitOutputOffset(renderer, surfaceOffset) {
+    return this.opentui.symbols.getSplitOutputOffset(renderer, surfaceOffset);
+  }
+  setPendingSplitFooterTransition(renderer, mode, sourceTopLine, sourceHeight, targetTopLine, targetHeight, scrollLines) {
+    this.opentui.symbols.setPendingSplitFooterTransition(renderer, mode, sourceTopLine, sourceHeight, targetTopLine, targetHeight, scrollLines);
   }
   clearPendingSplitFooterTransition(renderer) {
     this.opentui.symbols.clearPendingSplitFooterTransition(renderer);
@@ -21380,6 +21500,9 @@ class ExternalOutputQueue {
   writeSnapshot(commit) {
     this.commits.push(commit);
   }
+  peek() {
+    return this.commits;
+  }
   claim(limit = Number.POSITIVE_INFINITY) {
     if (this.commits.length === 0) {
       return [];
@@ -21721,6 +21844,8 @@ class CliRenderer extends EventEmitter9 {
   clearOnShutdown = true;
   _suspendedMouseEnabled = false;
   _previousControlState = "idle" /* IDLE */;
+  pendingSuspendedTerminalSetup = false;
+  suspendedNonAltSurfacePreserved = false;
   capturedRenderable;
   lastOverRenderableNum = 0;
   lastOverRenderable;
@@ -21737,6 +21862,7 @@ class CliRenderer extends EventEmitter9 {
   _terminalHeight = 0;
   _terminalIsSetup = false;
   externalOutputQueue = new ExternalOutputQueue;
+  pendingExternalOutputMode = null;
   realStdoutWrite;
   _useConsole = true;
   sigwinchHandler = (() => {
@@ -22205,6 +22331,13 @@ Captured external output:
   }
   set screenMode(mode) {
     if (this.externalOutputMode === "capture-stdout" && mode !== "split-footer") {
+      if (this.pendingExternalOutputMode === "passthrough") {
+        this.flushPendingSplitOutputBeforeLeavingSplitFooter();
+      }
+      if (this.externalOutputMode !== "capture-stdout") {
+        this.applyScreenMode(mode);
+        return;
+      }
       throw new Error('externalOutputMode "capture-stdout" requires screenMode "split-footer"');
     }
     this.applyScreenMode(mode);
@@ -22231,16 +22364,49 @@ Captured external output:
     }
     const previousMode = this._externalOutputMode;
     if (previousMode === mode) {
+      if (this.pendingExternalOutputMode !== null && this.pendingExternalOutputMode !== mode) {
+        this.pendingExternalOutputMode = null;
+      }
+      return;
+    }
+    const canFlushSplitOutputBeforeTransition = this.canFlushSplitOutputBeforeTransition();
+    const isSplitCaptureToPassthrough = previousMode === "capture-stdout" && mode === "passthrough" && this._screenMode === "split-footer" && this._splitHeight > 0;
+    if (isSplitCaptureToPassthrough && this.externalOutputQueue.size > 0 && !canFlushSplitOutputBeforeTransition) {
+      this.pendingExternalOutputMode = "passthrough";
       return;
     }
-    if (previousMode === "capture-stdout" && mode === "passthrough" && this._splitHeight > 0) {
+    if (isSplitCaptureToPassthrough && canFlushSplitOutputBeforeTransition) {
       this.flushPendingSplitOutputBeforeTransition();
     }
+    this.pendingExternalOutputMode = null;
+    this.applyExternalOutputMode(mode);
+    this.afterExternalOutputModeChanged(previousMode, mode);
+  }
+  applyExternalOutputMode(mode) {
     this._externalOutputMode = mode;
     this.stdout.write = mode === "capture-stdout" ? this.interceptStdoutWrite : this.realStdoutWrite;
+  }
+  afterExternalOutputModeChanged(previousMode, mode) {
     if (this._screenMode === "split-footer" && this._splitHeight > 0 && mode === "capture-stdout") {
+      const previousSurfaceTopLine = this.renderOffset + 1;
+      const previousSurfaceHeight = this._splitHeight;
       this.clearPendingSplitFooterTransition();
       this.resetSplitScrollback(this.getSplitCursorSeedRows());
+      if (previousMode === "passthrough" && this._terminalIsSetup) {
+        const nextSurfaceTopLine = this.renderOffset + 1;
+        if (previousSurfaceTopLine !== nextSurfaceTopLine) {
+          this.setPendingSplitFooterTransition({
+            mode: "clear-stale-rows",
+            sourceTopLine: previousSurfaceTopLine,
+            sourceHeight: previousSurfaceHeight,
+            targetTopLine: nextSurfaceTopLine,
+            targetHeight: this._splitHeight,
+            scrollLines: 0
+          });
+          this.forceFullRepaintRequested = true;
+        }
+      }
+      this.requestRender();
       return;
     }
     if (this._screenMode === "split-footer" && this._splitHeight > 0 && previousMode === "capture-stdout" && mode === "passthrough") {
@@ -22249,6 +22415,31 @@ Captured external output:
     }
     this.syncSplitFooterState();
   }
+  applyPendingExternalOutputModeIfReady() {
+    const pendingMode = this.pendingExternalOutputMode;
+    if (pendingMode === null || this.externalOutputQueue.size > 0) {
+      return;
+    }
+    const previousMode = this._externalOutputMode;
+    this.pendingExternalOutputMode = null;
+    if (previousMode === pendingMode) {
+      return;
+    }
+    this.applyExternalOutputMode(pendingMode);
+    this.afterExternalOutputModeChanged(previousMode, pendingMode);
+  }
+  flushPendingSplitOutputBeforeLeavingSplitFooter() {
+    if (this.pendingExternalOutputMode !== "passthrough") {
+      return;
+    }
+    if (this.isSplitCursorSeedFrameBlocked() && this._controlState !== "explicit_suspended" /* EXPLICIT_SUSPENDED */) {
+      this.abortSplitStartupCursorSeed();
+    }
+    this.flushPendingSplitOutputBeforeTransition();
+    if (this.pendingExternalOutputMode !== null) {
+      throw new Error("Cannot leave split-footer while captured output is pending");
+    }
+  }
   get liveRequestCount() {
     return this.liveRequestCounter;
   }
@@ -22284,7 +22475,8 @@ Captured external output:
     const renderer = this;
     const surfaceId = scrollbackSurfaceCounter++;
     const startOnNewLine = options.startOnNewLine ?? true;
-    const firstLineOffset = !startOnNewLine && renderer.splitTailColumn > 0 && renderer.splitTailColumn < renderer.width ? renderer.splitTailColumn : 0;
+    const tailColumn = renderer.getPendingSplitTailColumn();
+    const firstLineOffset = !startOnNewLine && tailColumn > 0 && tailColumn < renderer.width ? tailColumn : 0;
     const snapshotContext = new ScrollbackSnapshotRenderContext(renderer.width, 1, renderer.widthMethod);
     let firstLineOffsetOwner = null;
     const renderContext = Object.create(snapshotContext);
@@ -22473,7 +22665,7 @@ Captured external output:
           snapshot: commitBuffer,
           rowColumns: commitOptions.rowColumns,
           startOnNewLine: nextCommitStartOnNewLine,
-          trailingNewline: commitOptions.trailingNewline ?? false
+          trailingNewline: commitOptions.trailingNewline ?? true
         });
         nextCommitStartOnNewLine = false;
       } catch (error) {
@@ -22537,7 +22729,7 @@ Captured external output:
     const snapshot = write({
       width: this.width,
       widthMethod: this.widthMethod,
-      tailColumn: this.splitTailColumn,
+      tailColumn: this.getPendingSplitTailColumn(),
       renderContext: snapshotContext
     });
     if (!snapshot || !snapshot.root) {
@@ -22624,12 +22816,11 @@ Captured external output:
     }
     return widths;
   }
-  publishSplitTailColumns(columns) {
+  advanceSplitTailColumn(tailColumn, columns, width) {
     if (columns <= 0) {
-      return;
+      return tailColumn;
     }
-    const width = Math.max(this.width, 1);
-    let tail = this.splitTailColumn;
+    let tail = tailColumn;
     let remaining = columns;
     while (remaining > 0) {
       if (tail >= width) {
@@ -22642,19 +22833,32 @@ Captured external output:
         tail = 0;
       }
     }
-    this.splitTailColumn = tail;
+    return tail;
   }
-  recordSplitCommit(commit) {
-    if (commit.startOnNewLine && this.splitTailColumn > 0) {
-      this.splitTailColumn = 0;
+  getSplitTailColumnAfterCommit(commit, initialTailColumn, width) {
+    let tailColumn = initialTailColumn;
+    if (commit.startOnNewLine && tailColumn > 0) {
+      tailColumn = 0;
     }
     const rowWidths = this.getSnapshotRowWidths(commit.snapshot, commit.rowColumns);
     for (const [index, rowWidth] of rowWidths.entries()) {
-      this.publishSplitTailColumns(rowWidth);
+      tailColumn = this.advanceSplitTailColumn(tailColumn, rowWidth, width);
       if (index < rowWidths.length - 1 || commit.trailingNewline) {
-        this.splitTailColumn = 0;
+        tailColumn = 0;
       }
     }
+    return tailColumn;
+  }
+  recordSplitCommit(commit) {
+    this.splitTailColumn = this.getSplitTailColumnAfterCommit(commit, this.splitTailColumn, Math.max(this.width, 1));
+  }
+  getPendingSplitTailColumn() {
+    const width = Math.max(this.width, 1);
+    let tailColumn = this.splitTailColumn;
+    for (const commit of this.externalOutputQueue.peek()) {
+      tailColumn = this.getSplitTailColumnAfterCommit(commit, tailColumn, width);
+    }
+    return tailColumn;
   }
   enqueueRenderedScrollbackCommit(options) {
     if (this._screenMode !== "split-footer" || this._externalOutputMode !== "capture-stdout") {
@@ -22670,7 +22874,6 @@ Captured external output:
     this.requestRender();
   }
   enqueueSplitCommit(commit) {
-    this.recordSplitCommit(commit);
     this.externalOutputQueue.writeSnapshot(commit);
   }
   createStdoutSnapshotCommit(line, trailingNewline) {
@@ -22751,8 +22954,8 @@ Captured external output:
     }
     return commits;
   }
-  flushPendingSplitCommits(forceFooterRepaint = false) {
-    const commits = this.externalOutputQueue.claim(this.maxSplitCommitsPerFrame);
+  flushPendingSplitCommits(forceFooterRepaint = false, drainAll = false) {
+    const commits = this.externalOutputQueue.claim(drainAll ? Number.POSITIVE_INFINITY : this.maxSplitCommitsPerFrame);
     let hasCommittedOutput = false;
     const lastCommitIndex = commits.length - 1;
     for (const [index, commit] of commits.entries()) {
@@ -22761,6 +22964,7 @@ Captured external output:
       const finalizeFrame = index === lastCommitIndex;
       try {
         this.renderOffset = this.lib.commitSplitFooterSnapshot(this.rendererPtr, commit.snapshot, commit.rowColumns, commit.startOnNewLine, commit.trailingNewline, this.getSplitPinnedRenderOffset(), forceCommit, beginFrame, finalizeFrame);
+        this.recordSplitCommit(commit);
         hasCommittedOutput = true;
       } finally {
         commit.snapshot.destroy();
@@ -22772,6 +22976,8 @@ Captured external output:
     this.pendingSplitFooterTransition = null;
     if (this.externalOutputQueue.size > 0) {
       this.requestRender();
+    } else {
+      this.applyPendingExternalOutputModeIfReady();
     }
   }
   interceptStdoutWrite = (chunk, encoding, callback) => {
@@ -22800,14 +23006,37 @@ Captured external output:
     const cursorRow = Number.isFinite(cursorState.y) ? Math.max(Math.trunc(cursorState.y), 1) : 1;
     return Math.min(cursorRow, Math.max(this._terminalHeight, 1));
   }
-  flushPendingSplitOutputBeforeTransition(forceFooterRepaint = false) {
-    if (this._screenMode !== "split-footer" || this._splitHeight <= 0 || this._externalOutputMode !== "capture-stdout") {
+  isSplitCursorSeedFrameBlocked() {
+    return this._screenMode === "split-footer" && this._externalOutputMode === "capture-stdout" && this._splitHeight > 0 && this.pendingSplitStartupCursorSeed && this.splitStartupSeedTimeoutId !== null;
+  }
+  canFlushSplitOutputBeforeTransition(allowSuspended = false) {
+    return this._terminalIsSetup && (allowSuspended || this._controlState !== "explicit_suspended" /* EXPLICIT_SUSPENDED */) && !this.isSplitCursorSeedFrameBlocked();
+  }
+  clearSplitStartupCursorSeed() {
+    this.pendingSplitStartupCursorSeed = false;
+    if (this.splitStartupSeedTimeoutId !== null) {
+      this.clock.clearTimeout(this.splitStartupSeedTimeoutId);
+      this.splitStartupSeedTimeoutId = null;
+    }
+  }
+  abortSplitStartupCursorSeed() {
+    this.clearSplitStartupCursorSeed();
+    this.stdinParser?.abortPendingStartupCursorCpr();
+    this.updateStdinParserProtocolContext({ startupCursorCprActive: false });
+  }
+  flushPendingSplitOutputBeforeTransition(forceFooterRepaint = false, options = {}) {
+    const hasDeferredCapturedOutput = this.externalOutputQueue.size > 0 || this.pendingExternalOutputMode !== null;
+    if (this._screenMode !== "split-footer" || this._splitHeight <= 0 || this._externalOutputMode !== "capture-stdout" && !(options.allowPassthrough && hasDeferredCapturedOutput)) {
+      return;
+    }
+    if (!this.canFlushSplitOutputBeforeTransition(options.allowSuspended ?? false)) {
       return;
     }
     if (this.externalOutputQueue.size === 0 && !forceFooterRepaint) {
+      this.applyPendingExternalOutputModeIfReady();
       return;
     }
-    this.flushPendingSplitCommits(forceFooterRepaint);
+    this.flushPendingSplitCommits(this._externalOutputMode === "capture-stdout" ? forceFooterRepaint : false, true);
   }
   resetSplitScrollback(seedRows = 0) {
     this.splitTailColumn = 0;
@@ -22816,6 +23045,9 @@ Captured external output:
   syncSplitScrollback() {
     this.renderOffset = this.lib.syncSplitScrollback(this.rendererPtr, this.getSplitPinnedRenderOffset());
   }
+  getSplitOutputOffset(surfaceOffset = this.renderOffset) {
+    return this.lib.getSplitOutputOffset(this.rendererPtr, surfaceOffset);
+  }
   clearPendingSplitFooterTransition() {
     if (this.pendingSplitFooterTransition === null) {
       return;
@@ -22825,7 +23057,7 @@ Captured external output:
   }
   setPendingSplitFooterTransition(transition) {
     this.pendingSplitFooterTransition = transition;
-    this.lib.setPendingSplitFooterTransition(this.rendererPtr, transition.mode === "viewport-scroll" ? 1 : 2, transition.sourceTopLine, transition.sourceHeight, transition.targetTopLine, transition.targetHeight);
+    this.lib.setPendingSplitFooterTransition(this.rendererPtr, transition.mode === "viewport-scroll" ? 1 : 2, transition.sourceTopLine, transition.sourceHeight, transition.targetTopLine, transition.targetHeight, transition.scrollLines ?? 0);
   }
   syncSplitFooterState() {
     const splitActive = this._screenMode === "split-footer" && this._splitHeight > 0;
@@ -22878,38 +23110,47 @@ Captured external output:
     if (prevScreenMode === screenMode && prevSplitHeight === nextSplitHeight) {
       return;
     }
+    const terminalWritable = this._terminalIsSetup && this._controlState !== "explicit_suspended" /* EXPLICIT_SUSPENDED */;
     const prevUseAlternateScreen = prevScreenMode === "alternate-screen";
     const nextUseAlternateScreen = screenMode === "alternate-screen";
     const terminalScreenModeChanged = this._terminalIsSetup && prevUseAlternateScreen !== nextUseAlternateScreen;
     const leavingSplitFooter = prevSplitHeight > 0 && nextSplitHeight === 0;
-    if (this._terminalIsSetup && prevSplitHeight > 0) {
+    if (terminalWritable && prevSplitHeight > 0) {
       this.flushPendingSplitOutputBeforeTransition();
     }
     const previousSurfaceTopLine = this.renderOffset + 1;
-    const previousPinnedRenderOffset = Math.max(this._terminalHeight - prevSplitHeight, 0);
-    const splitWasSettled = prevSplitHeight === 0 || this.renderOffset >= previousPinnedRenderOffset;
-    const shouldUseViewportScrollTransitions = this._externalOutputMode !== "capture-stdout" || splitWasSettled;
     const shouldDeferSplitFooterResizeTransition = this._terminalIsSetup && prevScreenMode === "split-footer" && screenMode === "split-footer" && this._externalOutputMode === "capture-stdout" && prevSplitHeight > 0 && nextSplitHeight > 0 && !terminalScreenModeChanged;
     const splitStartupSeedBlocksFirstNativeFrame = this.pendingSplitStartupCursorSeed && this.splitStartupSeedTimeoutId !== null;
     const splitTransitionSourceTopLine = this.pendingSplitFooterTransition?.sourceTopLine ?? previousSurfaceTopLine;
     const splitTransitionSourceHeight = this.pendingSplitFooterTransition?.sourceHeight ?? prevSplitHeight;
-    const splitTransitionMode = this.pendingSplitFooterTransition?.mode ?? (splitWasSettled ? "viewport-scroll" : "clear-stale-rows");
-    if (this._terminalIsSetup && leavingSplitFooter) {
+    const splitTransitionSourceSurfaceOffset = Math.max(splitTransitionSourceTopLine - 1, 0);
+    const splitTransitionSourceOutputOffset = prevScreenMode === "split-footer" && prevSplitHeight > 0 && this._externalOutputMode === "capture-stdout" ? this.getSplitOutputOffset(splitTransitionSourceSurfaceOffset) : splitTransitionSourceSurfaceOffset;
+    const nextPinnedRenderOffset = nextGeometry.renderOffset;
+    const nextSplitOutputOffset = screenMode === "split-footer" && nextSplitHeight > 0 && this._externalOutputMode === "capture-stdout" ? this.getSplitOutputOffset(nextPinnedRenderOffset) : nextPinnedRenderOffset;
+    const pendingSplitFooterTransition = this.pendingSplitFooterTransition;
+    const pendingSplitFooterReturn = pendingSplitFooterTransition !== null && nextSplitHeight === splitTransitionSourceHeight;
+    const pendingSplitFooterViewportReturn = pendingSplitFooterReturn && pendingSplitFooterTransition.mode === "viewport-scroll" && (pendingSplitFooterTransition.scrollLines ?? 0) > 0;
+    const shrinkingSplitFooter = nextSplitHeight > 0 && nextSplitHeight < splitTransitionSourceHeight;
+    const growingSplitFooter = nextSplitHeight > splitTransitionSourceHeight && splitTransitionSourceHeight > 0;
+    const nextSplitSurfaceOffset = screenMode !== "split-footer" || nextSplitHeight === 0 ? 0 : pendingSplitFooterViewportReturn ? pendingSplitFooterTransition.targetTopLine - 1 : pendingSplitFooterReturn ? splitTransitionSourceSurfaceOffset : shrinkingSplitFooter && splitTransitionSourceSurfaceOffset > 0 ? splitTransitionSourceSurfaceOffset : shrinkingSplitFooter ? nextSplitOutputOffset : growingSplitFooter ? Math.max(nextSplitOutputOffset, Math.min(splitTransitionSourceSurfaceOffset, nextPinnedRenderOffset)) : nextPinnedRenderOffset;
+    const splitTransitionTargetTopLine = nextSplitSurfaceOffset + 1;
+    const splitViewportScrollLines = pendingSplitFooterViewportReturn ? pendingSplitFooterTransition.scrollLines ?? 0 : nextSplitHeight > 0 && !pendingSplitFooterReturn ? Math.max(splitTransitionSourceOutputOffset - nextSplitOutputOffset, 0) : 0;
+    const splitTransitionMode = (!shrinkingSplitFooter || pendingSplitFooterViewportReturn) && splitViewportScrollLines > 0 ? "viewport-scroll" : "clear-stale-rows";
+    const splitFooterSurfaceMovesDown = nextSplitSurfaceOffset > splitTransitionSourceSurfaceOffset;
+    const splitFooterSurfaceLeavesStaleRows = splitFooterSurfaceMovesDown || shrinkingSplitFooter;
+    const shouldClearSplitSurfaceRowsImmediately = terminalWritable && !terminalScreenModeChanged && !shouldDeferSplitFooterResizeTransition && splitFooterSurfaceLeavesStaleRows && nextSplitHeight > 0;
+    if (terminalWritable && leavingSplitFooter) {
       this.clearPendingSplitFooterTransition();
       this.renderOffset = 0;
       this.lib.setRenderOffset(this.rendererPtr, 0);
     }
-    if (this._terminalIsSetup && !terminalScreenModeChanged && shouldUseViewportScrollTransitions && !shouldDeferSplitFooterResizeTransition) {
+    if (terminalWritable && !terminalScreenModeChanged && !shouldDeferSplitFooterResizeTransition) {
       if (prevSplitHeight === 0 && nextSplitHeight > 0) {
         const freedLines = this._terminalHeight - nextSplitHeight;
         const scrollDown = ANSI.scrollDown(freedLines);
         this.writeOut(scrollDown);
-      } else if (prevSplitHeight > nextSplitHeight && nextSplitHeight > 0) {
-        const freedLines = prevSplitHeight - nextSplitHeight;
-        const scrollDown = ANSI.scrollDown(freedLines);
-        this.writeOut(scrollDown);
-      } else if (prevSplitHeight < nextSplitHeight && prevSplitHeight > 0) {
-        const additionalLines = nextSplitHeight - prevSplitHeight;
+      } else if (splitViewportScrollLines > 0) {
+        const additionalLines = splitViewportScrollLines;
         const scrollUp = ANSI.scrollUp(additionalLines);
         this.writeOut(scrollUp);
       }
@@ -22923,7 +23164,8 @@ Captured external output:
       if (prevScreenMode !== "split-footer") {
         this.resetSplitScrollback(this.getSplitCursorSeedRows());
       } else {
-        this.syncSplitScrollback();
+        this.renderOffset = nextSplitSurfaceOffset;
+        this.lib.setRenderOffset(this.rendererPtr, this.renderOffset);
       }
       if (shouldDeferSplitFooterResizeTransition) {
         if (splitStartupSeedBlocksFirstNativeFrame) {
@@ -22933,28 +23175,37 @@ Captured external output:
             mode: splitTransitionMode,
             sourceTopLine: splitTransitionSourceTopLine,
             sourceHeight: splitTransitionSourceHeight,
-            targetTopLine: this.renderOffset + 1,
-            targetHeight: nextSplitHeight
+            targetTopLine: splitTransitionTargetTopLine,
+            targetHeight: nextSplitHeight,
+            scrollLines: splitViewportScrollLines
           });
         }
         this.forceFullRepaintRequested = true;
-      } else if (!shouldUseViewportScrollTransitions && prevSplitHeight > 0 && nextSplitHeight > 0) {
+      } else if (shouldClearSplitSurfaceRowsImmediately) {
         this.clearPendingSplitFooterTransition();
-        this.clearStaleSplitSurfaceRows(previousSurfaceTopLine, prevSplitHeight, this.renderOffset + 1, nextSplitHeight);
+        this.clearStaleSplitSurfaceRows(splitTransitionSourceTopLine, splitTransitionSourceHeight, splitTransitionTargetTopLine, nextSplitHeight);
       } else {
         this.clearPendingSplitFooterTransition();
       }
     } else {
       this.syncSplitFooterState();
+      if (shouldClearSplitSurfaceRowsImmediately) {
+        this.clearStaleSplitSurfaceRows(splitTransitionSourceTopLine, splitTransitionSourceHeight, this.renderOffset + 1, nextSplitHeight);
+      }
     }
     this.nextRenderBuffer = this.lib.getNextBuffer(this.rendererPtr);
     this.currentRenderBuffer = this.lib.getCurrentBuffer(this.rendererPtr);
     this._console.resize(this.width, this.height);
     this.root.resize(this.width, this.height);
     if (terminalScreenModeChanged) {
-      this.lib.suspendRenderer(this.rendererPtr);
-      this.lib.setupTerminal(this.rendererPtr, nextUseAlternateScreen);
-      if (this._useMouse) {
+      if (terminalWritable) {
+        this.lib.suspendRenderer(this.rendererPtr);
+        this.lib.setupTerminal(this.rendererPtr, nextUseAlternateScreen);
+        this.pendingSuspendedTerminalSetup = false;
+      } else {
+        this.pendingSuspendedTerminalSetup = true;
+      }
+      if (terminalWritable && this._useMouse) {
         this.enableMouse();
       }
     }
@@ -23037,11 +23288,7 @@ Captured external output:
     }
     this.capabilityTimeoutId = this.clock.setTimeout(() => {
       this.capabilityTimeoutId = null;
-      this.pendingSplitStartupCursorSeed = false;
-      if (this.splitStartupSeedTimeoutId !== null) {
-        this.clock.clearTimeout(this.splitStartupSeedTimeoutId);
-        this.splitStartupSeedTimeoutId = null;
-      }
+      this.clearSplitStartupCursorSeed();
       if (this._screenMode === "split-footer" && this._externalOutputMode === "capture-stdout") {
         this.requestRender();
       }
@@ -23070,6 +23317,7 @@ Captured external output:
         if (this._screenMode === "split-footer" && this._externalOutputMode === "capture-stdout") {
           this.requestRender();
         }
+        this.flushPendingSplitOutputBeforeTransition(false, { allowPassthrough: true });
       }, 120);
     }
     this.queryPixelResolution();
@@ -23130,13 +23378,12 @@ Captured external output:
     if (hadPendingSplitStartupCursorSeed && hasCursorReport && this._screenMode === "split-footer" && this._externalOutputMode === "capture-stdout") {
       this.resetSplitScrollback(this.getSplitCursorSeedRows());
       this.clearPendingSplitFooterTransition();
-      this.pendingSplitStartupCursorSeed = false;
+      this.clearSplitStartupCursorSeed();
       this.updateStdinParserProtocolContext({ startupCursorCprActive: false });
-      if (this.splitStartupSeedTimeoutId !== null) {
-        this.clock.clearTimeout(this.splitStartupSeedTimeoutId);
-        this.splitStartupSeedTimeoutId = null;
-      }
       this.requestRender();
+      if (this.pendingExternalOutputMode === "passthrough") {
+        this.flushPendingSplitOutputBeforeTransition();
+      }
     }
     const consumeStartupCursorReport = hadPendingSplitStartupCursorSeed && hasCursorReport && this.splitStartupSeedTimeoutId !== null;
     return hasStandardCapabilitySignature || consumeStartupCursorReport;
@@ -23499,7 +23746,7 @@ Captured external output:
   processResize(width, height) {
     if (width === this._terminalWidth && height === this._terminalHeight)
       return;
-    if (this._terminalIsSetup && this._controlState !== "explicit_suspended" /* EXPLICIT_SUSPENDED */) {
+    if (this._terminalIsSetup && this._controlState !== "explicit_suspended" /* EXPLICIT_SUSPENDED */ && !this.isSplitCursorSeedFrameBlocked()) {
       this.flushPendingSplitOutputBeforeTransition();
     }
     const pendingSplitFooterTransition = this.pendingSplitFooterTransition;
@@ -23686,7 +23933,11 @@ Captured external output:
     this._controlState = "explicit_suspended" /* EXPLICIT_SUSPENDED */;
     this.internalPause();
     if (this._terminalIsSetup) {
-      this.flushPendingSplitOutputBeforeTransition(true);
+      this.clearSplitStartupCursorSeed();
+      this.flushPendingSplitOutputBeforeTransition(true, { allowSuspended: true });
+      this.suspendedNonAltSurfacePreserved = this._screenMode !== "alternate-screen" && this.renderOffset > 0;
+    } else {
+      this.suspendedNonAltSurfacePreserved = false;
     }
     this._suspendedMouseEnabled = this._useMouse;
     this.disableMouse();
@@ -23715,7 +23966,19 @@ Captured external output:
     this.stdin.on("data", this.stdinListener);
     this.stdin.resume();
     this.addExitListeners();
-    this.lib.resumeRenderer(this.rendererPtr);
+    const resumePreservedNonAltSurface = this.pendingSuspendedTerminalSetup && this._screenMode !== "alternate-screen" && this.suspendedNonAltSurfacePreserved && this.renderOffset > 0;
+    if (this.pendingSuspendedTerminalSetup) {
+      this.pendingSuspendedTerminalSetup = false;
+      if (resumePreservedNonAltSurface) {
+        this.lib.resumeRenderer(this.rendererPtr);
+      } else {
+        this.lib.setupTerminal(this.rendererPtr, this._screenMode === "alternate-screen");
+      }
+    } else {
+      this.lib.resumeRenderer(this.rendererPtr);
+    }
+    this.suspendedNonAltSurfacePreserved = false;
+    this.flushPendingSplitOutputBeforeTransition(false, { allowSuspended: true, allowPassthrough: true });
     if (this._screenMode === "split-footer" && this._splitHeight > 0) {
       this.syncSplitFooterState();
     }
@@ -23790,10 +24053,7 @@ Captured external output:
       this.clock.clearTimeout(this.capabilityTimeoutId);
       this.capabilityTimeoutId = null;
     }
-    if (this.splitStartupSeedTimeoutId !== null) {
-      this.clock.clearTimeout(this.splitStartupSeedTimeoutId);
-      this.splitStartupSeedTimeoutId = null;
-    }
+    this.clearSplitStartupCursorSeed();
     if (this.memorySnapshotTimer) {
       this.clock.clearInterval(this.memorySnapshotTimer);
       this.memorySnapshotTimer = null;
@@ -23862,6 +24122,7 @@ Captured external output:
       }
     }
     this._externalOutputMode = "passthrough";
+    this.pendingExternalOutputMode = null;
     this.stdout.write = this.realStdoutWrite;
     this.externalOutputQueue.clear();
     this.lib.destroyRenderer(this.rendererPtr);
@@ -23973,14 +24234,14 @@ Captured external output:
       throw new Error("Rendering called concurrently");
     }
     this.renderingNative = true;
-    if (this.pendingSplitStartupCursorSeed && this.splitStartupSeedTimeoutId !== null && this._splitHeight > 0 && this._externalOutputMode === "capture-stdout") {
+    if (this.isSplitCursorSeedFrameBlocked()) {
       this.renderingNative = false;
       return;
     }
     if (this._splitHeight > 0 && this._externalOutputMode === "capture-stdout") {
       const forceSplitRepaint = this.forceFullRepaintRequested;
       this.forceFullRepaintRequested = false;
-      this.flushPendingSplitCommits(forceSplitRepaint);
+      this.flushPendingSplitCommits(forceSplitRepaint, this.pendingExternalOutputMode === "passthrough");
       this.pendingSplitFooterTransition = null;
     } else {
       const force = this.forceFullRepaintRequested;
@@ -24295,5 +24556,5 @@ Captured external output:
 
 export { __export, __require, MeasureMode, exports_src, isValidBorderStyle, parseBorderStyle, BorderChars, getBorderFromSides, getBorderSides, borderCharsToArray, BorderCharArrays, KeyEvent, PasteEvent, KeyHandler, InternalKeyHandler, DEFAULT_FOREGROUND_RGB, DEFAULT_BACKGROUND_RGB, normalizeIndexedColorIndex, ansi256IndexToRgb, RGBA, normalizeColorValue, hexToRgb, rgbToHex, hsvToRgb, parseColor, fonts, measureText, getCharacterPositions, coordinateToCharacterIndex, renderFontToFrameBuffer, TextAttributes, ATTRIBUTE_BASE_BITS, ATTRIBUTE_BASE_MASK, getBaseAttributes, DebugOverlayCorner, TargetChannel, createTextAttributes, attributesWithLink, getLinkId, visualizeRenderableTree, isStyledText, StyledText, stringToStyledText, black, red, green, yellow, blue, magenta, cyan, white, brightBlack, brightRed, brightGreen, brightYellow, brightBlue, brightMagenta, brightCyan, brightWhite, bgBlack, bgRed, bgGreen, bgYellow, bgBlue, bgMagenta, bgCyan, bgWhite, bold, italic, underline, strikethrough, dim, reverse, blink, fg, bg, link, t, hastToStyledText, SystemClock, nonAlphanumericKeys, terminalNamedSingleStrokeKeys, parseKeypress, LinearScrollAccel, MacOSScrollAccel, parseAlign, parseAlignItems, parseBoxSizing, parseDimension, parseDirection, parseDisplay, parseEdge, parseFlexDirection, parseGutter, parseJustify, parseLogLevel, parseMeasureMode, parseOverflow, parsePositionType, parseUnit, parseWrap, MouseParser, Selection, convertGlobalToLocalSelection, ASCIIFontSelectionHelper, envRegistry, registerEnvVar, clearEnvCache, generateEnvMarkdown, generateEnvColored, env, StdinParser, treeSitterToTextChunks, treeSitterToStyledText, addDefaultParsers, TreeSitterClient, DataPathsManager, getDataPaths, extensionToFiletype, basenameToFiletype, extToFiletype, pathToFiletype, infoStringToFiletype, main, getTreeSitterClient, stringWidth2 as stringWidth, ExtmarksController, createExtmarksController, TerminalPalette, createTerminalPalette, normalizeTerminalPalette, buildTerminalPaletteSignature, decodePasteBytes, stripAnsiSequences, detectLinks, toArrayBuffer, TextBuffer, SpanInfoStruct, LogLevel2 as LogLevel, setRenderLibPath, resolveRenderLib, OptimizedBuffer, h, isVNode, maybeMakeRenderable, wrapWithDelegates, instantiate, delegate, LayoutEvents, RenderableEvents, isRenderable, BaseRenderable, Renderable, RootRenderable, TextBufferView, EditBuffer, EditorView, convertThemeToStyles, SyntaxStyle, ANSI, BoxRenderable, TextBufferRenderable, CodeRenderable, isTextNodeRenderable, TextNodeRenderable, RootTextNodeRenderable, TextRenderable, defaultKeyAliases, mergeKeyAliases, mergeKeyBindings, getKeyBindingAction, buildKeyBindingsMap, capture, ConsolePosition, TerminalConsole, getObjectsInViewport, EditBufferRenderableEvents, isEditBufferRenderable, EditBufferRenderable, calculateRenderGeometry, buildKittyKeyboardFlags, MouseEvent, MouseButton, createCliRenderer, CliRenderEvents, RendererControlState, CliRenderer };
 
-//# debugId=A8199A30ABCACF0064756E2164756E21
-//# sourceMappingURL=index-hmk8xzt3.js.map
+//# debugId=355172C54650946864756E2164756E21
+//# sourceMappingURL=index-s460mpf9.js.map