feng3d-cli 0.0.4 → 0.0.6

package/lib/commands/update.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"update.d.ts","sourceRoot":"","sources":["../../src/commands/update.ts"],"names":[],"mappings":"AAAA;;GAEG;AAmCH;;;GAGG;AACH,wBAAsB,aAAa,CAAC,SAAS,GAAE,MAAY,GAAG,OAAO,CAAC,IAAI,CAAC,CAuM1E;AAED;;GAEG;AACH,wBAAsB,sBAAsB,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAG9E"}

package/lib/index.d.ts

@@ -0,0 +1,9 @@
+/**
+ * feng3d-cli
+ * feng3d 命令行工具
+ */
+export { VERSIONS, getDevDependencies } from './versions.js';
+export * from './templates.js';
+export { createProject } from './commands/create.js';
+export { updateProject } from './commands/update.js';
+//# sourceMappingURL=index.d.ts.map

package/lib/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAE,QAAQ,EAAE,kBAAkB,EAAE,MAAM,eAAe,CAAC;AAC7D,cAAc,gBAAgB,CAAC;AAC/B,OAAO,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAC;AACrD,OAAO,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAC"}

package/{dist → lib}/templates.d.ts

@@ -18,9 +18,9 @@ export declare function getTsconfigTemplate(): object;
  */
 export declare function getTsconfigTemplateString(): string;
 /**
- * 获取 vitest.config.ts 模板内容
+ * 获取 vite.config.js 模板内容
  */
-export declare function getVitestConfigTemplate(): string;
+export declare function getViteConfigTemplate(): string;
 /**
  * 获取 eslint.config.js 模板内容
  */
@@ -55,6 +55,10 @@ export declare function getPagesWorkflowTemplate(): string;
  * 获取 GitHub Actions pull-request workflow 模板内容
  */
 export declare function getPullRequestWorkflowTemplate(): string;
+/**
+ * 获取 GitHub Actions upload-oss workflow 模板内容
+ */
+export declare function getUploadOssWorkflowTemplate(): string;
 /**
  * 获取 .husky/pre-commit 模板内容
  */
@@ -70,25 +74,21 @@ export declare function getLicenseTemplate(ctx?: {
  */
 export declare function getVscodeSettingsTemplate(): string;
 /**
- * 检测可用的 schema 路径
- * 优先级：当前项目 -> 依赖目录
+ * 获取 scripts/prepublish.js 模板内容
+ */
+export declare function getPrepublishScriptTemplate(): string;
+/**
+ * 获取 scripts/postpublish.js 模板内容
  */
-export declare function detectSchemaPath(projectDir: string): string;
+export declare function getPostpublishScriptTemplate(): string;
 /**
- * 获取 feng3d.json 模板内容
+ * 获取 scripts/postdocs.js 模板内容
  */
-export declare function getFeng3dConfigTemplate(options: {
+export declare function getPostdocsScriptTemplate(): string;
+/**
+ * 获取 src/index.ts 模板内容
+ */
+export declare function getSrcIndexTemplate(options: {
     name: string;
-    schemaPath?: string;
-}): object;
-/** @deprecated 请使用 getGitignoreTemplate() 函数 */
-export declare const gitignoreTemplate: string;
-/** @deprecated 请使用 getCursorrrulesTemplate() 函数 */
-export declare const cursorrrulesTemplate: string;
-/** @deprecated 请使用 getTsconfigTemplate() 函数 */
-export declare const tsconfigTemplate: object;
-/** @deprecated 请使用 getVitestConfigTemplate() 函数 */
-export declare const vitestConfigTemplate: string;
-/** @deprecated 请使用 getTypedocConfig() 函数 */
-export declare const createTypedocConfig: typeof getTypedocConfig;
+}): string;
 //# sourceMappingURL=templates.d.ts.map

package/{dist → lib}/templates.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"templates.d.ts","sourceRoot":"","sources":["../src/templates.ts"],"names":[],"mappings":"AAAA;;GAEG;AAYH;;GAEG;AACH,wBAAgB,oBAAoB,IAAI,MAAM,CAI7C;AAED;;GAEG;AACH,wBAAgB,uBAAuB,IAAI,MAAM,CAGhD;AAED;;GAEG;AACH,wBAAgB,mBAAmB,IAAI,MAAM,CAG5C;AAED;;GAEG;AACH,wBAAgB,yBAAyB,IAAI,MAAM,CAGlD;AAED;;GAEG;AACH,wBAAgB,uBAAuB,IAAI,MAAM,CAGhD;AAED;;GAEG;AACH,wBAAgB,uBAAuB,IAAI,MAAM,CAGhD;AAED;;GAEG;AACH,wBAAgB,gBAAgB,CAAC,OAAO,EAAE;IACtC,QAAQ,EAAE,MAAM,CAAC;CACpB,GAAG,MAAM,CAGT;AAED;;GAEG;AACH,wBAAgB,wBAAwB,CAAC,OAAO,EAAE;IAC9C,QAAQ,EAAE,MAAM,CAAC;CACpB,GAAG,MAAM,CAKT;AAED;;GAEG;AACH,wBAAgB,oBAAoB,CAAC,QAAQ,EAAE;IAAE,IAAI,EAAE,MAAM,CAAA;CAAE,GAAG,MAAM,CAGvE;AAED;;GAEG;AACH,wBAAgB,0BAA0B,IAAI,MAAM,CAGnD;AAED;;GAEG;AACH,wBAAgB,wBAAwB,IAAI,MAAM,CAGjD;AAED;;GAEG;AACH,wBAAgB,8BAA8B,IAAI,MAAM,CAGvD;AAED;;GAEG;AACH,wBAAgB,yBAAyB,IAAI,MAAM,CAGlD;AAED;;GAEG;AACH,wBAAgB,kBAAkB,CAAC,GAAG,GAAE;IAAE,IAAI,CAAC,EAAE,MAAM,CAAA;CAAO,GAAG,MAAM,CAMtE;AAED;;GAEG;AACH,wBAAgB,yBAAyB,IAAI,MAAM,CAGlD;AAUD;;;GAGG;AACH,wBAAgB,gBAAgB,CAAC,UAAU,EAAE,MAAM,GAAG,MAAM,CAc3D;AAED;;GAEG;AACH,wBAAgB,uBAAuB,CAAC,OAAO,EAAE;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,UAAU,CAAC,EAAE,MAAM,CAAA;CAAE,GAAG,MAAM,CAa9F;AAGD,gDAAgD;AAChD,eAAO,MAAM,iBAAiB,QAAyB,CAAC;AACxD,mDAAmD;AACnD,eAAO,MAAM,oBAAoB,QAA4B,CAAC;AAC9D,+CAA+C;AAC/C,eAAO,MAAM,gBAAgB,QAAwB,CAAC;AACtD,mDAAmD;AACnD,eAAO,MAAM,oBAAoB,QAA4B,CAAC;AAC9D,4CAA4C;AAC5C,eAAO,MAAM,mBAAmB,yBAAmB,CAAC"}
+{"version":3,"file":"templates.d.ts","sourceRoot":"","sources":["../src/templates.ts"],"names":[],"mappings":"AAAA;;GAEG;AAYH;;GAEG;AACH,wBAAgB,oBAAoB,IAAI,MAAM,CAI7C;AAED;;GAEG;AACH,wBAAgB,uBAAuB,IAAI,MAAM,CAGhD;AAED;;GAEG;AACH,wBAAgB,mBAAmB,IAAI,MAAM,CAG5C;AAED;;GAEG;AACH,wBAAgB,yBAAyB,IAAI,MAAM,CAGlD;AAED;;GAEG;AACH,wBAAgB,qBAAqB,IAAI,MAAM,CAG9C;AAED;;GAEG;AACH,wBAAgB,uBAAuB,IAAI,MAAM,CAGhD;AAED;;GAEG;AACH,wBAAgB,gBAAgB,CAAC,OAAO,EAAE;IACtC,QAAQ,EAAE,MAAM,CAAC;CACpB,GAAG,MAAM,CAGT;AAED;;GAEG;AACH,wBAAgB,wBAAwB,CAAC,OAAO,EAAE;IAC9C,QAAQ,EAAE,MAAM,CAAC;CACpB,GAAG,MAAM,CAKT;AAED;;GAEG;AACH,wBAAgB,oBAAoB,CAAC,QAAQ,EAAE;IAAE,IAAI,EAAE,MAAM,CAAA;CAAE,GAAG,MAAM,CAGvE;AAED;;GAEG;AACH,wBAAgB,0BAA0B,IAAI,MAAM,CAGnD;AAED;;GAEG;AACH,wBAAgB,wBAAwB,IAAI,MAAM,CAGjD;AAED;;GAEG;AACH,wBAAgB,8BAA8B,IAAI,MAAM,CAGvD;AAED;;GAEG;AACH,wBAAgB,4BAA4B,IAAI,MAAM,CAGrD;AAED;;GAEG;AACH,wBAAgB,yBAAyB,IAAI,MAAM,CAGlD;AAED;;GAEG;AACH,wBAAgB,kBAAkB,CAAC,GAAG,GAAE;IAAE,IAAI,CAAC,EAAE,MAAM,CAAA;CAAO,GAAG,MAAM,CAMtE;AAED;;GAEG;AACH,wBAAgB,yBAAyB,IAAI,MAAM,CAGlD;AAED;;GAEG;AACH,wBAAgB,2BAA2B,IAAI,MAAM,CAGpD;AAED;;GAEG;AACH,wBAAgB,4BAA4B,IAAI,MAAM,CAGrD;AAED;;GAEG;AACH,wBAAgB,yBAAyB,IAAI,MAAM,CAGlD;AAED;;GAEG;AACH,wBAAgB,mBAAmB,CAAC,OAAO,EAAE;IAAE,IAAI,EAAE,MAAM,CAAA;CAAE,GAAG,MAAM,CAKrE"}

package/lib/versions.d.ts

@@ -0,0 +1,17 @@
+/**
+ * feng3d 项目统一依赖版本
+ * 从 templates/package.json 中读取
+ */
+/**
+ * 统一依赖版本（从 templates/package.json 读取）
+ */
+export declare const VERSIONS: Record<string, string>;
+/**
+ * 获取 devDependencies 配置
+ */
+export declare function getDevDependencies(options?: {
+    includeVitest?: boolean;
+    includeTypedoc?: boolean;
+    includeCoverage?: boolean;
+}): Record<string, string>;
+//# sourceMappingURL=versions.d.ts.map

package/lib/versions.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"versions.d.ts","sourceRoot":"","sources":["../src/versions.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAuBH;;GAEG;AACH,eAAO,MAAM,QAAQ,wBAA6B,CAAC;AAEnD;;GAEG;AACH,wBAAgB,kBAAkB,CAAC,OAAO,GAAE;IACxC,aAAa,CAAC,EAAE,OAAO,CAAC;IACxB,cAAc,CAAC,EAAE,OAAO,CAAC;IACzB,eAAe,CAAC,EAAE,OAAO,CAAC;CACxB,GAAG,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAuB9B"}

package/package.json

@@ -1,44 +1,37 @@
 {
   "name": "feng3d-cli",
-  "version": "0.0.4",
+  "version": "0.0.6",
   "description": "feng3d 项目通用标准，包含代码规范、配置模板和 CLI 工具",
   "homepage": "https://feng3d.com/feng3d-cli/",
   "author": "feng",
   "license": "MIT",
   "type": "module",
-  "main": "./dist/index.js",
-  "types": "./dist/index.d.ts",
+  "main": "./dist/index.umd.cjs",
+  "types": "./lib/index.d.ts",
+  "module": "./dist/index.js",
   "bin": {
-    "feng3d-cli": "./dist/cli.js"
+    "feng3d-cli": "./bin/cli.js"
   },
   "exports": {
     ".": {
-      "types": "./dist/index.d.ts",
-      "import": "./dist/index.js"
-    },
-    "./eslint": {
-      "types": "./dist/eslint.d.ts",
-      "import": "./dist/eslint.js"
+      "types": "./src/index.ts",
+      "import": "./dist/index.js",
+      "require": "./dist/index.umd.cjs"
     }
   },
   "scripts": {
-    "clean": "rimraf \"{lib,dist,public}\"",
-    "build": "tsc",
-    "dev": "tsc -w",
+    "clean": "rimraf lib dist public",
+    "build": "vite build && tsc",
+    "watch": "concurrently \"vite build --watch\" \"tsc -w\" \"vitest\"",
     "test": "vitest run",
-    "test:watch": "vitest",
-    "types": "tsc",
-    "watch": "tsc -w",
     "lint": "eslint . --ext .js,.ts --max-warnings 0",
     "lintfix": "npm run lint -- --fix",
     "docs": "typedoc",
-    "upload_oss": "npm run build && npm run docs && node dist/cli.js oss_upload_dir",
-    "update": "npm run build && node dist/cli.js update && npm install",
-    "release": "npm run clean && npm run lint && npm run build && npm run docs && npm publish",
-    "prepublishOnly": "npm run lint && npm test && npm run build",
-    "publish:manual": "npm publish",
-    "prepare": "husky",
-    "postinstall": "npm run build && node dist/cli.js update || exit 0"
+    "update": "npm run build && node bin/cli.js update && npm install",
+    "prepublishOnly": "node scripts/prepublish.js",
+    "release": "npm run clean && npm run lint && npm test && npm run build && npm run docs && npm publish",
+    "postpublish": "node scripts/postpublish.js",
+    "prepare": "husky"
   },
   "publishConfig": {
     "access": "public"
@@ -48,12 +41,12 @@
     "url": "https://github.com/feng3d-labs/feng3d-cli.git"
   },
   "files": [
+    "bin",
     "dist",
-    "templates",
-    "schemas"
+    "lib",
+    "templates"
   ],
   "dependencies": {
-    "ali-oss": "^6.22.0",
     "chalk": "^5.3.0",
     "commander": "^12.1.0",
     "fs-extra": "^11.2.0"
@@ -75,7 +68,8 @@
     "typescript-eslint": "^8.32.1",
     "vite": "^6.3.5",
     "vitest": "^3.1.3",
-    "cross-env": "7.0.3"
+    "cross-env": "7.0.3",
+    "concurrently": "^9.1.2"
   },
   "lint-staged": {
     "*.{js,ts}": [

package/templates/.github/workflows/pages.yml

@@ -1,15 +1,16 @@
 # 将文档发布到 GitHub Pages
-# 仅在主分支版本号发生变化时触发部署
+# 在 npm 发布成功后自动执行，也可手动触发
 name: Deploy to GitHub Pages
 
 on:
-  push:
-    branches:
-      - master
-      - main
-    paths:
-      - 'package.json'  # 仅在 package.json 变化时触发
-  workflow_dispatch:  # 支持手动触发
+  # npm 发布成功后自动触发
+  workflow_run:
+    workflows: ["Publish to NPM"]
+    types:
+      - completed
+
+  # 支持手动触发
+  workflow_dispatch:
 
 # 设置 GITHUB_TOKEN 的权限
 permissions:
@@ -23,40 +24,10 @@ concurrency:
   cancel-in-progress: true
 
 jobs:
-  # 检查版本号是否变化
-  check-version:
-    runs-on: ubuntu-latest
-    outputs:
-      version_changed: ${{ steps.check.outputs.changed }}
-    steps:
-      - name: Checkout
-        uses: actions/checkout@v4
-        with:
-          fetch-depth: 2  # 获取最近两次提交以比较版本
-
-      - name: Check if version changed
-        id: check
-        run: |
-          # 获取当前版本
-          CURRENT_VERSION=$(node -p "require('./package.json').version")
-          # 获取上一次提交的版本
-          git checkout HEAD~1 -- package.json 2>/dev/null || echo "First commit"
-          PREVIOUS_VERSION=$(node -p "require('./package.json').version" 2>/dev/null || echo "0.0.0")
-          git checkout HEAD -- package.json
-          
-          if [ "$CURRENT_VERSION" != "$PREVIOUS_VERSION" ]; then
-            echo "Version changed from $PREVIOUS_VERSION to $CURRENT_VERSION"
-            echo "changed=true" >> $GITHUB_OUTPUT
-          else
-            echo "Version unchanged: $CURRENT_VERSION"
-            echo "changed=false" >> $GITHUB_OUTPUT
-          fi
-
   build:
     runs-on: ubuntu-latest
-    needs: check-version
-    # 仅在版本号变化或手动触发时构建
-    if: needs.check-version.outputs.version_changed == 'true' || github.event_name == 'workflow_dispatch'
+    # 仅在 publish 成功后执行，或手动触发时执行
+    if: ${{ github.event_name == 'workflow_dispatch' || github.event.workflow_run.conclusion == 'success' }}
     steps:
       - name: Checkout
         uses: actions/checkout@v4
@@ -90,4 +61,3 @@ jobs:
       - name: Deploy to GitHub Pages
         id: deployment
         uses: actions/deploy-pages@v4
-

package/templates/.github/workflows/publish.yml

@@ -58,17 +58,11 @@ jobs:
       - name: Install dependencies
         run: npm install
 
-      - name: Build
-        run: npm run build
-
-      - name: Run lint
-        run: npm run lint
-
       - name: Run tests
         run: npm test
 
-      - name: Publish to NPM
-        run: npm publish
+      - name: Release to NPM
+        run: npm run release
         env:
           NODE_AUTH_TOKEN: ${{ secrets.NPM_TOKEN }}
 

package/templates/.github/workflows/pull-request.yml

@@ -1,6 +1,6 @@
-# CI - 运行单元测试
-# 在合并到主分支或在主分支提交代码时执行
-name: CI
+# 代码检查和测试
+# 在 PR 或推送到主分支时执行
+name: Lint and Test
 
 on:
   push:

package/templates/.github/workflows/upload-oss.yml

@@ -0,0 +1,100 @@
+# 上传文档到 OSS
+# 在 npm 发布成功后自动执行，也可手动触发
+name: Upload to OSS
+
+on:
+  # npm 发布成功后自动触发
+  workflow_run:
+    workflows: ["Publish to NPM"]
+    types:
+      - completed
+
+  # 支持手动触发
+  workflow_dispatch:
+
+jobs:
+  upload:
+    runs-on: ubuntu-latest
+    # 仅在 publish 成功后执行，或手动触发时执行
+    if: ${{ github.event_name == 'workflow_dispatch' || github.event.workflow_run.conclusion == 'success' }}
+    steps:
+      - name: Checkout
+        uses: actions/checkout@v4
+
+      - name: Setup Node.js
+        uses: actions/setup-node@v4
+        with:
+          node-version: '20'
+
+      - name: Install dependencies
+        run: npm install
+
+      - name: Build docs
+        run: npm run docs
+
+      - name: Check OSS config
+        id: check_oss
+        run: |
+          if [ -z "${{ secrets.OSS_ACCESS_KEY_ID }}" ]; then
+            echo "OSS 未配置，跳过上传"
+            echo "skip=true" >> $GITHUB_OUTPUT
+          else
+            echo "skip=false" >> $GITHUB_OUTPUT
+          fi
+
+      - name: Upload to OSS
+        if: steps.check_oss.outputs.skip != 'true'
+        env:
+          OSS_REGION: ${{ secrets.OSS_REGION }}
+          OSS_ACCESS_KEY_ID: ${{ secrets.OSS_ACCESS_KEY_ID }}
+          OSS_ACCESS_KEY_SECRET: ${{ secrets.OSS_ACCESS_KEY_SECRET }}
+          OSS_BUCKET: ${{ secrets.OSS_BUCKET }}
+        run: |
+          # 检查 public 目录是否存在
+          if [ ! -d "public" ]; then
+            echo "public 目录不存在，跳过 OSS 上传"
+            exit 0
+          fi
+
+          # 获取仓库名作为 OSS 目录
+          REPO_NAME=$(node -p "require('./package.json').name.replace(/^@[^/]+\//, '')")
+          echo "上传目录: $REPO_NAME"
+
+          # 安装 ali-oss
+          npm install ali-oss --no-save
+
+          # 执行上传
+          node -e "
+            const OSS = require('ali-oss');
+            const fs = require('fs');
+            const path = require('path');
+
+            const client = new OSS({
+              region: process.env.OSS_REGION,
+              accessKeyId: process.env.OSS_ACCESS_KEY_ID,
+              accessKeySecret: process.env.OSS_ACCESS_KEY_SECRET,
+              bucket: process.env.OSS_BUCKET,
+            });
+
+            const localDir = 'public';
+            const ossDir = '$REPO_NAME';
+
+            async function uploadDir(dir, ossPath) {
+              const items = fs.readdirSync(dir);
+              for (const item of items) {
+                const localPath = path.join(dir, item);
+                const remotePath = ossPath + '/' + item;
+                if (fs.statSync(localPath).isDirectory()) {
+                  await uploadDir(localPath, remotePath);
+                } else {
+                  await client.put(remotePath, localPath);
+                  console.log('上传: ' + remotePath);
+                }
+              }
+            }
+
+            uploadDir(localDir, ossDir)
+              .then(() => console.log('OSS 上传完成'))
+              .catch(err => { console.error('OSS 上传失败:', err); process.exit(1); });
+          "
+

package/templates/.husky/pre-commit

@@ -1,2 +1,33 @@
-npx lint-staged
+#!/bin/sh
 
+echo ""
+echo "🔍 [1/2] 检查代码规范..."
+echo ""
+
+if ! npx lint-staged --allow-empty; then
+    echo ""
+    echo "❌ 代码规范检查失败！"
+    echo ""
+    echo "请修复以上 ESLint 错误后再提交。"
+    echo "提示: 运行 'npm run lintfix' 可自动修复部分问题。"
+    echo ""
+    exit 1
+fi
+
+echo ""
+echo "🧪 [2/2] 运行单元测试..."
+echo ""
+
+if ! npm test; then
+    echo ""
+    echo "❌ 单元测试失败！"
+    echo ""
+    echo "请修复测试错误后再提交。"
+    echo "提示: 运行 'npm test' 查看详细错误信息。"
+    echo ""
+    exit 1
+fi
+
+echo ""
+echo "✅ 所有检查通过，准备提交！"
+echo ""

package/templates/gitignore

@@ -11,13 +11,3 @@ test_dist
 # 测试覆盖率
 coverage
 
-# 以下文件可由 feng3d-cli 自动生成，无需提交
-# 运行 `feng3d-cli update` 可重新生成
-feng3d.json
-.cursorrules
-eslint.config.js
-typedoc.json
-test/_.test.ts
-.husky/pre-commit
-.vscode/settings.json
-tsconfig.json

package/templates/package.json

@@ -0,0 +1,71 @@
+{
+    "name": "{{name}}",
+    "version": "0.0.1",
+    "description": "",
+    "homepage": "https://feng3d.com/{{repoName}}/",
+    "author": "feng",
+    "license": "MIT",
+    "type": "module",
+    "main": "./src/index.ts",
+    "types": "./src/index.ts",
+    "module": "./src/index.ts",
+    "exports": {
+        ".": {
+            "types": "./src/index.ts",
+            "import": "./src/index.ts",
+            "require": "./src/index.ts"
+        }
+    },
+    "scripts": {
+        "examples:dev": "cd examples && npm run dev",
+        "postdocs": "node scripts/postdocs.js && cd examples && vite build --outDir ../public",
+        "clean": "rimraf lib dist public",
+        "build": "vite build && tsc",
+        "watch": "concurrently \"vite build --watch\" \"tsc -w\" \"vitest\"",
+        "test": "vitest run",
+        "lint": "eslint . --ext .js,.ts --max-warnings 0",
+        "lintfix": "npm run lint -- --fix",
+        "docs": "typedoc",
+        "prepublishOnly": "node scripts/prepublish.js",
+        "release": "npm run clean && npm run lint && npm test && npm run build && npm run docs && npm publish",
+        "postpublish": "node scripts/postpublish.js",
+        "prepare": "husky"
+    },
+    "repository": {
+        "type": "git",
+        "url": "https://github.com/feng3d-labs/{{repoName}}.git"
+    },
+    "publishConfig": {
+        "access": "public"
+    },
+    "files": [
+        "dist/",
+        "lib",
+        "src"
+    ],
+    "devDependencies": {
+        "@eslint/js": "^9.0.0",
+        "@typescript-eslint/eslint-plugin": "8.32.1",
+        "@typescript-eslint/parser": "8.32.1",
+        "concurrently": "^9.1.2",
+        "cross-env": "7.0.3",
+        "eslint": "9.26.0",
+        "globals": "^14.0.0",
+        "husky": "^9.1.7",
+        "lint-staged": "^15.2.10",
+        "rimraf": "6.0.1",
+        "tslib": "^2.8.1",
+        "typedoc": "^0.28.4",
+        "typescript": "5.8.3",
+        "typescript-eslint": "^8.32.1",
+        "vite": "^6.3.5",
+        "vitest": "^3.1.3"
+    },
+    "dependencies": {},
+    "lint-staged": {
+        "*.{js,ts}": [
+            "eslint --fix --max-warnings 0"
+        ]
+    }
+}
+

package/templates/scripts/postdocs.js

@@ -0,0 +1,46 @@
+/**
+ * postdocs 脚本
+ *
+ * 将 typedoc 生成的文档从 public 移动到 public/doc 目录
+ */
+
+import { existsSync, mkdirSync, cpSync, rmSync } from 'fs';
+import { resolve, dirname } from 'path';
+import { fileURLToPath } from 'url';
+
+const __filename = fileURLToPath(import.meta.url);
+const __dirname = dirname(__filename);
+const rootDir = resolve(__dirname, '..');
+
+const publicDir = resolve(rootDir, 'public');
+const tempDir = resolve(rootDir, 'public_temp');
+const docDir = resolve(rootDir, 'public/doc');
+
+// 1. 复制 public 到 public_temp
+if (existsSync(publicDir))
+{
+    // 先删除临时目录（如果存在）
+    if (existsSync(tempDir))
+    {
+        rmSync(tempDir, { recursive: true, force: true });
+    }
+    // 复制 public 到 public_temp
+    cpSync(publicDir, tempDir, { recursive: true });
+    // 删除原 public 目录
+    rmSync(publicDir, { recursive: true, force: true });
+}
+
+// 2. 创建新的 public 目录
+mkdirSync(publicDir, { recursive: true });
+
+// 3. 将 public_temp 移动到 public/doc
+if (existsSync(tempDir))
+{
+    // 复制 public_temp 到 public/doc
+    cpSync(tempDir, docDir, { recursive: true });
+    // 删除 public_temp
+    rmSync(tempDir, { recursive: true, force: true });
+}
+
+console.log('文档已移动到 public/doc 目录');
+

package/templates/scripts/postpublish.js

@@ -0,0 +1,19 @@
+import * as fs from 'fs';
+import * as path from 'path';
+
+const pkgpath = path.resolve('package.json');
+
+let pkg = fs.readFileSync(pkgpath, 'utf8');
+
+pkg = pkg
+    .replace(`"types": "./lib/index.d.ts"`, `"types": "./src/index.ts"`)
+    //
+    .replace(`"module": "./dist/index.js"`, `"module": "./src/index.ts"`)
+    .replace(`"main": "./dist/index.umd.cjs"`, `"main": "./src/index.ts"`)
+    //
+    .replace(`"import": "./dist/index.js"`, `"import": "./src/index.ts"`)
+    .replace(`"require": "./dist/index.umd.cjs"`, `"require": "./src/index.ts"`)
+;
+
+fs.writeFileSync(pkgpath, pkg, 'utf8');
+

package/templates/scripts/prepublish.js

@@ -0,0 +1,19 @@
+import * as fs from 'fs';
+import * as path from 'path';
+
+const pkgpath = path.resolve('package.json');
+
+let pkg = fs.readFileSync(pkgpath, 'utf8');
+
+pkg = pkg
+    .replace(`"types": "./src/index.ts"`, `"types": "./lib/index.d.ts"`)
+    //
+    .replace(`"module": "./src/index.ts"`, `"module": "./dist/index.js"`)
+    .replace(`"main": "./src/index.ts"`, `"main": "./dist/index.umd.cjs"`)
+    //
+    .replace(`"import": "./src/index.ts"`, `"import": "./dist/index.js"`)
+    .replace(`"require": "./src/index.ts"`, `"require": "./dist/index.umd.cjs"`)
+;
+
+fs.writeFileSync(pkgpath, pkg, 'utf8');
+

package/templates/src/index.ts

@@ -0,0 +1,6 @@
+/**
+ * {{name}}
+ */
+
+export { };
+