Merge branch 'main-dev'

Author: ashvardanian

.github/workflows/release.yml

@@ -56,13 +56,11 @@ jobs:
         uses: actions/checkout@v4
         with:
           fetch-depth: 0
-
       - name: Perform rebase
         run: |
           git fetch origin main
           git checkout main-dev
           git rebase origin/main
-
       - name: Push changes
         uses: CasperWA/push-protected@v2
         with:
@@ -350,12 +348,8 @@ jobs:
     strategy:
       fail-fast: false
       matrix:
-        arch:
-          - x64
-          - x86
-        os:
-          - macos-latest
-          - ubuntu-22.04
+        arch: [x64, x86]
+        os: [macos-latest, ubuntu-22.04]
         exclude:
           - arch: x86
             os: macos-latest
@@ -365,100 +359,104 @@ jobs:
     env:
       CC: gcc-12
       CXX: g++-12
-
     steps:
-      - name: Checkout the latest code
+      - name: Checkout Repository
         uses: actions/checkout@v4
         with:
           ref: "main"
-      - run: git submodule update --init --recursive
-
-      - name: Set up Node.js
+      - name: Update Git Submodules
+        run: git submodule update --init --recursive
+      - name: Set Up Node.js
         uses: actions/setup-node@v4
         with:
-          node-version: 20
+          node-version: "20"
           architecture: ${{ matrix.arch }}
-
-      - name: Update compilers
+      - name: Update System Compilers (Ubuntu Only)
         if: matrix.os == 'ubuntu-22.04'
         run: |
+          echo "Updating compilers and installing build dependencies on Ubuntu"
           sudo apt update
           sudo apt install -y cmake build-essential libjemalloc-dev libomp-dev gcc-12 g++-12
-          sudo apt install gcc-aarch64-linux-gnu binutils-aarch64-linux-gnu
-
-      - run: npm ci --ignore-scripts
-      - run: npm run prebuild-single
+          sudo apt install -y gcc-aarch64-linux-gnu binutils-aarch64-linux-gnu
+      - name: Install Node.js Dependencies
+        run: npm ci --ignore-scripts
+      - name: Prebuild Native Modules (Linux / Non-Darwin)
         if: matrix.os != 'macos-latest'
-      - run: npm run prebuild-darwin-x64+arm64
+        run: npm run prebuild-single
+      - name: Prebuild Native Modules for macOS
+        if: matrix.os == 'macos-latest'
         env:
           CC: clang
           CXX: clang++
+        run: npm run prebuild-darwin-x64+arm64
+      - name: Validate macOS Prebuild Artifacts
         if: matrix.os == 'macos-latest'
-      - run: file prebuilds/*/*
-        if: matrix.os == 'macos-latest'
-      - name: Extra for cross build
+        run: file prebuilds/*/*
+      - name: Cross-Build for ARM64 on Ubuntu
         if: matrix.os == 'ubuntu-22.04'
         run: npm run prebuild-arm64
-      - uses: actions/upload-artifact@v3
+      - name: Upload Prebuild Artifacts
+        uses: actions/upload-artifact@v4
         with:
           name: prebuilds
           path: prebuilds
           retention-days: 1
 
   publish_javascript:
-    name: Publish JavaScript
+    name: Publish JavaScript Package
     needs: build_javascript
     runs-on: ubuntu-22.04
-
     steps:
-      - uses: actions/checkout@v4
+      - name: Checkout Repository
+        uses: actions/checkout@v4
         with:
           ref: "main"
-      - run: git submodule update --init --recursive
-
-      - name: Set up Node.js
+      - name: Update Git Submodules
+        run: git submodule update --init --recursive
+      - name: Set Up Node.js Environment
         uses: actions/setup-node@v4
         with:
-          node-version: 20
-
-      - uses: actions/download-artifact@v3
-
-      - name: Look for links
+          node-version: "20"
+      - name: Download Prebuild Artifacts
+        uses: actions/download-artifact@v4
+        with:
+          name: prebuilds
+          path: prebuilds
+      - name: Verify File Hard Links (Optional)
         run: find . -type f -links +1
-
-      - name: Install dependencies
+      - name: Install Node.js Dependencies
         run: npm ci --ignore-scripts
-
-      - name: Build the JS from TS
+      - name: Build JavaScript from TypeScript
         run: npm run build-js
-
-      - name: Last minute test with prebuild artifact
+      - name: Run Final Tests with Prebuild Artifacts
         run: npm run test
-
-      - name: Publish Dry Run
-        run: npm publish --dry-run
+      - name: Dry Run Publish to NPM
         if: github.ref != 'refs/heads/main'
-
-      - name: Publish
-        uses: JS-DevTools/npm-publish@v3
+        run: npm publish --dry-run
+      - name: Publish to NPM
         if: github.ref == 'refs/heads/main'
+        uses: JS-DevTools/npm-publish@v3
         with:
           token: ${{ secrets.NPM_TOKEN }}
           access: public
 
   publish_rust:
-    name: Publish Rust
+    name: Publish Rust Crate
     needs: versioning
     runs-on: ubuntu-22.04
     steps:
-      - uses: actions/checkout@v4
+      - name: Checkout Repository
+        uses: actions/checkout@v4
         with:
           ref: "main"
-      - run: git submodule update --init --recursive
-      - uses: actions-rs/toolchain@v1
+      - name: Update Git Submodules
+        run: git submodule update --init --recursive
+      - name: Set Up Rust Toolchain
+        uses: actions-rs/toolchain@v1
         with:
           toolchain: stable
           override: true
-      - uses: katyo/publish-crates@v2
+      - name: Publish Rust Crate to Registry
+        uses: katyo/publish-crates@v2
         with:
           registry-token: ${{ secrets.CARGO_REGISTRY_TOKEN }}