niuma-ui 1.3.8 → 2.0.0

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

@@ -0,0 +1,3 @@
+export { default as RsTabs } from './src/RsTabs.js';
+export type { RsTabItem, RsTabsCloseAction, RsTabsContentGap, RsTabsOverflow, RsTabsSize, RsTabsJustify, RsTabsVariant, } from './src/tabs-utils';
+export { buildTabContextMenuItems, getNextTabAfterBatchClose, getNextTabAfterClose, isTabClosable, isTabFixed, isTabRenamable, reorderTabItems, resolveTabsToClose, resolveVisibleTabValues, } from './src/tabs-utils';

package/dist/components/tabs/src/RsTabs.impl.js

@@ -0,0 +1,526 @@
+import { useRsI18n } from "../../../composables/useRsI18n.js";
+import RsIcon_default from "../../icon/src/RsIcon.js";
+import { DropdownMenuContent, DropdownMenuItem, DropdownMenuPortal, DropdownMenuRoot, DropdownMenuTrigger, TabsContent, TabsList, TabsRoot, TabsTrigger } from "../../_shared/src/reka.js";
+import { buildTabContextMenuItems, getNextTabAfterBatchClose, getNextTabAfterClose, isTabClosable, isTabFixed, isTabRenamable, resolveTabsToClose } from "./tabs-utils.js";
+import { useRsTabsNav } from "../../../composables/useRsTabsNav.js";
+import RsContextMenu_default from "../../context-menu/src/RsContextMenu.js";
+import { Fragment, computed, createBlock, createCommentVNode, createElementBlock, createElementVNode, createTextVNode, createVNode, defineComponent, mergeModels, mergeProps, nextTick, normalizeClass, openBlock, ref, renderList, renderSlot, toDisplayString, unref, useModel, useSlots, vModelText, withCtx, withDirectives, withKeys, withModifiers } from "vue";
+//#region src/components/tabs/src/RsTabs.vue?vue&type=script&setup=true&lang.ts
+var _hoisted_1 = ["data-tab-value"];
+var _hoisted_2 = { class: "rs-tabs__label" };
+var _hoisted_3 = {
+	key: 1,
+	class: "rs-tabs__badge"
+};
+var _hoisted_4 = ["aria-label"];
+var _hoisted_5 = [
+	"aria-label",
+	"placeholder",
+	"onKeydown",
+	"onBlur"
+];
+var _hoisted_6 = ["title", "onDblclick"];
+var _hoisted_7 = {
+	key: 4,
+	class: "rs-tabs__badge"
+};
+var _hoisted_8 = [
+	"aria-label",
+	"disabled",
+	"onClick"
+];
+var _hoisted_9 = { class: "rs-tabs__more-label" };
+var _hoisted_10 = ["aria-label"];
+var _hoisted_11 = ["aria-label"];
+var _hoisted_12 = { class: "rs-tabs__panel-inner" };
+var RsTabs_vue_vue_type_script_setup_true_lang_default = /*@__PURE__*/ defineComponent({
+	__name: "RsTabs",
+	props: /*@__PURE__*/ mergeModels({
+		items: {},
+		size: { default: "md" },
+		variant: { default: "line" },
+		panelless: {
+			type: Boolean,
+			default: false
+		},
+		borderless: {
+			type: Boolean,
+			default: false
+		},
+		contentGap: { default: "none" },
+		justify: { default: "start" },
+		closable: {
+			type: Boolean,
+			default: false
+		},
+		addable: {
+			type: Boolean,
+			default: false
+		},
+		maxCount: {},
+		renamable: {
+			type: Boolean,
+			default: false
+		},
+		draggable: {
+			type: Boolean,
+			default: false
+		},
+		overflow: {
+			type: [String, Boolean],
+			default: false
+		},
+		contextMenu: {
+			type: Boolean,
+			default: false
+		},
+		beforeLeave: {}
+	}, {
+		"modelValue": { required: true },
+		"modelModifiers": {}
+	}),
+	emits: /*@__PURE__*/ mergeModels([
+		"close",
+		"closeBatch",
+		"add",
+		"rename",
+		"reorder",
+		"contextMenu"
+	], ["update:modelValue"]),
+	setup(__props, { emit: __emit }) {
+		const model = useModel(__props, "modelValue");
+		const props = __props;
+		const emit = __emit;
+		const slots = useSlots();
+		const { t } = useRsI18n();
+		const itemsRef = computed(() => props.items);
+		const overflowMode = computed(() => props.overflow);
+		const hasExtra = computed(() => Boolean(slots.extra));
+		const canAdd = computed(() => {
+			if (!props.addable) return false;
+			if (props.maxCount == null) return true;
+			return props.items.length < props.maxCount;
+		});
+		const navRef = ref(null);
+		const measureRef = ref(null);
+		const overflowWrapRef = ref(null);
+		const extraRef = ref(null);
+		const { navViewportRef, useDropdownOverflow, useScrollOverflow, visibleTabItems, hiddenItems, overflowMenuItems, activeInHidden, showOverflowMenu, canScrollPrev, canScrollNext, scrollNav, onNavScroll, scheduleLayout } = useRsTabsNav({
+			items: itemsRef,
+			activeValue: model,
+			overflow: overflowMode,
+			canAdd,
+			navRef,
+			measureRef,
+			overflowRef: overflowWrapRef,
+			extraRef,
+			addButtonWidth: 36
+		});
+		const renamingValue = ref(null);
+		const renameDraft = ref("");
+		const dragValue = ref(null);
+		const dragOverValue = ref(null);
+		let renameInputEl = null;
+		let leaveLock = false;
+		function setRenameInputRef(el, item) {
+			if (!(el instanceof HTMLInputElement) || renamingValue.value !== item.value) return;
+			renameInputEl = el;
+			nextTick(() => {
+				renameInputEl?.focus();
+				renameInputEl?.select();
+			});
+		}
+		const tabBarItems = computed(() => useDropdownOverflow.value ? visibleTabItems.value : props.items);
+		const moreLabel = computed(() => {
+			if (activeInHidden.value) return props.items.find((item) => item.value === model.value)?.label ?? t("tabs.more");
+			if (hiddenItems.value.length > 0) return `${t("tabs.more")} (${hiddenItems.value.length})`;
+			return t("tabs.more");
+		});
+		const contextMenuLabels = computed(() => ({
+			close: t("tabs.closeTab"),
+			closeOthers: t("tabs.closeOthers"),
+			closeLeft: t("tabs.closeLeft"),
+			closeRight: t("tabs.closeRight"),
+			closeAll: t("tabs.closeAll")
+		}));
+		function closeAriaLabel(item) {
+			return t("tabs.close", "Close {label}").replace("{label}", item.label);
+		}
+		function contextItemsFor(item) {
+			return buildTabContextMenuItems(props.items, item, props.closable, contextMenuLabels.value);
+		}
+		function labelTitle(item) {
+			return item.label.length > 12 ? item.label : void 0;
+		}
+		async function onSelectTab(next) {
+			const value = String(next);
+			if (value === model.value || leaveLock) return;
+			if (props.beforeLeave) {
+				leaveLock = true;
+				try {
+					if (await props.beforeLeave(value, model.value) === false) return;
+				} finally {
+					leaveLock = false;
+				}
+			}
+			model.value = value;
+		}
+		function applyCloseValues(values, action, anchor) {
+			if (!values.length) return;
+			if (action === "close" && values.length === 1) {
+				const closed = values[0];
+				const next = getNextTabAfterClose(props.items, closed, model.value);
+				if (next && model.value === closed) model.value = next;
+				emit("close", closed);
+				return;
+			}
+			const next = getNextTabAfterBatchClose(props.items.filter((item) => !values.includes(item.value)), model.value, anchor);
+			if (next !== void 0 && next !== model.value) model.value = next;
+			else if (next === void 0) model.value = "";
+			emit("closeBatch", values, action, anchor);
+		}
+		function onCloseTab(item) {
+			if (item.disabled || !isTabClosable(item, props.closable)) return;
+			applyCloseValues([item.value], "close", item.value);
+		}
+		function onContextSelect(actionKey, item) {
+			const action = actionKey;
+			if (![
+				"close",
+				"others",
+				"left",
+				"right",
+				"all"
+			].includes(action)) return;
+			const values = resolveTabsToClose(props.items, action, item.value, props.closable);
+			emit("contextMenu", action, item.value);
+			applyCloseValues(values, action, item.value);
+		}
+		function onAddTab() {
+			if (!canAdd.value) return;
+			emit("add");
+		}
+		function onOverflowSelect(value) {
+			onSelectTab(value);
+		}
+		/** 中键关闭（对齐浏览器 / VS Code 页签） */
+		function onTabAuxClick(item, event) {
+			if (event.button !== 1) return;
+			event.preventDefault();
+			onCloseTab(item);
+		}
+		/** 纵向滚轮转为横向滚动（scroll 溢出模式） */
+		function onNavWheel(event) {
+			if (!useScrollOverflow.value) return;
+			const viewport = navViewportRef.value;
+			if (!viewport) return;
+			if (Math.abs(event.deltaY) <= Math.abs(event.deltaX)) return;
+			if (viewport.scrollWidth <= viewport.clientWidth) return;
+			event.preventDefault();
+			viewport.scrollLeft += event.deltaY;
+			onNavScroll();
+		}
+		async function startRename(item) {
+			if (!isTabRenamable(item, props.renamable) || item.disabled) return;
+			renamingValue.value = item.value;
+			renameDraft.value = item.label;
+		}
+		function cancelRename() {
+			renamingValue.value = null;
+			renameDraft.value = "";
+			renameInputEl = null;
+		}
+		function commitRename(item) {
+			if (renamingValue.value !== item.value) return;
+			const label = renameDraft.value.trim();
+			if (label && label !== item.label) emit("rename", item.value, label);
+			cancelRename();
+		}
+		function canDragItem(item) {
+			return props.draggable && !item.disabled && !isTabFixed(item);
+		}
+		function onDragStart(item, event) {
+			if (!canDragItem(item)) {
+				event.preventDefault();
+				return;
+			}
+			const target = event.target;
+			if (target instanceof Element && target.closest(".rs-tabs__close, .rs-tabs__rename-input")) {
+				event.preventDefault();
+				return;
+			}
+			dragValue.value = item.value;
+			event.dataTransfer?.setData("text/plain", item.value);
+			if (event.dataTransfer) event.dataTransfer.effectAllowed = "move";
+		}
+		function onDragOver(item, event) {
+			if (!props.draggable || !dragValue.value || dragValue.value === item.value) return;
+			if (isTabFixed(item)) return;
+			event.preventDefault();
+			dragOverValue.value = item.value;
+		}
+		function onDragLeave(item) {
+			if (dragOverValue.value === item.value) dragOverValue.value = null;
+		}
+		function onDrop(item, event) {
+			if (!props.draggable || !dragValue.value) return;
+			event.preventDefault();
+			if (dragValue.value !== item.value && !isTabFixed(item)) emit("reorder", dragValue.value, item.value);
+			dragValue.value = null;
+			dragOverValue.value = null;
+			scheduleLayout();
+		}
+		function onDragEnd() {
+			dragValue.value = null;
+			dragOverValue.value = null;
+		}
+		return (_ctx, _cache) => {
+			return openBlock(), createBlock(unref(TabsRoot), {
+				"model-value": model.value,
+				class: normalizeClass(["rs-tabs", [
+					`rs-tabs--${__props.variant}`,
+					`rs-tabs--${__props.size}`,
+					`rs-tabs--justify-${__props.justify}`,
+					`rs-tabs--content-gap-${__props.contentGap}`,
+					{
+						"rs-tabs--panelless": __props.panelless,
+						"rs-tabs--borderless": __props.borderless,
+						"rs-tabs--scrollable": unref(useScrollOverflow),
+						"rs-tabs--dropdown-overflow": unref(useDropdownOverflow),
+						"rs-tabs--has-extra": hasExtra.value,
+						"rs-tabs--draggable": __props.draggable
+					}
+				]]),
+				"aria-label": unref(t)("tabs.label"),
+				"onUpdate:modelValue": onSelectTab
+			}, {
+				default: withCtx(() => [createElementVNode("div", { class: normalizeClass(__props.panelless ? "rs-tabs__shell" : "rs-tabs__body") }, [
+					unref(useDropdownOverflow) ? (openBlock(), createElementBlock("div", {
+						key: 0,
+						ref_key: "measureRef",
+						ref: measureRef,
+						class: "rs-tabs__measure",
+						"aria-hidden": "true"
+					}, [(openBlock(true), createElementBlock(Fragment, null, renderList(__props.items, (item) => {
+						return openBlock(), createElementBlock("button", {
+							key: `measure-${item.value}`,
+							type: "button",
+							class: normalizeClass(["rs-tabs__trigger rs-tabs__measure-trigger", `rs-tabs__trigger--${__props.size}`]),
+							"data-tab-value": item.value,
+							tabindex: "-1"
+						}, [
+							item.icon ? (openBlock(), createBlock(RsIcon_default, {
+								key: 0,
+								name: item.icon,
+								size: 14,
+								class: "rs-tabs__icon"
+							}, null, 8, ["name"])) : createCommentVNode("", true),
+							createElementVNode("span", _hoisted_2, toDisplayString(item.label), 1),
+							item.badge != null && item.badge !== "" ? (openBlock(), createElementBlock("span", _hoisted_3, toDisplayString(item.badge), 1)) : createCommentVNode("", true)
+						], 10, _hoisted_1);
+					}), 128))], 512)) : createCommentVNode("", true),
+					createElementVNode("div", {
+						ref_key: "navRef",
+						ref: navRef,
+						class: "rs-tabs__nav"
+					}, [
+						unref(useScrollOverflow) && unref(canScrollPrev) ? (openBlock(), createElementBlock("button", {
+							key: 0,
+							type: "button",
+							class: "rs-tabs__scroll-btn rs-tabs__scroll-btn--prev",
+							"aria-label": unref(t)("tabs.scrollPrev"),
+							onClick: _cache[0] || (_cache[0] = ($event) => unref(scrollNav)(-1))
+						}, [createVNode(RsIcon_default, {
+							name: "chevron-left",
+							size: 14
+						})], 8, _hoisted_4)) : createCommentVNode("", true),
+						createElementVNode("div", mergeProps({
+							ref_key: "navViewportRef",
+							ref: navViewportRef,
+							class: "rs-tabs__nav-viewport",
+							onScrollPassive: _cache[9] || (_cache[9] = (...args) => unref(onNavScroll) && unref(onNavScroll)(...args))
+						}, unref(useScrollOverflow) ? { onWheel: onNavWheel } : {}), [createVNode(unref(TabsList), { class: "rs-tabs__list" }, {
+							default: withCtx(() => [(openBlock(true), createElementBlock(Fragment, null, renderList(tabBarItems.value, (item) => {
+								return openBlock(), createBlock(RsContextMenu_default, {
+									key: item.value,
+									items: contextItemsFor(item),
+									disabled: !__props.contextMenu,
+									onSelect: (key) => onContextSelect(key, item)
+								}, {
+									default: withCtx(() => [createVNode(unref(TabsTrigger), {
+										value: item.value,
+										disabled: item.disabled,
+										class: normalizeClass(["rs-tabs__trigger", {
+											"rs-tabs__trigger--dragging": dragValue.value === item.value,
+											"rs-tabs__trigger--drag-over": dragOverValue.value === item.value,
+											"rs-tabs__trigger--fixed": unref(isTabFixed)(item),
+											"rs-tabs__trigger--movable": canDragItem(item)
+										}]),
+										"data-tab-value": item.value,
+										"data-fixed": unref(isTabFixed)(item) ? "true" : void 0,
+										draggable: canDragItem(item) || void 0,
+										onDragstart: ($event) => onDragStart(item, $event),
+										onDragover: ($event) => onDragOver(item, $event),
+										onDragleave: ($event) => onDragLeave(item),
+										onDrop: ($event) => onDrop(item, $event),
+										onDragend: onDragEnd,
+										onAuxclick: ($event) => onTabAuxClick(item, $event)
+									}, {
+										default: withCtx(() => [
+											unref(isTabFixed)(item) ? (openBlock(), createBlock(RsIcon_default, {
+												key: 0,
+												name: "pin",
+												size: 12,
+												class: "rs-tabs__pin"
+											})) : createCommentVNode("", true),
+											item.icon ? (openBlock(), createBlock(RsIcon_default, {
+												key: 1,
+												name: item.icon,
+												size: 14,
+												class: "rs-tabs__icon"
+											}, null, 8, ["name"])) : createCommentVNode("", true),
+											renamingValue.value === item.value ? withDirectives((openBlock(), createElementBlock("input", {
+												key: 2,
+												ref_for: true,
+												ref: (el) => setRenameInputRef(el, item),
+												"onUpdate:modelValue": _cache[1] || (_cache[1] = ($event) => renameDraft.value = $event),
+												class: "rs-tabs__rename-input",
+												"aria-label": unref(t)("tabs.rename"),
+												placeholder: unref(t)("tabs.renamePlaceholder"),
+												draggable: "false",
+												onKeydown: [withKeys(withModifiers(($event) => commitRename(item), ["prevent"]), ["enter"]), withKeys(withModifiers(cancelRename, ["prevent"]), ["escape"])],
+												onBlur: ($event) => commitRename(item),
+												onMousedown: _cache[2] || (_cache[2] = withModifiers(() => {}, ["stop"])),
+												onClick: _cache[3] || (_cache[3] = withModifiers(() => {}, ["stop"])),
+												onDblclick: _cache[4] || (_cache[4] = withModifiers(() => {}, ["stop"])),
+												onDragstart: _cache[5] || (_cache[5] = withModifiers(() => {}, ["stop", "prevent"]))
+											}, null, 40, _hoisted_5)), [[vModelText, renameDraft.value]]) : (openBlock(), createElementBlock("span", {
+												key: 3,
+												class: "rs-tabs__label",
+												title: labelTitle(item),
+												onDblclick: withModifiers(($event) => startRename(item), ["stop"])
+											}, toDisplayString(item.label), 41, _hoisted_6)),
+											item.badge != null && item.badge !== "" ? (openBlock(), createElementBlock("span", _hoisted_7, toDisplayString(item.badge), 1)) : createCommentVNode("", true),
+											unref(isTabClosable)(item, __props.closable) ? (openBlock(), createElementBlock("button", {
+												key: 5,
+												type: "button",
+												class: "rs-tabs__close",
+												"aria-label": closeAriaLabel(item),
+												disabled: item.disabled,
+												draggable: "false",
+												onMousedown: _cache[6] || (_cache[6] = withModifiers(() => {}, ["stop", "prevent"])),
+												onClick: withModifiers(($event) => onCloseTab(item), ["stop"]),
+												onAuxclick: _cache[7] || (_cache[7] = withModifiers(() => {}, ["stop", "prevent"])),
+												onDragstart: _cache[8] || (_cache[8] = withModifiers(() => {}, ["stop", "prevent"]))
+											}, [createVNode(RsIcon_default, {
+												name: "x",
+												size: 12
+											})], 40, _hoisted_8)) : createCommentVNode("", true)
+										]),
+										_: 2
+									}, 1032, [
+										"value",
+										"disabled",
+										"class",
+										"data-tab-value",
+										"data-fixed",
+										"draggable",
+										"onDragstart",
+										"onDragover",
+										"onDragleave",
+										"onDrop",
+										"onAuxclick"
+									])]),
+									_: 2
+								}, 1032, [
+									"items",
+									"disabled",
+									"onSelect"
+								]);
+							}), 128))]),
+							_: 1
+						})], 16),
+						unref(showOverflowMenu) ? (openBlock(), createElementBlock("div", {
+							key: 1,
+							ref_key: "overflowWrapRef",
+							ref: overflowWrapRef,
+							class: "rs-tabs__overflow-wrap"
+						}, [createVNode(unref(DropdownMenuRoot), null, {
+							default: withCtx(() => [createVNode(unref(DropdownMenuTrigger), { class: normalizeClass(["rs-tabs__more", { "rs-tabs__more--active": unref(activeInHidden) }]) }, {
+								default: withCtx(() => [createElementVNode("span", _hoisted_9, toDisplayString(moreLabel.value), 1), createVNode(RsIcon_default, {
+									name: "chevron-down",
+									size: 14,
+									class: "rs-tabs__more-icon"
+								})]),
+								_: 1
+							}, 8, ["class"]), createVNode(unref(DropdownMenuPortal), null, {
+								default: withCtx(() => [createVNode(unref(DropdownMenuContent), {
+									class: "rs-tabs__more-menu",
+									"side-offset": 4,
+									align: "end"
+								}, {
+									default: withCtx(() => [(openBlock(true), createElementBlock(Fragment, null, renderList(unref(overflowMenuItems), (item) => {
+										return openBlock(), createBlock(unref(DropdownMenuItem), {
+											key: item.value,
+											class: normalizeClass(["rs-tabs__more-item", { "rs-tabs__more-item--active": model.value === item.value }]),
+											onSelect: ($event) => onOverflowSelect(item.value)
+										}, {
+											default: withCtx(() => [createTextVNode(toDisplayString(item.label), 1)]),
+											_: 2
+										}, 1032, ["class", "onSelect"]);
+									}), 128))]),
+									_: 1
+								})]),
+								_: 1
+							})]),
+							_: 1
+						})], 512)) : createCommentVNode("", true),
+						canAdd.value ? (openBlock(), createElementBlock("button", {
+							key: 2,
+							type: "button",
+							class: "rs-tabs__add",
+							"aria-label": unref(t)("tabs.add"),
+							onClick: onAddTab
+						}, [createVNode(RsIcon_default, {
+							name: "plus",
+							size: 14
+						})], 8, _hoisted_10)) : createCommentVNode("", true),
+						unref(useScrollOverflow) && unref(canScrollNext) ? (openBlock(), createElementBlock("button", {
+							key: 3,
+							type: "button",
+							class: "rs-tabs__scroll-btn rs-tabs__scroll-btn--next",
+							"aria-label": unref(t)("tabs.scrollNext"),
+							onClick: _cache[10] || (_cache[10] = ($event) => unref(scrollNav)(1))
+						}, [createVNode(RsIcon_default, {
+							name: "chevron-right",
+							size: 14
+						})], 8, _hoisted_11)) : createCommentVNode("", true),
+						hasExtra.value ? (openBlock(), createElementBlock("div", {
+							key: 4,
+							ref_key: "extraRef",
+							ref: extraRef,
+							class: "rs-tabs__extra"
+						}, [renderSlot(_ctx.$slots, "extra")], 512)) : createCommentVNode("", true)
+					], 512),
+					!__props.panelless ? (openBlock(true), createElementBlock(Fragment, { key: 1 }, renderList(__props.items, (item) => {
+						return openBlock(), createBlock(unref(TabsContent), {
+							key: `panel-${item.value}`,
+							value: item.value,
+							class: "rs-tabs__panel"
+						}, {
+							default: withCtx(() => [createElementVNode("div", _hoisted_12, [renderSlot(_ctx.$slots, item.value)])]),
+							_: 2
+						}, 1032, ["value"]);
+					}), 128)) : createCommentVNode("", true)
+				], 2)]),
+				_: 3
+			}, 8, [
+				"model-value",
+				"class",
+				"aria-label"
+			]);
+		};
+	}
+});
+//#endregion
+export { RsTabs_vue_vue_type_script_setup_true_lang_default as default };

package/dist/components/tabs/src/RsTabs.js

@@ -0,0 +1,7 @@
+import './RsTabs.css'
+import RsTabs_vue_vue_type_script_setup_true_lang_default from "./RsTabs.impl.js";
+
+//#region src/components/tabs/src/RsTabs.vue
+var RsTabs_default = RsTabs_vue_vue_type_script_setup_true_lang_default;
+//#endregion
+export { RsTabs_default as default };

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

@@ -0,0 +1,71 @@
+import type { RsContextMenuItem } from '../../context-menu/src/context-menu-utils';
+/** 选项卡项定义 */
+export interface RsTabItem {
+    value: string;
+    label: string;
+    icon?: string;
+    disabled?: boolean;
+    badge?: string | number;
+    /** 是否可关闭；未设置时继承 RsTabs 的 closable；fixed 为 true 时强制不可关 */
+    closable?: boolean;
+    /** 固定/常驻标签（对齐 GTabs fixed / 浏览器固定标签），不可关闭、不可被批量关闭 */
+    fixed?: boolean;
+    /** 是否可重命名；未设置时继承 RsTabs 的 renamable */
+    renamable?: boolean;
+}
+/** 选项卡尺寸 */
+export type RsTabsSize = 'sm' | 'md';
+/** line 下划线 · segmented 胶囊 · card 卡片（Ant editable-card） */
+export type RsTabsVariant = 'line' | 'segmented' | 'card';
+/**
+ * 标签栏对齐：start 左齐 · center 居中 · evenly 均分空隙 · stretch 项等宽铺满。
+ * 用于登录等场景，避免业务侧 :deep 改 list/trigger。
+ */
+export type RsTabsJustify = 'start' | 'center' | 'evenly' | 'stretch';
+/**
+ * 标题栏与内容区间距（主要用于 borderless）。
+ * none=0 · sm=8px · md=12px · lg=16px · xl=24px；也可用 CSS 变量 --rs-tabs-content-gap 覆盖。
+ */
+export type RsTabsContentGap = 'none' | 'sm' | 'md' | 'lg' | 'xl';
+/** 标签过多时的处理方式 */
+export type RsTabsOverflow = 'scroll' | 'dropdown';
+/** 批量关闭动作（顶栏导航右键菜单） */
+export type RsTabsCloseAction = 'close' | 'others' | 'left' | 'right' | 'all';
+/** 判断是否为固定标签 */
+export declare function isTabFixed(item: RsTabItem): boolean;
+/** 判断单项是否展示关闭按钮 */
+export declare function isTabClosable(item: RsTabItem, globalClosable?: boolean): boolean;
+/** 判断单项是否可双击重命名 */
+export declare function isTabRenamable(item: RsTabItem, globalRenamable?: boolean): boolean;
+/** 关闭当前激活项时，解析应切换到的下一项（优先右侧，否则左侧） */
+export declare function getNextTabAfterClose(items: RsTabItem[], closedValue: string, activeValue: string): string | undefined;
+/**
+ * 批量关闭后解析应保留的激活项。
+ * 若当前激活项仍在剩余列表中则保持，否则取锚点（若仍在）或首项。
+ */
+export declare function getNextTabAfterBatchClose(remaining: RsTabItem[], activeValue: string, anchorValue?: string): string | undefined;
+/** 将 dragValue 对应的项移动到 dropValue 之前（fixed 项不可作为拖拽源或落点） */
+export declare function reorderTabItems(items: RsTabItem[], dragValue: string, dropValue: string): RsTabItem[];
+/**
+ * 按动作解析待关闭的 value 列表（跳过 fixed / 不可关闭项）。
+ */
+export declare function resolveTabsToClose(items: RsTabItem[], action: RsTabsCloseAction, anchorValue: string, globalClosable?: boolean): string[];
+export interface BuildTabContextMenuLabels {
+    close: string;
+    closeOthers: string;
+    closeLeft: string;
+    closeRight: string;
+    closeAll: string;
+}
+/**
+ * 构建顶栏导航右键菜单项（关闭 / 关闭其他 / 左 / 右 / 全部）。
+ */
+export declare function buildTabContextMenuItems(items: RsTabItem[], anchor: RsTabItem, globalClosable: boolean, labels: BuildTabContextMenuLabels): RsContextMenuItem[];
+export interface ResolveVisibleTabOptions {
+    /** dropdown 模式下为 false：激活项仅在「更多」展示，不占标签栏 */
+    keepActiveVisible?: boolean;
+}
+/**
+ * 根据各标签宽度与可用宽度，计算应展示的标签 value 集合。
+ */
+export declare function resolveVisibleTabValues(items: RsTabItem[], widths: Map<string, number>, availableWidth: number, activeValue: string, reservedWidth?: number, options?: ResolveVisibleTabOptions): Set<string>;