@yarn-tool/detect-package-manager 1.0.9 → 1.0.11

package/CHANGELOG.md

@@ -3,6 +3,64 @@
 All notable changes to this project will be documented in this file.
 See [Conventional Commits](https://conventionalcommits.org) for commit guidelines.
 
+## [1.0.11](https://github.com/bluelovers/ws-yarn-workspaces/compare/@yarn-tool/detect-package-manager@1.0.10...@yarn-tool/detect-package-manager@1.0.11) (2026-10-12)
+
+
+
+### 📚　Documentation
+
+* add jsdoc ([9cb9b13](https://github.com/bluelovers/ws-yarn-workspaces/commit/9cb9b13eda8c357221ad1b754458aa9916eada22))
+
+
+### 🚨　Tests
+
+* **snap:** update snapshots ([c9945a5](https://github.com/bluelovers/ws-yarn-workspaces/commit/c9945a5b9cd723d38ded2a69b83e2e83ecc3b524))
+* **test:** 將測試框架從 jest 遷移至 node:test ([3af9774](https://github.com/bluelovers/ws-yarn-workspaces/commit/3af9774964abc48083ec60b2021c1cec08874803))
+
+
+### 🛠　Build System
+
+* update build ([3186340](https://github.com/bluelovers/ws-yarn-workspaces/commit/3186340758172427cb1e9b8955f6fd677abac625))
+* **deps:** 更新測試腳本與依賴以支援 node:test ([f9c71c7](https://github.com/bluelovers/ws-yarn-workspaces/commit/f9c71c795c792c5c7ed9d613ce7e9c3c726c39d5))
+
+
+### ♻️　Chores
+
+* **workspace:** 更新測試指令路徑與新增工作區搜尋選項 ([a80039d](https://github.com/bluelovers/ws-yarn-workspaces/commit/a80039dd8c691e047466966ffc8f8a4e2e31c03f))
+
+
+### 🔖　Miscellaneous
+
+* . ([e5788f8](https://github.com/bluelovers/ws-yarn-workspaces/commit/e5788f84551b870490a96d0a5d67d8d542481373))
+
+
+
+## [1.0.10](https://github.com/bluelovers/ws-yarn-workspaces/compare/@yarn-tool/detect-package-manager@1.0.9...@yarn-tool/detect-package-manager@1.0.10) (2026-09-06)
+
+
+
+### 🚨　Tests
+
+* **@yarn-tool/detect-package-manager:** 將測試驗證方式從 snapshot 改為內容比對 ([ee6f231](https://github.com/bluelovers/ws-yarn-workspaces/commit/ee6f2311f1caa4ffac16ca7c8069a4f31fb4ef09))
+* **tests:** 新增與更新多個套件的單元測試快照 ([11628a4](https://github.com/bluelovers/ws-yarn-workspaces/commit/11628a47aa48be30829cf615a52d7b2b1b273d43))
+
+
+### 🛠　Build System
+
+* update Static Files ([b2f5d72](https://github.com/bluelovers/ws-yarn-workspaces/commit/b2f5d7216773c53eb35f267ba34f8788543d46a1))
+
+
+### ♻️　Chores
+
+* **workspace:** 將所有套件的指令從 yarn 改為 pnpm 並更新依賴版本 ([0505892](https://github.com/bluelovers/ws-yarn-workspaces/commit/0505892e5e7c356f8cf59495fefda1aa681499c6))
+
+
+### 🔖　Miscellaneous
+
+* . ([b545589](https://github.com/bluelovers/ws-yarn-workspaces/commit/b54558925d67304019e2b4f9bb3c4671c429a96e))
+
+
+
 ## [1.0.9](https://github.com/bluelovers/ws-yarn-workspaces/compare/@yarn-tool/detect-package-manager@1.0.8...@yarn-tool/detect-package-manager@1.0.9) (2026-04-26)
 
 

package/README.md

@@ -54,7 +54,7 @@ _runtime 選項輸入類型 - 可接受布林值或 IOptionsWhichPackageManager
 type IRuntimeOptionInput = boolean | IOptionsWhichPackageManager;
 ```
 
-## API (API)
+## API 文件 (API Documentation)
 
 ### whichPackageManagerSync(npmClients?: IPackageManager[], returnDefaultOrOptions?: IRuntimeOptionInput): IPackageManager | undefined
 
@@ -116,6 +116,19 @@ type IRuntimeOptionInput = boolean | IOptionsWhichPackageManager;
 
 **回傳 (Returns):** AsyncGenerator yields `[packageManager, commandPath]` tuples
 
+## 組態設定 (Configuration)
+
+所有偵測函式共用同一組選項，可透過 `IRuntimeOptionInput`（布林值或 `IOptionsWhichPackageManager` 物件）傳入：
+
+| 選項 (Option) | 型別 (Type) | 預設值 (Default) | 說明 (Description) |
+| --- | --- | --- | --- |
+| `returnDefault` | `boolean` | `false` | 找不到任何套件管理器時，是否回傳優先順序中的第一個作為預設值 / Whether to return the first entry of the priority order as fallback when none is found |
+| `noUseDefaultClients` | `boolean` | `false` | 只使用使用者指定的套件管理器，不合併預設優先順序 / Only use user-specified package managers; do not merge the default priority order |
+
+- 預設優先順序 (Default priority)：`pnpm` → `yarn` → `npm`
+- 直接傳入 `true` 等同於 `{ returnDefault: true }` / Passing `true` directly is equivalent to `{ returnDefault: true }`
+- 若完全未指定套件管理器列表，則依預設優先順序檢查 / When no package manager list is given, detection follows the default priority order
+
 ## 安裝 (Installation)
 
 ```bash
@@ -134,7 +147,9 @@ pnpm add @yarn-tool/detect-package-manager
 npm install @yarn-tool/detect-package-manager
 ```
 
-## 範例 (Examples)
+## 用法 (Usage)
+
+以下範例展示常見的使用方式 (The following examples show common usage):
 
 ```typescript
 import {

package/index.d.ts

@@ -13,6 +13,12 @@ export declare const enum EnumPackageManager {
  * Supported package manager types
  */
 export type IPackageManager = ITSTypeAndStringLiteral<EnumPackageManager>;
+/**
+ * 支援的套件管理器型別，並允許擴充額外的自訂字串
+ * Supported package manager type, extended with extra custom string literals
+ *
+ * @typeParam T - 額外允許的自訂型別 / Additional custom literal type allowed
+ */
 export type IPackageManager2<T extends string> = IPackageManager | T;
 /**
  * 偵測結果類型 - 包含套件管理器名稱和命令路徑
@@ -80,13 +86,6 @@ export declare function handleOptionsWhichPackageManager<T extends string = IPac
  * Merge user-specified priority with default order
  */
 export declare function _handleClientsToCheck<T extends string = IPackageManager>(npmClients?: ITSArrayListMaybeReadonly<T> | undefined, options?: IOptionsWhichPackageManager): readonly IPackageManager2<T>[];
-/**
- * 使用 which 依序檢查套件管理器列表，返回第一個可用的
- * Sequentially check package managers using which, return the first available one
- *
- * @param npmClients - 套件管理器列表 / Package manager list
- * @returns 可用的套件管理器名稱 / Available package manager name
- */
 /**
  * 非同步生成器 - 使用 which 依序檢查套件管理器列表
  * Async generator - sequentially check package managers using which
@@ -122,13 +121,6 @@ export declare function whichPackageManagerAsync(npmClients?: ITSArrayListMaybeR
  * @returns 所有可用的套件管理器陣列 / Array of all available package managers
  */
 export declare function whichPackageManagerAsyncAll(npmClients?: ITSArrayListMaybeReadonly<IPackageManager> | undefined, returnDefaultOrOptions?: IRuntimeOptionInput): Promise<IPackageManager[]>;
-/**
- * 使用 which 依序檢查套件管理器列表，以同步生成器方式 yield 所有可用的套件管理器
- * Sequentially check package managers using which, yield all available package managers via sync generator
- *
- * @param npmClients - 套件管理器列表 / Package manager list
- * @returns 可用的套件管理器（透過 yield）/ Available package manager (via yield)
- */
 /**
  * 同步生成器 - 使用 which 依序檢查套件管理器列表
  * Sync generator - sequentially check package managers using which
@@ -164,4 +156,8 @@ export declare function whichPackageManagerSyncAll(npmClients?: ITSArrayListMayb
  * @returns 可用的套件管理器名稱 / Available package manager name
  */
 export declare function whichPackageManagerSync(npmClients?: ITSArrayListMaybeReadonly<IPackageManager> | undefined, returnDefaultOrOptions?: IRuntimeOptionInput): IPackageManager;
+/**
+ * 預設匯出：同步偵測第一個可用的套件管理器
+ * Default export: synchronously detect the first available package manager
+ */
 export default whichPackageManagerSync;

package/index.js

@@ -46,10 +46,22 @@ const _whichOptions = {
  */
 function _handleOptionsWhichPackageManagerCore(returnDefaultOrOptions) {
     if (typeof returnDefaultOrOptions === 'boolean') {
+        /**
+         * 布林值是 `returnDefault` 的簡寫形式，
+         * 正規化成物件後，後續程式只需處理單一型別
+         * A boolean is shorthand for `returnDefault`;
+         * normalizing to an object keeps downstream code single-typed
+         */
         returnDefaultOrOptions = {
             returnDefault: returnDefaultOrOptions,
         };
     }
+    /**
+     * 未傳入任何選項時以空物件代替 undefined，
+     * 讓呼叫端不必額外處理 null/undefined 分支
+     * When no option is given, return an empty object instead of undefined
+     * so callers never have to handle a null/undefined branch
+     */
     return returnDefaultOrOptions !== null && returnDefaultOrOptions !== void 0 ? returnDefaultOrOptions : {};
 }
 /**
@@ -81,21 +93,30 @@ function _handleClientsToCheck(npmClients, options) {
      * Merge user-specified priority with default order
      */
     if (npmClients === null || npmClients === void 0 ? void 0 : npmClients.length) {
-        // 過濾不合法的名稱
+        /**
+         * 過濾不合法的名稱（空字串或 undefined）
+         * Filter out invalid names (empty string or undefined)
+         */
         npmClients = npmClients.filter(v => v === null || v === void 0 ? void 0 : v.length);
+        /**
+         * `noUseDefaultClients` 時只保留使用者清單，否則追加預設順序；
+         * 以 Set 去重，避免使用者重複指定同一個套件管理器時重複檢查
+         * With `noUseDefaultClients` only the user list is kept, otherwise the
+         * default order is appended; Set de-duplicates so an entry specified
+         * twice by the user is not checked twice
+         */
         return (options === null || options === void 0 ? void 0 : options.noUseDefaultClients)
             ? [...new Set([...npmClients])]
             : [...new Set([...npmClients, ...defaultClients])];
     }
+    /**
+     * 使用者未指定任何套件管理器（或清單經篩選後為空）時，
+     * 直接以預設優先順序作為檢查清單
+     * When the user specified nothing (or the list became empty after filtering),
+     * fall back to the default priority order as the check list
+     */
     return [...defaultClients];
 }
-/**
- * 使用 which 依序檢查套件管理器列表，返回第一個可用的
- * Sequentially check package managers using which, return the first available one
- *
- * @param npmClients - 套件管理器列表 / Package manager list
- * @returns 可用的套件管理器名稱 / Available package manager name
- */
 /**
  * 非同步生成器 - 使用 which 依序檢查套件管理器列表
  * Async generator - sequentially check package managers using which
@@ -119,18 +140,40 @@ async function* _whichPackageManagerAsyncGenerator(npmClients, returnDefaultOrOp
  * @yield - 可用的套件管理器元組 [名稱, 路徑] / Available package manager tuple [name, path]
  */
 async function* _whichAsyncGeneratorCore(clientsToCheck, options) {
+    /**
+     * 追蹤是否會有任何套件管理器被找到，
+     * 供最後判斷是否需要回傳預設值
+     * Tracks whether any package manager was found,
+     * used at the end to decide if the default should be returned
+     */
     let notFound = true;
     /**
      * 依序檢查每個套件管理器是否可用
      * Check each package manager sequentially for availability
      */
     for (const client of clientsToCheck) {
+        /**
+         * `nothrow: true` 使找不到命令時回傳 null 而非丟出例外，
+         * `.catch(() => null)` 則涵蓋其他非預期錯誤，讓檢查能繼續下一個候選者
+         * `nothrow: true` makes a missing command resolve to null instead of throwing,
+         * and `.catch(() => null)` swallows unexpected errors so checking continues to the next candidate
+         */
         const commandPath = await (0, which_1.default)(client, _whichOptions).catch(() => null);
+        /**
+         * 只有找到可執行檔時才 yield，避免把不存在的套件管理器當成可用結果
+         * Only yield when the executable exists, so missing package managers are never reported as available
+         */
         if (commandPath) {
             yield [client, commandPath];
             notFound = false;
         }
     }
+    /**
+     * 全部都找不到時，若允許回傳預設值，
+     * 則以檢查清單的第一個作為回報（即使它並未安裝）
+     * When nothing was found, if defaults are allowed, report the first
+     * entry of the check list (even if it is not installed)
+     */
     if (options.returnDefault && notFound)
         return [clientsToCheck[0]];
 }
@@ -142,6 +185,12 @@ async function* _whichAsyncGeneratorCore(clientsToCheck, options) {
  * @returns 可用的套件管理器名稱 / Available package manager name
  */
 async function whichPackageManagerAsync(npmClients, returnDefaultOrOptions) {
+    /**
+     * 只取生成器第一次 yield 的結果，
+     * 找不到時 `next.value` 為 undefined，回傳 undefined
+     * Take only the first value yielded by the generator;
+     * when nothing is found `next.value` is undefined, so undefined is returned
+     */
     return _whichPackageManagerAsyncGenerator(npmClients, returnDefaultOrOptions).next().then(next => { var _a; return (_a = next.value) === null || _a === void 0 ? void 0 : _a[0]; });
 }
 /**
@@ -153,18 +202,15 @@ async function whichPackageManagerAsync(npmClients, returnDefaultOrOptions) {
  */
 async function whichPackageManagerAsyncAll(npmClients, returnDefaultOrOptions) {
     const result = [];
+    /**
+     * 逐一收集生成器 yield 的結果，只保留名稱、捨棄路徑
+     * Collect each value yielded by the generator, keeping only the name and discarding the path
+     */
     for await (const client of _whichPackageManagerAsyncGenerator(npmClients, returnDefaultOrOptions)) {
         result.push(client[0]);
     }
     return result;
 }
-/**
- * 使用 which 依序檢查套件管理器列表，以同步生成器方式 yield 所有可用的套件管理器
- * Sequentially check package managers using which, yield all available package managers via sync generator
- *
- * @param npmClients - 套件管理器列表 / Package manager list
- * @returns 可用的套件管理器（透過 yield）/ Available package manager (via yield)
- */
 /**
  * 同步生成器 - 使用 which 依序檢查套件管理器列表
  * Sync generator - sequentially check package managers using which
@@ -188,18 +234,40 @@ function* _whichPackageManagerSyncGenerator(npmClients, returnDefaultOrOptions)
  * @yield - 可用的套件管理器元組 [名稱, 路徑] / Available package manager tuple [name, path]
  */
 function* _whichSyncGeneratorCore(clientsToCheck, options) {
+    /**
+     * 追蹤是否會有任何套件管理器被找到，
+     * 供最後判斷是否需要回傳預設值
+     * Tracks whether any package manager was found,
+     * used at the end to decide if the default should be returned
+     */
     let notFound = true;
     /**
      * 依序檢查每個套件管理器是否可用
      * Check each package manager sequentially for availability
      */
     for (const client of clientsToCheck) {
+        /**
+         * `nothrow: true` 使找不到命令時回傳 null 而非丟出例外，
+         * 因此可直接以 truthy 判斷是否找到可執行檔
+         * `nothrow: true` makes a missing command return null instead of throwing,
+         * so a simple truthy check tells us whether the executable was found
+         */
         const commandPath = (0, which_1.sync)(client, _whichOptions);
+        /**
+         * 只有找到可執行檔時才 yield，避免把不存在的套件管理器當成可用結果
+         * Only yield when the executable exists, so missing package managers are never reported as available
+         */
         if (commandPath) {
             yield [client, commandPath];
             notFound = false;
         }
     }
+    /**
+     * 全部都找不到時，若允許回傳預設值，
+     * 則以檢查清單的第一個作為回報（即使它並未安裝）
+     * When nothing was found, if defaults are allowed, report the first
+     * entry of the check list (even if it is not installed)
+     */
     if (options.returnDefault && notFound)
         return [clientsToCheck[0]];
 }
@@ -212,6 +280,10 @@ function* _whichSyncGeneratorCore(clientsToCheck, options) {
  */
 function whichPackageManagerSyncAll(npmClients, returnDefaultOrOptions) {
     const result = [];
+    /**
+     * 逐一收集生成器 yield 的結果，只保留名稱、捨棄路徑
+     * Collect each value yielded by the generator, keeping only the name and discarding the path
+     */
     for (const client of _whichPackageManagerSyncGenerator(npmClients, returnDefaultOrOptions)) {
         result.push(client[0]);
     }
@@ -226,7 +298,17 @@ function whichPackageManagerSyncAll(npmClients, returnDefaultOrOptions) {
  */
 function whichPackageManagerSync(npmClients, returnDefaultOrOptions) {
     var _a;
+    /**
+     * 只取生成器第一次 yield 的結果，
+     * 找不到時 `next.value` 為 undefined，回傳 undefined
+     * Take only the first value yielded by the generator;
+     * when nothing is found `next.value` is undefined, so undefined is returned
+     */
     return (_a = _whichPackageManagerSyncGenerator(npmClients, returnDefaultOrOptions).next().value) === null || _a === void 0 ? void 0 : _a[0];
 }
+/**
+ * 預設匯出：同步偵測第一個可用的套件管理器
+ * Default export: synchronously detect the first available package manager
+ */
 exports.default = whichPackageManagerSync;
 //# 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":["import _ from 'lodash';\nimport { ITSAsyncGenerator, ITSGenerator, ITSTypeAndStringLiteral, ITSArrayListMaybeReadonly } from 'ts-type';\nimport which, { sync as whichSync } from 'which';\n\n/**\n * 支援的套件管理器類型\n * Supported package manager types\n */\nexport const enum EnumPackageManager\n{\n\t'yarn' = 'yarn',\n\t'npm' = 'npm',\n\t'pnpm' = 'pnpm',\n};\n\n/**\n * 支援的套件管理器類型\n * Supported package manager types\n */\nexport type IPackageManager = ITSTypeAndStringLiteral<EnumPackageManager>;\nexport type IPackageManager2<T extends string> = IPackageManager | T;\n\n/**\n * 預設的套件管理器優先順序\n * Default package manager priority order\n */\nconst defaultClients: readonly IPackageManager[] = [EnumPackageManager.pnpm, EnumPackageManager.yarn, EnumPackageManager.npm];\n\n/**\n * 偵測結果類型 - 包含套件管理器名稱和命令路徑\n * Detection result type - contains package manager name and command path\n *\n * @typeParam T - 套件管理器類型 / Package manager type\n */\nexport type IResultDetectPackageManagerRaw<T extends IPackageManager = IPackageManager> = IResultDetectRawCore<T>;\n\n/**\n * 偵測結果核心類型 - 元組 [名稱, 路徑?]\n * Detection result core type - tuple [name, path?]\n *\n * @typeParam T - 字串類型 / String type\n */\nexport type IResultDetectRawCore<T extends string = IPackageManager> = readonly [T, string?];\n\n/**\n * which 命令選項配置\n * which command options configuration\n */\nconst _whichOptions: which.Options = {\n\tnothrow: true,\n}\n\n/**\n * 選項配置介面\n * Options configuration interface\n */\nexport interface IOptionsWhichPackageManager\n{\n\t/**\n\t * 當找不到時是否返回預設值\n\t * Whether to return default when not found\n\t */\n\treturnDefault?: boolean;\n\t/**\n\t * 只使用使用者指定的套件管理器\n\t * 不合併使用者指定的優先順序與預設順序\n\t * Only use user-specified package managers\n\t * Do not merge user-specified priority with default order\n\t */\n\tnoUseDefaultClients?: boolean;\n}\n\n/**\n * 選項輸入類型 - 可接受布林值或選項物件\n * Options input type - accepts boolean or options object\n */\nexport type IRuntimeOptionInput = boolean | IOptionsWhichPackageManager;\n\n/**\n * 核心選項處理函數 - 將輸入轉換為標準選項物件\n * Core options handler function - converts input to standard options object\n *\n * @param returnDefaultOrOptions - 布林值或選項物件 / Boolean or options object\n * @returns 標準選項物件 / Standard options object\n */\nexport function _handleOptionsWhichPackageManagerCore(returnDefaultOrOptions?: IRuntimeOptionInput): IOptionsWhichPackageManager\n{\n\tif (typeof returnDefaultOrOptions === 'boolean')\n\t{\n\t\treturnDefaultOrOptions = {\n\t\t\treturnDefault: returnDefaultOrOptions,\n\t\t}\n\t}\n\n\treturn returnDefaultOrOptions ?? {};\n}\n\n/**\n * 處理套件管理器選項與客戶端列表\n * Handle package manager options and client list\n *\n * @param npmClients - 套件管理器列表 / Package manager list\n * @param returnDefaultOrOptions - 選項輸入 / Options input\n * @returns 包含選項與檢查列表的物件 / Object containing options and check list\n */\nexport function handleOptionsWhichPackageManager<T extends string = IPackageManager>(npmClients?: ITSArrayListMaybeReadonly<IPackageManager2<T>> | undefined, returnDefaultOrOptions?: IRuntimeOptionInput)\n{\n\treturnDefaultOrOptions = _handleOptionsWhichPackageManagerCore(returnDefaultOrOptions);\n\n\treturn {\n\t\toptions: returnDefaultOrOptions,\n\t\t/**\n\t\t * 合併使用者指定的優先順序與預設順序\n\t\t * Merge user-specified priority with default order\n\t\t */\n\t\tclientsToCheck: _handleClientsToCheck<T>(npmClients as T[], returnDefaultOrOptions),\n\t};\n}\n\n/**\n * 合併使用者指定的優先順序與預設順序\n * Merge user-specified priority with default order\n */\nexport function _handleClientsToCheck<T extends string = IPackageManager>(npmClients?: ITSArrayListMaybeReadonly<T> | undefined, options?: IOptionsWhichPackageManager): readonly IPackageManager2<T>[]\n{\n\t/**\n\t * 合併使用者指定的優先順序與預設順序\n\t * Merge user-specified priority with default order\n\t */\n\tif (npmClients?.length)\n\t{\n\t\t// 過濾不合法的名稱\n\t\tnpmClients = npmClients.filter(v => v?.length);\n\n\t\treturn options?.noUseDefaultClients\n\t\t\t? [...new Set([...npmClients])]\n\t\t\t: [...new Set([...npmClients, ...defaultClients])];\n\t}\n\n\treturn [...defaultClients];\n}\n\n/**\n * 使用 which 依序檢查套件管理器列表，返回第一個可用的\n * Sequentially check package managers using which, return the first available one\n *\n * @param npmClients - 套件管理器列表 / Package manager list\n * @returns 可用的套件管理器名稱 / Available package manager name\n */\n/**\n * 非同步生成器 - 使用 which 依序檢查套件管理器列表\n * Async generator - sequentially check package managers using which\n *\n * @param npmClients - 套件管理器列表 / Package manager list\n * @param returnDefaultOrOptions - 選項輸入 (布林值或 IOptionsWhichPackageManager) / Options input (boolean or IOptionsWhichPackageManager)\n * @yield - 可用的套件管理器元組 [名稱, 路徑] / Available package manager tuple [name, path]\n */\n// @ts-ignore\nexport async function* _whichPackageManagerAsyncGenerator<T extends string = IPackageManager>(npmClients?: ITSArrayListMaybeReadonly<IPackageManager2<T>> | undefined, returnDefaultOrOptions?: IRuntimeOptionInput): ITSAsyncGenerator<IResultDetectPackageManagerRaw<IPackageManager2<T>>>\n{\n\n\tconst { clientsToCheck, options } = handleOptionsWhichPackageManager(npmClients, returnDefaultOrOptions);\n\n\tyield* _whichAsyncGeneratorCore(clientsToCheck, options) as any;\n}\n\n/**\n * 非同步生成器核心實作 - 依序檢查每個套件管理器是否可用\n * Async generator core implementation - sequentially check each package manager for availability\n *\n * @typeParam T - 套件管理器類型 / Package manager type\n * @param clientsToCheck - 要檢查的套件管理器列表 / List of package managers to check\n * @param options - 選項 / Options\n * @yield - 可用的套件管理器元組 [名稱, 路徑] / Available package manager tuple [name, path]\n */\nexport async function* _whichAsyncGeneratorCore<T extends string = IPackageManager>(clientsToCheck: ITSArrayListMaybeReadonly<T>, options: IOptionsWhichPackageManager): ITSAsyncGenerator<IResultDetectRawCore<T>>\n{\n\tlet notFound = true;\n\n\t/**\n\t * 依序檢查每個套件管理器是否可用\n\t * Check each package manager sequentially for availability\n\t */\n\tfor (const client of clientsToCheck)\n\t{\n\t\tconst commandPath = await which(client, _whichOptions).catch(() => null);\n\t\tif (commandPath)\n\t\t{\n\t\t\tyield [client, commandPath as string] as IResultDetectRawCore<T>;\n\t\t\tnotFound = false;\n\t\t}\n\t}\n\n\tif (options.returnDefault && notFound) return [clientsToCheck[0]] as IResultDetectRawCore<T>;\n}\n\n/**\n * 使用 which 依序檢查套件管理器列表，返回第一個可用的\n * Sequentially check package managers using which, return the first available one\n *\n * @param npmClients - 套件管理器列表 / Package manager list\n * @returns 可用的套件管理器名稱 / Available package manager name\n */\nexport async function whichPackageManagerAsync(npmClients?: ITSArrayListMaybeReadonly<IPackageManager> | undefined, returnDefaultOrOptions?: IRuntimeOptionInput): Promise<IPackageManager>\n{\n\treturn _whichPackageManagerAsyncGenerator(npmClients, returnDefaultOrOptions).next().then(next => next.value?.[0]);\n}\n\n/**\n * 使用 which 依序檢查套件管理器列表，返回所有可用的套件管理器陣列\n * Sequentially check package managers using which, return all available package managers as array\n *\n * @param npmClients - 套件管理器列表 / Package manager list\n * @returns 所有可用的套件管理器陣列 / Array of all available package managers\n */\nexport async function whichPackageManagerAsyncAll(npmClients?: ITSArrayListMaybeReadonly<IPackageManager> | undefined, returnDefaultOrOptions?: IRuntimeOptionInput): Promise<IPackageManager[]>\n{\n\tconst result: IPackageManager[] = [];\n\n\tfor await (const client of _whichPackageManagerAsyncGenerator(npmClients, returnDefaultOrOptions))\n\t{\n\t\tresult.push(client[0]);\n\t}\n\n\treturn result;\n}\n\n/**\n * 使用 which 依序檢查套件管理器列表，以同步生成器方式 yield 所有可用的套件管理器\n * Sequentially check package managers using which, yield all available package managers via sync generator\n *\n * @param npmClients - 套件管理器列表 / Package manager list\n * @returns 可用的套件管理器（透過 yield）/ Available package manager (via yield)\n */\n/**\n * 同步生成器 - 使用 which 依序檢查套件管理器列表\n * Sync generator - sequentially check package managers using which\n *\n * @param npmClients - 套件管理器列表 / Package manager list\n * @param returnDefaultOrOptions - 選項輸入 (布林值或 IOptionsWhichPackageManager) / Options input (boolean or IOptionsWhichPackageManager)\n * @yield - 可用的套件管理器元組 [名稱, 路徑] / Available package manager tuple [name, path]\n */\n// @ts-ignore\nexport function* _whichPackageManagerSyncGenerator<T extends string = IPackageManager>(npmClients?: ITSArrayListMaybeReadonly<IPackageManager2<T>> | undefined, returnDefaultOrOptions?: IRuntimeOptionInput): ITSGenerator<IResultDetectPackageManagerRaw<IPackageManager2<T>>>\n{\n\tconst { clientsToCheck, options } = handleOptionsWhichPackageManager(npmClients, returnDefaultOrOptions);\n\n\tyield* _whichSyncGeneratorCore(clientsToCheck, options) as any;\n}\n\n/**\n * 同步生成器核心實作 - 依序檢查每個套件管理器是否可用\n * Sync generator core implementation - sequentially check each package manager for availability\n *\n * @typeParam T - 套件管理器類型 / Package manager type\n * @param clientsToCheck - 要檢查的套件管理器列表 / List of package managers to check\n * @param options - 選項 / Options\n * @yield - 可用的套件管理器元組 [名稱, 路徑] / Available package manager tuple [name, path]\n */\nexport function* _whichSyncGeneratorCore<T extends string = IPackageManager>(clientsToCheck: ITSArrayListMaybeReadonly<T>, options: IOptionsWhichPackageManager): ITSGenerator<IResultDetectRawCore<T>>\n{\n\tlet notFound = true;\n\n\t/**\n\t * 依序檢查每個套件管理器是否可用\n\t * Check each package manager sequentially for availability\n\t */\n\tfor (const client of clientsToCheck)\n\t{\n\t\tconst commandPath = whichSync(client, _whichOptions);\n\t\tif (commandPath)\n\t\t{\n\t\t\tyield [client, commandPath as string] as IResultDetectRawCore<T>;\n\t\t\tnotFound = false;\n\t\t}\n\t}\n\n\tif (options.returnDefault && notFound) return [clientsToCheck[0]] as IResultDetectRawCore<T>;\n}\n\n/**\n * 使用 which 依序檢查套件管理器列表，返回所有可用的套件管理器陣列（同步版本）\n * Sequentially check package managers using which, return all available package managers as array (sync version)\n *\n * @param npmClients - 套件管理器列表 / Package manager list\n * @returns 所有可用的套件管理器陣列 / Array of all available package managers\n */\nexport function whichPackageManagerSyncAll(npmClients?: ITSArrayListMaybeReadonly<IPackageManager> | undefined, returnDefaultOrOptions?: IRuntimeOptionInput): IPackageManager[]\n{\n\tconst result: IPackageManager[] = [];\n\n\tfor (const client of _whichPackageManagerSyncGenerator(npmClients, returnDefaultOrOptions))\n\t{\n\t\tresult.push(client[0]);\n\t}\n\n\treturn result;\n}\n\n/**\n * 使用 which 依序檢查套件管理器列表，返回第一個可用的\n * Sequentially check package managers using which, return the first available one\n *\n * @param npmClients - 套件管理器列表 / Package manager list\n * @returns 可用的套件管理器名稱 / Available package manager name\n */\nexport function whichPackageManagerSync(npmClients?: ITSArrayListMaybeReadonly<IPackageManager> | undefined, returnDefaultOrOptions?: IRuntimeOptionInput): IPackageManager\n{\n\treturn _whichPackageManagerSyncGenerator(npmClients, returnDefaultOrOptions).next().value?.[0]\n}\n\nexport default whichPackageManagerSync\n"]}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["index.ts"],"names":[],"mappings":"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","sourcesContent":["import _ from 'lodash';\nimport { ITSAsyncGenerator, ITSGenerator, ITSTypeAndStringLiteral, ITSArrayListMaybeReadonly } from 'ts-type';\nimport which, { sync as whichSync } from 'which';\n\n/**\n * 支援的套件管理器類型\n * Supported package manager types\n */\nexport const enum EnumPackageManager\n{\n\t'yarn' = 'yarn',\n\t'npm' = 'npm',\n\t'pnpm' = 'pnpm',\n};\n\n/**\n * 支援的套件管理器類型\n * Supported package manager types\n */\nexport type IPackageManager = ITSTypeAndStringLiteral<EnumPackageManager>;\n/**\n * 支援的套件管理器型別，並允許擴充額外的自訂字串\n * Supported package manager type, extended with extra custom string literals\n *\n * @typeParam T - 額外允許的自訂型別 / Additional custom literal type allowed\n */\nexport type IPackageManager2<T extends string> = IPackageManager | T;\n\n/**\n * 預設的套件管理器優先順序\n * Default package manager priority order\n */\nconst defaultClients: readonly IPackageManager[] = [EnumPackageManager.pnpm, EnumPackageManager.yarn, EnumPackageManager.npm];\n\n/**\n * 偵測結果類型 - 包含套件管理器名稱和命令路徑\n * Detection result type - contains package manager name and command path\n *\n * @typeParam T - 套件管理器類型 / Package manager type\n */\nexport type IResultDetectPackageManagerRaw<T extends IPackageManager = IPackageManager> = IResultDetectRawCore<T>;\n\n/**\n * 偵測結果核心類型 - 元組 [名稱, 路徑?]\n * Detection result core type - tuple [name, path?]\n *\n * @typeParam T - 字串類型 / String type\n */\nexport type IResultDetectRawCore<T extends string = IPackageManager> = readonly [T, string?];\n\n/**\n * which 命令選項配置\n * which command options configuration\n */\nconst _whichOptions: which.Options = {\n\tnothrow: true,\n}\n\n/**\n * 選項配置介面\n * Options configuration interface\n */\nexport interface IOptionsWhichPackageManager\n{\n\t/**\n\t * 當找不到時是否返回預設值\n\t * Whether to return default when not found\n\t */\n\treturnDefault?: boolean;\n\t/**\n\t * 只使用使用者指定的套件管理器\n\t * 不合併使用者指定的優先順序與預設順序\n\t * Only use user-specified package managers\n\t * Do not merge user-specified priority with default order\n\t */\n\tnoUseDefaultClients?: boolean;\n}\n\n/**\n * 選項輸入類型 - 可接受布林值或選項物件\n * Options input type - accepts boolean or options object\n */\nexport type IRuntimeOptionInput = boolean | IOptionsWhichPackageManager;\n\n/**\n * 核心選項處理函數 - 將輸入轉換為標準選項物件\n * Core options handler function - converts input to standard options object\n *\n * @param returnDefaultOrOptions - 布林值或選項物件 / Boolean or options object\n * @returns 標準選項物件 / Standard options object\n */\nexport function _handleOptionsWhichPackageManagerCore(returnDefaultOrOptions?: IRuntimeOptionInput): IOptionsWhichPackageManager\n{\n\tif (typeof returnDefaultOrOptions === 'boolean')\n\t{\n\t\t/**\n\t\t * 布林值是 `returnDefault` 的簡寫形式，\n\t\t * 正規化成物件後，後續程式只需處理單一型別\n\t\t * A boolean is shorthand for `returnDefault`;\n\t\t * normalizing to an object keeps downstream code single-typed\n\t\t */\n\t\treturnDefaultOrOptions = {\n\t\t\treturnDefault: returnDefaultOrOptions,\n\t\t}\n\t}\n\n\t/**\n\t * 未傳入任何選項時以空物件代替 undefined，\n\t * 讓呼叫端不必額外處理 null/undefined 分支\n\t * When no option is given, return an empty object instead of undefined\n\t * so callers never have to handle a null/undefined branch\n\t */\n\treturn returnDefaultOrOptions ?? {};\n}\n\n/**\n * 處理套件管理器選項與客戶端列表\n * Handle package manager options and client list\n *\n * @param npmClients - 套件管理器列表 / Package manager list\n * @param returnDefaultOrOptions - 選項輸入 / Options input\n * @returns 包含選項與檢查列表的物件 / Object containing options and check list\n */\nexport function handleOptionsWhichPackageManager<T extends string = IPackageManager>(npmClients?: ITSArrayListMaybeReadonly<IPackageManager2<T>> | undefined, returnDefaultOrOptions?: IRuntimeOptionInput)\n{\n\treturnDefaultOrOptions = _handleOptionsWhichPackageManagerCore(returnDefaultOrOptions);\n\n\treturn {\n\t\toptions: returnDefaultOrOptions,\n\t\t/**\n\t\t * 合併使用者指定的優先順序與預設順序\n\t\t * Merge user-specified priority with default order\n\t\t */\n\t\tclientsToCheck: _handleClientsToCheck<T>(npmClients as T[], returnDefaultOrOptions),\n\t};\n}\n\n/**\n * 合併使用者指定的優先順序與預設順序\n * Merge user-specified priority with default order\n */\nexport function _handleClientsToCheck<T extends string = IPackageManager>(npmClients?: ITSArrayListMaybeReadonly<T> | undefined, options?: IOptionsWhichPackageManager): readonly IPackageManager2<T>[]\n{\n\t/**\n\t * 合併使用者指定的優先順序與預設順序\n\t * Merge user-specified priority with default order\n\t */\n\tif (npmClients?.length)\n\t{\n\t\t/**\n\t\t * 過濾不合法的名稱（空字串或 undefined）\n\t\t * Filter out invalid names (empty string or undefined)\n\t\t */\n\t\tnpmClients = npmClients.filter(v => v?.length);\n\n\t\t/**\n\t\t * `noUseDefaultClients` 時只保留使用者清單，否則追加預設順序；\n\t\t * 以 Set 去重，避免使用者重複指定同一個套件管理器時重複檢查\n\t\t * With `noUseDefaultClients` only the user list is kept, otherwise the\n\t\t * default order is appended; Set de-duplicates so an entry specified\n\t\t * twice by the user is not checked twice\n\t\t */\n\t\treturn options?.noUseDefaultClients\n\t\t\t? [...new Set([...npmClients])]\n\t\t\t: [...new Set([...npmClients, ...defaultClients])];\n\t}\n\n\t/**\n\t * 使用者未指定任何套件管理器（或清單經篩選後為空）時，\n\t * 直接以預設優先順序作為檢查清單\n\t * When the user specified nothing (or the list became empty after filtering),\n\t * fall back to the default priority order as the check list\n\t */\n\treturn [...defaultClients];\n}\n\n/**\n * 非同步生成器 - 使用 which 依序檢查套件管理器列表\n * Async generator - sequentially check package managers using which\n *\n * @param npmClients - 套件管理器列表 / Package manager list\n * @param returnDefaultOrOptions - 選項輸入 (布林值或 IOptionsWhichPackageManager) / Options input (boolean or IOptionsWhichPackageManager)\n * @yield - 可用的套件管理器元組 [名稱, 路徑] / Available package manager tuple [name, path]\n */\n// @ts-ignore\nexport async function* _whichPackageManagerAsyncGenerator<T extends string = IPackageManager>(npmClients?: ITSArrayListMaybeReadonly<IPackageManager2<T>> | undefined, returnDefaultOrOptions?: IRuntimeOptionInput): ITSAsyncGenerator<IResultDetectPackageManagerRaw<IPackageManager2<T>>>\n{\n\n\tconst { clientsToCheck, options } = handleOptionsWhichPackageManager(npmClients, returnDefaultOrOptions);\n\n\tyield* _whichAsyncGeneratorCore(clientsToCheck, options) as any;\n}\n\n/**\n * 非同步生成器核心實作 - 依序檢查每個套件管理器是否可用\n * Async generator core implementation - sequentially check each package manager for availability\n *\n * @typeParam T - 套件管理器類型 / Package manager type\n * @param clientsToCheck - 要檢查的套件管理器列表 / List of package managers to check\n * @param options - 選項 / Options\n * @yield - 可用的套件管理器元組 [名稱, 路徑] / Available package manager tuple [name, path]\n */\nexport async function* _whichAsyncGeneratorCore<T extends string = IPackageManager>(clientsToCheck: ITSArrayListMaybeReadonly<T>, options: IOptionsWhichPackageManager): ITSAsyncGenerator<IResultDetectRawCore<T>>\n{\n\t/**\n\t * 追蹤是否會有任何套件管理器被找到，\n\t * 供最後判斷是否需要回傳預設值\n\t * Tracks whether any package manager was found,\n\t * used at the end to decide if the default should be returned\n\t */\n\tlet notFound = true;\n\n\t/**\n\t * 依序檢查每個套件管理器是否可用\n\t * Check each package manager sequentially for availability\n\t */\n\tfor (const client of clientsToCheck)\n\t{\n\t\t/**\n\t\t * `nothrow: true` 使找不到命令時回傳 null 而非丟出例外，\n\t\t * `.catch(() => null)` 則涵蓋其他非預期錯誤，讓檢查能繼續下一個候選者\n\t\t * `nothrow: true` makes a missing command resolve to null instead of throwing,\n\t\t * and `.catch(() => null)` swallows unexpected errors so checking continues to the next candidate\n\t\t */\n\t\tconst commandPath = await which(client, _whichOptions).catch(() => null);\n\t\t/**\n\t\t * 只有找到可執行檔時才 yield，避免把不存在的套件管理器當成可用結果\n\t\t * Only yield when the executable exists, so missing package managers are never reported as available\n\t\t */\n\t\tif (commandPath)\n\t\t{\n\t\t\tyield [client, commandPath as string] as IResultDetectRawCore<T>;\n\t\t\tnotFound = false;\n\t\t}\n\t}\n\n\t/**\n\t * 全部都找不到時，若允許回傳預設值，\n\t * 則以檢查清單的第一個作為回報（即使它並未安裝）\n\t * When nothing was found, if defaults are allowed, report the first\n\t * entry of the check list (even if it is not installed)\n\t */\n\tif (options.returnDefault && notFound) return [clientsToCheck[0]] as IResultDetectRawCore<T>;\n}\n\n/**\n * 使用 which 依序檢查套件管理器列表，返回第一個可用的\n * Sequentially check package managers using which, return the first available one\n *\n * @param npmClients - 套件管理器列表 / Package manager list\n * @returns 可用的套件管理器名稱 / Available package manager name\n */\nexport async function whichPackageManagerAsync(npmClients?: ITSArrayListMaybeReadonly<IPackageManager> | undefined, returnDefaultOrOptions?: IRuntimeOptionInput): Promise<IPackageManager>\n{\n\t/**\n\t * 只取生成器第一次 yield 的結果，\n\t * 找不到時 `next.value` 為 undefined，回傳 undefined\n\t * Take only the first value yielded by the generator;\n\t * when nothing is found `next.value` is undefined, so undefined is returned\n\t */\n\treturn _whichPackageManagerAsyncGenerator(npmClients, returnDefaultOrOptions).next().then(next => next.value?.[0]);\n}\n\n/**\n * 使用 which 依序檢查套件管理器列表，返回所有可用的套件管理器陣列\n * Sequentially check package managers using which, return all available package managers as array\n *\n * @param npmClients - 套件管理器列表 / Package manager list\n * @returns 所有可用的套件管理器陣列 / Array of all available package managers\n */\nexport async function whichPackageManagerAsyncAll(npmClients?: ITSArrayListMaybeReadonly<IPackageManager> | undefined, returnDefaultOrOptions?: IRuntimeOptionInput): Promise<IPackageManager[]>\n{\n\tconst result: IPackageManager[] = [];\n\n\t/**\n\t * 逐一收集生成器 yield 的結果，只保留名稱、捨棄路徑\n\t * Collect each value yielded by the generator, keeping only the name and discarding the path\n\t */\n\tfor await (const client of _whichPackageManagerAsyncGenerator(npmClients, returnDefaultOrOptions))\n\t{\n\t\tresult.push(client[0]);\n\t}\n\n\treturn result;\n}\n\n/**\n * 同步生成器 - 使用 which 依序檢查套件管理器列表\n * Sync generator - sequentially check package managers using which\n *\n * @param npmClients - 套件管理器列表 / Package manager list\n * @param returnDefaultOrOptions - 選項輸入 (布林值或 IOptionsWhichPackageManager) / Options input (boolean or IOptionsWhichPackageManager)\n * @yield - 可用的套件管理器元組 [名稱, 路徑] / Available package manager tuple [name, path]\n */\n// @ts-ignore\nexport function* _whichPackageManagerSyncGenerator<T extends string = IPackageManager>(npmClients?: ITSArrayListMaybeReadonly<IPackageManager2<T>> | undefined, returnDefaultOrOptions?: IRuntimeOptionInput): ITSGenerator<IResultDetectPackageManagerRaw<IPackageManager2<T>>>\n{\n\tconst { clientsToCheck, options } = handleOptionsWhichPackageManager(npmClients, returnDefaultOrOptions);\n\n\tyield* _whichSyncGeneratorCore(clientsToCheck, options) as any;\n}\n\n/**\n * 同步生成器核心實作 - 依序檢查每個套件管理器是否可用\n * Sync generator core implementation - sequentially check each package manager for availability\n *\n * @typeParam T - 套件管理器類型 / Package manager type\n * @param clientsToCheck - 要檢查的套件管理器列表 / List of package managers to check\n * @param options - 選項 / Options\n * @yield - 可用的套件管理器元組 [名稱, 路徑] / Available package manager tuple [name, path]\n */\nexport function* _whichSyncGeneratorCore<T extends string = IPackageManager>(clientsToCheck: ITSArrayListMaybeReadonly<T>, options: IOptionsWhichPackageManager): ITSGenerator<IResultDetectRawCore<T>>\n{\n\t/**\n\t * 追蹤是否會有任何套件管理器被找到，\n\t * 供最後判斷是否需要回傳預設值\n\t * Tracks whether any package manager was found,\n\t * used at the end to decide if the default should be returned\n\t */\n\tlet notFound = true;\n\n\t/**\n\t * 依序檢查每個套件管理器是否可用\n\t * Check each package manager sequentially for availability\n\t */\n\tfor (const client of clientsToCheck)\n\t{\n\t\t/**\n\t\t * `nothrow: true` 使找不到命令時回傳 null 而非丟出例外，\n\t\t * 因此可直接以 truthy 判斷是否找到可執行檔\n\t\t * `nothrow: true` makes a missing command return null instead of throwing,\n\t\t * so a simple truthy check tells us whether the executable was found\n\t\t */\n\t\tconst commandPath = whichSync(client, _whichOptions);\n\t\t/**\n\t\t * 只有找到可執行檔時才 yield，避免把不存在的套件管理器當成可用結果\n\t\t * Only yield when the executable exists, so missing package managers are never reported as available\n\t\t */\n\t\tif (commandPath)\n\t\t{\n\t\t\tyield [client, commandPath as string] as IResultDetectRawCore<T>;\n\t\t\tnotFound = false;\n\t\t}\n\t}\n\n\t/**\n\t * 全部都找不到時，若允許回傳預設值，\n\t * 則以檢查清單的第一個作為回報（即使它並未安裝）\n\t * When nothing was found, if defaults are allowed, report the first\n\t * entry of the check list (even if it is not installed)\n\t */\n\tif (options.returnDefault && notFound) return [clientsToCheck[0]] as IResultDetectRawCore<T>;\n}\n\n/**\n * 使用 which 依序檢查套件管理器列表，返回所有可用的套件管理器陣列（同步版本）\n * Sequentially check package managers using which, return all available package managers as array (sync version)\n *\n * @param npmClients - 套件管理器列表 / Package manager list\n * @returns 所有可用的套件管理器陣列 / Array of all available package managers\n */\nexport function whichPackageManagerSyncAll(npmClients?: ITSArrayListMaybeReadonly<IPackageManager> | undefined, returnDefaultOrOptions?: IRuntimeOptionInput): IPackageManager[]\n{\n\tconst result: IPackageManager[] = [];\n\n\t/**\n\t * 逐一收集生成器 yield 的結果，只保留名稱、捨棄路徑\n\t * Collect each value yielded by the generator, keeping only the name and discarding the path\n\t */\n\tfor (const client of _whichPackageManagerSyncGenerator(npmClients, returnDefaultOrOptions))\n\t{\n\t\tresult.push(client[0]);\n\t}\n\n\treturn result;\n}\n\n/**\n * 使用 which 依序檢查套件管理器列表，返回第一個可用的\n * Sequentially check package managers using which, return the first available one\n *\n * @param npmClients - 套件管理器列表 / Package manager list\n * @returns 可用的套件管理器名稱 / Available package manager name\n */\nexport function whichPackageManagerSync(npmClients?: ITSArrayListMaybeReadonly<IPackageManager> | undefined, returnDefaultOrOptions?: IRuntimeOptionInput): IPackageManager\n{\n\t/**\n\t * 只取生成器第一次 yield 的結果，\n\t * 找不到時 `next.value` 為 undefined，回傳 undefined\n\t * Take only the first value yielded by the generator;\n\t * when nothing is found `next.value` is undefined, so undefined is returned\n\t */\n\treturn _whichPackageManagerSyncGenerator(npmClients, returnDefaultOrOptions).next().value?.[0]\n}\n\n/**\n * 預設匯出：同步偵測第一個可用的套件管理器\n * Default export: synchronously detect the first available package manager\n */\nexport default whichPackageManagerSync\n"]}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@yarn-tool/detect-package-manager",
-  "version": "1.0.9",
+  "version": "1.0.11",
   "description": "Detect available package manager (yarn, npm, pnpm) using which command",
   "keywords": [
     "detect",
@@ -36,18 +36,20 @@
   "main": "index.js",
   "scripts": {
     "review": "node --run review:coverage",
-    "review:coverage": "yarn run lint && yarn run coverage",
-    "review:test": "yarn run lint && yarn run test",
-    "coverage": "yarn run test -- --coverage",
+    "review:coverage": "pnpm run lint && pnpm run coverage",
+    "review:test": "pnpm run lint && pnpm run test",
+    "coverage": "pnpm run test -- --coverage",
     "lint": "node --run lint:eslint",
     "lint:eslint": "ynpx eslint --ext .ts,.tsx,.mts,.cts ./",
     "pretest": "echo pretest",
-    "test": "jest --passWithNoTests",
+    "test": "node --run test:node",
     "test:jest": "jest --passWithNoTests",
     "test:jest:coverage": "node --run test:jest -- --coverage",
     "test:jest:snapshot": "node --run test:jest -- -u",
     "test:mocha": "ynpx --quiet -p ts-node -p mocha mocha -- --require ts-node/register \"!(node_modules)/**/*.{test,spec}.{ts,tsx}\"",
-    "test:snapshot": "yarn run test -- -u",
+    "test:node": "tsx --test --test-update-snapshots **/*.node-spec.ts **/*.node-test.ts **/*.spec.ts **/*.test.ts",
+    "test:snapshot": "pnpm run test -u",
+    "test:tsc": "tsc --noEmit & echo typescript check done",
     "test:tsd": "ynpx tsd",
     "test:tsdx": "ynpx @bluelovers/tsdx test --passWithNoTests",
     "build:dts:bundle": "ynpx @bluelovers/dts-bundle-generator -o ./dist/index.d.ts ./src/index.ts --no-banner --inline-declare-global & echo build:dts:bundle",
@@ -58,11 +60,10 @@
     "build:tsdx": "ynpx @bluelovers/tsdx build --target node --name index",
     "ci:install": "echo ci:install",
     "ci:build": "echo ci:build",
-    "preversion": "echo preversion && yarn run test",
+    "preversion": "echo preversion && pnpm run test",
     "version": "echo version",
     "postversion": "echo postversion",
     "prepublish": "echo prepublish",
-    "prepare": "echo prepare",
     "prepublishOnly": "echo prepublishOnly",
     "prepack": "echo prepack",
     "pack": "echo pack",
@@ -78,10 +79,10 @@
   "dependencies": {
     "@types/which": "^3.0.4",
     "tslib": ">=2.8.1",
-    "which": "^6.0.1"
+    "which": "^7.0.0"
   },
   "publishConfig": {
     "access": "public"
   },
-  "gitHead": "8c939a673ef0f088d4a3aa8a240ed6c28d390f98"
+  "gitHead": "471c63ee11851f0ac3487f23d1c472936f99b460"
 }