niuma-ui 1.1.12 → 1.2.0

package/dist/components/table/rs-table-module-registry.d.ts

@@ -0,0 +1,37 @@
+/**
+ * RsTable 模块注册表（对标 AG Grid ModuleRegistry）。
+ *
+ * - 全局 register：所有表格实例默认挂载（同页多表会共享这些模块）
+ * - 实例 props.features：仅该实例；同 id 覆盖全局
+ * - 不改内核渲染；模块通过 Feature.setup 订阅/贡献
+ * - 多表隔离要点：选中/编辑/ViewContext 仍是实例私有；仅 Registry 是全局点
+ */
+import type { RsTableFeature } from './table-features';
+import type { RsTableRowData } from '../table-utils';
+/**
+ * 全局模块注册表。
+ *
+ * @example
+ * ```ts
+ * RsTableModuleRegistry.register(
+ *   createAnalyticsTableFeature({ onSnapshot: (s) => syncCharts(s) }),
+ * )
+ * ```
+ */
+export declare const RsTableModuleRegistry: {
+    /**
+     * 注册全局 feature（幂等：同 id 覆盖）。
+     */
+    register<T extends RsTableRowData>(feature: RsTableFeature<T>): void;
+    /** 按 id 注销全局模块 */
+    unregister(id: string): void;
+    /** 清空（测试用） */
+    clear(): void;
+    /** 当前全局模块快照（浅拷贝） */
+    getModules<T extends RsTableRowData = object>(): RsTableFeature<T>[];
+    listIds(): string[];
+};
+/**
+ * 合并全局模块 + 实例 features（实例同 id 覆盖全局）。
+ */
+export declare function resolveInstanceFeatures<T extends RsTableRowData>(instanceFeatures?: RsTableFeature<T>[] | null): RsTableFeature<T>[];

package/dist/components/table/rs-table-module-registry.js

@@ -0,0 +1,51 @@
+//#region src/components/table/rs-table-module-registry.ts
+var globalModules = [];
+/**
+* 全局模块注册表。
+*
+* @example
+* ```ts
+* RsTableModuleRegistry.register(
+*   createAnalyticsTableFeature({ onSnapshot: (s) => syncCharts(s) }),
+* )
+* ```
+*/
+var RsTableModuleRegistry = {
+	/**
+	* 注册全局 feature（幂等：同 id 覆盖）。
+	*/
+	register(feature) {
+		const id = feature.id;
+		const idx = globalModules.findIndex((item) => item.id === id);
+		const next = feature;
+		if (idx >= 0) globalModules[idx] = next;
+		else globalModules.push(next);
+	},
+	/** 按 id 注销全局模块 */
+	unregister(id) {
+		const idx = globalModules.findIndex((item) => item.id === id);
+		if (idx >= 0) globalModules.splice(idx, 1);
+	},
+	/** 清空（测试用） */
+	clear() {
+		globalModules.length = 0;
+	},
+	/** 当前全局模块快照（浅拷贝） */
+	getModules() {
+		return [...globalModules];
+	},
+	listIds() {
+		return globalModules.map((item) => item.id);
+	}
+};
+/**
+* 合并全局模块 + 实例 features（实例同 id 覆盖全局）。
+*/
+function resolveInstanceFeatures(instanceFeatures) {
+	const map = /* @__PURE__ */ new Map();
+	for (const feature of RsTableModuleRegistry.getModules()) map.set(feature.id, feature);
+	for (const feature of instanceFeatures ?? []) map.set(feature.id, feature);
+	return [...map.values()];
+}
+//#endregion
+export { RsTableModuleRegistry, resolveInstanceFeatures };

package/dist/components/table/rs-table-props.d.ts

@@ -0,0 +1,315 @@
+/**
+ * RsTable 公开 props / emits / 默认值（从 SFC 抽出，削薄编排层）。
+ */
+import type { RsContextMenuItem } from '../context-menu-utils';
+import type { RsTableColumn, RsTableGroupBy, RsTableRowData, RsTableRowDropPosition, RsTableRowKey, RsTableSelectionType, RsTableSize, RsTableSortState, RsTableTreeConfig } from '../table-utils';
+import type { RsTableRowDragTrigger, RsTableRowDropMode } from '../table-drag';
+import type { RsTableCellEditFocusMode } from './table-edit-utils';
+import type { RsTableFeature } from './table-features';
+import type { RsTableSummaryData, RsTableSummaryMode } from './table-summary-utils';
+/** RsTable 组件 props */
+export interface RsTableProps<T extends RsTableRowData = RsTableRowData> {
+    columns: RsTableColumn<T>[];
+    data: T[];
+    rowKey?: RsTableRowKey<T>;
+    loading?: boolean;
+    bordered?: boolean;
+    columnBordered?: boolean;
+    /** 外容器圆角；嵌套在已有圆角/直角父级时可设为 false */
+    rounded?: boolean;
+    /** 填充父级高度：表格自身成为受限滚动容器 */
+    fill?: boolean;
+    compact?: boolean;
+    size?: RsTableSize;
+    scrollX?: number | string;
+    selectable?: boolean;
+    selectionType?: RsTableSelectionType;
+    selectedRowKeys?: string[];
+    defaultSelectedRowKeys?: string[];
+    rowSelectable?: (row: T, index: number) => boolean;
+    expandable?: boolean;
+    expandedRowKeys?: string[];
+    defaultExpandedRowKeys?: string[];
+    rowExpandable?: (row: T, index: number) => boolean;
+    expandRowHeight?: number;
+    /**
+     * 树形表格：按 children 展平可见行，在指定列缩进展开。
+     * 与 `expandable`（明细行）/ `groupBy` 互斥。
+     */
+    treeConfig?: RsTableTreeConfig<T>;
+    striped?: boolean;
+    showIndex?: boolean;
+    /** 行号列宽度（px，showIndex 且未显示 edit gutter 时生效） */
+    indexWidth?: number;
+    showHeader?: boolean;
+    remoteSort?: boolean;
+    filterText?: string;
+    filterKeys?: string[];
+    columnFilters?: Record<string, string>;
+    defaultColumnFilters?: Record<string, string>;
+    groupBy?: RsTableGroupBy<T>;
+    groupLabel?: (key: string) => string;
+    sort?: RsTableSortState | null;
+    defaultSort?: RsTableSortState | null;
+    multiSort?: boolean;
+    maxSort?: number;
+    sorts?: RsTableSortState[];
+    defaultSorts?: RsTableSortState[];
+    columnDraggable?: boolean;
+    columnOrder?: string[];
+    defaultColumnOrder?: string[];
+    rowDraggable?: boolean;
+    rowDragTrigger?: RsTableRowDragTrigger;
+    rowDropMode?: RsTableRowDropMode;
+    rowDraggableWhen?: (row: T, index: number) => boolean;
+    rowDropTargetWhen?: (row: T, index: number) => boolean;
+    canRowDrop?: (dragKeys: string[], dropKey: string) => boolean;
+    virtual?: boolean;
+    /** fill 模式下数据行数达到该阈值时自动启用虚拟滚动；0 表示禁用自动启用 */
+    virtualAutoThreshold?: number;
+    /**
+     * 列虚拟化：仅渲染横向可视区附近的数据列。
+     * true 强制开；false 强制关；默认 `'auto'` 由 virtualColumnsAutoThreshold 判定。
+     */
+    virtualColumns?: boolean | 'auto';
+    /** 数据列数达到该阈值时自动列虚拟化；0 表示禁用自动。默认 40 */
+    virtualColumnsAutoThreshold?: number;
+    virtualColumnOverscan?: number;
+    height?: number | string;
+    rowHeight?: number;
+    overscan?: number;
+    infinite?: boolean;
+    hasMore?: boolean;
+    loadingMore?: boolean;
+    infiniteDistance?: number;
+    virtualOnInfinite?: boolean;
+    resizable?: boolean;
+    columnLayout?: 'auto' | 'fixed';
+    initialColumnWidths?: Record<string, number>;
+    minColumnWidth?: number;
+    maxColumnWidth?: number;
+    selectOnContextmenu?: boolean;
+    contextMenuItems?: (row: T | null, selectedRows: T[]) => RsContextMenuItem[];
+    contextMenu?: boolean;
+    cellTooltip?: boolean;
+    cellTooltipDelay?: number;
+    headerTooltip?: boolean;
+    editable?: boolean;
+    editTrigger?: 'click' | 'dblclick';
+    editGutter?: boolean;
+    editGutterWidth?: number;
+    highlightRow?: boolean;
+    highlightedRowKey?: string;
+    defaultHighlightedRowKey?: string;
+    highlightRowOnClick?: boolean;
+    rowCommit?: boolean;
+    rowPending?: (row: T, index: number) => boolean;
+    showRowStatus?: boolean;
+    allowNull?: boolean;
+    nullLabel?: string;
+    editFocusMode?: RsTableCellEditFocusMode;
+    editKeyboard?: boolean;
+    editUndo?: boolean;
+    editUndoLimit?: number;
+    editPaste?: boolean;
+    editBatch?: boolean;
+    summaryMode?: RsTableSummaryMode;
+    summaryData?: RsTableSummaryData | null;
+    showSummary?: boolean;
+    features?: RsTableFeature<T>[];
+    viewKey?: string | number;
+    layoutActive?: boolean;
+    /** 无障碍名称；未传时回退 i18n `table.a11yLabel` */
+    ariaLabel?: string;
+}
+/** RsTable 组件 emits（defineEmits 类型） */
+export type RsTableEmits<T extends RsTableRowData = RsTableRowData> = {
+    rowClick: [row: T, index: number];
+    rowDblclick: [row: T, index: number];
+    cellView: [row: T, column: RsTableColumn<T>, index: number];
+    rowContextmenu: [row: T, index: number, event: MouseEvent];
+    contextMenuSelect: [key: string, row: T | null, selectedRows: T[]];
+    'update:sort': [value: RsTableSortState | null];
+    'update:sorts': [value: RsTableSortState[]];
+    sortsChange: [value: RsTableSortState[]];
+    'update:columnOrder': [value: string[]];
+    columnOrderChange: [value: string[]];
+    'update:columnFilters': [value: Record<string, string>];
+    columnFiltersChange: [value: Record<string, string>];
+    rowDrop: [dragKeys: string[], dropKey: string, position: RsTableRowDropPosition];
+    rowDragStart: [dragKeys: string[], event: DragEvent];
+    'update:selectedRowKeys': [keys: string[]];
+    'update:expandedRowKeys': [keys: string[]];
+    selectionChange: [keys: string[]];
+    expandChange: [keys: string[]];
+    loadMore: [];
+    columnResize: [key: string, width: number];
+    'update:highlightedRowKey': [key: string | undefined];
+    highlightChange: [key: string | undefined];
+    cellEditStart: [row: T, column: RsTableColumn<T>, index: number];
+    cellEditDialog: [row: T, column: RsTableColumn<T>, index: number, draft: string];
+    cellEditCommit: [
+        row: T,
+        column: RsTableColumn<T>,
+        index: number,
+        value: unknown,
+        previous: unknown
+    ];
+    cellEditCancel: [row: T, column: RsTableColumn<T>, index: number];
+    cellEditInvalid: [
+        row: T,
+        column: RsTableColumn<T>,
+        index: number,
+        message: string,
+        value: unknown
+    ];
+    cellEditBatchCommit: [
+        column: RsTableColumn<T>,
+        changes: Array<{
+            row: T;
+            index: number;
+            value: unknown;
+            previous: unknown;
+        }>
+    ];
+    cellEditUndo: [
+        entry: {
+            items: Array<{
+                rowKey: string;
+                colKey: string;
+                rowIndex: number;
+                previous: unknown;
+                next: unknown;
+            }>;
+        }
+    ];
+    cellEditRedo: [
+        entry: {
+            items: Array<{
+                rowKey: string;
+                colKey: string;
+                rowIndex: number;
+                previous: unknown;
+                next: unknown;
+            }>;
+        }
+    ];
+    cellEditReject: [row: T, index: number, reason?: string];
+    rowEditCommit: [
+        row: T,
+        index: number,
+        changes: Array<{
+            colKey: string;
+            value: unknown;
+            previous: unknown;
+        }>
+    ];
+    rowEditRollback: [row: T, index: number];
+};
+/**
+ * 插槽回调按双变处理：宿主把 row 写成业务行类型时，不被逆变拒绝。
+ * 列插槽名是动态的，vue-tsc 不能从子组件 inject 推断 T，必须由 RsTable 自身 declare。
+ */
+type RsTableSlotFn<P> = {
+    bivarianceHack(props: P): unknown;
+}['bivarianceHack'];
+/** 列单元格插槽参数（`#columnKey`） */
+export interface RsTableColumnSlotProps<T extends RsTableRowData = RsTableRowData> {
+    row: T;
+    column: RsTableColumn<T>;
+    index: number;
+}
+/** 自定义编辑器插槽参数（`#edit-columnKey`） */
+export interface RsTableEditSlotProps<T extends RsTableRowData = RsTableRowData> extends RsTableColumnSlotProps<T> {
+    draft: string;
+    error: string | null;
+    update: (value: string) => void;
+    commit: () => void;
+    cancel: () => void;
+}
+/** 列头插槽参数（`#header-columnKey`） */
+export interface RsTableHeaderSlotProps<T extends RsTableRowData = RsTableRowData> {
+    column: RsTableColumn<T>;
+}
+/** 展开行插槽参数（`#expand`） */
+export interface RsTableExpandSlotProps<T extends RsTableRowData = RsTableRowData> {
+    row: T;
+    index: number;
+}
+/** 分组行插槽参数（`#group`） */
+export interface RsTableGroupSlotProps {
+    key: string;
+    label: string;
+}
+/**
+ * 按插槽名解析参数。列名是动态 key；`edit-*` / `header-*` 用模板字面量区分。
+ */
+export type RsTableSlotPropsOf<T extends RsTableRowData, K extends string> = K extends 'empty' | 'summary' ? Record<string, never> : K extends 'group' ? RsTableGroupSlotProps : K extends 'expand' ? RsTableExpandSlotProps<T> : K extends `header-${string}` ? RsTableHeaderSlotProps<T> : K extends `edit-${string}` ? RsTableEditSlotProps<T> : RsTableColumnSlotProps<T>;
+/**
+ * RsTable 公开插槽。用映射类型而不是 string 索引，避免 empty/group 与列插槽冲突。
+ */
+export type RsTableSlots<T extends RsTableRowData = RsTableRowData> = {
+    [K in string]?: RsTableSlotFn<RsTableSlotPropsOf<T, K>>;
+};
+/** withDefaults 第二参（工厂默认用函数） */
+export declare const RS_TABLE_PROP_DEFAULTS: {
+    loading: boolean;
+    bordered: boolean;
+    columnBordered: boolean;
+    rounded: boolean;
+    fill: boolean;
+    compact: boolean;
+    size: "md";
+    selectable: boolean;
+    selectionType: "checkbox";
+    expandable: boolean;
+    defaultExpandedRowKeys: () => string[];
+    striped: boolean;
+    showIndex: boolean;
+    indexWidth: number;
+    showHeader: boolean;
+    remoteSort: boolean;
+    defaultSelectedRowKeys: () => string[];
+    defaultSorts: () => RsTableSortState[];
+    defaultColumnOrder: () => string[];
+    multiSort: boolean;
+    maxSort: number;
+    columnDraggable: boolean;
+    rowDraggable: boolean;
+    rowDragTrigger: "handle";
+    rowDropMode: "reorder";
+    overscan: number;
+    virtualColumnOverscan: number;
+    infiniteDistance: number;
+    virtualOnInfinite: boolean;
+    virtualAutoThreshold: number;
+    virtualColumns: "auto";
+    virtualColumnsAutoThreshold: number;
+    resizable: boolean;
+    columnLayout: "auto";
+    minColumnWidth: number;
+    maxColumnWidth: number;
+    cellTooltip: boolean;
+    cellTooltipDelay: number;
+    headerTooltip: boolean;
+    editable: boolean;
+    editTrigger: "dblclick";
+    editGutter: boolean;
+    editGutterWidth: number;
+    highlightRow: boolean;
+    highlightRowOnClick: boolean;
+    rowCommit: boolean;
+    showRowStatus: boolean;
+    allowNull: boolean;
+    nullLabel: string;
+    editFocusMode: "end";
+    editKeyboard: boolean;
+    editUndo: boolean;
+    editUndoLimit: number;
+    editPaste: boolean;
+    editBatch: boolean;
+    contextMenu: boolean;
+    summaryMode: "client";
+    showSummary: boolean;
+};
+export {};

package/dist/components/table/rs-table-props.js

@@ -0,0 +1,64 @@
+//#region src/components/table/rs-table-props.ts
+/** withDefaults 第二参（工厂默认用函数） */
+var RS_TABLE_PROP_DEFAULTS = {
+	loading: false,
+	bordered: true,
+	columnBordered: false,
+	rounded: false,
+	fill: false,
+	compact: false,
+	size: "md",
+	selectable: false,
+	selectionType: "checkbox",
+	expandable: false,
+	defaultExpandedRowKeys: () => [],
+	striped: false,
+	showIndex: false,
+	indexWidth: 48,
+	showHeader: true,
+	remoteSort: false,
+	defaultSelectedRowKeys: () => [],
+	defaultSorts: () => [],
+	defaultColumnOrder: () => [],
+	multiSort: false,
+	maxSort: 3,
+	columnDraggable: false,
+	rowDraggable: false,
+	rowDragTrigger: "handle",
+	rowDropMode: "reorder",
+	overscan: 4,
+	virtualColumnOverscan: 2,
+	infiniteDistance: 80,
+	virtualOnInfinite: true,
+	virtualAutoThreshold: 50,
+	virtualColumns: "auto",
+	virtualColumnsAutoThreshold: 40,
+	resizable: false,
+	columnLayout: "auto",
+	minColumnWidth: 48,
+	maxColumnWidth: 640,
+	cellTooltip: true,
+	cellTooltipDelay: 300,
+	headerTooltip: true,
+	editable: false,
+	editTrigger: "dblclick",
+	editGutter: true,
+	editGutterWidth: 32,
+	highlightRow: false,
+	highlightRowOnClick: true,
+	rowCommit: false,
+	showRowStatus: true,
+	allowNull: true,
+	nullLabel: "(NULL)",
+	editFocusMode: "end",
+	editKeyboard: true,
+	editUndo: true,
+	editUndoLimit: 50,
+	editPaste: true,
+	editBatch: true,
+	contextMenu: true,
+	summaryMode: "client",
+	showSummary: false
+};
+//#endregion
+export { RS_TABLE_PROP_DEFAULTS };

package/dist/components/table/rs-table-view-context.d.ts

@@ -0,0 +1,218 @@
+/**
+ * RsTable 视图上下文（provide/inject）。
+ *
+ * 多表隔离（关键）：
+ * - 每个 RsTable 实例在自身 setup 内 provide，子树 inject 最近祖先
+ * - 同页多表互不影响：A 的 Header/Body 不会读到 B 的 view
+ * - 禁止把 view 存到模块级单例；instanceId 仅用于诊断
+ *
+ * 对比：RsTableModuleRegistry 是进程级全局（同 AG Grid ModuleRegistry），
+ * 会作用于所有实例；实例专属能力请用 props.features。
+ */
+import { type InjectionKey } from 'vue';
+import type { CSSProperties } from 'vue';
+import type { RsTableColumn, RsTableRowData, RsTableRowDropPosition, RsTableRowEntry, RsTableRowKey, RsTableSelectionType } from '../table-utils';
+import type { RsTableCellEditFocusMode, RsTableCellEditTrigger, RsTableCellNavigateDirection } from './table-edit-utils';
+export declare const RS_TABLE_VIEW_KEY: InjectionKey<RsTableViewContext>;
+/** 视图层内联样式（Vue CSSProperties 或普通字符串字典） */
+export type RsTableViewStyle = CSSProperties | Record<string, string> | undefined;
+export type RsTableHeaderLabels = {
+    selectAll: string;
+    index: string;
+    rowStatus: string;
+    dragColumn: string;
+    filterColumn: string;
+    filterPlaceholder: string;
+    filterClear: string;
+    filterApply: string;
+};
+export type RsTableBodyLabels = {
+    loading: string;
+    empty: string;
+    loadingMore: string;
+    dragRow: string;
+    expandRow: string;
+    collapseRow: string;
+    selectRow: string;
+    rowCommit: string;
+    rowRollback: string;
+    gutterCommit: string;
+};
+type RowEntry<T extends RsTableRowData> = Extract<RsTableRowEntry<T>, {
+    type: 'row';
+}>;
+/**
+ * 视图只读状态 + 事件处理。
+ * 状态字段经 getter 暴露，子组件 render 访问时收集依赖；多表各自刷新、互不串扰。
+ */
+export interface RsTableViewContext<T extends RsTableRowData = RsTableRowData> {
+    readonly instanceId: string;
+    readonly useFixedColumnLayout: boolean;
+    readonly showRowDragHandle: boolean;
+    readonly detailExpandable: boolean;
+    readonly showSelectColumn: boolean;
+    readonly showEditGutterColumn: boolean;
+    readonly showIndexColumn: boolean;
+    readonly showRowStatusColumn: boolean;
+    readonly columnPadLeft: number;
+    readonly columnPadRight: number;
+    readonly visibleDataColumns: RsTableColumn<T>[];
+    readonly prefixWidths: {
+        drag: number;
+        expand: number;
+        select: number;
+        status: number;
+    };
+    readonly resolvedGutterWidth: number;
+    readonly resolvedIndexWidth: number;
+    resolvedDataColumnWidth: (key: string, fallback?: number | string) => number;
+    readonly isRadioSelection: boolean;
+    readonly selectAllState: 'checked' | 'indeterminate' | 'unchecked';
+    readonly columnDraggable: boolean;
+    readonly resizable: boolean;
+    readonly multiSort: boolean;
+    readonly columnFiltersState: Record<string, string>;
+    readonly dragColumnKey: string | null;
+    readonly dropColumnKey: string | null;
+    readonly dragLeadHeaderStyle: RsTableViewStyle;
+    readonly expandLeadHeaderStyle: RsTableViewStyle;
+    readonly selectLeadHeaderStyle: RsTableViewStyle;
+    readonly gutterLeadHeaderStyle: RsTableViewStyle;
+    readonly indexLeadHeaderStyle: RsTableViewStyle;
+    readonly columnHeaderStyleMap: Map<string, Record<string, string> | undefined>;
+    readonly headerLabels: RsTableHeaderLabels;
+    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;
+    onToggleSelectAll: () => void;
+    onColumnDragOver: (key: string, event: DragEvent) => void;
+    onColumnDrop: (key: string, event: DragEvent) => void;
+    onColumnDragStart: (key: string, event: DragEvent) => void;
+    onColumnDragEnd: () => void;
+    updateColumnFilter: (key: string, value: string) => void;
+    onHeaderClick: (column: RsTableColumn<T>) => void;
+    onResizeStart: (key: string, event: MouseEvent) => void;
+    onHeaderPointerOver: (event: PointerEvent) => void;
+    onHeaderPointerOut: (event: PointerEvent) => void;
+    readonly loading: boolean;
+    readonly hasData: boolean;
+    readonly loadingMore: boolean;
+    readonly infinite: boolean;
+    readonly bodyColspan: number;
+    readonly emptyContentStyle: RsTableViewStyle;
+    readonly virtualScrollEnabled: boolean;
+    readonly virtualSlice: {
+        paddingTop: number;
+        paddingBottom: number;
+    };
+    readonly visibleEntries: RsTableRowEntry<T>[];
+    readonly rowKey: RsTableRowKey<T> | undefined;
+    readonly treeMode: boolean;
+    readonly treeIndentPx: number;
+    readonly treeExpandColumnKey: string | null;
+    readonly treeLoadingKeySet: Set<string>;
+    readonly striped: boolean;
+    readonly selectionType: RsTableSelectionType;
+    readonly editable: boolean;
+    readonly editTrigger: RsTableCellEditTrigger;
+    readonly rowCommit: boolean;
+    readonly allowNull: boolean;
+    readonly editFocusMode: RsTableCellEditFocusMode;
+    readonly nullLabel: string;
+    readonly dragLeadStyle: Record<string, string>;
+    readonly expandLeadStyle: Record<string, string>;
+    readonly selectLeadStyle: Record<string, string>;
+    readonly indexLeadStyle: Record<string, string>;
+    readonly gutterLeadStyle: Record<string, string>;
+    readonly columnTdClassMap: Map<string, string[]>;
+    readonly columnStyleMap: Map<string, Record<string, string> | undefined>;
+    readonly dragRowKeys: string[];
+    readonly dropRowTargetKey: string | null;
+    readonly dropRowPosition: RsTableRowDropPosition | null;
+    readonly activeEditCellKey: string;
+    readonly activeFocusCellKey: string;
+    readonly activeErrorMapSize: number;
+    readonly activeValidatingMapSize: number;
+    readonly stagedMapSize: number;
+    readonly editingDraft: string;
+    readonly editingCell: {
+        rowKey: string;
+        colKey: string;
+    } | null;
+    readonly focusCell: {
+        rowKey: string;
+        colKey: string;
+    } | null;
+    readonly bodyLabels: RsTableBodyLabels;
+    rowKeyFor: (entry: RowEntry<T>) => string;
+    isRowSelected: (entry: RowEntry<T>) => boolean;
+    isRowIndeterminate: (entry: RowEntry<T>) => boolean;
+    isRowExpanded: (entry: RowEntry<T>) => boolean;
+    isHighlighted: (rowKey: string) => boolean;
+    rowEditPending: (entry: RowEntry<T>) => boolean;
+    isExternalRowPending: (entry: RowEntry<T>) => boolean;
+    treeDepthOf: (entry: RowEntry<T>) => number;
+    canExpandRow: (entry: RowEntry<T>) => boolean;
+    canSelectRow: (entry: RowEntry<T>) => boolean;
+    isRowDragByRow: (entry: RowEntry<T>) => boolean;
+    isRowDragging: (entry: RowEntry<T>) => boolean;
+    isRowDropTarget: (entry: RowEntry<T>) => boolean;
+    isRowDirty: (rowKey: string) => boolean;
+    hasColumnSlot: (key: string) => boolean;
+    hasEditSlot: (key: string) => boolean;
+    cellTooltipEnabled: (column: RsTableColumn<T>, rowIndex: number) => boolean;
+    cellTooltipMode: (column: RsTableColumn<T>, rowIndex: number) => string | undefined;
+    cellTooltipText: (column: RsTableColumn<T>, row: T, rowIndex: number) => string | undefined;
+    cellTooltipFallbackTitle: (column: RsTableColumn<T>, row: T, rowIndex: number) => string | undefined;
+    getCellDraft: (rowKey: string, colKey: string) => string | undefined;
+    isCellDirty: (rowKey: string, colKey: string) => boolean;
+    getCellError: (rowKey: string, colKey: string) => string | undefined;
+    isCellValidating: (rowKey: string, colKey: string) => boolean;
+    onBodyPointerOver: (event: PointerEvent) => void;
+    onBodyPointerOut: (event: PointerEvent) => void;
+    onRowClick: (entry: RowEntry<T>, event: MouseEvent) => void;
+    onRowSelectMouseDown: (event: MouseEvent) => void;
+    onCellClick: (entry: RowEntry<T>, colKey: string, event: MouseEvent) => void;
+    onCellDblclick: (entry: RowEntry<T>, colKey: string, event: MouseEvent) => void;
+    onCellContextmenu: (entry: RowEntry<T>, colKey: string, event: MouseEvent) => void;
+    onRowDblclick: (entry: RowEntry<T>, event: MouseEvent) => void;
+    onRowContextmenu: (entry: RowEntry<T>, event: MouseEvent) => void;
+    onRowDragOver: (entry: RowEntry<T>, event: DragEvent) => void;
+    onRowDragLeave: (event: DragEvent) => void;
+    onRowDrop: (entry: RowEntry<T>, event: DragEvent) => void;
+    onRowDragStart: (entry: RowEntry<T>, event: DragEvent) => void;
+    onRowDragEnd: () => void;
+    onToggleExpand: (entry: RowEntry<T>) => void;
+    onToggleSelect: (entry: RowEntry<T>) => void;
+    onCellStartEdit: (entry: RowEntry<T>, colKey: string) => void;
+    onCellCommit: (entry: RowEntry<T>, colKey: string, value: string) => void;
+    onCellCancel: (entry: RowEntry<T>, colKey: string) => void;
+    onCellUpdateDraft: (entry: RowEntry<T>, colKey: string, value: string) => void;
+    onCellNavigate: (entry: RowEntry<T>, colKey: string, direction: RsTableCellNavigateDirection) => void;
+    onRowCommit: (entry: RowEntry<T>) => void;
+    onRowRollback: (entry: RowEntry<T>) => void;
+    onGutterCommit: (entry: RowEntry<T>) => void;
+}
+/**
+ * 显式区分 state getters 与 handlers，避免把零参 handler 误当成状态 getter。
+ */
+export declare function createRsTableViewContext<T extends RsTableRowData>(parts: {
+    state: {
+        [K in keyof RsTableViewContext<T>]?: () => RsTableViewContext<T>[K];
+    };
+    handlers: {
+        [K in keyof RsTableViewContext<T>]?: RsTableViewContext<T>[K];
+    };
+}): RsTableViewContext<T>;
+/** 在 RsTable 内 provide（每个实例调用一次） */
+export declare function provideRsTableView<T extends RsTableRowData>(ctx: RsTableViewContext<T>): void;
+/**
+ * 子视图 inject；必须在某个 RsTable 子树内。
+ * 多表场景下自动绑定到最近的表格实例。
+ */
+export declare function useRsTableView<T extends RsTableRowData = RsTableRowData>(): RsTableViewContext<T>;
+/** 测试用：重置 instance 序号 */
+export declare function resetRsTableViewInstanceSeqForTest(): void;
+export {};