niuma-ui 1.3.4 → 1.3.7

package/CHANGELOG.md

@@ -6,6 +6,26 @@
 
 ## [Unreleased]
 
+## [1.3.7] - 2026-09-15
+
+### 新增
+
+- `RsDropdown`：`size`、`contentWidth="fit"`、菜单项 `hint`。工具条动作菜单走公开档位，不要 `:deep` 改菜单内边距。
+
+## [1.3.6] - 2026-09-14
+
+### 新增
+
+- `RsSplitPane`：`fill`（默认关）铺满父级并拉高插槽根节点，业务不要 `:deep` 改 `.rs-split__pane`。
+- `RsSplitPane`：`collapsible` 只表示可吸附折叠（拖过阈值 / Enter / `collapse()`）。分隔条不画折叠钮，与 Allotment、react-resizable-panels 一致。
+
+## [1.3.5] - 2026-09-12
+
+### 修复
+
+- `RsTerminal`：默认 `minimumContrastRatio=4.5`。浅色主题下 `ls --color` 软链接（黑底叠深色字）不再看不清；传 `1` 可关闭。
+- `RsTerminal`：`fit` 按宿主 `clientWidth/Height` 纠正行列，避免 FitAddon 把 `height: 100%` 算成内容高、PTY 停在默认 80×24。画布仍高出一行再减行。全屏清屏 / 进备用屏才回视口底部。
+
 ## [1.3.4] - 2026-09-11
 
 ### 修复

package/dist/components/RsDropdown.css

@@ -155,3 +155,38 @@
   opacity: 0.38;
   cursor: not-allowed;
 }
+.rs-dropdown__item-copy {
+  display: flex;
+  flex-direction: column;
+  gap: 1px;
+  min-width: 0;
+}
+.rs-dropdown__item-hint {
+  font-size: var(--rs-font-size-xs);
+  color: var(--rs-muted);
+  line-height: var(--rs-line-height-tight);
+  white-space: normal;
+  display: -webkit-box;
+  -webkit-line-clamp: 2;
+  -webkit-box-orient: vertical;
+  overflow: hidden;
+}
+.rs-dropdown__content--fit {
+  min-width: 10.5rem;
+  width: max-content;
+}
+.rs-dropdown__content--ssm .rs-dropdown__item {
+  min-height: 26px;
+  padding: 5px 8px;
+  gap: var(--rs-space-xs);
+  font-size: var(--rs-font-size-xs);
+  align-items: flex-start;
+}
+.rs-dropdown__content--ssm .rs-dropdown__item-icon {
+  margin-top: 2px;
+}
+.rs-dropdown__content--sm .rs-dropdown__item {
+  min-height: 28px;
+  padding: 6px 10px;
+  font-size: var(--rs-font-size-sm);
+}

package/dist/components/RsDropdown.d.ts

@@ -1,10 +1,15 @@
-import { type RsDropdownItems as RsDropdownData } from './dropdown-utils';
+import { type RsDropdownContentWidth, type RsDropdownItems as RsDropdownData } from './dropdown-utils';
+import type { RsComponentSize } from '../theme/types';
 type __VLS_Props = {
     items: RsDropdownData;
     placeholder?: string;
     disabled?: boolean;
     /** 选中后是否在触发器回显选项 label；false 时固定显示 placeholder（操作菜单） */
     showSelected?: boolean;
+    /** 菜单项密度，与控件 size 对齐 */
+    size?: RsComponentSize;
+    /** 菜单宽度；工具条图标按钮用 fit，避免被触发器宽度压扁 */
+    contentWidth?: RsDropdownContentWidth;
 };
 type __VLS_ModelProps = {
     modelValue?: string;
@@ -21,8 +26,10 @@ declare const __VLS_base: import("vue").DefineComponent<__VLS_PublicProps, {}, {
     onSelect?: ((value: string) => any) | undefined;
     "onUpdate:modelValue"?: ((value: string | undefined) => any) | undefined;
 }>, {
+    size: RsComponentSize;
     disabled: boolean;
     showSelected: boolean;
+    contentWidth: RsDropdownContentWidth;
 }, {}, {}, {}, string, import("vue").ComponentProvideOptions, false, {}, any>;
 declare const __VLS_export: __VLS_WithSlots<typeof __VLS_base, __VLS_Slots>;
 declare const _default: typeof __VLS_export;

package/dist/components/RsDropdown.impl.js

@@ -18,7 +18,9 @@ var RsDropdown_vue_vue_type_script_setup_true_lang_default = /*@__PURE__*/ defin
 		showSelected: {
 			type: Boolean,
 			default: true
-		}
+		},
+		size: { default: "md" },
+		contentWidth: { default: "trigger" }
 	}, {
 		"modelValue": {},
 		"modelModifiers": {}
@@ -69,7 +71,7 @@ var RsDropdown_vue_vue_type_script_setup_true_lang_default = /*@__PURE__*/ defin
 					_: 1
 				}, 8, ["disabled"])), createVNode(unref(DropdownMenuPortal), null, {
 					default: withCtx(() => [createVNode(unref(DropdownMenuContent), {
-						class: "rs-dropdown__content",
+						class: normalizeClass(["rs-dropdown__content", [`rs-dropdown__content--${__props.size}`, `rs-dropdown__content--${__props.contentWidth}`]]),
 						"side-offset": 4
 					}, {
 						default: withCtx(() => [__props.showSelected ? (openBlock(), createBlock(unref(DropdownMenuRadioGroup), {
@@ -79,16 +81,18 @@ var RsDropdown_vue_vue_type_script_setup_true_lang_default = /*@__PURE__*/ defin
 						}, {
 							default: withCtx(() => [createVNode(RsDropdownItems_default, {
 								items: __props.items,
+								size: __props.size,
 								selectable: ""
-							}, null, 8, ["items"])]),
+							}, null, 8, ["items", "size"])]),
 							_: 1
 						}, 8, ["modelValue"])) : (openBlock(), createBlock(RsDropdownItems_default, {
 							key: 1,
 							items: __props.items,
+							size: __props.size,
 							onSelect
-						}, null, 8, ["items"]))]),
+						}, null, 8, ["items", "size"]))]),
 						_: 1
-					})]),
+					}, 8, ["class"])]),
 					_: 1
 				})]),
 				_: 3

package/dist/components/RsDropdownItemView.d.ts

@@ -0,0 +1,11 @@
+import type { RsDropdownItem } from './dropdown-utils';
+import { type RsComponentSize } from '../theme/types';
+type __VLS_Props = {
+    item: RsDropdownItem;
+    size?: RsComponentSize;
+};
+declare const __VLS_export: import("vue").DefineComponent<__VLS_Props, {}, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {}, string, import("vue").PublicProps, Readonly<__VLS_Props> & Readonly<{}>, {
+    size: RsComponentSize;
+}, {}, {}, {}, string, import("vue").ComponentProvideOptions, false, {}, any>;
+declare const _default: typeof __VLS_export;
+export default _default;

package/dist/components/RsDropdownItemView.impl.js

@@ -0,0 +1,32 @@
+import RsIcon_default from "./RsIcon.js";
+import { RS_COMPONENT_SIZE_ICON_PX } from "../theme/types.js";
+import { Fragment, computed, createBlock, createCommentVNode, createElementBlock, createElementVNode, defineComponent, openBlock, toDisplayString } from "vue";
+//#region src/components/RsDropdownItemView.vue?vue&type=script&setup=true&lang.ts
+var _hoisted_1 = { class: "rs-dropdown__item-copy" };
+var _hoisted_2 = { class: "rs-dropdown__item-label" };
+var _hoisted_3 = {
+	key: 0,
+	class: "rs-dropdown__item-hint"
+};
+var RsDropdownItemView_vue_vue_type_script_setup_true_lang_default = /*@__PURE__*/ defineComponent({
+	__name: "RsDropdownItemView",
+	props: {
+		item: {},
+		size: { default: "md" }
+	},
+	setup(__props) {
+		/** 下拉项内容：图标 + 标题 + 可选说明，密度由 size 控制。 */
+		const props = __props;
+		const iconSize = computed(() => RS_COMPONENT_SIZE_ICON_PX[props.size]);
+		return (_ctx, _cache) => {
+			return openBlock(), createElementBlock(Fragment, null, [__props.item.icon ? (openBlock(), createBlock(RsIcon_default, {
+				key: 0,
+				name: __props.item.icon,
+				size: iconSize.value,
+				class: "rs-dropdown__item-icon"
+			}, null, 8, ["name", "size"])) : createCommentVNode("", true), createElementVNode("span", _hoisted_1, [createElementVNode("span", _hoisted_2, toDisplayString(__props.item.label), 1), __props.item.hint ? (openBlock(), createElementBlock("span", _hoisted_3, toDisplayString(__props.item.hint), 1)) : createCommentVNode("", true)])], 64);
+		};
+	}
+});
+//#endregion
+export { RsDropdownItemView_vue_vue_type_script_setup_true_lang_default as default };

package/dist/components/RsDropdownItemView.js

@@ -0,0 +1,5 @@
+import RsDropdownItemView_vue_vue_type_script_setup_true_lang_default from "./RsDropdownItemView.impl.js";
+//#region src/components/RsDropdownItemView.vue
+var RsDropdownItemView_default = RsDropdownItemView_vue_vue_type_script_setup_true_lang_default;
+//#endregion
+export { RsDropdownItemView_default as default };

package/dist/components/RsDropdownItems.d.ts

@@ -1,14 +1,17 @@
 import { type RsDropdownItems } from './dropdown-utils';
+import type { RsComponentSize } from '../theme/types';
 type __VLS_Props = {
     items: RsDropdownItems;
     /** true：单选互斥；false：操作项 */
     selectable?: boolean;
+    size?: RsComponentSize;
 };
 declare const __VLS_export: import("vue").DefineComponent<__VLS_Props, {}, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {
     select: (value: string) => any;
 }, string, import("vue").PublicProps, Readonly<__VLS_Props> & Readonly<{
     onSelect?: ((value: string) => any) | undefined;
 }>, {
+    size: RsComponentSize;
     selectable: boolean;
 }, {}, {}, {}, string, import("vue").ComponentProvideOptions, false, {}, any>;
 declare const _default: typeof __VLS_export;

package/dist/components/RsDropdownItems.impl.js

@@ -1,12 +1,8 @@
-import RsIcon_default from "./RsIcon.js";
 import { DropdownMenuGroup, DropdownMenuItem, DropdownMenuLabel, DropdownMenuRadioItem } from "./reka.js";
 import { isDropdownItemGroup } from "./dropdown-utils.js";
-import { Fragment, createBlock, createCommentVNode, createElementBlock, createElementVNode, createTextVNode, createVNode, defineComponent, openBlock, renderList, toDisplayString, unref, withCtx } from "vue";
+import RsDropdownItemView_default from "./RsDropdownItemView.js";
+import { Fragment, createBlock, createElementBlock, createTextVNode, createVNode, defineComponent, openBlock, renderList, toDisplayString, unref, withCtx } from "vue";
 //#region src/components/RsDropdownItems.vue?vue&type=script&setup=true&lang.ts
-var _hoisted_1 = { class: "rs-dropdown__item-label" };
-var _hoisted_2 = { class: "rs-dropdown__item-label" };
-var _hoisted_3 = { class: "rs-dropdown__item-label" };
-var _hoisted_4 = { class: "rs-dropdown__item-label" };
 var RsDropdownItems_vue_vue_type_script_setup_true_lang_default = /*@__PURE__*/ defineComponent({
 	__name: "RsDropdownItems",
 	props: {
@@ -14,7 +10,8 @@ var RsDropdownItems_vue_vue_type_script_setup_true_lang_default = /*@__PURE__*/
 		selectable: {
 			type: Boolean,
 			default: false
-		}
+		},
+		size: { default: "md" }
 	},
 	emits: ["select"],
 	setup(__props, { emit: __emit }) {
@@ -26,7 +23,7 @@ var RsDropdownItems_vue_vue_type_script_setup_true_lang_default = /*@__PURE__*/
 		return (_ctx, _cache) => {
 			return openBlock(true), createElementBlock(Fragment, null, renderList(__props.items, (entry, index) => {
 				return openBlock(), createElementBlock(Fragment, { key: index }, [unref(isDropdownItemGroup)(entry) ? (openBlock(), createBlock(unref(DropdownMenuGroup), {
-					key: 0,
+					key: `group-${index}`,
 					class: "rs-dropdown__group"
 				}, {
 					default: withCtx(() => [createVNode(unref(DropdownMenuLabel), { class: "rs-dropdown__group-label" }, {
@@ -39,12 +36,10 @@ var RsDropdownItems_vue_vue_type_script_setup_true_lang_default = /*@__PURE__*/
 							disabled: item.disabled,
 							class: "rs-dropdown__item"
 						}, {
-							default: withCtx(() => [item.icon ? (openBlock(), createBlock(RsIcon_default, {
-								key: 0,
-								name: item.icon,
-								size: 16,
-								class: "rs-dropdown__item-icon"
-							}, null, 8, ["name"])) : createCommentVNode("", true), createElementVNode("span", _hoisted_1, toDisplayString(item.label), 1)]),
+							default: withCtx(() => [createVNode(RsDropdownItemView_default, {
+								item,
+								size: __props.size
+							}, null, 8, ["item", "size"])]),
 							_: 2
 						}, 1032, ["value", "disabled"]);
 					}), 128)) : (openBlock(true), createElementBlock(Fragment, { key: 1 }, renderList(entry.options, (item) => {
@@ -54,41 +49,35 @@ var RsDropdownItems_vue_vue_type_script_setup_true_lang_default = /*@__PURE__*/
 							class: "rs-dropdown__item",
 							onSelect: ($event) => onActionSelect(item)
 						}, {
-							default: withCtx(() => [item.icon ? (openBlock(), createBlock(RsIcon_default, {
-								key: 0,
-								name: item.icon,
-								size: 16,
-								class: "rs-dropdown__item-icon"
-							}, null, 8, ["name"])) : createCommentVNode("", true), createElementVNode("span", _hoisted_2, toDisplayString(item.label), 1)]),
+							default: withCtx(() => [createVNode(RsDropdownItemView_default, {
+								item,
+								size: __props.size
+							}, null, 8, ["item", "size"])]),
 							_: 2
 						}, 1032, ["disabled", "onSelect"]);
 					}), 128))]),
 					_: 2
 				}, 1024)) : __props.selectable ? (openBlock(), createBlock(unref(DropdownMenuRadioItem), {
-					key: entry.value,
+					key: `radio-${entry.value}`,
 					value: entry.value,
 					disabled: entry.disabled,
 					class: "rs-dropdown__item"
 				}, {
-					default: withCtx(() => [entry.icon ? (openBlock(), createBlock(RsIcon_default, {
-						key: 0,
-						name: entry.icon,
-						size: 16,
-						class: "rs-dropdown__item-icon"
-					}, null, 8, ["name"])) : createCommentVNode("", true), createElementVNode("span", _hoisted_3, toDisplayString(entry.label), 1)]),
+					default: withCtx(() => [createVNode(RsDropdownItemView_default, {
+						item: entry,
+						size: __props.size
+					}, null, 8, ["item", "size"])]),
 					_: 2
 				}, 1032, ["value", "disabled"])) : (openBlock(), createBlock(unref(DropdownMenuItem), {
-					key: entry.value,
+					key: `action-${entry.value}`,
 					disabled: entry.disabled,
 					class: "rs-dropdown__item",
 					onSelect: ($event) => onActionSelect(entry)
 				}, {
-					default: withCtx(() => [entry.icon ? (openBlock(), createBlock(RsIcon_default, {
-						key: 0,
-						name: entry.icon,
-						size: 16,
-						class: "rs-dropdown__item-icon"
-					}, null, 8, ["name"])) : createCommentVNode("", true), createElementVNode("span", _hoisted_4, toDisplayString(entry.label), 1)]),
+					default: withCtx(() => [createVNode(RsDropdownItemView_default, {
+						item: entry,
+						size: __props.size
+					}, null, 8, ["item", "size"])]),
 					_: 2
 				}, 1032, ["disabled", "onSelect"]))], 64);
 			}), 128);

package/dist/components/RsSplitPane.css

@@ -22,6 +22,18 @@
   min-height: 0;
   overflow: hidden;
 }
+
+/* fill：面板当弹性列，插槽根节点吃满。业务改自己的内容，不要 :deep 本组件。 */
+.rs-split--fill > .rs-split__pane:not(.rs-split__pane--auto) {
+  display: flex;
+  flex-direction: column;
+}
+.rs-split--fill > .rs-split__pane:not(.rs-split__pane--auto) > * {
+  flex: 1 1 auto;
+  min-width: 0;
+  min-height: 0;
+  width: 100%;
+}
 .rs-split__pane--auto {
   /* 内容撑开；超出 max 时在面板内滚动 */
   overflow: auto;

package/dist/components/RsSplitPane.d.ts

@@ -10,6 +10,11 @@ type __VLS_Props = {
     keyboardStep?: number;
     /** 在分隔条中央展示抓手（grip）指示 */
     withHandle?: boolean;
+    /**
+     * 面板铺满父级，并把插槽根节点拉高。
+     * 默认关，不改变原有内容尺寸；工作台 / 设置页显式打开，避免 :deep。
+     */
+    fill?: boolean;
 };
 type __VLS_ModelProps = {
     /** 各面板尺寸（百分比，总和 100） */
@@ -36,6 +41,7 @@ declare const __VLS_base: import("vue").DefineComponent<__VLS_PublicProps, RsSpl
     onCollapse?: ((key: string) => any) | undefined;
     "onUpdate:sizes"?: ((value: number[]) => any) | undefined;
 }>, {
+    fill: boolean;
     disabled: boolean;
     orientation: RsSplitOrientation;
     keyboardStep: number;

package/dist/components/RsSplitPane.impl.js

@@ -40,6 +40,10 @@ var RsSplitPane_vue_vue_type_script_setup_true_lang_default = /*@__PURE__*/ defi
 		withHandle: {
 			type: Boolean,
 			default: false
+		},
+		fill: {
+			type: Boolean,
+			default: false
 		}
 	}, {
 		"sizes": { default: () => [] },
@@ -369,7 +373,10 @@ var RsSplitPane_vue_vue_type_script_setup_true_lang_default = /*@__PURE__*/ defi
 			return openBlock(), createElementBlock("div", {
 				ref_key: "rootRef",
 				ref: rootRef,
-				class: normalizeClass(["rs-split", [`rs-split--${__props.orientation}`, { "rs-split--disabled": __props.disabled }]])
+				class: normalizeClass(["rs-split", [`rs-split--${__props.orientation}`, {
+					"rs-split--disabled": __props.disabled,
+					"rs-split--fill": __props.fill
+				}]])
 			}, [(openBlock(true), createElementBlock(Fragment, null, renderList(__props.panes, (pane, index) => {
 				return openBlock(), createElementBlock(Fragment, { key: pane.key }, [createElementVNode("div", {
 					class: normalizeClass(["rs-split__pane", {

package/dist/components/RsTerminal.css

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

package/dist/components/RsTerminal.d.ts

@@ -46,6 +46,12 @@ type __VLS_Props = {
     copyOnSelect?: boolean;
     /** 启用 Ctrl/⌘+F 终端内搜索 */
     searchEnabled?: boolean;
+    /**
+     * 单元格前景相对背景的最低对比度（xterm `minimumContrastRatio`）。
+     * `ls --color` 软链接常用黑底；浅色主题把青/蓝调深后会看不清，4.5 对齐 WCAG AA。
+     * 传 1 关闭。
+     */
+    minimumContrastRatio?: number;
 };
 declare var __VLS_15: {};
 type __VLS_Slots = {} & {
@@ -90,6 +96,7 @@ declare const __VLS_base: import("vue").DefineComponent<__VLS_Props, RsTerminalE
     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;

package/dist/components/RsTerminal.impl.js

@@ -3,7 +3,7 @@ import RsLoading_default from "./RsLoading.js";
 import RsContextMenu_default from "./RsContextMenu.js";
 import { beginClipboardPrefetch, copyTextToClipboard, readClipboardText } from "../utils/rs-clipboard.js";
 import { readTerminalFontFamily, readTerminalFontSizePx, readTerminalFontWeight, readTerminalFontWeightBold } from "../theme/css-token.js";
-import { containsTuiRefreshSequence, mergeTerminalTheme, prepareTerminalForPtyWrite, resolveTerminalTheme, terminalShortcutLabel } from "./terminal-utils.js";
+import { mergeTerminalTheme, needsPtyWriteViewportPrep, prepareTerminalForPtyWrite, proposeTerminalGeometry, readXtermCssCellSize, resolveTerminalTheme, 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 { FitAddon } from "@xterm/addon-fit";
@@ -85,7 +85,8 @@ var RsTerminal_vue_vue_type_script_setup_true_lang_default = /*@__PURE__*/ defin
 		searchEnabled: {
 			type: Boolean,
 			default: false
-		}
+		},
+		minimumContrastRatio: { default: 4.5 }
 	},
 	emits: [
 		"ready",
@@ -268,14 +269,37 @@ var RsTerminal_vue_vue_type_script_setup_true_lang_default = /*@__PURE__*/ defin
 			if (!fitAddon || !terminal) return;
 			try {
 				fitAddon.fit();
-			} catch {
-				return;
-			}
+			} catch {}
 			didInitialFit = true;
-			emitResizeIfChanged();
+			applyHostBoxGeometry();
+			trimOverflowRow();
 			syncZebraRowStepFromDom();
+			emitResizeIfChanged();
 			syncResolvedFontSize();
 		}
+		/** 以 host client 盒为准，纠正 FitAddon 把 100% 高度 parseInt 成内容高（默认 24 行）的情况。 */
+		function applyHostBoxGeometry() {
+			if (!terminal || !hostEl.value) return;
+			const cell = readXtermCssCellSize(terminal);
+			if (!cell) return;
+			const proposed = proposeTerminalGeometry(hostEl.value.clientWidth, hostEl.value.clientHeight, cell.width, cell.height);
+			if (!proposed) return;
+			const cols = Math.max(proposed.cols, 20);
+			const rows = Math.max(proposed.rows, 5);
+			if (cols !== terminal.cols || rows !== terminal.rows) terminal.resize(cols, rows);
+		}
+		/** 画布比宿主高出超过一行时再减行，避免裁掉最后一行。 */
+		function trimOverflowRow() {
+			if (!terminal || !hostEl.value) return;
+			const screen = hostEl.value.querySelector(".xterm-screen");
+			if (!screen) return;
+			const overflow = screen.offsetHeight - hostEl.value.clientHeight;
+			if (overflow <= 1) return;
+			const cell = readXtermCssCellSize(terminal);
+			const cut = cell ? Math.max(1, Math.ceil(overflow / cell.height)) : 1;
+			const nextRows = Math.max(5, terminal.rows - cut);
+			if (nextRows < terminal.rows) terminal.resize(terminal.cols, nextRows);
+		}
 		function scheduleFit() {
 			if (fitRaf) return;
 			fitRaf = requestAnimationFrame(() => {
@@ -286,7 +310,7 @@ var RsTerminal_vue_vue_type_script_setup_true_lang_default = /*@__PURE__*/ defin
 		function write(data) {
 			const term = terminal;
 			if (!term) return;
-			if (props.snapViewportOnTuiWrite && containsTuiRefreshSequence(data)) prepareTerminalForPtyWrite(term, data);
+			if (props.snapViewportOnTuiWrite && needsPtyWriteViewportPrep(data, term)) prepareTerminalForPtyWrite(term, data);
 			term.write(data);
 		}
 		function clear() {
@@ -488,6 +512,9 @@ var RsTerminal_vue_vue_type_script_setup_true_lang_default = /*@__PURE__*/ defin
 		});
 		watch(() => [props.themeMode, props.theme], refreshResolvedTheme, { deep: true });
 		watch(() => props.wheelScrollModifier, attachWheelGuard);
+		watch(() => props.minimumContrastRatio, (value) => {
+			if (terminal) terminal.options.minimumContrastRatio = value;
+		});
 		onMounted(async () => {
 			if (!hostEl.value) return;
 			refreshResolvedTheme();
@@ -501,6 +528,7 @@ var RsTerminal_vue_vue_type_script_setup_true_lang_default = /*@__PURE__*/ defin
 				letterSpacing: 0,
 				allowTransparency: resolveAllowTransparency(),
 				drawBoldTextInBrightColors: true,
+				minimumContrastRatio: props.minimumContrastRatio,
 				scrollback: props.scrollback,
 				convertEol: props.convertEol,
 				rightClickSelectsWord: props.rightClickSelectsWord,

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-fba85f3c"]]);
+var RsTerminal_default = /*#__PURE__*/ _plugin_vue_export_helper_default(RsTerminal_vue_vue_type_script_setup_true_lang_default, [["__scopeId", "data-v-db06bdc1"]]);
 //#endregion
 export { RsTerminal_default as default };

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

@@ -2,6 +2,8 @@ export interface RsDropdownItem {
     label: string;
     value: string;
     icon?: string;
+    /** 次要说明，工具条动作菜单等场景使用 */
+    hint?: string;
     disabled?: boolean;
 }
 export interface RsDropdownItemGroup {
@@ -9,5 +11,7 @@ export interface RsDropdownItemGroup {
     options: RsDropdownItem[];
 }
 export type RsDropdownItems = RsDropdownItem[] | RsDropdownItemGroup[];
+/** 菜单宽度：trigger 对齐触发器；fit 随内容，不跟窄图标按钮 */
+export type RsDropdownContentWidth = 'trigger' | 'fit';
 export declare function isDropdownItemGroup(item: RsDropdownItem | RsDropdownItemGroup): item is RsDropdownItemGroup;
 export declare function flattenDropdownItems(items: RsDropdownItems): RsDropdownItem[];

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

@@ -40,6 +40,27 @@ export declare function readTerminalRowStripeFromCss(mode: RsResolvedTerminalThe
 export declare function containsEscapeSequence(data: string): boolean;
 /** 检测 ncurses/vim/top 等全屏刷新常用的光标定位与清屏序列 */
 export declare function containsTuiRefreshSequence(data: string): boolean;
+/**
+ * 按宿主像素高度与实测行高计算能完整放下的行数。
+ * FitAddon 用理论 cellHeight，亚像素取整后行盒往往更高，多报的行会被 overflow 裁掉
+ *（top 按 1 展开几十上百核时，最后几行 CPU 就像被高度挡住）。
+ */
+export declare function computeFittedTerminalRows(hostHeight: number, rowHeight: number, minRows?: number): number | null;
+/** 读取 xterm 当前 CSS 单元格尺寸（与 FitAddon 同一套私有 dimensions）。 */
+export declare function readXtermCssCellSize(terminal: Terminal): {
+    width: number;
+    height: number;
+} | null;
+/**
+ * 用宿主 client 宽高算行列，避开 FitAddon 对 computed `height: 100%` 走 parseInt 的偏差。
+ * 偏差时 PTY 会停在默认 80×24，`top` 按 1 就只画二十来行 CPU。
+ */
+export declare function proposeTerminalGeometry(hostWidth: number, hostHeight: number, cellWidth: number, cellHeight: number, scrollbarWidth?: number): {
+    cols: number;
+    rows: number;
+} | null;
+/** 进入备用屏（smcup），top/vim 全屏时常走这条 */
+export declare function containsAltScreenEnter(data: string): boolean;
 /** 全屏清屏（top/vim 新一轮绘制常见） */
 export declare function containsFullScreenClear(data: string): boolean;
 /** 数据块以光标归位首行开头（top 每轮刷新常见） */
@@ -50,6 +71,11 @@ export declare function startsWithCursorHome(data: string): boolean;
  */
 export declare function resetLocalTerminalModes(terminal: Terminal): void;
 export declare function snapTerminalViewportToBottom(terminal: Terminal): void;
+/**
+ * 是否要在写入前校正视口。
+ * 只认清屏 / 进备用屏 / 已在备用屏且视口不在底部；普通 `\x1b[H` 不碰，以免把用户翻的 scrollback 拽回去。
+ */
+export declare function needsPtyWriteViewportPrep(data: string, terminal: Terminal): boolean;
 /** 处理 PTY 写入前的视口/模式准备（不移动写入光标，避免输入错位） */
 export declare function prepareTerminalForPtyWrite(terminal: Terminal, data: string): void;
 export declare function isMacPlatform(): boolean;

package/dist/components/terminal-utils.js

@@ -145,6 +145,32 @@ function containsTuiRefreshSequence(data) {
 	return TUI_REFRESH_PATTERN.test(data);
 }
 var FULL_SCREEN_CLEAR_PATTERN = /\x1b\[[0-9;]*2J|\x1b\[[0-9;]*3J/;
+var ALT_SCREEN_ENTER_PATTERN = /\x1b\[\?1049h|\x1b\[\?47h|\x1b\[1049h/;
+var DEFAULT_TERMINAL_SCROLLBAR_PX = 14;
+/** 读取 xterm 当前 CSS 单元格尺寸（与 FitAddon 同一套私有 dimensions）。 */
+function readXtermCssCellSize(terminal) {
+	const cell = terminal._core?._renderService?.dimensions?.css?.cell;
+	if (!cell || cell.width < 1 || cell.height < 1) return null;
+	return {
+		width: cell.width,
+		height: cell.height
+	};
+}
+/**
+* 用宿主 client 宽高算行列，避开 FitAddon 对 computed `height: 100%` 走 parseInt 的偏差。
+* 偏差时 PTY 会停在默认 80×24，`top` 按 1 就只画二十来行 CPU。
+*/
+function proposeTerminalGeometry(hostWidth, hostHeight, cellWidth, cellHeight, scrollbarWidth = DEFAULT_TERMINAL_SCROLLBAR_PX) {
+	if (hostWidth <= 0 || hostHeight <= 0 || cellWidth < 1 || cellHeight < 1) return null;
+	return {
+		cols: Math.max(2, Math.floor((hostWidth - scrollbarWidth) / cellWidth)),
+		rows: Math.max(1, Math.floor(hostHeight / cellHeight))
+	};
+}
+/** 进入备用屏（smcup），top/vim 全屏时常走这条 */
+function containsAltScreenEnter(data) {
+	return ALT_SCREEN_ENTER_PATTERN.test(data);
+}
 /** 全屏清屏（top/vim 新一轮绘制常见） */
 function containsFullScreenClear(data) {
 	return FULL_SCREEN_CLEAR_PATTERN.test(data);
@@ -159,10 +185,24 @@ function resetLocalTerminalModes(terminal) {
 function snapTerminalViewportToBottom(terminal) {
 	terminal.scrollToBottom();
 }
+/**
+* 是否要在写入前校正视口。
+* 只认清屏 / 进备用屏 / 已在备用屏且视口不在底部；普通 `\x1b[H` 不碰，以免把用户翻的 scrollback 拽回去。
+*/
+function needsPtyWriteViewportPrep(data, terminal) {
+	if (containsFullScreenClear(data) || containsAltScreenEnter(data)) return true;
+	if (terminal.buffer.active.type !== "alternate") return false;
+	return containsTuiRefreshSequence(data) && terminal.buffer.active.viewportY < terminal.buffer.active.baseY;
+}
 /** 处理 PTY 写入前的视口/模式准备（不移动写入光标，避免输入错位） */
 function prepareTerminalForPtyWrite(terminal, data) {
 	if (containsFullScreenClear(data)) {
 		resetLocalTerminalModes(terminal);
+		snapTerminalViewportToBottom(terminal);
+		return;
+	}
+	if (containsAltScreenEnter(data)) {
+		snapTerminalViewportToBottom(terminal);
 		return;
 	}
 	const buffer = terminal.buffer.active;
@@ -203,8 +243,13 @@ function buildAnsiColorDemo() {
 		"\x1B[1mStyles\x1B[0m  \x1B[1mbold\x1B[0m  \x1B[3mitalic\x1B[0m  \x1B[4munderline\x1B[0m  \x1B[9mstrikethrough\x1B[0m",
 		"",
 		"\x1B[38;5;196m256-color\x1B[0m sample:",
-		gradient
+		gradient,
+		"",
+		"\x1B[1mls --color symlink\x1B[0m",
+		`  23 Apr  1  2024 \x1b[01;36mbusiness-logs -> /wmsdata/business-logs/\x1b[0m`,
+		`  23 Apr  1  2024 \x1b[01;36;40mbusiness-logs -> /wmsdata/business-logs/\x1b[0m`,
+		`  23 Apr  1  2024 \x1b[40;31;01mbusiness-logs -> /wmsdata/business-logs/\x1b[0m`
 	].join("\r\n")}\r\n`;
 }
 //#endregion
-export { buildAnsiColorDemo, containsEscapeSequence, containsFullScreenClear, containsTuiRefreshSequence, getTerminalThemePalette, isMacPlatform, mergeTerminalTheme, normalizeTerminalHexColor, prepareTerminalForPtyWrite, readTerminalThemeFromCss, resetLocalTerminalModes, resolveCssColorForXterm, resolveTerminalTheme, snapTerminalViewportToBottom, terminalShortcutLabel };
+export { buildAnsiColorDemo, containsAltScreenEnter, containsEscapeSequence, containsFullScreenClear, containsTuiRefreshSequence, getTerminalThemePalette, isMacPlatform, mergeTerminalTheme, needsPtyWriteViewportPrep, normalizeTerminalHexColor, prepareTerminalForPtyWrite, proposeTerminalGeometry, readTerminalThemeFromCss, readXtermCssCellSize, resetLocalTerminalModes, resolveCssColorForXterm, resolveTerminalTheme, snapTerminalViewportToBottom, terminalShortcutLabel };

package/dist/index.d.ts

@@ -109,7 +109,7 @@ export type { RsContainerBreakpoint, RsContainerGap, RsContainerMaxWidth, RsCont
 export type { RsBreadcrumbItem } from './components/RsBreadcrumb.js';
 export type { RsToolbarBorder, RsToolbarSize } from './components/RsToolbar.js';
 export type { RsContextMenuItem } from './components/context-menu-utils';
-export type { RsDropdownItem, RsDropdownItemGroup, RsDropdownItems } from './components/dropdown-utils';
+export type { RsDropdownContentWidth, RsDropdownItem, RsDropdownItemGroup, RsDropdownItems } from './components/dropdown-utils';
 export type { RsMenuItem, RsMenuItemGroup, RsMenuItems } from './components/menu-utils';
 export type { RsScrollbarOrientation, RsScrollbarType } from './components/scrollbar-utils';
 export type { RsSelectFieldNames, RsSelectFilterOption, RsSelectFilterSort, RsSelectGetPopupContainer, RsSelectLabeledValue, RsSelectModelValue, RsSelectResolvedModel, RsSelectOption, RsSelectOptionFilterProp, RsSelectOptionGroup, RsSelectOptionInput, RsSelectOptions, RsSelectOptionsInput, RsSelectPlacement, RsSelectStatus, RsSelectMaxTagCount, RsSelectVariant, RsSelectValue, } from './components/select-utils';

package/dist/locale/messages.js

@@ -144,6 +144,8 @@ var zhCN = {
 	"tree.drag": "拖拽排序",
 	"split.label": "面板分割",
 	"split.resize": "拖动调整面板尺寸",
+	"split.collapse": "收起面板",
+	"split.expand": "展开面板",
 	"drawer.resize": "拖动调整抽屉尺寸",
 	"terminal.copy": "复制",
 	"terminal.paste": "粘贴",
@@ -374,6 +376,8 @@ var enUS = {
 	"tree.drag": "Drag to reorder",
 	"split.label": "Split panes",
 	"split.resize": "Drag to resize panes",
+	"split.collapse": "Collapse pane",
+	"split.expand": "Expand pane",
 	"drawer.resize": "Drag to resize the drawer",
 	"terminal.copy": "Copy",
 	"terminal.paste": "Paste",

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "niuma-ui",
-  "version": "1.3.4",
+  "version": "1.3.7",
   "license": "Apache-2.0",
   "type": "module",
   "description": "Vue 3 工作台设计系统（Rs* 组件、--rs-* token；含可选编辑器 / 终端）",