ensis-ui 0.0.0-stage → 3.0.0

package/dist/components/table/src/utils/table-drag.d.ts

@@ -0,0 +1,39 @@
+import { type Ref } from 'vue';
+import type { RsTableRowDropPosition } from './table-utils';
+export type RsTableRowDragTrigger = 'handle' | 'row';
+export type RsTableRowDropMode = 'reorder' | 'into';
+export interface TableRowDragState {
+    dragRowKeys: Ref<string[]>;
+    dropRowTargetKey: Ref<string | null>;
+    dropRowPosition: Ref<RsTableRowDropPosition>;
+}
+export declare function createTableRowDragState(): TableRowDragState;
+export declare function resolveTableRowDropPosition(event: MouseEvent, element: HTMLElement, mode: RsTableRowDropMode): RsTableRowDropPosition;
+export declare function resolveDragRowKeys(dragKey: string, selectedKeys: readonly string[]): string[];
+/** 用轻量数字徽标替代浏览器默认单元格拖影 */
+export declare function applyTableRowDragImage(event: DragEvent, count: number): void;
+export declare function clearTableRowDragImage(): void;
+export interface CreateTableRowDragHandlersOptions<T> {
+    state: TableRowDragState;
+    getRowDraggable: () => boolean;
+    getRowDragTrigger: () => RsTableRowDragTrigger;
+    getRowDropMode: () => RsTableRowDropMode;
+    rowDraggableWhen?: (row: T, index: number) => boolean;
+    rowDropTargetWhen?: (row: T, index: number) => boolean;
+    canRowDrop?: (dragKeys: string[], dropKey: string) => boolean;
+    rowKeyFor: (row: T, index: number) => string;
+    isRowDisabled: (row: T) => boolean;
+    getSelectedKeys: () => string[];
+    onDragStart: (dragKeys: string[], event: DragEvent) => void;
+    onDrop: (dragKeys: string[], dropKey: string, position: RsTableRowDropPosition) => void;
+}
+export declare function createTableRowDragHandlers<T>(options: CreateTableRowDragHandlersOptions<T>): {
+    canDragRow: (row: T, index: number) => boolean;
+    onRowDragStart: (row: T, index: number, event: DragEvent) => void;
+    onRowDragOver: (row: T, index: number, event: DragEvent) => void;
+    onRowDragLeave: (event: DragEvent) => void;
+    onRowDrop: (row: T, index: number, event: DragEvent) => void;
+    onRowDragEnd: () => void;
+    isRowDragging: (dropKey: string) => boolean;
+    isRowDropTarget: (dropKey: string) => boolean;
+};

package/dist/components/table/src/utils/table-drag.js

@@ -0,0 +1,130 @@
+import { ref } from "vue";
+//#region src/components/table/src/utils/table-drag.ts
+var rowDragPreviewEl = null;
+function createTableRowDragState() {
+	return {
+		dragRowKeys: ref([]),
+		dropRowTargetKey: ref(null),
+		dropRowPosition: ref("before")
+	};
+}
+function resolveTableRowDropPosition(event, element, mode) {
+	if (mode === "into") return "into";
+	const rect = element.getBoundingClientRect();
+	return event.clientY - rect.top < rect.height / 2 ? "before" : "after";
+}
+function resolveDragRowKeys(dragKey, selectedKeys) {
+	if (selectedKeys.includes(dragKey) && selectedKeys.length > 1) return [...selectedKeys];
+	return [dragKey];
+}
+/** 用轻量数字徽标替代浏览器默认单元格拖影 */
+function applyTableRowDragImage(event, count) {
+	if (!event.dataTransfer || typeof document === "undefined") return;
+	let el = rowDragPreviewEl;
+	if (!el) {
+		el = document.createElement("div");
+		el.className = "rs-table__drag-preview";
+		el.setAttribute("aria-hidden", "true");
+		rowDragPreviewEl = el;
+	}
+	el.textContent = String(Math.max(1, count));
+	el.hidden = false;
+	el.style.cssText = "position:fixed;top:0;left:0;transform:translate(-100vw,-100vh);pointer-events:none;z-index:99999";
+	if (!el.isConnected) document.body.appendChild(el);
+	event.dataTransfer.setDragImage(el, 12, 10);
+}
+function clearTableRowDragImage() {
+	const el = rowDragPreviewEl;
+	if (!el) return;
+	el.hidden = true;
+	if (el.isConnected) el.remove();
+}
+function createTableRowDragHandlers(options) {
+	const { state } = options;
+	function endRowDragSession() {
+		state.dragRowKeys.value = [];
+		state.dropRowTargetKey.value = null;
+		clearTableRowDragImage();
+	}
+	function canDragRow(row, index) {
+		if (!options.getRowDraggable() || options.isRowDisabled(row)) return false;
+		return options.rowDraggableWhen ? options.rowDraggableWhen(row, index) : true;
+	}
+	function canDropOnRow(row, index, dropKey) {
+		if (!state.dragRowKeys.value.length) return false;
+		if (state.dragRowKeys.value.includes(dropKey)) return false;
+		if (options.getRowDropMode() === "into") {
+			if (options.rowDropTargetWhen && !options.rowDropTargetWhen(row, index)) return false;
+		}
+		if (options.canRowDrop && !options.canRowDrop(state.dragRowKeys.value, dropKey)) return false;
+		return true;
+	}
+	function onRowDragStart(row, index, event) {
+		if (!options.getRowDraggable() || options.isRowDisabled(row)) {
+			event.preventDefault();
+			return;
+		}
+		const dragKey = options.rowKeyFor(row, index);
+		if (!canDragRow(row, index)) {
+			event.preventDefault();
+			return;
+		}
+		const dragKeys = resolveDragRowKeys(dragKey, options.getSelectedKeys());
+		state.dragRowKeys.value = dragKeys;
+		if (event.dataTransfer) {
+			event.dataTransfer.effectAllowed = "move";
+			event.dataTransfer.setData("text/plain", dragKeys.join(","));
+			applyTableRowDragImage(event, dragKeys.length);
+		}
+		options.onDragStart(dragKeys, event);
+	}
+	function onRowDragOver(row, index, event) {
+		if (!options.getRowDraggable() || !state.dragRowKeys.value.length) return;
+		const dropKey = options.rowKeyFor(row, index);
+		if (!canDropOnRow(row, index, dropKey)) {
+			if (event.dataTransfer) event.dataTransfer.dropEffect = "none";
+			return;
+		}
+		event.preventDefault();
+		state.dropRowTargetKey.value = dropKey;
+		state.dropRowPosition.value = resolveTableRowDropPosition(event, event.currentTarget, options.getRowDropMode());
+		if (event.dataTransfer) event.dataTransfer.dropEffect = "move";
+	}
+	function onRowDragLeave(event) {
+		const next = event.relatedTarget;
+		const current = event.currentTarget;
+		if (next && current?.contains(next)) return;
+		state.dropRowTargetKey.value = null;
+	}
+	function onRowDrop(row, index, event) {
+		if (!options.getRowDraggable() || !state.dragRowKeys.value.length) return;
+		const dropKey = options.rowKeyFor(row, index);
+		if (!canDropOnRow(row, index, dropKey)) return;
+		event.preventDefault();
+		const position = resolveTableRowDropPosition(event, event.currentTarget, options.getRowDropMode());
+		const dragKeys = [...state.dragRowKeys.value];
+		endRowDragSession();
+		options.onDrop(dragKeys, dropKey, position);
+	}
+	function onRowDragEnd() {
+		endRowDragSession();
+	}
+	function isRowDragging(dropKey) {
+		return state.dragRowKeys.value.includes(dropKey);
+	}
+	function isRowDropTarget(dropKey) {
+		return state.dropRowTargetKey.value === dropKey;
+	}
+	return {
+		canDragRow,
+		onRowDragStart,
+		onRowDragOver,
+		onRowDragLeave,
+		onRowDrop,
+		onRowDragEnd,
+		isRowDragging,
+		isRowDropTarget
+	};
+}
+//#endregion
+export { applyTableRowDragImage, clearTableRowDragImage, createTableRowDragHandlers, createTableRowDragState, resolveDragRowKeys, resolveTableRowDropPosition };

package/dist/components/table/src/utils/table-edit-utils.d.ts

@@ -0,0 +1,94 @@
+import type { VNodeChild } from 'vue';
+import type { RsTableCellValueType, RsTableColumn, RsTableColumnEditorOptionsResolved, RsTableRowData } from './table-utils';
+export type RsTableCellCommitTrigger = 'blur' | 'enter' | 'change' | 'manual';
+export type RsTableCellEditTrigger = 'click' | 'dblclick';
+export type RsTableCellEditFocusMode = 'end' | 'select' | 'start';
+export type RsTableCellNavigateDirection = 'next' | 'prev' | 'up' | 'down';
+export type RsTableCellEditorInputType = 'text' | 'number' | 'date' | 'datetime-local' | 'textarea';
+/** 编辑草稿中的显式 NULL 哨兵（与空字符串区分） */
+export declare const RS_TABLE_NULL_DRAFT = "__rs_null__";
+export declare function isNullDraft(text: string | undefined | null): boolean;
+export declare function nullToEditText(): string;
+export declare function resolveCellEditorInputType(valueType?: RsTableCellValueType): RsTableCellEditorInputType;
+export declare function resolveColumnValueType<T extends RsTableRowData>(column: RsTableColumn<T>): RsTableCellValueType;
+export declare function resolveColumnEditorOptions<T extends RsTableRowData>(column: RsTableColumn<T>, row?: T, index?: number): RsTableColumnEditorOptionsResolved;
+/** 布尔列：展示态直接勾选切换，不挂载编辑器（大表友好）。 */
+export declare function isBooleanToggleColumn<T extends RsTableRowData>(column: RsTableColumn<T>): boolean;
+/** 浮层类编辑器（select/date）：点选即编辑，避免再双击。 */
+export declare function usesOverlayEditor(valueType: RsTableCellValueType): boolean;
+export declare function resolveColumnEditTrigger<T extends RsTableRowData>(column: RsTableColumn<T>, tableDefault: RsTableCellEditTrigger): RsTableCellEditTrigger;
+export declare function resolveColumnCommitOn<T extends RsTableRowData>(column: RsTableColumn<T>, rowCommit: boolean): RsTableCellCommitTrigger;
+/** 单元格数据值（编辑 / 复制 / 对比）；不含 `render` 展示结果。 */
+export declare function resolveColumnRawValue<T extends RsTableRowData>(row: T, column: RsTableColumn<T>, _index: number): unknown;
+/** 将 `render` / 展示内容压成纯文本（tooltip、无障碍等）；VNode 取文本子节点。 */
+export declare function plainTextFromCellDisplay(content: VNodeChild): string;
+/**
+ * 单元格展示内容：优先 `column.render`（支持 VNode），否则 formatter / 原始值。
+ * `draft` 存在时展示编辑草稿的格式化文本。
+ */
+export declare function resolveColumnDisplayContent<T extends RsTableRowData>(row: T, column: RsTableColumn<T>, index: number, options?: {
+    draft?: string;
+    nullLabel?: string;
+}): VNodeChild;
+export declare function isColumnEditable<T extends RsTableRowData>(column: RsTableColumn<T>, row: T, index: number, tableEditable: boolean): boolean;
+export declare function isColumnNullable<T extends RsTableRowData>(column: RsTableColumn<T>, tableAllowNull: boolean): boolean;
+export declare function coerceBoolean(value: unknown): boolean;
+export declare function booleanToEditText(value: unknown): string;
+/** 去掉千分位等展示噪音，便于 number 解析 */
+export declare function stripNumberDecorations(input: string): string;
+export declare function formatCellDisplayValue<T extends RsTableRowData>(value: unknown, row: T, column: RsTableColumn<T>, index: number, options?: {
+    nullLabel?: string;
+}): string;
+/** 单元格值 → 纯文本（对象用 JSON，避免 `[object Object]`）。 */
+export declare function cellValueToText(value: unknown): string;
+export declare function resolveCellEditText<T extends RsTableRowData>(row: T, column: RsTableColumn<T>, index: number, draft?: string): string;
+export declare function parseCellEditInput<T extends RsTableRowData>(input: string, row: T, column: RsTableColumn<T>, index: number, options?: {
+    allowNull?: boolean;
+}): unknown;
+export declare function validateCellValue<T extends RsTableRowData>(value: unknown, row: T, column: RsTableColumn<T>, index: number): string | null;
+export declare function validateCellValueAsync<T extends RsTableRowData>(value: unknown, row: T, column: RsTableColumn<T>, index: number): Promise<string | null>;
+export declare function isAsyncValidator<T extends RsTableRowData>(column: RsTableColumn<T>): boolean;
+/** 多行同列批量填充目标 */
+export declare function listBatchColumnTargets<T extends RsTableRowData>(options: {
+    rows: Array<{
+        row: T;
+        rowIndex: number;
+        rowKey: string;
+    }>;
+    column: RsTableColumn<T>;
+    tableEditable: boolean;
+    selectedKeys: string[];
+    anchorRowKey: string;
+}): Array<{
+    row: T;
+    rowIndex: number;
+    rowKey: string;
+}>;
+export declare function isCellValueChanged(previous: unknown, next: unknown): boolean;
+export declare function isRowEditPending<T extends RsTableRowData>(rowKey: string, row: T, rowIndex: number, options: {
+    isRowDirty: (rowKey: string) => boolean;
+    editingCell: {
+        rowKey: string;
+        colKey: string;
+    } | null;
+    editingDraft: string;
+    resolveColumn: (colKey: string) => RsTableColumn<T> | undefined;
+}): boolean;
+export interface RsTableEditableCellRef {
+    rowKey: string;
+    colKey: string;
+    rowIndex: number;
+}
+/** 按显示列顺序收集可编辑单元格（用于 Tab / 方向键） */
+export declare function listEditableCells<T extends RsTableRowData>(options: {
+    rows: T[];
+    columns: RsTableColumn<T>[];
+    tableEditable: boolean;
+    rowKeyOf: (row: T, index: number) => string;
+    skipBooleanToggle?: boolean;
+}): RsTableEditableCellRef[];
+export declare function findEditableCellIndex(cells: RsTableEditableCellRef[], rowKey: string, colKey: string): number;
+export declare function navigateEditableCell(cells: RsTableEditableCellRef[], rowKey: string, colKey: string, direction: RsTableCellNavigateDirection, columnsPerRow: number): RsTableEditableCellRef | null;
+/** 解析剪贴板 TSV/CSV（制表符优先） */
+export declare function parseClipboardGrid(text: string): string[][];
+export declare function applyFocusMode(input: HTMLInputElement | HTMLTextAreaElement, mode: RsTableCellEditFocusMode): void;

package/dist/components/table/src/utils/table-edit-utils.js

@@ -0,0 +1,282 @@
+import { formatDateTimeValue, formatDateValue } from "../../../date-picker/src/date-picker-utils.js";
+import { getCellValue } from "./table-utils.js";
+import { formatIsoUtcToLocal, looksLikeIsoDateTimeWithTz, parseLocalDateTimeToUtcIso } from "../../../../utils/iso-local-datetime.js";
+import "vue";
+//#region src/components/table/src/utils/table-edit-utils.ts
+/** 编辑草稿中的显式 NULL 哨兵（与空字符串区分） */
+var RS_TABLE_NULL_DRAFT = "__rs_null__";
+function isNullDraft(text) {
+	return text === RS_TABLE_NULL_DRAFT;
+}
+function nullToEditText() {
+	return RS_TABLE_NULL_DRAFT;
+}
+function resolveCellEditorInputType(valueType = "text") {
+	switch (valueType) {
+		case "number": return "number";
+		case "date": return "date";
+		case "datetime": return "datetime-local";
+		case "textarea": return "textarea";
+		default: return "text";
+	}
+}
+function resolveColumnValueType(column) {
+	return column.valueType ?? "text";
+}
+function resolveColumnEditorOptions(column, row, index = 0) {
+	const { options: rawOptions, ...rest } = column.editorOptions ?? {};
+	let options;
+	if (typeof rawOptions === "function") if (row != null) options = rawOptions(row, index);
+	else options = [];
+	else options = rawOptions;
+	return {
+		...rest,
+		options
+	};
+}
+/** 布尔列：展示态直接勾选切换，不挂载编辑器（大表友好）。 */
+function isBooleanToggleColumn(column) {
+	return resolveColumnValueType(column) === "boolean";
+}
+/** 浮层类编辑器（select/date）：点选即编辑，避免再双击。 */
+function usesOverlayEditor(valueType) {
+	return valueType === "select" || valueType === "date" || valueType === "datetime";
+}
+function resolveColumnEditTrigger(column, tableDefault) {
+	if (column.editTrigger) return column.editTrigger;
+	if (usesOverlayEditor(resolveColumnValueType(column))) return "click";
+	return tableDefault;
+}
+function resolveColumnCommitOn(column, rowCommit) {
+	if (rowCommit) return "manual";
+	if (column.commitOn) return column.commitOn;
+	const valueType = resolveColumnValueType(column);
+	if (valueType === "boolean" || valueType === "select") return "change";
+	if (valueType === "date" || valueType === "datetime") return "enter";
+	return "blur";
+}
+/** 单元格数据值（编辑 / 复制 / 对比）；不含 `render` 展示结果。 */
+function resolveColumnRawValue(row, column, _index) {
+	return getCellValue(row, column);
+}
+/**
+* 单元格展示内容：优先 `column.render`（支持 VNode），否则 formatter / 原始值。
+* `draft` 存在时展示编辑草稿的格式化文本。
+*/
+function resolveColumnDisplayContent(row, column, index, options) {
+	if (options?.draft !== void 0) return formatCellDisplayValue(options.draft, row, column, index, { nullLabel: options.nullLabel });
+	if (column.render) return column.render(row, index);
+	return formatCellDisplayValue(getCellValue(row, column), row, column, index, { nullLabel: options?.nullLabel });
+}
+function isColumnEditable(column, row, index, tableEditable) {
+	if (!tableEditable) return false;
+	if (typeof column.editable === "function") return column.editable(row, index);
+	if (column.editable === false) return false;
+	if (column.editable === true) return true;
+	return tableEditable;
+}
+function isColumnNullable(column, tableAllowNull) {
+	if (column.nullable === false) return false;
+	if (column.nullable === true) return true;
+	return tableAllowNull;
+}
+function coerceBoolean(value) {
+	if (typeof value === "boolean") return value;
+	if (typeof value === "number") return value !== 0;
+	const text = String(value ?? "").trim().toLowerCase();
+	if ([
+		"false",
+		"0",
+		"no",
+		"n",
+		"否",
+		"f",
+		""
+	].includes(text)) return false;
+	return [
+		"true",
+		"1",
+		"yes",
+		"y",
+		"是",
+		"t",
+		"✓",
+		"✔",
+		"√"
+	].includes(text);
+}
+function booleanToEditText(value) {
+	return coerceBoolean(value) ? "true" : "false";
+}
+/** 去掉千分位等展示噪音，便于 number 解析 */
+function stripNumberDecorations(input) {
+	return String(input ?? "").replace(/,/g, "").replace(/\s/g, "").trim();
+}
+function formatCellDisplayValue(value, row, column, index, options) {
+	if (column.formatter) return column.formatter(value, row, index);
+	if (value === null || value === void 0) return options?.nullLabel ?? "(NULL)";
+	if (isNullDraft(String(value))) return options?.nullLabel ?? "(NULL)";
+	const valueType = resolveColumnValueType(column);
+	if (valueType === "boolean") return coerceBoolean(value) ? "✓" : "";
+	if (valueType === "date") {
+		const raw = String(value);
+		const local = formatIsoUtcToLocal(raw);
+		if (local) return local.slice(0, 10);
+		return formatDateValue(raw) || raw;
+	}
+	if (valueType === "datetime") {
+		const raw = String(value);
+		const local = formatIsoUtcToLocal(raw);
+		if (local) return local;
+		return formatDateTimeValue(raw) || raw;
+	}
+	if (typeof value === "string") {
+		const local = formatIsoUtcToLocal(value);
+		if (local) return local;
+	}
+	return cellValueToText(value);
+}
+/** 单元格值 → 纯文本（对象用 JSON，避免 `[object Object]`）。 */
+function cellValueToText(value) {
+	if (value === null || value === void 0) return "";
+	if (typeof value === "string") return value;
+	if (typeof value === "number" || typeof value === "boolean" || typeof value === "bigint") return String(value);
+	if (typeof value === "object") try {
+		return JSON.stringify(value);
+	} catch {
+		return Object.prototype.toString.call(value);
+	}
+	return String(value);
+}
+function resolveCellEditText(row, column, index, draft) {
+	if (draft !== void 0) return draft;
+	const raw = resolveColumnRawValue(row, column, index);
+	if (raw === null || raw === void 0) return RS_TABLE_NULL_DRAFT;
+	const valueType = resolveColumnValueType(column);
+	if (valueType === "boolean") return booleanToEditText(raw);
+	if (typeof raw === "string") {
+		const local = formatIsoUtcToLocal(raw);
+		if (local) {
+			if (valueType === "date") return local.slice(0, 10);
+			return local;
+		}
+	}
+	if (valueType === "date") return formatDateValue(String(raw)) || String(raw);
+	if (valueType === "datetime") return formatDateTimeValue(String(raw)) || String(raw);
+	if (column.formatter) return cellValueToText(raw);
+	return cellValueToText(raw);
+}
+function parseCellEditInput(input, row, column, index, options) {
+	if (isNullDraft(input)) return null;
+	const allowNull = options?.allowNull ?? isColumnNullable(column, true);
+	if (column.emptyAsNull && allowNull && input.trim() === "") return null;
+	if (column.parser) return column.parser(input, row, index);
+	const valueType = resolveColumnValueType(column);
+	if (valueType === "boolean") return coerceBoolean(input);
+	if (valueType === "number") {
+		const cleaned = stripNumberDecorations(input);
+		if (!cleaned) return allowNull ? null : "";
+		const parsed = Number(cleaned);
+		return Number.isNaN(parsed) ? input : parsed;
+	}
+	const trimmed = input.trim();
+	const previous = resolveColumnRawValue(row, column, index);
+	if (typeof previous === "string" && looksLikeIsoDateTimeWithTz(previous.trim())) {
+		if (!trimmed) return allowNull ? null : "";
+		const utc = parseLocalDateTimeToUtcIso(trimmed, previous);
+		if (utc) return utc;
+	}
+	if (valueType === "datetime" && column.editorOptions?.timezone === "utc") {
+		if (!trimmed) return allowNull ? null : "";
+		const utc = parseLocalDateTimeToUtcIso(trimmed);
+		if (utc) return utc;
+		if (/Z$/i.test(trimmed) || /[+-]\d{2}:?\d{2}$/.test(trimmed)) return trimmed;
+		return `${trimmed.replace(" ", "T")}Z`;
+	}
+	return input;
+}
+async function validateCellValueAsync(value, row, column, index) {
+	if (!column.validator) return null;
+	return column.validator(value, row, index);
+}
+/** 多行同列批量填充目标 */
+function listBatchColumnTargets(options) {
+	const selected = new Set(options.selectedKeys);
+	if (selected.size <= 1 || !selected.has(options.anchorRowKey)) {
+		const anchor = options.rows.find((item) => item.rowKey === options.anchorRowKey);
+		return anchor ? [anchor] : [];
+	}
+	return options.rows.filter((item) => selected.has(item.rowKey) && isColumnEditable(options.column, item.row, item.rowIndex, options.tableEditable));
+}
+function isCellValueChanged(previous, next) {
+	if (previous === next) return false;
+	if (previous == null && next == null) return false;
+	if (typeof previous === "boolean" || typeof next === "boolean") return coerceBoolean(previous) !== coerceBoolean(next);
+	return cellValueToText(previous) !== cellValueToText(next);
+}
+function isRowEditPending(rowKey, row, rowIndex, options) {
+	if (options.isRowDirty(rowKey)) return true;
+	const editing = options.editingCell;
+	if (!editing || editing.rowKey !== rowKey) return false;
+	const column = options.resolveColumn(editing.colKey);
+	if (!column) return false;
+	return isCellValueChanged(resolveCellEditText(row, column, rowIndex), options.editingDraft);
+}
+/** 按显示列顺序收集可编辑单元格（用于 Tab / 方向键） */
+function listEditableCells(options) {
+	const result = [];
+	for (let rowIndex = 0; rowIndex < options.rows.length; rowIndex += 1) {
+		const row = options.rows[rowIndex];
+		const rowKey = options.rowKeyOf(row, rowIndex);
+		for (const column of options.columns) {
+			if (!isColumnEditable(column, row, rowIndex, options.tableEditable)) continue;
+			if (options.skipBooleanToggle && isBooleanToggleColumn(column)) continue;
+			result.push({
+				rowKey,
+				colKey: column.key,
+				rowIndex
+			});
+		}
+	}
+	return result;
+}
+function findEditableCellIndex(cells, rowKey, colKey) {
+	return cells.findIndex((cell) => cell.rowKey === rowKey && cell.colKey === colKey);
+}
+function navigateEditableCell(cells, rowKey, colKey, direction, columnsPerRow) {
+	if (!cells.length || columnsPerRow <= 0) return null;
+	const index = findEditableCellIndex(cells, rowKey, colKey);
+	if (index < 0) return cells[0] ?? null;
+	if (direction === "next") return cells[(index + 1) % cells.length] ?? null;
+	if (direction === "prev") return cells[(index - 1 + cells.length) % cells.length] ?? null;
+	const current = cells[index];
+	[...new Set(cells.map((cell) => cell.colKey))].indexOf(current.colKey);
+	const rowDelta = direction === "down" ? 1 : -1;
+	const targetRow = current.rowIndex + rowDelta;
+	const sameCol = cells.find((cell) => cell.rowIndex === targetRow && cell.colKey === current.colKey);
+	if (sameCol) return sameCol;
+	const candidates = cells.filter((cell) => cell.colKey === current.colKey);
+	if (!candidates.length) return null;
+	if (direction === "down") return candidates.find((cell) => cell.rowIndex > current.rowIndex) ?? candidates[0] ?? null;
+	return [...candidates].reverse().find((cell) => cell.rowIndex < current.rowIndex) ?? candidates[candidates.length - 1] ?? null;
+}
+/** 解析剪贴板 TSV/CSV（制表符优先） */
+function parseClipboardGrid(text) {
+	const lines = text.replace(/\r\n/g, "\n").replace(/\r/g, "\n").split("\n");
+	while (lines.length && lines[lines.length - 1] === "") lines.pop();
+	return lines.map((line) => line.split("	"));
+}
+function applyFocusMode(input, mode) {
+	const end = input.value.length;
+	if (mode === "select") {
+		input.select();
+		return;
+	}
+	if (mode === "start") {
+		input.setSelectionRange(0, 0);
+		return;
+	}
+	input.setSelectionRange(end, end);
+}
+//#endregion
+export { RS_TABLE_NULL_DRAFT, applyFocusMode, booleanToEditText, cellValueToText, coerceBoolean, findEditableCellIndex, formatCellDisplayValue, isBooleanToggleColumn, isCellValueChanged, isColumnEditable, isColumnNullable, isNullDraft, isRowEditPending, listBatchColumnTargets, listEditableCells, navigateEditableCell, nullToEditText, parseCellEditInput, parseClipboardGrid, resolveCellEditText, resolveCellEditorInputType, resolveColumnCommitOn, resolveColumnDisplayContent, resolveColumnEditTrigger, resolveColumnEditorOptions, resolveColumnRawValue, resolveColumnValueType, stripNumberDecorations, usesOverlayEditor, validateCellValueAsync };

package/dist/components/table/src/utils/table-summary-utils.d.ts

@@ -0,0 +1,90 @@
+/**
+ * RsTable 列汇总纯函数：聚合算法、footer 单元格构建、兼容性警告。
+ *
+ * 不依赖 Vue；由 RsTable 在 computed 中调用。
+ * 聚合范围约定为「当前 viewRows」（筛选/排序后的业务行），不含 group/expand 伪行。
+ */
+import type { RsTableColumn, RsTableRowData } from './table-utils';
+/** 列汇总类型：内置数值聚合 + custom reduce */
+export type RsTableSummaryType = 'sum' | 'avg' | 'count' | 'min' | 'max' | 'custom';
+/**
+ * 列级汇总配置（挂在 `RsTableColumn.summary`）。
+ *
+ * - sum/avg/min/max：从行字段取可解析数字；无可解析值时单元格为空
+ * - count：行数（不读字段）
+ * - custom：必须提供 `reduce`
+ */
+export interface RsTableColumnSummary<T extends RsTableRowData = RsTableRowData> {
+    type: RsTableSummaryType;
+    /** 展示格式化；未传时用默认 String(value) */
+    formatter?: (value: number | string, rows: T[]) => string;
+    /** type=custom 时必填；返回值再经 formatter（若有） */
+    reduce?: (rows: T[]) => string | number;
+}
+/**
+ * 汇总数据来源：
+ * - client：本地对 viewRows 聚合
+ * - server：直接展示业务传入的 summaryData，不做本地 reduce
+ */
+export type RsTableSummaryMode = 'client' | 'server';
+/** 服务端汇总：列 key → 展示值（null/undefined 显示为空） */
+export type RsTableSummaryData = Record<string, string | number | null | undefined>;
+/** 单列汇总单元格结果（供 footer 行渲染） */
+export interface RsTableSummaryCell {
+    key: string;
+    /** 原始聚合值；无数据时为 null */
+    value: string | number | null;
+    /** 已格式化的展示文案 */
+    text: string;
+}
+/**
+ * 对单列做汇总。列未配置 `summary` 时返回 null（由调用方填空单元格）。
+ *
+ * @param column 含可选 summary 的列定义
+ * @param rows 参与聚合的业务行（通常为 Engine.viewRows）
+ */
+export declare function aggregateColumnSummary<T extends RsTableRowData>(column: RsTableColumn<T> & {
+    summary?: RsTableColumnSummary<T>;
+}, rows: readonly T[]): RsTableSummaryCell | null;
+/**
+ * 计算整行 footer 汇总单元格（与 displayColumns 一一对应）。
+ *
+ * - client：按 columns.summary 对 rows 聚合；无 summary 的列 text 为空
+ * - server：优先读 summaryData[key]；仍可用列上 formatter；忽略本地 sum/avg 等
+ *
+ * @returns 与 columns 等长的单元格数组
+ */
+export declare function buildTableSummaryCells<T extends RsTableRowData>(options: {
+    columns: Array<RsTableColumn<T> & {
+        summary?: RsTableColumnSummary<T>;
+    }>;
+    rows: readonly T[];
+    mode: RsTableSummaryMode;
+    summaryData?: RsTableSummaryData | null;
+}): RsTableSummaryCell[];
+/**
+ * 是否存在任何可展示的汇总配置。
+ *
+ * - client：任一列带 summary
+ * - server：summaryData 非空对象
+ *
+ * 用于决定是否启用 summary feature / 渲染内置汇总行。
+ */
+export declare function hasTableSummaryConfig<T extends RsTableRowData>(options: {
+    columns: Array<RsTableColumn<T> & {
+        summary?: RsTableColumnSummary<T>;
+    }>;
+    mode: RsTableSummaryMode;
+    summaryData?: RsTableSummaryData | null;
+}): boolean;
+/**
+ * summary 与互斥/易误解能力的兼容矩阵检查（仅 DEV 警告）。
+ *
+ * - tree：合计基于已展开的 viewRows，不含折叠子节点
+ * - detail expandable：合计不含 expand 明细槽内容
+ */
+export declare function warnSummaryCompatibility(flags: {
+    summaryEnabled: boolean;
+    tree: boolean;
+    detailExpandable: boolean;
+}): void;