@yarn-tool/detect-package-manager 1.0.4

package/CHANGELOG.md

@@ -0,0 +1,103 @@
+# Change Log
+
+All notable changes to this project will be documented in this file.
+See [Conventional Commits](https://conventionalcommits.org) for commit guidelines.
+
+## [1.0.4](https://github.com/bluelovers/ws-yarn-workspaces/compare/@yarn-tool/detect-package-manager@1.0.3...@yarn-tool/detect-package-manager@1.0.4) (2026-03-09)
+
+**Note:** Version bump only for package @yarn-tool/detect-package-manager
+
+
+
+
+
+## 1.0.3 (2026-03-09)
+
+
+### BREAKING CHANGES
+
+* **detect-package-manager:** `whichPackageManagerAsync` 和 `whichPackageManagerSync` 回傳值格式改變，從字串改為元組 [名稱, 路徑?]
+
+
+
+### 📦　Code Refactoring
+
+* **detect-package-manager:** 新增生成器偵測函數與全面測試覆蓋 ([59a19e3](https://github.com/bluelovers/ws-yarn-workspaces/commit/59a19e352f4dea91886d9bb8df26ac36ef20f4a3))
+
+
+### 🚨　Tests
+
+* update test ([0bf7b3c](https://github.com/bluelovers/ws-yarn-workspaces/commit/0bf7b3ca5f565f33e5dfb7333921da916fe266a0))
+
+
+### ♻️　Chores
+
+* **deps:** 更新 ts-type 和 @ts-type/package-dts 依賴版本 ([eb3e3db](https://github.com/bluelovers/ws-yarn-workspaces/commit/eb3e3dbe330398235ea99e64f3561db73d95b7fc))
+
+
+### 🔖　Miscellaneous
+
+* . ([385c013](https://github.com/bluelovers/ws-yarn-workspaces/commit/385c0135c0ed714ef3d1daf053a0072fc1433f47))
+* . ([cae7515](https://github.com/bluelovers/ws-yarn-workspaces/commit/cae7515d4a8befe93ca0baee8f6aeb9ae7cbad79))
+* **detect-package-manager:** 新增套件管理器偵測功能 ([9bbbe46](https://github.com/bluelovers/ws-yarn-workspaces/commit/9bbbe46709f8291e33aea60081546dfb549287f2))
+
+
+
+## 1.0.2 (2026-03-09)
+
+
+### BREAKING CHANGES
+
+* **detect-package-manager:** `whichPackageManagerAsync` 和 `whichPackageManagerSync` 回傳值格式改變，從字串改為元組 [名稱, 路徑?]
+
+
+
+### 📦　Code Refactoring
+
+* **detect-package-manager:** 新增生成器偵測函數與全面測試覆蓋 ([59a19e3](https://github.com/bluelovers/ws-yarn-workspaces/commit/59a19e352f4dea91886d9bb8df26ac36ef20f4a3))
+
+
+### 🚨　Tests
+
+* update test ([0bf7b3c](https://github.com/bluelovers/ws-yarn-workspaces/commit/0bf7b3ca5f565f33e5dfb7333921da916fe266a0))
+
+
+### ♻️　Chores
+
+* **deps:** 更新 ts-type 和 @ts-type/package-dts 依賴版本 ([eb3e3db](https://github.com/bluelovers/ws-yarn-workspaces/commit/eb3e3dbe330398235ea99e64f3561db73d95b7fc))
+
+
+### 🔖　Miscellaneous
+
+* . ([cae7515](https://github.com/bluelovers/ws-yarn-workspaces/commit/cae7515d4a8befe93ca0baee8f6aeb9ae7cbad79))
+* **detect-package-manager:** 新增套件管理器偵測功能 ([9bbbe46](https://github.com/bluelovers/ws-yarn-workspaces/commit/9bbbe46709f8291e33aea60081546dfb549287f2))
+
+
+
+## 1.0.1 (2026-03-08)
+
+
+### BREAKING CHANGES
+
+* **detect-package-manager:** `whichPackageManagerAsync` 和 `whichPackageManagerSync` 回傳值格式改變，從字串改為元組 [名稱, 路徑?]
+
+
+
+### 📦　Code Refactoring
+
+* **detect-package-manager:** 新增生成器偵測函數與全面測試覆蓋 ([59a19e3](https://github.com/bluelovers/ws-yarn-workspaces/commit/59a19e352f4dea91886d9bb8df26ac36ef20f4a3))
+
+
+### 🚨　Tests
+
+* update test ([0bf7b3c](https://github.com/bluelovers/ws-yarn-workspaces/commit/0bf7b3ca5f565f33e5dfb7333921da916fe266a0))
+
+
+### ♻️　Chores
+
+* **deps:** 更新 ts-type 和 @ts-type/package-dts 依賴版本 ([eb3e3db](https://github.com/bluelovers/ws-yarn-workspaces/commit/eb3e3dbe330398235ea99e64f3561db73d95b7fc))
+
+
+### 🔖　Miscellaneous
+
+* **detect-package-manager:** 新增套件管理器偵測功能 ([9bbbe46](https://github.com/bluelovers/ws-yarn-workspaces/commit/9bbbe46709f8291e33aea60081546dfb549287f2))

package/README.md

@@ -0,0 +1,150 @@
+# @yarn-tool/detect-package-manager
+
+使用 `which` 命令偵測系統中可用的套件管理器（yarn、npm、pnpm）
+
+Detect available package manager (yarn, npm, pnpm) in system using `which` command
+
+## 功能 (Features)
+
+- 支援偵測 yarn、npm、pnpm 三種套件管理器
+- 提供同步與非同步兩種偵測方式
+- 支援自訂套件管理器優先順序
+- 可取得第一個可用的套件管理器或所有可用的套件管理器
+- 支援回傳命令路徑資訊
+
+## 類型 (Types)
+
+### IPackageManager
+
+套件管理器類型 (Package manager type)
+
+```typescript
+type IPackageManager = 'yarn' | 'npm' | 'pnpm';
+```
+
+### IResultDetectPackageManagerRaw
+
+偵測結果類型，包含套件管理器名稱和命令路徑
+
+```typescript
+type IResultDetectPackageManagerRaw = readonly [IPackageManager, string?];
+```
+
+## API (API)
+
+### whichPackageManagerSync(npmClients?: IPackageManager[], returnDefault?: boolean): IPackageManager | undefined
+
+同步偵測第一個可用的套件管理器
+
+**參數 (Parameters):**
+- `npmClients?`: 自訂套件管理器列表（可選）/ Custom package manager list (optional)
+- `returnDefault?`: 當找不到時是否返回預設值（可選）/ Whether to return default when not found (optional)
+
+**回傳 (Returns):** 第一個可用的套件管理器名稱或 `undefined`
+
+### whichPackageManagerSyncAll(npmClients?: IPackageManager[], returnDefault?: boolean): IPackageManager[]
+
+同步偵測所有可用的套件管理器
+
+**參數 (Parameters):**
+- `npmClients?`: 自訂套件管理器列表（可選）/ Custom package manager list (optional)
+- `returnDefault?`: 當找不到時是否返回預設值（可選）/ Whether to return default when not found (optional)
+
+**回傳 (Returns):** 所有可用的套件管理器陣列
+
+### whichPackageManagerAsync(npmClients?: IPackageManager[], returnDefault?: boolean): Promise<IPackageManager>
+
+非同步偵測第一個可用的套件管理器
+
+**參數 (Parameters):**
+- `npmClients?`: 自訂套件管理器列表（可選）/ Custom package manager list (optional)
+- `returnDefault?`: 當找不到時是否返回預設值（可選）/ Whether to return default when not found (optional)
+
+**回傳 (Returns):** Promise resolves to 第一個可用的套件管理器名稱或 `undefined`
+
+### whichPackageManagerAsyncAll(npmClients?: IPackageManager[], returnDefault?: boolean): Promise<IPackageManager[]>
+
+非同步偵測所有可用的套件管理器
+
+**參數 (Parameters):**
+- `npmClients?`: 自訂套件管理器列表（可選）/ Custom package manager list (optional)
+- `returnDefault?`: 當找不到時是否返回預設值（可選）/ Whether to return default when not found (optional)
+
+**回傳 (Returns):** Promise resolves to 所有可用的套件管理器陣列
+
+### _whichPackageManagerSyncGenerator(npmClients?: IPackageManager[], returnDefault?: boolean): Generator<IResultDetectPackageManagerRaw>
+
+同步生成器版本，回傳包含路徑的結果
+
+**參數 (Parameters):**
+- `npmClients?`: 自訂套件管理器列表（可選）/ Custom package manager list (optional)
+- `returnDefault?`: 當找不到時是否返回預設值（可選）/ Whether to return default when not found (optional)
+
+**回傳 (Returns):** Generator yields `[packageManager, commandPath]` tuples
+
+### _whichPackageManagerAsyncGenerator(npmClients?: IPackageManager[], returnDefault?: boolean): AsyncGenerator<IResultDetectPackageManagerRaw>
+
+非同步生成器版本，回傳包含路徑的結果
+
+**參數 (Parameters):**
+- `npmClients?`: 自訂套件管理器列表（可選）/ Custom package manager list (optional)
+- `returnDefault?`: 當找不到時是否返回預設值（可選）/ Whether to return default when not found (optional)
+
+**回傳 (Returns):** AsyncGenerator yields `[packageManager, commandPath]` tuples
+
+## 安裝 (Installation)
+
+```bash
+# 使用 yarn / Using yarn
+yarn add @yarn-tool/detect-package-manager
+
+# 使用 yarn-tool / Using yarn-tool
+yarn-tool add @yarn-tool/detect-package-manager
+# yt 是 yarn-tool 的別名 / yt is an alias for yarn-tool
+yt add @yarn-tool/detect-package-manager
+
+# 使用 pnpm / Using pnpm
+pnpm add @yarn-tool/detect-package-manager
+
+# 使用 npm / Using npm
+npm install @yarn-tool/detect-package-manager
+```
+
+## 範例 (Examples)
+
+```typescript
+import {
+  whichPackageManagerSync,
+  whichPackageManagerSyncAll,
+  whichPackageManagerAsync,
+  whichPackageManagerAsyncAll,
+  _whichPackageManagerSyncGenerator,
+  _whichPackageManagerAsyncGenerator,
+} from '@yarn-tool/detect-package-manager';
+
+// 同步偵測第一個可用的套件管理器
+const pm = whichPackageManagerSync();
+console.log(pm); // 'pnpm' | 'yarn' | 'npm' | undefined
+
+// 同步偵測所有可用的套件管理器
+const pmAll = whichPackageManagerSyncAll();
+console.log(pmAll); // ['pnpm', 'yarn', 'npm']
+
+// 非同步偵測
+const pmAsync = await whichPackageManagerAsync();
+console.log(pmAsync); // 'pnpm' | 'yarn' | 'npm' | undefined
+
+// 自訂優先順序
+const pmCustom = whichPackageManagerSync(['yarn', 'pnpm', 'npm']);
+console.log(pmCustom); // 會按照自訂順序偵測
+
+// 使用生成器取得路徑資訊
+for (const [pm, path] of _whichPackageManagerSyncGenerator()) {
+  console.log(`Found ${pm} at ${path}`);
+}
+
+// 非同步生成器
+for await (const [pm, path] of _whichPackageManagerAsyncGenerator()) {
+  console.log(`Found ${pm} at ${path}`);
+}
+```

package/index.d.ts

@@ -0,0 +1,119 @@
+import { ITSAsyncGenerator, ITSGenerator, ITSTypeAndStringLiteral } from 'ts-type';
+/**
+ * 支援的套件管理器類型
+ * Supported package manager types
+ */
+export declare const enum EnumPackageManager {
+    'yarn' = "yarn",
+    'npm' = "npm",
+    'pnpm' = "pnpm"
+}
+/**
+ * 支援的套件管理器類型
+ * Supported package manager types
+ */
+export type IPackageManager = ITSTypeAndStringLiteral<EnumPackageManager>;
+/**
+ * 偵測結果類型 - 包含套件管理器名稱和命令路徑
+ * Detection result type - contains package manager name and command path
+ *
+ * @typeParam T - 套件管理器類型 / Package manager type
+ */
+export type IResultDetectPackageManagerRaw<T extends IPackageManager = IPackageManager> = IResultDetectRawCore<T>;
+/**
+ * 偵測結果核心類型 - 元組 [名稱, 路徑?]
+ * Detection result core type - tuple [name, path?]
+ *
+ * @typeParam T - 字串類型 / String type
+ */
+export type IResultDetectRawCore<T extends string = IPackageManager> = readonly [T, string?];
+/**
+ * 合併使用者指定的優先順序與預設順序
+ * Merge user-specified priority with default order
+ */
+export declare function _handleClientsToCheck(npmClients?: IPackageManager[] | undefined): IPackageManager[];
+/**
+ * 使用 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
+ *
+ * @param npmClients - 套件管理器列表 / Package manager list
+ * @param returnDefault - 當找不到時是否返回預設值 / Whether to return default when not found
+ * @yield - 可用的套件管理器元組 [名稱, 路徑] / Available package manager tuple [name, path]
+ */
+export declare function _whichPackageManagerAsyncGenerator(npmClients?: IPackageManager[] | undefined, returnDefault?: boolean): ITSAsyncGenerator<IResultDetectPackageManagerRaw>;
+/**
+ * 非同步生成器核心實作 - 依序檢查每個套件管理器是否可用
+ * Async generator core implementation - sequentially check each package manager for availability
+ *
+ * @typeParam T - 套件管理器類型 / Package manager type
+ * @param clientsToCheck - 要檢查的套件管理器列表 / List of package managers to check
+ * @param returnDefault - 當找不到時是否返回預設值 / Whether to return default when not found
+ * @yield - 可用的套件管理器元組 [名稱, 路徑] / Available package manager tuple [name, path]
+ */
+export declare function _whichAsyncGeneratorCore<T extends string = IPackageManager>(clientsToCheck: T[], returnDefault?: boolean): ITSAsyncGenerator<IResultDetectRawCore<T>>;
+/**
+ * 使用 which 依序檢查套件管理器列表，返回第一個可用的
+ * Sequentially check package managers using which, return the first available one
+ *
+ * @param npmClients - 套件管理器列表 / Package manager list
+ * @returns 可用的套件管理器名稱 / Available package manager name
+ */
+export declare function whichPackageManagerAsync(npmClients?: IPackageManager[] | undefined, returnDefault?: boolean): Promise<IPackageManager>;
+/**
+ * 使用 which 依序檢查套件管理器列表，返回所有可用的套件管理器陣列
+ * Sequentially check package managers using which, return all available package managers as array
+ *
+ * @param npmClients - 套件管理器列表 / Package manager list
+ * @returns 所有可用的套件管理器陣列 / Array of all available package managers
+ */
+export declare function whichPackageManagerAsyncAll(npmClients?: IPackageManager[] | undefined, returnDefault?: boolean): 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
+ *
+ * @param npmClients - 套件管理器列表 / Package manager list
+ * @param returnDefault - 當找不到時是否返回預設值 / Whether to return default when not found
+ * @yield - 可用的套件管理器元組 [名稱, 路徑] / Available package manager tuple [name, path]
+ */
+export declare function _whichPackageManagerSyncGenerator(npmClients?: IPackageManager[] | undefined, returnDefault?: boolean): ITSGenerator<IResultDetectPackageManagerRaw>;
+/**
+ * 同步生成器核心實作 - 依序檢查每個套件管理器是否可用
+ * Sync generator core implementation - sequentially check each package manager for availability
+ *
+ * @typeParam T - 套件管理器類型 / Package manager type
+ * @param clientsToCheck - 要檢查的套件管理器列表 / List of package managers to check
+ * @param returnDefault - 當找不到時是否返回預設值 / Whether to return default when not found
+ * @yield - 可用的套件管理器元組 [名稱, 路徑] / Available package manager tuple [name, path]
+ */
+export declare function _whichSyncGeneratorCore<T extends string = IPackageManager>(clientsToCheck: T[], returnDefault?: boolean): ITSGenerator<IResultDetectRawCore<T>>;
+/**
+ * 使用 which 依序檢查套件管理器列表，返回所有可用的套件管理器陣列（同步版本）
+ * Sequentially check package managers using which, return all available package managers as array (sync version)
+ *
+ * @param npmClients - 套件管理器列表 / Package manager list
+ * @returns 所有可用的套件管理器陣列 / Array of all available package managers
+ */
+export declare function whichPackageManagerSyncAll(npmClients?: IPackageManager[] | undefined, returnDefault?: boolean): IPackageManager[];
+/**
+ * 使用 which 依序檢查套件管理器列表，返回第一個可用的
+ * Sequentially check package managers using which, return the first available one
+ *
+ * @param npmClients - 套件管理器列表 / Package manager list
+ * @returns 可用的套件管理器名稱 / Available package manager name
+ */
+export declare function whichPackageManagerSync(npmClients?: IPackageManager[] | undefined, returnDefault?: boolean): IPackageManager;
+export default whichPackageManagerSync;

package/index.js

@@ -0,0 +1,186 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.EnumPackageManager = void 0;
+exports._handleClientsToCheck = _handleClientsToCheck;
+exports._whichPackageManagerAsyncGenerator = _whichPackageManagerAsyncGenerator;
+exports._whichAsyncGeneratorCore = _whichAsyncGeneratorCore;
+exports.whichPackageManagerAsync = whichPackageManagerAsync;
+exports.whichPackageManagerAsyncAll = whichPackageManagerAsyncAll;
+exports._whichPackageManagerSyncGenerator = _whichPackageManagerSyncGenerator;
+exports._whichSyncGeneratorCore = _whichSyncGeneratorCore;
+exports.whichPackageManagerSyncAll = whichPackageManagerSyncAll;
+exports.whichPackageManagerSync = whichPackageManagerSync;
+const tslib_1 = require("tslib");
+const which_1 = tslib_1.__importStar(require("which"));
+/**
+ * 支援的套件管理器類型
+ * Supported package manager types
+ */
+var EnumPackageManager;
+(function (EnumPackageManager) {
+    EnumPackageManager["yarn"] = "yarn";
+    EnumPackageManager["npm"] = "npm";
+    EnumPackageManager["pnpm"] = "pnpm";
+})(EnumPackageManager || (exports.EnumPackageManager = EnumPackageManager = {}));
+;
+/**
+ * 預設的套件管理器優先順序
+ * Default package manager priority order
+ */
+const defaultClients = ["pnpm" /* EnumPackageManager.pnpm */, "yarn" /* EnumPackageManager.yarn */, "npm" /* EnumPackageManager.npm */];
+/**
+ * 合併使用者指定的優先順序與預設順序
+ * Merge user-specified priority with default order
+ */
+function _handleClientsToCheck(npmClients) {
+    return (npmClients === null || npmClients === void 0 ? void 0 : npmClients.length)
+        ? [...new Set([...npmClients, ...defaultClients])]
+        : 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
+ *
+ * @param npmClients - 套件管理器列表 / Package manager list
+ * @param returnDefault - 當找不到時是否返回預設值 / Whether to return default when not found
+ * @yield - 可用的套件管理器元組 [名稱, 路徑] / Available package manager tuple [name, path]
+ */
+async function* _whichPackageManagerAsyncGenerator(npmClients, returnDefault) {
+    /**
+     * 合併使用者指定的優先順序與預設順序
+     * Merge user-specified priority with default order
+     */
+    const clientsToCheck = _handleClientsToCheck(npmClients);
+    return _whichAsyncGeneratorCore(clientsToCheck, returnDefault);
+}
+/**
+ * 非同步生成器核心實作 - 依序檢查每個套件管理器是否可用
+ * Async generator core implementation - sequentially check each package manager for availability
+ *
+ * @typeParam T - 套件管理器類型 / Package manager type
+ * @param clientsToCheck - 要檢查的套件管理器列表 / List of package managers to check
+ * @param returnDefault - 當找不到時是否返回預設值 / Whether to return default when not found
+ * @yield - 可用的套件管理器元組 [名稱, 路徑] / Available package manager tuple [name, path]
+ */
+async function* _whichAsyncGeneratorCore(clientsToCheck, returnDefault) {
+    let notFound = true;
+    /**
+     * 依序檢查每個套件管理器是否可用
+     * Check each package manager sequentially for availability
+     */
+    for (const client of clientsToCheck) {
+        const commandPath = await (0, which_1.default)(client).catch(() => null);
+        if (commandPath) {
+            yield [client, commandPath];
+            notFound = false;
+        }
+    }
+    if (returnDefault && notFound)
+        return [clientsToCheck[0]];
+}
+/**
+ * 使用 which 依序檢查套件管理器列表，返回第一個可用的
+ * Sequentially check package managers using which, return the first available one
+ *
+ * @param npmClients - 套件管理器列表 / Package manager list
+ * @returns 可用的套件管理器名稱 / Available package manager name
+ */
+function whichPackageManagerAsync(npmClients, returnDefault) {
+    return _whichPackageManagerAsyncGenerator(npmClients, returnDefault).next().then(next => { var _a; return (_a = next.value) === null || _a === void 0 ? void 0 : _a[0]; });
+}
+/**
+ * 使用 which 依序檢查套件管理器列表，返回所有可用的套件管理器陣列
+ * Sequentially check package managers using which, return all available package managers as array
+ *
+ * @param npmClients - 套件管理器列表 / Package manager list
+ * @returns 所有可用的套件管理器陣列 / Array of all available package managers
+ */
+async function whichPackageManagerAsyncAll(npmClients, returnDefault) {
+    const result = [];
+    for await (const client of _whichPackageManagerAsyncGenerator(npmClients, returnDefault)) {
+        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
+ *
+ * @param npmClients - 套件管理器列表 / Package manager list
+ * @param returnDefault - 當找不到時是否返回預設值 / Whether to return default when not found
+ * @yield - 可用的套件管理器元組 [名稱, 路徑] / Available package manager tuple [name, path]
+ */
+function* _whichPackageManagerSyncGenerator(npmClients, returnDefault) {
+    /**
+     * 合併使用者指定的優先順序與預設順序
+     * Merge user-specified priority with default order
+     */
+    const clientsToCheck = _handleClientsToCheck(npmClients);
+    return _whichSyncGeneratorCore(clientsToCheck, returnDefault);
+}
+/**
+ * 同步生成器核心實作 - 依序檢查每個套件管理器是否可用
+ * Sync generator core implementation - sequentially check each package manager for availability
+ *
+ * @typeParam T - 套件管理器類型 / Package manager type
+ * @param clientsToCheck - 要檢查的套件管理器列表 / List of package managers to check
+ * @param returnDefault - 當找不到時是否返回預設值 / Whether to return default when not found
+ * @yield - 可用的套件管理器元組 [名稱, 路徑] / Available package manager tuple [name, path]
+ */
+function* _whichSyncGeneratorCore(clientsToCheck, returnDefault) {
+    let notFound = true;
+    /**
+     * 依序檢查每個套件管理器是否可用
+     * Check each package manager sequentially for availability
+     */
+    for (const client of clientsToCheck) {
+        const commandPath = (0, which_1.sync)(client);
+        if (commandPath) {
+            yield [client, commandPath];
+            notFound = false;
+        }
+    }
+    if (returnDefault && notFound)
+        return [clientsToCheck[0]];
+}
+/**
+ * 使用 which 依序檢查套件管理器列表，返回所有可用的套件管理器陣列（同步版本）
+ * Sequentially check package managers using which, return all available package managers as array (sync version)
+ *
+ * @param npmClients - 套件管理器列表 / Package manager list
+ * @returns 所有可用的套件管理器陣列 / Array of all available package managers
+ */
+function whichPackageManagerSyncAll(npmClients, returnDefault) {
+    const result = [];
+    for (const client of _whichPackageManagerSyncGenerator(npmClients, returnDefault)) {
+        result.push(client[0]);
+    }
+    return result;
+}
+/**
+ * 使用 which 依序檢查套件管理器列表，返回第一個可用的
+ * Sequentially check package managers using which, return the first available one
+ *
+ * @param npmClients - 套件管理器列表 / Package manager list
+ * @returns 可用的套件管理器名稱 / Available package manager name
+ */
+function whichPackageManagerSync(npmClients, returnDefault) {
+    var _a;
+    return (_a = _whichPackageManagerSyncGenerator(npmClients, returnDefault).next().value) === null || _a === void 0 ? void 0 : _a[0];
+}
+exports.default = whichPackageManagerSync;
+//# sourceMappingURL=index.js.map

package/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["index.ts"],"names":[],"mappings":"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","sourcesContent":["import { ITSAsyncGenerator, ITSGenerator, ITSTypeAndStringLiteral } 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 * 預設的套件管理器優先順序\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 * 合併使用者指定的優先順序與預設順序\n * Merge user-specified priority with default order\n */\nexport function _handleClientsToCheck(npmClients?: IPackageManager[] | undefined): IPackageManager[]\n{\n\treturn npmClients?.length\n\t\t? [...new Set([...npmClients, ...defaultClients])]\n\t\t: defaultClients as IPackageManager[];\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 returnDefault - 當找不到時是否返回預設值 / Whether to return default when not found\n * @yield - 可用的套件管理器元組 [名稱, 路徑] / Available package manager tuple [name, path]\n */\nexport async function* _whichPackageManagerAsyncGenerator(npmClients?: IPackageManager[] | undefined, returnDefault?: boolean): ITSAsyncGenerator<IResultDetectPackageManagerRaw>\n{\n\t/**\n\t * 合併使用者指定的優先順序與預設順序\n\t * Merge user-specified priority with default order\n\t */\n\tconst clientsToCheck: IPackageManager[] = _handleClientsToCheck(npmClients);\n\n\treturn _whichAsyncGeneratorCore(clientsToCheck, returnDefault) 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 returnDefault - 當找不到時是否返回預設值 / Whether to return default when not found\n * @yield - 可用的套件管理器元組 [名稱, 路徑] / Available package manager tuple [name, path]\n */\nexport async function* _whichAsyncGeneratorCore<T extends string = IPackageManager>(clientsToCheck: T[], returnDefault?: boolean): 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).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 (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 function whichPackageManagerAsync(npmClients?: IPackageManager[] | undefined, returnDefault?: boolean): Promise<IPackageManager>\n{\n\treturn _whichPackageManagerAsyncGenerator(npmClients, returnDefault).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?: IPackageManager[] | undefined, returnDefault?: boolean): Promise<IPackageManager[]>\n{\n\tconst result: IPackageManager[] = [];\n\n\tfor await (const client of _whichPackageManagerAsyncGenerator(npmClients, returnDefault))\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 returnDefault - 當找不到時是否返回預設值 / Whether to return default when not found\n * @yield - 可用的套件管理器元組 [名稱, 路徑] / Available package manager tuple [name, path]\n */\nexport function* _whichPackageManagerSyncGenerator(npmClients?: IPackageManager[] | undefined, returnDefault?: boolean): ITSGenerator<IResultDetectPackageManagerRaw>\n{\n\t/**\n\t * 合併使用者指定的優先順序與預設順序\n\t * Merge user-specified priority with default order\n\t */\n\tconst clientsToCheck: IPackageManager[] = _handleClientsToCheck(npmClients);\n\n\treturn _whichSyncGeneratorCore(clientsToCheck, returnDefault) 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 returnDefault - 當找不到時是否返回預設值 / Whether to return default when not found\n * @yield - 可用的套件管理器元組 [名稱, 路徑] / Available package manager tuple [name, path]\n */\nexport function* _whichSyncGeneratorCore<T extends string = IPackageManager>(clientsToCheck: T[], returnDefault?: boolean): 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);\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 (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?: IPackageManager[] | undefined, returnDefault?: boolean): IPackageManager[]\n{\n\tconst result: IPackageManager[] = [];\n\n\tfor (const client of _whichPackageManagerSyncGenerator(npmClients, returnDefault))\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?: IPackageManager[] | undefined, returnDefault?: boolean)\n{\n\treturn _whichPackageManagerSyncGenerator(npmClients, returnDefault).next().value?.[0]\n}\n\nexport default whichPackageManagerSync\n"]}

package/package.json

@@ -0,0 +1,87 @@
+{
+  "name": "@yarn-tool/detect-package-manager",
+  "version": "1.0.4",
+  "description": "Detect available package manager (yarn, npm, pnpm) using which command",
+  "keywords": [
+    "detect",
+    "yarn",
+    "yarn-tool",
+    "pnpm",
+    "npm",
+    "package-manager",
+    "monorepo",
+    "workspaces",
+    "lerna",
+    "pkg",
+    "dependencies",
+    "yarnlock",
+    "node-modules",
+    "packages",
+    "package",
+    "create-by-yarn-tool"
+  ],
+  "homepage": "https://github.com/bluelovers/ws-yarn-workspaces/tree/master/packages/@yarn-tool/detect-package-manager#readme",
+  "bugs": {
+    "url": "https://github.com/bluelovers/ws-yarn-workspaces/issues"
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/bluelovers/ws-yarn-workspaces.git",
+    "directory": "packages/@yarn-tool/detect-package-manager"
+  },
+  "license": "ISC",
+  "author": "",
+  "sideEffects": false,
+  "type": "commonjs",
+  "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",
+    "lint": "node --run lint:eslint",
+    "lint:eslint": "ynpx eslint --ext .ts,.tsx,.mts,.cts ./",
+    "pretest": "echo pretest",
+    "test": "jest --passWithNoTests",
+    "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: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",
+    "build:dts:copy": "copy .\\src\\index.d.ts .\\dist\\index.d.ts & echo build:dts",
+    "build:dts:tsc": "node --run build:dts:tsc:emit && node --run build:dts:copy",
+    "build:dts:tsc:emit": "tsc --emitDeclarationOnly --declaration --noEmit false",
+    "build:microbundle": "ynpx microbundle --target node",
+    "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",
+    "version": "echo version",
+    "postversion": "echo postversion",
+    "prepublish": "echo prepublish",
+    "prepare": "echo prepare",
+    "prepublishOnly": "echo prepublishOnly",
+    "prepack": "echo prepack",
+    "pack": "echo pack",
+    "postpack": "echo postpack",
+    "publish": "echo publish",
+    "postpublish": "echo postpublish",
+    "postpublishOnly": "echo postpublishOnly",
+    "sort-package-json": "yarn-tool sort",
+    "tsc:default": "tsc -p tsconfig.json",
+    "tsc:esm": "tsc -p tsconfig.esm.json",
+    "tsc:showConfig": "ynpx get-current-tsconfig -p"
+  },
+  "dependencies": {
+    "@types/which": "^3.0.4",
+    "tslib": ">=2",
+    "which": "^6.0.1"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "gitHead": "ca3fae2bbdf31ed1ce9bab14793912026200767e"
+}