create-yarn-workspaces 3.0.4 → 3.0.5

package/CHANGELOG.md

@@ -3,6 +3,41 @@
 All notable changes to this project will be documented in this file.
 See [Conventional Commits](https://conventionalcommits.org) for commit guidelines.
 
+## [3.0.5](https://github.com/bluelovers/ws-yarn-workspaces/compare/create-yarn-workspaces@3.0.4...create-yarn-workspaces@3.0.5) (2026-03-02)
+
+
+
+### 📦　Code Refactoring
+
+* **npa-to-deps-query:** 整合 IResult 類型並添加 npm-package-arg-util 依賴 ([7c4471c](https://github.com/bluelovers/ws-yarn-workspaces/commit/7c4471c7ccd1242826b6f47da38bb967a6c44abc))
+
+
+### 📚　Documentation
+
+* **pkg-entry-util,create-yarn-workspaces,npm-init2:** 新增完整雙語文件與 JSDoc 註解 ([c1786e6](https://github.com/bluelovers/ws-yarn-workspaces/commit/c1786e6785abe484c95ee3dee8b8a16358c3904b))
+
+
+### 🚨　Tests
+
+* **fnm-detect:** correct alias props and update dependencies ([21d1c54](https://github.com/bluelovers/ws-yarn-workspaces/commit/21d1c54c60ae64fb2117eae1e2b86bb42c8b6070))
+
+
+### 🛠　Build System
+
+* **pkg-entry-util,create-yarn-workspaces,npm-init2:** 新增完整雙語文件與 JSDoc 註解 ([087d6d6](https://github.com/bluelovers/ws-yarn-workspaces/commit/087d6d6e560c70ed68a79ad73c8eb05868ec4203))
+
+
+### ♻️　Chores
+
+* Add test config and global types for tsdx ([88a8df6](https://github.com/bluelovers/ws-yarn-workspaces/commit/88a8df6eef5dc59d9e0d9268b21706dceb5ab2a1))
+* remove empty resolutions and redundant packageManager fields ([65b5c5f](https://github.com/bluelovers/ws-yarn-workspaces/commit/65b5c5f929aae82474408b2b46cfc5a471c919f6))
+* add __root.ts test utility to workspace packages ([a771727](https://github.com/bluelovers/ws-yarn-workspaces/commit/a7717278883c86d9ed8ab89f42070d3385c173a7))
+* **deps:** 升級路徑與檔案系統相關依賴版本 ([78d395b](https://github.com/bluelovers/ws-yarn-workspaces/commit/78d395b5469feecc85f250ca2d8b4977161e7618))
+* **deps:** 更新依賴版本並將腳本執行從 yarn 遷移至 node --run ([389e581](https://github.com/bluelovers/ws-yarn-workspaces/commit/389e581a07cf803dc34c8402b4d3f69af0016b8c))
+* **deps:** 升級多項依賴套件版本 ([1382602](https://github.com/bluelovers/ws-yarn-workspaces/commit/1382602ca94ff236b251fd1481b6332468de4621))
+
+
+
 ## [3.0.4](https://github.com/bluelovers/ws-yarn-workspaces/compare/create-yarn-workspaces@3.0.3...create-yarn-workspaces@3.0.4) (2025-09-07)
 
 

package/README.md

@@ -1,10 +1,80 @@
 # create-yarn-workspaces
 
-    yarn create yarn-workspaces
-    npx create-yarn-workspaces
-
-* [npm-init2](https://www.npmjs.com/package/npm-init2)
-* [create-yarn-workspaces](https://www.npmjs.com/package/create-yarn-workspaces)
-* [find-pkg-ws](https://www.npmjs.com/package/find-pkg-ws)
-* [workspaces-config](https://www.npmjs.com/package/workspaces-config)
-* [keywords:workspaces](https://www.npmjs.com/search?q=keywords:workspaces)
+> 快速初始化 Yarn Workspaces 專案結構 / Quickly initialize Yarn Workspaces project structure
+
+## 安裝與使用 / Installation & Usage
+
+```bash
+# 使用 Yarn
+yarn create yarn-workspaces
+
+# 使用 npx
+npx create-yarn-workspaces
+
+# 使用 pnpm
+pnpm create yarn-workspaces
+```
+
+## 功能特性 / Features
+
+- 🚀 **快速初始化** - 一鍵創建完整的 Yarn Workspaces 專案結構
+- 📦 **Lerna 整合** - 自動檢測並更新現有的 Lerna 配置
+- 📝 **智能設定** - 自動配置 package.json、tsconfig 等開發環境檔案
+- 🔧 **靈活選項** - 支援自定義初始化回呼與多種配置選項
+- 🗂️ **目錄管理** - 根據 workspaces 配置自動創建 packages 目錄
+
+## 命令列選項 / CLI Options
+
+| 選項 / Option | 別名 / Alias | 說明 / Description |
+|--------------|-------------|-------------------|
+| `--name` | `-n` | 指定 Package 名稱 / Specify package name |
+| `--ignoreExistsPackage` | `-i` | 忽略已存在的 Package / Ignore existing package |
+| `--ignoreParentWorkspaces` | | 忽略父層 Workspaces / Ignore parent workspaces |
+| `--debug` | | 啟用除錯模式 / Enable debug mode |
+
+## API 使用 / API Usage
+
+```typescript
+import { createYarnWorkspaces, IOptions } from 'create-yarn-workspaces';
+
+// 基本使用 / Basic usage
+const success = createYarnWorkspaces('./my-project');
+
+// 帶選項 / With options
+const options: IOptions = {
+  ignoreExistsPackage: true,
+  ignoreParentWorkspaces: false,
+  initPackageJson: (pkg) => {
+    pkg.author = 'Your Name';
+    return pkg;
+  }
+};
+
+createYarnWorkspaces('./my-project', options);
+```
+
+## 目錄結構 / Directory Structure
+
+初始化後的專案結構 / Project structure after initialization:
+
+```
+my-project/
+├── package.json          # Workspaces 配置 / Workspaces config
+├── lerna.json           # Lerna 配置（如果存在）/ Lerna config (if exists)
+├── tsconfig.json        # TypeScript 配置 / TypeScript config
+├── .gitignore           # Git 忽略規則 / Git ignore rules
+├── .eslintrc.json       # ESLint 配置 / ESLint config
+└── packages/            # 套件目錄 / Packages directory
+    └── .gitkeep
+```
+
+## 相關專案 / Related Projects
+
+- [npm-init2](https://www.npmjs.com/package/npm-init2) - 初始化個別 Package / Initialize individual packages
+- [find-pkg-ws](https://www.npmjs.com/package/find-pkg-ws) - 尋找 Workspace Package / Find workspace packages
+- [workspaces-config](https://www.npmjs.com/package/workspaces-config) - Workspaces 配置解析 / Workspaces config parser
+- [keywords:workspaces](https://www.npmjs.com/search?q=keywords:workspaces) - 更多 Workspaces 工具 / More workspaces tools
+
+## 授權 / License
+
+ISC

package/index.d.ts

@@ -1,17 +1,99 @@
 /**
- * Created by user on 2018/5/13/013.
+ * 創建 Yarn Workspaces 工具模組
+ * Yarn Workspaces Creation Tool Module
+ *
+ * 提供初始化 Yarn Workspaces 專案結構的功能，包含 package.json 設定、
+ * Lerna 整合、目錄創建與靜態檔案複製等功能。
+ * Provides functionality to initialize Yarn Workspaces project structure,
+ * including package.json configuration, Lerna integration, directory creation,
+ * and static file copying.
+ *
+ * @author user
+ * @since 2018/5/13/013
  */
 import { IPackageJson } from '@ts-type/package-dts/package-json';
 export * from './lib/index';
 export * from './lib/util';
+/**
+ * 創建 Workspaces 的選項介面
+ * Interface for creating workspaces options
+ */
 export interface IOptions {
+    /**
+     * 工作目錄路徑 / Working directory path
+     */
     cwd?: string;
+    /**
+     * 忽略父層 Workspaces / Ignore parent workspaces
+     */
     ignoreParentWorkspaces?: boolean;
+    /**
+     * 忽略已存在的 Package / Ignore existing package
+     */
     ignoreExistsPackage?: boolean;
+    /**
+     * 初始化 Package.json 的回呼函式
+     * Callback function to initialize package.json
+     * @template T - 擴展屬性類型 / Extended property type
+     * @param current - 當前的 package.json / Current package.json
+     * @returns 修改後的 package.json / Modified package.json
+     */
     initPackageJson?<T extends Record<string, any> = {}>(current: IPackageJson): IPackageJson & T;
+    /**
+     * 啟用除錯模式 / Enable debug mode
+     */
     debug?: boolean;
 }
+/**
+ * 創建 Yarn Workspaces 主函式
+ * Main function to create Yarn Workspaces
+ *
+ * 檢查並創建 Workspaces 專案結構，處理已存在 Package 與父層 Workspaces 的情況
+ * Checks and creates workspace project structure, handling existing packages
+ * and parent workspaces
+ *
+ * @param cwd - 工作目錄路徑 / Working directory path
+ * @param options - 配置選項 / Configuration options
+ * @returns 是否成功創建 / Whether creation was successful
+ */
 export declare function createYarnWorkspaces(cwd?: string, options?: IOptions): boolean;
+/**
+ * 內部創建 Workspaces 實作函式
+ * Internal implementation function for creating workspaces
+ *
+ * 執行實際的 Workspaces 初始化工作，包含：
+ * - 讀取並更新 Lerna 配置
+ * - 創建或更新 package.json
+ * - 複製靜態範本檔案
+ * - 創建 packages 目錄
+ *
+ * Performs actual workspace initialization including:
+ * - Reading and updating Lerna configuration
+ * - Creating or updating package.json
+ * - Copying static template files
+ * - Creating packages directory
+ *
+ * @param targetPath - 目標路徑 / Target path
+ * @param options - 配置選項 / Configuration options
+ * @returns 是否成功 / Whether successful
+ */
 export declare function _createYarnWorkspaces(targetPath: string, options?: IOptions): boolean;
+/**
+ * 根據 packages 模式創建目錄
+ * Create directories based on packages pattern
+ *
+ * 解析 packages 陣列中的目錄模式（如 "packages/*"），
+ * 並創建對應的實體目錄。
+ * Parses directory patterns from packages array (e.g., "packages/*")
+ * and creates corresponding physical directories.
+ *
+ * @param cwd - 當前工作目錄 / Current working directory
+ * @param packages - packages 模式陣列 / Array of package patterns
+ * @returns 是否有創建任何目錄 / Whether any directories were created
+ */
 export declare function createDirByPackages(cwd: string, packages: string[]): boolean;
+/**
+ * 預設導出創建函式
+ * Default export of creation function
+ */
 export default createYarnWorkspaces;

package/index.js

@@ -1,6 +1,16 @@
 "use strict";
 /**
- * Created by user on 2018/5/13/013.
+ * 創建 Yarn Workspaces 工具模組
+ * Yarn Workspaces Creation Tool Module
+ *
+ * 提供初始化 Yarn Workspaces 專案結構的功能，包含 package.json 設定、
+ * Lerna 整合、目錄創建與靜態檔案複製等功能。
+ * Provides functionality to initialize Yarn Workspaces project structure,
+ * including package.json configuration, Lerna integration, directory creation,
+ * and static file copying.
+ *
+ * @author user
+ * @since 2018/5/13/013
  */
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.createYarnWorkspaces = createYarnWorkspaces;
@@ -19,36 +29,69 @@ const find_root_1 = require("@yarn-tool/find-root");
 const upath2_2 = require("upath2");
 tslib_1.__exportStar(require("./lib/index"), exports);
 tslib_1.__exportStar(require("./lib/util"), exports);
+/**
+ * 創建 Yarn Workspaces 主函式
+ * Main function to create Yarn Workspaces
+ *
+ * 檢查並創建 Workspaces 專案結構，處理已存在 Package 與父層 Workspaces 的情況
+ * Checks and creates workspace project structure, handling existing packages
+ * and parent workspaces
+ *
+ * @param cwd - 工作目錄路徑 / Working directory path
+ * @param options - 配置選項 / Configuration options
+ * @returns 是否成功創建 / Whether creation was successful
+ */
 function createYarnWorkspaces(cwd, options = {}) {
     var _a;
+    // 處理第一個參數可能是選項物件的情況
+    // Handle case where first argument might be options object
     if (cwd && typeof cwd != 'string') {
         options = cwd;
         cwd = options.cwd;
     }
+    // 預設使用當前工作目錄 / Default to current working directory
     cwd !== null && cwd !== void 0 ? cwd : (cwd = process.cwd());
+    // 尋找專案根目錄資訊 / Find project root information
     const rootData = (0, find_root_1.findRootLazy)({
         cwd,
     });
+    // 標準化路徑 / Normalize path
     cwd = (0, upath2_2.normalize)((_a = rootData === null || rootData === void 0 ? void 0 : rootData.cwd) !== null && _a !== void 0 ? _a : cwd);
+    // 取得 Package 根目錄與 Workspaces 路徑
+    // Get package root directory and workspace path
     let root = rootData === null || rootData === void 0 ? void 0 : rootData.pkg;
     let ws = rootData === null || rootData === void 0 ? void 0 : rootData.ws;
     let targetPath = (0, upath2_1.resolve)(root || cwd);
+    // 除錯輸出 / Debug output
     options.debug && logger_1.consoleLogger.debug({
         targetPath,
         ws,
         options,
     });
+    /**
+     * 檢查是否已存在 Package
+     * Check if package already exists
+     */
     if (!options.ignoreExistsPackage && root) {
         logger_1.consoleLogger.error(`already have package at "${root}", or use ignoreExistsPackage for overwrite it`);
         return false;
     }
     else if (root) {
+        // 忽略已存在的 Package / Ignore existing package
         logger_1.consoleLogger.warn(`ignore exists package "${root}"`);
     }
+    /**
+     * 檢查是否已存在 Workspaces
+     * Check if workspace already exists
+     */
     if (ws) {
+        // 檢查目標路徑是否與現有 Workspace 相同
+        // Check if target path is same as existing workspace
         let bool = !(0, util_1.isSamePath)(targetPath, ws);
         logger_1.consoleLogger.warn(`detect exists workspace "${ws}"`);
         if (bool) {
+            // 根據選項決定是否忽略父層 Workspaces
+            // Decide whether to ignore parent workspaces based on options
             if (options.ignoreParentWorkspaces) {
                 logger_1.consoleLogger.warn(`ignoreParentWorkspaces = true`);
                 bool = false;
@@ -63,33 +106,79 @@ function createYarnWorkspaces(cwd, options = {}) {
     }
     return _createYarnWorkspaces(targetPath);
 }
+/**
+ * 內部創建 Workspaces 實作函式
+ * Internal implementation function for creating workspaces
+ *
+ * 執行實際的 Workspaces 初始化工作，包含：
+ * - 讀取並更新 Lerna 配置
+ * - 創建或更新 package.json
+ * - 複製靜態範本檔案
+ * - 創建 packages 目錄
+ *
+ * Performs actual workspace initialization including:
+ * - Reading and updating Lerna configuration
+ * - Creating or updating package.json
+ * - Copying static template files
+ * - Creating packages directory
+ *
+ * @param targetPath - 目標路徑 / Target path
+ * @param options - 配置選項 / Configuration options
+ * @returns 是否成功 / Whether successful
+ */
 function _createYarnWorkspaces(targetPath, options = {}) {
     logger_1.consoleLogger.info(`create in target path "${targetPath}"`);
     let pkg;
     let lerna;
+    /**
+     * 嘗試讀取現有的 lerna.json 配置
+     * Try to read existing lerna.json configuration
+     */
     {
         let file = (0, upath2_1.join)(targetPath, 'lerna.json');
         if ((0, fs_extra_1.existsSync)(file)) {
             let json = JSON.parse((0, fs_extra_1.readFileSync)(file).toString());
+            /**
+             * 清理空的 packages 陣列
+             * Clean up empty packages array
+             */
             if (json.packages && !Object.keys(json.packages).length) {
                 json.packages = undefined;
             }
             lerna = json;
         }
     }
+    /**
+     * 預設 packages 目錄模式
+     * Default packages directory pattern
+     */
     let packages = lerna && lerna.packages || [
         "packages/*",
     ];
     let file = (0, upath2_1.join)(targetPath, 'package.json');
+    /**
+     * 處理 package.json 不存在的情況
+     * Handle case when package.json does not exist
+     */
     if (!(0, fs_extra_1.existsSync)(file)) {
+        // 使用目錄名作為預設 Package 名稱
+        // Use directory name as default package name
         let name = (0, upath2_1.basename)(targetPath);
+        // 創建目標目錄（如果不存在）
+        // Create target directory if it doesn't exist
         if (!(0, fs_extra_1.existsSync)(targetPath)) {
             (0, fs_extra_1.mkdirSync)(targetPath);
         }
+        // 合併預設配置與基本資訊
+        // Merge default configuration with basic info
         pkg = Object.assign((0, lib_1.getDefaultPackageJson)(name), {
             name,
             workspaces: packages,
         });
+        /**
+         * 執行自定義初始化回呼
+         * Execute custom initialization callback
+         */
         if (options.initPackageJson) {
             let ret = options.initPackageJson(pkg);
             if (ret) {
@@ -98,63 +187,129 @@ function _createYarnWorkspaces(targetPath, options = {}) {
         }
     }
     else {
+        /**
+         * 處理已存在的 package.json
+         * Handle existing package.json
+         */
         let json = JSON.parse((0, fs_extra_1.readFileSync)(file).toString());
         let workspaces;
+        /**
+         * 解析現有的 workspaces 配置
+         * Parse existing workspaces configuration
+         */
         if (json.workspaces && Object.keys(json.workspaces).length) {
             workspaces = json.workspaces;
-            // https://yarnpkg.com/blog/2018/02/15/nohoist/
+            /**
+             * 支援 nohoist 配置格式
+             * Support nohoist configuration format
+             * @see https://yarnpkg.com/blog/2018/02/15/nohoist/
+             */
             // @ts-ignore
             packages = workspaces.packages || workspaces;
         }
         else {
             workspaces = packages;
         }
+        /**
+         * 更新 Package.json 內容
+         * Update package.json content
+         */
         pkg = Object.assign(json, {
             "private": true,
             "workspaces": workspaces,
         });
+        // 初始化 resolutions 欄位 / Initialize resolutions field
         pkg.resolutions = pkg.resolutions || {};
+        /**
+         * 合併預設腳本與欄位
+         * Merge default scripts and fields
+         */
         Object.entries((0, lib_1.getDefaultPackageJson)(json.name))
             .forEach(([field, value]) => {
             var _a, _b;
+            /**
+             * 特殊處理 scripts 欄位：合併而非覆蓋
+             * Special handling for scripts field: merge instead of overwrite
+             */
             if (field === 'scripts') {
                 (_a = pkg.scripts) !== null && _a !== void 0 ? _a : (pkg.scripts = {});
                 pkg.scripts = {
+                    // @ts-ignore
                     ...value,
                     ...pkg.scripts,
                 };
             }
             else {
+                // 使用空值合併運算子設置預設值
+                // Use nullish coalescing operator for default values
                 (_b = pkg[field]) !== null && _b !== void 0 ? _b : (pkg[field] = value);
             }
         });
     }
+    /**
+     * 寫入格式化後的 package.json
+     * Write formatted package.json
+     */
     let s = JSON.stringify((0, sort_package_json3_1.sortPackageJson)(pkg), null, 2);
     (0, fs_extra_1.writeFileSync)(file, s);
     logger_1.consoleLogger.success(`create workspace package.json`);
-    if (lerna && (packages != lerna.packages || lerna.npmClient !== 'yarn' || lerna.useWorkspaces !== true)) {
+    /**
+     * 更新 Lerna 配置（如果存在且需要更新）
+     * Update Lerna configuration if exists and needs updating
+     */
+    if (lerna && (packages != lerna.packages || lerna.npmClient !== 'yarn' || lerna['useWorkspaces'] !== true)) {
         let file = (0, upath2_1.join)(targetPath, 'lerna.json');
+        // 更新為 Yarn Workspaces 模式
+        // Update to Yarn Workspaces mode
         lerna.packages = packages;
         lerna.npmClient = 'yarn';
-        lerna.useWorkspaces = true;
+        lerna['useWorkspaces'] = true;
         let s = JSON.stringify((0, sort_package_json3_1.sortPackageJson)(lerna), null, 2);
         (0, fs_extra_1.writeFileSync)(file, s);
         logger_1.consoleLogger.info(`update lerna.json`);
     }
+    /**
+     * 複製靜態範本檔案
+     * Copy static template files
+     */
     const file_map = (0, wsCopyStaticFiles_1.getWsCopyStaticFiles)();
     (0, static_file_1.copyStaticFiles)({
         cwd: targetPath,
         file_map,
     });
+    /**
+     * 根據 packages 模式創建目錄
+     * Create directories based on packages pattern
+     */
     createDirByPackages(targetPath, packages);
     return true;
 }
+/**
+ * 根據 packages 模式創建目錄
+ * Create directories based on packages pattern
+ *
+ * 解析 packages 陣列中的目錄模式（如 "packages/*"），
+ * 並創建對應的實體目錄。
+ * Parses directory patterns from packages array (e.g., "packages/*")
+ * and creates corresponding physical directories.
+ *
+ * @param cwd - 當前工作目錄 / Current working directory
+ * @param packages - packages 模式陣列 / Array of package patterns
+ * @returns 是否有創建任何目錄 / Whether any directories were created
+ */
 function createDirByPackages(cwd, packages) {
     return packages.some(function (value) {
         let bool;
+        // 提取路徑的第一個部分（目錄名稱）
+        // Extract first part of path (directory name)
         let s = value.split(/[\/\\]/)[0];
+        /**
+         * 只處理不包含 glob 模式的純目錄路徑
+         * Only handle pure directory paths without glob patterns
+         */
         if (!/[!?\*{}\[\]]/.test(s)) {
             let dir = (0, upath2_1.join)(cwd, s);
+            // 目錄不存在時創建 / Create directory if it doesn't exist
             if (!(0, fs_extra_1.existsSync)(dir)) {
                 (0, fs_extra_1.mkdirSync)(dir);
             }
@@ -163,5 +318,9 @@ function createDirByPackages(cwd, packages) {
         return bool;
     });
 }
+/**
+ * 預設導出創建函式
+ * Default export of creation function
+ */
 exports.default = createYarnWorkspaces;
 //# sourceMappingURL=index.js.map

package/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["index.ts"],"names":[],"mappings":"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","sourcesContent":["/**\n * Created by user on 2018/5/13/013.\n */\n\nimport findYarnWorkspaceRoot from 'find-yarn-workspace-root2/core';\nimport { resolve, join, basename } from 'upath2';\nimport pkgDir from 'pkg-dir';\nimport { consoleLogger as console } from 'debug-color2/logger';\nimport { copyStaticFiles } from '@yarn-tool/static-file';\nimport { existsSync, readFileSync, mkdirSync, writeFileSync } from 'fs-extra';\nimport { sortPackageJson } from 'sort-package-json3';\nimport { getDefaultPackageJson } from './lib';\nimport { isSamePath } from './lib/util';\nimport { ILernaJson } from '@ts-type/package-dts/lerna-json';\nimport { IPackageJson } from '@ts-type/package-dts/package-json';\nimport { getWsCopyStaticFiles } from '@yarn-tool/static-file/lib/ws/wsCopyStaticFiles';\nimport { findRootLazy } from '@yarn-tool/find-root';\nimport { normalize as pathNormalize } from 'upath2';\n\nexport * from './lib/index';\nexport * from './lib/util';\n\nexport interface IOptions\n{\n\tcwd?: string,\n\n\tignoreParentWorkspaces?: boolean,\n\tignoreExistsPackage?: boolean,\n\n\tinitPackageJson?<T extends Record<string, any> = {}>(current: IPackageJson): IPackageJson & T,\n\n\tdebug?: boolean,\n}\n\nexport function createYarnWorkspaces(cwd?: string, options: IOptions = {})\n{\n\tif (cwd && typeof cwd != 'string')\n\t{\n\t\toptions = cwd;\n\t\tcwd = options.cwd;\n\t}\n\n\tcwd ??= process.cwd();\n\n\tconst rootData = findRootLazy({\n\t\tcwd,\n\t});\n\n\tcwd = pathNormalize(rootData?.cwd ?? cwd);\n\n\tlet root: string = rootData?.pkg;\n\tlet ws: string = rootData?.ws;\n\n\tlet targetPath = resolve(root || cwd);\n\n\toptions.debug && console.debug({\n\t\ttargetPath,\n\t\tws,\n\t\toptions,\n\t});\n\n\tif (!options.ignoreExistsPackage && root)\n\t{\n\t\tconsole.error(`already have package at \"${root}\", or use ignoreExistsPackage for overwrite it`);\n\n\t\treturn false;\n\t}\n\telse if (root)\n\t{\n\t\tconsole.warn(`ignore exists package \"${root}\"`);\n\t}\n\n\tif (ws)\n\t{\n\t\tlet bool: boolean = !isSamePath(targetPath, ws);\n\n\t\tconsole.warn(`detect exists workspace \"${ws}\"`);\n\n\t\tif (bool)\n\t\t{\n\t\t\tif (options.ignoreParentWorkspaces)\n\t\t\t{\n\t\t\t\tconsole.warn(`ignoreParentWorkspaces = true`);\n\t\t\t\tbool = false;\n\t\t\t}\n\t\t\telse\n\t\t\t{\n\t\t\t\tconsole.error(`target path already is workspace`);\n\t\t\t}\n\t\t}\n\n\t\tif (bool)\n\t\t{\n\t\t\treturn false;\n\t\t}\n\t}\n\n\treturn _createYarnWorkspaces(targetPath);\n}\n\nexport function _createYarnWorkspaces(targetPath: string, options: IOptions = {})\n{\n\tconsole.info(`create in target path \"${targetPath}\"`);\n\n\tlet pkg: IPackageJson;\n\n\tlet lerna: ILernaJson;\n\n\t{\n\t\tlet file = join(targetPath, 'lerna.json');\n\n\t\tif (existsSync(file))\n\t\t{\n\t\t\tlet json: ILernaJson = JSON.parse(readFileSync(file).toString());\n\n\t\t\tif (json.packages && !Object.keys(json.packages).length)\n\t\t\t{\n\t\t\t\tjson.packages = undefined;\n\t\t\t}\n\n\t\t\tlerna = json;\n\t\t}\n\t}\n\n\tlet packages = lerna && lerna.packages || [\n\t\t\"packages/*\",\n\t];\n\n\tlet file = join(targetPath, 'package.json');\n\n\tif (!existsSync(file))\n\t{\n\t\tlet name = basename(targetPath);\n\n\t\tif (!existsSync(targetPath))\n\t\t{\n\t\t\tmkdirSync(targetPath);\n\t\t}\n\n\t\tpkg = Object.assign(getDefaultPackageJson(name), {\n\t\t\tname,\n\t\t\tworkspaces: packages,\n\t\t});\n\n\t\tif (options.initPackageJson)\n\t\t{\n\t\t\tlet ret = options.initPackageJson(pkg);\n\n\t\t\tif (ret)\n\t\t\t{\n\t\t\t\tpkg = ret;\n\t\t\t}\n\t\t}\n\t}\n\telse\n\t{\n\t\tlet json: IPackageJson = JSON.parse(readFileSync(file).toString());\n\n\t\tlet workspaces: ILernaJson['packages'];\n\n\t\tif (json.workspaces && Object.keys(json.workspaces).length)\n\t\t{\n\t\t\tworkspaces = json.workspaces;\n\n\t\t\t// https://yarnpkg.com/blog/2018/02/15/nohoist/\n\t\t\t// @ts-ignore\n\t\t\tpackages = workspaces.packages || workspaces;\n\t\t}\n\t\telse\n\t\t{\n\t\t\tworkspaces = packages;\n\t\t}\n\n\t\tpkg = Object.assign(json, {\n\t\t\t\"private\": true,\n\t\t\t\"workspaces\": workspaces,\n\t\t});\n\n\t\tpkg.resolutions = pkg.resolutions || {};\n\n\t\tObject.entries(getDefaultPackageJson(json.name))\n\t\t\t.forEach(([field, value]) => {\n\n\t\t\t\tif (field === 'scripts')\n\t\t\t\t{\n\t\t\t\t\tpkg.scripts ??= {};\n\t\t\t\t\tpkg.scripts = {\n\t\t\t\t\t\t...value,\n\t\t\t\t\t\t...pkg.scripts,\n\t\t\t\t\t}\n\t\t\t\t}\n\t\t\t\telse\n\t\t\t\t{\n\t\t\t\t\tpkg[field] ??= value\n\t\t\t\t}\n\n\t\t\t})\n\t\t;\n\n\t}\n\n\tlet s = JSON.stringify(sortPackageJson(pkg), null, 2);\n\twriteFileSync(file, s);\n\n\tconsole.success(`create workspace package.json`);\n\n\tif (lerna && (packages != lerna.packages || lerna.npmClient !== 'yarn' || lerna.useWorkspaces !== true))\n\t{\n\t\tlet file = join(targetPath, 'lerna.json');\n\n\t\tlerna.packages = packages;\n\t\tlerna.npmClient = 'yarn';\n\t\tlerna.useWorkspaces = true;\n\n\t\tlet s = JSON.stringify(sortPackageJson(lerna), null, 2);\n\t\twriteFileSync(file, s);\n\n\t\tconsole.info(`update lerna.json`);\n\t}\n\n\tconst file_map = getWsCopyStaticFiles();\n\n\tcopyStaticFiles({\n\t\tcwd: targetPath,\n\t\tfile_map,\n\t});\n\n\tcreateDirByPackages(targetPath, packages);\n\n\treturn true;\n}\n\nexport function createDirByPackages(cwd: string, packages: string[])\n{\n\treturn packages.some(function (value)\n\t{\n\t\tlet bool: boolean;\n\n\t\tlet s = value.split(/[\\/\\\\]/)[0];\n\n\t\tif (!/[!?\\*{}\\[\\]]/.test(s))\n\t\t{\n\t\t\tlet dir = join(cwd, s);\n\n\t\t\tif (!existsSync(dir))\n\t\t\t{\n\t\t\t\tmkdirSync(dir);\n\t\t\t}\n\n\t\t\treturn true;\n\t\t}\n\n\t\treturn bool;\n\t})\n}\n\nexport default createYarnWorkspaces;\n"]}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["index.ts"],"names":[],"mappings":";AAAA;;;;;;;;;;;;GAYG;;AAoEH,oDAqFC;AAsBD,sDA0MC;AAeD,kDA6BC;;AAlaD,mCAAiD;AAEjD,gDAA+D;AAC/D,wDAAyD;AACzD,uCAA8E;AAC9E,2DAAqD;AACrD,+BAA8C;AAC9C,qCAAwC;AAGxC,uFAAuF;AACvF,oDAAoD;AACpD,mCAAoD;AAEpD,sDAA4B;AAC5B,qDAA2B;AAsC3B;;;;;;;;;;;GAWG;AACH,SAAgB,oBAAoB,CAAC,GAAY,EAAE,UAAoB,EAAE;;IAExE,oBAAoB;IACpB,2DAA2D;IAC3D,IAAI,GAAG,IAAI,OAAO,GAAG,IAAI,QAAQ,EACjC,CAAC;QACA,OAAO,GAAG,GAAG,CAAC;QACd,GAAG,GAAG,OAAO,CAAC,GAAG,CAAC;IACnB,CAAC;IAED,oDAAoD;IACpD,GAAG,aAAH,GAAG,cAAH,GAAG,IAAH,GAAG,GAAK,OAAO,CAAC,GAAG,EAAE,EAAC;IAEtB,4CAA4C;IAC5C,MAAM,QAAQ,GAAG,IAAA,wBAAY,EAAC;QAC7B,GAAG;KACH,CAAC,CAAC;IAEH,yBAAyB;IACzB,GAAG,GAAG,IAAA,kBAAa,EAAC,MAAA,QAAQ,aAAR,QAAQ,uBAAR,QAAQ,CAAE,GAAG,mCAAI,GAAG,CAAC,CAAC;IAE1C,gCAAgC;IAChC,gDAAgD;IAChD,IAAI,IAAI,GAAW,QAAQ,aAAR,QAAQ,uBAAR,QAAQ,CAAE,GAAG,CAAC;IACjC,IAAI,EAAE,GAAW,QAAQ,aAAR,QAAQ,uBAAR,QAAQ,CAAE,EAAE,CAAC;IAE9B,IAAI,UAAU,GAAG,IAAA,gBAAO,EAAC,IAAI,IAAI,GAAG,CAAC,CAAC;IAEtC,sBAAsB;IACtB,OAAO,CAAC,KAAK,IAAI,sBAAO,CAAC,KAAK,CAAC;QAC9B,UAAU;QACV,EAAE;QACF,OAAO;KACP,CAAC,CAAC;IAEH;;;OAGG;IACH,IAAI,CAAC,OAAO,CAAC,mBAAmB,IAAI,IAAI,EACxC,CAAC;QACA,sBAAO,CAAC,KAAK,CAAC,4BAA4B,IAAI,gDAAgD,CAAC,CAAC;QAEhG,OAAO,KAAK,CAAC;IACd,CAAC;SACI,IAAI,IAAI,EACb,CAAC;QACA,2CAA2C;QAC3C,sBAAO,CAAC,IAAI,CAAC,0BAA0B,IAAI,GAAG,CAAC,CAAC;IACjD,CAAC;IAED;;;OAGG;IACH,IAAI,EAAE,EACN,CAAC;QACA,2BAA2B;QAC3B,qDAAqD;QACrD,IAAI,IAAI,GAAY,CAAC,IAAA,iBAAU,EAAC,UAAU,EAAE,EAAE,CAAC,CAAC;QAEhD,sBAAO,CAAC,IAAI,CAAC,4BAA4B,EAAE,GAAG,CAAC,CAAC;QAEhD,IAAI,IAAI,EACR,CAAC;YACA,0BAA0B;YAC1B,8DAA8D;YAC9D,IAAI,OAAO,CAAC,sBAAsB,EAClC,CAAC;gBACA,sBAAO,CAAC,IAAI,CAAC,+BAA+B,CAAC,CAAC;gBAC9C,IAAI,GAAG,KAAK,CAAC;YACd,CAAC;iBAED,CAAC;gBACA,sBAAO,CAAC,KAAK,CAAC,kCAAkC,CAAC,CAAC;YACnD,CAAC;QACF,CAAC;QAED,IAAI,IAAI,EACR,CAAC;YACA,OAAO,KAAK,CAAC;QACd,CAAC;IACF,CAAC;IAED,OAAO,qBAAqB,CAAC,UAAU,CAAC,CAAC;AAC1C,CAAC;AAED;;;;;;;;;;;;;;;;;;;GAmBG;AACH,SAAgB,qBAAqB,CAAC,UAAkB,EAAE,UAAoB,EAAE;IAE/E,sBAAO,CAAC,IAAI,CAAC,0BAA0B,UAAU,GAAG,CAAC,CAAC;IAEtD,IAAI,GAAiB,CAAC;IAEtB,IAAI,KAAiB,CAAC;IAEtB;;;OAGG;IACH,CAAC;QACA,IAAI,IAAI,GAAG,IAAA,aAAI,EAAC,UAAU,EAAE,YAAY,CAAC,CAAC;QAE1C,IAAI,IAAA,qBAAU,EAAC,IAAI,CAAC,EACpB,CAAC;YACA,IAAI,IAAI,GAAe,IAAI,CAAC,KAAK,CAAC,IAAA,uBAAY,EAAC,IAAI,CAAC,CAAC,QAAQ,EAAE,CAAC,CAAC;YAEjE;;;eAGG;YACH,IAAI,IAAI,CAAC,QAAQ,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC,MAAM,EACvD,CAAC;gBACA,IAAI,CAAC,QAAQ,GAAG,SAAS,CAAC;YAC3B,CAAC;YAED,KAAK,GAAG,IAAI,CAAC;QACd,CAAC;IACF,CAAC;IAED;;;OAGG;IACH,IAAI,QAAQ,GAAG,KAAK,IAAI,KAAK,CAAC,QAAQ,IAAI;QACzC,YAAY;KACZ,CAAC;IAEF,IAAI,IAAI,GAAG,IAAA,aAAI,EAAC,UAAU,EAAE,cAAc,CAAC,CAAC;IAE5C;;;OAGG;IACH,IAAI,CAAC,IAAA,qBAAU,EAAC,IAAI,CAAC,EACrB,CAAC;QACA,uBAAuB;QACvB,6CAA6C;QAC7C,IAAI,IAAI,GAAG,IAAA,iBAAQ,EAAC,UAAU,CAAC,CAAC;QAEhC,gBAAgB;QAChB,8CAA8C;QAC9C,IAAI,CAAC,IAAA,qBAAU,EAAC,UAAU,CAAC,EAC3B,CAAC;YACA,IAAA,oBAAS,EAAC,UAAU,CAAC,CAAC;QACvB,CAAC;QAED,cAAc;QACd,8CAA8C;QAC9C,GAAG,GAAG,MAAM,CAAC,MAAM,CAAC,IAAA,2BAAqB,EAAC,IAAI,CAAC,EAAE;YAChD,IAAI;YACJ,UAAU,EAAE,QAAQ;SACpB,CAAC,CAAC;QAEH;;;WAGG;QACH,IAAI,OAAO,CAAC,eAAe,EAC3B,CAAC;YACA,IAAI,GAAG,GAAG,OAAO,CAAC,eAAe,CAAC,GAAG,CAAC,CAAC;YAEvC,IAAI,GAAG,EACP,CAAC;gBACA,GAAG,GAAG,GAAG,CAAC;YACX,CAAC;QACF,CAAC;IACF,CAAC;SAED,CAAC;QACA;;;WAGG;QACH,IAAI,IAAI,GAAiB,IAAI,CAAC,KAAK,CAAC,IAAA,uBAAY,EAAC,IAAI,CAAC,CAAC,QAAQ,EAAE,CAAC,CAAC;QAEnE,IAAI,UAAkC,CAAC;QAEvC;;;WAGG;QACH,IAAI,IAAI,CAAC,UAAU,IAAI,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC,MAAM,EAC1D,CAAC;YACA,UAAU,GAAG,IAAI,CAAC,UAAU,CAAC;YAE7B;;;;eAIG;YACH,aAAa;YACb,QAAQ,GAAG,UAAU,CAAC,QAAQ,IAAI,UAAU,CAAC;QAC9C,CAAC;aAED,CAAC;YACA,UAAU,GAAG,QAAQ,CAAC;QACvB,CAAC;QAED;;;WAGG;QACH,GAAG,GAAG,MAAM,CAAC,MAAM,CAAC,IAAI,EAAE;YACzB,SAAS,EAAE,IAAI;YACf,YAAY,EAAE,UAAU;SACxB,CAAC,CAAC;QAEH,oDAAoD;QACpD,GAAG,CAAC,WAAW,GAAG,GAAG,CAAC,WAAW,IAAI,EAAE,CAAC;QAExC;;;WAGG;QACH,MAAM,CAAC,OAAO,CAAC,IAAA,2BAAqB,EAAC,IAAI,CAAC,IAAI,CAAC,CAAC;aAC9C,OAAO,CAAC,CAAC,CAAC,KAAK,EAAE,KAAK,CAAC,EAAE,EAAE;;YAE3B;;;eAGG;YACH,IAAI,KAAK,KAAK,SAAS,EACvB,CAAC;gBACA,MAAA,GAAG,CAAC,OAAO,oCAAX,GAAG,CAAC,OAAO,GAAK,EAAE,EAAC;gBACnB,GAAG,CAAC,OAAO,GAAG;oBACb,aAAa;oBACb,GAAG,KAAK;oBACR,GAAG,GAAG,CAAC,OAAO;iBACd,CAAA;YACF,CAAC;iBAED,CAAC;gBACA,iBAAiB;gBACjB,qDAAqD;gBACrD,MAAA,GAAG,CAAC,KAAK,qCAAT,GAAG,CAAC,KAAK,IAAM,KAAK,EAAA;YACrB,CAAC;QAEF,CAAC,CAAC,CACF;IAEF,CAAC;IAED;;;OAGG;IACH,IAAI,CAAC,GAAG,IAAI,CAAC,SAAS,CAAC,IAAA,oCAAe,EAAC,GAAG,CAAC,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC;IACtD,IAAA,wBAAa,EAAC,IAAI,EAAE,CAAC,CAAC,CAAC;IAEvB,sBAAO,CAAC,OAAO,CAAC,+BAA+B,CAAC,CAAC;IAEjD;;;OAGG;IACH,IAAI,KAAK,IAAI,CAAC,QAAQ,IAAI,KAAK,CAAC,QAAQ,IAAI,KAAK,CAAC,SAAS,KAAK,MAAM,IAAI,KAAK,CAAC,eAAe,CAAC,KAAK,IAAI,CAAC,EAC1G,CAAC;QACA,IAAI,IAAI,GAAG,IAAA,aAAI,EAAC,UAAU,EAAE,YAAY,CAAC,CAAC;QAE1C,yBAAyB;QACzB,iCAAiC;QACjC,KAAK,CAAC,QAAQ,GAAG,QAAQ,CAAC;QAC1B,KAAK,CAAC,SAAS,GAAG,MAAM,CAAC;QACzB,KAAK,CAAC,eAAe,CAAC,GAAG,IAAI,CAAC;QAE9B,IAAI,CAAC,GAAG,IAAI,CAAC,SAAS,CAAC,IAAA,oCAAe,EAAC,KAAK,CAAC,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC;QACxD,IAAA,wBAAa,EAAC,IAAI,EAAE,CAAC,CAAC,CAAC;QAEvB,sBAAO,CAAC,IAAI,CAAC,mBAAmB,CAAC,CAAC;IACnC,CAAC;IAED;;;OAGG;IACH,MAAM,QAAQ,GAAG,IAAA,wCAAoB,GAAE,CAAC;IAExC,IAAA,6BAAe,EAAC;QACf,GAAG,EAAE,UAAU;QACf,QAAQ;KACR,CAAC,CAAC;IAEH;;;OAGG;IACH,mBAAmB,CAAC,UAAU,EAAE,QAAQ,CAAC,CAAC;IAE1C,OAAO,IAAI,CAAC;AACb,CAAC;AAED;;;;;;;;;;;;GAYG;AACH,SAAgB,mBAAmB,CAAC,GAAW,EAAE,QAAkB;IAElE,OAAO,QAAQ,CAAC,IAAI,CAAC,UAAU,KAAK;QAEnC,IAAI,IAAa,CAAC;QAElB,mBAAmB;QACnB,8CAA8C;QAC9C,IAAI,CAAC,GAAG,KAAK,CAAC,KAAK,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,CAAC;QAEjC;;;WAGG;QACH,IAAI,CAAC,cAAc,CAAC,IAAI,CAAC,CAAC,CAAC,EAC3B,CAAC;YACA,IAAI,GAAG,GAAG,IAAA,aAAI,EAAC,GAAG,EAAE,CAAC,CAAC,CAAC;YAEvB,kDAAkD;YAClD,IAAI,CAAC,IAAA,qBAAU,EAAC,GAAG,CAAC,EACpB,CAAC;gBACA,IAAA,oBAAS,EAAC,GAAG,CAAC,CAAC;YAChB,CAAC;YAED,OAAO,IAAI,CAAC;QACb,CAAC;QAED,OAAO,IAAI,CAAC;IACb,CAAC,CAAC,CAAA;AACH,CAAC;AAED;;;GAGG;AACH,kBAAe,oBAAoB,CAAC","sourcesContent":["/**\n * 創建 Yarn Workspaces 工具模組\n * Yarn Workspaces Creation Tool Module\n *\n * 提供初始化 Yarn Workspaces 專案結構的功能，包含 package.json 設定、\n * Lerna 整合、目錄創建與靜態檔案複製等功能。\n * Provides functionality to initialize Yarn Workspaces project structure,\n * including package.json configuration, Lerna integration, directory creation,\n * and static file copying.\n *\n * @author user\n * @since 2018/5/13/013\n */\n\nimport findYarnWorkspaceRoot from 'find-yarn-workspace-root2/core';\nimport { resolve, join, basename } from 'upath2';\nimport pkgDir from 'pkg-dir';\nimport { consoleLogger as console } from 'debug-color2/logger';\nimport { copyStaticFiles } from '@yarn-tool/static-file';\nimport { existsSync, readFileSync, mkdirSync, writeFileSync } from 'fs-extra';\nimport { sortPackageJson } from 'sort-package-json3';\nimport { getDefaultPackageJson } from './lib';\nimport { isSamePath } from './lib/util';\nimport { ILernaJson } from '@ts-type/package-dts/lerna-json';\nimport { IPackageJson } from '@ts-type/package-dts/package-json';\nimport { getWsCopyStaticFiles } from '@yarn-tool/static-file/lib/ws/wsCopyStaticFiles';\nimport { findRootLazy } from '@yarn-tool/find-root';\nimport { normalize as pathNormalize } from 'upath2';\n\nexport * from './lib/index';\nexport * from './lib/util';\n\n/**\n * 創建 Workspaces 的選項介面\n * Interface for creating workspaces options\n */\nexport interface IOptions\n{\n\t/**\n\t * 工作目錄路徑 / Working directory path\n\t */\n\tcwd?: string,\n\n\t/**\n\t * 忽略父層 Workspaces / Ignore parent workspaces\n\t */\n\tignoreParentWorkspaces?: boolean,\n\n\t/**\n\t * 忽略已存在的 Package / Ignore existing package\n\t */\n\tignoreExistsPackage?: boolean,\n\n\t/**\n\t * 初始化 Package.json 的回呼函式\n\t * Callback function to initialize package.json\n\t * @template T - 擴展屬性類型 / Extended property type\n\t * @param current - 當前的 package.json / Current package.json\n\t * @returns 修改後的 package.json / Modified package.json\n\t */\n\tinitPackageJson?<T extends Record<string, any> = {}>(current: IPackageJson): IPackageJson & T,\n\n\t/**\n\t * 啟用除錯模式 / Enable debug mode\n\t */\n\tdebug?: boolean,\n}\n\n/**\n * 創建 Yarn Workspaces 主函式\n * Main function to create Yarn Workspaces\n *\n * 檢查並創建 Workspaces 專案結構，處理已存在 Package 與父層 Workspaces 的情況\n * Checks and creates workspace project structure, handling existing packages\n * and parent workspaces\n *\n * @param cwd - 工作目錄路徑 / Working directory path\n * @param options - 配置選項 / Configuration options\n * @returns 是否成功創建 / Whether creation was successful\n */\nexport function createYarnWorkspaces(cwd?: string, options: IOptions = {})\n{\n\t// 處理第一個參數可能是選項物件的情況\n\t// Handle case where first argument might be options object\n\tif (cwd && typeof cwd != 'string')\n\t{\n\t\toptions = cwd;\n\t\tcwd = options.cwd;\n\t}\n\n\t// 預設使用當前工作目錄 / Default to current working directory\n\tcwd ??= process.cwd();\n\n\t// 尋找專案根目錄資訊 / Find project root information\n\tconst rootData = findRootLazy({\n\t\tcwd,\n\t});\n\n\t// 標準化路徑 / Normalize path\n\tcwd = pathNormalize(rootData?.cwd ?? cwd);\n\n\t// 取得 Package 根目錄與 Workspaces 路徑\n\t// Get package root directory and workspace path\n\tlet root: string = rootData?.pkg;\n\tlet ws: string = rootData?.ws;\n\n\tlet targetPath = resolve(root || cwd);\n\n\t// 除錯輸出 / Debug output\n\toptions.debug && console.debug({\n\t\ttargetPath,\n\t\tws,\n\t\toptions,\n\t});\n\n\t/**\n\t * 檢查是否已存在 Package\n\t * Check if package already exists\n\t */\n\tif (!options.ignoreExistsPackage && root)\n\t{\n\t\tconsole.error(`already have package at \"${root}\", or use ignoreExistsPackage for overwrite it`);\n\n\t\treturn false;\n\t}\n\telse if (root)\n\t{\n\t\t// 忽略已存在的 Package / Ignore existing package\n\t\tconsole.warn(`ignore exists package \"${root}\"`);\n\t}\n\n\t/**\n\t * 檢查是否已存在 Workspaces\n\t * Check if workspace already exists\n\t */\n\tif (ws)\n\t{\n\t\t// 檢查目標路徑是否與現有 Workspace 相同\n\t\t// Check if target path is same as existing workspace\n\t\tlet bool: boolean = !isSamePath(targetPath, ws);\n\n\t\tconsole.warn(`detect exists workspace \"${ws}\"`);\n\n\t\tif (bool)\n\t\t{\n\t\t\t// 根據選項決定是否忽略父層 Workspaces\n\t\t\t// Decide whether to ignore parent workspaces based on options\n\t\t\tif (options.ignoreParentWorkspaces)\n\t\t\t{\n\t\t\t\tconsole.warn(`ignoreParentWorkspaces = true`);\n\t\t\t\tbool = false;\n\t\t\t}\n\t\t\telse\n\t\t\t{\n\t\t\t\tconsole.error(`target path already is workspace`);\n\t\t\t}\n\t\t}\n\n\t\tif (bool)\n\t\t{\n\t\t\treturn false;\n\t\t}\n\t}\n\n\treturn _createYarnWorkspaces(targetPath);\n}\n\n/**\n * 內部創建 Workspaces 實作函式\n * Internal implementation function for creating workspaces\n *\n * 執行實際的 Workspaces 初始化工作，包含：\n * - 讀取並更新 Lerna 配置\n * - 創建或更新 package.json\n * - 複製靜態範本檔案\n * - 創建 packages 目錄\n *\n * Performs actual workspace initialization including:\n * - Reading and updating Lerna configuration\n * - Creating or updating package.json\n * - Copying static template files\n * - Creating packages directory\n *\n * @param targetPath - 目標路徑 / Target path\n * @param options - 配置選項 / Configuration options\n * @returns 是否成功 / Whether successful\n */\nexport function _createYarnWorkspaces(targetPath: string, options: IOptions = {})\n{\n\tconsole.info(`create in target path \"${targetPath}\"`);\n\n\tlet pkg: IPackageJson;\n\n\tlet lerna: ILernaJson;\n\n\t/**\n\t * 嘗試讀取現有的 lerna.json 配置\n\t * Try to read existing lerna.json configuration\n\t */\n\t{\n\t\tlet file = join(targetPath, 'lerna.json');\n\n\t\tif (existsSync(file))\n\t\t{\n\t\t\tlet json: ILernaJson = JSON.parse(readFileSync(file).toString());\n\n\t\t\t/**\n\t\t\t * 清理空的 packages 陣列\n\t\t\t * Clean up empty packages array\n\t\t\t */\n\t\t\tif (json.packages && !Object.keys(json.packages).length)\n\t\t\t{\n\t\t\t\tjson.packages = undefined;\n\t\t\t}\n\n\t\t\tlerna = json;\n\t\t}\n\t}\n\n\t/**\n\t * 預設 packages 目錄模式\n\t * Default packages directory pattern\n\t */\n\tlet packages = lerna && lerna.packages || [\n\t\t\"packages/*\",\n\t];\n\n\tlet file = join(targetPath, 'package.json');\n\n\t/**\n\t * 處理 package.json 不存在的情況\n\t * Handle case when package.json does not exist\n\t */\n\tif (!existsSync(file))\n\t{\n\t\t// 使用目錄名作為預設 Package 名稱\n\t\t// Use directory name as default package name\n\t\tlet name = basename(targetPath);\n\n\t\t// 創建目標目錄（如果不存在）\n\t\t// Create target directory if it doesn't exist\n\t\tif (!existsSync(targetPath))\n\t\t{\n\t\t\tmkdirSync(targetPath);\n\t\t}\n\n\t\t// 合併預設配置與基本資訊\n\t\t// Merge default configuration with basic info\n\t\tpkg = Object.assign(getDefaultPackageJson(name), {\n\t\t\tname,\n\t\t\tworkspaces: packages,\n\t\t});\n\n\t\t/**\n\t\t * 執行自定義初始化回呼\n\t\t * Execute custom initialization callback\n\t\t */\n\t\tif (options.initPackageJson)\n\t\t{\n\t\t\tlet ret = options.initPackageJson(pkg);\n\n\t\t\tif (ret)\n\t\t\t{\n\t\t\t\tpkg = ret;\n\t\t\t}\n\t\t}\n\t}\n\telse\n\t{\n\t\t/**\n\t\t * 處理已存在的 package.json\n\t\t * Handle existing package.json\n\t\t */\n\t\tlet json: IPackageJson = JSON.parse(readFileSync(file).toString());\n\n\t\tlet workspaces: ILernaJson['packages'];\n\n\t\t/**\n\t\t * 解析現有的 workspaces 配置\n\t\t * Parse existing workspaces configuration\n\t\t */\n\t\tif (json.workspaces && Object.keys(json.workspaces).length)\n\t\t{\n\t\t\tworkspaces = json.workspaces;\n\n\t\t\t/**\n\t\t\t * 支援 nohoist 配置格式\n\t\t\t * Support nohoist configuration format\n\t\t\t * @see https://yarnpkg.com/blog/2018/02/15/nohoist/\n\t\t\t */\n\t\t\t// @ts-ignore\n\t\t\tpackages = workspaces.packages || workspaces;\n\t\t}\n\t\telse\n\t\t{\n\t\t\tworkspaces = packages;\n\t\t}\n\n\t\t/**\n\t\t * 更新 Package.json 內容\n\t\t * Update package.json content\n\t\t */\n\t\tpkg = Object.assign(json, {\n\t\t\t\"private\": true,\n\t\t\t\"workspaces\": workspaces,\n\t\t});\n\n\t\t// 初始化 resolutions 欄位 / Initialize resolutions field\n\t\tpkg.resolutions = pkg.resolutions || {};\n\n\t\t/**\n\t\t * 合併預設腳本與欄位\n\t\t * Merge default scripts and fields\n\t\t */\n\t\tObject.entries(getDefaultPackageJson(json.name))\n\t\t\t.forEach(([field, value]) => {\n\n\t\t\t\t/**\n\t\t\t\t * 特殊處理 scripts 欄位：合併而非覆蓋\n\t\t\t\t * Special handling for scripts field: merge instead of overwrite\n\t\t\t\t */\n\t\t\t\tif (field === 'scripts')\n\t\t\t\t{\n\t\t\t\t\tpkg.scripts ??= {};\n\t\t\t\t\tpkg.scripts = {\n\t\t\t\t\t\t// @ts-ignore\n\t\t\t\t\t\t...value,\n\t\t\t\t\t\t...pkg.scripts,\n\t\t\t\t\t}\n\t\t\t\t}\n\t\t\t\telse\n\t\t\t\t{\n\t\t\t\t\t// 使用空值合併運算子設置預設值\n\t\t\t\t\t// Use nullish coalescing operator for default values\n\t\t\t\t\tpkg[field] ??= value\n\t\t\t\t}\n\n\t\t\t})\n\t\t;\n\n\t}\n\n\t/**\n\t * 寫入格式化後的 package.json\n\t * Write formatted package.json\n\t */\n\tlet s = JSON.stringify(sortPackageJson(pkg), null, 2);\n\twriteFileSync(file, s);\n\n\tconsole.success(`create workspace package.json`);\n\n\t/**\n\t * 更新 Lerna 配置（如果存在且需要更新）\n\t * Update Lerna configuration if exists and needs updating\n\t */\n\tif (lerna && (packages != lerna.packages || lerna.npmClient !== 'yarn' || lerna['useWorkspaces'] !== true))\n\t{\n\t\tlet file = join(targetPath, 'lerna.json');\n\n\t\t// 更新為 Yarn Workspaces 模式\n\t\t// Update to Yarn Workspaces mode\n\t\tlerna.packages = packages;\n\t\tlerna.npmClient = 'yarn';\n\t\tlerna['useWorkspaces'] = true;\n\n\t\tlet s = JSON.stringify(sortPackageJson(lerna), null, 2);\n\t\twriteFileSync(file, s);\n\n\t\tconsole.info(`update lerna.json`);\n\t}\n\n\t/**\n\t * 複製靜態範本檔案\n\t * Copy static template files\n\t */\n\tconst file_map = getWsCopyStaticFiles();\n\n\tcopyStaticFiles({\n\t\tcwd: targetPath,\n\t\tfile_map,\n\t});\n\n\t/**\n\t * 根據 packages 模式創建目錄\n\t * Create directories based on packages pattern\n\t */\n\tcreateDirByPackages(targetPath, packages);\n\n\treturn true;\n}\n\n/**\n * 根據 packages 模式創建目錄\n * Create directories based on packages pattern\n *\n * 解析 packages 陣列中的目錄模式（如 \"packages/*\"），\n * 並創建對應的實體目錄。\n * Parses directory patterns from packages array (e.g., \"packages/*\")\n * and creates corresponding physical directories.\n *\n * @param cwd - 當前工作目錄 / Current working directory\n * @param packages - packages 模式陣列 / Array of package patterns\n * @returns 是否有創建任何目錄 / Whether any directories were created\n */\nexport function createDirByPackages(cwd: string, packages: string[])\n{\n\treturn packages.some(function (value)\n\t{\n\t\tlet bool: boolean;\n\n\t\t// 提取路徑的第一個部分（目錄名稱）\n\t\t// Extract first part of path (directory name)\n\t\tlet s = value.split(/[\\/\\\\]/)[0];\n\n\t\t/**\n\t\t * 只處理不包含 glob 模式的純目錄路徑\n\t\t * Only handle pure directory paths without glob patterns\n\t\t */\n\t\tif (!/[!?\\*{}\\[\\]]/.test(s))\n\t\t{\n\t\t\tlet dir = join(cwd, s);\n\n\t\t\t// 目錄不存在時創建 / Create directory if it doesn't exist\n\t\t\tif (!existsSync(dir))\n\t\t\t{\n\t\t\t\tmkdirSync(dir);\n\t\t\t}\n\n\t\t\treturn true;\n\t\t}\n\n\t\treturn bool;\n\t})\n}\n\n/**\n * 預設導出創建函式\n * Default export of creation function\n */\nexport default createYarnWorkspaces;\n"]}

package/lib/package.demo.json

@@ -6,8 +6,8 @@
   "devDependencies": {
     "@bluelovers/tsconfig": "^1.0.35",
     "@types/jest": "^30.0.0",
-    "@types/node": "^24.3.1",
-    "@yarn-tool/ws-find-up-paths": "^1.0.13"
+    "@types/node": "^25.3.3",
+    "@yarn-tool/ws-find-up-paths": "^1.0.14"
   },
   "peerDependencies": {
     "@bluelovers/conventional-changelog-bluelovers": "*",

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "create-yarn-workspaces",
-  "version": "3.0.4",
+  "version": "3.0.5",
   "description": "yarn create yarn-workspaces     npx create-yarn-workspaces",
   "keywords": [
     "cli",
@@ -53,21 +53,20 @@
     "tsc:esm": "tsc -p tsconfig.esm.json",
     "tsc:showConfig": "ynpx get-current-tsconfig -p"
   },
-  "resolutions": {},
   "dependencies": {
     "@ts-type/package-dts": "^2.0.8",
-    "@yarn-tool/find-root": "^2.0.15",
-    "@yarn-tool/pkg-entry-util": "^3.0.3",
-    "@yarn-tool/static-file": "^3.0.4",
+    "@yarn-tool/find-root": "^2.0.16",
+    "@yarn-tool/pkg-entry-util": "^3.0.4",
+    "@yarn-tool/static-file": "^3.0.5",
     "debug-color2": "^1.3.2",
-    "find-yarn-workspace-root2": "^1.2.51",
-    "fs-extra": "^11.2.0",
-    "path-is-same": "^1.0.25",
+    "find-yarn-workspace-root2": "^1.2.52",
+    "fs-extra": "^11.3.3",
+    "path-is-same": "^1.0.29",
     "pkg-dir": "<6 >=5",
-    "sort-package-json3": "^3.0.3",
+    "sort-package-json3": "^3.0.4",
     "tslib": ">=2",
-    "upath2": "^3.1.19",
-    "yargs": "^17.7.2"
+    "upath2": "^3.1.23",
+    "yargs": "<18 >=17.7.2"
   },
-  "gitHead": "ca7f14bdac1827ed8e8fe5fd0932ee56a44669dc"
+  "gitHead": "ae9b0817b25b1019ba68c88e541bbffc7d84047c"
 }

package/yargs-setting.d.ts

@@ -1,8 +1,36 @@
 /**
- * Created by user on 2019/5/16.
+ * Yargs 命令列參數設定模組
+ * Yargs Command Line Arguments Configuration Module
+ *
+ * 提供 Workspaces 初始化相關的命令列參數設定與驗證
+ * Provides command line argument configuration and validation for
+ * workspace initialization
+ *
+ * @author user
+ * @since 2019/5/16
  */
 import yargs from 'yargs';
 import { Argv } from 'yargs';
+/**
+ * 設定 Workspaces 初始化相關的 Yargs 選項
+ * Setup Yargs options for workspaces initialization
+ *
+ * 配置命令列參數，包含：
+ * - name: Package 名稱
+ * - ignoreExistsPackage: 忽略已存在的 Package
+ * - ignoreParentWorkspaces: 忽略父層 Workspaces
+ * - debug: 啟用除錯模式
+ *
+ * Configures command line arguments including:
+ * - name: Package name
+ * - ignoreExistsPackage: Ignore existing package
+ * - ignoreParentWorkspaces: Ignore parent workspaces
+ * - debug: Enable debug mode
+ *
+ * @template T - Yargs 參數類型 / Yargs argument type
+ * @param yargs - Yargs 實例 / Yargs instance
+ * @returns 配置後的 Yargs 實例 / Configured Yargs instance
+ */
 export declare function setupWorkspacesInitToYargs<T extends any>(yargs: Argv<T>): yargs.Argv<yargs.Omit<T, never> & {
     name: string;
 } & {
@@ -12,4 +40,8 @@ export declare function setupWorkspacesInitToYargs<T extends any>(yargs: Argv<T>
 } & {
     debug: boolean;
 }>;
+/**
+ * 預設導出設定函式
+ * Default export of setup function
+ */
 export default setupWorkspacesInitToYargs;

package/yargs-setting.js

@@ -1,30 +1,78 @@
 "use strict";
 /**
- * Created by user on 2019/5/16.
+ * Yargs 命令列參數設定模組
+ * Yargs Command Line Arguments Configuration Module
+ *
+ * 提供 Workspaces 初始化相關的命令列參數設定與驗證
+ * Provides command line argument configuration and validation for
+ * workspace initialization
+ *
+ * @author user
+ * @since 2019/5/16
  */
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.setupWorkspacesInitToYargs = setupWorkspacesInitToYargs;
+/**
+ * 設定 Workspaces 初始化相關的 Yargs 選項
+ * Setup Yargs options for workspaces initialization
+ *
+ * 配置命令列參數，包含：
+ * - name: Package 名稱
+ * - ignoreExistsPackage: 忽略已存在的 Package
+ * - ignoreParentWorkspaces: 忽略父層 Workspaces
+ * - debug: 啟用除錯模式
+ *
+ * Configures command line arguments including:
+ * - name: Package name
+ * - ignoreExistsPackage: Ignore existing package
+ * - ignoreParentWorkspaces: Ignore parent workspaces
+ * - debug: Enable debug mode
+ *
+ * @template T - Yargs 參數類型 / Yargs argument type
+ * @param yargs - Yargs 實例 / Yargs instance
+ * @returns 配置後的 Yargs 實例 / Configured Yargs instance
+ */
 function setupWorkspacesInitToYargs(yargs) {
     return yargs
         .default({
     //input: process.cwd(),
     })
+        /**
+         * Package 名稱選項
+         * Package name option
+         */
         .option('name', {
         alias: ['n'],
         requiresArg: true,
         normalize: true,
         type: 'string',
     })
+        /**
+         * 忽略已存在 Package 選項
+         * Ignore existing package option
+         */
         .option('ignoreExistsPackage', {
         boolean: true,
         alias: ['i'],
     })
+        /**
+         * 忽略父層 Workspaces 選項
+         * Ignore parent workspaces option
+         */
         .option('ignoreParentWorkspaces', {
         boolean: true,
     })
+        /**
+         * 除錯模式選項
+         * Debug mode option
+         */
         .option('debug', {
         boolean: true,
     });
 }
+/**
+ * 預設導出設定函式
+ * Default export of setup function
+ */
 exports.default = setupWorkspacesInitToYargs;
 //# sourceMappingURL=yargs-setting.js.map

package/yargs-setting.js.map

@@ -1 +1 @@
-{"version":3,"file":"yargs-setting.js","sourceRoot":"","sources":["yargs-setting.ts"],"names":[],"mappings":";AAAA;;GAEG;;AAKH,gEAuBC;AAvBD,SAAgB,0BAA0B,CAAgB,KAAc;IAEvE,OAAO,KAAK;SACV,OAAO,CAAC;IACR,uBAAuB;KACvB,CAAC;SACD,MAAM,CAAC,MAAM,EAAE;QACf,KAAK,EAAE,CAAC,GAAG,CAAC;QACZ,WAAW,EAAE,IAAI;QACjB,SAAS,EAAE,IAAI;QACf,IAAI,EAAE,QAAQ;KACd,CAAC;SACD,MAAM,CAAC,qBAAqB,EAAE;QAC9B,OAAO,EAAE,IAAI;QACb,KAAK,EAAE,CAAC,GAAG,CAAC;KACZ,CAAC;SACD,MAAM,CAAC,wBAAwB,EAAE;QACjC,OAAO,EAAE,IAAI;KACb,CAAC;SACD,MAAM,CAAC,OAAO,EAAE;QAChB,OAAO,EAAE,IAAI;KACb,CAAC,CACF;AACF,CAAC;AAED,kBAAe,0BAA0B,CAAA","sourcesContent":["/**\n * Created by user on 2019/5/16.\n */\n\nimport yargs from 'yargs';\nimport { Argv, Omit } from 'yargs';\n\nexport function setupWorkspacesInitToYargs<T extends any>(yargs: Argv<T>)\n{\n\treturn yargs\n\t\t.default({\n\t\t\t//input: process.cwd(),\n\t\t})\n\t\t.option('name', {\n\t\t\talias: ['n'],\n\t\t\trequiresArg: true,\n\t\t\tnormalize: true,\n\t\t\ttype: 'string',\n\t\t})\n\t\t.option('ignoreExistsPackage', {\n\t\t\tboolean: true,\n\t\t\talias: ['i'],\n\t\t})\n\t\t.option('ignoreParentWorkspaces', {\n\t\t\tboolean: true,\n\t\t})\n\t\t.option('debug', {\n\t\t\tboolean: true,\n\t\t})\n\t;\n}\n\nexport default setupWorkspacesInitToYargs\n"]}
+{"version":3,"file":"yargs-setting.js","sourceRoot":"","sources":["yargs-setting.ts"],"names":[],"mappings":";AAAA;;;;;;;;;;GAUG;;AAyBH,gEAuCC;AA3DD;;;;;;;;;;;;;;;;;;;GAmBG;AACH,SAAgB,0BAA0B,CAAgB,KAAc;IAEvE,OAAO,KAAK;SACV,OAAO,CAAC;IACR,uBAAuB;KACvB,CAAC;QACF;;;WAGG;SACF,MAAM,CAAC,MAAM,EAAE;QACf,KAAK,EAAE,CAAC,GAAG,CAAC;QACZ,WAAW,EAAE,IAAI;QACjB,SAAS,EAAE,IAAI;QACf,IAAI,EAAE,QAAQ;KACd,CAAC;QACF;;;WAGG;SACF,MAAM,CAAC,qBAAqB,EAAE;QAC9B,OAAO,EAAE,IAAI;QACb,KAAK,EAAE,CAAC,GAAG,CAAC;KACZ,CAAC;QACF;;;WAGG;SACF,MAAM,CAAC,wBAAwB,EAAE;QACjC,OAAO,EAAE,IAAI;KACb,CAAC;QACF;;;WAGG;SACF,MAAM,CAAC,OAAO,EAAE;QAChB,OAAO,EAAE,IAAI;KACb,CAAC,CACF;AACF,CAAC;AAED;;;GAGG;AACH,kBAAe,0BAA0B,CAAA","sourcesContent":["/**\n * Yargs 命令列參數設定模組\n * Yargs Command Line Arguments Configuration Module\n * \n * 提供 Workspaces 初始化相關的命令列參數設定與驗證\n * Provides command line argument configuration and validation for\n * workspace initialization\n * \n * @author user\n * @since 2019/5/16\n */\n\nimport yargs from 'yargs';\nimport { Argv, Omit } from 'yargs';\n\n/**\n * 設定 Workspaces 初始化相關的 Yargs 選項\n * Setup Yargs options for workspaces initialization\n * \n * 配置命令列參數，包含：\n * - name: Package 名稱\n * - ignoreExistsPackage: 忽略已存在的 Package\n * - ignoreParentWorkspaces: 忽略父層 Workspaces\n * - debug: 啟用除錯模式\n * \n * Configures command line arguments including:\n * - name: Package name\n * - ignoreExistsPackage: Ignore existing package\n * - ignoreParentWorkspaces: Ignore parent workspaces\n * - debug: Enable debug mode\n * \n * @template T - Yargs 參數類型 / Yargs argument type\n * @param yargs - Yargs 實例 / Yargs instance\n * @returns 配置後的 Yargs 實例 / Configured Yargs instance\n */\nexport function setupWorkspacesInitToYargs<T extends any>(yargs: Argv<T>)\n{\n\treturn yargs\n\t\t.default({\n\t\t\t//input: process.cwd(),\n\t\t})\n\t\t/**\n\t\t * Package 名稱選項\n\t\t * Package name option\n\t\t */\n\t\t.option('name', {\n\t\t\talias: ['n'],\n\t\t\trequiresArg: true,\n\t\t\tnormalize: true,\n\t\t\ttype: 'string',\n\t\t})\n\t\t/**\n\t\t * 忽略已存在 Package 選項\n\t\t * Ignore existing package option\n\t\t */\n\t\t.option('ignoreExistsPackage', {\n\t\t\tboolean: true,\n\t\t\talias: ['i'],\n\t\t})\n\t\t/**\n\t\t * 忽略父層 Workspaces 選項\n\t\t * Ignore parent workspaces option\n\t\t */\n\t\t.option('ignoreParentWorkspaces', {\n\t\t\tboolean: true,\n\t\t})\n\t\t/**\n\t\t * 除錯模式選項\n\t\t * Debug mode option\n\t\t */\n\t\t.option('debug', {\n\t\t\tboolean: true,\n\t\t})\n\t;\n}\n\n/**\n * 預設導出設定函式\n * Default export of setup function\n */\nexport default setupWorkspacesInitToYargs\n"]}