niuma-ui 1.3.8 → 2.0.0

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;

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

@@ -0,0 +1,97 @@
+import { resolveColumnRawValue } from "./table-edit-utils.js";
+//#region src/components/table/src/utils/table-summary-utils.ts
+/** 将未知值解析为有限数字；失败返回 null（跳过该行） */
+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;
+}
+/**
+* 收集列上可解析的数值序列。
+* 取值路径与编辑/复制一致：resolveColumnRawValue（dataIndex / key）。
+*/
+function collectNumericValues(rows, column) {
+	const nums = [];
+	for (let i = 0; i < rows.length; i += 1) {
+		const n = toNumber(resolveColumnRawValue(rows[i], column, i));
+		if (n != null) nums.push(n);
+	}
+	return nums;
+}
+/**
+* 对单列做汇总。列未配置 `summary` 时返回 null（由调用方填空单元格）。
+*
+* @param column 含可选 summary 的列定义
+* @param rows 参与聚合的业务行（通常为 Engine.viewRows）
+*/
+function aggregateColumnSummary(column, rows) {
+	const config = column.summary;
+	if (!config) return null;
+	let value = null;
+	if (config.type === "custom") value = config.reduce ? config.reduce(rows) : null;
+	else if (config.type === "count") value = rows.length;
+	else {
+		const nums = collectNumericValues(rows, column);
+		if (nums.length === 0) value = null;
+		else if (config.type === "sum") value = nums.reduce((a, b) => a + b, 0);
+		else if (config.type === "avg") value = nums.reduce((a, b) => a + b, 0) / nums.length;
+		else if (config.type === "min") value = Math.min(...nums);
+		else if (config.type === "max") value = Math.max(...nums);
+	}
+	const text = value == null ? "" : config.formatter ? config.formatter(value, rows) : String(value);
+	return {
+		key: column.key,
+		value,
+		text
+	};
+}
+/**
+* 计算整行 footer 汇总单元格（与 displayColumns 一一对应）。
+*
+* - client：按 columns.summary 对 rows 聚合；无 summary 的列 text 为空
+* - server：优先读 summaryData[key]；仍可用列上 formatter；忽略本地 sum/avg 等
+*
+* @returns 与 columns 等长的单元格数组
+*/
+function buildTableSummaryCells(options) {
+	const { columns, rows, mode, summaryData } = options;
+	if (mode === "server") return columns.map((column) => {
+		if (!column.summary && summaryData?.[column.key] === void 0) return {
+			key: column.key,
+			value: null,
+			text: ""
+		};
+		const raw = summaryData?.[column.key];
+		const value = raw == null ? null : raw;
+		const text = value == null ? "" : column.summary?.formatter ? column.summary.formatter(value, rows) : String(value);
+		return {
+			key: column.key,
+			value,
+			text
+		};
+	});
+	return columns.map((column) => {
+		return aggregateColumnSummary(column, rows) ?? {
+			key: column.key,
+			value: null,
+			text: ""
+		};
+	});
+}
+/**
+* 是否存在任何可展示的汇总配置。
+*
+* - client：任一列带 summary
+* - server：summaryData 非空对象
+*
+* 用于决定是否启用 summary feature / 渲染内置汇总行。
+*/
+function hasTableSummaryConfig(options) {
+	if (options.mode === "server") return Boolean(options.summaryData && Object.keys(options.summaryData).length > 0);
+	return options.columns.some((column) => Boolean(column.summary));
+}
+//#endregion
+export { aggregateColumnSummary, buildTableSummaryCells, hasTableSummaryConfig };