@qlover/fe-release 5.0.4 → 5.0.5

package/dist/cli.cjs

@@ -28,7 +28,7 @@ var import_commander = require("commander");
 
 // package.json
 var description = "A tool for releasing front-end projects, supporting multiple release modes and configurations, simplifying the release process and improving efficiency.";
-var version = "5.0.4";
+var version = "5.0.5";
 
 // src/cli.ts
 var import_semver = __toESM(require("semver"), 1);
@@ -69,16 +69,23 @@ var releaseJson = {
     autoMergeReleasePR: false,
     pushChangeLabels: false,
     skipCreateReleasePR: false,
-    PRTitle: "Release ${env} ${pkgName} ${tagName}",
+    /** Used when releasing 1–2 packages */
+    PRTitle: "Release ${spaces}",
+    /** Used when releasing more than 2 packages */
+    PRTitleMany: "Release ${count} packages: ${spaces}",
     PRBody: "## Changelog\n\n${changelog}",
-    batchPRBody: "\n## ${name} ${newVersion}\n${changelog}\n",
+    /**
+     * Per-workspace section in the PR body (single and multi package).
+     * `${changeTypeSection}` is Patch/Minor/Major Changes from increment.
+     */
+    batchPRBody: "\n### ${name}@${newVersion}\n\n#### ${changeTypeSection}\n\n${changelog}\n",
     branchName: "release/${repoName}-${releaseId}",
     releaseTagName: "release-tag-${count}-patch-${releaseId}",
     commitMessage: "chore(release): ${spaces}",
     label: {
       name: "CI-Release",
       color: "1A7F37",
-      description: "Release PR"
+      description: "Automated release PR (merge to publish)"
     }
   },
   changesetVersion: {
@@ -3375,23 +3382,33 @@ var ReleaseFormatter = class {
     if (workspaces.length === 0) {
       return "";
     }
-    if (workspaces.length === 1) {
-      return workspaces[0].changelog || "";
-    }
+    const changeTypeSection = this.getChangeTypeSection();
+    const batchTpl = this.config.batchPRBody || releaseJson.github.batchPRBody;
     return workspaces.map(
-      (workspace) => this.templateEngine.render(
-        this.config.batchPRBody || releaseJson.github.batchPRBody,
-        {
-          ...workspace,
-          // Prefer bumped version in PR changelog section headers
-          version: workspace.newVersion || workspace.version,
-          newVersion: workspace.newVersion || workspace.version
-        }
-      )
+      (workspace) => this.templateEngine.render(batchTpl, {
+        ...workspace,
+        // Prefer bumped version in PR changelog section headers
+        version: workspace.newVersion || workspace.version,
+        newVersion: workspace.newVersion || workspace.version,
+        changeTypeSection
+      })
     ).join("\n");
   }
+  /**
+   * Map semver increment to Changesets-style section title.
+   */
+  getChangeTypeSection() {
+    const increment = (this.config.increment || "patch").toLowerCase();
+    if (increment === "major") {
+      return "Major Changes";
+    }
+    if (increment === "minor") {
+      return "Minor Changes";
+    }
+    return "Patch Changes";
+  }
   formatPRTagName(workspaces, releaseBranchResult) {
-    if (workspaces.length <= 1) {
+    if (workspaces.length === 0) {
       return releaseBranchResult.releaseTagName;
     }
     return workspaces.map(
@@ -3399,7 +3416,8 @@ var ReleaseFormatter = class {
     ).join(" ");
   }
   getPRTitle(releaseBranchResult, context, workspaces = []) {
-    const prTitleTpl = this.config.PRTitle || releaseJson.github.PRTitle;
+    const count = workspaces.length;
+    const prTitleTpl = count > 2 ? this.config.PRTitleMany || this.config.PRTitle || releaseJson.github.PRTitleMany : this.config.PRTitle || releaseJson.github.PRTitle;
     return this.templateEngine.render(
       prTitleTpl,
       this.buildPRTemplateVars(workspaces, releaseBranchResult, context)
@@ -3437,7 +3455,8 @@ var Github = class extends GitBase {
       repoName: this.context.options.repoName,
       authorName: this.context.options.authorName,
       env: this.context.options.releaseEnv,
-      releaseId: this.context.releaseId
+      releaseId: this.context.releaseId,
+      increment: this.context.parameters.changesetVersion?.increment || releaseJson.changesetVersion.increment
     });
     this.logger.info(`Github mode: ${this.mode}`);
   }

package/dist/cli.js

@@ -5,7 +5,7 @@ import { Command } from "commander";
 
 // package.json
 var description = "A tool for releasing front-end projects, supporting multiple release modes and configurations, simplifying the release process and improving efficiency.";
-var version = "5.0.4";
+var version = "5.0.5";
 
 // src/cli.ts
 import semver from "semver";
@@ -46,16 +46,23 @@ var releaseJson = {
     autoMergeReleasePR: false,
     pushChangeLabels: false,
     skipCreateReleasePR: false,
-    PRTitle: "Release ${env} ${pkgName} ${tagName}",
+    /** Used when releasing 1–2 packages */
+    PRTitle: "Release ${spaces}",
+    /** Used when releasing more than 2 packages */
+    PRTitleMany: "Release ${count} packages: ${spaces}",
     PRBody: "## Changelog\n\n${changelog}",
-    batchPRBody: "\n## ${name} ${newVersion}\n${changelog}\n",
+    /**
+     * Per-workspace section in the PR body (single and multi package).
+     * `${changeTypeSection}` is Patch/Minor/Major Changes from increment.
+     */
+    batchPRBody: "\n### ${name}@${newVersion}\n\n#### ${changeTypeSection}\n\n${changelog}\n",
     branchName: "release/${repoName}-${releaseId}",
     releaseTagName: "release-tag-${count}-patch-${releaseId}",
     commitMessage: "chore(release): ${spaces}",
     label: {
       name: "CI-Release",
       color: "1A7F37",
-      description: "Release PR"
+      description: "Automated release PR (merge to publish)"
     }
   },
   changesetVersion: {
@@ -3355,23 +3362,33 @@ var ReleaseFormatter = class {
     if (workspaces.length === 0) {
       return "";
     }
-    if (workspaces.length === 1) {
-      return workspaces[0].changelog || "";
-    }
+    const changeTypeSection = this.getChangeTypeSection();
+    const batchTpl = this.config.batchPRBody || releaseJson.github.batchPRBody;
     return workspaces.map(
-      (workspace) => this.templateEngine.render(
-        this.config.batchPRBody || releaseJson.github.batchPRBody,
-        {
-          ...workspace,
-          // Prefer bumped version in PR changelog section headers
-          version: workspace.newVersion || workspace.version,
-          newVersion: workspace.newVersion || workspace.version
-        }
-      )
+      (workspace) => this.templateEngine.render(batchTpl, {
+        ...workspace,
+        // Prefer bumped version in PR changelog section headers
+        version: workspace.newVersion || workspace.version,
+        newVersion: workspace.newVersion || workspace.version,
+        changeTypeSection
+      })
     ).join("\n");
   }
+  /**
+   * Map semver increment to Changesets-style section title.
+   */
+  getChangeTypeSection() {
+    const increment = (this.config.increment || "patch").toLowerCase();
+    if (increment === "major") {
+      return "Major Changes";
+    }
+    if (increment === "minor") {
+      return "Minor Changes";
+    }
+    return "Patch Changes";
+  }
   formatPRTagName(workspaces, releaseBranchResult) {
-    if (workspaces.length <= 1) {
+    if (workspaces.length === 0) {
       return releaseBranchResult.releaseTagName;
     }
     return workspaces.map(
@@ -3379,7 +3396,8 @@ var ReleaseFormatter = class {
     ).join(" ");
   }
   getPRTitle(releaseBranchResult, context, workspaces = []) {
-    const prTitleTpl = this.config.PRTitle || releaseJson.github.PRTitle;
+    const count = workspaces.length;
+    const prTitleTpl = count > 2 ? this.config.PRTitleMany || this.config.PRTitle || releaseJson.github.PRTitleMany : this.config.PRTitle || releaseJson.github.PRTitle;
     return this.templateEngine.render(
       prTitleTpl,
       this.buildPRTemplateVars(workspaces, releaseBranchResult, context)
@@ -3417,7 +3435,8 @@ var Github = class extends GitBase {
       repoName: this.context.options.repoName,
       authorName: this.context.options.authorName,
       env: this.context.options.releaseEnv,
-      releaseId: this.context.releaseId
+      releaseId: this.context.releaseId,
+      increment: this.context.parameters.changesetVersion?.increment || releaseJson.changesetVersion.increment
     });
     this.logger.info(`Github mode: ${this.mode}`);
   }

package/dist/index.cjs

@@ -66,16 +66,23 @@ var releaseJson = {
     autoMergeReleasePR: false,
     pushChangeLabels: false,
     skipCreateReleasePR: false,
-    PRTitle: "Release ${env} ${pkgName} ${tagName}",
+    /** Used when releasing 1–2 packages */
+    PRTitle: "Release ${spaces}",
+    /** Used when releasing more than 2 packages */
+    PRTitleMany: "Release ${count} packages: ${spaces}",
     PRBody: "## Changelog\n\n${changelog}",
-    batchPRBody: "\n## ${name} ${newVersion}\n${changelog}\n",
+    /**
+     * Per-workspace section in the PR body (single and multi package).
+     * `${changeTypeSection}` is Patch/Minor/Major Changes from increment.
+     */
+    batchPRBody: "\n### ${name}@${newVersion}\n\n#### ${changeTypeSection}\n\n${changelog}\n",
     branchName: "release/${repoName}-${releaseId}",
     releaseTagName: "release-tag-${count}-patch-${releaseId}",
     commitMessage: "chore(release): ${spaces}",
     label: {
       name: "CI-Release",
       color: "1A7F37",
-      description: "Release PR"
+      description: "Automated release PR (merge to publish)"
     }
   },
   changesetVersion: {
@@ -3380,23 +3387,33 @@ var ReleaseFormatter = class {
     if (workspaces.length === 0) {
       return "";
     }
-    if (workspaces.length === 1) {
-      return workspaces[0].changelog || "";
-    }
+    const changeTypeSection = this.getChangeTypeSection();
+    const batchTpl = this.config.batchPRBody || releaseJson.github.batchPRBody;
     return workspaces.map(
-      (workspace) => this.templateEngine.render(
-        this.config.batchPRBody || releaseJson.github.batchPRBody,
-        {
-          ...workspace,
-          // Prefer bumped version in PR changelog section headers
-          version: workspace.newVersion || workspace.version,
-          newVersion: workspace.newVersion || workspace.version
-        }
-      )
+      (workspace) => this.templateEngine.render(batchTpl, {
+        ...workspace,
+        // Prefer bumped version in PR changelog section headers
+        version: workspace.newVersion || workspace.version,
+        newVersion: workspace.newVersion || workspace.version,
+        changeTypeSection
+      })
     ).join("\n");
   }
+  /**
+   * Map semver increment to Changesets-style section title.
+   */
+  getChangeTypeSection() {
+    const increment = (this.config.increment || "patch").toLowerCase();
+    if (increment === "major") {
+      return "Major Changes";
+    }
+    if (increment === "minor") {
+      return "Minor Changes";
+    }
+    return "Patch Changes";
+  }
   formatPRTagName(workspaces, releaseBranchResult) {
-    if (workspaces.length <= 1) {
+    if (workspaces.length === 0) {
       return releaseBranchResult.releaseTagName;
     }
     return workspaces.map(
@@ -3404,7 +3421,8 @@ var ReleaseFormatter = class {
     ).join(" ");
   }
   getPRTitle(releaseBranchResult, context, workspaces = []) {
-    const prTitleTpl = this.config.PRTitle || releaseJson.github.PRTitle;
+    const count = workspaces.length;
+    const prTitleTpl = count > 2 ? this.config.PRTitleMany || this.config.PRTitle || releaseJson.github.PRTitleMany : this.config.PRTitle || releaseJson.github.PRTitle;
     return this.templateEngine.render(
       prTitleTpl,
       this.buildPRTemplateVars(workspaces, releaseBranchResult, context)
@@ -3442,7 +3460,8 @@ var Github = class extends GitBase {
       repoName: this.context.options.repoName,
       authorName: this.context.options.authorName,
       env: this.context.options.releaseEnv,
-      releaseId: this.context.releaseId
+      releaseId: this.context.releaseId,
+      increment: this.context.parameters.changesetVersion?.increment || releaseJson.changesetVersion.increment
     });
     this.logger.info(`Github mode: ${this.mode}`);
   }

package/dist/index.d.ts

@@ -216,11 +216,19 @@ interface ReleaseFormatterConfig {
         more: string;
     };
     /**
-     * Pull request title template
+     * Pull request title template (1–2 packages)
      *
-     * @default {@link DEFAULT_PR_TITLE}
+     * @default {@link releaseJson.github.PRTitle}
      */
     PRTitle?: string;
+    /**
+     * Pull request title template when releasing more than 2 packages
+     *
+     * Falls back to {@link PRTitle} when unset.
+     *
+     * @default {@link releaseJson.github.PRTitleMany}
+     */
+    PRTitleMany?: string;
     /**
      * Pull request body template
      *
@@ -228,11 +236,19 @@ interface ReleaseFormatterConfig {
      */
     PRBody?: string;
     /**
-     * Template for each workspace section in a multi-workspace PR body
+     * Template for each workspace section in the PR body
+     *
+     * Used for both single- and multi-workspace releases.
+     * Supports `${changeTypeSection}` (Patch/Minor/Major Changes).
      *
      * @default from release.json
      */
     batchPRBody?: string;
+    /**
+     * Semver increment used to title changelog sections (patch | minor | major)
+     * @default 'patch'
+     */
+    increment?: string;
 }
 
 /**
@@ -1415,16 +1431,23 @@ declare const releaseJson: {
         readonly autoMergeReleasePR: false;
         readonly pushChangeLabels: false;
         readonly skipCreateReleasePR: false;
-        readonly PRTitle: "Release ${env} ${pkgName} ${tagName}";
+        /** Used when releasing 1–2 packages */
+        readonly PRTitle: "Release ${spaces}";
+        /** Used when releasing more than 2 packages */
+        readonly PRTitleMany: "Release ${count} packages: ${spaces}";
         readonly PRBody: "## Changelog\n\n${changelog}";
-        readonly batchPRBody: "\n## ${name} ${newVersion}\n${changelog}\n";
+        /**
+         * Per-workspace section in the PR body (single and multi package).
+         * `${changeTypeSection}` is Patch/Minor/Major Changes from increment.
+         */
+        readonly batchPRBody: "\n### ${name}@${newVersion}\n\n#### ${changeTypeSection}\n\n${changelog}\n";
         readonly branchName: "release/${repoName}-${releaseId}";
         readonly releaseTagName: "release-tag-${count}-patch-${releaseId}";
         readonly commitMessage: "chore(release): ${spaces}";
         readonly label: {
             readonly name: "CI-Release";
             readonly color: "1A7F37";
-            readonly description: "Release PR";
+            readonly description: "Automated release PR (merge to publish)";
         };
     };
     readonly changesetVersion: {

package/dist/index.js

@@ -14,16 +14,23 @@ var releaseJson = {
     autoMergeReleasePR: false,
     pushChangeLabels: false,
     skipCreateReleasePR: false,
-    PRTitle: "Release ${env} ${pkgName} ${tagName}",
+    /** Used when releasing 1–2 packages */
+    PRTitle: "Release ${spaces}",
+    /** Used when releasing more than 2 packages */
+    PRTitleMany: "Release ${count} packages: ${spaces}",
     PRBody: "## Changelog\n\n${changelog}",
-    batchPRBody: "\n## ${name} ${newVersion}\n${changelog}\n",
+    /**
+     * Per-workspace section in the PR body (single and multi package).
+     * `${changeTypeSection}` is Patch/Minor/Major Changes from increment.
+     */
+    batchPRBody: "\n### ${name}@${newVersion}\n\n#### ${changeTypeSection}\n\n${changelog}\n",
     branchName: "release/${repoName}-${releaseId}",
     releaseTagName: "release-tag-${count}-patch-${releaseId}",
     commitMessage: "chore(release): ${spaces}",
     label: {
       name: "CI-Release",
       color: "1A7F37",
-      description: "Release PR"
+      description: "Automated release PR (merge to publish)"
     }
   },
   changesetVersion: {
@@ -3331,23 +3338,33 @@ var ReleaseFormatter = class {
     if (workspaces.length === 0) {
       return "";
     }
-    if (workspaces.length === 1) {
-      return workspaces[0].changelog || "";
-    }
+    const changeTypeSection = this.getChangeTypeSection();
+    const batchTpl = this.config.batchPRBody || releaseJson.github.batchPRBody;
     return workspaces.map(
-      (workspace) => this.templateEngine.render(
-        this.config.batchPRBody || releaseJson.github.batchPRBody,
-        {
-          ...workspace,
-          // Prefer bumped version in PR changelog section headers
-          version: workspace.newVersion || workspace.version,
-          newVersion: workspace.newVersion || workspace.version
-        }
-      )
+      (workspace) => this.templateEngine.render(batchTpl, {
+        ...workspace,
+        // Prefer bumped version in PR changelog section headers
+        version: workspace.newVersion || workspace.version,
+        newVersion: workspace.newVersion || workspace.version,
+        changeTypeSection
+      })
     ).join("\n");
   }
+  /**
+   * Map semver increment to Changesets-style section title.
+   */
+  getChangeTypeSection() {
+    const increment = (this.config.increment || "patch").toLowerCase();
+    if (increment === "major") {
+      return "Major Changes";
+    }
+    if (increment === "minor") {
+      return "Minor Changes";
+    }
+    return "Patch Changes";
+  }
   formatPRTagName(workspaces, releaseBranchResult) {
-    if (workspaces.length <= 1) {
+    if (workspaces.length === 0) {
       return releaseBranchResult.releaseTagName;
     }
     return workspaces.map(
@@ -3355,7 +3372,8 @@ var ReleaseFormatter = class {
     ).join(" ");
   }
   getPRTitle(releaseBranchResult, context, workspaces = []) {
-    const prTitleTpl = this.config.PRTitle || releaseJson.github.PRTitle;
+    const count = workspaces.length;
+    const prTitleTpl = count > 2 ? this.config.PRTitleMany || this.config.PRTitle || releaseJson.github.PRTitleMany : this.config.PRTitle || releaseJson.github.PRTitle;
     return this.templateEngine.render(
       prTitleTpl,
       this.buildPRTemplateVars(workspaces, releaseBranchResult, context)
@@ -3393,7 +3411,8 @@ var Github = class extends GitBase {
       repoName: this.context.options.repoName,
       authorName: this.context.options.authorName,
       env: this.context.options.releaseEnv,
-      releaseId: this.context.releaseId
+      releaseId: this.context.releaseId,
+      increment: this.context.parameters.changesetVersion?.increment || releaseJson.changesetVersion.increment
     });
     this.logger.info(`Github mode: ${this.mode}`);
   }

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@qlover/fe-release",
   "description": "A tool for releasing front-end projects, supporting multiple release modes and configurations, simplifying the release process and improving efficiency.",
-  "version": "5.0.4",
+  "version": "5.0.5",
   "type": "module",
   "private": false,
   "homepage": "https://github.com/qlover/fe-base/tree/master/packages/fe-release",
@@ -61,8 +61,8 @@
     "semver": "^7.5.4",
     "@qlover/env-loader": "1.0.2",
     "@qlover/fe-corekit": "3.3.0",
-    "@qlover/scripts-context": "2.3.3",
-    "@qlover/logger": "1.2.1"
+    "@qlover/logger": "1.2.1",
+    "@qlover/scripts-context": "2.3.3"
   },
   "scripts": {
     "lint": "eslint src --fix",