niuma-ui 2.0.3 → 2.0.9

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

@@ -13,10 +13,33 @@ export interface RsTabItem {
     /** 是否可重命名；未设置时继承 RsTabs 的 renamable */
     renamable?: boolean;
 }
-/** 选项卡尺寸 */
-export type RsTabsSize = 'sm' | 'md';
+/** 选项卡尺寸（ssm 由 ConfigProvider 落入时按 sm） */
+export type RsTabsSize = 'sm' | 'md' | 'lg';
 /** line 下划线 · segmented 胶囊 · card 卡片（Ant editable-card） */
 export type RsTabsVariant = 'line' | 'segmented' | 'card';
+/** 标签栏位置（对齐 Ant / Element tabPosition） */
+export type RsTabsPosition = 'top' | 'bottom' | 'left' | 'right';
+/**
+ * 键盘激活方式（WAI-ARIA APG）。
+ * automatic：方向键同时移动焦点并切换；manual：方向键只移焦点，Enter / Space 才切换。
+ */
+export type RsTabsActivation = 'automatic' | 'manual';
+/** `#tab` 插槽参数 */
+export interface RsTabsTabSlot {
+    item: RsTabItem;
+    active: boolean;
+    disabled: boolean;
+}
+export interface RsTabsExpose {
+    /** 把焦点放到指定标签；未传则落到当前激活项 */
+    focus: (value?: string) => void;
+    /** 走 beforeLeave 后切换。被拦截时返回 false */
+    selectTab: (value: string) => Promise<boolean>;
+}
+/** 模板 ref 实例：expose + 根节点 */
+export type RsTabsInstance = RsTabsExpose & {
+    $el: HTMLElement;
+};
 /**
  * 标签栏对齐：start 左齐 · center 居中 · evenly 均分空隙 · stretch 项等宽铺满。
  * 用于登录等场景，避免业务侧 :deep 改 list/trigger。
@@ -69,3 +92,19 @@ export interface ResolveVisibleTabOptions {
  * 根据各标签宽度与可用宽度，计算应展示的标签 value 集合。
  */
 export declare function resolveVisibleTabValues(items: RsTabItem[], widths: Map<string, number>, availableWidth: number, activeValue: string, reservedWidth?: number, options?: ResolveVisibleTabOptions): Set<string>;
+export declare function isVerticalTabsPosition(position: RsTabsPosition): boolean;
+export declare function getEnabledTabValues(items: readonly RsTabItem[]): string[];
+/** 在可启用项里按 delta 环移（跳过 disabled） */
+export declare function getAdjacentTabValue(items: readonly RsTabItem[], current: string, delta: number): string | undefined;
+export declare function getEdgeTabValue(items: readonly RsTabItem[], edge: 'start' | 'end'): string | undefined;
+/**
+ * 解析标签栏键盘位移。竖排只用上下；横排左右在 RTL 下对调。
+ * Home / End 返回端点；不处理的键返回 null。
+ */
+export declare function resolveTabKeyboardMove(key: string, position: RsTabsPosition, rtl?: boolean): number | 'start' | 'end' | null;
+export declare function sanitizeTabDomId(value: string): string;
+export declare function tabTriggerId(rootId: string, value: string): string;
+export declare function tabPanelId(rootId: string, value: string): string;
+/** lazy：首次激活才挂；destroyInactive：离开即卸。后者优先。 */
+export declare function shouldRenderTabPanel(value: string, activeValue: string, visited: ReadonlySet<string>, lazy: boolean, destroyInactive: boolean): boolean;
+export declare function resolveTabsSize(size: string | undefined): RsTabsSize;

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

@@ -143,5 +143,59 @@ function resolveVisibleTabValues(items, widths, availableWidth, activeValue, res
 	}
 	return new Set(visible);
 }
+function isVerticalTabsPosition(position) {
+	return position === "left" || position === "right";
+}
+function getEnabledTabValues(items) {
+	return items.filter((item) => !item.disabled).map((item) => item.value);
+}
+/** 在可启用项里按 delta 环移（跳过 disabled） */
+function getAdjacentTabValue(items, current, delta) {
+	const enabled = getEnabledTabValues(items);
+	if (!enabled.length) return void 0;
+	const index = enabled.indexOf(current);
+	return enabled[(Math.max(index, 0) + delta + enabled.length * 8) % enabled.length];
+}
+function getEdgeTabValue(items, edge) {
+	const enabled = getEnabledTabValues(items);
+	if (!enabled.length) return void 0;
+	return edge === "start" ? enabled[0] : enabled.at(-1);
+}
+/**
+* 解析标签栏键盘位移。竖排只用上下；横排左右在 RTL 下对调。
+* Home / End 返回端点；不处理的键返回 null。
+*/
+function resolveTabKeyboardMove(key, position, rtl = false) {
+	if (key === "Home") return "start";
+	if (key === "End") return "end";
+	if (isVerticalTabsPosition(position)) {
+		if (key === "ArrowUp") return -1;
+		if (key === "ArrowDown") return 1;
+		return null;
+	}
+	if (key === "ArrowLeft") return rtl ? 1 : -1;
+	if (key === "ArrowRight") return rtl ? -1 : 1;
+	return null;
+}
+function sanitizeTabDomId(value) {
+	return value.replace(/[^a-zA-Z0-9_-]+/g, "-").replace(/^-/, "").replace(/-$/, "") || "tab";
+}
+function tabTriggerId(rootId, value) {
+	return `${rootId}-tab-${sanitizeTabDomId(value)}`;
+}
+function tabPanelId(rootId, value) {
+	return `${rootId}-panel-${sanitizeTabDomId(value)}`;
+}
+/** lazy：首次激活才挂；destroyInactive：离开即卸。后者优先。 */
+function shouldRenderTabPanel(value, activeValue, visited, lazy, destroyInactive) {
+	if (destroyInactive) return value === activeValue;
+	if (!lazy) return true;
+	return value === activeValue || visited.has(value);
+}
+function resolveTabsSize(size) {
+	if (size === "lg") return "lg";
+	if (size === "sm" || size === "ssm") return "sm";
+	return "md";
+}
 //#endregion
-export { buildTabContextMenuItems, getNextTabAfterBatchClose, getNextTabAfterClose, isTabClosable, isTabFixed, isTabRenamable, reorderTabItems, resolveTabsToClose, resolveVisibleTabValues };
+export { buildTabContextMenuItems, getAdjacentTabValue, getEdgeTabValue, getEnabledTabValues, getNextTabAfterBatchClose, getNextTabAfterClose, isTabClosable, isTabFixed, isTabRenamable, isVerticalTabsPosition, reorderTabItems, resolveTabKeyboardMove, resolveTabsSize, resolveTabsToClose, resolveVisibleTabValues, sanitizeTabDomId, shouldRenderTabPanel, tabPanelId, tabTriggerId };

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

@@ -1,3 +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';
+export type { RsResolvedTerminalTheme, RsTerminalAction, RsTerminalCursorStyle, RsTerminalExpose, RsTerminalGeometry, RsTerminalThemeMode, } from './src/terminal-utils';

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

@@ -1,5 +1,5 @@
 
-.rs-terminal[data-v-fcddd3a1] {
+.rs-terminal[data-v-79324a27] {
   position: relative;
   height: 100%;
   min-height: 0;
@@ -10,19 +10,10 @@
   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);
+  box-shadow: var(--rs-shadow-sm);
   overflow: hidden;
 }
-[data-rs-theme='light'] .rs-terminal[data-v-fcddd3a1] {
-  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-fcddd3a1] {
+.rs-terminal__host[data-v-79324a27] {
   position: relative;
   width: 100%;
   height: 100%;
@@ -30,19 +21,19 @@
   /* FitAddon 取整余量露底时，与单元格同色（勿用 shell 灰底） */
   background: var(--rs-terminal-bg);
 }
-.rs-terminal__loading[data-v-fcddd3a1],
-.rs-terminal__overlay[data-v-fcddd3a1] {
+.rs-terminal__loading[data-v-79324a27],
+.rs-terminal__overlay[data-v-79324a27] {
   position: absolute;
   inset: 0;
   display: flex;
   align-items: center;
   justify-content: center;
 }
-.rs-terminal__overlay[data-v-fcddd3a1] {
+.rs-terminal__overlay[data-v-79324a27] {
   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%);
+  color: var(--rs-terminal-fg);
   background: color-mix(in srgb, var(--rs-terminal-bg) 84%, transparent);
   text-align: center;
   pointer-events: none;
@@ -51,28 +42,32 @@
   font-weight: var(--rs-font-weight-regular);
   line-height: var(--rs-line-height-normal);
 }
-.rs-terminal__overlay--interactive[data-v-fcddd3a1] {
+.rs-terminal__overlay--interactive[data-v-79324a27] {
   pointer-events: auto;
 }
-.rs-terminal__overlay-action[data-v-fcddd3a1] {
+.rs-terminal__overlay-action[data-v-79324a27] {
   pointer-events: auto;
 }
-.rs-terminal__search[data-v-fcddd3a1] {
+.rs-terminal__search[data-v-79324a27] {
   position: absolute;
-  top: var(--rs-space-xs);
+  inset-block-start: var(--rs-space-xs);
   inset-inline-end: var(--rs-space-xs);
   z-index: 2;
   display: flex;
+  flex-wrap: wrap;
   align-items: center;
+  max-inline-size: calc(100% - var(--rs-space-sm));
   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-fcddd3a1] {
-  width: 12rem;
-  padding: 0.2rem 0.4rem;
+.rs-terminal__search-input[data-v-79324a27] {
+  inline-size: 12rem;
+  max-inline-size: 100%;
+  padding-block: var(--rs-space-xs);
+  padding-inline: var(--rs-space-xs);
   border: 1px solid var(--rs-terminal-border);
   border-radius: var(--rs-radius-sm);
   background: var(--rs-terminal-bg);
@@ -81,8 +76,14 @@
   font-size: var(--rs-font-size-xs);
   outline: none;
 }
-.rs-terminal__search-btn[data-v-fcddd3a1] {
-  padding: 0.2rem 0.4rem;
+.rs-terminal__search-input[data-v-79324a27]:focus-visible,
+.rs-terminal__search-btn[data-v-79324a27]:focus-visible {
+  outline: var(--rs-focus-ring-width, 2px) solid var(--rs-focus-border);
+  outline-offset: 1px;
+}
+.rs-terminal__search-btn[data-v-79324a27] {
+  padding-block: var(--rs-space-xs);
+  padding-inline: var(--rs-space-xs);
   border: 1px solid var(--rs-terminal-border);
   border-radius: var(--rs-radius-sm);
   background: transparent;
@@ -90,6 +91,11 @@
   font-size: var(--rs-font-size-xs);
   cursor: pointer;
 }
+.rs-terminal__search-status[data-v-79324a27] {
+  margin: 0;
+  color: var(--rs-text-secondary);
+  font-size: var(--rs-font-size-xs);
+}
 
 /*
  * letter-spacing 必须在终端内归零：宿主应用常在祖先上设负字距（NiuMa 的 .nm-app 是 -0.011em）。
@@ -98,7 +104,7 @@
  * DOM 渲染器于是按 `cellWidth - 测量值` 给每个字符补正字距，行盒却仍是 cols × cellWidth，
  * 逐列累积后整行溢出十几到几十像素，被行盒的 overflow:hidden 切掉行尾几个字符。
  */
-.rs-terminal[data-v-fcddd3a1] .xterm {
+.rs-terminal[data-v-79324a27] .xterm {
   width: 100%;
   height: 100%;
   line-height: normal;
@@ -109,7 +115,7 @@
  * xterm 6 官方仍给空的 .xterm-viewport 写 overflow-y:scroll + 背景 #000。
  * 真正滚动的是 .xterm-scrollable-element；空层滚动条会挡住最后一列。
  */
-.rs-terminal[data-v-fcddd3a1] .xterm .xterm-viewport {
+.rs-terminal[data-v-79324a27] .xterm .xterm-viewport {
   overflow: hidden;
   background-color: transparent;
 }
@@ -119,7 +125,7 @@
  * 的圆角胶囊不一致。轨道宽度由 overviewRuler.width 决定，改它会给每个终端实例多建一块
  * overview ruler 画布，因此只重绘滑块：热区仍是 14px，靠透明边框内缩出 10px 可见胶囊。
  */
-.rs-terminal[data-v-fcddd3a1] .xterm-scrollable-element > .scrollbar > .slider {
+.rs-terminal[data-v-79324a27] .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 +133,35 @@
   background-clip: padding-box;
   transition: background-color var(--rs-transition-fast);
 }
-.rs-terminal[data-v-fcddd3a1] .xterm-scrollable-element > .scrollbar > .slider:hover {
+@media (prefers-reduced-motion: reduce) {
+.rs-terminal[data-v-79324a27] .xterm-scrollable-element > .scrollbar > .slider {
+    transition: none;
+}
+}
+@media (forced-colors: active) {
+.rs-terminal[data-v-79324a27] {
+    background: Canvas;
+    color: CanvasText;
+    border-color: ButtonText;
+    box-shadow: none;
+}
+.rs-terminal__search-input[data-v-79324a27]:focus-visible,
+  .rs-terminal__search-btn[data-v-79324a27]:focus-visible {
+    outline: var(--rs-focus-ring-width, 2px) solid Highlight;
+}
+}
+.rs-terminal[data-v-79324a27] .xterm-scrollable-element > .scrollbar > .slider:hover {
   background-color: color-mix(in srgb, var(--rs-primary) 40%, var(--rs-muted));
 }
-.rs-terminal[data-v-fcddd3a1] .xterm-scrollable-element > .scrollbar > .slider.active {
+.rs-terminal[data-v-79324a27] .xterm-scrollable-element > .scrollbar > .slider.active {
   background-color: color-mix(in srgb, var(--rs-primary) 55%, var(--rs-muted));
 }
-.rs-terminal--zebra[data-v-fcddd3a1] .xterm-rows,
-.rs-terminal--zebra[data-v-fcddd3a1] .xterm-rows > div,
-.rs-terminal--zebra[data-v-fcddd3a1] .xterm-row {
+.rs-terminal--zebra[data-v-79324a27] .xterm-rows,
+.rs-terminal--zebra[data-v-79324a27] .xterm-rows > div,
+.rs-terminal--zebra[data-v-79324a27] .xterm-row {
   background-color: transparent !important;
 }
-.rs-terminal--zebra[data-v-fcddd3a1] .xterm-scrollable-element {
+.rs-terminal--zebra[data-v-79324a27] .xterm-scrollable-element {
   background-color: transparent !important;
   background-image: repeating-linear-gradient(
     to bottom,
@@ -149,12 +172,12 @@
   );
   background-attachment: local;
 }
-.rs-terminal--zebra[data-v-fcddd3a1] .xterm-screen {
+.rs-terminal--zebra[data-v-79324a27] .xterm-screen {
   background-color: transparent !important;
 }
-.rs-terminal[data-v-fcddd3a1] .xterm-fg-257 {
+.rs-terminal[data-v-79324a27] .xterm-fg-257 {
   color: var(--rs-terminal-bg) !important;
 }
-.rs-terminal[data-v-fcddd3a1] .xterm-bg-257 {
+.rs-terminal[data-v-79324a27] .xterm-bg-257 {
   background-color: var(--rs-terminal-fg) !important;
 }

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

@@ -1,7 +1,7 @@
 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 RsTerminalAction, type RsTerminalCursorStyle, 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 = {
@@ -32,7 +32,8 @@ type __VLS_Props = {
     extraContextMenuItems?: RsContextMenuItem[];
     /**
      * 右键是否自动选中光标下单词。
-     * SSH/vim/less 等 TUI 场景建议 false，避免冲掉用户已拖选的大段文本。
+     * 已经有拖选时不会缩成一个词，避免滚选大段文本时选区跳一下。
+     * SSH/vim/less 等 TUI 场景建议 false。
      */
     rightClickSelectsWord?: boolean;
     shortcuts?: boolean;
@@ -52,6 +53,27 @@ type __VLS_Props = {
     copyOnSelect?: boolean;
     /** 启用 Ctrl/⌘+F 终端内搜索 */
     searchEnabled?: boolean;
+    /** 光标形状。缺省 block，与 xterm 一致。 */
+    cursorStyle?: RsTerminalCursorStyle;
+    /**
+     * 读屏模式。缺省关闭：打开后 xterm 会为每次光标移动暴露辅助节点。
+     * 需要 NVDA / VoiceOver 跟随时再开。
+     */
+    screenReaderMode?: boolean;
+    /**
+     * 点击 http(s) / mailto 时用新标签打开。
+     * 设为 false 时只发 `link`，由宿主决定。javascript: 与 data: 一律忽略。
+     */
+    openLinks?: boolean;
+    /**
+     * 单格宽、字形却更宽的字符（GB18030 歧义宽度）按格缩放。
+     * 缺省开启。DOM 渲染器下无效。
+     */
+    rescaleOverlappingGlyphs?: boolean;
+    /** 区域的可访问名称。未传走 terminal.label。 */
+    ariaLabel?: string;
+    /** 根节点 id。 */
+    id?: string;
     /**
      * 单元格前景相对背景的最低对比度（xterm `minimumContrastRatio`）。
      * `ls --color` 软链接常用黑底；浅色主题把青/蓝调深后会看不清，4.5 对齐 WCAG AA。
@@ -64,33 +86,40 @@ 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, {
+    link: (url: string) => any;
     data: (data: string) => any;
     resize: (payload: {
         cols: number;
         rows: number;
     }) => any;
+    bell: () => any;
+    action: (action: RsTerminalAction) => any;
     selectionChange: (text: string) => any;
     ready: () => any;
     askAi: (text: string) => any;
-    action: (action: RsTerminalAction) => any;
     extraSelect: (key: string) => any;
+    titleChange: (title: string) => any;
 }, string, import("vue").PublicProps, Readonly<__VLS_Props> & Readonly<{
+    onLink?: ((url: string) => any) | undefined;
     onData?: ((data: string) => any) | undefined;
     onResize?: ((payload: {
         cols: number;
         rows: number;
     }) => any) | undefined;
+    onBell?: (() => any) | undefined;
+    onAction?: ((action: RsTerminalAction) => 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;
+    onTitleChange?: ((title: string) => any) | undefined;
 }>, {
     theme: Partial<ITheme>;
     overlay: string;
     loading: boolean;
     contextMenu: boolean;
     shortcuts: boolean;
+    cursorStyle: RsTerminalCursorStyle;
     inputEnabled: boolean;
     cursorBlink: boolean;
     allowTransparency: boolean;
@@ -105,6 +134,9 @@ declare const __VLS_base: import("vue").DefineComponent<__VLS_Props, RsTerminalE
     snapViewportOnTuiWrite: boolean;
     copyOnSelect: boolean;
     searchEnabled: boolean;
+    screenReaderMode: boolean;
+    openLinks: boolean;
+    rescaleOverlappingGlyphs: boolean;
     minimumContrastRatio: number;
 }, {}, {}, {}, string, import("vue").ComponentProvideOptions, false, {}, any>;
 declare const __VLS_export: __VLS_WithSlots<typeof __VLS_base, __VLS_Slots>;