@simon_he/vue-tui 1.1.4 → 1.1.6

package/dist/cli.cjs

@@ -7355,7 +7355,7 @@ function pickBestTerminalGraphicsProtocol(protocols) {
 }
 function detectCandidates(env) {
   let candidates = [], term = String(envString2(env, "TERM") ?? "").toLowerCase(), termProgram = String(envString2(env, "TERM_PROGRAM") ?? "").toLowerCase(), termProgramVersion = String(envString2(env, "TERM_PROGRAM_VERSION") ?? "").toLowerCase();
-  return (envString2(env, "KITTY_WINDOW_ID") || envString2(env, "GHOSTTY_RESOURCES_DIR") || /(?:^|-)kitty(?:-|$)/i.test(term) || term.includes("ghostty") || termProgram.includes("ghostty")) && candidates.push("kitty"), (termProgram.includes("iterm") || termProgram.includes("wezterm") || envString2(env, "WEZTERM_PANE") || envString2(env, "WEZTERM_EXECUTABLE")) && candidates.push("iterm2"), (truthy(envString2(env, "VUE_TUI_SIXEL")) || truthy(envString2(env, "VUE_TUI_GRAPHICS_SIXEL")) || String(envString2(env, "TERMINAL_GRAPHICS") ?? "").toLowerCase().includes("sixel") || /\bsixel\b/i.test(`${term} ${termProgram} ${termProgramVersion}`)) && candidates.push("sixel"), uniqueProtocols(candidates);
+  return (envString2(env, "KITTY_WINDOW_ID") || envString2(env, "GHOSTTY_RESOURCES_DIR") || /(?:^|-)kitty(?:-|$)/i.test(term) || term.includes("ghostty") || termProgram.includes("ghostty") || termProgram.includes("wezterm") || envString2(env, "WEZTERM_PANE") || envString2(env, "WEZTERM_EXECUTABLE")) && candidates.push("kitty"), termProgram.includes("iterm") && candidates.push("iterm2"), (truthy(envString2(env, "VUE_TUI_SIXEL")) || truthy(envString2(env, "VUE_TUI_GRAPHICS_SIXEL")) || String(envString2(env, "TERMINAL_GRAPHICS") ?? "").toLowerCase().includes("sixel") || /\bsixel\b/i.test(`${term} ${termProgram} ${termProgramVersion}`)) && candidates.push("sixel"), uniqueProtocols(candidates);
 }
 function capabilitiesFor(protocol, input) {
   let supported = protocol === "kitty" || protocol === "iterm2" || protocol === "sixel", candidates = uniqueProtocols([...input.candidates ?? (supported ? [protocol] : [])]);
@@ -8000,7 +8000,7 @@ function createStdoutRenderer(terminal, options) {
         return "multi-span";
     }
   }
-  let effectiveDirtyRowPatchMode = resolveEffectiveDirtyRowPatchMode(), shouldUseDirtySpans = () => effectiveDirtyRowPatchMode !== "row", shouldUseMultiDirtySpans = () => effectiveDirtyRowPatchMode === "multi-span", enableOsc8Links = outputAllowsOsc8Links && !isVscodeTerminal, renderedHref = (value) => enableOsc8Links ? normalizeHref(value) : null, disposed = !1, lastFrameTime = 0, pendingRender = !1, renderTimer = null, rowsOnlyResizeRepaintTimer = null, writeEmaMs = 0, lastCursorX = null, lastCursorY = null, accumulatedAllRows = !1, accumulatedDirtyBits = null, accumulatedDirtyCount = 0, accumulatedDirtyMin = Number.POSITIVE_INFINITY, accumulatedDirtyMax = -1, accumulatedDirtyRowsRequireRepaint = !1, accumulatedScrollOperations = null, allowNextGraphicsOnlyRenderWithoutBaseline = !1, preserveNextRowsOnlyResizeBaseline = !1, deferGraphicsFlushUntilResizeCommit = !1, graphicsCapabilities = resolveTerminalGraphicsCapabilities(options, env, outputIsTTY), pendingGraphics = /* @__PURE__ */ new Map(), pendingGraphicClears = /* @__PURE__ */ new Set(), activeGraphics = /* @__PURE__ */ new Map(), pendingGraphicSignatures = /* @__PURE__ */ new Map(), activeGraphicSignatures = /* @__PURE__ */ new Map(), retainedGraphics = /* @__PURE__ */ new Map(), knownKittyImageIds = /* @__PURE__ */ new Set(), terminalResizeDirtyGraphics = /* @__PURE__ */ new Set(), nextGraphicsOrder = 0, terminalGraphicsFlushTimer = null, hasPendingTerminalGraphics = () => pendingGraphics.size > 0 || pendingGraphicClears.size > 0;
+  let effectiveDirtyRowPatchMode = resolveEffectiveDirtyRowPatchMode(), shouldUseDirtySpans = () => effectiveDirtyRowPatchMode !== "row", shouldUseMultiDirtySpans = () => effectiveDirtyRowPatchMode === "multi-span", enableOsc8Links = outputAllowsOsc8Links && !isVscodeTerminal, renderedHref = (value) => enableOsc8Links ? normalizeHref(value) : null, disposed = !1, lastFrameTime = 0, pendingRender = !1, renderTimer = null, rowsOnlyResizeRepaintTimer = null, writeEmaMs = 0, lastCursorX = null, lastCursorY = null, accumulatedAllRows = !1, accumulatedDirtyBits = null, accumulatedDirtyCount = 0, accumulatedDirtyMin = Number.POSITIVE_INFINITY, accumulatedDirtyMax = -1, accumulatedDirtyRowsRequireRepaint = !1, accumulatedScrollOperations = null, allowNextGraphicsOnlyRenderWithoutBaseline = !1, preserveNextRowsOnlyResizeBaseline = !1, deferGraphicsFlushUntilResizeCommit = !1, graphicsCapabilities = resolveTerminalGraphicsCapabilities(options, env, outputIsTTY), pendingGraphics = /* @__PURE__ */ new Map(), pendingGraphicClears = /* @__PURE__ */ new Set(), activeGraphics = /* @__PURE__ */ new Map(), pendingGraphicSignatures = /* @__PURE__ */ new Map(), activeGraphicSignatures = /* @__PURE__ */ new Map(), validatedGraphicFrames = /* @__PURE__ */ new Map(), graphicSequenceHashes = /* @__PURE__ */ new Map(), retainedGraphics = /* @__PURE__ */ new Map(), knownKittyImageIds = /* @__PURE__ */ new Set(), terminalResizeDirtyGraphics = /* @__PURE__ */ new Set(), nextGraphicsOrder = 0, terminalGraphicsFlushTimer = null, hasPendingTerminalGraphics = () => pendingGraphics.size > 0 || pendingGraphicClears.size > 0;
   function canUseTerminalGraphicsProtocol(protocol, capabilities) {
     return capabilities.supported && isTerminalGraphicsProtocol(protocol) && protocol === capabilities.preferredProtocol;
   }
@@ -8020,16 +8020,24 @@ function createStdoutRenderer(terminal, options) {
     }
   }
   function terminalGraphicsPayloadSignature(payload) {
-    return [
+    let cached = graphicSequenceHashes.get(payload.id), resizeSequence = payload.resizeSequence ?? "", clearSequence = payload.clearSequence ?? "", hashes = cached && cached.sequence === payload.sequence && cached.resizeSequence === resizeSequence && cached.clearSequence === clearSequence ? cached : {
+      sequence: payload.sequence,
+      resizeSequence,
+      clearSequence,
+      sequenceHash: hashTerminalGraphicsString(payload.sequence),
+      resizeSequenceHash: hashTerminalGraphicsString(resizeSequence),
+      clearSequenceHash: hashTerminalGraphicsString(clearSequence)
+    };
+    return hashes !== cached && graphicSequenceHashes.set(payload.id, hashes), [
       payload.id,
       payload.protocol,
       payload.x,
       payload.y,
       payload.w ?? "",
       payload.h ?? "",
-      hashTerminalGraphicsString(payload.sequence),
-      hashTerminalGraphicsString(payload.resizeSequence ?? ""),
-      hashTerminalGraphicsString(payload.clearSequence ?? ""),
+      hashes.sequenceHash,
+      hashes.resizeSequenceHash,
+      hashes.clearSequenceHash,
       payload.allowTextOverlay ? "1" : "0"
     ].join(":");
   }
@@ -8095,6 +8103,10 @@ function createStdoutRenderer(terminal, options) {
     }
     return null;
   }
+  function sameKittyImage(a, b) {
+    let aId = kittyImageId(a);
+    return aId != null && aId === kittyImageId(b);
+  }
   function canReplaceKittyPlacementWithoutClear(previous, payload) {
     if (payload.terminalResizeRedraw || !payload.resizeRedraw || previous.protocol !== "kitty" || payload.protocol !== "kitty")
       return !1;
@@ -8113,7 +8125,7 @@ function createStdoutRenderer(terminal, options) {
     pendingGraphicSignatures.delete(id), terminalResizeDirtyGraphics.delete(id);
     let active = activeGraphics.get(id);
     if (!active)
-      return options2.retainOnClear || retainedGraphics.delete(id), removedPendingDraw;
+      return options2.retainOnClear || (retainedGraphics.delete(id), validatedGraphicFrames.delete(id), graphicSequenceHashes.delete(id)), removedPendingDraw;
     if (active.clearSequence) {
       let payload = {
         id,
@@ -8155,7 +8167,7 @@ function createStdoutRenderer(terminal, options) {
       );
     for (let payload of pendingGraphics.values())
       rememberImageId(payload.sequence, payload.resizeSequence, payload.clearSequence);
-    pendingGraphics.clear(), pendingGraphicClears.clear(), activeGraphics.clear(), pendingGraphicSignatures.clear(), activeGraphicSignatures.clear(), retainedGraphics.clear(), knownKittyImageIds.clear(), terminalResizeDirtyGraphics.clear();
+    pendingGraphics.clear(), pendingGraphicClears.clear(), activeGraphics.clear(), pendingGraphicSignatures.clear(), activeGraphicSignatures.clear(), retainedGraphics.clear(), validatedGraphicFrames.clear(), graphicSequenceHashes.clear(), knownKittyImageIds.clear(), terminalResizeDirtyGraphics.clear();
     for (let imageId of imageIds) {
       let payload = {
         id: `__terminal_graphics_clear_image_${imageId}__`,
@@ -8263,16 +8275,17 @@ function createStdoutRenderer(terminal, options) {
       if (!normalized.id.trim() || !Number.isFinite(normalized.x) || !Number.isFinite(normalized.y) || !canUseTerminalGraphicsProtocol(normalized.protocol, graphicsCapabilities))
         return !1;
       if (op === "draw") {
-        let frame = validateTerminalGraphicFrame({
+        let cachedFrame = validatedGraphicFrames.get(normalized.id), width = normalized.w ?? 1, height = normalized.h ?? 1, frame = cachedFrame && cachedFrame.protocol === normalized.protocol && cachedFrame.sequence === normalized.sequence && cachedFrame.width === width && cachedFrame.height === height && cachedFrame.fallbackText === (normalized.fallbackText ?? "") ? cachedFrame : validateTerminalGraphicFrame({
           id: normalized.id,
           protocol: normalized.protocol,
           sequence: normalized.sequence,
           fallbackText: normalized.fallbackText,
-          width: normalized.w ?? 1,
-          height: normalized.h ?? 1
+          width,
+          height
         });
         if (!frame)
           return !1;
+        frame !== cachedFrame && validatedGraphicFrames.set(frame.id, frame);
         let imageId = kittyImageId(frame.sequence) ?? kittyImageId(normalized.resizeSequence);
         if (imageId != null && knownKittyImageIds.add(imageId), isDebugEnabled()) {
           let size = terminal.size();
@@ -8317,7 +8330,7 @@ function createStdoutRenderer(terminal, options) {
           }), isDebugEnabled() && getDebugLog().render(
             `terminal graphic queue draw canceled clear: id=${frame.id}, x=${normalized.x}, y=${normalized.y}, w=${frame.width}, h=${frame.height}`
           ), !0;
-        let active = activeGraphics.get(frame.id), activeCanReplacePlacement = active && active.sequence === frame.sequence && resizeSequence && canReplaceKittyPlacementWithoutClear(active, {
+        let active = activeGraphics.get(frame.id), activeCanReplacePlacement = active && (active.sequence === frame.sequence || normalized.placementMoveWithoutClear && sameKittyImage(active.sequence, frame.sequence)) && resizeSequence && canReplaceKittyPlacementWithoutClear(active, {
           ...normalized,
           id: frame.id,
           w: frame.width,
@@ -8340,14 +8353,18 @@ 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,
             protocol: normalized.protocol,
             bytes: resizeSequence.length
           }), requestTerminalGraphicsFlush(!!normalized.deferFlush), !0;
-        let retained = retainedGraphics.get(frame.id), retainedCanReplacePlacement = retained && retained.active.sequence === frame.sequence && resizeSequence && canReplaceKittyPlacementWithoutClear(retained.active, {
+        let retained = retainedGraphics.get(frame.id), retainedCanReplacePlacement = retained && (retained.active.sequence === frame.sequence || normalized.placementMoveWithoutClear && sameKittyImage(retained.active.sequence, frame.sequence)) && resizeSequence && canReplaceKittyPlacementWithoutClear(retained.active, {
           ...normalized,
           id: frame.id,
           w: frame.width,
@@ -8369,7 +8386,7 @@ function createStdoutRenderer(terminal, options) {
           clearSequence,
           fallbackText: frame.fallbackText,
           resizeRedraw: !0,
-          placementMoveWithoutClear: !1,
+          placementMoveWithoutClear: !!normalized.placementMoveWithoutClear,
           terminalResizeRedraw: forceTerminalResizeRedraw
         }), pendingGraphicSignatures.set(frame.id, signature), isDebugEnabled() && getDebugLog().render(
           `terminal graphic retained resize redraw: id=${frame.id}, x=${retained.active.x}, y=${retained.active.y}, w=${retained.active.w}, h=${retained.active.h}, bytes=${resizeSequence.length}`
@@ -9739,7 +9756,7 @@ function createStdoutRenderer(terminal, options) {
         return opA - opB || a.order - b.order;
       }), graphicsToRender = graphicsEntriesToRender.map(([, payload]) => payload));
     })(), graphicsClearsToRender.length > 0 || graphicsToRender.length > 0) {
-      let nextActiveGraphics = new Map(activeGraphics), nextActiveGraphicSignatures = new Map(activeGraphicSignatures), nextPendingGraphicSignatures = new Map(pendingGraphicSignatures), terminalGraphicsDraws = 0, terminalGraphicsClears = 0, terminalGraphicsBytes = 0, countGraphicsBytes = (value) => (terminalGraphicsBytes += import_node_buffer3.Buffer.byteLength(value, "utf8"), value), appendTerminalGraphicSequenceAt = (sequence, rect, fallbackCell, skipWithoutRect = !1) => {
+      let nextActiveGraphics = new Map(activeGraphics), nextActiveGraphicSignatures = new Map(activeGraphicSignatures), nextPendingGraphicSignatures = new Map(pendingGraphicSignatures), clearedGraphicCacheIds = /* @__PURE__ */ new Set(), terminalGraphicsDraws = 0, terminalGraphicsClears = 0, terminalGraphicsBytes = 0, countGraphicsBytes = (value) => (terminalGraphicsBytes += import_node_buffer3.Buffer.byteLength(value, "utf8"), value), appendTerminalGraphicSequenceAt = (sequence, rect, fallbackCell, skipWithoutRect = !1) => {
         if (!rect && skipWithoutRect)
           return !1;
         let cell = rect ? { x: rect.x, y: rect.y } : clampCellToViewport(fallbackCell, size);
@@ -9780,7 +9797,7 @@ function createStdoutRenderer(terminal, options) {
           let clearRect2 = clearGraphicRectForRowsNotPainted(visibleRect);
           clearRect2 && (frameParts.push(countGraphicsBytes(clearRect2)), wroteClear = !0);
         }
-        wroteClear = appendActiveGraphicProtocolClear(active, visibleRect) || wroteClear, wroteClear && terminalGraphicsClears++, retainedGraphics.delete(id), terminalResizeDirtyGraphics.delete(id), nextActiveGraphics.delete(id), nextActiveGraphicSignatures.delete(id), nextPendingGraphicSignatures.delete(id);
+        wroteClear = appendActiveGraphicProtocolClear(active, visibleRect) || wroteClear, wroteClear && terminalGraphicsClears++, retainedGraphics.delete(id), clearedGraphicCacheIds.add(id), terminalResizeDirtyGraphics.delete(id), nextActiveGraphics.delete(id), nextActiveGraphicSignatures.delete(id), nextPendingGraphicSignatures.delete(id);
       }
       for (let payload of graphicsToRender) {
         if (payload.op === "clear") {
@@ -9805,7 +9822,7 @@ function createStdoutRenderer(terminal, options) {
               cellY: (active == null ? void 0 : active.y) ?? payload.y
             },
             clearSequenceNeedsVisibleCell(payload.sequence, payload.protocol)
-          ) || wroteClear, wroteClear && terminalGraphicsClears++, active && payload.retainOnClear ? retainTerminalGraphic(payload.id, active, nextActiveGraphicSignatures.get(payload.id)) : retainedGraphics.delete(payload.id), terminalResizeDirtyGraphics.delete(payload.id), nextActiveGraphics.delete(payload.id), nextActiveGraphicSignatures.delete(payload.id), nextPendingGraphicSignatures.delete(payload.id);
+          ) || wroteClear, wroteClear && terminalGraphicsClears++, active && payload.retainOnClear ? retainTerminalGraphic(payload.id, active, nextActiveGraphicSignatures.get(payload.id)) : (retainedGraphics.delete(payload.id), clearedGraphicCacheIds.add(payload.id)), terminalResizeDirtyGraphics.delete(payload.id), nextActiveGraphics.delete(payload.id), nextActiveGraphicSignatures.delete(payload.id), nextPendingGraphicSignatures.delete(payload.id);
           continue;
         }
         let previous = nextActiveGraphics.get(payload.id), rect = anchoredGraphicRectInViewport(
@@ -9876,6 +9893,8 @@ function createStdoutRenderer(terminal, options) {
         pendingGraphicSignatures.clear();
         for (let [id, signature] of nextPendingGraphicSignatures)
           pendingGraphicSignatures.set(id, signature);
+        for (let id of clearedGraphicCacheIds)
+          nextActiveGraphics.has(id) || retainedGraphics.has(id) || (validatedGraphicFrames.delete(id), graphicSequenceHashes.delete(id));
       }, terminalGraphicsMetrics = {
         draws: terminalGraphicsDraws,
         clears: terminalGraphicsClears,
@@ -10271,7 +10290,7 @@ function createStdoutRenderer(terminal, options) {
       return;
     disposed = !0;
     let disposeError = null;
-    renderTimer && (clearTimeout(renderTimer), renderTimer = null), terminalGraphicsFlushTimer && (clearTimeout(terminalGraphicsFlushTimer), terminalGraphicsFlushTimer = null), clearRowsOnlyResizeRepaintTimer(), accumulatedAllRows = !1, accumulatedDirtyBits = null, accumulatedDirtyCount = 0, accumulatedDirtyMin = Number.POSITIVE_INFINITY, accumulatedDirtyMax = -1, accumulatedDirtyRowsRequireRepaint = !1, pendingGraphics.clear(), pendingGraphicClears.clear(), pendingGraphicSignatures.clear(), retainedGraphics.clear(), knownKittyImageIds.clear(), terminalResizeDirtyGraphics.clear();
+    renderTimer && (clearTimeout(renderTimer), renderTimer = null), terminalGraphicsFlushTimer && (clearTimeout(terminalGraphicsFlushTimer), terminalGraphicsFlushTimer = null), clearRowsOnlyResizeRepaintTimer(), accumulatedAllRows = !1, accumulatedDirtyBits = null, accumulatedDirtyCount = 0, accumulatedDirtyMin = Number.POSITIVE_INFINITY, accumulatedDirtyMax = -1, accumulatedDirtyRowsRequireRepaint = !1, pendingGraphics.clear(), pendingGraphicClears.clear(), pendingGraphicSignatures.clear(), retainedGraphics.clear(), validatedGraphicFrames.clear(), graphicSequenceHashes.clear(), knownKittyImageIds.clear(), terminalResizeDirtyGraphics.clear();
     try {
       if (activeGraphics.size > 0) {
         let size = terminal.size(), clearParts = [], terminalGraphicsClears = 0;

package/dist/cli.js

@@ -9335,8 +9335,8 @@ function detectCandidates(env) {
 	const term = String(envString(env, "TERM") ?? "").toLowerCase();
 	const termProgram = String(envString(env, "TERM_PROGRAM") ?? "").toLowerCase();
 	const termProgramVersion = String(envString(env, "TERM_PROGRAM_VERSION") ?? "").toLowerCase();
-	if (envString(env, "KITTY_WINDOW_ID") || envString(env, "GHOSTTY_RESOURCES_DIR") || /(?:^|-)kitty(?:-|$)/i.test(term) || term.includes("ghostty") || termProgram.includes("ghostty")) candidates.push("kitty");
-	if (termProgram.includes("iterm") || termProgram.includes("wezterm") || envString(env, "WEZTERM_PANE") || envString(env, "WEZTERM_EXECUTABLE")) candidates.push("iterm2");
+	if (envString(env, "KITTY_WINDOW_ID") || envString(env, "GHOSTTY_RESOURCES_DIR") || /(?:^|-)kitty(?:-|$)/i.test(term) || term.includes("ghostty") || termProgram.includes("ghostty") || termProgram.includes("wezterm") || envString(env, "WEZTERM_PANE") || envString(env, "WEZTERM_EXECUTABLE")) candidates.push("kitty");
+	if (termProgram.includes("iterm")) candidates.push("iterm2");
 	if (truthy(envString(env, "VUE_TUI_SIXEL")) || truthy(envString(env, "VUE_TUI_GRAPHICS_SIXEL")) || String(envString(env, "TERMINAL_GRAPHICS") ?? "").toLowerCase().includes("sixel") || /\bsixel\b/i.test(`${term} ${termProgram} ${termProgramVersion}`)) candidates.push("sixel");
 	return uniqueProtocols(candidates);
 }
@@ -10096,6 +10096,8 @@ function createStdoutRenderer(terminal, options) {
 	const activeGraphics = new Map();
 	const pendingGraphicSignatures = new Map();
 	const activeGraphicSignatures = new Map();
+	const validatedGraphicFrames = new Map();
+	const graphicSequenceHashes = new Map();
 	const retainedGraphics = new Map();
 	const knownKittyImageIds = new Set();
 	const terminalResizeDirtyGraphics = new Set();
@@ -10122,6 +10124,18 @@ function createStdoutRenderer(terminal, options) {
 		}, 0);
 	}
 	function terminalGraphicsPayloadSignature(payload) {
+		const cached = graphicSequenceHashes.get(payload.id);
+		const resizeSequence = payload.resizeSequence ?? "";
+		const clearSequence = payload.clearSequence ?? "";
+		const hashes = cached && cached.sequence === payload.sequence && cached.resizeSequence === resizeSequence && cached.clearSequence === clearSequence ? cached : {
+			sequence: payload.sequence,
+			resizeSequence,
+			clearSequence,
+			sequenceHash: hashTerminalGraphicsString(payload.sequence),
+			resizeSequenceHash: hashTerminalGraphicsString(resizeSequence),
+			clearSequenceHash: hashTerminalGraphicsString(clearSequence)
+		};
+		if (hashes !== cached) graphicSequenceHashes.set(payload.id, hashes);
 		return [
 			payload.id,
 			payload.protocol,
@@ -10129,9 +10143,9 @@ function createStdoutRenderer(terminal, options) {
 			payload.y,
 			payload.w ?? "",
 			payload.h ?? "",
-			hashTerminalGraphicsString(payload.sequence),
-			hashTerminalGraphicsString(payload.resizeSequence ?? ""),
-			hashTerminalGraphicsString(payload.clearSequence ?? ""),
+			hashes.sequenceHash,
+			hashes.resizeSequenceHash,
+			hashes.clearSequenceHash,
 			payload.allowTextOverlay ? "1" : "0"
 		].join(":");
 	}
@@ -10196,6 +10210,10 @@ function createStdoutRenderer(terminal, options) {
 		}
 		return null;
 	}
+	function sameKittyImage(a, b) {
+		const aId = kittyImageId(a);
+		return aId != null && aId === kittyImageId(b);
+	}
 	function canReplaceKittyPlacementWithoutClear(previous, payload) {
 		if (payload.terminalResizeRedraw) return false;
 		if (!payload.resizeRedraw || previous.protocol !== "kitty" || payload.protocol !== "kitty") return false;
@@ -10215,7 +10233,11 @@ function createStdoutRenderer(terminal, options) {
 		terminalResizeDirtyGraphics.delete(id);
 		const active = activeGraphics.get(id);
 		if (!active) {
-			if (!options$1.retainOnClear) retainedGraphics.delete(id);
+			if (!options$1.retainOnClear) {
+				retainedGraphics.delete(id);
+				validatedGraphicFrames.delete(id);
+				graphicSequenceHashes.delete(id);
+			}
 			return removedPendingDraw;
 		}
 		if (active.clearSequence) {
@@ -10273,6 +10295,8 @@ function createStdoutRenderer(terminal, options) {
 		pendingGraphicSignatures.clear();
 		activeGraphicSignatures.clear();
 		retainedGraphics.clear();
+		validatedGraphicFrames.clear();
+		graphicSequenceHashes.clear();
 		knownKittyImageIds.clear();
 		terminalResizeDirtyGraphics.clear();
 		for (const imageId of imageIds) {
@@ -10397,15 +10421,19 @@ function createStdoutRenderer(terminal, options) {
 			if (!Number.isFinite(normalized.x) || !Number.isFinite(normalized.y)) return false;
 			if (!canUseTerminalGraphicsProtocol(normalized.protocol, graphicsCapabilities)) return false;
 			if (op === "draw") {
-				const frame = validateTerminalGraphicFrame({
+				const cachedFrame = validatedGraphicFrames.get(normalized.id);
+				const width = normalized.w ?? 1;
+				const height = normalized.h ?? 1;
+				const frame = cachedFrame && cachedFrame.protocol === normalized.protocol && cachedFrame.sequence === normalized.sequence && cachedFrame.width === width && cachedFrame.height === height && cachedFrame.fallbackText === (normalized.fallbackText ?? "") ? cachedFrame : validateTerminalGraphicFrame({
 					id: normalized.id,
 					protocol: normalized.protocol,
 					sequence: normalized.sequence,
 					fallbackText: normalized.fallbackText,
-					width: normalized.w ?? 1,
-					height: normalized.h ?? 1
+					width,
+					height
 				});
 				if (!frame) return false;
+				if (frame !== cachedFrame) validatedGraphicFrames.set(frame.id, frame);
 				const imageId = kittyImageId(frame.sequence) ?? kittyImageId(normalized.resizeSequence);
 				if (imageId != null) knownKittyImageIds.add(imageId);
 				if (isDebugEnabled()) {
@@ -10459,7 +10487,7 @@ function createStdoutRenderer(terminal, options) {
 					return true;
 				}
 				const active = activeGraphics.get(frame.id);
-				const activeCanReplacePlacement = active && active.sequence === frame.sequence && resizeSequence && canReplaceKittyPlacementWithoutClear(active, {
+				const activeCanReplacePlacement = active && (active.sequence === frame.sequence || normalized.placementMoveWithoutClear && sameKittyImage(active.sequence, frame.sequence)) && resizeSequence && canReplaceKittyPlacementWithoutClear(active, {
 					...normalized,
 					id: frame.id,
 					w: frame.width,
@@ -10482,7 +10510,7 @@ function createStdoutRenderer(terminal, options) {
 						clearSequence,
 						fallbackText: frame.fallbackText,
 						resizeRedraw: true,
-						placementMoveWithoutClear: false
+						placementMoveWithoutClear: Boolean(normalized.placementMoveWithoutClear)
 					});
 					pendingGraphicSignatures.set(frame.id, signature);
 					recordTerminalGraphicTrace({
@@ -10495,7 +10523,7 @@ function createStdoutRenderer(terminal, options) {
 					return true;
 				}
 				const retained = retainedGraphics.get(frame.id);
-				const retainedCanReplacePlacement = retained && retained.active.sequence === frame.sequence && resizeSequence && canReplaceKittyPlacementWithoutClear(retained.active, {
+				const retainedCanReplacePlacement = retained && (retained.active.sequence === frame.sequence || normalized.placementMoveWithoutClear && sameKittyImage(retained.active.sequence, frame.sequence)) && resizeSequence && canReplaceKittyPlacementWithoutClear(retained.active, {
 					...normalized,
 					id: frame.id,
 					w: frame.width,
@@ -10521,7 +10549,7 @@ function createStdoutRenderer(terminal, options) {
 						clearSequence,
 						fallbackText: frame.fallbackText,
 						resizeRedraw: true,
-						placementMoveWithoutClear: false,
+						placementMoveWithoutClear: Boolean(normalized.placementMoveWithoutClear),
 						terminalResizeRedraw: forceTerminalResizeRedraw
 					});
 					pendingGraphicSignatures.set(frame.id, signature);
@@ -12450,6 +12478,7 @@ function createStdoutRenderer(terminal, options) {
 			const nextActiveGraphics = new Map(activeGraphics);
 			const nextActiveGraphicSignatures = new Map(activeGraphicSignatures);
 			const nextPendingGraphicSignatures = new Map(pendingGraphicSignatures);
+			const clearedGraphicCacheIds = new Set();
 			let terminalGraphicsDraws = 0;
 			let terminalGraphicsClears = 0;
 			let terminalGraphicsBytes = 0;
@@ -12504,6 +12533,7 @@ function createStdoutRenderer(terminal, options) {
 				wroteClear = appendActiveGraphicProtocolClear(active, visibleRect) || wroteClear;
 				if (wroteClear) terminalGraphicsClears++;
 				retainedGraphics.delete(id);
+				clearedGraphicCacheIds.add(id);
 				terminalResizeDirtyGraphics.delete(id);
 				nextActiveGraphics.delete(id);
 				nextActiveGraphicSignatures.delete(id);
@@ -12531,7 +12561,10 @@ function createStdoutRenderer(terminal, options) {
 					}, clearSequenceNeedsVisibleCell(payload.sequence, payload.protocol)) || wroteClear;
 					if (wroteClear) terminalGraphicsClears++;
 					if (active && payload.retainOnClear) retainTerminalGraphic(payload.id, active, nextActiveGraphicSignatures.get(payload.id));
-					else retainedGraphics.delete(payload.id);
+					else {
+						retainedGraphics.delete(payload.id);
+						clearedGraphicCacheIds.add(payload.id);
+					}
 					terminalResizeDirtyGraphics.delete(payload.id);
 					nextActiveGraphics.delete(payload.id);
 					nextActiveGraphicSignatures.delete(payload.id);
@@ -12618,6 +12651,11 @@ function createStdoutRenderer(terminal, options) {
 				for (const [id, signature] of nextActiveGraphicSignatures) activeGraphicSignatures.set(id, signature);
 				pendingGraphicSignatures.clear();
 				for (const [id, signature] of nextPendingGraphicSignatures) pendingGraphicSignatures.set(id, signature);
+				for (const id of clearedGraphicCacheIds) {
+					if (nextActiveGraphics.has(id) || retainedGraphics.has(id)) continue;
+					validatedGraphicFrames.delete(id);
+					graphicSequenceHashes.delete(id);
+				}
 			};
 			terminalGraphicsMetrics = {
 				draws: terminalGraphicsDraws,
@@ -13206,6 +13244,8 @@ function createStdoutRenderer(terminal, options) {
 		pendingGraphicClears.clear();
 		pendingGraphicSignatures.clear();
 		retainedGraphics.clear();
+		validatedGraphicFrames.clear();
+		graphicSequenceHashes.clear();
 		knownKittyImageIds.clear();
 		terminalResizeDirtyGraphics.clear();
 		try {

package/dist/experimental.cjs

@@ -2619,6 +2619,10 @@ function createTerminalGraphicPngSequence(options) {
       );
       crop && (placement = { ...placement, ...crop });
     }
+    let transmissionPlacement = options.cropTransmission !== !1 ? placement : {
+      columns: options.transmissionColumns ?? options.placementColumns,
+      rows: options.transmissionRows ?? options.placementRows
+    };
     return {
       type: "sequence",
       protocol: "kitty",
@@ -2626,7 +2630,7 @@ function createTerminalGraphicPngSequence(options) {
         imageId: options.imageId,
         placementId: options.placementId,
         zIndex: options.zIndex,
-        ...placement
+        ...transmissionPlacement
       }),
       resizeSequence: createKittyPlacementSequence({
         imageId: options.imageId,
@@ -2800,6 +2804,7 @@ var tAgentTerminalGraphicProps = {
   suspendRenderWhileScrolling: { type: Boolean, default: !0 },
   scrolling: { type: Boolean, default: !1 },
   scrollVersion: { type: Number, default: 0 },
+  /** Advanced Kitty-only opt-in for moving an unchanged image via a reusable placement sequence. */
   placementMoveWithoutClear: { type: Boolean, default: !1 },
   preserveRawWhileRendering: { type: Boolean, default: !1 },
   suspended: { type: Boolean, default: !1 },

package/dist/experimental.js

@@ -5,8 +5,8 @@ import { TText, TView, createFrameMailbox, mergeStyle } from "./linkify-CL9wwnZN
 import "./frame-perf-CHpWhbC4.js";
 import "./terminal-selection-4W1SJj4c.js";
 import "./wheel-scroll-DASkEZr-.js";
-import { createTerminalGraphicPngSequence, getTerminalGraphicsOutput, getTerminalGraphicsOutputVersion, subscribeTerminalGraphicsOutput } from "./terminal-graphics-DWZrl3oh.js";
-import { TAgentTerminalGraphic, TLogLinksPanel, TLogMinimap, TLogScrollbar, TLogSearchBar, TLogSearchPager, TLogSearchResults, TLogView, TLogVirtualLinksPanel, TLogVirtualSearchResults, TTranscriptView, TVirtualList, createAppendOnlyLogStore, createTLogDensityBucketsFromMarkers, createTLogLevelPlugin, createTLogLineMatcherPlugin, createTLogLinkActionPlugin, createTLogOsc8LinkPlugin, createTLogUrlPlugin, detectTLogUrls, dispatchTLogPluginLinkAction, getTLogPluginMetadata, handleTLogKeymapEvent, matchesTLogKeyBinding, parseTLogAnnotatedText, resolveTLogLinksPanelTheme, resolveTLogMinimapTheme, resolveTLogScrollbarTheme, resolveTLogSearchBarTheme, resolveTLogSearchPagerTheme, resolveTLogSearchResultsTheme, resolveTLogViewTheme, stripTLogAnsiText, tlogDarkPreset, tlogDarkTheme, tlogDefaultKeymap, tlogDefaultPreset, tlogDefaultTheme, tlogHighContrastKeymap, tlogHighContrastPreset, tlogHighContrastTheme, toTLogExternalLinkFromVisibleLink, useTLogLinkController, useTLogRetainedIndex, useTLogSearchController, useTLogSearchResultsPage, useTLogVirtualSearchResults } from "./tlog-theme-DqnF_zNe.js";
+import { createTerminalGraphicPngSequence, getTerminalGraphicsOutput, getTerminalGraphicsOutputVersion, subscribeTerminalGraphicsOutput } from "./terminal-graphics-D6KErRBY.js";
+import { TAgentTerminalGraphic, TLogLinksPanel, TLogMinimap, TLogScrollbar, TLogSearchBar, TLogSearchPager, TLogSearchResults, TLogView, TLogVirtualLinksPanel, TLogVirtualSearchResults, TTranscriptView, TVirtualList, createAppendOnlyLogStore, createTLogDensityBucketsFromMarkers, createTLogLevelPlugin, createTLogLineMatcherPlugin, createTLogLinkActionPlugin, createTLogOsc8LinkPlugin, createTLogUrlPlugin, detectTLogUrls, dispatchTLogPluginLinkAction, getTLogPluginMetadata, handleTLogKeymapEvent, matchesTLogKeyBinding, parseTLogAnnotatedText, resolveTLogLinksPanelTheme, resolveTLogMinimapTheme, resolveTLogScrollbarTheme, resolveTLogSearchBarTheme, resolveTLogSearchPagerTheme, resolveTLogSearchResultsTheme, resolveTLogViewTheme, stripTLogAnsiText, tlogDarkPreset, tlogDarkTheme, tlogDefaultKeymap, tlogDefaultPreset, tlogDefaultTheme, tlogHighContrastKeymap, tlogHighContrastPreset, tlogHighContrastTheme, toTLogExternalLinkFromVisibleLink, useTLogLinkController, useTLogRetainedIndex, useTLogSearchController, useTLogSearchResultsPage, useTLogVirtualSearchResults } from "./tlog-theme-DIrlCw6m.js";
 import { computed, defineComponent, getCurrentInstance, h, inject, markRaw, onBeforeUnmount, onUnmounted, ref, shallowRef, watch } from "vue";
 
 //#region src/vue/components/TVideo.ts