feat: release workflows

Author: northword

.github/workflows/release-npm.yml

@@ -0,0 +1,52 @@
+name: Reusable Release NPM Package Workflow
+
+on:
+  workflow_call:
+    inputs:
+      build:
+        required: false
+        type: string
+        default: ""
+      cr:
+        description: Enable Continuous Releases, powered by pkg-pr-new
+        required: false
+        type: boolean
+        default: false
+
+jobs:
+  release:
+    name: Release
+    runs-on: ubuntu-latest
+
+    permissions:
+      contents: write
+      id-token: write
+
+    steps:
+      - name: Setup JS
+        uses: zotero-plugin-dev/workflows/setup-js@main
+        with:
+          fetch-all: true
+
+      - name: Build
+        if: ${{ inputs.build }}
+        run: ${{ inputs.build }}
+
+      # ========================================
+      #  Production release (Tag-triggered)
+      #  Runs only when pushing a version tag
+      # ========================================
+      - name: Publish to NPM and sync Changelog
+        if: github.event_name == 'push' && github.ref_type == 'tag' && startsWith(github.ref, 'refs/tags/')
+        run: |
+          pnpm publish --no-git-checks --access public
+          pnpx changelogithub
+        env:
+          NPM_CONFIG_PROVENANCE: true
+
+      # ========================================
+      #  Preview release (Push / PR-triggered)
+      # ========================================
+      - name: Publish Preview Package (pkg-pr-new)
+        if: ${{ inputs.cr == true && github.ref_type != 'tag' }}
+        run: pnpx pkg-pr-new publish --compact --no-template --pnpm

.github/workflows/release-plugin.yml

@@ -0,0 +1,63 @@
+name: Reusable Release Zotero Plugin Workflow
+
+on:
+  workflow_call:
+    inputs:
+      fetch-all:
+        description: "Whether to fetch all commits and submodules."
+        type: boolean
+        required: false
+        default: false
+      build:
+        description: "The command to build the project. Set to an empty string to skip."
+        type: string
+        required: false
+        default: ""
+      release:
+        description: "The command to execute the release (e.g., publishing to GitHub Releases)."
+        type: string
+        required: true
+        default: "pnpm release"
+      comment-template:
+        description: "Template for the comment posted on related Issues/PRs after release."
+        type: string
+        required: false
+        default: |
+          :rocket: _This ticket has been resolved in {release_tag}. See {release_link} for release notes._
+
+    secrets:
+      GITHUB_TOKEN:
+        description: "A GITHUB_TOKEN with write permissions for contents, issues, and pull-requests."
+        required: false
+
+permissions:
+  contents: write
+  issues: write
+  pull-requests: write
+
+jobs:
+  release:
+    runs-on: ubuntu-latest
+    steps:
+      - name: Setup JS
+        uses: zotero-plugin-dev/workflows/setup-js@main
+        with:
+          fetch-all: ${{ inputs.fetch-all }}
+
+      - name: Build
+        if: inputs.build != ''
+        run: ${{ inputs.build }}
+
+      - name: Release to GitHub
+        run: ${{ inputs.release }}
+        env:
+          GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}
+
+      - run: sleep 1s
+
+      - name: Notify release
+        uses: apexskier/github-release-commenter@v1
+        continue-on-error: true
+        with:
+          GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}
+          comment-template: ${{ inputs.comment-template }}

examples/release-npm.yml

@@ -0,0 +1,21 @@
+name: Release
+
+on:
+  push:
+    branches:
+      - main
+    tags:
+      - v**
+  pull_request:
+    branches:
+      - main
+
+jobs:
+  release:
+    uses: zotero-plugin-dev/workflows/.github/workflows/release-npm.yml@main
+    with:
+      build: "pnpm build"
+      cr: true
+    permissions:
+      contents: write
+      id-token: write

examples/release-plugin.yml

@@ -0,0 +1,22 @@
+name: Release
+
+on:
+  push:
+    tags:
+      - v**
+
+permissions:
+  contents: write
+  issues: write
+  pull-requests: write
+
+jobs:
+  create-release:
+    uses: zotero-plugin-dev/workflows/.github/workflows/release-plugin.yml@main
+
+    # You can customize any of the inputs here.
+    # If you omit an input, its default value will be used.
+    # with:
+    #   build: ""
+    #   release: "pnpm release"
+    # secrets: inherit