create-bubbles 0.1.25 → 0.1.26

package/dist/index.js

@@ -1,4 +1,4 @@
-import e from"node:fs";import t from"node:path";import{fileURLToPath as n}from"node:url";import*as r from"@clack/prompts";import i from"cross-spawn";import a from"gradient-string";import o from"mri";const s={vue:a([`#42B883`,`#42B883`]),react:a([`#087EA4`,`#087EA4`]),taro:a([`#0000C2`,`#fff`]),nextjs:a([`#000`,`#fff`]),others:a([`#8B5CF6`,`#A855F7`])},c=o(process.argv.slice(2),{alias:{h:`help`,t:`template`},boolean:[`help`,`overwrite`],string:[`template`]}),l=process.cwd(),u=`\
+import e from"node:fs";import t from"node:path";import{fileURLToPath as n}from"node:url";import*as r from"@clack/prompts";import i from"cross-spawn";import a from"gradient-string";import o from"mri";const s={vue:a([`#42B883`,`#42B883`]),react:a([`#087EA4`,`#087EA4`]),taro:a([`#0000C2`,`#fff`]),nextjs:a([`#000`,`#fff`]),others:a([`#8B5CF6`,`#A855F7`])},c=o(process.argv.slice(2),{alias:{h:`help`,t:`template`},boolean:[`help`,`overwrite`],string:[`template`]}),l=process.cwd(),u=e=>e.trim().replace(/\/+$/g,``),d=e=>{if(!e)return;let t=e.split(` `)[0].split(`/`);return{name:t[0],version:t[1]}},f=t=>{let n=e.readdirSync(t);return n.length===0||n.length===1&&n[0]===`.git`},p=async n=>{await Promise.all(e.readdirSync(n).filter(e=>e!==`.git`).map(r=>e.promises.rm(t.resolve(n,r),{recursive:!0,force:!0})))},m=e=>/^(?:@[a-z\d\-*~][a-z\d\-*._~]*\/)?[a-z\d\-~][a-z\d\-._~]*$/.test(e),h=e=>e.trim().toLowerCase().replace(/\s+/g,`-`).replace(/^[._]/,``).replace(/[^a-z\d\-~]+g/,`-`),g=[{name:`vue`,display:`Vue`,color:s.vue,variants:[{name:`vue-vp-eslint`,display:`vp + eslint`,color:s.vue},{name:`vp-vue-eslint-vapor`,display:`vp + eslint + vapor`,color:s.vue}]},{name:`react`,display:`React`,color:s.react,variants:[{name:`react-rsbuild-biome`,display:`rsbuild-biome`,color:s.react},{name:`vp-react`,display:`vp-react`,color:s.react},{name:`vp-react-shadcn`,display:`vp-react-shadcn`,color:s.react},{name:`vp-monorepo-react-nestjs`,display:`vp-monorepo-react-nestjs`,color:s.react},{name:`vp-monorepo-react-hono`,display:`vp-monorepo-react-hono`,color:s.react}]},{name:`taro`,display:`Taro`,color:s.taro,variants:[{name:`taro-vue-eslint`,display:`taro-vue + eslint`,color:s.taro},{name:`taro-react-oxc`,display:`taro-react + oxc`,color:s.taro}]},{name:`nextjs`,display:`NextJS`,color:s.nextjs,variants:[{name:`nextjs-vinext-eslint`,display:`nextjs + vinext + eslint`,color:s.nextjs}]},{name:`others`,display:`Others`,color:s.others,variants:[{name:`create-eletron-vite`,display:`Electron ↗`,color:s.others,customCommand:`pnpm create electron-vite@latest TARGET_DIR`}]}],_=g.map(e=>e.variants.map(e=>`${e.name}`)).reduce((e,t)=>e.concat(t),[]),v=`\
 Usage: create-bubbles [OPTION]... [DIRECTORY]
 
 Create a new Bubbles project in JavaScript or TypeScript.
@@ -8,14 +8,8 @@ Options:
   -t, --template NAME        use a specific template
 
 Available templates:
-${s.vue(`vue-vp-eslint              vue`)}
-${s.vue(`vp-vue-eslint-vapor       vue`)}
-${s.react(`react-rsbuild-biome        react`)}
-${s.react(`vp-react                   react`)}
-${s.react(`vp-react-shadcn            react`)}
-${s.react(`vp-monorepo-react-nestjs   react`)}
-${s.taro(`taro-vue-eslint            taro`)}
-${s.nextjs(`nextjs-vinext-eslint      nextjs`)}`,d=e=>e.trim().replace(/\/+$/g,``),f=e=>{if(!e)return;let t=e.split(` `)[0].split(`/`);return{name:t[0],version:t[1]}},p=t=>{let n=e.readdirSync(t);return n.length===0||n.length===1&&n[0]===`.git`},m=async n=>{await Promise.all(e.readdirSync(n).filter(e=>e!==`.git`).map(r=>e.promises.rm(t.resolve(n,r),{recursive:!0,force:!0})))},h=e=>/^(?:@[a-z\d\-*~][a-z\d\-*._~]*\/)?[a-z\d\-~][a-z\d\-._~]*$/.test(e),g=e=>e.trim().toLowerCase().replace(/\s+/g,`-`).replace(/^[._]/,``).replace(/[^a-z\d\-~]+g/,`-`),_=[{name:`vue`,display:`Vue`,color:s.vue,variants:[{name:`vue-vp-eslint`,display:`vp + eslint`,color:s.vue},{name:`vp-vue-eslint-vapor`,display:`vp + eslint + vapor`,color:s.vue}]},{name:`react`,display:`React`,color:s.react,variants:[{name:`react-rsbuild-biome`,display:`rsbuild-biome`,color:s.react},{name:`vp-react`,display:`vp-react`,color:s.react},{name:`vp-react-shadcn`,display:`vp-react-shadcn`,color:s.react},{name:`vp-monorepo-react-nestjs`,display:`vp-monorepo-react-nestjs`,color:s.react}]},{name:`taro`,display:`Taro`,color:s.taro,variants:[{name:`taro-vue-eslint`,display:`taro-vue + eslint`,color:s.taro},{name:`taro-react-oxc`,display:`taro-react + oxc`,color:s.taro}]},{name:`nextjs`,display:`NextJS`,color:s.nextjs,variants:[{name:`nextjs-vinext-eslint`,display:`nextjs + vinext + eslint`,color:s.nextjs}]},{name:`others`,display:`Others`,color:s.others,variants:[{name:`create-eletron-vite`,display:`Electron ↗`,color:s.others,customCommand:`pnpm create electron-vite@latest TARGET_DIR`}]}],v=_.map(e=>e.variants.map(e=>`${e.name}`)).reduce((e,t)=>e.concat(t),[]),y=(e,t)=>{console.log(`💦customCommand`,e,t);let n=t?t.name:`npm`,r=n===`yarn`&&t?.version.startsWith(`1.`);return e.replace(/^npm create (?:-- )?/,()=>n===`bun`?`bun x create-`:n===`pnpm`?`pnpm create `:e.startsWith(`npm create -- `)?`${n} create -- `:`${n} create `).replace(`@latest`,()=>r?``:`@latest`).replace(/^npm exec/,()=>n===`pnpm`?`pnpm dlx`:n===`yarn`&&!r?`yarn dlx`:n===`bun`?`bun x`:`npm exec`)},b={_gitignore:`.gitignore`},x=(n,r)=>{e.mkdirSync(r,{recursive:!0});for(let i of e.readdirSync(n)){let e=t.resolve(n,i),a=t.resolve(r,i);S(e,a)}},S=(t,n)=>{e.statSync(t).isDirectory()?x(t,n):e.copyFileSync(t,n)},C=(t,n)=>{let r=e.readFileSync(t,`utf-8`);e.writeFileSync(t,n(r),`utf-8`)},w=(e,n)=>{C(t.resolve(e,`package.json`),e=>e.replace(/"@vitejs\/plugin-react": ".+?"/,`"@vitejs/plugin-react-swc": "^4.0.1"`)),C(t.resolve(e,`vite.config.${n?`ts`:`js`}`),e=>e.replace(`@vitejs/plugin-react`,`@vitejs/plugin-react-swc`))};(async()=>{console.log(c);let o=c._[0]?d(c._[0]):void 0,x=c.template,C=c.overwrite,T=`bubbles-project`;if(c.help){console.log(u);return}let E=f(process.env.npm_config_user_agent),D=()=>r.cancel(`Operation cancelled`),O=o;if(!O){let e=await r.text({message:`Project name`,defaultValue:T,placeholder:T,validate:e=>(e||[]).length===0||d(e||``).length>0?void 0:`Invalid project name`});if(r.isCancel(e))return D();O=d(e)}if(e.existsSync(O)&&!p(O)){let e=C?`yes`:await r.select({message:O===`.`?`Current directory`:`Target directory "${O}" is not empty. Please choose how to proceed:`,options:[{label:`${s.vue(`Cancel operation`)}`,value:`no`},{label:`Remove existing files and continue`,value:`yes`},{label:`Ignore files and continue`,value:`ignore`}]});if(r.isCancel(e))return D();switch(e){case`yes`:m(O);break;case`no`:D();return}}let k=t.basename(t.resolve(O));if(!h(k)){let e=await r.text({message:`Package name is invalid. please input again:`,defaultValue:g(k),placeholder:g(k),validate(e){if(!h(e))return`Invalid package.json name`}});if(r.isCancel(e))return D();k=e}let A=x,j=!1;if(x&&!v.includes(x)&&(A=void 0,j=!0),!A){let e=await r.select({message:j?`"${x}" isn't a valia template. please choose from below:`:`Select a framework`,options:_.map(e=>{let t=e.color;return{label:t(e.display),value:e}})});if(r.isCancel(e))return D();console.log(`💦pkgInfo`,E);let t=await r.select({message:`Select a variant:`,options:e.variants.map(e=>{let t=e.color,n=e.customCommand?y(e.customCommand,E).replace(/ TARGET_DIR$/,``):void 0;return{label:t(e.display||e.name),value:e.name,hint:n}})});if(r.isCancel(t))return D();A=t}let M=t.join(l,O);e.mkdirSync(M,{recursive:!0});let N=!1;A.includes(`-swc`)&&(N=!0,A=A.replace(`-swc`,``));let P=E?E.name:`npm`,{customCommand:F}=_.flatMap(e=>e.variants).find(e=>e.name===A)??{};if(F){let[e,...t]=y(F,E).split(` `),n=t.map(e=>e.replace(`TARGET_DIR`,()=>O));console.log(`💦replacedArgs`,n);let{status:r}=i.sync(e,n,{stdio:`inherit`});process.exit(r??0)}r.log.step(`scaffolding project in ${M}...`);let I=t.resolve(n(import.meta.url),`../..`,`template-${A}`),L=(n,r)=>{let i=t.join(M,b[n]??n);r?e.writeFileSync(i,r):S(t.join(I,n),i)},R=e.readdirSync(I);for(let e of R)e!==`package.json`&&L(e);let z=JSON.parse(e.readFileSync(t.join(I,`package.json`),`utf-8`));z.name=k,L(`package.json`,`${JSON.stringify(z,null,2)}\n`),N&&w(M,A.endsWith(`-ts`));let B=``,V=t.relative(l,M);switch(console.log(`💦cwd`,l),console.log(`💦root`,M),console.log(`💦cdProjectName`,V),B+=`Done. Now run:
+${g.flatMap(e=>e.variants.map(t=>t.color(`${t.name.padEnd(28)}${e.name}`))).join(`
+`)}`,y=(e,t)=>{console.log(`💦customCommand`,e,t);let n=t?t.name:`npm`,r=n===`yarn`&&t?.version.startsWith(`1.`);return e.replace(/^npm create (?:-- )?/,()=>n===`bun`?`bun x create-`:n===`pnpm`?`pnpm create `:e.startsWith(`npm create -- `)?`${n} create -- `:`${n} create `).replace(`@latest`,()=>r?``:`@latest`).replace(/^npm exec/,()=>n===`pnpm`?`pnpm dlx`:n===`yarn`&&!r?`yarn dlx`:n===`bun`?`bun x`:`npm exec`)},b={_gitignore:`.gitignore`},x=(n,r)=>{e.mkdirSync(r,{recursive:!0});for(let i of e.readdirSync(n)){let e=t.resolve(n,i),a=t.resolve(r,i);S(e,a)}},S=(t,n)=>{e.statSync(t).isDirectory()?x(t,n):e.copyFileSync(t,n)},C=(t,n)=>{let r=e.readFileSync(t,`utf-8`);e.writeFileSync(t,n(r),`utf-8`)},w=(e,n)=>{C(t.resolve(e,`package.json`),e=>e.replace(/"@vitejs\/plugin-react": ".+?"/,`"@vitejs/plugin-react-swc": "^4.0.1"`)),C(t.resolve(e,`vite.config.${n?`ts`:`js`}`),e=>e.replace(`@vitejs/plugin-react`,`@vitejs/plugin-react-swc`))};(async()=>{console.log(c);let o=c._[0]?u(c._[0]):void 0,x=c.template,C=c.overwrite,T=`bubbles-project`;if(c.help){console.log(v);return}let E=d(process.env.npm_config_user_agent),D=()=>r.cancel(`Operation cancelled`),O=o;if(!O){let e=await r.text({message:`Project name`,defaultValue:T,placeholder:T,validate:e=>(e||[]).length===0||u(e||``).length>0?void 0:`Invalid project name`});if(r.isCancel(e))return D();O=u(e)}if(e.existsSync(O)&&!f(O)){let e=C?`yes`:await r.select({message:O===`.`?`Current directory`:`Target directory "${O}" is not empty. Please choose how to proceed:`,options:[{label:`${s.vue(`Cancel operation`)}`,value:`no`},{label:`Remove existing files and continue`,value:`yes`},{label:`Ignore files and continue`,value:`ignore`}]});if(r.isCancel(e))return D();switch(e){case`yes`:p(O);break;case`no`:D();return}}let k=t.basename(t.resolve(O));if(!m(k)){let e=await r.text({message:`Package name is invalid. please input again:`,defaultValue:h(k),placeholder:h(k),validate(e){if(!m(e))return`Invalid package.json name`}});if(r.isCancel(e))return D();k=e}let A=x,j=!1;if(x&&!_.includes(x)&&(A=void 0,j=!0),!A){let e=await r.select({message:j?`"${x}" isn't a valia template. please choose from below:`:`Select a framework`,options:g.map(e=>{let t=e.color;return{label:t(e.display),value:e}})});if(r.isCancel(e))return D();console.log(`💦pkgInfo`,E);let t=await r.select({message:`Select a variant:`,options:e.variants.map(e=>{let t=e.color,n=e.customCommand?y(e.customCommand,E).replace(/ TARGET_DIR$/,``):void 0;return{label:t(e.display||e.name),value:e.name,hint:n}})});if(r.isCancel(t))return D();A=t}let M=t.join(l,O);e.mkdirSync(M,{recursive:!0});let N=!1;A.includes(`-swc`)&&(N=!0,A=A.replace(`-swc`,``));let P=E?E.name:`npm`,{customCommand:F}=g.flatMap(e=>e.variants).find(e=>e.name===A)??{};if(F){let[e,...t]=y(F,E).split(` `),n=t.map(e=>e.replace(`TARGET_DIR`,()=>O));console.log(`💦replacedArgs`,n);let{status:r}=i.sync(e,n,{stdio:`inherit`});process.exit(r??0)}r.log.step(`scaffolding project in ${M}...`);let I=t.resolve(n(import.meta.url),`../..`,`template-${A}`),L=(n,r)=>{let i=t.join(M,b[n]??n);r?e.writeFileSync(i,r):S(t.join(I,n),i)},R=e.readdirSync(I);for(let e of R)e!==`package.json`&&L(e);let z=JSON.parse(e.readFileSync(t.join(I,`package.json`),`utf-8`));z.name=k,L(`package.json`,`${JSON.stringify(z,null,2)}\n`),N&&w(M,A.endsWith(`-ts`));let B=``,V=t.relative(l,M);switch(console.log(`💦cwd`,l),console.log(`💦root`,M),console.log(`💦cdProjectName`,V),B+=`Done. Now run:
 `,M!==l&&(B+=`\n cd ${V.includes(` `)?`"${V}"`:V} `),P){case`yarn`:B+=`
  yarn`,B+=`
  yarn dev`;break;default:B+=a([`pink`,`white`])(`\n  ${P} install`),B+=a([`pink`,`white`])(`\n  ${P} run dev`);break}r.outro(B)})().catch(e=>{console.error(`💦`,e)});export{};

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "create-bubbles",
-  "version": "0.1.25",
+  "version": "0.1.26",
   "homepage": "https://github.com/435012357/bubblesjs/tree/master/packages/create-bubbles#readme",
   "bugs": {
     "url": "https://github.com/435012357/bubblesjs/issues"

package/template-nextjs-vinext-eslint/Dockerfile

@@ -1,8 +1,8 @@
-# nodejs 版本
-FROM node:24-alpine
+# 使用 Node.js Alpine 镜像
+FROM node:alpine
 
-# 使用pnpm 
-RUN corepack enable && corepack prepare pnpm@10.17.1 --activate
+# 安装 pnpm
+RUN npm install --global pnpm
 
 # 设置工作目录
 WORKDIR /app

package/template-nextjs-vinext-eslint/README.md

@@ -7,14 +7,18 @@
 | 类别     | 技术                                |
 | -------- | ----------------------------------- |
 | 框架     | Next.js 16 App Router（via vinext） |
-| 运行时   | Node.js 24                          |
+| 运行时   | Node.js                             |
 | 包管理   | pnpm                                |
-| 语言     | TypeScript 5（严格模式）            |
+| 语言     | TypeScript 7（严格模式）            |
 | UI       | Ant Design 6                        |
 | CSS      | UnoCSS（presetWind4 + Attributify） |
 | 动画     | GSAP 3                              |
 | 代码检查 | ESLint 10                           |
 
+`pnpm typecheck` 使用 TypeScript 7。ESLint 通过 `@typescript/typescript6` 兼容包使用 TypeScript 6 API。
+
+vinext 当前的 npm `latest` 版本为 `1.0.0-beta.9`。显式声明 `ipaddr.js` 是为了让 pnpm 安装后的生产服务能够加载 vinext 图片处理所需的运行时依赖。
+
 ---
 
 ## 代码规范

package/template-nextjs-vinext-eslint/docker-compose.yaml

@@ -1,11 +1,11 @@
-version:  "0.1"
+version: '0.1'
 
 services:
   web:
     container_name: bee-portal
     image: bee-portal
     ports:
-      - "9980:9980"
+      - '9980:9980'
   nginx:
     image: nginx:latest
     container_name: nginx
@@ -14,8 +14,8 @@ services:
       - ./nginx.conf:/etc/nginx/nginx.conf
       - ./logs:/var/log/nginx
     ports:
-      - "8080:80"
-      - "8443:443"
+      - '8080:80'
+      - '8443:443'
     restart: always
     # 依赖于哪个服务，这边是依赖于web服务
     depends_on:

package/template-nextjs-vinext-eslint/eslint.config.js

@@ -14,6 +14,8 @@ export default antfu({
   ignores: [
     '**/node_modules/**',
     '**/dist/**',
+    '**/.next/**',
+    '**/.vinext/**',
     '**/public/**',
     '**/*.md',
   ],

package/template-nextjs-vinext-eslint/package.json

@@ -6,6 +6,7 @@
   "scripts": {
     "dev": "vinext dev --port 9980",
     "build": "vinext build",
+    "typecheck": "tsc --noEmit",
     "start": "vinext start",
     "prepare": "lefthook install",
     "lint": "eslint",
@@ -13,38 +14,39 @@
   },
   "dependencies": {
     "@ant-design/cssinjs": "^2.1.2",
-    "alova": "^3.5.1",
-    "antd": "^6.4.3",
+    "alova": "^3.5.5",
+    "antd": "^6.6.3",
     "gsap": "^3.15.0",
-    "next": "16.2.7",
-    "react": "19.2.7",
-    "react-dom": "19.2.7"
+    "ipaddr.js": "^2.5.0",
+    "next": "16.3.4",
+    "react": "19.2.8",
+    "react-dom": "19.2.8"
   },
   "devDependencies": {
-    "@antfu/eslint-config": "^9.0.0",
-    "@commitlint/cli": "^21.0.2",
-    "@commitlint/config-conventional": "^21.0.2",
-    "@eslint-react/eslint-plugin": "^5.8.16",
-    "@next/eslint-plugin-next": "^16.2.7",
+    "@antfu/eslint-config": "^9.5.1",
+    "@commitlint/cli": "^21.2.2",
+    "@commitlint/config-conventional": "^21.2.2",
+    "@eslint-react/eslint-plugin": "^5.19.0",
+    "@next/eslint-plugin-next": "^16.3.4",
     "@svgr/core": "^8.1.0",
-    "@types/node": "^24.12.0",
-    "@types/react": "^19.2.17",
-    "@types/react-dom": "^19.2.3",
-    "@unocss/eslint-plugin": "^66.7.0",
-    "@vitejs/plugin-rsc": "^0.5.27",
-    "eslint": "^10.4.1",
+    "@types/node": "^26.5.0",
+    "@types/react": "^19.2.18",
+    "@types/react-dom": "^19.2.7",
+    "@typescript/native": "npm:typescript@^7.0.2",
+    "@unocss/eslint-plugin": "^66.10.0",
+    "@vitejs/plugin-react": "^6.1.1",
+    "@vitejs/plugin-rsc": "^0.5.34",
+    "eslint": "^10.10.0",
     "eslint-plugin-format": "^2.0.1",
+    "eslint-plugin-jsx-a11y": "^6.10.2",
     "eslint-plugin-react-hooks": "^7.1.1",
-    "eslint-plugin-react-refresh": "^0.5.2",
-    "lefthook": "^2.1.9",
-    "react-server-dom-webpack": "^19.2.7",
-    "typescript": "^6.0.3",
-    "unocss": "^66.7.0",
-    "vinext": "^0.0.55",
-    "vite": "^8.0.16",
+    "eslint-plugin-react-refresh": "^0.5.6",
+    "lefthook": "^2.1.12",
+    "react-server-dom-webpack": "^19.2.8",
+    "typescript": "npm:@typescript/typescript6@^6.0.2",
+    "unocss": "^66.10.0",
+    "vinext": "^1.0.0-beta.9",
+    "vite": "^8.2.2",
     "vite-plugin-svgr": "^5.2.0"
-  },
-  "volta": {
-    "node": "24.14.0"
   }
 }

package/template-nextjs-vinext-eslint/pnpm-workspace.yaml

@@ -1,7 +1,19 @@
-shellEmulator: true
+minimumReleaseAgeExcludePrune: true
+minimumReleaseAgeExclude:
+  - '@types/node@26.5.0'
 
 trustPolicy: no-downgrade
 
+# Babel 7 requires this legacy release; its npm integrity matches the existing lockfile.
+trustPolicyExclude:
+  - semver@6.3.1
+
+shellEmulator: true
+
+allowBuilds:
+  esbuild: true
+  lefthook: true
+
 ignoredBuiltDependencies:
   - sharp
   - unrs-resolver

package/template-nextjs-vinext-eslint/src/utils/request/core/index.ts

@@ -1,9 +1,3 @@
-import {
-  deepMergeObject,
-  isPlainObject,
-  isReadableStream,
-  tryParseJsonString,
-} from './utils'
 import type {
   AlovaGlobalCacheAdapter,
   AlovaOptions,
@@ -12,18 +6,24 @@ import type {
   StatesExport,
   StatesHook,
 } from 'alova'
-import { createAlova } from 'alova'
 import type { FetchRequestInit } from 'alova/fetch'
+import { createAlova } from 'alova'
 import adapterFetch from 'alova/fetch'
+import {
+  deepMergeObject,
+  isPlainObject,
+  isReadableStream,
+  tryParseJsonString,
+} from './utils'
 
 type MaybePromise<T> = T | Promise<T>
-type HeaderValue =
-  | string
-  | number
-  | boolean
-  | null
-  | undefined
-  | (() => MaybePromise<string | number | boolean | null | undefined>)
+type HeaderValue
+  = | string
+    | number
+    | boolean
+    | null
+    | undefined
+    | (() => MaybePromise<string | number | boolean | null | undefined>)
 type StatusMatcher<RE> = number | number[] | ((status: number, response: RE) => boolean)
 type CodeMatcher = Array<number | string>
 
@@ -86,7 +86,7 @@ export type RequestOption<
   SE extends StatesExport<any> = StatesExport<any>,
 > = BaseRequestOption<RC, RE, RH, SE>
 
-type RequestAlovaGenerics<RC extends object, RE, RH, SE extends StatesExport<any>> = {
+interface RequestAlovaGenerics<RC extends object, RE, RH, SE extends StatesExport<any>> {
   Responded: unknown
   Transformed: unknown
   RequestConfig: RC
@@ -114,8 +114,8 @@ type ResolvedRequestOption<RC extends object, RE, RH, SE extends StatesExport<an
     | 'errorDefaultMessage'
     | 'cacheLogger'
   >
-> &
-  BaseRequestOption<RC, RE, RH, SE>
+>
+& BaseRequestOption<RC, RE, RH, SE>
 
 const DEFAULT_SUCCESS_MESSAGE = '操作成功'
 const DEFAULT_ERROR_MESSAGE = '服务异常'
@@ -146,7 +146,7 @@ const defaultRequestOption: BaseRequestOption<any, any, any, any> = {
 }
 
 function getMethodMeta(method: unknown): RequestMeta {
-  const methodRecord = method as { meta?: RequestMeta; config?: { meta?: RequestMeta } } | undefined
+  const methodRecord = method as { meta?: RequestMeta, config?: { meta?: RequestMeta } } | undefined
   return methodRecord?.config?.meta ?? methodRecord?.meta ?? {}
 }
 
@@ -160,31 +160,37 @@ function isMatchedStatus<RE>(
   matcher: StatusMatcher<RE> | undefined,
   response: RE,
 ): boolean {
-  if (matcher === undefined) return status >= 200 && status < 300
+  if (matcher === undefined)
+    return status >= 200 && status < 300
 
-  if (typeof matcher === 'function') return matcher(status, response)
+  if (typeof matcher === 'function')
+    return matcher(status, response)
 
   return Array.isArray(matcher) ? matcher.includes(status) : matcher === status
 }
 
 function isMatchedCode(code: unknown, matcher: CodeMatcher | undefined): boolean {
-  if (!matcher?.length) return true
+  if (!matcher?.length)
+    return true
 
-  return matcher.some((item) => String(item) === String(code))
+  return matcher.some(item => String(item) === String(code))
 }
 
 function getResponseStatus(response: unknown): number {
-  const responseRecord = response as { status?: unknown; statusCode?: unknown }
+  const responseRecord = response as { status?: unknown, statusCode?: unknown }
   const status = responseRecord.statusCode ?? responseRecord.status
   return typeof status === 'number' ? status : Number(status)
 }
 
 function getResponseMessage(data: unknown, messageKey: string, defaultMessage: string): string {
-  if (!isPlainObject(data)) return defaultMessage
+  if (!isPlainObject(data))
+    return defaultMessage
 
   const message = data[messageKey] ?? data.message ?? data.msg
-  if (typeof message === 'string') return message || defaultMessage
-  if (typeof message === 'number') return String(message)
+  if (typeof message === 'string')
+    return message || defaultMessage
+  if (typeof message === 'number')
+    return String(message)
 
   return defaultMessage
 }
@@ -201,7 +207,8 @@ async function parseFetchResponse(response: {
   json?: () => Promise<unknown>
   text?: () => Promise<string>
 }): Promise<unknown> {
-  if (response.status === 204) return undefined
+  if (response.status === 204)
+    return undefined
 
   const reader = typeof response.clone === 'function' ? response.clone() : response
   const contentType = getHeaderValue(response.headers, 'content-type')
@@ -215,12 +222,14 @@ async function parseFetchResponse(response: {
   if (typeof reader.json === 'function') {
     try {
       return await reader.json()
-    } catch {
+    }
+    catch {
       // Fall through to text parsing.
     }
   }
 
-  if (typeof reader.text === 'function') return tryParseJsonString(await reader.text())
+  if (typeof reader.text === 'function')
+    return tryParseJsonString(await reader.text())
 
   return undefined
 }
@@ -229,13 +238,15 @@ function getHeaderValue(
   headers: Headers | Record<string, unknown> | undefined,
   key: string,
 ): string {
-  if (!headers) return ''
+  if (!headers)
+    return ''
 
-  if (typeof Headers !== 'undefined' && headers instanceof Headers) return headers.get(key) ?? ''
+  if (typeof Headers !== 'undefined' && headers instanceof Headers)
+    return headers.get(key) ?? ''
 
   const headerRecord = headers as Record<string, unknown>
-  const value =
-    headerRecord[key] ?? headerRecord[key.toLowerCase()] ?? headerRecord[key.toUpperCase()]
+  const value
+    = headerRecord[key] ?? headerRecord[key.toLowerCase()] ?? headerRecord[key.toUpperCase()]
   return typeof value === 'string' ? value : ''
 }
 
@@ -251,9 +262,9 @@ async function getResponseData(response: unknown): Promise<unknown> {
     return tryParseJsonString(responseRecord.data)
 
   if (
-    isReadableStream(responseRecord.body) ||
-    typeof responseRecord.json === 'function' ||
-    typeof responseRecord.text === 'function'
+    isReadableStream(responseRecord.body)
+    || typeof responseRecord.json === 'function'
+    || typeof responseRecord.text === 'function'
   ) {
     return parseFetchResponse(responseRecord)
   }
@@ -263,7 +274,8 @@ async function getResponseData(response: unknown): Promise<unknown> {
 
 async function resolveHeaderValue(value: HeaderValue): Promise<string | undefined> {
   const resolved = typeof value === 'function' ? await value() : value
-  if (resolved === null || resolved === undefined) return undefined
+  if (resolved === null || resolved === undefined)
+    return undefined
   return String(resolved)
 }
 
@@ -311,7 +323,8 @@ export function createInstance<
 
       for (const [key, value] of Object.entries(config.commonHeaders?.() ?? {})) {
         const resolvedValue = await resolveHeaderValue(value)
-        if (resolvedValue !== undefined) setHeader(headers, key, resolvedValue)
+        if (resolvedValue !== undefined)
+          setHeader(headers, key, resolvedValue)
       }
     },
     responded: {
@@ -322,7 +335,8 @@ export function createInstance<
         const showError = getMetaFlag(meta, 'isShowErrorMessage', config.isShowErrorMessage)
         const isWrapped = getMetaFlag(meta, 'isWrapped', config.isWrapped)
 
-        if (!shouldTransform) return response
+        if (!shouldTransform)
+          return response
 
         const status = getResponseStatus(response)
         const data = await getResponseData(response)
@@ -340,7 +354,8 @@ export function createInstance<
         }
 
         if (!isWrapped) {
-          if (showSuccess) config.successMessageFunc?.(config.successDefaultMessage)
+          if (showSuccess)
+            config.successMessageFunc?.(config.successDefaultMessage)
           return data
         }
 
@@ -353,7 +368,8 @@ export function createInstance<
         )
 
         if (!isMatchedCode(code, config.codeMap.success)) {
-          if (isMatchedCode(code, config.codeMap.unAuthorized)) config.unAuthorizedResponseFunc?.()
+          if (isMatchedCode(code, config.codeMap.unAuthorized))
+            config.unAuthorizedResponseFunc?.()
 
           if (showError) {
             config.errorMessageFunc?.(
@@ -363,7 +379,8 @@ export function createInstance<
           return Promise.reject(response)
         }
 
-        if (showSuccess) config.successMessageFunc?.(responseMessage)
+        if (showSuccess)
+          config.successMessageFunc?.(responseMessage)
 
         return responseData
       },
@@ -396,8 +413,8 @@ export type DualCallInstance<
   RE = Response,
   RH = Headers,
   SE extends StatesExport<any> = StatesExport<any>,
-> = RequestInstance<RC, RE, RH, SE> &
-  ((option?: RequestOption<RC, RE, RH, SE>) => RequestInstance<RC, RE, RH, SE>)
+> = RequestInstance<RC, RE, RH, SE>
+  & ((option?: RequestOption<RC, RE, RH, SE>) => RequestInstance<RC, RE, RH, SE>)
 
 export function createDualCallInstance<
   RC extends object = FetchRequestInit,
@@ -407,7 +424,8 @@ export function createDualCallInstance<
 >(baseConfig: BaseRequestOption<RC, RE, RH, SE>): DualCallInstance<RC, RE, RH, SE> {
   const defaultInstance = createInstance(baseConfig)
   const dualInstance = ((option?: RequestOption<RC, RE, RH, SE>) => {
-    if (!option) return defaultInstance
+    if (!option)
+      return defaultInstance
     return createInstance(deepMergeObject(baseConfig, option))
   }) as DualCallInstance<RC, RE, RH, SE>
 

package/template-nextjs-vinext-eslint/src/utils/request/core/utils.ts

@@ -1,6 +1,7 @@
 export function deepMergeObject<T = any>(source: T, target: Partial<T>): T {
   const merge = (src: any, tgt: any): any => {
-    if (!isPlainObject(src) || !isPlainObject(tgt)) return tgt === undefined ? src : tgt
+    if (!isPlainObject(src) || !isPlainObject(tgt))
+      return tgt === undefined ? src : tgt
 
     const result = { ...src }
     for (const key of Object.keys(tgt)) {
@@ -19,21 +20,26 @@ export function isPlainObject(data: unknown): data is Record<string, any> {
 }
 
 export function isReadableStream(data: unknown): boolean {
-  if (typeof ReadableStream === 'undefined') return false
+  if (typeof ReadableStream === 'undefined')
+    return false
   return data instanceof ReadableStream
 }
 
 export function tryParseJsonString(data: unknown): unknown {
-  if (typeof data !== 'string') return data
+  if (typeof data !== 'string')
+    return data
 
   const value = data.trim()
-  if (!value) return data
+  if (!value)
+    return data
 
-  if (!value.startsWith('{') && !value.startsWith('[')) return data
+  if (!value.startsWith('{') && !value.startsWith('['))
+    return data
 
   try {
     return JSON.parse(value)
-  } catch {
+  }
+  catch {
     return data
   }
 }

package/template-nextjs-vinext-eslint/vite.config.ts

@@ -1,6 +1,6 @@
 import UnoCSS from 'unocss/vite'
 import vinext from 'vinext'
-import { defineConfig } from 'vite-plus'
+import { defineConfig } from 'vite'
 import svgr from 'vite-plugin-svgr'
 
 export default defineConfig({

package/template-react-rsbuild-biome/.agents/rules/SVG/344/275/277/347/224/250.md

@@ -0,0 +1,8 @@
+# SVG 使用
+
+- 图标通过 `*.svg?react` 导入，使用 `@/components/Icon/svg-icon/SvgIcon` 渲染；用 `size`、`color` 控制大小和颜色，默认继承父级。
+- 公共图标放 `src/assets/svg/`，页面专用图标放所属页面的 `assets/svg/`。
+- 保留 `viewBox`；单色图标用 `currentColor`，保留 `none`、多色和渐变。
+- 图片或背景直接导入 `*.svg` 获取 URL。
+
+参数、无障碍设置及示例见 [SvgIcon 使用说明](../../src/components/Icon/svg-icon/README.md)。

package/template-react-rsbuild-biome/AGENTS.md

@@ -0,0 +1,11 @@
+## 目录说明
+
+- 修改文件前，须从文件所在目录逐级向上查找并阅读相关的 `AGENTS.md`（如存在），并遵循其中的说明。
+
+## 按需规则
+
+根据当前任务匹配下表，在执行相关操作前读取对应规则。不要预先加载整个 `.agents/rules/` 目录；任务范围变化时补读新命中的规则。
+
+| 适用条件             | 规则文件                             |
+| -------------------- | ------------------------------------ |
+| 新增、修改或使用 SVG | [SVG 使用](.agents/rules/SVG使用.md) |

package/template-react-rsbuild-biome/index.html

@@ -1,7 +1,7 @@
 <!doctype html>
-<html>
+<html lang="zh-CN">
   <head></head>
   <body>
     <div id="<%= mountId %>"></div>
   </body>
-</html>
+</html>

package/template-react-rsbuild-biome/package.json

@@ -6,37 +6,38 @@
     "dev": "rsbuild dev --env-mode development",
     "dev:prod": "rsbuild dev --env-mode production",
     "build": "rsbuild build",
+    "typecheck": "tsc --noEmit",
     "check": "biome check --write",
     "format": "prettier --write .",
     "preview": "rsbuild preview",
     "reinstall": "rimraf pnpm-lock.yaml && rimraf node_modules && pnpm install"
   },
   "dependencies": {
-    "@alova/adapter-axios": "^2.0.18",
-    "@ant-design/icons": "~6.2.5",
-    "ahooks": "^3.9.7",
-    "alova": "^3.5.1",
-    "antd": "^6.4.3",
-    "dayjs": "^1.11.21",
-    "react": "^19.2.7",
-    "react-dom": "^19.2.7",
-    "react-router": "^7.17.0",
-    "zustand": "^5.0.14"
+    "@alova/adapter-axios": "^2.0.20",
+    "@ant-design/icons": "~6.3.4",
+    "ahooks": "^3.10.0",
+    "alova": "^3.5.5",
+    "antd": "^6.6.3",
+    "dayjs": "^1.11.23",
+    "react": "^19.2.8",
+    "react-dom": "^19.2.8",
+    "react-router": "^8.3.1",
+    "zustand": "^5.0.15"
   },
   "devDependencies": {
-    "@biomejs/biome": "^2.4.16",
-    "@commitlint/config-conventional": "^21.0.2",
-    "@rsbuild/core": "^2.0.11",
-    "@rsbuild/plugin-react": "^2.0.1",
-    "@rsbuild/plugin-sass": "^1.5.3",
-    "@rsbuild/plugin-svgr": "^2.0.3",
-    "@types/react": "^19.2.17",
-    "@types/react-dom": "^19.2.3",
-    "@unocss/postcss": "^66.7.0",
-    "lefthook": "^2.1.9",
-    "prettier": "^3.8.3",
-    "typescript": "^6.0.3",
-    "unocss": "^66.7.0",
-    "unplugin-auto-import": "^21.0.0"
+    "@biomejs/biome": "^2.5.12",
+    "@commitlint/config-conventional": "^21.2.2",
+    "@rsbuild/core": "^2.2.3",
+    "@rsbuild/plugin-react": "^2.1.0",
+    "@rsbuild/plugin-sass": "^2.0.1",
+    "@rsbuild/plugin-svgr": "^2.0.5",
+    "@types/react": "^19.2.18",
+    "@types/react-dom": "^19.2.7",
+    "@unocss/postcss": "^66.10.0",
+    "lefthook": "^2.1.12",
+    "prettier": "^3.9.6",
+    "typescript": "^7.0.2",
+    "unocss": "^66.10.0",
+    "unplugin-auto-import": "^21.1.0"
   }
 }

package/template-react-rsbuild-biome/pnpm-workspace.yaml

@@ -0,0 +1,5 @@
+allowBuilds:
+  '@parcel/watcher': true
+  core-js: true
+  esbuild: true
+  lefthook: true

package/template-react-rsbuild-biome/rsbuild.config.ts

@@ -24,7 +24,7 @@ export default defineConfig({
         // additionalData: `@import "@/styles/variables.scss";`,
       },
     }),
-    pluginSvgr(),
+    pluginSvgr({ svgrOptions: { icon: true, ref: true } }),
   ],
   tools: {
     rspack: {

package/template-react-rsbuild-biome/src/assets/icon/logo.svg

@@ -1,7 +1,7 @@
 <svg width="32" height="32" viewBox="0 0 32 32" fill="none" xmlns="http://www.w3.org/2000/svg">
+  <title>Bubbles</title>
   <rect width="32" height="32" rx="8" fill="white" fill-opacity="0.96"/>
   <path d="M19.0579 9.09827L15.8082 11.0706L12.9421 9.09827L6 13.3109V21.7368L12.9421 25.9498L16.1918 24.2105L19.0579 25.9498L26 21.7368V13.3109L19.0579 9.09827ZM12.9421 24.705L7.02568 21.1148V13.9336L12.9421 10.3433L14.7822 11.6929L12.1157 13.3112V21.7371L15.1661 23.5882L12.9421 24.705ZM13.1417 20.0549H18.8586V21.3475L16.1918 22.9658L13.1417 21.1148V20.0549ZM13.1417 18.9765V16.5097H18.8586V18.9765H13.1417ZM18.8586 15.4312H13.1417V13.9336L15.8082 12.3153L18.8586 14.1663V15.4312ZM24.9743 21.1148L19.0579 24.705L17.2178 23.5882L19.8846 21.9699V13.544L16.8342 11.6929L19.0582 10.3433L24.9746 13.9336L24.9743 21.1148Z" fill="#146AE1"/>
   <path d="M14.573 7.86376L13.3172 5.51634C13.3835 5.37271 13.4218 5.21177 13.4218 5.04137C13.4218 4.43853 12.9568 3.94971 12.3832 3.94971C11.8097 3.94971 11.3447 4.43853 11.3447 5.04137C11.3447 5.64421 11.7792 6.0987 12.326 6.1302L13.5704 8.45652C13.6759 8.65401 13.8713 8.76487 14.0723 8.76487C14.1676 8.76487 14.2647 8.73999 14.3537 8.68708C14.6306 8.5233 14.7289 8.15479 14.573 7.86376Z" fill="#FDC23A"/>
   <path d="M17.4268 7.86376L18.6826 5.51634C18.6164 5.37271 18.5781 5.21177 18.5781 5.04137C18.5781 4.43853 19.0431 3.94971 19.6169 3.94971C20.1904 3.94971 20.6555 4.43853 20.6555 5.04137C20.6555 5.62405 20.221 6.0987 19.6742 6.1302L18.4297 8.45652C18.3243 8.65401 18.1289 8.76487 17.9278 8.76487C17.8325 8.76487 17.7355 8.73999 17.6465 8.68708C17.3696 8.5233 17.2713 8.15479 17.4271 7.86376H17.4268Z" fill="#FDC23A"/>
   </svg>
-