Updated API & dependencies

.github/actions/setup-node-deps/action.yml

@@ -0,0 +1,40 @@
+name: Setup Node and dependencies
+description: Setup Node.js runtime, restore Yarn cache, and install dependencies.
+
+inputs:
+  node-version:
+    description: Node.js version
+    required: false
+    default: 24.x
+  registry-url:
+    description: Optional npm registry URL for setup-node
+    required: false
+    default: ''
+  install-args:
+    description: Extra arguments passed to yarn install
+    required: false
+    default: --immutable
+
+runs:
+  using: composite
+  steps:
+    - name: Setup Node.js
+      if: ${{ inputs.registry-url == '' }}
+      uses: actions/setup-node@v4
+      with:
+        node-version: ${{ inputs.node-version }}
+        cache: yarn
+        cache-dependency-path: yarn.lock
+
+    - name: Setup Node.js with registry
+      if: ${{ inputs.registry-url != '' }}
+      uses: actions/setup-node@v4
+      with:
+        node-version: ${{ inputs.node-version }}
+        registry-url: ${{ inputs.registry-url }}
+        cache: yarn
+        cache-dependency-path: yarn.lock
+
+    - name: Install dependencies
+      shell: bash
+      run: yarn install ${{ inputs.install-args }}

.github/workflows/release.yml

@@ -0,0 +1,116 @@
+name: Release
+
+on:
+  workflow_dispatch:
+    inputs:
+      release:
+        description: "Release type"
+        required: true
+        default: "auto"
+        type: choice
+        options:
+          - auto
+          - patch
+          - minor
+          - major
+      prerelease:
+        description: "Prerelease channel"
+        required: true
+        default: "none"
+        type: choice
+        options:
+          - none
+          - alpha
+          - beta
+          - rc
+      npm_tag:
+        description: "npm dist-tag for publication"
+        required: true
+        default: "latest"
+        type: string
+
+permissions:
+  contents: write
+
+concurrency:
+  group: release-${{ github.ref }}
+  cancel-in-progress: false
+
+jobs:
+  release:
+    runs-on: ubuntu-22.04
+
+    steps:
+      - name: Checkout
+        uses: actions/checkout@v4
+        with:
+          fetch-depth: 0
+
+      - name: Validate release branch and npm tag
+        env:
+          NPM_TAG: ${{ inputs.npm_tag }}
+        run: |
+          if [ "$NPM_TAG" = "latest" ] && [ "$GITHUB_REF" != "refs/heads/main" ]; then
+            echo "Release to npm tag 'latest' must be started from the main branch."
+            exit 1
+          fi
+
+      - name: Setup Node.js and dependencies
+        uses: ./.github/actions/setup-node-deps
+        with:
+          node-version: 24.x
+          registry-url: https://registry.npmjs.org
+
+      - name: Configure git user
+        run: |
+          git config user.name "github-actions[bot]"
+          git config user.email "41898282+github-actions[bot]@users.noreply.github.com"
+
+      - name: Run release checks
+        run: |
+          yarn lint
+          yarn typecheck
+          yarn test
+
+      - name: Run release script
+        env:
+          RELEASE_TYPE: ${{ inputs.release }}
+          PRERELEASE: ${{ inputs.prerelease }}
+        run: |
+          case "$RELEASE_TYPE" in
+            auto)
+              RELEASE_SCRIPT="release"
+              ;;
+            patch)
+              RELEASE_SCRIPT="release:patch"
+              ;;
+            minor)
+              RELEASE_SCRIPT="release:minor"
+              ;;
+            major)
+              RELEASE_SCRIPT="release:major"
+              ;;
+            *)
+              echo "Unknown release type: $RELEASE_TYPE"
+              exit 1
+              ;;
+          esac
+
+          CMD=(yarn run "$RELEASE_SCRIPT")
+          if [ "$PRERELEASE" != "none" ]; then
+            CMD+=(--prerelease "$PRERELEASE")
+          fi
+
+          "${CMD[@]}"
+
+      - name: Build package
+        run: yarn build
+
+      - name: Push release commit and tags
+        run: git push origin "HEAD:${GITHUB_REF_NAME}" --follow-tags
+
+      - name: Publish to npm
+        env:
+          NODE_AUTH_TOKEN: ${{ secrets.NPM_TOKEN }}
+          NPM_TAG: ${{ inputs.npm_tag }}
+        run: npm publish --access public --tag "$NPM_TAG"

.github/workflows/tests.yml

@@ -6,83 +6,77 @@ on:
   pull_request:
     branches: [ "main" ]
 
+concurrency:
+  group: ${{ github.workflow }}-${{ github.ref }}
+  cancel-in-progress: true
+
 jobs:
+  actionlint:
+    runs-on: ubuntu-22.04
+
+    steps:
+      - name: Using branch ${{ github.ref }} for repository ${{ github.repository }}.
+        uses: actions/checkout@v4
+
+      - name: Run actionlint
+        run: make actionlint
+
   eslint:
-    runs-on: ubuntu-latest
+    runs-on: ubuntu-22.04
 
     strategy:
       matrix:
-        node-version: [ 18.x, 20.x ]
+        node-version: [ 22.x, 24.x ]
 
     steps:
-    - name: Using branch ${{ github.ref }} for repository ${{ github.repository }}.
-      uses: actions/checkout@v4
-
-    - name: Use Node.js ${{ matrix.node-version }}
-      uses: actions/setup-node@v4
-      with:
-        node-version: ${{ matrix.node-version }}
-
-    - name: Cache dependencies
-      id: cache-deps
-      uses: actions/cache@v4
-      with:
-        path: .yarn
-        key: ${{ runner.OS }}-node-${{ matrix.node-version }}-yarn-${{ hashFiles('**/yarn.lock') }}
-        restore-keys: |
-          ${{ runner.OS }}-node-${{ matrix.node-version }}-yarn-
-
-    - name: Install dependencies
-      run: |
-        yarn install
-
-    - name: Run lint
-      run: |
-        yarn lint
+      - name: Using branch ${{ github.ref }} for repository ${{ github.repository }}.
+        uses: actions/checkout@v4
+
+      - name: Setup Node.js and dependencies
+        uses: ./.github/actions/setup-node-deps
+        with:
+          node-version: ${{ matrix.node-version }}
+
+      - name: Run lint
+        run: yarn lint
 
   tests:
-    needs: eslint
+    needs: [ actionlint, eslint ]
 
-    runs-on: ubuntu-latest
+    runs-on: ubuntu-22.04
 
     strategy:
       matrix:
-        node-version: [18.x, 20.x]
+        node-version: [22.x, 24.x]
 
     steps:
-    - name: Using branch ${{ github.ref }} for repository ${{ github.repository }}.
-      uses: actions/checkout@v4
-
-    - name: Use Node.js ${{ matrix.node-version }}
-      uses: actions/setup-node@v4
-      with:
-        node-version: ${{ matrix.node-version }}
-
-    - name: Cache dependencies
-      id: cache-deps
-      uses: actions/cache@v4
-      with:
-        path: .yarn
-        key: ${{ runner.OS }}-node-${{ matrix.node-version }}-yarn-${{ hashFiles('**/yarn.lock') }}
-        restore-keys: |
-          ${{ runner.OS }}-node-${{ matrix.node-version }}-yarn-
-
-    - name: Install dependencies
-      run: |
-        yarn install
-
-    - name: Run tests
-      run: |
-        yarn test:coverage
-
-    - name: Upload coverage to GitHub Artifacts
-      uses: actions/upload-artifact@v4
-      with:
-        name: coverage-${{ matrix.node-version }}
-        path: coverage/
-
-    - name: Upload coverage reports to Codecov
-      uses: codecov/codecov-action@v4
-      with:
-        token: ${{ secrets.CODECOV_TOKEN }}
-        file: ./coverage/lcov.info
+      - name: Using branch ${{ github.ref }} for repository ${{ github.repository }}.
+        uses: actions/checkout@v4
+
+      - name: Setup Node.js and dependencies
+        uses: ./.github/actions/setup-node-deps
+        with:
+          node-version: ${{ matrix.node-version }}
+
+      - name: Run tests
+        run: yarn test:coverage
+
+      - name: Run type tests
+        run: yarn test:d
+
+      - name: Upload coverage to GitHub Artifacts
+        uses: actions/upload-artifact@v4
+        with:
+          name: coverage-${{ matrix.node-version }}
+          path: coverage/
+          retention-days: 30
+
+      - name: Upload coverage reports to Codecov
+        if: matrix.node-version == '24.x'
+        uses: codecov/codecov-action@v5
+        with:
+          token: ${{ secrets.CODECOV_TOKEN }}
+          files: ./coverage/lcov.info
+          disable_search: true
+          fail_ci_if_error: true
+          verbose: true

.gitignore

@@ -4,5 +4,9 @@ coverage/
 dist/
 node_modules/
 reports/
+.yarn/cache/
+.yarn/unplugged/
+.yarn/build-state.yml
+.yarn/install-state.gz
 
-.npmrc
+.npmrc