chore: add gha workflows for PR validation, stable promotion, and package release

Author: caio-pizzol

.github/workflows/pr-validation.yml

@@ -0,0 +1,33 @@
+name: PR Validation
+
+on:
+  pull_request:
+    branches: [main, stable, "*.x"]
+
+concurrency:
+  group: pr-${{ github.event.pull_request.number }}
+  cancel-in-progress: true
+
+jobs:
+  validate:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+        with:
+          fetch-depth: 0
+
+      - uses: actions/setup-node@v4
+        with:
+          node-version: 22
+
+      - run: npm ci
+
+      - name: Validate commits
+        run: |
+          npx commitlint \
+            --from ${{ github.event.pull_request.base.sha }} \
+            --to ${{ github.event.pull_request.head.sha }}
+
+      - run: npm run lint
+      - run: npm run build
+      - run: npm test

.github/workflows/promote-stable.yml

@@ -0,0 +1,19 @@
+name: Promote to Stable
+
+on:
+  workflow_dispatch:
+
+jobs:
+  promote:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+        with:
+          fetch-depth: 0
+
+      - run: |
+          git config user.name "github-actions[bot]"
+          git config user.email "github-actions[bot]@users.noreply.github.com"
+          git checkout stable || git checkout -b stable
+          git merge main --no-ff -m "chore: promote main to stable"
+          git push origin stable

.github/workflows/release-package.yml

@@ -0,0 +1,41 @@
+name: Release Package
+
+on:
+  push:
+    branches: [main, stable, "*.x"]
+    paths:
+      - "packages/**"
+      - "!**.md"
+  workflow_dispatch:
+
+concurrency:
+  group: release-${{ github.ref }}
+  cancel-in-progress: true
+
+jobs:
+  release:
+    runs-on: ubuntu-latest
+    permissions:
+      contents: write
+      packages: write
+    steps:
+      - uses: actions/checkout@v4
+        with:
+          fetch-depth: 0
+          token: ${{ secrets.GITHUB_TOKEN }}
+
+      - uses: actions/setup-node@v4
+        with:
+          node-version: 22
+          registry-url: "https://registry.npmjs.org"
+
+      - run: npm ci
+      - run: npm run build
+      - run: npm test
+
+      - name: Release
+        env:
+          GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}
+          NPM_TOKEN: ${{ secrets.NPM_TOKEN }}
+          NODE_AUTH_TOKEN: ${{ secrets.NPM_TOKEN }}
+        run: npx semantic-release

.releaserc.cjs

@@ -0,0 +1,69 @@
+/* eslint-env node */
+
+const branch = process.env.GITHUB_REF_NAME || process.env.CI_COMMIT_BRANCH
+
+const config = {
+  branches: [
+    {
+      name: 'stable',
+      channel: 'latest', // Only stable gets @latest
+    },
+    {
+      name: 'main',
+      prerelease: 'next',
+      channel: 'next',
+    },
+    // Maintenance branches - channel defaults to branch name
+    {
+      name: '+([0-9])?(.{+([0-9]),x}).x',
+      // No channel specified - defaults to branch name (0.8.x, 1.2.x, etc)
+    },
+  ],
+  tagFormat: 'v${version}',
+  plugins: [
+    '@semantic-release/commit-analyzer',
+    '@semantic-release/release-notes-generator',
+    // NPM plugin MUST come before git plugin - ADD pkgRoot HERE!
+    [
+      '@semantic-release/npm',
+      {
+        npmPublish: true,
+        pkgRoot: 'packages/superdoc'
+      }
+    ],
+    './scripts/publish-superdoc.cjs'
+  ],
+}
+
+// Only add changelog and git plugins for non-prerelease branches
+const isPrerelease = config.branches.some(
+  (b) => typeof b === 'object' && b.name === branch && b.prerelease
+)
+
+if (!isPrerelease) {
+  // Add changelog BEFORE git
+  config.plugins.push([
+    '@semantic-release/changelog',
+    {
+      changelogFile: 'packages/superdoc/CHANGELOG.md'  // Also specify where changelog goes
+    }
+  ])
+
+  // Git plugin comes AFTER npm and changelog
+  config.plugins.push([
+    '@semantic-release/git',
+    {
+      assets: [
+        'packages/superdoc/CHANGELOG.md',
+        'packages/superdoc/package.json'  // Update paths to point to actual package
+      ],
+      message:
+        'chore(release): ${nextRelease.version} [skip ci]\n\n${nextRelease.notes}',
+    },
+  ])
+}
+
+// GitHub plugin comes last
+config.plugins.push('@semantic-release/github')
+
+module.exports = config