ensis-ui 0.0.0-stage → 3.0.0

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

@@ -0,0 +1,102 @@
+import RsIcon_default from "../../../icon/src/RsIcon.js";
+import RsButton_default from "../../../button/src/RsButton.js";
+import RsPopover_default from "../../../popover/src/RsPopover.js";
+import RsTableCellEditor_default from "../table-body/RsTableCellEditor.js";
+import { computed, createBlock, createElementVNode, createTextVNode, createVNode, defineComponent, mergeModels, normalizeClass, openBlock, ref, toDisplayString, useModel, watch, withCtx, withModifiers } from "vue";
+//#region src/components/table/src/table-header/RsTableHeaderFilter.vue?vue&type=script&setup=true&lang.ts
+var _hoisted_1 = ["title", "aria-label"];
+var _hoisted_2 = { class: "rs-table-header-filter" };
+var _hoisted_3 = { class: "rs-table-header-filter__title" };
+var _hoisted_4 = { class: "rs-table-header-filter__field" };
+var _hoisted_5 = { class: "rs-table-header-filter__actions" };
+var RsTableHeaderFilter_vue_vue_type_script_setup_true_lang_default = /*@__PURE__*/ defineComponent({
+	__name: "RsTableHeaderFilter",
+	props: /*@__PURE__*/ mergeModels({
+		columnTitle: {},
+		filterLabel: {},
+		placeholder: {},
+		clearLabel: {},
+		applyLabel: {},
+		active: { type: Boolean }
+	}, {
+		"modelValue": { default: "" },
+		"modelModifiers": {}
+	}),
+	emits: ["update:modelValue"],
+	setup(__props) {
+		const props = __props;
+		const model = useModel(__props, "modelValue");
+		const open = ref(false);
+		const draft = ref(model.value);
+		watch(open, (value) => {
+			if (value) draft.value = model.value;
+		});
+		watch(model, (value) => {
+			if (!open.value) draft.value = value;
+		});
+		const ariaLabel = computed(() => props.filterLabel.replace("{title}", props.columnTitle));
+		function apply() {
+			model.value = draft.value;
+			open.value = false;
+		}
+		function clear() {
+			draft.value = "";
+			model.value = "";
+			open.value = false;
+		}
+		function onEditorEnter() {
+			apply();
+		}
+		return (_ctx, _cache) => {
+			return openBlock(), createBlock(RsPopover_default, {
+				open: open.value,
+				"onUpdate:open": _cache[2] || (_cache[2] = ($event) => open.value = $event),
+				side: "bottom",
+				align: "end",
+				width: "md",
+				"lazy-mount": ""
+			}, {
+				content: withCtx(() => [createElementVNode("div", _hoisted_2, [
+					createElementVNode("p", _hoisted_3, toDisplayString(__props.columnTitle), 1),
+					createElementVNode("div", _hoisted_4, [createVNode(RsTableCellEditor_default, {
+						modelValue: draft.value,
+						"onUpdate:modelValue": _cache[1] || (_cache[1] = ($event) => draft.value = $event),
+						"value-type": "text",
+						variant: "field",
+						size: "sm",
+						"commit-on": "enter",
+						placeholder: __props.placeholder,
+						onCommit: onEditorEnter
+					}, null, 8, ["modelValue", "placeholder"])]),
+					createElementVNode("div", _hoisted_5, [createVNode(RsButton_default, {
+						size: "sm",
+						variant: "ghost",
+						onClick: clear
+					}, {
+						default: withCtx(() => [createTextVNode(toDisplayString(__props.clearLabel), 1)]),
+						_: 1
+					}), createVNode(RsButton_default, {
+						size: "sm",
+						onClick: apply
+					}, {
+						default: withCtx(() => [createTextVNode(toDisplayString(__props.applyLabel), 1)]),
+						_: 1
+					})])
+				])]),
+				default: withCtx(() => [createElementVNode("button", {
+					type: "button",
+					class: normalizeClass(["rs-table__filter", { "rs-table__filter--active": __props.active }]),
+					title: ariaLabel.value,
+					"aria-label": ariaLabel.value,
+					onClick: _cache[0] || (_cache[0] = withModifiers(() => {}, ["stop"]))
+				}, [createVNode(RsIcon_default, {
+					name: "list-filter",
+					size: "sm"
+				})], 10, _hoisted_1)]),
+				_: 1
+			}, 8, ["open"]);
+		};
+	}
+});
+//#endregion
+export { RsTableHeaderFilter_vue_vue_type_script_setup_true_lang_default as default };

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.d.ts

@@ -0,0 +1,24 @@
+/**
+ * RsTable 公开契约兼容矩阵（单一真源）。
+ *
+ * - 测试锁定这些键：删除/改名 = 失败，须 bump RS_TABLE_API_VERSION
+ * - 文档与 CI 共用，避免矩阵与实现漂移
+ */
+/** 当前锁定的 API 契约版本（与 createRsTableApi 一致） */
+export declare const RS_TABLE_COMPAT_API_VERSION: "1.0.0";
+/**
+ * 1.0.x 必选 Api 方法（加性可选方法不在此列）。
+ * 删减任一项视为 breaking。
+ */
+export declare const RS_TABLE_API_REQUIRED_METHODS: readonly ["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（可缺省，但若存在须为函数） */
+export declare const RS_TABLE_API_OPTIONAL_METHODS: readonly ["getActiveFeatureIds", "getToolbarItems", "getOverlayContributions"];
+/**
+ * 稳定 emit 名（同主版本不删）。
+ * 新增 emit 可追加到测试期望的超集校验。
+ */
+export declare const RS_TABLE_STABLE_EMITS: readonly ["rowClick", "rowDblclick", "cellView", "update:selectedRowKeys", "selectionChange", "loadMore", "cellEditCommit", "cellEditCancel", "rowEditCommit", "rowEditRollback"];
+/** 带默认值的 props 键（与 RS_TABLE_PROP_DEFAULTS 同步校验） */
+export declare const RS_TABLE_DEFAULTED_PROP_KEYS: string[];
+export type RsTableApiRequiredMethod = (typeof RS_TABLE_API_REQUIRED_METHODS)[number];
+export type RsTableApiOptionalMethod = (typeof RS_TABLE_API_OPTIONAL_METHODS)[number];

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.d.ts

@@ -0,0 +1,47 @@
+/**
+ * RsTable 系列 → ECharts option 纯映射（不依赖 echarts 包）。
+ *
+ * 业务侧：`import('echarts').then(e => e.init(el).setOption(option))`
+ * 内核保持库无关；本文件只产出普通 JSON 可序列化结构。
+ */
+import type { RsTableChartSeries } from './table-chart-utils';
+/** 最小 ECharts option 面（刻意放宽，避免绑定具体 echarts 类型版本） */
+export type RsTableEChartsOption = {
+    tooltip?: {
+        trigger?: string;
+    };
+    legend?: {
+        data?: string[];
+    };
+    xAxis?: {
+        type?: string;
+        data?: string[];
+    } | Array<{
+        type?: string;
+        data?: string[];
+    }>;
+    yAxis?: {
+        type?: string;
+    } | Array<{
+        type?: string;
+    }>;
+    series: Array<{
+        id?: string;
+        name?: string;
+        type: 'bar' | 'line' | 'pie';
+        data: Array<number | {
+            name: string;
+            value: number;
+        }>;
+    }>;
+};
+export interface MapRsTableSeriesToEChartsOptions {
+    /** 多系列时是否共用类目轴（默认 true；饼图忽略） */
+    sharedCategoryAxis?: boolean;
+    /** tooltip.trigger，默认按首系列推断 */
+    tooltipTrigger?: 'item' | 'axis';
+}
+/**
+ * 将库无关 series 映射为可直接 setOption 的 ECharts option。
+ */
+export declare function mapRsTableSeriesToEChartsOption(seriesList: readonly RsTableChartSeries[], options?: MapRsTableSeriesToEChartsOptions): RsTableEChartsOption;

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.d.ts

@@ -0,0 +1,22 @@
+/**
+ * ARIA Grid 单元格导航（矩形行列模型，不限于可编辑格）。
+ * 对标 Excel / AG Grid 漫游：箭头、Home/End、Ctrl+Home/End、PageUp/PageDown。
+ */
+export type RsTableGridNavDirection = 'left' | 'right' | 'up' | 'down' | 'home' | 'end' | 'first' | 'last' | 'pageUp' | 'pageDown';
+export interface RsTableGridCellRef {
+    rowKey: string;
+    colKey: string;
+    rowIndex: number;
+}
+/**
+ * 在「行列表 × 列 key」矩形上移动焦点。
+ * rows 按视觉顺序；colKeys 为可见数据列顺序。
+ */
+export declare function navigateGridCell(rows: Array<{
+    rowKey: string;
+    rowIndex: number;
+}>, colKeys: string[], current: RsTableGridCellRef | null, direction: RsTableGridNavDirection, pageSize?: number): RsTableGridCellRef | null;
+/**
+ * 将 KeyboardEvent 映射为网格导航方向；无法识别则返回 null。
+ */
+export declare function resolveGridNavDirection(event: KeyboardEvent): RsTableGridNavDirection | null;

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 };