create-yarn-workspaces 3.0.35 → 3.0.36

package/CHANGELOG.md

@@ -3,6 +3,44 @@
 All notable changes to this project will be documented in this file.
 See [Conventional Commits](https://conventionalcommits.org) for commit guidelines.
 
+## [3.0.36](https://github.com/bluelovers/ws-yarn-workspaces/compare/create-yarn-workspaces@3.0.35...create-yarn-workspaces@3.0.36) (2026-11-06)
+
+
+### BREAKING CHANGES
+
+* **create-yarn-workspaces:** 重構核心邏輯並支援非同步互動式介面
+
+
+
+### 🐛　Bug Fixes
+
+* **create-yarn-workspaces:** 增加對依賴欄位存在性的檢查 ([c5d6f10](https://github.com/bluelovers/ws-yarn-workspaces/commit/c5d6f10cdfd5cd5bc4d8111b365ec567a9a03ea0))
+
+
+### 📦　Code Refactoring
+
+* **create-yarn-workspaces:** 重構核心邏輯並支援非同步互動式介面 ([633c02b](https://github.com/bluelovers/ws-yarn-workspaces/commit/633c02b4e217001186e3db897621977c815bac44))
+
+
+### 📚　Documentation
+
+* **create-yarn-workspaces:** 更新文件以反映支援 pnpm 與非同步 API ([d3824db](https://github.com/bluelovers/ws-yarn-workspaces/commit/d3824db408860e0c8d4f1933361ab95a2e90451d))
+
+
+### 🛠　Build System
+
+* update build ([1e395f4](https://github.com/bluelovers/ws-yarn-workspaces/commit/1e395f4228f1464fb1acd2efd6f7dc59972f76a0))
+* **cache:** update cache-versions ([798cb57](https://github.com/bluelovers/ws-yarn-workspaces/commit/798cb57268e8cf4c795056a4fe603be0b4234216))
+* **create-yarn-workspaces:** 模組化核心邏輯並實作非同步互動式 CLI ([369a841](https://github.com/bluelovers/ws-yarn-workspaces/commit/369a841963fccc62e3397a0952f0a5aa7246b2c6))
+
+
+### 🔖　Miscellaneous
+
+* . ([c7d0081](https://github.com/bluelovers/ws-yarn-workspaces/commit/c7d00810006d688b18c2eb18f9324356fc40a19b))
+* . ([74f772c](https://github.com/bluelovers/ws-yarn-workspaces/commit/74f772ca4b956e32cb9e7f04a6ba186f0ab5127a))
+
+
+
 ## [3.0.35](https://github.com/bluelovers/ws-yarn-workspaces/compare/create-yarn-workspaces@3.0.34...create-yarn-workspaces@3.0.35) (2026-11-03)
 
 

package/README.md

@@ -1,15 +1,20 @@
 # create-yarn-workspaces
 
-> 快速初始化 Yarn Workspaces 專案結構 / Quickly initialize Yarn Workspaces project structure
+> 快速初始化 Workspaces 專案結構（Yarn / pnpm 相容）/ Quickly initialize Workspaces project structure (Yarn / pnpm compatible)
 
-一鍵建立 Yarn Workspaces（工作區）專案骨架，自動處理 package.json、Lerna 設定與 packages 目錄。
+一鍵建立 Workspaces（工作區）專案骨架，自動處理 package.json、Lerna 設定與 packages 目錄。
+
+已不再專用於 Yarn：產生的專案同時相容 pnpm，且更新 `lerna.json` 時會將 `npmClient` 預設為 `pnpm`。
+No longer Yarn-only: the generated project is also pnpm-compatible, and `lerna.json` `npmClient` defaults to `pnpm`.
 
 ## 功能特性 / Features
 
-- 🚀 **快速初始化** - 一鍵創建完整的 Yarn Workspaces 專案結構
-- 📦 **Lerna 整合** - 自動檢測並更新現有的 Lerna 配置
+- 🚀 **快速初始化** - 一鍵創建完整的 Workspaces 專案結構
+- 🧩 **Yarn / pnpm 相容** - 已非 Yarn 專用，同時建立 pnpm 相容的 Workspaces 設定
+- 📦 **Lerna 整合** - 自動檢測並更新現有的 Lerna 配置，`npmClient` 預設為 `pnpm`
 - 📝 **智能設定** - 自動配置 package.json、tsconfig 等開發環境檔案
 - 🔧 **靈活選項** - 支援自定義初始化回呼與多種配置選項
+- 🖥️ **互動介面** - CLI 預設啟用互動確認，無 TTY 時自動退回警告（`--no-interactive` 可關閉）
 - 🗂️ **目錄管理** - 根據 workspaces 配置自動創建 packages 目錄
 
 ## 安裝 / Installation
@@ -38,6 +43,9 @@ yarn create yarn-workspaces my-project
 
 # 忽略已存在的 Package 並覆寫
 yarn create yarn-workspaces --ignoreExistsPackage
+
+# 關閉互動確認 / Disable interactive confirm
+yarn create yarn-workspaces --no-interactive
 ```
 
 命令列選項 / CLI Options：
@@ -48,13 +56,14 @@ yarn create yarn-workspaces --ignoreExistsPackage
 | `--ignoreExistsPackage` | `-i` | 忽略已存在的 Package / Ignore existing package |
 | `--ignoreParentWorkspaces` | | 忽略父層 Workspaces / Ignore parent workspaces |
 | `--debug` | | 啟用除錯模式 / Enable debug mode |
+| `--interactive` | | 互動介面（預設啟用，`--no-interactive` 關閉；無 TTY 時退回警告）/ Interactive mode (enabled by default, disable with `--no-interactive`; falls back to a warning without a TTY) |
 
 初始化後的專案結構 / Project structure after initialization:
 
 ```
 my-project/
 ├── package.json          # Workspaces 配置 / Workspaces config
-├── lerna.json           # Lerna 配置（如果存在）/ Lerna config (if exists)
+├── lerna.json           # Lerna 配置（如果存在；npmClient 預設 pnpm）/ Lerna config (if exists; npmClient defaults to pnpm)
 ├── tsconfig.json        # TypeScript 配置 / TypeScript config
 ├── .gitignore           # Git 忽略規則 / Git ignore rules
 ├── .eslintrc.json       # ESLint 配置 / ESLint config
@@ -65,31 +74,44 @@ my-project/
 ## API 文件 / API Documentation
 
 ```typescript
-import { createYarnWorkspaces, IOptions } from 'create-yarn-workspaces';
+import { createYarnWorkspacesAsync, IOptions } from 'create-yarn-workspaces';
 
 // 基本使用 / Basic usage
-const success = createYarnWorkspaces('./my-project');
+const success = await createYarnWorkspacesAsync('./my-project');
 
 // 帶選項 / With options
 const options: IOptions = {
   ignoreExistsPackage: true,
   ignoreParentWorkspaces: false,
+  interactive: true,
   initPackageJson: (pkg) => {
     pkg.author = 'Your Name';
     return pkg;
   }
 };
 
-createYarnWorkspaces('./my-project', options);
+await createYarnWorkspacesAsync('./my-project', options);
 ```
 
-### `createYarnWorkspaces(cwd?, options?)`
+### `createYarnWorkspacesAsync(cwd?, options?)`
 
-建立 Workspaces 專案結構的主要函式 / Main function that creates the workspace project structure.
+建立 Workspaces 專案結構的主要函式（非同步）/ Main async function that creates the workspace project structure.
 
 - `cwd?: string | IOptions` — 目標目錄；也可直接傳入選項物件 / Target directory; an options object may be passed directly as the first argument.
 - `options?: IOptions` — 配置選項 / Configuration options.
-- 回傳 `boolean` — 是否成功建立 / Whether creation succeeded.
+- 回傳 `Promise<boolean>` — 是否成功建立；使用者於互動介面取消時為 `false` / Whether creation succeeded; `false` when the user cancels the interactive prompt.
+
+當 `options.interactive` 啟用且環境具備 TTY 時，若環境檢查發現疑似在錯誤路徑執行（目錄或子目錄已存在 package.json），會透過互動介面詢問是否繼續；未啟用互動介面（或不具備 TTY）時僅印出警告並繼續執行。
+When `options.interactive` is enabled and a TTY is available, a suspicious path detected by the environment check (an existing `package.json` in the directory or its subdirectories) triggers an interactive confirm prompt; otherwise a warning is printed and execution continues.
+
+### `createYarnWorkspaces(cwd?, options?)` — `@deprecated`
+
+**已棄用 / Deprecated**：請改用 `createYarnWorkspacesAsync` / Please use `createYarnWorkspacesAsync` instead.
+
+同步版本不支援互動介面，發現疑似錯誤路徑時僅印出警告並繼續執行。
+The synchronous version does not support the interactive prompt; it only prints a warning and continues.
+
+- 參數與回傳值同 `createYarnWorkspacesAsync`（回傳 `boolean`）/ Same parameters and return value as `createYarnWorkspacesAsync` (returns `boolean`).
 
 其他匯出 / Also exported: `createDirByPackages(cwd, packages)`、`getDefaultPackageJson(name?)`、`getDefaultTsconfig()`、`setupWorkspacesInitToYargs(yargs)`。
 
@@ -104,6 +126,7 @@ createYarnWorkspaces('./my-project', options);
 | `ignoreParentWorkspaces` | `boolean` | `false` | 忽略父層 Workspaces / Ignore parent workspaces |
 | `initPackageJson` | `(pkg) => pkg` | — | 自定義 package.json 初始化回呼 / Custom package.json init callback |
 | `debug` | `boolean` | `false` | 啟用除錯輸出 / Enable debug output |
+| `interactive` | `boolean` | `false`（CLI 為 `true`）/ `false` (`true` in CLI) | 啟用互動詢問，僅 `createYarnWorkspacesAsync` 支援，需 TTY / Enable the interactive prompt; `createYarnWorkspacesAsync` only, requires a TTY |
 | `addStaticFiles` | `boolean` | `true` | 自動加入靜態範本檔案 / Auto-add static template files |
 | `noStaticFiles` | `boolean` | `false` | 略過靜態檔案（優先於 `addStaticFiles`）/ Skip static files (takes precedence over `addStaticFiles`) |
 

package/bin/yarn-ws-init.js

@@ -2,29 +2,27 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 const tslib_1 = require("tslib");
-const __1 = tslib_1.__importDefault(require(".."));
+const __1 = require("..");
 const logger_1 = tslib_1.__importDefault(require("debug-color2/logger"));
 const yargs_1 = tslib_1.__importDefault(require("yargs"));
 const path_1 = require("path");
 const yargs_setting_1 = tslib_1.__importDefault(require("../yargs-setting"));
 /**
  * CLI 一律以呼叫當下的 shell 目錄作為基準路徑。
- * The CLI always uses the invoking shell's directory as the base path.
  */
 const CWD = process.cwd();
 /**
- * CLI 入口：解析參數後呼叫 createYarnWorkspaces，失敗時印出說明。
- * CLI entry: parse arguments, call `createYarnWorkspaces`, and print help on failure.
+ * CLI 入口：解析參數後呼叫 createYarnWorkspacesAsync，失敗時印出說明。
+ *
+ * 以 async handler 搭配 parseAsync，確保互動介面（@clack/prompts）完成後才結束流程。
  */
 let cli = (0, yargs_setting_1.default)(yargs_1.default)
     // @ts-ignore
-    .command('$0', '', function (yargs) {
+    .command('$0', '', async function (yargs) {
+    /** 優先採用 --name，否則取第一個位置參數作為目標資料夾名稱。 */
     // @ts-ignore
-    // 優先採用 --name，否則取第一個位置參數作為目標資料夾名稱。
-    // Prefer `--name`; otherwise take the first positional argument as the target folder name.
     let name = (yargs.argv.name || yargs.argv._[0]);
-    // 未指定名稱時就地初始化（以 CWD 為目標）。
-    // When no name is given, initialize in place (target = `CWD`).
+    /** 未指定名稱時就地初始化（以 CWD 為目標）。 */
     if (name) {
         name = (0, path_1.join)(CWD, name);
     }
@@ -34,17 +32,22 @@ let cli = (0, yargs_setting_1.default)(yargs_1.default)
     //console.log(CWD, yargs.argv);
     // @ts-ignore
     yargs.argv.debug && logger_1.default.debug(yargs.argv);
-    // 布林參數以 !! 強制轉型；靜態檔案相關選項刻意保留原始值，讓 addStaticFiles 維持預設 true。
-    // Coerce booleans with `!!`; static-file options are intentionally passed through untouched so `addStaticFiles` keeps its default of `true`.
-    let bool = (0, __1.default)(name, {
+    /** 布林參數以 !! 強制轉型；靜態檔案相關選項刻意保留原始值，讓 addStaticFiles 維持預設 true。 */
+    let bool = await (0, __1.createYarnWorkspacesAsync)(name, {
         // @ts-ignore
         ignoreExistsPackage: !!yargs.argv.ignoreExistsPackage,
         // @ts-ignore
         ignoreParentWorkspaces: !!yargs.argv.ignoreParentWorkspaces,
+        /**
+         * 互動介面預設啟用（yargs default: true），可用 --no-interactive 關閉；
+         * 無 TTY 時於 async 版本內自動退回警告。
+         */
+        // @ts-ignore
+        interactive: !!yargs.argv.interactive,
         // @ts-ignore
         debug: !!yargs.argv.debug,
         /*
-         * 保留 undefined，讓 addStaticFiles 維持預設 true / Keep undefined so addStaticFiles keeps its default of true
+         * 保留 undefined，讓 addStaticFiles 維持預設 true
          * */
         // @ts-ignore
         addStaticFiles: yargs.argv.addStaticFiles,
@@ -54,8 +57,7 @@ let cli = (0, yargs_setting_1.default)(yargs_1.default)
         resetStaticFiles: yargs.argv.resetStaticFiles,
     });
     //console.log(77777777777, bool);
-    // 回傳 false 代表前置檢查失敗（如已存在 Package），此時顯示說明協助使用者修正參數。
-    // A `false` return means a pre-check failed (e.g. package already exists), so show help to guide the user.
+    /** 回傳 false 代表前置檢查失敗（如已存在 Package）或使用者於互動介面取消，此時顯示說明協助使用者修正參數。 */
     if (!bool) {
         console.log('\n');
         yargs.showHelp();
@@ -66,5 +68,5 @@ let cli = (0, yargs_setting_1.default)(yargs_1.default)
 })
     .version()
     .help()
-    .argv;
+    .parseAsync();
 //# sourceMappingURL=yarn-ws-init.js.map

package/bin/yarn-ws-init.js.map

@@ -1 +1 @@
-{"version":3,"file":"yarn-ws-init.js","sourceRoot":"","sources":["yarn-ws-init.ts"],"names":[],"mappings":";;;;AAEA,mDAAsC;AACtC,yEAAwC;AACxC,0DAA0B;AAC1B,+BAA4B;AAC5B,6EAA0D;AAE1D;;;GAGG;AACH,MAAM,GAAG,GAAG,OAAO,CAAC,GAAG,EAAE,CAAC;AAE1B;;;GAGG;AACH,IAAI,GAAG,GAAG,IAAA,uBAA0B,EAAC,eAAK,CAAC;IAC1C,aAAa;KACZ,OAAO,CAAC,IAAI,EAAE,EAAE,EAAE,UAAU,KAAK;IAEjC,aAAa;IACb,mCAAmC;IACnC,2FAA2F;IAC3F,IAAI,IAAI,GAAG,CAAC,KAAK,CAAC,IAAI,CAAC,IAAI,IAAI,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC,CAAW,CAAC;IAE1D,0BAA0B;IAC1B,+DAA+D;IAC/D,IAAI,IAAI,EACR,CAAC;QACA,IAAI,GAAG,IAAA,WAAI,EAAC,GAAG,EAAE,IAAI,CAAC,CAAC;IACxB,CAAC;SAED,CAAC;QACA,IAAI,GAAG,GAAG,CAAC;IACZ,CAAC;IAED,+BAA+B;IAE/B,aAAa;IACb,KAAK,CAAC,IAAI,CAAC,KAAK,IAAI,gBAAK,CAAC,KAAK,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;IAE5C,4DAA4D;IAC5D,6IAA6I;IAC7I,IAAI,IAAI,GAAG,IAAA,WAAoB,EAAC,IAAI,EAAE;QACrC,aAAa;QACb,mBAAmB,EAAE,CAAC,CAAC,KAAK,CAAC,IAAI,CAAC,mBAAmB;QACrD,aAAa;QACb,sBAAsB,EAAE,CAAC,CAAC,KAAK,CAAC,IAAI,CAAC,sBAAsB;QAC3D,aAAa;QACb,KAAK,EAAE,CAAC,CAAC,KAAK,CAAC,IAAI,CAAC,KAAK;QACzB;;aAEK;QACL,aAAa;QACb,cAAc,EAAE,KAAK,CAAC,IAAI,CAAC,cAAc;QACzC,aAAa;QACb,aAAa,EAAE,KAAK,CAAC,IAAI,CAAC,aAAa;QACvC,aAAa;QACb,gBAAgB,EAAE,KAAK,CAAC,IAAI,CAAC,gBAAgB;KAC7C,CAAC,CAAC;IAEH,iCAAiC;IAEjC,mDAAmD;IACnD,2GAA2G;IAC3G,IAAI,CAAC,IAAI,EACT,CAAC;QACA,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;QAClB,KAAK,CAAC,QAAQ,EAAE,CAAC;IAClB,CAAC;SAED,CAAC;QACA,gBAAK,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC;IACvB,CAAC;AACF,CAAC,CAAC;KACD,OAAO,EAAE;KACT,IAAI,EAAE;KACN,IAAI,CACL","sourcesContent":["#!/usr/bin/env node\n\nimport createYarnWorkspaces from '..';\nimport debug from 'debug-color2/logger';\nimport yargs from 'yargs';\nimport { join } from 'path';\nimport setupWorkspacesInitToYargs from '../yargs-setting';\n\n/**\n * CLI 一律以呼叫當下的 shell 目錄作為基準路徑。\n * The CLI always uses the invoking shell's directory as the base path.\n */\nconst CWD = process.cwd();\n\n/**\n * CLI 入口：解析參數後呼叫 createYarnWorkspaces，失敗時印出說明。\n * CLI entry: parse arguments, call `createYarnWorkspaces`, and print help on failure.\n */\nlet cli = setupWorkspacesInitToYargs(yargs)\n\t// @ts-ignore\n\t.command('$0', '', function (yargs)\n\t{\n\t\t// @ts-ignore\n\t\t// 優先採用 --name，否則取第一個位置參數作為目標資料夾名稱。\n\t\t// Prefer `--name`; otherwise take the first positional argument as the target folder name.\n\t\tlet name = (yargs.argv.name || yargs.argv._[0]) as string;\n\n\t\t// 未指定名稱時就地初始化（以 CWD 為目標）。\n\t\t// When no name is given, initialize in place (target = `CWD`).\n\t\tif (name)\n\t\t{\n\t\t\tname = join(CWD, name);\n\t\t}\n\t\telse\n\t\t{\n\t\t\tname = CWD;\n\t\t}\n\n\t\t//console.log(CWD, yargs.argv);\n\n\t\t// @ts-ignore\n\t\tyargs.argv.debug && debug.debug(yargs.argv);\n\n\t\t// 布林參數以 !! 強制轉型；靜態檔案相關選項刻意保留原始值，讓 addStaticFiles 維持預設 true。\n\t\t// Coerce booleans with `!!`; static-file options are intentionally passed through untouched so `addStaticFiles` keeps its default of `true`.\n\t\tlet bool = createYarnWorkspaces(name, {\n\t\t\t// @ts-ignore\n\t\t\tignoreExistsPackage: !!yargs.argv.ignoreExistsPackage,\n\t\t\t// @ts-ignore\n\t\t\tignoreParentWorkspaces: !!yargs.argv.ignoreParentWorkspaces,\n\t\t\t// @ts-ignore\n\t\t\tdebug: !!yargs.argv.debug,\n\t\t\t/*\n\t\t\t * 保留 undefined，讓 addStaticFiles 維持預設 true / Keep undefined so addStaticFiles keeps its default of true\n\t\t\t * */\n\t\t\t// @ts-ignore\n\t\t\taddStaticFiles: yargs.argv.addStaticFiles,\n\t\t\t// @ts-ignore\n\t\t\tnoStaticFiles: yargs.argv.noStaticFiles,\n\t\t\t// @ts-ignore\n\t\t\tresetStaticFiles: yargs.argv.resetStaticFiles,\n\t\t});\n\n\t\t//console.log(77777777777, bool);\n\n\t\t// 回傳 false 代表前置檢查失敗（如已存在 Package），此時顯示說明協助使用者修正參數。\n\t\t// A `false` return means a pre-check failed (e.g. package already exists), so show help to guide the user.\n\t\tif (!bool)\n\t\t{\n\t\t\tconsole.log('\\n');\n\t\t\tyargs.showHelp();\n\t\t}\n\t\telse\n\t\t{\n\t\t\tdebug.success(`done`);\n\t\t}\n\t})\n\t.version()\n\t.help()\n\t.argv\n;\n"]}
+{"version":3,"file":"yarn-ws-init.js","sourceRoot":"","sources":["yarn-ws-init.ts"],"names":[],"mappings":";;;;AAEA,0BAA+C;AAC/C,yEAAwC;AACxC,0DAA0B;AAC1B,+BAA4B;AAC5B,6EAA0D;AAE1D;;GAEG;AACH,MAAM,GAAG,GAAG,OAAO,CAAC,GAAG,EAAE,CAAC;AAE1B;;;;GAIG;AACH,IAAI,GAAG,GAAG,IAAA,uBAA0B,EAAC,eAAK,CAAC;IAC1C,aAAa;KACZ,OAAO,CAAC,IAAI,EAAE,EAAE,EAAE,KAAK,WAAW,KAAK;IAEvC,uCAAuC;IACvC,aAAa;IACb,IAAI,IAAI,GAAG,CAAC,KAAK,CAAC,IAAI,CAAC,IAAI,IAAI,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC,CAAW,CAAC;IAE1D,8BAA8B;IAC9B,IAAI,IAAI,EACR,CAAC;QACA,IAAI,GAAG,IAAA,WAAI,EAAC,GAAG,EAAE,IAAI,CAAC,CAAC;IACxB,CAAC;SAED,CAAC;QACA,IAAI,GAAG,GAAG,CAAC;IACZ,CAAC;IAED,+BAA+B;IAE/B,aAAa;IACb,KAAK,CAAC,IAAI,CAAC,KAAK,IAAI,gBAAK,CAAC,KAAK,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;IAE5C,gEAAgE;IAChE,IAAI,IAAI,GAAG,MAAM,IAAA,6BAAyB,EAAC,IAAI,EAAE;QAChD,aAAa;QACb,mBAAmB,EAAE,CAAC,CAAC,KAAK,CAAC,IAAI,CAAC,mBAAmB;QACrD,aAAa;QACb,sBAAsB,EAAE,CAAC,CAAC,KAAK,CAAC,IAAI,CAAC,sBAAsB;QAC3D;;;WAGG;QACH,aAAa;QACb,WAAW,EAAE,CAAC,CAAC,KAAK,CAAC,IAAI,CAAC,WAAW;QACrC,aAAa;QACb,KAAK,EAAE,CAAC,CAAC,KAAK,CAAC,IAAI,CAAC,KAAK;QACzB;;aAEK;QACL,aAAa;QACb,cAAc,EAAE,KAAK,CAAC,IAAI,CAAC,cAAc;QACzC,aAAa;QACb,aAAa,EAAE,KAAK,CAAC,IAAI,CAAC,aAAa;QACvC,aAAa;QACb,gBAAgB,EAAE,KAAK,CAAC,IAAI,CAAC,gBAAgB;KAC7C,CAAC,CAAC;IAEH,iCAAiC;IAEjC,kEAAkE;IAClE,IAAI,CAAC,IAAI,EACT,CAAC;QACA,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;QAClB,KAAK,CAAC,QAAQ,EAAE,CAAC;IAClB,CAAC;SAED,CAAC;QACA,gBAAK,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC;IACvB,CAAC;AACF,CAAC,CAAC;KACD,OAAO,EAAE;KACT,IAAI,EAAE;KACN,UAAU,EAAE,CACb","sourcesContent":["#!/usr/bin/env node\n\nimport { createYarnWorkspacesAsync } from '..';\nimport debug from 'debug-color2/logger';\nimport yargs from 'yargs';\nimport { join } from 'path';\nimport setupWorkspacesInitToYargs from '../yargs-setting';\n\n/**\n * CLI 一律以呼叫當下的 shell 目錄作為基準路徑。\n */\nconst CWD = process.cwd();\n\n/**\n * CLI 入口：解析參數後呼叫 createYarnWorkspacesAsync，失敗時印出說明。\n *\n * 以 async handler 搭配 parseAsync，確保互動介面（@clack/prompts）完成後才結束流程。\n */\nlet cli = setupWorkspacesInitToYargs(yargs)\n\t// @ts-ignore\n\t.command('$0', '', async function (yargs)\n\t{\n\t\t/** 優先採用 --name，否則取第一個位置參數作為目標資料夾名稱。 */\n\t\t// @ts-ignore\n\t\tlet name = (yargs.argv.name || yargs.argv._[0]) as string;\n\n\t\t/** 未指定名稱時就地初始化（以 CWD 為目標）。 */\n\t\tif (name)\n\t\t{\n\t\t\tname = join(CWD, name);\n\t\t}\n\t\telse\n\t\t{\n\t\t\tname = CWD;\n\t\t}\n\n\t\t//console.log(CWD, yargs.argv);\n\n\t\t// @ts-ignore\n\t\tyargs.argv.debug && debug.debug(yargs.argv);\n\n\t\t/** 布林參數以 !! 強制轉型；靜態檔案相關選項刻意保留原始值，讓 addStaticFiles 維持預設 true。 */\n\t\tlet bool = await createYarnWorkspacesAsync(name, {\n\t\t\t// @ts-ignore\n\t\t\tignoreExistsPackage: !!yargs.argv.ignoreExistsPackage,\n\t\t\t// @ts-ignore\n\t\t\tignoreParentWorkspaces: !!yargs.argv.ignoreParentWorkspaces,\n\t\t\t/**\n\t\t\t * 互動介面預設啟用（yargs default: true），可用 --no-interactive 關閉；\n\t\t\t * 無 TTY 時於 async 版本內自動退回警告。\n\t\t\t */\n\t\t\t// @ts-ignore\n\t\t\tinteractive: !!yargs.argv.interactive,\n\t\t\t// @ts-ignore\n\t\t\tdebug: !!yargs.argv.debug,\n\t\t\t/*\n\t\t\t * 保留 undefined，讓 addStaticFiles 維持預設 true\n\t\t\t * */\n\t\t\t// @ts-ignore\n\t\t\taddStaticFiles: yargs.argv.addStaticFiles,\n\t\t\t// @ts-ignore\n\t\t\tnoStaticFiles: yargs.argv.noStaticFiles,\n\t\t\t// @ts-ignore\n\t\t\tresetStaticFiles: yargs.argv.resetStaticFiles,\n\t\t});\n\n\t\t//console.log(77777777777, bool);\n\n\t\t/** 回傳 false 代表前置檢查失敗（如已存在 Package）或使用者於互動介面取消，此時顯示說明協助使用者修正參數。 */\n\t\tif (!bool)\n\t\t{\n\t\t\tconsole.log('\\n');\n\t\t\tyargs.showHelp();\n\t\t}\n\t\telse\n\t\t{\n\t\t\tdebug.success(`done`);\n\t\t}\n\t})\n\t.version()\n\t.help()\n\t.parseAsync()\n;\n"]}

package/index.d.ts

@@ -1,100 +1,40 @@
 /**
- * 創建 Yarn Workspaces 工具模組
- * Yarn Workspaces Creation Tool Module
+ * 創建 Workspaces 工具模組
  *
- * 提供初始化 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
+ * 提供初始化 Workspaces 專案結構的功能，
+ * 包含 package.json 設定、
+ * Lerna 整合、
+ * 目錄創建與靜態檔案複製等功能。
  */
-import { IPackageJson } from '@ts-type/package-dts/package-json';
-import { INpmAutoFixAll } from '@yarn-tool/fix-all';
+import { IOptions } from './lib/core';
 export * from './lib/index';
 export * from './lib/util';
 /**
- * 創建 Workspaces 的選項介面
- * Interface for creating workspaces options
- */
-export interface IOptions extends Pick<INpmAutoFixAll, 'addStaticFiles' | 'noStaticFiles'> {
-    /**
-     * 工作目錄路徑 / 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 主函式（同步）
  *
- * 檢查並創建 Workspaces 專案結構，處理已存在 Package 與父層 Workspaces 的情況
- * Checks and creates workspace project structure, handling existing packages
- * and parent workspaces
+ * 檢查並創建 Workspaces 專案結構，處理已存在 Package 與父層 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 目錄
+ * @param cwd - 工作目錄路徑
+ * @param options - 配置選項
+ * @returns 是否成功創建
  *
- * 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
+ * @deprecated 請改用 `createYarnWorkspacesAsync` 以獲得更好的互動體驗
  */
-export declare function _createYarnWorkspaces(targetPath: string, options?: IOptions): boolean;
+export declare function createYarnWorkspaces(cwd?: string, options?: IOptions): boolean;
 /**
- * 根據 packages 模式創建目錄
- * Create directories based on packages pattern
+ * 創建 Workspaces 主函式（非同步）
  *
- * 解析 packages 陣列中的目錄模式（如 "packages/*"），
- * 並創建對應的實體目錄。
- * Parses directory patterns from packages array (e.g., "packages/*")
- * and creates corresponding physical directories.
+ * 與 {@link createYarnWorkspaces} 相同，但當 `options.interactive` 啟用且環境具備 TTY 時，
+ * 會依環境檢查報告透過互動介面詢問是否繼續；
+ * 未啟用互動介面（或不具備 TTY）時與同步版本相同，僅印出警告並繼續執行。
  *
- * @param cwd - 當前工作目錄 / Current working directory
- * @param packages - packages 模式陣列 / Array of package patterns
- * @returns 是否有創建任何目錄 / Whether any directories were created
+ * @param cwd - 工作目錄路徑
+ * @param options - 配置選項
+ * @returns 是否成功創建；使用者在互動介面取消時回傳 false
  */
-export declare function createDirByPackages(cwd: string, packages: string[]): boolean;
+export declare function createYarnWorkspacesAsync(cwd?: string, options?: IOptions): Promise<boolean>;
 /**
  * 預設導出創建函式
- * Default export of creation function
  */
 export default createYarnWorkspaces;