@movk/nuxt 1.1.2 → 1.3.0

package/dist/runtime/components/input/WithPasswordToggle.vue.d.ts

@@ -1,19 +1,25 @@
-import type { InputProps, InputValue } from '@nuxt/ui';
-import type { WithPasswordToggleProps } from '../../types/components.js';
+import type { InputSlots, InputValue, ComponentConfig } from '@nuxt/ui';
+import type { OmitByKey } from '@movk/core';
+import theme from '#build/movk-ui/with-password-toggle';
+import inputTheme from '#build/ui/input';
+import type { AppConfig } from 'nuxt/schema';
+import type { WithPasswordToggleProps } from '../../types/components/input/with-password-toggle';
 declare const __VLS_export: <T extends InputValue>(__VLS_props: NonNullable<Awaited<typeof __VLS_setup>>["props"], __VLS_ctx?: __VLS_PrettifyLocal<Pick<NonNullable<Awaited<typeof __VLS_setup>>, "attrs" | "emit" | "slots">>, __VLS_exposed?: NonNullable<Awaited<typeof __VLS_setup>>["expose"], __VLS_setup?: Promise<{
-    props: import("vue").PublicProps & __VLS_PrettifyLocal<(WithPasswordToggleProps<import("@nuxt/ui/.").AcceptableValue> & {
-        modelValue?: InputProps["modelValue"];
+    props: import("vue").PublicProps & __VLS_PrettifyLocal<(WithPasswordToggleProps<T> & {
+        ui?: ComponentConfig<typeof inputTheme & typeof theme, AppConfig, "withPasswordToggle">["slots"];
+    } & {
+        modelValue?: T;
     }) & {
         onBlur?: ((event: FocusEvent) => any) | undefined;
         onChange?: ((event: Event) => any) | undefined;
-        "onUpdate:modelValue"?: ((value: import("@nuxt/ui/.").AcceptableValue | undefined) => any) | undefined;
+        "onUpdate:modelValue"?: ((value: T | undefined) => any) | undefined;
     }> & (typeof globalThis extends {
         __VLS_PROPS_FALLBACK: infer P;
     } ? P : {});
     expose: (exposed: {}) => void;
     attrs: any;
-    slots: import("@movk/core").OmitByKey<import("@nuxt/ui/.").InputSlots, "trailing">;
-    emit: (((evt: "blur", event: FocusEvent) => void) & ((evt: "change", event: Event) => void) & ((evt: "update:modelValue", value: import("@nuxt/ui/.").AcceptableValue) => void)) & ((evt: "update:modelValue", value: import("@nuxt/ui/.").AcceptableValue | undefined) => void);
+    slots: OmitByKey<InputSlots, "trailing">;
+    emit: (((evt: "blur", event: FocusEvent) => void) & ((evt: "change", event: Event) => void) & ((evt: "update:modelValue", value: T) => void)) & ((event: "update:modelValue", value: T | undefined) => void);
 }>) => import("vue").VNode & {
     __ctx?: Awaited<typeof __VLS_setup>;
 };

package/dist/runtime/components/theme-picker/ThemePicker.d.vue.ts

@@ -1,3 +1,10 @@
-declare const __VLS_export: import("vue").DefineComponent<{}, {}, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {}, string, import("vue").PublicProps, Readonly<{}> & Readonly<{}>, {}, {}, {}, {}, string, import("vue").ComponentProvideOptions, true, {}, any>;
+import type { ComponentConfig } from '@nuxt/ui';
+import type { AppConfig } from 'nuxt/schema';
+import theme from '#build/movk-ui/theme-picker';
+import popoverTheme from '#build/ui/popover';
+interface ThemePickerProps {
+    ui?: ComponentConfig<typeof popoverTheme & typeof theme, AppConfig, 'themePicker'>['slots'];
+}
+declare const __VLS_export: import("vue").DefineComponent<ThemePickerProps, {}, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {}, string, import("vue").PublicProps, Readonly<ThemePickerProps> & Readonly<{}>, {}, {}, {}, {}, string, import("vue").ComponentProvideOptions, false, {}, any>;
 declare const _default: typeof __VLS_export;
 export default _default;

package/dist/runtime/components/theme-picker/ThemePicker.vue

@@ -4,16 +4,29 @@ import { useClipboard } from "@vueuse/core";
 import { ref } from "vue";
 import { useTheme } from "../../composables/useTheme";
 import ThemePickerButton from "./ThemePickerButton.vue";
+import theme from "#build/movk-ui/theme-picker";
+import popoverTheme from "#build/ui/popover";
+import { useExtendedTv } from "../../utils/extend-theme";
+const props = defineProps({
+  ui: { type: Object, required: false }
+});
 const appConfig = useAppConfig();
 const colorMode = useColorMode();
+const { extendUi } = useExtendedTv(
+  popoverTheme,
+  theme,
+  () => appConfig.movk?.themePicker,
+  () => ({ ui: props.ui })
+);
 const open = ref(false);
 const { copy: copyCSS, copied: copiedCSS } = useClipboard();
-const { copy: copyAppConfig, copied: copiedAppConfig } = useClipboard();
+const { copy: copyConfig, copied: copiedConfig } = useClipboard();
 const {
   neutralColors,
   neutral,
   primaryColors,
   primary,
+  blackAsPrimary,
   setBlackAsPrimary,
   radiuses,
   radius,
@@ -24,18 +37,16 @@ const {
   modes,
   mode,
   hasCSSChanges,
-  hasAppConfigChanges,
+  hasConfigChanges,
+  configLabel,
   exportCSS,
-  exportAppConfig,
+  exportConfig,
   resetTheme
 } = useTheme();
 </script>
 
 <template>
-  <UPopover
-    v-model:open="open"
-    :ui="{ content: 'w-72 px-6 py-4 flex flex-col gap-4 overflow-y-auto max-h-[calc(100vh-5rem)]' }"
-  >
+  <UPopover v-model:open="open" :ui="extendUi">
     <template #default>
       <UButton
         icon="i-lucide-swatch-book"
@@ -57,17 +68,20 @@ const {
             size="xs"
             color="neutral"
             variant="link"
-            target="_blank"
-            icon="i-lucide-circle-help"
+            icon="i-lucide-help-circle"
             class="p-0 -my-0.5"
             :ui="{ leadingIcon: 'size-3' }"
           />
         </legend>
 
         <div class="grid grid-cols-3 gap-1 -mx-2">
-          <ThemePickerButton label="Black" :selected="appConfig.theme.blackAsPrimary" @click="setBlackAsPrimary(true)">
+          <ThemePickerButton
+            label="Black"
+            :selected="blackAsPrimary"
+            @click="setBlackAsPrimary(true)"
+          >
             <template #leading>
-              <span class="inline-block w-2 h-2 rounded-full bg-black dark:bg-white" />
+              <span class="inline-block size-2 rounded-full bg-black dark:bg-white" />
             </template>
           </ThemePickerButton>
 
@@ -76,7 +90,7 @@ const {
             :key="color"
             :label="color"
             :chip="color"
-            :selected="!appConfig.theme.blackAsPrimary && primary === color"
+            :selected="!blackAsPrimary && primary === color"
             @click="primary = color"
           />
         </div>
@@ -91,8 +105,7 @@ const {
             size="xs"
             color="neutral"
             variant="link"
-            target="_blank"
-            icon="i-lucide-circle-help"
+            icon="i-lucide-help-circle"
             class="p-0 -my-0.5"
             :ui="{ leadingIcon: 'size-3' }"
           />
@@ -119,8 +132,7 @@ const {
             size="xs"
             color="neutral"
             variant="link"
-            target="_blank"
-            icon="i-lucide-circle-help"
+            icon="i-lucide-help-circle"
             class="p-0 -my-0.5"
             :ui="{ leadingIcon: 'size-3' }"
           />
@@ -147,8 +159,7 @@ const {
             size="xs"
             color="neutral"
             variant="link"
-            target="_blank"
-            icon="i-lucide-circle-help"
+            icon="i-lucide-help-circle"
             class="p-0 -my-0.5"
             :ui="{ leadingIcon: 'size-3' }"
           />
@@ -176,8 +187,7 @@ const {
             size="xs"
             color="neutral"
             variant="link"
-            target="_blank"
-            icon="i-lucide-circle-help"
+            icon="i-lucide-help-circle"
             class="p-0 -my-0.5"
             :ui="{ leadingIcon: 'size-3' }"
           />
@@ -205,8 +215,7 @@ const {
             size="xs"
             color="neutral"
             variant="link"
-            target="_blank"
-            icon="i-lucide-circle-help"
+            icon="i-lucide-help-circle"
             class="p-0 -my-0.5"
             :ui="{ leadingIcon: 'size-3' }"
           />
@@ -223,7 +232,7 @@ const {
         </div>
       </fieldset>
 
-      <fieldset v-if="hasCSSChanges || hasAppConfigChanges">
+      <fieldset v-if="hasCSSChanges || hasConfigChanges">
         <legend class="text-[11px] leading-none font-semibold mb-2 select-none">
           Export
         </legend>
@@ -236,18 +245,18 @@ const {
             size="sm"
             label="main.css"
             class="flex-1 text-[11px]"
-            :icon="copiedCSS ? appConfig.ui.icons.copyCheck : appConfig.ui.icons.copy"
+            :icon="copiedCSS ? 'i-lucide-copy-check' : 'i-lucide-copy'"
             @click="copyCSS(exportCSS())"
           />
           <UButton
-            v-if="hasAppConfigChanges"
+            v-if="hasConfigChanges"
             color="neutral"
             variant="soft"
             size="sm"
-            label="app.config.ts"
-            :icon="copiedAppConfig ? appConfig.ui.icons.copyCheck : appConfig.ui.icons.copy"
+            :label="configLabel"
+            :icon="copiedConfig ? 'i-lucide-copy-check' : 'i-lucide-copy'"
             class="flex-1 text-[11px]"
-            @click="copyAppConfig(exportAppConfig())"
+            @click="copyConfig(exportConfig())"
           />
           <UTooltip text="Reset theme">
             <UButton

package/dist/runtime/components/theme-picker/ThemePicker.vue.d.ts

@@ -1,3 +1,10 @@
-declare const __VLS_export: import("vue").DefineComponent<{}, {}, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {}, string, import("vue").PublicProps, Readonly<{}> & Readonly<{}>, {}, {}, {}, {}, string, import("vue").ComponentProvideOptions, true, {}, any>;
+import type { ComponentConfig } from '@nuxt/ui';
+import type { AppConfig } from 'nuxt/schema';
+import theme from '#build/movk-ui/theme-picker';
+import popoverTheme from '#build/ui/popover';
+interface ThemePickerProps {
+    ui?: ComponentConfig<typeof popoverTheme & typeof theme, AppConfig, 'themePicker'>['slots'];
+}
+declare const __VLS_export: import("vue").DefineComponent<ThemePickerProps, {}, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {}, string, import("vue").PublicProps, Readonly<ThemePickerProps> & Readonly<{}>, {}, {}, {}, {}, string, import("vue").ComponentProvideOptions, false, {}, any>;
 declare const _default: typeof __VLS_export;
 export default _default;

package/dist/runtime/components/theme-picker/ThemePickerButton.d.vue.ts

@@ -1,16 +1,15 @@
-type __VLS_Props = {
+interface ThemePickerButtonProps {
     label: string;
     icon?: string;
     chip?: string;
     selected?: boolean;
-};
-type __VLS_Slots = {
+}
+interface ThemePickerButtonSlots {
     leading: () => any;
-};
-declare const __VLS_base: import("vue").DefineComponent<__VLS_Props, {}, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {}, string, import("vue").PublicProps, Readonly<__VLS_Props> & Readonly<{}>, {}, {}, {}, {}, string, import("vue").ComponentProvideOptions, false, {}, any>;
-declare const __VLS_export: __VLS_WithSlots<typeof __VLS_base, __VLS_Slots>;
+}
 declare const _default: typeof __VLS_export;
 export default _default;
+declare const __VLS_export: __VLS_WithSlots<import("vue").DefineComponent<ThemePickerButtonProps, {}, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {}, string, import("vue").PublicProps, Readonly<ThemePickerButtonProps> & Readonly<{}>, {}, {}, {}, {}, string, import("vue").ComponentProvideOptions, false, {}, any>, ThemePickerButtonSlots>;
 type __VLS_WithSlots<T, S> = T & {
     new (): {
         $slots: S;

package/dist/runtime/components/theme-picker/ThemePickerButton.vue

@@ -1,3 +1,7 @@
+<script>
+
+</script>
+
 <script setup>
 defineProps({
   label: { type: String, required: true },

package/dist/runtime/components/theme-picker/ThemePickerButton.vue.d.ts

@@ -1,16 +1,15 @@
-type __VLS_Props = {
+interface ThemePickerButtonProps {
     label: string;
     icon?: string;
     chip?: string;
     selected?: boolean;
-};
-type __VLS_Slots = {
+}
+interface ThemePickerButtonSlots {
     leading: () => any;
-};
-declare const __VLS_base: import("vue").DefineComponent<__VLS_Props, {}, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {}, string, import("vue").PublicProps, Readonly<__VLS_Props> & Readonly<{}>, {}, {}, {}, {}, string, import("vue").ComponentProvideOptions, false, {}, any>;
-declare const __VLS_export: __VLS_WithSlots<typeof __VLS_base, __VLS_Slots>;
+}
 declare const _default: typeof __VLS_export;
 export default _default;
+declare const __VLS_export: __VLS_WithSlots<import("vue").DefineComponent<ThemePickerButtonProps, {}, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {}, string, import("vue").PublicProps, Readonly<ThemePickerButtonProps> & Readonly<{}>, {}, {}, {}, {}, string, import("vue").ComponentProvideOptions, false, {}, any>, ThemePickerButtonSlots>;
 type __VLS_WithSlots<T, S> = T & {
     new (): {
         $slots: S;

package/dist/runtime/composables/index.d.ts

@@ -1,8 +1,9 @@
-export * from './useApiFetch.js';
-export * from './useClientApiFetch.js';
-export * from './useApiAuth.js';
-export * from './useDownloadWithProgress.js';
-export * from './useUploadWithProgress.js';
-export * from './useAutoForm.js';
-export * from './useTheme.js';
-export * from './useDateFormatter.js';
+export * from './useApiFetch';
+export * from './useLazyApiFetch';
+export * from './useClientApiFetch';
+export * from './useDownloadWithProgress';
+export * from './useUploadWithProgress';
+export * from './useAutoForm';
+export * from './useTheme';
+export * from './useDateFormatter';
+export * from './useMessageBox';

package/dist/runtime/composables/index.js

@@ -1,8 +1,9 @@
 export * from "./useApiFetch.js";
+export * from "./useLazyApiFetch.js";
 export * from "./useClientApiFetch.js";
-export * from "./useApiAuth.js";
 export * from "./useDownloadWithProgress.js";
 export * from "./useUploadWithProgress.js";
 export * from "./useAutoForm.js";
 export * from "./useTheme.js";
 export * from "./useDateFormatter.js";
+export * from "./useMessageBox.js";

package/dist/runtime/composables/useApiFetch.d.ts

@@ -1,16 +1,12 @@
-import type { UseApiFetchOptions, UseApiFetchReturn } from '../types/api.js';
+import type { NitroFetchRequest } from 'nitropack/types';
+import type { UseApiFetchOptions, UseApiFetchReturn } from '../types/api';
 /**
  * API Fetch 组合式函数
  *
- * 基于 Nuxt useFetch 封装，提供：
- * - 自动认证（从 session 获取 token）
- * - 业务状态码检查
- * - Toast 提示（通过内置 hooks 统一处理）
- * - 自动数据解包
- * - 支持用户自定义 hooks（与内置 hooks 合并执行）
+ * 基于 Nuxt useFetch 的薄封装，自动注入 $api 实例。
+ * 所有核心能力（认证、业务检查、数据解包、Toast）由 $api interceptors 统一处理。
  *
- * @typeParam ResT - API 响应 data 字段的原始类型
- * @typeParam DataT - transform 转换后的最终类型（默认等于 ResT）
+ * @typeParam T - 业务数据类型（默认已由 $api 自动解包；skipUnwrap 时为原始响应类型）
  *
  * @example
  * ```ts
@@ -23,20 +19,32 @@ import type { UseApiFetchOptions, UseApiFetchReturn } from '../types/api.js';
  *   body: { name: 'test' }
  * })
  *
- * // 自定义 transform（双泛型，接收解包后的数据）
- * const { data } = await useApiFetch<{ content: User[] }, User[]>('/users', {
- *   transform: ({ content }) => content ?? []
+ * // 自定义 transform（接收已解包的业务数据）
+ * const { data } = await useApiFetch<User[]>('/users', {
+ *   transform: (users) => users.filter(u => u.active)
  * })
  *
  * // 使用其他端点
  * const { data } = await useApiFetch('/users', { endpoint: 'v2' })
  *
- * // 自定义 hooks（与内置 hooks 合并执行）
+ * // 自定义 Toast
+ * const { data } = await useApiFetch('/users', {
+ *   toast: { successMessage: '加载成功' }
+ * })
+ *
+ * // 跳过业务状态码校验（仍按 dataKey 解包，适合 code 字段缺失的场景）
+ * const { data } = await useApiFetch('/legacy', { skipBusinessCheck: true })
+ *
+ * // 跳过解包，拿原始响应（与 skipBusinessCheck 正交）
+ * const { data } = await useApiFetch<ApiResponse>('/external', { skipUnwrap: true })
+ *
+ * // 用户自定义 hooks（通过 useFetch 原生选项透传）
  * const { data } = await useApiFetch('/users', {
  *   onResponse({ response }) {
- *     console.log('用户自定义处理:', response._data)
+ *     // response._data 已是解包后的业务数据（除非传入 skipUnwrap: true）
+ *     console.log('自定义处理:', response._data)
  *   }
  * })
  * ```
  */
-export declare function useApiFetch<ResT = unknown, DataT = ResT>(url: string | (() => string), options?: UseApiFetchOptions<ResT, DataT>): UseApiFetchReturn<DataT>;
+export declare function useApiFetch<T = unknown, DataT = T>(url: NitroFetchRequest | (() => NitroFetchRequest), options?: UseApiFetchOptions<T, DataT>): UseApiFetchReturn<DataT>;

package/dist/runtime/composables/useApiFetch.js

@@ -1,41 +1,34 @@
-import { useNuxtApp, useFetch } from "#imports";
-import { createTransform, mergeFetchHooks } from "../utils/api-utils.js";
+import { computed, toValue } from "vue";
+import { useNuxtApp, useFetch } from "#app";
+import { buildApiFetchKey } from "../domains/api/fetch-key.js";
 export function useApiFetch(url, options = {}) {
   const { $api } = useNuxtApp();
   const {
     endpoint,
     toast,
-    skipBusinessCheck = false,
-    transform: userTransform,
-    onRequest: userOnRequest,
-    onRequestError: userOnRequestError,
-    onResponse: userOnResponse,
-    onResponseError: userOnResponseError,
+    skipBusinessCheck,
+    skipUnwrap,
     ...fetchOptions
   } = options;
   const apiInstance = endpoint ? $api.use(endpoint) : $api;
-  const endpointConfig = apiInstance.getConfig();
-  const builtinHooks = endpointConfig.builtinHooks || {};
-  const transformFn = createTransform({
-    skipBusinessCheck,
-    userTransform,
-    successConfig: endpointConfig.response
-  });
-  const mergedHooks = mergeFetchHooks(builtinHooks, {
-    onRequest: userOnRequest,
-    onRequestError: userOnRequestError,
-    onResponse: userOnResponse,
-    onResponseError: userOnResponseError
+  const fetchKey = computed(() => {
+    const userKey = toValue(fetchOptions.key);
+    if (userKey) return userKey;
+    return buildApiFetchKey({
+      endpoint,
+      skipUnwrap,
+      skipBusinessCheck,
+      toast,
+      method: toValue(fetchOptions.method),
+      url: typeof url === "function" ? url() : url,
+      query: toValue(fetchOptions.query),
+      body: toValue(fetchOptions.body)
+    });
   });
-  const context = { toast, skipBusinessCheck };
   return useFetch(url, {
     ...fetchOptions,
-    $fetch: apiInstance.$fetch,
-    transform: transformFn,
-    onRequest: mergedHooks.onRequest,
-    onRequestError: mergedHooks.onRequestError,
-    onResponse: mergedHooks.onResponse,
-    onResponseError: mergedHooks.onResponseError,
-    context
+    key: fetchKey,
+    $fetch: apiInstance,
+    context: { toast, skipBusinessCheck, skipUnwrap }
   });
 }

package/dist/runtime/composables/useAutoForm.d.ts

@@ -1,101 +1,17 @@
-import type { IsComponent } from '@movk/core';
-import type { AutoFormControl, AutoFormControls, TypedZodFactory } from '../types/auto-form.js';
-import { z } from 'zod/v4';
-import WithClear from '../components/input/WithClear.vue.js';
-import WithPasswordToggle from '../components/input/WithPasswordToggle.vue.js';
-import WithCopy from '../components/input/WithCopy.vue.js';
-import WithCharacterLimit from '../components/input/WithCharacterLimit.vue.js';
-import DatePicker from '../components/DatePicker.vue.js';
-import ColorChooser from '../components/ColorChooser.vue.js';
-import StarRating from '../components/StarRating.vue.js';
-import SlideVerify from '../components/SlideVerify.vue.js';
-import { UInput, UInputNumber, UCheckbox, USwitch, UTextarea, USlider, UPinInput, UInputTags, UFileUpload, USelect, USelectMenu, UInputMenu, UCheckboxGroup, URadioGroup, UInputDate, UInputTime } from '#components';
-/**
- * 从 Zod schema 中提取自定义元数据
- */
-declare function getAutoFormMetadata(schema: z.ZodType): Record<string, any>;
-declare function defineControl<C extends IsComponent>(e: AutoFormControl<C>): AutoFormControl<C>;
-declare const DEFAULT_CONTROLS: {
-    readonly string: AutoFormControl<typeof UInput>;
-    readonly number: AutoFormControl<typeof UInputNumber>;
-    readonly boolean: AutoFormControl<typeof UCheckbox>;
-    readonly enum: AutoFormControl<typeof USelect>;
-    readonly file: AutoFormControl<typeof UFileUpload>;
-    readonly calendarDate: AutoFormControl<typeof DatePicker>;
-    readonly switch: AutoFormControl<typeof USwitch>;
-    readonly textarea: AutoFormControl<typeof UTextarea>;
-    readonly slider: AutoFormControl<typeof USlider>;
-    readonly pinInput: AutoFormControl<typeof UPinInput>;
-    readonly inputTags: AutoFormControl<typeof UInputTags>;
-    readonly selectMenu: AutoFormControl<typeof USelectMenu>;
-    readonly inputMenu: AutoFormControl<typeof UInputMenu>;
-    readonly checkboxGroup: AutoFormControl<typeof UCheckboxGroup>;
-    readonly radioGroup: AutoFormControl<typeof URadioGroup>;
-    readonly inputDate: AutoFormControl<typeof UInputDate>;
-    readonly inputTime: AutoFormControl<typeof UInputTime>;
-    readonly withClear: AutoFormControl<typeof WithClear>;
-    readonly withPasswordToggle: AutoFormControl<typeof WithPasswordToggle>;
-    readonly withCopy: AutoFormControl<typeof WithCopy>;
-    readonly withCharacterLimit: AutoFormControl<typeof WithCharacterLimit>;
-    readonly colorChooser: AutoFormControl<typeof ColorChooser>;
-    readonly starRating: AutoFormControl<typeof StarRating>;
-    readonly slideVerify: AutoFormControl<typeof SlideVerify>;
-};
-export declare function useAutoForm<TControls extends AutoFormControls = typeof DEFAULT_CONTROLS>(controls?: TControls): {
+import type { AutoFormControls, TypedZodFactory } from '../types/auto-form';
+import { getAutoFormMetadata } from '../domains/auto-form/metadata';
+import { DEFAULT_CONTROLS, defineControl } from '../domains/auto-form/controls';
+type UseAutoFormReturn<TControls extends AutoFormControls> = {
     defineControl: typeof defineControl;
-    afz: TypedZodFactory<TControls, {
-        readonly string: AutoFormControl<typeof UInput>;
-        readonly number: AutoFormControl<typeof UInputNumber>;
-        readonly boolean: AutoFormControl<typeof UCheckbox>;
-        readonly enum: AutoFormControl<typeof USelect>;
-        readonly file: AutoFormControl<typeof UFileUpload>;
-        readonly calendarDate: AutoFormControl<typeof DatePicker>;
-        readonly switch: AutoFormControl<typeof USwitch>;
-        readonly textarea: AutoFormControl<typeof UTextarea>;
-        readonly slider: AutoFormControl<typeof USlider>;
-        readonly pinInput: AutoFormControl<typeof UPinInput>;
-        readonly inputTags: AutoFormControl<typeof UInputTags>;
-        readonly selectMenu: AutoFormControl<typeof USelectMenu>;
-        readonly inputMenu: AutoFormControl<typeof UInputMenu>;
-        readonly checkboxGroup: AutoFormControl<typeof UCheckboxGroup>;
-        readonly radioGroup: AutoFormControl<typeof URadioGroup>;
-        readonly inputDate: AutoFormControl<typeof UInputDate>;
-        readonly inputTime: AutoFormControl<typeof UInputTime>;
-        readonly withClear: AutoFormControl<typeof WithClear>;
-        readonly withPasswordToggle: AutoFormControl<typeof WithPasswordToggle>;
-        readonly withCopy: AutoFormControl<typeof WithCopy>;
-        readonly withCharacterLimit: AutoFormControl<typeof WithCharacterLimit>;
-        readonly colorChooser: AutoFormControl<typeof ColorChooser>;
-        readonly starRating: AutoFormControl<typeof StarRating>;
-        readonly slideVerify: AutoFormControl<typeof SlideVerify>;
-    }>;
-    DEFAULT_CONTROLS: {
-        readonly string: AutoFormControl<typeof UInput>;
-        readonly number: AutoFormControl<typeof UInputNumber>;
-        readonly boolean: AutoFormControl<typeof UCheckbox>;
-        readonly enum: AutoFormControl<typeof USelect>;
-        readonly file: AutoFormControl<typeof UFileUpload>;
-        readonly calendarDate: AutoFormControl<typeof DatePicker>;
-        readonly switch: AutoFormControl<typeof USwitch>;
-        readonly textarea: AutoFormControl<typeof UTextarea>;
-        readonly slider: AutoFormControl<typeof USlider>;
-        readonly pinInput: AutoFormControl<typeof UPinInput>;
-        readonly inputTags: AutoFormControl<typeof UInputTags>;
-        readonly selectMenu: AutoFormControl<typeof USelectMenu>;
-        readonly inputMenu: AutoFormControl<typeof UInputMenu>;
-        readonly checkboxGroup: AutoFormControl<typeof UCheckboxGroup>;
-        readonly radioGroup: AutoFormControl<typeof URadioGroup>;
-        readonly inputDate: AutoFormControl<typeof UInputDate>;
-        readonly inputTime: AutoFormControl<typeof UInputTime>;
-        readonly withClear: AutoFormControl<typeof WithClear>;
-        readonly withPasswordToggle: AutoFormControl<typeof WithPasswordToggle>;
-        readonly withCopy: AutoFormControl<typeof WithCopy>;
-        readonly withCharacterLimit: AutoFormControl<typeof WithCharacterLimit>;
-        readonly colorChooser: AutoFormControl<typeof ColorChooser>;
-        readonly starRating: AutoFormControl<typeof StarRating>;
-        readonly slideVerify: AutoFormControl<typeof SlideVerify>;
-    };
-    controls: TControls | undefined;
+    afz: TypedZodFactory<TControls>;
+    DEFAULT_CONTROLS: typeof DEFAULT_CONTROLS;
+    controls: TControls;
     getAutoFormMetadata: typeof getAutoFormMetadata;
 };
-export {};
+/**
+ * 初始化 AutoForm，返回绑定了 controls 类型的 afz 工厂和工具方法。
+ * 可传入自定义 controls 以扩展或覆盖默认控件映射。
+ */
+export declare function useAutoForm(): UseAutoFormReturn<typeof DEFAULT_CONTROLS>;
+export declare function useAutoForm<const TControls extends AutoFormControls>(controls: TControls): UseAutoFormReturn<typeof DEFAULT_CONTROLS & TControls>;
+export { defineControl, DEFAULT_CONTROLS, getAutoFormMetadata };