create-yarn-workspaces 3.0.35 → 3.0.37

package/lib/core.js

@@ -0,0 +1,273 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports._precheckYarnWorkspaces = _precheckYarnWorkspaces;
+exports._createYarnWorkspaces = _createYarnWorkspaces;
+exports.createDirByPackages = createDirByPackages;
+const upath2_1 = require("upath2");
+const fs_extra_1 = require("fs-extra");
+const index_1 = require("./index");
+const util_1 = require("./util");
+const find_root_1 = require("@yarn-tool/find-root");
+const staticFiles_1 = require("@yarn-tool/fix-all/lib/file/staticFiles");
+const static_file_1 = require("@yarn-tool/static-file");
+const sort_package_json3_1 = require("sort-package-json3");
+const logger_1 = require("debug-color2/logger");
+const wsCopyStaticFiles_1 = require("@yarn-tool/static-file/lib/ws/wsCopyStaticFiles");
+/**
+ * 創建 Workspaces 的核心前置檢查邏輯
+ *
+ * 處理參數正規化、尋找專案根目錄，並檢查：
+ * - 是否已存在 Package
+ * - 是否已存在（父層）Workspaces
+ *
+ * @param cwd - 工作目錄路徑；也可直接傳入 IOptions
+ * @param options - 配置選項
+ * @returns 前置檢查結果；`ok` 為 false 時不應繼續創建
+ */
+function _precheckYarnWorkspaces(cwd, options = {}) {
+    var _a;
+    /** 處理第一個參數可能是選項物件的情況 */
+    if (cwd && typeof cwd != 'string') {
+        options = cwd;
+        cwd = options.cwd;
+    }
+    /** 預設使用當前工作目錄 */
+    cwd !== null && cwd !== void 0 ? cwd : (cwd = process.cwd());
+    /** 尋找專案根目錄資訊 */
+    const rootData = (0, find_root_1.findRootLazy)({
+        cwd,
+    });
+    /** 標準化路徑 */
+    cwd = (0, upath2_1.normalize)((_a = rootData === null || rootData === void 0 ? void 0 : rootData.cwd) !== null && _a !== void 0 ? _a : cwd);
+    /** 取得 Package 根目錄與 Workspaces 路徑 */
+    let root = rootData === null || rootData === void 0 ? void 0 : rootData.pkg;
+    let ws = rootData === null || rootData === void 0 ? void 0 : rootData.ws;
+    /** 實際要初始化的目標路徑：優先採用既有 package 根目錄，否則退回 cwd。 */
+    let targetPath = (0, upath2_1.resolve)(root || cwd);
+    /** 除錯輸出 */
+    options.debug && logger_1.consoleLogger.debug({
+        targetPath,
+        ws,
+        options,
+    });
+    /**
+     * 檢查是否已存在 Package
+     */
+    if (!options.ignoreExistsPackage && root) {
+        logger_1.consoleLogger.error(`already have package at "${root}", or use ignoreExistsPackage for overwrite it`);
+        return { ok: false, targetPath, options };
+    }
+    else if (root) {
+        /** 忽略已存在的 Package */
+        logger_1.consoleLogger.warn(`ignore exists package "${root}"`);
+    }
+    /**
+     * 檢查是否已存在 Workspaces
+     */
+    if (ws) {
+        /** 檢查目標路徑是否與現有 Workspace 相同 */
+        let bool = !(0, util_1.isSamePath)(targetPath, ws);
+        logger_1.consoleLogger.warn(`detect exists workspace "${ws}"`);
+        if (bool) {
+            /** 根據選項決定是否忽略父層 Workspaces */
+            if (options.ignoreParentWorkspaces) {
+                logger_1.consoleLogger.warn(`ignoreParentWorkspaces = true`);
+                bool = false;
+            }
+            else {
+                logger_1.consoleLogger.error(`target path already is workspace`);
+            }
+        }
+        if (bool) {
+            return { ok: false, targetPath, options };
+        }
+    }
+    return { ok: true, targetPath, options };
+}
+/**
+ * 內部創建 Workspaces 實作函式
+ *
+ * 執行實際的 Workspaces 初始化工作，包含：
+ * - 讀取並更新 Lerna 配置
+ * - 創建或更新 package.json
+ * - 複製靜態範本檔案
+ * - 創建 packages 目錄
+ *
+ * @param targetPath - 目標路徑
+ * @param options - 配置選項
+ * @returns 是否成功
+ */
+function _createYarnWorkspaces(targetPath, options = {}) {
+    var _a;
+    logger_1.consoleLogger.info(`create in target path "${targetPath}"`);
+    let pkg;
+    let lerna;
+    /**
+     * 嘗試讀取現有的 lerna.json 配置
+     */
+    {
+        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 陣列
+             */
+            if (json.packages && !Object.keys(json.packages).length) {
+                json.packages = undefined;
+            }
+            lerna = json;
+        }
+    }
+    /**
+     * 預設 packages 目錄模式
+     */
+    let packages = lerna && lerna.packages || [
+        "packages/*",
+    ];
+    let file = (0, upath2_1.join)(targetPath, 'package.json');
+    /**
+     * 處理 package.json 不存在的情況
+     */
+    if (!(0, fs_extra_1.existsSync)(file)) {
+        /** 使用目錄名作為預設 Package 名稱 */
+        let name = (0, upath2_1.basename)(targetPath);
+        /** 創建目標目錄（如果不存在） */
+        if (!(0, fs_extra_1.existsSync)(targetPath)) {
+            (0, fs_extra_1.mkdirSync)(targetPath);
+        }
+        /** 合併預設配置與基本資訊 */
+        pkg = Object.assign((0, index_1.getDefaultPackageJson)(name), {
+            name,
+            workspaces: packages,
+        });
+        /**
+         * 執行自定義初始化回呼
+         */
+        if (options.initPackageJson) {
+            let ret = options.initPackageJson(pkg);
+            if (ret) {
+                pkg = ret;
+            }
+        }
+    }
+    else {
+        /**
+         * 處理已存在的 package.json
+         */
+        let json = JSON.parse((0, fs_extra_1.readFileSync)(file).toString());
+        let workspaces;
+        /**
+         * 解析現有的 workspaces 配置
+         */
+        if (json.workspaces && Object.keys(json.workspaces).length) {
+            workspaces = json.workspaces;
+            /**
+             * 支援 nohoist 配置格式
+             * @see https://yarnpkg.com/blog/2018/02/15/nohoist/
+             */
+            // @ts-ignore
+            packages = workspaces.packages || workspaces;
+        }
+        else {
+            workspaces = packages;
+        }
+        /**
+         * 更新 Package.json 內容
+         */
+        pkg = Object.assign(json, {
+            "private": true,
+            "workspaces": workspaces,
+        });
+        /**
+         * 合併預設腳本與欄位
+         */
+        Object.entries((0, index_1.getDefaultPackageJson)(json.name))
+            .forEach(([field, value]) => {
+            var _a, _b;
+            /**
+             * 特殊處理 scripts 欄位：合併而非覆蓋
+             */
+            if (field === 'scripts') {
+                (_a = pkg.scripts) !== null && _a !== void 0 ? _a : (pkg.scripts = {});
+                pkg.scripts = {
+                    // @ts-ignore
+                    ...value,
+                    ...pkg.scripts,
+                };
+            }
+            else {
+                /** 使用空值合併運算子設置預設值 */
+                (_b = pkg[field]) !== null && _b !== void 0 ? _b : (pkg[field] = value);
+            }
+        });
+    }
+    /**
+     * 寫入格式化後的 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`);
+    /**
+     * 更新 Lerna 配置（如果存在且需要更新）
+     */
+    if (lerna && (packages != lerna.packages || lerna.npmClient !== 'yarn' || lerna['useWorkspaces'] !== true)) {
+        let file = (0, upath2_1.join)(targetPath, 'lerna.json');
+        /** 更新 Workspaces 模式 */
+        lerna.packages = packages;
+        (_a = lerna.npmClient) !== null && _a !== void 0 ? _a : (lerna.npmClient = 'pnpm');
+        // 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`);
+    }
+    /**
+     * 複製靜態範本檔案
+     */
+    const file_map = (0, wsCopyStaticFiles_1.getWsCopyStaticFiles)();
+    /**
+     * 複製靜態範本檔案
+     *
+     * 此呼叫點 addStaticFiles 預設為 true，可用 noStaticFiles 關閉
+     */
+    if ((0, staticFiles_1._isAddStaticFilesOrReset)(options, true)) {
+        (0, static_file_1.copyStaticFiles)({
+            cwd: targetPath,
+            file_map,
+        });
+    }
+    /**
+     * 根據 packages 模式創建目錄
+     */
+    createDirByPackages(targetPath, packages);
+    return true;
+}
+/**
+ * 根據 packages 模式創建目錄
+ *
+ * 解析 packages 陣列中的目錄模式（如 "packages/*"），
+ * 並創建對應的實體目錄。
+ *
+ * @param cwd - 當前工作目錄
+ * @param packages - packages 模式陣列
+ * @returns 是否有創建任何目錄
+ */
+function createDirByPackages(cwd, packages) {
+    return packages.some(function (value) {
+        let bool;
+        /** 提取路徑的第一個部分（目錄名稱） */
+        let s = value.split(/[\/\\]/)[0];
+        /**
+         * 只處理不包含 glob 模式的純目錄路徑
+         */
+        if (!/[!?\*{}\[\]]/.test(s)) {
+            let dir = (0, upath2_1.join)(cwd, s);
+            /** 目錄不存在時創建 */
+            if (!(0, fs_extra_1.existsSync)(dir)) {
+                (0, fs_extra_1.mkdirSync)(dir);
+            }
+            return true;
+        }
+        return bool;
+    });
+}
+//# sourceMappingURL=core.js.map

package/lib/core.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"core.js","sourceRoot":"","sources":["core.ts"],"names":[],"mappings":"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","sourcesContent":["import { INpmAutoFixAll } from '@yarn-tool/fix-all';\nimport { IPackageJson } from '@ts-type/package-dts/package-json';\nimport { ILernaJson } from '@ts-type/package-dts/lerna-json';\nimport { basename, join, normalize as pathNormalize, resolve } from 'upath2';\nimport { existsSync, mkdirSync, readFileSync, writeFileSync } from 'fs-extra';\nimport { getDefaultPackageJson } from './index';\nimport { isSamePath } from './util';\nimport { findRootLazy } from '@yarn-tool/find-root';\nimport { _isAddStaticFilesOrReset } from '@yarn-tool/fix-all/lib/file/staticFiles';\nimport { copyStaticFiles } from '@yarn-tool/static-file';\nimport { sortPackageJson } from 'sort-package-json3';\nimport { consoleLogger as console } from 'debug-color2/logger';\nimport { getWsCopyStaticFiles } from '@yarn-tool/static-file/lib/ws/wsCopyStaticFiles';\n\n/**\n * 創建 Workspaces 的選項介面\n */\nexport interface IOptions extends Pick<INpmAutoFixAll, 'addStaticFiles' | 'noStaticFiles'>\n{\n\t/**\n\t * 工作目錄路徑\n\t */\n\tcwd?: string,\n\n\t/**\n\t * 忽略父層 Workspaces\n\t */\n\tignoreParentWorkspaces?: boolean,\n\n\t/**\n\t * 忽略已存在的 Package\n\t */\n\tignoreExistsPackage?: boolean,\n\n\t/**\n\t * 初始化 Package.json 的回呼函式\n\t * @template T - 擴展屬性類型\n\t * @param current - 當前的 package.json\n\t * @returns 修改後的 package.json\n\t */\n\tinitPackageJson?<T extends Record<string, any> = {}>(current: IPackageJson): IPackageJson & T,\n\n\t/**\n\t * 啟用除錯模式\n\t */\n\tdebug?: boolean,\n\n\t/**\n\t * 啟用互動介面\n\t *\n\t * 僅 `createYarnWorkspacesAsync` 支援，sync 版本會忽略此選項；\n\t * 需環境具備 TTY，且在 `_checkEnv` 判定疑似錯誤路徑時才會詢問是否繼續。\n\t */\n\tinteractive?: boolean,\n}\n\n/**\n * `createYarnWorkspaces` 的前置檢查結果\n */\nexport interface IPrecheckResult\n{\n\t/** 是否可繼續執行創建流程 */\n\tok: boolean,\n\n\t/** 實際要初始化的目標路徑：優先採用既有 package 根目錄，否則退回 cwd。 */\n\ttargetPath: string,\n\n\t/** 經參數正規化後的配置選項（第一個參數可能直接傳入選項物件） */\n\toptions: IOptions,\n}\n\n/**\n * 創建 Workspaces 的核心前置檢查邏輯\n *\n * 處理參數正規化、尋找專案根目錄，並檢查：\n * - 是否已存在 Package\n * - 是否已存在（父層）Workspaces\n *\n * @param cwd - 工作目錄路徑；也可直接傳入 IOptions\n * @param options - 配置選項\n * @returns 前置檢查結果；`ok` 為 false 時不應繼續創建\n */\nexport function _precheckYarnWorkspaces(cwd?: string, options: IOptions = {}): IPrecheckResult\n{\n\t/** 處理第一個參數可能是選項物件的情況 */\n\tif (cwd && typeof cwd != 'string')\n\t{\n\t\toptions = cwd;\n\t\tcwd = options.cwd;\n\t}\n\n\t/** 預設使用當前工作目錄 */\n\tcwd ??= process.cwd();\n\n\t/** 尋找專案根目錄資訊 */\n\tconst rootData = findRootLazy({\n\t\tcwd,\n\t});\n\n\t/** 標準化路徑 */\n\tcwd = pathNormalize(rootData?.cwd ?? cwd);\n\n\t/** 取得 Package 根目錄與 Workspaces 路徑 */\n\tlet root: string = rootData?.pkg;\n\tlet ws: string = rootData?.ws;\n\n\t/** 實際要初始化的目標路徑：優先採用既有 package 根目錄，否則退回 cwd。 */\n\tlet targetPath = resolve(root || cwd);\n\n\t/** 除錯輸出 */\n\toptions.debug && console.debug({\n\t\ttargetPath,\n\t\tws,\n\t\toptions,\n\t});\n\n\t/**\n\t * 檢查是否已存在 Package\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 { ok: false, targetPath, options };\n\t}\n\telse if (root)\n\t{\n\t\t/** 忽略已存在的 Package */\n\t\tconsole.warn(`ignore exists package \"${root}\"`);\n\t}\n\n\t/**\n\t * 檢查是否已存在 Workspaces\n\t */\n\tif (ws)\n\t{\n\t\t/** 檢查目標路徑是否與現有 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\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 { ok: false, targetPath, options };\n\t\t}\n\t}\n\n\treturn { ok: true, targetPath, options };\n}\n\n/**\n * 內部創建 Workspaces 實作函式\n *\n * 執行實際的 Workspaces 初始化工作，包含：\n * - 讀取並更新 Lerna 配置\n * - 創建或更新 package.json\n * - 複製靜態範本檔案\n * - 創建 packages 目錄\n *\n * @param targetPath - 目標路徑\n * @param options - 配置選項\n * @returns 是否成功\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 */\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 */\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 */\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 */\n\tif (!existsSync(file))\n\t{\n\t\t/** 使用目錄名作為預設 Package 名稱 */\n\t\tlet name = basename(targetPath);\n\n\t\t/** 創建目標目錄（如果不存在） */\n\t\tif (!existsSync(targetPath))\n\t\t{\n\t\t\tmkdirSync(targetPath);\n\t\t}\n\n\t\t/** 合併預設配置與基本資訊 */\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 */\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 */\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 */\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 * @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 */\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/**\n\t\t * 合併預設腳本與欄位\n\t\t */\n\t\tObject.entries(getDefaultPackageJson(json.name))\n\t\t\t.forEach(([field, value]) =>\n\t\t\t{\n\n\t\t\t\t/**\n\t\t\t\t * 特殊處理 scripts 欄位：合併而非覆蓋\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\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 */\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 */\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/** 更新 Workspaces 模式 */\n\t\tlerna.packages = packages;\n\t\tlerna.npmClient ??= 'pnpm';\n\t\t// lerna['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 */\n\tconst file_map = getWsCopyStaticFiles();\n\n\t/**\n\t * 複製靜態範本檔案\n\t *\n\t * 此呼叫點 addStaticFiles 預設為 true，可用 noStaticFiles 關閉\n\t */\n\tif (_isAddStaticFilesOrReset(options, true))\n\t{\n\t\tcopyStaticFiles({\n\t\t\tcwd: targetPath,\n\t\t\tfile_map,\n\t\t});\n\t}\n\n\t/**\n\t * 根據 packages 模式創建目錄\n\t */\n\tcreateDirByPackages(targetPath, packages);\n\n\treturn true;\n}\n\n/**\n * 根據 packages 模式創建目錄\n *\n * 解析 packages 陣列中的目錄模式（如 \"packages/*\"），\n * 並創建對應的實體目錄。\n *\n * @param cwd - 當前工作目錄\n * @param packages - packages 模式陣列\n * @returns 是否有創建任何目錄\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\tlet s = value.split(/[\\/\\\\]/)[0];\n\n\t\t/**\n\t\t * 只處理不包含 glob 模式的純目錄路徑\n\t\t */\n\t\tif (!/[!?\\*{}\\[\\]]/.test(s))\n\t\t{\n\t\t\tlet dir = join(cwd, s);\n\n\t\t\t/** 目錄不存在時創建 */\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}"]}

package/lib/index.d.ts

@@ -1,17 +1,16 @@
 import { IPackageJson } from '@ts-type/package-dts/package-json';
 /**
  * 取得新專案根目錄的預設 package.json 內容。
- * Build the default root `package.json` content for a new project.
  *
- * @param name 套件名稱；未提供時保留 undefined 交由呼叫端補上。Package name; left `undefined` when absent for the caller to fill in.
- * @returns 含預設 scripts 與依賴的 package.json 物件。A `package.json` object with default scripts and dependencies.
+ * @param name 套件名稱；未提供時保留 undefined 交由呼叫端補上。
+ * @returns 含預設 scripts 與依賴的 package.json 物件。
  */
 export declare function getDefaultPackageJson(name?: string): IPackageJson;
 /**
  * 取得新專案根目錄的預設 tsconfig 內容。
- * Build the default root `tsconfig` content for a new project.
  *
- * @returns 繼承 @bluelovers/tsconfig 的 tsconfig 物件。A `tsconfig` object extending `@bluelovers/tsconfig`.
+ * @returns 繼承 @bluelovers/tsconfig 的 tsconfig 物件。
+ * @deprecated
  */
 export declare function getDefaultTsconfig(): {
     extends: string;

package/lib/index.js

@@ -5,14 +5,14 @@ exports.getDefaultTsconfig = getDefaultTsconfig;
 const tslib_1 = require("tslib");
 const ws_root_scripts_1 = require("@yarn-tool/pkg-entry-util/lib/preset/scripts/ws-root-scripts");
 const dummy_1 = require("@yarn-tool/pkg-entry-util/lib/preset/scripts/dummy");
+// @ts-ignore
 const package_demo_json_1 = require("./package.demo.json");
 const package_json_1 = tslib_1.__importDefault(require("../package.json"));
 /**
  * 取得新專案根目錄的預設 package.json 內容。
- * Build the default root `package.json` content for a new project.
  *
- * @param name 套件名稱；未提供時保留 undefined 交由呼叫端補上。Package name; left `undefined` when absent for the caller to fill in.
- * @returns 含預設 scripts 與依賴的 package.json 物件。A `package.json` object with default scripts and dependencies.
+ * @param name 套件名稱；未提供時保留 undefined 交由呼叫端補上。
+ * @returns 含預設 scripts 與依賴的 package.json 物件。
  */
 function getDefaultPackageJson(name) {
     let json = {
@@ -23,8 +23,7 @@ function getDefaultPackageJson(name) {
         "workspaces": [
             "packages/*",
         ],
-        // 預設標記建立來源，方便日後辨識此專案由 yarn-tool 產生。
-        // Mark the origin by default so the project can later be recognized as created by yarn-tool.
+        /** 預設標記建立來源，方便日後辨識此專案由 yarn-tool 產生。 */
         keywords: [
             "create-by-yarn-tool",
         ],
@@ -34,39 +33,37 @@ function getDefaultPackageJson(name) {
         peerDependencies: package_demo_json_1.peerDependencies,
         // "resolutions": {},
     };
-    // 以本套件自身的依賴版本覆寫範本版本，確保產生的專案與工具列版本一致。
-    // Override the template versions with this package's own dependency versions so the generated project matches the toolchain.
+    /** 以本套件自身的依賴版本覆寫範本版本，確保產生的專案與工具列版本一致。 */
     for (const deps of ['dependencies', 'devDependencies', 'peerDependencies']) {
-        let keys = Object.keys(json[deps]);
-        // 範本沒有該依賴欄位、或本套件也未宣告時略過，避免憑空新增空的依賴區塊。
-        // Skip when the template lacks the field or this package does not declare it, avoiding empty dependency blocks out of nowhere.
+        if (!json[deps]) {
+            continue;
+        }
+        const keys = Object.keys(json[deps]);
+        /** 範本沒有該依賴欄位、或本套件也未宣告時略過，避免憑空新增空的依賴區塊。 */
         if (!keys.length || !package_json_1.default[deps]) {
             continue;
         }
-        // 複製一份再改寫，避免直接動到匯入的範本物件（其為模組快取中的共享實例）。
-        // Copy before mutating so we do not edit the imported template object (a shared instance in the module cache).
+        /** 複製一份再改寫，避免直接動到匯入的範本物件（其為模組快取中的共享實例）。 */
         json[deps] = {
             ...json[deps],
         };
         keys
             .forEach(function (key) {
-            // 只覆寫本套件也宣告了的鍵，其餘保留範本預設版本。
-            // Only overwrite keys also declared by this package; keep template defaults for the rest.
+            /** 只覆寫本套件也宣告了的鍵，其餘保留範本預設版本。 */
             if (package_json_1.default[deps][key]) {
                 json[deps][key] = package_json_1.default[deps][key];
             }
         });
     }
-    // 補上 workspaces 專用的預設腳本（已存在的腳本不會被覆蓋）。
-    // Fill in workspace-specific default scripts (existing scripts are not overwritten).
+    /** 補上 workspaces 專用的預設腳本（已存在的腳本不會被覆蓋）。 */
     (0, dummy_1.fillDummyScripts)(json.scripts, 'workspaces');
     return json;
 }
 /**
  * 取得新專案根目錄的預設 tsconfig 內容。
- * Build the default root `tsconfig` content for a new project.
  *
- * @returns 繼承 @bluelovers/tsconfig 的 tsconfig 物件。A `tsconfig` object extending `@bluelovers/tsconfig`.
+ * @returns 繼承 @bluelovers/tsconfig 的 tsconfig 物件。
+ * @deprecated
  */
 function getDefaultTsconfig() {
     return {

package/lib/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["index.ts"],"names":[],"mappings":";;AAaA,sDA2DC;AAQD,gDAKC;;AApFD,kGAA2G;AAC3G,8EAAsF;AACtF,2DAAsF;AACtF,2EAAmC;AAEnC;;;;;;GAMG;AACH,SAAgB,qBAAqB,CAAC,IAAa;IAElD,IAAI,IAAI,GAAiB;QACxB,MAAM,EAAE,IAAI;QACZ,SAAS,EAAE,OAAO;QAClB,SAAS,EAAE,IAAI;QACf,oCAAoC;QACpC,YAAY,EAAE;YACb,YAAY;SACZ;QACD,oCAAoC;QACpC,6FAA6F;QAC7F,QAAQ,EAAE;YACT,qBAAqB;SACrB;QACD,SAAS,EAAE,IAAA,6CAA2B,GAAE;QACxC,YAAY,EAAZ,gCAAY;QACZ,eAAe,EAAf,mCAAe;QACf,gBAAgB,EAAhB,oCAAgB;QAChB,qBAAqB;KACd,CAAC;IAET,qCAAqC;IACrC,6HAA6H;IAC7H,KAAK,MAAM,IAAI,IAAI,CAAC,cAAc,EAAE,iBAAiB,EAAE,kBAAkB,CAAU,EACnF,CAAC;QACA,IAAI,IAAI,GAAG,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC;QAEnC,sCAAsC;QACtC,+HAA+H;QAC/H,IAAI,CAAC,IAAI,CAAC,MAAM,IAAI,CAAC,sBAAI,CAAC,IAAI,CAAC,EAC/B,CAAC;YACA,SAAS;QACV,CAAC;QAED,uCAAuC;QACvC,+GAA+G;QAC/G,IAAI,CAAC,IAAI,CAAC,GAAG;YACZ,GAAG,IAAI,CAAC,IAAI,CAAC;SACb,CAAC;QAEF,IAAI;aACF,OAAO,CAAC,UAAU,GAAG;YAErB,2BAA2B;YAC3B,0FAA0F;YAC1F,IAAI,sBAAI,CAAC,IAAI,CAAC,CAAC,GAAG,CAAC,EACnB,CAAC;gBACA,IAAI,CAAC,IAAI,CAAC,CAAC,GAAG,CAAC,GAAG,sBAAI,CAAC,IAAI,CAAC,CAAC,GAAG,CAAC,CAAC;YACnC,CAAC;QACF,CAAC,CAAC,CACF;IACF,CAAC;IAED,sCAAsC;IACtC,qFAAqF;IACrF,IAAA,wBAAgB,EAAC,IAAI,CAAC,OAAO,EAAE,YAAY,CAAC,CAAC;IAE7C,OAAO,IAAI,CAAC;AACb,CAAC;AAED;;;;;GAKG;AACH,SAAgB,kBAAkB;IAEjC,OAAO;QACN,OAAO,EAAE,uCAAuC;KAChD,CAAA;AACF,CAAC","sourcesContent":["import { IPackageJson } from '@ts-type/package-dts/package-json';\nimport { defaultWorkspaceRootScripts } from '@yarn-tool/pkg-entry-util/lib/preset/scripts/ws-root-scripts';\nimport { fillDummyScripts } from '@yarn-tool/pkg-entry-util/lib/preset/scripts/dummy';\nimport { dependencies, devDependencies, peerDependencies } from './package.demo.json';\nimport _pkg from '../package.json';\n\n/**\n * 取得新專案根目錄的預設 package.json 內容。\n * Build the default root `package.json` content for a new project.\n *\n * @param name 套件名稱；未提供時保留 undefined 交由呼叫端補上。Package name; left `undefined` when absent for the caller to fill in.\n * @returns 含預設 scripts 與依賴的 package.json 物件。A `package.json` object with default scripts and dependencies.\n */\nexport function getDefaultPackageJson(name?: string): IPackageJson\n{\n\tlet json: IPackageJson = {\n\t\t\"name\": name,\n\t\t\"version\": \"1.0.0\",\n\t\t\"private\": true,\n\t\t// \"packageManager\": \"yarn@1.22.19\",\n\t\t\"workspaces\": [\n\t\t\t\"packages/*\",\n\t\t],\n\t\t// 預設標記建立來源，方便日後辨識此專案由 yarn-tool 產生。\n\t\t// Mark the origin by default so the project can later be recognized as created by yarn-tool.\n\t\tkeywords: [\n\t\t\t\"create-by-yarn-tool\",\n\t\t],\n\t\t\"scripts\": defaultWorkspaceRootScripts(),\n\t\tdependencies,\n\t\tdevDependencies,\n\t\tpeerDependencies,\n\t\t// \"resolutions\": {},\n\t} as any;\n\n\t// 以本套件自身的依賴版本覆寫範本版本，確保產生的專案與工具列版本一致。\n\t// Override the template versions with this package's own dependency versions so the generated project matches the toolchain.\n\tfor (const deps of ['dependencies', 'devDependencies', 'peerDependencies'] as const)\n\t{\n\t\tlet keys = Object.keys(json[deps]);\n\n\t\t// 範本沒有該依賴欄位、或本套件也未宣告時略過，避免憑空新增空的依賴區塊。\n\t\t// Skip when the template lacks the field or this package does not declare it, avoiding empty dependency blocks out of nowhere.\n\t\tif (!keys.length || !_pkg[deps])\n\t\t{\n\t\t\tcontinue;\n\t\t}\n\n\t\t// 複製一份再改寫，避免直接動到匯入的範本物件（其為模組快取中的共享實例）。\n\t\t// Copy before mutating so we do not edit the imported template object (a shared instance in the module cache).\n\t\tjson[deps] = {\n\t\t\t...json[deps],\n\t\t};\n\n\t\tkeys\n\t\t\t.forEach(function (key)\n\t\t\t{\n\t\t\t\t// 只覆寫本套件也宣告了的鍵，其餘保留範本預設版本。\n\t\t\t\t// Only overwrite keys also declared by this package; keep template defaults for the rest.\n\t\t\t\tif (_pkg[deps][key])\n\t\t\t\t{\n\t\t\t\t\tjson[deps][key] = _pkg[deps][key];\n\t\t\t\t}\n\t\t\t})\n\t\t;\n\t}\n\n\t// 補上 workspaces 專用的預設腳本（已存在的腳本不會被覆蓋）。\n\t// Fill in workspace-specific default scripts (existing scripts are not overwritten).\n\tfillDummyScripts(json.scripts, 'workspaces');\n\n\treturn json;\n}\n\n/**\n * 取得新專案根目錄的預設 tsconfig 內容。\n * Build the default root `tsconfig` content for a new project.\n *\n * @returns 繼承 @bluelovers/tsconfig 的 tsconfig 物件。A `tsconfig` object extending `@bluelovers/tsconfig`.\n */\nexport function getDefaultTsconfig()\n{\n\treturn {\n\t\textends: \"@bluelovers/tsconfig/esm/mapfile.json\",\n\t}\n}\n"]}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["index.ts"],"names":[],"mappings":";;AAaA,sDAyDC;AAQD,gDAKC;;AAlFD,kGAA2G;AAC3G,8EAAsF;AACtF,aAAa;AACb,2DAAsF;AACtF,2EAAmC;AAEnC;;;;;GAKG;AACH,SAAgB,qBAAqB,CAAC,IAAa;IAElD,IAAI,IAAI,GAAiB;QACxB,MAAM,EAAE,IAAI;QACZ,SAAS,EAAE,OAAO;QAClB,SAAS,EAAE,IAAI;QACf,oCAAoC;QACpC,YAAY,EAAE;YACb,YAAY;SACZ;QACD,wCAAwC;QACxC,QAAQ,EAAE;YACT,qBAAqB;SACrB;QACD,SAAS,EAAE,IAAA,6CAA2B,GAAE;QACxC,YAAY,EAAZ,gCAAY;QACZ,eAAe,EAAf,mCAAe;QACf,gBAAgB,EAAhB,oCAAgB;QAChB,qBAAqB;KACd,CAAC;IAET,yCAAyC;IACzC,KAAK,MAAM,IAAI,IAAI,CAAC,cAAc,EAAE,iBAAiB,EAAE,kBAAkB,CAAU,EACnF,CAAC;QACA,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,EACf,CAAC;YACA,SAAS;QACV,CAAC;QACD,MAAM,IAAI,GAAG,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC;QAErC,0CAA0C;QAC1C,IAAI,CAAC,IAAI,CAAC,MAAM,IAAI,CAAC,sBAAI,CAAC,IAAI,CAAC,EAC/B,CAAC;YACA,SAAS;QACV,CAAC;QAED,2CAA2C;QAC3C,IAAI,CAAC,IAAI,CAAC,GAAG;YACZ,GAAG,IAAI,CAAC,IAAI,CAAC;SACb,CAAC;QAEF,IAAI;aACF,OAAO,CAAC,UAAU,GAAG;YAErB,+BAA+B;YAC/B,IAAI,sBAAI,CAAC,IAAI,CAAC,CAAC,GAAG,CAAC,EACnB,CAAC;gBACA,IAAI,CAAC,IAAI,CAAC,CAAC,GAAG,CAAC,GAAG,sBAAI,CAAC,IAAI,CAAC,CAAC,GAAG,CAAC,CAAC;YACnC,CAAC;QACF,CAAC,CAAC,CACF;IACF,CAAC;IAED,0CAA0C;IAC1C,IAAA,wBAAgB,EAAC,IAAI,CAAC,OAAO,EAAE,YAAY,CAAC,CAAC;IAE7C,OAAO,IAAI,CAAC;AACb,CAAC;AAED;;;;;GAKG;AACH,SAAgB,kBAAkB;IAEjC,OAAO;QACN,OAAO,EAAE,uCAAuC;KAChD,CAAA;AACF,CAAC","sourcesContent":["import { IPackageJson } from '@ts-type/package-dts/package-json';\nimport { defaultWorkspaceRootScripts } from '@yarn-tool/pkg-entry-util/lib/preset/scripts/ws-root-scripts';\nimport { fillDummyScripts } from '@yarn-tool/pkg-entry-util/lib/preset/scripts/dummy';\n// @ts-ignore\nimport { dependencies, devDependencies, peerDependencies } from './package.demo.json';\nimport _pkg from '../package.json';\n\n/**\n * 取得新專案根目錄的預設 package.json 內容。\n *\n * @param name 套件名稱；未提供時保留 undefined 交由呼叫端補上。\n * @returns 含預設 scripts 與依賴的 package.json 物件。\n */\nexport function getDefaultPackageJson(name?: string): IPackageJson\n{\n\tlet json: IPackageJson = {\n\t\t\"name\": name,\n\t\t\"version\": \"1.0.0\",\n\t\t\"private\": true,\n\t\t// \"packageManager\": \"yarn@1.22.19\",\n\t\t\"workspaces\": [\n\t\t\t\"packages/*\",\n\t\t],\n\t\t/** 預設標記建立來源，方便日後辨識此專案由 yarn-tool 產生。 */\n\t\tkeywords: [\n\t\t\t\"create-by-yarn-tool\",\n\t\t],\n\t\t\"scripts\": defaultWorkspaceRootScripts(),\n\t\tdependencies,\n\t\tdevDependencies,\n\t\tpeerDependencies,\n\t\t// \"resolutions\": {},\n\t} as any;\n\n\t/** 以本套件自身的依賴版本覆寫範本版本，確保產生的專案與工具列版本一致。 */\n\tfor (const deps of ['dependencies', 'devDependencies', 'peerDependencies'] as const)\n\t{\n\t\tif (!json[deps])\n\t\t{\n\t\t\tcontinue;\n\t\t}\n\t\tconst keys = Object.keys(json[deps]);\n\n\t\t/** 範本沒有該依賴欄位、或本套件也未宣告時略過，避免憑空新增空的依賴區塊。 */\n\t\tif (!keys.length || !_pkg[deps])\n\t\t{\n\t\t\tcontinue;\n\t\t}\n\n\t\t/** 複製一份再改寫，避免直接動到匯入的範本物件（其為模組快取中的共享實例）。 */\n\t\tjson[deps] = {\n\t\t\t...json[deps],\n\t\t};\n\n\t\tkeys\n\t\t\t.forEach(function (key)\n\t\t\t{\n\t\t\t\t/** 只覆寫本套件也宣告了的鍵，其餘保留範本預設版本。 */\n\t\t\t\tif (_pkg[deps][key])\n\t\t\t\t{\n\t\t\t\t\tjson[deps][key] = _pkg[deps][key];\n\t\t\t\t}\n\t\t\t})\n\t\t;\n\t}\n\n\t/** 補上 workspaces 專用的預設腳本（已存在的腳本不會被覆蓋）。 */\n\tfillDummyScripts(json.scripts, 'workspaces');\n\n\treturn json;\n}\n\n/**\n * 取得新專案根目錄的預設 tsconfig 內容。\n *\n * @returns 繼承 @bluelovers/tsconfig 的 tsconfig 物件。\n * @deprecated\n */\nexport function getDefaultTsconfig()\n{\n\treturn {\n\t\textends: \"@bluelovers/tsconfig/esm/mapfile.json\",\n\t}\n}\n"]}

package/lib/package.demo.json

@@ -8,7 +8,7 @@
     "@bluelovers/tsconfig": "^2.0.3",
     "@types/jest": "^30.0.0",
     "@types/node": "^26.6.6",
-    "@yarn-tool/require-resolve": "^4.0.15",
+    "@yarn-tool/require-resolve": "^4.0.16",
     "@yarn-tool/ws-find-up-paths": "^1.0.27"
   }
 }

package/lib/util.d.ts

@@ -1,9 +1,8 @@
 /**
- * 判斷兩個路徑是否為同一位置（已標記 @deprecated，請改用 path-is-same）。
- * Check whether two paths point to the same location (marked `@deprecated`; use `path-is-same` instead).
+ * 判斷兩個路徑是否為同一位置
  *
- * @param p1 第一個路徑。The first path.
- * @param p2 第二個路徑。The second path.
- * @returns 兩路徑相同時為 true；任一為空則直接 false。`true` when they match; `false` when either input is empty.
+ * @param p1 第一個路徑。
+ * @param p2 第二個路徑。
+ * @returns 兩路徑相同時為 true；任一為空則直接 false。
  */
 export declare function isSamePath(p1: string, p2: string): boolean;

package/lib/util.js

@@ -4,24 +4,25 @@ exports.isSamePath = isSamePath;
 const path_1 = require("path");
 const path_is_same_1 = require("path-is-same");
 /**
- * 判斷兩個路徑是否為同一位置（已標記 @deprecated，請改用 path-is-same）。
- * Check whether two paths point to the same location (marked `@deprecated`; use `path-is-same` instead).
+ * 判斷兩個路徑是否為同一位置
  *
- * @param p1 第一個路徑。The first path.
- * @param p2 第二個路徑。The second path.
- * @returns 兩路徑相同時為 true；任一為空則直接 false。`true` when they match; `false` when either input is empty.
+ * @param p1 第一個路徑。
+ * @param p2 第二個路徑。
+ * @returns 兩路徑相同時為 true；任一為空則直接 false。
  */
 function isSamePath(p1, p2) {
-    // 任一輸入為空時無法比較，直接回傳 false 以免 relative() 產生誤判。
-    // Bail out with `false` when either input is empty so `relative()` cannot produce a misleading result.
+    /**
+     * 任一輸入為空時無法比較，直接回傳 false 以免 relative() 產生誤判。
+     */
     if (!p1 || !p2) {
         return false;
     }
     else if ((0, path_is_same_1.pathIsSame)(p1, p2)) {
         return true;
     }
-    // 字面不相同時再以 relative 判斷，涵蓋結尾斜線或 '.' 等等價寫法。
-    // When the literals differ, fall back to `relative()` to cover equivalent spellings such as trailing slashes or `.`.
+    /**
+     * 字面不相同時再以 relative 判斷，涵蓋結尾斜線或 '.' 等等價寫法。
+     */
     let s = (0, path_1.relative)(p1, p2);
     return (s === '.' || s === '');
 }

package/lib/util.js.map

@@ -1 +1 @@
-{"version":3,"file":"util.js","sourceRoot":"","sources":["util.ts"],"names":[],"mappings":";;AAWA,gCAiBC;AA5BD,+BAAgC;AAChC,+CAA0C;AAE1C;;;;;;;GAOG;AACH,SAAgB,UAAU,CAAC,EAAU,EAAE,EAAU;IAEhD,6CAA6C;IAC7C,uGAAuG;IACvG,IAAI,CAAC,EAAE,IAAI,CAAC,EAAE,EACd,CAAC;QACA,OAAO,KAAK,CAAC;IACd,CAAC;SACI,IAAI,IAAA,yBAAU,EAAC,EAAE,EAAE,EAAE,CAAC,EAC3B,CAAC;QACA,OAAO,IAAI,CAAC;IACb,CAAC;IAED,0CAA0C;IAC1C,qHAAqH;IACrH,IAAI,CAAC,GAAG,IAAA,eAAQ,EAAC,EAAE,EAAE,EAAE,CAAC,CAAC;IACzB,OAAO,CAAC,CAAC,KAAK,GAAG,IAAI,CAAC,KAAK,EAAE,CAAC,CAAC;AAChC,CAAC","sourcesContent":["import { relative } from \"path\";\nimport { pathIsSame } from 'path-is-same';\n\n/**\n * 判斷兩個路徑是否為同一位置（已標記 @deprecated，請改用 path-is-same）。\n * Check whether two paths point to the same location (marked `@deprecated`; use `path-is-same` instead).\n *\n * @param p1 第一個路徑。The first path.\n * @param p2 第二個路徑。The second path.\n * @returns 兩路徑相同時為 true；任一為空則直接 false。`true` when they match; `false` when either input is empty.\n */\nexport function isSamePath(p1: string, p2: string)\n{\n\t// 任一輸入為空時無法比較，直接回傳 false 以免 relative() 產生誤判。\n\t// Bail out with `false` when either input is empty so `relative()` cannot produce a misleading result.\n\tif (!p1 || !p2)\n\t{\n\t\treturn false;\n\t}\n\telse if (pathIsSame(p1, p2))\n\t{\n\t\treturn true;\n\t}\n\n\t// 字面不相同時再以 relative 判斷，涵蓋結尾斜線或 '.' 等等價寫法。\n\t// When the literals differ, fall back to `relative()` to cover equivalent spellings such as trailing slashes or `.`.\n\tlet s = relative(p1, p2);\n\treturn (s === '.' || s === '');\n}\n"]}
+{"version":3,"file":"util.js","sourceRoot":"","sources":["util.ts"],"names":[],"mappings":";;AAUA,gCAmBC;AA7BD,+BAAgC;AAChC,+CAA0C;AAE1C;;;;;;GAMG;AACH,SAAgB,UAAU,CAAC,EAAU,EAAE,EAAU;IAEhD;;OAEG;IACH,IAAI,CAAC,EAAE,IAAI,CAAC,EAAE,EACd,CAAC;QACA,OAAO,KAAK,CAAC;IACd,CAAC;SACI,IAAI,IAAA,yBAAU,EAAC,EAAE,EAAE,EAAE,CAAC,EAC3B,CAAC;QACA,OAAO,IAAI,CAAC;IACb,CAAC;IAED;;OAEG;IACH,IAAI,CAAC,GAAG,IAAA,eAAQ,EAAC,EAAE,EAAE,EAAE,CAAC,CAAC;IACzB,OAAO,CAAC,CAAC,KAAK,GAAG,IAAI,CAAC,KAAK,EAAE,CAAC,CAAC;AAChC,CAAC","sourcesContent":["import { relative } from \"path\";\nimport { pathIsSame } from 'path-is-same';\n\n/**\n * 判斷兩個路徑是否為同一位置\n *\n * @param p1 第一個路徑。\n * @param p2 第二個路徑。\n * @returns 兩路徑相同時為 true；任一為空則直接 false。\n */\nexport function isSamePath(p1: string, p2: string)\n{\n\t/**\n\t * 任一輸入為空時無法比較，直接回傳 false 以免 relative() 產生誤判。\n\t */\n\tif (!p1 || !p2)\n\t{\n\t\treturn false;\n\t}\n\telse if (pathIsSame(p1, p2))\n\t{\n\t\treturn true;\n\t}\n\n\t/**\n\t * 字面不相同時再以 relative 判斷，涵蓋結尾斜線或 '.' 等等價寫法。\n\t */\n\tlet s = relative(p1, p2);\n\treturn (s === '.' || s === '');\n}\n"]}

package/package.json

@@ -1,13 +1,16 @@
 {
   "name": "create-yarn-workspaces",
-  "version": "3.0.35",
-  "description": "Quickly initialize Yarn Workspaces project structure",
+  "version": "3.0.37",
+  "description": "Quickly initialize a Workspaces project structure compatible with both Yarn and pnpm And Lerna",
   "keywords": [
     "create",
     "yarn-workspaces",
     "cli",
     "init",
+    "lerna",
+    "monorepo",
     "npm",
+    "pnpm",
     "workspace",
     "workspaces",
     "ws",
@@ -46,6 +49,7 @@
     "test:node:bin:coverage": "node --run test:node:bin -- --experimental-test-coverage --",
     "test:snapshot": "pnpm run test -u",
     "test:tsc": "tsc --noEmit & echo typescript check done",
+    "test:tsc:all": "node --run test:tsc && node --run test:tsc:sub",
     "test:tsc:sub": "cd test && tsc --noEmit & echo Type checking completed (test)",
     "test:tsd": "ynpx tsd",
     "npm:publish": "npm publish",
@@ -60,16 +64,18 @@
   },
   "dependencies": {
     "@bluelovers/tsconfig": "^2.0.3",
+    "@clack/prompts": "^1.8.1",
     "@ts-type/package-dts": "^3.0.14",
     "@types/jest": "^30.0.0",
     "@types/node": "^26.6.5",
     "@yarn-tool/find-root": "^2.0.29",
-    "@yarn-tool/fix-all": "^3.0.30",
-    "@yarn-tool/pkg-entry-util": "^3.0.24",
+    "@yarn-tool/fix-all": "^3.0.31",
+    "@yarn-tool/pkg-entry-util": "^3.0.26",
     "@yarn-tool/require-resolve": "^4.0.16",
-    "@yarn-tool/static-file": "^3.0.29",
+    "@yarn-tool/static-file": "^3.0.31",
     "@yarn-tool/ws-find-up-paths": "^1.0.27",
     "debug-color2": "^1.3.2",
+    "fast-glob": "^3.3.3",
     "find-yarn-workspace-root2": "^1.2.59",
     "fs-extra": "^11.4.1",
     "path-is-same": "^1.0.29",
@@ -84,5 +90,5 @@
     "@yarn-tool/ncu": "^3.0.19",
     "@yarn-tool/write-package-json": "^1.0.22"
   },
-  "gitHead": "d4f1a8f00016582d99cd0bb87a19faacded430a8"
+  "gitHead": "491c2429f96718eca2e628c00a8cd0cf5ade31c2"
 }

package/yargs-setting.d.ts

@@ -1,10 +1,7 @@
 /**
  * Yargs 命令列參數設定模組
- * Yargs Command Line Arguments Configuration Module
  *
  * 提供 Workspaces 初始化相關的命令列參數設定與驗證
- * Provides command line argument configuration and validation for
- * workspace initialization
  *
  * @author user
  * @since 2019/5/16
@@ -13,19 +10,13 @@ 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
+ * - interactive: 啟用互動介面
  *
  * @template T - Yargs 參數類型 / Yargs argument type
  * @param yargs - Yargs 實例 / Yargs instance
@@ -51,6 +42,8 @@ export declare function setupWorkspacesInitToYargs<T extends any>(yargs: Argv<T>
     ignoreParentWorkspaces: boolean;
 } & {
     debug: boolean;
+} & {
+    interactive: boolean;
 }>;
 /**
  * 預設導出設定函式