niuma-ui 1.1.11 → 1.2.0

package/dist/components/table/rs-table-view-context.js

@@ -0,0 +1,47 @@
+import { inject, provide } from "vue";
+//#region src/components/table/rs-table-view-context.ts
+/**
+* RsTable 视图上下文（provide/inject）。
+*
+* 多表隔离（关键）：
+* - 每个 RsTable 实例在自身 setup 内 provide，子树 inject 最近祖先
+* - 同页多表互不影响：A 的 Header/Body 不会读到 B 的 view
+* - 禁止把 view 存到模块级单例；instanceId 仅用于诊断
+*
+* 对比：RsTableModuleRegistry 是进程级全局（同 AG Grid ModuleRegistry），
+* 会作用于所有实例；实例专属能力请用 props.features。
+*/
+/** 每实例递增，仅诊断用，不参与业务逻辑 */
+var viewInstanceSeq = 0;
+var RS_TABLE_VIEW_KEY = Symbol("rsTableView");
+/**
+* 显式区分 state getters 与 handlers，避免把零参 handler 误当成状态 getter。
+*/
+function createRsTableViewContext(parts) {
+	const ctx = { instanceId: `rs-table-view-${++viewInstanceSeq}` };
+	for (const [key, getter] of Object.entries(parts.state)) {
+		if (!getter) continue;
+		Object.defineProperty(ctx, key, {
+			enumerable: true,
+			configurable: true,
+			get: getter
+		});
+	}
+	for (const [key, fn] of Object.entries(parts.handlers)) if (fn !== void 0) ctx[key] = fn;
+	return ctx;
+}
+/** 在 RsTable 内 provide（每个实例调用一次） */
+function provideRsTableView(ctx) {
+	provide(RS_TABLE_VIEW_KEY, ctx);
+}
+/**
+* 子视图 inject；必须在某个 RsTable 子树内。
+* 多表场景下自动绑定到最近的表格实例。
+*/
+function useRsTableView() {
+	const ctx = inject(RS_TABLE_VIEW_KEY, null);
+	if (!ctx) throw new Error("[RsTable] useRsTableView() 必须在 RsTable 子树内调用（每表独立 provide，多表互不串扰）");
+	return ctx;
+}
+//#endregion
+export { RS_TABLE_VIEW_KEY, createRsTableViewContext, provideRsTableView, useRsTableView };

package/dist/components/table/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/table-chart-utils.js

@@ -0,0 +1,91 @@
+//#region src/components/table/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/table-context-menu.d.ts

@@ -0,0 +1,13 @@
+import type { RsContextMenuItem } from '../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/table-context-menu.js

@@ -0,0 +1,30 @@
+import { formatCellDisplayValue, resolveCellEditText, resolveColumnRawValue } from "./table-edit-utils.js";
+//#region src/components/table/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/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/table-edit-utils.js

@@ -0,0 +1,282 @@
+import { formatDateTimeValue, formatDateValue } from "../date-picker-utils.js";
+import { getCellValue } from "../table-utils.js";
+import { formatIsoUtcToLocal, looksLikeIsoDateTimeWithTz, parseLocalDateTimeToUtcIso } from "../../lib/iso-local-datetime.js";
+import "vue";
+//#region src/components/table/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 };