Merge branch 'master' into task/SAT-7028

Author: jharlow-intel

.git-blame-ignore-revs

@@ -20,3 +20,6 @@ e62718415aa3660da5f607e352c991a063a54219
 
 # Bump clang-format from 12.0.1 to 22.1.0 version
 c2d65bd451a7d8e5b6319147da95e9dabf7a382b
+
+# cython-lint cleanup
+6afda951b26d59aee7488f40c40968feb4725ad8

.github/workflows/build-sphinx.yml

@@ -11,10 +11,9 @@ permissions: read-all
 env:
   GH_BOT_NAME: 'github-actions[bot]'
   GH_BOT_EMAIL: 'github-actions[bot]@users.noreply.github.com'
-  GH_EVENT_OPEN_PR_UPSTREAM: ${{ github.event_name == 'pull_request' && github.event.action != 'closed' &&
-                                 github.event.pull_request && !github.event.pull_request.base.repo.fork }}
   GH_EVENT_PUSH_UPSTREAM: ${{ github.ref == 'refs/heads/master' && github.event_name == 'push' &&
                               github.event.ref == 'refs/heads/master' && github.event.repository && !github.event.repository.fork }}
+  GH_EVENT_PR_OPEN: ${{ github.event_name == 'pull_request' && github.event.action != 'closed' }}
   PUBLISH_DIR: doc/_build/html/
 
 defaults:
@@ -25,7 +24,7 @@ jobs:
   build-and-deploy:
     name: Build and Deploy Docs
 
-    runs-on: ubuntu-22.04
+    runs-on: ubuntu-latest
     timeout-minutes: 90
 
     permissions:
@@ -71,13 +70,6 @@ jobs:
           echo "deb [signed-by=/usr/share/keyrings/oneapi-archive-keyring.gpg] https://apt.repos.intel.com/oneapi all main" | sudo tee /etc/apt/sources.list.d/oneAPI.list
           sudo apt update
 
-      - name: Update libstdc++-dev
-        run: |
-          sudo apt remove -y gcc-7 g++-7 gcc-8 g++-8 gcc-10 g++-10
-          sudo apt remove -y libstdc++-10-dev
-          sudo apt autoremove
-          sudo apt install --reinstall -y gcc-9 g++-9 libstdc++-9-dev
-
       - name: Install Intel OneAPI
         if: env.oneapi-pkgs-env == ''
         run: |
@@ -98,7 +90,7 @@ jobs:
         run: |
           sudo add-apt-repository ppa:graphics-drivers/ppa
           sudo apt-get update
-          sudo apt-get install -y libnvidia-gl-450
+          sudo apt-get install -y libnvidia-gl-550
           sudo apt-get install -y nvidia-cuda-toolkit clinfo
 
       - name: Checkout repo
@@ -191,10 +183,30 @@ jobs:
       - name: Copy backend docs
         run: cp -r dpnp/backend/doc/html ${{ env.PUBLISH_DIR }}/backend_doc
 
+      # Detect if this is a fork PR
+      - name: Check if fork PR
+        id: check_fork
+        run: |
+          IS_FORK="false"
+          if [ "${{ github.event_name }}" == "pull_request" ] && [ "${{ github.event.pull_request.head.repo.fork }}" == "true" ]; then
+            IS_FORK="true"
+          fi
+          echo "is_fork=$IS_FORK" >> "$GITHUB_OUTPUT"
+          echo "Is fork PR: $IS_FORK"
+
+      # Upload artifact for fork PRs
+      - name: Upload docs artifact (Fork PRs)
+        if: env.GH_EVENT_PR_OPEN == 'true' && steps.check_fork.outputs.is_fork == 'true'
+        uses: actions/upload-artifact@043fb46d1a93c77aae656e7c1c64a875d1fc6a0a # v7.0.1
+        with:
+          name: pr-${{ github.event.number }}-docs
+          path: ${{ env.PUBLISH_DIR }}
+          retention-days: 30
+
       # The step is only used to build docs while pushing a PR to "master"
       - name: Deploy docs
         if: env.GH_EVENT_PUSH_UPSTREAM == 'true'
-        uses: peaceiris/actions-gh-pages@4f9cc6602d3f66b9c108549d475ec49e8ef4d45e # v4.0.0
+        uses: peaceiris/actions-gh-pages@84c30a85c19949d7eee79c4ff27748b70285e453 # v4.1.0
         with:
           github_token: ${{ secrets.GITHUB_TOKEN }}
           publish_dir: ${{ env.PUBLISH_DIR }}
@@ -206,8 +218,8 @@ jobs:
 
       # The step is only used to build docs while pushing to PR branch
       - name: Publish pull-request docs
-        if: env.GH_EVENT_OPEN_PR_UPSTREAM == 'true'
-        uses: peaceiris/actions-gh-pages@4f9cc6602d3f66b9c108549d475ec49e8ef4d45e # v4.0.0
+        if: env.GH_EVENT_PR_OPEN == 'true' && steps.check_fork.outputs.is_fork == 'false'
+        uses: peaceiris/actions-gh-pages@84c30a85c19949d7eee79c4ff27748b70285e453 # v4.1.0
         with:
           github_token: ${{ secrets.GITHUB_TOKEN }}
           publish_dir: ${{ env.PUBLISH_DIR }}
@@ -220,8 +232,10 @@ jobs:
           user_email: ${{ env.GH_BOT_EMAIL }}
 
       # The step is only used to build docs while pushing to PR branch
+      # Note: Fork PRs have read-only GITHUB_TOKEN and cannot post comments
+      # See: https://docs.github.com/en/actions/writing-workflows/choosing-when-your-workflow-runs/events-that-trigger-workflows#workflows-in-forked-repositories
       - name: Comment with URL to published pull-request docs
-        if: env.GH_EVENT_OPEN_PR_UPSTREAM == 'true'
+        if: env.GH_EVENT_PR_OPEN == 'true' && steps.check_fork.outputs.is_fork == 'false'
         env:
           PR_NUM: ${{ github.event.number }}
         uses: mshick/add-pr-comment@8e4927817251f1ff60c001f04568532b38e0b4a0 # v3.11.0.8.3.11.0
@@ -235,7 +249,7 @@ jobs:
   clean:
     if: |
       github.event_name == 'pull_request' && github.event.action == 'closed' &&
-      github.event.pull_request && !github.event.pull_request.base.repo.fork
+      github.event.pull_request.head.repo && !github.event.pull_request.head.repo.fork
 
     needs: build-and-deploy
 

.github/workflows/check-onemath.yaml

@@ -71,7 +71,7 @@ jobs:
       fail-fast: false
       matrix:
         python: ['3.13'] # no dpctl package on PyPI with enabled python 3.14 support
-        os: [ubuntu-22.04] # windows-2022 - no DFT support for Windows in oneMKL
+        os: [ubuntu-latest] # windows-2022 - no DFT support for Windows in oneMKL
 
     runs-on: ${{ matrix.os }}
     timeout-minutes: 120
@@ -188,7 +188,7 @@ jobs:
       fail-fast: false
       matrix:
         python: ['3.13'] # no dpctl package on PyPI with enabled python 3.14 support
-        os: [ubuntu-22.04] # windows-2022 - no DFT support for Windows in oneMKL
+        os: [ubuntu-latest] # windows-2022 - no DFT support for Windows in oneMKL
 
     runs-on: ${{ matrix.os }}
     timeout-minutes: 60

.github/workflows/conda-package.yml

@@ -457,7 +457,7 @@ jobs:
       fail-fast: false
       matrix:
         python: ['3.10', '3.11', '3.12', '3.13', '3.14']
-        os: [ubuntu-22.04, windows-2022]
+        os: [ubuntu-latest, windows-2022]
 
     runs-on: ${{ matrix.os }}
     timeout-minutes: 10
@@ -537,11 +537,7 @@ jobs:
       # Needed to add a comment to a pull request's issue
       pull-requests: write
 
-    strategy:
-      matrix:
-        os: [ubuntu-22.04]
-
-    runs-on:  ${{ matrix.os }}
+    runs-on:  ubuntu-latest
     timeout-minutes: 15
 
     defaults:
@@ -707,7 +703,7 @@ jobs:
 
     needs: [upload]
 
-    runs-on: 'ubuntu-latest'
+    runs-on: ubuntu-latest
     timeout-minutes: 10
 
     defaults:

.github/workflows/cron-run-tests.yaml

@@ -81,6 +81,9 @@ jobs:
           python-version: ${{ matrix.python }}
           activate-environment: ${{ env.test-env-name }}
 
+      - name: Install OCL CPU RT from Intel channel
+        run: mamba install intel-opencl-rt=*=intel_* ${{ env.channels-list }}
+
       - name: Install dpnp
         id: install_dpnp
         continue-on-error: true
@@ -92,9 +95,6 @@ jobs:
         run: |
           mamba install ${{ env.package-name }}=${{ steps.find_latest_tag.outputs.tag }} ${{ env.test-packages }} ${{ env.channels-list }}
 
-      - name: Install OCL CPU RT from Intel channel
-        run: mamba install intel-opencl-rt=*=intel_* ${{ env.channels-list }}
-
       - name: List installed packages
         run: mamba list
 

.github/workflows/generate_coverage.yaml

@@ -46,16 +46,18 @@ jobs:
           echo "deb [signed-by=/usr/share/keyrings/oneapi-archive-keyring.gpg] https://apt.repos.intel.com/oneapi all main" | sudo tee /etc/apt/sources.list.d/oneAPI.list
           sudo apt update
 
-      - name: Install latest Intel OneAPI
+      # Pinned to OneAPI 2025.3 due to known 2026.0 DPC++ compiler issue with Segfault during the sycl-post-link
+      # TODO: renmove once CMPLRLLVM-75178 is resolved and released
+      - name: Install Intel OneAPI
         if: env.oneapi-pkgs-env == ''
         run: |
-          sudo apt install hwloc                           \
-                           intel-oneapi-mkl                \
-                           intel-oneapi-umf                \
-                           intel-oneapi-mkl-devel          \
-                           intel-oneapi-tbb-devel          \
-                           intel-oneapi-libdpstd-devel     \
-                           intel-oneapi-compiler-dpcpp-cpp
+          sudo apt install hwloc                                   \
+                           intel-oneapi-mkl-2025.3                 \
+                           intel-oneapi-umf-1.0                    \
+                           intel-oneapi-mkl-devel-2025.3           \
+                           intel-oneapi-tbb-devel-2022.3           \
+                           intel-oneapi-libdpstd-devel-2022.10     \
+                           intel-oneapi-compiler-dpcpp-cpp-2025.3
 
       - name: Checkout repo
         uses: actions/checkout@de0fac2e4500dabe0009e67214ff5f5447ce83dd # v6.0.2
@@ -107,10 +109,14 @@ jobs:
       # with a newer version of the DPC++ compiler).
       # Installing dpctl via the pip manager has no such limitation, as the package has no
       # run dependency on the DPC++ RT pip package, so this is why the step is necessary here.
+      # - name: Install dpctl
+      #   if: env.oneapi-pkgs-env == ''
+      #   run: |
+      #     pip install -r ${{ env.dpctl-pkg-txt }}
+      # TODO: renmove pinning once CMPLRLLVM-75178 is resolved and released
       - name: Install dpctl
-        if: env.oneapi-pkgs-env == ''
         run: |
-          pip install -r ${{ env.dpctl-pkg-txt }}
+          pip install dpctl>=0.23.0dev0 --index-url https://pypi.anaconda.org/dppy/label/coverage/simple
 
       - name: Conda info
         run: |

.github/workflows/openssf-scorecard.yml

@@ -72,6 +72,6 @@ jobs:
 
       # Upload the results to GitHub's code scanning dashboard.
       - name: "Upload to code-scanning"
-        uses: github/codeql-action/upload-sarif@e46ed2cbd01164d986452f91f178727624ae40d7 # v4.35.3
+        uses: github/codeql-action/upload-sarif@7211b7c8077ea37d8641b6271f6a365a22a5fbfa # v4.36.0
         with:
           sarif_file: results.sarif

.github/workflows/pre-commit.yml

@@ -11,7 +11,7 @@ jobs:
   pre-commit:
     name: Check
 
-    runs-on: ubuntu-22.04
+    runs-on: ubuntu-latest
     timeout-minutes: 10
 
     steps:

.pre-commit-config.yaml

@@ -64,7 +64,7 @@ repos:
         additional_dependencies:
             - tomli
 -   repo: https://github.com/psf/black
-    rev: 26.3.1
+    rev: 26.5.1
     hooks:
     -   id: black
         exclude: "dpnp/_version.py"
@@ -89,7 +89,7 @@ repos:
             - flake8-docstrings==1.7.0
             - flake8-bugbear==24.12.12
 -   repo: https://github.com/pre-commit/mirrors-clang-format
-    rev: v22.1.4
+    rev: v22.1.5
     hooks:
     -   id: clang-format
         args: ["-i"]
@@ -128,8 +128,13 @@ repos:
     hooks:
     -   id: actionlint
 -   repo: https://github.com/BlankSpruce/gersemi-pre-commit
-    rev: 0.27.2
+    rev: 0.27.6
     hooks:
     -   id: gersemi
         exclude: "dpnp/backend/cmake/Modules/"
         args: ["-i", "-l", "88", "--no-warn-about-unknown-commands"]
+-   repo: https://github.com/MarcoGorelli/cython-lint
+    rev: v0.19.0
+    hooks:
+    -   id: cython-lint
+    -   id: double-quote-cython-strings

CHANGELOG.md

@@ -4,13 +4,22 @@ All notable changes to this project will be documented in this file.
 The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.1.0/),
 and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
 
-## [0.21.0] - MM/DD/2026
+## [0.21.0] - 2026-MM-DD
+
+This release is compatible with NumPy 2.4.5.
 
 ### Added
 * Added `dpnp.broadcast` class implementation [#2901](https://github.com/IntelPython/dpnp/pull/2901)
 
+* Added C API functions for `dpnp.tensor.usm_ndarray` setters and getters to avoid ABI breakage if `dpnp.tensor.usm_ndarray` is modified [gh-2866](https://github.com/IntelPython/dpnp/pull/2866)
+* Added support for buffer protocol objects as advanced index keys in `dpnp.ndarray` [#2889](https://github.com/IntelPython/dpnp/pull/2889)
+
 ### Changed
 
+* Changed `dpnp.meshgrid` and `dpnp.tensor.meshgrid` to return a tuple instead of a list, aligning with NumPy 2.5+ behavior and 2025.12 version of the Python array API standard [#2854](https://github.com/IntelPython/dpnp/pull/2854)
+* Updated `searchsorted` implementations to align with the 2025.12 array API spec [gh-2902](https://github.com/IntelPython/dpnp/pull/2902)
+* Updated tests to align with NumPy 2.4.5 compatibility [gh-2920](https://github.com/IntelPython/dpnp/pull/2920)
+
 ### Deprecated
 
 ### Removed
@@ -19,6 +28,11 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 
 * Fixed incorrect in-place advanced indexing for 4D arrays when using `range` or `list` as index keys [#2872](https://github.com/IntelPython/dpnp/pull/2872)
 * Fixed `conda build` command syntax in GitHub workflows and documentation to use `conda-build` [#2888](https://github.com/IntelPython/dpnp/pull/2888)
+* Fixed incorrect `dpnp.tensor.acosh` result for `complex(±0, NaN)` special case to match the Python Array API specification [#2914](https://github.com/IntelPython/dpnp/pull/2914)
+* Fixed fork PR documentation workflow failures by implementing conditional publishing strategy: upstream PRs publish to GitHub Pages with comment, fork PRs upload artifacts [#2910](https://github.com/IntelPython/dpnp/pull/2910)
+* Fixed missing `libtensor` headers in the installed `dpnp` package [#2915](https://github.com/IntelPython/dpnp/pull/2915)
+* Fixed boolean mask indexing to raise `IndexError` when mask dimensions don't match the indexed array dimensions, aligning with NumPy behavior. Previously, incompatible boolean masks silently returned incorrect results instead of raising an error [#2929](https://github.com/IntelPython/dpnp/pull/2929)
+* Fixed a bug in `astype` where casting floating point types to unsigned integral types could cause an intermediate signed integral type to overflow, leading to incorrect results [#2930](https://github.com/IntelPython/dpnp/pull/2930)
 
 ### Security