@simon_he/vue-tui 1.1.1 → 1.1.2

package/dist/cli.js

@@ -2382,10 +2382,8 @@ function createStdinDriver(options) {
 		if (stdout.isTTY) {
 			let restore = "\x1B[?2004l\x1B[?1004l";
 			if (keyboardProtocolSequences) restore += keyboardProtocolSequences.disable;
-			if (enableMouse) {
-				restore += "\x1B[?1007l";
-				restore += enableMouseMotion ? "\x1B[?1000l\x1B[?1003l\x1B[?1006l" : "\x1B[?1000l\x1B[?1002l\x1B[?1006l";
-			}
+			restore += "\x1B[?1007l";
+			restore += enableMouseMotion ? "\x1B[?1000l\x1B[?1003l\x1B[?1006l" : "\x1B[?1000l\x1B[?1002l\x1B[?1006l";
 			writeTTYSyncOrStream(stdout, restore);
 		}
 	};
@@ -2397,7 +2395,21 @@ function createStdinDriver(options) {
 			signalPolicy: typeof autoCleanup === "object" ? cleanupOptions.signalPolicy ?? "reraise" : "reraise"
 		});
 	}
-	return { dispose };
+	const setMouseCapture = (enabled) => {
+		if (disposed || !stdout.isTTY) return;
+		if (enabled) {
+			stdout.write("\x1B[?1007h");
+			if (enableMouseMotion) stdout.write("\x1B[?1000h\x1B[?1003h\x1B[?1006h");
+			else stdout.write("\x1B[?1000h\x1B[?1002h\x1B[?1006h");
+		} else {
+			stdout.write("\x1B[?1007l");
+			stdout.write(enableMouseMotion ? "\x1B[?1000l\x1B[?1003l\x1B[?1006l" : "\x1B[?1000l\x1B[?1002l\x1B[?1006l");
+		}
+	};
+	return {
+		dispose,
+		setMouseCapture
+	};
 }
 
 //#endregion
@@ -8181,6 +8193,7 @@ function createTerminalApp(options) {
 	});
 	const selectionTextProviders = new Map();
 	const selectionCopyHandlers = new Set();
+	const selectionConfig = shallowRef(options.selection ?? false);
 	const selectionContext = {
 		registerTextProvider(provider) {
 			selectionTextProviders.set(provider.id, provider);
@@ -8199,6 +8212,10 @@ function createTerminalApp(options) {
 		},
 		clear() {
 			selection.clear();
+		},
+		setConfig(config) {
+			selectionConfig.value = config;
+			selection.refresh();
 		}
 	};
 	const selectionOverlay = getPlaneTerminal(terminal, "overlay");
@@ -8216,7 +8233,7 @@ function createTerminalApp(options) {
 		getRow: (y) => readTerminalRowForPlanes(terminal, y, selectionReadPlanes),
 		getTextProviders: () => Array.from(selectionTextProviders.values()),
 		getOptions: () => {
-			const config = resolveSelectionConfig(options.selection);
+			const config = resolveSelectionConfig(selectionConfig.value);
 			return {
 				autoCopy: config.autoCopy,
 				copyOnMouseUp: config.copyOnMouseUp,
@@ -8461,6 +8478,8 @@ function createTerminalApp(options) {
 		events,
 		scheduler: ctx.scheduler,
 		defaultStyle: ctx.defaultStyle,
+		clipboard,
+		selection: selectionContext,
 		getImeAnchor() {
 			return imeAnchor.value;
 		},
@@ -10049,6 +10068,7 @@ function createStdoutRenderer(terminal, options) {
 	const pendingGraphicSignatures = new Map();
 	const activeGraphicSignatures = new Map();
 	const retainedGraphics = new Map();
+	const knownKittyImageIds = new Set();
 	const terminalResizeDirtyGraphics = new Set();
 	let nextGraphicsOrder = 0;
 	let terminalGraphicsFlushTimer = null;
@@ -10082,7 +10102,8 @@ function createStdoutRenderer(terminal, options) {
 			payload.h ?? "",
 			hashTerminalGraphicsString(payload.sequence),
 			hashTerminalGraphicsString(payload.resizeSequence ?? ""),
-			hashTerminalGraphicsString(payload.clearSequence ?? "")
+			hashTerminalGraphicsString(payload.clearSequence ?? ""),
+			payload.allowTextOverlay ? "1" : "0"
 		].join(":");
 	}
 	function kittyClearSequenceKeepsImageData(sequence) {
@@ -10131,6 +10152,21 @@ function createStdoutRenderer(terminal, options) {
 		if (imageId === "0" || placementId === "0") return null;
 		return `${imageId}:${placementId}`;
 	}
+	function kittyImageId(sequence) {
+		if (!sequence) return null;
+		const start = sequence.indexOf("\x1B_G");
+		if (start < 0) return null;
+		const end = sequence.indexOf("\x1B\\", start + 3);
+		if (end < 0) return null;
+		const body = sequence.slice(start + 3, end);
+		const controlsRaw = body.slice(0, body.indexOf(";") < 0 ? body.length : body.indexOf(";"));
+		for (const part of controlsRaw.split(",")) {
+			if (!part.startsWith("i=")) continue;
+			const imageId = Number(part.slice(2));
+			return Number.isInteger(imageId) && imageId > 0 ? imageId : null;
+		}
+		return null;
+	}
 	function canReplaceKittyPlacementWithoutClear(previous, payload) {
 		if (payload.terminalResizeRedraw) return false;
 		if (!payload.resizeRedraw || previous.protocol !== "kitty" || payload.protocol !== "kitty") return false;
@@ -10143,14 +10179,14 @@ function createStdoutRenderer(terminal, options) {
 			h: payload.h ?? previous.h
 		}));
 	}
-	function queueTerminalGraphicClear(id) {
+	function queueTerminalGraphicClear(id, options$1 = {}) {
 		if (disposed) return false;
 		const removedPendingDraw = pendingGraphics.delete(`${id}:draw`);
 		pendingGraphicSignatures.delete(id);
 		terminalResizeDirtyGraphics.delete(id);
 		const active = activeGraphics.get(id);
 		if (!active) {
-			retainedGraphics.delete(id);
+			if (!options$1.retainOnClear) retainedGraphics.delete(id);
 			return removedPendingDraw;
 		}
 		if (active.clearSequence) {
@@ -10162,6 +10198,7 @@ function createStdoutRenderer(terminal, options) {
 				h: active.h,
 				protocol: active.protocol,
 				sequence: active.clearSequence,
+				retainOnClear: options$1.retainOnClear,
 				op: "clear",
 				order: nextGraphicsOrder++
 			};
@@ -10184,6 +10221,69 @@ function createStdoutRenderer(terminal, options) {
 		requestTerminalGraphicsFlush();
 		return true;
 	}
+	function clearAllTerminalGraphics() {
+		if (disposed || graphicsCapabilities.preferredProtocol !== "kitty") return false;
+		const imageIds = new Set(knownKittyImageIds);
+		let needsVisibleFallback = false;
+		const rememberImageId = (...sequences) => {
+			for (const sequence of sequences) {
+				const imageId = kittyImageId(sequence);
+				if (imageId != null) {
+					imageIds.add(imageId);
+					return;
+				}
+			}
+			needsVisibleFallback = true;
+		};
+		for (const active of activeGraphics.values()) rememberImageId(active.sequence, active.resizeSequence, active.clearSequence);
+		for (const retained of retainedGraphics.values()) rememberImageId(retained.active.sequence, retained.active.resizeSequence, retained.active.clearSequence);
+		for (const 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();
+		for (const imageId of imageIds) {
+			const payload = {
+				id: `__terminal_graphics_clear_image_${imageId}__`,
+				x: 0,
+				y: 0,
+				w: 1,
+				h: 1,
+				protocol: "kitty",
+				sequence: createKittyDeleteGraphicsSequence({
+					imageId,
+					freeImageData: true
+				}),
+				op: "clear",
+				order: nextGraphicsOrder++
+			};
+			if (validateTerminalGraphicsPayload(payload, graphicsCapabilities)) pendingGraphics.set(`${payload.id}:clear`, payload);
+		}
+		if (needsVisibleFallback) {
+			const payload = {
+				id: "__terminal_graphics_clear_visible__",
+				x: 0,
+				y: 0,
+				w: 1,
+				h: 1,
+				protocol: "kitty",
+				sequence: createKittyDeleteGraphicsSequence({
+					allVisible: true,
+					freeImageData: true
+				}),
+				op: "clear",
+				order: nextGraphicsOrder++
+			};
+			if (validateTerminalGraphicsPayload(payload, graphicsCapabilities)) pendingGraphics.set(`${payload.id}:clear`, payload);
+		}
+		if (pendingGraphics.size === 0) return false;
+		requestTerminalGraphicsFlush();
+		return true;
+	}
 	function queueTerminalGraphicsForResizeRedraw(size) {
 		if (isDebugEnabled()) getDebugLog().render(`graphics resize redraw queue: size=${size.cols}x${size.rows}, activeGraphics=${activeGraphics.size}, pendingGraphics=${pendingGraphics.size}, pendingClears=${pendingGraphicClears.size}`);
 		for (const [id, active] of activeGraphics) {
@@ -10195,7 +10295,7 @@ function createStdoutRenderer(terminal, options) {
 				continue;
 			}
 			const signature = activeGraphicSignatures.get(id);
-			const sequence = active.resizeSequence ?? active.sequence;
+			const sequence = active.sequence;
 			pendingGraphics.set(`${id}:draw`, {
 				id,
 				x: active.x,
@@ -10206,6 +10306,7 @@ function createStdoutRenderer(terminal, options) {
 				sequence,
 				resizeSequence: active.resizeSequence,
 				clearSequence: active.clearSequence,
+				allowTextOverlay: active.allowTextOverlay,
 				op: "draw",
 				order: nextGraphicsOrder++,
 				resizeRedraw: true,
@@ -10230,9 +10331,10 @@ function createStdoutRenderer(terminal, options) {
 				w: active.w,
 				h: active.h,
 				protocol: active.protocol,
-				sequence: active.resizeSequence ?? active.sequence,
+				sequence: active.sequence,
 				resizeSequence: active.resizeSequence,
 				clearSequence: active.clearSequence,
+				allowTextOverlay: active.allowTextOverlay,
 				op: "draw",
 				order: nextGraphicsOrder++,
 				resizeRedraw: true,
@@ -10275,6 +10377,8 @@ function createStdoutRenderer(terminal, options) {
 					height: normalized.h ?? 1
 				});
 				if (!frame) return false;
+				const imageId = kittyImageId(frame.sequence) ?? kittyImageId(normalized.resizeSequence);
+				if (imageId != null) knownKittyImageIds.add(imageId);
 				if (isDebugEnabled()) {
 					const size = terminal.size();
 					getDebugLog().render(`terminal graphic queue draw request: id=${frame.id}, x=${normalized.x}, y=${normalized.y}, w=${frame.width}, h=${frame.height}, viewport=${size.cols}x${size.rows}`);
@@ -10289,7 +10393,7 @@ function createStdoutRenderer(terminal, options) {
 						const size = terminal.size();
 						getDebugLog().render(`terminal graphic queue draw rejected offscreen: id=${frame.id}, x=${normalized.x}, y=${normalized.y}, w=${frame.width}, h=${frame.height}, viewport=${size.cols}x${size.rows}`);
 					}
-					queueTerminalGraphicClear(frame.id);
+					queueTerminalGraphicClear(frame.id, { retainOnClear: normalized.retainOnClear });
 					return false;
 				}
 				const clearSequence = normalized.clearSequence && isSafeTerminalGraphicsSequence(normalized.clearSequence, normalized.protocol, "clear") ? normalized.clearSequence : void 0;
@@ -10325,8 +10429,44 @@ function createStdoutRenderer(terminal, options) {
 					if (isDebugEnabled()) getDebugLog().render(`terminal graphic queue draw canceled clear: id=${frame.id}, x=${normalized.x}, y=${normalized.y}, w=${frame.width}, h=${frame.height}`);
 					return true;
 				}
+				const active = activeGraphics.get(frame.id);
+				const activeCanReplacePlacement = active && active.sequence === frame.sequence && resizeSequence && canReplaceKittyPlacementWithoutClear(active, {
+					...normalized,
+					id: frame.id,
+					w: frame.width,
+					h: frame.height,
+					sequence: resizeSequence,
+					resizeSequence,
+					clearSequence,
+					fallbackText: frame.fallbackText,
+					resizeRedraw: true,
+					placementMoveWithoutClear: true
+				});
+				if (!forceTerminalResizeRedraw && !normalized.forceDraw && !normalized.resizeRedraw && activeCanReplacePlacement && resizeSequence) {
+					pendingGraphics.set(`${frame.id}:draw`, {
+						...normalized,
+						id: frame.id,
+						w: frame.width,
+						h: frame.height,
+						sequence: resizeSequence,
+						resizeSequence,
+						clearSequence,
+						fallbackText: frame.fallbackText,
+						resizeRedraw: true,
+						placementMoveWithoutClear: false
+					});
+					pendingGraphicSignatures.set(frame.id, signature);
+					recordTerminalGraphicTrace({
+						type: "queue",
+						id: frame.id,
+						protocol: normalized.protocol,
+						bytes: resizeSequence.length
+					});
+					requestTerminalGraphicsFlush(Boolean(normalized.deferFlush));
+					return true;
+				}
 				const retained = retainedGraphics.get(frame.id);
-				const retainedCanReplacePlacement = retained && resizeSequence && canReplaceKittyPlacementWithoutClear(retained.active, {
+				const retainedCanReplacePlacement = retained && retained.active.sequence === frame.sequence && resizeSequence && canReplaceKittyPlacementWithoutClear(retained.active, {
 					...normalized,
 					id: frame.id,
 					w: frame.width,
@@ -10347,12 +10487,12 @@ function createStdoutRenderer(terminal, options) {
 						id: frame.id,
 						w: frame.width,
 						h: frame.height,
-						sequence: resizeSequence,
+						sequence: forceTerminalResizeRedraw ? frame.sequence : resizeSequence,
 						resizeSequence,
 						clearSequence,
 						fallbackText: frame.fallbackText,
 						resizeRedraw: true,
-						placementMoveWithoutClear: true,
+						placementMoveWithoutClear: false,
 						terminalResizeRedraw: forceTerminalResizeRedraw
 					});
 					pendingGraphicSignatures.set(frame.id, signature);
@@ -10409,6 +10549,9 @@ function createStdoutRenderer(terminal, options) {
 		},
 		clear(id) {
 			return queueTerminalGraphicClear(id);
+		},
+		clearAll() {
+			return clearAllTerminalGraphics();
 		}
 	};
 	const unregisterGraphicsOutput = registerTerminalGraphicsOutput(terminal, graphicsOutput);
@@ -11508,6 +11651,7 @@ function createStdoutRenderer(terminal, options) {
 				sequence: active.sequence,
 				resizeSequence: active.resizeSequence,
 				clearSequence: active.clearSequence,
+				allowTextOverlay: active.allowTextOverlay,
 				op: "draw",
 				order: nextGraphicsOrder++
 			});
@@ -11518,7 +11662,7 @@ function createStdoutRenderer(terminal, options) {
 			if (explicitGraphicClears.has(id)) continue;
 			if (pendingGraphicIds.has(id)) continue;
 			if (intersectsScrollOperations(active)) continue;
-			addTerminalGraphicTextPreserveSpans(active);
+			if (!active.allowTextOverlay) addTerminalGraphicTextPreserveSpans(active);
 		}
 		if ((normalizedScrollOperations === null || normalizedScrollOperations === void 0 ? void 0 : normalizedScrollOperations.length) && activeGraphics.size > 0) for (const active of activeGraphics.values()) {
 			if (!intersectsScrollOperations(active)) continue;
@@ -12224,22 +12368,6 @@ function createStdoutRenderer(terminal, options) {
 			}
 			return out$1;
 		};
-		const clearGraphicRowBackgroundForRowsNotPainted = (rect) => {
-			if (scrollHandled) return "";
-			const clearStyle = bgSeq;
-			let out$1 = "";
-			const leftW = Math.max(0, Math.min(size.cols, rect.x));
-			const rightX = Math.max(0, Math.min(size.cols, rect.x + rect.w));
-			const rightW = Math.max(0, size.cols - rightX);
-			if (leftW <= 0 && rightW <= 0) return "";
-			for (let row = 0; row < rect.h; row++) {
-				const y = rect.y + row;
-				if (!rowsToRender || rowWasPaintedByTextRenderer(y)) continue;
-				if (leftW > 0) out$1 += `\u001B[${y + 1};1H${clearStyle}\u001B[${leftW}X${SGR_RESET}`;
-				if (rightW > 0) out$1 += `\u001B[${y + 1};${rightX + 1}H${clearStyle}\u001B[${rightW}X${SGR_RESET}`;
-			}
-			return out$1;
-		};
 		let commitTerminalGraphicsState = null;
 		let restoreTerminalGraphicsAfterWriteFailure = null;
 		let terminalGraphicsMetrics = null;
@@ -12388,6 +12516,7 @@ function createStdoutRenderer(terminal, options) {
 				const previousSignature = previous ? nextActiveGraphicSignatures.get(payload.id) : void 0;
 				const nextSignature = nextPendingGraphicSignatures.get(payload.id) ?? terminalGraphicsPayloadSignature(payload);
 				const canReplacePlacement = previous != null && payload.resizeRedraw && canReplaceKittyPlacementWithoutClear(previous, payload);
+				const terminalResizePlacementOnly = previous != null && payload.terminalResizeRedraw && payload.resizeSequence != null && previous.sequence === payload.sequence;
 				const resizeRedrawNeedsClear = previous && (payload.resizeRedraw || payload.terminalResizeRedraw) && Boolean(previous.clearSequence) && !canReplacePlacement;
 				if (previous && (!canReplacePlacement && (previousSignature !== nextSignature || !sameGraphicRect(previous, rect)) || resizeRedrawNeedsClear)) {
 					const visiblePrevious = clipGraphicRectToViewport(previous, size);
@@ -12405,18 +12534,18 @@ function createStdoutRenderer(terminal, options) {
 				const visibleRect = clipGraphicRectToViewport(rect, size);
 				if (isDebugEnabled()) getDebugLog().render(`terminal graphic render draw: id=${payload.id}, x=${rect.x}, y=${rect.y}, w=${rect.w}, h=${rect.h}, visible=${visibleRect ? `${visibleRect.x},${visibleRect.y},${visibleRect.w},${visibleRect.h}` : "none"}, resizeRedraw=${payload.resizeRedraw || payload.terminalResizeRedraw ? "true" : "false"}, previous=${previous ? `${previous.x},${previous.y},${previous.w},${previous.h}` : "none"}`);
 				const clearRect$1 = visibleRect ? clearGraphicRectForRowsNotPainted(visibleRect) : "";
-				const clearRowBackground = visibleRect ? clearGraphicRowBackgroundForRowsNotPainted(visibleRect) : "";
 				const cursor = `\u001B[${rect.y + 1};${rect.x + 1}H`;
-				const sequencePayload = (canReplacePlacement || payload.terminalResizeRedraw) && payload.resizeSequence ? payload.resizeSequence : payload.sequence;
+				const sequencePayload = (canReplacePlacement || terminalResizePlacementOnly) && payload.resizeSequence ? payload.resizeSequence : payload.sequence;
 				const sequence = maybeWrapTerminalGraphic(sequencePayload);
-				frameParts.push(countGraphicsBytes(cursor), countGraphicsBytes(sequence), countGraphicsBytes(SGR_RESET), clearRowBackground ? countGraphicsBytes(clearRowBackground) : "", clearRect$1 ? countGraphicsBytes(clearRect$1) : "");
+				frameParts.push(countGraphicsBytes(cursor), countGraphicsBytes(sequence), countGraphicsBytes(SGR_RESET), clearRect$1 ? countGraphicsBytes(clearRect$1) : "");
 				terminalGraphicsDraws++;
 				nextActiveGraphics.set(payload.id, {
 					...rect,
 					protocol: payload.protocol,
-					sequence: payload.sequence,
+					sequence: previous && (canReplacePlacement || terminalResizePlacementOnly) ? previous.sequence : payload.sequence,
 					resizeSequence: payload.resizeSequence ?? (previous === null || previous === void 0 ? void 0 : previous.resizeSequence),
-					clearSequence: payload.clearSequence
+					clearSequence: payload.clearSequence,
+					allowTextOverlay: payload.allowTextOverlay ?? (previous === null || previous === void 0 ? void 0 : previous.allowTextOverlay)
 				});
 				nextActiveGraphicSignatures.set(payload.id, nextSignature);
 				nextPendingGraphicSignatures.delete(payload.id);
@@ -13024,6 +13153,7 @@ function createStdoutRenderer(terminal, options) {
 		pendingGraphicClears.clear();
 		pendingGraphicSignatures.clear();
 		retainedGraphics.clear();
+		knownKittyImageIds.clear();
 		terminalResizeDirtyGraphics.clear();
 		try {
 			if (activeGraphics.size > 0) {

package/dist/core.js

@@ -1,10 +1,9 @@
-import { TERMINAL_RENDER_PLANES, createTerminal } from "./create-terminal-DXuZ2fci.js";
+import { TERMINAL_RENDER_PLANES, createTerminal, isSafeRelativeHref, parseAnsiSgr, sanitizeDomHref, sanitizeTerminalHref } from "./hyperlink-_1FAj7Wq.js";
 import { charCellWidth } from "./width-GqllnV8C.js";
-import { isSafeRelativeHref, parseAnsiSgr, sanitizeDomHref, sanitizeTerminalHref } from "./hyperlink-B35-O-cW.js";
-import { ansiColorRgb } from "./ansi-palette-CNXqFciC.js";
-import { firstNonEmptyEnv } from "./env-DNCzvX8b.js";
-import { normalizeNewlines } from "./path-BI9W15Zt.js";
-import { parsePathQuery, resolveUserPath, suggestParentHint, suggestPaths } from "./path-suggest-fPzRsgPv.js";
+import { ansiColorRgb } from "./ansi-palette-CH6jc2Z7.js";
+import { firstNonEmptyEnv } from "./env-Cl8qmNFN.js";
+import { normalizeNewlines } from "./path-mnSgEpCm.js";
+import { parsePathQuery, resolveUserPath, suggestParentHint, suggestPaths } from "./path-suggest-Dndu4dTi.js";
 
 //#region src/core/ansi/colors.ts
 const ANSI8_COLOR_NAMES = Object.freeze([

package/dist/create-terminal-app.d.ts

@@ -5,15 +5,38 @@ import type { Style, Terminal } from "./core/types.js";
 import type { CliEventManager } from "./events/index.js";
 import type { ClipboardApi } from "./runtime/index.js";
 import type { TerminalLinkOpenerLike } from "./vue/components/link/host.js";
-import type { TerminalSelectionConfig, TerminalSelectionCopyPayload } from "./selection/terminal-selection.js";
+import type { SelectionTextProvider, TerminalSelectionConfig, TerminalSelectionCopyPayload, TerminalSelectionRefreshOptions } from "./selection/terminal-selection.js";
 import type { TInputPlugin } from "./vue/components/input/plugins/types.js";
 import type { ImeAnchor, TerminalScheduler } from "./vue/context.js";
+export type TerminalSelectionContext = Readonly<{
+    registerTextProvider(provider: SelectionTextProvider): () => void;
+    onCopy(handler: (payload: TerminalSelectionCopyPayload) => void): () => void;
+    refresh(options?: TerminalSelectionRefreshOptions): void;
+    clear(): void;
+    /**
+     * Update the selection copy strategy at runtime. Only `autoCopy`,
+     * `copyOnMouseUp`, and `style` take effect dynamically — `enabled` is
+     * resolved at app creation time (it gates overlay node registration and
+     * the pointer-event selection path) and cannot be toggled afterwards.
+     * Triggers a refresh so the new options apply immediately.
+     *
+     * This does NOT toggle mouse capture — that is owned by the stdin driver
+     * layer. To let the terminal perform native selection, disable mouse
+     * capture at stdin-driver startup time, or rely on the terminal's
+     * Shift+drag escape hatch.
+     */
+    setConfig(config: TerminalSelectionConfig): void;
+}>;
 export type TerminalApp = Readonly<{
     app: App;
     terminal: Terminal;
     events: CliEventManager;
     scheduler: TerminalScheduler;
     defaultStyle: Ref<Style>;
+    /** The active clipboard instance used by selection copy and exposed for upper-layer copy actions. */
+    clipboard: ClipboardApi;
+    /** Selection controller surface: register text providers, observe copy events, refresh/clear. */
+    selection: TerminalSelectionContext;
     /** Returns the current IME anchor position (cursor position in cell coordinates), or null if no input is focused */
     getImeAnchor: () => ImeAnchor | null;
     mount: () => void;

package/dist/{debug-logger-ChY_PXVk.js → debug-logger-CmsGI4of.js}

@@ -1,4 +1,4 @@
-import { envFlag, envString } from "./env-DNCzvX8b.js";
+import { envFlag, envString } from "./env-Cl8qmNFN.js";
 
 //#region src/core/debug-logger.ts
 const DEFAULT_LOG_FILE = "vue-tui-debug.log";

package/dist/{dom-renderer-DNzmg2As.js → dom-renderer-DXx8fWzD.js}

@@ -1,6 +1,5 @@
-import { TERMINAL_RENDER_PLANES, getPlaneTerminal } from "./create-terminal-DXuZ2fci.js";
-import { sanitizeDomHref } from "./hyperlink-B35-O-cW.js";
-import { ansiColorHex, ansiCssVar, installAnsiPaletteCssVars, isAnsiColorName } from "./ansi-palette-CNXqFciC.js";
+import { TERMINAL_RENDER_PLANES, getPlaneTerminal, sanitizeDomHref } from "./hyperlink-_1FAj7Wq.js";
+import { ansiColorHex, ansiCssVar, installAnsiPaletteCssVars, isAnsiColorName } from "./ansi-palette-CH6jc2Z7.js";
 
 //#region src/renderer/capabilities.ts
 const DOM_RENDERER_CAPABILITIES = Object.freeze({

package/dist/experimental/3d/bun/contributor-avatar-atlas.d.ts

@@ -0,0 +1,12 @@
+/**
+ * Fixed, offline 32px avatar atlas for the top 100 human Vue core contributors.
+ * Ordered by the GitHub contributors API response after filtering bot accounts.
+ * Source: https://github.com/vuejs/core/graphs/contributors
+ * Avatars: https://avatars.githubusercontent.com (retrieved 2026-07-24).
+ */
+export declare const contributorAvatarLogins: readonly ["yyx990803", "edison1105", "sxzz", "HcySunYang", "pikax", "underfin", "Alfred-Skyblue", "jh-leong", "cexbrayat", "LinusBorg", "skirtles-code", "baiwusanyu-c", "dsseng", "haoqunjiang", "KazariEX", "linzhe141", "posva", "yangmingshan", "btea", "yangxiuxiu1115", "Akryum", "webfansplz", "zhangenming", "zhangzhonghe", "johnsoncodehk", "antfu", "a631807682", "jiangying000", "liulinboyi", "Doctor-wu", "ygj6", "unbyte", "himself65", "shengxinjing", "fisker", "danielroe", "CyberAP", "loiacon", "HerringtonDarkholme", "znck", "caozhong1996", "OnlyWick", "Picknight", "hareku", "zh-lx", "CodinCat", "godxiaoji", "lidlanca", "meteorlxy", "rudyxu1102", "wsypower", "basvanmeurs", "liuseen-l", "alex-snezhko", "fnlctrl", "CodeDaraW", "rzzf", "ztplz", "zqran", "Bigfish8", "Mini-ghost", "zzzzzhowie", "Amour1688", "zhiyuanzmj", "ysj16", "TerenceZ", "shadowings-zy", "inottn", "Rudeus3Greyrat", "KaelWD", "theniceangel", "JayFate", "xanf", "Justineo", "zhmushan", "susiwen8", "jods4", "ifer47", "chenfan0", "Zardddddd60", "jo0ger", "dsonet", "69hunter", "DV8FromTheWorld", "AjaiKN", "nandi95", "PengBoUESTC", "Notryag", "wonderful-panda", "wxsms", "yyyanghj", "javastation", "dlxqlig", "leaon4", "LongTengDao", "iiio2", "serkodev", "cuixiaorui", "sudongyuer", "hyfdev"];
+export declare const contributorAvatarAtlas: {
+    readonly width: 512;
+    readonly height: 224;
+    readonly rgba: Uint8Array<ArrayBufferLike>;
+};

package/dist/experimental/3d/bun/png.d.ts

@@ -0,0 +1 @@
+export declare function encodeRgbaPng(rgba: Uint8Array, width: number, height: number): Uint8Array;

package/dist/experimental/3d/bun/terminal-badge-scene.d.ts

@@ -0,0 +1,11 @@
+import type { T3DHitResult, T3DHitTestContext } from "../../../vue/components/T3DViewport.js";
+export declare const TERMINAL_BADGE_CONTRIBUTOR_COUNT = 100;
+export declare const terminalBadgeContributorRadiusScales: readonly number[];
+export type TerminalBadgeContributorSphere = Readonly<{
+    x: number;
+    y: number;
+    z: number;
+    radius: number;
+}>;
+export declare const terminalBadgeContributorSpheres: readonly TerminalBadgeContributorSphere[];
+export declare function pickTerminalBadgeContributor(context: T3DHitTestContext): T3DHitResult | null;

package/dist/experimental/3d/bun/terminal-badge.wgsl.d.ts

@@ -0,0 +1 @@
+export declare const terminalBadge3DWgsl: string;

package/dist/experimental/3d/bun/webgpu-renderer.d.ts

@@ -0,0 +1,26 @@
+import type { T3DRenderer } from "../../../vue/components/T3DViewport.js";
+export type BunWebGPUTextureData = Readonly<{
+    /** Texture width in pixels. */
+    width: number;
+    /** Texture height in pixels. */
+    height: number;
+    /** Tightly packed RGBA8 pixels, ordered from top-left to bottom-right. */
+    rgba: Uint8Array;
+}>;
+export type BunWebGPU3DRendererOptions = Readonly<{
+    /** Compute shader with the T3D uniform block at binding 0 and RGBA8 storage output at binding 1. */
+    shader: string;
+    /** Optional RGBA8 sampled texture exposed to the shader at binding 2. */
+    texture?: BunWebGPUTextureData;
+    /** Label included in WebGPU resources and error messages. */
+    label?: string;
+}>;
+export type TerminalBadge3DRendererOptions = Readonly<{
+    /** Label included in WebGPU resources and error messages. */
+    label?: string;
+}>;
+export declare function rgbaToGray8(rgba: Uint8Array): Uint8Array;
+/** Creates a Bun-only Pull renderer backed by a raw WGSL compute shader. */
+export declare function createBunWebGPU3DRenderer(options: BunWebGPU3DRendererOptions): T3DRenderer;
+/** Creates the direction-E vue-tui terminal badge renderer. */
+export declare function createTerminalBadge3DRenderer(options?: TerminalBadge3DRendererOptions): T3DRenderer;