@simon_he/vue-tui 1.1.5 → 1.1.7

package/dist/cli.cjs

@@ -7299,7 +7299,7 @@ var TERMINAL_GRAPHICS_PROTOCOL_PRIORITY = [
   "kitty",
   "iterm2",
   "sixel"
-], ESC4 = "\x1B", BEL = "\x07", ST = `${ESC4}\\`, ESC_RE = "\\u001B", BEL_RE = "\\u0007", CSI_RE = new RegExp(`${ESC_RE}\\[[0-?]*[ -/]*[@-~]`, "g"), OSC_RE = new RegExp(`${ESC_RE}\\][\\s\\S]*?(?:${BEL_RE}|${ESC_RE}\\\\)`, "g"), DCS_RE = new RegExp(`${ESC_RE}P[\\s\\S]*?${ESC_RE}\\\\`, "g"), APC_RE = new RegExp(`${ESC_RE}_[\\s\\S]*?${ESC_RE}\\\\`, "g"), C1_CSI_RE = new RegExp("\\u009B[0-?]*[ -/]*[@-~]", "g"), C1_OSC_RE = new RegExp(`\\u009D[\\s\\S]*?(?:${BEL_RE}|\\u009C)`, "g"), C1_DCS_RE = new RegExp("\\u0090[\\s\\S]*?\\u009C", "g"), C1_APC_RE = new RegExp("\\u009F[\\s\\S]*?\\u009C", "g"), MAX_TERMINAL_GRAPHICS_SEQUENCE_CHARS = 16 * 1024 * 1024, MAX_TERMINAL_GRAPHICS_FALLBACK_CHARS = 16384, MAX_TERMINAL_GRAPHIC_CELLS = 1e4, TERMINAL_GRAPHICS_REGISTRY = Symbol.for("@simon_he/vue-tui:v1:terminal-graphics"), terminalGraphicsGlobal = globalThis, terminalGraphicsRegistry = terminalGraphicsGlobal[TERMINAL_GRAPHICS_REGISTRY] ?? {
+], ESC4 = "\x1B", BEL = "\x07", ST = `${ESC4}\\`, ESC_RE = "\\u001B", BEL_RE = "\\u0007", CSI_RE = new RegExp(`${ESC_RE}\\[[0-?]*[ -/]*[@-~]`, "g"), OSC_RE = new RegExp(`${ESC_RE}\\][\\s\\S]*?(?:${BEL_RE}|${ESC_RE}\\\\)`, "g"), DCS_RE = new RegExp(`${ESC_RE}P[\\s\\S]*?${ESC_RE}\\\\`, "g"), APC_RE = new RegExp(`${ESC_RE}_[\\s\\S]*?${ESC_RE}\\\\`, "g"), C1_CSI_RE = new RegExp("\\u009B[0-?]*[ -/]*[@-~]", "g"), C1_OSC_RE = new RegExp(`\\u009D[\\s\\S]*?(?:${BEL_RE}|\\u009C)`, "g"), C1_DCS_RE = new RegExp("\\u0090[\\s\\S]*?\\u009C", "g"), C1_APC_RE = new RegExp("\\u009F[\\s\\S]*?\\u009C", "g"), MAX_TERMINAL_GRAPHICS_SEQUENCE_CHARS = 16 * 1024 * 1024, MAX_TERMINAL_GRAPHICS_FALLBACK_CHARS = 16384, MAX_TERMINAL_GRAPHIC_CELLS = 1e5, TERMINAL_GRAPHICS_REGISTRY = Symbol.for("@simon_he/vue-tui:v1:terminal-graphics"), terminalGraphicsGlobal = globalThis, terminalGraphicsRegistry = terminalGraphicsGlobal[TERMINAL_GRAPHICS_REGISTRY] ?? {
   outputs: /* @__PURE__ */ new WeakMap(),
   outputVersions: /* @__PURE__ */ new WeakMap(),
   outputListeners: /* @__PURE__ */ new WeakMap()
@@ -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,
@@ -8351,7 +8364,7 @@ function createStdoutRenderer(terminal, options) {
             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,
@@ -8373,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}`
@@ -9092,7 +9105,7 @@ function createStdoutRenderer(terminal, options) {
     }
     return end > start ? end : codePointEnd(data, start);
   };
-  function writeChunked(data) {
+  function writeChunked(data, pin) {
     if (import_node_buffer3.Buffer.byteLength(data, "utf8") <= chunkSize) {
       out.write(data);
       return;
@@ -9102,8 +9115,8 @@ function createStdoutRenderer(terminal, options) {
     );
     try {
       for (let start = 0; start < data.length; ) {
-        let end = safeChunkEnd(data, start, chunkSize);
-        out.write(data.slice(start, end)), start = end;
+        let end = safeChunkEnd(data, start, chunkSize), chunk = data.slice(start, end);
+        out.write(end >= data.length || !pin ? chunk : `${chunk}${pin}`), start = end;
       }
       isDebugEnabled() && getDebugLog().render("writeChunked: chunked write completed");
     } catch (e) {
@@ -9743,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);
@@ -9784,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") {
@@ -9809,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(
@@ -9880,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,
@@ -9889,12 +9904,12 @@ function createStdoutRenderer(terminal, options) {
         `terminal graphics frame: draws=${terminalGraphicsDraws}, clears=${terminalGraphicsClears}, bytes=${terminalGraphicsBytes}, activeNext=${nextActiveGraphics.size}`
       );
     }
-    let emittedCursorPos = null;
+    let emittedCursorPos = null, frameCursorPin = null;
     if (getImeAnchor) {
       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 + rowOffset};${x + 1}H`));
+        let { x, y } = clampCellToViewport(anchor, size), cursorSequence = `\x1B[${y + 1 + rowOffset};${x + 1}H`;
+        frameCursorPin = cursorSequence, (hasFrameOutput || x !== lastCursorX || y !== lastCursorY) && (hasFrameOutput = !0, emittedCursorPos = { x, y }, closeActiveHrefBeforeCursorMove(), frameParts.push(cursorSequence));
       }
     }
     if (!hasFrameOutput) {
@@ -9957,7 +9972,7 @@ function createStdoutRenderer(terminal, options) {
       if (writeMode === "chunked")
         isDebugEnabled() && getDebugLog().render(
           ` Using chunked write (chunkSize=${chunkSize}, threshold=${chunkThresholdBytes}, emaMs=${writeEmaMs.toFixed(2)})`
-        ), writeChunked(frame);
+        ), writeChunked(frame, frameCursorPin);
       else if (writeMode === "sync" && canUseSyncStdout) {
         isDebugEnabled() && getDebugLog().render(" Using writeSync");
         try {
@@ -10275,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

@@ -9267,7 +9267,7 @@ const C1_DCS_RE = new RegExp("\\u0090[\\s\\S]*?\\u009C", "g");
 const C1_APC_RE = new RegExp("\\u009F[\\s\\S]*?\\u009C", "g");
 const MAX_TERMINAL_GRAPHICS_SEQUENCE_CHARS = 16 * 1024 * 1024;
 const MAX_TERMINAL_GRAPHICS_FALLBACK_CHARS = 16384;
-const MAX_TERMINAL_GRAPHIC_CELLS = 1e4;
+const MAX_TERMINAL_GRAPHIC_CELLS = 1e5;
 const TERMINAL_GRAPHICS_REGISTRY = Symbol.for("@simon_he/vue-tui:v1:terminal-graphics");
 const terminalGraphicsGlobal = globalThis;
 const terminalGraphicsRegistry = terminalGraphicsGlobal[TERMINAL_GRAPHICS_REGISTRY] ?? {
@@ -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,
@@ -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);
@@ -11518,8 +11546,14 @@ function createStdoutRenderer(terminal, options) {
 	/**
 	* Write data in chunks to avoid overwhelming terminal buffers.
 	* This is especially important for ghostty which can hang on large writes.
+	*
+	* `pin` is appended after every chunk but the last. A host may observe the
+	* terminal between two writes (macOS asks for the IME rect when the marked text
+	* changes), and a chunk boundary would otherwise expose the cell of the last
+	* painted row instead of the frame's IME cursor, while the preedit — rendered
+	* only when the frame's synchronized output ends — stays on that cursor.
 	*/
-	function writeChunked(data) {
+	function writeChunked(data, pin) {
 		if (Buffer.byteLength(data, "utf8") <= chunkSize) {
 			out.write(data);
 			return;
@@ -11528,7 +11562,8 @@ function createStdoutRenderer(terminal, options) {
 		try {
 			for (let start = 0; start < data.length;) {
 				const end = safeChunkEnd(data, start, chunkSize);
-				out.write(data.slice(start, end));
+				const chunk = data.slice(start, end);
+				out.write(end >= data.length || !pin ? chunk : `${chunk}${pin}`);
 				start = end;
 			}
 			if (isDebugEnabled()) getDebugLog().render(`writeChunked: chunked write completed`);
@@ -12450,6 +12485,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 +12540,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 +12568,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 +12658,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,
@@ -12628,10 +12673,13 @@ function createStdoutRenderer(terminal, options) {
 			if (isDebugEnabled()) getDebugLog().render(`terminal graphics frame: draws=${terminalGraphicsDraws}, clears=${terminalGraphicsClears}, bytes=${terminalGraphicsBytes}, activeNext=${nextActiveGraphics.size}`);
 		}
 		let emittedCursorPos = null;
+		let frameCursorPin = null;
 		if (getImeAnchor) {
 			const anchor = getImeAnchor();
 			if (anchor) {
 				const { x, y } = clampCellToViewport(anchor, size);
+				const cursorSequence = `\u001B[${y + 1 + rowOffset};${x + 1}H`;
+				frameCursorPin = cursorSequence;
 				if (hasFrameOutput || x !== lastCursorX || y !== lastCursorY) {
 					hasFrameOutput = true;
 					emittedCursorPos = {
@@ -12639,7 +12687,7 @@ function createStdoutRenderer(terminal, options) {
 						y
 					};
 					closeActiveHrefBeforeCursorMove();
-					frameParts.push(`\u001B[${y + 1 + rowOffset};${x + 1}H`);
+					frameParts.push(cursorSequence);
 				}
 			}
 		}
@@ -12730,7 +12778,7 @@ function createStdoutRenderer(terminal, options) {
 		try {
 			if (writeMode === "chunked") {
 				if (isDebugEnabled()) getDebugLog().render(` Using chunked write (chunkSize=${chunkSize}, threshold=${chunkThresholdBytes}, emaMs=${writeEmaMs.toFixed(2)})`);
-				writeChunked(frame);
+				writeChunked(frame, frameCursorPin);
 			} else if (writeMode === "sync" && canUseSyncStdout) {
 				if (isDebugEnabled()) getDebugLog().render(` Using writeSync`);
 				try {
@@ -13206,6 +13254,8 @@ function createStdoutRenderer(terminal, options) {
 		pendingGraphicClears.clear();
 		pendingGraphicSignatures.clear();
 		retainedGraphics.clear();
+		validatedGraphicFrames.clear();
+		graphicSequenceHashes.clear();
 		knownKittyImageIds.clear();
 		terminalResizeDirtyGraphics.clear();
 		try {

package/dist/core.js

@@ -2,8 +2,8 @@ import { TERMINAL_RENDER_PLANES, charCellWidth, createTerminal, parseAnsiSgr } f
 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";
+import { normalizeNewlines } from "./path-BI9W15Zt.js";
+import { parsePathQuery, resolveUserPath, suggestParentHint, suggestPaths } from "./path-suggest-fPzRsgPv.js";
 
 //#region src/core/ansi/colors.ts
 const ANSI8_COLOR_NAMES = Object.freeze([