@yarn-tool/ws-scope

A utility for managing workspace scope settings across package.json, lerna.json, and pnpm-workspace.yaml

管理工作區範圍設定的工具，支援跨多種設定檔案格式

Features | 功能特色

• Multi-format Support | 多格式支援: Manages workspace scopes across package.json, lerna.json, and pnpm-workspace.yaml
• Add/Remove Scopes | 新增/移除範圍: Easily add or remove workspace paths from all configuration files
• Sync Values | 同步數值: Synchronize workspace paths across all configuration files
• Safe Path Validation | 安全路徑驗證: Validates that all paths are within the workspace root
• Format Preservation | 格式保留: Preserves YAML formatting and comments when modifying pnpm-workspace.yaml

Installation | 安裝

# Using yarn
yarn add @yarn-tool/ws-scope

# Using yarn-tool
yarn-tool add @yarn-tool/ws-scope

# Using yt (short for yarn-tool)
yt add @yarn-tool/ws-scope

Usage | 使用方式

Basic Usage | 基本用法

import { WorkspacesScope } from '@yarn-tool/ws-scope';

// Create instance - automatically finds workspace root
// 建立實例 - 自動尋找工作區根目錄
const ws = new WorkspacesScope();

// Add a workspace scope
// 新增工作區範圍
ws.add('packages/new-package/*');
// Or simply use the package name (auto-converts to 'packages/new-package/*')
// 或直接使用套件名稱（自動轉換為 'packages/new-package/*'）
ws.add('new-package');

// Remove a workspace scope
// 移除工作區範圍
ws.remove('packages/old-package/*');

// Check if any changes were made
// 檢查是否有變更
if (ws.changed) {
  // Save changes to all configuration files
  // 將變更儲存至所有設定檔
  ws.save();
}

Sync Workspace Values | 同步工作區數值

import { WorkspacesScope } from '@yarn-tool/ws-scope';

const ws = new WorkspacesScope();

// Synchronize workspace paths across all config files
// 跨所有設定檔同步工作區路徑
const allScopes = ws.syncValue();

// Save the synchronized configuration
// 儲存同步後的設定
ws.save();

Get All Workspace Scopes | 取得所有工作區範圍

import { WorkspacesScope } from '@yarn-tool/ws-scope';

const ws = new WorkspacesScope();

// Get all unique workspace scopes from all configuration files
// 從所有設定檔取得所有唯一的工作區範圍
const scopes = ws.value;
console.log(scopes);
// Output: ['packages/*', 'packages/@scope/*', ...]

API Reference | API 參考

WorkspacesScope

Main class for managing workspace scope configurations.

管理工作區範圍設定的主要類別。

Constructor | 建構函式

constructor(cwd?: string)

• cwd (optional): Current working directory to start searching for workspace root
• cwd（可選）：當前工作目錄，用於開始搜尋工作區根目錄

Properties | 屬性

Methods | 方法

Supported Configuration Files | 支援的設定檔

Related Packages | 相關套件

• @yarn-tool/find-root - Find workspace root directory
• @yarn-tool/sort-lerna-json - Sort lerna.json configuration
• @yarn-tool/write-package-json - Write package.json with formatting

License | 授權

ISC © bluelovers