fast-element-plus 1.0.21 → 2.0.1

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":"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"}

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"}

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

@@ -0,0 +1,13 @@
+/**
+ * Fast.Element.Plus 内部使用的 Vue 3 工具。
+ *
+ * @packageDocumentation
+ */
+export * from "./emits";
+export * from "./expose";
+export * from "./func";
+export * from "./install";
+export * from "./props";
+export * from "./render";
+export * from "./slots";
+export * from "./with";

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

@@ -0,0 +1,47 @@
+import type { App } from "vue";
+/** Vue 组件对象、函数组件或指令对象可接受的最小结构类型。 */
+export type VueInstallValue = object | ((...arguments_: never[]) => unknown);
+/** 为 Vue 组件或指令附加供 Vue 3 `app.use()` 调用的安装能力。 */
+export type Installable<Value> = Value & {
+    /**
+     * 把当前组件或指令安装到 Vue 3 App。
+     * @param app - Vue 3 App 实例。
+     */
+    install: (app: App) => void;
+};
+/** TSX 组件安装类型；与 {@link Installable} 保持同一运行时契约。 */
+export type TSXWithInstall<Value> = Installable<Value>;
+/**
+ * 为主组件附加 Vue 3 `app.use()` 安装能力。
+ *
+ * @remarks 函数会直接为 `main` 定义附属组件属性和 `install`。所有组件名称、附属属性
+ * 冲突会在修改 `main` 前完成校验；安装到 App 时也会先预检全部全局名称，再统一注册。
+ * @param main - 具有非空 `name` 的组件。
+ * @param extras - 同时注册并以可枚举属性挂到主组件的附属组件映射。
+ * @returns 原始 `main` 引用，并附加类型化的 `install` 与 `extras` 属性。
+ * @throws `TypeError` 当组件缺少合法名称、已有 `install`、附属键或名称发生冲突。
+ * @throws `Error` 当 App 中同名位置已经注册其他组件。
+ */
+export declare function withInstall<Main extends VueInstallValue, Extras extends Record<string, VueInstallValue> = Record<never, never>>(main: Main, extras?: Extras): Installable<Main> & Extras;
+/**
+ * 为不需要单独注册的附属组件附加空安装函数。
+ *
+ * @remarks 适用于只能作为主组件附属属性使用、但仍需满足 Vue Plugin 类型的组件。
+ * 函数直接修改并返回传入组件，不会向 Vue 3 App 注册内容。
+ * @param component - 尚未定义或继承 `install` 属性的组件。
+ * @returns 原组件引用及无副作用的 `install` 方法。
+ * @throws `TypeError` 当组件自身或原型链已经存在 `install`。
+ */
+export declare function withNoopInstall<Value extends VueInstallValue>(component: Value): TSXWithInstall<Value>;
+/**
+ * 为 Vue 3 指令附加插件安装能力。
+ *
+ * @remarks 函数直接修改并返回指令。安装时重复注册同一引用保持幂等，不会覆盖同名的
+ * 其他指令。名称只传给 `directive()`，不得包含 `v-` 前缀。
+ * @param directive - 尚未定义或继承 `install` 属性的 Vue 指令对象。
+ * @param name - 非空、无空白且不以 `v-` 开头的全局指令名。
+ * @returns 原指令引用及 Vue Plugin `install` 方法。
+ * @throws `TypeError` 当名称非法、指令已有 `install`，或安装目标无效。
+ * @throws `Error` 当 App 中同名位置已经注册其他指令。
+ */
+export declare function withInstallDirective<Value extends VueInstallValue>(directive: Value, name: string): Installable<Value>;

package/dist/utils/vue/install.mjs

@@ -0,0 +1,123 @@
+//#region src/utils/vue/install.ts
+/**
+* 校验 Vue 3 插件安装目标。
+*
+* @param value - Vue 3 App 实例。
+* @returns 只包含组件和指令注册能力的 App。
+* @throws `TypeError` 当目标不是对象或缺少 `component`、`directive` 方法。
+*/
+const assertApp = (value) => {
+	if (typeof value !== "object" || value === null) throw new TypeError("安装 Vue 插件需要 Vue 3 App 实例。");
+	const app = value;
+	if (typeof app.component !== "function" || typeof app.directive !== "function") throw new TypeError("安装 Vue 插件需要 `component()` 和 `directive()` 注册方法。");
+	return app;
+};
+/**
+* 提取组件的全局注册名称。
+*
+* @param component - 待注册组件。
+* @returns 经过校验的显式名称。
+* @throws `TypeError` 当组件没有非空字符串名称，或名称包含空白。
+*/
+const getComponentName = (component) => {
+	const name = component.name;
+	if (typeof name !== "string" || name.length === 0 || /\s/u.test(name)) throw new TypeError("可安装的 Vue 组件必须公开不含空白的非空名称。");
+	return name;
+};
+/**
+* 预检单个组件注册。
+*
+* @remarks 先读取同名组件并完成冲突判断，再返回延迟执行动作；调用方可以在所有组件预检通过后统一提交。
+* @param app - 已校验的 Vue 3 App 注册目标。
+* @param component - 待注册组件。
+* @returns 已校验的组件引用、名称和目标中是否已经存在同一引用。
+* @throws `Error` 当同名位置已由其他组件占用。
+*/
+const prepareComponentRegistration = (app, component) => {
+	const name = getComponentName(component);
+	const existing = app.component(name);
+	if (existing !== void 0 && existing !== component) throw new Error(`Vue 组件名称“${name}”已被其他组件注册。`);
+	return {
+		component,
+		name,
+		registered: existing === component
+	};
+};
+/**
+* 为主组件附加 Vue 3 `app.use()` 安装能力。
+*
+* @remarks 函数会直接为 `main` 定义附属组件属性和 `install`。所有组件名称、附属属性
+* 冲突会在修改 `main` 前完成校验；安装到 App 时也会先预检全部全局名称，再统一注册。
+* @param main - 具有非空 `name` 的组件。
+* @param extras - 同时注册并以可枚举属性挂到主组件的附属组件映射。
+* @returns 原始 `main` 引用，并附加类型化的 `install` 与 `extras` 属性。
+* @throws `TypeError` 当组件缺少合法名称、已有 `install`、附属键或名称发生冲突。
+* @throws `Error` 当 App 中同名位置已经注册其他组件。
+*/
+function withInstall(main, extras) {
+	const componentNames = /* @__PURE__ */ new Set([getComponentName(main)]);
+	if ("install" in Object(main)) throw new TypeError("Vue 组件已定义 `install` 属性。");
+	const extraEntries = Object.entries(extras ?? {});
+	if (extras !== void 0 && Object.getOwnPropertySymbols(extras).some((key) => Object.prototype.propertyIsEnumerable.call(extras, key))) throw new TypeError("Vue 组件附属项必须使用字符串属性名。");
+	for (const [key, component] of extraEntries) {
+		const componentName = getComponentName(component);
+		if (componentNames.has(componentName)) throw new TypeError(`Vue 组件名称“${componentName}”被重复注册。`);
+		componentNames.add(componentName);
+		if (key === "install" || key in Object(main)) throw new TypeError(`Vue 组件附属项“${key}”会覆盖主组件上的属性。`);
+	}
+	const installable = main;
+	for (const [key, component] of extraEntries) Object.defineProperty(installable, key, {
+		configurable: true,
+		enumerable: true,
+		value: component,
+		writable: true
+	});
+	installable.install = (value) => {
+		const app = assertApp(value);
+		const registrations = [main, ...extraEntries.map(([, component]) => component)].map((component) => prepareComponentRegistration(app, component));
+		for (const registration of registrations) if (!registration.registered) app.component(registration.name, registration.component);
+	};
+	return installable;
+}
+/**
+* 为不需要单独注册的附属组件附加空安装函数。
+*
+* @remarks 适用于只能作为主组件附属属性使用、但仍需满足 Vue Plugin 类型的组件。
+* 函数直接修改并返回传入组件，不会向 Vue 3 App 注册内容。
+* @param component - 尚未定义或继承 `install` 属性的组件。
+* @returns 原组件引用及无副作用的 `install` 方法。
+* @throws `TypeError` 当组件自身或原型链已经存在 `install`。
+*/
+function withNoopInstall(component) {
+	if ("install" in Object(component)) throw new TypeError("Vue 组件已定义 `install` 属性。");
+	const installable = component;
+	installable.install = () => void 0;
+	return installable;
+}
+/**
+* 为 Vue 3 指令附加插件安装能力。
+*
+* @remarks 函数直接修改并返回指令。安装时重复注册同一引用保持幂等，不会覆盖同名的
+* 其他指令。名称只传给 `directive()`，不得包含 `v-` 前缀。
+* @param directive - 尚未定义或继承 `install` 属性的 Vue 指令对象。
+* @param name - 非空、无空白且不以 `v-` 开头的全局指令名。
+* @returns 原指令引用及 Vue Plugin `install` 方法。
+* @throws `TypeError` 当名称非法、指令已有 `install`，或安装目标无效。
+* @throws `Error` 当 App 中同名位置已经注册其他指令。
+*/
+function withInstallDirective(directive, name) {
+	if (name.length === 0 || /\s/u.test(name) || name.startsWith("v-")) throw new TypeError("可安装的 Vue 指令名称不能包含空白或 `v-` 前缀。");
+	if ("install" in Object(directive)) throw new TypeError("Vue 指令已定义 `install` 属性。");
+	const installable = directive;
+	installable.install = (value) => {
+		const app = assertApp(value);
+		const existing = app.directive(name);
+		if (existing !== void 0 && existing !== directive) throw new Error(`Vue 指令名称“${name}”已被其他指令注册。`);
+		if (existing !== directive) app.directive(name, directive);
+	};
+	return installable;
+}
+//#endregion
+export { withInstall, withInstallDirective, withNoopInstall };
+
+//# sourceMappingURL=install.mjs.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"install.mjs","names":[],"sources":["../../../src/utils/vue/install.ts"],"sourcesContent":["import type { App } from \"vue\";\n\n/** Vue 组件对象、函数组件或指令对象可接受的最小结构类型。 */\nexport type VueInstallValue = object | ((...arguments_: never[]) => unknown);\n\n/** 为 Vue 组件或指令附加供 Vue 3 `app.use()` 调用的安装能力。 */\nexport type Installable<Value> = Value & {\n\t/**\n\t * 把当前组件或指令安装到 Vue 3 App。\n\t * @param app - Vue 3 App 实例。\n\t */\n\tinstall: (app: App) => void;\n};\n\n/** TSX 组件安装类型；与 {@link Installable} 保持同一运行时契约。 */\nexport type TSXWithInstall<Value> = Installable<Value>;\n\n/** 组件、指令注册所需的 Vue 3 App 能力。 */\ninterface VueAppRegistrationTarget {\n\t/**\n\t * 读取或注册全局组件。\n\t *\n\t * @param name - 全局组件名。\n\t * @param component - 注册时传入的组件；省略时读取现有组件。\n\t * @returns Vue App 返回的现有组件、注册结果或 App 自身。\n\t */\n\tcomponent: (name: string, component?: unknown) => unknown;\n\t/**\n\t * 读取或注册全局指令。\n\t *\n\t * @param name - 不带 `v-` 的全局指令名。\n\t * @param directive - 注册时传入的指令；省略时读取现有指令。\n\t * @returns Vue App 返回的现有指令、注册结果或 App 自身。\n\t */\n\tdirective: (name: string, directive?: unknown) => unknown;\n}\n\n/**\n * 校验 Vue 3 插件安装目标。\n *\n * @param value - Vue 3 App 实例。\n * @returns 只包含组件和指令注册能力的 App。\n * @throws `TypeError` 当目标不是对象或缺少 `component`、`directive` 方法。\n */\nconst assertApp = (value: App): VueAppRegistrationTarget => {\n\tif (typeof value !== \"object\" || value === null) {\n\t\tthrow new TypeError(\"安装 Vue 插件需要 Vue 3 App 实例。\");\n\t}\n\tconst app = value as unknown as Partial<VueAppRegistrationTarget>;\n\tif (typeof app.component !== \"function\" || typeof app.directive !== \"function\") {\n\t\tthrow new TypeError(\"安装 Vue 插件需要 `component()` 和 `directive()` 注册方法。\");\n\t}\n\treturn app as VueAppRegistrationTarget;\n};\n\n/**\n * 提取组件的全局注册名称。\n *\n * @param component - 待注册组件。\n * @returns 经过校验的显式名称。\n * @throws `TypeError` 当组件没有非空字符串名称，或名称包含空白。\n */\nconst getComponentName = (component: VueInstallValue): string => {\n\tconst name = (component as { name?: unknown }).name;\n\tif (typeof name !== \"string\" || name.length === 0 || /\\s/u.test(name)) {\n\t\tthrow new TypeError(\"可安装的 Vue 组件必须公开不含空白的非空名称。\");\n\t}\n\treturn name;\n};\n\n/** 预检完成、可以无失败注册的组件动作。 */\ninterface ComponentRegistration {\n\t/** 已校验的组件引用。 */\n\tcomponent: VueInstallValue;\n\t/** 已校验的组件名称。 */\n\tname: string;\n\t/** 目标中是否已经注册了完全相同的组件引用。 */\n\tregistered: boolean;\n}\n\n/**\n * 预检单个组件注册。\n *\n * @remarks 先读取同名组件并完成冲突判断，再返回延迟执行动作；调用方可以在所有组件预检通过后统一提交。\n * @param app - 已校验的 Vue 3 App 注册目标。\n * @param component - 待注册组件。\n * @returns 已校验的组件引用、名称和目标中是否已经存在同一引用。\n * @throws `Error` 当同名位置已由其他组件占用。\n */\nconst prepareComponentRegistration = (app: VueAppRegistrationTarget, component: VueInstallValue): ComponentRegistration => {\n\tconst name = getComponentName(component);\n\tconst existing = app.component(name);\n\tif (existing !== undefined && existing !== component) {\n\t\tthrow new Error(`Vue 组件名称“${name}”已被其他组件注册。`);\n\t}\n\treturn { component, name, registered: existing === component };\n};\n\n/**\n * 为主组件附加 Vue 3 `app.use()` 安装能力。\n *\n * @remarks 函数会直接为 `main` 定义附属组件属性和 `install`。所有组件名称、附属属性\n * 冲突会在修改 `main` 前完成校验；安装到 App 时也会先预检全部全局名称，再统一注册。\n * @param main - 具有非空 `name` 的组件。\n * @param extras - 同时注册并以可枚举属性挂到主组件的附属组件映射。\n * @returns 原始 `main` 引用，并附加类型化的 `install` 与 `extras` 属性。\n * @throws `TypeError` 当组件缺少合法名称、已有 `install`、附属键或名称发生冲突。\n * @throws `Error` 当 App 中同名位置已经注册其他组件。\n */\nexport function withInstall<Main extends VueInstallValue, Extras extends Record<string, VueInstallValue> = Record<never, never>>(\n\tmain: Main,\n\textras?: Extras\n): Installable<Main> & Extras {\n\tconst componentNames = new Set([getComponentName(main)]);\n\tif (\"install\" in Object(main)) throw new TypeError(\"Vue 组件已定义 `install` 属性。\");\n\tconst extraEntries = Object.entries(extras ?? {});\n\tif (extras !== undefined && Object.getOwnPropertySymbols(extras).some((key) => Object.prototype.propertyIsEnumerable.call(extras, key))) {\n\t\tthrow new TypeError(\"Vue 组件附属项必须使用字符串属性名。\");\n\t}\n\tfor (const [key, component] of extraEntries) {\n\t\tconst componentName = getComponentName(component);\n\t\tif (componentNames.has(componentName)) throw new TypeError(`Vue 组件名称“${componentName}”被重复注册。`);\n\t\tcomponentNames.add(componentName);\n\t\tif (key === \"install\" || key in Object(main)) {\n\t\t\tthrow new TypeError(`Vue 组件附属项“${key}”会覆盖主组件上的属性。`);\n\t\t}\n\t}\n\tconst installable = main as Installable<Main> & Extras;\n\tfor (const [key, component] of extraEntries) {\n\t\tObject.defineProperty(installable, key, { configurable: true, enumerable: true, value: component, writable: true });\n\t}\n\tinstallable.install = (value: App): void => {\n\t\tconst app = assertApp(value);\n\t\t// 先完成全部冲突检查，再统一注册，避免安装到一半留下部分全局组件。\n\t\tconst registrations = [main, ...extraEntries.map(([, component]) => component)].map((component) =>\n\t\t\tprepareComponentRegistration(app, component)\n\t\t);\n\t\tfor (const registration of registrations) {\n\t\t\tif (!registration.registered) app.component(registration.name, registration.component);\n\t\t}\n\t};\n\treturn installable;\n}\n\n/**\n * 为不需要单独注册的附属组件附加空安装函数。\n *\n * @remarks 适用于只能作为主组件附属属性使用、但仍需满足 Vue Plugin 类型的组件。\n * 函数直接修改并返回传入组件，不会向 Vue 3 App 注册内容。\n * @param component - 尚未定义或继承 `install` 属性的组件。\n * @returns 原组件引用及无副作用的 `install` 方法。\n * @throws `TypeError` 当组件自身或原型链已经存在 `install`。\n */\nexport function withNoopInstall<Value extends VueInstallValue>(component: Value): TSXWithInstall<Value> {\n\tif (\"install\" in Object(component)) throw new TypeError(\"Vue 组件已定义 `install` 属性。\");\n\tconst installable = component as TSXWithInstall<Value>;\n\tinstallable.install = (): void => undefined;\n\treturn installable;\n}\n\n/**\n * 为 Vue 3 指令附加插件安装能力。\n *\n * @remarks 函数直接修改并返回指令。安装时重复注册同一引用保持幂等，不会覆盖同名的\n * 其他指令。名称只传给 `directive()`，不得包含 `v-` 前缀。\n * @param directive - 尚未定义或继承 `install` 属性的 Vue 指令对象。\n * @param name - 非空、无空白且不以 `v-` 开头的全局指令名。\n * @returns 原指令引用及 Vue Plugin `install` 方法。\n * @throws `TypeError` 当名称非法、指令已有 `install`，或安装目标无效。\n * @throws `Error` 当 App 中同名位置已经注册其他指令。\n */\nexport function withInstallDirective<Value extends VueInstallValue>(directive: Value, name: string): Installable<Value> {\n\tif (name.length === 0 || /\\s/u.test(name) || name.startsWith(\"v-\")) {\n\t\tthrow new TypeError(\"可安装的 Vue 指令名称不能包含空白或 `v-` 前缀。\");\n\t}\n\tif (\"install\" in Object(directive)) throw new TypeError(\"Vue 指令已定义 `install` 属性。\");\n\tconst installable = directive as Installable<Value>;\n\tinstallable.install = (value: App): void => {\n\t\tconst app = assertApp(value);\n\t\tconst existing = app.directive(name);\n\t\tif (existing !== undefined && existing !== directive) {\n\t\t\tthrow new Error(`Vue 指令名称“${name}”已被其他指令注册。`);\n\t\t}\n\t\tif (existing !== directive) app.directive(name, directive);\n\t};\n\treturn installable;\n}\n"],"mappings":"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"}

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

@@ -0,0 +1,19 @@
+import type { ComputedRef, PropType } from "vue";
+/**
+ * 为 Vue 运行时 Props 构造器附加泛型类型。
+ *
+ * @remarks 该函数只帮助 TypeScript 建模，不验证运行时值与 `Value` 一致；调用方仍应
+ * 传入 Vue 支持的构造器或构造器数组。
+ * @param runtimeType - Vue 支持的运行时构造器或构造器数组。
+ * @returns 同一引用，仅在类型层收窄为 `PropType<Value>`。
+ */
+export declare function definePropType<Value>(runtimeType: unknown): PropType<Value>;
+/**
+ * 构建需要透传给子组件的响应式 Props。
+ *
+ * @param props - Vue `setup` 接收的只读响应式 Props 对象。
+ * @param rawProps - 子组件的运行时 Props 配置。
+ * @param ignoredProps - 不需要透传的 Props 名称。
+ * @returns 只包含 `rawProps` 声明键且随 Props 更新的 ComputedRef。
+ */
+export declare function useProps<Props extends object, RawProps extends object, IgnoredProp extends keyof RawProps = never>(props: Props, rawProps: RawProps, ignoredProps?: readonly IgnoredProp[]): ComputedRef<Omit<Pick<Props, Extract<keyof Props, keyof RawProps>>, Extract<IgnoredProp, keyof Props>>>;

package/dist/utils/vue/props.mjs

@@ -0,0 +1,41 @@
+import { computed } from "vue";
+//#region src/utils/vue/props.ts
+/**
+* 为 Vue 运行时 Props 构造器附加泛型类型。
+*
+* @remarks 该函数只帮助 TypeScript 建模，不验证运行时值与 `Value` 一致；调用方仍应
+* 传入 Vue 支持的构造器或构造器数组。
+* @param runtimeType - Vue 支持的运行时构造器或构造器数组。
+* @returns 同一引用，仅在类型层收窄为 `PropType<Value>`。
+*/
+function definePropType(runtimeType) {
+	return runtimeType;
+}
+/**
+* 构建需要透传给子组件的响应式 Props。
+*
+* @param props - Vue `setup` 接收的只读响应式 Props 对象。
+* @param rawProps - 子组件的运行时 Props 配置。
+* @param ignoredProps - 不需要透传的 Props 名称。
+* @returns 只包含 `rawProps` 声明键且随 Props 更新的 ComputedRef。
+*/
+function useProps(props, rawProps, ignoredProps = []) {
+	const ignored = new Set(ignoredProps);
+	return computed(() => {
+		const result = {};
+		for (const key of Reflect.ownKeys(rawProps)) {
+			if (ignored.has(key) || !Object.hasOwn(props, key)) continue;
+			Object.defineProperty(result, key, {
+				configurable: true,
+				enumerable: true,
+				value: Reflect.get(props, key),
+				writable: true
+			});
+		}
+		return result;
+	});
+}
+//#endregion
+export { definePropType, useProps };
+
+//# sourceMappingURL=props.mjs.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"props.mjs","names":[],"sources":["../../../src/utils/vue/props.ts"],"sourcesContent":["import { computed } from \"vue\";\nimport type { ComputedRef, PropType } from \"vue\";\n\n/**\n * 为 Vue 运行时 Props 构造器附加泛型类型。\n *\n * @remarks 该函数只帮助 TypeScript 建模，不验证运行时值与 `Value` 一致；调用方仍应\n * 传入 Vue 支持的构造器或构造器数组。\n * @param runtimeType - Vue 支持的运行时构造器或构造器数组。\n * @returns 同一引用，仅在类型层收窄为 `PropType<Value>`。\n */\nexport function definePropType<Value>(runtimeType: unknown): PropType<Value> {\n\treturn runtimeType as PropType<Value>;\n}\n\n/**\n * 构建需要透传给子组件的响应式 Props。\n *\n * @param props - Vue `setup` 接收的只读响应式 Props 对象。\n * @param rawProps - 子组件的运行时 Props 配置。\n * @param ignoredProps - 不需要透传的 Props 名称。\n * @returns 只包含 `rawProps` 声明键且随 Props 更新的 ComputedRef。\n */\nexport function useProps<Props extends object, RawProps extends object, IgnoredProp extends keyof RawProps = never>(\n\tprops: Props,\n\trawProps: RawProps,\n\tignoredProps: readonly IgnoredProp[] = []\n): ComputedRef<Omit<Pick<Props, Extract<keyof Props, keyof RawProps>>, Extract<IgnoredProp, keyof Props>>> {\n\tconst ignored = new Set<PropertyKey>(ignoredProps);\n\ttype Result = Omit<Pick<Props, Extract<keyof Props, keyof RawProps>>, Extract<IgnoredProp, keyof Props>>;\n\treturn computed<Result>(() => {\n\t\tconst result = {} as Result;\n\t\tfor (const key of Reflect.ownKeys(rawProps)) {\n\t\t\tif (ignored.has(key) || !Object.hasOwn(props, key)) continue;\n\t\t\tObject.defineProperty(result, key, { configurable: true, enumerable: true, value: Reflect.get(props, key), writable: true });\n\t\t}\n\t\treturn result;\n\t});\n}\n"],"mappings":";;;;;;;;;;AAWA,SAAgB,eAAsB,aAAuC;CAC5E,OAAO;AACR;;;;;;;;;AAUA,SAAgB,SACf,OACA,UACA,eAAuC,CAAC,GACkE;CAC1G,MAAM,UAAU,IAAI,IAAiB,YAAY;CAEjD,OAAO,eAAuB;EAC7B,MAAM,SAAS,CAAC;EAChB,KAAK,MAAM,OAAO,QAAQ,QAAQ,QAAQ,GAAG;GAC5C,IAAI,QAAQ,IAAI,GAAG,KAAK,CAAC,OAAO,OAAO,OAAO,GAAG,GAAG;GACpD,OAAO,eAAe,QAAQ,KAAK;IAAE,cAAc;IAAM,YAAY;IAAM,OAAO,QAAQ,IAAI,OAAO,GAAG;IAAG,UAAU;GAAK,CAAC;EAC5H;EACA,OAAO;CACR,CAAC;AACF"}

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

@@ -0,0 +1,8 @@
+import type { VNode } from "vue";
+/**
+ * 在当前 Vue 3 组件实例上安装 TSX 渲染函数。
+ * @remarks `setup` 仍可返回状态对象，因此状态能够显示在 Vue Devtools 中。
+ * @param render - 当前组件的渲染函数。
+ * @throws 不在组件 `setup` 调用栈中使用时抛出 `Error`。
+ */
+export declare function useRender(render: () => VNode): void;

package/dist/utils/vue/render.mjs

@@ -0,0 +1,17 @@
+import { getCurrentInstance } from "vue";
+//#region src/utils/vue/render.ts
+/**
+* 在当前 Vue 3 组件实例上安装 TSX 渲染函数。
+* @remarks `setup` 仍可返回状态对象，因此状态能够显示在 Vue Devtools 中。
+* @param render - 当前组件的渲染函数。
+* @throws 不在组件 `setup` 调用栈中使用时抛出 `Error`。
+*/
+function useRender(render) {
+	const instance = getCurrentInstance();
+	if (instance === null) throw new Error("`useRender` 必须在 `setup` 函数内部调用。");
+	instance.render = render;
+}
+//#endregion
+export { useRender };
+
+//# sourceMappingURL=render.mjs.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"render.mjs","names":[],"sources":["../../../src/utils/vue/render.ts"],"sourcesContent":["import { getCurrentInstance } from \"vue\";\nimport type { VNode } from \"vue\";\n\n/** `useRender` 需要写入的 Vue 3 内部组件实例字段。 */\ninterface MutableVueComponentInstance {\n\trender?: () => VNode;\n}\n\n/**\n * 在当前 Vue 3 组件实例上安装 TSX 渲染函数。\n * @remarks `setup` 仍可返回状态对象，因此状态能够显示在 Vue Devtools 中。\n * @param render - 当前组件的渲染函数。\n * @throws 不在组件 `setup` 调用栈中使用时抛出 `Error`。\n */\nexport function useRender(render: () => VNode): void {\n\tconst instance = getCurrentInstance();\n\tif (instance === null) throw new Error(\"`useRender` 必须在 `setup` 函数内部调用。\");\n\t(instance as unknown as MutableVueComponentInstance).render = render;\n}\n"],"mappings":";;;;;;;;AAcA,SAAgB,UAAU,QAA2B;CACpD,MAAM,WAAW,mBAAmB;CACpC,IAAI,aAAa,MAAM,MAAM,IAAI,MAAM,iCAAiC;CACxE,SAAqD,SAAS;AAC/D"}

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

@@ -0,0 +1,18 @@
+import type { SlotsType, VNode } from "vue";
+/** Slot 名到 Props 类型的内部声明映射。 */
+type RawSlots = Record<string, unknown>;
+/** 根据 Slot Props 是否为 never 生成无参数或有参数的 Slot 签名。 */
+type VueSlot<Properties> = [Properties] extends [never] ? () => VNode[] : (properties: Properties) => VNode[];
+/** 把 Slot 名称与作用域参数映射为 Vue 3 Slot 函数。 */
+export type TypedSlots<Slots extends RawSlots> = {
+    [Name in keyof Slots]: VueSlot<Slots[Name]>;
+};
+/** Vue 3 `slots` 选项接受的运行时声明与官方静态类型标记。 */
+export type TypedSlotsDeclaration<Slots extends RawSlots> = SlotsType<Partial<TypedSlots<Slots>>>;
+/**
+ * 为 Options API 的 `slots` 选项创建带作用域参数的类型声明。
+ *
+ * @returns 运行时 `Object` 构造器，并携带仅供 TypeScript 使用的 Slot 类型标记。
+ */
+export declare function makeSlots<Slots extends RawSlots>(): TypedSlotsDeclaration<Slots>;
+export {};