@movk/nuxt 1.1.2 → 1.2.0

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

@@ -1,13 +1,7 @@
-type __VLS_Props = {
-    label: string;
-    icon?: string;
-    chip?: string;
-    selected?: boolean;
-};
 type __VLS_Slots = {
     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_base: any;
 declare const __VLS_export: __VLS_WithSlots<typeof __VLS_base, __VLS_Slots>;
 declare const _default: typeof __VLS_export;
 export default _default;

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

@@ -1,6 +1,6 @@
 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';

package/dist/runtime/composables/index.js

@@ -1,6 +1,6 @@
 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";

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

@@ -2,15 +2,10 @@ import type { UseApiFetchOptions, UseApiFetchReturn } from '../types/api.js';
 /**
  * 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 自动解包）
  *
  * @example
  * ```ts
@@ -23,20 +18,28 @@ 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: '加载成功' }
+ * })
+ *
+ * // 跳过业务检查（直接返回原始响应）
+ * const { data } = await useApiFetch('/external', { skipBusinessCheck: true })
+ *
+ * // 用户自定义 hooks（通过 useFetch 原生选项透传）
  * const { data } = await useApiFetch('/users', {
  *   onResponse({ response }) {
- *     console.log('用户自定义处理:', response._data)
+ *     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: string | (() => string), options?: UseApiFetchOptions<T, DataT>): UseApiFetchReturn<DataT>;

package/dist/runtime/composables/useApiFetch.js

@@ -1,41 +1,16 @@
 import { useNuxtApp, useFetch } from "#imports";
-import { createTransform, mergeFetchHooks } from "../utils/api-utils.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,
     ...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 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
+    $fetch: apiInstance,
+    context: { toast, skipBusinessCheck }
   });
 }

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.js';
+import { getAutoFormMetadata } from '../auto-form/metadata.js';
+import { DEFAULT_CONTROLS, defineControl } from '../auto-form/controls.js';
+export { defineControl, DEFAULT_CONTROLS, getAutoFormMetadata };
+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>;

package/dist/runtime/composables/useAutoForm.js

@@ -1,78 +1,10 @@
-import { z } from "zod/v4";
-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 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";
+import { z } from "zod";
 import { isObject } from "@movk/core";
-import { AUTOFORM_META, CLONE_METHODS } from "../constants/auto-form.js";
+import { AUTOFORM_META } from "../constants/auto-form.js";
+import { applyMeta, extractErrorAndMeta, getAutoFormMetadata } from "../auto-form/metadata.js";
+import { DEFAULT_CONTROLS, defineControl } from "../auto-form/controls.js";
+import { extractEnumValuesFromItems } from "../auto-form/field-utils.js";
 import { useDateFormatter } from "./useDateFormatter.js";
-import { extractEnumValuesFromItems } from "../utils/auto-form.js";
-function interceptCloneMethods(schema, customMeta) {
-  for (const methodName of CLONE_METHODS) {
-    const originalMethod = schema[methodName];
-    if (typeof originalMethod !== "function")
-      continue;
-    schema[methodName] = function(...args) {
-      const newSchema = originalMethod.apply(this, args);
-      if (!newSchema?._def)
-        return newSchema;
-      const newMeta = methodName === "meta" && args[0] ? { ...customMeta || {}, ...args[0] || {} } : customMeta || {};
-      newSchema[AUTOFORM_META.KEY] = newMeta;
-      return interceptCloneMethods(newSchema, newMeta);
-    };
-  }
-  return schema;
-}
-function applyMeta(schema, meta = {}) {
-  schema[AUTOFORM_META.KEY] = meta;
-  interceptCloneMethods(schema, meta);
-  return schema;
-}
-function getAutoFormMetadata(schema) {
-  const meta = schema[AUTOFORM_META.KEY];
-  if (meta)
-    return meta;
-  if ("unwrap" in schema && typeof schema.unwrap === "function") {
-    try {
-      const unwrapped = schema.unwrap();
-      return unwrapped?.[AUTOFORM_META.KEY] || {};
-    } catch {
-    }
-  }
-  return {};
-}
-function extractErrorAndMeta(controlMeta) {
-  if (typeof controlMeta === "string") {
-    return [controlMeta, void 0];
-  }
-  if (controlMeta && isObject(controlMeta) && "error" in controlMeta) {
-    const { error, ...meta } = controlMeta;
-    return [error, meta];
-  }
-  return [void 0, controlMeta];
-}
 function createBasicFactory(zodFactory) {
   return (controlMeta) => {
     const [error, meta] = extractErrorAndMeta(controlMeta);
@@ -102,17 +34,15 @@ function createCalendarDateFactory(type = "calendarDate") {
     return applyMeta(schema, { ...meta || {}, type: finalType });
   };
 }
-function createInputTimeFactory() {
-  return (controlMeta) => {
-    const [error, meta] = extractErrorAndMeta(controlMeta);
-    const schema = z.custom().refine(
-      (val) => {
-        return val !== null && val !== void 0 && typeof val === "object" && "hour" in val && "minute" in val && typeof val.hour === "number" && typeof val.minute === "number";
-      },
-      { message: error || "\u65E0\u6548\u7684\u65F6\u95F4\u683C\u5F0F" }
-    );
-    return applyMeta(schema, { ...meta || {}, type: "inputTime" });
-  };
+function inputTimeFactory(controlMeta) {
+  const [error, meta] = extractErrorAndMeta(controlMeta);
+  const schema = z.custom().refine(
+    (val) => {
+      return val !== null && val !== void 0 && typeof val === "object" && "hour" in val && "minute" in val && typeof val.hour === "number" && typeof val.minute === "number";
+    },
+    { message: error || "\u65E0\u6548\u7684\u65F6\u95F4\u683C\u5F0F" }
+  );
+  return applyMeta(schema, { ...meta || {}, type: "inputTime" });
 }
 function createISOFactory(type) {
   return (controlMeta) => {
@@ -122,41 +52,35 @@ function createISOFactory(type) {
   };
 }
 function applyOverwrite(schema, overwrite) {
-  return overwrite && isObject(overwrite) ? applyMeta(schema, { overwrite }) : applyMeta(schema, {});
+  return applyMeta(schema, overwrite && isObject(overwrite) ? { overwrite } : void 0);
 }
 function createObjectFactory(method) {
+  const createSchema = (shape) => z[method](shape);
   return (shapeOrNothing, meta) => {
     if (shapeOrNothing === void 0) {
-      return (shape, innerMeta) => applyMeta(z[method](shape), innerMeta || {});
+      return (shape, innerMeta) => applyMeta(createSchema(shape), innerMeta);
     }
-    return applyMeta(z[method](shapeOrNothing), meta || {});
+    return applyMeta(createSchema(shapeOrNothing), meta);
   };
 }
-function createLayoutFactory() {
-  return (config) => {
-    return applyMeta(z.custom(), {
-      type: AUTOFORM_META.LAYOUT_KEY,
-      layout: config
-    });
-  };
+function layoutFactory(config) {
+  return applyMeta(z.custom(), {
+    type: AUTOFORM_META.LAYOUT_KEY,
+    layout: config
+  });
 }
-function createArrayFactory() {
-  return (schema, overwrite) => applyOverwrite(z.array(schema), overwrite);
+function arrayFactory(schema, overwrite) {
+  return applyOverwrite(z.array(schema), overwrite);
 }
-function createTupleFactory() {
-  return (schemas, overwrite) => applyOverwrite(z.tuple(schemas), overwrite);
+function tupleFactory(schemas, overwrite) {
+  return applyOverwrite(z.tuple(schemas), overwrite);
 }
 function createEnumFactory() {
   return (values, overwrite) => {
     let enumValues = values;
     if ((!values || Array.isArray(values) && values.length === 0) && overwrite?.controlProps?.items) {
       const valueKey = overwrite.controlProps.valueKey;
-      const extractedValues = extractEnumValuesFromItems(overwrite.controlProps.items, valueKey);
-      if (extractedValues.length > 0) {
-        enumValues = extractedValues;
-      } else {
-        enumValues = [];
-      }
+      enumValues = extractEnumValuesFromItems(overwrite.controlProps.items, valueKey);
     }
     if (!enumValues || Array.isArray(enumValues) && enumValues.length === 0) {
       return applyOverwrite(z.string(), overwrite);
@@ -164,83 +88,39 @@ function createEnumFactory() {
     return applyOverwrite(z.enum(enumValues), overwrite);
   };
 }
-const DEFAULT_CONTROL_PROPS = { class: "w-full" };
-function defineControl(e) {
-  return e;
-}
-const DEFAULT_CONTROLS = {
-  // 基础类型
-  string: defineControl({ component: UInput, controlProps: DEFAULT_CONTROL_PROPS }),
-  number: defineControl({ component: UInputNumber, controlProps: DEFAULT_CONTROL_PROPS }),
-  boolean: defineControl({ component: UCheckbox, controlProps: DEFAULT_CONTROL_PROPS }),
-  enum: defineControl({ component: USelect, controlProps: DEFAULT_CONTROL_PROPS }),
-  file: defineControl({ component: UFileUpload, controlProps: DEFAULT_CONTROL_PROPS }),
-  calendarDate: defineControl({ component: DatePicker, controlProps: DEFAULT_CONTROL_PROPS }),
-  // 扩展类型
-  switch: defineControl({ component: USwitch, controlProps: DEFAULT_CONTROL_PROPS }),
-  textarea: defineControl({ component: UTextarea, controlProps: DEFAULT_CONTROL_PROPS }),
-  slider: defineControl({ component: USlider, controlProps: DEFAULT_CONTROL_PROPS }),
-  pinInput: defineControl({ component: UPinInput, controlProps: DEFAULT_CONTROL_PROPS }),
-  inputTags: defineControl({ component: UInputTags, controlProps: DEFAULT_CONTROL_PROPS }),
-  selectMenu: defineControl({ component: USelectMenu, controlProps: DEFAULT_CONTROL_PROPS }),
-  inputMenu: defineControl({ component: UInputMenu, controlProps: DEFAULT_CONTROL_PROPS }),
-  checkboxGroup: defineControl({ component: UCheckboxGroup, controlProps: DEFAULT_CONTROL_PROPS }),
-  radioGroup: defineControl({ component: URadioGroup, controlProps: DEFAULT_CONTROL_PROPS }),
-  inputDate: defineControl({ component: UInputDate, controlProps: DEFAULT_CONTROL_PROPS }),
-  inputTime: defineControl({ component: UInputTime, controlProps: DEFAULT_CONTROL_PROPS }),
-  // 自定义增强型组件
-  withClear: defineControl({ component: WithClear, controlProps: DEFAULT_CONTROL_PROPS }),
-  withPasswordToggle: defineControl({ component: WithPasswordToggle, controlProps: DEFAULT_CONTROL_PROPS }),
-  withCopy: defineControl({ component: WithCopy, controlProps: DEFAULT_CONTROL_PROPS }),
-  withCharacterLimit: defineControl({ component: WithCharacterLimit, controlProps: DEFAULT_CONTROL_PROPS }),
-  colorChooser: defineControl({ component: ColorChooser, controlProps: DEFAULT_CONTROL_PROPS }),
-  starRating: defineControl({ component: StarRating, controlProps: DEFAULT_CONTROL_PROPS }),
-  slideVerify: defineControl({ component: SlideVerify, controlProps: DEFAULT_CONTROL_PROPS })
-};
+export { defineControl, DEFAULT_CONTROLS, getAutoFormMetadata };
 export function useAutoForm(controls) {
-  function createZodFactory(_controls) {
+  function createZodFactory() {
     return {
-      // 基础类型
       string: createBasicFactory(z.string),
       number: createBasicFactory(z.number),
       boolean: createBasicFactory(z.boolean),
       file: createBasicFactory(z.file),
-      // 日期和时间类型
       calendarDate: createCalendarDateFactory(),
       inputDate: createCalendarDateFactory("inputDate"),
-      inputTime: createInputTimeFactory(),
-      // ISO 字符串类型
+      inputTime: inputTimeFactory,
       isoDatetime: createISOFactory("datetime"),
       isoDate: createISOFactory("date"),
       isoTime: createISOFactory("time"),
-      // Zod v4 专用验证函数
       email: createBasicFactory(z.email),
       url: createBasicFactory(z.url),
       uuid: createBasicFactory(z.uuid),
-      // 集合类型
-      array: createArrayFactory(),
-      tuple: createTupleFactory(),
+      array: arrayFactory,
+      tuple: tupleFactory,
       enum: createEnumFactory(),
-      // 布局系统
-      layout: createLayoutFactory(),
-      // 对象类型
+      layout: layoutFactory,
       object: createObjectFactory("object"),
       looseObject: createObjectFactory("looseObject"),
       strictObject: createObjectFactory("strictObject")
     };
   }
-  const builtControls = controls ? Object.fromEntries(
-    Object.entries(controls).map(([key, control]) => [
-      key,
-      defineControl(control)
-    ])
-  ) : void 0;
-  const afz = createZodFactory(builtControls);
+  const mergedControls = controls ? { ...DEFAULT_CONTROLS, ...controls } : DEFAULT_CONTROLS;
+  const afz = createZodFactory();
   return {
     defineControl,
     afz,
     DEFAULT_CONTROLS,
-    controls,
+    controls: mergedControls,
     getAutoFormMetadata
   };
 }

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

@@ -5,8 +5,7 @@ import type { UseApiFetchOptions, UseApiFetchReturn } from '../types/api.js';
  * 设置 `server: false, lazy: true`
  * 适合非 SEO 敏感数据，需手动调用 execute() 触发请求
  *
- * @typeParam ResT - API 响应 data 字段的原始类型
- * @typeParam DataT - transform 转换后的最终类型（默认等于 ResT）
+ * @typeParam T - 业务数据类型（已由 $api 自动解包）
  *
  * @example
  * ```ts
@@ -15,10 +14,10 @@ import type { UseApiFetchOptions, UseApiFetchReturn } from '../types/api.js';
  * // 在 onMounted 或用户操作时触发
  * onMounted(() => execute())
  *
- * // 使用 transform 转换数据（接收解包后的数据）
- * const { data } = useClientApiFetch<{ content: User[] }, User[]>('/users', {
- *   transform: ({ content }) => content ?? []
+ * // 使用 transform 转换数据（接收已解包的业务数据）
+ * const { data } = useClientApiFetch<User[]>('/users', {
+ *   transform: (users) => users.filter(u => u.active)
  * })
  * ```
  */
-export declare function useClientApiFetch<ResT = unknown, DataT = ResT>(url: string | (() => string), options?: UseApiFetchOptions<ResT, DataT>): UseApiFetchReturn<DataT>;
+export declare function useClientApiFetch<T = unknown, DataT = T>(url: string | (() => string), options?: UseApiFetchOptions<T, DataT>): UseApiFetchReturn<DataT>;

package/dist/runtime/composables/useDownloadWithProgress.js

@@ -1,8 +1,8 @@
-import { ref, useNuxtApp } from "#imports";
+import { ref, useRuntimeConfig } from "#imports";
 import { extractFilename, triggerDownload } from "@movk/core";
-import { showToast, extractToastMessage, getAuthHeaders } from "../utils/api-utils.js";
+import { showToast, extractToastMessage, getAuthHeaders, resolveEndpointConfig } from "../utils/api-utils.js";
 export function useDownloadWithProgress() {
-  const { $api } = useNuxtApp();
+  const publicConfig = useRuntimeConfig().public.movkApi;
   const progress = ref(0);
   const downloading = ref(false);
   const error = ref(null);
@@ -15,9 +15,8 @@ export function useDownloadWithProgress() {
   };
   const download = async (url, options = {}) => {
     const { filename, headers = {}, toast, endpoint, onSuccess, onError } = options;
-    const apiInstance = endpoint ? $api.use(endpoint) : $api;
-    const config = apiInstance.getConfig();
-    const fullUrl = `${config.baseURL || ""}${url}`;
+    const config = resolveEndpointConfig(publicConfig, endpoint);
+    const fullUrl = `${config.baseURL}${url}`;
     progress.value = 0;
     downloading.value = true;
     error.value = null;

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

@@ -0,0 +1,18 @@
+import type { UseApiFetchOptions, UseApiFetchReturn } from '../types/api.js';
+/**
+ * 懒加载版 useApiFetch
+ *
+ * 等价于 `useApiFetch(url, { lazy: true, ...options })`
+ * 不阻塞客户端导航，页面立即显示，数据在后台加载
+ *
+ * @typeParam T - 业务数据类型（已由 $api 自动解包）
+ *
+ * @example
+ * ```ts
+ * const { data, status } = useLazyApiFetch<Post[]>('/posts')
+ *
+ * // 需要手动处理 loading 状态
+ * // <div v-if="status === 'pending'">Loading...</div>
+ * ```
+ */
+export declare function useLazyApiFetch<T = unknown, DataT = T>(url: string | (() => string), options?: UseApiFetchOptions<T, DataT>): UseApiFetchReturn<DataT>;

package/dist/runtime/composables/useLazyApiFetch.js

@@ -0,0 +1,4 @@
+import { useApiFetch } from "./useApiFetch.js";
+export function useLazyApiFetch(url, options = {}) {
+  return useApiFetch(url, { ...options, lazy: true });
+}

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

@@ -1,26 +1,29 @@
 export declare function useTheme(): {
-    neutralColors: readonly ["slate", "gray", "zinc", "neutral", "stone"];
-    neutral: import("vue").WritableComputedRef<any, any>;
+    style: {
+        innerHTML: any;
+        id: string;
+        tagPriority: number;
+    }[];
+    link: any;
+    neutralColors: string[];
+    neutral: any;
     primaryColors: string[];
-    primary: import("vue").WritableComputedRef<any, any>;
-    setBlackAsPrimary: (value: boolean) => void;
+    primary: any;
+    blackAsPrimary: import("@vueuse/core").RemovableRef<boolean>;
     radiuses: number[];
-    radius: import("vue").WritableComputedRef<any, any>;
+    radius: import("@vueuse/core").RemovableRef<number>;
     fonts: string[];
-    font: import("vue").WritableComputedRef<any, any>;
-    icon: import("vue").WritableComputedRef<any, any>;
+    font: import("@vueuse/core").RemovableRef<string>;
+    icon: any;
     icons: {
         label: string;
         icon: string;
         value: string;
     }[];
-    modes: {
-        label: string;
-        icon: any;
-    }[];
-    mode: import("vue").WritableComputedRef<any, any>;
-    hasCSSChanges: import("vue").ComputedRef<any>;
-    hasAppConfigChanges: import("vue").ComputedRef<boolean>;
+    modes: any;
+    mode: any;
+    hasCSSChanges: any;
+    hasAppConfigChanges: any;
     exportCSS: () => string;
     exportAppConfig: () => string;
     resetTheme: () => void;