@movk/nuxt 1.2.0 → 1.3.0

package/dist/runtime/composables/useTheme.js

@@ -1,68 +1,79 @@
 import { useAppConfig, useColorMode, useSiteConfig } from "#imports";
-import { themeIcons } from "../utils/theme.js";
+import { themeIcons } from "../domains/theme/theme-icons.js";
 import { omit, kebabCase } from "@movk/core";
 import { useLocalStorage } from "@vueuse/core";
 import colors from "tailwindcss/colors";
 import { computed } from "vue";
+import { getDefaultConfig } from "../utils/theme-defaults.js";
 export function useTheme() {
-  const appConfig = useAppConfig();
+  const { movk, ui } = useAppConfig();
   const colorMode = useColorMode();
-  const site = useSiteConfig();
-  const name = kebabCase(site.name);
-  const radius = useLocalStorage(`${name}-ui-radius`, 0.25);
-  const font = useLocalStorage(`${name}-ui-font`, "Alibaba PuHuiTi");
-  const _iconSet = useLocalStorage(`${name}-ui-icons`, "lucide");
-  const blackAsPrimary = useLocalStorage(`${name}-ui-black-as-primary`, false);
-  const neutralColors = ["slate", "gray", "zinc", "neutral", "stone", "taupe", "mauve", "mist", "olive"];
+  const name = kebabCase(useSiteConfig().name);
+  const color = computed(() => colorMode.value === "dark" ? colors[ui.colors.neutral][900] : "white");
+  const defaultConfig = getDefaultConfig();
+  const _radius = useLocalStorage(`${name}-ui-radius`, movk?.radius ?? defaultConfig.radius);
+  const _font = useLocalStorage(`${name}-ui-font`, movk?.font ?? defaultConfig.font);
+  const _iconSet = useLocalStorage(`${name}-ui-icons`, movk?.icons ?? defaultConfig.icons);
+  const _blackAsPrimary = useLocalStorage(`${name}-ui-black-as-primary`, defaultConfig.blackAsPrimary);
+  const pickerFonts = movk?.picker?.fonts ?? [];
+  const neutralColors = movk?.picker?.neutralColors ?? [];
   const neutral = computed({
     get() {
-      return appConfig.ui.colors.neutral;
+      return ui.colors.neutral;
     },
     set(option) {
-      appConfig.ui.colors.neutral = option;
-      window.localStorage.setItem(`${name}-ui-neutral`, appConfig.ui.colors.neutral);
+      ui.colors.neutral = option;
+      window.localStorage.setItem(`${name}-ui-neutral`, ui.colors.neutral);
     }
   });
   const colorsToOmit = ["inherit", "current", "transparent", "black", "white", ...neutralColors];
   const primaryColors = Object.keys(omit(colors, colorsToOmit));
   const primary = computed({
     get() {
-      return appConfig.ui.colors.primary;
+      return ui.colors.primary;
     },
     set(option) {
-      appConfig.ui.colors.primary = option;
-      window.localStorage.setItem(`${name}-ui-primary`, appConfig.ui.colors.primary);
-      blackAsPrimary.value = false;
+      ui.colors.primary = option;
+      window.localStorage.setItem(`${name}-ui-primary`, ui.colors.primary);
+      setBlackAsPrimary(false);
     }
   });
-  const radiuses = [0, 0.125, 0.25, 0.375, 0.5];
-  const fonts = ["Alibaba PuHuiTi", "Public Sans", "DM Sans", "Geist", "Inter", "Poppins", "Outfit", "Raleway"];
-  const icons = [{
-    label: "Lucide",
-    icon: "i-lucide-feather",
-    value: "lucide"
-  }, {
-    label: "Phosphor",
-    icon: "i-ph-phosphor-logo",
-    value: "phosphor"
-  }, {
-    label: "Tabler",
-    icon: "i-tabler-brand-tabler",
-    value: "tabler"
-  }];
+  const radiuses = movk?.picker?.radiuses ?? [];
+  const radius = computed({
+    get() {
+      return _radius.value;
+    },
+    set(option) {
+      _radius.value = option;
+    }
+  });
+  const fonts = pickerFonts.map((f) => f.name);
+  const font = computed({
+    get() {
+      return _font.value;
+    },
+    set(option) {
+      _font.value = option;
+    }
+  });
+  const icons = [
+    { label: "Lucide", icon: "i-lucide-feather", value: "lucide" },
+    { label: "Phosphor", icon: "i-ph-phosphor-logo", value: "phosphor" },
+    { label: "Tabler", icon: "i-tabler-brand-tabler", value: "tabler" }
+  ];
   const icon = computed({
     get() {
       return _iconSet.value;
     },
     set(option) {
       _iconSet.value = option;
-      appConfig.ui.icons = themeIcons[option];
+      ui.icons = themeIcons[option];
     }
   });
   const modes = computed(() => [
-    { label: "light", icon: appConfig.ui.icons.light },
-    { label: "dark", icon: appConfig.ui.icons.dark },
-    { label: "system", icon: appConfig.ui.icons.system }
+    { label: "light", icon: ui.icons.light },
+    { label: "dark", icon: ui.icons.dark },
+    { label: "system", icon: ui.icons.system }
   ]);
   const mode = computed({
     get() {
@@ -72,49 +83,54 @@ export function useTheme() {
       colorMode.preference = option;
     }
   });
-  const radiusStyle = computed(() => `:root { --ui-radius: ${radius.value}rem; }`);
-  const blackAsPrimaryStyle = computed(() => blackAsPrimary.value ? `:root { --ui-primary: black; } .dark { --ui-primary: white; }` : ":root {}");
-  const fontStyle = computed(() => `:root { --font-sans: '${font.value}', sans-serif; }`);
+  const blackAsPrimary = computed(() => _blackAsPrimary.value);
+  function setBlackAsPrimary(value) {
+    _blackAsPrimary.value = value;
+  }
+  const radiusStyle = computed(() => `:root { --ui-radius: ${_radius.value}rem; }`);
+  const blackAsPrimaryStyle = computed(() => _blackAsPrimary.value ? `:root { --ui-primary: black; } .dark { --ui-primary: white; }` : ":root {}");
+  const fontStyle = computed(() => `:root { --font-sans: '${_font.value}', sans-serif; }`);
   const link = computed(() => {
-    const name2 = font.value;
-    if (name2 === "Alibaba PuHuiTi" || !fonts.includes(name2)) return [];
+    const fontName = _font.value;
+    const fontConfig = pickerFonts.find((f) => f.name === fontName);
+    const href = fontConfig?.href ?? `https://fonts.googleapis.com/css2?family=${encodeURIComponent(fontName)}:wght@400;500;600;700&display=swap`;
     return [{
       rel: "stylesheet",
-      href: `https://fonts.googleapis.com/css2?family=${encodeURIComponent(name2)}:wght@400;500;600;700&display=swap`,
-      id: `font-${kebabCase(name2)}`
+      href,
+      id: `font-${fontName.toLowerCase().replace(/\s+/g, "-")}`
     }];
   });
   const style = [
-    { innerHTML: radiusStyle, id: `${name}-ui-radius`, tagPriority: -2 },
-    { innerHTML: blackAsPrimaryStyle, id: `${name}-ui-black-as-primary`, tagPriority: -2 },
-    { innerHTML: fontStyle, id: `${name}-ui-font`, tagPriority: -2 }
+    { innerHTML: radiusStyle, id: `nuxt-ui-radius`, tagPriority: -2 },
+    { innerHTML: blackAsPrimaryStyle, id: `nuxt-ui-black-as-primary`, tagPriority: -2 },
+    { innerHTML: fontStyle, id: `nuxt-ui-font`, tagPriority: -2 }
   ];
   const hasCSSChanges = computed(() => {
-    return radius.value !== 0.25 || blackAsPrimary.value || font.value !== "Alibaba PuHuiTi";
+    return _radius.value !== (movk?.radius ?? defaultConfig.radius) || _blackAsPrimary.value || _font.value !== (movk?.font ?? defaultConfig.font);
   });
-  const hasAppConfigChanges = computed(() => {
-    return appConfig.ui.colors.primary !== "sky" || appConfig.ui.colors.neutral !== "slate" || _iconSet.value !== "lucide";
+  const hasConfigChanges = computed(() => {
+    return ui.colors.primary !== "blue" || ui.colors.neutral !== "slate" || _iconSet.value !== (movk?.icons ?? defaultConfig.icons);
   });
   function exportCSS() {
     const lines = [
       '@import "tailwindcss";',
       '@import "@nuxt/ui";'
     ];
-    if (font.value !== "Alibaba PuHuiTi") {
-      lines.push("", "@theme {", `  --font-sans: '${font.value}', sans-serif;`, "}");
+    if (_font.value !== defaultConfig.font) {
+      lines.push("", "@theme {", `  --font-sans: '${_font.value}', sans-serif;`, "}");
     }
     const rootLines = [];
-    if (radius.value !== 0.25) {
-      rootLines.push(`  --ui-radius: ${radius.value}rem;`);
+    if (_radius.value !== defaultConfig.radius) {
+      rootLines.push(`  --ui-radius: ${_radius.value}rem;`);
     }
-    if (blackAsPrimary.value) {
+    if (_blackAsPrimary.value) {
       rootLines.push("  --ui-primary: black;");
     }
     if (rootLines.length) {
       lines.push("", ":root {", ...rootLines, "}");
     }
     const darkLines = [];
-    if (blackAsPrimary.value) {
+    if (_blackAsPrimary.value) {
       darkLines.push("  --ui-primary: white;");
     }
     if (darkLines.length) {
@@ -122,14 +138,22 @@ export function useTheme() {
     }
     return lines.join("\n");
   }
-  function exportAppConfig() {
+  function exportConfig() {
     const config = {};
-    const defaultColors = { primary: "sky", secondary: "blue", success: "green", info: "blue", warning: "yellow", error: "red", neutral: "slate" };
-    const colorEntries = Object.entries(defaultColors).filter(([key, def]) => appConfig.ui.colors[key] !== def);
+    const defaultColors = {
+      primary: "blue",
+      neutral: "slate",
+      secondary: "blue",
+      success: "green",
+      info: "blue",
+      warning: "yellow",
+      error: "red"
+    };
+    const colorEntries = Object.entries(defaultColors).filter(([key, def]) => ui.colors[key] !== def);
     if (colorEntries.length) {
-      config.ui = { colors: Object.fromEntries(colorEntries.map(([key]) => [key, appConfig.ui.colors[key]])) };
+      config.ui = { colors: Object.fromEntries(colorEntries.map(([key]) => [key, ui.colors[key]])) };
     }
-    if (_iconSet.value !== "lucide") {
+    if (_iconSet.value !== defaultConfig.icons) {
       const iconMapping = themeIcons[_iconSet.value];
       config.ui = config.ui || {};
       config.ui.icons = iconMapping;
@@ -138,20 +162,21 @@ export function useTheme() {
     return `export default defineAppConfig(${configString})`;
   }
   function resetTheme() {
-    appConfig.ui.colors.primary = "sky";
+    const defaultPrimary = "blue";
+    const defaultNeutral = "slate";
+    const defaultIcon = movk?.icons ?? defaultConfig.icons;
+    ui.colors.primary = defaultPrimary;
     window.localStorage.removeItem(`${name}-ui-primary`);
-    appConfig.ui.colors.neutral = "slate";
+    ui.colors.neutral = defaultNeutral;
     window.localStorage.removeItem(`${name}-ui-neutral`);
-    radius.value = 0.25;
-    font.value = "Alibaba PuHuiTi";
-    _iconSet.value = "lucide";
-    appConfig.ui.icons = themeIcons.lucide;
-    blackAsPrimary.value = false;
-    window.localStorage.removeItem(`${name}-ui-ai-theme`);
-    window.localStorage.removeItem(`${name}-ui-custom-colors`);
-    window.localStorage.removeItem(`${name}-ui-css-variables`);
+    _radius.value = movk?.radius ?? defaultConfig.radius;
+    _font.value = movk?.font ?? defaultConfig.font;
+    _iconSet.value = defaultIcon;
+    ui.icons = themeIcons[defaultIcon];
+    _blackAsPrimary.value = movk?.blackAsPrimary ?? defaultConfig.blackAsPrimary;
   }
   return {
+    color,
     style,
     link,
     neutralColors,
@@ -159,6 +184,7 @@ export function useTheme() {
     primaryColors,
     primary,
     blackAsPrimary,
+    setBlackAsPrimary,
     radiuses,
     radius,
     fonts,
@@ -168,9 +194,10 @@ export function useTheme() {
     modes,
     mode,
     hasCSSChanges,
-    hasAppConfigChanges,
+    hasConfigChanges,
+    configLabel: "app.config.ts",
     exportCSS,
-    exportAppConfig,
+    exportConfig,
     resetTheme
   };
 }

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

@@ -1,52 +1,46 @@
-import type { ApiResponse, RequestToastOptions } from '../types/api.js';
+import type { NitroFetchRequest } from 'nitropack/types';
+import type { ApiError, TransferRequestOptions, TransferResult } from '../types/api';
 /**
- * 上传选项(带进度监控)
+ * 上传选项（带进度监控）
  */
-export interface UploadWithProgressOptions {
+export interface UploadWithProgressOptions<T = unknown> extends TransferRequestOptions {
     /** 文件字段名 @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;
+    /** 超时毫秒数，0 或未设置不超时 */
+    timeoutMs?: number;
+    /** 是否跨域携带凭证 */
+    withCredentials?: boolean;
+    /** 上传成功回调（解包后业务数据） */
+    onSuccess?: (data: T) => void;
+    /** 上传失败回调；中止时不触发 */
+    onError?: (error: ApiError | Error) => void;
 }
 /**
- * 带进度监控的文件上传 composable
+ * 带进度监控的文件上传 composable（仅客户端）
  *
- * 基于原生 XMLHttpRequest 实现，支持实时进度和取消上传
+ * @description 基于原生 XMLHttpRequest 实现，复用 `@movk/nuxt` 的端点/认证/业务校验/toast/hook 体系。
+ *  返回的 `data` 是按 `dataKey` 解包后的业务数据，与 `useApiFetch<T>` 一致。
  *
  * @example
  * ```ts
- * const { progress, uploading, upload, abort } = useUploadWithProgress()
+ * const { progress, status, data, upload, abort } = useUploadWithProgress<{ files: Array<{ name: string }> }>()
  *
- * const { data, error } = await upload('/api/upload', files, {
- *   fieldName: 'files',
- *   onSuccess: (res) => console.log('上传成功', res)
- * })
+ * await upload('/api/upload', files, { fieldName: 'files' })
  * ```
  */
-export declare function useUploadWithProgress(): {
-    /** 上传进度 (0-100) */
+export declare function useUploadWithProgress<T = unknown>(): {
+    /** 上传进度 0-100 */
     progress: any;
-    /** 是否正在上传 */
-    uploading: any;
-    /** 上传结果 */
+    /** 传输状态 */
+    status: any;
+    /** 解包后的业务数据 */
     data: any;
     /** 错误信息 */
     error: any;
     /** 执行上传 */
-    upload: (url: string, files: File | File[], options?: UploadWithProgressOptions) => Promise<{
-        data: ApiResponse | null;
-        error: Error | null;
-    }>;
+    upload: (url: NitroFetchRequest, files: File | File[], options?: UploadWithProgressOptions<T>) => Promise<TransferResult<T>>;
     /** 中止上传 */
     abort: () => void;
 };

package/dist/runtime/composables/useUploadWithProgress.js

@@ -1,111 +1,122 @@
-import { ref, useRuntimeConfig } from "#imports";
+import { ref, useNuxtApp, useRuntimeConfig } from "#imports";
 import {
-  showToast,
-  isBusinessSuccess,
-  extractMessage,
-  extractToastMessage,
-  getAuthHeaders,
-  resolveEndpointConfig
-} from "../utils/api-utils.js";
+  buildFetchContext,
+  finalizeTransfer,
+  parseXhrHeaders,
+  prepareTransfer,
+  tryParseJsonResponse
+} from "../domains/api/transfer.js";
 export function useUploadWithProgress() {
   const publicConfig = useRuntimeConfig().public.movkApi;
+  const nuxtApp = useNuxtApp();
   const progress = ref(0);
-  const uploading = ref(false);
+  const status = ref("idle");
   const data = ref(null);
   const error = ref(null);
   let currentXhr = null;
   const abort = () => {
     currentXhr?.abort();
     currentXhr = null;
-    uploading.value = false;
+    status.value = "aborted";
     progress.value = 0;
   };
-  const upload = async (url, files, options = {}) => {
-    const { fieldName = "file", fields = {}, headers = {}, toast, endpoint, onSuccess, onError } = options;
-    const config = resolveEndpointConfig(publicConfig, endpoint);
-    const fullUrl = `${config.baseURL}${url}`;
+  const upload = (url, files, options = {}) => {
+    const {
+      fieldName = "file",
+      fields = {},
+      headers: userHeaders,
+      toast,
+      endpoint,
+      skipBusinessCheck,
+      timeoutMs,
+      withCredentials,
+      onSuccess,
+      onError
+    } = options;
+    const urlStr = typeof url === "string" ? url : url.url;
+    const { fullUrl, headers, config } = prepareTransfer(publicConfig, urlStr, {
+      endpoint,
+      headers: userHeaders,
+      toast,
+      skipBusinessCheck
+    });
     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;
+    status.value = "pending";
     data.value = null;
     error.value = null;
     return new Promise((resolve) => {
-      const authHeaders = getAuthHeaders(config);
       const xhr = new XMLHttpRequest();
       currentXhr = xhr;
+      if (withCredentials) xhr.withCredentials = true;
+      if (timeoutMs && timeoutMs > 0) xhr.timeout = timeoutMs;
       xhr.upload.addEventListener("progress", (e) => {
         if (e.lengthComputable) {
           progress.value = Math.round(e.loaded / e.total * 100);
         }
       });
-      xhr.addEventListener("load", () => {
-        uploading.value = false;
+      const finishWith = async (raw, fallback) => {
+        const responseHeaders = parseXhrHeaders(xhr.getAllResponseHeaders());
+        const fetchContext = buildFetchContext(fullUrl, { context: { toast, skipBusinessCheck } }, {
+          status: xhr.status,
+          headers: responseHeaders
+        });
+        const result = await finalizeTransfer(nuxtApp, {
+          raw,
+          fallback: fallback ? { isSuccess: fallback.isSuccess, data: null, message: fallback.message } : void 0,
+          config,
+          publicConfig,
+          requestToast: toast,
+          skipBusinessCheck,
+          fetchContext
+        });
         currentXhr = null;
-        try {
-          const response = JSON.parse(xhr.responseText);
-          const isSuccess = isBusinessSuccess(response, config.response);
-          const message = extractMessage(response, config.response);
-          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 });
+        if (result.error) {
+          status.value = "error";
+          error.value = result.error;
+          onError?.(result.error);
+        } else {
+          status.value = "success";
+          data.value = result.data;
+          progress.value = 100;
+          if (result.data !== null) onSuccess?.(result.data);
+        }
+        resolve(result);
+      };
+      xhr.addEventListener("load", () => {
+        const responseHeaders = parseXhrHeaders(xhr.getAllResponseHeaders());
+        const raw = tryParseJsonResponse(responseHeaders, xhr.responseText);
+        if (xhr.status < 200 || xhr.status >= 300) {
+          void finishWith(raw, { isSuccess: false, message: `HTTP ${xhr.status} ${xhr.statusText}` });
+          return;
         }
+        void finishWith(raw, raw ? void 0 : { isSuccess: true, message: "\u4E0A\u4F20\u6210\u529F" });
       });
       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 });
+        void finishWith(null, { isSuccess: false, message: "\u7F51\u7EDC\u9519\u8BEF" });
+      });
+      xhr.addEventListener("timeout", () => {
+        void finishWith(null, { isSuccess: false, message: `\u4E0A\u4F20\u8D85\u65F6\uFF08${timeoutMs}ms\uFF09` });
       });
       xhr.addEventListener("abort", () => {
-        uploading.value = false;
         currentXhr = null;
-        error.value = new Error("\u4E0A\u4F20\u5DF2\u53D6\u6D88");
-        resolve({ data: null, error: error.value });
+        status.value = "aborted";
+        resolve({ data: null, error: null, aborted: true });
       });
       xhr.open("POST", fullUrl);
-      Object.entries({ ...headers, ...authHeaders }).forEach(([key, value]) => {
-        xhr.setRequestHeader(key, value);
-      });
+      Object.entries(headers).forEach(([k, v]) => xhr.setRequestHeader(k, v));
       xhr.send(formData);
     });
   };
   return {
-    /** 上传进度 (0-100) */
+    /** 上传进度 0-100 */
     progress,
-    /** 是否正在上传 */
-    uploading,
-    /** 上传结果 */
+    /** 传输状态 */
+    status,
+    /** 解包后的业务数据 */
     data,
     /** 错误信息 */
     error,

package/dist/runtime/domains/api/auth.d.ts

@@ -0,0 +1,2 @@
+import type { ApiAuthConfig } from '../../types/api';
+export declare function getAuthHeaders(auth: ApiAuthConfig): Record<string, string>;

package/dist/runtime/domains/api/auth.js

@@ -0,0 +1,31 @@
+import { getPath } from "@movk/core";
+import { useNuxtApp, useUserSession } from "#imports";
+function getUserSession() {
+  try {
+    const nuxtApp = useNuxtApp();
+    return nuxtApp.vueApp.runWithContext(() => useUserSession());
+  } catch {
+    return null;
+  }
+}
+function getTokenFromSession(tokenPath) {
+  const userSession = getUserSession();
+  if (!userSession?.session?.value) return null;
+  const sessionData = userSession.session.value;
+  return getPath(sessionData, tokenPath) || null;
+}
+function buildAuthHeaderValue(token, config) {
+  const tokenType = config.tokenType === "Custom" ? config.customTokenType || "" : config.tokenType || "Bearer";
+  return tokenType ? `${tokenType} ${token}` : token;
+}
+export function getAuthHeaders(auth) {
+  const headers = {};
+  if (!auth.enabled) return headers;
+  const tokenPath = auth.sessionTokenPath || "token";
+  const token = getTokenFromSession(tokenPath);
+  if (token) {
+    const headerName = auth.headerName || "Authorization";
+    headers[headerName] = buildAuthHeaderValue(token, auth);
+  }
+  return headers;
+}

package/dist/runtime/domains/api/endpoint-config.d.ts

@@ -0,0 +1,11 @@
+import type { MovkApiPublicConfig } from '../../types/api';
+import type { EndpointPrivateConfig, ResolvedEndpointConfig } from '../../types/api/module';
+/**
+ * 合并全局与端点配置为运行时实际生效的 ResolvedEndpointConfig
+ *
+ * @param publicConfig 模块公共配置
+ * @param endpoint 端点名称；未指定时使用 defaultEndpoint
+ * @param privateEndpoints 服务端私有端点配置（含 headers），仅在服务端可用
+ * @description 端点不存在时降级到 defaultEndpoint，并打印警告
+ */
+export declare function resolveEndpointConfig(publicConfig: MovkApiPublicConfig, endpoint?: string, privateEndpoints?: Record<string, EndpointPrivateConfig>): ResolvedEndpointConfig;

package/dist/runtime/domains/api/endpoint-config.js

@@ -0,0 +1,17 @@
+import defu from "defu";
+export function resolveEndpointConfig(publicConfig, endpoint, privateEndpoints) {
+  const endpointName = endpoint || publicConfig.defaultEndpoint || "default";
+  const endpointConfig = publicConfig.endpoints?.[endpointName];
+  if (!endpointConfig) {
+    console.warn(`[@movk/nuxt] Endpoint "${endpointName}" not found, using default`);
+    return resolveEndpointConfig(publicConfig, publicConfig.defaultEndpoint || "default", privateEndpoints);
+  }
+  return {
+    ...endpointConfig,
+    baseURL: endpointConfig.baseURL || "",
+    headers: privateEndpoints?.[endpointName]?.headers,
+    auth: defu(endpointConfig.auth, publicConfig.auth),
+    toast: defu(endpointConfig.toast, publicConfig.toast),
+    response: defu(endpointConfig.response, publicConfig.response)
+  };
+}

package/dist/runtime/domains/api/errors.d.ts

@@ -0,0 +1,2 @@
+import type { ApiError, ApiResponse } from '../../types/api';
+export declare function createApiError(response: ApiResponse, message?: string): ApiError;

package/dist/runtime/domains/api/errors.js

@@ -0,0 +1,10 @@
+export function createApiError(response, message) {
+  const error = new Error(message || "\u8BF7\u6C42\u5931\u8D25", { cause: response });
+  const rawCode = response.code ?? response.status ?? 500;
+  const numericCode = typeof rawCode === "number" ? rawCode : Number(rawCode);
+  error.statusCode = Number.isNaN(numericCode) ? 500 : numericCode;
+  error.response = response;
+  error.isBusinessError = true;
+  Error.captureStackTrace?.(error, createApiError);
+  return error;
+}

package/dist/runtime/domains/api/fetch-key.d.ts

@@ -0,0 +1,20 @@
+import type { RequestToastOptions } from '../../types/api';
+interface ApiFetchKeyInput {
+    endpoint?: string;
+    skipUnwrap?: boolean;
+    skipBusinessCheck?: boolean;
+    toast?: RequestToastOptions | false;
+    method?: string;
+    url: unknown;
+    query?: unknown;
+    body?: unknown;
+}
+/**
+ * 计算 useApiFetch 的去重 key
+ *
+ * @description 纳入所有影响处理逻辑的维度（含请求级 toast），避免同 URL 不同 toast 配置
+ * 因 key 相同被 Nuxt useAsyncData 去重，复用首个 handler 导致单次配置失效。
+ * 入参须为已 resolve 的值（调用方负责 toValue）。
+ */
+export declare function buildApiFetchKey(input: ApiFetchKeyInput): string;
+export {};