niuma-ui 1.3.8 → 2.0.0

package/dist/components/table/src/table-header/RsTableHeaderFilter.js

@@ -0,0 +1,8 @@
+import './RsTableHeaderFilter.css'
+import _plugin_vue_export_helper_default from "../../../../_virtual/_plugin-vue_export-helper.js";
+import RsTableHeaderFilter_vue_vue_type_script_setup_true_lang_default from "./RsTableHeaderFilter.impl.js";
+
+//#region src/components/table/src/table-header/RsTableHeaderFilter.vue
+var RsTableHeaderFilter_default = /*#__PURE__*/ _plugin_vue_export_helper_default(RsTableHeaderFilter_vue_vue_type_script_setup_true_lang_default, [["__scopeId", "data-v-28f84199"]]);
+//#endregion
+export { RsTableHeaderFilter_default as default };

package/dist/components/table/src/table-header/rs-table-header-types.d.ts

@@ -0,0 +1,45 @@
+/**
+ * RsTableHeader 视图契约（对标列头渲染层，与 Engine 解耦）。
+ */
+import type { CSSProperties } from 'vue';
+import type { RsTableColumn, RsTableRowData } from '../utils/table-utils';
+export interface RsTableHeaderProps<T extends RsTableRowData = RsTableRowData> {
+    showRowDragHandle: boolean;
+    detailExpandable: boolean;
+    showSelectColumn: boolean;
+    isRadioSelection: boolean;
+    selectAllState: 'checked' | 'indeterminate' | 'unchecked';
+    showEditGutterColumn: boolean;
+    showIndexColumn: boolean;
+    showRowStatusColumn: boolean;
+    columnPadLeft: number;
+    columnPadRight: number;
+    visibleDataColumns: RsTableColumn<T>[];
+    columnDraggable: boolean;
+    resizable: boolean;
+    multiSort: boolean;
+    columnFiltersState: Record<string, string>;
+    dragColumnKey: string | null;
+    dropColumnKey: string | null;
+    dragLeadHeaderStyle: CSSProperties | Record<string, string> | undefined;
+    expandLeadHeaderStyle: CSSProperties | Record<string, string> | undefined;
+    selectLeadHeaderStyle: CSSProperties | Record<string, string> | undefined;
+    gutterLeadHeaderStyle: CSSProperties | Record<string, string> | undefined;
+    indexLeadHeaderStyle: CSSProperties | Record<string, string> | undefined;
+    columnHeaderStyleMap: Map<string, Record<string, string> | undefined>;
+    columnFilterValue: (key: string) => string;
+    isColumnFilterActive: (filters: Record<string, string>, key: string) => boolean;
+    sortOrderFor: (key: string) => string | null | undefined;
+    sortPriorityFor: (key: string) => number;
+    sortIconName: (key: string) => string;
+    labels: {
+        selectAll: string;
+        index: string;
+        rowStatus: string;
+        dragColumn: string;
+        filterColumn: string;
+        filterPlaceholder: string;
+        filterClear: string;
+        filterApply: string;
+    };
+}

package/dist/components/table/src/utils/rs-table-compat-matrix.js

@@ -0,0 +1,64 @@
+import { RS_TABLE_API_VERSION } from "../rs-table-api.js";
+import { RS_TABLE_PROP_DEFAULTS } from "../rs-table-props.js";
+//#region src/components/table/src/utils/rs-table-compat-matrix.ts
+/**
+* RsTable 公开契约兼容矩阵（单一真源）。
+*
+* - 测试锁定这些键：删除/改名 = 失败，须 bump RS_TABLE_API_VERSION
+* - 文档与 CI 共用，避免矩阵与实现漂移
+*/
+/** 当前锁定的 API 契约版本（与 createRsTableApi 一致） */
+var RS_TABLE_COMPAT_API_VERSION = RS_TABLE_API_VERSION;
+/**
+* 1.0.x 必选 Api 方法（加性可选方法不在此列）。
+* 删减任一项视为 breaking。
+*/
+var RS_TABLE_API_REQUIRED_METHODS = [
+	"getRowByKey",
+	"getRowByIndex",
+	"getColumnValues",
+	"getCellValue",
+	"getViewRows",
+	"getSelectedRows",
+	"getSelectedRowKeys",
+	"getAnalyticsSnapshot",
+	"subscribeAnalytics",
+	"getHighlightedRowKey",
+	"setHighlightedRowKey",
+	"cancelCellEdit",
+	"cancelAllEdits",
+	"getDirtyCellKeys",
+	"getCellError",
+	"setCellError",
+	"stageCell",
+	"rejectRowEdit",
+	"undoEdit",
+	"redoEdit",
+	"commitRowEdits",
+	"rollbackRowEdits"
+];
+/** 1.0.x 加性可选 Api（可缺省，但若存在须为函数） */
+var RS_TABLE_API_OPTIONAL_METHODS = [
+	"getActiveFeatureIds",
+	"getToolbarItems",
+	"getOverlayContributions"
+];
+/**
+* 稳定 emit 名（同主版本不删）。
+* 新增 emit 可追加到测试期望的超集校验。
+*/
+var RS_TABLE_STABLE_EMITS = [
+	"rowClick",
+	"rowDblclick",
+	"cellView",
+	"update:selectedRowKeys",
+	"selectionChange",
+	"loadMore",
+	"cellEditCommit",
+	"cellEditCancel",
+	"rowEditCommit",
+	"rowEditRollback"
+];
+Object.keys(RS_TABLE_PROP_DEFAULTS).sort();
+//#endregion
+export { RS_TABLE_API_OPTIONAL_METHODS, RS_TABLE_API_REQUIRED_METHODS, RS_TABLE_COMPAT_API_VERSION, RS_TABLE_STABLE_EMITS };

package/dist/components/table/src/utils/rs-table-echarts-adapter.js

@@ -0,0 +1,49 @@
+//#region src/components/table/src/utils/rs-table-echarts-adapter.ts
+function mapKind(kind) {
+	if (kind === "pie") return "pie";
+	if (kind === "line") return "line";
+	return "bar";
+}
+/**
+* 将库无关 series 映射为可直接 setOption 的 ECharts option。
+*/
+function mapRsTableSeriesToEChartsOption(seriesList, options = {}) {
+	if (!seriesList.length) return { series: [] };
+	const allPie = seriesList.every((s) => s.kind === "pie");
+	const tooltipTrigger = options.tooltipTrigger ?? (allPie ? "item" : "axis");
+	if (allPie) return {
+		tooltip: { trigger: tooltipTrigger },
+		legend: { data: seriesList.flatMap((s) => s.categories) },
+		series: seriesList.map((s) => ({
+			id: s.id,
+			name: s.id,
+			type: "pie",
+			data: s.points.map((p) => ({
+				name: p.name,
+				value: p.value
+			}))
+		}))
+	};
+	const shared = options.sharedCategoryAxis !== false;
+	const primary = seriesList[0];
+	return {
+		tooltip: { trigger: tooltipTrigger },
+		legend: { data: seriesList.map((s) => s.id) },
+		xAxis: shared ? {
+			type: "category",
+			data: primary.categories
+		} : seriesList.map((s) => ({
+			type: "category",
+			data: s.categories
+		})),
+		yAxis: { type: "value" },
+		series: seriesList.map((s) => ({
+			id: s.id,
+			name: s.id,
+			type: mapKind(s.kind),
+			data: s.values
+		}))
+	};
+}
+//#endregion
+export { mapRsTableSeriesToEChartsOption };

package/dist/components/table/src/utils/rs-table-grid-nav.js

@@ -0,0 +1,80 @@
+//#region src/components/table/src/utils/rs-table-grid-nav.ts
+/**
+* 在「行列表 × 列 key」矩形上移动焦点。
+* rows 按视觉顺序；colKeys 为可见数据列顺序。
+*/
+function navigateGridCell(rows, colKeys, current, direction, pageSize = 10) {
+	if (!rows.length || !colKeys.length) return null;
+	const seed = current ?? {
+		rowKey: rows[0].rowKey,
+		colKey: colKeys[0],
+		rowIndex: rows[0].rowIndex
+	};
+	let rowPos = rows.findIndex((r) => r.rowKey === seed.rowKey);
+	if (rowPos < 0) rowPos = 0;
+	let colPos = colKeys.indexOf(seed.colKey);
+	if (colPos < 0) colPos = 0;
+	const lastRow = rows.length - 1;
+	const lastCol = colKeys.length - 1;
+	const step = Math.max(1, pageSize);
+	switch (direction) {
+		case "left":
+			colPos = Math.max(0, colPos - 1);
+			break;
+		case "right":
+			colPos = Math.min(lastCol, colPos + 1);
+			break;
+		case "up":
+			rowPos = Math.max(0, rowPos - 1);
+			break;
+		case "down":
+			rowPos = Math.min(lastRow, rowPos + 1);
+			break;
+		case "home":
+			colPos = 0;
+			break;
+		case "end":
+			colPos = lastCol;
+			break;
+		case "first":
+			rowPos = 0;
+			colPos = 0;
+			break;
+		case "last":
+			rowPos = lastRow;
+			colPos = lastCol;
+			break;
+		case "pageUp":
+			rowPos = Math.max(0, rowPos - step);
+			break;
+		case "pageDown":
+			rowPos = Math.min(lastRow, rowPos + step);
+			break;
+		default: break;
+	}
+	const row = rows[rowPos];
+	return {
+		rowKey: row.rowKey,
+		colKey: colKeys[colPos],
+		rowIndex: row.rowIndex
+	};
+}
+/**
+* 将 KeyboardEvent 映射为网格导航方向；无法识别则返回 null。
+*/
+function resolveGridNavDirection(event) {
+	const mod = event.ctrlKey || event.metaKey;
+	switch (event.key) {
+		case "ArrowLeft": return "left";
+		case "ArrowRight": return "right";
+		case "ArrowUp": return "up";
+		case "ArrowDown": return "down";
+		case "Home": return mod ? "first" : "home";
+		case "End": return mod ? "last" : "end";
+		case "PageUp": return "pageUp";
+		case "PageDown": return "pageDown";
+		default: return null;
+	}
+}
+//#endregion
+export { navigateGridCell, resolveGridNavDirection };

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

@@ -0,0 +1,62 @@
+/**
+ * 表格 → 图表系列纯函数（库无关）。
+ *
+ * 产出结构可直接喂给 ECharts / Chart.js 等：
+ * - pie / 普通 bar：points[{ name, value }]
+ * - 分类轴 bar：categories + values
+ *
+ * 不引入任何图表依赖，避免拖重内核。
+ */
+import type { RsTableRowData } from './table-utils';
+/** 图表意图类型（渲染层自行映射到具体库） */
+export type RsTableChartKind = 'bar' | 'pie' | 'line';
+/** 单点：饼图扇区 / 柱条 */
+export interface RsTableChartPoint {
+    /** 分类名（展示） */
+    name: string;
+    /** 聚合值 */
+    value: number;
+    /** 原始分类 key（与 name 通常相同，供下钻） */
+    key: string;
+    /** 该分类下的行数（便于 tooltip） */
+    count: number;
+}
+/** 一组图表系列 */
+export interface RsTableChartSeries {
+    id: string;
+    kind: RsTableChartKind;
+    points: RsTableChartPoint[];
+    /** 分类轴（与 points 顺序一致） */
+    categories: string[];
+    /** 数值轴（与 points 顺序一致） */
+    values: number[];
+}
+export type RsTableChartValueAgg = 'count' | 'sum' | 'avg' | 'min' | 'max';
+/**
+ * 图表系列定义。
+ * - categoryField：分组字段
+ * - valueField + valueAgg：度量；仅 count 时可省略 valueField
+ */
+export interface RsTableChartSeriesDef {
+    id: string;
+    kind: RsTableChartKind;
+    categoryField: string;
+    valueField?: string;
+    valueAgg?: RsTableChartValueAgg;
+    /** 最多保留前 N 类，其余合并为 otherLabel；0/不传表示不截断 */
+    topN?: number;
+    otherLabel?: string;
+    /** 空分类展示名 */
+    emptyCategoryLabel?: string;
+}
+/**
+ * 按分类字段对行做聚合，生成库无关图表系列。
+ *
+ * @param rows 通常为 SelectionSource.sourceRows（选中优先）
+ * @param def 系列定义
+ */
+export declare function buildTableChartSeries<T extends RsTableRowData>(rows: readonly T[], def: RsTableChartSeriesDef): RsTableChartSeries;
+/**
+ * 批量构建多组系列（同一 sourceRows，多套分组/度量）。
+ */
+export declare function buildTableChartSeriesList<T extends RsTableRowData>(rows: readonly T[], defs: readonly RsTableChartSeriesDef[]): RsTableChartSeries[];

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

@@ -0,0 +1,91 @@
+//#region src/components/table/src/utils/table-chart-utils.ts
+function readField(row, field) {
+	return row[field];
+}
+function toNumber(value) {
+	if (typeof value === "number" && Number.isFinite(value)) return value;
+	if (typeof value === "string" && value.trim() !== "") {
+		const n = Number(value);
+		return Number.isFinite(n) ? n : null;
+	}
+	return null;
+}
+function categoryKey(raw, emptyLabel) {
+	if (raw == null || raw === "") return emptyLabel;
+	return String(raw);
+}
+function aggregateBucket(bucket, agg) {
+	if (agg === "count") return bucket.count;
+	if (!bucket.nums.length) return 0;
+	if (agg === "sum") return bucket.nums.reduce((a, b) => a + b, 0);
+	if (agg === "avg") return bucket.nums.reduce((a, b) => a + b, 0) / bucket.nums.length;
+	if (agg === "min") return Math.min(...bucket.nums);
+	if (agg === "max") return Math.max(...bucket.nums);
+	return 0;
+}
+/**
+* 按分类字段对行做聚合，生成库无关图表系列。
+*
+* @param rows 通常为 SelectionSource.sourceRows（选中优先）
+* @param def 系列定义
+*/
+function buildTableChartSeries(rows, def) {
+	const emptyLabel = def.emptyCategoryLabel ?? "(空)";
+	const agg = def.valueAgg ?? (def.valueField ? "sum" : "count");
+	const map = /* @__PURE__ */ new Map();
+	for (let i = 0; i < rows.length; i += 1) {
+		const row = rows[i];
+		const key = categoryKey(readField(row, def.categoryField), emptyLabel);
+		let bucket = map.get(key);
+		if (!bucket) {
+			bucket = {
+				key,
+				name: key,
+				count: 0,
+				nums: []
+			};
+			map.set(key, bucket);
+		}
+		bucket.count += 1;
+		if (def.valueField && agg !== "count") {
+			const n = toNumber(readField(row, def.valueField));
+			if (n != null) bucket.nums.push(n);
+		}
+	}
+	let points = [...map.values()].map((bucket) => ({
+		key: bucket.key,
+		name: bucket.name,
+		value: aggregateBucket(bucket, agg),
+		count: bucket.count
+	}));
+	points.sort((a, b) => b.value - a.value || a.name.localeCompare(b.name));
+	const topN = def.topN ?? 0;
+	if (topN > 0 && points.length > topN) {
+		const head = points.slice(0, topN);
+		const rest = points.slice(topN);
+		const otherValue = rest.reduce((s, p) => s + p.value, 0);
+		const otherCount = rest.reduce((s, p) => s + p.count, 0);
+		head.push({
+			key: "__other__",
+			name: def.otherLabel ?? "其他",
+			value: otherValue,
+			count: otherCount
+		});
+		points = head;
+	}
+	return {
+		id: def.id,
+		kind: def.kind,
+		points,
+		categories: points.map((p) => p.name),
+		values: points.map((p) => p.value)
+	};
+}
+/**
+* 批量构建多组系列（同一 sourceRows，多套分组/度量）。
+*/
+function buildTableChartSeriesList(rows, defs) {
+	return defs.map((def) => buildTableChartSeries(rows, def));
+}
+//#endregion
+export { buildTableChartSeries, buildTableChartSeriesList };

package/dist/components/table/src/utils/table-context-menu.d.ts

@@ -0,0 +1,13 @@
+import type { RsContextMenuItem } from '../../../context-menu/src/context-menu-utils';
+import type { RsTableColumn, RsTableRowData } from './table-utils';
+export declare const TABLE_CTX_COPY_CELL = "copyCell";
+export declare const TABLE_CTX_COPY_ROW = "copyRow";
+export declare function buildDefaultTableContextMenuItems(options: {
+    copyCellLabel: string;
+    copyRowLabel: string;
+    hasRow: boolean;
+    hasCell: boolean;
+}): RsContextMenuItem[];
+export declare function resolveTableCellCopyText<T extends RsTableRowData>(row: T, column: RsTableColumn<T>, rowIndex: number, draft?: string): string;
+export declare function resolveTableRowCopyText<T extends RsTableRowData>(row: T, rowIndex: number, columns: RsTableColumn<T>[], getDraft?: (rowKey: string, colKey: string) => string | undefined, rowKey?: string): string;
+export declare function isBuiltInTableContextMenuKey(key: string): boolean;

package/dist/components/table/src/utils/table-context-menu.js

@@ -0,0 +1,30 @@
+import { formatCellDisplayValue, resolveCellEditText, resolveColumnRawValue } from "./table-edit-utils.js";
+//#region src/components/table/src/utils/table-context-menu.ts
+var TABLE_CTX_COPY_CELL = "copyCell";
+var TABLE_CTX_COPY_ROW = "copyRow";
+function buildDefaultTableContextMenuItems(options) {
+	const items = [];
+	if (options.hasRow && options.hasCell) items.push({
+		key: TABLE_CTX_COPY_CELL,
+		label: options.copyCellLabel,
+		icon: "copy"
+	});
+	if (options.hasRow) items.push({
+		key: TABLE_CTX_COPY_ROW,
+		label: options.copyRowLabel,
+		icon: "copy"
+	});
+	return items;
+}
+function resolveTableCellCopyText(row, column, rowIndex, draft) {
+	return resolveCellEditText(row, column, rowIndex, draft);
+}
+function resolveTableRowCopyText(row, rowIndex, columns, getDraft, rowKey) {
+	return columns.map((column) => {
+		const draft = rowKey && getDraft ? getDraft(rowKey, column.key) : void 0;
+		if (draft !== void 0) return formatCellDisplayValue(draft, row, column, rowIndex);
+		return formatCellDisplayValue(resolveColumnRawValue(row, column, rowIndex), row, column, rowIndex);
+	}).join("	");
+}
+//#endregion
+export { TABLE_CTX_COPY_CELL, TABLE_CTX_COPY_ROW, buildDefaultTableContextMenuItems, resolveTableCellCopyText, resolveTableRowCopyText };

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;