@simon_he/vue-tui 1.1.5 → 1.1.7

package/dist/agent.js

@@ -1,19 +1,21 @@
 import "./create-terminal-Db_-UGVQ.js";
 import "./hyperlink-clbb_ha_.js";
 import { forEachTextCellSegment, recordTerminalGraphicTrace, sanitizeInlineText, sanitizeTextBlock, sliceByCells, spaces, textCellWidth$1 as textCellWidth, useTerminal, withTextWidthProvider } from "./rect-JzWMJxxc.js";
-import { TText, TView } from "./linkify-CL9wwnZN.js";
+import "./linkify-CklfA1vp.js";
 import "./frame-perf-CHpWhbC4.js";
 import "./env-Cl8qmNFN.js";
 import "./terminal-selection-4W1SJj4c.js";
 import "./debug-logger-CmsGI4of.js";
-import { TBox, TCommandPalette, TDialog, TInput, TRenderPlane, TSelect, computeCommandPaletteMatchRanges } from "./TSelect-CMBOOFwK.js";
-import "./path-mnSgEpCm.js";
-import "./wheel-scroll-DASkEZr-.js";
-import { TMermaid$1 as TMermaid, TMermaidText$1 as TMermaidText, isSimpleMermaidFlowchartSource, markMermaidRenderErrorFatal } from "./TMermaidText-wLnMMvVS.js";
-import { createIterm2InlineImageSequence, createKittyDeleteGraphicsSequence, createKittyGraphicsSequence, createKittyPlacementSequence, createTerminalGraphicPngSequence, detectTerminalGraphicsCapabilities, getTerminalGraphicsOutput, getTerminalGraphicsOutputVersion, hashTerminalGraphicsString, isSafeTerminalGraphicsSequence, normalizeTerminalGraphicSize, sanitizeTerminalFallbackText, subscribeTerminalGraphicsOutput } from "./terminal-graphics-2FTRg9x3.js";
-import { TVirtualMarkdown, createMarkdownBlockSource } from "./block-source-DhzajB9H.js";
-import "./math-image-BZhmfUeu.js";
-import { TAgentTerminalGraphic, TLogLinksPanel, TLogMinimap, TLogScrollbar, TLogSearchBar, TLogSearchPager, TLogSearchResults, TLogView, TLogVirtualLinksPanel, TLogVirtualSearchResults, TTranscriptView, TVirtualList, createAppendOnlyLogStore, createTLogDensityBucketsFromMarkers, createTLogLevelPlugin, createTLogLineMatcherPlugin, createTLogLinkActionPlugin, createTLogOsc8LinkPlugin, createTLogUrlPlugin, detectTLogUrls, dispatchTLogPluginLinkAction, getTLogPluginMetadata, parseTLogAnnotatedText, resolveTLogLinksPanelTheme, resolveTLogMinimapTheme, resolveTLogScrollbarTheme, resolveTLogSearchBarTheme, resolveTLogSearchPagerTheme, resolveTLogSearchResultsTheme, resolveTLogViewTheme, stripTLogAnsiText, tlogDarkPreset, tlogDarkTheme, tlogDefaultPreset, tlogDefaultTheme, tlogHighContrastPreset, tlogHighContrastTheme, toTLogExternalLinkFromVisibleLink, useTLogLinkController, useTLogRetainedIndex, useTLogSearchController, useTLogSearchResultsPage, useTLogVirtualSearchResults } from "./tlog-theme-B91Wv7Zj.js";
+import { TBox, TCommandPalette, TDialog, TInput, TRenderPlane, TSelect, computeCommandPaletteMatchRanges } from "./TSelect-CCsjjCOr.js";
+import { TText, TView } from "./frame-mailbox-DaTrfyaF.js";
+import "./path-BI9W15Zt.js";
+import "./wheel-scroll-CQ22Hcyj.js";
+import { TMermaid$1 as TMermaid, TMermaidText$1 as TMermaidText, isSimpleMermaidFlowchartSource, markMermaidRenderErrorFatal } from "./TMermaidText-C1akgJPU.js";
+import { createIterm2InlineImageSequence, createKittyDeleteGraphicsSequence, createKittyGraphicsSequence, createKittyPlacementSequence, createTerminalGraphicPngSequence, detectTerminalGraphicsCapabilities, getTerminalGraphicsOutput, getTerminalGraphicsOutputVersion, hashTerminalGraphicsString, isSafeTerminalGraphicsSequence, normalizeTerminalGraphicSize, sanitizeTerminalFallbackText, subscribeTerminalGraphicsOutput } from "./terminal-graphics-DpSL29OQ.js";
+import { TVirtualMarkdown, createMarkdownBlockSource } from "./block-source-BhvdZomx.js";
+import "./math-image-CcUpBnW0.js";
+import { TLogLinksPanel, TLogMinimap, TLogScrollbar, TLogSearchBar, TLogSearchPager, TLogSearchResults, TLogView, TLogVirtualLinksPanel, TLogVirtualSearchResults, TTranscriptView, TVirtualList, createAppendOnlyLogStore, createTLogDensityBucketsFromMarkers, createTLogLevelPlugin, createTLogLineMatcherPlugin, createTLogLinkActionPlugin, createTLogOsc8LinkPlugin, createTLogUrlPlugin, detectTLogUrls, dispatchTLogPluginLinkAction, getTLogPluginMetadata, parseTLogAnnotatedText, resolveTLogLinksPanelTheme, resolveTLogMinimapTheme, resolveTLogScrollbarTheme, resolveTLogSearchBarTheme, resolveTLogSearchPagerTheme, resolveTLogSearchResultsTheme, resolveTLogViewTheme, stripTLogAnsiText, tlogDarkPreset, tlogDarkTheme, tlogDefaultPreset, tlogDefaultTheme, tlogHighContrastPreset, tlogHighContrastTheme, toTLogExternalLinkFromVisibleLink, useTLogLinkController, useTLogRetainedIndex, useTLogSearchController, useTLogSearchResultsPage, useTLogVirtualSearchResults } from "./tlog-theme-BnILsD3n.js";
+import { TAgentTerminalGraphic } from "./TAgentTerminalGraphic-B8-YZfuP.js";
 import { computed, defineComponent, h } from "vue";
 
 //#region src/vue/agent/view-models.ts

package/dist/{block-source-DhzajB9H.js → block-source-BhvdZomx.js}

@@ -1,10 +1,10 @@
 import { hasEncodedControl, sanitizeDomHref } from "./hyperlink-clbb_ha_.js";
-import { EventZIndexContextKey, currentTextWidthProvider, forEachTextCellSegment, intersectRect, normalizeCellRect, repeatChar, sanitizeInlineText, sanitizeTextBlock, sliceByCellsRange, spaces, textCellWidth$1 as textCellWidth, translateRect, useLayout, useRenderNode, useTerminal, useTerminalNode, useVisibility, withTextWidthProvider } from "./rect-JzWMJxxc.js";
+import { EventZIndexContextKey, RenderPlaneContextKey, currentTextWidthProvider, forEachTextCellSegment, intersectRect, normalizeCellRect, repeatChar, sanitizeInlineText, sanitizeTextBlock, sliceByCellsRange, spaces, textCellWidth$1 as textCellWidth, translateRect, useLayout, useRenderNode, useTerminal, useTerminalNode, useVisibility, withTextWidthProvider } from "./rect-JzWMJxxc.js";
 import { terminalSelectionRowSpans, terminalSelectionVisibleRowSpans } from "./terminal-selection-4W1SJj4c.js";
 import { createDebugLogger, isDebugEnabled } from "./debug-logger-CmsGI4of.js";
-import { applyWheelScroll, createWheelScrollState, resetWheelScrollState } from "./wheel-scroll-DASkEZr-.js";
-import { createIterm2InlineImageSequence, createKittyDeleteGraphicsSequence, createKittyGraphicsSequence, createKittyPlacementSequence, getTerminalGraphicsOutput, getTerminalGraphicsOutputVersion, isTerminalGraphicsProtocol, stableTerminalGraphicNumericId, subscribeTerminalGraphicsOutput } from "./terminal-graphics-2FTRg9x3.js";
-import { enqueueMarkdownMathImages, getCachedMarkdownMathImage, isMarkdownMathImageRendererReady, loadMarkdownMathImageRenderer, resolveMarkdownMathColor, subscribeMarkdownMathImage } from "./math-image-BZhmfUeu.js";
+import { applyWheelScroll, createWheelScrollState, resetWheelScrollState } from "./wheel-scroll-CQ22Hcyj.js";
+import { createIterm2InlineImageSequence, createKittyDeleteGraphicsSequence, createKittyGraphicsSequence, createKittyPlacementSequence, getTerminalGraphicsOutput, getTerminalGraphicsOutputVersion, isTerminalGraphicsProtocol, stableTerminalGraphicNumericId, subscribeTerminalGraphicsOutput } from "./terminal-graphics-DpSL29OQ.js";
+import { enqueueMarkdownMathImages, getCachedMarkdownMathImage, isMarkdownMathImageRendererReady, loadMarkdownMathImageRenderer, resolveMarkdownMathColor, subscribeMarkdownMathImage } from "./math-image-CcUpBnW0.js";
 import { computed, defineComponent, getCurrentInstance, h, inject, markRaw, onBeforeUnmount, ref, shallowRef, watch, watchEffect } from "vue";
 import { getMarkdown, parseMarkdownToStructure } from "stream-markdown-parser";
 
@@ -1696,8 +1696,70 @@ function mergeStyle(base, overlay) {
 	return merged;
 }
 const activeMarkdownImageGraphics = new WeakMap();
+const markdownImageGraphicIdCache = new WeakMap();
+const preparedMarkdownImageGraphicCache = new WeakMap();
 function markdownImageGraphicId(segment, identity) {
-	return `md-image:${stableTerminalGraphicNumericId(`${identity}:${segment.src ?? segment.tex ?? ""}:${segment.displayWidth ?? 0}:${segment.displayHeight ?? 0}:${segment.base64 ?? ""}`)}`;
+	let cachedIds = markdownImageGraphicIdCache.get(segment);
+	if (!cachedIds) {
+		cachedIds = new Map();
+		markdownImageGraphicIdCache.set(segment, cachedIds);
+	}
+	const cached = cachedIds.get(identity);
+	if (cached) return cached;
+	const id = `md-image:${stableTerminalGraphicNumericId(`${identity}:${segment.src ?? segment.tex ?? ""}:${segment.displayWidth ?? 0}:${segment.displayHeight ?? 0}:${segment.base64 ?? ""}`)}`;
+	cachedIds.set(identity, id);
+	return id;
+}
+function prepareMarkdownImageGraphic(segment, identity, protocol, placement) {
+	if (!segment.base64) return null;
+	let preparedByVariant = preparedMarkdownImageGraphicCache.get(segment);
+	if (!preparedByVariant) {
+		preparedByVariant = new Map();
+		preparedMarkdownImageGraphicCache.set(segment, preparedByVariant);
+	}
+	const cacheKey = `${identity}\u0000${protocol}\u0000${placement.width}\u0000${placement.height}\u0000${placement.sourceX ?? ""}\u0000${placement.sourceY ?? ""}\u0000${placement.sourceWidth ?? ""}\u0000${placement.sourceHeight ?? ""}`;
+	const cached = preparedByVariant.get(cacheKey);
+	if (cached) return cached;
+	const id = markdownImageGraphicId(segment, identity);
+	const imageId = stableTerminalGraphicNumericId(`image:${id}`);
+	const placementId = stableTerminalGraphicNumericId(`placement:${id}`);
+	const sequence = protocol === "kitty" ? createKittyGraphicsSequence(segment.base64, {
+		imageId,
+		placementId,
+		columns: placement.width,
+		rows: placement.height,
+		sourceX: placement.sourceX,
+		sourceY: placement.sourceY,
+		sourceWidth: placement.sourceWidth,
+		sourceHeight: placement.sourceHeight,
+		zIndex: -1
+	}) : protocol === "iterm2" ? createIterm2InlineImageSequence(segment.base64, {
+		width: placement.width,
+		height: placement.height,
+		preserveAspectRatio: true,
+		doNotMoveCursor: true
+	}) : "";
+	if (!sequence) return null;
+	const prepared = Object.freeze({
+		id,
+		sequence,
+		clearSequence: protocol === "kitty" ? createKittyDeleteGraphicsSequence({
+			imageId,
+			placementId
+		}) : void 0,
+		resizeSequence: protocol === "kitty" ? createKittyPlacementSequence({
+			imageId,
+			placementId,
+			columns: placement.width,
+			rows: placement.height,
+			sourceX: placement.sourceX,
+			sourceY: placement.sourceY,
+			sourceWidth: placement.sourceWidth,
+			sourceHeight: placement.sourceHeight
+		}) : void 0
+	});
+	preparedByVariant.set(cacheKey, prepared);
+	return prepared;
 }
 function rememberMarkdownImageGraphic(terminal, id, rect) {
 	let active = activeMarkdownImageGraphics.get(terminal);
@@ -1736,57 +1798,36 @@ function clearMarkdownImageGraphics(terminal, rect) {
 		clearTrackedMarkdownImageGraphic(terminal, id);
 	}
 }
-function queueMarkdownImageGraphic(terminal, segment, identity, rect) {
+function queueMarkdownImageGraphic(terminal, segment, identity, rect, placementOverride) {
 	if (!segment.base64) return "unavailable";
 	const output = getTerminalGraphicsOutput(terminal);
 	const protocol = output?.capabilities.preferredProtocol;
 	if (!output?.capabilities.supported || !isTerminalGraphicsProtocol(protocol)) return "unavailable";
-	const width = Math.max(1, Math.floor(segment.displayWidth ?? rect.w));
-	const height = Math.max(1, Math.floor(segment.displayHeight ?? 1));
-	const id = markdownImageGraphicId(segment, identity);
-	const imageId = stableTerminalGraphicNumericId(`image:${id}`);
-	const placementId = stableTerminalGraphicNumericId(`placement:${id}`);
-	const sequence = protocol === "kitty" ? createKittyGraphicsSequence(segment.base64, {
-		imageId,
-		placementId,
-		columns: width,
-		rows: height,
-		zIndex: -1
-	}) : protocol === "iterm2" ? createIterm2InlineImageSequence(segment.base64, {
-		width,
-		height,
-		preserveAspectRatio: true,
-		doNotMoveCursor: true
-	}) : "";
-	if (!sequence) return "unavailable";
-	const clearSequence = protocol === "kitty" ? createKittyDeleteGraphicsSequence({
-		imageId,
-		placementId
-	}) : void 0;
-	const resizeSequence = protocol === "kitty" ? createKittyPlacementSequence({
-		imageId,
-		placementId,
-		columns: width,
-		rows: height
-	}) : void 0;
+	const placement = placementOverride ?? {
+		width: Math.max(1, Math.floor(segment.displayWidth ?? rect.w)),
+		height: Math.max(1, Math.floor(segment.displayHeight ?? 1))
+	};
+	const prepared = prepareMarkdownImageGraphic(segment, identity, protocol, placement);
+	if (!prepared) return "unavailable";
 	const accepted = output.queue({
-		id,
+		id: prepared.id,
 		x: rect.x,
 		y: rect.y,
-		w: width,
-		h: height,
+		w: placement.width,
+		h: placement.height,
 		protocol,
-		sequence,
-		resizeSequence,
-		clearSequence,
+		sequence: prepared.sequence,
+		resizeSequence: prepared.resizeSequence,
+		clearSequence: prepared.clearSequence,
+		placementMoveWithoutClear: protocol === "kitty",
 		fallbackText: segment.alt ?? (segment.kind === "math" ? segment.raw ?? segment.tex ?? "math" : "image")
 	});
-	markdownImageDebug(`queue id=${id}`, `accepted=${accepted ? "true" : "false"}`, `x=${rect.x}`, `y=${rect.y}`, `w=${width}`, `h=${height}`, `visibleW=${rect.w}`, `displayW=${segment.displayWidth ?? ""}`, `displayH=${segment.displayHeight ?? ""}`);
-	if (accepted) rememberMarkdownImageGraphic(terminal, id, {
+	markdownImageDebug(`queue id=${prepared.id}`, `accepted=${accepted ? "true" : "false"}`, `x=${rect.x}`, `y=${rect.y}`, `w=${placement.width}`, `h=${placement.height}`, `visibleW=${rect.w}`, `displayW=${segment.displayWidth ?? ""}`, `displayH=${segment.displayHeight ?? ""}`);
+	if (accepted) rememberMarkdownImageGraphic(terminal, prepared.id, {
 		x: rect.x,
 		y: rect.y,
-		w: width,
-		h: height
+		w: placement.width,
+		h: placement.height
 	});
 	return accepted ? "queued" : "rejected";
 }
@@ -1809,7 +1850,6 @@ function collectVisibleMarkdownImageGraphicIds(rows, options) {
 			logicalX = segmentEnd;
 			if (!segment.graphic) continue;
 			if (segmentEnd <= clipStart || segmentStart >= clipEnd) continue;
-			if (Math.max(segmentStart, clipStart) !== segmentStart) continue;
 			const height = Math.max(1, Math.floor(segment.graphic.displayHeight ?? 1));
 			if (rowIndex + height <= firstRow || rowIndex >= lastRow) continue;
 			const rect = {
@@ -1824,6 +1864,67 @@ function collectVisibleMarkdownImageGraphicIds(rows, options) {
 	}
 	return keepIds;
 }
+function queueClippedVisibleMarkdownImageGraphics(terminal, rows, options) {
+	const queuedIds = new Set();
+	const output = getTerminalGraphicsOutput(terminal);
+	if (options.w <= 0 || options.h <= 0 || !output?.capabilities.supported || output.capabilities.preferredProtocol !== "kitty") return queuedIds;
+	const clipStart = Math.max(0, Math.floor(options.clipStart));
+	const firstRow = Math.min(rows.length, Math.max(0, Math.floor(options.rowOffset)));
+	const lastRow = Math.min(rows.length, firstRow + Math.max(0, Math.floor(options.h)));
+	let scanStart = firstRow;
+	while (scanStart > 0 && (rows[scanStart]?.segments.length ?? 0) === 0) scanStart--;
+	for (let rowIndex = scanStart; rowIndex < lastRow; rowIndex++) {
+		const row = rows[rowIndex];
+		if (!row) continue;
+		let logicalX = 0;
+		for (const [segmentIndex, segment] of row.segments.entries()) {
+			const segmentStart = logicalX;
+			logicalX += segment.cells;
+			if (!segment.graphic?.base64) continue;
+			const fullWidth = Math.max(1, Math.floor(segment.graphic.displayWidth ?? segment.cells));
+			const fullHeight = Math.max(1, Math.floor(segment.graphic.displayHeight ?? 1));
+			const fullRect = {
+				x: options.x + segmentStart - clipStart,
+				y: options.y + rowIndex - firstRow,
+				w: fullWidth,
+				h: fullHeight
+			};
+			const visibleRect = {
+				x: Math.max(options.x, fullRect.x),
+				y: Math.max(options.y, fullRect.y),
+				w: Math.min(options.x + options.w, fullRect.x + fullRect.w) - Math.max(options.x, fullRect.x),
+				h: Math.min(options.y + options.h, fullRect.y + fullRect.h) - Math.max(options.y, fullRect.y)
+			};
+			if (visibleRect.w <= 0 || visibleRect.h <= 0) continue;
+			if (visibleRect.x === fullRect.x && visibleRect.y === fullRect.y && visibleRect.w === fullRect.w && visibleRect.h === fullRect.h) continue;
+			if (options.isGraphicCovered?.(visibleRect)) continue;
+			const naturalWidth = Math.floor(segment.graphic.naturalWidth ?? 0);
+			const naturalHeight = Math.floor(segment.graphic.naturalHeight ?? 0);
+			if (naturalWidth <= 0 || naturalHeight <= 0) continue;
+			const offsetX = visibleRect.x - fullRect.x;
+			const offsetY = visibleRect.y - fullRect.y;
+			const sourceX = Math.floor(offsetX * naturalWidth / fullWidth);
+			const sourceY = Math.floor(offsetY * naturalHeight / fullHeight);
+			const sourceRight = Math.max(sourceX + 1, Math.min(naturalWidth, Math.ceil((offsetX + visibleRect.w) * naturalWidth / fullWidth)));
+			const sourceBottom = Math.max(sourceY + 1, Math.min(naturalHeight, Math.ceil((offsetY + visibleRect.h) * naturalHeight / fullHeight)));
+			const identity = `${row.key}:${segmentIndex}`;
+			const result = queueMarkdownImageGraphic(terminal, segment.graphic, identity, {
+				x: visibleRect.x,
+				y: visibleRect.y,
+				w: visibleRect.w
+			}, {
+				width: visibleRect.w,
+				height: visibleRect.h,
+				sourceX,
+				sourceY,
+				sourceWidth: sourceRight - sourceX,
+				sourceHeight: sourceBottom - sourceY
+			});
+			if (result === "queued") queuedIds.add(markdownImageGraphicId(segment.graphic, identity));
+		}
+	}
+	return queuedIds;
+}
 function paintMarkdownVisualRow(terminal, row, options) {
 	const clipStart = Math.max(0, Math.floor(options.clipStart ?? 0));
 	const clipEnd = clipStart + options.w;
@@ -1874,7 +1975,8 @@ function paintMarkdownVisualRow(terminal, row, options) {
 				h: Math.max(1, Math.floor(segment.graphic.displayHeight ?? 1))
 			};
 			const graphicCovered = options.isGraphicCovered?.(graphicRect) === true;
-			const queueResult = !graphicCovered && visibleStart === segmentStart && visibleCells > 0 && queueMarkdownImageGraphic(terminal, segment.graphic, `${row.key}:${segmentIndex}`, {
+			const graphicId = markdownImageGraphicId(segment.graphic, `${row.key}:${segmentIndex}`);
+			const queueResult = options.prequeuedGraphicIds?.has(graphicId) === true ? "queued" : !graphicCovered && visibleStart === segmentStart && visibleCells > 0 && queueMarkdownImageGraphic(terminal, segment.graphic, `${row.key}:${segmentIndex}`, {
 				x: cellX,
 				y: options.y,
 				w: visibleCells
@@ -1882,7 +1984,7 @@ function paintMarkdownVisualRow(terminal, row, options) {
 			const graphicAvailable = queueResult || canAttemptMarkdownImageGraphic(terminal, segment.graphic);
 			const queuedGraphic = queueResult === "queued";
 			const suppressFallback = queuedGraphic || queueResult === "rejected" || graphicAvailable === true;
-			if (queuedGraphic) queuedGraphics.add(markdownImageGraphicId(segment.graphic, `${row.key}:${segmentIndex}`));
+			if (queuedGraphic) queuedGraphics.add(graphicId);
 			terminal.write(suppressFallback ? spaces(visibleCells) : sliceByCellsRange(segment.fallbackText ?? segment.graphic.alt ?? (segment.graphic.kind === "math" ? segment.graphic.raw ?? segment.graphic.tex ?? "math" : "image"), 0, visibleCells) || spaces(visibleCells), {
 				x: cellX,
 				y: options.y,
@@ -1956,13 +2058,19 @@ function markdownStyleSignature(style) {
 		style.href ?? ""
 	].join("
");
 }
+const markdownRowSignatureCache = new WeakMap();
+const markdownRowGraphicSignatureCache = new WeakMap();
 function markdownRowSignature(row) {
 	if (!row) return "";
-	return [
+	const cached = markdownRowSignatureCache.get(row);
+	if (cached != null) return cached;
+	const signature = [
 		row.key,
 		row.plainText,
 		row.segments.map((segment) => `${segment.text}\u0001${segment.cells}\u0001${markdownStyleSignature(segment.style)}\u0001${segment.graphic?.src ?? ""}\u0001${segment.graphic?.base64 ?? ""}\u0001${segment.fallbackText ?? ""}`).join("")
 	].join("");
+	markdownRowSignatureCache.set(row, signature);
+	return signature;
 }
 function getWheelScrollInput(e) {
 	const deltaY = Number(e.deltaY ?? 0);
@@ -1986,7 +2094,11 @@ function getWheelScrollInput(e) {
 }
 function rowGraphicSignature(row) {
 	if (!row) return "";
-	return row.segments.map((segment) => segment.graphic ? `${segment.graphic.kind}\u0001${segment.graphic.src}\u0001${segment.graphic.base64 ?? ""}` : "").join("");
+	const cached = markdownRowGraphicSignatureCache.get(row);
+	if (cached != null) return cached;
+	const signature = row.segments.filter((segment) => segment.graphic).map((segment) => `${segment.graphic.kind}\u0001${segment.graphic.src}\u0001${segment.graphic.base64 ?? ""}`).join("");
+	markdownRowGraphicSignatureCache.set(row, signature);
+	return signature;
 }
 const TVirtualMarkdown = defineComponent({
 	name: "TVirtualMarkdown",
@@ -2118,6 +2230,10 @@ const TVirtualMarkdown = defineComponent({
 		imageOcclusionRects: {
 			type: Array,
 			default: void 0
+		},
+		rowScrollMode: {
+			type: String,
+			default: "off"
 		}
 	},
 	emits: {
@@ -2132,10 +2248,11 @@ const TVirtualMarkdown = defineComponent({
 	},
 	setup(props, { emit }) {
 		const instance = getCurrentInstance();
-		const { terminal, defaultStyle, events, scheduler, selection, widthProvider } = useTerminal();
+		const { terminal, defaultStyle, events, scheduler, selection, widthProvider, render, rendererCapabilities } = useTerminal();
 		const layout = useLayout();
 		const { visible, rootProps } = useVisibility();
 		const parentEventZ = inject(EventZIndexContextKey, computed(() => 0));
+		const plane = inject(RenderPlaneContextKey, ref("default"));
 		const eventZ = computed(() => (parentEventZ.value ?? 0) + (props.zIndex ?? 0));
 		const internalScrollTop = ref(0);
 		const documentVersion = ref(0);
@@ -2146,6 +2263,8 @@ const TVirtualMarkdown = defineComponent({
 		let rebuildVersion = 0;
 		let layoutCache;
 		let alive = true;
+		let dirtyRowsHint;
+		let renderNodeId = null;
 		const parser = shallowRef(markRaw(createTuiMarkdownParser({
 			streaming: props.streaming,
 			customHtmlTags: props.customHtmlTags
@@ -2225,6 +2344,13 @@ const TVirtualMarkdown = defineComponent({
 			const nextVisibleGraphics = visibleRowGraphics(nextRows, nextScrollTop);
 			const visibleChanged = prevVisibleRows.length !== nextVisibleRows.length || prevVisibleRows.some((row, index) => row !== nextVisibleRows[index]) || prevVisibleGraphics.some((row, index) => row !== nextVisibleGraphics[index]);
 			if (!builtOnce || prevScrollTop !== nextScrollTop || visibleChanged) {
+				if (visibleChanged && prevScrollTop === nextScrollTop && prevVisibleGraphics.every((signature) => !signature) && nextVisibleGraphics.every((signature) => !signature)) {
+					const rect = normalizedRect();
+					const changedRows = [];
+					const count = Math.max(prevVisibleRows.length, nextVisibleRows.length);
+					for (let index = 0; index < count; index++) if (prevVisibleRows[index] !== nextVisibleRows[index]) changedRows.push(rect.y + index);
+					markRowsDirty(changedRows);
+				} else markRowsDirty(viewportRows());
 				documentVersion.value++;
 				selection.refresh();
 			}
@@ -2301,6 +2427,52 @@ const TVirtualMarkdown = defineComponent({
 			for (let index = start; index < end; index++) out.push(rowGraphicSignature(sourceRows[index]));
 			return out;
 		}
+		function viewportRows() {
+			const rect = normalizedRect();
+			const result = [];
+			for (let y = rect.y; y < rect.y + rect.h; y++) result.push(y);
+			return result;
+		}
+		function exposedRowsForDelta(y, height, delta) {
+			const result = [];
+			if (delta > 0) for (let offset = height - delta; offset < height; offset++) result.push(y + offset);
+			else for (let offset = 0; offset < -delta; offset++) result.push(y + offset);
+			return result;
+		}
+		function markRowsDirty(nextRows) {
+			const rows$1 = new Set(dirtyRowsHint);
+			for (const y of nextRows) rows$1.add(y);
+			dirtyRowsHint = Array.from(rows$1).sort((a, b) => a - b);
+			if (renderNodeId) render.markDirtyRows(renderNodeId, dirtyRowsHint);
+		}
+		function visibleGraphicsAt(scrollTop) {
+			const rect = normalizedRect();
+			const { x: clipX, y: clipY } = clipOffsets();
+			return collectVisibleMarkdownImageGraphicIds(rows.value, {
+				x: rect.x,
+				y: rect.y,
+				w: rect.w,
+				h: rect.h,
+				rowOffset: scrollTop + clipY,
+				clipStart: clipX
+			}).size > 0;
+		}
+		function isClipped() {
+			const rect = normalizedRect();
+			const full = normalizedFullRect();
+			return rect.x !== full.x || rect.y !== full.y || rect.w !== full.w || rect.h !== full.h;
+		}
+		function markScrollDamage(prevTop, nextTop) {
+			const rect = normalizedRect();
+			const delta = nextTop - prevTop;
+			if (rect.h <= 0 || !delta) return;
+			const size = terminal.size();
+			const canShiftRows = props.rowScrollMode === "unsafe-full-row" && rendererCapabilities.value.scrollOperations && rect.x === 0 && rect.w >= size.cols && rect.y >= 0 && rect.y + rect.h <= size.rows && !isClipped() && Math.abs(delta) < rect.h && !dirtyRowsHint?.length && !visibleGraphicsAt(prevTop);
+			if (canShiftRows) {
+				render.unsafeScrollPlaneRows(plane.value, rect.y, rect.y + rect.h, delta);
+				markRowsDirty(exposedRowsForDelta(rect.y, rect.h, delta));
+			} else markRowsDirty(viewportRows());
+		}
 		function hasControlledScrollTop() {
 			return Object.prototype.hasOwnProperty.call(instance?.vnode.props ?? {}, "scrollTop");
 		}
@@ -2308,7 +2480,10 @@ const TVirtualMarkdown = defineComponent({
 			const desired = Math.floor(Number(next) || 0);
 			const clamped = clamp(desired, 0, maxScrollTop());
 			const changed = internalScrollTop.value !== clamped;
-			if (changed) internalScrollTop.value = clamped;
+			if (changed) {
+				markScrollDamage(internalScrollTop.value, clamped);
+				internalScrollTop.value = clamped;
+			}
 			if (desired !== clamped) {
 				emit("update:scrollTop", clamped);
 				emit("scroll", clamped);
@@ -2319,7 +2494,10 @@ const TVirtualMarkdown = defineComponent({
 			const desired = Math.floor(Number(next) || 0);
 			const clamped = clamp(desired, 0, maxScrollTop());
 			const changed = internalScrollTop.value !== clamped;
-			if (changed) internalScrollTop.value = clamped;
+			if (changed) {
+				markScrollDamage(internalScrollTop.value, clamped);
+				internalScrollTop.value = clamped;
+			}
 			if (emitChange && (changed || refreshOptions?.emitClampEvenIfUnchanged && desired !== clamped)) {
 				emit("update:scrollTop", clamped);
 				emit("scroll", clamped);
@@ -2572,7 +2750,7 @@ const TVirtualMarkdown = defineComponent({
 			unsubscribeMathImage();
 			clearMarkdownImageGraphics(terminal, fullRect.value);
 		});
-		useRenderNode(() => ({
+		const renderNode = useRenderNode(() => ({
 			zIndex: props.zIndex,
 			rect: visible.value ? normalizedRect() : {
 				x: 0,
@@ -2580,6 +2758,7 @@ const TVirtualMarkdown = defineComponent({
 				w: 0,
 				h: 0
 			},
+			dirtyRowsHint,
 			deps: [
 				visible.value,
 				absRect.value,
@@ -2592,6 +2771,7 @@ const TVirtualMarkdown = defineComponent({
 				props.imageOcclusionRects
 			],
 			paint: (dirtyRows) => {
+				dirtyRowsHint = void 0;
 				withTextWidthProvider(widthProvider, () => {
 					if (!visible.value) return;
 					const r = normalizedRect();
@@ -2601,6 +2781,15 @@ const TVirtualMarkdown = defineComponent({
 					const isGraphicCovered = (rect) => {
 						return props.imageOcclusionRects?.some((item) => intersectRect(rect, item)) === true;
 					};
+					const prequeuedGraphicIds = queueClippedVisibleMarkdownImageGraphics(terminal, rows.value, {
+						x: r.x,
+						y: r.y,
+						w: r.w,
+						h: r.h,
+						rowOffset: internalScrollTop.value + clipY,
+						clipStart: clipX,
+						isGraphicCovered
+					});
 					const keepGraphicIds = collectVisibleMarkdownImageGraphicIds(rows.value, {
 						x: r.x,
 						y: r.y,
@@ -2621,6 +2810,7 @@ const TVirtualMarkdown = defineComponent({
 							baseStyle,
 							clear: true,
 							keepGraphicIds,
+							prequeuedGraphicIds,
 							isGraphicCovered
 						});
 					};
@@ -2632,6 +2822,9 @@ const TVirtualMarkdown = defineComponent({
 				});
 			}
 		}));
+		watchEffect(() => {
+			renderNodeId = renderNode.id.value;
+		});
 		return () => h("span", rootProps);
 	}
 });