@movk/nuxt 0.1.1 → 1.0.0

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

@@ -0,0 +1,24 @@
+import type { UseApiFetchOptions, UseApiFetchReturn } from '../types/api.js';
+/**
+ * 仅客户端执行的 useApiFetch
+ *
+ * 设置 `server: false, lazy: true`
+ * 适合非 SEO 敏感数据，需手动调用 execute() 触发请求
+ *
+ * @typeParam ResT - API 响应 data 字段的原始类型
+ * @typeParam DataT - transform 转换后的最终类型（默认等于 ResT）
+ *
+ * @example
+ * ```ts
+ * const { data, execute } = useClientApiFetch<User>('/user/preferences')
+ *
+ * // 在 onMounted 或用户操作时触发
+ * onMounted(() => execute())
+ *
+ * // 使用 transform 转换数据（接收解包后的数据）
+ * const { data } = useClientApiFetch<{ content: User[] }, User[]>('/users', {
+ *   transform: ({ content }) => content ?? []
+ * })
+ * ```
+ */
+export declare function useClientApiFetch<ResT = unknown, DataT = ResT>(url: string | (() => string), options?: UseApiFetchOptions<ResT, DataT>): UseApiFetchReturn<DataT>;

package/dist/runtime/composables/useClientApiFetch.js

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

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

@@ -1,26 +1,40 @@
 import type { DateValue } from '@internationalized/date';
 import type { DateRange } from 'reka-ui';
+/**
+ * 日期格式化器配置选项
+ */
 export interface DateFormatterOptions {
     /**
      * 语言区域
-     * @default 'zh-CN'
+     * @defaultValue 'zh-CN'
      */
     locale?: string;
     /**
      * 日期格式化选项
-     * @see https://developer.mozilla.org/zh-CN/docs/Web/JavaScript/Reference/Global_Objects/Intl/DateTimeFormat/DateTimeFormat
+     * @see {@link https://developer.mozilla.org/zh-CN/docs/Web/JavaScript/Reference/Global_Objects/Intl/DateTimeFormat/DateTimeFormat | Intl.DateTimeFormat}
      */
     formatOptions?: Intl.DateTimeFormatOptions;
     /**
-     * 时区标识符，默认使用本地时区
-     * @see https://react-spectrum.adobe.com/internationalized/date/index.html#timezones
+     * 时区标识符,默认使用本地时区
+     * @see {@link https://react-spectrum.adobe.com/internationalized/date/index.html#timezones | 时区文档}
      */
     timeZone?: string;
 }
+/**
+ * 检查值是否为 DateValue 类型
+ */
 declare function isDateValue(value: unknown): value is DateValue;
+/**
+ * 检查值是否为 DateRange 类型
+ */
 declare function isDateRange(value: unknown): value is DateRange;
 /**
- * 日期格式化工具
+ * 日期格式化工具 Composable
+ *
+ * 提供日期格式化、转换、解析和查询功能,基于 `@internationalized/date` 库实现国际化支持。
+ *
+ * @param options - 配置选项
+ * @returns 日期格式化工具集
  *
  * @example
  * ```ts
@@ -29,7 +43,6 @@ declare function isDateRange(value: unknown): value is DateRange;
  * formatter.format(date) // "2025年11月6日"
  * formatter.toISO(date) // "2025-11-06"
  * formatter.toTimestamp(date) // 1730822400000
- * formatter.toUnixTimestamp(date) // 1730822400
  * formatter.getToday() // 今天的日期
  * formatter.isWeekend(date) // 是否周末
  * ```
@@ -43,7 +56,7 @@ export declare function useDateFormatter(options?: DateFormatterOptions): {
     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;
-    convertData: <T>(data: T, converter: (value: DateValue) => any) => T;
+    convertData: <T>(data: T, converter: (value: DateValue) => unknown) => T;
     getToday: () => import("@internationalized/date").CalendarDate;
     getNow: () => import("@internationalized/date").ZonedDateTime;
     getStartOfWeek: (date: DateValue) => DateValue;
@@ -53,6 +66,7 @@ export declare function useDateFormatter(options?: DateFormatterOptions): {
     getStartOfYear: (date: DateValue) => DateValue;
     getEndOfYear: (date: DateValue) => DateValue;
     getDayOfWeek: (date: DateValue) => number;
+    getDayOfWeekName: (date: DateValue, style?: "narrow" | "short" | "long") => string;
     getWeeksInMonth: (date: DateValue) => number;
     isWeekday: (date: DateValue) => boolean;
     isWeekend: (date: DateValue) => boolean;

package/dist/runtime/composables/useDateFormatter.js

@@ -33,89 +33,123 @@ 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 format = (date) => {
+  const formatter = new DateFormatter(locale, { ...formatOptions, timeZone });
+  function format(date) {
     if (!date) return "";
     try {
       return formatter.format(date.toDate(timeZone));
-    } catch (error) {
-      console.error("[useDateFormatter] Format error:", error);
+    } catch {
       return "";
     }
-  };
-  const formatRange = (start, end, separator = " - ") => {
+  }
+  function formatRange(start, end, separator = " - ") {
     if (!start || !end) return "";
     return `${format(start)}${separator}${format(end)}`;
-  };
-  const formatArray = (dates, separator = ", ") => {
+  }
+  function formatArray(dates, separator = ", ") {
     if (!dates?.length) return "";
     return dates.map(format).join(separator);
-  };
-  const toISO = (date) => {
+  }
+  function toISO(date) {
     if (!date) return "";
     try {
       return date.toString();
-    } catch (error) {
-      console.error("[useDateFormatter] toISO error:", error);
+    } catch {
       return "";
     }
-  };
-  const toDate = (date) => {
+  }
+  function toDate(date) {
     if (!date) return null;
     try {
       return new Date(Date.UTC(date.year, date.month - 1, date.day));
-    } catch (error) {
-      console.error("[useDateFormatter] toDate error:", error);
+    } catch {
       return null;
     }
-  };
-  const toTimestamp = (date) => {
+  }
+  function toTimestamp(date) {
     const jsDate = toDate(date);
     return jsDate ? jsDate.getTime() : null;
-  };
-  const toUnixTimestamp = (date) => {
+  }
+  function toUnixTimestamp(date) {
     const timestamp = toTimestamp(date);
     return timestamp ? Math.floor(timestamp / 1e3) : null;
-  };
-  const getToday = () => today(timeZone);
-  const getNow = () => now(timeZone);
-  const parse = (value) => {
+  }
+  function getToday() {
+    return today(timeZone);
+  }
+  function getNow() {
+    return now(timeZone);
+  }
+  function parse(value) {
     try {
       if (value.includes("T")) {
         return value.includes("[") ? parseZonedDateTime(value) : parseDateTime(value);
       }
       return parseDate(value);
-    } catch (error) {
-      console.error("[useDateFormatter] Parse error:", error);
+    } catch {
       return null;
     }
-  };
-  const getStartOfWeek = (date) => startOfWeek(date, locale);
-  const getEndOfWeek = (date) => endOfWeek(date, locale);
-  const getStartOfMonth = (date) => startOfMonth(date);
-  const getEndOfMonth = (date) => endOfMonth(date);
-  const getStartOfYear = (date) => startOfYear(date);
-  const getEndOfYear = (date) => endOfYear(date);
-  const getDayOfWeekNumber = (date) => getDayOfWeek(date, locale);
-  const getWeeksInMonthNumber = (date) => getWeeksInMonth(date, locale);
-  const checkIsWeekday = (date) => isWeekday(date, locale);
-  const checkIsWeekend = (date) => isWeekend(date, locale);
-  const checkIsSameDay = (a, b) => isSameDay(a, b);
-  const checkIsSameMonth = (a, b) => isSameMonth(a, b);
-  const checkIsSameYear = (a, b) => isSameYear(a, b);
-  const checkIsToday = (date) => isToday(date, timeZone);
-  const convertData = (data, converter) => {
+  }
+  function getStartOfWeek(date) {
+    return startOfWeek(date, locale);
+  }
+  function getEndOfWeek(date) {
+    return endOfWeek(date, locale);
+  }
+  function getStartOfMonth(date) {
+    return startOfMonth(date);
+  }
+  function getEndOfMonth(date) {
+    return endOfMonth(date);
+  }
+  function getStartOfYear(date) {
+    return startOfYear(date);
+  }
+  function getEndOfYear(date) {
+    return endOfYear(date);
+  }
+  function getDayOfWeekNumber(date) {
+    return getDayOfWeek(date, locale);
+  }
+  function getDayOfWeekName(date, style = "long") {
+    try {
+      const weekdayFormatter = new DateFormatter(locale, { weekday: style, timeZone });
+      return weekdayFormatter.format(date.toDate(timeZone));
+    } catch {
+      return "";
+    }
+  }
+  function getWeeksInMonthNumber(date) {
+    return getWeeksInMonth(date, locale);
+  }
+  function checkIsWeekday(date) {
+    return isWeekday(date, locale);
+  }
+  function checkIsWeekend(date) {
+    return isWeekend(date, locale);
+  }
+  function checkIsSameDay(a, b) {
+    return isSameDay(a, b);
+  }
+  function checkIsSameMonth(a, b) {
+    return isSameMonth(a, b);
+  }
+  function checkIsSameYear(a, b) {
+    return isSameYear(a, b);
+  }
+  function checkIsToday(date) {
+    return isToday(date, timeZone);
+  }
+  function convertData(data, converter) {
     if (!data) return data;
     if (isDateValue(data)) {
       return converter(data);
     }
     if (isDateRange(data)) {
+      const range = data;
       return {
-        start: data.start ? converter(data.start) : data.start,
-        end: data.end ? converter(data.end) : data.end
+        start: range.start ? converter(range.start) : range.start,
+        end: range.end ? converter(range.end) : range.end
       };
     }
     if (Array.isArray(data)) {
@@ -131,23 +165,26 @@ export function useDateFormatter(options = {}) {
       return result;
     }
     return data;
-  };
-  const convertToISO = (data) => convertData(data, toISO);
-  const convertToFormatted = (data) => convertData(data, format);
-  const convertToDate = (data) => convertData(data, toDate);
+  }
+  function convertToISO(data) {
+    return convertData(data, toISO);
+  }
+  function convertToFormatted(data) {
+    return convertData(data, format);
+  }
+  function convertToDate(data) {
+    return convertData(data, toDate);
+  }
   return {
-    // 格式化
     format,
     formatRange,
     formatArray,
-    // 转换
     toISO,
     toDate,
     toTimestamp,
     toUnixTimestamp,
     parse,
     convertData,
-    // 工具方法 - 获取日期
     getToday,
     getNow,
     getStartOfWeek,
@@ -156,8 +193,8 @@ export function useDateFormatter(options = {}) {
     getEndOfMonth,
     getStartOfYear,
     getEndOfYear,
-    // 工具方法 - 查询
     getDayOfWeek: getDayOfWeekNumber,
+    getDayOfWeekName,
     getWeeksInMonth: getWeeksInMonthNumber,
     isWeekday: checkIsWeekday,
     isWeekend: checkIsWeekend,
@@ -167,11 +204,9 @@ export function useDateFormatter(options = {}) {
     isToday: checkIsToday,
     isDateValue,
     isDateRange,
-    // 批量转换
     convertToISO,
     convertToFormatted,
     convertToDate,
-    // 导出配置供外部使用
     locale,
     timeZone
   };

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

@@ -0,0 +1,48 @@
+import type { RequestToastOptions } from '../types/api.js';
+/**
+ * 下载选项(带进度监控)
+ */
+export interface DownloadWithProgressOptions {
+    /** 自定义文件名，不提供时从响应头提取 */
+    filename?: string;
+    /** 额外的请求头 */
+    headers?: Record<string, string>;
+    /** Toast 配置 */
+    toast?: RequestToastOptions | false;
+    /** 端点名称 */
+    endpoint?: string;
+    /** 下载成功回调 */
+    onSuccess?: (filename: string) => void;
+    /** 下载失败回调 */
+    onError?: (error: Error) => void;
+}
+/**
+ * 带进度监控的文件下载 composable
+ *
+ * 基于原生 fetch + ReadableStream 实现，支持实时进度和取消下载
+ *
+ * @example
+ * ```ts
+ * const { progress, downloading, download, abort } = useDownloadWithProgress()
+ *
+ * await download('/api/export', {
+ *   filename: 'report.pdf',
+ *   onSuccess: (name) => console.log('下载成功:', name)
+ * })
+ * ```
+ */
+export declare function useDownloadWithProgress(): {
+    /** 下载进度 (0-100) */
+    progress: any;
+    /** 是否正在下载 */
+    downloading: any;
+    /** 错误信息 */
+    error: any;
+    /** 执行下载 */
+    download: (url: string, options?: DownloadWithProgressOptions) => Promise<{
+        success: boolean;
+        error: Error | null;
+    }>;
+    /** 中止下载 */
+    abort: () => void;
+};

package/dist/runtime/composables/useDownloadWithProgress.js

@@ -0,0 +1,85 @@
+import { ref, useNuxtApp } from "#imports";
+import { extractFilename, triggerDownload } from "@movk/core";
+import { showToast, extractToastMessage, getAuthHeaders } from "../utils/api-utils.js";
+export function useDownloadWithProgress() {
+  const { $api } = useNuxtApp();
+  const progress = ref(0);
+  const downloading = ref(false);
+  const error = ref(null);
+  let abortController = null;
+  const abort = () => {
+    abortController?.abort();
+    abortController = null;
+    downloading.value = false;
+    progress.value = 0;
+  };
+  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}`;
+    progress.value = 0;
+    downloading.value = true;
+    error.value = null;
+    abortController = new AbortController();
+    try {
+      const authHeaders = getAuthHeaders(config);
+      const response = await fetch(fullUrl, {
+        method: "GET",
+        headers: { ...headers, ...authHeaders },
+        signal: abortController.signal
+      });
+      if (!response.ok) {
+        throw new Error(`\u4E0B\u8F7D\u5931\u8D25: ${response.status} ${response.statusText}`);
+      }
+      const contentLength = response.headers.get("content-length");
+      const total = contentLength ? Number.parseInt(contentLength, 10) : 0;
+      const finalFilename = filename || extractFilename(response.headers, url.split("/").pop() || "download");
+      const reader = response.body?.getReader();
+      if (!reader) throw new Error("\u65E0\u6CD5\u8BFB\u53D6\u54CD\u5E94\u6D41");
+      const chunks = [];
+      let received = 0;
+      while (true) {
+        const { done, value } = await reader.read();
+        if (done) break;
+        chunks.push(value);
+        received += value.length;
+        if (total > 0) progress.value = Math.round(received / total * 100);
+      }
+      triggerDownload(new Blob(chunks), finalFilename);
+      downloading.value = false;
+      abortController = null;
+      progress.value = 100;
+      if (import.meta.client && toast !== false) {
+        const message = extractToastMessage(toast, "success", `\u4E0B\u8F7D\u6210\u529F: ${finalFilename}`);
+        showToast("success", message, toast, config.toast);
+      }
+      onSuccess?.(finalFilename);
+      return { success: true, error: null };
+    } catch (err) {
+      downloading.value = false;
+      abortController = null;
+      const downloadError = err instanceof Error ? err : new Error("\u4E0B\u8F7D\u5931\u8D25");
+      error.value = downloadError;
+      const isAborted = downloadError.name === "AbortError";
+      if (import.meta.client && !isAborted && toast !== false) {
+        const message = extractToastMessage(toast, "error", downloadError.message || "\u4E0B\u8F7D\u5931\u8D25");
+        showToast("error", message, toast, config.toast);
+      }
+      if (!isAborted) onError?.(downloadError);
+      return { success: false, error: downloadError };
+    }
+  };
+  return {
+    /** 下载进度 (0-100) */
+    progress,
+    /** 是否正在下载 */
+    downloading,
+    /** 错误信息 */
+    error,
+    /** 执行下载 */
+    download,
+    /** 中止下载 */
+    abort
+  };
+}

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

@@ -0,0 +1,52 @@
+import type { ApiResponse, RequestToastOptions } from '../types/api.js';
+/**
+ * 上传选项(带进度监控)
+ */
+export interface UploadWithProgressOptions {
+    /** 文件字段名 @defaultValue 'file' */
+    fieldName?: string;
+    /** 额外的表单字段 */
+    fields?: Record<string, string | Blob>;
+    /** 额外的请求头 */
+    headers?: Record<string, string>;
+    /** Toast 配置 */
+    toast?: RequestToastOptions | false;
+    /** 端点名称 */
+    endpoint?: string;
+    /** 上传成功回调 */
+    onSuccess?: (response: ApiResponse) => void;
+    /** 上传失败回调 */
+    onError?: (error: Error) => void;
+}
+/**
+ * 带进度监控的文件上传 composable
+ *
+ * 基于原生 XMLHttpRequest 实现，支持实时进度和取消上传
+ *
+ * @example
+ * ```ts
+ * const { progress, uploading, upload, abort } = useUploadWithProgress()
+ *
+ * const { data, error } = await upload('/api/upload', files, {
+ *   fieldName: 'files',
+ *   onSuccess: (res) => console.log('上传成功', res)
+ * })
+ * ```
+ */
+export declare function useUploadWithProgress<T = unknown>(): {
+    /** 上传进度 (0-100) */
+    progress: any;
+    /** 是否正在上传 */
+    uploading: any;
+    /** 上传结果 */
+    data: any;
+    /** 错误信息 */
+    error: any;
+    /** 执行上传 */
+    upload: (url: string, files: File | File[], options?: UploadWithProgressOptions) => Promise<{
+        data: ApiResponse<T> | null;
+        error: Error | null;
+    }>;
+    /** 中止上传 */
+    abort: () => void;
+};

package/dist/runtime/composables/useUploadWithProgress.js

@@ -0,0 +1,117 @@
+import { ref, useNuxtApp } from "#imports";
+import {
+  showToast,
+  isBusinessSuccess,
+  extractMessage,
+  extractToastMessage,
+  getAuthHeaders
+} from "../utils/api-utils.js";
+export function useUploadWithProgress() {
+  const { $api } = useNuxtApp();
+  const progress = ref(0);
+  const uploading = ref(false);
+  const data = ref(null);
+  const error = ref(null);
+  let currentXhr = null;
+  const abort = () => {
+    currentXhr?.abort();
+    currentXhr = null;
+    uploading.value = false;
+    progress.value = 0;
+  };
+  const upload = async (url, files, options = {}) => {
+    const { fieldName = "file", fields = {}, headers = {}, toast, endpoint, onSuccess, onError } = options;
+    const apiInstance = endpoint ? $api.use(endpoint) : $api;
+    const config = apiInstance.getConfig();
+    const fullUrl = `${config.baseURL || ""}${url}`;
+    const formData = new FormData();
+    const fileArray = Array.isArray(files) ? files : [files];
+    fileArray.forEach((file) => formData.append(fieldName, file));
+    Object.entries(fields).forEach(([key, value]) => formData.append(key, value));
+    progress.value = 0;
+    uploading.value = true;
+    data.value = null;
+    error.value = null;
+    return new Promise((resolve) => {
+      const xhr = new XMLHttpRequest();
+      currentXhr = xhr;
+      xhr.upload.addEventListener("progress", (e) => {
+        if (e.lengthComputable) {
+          progress.value = Math.round(e.loaded / e.total * 100);
+        }
+      });
+      xhr.addEventListener("load", () => {
+        uploading.value = false;
+        currentXhr = null;
+        try {
+          const response = JSON.parse(xhr.responseText);
+          const isSuccess = isBusinessSuccess(response, config.success);
+          const message = extractMessage(response, config.success);
+          if (isSuccess) {
+            data.value = response;
+            if (import.meta.client && toast !== false) {
+              const msg = extractToastMessage(toast, "success", message || "\u4E0A\u4F20\u6210\u529F");
+              showToast("success", msg, toast, config.toast);
+            }
+            onSuccess?.(response);
+            resolve({ data: response, error: null });
+          } else {
+            const err = new Error(message || "\u4E0A\u4F20\u5931\u8D25");
+            error.value = err;
+            if (import.meta.client && toast !== false) {
+              const msg = extractToastMessage(toast, "error", message || "\u4E0A\u4F20\u5931\u8D25");
+              showToast("error", msg, toast, config.toast);
+            }
+            onError?.(err);
+            resolve({ data: null, error: err });
+          }
+        } catch (err) {
+          const parseError = err instanceof Error ? err : new Error("\u54CD\u5E94\u89E3\u6790\u5931\u8D25");
+          error.value = parseError;
+          if (import.meta.client && toast !== false) {
+            showToast("error", "\u4E0A\u4F20\u5931\u8D25", toast, config.toast);
+          }
+          onError?.(parseError);
+          resolve({ data: null, error: parseError });
+        }
+      });
+      xhr.addEventListener("error", () => {
+        uploading.value = false;
+        currentXhr = null;
+        const err = new Error("\u7F51\u7EDC\u9519\u8BEF");
+        error.value = err;
+        if (import.meta.client && toast !== false) {
+          showToast("error", "\u4E0A\u4F20\u5931\u8D25", toast, config.toast);
+        }
+        onError?.(err);
+        resolve({ data: null, error: err });
+      });
+      xhr.addEventListener("abort", () => {
+        uploading.value = false;
+        currentXhr = null;
+        error.value = new Error("\u4E0A\u4F20\u5DF2\u53D6\u6D88");
+        resolve({ data: null, error: error.value });
+      });
+      xhr.open("POST", fullUrl);
+      const authHeaders = getAuthHeaders(config);
+      Object.entries({ ...headers, ...authHeaders }).forEach(([key, value]) => {
+        xhr.setRequestHeader(key, value);
+      });
+      xhr.send(formData);
+    });
+  };
+  return {
+    /** 上传进度 (0-100) */
+    progress,
+    /** 是否正在上传 */
+    uploading,
+    /** 上传结果 */
+    data,
+    /** 错误信息 */
+    error,
+    /** 执行上传 */
+    upload,
+    /** 中止上传 */
+    abort
+  };
+}

package/dist/runtime/plugins/api.factory.d.ts

@@ -0,0 +1,2 @@
+declare const _default: any;
+export default _default;