niuma-ui 1.2.9 → 1.3.0

package/CHANGELOG.md

@@ -6,6 +6,15 @@
 
 ## [Unreleased]
 
+## [1.3.0] - 2026-09-07
+
+### 新增
+
+- `RsTerminal`：`searchEnabled`（默认 `false`）打开终端内查找。`Ctrl/⌘+F`、右键「搜索」调出浮层；Enter / Shift+Enter 下一个 / 上一个，Esc 关闭。依赖 `@xterm/addon-search`，已列入 `niuma-ui/vite-prebundle/xterm`。
+- `RsTerminal`：`copyOnSelect`（默认 `false`）在鼠标松开且有选区时复制，接近原生终端 copy-on-select。
+- `RsTerminal`：`#overlayAction` 插槽。有插槽时遮罩可点，便于宿主放「重连」等操作；仅 `overlay` 文案时仍拦截点击。
+- `RsTerminalAction` 增加 `search`。中英 locale：`terminal.search` / `searchPlaceholder` / `searchNext` / `searchPrev` / `searchClose`。
+
 ## [1.2.9] - 2026-09-01
 
 ### 修复

package/dist/components/RsTerminal.css

@@ -1,5 +1,5 @@
 
-.rs-terminal[data-v-67905bea] {
+.rs-terminal[data-v-fba85f3c] {
   position: relative;
   height: 100%;
   min-height: 0;
@@ -16,13 +16,13 @@
     0 1px 3px color-mix(in srgb, #000 32%, transparent);
   overflow: hidden;
 }
-[data-rs-theme='light'] .rs-terminal[data-v-67905bea] {
+[data-rs-theme='light'] .rs-terminal[data-v-fba85f3c] {
   box-shadow:
     inset 0 1px 0 color-mix(in srgb, #fff 80%, transparent),
     inset 0 0 0 1px color-mix(in srgb, #000 4%, transparent),
     0 1px 4px color-mix(in srgb, #000 8%, transparent);
 }
-.rs-terminal__host[data-v-67905bea] {
+.rs-terminal__host[data-v-fba85f3c] {
   position: relative;
   width: 100%;
   height: 100%;
@@ -30,15 +30,17 @@
   /* FitAddon 取整余量露底时，与单元格同色（勿用 shell 灰底） */
   background: var(--rs-terminal-bg);
 }
-.rs-terminal__loading[data-v-67905bea],
-.rs-terminal__overlay[data-v-67905bea] {
+.rs-terminal__loading[data-v-fba85f3c],
+.rs-terminal__overlay[data-v-fba85f3c] {
   position: absolute;
   inset: 0;
   display: flex;
   align-items: center;
   justify-content: center;
 }
-.rs-terminal__overlay[data-v-67905bea] {
+.rs-terminal__overlay[data-v-fba85f3c] {
+  flex-direction: column;
+  gap: var(--rs-space-sm);
   padding: var(--rs-space-lg);
   color: color-mix(in srgb, var(--rs-terminal-fg) 92%, #fff 8%);
   background: color-mix(in srgb, var(--rs-terminal-bg) 84%, transparent);
@@ -49,6 +51,45 @@
   font-weight: var(--rs-font-weight-regular);
   line-height: var(--rs-line-height-normal);
 }
+.rs-terminal__overlay--interactive[data-v-fba85f3c] {
+  pointer-events: auto;
+}
+.rs-terminal__overlay-action[data-v-fba85f3c] {
+  pointer-events: auto;
+}
+.rs-terminal__search[data-v-fba85f3c] {
+  position: absolute;
+  top: var(--rs-space-xs);
+  right: var(--rs-space-xs);
+  z-index: 2;
+  display: flex;
+  align-items: center;
+  gap: var(--rs-space-xs);
+  padding: var(--rs-space-xs);
+  border: 1px solid var(--rs-terminal-border);
+  border-radius: var(--rs-radius-sm);
+  background: color-mix(in srgb, var(--rs-terminal-bg) 92%, transparent);
+}
+.rs-terminal__search-input[data-v-fba85f3c] {
+  width: 12rem;
+  padding: 0.2rem 0.4rem;
+  border: 1px solid var(--rs-terminal-border);
+  border-radius: var(--rs-radius-sm);
+  background: var(--rs-terminal-bg);
+  color: var(--rs-terminal-fg);
+  font-family: var(--rs-font-mono);
+  font-size: var(--rs-font-size-xs);
+  outline: none;
+}
+.rs-terminal__search-btn[data-v-fba85f3c] {
+  padding: 0.2rem 0.4rem;
+  border: 1px solid var(--rs-terminal-border);
+  border-radius: var(--rs-radius-sm);
+  background: transparent;
+  color: var(--rs-terminal-fg);
+  font-size: var(--rs-font-size-xs);
+  cursor: pointer;
+}
 
 /*
  * letter-spacing 必须在终端内归零：宿主应用常在祖先上设负字距（NiuMa 的 .nm-app 是 -0.011em）。
@@ -57,7 +98,7 @@
  * DOM 渲染器于是按 `cellWidth - 测量值` 给每个字符补正字距，行盒却仍是 cols × cellWidth，
  * 逐列累积后整行溢出十几到几十像素，被行盒的 overflow:hidden 切掉行尾几个字符。
  */
-.rs-terminal[data-v-67905bea] .xterm {
+.rs-terminal[data-v-fba85f3c] .xterm {
   width: 100%;
   height: 100%;
   line-height: normal;
@@ -68,7 +109,7 @@
  * xterm 6 官方仍给空的 .xterm-viewport 写 overflow-y:scroll + 背景 #000。
  * 真正滚动的是 .xterm-scrollable-element；空层滚动条会挡住最后一列。
  */
-.rs-terminal[data-v-67905bea] .xterm .xterm-viewport {
+.rs-terminal[data-v-fba85f3c] .xterm .xterm-viewport {
   overflow: hidden;
   background-color: transparent;
 }
@@ -78,7 +119,7 @@
  * 的圆角胶囊不一致。轨道宽度由 overviewRuler.width 决定，改它会给每个终端实例多建一块
  * overview ruler 画布，因此只重绘滑块：热区仍是 14px，靠透明边框内缩出 10px 可见胶囊。
  */
-.rs-terminal[data-v-67905bea] .xterm-scrollable-element > .scrollbar > .slider {
+.rs-terminal[data-v-fba85f3c] .xterm-scrollable-element > .scrollbar > .slider {
   box-sizing: border-box;
   border: var(--rs-scrollbar-padding, 2px) solid transparent;
   border-radius: var(--rs-radius-full);
@@ -86,18 +127,18 @@
   background-clip: padding-box;
   transition: background-color var(--rs-transition-fast);
 }
-.rs-terminal[data-v-67905bea] .xterm-scrollable-element > .scrollbar > .slider:hover {
+.rs-terminal[data-v-fba85f3c] .xterm-scrollable-element > .scrollbar > .slider:hover {
   background-color: color-mix(in srgb, var(--rs-primary) 40%, var(--rs-muted));
 }
-.rs-terminal[data-v-67905bea] .xterm-scrollable-element > .scrollbar > .slider.active {
+.rs-terminal[data-v-fba85f3c] .xterm-scrollable-element > .scrollbar > .slider.active {
   background-color: color-mix(in srgb, var(--rs-primary) 55%, var(--rs-muted));
 }
-.rs-terminal--zebra[data-v-67905bea] .xterm-rows,
-.rs-terminal--zebra[data-v-67905bea] .xterm-rows > div,
-.rs-terminal--zebra[data-v-67905bea] .xterm-row {
+.rs-terminal--zebra[data-v-fba85f3c] .xterm-rows,
+.rs-terminal--zebra[data-v-fba85f3c] .xterm-rows > div,
+.rs-terminal--zebra[data-v-fba85f3c] .xterm-row {
   background-color: transparent !important;
 }
-.rs-terminal--zebra[data-v-67905bea] .xterm-scrollable-element {
+.rs-terminal--zebra[data-v-fba85f3c] .xterm-scrollable-element {
   background-color: transparent !important;
   background-image: repeating-linear-gradient(
     to bottom,
@@ -108,12 +149,12 @@
   );
   background-attachment: local;
 }
-.rs-terminal--zebra[data-v-67905bea] .xterm-screen {
+.rs-terminal--zebra[data-v-fba85f3c] .xterm-screen {
   background-color: transparent !important;
 }
-.rs-terminal[data-v-67905bea] .xterm-fg-257 {
+.rs-terminal[data-v-fba85f3c] .xterm-fg-257 {
   color: var(--rs-terminal-bg) !important;
 }
-.rs-terminal[data-v-67905bea] .xterm-bg-257 {
+.rs-terminal[data-v-fba85f3c] .xterm-bg-257 {
   background-color: var(--rs-terminal-fg) !important;
 }

package/dist/components/RsTerminal.d.ts

@@ -42,8 +42,16 @@ type __VLS_Props = {
     wheelScrollModifier?: RsTerminalWheelScrollModifier;
     /** TUI 全屏刷新时若视口不在底部，自动滚回底部（修复 top 表头丢失） */
     snapViewportOnTuiWrite?: boolean;
+    /** 鼠标松开时若有选区则复制（接近原生终端 copy-on-select） */
+    copyOnSelect?: boolean;
+    /** 启用 Ctrl/⌘+F 终端内搜索 */
+    searchEnabled?: boolean;
 };
-declare const __VLS_export: import("vue").DefineComponent<__VLS_Props, RsTerminalExpose, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {
+declare var __VLS_15: {};
+type __VLS_Slots = {} & {
+    overlayAction?: (props: typeof __VLS_15) => any;
+};
+declare const __VLS_base: import("vue").DefineComponent<__VLS_Props, RsTerminalExpose, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {
     data: (data: string) => any;
     resize: (payload: {
         cols: number;
@@ -80,6 +88,14 @@ declare const __VLS_export: import("vue").DefineComponent<__VLS_Props, RsTermina
     zebraStripes: boolean;
     wheelScrollModifier: RsTerminalWheelScrollModifier;
     snapViewportOnTuiWrite: boolean;
+    copyOnSelect: boolean;
+    searchEnabled: boolean;
 }, {}, {}, {}, string, import("vue").ComponentProvideOptions, false, {}, any>;
+declare const __VLS_export: __VLS_WithSlots<typeof __VLS_base, __VLS_Slots>;
 declare const _default: typeof __VLS_export;
 export default _default;
+type __VLS_WithSlots<T, S> = T & {
+    new (): {
+        $slots: S;
+    };
+};

package/dist/components/RsTerminal.impl.js

@@ -5,14 +5,17 @@ import { beginClipboardPrefetch, copyTextToClipboard, readClipboardText } from "
 import { readTerminalFontFamily, readTerminalFontSizePx, readTerminalFontWeight, readTerminalFontWeightBold } from "../theme/css-token.js";
 import { containsTuiRefreshSequence, mergeTerminalTheme, prepareTerminalForPtyWrite, resolveTerminalTheme, terminalShortcutLabel } from "./terminal-utils.js";
 import { attachWheelScrollGuard, isAlternateTerminalBuffer } from "./terminal-wheel.js";
-import { computed, createBlock, createCommentVNode, createElementBlock, createElementVNode, defineComponent, mergeProps, nextTick, onBeforeUnmount, onMounted, openBlock, ref, toDisplayString, watch, withCtx } from "vue";
+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 { 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/RsTerminal.vue?vue&type=script&setup=true&lang.ts
-var _hoisted_1 = {
+var _hoisted_1 = ["placeholder", "aria-label"];
+var _hoisted_2 = { key: 0 };
+var _hoisted_3 = {
 	key: 1,
-	class: "rs-terminal__overlay"
+	class: "rs-terminal__overlay-action"
 };
 /** 单元格高度倍率（xterm options.lineHeight）。中文比 Canvas 测的西文高，1 会裁到下一行。 */
 var TERMINAL_LINE_HEIGHT = 1.2;
@@ -74,6 +77,14 @@ var RsTerminal_vue_vue_type_script_setup_true_lang_default = /*@__PURE__*/ defin
 		snapViewportOnTuiWrite: {
 			type: Boolean,
 			default: true
+		},
+		copyOnSelect: {
+			type: Boolean,
+			default: false
+		},
+		searchEnabled: {
+			type: Boolean,
+			default: false
 		}
 	},
 	emits: [
@@ -149,6 +160,12 @@ var RsTerminal_vue_vue_type_script_setup_true_lang_default = /*@__PURE__*/ defin
 					shortcut: terminalShortcutLabel("A")
 				}
 			];
+			if (props.searchEnabled) items.push({
+				key: "search",
+				label: t("terminal.search", "Search"),
+				icon: "search",
+				shortcut: terminalShortcutLabel("F")
+			});
 			if (props.showAskAi) items.push({
 				key: "sep-ai",
 				label: "",
@@ -172,8 +189,12 @@ var RsTerminal_vue_vue_type_script_setup_true_lang_default = /*@__PURE__*/ defin
 			});
 			return items;
 		});
+		const searchOpen = ref(false);
+		const searchQuery = ref("");
+		const searchInputEl = ref(null);
 		let terminal = null;
 		let fitAddon = null;
+		let searchAddon = null;
 		let resizeObserver = null;
 		let themeObserver = null;
 		let detachWheelGuard = null;
@@ -290,6 +311,43 @@ var RsTerminal_vue_vue_type_script_setup_true_lang_default = /*@__PURE__*/ defin
 			if (live && (!snap || live.length >= snap.length)) return live;
 			return snap;
 		}
+		function openSearch() {
+			if (!props.searchEnabled) return;
+			searchOpen.value = true;
+			nextTick(() => {
+				searchInputEl.value?.focus();
+				searchInputEl.value?.select();
+			});
+		}
+		function closeSearch() {
+			searchOpen.value = false;
+			searchAddon?.clearDecorations();
+			terminal?.focus();
+		}
+		function runSearch(direction) {
+			const query = searchQuery.value;
+			if (!query || !searchAddon) return;
+			if (direction === "prev") {
+				searchAddon.findPrevious(query);
+				return;
+			}
+			searchAddon.findNext(query);
+		}
+		function onSearchKeydown(event) {
+			if (event.key === "Escape") {
+				event.preventDefault();
+				closeSearch();
+				return;
+			}
+			if (event.key === "Enter") {
+				event.preventDefault();
+				runSearch(event.shiftKey ? "prev" : "next");
+			}
+		}
+		function onHostMouseUp() {
+			if (!props.copyOnSelect || !terminal?.hasSelection()) return;
+			copySelection();
+		}
 		async function copySelection() {
 			const text = resolveMenuSelectionText();
 			if (!text) return;
@@ -345,6 +403,11 @@ var RsTerminal_vue_vue_type_script_setup_true_lang_default = /*@__PURE__*/ defin
 				clearTerminal();
 				return;
 			}
+			if (action === "search") {
+				openSearch();
+				emit("action", "search");
+				return;
+			}
 			if (action === "askAi") {
 				const text = resolveMenuSelectionText();
 				emit("askAi", text);
@@ -384,6 +447,12 @@ var RsTerminal_vue_vue_type_script_setup_true_lang_default = /*@__PURE__*/ defin
 					clearTerminal();
 					return false;
 				}
+				if (key === "f" && props.searchEnabled) {
+					event.preventDefault();
+					event.stopPropagation();
+					openSearch();
+					return false;
+				}
 				return true;
 			});
 		}
@@ -439,6 +508,8 @@ var RsTerminal_vue_vue_type_script_setup_true_lang_default = /*@__PURE__*/ defin
 			});
 			fitAddon = new FitAddon();
 			terminal.loadAddon(fitAddon);
+			searchAddon = new SearchAddon();
+			terminal.loadAddon(searchAddon);
 			terminal.open(hostEl.value);
 			terminal.onData((data) => {
 				if (props.inputEnabled) emit("data", data);
@@ -478,6 +549,7 @@ var RsTerminal_vue_vue_type_script_setup_true_lang_default = /*@__PURE__*/ defin
 			terminal?.dispose();
 			terminal = null;
 			fitAddon = null;
+			searchAddon = null;
 			didInitialFit = false;
 		});
 		__expose({
@@ -505,18 +577,53 @@ var RsTerminal_vue_vue_type_script_setup_true_lang_default = /*@__PURE__*/ defin
 					onClick: focus,
 					onContextmenuCapture: onTerminalContextMenu
 				}), [
+					__props.searchEnabled && searchOpen.value ? (openBlock(), createElementBlock("div", {
+						key: 0,
+						class: "rs-terminal__search",
+						onClick: _cache[3] || (_cache[3] = withModifiers(() => {}, ["stop"]))
+					}, [
+						withDirectives(createElementVNode("input", {
+							ref_key: "searchInputEl",
+							ref: searchInputEl,
+							"onUpdate:modelValue": _cache[0] || (_cache[0] = ($event) => searchQuery.value = $event),
+							class: "rs-terminal__search-input",
+							type: "search",
+							placeholder: unref(t)("terminal.searchPlaceholder", "Find in terminal"),
+							"aria-label": unref(t)("terminal.search", "Search"),
+							onKeydown: onSearchKeydown
+						}, null, 40, _hoisted_1), [[vModelText, searchQuery.value]]),
+						createElementVNode("button", {
+							type: "button",
+							class: "rs-terminal__search-btn",
+							onClick: _cache[1] || (_cache[1] = ($event) => runSearch("prev"))
+						}, toDisplayString(unref(t)("terminal.searchPrev", "Previous")), 1),
+						createElementVNode("button", {
+							type: "button",
+							class: "rs-terminal__search-btn",
+							onClick: _cache[2] || (_cache[2] = ($event) => runSearch("next"))
+						}, toDisplayString(unref(t)("terminal.searchNext", "Next")), 1),
+						createElementVNode("button", {
+							type: "button",
+							class: "rs-terminal__search-btn",
+							onClick: closeSearch
+						}, toDisplayString(unref(t)("terminal.searchClose", "Close search")), 1)
+					])) : createCommentVNode("", true),
 					createElementVNode("div", {
 						ref_key: "hostEl",
 						ref: hostEl,
-						class: "rs-terminal__host"
-					}, null, 512),
+						class: "rs-terminal__host",
+						onMouseup: onHostMouseUp
+					}, null, 544),
 					showLoading.value ? (openBlock(), createBlock(RsLoading_default, {
-						key: 0,
+						key: 1,
 						class: "rs-terminal__loading"
 					})) : createCommentVNode("", true),
-					__props.overlay ? (openBlock(), createElementBlock("output", _hoisted_1, toDisplayString(__props.overlay), 1)) : createCommentVNode("", true)
+					__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)]),
-				_: 1
+				_: 3
 			}, 8, ["disabled", "items"]);
 		};
 	}

package/dist/components/RsTerminal.js

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

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

@@ -1,7 +1,7 @@
 import type { ITheme, Terminal } from '@xterm/xterm';
 export type RsTerminalThemeMode = 'auto' | 'light' | 'dark';
 export type RsResolvedTerminalTheme = 'light' | 'dark';
-export type RsTerminalAction = 'copy' | 'paste' | 'selectAll' | 'clear' | 'askAi';
+export type RsTerminalAction = 'copy' | 'paste' | 'selectAll' | 'clear' | 'askAi' | 'search';
 export type RsTerminalGeometry = {
     cols: number;
     rows: number;

package/dist/dev/vite-xterm-deps.d.ts

@@ -4,5 +4,6 @@
  * CSS 一并扫描，防止 JS 预构建后样式副作用丢失。
  */
 import '@xterm/addon-fit';
+import '@xterm/addon-search';
 import '@xterm/xterm';
 import '@xterm/xterm/css/xterm.css';

package/dist/dev/vite-xterm-deps.js

@@ -1,3 +1,4 @@
 import "@xterm/addon-fit";
+import "@xterm/addon-search";
 import "@xterm/xterm";
 import "@xterm/xterm/css/xterm.css";

package/dist/locale/messages.js

@@ -148,6 +148,11 @@ var zhCN = {
 	"terminal.selectAll": "全选",
 	"terminal.clear": "清空终端",
 	"terminal.askAi": "询问 AI",
+	"terminal.search": "搜索",
+	"terminal.searchPlaceholder": "在终端中查找",
+	"terminal.searchNext": "下一个",
+	"terminal.searchPrev": "上一个",
+	"terminal.searchClose": "关闭搜索",
 	"playground.brand": "Niuma UI",
 	"playground.subtitle": "Vue 3 组件演示",
 	"playground.nav.label": "组件导航",
@@ -351,6 +356,11 @@ var enUS = {
 	"terminal.selectAll": "Select All",
 	"terminal.clear": "Clear Terminal",
 	"terminal.askAi": "Ask AI",
+	"terminal.search": "Search",
+	"terminal.searchPlaceholder": "Find in terminal",
+	"terminal.searchNext": "Next",
+	"terminal.searchPrev": "Previous",
+	"terminal.searchClose": "Close search",
 	"playground.brand": "Niuma UI",
 	"playground.subtitle": "Vue 3 component demos",
 	"playground.nav.label": "Component navigation",

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "niuma-ui",
-  "version": "1.2.9",
+  "version": "1.3.0",
   "license": "Apache-2.0",
   "type": "module",
   "description": "Vue 3 工作台设计系统（Rs* 组件、--rs-* token；含可选编辑器 / 终端）",
@@ -105,6 +105,7 @@
     "@codemirror/view": "^6.43.1",
     "@lucide/vue": "^1.31.0",
     "@xterm/addon-fit": "^0.11.0",
+    "@xterm/addon-search": "^0.16.0",
     "@xterm/xterm": "^6.0.0",
     "codemirror": "^6.0.2",
     "dayjs": "^1.11.21",