package-versioner 0.8.1 → 0.8.2

package/README.md

@@ -74,7 +74,7 @@ npx package-versioner --dry-run --json
 
 By default, `package-versioner` intelligently handles Git tag reachability to provide the best user experience:
 
-- **Default behavior**: Uses reachable tags when available, but falls back to the latest repository tag if needed (common in feature branches)
+- **Default behaviour**: Uses reachable tags when available, but falls back to the latest repository tag if needed (common in feature branches)
 - **Strict mode (`--strict-reachable`)**: Only uses tags reachable from the current commit, following strict Git semantics
 
 This is particularly useful when working on feature branches that have diverged from the main branch where newer tags exist. The tool will automatically detect the Git context and provide helpful guidance:
@@ -151,6 +151,7 @@ Customize behaviour by creating a `version.config.json` file in your project roo
 - `updateChangelog`: Whether to automatically update changelogs (default: true)
 - `changelogFormat`: Format for changelogs - "keep-a-changelog" or "angular" (default: "keep-a-changelog")
 - `strictReachable`: Only use reachable tags, no fallback to unreachable tags (default: false)
+- `prereleaseIdentifier`: Identifier for prerelease versions (e.g., "alpha", "beta", "next") used in versions like "1.2.0-alpha.3"
 - `cargo`: Options for Rust projects:
   - `enabled`: Whether to handle Cargo.toml files (default: true)
   - `paths`: Directories to search for Cargo.toml files (optional)
@@ -167,7 +168,7 @@ For more details on CI/CD integration and advanced usage, see [CI/CD Integration
 
 ### Package Targeting
 
-The `packages` configuration option allows you to specify which packages should be processed for versioning. It supports several pattern types:
+The `packages` configuration option controls which packages are processed for versioning. It supports several pattern types:
 
 #### Exact Package Names
 ```json
@@ -200,7 +201,12 @@ Combine different pattern types:
 }
 ```
 
-**Note**: Package discovery is handled by your workspace configuration (pnpm-workspace.yaml, package.json workspaces, etc.). The `packages` option only filters which discovered packages to process.
+**Behaviour:**
+- When `packages` is specified, **only** packages matching those patterns will be processed
+- When `packages` is empty or not specified, **all** workspace packages will be processed  
+- The `skip` option can exclude specific packages from the selected set
+
+**Note**: Your workspace configuration (pnpm-workspace.yaml, package.json workspaces, etc.) determines which packages are available, but the `packages` option directly controls which ones get versioned.
 
 ### Package-Specific Tagging
 

package/dist/index.cjs

@@ -639,6 +639,30 @@ function createVersionError(code, details) {
   return new VersionError(fullMessage, code);
 }
 
+// src/utils/packageMatching.ts
+function matchesPackageTarget(packageName, target) {
+  if (packageName === target) {
+    return true;
+  }
+  if (target.endsWith("/*")) {
+    const scope = target.slice(0, -2);
+    if (scope.startsWith("@")) {
+      return packageName.startsWith(`${scope}/`);
+    }
+    return packageName.startsWith(`${scope}/`);
+  }
+  if (target === "*") {
+    return true;
+  }
+  return false;
+}
+function shouldMatchPackageTargets(packageName, targets) {
+  return targets.some((target) => matchesPackageTarget(packageName, target));
+}
+function shouldProcessPackage(packageName, skip = []) {
+  return !skip.includes(packageName);
+}
+
 // src/core/versionStrategies.ts
 var import_node_fs7 = __toESM(require("fs"), 1);
 var path7 = __toESM(require("path"), 1);
@@ -1698,7 +1722,7 @@ To fix this mismatch:
       const bumper = new import_conventional_recommended_bump.Bumper();
       bumper.loadPreset(preset);
       const recommendedBump = await bumper.bump();
-      const releaseTypeFromCommits = recommendedBump == null ? void 0 : recommendedBump.releaseType;
+      const releaseTypeFromCommits = recommendedBump && "releaseType" in recommendedBump ? recommendedBump.releaseType : void 0;
       if (hasNoTags) {
         if (releaseTypeFromCommits) {
           return getPackageVersionFallback(
@@ -1783,37 +1807,9 @@ function calculateNextVersion(version, manifestType, name, releaseType, prerelea
   return result || initialVersion;
 }
 
-// src/utils/packageMatching.ts
-function matchesPackageTarget(packageName, target) {
-  if (packageName === target) {
-    return true;
-  }
-  if (target.endsWith("/*")) {
-    const scope = target.slice(0, -2);
-    if (scope.startsWith("@")) {
-      return packageName.startsWith(`${scope}/`);
-    }
-    return packageName.startsWith(`${scope}/`);
-  }
-  if (target === "*") {
-    return true;
-  }
-  return false;
-}
-function shouldProcessPackage(packageName, targets = [], skip = []) {
-  if (skip.includes(packageName)) {
-    return false;
-  }
-  if (targets.length === 0) {
-    return true;
-  }
-  return targets.some((target) => matchesPackageTarget(packageName, target));
-}
-
 // src/package/packageProcessor.ts
 var PackageProcessor = class {
   skip;
-  targets;
   versionPrefix;
   tagTemplate;
   commitMessageTemplate;
@@ -1825,7 +1821,6 @@ var PackageProcessor = class {
   fullConfig;
   constructor(options) {
     this.skip = options.skip || [];
-    this.targets = options.targets || [];
     this.versionPrefix = options.versionPrefix || "v";
     this.tagTemplate = options.tagTemplate;
     this.commitMessageTemplate = options.commitMessageTemplate || "";
@@ -1836,13 +1831,7 @@ var PackageProcessor = class {
     this.fullConfig = options.fullConfig;
   }
   /**
-   * Set package targets to process
-   */
-  setTargets(targets) {
-    this.targets = targets;
-  }
-  /**
-   * Process packages based on targeting criteria
+   * Process packages based on skip list only (targeting handled at discovery time)
    */
   async processPackages(packages) {
     var _a, _b, _c, _d, _e;
@@ -1853,21 +1842,16 @@ var PackageProcessor = class {
       return { updatedPackages: [], tags: [] };
     }
     const pkgsToConsider = packages.filter((pkg) => {
-      var _a2;
       const pkgName = pkg.packageJson.name;
-      const shouldProcess = shouldProcessPackage(pkgName, this.targets, this.skip);
+      const shouldProcess = shouldProcessPackage(pkgName, this.skip);
       if (!shouldProcess) {
-        if ((_a2 = this.skip) == null ? void 0 : _a2.includes(pkgName)) {
-          log(`Skipping package ${pkgName} as it's in the skip list.`, "info");
-        } else {
-          log(`Package ${pkgName} not in target list, skipping.`, "info");
-        }
+        log(`Skipping package ${pkgName} as it's in the skip list.`, "info");
       }
       return shouldProcess;
     });
-    log(`Found ${pkgsToConsider.length} targeted package(s) to process after filtering.`, "info");
+    log(`Found ${pkgsToConsider.length} package(s) to process after filtering.`, "info");
     if (pkgsToConsider.length === 0) {
-      log("No matching targeted packages found to process.", "info");
+      log("No packages found to process.", "info");
       return { updatedPackages: [], tags: [] };
     }
     for (const pkg of pkgsToConsider) {
@@ -2050,7 +2034,7 @@ var PackageProcessor = class {
       updatedPackagesInfo.push({ name, version: nextVersion, path: pkgPath });
     }
     if (updatedPackagesInfo.length === 0) {
-      log("No targeted packages required a version update.", "info");
+      log("No packages required a version update.", "info");
       return { updatedPackages: [], tags };
     }
     const filesToCommit = [];
@@ -2114,9 +2098,9 @@ var PackageProcessor = class {
 };
 
 // src/core/versionStrategies.ts
-function shouldProcessPackage2(pkg, config, targets = []) {
+function shouldProcessPackage2(pkg, config) {
   const pkgName = pkg.packageJson.name;
-  return shouldProcessPackage(pkgName, targets, config.skip);
+  return shouldProcessPackage(pkgName, config.skip);
 }
 function createSyncedStrategy(config) {
   return async (packages) => {
@@ -2332,7 +2316,6 @@ function createAsyncStrategy(config) {
   };
   const processorOptions = {
     skip: config.skip || [],
-    targets: config.packages || [],
     versionPrefix: config.versionPrefix || "v",
     tagTemplate: config.tagTemplate,
     commitMessageTemplate: config.commitMessage || "",
@@ -2349,15 +2332,9 @@ function createAsyncStrategy(config) {
     }
   };
   const packageProcessor = new PackageProcessor(processorOptions);
-  return async (packages, targets = []) => {
+  return async (packages, _targets = []) => {
     try {
-      const targetPackages = targets.length > 0 ? targets : config.packages || [];
-      packageProcessor.setTargets(targetPackages);
-      if (targetPackages.length > 0) {
-        log(`Processing targeted packages: ${targetPackages.join(", ")}`, "info");
-      } else {
-        log("No targets specified, processing all non-skipped packages", "info");
-      }
+      log(`Processing ${packages.packages.length} pre-filtered packages`, "info");
       const result = await packageProcessor.processPackages(packages.packages);
       if (result.updatedPackages.length === 0) {
         log("No packages required a version update.", "info");
@@ -2439,6 +2416,25 @@ var VersionEngine = class {
         );
         pkgsResult.root = (0, import_node_process5.cwd)();
       }
+      if (this.config.packages && this.config.packages.length > 0) {
+        const originalCount = pkgsResult.packages.length;
+        const filteredPackages = pkgsResult.packages.filter(
+          (pkg) => shouldMatchPackageTargets(pkg.packageJson.name, this.config.packages)
+        );
+        pkgsResult.packages = filteredPackages;
+        log(
+          `Filtered ${originalCount} workspace packages to ${filteredPackages.length} based on packages config`,
+          "info"
+        );
+        if (filteredPackages.length === 0) {
+          log("Warning: No packages matched the specified patterns in config.packages", "warning");
+        }
+      } else {
+        log(
+          `Processing all ${pkgsResult.packages.length} workspace packages (no packages filter specified)`,
+          "info"
+        );
+      }
       this.workspaceCache = pkgsResult;
       return pkgsResult;
     } catch (error) {

package/dist/index.js

@@ -606,6 +606,30 @@ function createVersionError(code, details) {
   return new VersionError(fullMessage, code);
 }
 
+// src/utils/packageMatching.ts
+function matchesPackageTarget(packageName, target) {
+  if (packageName === target) {
+    return true;
+  }
+  if (target.endsWith("/*")) {
+    const scope = target.slice(0, -2);
+    if (scope.startsWith("@")) {
+      return packageName.startsWith(`${scope}/`);
+    }
+    return packageName.startsWith(`${scope}/`);
+  }
+  if (target === "*") {
+    return true;
+  }
+  return false;
+}
+function shouldMatchPackageTargets(packageName, targets) {
+  return targets.some((target) => matchesPackageTarget(packageName, target));
+}
+function shouldProcessPackage(packageName, skip = []) {
+  return !skip.includes(packageName);
+}
+
 // src/core/versionStrategies.ts
 import fs9 from "fs";
 import * as path7 from "path";
@@ -1665,7 +1689,7 @@ To fix this mismatch:
       const bumper = new Bumper();
       bumper.loadPreset(preset);
       const recommendedBump = await bumper.bump();
-      const releaseTypeFromCommits = recommendedBump == null ? void 0 : recommendedBump.releaseType;
+      const releaseTypeFromCommits = recommendedBump && "releaseType" in recommendedBump ? recommendedBump.releaseType : void 0;
       if (hasNoTags) {
         if (releaseTypeFromCommits) {
           return getPackageVersionFallback(
@@ -1750,37 +1774,9 @@ function calculateNextVersion(version, manifestType, name, releaseType, prerelea
   return result || initialVersion;
 }
 
-// src/utils/packageMatching.ts
-function matchesPackageTarget(packageName, target) {
-  if (packageName === target) {
-    return true;
-  }
-  if (target.endsWith("/*")) {
-    const scope = target.slice(0, -2);
-    if (scope.startsWith("@")) {
-      return packageName.startsWith(`${scope}/`);
-    }
-    return packageName.startsWith(`${scope}/`);
-  }
-  if (target === "*") {
-    return true;
-  }
-  return false;
-}
-function shouldProcessPackage(packageName, targets = [], skip = []) {
-  if (skip.includes(packageName)) {
-    return false;
-  }
-  if (targets.length === 0) {
-    return true;
-  }
-  return targets.some((target) => matchesPackageTarget(packageName, target));
-}
-
 // src/package/packageProcessor.ts
 var PackageProcessor = class {
   skip;
-  targets;
   versionPrefix;
   tagTemplate;
   commitMessageTemplate;
@@ -1792,7 +1788,6 @@ var PackageProcessor = class {
   fullConfig;
   constructor(options) {
     this.skip = options.skip || [];
-    this.targets = options.targets || [];
     this.versionPrefix = options.versionPrefix || "v";
     this.tagTemplate = options.tagTemplate;
     this.commitMessageTemplate = options.commitMessageTemplate || "";
@@ -1803,13 +1798,7 @@ var PackageProcessor = class {
     this.fullConfig = options.fullConfig;
   }
   /**
-   * Set package targets to process
-   */
-  setTargets(targets) {
-    this.targets = targets;
-  }
-  /**
-   * Process packages based on targeting criteria
+   * Process packages based on skip list only (targeting handled at discovery time)
    */
   async processPackages(packages) {
     var _a, _b, _c, _d, _e;
@@ -1820,21 +1809,16 @@ var PackageProcessor = class {
       return { updatedPackages: [], tags: [] };
     }
     const pkgsToConsider = packages.filter((pkg) => {
-      var _a2;
       const pkgName = pkg.packageJson.name;
-      const shouldProcess = shouldProcessPackage(pkgName, this.targets, this.skip);
+      const shouldProcess = shouldProcessPackage(pkgName, this.skip);
       if (!shouldProcess) {
-        if ((_a2 = this.skip) == null ? void 0 : _a2.includes(pkgName)) {
-          log(`Skipping package ${pkgName} as it's in the skip list.`, "info");
-        } else {
-          log(`Package ${pkgName} not in target list, skipping.`, "info");
-        }
+        log(`Skipping package ${pkgName} as it's in the skip list.`, "info");
       }
       return shouldProcess;
     });
-    log(`Found ${pkgsToConsider.length} targeted package(s) to process after filtering.`, "info");
+    log(`Found ${pkgsToConsider.length} package(s) to process after filtering.`, "info");
     if (pkgsToConsider.length === 0) {
-      log("No matching targeted packages found to process.", "info");
+      log("No packages found to process.", "info");
       return { updatedPackages: [], tags: [] };
     }
     for (const pkg of pkgsToConsider) {
@@ -2017,7 +2001,7 @@ var PackageProcessor = class {
       updatedPackagesInfo.push({ name, version: nextVersion, path: pkgPath });
     }
     if (updatedPackagesInfo.length === 0) {
-      log("No targeted packages required a version update.", "info");
+      log("No packages required a version update.", "info");
       return { updatedPackages: [], tags };
     }
     const filesToCommit = [];
@@ -2081,9 +2065,9 @@ var PackageProcessor = class {
 };
 
 // src/core/versionStrategies.ts
-function shouldProcessPackage2(pkg, config, targets = []) {
+function shouldProcessPackage2(pkg, config) {
   const pkgName = pkg.packageJson.name;
-  return shouldProcessPackage(pkgName, targets, config.skip);
+  return shouldProcessPackage(pkgName, config.skip);
 }
 function createSyncedStrategy(config) {
   return async (packages) => {
@@ -2299,7 +2283,6 @@ function createAsyncStrategy(config) {
   };
   const processorOptions = {
     skip: config.skip || [],
-    targets: config.packages || [],
     versionPrefix: config.versionPrefix || "v",
     tagTemplate: config.tagTemplate,
     commitMessageTemplate: config.commitMessage || "",
@@ -2316,15 +2299,9 @@ function createAsyncStrategy(config) {
     }
   };
   const packageProcessor = new PackageProcessor(processorOptions);
-  return async (packages, targets = []) => {
+  return async (packages, _targets = []) => {
     try {
-      const targetPackages = targets.length > 0 ? targets : config.packages || [];
-      packageProcessor.setTargets(targetPackages);
-      if (targetPackages.length > 0) {
-        log(`Processing targeted packages: ${targetPackages.join(", ")}`, "info");
-      } else {
-        log("No targets specified, processing all non-skipped packages", "info");
-      }
+      log(`Processing ${packages.packages.length} pre-filtered packages`, "info");
       const result = await packageProcessor.processPackages(packages.packages);
       if (result.updatedPackages.length === 0) {
         log("No packages required a version update.", "info");
@@ -2406,6 +2383,25 @@ var VersionEngine = class {
         );
         pkgsResult.root = cwd4();
       }
+      if (this.config.packages && this.config.packages.length > 0) {
+        const originalCount = pkgsResult.packages.length;
+        const filteredPackages = pkgsResult.packages.filter(
+          (pkg) => shouldMatchPackageTargets(pkg.packageJson.name, this.config.packages)
+        );
+        pkgsResult.packages = filteredPackages;
+        log(
+          `Filtered ${originalCount} workspace packages to ${filteredPackages.length} based on packages config`,
+          "info"
+        );
+        if (filteredPackages.length === 0) {
+          log("Warning: No packages matched the specified patterns in config.packages", "warning");
+        }
+      } else {
+        log(
+          `Processing all ${pkgsResult.packages.length} workspace packages (no packages filter specified)`,
+          "info"
+        );
+      }
       this.workspaceCache = pkgsResult;
       return pkgsResult;
     } catch (error) {

package/docs/CI_CD_INTEGRATION.md

@@ -154,7 +154,7 @@ git push origin "v$NEW_VERSION"
 `package-versioner` respects the following environment variables:
 
 - `NO_COLOR=1`: Disables colored output in logs (automatically detected in CI environments)
-- `CI=true`: Most CI environments set this automatically, which helps the tool adjust its output behavior
+- `CI=true`: Most CI environments set this automatically, which helps the tool adjust its output behaviour
 
 ## Skipping CI for Version Commits
 

package/docs/versioning.md

@@ -170,13 +170,6 @@ This dual support makes `package-versioner` suitable for both JavaScript/TypeScr
 
 When working with monorepos, you can control which packages are processed for versioning using the `packages` configuration option. This provides flexible targeting with support for various pattern types.
 
-### Package Discovery vs. Targeting
-
-It's important to understand the distinction:
-
-- **Package Discovery**: Handled by your workspace configuration (pnpm-workspace.yaml, package.json workspaces, etc.)
-- **Package Targeting**: Controlled by the `packages` option in version.config.json to filter which discovered packages to process
-
 ### Targeting Patterns
 
 #### Exact Package Names
@@ -212,6 +205,12 @@ Combine different pattern types for flexible targeting:
 }
 ```
 
+### Behaviour
+
+- **When `packages` is specified**: Only packages matching those patterns will be processed for versioning
+- **When `packages` is empty or not specified**: All workspace packages will be processed
+- **Error handling**: If no packages match the specified patterns, a warning is displayed
+
 ### Excluding Packages
 
 Use the `skip` option to exclude specific packages from processing:
@@ -224,6 +223,8 @@ Use the `skip` option to exclude specific packages from processing:
 
 This configuration will process all packages in the `@mycompany` scope except for `@mycompany/deprecated-package`.
 
+**Note**: Your workspace configuration (pnpm-workspace.yaml, package.json workspaces, etc.) determines which packages are available in your workspace, but the `packages` option directly controls which ones get versioned.
+
 ## Tag Templates and Configuration
 
 `package-versioner` provides flexible configuration for how Git tags are formatted, allowing you to customize the tag structure for both single package repositories and monorepos.

package/package-versioner.schema.json

@@ -21,7 +21,7 @@
     "packageSpecificTags": {
       "type": "boolean",
       "default": false,
-      "description": "Whether to enable package-specific tagging behavior"
+      "description": "Whether to enable package-specific tagging behaviour"
     },
     "preset": {
       "type": "string",
@@ -53,7 +53,7 @@
         "minLength": 1
       },
       "default": [],
-      "description": "Array of package names or patterns to target for versioning. Supports exact names (e.g., '@scope/package-a'), scope wildcards (e.g., '@scope/*'), and global wildcards (e.g., '*')"
+      "description": "Array of package names or patterns that determines which packages will be processed for versioning. When specified, only packages matching these patterns will be versioned. When empty or not specified, all workspace packages will be processed. Supports exact names (e.g., '@scope/package-a'), scope wildcards (e.g., '@scope/*'), and global wildcards (e.g., '*')"
     },
     "mainPackage": {
       "type": "string",

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "package-versioner",
   "description": "A lightweight yet powerful CLI tool for automated semantic versioning based on Git history and conventional commits.",
-  "version": "0.8.1",
+  "version": "0.8.2",
   "type": "module",
   "main": "./dist/index.js",
   "module": "./dist/index.mjs",
@@ -37,17 +37,17 @@
     ]
   },
   "devDependencies": {
-    "@biomejs/biome": "^1.9.4",
+    "@biomejs/biome": "^2.0.6",
     "@types/figlet": "^1.5.5",
-    "@types/node": "^24.0.3",
+    "@types/node": "^24.0.10",
     "@types/semver": "^7.3.13",
-    "@vitest/coverage-v8": "^3.2.3",
+    "@vitest/coverage-v8": "^3.2.4",
     "husky": "^9.1.7",
     "lint-staged": "^16.1.2",
     "tsup": "^8.5.0",
     "tsx": "^4.20.3",
     "typescript": "^5.8.3",
-    "vitest": "^3.2.3"
+    "vitest": "^3.2.4"
   },
   "dependencies": {
     "@manypkg/get-packages": "^3.0.0",
@@ -59,7 +59,7 @@
     "figlet": "^1.8.1",
     "git-semver-tags": "^8.0.0",
     "semver": "^7.7.2",
-    "smol-toml": "^1.3.4"
+    "smol-toml": "^1.4.1"
   },
   "scripts": {
     "build": "tsup src/index.ts --format esm,cjs --dts",