niuma-ui 1.1.12 → 1.2.0

package/dist/components/date-validation.js

@@ -0,0 +1,46 @@
+import { parseRsDateTimeDayjs, parseRsDayjs } from "../lib/rs-dayjs.js";
+//#region src/components/date-validation.ts
+function validateDateValue(value, rules = {}) {
+	if (!value) return rules.required ? {
+		valid: false,
+		error: "required"
+	} : { valid: true };
+	const parsed = parseRsDayjs(value);
+	if (!parsed) return {
+		valid: false,
+		error: "format"
+	};
+	const canonical = parsed.format("YYYY-MM-DD");
+	if (rules.min && canonical < rules.min) return {
+		valid: false,
+		error: "min"
+	};
+	if (rules.max && canonical > rules.max) return {
+		valid: false,
+		error: "max"
+	};
+	return { valid: true };
+}
+function validateDateTimeValue(value, rules = {}) {
+	if (!value) return rules.required ? {
+		valid: false,
+		error: "required"
+	} : { valid: true };
+	const parsed = parseRsDateTimeDayjs(value);
+	if (!parsed) return {
+		valid: false,
+		error: "format"
+	};
+	const canonical = parsed.format("YYYY-MM-DD HH:mm:ss");
+	if (rules.min && canonical < rules.min) return {
+		valid: false,
+		error: "min"
+	};
+	if (rules.max && canonical > rules.max) return {
+		valid: false,
+		error: "max"
+	};
+	return { valid: true };
+}
+//#endregion
+export { validateDateTimeValue, validateDateValue };

package/dist/components/descriptions-utils.d.ts

@@ -0,0 +1,18 @@
+import type { InjectionKey } from 'vue';
+import type { RsComponentSize } from '../theme/types';
+/** Descriptions 尺寸与全局控件尺寸对齐：ssm / sm / md / lg */
+export type RsDescriptionsSize = RsComponentSize;
+export type RsDescriptionsLabelPlacement = 'left' | 'top';
+export type RsDescriptionsItem = {
+    label: string;
+    value?: string | number | null;
+    span?: number;
+    key?: string | number;
+};
+export type RsDescriptionsContext = {
+    labelPlacement: RsDescriptionsLabelPlacement;
+    bordered: boolean;
+    size: RsDescriptionsSize;
+    columns: number;
+};
+export declare const RS_DESCRIPTIONS_KEY: InjectionKey<RsDescriptionsContext>;

package/dist/components/descriptions-utils.js

@@ -0,0 +1,4 @@
+//#region src/components/descriptions-utils.ts
+var RS_DESCRIPTIONS_KEY = Symbol("rs-descriptions");
+//#endregion
+export { RS_DESCRIPTIONS_KEY };

package/dist/components/dialog-utils.d.ts

@@ -0,0 +1,95 @@
+import type { Component } from 'vue';
+import type { RsLocale } from '../locale/types';
+import type { RsThemeMode } from '../theme/types';
+import type { RsFeedbackTone } from './overlay-utils';
+/** 宽度预设（与历史 sm/md/lg 一致） */
+export type RsDialogWidthPreset = 'sm' | 'md' | 'lg';
+/**
+ * 对话框宽度：预设或自定义（number 按 px；string 为 CSS 长度，如 `40rem` / `60%`）。
+ * window 布局会在打开时把 px / rem / % 折成像素再居中（% 相对视口扣除 inset）；
+ * form / confirm 布局仍把自定义宽度当作 CSS 写入。
+ */
+export type RsDialogWidth = RsDialogWidthPreset | number | string;
+/** window：可缩放工作窗；form：居中轻量表单/说明；confirm：历史别名，等同 form */
+export type RsDialogLayout = 'window' | 'form' | 'confirm';
+/** 关闭来源，供 beforeClose / afterClose 区分 */
+export type RsDialogCloseReason = 'close' | 'overlay' | 'escape' | 'cancel' | 'confirm' | 'programmatic';
+/**
+ * 关闭前钩子：返回 false 阻止关闭；支持异步。
+ * 未提供或返回 void/true 时允许关闭。
+ */
+export type RsDialogBeforeClose = (reason: RsDialogCloseReason) => boolean | void | Promise<boolean | void>;
+export declare function isRsDialogWidthPreset(width: RsDialogWidth): width is RsDialogWidthPreset;
+/** 将自定义宽度规范为 CSS 长度 */
+export declare function resolveRsDialogCssWidth(width: RsDialogWidth): string | undefined;
+/**
+ * 将自定义宽度折成 px，供 window 布局计算 bounds / 居中。
+ * 支持 number、`px`、`rem`、`%`（相对视口可用宽度）；预设与无法解析的单位返回 undefined。
+ */
+export declare function resolveRsDialogWidthPx(width: RsDialogWidth, viewportWidth?: number): number | undefined;
+export declare function runRsDialogBeforeClose(beforeClose: RsDialogBeforeClose | undefined, reason: RsDialogCloseReason): Promise<boolean>;
+/** 确认框关闭来源，供 beforeClose 区分 */
+export type RsConfirmCloseReason = 'confirm' | 'cancel' | 'escape' | 'programmatic';
+/**
+ * 确认框关闭前钩子：返回 false 阻止关闭；支持异步。
+ * 未提供或返回 void/true 时允许关闭。
+ */
+export type RsConfirmBeforeClose = (reason: RsConfirmCloseReason) => boolean | void | Promise<boolean | void>;
+export interface RsConfirmOptions {
+    title?: string;
+    /** 次要说明（标题与正文之间，对应业务侧常见 subtitle） */
+    subtitle?: string;
+    description?: string;
+    tone?: RsFeedbackTone;
+    /** 自定义图标组件；不传则使用默认 "!" */
+    icon?: Component;
+    /** 宽度：预设 sm/md/lg，或 number(px) / CSS 长度；默认保持 28rem */
+    width?: RsDialogWidth;
+    confirmText?: string;
+    cancelText?: string;
+    confirmVariant?: 'primary' | 'danger';
+    /** 是否显示取消按钮；false 时为单按钮提示（info/success/error） */
+    showCancel?: boolean;
+    /** 受控加载态；若同时提供 onConfirm，命令式 API 会在执行期间自动置 true */
+    confirmLoading?: boolean;
+    /**
+     * 确认回调。返回 Promise 时对话框保持打开并进入 loading，
+     * resolve 后关闭并 resolve(true)；reject 则取消 loading 并保持打开。
+     */
+    onConfirm?: () => void | Promise<void>;
+    /** 取消/关闭时回调（不区分来源） */
+    onCancel?: () => void;
+    /** 关闭前钩子；返回 false 可阻止关闭 */
+    beforeClose?: RsConfirmBeforeClose;
+    /**
+     * 正文与按钮之间的额外内容（渲染函数）。
+     * 声明式请用 RsConfirmDialog 的 #extra 插槽。
+     */
+    extra?: () => unknown;
+    showOverlay?: boolean;
+    /**
+     * 遮罩不透明度 0–1；覆盖 CSS 变量 --rs-dialog-overlay-bg。
+     * 未传时使用主题默认（最浅）。
+     */
+    overlayOpacity?: number;
+    /**
+     * 遮罩模糊半径；number 按 px。覆盖 --rs-dialog-overlay-blur。
+     * 未传时使用主题默认（0）。
+     */
+    overlayBlur?: number | string;
+    /** false 表示禁用 Teleport，就地渲染 */
+    teleportTo?: string | HTMLElement | false;
+    /** 命令式挂载时覆盖主题；默认读 document data-rs-theme */
+    theme?: RsThemeMode;
+    /** 命令式挂载时覆盖语言；默认读 document data-rs-locale */
+    locale?: RsLocale;
+}
+/** 运行确认框 beforeClose；未提供或非 false 视为允许关闭 */
+export declare function runRsConfirmBeforeClose(beforeClose: RsConfirmBeforeClose | undefined, reason: RsConfirmCloseReason): Promise<boolean>;
+/**
+ * 将 overlayOpacity / overlayBlur 转为遮罩 CSS 变量（可挂到 overlay 节点 style）。
+ */
+export declare function resolveDialogOverlayStyle(options?: {
+    overlayOpacity?: number;
+    overlayBlur?: number | string;
+}): Record<string, string> | undefined;

package/dist/components/dialog-utils.js

@@ -0,0 +1,58 @@
+import { dialogViewportSize } from "./dialog-viewport.js";
+//#region src/components/dialog-utils.ts
+function isRsDialogWidthPreset(width) {
+	return width === "sm" || width === "md" || width === "lg";
+}
+/** 将自定义宽度规范为 CSS 长度 */
+function resolveRsDialogCssWidth(width) {
+	if (isRsDialogWidthPreset(width)) return void 0;
+	if (typeof width === "number") {
+		if (!Number.isFinite(width) || width <= 0) return void 0;
+		return `${width}px`;
+	}
+	return String(width).trim() || void 0;
+}
+function rootFontSizePx() {
+	if (typeof document === "undefined") return 16;
+	return Number.parseFloat(getComputedStyle(document.documentElement).fontSize) || 16;
+}
+/**
+* 将自定义宽度折成 px，供 window 布局计算 bounds / 居中。
+* 支持 number、`px`、`rem`、`%`（相对视口可用宽度）；预设与无法解析的单位返回 undefined。
+*/
+function resolveRsDialogWidthPx(width, viewportWidth = dialogViewportSize().width) {
+	if (isRsDialogWidthPreset(width)) return void 0;
+	if (typeof width === "number") {
+		if (!Number.isFinite(width) || width <= 0) return void 0;
+		return Math.round(width);
+	}
+	const trimmed = String(width).trim();
+	if (!trimmed) return void 0;
+	if (/^\d+(\.\d+)?px$/i.test(trimmed)) return Math.round(Number.parseFloat(trimmed));
+	if (/^\d+(\.\d+)?rem$/i.test(trimmed)) return Math.round(Number.parseFloat(trimmed) * rootFontSizePx());
+	if (/^\d+(\.\d+)?%$/.test(trimmed)) {
+		if (!Number.isFinite(viewportWidth) || viewportWidth <= 0) return void 0;
+		return Math.round(Number.parseFloat(trimmed) / 100 * viewportWidth);
+	}
+}
+async function runRsDialogBeforeClose(beforeClose, reason) {
+	if (!beforeClose) return true;
+	return await beforeClose(reason) !== false;
+}
+/** 运行确认框 beforeClose；未提供或非 false 视为允许关闭 */
+async function runRsConfirmBeforeClose(beforeClose, reason) {
+	if (!beforeClose) return true;
+	return await beforeClose(reason) !== false;
+}
+/**
+* 将 overlayOpacity / overlayBlur 转为遮罩 CSS 变量（可挂到 overlay 节点 style）。
+*/
+function resolveDialogOverlayStyle(options) {
+	if (!options) return void 0;
+	const style = {};
+	if (options.overlayOpacity != null && Number.isFinite(options.overlayOpacity)) style["--rs-dialog-overlay-bg"] = `rgb(0 0 0 / ${Math.min(1, Math.max(0, options.overlayOpacity))})`;
+	if (options.overlayBlur != null && options.overlayBlur !== "") style["--rs-dialog-overlay-blur"] = typeof options.overlayBlur === "number" ? `${options.overlayBlur}px` : String(options.overlayBlur);
+	return Object.keys(style).length ? style : void 0;
+}
+//#endregion
+export { isRsDialogWidthPreset, resolveDialogOverlayStyle, resolveRsDialogCssWidth, resolveRsDialogWidthPx, runRsConfirmBeforeClose, runRsDialogBeforeClose };

package/dist/components/dialog-viewport.d.ts

@@ -0,0 +1,14 @@
+declare const viewportGap = 16;
+export interface RsDialogViewportInsets {
+    top: number;
+    right: number;
+    bottom: number;
+    left: number;
+}
+/** 读取对话框可用视口 inset（px），未设置时回退 viewportGap。 */
+export declare function readDialogViewportInsets(): RsDialogViewportInsets;
+export declare function dialogViewportSize(): {
+    width: number;
+    height: number;
+};
+export { viewportGap };

package/dist/components/dialog-viewport.js

@@ -0,0 +1,38 @@
+function parseCssPx(value, fallback) {
+	const trimmed = value.trim();
+	if (!trimmed) return fallback;
+	const num = Number.parseFloat(trimmed);
+	if (Number.isNaN(num)) return fallback;
+	if (trimmed.endsWith("rem")) return num * (Number.parseFloat(getComputedStyle(document.documentElement).fontSize) || 16);
+	return num;
+}
+/** 读取对话框可用视口 inset（px），未设置时回退 viewportGap。 */
+function readDialogViewportInsets() {
+	if (typeof document === "undefined") return {
+		top: 16,
+		right: 16,
+		bottom: 16,
+		left: 16
+	};
+	const root = getComputedStyle(document.documentElement);
+	const x = parseCssPx(root.getPropertyValue("--rs-dialog-inset-x"), 16);
+	return {
+		top: parseCssPx(root.getPropertyValue("--rs-dialog-inset-top"), 16),
+		right: x,
+		bottom: parseCssPx(root.getPropertyValue("--rs-dialog-inset-bottom"), 16),
+		left: x
+	};
+}
+function dialogViewportSize() {
+	if (typeof window === "undefined") return {
+		width: 800,
+		height: 600
+	};
+	const insets = readDialogViewportInsets();
+	return {
+		width: window.innerWidth - insets.left - insets.right,
+		height: window.innerHeight - insets.top - insets.bottom
+	};
+}
+//#endregion
+export { dialogViewportSize, readDialogViewportInsets };

package/dist/components/dialog-window.d.ts

@@ -0,0 +1,45 @@
+import { type Ref } from 'vue';
+import type { RsDialogWidthPreset } from './dialog-utils';
+/** @deprecated 使用 RsDialogWidthPreset；保留别名避免外部类型断裂 */
+export type RsDialogWidth = RsDialogWidthPreset;
+export type RsDialogResizeHandle = 'n' | 's' | 'e' | 'w' | 'ne' | 'nw' | 'se' | 'sw';
+export interface RsDialogBounds {
+    x: number;
+    y: number;
+    width: number;
+    height: number;
+}
+export declare function useRsDialogWindow(options: {
+    open: Ref<boolean>;
+    widthPreset: Ref<RsDialogWidthPreset>;
+    /** 自定义初始宽度（px）；有值时优先于预设/比例 */
+    initialWidth?: Ref<number | undefined>;
+    draggable: Ref<boolean>;
+    resizable: Ref<boolean>;
+    compact?: Ref<boolean>;
+    /** 全屏/还原时是否播放 left/top/width/height 过渡（含编辑器时建议 false） */
+    boundsTransition?: Ref<boolean>;
+}): {
+    isFullscreen: Ref<boolean, boolean>;
+    boundsTransitionEnabled: Ref<boolean, boolean>;
+    dialogStyle: import("vue").ComputedRef<{
+        left: string;
+        top: string;
+        width: string;
+        height: string;
+        transform: string;
+        maxWidth?: undefined;
+    } | {
+        left: string;
+        top: string;
+        width: string;
+        maxWidth: string;
+        height: string;
+        transform: string;
+    }>;
+    resizeHandles: RsDialogResizeHandle[];
+    setPanelEl: (el: HTMLElement | null) => void;
+    toggleFullscreen: () => void;
+    onHeaderPointerDown: (event: PointerEvent) => void;
+    onResizePointerDown: (handle: RsDialogResizeHandle, event: PointerEvent) => void;
+};

package/dist/components/dialog-window.js

@@ -0,0 +1,275 @@
+import { dialogViewportSize, readDialogViewportInsets } from "./dialog-viewport.js";
+import { computed, onBeforeUnmount, ref, watch } from "vue";
+//#region src/components/dialog-window.ts
+var widthMap = {
+	sm: 384,
+	md: 448,
+	lg: 512
+};
+var defaultWidthRatio = .8;
+var defaultHeightRatio = .75;
+var minWidth = 320;
+var minHeight = 240;
+function useRsDialogWindow(options) {
+	const isFullscreen = ref(false);
+	const boundsTransitionEnabled = ref(false);
+	const bounds = ref({
+		x: 0,
+		y: 0,
+		width: widthMap.md,
+		height: minHeight
+	});
+	const restoreBounds = ref(null);
+	const resizeHandles = [
+		"n",
+		"s",
+		"e",
+		"w",
+		"ne",
+		"nw",
+		"se",
+		"sw"
+	];
+	let boundsTransitionTimer = null;
+	let cachedInsets = readDialogViewportInsets();
+	/** 交互中的目标面板；有值时 pointermove 只改 DOM，pointerup 再写回 bounds */
+	let panelEl = null;
+	let liveBounds = null;
+	let dragState = null;
+	let resizeState = null;
+	function writePanelBox(next) {
+		if (!panelEl) return;
+		panelEl.style.left = `${next.x}px`;
+		panelEl.style.top = `${next.y}px`;
+		panelEl.style.width = `${next.width}px`;
+		panelEl.style.height = `${next.height}px`;
+		panelEl.style.transform = "none";
+	}
+	/** 绑定可定位的对话框根节点（DialogContent 的 DOM） */
+	function setPanelEl(el) {
+		panelEl = el;
+	}
+	/** 优先用已绑定节点；否则从事件目标向上找面板（Reka DialogContent ref 不一定有 $el） */
+	function ensurePanelEl(from) {
+		if (panelEl?.isConnected) return panelEl;
+		const found = (from instanceof Element ? from : null)?.closest(".rs-dialog__content");
+		if (found instanceof HTMLElement) {
+			panelEl = found;
+			return found;
+		}
+		return null;
+	}
+	function defaultWindowSize() {
+		const { width: maxW, height: maxH } = dialogViewportSize();
+		const customW = options.initialWidth?.value;
+		return {
+			width: customW != null && Number.isFinite(customW) && customW > 0 ? Math.min(maxW, Math.max(minWidth, Math.round(customW))) : Math.min(maxW, Math.max(minWidth, Math.round(maxW * defaultWidthRatio))),
+			height: Math.min(maxH, Math.max(minHeight, Math.round(maxH * defaultHeightRatio)))
+		};
+	}
+	function refreshCachedInsets() {
+		cachedInsets = readDialogViewportInsets();
+	}
+	function clampBounds(next) {
+		const insets = cachedInsets;
+		const maxW = window.innerWidth - insets.left - insets.right;
+		const maxH = window.innerHeight - insets.top - insets.bottom;
+		const width = Math.min(maxW, Math.max(minWidth, next.width));
+		const height = Math.min(maxH, Math.max(minHeight, next.height));
+		return {
+			x: Math.min(window.innerWidth - width - insets.right, Math.max(insets.left, next.x)),
+			y: Math.min(window.innerHeight - height - insets.bottom, Math.max(insets.top, next.y)),
+			width,
+			height
+		};
+	}
+	function resetOnOpen() {
+		isFullscreen.value = false;
+		restoreBounds.value = null;
+		if (options.compact?.value) {
+			bounds.value = {
+				x: bounds.value.x,
+				y: bounds.value.y,
+				width: widthMap[options.widthPreset.value],
+				height: 0
+			};
+			return;
+		}
+		refreshCachedInsets();
+		const insets = cachedInsets;
+		const { width, height } = defaultWindowSize();
+		const availableH = window.innerHeight - insets.top - insets.bottom;
+		bounds.value = clampBounds({
+			x: insets.left + (window.innerWidth - insets.left - insets.right - width) / 2,
+			y: insets.top + (availableH - height) / 2,
+			width,
+			height
+		});
+	}
+	watch(options.open, (value) => {
+		if (value) resetOnOpen();
+		else {
+			stopInteractions();
+			isFullscreen.value = false;
+			restoreBounds.value = null;
+		}
+	}, { immediate: true });
+	const dialogStyle = computed(() => {
+		const insets = cachedInsets;
+		if (isFullscreen.value) return {
+			left: `${insets.left}px`,
+			top: `${insets.top}px`,
+			width: `calc(100vw - ${insets.left + insets.right}px)`,
+			height: `calc(100vh - ${insets.top + insets.bottom}px)`,
+			transform: "none"
+		};
+		if (options.compact?.value) {
+			const customW = options.initialWidth?.value;
+			const width = customW != null && Number.isFinite(customW) && customW > 0 ? customW : widthMap[options.widthPreset.value];
+			return {
+				left: "50%",
+				top: `calc(${insets.top}px + (100vh - ${insets.top + insets.bottom}px) / 2)`,
+				width: `${width}px`,
+				maxWidth: `calc(100vw - ${insets.left + insets.right}px)`,
+				height: "auto",
+				transform: "translate(-50%, -50%)"
+			};
+		}
+		const b = bounds.value;
+		return {
+			left: `${b.x}px`,
+			top: `${b.y}px`,
+			width: `${b.width}px`,
+			height: `${b.height}px`,
+			transform: "none"
+		};
+	});
+	function clearBoundsTransitionTimer() {
+		if (!boundsTransitionTimer) return;
+		clearTimeout(boundsTransitionTimer);
+		boundsTransitionTimer = null;
+	}
+	function enableBoundsTransition() {
+		boundsTransitionEnabled.value = true;
+		clearBoundsTransitionTimer();
+		boundsTransitionTimer = setTimeout(() => {
+			boundsTransitionEnabled.value = false;
+			boundsTransitionTimer = null;
+		}, 280);
+	}
+	function toggleFullscreen() {
+		refreshCachedInsets();
+		if (options.boundsTransition?.value) enableBoundsTransition();
+		if (isFullscreen.value) {
+			isFullscreen.value = false;
+			bounds.value = restoreBounds.value ? { ...restoreBounds.value } : bounds.value;
+			restoreBounds.value = null;
+			return;
+		}
+		restoreBounds.value = { ...bounds.value };
+		isFullscreen.value = true;
+	}
+	function onPointerMove(event) {
+		if (dragState) {
+			const dx = event.clientX - dragState.startX;
+			const dy = event.clientY - dragState.startY;
+			const next = clampBounds({
+				...dragState.origin,
+				x: dragState.origin.x + dx,
+				y: dragState.origin.y + dy
+			});
+			liveBounds = next;
+			writePanelBox(next);
+			return;
+		}
+		if (!resizeState) return;
+		const dx = event.clientX - resizeState.startX;
+		const dy = event.clientY - resizeState.startY;
+		const next = { ...resizeState.origin };
+		if (resizeState.handle.includes("e")) next.width = resizeState.origin.width + dx;
+		if (resizeState.handle.includes("w")) {
+			next.width = resizeState.origin.width - dx;
+			next.x = resizeState.origin.x + dx;
+		}
+		if (resizeState.handle.includes("s")) next.height = resizeState.origin.height + dy;
+		if (resizeState.handle.includes("n")) {
+			next.height = resizeState.origin.height - dy;
+			next.y = resizeState.origin.y + dy;
+		}
+		const clamped = clampBounds(next);
+		liveBounds = clamped;
+		writePanelBox(clamped);
+	}
+	function stopInteractions() {
+		if (liveBounds) {
+			bounds.value = liveBounds;
+			liveBounds = null;
+		}
+		dragState = null;
+		resizeState = null;
+		window.removeEventListener("pointermove", onPointerMove);
+		window.removeEventListener("pointerup", stopInteractions);
+		document.body.style.userSelect = "";
+		document.body.style.cursor = "";
+	}
+	function startInteraction(cursor) {
+		boundsTransitionEnabled.value = false;
+		clearBoundsTransitionTimer();
+		refreshCachedInsets();
+		liveBounds = { ...bounds.value };
+		window.addEventListener("pointermove", onPointerMove);
+		window.addEventListener("pointerup", stopInteractions);
+		document.body.style.userSelect = "none";
+		document.body.style.cursor = cursor;
+	}
+	function onHeaderPointerDown(event) {
+		if (!options.draggable.value || isFullscreen.value) return;
+		if (event.target.closest("button,a,input,textarea,select")) return;
+		event.preventDefault();
+		ensurePanelEl(event.target);
+		dragState = {
+			startX: event.clientX,
+			startY: event.clientY,
+			origin: { ...bounds.value }
+		};
+		startInteraction("move");
+	}
+	const resizeCursor = {
+		n: "ns-resize",
+		s: "ns-resize",
+		e: "ew-resize",
+		w: "ew-resize",
+		ne: "nesw-resize",
+		sw: "nesw-resize",
+		nw: "nwse-resize",
+		se: "nwse-resize"
+	};
+	function onResizePointerDown(handle, event) {
+		if (!options.resizable.value || isFullscreen.value) return;
+		event.preventDefault();
+		ensurePanelEl(event.target);
+		resizeState = {
+			handle,
+			startX: event.clientX,
+			startY: event.clientY,
+			origin: { ...bounds.value }
+		};
+		startInteraction(resizeCursor[handle]);
+	}
+	onBeforeUnmount(() => {
+		stopInteractions();
+		clearBoundsTransitionTimer();
+	});
+	return {
+		isFullscreen,
+		boundsTransitionEnabled,
+		dialogStyle,
+		resizeHandles,
+		setPanelEl,
+		toggleFullscreen,
+		onHeaderPointerDown,
+		onResizePointerDown
+	};
+}
+//#endregion
+export { useRsDialogWindow };

package/dist/components/drawer-utils.d.ts

@@ -0,0 +1,37 @@
+import { type RsDialogBeforeClose, type RsDialogCloseReason } from './dialog-utils';
+/** 抽屉滑出方向 */
+export type RsDrawerSide = 'left' | 'right' | 'top' | 'bottom';
+/** 抽屉尺寸预设（左右为宽度，上下为高度） */
+export type RsDrawerSize = 'sm' | 'md' | 'lg' | 'full';
+/**
+ * 自定义面板尺寸：number 按 px；string 原样写入 CSS（如 `24rem` / `40%`）。
+ * 与 size 同时传入时，自定义尺寸优先。
+ */
+export type RsDrawerDimension = number | string;
+/** 关闭来源，与 Dialog 共用语义，便于业务统一 beforeClose */
+export type RsDrawerCloseReason = RsDialogCloseReason;
+/** 关闭前钩子：返回 false 阻止关闭；支持异步 */
+export type RsDrawerBeforeClose = RsDialogBeforeClose;
+/** 左右抽屉默认可拖最小宽度 */
+export declare const RS_DRAWER_MIN_SIZE_PX = 256;
+/** 相对视口的默认可拖上限比例 */
+export declare const RS_DRAWER_MAX_VIEWPORT_RATIO = 0.9;
+/** 将 size 预设解析为 CSS 长度（full 由样式类处理） */
+export declare function resolveRsDrawerSizeCss(size: RsDrawerSize): string | undefined;
+/** 将自定义 width/height 规范为 CSS 长度 */
+export declare function resolveRsDrawerDimensionCss(value: RsDrawerDimension | undefined): string | undefined;
+/**
+ * 将抽屉尺寸表达式解析为像素，供拖拽缩放夹紧。
+ * 无法解析时返回 fallbackPx。
+ */
+export declare function resolveRsDrawerSizePx(value: RsDrawerDimension | undefined, fallbackPx: number, rootFontPx: number, viewportPx: number): number;
+/** 将拖拽得到的尺寸夹在 min/max 之间并取整。 */
+export declare function clampRsDrawerSize(px: number, minPx: number, maxPx: number): number;
+export declare function runRsDrawerBeforeClose(beforeClose: RsDrawerBeforeClose | undefined, reason: RsDrawerCloseReason): Promise<boolean>;
+/**
+ * 遮罩样式：复用 Dialog 的 opacity/blur 解析，写入抽屉专用 CSS 变量。
+ */
+export declare function resolveDrawerOverlayStyle(options?: {
+    overlayOpacity?: number;
+    overlayBlur?: number | string;
+}): Record<string, string> | undefined;