Merge branch 'v7' into v6

Author: pluma

.github/workflows/docs.yml

@@ -2,13 +2,13 @@ name: Update docs
 
 on:
   push:
+    tags:
+      - "v7.*.*" # all v7 semver release tags
     branches:
-      - v7
-      - master
+      - main
 
 jobs:
   publish-docs:
-
     runs-on: ubuntu-latest
 
     steps:
@@ -23,17 +23,58 @@ jobs:
         uses: actions/checkout@v2
         with:
           ref: gh-pages
-          path: tsdoc
+          path: gh-pages
+
+      - run: yarn
+
+      - name: Set tag env to devel
+        if: startsWith( github.event.ref, 'refs/heads/' )
+        run: |
+          echo "::set-env name=tag::devel"
+          echo "::set-env name=latest::1"
+
+      - name: Set tag env to ref tag
+        if: startsWith( github.event.ref, 'refs/tags/v' )
+        run: |
+          export tag=$(echo ${{ github.event.ref }} | sed -e 's/^refs\/tags\/v//')
+          echo "::set-env name=tag::${tag}"
+          echo "::set-env name=latest::$(node -p "Number(require('semver').gt('${tag}','$(cat gh-pages/VERSION)'))")"
+
+      - name: Update versions
+        if: env.tag != 'devel'
+        run: |
+          node -p 'var all=fs.readdirSync("gh-pages",{withFileTypes:true}).flatMap(f=>f.isDirectory()&&!isNaN(f.name.charAt(0))?[f.name]:[]).sort(require("semver").rcompare);JSON.stringify({all,stable:all.filter(s=>!s.includes("-"))})' > gh-pages/_data/versions.json
+
+      - name: Update VERSION
+        if: env.tag != 'devel' && env.latest == 1
+        run: |
+          echo $tag > gh-pages/VERSION
+
+      - name: Update CHANGELOG
+        if: env.latest == 1 # don't overwrite for backport versions
+        run: |
+          echo $'---\npermalink: /CHANGELOG\ntitle: "CHANGELOG"\n---\n' > gh-pages/CHANGELOG.md
+          cat CHANGELOG.md >> gh-pages/CHANGELOG.md
+
+      - name: Remove old docs
+        run: |
+          rm -rf gh-pages/${tag}
+
+      - name: Rebuild docs for tag
+        if: env.tag != 'devel'
+        run: |
+          yarn typedoc --includeVersion --out gh-pages/${tag}
 
-      - run: 'rm -rf tsdoc/*'
-      - run: yarn typedoc --disableOutputCheck
+      - name: Rebuild docs for devel
+        if: env.tag == 'devel'
+        run: |
+          yarn typedoc --out gh-pages/${tag}
 
       - name: Commit to gh-pages
         uses: EndBug/add-and-commit@v4
         with:
-          cwd: './tsdoc'
+          cwd: ./gh-pages
           ref: gh-pages
-          message: "Update docs via ${GIT_SHA}"
+          message: Update ${{ env.tag }} docs via ${{ github.sha }}
         env:
           GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}
-          GIT_SHA: ${{ github.sha }}

.gitignore

@@ -1,7 +1,8 @@
 node_modules/
-/lib
 /build
 /gh-pages
+/tsdoc
 /.vscode
+yarn-error.log
 yarn.lock
-package-lock.json
+package-lock.json