@movk/nuxt 1.1.2 → 1.3.0

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 { 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 { 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];
-}
+import { AUTOFORM_META } from "../domains/auto-form/constants.js";
 function createBasicFactory(zodFactory) {
   return (controlMeta) => {
     const [error, meta] = extractErrorAndMeta(controlMeta);
@@ -80,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;
       },
@@ -102,17 +48,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 +66,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 +102,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 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
   };
 }
+export { defineControl, DEFAULT_CONTROLS, getAutoFormMetadata };

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

@@ -1,12 +1,12 @@
-import type { UseApiFetchOptions, UseApiFetchReturn } from '../types/api.js';
+import type { NitroFetchRequest } from 'nitropack/types';
+import type { UseApiFetchOptions, UseApiFetchReturn } from '../types/api';
 /**
  * 仅客户端执行的 useApiFetch
  *
  * 设置 `server: false, lazy: true`
  * 适合非 SEO 敏感数据，需手动调用 execute() 触发请求
  *
- * @typeParam ResT - API 响应 data 字段的原始类型
- * @typeParam DataT - transform 转换后的最终类型（默认等于 ResT）
+ * @typeParam T - 业务数据类型（已由 $api 自动解包）
  *
  * @example
  * ```ts
@@ -15,10 +15,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: NitroFetchRequest | (() => NitroFetchRequest), options?: UseApiFetchOptions<T, DataT>): UseApiFetchReturn<DataT>;

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

@@ -1,5 +1,7 @@
+import { CalendarDate } from '@internationalized/date';
 import type { DateValue } from '@internationalized/date';
 import type { DateRange } from 'reka-ui';
+export type ValueFormat = 'date-value' | 'iso' | 'timestamp' | 'unix' | 'date';
 /**
  * 日期格式化器配置选项
  */
@@ -55,9 +57,17 @@ export declare function useDateFormatter(options?: DateFormatterOptions): {
     toDate: (date: DateValue | undefined | null) => Date | null;
     toTimestamp: (date: DateValue | undefined | null) => number | null;
     toUnixTimestamp: (date: DateValue | undefined | null) => number | null;
-    parse: (value: string) => import("@internationalized/date").CalendarDate | import("@internationalized/date").CalendarDateTime | import("@internationalized/date").ZonedDateTime | null;
+    toFormat: (date: DateValue | undefined | null, format: ValueFormat) => unknown;
+    fromISO: (value: string | undefined | null) => DateValue | null;
+    fromDate: (value: Date | undefined | null) => CalendarDate | null;
+    fromTimestamp: (value: number | undefined | null) => CalendarDate | null;
+    fromUnixTimestamp: (value: number | undefined | null) => CalendarDate | null;
+    fromFormat: (value: unknown, format: ValueFormat) => DateValue | null;
+    parse: (value: string) => CalendarDate | import("@internationalized/date").CalendarDateTime | import("@internationalized/date").ZonedDateTime | null;
     convertData: <T>(data: T, converter: (value: DateValue) => unknown) => T;
-    getToday: () => import("@internationalized/date").CalendarDate;
+    convertToFormat: <T>(data: T, format: ValueFormat) => unknown;
+    convertFromFormat: <T>(data: T, format: ValueFormat) => unknown;
+    getToday: () => CalendarDate;
     getNow: () => import("@internationalized/date").ZonedDateTime;
     getStartOfWeek: (date: DateValue) => DateValue;
     getEndOfWeek: (date: DateValue) => DateValue;
@@ -82,4 +92,7 @@ export declare function useDateFormatter(options?: DateFormatterOptions): {
     locale: string;
     timeZone: string;
 };
-export {};
+export { CalendarDate } from '@internationalized/date';
+export type DateFormatter = ReturnType<typeof useDateFormatter>;
+export type { AnyCalendarDate, Calendar, CalendarDateTime, DateDuration, DateFields, DateValue, Time, ZonedDateTime } from '@internationalized/date';
+export type { DateRange } from 'reka-ui';

package/dist/runtime/composables/useDateFormatter.js

@@ -1,5 +1,6 @@
 import {
-  DateFormatter,
+  CalendarDate,
+  DateFormatter as IntlDateFormatter,
   getLocalTimeZone,
   today,
   now,
@@ -23,6 +24,13 @@ import {
 } from "@internationalized/date";
 const DEFAULT_LOCALE = "zh-CN";
 const DEFAULT_FORMAT_OPTIONS = { dateStyle: "medium" };
+function safe(fn, fallback) {
+  try {
+    return fn();
+  } catch {
+    return fallback;
+  }
+}
 function isDateValue(value) {
   return value !== null && value !== void 0 && typeof value === "object" && "calendar" in value && "year" in value && "month" in value && "day" in value;
 }
@@ -33,14 +41,10 @@ export function useDateFormatter(options = {}) {
   const locale = options.locale ?? DEFAULT_LOCALE;
   const formatOptions = options.formatOptions ?? DEFAULT_FORMAT_OPTIONS;
   const timeZone = options.timeZone ?? getLocalTimeZone();
-  const formatter = new DateFormatter(locale, { ...formatOptions, timeZone });
+  const formatter = new IntlDateFormatter(locale, { ...formatOptions, timeZone });
   function format(date) {
     if (!date) return "";
-    try {
-      return formatter.format(date.toDate(timeZone));
-    } catch {
-      return "";
-    }
+    return safe(() => formatter.format(date.toDate(timeZone)), "");
   }
   function formatRange(start, end, separator = " - ") {
     if (!start || !end) return "";
@@ -52,19 +56,11 @@ export function useDateFormatter(options = {}) {
   }
   function toISO(date) {
     if (!date) return "";
-    try {
-      return date.toString();
-    } catch {
-      return "";
-    }
+    return safe(() => date.toString(), "");
   }
   function toDate(date) {
     if (!date) return null;
-    try {
-      return new Date(Date.UTC(date.year, date.month - 1, date.day));
-    } catch {
-      return null;
-    }
+    return safe(() => new Date(Date.UTC(date.year, date.month - 1, date.day)), null);
   }
   function toTimestamp(date) {
     const jsDate = toDate(date);
@@ -72,7 +68,67 @@ export function useDateFormatter(options = {}) {
   }
   function toUnixTimestamp(date) {
     const timestamp = toTimestamp(date);
-    return timestamp ? Math.floor(timestamp / 1e3) : null;
+    return timestamp === null ? null : Math.floor(timestamp / 1e3);
+  }
+  function toFormat(date, format2) {
+    if (!date) return void 0;
+    switch (format2) {
+      case "date-value":
+        return date;
+      case "iso":
+        return toISO(date);
+      case "timestamp":
+        return toTimestamp(date);
+      case "unix":
+        return toUnixTimestamp(date);
+      case "date":
+        return toDate(date);
+    }
+  }
+  function convertToFormat(data, format2) {
+    if (format2 === "date-value") return data;
+    return convertData(data, (value) => toFormat(value, format2));
+  }
+  function fromDate(value) {
+    if (!value || Number.isNaN(value.getTime())) return null;
+    return safe(
+      () => new CalendarDate(value.getUTCFullYear(), value.getUTCMonth() + 1, value.getUTCDate()),
+      null
+    );
+  }
+  function fromTimestamp(value) {
+    if (value === null || value === void 0 || Number.isNaN(value)) return null;
+    return fromDate(new Date(value));
+  }
+  function fromUnixTimestamp(value) {
+    if (value === null || value === void 0 || Number.isNaN(value)) return null;
+    return fromTimestamp(value * 1e3);
+  }
+  function fromISO(value) {
+    if (!value) return null;
+    return parse(value);
+  }
+  function fromFormat(value, format2) {
+    if (value === null || value === void 0) return null;
+    if (format2 === "date-value") return isDateValue(value) ? value : null;
+    if (format2 === "iso") return typeof value === "string" ? fromISO(value) : null;
+    if (format2 === "timestamp") return typeof value === "number" ? fromTimestamp(value) : null;
+    if (format2 === "unix") return typeof value === "number" ? fromUnixTimestamp(value) : null;
+    if (format2 === "date") return value instanceof Date ? fromDate(value) : null;
+    return null;
+  }
+  function convertFromFormat(data, format2) {
+    if (data === null || data === void 0) return data;
+    if (format2 === "date-value") return data;
+    if (Array.isArray(data)) return data.map((item) => convertFromFormat(item, format2));
+    if (typeof data === "object" && "start" in data && "end" in data) {
+      const range = data;
+      return {
+        start: range.start === void 0 || range.start === null ? range.start : fromFormat(range.start, format2),
+        end: range.end === void 0 || range.end === null ? range.end : fromFormat(range.end, format2)
+      };
+    }
+    return fromFormat(data, format2);
   }
   function getToday() {
     return today(timeZone);
@@ -112,12 +168,10 @@ export function useDateFormatter(options = {}) {
     return getDayOfWeek(date, locale);
   }
   function getDayOfWeekName(date, style = "long") {
-    try {
-      const weekdayFormatter = new DateFormatter(locale, { weekday: style, timeZone });
+    return safe(() => {
+      const weekdayFormatter = new IntlDateFormatter(locale, { weekday: style, timeZone });
       return weekdayFormatter.format(date.toDate(timeZone));
-    } catch {
-      return "";
-    }
+    }, "");
   }
   function getWeeksInMonthNumber(date) {
     return getWeeksInMonth(date, locale);
@@ -156,13 +210,9 @@ export function useDateFormatter(options = {}) {
       return data.map((item) => convertData(item, converter));
     }
     if (typeof data === "object") {
-      const result = {};
-      for (const key in data) {
-        if (Object.prototype.hasOwnProperty.call(data, key)) {
-          result[key] = convertData(data[key], converter);
-        }
-      }
-      return result;
+      return Object.fromEntries(
+        Object.entries(data).map(([k, v]) => [k, convertData(v, converter)])
+      );
     }
     return data;
   }
@@ -183,8 +233,16 @@ export function useDateFormatter(options = {}) {
     toDate,
     toTimestamp,
     toUnixTimestamp,
+    toFormat,
+    fromISO,
+    fromDate,
+    fromTimestamp,
+    fromUnixTimestamp,
+    fromFormat,
     parse,
     convertData,
+    convertToFormat,
+    convertFromFormat,
     getToday,
     getNow,
     getStartOfWeek,
@@ -211,3 +269,4 @@ export function useDateFormatter(options = {}) {
     timeZone
   };
 }
+export { CalendarDate } from "@internationalized/date";

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

@@ -1,48 +1,47 @@
-import type { RequestToastOptions } from '../types/api.js';
+import type { NitroFetchRequest } from 'nitropack/types';
+import type { ApiError, TransferRequestOptions, TransferResult } from '../types/api';
 /**
- * 下载选项(带进度监控)
+ * 下载选项（带进度监控）
  */
-export interface DownloadWithProgressOptions {
-    /** 自定义文件名，不提供时从响应头提取 */
+export interface DownloadWithProgressOptions extends TransferRequestOptions {
+    /** HTTP 方法 @defaultValue 'GET' */
+    method?: RequestInit['method'];
+    /** 请求体，非 GET 时若非 string 自动序列化为 JSON */
+    body?: RequestInit['body'] | Record<string, unknown>;
+    /** 自定义文件名，不提供时从响应头或 URL 提取 */
     filename?: string;
-    /** 额外的请求头 */
-    headers?: Record<string, string>;
-    /** Toast 配置 */
-    toast?: RequestToastOptions | false;
-    /** 端点名称 */
-    endpoint?: string;
-    /** 下载成功回调 */
+    /** 下载成功回调（文件名） */
     onSuccess?: (filename: string) => void;
-    /** 下载失败回调 */
-    onError?: (error: Error) => void;
+    /** 下载失败回调；中止时不触发 */
+    onError?: (error: ApiError | Error) => void;
 }
 /**
- * 带进度监控的文件下载 composable
+ * 带进度监控的文件下载 composable（仅客户端）
  *
- * 基于原生 fetch + ReadableStream 实现，支持实时进度和取消下载
+ * @description 基于原生 fetch + ReadableStream 实现，复用 `@movk/nuxt` 的端点/认证/业务校验/toast/hook 体系。
+ *  - 后端返回 JSON 时按业务码校验，错误不会触发文件下载
+ *  - 后端无 content-length 时 progress 为 null，UI 据此切 indeterminate
  *
  * @example
  * ```ts
- * const { progress, downloading, download, abort } = useDownloadWithProgress()
+ * const { progress, status, error, download, abort } = useDownloadWithProgress()
  *
- * await download('/api/export', {
- *   filename: 'report.pdf',
- *   onSuccess: (name) => console.log('下载成功:', name)
+ * const { data, error: err, aborted } = await download('/api/export', {
+ *   filename: 'report.pdf'
  * })
  * ```
  */
-export declare function useDownloadWithProgress(): {
-    /** 下载进度 (0-100) */
+export declare function useDownloadWithProgress<T = Blob>(): {
+    /** 下载进度 0-100；后端未返回 content-length 时为 null（不确定） */
     progress: any;
-    /** 是否正在下载 */
-    downloading: any;
+    /** 传输状态 */
+    status: any;
+    /** 业务数据（默认 Blob；JSON 响应时为解包后的业务数据） */
+    data: any;
     /** 错误信息 */
     error: any;
     /** 执行下载 */
-    download: (url: string, options?: DownloadWithProgressOptions) => Promise<{
-        success: boolean;
-        error: Error | null;
-    }>;
+    download: (url: NitroFetchRequest, options?: DownloadWithProgressOptions) => Promise<TransferResult<T>>;
     /** 中止下载 */
     abort: () => void;
 };