niuma-ui 2.0.4 → 2.1.0

package/dist/components/terminal/src/RsTerminal.impl.js

@@ -3,17 +3,28 @@ import RsLoading_default from "../../loading/src/RsLoading.js";
 import RsContextMenu_default from "../../context-menu/src/RsContextMenu.js";
 import { beginClipboardPrefetch, copyTextToClipboard, readClipboardText } from "../../../utils/rs-clipboard.js";
 import { readTerminalFontFamily, readTerminalFontSizePx, readTerminalFontWeight, readTerminalFontWeightBold } from "../../../theme/css-token.js";
-import { mergeTerminalTheme, needsPtyWriteViewportPrep, prepareTerminalForPtyWrite, proposeTerminalGeometry, readXtermCssCellSize, resolveTerminalTheme, terminalShortcutLabel } from "./terminal-utils.js";
+import { findTerminalHttpLinks, isSafeTerminalLink, mergeTerminalTheme, needsPtyWriteViewportPrep, prepareTerminalForPtyWrite, proposeTerminalGeometry, readXtermCssCellSize, resolveTerminalTheme, subscribeTerminalTheme, terminalLinkCellRange, terminalShortcutLabel } from "./terminal-utils.js";
 import { attachWheelScrollGuard, isAlternateTerminalBuffer } from "./terminal-wheel.js";
-import { computed, createBlock, createCommentVNode, createElementBlock, createElementVNode, defineComponent, mergeProps, nextTick, normalizeClass, onBeforeUnmount, onMounted, openBlock, ref, renderSlot, toDisplayString, unref, vModelText, watch, withCtx, withDirectives, withModifiers } from "vue";
+import { computed, createBlock, createCommentVNode, createElementBlock, createElementVNode, defineComponent, mergeProps, nextTick, normalizeClass, onBeforeUnmount, onMounted, openBlock, ref, renderSlot, toDisplayString, unref, useId, vModelText, watch, withCtx, withDirectives, withModifiers } from "vue";
 import { FitAddon } from "@xterm/addon-fit";
 import { SearchAddon } from "@xterm/addon-search";
 import { Terminal } from "@xterm/xterm";
 import "@xterm/xterm/css/xterm.css";
 //#region src/components/terminal/src/RsTerminal.vue?vue&type=script&setup=true&lang.ts
-var _hoisted_1 = ["placeholder", "aria-label"];
-var _hoisted_2 = { key: 0 };
-var _hoisted_3 = {
+var _hoisted_1 = [
+	"id",
+	"aria-label",
+	"aria-busy",
+	"aria-readonly"
+];
+var _hoisted_2 = [
+	"placeholder",
+	"aria-label",
+	"aria-describedby"
+];
+var _hoisted_3 = ["id"];
+var _hoisted_4 = { key: 0 };
+var _hoisted_5 = {
 	key: 1,
 	class: "rs-terminal__overlay-action"
 };
@@ -22,6 +33,7 @@ var TERMINAL_LINE_HEIGHT = 1.2;
 /** 令牌缺省字号；仅在挂载前（含 SSR）占位，挂载后由 syncResolvedFontSize 换成实测值。 */
 var FALLBACK_FONT_SIZE_PX = 14;
 var RsTerminal_vue_vue_type_script_setup_true_lang_default = /*@__PURE__*/ defineComponent({
+	name: "RsTerminal",
 	inheritAttrs: false,
 	__name: "RsTerminal",
 	props: {
@@ -87,6 +99,21 @@ var RsTerminal_vue_vue_type_script_setup_true_lang_default = /*@__PURE__*/ defin
 			type: Boolean,
 			default: false
 		},
+		cursorStyle: { default: "block" },
+		screenReaderMode: {
+			type: Boolean,
+			default: false
+		},
+		openLinks: {
+			type: Boolean,
+			default: true
+		},
+		rescaleOverlappingGlyphs: {
+			type: Boolean,
+			default: true
+		},
+		ariaLabel: {},
+		id: {},
 		minimumContrastRatio: { default: 4.5 }
 	},
 	emits: [
@@ -96,17 +123,24 @@ var RsTerminal_vue_vue_type_script_setup_true_lang_default = /*@__PURE__*/ defin
 		"action",
 		"askAi",
 		"selectionChange",
-		"extraSelect"
+		"extraSelect",
+		"titleChange",
+		"bell",
+		"link"
 	],
 	setup(__props, { expose: __expose, emit: __emit }) {
 		const props = __props;
 		const emit = __emit;
 		const { t } = useRsI18n();
 		const hostEl = ref(null);
+		const regionLabel = computed(() => props.ariaLabel || t("terminal.label", "Terminal"));
 		const terminalReady = ref(false);
 		const hasSelection = ref(false);
-		/** 右键菜单打开瞬间的选区快照（capture 阶段，早于 xterm word-select） */
-		const menuSelectionSnapshot = ref("");
+		/**
+		* 右键打开前的选区文本。不用 ref：菜单禁用只看 hasSelection，
+		* 避免大段文本写回响应式数据时把菜单再排一次。
+		*/
+		let menuSelectionText = "";
 		const resolvedThemeMode = ref(resolveTerminalTheme(props.themeMode));
 		/** fit 后量一次真实行高，避免亚像素漂移；非每帧更新 */
 		const zebraRowStepPx = ref(null);
@@ -148,13 +182,14 @@ var RsTerminal_vue_vue_type_script_setup_true_lang_default = /*@__PURE__*/ defin
 					label: t("terminal.copy", "Copy"),
 					icon: "copy",
 					shortcut: terminalShortcutLabel("C"),
-					disabled: false
+					disabled: !hasSelection.value
 				},
 				{
 					key: "paste",
 					label: t("terminal.paste", "Paste"),
 					icon: "clipboard-paste",
-					shortcut: terminalShortcutLabel("V")
+					shortcut: terminalShortcutLabel("V"),
+					disabled: !props.inputEnabled
 				},
 				{
 					key: "selectAll",
@@ -177,7 +212,7 @@ var RsTerminal_vue_vue_type_script_setup_true_lang_default = /*@__PURE__*/ defin
 				key: "askAi",
 				label: t("terminal.askAi", "Ask AI"),
 				icon: "bot",
-				disabled: !hasSelection.value && !menuSelectionSnapshot.value
+				disabled: !hasSelection.value
 			});
 			if (props.extraContextMenuItems?.length) items.push({
 				key: "sep-extra",
@@ -199,24 +234,53 @@ var RsTerminal_vue_vue_type_script_setup_true_lang_default = /*@__PURE__*/ defin
 		});
 		const searchOpen = ref(false);
 		const searchQuery = ref("");
+		const searchStatus = ref("");
 		const searchInputEl = ref(null);
+		const searchStatusId = useId();
 		let terminal = null;
 		let fitAddon = null;
 		let searchAddon = null;
 		let resizeObserver = null;
-		let themeObserver = null;
+		let unsubscribeTheme = null;
 		let detachWheelGuard = null;
+		let dataDisposable = null;
+		let selectionDisposable = null;
+		let titleDisposable = null;
+		let bellDisposable = null;
+		let linkDisposable = null;
+		let motionMedia = null;
 		let lastGeometry = {
 			cols: 0,
 			rows: 0
 		};
 		let fitRaf = 0;
+		let selectionFrame = 0;
 		let didInitialFit = false;
+		let alive = true;
 		function resolveAllowTransparency() {
 			return props.allowTransparency || props.zebraStripes;
 		}
 		function buildXtermTheme() {
-			return mergeTerminalTheme(resolvedThemeMode.value, props.theme);
+			return mergeTerminalTheme(resolvedThemeMode.value, props.theme, hostEl.value);
+		}
+		function prefersReducedMotion() {
+			if (typeof window === "undefined" || typeof window.matchMedia !== "function") return false;
+			return window.matchMedia("(prefers-reduced-motion: reduce)").matches;
+		}
+		function syncCursorBlink() {
+			if (!terminal) return;
+			terminal.options.cursorBlink = props.cursorBlink && !prefersReducedMotion();
+		}
+		function onMotionPreference() {
+			syncCursorBlink();
+		}
+		function syncInputEnabled() {
+			if (!terminal) return;
+			terminal.options.disableStdin = !props.inputEnabled;
+		}
+		function labelTerminalInput() {
+			const textarea = hostEl.value?.querySelector("textarea");
+			if (textarea instanceof HTMLTextAreaElement) textarea.setAttribute("aria-label", regionLabel.value);
 		}
 		function applyThemeToTerminal() {
 			if (!terminal) return;
@@ -242,7 +306,7 @@ var RsTerminal_vue_vue_type_script_setup_true_lang_default = /*@__PURE__*/ defin
 			});
 		}
 		function refreshResolvedTheme() {
-			resolvedThemeMode.value = resolveTerminalTheme(props.themeMode);
+			resolvedThemeMode.value = resolveTerminalTheme(props.themeMode, hostEl.value);
 			applyThemeToTerminal();
 		}
 		function currentGeometry() {
@@ -265,7 +329,7 @@ var RsTerminal_vue_vue_type_script_setup_true_lang_default = /*@__PURE__*/ defin
 			emit("resize", geometry);
 		}
 		async function fit() {
-			if (!fitAddon || !terminal || !hostEl.value) return;
+			if (!alive || !fitAddon || !terminal || !hostEl.value) return;
 			const { clientWidth, clientHeight } = hostEl.value;
 			if (clientWidth <= 0 || clientHeight <= 0) return;
 			if (!didInitialFit) {
@@ -273,7 +337,7 @@ var RsTerminal_vue_vue_type_script_setup_true_lang_default = /*@__PURE__*/ defin
 				await nextTick();
 				await rafTwice();
 			}
-			if (!fitAddon || !terminal) return;
+			if (!alive || !fitAddon || !terminal || !hostEl.value) return;
 			try {
 				fitAddon.fit();
 			} catch {}
@@ -308,9 +372,10 @@ var RsTerminal_vue_vue_type_script_setup_true_lang_default = /*@__PURE__*/ defin
 			if (nextRows < terminal.rows) terminal.resize(terminal.cols, nextRows);
 		}
 		function scheduleFit() {
-			if (fitRaf) return;
+			if (!alive || fitRaf) return;
 			fitRaf = requestAnimationFrame(() => {
 				fitRaf = 0;
+				if (!alive) return;
 				fit();
 			});
 		}
@@ -332,37 +397,61 @@ var RsTerminal_vue_vue_type_script_setup_true_lang_default = /*@__PURE__*/ defin
 			return String(terminal?.getSelection?.() ?? "");
 		}
 		function syncSelectionState() {
-			hasSelection.value = Boolean(terminal?.hasSelection());
-			emit("selectionChange", getSelectionText());
+			const text = getSelectionText();
+			const selected = Boolean(terminal?.hasSelection());
+			if (hasSelection.value !== selected) hasSelection.value = selected;
+			menuSelectionText = selected ? text.trim() : "";
+			emit("selectionChange", text);
+		}
+		/** 选区文本留到下一帧再序列化，右键和松开鼠标先把画面画完。 */
+		function scheduleSelectionText() {
+			if (selectionFrame) return;
+			selectionFrame = requestAnimationFrame(() => {
+				selectionFrame = 0;
+				if (!alive) return;
+				syncSelectionState();
+			});
 		}
-		/** 优先活选区；若被右键 word-select / 失焦冲掉，则回退菜单快照。 */
+		/** 优先活选区；菜单抢走焦点后回退打开时记下的文本。 */
 		function resolveMenuSelectionText() {
 			const live = getSelectionText().trim();
-			const snap = menuSelectionSnapshot.value.trim();
-			if (live && (!snap || live.length >= snap.length)) return live;
-			return snap;
+			if (live) return live;
+			return menuSelectionText;
+		}
+		function ensureSearchAddon() {
+			if (!terminal || !props.searchEnabled) return null;
+			if (!searchAddon) {
+				searchAddon = new SearchAddon();
+				terminal.loadAddon(searchAddon);
+			}
+			return searchAddon;
 		}
 		function openSearch() {
-			if (!props.searchEnabled) return;
+			if (!props.searchEnabled || !alive) return;
+			ensureSearchAddon();
 			searchOpen.value = true;
+			searchStatus.value = "";
 			nextTick(() => {
+				if (!alive) return;
 				searchInputEl.value?.focus();
 				searchInputEl.value?.select();
 			});
 		}
 		function closeSearch() {
 			searchOpen.value = false;
+			searchStatus.value = "";
 			searchAddon?.clearDecorations();
-			terminal?.focus();
+			if (alive) terminal?.focus();
 		}
 		function runSearch(direction) {
 			const query = searchQuery.value;
-			if (!query || !searchAddon) return;
-			if (direction === "prev") {
-				searchAddon.findPrevious(query);
+			const addon = ensureSearchAddon();
+			if (!query || !addon) {
+				searchStatus.value = "";
 				return;
 			}
-			searchAddon.findNext(query);
+			const found = direction === "prev" ? addon.findPrevious(query) : addon.findNext(query);
+			searchStatus.value = found ? "" : t("terminal.searchEmpty", "No matches");
 		}
 		function onSearchKeydown(event) {
 			if (event.key === "Escape") {
@@ -370,7 +459,7 @@ var RsTerminal_vue_vue_type_script_setup_true_lang_default = /*@__PURE__*/ defin
 				closeSearch();
 				return;
 			}
-			if (event.key === "Enter") {
+			if (event.key === "Enter" && !event.isComposing) {
 				event.preventDefault();
 				runSearch(event.shiftKey ? "prev" : "next");
 			}
@@ -381,32 +470,35 @@ var RsTerminal_vue_vue_type_script_setup_true_lang_default = /*@__PURE__*/ defin
 		}
 		async function copySelection() {
 			const text = resolveMenuSelectionText();
-			if (!text) return;
-			if (await copyTextToClipboard(text)) emit("action", "copy");
+			if (!text || !alive) return;
+			const copied = await copyTextToClipboard(text);
+			if (!alive || !copied) return;
+			emit("action", "copy");
 		}
 		async function pasteFromClipboard() {
-			if (!terminal || !props.inputEnabled) return;
+			if (!alive || !terminal || !props.inputEnabled) return;
 			terminal.focus();
 			const textarea = terminal.element?.querySelector("textarea");
 			if (textarea instanceof HTMLTextAreaElement) textarea.focus();
 			const text = await readClipboardText();
-			if (!text) return;
+			if (!alive || !text || !terminal) return;
 			terminal.paste(text);
 			emit("action", "paste");
 		}
 		function onTerminalContextMenu() {
 			beginClipboardPrefetch();
-			const existing = getSelectionText().trim();
-			if (existing) {
-				menuSelectionSnapshot.value = existing;
-				hasSelection.value = true;
-			} else menuSelectionSnapshot.value = "";
-			nextTick(() => {
-				syncSelectionState();
-				const after = getSelectionText().trim();
-				if (after && (!menuSelectionSnapshot.value || after.length > menuSelectionSnapshot.value.length)) menuSelectionSnapshot.value = after;
-				if (menuSelectionSnapshot.value) hasSelection.value = true;
-			});
+			const term = terminal;
+			if (!term) return;
+			const selected = Boolean(term.hasSelection());
+			if (selected && props.rightClickSelectsWord) {
+				term.options.rightClickSelectsWord = false;
+				queueMicrotask(() => {
+					if (alive && terminal) terminal.options.rightClickSelectsWord = props.rightClickSelectsWord;
+				});
+			}
+			if (hasSelection.value !== selected) hasSelection.value = selected;
+			if (!selected) menuSelectionText = "";
+			scheduleSelectionText();
 		}
 		function selectAll() {
 			terminal?.selectAll();
@@ -512,8 +604,23 @@ var RsTerminal_vue_vue_type_script_setup_true_lang_default = /*@__PURE__*/ defin
 			terminal.options.fontWeightBold = resolveTerminalFontWeightBold();
 			fit();
 		});
-		watch(() => props.cursorBlink, (value) => {
-			if (terminal) terminal.options.cursorBlink = value;
+		watch(() => props.cursorBlink, syncCursorBlink);
+		watch(() => props.cursorStyle, (value) => {
+			if (terminal) terminal.options.cursorStyle = value;
+		});
+		watch(() => props.inputEnabled, syncInputEnabled);
+		watch(regionLabel, labelTerminalInput);
+		watch(searchQuery, () => {
+			searchStatus.value = "";
+		});
+		watch(() => props.screenReaderMode, (value) => {
+			if (terminal) terminal.options.screenReaderMode = value;
+		});
+		watch(() => props.rescaleOverlappingGlyphs, (value) => {
+			if (terminal) terminal.options.rescaleOverlappingGlyphs = value;
+		});
+		watch(() => props.searchEnabled, (value) => {
+			if (!value) closeSearch();
 		});
 		watch(() => props.convertEol, (value) => {
 			if (terminal) terminal.options.convertEol = value;
@@ -534,11 +641,80 @@ var RsTerminal_vue_vue_type_script_setup_true_lang_default = /*@__PURE__*/ defin
 		watch(() => props.minimumContrastRatio, (value) => {
 			if (terminal) terminal.options.minimumContrastRatio = value;
 		});
+		function releaseDisposable(handle) {
+			handle?.dispose();
+		}
+		function openTerminalLink(raw) {
+			const text = raw.trim();
+			if (!alive || !isSafeTerminalLink(text)) return;
+			emit("link", text);
+			if (!props.openLinks || typeof window === "undefined") return;
+			window.open(text, "_blank", "noopener,noreferrer");
+		}
+		function attachLinkProvider() {
+			if (!terminal) return;
+			linkDisposable = terminal.registerLinkProvider({ provideLinks(bufferLineNumber, callback) {
+				const term = terminal;
+				if (!alive || !term) {
+					callback(void 0);
+					return;
+				}
+				const row = term.buffer.active.getLine(bufferLineNumber - 1);
+				if (!row) {
+					callback(void 0);
+					return;
+				}
+				const hits = findTerminalHttpLinks(row.translateToString(true));
+				if (!hits.length) {
+					callback(void 0);
+					return;
+				}
+				const cells = [];
+				for (let index = 0; index < row.length; index += 1) {
+					const cell = row.getCell(index);
+					cells.push({
+						chars: cell?.getChars() || "",
+						width: cell?.getWidth() ?? 1
+					});
+				}
+				callback(hits.map((hit) => {
+					const range = terminalLinkCellRange(cells, hit.start, hit.end);
+					return {
+						text: hit.text,
+						range: {
+							start: {
+								x: range.startX,
+								y: bufferLineNumber
+							},
+							end: {
+								x: range.endX,
+								y: bufferLineNumber
+							}
+						},
+						activate(_event, uri) {
+							openTerminalLink(uri);
+						}
+					};
+				}));
+			} });
+		}
+		function attachMotionPreference() {
+			if (typeof window === "undefined" || typeof window.matchMedia !== "function") return;
+			motionMedia = window.matchMedia("(prefers-reduced-motion: reduce)");
+			motionMedia.addEventListener("change", onMotionPreference);
+		}
+		function detachMotionPreference() {
+			motionMedia?.removeEventListener("change", onMotionPreference);
+			motionMedia = null;
+		}
 		onMounted(async () => {
+			alive = true;
 			if (!hostEl.value) return;
 			refreshResolvedTheme();
 			terminal = new Terminal({
-				cursorBlink: props.cursorBlink,
+				cursorBlink: props.cursorBlink && !prefersReducedMotion(),
+				cursorStyle: props.cursorStyle,
+				disableStdin: !props.inputEnabled,
 				fontFamily: resolveTerminalFontFamily(),
 				fontSize: resolveTerminalFontSize(),
 				fontWeight: resolveTerminalFontWeight(),
@@ -551,40 +727,56 @@ var RsTerminal_vue_vue_type_script_setup_true_lang_default = /*@__PURE__*/ defin
 				scrollback: props.scrollback,
 				convertEol: props.convertEol,
 				rightClickSelectsWord: props.rightClickSelectsWord,
-				theme: buildXtermTheme()
+				screenReaderMode: props.screenReaderMode,
+				rescaleOverlappingGlyphs: props.rescaleOverlappingGlyphs,
+				theme: buildXtermTheme(),
+				linkHandler: { activate(_event, text) {
+					openTerminalLink(text);
+				} }
 			});
 			fitAddon = new FitAddon();
 			terminal.loadAddon(fitAddon);
-			searchAddon = new SearchAddon();
-			terminal.loadAddon(searchAddon);
+			if (props.searchEnabled) ensureSearchAddon();
 			terminal.open(hostEl.value);
-			terminal.onData((data) => {
-				if (props.inputEnabled) emit("data", data);
+			labelTerminalInput();
+			dataDisposable = terminal.onData((data) => {
+				if (alive && props.inputEnabled) emit("data", data);
 			});
-			terminal.onSelectionChange(() => {
-				syncSelectionState();
+			selectionDisposable = terminal.onSelectionChange(() => {
+				if (!alive || !terminal) return;
+				const selected = Boolean(terminal.hasSelection());
+				if (hasSelection.value !== selected) hasSelection.value = selected;
+				scheduleSelectionText();
+			});
+			titleDisposable = terminal.onTitleChange((title) => {
+				if (alive) emit("titleChange", title);
 			});
+			bellDisposable = terminal.onBell(() => {
+				if (alive) emit("bell");
+			});
+			attachLinkProvider();
 			attachShortcuts();
+			attachMotionPreference();
 			await nextTick();
+			if (!alive || !terminal || !hostEl.value) return;
 			attachWheelGuard();
 			terminalReady.value = true;
 			await fit();
+			if (!alive || !terminal || !hostEl.value) return;
 			emit("ready");
 			resizeObserver = new ResizeObserver(() => {
 				scheduleFit();
 			});
 			resizeObserver.observe(hostEl.value);
-			themeObserver = new MutationObserver(() => {
-				if (props.themeMode === "auto") refreshResolvedTheme();
-			});
-			themeObserver.observe(document.documentElement, {
-				attributes: true,
-				attributeFilter: ["data-rs-theme"]
+			unsubscribeTheme = subscribeTerminalTheme(() => {
+				if (alive && props.themeMode === "auto") refreshResolvedTheme();
 			});
 		});
 		onBeforeUnmount(() => {
-			themeObserver?.disconnect();
-			themeObserver = null;
+			alive = false;
+			unsubscribeTheme?.();
+			unsubscribeTheme = null;
+			detachMotionPreference();
 			resizeObserver?.disconnect();
 			resizeObserver = null;
 			detachWheelGuard?.();
@@ -593,10 +785,25 @@ var RsTerminal_vue_vue_type_script_setup_true_lang_default = /*@__PURE__*/ defin
 				cancelAnimationFrame(fitRaf);
 				fitRaf = 0;
 			}
+			if (selectionFrame) {
+				cancelAnimationFrame(selectionFrame);
+				selectionFrame = 0;
+			}
+			releaseDisposable(dataDisposable);
+			releaseDisposable(selectionDisposable);
+			releaseDisposable(titleDisposable);
+			releaseDisposable(bellDisposable);
+			releaseDisposable(linkDisposable);
+			dataDisposable = null;
+			selectionDisposable = null;
+			titleDisposable = null;
+			bellDisposable = null;
+			linkDisposable = null;
+			searchAddon?.dispose?.();
+			searchAddon = null;
 			terminal?.dispose();
 			terminal = null;
 			fitAddon = null;
-			searchAddon = null;
 			didInitialFit = false;
 		});
 		__expose({
@@ -619,14 +826,20 @@ var RsTerminal_vue_vue_type_script_setup_true_lang_default = /*@__PURE__*/ defin
 				onSelect: onContextMenuSelect
 			}, {
 				default: withCtx(() => [createElementVNode("section", mergeProps(_ctx.$attrs, {
+					id: __props.id,
 					class: ["rs-terminal", { "rs-terminal--zebra": __props.zebraStripes }],
 					style: zebraStyle.value,
+					dir: "ltr",
+					"aria-label": regionLabel.value,
+					"aria-busy": showLoading.value ? "true" : void 0,
+					"aria-readonly": __props.inputEnabled ? void 0 : "true",
 					onClick: focus,
 					onContextmenuCapture: onTerminalContextMenu
 				}), [
 					__props.searchEnabled && searchOpen.value ? (openBlock(), createElementBlock("div", {
 						key: 0,
 						class: "rs-terminal__search",
+						role: "search",
 						onClick: _cache[3] || (_cache[3] = withModifiers(() => {}, ["stop"]))
 					}, [
 						withDirectives(createElementVNode("input", {
@@ -635,10 +848,12 @@ var RsTerminal_vue_vue_type_script_setup_true_lang_default = /*@__PURE__*/ defin
 							"onUpdate:modelValue": _cache[0] || (_cache[0] = ($event) => searchQuery.value = $event),
 							class: "rs-terminal__search-input",
 							type: "search",
+							enterkeyhint: "search",
 							placeholder: unref(t)("terminal.searchPlaceholder", "Find in terminal"),
 							"aria-label": unref(t)("terminal.search", "Search"),
+							"aria-describedby": searchStatus.value ? unref(searchStatusId) : void 0,
 							onKeydown: onSearchKeydown
-						}, null, 40, _hoisted_1), [[vModelText, searchQuery.value]]),
+						}, null, 40, _hoisted_2), [[vModelText, searchQuery.value]]),
 						createElementVNode("button", {
 							type: "button",
 							class: "rs-terminal__search-btn",
@@ -653,7 +868,12 @@ var RsTerminal_vue_vue_type_script_setup_true_lang_default = /*@__PURE__*/ defin
 							type: "button",
 							class: "rs-terminal__search-btn",
 							onClick: closeSearch
-						}, toDisplayString(unref(t)("terminal.searchClose", "Close search")), 1)
+						}, toDisplayString(unref(t)("terminal.searchClose", "Close search")), 1),
+						searchStatus.value ? (openBlock(), createElementBlock("output", {
+							key: 0,
+							id: unref(searchStatusId),
+							class: "rs-terminal__search-status"
+						}, toDisplayString(searchStatus.value), 9, _hoisted_3)) : createCommentVNode("", true)
 					])) : createCommentVNode("", true),
 					createElementVNode("div", {
 						ref_key: "hostEl",
@@ -668,8 +888,8 @@ var RsTerminal_vue_vue_type_script_setup_true_lang_default = /*@__PURE__*/ defin
 					__props.overlay || _ctx.$slots.overlayAction ? (openBlock(), createElementBlock("output", {
 						key: 2,
 						class: normalizeClass(["rs-terminal__overlay", { "rs-terminal__overlay--interactive": Boolean(_ctx.$slots.overlayAction) }])
-					}, [__props.overlay ? (openBlock(), createElementBlock("span", _hoisted_2, toDisplayString(__props.overlay), 1)) : createCommentVNode("", true), _ctx.$slots.overlayAction ? (openBlock(), createElementBlock("div", _hoisted_3, [renderSlot(_ctx.$slots, "overlayAction", {}, void 0, true)])) : createCommentVNode("", true)], 2)) : createCommentVNode("", true)
-				], 16)]),
+					}, [__props.overlay ? (openBlock(), createElementBlock("span", _hoisted_4, toDisplayString(__props.overlay), 1)) : createCommentVNode("", true), _ctx.$slots.overlayAction ? (openBlock(), createElementBlock("div", _hoisted_5, [renderSlot(_ctx.$slots, "overlayAction", {}, void 0, true)])) : createCommentVNode("", true)], 2)) : createCommentVNode("", true)
+				], 16, _hoisted_1)]),
 				_: 3
 			}, 8, ["disabled", "items"]);
 		};

package/dist/components/terminal/src/RsTerminal.js

@@ -3,6 +3,6 @@ import _plugin_vue_export_helper_default from "../../../_virtual/_plugin-vue_exp
 import RsTerminal_vue_vue_type_script_setup_true_lang_default from "./RsTerminal.impl.js";
 
 //#region src/components/terminal/src/RsTerminal.vue
-var RsTerminal_default = /*#__PURE__*/ _plugin_vue_export_helper_default(RsTerminal_vue_vue_type_script_setup_true_lang_default, [["__scopeId", "data-v-fcddd3a1"]]);
+var RsTerminal_default = /*#__PURE__*/ _plugin_vue_export_helper_default(RsTerminal_vue_vue_type_script_setup_true_lang_default, [["__scopeId", "data-v-79324a27"]]);
 //#endregion
 export { RsTerminal_default as default };

package/dist/components/terminal/src/terminal-utils.d.ts

@@ -1,6 +1,7 @@
 import type { ITheme, Terminal } from '@xterm/xterm';
 export type RsTerminalThemeMode = 'auto' | 'light' | 'dark';
 export type RsResolvedTerminalTheme = 'light' | 'dark';
+export type RsTerminalCursorStyle = 'block' | 'underline' | 'bar';
 export type RsTerminalAction = 'copy' | 'paste' | 'selectAll' | 'clear' | 'askAi' | 'search';
 export type RsTerminalGeometry = {
     cols: number;
@@ -29,11 +30,15 @@ export interface RsTerminalExpose {
 export declare function normalizeTerminalHexColor(value: string): string | null;
 /** 将 lab()/color() 等现代 CSS 色值转为 xterm 可解析的 #RRGGBB */
 export declare function resolveCssColorForXterm(value: string): string | null;
-/** 从全局 `--rs-terminal-*` token 构建 xterm 调色板（须已加载 styles.css） */
-export declare function readTerminalThemeFromCss(mode: RsResolvedTerminalTheme): ITheme;
-export declare function resolveTerminalTheme(mode?: RsTerminalThemeMode): RsResolvedTerminalTheme;
+/**
+ * auto 看最近的 `data-rs-theme`，没有时看 documentElement。
+ * 未写或不是 dark 时跟全库浅色。传入元素时深色岛不必改整页。
+ */
+export declare function resolveTerminalTheme(mode?: RsTerminalThemeMode, el?: HTMLElement | null): RsResolvedTerminalTheme;
+/** 从 `--rs-terminal-*` 构建 xterm 调色板。传入宿主时读继承到的 token。 */
+export declare function readTerminalThemeFromCss(mode: RsResolvedTerminalTheme, el?: HTMLElement | null): ITheme;
 export declare function getTerminalThemePalette(mode: RsResolvedTerminalTheme): ITheme;
-export declare function mergeTerminalTheme(mode: RsResolvedTerminalTheme, overrides?: Partial<ITheme>): ITheme;
+export declare function mergeTerminalTheme(mode: RsResolvedTerminalTheme, overrides?: Partial<ITheme>, el?: HTMLElement | null): ITheme;
 /** 读取斑马纹行底色（`--rs-terminal-row-stripe`，解析后供 xterm decoration 使用） */
 export declare function readTerminalRowStripeFromCss(mode: RsResolvedTerminalTheme): string;
 /** PTY 输出是否含终端控制序列（ESC / CSI），此类数据不应批量延迟。 */
@@ -81,5 +86,38 @@ export declare function prepareTerminalForPtyWrite(terminal: Terminal, data: str
 export declare function isMacPlatform(): boolean;
 /** 菜单/文档展示的修饰键标签 */
 export declare function terminalShortcutLabel(key: string): string;
+type ThemeListener = () => void;
+/**
+ * 多个终端共用一个 `data-rs-theme` 观察器（含主题岛）。
+ * 最后一个退订时断开，避免卸载后仍监听整棵文档。
+ */
+export declare function subscribeTerminalTheme(listener: ThemeListener): () => void;
+/** 当前仍挂着的主题订阅数。测试用来确认卸载成对退订。 */
+export declare function terminalThemeSubscriptionCount(): number;
+export type RsTerminalLinkHit = {
+    start: number;
+    end: number;
+    text: string;
+};
+/** 只放行 http(s) 与 mailto。javascript: / data: 一律拒绝。 */
+export declare function isSafeTerminalLink(value: string): boolean;
+/** 从一行可见文本里找出可点的 http(s) / mailto。end 为不含尾标点的字符串下标。 */
+export declare function findTerminalHttpLinks(line: string): RsTerminalLinkHit[];
+/**
+ * 把字符串下标换成 xterm 1-based 单元格列。
+ * 宽字符占两格，后续 width 0 的格子跳过，避免链接框落在汉字上。
+ */
+export declare function terminalCellIndexForString(cells: ReadonlyArray<{
+    chars: string;
+    width: number;
+}>, stringIndex: number): number;
+export declare function terminalLinkCellRange(cells: ReadonlyArray<{
+    chars: string;
+    width: number;
+}>, start: number, end: number): {
+    startX: number;
+    endX: number;
+};
 /** ANSI 16 色演示文本 */
 export declare function buildAnsiColorDemo(): string;
+export {};