@sybz-components/utils 1.0.10 → 1.0.12

package/dist/base.cjs

@@ -3,9 +3,10 @@
 require('vue');
 require('consola');
 require('es-toolkit');
-const format = require('./shared/utils.V4Kpqes0.cjs');
+const format = require('./shared/utils.-eWHeuS_.cjs');
 require('./confirmSemantic.cjs');
 require('element-plus');
+require('axios');
 require('./is.cjs');
 
 

package/dist/base.d.cts

@@ -1,7 +1,10 @@
 import * as vue from 'vue';
 import { VNode, AppContext, Ref } from 'vue';
+import { SybzComponentTheme } from './theme.cjs';
 import { ConfirmVariant, ConfirmTarget } from './confirmSemantic.cjs';
 import { MessageOptions, ElMessageBoxOptions, ElMessageBox } from 'element-plus';
+import { CreateHttpOptions } from './http.cjs';
+import 'axios';
 
 type Func<Args extends any[] = any[], Return = any> = (...args: Args) => Return;
 type StorageValue = unknown;
@@ -26,12 +29,14 @@ type MockValueOptionItem<T = any> = {
     label: string;
     value: T;
 };
-type UtilsTheme = 'default' | 'chenghua' | 'shijingshan';
+type UtilsTheme = SybzComponentTheme;
 interface SybzUtilsConfig {
     /**
      * 工具函数的默认主题。
      */
     theme?: UtilsTheme;
+    /** HTTP 客户端的全局配置，应用入口配置一次即可。 */
+    http?: CreateHttpOptions;
 }
 interface ToastOptions extends Partial<MessageOptions> {
     /**

package/dist/base.d.mts

@@ -1,7 +1,10 @@
 import * as vue from 'vue';
 import { VNode, AppContext, Ref } from 'vue';
+import { SybzComponentTheme } from './theme.mjs';
 import { ConfirmVariant, ConfirmTarget } from './confirmSemantic.mjs';
 import { MessageOptions, ElMessageBoxOptions, ElMessageBox } from 'element-plus';
+import { CreateHttpOptions } from './http.mjs';
+import 'axios';
 
 type Func<Args extends any[] = any[], Return = any> = (...args: Args) => Return;
 type StorageValue = unknown;
@@ -26,12 +29,14 @@ type MockValueOptionItem<T = any> = {
     label: string;
     value: T;
 };
-type UtilsTheme = 'default' | 'chenghua' | 'shijingshan';
+type UtilsTheme = SybzComponentTheme;
 interface SybzUtilsConfig {
     /**
      * 工具函数的默认主题。
      */
     theme?: UtilsTheme;
+    /** HTTP 客户端的全局配置，应用入口配置一次即可。 */
+    http?: CreateHttpOptions;
 }
 interface ToastOptions extends Partial<MessageOptions> {
     /**

package/dist/base.d.ts

@@ -1,7 +1,10 @@
 import * as vue from 'vue';
 import { VNode, AppContext, Ref } from 'vue';
+import { SybzComponentTheme } from './theme.js';
 import { ConfirmVariant, ConfirmTarget } from './confirmSemantic.js';
 import { MessageOptions, ElMessageBoxOptions, ElMessageBox } from 'element-plus';
+import { CreateHttpOptions } from './http.js';
+import 'axios';
 
 type Func<Args extends any[] = any[], Return = any> = (...args: Args) => Return;
 type StorageValue = unknown;
@@ -26,12 +29,14 @@ type MockValueOptionItem<T = any> = {
     label: string;
     value: T;
 };
-type UtilsTheme = 'default' | 'chenghua' | 'shijingshan';
+type UtilsTheme = SybzComponentTheme;
 interface SybzUtilsConfig {
     /**
      * 工具函数的默认主题。
      */
     theme?: UtilsTheme;
+    /** HTTP 客户端的全局配置，应用入口配置一次即可。 */
+    http?: CreateHttpOptions;
 }
 interface ToastOptions extends Partial<MessageOptions> {
     /**

package/dist/base.mjs

@@ -1,7 +1,8 @@
 import 'vue';
 import 'consola';
 import 'es-toolkit';
-export { $ as $toast, c as clearStorage, a as clone, b as configureUtils, d as confirm, e as copy, f as debounce, g as delay, h as getStorage, i as getType, j as getUtilsBuildTime, k as getVariable, l as isEmpty, m as log, n as merge, o as mockValue, p as processWidth, r as random, s as setStorage, t as test, q as throttle, u as toLine, v as tryCatch, w as validate, x as validateForm, y as validateOnSubmit } from './shared/utils.JIlaBPw3.mjs';
+export { $ as $toast, c as clearStorage, a as clone, b as configureUtils, d as confirm, e as copy, f as debounce, g as delay, h as getStorage, i as getType, j as getUtilsBuildTime, k as getVariable, l as isEmpty, m as log, n as merge, o as mockValue, p as processWidth, r as random, s as setStorage, t as test, q as throttle, u as toLine, v as tryCatch, w as validate, x as validateForm, y as validateOnSubmit } from './shared/utils.S76wYqQ8.mjs';
 import './confirmSemantic.mjs';
 import 'element-plus';
+import 'axios';
 import './is.mjs';

package/dist/codeStandard.cjs

@@ -0,0 +1,108 @@
+'use strict';
+
+const js = require('@eslint/js');
+const tsPlugin = require('@typescript-eslint/eslint-plugin');
+const tsParser = require('@typescript-eslint/parser');
+const prettier = require('eslint-config-prettier');
+const vue = require('eslint-plugin-vue');
+const globals = require('globals');
+const vueParser = require('vue-eslint-parser');
+
+function _interopDefaultCompat (e) { return e && typeof e === 'object' && 'default' in e ? e.default : e; }
+
+const js__default = /*#__PURE__*/_interopDefaultCompat(js);
+const tsPlugin__default = /*#__PURE__*/_interopDefaultCompat(tsPlugin);
+const tsParser__default = /*#__PURE__*/_interopDefaultCompat(tsParser);
+const prettier__default = /*#__PURE__*/_interopDefaultCompat(prettier);
+const vue__default = /*#__PURE__*/_interopDefaultCompat(vue);
+const globals__default = /*#__PURE__*/_interopDefaultCompat(globals);
+const vueParser__default = /*#__PURE__*/_interopDefaultCompat(vueParser);
+
+const sybzPrettierConfig = {
+  singleQuote: true,
+  semi: false,
+  trailingComma: "all",
+  printWidth: 120,
+  endOfLine: "lf",
+  htmlWhitespaceSensitivity: "ignore"
+};
+const sybzLintStagedConfig = {
+  "**/*.{js,jsx,ts,tsx,vue,mjs,cjs}": [
+    "sybz-code-standard prettier --write",
+    "sybz-code-standard eslint --fix --max-warnings=0"
+  ],
+  "**/*.{css,scss,json,yaml,yml,html,md}": ["sybz-code-standard prettier --write"]
+};
+const baseEslintConfig = [
+  {
+    ignores: [
+      "node_modules/**",
+      "dist/**",
+      "dist-ssr/**",
+      "coverage/**",
+      "docs/.vitepress/cache/**",
+      "docs/.vitepress/dist/**",
+      "packages/*/dist/**",
+      ".vitepress/**",
+      ".codex-types-temp/**",
+      "*.tsbuildinfo",
+      "*.local"
+    ]
+  },
+  js__default.configs.recommended,
+  tsPlugin__default.configs["flat/base"],
+  ...vue__default.configs["flat/recommended"],
+  {
+    files: ["**/*.{js,jsx,ts,tsx,cjs,mjs,vue}"],
+    languageOptions: {
+      ecmaVersion: "latest",
+      sourceType: "module",
+      globals: {
+        ...globals__default.browser,
+        ...globals__default.node,
+        ...globals__default.es2021
+      }
+    },
+    rules: {
+      "no-console": "off",
+      "no-unused-vars": "off",
+      "vue/no-unused-vars": "off",
+      "@typescript-eslint/no-unused-vars": "off",
+      "vue/multi-word-component-names": "off",
+      "vue/no-template-shadow": "off",
+      "vue/attribute-hyphenation": ["warn", "always", { ignore: ["dangerouslyUseHTMLString"] }],
+      "vue/require-default-prop": "off"
+    }
+  },
+  {
+    files: ["**/*.{ts,tsx,vue}"],
+    rules: {
+      "no-undef": "off",
+      "no-redeclare": "off"
+    }
+  },
+  {
+    files: ["**/*.vue"],
+    languageOptions: {
+      parser: vueParser__default,
+      parserOptions: {
+        parser: tsParser__default,
+        ecmaVersion: "latest",
+        sourceType: "module",
+        ecmaFeatures: { jsx: true },
+        extraFileExtensions: [".vue"]
+      }
+    }
+  }
+];
+const createSybzEslintConfig = (...extensions) => [
+  ...baseEslintConfig,
+  ...extensions,
+  prettier__default
+];
+const sybzEslintConfig = createSybzEslintConfig();
+
+exports.createSybzEslintConfig = createSybzEslintConfig;
+exports.sybzEslintConfig = sybzEslintConfig;
+exports.sybzLintStagedConfig = sybzLintStagedConfig;
+exports.sybzPrettierConfig = sybzPrettierConfig;

package/dist/codeStandard.d.cts

@@ -0,0 +1,17 @@
+import { Linter } from 'eslint';
+import { Config } from 'prettier';
+
+type SybzEslintConfig = Linter.Config;
+/** 公司前端项目统一使用的 Prettier 配置。 */
+declare const sybzPrettierConfig: Config;
+/** 公司前端项目统一使用的 lint-staged 配置。 */
+declare const sybzLintStagedConfig: Record<string, string[]>;
+/**
+ * 创建公司统一的 ESLint flat config。项目级扩展会插入到 Prettier 兼容配置之前。
+ */
+declare const createSybzEslintConfig: (...extensions: Linter.Config[]) => Linter.Config[];
+/** 公司前端项目默认的 ESLint flat config。 */
+declare const sybzEslintConfig: SybzEslintConfig[];
+
+export { createSybzEslintConfig, sybzEslintConfig, sybzLintStagedConfig, sybzPrettierConfig };
+export type { SybzEslintConfig };

package/dist/codeStandard.d.mts

@@ -0,0 +1,17 @@
+import { Linter } from 'eslint';
+import { Config } from 'prettier';
+
+type SybzEslintConfig = Linter.Config;
+/** 公司前端项目统一使用的 Prettier 配置。 */
+declare const sybzPrettierConfig: Config;
+/** 公司前端项目统一使用的 lint-staged 配置。 */
+declare const sybzLintStagedConfig: Record<string, string[]>;
+/**
+ * 创建公司统一的 ESLint flat config。项目级扩展会插入到 Prettier 兼容配置之前。
+ */
+declare const createSybzEslintConfig: (...extensions: Linter.Config[]) => Linter.Config[];
+/** 公司前端项目默认的 ESLint flat config。 */
+declare const sybzEslintConfig: SybzEslintConfig[];
+
+export { createSybzEslintConfig, sybzEslintConfig, sybzLintStagedConfig, sybzPrettierConfig };
+export type { SybzEslintConfig };

package/dist/codeStandard.d.ts

@@ -0,0 +1,17 @@
+import { Linter } from 'eslint';
+import { Config } from 'prettier';
+
+type SybzEslintConfig = Linter.Config;
+/** 公司前端项目统一使用的 Prettier 配置。 */
+declare const sybzPrettierConfig: Config;
+/** 公司前端项目统一使用的 lint-staged 配置。 */
+declare const sybzLintStagedConfig: Record<string, string[]>;
+/**
+ * 创建公司统一的 ESLint flat config。项目级扩展会插入到 Prettier 兼容配置之前。
+ */
+declare const createSybzEslintConfig: (...extensions: Linter.Config[]) => Linter.Config[];
+/** 公司前端项目默认的 ESLint flat config。 */
+declare const sybzEslintConfig: SybzEslintConfig[];
+
+export { createSybzEslintConfig, sybzEslintConfig, sybzLintStagedConfig, sybzPrettierConfig };
+export type { SybzEslintConfig };

package/dist/codeStandard.mjs

@@ -0,0 +1,93 @@
+import js from '@eslint/js';
+import tsPlugin from '@typescript-eslint/eslint-plugin';
+import tsParser from '@typescript-eslint/parser';
+import prettier from 'eslint-config-prettier';
+import vue from 'eslint-plugin-vue';
+import globals from 'globals';
+import vueParser from 'vue-eslint-parser';
+
+const sybzPrettierConfig = {
+  singleQuote: true,
+  semi: false,
+  trailingComma: "all",
+  printWidth: 120,
+  endOfLine: "lf",
+  htmlWhitespaceSensitivity: "ignore"
+};
+const sybzLintStagedConfig = {
+  "**/*.{js,jsx,ts,tsx,vue,mjs,cjs}": [
+    "sybz-code-standard prettier --write",
+    "sybz-code-standard eslint --fix --max-warnings=0"
+  ],
+  "**/*.{css,scss,json,yaml,yml,html,md}": ["sybz-code-standard prettier --write"]
+};
+const baseEslintConfig = [
+  {
+    ignores: [
+      "node_modules/**",
+      "dist/**",
+      "dist-ssr/**",
+      "coverage/**",
+      "docs/.vitepress/cache/**",
+      "docs/.vitepress/dist/**",
+      "packages/*/dist/**",
+      ".vitepress/**",
+      ".codex-types-temp/**",
+      "*.tsbuildinfo",
+      "*.local"
+    ]
+  },
+  js.configs.recommended,
+  tsPlugin.configs["flat/base"],
+  ...vue.configs["flat/recommended"],
+  {
+    files: ["**/*.{js,jsx,ts,tsx,cjs,mjs,vue}"],
+    languageOptions: {
+      ecmaVersion: "latest",
+      sourceType: "module",
+      globals: {
+        ...globals.browser,
+        ...globals.node,
+        ...globals.es2021
+      }
+    },
+    rules: {
+      "no-console": "off",
+      "no-unused-vars": "off",
+      "vue/no-unused-vars": "off",
+      "@typescript-eslint/no-unused-vars": "off",
+      "vue/multi-word-component-names": "off",
+      "vue/no-template-shadow": "off",
+      "vue/attribute-hyphenation": ["warn", "always", { ignore: ["dangerouslyUseHTMLString"] }],
+      "vue/require-default-prop": "off"
+    }
+  },
+  {
+    files: ["**/*.{ts,tsx,vue}"],
+    rules: {
+      "no-undef": "off",
+      "no-redeclare": "off"
+    }
+  },
+  {
+    files: ["**/*.vue"],
+    languageOptions: {
+      parser: vueParser,
+      parserOptions: {
+        parser: tsParser,
+        ecmaVersion: "latest",
+        sourceType: "module",
+        ecmaFeatures: { jsx: true },
+        extraFileExtensions: [".vue"]
+      }
+    }
+  }
+];
+const createSybzEslintConfig = (...extensions) => [
+  ...baseEslintConfig,
+  ...extensions,
+  prettier
+];
+const sybzEslintConfig = createSybzEslintConfig();
+
+export { createSybzEslintConfig, sybzEslintConfig, sybzLintStagedConfig, sybzPrettierConfig };

package/dist/confirmSemantic.d.cts

@@ -1,6 +1,8 @@
+import { SybzComponentTheme } from './theme.cjs';
+
 type ConfirmVariant = 'default' | 'delete' | 'warning';
 type ConfirmTarget = string | number;
-type ConfirmSemanticTheme = 'default' | 'chenghua' | 'shijingshan';
+type ConfirmSemanticTheme = SybzComponentTheme;
 type ConfirmSemanticButtonType = 'default' | 'primary' | 'success' | 'warning' | 'info' | 'danger' | 'text' | '';
 interface ConfirmSemanticOptions {
     variant?: ConfirmVariant;

package/dist/confirmSemantic.d.mts

@@ -1,6 +1,8 @@
+import { SybzComponentTheme } from './theme.mjs';
+
 type ConfirmVariant = 'default' | 'delete' | 'warning';
 type ConfirmTarget = string | number;
-type ConfirmSemanticTheme = 'default' | 'chenghua' | 'shijingshan';
+type ConfirmSemanticTheme = SybzComponentTheme;
 type ConfirmSemanticButtonType = 'default' | 'primary' | 'success' | 'warning' | 'info' | 'danger' | 'text' | '';
 interface ConfirmSemanticOptions {
     variant?: ConfirmVariant;

package/dist/confirmSemantic.d.ts

@@ -1,6 +1,8 @@
+import { SybzComponentTheme } from './theme.js';
+
 type ConfirmVariant = 'default' | 'delete' | 'warning';
 type ConfirmTarget = string | number;
-type ConfirmSemanticTheme = 'default' | 'chenghua' | 'shijingshan';
+type ConfirmSemanticTheme = SybzComponentTheme;
 type ConfirmSemanticButtonType = 'default' | 'primary' | 'success' | 'warning' | 'info' | 'danger' | 'text' | '';
 interface ConfirmSemanticOptions {
     variant?: ConfirmVariant;

package/dist/format.cjs

@@ -1,12 +1,13 @@
 'use strict';
 
-const format = require('./shared/utils.V4Kpqes0.cjs');
+const format = require('./shared/utils.-eWHeuS_.cjs');
 require('./is.cjs');
 require('consola');
 require('vue');
 require('es-toolkit');
 require('./confirmSemantic.cjs');
 require('element-plus');
+require('axios');
 
 
 

package/dist/format.mjs

@@ -1,7 +1,8 @@
-export { z as formatBytes, A as formatBytesConvert, B as formatDurationTime, C as formatTextToHtml, D as formatThousands, E as formatTime, F as formatToFixed } from './shared/utils.JIlaBPw3.mjs';
+export { z as formatBytes, A as formatBytesConvert, B as formatDurationTime, C as formatTextToHtml, D as formatThousands, E as formatTime, F as formatToFixed } from './shared/utils.S76wYqQ8.mjs';
 import './is.mjs';
 import 'consola';
 import 'vue';
 import 'es-toolkit';
 import './confirmSemantic.mjs';
 import 'element-plus';
+import 'axios';

package/dist/http.cjs

@@ -0,0 +1,20 @@
+'use strict';
+
+require('axios');
+const format = require('./shared/utils.-eWHeuS_.cjs');
+require('vue');
+require('consola');
+require('es-toolkit');
+require('./confirmSemantic.cjs');
+require('element-plus');
+require('./is.cjs');
+
+
+
+exports.HttpError = format.HttpError;
+exports.configureHttp = format.configureHttp;
+exports.createHttp = format.createHttp;
+Object.defineProperty(exports, "http", {
+	enumerable: true,
+	get: function () { return format.http; }
+});

package/dist/http.d.cts

@@ -0,0 +1,66 @@
+import { CreateAxiosDefaults, AxiosResponse, AxiosRequestConfig, AxiosInstance } from 'axios';
+
+interface HttpRequestConfig<D = unknown> extends AxiosRequestConfig<D> {
+    rawResponse?: boolean;
+    skipAuth?: boolean;
+    /** 是否显示当前请求的错误提示；默认继承全局配置。 */
+    showErrorToast?: boolean;
+    /** 当前请求的自定义错误文案。 */
+    message?: string | ((error: HttpError) => string);
+}
+declare class HttpError<T = unknown> extends Error {
+    readonly status?: number;
+    readonly code?: string;
+    readonly data?: T;
+    readonly cause?: unknown;
+    constructor(message: string, options?: {
+        status?: number;
+        code?: string;
+        data?: T;
+        cause?: unknown;
+    });
+}
+interface CreateHttpOptions<D = unknown> extends CreateAxiosDefaults<D> {
+    /** 返回 false 时视为业务失败；默认仅识别 success === false。 */
+    isBusinessSuccess?: (data: unknown, response: AxiosResponse<D>) => boolean;
+    /** 从后端返回体提取业务错误文案。 */
+    getBusinessMessage?: (data: unknown, fallback: string) => string;
+    /** 统一转换响应体，适用于 { data: ... } 等包装格式。 */
+    transformResponseData?: (data: D, response: AxiosResponse<D>) => unknown;
+    /** 是否自动使用 $toast.error 提示错误；默认 `true`。 */
+    showErrorToast?: boolean;
+    toast?: (message: string) => void;
+    normalizeError?: (error: unknown) => HttpError;
+    /** 统一获取请求令牌。 */
+    getToken?: () => string | undefined | null;
+    /** 请求发出前的统一处理。 */
+    onRequest?: (config: HttpRequestConfig) => HttpRequestConfig | void;
+    /** 响应成功后的统一处理。 */
+    onResponse?: (response: AxiosResponse) => void;
+    /** 响应失败后的统一处理，例如 401 跳转登录。 */
+    onError?: (error: HttpError, response?: AxiosResponse) => void | Promise<void>;
+}
+type HttpClient = Omit<AxiosInstance, 'get' | 'post' | 'put' | 'patch' | 'delete'> & {
+    <T = unknown, D = unknown>(url: string, config?: HttpRequestConfig<D>): Promise<T>;
+    <T = unknown, D = unknown>(url: string, params?: unknown, config?: HttpRequestConfig<D>): Promise<T>;
+    send<T = unknown, D = unknown>(config: HttpRequestConfig<D> & {
+        rawResponse: true;
+    }): Promise<AxiosResponse<T>>;
+    send<T = unknown, D = unknown>(config: HttpRequestConfig<D> & {
+        rawResponse?: false;
+    }): Promise<T>;
+    get<T = unknown>(url: string, config?: HttpRequestConfig): Promise<T>;
+    get<T = unknown>(url: string, params?: unknown, config?: HttpRequestConfig): Promise<T>;
+    post<T = unknown, D = unknown>(url: string, data?: D, config?: HttpRequestConfig<D>): Promise<T>;
+    put<T = unknown, D = unknown>(url: string, data?: D, config?: HttpRequestConfig<D>): Promise<T>;
+    patch<T = unknown, D = unknown>(url: string, data?: D, config?: HttpRequestConfig<D>): Promise<T>;
+    delete<T = unknown>(url: string, config?: HttpRequestConfig): Promise<T>;
+    download(url: string, params?: unknown, config?: HttpRequestConfig): Promise<Blob>;
+};
+declare function createHttp<D = unknown>(options?: CreateHttpOptions<D>): HttpClient;
+/** 全局 HTTP 客户端；通过 configureUtils({ http: ... }) 配置一次。 */
+declare let http: HttpClient;
+declare function configureHttp(options?: CreateHttpOptions): HttpClient;
+
+export { HttpError, configureHttp, createHttp, http };
+export type { CreateHttpOptions, HttpClient, HttpRequestConfig };

package/dist/http.d.mts

@@ -0,0 +1,66 @@
+import { CreateAxiosDefaults, AxiosResponse, AxiosRequestConfig, AxiosInstance } from 'axios';
+
+interface HttpRequestConfig<D = unknown> extends AxiosRequestConfig<D> {
+    rawResponse?: boolean;
+    skipAuth?: boolean;
+    /** 是否显示当前请求的错误提示；默认继承全局配置。 */
+    showErrorToast?: boolean;
+    /** 当前请求的自定义错误文案。 */
+    message?: string | ((error: HttpError) => string);
+}
+declare class HttpError<T = unknown> extends Error {
+    readonly status?: number;
+    readonly code?: string;
+    readonly data?: T;
+    readonly cause?: unknown;
+    constructor(message: string, options?: {
+        status?: number;
+        code?: string;
+        data?: T;
+        cause?: unknown;
+    });
+}
+interface CreateHttpOptions<D = unknown> extends CreateAxiosDefaults<D> {
+    /** 返回 false 时视为业务失败；默认仅识别 success === false。 */
+    isBusinessSuccess?: (data: unknown, response: AxiosResponse<D>) => boolean;
+    /** 从后端返回体提取业务错误文案。 */
+    getBusinessMessage?: (data: unknown, fallback: string) => string;
+    /** 统一转换响应体，适用于 { data: ... } 等包装格式。 */
+    transformResponseData?: (data: D, response: AxiosResponse<D>) => unknown;
+    /** 是否自动使用 $toast.error 提示错误；默认 `true`。 */
+    showErrorToast?: boolean;
+    toast?: (message: string) => void;
+    normalizeError?: (error: unknown) => HttpError;
+    /** 统一获取请求令牌。 */
+    getToken?: () => string | undefined | null;
+    /** 请求发出前的统一处理。 */
+    onRequest?: (config: HttpRequestConfig) => HttpRequestConfig | void;
+    /** 响应成功后的统一处理。 */
+    onResponse?: (response: AxiosResponse) => void;
+    /** 响应失败后的统一处理，例如 401 跳转登录。 */
+    onError?: (error: HttpError, response?: AxiosResponse) => void | Promise<void>;
+}
+type HttpClient = Omit<AxiosInstance, 'get' | 'post' | 'put' | 'patch' | 'delete'> & {
+    <T = unknown, D = unknown>(url: string, config?: HttpRequestConfig<D>): Promise<T>;
+    <T = unknown, D = unknown>(url: string, params?: unknown, config?: HttpRequestConfig<D>): Promise<T>;
+    send<T = unknown, D = unknown>(config: HttpRequestConfig<D> & {
+        rawResponse: true;
+    }): Promise<AxiosResponse<T>>;
+    send<T = unknown, D = unknown>(config: HttpRequestConfig<D> & {
+        rawResponse?: false;
+    }): Promise<T>;
+    get<T = unknown>(url: string, config?: HttpRequestConfig): Promise<T>;
+    get<T = unknown>(url: string, params?: unknown, config?: HttpRequestConfig): Promise<T>;
+    post<T = unknown, D = unknown>(url: string, data?: D, config?: HttpRequestConfig<D>): Promise<T>;
+    put<T = unknown, D = unknown>(url: string, data?: D, config?: HttpRequestConfig<D>): Promise<T>;
+    patch<T = unknown, D = unknown>(url: string, data?: D, config?: HttpRequestConfig<D>): Promise<T>;
+    delete<T = unknown>(url: string, config?: HttpRequestConfig): Promise<T>;
+    download(url: string, params?: unknown, config?: HttpRequestConfig): Promise<Blob>;
+};
+declare function createHttp<D = unknown>(options?: CreateHttpOptions<D>): HttpClient;
+/** 全局 HTTP 客户端；通过 configureUtils({ http: ... }) 配置一次。 */
+declare let http: HttpClient;
+declare function configureHttp(options?: CreateHttpOptions): HttpClient;
+
+export { HttpError, configureHttp, createHttp, http };
+export type { CreateHttpOptions, HttpClient, HttpRequestConfig };

package/dist/http.d.ts

@@ -0,0 +1,66 @@
+import { CreateAxiosDefaults, AxiosResponse, AxiosRequestConfig, AxiosInstance } from 'axios';
+
+interface HttpRequestConfig<D = unknown> extends AxiosRequestConfig<D> {
+    rawResponse?: boolean;
+    skipAuth?: boolean;
+    /** 是否显示当前请求的错误提示；默认继承全局配置。 */
+    showErrorToast?: boolean;
+    /** 当前请求的自定义错误文案。 */
+    message?: string | ((error: HttpError) => string);
+}
+declare class HttpError<T = unknown> extends Error {
+    readonly status?: number;
+    readonly code?: string;
+    readonly data?: T;
+    readonly cause?: unknown;
+    constructor(message: string, options?: {
+        status?: number;
+        code?: string;
+        data?: T;
+        cause?: unknown;
+    });
+}
+interface CreateHttpOptions<D = unknown> extends CreateAxiosDefaults<D> {
+    /** 返回 false 时视为业务失败；默认仅识别 success === false。 */
+    isBusinessSuccess?: (data: unknown, response: AxiosResponse<D>) => boolean;
+    /** 从后端返回体提取业务错误文案。 */
+    getBusinessMessage?: (data: unknown, fallback: string) => string;
+    /** 统一转换响应体，适用于 { data: ... } 等包装格式。 */
+    transformResponseData?: (data: D, response: AxiosResponse<D>) => unknown;
+    /** 是否自动使用 $toast.error 提示错误；默认 `true`。 */
+    showErrorToast?: boolean;
+    toast?: (message: string) => void;
+    normalizeError?: (error: unknown) => HttpError;
+    /** 统一获取请求令牌。 */
+    getToken?: () => string | undefined | null;
+    /** 请求发出前的统一处理。 */
+    onRequest?: (config: HttpRequestConfig) => HttpRequestConfig | void;
+    /** 响应成功后的统一处理。 */
+    onResponse?: (response: AxiosResponse) => void;
+    /** 响应失败后的统一处理，例如 401 跳转登录。 */
+    onError?: (error: HttpError, response?: AxiosResponse) => void | Promise<void>;
+}
+type HttpClient = Omit<AxiosInstance, 'get' | 'post' | 'put' | 'patch' | 'delete'> & {
+    <T = unknown, D = unknown>(url: string, config?: HttpRequestConfig<D>): Promise<T>;
+    <T = unknown, D = unknown>(url: string, params?: unknown, config?: HttpRequestConfig<D>): Promise<T>;
+    send<T = unknown, D = unknown>(config: HttpRequestConfig<D> & {
+        rawResponse: true;
+    }): Promise<AxiosResponse<T>>;
+    send<T = unknown, D = unknown>(config: HttpRequestConfig<D> & {
+        rawResponse?: false;
+    }): Promise<T>;
+    get<T = unknown>(url: string, config?: HttpRequestConfig): Promise<T>;
+    get<T = unknown>(url: string, params?: unknown, config?: HttpRequestConfig): Promise<T>;
+    post<T = unknown, D = unknown>(url: string, data?: D, config?: HttpRequestConfig<D>): Promise<T>;
+    put<T = unknown, D = unknown>(url: string, data?: D, config?: HttpRequestConfig<D>): Promise<T>;
+    patch<T = unknown, D = unknown>(url: string, data?: D, config?: HttpRequestConfig<D>): Promise<T>;
+    delete<T = unknown>(url: string, config?: HttpRequestConfig): Promise<T>;
+    download(url: string, params?: unknown, config?: HttpRequestConfig): Promise<Blob>;
+};
+declare function createHttp<D = unknown>(options?: CreateHttpOptions<D>): HttpClient;
+/** 全局 HTTP 客户端；通过 configureUtils({ http: ... }) 配置一次。 */
+declare let http: HttpClient;
+declare function configureHttp(options?: CreateHttpOptions): HttpClient;
+
+export { HttpError, configureHttp, createHttp, http };
+export type { CreateHttpOptions, HttpClient, HttpRequestConfig };

package/dist/http.mjs

@@ -0,0 +1,8 @@
+import 'axios';
+export { H as HttpError, G as configureHttp, I as createHttp, J as http } from './shared/utils.S76wYqQ8.mjs';
+import 'vue';
+import 'consola';
+import 'es-toolkit';
+import './confirmSemantic.mjs';
+import 'element-plus';
+import './is.mjs';