@simon_he/vue-tui 1.1.3 → 1.1.5

package/dist/cli.cjs

@@ -7869,7 +7869,28 @@ function createStdoutRenderer(terminal, options) {
   let output = (options == null ? void 0 : options.output) ?? import_node_process6.default.stdout;
   if (!output)
     throw new Error("createStdoutRenderer requires a Node stdout-like output");
-  let out = output, outputFd = Number(out.fd), canUseSyncStdout = (options == null ? void 0 : options.output) == null && Number.isInteger(outputFd) && outputFd === 1, fingerprintOwner = Symbol("stdout-renderer"), ownsFingerprintFn = !1, fingerprintTerminal = terminal, canInstallTerminalFingerprintFn = () => typeof fingerprintTerminal.setFingerprintFn == "function" && typeof fingerprintTerminal.getRowFingerprints == "function", outputIsTTY = !!out.isTTY, outputAllowsOsc8Links = out.isTTY !== !1, clear = (options == null ? void 0 : options.clear) ?? !0, hideCursor = (options == null ? void 0 : options.hideCursor) ?? !0, altScreen = (options == null ? void 0 : options.altScreen) ?? outputIsTTY, keepLineWrapDisabled = altScreen && outputIsTTY, defaultBg = (options == null ? void 0 : options.defaultBg) == null || (options == null ? void 0 : options.defaultBg) === "transparent" ? void 0 : (options == null ? void 0 : options.defaultBg) ?? "black", palette = (options == null ? void 0 : options.palette) ?? null, trackResize = (options == null ? void 0 : options.trackResize) ?? !0, getImeAnchor = options == null ? void 0 : options.getImeAnchor, allowFileUrls = (options == null ? void 0 : options.allowFileUrls) ?? !1, cliLatency = getCliLatencyProfiler(), profiler = createTuiProfiler("stdout-renderer", {
+  let out = output, outputFd = Number(out.fd), canUseSyncStdout = (options == null ? void 0 : options.output) == null && Number.isInteger(outputFd) && outputFd === 1, fingerprintOwner = Symbol("stdout-renderer"), ownsFingerprintFn = !1, fingerprintTerminal = terminal, canInstallTerminalFingerprintFn = () => typeof fingerprintTerminal.setFingerprintFn == "function" && typeof fingerprintTerminal.getRowFingerprints == "function", outputIsTTY = !!out.isTTY, outputAllowsOsc8Links = out.isTTY !== !1, clear = (options == null ? void 0 : options.clear) ?? !0, hideCursor = (options == null ? void 0 : options.hideCursor) ?? !0, altScreen = (options == null ? void 0 : options.altScreen) ?? outputIsTTY, keepLineWrapDisabled = altScreen && outputIsTTY, defaultBg = (options == null ? void 0 : options.defaultBg) == null || (options == null ? void 0 : options.defaultBg) === "transparent" ? void 0 : (options == null ? void 0 : options.defaultBg) ?? "black", palette = (options == null ? void 0 : options.palette) ?? null, trackResize = (options == null ? void 0 : options.trackResize) ?? !0, getImeAnchor = options == null ? void 0 : options.getImeAnchor, anchorMode = (options == null ? void 0 : options.anchor) === "bottom" ? "bottom" : "top", screenRowsFn = typeof (options == null ? void 0 : options.screenRows) == "function" ? options.screenRows : void 0, rawBarGap = Math.floor(Number((options == null ? void 0 : options.barGap) ?? 0)), barGap = Number.isFinite(rawBarGap) ? Math.max(0, rawBarGap) : 0, rowOffset = 0, scrollRegionBottom = 0, bottomRegionInitialized = !1, resolveScreenRows = () => {
+    var _a2;
+    let rows = 0;
+    if (screenRowsFn) {
+      let v = Math.floor(Number(screenRowsFn()));
+      Number.isFinite(v) && v > 0 && (rows = v);
+    }
+    if (!rows) {
+      let v = Math.floor(Number(out.rows));
+      Number.isFinite(v) && v > 0 && (rows = v);
+    }
+    if (!rows) {
+      let v = Math.floor(Number((_a2 = import_node_process6.default.stdout) == null ? void 0 : _a2.rows));
+      Number.isFinite(v) && v > 0 && (rows = v);
+    }
+    return rows;
+  }, computeRowOffset = (bufferRows) => {
+    if (anchorMode !== "bottom")
+      return 0;
+    let offset = resolveScreenRows() - bufferRows;
+    return Number.isFinite(offset) && offset > 0 ? offset : 0;
+  }, allowFileUrls = (options == null ? void 0 : options.allowFileUrls) ?? !1, cliLatency = getCliLatencyProfiler(), profiler = createTuiProfiler("stdout-renderer", {
     fileWriter: (options == null ? void 0 : options.profileFileWriter) ?? nodeProfilerFileWriter,
     defaultLogDest: "file",
     defaultLogPath: defaultVueTuiProfileLogPath()
@@ -8319,7 +8340,11 @@ function createStdoutRenderer(terminal, options) {
             clearSequence,
             fallbackText: frame.fallbackText,
             resizeRedraw: !0,
-            placementMoveWithoutClear: !1
+            // Preserve the caller's opt-in: when the placement moves (e.g.
+            // interactive wheel zoom) the render pass can replace the kitty
+            // placement in place and keep the original transmission sequence,
+            // so subsequent resizes stay on the cheap path.
+            placementMoveWithoutClear: !!normalized.placementMoveWithoutClear
           }), pendingGraphicSignatures.set(frame.id, signature), recordTerminalGraphicTrace({
             type: "queue",
             id: frame.id,
@@ -8426,7 +8451,7 @@ function createStdoutRenderer(terminal, options) {
   function clearGraphicRect(rect) {
     let blank = " ".repeat(Math.max(0, rect.w)), out2 = "";
     for (let row = 0; row < rect.h; row++)
-      out2 += `\x1B[${rect.y + row + 1};${rect.x + 1}H${blank}`;
+      out2 += `\x1B[${rect.y + row + 1 + rowOffset};${rect.x + 1}H${blank}`;
     return out2;
   }
   function sameGraphicRect(a, b) {
@@ -8887,7 +8912,7 @@ function createStdoutRenderer(terminal, options) {
     let start = rowCursorToCol1.length;
     rowCursorToCol1.length = rows, rowClearToEol.length = rows;
     for (let y = start; y < rows; y++)
-      rowCursorToCol1[y] = `\x1B[${y + 1};1H`, rowClearToEol[y] = `\x1B[${y + 1};1H\x1B[K`;
+      rowCursorToCol1[y] = `\x1B[${y + 1 + rowOffset};1H`, rowClearToEol[y] = `\x1B[${y + 1 + rowOffset};1H\x1B[K`;
   }, rowHasNonDefaultBlankCell = (sourceFP, sourceTextIds, sourceHrefIds, y, cols) => {
     if (!fpCols || y < 0 || y >= fpRows)
       return !1;
@@ -9106,6 +9131,21 @@ function createStdoutRenderer(terminal, options) {
       `doRender state: size=${size.cols}x${size.rows}, dirtyRows=${(dirtyRows == null ? void 0 : dirtyRows.length) ?? "null"}, scrollOps=${(scrollOperations == null ? void 0 : scrollOperations.length) ?? 0}, rowsOnlyBaseline=${rowsOnlyResizeBaseline ? "true" : "false"}, allowGraphicsOnlyWithoutBaseline=${allowGraphicsOnlyWithoutBaseline ? "true" : "false"}, activeGraphics=${activeGraphics.size}, pendingGraphics=${graphicsToRender.length}, pendingGraphicClears=${graphicsClearsToRender.length}`
     );
     let terminalGraphicsBlockScrollRegions = !1;
+    if (anchorMode === "bottom") {
+      dirtyRows = null, scrollOperations = null;
+      let nextRowOffset = computeRowOffset(size.rows);
+      nextRowOffset !== rowOffset && (rowOffset = nextRowOffset, rowCursorToCol1.length = 0, rowClearToEol.length = 0);
+      let nextRegionBottom = Math.max(1, nextRowOffset - barGap);
+      if (outputIsTTY && !bottomRegionInitialized) {
+        let screenRows = resolveScreenRows();
+        if (screenRows > 0 && nextRowOffset > 0) {
+          let reservedRows = Math.max(0, screenRows - nextRegionBottom), scrollCount = Math.min(screenRows, reservedRows + 1);
+          out.write(`\x1B[r\x1B[${screenRows};1H${`
+`.repeat(scrollCount)}`), bottomRegionInitialized = !0;
+        }
+      }
+      outputIsTTY && nextRegionBottom !== scrollRegionBottom && (scrollRegionBottom = nextRegionBottom, out.write(`\x1B[1;${nextRegionBottom}r`));
+    }
     ensureRowEscapes(Math.max(size.rows, lastRenderedRows)), ensureFingerprints(size.cols, size.rows);
     let bgSeq = openBg(defaultBg), bgOnlyStyle = { bg: defaultBg }, bgKey = styleKeyFromParts({ bg: defaultBg }), blankFP = cellFingerprintFromStyleKey(" ", bgKey);
     if (rowsOnlyResizeBaseline && rowsOnlyResizeBaseline.cols === size.cols) {
@@ -9276,7 +9316,7 @@ function createStdoutRenderer(terminal, options) {
         }
     })(), fpPrevValid && rowsToRender && (currentFP.set(prevFP), currentHrefIds.set(prevHrefIds), currentTextIds.set(prevTextIds));
     let frameHasTerminalGraphics = activeGraphics.size > 0 || graphicsClearsToRender.length > 0 || graphicsToRender.length > 0, useFrameSyncOutput = useSyncOutput || isGhostty && frameHasTerminalGraphics, frameParts = [];
-    frameParts.push(useFrameSyncOutput ? SYNC_START : ""), frameParts.push(allowGraphicsOnlyWithoutBaseline || keepLineWrapDisabled ? "" : "\x1B[?7l"), frameParts.push(SGR_RESET, bgSeq), hideCursor && !getImeAnchor && frameParts.push(CURSOR_HOME);
+    frameParts.push(useFrameSyncOutput ? SYNC_START : ""), frameParts.push(allowGraphicsOnlyWithoutBaseline || keepLineWrapDisabled ? "" : "\x1B[?7l"), frameParts.push(SGR_RESET, bgSeq), hideCursor && !getImeAnchor && frameParts.push(rowOffset > 0 ? `\x1B[${rowOffset + 1}H` : CURSOR_HOME);
     let lastRenderedY = -1, lastRenderWasFullRow = !1, hasFrameOutput = !1, activeStyleKey = null, activeStyle = {
       fg: null,
       bg: defaultBg,
@@ -9316,11 +9356,11 @@ function createStdoutRenderer(terminal, options) {
       hasFrameOutput = !0;
       let pushCursorFixAfterCell = (parts, cellX, cell) => {
         let afterX = cellX + (cell.width ?? 1);
-        afterX >= size.cols || parts.push(`\x1B[${y + 1};${afterX + 1}H`);
+        afterX >= size.cols || parts.push(`\x1B[${y + 1 + rowOffset};${afterX + 1}H`);
       };
       disableCursorPos || (closeActiveHrefBeforeCursorMove(), spanStart === 0 && lastRenderWasFullRow && y === lastRenderedY + 1 ? frameParts.push(`\r
 `) : frameParts.push(
-        spanStart === 0 ? rowCursorToCol1[y] : `\x1B[${y + 1};${spanStart + 1}H`
+        spanStart === 0 ? rowCursorToCol1[y] : `\x1B[${y + 1 + rowOffset};${spanStart + 1}H`
       ));
       let currentKey = null, currentStyle = null, currentTextParts = rowTextPartsScratch;
       currentTextParts.length = 0;
@@ -9666,7 +9706,7 @@ function createStdoutRenderer(terminal, options) {
           fingerprintRow(row, y, size.cols), renderRowPreservingTerminalGraphics(y, row);
         }
       }
-    if (!rowsToRender && lastRenderedRows > size.rows && !rowsOnlyResizeBaseline) {
+    if (!rowsToRender && lastRenderedRows > size.rows && !rowsOnlyResizeBaseline && anchorMode !== "bottom") {
       let extraRows = lastRenderedRows - size.rows;
       activeStyleKey !== bgKey && (frameParts.push(SGR_RESET, bgSeq), activeStyleKey = bgKey);
       for (let i = 0; i < extraRows; i++)
@@ -9688,7 +9728,7 @@ function createStdoutRenderer(terminal, options) {
       let erase = `\x1B[${Math.max(0, rect.w)}X`, clearStyle = bgSeq, out2 = "";
       for (let row = 0; row < rect.h; row++) {
         let y = rect.y + row, spans = terminalGraphicTextPreserveSpans.get(y), preservedGraphicSpan = !(overlayTouchedRowSet != null && overlayTouchedRowSet.has(y)) && !!(spans != null && spans.some((span) => span.start < rect.x + rect.w && span.end > rect.x));
-        (!rowsToRender || rowWasPaintedByTextRenderer(y)) && !preservedGraphicSpan || (out2 += `\x1B[${y + 1};${rect.x + 1}H${clearStyle}${erase}${SGR_RESET}`);
+        (!rowsToRender || rowWasPaintedByTextRenderer(y)) && !preservedGraphicSpan || (out2 += `\x1B[${y + 1 + rowOffset};${rect.x + 1}H${clearStyle}${erase}${SGR_RESET}`);
       }
       return out2;
     }, commitTerminalGraphicsState = null, restoreTerminalGraphicsAfterWriteFailure = null, terminalGraphicsMetrics = null;
@@ -9708,7 +9748,7 @@ function createStdoutRenderer(terminal, options) {
           return !1;
         let cell = rect ? { x: rect.x, y: rect.y } : clampCellToViewport(fallbackCell, size);
         return frameParts.push(
-          countGraphicsBytes(`\x1B[${cell.y + 1};${cell.x + 1}H`),
+          countGraphicsBytes(`\x1B[${cell.y + 1 + rowOffset};${cell.x + 1}H`),
           countGraphicsBytes(maybeWrapTerminalGraphic(sequence)),
           countGraphicsBytes(SGR_RESET)
         ), !0;
@@ -9854,14 +9894,14 @@ function createStdoutRenderer(terminal, options) {
       let anchor = getImeAnchor();
       if (anchor) {
         let { x, y } = clampCellToViewport(anchor, size);
-        (hasFrameOutput || x !== lastCursorX || y !== lastCursorY) && (hasFrameOutput = !0, emittedCursorPos = { x, y }, closeActiveHrefBeforeCursorMove(), frameParts.push(`\x1B[${y + 1};${x + 1}H`));
+        (hasFrameOutput || x !== lastCursorX || y !== lastCursorY) && (hasFrameOutput = !0, emittedCursorPos = { x, y }, closeActiveHrefBeforeCursorMove(), frameParts.push(`\x1B[${y + 1 + rowOffset};${x + 1}H`));
       }
     }
     if (!hasFrameOutput) {
       commitRenderBaseline(), isDebugEnabled() && getDebugLog().render(" No-op frame skipped"), cliLatency == null || cliLatency.recordStdoutNoOutput();
       return;
     }
-    enableOsc8Links && activeStyle.href && frameParts.push(OSC8_CLOSE), frameParts.push(SGR_RESET), hideCursor && !getImeAnchor && frameParts.push(CURSOR_HOME), frameParts.push(allowGraphicsOnlyWithoutBaseline || keepLineWrapDisabled ? "" : "\x1B[?7h"), frameParts.push(useFrameSyncOutput ? SYNC_END : "");
+    enableOsc8Links && activeStyle.href && frameParts.push(OSC8_CLOSE), frameParts.push(SGR_RESET), hideCursor && !getImeAnchor && frameParts.push(rowOffset > 0 ? `\x1B[${rowOffset + 1}H` : CURSOR_HOME), frameParts.push(allowGraphicsOnlyWithoutBaseline || keepLineWrapDisabled ? "" : "\x1B[?7h"), frameParts.push(useFrameSyncOutput ? SYNC_END : "");
     let frame = frameParts.join(""), frameBytes = import_node_buffer3.Buffer.byteLength(frame, "utf8");
     if (profiler && profiler.recordRender({
       durationMs: profiler.now() - renderStart,
@@ -10172,7 +10212,7 @@ function createStdoutRenderer(terminal, options) {
       rowsOnlyResizeRepaintTimer = null, repaintRowsAfterRowsOnlyResize();
     }, ROWS_ONLY_RESIZE_REPAINT_DELAY_MS);
   }
-  altScreen && outputIsTTY && out.write("\x1B[?1049h"), keepLineWrapDisabled && out.write("\x1B[?7l"), hideCursor && out.write("\x1B[?25l"), clear && out.write(`${SGR_RESET}${openBg(defaultBg)}\x1B[2J\x1B[H${SGR_RESET}`);
+  altScreen && outputIsTTY && out.write("\x1B[?1049h"), keepLineWrapDisabled && out.write("\x1B[?7l"), hideCursor && out.write("\x1B[?25l"), clear && anchorMode !== "bottom" && out.write(`${SGR_RESET}${openBg(defaultBg)}\x1B[2J\x1B[H${SGR_RESET}`);
   let off = terminal.on("commit", ({ dirtyRows, scrollOperations, sync }) => {
     if (suppressNextResizeCommitRender)
       return;
@@ -10225,7 +10265,7 @@ function createStdoutRenderer(terminal, options) {
       { cellX: x, cellY: y },
       { cols: size.cols, rows: size.rows }
     );
-    out.write(`\x1B[${cy + 1};${cx + 1}H`), lastCursorX = cx, lastCursorY = cy;
+    out.write(`\x1B[${cy + 1 + rowOffset};${cx + 1}H`), lastCursorX = cx, lastCursorY = cy;
   }
   function showCursor(visible) {
     disposed || out.write(visible ? "\x1B[?25h" : "\x1B[?25l");
@@ -10244,7 +10284,7 @@ function createStdoutRenderer(terminal, options) {
           if (visibleRect && (clearParts.push(clearGraphicRect(visibleRect)), wroteClear = !0), active.clearSequence && (visibleRect || !clearSequenceNeedsVisibleCell(active.clearSequence, active.protocol))) {
             let cell = visibleRect ? { x: visibleRect.x, y: visibleRect.y } : clampCellToViewport({ cellX: active.x, cellY: active.y }, size);
             clearParts.push(
-              `\x1B[${cell.y + 1};${cell.x + 1}H`,
+              `\x1B[${cell.y + 1 + rowOffset};${cell.x + 1}H`,
               maybeWrapTerminalGraphic(active.clearSequence)
             ), wroteClear = !0;
           }
@@ -10274,7 +10314,7 @@ function createStdoutRenderer(terminal, options) {
       } catch {
       }
     try {
-      keepLineWrapDisabled && out.write("\x1B[?7h"), hideCursor && out.write("\x1B[?25h"), altScreen && outputIsTTY && out.write("\x1B[?1049l");
+      keepLineWrapDisabled && out.write("\x1B[?7h"), hideCursor && out.write("\x1B[?25h"), altScreen && outputIsTTY && out.write("\x1B[?1049l"), anchorMode === "bottom" && outputIsTTY && scrollRegionBottom > 0 && out.write("\x1B[r");
     } catch (err) {
       disposeError == null && (disposeError = err);
     }
@@ -10285,6 +10325,7 @@ function createStdoutRenderer(terminal, options) {
     capabilities: STDOUT_RENDERER_CAPABILITIES,
     graphicsCapabilities,
     render,
+    forceRender: () => render(void 0, !0),
     dispose,
     setCursor,
     showCursor,

package/dist/cli.js

@@ -9919,6 +9919,35 @@ function createStdoutRenderer(terminal, options) {
 	let palette = (options === null || options === void 0 ? void 0 : options.palette) ?? null;
 	const trackResize = (options === null || options === void 0 ? void 0 : options.trackResize) ?? true;
 	const getImeAnchor = options === null || options === void 0 ? void 0 : options.getImeAnchor;
+	const anchorMode = (options === null || options === void 0 ? void 0 : options.anchor) === "bottom" ? "bottom" : "top";
+	const screenRowsFn = typeof (options === null || options === void 0 ? void 0 : options.screenRows) === "function" ? options.screenRows : void 0;
+	const rawBarGap = Math.floor(Number((options === null || options === void 0 ? void 0 : options.barGap) ?? 0));
+	const barGap = Number.isFinite(rawBarGap) ? Math.max(0, rawBarGap) : 0;
+	let rowOffset = 0;
+	let scrollRegionBottom = 0;
+	let bottomRegionInitialized = false;
+	const resolveScreenRows = () => {
+		let rows = 0;
+		if (screenRowsFn) {
+			const v = Math.floor(Number(screenRowsFn()));
+			if (Number.isFinite(v) && v > 0) rows = v;
+		}
+		if (!rows) {
+			const v = Math.floor(Number(out.rows));
+			if (Number.isFinite(v) && v > 0) rows = v;
+		}
+		if (!rows) {
+			var _stdout;
+			const v = Math.floor(Number((_stdout = process.stdout) === null || _stdout === void 0 ? void 0 : _stdout.rows));
+			if (Number.isFinite(v) && v > 0) rows = v;
+		}
+		return rows;
+	};
+	const computeRowOffset = (bufferRows) => {
+		if (anchorMode !== "bottom") return 0;
+		const offset = resolveScreenRows() - bufferRows;
+		return Number.isFinite(offset) && offset > 0 ? offset : 0;
+	};
 	const allowFileUrls = (options === null || options === void 0 ? void 0 : options.allowFileUrls) ?? false;
 	const cliLatency = getCliLatencyProfiler();
 	const profiler = createTuiProfiler("stdout-renderer", {
@@ -10453,7 +10482,7 @@ function createStdoutRenderer(terminal, options) {
 						clearSequence,
 						fallbackText: frame.fallbackText,
 						resizeRedraw: true,
-						placementMoveWithoutClear: false
+						placementMoveWithoutClear: Boolean(normalized.placementMoveWithoutClear)
 					});
 					pendingGraphicSignatures.set(frame.id, signature);
 					recordTerminalGraphicTrace({
@@ -10617,7 +10646,7 @@ function createStdoutRenderer(terminal, options) {
 	function clearGraphicRect(rect) {
 		const blank = " ".repeat(Math.max(0, rect.w));
 		let out$1 = "";
-		for (let row = 0; row < rect.h; row++) out$1 += `\u001B[${rect.y + row + 1};${rect.x + 1}H${blank}`;
+		for (let row = 0; row < rect.h; row++) out$1 += `\u001B[${rect.y + row + 1 + rowOffset};${rect.x + 1}H${blank}`;
 		return out$1;
 	}
 	function sameGraphicRect(a, b) {
@@ -11238,8 +11267,8 @@ function createStdoutRenderer(terminal, options) {
 		rowCursorToCol1.length = rows;
 		rowClearToEol.length = rows;
 		for (let y = start; y < rows; y++) {
-			rowCursorToCol1[y] = `\u001B[${y + 1};1H`;
-			rowClearToEol[y] = `\u001B[${y + 1};1H\u001B[K`;
+			rowCursorToCol1[y] = `\u001B[${y + 1 + rowOffset};1H`;
+			rowClearToEol[y] = `\u001B[${y + 1 + rowOffset};1H\u001B[K`;
 		}
 	};
 	const rowHasNonDefaultBlankCell = (sourceFP, sourceTextIds, sourceHrefIds, y, cols) => {
@@ -11549,6 +11578,30 @@ function createStdoutRenderer(terminal, options) {
 		allowNextGraphicsOnlyRenderWithoutBaseline = false;
 		if (isDebugEnabled()) getDebugLog().render(`doRender state: size=${size.cols}x${size.rows}, dirtyRows=${(dirtyRows === null || dirtyRows === void 0 ? void 0 : dirtyRows.length) ?? "null"}, scrollOps=${(scrollOperations === null || scrollOperations === void 0 ? void 0 : scrollOperations.length) ?? 0}, rowsOnlyBaseline=${rowsOnlyResizeBaseline ? "true" : "false"}, allowGraphicsOnlyWithoutBaseline=${allowGraphicsOnlyWithoutBaseline ? "true" : "false"}, activeGraphics=${activeGraphics.size}, pendingGraphics=${graphicsToRender.length}, pendingGraphicClears=${graphicsClearsToRender.length}`);
 		let terminalGraphicsBlockScrollRegions = false;
+		if (anchorMode === "bottom") {
+			dirtyRows = null;
+			scrollOperations = null;
+			const nextRowOffset = computeRowOffset(size.rows);
+			if (nextRowOffset !== rowOffset) {
+				rowOffset = nextRowOffset;
+				rowCursorToCol1.length = 0;
+				rowClearToEol.length = 0;
+			}
+			const nextRegionBottom = Math.max(1, nextRowOffset - barGap);
+			if (outputIsTTY && !bottomRegionInitialized) {
+				const screenRows = resolveScreenRows();
+				if (screenRows > 0 && nextRowOffset > 0) {
+					const reservedRows = Math.max(0, screenRows - nextRegionBottom);
+					const scrollCount = Math.min(screenRows, reservedRows + 1);
+					out.write(`\u001B[r\u001B[${screenRows};1H${"\n".repeat(scrollCount)}`);
+					bottomRegionInitialized = true;
+				}
+			}
+			if (outputIsTTY && nextRegionBottom !== scrollRegionBottom) {
+				scrollRegionBottom = nextRegionBottom;
+				out.write(`\u001B[1;${nextRegionBottom}r`);
+			}
+		}
 		ensureRowEscapes(Math.max(size.rows, lastRenderedRows));
 		ensureFingerprints(size.cols, size.rows);
 		const bgSeq = openBg(defaultBg);
@@ -11806,7 +11859,7 @@ function createStdoutRenderer(terminal, options) {
 		frameParts.push(useFrameSyncOutput ? SYNC_START : "");
 		frameParts.push(allowGraphicsOnlyWithoutBaseline || keepLineWrapDisabled ? "" : "\x1B[?7l");
 		frameParts.push(SGR_RESET, bgSeq);
-		if (hideCursor && !getImeAnchor) frameParts.push(CURSOR_HOME);
+		if (hideCursor && !getImeAnchor) frameParts.push(rowOffset > 0 ? `\u001B[${rowOffset + 1}H` : CURSOR_HOME);
 		let lastRenderedY = -1;
 		let lastRenderWasFullRow = false;
 		let hasFrameOutput = false;
@@ -11876,12 +11929,12 @@ function createStdoutRenderer(terminal, options) {
 			const pushCursorFixAfterCell = (parts, cellX, cell) => {
 				const afterX = cellX + (cell.width ?? 1);
 				if (afterX >= size.cols) return;
-				parts.push(`\u001B[${y + 1};${afterX + 1}H`);
+				parts.push(`\u001B[${y + 1 + rowOffset};${afterX + 1}H`);
 			};
 			if (!disableCursorPos) {
 				closeActiveHrefBeforeCursorMove();
 				if (spanStart === 0 && lastRenderWasFullRow && y === lastRenderedY + 1) frameParts.push("\r\n");
-				else frameParts.push(spanStart === 0 ? rowCursorToCol1[y] : `\u001B[${y + 1};${spanStart + 1}H`);
+				else frameParts.push(spanStart === 0 ? rowCursorToCol1[y] : `\u001B[${y + 1 + rowOffset};${spanStart + 1}H`);
 			}
 			let currentKey = null;
 			let currentStyle = null;
@@ -12313,7 +12366,7 @@ function createStdoutRenderer(terminal, options) {
 				renderDirtySpans(y, row, spans, rewriteTail);
 			}
 		}
-		if (!rowsToRender && lastRenderedRows > size.rows && !rowsOnlyResizeBaseline) {
+		if (!rowsToRender && lastRenderedRows > size.rows && !rowsOnlyResizeBaseline && anchorMode !== "bottom") {
 			const extraRows = lastRenderedRows - size.rows;
 			if (activeStyleKey !== bgKey) {
 				frameParts.push(SGR_RESET, bgSeq);
@@ -12364,7 +12417,7 @@ function createStdoutRenderer(terminal, options) {
 				const spans = terminalGraphicTextPreserveSpans.get(y);
 				const preservedGraphicSpan = !(overlayTouchedRowSet === null || overlayTouchedRowSet === void 0 ? void 0 : overlayTouchedRowSet.has(y)) && Boolean(spans === null || spans === void 0 ? void 0 : spans.some((span) => span.start < rect.x + rect.w && span.end > rect.x));
 				if ((!rowsToRender || rowWasPaintedByTextRenderer(y)) && !preservedGraphicSpan) continue;
-				out$1 += `\u001B[${y + 1};${rect.x + 1}H${clearStyle}${erase}${SGR_RESET}`;
+				out$1 += `\u001B[${y + 1 + rowOffset};${rect.x + 1}H${clearStyle}${erase}${SGR_RESET}`;
 			}
 			return out$1;
 		};
@@ -12410,7 +12463,7 @@ function createStdoutRenderer(terminal, options) {
 					x: rect.x,
 					y: rect.y
 				} : clampCellToViewport(fallbackCell, size);
-				frameParts.push(countGraphicsBytes(`\u001B[${cell.y + 1};${cell.x + 1}H`), countGraphicsBytes(maybeWrapTerminalGraphic(sequence)), countGraphicsBytes(SGR_RESET));
+				frameParts.push(countGraphicsBytes(`\u001B[${cell.y + 1 + rowOffset};${cell.x + 1}H`), countGraphicsBytes(maybeWrapTerminalGraphic(sequence)), countGraphicsBytes(SGR_RESET));
 				return true;
 			};
 			const appendActiveGraphicProtocolClear = (active, rect) => {
@@ -12586,7 +12639,7 @@ function createStdoutRenderer(terminal, options) {
 						y
 					};
 					closeActiveHrefBeforeCursorMove();
-					frameParts.push(`\u001B[${y + 1};${x + 1}H`);
+					frameParts.push(`\u001B[${y + 1 + rowOffset};${x + 1}H`);
 				}
 			}
 		}
@@ -12598,7 +12651,7 @@ function createStdoutRenderer(terminal, options) {
 		}
 		if (enableOsc8Links && activeStyle.href) frameParts.push(OSC8_CLOSE);
 		frameParts.push(SGR_RESET);
-		if (hideCursor && !getImeAnchor) frameParts.push(CURSOR_HOME);
+		if (hideCursor && !getImeAnchor) frameParts.push(rowOffset > 0 ? `\u001B[${rowOffset + 1}H` : CURSOR_HOME);
 		frameParts.push(allowGraphicsOnlyWithoutBaseline || keepLineWrapDisabled ? "" : "\x1B[?7h");
 		frameParts.push(useFrameSyncOutput ? SYNC_END : "");
 		const frame = frameParts.join("");
@@ -13039,7 +13092,7 @@ function createStdoutRenderer(terminal, options) {
 	if (altScreen && outputIsTTY) out.write("\x1B[?1049h");
 	if (keepLineWrapDisabled) out.write("\x1B[?7l");
 	if (hideCursor) out.write("\x1B[?25l");
-	if (clear) out.write(`${SGR_RESET}${openBg(defaultBg)}\u001B[2J\u001B[H${SGR_RESET}`);
+	if (clear && anchorMode !== "bottom") out.write(`${SGR_RESET}${openBg(defaultBg)}\u001B[2J\u001B[H${SGR_RESET}`);
 	const off = terminal.on("commit", ({ dirtyRows, scrollOperations, sync }) => {
 		if (suppressNextResizeCommitRender) return;
 		const deferRowsOnlyResizeCommit = rowsOnlyResizeRepaintTimer && (dirtyRows == null || dirtyRows.length >= terminal.size().rows);
@@ -13121,7 +13174,7 @@ function createStdoutRenderer(terminal, options) {
 			cols: size.cols,
 			rows: size.rows
 		});
-		out.write(`\u001B[${cy + 1};${cx + 1}H`);
+		out.write(`\u001B[${cy + 1 + rowOffset};${cx + 1}H`);
 		lastCursorX = cx;
 		lastCursorY = cy;
 	}
@@ -13175,7 +13228,7 @@ function createStdoutRenderer(terminal, options) {
 							cellX: active.x,
 							cellY: active.y
 						}, size);
-						clearParts.push(`\u001B[${cell.y + 1};${cell.x + 1}H`, maybeWrapTerminalGraphic(active.clearSequence));
+						clearParts.push(`\u001B[${cell.y + 1 + rowOffset};${cell.x + 1}H`, maybeWrapTerminalGraphic(active.clearSequence));
 						wroteClear = true;
 					}
 					if (wroteClear) terminalGraphicsClears++;
@@ -13211,6 +13264,7 @@ function createStdoutRenderer(terminal, options) {
 			if (keepLineWrapDisabled) out.write("\x1B[?7h");
 			if (hideCursor) out.write("\x1B[?25h");
 			if (altScreen && outputIsTTY) out.write("\x1B[?1049l");
+			if (anchorMode === "bottom" && outputIsTTY && scrollRegionBottom > 0) out.write("\x1B[r");
 		} catch (err) {
 			if (disposeError == null) disposeError = err;
 		}
@@ -13237,6 +13291,7 @@ function createStdoutRenderer(terminal, options) {
 		capabilities: STDOUT_RENDERER_CAPABILITIES,
 		graphicsCapabilities,
 		render,
+		forceRender: () => render(void 0, true),
 		dispose,
 		setCursor,
 		showCursor,

package/dist/core.js

@@ -1,6 +1,6 @@
-import { TERMINAL_RENDER_PLANES, createTerminal, isSafeRelativeHref, parseAnsiSgr, sanitizeDomHref, sanitizeTerminalHref } from "./hyperlink-_1FAj7Wq.js";
-import { charCellWidth } from "./width-GqllnV8C.js";
-import { ansiColorRgb } from "./ansi-palette-CH6jc2Z7.js";
+import { TERMINAL_RENDER_PLANES, charCellWidth, createTerminal, parseAnsiSgr } from "./create-terminal-Db_-UGVQ.js";
+import { ansiColorRgb } from "./ansi-palette-BHF1rN7R.js";
+import { isSafeRelativeHref, sanitizeDomHref, sanitizeTerminalHref } from "./hyperlink-clbb_ha_.js";
 import { firstNonEmptyEnv } from "./env-Cl8qmNFN.js";
 import { normalizeNewlines } from "./path-mnSgEpCm.js";
 import { parsePathQuery, resolveUserPath, suggestParentHint, suggestPaths } from "./path-suggest-Dndu4dTi.js";