niuma-ui 1.1.12 → 1.2.0

package/dist/components/table/table-features.d.ts

@@ -0,0 +1,149 @@
+/**
+ * RsTable 特性插件协议。
+ *
+ * 目标：新能力以 feature 注册，避免继续向 RsTable.vue 堆分支。
+ *
+ * 已迁出 composable 的内置能力（行为真源）：
+ * - virtual → useRsTableVirtual + useRsTableColumnVirtual + useRsTableScrollLayout
+ * - contextMenu → useRsTableContextMenu
+ * - summary → useRsTableSummary
+ * - sort/selection/filter/tree → useRsTableEngine / useRsTableColumns / useRsTableInteraction
+ * - edit → useTableEdit + useRsTableEditActions
+ * - analytics / chart → useRsTableSelectionSource + useRsTableChartBridge（表外）
+ *
+ * Feature.setup 用于生命周期登记与扩展点；重逻辑不在此重复执行。
+ *
+ * 视图分层（世界级演进）：
+ * - Core / Shell / EditLayer = 行为真源
+ * - RsTableColGroup / Header / Body / BodyRow = 纯视图，不持业务状态
+ */
+import type { RsContextMenuItem } from '../context-menu-utils';
+import type { RsTableRowData } from '../table-utils';
+import type { RsTableAnalyticsSnapshot } from '../../composables/useRsTableSelectionSource';
+import type { RsTableOverlayContribution, RsTableToolbarItem } from './rs-table-feature-host';
+import { type RsTableChartSeries, type RsTableChartSeriesDef } from './table-chart-utils';
+/**
+ * 表格特性插件上下文（只读查询 + 订阅 + 有限贡献点）。
+ * Feature 不得直接操作表格 DOM；图表/指标通过 snapshot / subscribe 接入。
+ */
+export interface RsTableFeatureContext<T extends RsTableRowData = RsTableRowData> {
+    /** 当前筛选/排序后的业务行（Engine.viewRows） */
+    getViewRows: () => T[];
+    /** 当前选中行 */
+    getSelectedRows: () => T[];
+    /**
+     * 分析快照：含 sourceRows（选中优先）与 sourceMode。
+     * 柱状图/饼图等应消费 sourceRows，而不是直接绑原始 data。
+     */
+    getAnalyticsSnapshot: () => RsTableAnalyticsSnapshot<T>;
+    /**
+     * 订阅分析快照变化（浅层：view/selected 引用或 sourceMode）。
+     * @returns teardown
+     */
+    subscribeAnalytics: (listener: (snap: RsTableAnalyticsSnapshot<T>) => void) => () => void;
+    /**
+     * 向右键菜单贡献项（setup 时调用）。
+     * - 传入数组：静态追加
+     * - 传入函数：每次打开菜单时动态贡献（可 push 到 items）
+     */
+    contributeContextMenuItems?: (contributor: RsContextMenuItem[] | ((items: RsContextMenuItem[], menuCtx: {
+        row: T | null;
+        selectedRows: T[];
+    }) => void)) => void;
+    /**
+     * 向工具条贡献项（实例级；多表互不共享贡献袋）。
+     */
+    contributeToolbarItems?: (contributor: RsTableToolbarItem[] | ((items: RsTableToolbarItem[]) => void)) => void;
+    /**
+     * 向 overlay 旁路贡献挂载描述（图表壳等，不直接改表格 DOM）。
+     */
+    contributeOverlay?: (contributor: RsTableOverlayContribution[] | ((items: RsTableOverlayContribution[]) => void)) => void;
+}
+/**
+ * 企业级表格特性插件接口。
+ *
+ * @property id 稳定标识，与 props 开关 / 遥测对齐
+ * @property setup 挂载时调用；可返回 teardown
+ */
+export interface RsTableFeature<T extends RsTableRowData = RsTableRowData> {
+    id: string;
+    setup(ctx: RsTableFeatureContext<T>): void | (() => void);
+}
+/**
+ * 内置特性 id（与 RsTable props 开关映射）。
+ * analytics 不进内置 props 开关：由业务通过 ChartBridge / Feature 外挂。
+ */
+export type RsTableBuiltinFeatureId = 'selection' | 'sort' | 'filter' | 'virtual' | 'edit' | 'tree' | 'contextMenu' | 'summary';
+/** 已有独立 composable 承载的内置 id（feature 仅作登记） */
+export declare const RS_TABLE_FEATURE_COMPOSABLE_MAP: Record<RsTableBuiltinFeatureId, string | null>;
+/** 列布局/拖拽非 builtin feature id，但属内核横切能力 */
+export declare const RS_TABLE_COLUMN_SHELL: {
+    readonly layout: "useRsTableColumnLayout";
+    readonly resize: "useRsTableColumnResize";
+};
+/** 表外分析/图表扩展入口（不进 RsTable 内核渲染） */
+export declare const RS_TABLE_ANALYTICS_SHELL: {
+    readonly selectionSource: "useRsTableSelectionSource";
+    readonly chartBridge: "useRsTableChartBridge";
+    readonly chartUtils: "table-chart-utils";
+};
+/**
+ * 按 props 开关解析应启用的内置特性 id 列表。
+ */
+export declare function resolveBuiltinTableFeatures(flags: {
+    selectable?: boolean;
+    sortableColumns?: boolean;
+    filterable?: boolean;
+    virtual?: boolean | 'auto';
+    editable?: boolean;
+    tree?: boolean;
+    contextMenu?: boolean;
+    summary?: boolean;
+}): RsTableBuiltinFeatureId[];
+/**
+ * 依次 setup 特性列表，并返回统一 teardown（逆序 dispose）。
+ */
+export declare function setupTableFeatures<T extends RsTableRowData>(features: RsTableFeature<T>[], ctx: RsTableFeatureContext<T>): () => void;
+/**
+ * 创建已绑定 composable 真源的内置 feature。
+ */
+export declare function createBuiltinTableFeatures<T extends RsTableRowData>(ids: RsTableBuiltinFeatureId[]): RsTableFeature<T>[];
+/**
+ * 创建分析/图表旁路 feature：setup 时订阅 snapshot，交由业务 listener。
+ * 用于把「选中 → 图表」挂到统一生命周期，而不改 RsTable 模板。
+ */
+export declare function createAnalyticsTableFeature<T extends RsTableRowData>(options: {
+    id?: string;
+    onSnapshot: (snap: RsTableAnalyticsSnapshot<T>) => void;
+}): RsTableFeature<T>;
+/**
+ * 创建右键菜单贡献 feature（静态项或动态函数）。
+ */
+export declare function createContextMenuTableFeature<T extends RsTableRowData>(options: {
+    id?: string;
+    items: RsContextMenuItem[] | ((items: RsContextMenuItem[], menuCtx: {
+        row: T | null;
+        selectedRows: T[];
+    }) => void);
+}): RsTableFeature<T>;
+/** 创建工具条贡献 feature */
+export declare function createToolbarTableFeature(options: {
+    id?: string;
+    items: RsTableToolbarItem[] | ((items: RsTableToolbarItem[]) => void);
+}): RsTableFeature;
+/** 创建 overlay 贡献 feature（图表旁路挂载点等） */
+export declare function createOverlayTableFeature(options: {
+    id?: string;
+    items: RsTableOverlayContribution[] | ((items: RsTableOverlayContribution[]) => void);
+}): RsTableFeature;
+/**
+ * 官方图表 Feature：订阅 analytics → 库无关 series，并登记 overlay 挂载点。
+ * 不捆绑 ECharts/Chart.js；业务用 onSeries 映射 option。
+ */
+export declare function createChartSeriesTableFeature<T extends RsTableRowData>(options: {
+    id?: string;
+    seriesDefs: RsTableChartSeriesDef[] | (() => RsTableChartSeriesDef[]);
+    onSeries: (series: RsTableChartSeries[], snap: RsTableAnalyticsSnapshot<T>) => void;
+    /** overlay 登记；默认 key=chart / slot=chart */
+    overlay?: RsTableOverlayContribution;
+}): RsTableFeature<T>;

package/dist/components/table/table-features.js

@@ -0,0 +1,119 @@
+import { buildTableChartSeriesList } from "./table-chart-utils.js";
+//#region src/components/table/table-features.ts
+/** 已有独立 composable 承载的内置 id（feature 仅作登记） */
+var RS_TABLE_FEATURE_COMPOSABLE_MAP = {
+	selection: "useRsTableEngine",
+	sort: "useRsTableEngine",
+	filter: "useRsTableEngine",
+	virtual: "useRsTableVirtual+useRsTableColumnVirtual+useRsTableScrollLayout",
+	edit: "useTableEdit+useRsTableEditActions",
+	tree: "useRsTableEngine+useRsTableInteraction",
+	contextMenu: "useRsTableContextMenu",
+	summary: "useRsTableSummary"
+};
+/** 表外分析/图表扩展入口（不进 RsTable 内核渲染） */
+var RS_TABLE_ANALYTICS_SHELL = {
+	selectionSource: "useRsTableSelectionSource",
+	chartBridge: "useRsTableChartBridge",
+	chartUtils: "table-chart-utils"
+};
+/**
+* 按 props 开关解析应启用的内置特性 id 列表。
+*/
+function resolveBuiltinTableFeatures(flags) {
+	const ids = [];
+	if (flags.selectable) ids.push("selection");
+	if (flags.sortableColumns !== false) ids.push("sort");
+	if (flags.filterable) ids.push("filter");
+	if (flags.virtual !== false) ids.push("virtual");
+	if (flags.editable) ids.push("edit");
+	if (flags.tree) ids.push("tree");
+	if (flags.contextMenu !== false) ids.push("contextMenu");
+	if (flags.summary) ids.push("summary");
+	return ids;
+}
+/**
+* 依次 setup 特性列表，并返回统一 teardown（逆序 dispose）。
+*/
+function setupTableFeatures(features, ctx) {
+	const teardowns = [];
+	for (const feature of features) {
+		const dispose = feature.setup(ctx);
+		if (typeof dispose === "function") teardowns.push(dispose);
+	}
+	return () => {
+		for (const dispose of teardowns.reverse()) dispose();
+	};
+}
+/**
+* 创建已绑定 composable 真源的内置 feature。
+*/
+function createBuiltinTableFeatures(ids) {
+	return ids.map((id) => ({
+		id,
+		setup(ctx) {}
+	}));
+}
+/**
+* 创建分析/图表旁路 feature：setup 时订阅 snapshot，交由业务 listener。
+* 用于把「选中 → 图表」挂到统一生命周期，而不改 RsTable 模板。
+*/
+function createAnalyticsTableFeature(options) {
+	return {
+		id: options.id ?? "analytics",
+		setup(ctx) {
+			return ctx.subscribeAnalytics(options.onSnapshot);
+		}
+	};
+}
+/**
+* 创建右键菜单贡献 feature（静态项或动态函数）。
+*/
+function createContextMenuTableFeature(options) {
+	return {
+		id: options.id ?? "contextMenuExtra",
+		setup(ctx) {
+			ctx.contributeContextMenuItems?.(options.items);
+		}
+	};
+}
+/** 创建工具条贡献 feature */
+function createToolbarTableFeature(options) {
+	return {
+		id: options.id ?? "toolbarExtra",
+		setup(ctx) {
+			ctx.contributeToolbarItems?.(options.items);
+		}
+	};
+}
+/** 创建 overlay 贡献 feature（图表旁路挂载点等） */
+function createOverlayTableFeature(options) {
+	return {
+		id: options.id ?? "overlayExtra",
+		setup(ctx) {
+			ctx.contributeOverlay?.(options.items);
+		}
+	};
+}
+/**
+* 官方图表 Feature：订阅 analytics → 库无关 series，并登记 overlay 挂载点。
+* 不捆绑 ECharts/Chart.js；业务用 onSeries 映射 option。
+*/
+function createChartSeriesTableFeature(options) {
+	return {
+		id: options.id ?? "chartSeries",
+		setup(ctx) {
+			ctx.contributeOverlay?.([options.overlay ?? {
+				key: "chart",
+				slot: "chart",
+				meta: { kind: "series" }
+			}]);
+			return ctx.subscribeAnalytics((snap) => {
+				const defs = typeof options.seriesDefs === "function" ? options.seriesDefs() : options.seriesDefs;
+				options.onSeries(buildTableChartSeriesList(snap.sourceRows, defs), snap);
+			});
+		}
+	};
+}
+//#endregion
+export { RS_TABLE_ANALYTICS_SHELL, RS_TABLE_FEATURE_COMPOSABLE_MAP, createAnalyticsTableFeature, createBuiltinTableFeatures, createChartSeriesTableFeature, createContextMenuTableFeature, createOverlayTableFeature, createToolbarTableFeature, resolveBuiltinTableFeatures, setupTableFeatures };

package/dist/components/table/table-keys.d.ts

@@ -0,0 +1,5 @@
+export declare function makeCellKey(rowKey: string, colKey: string): string;
+export declare function parseCellKey(cellKey: string): {
+    rowKey: string;
+    colKey: string;
+};

package/dist/components/table/table-keys.js

@@ -0,0 +1,6 @@
+//#region src/components/table/table-keys.ts
+function makeCellKey(rowKey, colKey) {
+	return `${rowKey}:${colKey}`;
+}
+//#endregion
+export { makeCellKey };

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

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

@@ -0,0 +1,39 @@
+import { type Ref } from 'vue';
+import type { RsTableRowDropPosition } from './table-utils';
+export type RsTableRowDragTrigger = 'handle' | 'row';
+export type RsTableRowDropMode = 'reorder' | 'into';
+export interface TableRowDragState {
+    dragRowKeys: Ref<string[]>;
+    dropRowTargetKey: Ref<string | null>;
+    dropRowPosition: Ref<RsTableRowDropPosition>;
+}
+export declare function createTableRowDragState(): TableRowDragState;
+export declare function resolveTableRowDropPosition(event: MouseEvent, element: HTMLElement, mode: RsTableRowDropMode): RsTableRowDropPosition;
+export declare function resolveDragRowKeys(dragKey: string, selectedKeys: readonly string[]): string[];
+/** 用轻量数字徽标替代浏览器默认单元格拖影 */
+export declare function applyTableRowDragImage(event: DragEvent, count: number): void;
+export declare function clearTableRowDragImage(): void;
+export interface CreateTableRowDragHandlersOptions<T> {
+    state: TableRowDragState;
+    getRowDraggable: () => boolean;
+    getRowDragTrigger: () => RsTableRowDragTrigger;
+    getRowDropMode: () => RsTableRowDropMode;
+    rowDraggableWhen?: (row: T, index: number) => boolean;
+    rowDropTargetWhen?: (row: T, index: number) => boolean;
+    canRowDrop?: (dragKeys: string[], dropKey: string) => boolean;
+    rowKeyFor: (row: T, index: number) => string;
+    isRowDisabled: (row: T) => boolean;
+    getSelectedKeys: () => string[];
+    onDragStart: (dragKeys: string[], event: DragEvent) => void;
+    onDrop: (dragKeys: string[], dropKey: string, position: RsTableRowDropPosition) => void;
+}
+export declare function createTableRowDragHandlers<T>(options: CreateTableRowDragHandlersOptions<T>): {
+    canDragRow: (row: T, index: number) => boolean;
+    onRowDragStart: (row: T, index: number, event: DragEvent) => void;
+    onRowDragOver: (row: T, index: number, event: DragEvent) => void;
+    onRowDragLeave: (event: DragEvent) => void;
+    onRowDrop: (row: T, index: number, event: DragEvent) => void;
+    onRowDragEnd: () => void;
+    isRowDragging: (dropKey: string) => boolean;
+    isRowDropTarget: (dropKey: string) => boolean;
+};

package/dist/components/table-drag.js

@@ -0,0 +1,130 @@
+import { ref } from "vue";
+//#region src/components/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 };