ci: config beachball to automate publishing process

Author: rainx

Diff for: .github/workflows/ci.yml

@@ -40,3 +40,23 @@ jobs:
 
       - name: Build
         run: pnpm run build
+
+      - name: Publish (development)
+        if: github.repository == 'RightCapitalHQ/php-parser' && github.base_ref == github.event.repository.default_branch
+        env:
+          NPM_TOKEN: ${{ secrets.NPM_PUBLISH_TOKEN }}
+        run: |
+          npm config set //registry.npmjs.org/:_authToken "${NPM_TOKEN}"
+          preid=$(sed -e s:/:-:g <<<${{ github.head_ref }}).${{ github.run_number }}.${{ github.run_attempt }}
+          npm --no-git-tag-version version prerelease --preid="${preid}"
+          pnpm publish --no-git-checks --access public --tag development
+
+      - name: Publish (main)
+        if: github.repository == 'RightCapitalHQ/php-parser' && github.ref_name == github.event.repository.default_branch
+        env:
+          NPM_TOKEN: ${{ secrets.NPM_PUBLISH_TOKEN }}
+        run: |
+          npm config set //registry.npmjs.org/:_authToken "${NPM_TOKEN}"
+          git config --local user.email "[email protected]"
+          git config --local user.name "GitHub Actions[bot]"
+          pnpm beachball publish --access public --yes -m 'chore(release): applying package updates'

Diff for: beachball.config.js

@@ -0,0 +1,40 @@
+// @ts-check
+/** @type {import('beachball').BeachballConfig} */
+module.exports = {
+  registry: 'https://registry.npmjs.org',
+  ignorePatterns: [
+    '.*ignore',
+    'prettier.config.cjs',
+    '.eslintrc.cjs',
+    'jest.*.js',
+    '.pnpm-store/**',
+    '.vscode/**',
+    'pnpm-lock.yaml',
+  ],
+  changelog: {
+    customRenderers: {
+      renderHeader() {},
+      renderChangeTypeHeader(changeType, renderInfo) {
+        const changelogDate = renderInfo.newVersionChangelog.date
+          .toLocaleDateString('zh-CN')
+          .replace(/\//g, '-');
+        const heading =
+          changeType === 'major' || changeType === 'minor' ? '##' : '###';
+        return `${heading} [${renderInfo.newVersionChangelog.version}](https://github.com/RightCapitalHQ/phpdoc-parser/tree/${renderInfo.newVersionChangelog.tag}) (${changelogDate})`;
+      },
+      // Original template: https://github.com/microsoft/beachball/blob/aefbc1ac37ee85961cc787133c827f1fd3925550/src/changelog/renderPackageChangelog.ts#L93
+      renderEntry(entry) {
+        if (entry.author === 'beachball') {
+          return `- ${entry.comment}`;
+        }
+        // Imitate GitHub's commit format https://docs.github.com/en/get-started/writing-on-github/working-with-advanced-formatting/autolinked-references-and-urls#commit-shas
+        return `- ${entry.comment} ([${entry.commit.substring(
+          0,
+          7,
+        )}](https://github.com/RightCapitalHQ/phpdoc-parser/commit/${
+          entry.commit
+        }))`;
+      },
+    },
+  },
+};

Diff for: package.json

@@ -6,6 +6,8 @@
   "scripts": {
     "commit": "cz",
     "clean": "tsc --build --clean ./tsconfig.build.json",
+    "change": "beachball change --no-commit",
+    "check": "beachball check",
     "build": "pnpm run clean && tsc --project ./tsconfig.build.json",
     "eslint": "eslint --report-unused-disable-directives 'src/**/*.ts*'",
     "eslint:fix": "eslint --report-unused-disable-directives --fix 'src/**/*.ts*'",
@@ -49,6 +51,7 @@
     "@types/lodash": "4.14.198",
     "@types/mustache": "4.2.2",
     "@types/node": "20.6.0",
+    "beachball": "2.37.0",
     "husky": "8.0.3"
   },
   "config": {