ensis-ui 0.0.0-stage → 3.0.0

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

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

@@ -0,0 +1,444 @@
+import type { VNodeChild } from 'vue';
+export type RsTableColumnAlign = 'left' | 'center' | 'right';
+export type RsTableColumnFixed = 'left' | 'right';
+export type RsTableSortOrder = 'asc' | 'desc' | null;
+/**
+ * 行选择模式：
+ * - checkbox / radio：左侧选择列
+ * - row：无选择列，点击行多选（Ctrl/Cmd 切换、Shift 范围）
+ */
+export type RsTableSelectionType = 'checkbox' | 'radio' | 'row';
+export type RsTableSize = 'sm' | 'md' | 'lg';
+/** 行数据最小约束：任意非原始类型对象（interface / type 均可） */
+export type RsTableRowData = object;
+/**
+ * 可选约定字段（非强制）。
+ * - 未传 `rowKey` 时，`resolveRowKey` 依次回退 `id` → `key` → 行索引
+ * - `disabled === true` 时行不可选
+ */
+export interface RsTableRowConvention {
+    id?: string | number;
+    key?: string | number;
+    disabled?: boolean;
+}
+/**
+ * 行字段访问器：列 key（ keyof 字符串键）、任意路径字符串、或自定义函数。
+ * 用于 `rowKey`、`groupBy` 等配置。
+ */
+export type RsTableFieldAccessor<T extends RsTableRowData = RsTableRowData> = Extract<keyof T, string> | string | ((row: T) => string);
+/** 行唯一键配置 */
+export type RsTableRowKey<T extends RsTableRowData = RsTableRowData> = RsTableFieldAccessor<T>;
+/** 分组字段配置 */
+export type RsTableGroupBy<T extends RsTableRowData = RsTableRowData> = RsTableFieldAccessor<T>;
+/** 单元格 render 返回值（文本、数字或 Vue VNode） */
+export type RsTableCellRenderResult = VNodeChild;
+/** 单元格编辑/展示值类型 */
+export type RsTableCellValueType = 'text' | 'number' | 'date' | 'datetime' | 'boolean' | 'select' | 'textarea';
+/** 列级编辑器选项（仅编辑挂载时读取，不影响展示路径）。 */
+export interface RsTableColumnEditorOptions {
+    /**
+     * select：选项列表；也可按行返回（如外键引用表随 schema 变化）。
+     * 函数形式在进入编辑态时按当前行解析。
+     */
+    options?: import('../../../select/src/select-utils').RsSelectOptions | ((row: RsTableRowData, index: number) => import('../../../select/src/select-utils').RsSelectOptions);
+    /** select：可搜索 */
+    searchable?: boolean;
+    /**
+     * select：允许搜索框手输自定义值（Enter / 「使用 xxx」）。
+     * 适合类型名、厂商扩展类型等预设列表外的输入。
+     */
+    creatable?: boolean;
+    /**
+     * select：多选。草稿仍为字符串，选项间以 `, ` 拼接；
+     * 多选时在下拉关闭时提交（避免每点一项就结束编辑）。
+     */
+    multiple?: boolean;
+    /** select / date：可清空；表格单元格 select 默认 false（仅选择，无清除 X） */
+    clearable?: boolean;
+    /** number：最小值（对齐 InputNumber min） */
+    min?: number;
+    /** number：最大值 */
+    max?: number;
+    /** number：步进 */
+    step?: number | string;
+    /** number：小数位 */
+    precision?: number;
+    /** number：是否显示步进按钮；inline 单元格默认 false */
+    controls?: boolean;
+    /** datetime：是否含秒 */
+    withSeconds?: boolean;
+    /** datetime：时区策略（utc 提交时补 Z） */
+    timezone?: 'local' | 'utc';
+    /** textarea：可见行数 */
+    rows?: number;
+    /**
+     * 编辑呈现：inline 为单元格内编辑；dialog 由外层弹窗承接（大字段）。
+     * 为 dialog 时表格不进入行内编辑态，改为发出 cellEditDialog。
+     */
+    presentation?: 'inline' | 'dialog';
+    /** 进入编辑时光标策略覆盖 */
+    focusMode?: 'end' | 'select' | 'start';
+}
+/** 已按行解析后的编辑器选项（options 仅为列表，供单元格编辑器使用）。 */
+export type RsTableColumnEditorOptionsResolved = Omit<RsTableColumnEditorOptions, 'options'> & {
+    options?: import('../../../select/src/select-utils').RsSelectOptions;
+};
+export interface RsTableSortState {
+    key: string;
+    order: Exclude<RsTableSortOrder, null>;
+}
+export interface RsTableColumn<T extends RsTableRowData = Record<string, unknown>> {
+    key: string;
+    title: string;
+    dataIndex?: Extract<keyof T, string> | string;
+    width?: number | string;
+    minWidth?: number | string;
+    align?: RsTableColumnAlign;
+    sortable?: boolean;
+    sorter?: (left: T, right: T) => number;
+    /** 表头显示筛选图标，配合表格 `columnFilters` 使用 */
+    filterable?: boolean;
+    /** 自定义列筛选；默认对单元格值做包含匹配 */
+    filter?: (value: unknown, row: T, query: string) => boolean;
+    fixed?: RsTableColumnFixed;
+    ellipsis?: boolean;
+    /**
+     * 格子里看不到的额外提示（always）。不要重复可见文本。
+     * 可见文本被截断时的提示用 `ellipsis`：只量表格自身省略容器。
+     */
+    tooltip?: (row: T, index: number) => string | null | undefined;
+    /** 表头原生 title（宽表勿逐列挂 RsTooltip，避免成百实例） */
+    headerTip?: string;
+    /** 是否允许行内编辑；也可在表格级设置 editable */
+    editable?: boolean | ((row: T, index: number) => boolean);
+    /** 单元格值类型，控制行内编辑控件（默认 text） */
+    valueType?: RsTableCellValueType;
+    /** 编辑器附加选项（select options 等）；仅进入编辑态时使用 */
+    editorOptions?: RsTableColumnEditorOptions;
+    /** 展示格式化 */
+    formatter?: (value: unknown, row: T, index: number) => string;
+    /** 编辑输入解析 */
+    parser?: (input: string, row: T, index: number) => unknown;
+    /** 编辑校验，返回错误文案；支持异步 */
+    validator?: (value: unknown, row: T, index: number) => string | null | Promise<string | null>;
+    /** 是否允许 NULL（覆盖表格 allowNull） */
+    nullable?: boolean;
+    /** 空字符串提交为 null（需 nullable） */
+    emptyAsNull?: boolean;
+    /** 提交时机 */
+    commitOn?: 'blur' | 'enter' | 'change' | 'manual';
+    /** 进入编辑的触发方式 */
+    editTrigger?: 'click' | 'dblclick';
+    /**
+     * 自定义单元格展示内容（string / number / VNode 等 `VNodeChild`）。
+     * 仅影响展示层；排序、筛选、编辑、复制仍读取 `dataIndex` / `key` 字段。
+     * 纯文本格式化请优先用 `formatter`。
+     */
+    render?: (row: T, index: number) => RsTableCellRenderResult;
+    /**
+     * 列汇总（footer / 分组小计）。配合表格 `summaryMode`：
+     * - client：对当前 viewRows 做本地聚合
+     * - server：展示 `summaryData[column.key]`
+     */
+    summary?: import('./table-summary-utils').RsTableColumnSummary<T>;
+}
+export type RsTableSelectAllState = 'checked' | 'indeterminate' | 'unchecked';
+export type RsTableRowEntry<T extends RsTableRowData = Record<string, unknown>> = {
+    type: 'row';
+    row: T;
+    rowIndex: number;
+    /** 树表深度（根为 0）；非树表为 undefined */
+    depth?: number;
+    /** 树表：是否有可展开子节点 */
+    hasChildren?: boolean;
+    /** 树表：父行 key；根为 null */
+    parentKey?: string | null;
+    /** 树表：展平时确定的稳定行 key（优先于重新 resolve） */
+    treeKey?: string;
+} | {
+    type: 'group';
+    key: string;
+    label: string;
+} | {
+    type: 'expand';
+    row: T;
+    rowIndex: number;
+    rowKey: string;
+};
+/**
+ * 树形表格配置。
+ * 与 detail 展开（`expandable`）互斥：树表在数据列内缩进展开，不插入 `#expand` 明细行。
+ */
+export interface RsTableTreeConfig<T extends RsTableRowData = RsTableRowData> {
+    /** 子节点字段名，默认 `children` */
+    childrenField?: string;
+    /** 叶子标记字段名，默认 `isLeaf`；为 true 时不可展开 */
+    isLeafField?: string;
+    /**
+     * 展示缩进与展开按钮的列 key；
+     * 缺省为第一列（`columns[0].key`）。
+     */
+    expandColumnKey?: string;
+    /**
+     * 是否自动将展开列设为 `fixed: 'left'`（避免横向滚动 / 列虚拟时丢失展开钮）。
+     * @default true
+     */
+    fixExpandColumn?: boolean;
+    /** 每一层缩进像素；缺省按表格 size（sm/md/lg → 16/20/24） */
+    indent?: number;
+    /**
+     * 仅在首次有数据时展开全部可展开节点（非受控）。
+     * 若同时提供非空 `defaultExpandedRowKeys`，则以后者为准且不再全开。
+     */
+    defaultExpandAll?: boolean;
+    /**
+     * 勾选是否父子独立。
+     * - `true`（默认）：与平面表一致，只切换当前行
+     * - `false`：父子联动，父级可呈半选
+     */
+    checkStrictly?: boolean;
+    /**
+     * 懒加载：无子节点且非叶子时仍显示展开按钮；
+     * 首次展开时调用 `loadData`。
+     */
+    lazy?: boolean;
+    /**
+     * 懒加载回调。可直接改 `row[childrenField]`，或返回子节点数组由表格写入。
+     * 使用 bivarianceHack：具体行类型的 treeConfig 可赋给更宽泛的 treeConfig prop（如 RsGrid）。
+     */
+    loadData?: {
+        bivarianceHack(row: T, key: string): void | T[] | Promise<void | T[]>;
+    }['bivarianceHack'];
+}
+/** 树表节点索引（供级联勾选 / 半选） */
+export interface RsTableTreeNodeIndex {
+    parentKey: string | null;
+    childrenKeys: string[];
+}
+export type RsTableTreeCheckState = 'checked' | 'indeterminate' | 'unchecked';
+export declare const TABLE_ROW_HEIGHT: {
+    readonly sm: 33;
+    readonly md: 41;
+    readonly lg: 48;
+    readonly group: 36;
+    readonly expand: 80;
+};
+export interface RsTableFixedCellStyle {
+    fixed: RsTableColumnFixed;
+    left?: number;
+    right?: number;
+}
+export declare function getCellValue<T extends RsTableRowData>(row: T, column: RsTableColumn<T>): unknown;
+export type RsTableCellTooltipMode = 'overflow' | 'always';
+export declare function columnUsesSharedTooltip<T extends RsTableRowData>(column: RsTableColumn<T>): boolean;
+export declare function resolveCellTooltipMode<T extends RsTableRowData>(column: RsTableColumn<T>): RsTableCellTooltipMode | null;
+export declare function resolveCellTooltipText<T extends RsTableRowData>(column: RsTableColumn<T>, row: T, index: number): string;
+export declare function compareTableValues(a: unknown, b: unknown, locale?: string): number;
+export declare function toggleSortState(current: RsTableSortState | null, key: string): RsTableSortState | null;
+export declare function toggleMultiSortState(sorts: readonly RsTableSortState[], key: string, maxSort?: number): RsTableSortState[];
+export declare function getSortOrderForKey(sorts: readonly RsTableSortState[], key: string): RsTableSortOrder;
+export declare function getSortPriorityForKey(sorts: readonly RsTableSortState[], key: string): number;
+export declare function compareTableRowsBySort<T extends RsTableRowData>(left: T, right: T, column: RsTableColumn<T>, order: Exclude<RsTableSortOrder, null>, locale?: string): number;
+export declare function sortTableRows<T extends RsTableRowData>(rows: readonly T[], columns: readonly RsTableColumn<T>[], sort: RsTableSortState | null, locale?: string): T[];
+export declare function sortTableRowsMulti<T extends RsTableRowData>(rows: readonly T[], columns: readonly RsTableColumn<T>[], sorts: readonly RsTableSortState[], locale?: string): T[];
+export declare function filterTableRows<T extends RsTableRowData>(rows: readonly T[], query: string, columns: readonly RsTableColumn<T>[], keys?: string[], locale?: string): T[];
+export declare function filterTableRowsByColumnFilters<T extends RsTableRowData>(rows: readonly T[], columns: readonly RsTableColumn<T>[], filters: Record<string, string>, locale?: string): T[];
+export declare function isColumnFilterActive(filters: Record<string, string>, key: string): boolean;
+export declare function resolveGroupKey<T extends RsTableRowData>(row: T, groupBy: RsTableGroupBy<T>): string;
+export declare function groupTableRows<T extends RsTableRowData>(rows: readonly T[], groupBy: RsTableGroupBy<T>, labelFormatter?: (key: string) => string): RsTableRowEntry<T>[];
+export declare function resolveColumnOrder<T extends RsTableRowData>(columns: readonly RsTableColumn<T>[], order?: readonly string[]): string[];
+export declare function resolveOrderedColumns<T extends RsTableRowData>(columns: readonly RsTableColumn<T>[], order?: readonly string[]): RsTableColumn<T>[];
+export declare function reorderColumnKeys(order: readonly string[], dragKey: string, dropKey: string): string[];
+export type RsTableRowDropPosition = 'before' | 'after' | 'into';
+export declare function reorderTableRows<T>(rows: readonly T[], dragIndex: number, dropIndex: number, position: RsTableRowDropPosition): T[];
+export declare function buildTableEntries<T extends RsTableRowData>(rows: readonly T[], columns: readonly RsTableColumn<T>[], options?: {
+    sort?: RsTableSortState | null;
+    sorts?: readonly RsTableSortState[];
+    multiSort?: boolean;
+    filterText?: string;
+    filterKeys?: string[];
+    columnFilters?: Record<string, string>;
+    groupBy?: RsTableGroupBy<T>;
+    groupLabel?: (key: string) => string;
+    remoteSort?: boolean;
+    locale?: string;
+}): RsTableRowEntry<T>[];
+export declare function injectExpandRows<T extends RsTableRowData>(entries: readonly RsTableRowEntry<T>[], expandedKeys: ReadonlySet<string>, rowKey?: RsTableRowKey<T>, rowExpandable?: (row: T, index: number) => boolean): RsTableRowEntry<T>[];
+export declare function toggleExpandedRowKeys(keys: readonly string[], key: string): string[];
+/** 读取树表子节点数组（非数组视为无子节点） */
+export declare function getTableTreeChildren<T extends RsTableRowData>(row: T, childrenField?: string): T[];
+/** 是否为叶子（显式 isLeaf 优先） */
+export declare function getTableTreeIsLeaf<T extends RsTableRowData>(row: T, isLeafField?: string): boolean;
+/** 是否可展开：非叶子且（有子节点，或懒加载） */
+export declare function hasTableTreeChildren<T extends RsTableRowData>(row: T, options?: {
+    childrenField?: string;
+    isLeafField?: string;
+    lazy?: boolean;
+}): boolean;
+/**
+ * 解析树表行 key。
+ * 有 `rowKey` 时走 `resolveRowKey`；否则用路径回退（避免兄弟下标跨分支碰撞）。
+ * 树表强烈建议显式传 `rowKey`。
+ */
+export declare function resolveTableTreeRowKey<T extends RsTableRowData>(row: T, index: number, parentKey: string | null, rowKey?: RsTableRowKey<T>): string;
+/** 是否配置了可用的稳定 rowKey（字段名或函数） */
+export declare function hasStableTableTreeRowKey<T extends RsTableRowData>(rowKey?: RsTableRowKey<T>): boolean;
+/** 收集所有可展开节点 key（用于 defaultExpandAll） */
+export declare function collectTableTreeExpandableKeys<T extends RsTableRowData>(rows: readonly T[], options?: {
+    childrenField?: string;
+    isLeafField?: string;
+    lazy?: boolean;
+    rowKey?: RsTableRowKey<T>;
+}): string[];
+/** 构建整棵树的 parent/children key 索引（级联勾选） */
+export declare function buildTableTreeNodeIndex<T extends RsTableRowData>(rows: readonly T[], options?: {
+    childrenField?: string;
+    isLeafField?: string;
+    lazy?: boolean;
+    rowKey?: RsTableRowKey<T>;
+}): Map<string, RsTableTreeNodeIndex>;
+export declare function collectTableTreeDescendantKeys(key: string, index: ReadonlyMap<string, RsTableTreeNodeIndex>): string[];
+export declare function resolveTableTreeCheckState(key: string, checkedKeys: ReadonlySet<string>, index: ReadonlyMap<string, RsTableTreeNodeIndex>, checkStrictly: boolean): RsTableTreeCheckState;
+export declare function collectTableTreeHalfCheckedKeys(index: ReadonlyMap<string, RsTableTreeNodeIndex>, checkedKeys: ReadonlySet<string>, checkStrictly: boolean): string[];
+/** 切换树表勾选；`checkStrictly=false` 时父子联动 */
+export declare function toggleTableTreeCheck(key: string, checkedKeys: ReadonlySet<string>, index: ReadonlyMap<string, RsTableTreeNodeIndex>, checkStrictly: boolean): string[];
+/**
+ * 树过滤：匹配节点或其后代匹配时保留该节点，并裁剪子树。
+ * 与 RsTree `filterTreeNodes` 语义一致（保留祖先路径）。
+ */
+export declare function filterTableTreeRows<T extends RsTableRowData>(rows: readonly T[], query: string, columns: readonly RsTableColumn<T>[], options?: {
+    childrenField?: string;
+    filterKeys?: string[];
+    columnFilters?: Record<string, string>;
+    locale?: string;
+}): T[];
+/** 树排序：仅对同级节点排序，递归处理子树 */
+export declare function sortTableTreeRows<T extends RsTableRowData>(rows: readonly T[], columns: readonly RsTableColumn<T>[], options: {
+    childrenField?: string;
+    sort?: RsTableSortState | null;
+    sorts?: readonly RsTableSortState[];
+    multiSort?: boolean;
+    locale?: string;
+}): T[];
+/**
+ * 按展开 key 展平可见树行为表格 row entries（不含 detail expand 行）。
+ */
+export declare function flattenVisibleTableTreeEntries<T extends RsTableRowData>(rows: readonly T[], expandedKeys: ReadonlySet<string>, options?: {
+    childrenField?: string;
+    isLeafField?: string;
+    lazy?: boolean;
+    rowKey?: RsTableRowKey<T>;
+}): Extract<RsTableRowEntry<T>, {
+    type: 'row';
+}>[];
+/**
+ * 树表入口构建：过滤 → 同级排序 → 按展开状态展平。
+ * 不支持与 `groupBy` / detail `expandable` 同时使用。
+ */
+export declare function buildTableTreeEntries<T extends RsTableRowData>(rows: readonly T[], columns: readonly RsTableColumn<T>[], expandedKeys: ReadonlySet<string>, options: {
+    tree: RsTableTreeConfig<T>;
+    rowKey?: RsTableRowKey<T>;
+    sort?: RsTableSortState | null;
+    sorts?: readonly RsTableSortState[];
+    multiSort?: boolean;
+    filterText?: string;
+    filterKeys?: string[];
+    columnFilters?: Record<string, string>;
+    remoteSort?: boolean;
+    locale?: string;
+}): RsTableRowEntry<T>[];
+/** 按表格 size 解析树缩进默认值 */
+export declare function resolveTableTreeIndent(size?: RsTableSize, custom?: number): number;
+export declare function resolveTableSize(compact: boolean, size?: RsTableSize): RsTableSize;
+export declare function resolveTableRowHeight(size?: RsTableSize, custom?: number): number;
+export declare function resolveTableVirtualEnabled(options: {
+    virtual?: boolean;
+    infinite?: boolean;
+    virtualOnInfinite?: boolean;
+}): boolean;
+export declare function isNearScrollBottom(scrollTop: number, scrollHeight: number, clientHeight: number, distance?: number): boolean;
+export declare function entryHeight<T extends RsTableRowData>(entry: RsTableRowEntry<T>, rowHeight: number, groupRowHeight?: 36, expandRowHeight?: 80): number;
+export declare function resolveScrollWidth(scrollX?: number | string, _columns?: readonly RsTableColumn[]): string | undefined;
+export declare function resolveLeadingColumnWidth(options: {
+    selectable?: boolean;
+    showIndex?: boolean;
+    showEditGutter?: boolean;
+    gutterWidth?: number;
+    indexWidth?: number;
+    expandable?: boolean;
+    rowDraggable?: boolean;
+}): number;
+export declare function resolveFixedColumnStyles<T extends RsTableRowData>(columns: readonly RsTableColumn<T>[], widths: Record<string, number | string>, options?: {
+    selectable?: boolean;
+    showIndex?: boolean;
+    showEditGutter?: boolean;
+    gutterWidth?: number;
+    indexWidth?: number;
+    expandable?: boolean;
+    rowDraggable?: boolean;
+}): Map<string, RsTableFixedCellStyle>;
+export declare function fixedCellStyle(style?: RsTableFixedCellStyle, options?: {
+    header?: boolean;
+}): Record<string, string> | undefined;
+export declare function selectRowKeys(selectedKeys: readonly string[], key: string, selectionType: RsTableSelectionType): string[];
+/** 行点击多选（plain / Ctrl·Cmd / Shift），供 selectionType=`row` 使用。 */
+export declare function selectRowKeysByClick(selectedKeys: readonly string[], key: string, options: {
+    toggle: boolean;
+    range: boolean;
+    /** 有序行键（当前可见数据顺序），用于 Shift 范围选 */
+    orderedKeys: readonly string[];
+    /** Shift 范围的锚点行键 */
+    anchorKey?: string | null;
+}): string[];
+export declare function sliceVirtualTableEntries<T extends RsTableRowData>(entries: readonly RsTableRowEntry<T>[], scrollTop: number, viewportHeight: number, rowHeight: number, groupRowHeight?: 36, overscan?: number, expandRowHeight?: 80): {
+    entries: RsTableRowEntry<T>[];
+    paddingTop: number;
+    paddingBottom: number;
+};
+/** 预计算行高前缀和，供虚拟滚动复用，避免每次 scroll 全量 map/reduce */
+export declare function buildVirtualHeightModel<T extends RsTableRowData>(entries: readonly RsTableRowEntry<T>[], rowHeight: number, groupRowHeight?: 36, expandRowHeight?: 80): {
+    entries: readonly RsTableRowEntry<T>[];
+    prefix: number[];
+    total: number;
+};
+export declare function sliceVirtualHeightModel<T extends RsTableRowData>(model: {
+    entries: readonly RsTableRowEntry<T>[];
+    prefix: readonly number[];
+    total: number;
+}, scrollTop: number, viewportHeight: number, rowHeight: number, overscan?: number): {
+    entries: RsTableRowEntry<T>[];
+    paddingTop: number;
+    paddingBottom: number;
+};
+/** 列像素宽：优先已测量/配置 widths，其次 column.width / minWidth */
+export declare function resolveColumnPixelWidth<T extends RsTableRowData>(column: RsTableColumn<T>, widths?: Record<string, number | string>, fallback?: number): number;
+/**
+ * 横向列虚拟切片（仅针对可横滚的流体列）。
+ * 调用方负责：冻结列始终实体渲染；`scrollLeft` 为相对流体区起点的偏移
+ * （即容器 scrollLeft 减去前缀列与左冻结列宽度）。
+ */
+export declare function sliceVirtualColumns<T extends RsTableRowData>(columns: readonly RsTableColumn<T>[], options: {
+    scrollLeft: number;
+    viewportWidth: number;
+    getWidth: (column: RsTableColumn<T>) => number;
+    overscan?: number;
+}): {
+    columns: RsTableColumn<T>[];
+    paddingLeft: number;
+    paddingRight: number;
+    startIndex: number;
+    endIndex: number;
+};
+export declare function resolveRowKey<T extends RsTableRowData>(row: T, index: number, rowKey?: RsTableRowKey<T>): string;
+export declare function resolveEntryKey<T extends RsTableRowData>(entry: RsTableRowEntry<T>, rowKey?: RsTableRowKey<T>): string;
+export declare function resolveColumnStyle<T extends RsTableRowData = Record<string, unknown>>(column: RsTableColumn<T>, widths?: Record<string, number | string>): Record<string, string> | undefined;
+export declare function clampColumnWidth(width: number, min?: number, max?: number): number;
+export declare function parseColumnWidth(width: number | string | undefined, fallback?: number): number;
+export declare function createInitialColumnWidths<T extends RsTableRowData>(columns: readonly RsTableColumn<T>[], overrides?: Record<string, number | string>, options?: {
+    forceAll?: boolean;
+}): Record<string, number>;
+export declare function isTableRowDisabled<T extends RsTableRowData>(row: T): boolean;
+export declare function resolveSelectableRowKeys<T extends RsTableRowData>(rows: readonly T[], rowKey?: RsTableRowKey<T>, rowSelectable?: (row: T, index: number) => boolean): string[];
+export declare function resolveSelectAllState(selectedKeys: readonly string[], allKeys: readonly string[]): RsTableSelectAllState;
+export declare function toggleRowSelection(selectedKeys: readonly string[], key: string): string[];
+export declare function toggleSelectAll(selectedKeys: readonly string[], allKeys: readonly string[], select: boolean): string[];