create-bubbles 0.1.27 → 0.1.28

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=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=`\
+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`]),monorepo:a([`#F59E0B`,`#FBBF24`]),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:`monorepo`,display:`Monorepo`,color:s.monorepo,variants:[{name:`pnpm-vp-monorepo`,display:`pnpm + vp monorepo`,color:s.monorepo}]},{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.
@@ -9,7 +9,7 @@ Options:
 
 Available templates:
 ${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+=`
+`)}`,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,b[i]??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 or project type`,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.resolve(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);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} `);let H=A===`pnpm-vp-monorepo`?`pnpm`:P;switch(H){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{};
+ yarn dev`;break;default:B+=a([`pink`,`white`])(`\n  ${H} install`),B+=a([`pink`,`white`])(`\n  ${H} 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.27",
+  "version": "0.1.28",
   "homepage": "https://github.com/435012357/bubblesjs/tree/master/packages/create-bubbles#readme",
   "bugs": {
     "url": "https://github.com/435012357/bubblesjs/issues"
@@ -20,7 +20,15 @@
     "index.js",
     "template-*",
     "dist",
-    "template-*/**"
+    "template-*/**",
+    "!template-pnpm-vp-monorepo/**/node_modules/**",
+    "!template-pnpm-vp-monorepo/**/dist/**",
+    "!template-pnpm-vp-monorepo/**/coverage/**",
+    "!template-pnpm-vp-monorepo/**/.vite/**",
+    "!template-pnpm-vp-monorepo/**/.vitepress/cache/**",
+    "!template-pnpm-vp-monorepo/.vite-hooks/_/**",
+    "!template-pnpm-vp-monorepo/**/*.tsbuildinfo",
+    "!template-pnpm-vp-monorepo/**/*.tgz"
   ],
   "type": "module",
   "publishConfig": {

package/template-pnpm-vp-monorepo/.changeset/README.md

@@ -0,0 +1,8 @@
+# Changesets
+
+根项目、`docs`、`playground` 和 `@bubblesjs/utils` 均为 `private: true`，目前没有 npm 发布对象。根目录 `tsconfig/` 是普通配置目录，不作为工作区包，也不参与版本与发布。
+
+以下流程保留给将来新增的公开包：修改公开包后运行 `pnpm changeset`，选择包、版本类型并填写变更说明。
+
+合并变更后运行 `pnpm version-packages` 更新版本和锁文件；运行 `pnpm release` 发布。
+将来的公开包默认使用 `@bubblesjs/<名称>`，例如 `@bubblesjs/math`。若复制 utils 作为公开包，须显式移除 `private: true`，设置 `publishConfig.access` 为 `public` 并完善发布元信息，确认 npm 账户拥有 `@bubblesjs` scope 或对应组织的包发布权限；只有更换 scope 时才同步替换包名与引用。完整步骤见 `apps/docs/guide/release.md`。

package/template-pnpm-vp-monorepo/.changeset/config.json

@@ -0,0 +1,11 @@
+{
+  "$schema": "https://unpkg.com/@changesets/config@3.1.1/schema.json",
+  "changelog": "@changesets/cli/changelog",
+  "commit": false,
+  "fixed": [],
+  "linked": [],
+  "access": "public",
+  "baseBranch": "main",
+  "updateInternalDependencies": "patch",
+  "ignore": []
+}

package/template-pnpm-vp-monorepo/.gitattributes

@@ -0,0 +1,5 @@
+* text=auto
+.vite-hooks/* text eol=lf
+*.sh text eol=lf
+*.yml text eol=lf
+*.yaml text eol=lf

package/template-pnpm-vp-monorepo/.github/workflows/ci.yml

@@ -0,0 +1,33 @@
+name: CI
+
+on:
+  pull_request:
+  push:
+    branches: [main]
+
+concurrency:
+  group: ci-${{ github.workflow }}-${{ github.ref }}
+  cancel-in-progress: true
+
+permissions:
+  contents: read
+
+jobs:
+  quality:
+    name: Check and build (${{ matrix.os }})
+    strategy:
+      matrix:
+        os: [ubuntu-latest, windows-latest]
+    runs-on: ${{ matrix.os }}
+    timeout-minutes: 20
+    steps:
+      - uses: actions/checkout@v4
+      - uses: pnpm/action-setup@v4
+        with:
+          run_install: false
+      - uses: actions/setup-node@v4
+        with:
+          node-version-file: .node-version
+          cache: pnpm
+      - run: pnpm install --frozen-lockfile
+      - run: pnpm ready

package/template-pnpm-vp-monorepo/.github/workflows/docs.yml

@@ -0,0 +1,55 @@
+name: Deploy docs
+
+on:
+  workflow_dispatch:
+
+concurrency:
+  group: pages
+  cancel-in-progress: false
+
+permissions:
+  contents: read
+  pages: write
+  id-token: write
+
+jobs:
+  build:
+    runs-on: ubuntu-latest
+    timeout-minutes: 15
+    steps:
+      - uses: actions/checkout@v4
+      - uses: pnpm/action-setup@v4
+        with:
+          run_install: false
+      - uses: actions/setup-node@v4
+        with:
+          node-version-file: .node-version
+          cache: pnpm
+      - run: pnpm install --frozen-lockfile
+      - name: Resolve GitHub Pages base
+        shell: bash
+        env:
+          REPOSITORY: ${{ github.repository }}
+        run: |
+          owner_name="${REPOSITORY%%/*}"
+          repository_name="${REPOSITORY#*/}"
+          if [[ "${repository_name,,}" == "${owner_name,,}.github.io" ]]; then
+            echo "DOCS_BASE=/" >> "$GITHUB_ENV"
+          else
+            echo "DOCS_BASE=/$repository_name/" >> "$GITHUB_ENV"
+          fi
+      - run: pnpm docs:build
+      - uses: actions/configure-pages@v5
+      - uses: actions/upload-pages-artifact@v3
+        with:
+          path: apps/docs/.vitepress/dist
+  deploy:
+    needs: build
+    runs-on: ubuntu-latest
+    environment:
+      name: github-pages
+      url: ${{ steps.deployment.outputs.page_url }}
+    steps:
+      - name: Deploy to GitHub Pages
+        id: deployment
+        uses: actions/deploy-pages@v4

package/template-pnpm-vp-monorepo/.github/workflows/release.yml

@@ -0,0 +1,54 @@
+name: Release
+
+on:
+  workflow_dispatch:
+
+concurrency:
+  group: release-main
+  cancel-in-progress: false
+
+permissions:
+  contents: write
+  pull-requests: write
+
+jobs:
+  release:
+    if: github.ref == 'refs/heads/main' && vars.RELEASE_ENABLED == 'true'
+    runs-on: ubuntu-latest
+    timeout-minutes: 20
+    env:
+      NPM_TOKEN: ${{ secrets.NPM_TOKEN }}
+    steps:
+      - uses: actions/checkout@v4
+        with:
+          fetch-depth: 0
+      - uses: pnpm/action-setup@v4
+        with:
+          run_install: false
+      - uses: actions/setup-node@v4
+        with:
+          node-version-file: .node-version
+          cache: pnpm
+          registry-url: https://registry.npmjs.org
+      - run: pnpm install --frozen-lockfile
+      - run: pnpm ready
+      - name: Version packages or publish to npm
+        if: env.NPM_TOKEN != ''
+        uses: changesets/action@v1
+        with:
+          publish: pnpm release
+          version: pnpm version-packages
+          commit: "chore(release): version packages"
+          title: "chore(release): version packages"
+        env:
+          GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}
+          NODE_AUTH_TOKEN: ${{ secrets.NPM_TOKEN }}
+      - name: Create version PR
+        if: env.NPM_TOKEN == ''
+        uses: changesets/action@v1
+        with:
+          version: pnpm version-packages
+          commit: "chore(release): version packages"
+          title: "chore(release): version packages"
+        env:
+          GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}

package/template-pnpm-vp-monorepo/.vite-hooks/commit-msg

@@ -0,0 +1 @@
+node .vite-hooks/run.mjs commitlint --edit "$1"

package/template-pnpm-vp-monorepo/.vite-hooks/pre-commit

@@ -0,0 +1 @@
+node .vite-hooks/run.mjs staged

package/template-pnpm-vp-monorepo/.vite-hooks/run.mjs

@@ -0,0 +1,17 @@
+import { spawnSync } from "node:child_process";
+import { createRequire } from "node:module";
+import { dirname, resolve } from "node:path";
+
+const require = createRequire(import.meta.url);
+const [command, ...args] = process.argv.slice(2);
+const commands = {
+  staged: [resolve(dirname(require.resolve("vite-plus/package.json")), "bin/vp"), "staged"],
+  commitlint: [resolve(dirname(require.resolve("@commitlint/cli/package.json")), "cli.js")],
+};
+
+if (!Object.hasOwn(commands, command)) {
+  throw new Error(`未知 Git hook 命令: ${command}`);
+}
+
+const result = spawnSync(process.execPath, [...commands[command], ...args], { stdio: "inherit" });
+process.exitCode = result.status ?? 1;

package/template-pnpm-vp-monorepo/.vscode/settings.json

@@ -0,0 +1,23 @@
+{
+  "npm.scriptRunner": "vp",
+  "editor.defaultFormatter": "oxc.oxc-vscode",
+  "[javascript]": {
+    "editor.defaultFormatter": "oxc.oxc-vscode"
+  },
+  "[javascriptreact]": {
+    "editor.defaultFormatter": "oxc.oxc-vscode"
+  },
+  "[typescript]": {
+    "editor.defaultFormatter": "oxc.oxc-vscode"
+  },
+  "[typescriptreact]": {
+    "editor.defaultFormatter": "oxc.oxc-vscode"
+  },
+  "oxc.disableNestedConfig": true,
+  "oxc.fmt.disableNestedConfig": true,
+  "editor.formatOnSave": true,
+  "editor.formatOnSaveMode": "file",
+  "editor.codeActionsOnSave": {
+    "source.fixAll.oxc": "explicit"
+  }
+}

package/{LICENSE → template-pnpm-vp-monorepo/LICENSE}

@@ -1,6 +1,6 @@
 MIT License
 
-Copyright (c) 2025-present, bubblesplant.
+Copyright (c) [year] [copyright holder]
 
 Permission is hereby granted, free of charge, to any person obtaining a copy
 of this software and associated documentation files (the "Software"), to deal
@@ -18,4 +18,4 @@ FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
 AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
 LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
 OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
-SOFTWARE.
+SOFTWARE.

package/template-pnpm-vp-monorepo/README.md

@@ -0,0 +1,93 @@
+# Monorepo Template
+
+基于 **pnpm workspace + Vite+ + Vue 3 + VitePress + Changesets** 的 monorepo 模板。参考 `antv-next-pro` 的工程结构，提供可运行的应用、文档站和可构建的内部共享 TypeScript 包。
+
+根项目、`docs`、`playground` 和 `@bubblesjs/utils` 均为 `private: true`，目前没有 npm 发布对象。`@bubblesjs` scope 同样用于内部包标识；Changesets 与发布流程保留给将来新增的公开包。
+
+## 环境与启动
+
+通过 create-bubbles 创建项目，在交互菜单中选择 **Monorepo → pnpm + vp monorepo**，或直接指定模板：
+
+```bash
+pnpm create bubbles my-monorepo -t pnpm-vp-monorepo
+cd my-monorepo
+```
+
+- Node.js 24（最低 24.11.0；`.node-version` / `mise.toml` 固定 24.21.0）
+- pnpm 12.10.1（`packageManager` 固定版本）
+
+```bash
+pnpm install
+pnpm dev
+# 另一个终端启动文档
+pnpm docs:dev
+```
+
+Playground 在 <http://localhost:5173>，文档在 <http://localhost:5174>。Playground 通过源码 alias 消费 `@bubblesjs/utils`，首次开发无需预构建共享包；文档站点独立运行。
+
+## 目录结构
+
+```text
+apps/
+  playground/          Vue 3 示例应用，验证共享包的实际使用
+  docs/                VitePress 中文文档
+packages/
+  utils/               内部共享工具包，ESM / CJS / 类型声明
+tsconfig/              共享严格 TypeScript 配置（base / node / vue）
+.changeset/            版本记录及发布配置
+.github/workflows/     Windows / Linux CI、手动发布及文档部署
+.vite-hooks/           暂存文件检查、Conventional Commits 校验
+```
+
+## 常用命令
+
+| 命令                                                      | 作用                                           |
+| --------------------------------------------------------- | ---------------------------------------------- |
+| `pnpm dev` / `pnpm preview`                               | 启动 / 预览 playground                         |
+| `pnpm docs:dev` / `pnpm docs:build` / `pnpm docs:preview` | 文档开发 / 构建 / 预览                         |
+| `pnpm build`                                              | 按工作区依赖顺序构建所有包与应用               |
+| `pnpm test`                                               | 执行共享包单元测试，不进入 watch 模式          |
+| `pnpm typecheck`                                          | 根配置、共享包、Vue 应用及文档的类型检查       |
+| `pnpm lint`                                               | Oxlint 检查 TS/JS，ESLint 检查 Vue SFC         |
+| `pnpm format` / `pnpm format:check`                       | 格式化 / 检查格式                              |
+| `pnpm check`                                              | 格式、lint、类型和单元测试                     |
+| `pnpm verify:packages`                                    | 本地构建并验证 ESM/CJS、消费类型与打包文件清单 |
+| `pnpm ready` / `pnpm run ci`                              | 完整检查、全量构建和本地产物验证               |
+| `pnpm changeset`                                          | 为将来公开包记录版本变更                       |
+| `pnpm version-packages`                                   | 更新将来公开包的版本、CHANGELOG 和锁文件       |
+| `pnpm release`                                            | 为将来公开包保留的 Changesets npm 发布流程     |
+| `pnpm hooks:install`                                      | 初始化 Git 后手动安装提交检查 hooks            |
+
+Vite+ 统一提供 dev/build/pack/test/lint/fmt/run。任务缓存由 Vite+ 管理；构建产物验证和聚合质量检查每次实际执行。`pnpm verify:packages` 只检查本地产物，不执行 npm 发布。
+
+pnpm 12 的 `pnpm ci` 是清理后安装依赖的内置命令。执行本项目的完整验证请使用 `pnpm ready` 或 `pnpm run ci`。
+
+## 复制为新项目
+
+1. 复制源码，跳过 `node_modules`、`dist`、`.vitepress/cache`、`.vitepress/dist`。
+2. 修改根 `package.json` 的项目名。内部包默认沿用 `@bubblesjs` scope；只有更换 scope 时，才同步替换包名、`workspace:*` 依赖、alias、TS paths、消费类型示例及文档中的 `@bubblesjs`。
+3. 替换各 `LICENSE` 中的年份和版权人，按需要修改许可证。将来新增公开包时，再填写 `author`、`repository`、`homepage`、`bugs`；发布到 npm 的账户需拥有 `@bubblesjs` scope 或对应组织的包发布权限。
+4. 执行 `pnpm install` 更新锁文件，然后运行 `pnpm ready`。
+5. 如需 Git hooks，先初始化 Git（新仓库可执行 `git init -b main`），再运行 `pnpm hooks:install`。源码压缩包或尚未初始化 Git 的目录也可以正常安装。
+
+`pnpm hooks:install` 执行 `vp config --hooks-dir .vite-hooks --no-agent`，手动安装暂存文件检查与 Conventional Commits 校验。`pnpm install` 负责安装依赖，Git hooks 在初始化仓库后按需启用。
+
+模板使用 TypeScript 6.x（`^6.0.3`），工作区统一从 catalog 获取版本。升级到 TypeScript 7 前应验证 Volar 的支持情况。VitePress 使用与 Vite 8 兼容的 `2.0.0-alpha.20`，升级时一起验证文档构建。
+
+## 扩展工作区
+
+新增应用放在 `apps/*`，共享包放在 `packages/*`。每个项目创建独立 `package.json`。内部共享包和应用设为 `private: true`；应用名称可继续使用 `playground`、`docs` 等，无需添加 scope。若将来复制 utils 为公开包，例如 `@bubblesjs/math`，须显式移除 `private: true`，设置 `publishConfig.access` 为 `public` 并完善发布元信息。
+
+外部依赖使用 `catalog:`，版本集中维护在 `pnpm-workspace.yaml`；工作区依赖使用 `workspace:*`。复制 `packages/utils` 可得到带测试和双格式导出的共享包；复制 `apps/playground` 可得到 Vue 应用。修改包名后同步更新 import、alias 和消费类型测试。
+
+共享 TS 配置放在根目录 `tsconfig/`，通过相对路径 `extends` 使用。Vue 应用使用 `tsconfig/vue.json`，Node / 库使用 `tsconfig/node.json`，它们继承 `tsconfig/base.json`。这是普通配置目录，不包含 `package.json`，也不作为工作区包或依赖。
+
+详细说明见 [快速开始](apps/docs/guide/getting-started.md)、[工作区约定](apps/docs/guide/workspace.md) 和 [发布指南](apps/docs/guide/release.md)。
+
+## CI、发布与文档部署
+
+推送 `main` 或创建 PR 时，CI 在 Linux 和 Windows 上执行 `pnpm ready`，使用与本地一致的 Node 和 pnpm 版本。
+
+将来新增公开包后，Release 工作流需先设置仓库变量 `RELEASE_ENABLED=true`，再从 `main` 手动运行。无 `NPM_TOKEN` 时只创建版本 PR，有 token 时支持 npm 发布。仓库需允许 GitHub Actions 创建 PR。首次使用之前完成包名、许可证、仓库元信息和 npm 权限的配置。
+
+文档工作流手动运行。将 GitHub Pages 的构建来源设为 **GitHub Actions**，工作流会根据仓库名设置 `DOCS_BASE`。本地默认为 `/`，也可指定部署子路径（例如 PowerShell：`$env:DOCS_BASE = '/my-project/'`，然后 `pnpm docs:build`）。

package/template-pnpm-vp-monorepo/_gitignore

@@ -0,0 +1,43 @@
+# Logs
+logs
+*.log
+npm-debug.log*
+yarn-debug.log*
+yarn-error.log*
+pnpm-debug.log*
+lerna-debug.log*
+
+node_modules
+dist
+dist-ssr
+*.local
+coverage/
+.pnpm-store/
+.vite/
+.vite-hooks/_/
+**/.vitepress/cache/
+**/.vitepress/dist/
+*.tgz
+
+# dotenv environment variable files
+.env
+.env.*
+!.env.example
+
+# Editor directories and files
+.vscode/*
+!.vscode/settings.json
+!.vscode/extensions.json
+.idea
+.DS_Store
+*.suo
+*.ntvs*
+*.njsproj
+*.sln
+*.sw?
+
+# AI agent worktrees
+.claude/worktrees/
+!.vscode/
+!.vscode/settings.json
+!.vscode/extensions.json

package/template-pnpm-vp-monorepo/apps/docs/.vitepress/config.mts

@@ -0,0 +1,69 @@
+import { defineConfig } from "vitepress";
+
+const basePath = (process.env.DOCS_BASE ?? "/").trim().replace(/^\/+|\/+$/g, "");
+
+export default defineConfig({
+  title: "Monorepo Starter",
+  description: "基于 pnpm、Vue 3 与 Vite+ 的可复用 Monorepo 模板",
+  lang: "zh-CN",
+  base: basePath ? `/${basePath}/` : "/",
+  cleanUrls: true,
+  lastUpdated: true,
+  markdown: {
+    theme: { light: "github-light", dark: "github-dark" },
+  },
+  themeConfig: {
+    nav: [
+      { text: "快速开始", link: "/guide/getting-started" },
+      { text: "工作区约定", link: "/guide/workspace" },
+      { text: "版本与发布", link: "/guide/release" },
+    ],
+    sidebar: {
+      "/guide/": [
+        {
+          text: "使用模板",
+          items: [
+            { text: "快速开始", link: "/guide/getting-started" },
+            { text: "工作区约定", link: "/guide/workspace" },
+            { text: "版本与发布", link: "/guide/release" },
+          ],
+        },
+      ],
+    },
+    search: {
+      provider: "local",
+      options: {
+        locales: {
+          root: {
+            translations: {
+              button: { buttonText: "搜索文档", buttonAriaLabel: "搜索文档" },
+              modal: {
+                displayDetails: "显示详细列表",
+                resetButtonTitle: "清除搜索",
+                backButtonTitle: "返回",
+                noResultsText: "没有找到相关结果",
+                footer: {
+                  selectText: "选择",
+                  navigateText: "切换",
+                  closeText: "关闭",
+                },
+              },
+            },
+          },
+        },
+      },
+    },
+    outline: { label: "本页目录", level: [2, 3] },
+    docFooter: { prev: "上一篇", next: "下一篇" },
+    lastUpdated: { text: "最后更新于" },
+    returnToTopLabel: "返回顶部",
+    sidebarMenuLabel: "菜单",
+    darkModeSwitchLabel: "主题",
+    lightModeSwitchTitle: "切换到浅色模式",
+    darkModeSwitchTitle: "切换到深色模式",
+    skipToContentLabel: "跳转到内容",
+    footer: {
+      message: "从一个共享包、一份文档和一个应用开始。",
+    },
+  },
+});

package/template-pnpm-vp-monorepo/apps/docs/guide/getting-started.md

@@ -0,0 +1,70 @@
+# 快速开始
+
+这个模板把应用、共享包、文档和工程配置组织到一个 pnpm 工作区。示例应用使用 `@bubblesjs/utils`，文档站点独立运行。你可以沿着示例应用的依赖关系继续添加自己的功能。
+
+根项目、`docs`、`playground` 和 `@bubblesjs/utils` 均为 `private: true`，目前没有 npm 发布对象。utils 是内部共享包，仍可构建 ESM/CJS 和类型声明。
+
+## 环境要求
+
+- Node.js `>=24.11.0 <25`
+- pnpm `12.10.1`，与根目录 `package.json` 的 `packageManager` 保持一致
+
+仓库通过 `.node-version` 和 `mise.toml` 固定 Node.js `24.21.0`，便于本地与 CI 使用同一版本。
+
+在项目根目录安装依赖，然后启动应用：
+
+```bash
+pnpm install
+pnpm dev
+```
+
+文档站点使用 VitePress，单独启动：
+
+```bash
+pnpm docs:dev
+```
+
+示例应用默认使用 `http://localhost:5173`，文档默认使用 `http://localhost:5174`。两个开发服务都启用了 `strictPort`，端口被占用时会提示错误。打开终端中输出的本地地址即可浏览。
+
+Playground 通过源码别名消费共享包，修改 `packages/utils/src/` 后即可在示例应用中观察变化。
+
+## 常用命令
+
+以下命令均在仓库根目录运行：
+
+| 命令                    | 用途                                         |
+| ----------------------- | -------------------------------------------- |
+| `pnpm dev`              | 启动示例应用                                 |
+| `pnpm docs:dev`         | 启动文档站点                                 |
+| `pnpm check`            | 运行质量检查与测试                           |
+| `pnpm ready`            | 完整验证：质量检查、测试、构建与包产物检查   |
+| `pnpm build`            | 构建工作区内的包、应用和文档                 |
+| `pnpm test`             | 运行单元测试                                 |
+| `pnpm typecheck`        | 检查工作区的 TypeScript 和 Vue 类型          |
+| `pnpm verify:packages`  | 检查本地 ESM/CJS 和类型产物，不执行 npm 发布 |
+| `pnpm changeset`        | 为将来公开包的变更添加版本记录               |
+| `pnpm version-packages` | 消费 changeset，更新将来公开包的版本与日志   |
+| `pnpm release`          | 为将来公开包保留的 npm 发布流程              |
+| `pnpm hooks:install`    | 初始化 Git 后手动安装提交检查 hooks          |
+
+提交前推荐运行 `pnpm ready`。备用命令是 `pnpm run ci`，显式执行根 `package.json` 中的 `ci` 脚本。在 pnpm 12 中，`ci` 是内置安装命令，因此调用同名项目脚本需要保留 `run`。
+
+只运行某个应用或包时，可以使用 pnpm 的过滤器。例如：
+
+```bash
+pnpm --filter docs build
+pnpm --filter docs preview
+pnpm --filter @bubblesjs/utils test
+```
+
+## 用模板开始自己的项目
+
+1. 把仓库复制到自己的项目目录，设置自己的 Git 远程仓库。
+2. 修改根 `package.json` 的 `name`，内部包默认沿用 `@bubblesjs` scope，私有应用名称无需更改。只有更换 scope 时，才同步修改包名、工作区引用、源码别名和包产物检查脚本。
+3. 替换文档标题、描述、首页内容和示例应用内容。
+4. 更新作者和许可证信息。将来新增公开包时，再完善 `repository`、`homepage`、`bugs` 等发布元信息；若复制 utils 作为公开包，须显式移除 `private: true` 并设置 `publishConfig.access` 为 `public`。
+5. 执行 `pnpm install` 更新锁文件，然后运行 `pnpm ready` 完成全部验证。
+
+如需启用提交前的暂存文件检查与 Conventional Commits 校验，先初始化 Git（新仓库可执行 `git init -b main`），再运行 `pnpm hooks:install`。依赖安装完成后，Git hooks 由这个命令按需启用。
+
+添加新代码之前，先阅读[工作区约定](./workspace)。需要发布 npm 包时，完成[版本与发布](./release)中的初始化步骤。

package/template-pnpm-vp-monorepo/apps/docs/guide/release.md

@@ -0,0 +1,73 @@
+# 版本与发布
+
+根项目、`docs`、`playground` 和 `@bubblesjs/utils` 均为 `private: true`，目前没有 npm 发布对象。utils 用于内部共享，仍可构建与验证 ESM/CJS 和类型声明；`pnpm verify:packages` 是本地产物检查，不执行 npm 发布。
+
+以下 Changesets 流程保留给将来新增的公开包，例如 `@bubblesjs/math` 或 `@bubblesjs/i18n`。
+
+根目录 `tsconfig/` 只保存共享 TypeScript 配置，不作为工作区包，也不参与版本与发布。
+
+## 初始化自己的发布信息
+
+第一次发布前，完成以下配置：
+
+1. 将来的公开包默认使用 `@bubblesjs/<名称>`，例如 `@bubblesjs/math`，私有应用名称无需更改。若复制 utils 作为公开包，须显式移除 `private: true` 并设置 `publishConfig.access` 为 `public`。只有更换 scope 时，才同步更新包名、工作区引用、Vite 与 TypeScript 别名，以及包产物检查脚本。
+2. 更新包清单中的 `repository`、`homepage`、`bugs`、作者和许可证信息，确保链接指向自己的项目。
+3. 检查 `.changeset/config.json` 的默认分支。模板使用 `main`；你的仓库若使用其他分支，需要同步修改配置与工作流。
+4. 确认可发布包的 `files`、`exports`、类型入口和版本，并保持 `publishConfig.access` 为 `public`。模板初始版本是起点，首次发布的目标版本由 changeset 决定。
+5. 发布到 npm 的账户需拥有 `@bubblesjs` scope 或对应组织的包发布权限。在 GitHub 仓库配置具有目标包发布权限的 `NPM_TOKEN` secret，并将仓库变量 `RELEASE_ENABLED` 设置为字符串 `true`，启用发布工作流。
+
+执行 `pnpm install` 更新锁文件，再执行 `pnpm ready` 完成质量检查、测试、构建与包产物检查。验证通过后再进行发布。
+
+## 记录包的变更
+
+当修改会影响共享包的使用者时，运行：
+
+```bash
+pnpm changeset
+```
+
+选择受影响的包、版本级别，并写清行为变化。将生成的 `.changeset/*.md` 与实现一起提交。现有私有项目（包括 utils）不参与 npm 发布，此流程用于将来的公开包。
+
+## 本地更新版本和发布
+
+```bash
+pnpm version-packages
+pnpm install
+pnpm ready
+```
+
+检查包版本、变更日志和锁文件，提交版本变更后，在具有 npm 发布权限的环境运行：
+
+```bash
+pnpm release
+```
+
+`version-packages` 消费 changeset 并修改仓库文件；`release` 会把符合条件的新版本发布到 npm。先确认包名、目标版本和构建产物。
+
+## GitHub 发布工作流
+
+`.github/workflows/release.yml` 使用手动触发 `workflow_dispatch`，并要求在 `main` 分支运行。在 Actions 页面运行它之前，先完成上述发布配置。
+
+- `RELEASE_ENABLED` 未设置为 `true` 时，发布任务跳过。
+- 启用后，Changesets Action 可以创建或更新版本 PR。
+- 版本 PR 合并后，再次手动运行工作流可发布新版本；仅配置了 `NPM_TOKEN` 时才执行 npm 发布。
+
+模板不会因一次普通代码推送自动开启 npm 发布。自己的包完成初始化后，可根据团队流程调整触发条件。
+
+## 部署文档
+
+文档的静态输出位于 `apps/docs/.vitepress/dist/`。本地构建和预览：
+
+```bash
+pnpm --filter docs build
+pnpm --filter docs preview
+```
+
+默认站点路径是 `/`。部署到子路径时，通过 `DOCS_BASE` 设置，例如在 PowerShell 中：
+
+```powershell
+$env:DOCS_BASE = '/my-repository/'
+pnpm --filter docs build
+```
+
+使用 GitHub Pages 时，在仓库设置里将 Pages 的构建来源设置为 GitHub Actions，然后手动运行 `.github/workflows/docs.yml`。工作流根据仓库名称计算 `DOCS_BASE`，上传文档产物并执行 Pages 部署。组织或用户首页仓库，以及自定义域名部署，需确认最终路径与实际访问地址一致。