release-npm-packages.yml

name: Publish subpackages to npm

on:
  release:
    types: [published]
  workflow_dispatch:
    inputs:
      publish_all:
        description: 'Publish all packages (ignore change detection)'
        type: boolean
        default: false
      version:
        description: 'Version to publish (e.g. 1.2.3). Required for manual runs.'
        type: string
        required: true

jobs:
  publish:
    runs-on: ubuntu-latest
    env:
      FORCE_JAVASCRIPT_ACTIONS_TO_NODE24: true
    permissions:
      contents: read
      id-token: write

    steps:
      - name: Checkout repo
        uses: actions/checkout@v4
        with:
          fetch-depth: 0

      - name: Use Node.js
        uses: actions/setup-node@v4
        with:
          node-version: 24
          registry-url: "https://registry.npmjs.org"

      - name: Get release version
        id: release
        run: |
          if [ -n "${{ inputs.version }}" ]; then
            echo "version=${{ inputs.version }}" >> "$GITHUB_OUTPUT"
          else
            echo "version=${GITHUB_REF_NAME#v}" >> "$GITHUB_OUTPUT"
          fi

      - name: Get previous release tag
        id: prev_tag
        run: |
          CURRENT_TAG="${GITHUB_REF_NAME}"
          PREV_TAG=$(git tag --sort=-version:refname | grep -v "^${CURRENT_TAG}$" | head -1)
          if [ -z "$PREV_TAG" ]; then
            # No previous tag: diff against the very first commit
            PREV_TAG=$(git rev-list --max-parents=0 HEAD)
          fi
          echo "tag=$PREV_TAG" >> "$GITHUB_OUTPUT"

      - name: Detect changed packages
        id: changes
        run: |
          CHANGED=""
          for dir in templates/*; do
            # skip if folder does not contain a package.json
            if [ ! -f "$dir/package.json" ]; then
               echo "Skipping $dir (no package.json)"
               continue
            fi

            # skip storybook as it's not meant to be published
            if [ "$(basename "$dir")" = "storybook" ]; then
              echo "Skipping storybook (development tool, not for publishing)"
              continue
            fi

            if [ "${{ github.event_name }}" != "workflow_dispatch" ] \
               && [ "${{ inputs.publish_all }}" != "true" ] \
               && git diff --quiet "${{ steps.prev_tag.outputs.tag }}" HEAD -- "$dir"; then
              continue
            fi

            CHANGED="$CHANGED $dir"
          done
          echo "dirs=$CHANGED" >> "$GITHUB_OUTPUT"

      - name: Publish changed packages
        # Requires npm Trusted Publishing configured on npmjs.com for each package:
        # Package Settings → Publishing → Trusted Publishers → Add GitHub Actions publisher
        # (owner: vardumper, repo: extended-htmldocument, workflow: release-npm-packages.yml)
        if: steps.changes.outputs.dirs != ''
        run: |
          VERSION="${{ steps.release.outputs.version }}"
          
          for dir in ${{ steps.changes.outputs.dirs }}; do
            echo "Publishing $dir"

            # update version number
            jq --arg v "$VERSION" '.version=$v' "$dir/package.json" \
              > "$dir/package.json.tmp"
            mv "$dir/package.json.tmp" "$dir/package.json"

            cd "$dir"
            npm publish --access public --provenance
            cd -
          done