@icebreakers/monorepo 2.1.5 → 2.2.0

package/assets/package.json

@@ -3,7 +3,7 @@
   "type": "module",
   "version": "0.0.0",
   "private": true,
-  "packageManager": "pnpm@10.21.0",
+  "packageManager": "pnpm@10.22.0",
   "author": "ice breaker <1324318532@qq.com>",
   "repository": {
     "type": "git",
@@ -48,7 +48,7 @@
     "@icebreakers/monorepo": "workspace:*",
     "@icebreakers/stylelint-config": "^1.2.3",
     "@types/fs-extra": "^11.0.4",
-    "@types/node": "^24.10.0",
+    "@types/node": "^24.10.1",
     "@types/semver": "^7.7.1",
     "@vitest/coverage-v8": "~4.0.8",
     "ci-info": "^4.3.1",
@@ -65,11 +65,11 @@
     "pkg-types": "^2.3.0",
     "rimraf": "^6.1.0",
     "stylelint": "^16.25.0",
-    "tsdown": "^0.16.1",
+    "tsdown": "^0.16.4",
     "tslib": "^2.8.1",
-    "tsup": "^8.5.0",
+    "tsup": "^8.5.1",
     "tsx": "^4.20.6",
-    "turbo": "^2.6.0",
+    "turbo": "^2.6.1",
     "type-fest": "^5.2.0",
     "typescript": "^5.9.3",
     "unbuild": "^3.6.1",

package/assets/vitest.config.ts

@@ -2,20 +2,74 @@ import fs from 'node:fs'
 import path from 'node:path'
 import { fileURLToPath } from 'node:url'
 import { defineConfig } from 'vitest/config'
+import YAML from 'yaml'
 
 const ROOT_DIR = path.dirname(fileURLToPath(new URL(import.meta.url)))
-const PROJECT_ROOTS = [
-  'packages',
-  'apps',
-]
-const CONFIG_CANDIDATES = [
+const WORKSPACE_FILE = path.resolve(ROOT_DIR, 'pnpm-workspace.yaml')
+const CONFIG_FILENAMES = [
   'vitest.config.ts',
   'vitest.config.mts',
+  'vitest.config.cts',
   'vitest.config.js',
   'vitest.config.cjs',
-  'vitest.workspace.ts',
-  'vitest.workspace.mts',
-]
+  'vitest.config.mjs',
+] as const
+
+function extractBaseDirFromGlob(pattern: string): string | null {
+  if (!pattern) {
+    return null
+  }
+
+  const normalized = pattern
+    .replace(/\\/g, '/')
+    .replace(/^\.\//, '')
+  const globIndex = normalized.search(/[*?[{]/)
+  const base = globIndex === -1
+    ? normalized
+    : normalized.slice(0, globIndex)
+
+  const cleaned = base.replace(/\/+$/, '')
+  return cleaned || null
+}
+
+function loadProjectRootsFromWorkspace(): string[] {
+  if (!fs.existsSync(WORKSPACE_FILE)) {
+    return []
+  }
+
+  try {
+    const workspaceContent = fs.readFileSync(WORKSPACE_FILE, 'utf8')
+    const workspace = YAML.parse(workspaceContent) ?? {}
+    const packages: unknown[] = Array.isArray(workspace.packages) ? workspace.packages : []
+    const roots = packages
+      .map(entry => typeof entry === 'string' ? entry.trim() : '')
+      .filter(entry => entry && !entry.startsWith('!'))
+      .map(extractBaseDirFromGlob)
+      .filter((entry): entry is string => Boolean(entry))
+
+    return roots.length ? Array.from(new Set(roots)) : []
+  }
+  catch (error) {
+    console.warn('[vitest] Failed to parse pnpm-workspace.yaml, no project roots will be used.', error)
+    return []
+  }
+}
+
+const PROJECT_ROOTS = loadProjectRootsFromWorkspace()
+
+if (!PROJECT_ROOTS.length) {
+  console.warn('[vitest] No project roots detected. Check pnpm-workspace.yaml to define workspace packages.')
+}
+
+function findConfig(basePath: string): string | null {
+  for (const filename of CONFIG_FILENAMES) {
+    const candidate = path.join(basePath, filename)
+    if (fs.existsSync(candidate)) {
+      return candidate
+    }
+  }
+  return null
+}
 
 function resolveProjects(): string[] {
   const projects: string[] = []
@@ -26,6 +80,11 @@ function resolveProjects(): string[] {
       continue
     }
 
+    const rootConfig = findConfig(rootPath)
+    if (rootConfig) {
+      projects.push(path.relative(ROOT_DIR, rootConfig))
+    }
+
     const entries = fs.readdirSync(rootPath, { withFileTypes: true })
     for (const entry of entries) {
       if (!entry.isDirectory()) {
@@ -33,10 +92,7 @@ function resolveProjects(): string[] {
       }
 
       const projectDir = path.join(rootPath, entry.name)
-      const configPath = CONFIG_CANDIDATES
-        .map(candidate => path.join(projectDir, candidate))
-        .find(fs.existsSync)
-
+      const configPath = findConfig(projectDir)
       if (configPath) {
         projects.push(path.relative(ROOT_DIR, configPath))
       }

package/dist/{chunk-X2BQKWYW.js → chunk-Y4HUH2J5.js}

@@ -27,11 +27,11 @@ var __toESM = (mod, isNodeMode, target) => (target = mod != null ? __create(__ge
   mod
 ));
 
-// ../../node_modules/.pnpm/tsup@8.5.0_@microsoft+api-extractor@7.52.12_@types+node@24.10.0__jiti@2.6.1_postcss@8.5_a8334cf75448b07907f6e1bdf13650dc/node_modules/tsup/assets/esm_shims.js
+// ../../node_modules/.pnpm/tsup@8.5.1_@microsoft+api-extractor@7.52.12_@types+node@24.10.1__jiti@2.6.1_postcss@8.5_f48fe4e18fc17d0faecb4c10461dc770/node_modules/tsup/assets/esm_shims.js
 import path from "path";
 import { fileURLToPath } from "url";
 var init_esm_shims = __esm({
-  "../../node_modules/.pnpm/tsup@8.5.0_@microsoft+api-extractor@7.52.12_@types+node@24.10.0__jiti@2.6.1_postcss@8.5_a8334cf75448b07907f6e1bdf13650dc/node_modules/tsup/assets/esm_shims.js"() {
+  "../../node_modules/.pnpm/tsup@8.5.1_@microsoft+api-extractor@7.52.12_@types+node@24.10.1__jiti@2.6.1_postcss@8.5_f48fe4e18fc17d0faecb4c10461dc770/node_modules/tsup/assets/esm_shims.js"() {
     "use strict";
   }
 });
@@ -589,7 +589,7 @@ async function cleanProjects(cwd) {
 
 // package.json
 var name = "@icebreakers/monorepo";
-var version = "2.1.5";
+var version = "2.2.0";
 
 // src/constants.ts
 init_esm_shims();

package/dist/cli.cjs

@@ -28,12 +28,12 @@ var __toESM = (mod, isNodeMode, target) => (target = mod != null ? __create(__ge
   mod
 ));
 
-// ../../node_modules/.pnpm/tsup@8.5.0_@microsoft+api-extractor@7.52.12_@types+node@24.10.0__jiti@2.6.1_postcss@8.5_a8334cf75448b07907f6e1bdf13650dc/node_modules/tsup/assets/cjs_shims.js
+// ../../node_modules/.pnpm/tsup@8.5.1_@microsoft+api-extractor@7.52.12_@types+node@24.10.1__jiti@2.6.1_postcss@8.5_f48fe4e18fc17d0faecb4c10461dc770/node_modules/tsup/assets/cjs_shims.js
 var getImportMetaUrl, importMetaUrl;
 var init_cjs_shims = __esm({
-  "../../node_modules/.pnpm/tsup@8.5.0_@microsoft+api-extractor@7.52.12_@types+node@24.10.0__jiti@2.6.1_postcss@8.5_a8334cf75448b07907f6e1bdf13650dc/node_modules/tsup/assets/cjs_shims.js"() {
+  "../../node_modules/.pnpm/tsup@8.5.1_@microsoft+api-extractor@7.52.12_@types+node@24.10.1__jiti@2.6.1_postcss@8.5_f48fe4e18fc17d0faecb4c10461dc770/node_modules/tsup/assets/cjs_shims.js"() {
     "use strict";
-    getImportMetaUrl = () => typeof document === "undefined" ? new URL(`file:${__filename}`).href : document.currentScript && document.currentScript.src || new URL("main.js", document.baseURI).href;
+    getImportMetaUrl = () => typeof document === "undefined" ? new URL(`file:${__filename}`).href : document.currentScript && document.currentScript.tagName.toUpperCase() === "SCRIPT" ? document.currentScript.src : new URL("main.js", document.baseURI).href;
     importMetaUrl = /* @__PURE__ */ getImportMetaUrl();
   }
 });
@@ -616,7 +616,7 @@ var import_node_url = require("url");
 
 // package.json
 var name = "@icebreakers/monorepo";
-var version = "2.1.5";
+var version = "2.2.0";
 
 // src/constants.ts
 var packageJsonPath = (0, import_node_url.fileURLToPath)(new URL("../package.json", importMetaUrl));

package/dist/cli.js

@@ -12,7 +12,7 @@ import {
   syncNpmMirror,
   upgradeMonorepo,
   version
-} from "./chunk-X2BQKWYW.js";
+} from "./chunk-Y4HUH2J5.js";
 
 // src/cli.ts
 init_esm_shims();

package/dist/index.cjs

@@ -33,12 +33,12 @@ var __toESM = (mod, isNodeMode, target) => (target = mod != null ? __create(__ge
 ));
 var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
 
-// ../../node_modules/.pnpm/tsup@8.5.0_@microsoft+api-extractor@7.52.12_@types+node@24.10.0__jiti@2.6.1_postcss@8.5_a8334cf75448b07907f6e1bdf13650dc/node_modules/tsup/assets/cjs_shims.js
+// ../../node_modules/.pnpm/tsup@8.5.1_@microsoft+api-extractor@7.52.12_@types+node@24.10.1__jiti@2.6.1_postcss@8.5_f48fe4e18fc17d0faecb4c10461dc770/node_modules/tsup/assets/cjs_shims.js
 var getImportMetaUrl, importMetaUrl;
 var init_cjs_shims = __esm({
-  "../../node_modules/.pnpm/tsup@8.5.0_@microsoft+api-extractor@7.52.12_@types+node@24.10.0__jiti@2.6.1_postcss@8.5_a8334cf75448b07907f6e1bdf13650dc/node_modules/tsup/assets/cjs_shims.js"() {
+  "../../node_modules/.pnpm/tsup@8.5.1_@microsoft+api-extractor@7.52.12_@types+node@24.10.1__jiti@2.6.1_postcss@8.5_f48fe4e18fc17d0faecb4c10461dc770/node_modules/tsup/assets/cjs_shims.js"() {
     "use strict";
-    getImportMetaUrl = () => typeof document === "undefined" ? new URL(`file:${__filename}`).href : document.currentScript && document.currentScript.src || new URL("main.js", document.baseURI).href;
+    getImportMetaUrl = () => typeof document === "undefined" ? new URL(`file:${__filename}`).href : document.currentScript && document.currentScript.tagName.toUpperCase() === "SCRIPT" ? document.currentScript.src : new URL("main.js", document.baseURI).href;
     importMetaUrl = /* @__PURE__ */ getImportMetaUrl();
   }
 });
@@ -652,7 +652,7 @@ var import_node_url = require("url");
 
 // package.json
 var name = "@icebreakers/monorepo";
-var version = "2.1.5";
+var version = "2.2.0";
 
 // src/constants.ts
 var packageJsonPath = (0, import_node_url.fileURLToPath)(new URL("../package.json", importMetaUrl));

package/dist/index.d.cts

@@ -1,137 +1,285 @@
-import * as _pnpm_types from '@pnpm/types';
+export { PackageJson } from 'pkg-types';
 import * as simple_git from 'simple-git';
 import { SimpleGitOptions, ConfigValues } from 'simple-git';
 export { ConfigValues, SimpleGit, SimpleGitOptions } from 'simple-git';
 import * as gitUrlParse from 'git-url-parse';
 import gitUrlParse__default from 'git-url-parse';
+import * as _pnpm_types from '@pnpm/types';
 import * as consola from 'consola';
 import crypto from 'node:crypto';
-export { PackageJson } from 'pkg-types';
 
 /**
- * 工作区包列表的查询选项，允许控制根包、私有包与匹配模式。
+ * CLI 公用参数，保证各命令对外暴露一致的行为。
  */
-interface GetWorkspacePackagesOptions {
-    ignoreRootPackage?: boolean;
-    ignorePrivatePackage?: boolean;
-    patterns?: string[];
+interface CliOpts {
+    /**
+     * 是否开启交互模式，开启后每一步都会提示用户确认。
+     * @default false
+     */
+    interactive?: boolean;
+    /**
+     * 是否使用 core 版资产，只同步最精简的文件集合。
+     * @default false
+     */
+    core?: boolean;
+    /**
+     * 输出目录（相对 `cwd`），用于放置生成或拷贝出来的文件。
+     * @default ''
+     */
+    outDir?: string;
+    /**
+     * 命令执行的工作目录。
+     * @default process.cwd()
+     */
+    cwd?: string;
+    /**
+     * 是否跳过已有文件的覆写；开启后保留旧文件不做对比。
+     * @default false
+     */
+    skipOverwrite?: boolean;
 }
+
 /**
- * 读取 pnpm workspace 下的所有包，并根据配置过滤与补充字段。
+ * 内置模板映射表，value 指向仓库中对应模板所在路径。
  */
-declare function getWorkspacePackages(workspaceDir: string, options?: GetWorkspacePackagesOptions): Promise<{
-    pkgJsonPath: string;
-    rootDir: _pnpm_types.ProjectRootDir;
-    rootDirRealPath: _pnpm_types.ProjectRootDirRealPath;
-    modulesDir?: string;
-    manifest: _pnpm_types.ProjectManifest;
-    writeProjectManifest: (manifest: _pnpm_types.ProjectManifest, force?: boolean | undefined) => Promise<void>;
-}[]>;
+declare const templateMap: {
+    readonly tsup: "packages/tsup-template";
+    readonly tsdown: "packages/tsdown-template";
+    readonly unbuild: "packages/unbuild-template";
+    readonly 'vue-lib': "packages/vue-lib-template";
+    readonly 'hono-server': "apps/server";
+    readonly 'vue-hono': "apps/client";
+    readonly vitepress: "apps/website";
+    readonly cli: "apps/cli";
+};
+type CreateNewProjectType = keyof typeof templateMap;
+interface CreateNewProjectOptions {
+    name?: string;
+    cwd?: string;
+    renameJson?: boolean;
+    type?: CreateNewProjectType | string;
+}
 /**
- * 将工作区绝对路径、包列表与当前 cwd 打包返回，方便调用方一次获取所有信息。
+ * 若配置中提供 choices 则优先使用，否则退回默认预设。
  */
-declare function getWorkspaceData(cwd: string, options?: GetWorkspacePackagesOptions): Promise<{
-    cwd: string;
-    workspaceDir: string;
-    packages: {
-        pkgJsonPath: string;
-        rootDir: _pnpm_types.ProjectRootDir;
-        rootDirRealPath: _pnpm_types.ProjectRootDirRealPath;
-        modulesDir?: string;
-        manifest: _pnpm_types.ProjectManifest;
-        writeProjectManifest: (manifest: _pnpm_types.ProjectManifest, force?: boolean | undefined) => Promise<void>;
-    }[];
-}>;
+declare function getCreateChoices(choices?: CreateChoiceOption[]): CreateChoiceOption[] | ({
+    readonly name: "unbuild 打包";
+    readonly value: "unbuild";
+} | {
+    readonly name: "tsup 打包";
+    readonly value: "tsup";
+} | {
+    readonly name: "tsdown 打包";
+    readonly value: "tsdown";
+} | {
+    readonly name: "vue 组件";
+    readonly value: "vue-lib";
+} | {
+    readonly name: "vue hono 全栈";
+    readonly value: "vue-hono";
+} | {
+    readonly name: "hono 模板";
+    readonly value: "hono-server";
+} | {
+    readonly name: "vitepress 文档";
+    readonly value: "vitepress";
+} | {
+    readonly name: "cli 模板";
+    readonly value: "cli";
+})[];
+/**
+ * 合并内置与自定义模板映射，允许扩展新的模板类型。
+ */
+declare function getTemplateMap(extra?: Record<string, string>): Record<string, string>;
+/**
+ * 根据提供的参数或配置生成新工程目录，并可自动改写 package.json。
+ */
+declare function createNewProject(options?: CreateNewProjectOptions): Promise<void>;
 
 /**
- * CLI 命令通用参数，便于在各个子命令之间复用。
+ * 工作区工具可接收的筛选选项。
  */
-interface CliOpts {
-    interactive?: boolean;
-    core?: boolean;
-    outDir?: string;
-    cwd?: string;
-    skipOverwrite?: boolean;
+interface GetWorkspacePackagesOptions {
+    /**
+     * 是否在结果中排除 workspace 根包。
+     * @default true
+     */
+    ignoreRootPackage?: boolean;
+    /**
+     * 是否过滤掉标记为 `private` 的包。
+     * @default true
+     */
+    ignorePrivatePackage?: boolean;
+    /**
+     * 自定义 glob，覆盖 `pnpm-workspace.yaml` 的 `packages` 配置。
+     * @default workspace manifest `packages`
+     */
+    patterns?: string[];
 }
 
 /**
  * `monorepo new` 命令的配置项，允许外部覆写模板目录、模板清单等。
  */
 interface CreateCommandConfig extends Partial<Omit<CreateNewProjectOptions, 'cwd'>> {
-    /** 自定义模板根目录（默认为包内置模板） */
+    /**
+     * 自定义模板根目录。
+     * @default 内置模板所在的 `packages/monorepo/templates`
+     */
     templatesDir?: string;
-    /** 扩展模板映射表，key 为类型，value 为模板相对路径 */
+    /**
+     * 扩展模板映射表，key 为类型，value 为模板相对路径。
+     * @default 内置 `templateMap`
+     */
     templateMap?: Record<string, string>;
-    /** 自定义交互提示的选项列表 */
+    /**
+     * 自定义交互提示的选项列表。
+     * @default 内置 `baseChoices`
+     */
     choices?: CreateChoiceOption[];
-    /** 当未选择模板时使用的默认模板 */
+    /**
+     * 当未选择模板时使用的默认模板。
+     * @default 'unbuild'
+     */
     defaultTemplate?: CreateNewProjectOptions['type'];
 }
 /**
  * CLI 交互式选择框的选项结构。
  */
 interface CreateChoiceOption {
+    /**
+     * 唯一值，将回传给命令逻辑使用。
+     * @default undefined
+     */
     value: string;
+    /**
+     * 选项展示名称。
+     * @default value
+     */
     name?: string;
+    /**
+     * 选项描述信息。
+     * @default undefined
+     */
     description?: string;
+    /**
+     * 短名称，用于命令行紧凑展示。
+     * @default undefined
+     */
     short?: string;
+    /**
+     * 设置为 true 或字符串即可禁用该选项并显示原因。
+     * @default false
+     */
     disabled?: boolean | string;
 }
 /**
  * `monorepo clean` 命令配置，可控制自动选择、排除包等行为。
  */
 interface CleanCommandConfig {
-    /** 是否跳过交互直接清理全部 */
+    /**
+     * 是否跳过交互直接清理全部。
+     * @default false
+     */
     autoConfirm?: boolean;
-    /** 不允许被清理的包名列表 */
+    /**
+     * 不允许被清理的包名列表。
+     * @default []
+     */
     ignorePackages?: string[];
-    /** 是否包含 private 包 */
+    /**
+     * 是否包含 private 包。
+     * @default false
+     */
     includePrivate?: boolean;
-    /** 强制写回的 @icebreakers/monorepo 版本 */
+    /**
+     * 强制写回的 @icebreakers/monorepo 版本。
+     * @default 当前依赖版本
+     */
     pinnedVersion?: string;
 }
 /**
  * `monorepo sync` 命令配置，可覆盖 workspace 过滤规则或同步命令模板。
  */
 interface SyncCommandConfig extends Partial<GetWorkspacePackagesOptions> {
-    /** 并发执行同步命令的最大数量 */
+    /**
+     * 并发执行同步命令的最大数量。
+     * @default os.cpus().length
+     */
     concurrency?: number;
-    /** 自定义执行的同步命令模板，使用 {name} 占位 */
+    /**
+     * 自定义执行的同步命令模板，使用 {name} 占位。
+     * @default 'cnpm sync {name}'
+     */
     command?: string;
-    /** 仅同步指定的包（按名称过滤） */
+    /**
+     * 仅同步指定的包（按名称过滤）。
+     * @default 同步全部可见包
+     */
     packages?: string[];
 }
 /**
  * `monorepo upgrade` 命令配置，覆盖脚本、目标文件等能力。
  */
 interface UpgradeCommandConfig extends Partial<CliOpts> {
-    /** 额外需要写入的目标文件列表 */
+    /**
+     * 额外需要写入的目标文件列表。
+     * @default []
+     */
     targets?: string[];
-    /** 是否与默认目标合并，false 表示完全覆盖 */
+    /**
+     * 是否与默认目标合并，false 表示完全覆盖。
+     * @default true
+     */
     mergeTargets?: boolean;
-    /** 需要写入 package.json 的脚本集合 */
+    /**
+     * 需要写入 package.json 的脚本集合。
+     * @default {}
+     */
     scripts?: Record<string, string>;
-    /** 是否跳过生成 changeset markdown */
+    /**
+     * 是否跳过生成 changeset markdown。
+     * @default true
+     */
     skipChangesetMarkdown?: boolean;
 }
 /**
  * `monorepo init` 命令配置，用于跳过部分初始化步骤。
  */
 interface InitCommandConfig {
+    /**
+     * 是否跳过 README 生成。
+     * @default false
+     */
     skipReadme?: boolean;
+    /**
+     * 是否跳过 package.json 写入。
+     * @default false
+     */
     skipPkgJson?: boolean;
+    /**
+     * 是否跳过 changeset 的更新。
+     * @default false
+     */
     skipChangeset?: boolean;
 }
 /**
  * `monorepo mirror` 命令配置，可增加额外的环境变量镜像。
  */
 interface MirrorCommandConfig {
+    /**
+     * 需要注入的环境变量键值对。
+     * @default {}
+     */
     env?: Record<string, string>;
 }
 /**
  * 项目级配置入口，按命令划分可插拔的配置块。
  */
 interface MonorepoConfig {
+    /**
+     * 按命令分类的可选配置。
+     * @default {}
+     */
     commands?: {
         create?: CreateCommandConfig;
         clean?: CleanCommandConfig;
@@ -141,75 +289,6 @@ interface MonorepoConfig {
         mirror?: MirrorCommandConfig;
     };
 }
-/**
- * 提供类型提示的辅助函数，供外部定义配置时使用。
- */
-declare function defineMonorepoConfig(config: MonorepoConfig): MonorepoConfig;
-/**
- * 加载指定目录的 monorepo 配置，并利用缓存提升性能。
- */
-declare function loadMonorepoConfig(cwd: string): Promise<MonorepoConfig>;
-/**
- * 获取命令对应的合并配置，若未配置则返回空对象，保证调用端逻辑简单。
- */
-declare function resolveCommandConfig<Name extends keyof NonNullable<MonorepoConfig['commands']>>(name: Name, cwd: string): Promise<NonNullable<MonorepoConfig['commands']>[Name]>;
-
-/**
- * 内置模板映射表，value 指向仓库中对应模板所在路径。
- */
-declare const templateMap: {
-    readonly tsup: "packages/tsup-template";
-    readonly tsdown: "packages/tsdown-template";
-    readonly unbuild: "packages/unbuild-template";
-    readonly 'vue-lib': "packages/vue-lib-template";
-    readonly 'hono-server': "apps/server";
-    readonly 'vue-hono': "apps/client";
-    readonly vitepress: "apps/website";
-    readonly cli: "apps/cli";
-};
-type CreateNewProjectType = keyof typeof templateMap;
-interface CreateNewProjectOptions {
-    name?: string;
-    cwd?: string;
-    renameJson?: boolean;
-    type?: CreateNewProjectType | string;
-}
-/**
- * 若配置中提供 choices 则优先使用，否则退回默认预设。
- */
-declare function getCreateChoices(choices?: CreateChoiceOption[]): CreateChoiceOption[] | ({
-    readonly name: "unbuild 打包";
-    readonly value: "unbuild";
-} | {
-    readonly name: "tsup 打包";
-    readonly value: "tsup";
-} | {
-    readonly name: "tsdown 打包";
-    readonly value: "tsdown";
-} | {
-    readonly name: "vue 组件";
-    readonly value: "vue-lib";
-} | {
-    readonly name: "vue hono 全栈";
-    readonly value: "vue-hono";
-} | {
-    readonly name: "hono 模板";
-    readonly value: "hono-server";
-} | {
-    readonly name: "vitepress 文档";
-    readonly value: "vitepress";
-} | {
-    readonly name: "cli 模板";
-    readonly value: "cli";
-})[];
-/**
- * 合并内置与自定义模板映射，允许扩展新的模板类型。
- */
-declare function getTemplateMap(extra?: Record<string, string>): Record<string, string>;
-/**
- * 根据提供的参数或配置生成新工程目录，并可自动改写 package.json。
- */
-declare function createNewProject(options?: CreateNewProjectOptions): Promise<void>;
 
 /**
  * 对 simple-git 的轻量封装，集中处理配置缓存与常用查询。
@@ -251,6 +330,33 @@ declare class GitClient {
     getRepoRoot(): Promise<string | undefined>;
 }
 
+/**
+ * 读取 pnpm workspace 下的所有包，并根据配置过滤与补充字段。
+ */
+declare function getWorkspacePackages(workspaceDir: string, options?: GetWorkspacePackagesOptions): Promise<{
+    pkgJsonPath: string;
+    rootDir: _pnpm_types.ProjectRootDir;
+    rootDirRealPath: _pnpm_types.ProjectRootDirRealPath;
+    modulesDir?: string;
+    manifest: _pnpm_types.ProjectManifest;
+    writeProjectManifest: (manifest: _pnpm_types.ProjectManifest, force?: boolean | undefined) => Promise<void>;
+}[]>;
+/**
+ * 将工作区绝对路径、包列表与当前 cwd 打包返回，方便调用方一次获取所有信息。
+ */
+declare function getWorkspaceData(cwd: string, options?: GetWorkspacePackagesOptions): Promise<{
+    cwd: string;
+    workspaceDir: string;
+    packages: {
+        pkgJsonPath: string;
+        rootDir: _pnpm_types.ProjectRootDir;
+        rootDirRealPath: _pnpm_types.ProjectRootDirRealPath;
+        modulesDir?: string;
+        manifest: _pnpm_types.ProjectManifest;
+        writeProjectManifest: (manifest: _pnpm_types.ProjectManifest, force?: boolean | undefined) => Promise<void>;
+    }[];
+}>;
+
 /**
  * 交互式清理被选中的包目录，同时重写根 package.json 中的 @icebreakers/monorepo 版本。
  */
@@ -277,7 +383,7 @@ declare function syncNpmMirror(cwd: string, options?: GetWorkspacePackagesOption
 declare function upgradeMonorepo(opts: CliOpts): Promise<void>;
 
 var name = "@icebreakers/monorepo";
-var version = "2.1.5";
+var version = "2.2.0";
 
 /**
  * @icebreakers/monorepo 包的根目录，所有模板与资产目录都以此为基准。
@@ -296,6 +402,19 @@ declare const assetsDir: string;
  */
 declare const rootDir: string;
 
+/**
+ * 提供类型提示的辅助函数，供外部定义配置时使用。
+ */
+declare function defineMonorepoConfig(config: MonorepoConfig): MonorepoConfig;
+/**
+ * 加载指定目录的 monorepo 配置，并利用缓存提升性能。
+ */
+declare function loadMonorepoConfig(cwd: string): Promise<MonorepoConfig>;
+/**
+ * 获取命令对应的合并配置，若未配置则返回空对象，保证调用端逻辑简单。
+ */
+declare function resolveCommandConfig<Name extends keyof NonNullable<MonorepoConfig['commands']>>(name: Name, cwd: string): Promise<NonNullable<MonorepoConfig['commands']>[Name]>;
+
 /**
  * 构建命令执行上下文，封装常用的工作区、Git、配置等信息。
  */

package/dist/index.d.ts

@@ -1,137 +1,285 @@
-import * as _pnpm_types from '@pnpm/types';
+export { PackageJson } from 'pkg-types';
 import * as simple_git from 'simple-git';
 import { SimpleGitOptions, ConfigValues } from 'simple-git';
 export { ConfigValues, SimpleGit, SimpleGitOptions } from 'simple-git';
 import * as gitUrlParse from 'git-url-parse';
 import gitUrlParse__default from 'git-url-parse';
+import * as _pnpm_types from '@pnpm/types';
 import * as consola from 'consola';
 import crypto from 'node:crypto';
-export { PackageJson } from 'pkg-types';
 
 /**
- * 工作区包列表的查询选项，允许控制根包、私有包与匹配模式。
+ * CLI 公用参数，保证各命令对外暴露一致的行为。
  */
-interface GetWorkspacePackagesOptions {
-    ignoreRootPackage?: boolean;
-    ignorePrivatePackage?: boolean;
-    patterns?: string[];
+interface CliOpts {
+    /**
+     * 是否开启交互模式，开启后每一步都会提示用户确认。
+     * @default false
+     */
+    interactive?: boolean;
+    /**
+     * 是否使用 core 版资产，只同步最精简的文件集合。
+     * @default false
+     */
+    core?: boolean;
+    /**
+     * 输出目录（相对 `cwd`），用于放置生成或拷贝出来的文件。
+     * @default ''
+     */
+    outDir?: string;
+    /**
+     * 命令执行的工作目录。
+     * @default process.cwd()
+     */
+    cwd?: string;
+    /**
+     * 是否跳过已有文件的覆写；开启后保留旧文件不做对比。
+     * @default false
+     */
+    skipOverwrite?: boolean;
 }
+
 /**
- * 读取 pnpm workspace 下的所有包，并根据配置过滤与补充字段。
+ * 内置模板映射表，value 指向仓库中对应模板所在路径。
  */
-declare function getWorkspacePackages(workspaceDir: string, options?: GetWorkspacePackagesOptions): Promise<{
-    pkgJsonPath: string;
-    rootDir: _pnpm_types.ProjectRootDir;
-    rootDirRealPath: _pnpm_types.ProjectRootDirRealPath;
-    modulesDir?: string;
-    manifest: _pnpm_types.ProjectManifest;
-    writeProjectManifest: (manifest: _pnpm_types.ProjectManifest, force?: boolean | undefined) => Promise<void>;
-}[]>;
+declare const templateMap: {
+    readonly tsup: "packages/tsup-template";
+    readonly tsdown: "packages/tsdown-template";
+    readonly unbuild: "packages/unbuild-template";
+    readonly 'vue-lib': "packages/vue-lib-template";
+    readonly 'hono-server': "apps/server";
+    readonly 'vue-hono': "apps/client";
+    readonly vitepress: "apps/website";
+    readonly cli: "apps/cli";
+};
+type CreateNewProjectType = keyof typeof templateMap;
+interface CreateNewProjectOptions {
+    name?: string;
+    cwd?: string;
+    renameJson?: boolean;
+    type?: CreateNewProjectType | string;
+}
 /**
- * 将工作区绝对路径、包列表与当前 cwd 打包返回，方便调用方一次获取所有信息。
+ * 若配置中提供 choices 则优先使用，否则退回默认预设。
  */
-declare function getWorkspaceData(cwd: string, options?: GetWorkspacePackagesOptions): Promise<{
-    cwd: string;
-    workspaceDir: string;
-    packages: {
-        pkgJsonPath: string;
-        rootDir: _pnpm_types.ProjectRootDir;
-        rootDirRealPath: _pnpm_types.ProjectRootDirRealPath;
-        modulesDir?: string;
-        manifest: _pnpm_types.ProjectManifest;
-        writeProjectManifest: (manifest: _pnpm_types.ProjectManifest, force?: boolean | undefined) => Promise<void>;
-    }[];
-}>;
+declare function getCreateChoices(choices?: CreateChoiceOption[]): CreateChoiceOption[] | ({
+    readonly name: "unbuild 打包";
+    readonly value: "unbuild";
+} | {
+    readonly name: "tsup 打包";
+    readonly value: "tsup";
+} | {
+    readonly name: "tsdown 打包";
+    readonly value: "tsdown";
+} | {
+    readonly name: "vue 组件";
+    readonly value: "vue-lib";
+} | {
+    readonly name: "vue hono 全栈";
+    readonly value: "vue-hono";
+} | {
+    readonly name: "hono 模板";
+    readonly value: "hono-server";
+} | {
+    readonly name: "vitepress 文档";
+    readonly value: "vitepress";
+} | {
+    readonly name: "cli 模板";
+    readonly value: "cli";
+})[];
+/**
+ * 合并内置与自定义模板映射，允许扩展新的模板类型。
+ */
+declare function getTemplateMap(extra?: Record<string, string>): Record<string, string>;
+/**
+ * 根据提供的参数或配置生成新工程目录，并可自动改写 package.json。
+ */
+declare function createNewProject(options?: CreateNewProjectOptions): Promise<void>;
 
 /**
- * CLI 命令通用参数，便于在各个子命令之间复用。
+ * 工作区工具可接收的筛选选项。
  */
-interface CliOpts {
-    interactive?: boolean;
-    core?: boolean;
-    outDir?: string;
-    cwd?: string;
-    skipOverwrite?: boolean;
+interface GetWorkspacePackagesOptions {
+    /**
+     * 是否在结果中排除 workspace 根包。
+     * @default true
+     */
+    ignoreRootPackage?: boolean;
+    /**
+     * 是否过滤掉标记为 `private` 的包。
+     * @default true
+     */
+    ignorePrivatePackage?: boolean;
+    /**
+     * 自定义 glob，覆盖 `pnpm-workspace.yaml` 的 `packages` 配置。
+     * @default workspace manifest `packages`
+     */
+    patterns?: string[];
 }
 
 /**
  * `monorepo new` 命令的配置项，允许外部覆写模板目录、模板清单等。
  */
 interface CreateCommandConfig extends Partial<Omit<CreateNewProjectOptions, 'cwd'>> {
-    /** 自定义模板根目录（默认为包内置模板） */
+    /**
+     * 自定义模板根目录。
+     * @default 内置模板所在的 `packages/monorepo/templates`
+     */
     templatesDir?: string;
-    /** 扩展模板映射表，key 为类型，value 为模板相对路径 */
+    /**
+     * 扩展模板映射表，key 为类型，value 为模板相对路径。
+     * @default 内置 `templateMap`
+     */
     templateMap?: Record<string, string>;
-    /** 自定义交互提示的选项列表 */
+    /**
+     * 自定义交互提示的选项列表。
+     * @default 内置 `baseChoices`
+     */
     choices?: CreateChoiceOption[];
-    /** 当未选择模板时使用的默认模板 */
+    /**
+     * 当未选择模板时使用的默认模板。
+     * @default 'unbuild'
+     */
     defaultTemplate?: CreateNewProjectOptions['type'];
 }
 /**
  * CLI 交互式选择框的选项结构。
  */
 interface CreateChoiceOption {
+    /**
+     * 唯一值，将回传给命令逻辑使用。
+     * @default undefined
+     */
     value: string;
+    /**
+     * 选项展示名称。
+     * @default value
+     */
     name?: string;
+    /**
+     * 选项描述信息。
+     * @default undefined
+     */
     description?: string;
+    /**
+     * 短名称，用于命令行紧凑展示。
+     * @default undefined
+     */
     short?: string;
+    /**
+     * 设置为 true 或字符串即可禁用该选项并显示原因。
+     * @default false
+     */
     disabled?: boolean | string;
 }
 /**
  * `monorepo clean` 命令配置，可控制自动选择、排除包等行为。
  */
 interface CleanCommandConfig {
-    /** 是否跳过交互直接清理全部 */
+    /**
+     * 是否跳过交互直接清理全部。
+     * @default false
+     */
     autoConfirm?: boolean;
-    /** 不允许被清理的包名列表 */
+    /**
+     * 不允许被清理的包名列表。
+     * @default []
+     */
     ignorePackages?: string[];
-    /** 是否包含 private 包 */
+    /**
+     * 是否包含 private 包。
+     * @default false
+     */
     includePrivate?: boolean;
-    /** 强制写回的 @icebreakers/monorepo 版本 */
+    /**
+     * 强制写回的 @icebreakers/monorepo 版本。
+     * @default 当前依赖版本
+     */
     pinnedVersion?: string;
 }
 /**
  * `monorepo sync` 命令配置，可覆盖 workspace 过滤规则或同步命令模板。
  */
 interface SyncCommandConfig extends Partial<GetWorkspacePackagesOptions> {
-    /** 并发执行同步命令的最大数量 */
+    /**
+     * 并发执行同步命令的最大数量。
+     * @default os.cpus().length
+     */
     concurrency?: number;
-    /** 自定义执行的同步命令模板，使用 {name} 占位 */
+    /**
+     * 自定义执行的同步命令模板，使用 {name} 占位。
+     * @default 'cnpm sync {name}'
+     */
     command?: string;
-    /** 仅同步指定的包（按名称过滤） */
+    /**
+     * 仅同步指定的包（按名称过滤）。
+     * @default 同步全部可见包
+     */
     packages?: string[];
 }
 /**
  * `monorepo upgrade` 命令配置，覆盖脚本、目标文件等能力。
  */
 interface UpgradeCommandConfig extends Partial<CliOpts> {
-    /** 额外需要写入的目标文件列表 */
+    /**
+     * 额外需要写入的目标文件列表。
+     * @default []
+     */
     targets?: string[];
-    /** 是否与默认目标合并，false 表示完全覆盖 */
+    /**
+     * 是否与默认目标合并，false 表示完全覆盖。
+     * @default true
+     */
     mergeTargets?: boolean;
-    /** 需要写入 package.json 的脚本集合 */
+    /**
+     * 需要写入 package.json 的脚本集合。
+     * @default {}
+     */
     scripts?: Record<string, string>;
-    /** 是否跳过生成 changeset markdown */
+    /**
+     * 是否跳过生成 changeset markdown。
+     * @default true
+     */
     skipChangesetMarkdown?: boolean;
 }
 /**
  * `monorepo init` 命令配置，用于跳过部分初始化步骤。
  */
 interface InitCommandConfig {
+    /**
+     * 是否跳过 README 生成。
+     * @default false
+     */
     skipReadme?: boolean;
+    /**
+     * 是否跳过 package.json 写入。
+     * @default false
+     */
     skipPkgJson?: boolean;
+    /**
+     * 是否跳过 changeset 的更新。
+     * @default false
+     */
     skipChangeset?: boolean;
 }
 /**
  * `monorepo mirror` 命令配置，可增加额外的环境变量镜像。
  */
 interface MirrorCommandConfig {
+    /**
+     * 需要注入的环境变量键值对。
+     * @default {}
+     */
     env?: Record<string, string>;
 }
 /**
  * 项目级配置入口，按命令划分可插拔的配置块。
  */
 interface MonorepoConfig {
+    /**
+     * 按命令分类的可选配置。
+     * @default {}
+     */
     commands?: {
         create?: CreateCommandConfig;
         clean?: CleanCommandConfig;
@@ -141,75 +289,6 @@ interface MonorepoConfig {
         mirror?: MirrorCommandConfig;
     };
 }
-/**
- * 提供类型提示的辅助函数，供外部定义配置时使用。
- */
-declare function defineMonorepoConfig(config: MonorepoConfig): MonorepoConfig;
-/**
- * 加载指定目录的 monorepo 配置，并利用缓存提升性能。
- */
-declare function loadMonorepoConfig(cwd: string): Promise<MonorepoConfig>;
-/**
- * 获取命令对应的合并配置，若未配置则返回空对象，保证调用端逻辑简单。
- */
-declare function resolveCommandConfig<Name extends keyof NonNullable<MonorepoConfig['commands']>>(name: Name, cwd: string): Promise<NonNullable<MonorepoConfig['commands']>[Name]>;
-
-/**
- * 内置模板映射表，value 指向仓库中对应模板所在路径。
- */
-declare const templateMap: {
-    readonly tsup: "packages/tsup-template";
-    readonly tsdown: "packages/tsdown-template";
-    readonly unbuild: "packages/unbuild-template";
-    readonly 'vue-lib': "packages/vue-lib-template";
-    readonly 'hono-server': "apps/server";
-    readonly 'vue-hono': "apps/client";
-    readonly vitepress: "apps/website";
-    readonly cli: "apps/cli";
-};
-type CreateNewProjectType = keyof typeof templateMap;
-interface CreateNewProjectOptions {
-    name?: string;
-    cwd?: string;
-    renameJson?: boolean;
-    type?: CreateNewProjectType | string;
-}
-/**
- * 若配置中提供 choices 则优先使用，否则退回默认预设。
- */
-declare function getCreateChoices(choices?: CreateChoiceOption[]): CreateChoiceOption[] | ({
-    readonly name: "unbuild 打包";
-    readonly value: "unbuild";
-} | {
-    readonly name: "tsup 打包";
-    readonly value: "tsup";
-} | {
-    readonly name: "tsdown 打包";
-    readonly value: "tsdown";
-} | {
-    readonly name: "vue 组件";
-    readonly value: "vue-lib";
-} | {
-    readonly name: "vue hono 全栈";
-    readonly value: "vue-hono";
-} | {
-    readonly name: "hono 模板";
-    readonly value: "hono-server";
-} | {
-    readonly name: "vitepress 文档";
-    readonly value: "vitepress";
-} | {
-    readonly name: "cli 模板";
-    readonly value: "cli";
-})[];
-/**
- * 合并内置与自定义模板映射，允许扩展新的模板类型。
- */
-declare function getTemplateMap(extra?: Record<string, string>): Record<string, string>;
-/**
- * 根据提供的参数或配置生成新工程目录，并可自动改写 package.json。
- */
-declare function createNewProject(options?: CreateNewProjectOptions): Promise<void>;
 
 /**
  * 对 simple-git 的轻量封装，集中处理配置缓存与常用查询。
@@ -251,6 +330,33 @@ declare class GitClient {
     getRepoRoot(): Promise<string | undefined>;
 }
 
+/**
+ * 读取 pnpm workspace 下的所有包，并根据配置过滤与补充字段。
+ */
+declare function getWorkspacePackages(workspaceDir: string, options?: GetWorkspacePackagesOptions): Promise<{
+    pkgJsonPath: string;
+    rootDir: _pnpm_types.ProjectRootDir;
+    rootDirRealPath: _pnpm_types.ProjectRootDirRealPath;
+    modulesDir?: string;
+    manifest: _pnpm_types.ProjectManifest;
+    writeProjectManifest: (manifest: _pnpm_types.ProjectManifest, force?: boolean | undefined) => Promise<void>;
+}[]>;
+/**
+ * 将工作区绝对路径、包列表与当前 cwd 打包返回，方便调用方一次获取所有信息。
+ */
+declare function getWorkspaceData(cwd: string, options?: GetWorkspacePackagesOptions): Promise<{
+    cwd: string;
+    workspaceDir: string;
+    packages: {
+        pkgJsonPath: string;
+        rootDir: _pnpm_types.ProjectRootDir;
+        rootDirRealPath: _pnpm_types.ProjectRootDirRealPath;
+        modulesDir?: string;
+        manifest: _pnpm_types.ProjectManifest;
+        writeProjectManifest: (manifest: _pnpm_types.ProjectManifest, force?: boolean | undefined) => Promise<void>;
+    }[];
+}>;
+
 /**
  * 交互式清理被选中的包目录，同时重写根 package.json 中的 @icebreakers/monorepo 版本。
  */
@@ -277,7 +383,7 @@ declare function syncNpmMirror(cwd: string, options?: GetWorkspacePackagesOption
 declare function upgradeMonorepo(opts: CliOpts): Promise<void>;
 
 var name = "@icebreakers/monorepo";
-var version = "2.1.5";
+var version = "2.2.0";
 
 /**
  * @icebreakers/monorepo 包的根目录，所有模板与资产目录都以此为基准。
@@ -296,6 +402,19 @@ declare const assetsDir: string;
  */
 declare const rootDir: string;
 
+/**
+ * 提供类型提示的辅助函数，供外部定义配置时使用。
+ */
+declare function defineMonorepoConfig(config: MonorepoConfig): MonorepoConfig;
+/**
+ * 加载指定目录的 monorepo 配置，并利用缓存提升性能。
+ */
+declare function loadMonorepoConfig(cwd: string): Promise<MonorepoConfig>;
+/**
+ * 获取命令对应的合并配置，若未配置则返回空对象，保证调用端逻辑简单。
+ */
+declare function resolveCommandConfig<Name extends keyof NonNullable<MonorepoConfig['commands']>>(name: Name, cwd: string): Promise<NonNullable<MonorepoConfig['commands']>[Name]>;
+
 /**
  * 构建命令执行上下文，封装常用的工作区、Git、配置等信息。
  */

package/dist/index.js

@@ -31,7 +31,7 @@ import {
   toWorkspaceGitignorePath,
   upgradeMonorepo,
   version
-} from "./chunk-X2BQKWYW.js";
+} from "./chunk-Y4HUH2J5.js";
 
 // src/index.ts
 init_esm_shims();

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@icebreakers/monorepo",
   "type": "module",
-  "version": "2.1.5",
+  "version": "2.2.0",
   "description": "The icebreaker's monorepo manager",
   "author": "ice breaker <1324318532@qq.com>",
   "license": "MIT",
@@ -34,16 +34,16 @@
     "templates"
   ],
   "dependencies": {
-    "@inquirer/checkbox": "^4.3.1",
-    "@inquirer/input": "^4.3.0",
-    "@inquirer/select": "^4.4.1",
+    "@inquirer/checkbox": "^4.3.2",
+    "@inquirer/input": "^4.3.1",
+    "@inquirer/select": "^4.4.2",
     "@pnpm/find-workspace-dir": "^1000.1.3",
     "@pnpm/logger": "^1001.0.1",
     "@pnpm/types": "^1001.0.0",
-    "@pnpm/worker": "^1000.3.1",
-    "@pnpm/workspace.find-packages": "^1000.0.44",
+    "@pnpm/worker": "^1000.3.2",
+    "@pnpm/workspace.find-packages": "^1000.0.45",
     "@pnpm/workspace.read-manifest": "^1000.2.6",
-    "c12": "^3.3.1",
+    "c12": "^3.3.2",
     "commander": "^14.0.2",
     "comment-json": "^4.4.1",
     "consola": "^3.4.2",

package/templates/apps/client/package.json

@@ -15,7 +15,7 @@
   },
   "dependencies": {
     "@faker-js/faker": "^10.1.0",
-    "@tanstack/vue-query": "^5.90.7",
+    "@tanstack/vue-query": "^5.91.0",
     "@tanstack/vue-table": "^8.21.3",
     "@tanstack/vue-virtual": "^3.13.12",
     "@trpc/client": "^11.7.1",
@@ -25,7 +25,7 @@
     "vue-router": "^4.6.3"
   },
   "devDependencies": {
-    "@cloudflare/vite-plugin": "^1.14.0",
+    "@cloudflare/vite-plugin": "^1.14.2",
     "@hono/node-server": "^1.19.6",
     "@hono/trpc-server": "^0.4.0",
     "@tailwindcss/vite": "^4.1.17",
@@ -33,7 +33,7 @@
     "@vitejs/plugin-vue": "^6.0.1",
     "@vitejs/plugin-vue-jsx": "^5.1.1",
     "@vue/tsconfig": "^0.8.1",
-    "hono": "^4.10.4",
+    "hono": "^4.10.5",
     "tailwindcss": "^4.1.17",
     "typescript": "~5.9.3",
     "unplugin-vue-router": "^0.16.1",
@@ -41,7 +41,7 @@
     "vite-plugin-vue-devtools": "^8.0.3",
     "vite-tsconfig-paths": "^5.1.4",
     "vue-tsc": "3.1.3",
-    "wrangler": "^4.46.0",
+    "wrangler": "^4.48.0",
     "zod": "^4.1.12"
   }
 }

package/templates/apps/server/package.json

@@ -52,8 +52,8 @@
   },
   "devDependencies": {
     "@hono/node-server": "^1.19.6",
-    "hono": "^4.10.4",
-    "wrangler": "^4.46.0",
+    "hono": "^4.10.5",
+    "wrangler": "^4.48.0",
     "zod": "^4.1.12"
   }
 }

package/templates/packages/vue-lib-template/package.json

@@ -49,7 +49,7 @@
     "@vitejs/plugin-vue": "^6.0.1",
     "@vue/test-utils": "^2.4.6",
     "@vue/tsconfig": "^0.8.1",
-    "jsdom": "^27.1.0",
+    "jsdom": "^27.2.0",
     "tailwindcss": "^4.1.17",
     "unplugin-vue-router": "^0.16.1",
     "vite": "^7.2.2",