@simon_he/vue-tui 1.1.1 → 1.1.3

package/dist/{block-source-5CQp4tF8.js → block-source-Crro3mxi.js}

@@ -1,607 +1,12 @@
-import { getRootTerminal } from "./create-terminal-DXuZ2fci.js";
-import { hasEncodedControl, sanitizeDomHref } from "./hyperlink-B35-O-cW.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-Ng-3eKzF.js";
-import { terminalSelectionRowSpans, terminalSelectionVisibleRowSpans } from "./terminal-selection-CQYr--26.js";
-import { createDebugLogger, isDebugEnabled } from "./debug-logger-ChY_PXVk.js";
-import { applyWheelScroll, createWheelScrollState, resetWheelScrollState } from "./wheel-scroll-CQ22Hcyj.js";
+import { hasEncodedControl, sanitizeDomHref } from "./hyperlink-_1FAj7Wq.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-DUpeDfBg.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-Bbe83wSr.js";
 import { computed, defineComponent, getCurrentInstance, h, inject, markRaw, onBeforeUnmount, ref, shallowRef, watch, watchEffect } from "vue";
-import katex from "katex";
 import { getMarkdown, parseMarkdownToStructure } from "stream-markdown-parser";
 
-//#region src/renderer/terminal-graphics.ts
-const TERMINAL_GRAPHICS_PROTOCOL_PRIORITY = [
-	"kitty",
-	"iterm2",
-	"sixel"
-];
-const ESC = "\x1B";
-const BEL = "\x07";
-const ST = `${ESC}\\`;
-const ESC_RE = "\\u001B";
-const BEL_RE = "\\u0007";
-const CSI_RE = new RegExp(`${ESC_RE}\\[[0-?]*[ -/]*[@-~]`, "g");
-const OSC_RE = new RegExp(`${ESC_RE}\\][\\s\\S]*?(?:${BEL_RE}|${ESC_RE}\\\\)`, "g");
-const DCS_RE = new RegExp(`${ESC_RE}P[\\s\\S]*?${ESC_RE}\\\\`, "g");
-const APC_RE = new RegExp(`${ESC_RE}_[\\s\\S]*?${ESC_RE}\\\\`, "g");
-const C1_CSI_RE = new RegExp("\\u009B[0-?]*[ -/]*[@-~]", "g");
-const C1_OSC_RE = new RegExp(`\\u009D[\\s\\S]*?(?:${BEL_RE}|\\u009C)`, "g");
-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 TERMINAL_GRAPHICS_REGISTRY = Symbol.for("@simon_he/vue-tui:v1:terminal-graphics");
-const terminalGraphicsGlobal = globalThis;
-const terminalGraphicsRegistry = terminalGraphicsGlobal[TERMINAL_GRAPHICS_REGISTRY] ?? {
-	outputs: new WeakMap(),
-	outputVersions: new WeakMap(),
-	outputListeners: new WeakMap()
-};
-terminalGraphicsGlobal[TERMINAL_GRAPHICS_REGISTRY] = terminalGraphicsRegistry;
-const terminalGraphicsOutputs = terminalGraphicsRegistry.outputs;
-const terminalGraphicsOutputVersions = terminalGraphicsRegistry.outputVersions;
-const terminalGraphicsOutputListeners = terminalGraphicsRegistry.outputListeners;
-function getTerminalGraphicsOutput(terminal) {
-	return terminalGraphicsOutputs.get(getRootTerminal(terminal)) ?? null;
-}
-function getTerminalGraphicsOutputVersion(terminal) {
-	return terminalGraphicsOutputVersions.get(getRootTerminal(terminal)) ?? 0;
-}
-function subscribeTerminalGraphicsOutput(terminal, listener) {
-	const rootTerminal = getRootTerminal(terminal);
-	let listeners = terminalGraphicsOutputListeners.get(rootTerminal);
-	if (!listeners) {
-		listeners = new Set();
-		terminalGraphicsOutputListeners.set(rootTerminal, listeners);
-	}
-	listeners.add(listener);
-	return () => {
-		listeners.delete(listener);
-		if (listeners.size === 0) terminalGraphicsOutputListeners.delete(rootTerminal);
-	};
-}
-function envString(env, key) {
-	const value = env[key];
-	return value == null ? void 0 : String(value);
-}
-function truthy(value) {
-	if (value == null) return false;
-	return /^(1|true|yes|on)$/i.test(String(value));
-}
-function readStdoutIsTTY() {
-	const maybeProcess = globalThis.process;
-	return Boolean(maybeProcess?.stdout?.isTTY);
-}
-function readProcessEnv() {
-	const maybeProcess = globalThis.process;
-	return maybeProcess?.env ?? {};
-}
-function normalizeMode(value) {
-	const raw = String(value ?? "auto").trim().toLowerCase();
-	if (raw === "auto" || raw === "off" || raw === "none" || raw === "kitty" || raw === "iterm2" || raw === "sixel" || raw === "unicode") return raw === "off" ? "none" : raw;
-	return "auto";
-}
-function isTerminalGraphicsProtocol(value) {
-	return value === "kitty" || value === "iterm2" || value === "sixel";
-}
-function uniqueProtocols(protocols) {
-	return [...new Set(protocols)];
-}
-function pickBestTerminalGraphicsProtocol(protocols) {
-	const available = new Set(protocols);
-	for (const protocol of TERMINAL_GRAPHICS_PROTOCOL_PRIORITY) if (available.has(protocol)) return protocol;
-	return null;
-}
-function detectCandidates(env) {
-	const candidates = [];
-	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 (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);
-}
-function capabilitiesFor(protocol, input) {
-	const supported = protocol === "kitty" || protocol === "iterm2" || protocol === "sixel";
-	const candidates = uniqueProtocols([...input.candidates ?? (supported ? [protocol] : [])]);
-	return {
-		supported,
-		kitty: protocol === "kitty" || candidates.includes("kitty"),
-		iterm2: protocol === "iterm2" || candidates.includes("iterm2"),
-		sixel: protocol === "sixel" || candidates.includes("sixel"),
-		preferredProtocol: supported ? protocol : null,
-		protocol,
-		candidates,
-		stdoutIsTTY: input.stdoutIsTTY,
-		insideTmux: input.insideTmux,
-		insideScreen: input.insideScreen,
-		insideZellij: input.insideZellij,
-		multiplexer: input.multiplexer,
-		passthrough: input.passthrough,
-		forced: input.forced,
-		reason: input.reason
-	};
-}
-function detectTerminalGraphicsCapabilities(options = {}) {
-	const env = options.env ?? readProcessEnv();
-	const stdoutIsTTY = options.stdoutIsTTY ?? options.isTTY ?? readStdoutIsTTY();
-	const term = String(envString(env, "TERM") ?? "").toLowerCase();
-	const insideTmux = Boolean(envString(env, "TMUX")) || term.includes("tmux");
-	const insideScreen = Boolean(envString(env, "STY")) || term.startsWith("screen");
-	const insideZellij = Boolean(envString(env, "ZELLIJ") || envString(env, "ZELLIJ_SESSION_NAME")) || term.includes("zellij");
-	const multiplexer = insideTmux ? "tmux" : insideScreen ? "screen" : insideZellij ? "zellij" : null;
-	const passthroughRequested = options.passthrough ?? (truthy(envString(env, "VUE_TUI_TERMINAL_GRAPHICS_PASSTHROUGH")) || truthy(envString(env, "VUE_TUI_GRAPHICS_TMUX_PASSTHROUGH")));
-	const passthroughSupported = !multiplexer || multiplexer === "tmux";
-	const passthrough = passthroughRequested && passthroughSupported;
-	const protocolOptionProvided = options.protocol != null;
-	const mode = normalizeMode(options.protocol ?? envString(env, "VUE_TUI_TERMINAL_GRAPHICS") ?? envString(env, "VUE_TUI_GRAPHICS_PROTOCOL"));
-	const forceFromOption = options.force === true;
-	const force = options.force ?? truthy(envString(env, "VUE_TUI_GRAPHICS_FORCE"));
-	const base = {
-		stdoutIsTTY,
-		insideTmux,
-		insideScreen,
-		insideZellij,
-		multiplexer,
-		passthrough,
-		forced: force
-	};
-	if (mode === "none") return capabilitiesFor("none", {
-		...base,
-		reason: protocolOptionProvided ? "disabled-by-option" : "disabled-by-env"
-	});
-	if (!stdoutIsTTY && !force) return capabilitiesFor("unicode", {
-		...base,
-		reason: "stdout-is-not-tty"
-	});
-	if (truthy(envString(env, "CI")) && !force) return capabilitiesFor("unicode", {
-		...base,
-		reason: "ci"
-	});
-	if (multiplexer && passthroughRequested && !passthroughSupported && !force) return capabilitiesFor("unicode", {
-		...base,
-		reason: `${multiplexer}-passthrough-not-implemented`
-	});
-	if (multiplexer && !passthrough && !force) return capabilitiesFor("unicode", {
-		...base,
-		reason: `${multiplexer}-without-passthrough`
-	});
-	if (mode === "kitty" || mode === "iterm2" || mode === "sixel") return capabilitiesFor(mode, {
-		...base,
-		candidates: [mode],
-		reason: force ? forceFromOption ? "forced-by-option" : "forced-by-env" : protocolOptionProvided ? "selected-by-option" : "selected-by-env"
-	});
-	if (mode === "unicode") return capabilitiesFor("unicode", {
-		...base,
-		reason: protocolOptionProvided ? "unicode-forced-by-option" : "unicode-forced-by-env"
-	});
-	const candidates = detectCandidates(env);
-	const preferredProtocol = pickBestTerminalGraphicsProtocol(candidates);
-	const protocol = preferredProtocol ?? "unicode";
-	return capabilitiesFor(protocol, {
-		...base,
-		candidates,
-		reason: protocol === "unicode" ? "no-supported-graphics-protocol-detected" : "auto-detected"
-	});
-}
-function hashTerminalGraphicsString(input) {
-	let hash = 2166136261;
-	for (let index = 0; index < input.length; index += 1) {
-		hash ^= input.charCodeAt(index);
-		hash = Math.imul(hash, 16777619);
-	}
-	return (hash >>> 0).toString(36);
-}
-function stableTerminalGraphicNumericId(input, options = {}) {
-	const min = Math.floor(options.min ?? 1);
-	const max = Math.floor(options.max ?? 2147483647);
-	const span = Math.max(1, max - min + 1);
-	let hash = 2166136261;
-	for (let index = 0; index < input.length; index += 1) {
-		hash ^= input.charCodeAt(index);
-		hash = Math.imul(hash, 16777619);
-	}
-	return min + (hash >>> 0) % span;
-}
-function positiveGraphicInt(value, max) {
-	const n = Math.trunc(Number(value));
-	if (!Number.isFinite(n) || n <= 0) return null;
-	return Math.min(max, n);
-}
-function normalizeTerminalGraphicSize(width, height) {
-	const w = positiveGraphicInt(width, MAX_TERMINAL_GRAPHIC_CELLS);
-	const h$1 = positiveGraphicInt(height, MAX_TERMINAL_GRAPHIC_CELLS);
-	if (w == null || h$1 == null) return null;
-	if (w * h$1 > MAX_TERMINAL_GRAPHIC_CELLS) return null;
-	return {
-		width: w,
-		height: h$1
-	};
-}
-function canDrawTerminalGraphicRect(rect, size) {
-	const x = Math.floor(rect.x);
-	const y = Math.floor(rect.y);
-	const graphicSize = normalizeTerminalGraphicSize(rect.w, rect.h);
-	const cols = Math.max(0, Math.floor(size.cols));
-	const rows = Math.max(0, Math.floor(size.rows));
-	return graphicSize != null && cols > 0 && rows > 0 && Number.isFinite(x) && Number.isFinite(y) && x >= 0 && y >= 0 && x < cols && y < rows;
-}
-function withoutNestedEscapes(body) {
-	return !body.includes(ESC) && !body.includes(BEL);
-}
-function isBase64ish(value) {
-	return /^[A-Za-z0-9+/=]*$/.test(value);
-}
-function parseKittyControls(raw) {
-	const out = new Map();
-	if (!/^[A-Za-z0-9_,=+.\-:]*$/.test(raw)) return null;
-	for (const part of raw.split(",")) {
-		if (!part) continue;
-		const eq = part.indexOf("=");
-		if (eq <= 0) return null;
-		const key = part.slice(0, eq);
-		const value = part.slice(eq + 1);
-		if (!/^[A-Za-z]$/.test(key)) return null;
-		if (!/^[A-Za-z0-9+.\-:]*$/.test(value)) return null;
-		out.set(key, value);
-	}
-	return out;
-}
-function parseKittyPackets(sequence) {
-	const packets = [];
-	let index = 0;
-	while (index < sequence.length) {
-		if (!sequence.startsWith(`${ESC}_G`, index)) return null;
-		const end = sequence.indexOf(ST, index + 3);
-		if (end < 0) return null;
-		const body = sequence.slice(index + 3, end);
-		if (!withoutNestedEscapes(body)) return null;
-		const semicolon = body.indexOf(";");
-		const rawControls = semicolon >= 0 ? body.slice(0, semicolon) : body;
-		const payload = semicolon >= 0 ? body.slice(semicolon + 1) : "";
-		const controls = parseKittyControls(rawControls);
-		if (!controls) return null;
-		if (payload && !isBase64ish(payload)) return null;
-		packets.push({
-			controls,
-			payload
-		});
-		index = end + ST.length;
-	}
-	return packets.length ? packets : null;
-}
-const KITTY_DRAW_FIRST_CONTROL_KEYS = new Set([
-	"a",
-	"f",
-	"q",
-	"C",
-	"i",
-	"I",
-	"p",
-	"c",
-	"r",
-	"x",
-	"y",
-	"w",
-	"h",
-	"z",
-	"m",
-	"t"
-]);
-const KITTY_DRAW_CONTINUATION_CONTROL_KEYS = new Set([
-	"a",
-	"q",
-	"m"
-]);
-const KITTY_CLEAR_CONTROL_KEYS = new Set([
-	"a",
-	"d",
-	"i",
-	"I",
-	"p",
-	"q"
-]);
-function kittyControlsUseOnly(controls, allowed) {
-	for (const key of controls.keys()) if (!allowed.has(key)) return false;
-	return true;
-}
-const KITTY_UINT32_MAX = 4294967295;
-const KITTY_INT32_MIN = -2147483648;
-const KITTY_INT32_MAX = 2147483647;
-function kittyControlIsUint32(controls, key, min = 0) {
-	const value = controls.get(key);
-	if (value == null) return true;
-	if (!/^\d+$/.test(value)) return false;
-	const n = Number(value);
-	return Number.isSafeInteger(n) && n >= min && n <= KITTY_UINT32_MAX;
-}
-function kittyControlIsInt32(controls, key) {
-	const value = controls.get(key);
-	if (value == null) return true;
-	if (!/^-?\d+$/.test(value)) return false;
-	const n = Number(value);
-	return Number.isSafeInteger(n) && n >= KITTY_INT32_MIN && n <= KITTY_INT32_MAX;
-}
-function kittyControlPositiveInt(controls, key, fallback) {
-	const value = controls.get(key);
-	if (value == null) return fallback;
-	if (!/^\d+$/.test(value)) return null;
-	const n = Number(value);
-	return Number.isSafeInteger(n) && n >= 1 ? n : null;
-}
-function kittyControlIsTerminalGraphicCellsBounded(controls) {
-	const columns = kittyControlPositiveInt(controls, "c", 1);
-	const rows = kittyControlPositiveInt(controls, "r", 1);
-	return columns != null && rows != null && columns * rows <= MAX_TERMINAL_GRAPHIC_CELLS;
-}
-function validateKittySharedSafeControls(controls) {
-	const q = controls.get("q");
-	if (q != null && !/^[0-2]$/.test(q)) return false;
-	const cursorMove = controls.get("C");
-	if (cursorMove != null && !/^[01]$/.test(cursorMove)) return false;
-	for (const key of [
-		"i",
-		"I",
-		"p"
-	]) if (!kittyControlIsUint32(controls, key)) return false;
-	for (const key of ["c", "r"]) if (!kittyControlIsUint32(controls, key, 1)) return false;
-	if (!kittyControlIsTerminalGraphicCellsBounded(controls)) return false;
-	for (const key of ["x", "y"]) if (!kittyControlIsUint32(controls, key)) return false;
-	for (const key of ["w", "h"]) if (!kittyControlIsUint32(controls, key, 1)) return false;
-	if (!kittyControlIsInt32(controls, "z")) return false;
-	const transmissionMedium = controls.get("t");
-	if (transmissionMedium != null && transmissionMedium !== "d") return false;
-	return true;
-}
-function validateKittySequence(sequence, op = "draw") {
-	const packets = parseKittyPackets(sequence);
-	if (!packets) return false;
-	if (op === "clear") {
-		if (packets.length !== 1) return false;
-		const packet = packets[0];
-		if (!kittyControlsUseOnly(packet.controls, KITTY_CLEAR_CONTROL_KEYS)) return false;
-		if (!validateKittySharedSafeControls(packet.controls)) return false;
-		if (packet.payload) return false;
-		if (packet.controls.get("a") !== "d") return false;
-		const d = packet.controls.get("d");
-		return d == null || /^[aAcCiI]$/.test(d);
-	}
-	const first = packets[0];
-	if (!kittyControlsUseOnly(first.controls, KITTY_DRAW_FIRST_CONTROL_KEYS)) return false;
-	if (!validateKittySharedSafeControls(first.controls)) return false;
-	if (first.controls.get("a") === "p") {
-		if (packets.length !== 1) return false;
-		if (first.payload) return false;
-		if (!first.controls.has("i") && !first.controls.has("I")) return false;
-		return true;
-	}
-	if (first.controls.get("a") !== "T") return false;
-	if (!first.payload) return false;
-	const f = first.controls.get("f");
-	if (f != null && f !== "24" && f !== "32" && f !== "100") return false;
-	const firstMore = first.controls.get("m");
-	if (firstMore != null && firstMore !== "0" && firstMore !== "1") return false;
-	if (packets.length > 1 && firstMore !== "1") return false;
-	for (let i = 1; i < packets.length; i++) {
-		const packet = packets[i];
-		if (!kittyControlsUseOnly(packet.controls, KITTY_DRAW_CONTINUATION_CONTROL_KEYS)) return false;
-		if (!validateKittySharedSafeControls(packet.controls)) return false;
-		const action = packet.controls.get("a");
-		if (action != null && action !== "T") return false;
-		const m = packet.controls.get("m");
-		if (m !== "0" && m !== "1") return false;
-		if (!packet.payload && !(i === packets.length - 1 && m === "0")) return false;
-	}
-	if (packets.length > 1 && packets[packets.length - 1].controls.get("m") === "1") return false;
-	return true;
-}
-function validateIterm2Dimension(value) {
-	return /^auto$/i.test(value) || /^(?:[1-9]\d{0,4})(?:px|%)?$/.test(value);
-}
-function validateIterm2Params(params) {
-	const seen = new Set();
-	let inline = false;
-	for (const part of params.split(";").filter(Boolean)) {
-		const eq = part.indexOf("=");
-		if (eq <= 0) return false;
-		const key = part.slice(0, eq);
-		const value = part.slice(eq + 1);
-		if (seen.has(key)) return false;
-		seen.add(key);
-		switch (key) {
-			case "inline":
-				if (value !== "1") return false;
-				inline = true;
-				break;
-			case "width":
-			case "height":
-				if (!validateIterm2Dimension(value)) return false;
-				break;
-			case "preserveAspectRatio":
-			case "doNotMoveCursor":
-				if (!/^[01]$/.test(value)) return false;
-				break;
-			default: return false;
-		}
-	}
-	return inline;
-}
-function validateIterm2Sequence(sequence, op = "draw") {
-	if (op === "clear") return false;
-	let index = 0;
-	while (index < sequence.length) {
-		const prefix = `${ESC}]1337;File=`;
-		if (!sequence.startsWith(prefix, index)) return false;
-		const belEnd = sequence.indexOf(BEL, index + prefix.length);
-		const stEnd = sequence.indexOf(ST, index + prefix.length);
-		const end = belEnd >= 0 && stEnd >= 0 ? Math.min(belEnd, stEnd) : belEnd >= 0 ? belEnd : stEnd;
-		if (end < 0) return false;
-		const body = sequence.slice(index + `${ESC}]1337;`.length, end);
-		if (!body.startsWith("File=")) return false;
-		if (!withoutNestedEscapes(body)) return false;
-		const colon = body.indexOf(":");
-		if (colon < 0) return false;
-		const params = body.slice(5, colon);
-		const payload = body.slice(colon + 1);
-		if (!/^[A-Za-z0-9_=;,.%+\-:]*$/.test(params)) return false;
-		if (!payload || !isBase64ish(payload)) return false;
-		if (!validateIterm2Params(params)) return false;
-		index = end + (end === stEnd ? ST.length : BEL.length);
-	}
-	return sequence.length > 0;
-}
-function validateSixelSequence(sequence, op = "draw") {
-	if (op === "clear") return false;
-	let index = 0;
-	while (index < sequence.length) {
-		if (!sequence.startsWith(`${ESC}P`, index)) return false;
-		const end = sequence.indexOf(ST, index + 2);
-		if (end < 0) return false;
-		const body = sequence.slice(index + 2, end);
-		if (!withoutNestedEscapes(body)) return false;
-		for (let i = 0; i < body.length; i++) {
-			const code = body.charCodeAt(i);
-			if (code < 32 || code > 126) return false;
-		}
-		const q = body.indexOf("q");
-		if (q < 0 || q > 32) return false;
-		const introducer = body.slice(0, q);
-		if (!/^[0-9;?]*$/.test(introducer)) return false;
-		const data = body.slice(q + 1);
-		if (!data.length) return false;
-		index = end + ST.length;
-	}
-	return sequence.length > 0;
-}
-function stripTerminalControlChars(value) {
-	let out = "";
-	for (let index = 0; index < value.length; index++) {
-		const code = value.charCodeAt(index);
-		if (code <= 8 || code === 11 || code === 12 || code >= 14 && code <= 31 || code === 127 || code >= 128 && code <= 159) continue;
-		out += value[index];
-	}
-	return out;
-}
-function sanitizeTerminalFallbackText(text) {
-	return stripTerminalControlChars(String(text ?? "").replace(OSC_RE, "").replace(CSI_RE, "").replace(DCS_RE, "").replace(APC_RE, "").replace(C1_OSC_RE, "").replace(C1_CSI_RE, "").replace(C1_DCS_RE, "").replace(C1_APC_RE, "")).slice(0, MAX_TERMINAL_GRAPHICS_FALLBACK_CHARS);
-}
-function isSafeTerminalGraphicsSequence(sequence, protocol, op = "draw") {
-	if (!isTerminalGraphicsProtocol(protocol)) return false;
-	if (!sequence || sequence.length > MAX_TERMINAL_GRAPHICS_SEQUENCE_CHARS) return false;
-	return protocol === "kitty" ? validateKittySequence(sequence, op) : protocol === "iterm2" ? validateIterm2Sequence(sequence, op) : validateSixelSequence(sequence, op);
-}
-function uint32Control(key, value, min = 0) {
-	if (value == null) return "";
-	const n = Math.floor(value);
-	return Number.isSafeInteger(n) && n >= min && n <= KITTY_UINT32_MAX ? `${key}=${n}` : "";
-}
-function int32Control(key, value) {
-	if (value == null) return "";
-	const n = Math.floor(value);
-	return Number.isSafeInteger(n) && n >= KITTY_INT32_MIN && n <= KITTY_INT32_MAX ? `${key}=${n}` : "";
-}
-function sanitizeBase64(value) {
-	const data = String(value ?? "").replace(/\s+/g, "");
-	return isBase64ish(data) ? data : "";
-}
-function kittyGraphicCellControls(columns, rows) {
-	if (columns == null && rows == null) return [];
-	const size = normalizeTerminalGraphicSize(columns ?? 1, rows ?? 1);
-	if (!size) return [];
-	return [columns == null ? "" : `c=${size.width}`, rows == null ? "" : `r=${size.height}`];
-}
-function kittyGraphicSourceControls(sourceX, sourceY, sourceWidth, sourceHeight) {
-	return [
-		uint32Control("x", sourceX),
-		uint32Control("y", sourceY),
-		uint32Control("w", sourceWidth, 1),
-		uint32Control("h", sourceHeight, 1)
-	];
-}
-function chunkBase64(value, chunkSize) {
-	const normalizedSize = Math.max(4, Math.floor(chunkSize / 4) * 4);
-	const chunks = [];
-	for (let index = 0; index < value.length; index += normalizedSize) chunks.push(value.slice(index, index + normalizedSize));
-	return chunks.length ? chunks : [""];
-}
-function createKittyPlacementSequence(options) {
-	const imageId = uint32Control("i", options.imageId);
-	const imageNumber = uint32Control("I", options.imageNumber);
-	if (!imageId && !imageNumber) return "";
-	const controls = [
-		"a=p",
-		options.quiet === false ? "" : "q=2",
-		options.noCursorMove === false ? "" : "C=1",
-		imageId,
-		imageNumber,
-		uint32Control("p", options.placementId),
-		...kittyGraphicCellControls(options.columns, options.rows),
-		...kittyGraphicSourceControls(options.sourceX, options.sourceY, options.sourceWidth, options.sourceHeight),
-		int32Control("z", options.zIndex)
-	].filter(Boolean);
-	return `${ESC}_G${controls.join(",")}${ST}`;
-}
-function createKittyGraphicsSequence(base64Png, options = {}) {
-	const data = sanitizeBase64(base64Png);
-	if (!data) return "";
-	const chunks = chunkBase64(data, options.chunkSize ?? 4096);
-	const baseControls = [
-		"a=T",
-		"f=100",
-		options.quiet === false ? "" : "q=2",
-		options.noCursorMove === false ? "" : "C=1",
-		uint32Control("i", options.imageId),
-		uint32Control("I", options.imageNumber),
-		uint32Control("p", options.placementId),
-		...kittyGraphicCellControls(options.columns, options.rows),
-		...kittyGraphicSourceControls(options.sourceX, options.sourceY, options.sourceWidth, options.sourceHeight),
-		int32Control("z", options.zIndex)
-	].filter(Boolean);
-	return chunks.map((chunk, index) => {
-		const last = index === chunks.length - 1;
-		const controls = index === 0 ? [...baseControls, chunks.length > 1 ? `m=${last ? 0 : 1}` : ""] : [options.quiet === false ? "" : "q=2", `m=${last ? 0 : 1}`].filter(Boolean);
-		return `${ESC}_G${controls.filter(Boolean).join(",")};${chunk}${ST}`;
-	}).join("");
-}
-function createKittyDeleteGraphicsSequence(options = {}) {
-	const controls = ["a=d"];
-	if (options.allVisible) controls.push(`d=${options.freeImageData ? "A" : "a"}`);
-	else if (options.imageId != null) {
-		const imageId = uint32Control("i", options.imageId);
-		const placementId = uint32Control("p", options.placementId);
-		if (!imageId || options.placementId != null && !placementId) return "";
-		controls.push(`d=${options.freeImageData ? "I" : "i"}`);
-		controls.push(imageId);
-		controls.push(placementId);
-	} else if (options.currentCell) controls.push(`d=${options.freeImageData ? "C" : "c"}`);
-	else return "";
-	if (options.quiet !== false) controls.push("q=2");
-	return `${ESC}_G${controls.filter(Boolean).join(",")}${ST}`;
-}
-function createIterm2InlineImageSequence(base64Data, options = {}) {
-	const data = sanitizeBase64(base64Data);
-	if (!data) return "";
-	const params = [
-		"inline=1",
-		options.width != null ? `width=${formatItermDimension(options.width)}` : "",
-		options.height != null ? `height=${formatItermDimension(options.height)}` : "",
-		`preserveAspectRatio=${options.preserveAspectRatio === false ? 0 : 1}`,
-		options.doNotMoveCursor === false ? "" : "doNotMoveCursor=1"
-	].filter(Boolean);
-	return `${ESC}]1337;File=${params.join(";")}:${data}${BEL}`;
-}
-function formatItermDimension(value) {
-	if (typeof value === "number") {
-		const n = Math.floor(value);
-		if (!Number.isFinite(n)) return "auto";
-		return String(Math.min(99999, Math.max(1, n)));
-	}
-	const raw = String(value ?? "").trim();
-	return validateIterm2Dimension(raw) ? raw : "auto";
-}
-
-//#endregion
 //#region src/vue/markdown/image.ts
 const DATA_IMAGE_RE = /^data:(image\/[A-Za-z0-9.+-]+);base64,([A-Za-z0-9+/=\s]+)$/i;
 const SAFE_IMAGE_MIME_RE = /^image\/(?:png|jpeg|jpg|gif|webp)$/i;
@@ -710,6 +115,29 @@ function readMarkdownImageDimensions(base64) {
 
 //#endregion
 //#region src/vue/markdown/math.ts
+let loadedKatex = null;
+let katexLoad = null;
+const katexListeners = new Set();
+function resolveKatexRenderer(value) {
+	if (!value || typeof value !== "object") return null;
+	const renderToString = value.renderToString;
+	return typeof renderToString === "function" ? { renderToString } : null;
+}
+function subscribeMarkdownMathRenderer(listener) {
+	katexListeners.add(listener);
+	return () => katexListeners.delete(listener);
+}
+async function loadMarkdownMathRenderer() {
+	if (loadedKatex) return true;
+	if (!katexLoad) katexLoad = import("katex").then((mod) => {
+		const renderer = resolveKatexRenderer(mod.default) ?? resolveKatexRenderer(mod);
+		if (!renderer) return false;
+		loadedKatex = renderer;
+		for (const listener of katexListeners) listener();
+		return true;
+	}).catch(() => false);
+	return katexLoad;
+}
 const KATEX_TEXT_OPTIONS = Object.freeze({
 	output: "mathml",
 	throwOnError: false,
@@ -838,7 +266,7 @@ function approximateTexToUnicode(tex) {
 	out = out.replace(/\s+/g, " ").trim();
 	return sanitizeInlineText(out.replace(/[<>]/g, ""));
 }
-function canRenderTerminalMath(tex) {
+function canRenderTerminalMath(tex, katex) {
 	const source = String(tex ?? "").trim();
 	if (!source || source.length > 160) return false;
 	if (/\\(?:begin|end|left|right|matrix|cases|array|align|color|href|html|includegraphics|class|style|tag|text|operatorname)\b/.test(source)) return false;
@@ -857,7 +285,15 @@ function renderMarkdownInlineMathSegment(tex) {
 		text: "",
 		supported: false
 	};
-	if (!canRenderTerminalMath(source)) return {
+	const katex = loadedKatex;
+	if (!katex) {
+		loadMarkdownMathRenderer();
+		return {
+			text: "",
+			supported: false
+		};
+	}
+	if (!canRenderTerminalMath(source, katex)) return {
 		text: "",
 		supported: false
 	};
@@ -964,6 +400,15 @@ function stringProp(node, key) {
 	const value = node[key];
 	return typeof value === "string" ? value : "";
 }
+/**
+* Temporary fallback: stream-markdown-parser only recovers `![alt](file:///X:/...)`
+* destinations (Windows drive letters, fixed in 1.1.8). Unix-style `file:///...`
+* destinations at inline start are still emitted as `text("!") + link`. Remove this
+* once the parser covers all `file://` destinations.
+*/
+function isUnixFileUrlNeedingImageFallback(href) {
+	return /^file:\/\//i.test(href) && !/^file:\/\/\/[a-z]:\//i.test(href);
+}
 function imageSourceFromRaw(raw) {
 	if (!raw.startsWith("![")) return "";
 	const marker = raw.indexOf("](");
@@ -1060,132 +505,150 @@ function codeBlockLanguage(node) {
 }
 function inlineNodeSegments(nodes, theme, inheritedStyle, options = {}) {
 	const out = [];
-	for (const node of nodes) switch (node.type) {
-		case "text":
-			pushTextSegments(out, stringProp(node, "content"), inheritedStyle);
-			break;
-		case "inline":
-		case "paragraph":
-		case "heading":
-		case "list_item":
-		case "blockquote":
-			out.push(...inlineNodeSegments(nodeChildren(node), theme, inheritedStyle, options));
-			break;
-		case "strong":
-			out.push(...inlineNodeSegments(nodeChildren(node), theme, mergeStyle$1(inheritedStyle, theme.strong), options));
-			break;
-		case "emphasis":
-			out.push(...inlineNodeSegments(nodeChildren(node), theme, mergeStyle$1(inheritedStyle, theme.emphasis), options));
-			break;
-		case "strikethrough":
-			out.push(...inlineNodeSegments(nodeChildren(node), theme, mergeStyle$1(inheritedStyle, theme.strikethrough), options));
-			break;
-		case "highlight":
-		case "insert":
-		case "subscript":
-		case "superscript":
-			out.push(...inlineNodeSegments(nodeChildren(node), theme, inheritedStyle, options));
-			break;
-		case "inline_code":
-			pushTextSegments(out, stringProp(node, "code"), mergeStyle$1(inheritedStyle, theme.inlineCode));
-			break;
-		case "hardbreak":
-			out.push(HARD_BREAK_SEGMENT);
-			break;
-		case "link": {
-			const href = stringProp(node, "href");
-			const safeHref = href ? sanitizeMarkdownLink(href) : null;
-			const linkStyle = safeHref ? mergeStyle$1(inheritedStyle, {
-				...theme.link,
-				href: safeHref
-			}) : inheritedStyle;
-			const children = nodeChildren(node);
-			if (children.length) out.push(...inlineNodeSegments(children, theme, linkStyle, options));
-			else pushTextSegments(out, stringProp(node, "text"), linkStyle);
-			break;
+	for (let index = 0; index < nodes.length; index++) {
+		let node = nodes[index];
+		const next = nodes[index + 1];
+		const text = node.type === "text" ? stringProp(node, "content") : "";
+		if (node.type === "text" && text.endsWith("!") && stringProp(node, "raw").endsWith("!") && next?.type === "link" && isUnixFileUrlNeedingImageFallback(stringProp(next, "href"))) {
+			const src = stringProp(next, "href");
+			if (sanitizeMarkdownImageSource(src)) {
+				pushTextSegments(out, text.slice(0, -1), inheritedStyle);
+				node = {
+					type: "image",
+					src,
+					alt: stringProp(next, "text"),
+					raw: `!${stringProp(next, "raw")}`
+				};
+				index++;
+			}
 		}
-		case "image": {
-			const raw = stringProp(node, "raw");
-			const rawSource = stringProp(node, "src") || imageSourceFromRaw(raw);
-			const source = sanitizeMarkdownImageSource(rawSource);
-			const alt = stringProp(node, "alt") || imageFallbackText(raw, rawSource, source?.src);
-			if (source) {
-				const size = options.imageSize;
-				const imageLinkStyle = mergeStyle$1(inheritedStyle, {
+		switch (node.type) {
+			case "text":
+				pushTextSegments(out, stringProp(node, "content"), inheritedStyle);
+				break;
+			case "inline":
+			case "paragraph":
+			case "heading":
+			case "list_item":
+			case "blockquote":
+				out.push(...inlineNodeSegments(nodeChildren(node), theme, inheritedStyle, options));
+				break;
+			case "strong":
+				out.push(...inlineNodeSegments(nodeChildren(node), theme, mergeStyle$1(inheritedStyle, theme.strong), options));
+				break;
+			case "emphasis":
+				out.push(...inlineNodeSegments(nodeChildren(node), theme, mergeStyle$1(inheritedStyle, theme.emphasis), options));
+				break;
+			case "strikethrough":
+				out.push(...inlineNodeSegments(nodeChildren(node), theme, mergeStyle$1(inheritedStyle, theme.strikethrough), options));
+				break;
+			case "highlight":
+			case "insert":
+			case "subscript":
+			case "superscript":
+				out.push(...inlineNodeSegments(nodeChildren(node), theme, inheritedStyle, options));
+				break;
+			case "inline_code":
+				pushTextSegments(out, stringProp(node, "code"), mergeStyle$1(inheritedStyle, theme.inlineCode));
+				break;
+			case "hardbreak":
+				out.push(HARD_BREAK_SEGMENT);
+				break;
+			case "link": {
+				const href = stringProp(node, "href");
+				const safeHref = href ? sanitizeMarkdownLink(href) : null;
+				const linkStyle = safeHref ? mergeStyle$1(inheritedStyle, {
 					...theme.link,
-					href: source.src
-				});
-				const sourceDimensions = readMarkdownImageDimensions(source.base64);
-				const graphicBase = {
-					kind: "image",
-					src: source.src,
-					alt,
-					...source.mime ? { mime: source.mime } : {},
-					...source.base64 ? { base64: source.base64 } : {},
-					...sourceDimensions ? {
-						naturalWidth: sourceDimensions.width,
-						naturalHeight: sourceDimensions.height
-					} : {},
-					...resolveImageDisplaySize(alt, size, sourceDimensions?.width, sourceDimensions?.height)
-				};
-				const resolved = normalizeImageResolverResult(options.imageResolver?.(graphicBase));
-				const base64 = resolved.base64 || source.base64;
-				if (base64) {
-					const dimensions = readMarkdownImageDimensions(base64) ?? sourceDimensions;
-					const graphic = {
-						...graphicBase,
-						base64,
-						...resolved.originalBase64 ? { originalBase64: resolved.originalBase64 } : {},
-						...resolved.mime ? { mime: resolved.mime } : {},
-						...resolved.originalMime ? { originalMime: resolved.originalMime } : {},
-						...dimensions ? {
-							naturalWidth: dimensions.width,
-							naturalHeight: dimensions.height
+					href: safeHref
+				}) : inheritedStyle;
+				const children = nodeChildren(node);
+				if (children.length) out.push(...inlineNodeSegments(children, theme, linkStyle, options));
+				else pushTextSegments(out, stringProp(node, "text"), linkStyle);
+				break;
+			}
+			case "image": {
+				const raw = stringProp(node, "raw");
+				const rawSource = stringProp(node, "src") || imageSourceFromRaw(raw);
+				const source = sanitizeMarkdownImageSource(rawSource);
+				const alt = stringProp(node, "alt") || imageFallbackText(raw, rawSource, source?.src);
+				if (source) {
+					const size = options.imageSize;
+					const imageLinkStyle = mergeStyle$1(inheritedStyle, {
+						...theme.link,
+						href: source.src
+					});
+					const sourceDimensions = readMarkdownImageDimensions(source.base64);
+					const graphicBase = {
+						kind: "image",
+						src: source.src,
+						alt,
+						...source.mime ? { mime: source.mime } : {},
+						...source.base64 ? { base64: source.base64 } : {},
+						...sourceDimensions ? {
+							naturalWidth: sourceDimensions.width,
+							naturalHeight: sourceDimensions.height
 						} : {},
-						...resolveImageDisplaySize(alt, size, dimensions?.width, dimensions?.height)
+						...resolveImageDisplaySize(alt, size, sourceDimensions?.width, sourceDimensions?.height)
 					};
-					pushTextSegments(out, alt, imageLinkStyle, graphic);
-				} else pushTextSegments(out, alt, imageLinkStyle);
-			} else pushTextSegments(out, alt, mergeStyle$1(inheritedStyle, theme.link));
-			break;
-		}
-		case "checkbox":
-		case "checkbox_input":
-			pushTextSegments(out, booleanProp(node, "checked") ? "[x]" : "[ ]", inheritedStyle);
-			break;
-		case "emoji":
-			pushTextSegments(out, stringProp(node, "markup") || stringProp(node, "name"), inheritedStyle);
-			break;
-		case "math_inline":
-			{
-				const source = stringProp(node, "content");
-				const raw = stringProp(node, "raw") || `$${source}$`;
-				const rendered = renderMarkdownInlineMathSegment(source);
-				pushTextSegments(out, rendered.supported ? rendered.text : raw, mergeStyle$1(inheritedStyle, theme.inlineCode), void 0, {
-					source,
-					raw,
-					rendered: rendered.supported
-				});
-			}
-			break;
-		case "reference":
-		case "footnote_reference":
-		case "footnote_anchor":
-			pushTextSegments(out, stringProp(node, "raw"), inheritedStyle);
-			break;
-		case "html_inline":
-			pushTextSegments(out, stringProp(node, "content"), mergeStyle$1(inheritedStyle, theme.html));
-			break;
-		case "html_block":
-			pushTextSegments(out, stringProp(node, "content"), mergeStyle$1(inheritedStyle, theme.html));
-			break;
-		default:
-			if (nodeChildren(node).length) {
-				out.push(...inlineNodeSegments(nodeChildren(node), theme, inheritedStyle, options));
+					const resolved = normalizeImageResolverResult(options.imageResolver?.(graphicBase));
+					const base64 = resolved.base64 || source.base64;
+					if (base64) {
+						const dimensions = readMarkdownImageDimensions(base64) ?? sourceDimensions;
+						const graphic = {
+							...graphicBase,
+							base64,
+							...resolved.originalBase64 ? { originalBase64: resolved.originalBase64 } : {},
+							...resolved.mime ? { mime: resolved.mime } : {},
+							...resolved.originalMime ? { originalMime: resolved.originalMime } : {},
+							...dimensions ? {
+								naturalWidth: dimensions.width,
+								naturalHeight: dimensions.height
+							} : {},
+							...resolveImageDisplaySize(alt, size, dimensions?.width, dimensions?.height)
+						};
+						pushTextSegments(out, alt, imageLinkStyle, graphic);
+					} else pushTextSegments(out, alt, imageLinkStyle);
+				} else pushTextSegments(out, alt, mergeStyle$1(inheritedStyle, theme.link));
 				break;
 			}
-			pushTextSegments(out, stringProp(node, "raw"), inheritedStyle);
-			break;
+			case "checkbox":
+			case "checkbox_input":
+				pushTextSegments(out, booleanProp(node, "checked") ? "[x]" : "[ ]", inheritedStyle);
+				break;
+			case "emoji":
+				pushTextSegments(out, stringProp(node, "markup") || stringProp(node, "name"), inheritedStyle);
+				break;
+			case "math_inline":
+				{
+					const source = stringProp(node, "content");
+					const raw = stringProp(node, "raw") || `$${source}$`;
+					const rendered = renderMarkdownInlineMathSegment(source);
+					pushTextSegments(out, rendered.supported ? rendered.text : raw, mergeStyle$1(inheritedStyle, theme.inlineCode), void 0, {
+						source,
+						raw,
+						rendered: rendered.supported
+					});
+				}
+				break;
+			case "reference":
+			case "footnote_reference":
+			case "footnote_anchor":
+				pushTextSegments(out, stringProp(node, "raw"), inheritedStyle);
+				break;
+			case "html_inline":
+				pushTextSegments(out, stringProp(node, "content"), mergeStyle$1(inheritedStyle, theme.html));
+				break;
+			case "html_block":
+				pushTextSegments(out, stringProp(node, "content"), mergeStyle$1(inheritedStyle, theme.html));
+				break;
+			default:
+				if (nodeChildren(node).length) {
+					out.push(...inlineNodeSegments(nodeChildren(node), theme, inheritedStyle, options));
+					break;
+				}
+				pushTextSegments(out, stringProp(node, "raw"), inheritedStyle);
+				break;
+		}
 	}
 	return out;
 }
@@ -2676,6 +2139,9 @@ const TVirtualMarkdown = defineComponent({
 		const unsubscribeGraphicsOutput = subscribeTerminalGraphicsOutput(terminal, () => {
 			graphicsOutputVersion.value = getTerminalGraphicsOutputVersion(terminal);
 		});
+		const unsubscribeMathRenderer = subscribeMarkdownMathRenderer(() => {
+			scheduleRebuild();
+		});
 		watch(() => `${props.streaming ? 1 : 0}:${(props.customHtmlTags ?? []).join("\0")}`, () => {
 			parser.value = markRaw(createTuiMarkdownParser({
 				streaming: props.streaming,
@@ -3043,6 +2509,7 @@ const TVirtualMarkdown = defineComponent({
 			alive = false;
 			rebuildVersion++;
 			unsubscribeGraphicsOutput();
+			unsubscribeMathRenderer();
 			clearMarkdownImageGraphics(terminal, fullRect.value);
 		});
 		useRenderNode(() => ({
@@ -3227,4 +2694,4 @@ function createMarkdownBlockSource(options) {
 }
 
 //#endregion
-export { TVirtualMarkdown, buildMarkdownBlocks, buildMarkdownVisualRows, canDrawTerminalGraphicRect, clearMarkdownImageGraphics, collectVisibleMarkdownImageGraphicIds, createIterm2InlineImageSequence, createKittyDeleteGraphicsSequence, createKittyGraphicsSequence, createKittyPlacementSequence, createMarkdownBlockSource, createTuiMarkdownParser, detectTerminalGraphicsCapabilities, findMarkdownImageActionAt, findMarkdownLinkActionAt, findMarkdownMathActionAt, getTerminalGraphicsOutput, getTerminalGraphicsOutputVersion, hashTerminalGraphicsString, isSafeMarkdownLink, isSafeTerminalGraphicsSequence, isTerminalGraphicsProtocol, layoutMarkdownBlocks, markdownThemeSignature, normalizeTerminalGraphicSize, paintMarkdownVisualRow, sanitizeTerminalFallbackText, stableTerminalGraphicNumericId, subscribeTerminalGraphicsOutput };
+export { TVirtualMarkdown, buildMarkdownBlocks, buildMarkdownVisualRows, clearMarkdownImageGraphics, collectVisibleMarkdownImageGraphicIds, createMarkdownBlockSource, createTuiMarkdownParser, findMarkdownImageActionAt, findMarkdownLinkActionAt, findMarkdownMathActionAt, isSafeMarkdownLink, layoutMarkdownBlocks, loadMarkdownMathRenderer, markdownThemeSignature, paintMarkdownVisualRow, subscribeMarkdownMathRenderer };