niuma-ui 1.1.11 → 1.2.0

package/dist/composables/useRsI18n.js

@@ -0,0 +1,25 @@
+import { interpolateRsMessage, resolveRsTranslateArgs } from "../locale/interpolate.js";
+import { localeMap } from "../locale/messages.js";
+import "../locale/types.js";
+import { rsConfigKey } from "./useRsConfig.js";
+import { computed, inject } from "vue";
+//#region src/composables/useRsI18n.ts
+function translate(locale, key, fallbackOrVars, vars) {
+	const parsed = resolveRsTranslateArgs(fallbackOrVars, vars);
+	return interpolateRsMessage(localeMap[locale][key] ?? parsed.fallback ?? key, parsed.vars);
+}
+/** 组件内安全取文案：Provider 内跟随 locale，否则回退 defaultLocale */
+function useRsI18n() {
+	const ctx = inject(rsConfigKey, null);
+	const locale = computed(() => ctx?.locale.value ?? "zh-CN");
+	const t = (key, fallbackOrVars, vars) => translate(locale.value, key, fallbackOrVars, vars);
+	return {
+		t,
+		locale
+	};
+}
+function createTranslator(locale) {
+	return (key, fallbackOrVars, vars) => translate(locale, key, fallbackOrVars, vars);
+}
+//#endregion
+export { createTranslator, useRsI18n };

package/dist/composables/useRsLoadingBar.d.ts

@@ -0,0 +1,13 @@
+import { type InjectionKey, type ShallowRef } from 'vue';
+export type RsLoadingBarApi = {
+    start: () => void;
+    finish: () => void;
+    error: () => void;
+};
+export declare const RS_LOADING_BAR_KEY: InjectionKey<ShallowRef<RsLoadingBarApi | null>>;
+/**
+ * useRsLoadingBar 读取最近的 RsLoadingBar 实例 API。
+ * 调用方须位于 RsLoadingBar 默认插槽的后代树中；
+ * 未挂载或未包裹时返回空操作实现，避免调用方崩溃。
+ */
+export declare function useRsLoadingBar(): RsLoadingBarApi;

package/dist/composables/useRsLoadingBar.js

@@ -0,0 +1,30 @@
+import { inject } from "vue";
+//#region src/composables/useRsLoadingBar.ts
+var RS_LOADING_BAR_KEY = Symbol("rs-loading-bar");
+/**
+* useRsLoadingBar 读取最近的 RsLoadingBar 实例 API。
+* 调用方须位于 RsLoadingBar 默认插槽的后代树中；
+* 未挂载或未包裹时返回空操作实现，避免调用方崩溃。
+*/
+function useRsLoadingBar() {
+	const injected = inject(RS_LOADING_BAR_KEY, null);
+	const noop = {
+		start() {},
+		finish() {},
+		error() {}
+	};
+	if (!injected) return noop;
+	return {
+		start() {
+			injected.value?.start();
+		},
+		finish() {
+			injected.value?.finish();
+		},
+		error() {
+			injected.value?.error();
+		}
+	};
+}
+//#endregion
+export { RS_LOADING_BAR_KEY, useRsLoadingBar };

package/dist/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 '../components/context-menu-utils';
+import type { RsTableRowData } from '../components/table-utils';
+import { type RsTableApi } from '../components/table/rs-table-api';
+import { type RsTableFeatureHost, type RsTableOverlayContribution, type RsTableToolbarItem } from '../components/table/rs-table-feature-host';
+import { type RsTableBuiltinFeatureId, type RsTableFeature } from '../components/table/table-features';
+import type { RsTableAnalyticsSnapshot } from './useRsTableSelectionSource';
+export type { RsTableApi };
+export { RS_TABLE_API_KEY, RS_TABLE_API_VERSION, isRsTableApi } from '../components/table/rs-table-api';
+export { RsTableModuleRegistry, resolveInstanceFeatures } from '../components/table/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/composables/useRsTable.js

@@ -0,0 +1,57 @@
+import { createBuiltinTableFeatures } from "../components/table/table-features.js";
+import { RS_TABLE_API_KEY, RS_TABLE_API_VERSION, createRsTableApi, isRsTableApi } from "../components/table/rs-table-api.js";
+import { createRsTableFeatureHost } from "../components/table/rs-table-feature-host.js";
+import { RsTableModuleRegistry, resolveInstanceFeatures } from "../components/table/rs-table-module-registry.js";
+import { inject, provide } from "vue";
+//#region 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/composables/useRsTableA11y.d.ts

@@ -0,0 +1,35 @@
+/**
+ * RsTable 无障碍基线：region / grid 语义与 loading busy。
+ *
+ * 与 useRsTableGridKeyboard + 单元格 role=gridcell 配合，形成可漫游网格。
+ * tabindex 放在 role=grid 的 table 上（复合控件可聚焦），勿放在 region 壳层。
+ */
+import { type ComputedRef, type Ref } from 'vue';
+export interface UseRsTableA11yOptions {
+    /** 显式无障碍名称；空则回退 defaultLabel */
+    ariaLabel: () => string | undefined;
+    defaultLabel: () => string;
+    loading: () => boolean;
+    /** 业务行数（view / dataRows） */
+    rowCount: Ref<number> | ComputedRef<number> | (() => number);
+    /** 可见数据列数 */
+    colCount: Ref<number> | ComputedRef<number> | (() => number);
+}
+/**
+ * 壳层 / table 元素无障碍属性。
+ */
+export declare function useRsTableA11y(options: UseRsTableA11yOptions): {
+    resolvedLabel: ComputedRef<string>;
+    shellA11y: ComputedRef<{
+        role: "region";
+        'aria-label': string;
+        'aria-busy': boolean | undefined;
+    }>;
+    tableA11y: ComputedRef<{
+        role: "grid";
+        tabindex: number;
+        'aria-rowcount': number;
+        'aria-colcount': number;
+        'aria-label': string;
+    }>;
+};

package/dist/composables/useRsTableA11y.js

@@ -0,0 +1,34 @@
+import { computed } from "vue";
+//#region 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/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 '../components/table-utils';
+import { type RsTableChartSeries, type RsTableChartSeriesDef } from '../components/table/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/composables/useRsTableChartBridge.js

@@ -0,0 +1,47 @@
+import { buildTableChartSeriesList } from "../components/table/table-chart-utils.js";
+import { useRsTableSelectionSource } from "./useRsTableSelectionSource.js";
+import { computed } from "vue";
+//#region 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/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 '../components/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("../components/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 {};

package/dist/composables/useRsTableColumnLayout.js

@@ -0,0 +1,250 @@
+import { fixedCellStyle, parseColumnWidth, resolveColumnStyle, resolveFixedColumnStyles } from "../components/table-utils.js";
+import { RS_TABLE_PREFIX_COL_WIDTH, measureRsTablePrefixWidth } from "./useRsTableColumnVirtual.js";
+import { computed } from "vue";
+//#region src/composables/useRsTableColumnLayout.ts
+/**
+* RsTable 列布局：拉满补宽、渲染列宽、fixed/overflow/前缀 lead 样式。
+*
+* 性能约定：
+* - `emptyFillExtras` 使用冻结空对象恒等，避免无补宽时 renderColumnWidths 复制整表
+* - 列 style Map 一次遍历构建，模板热路径按 key O(1) 取用
+*/
+function read(source) {
+	if (typeof source === "function") return source();
+	return source.value;
+}
+/** 无补宽时的共享空对象（恒等比较，避免无意义拷贝） */
+var EMPTY_FILL_EXTRAS = Object.freeze({});
+/**
+* 列布局与样式缓存。
+*/
+function useRsTableColumnLayout(options) {
+	const PREFIX = RS_TABLE_PREFIX_COL_WIDTH;
+	/** 前缀列总宽（不含 status；status 在部分合计里另加） */
+	function measurePrefixColumnWidth() {
+		return measureRsTablePrefixWidth({
+			showRowDragHandle: read(options.showRowDragHandle),
+			detailExpandable: read(options.detailExpandable),
+			showSelectColumn: read(options.showSelectColumn),
+			showEditGutterColumn: read(options.showEditGutterColumn),
+			showIndexColumn: read(options.showIndexColumn),
+			gutterWidth: read(options.resolvedGutterWidth),
+			indexWidth: read(options.resolvedIndexWidth)
+		});
+	}
+	/** resizable 且列宽稳定时，或拖拽会话中：表格内容最小宽度 = 各列宽度之和 */
+	const resizableTableWidth = computed(() => {
+		if (!read(options.resizable)) return void 0;
+		if (!read(options.resizePaintWidths) && read(options.columnLayout) === "auto" && !read(options.useStableColumnWidths)) return;
+		let sum = measurePrefixColumnWidth();
+		const widths = read(options.effectiveColumnWidths);
+		for (const col of read(options.displayColumns)) sum += widths[col.key] ?? parseColumnWidth(col.width ?? col.minWidth);
+		return `${sum}px`;
+	});
+	const useFixedColumnLayout = computed(() => read(options.useStableColumnWidths) || read(options.isColumnResizing));
+	/**
+	* 列总宽不足视口时，把剩余像素均分到数据列（前缀列不动）。
+	* 列虚拟开启时不做拉满，避免与横向切片打架。
+	*/
+	const columnFillExtras = computed(() => {
+		if (read(options.isColumnResizing)) return EMPTY_FILL_EXTRAS;
+		if (!useFixedColumnLayout.value) return EMPTY_FILL_EXTRAS;
+		if (read(options.virtualColumnsEnabled)) return EMPTY_FILL_EXTRAS;
+		const viewportW = read(options.measuredViewportWidth);
+		if (viewportW <= 0) return EMPTY_FILL_EXTRAS;
+		const cols = read(options.displayColumns);
+		if (cols.length === 0) return EMPTY_FILL_EXTRAS;
+		let sum = measurePrefixColumnWidth();
+		if (read(options.showRowStatusColumn)) sum += PREFIX.status;
+		const widths = read(options.effectiveColumnWidths);
+		for (const col of cols) sum += widths[col.key] ?? parseColumnWidth(col.width ?? col.minWidth);
+		const excess = Math.floor(viewportW - sum) - 1;
+		if (excess <= 0) return EMPTY_FILL_EXTRAS;
+		const extras = {};
+		const base = Math.floor(excess / cols.length);
+		let rem = excess - base * cols.length;
+		for (const col of cols) {
+			extras[col.key] = base + (rem > 0 ? 1 : 0);
+			if (rem > 0) rem -= 1;
+		}
+		return extras;
+	});
+	/** 渲染用列宽 = 持久化/拖拽列宽 + 拉满补宽；无补宽时直接返回 base 引用 */
+	const renderColumnWidths = computed(() => {
+		const extras = columnFillExtras.value;
+		const base = read(options.effectiveColumnWidths);
+		if (extras === EMPTY_FILL_EXTRAS) return base;
+		const next = { ...base };
+		for (const col of read(options.displayColumns)) {
+			const extra = extras[col.key];
+			if (!extra) continue;
+			const cur = next[col.key] ?? parseColumnWidth(col.width ?? col.minWidth);
+			next[col.key] = cur + extra;
+		}
+		return next;
+	});
+	const tableInlineStyle = computed(() => {
+		if (read(options.isColumnResizing)) return void 0;
+		if (read(options.resizable)) {
+			if (read(options.columnLayout) === "auto" && !read(options.useStableColumnWidths)) {
+				const minW = read(options.tableMinWidth);
+				return minW ? {
+					width: "100%",
+					minWidth: minW
+				} : { width: "100%" };
+			}
+			const width = resizableTableWidth.value;
+			if (!width) return void 0;
+			return {
+				width: "100%",
+				minWidth: read(options.tableMinWidth) ?? width
+			};
+		}
+		const minW = read(options.tableMinWidth);
+		return minW ? { minWidth: minW } : void 0;
+	});
+	function estimateRequiredTableWidth() {
+		let sum = measurePrefixColumnWidth();
+		if (read(options.showRowStatusColumn)) sum += PREFIX.status;
+		const widths = read(options.effectiveColumnWidths);
+		for (const col of read(options.displayColumns)) {
+			const stored = widths[col.key];
+			if (typeof stored === "number") {
+				sum += stored;
+				continue;
+			}
+			if (typeof col.width === "number") {
+				sum += col.width;
+				continue;
+			}
+			if (col.minWidth !== void 0) sum += typeof col.minWidth === "number" ? col.minWidth : parseColumnWidth(col.minWidth, 0);
+		}
+		return sum;
+	}
+	/** 仅当列宽确需超过容器时开启横向滚动 */
+	const overflowXEnabled = computed(() => {
+		if (read(options.virtualColumnsEnabled)) return true;
+		const scrollX = read(options.scrollX);
+		if (scrollX != null && scrollX !== "") return true;
+		const viewportW = read(options.measuredViewportWidth);
+		if (viewportW <= 0) return false;
+		if (useFixedColumnLayout.value) {
+			const raw = resizableTableWidth.value;
+			const sum = raw ? Number.parseInt(raw, 10) : estimateRequiredTableWidth();
+			return Number.isFinite(sum) && sum > viewportW;
+		}
+		return estimateRequiredTableWidth() > viewportW;
+	});
+	function resolvedDataColumnWidth(key, fallback) {
+		const stored = renderColumnWidths.value[key];
+		if (typeof stored === "number") return stored;
+		return parseColumnWidth(fallback);
+	}
+	const fixedColumnStyles = computed(() => resolveFixedColumnStyles(read(options.displayColumns), renderColumnWidths.value, {
+		selectable: read(options.showSelectColumn),
+		showIndex: read(options.showIndexColumn),
+		showEditGutter: read(options.showEditGutterColumn),
+		gutterWidth: read(options.resolvedGutterWidth),
+		indexWidth: read(options.resolvedIndexWidth),
+		expandable: read(options.detailExpandable),
+		rowDraggable: read(options.showRowDragHandle)
+	}));
+	/**
+	* 一次遍历同时构建 body/header 列样式 Map，避免两遍 resolveColumnStyle。
+	*/
+	const columnStyleMaps = computed(() => {
+		const body = /* @__PURE__ */ new Map();
+		const header = /* @__PURE__ */ new Map();
+		const widths = renderColumnWidths.value;
+		const fixed = fixedColumnStyles.value;
+		for (const col of read(options.displayColumns)) {
+			const base = resolveColumnStyle(col, widths) ?? {};
+			const bodyFixed = fixedCellStyle(fixed.get(col.key));
+			const headerFixed = fixedCellStyle(fixed.get(col.key), { header: true });
+			let bodyMerged;
+			let headerMerged;
+			if (bodyFixed) bodyMerged = {
+				...base,
+				...bodyFixed
+			};
+			else if (Object.keys(base).length) bodyMerged = base;
+			if (headerFixed) headerMerged = {
+				...base,
+				...headerFixed
+			};
+			else if (Object.keys(base).length) headerMerged = base;
+			body.set(col.key, bodyMerged);
+			header.set(col.key, headerMerged);
+		}
+		return {
+			body,
+			header
+		};
+	});
+	return {
+		EMPTY_FILL_EXTRAS,
+		measurePrefixColumnWidth,
+		resizableTableWidth,
+		useFixedColumnLayout,
+		columnFillExtras,
+		renderColumnWidths,
+		tableInlineStyle,
+		overflowXEnabled,
+		resolvedDataColumnWidth,
+		fixedColumnStyles,
+		columnStyleMap: computed(() => columnStyleMaps.value.body),
+		columnHeaderStyleMap: computed(() => columnStyleMaps.value.header),
+		columnTdClassMap: computed(() => {
+			const map = /* @__PURE__ */ new Map();
+			for (const col of read(options.displayColumns)) {
+				const classes = [`rs-table__cell--${col.align ?? "left"}`];
+				if (col.ellipsis) classes.push("rs-table__td--ellipsis");
+				if (col.fixed) classes.push("rs-table__cell--fixed");
+				map.set(col.key, classes);
+			}
+			return map;
+		}),
+		dragLeadStyle: computed(() => fixedCellStyle({
+			fixed: "left",
+			left: 0
+		}) ?? {}),
+		expandLeadStyle: computed(() => fixedCellStyle({
+			fixed: "left",
+			left: read(options.dragColumnOffset)
+		}) ?? {}),
+		selectLeadStyle: computed(() => fixedCellStyle({
+			fixed: "left",
+			left: read(options.expandColumnOffset)
+		}) ?? {}),
+		indexLeadStyle: computed(() => fixedCellStyle({
+			fixed: "left",
+			left: read(options.selectColumnOffset)
+		}) ?? {}),
+		gutterLeadStyle: computed(() => fixedCellStyle({
+			fixed: "left",
+			left: read(options.selectColumnOffset)
+		}) ?? {}),
+		dragLeadHeaderStyle: computed(() => fixedCellStyle({
+			fixed: "left",
+			left: 0
+		}, { header: true }) ?? {}),
+		expandLeadHeaderStyle: computed(() => fixedCellStyle({
+			fixed: "left",
+			left: read(options.dragColumnOffset)
+		}, { header: true }) ?? {}),
+		selectLeadHeaderStyle: computed(() => fixedCellStyle({
+			fixed: "left",
+			left: read(options.expandColumnOffset)
+		}, { header: true }) ?? {}),
+		indexLeadHeaderStyle: computed(() => fixedCellStyle({
+			fixed: "left",
+			left: read(options.selectColumnOffset)
+		}, { header: true }) ?? {}),
+		gutterLeadHeaderStyle: computed(() => fixedCellStyle({
+			fixed: "left",
+			left: read(options.selectColumnOffset)
+		}, { header: true }) ?? {})
+	};
+}
+//#endregion
+export { useRsTableColumnLayout };