niuma-ui 1.1.11 → 1.2.0

package/dist/composables/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 '../components/table-utils';
+import type { RsTableCellEditFocusMode, RsTableCellEditTrigger } from '../components/table/table-edit-utils';
+import type { RsTableBodyLabels, RsTableHeaderLabels } from '../components/table/rs-table-view-context';
+import type { useTableEdit } from './useTableEdit';
+import { type RsTableViewProvideHandlers, type RsTableViewProvideSources } from './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/composables/bindRsTableViewContext.js

@@ -0,0 +1,104 @@
+import { useRsTableViewProvide } from "./useRsTableViewProvide.js";
+//#region src/composables/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/composables/createRsDialog.d.ts

@@ -0,0 +1,77 @@
+import type { RsConfirmOptions } from '../components/dialog-utils';
+import type { RsDialogBeforeClose, RsDialogCloseReason, RsDialogWidth } from '../components/dialog-utils';
+import type { RsFeedbackTone } from '../components/overlay-utils';
+import { type RsLocale } from '../locale/types';
+import type { RsThemeMode } from '../theme/types';
+export type RsConfirmResult = boolean;
+export type RsConfirmInput = RsConfirmOptions | string;
+export interface RsDialogOpenOptions {
+    title?: string;
+    subtitle?: string;
+    description?: string;
+    width?: RsDialogWidth;
+    tone?: RsFeedbackTone;
+    /**
+     * 布局。默认 window（工作窗）。
+     * form：居中轻量表单/说明；confirm 仅作历史兼容（等同 form）。
+     * 确认/提示请用 rsConfirm / RsConfirmDialog。
+     */
+    layout?: 'window' | 'form' | 'confirm';
+    showOverlay?: boolean;
+    /** 遮罩不透明度 0–1 */
+    overlayOpacity?: number;
+    /** 遮罩模糊；number 为 px */
+    overlayBlur?: number | string;
+    showClose?: boolean;
+    closeOnOverlayClick?: boolean;
+    closeOnEsc?: boolean;
+    showFooter?: boolean;
+    showCancel?: boolean;
+    showConfirm?: boolean;
+    cancelText?: string;
+    confirmText?: string;
+    confirmVariant?: 'primary' | 'danger';
+    autoCloseOnConfirm?: boolean;
+    beforeClose?: RsDialogBeforeClose;
+    teleportTo?: string | HTMLElement;
+    /** 默认插槽对应 #body 的渲染函数 */
+    body?: () => unknown;
+    footer?: () => unknown;
+    onConfirm?: () => void | Promise<void>;
+    onCancel?: () => void;
+    onAfterClose?: (reason: RsDialogCloseReason) => void;
+    /** 命令式挂载时覆盖主题；默认读 document data-rs-theme */
+    theme?: RsThemeMode;
+    /** 命令式挂载时覆盖语言；默认读 document data-rs-locale */
+    locale?: RsLocale;
+}
+export interface RsDialogHandle {
+    close: (reason?: RsDialogCloseReason) => Promise<boolean>;
+    destroy: () => void;
+}
+/** tone 快捷方法：可传完整选项或纯文案（作为 description） */
+export interface RsConfirmApi {
+    (options?: RsConfirmOptions): Promise<RsConfirmResult>;
+    warning: (options?: RsConfirmInput) => Promise<RsConfirmResult>;
+    danger: (options?: RsConfirmInput) => Promise<RsConfirmResult>;
+    info: (options?: RsConfirmInput) => Promise<RsConfirmResult>;
+    success: (options?: RsConfirmInput) => Promise<RsConfirmResult>;
+    error: (options?: RsConfirmInput) => Promise<RsConfirmResult>;
+    confirm: (options?: RsConfirmInput) => Promise<RsConfirmResult>;
+}
+/** 立即销毁所有命令式对话框宿主。测试 afterEach 使用，避免拆 DOM 后再延迟 unmount。 */
+export declare function destroyAllRsDialogHosts(): void;
+/**
+ * 命令式确认 / 提示 API。
+ * - rsConfirm(options) 基础调用
+ * - rsConfirm.warning / .danger / .confirm 双按钮确认
+ * - rsConfirm.info / .success / .error 默认单按钮提示（showCancel: false）
+ */
+export declare const rsConfirm: RsConfirmApi;
+/**
+ * 命令式打开 RsDialog；适合临时表单/说明层。
+ * 确认/危险提示请用 rsConfirm，不要传 layout: 'confirm'。
+ * 轻量表单/说明请用 layout: 'form'。
+ * 复杂长期状态仍建议声明式使用组件。
+ */
+export declare function openRsDialog(options?: RsDialogOpenOptions): RsDialogHandle;

package/dist/composables/createRsDialog.js

@@ -0,0 +1,263 @@
+import { defaultLocale } from "../locale/types.js";
+import RsConfigProvider_default from "../components/RsConfigProvider.js";
+import RsDialog_default from "../components/RsDialog.js";
+import RsConfirmDialog_default from "../components/RsConfirmDialog.js";
+import { createApp, h, ref } from "vue";
+//#region src/composables/createRsDialog.ts
+function readDomTheme() {
+	if (typeof document === "undefined") return "light";
+	return document.documentElement.getAttribute("data-rs-theme") === "dark" ? "dark" : "light";
+}
+function readDomLocale() {
+	if (typeof document === "undefined") return defaultLocale;
+	const value = document.documentElement.getAttribute("data-rs-locale");
+	return value === "en-US" || value === "zh-CN" ? value : defaultLocale;
+}
+/** 命令式实例的销毁函数；测试收尾用 destroyAllRsDialogHosts 走正规 unmount。 */
+var liveHosts = /* @__PURE__ */ new Set();
+function mountHost(render, config) {
+	const container = document.createElement("div");
+	document.body.appendChild(container);
+	const theme = config?.theme ?? readDomTheme();
+	const locale = config?.locale ?? readDomLocale();
+	const app = createApp({ setup() {
+		return () => h(RsConfigProvider_default, {
+			theme,
+			locale,
+			themeScope: "local"
+		}, { default: () => render() });
+	} });
+	app.mount(container);
+	let destroyed = false;
+	const destroy = () => {
+		if (destroyed) return;
+		destroyed = true;
+		liveHosts.delete(destroy);
+		try {
+			app.unmount();
+		} catch {}
+		container.remove();
+	};
+	liveHosts.add(destroy);
+	return {
+		app,
+		container,
+		destroy
+	};
+}
+var pendingDestroyTimers = /* @__PURE__ */ new Set();
+function scheduleHostDestroy(destroy) {
+	const timer = window.setTimeout(() => {
+		pendingDestroyTimers.delete(timer);
+		destroy();
+	}, 200);
+	pendingDestroyTimers.add(timer);
+	return timer;
+}
+function clearHostDestroyTimer(timer) {
+	if (timer == null) return;
+	clearTimeout(timer);
+	pendingDestroyTimers.delete(timer);
+}
+function normalizeConfirmInput(options, defaults) {
+	if (typeof options === "string") return {
+		...defaults,
+		description: options
+	};
+	return {
+		...defaults,
+		...options ?? {}
+	};
+}
+/**
+* 命令式确认框（基于 RsConfirmDialog）。
+* resolve(true) 为确认，resolve(false) 为取消/关闭。
+* 若传入 onConfirm 且返回 Promise，确认期间自动 loading，成功后关闭。
+*/
+function rsConfirmCore(options = {}) {
+	return new Promise((resolve) => {
+		const open = ref(true);
+		const loading = ref(options.confirmLoading ?? false);
+		let settled = false;
+		let confirmed = false;
+		let closeTimer;
+		const hasAsyncConfirm = typeof options.onConfirm === "function";
+		let unmountHost = () => {};
+		const destroy = () => {
+			clearHostDestroyTimer(closeTimer);
+			closeTimer = void 0;
+			unmountHost();
+		};
+		const settle = (value) => {
+			if (settled) return;
+			settled = true;
+			open.value = false;
+			if (!value) options.onCancel?.();
+			closeTimer = scheduleHostDestroy(destroy);
+			resolve(value);
+		};
+		unmountHost = mountHost(() => h(RsConfirmDialog_default, {
+			open: open.value,
+			"onUpdate:open": (value) => {
+				open.value = value;
+				if (!value) queueMicrotask(() => settle(confirmed));
+			},
+			title: options.title,
+			subtitle: options.subtitle,
+			description: options.description,
+			tone: options.tone,
+			icon: options.icon,
+			width: options.width,
+			confirmText: options.confirmText,
+			cancelText: options.cancelText,
+			confirmVariant: options.confirmVariant,
+			showCancel: options.showCancel,
+			confirmLoading: loading.value,
+			beforeClose: options.beforeClose,
+			autoCloseOnConfirm: !hasAsyncConfirm,
+			showOverlay: options.showOverlay ?? true,
+			overlayOpacity: options.overlayOpacity,
+			overlayBlur: options.overlayBlur,
+			teleportTo: options.teleportTo === false ? false : options.teleportTo,
+			onConfirm: () => {
+				if (!hasAsyncConfirm) {
+					confirmed = true;
+					return;
+				}
+				loading.value = true;
+				Promise.resolve().then(() => options.onConfirm?.()).then(() => {
+					confirmed = true;
+					settle(true);
+				}).catch(() => {
+					loading.value = false;
+				});
+			},
+			onCancel: () => {
+				confirmed = false;
+			}
+		}, options.extra ? { extra: () => options.extra?.() } : void 0), {
+			theme: options.theme,
+			locale: options.locale
+		}).destroy;
+	});
+}
+/**
+* 命令式确认 / 提示 API。
+* - rsConfirm(options) 基础调用
+* - rsConfirm.warning / .danger / .confirm 双按钮确认
+* - rsConfirm.info / .success / .error 默认单按钮提示（showCancel: false）
+*/
+var rsConfirm = Object.assign(rsConfirmCore, {
+	warning: (options) => rsConfirmCore(normalizeConfirmInput(options, {
+		tone: "danger",
+		confirmVariant: "danger",
+		showOverlay: true
+	})),
+	danger: (options) => rsConfirmCore(normalizeConfirmInput(options, {
+		tone: "danger",
+		confirmVariant: "danger",
+		showOverlay: true
+	})),
+	info: (options) => rsConfirmCore(normalizeConfirmInput(options, {
+		tone: "info",
+		confirmVariant: "primary",
+		showCancel: false,
+		showOverlay: true
+	})),
+	success: (options) => rsConfirmCore(normalizeConfirmInput(options, {
+		tone: "success",
+		confirmVariant: "primary",
+		showCancel: false,
+		showOverlay: true
+	})),
+	error: (options) => rsConfirmCore(normalizeConfirmInput(options, {
+		tone: "danger",
+		confirmVariant: "danger",
+		showCancel: false,
+		showOverlay: true
+	})),
+	confirm: (options) => rsConfirmCore(normalizeConfirmInput(options, {
+		tone: "warning",
+		confirmVariant: "primary",
+		showOverlay: true
+	}))
+});
+/**
+* 命令式打开 RsDialog；适合临时表单/说明层。
+* 确认/危险提示请用 rsConfirm，不要传 layout: 'confirm'。
+* 轻量表单/说明请用 layout: 'form'。
+* 复杂长期状态仍建议声明式使用组件。
+*/
+function openRsDialog(options = {}) {
+	const open = ref(true);
+	let destroyed = false;
+	let closeTimer;
+	let dialogExpose = null;
+	const layout = options.layout ?? "window";
+	const { destroy: unmount } = mountHost(() => h(RsDialog_default, {
+		ref: (instance) => {
+			dialogExpose = instance;
+		},
+		open: open.value,
+		"onUpdate:open": (value) => {
+			open.value = value;
+			if (!value && !destroyed) closeTimer = scheduleHostDestroy(destroy);
+		},
+		title: options.title,
+		description: [options.subtitle, options.description].filter(Boolean).join("\n\n") || options.description,
+		width: options.width ?? "md",
+		tone: options.tone,
+		layout,
+		resizable: layout === "window",
+		fullscreenable: layout === "window",
+		showOverlay: options.showOverlay ?? true,
+		overlayOpacity: options.overlayOpacity,
+		overlayBlur: options.overlayBlur,
+		showClose: options.showClose,
+		closeOnOverlayClick: options.closeOnOverlayClick,
+		closeOnEsc: options.closeOnEsc,
+		showFooter: options.showFooter ?? true,
+		showCancel: options.showCancel,
+		showConfirm: options.showConfirm,
+		cancelText: options.cancelText,
+		confirmText: options.confirmText,
+		confirmVariant: options.confirmVariant,
+		autoCloseOnConfirm: options.autoCloseOnConfirm ?? true,
+		beforeClose: options.beforeClose,
+		teleportTo: options.teleportTo,
+		deferBodyMount: false,
+		onConfirm: () => {
+			options.onConfirm?.();
+		},
+		onCancel: () => {
+			options.onCancel?.();
+		},
+		onAfterClose: (reason) => {
+			options.onAfterClose?.(reason);
+		}
+	}, {
+		body: options.body,
+		footer: options.footer
+	}), {
+		theme: options.theme,
+		locale: options.locale
+	});
+	function destroy() {
+		if (destroyed) return;
+		destroyed = true;
+		clearHostDestroyTimer(closeTimer);
+		closeTimer = void 0;
+		unmount();
+	}
+	return {
+		async close(reason = "programmatic") {
+			if (destroyed) return false;
+			if (dialogExpose?.close) return dialogExpose.close(reason);
+			open.value = false;
+			return true;
+		},
+		destroy
+	};
+}
+//#endregion
+export { openRsDialog, rsConfirm };

package/dist/composables/createRsTableEditEmitBridge.d.ts

@@ -0,0 +1,16 @@
+/**
+ * 将 Vue emit 适配为 useRsTableEditActions 所需的 edit emit 袋。
+ */
+import type { EmitFn } from 'vue';
+import type { RsTableEmits } from '../components/table/rs-table-props';
+import type { RsTableRowData } from '../components/table-utils';
+import type { UseRsTableEditActionsOptions } from './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/composables/createRsTableEditEmitBridge.js

@@ -0,0 +1,25 @@
+//#region src/composables/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/composables/useClickOutside.d.ts

@@ -0,0 +1,2 @@
+import { type Ref } from 'vue';
+export declare function useClickOutside(target: Ref<HTMLElement | null>, handler: () => void): void;

package/dist/composables/useRsConfig.d.ts

@@ -0,0 +1,26 @@
+import { type InjectionKey, type Ref } from 'vue';
+import { type RsTranslateFn } from '../locale/interpolate';
+import { type RsLocale } from '../locale/types';
+import type { RsComponentSize, RsRadius, RsThemeMode } from '../theme/types';
+export interface RsConfigContext {
+    theme: Ref<RsThemeMode>;
+    locale: Ref<RsLocale>;
+    /** 全局默认控件尺寸（ssm / sm / md / lg）。 */
+    controlSize: Ref<RsComponentSize>;
+    /**
+     * 全局默认圆角。未设置时各组件保留自身默认档（如按钮 full、输入 sm）。
+     * 设为 `none` 可整站直角风格。
+     */
+    controlRadius: Ref<RsRadius | undefined>;
+    setTheme: (mode: RsThemeMode) => void;
+    setLocale: (locale: RsLocale) => void;
+    setControlSize: (size: RsComponentSize) => void;
+    setControlRadius: (radius: RsRadius | undefined) => void;
+    t: RsTranslateFn;
+}
+export declare const rsConfigKey: InjectionKey<RsConfigContext>;
+export declare function useRsConfig(): RsConfigContext;
+/** 可选读取；组件在 Provider 外也可独立使用。 */
+export declare function useRsConfigOptional(): RsConfigContext | null;
+export declare function createRsConfigState(initialTheme?: RsThemeMode, initialLocale?: RsLocale, initialControlSize?: RsComponentSize, initialControlRadius?: RsRadius): RsConfigContext;
+export declare function provideRsConfig(ctx: RsConfigContext): void;

package/dist/composables/useRsConfig.js

@@ -0,0 +1,55 @@
+import { interpolateRsMessage, resolveRsTranslateArgs } from "../locale/interpolate.js";
+import { localeMap } from "../locale/messages.js";
+import { defaultLocale } from "../locale/types.js";
+import { inject, provide, ref } from "vue";
+//#region src/composables/useRsConfig.ts
+var rsConfigKey = Symbol("rs-config");
+function useRsConfig() {
+	const ctx = inject(rsConfigKey);
+	if (!ctx) throw new Error("useRsConfig() must be used within RsConfigProvider");
+	return ctx;
+}
+/** 可选读取；组件在 Provider 外也可独立使用。 */
+function useRsConfigOptional() {
+	return inject(rsConfigKey, null);
+}
+function createRsConfigState(initialTheme = "light", initialLocale = defaultLocale, initialControlSize = "md", initialControlRadius) {
+	const theme = ref(initialTheme);
+	const locale = ref(initialLocale);
+	const controlSize = ref(initialControlSize);
+	const controlRadius = ref(initialControlRadius);
+	function setTheme(mode) {
+		theme.value = mode;
+	}
+	function setLocale(next) {
+		locale.value = next;
+		if (typeof document !== "undefined") document.documentElement.setAttribute("data-rs-locale", next);
+	}
+	function setControlSize(size) {
+		controlSize.value = size;
+	}
+	function setControlRadius(radius) {
+		controlRadius.value = radius;
+	}
+	const t = (key, fallbackOrVars, vars) => {
+		const parsed = resolveRsTranslateArgs(fallbackOrVars, vars);
+		return interpolateRsMessage(localeMap[locale.value][key] ?? parsed.fallback ?? key, parsed.vars);
+	};
+	if (typeof document !== "undefined") document.documentElement.setAttribute("data-rs-locale", locale.value);
+	return {
+		theme,
+		locale,
+		controlSize,
+		controlRadius,
+		setTheme,
+		setLocale,
+		setControlSize,
+		setControlRadius,
+		t
+	};
+}
+function provideRsConfig(ctx) {
+	provide(rsConfigKey, ctx);
+}
+//#endregion
+export { createRsConfigState, provideRsConfig, rsConfigKey, useRsConfig, useRsConfigOptional };

package/dist/composables/useRsI18n.d.ts

@@ -0,0 +1,9 @@
+import { type RsI18nVars, type RsTranslateFn } from '../locale/interpolate';
+import { type RsLocale } from '../locale/types';
+export type { RsI18nVars, RsTranslateFn };
+/** 组件内安全取文案：Provider 内跟随 locale，否则回退 defaultLocale */
+export declare function useRsI18n(): {
+    t: RsTranslateFn;
+    locale: import("vue").ComputedRef<RsLocale>;
+};
+export declare function createTranslator(locale: RsLocale): RsTranslateFn;