@movk/nuxt 1.1.2 → 1.2.0

package/README.md

@@ -1,6 +1,6 @@
 [![Movk Nuxt](https://nuxt.mhaibaraai.cn/og-image.png)](https://nuxt.mhaibaraai.cn/)
 
-> `@movk/nuxt` 是一个为 Nuxt 4 设计的模块化工程套件，提供 Schema 驱动的自动表单生成、API 集成系统、独立 UI 组件和通用工具函数。
+> Nuxt 4 模块化工程套件 — 基于 Zod v4 的 Schema 驱动自动表单、带认证与进度追踪的 API 集成系统、10+ 独立 UI 组件和通用 Composables。
 
 [![Install MCP in Cursor](https://nuxt.mhaibaraai.cn/mcp/badge.svg)](https://nuxt.mhaibaraai.cn/mcp/deeplink)
 [![Install MCP in VS Code](https://nuxt.mhaibaraai.cn/mcp/badge.svg?ide=vscode)](https://nuxt.mhaibaraai.cn/mcp/deeplink?ide=vscode)
@@ -18,7 +18,7 @@
 
 - **Schema 驱动** - 基于 Zod v4 的声明式表单定义，一份 Schema 同时定义数据结构、验证规则和 UI 配置。
 - **自动化系统** - AutoForm 通过 Schema 自动生成完整表单界面，支持 15+ 种控件类型。
-- **API 集成** - 内置 useApiFetch、useApiAuth、useUploadWithProgress、useDownloadWithProgress，提供多端点支持、自动认证、业务状态码检查、Toast 提示和进度监控。
+- **API 集成** - 内置 useApiFetch、useUploadWithProgress、useDownloadWithProgress，提供多端点支持、自动认证、业务状态码检查、Toast 提示和进度监控。
 - **模块化设计** - 采用分层架构，按需使用 UI 组件、工具函数或全套自动化系统。
 - **独立组件库** - 内置 DatePicker、StarRating、WithCopy 等 10+ 个通用 UI 组件。
 - **类型安全** - 完整的 TypeScript 类型推断，从 Schema 到表单数据。
@@ -67,7 +67,7 @@ export default defineNuxtConfig({
 ```vue
 <script setup lang="ts">
 import type { FormSubmitEvent } from '@nuxt/ui'
-import type { z } from 'zod/v4'
+import type { z } from 'zod'
 
 const { afz } = useAutoForm()
 
@@ -237,29 +237,6 @@ const { data } = await useApiFetch<User>('/users', {
 const { data } = await useApiFetch('/users', { endpoint: 'v2' })
 ```
 
-#### useApiAuth
-
-与 nuxt-auth-utils 集成的认证管理：
-
-```ts
-const { login, clear, loggedIn, user } = useApiAuth()
-
-// 登录
-await login({
-  loginPath: '/auth/login',
-  credentials: { username: 'admin', password: '123456' },
-  userInfoPath: '/auth/me' // 可选，登录后获取用户信息
-})
-
-// 登出
-await clear()
-
-// 响应式状态
-if (loggedIn.value) {
-  console.log('当前用户:', user.value)
-}
-```
-
 #### useUploadWithProgress
 
 带进度监控的文件上传：
@@ -293,7 +270,7 @@ await download('/api/export/report', {
 Movk Nuxt 采用清晰的分层架构:
 
 - **Core Systems** - AutoForm(已发布)
-- **API System** - useApiFetch、useApiAuth,提供完整的 API 请求和认证方案
+- **API System** - useApiFetch、useUploadWithProgress、useDownloadWithProgress，提供完整的 API 请求方案
 - **Standalone Components** - DatePicker、StarRating、WithCopy 等独立 UI 组件
 - **Composables** - useDateFormatter、useAutoForm 等通用组合式函数
 - **Foundation** - 基于 [Nuxt UI](https://ui.nuxt.com)、[Zod v4](https://zod.dev)、[VueUse](https://vueuse.org)
@@ -310,9 +287,8 @@ Movk Nuxt 采用清晰的分层架构:
 ## 🗺️ 开发路线图
 
 - ✅ **AutoForm** - Schema 驱动的表单系统（已发布）
-- ✅ **API System** - API 请求封装和认证管理（已发布）
+- ✅ **API System** - API 请求封装（已发布）
   - useApiFetch、useClientApiFetch - API 请求
-  - useApiAuth - 认证管理
   - useUploadWithProgress、useDownloadWithProgress - 进度监控
 - ✅ **独立组件库** - DatePicker、StarRating、WithCopy 等组件（已发布）
 

package/dist/module.d.mts

@@ -1,5 +1,7 @@
+import * as _nuxt_schema from '@nuxt/schema';
+import { ModuleOptions } from '../dist/runtime/types/index.js';
 export * from '../dist/runtime/types/index.js';
 
-declare const _default: any;
+declare const _default: _nuxt_schema.NuxtModule<ModuleOptions, ModuleOptions, false>;
 
 export { _default as default };

package/dist/module.json

@@ -1,12 +1,12 @@
 {
   "name": "@movk/nuxt",
-  "version": "1.1.2",
+  "version": "1.2.0",
   "configKey": "movk",
   "compatibility": {
-    "nuxt": ">=4.2.0"
+    "nuxt": ">=4.4.2"
   },
   "builder": {
     "@nuxt/module-builder": "1.0.2",
-    "unbuild": "3.6.1"
+    "unbuild": "unknown"
   }
 }

package/dist/module.mjs

@@ -1,52 +1,119 @@
-import { addPlugin, defineNuxtModule, createResolver, addComponentsDir, addImportsDir, addServerHandler } from '@nuxt/kit';
-import { apiToastConfigSchema, apiAuthConfigSchema, apiResponseConfigSchema } from '../dist/runtime/schemas/api.js';
-import defu from 'defu';
+import { addPlugin, defineNuxtModule, createResolver, addComponentsDir, addImportsDir } from '@nuxt/kit';
+import defu, { defu as defu$1 } from 'defu';
+import { DEFAULT_TOAST_CONFIG, DEFAULT_AUTH_CONFIG, DEFAULT_RESPONSE_CONFIG, DEFAULT_ENDPOINT } from '../dist/runtime/constants/api-defaults.js';
+import { getPackageJsonMetadata } from '../dist/runtime/utils/meta.js';
+import { defineFontProvider } from 'unifont';
 export * from '../dist/runtime/types/index.js';
 
 const name = "@movk/nuxt";
-const version = "1.1.2";
+const version = "1.2.0";
 
-function setupTheme(nuxt, resolve) {
+function setupTheme(nuxt, resolve, options) {
+  if (options.theme?.enabled === false) return;
   nuxt.options.appConfig.theme = defu(nuxt.options.appConfig.theme || {}, {
     radius: 0.25,
     blackAsPrimary: false,
-    font: "Public Sans",
+    font: "Alibaba PuHuiTi",
     icons: "lucide"
   });
+  nuxt.options.appConfig.ui = defu(nuxt.options.appConfig.ui || {}, {
+    colors: {
+      primary: "sky",
+      secondary: "blue",
+      success: "green",
+      info: "blue",
+      warning: "yellow",
+      error: "red",
+      neutral: "slate"
+    }
+  });
   nuxt.options.app.head.meta = nuxt.options.app.head.meta || [];
   nuxt.options.app.head.meta.push(
     { charset: "utf-8" },
     { name: "viewport", content: "width=device-width, initial-scale=1" }
   );
+  nuxt.options.app.head.htmlAttrs = defu(nuxt.options.app.head.htmlAttrs || {}, {
+    lang: "zh-CN",
+    dir: "ltr"
+  });
   addPlugin({
     src: resolve("runtime/plugins/theme"),
     mode: "all"
   });
 }
 
-const DEFAULT_ENDPOINT = { default: { baseURL: "/api" } };
-function splitEndpointConfigs(endpoints) {
-  const publicEndpoints = {};
-  const privateEndpoints = {};
-  if (!endpoints) return { publicEndpoints, privateEndpoints };
-  for (const [name2, { headers, ...publicConfig }] of Object.entries(endpoints)) {
-    publicEndpoints[name2] = publicConfig;
-    if (headers) {
-      privateEndpoints[name2] = { headers };
+const WEIGHT_MAP = {
+  100: "Thin",
+  300: "Light",
+  400: "Regular",
+  500: "Medium",
+  600: "SemiBold",
+  700: "Bold",
+  800: "ExtraBold",
+  900: "Heavy",
+  950: "Black"
+};
+const FONT_FAMILY = "Alibaba PuHuiTi";
+function createAlibabaPuHuiTiProvider(cdnBase) {
+  return defineFontProvider("alibaba-puhuiti", () => ({
+    async resolveFont(fontFamily, options) {
+      if (fontFamily !== FONT_FAMILY) return void 0;
+      const weights = options.weights?.length ? options.weights.filter((w) => WEIGHT_MAP[w]) : Object.keys(WEIGHT_MAP);
+      const fonts = weights.map((weight) => ({
+        src: [{ url: `${cdnBase}/AlibabaPuHuiTi-${WEIGHT_MAP[weight]}.woff2`, format: "woff2" }],
+        weight,
+        style: "normal"
+      }));
+      return { fonts };
     }
+  }));
+}
+
+const FONT_PROVIDERS = [
+  {
+    key: "alibabaPuhuiti",
+    providerKey: "alibaba-puhuiti",
+    create: createAlibabaPuHuiTiProvider
   }
-  return { publicEndpoints, privateEndpoints };
+];
+const BUNNY_FONT_NAMES = ["Public Sans", "DM Sans", "Geist", "Inter", "Poppins", "Outfit", "Raleway"];
+function setupFonts(options, nuxt) {
+  if (options.fonts?.enabled === false) return;
+  const nuxtOpts = nuxt.options;
+  nuxtOpts.fonts = nuxtOpts.fonts || {};
+  nuxtOpts.fonts.families = nuxtOpts.fonts.families || [];
+  const existingNames = new Set(nuxtOpts.fonts.families.map((f) => f.name));
+  for (const name of BUNNY_FONT_NAMES) {
+    if (!existingNames.has(name)) {
+      nuxtOpts.fonts.families.push({ name, provider: "bunny" });
+    }
+  }
+  const active = FONT_PROVIDERS.filter((fp) => options.fonts?.[fp.key]?.cdn);
+  if (!active.length) return;
+  nuxt.hook("fonts:providers", (providers) => {
+    for (const fp of active) {
+      providers[fp.providerKey] = fp.create(options.fonts[fp.key].cdn);
+    }
+  });
 }
+
 function buildApiRuntimeConfig(apiConfig) {
-  const { publicEndpoints, privateEndpoints } = splitEndpointConfigs(apiConfig.endpoints);
+  const publicEndpoints = {};
+  const privateEndpoints = {};
+  if (apiConfig.endpoints) {
+    for (const [key, { headers, ...rest }] of Object.entries(apiConfig.endpoints)) {
+      publicEndpoints[key] = rest;
+      if (headers) privateEndpoints[key] = { headers };
+    }
+  }
   const hasEndpoints = Object.keys(publicEndpoints).length > 0;
   const publicConfig = {
     defaultEndpoint: apiConfig.defaultEndpoint ?? "default",
     debug: apiConfig.debug ?? false,
     endpoints: hasEndpoints ? publicEndpoints : DEFAULT_ENDPOINT,
-    response: apiResponseConfigSchema.parse(apiConfig.response ?? {}),
-    auth: apiAuthConfigSchema.parse(apiConfig.auth ?? {}),
-    toast: apiToastConfigSchema.parse(apiConfig.toast ?? {})
+    response: defu$1(apiConfig.response, DEFAULT_RESPONSE_CONFIG),
+    auth: defu$1(apiConfig.auth, DEFAULT_AUTH_CONFIG),
+    toast: defu$1(apiConfig.toast, DEFAULT_TOAST_CONFIG)
   };
   const privateConfig = {
     endpoints: Object.keys(privateEndpoints).length > 0 ? privateEndpoints : void 0
@@ -58,26 +125,46 @@ const module$1 = defineNuxtModule({
     name,
     version,
     configKey: "movk",
-    compatibility: { nuxt: ">=4.2.0" }
+    compatibility: { nuxt: ">=4.4.2" }
+  },
+  defaults: {
+    prefix: "M",
+    theme: {
+      enabled: true
+    },
+    fonts: {
+      enabled: true,
+      alibabaPuhuiti: {
+        cdn: "https://cdn.mhaibaraai.cn/fonts"
+      }
+    }
   },
-  defaults: { prefix: "M" },
   moduleDependencies: {
+    "@vueuse/nuxt": { version: ">=14.2.1" },
     "@nuxt/image": { version: ">=2.0.0" },
-    "@nuxt/ui": { version: ">=4.3.0" },
-    "@vueuse/nuxt": { version: ">=14.1.0" },
-    "nuxt-og-image": { version: ">=5.1.13" },
-    "nuxt-auth-utils": { version: ">=0.5.26" }
+    "@nuxt/ui": { version: ">=4.6.0" },
+    "nuxt-og-image": {
+      version: ">=6.3.1",
+      defaults: { zeroRuntime: true }
+    },
+    "nuxt-auth-utils": { version: ">=0.5.29" }
   },
-  setup(options, nuxt) {
+  async setup(options, nuxt) {
     const { resolve } = createResolver(import.meta.url);
-    setupTheme(nuxt, resolve);
+    setupTheme(nuxt, resolve, options);
+    setupFonts(options, nuxt);
     nuxt.options.alias["#movk"] = resolve("./runtime");
+    nuxt.options.css = nuxt.options.css || [];
     nuxt.options.css.push(resolve("runtime/style.css"));
+    const componentIgnore = ["auto-form-renderer/**"];
+    if (options.theme?.enabled === false) {
+      componentIgnore.push("theme-picker/**");
+    }
     addComponentsDir({
       path: resolve("runtime/components"),
       prefix: options.prefix,
       pathPrefix: false,
-      ignore: ["auto-form-renderer/**", "theme-picker/ThemePickerButton.vue"]
+      ignore: componentIgnore
     });
     addImportsDir(resolve("runtime/composables"));
     const apiConfig = options.api ?? {};
@@ -86,12 +173,11 @@ const module$1 = defineNuxtModule({
       nuxt.options.runtimeConfig.movkApi = privateConfig;
       nuxt.options.runtimeConfig.public.movkApi = publicConfig;
       addPlugin({ src: resolve("runtime/plugins/api.factory"), mode: "all" });
-      addServerHandler({
-        route: "/api/_movk/session",
-        method: "post",
-        handler: resolve("runtime/server/api/_movk/session.post")
-      });
     }
+    const meta = await getPackageJsonMetadata(nuxt.options.rootDir);
+    nuxt.options.site = defu$1(nuxt.options.site, {
+      name: meta.name || "movk-nuxt"
+    });
   }
 });
 

package/dist/runtime/auto-form/controls.d.ts

@@ -0,0 +1,221 @@
+import type { IsComponent } from '@movk/core';
+import type { AutoFormControl, _Unset } from '../types/auto-form.js';
+import type { InputProps, InputSlots, TextareaProps, TextareaSlots } from '@nuxt/ui';
+import { UInput, UTextarea } from '#components';
+/** 声明单个控件配置，恒等函数，仅用于保留精确的组件 props/slots 类型推断 */
+export declare function defineControl<C extends IsComponent, P = _Unset, S = _Unset>(e: AutoFormControl<C, P, S>): AutoFormControl<C, P, S>;
+declare const DEFAULT_CONTROL_COMPONENTS: {
+    readonly string: any;
+    readonly number: any;
+    readonly boolean: any;
+    readonly enum: any;
+    readonly file: any;
+    readonly calendarDate: <R extends boolean, M extends boolean, P extends "click" | "hover" = "click">(__VLS_props: NonNullable<Awaited<typeof __VLS_setup>>["props"], __VLS_ctx?: {
+        slots: {
+            default?: (props: any) => any;
+        } & {
+            leading?: (props: any) => any;
+        } & {
+            trailing?: (props: any) => any;
+        } & {
+            anchor?: (props: any) => any;
+        } & {
+            day?: (props: any) => any;
+        } & {
+            heading?: (props: any) => any;
+        } & {
+            'week-day'?: (props: any) => any;
+        };
+        attrs: any;
+        emit: any;
+    }, __VLS_exposed?: NonNullable<Awaited<typeof __VLS_setup>>["expose"], __VLS_setup?: Promise<{
+        props: any;
+        expose: (exposed: {}) => void;
+        attrs: any;
+        slots: {
+            default?: (props: any) => any;
+        } & {
+            leading?: (props: any) => any;
+        } & {
+            trailing?: (props: any) => any;
+        } & {
+            anchor?: (props: any) => any;
+        } & {
+            day?: (props: any) => any;
+        } & {
+            heading?: (props: any) => any;
+        } & {
+            'week-day'?: (props: any) => any;
+        };
+        emit: any;
+    }>) => import("vue").VNode & {
+        __ctx?: Awaited<typeof __VLS_setup>;
+    };
+    readonly datePicker: <R extends boolean, M extends boolean, P extends "click" | "hover" = "click">(__VLS_props: NonNullable<Awaited<typeof __VLS_setup>>["props"], __VLS_ctx?: {
+        slots: {
+            default?: (props: any) => any;
+        } & {
+            leading?: (props: any) => any;
+        } & {
+            trailing?: (props: any) => any;
+        } & {
+            anchor?: (props: any) => any;
+        } & {
+            day?: (props: any) => any;
+        } & {
+            heading?: (props: any) => any;
+        } & {
+            'week-day'?: (props: any) => any;
+        };
+        attrs: any;
+        emit: any;
+    }, __VLS_exposed?: NonNullable<Awaited<typeof __VLS_setup>>["expose"], __VLS_setup?: Promise<{
+        props: any;
+        expose: (exposed: {}) => void;
+        attrs: any;
+        slots: {
+            default?: (props: any) => any;
+        } & {
+            leading?: (props: any) => any;
+        } & {
+            trailing?: (props: any) => any;
+        } & {
+            anchor?: (props: any) => any;
+        } & {
+            day?: (props: any) => any;
+        } & {
+            heading?: (props: any) => any;
+        } & {
+            'week-day'?: (props: any) => any;
+        };
+        emit: any;
+    }>) => import("vue").VNode & {
+        __ctx?: Awaited<typeof __VLS_setup>;
+    };
+    readonly switch: any;
+    readonly textarea: any;
+    readonly slider: any;
+    readonly pinInput: any;
+    readonly inputTags: any;
+    readonly selectMenu: any;
+    readonly inputMenu: any;
+    readonly checkboxGroup: any;
+    readonly radioGroup: any;
+    readonly inputDate: any;
+    readonly inputTime: any;
+    readonly withClear: <T extends import("@nuxt/ui").InputValue>(__VLS_props: NonNullable<Awaited<typeof __VLS_setup>>["props"], __VLS_ctx?: {
+        slots: import("@movk/core").OmitByKey<InputSlots, "trailing">;
+        attrs: any;
+        emit: any & ((event: "update:modelValue", value: T | undefined) => void);
+    }, __VLS_exposed?: NonNullable<Awaited<typeof __VLS_setup>>["expose"], __VLS_setup?: Promise<{
+        props: any;
+        expose: (exposed: {}) => void;
+        attrs: any;
+        slots: import("@movk/core").OmitByKey<InputSlots, "trailing">;
+        emit: any & ((event: "update:modelValue", value: T | undefined) => void);
+    }>) => import("vue").VNode & {
+        __ctx?: Awaited<typeof __VLS_setup>;
+    };
+    readonly withPasswordToggle: <T extends import("@nuxt/ui").InputValue>(__VLS_props: NonNullable<Awaited<typeof __VLS_setup>>["props"], __VLS_ctx?: {
+        slots: import("@movk/core").OmitByKey<InputSlots, "trailing">;
+        attrs: any;
+        emit: any & ((event: "update:modelValue", value: T | undefined) => void);
+    }, __VLS_exposed?: NonNullable<Awaited<typeof __VLS_setup>>["expose"], __VLS_setup?: Promise<{
+        props: any;
+        expose: (exposed: {}) => void;
+        attrs: any;
+        slots: import("@movk/core").OmitByKey<InputSlots, "trailing">;
+        emit: any & ((event: "update:modelValue", value: T | undefined) => void);
+    }>) => import("vue").VNode & {
+        __ctx?: Awaited<typeof __VLS_setup>;
+    };
+    readonly withCopy: <T extends import("@nuxt/ui").InputValue>(__VLS_props: NonNullable<Awaited<typeof __VLS_setup>>["props"], __VLS_ctx?: {
+        slots: import("@movk/core").OmitByKey<InputSlots, "trailing">;
+        attrs: any;
+        emit: any & ((event: "update:modelValue", value: T | undefined) => void);
+    }, __VLS_exposed?: NonNullable<Awaited<typeof __VLS_setup>>["expose"], __VLS_setup?: Promise<{
+        props: any;
+        expose: (exposed: {}) => void;
+        attrs: any;
+        slots: import("@movk/core").OmitByKey<InputSlots, "trailing">;
+        emit: any & ((event: "update:modelValue", value: T | undefined) => void);
+    }>) => import("vue").VNode & {
+        __ctx?: Awaited<typeof __VLS_setup>;
+    };
+    readonly withCharacterLimit: <T extends import("@nuxt/ui").InputValue>(__VLS_props: NonNullable<Awaited<typeof __VLS_setup>>["props"], __VLS_ctx?: {
+        slots: import("@movk/core").OmitByKey<InputSlots, "trailing">;
+        attrs: any;
+        emit: any & ((event: "update:modelValue", value: T | undefined) => void);
+    }, __VLS_exposed?: NonNullable<Awaited<typeof __VLS_setup>>["expose"], __VLS_setup?: Promise<{
+        props: any;
+        expose: (exposed: {}) => void;
+        attrs: any;
+        slots: import("@movk/core").OmitByKey<InputSlots, "trailing">;
+        emit: any & ((event: "update:modelValue", value: T | undefined) => void);
+    }>) => import("vue").VNode & {
+        __ctx?: Awaited<typeof __VLS_setup>;
+    };
+    readonly asPhoneNumberInput: <T extends import("@nuxt/ui").InputValue>(__VLS_props: NonNullable<Awaited<typeof __VLS_setup>>["props"], __VLS_ctx?: {
+        slots: import("@movk/core").OmitByKey<InputSlots, "leading">;
+        attrs: any;
+        emit: any & ((event: "update:modelValue", value: T | undefined) => void);
+    }, __VLS_exposed?: NonNullable<Awaited<typeof __VLS_setup>>["expose"], __VLS_setup?: Promise<{
+        props: any;
+        expose: (exposed: {}) => void;
+        attrs: any;
+        slots: import("@movk/core").OmitByKey<InputSlots, "leading">;
+        emit: any & ((event: "update:modelValue", value: T | undefined) => void);
+    }>) => import("vue").VNode & {
+        __ctx?: Awaited<typeof __VLS_setup>;
+    };
+    readonly withFloatingLabel: <T extends import("@nuxt/ui").InputValue>(__VLS_props: NonNullable<Awaited<typeof __VLS_setup>>["props"], __VLS_ctx?: {
+        slots: import("@movk/core").OmitByKey<InputSlots, "default" | "trailing">;
+        attrs: any;
+        emit: any & ((event: "update:modelValue", value: T | undefined) => void);
+    }, __VLS_exposed?: NonNullable<Awaited<typeof __VLS_setup>>["expose"], __VLS_setup?: Promise<{
+        props: any;
+        expose: (exposed: {}) => void;
+        attrs: any;
+        slots: import("@movk/core").OmitByKey<InputSlots, "default" | "trailing">;
+        emit: any & ((event: "update:modelValue", value: T | undefined) => void);
+    }>) => import("vue").VNode & {
+        __ctx?: Awaited<typeof __VLS_setup>;
+    };
+    readonly colorChooser: <P extends "click" | "hover" = "click">(__VLS_props: NonNullable<Awaited<typeof __VLS_setup>>["props"], __VLS_ctx?: {
+        slots: {
+            default?: (props: any) => any;
+        } & {
+            leading?: (props: any) => any;
+        } & {
+            trailing?: (props: any) => any;
+        } & {
+            anchor?: (props: any) => any;
+        };
+        attrs: any;
+        emit: any & ((event: "update:modelValue", value: string | undefined) => void);
+    }, __VLS_exposed?: NonNullable<Awaited<typeof __VLS_setup>>["expose"], __VLS_setup?: Promise<{
+        props: any;
+        expose: (exposed: {}) => void;
+        attrs: any;
+        slots: {
+            default?: (props: any) => any;
+        } & {
+            leading?: (props: any) => any;
+        } & {
+            trailing?: (props: any) => any;
+        } & {
+            anchor?: (props: any) => any;
+        };
+        emit: any & ((event: "update:modelValue", value: string | undefined) => void);
+    }>) => import("vue").VNode & {
+        __ctx?: Awaited<typeof __VLS_setup>;
+    };
+    readonly starRating: any;
+    readonly slideVerify: any;
+};
+type DefaultControlComponents = typeof DEFAULT_CONTROL_COMPONENTS;
+type DefaultControlMap = {
+    readonly [K in keyof DefaultControlComponents]: K extends 'string' ? AutoFormControl<typeof UInput, InputProps, InputSlots> : K extends 'textarea' ? AutoFormControl<typeof UTextarea, TextareaProps, TextareaSlots> : AutoFormControl<DefaultControlComponents[K]>;
+};
+export declare const DEFAULT_CONTROLS: DefaultControlMap;
+export {};

package/dist/runtime/auto-form/controls.js

@@ -0,0 +1,70 @@
+import WithClear from "../components/input/WithClear.vue";
+import WithPasswordToggle from "../components/input/WithPasswordToggle.vue";
+import WithCopy from "../components/input/WithCopy.vue";
+import WithCharacterLimit from "../components/input/WithCharacterLimit.vue";
+import AsPhoneNumberInput from "../components/input/AsPhoneNumberInput.vue";
+import WithFloatingLabel from "../components/input/WithFloatingLabel.vue";
+import DatePicker from "../components/DatePicker.vue";
+import ColorChooser from "../components/ColorChooser.vue";
+import StarRating from "../components/StarRating.vue";
+import SlideVerify from "../components/SlideVerify.vue";
+import {
+  UInput,
+  UInputNumber,
+  UCheckbox,
+  USwitch,
+  UTextarea,
+  USlider,
+  UPinInput,
+  UInputTags,
+  UFileUpload,
+  USelect,
+  USelectMenu,
+  UInputMenu,
+  UCheckboxGroup,
+  URadioGroup,
+  UInputDate,
+  UInputTime
+} from "#components";
+const DEFAULT_CONTROL_PROPS = { class: "w-full" };
+export function defineControl(e) {
+  return e;
+}
+function createControlMap(components, defaultProps = DEFAULT_CONTROL_PROPS) {
+  return Object.fromEntries(
+    Object.entries(components).map(([key, component]) => [
+      key,
+      { component, controlProps: defaultProps }
+    ])
+  );
+}
+const DEFAULT_CONTROL_COMPONENTS = {
+  string: UInput,
+  number: UInputNumber,
+  boolean: UCheckbox,
+  enum: USelect,
+  file: UFileUpload,
+  calendarDate: DatePicker,
+  datePicker: DatePicker,
+  switch: USwitch,
+  textarea: UTextarea,
+  slider: USlider,
+  pinInput: UPinInput,
+  inputTags: UInputTags,
+  selectMenu: USelectMenu,
+  inputMenu: UInputMenu,
+  checkboxGroup: UCheckboxGroup,
+  radioGroup: URadioGroup,
+  inputDate: UInputDate,
+  inputTime: UInputTime,
+  withClear: WithClear,
+  withPasswordToggle: WithPasswordToggle,
+  withCopy: WithCopy,
+  withCharacterLimit: WithCharacterLimit,
+  asPhoneNumberInput: AsPhoneNumberInput,
+  withFloatingLabel: WithFloatingLabel,
+  colorChooser: ColorChooser,
+  starRating: StarRating,
+  slideVerify: SlideVerify
+};
+export const DEFAULT_CONTROLS = createControlMap(DEFAULT_CONTROL_COMPONENTS);

package/dist/runtime/{utils → auto-form}/field-utils.d.ts

@@ -1,8 +1,6 @@
 import type { VNode } from 'vue';
 import type { AutoFormField } from '../types/auto-form.js';
-/**
- * 字段分类
- */
+/** 将字段列表分类为叶子/嵌套/数组/布局四组 */
 export declare function classifyFields(fields: AutoFormField[]): {
     leafFields: AutoFormField[];
     nestedFields: AutoFormField[];
@@ -10,25 +8,11 @@ export declare function classifyFields(fields: AutoFormField[]): {
     layoutFields: AutoFormField[];
     hasComplexFields: boolean;
 };
-/**
- * 优化的字段类型检测 - 基于 meta.type 判断
- * @param field - 自动表单字段
- * @returns 是否为叶子字段（非 object 和 array）
- */
 export declare function isLeafField(field: AutoFormField): boolean;
-/**
- * 获取字段类型
- * @param field - 自动表单字段
- * @returns 字段类型
- */
 export declare function getFieldType(field: AutoFormField): 'leaf' | 'nested';
-/**
- * 收集字段默认值
- */
+/** 递归收集字段的默认值，object 类型返回嵌套结构，叶子类型直接返回值 */
 export declare function collectFieldDefaults(field: AutoFormField): {} | null | undefined;
-/**
- * 从 SelectMenuItem 数组中提取枚举值
- */
+/** 从 items 选项中提取枚举值，支持对象格式（取 valueKey/value/label）和原始值 */
 export declare function extractEnumValuesFromItems(items: any, valueKey?: string): string[];
-/** 创建提示插槽工厂 */
+/** 创建数组项的 hint 插槽渲染函数，根据层级和字段类型组合删除按钮与折叠图标 */
 export declare function createHintSlotFactory(removeCallback: (count?: number) => void): (field: AutoFormField, path: string, open?: boolean, count?: number) => VNode | undefined;

package/dist/runtime/{utils → auto-form}/field-utils.js

@@ -95,7 +95,6 @@ export function createHintSlotFactory(removeCallback) {
       color: "error",
       variant: "ghost",
       size: "xs",
-      square: true,
       onClick: (event) => {
         event?.stopPropagation();
         removeCallback(count);
@@ -104,7 +103,7 @@ export function createHintSlotFactory(removeCallback) {
     if (!isObject) {
       return deleteButton;
     }
-    return h("div", { class: "flex items-center gap-2" }, [
+    return h("div", { class: "flex items-center gap-1.5" }, [
       deleteButton,
       chevronIcon
     ]);