fast-element-plus 1.0.21 → 2.0.0

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 {};

package/dist/utils/vue/slots.mjs

@@ -0,0 +1,13 @@
+//#region src/utils/vue/slots.ts
+/**
+* 为 Options API 的 `slots` 选项创建带作用域参数的类型声明。
+*
+* @returns 运行时 `Object` 构造器，并携带仅供 TypeScript 使用的 Slot 类型标记。
+*/
+function makeSlots() {
+	return Object;
+}
+//#endregion
+export { makeSlots };
+
+//# sourceMappingURL=slots.mjs.map

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

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

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

@@ -0,0 +1,8 @@
+/**
+ * 保留传入值并显式指定其 TypeScript 类型。
+ *
+ * @remarks 未传值时运行时结果为 `undefined`，仅适合为 reactive 对象的初始字段提供类型。
+ * @param data - 可选的原始值。
+ * @returns 传入值本身；省略时返回类型化的 `undefined`。
+ */
+export declare function withDefineType<Value>(data?: Value): Value;

package/dist/utils/vue/with.mjs

@@ -0,0 +1,15 @@
+//#region src/utils/vue/with.ts
+/**
+* 保留传入值并显式指定其 TypeScript 类型。
+*
+* @remarks 未传值时运行时结果为 `undefined`，仅适合为 reactive 对象的初始字段提供类型。
+* @param data - 可选的原始值。
+* @returns 传入值本身；省略时返回类型化的 `undefined`。
+*/
+function withDefineType(data) {
+	return data;
+}
+//#endregion
+export { withDefineType };
+
+//# sourceMappingURL=with.mjs.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"with.mjs","names":[],"sources":["../../../src/utils/vue/with.ts"],"sourcesContent":["/**\n * 保留传入值并显式指定其 TypeScript 类型。\n *\n * @remarks 未传值时运行时结果为 `undefined`，仅适合为 reactive 对象的初始字段提供类型。\n * @param data - 可选的原始值。\n * @returns 传入值本身；省略时返回类型化的 `undefined`。\n */\nexport function withDefineType<Value>(data?: Value): Value {\n\treturn data as Value;\n}\n"],"mappings":";;;;;;;;AAOA,SAAgB,eAAsB,MAAqB;CAC1D,OAAO;AACR"}

package/dist/version.d.ts

@@ -0,0 +1,2 @@
+/** 当前 Fast.Element.Plus 包版本，发布时必须与 package.json 保持一致。 */
+export declare const version = "2.0.0";

package/dist/version.mjs

@@ -0,0 +1,7 @@
+//#region src/version.ts
+/** 当前 Fast.Element.Plus 包版本，发布时必须与 package.json 保持一致。 */
+const version = "2.0.0";
+//#endregion
+export { version };
+
+//# sourceMappingURL=version.mjs.map

package/dist/version.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"version.mjs","names":[],"sources":["../src/version.ts"],"sourcesContent":["/** 当前 Fast.Element.Plus 包版本，发布时必须与 package.json 保持一致。 */\nexport const version = \"2.0.0\";\n"],"mappings":";;AACA,MAAa,UAAU"}

package/package.json

@@ -1,10 +1,11 @@
 {
 	"name": "fast-element-plus",
-	"version": "1.0.21",
-	"description": "Fast 组件库.",
+	"version": "2.0.0",
+	"description": "Typed Vue 3 components, directives, and hooks built on Element Plus.",
 	"type": "module",
 	"keywords": [
 		"fast-element-plus",
+		"element-plus",
 		"fast",
 		"typescript",
 		"component library",
@@ -16,126 +17,115 @@
 	"license": "Apache-2.0",
 	"homepage": "https://fastdotnet.com",
 	"bugs": {
-		"url": "https://gitee.com/FastDotnet/Fast.Element.Plus/issues"
+		"url": "https://gitee.com/FastDotnet/fast.element.plus/issues"
 	},
 	"repository": {
 		"type": "git",
-		"url": "https://gitee.com/FastDotnet/Fast.Element.Plus"
+		"url": "https://gitee.com/FastDotnet/fast.element.plus"
 	},
 	"author": "小方",
 	"files": [
-		"./Fast.png",
-		"./LICENSE",
-		"./README.md",
-		"./README.zh.md",
-		"./dist",
-		"./es",
-		"./global.d.ts",
-		"./lib",
-		"./styles",
-		"./types"
+		"CHANGELOG.md",
+		"CONTRIBUTING.md",
+		"Fast.png",
+		"LICENSE",
+		"README.md",
+		"README.zh.md",
+		"SECURITY.md",
+		"dist"
 	],
-	"main": "lib/index.js",
-	"module": "es/index.mjs",
-	"types": "es/index.d.ts",
+	"main": "./dist/index.mjs",
+	"module": "./dist/index.mjs",
+	"types": "./dist/index.d.ts",
 	"exports": {
 		".": {
-			"types": "./es/index.d.ts",
-			"require": "./lib/index.js",
-			"import": "./es/index.mjs"
+			"types": "./dist/index.d.ts",
+			"import": "./dist/index.mjs",
+			"default": "./dist/index.mjs"
 		},
 		"./global": {
-			"types": "./global.d.ts"
+			"types": "./dist/global.d.ts",
+			"import": "./dist/global.mjs",
+			"default": "./dist/global.mjs"
 		},
-		"./es": {
-			"types": "./es/index.d.ts",
-			"import": "./es/index.mjs"
-		},
-		"./lib": {
-			"types": "./lib/index.d.ts",
-			"require": "./lib/index.js"
-		},
-		"./es/*.mjs": {
-			"types": "./es/*.d.ts",
-			"import": "./es/*.mjs"
-		},
-		"./es/*": {
-			"types": [
-				"./es/*.d.ts",
-				"./es/*/index.d.ts"
-			],
-			"import": "./es/*.mjs"
-		},
-		"./lib/*.js": {
-			"types": "./lib/*.d.ts",
-			"require": "./lib/*.js"
-		},
-		"./lib/*": {
-			"types": [
-				"./lib/*.d.ts",
-				"./lib/*/index.d.ts"
-			],
-			"require": "./lib/*.js"
-		},
-		"./*": "./*"
+		"./style.css": "./dist/index.css"
 	},
-	"style": "dist/index.css",
-	"sideEffects": false,
-	"unpkg": "dist/index.iife.min.js",
-	"jsdelivr": "dist/index.iife.min.js",
+	"sideEffects": [
+		"./dist/index.css"
+	],
+	"style": "./dist/index.css",
+	"unpkg": "./dist/index.global.min.js",
+	"jsdelivr": "./dist/index.global.min.js",
 	"publishConfig": {
 		"access": "public"
 	},
+	"scripts": {
+		"dev": "tsdown --watch",
+		"docs:dev": "vitepress dev docs",
+		"build": "tsdown && pnpm run typegen && pnpm run build:styles",
+		"docs:build": "vitepress build docs",
+		"docs:preview": "vitepress preview docs",
+		"build:styles": "sass styles/index.scss dist/index.css --style=compressed --source-map --embed-sources",
+		"typegen": "tsc",
+		"typecheck": "tsc --noEmit",
+		"lint": "eslint . --max-warnings 0",
+		"lint:fix": "eslint . --fix",
+		"format": "prettier --write .",
+		"format:check": "prettier --check .",
+		"test": "pnpm run build && pnpm run test:types && pnpm run test:runtime && pnpm run test:package",
+		"test:types": "tsc --noEmit --project tests/tsconfig.json",
+		"test:runtime": "node --test tests/runtime.test.mjs",
+		"test:package": "node --test tests/package.test.mjs && publint --strict --pack npm",
+		"check": "pnpm run typecheck && pnpm run lint && pnpm run test && pnpm run format:check",
+		"prepack": "pnpm run check"
+	},
 	"peerDependencies": {
-		"@element-plus/icons-vue": "^2.3",
-		"@fast-china/utils": "^1",
-		"@fast-element-plus/icons-vue": "^1",
-		"element-plus": "^2",
-		"vue": "^3.5"
+		"@element-plus/icons-vue": "^2.3.2",
+		"@fast-element-plus/icons-vue": "^2.0.0",
+		"element-plus": "^2.14.5",
+		"vue": "^3.5.41"
 	},
 	"dependencies": {
-		"@vueuse/core": "^14",
-		"decimal.js": "^10",
-		"lodash": "^4.18",
-		"lodash-es": "^4.18",
-		"lodash-unified": "^1",
-		"screenfull": "^6",
-		"sortablejs": "^1.15"
+		"@vueuse/core": "^14.4.0",
+		"csstype": "^3.2.3",
+		"decimal.js": "^10.6.0",
+		"lodash": "^4.18.1",
+		"lodash-es": "^4.18.1",
+		"lodash-unified": "^1.0.3",
+		"screenfull": "^6.0.2",
+		"sortablejs": "^1.15.7"
 	},
 	"devDependencies": {
-		"@element-plus/icons-vue": "^2.3",
-		"@fast-china/eslint-config": "^1",
-		"@fast-china/utils": "^1",
-		"@fast-element-plus/icons-vue": "^1",
-		"@rollup/plugin-terser": "^1",
-		"@types/lodash": "^4.17",
-		"@types/lodash-es": "^4.17",
-		"@types/node": "*",
-		"@types/sortablejs": "^1.15",
-		"@vitejs/plugin-vue": "^6",
-		"@vitejs/plugin-vue-jsx": "^5",
-		"@vue/tsconfig": "^0.9",
-		"element-plus": "^2",
-		"eslint": "^10",
-		"prettier": "^3",
-		"sass": "^1",
-		"terser": "^5",
-		"typescript": "^5",
-		"vite": "^8",
-		"vite-plugin-dts": "^4",
-		"vue": "^3.5",
-		"vue-tsc": "^3"
+		"@element-plus/icons-vue": "^2.3.2",
+		"@eslint/js": "^10.0.1",
+		"@eslint/markdown": "^8.0.3",
+		"@fast-element-plus/icons-vue": "^2.0.0",
+		"@types/lodash": "^4.17.25",
+		"@types/lodash-es": "^4.17.12",
+		"@types/node": "^24.13.3",
+		"@types/sortablejs": "^1.15.9",
+		"dayjs": "^1.11.23",
+		"element-plus": "^2.14.5",
+		"eslint": "^10.9.1",
+		"eslint-config-flat-gitignore": "^2.3.0",
+		"eslint-config-prettier": "^10.1.8",
+		"eslint-plugin-import-x": "^4.17.1",
+		"eslint-plugin-jsonc": "^3.4.2",
+		"eslint-plugin-regexp": "^3.2.0",
+		"globals": "^17.11.0",
+		"prettier": "^3.9.6",
+		"publint": "^0.3.24",
+		"sass": "^1.103.1",
+		"tsdown": "^0.22.14",
+		"tsx": "^4.23.12",
+		"typescript": "^6.0.3",
+		"typescript-eslint": "^8.68.0",
+		"unplugin-vue-jsx": "^0.10.0",
+		"vitepress": "^1.6.4",
+		"vue": "^3.5.41"
 	},
-	"browserslist": {
-		"production": [
-			"> 1%",
-			"not dead",
-			"not op_mini all"
-		],
-		"development": [
-			"last 1 chrome version",
-			"last 1 firefox version",
-			"last 1 safari version"
-		]
+	"engines": {
+		"node": "^22.18.0 || ^24.18.0",
+		"pnpm": "^11.0.0"
 	}
 }