niuma-ui 1.3.9 → 2.0.0

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

@@ -0,0 +1,34 @@
+/**
+ * 装配 RsTable 公开 Api（从 SFC 下沉，单一出口）。
+ */
+import type { ComputedRef, Ref } from 'vue';
+import type { RsTableApi } from './rs-table-api';
+import type { RsTableRowData, RsTableRowEntry } from './utils/table-utils';
+import type { RsTableAnalyticsSnapshot } from './composables/useRsTableSelectionSource';
+import type { useRsTable } from './composables/useRsTable';
+type RowEntry<T extends RsTableRowData> = Extract<RsTableRowEntry<T>, {
+    type: 'row';
+}>;
+export interface AssembleRsTableApiOptions<T extends RsTableRowData> {
+    tableSurface: ReturnType<typeof useRsTable<T>>;
+    dataRows: Ref<RowEntry<T>[]> | ComputedRef<RowEntry<T>[]>;
+    rowKeyByIndex: Ref<Map<number, string>> | ComputedRef<Map<number, string>>;
+    viewRows: Ref<T[]> | ComputedRef<T[]>;
+    selectedRows: Ref<T[]> | ComputedRef<T[]>;
+    selectedRowKeys: Ref<string[]> | ComputedRef<string[]>;
+    getAnalyticsSnapshot: () => RsTableAnalyticsSnapshot<T>;
+    subscribeAnalytics: (listener: (snap: RsTableAnalyticsSnapshot<T>) => void) => () => void;
+    getRowByKey: (rowKey: string, dataRows: RowEntry<T>[], rowKeyByIndex: Map<number, string>) => T | undefined;
+    getRowByIndex: (index: number, dataRows: RowEntry<T>[]) => T | undefined;
+    getColumnValues: (colKey: string, dataRows: RowEntry<T>[]) => unknown[];
+    getCellValue: (rowKey: string, colKey: string, dataRows: RowEntry<T>[], rowKeyByIndex: Map<number, string>) => unknown;
+    toApiEditSlice: (ctx: {
+        dataRows: Ref<RowEntry<T>[]> | ComputedRef<RowEntry<T>[]>;
+        rowKeyByIndex: Ref<Map<number, string>> | ComputedRef<Map<number, string>>;
+    }) => Pick<RsTableApi<T>, 'getHighlightedRowKey' | 'setHighlightedRowKey' | 'cancelCellEdit' | 'cancelAllEdits' | 'getDirtyCellKeys' | 'getCellError' | 'setCellError' | 'stageCell' | 'rejectRowEdit' | 'undoEdit' | 'redoEdit' | 'commitRowEdits' | 'rollbackRowEdits'>;
+}
+/**
+ * 创建并返回 RsTableApi（含 feature 元数据）。
+ */
+export declare function assembleRsTableApi<T extends RsTableRowData>(options: AssembleRsTableApiOptions<T>): RsTableApi<T>;
+export {};

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

@@ -0,0 +1,26 @@
+//#region src/components/table/src/assembleRsTableApi.ts
+/**
+* 创建并返回 RsTableApi（含 feature 元数据）。
+*/
+function assembleRsTableApi(options) {
+	const { tableSurface, dataRows, rowKeyByIndex } = options;
+	return tableSurface.createApi({
+		getRowByKey: (rowKey) => options.getRowByKey(rowKey, dataRows.value, rowKeyByIndex.value),
+		getRowByIndex: (index) => options.getRowByIndex(index, dataRows.value),
+		getColumnValues: (colKey) => options.getColumnValues(colKey, dataRows.value),
+		getCellValue: (rowKey, colKey) => options.getCellValue(rowKey, colKey, dataRows.value, rowKeyByIndex.value),
+		getViewRows: () => options.viewRows.value,
+		getSelectedRows: () => options.selectedRows.value,
+		getSelectedRowKeys: () => [...options.selectedRowKeys.value],
+		getAnalyticsSnapshot: options.getAnalyticsSnapshot,
+		subscribeAnalytics: options.subscribeAnalytics,
+		...options.toApiEditSlice({
+			dataRows,
+			rowKeyByIndex
+		}),
+		getToolbarItems: () => tableSurface.getToolbarItems(),
+		getOverlayContributions: () => tableSurface.getOverlayContributions()
+	});
+}
+//#endregion
+export { assembleRsTableApi };

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

@@ -0,0 +1,73 @@
+/**
+ * 将 Shell / Edit / Chrome 接线捆成 ViewContext provide（削薄 RsTable.vue）。
+ */
+import type { ComputedRef, Ref } from 'vue';
+import type { RsTableRowData, RsTableRowEntry, RsTableRowKey, RsTableSelectionType } from './utils/table-utils';
+import type { RsTableCellEditFocusMode, RsTableCellEditTrigger } from './utils/table-edit-utils';
+import type { RsTableBodyLabels, RsTableHeaderLabels } from './context/rs-table-view-context';
+import type { useTableEdit } from './composables/useTableEdit';
+import { type RsTableViewProvideHandlers, type RsTableViewProvideSources } from './composables/useRsTableViewProvide';
+type RowEntry<T extends RsTableRowData> = Extract<RsTableRowEntry<T>, {
+    type: 'row';
+}>;
+type TableEditApi = ReturnType<typeof useTableEdit>;
+export interface BindRsTableViewContextDeps<T extends RsTableRowData> {
+    props: {
+        columnDraggable: () => boolean;
+        resizable: () => boolean;
+        multiSort: () => boolean;
+        loading: () => boolean;
+        loadingMore: () => boolean;
+        infinite: () => boolean;
+        rowKey: () => RsTableRowKey<T> | undefined;
+        striped: () => boolean;
+        selectionType: () => RsTableSelectionType;
+        editable: () => boolean;
+        editTrigger: () => RsTableCellEditTrigger;
+        rowCommit: () => boolean;
+        allowNull: () => boolean;
+        editFocusMode: () => RsTableCellEditFocusMode;
+        nullLabel: () => string;
+    };
+    layout: Pick<RsTableViewProvideSources<T>, 'useFixedColumnLayout' | 'showRowDragHandle' | 'detailExpandable' | 'showSelectColumn' | 'showEditGutterColumn' | 'showIndexColumn' | 'showRowStatusColumn' | 'columnPadLeft' | 'columnPadRight' | 'visibleDataColumns' | 'prefixWidths' | 'resolvedGutterWidth' | 'resolvedIndexWidth' | 'isRadioSelection' | 'selectAllState' | 'columnFiltersState' | 'dragColumnKey' | 'dropColumnKey' | 'dragLeadHeaderStyle' | 'expandLeadHeaderStyle' | 'selectLeadHeaderStyle' | 'gutterLeadHeaderStyle' | 'indexLeadHeaderStyle' | 'columnHeaderStyleMap' | 'bodyColspan' | 'emptyContentStyle' | 'virtualScrollEnabled' | 'virtualSlice' | 'visibleEntries' | 'treeMode' | 'treeIndentPx' | 'treeExpandColumnKey' | 'treeLoadingKeySet' | 'dragLeadStyle' | 'expandLeadStyle' | 'selectLeadStyle' | 'indexLeadStyle' | 'gutterLeadStyle' | 'columnTdClassMap' | 'columnStyleMap' | 'dragRowKeys' | 'dropRowTargetKey' | 'dropRowPosition'>;
+    chrome: {
+        hasData: Ref<boolean> | ComputedRef<boolean>;
+        headerLabels: Ref<RsTableHeaderLabels> | ComputedRef<RsTableHeaderLabels>;
+        bodyLabels: Ref<RsTableBodyLabels> | ComputedRef<RsTableBodyLabels>;
+        hasColumnSlot: (key: string) => boolean;
+        hasEditSlot: (key: string) => boolean;
+    };
+    edit: {
+        tableEdit: TableEditApi;
+        activeEditCellKey: Ref<string> | ComputedRef<string>;
+        activeFocusCellKey: Ref<string> | ComputedRef<string>;
+        activeErrorMapSize: Ref<number> | ComputedRef<number>;
+        activeValidatingMapSize: Ref<number> | ComputedRef<number>;
+        cellTooltipEnabled: RsTableViewProvideHandlers<T>['cellTooltipEnabled'];
+        cellTooltipMode: RsTableViewProvideHandlers<T>['cellTooltipMode'];
+        cellTooltipText: RsTableViewProvideHandlers<T>['cellTooltipText'];
+        cellTooltipFallbackTitle: RsTableViewProvideHandlers<T>['cellTooltipFallbackTitle'];
+        rowEditPending: RsTableViewProvideHandlers<T>['rowEditPending'];
+        isExternalRowPending: RsTableViewProvideHandlers<T>['isExternalRowPending'];
+        onCellStartEdit: RsTableViewProvideHandlers<T>['onCellStartEdit'];
+        onCellCommit: RsTableViewProvideHandlers<T>['onCellCommit'];
+        onCellCancel: RsTableViewProvideHandlers<T>['onCellCancel'];
+        onCellUpdateDraft: RsTableViewProvideHandlers<T>['onCellUpdateDraft'];
+        onCellNavigate: RsTableViewProvideHandlers<T>['onCellNavigate'];
+        onRowCommit: RsTableViewProvideHandlers<T>['onRowCommit'];
+        onRowRollback: RsTableViewProvideHandlers<T>['onRowRollback'];
+        onGutterCommit: RsTableViewProvideHandlers<T>['onGutterCommit'];
+        onCellClick: RsTableViewProvideHandlers<T>['onCellClick'];
+        onCellDblclick: RsTableViewProvideHandlers<T>['onCellDblclick'];
+    };
+    interaction: {
+        isHighlighted: (key: string) => boolean;
+        onCellTipOver: (event: PointerEvent) => void;
+        onCellTipOut: (event: PointerEvent) => void;
+    } & Pick<RsTableViewProvideHandlers<T>, 'resolvedDataColumnWidth' | 'columnFilterValue' | 'sortOrderFor' | 'sortPriorityFor' | 'sortIconName' | 'onToggleSelectAll' | 'onColumnDragOver' | 'onColumnDrop' | 'onColumnDragStart' | 'onColumnDragEnd' | 'updateColumnFilter' | 'onHeaderClick' | 'onResizeStart' | 'rowKeyFor' | 'isRowSelected' | 'isRowIndeterminate' | 'isRowExpanded' | 'treeDepthOf' | 'canExpandRow' | 'canSelectRow' | 'isRowDragByRow' | 'isRowDragging' | 'isRowDropTarget' | 'onRowClick' | 'onRowSelectMouseDown' | 'onCellContextmenu' | 'onRowDblclick' | 'onRowContextmenu' | 'onRowDragOver' | 'onRowDragLeave' | 'onRowDrop' | 'onRowDragStart' | 'onRowDragEnd' | 'onToggleExpand' | 'onToggleSelect'>;
+}
+/**
+ * 装配并 provide ViewContext。
+ */
+export declare function bindRsTableViewContext<T extends RsTableRowData>(deps: BindRsTableViewContextDeps<T>): import("..").RsTableViewContext<T>;
+export type { RowEntry };

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

@@ -0,0 +1,104 @@
+import { useRsTableViewProvide } from "./composables/useRsTableViewProvide.js";
+//#region src/components/table/src/bindRsTableViewContext.ts
+/**
+* 装配并 provide ViewContext。
+*/
+function bindRsTableViewContext(deps) {
+	const { props, layout, chrome, edit, interaction } = deps;
+	const { tableEdit } = edit;
+	return useRsTableViewProvide({
+		...layout,
+		columnDraggable: props.columnDraggable,
+		resizable: props.resizable,
+		multiSort: props.multiSort,
+		headerLabels: chrome.headerLabels,
+		loading: props.loading,
+		hasData: chrome.hasData,
+		loadingMore: props.loadingMore,
+		infinite: props.infinite,
+		rowKey: props.rowKey,
+		striped: props.striped,
+		selectionType: props.selectionType,
+		editable: props.editable,
+		editTrigger: props.editTrigger,
+		rowCommit: props.rowCommit,
+		allowNull: props.allowNull,
+		editFocusMode: props.editFocusMode,
+		nullLabel: props.nullLabel,
+		activeEditCellKey: edit.activeEditCellKey,
+		activeFocusCellKey: edit.activeFocusCellKey,
+		activeErrorMapSize: edit.activeErrorMapSize,
+		activeValidatingMapSize: edit.activeValidatingMapSize,
+		stagedMapSize: () => tableEdit.stagedMap.value.size,
+		editingDraft: () => tableEdit.editingDraft.value,
+		editingCell: () => tableEdit.editingCell.value,
+		focusCell: () => tableEdit.focusCell.value,
+		bodyLabels: chrome.bodyLabels
+	}, {
+		resolvedDataColumnWidth: interaction.resolvedDataColumnWidth,
+		columnFilterValue: interaction.columnFilterValue,
+		sortOrderFor: interaction.sortOrderFor,
+		sortPriorityFor: interaction.sortPriorityFor,
+		sortIconName: interaction.sortIconName,
+		onToggleSelectAll: interaction.onToggleSelectAll,
+		onColumnDragOver: interaction.onColumnDragOver,
+		onColumnDrop: interaction.onColumnDrop,
+		onColumnDragStart: interaction.onColumnDragStart,
+		onColumnDragEnd: interaction.onColumnDragEnd,
+		updateColumnFilter: interaction.updateColumnFilter,
+		onHeaderClick: interaction.onHeaderClick,
+		onResizeStart: interaction.onResizeStart,
+		onHeaderPointerOver: interaction.onCellTipOver,
+		onHeaderPointerOut: interaction.onCellTipOut,
+		rowKeyFor: interaction.rowKeyFor,
+		isRowSelected: interaction.isRowSelected,
+		isRowIndeterminate: interaction.isRowIndeterminate,
+		isRowExpanded: interaction.isRowExpanded,
+		isHighlighted: interaction.isHighlighted,
+		rowEditPending: edit.rowEditPending,
+		isExternalRowPending: edit.isExternalRowPending,
+		treeDepthOf: interaction.treeDepthOf,
+		canExpandRow: interaction.canExpandRow,
+		canSelectRow: interaction.canSelectRow,
+		isRowDragByRow: interaction.isRowDragByRow,
+		isRowDragging: interaction.isRowDragging,
+		isRowDropTarget: interaction.isRowDropTarget,
+		isRowDirty: tableEdit.isRowDirty,
+		hasColumnSlot: chrome.hasColumnSlot,
+		hasEditSlot: chrome.hasEditSlot,
+		cellTooltipEnabled: edit.cellTooltipEnabled,
+		cellTooltipMode: edit.cellTooltipMode,
+		cellTooltipText: edit.cellTooltipText,
+		cellTooltipFallbackTitle: edit.cellTooltipFallbackTitle,
+		getCellDraft: tableEdit.getDraft,
+		isCellDirty: tableEdit.isDirty,
+		getCellError: tableEdit.getCellError,
+		isCellValidating: tableEdit.isValidating,
+		onBodyPointerOver: interaction.onCellTipOver,
+		onBodyPointerOut: interaction.onCellTipOut,
+		onRowClick: interaction.onRowClick,
+		onRowSelectMouseDown: interaction.onRowSelectMouseDown,
+		onCellClick: edit.onCellClick,
+		onCellDblclick: edit.onCellDblclick,
+		onCellContextmenu: interaction.onCellContextmenu,
+		onRowDblclick: interaction.onRowDblclick,
+		onRowContextmenu: interaction.onRowContextmenu,
+		onRowDragOver: interaction.onRowDragOver,
+		onRowDragLeave: interaction.onRowDragLeave,
+		onRowDrop: interaction.onRowDrop,
+		onRowDragStart: interaction.onRowDragStart,
+		onRowDragEnd: interaction.onRowDragEnd,
+		onToggleExpand: interaction.onToggleExpand,
+		onToggleSelect: interaction.onToggleSelect,
+		onCellStartEdit: edit.onCellStartEdit,
+		onCellCommit: edit.onCellCommit,
+		onCellCancel: edit.onCellCancel,
+		onCellUpdateDraft: edit.onCellUpdateDraft,
+		onCellNavigate: edit.onCellNavigate,
+		onRowCommit: edit.onRowCommit,
+		onRowRollback: edit.onRowRollback,
+		onGutterCommit: edit.onGutterCommit
+	});
+}
+//#endregion
+export { bindRsTableViewContext };

package/dist/components/table/src/composables/useRsTable.d.ts

@@ -0,0 +1,61 @@
+/**
+ * RsTable 公开面编排（对标 AG Grid api / TanStack table instance）。
+ *
+ * 职责：
+ * - FeatureHost：全局模块 + 实例 features 生命周期与贡献袋
+ * - RsTableApi：统一 create / provide，避免 expose 与 inject 漂移
+ *
+ * 内核装配（Columns / Engine / Virtual）见 useRsTableCore；本文件保持公开面轻量。
+ */
+import type { RsContextMenuItem } from '../../../context-menu/src/context-menu-utils';
+import type { RsTableRowData } from '../utils/table-utils';
+import { type RsTableApi } from '../rs-table-api';
+import { type RsTableFeatureHost, type RsTableOverlayContribution, type RsTableToolbarItem } from '../features/rs-table-feature-host';
+import { type RsTableBuiltinFeatureId, type RsTableFeature } from '../features/table-features';
+import type { RsTableAnalyticsSnapshot } from './useRsTableSelectionSource';
+export type { RsTableApi };
+export { RS_TABLE_API_KEY, RS_TABLE_API_VERSION, isRsTableApi } from '../rs-table-api';
+export { RsTableModuleRegistry, resolveInstanceFeatures } from '../context/rs-table-module-registry';
+/**
+ * useRsTable 返回的公开面：Feature 宿主 + API 工厂。
+ */
+export interface UseRsTableSurface<T extends RsTableRowData = RsTableRowData> {
+    featureHost: RsTableFeatureHost<T>;
+    /**
+     * 绑定内置 id + 实例/全局 features；返回 dispose。
+     * 应在 watch(immediate) 中调用，替换旧 dispose。
+     */
+    bindFeatures: (options: {
+        builtinIds: RsTableBuiltinFeatureId[];
+        instanceFeatures?: RsTableFeature<T>[] | null;
+        getViewRows: () => T[];
+        getSelectedRows: () => T[];
+        getAnalyticsSnapshot: () => RsTableAnalyticsSnapshot<T>;
+        subscribeAnalytics: (listener: (snap: RsTableAnalyticsSnapshot<T>) => void) => () => void;
+    }) => () => void;
+    /** 合并 props 自定义菜单与 feature 贡献 */
+    mergeContextMenuItems: (baseItems: RsContextMenuItem[], menuCtx: {
+        row: T | null;
+        selectedRows: T[];
+    }) => RsContextMenuItem[];
+    /** 由内部实现装配冻结 API，并可选 provide */
+    createApi: (impl: Omit<RsTableApi<T>, 'apiVersion' | 'getActiveFeatureIds'> & {
+        getActiveFeatureIds?: () => string[];
+    }, options?: {
+        provide?: boolean;
+    }) => RsTableApi<T>;
+    getActiveFeatureIds: () => string[];
+    /** 实例级 toolbar 贡献（多表互不共享） */
+    getToolbarItems: () => RsTableToolbarItem[];
+    /** 实例级 overlay 贡献 */
+    getOverlayContributions: () => RsTableOverlayContribution[];
+}
+/**
+ * 创建表格公开面（每个 RsTable 实例调用一次）。
+ */
+export declare function useRsTable<T extends RsTableRowData = RsTableRowData>(): UseRsTableSurface<T>;
+/**
+ * 子树内注入表格 API（插槽/子组件用）。
+ * 未 provide 时返回 undefined。
+ */
+export declare function useRsTableApi<T extends RsTableRowData = RsTableRowData>(): RsTableApi<T> | undefined;

package/dist/components/table/src/composables/useRsTable.js

@@ -0,0 +1,57 @@
+import { createBuiltinTableFeatures } from "../features/table-features.js";
+import { RS_TABLE_API_KEY, RS_TABLE_API_VERSION, createRsTableApi, isRsTableApi } from "../rs-table-api.js";
+import { createRsTableFeatureHost } from "../features/rs-table-feature-host.js";
+import { RsTableModuleRegistry, resolveInstanceFeatures } from "../context/rs-table-module-registry.js";
+import { inject, provide } from "vue";
+//#region src/components/table/src/composables/useRsTable.ts
+/**
+* RsTable 公开面编排（对标 AG Grid api / TanStack table instance）。
+*
+* 职责：
+* - FeatureHost：全局模块 + 实例 features 生命周期与贡献袋
+* - RsTableApi：统一 create / provide，避免 expose 与 inject 漂移
+*
+* 内核装配（Columns / Engine / Virtual）见 useRsTableCore；本文件保持公开面轻量。
+*/
+/**
+* 创建表格公开面（每个 RsTable 实例调用一次）。
+*/
+function useRsTable() {
+	const featureHost = createRsTableFeatureHost();
+	function bindFeatures(options) {
+		const features = resolveInstanceFeatures([...createBuiltinTableFeatures(options.builtinIds), ...options.instanceFeatures ?? []]);
+		const ctx = featureHost.createContext({
+			getViewRows: options.getViewRows,
+			getSelectedRows: options.getSelectedRows,
+			getAnalyticsSnapshot: options.getAnalyticsSnapshot,
+			subscribeAnalytics: options.subscribeAnalytics
+		});
+		return featureHost.setup(features, ctx);
+	}
+	function createApi(impl, options) {
+		const api = createRsTableApi({
+			...impl,
+			getActiveFeatureIds: impl.getActiveFeatureIds ?? (() => featureHost.getActiveFeatureIds())
+		});
+		if (options?.provide !== false) provide(RS_TABLE_API_KEY, api);
+		return api;
+	}
+	return {
+		featureHost,
+		bindFeatures,
+		mergeContextMenuItems: (base, menuCtx) => featureHost.mergeContextMenuItems(base, menuCtx),
+		createApi,
+		getActiveFeatureIds: () => featureHost.getActiveFeatureIds(),
+		getToolbarItems: () => featureHost.getToolbarItems(),
+		getOverlayContributions: () => featureHost.getOverlayContributions()
+	};
+}
+/**
+* 子树内注入表格 API（插槽/子组件用）。
+* 未 provide 时返回 undefined。
+*/
+function useRsTableApi() {
+	return inject(RS_TABLE_API_KEY, void 0);
+}
+//#endregion
+export { RS_TABLE_API_KEY, RS_TABLE_API_VERSION, RsTableModuleRegistry, isRsTableApi, resolveInstanceFeatures, useRsTable, useRsTableApi };

package/dist/components/table/src/composables/useRsTableA11y.js

@@ -0,0 +1,34 @@
+import { computed } from "vue";
+//#region src/components/table/src/composables/useRsTableA11y.ts
+/**
+* RsTable 无障碍基线：region / grid 语义与 loading busy。
+*
+* 与 useRsTableGridKeyboard + 单元格 role=gridcell 配合，形成可漫游网格。
+* tabindex 放在 role=grid 的 table 上（复合控件可聚焦），勿放在 region 壳层。
+*/
+function read(source) {
+	return typeof source === "function" ? source() : source.value;
+}
+/**
+* 壳层 / table 元素无障碍属性。
+*/
+function useRsTableA11y(options) {
+	const resolvedLabel = computed(() => options.ariaLabel()?.trim() || options.defaultLabel());
+	return {
+		resolvedLabel,
+		shellA11y: computed(() => ({
+			role: "region",
+			"aria-label": resolvedLabel.value,
+			"aria-busy": options.loading() ? true : void 0
+		})),
+		tableA11y: computed(() => ({
+			role: "grid",
+			tabindex: 0,
+			"aria-rowcount": Math.max(0, read(options.rowCount)),
+			"aria-colcount": Math.max(0, read(options.colCount)),
+			"aria-label": resolvedLabel.value
+		}))
+	};
+}
+//#endregion
+export { useRsTableA11y };

package/dist/components/table/src/composables/useRsTableChartBridge.d.ts

@@ -0,0 +1,37 @@
+/**
+ * 表格图表桥：订阅 SelectionSource，产出库无关 chart series。
+ *
+ * 业务页可：
+ * - 把 series 丢给 ECharts option 组装
+ * - 或在图表点击时用 point.key 反查行做联动筛选
+ *
+ * 性能：series 随 sourceRows 浅引用变化重算；defs 建议业务侧稳定引用。
+ */
+import { type ComputedRef, type Ref } from 'vue';
+import type { RsTableRowData } from '../utils/table-utils';
+import { type RsTableChartSeries, type RsTableChartSeriesDef } from '../utils/table-chart-utils';
+import { type RsTableAnalyticsSnapshot } from './useRsTableSelectionSource';
+export interface UseRsTableChartBridgeOptions<T extends RsTableRowData> {
+    viewRows: Ref<T[]> | ComputedRef<T[]>;
+    selectedRows?: Ref<T[]> | ComputedRef<T[]>;
+    /** 系列定义列表；变化会触发重算 */
+    seriesDefs: Ref<RsTableChartSeriesDef[]> | ComputedRef<RsTableChartSeriesDef[]> | RsTableChartSeriesDef[];
+}
+/**
+ * 选中联动图表桥。
+ *
+ * @returns selection 源 + series 列表 + getSnapshot
+ */
+export declare function useRsTableChartBridge<T extends RsTableRowData>(options: UseRsTableChartBridgeOptions<T>): {
+    series: ComputedRef<RsTableChartSeries[]>;
+    getSeriesById: (id: string) => RsTableChartSeries | undefined;
+    getSnapshot: () => RsTableAnalyticsSnapshot<T> & {
+        series: RsTableChartSeries[];
+    };
+    viewRows: ComputedRef<T[]>;
+    selectedRows: ComputedRef<T[]>;
+    sourceRows: ComputedRef<T[]>;
+    sourceMode: ComputedRef<import("./useRsTableSelectionSource").RsTableAnalyticsSourceMode>;
+    subscribe: (listener: (snap: RsTableAnalyticsSnapshot<T>) => void) => () => void;
+};
+export type RsTableChartBridgeApi<T extends RsTableRowData> = ReturnType<typeof useRsTableChartBridge<T>>;

package/dist/components/table/src/composables/useRsTableChartBridge.js

@@ -0,0 +1,47 @@
+import { buildTableChartSeriesList } from "../utils/table-chart-utils.js";
+import { useRsTableSelectionSource } from "./useRsTableSelectionSource.js";
+import { computed } from "vue";
+//#region src/components/table/src/composables/useRsTableChartBridge.ts
+/**
+* 表格图表桥：订阅 SelectionSource，产出库无关 chart series。
+*
+* 业务页可：
+* - 把 series 丢给 ECharts option 组装
+* - 或在图表点击时用 point.key 反查行做联动筛选
+*
+* 性能：series 随 sourceRows 浅引用变化重算；defs 建议业务侧稳定引用。
+*/
+function readDefs(defs) {
+	if (Array.isArray(defs)) return defs;
+	return defs.value ?? [];
+}
+/**
+* 选中联动图表桥。
+*
+* @returns selection 源 + series 列表 + getSnapshot
+*/
+function useRsTableChartBridge(options) {
+	const selection = useRsTableSelectionSource({
+		viewRows: options.viewRows,
+		selectedRows: options.selectedRows
+	});
+	const series = computed(() => buildTableChartSeriesList(selection.sourceRows.value, readDefs(options.seriesDefs)));
+	/** 按 id 取单系列，便于模板绑定 */
+	function getSeriesById(id) {
+		return series.value.find((item) => item.id === id);
+	}
+	function getSnapshot() {
+		return {
+			...selection.getSnapshot(),
+			series: series.value
+		};
+	}
+	return {
+		...selection,
+		series,
+		getSeriesById,
+		getSnapshot
+	};
+}
+//#endregion
+export { useRsTableChartBridge };

package/dist/components/table/src/composables/useRsTableColumnLayout.d.ts

@@ -0,0 +1,75 @@
+/**
+ * RsTable 列布局：拉满补宽、渲染列宽、fixed/overflow/前缀 lead 样式。
+ *
+ * 性能约定：
+ * - `emptyFillExtras` 使用冻结空对象恒等，避免无补宽时 renderColumnWidths 复制整表
+ * - 列 style Map 一次遍历构建，模板热路径按 key O(1) 取用
+ */
+import { type ComputedRef, type Ref } from 'vue';
+import { type RsTableColumn, type RsTableRowData } from '../utils/table-utils';
+/** ComputedRef / Ref / getter 均可 */
+type Source<T> = ComputedRef<T> | Ref<T> | (() => T);
+export interface UseRsTableColumnLayoutOptions<T extends RsTableRowData> {
+    displayColumns: Source<RsTableColumn<T>[]>;
+    effectiveColumnWidths: Source<Record<string, number>>;
+    measuredViewportWidth: Source<number>;
+    tableMinWidth: Source<string | undefined>;
+    resizable: Source<boolean>;
+    columnLayout: Source<'auto' | 'fixed'>;
+    useStableColumnWidths: Source<boolean>;
+    isColumnResizing: Source<boolean>;
+    virtualColumnsEnabled: Source<boolean>;
+    scrollX: Source<number | string | undefined>;
+    showRowDragHandle: Source<boolean>;
+    detailExpandable: Source<boolean>;
+    showSelectColumn: Source<boolean>;
+    showEditGutterColumn: Source<boolean>;
+    showIndexColumn: Source<boolean>;
+    showRowStatusColumn: Source<boolean>;
+    resolvedGutterWidth: Source<number>;
+    resolvedIndexWidth: Source<number>;
+    dragColumnOffset: Source<number>;
+    expandColumnOffset: Source<number>;
+    selectColumnOffset: Source<number>;
+    /** 拖拽会话快照列宽；非空表示正在/刚进入 resize paint */
+    resizePaintWidths: Source<Record<string, number> | null>;
+}
+/**
+ * 列布局与样式缓存。
+ */
+export declare function useRsTableColumnLayout<T extends RsTableRowData>(options: UseRsTableColumnLayoutOptions<T>): {
+    EMPTY_FILL_EXTRAS: Record<string, number>;
+    measurePrefixColumnWidth: () => number;
+    resizableTableWidth: ComputedRef<string | undefined>;
+    useFixedColumnLayout: ComputedRef<boolean>;
+    columnFillExtras: ComputedRef<Record<string, number>>;
+    renderColumnWidths: ComputedRef<Record<string, number>>;
+    tableInlineStyle: ComputedRef<{
+        width: string;
+        minWidth: string;
+    } | {
+        width: string;
+        minWidth?: undefined;
+    } | {
+        minWidth: string;
+        width?: undefined;
+    } | undefined>;
+    overflowXEnabled: ComputedRef<boolean>;
+    resolvedDataColumnWidth: (key: string, fallback?: number | string) => number;
+    fixedColumnStyles: ComputedRef<Map<string, import("../utils/table-utils").RsTableFixedCellStyle>>;
+    columnStyleMap: ComputedRef<Map<string, Record<string, string> | undefined>>;
+    columnHeaderStyleMap: ComputedRef<Map<string, Record<string, string> | undefined>>;
+    columnTdClassMap: ComputedRef<Map<string, string[]>>;
+    dragLeadStyle: ComputedRef<Record<string, string>>;
+    expandLeadStyle: ComputedRef<Record<string, string>>;
+    selectLeadStyle: ComputedRef<Record<string, string>>;
+    indexLeadStyle: ComputedRef<Record<string, string>>;
+    gutterLeadStyle: ComputedRef<Record<string, string>>;
+    dragLeadHeaderStyle: ComputedRef<Record<string, string>>;
+    expandLeadHeaderStyle: ComputedRef<Record<string, string>>;
+    selectLeadHeaderStyle: ComputedRef<Record<string, string>>;
+    indexLeadHeaderStyle: ComputedRef<Record<string, string>>;
+    gutterLeadHeaderStyle: ComputedRef<Record<string, string>>;
+};
+export type RsTableColumnLayoutApi<T extends RsTableRowData> = ReturnType<typeof useRsTableColumnLayout<T>>;
+export {};