Add semantic-release

Author: razor-x

.github/workflows/semantic-release.yml

@@ -0,0 +1,46 @@
+---
+name: Semantic Release
+
+run-name: Semantic Release from ${{ github.ref_name }}
+
+on:
+  push:
+    branches:
+      - '**'
+
+jobs:
+  semantic:
+    name: Determine version
+    runs-on: ubuntu-latest
+    timeout-minutes: 30
+    outputs:
+      new_release_published: ${{ steps.release.outputs.new_release_published }}
+      new_release_version: ${{ steps.release.outputs.new_release_version }}
+    steps:
+      - name: Checkout
+        uses: actions/checkout@v3
+        with:
+          fetch-depth: 0
+      - name: Semantic release
+        id: release
+        uses: cycjimmy/semantic-release-action@v3
+        with:
+          dry_run: true
+          semantic_version: '^19.0.0'
+  release:
+    name: Release version
+    runs-on: ubuntu-latest
+    timeout-minutes: 30
+    needs: semantic
+    if: ${{ needs.semantic.outputs.new_release_published == 'true' }}
+    steps:
+      - name: Checkout
+        uses: actions/checkout@v3
+        with:
+          fetch-depth: 1
+      - name: Release version ${{ steps.release.outputs.new_release_version }} on ${{ github.ref_name }}
+        run: gh workflow run version.yml --raw-field version=$VERSION --ref $BRANCH
+        env:
+          GITHUB_TOKEN: ${{ secrets.GH_TOKEN }}
+          VERSION: ${{ needs.semantic.outputs.new_release_version }}
+          BRANCH: ${{ github.ref_name }}

.releaserc.json

@@ -0,0 +1,14 @@
+{
+  "branches": [
+    "+([0-9])?(.{+([0-9]),x}).x",
+    "main",
+    "next",
+    "next-major",
+    { "name": "beta", "prerelease": true },
+    { "name": "alpha", "prerelease": true }
+  ],
+  "plugins": [
+    "@semantic-release/commit-analyzer",
+    { "preset": "conventionalcommits" }
+  ]
+}

README.md

@@ -20,12 +20,14 @@ Bootstrap a new TypeScript module in five minutes or less.
 - [Prettier] code.
 - Futuristic debuggable unit testing with [AVA].
 - Code coverage reporting with [Istanbul] and [c8].
+- Fully automated version management and package publishing with [semantic-release] and [Conventional Commits].
 - Continuous testing and package publishing with [GitHub Actions].
 - Consistent coding with [EditorConfig].
 - Get PR reviews directly from [code owners].
 
 [AVA]: https://github.com/avajs/ava
 [code owners]: https://github.blog/2017-07-06-introducing-code-owners/
+[Conventional Commits]: https://www.conventionalcommits.org/
 [ECMAScript module]: https://nodejs.org/api/esm.html
 [ESLint]: https://eslint.org/
 [EditorConfig]: https://editorconfig.org/
@@ -35,6 +37,7 @@ Bootstrap a new TypeScript module in five minutes or less.
 [JavaScript Standard Style]: https://standardjs.com/
 [Node.js]: https://nodejs.org/
 [Prettier]: https://prettier.io/
+[semantic-release]: https://semantic-release.gitbook.io/
 [TypeScript]: https://www.typescriptlang.org/
 [c8]: https://github.com/bcoe/c8
 [landlubber]: https://github.com/razor-x/landlubber
@@ -172,6 +175,16 @@ $ npm install
 
 ### Publishing
 
+#### Automatic
+
+New versions are released automatically with [semantic-release].
+as long as commits follow the [Conventional Commits] specification.
+
+[Conventional Commits]: https://www.conventionalcommits.org/
+[semantic-release]: https://semantic-release.gitbook.io/
+
+#### Manual
+
 Publish a new version by triggering a [version workflow_dispatch on GitHub Actions].
 The `version` input will be passed as the first argument to [npm-version].
 
@@ -203,6 +216,9 @@ The following repository secrets must be set on [GitHub Actions]:
 
 ## Contributing
 
+> If using squash merge, edit and ensure the commit message follows the [Conventional Commits] specification.
+> Otherwise, each individual commit must follow the [Conventional Commits] specification.
+
 1. Create your feature branch (`git checkout -b my-new-feature`).
 2. Make changes.
 3. Commit your changes (`git commit -am 'Add some feature'`).
@@ -213,6 +229,8 @@ The following repository secrets must be set on [GitHub Actions]:
 8. Wait for the required approval from the code owners.
 9. Merge when ready.
 
+[Conventional Commits]: https://www.conventionalcommits.org/
+
 ## License
 
 This npm package is Copyright (c) 2021-2023 Seam Labs, Inc.

makenew.sh

@@ -55,7 +55,7 @@ makenew () {
   read -p '> Short package description (Foos and bars.): ' mk_description
   read -p '> GitHub repository name (my-repo): ' mk_repo
 
-  sed_delete README.md '9,93d'
+  sed_delete README.md '9,96d'
   sed_insert README.md '9i' 'TODO'
 
   find_replace "s/^  \"version\": \".*\"/  \"version\": \"0.0.0\"/g"