xn-fe-tools 1.0.0

package/README.md

@@ -0,0 +1,112 @@
+# My Hooks
+
+一个 Vue 3 Composition API 工具库集合，灵感来自 VueUse。
+
+## ✨ 特性
+
+- 🎯 **Tree Shakeable** - 支持按需导入，减少打包体积
+- 📦 **TypeScript** - 完整的 TypeScript 支持
+- 🚀 **轻量级** - 零依赖（除了 Vue）
+- 🔧 **易用** - 简单直观的 API
+- 📚 **文档完善** - 详细的文档和示例
+
+## 📦 安装
+
+```bash
+npm install my-vue-hooks
+# 或
+pnpm add my-vue-hooks
+# 或
+yarn add my-vue-hooks
+```
+
+## 🚀 快速开始
+
+```vue
+<script setup lang="ts">
+import { useCounter } from 'my-vue-hooks'
+
+const { count, inc, dec, reset } = useCounter(0)
+</script>
+
+<template>
+  <div>
+    <p>Count: {{ count }}</p>
+    <button @click="inc()">+</button>
+    <button @click="dec()">-</button>
+    <button @click="reset()">Reset</button>
+  </div>
+</template>
+```
+
+## 📖 文档
+
+查看 [完整文档](https://your-docs-site.com) 了解更多。
+
+## 🛠️ 开发
+
+```bash
+# 安装依赖
+pnpm install
+
+# 开发模式
+pnpm dev
+
+# 构建
+pnpm build
+
+# 运行测试
+pnpm test
+
+# 开发文档
+pnpm dev:docs
+
+# 构建文档
+pnpm build:docs
+```
+
+## 📝 添加新 Hook
+
+查看 [贡献指南](./docs/guide/contributing.md) 了解如何添加新的 hook。
+
+## 🚀 发布 SDK
+
+### 快速发布
+
+```bash
+# 发布补丁版本 (1.0.0 -> 1.0.1)
+pnpm release:patch
+
+# 发布次版本 (1.0.0 -> 1.1.0)
+pnpm release:minor
+
+# 发布主版本 (1.0.0 -> 2.0.0)
+pnpm release:major
+```
+
+### 手动发布
+
+1. 更新版本号: `pnpm version:patch|minor|major`
+2. 更新 CHANGELOG.md
+3. 构建: `pnpm build`
+4. 测试: `pnpm test:run`
+5. 提交: `git commit -m "chore: release v1.0.1" && git tag v1.0.1`
+6. 发布: `npm publish`
+
+详细说明请查看 [发布指南](./RELEASE.md)。
+
+## 📦 版本信息
+
+SDK 内置了版本信息，可以在代码中使用：
+
+```ts
+import { VERSION, getVersion } from 'my-vue-hooks'
+
+console.log(VERSION)        // "1.0.0"
+console.log(getVersion())    // "1.0.0"
+```
+
+## 📄 License
+
+MIT
+

package/dist/hooks/toAwaitFetch/toAwaitFetch.api.d.ts

@@ -0,0 +1,469 @@
+/**
+ * toAwaitFetch API 类型定义
+ * 一个解决请求问题的工具类
+ */
+/**
+ * HTTP 请求方法
+ */
+export type HttpMethod = 'GET' | 'POST' | 'PUT' | 'PATCH' | 'DELETE' | 'HEAD' | 'OPTIONS';
+/**
+ * 请求模式
+ */
+export type RequestMode = 'cors' | 'no-cors' | 'same-origin' | 'navigate' | 'websocket';
+/**
+ * 凭证模式
+ */
+export type CredentialsMode = 'include' | 'same-origin' | 'omit';
+/**
+ * 请求数据类型
+ */
+export type RequestType = 'json' | 'form' | 'text' | 'blob' | 'arraybuffer';
+/**
+ * 响应数据类型
+ */
+export type ResponseType = 'json' | 'text' | 'blob' | 'arraybuffer' | 'formData';
+/**
+ * 请求头配置类型
+ * 可以是 HeadersInit、Record<string, string> 或返回这些类型的函数
+ */
+export type HeadersConfig = HeadersInit | Record<string, string> | ((config: {
+    url: string;
+    method?: HttpMethod;
+}) => HeadersInit | Record<string, string>);
+/**
+ * 验证状态码函数
+ * @param status HTTP 状态码
+ * @returns 是否通过验证
+ */
+export type ValidateStatusFn = (status: number) => boolean;
+/**
+ * 验证响应内容函数
+ * @param response 响应数据
+ * @returns 是否通过验证
+ */
+export type ValidateResponseFn<T = any> = (response: T) => boolean;
+/**
+ * 响应数据转换函数
+ * 用于将原始响应数据转换为业务中使用的数据格式
+ * @param data 原始响应数据（response 中的 data）
+ * @returns 转换后的数据
+ * @example
+ * // 例如：提取嵌套数据
+ * transformResponse: (data) => data.result.list
+ *
+ * // 例如：格式化数据
+ * transformResponse: (data) => ({
+ *   items: data.list,
+ *   total: data.pagination.total
+ * })
+ */
+export type TransformResponseFn<TRaw = any, TTransformed = any> = (data: TRaw) => TTransformed;
+/**
+ * HTTP 错误处理函数
+ * @param error 错误信息
+ * @param status HTTP 状态码
+ * @param response 响应数据
+ * @param suppressError 取消抛错的方法，调用此方法后，即使错误未被用户主动处理，也不会抛出未处理的错误
+ */
+export type HttpErrorHandler<T = any> = (error: Error, status: number, response: T, suppressError: () => void) => void | Promise<void>;
+/**
+ * 业务错误处理函数
+ * @param error 错误信息
+ * @param response 响应数据
+ * @param suppressError 取消抛错的方法，调用此方法后，即使错误未被用户主动处理，也不会抛出未处理的错误
+ */
+export type BusinessErrorHandler<T = any> = (error: Error, response: T, suppressError: () => void) => void | Promise<void>;
+/**
+ * 网络错误处理函数
+ * @param error 网络错误（已统一转换为 Error 类型）
+ * @param suppressError 取消抛错的方法，调用此方法后，即使错误未被用户主动处理，也不会抛出未处理的错误
+ */
+export type NetworkErrorHandler = (error: Error, suppressError: () => void) => void | Promise<void>;
+/**
+ * 重试判断函数
+ * @param attempt 当前重试次数（从 1 开始）
+ * @param error 错误信息
+ * @returns 是否应该继续重试
+ */
+export type ShouldRetry = (attempt: number, error: FetchError) => boolean | Promise<boolean>;
+/**
+ * 重试配置
+ */
+export interface RetryConfig {
+    /**
+     * 是否开启重试
+     * @default false
+     */
+    enabled?: boolean;
+    /**
+     * 最大重试次数
+     * @default 3
+     */
+    maxRetryCount?: number;
+    /**
+     * 重试延迟时间（毫秒）
+     * @default 1000
+     */
+    delay?: number;
+    /**
+     * 自定义重试判断函数，返回 true 表示继续重试，false 表示停止重试
+     * 如果未提供，将使用默认的重试逻辑
+     */
+    shouldRetry?: ShouldRetry;
+}
+/**
+ * 请求配置（单次请求）
+ */
+export interface RequestConfig<TRequest = any, TResponse = any> {
+    /**
+     * 请求 URL（必需）
+     */
+    url: string;
+    /**
+     * HTTP 方法
+     * @default 'GET'
+     */
+    method?: HttpMethod;
+    /**
+     * 请求数据
+     * - GET 请求时，data 会转换为 URL 查询参数
+     * - POST/PUT/PATCH 等请求时，data 作为请求体数据
+     * - POST 请求的查询参数应该放在 URL 中（如 '/api/users?page=1'）
+     */
+    data?: TRequest;
+    /**
+     * 验证请求状态码是否符合要求的函数，返回布尔类型
+     */
+    validateStatus?: ValidateStatusFn;
+    /**
+     * 验证请求内容是否符合业务要求，返回布尔类型
+     */
+    validateResponse?: ValidateResponseFn<TResponse>;
+    /**
+     * 响应数据转换函数
+     * 用于将原始响应数据转换为业务中使用的数据格式
+     * 在 validateResponse 验证通过后执行
+     * @example
+     * transformResponse: (data) => data.result.list
+     */
+    transformResponse?: TransformResponseFn<TResponse, TResponse>;
+    /**
+     * 用来捕获 validateStatus 为 false 时进行错误处理的函数
+     */
+    onHttpError?: HttpErrorHandler<TResponse>;
+    /**
+     * 用来捕获 validateResponse 为 false 时进行错误处理的函数
+     * 主要用来处理业务场景的错误
+     */
+    onBusinessError?: BusinessErrorHandler<TResponse>;
+    /**
+     * 用来捕获网络异常的错误处理函数
+     * 主要用来处理无网络、跨域等报错问题
+     */
+    onNetworkError?: NetworkErrorHandler;
+    /**
+     * 重试配置
+     */
+    retry?: RetryConfig;
+    /**
+     * 请求超时时间（毫秒）
+     */
+    timeout?: number;
+    /**
+     * 请求头配置
+     * 可以是 HeadersInit、Record<string, string> 或返回这些类型的函数
+     * 函数接收 { url, method } 作为参数，可用于动态生成请求头
+     */
+    headers?: HeadersConfig;
+    /**
+     * 取消请求的信号（可与返回的 cancel 一起使用）
+     */
+    signal?: AbortSignal;
+    /**
+     * 请求模式
+     * @default 'cors'
+     */
+    mode?: RequestMode;
+    /**
+     * 凭证模式
+     * @default 'include'
+     */
+    credentials?: CredentialsMode;
+    /**
+     * 请求数据类型
+     * @default 'json'
+     */
+    requestType?: RequestType;
+    /**
+     * 响应数据类型
+     * @default 'json'
+     */
+    responseType?: ResponseType;
+}
+/**
+ * 全局配置（不包含 url、method、data）
+ */
+export interface GlobalConfig<TResponse = any> {
+    /**
+     * 基础 URL，会与请求的 url 拼接
+     */
+    baseURL?: string;
+    /**
+     * 验证请求状态码是否符合要求的函数，返回布尔类型
+     */
+    validateStatus?: ValidateStatusFn;
+    /**
+     * 验证请求内容是否符合业务要求，返回布尔类型
+     */
+    validateResponse?: ValidateResponseFn<TResponse>;
+    /**
+     * 响应数据转换函数
+     * 用于将原始响应数据转换为业务中使用的数据格式
+     * 在 validateResponse 验证通过后执行
+     * @example
+     * // 全局配置：提取通用的 data 字段
+     * transformResponse: (response) => response.data
+     */
+    transformResponse?: TransformResponseFn<TResponse, TResponse>;
+    /**
+     * 用来捕获 validateStatus 为 false 时进行错误处理的函数
+     */
+    onHttpError?: HttpErrorHandler<TResponse>;
+    /**
+     * 用来捕获 validateResponse 为 false 时进行错误处理的函数
+     * 主要用来处理业务场景的错误
+     */
+    onBusinessError?: BusinessErrorHandler<TResponse>;
+    /**
+     * 用来捕获网络异常的错误处理函数
+     * 主要用来处理无网络、跨域等报错问题
+     */
+    onNetworkError?: NetworkErrorHandler;
+    /**
+     * 重试配置
+     */
+    retry?: RetryConfig;
+    /**
+     * 请求超时时间（毫秒）
+     */
+    timeout?: number;
+    /**
+     * 请求头配置
+     * 可以是 HeadersInit、Record<string, string> 或返回这些类型的函数
+     * 函数接收 { url, method } 作为参数，可用于动态生成请求头
+     */
+    headers?: HeadersConfig;
+    /**
+     * 请求模式
+     * @default 'cors'
+     */
+    mode?: RequestMode;
+    /**
+     * 凭证模式
+     * @default 'include'
+     */
+    credentials?: CredentialsMode;
+    /**
+     * 请求数据类型
+     * @default 'json'
+     */
+    requestType?: RequestType;
+    /**
+     * 响应数据类型
+     * @default 'json'
+     */
+    responseType?: ResponseType;
+}
+/**
+ * 响应结果
+ */
+export interface FetchResponse<T = any> {
+    /**
+     * 响应数据
+     */
+    data: T;
+    /**
+     * HTTP 状态码
+     */
+    status: number;
+    /**
+     * 状态文本
+     */
+    statusText: string;
+    /**
+     * 响应头
+     */
+    headers: Headers;
+    /**
+     * 原始 Response 对象
+     */
+    response: Response;
+}
+/**
+ * 错误结果
+ */
+export interface FetchError<T = any> {
+    /**
+     * 错误信息
+     */
+    message: string;
+    /**
+     * 错误类型
+     */
+    type: 'http' | 'business' | 'network' | 'timeout';
+    /**
+     * HTTP 状态码（如果是 HTTP 错误）
+     */
+    status?: number;
+    /**
+     * 响应数据（如果有）
+     */
+    response?: T;
+    /**
+     * 原始错误对象
+     */
+    error?: Error | TypeError | DOMException;
+}
+/**
+ * 请求结果（支持链式调用和解构）
+ * 数组格式：[data, error, success]
+ * - data: 响应数据（成功时）
+ * - error: 错误信息（失败时）
+ * - success: 请求是否成功
+ */
+export type FetchResult<T = any> = [T | undefined, FetchError | undefined, boolean];
+/**
+ * 扩展 Promise，同时支持解构和链式调用
+ */
+export interface FetchResultPromise<T = any> extends Promise<FetchResult<T>> {
+    /**
+     * 成功回调（重载 Promise 的 then 方法）
+     * @param callback 成功时的回调函数
+     * @returns 返回自身，支持链式调用
+     */
+    then(callback: (data: T) => void): this;
+    /**
+     * 取消当前请求（触发 AbortController）
+     */
+    cancel(): void;
+    /**
+     * Promise 的 then 方法（保持兼容性）
+     */
+    then<TResult1 = FetchResult<T>, TResult2 = never>(onfulfilled?: ((value: FetchResult<T>) => TResult1 | PromiseLike<TResult1>) | null | undefined, onrejected?: ((reason: any) => TResult2 | PromiseLike<TResult2>) | null | undefined): Promise<TResult1 | TResult2>;
+    /**
+     * HTTP 验证错误回调
+     * @param callback HTTP 验证错误时的回调函数（validateStatus 返回 false）
+     * @returns 返回自身，支持链式调用
+     */
+    catchHttp(callback: (error: FetchError) => void): this;
+    /**
+     * 业务验证错误回调
+     * @param callback 业务验证错误时的回调函数（validateResponse 返回 false）
+     * @returns 返回自身，支持链式调用
+     */
+    catchBusiness(callback: (error: FetchError) => void): this;
+    /**
+     * 网络错误回调（网络错误、超时等）
+     * @param callback 网络错误时的回调函数
+     * @returns 返回自身，支持链式调用
+     */
+    catchNetwork(callback: (error: FetchError) => void): this;
+    /**
+     * Promise 的 catch 方法（保持兼容性）
+     */
+    catch<TResult = never>(onrejected?: ((reason: any) => TResult | PromiseLike<TResult>) | null | undefined): Promise<FetchResult<T> | TResult>;
+}
+/**
+ * 主类接口
+ */
+export interface FetchInstance {
+    /**
+     * 发送请求
+     * @param config 请求配置
+     * @returns FetchResultPromise<TResponse> 支持链式调用和解构
+     */
+    request<TRequest = any, TResponse = any>(config: RequestConfig<TRequest, TResponse>): FetchResultPromise<TResponse>;
+    /**
+     * 设置全局配置
+     * @param config 全局配置
+     */
+    setGlobalConfig(config: GlobalConfig): void;
+    /**
+     * 获取当前全局配置
+     */
+    getGlobalConfig(): GlobalConfig;
+    /**
+     * 合并全局配置
+     * @param config 部分全局配置
+     */
+    mergeGlobalConfig(config: Partial<GlobalConfig>): void;
+    /**
+     * GET 请求（支持链式调用）
+     * @param url 请求 URL
+     * @param params 请求参数（会转换为 URL 查询参数）
+     * @param config 请求配置（不包含 url、method 和 data）
+     * @returns FetchResultPromise<TResponse> 支持链式调用和解构
+     */
+    sendGet<TRequest = any, TResponse = any>(url: string, params?: TRequest, config?: Omit<RequestConfig<TRequest, TResponse>, 'url' | 'method' | 'data'>): FetchResultPromise<TResponse>;
+    /**
+     * POST 请求（支持链式调用）
+     * 默认使用 JSON 格式发送数据
+     * @param url 请求 URL
+     * @param data 请求数据
+     * @param config 请求配置（不包含 url、method 和 data）
+     * @returns FetchResultPromise<TResponse> 支持链式调用和解构
+     */
+    sendPost<TRequest = any, TResponse = any>(url: string, data?: TRequest, config?: Omit<RequestConfig<TRequest, TResponse>, 'url' | 'method' | 'data'>): FetchResultPromise<TResponse>;
+    /**
+     * POST 请求，使用 FormData 格式发送数据（支持文件上传）
+     * @param url 请求 URL
+     * @param data 请求数据（对象会自动转换为 FormData）
+     * @param config 请求配置（不包含 url、method 和 data）
+     * @returns FetchResultPromise<TResponse> 支持链式调用和解构
+     */
+    sendPostForm<TRequest = any, TResponse = any>(url: string, data?: TRequest, config?: Omit<RequestConfig<TRequest, TResponse>, 'url' | 'method' | 'data'>): FetchResultPromise<TResponse>;
+    /**
+     * POST 请求，发送 Blob 数据
+     * @param url 请求 URL
+     * @param data 请求体（JSON/可序列化对象）
+     * @param config 请求配置（不包含 url、method 和 data）
+     * @returns FetchResultPromise<Blob> 支持链式调用和解构
+     */
+    sendPostBlob<TRequest = any>(url: string, data?: TRequest, config?: Omit<RequestConfig<TRequest, Blob>, 'url' | 'method' | 'data'>): FetchResultPromise<Blob>;
+    /**
+     * GET 请求，响应返回 Blob 数据（用于下载文件）
+     * @param url 请求 URL
+     * @param params 请求参数（会转换为 URL 查询参数）
+     * @param config 请求配置（不包含 url、method 和 data）
+     * @returns FetchResultPromise<Blob> 支持链式调用和解构
+     */
+    sendGetBlob<TRequest = any>(url: string, params?: TRequest, config?: Omit<RequestConfig<TRequest, Blob>, 'url' | 'method' | 'data'>): FetchResultPromise<Blob>;
+}
+/**
+ * 创建实例的函数类型
+ * @param globalConfig 全局配置（可选）
+ * @returns FetchInstance
+ */
+export type CreateFetch = (globalConfig?: GlobalConfig) => FetchInstance;
+/**
+ * toAwaitFetch 类型
+ * 既是工厂函数，也是默认实例（类似 axios）
+ */
+export type ToAwaitFetch = CreateFetch & Pick<FetchInstance, 'sendGet' | 'sendPost' | 'sendPostForm' | 'sendPostBlob' | 'sendGetBlob' | 'setGlobalConfig' | 'getGlobalConfig' | 'mergeGlobalConfig'> & {
+    (config: RequestConfig<any, any>): FetchResultPromise<any>;
+    (config?: GlobalConfig): FetchInstance;
+    /**
+     * 创建新实例的便捷方法（默认实例上的别名）
+     */
+    create: CreateFetch;
+    /**
+     * 取消请求的便捷方法
+     * 传入 FetchResultPromise 即可
+     */
+    cancel<T = any>(promise: FetchResultPromise<T>): void;
+};
+/**
+ * 默认导出：既是工厂函数，也是默认实例
+ */
+export default ToAwaitFetch;
+//# sourceMappingURL=toAwaitFetch.api.d.ts.map

package/dist/hooks/toAwaitFetch/toAwaitFetch.api.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"toAwaitFetch.api.d.ts","sourceRoot":"","sources":["../../../src/hooks/toAwaitFetch/toAwaitFetch.api.ts"],"names":[],"mappings":"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"}

package/dist/hooks/toAwaitFetch/toAwaitFetch.d.ts

@@ -0,0 +1,95 @@
+/**
+ * toAwaitFetch 实现
+ * Class 实现，参考 API 类型定义和生命周期图
+ */
+import type { FetchInstance, FetchResultPromise, RequestConfig, GlobalConfig, RequestType, ResponseType, TransformResponseFn, CreateFetch, ToAwaitFetch } from './toAwaitFetch.api';
+/**
+ * 内部请求配置（包含 requestType 和 responseType）
+ * 仅供内部使用，不对外暴露
+ */
+interface InternalRequestConfig<TRequest = any, TResponse = any> extends RequestConfig<TRequest, TResponse> {
+    /**
+     * 请求数据类型（内部使用）
+     * @default 'json'
+     */
+    requestType?: RequestType;
+    /**
+     * 响应数据类型（内部使用）
+     * @default 'json'
+     */
+    responseType?: ResponseType;
+    /**
+     * 响应数据转换函数
+     */
+    transformResponse?: TransformResponseFn<TResponse, TResponse>;
+}
+/**
+ * FetchInstance 实现类
+ */
+declare class FetchInstanceImpl implements FetchInstance {
+    private globalConfig;
+    constructor(globalConfig?: GlobalConfig);
+    /**
+     * 执行请求（核心逻辑）
+     */
+    private executeRequest;
+    /**
+     * 发送请求（内部可接收 requestType 和 responseType）
+     */
+    request<TRequest = any, TResponse = any>(config: RequestConfig<TRequest, TResponse> | InternalRequestConfig<TRequest, TResponse>): FetchResultPromise<TResponse>;
+    /**
+     * 设置全局配置
+     */
+    setGlobalConfig(config: GlobalConfig): void;
+    /**
+     * 获取全局配置
+     */
+    getGlobalConfig(): GlobalConfig;
+    /**
+     * 合并全局配置
+     */
+    mergeGlobalConfig(config: Partial<GlobalConfig>): void;
+    /**
+     * GET 请求
+     */
+    sendGet<TRequest = any, TResponse = any>(url: string, params?: TRequest, config?: Omit<RequestConfig<TRequest, TResponse>, 'url' | 'method' | 'data'>): FetchResultPromise<TResponse>;
+    /**
+     * POST 请求（默认 JSON 格式）
+     */
+    sendPost<TRequest = any, TResponse = any>(url: string, data?: TRequest, config?: Omit<RequestConfig<TRequest, TResponse>, 'url' | 'method' | 'data'>): FetchResultPromise<TResponse>;
+    /**
+     * POST 请求（FormData 格式，用于文件上传）
+     */
+    sendPostForm<TRequest = any, TResponse = any>(url: string, data?: TRequest, config?: Omit<RequestConfig<TRequest, TResponse>, 'url' | 'method' | 'data'>): FetchResultPromise<TResponse>;
+    /**
+     * POST 请求（Blob 数据）
+     */
+    sendPostBlob<TRequest = any>(url: string, data?: TRequest, config?: Omit<RequestConfig<TRequest, Blob>, 'url' | 'method' | 'data'>): FetchResultPromise<Blob>;
+    /**
+     * GET 请求（Blob 响应，用于下载文件）
+     */
+    sendGetBlob<TRequest = any>(url: string, params?: TRequest, config?: Omit<RequestConfig<TRequest, Blob>, 'url' | 'method' | 'data'>): FetchResultPromise<Blob>;
+}
+/**
+ * 创建 toAwaitFetch 实例的工厂函数
+ */
+declare const createInstance: CreateFetch;
+/**
+ * 导出常用方法，方便直接使用：import { sendGet, sendPost } from '...'
+ * 使用箭头函数直接调用实例方法，确保 this 正确绑定
+ */
+export declare const sendGet: <TRequest = any, TResponse = any>(url: string, params?: TRequest, config?: Omit<RequestConfig<TRequest, TResponse>, "url" | "method" | "data">) => FetchResultPromise<TResponse>;
+export declare const sendPost: <TRequest = any, TResponse = any>(url: string, data?: TRequest, config?: Omit<RequestConfig<TRequest, TResponse>, "url" | "method" | "data">) => FetchResultPromise<TResponse>;
+export declare const sendPostForm: <TRequest = any, TResponse = any>(url: string, data?: TRequest, config?: Omit<RequestConfig<TRequest, TResponse>, "url" | "method" | "data">) => FetchResultPromise<TResponse>;
+export declare const sendPostBlob: <TRequest = any>(url: string, data?: TRequest, config?: Omit<RequestConfig<TRequest, Blob>, "url" | "method" | "data">) => FetchResultPromise<Blob>;
+export declare const sendGetBlob: <TRequest = any>(url: string, params?: TRequest, config?: Omit<RequestConfig<TRequest, Blob>, "url" | "method" | "data">) => FetchResultPromise<Blob>;
+export declare const setGlobalConfig: (config: GlobalConfig) => void;
+export declare const cancel: <T = any>(promise: FetchResultPromise<T>) => void;
+/**
+ * 默认实例（既是工厂函数也是实例）
+ * 支持 axios 风格调用：toAwaitFetch(config) 直接发起请求
+ */
+declare const toAwaitFetch: ToAwaitFetch;
+export { createInstance, FetchInstanceImpl };
+export default toAwaitFetch;
+//# sourceMappingURL=toAwaitFetch.d.ts.map