fast-element-plus 1.0.21 → 2.0.0

package/dist/utils/date/index.d.ts

@@ -0,0 +1,74 @@
+/** 可转换为日期的输入；数字始终按 Unix 毫秒时间戳处理。 */
+export type DateInput = Date | number | string;
+/**
+ * 转换并克隆有效日期。
+ *
+ * @remarks 数字不进行秒/毫秒猜测；字符串遵循运行时 `Date` 解析规则，跨平台代码应传带显式时区的完整 ISO 8601。
+ * @param value - Date、Unix 毫秒时间戳或运行时可解析字符串。
+ * @returns 与输入不共享可变状态的新 Date。
+ * @throws 输入无效时抛出 `TypeError`。
+ */
+export declare function toDate(value: DateInput): Date;
+/**
+ * 返回输入日期所在本地时区日期的 `00:00:00.000`，不修改输入。
+ *
+ * @param value - 有效日期输入。
+ * @returns 新建的本地日开始时间。
+ * @throws 输入无效时抛出 `TypeError`。
+ */
+export declare function startOfDay(value: DateInput): Date;
+/** 日期选择器单日期快捷项。 */
+export interface DateShortcut {
+    /** 面向中文日期选择器的显示文本；调用方可直接用于菜单标签。 */
+    text: string;
+    /**
+     * 计算快捷项对应日期。
+     * @returns 每次调用时基于当前本地时间创建的新 `Date`，调用方可安全修改。
+     */
+    value: () => Date;
+}
+/** 日期选择器范围快捷项。 */
+export interface DateRangeShortcut {
+    /** 面向中文日期范围选择器的显示文本；调用方可直接用于菜单标签。 */
+    text: string;
+    /**
+     * 计算快捷项对应的本地日期范围。
+     * @returns 每次调用时创建的新元组；起点为 `00:00:00.000`，终点为 `23:59:59.999`。
+     */
+    value: () => [start: Date, end: Date];
+}
+/**
+ * 把日期转换为固定中文相对时间文本。
+ *
+ * @remarks 10 位以内数字按 Unix 秒处理，其余数字按毫秒处理；月份与年份按本地日历月差计算。
+ * @param value - Date、时间戳、可解析字符串或空值。
+ * @returns 例如“3分钟前”“半年后”；非法或空输入返回空字符串。
+ */
+export declare function formatChineseRelativeTime(value: Date | number | string | null | undefined): string;
+/**
+ * 创建从今天到前后一个月日期的完整本地日范围。
+ *
+ * @param towardFuture - `true` 返回今天至一个月后，默认返回一个月前至今天。
+ * @returns 每次调用新建的本地日首尾边界。
+ */
+export declare function createOneMonthRangeFromToday(towardFuture?: boolean): [start: Date, end: Date];
+/**
+ * 创建面向过去或未来的常用完整日期范围快捷项。
+ *
+ * @param towardFuture - `true` 创建未来范围，默认创建历史范围。
+ * @returns 每次求值都会重新读取当前时间的范围快捷项。
+ */
+export declare function createDateRangeShortcuts(towardFuture?: boolean): DateRangeShortcut[];
+/**
+ * 创建面向过去或未来的常用单日期快捷项。
+ *
+ * @param towardFuture - `true` 创建未来日期，默认创建历史日期。
+ * @returns 每次求值都会重新读取当前时间的单日期快捷项。
+ */
+export declare function createDateShortcuts(towardFuture?: boolean): DateShortcut[];
+/**
+ * 返回今天的本地零点。
+ *
+ * @returns 新建的 `00:00:00.000` Date。
+ */
+export declare function getStartOfToday(): Date;

package/dist/utils/date/index.mjs

@@ -0,0 +1,190 @@
+//#region src/utils/date/index.ts
+/**
+* 转换并克隆有效日期。
+*
+* @remarks 数字不进行秒/毫秒猜测；字符串遵循运行时 `Date` 解析规则，跨平台代码应传带显式时区的完整 ISO 8601。
+* @param value - Date、Unix 毫秒时间戳或运行时可解析字符串。
+* @returns 与输入不共享可变状态的新 Date。
+* @throws 输入无效时抛出 `TypeError`。
+*/
+function toDate(value) {
+	const date = value instanceof Date ? new Date(value.getTime()) : new Date(value);
+	if (!Number.isFinite(date.getTime())) throw new TypeError("该值不是有效日期。");
+	return date;
+}
+/**
+* 返回输入日期所在本地时区日期的 `00:00:00.000`，不修改输入。
+*
+* @param value - 有效日期输入。
+* @returns 新建的本地日开始时间。
+* @throws 输入无效时抛出 `TypeError`。
+*/
+function startOfDay(value) {
+	const date = toDate(value);
+	date.setHours(0, 0, 0, 0);
+	return toDate(date);
+}
+/**
+* 移动本地日历字段。
+*
+* @remarks 直接使用 Date Setter，以保留历史快捷项在月底和闰年的溢出语义。
+* @param date - 会被原地修改的日期。
+* @param amount - 对目标字段增加的整数。
+* @param unit - 要移动的日历字段。
+*/
+const shiftCalendarFieldInPlace = (date, amount, unit) => {
+	switch (unit) {
+		case "day":
+			date.setDate(date.getDate() + amount);
+			break;
+		case "month":
+			date.setMonth(date.getMonth() + amount);
+			break;
+		case "year": date.setFullYear(date.getFullYear() + amount);
+	}
+};
+/**
+* 创建动态单日期快捷项。
+*
+* @param text - 日期选择器显示文本。
+* @param amount - 相对当前时间的移动量。
+* @param unit - 移动使用的日历单位。
+* @returns 每次执行 `value` 都重新读取当前时间的快捷项。
+*/
+const createDateShortcut = (text, amount, unit) => ({
+	text,
+	value: () => {
+		const date = /* @__PURE__ */ new Date();
+		shiftCalendarFieldInPlace(date, amount, unit);
+		date.setHours(0, 0, 0, 0);
+		return date;
+	}
+});
+/**
+* 创建动态日期范围快捷项。
+*
+* @param text - 日期选择器显示文本。
+* @param amount - 范围边界相对当前时间的移动量。
+* @param unit - 移动使用的日历单位。
+* @param towardFuture - `true` 移动结束边界，`false` 移动开始边界。
+* @returns 每次求值都覆盖完整本地日边界的范围快捷项。
+*/
+const createRangeShortcut = (text, amount, unit, towardFuture) => ({
+	text,
+	value: () => {
+		const start = /* @__PURE__ */ new Date();
+		const end = /* @__PURE__ */ new Date();
+		shiftCalendarFieldInPlace(towardFuture ? end : start, towardFuture ? amount : -amount, unit);
+		start.setHours(0, 0, 0, 0);
+		end.setHours(23, 59, 59, 999);
+		return [start, end];
+	}
+});
+/**
+* 把日期转换为固定中文相对时间文本。
+*
+* @remarks 10 位以内数字按 Unix 秒处理，其余数字按毫秒处理；月份与年份按本地日历月差计算。
+* @param value - Date、时间戳、可解析字符串或空值。
+* @returns 例如“3分钟前”“半年后”；非法或空输入返回空字符串。
+*/
+function formatChineseRelativeTime(value) {
+	if (value === null || value === void 0) return "";
+	let timestamp;
+	if (typeof value === "string") timestamp = new Date(value).getTime();
+	else if (typeof value === "number") timestamp = value.toString().length <= 10 ? value * 1e3 : value;
+	else timestamp = value.getTime();
+	if (!Number.isFinite(timestamp)) return "";
+	const minute = 6e4;
+	const hour = minute * 60;
+	const day = hour * 24;
+	const currentTimestamp = Date.now();
+	const difference = currentTimestamp - timestamp;
+	const minuteDifference = Math.abs(difference) / minute;
+	const hourDifference = Math.abs(difference) / hour;
+	const dayDifference = Math.abs(difference) / day;
+	const currentDate = new Date(currentTimestamp);
+	const targetDate = new Date(timestamp);
+	const monthDifference = (currentDate.getFullYear() - targetDate.getFullYear()) * 12 + currentDate.getMonth() - targetDate.getMonth();
+	const suffix = difference < 0 ? "后" : "前";
+	if (Math.abs(monthDifference) >= 12) return `${Math.floor(Math.abs(monthDifference) / 12)}年${suffix}`;
+	if (Math.abs(monthDifference) >= 6) return `半年${suffix}`;
+	if (Math.abs(monthDifference) >= 1) return `${Math.abs(monthDifference)}月${suffix}`;
+	if (dayDifference >= 15) return `半月${suffix}`;
+	if (dayDifference >= 7) return `${Math.floor(dayDifference / 7)}周${suffix}`;
+	if (dayDifference >= 1) return `${Math.floor(dayDifference)}天${suffix}`;
+	if (hourDifference >= 1) return `${Math.floor(hourDifference)}小时${suffix}`;
+	if (minuteDifference >= 1) return `${Math.floor(minuteDifference)}分钟${suffix}`;
+	return "刚刚";
+}
+/**
+* 创建从今天到前后一个月日期的完整本地日范围。
+*
+* @param towardFuture - `true` 返回今天至一个月后，默认返回一个月前至今天。
+* @returns 每次调用新建的本地日首尾边界。
+*/
+function createOneMonthRangeFromToday(towardFuture = false) {
+	const start = /* @__PURE__ */ new Date();
+	const end = /* @__PURE__ */ new Date();
+	shiftCalendarFieldInPlace(towardFuture ? end : start, towardFuture ? 1 : -1, "month");
+	start.setHours(0, 0, 0, 0);
+	end.setHours(23, 59, 59, 999);
+	return [start, end];
+}
+/**
+* 创建面向过去或未来的常用完整日期范围快捷项。
+*
+* @param towardFuture - `true` 创建未来范围，默认创建历史范围。
+* @returns 每次求值都会重新读取当前时间的范围快捷项。
+*/
+function createDateRangeShortcuts(towardFuture = false) {
+	return towardFuture ? [
+		createRangeShortcut("后1天", 1, "day", true),
+		createRangeShortcut("后3天", 3, "day", true),
+		createRangeShortcut("后1周", 7, "day", true),
+		createRangeShortcut("后1月", 1, "month", true),
+		createRangeShortcut("后3月", 3, "month", true),
+		createRangeShortcut("后6月", 6, "month", true),
+		createRangeShortcut("后1年", 1, "year", true)
+	] : [
+		createRangeShortcut("近1天", 1, "day", false),
+		createRangeShortcut("近3天", 3, "day", false),
+		createRangeShortcut("近1周", 7, "day", false),
+		createRangeShortcut("近1月", 1, "month", false),
+		createRangeShortcut("近3月", 3, "month", false),
+		createRangeShortcut("近6月", 6, "month", false),
+		createRangeShortcut("近1年", 1, "year", false)
+	];
+}
+/**
+* 创建面向过去或未来的常用单日期快捷项。
+*
+* @param towardFuture - `true` 创建未来日期，默认创建历史日期。
+* @returns 每次求值都会重新读取当前时间的单日期快捷项。
+*/
+function createDateShortcuts(towardFuture = false) {
+	return towardFuture ? [
+		createDateShortcut("今天", 0, "day"),
+		createDateShortcut("明天", 1, "day"),
+		createDateShortcut("一周后", 7, "day"),
+		createDateShortcut("一月后", 1, "month"),
+		createDateShortcut("一年后", 1, "year")
+	] : [
+		createDateShortcut("今天", 0, "day"),
+		createDateShortcut("昨天", -1, "day"),
+		createDateShortcut("一周前", -7, "day"),
+		createDateShortcut("一月前", -1, "month"),
+		createDateShortcut("一年前", -1, "year")
+	];
+}
+/**
+* 返回今天的本地零点。
+*
+* @returns 新建的 `00:00:00.000` Date。
+*/
+function getStartOfToday() {
+	return startOfDay(/* @__PURE__ */ new Date());
+}
+//#endregion
+export { createDateRangeShortcuts, createDateShortcuts, createOneMonthRangeFromToday, formatChineseRelativeTime, getStartOfToday, startOfDay, toDate };
+
+//# sourceMappingURL=index.mjs.map

package/dist/utils/date/index.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.mjs","names":[],"sources":["../../../src/utils/date/index.ts"],"sourcesContent":["/** 可转换为日期的输入；数字始终按 Unix 毫秒时间戳处理。 */\nexport type DateInput = Date | number | string;\n\n/**\n * 转换并克隆有效日期。\n *\n * @remarks 数字不进行秒/毫秒猜测；字符串遵循运行时 `Date` 解析规则，跨平台代码应传带显式时区的完整 ISO 8601。\n * @param value - Date、Unix 毫秒时间戳或运行时可解析字符串。\n * @returns 与输入不共享可变状态的新 Date。\n * @throws 输入无效时抛出 `TypeError`。\n */\nexport function toDate(value: DateInput): Date {\n\tconst date = value instanceof Date ? new Date(value.getTime()) : new Date(value);\n\tif (!Number.isFinite(date.getTime())) {\n\t\tthrow new TypeError(\"该值不是有效日期。\");\n\t}\n\treturn date;\n}\n\n/**\n * 返回输入日期所在本地时区日期的 `00:00:00.000`，不修改输入。\n *\n * @param value - 有效日期输入。\n * @returns 新建的本地日开始时间。\n * @throws 输入无效时抛出 `TypeError`。\n */\nexport function startOfDay(value: DateInput): Date {\n\tconst date = toDate(value);\n\tdate.setHours(0, 0, 0, 0);\n\treturn toDate(date);\n}\n\n/** 日期选择器单日期快捷项。 */\nexport interface DateShortcut {\n\t/** 面向中文日期选择器的显示文本；调用方可直接用于菜单标签。 */\n\ttext: string;\n\t/**\n\t * 计算快捷项对应日期。\n\t * @returns 每次调用时基于当前本地时间创建的新 `Date`，调用方可安全修改。\n\t */\n\tvalue: () => Date;\n}\n\n/** 日期选择器范围快捷项。 */\nexport interface DateRangeShortcut {\n\t/** 面向中文日期范围选择器的显示文本；调用方可直接用于菜单标签。 */\n\ttext: string;\n\t/**\n\t * 计算快捷项对应的本地日期范围。\n\t * @returns 每次调用时创建的新元组；起点为 `00:00:00.000`，终点为 `23:59:59.999`。\n\t */\n\tvalue: () => [start: Date, end: Date];\n}\n\n/** 历史快捷项允许移动的本地日历单位。 */\ntype CalendarUnit = \"day\" | \"month\" | \"year\";\n\n/**\n * 移动本地日历字段。\n *\n * @remarks 直接使用 Date Setter，以保留历史快捷项在月底和闰年的溢出语义。\n * @param date - 会被原地修改的日期。\n * @param amount - 对目标字段增加的整数。\n * @param unit - 要移动的日历字段。\n */\nconst shiftCalendarFieldInPlace = (date: Date, amount: number, unit: CalendarUnit): void => {\n\tswitch (unit) {\n\t\tcase \"day\":\n\t\t\tdate.setDate(date.getDate() + amount);\n\t\t\tbreak;\n\t\tcase \"month\":\n\t\t\tdate.setMonth(date.getMonth() + amount);\n\t\t\tbreak;\n\t\tcase \"year\":\n\t\t\tdate.setFullYear(date.getFullYear() + amount);\n\t\t\tbreak;\n\t}\n};\n\n/**\n * 创建动态单日期快捷项。\n *\n * @param text - 日期选择器显示文本。\n * @param amount - 相对当前时间的移动量。\n * @param unit - 移动使用的日历单位。\n * @returns 每次执行 `value` 都重新读取当前时间的快捷项。\n */\nconst createDateShortcut = (text: string, amount: number, unit: CalendarUnit): DateShortcut => ({\n\ttext,\n\tvalue: (): Date => {\n\t\tconst date = new Date();\n\t\tshiftCalendarFieldInPlace(date, amount, unit);\n\t\tdate.setHours(0, 0, 0, 0);\n\t\treturn date;\n\t},\n});\n\n/**\n * 创建动态日期范围快捷项。\n *\n * @param text - 日期选择器显示文本。\n * @param amount - 范围边界相对当前时间的移动量。\n * @param unit - 移动使用的日历单位。\n * @param towardFuture - `true` 移动结束边界，`false` 移动开始边界。\n * @returns 每次求值都覆盖完整本地日边界的范围快捷项。\n */\nconst createRangeShortcut = (text: string, amount: number, unit: CalendarUnit, towardFuture: boolean): DateRangeShortcut => ({\n\ttext,\n\tvalue: (): [Date, Date] => {\n\t\tconst start = new Date();\n\t\tconst end = new Date();\n\t\tshiftCalendarFieldInPlace(towardFuture ? end : start, towardFuture ? amount : -amount, unit);\n\t\tstart.setHours(0, 0, 0, 0);\n\t\tend.setHours(23, 59, 59, 999);\n\t\treturn [start, end];\n\t},\n});\n\n/**\n * 把日期转换为固定中文相对时间文本。\n *\n * @remarks 10 位以内数字按 Unix 秒处理，其余数字按毫秒处理；月份与年份按本地日历月差计算。\n * @param value - Date、时间戳、可解析字符串或空值。\n * @returns 例如“3分钟前”“半年后”；非法或空输入返回空字符串。\n */\nexport function formatChineseRelativeTime(value: Date | number | string | null | undefined): string {\n\tif (value === null || value === undefined) return \"\";\n\tlet timestamp: number;\n\tif (typeof value === \"string\") timestamp = new Date(value).getTime();\n\telse if (typeof value === \"number\") timestamp = value.toString().length <= 10 ? value * 1000 : value;\n\telse timestamp = value.getTime();\n\tif (!Number.isFinite(timestamp)) return \"\";\n\n\tconst minute = 60_000;\n\tconst hour = minute * 60;\n\tconst day = hour * 24;\n\tconst currentTimestamp = Date.now();\n\tconst difference = currentTimestamp - timestamp;\n\tconst minuteDifference = Math.abs(difference) / minute;\n\tconst hourDifference = Math.abs(difference) / hour;\n\tconst dayDifference = Math.abs(difference) / day;\n\tconst currentDate = new Date(currentTimestamp);\n\tconst targetDate = new Date(timestamp);\n\tconst monthDifference = (currentDate.getFullYear() - targetDate.getFullYear()) * 12 + currentDate.getMonth() - targetDate.getMonth();\n\tconst suffix = difference < 0 ? \"后\" : \"前\";\n\tif (Math.abs(monthDifference) >= 12) return `${Math.floor(Math.abs(monthDifference) / 12)}年${suffix}`;\n\tif (Math.abs(monthDifference) >= 6) return `半年${suffix}`;\n\tif (Math.abs(monthDifference) >= 1) return `${Math.abs(monthDifference)}月${suffix}`;\n\tif (dayDifference >= 15) return `半月${suffix}`;\n\tif (dayDifference >= 7) return `${Math.floor(dayDifference / 7)}周${suffix}`;\n\tif (dayDifference >= 1) return `${Math.floor(dayDifference)}天${suffix}`;\n\tif (hourDifference >= 1) return `${Math.floor(hourDifference)}小时${suffix}`;\n\tif (minuteDifference >= 1) return `${Math.floor(minuteDifference)}分钟${suffix}`;\n\treturn \"刚刚\";\n}\n\n/**\n * 创建从今天到前后一个月日期的完整本地日范围。\n *\n * @param towardFuture - `true` 返回今天至一个月后，默认返回一个月前至今天。\n * @returns 每次调用新建的本地日首尾边界。\n */\nexport function createOneMonthRangeFromToday(towardFuture = false): [start: Date, end: Date] {\n\tconst start = new Date();\n\tconst end = new Date();\n\tshiftCalendarFieldInPlace(towardFuture ? end : start, towardFuture ? 1 : -1, \"month\");\n\tstart.setHours(0, 0, 0, 0);\n\tend.setHours(23, 59, 59, 999);\n\treturn [start, end];\n}\n\n/**\n * 创建面向过去或未来的常用完整日期范围快捷项。\n *\n * @param towardFuture - `true` 创建未来范围，默认创建历史范围。\n * @returns 每次求值都会重新读取当前时间的范围快捷项。\n */\nexport function createDateRangeShortcuts(towardFuture = false): DateRangeShortcut[] {\n\treturn towardFuture\n\t\t? [\n\t\t\t\tcreateRangeShortcut(\"后1天\", 1, \"day\", true),\n\t\t\t\tcreateRangeShortcut(\"后3天\", 3, \"day\", true),\n\t\t\t\tcreateRangeShortcut(\"后1周\", 7, \"day\", true),\n\t\t\t\tcreateRangeShortcut(\"后1月\", 1, \"month\", true),\n\t\t\t\tcreateRangeShortcut(\"后3月\", 3, \"month\", true),\n\t\t\t\tcreateRangeShortcut(\"后6月\", 6, \"month\", true),\n\t\t\t\tcreateRangeShortcut(\"后1年\", 1, \"year\", true),\n\t\t\t]\n\t\t: [\n\t\t\t\tcreateRangeShortcut(\"近1天\", 1, \"day\", false),\n\t\t\t\tcreateRangeShortcut(\"近3天\", 3, \"day\", false),\n\t\t\t\tcreateRangeShortcut(\"近1周\", 7, \"day\", false),\n\t\t\t\tcreateRangeShortcut(\"近1月\", 1, \"month\", false),\n\t\t\t\tcreateRangeShortcut(\"近3月\", 3, \"month\", false),\n\t\t\t\tcreateRangeShortcut(\"近6月\", 6, \"month\", false),\n\t\t\t\tcreateRangeShortcut(\"近1年\", 1, \"year\", false),\n\t\t\t];\n}\n\n/**\n * 创建面向过去或未来的常用单日期快捷项。\n *\n * @param towardFuture - `true` 创建未来日期，默认创建历史日期。\n * @returns 每次求值都会重新读取当前时间的单日期快捷项。\n */\nexport function createDateShortcuts(towardFuture = false): DateShortcut[] {\n\treturn towardFuture\n\t\t? [\n\t\t\t\tcreateDateShortcut(\"今天\", 0, \"day\"),\n\t\t\t\tcreateDateShortcut(\"明天\", 1, \"day\"),\n\t\t\t\tcreateDateShortcut(\"一周后\", 7, \"day\"),\n\t\t\t\tcreateDateShortcut(\"一月后\", 1, \"month\"),\n\t\t\t\tcreateDateShortcut(\"一年后\", 1, \"year\"),\n\t\t\t]\n\t\t: [\n\t\t\t\tcreateDateShortcut(\"今天\", 0, \"day\"),\n\t\t\t\tcreateDateShortcut(\"昨天\", -1, \"day\"),\n\t\t\t\tcreateDateShortcut(\"一周前\", -7, \"day\"),\n\t\t\t\tcreateDateShortcut(\"一月前\", -1, \"month\"),\n\t\t\t\tcreateDateShortcut(\"一年前\", -1, \"year\"),\n\t\t\t];\n}\n\n/**\n * 返回今天的本地零点。\n *\n * @returns 新建的 `00:00:00.000` Date。\n */\nexport function getStartOfToday(): Date {\n\treturn startOfDay(new Date());\n}\n"],"mappings":"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"}

package/dist/utils/dom/index.d.ts

@@ -0,0 +1,9 @@
+/**
+ * 为数值或纯数字字符串添加 CSS 单位。
+ *
+ * @param value - 数字、数字字符串或已有单位的 CSS 值；空值返回空字符串。
+ * @param unit - 非零数字使用的单位，默认 `px`。
+ * @returns 零统一返回 `"0"`；非数字字符串保持原样。
+ * @throws `RangeError` 当数字非有限或单位为空。
+ */
+export declare function addCssUnit(value?: string | number | null, unit?: string): string;

package/dist/utils/dom/index.mjs

@@ -0,0 +1,35 @@
+//#region src/utils/dom/index.ts
+/**
+* 判断文本是否可按十进制数值追加 CSS 单位。
+*
+* @param value - 已去除外围空白的文本。
+* @returns 有限十进制数值返回 `true`；二、八、十六进制前缀返回 `false`。
+*/
+const isNumericString = (value) => {
+	if (value.length === 0 || !Number.isFinite(Number(value))) return false;
+	const unsigned = value.startsWith("+") || value.startsWith("-") ? value.slice(1) : value;
+	return !/^0[box]/iu.test(unsigned);
+};
+/**
+* 为数值或纯数字字符串添加 CSS 单位。
+*
+* @param value - 数字、数字字符串或已有单位的 CSS 值；空值返回空字符串。
+* @param unit - 非零数字使用的单位，默认 `px`。
+* @returns 零统一返回 `"0"`；非数字字符串保持原样。
+* @throws `RangeError` 当数字非有限或单位为空。
+*/
+function addCssUnit(value, unit = "px") {
+	if (value === null || value === void 0 || value === "") return "";
+	if (unit.length === 0) throw new RangeError("`unit` 不能为空。");
+	if (typeof value === "number") {
+		if (!Number.isFinite(value)) throw new RangeError("`value` 必须是有限数。");
+		return value === 0 ? "0" : `${value}${unit}`;
+	}
+	const trimmed = value.trim();
+	if (!isNumericString(trimmed)) return value;
+	return Number(trimmed) === 0 ? "0" : `${trimmed}${unit}`;
+}
+//#endregion
+export { addCssUnit };
+
+//# sourceMappingURL=index.mjs.map

package/dist/utils/dom/index.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.mjs","names":[],"sources":["../../../src/utils/dom/index.ts"],"sourcesContent":["/**\n * 判断文本是否可按十进制数值追加 CSS 单位。\n *\n * @param value - 已去除外围空白的文本。\n * @returns 有限十进制数值返回 `true`；二、八、十六进制前缀返回 `false`。\n */\nconst isNumericString = (value: string): boolean => {\n\tif (value.length === 0 || !Number.isFinite(Number(value))) return false;\n\tconst unsigned = value.startsWith(\"+\") || value.startsWith(\"-\") ? value.slice(1) : value;\n\treturn !/^0[box]/iu.test(unsigned);\n};\n\n/**\n * 为数值或纯数字字符串添加 CSS 单位。\n *\n * @param value - 数字、数字字符串或已有单位的 CSS 值；空值返回空字符串。\n * @param unit - 非零数字使用的单位，默认 `px`。\n * @returns 零统一返回 `\"0\"`；非数字字符串保持原样。\n * @throws `RangeError` 当数字非有限或单位为空。\n */\nexport function addCssUnit(value?: string | number | null, unit = \"px\"): string {\n\tif (value === null || value === undefined || value === \"\") return \"\";\n\tif (unit.length === 0) throw new RangeError(\"`unit` 不能为空。\");\n\tif (typeof value === \"number\") {\n\t\tif (!Number.isFinite(value)) throw new RangeError(\"`value` 必须是有限数。\");\n\t\treturn value === 0 ? \"0\" : `${value}${unit}`;\n\t}\n\tconst trimmed = value.trim();\n\tif (!isNumericString(trimmed)) return value;\n\treturn Number(trimmed) === 0 ? \"0\" : `${trimmed}${unit}`;\n}\n"],"mappings":";;;;;;;AAMA,MAAM,mBAAmB,UAA2B;CACnD,IAAI,MAAM,WAAW,KAAK,CAAC,OAAO,SAAS,OAAO,KAAK,CAAC,GAAG,OAAO;CAClE,MAAM,WAAW,MAAM,WAAW,GAAG,KAAK,MAAM,WAAW,GAAG,IAAI,MAAM,MAAM,CAAC,IAAI;CACnF,OAAO,CAAC,YAAY,KAAK,QAAQ;AAClC;;;;;;;;;AAUA,SAAgB,WAAW,OAAgC,OAAO,MAAc;CAC/E,IAAI,UAAU,QAAQ,UAAU,KAAA,KAAa,UAAU,IAAI,OAAO;CAClE,IAAI,KAAK,WAAW,GAAG,MAAM,IAAI,WAAW,cAAc;CAC1D,IAAI,OAAO,UAAU,UAAU;EAC9B,IAAI,CAAC,OAAO,SAAS,KAAK,GAAG,MAAM,IAAI,WAAW,iBAAiB;EACnE,OAAO,UAAU,IAAI,MAAM,GAAG,QAAQ;CACvC;CACA,MAAM,UAAU,MAAM,KAAK;CAC3B,IAAI,CAAC,gBAAgB,OAAO,GAAG,OAAO;CACtC,OAAO,OAAO,OAAO,MAAM,IAAI,MAAM,GAAG,UAAU;AACnD"}

package/dist/utils/index.d.ts

@@ -0,0 +1,10 @@
+/**
+ * Fast.Element.Plus 内部工具聚合入口。
+ *
+ * @packageDocumentation
+ */
+export * from "./async";
+export * from "./date";
+export * from "./dom";
+export * from "./string";
+export * from "./vue";

package/dist/utils/string/index.d.ts

@@ -0,0 +1,20 @@
+/**
+ * 把文本复制到系统剪贴板。
+ *
+ * @remarks uni-app 使用 `setClipboardData`；浏览器优先使用 Clipboard API，并在该 API 不可用时
+ * 回退到 `document.execCommand("copy")`。平台拒绝访问剪贴板时不会静默忽略错误。
+ * @param value - 要复制的文本。
+ * @returns 复制完成后兑现的 Promise。
+ * @throws `Error` 当运行时没有可用的剪贴板能力或复制失败。
+ */
+export declare function copy(value: string): Promise<void>;
+/**
+ * 生成随机字符串。
+ *
+ * @remarks 优先使用 Web Crypto；平台缺少安全随机能力时回退到 `Math.random()`。
+ * @param length - 字符数量，必须是 0 至 1,000,000 的安全整数。
+ * @param alphabet - 不得为空、包含重复字符或超过 2^32 个 Unicode 码点。
+ * @returns 由 `alphabet` 中 Unicode 码点组成的随机文本。
+ * @throws `RangeError` 当长度或字母表非法。
+ */
+export declare function randomString(length: number, alphabet?: string): string;

package/dist/utils/string/index.mjs

@@ -0,0 +1,101 @@
+//#region src/utils/string/index.ts
+const defaultRandomAlphabet = "ABCDEFGHIJKLMNOPQRSTUVWXYZabcdefghijklmnopqrstuvwxyz0123456789";
+const maximumRandomStringLength = 1e6;
+const maximumRandomValuesPerBatch = 16384;
+const uint32Range = 4294967296;
+/** 使用 Web Crypto 填充随机值，能力缺失时回退到 `Math.random()`。 */
+const fillRandomValues = (values) => {
+	const crypto = globalThis.crypto;
+	if (typeof crypto?.getRandomValues === "function") {
+		crypto.getRandomValues(values);
+		return;
+	}
+	const range = values.BYTES_PER_ELEMENT === Uint8Array.BYTES_PER_ELEMENT ? 256 : uint32Range;
+	for (let index = 0; index < values.length; index += 1) values[index] = Math.floor(Math.random() * range);
+};
+/**
+* 把文本复制到系统剪贴板。
+*
+* @remarks uni-app 使用 `setClipboardData`；浏览器优先使用 Clipboard API，并在该 API 不可用时
+* 回退到 `document.execCommand("copy")`。平台拒绝访问剪贴板时不会静默忽略错误。
+* @param value - 要复制的文本。
+* @returns 复制完成后兑现的 Promise。
+* @throws `Error` 当运行时没有可用的剪贴板能力或复制失败。
+*/
+async function copy(value) {
+	const uni = Reflect.get(globalThis, "uni");
+	if (uni !== void 0) {
+		if (typeof uni !== "object" && typeof uni !== "function" || uni === null) throw new TypeError("全局 uni 对象未提供 `setClipboardData`。");
+		const setClipboardData = Reflect.get(uni, "setClipboardData");
+		if (typeof setClipboardData !== "function") throw new TypeError("全局 uni 对象未提供 `setClipboardData`。");
+		await new Promise((resolve, reject) => {
+			Reflect.apply(setClipboardData, uni, [{
+				data: value,
+				fail: (error) => {
+					reject(error instanceof Error ? error : new Error("文本复制到剪贴板失败。", { cause: error }));
+				},
+				success: resolve
+			}]);
+		});
+		return;
+	}
+	const clipboard = globalThis.navigator?.clipboard;
+	if (globalThis.isSecureContext === true && typeof clipboard?.writeText === "function") {
+		await clipboard.writeText(value);
+		return;
+	}
+	const document = globalThis.document;
+	if (typeof document?.createElement !== "function" || document.body === null || typeof document.execCommand !== "function") throw new Error("当前运行环境不支持访问剪贴板。");
+	const textarea = document.createElement("textarea");
+	textarea.value = value;
+	textarea.style.left = "-999999px";
+	textarea.style.opacity = "0";
+	textarea.style.position = "fixed";
+	textarea.style.top = "-999999px";
+	document.body.appendChild(textarea);
+	let copied;
+	try {
+		textarea.focus();
+		textarea.select();
+		copied = document.execCommand("copy");
+	} finally {
+		textarea.remove();
+	}
+	if (!copied) throw new Error("文本复制到剪贴板失败。");
+}
+/**
+* 生成随机字符串。
+*
+* @remarks 优先使用 Web Crypto；平台缺少安全随机能力时回退到 `Math.random()`。
+* @param length - 字符数量，必须是 0 至 1,000,000 的安全整数。
+* @param alphabet - 不得为空、包含重复字符或超过 2^32 个 Unicode 码点。
+* @returns 由 `alphabet` 中 Unicode 码点组成的随机文本。
+* @throws `RangeError` 当长度或字母表非法。
+*/
+function randomString(length, alphabet = defaultRandomAlphabet) {
+	if (!Number.isSafeInteger(length) || length < 0 || length > maximumRandomStringLength) throw new RangeError(`\`length\` 必须是 0 到 ${maximumRandomStringLength} 之间的安全整数。`);
+	const characters = Array.from(alphabet);
+	if (characters.length === 0) throw new RangeError("`alphabet` 不能为空。");
+	if (new Set(characters).size !== characters.length) throw new RangeError("`alphabet` 不能包含重复字符。");
+	if (characters.length > 4294967296) throw new RangeError("`alphabet` 不能包含超过 2^32 个字符。");
+	if (length === 0) return "";
+	const acceptanceLimit = Math.floor(uint32Range / characters.length) * characters.length;
+	const result = [];
+	while (result.length < length) {
+		const remaining = length - result.length;
+		const samples = new Uint32Array(Math.min(remaining, maximumRandomValuesPerBatch));
+		fillRandomValues(samples);
+		for (const sample of samples) {
+			if (sample >= acceptanceLimit) continue;
+			const character = characters[sample % characters.length];
+			if (character === void 0) continue;
+			result.push(character);
+			if (result.length === length) break;
+		}
+	}
+	return result.join("");
+}
+//#endregion
+export { copy, randomString };
+
+//# sourceMappingURL=index.mjs.map

package/dist/utils/string/index.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.mjs","names":[],"sources":["../../../src/utils/string/index.ts"],"sourcesContent":["const defaultRandomAlphabet = \"ABCDEFGHIJKLMNOPQRSTUVWXYZabcdefghijklmnopqrstuvwxyz0123456789\";\nconst maximumRandomStringLength = 1_000_000;\nconst maximumRandomValuesPerBatch = 16_384;\nconst uint32Range = 0x1_0000_0000;\n\n/** 使用 Web Crypto 填充随机值，能力缺失时回退到 `Math.random()`。 */\nconst fillRandomValues = (values: Uint8Array<ArrayBuffer> | Uint32Array<ArrayBuffer>): void => {\n\tconst crypto = globalThis.crypto;\n\tif (typeof crypto?.getRandomValues === \"function\") {\n\t\tcrypto.getRandomValues(values);\n\t\treturn;\n\t}\n\tconst range = values.BYTES_PER_ELEMENT === Uint8Array.BYTES_PER_ELEMENT ? 0x100 : uint32Range;\n\tfor (let index = 0; index < values.length; index += 1) values[index] = Math.floor(Math.random() * range);\n};\n\n/**\n * 把文本复制到系统剪贴板。\n *\n * @remarks uni-app 使用 `setClipboardData`；浏览器优先使用 Clipboard API，并在该 API 不可用时\n * 回退到 `document.execCommand(\"copy\")`。平台拒绝访问剪贴板时不会静默忽略错误。\n * @param value - 要复制的文本。\n * @returns 复制完成后兑现的 Promise。\n * @throws `Error` 当运行时没有可用的剪贴板能力或复制失败。\n */\nexport async function copy(value: string): Promise<void> {\n\tconst uni: unknown = Reflect.get(globalThis, \"uni\");\n\tif (uni !== undefined) {\n\t\tif ((typeof uni !== \"object\" && typeof uni !== \"function\") || uni === null) {\n\t\t\tthrow new TypeError(\"全局 uni 对象未提供 `setClipboardData`。\");\n\t\t}\n\t\tconst setClipboardData: unknown = Reflect.get(uni, \"setClipboardData\");\n\t\tif (typeof setClipboardData !== \"function\") throw new TypeError(\"全局 uni 对象未提供 `setClipboardData`。\");\n\t\tawait new Promise<void>((resolve, reject) => {\n\t\t\tReflect.apply(setClipboardData, uni, [\n\t\t\t\t{\n\t\t\t\t\tdata: value,\n\t\t\t\t\tfail: (error: unknown): void => {\n\t\t\t\t\t\treject(error instanceof Error ? error : new Error(\"文本复制到剪贴板失败。\", { cause: error }));\n\t\t\t\t\t},\n\t\t\t\t\tsuccess: resolve,\n\t\t\t\t},\n\t\t\t]);\n\t\t});\n\t\treturn;\n\t}\n\n\tconst clipboard = globalThis.navigator?.clipboard;\n\tif (globalThis.isSecureContext === true && typeof clipboard?.writeText === \"function\") {\n\t\tawait clipboard.writeText(value);\n\t\treturn;\n\t}\n\n\tconst document = globalThis.document;\n\tif (typeof document?.createElement !== \"function\" || document.body === null || typeof document.execCommand !== \"function\") {\n\t\tthrow new Error(\"当前运行环境不支持访问剪贴板。\");\n\t}\n\tconst textarea = document.createElement(\"textarea\");\n\ttextarea.value = value;\n\ttextarea.style.left = \"-999999px\";\n\ttextarea.style.opacity = \"0\";\n\ttextarea.style.position = \"fixed\";\n\ttextarea.style.top = \"-999999px\";\n\tdocument.body.appendChild(textarea);\n\tlet copied: boolean;\n\ttry {\n\t\ttextarea.focus();\n\t\ttextarea.select();\n\t\tcopied = document.execCommand(\"copy\");\n\t} finally {\n\t\ttextarea.remove();\n\t}\n\tif (!copied) throw new Error(\"文本复制到剪贴板失败。\");\n}\n\n/**\n * 生成随机字符串。\n *\n * @remarks 优先使用 Web Crypto；平台缺少安全随机能力时回退到 `Math.random()`。\n * @param length - 字符数量，必须是 0 至 1,000,000 的安全整数。\n * @param alphabet - 不得为空、包含重复字符或超过 2^32 个 Unicode 码点。\n * @returns 由 `alphabet` 中 Unicode 码点组成的随机文本。\n * @throws `RangeError` 当长度或字母表非法。\n */\nexport function randomString(length: number, alphabet: string = defaultRandomAlphabet): string {\n\tif (!Number.isSafeInteger(length) || length < 0 || length > maximumRandomStringLength) {\n\t\tthrow new RangeError(`\\`length\\` 必须是 0 到 ${maximumRandomStringLength} 之间的安全整数。`);\n\t}\n\tconst characters = Array.from(alphabet);\n\tif (characters.length === 0) throw new RangeError(\"`alphabet` 不能为空。\");\n\tif (new Set(characters).size !== characters.length) throw new RangeError(\"`alphabet` 不能包含重复字符。\");\n\tif (characters.length > 0x1_0000_0000) throw new RangeError(\"`alphabet` 不能包含超过 2^32 个字符。\");\n\tif (length === 0) return \"\";\n\n\t// 丢弃不能平均映射到字母表的尾部区间，避免 `%` 造成前部字符概率偏高。\n\tconst acceptanceLimit = Math.floor(uint32Range / characters.length) * characters.length;\n\tconst result: string[] = [];\n\twhile (result.length < length) {\n\t\tconst remaining = length - result.length;\n\t\t// 分批填充可控制临时内存，并避开 Web Crypto 单次随机数组大小限制。\n\t\tconst samples = new Uint32Array(Math.min(remaining, maximumRandomValuesPerBatch));\n\t\tfillRandomValues(samples);\n\t\tfor (const sample of samples) {\n\t\t\tif (sample >= acceptanceLimit) continue;\n\t\t\tconst character = characters[sample % characters.length];\n\t\t\tif (character === undefined) continue;\n\t\t\tresult.push(character);\n\t\t\tif (result.length === length) break;\n\t\t}\n\t}\n\treturn result.join(\"\");\n}\n"],"mappings":";AAAA,MAAM,wBAAwB;AAC9B,MAAM,4BAA4B;AAClC,MAAM,8BAA8B;AACpC,MAAM,cAAc;;AAGpB,MAAM,oBAAoB,WAAqE;CAC9F,MAAM,SAAS,WAAW;CAC1B,IAAI,OAAO,QAAQ,oBAAoB,YAAY;EAClD,OAAO,gBAAgB,MAAM;EAC7B;CACD;CACA,MAAM,QAAQ,OAAO,sBAAsB,WAAW,oBAAoB,MAAQ;CAClF,KAAK,IAAI,QAAQ,GAAG,QAAQ,OAAO,QAAQ,SAAS,GAAG,OAAO,SAAS,KAAK,MAAM,KAAK,OAAO,IAAI,KAAK;AACxG;;;;;;;;;;AAWA,eAAsB,KAAK,OAA8B;CACxD,MAAM,MAAe,QAAQ,IAAI,YAAY,KAAK;CAClD,IAAI,QAAQ,KAAA,GAAW;EACtB,IAAK,OAAO,QAAQ,YAAY,OAAO,QAAQ,cAAe,QAAQ,MACrE,MAAM,IAAI,UAAU,kCAAkC;EAEvD,MAAM,mBAA4B,QAAQ,IAAI,KAAK,kBAAkB;EACrE,IAAI,OAAO,qBAAqB,YAAY,MAAM,IAAI,UAAU,kCAAkC;EAClG,MAAM,IAAI,SAAe,SAAS,WAAW;GAC5C,QAAQ,MAAM,kBAAkB,KAAK,CACpC;IACC,MAAM;IACN,OAAO,UAAyB;KAC/B,OAAO,iBAAiB,QAAQ,QAAQ,IAAI,MAAM,eAAe,EAAE,OAAO,MAAM,CAAC,CAAC;IACnF;IACA,SAAS;GACV,CACD,CAAC;EACF,CAAC;EACD;CACD;CAEA,MAAM,YAAY,WAAW,WAAW;CACxC,IAAI,WAAW,oBAAoB,QAAQ,OAAO,WAAW,cAAc,YAAY;EACtF,MAAM,UAAU,UAAU,KAAK;EAC/B;CACD;CAEA,MAAM,WAAW,WAAW;CAC5B,IAAI,OAAO,UAAU,kBAAkB,cAAc,SAAS,SAAS,QAAQ,OAAO,SAAS,gBAAgB,YAC9G,MAAM,IAAI,MAAM,iBAAiB;CAElC,MAAM,WAAW,SAAS,cAAc,UAAU;CAClD,SAAS,QAAQ;CACjB,SAAS,MAAM,OAAO;CACtB,SAAS,MAAM,UAAU;CACzB,SAAS,MAAM,WAAW;CAC1B,SAAS,MAAM,MAAM;CACrB,SAAS,KAAK,YAAY,QAAQ;CAClC,IAAI;CACJ,IAAI;EACH,SAAS,MAAM;EACf,SAAS,OAAO;EAChB,SAAS,SAAS,YAAY,MAAM;CACrC,UAAU;EACT,SAAS,OAAO;CACjB;CACA,IAAI,CAAC,QAAQ,MAAM,IAAI,MAAM,aAAa;AAC3C;;;;;;;;;;AAWA,SAAgB,aAAa,QAAgB,WAAmB,uBAA+B;CAC9F,IAAI,CAAC,OAAO,cAAc,MAAM,KAAK,SAAS,KAAK,SAAS,2BAC3D,MAAM,IAAI,WAAW,sBAAsB,0BAA0B,UAAU;CAEhF,MAAM,aAAa,MAAM,KAAK,QAAQ;CACtC,IAAI,WAAW,WAAW,GAAG,MAAM,IAAI,WAAW,kBAAkB;CACpE,IAAI,IAAI,IAAI,UAAU,CAAC,CAAC,SAAS,WAAW,QAAQ,MAAM,IAAI,WAAW,sBAAsB;CAC/F,IAAI,WAAW,SAAS,YAAe,MAAM,IAAI,WAAW,6BAA6B;CACzF,IAAI,WAAW,GAAG,OAAO;CAGzB,MAAM,kBAAkB,KAAK,MAAM,cAAc,WAAW,MAAM,IAAI,WAAW;CACjF,MAAM,SAAmB,CAAC;CAC1B,OAAO,OAAO,SAAS,QAAQ;EAC9B,MAAM,YAAY,SAAS,OAAO;EAElC,MAAM,UAAU,IAAI,YAAY,KAAK,IAAI,WAAW,2BAA2B,CAAC;EAChF,iBAAiB,OAAO;EACxB,KAAK,MAAM,UAAU,SAAS;GAC7B,IAAI,UAAU,iBAAiB;GAC/B,MAAM,YAAY,WAAW,SAAS,WAAW;GACjD,IAAI,cAAc,KAAA,GAAW;GAC7B,OAAO,KAAK,SAAS;GACrB,IAAI,OAAO,WAAW,QAAQ;EAC/B;CACD;CACA,OAAO,OAAO,KAAK,EAAE;AACtB"}

package/dist/utils/vue/emits.d.ts

@@ -0,0 +1,23 @@
+import type { ComputedRef } from "vue";
+/** Vue Emits 对象中允许的校验器形状。 */
+type EmitValidator = ((...arguments_: never[]) => unknown) | null;
+/** 事件名到可选参数校验器的内部映射。 */
+type EmitsOptions = Record<string, EmitValidator>;
+/** 从校验器中提取事件参数；无校验器时保留未知参数。 */
+type EventArguments<Validator> = Validator extends (...arguments_: infer Arguments) => unknown ? Arguments : unknown[];
+/** 在类型层递归把 kebab-case 事件名转换为 PascalCase。 */
+type PascalEventName<Value extends string> = Value extends `${infer Head}-${infer Tail}` ? `${Capitalize<Head>}${PascalEventName<Tail>}` : Capitalize<Value>;
+/** 把事件配置映射为 Vue `onXxx` 属性。 */
+export type EmitHandlers<Emits extends EmitsOptions> = {
+    [Name in keyof Emits as Name extends string ? `on${PascalEventName<Name>}` : never]: (...arguments_: EventArguments<Emits[Name]>) => void;
+};
+/**
+ * 构建响应式 Vue 事件处理器。
+ *
+ * @param emits - Vue emits 配置对象。
+ * @param emit - `setup` 上下文提供的 emit 函数。
+ * @param ignoredEvents - 不需要向子组件透传的事件名。
+ * @returns 随配置重新计算的事件处理器对象。
+ */
+export declare function useEmits<Emits extends EmitsOptions>(emits: Emits, emit: (...arguments_: never[]) => unknown, ignoredEvents?: readonly (keyof Emits)[]): ComputedRef<Partial<EmitHandlers<Emits>>>;
+export {};

package/dist/utils/vue/emits.mjs

@@ -0,0 +1,47 @@
+import { computed } from "vue";
+//#region src/utils/vue/emits.ts
+/**
+* 把事件名转换为 Vue Handler Prop 名称。
+*
+* @param eventName - Emits 对象中的原始事件名，可使用 kebab-case。
+* @returns `onPascalCase` 形式的属性名。
+* @throws `TypeError` 当事件名包含空片段或无法生成有效 Handler 名称。
+*/
+const toHandlerName = (eventName) => {
+	return `on${eventName.split("-").map((part) => part.charAt(0).toUpperCase() + part.slice(1)).join("")}`;
+};
+/**
+* 构建响应式 Vue 事件处理器。
+*
+* @param emits - Vue emits 配置对象。
+* @param emit - `setup` 上下文提供的 emit 函数。
+* @param ignoredEvents - 不需要向子组件透传的事件名。
+* @returns 随配置重新计算的事件处理器对象。
+*/
+function useEmits(emits, emit, ignoredEvents = []) {
+	const ignored = new Set(ignoredEvents);
+	const emitEvent = emit;
+	return computed(() => {
+		const handlers = {};
+		const handlerNames = /* @__PURE__ */ new Set();
+		for (const eventName of Object.keys(emits)) {
+			if (ignored.has(eventName)) continue;
+			if (eventName.length === 0 || /\s/u.test(eventName)) throw new TypeError(`无效的 Vue 事件名称：“${eventName}”。`);
+			const handlerName = toHandlerName(eventName);
+			if (handlerNames.has(handlerName)) throw new TypeError(`多个 Vue 事件映射到同一处理器属性：“${handlerName}”。`);
+			handlerNames.add(handlerName);
+			Object.defineProperty(handlers, handlerName, {
+				enumerable: true,
+				value: (...arguments_) => {
+					emitEvent(eventName, ...arguments_);
+				},
+				writable: true
+			});
+		}
+		return handlers;
+	});
+}
+//#endregion
+export { useEmits };
+
+//# sourceMappingURL=emits.mjs.map

package/dist/utils/vue/emits.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"emits.mjs","names":[],"sources":["../../../src/utils/vue/emits.ts"],"sourcesContent":["import { computed } from \"vue\";\nimport type { ComputedRef } from \"vue\";\n\n/** Vue Emits 对象中允许的校验器形状。 */\ntype EmitValidator = ((...arguments_: never[]) => unknown) | null;\n/** 事件名到可选参数校验器的内部映射。 */\ntype EmitsOptions = Record<string, EmitValidator>;\n/** 从校验器中提取事件参数；无校验器时保留未知参数。 */\ntype EventArguments<Validator> = Validator extends (...arguments_: infer Arguments) => unknown ? Arguments : unknown[];\n/** 在类型层递归把 kebab-case 事件名转换为 PascalCase。 */\ntype PascalEventName<Value extends string> = Value extends `${infer Head}-${infer Tail}`\n\t? `${Capitalize<Head>}${PascalEventName<Tail>}`\n\t: Capitalize<Value>;\n\n/** 把事件配置映射为 Vue `onXxx` 属性。 */\nexport type EmitHandlers<Emits extends EmitsOptions> = {\n\t[Name in keyof Emits as Name extends string ? `on${PascalEventName<Name>}` : never]: (...arguments_: EventArguments<Emits[Name]>) => void;\n};\n\n/**\n * 把事件名转换为 Vue Handler Prop 名称。\n *\n * @param eventName - Emits 对象中的原始事件名，可使用 kebab-case。\n * @returns `onPascalCase` 形式的属性名。\n * @throws `TypeError` 当事件名包含空片段或无法生成有效 Handler 名称。\n */\nconst toHandlerName = (eventName: string): string => {\n\treturn `on${eventName\n\t\t.split(\"-\")\n\t\t.map((part) => part.charAt(0).toUpperCase() + part.slice(1))\n\t\t.join(\"\")}`;\n};\n\n/**\n * 构建响应式 Vue 事件处理器。\n *\n * @param emits - Vue emits 配置对象。\n * @param emit - `setup` 上下文提供的 emit 函数。\n * @param ignoredEvents - 不需要向子组件透传的事件名。\n * @returns 随配置重新计算的事件处理器对象。\n */\nexport function useEmits<Emits extends EmitsOptions>(\n\temits: Emits,\n\temit: (...arguments_: never[]) => unknown,\n\tignoredEvents: readonly (keyof Emits)[] = []\n): ComputedRef<Partial<EmitHandlers<Emits>>> {\n\tconst ignored = new Set<PropertyKey>(ignoredEvents);\n\tconst emitEvent = emit as unknown as (eventName: string, ...arguments_: unknown[]) => void;\n\treturn computed<Partial<EmitHandlers<Emits>>>(() => {\n\t\tconst handlers = {} as Partial<EmitHandlers<Emits>>;\n\t\tconst handlerNames = new Set<string>();\n\t\tfor (const eventName of Object.keys(emits)) {\n\t\t\tif (ignored.has(eventName)) continue;\n\t\t\tif (eventName.length === 0 || /\\s/u.test(eventName)) throw new TypeError(`无效的 Vue 事件名称：“${eventName}”。`);\n\t\t\tconst handlerName = toHandlerName(eventName);\n\t\t\tif (handlerNames.has(handlerName)) {\n\t\t\t\tthrow new TypeError(`多个 Vue 事件映射到同一处理器属性：“${handlerName}”。`);\n\t\t\t}\n\t\t\thandlerNames.add(handlerName);\n\t\t\tObject.defineProperty(handlers, handlerName, {\n\t\t\t\tenumerable: true,\n\t\t\t\tvalue: (...arguments_: unknown[]): void => {\n\t\t\t\t\temitEvent(eventName, ...arguments_);\n\t\t\t\t},\n\t\t\t\twritable: true,\n\t\t\t});\n\t\t}\n\t\treturn handlers;\n\t});\n}\n"],"mappings":";;;;;;;;;AA0BA,MAAM,iBAAiB,cAA8B;CACpD,OAAO,KAAK,UACV,MAAM,GAAG,CAAC,CACV,KAAK,SAAS,KAAK,OAAO,CAAC,CAAC,CAAC,YAAY,IAAI,KAAK,MAAM,CAAC,CAAC,CAAC,CAC3D,KAAK,EAAE;AACV;;;;;;;;;AAUA,SAAgB,SACf,OACA,MACA,gBAA0C,CAAC,GACC;CAC5C,MAAM,UAAU,IAAI,IAAiB,aAAa;CAClD,MAAM,YAAY;CAClB,OAAO,eAA6C;EACnD,MAAM,WAAW,CAAC;EAClB,MAAM,+BAAe,IAAI,IAAY;EACrC,KAAK,MAAM,aAAa,OAAO,KAAK,KAAK,GAAG;GAC3C,IAAI,QAAQ,IAAI,SAAS,GAAG;GAC5B,IAAI,UAAU,WAAW,KAAK,MAAM,KAAK,SAAS,GAAG,MAAM,IAAI,UAAU,iBAAiB,UAAU,GAAG;GACvG,MAAM,cAAc,cAAc,SAAS;GAC3C,IAAI,aAAa,IAAI,WAAW,GAC/B,MAAM,IAAI,UAAU,wBAAwB,YAAY,GAAG;GAE5D,aAAa,IAAI,WAAW;GAC5B,OAAO,eAAe,UAAU,aAAa;IAC5C,YAAY;IACZ,QAAQ,GAAG,eAAgC;KAC1C,UAAU,WAAW,GAAG,UAAU;IACnC;IACA,UAAU;GACX,CAAC;EACF;EACA,OAAO;CACR,CAAC;AACF"}

package/dist/utils/vue/expose.d.ts

@@ -0,0 +1,8 @@
+/**
+ * 同时暴露组件实例能力并返回同一个对象，便于 `setup` 返回状态供 Vue Devtools 查看。
+ *
+ * @param expose - `setup` 上下文提供的 expose 函数。
+ * @param exposed - 需要暴露的状态和方法。
+ * @returns 原始 exposed 对象。
+ */
+export declare function useExpose<Exposed extends object>(expose: (exposed?: Exposed) => void, exposed: Exposed): Exposed;

package/dist/utils/vue/expose.mjs

@@ -0,0 +1,16 @@
+//#region src/utils/vue/expose.ts
+/**
+* 同时暴露组件实例能力并返回同一个对象，便于 `setup` 返回状态供 Vue Devtools 查看。
+*
+* @param expose - `setup` 上下文提供的 expose 函数。
+* @param exposed - 需要暴露的状态和方法。
+* @returns 原始 exposed 对象。
+*/
+function useExpose(expose, exposed) {
+	expose(exposed);
+	return exposed;
+}
+//#endregion
+export { useExpose };
+
+//# sourceMappingURL=expose.mjs.map

package/dist/utils/vue/expose.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"expose.mjs","names":[],"sources":["../../../src/utils/vue/expose.ts"],"sourcesContent":["/**\n * 同时暴露组件实例能力并返回同一个对象，便于 `setup` 返回状态供 Vue Devtools 查看。\n *\n * @param expose - `setup` 上下文提供的 expose 函数。\n * @param exposed - 需要暴露的状态和方法。\n * @returns 原始 exposed 对象。\n */\nexport function useExpose<Exposed extends object>(expose: (exposed?: Exposed) => void, exposed: Exposed): Exposed {\n\texpose(exposed);\n\treturn exposed;\n}\n"],"mappings":";;;;;;;;AAOA,SAAgB,UAAkC,QAAqC,SAA2B;CACjH,OAAO,OAAO;CACd,OAAO;AACR"}

package/dist/utils/vue/func.d.ts

@@ -0,0 +1,10 @@
+/** 可同步或异步返回结果的函数。 */
+export type AwaitableFunction<Arguments extends readonly unknown[], Result> = (...arguments_: Arguments) => Result | PromiseLike<Result>;
+/**
+ * 统一执行同步或异步函数，异常保持原样向调用方传播。
+ *
+ * @param function_ - 可选的待执行函数。
+ * @param arguments_ - 原样传入函数的参数。
+ * @returns 函数结果；未传函数时返回 `undefined`。
+ */
+export declare function callOptionalFunction<Arguments extends readonly unknown[], Result>(function_: AwaitableFunction<Arguments, Result> | null | undefined, ...arguments_: Arguments): Promise<Awaited<Result> | undefined>;

package/dist/utils/vue/func.mjs

@@ -0,0 +1,16 @@
+//#region src/utils/vue/func.ts
+/**
+* 统一执行同步或异步函数，异常保持原样向调用方传播。
+*
+* @param function_ - 可选的待执行函数。
+* @param arguments_ - 原样传入函数的参数。
+* @returns 函数结果；未传函数时返回 `undefined`。
+*/
+async function callOptionalFunction(function_, ...arguments_) {
+	if (function_ === null || function_ === void 0) return void 0;
+	return Promise.resolve(function_(...arguments_));
+}
+//#endregion
+export { callOptionalFunction };
+
+//# sourceMappingURL=func.mjs.map

package/dist/utils/vue/func.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"func.mjs","names":[],"sources":["../../../src/utils/vue/func.ts"],"sourcesContent":["/** 可同步或异步返回结果的函数。 */\nexport type AwaitableFunction<Arguments extends readonly unknown[], Result> = (...arguments_: Arguments) => Result | PromiseLike<Result>;\n\n/**\n * 统一执行同步或异步函数，异常保持原样向调用方传播。\n *\n * @param function_ - 可选的待执行函数。\n * @param arguments_ - 原样传入函数的参数。\n * @returns 函数结果；未传函数时返回 `undefined`。\n */\nexport async function callOptionalFunction<Arguments extends readonly unknown[], Result>(\n\tfunction_: AwaitableFunction<Arguments, Result> | null | undefined,\n\t...arguments_: Arguments\n): Promise<Awaited<Result> | undefined> {\n\tif (function_ === null || function_ === undefined) return undefined;\n\treturn Promise.resolve(function_(...arguments_));\n}\n"],"mappings":";;;;;;;;AAUA,eAAsB,qBACrB,WACA,GAAG,YACoC;CACvC,IAAI,cAAc,QAAQ,cAAc,KAAA,GAAW,OAAO,KAAA;CAC1D,OAAO,QAAQ,QAAQ,UAAU,GAAG,UAAU,CAAC;AAChD"}