niuma-ui 1.3.8 → 2.0.0

package/dist/components/tabs/src/tabs-utils.js

@@ -0,0 +1,147 @@
+//#region src/components/tabs/src/tabs-utils.ts
+/** 判断是否为固定标签 */
+function isTabFixed(item) {
+	return item.fixed === true;
+}
+/** 判断单项是否展示关闭按钮 */
+function isTabClosable(item, globalClosable = false) {
+	if (isTabFixed(item)) return false;
+	if (item.closable !== void 0) return item.closable;
+	return globalClosable;
+}
+/** 判断单项是否可双击重命名 */
+function isTabRenamable(item, globalRenamable = false) {
+	if (item.renamable !== void 0) return item.renamable;
+	return globalRenamable;
+}
+/** 关闭当前激活项时，解析应切换到的下一项（优先右侧，否则左侧） */
+function getNextTabAfterClose(items, closedValue, activeValue) {
+	if (activeValue !== closedValue) return activeValue;
+	const index = items.findIndex((item) => item.value === closedValue);
+	if (index < 0) return void 0;
+	const remaining = items.filter((item) => item.value !== closedValue);
+	if (!remaining.length) return void 0;
+	return remaining[index]?.value ?? remaining[index - 1]?.value ?? remaining[0]?.value;
+}
+/**
+* 批量关闭后解析应保留的激活项。
+* 若当前激活项仍在剩余列表中则保持，否则取锚点（若仍在）或首项。
+*/
+function getNextTabAfterBatchClose(remaining, activeValue, anchorValue) {
+	if (!remaining.length) return void 0;
+	if (remaining.some((item) => item.value === activeValue)) return activeValue;
+	if (anchorValue && remaining.some((item) => item.value === anchorValue)) return anchorValue;
+	return remaining[0]?.value;
+}
+/** 将 dragValue 对应的项移动到 dropValue 之前（fixed 项不可作为拖拽源或落点） */
+function reorderTabItems(items, dragValue, dropValue) {
+	const from = items.findIndex((item) => item.value === dragValue);
+	const to = items.findIndex((item) => item.value === dropValue);
+	if (from < 0 || to < 0 || from === to) return items;
+	const dragItem = items[from];
+	const dropItem = items[to];
+	if (!dragItem || !dropItem || isTabFixed(dragItem) || isTabFixed(dropItem)) return items;
+	const next = [...items];
+	const [moved] = next.splice(from, 1);
+	if (!moved) return items;
+	next.splice(to, 0, moved);
+	return next;
+}
+/**
+* 按动作解析待关闭的 value 列表（跳过 fixed / 不可关闭项）。
+*/
+function resolveTabsToClose(items, action, anchorValue, globalClosable = false) {
+	const index = items.findIndex((item) => item.value === anchorValue);
+	if (index < 0 && action !== "all") return [];
+	const canClose = (item) => isTabClosable(item, globalClosable);
+	switch (action) {
+		case "close": {
+			const item = items[index];
+			return item && canClose(item) ? [item.value] : [];
+		}
+		case "others": return items.filter((item) => item.value !== anchorValue && canClose(item)).map((item) => item.value);
+		case "left": return items.filter((item, i) => i < index && canClose(item)).map((item) => item.value);
+		case "right": return items.filter((item, i) => i > index && canClose(item)).map((item) => item.value);
+		case "all": return items.filter((item) => canClose(item)).map((item) => item.value);
+		default: return [];
+	}
+}
+/**
+* 构建顶栏导航右键菜单项（关闭 / 关闭其他 / 左 / 右 / 全部）。
+*/
+function buildTabContextMenuItems(items, anchor, globalClosable, labels) {
+	if (items.findIndex((item) => item.value === anchor.value) < 0) return [];
+	const canCloseAnchor = isTabClosable(anchor, globalClosable);
+	const others = resolveTabsToClose(items, "others", anchor.value, globalClosable);
+	const left = resolveTabsToClose(items, "left", anchor.value, globalClosable);
+	const right = resolveTabsToClose(items, "right", anchor.value, globalClosable);
+	const all = resolveTabsToClose(items, "all", anchor.value, globalClosable);
+	return [
+		{
+			key: "close",
+			label: labels.close,
+			icon: "x",
+			disabled: !canCloseAnchor
+		},
+		{
+			key: "sep-1",
+			label: "",
+			separator: true
+		},
+		{
+			key: "others",
+			label: labels.closeOthers,
+			icon: "copy-x",
+			disabled: others.length === 0
+		},
+		{
+			key: "left",
+			label: labels.closeLeft,
+			icon: "arrow-left-to-line",
+			disabled: left.length === 0
+		},
+		{
+			key: "right",
+			label: labels.closeRight,
+			icon: "arrow-right-to-line",
+			disabled: right.length === 0
+		},
+		{
+			key: "sep-2",
+			label: "",
+			separator: true
+		},
+		{
+			key: "all",
+			label: labels.closeAll,
+			icon: "trash-2",
+			danger: true,
+			disabled: all.length === 0
+		}
+	];
+}
+/**
+* 根据各标签宽度与可用宽度，计算应展示的标签 value 集合。
+*/
+function resolveVisibleTabValues(items, widths, availableWidth, activeValue, reservedWidth = 0, options = {}) {
+	const keepActiveVisible = options.keepActiveVisible ?? true;
+	if (availableWidth <= 0 || !items.length) return new Set(items.map((item) => item.value));
+	const budget = Math.max(0, availableWidth - reservedWidth);
+	const visible = [];
+	let used = 0;
+	for (const item of items) {
+		const width = widths.get(item.value) ?? 0;
+		if (used + width > budget) break;
+		visible.push(item.value);
+		used += width;
+	}
+	if (keepActiveVisible && !visible.includes(activeValue)) {
+		if (items.findIndex((item) => item.value === activeValue) >= 0) {
+			if (visible.length > 1) visible.pop();
+			if (!visible.includes(activeValue)) visible.push(activeValue);
+		}
+	}
+	return new Set(visible);
+}
+//#endregion
+export { buildTabContextMenuItems, getNextTabAfterBatchClose, getNextTabAfterClose, isTabClosable, isTabFixed, isTabRenamable, reorderTabItems, resolveTabsToClose, resolveVisibleTabValues };

package/dist/components/tag/index.d.ts

@@ -0,0 +1,2 @@
+export { default as RsTag } from './src/RsTag.js';
+export type { RsTagVariant } from './src/RsTag.js';

package/dist/components/tag/src/RsTag.css

@@ -0,0 +1,94 @@
+
+.rs-tag[data-v-0140d810] {
+  display: inline-flex;
+  align-items: center;
+  gap: var(--rs-space-xs);
+  max-width: 100%;
+  border-radius: var(--rs-tag-radius, var(--rs-radius-sm));
+  font-weight: var(--rs-tag-font-weight, 400);
+  line-height: var(--rs-line-height-tight);
+  box-sizing: border-box;
+  vertical-align: middle;
+}
+.rs-tag--ssm[data-v-0140d810] {
+  padding: 0 var(--rs-space-xs);
+  font-size: var(--rs-font-size-xs);
+}
+.rs-tag--sm[data-v-0140d810] {
+  padding: 0.0625rem var(--rs-space-xs);
+  font-size: var(--rs-font-size-xs);
+}
+.rs-tag--md[data-v-0140d810] {
+  padding: 0.125rem var(--rs-space-sm);
+  font-size: var(--rs-font-size-xs);
+}
+.rs-tag--lg[data-v-0140d810] {
+  padding: var(--rs-space-xs) var(--rs-space-sm);
+  font-size: var(--rs-font-size-sm);
+}
+.rs-tag--round[data-v-0140d810] {
+  border-radius: var(--rs-radius-full);
+}
+.rs-tag--disabled[data-v-0140d810] {
+  opacity: 0.55;
+  cursor: not-allowed;
+}
+.rs-tag__content[data-v-0140d810] {
+  overflow: hidden;
+  text-overflow: ellipsis;
+  white-space: nowrap;
+}
+.rs-tag__close[data-v-0140d810] {
+  display: inline-flex;
+  align-items: center;
+  justify-content: center;
+  margin: 0;
+  padding: 0;
+  border: 0;
+  border-radius: var(--rs-radius-full);
+  background: transparent;
+  color: inherit;
+  cursor: pointer;
+  opacity: 0.75;
+  outline: none;
+}
+.rs-tag__close[data-v-0140d810]:hover:not(:disabled) {
+  opacity: 1;
+  background: color-mix(in srgb, currentColor 12%, transparent);
+}
+.rs-tag__close[data-v-0140d810]:focus-visible {
+  box-shadow: 0 0 0 var(--rs-focus-ring-width, 2px) var(--rs-focus-ring);
+}
+.rs-tag__close[data-v-0140d810]:disabled {
+  cursor: not-allowed;
+}
+.rs-tag--default[data-v-0140d810] {
+  background: var(--rs-surface-hover);
+  color: var(--rs-text);
+  border: 1px solid var(--rs-border);
+}
+.rs-tag--primary[data-v-0140d810] {
+  background: var(--rs-primary-container);
+  color: var(--rs-on-primary-container);
+  border: 1px solid color-mix(in srgb, var(--rs-primary) var(--rs-tag-border-alpha, 40%), transparent);
+}
+.rs-tag--success[data-v-0140d810] {
+  background: var(--rs-success-container);
+  color: var(--rs-on-success-container);
+  border: 1px solid color-mix(in srgb, var(--rs-success) var(--rs-tag-border-alpha, 40%), transparent);
+}
+.rs-tag--warning[data-v-0140d810] {
+  background: var(--rs-warning-container);
+  color: var(--rs-on-warning-container);
+  border: 1px solid color-mix(in srgb, var(--rs-warning) var(--rs-tag-border-alpha, 40%), transparent);
+}
+.rs-tag--danger[data-v-0140d810] {
+  background: var(--rs-danger-container);
+  color: var(--rs-on-danger-container);
+  border: 1px solid color-mix(in srgb, var(--rs-danger) var(--rs-tag-border-alpha, 40%), transparent);
+}
+.rs-tag--info[data-v-0140d810] {
+  background: var(--rs-info-container);
+  color: var(--rs-on-info-container);
+  border: 1px solid color-mix(in srgb, var(--rs-info) var(--rs-tag-border-alpha, 40%), transparent);
+}

package/dist/components/tag/src/RsTag.d.ts

@@ -0,0 +1,33 @@
+import type { RsComponentSize, RsRadius } from '../../../theme/types';
+export type RsTagVariant = 'default' | 'primary' | 'success' | 'warning' | 'danger' | 'info';
+type __VLS_Props = {
+    variant?: RsTagVariant;
+    closable?: boolean;
+    disabled?: boolean;
+    /** 胶囊圆角快捷开关；等价于 radius="full" */
+    round?: boolean;
+    size?: RsComponentSize;
+    radius?: RsRadius;
+};
+declare var __VLS_1: {};
+type __VLS_Slots = {} & {
+    default?: (props: typeof __VLS_1) => any;
+};
+declare const __VLS_base: import("vue").DefineComponent<__VLS_Props, {}, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {
+    close: (event: MouseEvent) => any;
+}, string, import("vue").PublicProps, Readonly<__VLS_Props> & Readonly<{
+    onClose?: ((event: MouseEvent) => any) | undefined;
+}>, {
+    variant: RsTagVariant;
+    disabled: boolean;
+    closable: boolean;
+    round: 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/tag/src/RsTag.impl.js

@@ -0,0 +1,70 @@
+import { useRsI18n } from "../../../composables/useRsI18n.js";
+import RsIcon_default from "../../icon/src/RsIcon.js";
+import { useResolvedRsComponentSize } from "../../_shared/src/resolve-size.js";
+import { rsRadiusCss, useResolvedRsRadius } from "../../_shared/src/resolve-radius.js";
+import { computed, createCommentVNode, createElementBlock, createElementVNode, createVNode, defineComponent, normalizeClass, normalizeStyle, openBlock, renderSlot, unref } from "vue";
+//#region src/components/tag/src/RsTag.vue?vue&type=script&setup=true&lang.ts
+var _hoisted_1 = { class: "rs-tag__content" };
+var _hoisted_2 = ["disabled", "aria-label"];
+var RsTag_vue_vue_type_script_setup_true_lang_default = /*@__PURE__*/ defineComponent({
+	__name: "RsTag",
+	props: {
+		variant: { default: "default" },
+		closable: {
+			type: Boolean,
+			default: false
+		},
+		disabled: {
+			type: Boolean,
+			default: false
+		},
+		round: {
+			type: Boolean,
+			default: false
+		},
+		size: {},
+		radius: {}
+	},
+	emits: ["close"],
+	setup(__props, { emit: __emit }) {
+		const props = __props;
+		const emit = __emit;
+		const { t } = useRsI18n();
+		const resolvedSize = useResolvedRsComponentSize(() => props.size);
+		const resolvedRadius = useResolvedRsRadius(() => props.round ? "full" : props.radius, "sm");
+		const rootClass = computed(() => [
+			"rs-tag",
+			`rs-tag--${props.variant}`,
+			`rs-tag--${resolvedSize.value}`,
+			{
+				"rs-tag--closable": props.closable,
+				"rs-tag--disabled": props.disabled,
+				"rs-tag--round": props.round || resolvedRadius.value === "full"
+			}
+		]);
+		const rootStyle = computed(() => ({ "--rs-tag-radius": rsRadiusCss(resolvedRadius.value) }));
+		function onClose(event) {
+			if (props.disabled) return;
+			event.stopPropagation();
+			emit("close", event);
+		}
+		return (_ctx, _cache) => {
+			return openBlock(), createElementBlock("span", {
+				class: normalizeClass(rootClass.value),
+				style: normalizeStyle(rootStyle.value)
+			}, [createElementVNode("span", _hoisted_1, [renderSlot(_ctx.$slots, "default", {}, void 0, true)]), __props.closable ? (openBlock(), createElementBlock("button", {
+				key: 0,
+				type: "button",
+				class: "rs-tag__close",
+				disabled: __props.disabled,
+				"aria-label": unref(t)("tag.close"),
+				onClick: onClose
+			}, [createVNode(RsIcon_default, {
+				name: "x",
+				size: 12
+			})], 8, _hoisted_2)) : createCommentVNode("", true)], 6);
+		};
+	}
+});
+//#endregion
+export { RsTag_vue_vue_type_script_setup_true_lang_default as default };

package/dist/components/tag/src/RsTag.js

@@ -0,0 +1,8 @@
+import './RsTag.css'
+import _plugin_vue_export_helper_default from "../../../_virtual/_plugin-vue_export-helper.js";
+import RsTag_vue_vue_type_script_setup_true_lang_default from "./RsTag.impl.js";
+
+//#region src/components/tag/src/RsTag.vue
+var RsTag_default = /*#__PURE__*/ _plugin_vue_export_helper_default(RsTag_vue_vue_type_script_setup_true_lang_default, [["__scopeId", "data-v-0140d810"]]);
+//#endregion
+export { RsTag_default as default };

package/dist/components/terminal/index.d.ts

@@ -0,0 +1,3 @@
+export { default as RsTerminal } from './src/RsTerminal.js';
+export { buildAnsiColorDemo, containsEscapeSequence, getTerminalThemePalette, mergeTerminalTheme, readTerminalThemeFromCss, resolveTerminalTheme, terminalShortcutLabel, } from './src/terminal-utils';
+export type { RsResolvedTerminalTheme, RsTerminalAction, RsTerminalExpose, RsTerminalGeometry, RsTerminalThemeMode, } from './src/terminal-utils';

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

@@ -0,0 +1,160 @@
+
+.rs-terminal[data-v-69d9aa6d] {
+  position: relative;
+  height: 100%;
+  min-height: 0;
+  /* 作为 flex/grid 项时，xterm 行盒的固有宽度不得撑开轨道，
+     否则容器收窄后列数降不下来、行尾字符会被 overflow 裁掉。 */
+  min-width: 0;
+  border: 1px solid var(--rs-terminal-border);
+  border-radius: var(--rs-radius-md);
+  background: var(--rs-terminal-shell-bg, var(--rs-terminal-bg));
+  color: var(--rs-terminal-fg);
+  box-shadow:
+    inset 0 1px 0 color-mix(in srgb, var(--rs-terminal-fg) 5%, transparent),
+    inset 0 0 0 1px color-mix(in srgb, var(--rs-terminal-fg) 4%, transparent),
+    0 1px 3px color-mix(in srgb, #000 32%, transparent);
+  overflow: hidden;
+}
+[data-rs-theme='light'] .rs-terminal[data-v-69d9aa6d] {
+  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-69d9aa6d] {
+  position: relative;
+  width: 100%;
+  height: 100%;
+  min-height: 0;
+  /* FitAddon 取整余量露底时，与单元格同色（勿用 shell 灰底） */
+  background: var(--rs-terminal-bg);
+}
+.rs-terminal__loading[data-v-69d9aa6d],
+.rs-terminal__overlay[data-v-69d9aa6d] {
+  position: absolute;
+  inset: 0;
+  display: flex;
+  align-items: center;
+  justify-content: center;
+}
+.rs-terminal__overlay[data-v-69d9aa6d] {
+  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);
+  text-align: center;
+  pointer-events: none;
+  font-family: var(--rs-font-mono);
+  font-size: var(--rs-font-size-xs);
+  font-weight: var(--rs-font-weight-regular);
+  line-height: var(--rs-line-height-normal);
+}
+.rs-terminal__overlay--interactive[data-v-69d9aa6d] {
+  pointer-events: auto;
+}
+.rs-terminal__overlay-action[data-v-69d9aa6d] {
+  pointer-events: auto;
+}
+.rs-terminal__search[data-v-69d9aa6d] {
+  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-69d9aa6d] {
+  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-69d9aa6d] {
+  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）。
+ * 它会继承进 xterm 隐藏的字宽测量元素（.xterm-helpers 下的 WidthCache），使 offsetWidth 量到的
+ * 字形比实际渲染窄；而 CharSizeService 走 canvas measureText 不受 CSS 影响、单元格宽是准的。
+ * DOM 渲染器于是按 `cellWidth - 测量值` 给每个字符补正字距，行盒却仍是 cols × cellWidth，
+ * 逐列累积后整行溢出十几到几十像素，被行盒的 overflow:hidden 切掉行尾几个字符。
+ */
+.rs-terminal[data-v-69d9aa6d] .xterm {
+  width: 100%;
+  height: 100%;
+  line-height: normal;
+  letter-spacing: normal;
+}
+
+/*
+ * xterm 6 官方仍给空的 .xterm-viewport 写 overflow-y:scroll + 背景 #000。
+ * 真正滚动的是 .xterm-scrollable-element；空层滚动条会挡住最后一列。
+ */
+.rs-terminal[data-v-69d9aa6d] .xterm .xterm-viewport {
+  overflow: hidden;
+  background-color: transparent;
+}
+
+/*
+ * xterm 兜底的滑块是占满 14px 轨道的直角块，配色取终端前景色 20% 不透明度，与 RsScrollbar
+ * 的圆角胶囊不一致。轨道宽度由 overviewRuler.width 决定，改它会给每个终端实例多建一块
+ * overview ruler 画布，因此只重绘滑块：热区仍是 14px，靠透明边框内缩出 10px 可见胶囊。
+ */
+.rs-terminal[data-v-69d9aa6d] .xterm-scrollable-element > .scrollbar > .slider {
+  box-sizing: border-box;
+  border: var(--rs-scrollbar-padding, 2px) solid transparent;
+  border-radius: var(--rs-radius-full);
+  background-color: color-mix(in srgb, var(--rs-muted) 60%, transparent);
+  background-clip: padding-box;
+  transition: background-color var(--rs-transition-fast);
+}
+.rs-terminal[data-v-69d9aa6d] .xterm-scrollable-element > .scrollbar > .slider:hover {
+  background-color: color-mix(in srgb, var(--rs-primary) 40%, var(--rs-muted));
+}
+.rs-terminal[data-v-69d9aa6d] .xterm-scrollable-element > .scrollbar > .slider.active {
+  background-color: color-mix(in srgb, var(--rs-primary) 55%, var(--rs-muted));
+}
+.rs-terminal--zebra[data-v-69d9aa6d] .xterm-rows,
+.rs-terminal--zebra[data-v-69d9aa6d] .xterm-rows > div,
+.rs-terminal--zebra[data-v-69d9aa6d] .xterm-row {
+  background-color: transparent !important;
+}
+.rs-terminal--zebra[data-v-69d9aa6d] .xterm-scrollable-element {
+  background-color: transparent !important;
+  background-image: repeating-linear-gradient(
+    to bottom,
+    var(--rs-terminal-bg) 0,
+    var(--rs-terminal-bg) var(--rs-terminal-zebra-step, 1lh),
+    var(--rs-terminal-row-stripe) var(--rs-terminal-zebra-step, 1lh),
+    var(--rs-terminal-row-stripe) calc(var(--rs-terminal-zebra-step, 1lh) * 2)
+  );
+  background-attachment: local;
+}
+.rs-terminal--zebra[data-v-69d9aa6d] .xterm-screen {
+  background-color: transparent !important;
+}
+.rs-terminal[data-v-69d9aa6d] .xterm-fg-257 {
+  color: var(--rs-terminal-bg) !important;
+}
+.rs-terminal[data-v-69d9aa6d] .xterm-bg-257 {
+  background-color: var(--rs-terminal-fg) !important;
+}

package/dist/components/terminal/src/RsTerminal.d.ts

@@ -0,0 +1,117 @@
+import type { ITheme } from '@xterm/xterm';
+import '@xterm/xterm/css/xterm.css';
+import type { RsContextMenuItem } from '../../context-menu/src/context-menu-utils';
+import { type RsTerminalAction, type RsTerminalExpose, type RsTerminalThemeMode } from './terminal-utils';
+import { type RsTerminalWheelScrollModifier } from './terminal-wheel';
+type RsTerminalFontWeight = 'normal' | 'bold' | '100' | '200' | '300' | '400' | '500' | '600' | '700' | '800' | '900';
+type __VLS_Props = {
+    loading?: boolean;
+    overlay?: string;
+    inputEnabled?: boolean;
+    cursorBlink?: boolean;
+    /** 缺省读取 `--rs-terminal-font-family` / `--rs-font-mono` */
+    fontFamily?: string;
+    /** 缺省读取 `--rs-terminal-font-size`（对齐 `--rs-font-size-sm`） */
+    fontSize?: number;
+    /** 缺省读取 `--rs-terminal-font-weight` */
+    fontWeight?: RsTerminalFontWeight;
+    /** 缺省读取 `--rs-terminal-font-weight-bold` */
+    fontWeightBold?: RsTerminalFontWeight;
+    allowTransparency?: boolean;
+    /** auto 跟随 data-rs-theme；也可强制 light / dark */
+    themeMode?: RsTerminalThemeMode;
+    /** 覆盖内置调色板中的部分 token */
+    theme?: Partial<ITheme>;
+    contextMenu?: boolean;
+    /** 右键菜单是否展示「询问 AI」（仅 emit，业务侧自行处理） */
+    showAskAi?: boolean;
+    /**
+     * 追加到内置右键菜单（复制/粘贴等）与「清空」之间。
+     * `key` 勿与 copy / paste / selectAll / search / askAi / clear 冲突。
+     */
+    extraContextMenuItems?: RsContextMenuItem[];
+    /**
+     * 右键是否自动选中光标下单词。
+     * SSH/vim/less 等 TUI 场景建议 false，避免冲掉用户已拖选的大段文本。
+     */
+    rightClickSelectsWord?: boolean;
+    shortcuts?: boolean;
+    scrollback?: number;
+    /** 将裸 \\n 当作换行；PTY/SSH 建议 false，避免破坏 ncurses(top/vim) */
+    convertEol?: boolean;
+    /** 奇数行斑马纹底色，提升长日志可读性 */
+    zebraStripes?: boolean;
+    /**
+     * none：滚轮始终翻 scrollback。
+     * shift：普通 shell 翻 scrollback；仅 vim/top 等备用屏把滚轮转成方向键。
+     */
+    wheelScrollModifier?: RsTerminalWheelScrollModifier;
+    /** TUI 全屏刷新时若视口不在底部，自动滚回底部（修复 top 表头丢失） */
+    snapViewportOnTuiWrite?: boolean;
+    /** 鼠标松开时若有选区则复制（接近原生终端 copy-on-select） */
+    copyOnSelect?: boolean;
+    /** 启用 Ctrl/⌘+F 终端内搜索 */
+    searchEnabled?: boolean;
+    /**
+     * 单元格前景相对背景的最低对比度（xterm `minimumContrastRatio`）。
+     * `ls --color` 软链接常用黑底；浅色主题把青/蓝调深后会看不清，4.5 对齐 WCAG AA。
+     * 传 1 关闭。
+     */
+    minimumContrastRatio?: number;
+};
+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;
+        rows: number;
+    }) => any;
+    selectionChange: (text: string) => any;
+    ready: () => any;
+    askAi: (text: string) => any;
+    action: (action: RsTerminalAction) => any;
+    extraSelect: (key: string) => any;
+}, string, import("vue").PublicProps, Readonly<__VLS_Props> & Readonly<{
+    onData?: ((data: string) => any) | undefined;
+    onResize?: ((payload: {
+        cols: number;
+        rows: number;
+    }) => any) | undefined;
+    onSelectionChange?: ((text: string) => any) | undefined;
+    onReady?: (() => any) | undefined;
+    onAskAi?: ((text: string) => any) | undefined;
+    onAction?: ((action: RsTerminalAction) => any) | undefined;
+    onExtraSelect?: ((key: string) => any) | undefined;
+}>, {
+    theme: Partial<ITheme>;
+    loading: boolean;
+    overlay: string;
+    contextMenu: boolean;
+    shortcuts: boolean;
+    inputEnabled: boolean;
+    cursorBlink: boolean;
+    allowTransparency: boolean;
+    themeMode: RsTerminalThemeMode;
+    showAskAi: boolean;
+    extraContextMenuItems: RsContextMenuItem[];
+    rightClickSelectsWord: boolean;
+    scrollback: number;
+    convertEol: boolean;
+    zebraStripes: boolean;
+    wheelScrollModifier: RsTerminalWheelScrollModifier;
+    snapViewportOnTuiWrite: boolean;
+    copyOnSelect: boolean;
+    searchEnabled: boolean;
+    minimumContrastRatio: number;
+}, {}, {}, {}, 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;
+    };
+};