create-vite-vue 1.0.0 → 1.1.0

package/bin/index.js

@@ -1,4 +1,4 @@
-#!/usr/bin/env node
+#!/usr/bin/env node
 import { execSync } from 'child_process'
 import fs from 'fs'
 import path from 'path'
@@ -8,204 +8,204 @@ import { fileURLToPath } from 'url'
 const __filename = fileURLToPath(import.meta.url)
 const __dirname = path.dirname(__filename)
 
-async function createProject () {
-  // 1️⃣ 输入项目名
-  let projectName
-  while (true) {
-    const res = await prompts({
-      type: 'text',
-      name: 'projectName',
-      message: '📦 项目名称',
-      validate: v => v ? true : '项目名不能为空'
-    })
-    projectName = res.projectName
-    if (!projectName) process.exit(1)
-
-    const targetDir = path.resolve(process.cwd(), projectName)
-    if (fs.existsSync(targetDir)) {
-      console.log('❌ 目录已存在，请重新输入')
-      continue
+  ; (async () => {
+    // 1️⃣ 输入项目名
+    let projectName
+    while (true) {
+      const res = await prompts({
+        type: 'text',
+        name: 'projectName',
+        message: '📦 项目名称',
+        validate: v => v ? true : '项目名不能为空'
+      })
+      projectName = res.projectName
+      if (!projectName) process.exit(1)
+
+      const targetDir = path.resolve(process.cwd(), projectName)
+      if (fs.existsSync(targetDir)) {
+        console.log('❌ 目录已存在，请重新输入')
+        continue
+      }
+      break
     }
-    break
-  }
 
-  const targetDir = path.resolve(process.cwd(), projectName)
+    const targetDir = path.resolve(process.cwd(), projectName)
 
-  const { language } = await prompts({
-    type: 'select',
-    name: 'language',
-    message: '请选择项目语言',
-    choices: [
-      { title: 'JavaScript', value: 'js' },
-      { title: 'TypeScript', value: 'ts' }
-    ]
-  })
+    const { language } = await prompts({
+      type: 'select',
+      name: 'language',
+      message: '请选择项目语言',
+      choices: [
+        { title: 'JavaScript', value: 'js' },
+        { title: 'TypeScript', value: 'ts' }
+      ]
+    })
 
 
-  // 2️⃣ 功能选择
-  const features = await prompts([
-    {
+    // 2️⃣ 功能选择
+    const features = await prompts([
+      {
+        type: 'select',
+        name: 'router',
+        message: '是否使用 vue-router？',
+        choices: [{ title: 'Yes', value: true }, { title: 'No', value: false }]
+      },
+      {
+        type: 'select',
+        name: 'pinia',
+        message: '是否使用 Pinia（含持久化）？',
+        choices: [{ title: 'Yes', value: true }, { title: 'No', value: false }]
+      },
+      {
+        type: 'select',
+        name: 'axios',
+        message: '是否使用 Axios？',
+        choices: [{ title: 'Yes', value: true }, { title: 'No', value: false }]
+      },
+      {
+        type: 'select',
+        name: 'ui',
+        message: '请选择 UI 框架',
+        choices: [
+          { title: 'Element Plus（PC）', value: 'element' },
+          { title: 'Vant（Mobile）', value: 'vant' },
+          { title: '不使用 UI 框架', value: 'none' }
+        ]
+      }
+    ])
+
+    // 3️⃣ 是否立即运行 dev
+    const { runDev } = await prompts({
       type: 'select',
-      name: 'router',
-      message: '是否使用 vue-router？',
+      name: 'runDev',
+      message: '是否立即运行 npm run dev？',
       choices: [{ title: 'Yes', value: true }, { title: 'No', value: false }]
-    },
-    {
-      type: 'select',
-      name: 'pinia',
-      message: '是否使用 Pinia（含持久化）？',
-      choices: [{ title: 'Yes', value: true }, { title: 'No', value: false }]
-    },
-    {
-      type: 'select',
-      name: 'axios',
-      message: '是否使用 Axios？',
-      choices: [{ title: 'Yes', value: true }, { title: 'No', value: false }]
-    },
-    {
-      type: 'select',
-      name: 'ui',
-      message: '请选择 UI 框架',
-      choices: [
-        { title: 'Element Plus（PC）', value: 'element' },
-        { title: 'Vant（Mobile）', value: 'vant' },
-        { title: '不使用 UI 框架', value: 'none' }
-      ]
-    }
-  ])
-
-  // 3️⃣ 是否立即运行 dev
-  const { runDev } = await prompts({
-    type: 'select',
-    name: 'runDev',
-    message: '是否立即运行 npm run dev？',
-    choices: [{ title: 'Yes', value: true }, { title: 'No', value: false }]
-  })
-
-  // 4️⃣ 拷贝 base 模板
-  const baseTemplate = language === 'ts' ? 'base-ts' : 'base-js'
-  fs.cpSync(
-    path.resolve(__dirname, `../template/${baseTemplate}`),
-    targetDir,
-    { recursive: true }
-  )
-
-  // 4️⃣-1️⃣ 替换 index.html 的 title
-  const indexPath = path.join(targetDir, 'index.html')
-  if (fs.existsSync(indexPath)) {
-    const indexContent = fs.readFileSync(indexPath, 'utf-8')
-    fs.writeFileSync(
-      indexPath,
-      indexContent.replace(/<title>.*<\/title>/, `<title>${projectName}</title>`)
+    })
+
+    // 4️⃣ 拷贝 base 模板
+    const baseTemplate = language === 'ts' ? 'base-ts' : 'base-js'
+    fs.cpSync(
+      path.resolve(__dirname, `../template/${baseTemplate}`),
+      targetDir,
+      { recursive: true }
     )
-  }
-
-  // 5️⃣ 拷贝可选模板
-  const copy = name => {
-    fs.cpSync(path.resolve(__dirname, `../template/${name}`), targetDir, { recursive: true })
-  }
-  features.router && copy(language === 'ts' ? 'router-ts' : 'router-js')
-  features.pinia && copy(language === 'ts' ? 'pinia-ts' : 'pinia-js')
-  features.axios && copy(language === 'ts' ? 'axios-ts' : 'axios-js')
-
-  // 6️⃣ 生成 main.js
-  const mainFile = language === 'ts' ? 'main.ts' : 'main.js'
-  const mainTplPath = path.join(targetDir, `src/${mainFile}.tpl`)
-  let main = fs.readFileSync(mainTplPath, 'utf-8')
-
-  const replacements = {
-    '/* __ROUTER_IMPORT__ */': features.router ? "import router from './router'" : '',
-    '/* __PINIA_IMPORT__ */': features.pinia
-      ? "import { createPinia } from 'pinia'\nimport persistedstate from 'pinia-plugin-persistedstate'"
-      : '',
-    '/* __ELEMENT_IMPORT__ */': features.ui === 'element'
-      ? `import ElementPlus from 'element-plus'
+
+    // 4️⃣-1️⃣ 替换 index.html 的 title
+    const indexPath = path.join(targetDir, 'index.html')
+    if (fs.existsSync(indexPath)) {
+      const indexContent = fs.readFileSync(indexPath, 'utf-8')
+      fs.writeFileSync(
+        indexPath,
+        indexContent.replace(/<title>.*<\/title>/, `<title>${projectName}</title>`)
+      )
+    }
+
+    // 5️⃣ 拷贝可选模板
+    const copy = name => {
+      fs.cpSync(path.resolve(__dirname, `../template/${name}`), targetDir, { recursive: true })
+    }
+    features.router && copy(language === 'ts' ? 'router-ts' : 'router-js')
+    features.pinia && copy(language === 'ts' ? 'pinia-ts' : 'pinia-js')
+    features.axios && copy(language === 'ts' ? 'axios-ts' : 'axios-js')
+
+    // 6️⃣ 生成 main.js
+    const mainFile = language === 'ts' ? 'main.ts' : 'main.js'
+    const mainTplPath = path.join(targetDir, `src/${mainFile}.tpl`)
+    let main = fs.readFileSync(mainTplPath, 'utf-8')
+
+    const replacements = {
+      '/* __ROUTER_IMPORT__ */': features.router ? "import router from './router'" : '',
+      '/* __PINIA_IMPORT__ */': features.pinia
+        ? "import { createPinia } from 'pinia'\nimport persistedstate from 'pinia-plugin-persistedstate'"
+        : '',
+      '/* __ELEMENT_IMPORT__ */': features.ui === 'element'
+        ? `import ElementPlus from 'element-plus'
 import 'element-plus/dist/index.css'
 import * as ElementPlusIconsVue from '@element-plus/icons-vue'`
-      : '',
-    '/* __VANT_IMPORT__ */': features.ui === 'vant'
-      ? `import Vant from 'vant'
+        : '',
+      '/* __VANT_IMPORT__ */': features.ui === 'vant'
+        ? `import Vant from 'vant'
 import 'vant/lib/index.css'`
-      : '',
-    '/* __ROUTER_USE__ */': features.router ? 'app.use(router)' : '',
-    '/* __PINIA_USE__ */': features.pinia
-      ? 'app.use(createPinia().use(persistedstate))'
-      : '',
-    '/* __ELEMENT_USE__ */': features.ui === 'element'
-      ? `app.use(ElementPlus)
+        : '',
+      '/* __ROUTER_USE__ */': features.router ? 'app.use(router)' : '',
+      '/* __PINIA_USE__ */': features.pinia
+        ? 'app.use(createPinia().use(persistedstate))'
+        : '',
+      '/* __ELEMENT_USE__ */': features.ui === 'element'
+        ? `app.use(ElementPlus)
 for (const [key, component] of Object.entries(ElementPlusIconsVue)) {
   app.component(key, component)
 }`
-      : '',
-    '/* __VANT_USE__ */': features.ui === 'vant'
-      ? 'app.use(Vant)'
-      : ''
-  }
-
-  function escapeRegExp (str) {
-    return str.replace(/[.*+?^${}()|[\]\\]/g, '\\$&')
-  }
-
-  for (const [placeholder, content] of Object.entries(replacements)) {
-    if (content) {
-      main = main.replace(placeholder, content)
-    } else {
-      const re = new RegExp(`^\\s*${escapeRegExp(placeholder)}\\s*$\\n?`, 'gm')
-      main = main.replace(re, '')
+        : '',
+      '/* __VANT_USE__ */': features.ui === 'vant'
+        ? 'app.use(Vant)'
+        : ''
     }
-  }
-
-  fs.writeFileSync(
-    path.join(targetDir, `src/${mainFile}`),
-    main
-  )
-  fs.unlinkSync(mainTplPath)
-
-  // 7️⃣ 生成 package.json
-  const pkgTpl = path.join(targetDir, 'package.json.tpl')
-  if (fs.existsSync(pkgTpl)) {
-    let pkg = fs.readFileSync(pkgTpl, 'utf-8')
-
-    const optionalDeps = {}
-    if (features.router) optionalDeps['vue-router'] = '^4.4.0'
-    if (features.pinia) {
-      optionalDeps['pinia'] = '^2.2.2'
-      optionalDeps['pinia-plugin-persistedstate'] = '^3.2.1'
-    }
-    if (features.axios) optionalDeps['axios'] = '^1.7.7'
-    if (features.ui === 'element') {
-      optionalDeps['element-plus'] = '^2.8.8'
-      optionalDeps['@element-plus/icons-vue'] = '^2.3.1'
-    }
-    if (features.ui === 'vant') {
-      optionalDeps['vant'] = '^4.9.22'
+
+    function escapeRegExp (str) {
+      return str.replace(/[.*+?^${}()|[\]\\]/g, '\\$&')
     }
 
-    let depsStr = ''
-    const keys = Object.keys(optionalDeps)
-    if (keys.length > 0) {
-      depsStr = ',\n' + keys.map(k => `    "${k}": "${optionalDeps[k]}"`).join(',\n')
+    for (const [placeholder, content] of Object.entries(replacements)) {
+      if (content) {
+        main = main.replace(placeholder, content)
+      } else {
+        const re = new RegExp(`^\\s*${escapeRegExp(placeholder)}\\s*$\\n?`, 'gm')
+        main = main.replace(re, '')
+      }
     }
 
-    pkg = pkg
-      .replace('__PROJECT_NAME__', projectName)
-      .replace('__OPTIONAL_DEP__', depsStr)
+    fs.writeFileSync(
+      path.join(targetDir, `src/${mainFile}`),
+      main
+    )
+    fs.unlinkSync(mainTplPath)
+
+    // 7️⃣ 生成 package.json
+    const pkgTpl = path.join(targetDir, 'package.json.tpl')
+    if (fs.existsSync(pkgTpl)) {
+      let pkg = fs.readFileSync(pkgTpl, 'utf-8')
+
+      const optionalDeps = {}
+      if (features.router) optionalDeps['vue-router'] = '^4.4.0'
+      if (features.pinia) {
+        optionalDeps['pinia'] = '^2.2.2'
+        optionalDeps['pinia-plugin-persistedstate'] = '^3.2.1'
+      }
+      if (features.axios) optionalDeps['axios'] = '^1.7.7'
+      if (features.ui === 'element') {
+        optionalDeps['element-plus'] = '^2.8.8'
+        optionalDeps['@element-plus/icons-vue'] = '^2.3.1'
+      }
+      if (features.ui === 'vant') {
+        optionalDeps['vant'] = '^4.9.22'
+      }
+
+      let depsStr = ''
+      const keys = Object.keys(optionalDeps)
+      if (keys.length > 0) {
+        depsStr = ',\n' + keys.map(k => `    "${k}": "${optionalDeps[k]}"`).join(',\n')
+      }
+
+      pkg = pkg
+        .replace('__PROJECT_NAME__', projectName)
+        .replace('__OPTIONAL_DEP__', depsStr)
+
+      fs.writeFileSync(path.join(targetDir, 'package.json'), pkg)
+      fs.unlinkSync(pkgTpl)
+    }
 
-    fs.writeFileSync(path.join(targetDir, 'package.json'), pkg)
-    fs.unlinkSync(pkgTpl)
-  }
+    // 8️⃣ 安装依赖
+    console.log('📦 安装依赖中...')
+    execSync('npm install', { cwd: targetDir, stdio: 'inherit' })
 
-  // 8️⃣ 安装依赖
-  console.log('📦 安装依赖中...')
-  execSync('npm install', { cwd: targetDir, stdio: 'inherit' })
+    // 9️⃣ 运行 dev
+    if (runDev) {
+      console.log('🚀 启动开发服务器...')
+      execSync('npm run dev', { cwd: targetDir, stdio: 'inherit' })
+    } else {
+      console.log(`\n✅ 项目创建完成\n👉 cd ${projectName}\n👉 npm run dev\n`)
+    }
+  })()
 
-  // 9️⃣ 运行 dev
-  if (runDev) {
-    console.log('🚀 启动开发服务器...')
-    execSync('npm run dev', { cwd: targetDir, stdio: 'inherit' })
-  } else {
-    console.log(`\n✅ 项目创建完成\n👉 cd ${projectName}\n👉 npm run dev\n`)
-  }
-}
 
-createProject()

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "create-vite-vue",
-  "version": "1.0.0",
+  "version": "1.1.0",
   "description": "基于Vite+Vue3创建基础项目模板",
   "main": "index.js",
   "author": "YwaiX",
@@ -24,4 +24,4 @@
   "dependencies": {
     "prompts": "^2.4.2"
   }
-}
+}

package/template/axios-js/src/utils/request.js

@@ -1,4 +1,5 @@
 import axios from 'axios'
+import { addPendingRequest, removePendingRequest } from './requestCache'
 
 const service = axios.create({
   baseURL: '/api',
@@ -6,13 +7,44 @@ const service = axios.create({
 })
 
 service.interceptors.request.use(
-  config => config,
+  config => {
+    // 在发送请求之前做些什么
+
+    try {
+      addPendingRequest(config)
+    } catch (error) {
+      // 如果是取消请求,直接reject
+      if (error.isCancel) {
+        return Promise.reject({ canceled: true, message: '请求取消' })
+      }
+      throw error
+    }
+    return config
+  },
+  // 对请求错误做些什么
   error => Promise.reject(error)
 )
 
 service.interceptors.response.use(
-  response => response.data,
-  error => Promise.reject(error)
+  response => {
+    removePendingRequest(response.config)
+
+    // 对响应数据做点什么
+    return response.data
+  },
+  error => {
+    // 即使是错误(包括网络错误)也要清理
+    if (error.config) {
+      removePendingRequest(error.config)
+    }
+    // 判断是否是重复请求被取消
+    if (error.canceled) {
+      return Promise.reject(error)
+    }
+
+    // 对响应错误做点什么
+    return Promise.reject(error)
+  }
 )
 
 export default service

package/template/axios-js/src/utils/requestCache.js

@@ -0,0 +1,41 @@
+const pendingRequests = new Map()
+
+/**
+ * 生成请求唯一kaey
+ * @param {RequestConfig} config 请求配置对象
+ * 注意：只适用于可序列化的 params 和 data（如普通对象）
+ */
+function generateReqKey (config) {
+  const { method, url, params, data } = config
+  return [method, url, JSON.stringify(params), JSON.stringify(data)].join('&')
+}
+
+/**
+ * 添加pending请求,并自动取消请求
+ * @param {RequestConfig} config 请求配置对象
+ */
+export function addPendingRequest (config) {
+  // 获取请求key
+  const requestKey = generateReqKey(config)
+  // 如果存在相同请求,取消当前请求
+  if (pendingRequests.has(requestKey)) {
+    const error = new Error('重复请求')
+    error.isCancel = true
+    throw error
+  }
+
+  //否则为本次请求创建新的AbortController
+  const controller = new AbortController()
+  // 绑定 signal 到 axios 配置
+  config.signal = controller.signal
+  pendingRequests.set(requestKey, controller)
+}
+
+/**
+ * 移除已完成/失败/取消的请求
+ * @param {RequestConfig} config 请求配置对象
+ */
+export function removePendingRequest (config) {
+  const requestKey = generateReqKey(config)
+  pendingRequests.delete(requestKey)
+}

package/template/axios-ts/src/utils/request.ts

@@ -1,4 +1,5 @@
 import axios from 'axios'
+import { addPendingRequest, removePendingRequest } from './requestCache'
 
 const service = axios.create({
   baseURL: '/api',
@@ -6,13 +7,44 @@ const service = axios.create({
 })
 
 service.interceptors.request.use(
-  config => config,
+  config => {
+    // 在发送请求之前做些什么
+
+    try {
+      addPendingRequest(config)
+    } catch (error) {
+      // 如果是取消请求,直接reject
+      if (error.isCancel) {
+        return Promise.reject({ canceled: true, message: '请求取消' })
+      }
+      throw error
+    }
+    return config
+  },
+  // 对请求错误做些什么
   error => Promise.reject(error)
 )
 
 service.interceptors.response.use(
-  response => response.data,
-  error => Promise.reject(error)
+  response => {
+    removePendingRequest(response.config)
+
+    // 对响应数据做点什么
+    return response.data
+  },
+  error => {
+    // 即使是错误(包括网络错误)也要清理
+    if (error.config) {
+      removePendingRequest(error.config)
+    }
+    // 判断是否是重复请求被取消
+    if (error.canceled) {
+      return Promise.reject(error)
+    }
+
+    // 对响应错误做点什么
+    return Promise.reject(error)
+  }
 )
 
 export default service

package/template/axios-ts/src/utils/requestCache.ts

@@ -0,0 +1,41 @@
+const pendingRequests = new Map()
+
+/**
+ * 生成请求唯一kaey
+ * @param {RequestConfig} config 请求配置对象
+ * 注意：只适用于可序列化的 params 和 data（如普通对象）
+ */
+function generateReqKey (config) {
+  const { method, url, params, data } = config
+  return [method, url, JSON.stringify(params), JSON.stringify(data)].join('&')
+}
+
+/**
+ * 添加pending请求,并自动取消请求
+ * @param {RequestConfig} config 请求配置对象
+ */
+export function addPendingRequest (config) {
+  // 获取请求key
+  const requestKey = generateReqKey(config)
+  // 如果存在相同请求,取消当前请求
+  if (pendingRequests.has(requestKey)) {
+    const error = new Error('重复请求') as Error & { isCancel: boolean }
+    error.isCancel = true
+    throw error
+  }
+
+  //否则为本次请求创建新的AbortController
+  const controller = new AbortController()
+  // 绑定 signal 到 axios 配置
+  config.signal = controller.signal
+  pendingRequests.set(requestKey, controller)
+}
+
+/**
+ * 移除已完成/失败/取消的请求
+ * @param {RequestConfig} config 请求配置对象
+ */
+export function removePendingRequest (config) {
+  const requestKey = generateReqKey(config)
+  pendingRequests.delete(requestKey)
+}

package/template/base-js/types/request.d.ts

@@ -0,0 +1,148 @@
+// request.d.ts
+
+declare global {
+  /**
+   * HTTP 请求方法类型
+   */
+  type HttpMethod =
+    | 'GET'
+    | 'POST'
+    | 'PUT'
+    | 'DELETE'
+    | 'PATCH'
+    | 'HEAD'
+    | 'OPTIONS'
+    | 'CONNECT'
+    | 'TRACE'
+
+  /**
+   * 请求配置对象（Axios 风格）
+   */
+  interface RequestConfig<T = any> {
+    /** 请求方法，默认 GET */
+    method?: HttpMethod
+    /** 请求 URL */
+    url: string
+    /** 基础 URL，会自动拼接到 url 前面 */
+    baseURL?: string
+    /** URL 查询参数（GET 请求的参数） */
+    params?: Record<string, any>
+    /** 请求体数据（POST、PUT、PATCH 等请求的参数） */
+    data?: T
+    /** 请求超时时间（毫秒），0 表示不超时 */
+    timeout?: number
+    /** 超时错误消息 */
+    timeoutErrorMessage?: string
+    /** 是否携带跨域凭证（cookies） */
+    withCredentials?: boolean
+    /** 响应数据类型 */
+    responseType?: 'arraybuffer' | 'blob' | 'document' | 'json' | 'text' | 'stream'
+    /** 响应编码 */
+    responseEncoding?: string
+    /** 自定义请求头 */
+    headers?: Record<string, string>
+    /** HTTP 基础认证 */
+    auth?: {
+      username: string
+      password: string
+    }
+    /** 代理配置 */
+    proxy?: {
+      host: string
+      port: number
+      protocol?: string
+      auth?: string
+    }
+    /** 响应内容最大长度 */
+    maxContentLength?: number
+    /** 请求体最大长度 */
+    maxBodyLength?: number
+    /** 最大重定向次数 */
+    maxRedirects?: number
+    /** Unix Socket 路径 */
+    socketPath?: string
+    /** Node.js HTTP Agent */
+    httpAgent?: any
+    /** Node.js HTTPS Agent */
+    httpsAgent?: any
+    /** 是否自动解压响应 */
+    decompress?: boolean
+    /** 自定义状态码验证函数 */
+    validateStatus?: (status: number) => boolean
+    /** 参数序列化函数 */
+    paramsSerializer?: (params: any) => string
+    /** 请求数据转换函数 */
+    transformRequest?: ((data: any, headers: any) => any) | Array<(data: any, headers: any) => any>
+    /** 响应数据转换函数 */
+    transformResponse?: ((data: any, headers: any, status: number) => any) | Array<(data: any, headers: any, status: number) => any>
+    /** 上传进度事件回调 */
+    onUploadProgress?: (progressEvent: any) => void
+    /** 下载进度事件回调 */
+    onDownloadProgress?: (progressEvent: any) => void
+    /** 取消令牌 */
+    cancelToken?: any
+    /** CSRF token cookie 名称 */
+    xsrfCookieName?: string
+    /** CSRF token header 名称 */
+    xsrfHeaderName?: string
+    /** 请求适配器 */
+    adapter?: (config: RequestConfig) => any
+    /** AbortSignal（用于取消请求） */
+    signal?: AbortSignal
+    /** 是否使用不安全的 HTTP 解析器 */
+    insecureHTTPParser?: boolean
+    /** 过渡性配置 */
+    transitional?: {
+      /** 是否静默 JSON 解析错误 */
+      silentJSONParsing?: boolean
+      /** 是否强制 JSON 解析 */
+      forcedJSONParsing?: boolean
+      /** 是否澄清超时错误 */
+      clarifyTimeoutError?: boolean
+    }
+    /** 代理连接回调 */
+    onProxyConnect?: (proxyReq: any, req: any, res: any) => void
+    /** 代理错误回调 */
+    onProxyError?: (err: Error, req: any, res: any) => void
+    /** 代理响应回调 */
+    onProxyResponse?: (proxyRes: any, req: any, res: any) => void
+    /** 方法名称（用于拦截器） */
+    methodName?: string
+  }
+
+  /**
+   * Axios 响应对象
+   */
+  interface AxiosResponse<T = any> {
+    /** 响应数据 */
+    data: T
+    /** HTTP 状态码 */
+    status: number
+    /** HTTP 状态文本 */
+    statusText: string
+    /** 响应头 */
+    headers: Record<string, string>
+    /** 请求配置 */
+    config: RequestConfig<T>
+    /** 原始请求对象 */
+    request?: XMLHttpRequest
+  }
+
+  /**
+   * Axios 错误对象
+   */
+  interface AxiosError<T = any> extends Error {
+    /** 错误代码 */
+    code?: string
+    /** 响应对象（如果收到响应） */
+    response?: AxiosResponse<T>
+    /** 请求配置 */
+    config?: RequestConfig<T>
+    /** 原始请求对象 */
+    request?: XMLHttpRequest
+    /** 是否为 Axios 错误 */
+    isAxiosError: boolean
+  }
+}
+export { }
+

package/template/base-ts/types/request.d.ts

@@ -0,0 +1,148 @@
+// request.d.ts
+
+declare global {
+  /**
+   * HTTP 请求方法类型
+   */
+  type HttpMethod =
+    | 'GET'
+    | 'POST'
+    | 'PUT'
+    | 'DELETE'
+    | 'PATCH'
+    | 'HEAD'
+    | 'OPTIONS'
+    | 'CONNECT'
+    | 'TRACE'
+
+  /**
+   * 请求配置对象（Axios 风格）
+   */
+  interface RequestConfig<T = any> {
+    /** 请求方法，默认 GET */
+    method?: HttpMethod
+    /** 请求 URL */
+    url: string
+    /** 基础 URL，会自动拼接到 url 前面 */
+    baseURL?: string
+    /** URL 查询参数（GET 请求的参数） */
+    params?: Record<string, any>
+    /** 请求体数据（POST、PUT、PATCH 等请求的参数） */
+    data?: T
+    /** 请求超时时间（毫秒），0 表示不超时 */
+    timeout?: number
+    /** 超时错误消息 */
+    timeoutErrorMessage?: string
+    /** 是否携带跨域凭证（cookies） */
+    withCredentials?: boolean
+    /** 响应数据类型 */
+    responseType?: 'arraybuffer' | 'blob' | 'document' | 'json' | 'text' | 'stream'
+    /** 响应编码 */
+    responseEncoding?: string
+    /** 自定义请求头 */
+    headers?: Record<string, string>
+    /** HTTP 基础认证 */
+    auth?: {
+      username: string
+      password: string
+    }
+    /** 代理配置 */
+    proxy?: {
+      host: string
+      port: number
+      protocol?: string
+      auth?: string
+    }
+    /** 响应内容最大长度 */
+    maxContentLength?: number
+    /** 请求体最大长度 */
+    maxBodyLength?: number
+    /** 最大重定向次数 */
+    maxRedirects?: number
+    /** Unix Socket 路径 */
+    socketPath?: string
+    /** Node.js HTTP Agent */
+    httpAgent?: any
+    /** Node.js HTTPS Agent */
+    httpsAgent?: any
+    /** 是否自动解压响应 */
+    decompress?: boolean
+    /** 自定义状态码验证函数 */
+    validateStatus?: (status: number) => boolean
+    /** 参数序列化函数 */
+    paramsSerializer?: (params: any) => string
+    /** 请求数据转换函数 */
+    transformRequest?: ((data: any, headers: any) => any) | Array<(data: any, headers: any) => any>
+    /** 响应数据转换函数 */
+    transformResponse?: ((data: any, headers: any, status: number) => any) | Array<(data: any, headers: any, status: number) => any>
+    /** 上传进度事件回调 */
+    onUploadProgress?: (progressEvent: any) => void
+    /** 下载进度事件回调 */
+    onDownloadProgress?: (progressEvent: any) => void
+    /** 取消令牌 */
+    cancelToken?: any
+    /** CSRF token cookie 名称 */
+    xsrfCookieName?: string
+    /** CSRF token header 名称 */
+    xsrfHeaderName?: string
+    /** 请求适配器 */
+    adapter?: (config: RequestConfig) => any
+    /** AbortSignal（用于取消请求） */
+    signal?: AbortSignal
+    /** 是否使用不安全的 HTTP 解析器 */
+    insecureHTTPParser?: boolean
+    /** 过渡性配置 */
+    transitional?: {
+      /** 是否静默 JSON 解析错误 */
+      silentJSONParsing?: boolean
+      /** 是否强制 JSON 解析 */
+      forcedJSONParsing?: boolean
+      /** 是否澄清超时错误 */
+      clarifyTimeoutError?: boolean
+    }
+    /** 代理连接回调 */
+    onProxyConnect?: (proxyReq: any, req: any, res: any) => void
+    /** 代理错误回调 */
+    onProxyError?: (err: Error, req: any, res: any) => void
+    /** 代理响应回调 */
+    onProxyResponse?: (proxyRes: any, req: any, res: any) => void
+    /** 方法名称（用于拦截器） */
+    methodName?: string
+  }
+
+  /**
+   * Axios 响应对象
+   */
+  interface AxiosResponse<T = any> {
+    /** 响应数据 */
+    data: T
+    /** HTTP 状态码 */
+    status: number
+    /** HTTP 状态文本 */
+    statusText: string
+    /** 响应头 */
+    headers: Record<string, string>
+    /** 请求配置 */
+    config: RequestConfig<T>
+    /** 原始请求对象 */
+    request?: XMLHttpRequest
+  }
+
+  /**
+   * Axios 错误对象
+   */
+  interface AxiosError<T = any> extends Error {
+    /** 错误代码 */
+    code?: string
+    /** 响应对象（如果收到响应） */
+    response?: AxiosResponse<T>
+    /** 请求配置 */
+    config?: RequestConfig<T>
+    /** 原始请求对象 */
+    request?: XMLHttpRequest
+    /** 是否为 Axios 错误 */
+    isAxiosError: boolean
+  }
+}
+export { }
+