niuma-ui 1.3.8 → 2.0.0

package/dist/components/table/src/context/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 '../utils/table-utils';
+import type { RsTableCellEditFocusMode, RsTableCellEditTrigger, RsTableCellNavigateDirection } from '../utils/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 {};

package/dist/components/table/src/context/rs-table-view-context.js

@@ -0,0 +1,47 @@
+import { inject, provide } from "vue";
+//#region src/components/table/src/context/rs-table-view-context.ts
+/**
+* RsTable 视图上下文（provide/inject）。
+*
+* 多表隔离（关键）：
+* - 每个 RsTable 实例在自身 setup 内 provide，子树 inject 最近祖先
+* - 同页多表互不影响：A 的 Header/Body 不会读到 B 的 view
+* - 禁止把 view 存到模块级单例；instanceId 仅用于诊断
+*
+* 对比：RsTableModuleRegistry 是进程级全局（同 AG Grid ModuleRegistry），
+* 会作用于所有实例；实例专属能力请用 props.features。
+*/
+/** 每实例递增，仅诊断用，不参与业务逻辑 */
+var viewInstanceSeq = 0;
+var RS_TABLE_VIEW_KEY = Symbol("rsTableView");
+/**
+* 显式区分 state getters 与 handlers，避免把零参 handler 误当成状态 getter。
+*/
+function createRsTableViewContext(parts) {
+	const ctx = { instanceId: `rs-table-view-${++viewInstanceSeq}` };
+	for (const [key, getter] of Object.entries(parts.state)) {
+		if (!getter) continue;
+		Object.defineProperty(ctx, key, {
+			enumerable: true,
+			configurable: true,
+			get: getter
+		});
+	}
+	for (const [key, fn] of Object.entries(parts.handlers)) if (fn !== void 0) ctx[key] = fn;
+	return ctx;
+}
+/** 在 RsTable 内 provide（每个实例调用一次） */
+function provideRsTableView(ctx) {
+	provide(RS_TABLE_VIEW_KEY, ctx);
+}
+/**
+* 子视图 inject；必须在某个 RsTable 子树内。
+* 多表场景下自动绑定到最近的表格实例。
+*/
+function useRsTableView() {
+	const ctx = inject(RS_TABLE_VIEW_KEY, null);
+	if (!ctx) throw new Error("[RsTable] useRsTableView() 必须在 RsTable 子树内调用（每表独立 provide，多表互不串扰）");
+	return ctx;
+}
+//#endregion
+export { RS_TABLE_VIEW_KEY, createRsTableViewContext, provideRsTableView, useRsTableView };

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

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

package/dist/components/table/src/createRsTableEditEmitBridge.d.ts

@@ -0,0 +1,16 @@
+/**
+ * 将 Vue emit 适配为 useRsTableEditActions 所需的 edit emit 袋。
+ */
+import type { EmitFn } from 'vue';
+import type { RsTableEmits } from './rs-table-props';
+import type { RsTableRowData } from './utils/table-utils';
+import type { UseRsTableEditActionsOptions } from './composables/useRsTableEditActions';
+type EditEmitBag<T extends RsTableRowData> = UseRsTableEditActionsOptions<T>['emit'];
+/**
+ * 创建编辑 emit 桥（避免 RsTable 内联一长串箭头函数）。
+ *
+ * 入参用 Vue `EmitFn<RsTableEmits>`，与 `defineEmits` 产物对齐；
+ * 勿用手写 overload 接口承接（交叉重载在参数位逆变，会报 cellView ̸∈ update:columnOrder）。
+ */
+export declare function createRsTableEditEmitBridge<T extends RsTableRowData>(emit: EmitFn<RsTableEmits<T>>): EditEmitBag<T>;
+export {};

package/dist/components/table/src/createRsTableEditEmitBridge.js

@@ -0,0 +1,25 @@
+//#region src/components/table/src/createRsTableEditEmitBridge.ts
+/**
+* 创建编辑 emit 桥（避免 RsTable 内联一长串箭头函数）。
+*
+* 入参用 Vue `EmitFn<RsTableEmits>`，与 `defineEmits` 产物对齐；
+* 勿用手写 overload 接口承接（交叉重载在参数位逆变，会报 cellView ̸∈ update:columnOrder）。
+*/
+function createRsTableEditEmitBridge(emit) {
+	return {
+		cellView: (row, column, index) => emit("cellView", row, column, index),
+		cellEditStart: (row, column, index) => emit("cellEditStart", row, column, index),
+		cellEditDialog: (row, column, index, draft) => emit("cellEditDialog", row, column, index, draft),
+		cellEditCommit: (row, column, index, value, previous) => emit("cellEditCommit", row, column, index, value, previous),
+		cellEditCancel: (row, column, index) => emit("cellEditCancel", row, column, index),
+		cellEditInvalid: (row, column, index, message, value) => emit("cellEditInvalid", row, column, index, message, value),
+		cellEditBatchCommit: (column, changes) => emit("cellEditBatchCommit", column, changes),
+		cellEditUndo: (entry) => emit("cellEditUndo", entry),
+		cellEditRedo: (entry) => emit("cellEditRedo", entry),
+		cellEditReject: (row, index, reason) => emit("cellEditReject", row, index, reason),
+		rowEditCommit: (row, index, changes) => emit("rowEditCommit", row, index, changes),
+		rowEditRollback: (row, index) => emit("rowEditRollback", row, index)
+	};
+}
+//#endregion
+export { createRsTableEditEmitBridge };

package/dist/components/table/src/features/rs-table-feature-host.d.ts

@@ -0,0 +1,61 @@
+/**
+ * Feature 运行时宿主：贡献袋 + 生命周期（对标可插拔中间件总线）。
+ *
+ * 贡献点（实例级，多表互不串扰）：
+ * - contextMenu：右键菜单
+ * - toolbar：表头工具条项
+ * - overlay：浮层/旁路 UI 标记（图表容器挂载点等）
+ *
+ * 每个 RsTable 各自 createRsTableFeatureHost()；不要跨实例复用 host。
+ */
+import type { RsContextMenuItem } from '../../../context-menu/src/context-menu-utils';
+import type { RsTableRowData } from '../utils/table-utils';
+import type { RsTableAnalyticsSnapshot } from '../composables/useRsTableSelectionSource';
+import type { RsTableFeature, RsTableFeatureContext } from './table-features';
+/** 动态右键菜单贡献函数 */
+export type RsTableContextMenuContributor<T extends RsTableRowData> = (items: RsContextMenuItem[], ctx: {
+    row: T | null;
+    selectedRows: T[];
+}) => void;
+/** 工具条贡献项 */
+export interface RsTableToolbarItem {
+    key: string;
+    label: string;
+    icon?: string;
+    disabled?: boolean;
+    onClick?: () => void;
+}
+export type RsTableToolbarContributor = (items: RsTableToolbarItem[]) => void;
+/** Overlay 贡献（旁路挂载描述，不直接操作 DOM） */
+export interface RsTableOverlayContribution {
+    key: string;
+    /** 业务自定义渲染/挂载标识 */
+    slot?: string;
+    meta?: Record<string, unknown>;
+}
+export type RsTableOverlayContributor = (items: RsTableOverlayContribution[]) => void;
+/**
+ * 单次 setup 周期内的贡献收集器（实例私有）。
+ */
+export interface RsTableFeatureHost<T extends RsTableRowData = RsTableRowData> {
+    createContext: (base: {
+        getViewRows: () => T[];
+        getSelectedRows: () => T[];
+        getAnalyticsSnapshot: () => RsTableAnalyticsSnapshot<T>;
+        subscribeAnalytics: (listener: (snap: RsTableAnalyticsSnapshot<T>) => void) => () => void;
+    }) => RsTableFeatureContext<T>;
+    setup: (features: RsTableFeature<T>[], ctx: RsTableFeatureContext<T>) => () => void;
+    mergeContextMenuItems: (baseItems: RsContextMenuItem[], menuCtx: {
+        row: T | null;
+        selectedRows: T[];
+    }) => RsContextMenuItem[];
+    /** 合并 toolbar 贡献 */
+    getToolbarItems: () => RsTableToolbarItem[];
+    /** 合并 overlay 贡献 */
+    getOverlayContributions: () => RsTableOverlayContribution[];
+    getActiveFeatureIds: () => string[];
+}
+/**
+ * 创建 Feature 宿主（每个 RsTable 实例一个 —— 多表请各建各的）。
+ */
+export declare function createRsTableFeatureHost<T extends RsTableRowData>(): RsTableFeatureHost<T>;

package/dist/components/table/src/features/rs-table-feature-host.js

@@ -0,0 +1,97 @@
+import { setupTableFeatures } from "./table-features.js";
+//#region src/components/table/src/features/rs-table-feature-host.ts
+/**
+* 创建 Feature 宿主（每个 RsTable 实例一个 —— 多表请各建各的）。
+*/
+function createRsTableFeatureHost() {
+	let menuContributors = [];
+	let toolbarContributors = [];
+	let overlayContributors = [];
+	let activeIds = [];
+	function createContext(base) {
+		return {
+			getViewRows: base.getViewRows,
+			getSelectedRows: base.getSelectedRows,
+			getAnalyticsSnapshot: base.getAnalyticsSnapshot,
+			subscribeAnalytics: base.subscribeAnalytics,
+			contributeContextMenuItems(contributor) {
+				if (typeof contributor === "function") {
+					menuContributors.push(contributor);
+					return;
+				}
+				const staticItems = contributor;
+				menuContributors.push((items) => {
+					items.push(...staticItems);
+				});
+			},
+			contributeToolbarItems(contributor) {
+				if (typeof contributor === "function") {
+					toolbarContributors.push(contributor);
+					return;
+				}
+				const staticItems = contributor;
+				toolbarContributors.push((items) => {
+					items.push(...staticItems);
+				});
+			},
+			contributeOverlay(contributor) {
+				if (typeof contributor === "function") {
+					overlayContributors.push(contributor);
+					return;
+				}
+				const staticItems = contributor;
+				overlayContributors.push((items) => {
+					items.push(...staticItems);
+				});
+			}
+		};
+	}
+	function setup(features, ctx) {
+		menuContributors = [];
+		toolbarContributors = [];
+		overlayContributors = [];
+		activeIds = features.map((f) => f.id);
+		const dispose = setupTableFeatures(features, ctx);
+		return () => {
+			dispose();
+			menuContributors = [];
+			toolbarContributors = [];
+			overlayContributors = [];
+			activeIds = [];
+		};
+	}
+	function mergeContextMenuItems(baseItems, menuCtx) {
+		const items = [...baseItems];
+		const before = items.length;
+		for (const contribute of menuContributors) contribute(items, menuCtx);
+		if (before > 0 && items.length > before && !items[before]?.separator) items.splice(before, 0, {
+			key: "__ctx-feature-sep",
+			label: "",
+			separator: true
+		});
+		return items;
+	}
+	function getToolbarItems() {
+		const items = [];
+		for (const contribute of toolbarContributors) contribute(items);
+		return items;
+	}
+	function getOverlayContributions() {
+		const items = [];
+		for (const contribute of overlayContributors) contribute(items);
+		return items;
+	}
+	function getActiveFeatureIds() {
+		return [...activeIds];
+	}
+	return {
+		createContext,
+		setup,
+		mergeContextMenuItems,
+		getToolbarItems,
+		getOverlayContributions,
+		getActiveFeatureIds
+	};
+}
+//#endregion
+export { createRsTableFeatureHost };

package/dist/components/table/src/features/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/src/context-menu-utils';
+import type { RsTableRowData } from '../utils/table-utils';
+import type { RsTableAnalyticsSnapshot } from '../composables/useRsTableSelectionSource';
+import type { RsTableOverlayContribution, RsTableToolbarItem } from './rs-table-feature-host';
+import { type RsTableChartSeries, type RsTableChartSeriesDef } from '../utils/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>;