@movk/nuxt 1.2.0 → 1.3.0

package/dist/runtime/components/input/WithFloatingLabel.vue

@@ -1,32 +1,43 @@
 <script setup>
-import { computed, useAttrs } from "vue";
+import { useAttrs } from "vue";
 import { UInput, UButton } from "#components";
 import { isEmpty } from "@movk/core";
+import { useAppConfig } from "#imports";
+import theme from "#build/movk-ui/with-floating-label";
+import inputTheme from "#build/ui/input";
+import { useExtendedTv } from "../../utils/extend-theme";
+import { useFormFieldBridge, useForwardedProps } from "../../utils/form-control";
 const props = defineProps({
   label: { type: String, required: false },
-  labelClass: { type: [Array, String, null, Number, Boolean], required: false, skipCheck: true },
-  clearButtonProps: { type: Object, required: false }
+  size: { type: null, required: false },
+  clearButtonProps: { type: Object, required: false },
+  ui: { type: Object, required: false }
 });
-const emit = defineEmits(["update:modelValue", "blur", "change", "clear"]);
+const emits = defineEmits(["update:modelValue", "blur", "change", "clear"]);
 const slots = defineSlots();
 defineOptions({ inheritAttrs: false });
 const attrs = useAttrs();
+const appConfig = useAppConfig();
 const modelValue = defineModel({ type: null });
-const labelLeftClass = computed(() => {
-  const hasLeading = !!(attrs["leading-icon"] || attrs.avatar || attrs.leadingIcon || slots.leading);
-  if (!hasLeading) return "left-0";
-  const offsetMap = {
-    xs: "left-5",
-    sm: "left-6",
-    md: "left-7",
-    lg: "left-8",
-    xl: "left-9"
-  };
-  return offsetMap[attrs.size ?? "md"] ?? "left-7";
-});
+const inputProps = useForwardedProps(props, ["ui", "label", "clearButtonProps", "placeholder", "defaultValue", "modelModifiers"]);
+const { size: effectiveSize, emitFormChange, emitFormInput } = useFormFieldBridge(props);
+const { baseUi, extraUi } = useExtendedTv(
+  inputTheme,
+  theme,
+  () => appConfig.movk?.withFloatingLabel,
+  () => ({
+    ui: props.ui,
+    variants: {
+      size: effectiveSize.value,
+      hasLeading: !!(attrs["leading-icon"] || attrs.avatar || attrs.leadingIcon || attrs.icon || slots.leading)
+    }
+  })
+);
 function handleClear() {
   modelValue.value = void 0;
-  emit("clear");
+  emitFormInput();
+  emitFormChange();
+  emits("clear");
 }
 </script>
 
@@ -34,21 +45,18 @@ function handleClear() {
   <UInput
     v-model="modelValue"
     :placeholder="props.placeholder ?? ''"
-    :ui="{ base: 'peer', trailing: 'pe-1' }"
-    v-bind="$attrs"
-    @blur="emit('blur', $event)"
-    @change="emit('change', $event)"
+    :ui="baseUi"
+    v-bind="{ ...inputProps, ...attrs }"
+    @blur="emits('blur', $event)"
+    @change="emits('change', $event)"
   >
     <template v-for="(_, slotName) in slots" :key="slotName" #[slotName]="slotProps">
       <slot :name="slotName" v-bind="slotProps ?? {}" />
     </template>
 
     <template v-if="props.label" #default>
-      <label
-        class="pointer-events-none absolute -top-2.5 text-highlighted text-xs font-medium px-1.5 transition-all peer-focus:-top-2.5 peer-focus:text-highlighted peer-focus:text-xs peer-focus:font-medium peer-placeholder-shown:text-sm peer-placeholder-shown:text-dimmed peer-placeholder-shown:top-1.5 peer-placeholder-shown:font-normal"
-        :class="[labelLeftClass, props.labelClass]"
-      >
-        <span class="inline-flex bg-default px-1">{{ props.label }}</span>
+      <label :class="extraUi.label">
+        <span :class="extraUi.labelText">{{ props.label }}</span>
       </label>
     </template>
 
@@ -56,7 +64,7 @@ function handleClear() {
       <UButton
         color="neutral"
         variant="link"
-        size="sm"
+        :size="effectiveSize"
         icon="i-lucide-circle-x"
         aria-label="Clear input"
         v-bind="props.clearButtonProps"

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

@@ -1,29 +1,26 @@
-import { type OmitByKey } from '@movk/core';
-import type { ButtonProps, InputEmits, InputProps, InputSlots, InputValue } from '@nuxt/ui';
-import type { ClassNameValue } from '../../types/index.js';
-export interface WithFloatingLabelProps<T extends InputValue = InputValue> extends /** @vue-ignore */ OmitByKey<InputProps<T>, 'modelValue'> {
-    /** 浮动标签文本 */
-    label?: string;
-    /** 浮动标签的自定义样式类 */
-    labelClass?: ClassNameValue;
-    /** 清除按钮的自定义属性 */
-    clearButtonProps?: ButtonProps;
-}
-export type WithFloatingLabelEmits<T extends InputValue = InputValue> = InputEmits<T> & {
-    clear: [];
-};
+import type { InputSlots, InputValue, ComponentConfig } from '@nuxt/ui';
+import type { OmitByKey } from '@movk/core';
+import theme from '#build/movk-ui/with-floating-label';
+import inputTheme from '#build/ui/input';
+import type { AppConfig } from 'nuxt/schema';
+import type { WithFloatingLabelProps } from '../../types/components/input/with-floating-label';
 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<(WithFloatingLabelProps<T> & {
+        ui?: ComponentConfig<typeof inputTheme & typeof theme, AppConfig, "withFloatingLabel">["slots"];
+    } & {
         modelValue?: T;
     }) & {
-        [x: `on${Capitalize<string>}`]: ((...args: any) => any) | undefined;
+        onClear?: (() => any) | undefined;
+        onBlur?: ((event: FocusEvent) => any) | undefined;
+        onChange?: ((event: Event) => any) | undefined;
+        "onUpdate:modelValue"?: ((value: T | undefined) => any) | undefined;
     }> & (typeof globalThis extends {
         __VLS_PROPS_FALLBACK: infer P;
     } ? P : {});
     expose: (exposed: {}) => void;
     attrs: any;
     slots: OmitByKey<InputSlots, "default" | "trailing">;
-    emit: any & ((event: "update:modelValue", value: T | undefined) => void);
+    emit: (((evt: "clear") => void) & ((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/input/WithPasswordToggle.d.vue.ts

@@ -1,21 +1,25 @@
+import type { InputSlots, InputValue, ComponentConfig } from '@nuxt/ui';
 import type { OmitByKey } from '@movk/core';
-import type { ButtonProps, InputProps, InputSlots, InputValue } from '@nuxt/ui';
-export interface WithPasswordToggleProps<T extends InputValue = InputValue> extends /** @vue-ignore */ OmitByKey<InputProps<T>, 'type' | 'modelValue'> {
-    /** 切换按钮的自定义属性 */
-    buttonProps?: ButtonProps;
-}
+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<T> & {
+        ui?: ComponentConfig<typeof inputTheme & typeof theme, AppConfig, "withPasswordToggle">["slots"];
+    } & {
         modelValue?: T;
     }) & {
-        [x: `on${Capitalize<string>}`]: ((...args: any) => any) | undefined;
+        onBlur?: ((event: FocusEvent) => any) | undefined;
+        onChange?: ((event: Event) => any) | undefined;
+        "onUpdate:modelValue"?: ((value: T | undefined) => any) | undefined;
     }> & (typeof globalThis extends {
         __VLS_PROPS_FALLBACK: infer P;
     } ? P : {});
     expose: (exposed: {}) => void;
     attrs: any;
     slots: OmitByKey<InputSlots, "trailing">;
-    emit: any & ((event: "update:modelValue", value: T | undefined) => void);
+    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/input/WithPasswordToggle.vue

@@ -1,13 +1,30 @@
 <script setup>
+import { useAttrs } from "vue";
 import { UInput, UButton } from "#components";
 import { useToggle } from "@vueuse/core";
+import { useAppConfig } from "#imports";
+import theme from "#build/movk-ui/with-password-toggle";
+import inputTheme from "#build/ui/input";
+import { useExtendedTv } from "../../utils/extend-theme";
+import { useFormFieldBridge, useForwardedProps } from "../../utils/form-control";
 const props = defineProps({
-  buttonProps: { type: Object, required: false }
+  buttonProps: { type: Object, required: false },
+  ui: { type: Object, required: false }
 });
-const emit = defineEmits(["update:modelValue", "blur", "change"]);
+const emits = defineEmits(["update:modelValue", "blur", "change"]);
 const slots = defineSlots();
 defineOptions({ inheritAttrs: false });
+const attrs = useAttrs();
+const appConfig = useAppConfig();
 const modelValue = defineModel({ type: null });
+const inputProps = useForwardedProps(props, ["ui", "buttonProps", "defaultValue", "modelModifiers"]);
+const { size: buttonSize } = useFormFieldBridge(props);
+const { baseUi } = useExtendedTv(
+  inputTheme,
+  theme,
+  () => appConfig.movk?.withPasswordToggle,
+  () => ({ ui: props.ui })
+);
 const [value, toggle] = useToggle(false);
 </script>
 
@@ -15,10 +32,10 @@ const [value, toggle] = useToggle(false);
   <UInput
     v-model="modelValue"
     :type="value ? 'text' : 'password'"
-    :ui="{ trailing: 'pe-1' }"
-    v-bind="$attrs"
-    @blur="emit('blur', $event)"
-    @change="emit('change', $event)"
+    :ui="baseUi"
+    v-bind="{ ...inputProps, ...attrs }"
+    @blur="emits('blur', $event)"
+    @change="emits('change', $event)"
   >
     <template v-for="(_, slotName) in slots" :key="slotName" #[slotName]="slotProps">
       <slot :name="slotName" v-bind="slotProps ?? {}" />
@@ -28,7 +45,7 @@ const [value, toggle] = useToggle(false);
       <UButton
         color="neutral"
         variant="link"
-        size="sm"
+        :size="buttonSize"
         :icon="value ? 'i-lucide-eye-off' : 'i-lucide-eye'"
         :aria-label="value ? 'Hide password' : 'Show password'"
         :aria-pressed="value"

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

@@ -1,21 +1,25 @@
+import type { InputSlots, InputValue, ComponentConfig } from '@nuxt/ui';
 import type { OmitByKey } from '@movk/core';
-import type { ButtonProps, InputProps, InputSlots, InputValue } from '@nuxt/ui';
-export interface WithPasswordToggleProps<T extends InputValue = InputValue> extends /** @vue-ignore */ OmitByKey<InputProps<T>, 'type' | 'modelValue'> {
-    /** 切换按钮的自定义属性 */
-    buttonProps?: ButtonProps;
-}
+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<T> & {
+        ui?: ComponentConfig<typeof inputTheme & typeof theme, AppConfig, "withPasswordToggle">["slots"];
+    } & {
         modelValue?: T;
     }) & {
-        [x: `on${Capitalize<string>}`]: ((...args: any) => any) | undefined;
+        onBlur?: ((event: FocusEvent) => any) | undefined;
+        onChange?: ((event: Event) => any) | undefined;
+        "onUpdate:modelValue"?: ((value: T | undefined) => any) | undefined;
     }> & (typeof globalThis extends {
         __VLS_PROPS_FALLBACK: infer P;
     } ? P : {});
     expose: (exposed: {}) => void;
     attrs: any;
     slots: OmitByKey<InputSlots, "trailing">;
-    emit: any & ((event: "update:modelValue", value: T | undefined) => void);
+    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: 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

@@ -1,19 +1,33 @@
 <script setup>
-import { useColorMode } from "#imports";
+import { useAppConfig, useColorMode } from "#imports";
 import { useClipboard } from "@vueuse/core";
 import { ref } from "vue";
-import { useTheme } from "../../composables";
+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,
   fonts,
@@ -23,15 +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"
@@ -63,7 +78,7 @@ const {
           <ThemePickerButton
             label="Black"
             :selected="blackAsPrimary"
-            @click="blackAsPrimary = true"
+            @click="setBlackAsPrimary(true)"
           >
             <template #leading>
               <span class="inline-block size-2 rounded-full bg-black dark:bg-white" />
@@ -217,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>
@@ -234,14 +249,14 @@ const {
             @click="copyCSS(exportCSS())"
           />
           <UButton
-            v-if="hasAppConfigChanges"
+            v-if="hasConfigChanges"
             color="neutral"
             variant="soft"
             size="sm"
-            label="app.config.ts"
-            :icon="copiedAppConfig ? 'i-lucide-copy-check' : 'i-lucide-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: 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,10 +1,15 @@
-type __VLS_Slots = {
+interface ThemePickerButtonProps {
+    label: string;
+    icon?: string;
+    chip?: string;
+    selected?: boolean;
+}
+interface ThemePickerButtonSlots {
     leading: () => 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;
+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,10 +1,15 @@
-type __VLS_Slots = {
+interface ThemePickerButtonProps {
+    label: string;
+    icon?: string;
+    chip?: string;
+    selected?: boolean;
+}
+interface ThemePickerButtonSlots {
     leading: () => 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;
+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 './useLazyApiFetch.js';
-export * from './useClientApiFetch.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

@@ -6,3 +6,4 @@ 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,11 +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 的薄封装，自动注入 $api 实例。
  * 所有核心能力（认证、业务检查、数据解包、Toast）由 $api interceptors 统一处理。
  *
- * @typeParam T - 业务数据类型（已由 $api 自动解包）
+ * @typeParam T - 业务数据类型（默认已由 $api 自动解包；skipUnwrap 时为原始响应类型）
  *
  * @example
  * ```ts
@@ -31,15 +32,19 @@ import type { UseApiFetchOptions, UseApiFetchReturn } from '../types/api.js';
  *   toast: { successMessage: '加载成功' }
  * })
  *
- * // 跳过业务检查（直接返回原始响应）
- * const { data } = await useApiFetch('/external', { skipBusinessCheck: true })
+ * // 跳过业务状态码校验（仍按 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 }) {
+ *     // response._data 已是解包后的业务数据（除非传入 skipUnwrap: true）
  *     console.log('自定义处理:', response._data)
  *   }
  * })
  * ```
  */
-export declare function useApiFetch<T = unknown, DataT = T>(url: string | (() => string), options?: UseApiFetchOptions<T, 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,16 +1,34 @@
-import { useNuxtApp, useFetch } from "#imports";
+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,
+    skipUnwrap,
     ...fetchOptions
   } = options;
   const apiInstance = endpoint ? $api.use(endpoint) : $api;
+  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)
+    });
+  });
   return useFetch(url, {
     ...fetchOptions,
+    key: fetchKey,
     $fetch: apiInstance,
-    context: { toast, skipBusinessCheck }
+    context: { toast, skipBusinessCheck, skipUnwrap }
   });
 }

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

@@ -1,7 +1,6 @@
-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 };
+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>;
@@ -15,3 +14,4 @@ type UseAutoFormReturn<TControls extends AutoFormControls> = {
  */
 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 };

package/dist/runtime/composables/useAutoForm.js

@@ -1,10 +1,10 @@
 import { z } from "zod";
 import { isObject } from "@movk/core";
-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 { applyMeta, extractErrorAndMeta, getAutoFormMetadata } from "../domains/auto-form/metadata.js";
+import { DEFAULT_CONTROLS, defineControl } from "../domains/auto-form/controls.js";
+import { extractEnumValuesFromItems } from "../domains/auto-form/fields.js";
 import { useDateFormatter } from "./useDateFormatter.js";
+import { AUTOFORM_META } from "../domains/auto-form/constants.js";
 function createBasicFactory(zodFactory) {
   return (controlMeta) => {
     const [error, meta] = extractErrorAndMeta(controlMeta);
@@ -12,19 +12,33 @@ function createBasicFactory(zodFactory) {
     return applyMeta(schema, meta || {});
   };
 }
+const DEFAULT_VALUE_FORMAT = "date-value";
+const VALUE_FORMATS = ["date-value", "iso", "timestamp", "unix", "date"];
+function isValueFormat(value) {
+  return typeof value === "string" && VALUE_FORMATS.includes(value);
+}
+function resolveStaticValueFormat(meta) {
+  if (!isObject(meta)) return DEFAULT_VALUE_FORMAT;
+  const controlProps = meta.controlProps;
+  if (!isObject(controlProps)) return DEFAULT_VALUE_FORMAT;
+  const valueFormat = controlProps.valueFormat;
+  return isValueFormat(valueFormat) ? valueFormat : DEFAULT_VALUE_FORMAT;
+}
 function createCalendarDateFactory(type = "calendarDate") {
-  const { isDateValue, isDateRange } = useDateFormatter();
+  const { fromFormat, isDateRange } = useDateFormatter();
   return (controlMeta) => {
     const [error, meta] = extractErrorAndMeta(controlMeta);
+    const valueFormat = resolveStaticValueFormat(meta);
+    const isValidDateValue = (value) => fromFormat(value, valueFormat) !== null;
     const schema = z.custom().refine(
       (val) => {
-        if (isDateValue(val)) return true;
+        if (isValidDateValue(val)) return true;
         if (isDateRange(val)) {
           const range = val;
-          return isDateValue(range.start) && isDateValue(range.end);
+          return isValidDateValue(range.start) && isValidDateValue(range.end);
         }
         if (Array.isArray(val)) {
-          return val.length > 0 && val.every((item) => isDateValue(item));
+          return val.length > 0 && val.every(isValidDateValue);
         }
         return false;
       },
@@ -88,7 +102,6 @@ function createEnumFactory() {
     return applyOverwrite(z.enum(enumValues), overwrite);
   };
 }
-export { defineControl, DEFAULT_CONTROLS, getAutoFormMetadata };
 export function useAutoForm(controls) {
   function createZodFactory() {
     return {
@@ -124,3 +137,4 @@ export function useAutoForm(controls) {
     getAutoFormMetadata
   };
 }
+export { defineControl, DEFAULT_CONTROLS, getAutoFormMetadata };

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

@@ -1,4 +1,5 @@
-import type { UseApiFetchOptions, UseApiFetchReturn } from '../types/api.js';
+import type { NitroFetchRequest } from 'nitropack/types';
+import type { UseApiFetchOptions, UseApiFetchReturn } from '../types/api';
 /**
  * 仅客户端执行的 useApiFetch
  *
@@ -20,4 +21,4 @@ import type { UseApiFetchOptions, UseApiFetchReturn } from '../types/api.js';
  * })
  * ```
  */
-export declare function useClientApiFetch<T = unknown, DataT = T>(url: string | (() => string), options?: UseApiFetchOptions<T, DataT>): UseApiFetchReturn<DataT>;
+export declare function useClientApiFetch<T = unknown, DataT = T>(url: NitroFetchRequest | (() => NitroFetchRequest), options?: UseApiFetchOptions<T, DataT>): UseApiFetchReturn<DataT>;