Merge remote-tracking branch 'upstream/main' into cuda-graph-dev

Author: Nafees01

.clang-format

@@ -1,33 +1,37 @@
 BasedOnStyle: "Google"
 
-AlignAfterOpenBracket:        Align
-AlignArrayOfStructures:       Left
-AlignConsecutiveAssignments:  Consecutive
-AlignConsecutiveDeclarations: Consecutive
-AlignEscapedNewlines:         true
-AlignOperands:                Align
-AllowShortIfStatementsOnASingleLine: AllIfsAndElse
-ColumnLimit:                  150
-ReflowComments:               false
-CommentPragmas:               'TESTARGS'
-DerivePointerAlignment:       false
-IncludeBlocks:                Preserve
+
+AlignAfterOpenBracket:               true
+BreakAfterOpenBracketBracedList:     true
+BreakBeforeCloseBracketBracedList:   true
+AlignArrayOfStructures:              Left
+AlignConsecutiveAssignments:         Consecutive
+AlignConsecutiveDeclarations:        Consecutive
+AlignEscapedNewlines:                true
+AlignOperands:                       Align
+AllowShortIfStatementsOnASingleLine: WithoutElse
+ColumnLimit:                         150
+PenaltyBreakOpenParenthesis:         100
+ReflowComments:                      false
+CommentPragmas:                      'TESTARGS'
+DerivePointerAlignment:              false
+IncludeBlocks:                       Preserve
 IncludeCategories:
-  - Regex:                    '^<ceed/.*\.h>'
-    Priority:                 2
-  - Regex:                    '^<ceed.*\.h>'
-    Priority:                 1
-  - Regex:                    '^<.*/.*\.h>'
-    Priority:                 5
-  - Regex:                    '^<.*\.h>'
-    Priority:                 4
-  - Regex:                    '^<.*>'
-    Priority:                 3
-  - Regex:                    '^".*"'
-    Priority:                 6
-  - Regex:                    '.*'
-    Priority:                 7
+  - Regex:    '^<ceed/.*\.h>'
+    Priority: 2
+  - Regex:    '^<ceed.*\.h>'
+    Priority: 1
+  - Regex:    '^<.*/.*\.h>'
+    Priority: 5
+  - Regex:    '^<.*\.h>'
+    Priority: 4
+  - Regex:    '^<.*>'
+    Priority: 3
+  - Regex:    '^".*"'
+    Priority: 6
+  - Regex:    '.*'
+    Priority: 7
 PointerAlignment:             Right
-TabWidth:                     4
+IndentWidth:                  2
 UseTab:                       Never
 StatementMacros:              [CeedPragmaOptimizeOn, CeedPragmaOptimizeOff]

.clang-tidy-fix

@@ -0,0 +1,4 @@
+Checks: "-*,readability-inconsistent-declaration-parameter-name,readability-braces-around-statements"
+CheckOptions:
+  - key: readability-braces-around-statements.ShortStatementLines
+    value: '1'

.codecov.yml

@@ -2,8 +2,11 @@ codecov:
   branch: main
 
 fixes:
-  - "build/backends/::backends/"
+  - "build/interface/::interface/"
   - "build/gallery/::gallery/"
+  - "build/backends/::backends/"
+  - "build/t*/::tests/t*"
+  - "build/ex*/::examples/ceed/ex*"
 
 ignore:
   - "julia/LibCEED.jl/src/generated/*.jl"
@@ -37,6 +40,7 @@ flags:
   gallery:
     paths:
       - gallery/
+      - include/ceed/jit-source/gallery/
   backends:
     paths:
       - backends/

.github/pull_request_template.md

@@ -0,0 +1,12 @@
+Purpose:
+
+Describe the purpose of the PR here.
+
+Closes: #ISSUE_NUMBER
+
+LLM/GenAI Disclosure:
+
+Describe any LLM and GenAI usage here.
+
+By submitting this PR, the author certifies to its contents as described by the [Developer's Certificate of Origin](https://developercertificate.org/).
+Please follow the [Contributing Guidelines](https://github.com/CEED/libCEED/blob/main/CONTRIBUTING.md) for all PRs.

.github/workflows/c-fortan-test-ppc64le.yml

@@ -19,7 +19,7 @@ jobs:
 
     steps:
     - name: Environment setup
-      uses: actions/checkout@v4
+      uses: actions/checkout@v5
     - name: Hardware setup and test libCEED
       uses: uraimo/run-on-arch-action@v3
       env:

.github/workflows/c-fortran-test-arm64.yml

@@ -17,7 +17,7 @@ jobs:
 
     steps:
     - name: Environment setup
-      uses: actions/checkout@v4
+      uses: actions/checkout@v5
     - name: Build and test libCEED
       env:
         CC: ${{ matrix.compiler }}

.github/workflows/c-fortran-test-icc.yml

@@ -19,7 +19,7 @@ jobs:
     runs-on: ${{ matrix.os }}
 
     steps:
-      - uses: actions/checkout@v4
+      - uses: actions/checkout@v5
       - name: Install Intel compilers
         uses: rscohn2/setup-oneapi@v0
         with:

.github/workflows/c-fortran-test-linux-osx.yml

@@ -12,15 +12,40 @@ jobs:
       matrix:
         os: [ubuntu-24.04, macos-15]
         compiler: [gcc, clang]
+        include:
+          - os: macos-15
+            compiler: apple-clang
 
     runs-on: ${{ matrix.os }}
 
     steps:
     - name: Environment setup
-      uses: actions/checkout@v4
+      uses: actions/checkout@v5
+    - name: Set compiler
+      run: |
+        case "${{ matrix.compiler }}" in
+          gcc)
+            if [[ "${{ matrix.os }}" == macos-* ]]; then
+              echo "CC=gcc-15" >> $GITHUB_ENV
+            else
+              echo "CC=gcc" >> $GITHUB_ENV
+            fi
+            ;;
+          clang)
+            if [[ "${{ matrix.os }}" == macos-* ]]; then
+              echo "CC=$(brew --prefix llvm@18)/bin/clang" >> $GITHUB_ENV
+            else
+              echo "CC=clang" >> $GITHUB_ENV
+            fi
+            ;;
+          apple-clang)
+            echo "CC=clang" >> $GITHUB_ENV
+            ;;
+        esac
+    - name: Show compiler version
+      run: $CC --version | head -1
     - name: Build and test libCEED
       env:
-        CC: ${{ matrix.compiler }}
         FC: gfortran-14
       run: |
         make info

.github/workflows/c-fortran-test-style.yml

@@ -17,16 +17,16 @@ jobs:
 
     steps:
     - name: Environment setup
-      uses: actions/checkout@v4
+      uses: actions/checkout@v5
     - name: Install clang-format
       run: |
           wget -O- https://apt.llvm.org/llvm-snapshot.gpg.key | sudo apt-key add -
-          sudo add-apt-repository 'deb http://apt.llvm.org/noble/ llvm-toolchain-noble-19 main'
-          sudo apt update && sudo apt install clang-format-19
+          sudo add-apt-repository 'deb http://apt.llvm.org/noble/ llvm-toolchain-noble-22 main'
+          sudo apt update && sudo apt install clang-format-22
     - name: C style
       env:
         CC: ${{ matrix.compiler }}
         FC: gfortran
       run: |
         make info
-        make format-c -j CLANG_FORMAT=clang-format-19 && git diff --exit-code
+        make format-c -j CLANG_FORMAT=clang-format-22 && git diff --exit-code

.github/workflows/julia-documentation.yml

@@ -11,7 +11,7 @@ jobs:
   build:
     runs-on: ubuntu-24.04
     steps:
-      - uses: actions/checkout@v4
+      - uses: actions/checkout@v5
       - uses: julia-actions/setup-julia@latest
       - name: Install dependencies
         run: |