niuma-ui 1.1.12 → 1.2.0

package/dist/composables/useRsTableViewProvide.d.ts

@@ -0,0 +1,111 @@
+/**
+ * 将 Core/Shell/Edit 装配结果安装为实例级 ViewContext。
+ *
+ * 从 RsTable.vue 下沉大块 provide 装配，便于壳层只做接线。
+ * 多表：每次调用 provide 到当前实例树，互不串扰。
+ */
+import type { ComputedRef, Ref } from 'vue';
+import type { RsTableColumn, RsTableRowData, RsTableRowDropPosition, RsTableRowEntry, RsTableRowKey, RsTableSelectionType } from '../components/table-utils';
+import type { RsTableCellEditFocusMode, RsTableCellEditTrigger } from '../components/table/table-edit-utils';
+import { type RsTableBodyLabels, type RsTableHeaderLabels, type RsTableViewContext, type RsTableViewStyle } from '../components/table/rs-table-view-context';
+type RowEntry<T extends RsTableRowData> = Extract<RsTableRowEntry<T>, {
+    type: 'row';
+}>;
+/** ViewContext 安装所需的状态源（getter / Ref 均可） */
+export interface RsTableViewProvideSources<T extends RsTableRowData> {
+    useFixedColumnLayout: Ref<boolean> | ComputedRef<boolean> | (() => boolean);
+    showRowDragHandle: Ref<boolean> | ComputedRef<boolean> | (() => boolean);
+    detailExpandable: Ref<boolean> | ComputedRef<boolean> | (() => boolean);
+    showSelectColumn: Ref<boolean> | ComputedRef<boolean> | (() => boolean);
+    showEditGutterColumn: Ref<boolean> | ComputedRef<boolean> | (() => boolean);
+    showIndexColumn: Ref<boolean> | ComputedRef<boolean> | (() => boolean);
+    showRowStatusColumn: Ref<boolean> | ComputedRef<boolean> | (() => boolean);
+    columnPadLeft: Ref<number> | ComputedRef<number> | (() => number);
+    columnPadRight: Ref<number> | ComputedRef<number> | (() => number);
+    visibleDataColumns: Ref<RsTableColumn<T>[]> | ComputedRef<RsTableColumn<T>[]> | (() => RsTableColumn<T>[]);
+    prefixWidths: {
+        drag: number;
+        expand: number;
+        select: number;
+        status: number;
+    };
+    resolvedGutterWidth: Ref<number> | ComputedRef<number> | (() => number);
+    resolvedIndexWidth: Ref<number> | ComputedRef<number> | (() => number);
+    isRadioSelection: Ref<boolean> | ComputedRef<boolean> | (() => boolean);
+    selectAllState: Ref<'checked' | 'indeterminate' | 'unchecked'> | ComputedRef<'checked' | 'indeterminate' | 'unchecked'> | (() => 'checked' | 'indeterminate' | 'unchecked');
+    columnDraggable: () => boolean;
+    resizable: () => boolean;
+    multiSort: () => boolean;
+    columnFiltersState: Ref<Record<string, string>> | ComputedRef<Record<string, string>> | (() => Record<string, string>);
+    dragColumnKey: Ref<string | null> | (() => string | null);
+    dropColumnKey: Ref<string | null> | (() => string | null);
+    dragLeadHeaderStyle: Ref<RsTableViewStyle> | ComputedRef<RsTableViewStyle> | (() => RsTableViewStyle);
+    expandLeadHeaderStyle: Ref<RsTableViewStyle> | ComputedRef<RsTableViewStyle> | (() => RsTableViewStyle);
+    selectLeadHeaderStyle: Ref<RsTableViewStyle> | ComputedRef<RsTableViewStyle> | (() => RsTableViewStyle);
+    gutterLeadHeaderStyle: Ref<RsTableViewStyle> | ComputedRef<RsTableViewStyle> | (() => RsTableViewStyle);
+    indexLeadHeaderStyle: Ref<RsTableViewStyle> | ComputedRef<RsTableViewStyle> | (() => RsTableViewStyle);
+    columnHeaderStyleMap: Ref<Map<string, Record<string, string> | undefined>> | ComputedRef<Map<string, Record<string, string> | undefined>> | (() => Map<string, Record<string, string> | undefined>);
+    headerLabels: Ref<RsTableHeaderLabels> | ComputedRef<RsTableHeaderLabels> | (() => RsTableHeaderLabels);
+    loading: () => boolean;
+    hasData: Ref<boolean> | ComputedRef<boolean> | (() => boolean);
+    loadingMore: () => boolean;
+    infinite: () => boolean;
+    bodyColspan: Ref<number> | ComputedRef<number> | (() => number);
+    emptyContentStyle: Ref<RsTableViewStyle> | ComputedRef<RsTableViewStyle> | (() => RsTableViewStyle);
+    virtualScrollEnabled: Ref<boolean> | ComputedRef<boolean> | (() => boolean);
+    virtualSlice: Ref<{
+        paddingTop: number;
+        paddingBottom: number;
+    }> | ComputedRef<{
+        paddingTop: number;
+        paddingBottom: number;
+    }> | (() => {
+        paddingTop: number;
+        paddingBottom: number;
+    });
+    visibleEntries: Ref<RsTableRowEntry<T>[]> | ComputedRef<RsTableRowEntry<T>[]> | (() => RsTableRowEntry<T>[]);
+    rowKey: () => RsTableRowKey<T> | undefined;
+    treeMode: Ref<boolean> | ComputedRef<boolean> | (() => boolean);
+    treeIndentPx: Ref<number> | ComputedRef<number> | (() => number);
+    treeExpandColumnKey: Ref<string | null> | ComputedRef<string | null> | (() => string | null);
+    treeLoadingKeySet: Ref<Set<string>> | ComputedRef<Set<string>> | (() => Set<string>);
+    striped: () => boolean;
+    selectionType: () => RsTableSelectionType;
+    editable: () => boolean;
+    editTrigger: () => RsTableCellEditTrigger;
+    rowCommit: () => boolean;
+    allowNull: () => boolean;
+    editFocusMode: () => RsTableCellEditFocusMode;
+    nullLabel: () => string;
+    dragLeadStyle: Ref<Record<string, string>> | ComputedRef<Record<string, string>> | (() => Record<string, string>);
+    expandLeadStyle: Ref<Record<string, string>> | ComputedRef<Record<string, string>> | (() => Record<string, string>);
+    selectLeadStyle: Ref<Record<string, string>> | ComputedRef<Record<string, string>> | (() => Record<string, string>);
+    indexLeadStyle: Ref<Record<string, string>> | ComputedRef<Record<string, string>> | (() => Record<string, string>);
+    gutterLeadStyle: Ref<Record<string, string>> | ComputedRef<Record<string, string>> | (() => Record<string, string>);
+    columnTdClassMap: Ref<Map<string, string[]>> | ComputedRef<Map<string, string[]>> | (() => Map<string, string[]>);
+    columnStyleMap: Ref<Map<string, Record<string, string> | undefined>> | ComputedRef<Map<string, Record<string, string> | undefined>> | (() => Map<string, Record<string, string> | undefined>);
+    dragRowKeys: Ref<string[]> | (() => string[]);
+    dropRowTargetKey: Ref<string | null> | (() => string | null);
+    dropRowPosition: Ref<RsTableRowDropPosition | null> | (() => RsTableRowDropPosition | null);
+    activeEditCellKey: Ref<string> | ComputedRef<string> | (() => string);
+    activeFocusCellKey: Ref<string> | ComputedRef<string> | (() => string);
+    activeErrorMapSize: Ref<number> | ComputedRef<number> | (() => number);
+    activeValidatingMapSize: Ref<number> | ComputedRef<number> | (() => number);
+    stagedMapSize: () => number;
+    editingDraft: () => string;
+    editingCell: () => {
+        rowKey: string;
+        colKey: string;
+    } | null;
+    focusCell: () => {
+        rowKey: string;
+        colKey: string;
+    } | null;
+    bodyLabels: Ref<RsTableBodyLabels> | ComputedRef<RsTableBodyLabels> | (() => RsTableBodyLabels);
+}
+export type RsTableViewProvideHandlers<T extends RsTableRowData> = Pick<RsTableViewContext<T>, 'resolvedDataColumnWidth' | 'columnFilterValue' | 'sortOrderFor' | 'sortPriorityFor' | 'sortIconName' | 'onToggleSelectAll' | 'onColumnDragOver' | 'onColumnDrop' | 'onColumnDragStart' | 'onColumnDragEnd' | 'updateColumnFilter' | 'onHeaderClick' | 'onResizeStart' | 'onHeaderPointerOver' | 'onHeaderPointerOut' | 'rowKeyFor' | 'isRowSelected' | 'isRowIndeterminate' | 'isRowExpanded' | 'isHighlighted' | 'rowEditPending' | 'isExternalRowPending' | 'treeDepthOf' | 'canExpandRow' | 'canSelectRow' | 'isRowDragByRow' | 'isRowDragging' | 'isRowDropTarget' | 'isRowDirty' | 'hasColumnSlot' | 'hasEditSlot' | 'cellTooltipEnabled' | 'cellTooltipMode' | 'cellTooltipText' | 'cellTooltipFallbackTitle' | 'getCellDraft' | 'isCellDirty' | 'getCellError' | 'isCellValidating' | 'onBodyPointerOver' | 'onBodyPointerOut' | 'onRowClick' | 'onRowSelectMouseDown' | 'onCellClick' | 'onCellDblclick' | 'onCellContextmenu' | 'onRowDblclick' | 'onRowContextmenu' | 'onRowDragOver' | 'onRowDragLeave' | 'onRowDrop' | 'onRowDragStart' | 'onRowDragEnd' | 'onToggleExpand' | 'onToggleSelect' | 'onCellStartEdit' | 'onCellCommit' | 'onCellCancel' | 'onCellUpdateDraft' | 'onCellNavigate' | 'onRowCommit' | 'onRowRollback' | 'onGutterCommit'>;
+/**
+ * 装配并 provide ViewContext；返回 ctx（便于测试读 instanceId）。
+ */
+export declare function useRsTableViewProvide<T extends RsTableRowData>(sources: RsTableViewProvideSources<T>, handlers: RsTableViewProvideHandlers<T>): RsTableViewContext<T>;
+export type { RowEntry };

package/dist/composables/useRsTableViewProvide.js

@@ -0,0 +1,93 @@
+import { isColumnFilterActive } from "../components/table-utils.js";
+import { createRsTableViewContext, provideRsTableView } from "../components/table/rs-table-view-context.js";
+//#region src/composables/useRsTableViewProvide.ts
+function val(source) {
+	if (typeof source === "function") return source;
+	return () => source.value;
+}
+/**
+* 装配并 provide ViewContext；返回 ctx（便于测试读 instanceId）。
+*/
+function useRsTableViewProvide(sources, handlers) {
+	const ctx = createRsTableViewContext({
+		state: {
+			useFixedColumnLayout: val(sources.useFixedColumnLayout),
+			showRowDragHandle: val(sources.showRowDragHandle),
+			detailExpandable: val(sources.detailExpandable),
+			showSelectColumn: val(sources.showSelectColumn),
+			showEditGutterColumn: val(sources.showEditGutterColumn),
+			showIndexColumn: val(sources.showIndexColumn),
+			showRowStatusColumn: val(sources.showRowStatusColumn),
+			columnPadLeft: val(sources.columnPadLeft),
+			columnPadRight: val(sources.columnPadRight),
+			visibleDataColumns: val(sources.visibleDataColumns),
+			prefixWidths: () => sources.prefixWidths,
+			resolvedGutterWidth: val(sources.resolvedGutterWidth),
+			resolvedIndexWidth: val(sources.resolvedIndexWidth),
+			isRadioSelection: val(sources.isRadioSelection),
+			selectAllState: val(sources.selectAllState),
+			columnDraggable: sources.columnDraggable,
+			resizable: sources.resizable,
+			multiSort: sources.multiSort,
+			columnFiltersState: val(sources.columnFiltersState),
+			dragColumnKey: val(sources.dragColumnKey),
+			dropColumnKey: val(sources.dropColumnKey),
+			dragLeadHeaderStyle: val(sources.dragLeadHeaderStyle),
+			expandLeadHeaderStyle: val(sources.expandLeadHeaderStyle),
+			selectLeadHeaderStyle: val(sources.selectLeadHeaderStyle),
+			gutterLeadHeaderStyle: val(sources.gutterLeadHeaderStyle),
+			indexLeadHeaderStyle: val(sources.indexLeadHeaderStyle),
+			columnHeaderStyleMap: val(sources.columnHeaderStyleMap),
+			headerLabels: val(sources.headerLabels),
+			loading: sources.loading,
+			hasData: val(sources.hasData),
+			loadingMore: sources.loadingMore,
+			infinite: sources.infinite,
+			bodyColspan: val(sources.bodyColspan),
+			emptyContentStyle: val(sources.emptyContentStyle),
+			virtualScrollEnabled: val(sources.virtualScrollEnabled),
+			virtualSlice: val(sources.virtualSlice),
+			visibleEntries: val(sources.visibleEntries),
+			rowKey: sources.rowKey,
+			treeMode: val(sources.treeMode),
+			treeIndentPx: val(sources.treeIndentPx),
+			treeExpandColumnKey: val(sources.treeExpandColumnKey),
+			treeLoadingKeySet: val(sources.treeLoadingKeySet),
+			striped: sources.striped,
+			selectionType: sources.selectionType,
+			editable: sources.editable,
+			editTrigger: sources.editTrigger,
+			rowCommit: sources.rowCommit,
+			allowNull: sources.allowNull,
+			editFocusMode: sources.editFocusMode,
+			nullLabel: sources.nullLabel,
+			dragLeadStyle: val(sources.dragLeadStyle),
+			expandLeadStyle: val(sources.expandLeadStyle),
+			selectLeadStyle: val(sources.selectLeadStyle),
+			indexLeadStyle: val(sources.indexLeadStyle),
+			gutterLeadStyle: val(sources.gutterLeadStyle),
+			columnTdClassMap: val(sources.columnTdClassMap),
+			columnStyleMap: val(sources.columnStyleMap),
+			dragRowKeys: val(sources.dragRowKeys),
+			dropRowTargetKey: val(sources.dropRowTargetKey),
+			dropRowPosition: val(sources.dropRowPosition),
+			activeEditCellKey: val(sources.activeEditCellKey),
+			activeFocusCellKey: val(sources.activeFocusCellKey),
+			activeErrorMapSize: val(sources.activeErrorMapSize),
+			activeValidatingMapSize: val(sources.activeValidatingMapSize),
+			stagedMapSize: sources.stagedMapSize,
+			editingDraft: sources.editingDraft,
+			editingCell: sources.editingCell,
+			focusCell: sources.focusCell,
+			bodyLabels: val(sources.bodyLabels)
+		},
+		handlers: {
+			...handlers,
+			isColumnFilterActive
+		}
+	});
+	provideRsTableView(ctx);
+	return ctx;
+}
+//#endregion
+export { useRsTableViewProvide };

package/dist/composables/useRsTableVirtual.d.ts

@@ -0,0 +1,75 @@
+/**
+ * RsTable 行虚拟滚动：启用判定、高度前缀和、可视窗口切片。
+ *
+ * 横向列虚拟见 useRsTableColumnVirtual；滚动/视口见 useRsTableScrollLayout。
+ * 本 composable 只消费已算好的 `tableEntries`，不参与 entries 构建，避免循环依赖。
+ */
+import { type ComputedRef, type Ref } from 'vue';
+import { type RsTableRowData, type RsTableRowEntry, type RsTableRowKey } from '../components/table-utils';
+/**
+ * useRsTableVirtual 入参。
+ * `tableEntriesForThreshold` 用于 auto 阈值，不可直接依赖完整 tableEntries（会循环）。
+ */
+export interface UseRsTableVirtualOptions<T extends RsTableRowData> {
+    /** 根数据行数（非树表阈值用） */
+    dataLength: ComputedRef<number> | (() => number);
+    treeMode: ComputedRef<boolean> | (() => boolean);
+    /** 树表当前展开态下的可见条目粗算 */
+    tableEntriesForThreshold: ComputedRef<number> | (() => number);
+    /** virtual prop：true 强制开 / false 强制关 / undefined 走 auto */
+    virtual: ComputedRef<boolean | undefined> | (() => boolean | undefined);
+    /** auto 模式下的行数阈值 */
+    virtualAutoThreshold: ComputedRef<number> | (() => number);
+    /** fill 为 true 时才允许 auto 开启虚拟（需确定视口高度） */
+    fill: ComputedRef<boolean> | (() => boolean);
+    infinite: ComputedRef<boolean> | (() => boolean);
+    /** infinite 时默认开启虚拟；可显式关掉 */
+    virtualOnInfinite: ComputedRef<boolean> | (() => boolean);
+    overscan: ComputedRef<number> | (() => number);
+    expandRowHeight: ComputedRef<number | undefined> | (() => number | undefined);
+    scrollTop: Ref<number>;
+    viewportHeight: ComputedRef<number> | (() => number);
+    fixedRowHeight: ComputedRef<number> | (() => number);
+    /** 完整 entry 列表（含 group / expand 伪行） */
+    tableEntries: ComputedRef<RsTableRowEntry<T>[]> | (() => RsTableRowEntry<T>[]);
+}
+/**
+ * 树表展开态下的可见行粗算，供 virtual 自动阈值使用。
+ * 仅统计当前 expandedKeys 下可见节点，不做完整 entry 构建。
+ *
+ * @param rows 根节点列表
+ * @param expandedKeys 已展开行 key 集合
+ * @param options 树字段与 rowKey 约定
+ * @returns 可见行数量（含未展开的叶子占位行本身）
+ */
+export declare function flattenVisibleCountRough<R extends RsTableRowData>(rows: readonly R[], expandedKeys: ReadonlySet<string>, options: {
+    childrenField: string;
+    isLeafField: string;
+    lazy: boolean;
+    rowKey?: RsTableRowKey<R>;
+}): number;
+/**
+ * 行虚拟滚动状态。
+ *
+ * @returns
+ * - `virtualScrollEnabled`：是否启用行虚拟
+ * - `virtualHeightModel`：前缀高度模型（总高 / 定位）
+ * - `virtualSlice`：当前窗口 entries + 上下 pad
+ * - `visibleEntries`：切片后的 entries（模板渲染用）
+ */
+export declare function useRsTableVirtual<T extends RsTableRowData>(options: UseRsTableVirtualOptions<T>): {
+    virtualScrollEnabled: ComputedRef<boolean>;
+    virtualHeightModel: ComputedRef<{
+        entries: readonly RsTableRowEntry<T>[];
+        prefix: number[];
+        total: number;
+    }>;
+    virtualSlice: ComputedRef<{
+        entries: RsTableRowEntry<T>[];
+        paddingTop: number;
+        paddingBottom: number;
+    }>;
+    visibleEntries: ComputedRef<RsTableRowEntry<T>[]>;
+};
+/** useRsTableVirtual 返回值类型 */
+export type RsTableVirtualApi<T extends RsTableRowData> = ReturnType<typeof useRsTableVirtual<T>>;

package/dist/composables/useRsTableVirtual.js

@@ -0,0 +1,83 @@
+import { buildVirtualHeightModel, getTableTreeChildren, hasTableTreeChildren, resolveTableTreeRowKey, sliceVirtualHeightModel } from "../components/table-utils.js";
+import { computed } from "vue";
+//#region src/composables/useRsTableVirtual.ts
+/**
+* RsTable 行虚拟滚动：启用判定、高度前缀和、可视窗口切片。
+*
+* 横向列虚拟见 useRsTableColumnVirtual；滚动/视口见 useRsTableScrollLayout。
+* 本 composable 只消费已算好的 `tableEntries`，不参与 entries 构建，避免循环依赖。
+*/
+/** 统一读取 ComputedRef / Ref / getter */
+function read(source) {
+	if (typeof source === "function") return source();
+	return source.value;
+}
+/**
+* 树表展开态下的可见行粗算，供 virtual 自动阈值使用。
+* 仅统计当前 expandedKeys 下可见节点，不做完整 entry 构建。
+*
+* @param rows 根节点列表
+* @param expandedKeys 已展开行 key 集合
+* @param options 树字段与 rowKey 约定
+* @returns 可见行数量（含未展开的叶子占位行本身）
+*/
+function flattenVisibleCountRough(rows, expandedKeys, options) {
+	let count = 0;
+	const walk = (items, parentKey) => {
+		for (let i = 0; i < items.length; i += 1) {
+			const row = items[i];
+			count += 1;
+			const key = resolveTableTreeRowKey(row, i, parentKey, options.rowKey);
+			if (hasTableTreeChildren(row, options) && expandedKeys.has(key)) walk(getTableTreeChildren(row, options.childrenField), key);
+		}
+	};
+	walk(rows, null);
+	return count;
+}
+/**
+* 行虚拟滚动状态。
+*
+* @returns
+* - `virtualScrollEnabled`：是否启用行虚拟
+* - `virtualHeightModel`：前缀高度模型（总高 / 定位）
+* - `virtualSlice`：当前窗口 entries + 上下 pad
+* - `visibleEntries`：切片后的 entries（模板渲染用）
+*/
+function useRsTableVirtual(options) {
+	/**
+	* 启用规则：
+	* 1. virtual === true → 开
+	* 2. infinite 且未关闭 virtualOnInfinite → 开
+	* 3. virtual === false → 关
+	* 4. 否则 auto：fill 且行数 >= threshold
+	*/
+	const virtualScrollEnabled = computed(() => {
+		if (read(options.virtual) === true) return true;
+		if (read(options.infinite) && read(options.virtualOnInfinite) !== false) return true;
+		if (read(options.virtual) === false) return false;
+		const threshold = read(options.virtualAutoThreshold) ?? 0;
+		const rowCount = read(options.treeMode) ? read(options.tableEntriesForThreshold) : read(options.dataLength);
+		return Boolean(read(options.fill) && threshold > 0 && rowCount >= threshold);
+	});
+	/** 全量 entries 的高度前缀和模型 */
+	const virtualHeightModel = computed(() => buildVirtualHeightModel(read(options.tableEntries), read(options.fixedRowHeight), void 0, read(options.expandRowHeight) ?? void 0));
+	/**
+	* 可视切片。未启用虚拟时返回全部 entries，pad 为 0。
+	*/
+	const virtualSlice = computed(() => {
+		if (!virtualScrollEnabled.value) return {
+			entries: read(options.tableEntries),
+			paddingTop: 0,
+			paddingBottom: 0
+		};
+		return sliceVirtualHeightModel(virtualHeightModel.value, options.scrollTop.value, read(options.viewportHeight), read(options.fixedRowHeight), read(options.overscan));
+	});
+	return {
+		virtualScrollEnabled,
+		virtualHeightModel,
+		virtualSlice,
+		visibleEntries: computed(() => virtualSlice.value.entries)
+	};
+}
+//#endregion
+export { flattenVisibleCountRough, useRsTableVirtual };

package/dist/composables/useRsTabsNav.d.ts

@@ -0,0 +1,33 @@
+import { type ComputedRef, type Ref } from 'vue';
+import { type RsTabItem, type RsTabsOverflow } from '../components/tabs-utils';
+interface UseRsTabsNavOptions {
+    items: ComputedRef<RsTabItem[]>;
+    activeValue: Ref<string>;
+    overflow: ComputedRef<RsTabsOverflow | false>;
+    canAdd: ComputedRef<boolean>;
+    navRef: Ref<HTMLElement | null>;
+    measureRef: Ref<HTMLElement | null>;
+    overflowRef: Ref<HTMLElement | null>;
+    /** 右侧 #extra 区域，计入下拉溢出预留宽度 */
+    extraRef?: Ref<HTMLElement | null>;
+    addButtonWidth: number;
+}
+export declare function useRsTabsNav(options: UseRsTabsNavOptions): {
+    navViewportRef: Ref<HTMLElement | null, HTMLElement | null>;
+    useDropdownOverflow: ComputedRef<boolean>;
+    useScrollOverflow: ComputedRef<boolean>;
+    visibleTabItems: ComputedRef<RsTabItem[]>;
+    hiddenItems: ComputedRef<RsTabItem[]>;
+    overflowMenuItems: ComputedRef<{
+        value: string;
+        label: string;
+    }[]>;
+    activeInHidden: ComputedRef<boolean>;
+    showOverflowMenu: ComputedRef<boolean>;
+    canScrollPrev: Ref<boolean, boolean>;
+    canScrollNext: Ref<boolean, boolean>;
+    scrollNav: (direction: -1 | 1) => void;
+    onNavScroll: () => void;
+    scheduleLayout: () => void;
+};
+export {};

package/dist/composables/useRsTabsNav.js

@@ -0,0 +1,137 @@
+import { resolveVisibleTabValues } from "../components/tabs-utils.js";
+import { computed, nextTick, onMounted, onUnmounted, ref, watch } from "vue";
+//#region src/composables/useRsTabsNav.ts
+function useRsTabsNav(options) {
+	const navViewportRef = ref(null);
+	const triggerWidths = ref(/* @__PURE__ */ new Map());
+	const visibleValues = ref(/* @__PURE__ */ new Set());
+	const canScrollPrev = ref(false);
+	const canScrollNext = ref(false);
+	let resizeObserver = null;
+	const useDropdownOverflow = computed(() => options.overflow.value === "dropdown");
+	const useScrollOverflow = computed(() => options.overflow.value === "scroll");
+	const visibleTabItems = computed(() => options.items.value.filter((item) => visibleValues.value.has(item.value)));
+	const hiddenItems = computed(() => options.items.value.filter((item) => !visibleValues.value.has(item.value)));
+	const overflowMenuItems = computed(() => hiddenItems.value.map((item) => ({
+		value: item.value,
+		label: item.label
+	})));
+	const activeInHidden = computed(() => hiddenItems.value.some((item) => item.value === options.activeValue.value));
+	const showOverflowMenu = computed(() => useDropdownOverflow.value && hiddenItems.value.length > 0);
+	function measureTriggerWidths() {
+		const measureRoot = options.measureRef.value;
+		if (measureRoot) {
+			const next = /* @__PURE__ */ new Map();
+			for (const node of measureRoot.querySelectorAll("[data-tab-value]")) {
+				const value = node.dataset.tabValue;
+				if (value) next.set(value, node.offsetWidth);
+			}
+			if (next.size > 0) return next;
+		}
+		const viewport = navViewportRef.value;
+		const next = /* @__PURE__ */ new Map();
+		if (!viewport) return next;
+		for (const trigger of viewport.querySelectorAll(".rs-tabs__trigger[data-tab-value]")) {
+			const value = trigger.dataset.tabValue;
+			if (value) next.set(value, trigger.offsetWidth);
+		}
+		return next;
+	}
+	function reservedWidth() {
+		let width = 0;
+		if (useDropdownOverflow.value && options.items.value.length > 1) width += options.overflowRef.value?.offsetWidth ?? 76;
+		if (options.canAdd.value) width += options.addButtonWidth;
+		width += options.extraRef?.value?.offsetWidth ?? 0;
+		return width;
+	}
+	function recomputeVisibleTabs() {
+		if (!useDropdownOverflow.value) {
+			visibleValues.value = new Set(options.items.value.map((item) => item.value));
+			return;
+		}
+		const nav = options.navRef.value;
+		if (!nav) return;
+		triggerWidths.value = measureTriggerWidths();
+		const availableWidth = nav.clientWidth;
+		visibleValues.value = resolveVisibleTabValues(options.items.value, triggerWidths.value, availableWidth, options.activeValue.value, reservedWidth(), { keepActiveVisible: false });
+	}
+	function updateScrollButtons() {
+		const viewport = navViewportRef.value;
+		if (!viewport || !useScrollOverflow.value) {
+			canScrollPrev.value = false;
+			canScrollNext.value = false;
+			return;
+		}
+		canScrollPrev.value = viewport.scrollLeft > 1;
+		canScrollNext.value = viewport.scrollLeft + viewport.clientWidth < viewport.scrollWidth - 1;
+	}
+	function scrollNav(direction) {
+		navViewportRef.value?.scrollBy({
+			left: direction * 180,
+			behavior: "smooth"
+		});
+	}
+	function onNavScroll() {
+		updateScrollButtons();
+	}
+	async function scrollActiveTabIntoView() {
+		if (!useScrollOverflow.value) return;
+		await nextTick();
+		const viewport = navViewportRef.value;
+		if (!viewport) return;
+		viewport.querySelector(`.rs-tabs__trigger[data-state='active']`)?.scrollIntoView({
+			inline: "nearest",
+			block: "nearest",
+			behavior: "smooth"
+		});
+		updateScrollButtons();
+	}
+	function scheduleLayout() {
+		nextTick(() => {
+			recomputeVisibleTabs();
+			updateScrollButtons();
+			if (!useDropdownOverflow.value) return;
+			nextTick(() => {
+				recomputeVisibleTabs();
+				updateScrollButtons();
+			});
+		});
+	}
+	onMounted(() => {
+		scheduleLayout();
+		const nav = options.navRef.value;
+		if (!nav || typeof ResizeObserver === "undefined") return;
+		resizeObserver = new ResizeObserver(() => scheduleLayout());
+		resizeObserver.observe(nav);
+	});
+	onUnmounted(() => {
+		resizeObserver?.disconnect();
+		resizeObserver = null;
+	});
+	watch(() => [
+		options.items.value,
+		options.overflow.value,
+		options.canAdd.value
+	], () => scheduleLayout(), { deep: true });
+	watch(options.activeValue, () => {
+		scheduleLayout();
+		scrollActiveTabIntoView();
+	});
+	return {
+		navViewportRef,
+		useDropdownOverflow,
+		useScrollOverflow,
+		visibleTabItems,
+		hiddenItems,
+		overflowMenuItems,
+		activeInHidden,
+		showOverflowMenu,
+		canScrollPrev,
+		canScrollNext,
+		scrollNav,
+		onNavScroll,
+		scheduleLayout
+	};
+}
+//#endregion
+export { useRsTabsNav };

package/dist/composables/useRsToast.d.ts

@@ -0,0 +1,15 @@
+import type { RsToastPosition, RsToastType } from '../components/overlay-utils';
+export type { RsToastPosition, RsToastType };
+export type RsToastInput = string | {
+    title: string;
+    description?: string;
+    position?: RsToastPosition;
+    duration?: number;
+};
+export declare function useRsToast(): {
+    success: (input: RsToastInput) => void;
+    error: (input: RsToastInput) => void;
+    info: (input: RsToastInput) => void;
+    warning: (input: RsToastInput) => void;
+    dismiss: (id?: number | string) => string | number | undefined;
+};

package/dist/composables/useRsToast.js

@@ -0,0 +1,30 @@
+import { toast } from "vue-sonner";
+//#region src/composables/useRsToast.ts
+function resolveToast(input) {
+	if (typeof input === "string") return { title: input };
+	return input;
+}
+function useRsToast() {
+	function show(type, input) {
+		const payload = resolveToast(input);
+		const options = {
+			description: payload.description,
+			...payload.position ? { position: payload.position } : {},
+			...payload.duration ? { duration: payload.duration } : {},
+			class: `rs-toast rs-toast--${type}`
+		};
+		if (type === "success") toast.success(payload.title, options);
+		else if (type === "error") toast.error(payload.title, options);
+		else if (type === "warning") toast.warning(payload.title, options);
+		else toast.info(payload.title, options);
+	}
+	return {
+		success: (input) => show("success", input),
+		error: (input) => show("error", input),
+		info: (input) => show("info", input),
+		warning: (input) => show("warning", input),
+		dismiss: toast.dismiss
+	};
+}
+//#endregion
+export { useRsToast };

package/dist/composables/useTableCellTooltip.d.ts

@@ -0,0 +1,28 @@
+import { type Ref } from 'vue';
+export declare const RS_TABLE_TIP_ATTR = "data-rs-table-tip";
+export declare const RS_TABLE_TIP_MODE_ATTR = "data-rs-table-tip-mode";
+export declare const RS_TABLE_TIP_TEXT_ATTR = "data-rs-table-tip-text";
+/** 列头 headerTip：整表共享浮层，悬停 th-label 显示 */
+export declare const RS_TABLE_HEADER_TIP_ATTR = "data-rs-table-header-tip";
+export interface TableCellTooltipState {
+    visible: boolean;
+    ready: boolean;
+    text: string;
+    kind: 'cell' | 'header';
+    style: {
+        left: string;
+        top: string;
+    };
+}
+export declare function useTableCellTooltip(options: {
+    enabled: () => boolean;
+    /** 列头 headerTip 共享浮层；默认 true */
+    headerEnabled?: () => boolean;
+    delay: () => number;
+    tipRef: Ref<HTMLElement | null>;
+}): {
+    state: Ref<TableCellTooltipState>;
+    onPointerOver: (event: PointerEvent) => void;
+    onPointerOut: (event: PointerEvent) => void;
+    hide: () => void;
+};