Merge remote-tracking branch 'upstream/develop' into random-math1

Author: stdlib-bot

.github/workflows/autoclose.yml

@@ -211,3 +211,44 @@ jobs:
             This pull request has been automatically closed because it has been inactive for an extended period after changes were requested. If you still wish to pursue this contribution, feel free to reopen the pull request or submit a new one.
 
             We appreciate your interest in contributing to stdlib!
+
+  # Define a job which closes a pull request if a PR has an inappropriate Git history:
+  git_history:
+
+    # Define job name:
+    name: 'Check for Git History label'
+
+    # Only run this job if the pull request has a specific label:
+    if: "${{ github.event.label.name == 'autoclose: Git History' }}"
+
+    # Define job permissions:
+    permissions:
+      contents: read
+      pull-requests: write
+
+    # Define the type of virtual host machine:
+    runs-on: ubuntu-latest
+
+    # Define the sequence of job steps:
+    steps:
+
+      # Close the pull request:
+      - name: 'Close pull request'
+        run: gh pr close "$NUMBER" --comment "$BODY"
+        env:
+          GH_TOKEN: ${{ secrets.STDLIB_BOT_PAT_REPO_WRITE }}
+          GH_REPO: ${{ github.repository }}
+          NUMBER: ${{ github.event.pull_request.number }}
+          BODY: |
+            Thank you for working on this pull request. However, we cannot accept your contribution due to Git history issues.
+
+            Some common issues include:
+
+            -   Merge conflicts
+            -   Inappropriate commit messages
+            -   Unrelated commits
+            -   Including changes from merged branches that weren't intended for this PR
+
+            We recommend opening a new pull request with only the intended changes.
+
+            Thank you for your interest in stdlib, and we look forward to your future contributions.

.github/workflows/check_commit_metadata.yml

@@ -43,8 +43,8 @@ jobs:
     # Define the type of virtual host machine:
     runs-on: ubuntu-latest
 
-    # Skip this job for PRs opened by automated bot accounts:
-    if: github.event.pull_request.user.login != 'stdlib-bot' && github.event.pull_request.user.login != 'dependabot[bot]'
+    # Temporarily disable the entire workflow:
+    if: false
 
     # Define the sequence of job steps...
     steps:
@@ -66,7 +66,8 @@ jobs:
       # Extract commit metadata from commit messages as JSON:
       - name: 'Extract commit metadata'
         id: extract-metadata
-        uses: stdlib-js/metadata-action@v2
+        # Pin action to full length commit SHA
+        uses: stdlib-js/metadata-action@3ccf68f24c51ae23470319e8e5619d539df8212b # v3.0.0
 
       # Check commit metadata:
       - name: 'Check commit metadata'

.github/workflows/too_many_good_first_prs.yml

@@ -69,5 +69,6 @@ jobs:
       - name: 'Prevent contributors from opening too many "Good First PR"s'
         env:
           PR_NUMBER: ${{ github.event.pull_request.number }}
+          GITHUB_TOKEN: ${{ secrets.STDLIB_BOT_PAT_REPO_WRITE }}
         run: |
           . "$GITHUB_WORKSPACE/.github/workflows/scripts/rate_limit_contributions" $PR_NUMBER

.mailmap

@@ -28,6 +28,8 @@ Ahmed Khaled <[email protected]> Khaldon
 Ahmed Kashkoush <[email protected]> <[email protected]>
 Ahmed Kashkoush <[email protected]> Ahmed_Kashkoush
 
+Aksshay Balasubramanian <[email protected]> Aksshay88
+
 Aman Bhansali <[email protected]> <[email protected]>
 Aman Bhansali <[email protected]> aman-095
 

CONTRIBUTORS

@@ -11,6 +11,7 @@ Aditya Sapra <[email protected]>
 Ahmed Atwa <[email protected]>
 Ahmed Kashkoush <[email protected]>
 Ahmed Khaled <[email protected]>
+Aksshay Balasubramanian <[email protected]>
 Aleksandr <[email protected]>
 Ali Salesi <[email protected]>
 Aman Bhansali <[email protected]>
@@ -47,6 +48,7 @@ HarshaNP <[email protected]>
 Harshita Kalani <[email protected]>
 Hridyanshu <[email protected]>
 Jaimin Godhani <[email protected]>
+Jalaj Kumar <[email protected]>
 James Gelok <[email protected]>
 Jaysukh Makvana <[email protected]>
 Jenish Thapa <[email protected]>
@@ -137,6 +139,7 @@ Yaswanth Kosuru <[email protected]>
 Yernar Yergaziyev <[email protected]>
 Yugal Kaushik <[email protected]>
 Yuvi Mittal <[email protected]>
+ditsu <[email protected]>
 ekambains <[email protected]>
 fadiothman22 <[email protected]>
 olenkabilonizhka <[email protected]>

lib/node_modules/@stdlib/_tools/eslint/rules/no-nested-require/examples/index.js

@@ -36,17 +36,17 @@ result = linter.verify( code, {
 });
 console.log( result );
 /* =>
-    [
-        {
-            'ruleId': 'no-nested-require',
-            'severity': 2,
-            'message': 'do not use nested property access for require() expressions',
-            'line': 2,
-            'column': 15,
-            'nodeType': 'CallExpression',
-            'source': 'var special = require( \'@stdlib/math\' ).base.special;',
-            'endLine': 2,
-            'endColumn': 29
-        }
-    ]
+	[
+		{
+			'ruleId': 'no-nested-require',
+			'severity': 2,
+			'message': 'do not use nested property access for require() expressions',
+			'line': 2,
+			'column': 15,
+			'nodeType': 'CallExpression',
+			'source': 'var special = require( \'@stdlib/math\' ).base.special;',
+			'endLine': 2,
+			'endColumn': 29
+		}
+	]
 */

lib/node_modules/@stdlib/_tools/github/user-details/lib/defaults.json

@@ -1,13 +1,13 @@
 {
-	"usernames": [],
-	"protocol": "https",
-	"hostname": "api.github.com",
-	"port": 443,
-	"pathname": "/",
-	"page": 1,
-	"last_page": 1,
-	"per_page": 1,
-	"method": "GET",
-	"useragent": "https://github.com/stdlib-js/stdlib/@stdlib/_tools/github/user-details",
-	"accept": "application/vnd.github.v3+json"
+  "usernames": [],
+  "protocol": "https",
+  "hostname": "api.github.com",
+  "port": 443,
+  "pathname": "/",
+  "page": 1,
+  "last_page": 1,
+  "per_page": 1,
+  "method": "GET",
+  "useragent": "https://github.com/stdlib-js/stdlib/@stdlib/_tools/github/user-details",
+  "accept": "application/vnd.github.v3+json"
 }

lib/node_modules/@stdlib/blas/base/wasm/zswap/README.md

@@ -36,31 +36,13 @@ Interchanges two complex double-precision floating-point vectors.
 
 ```javascript
 var Complex128Array = require( '@stdlib/array/complex128' );
-var real = require( '@stdlib/complex/float64/real' );
-var imag = require( '@stdlib/complex/float64/imag' );
 
 var x = new Complex128Array( [ 1.0, 2.0, 3.0, 4.0, 5.0, 6.0 ] );
 var y = new Complex128Array( [ 0.0, 0.0, 0.0, 0.0, 0.0, 0.0 ] );
 
 zswap.main( x.length, x, 1, y, 1 );
-
-var z = y.get( 0 );
-// returns <Complex128>
-
-var re = real( z );
-// returns 1.0
-
-var im = imag( z );
-// returns 2.0
-
-z = x.get( 0 );
-// returns <Complex128>
-
-re = real( z );
-// returns 0.0
-
-im = imag( z );
-// returns 0.0
+// x => <Complex128Array>[ 0.0, 0.0, 0.0, 0.0, 0.0, 0.0 ]
+// y => <Complex128Array>[ 1.0, 2.0, 3.0, 4.0, 5.0, 6.0 ]
 ```
 
 The function has the following parameters:
@@ -75,31 +57,13 @@ The `N` and stride parameters determine how values from `x` are interchanged wit
 
 ```javascript
 var Complex128Array = require( '@stdlib/array/complex128' );
-var real = require( '@stdlib/complex/float64/real' );
-var imag = require( '@stdlib/complex/float64/imag' );
 
 var x = new Complex128Array( [ 1.0, 2.0, 3.0, 4.0, 5.0, 6.0, 7.0, 8.0 ] );
 var y = new Complex128Array( [ 0.0, 0.0, 0.0, 0.0, 0.0, 0.0, 0.0, 0.0 ] );
 
 zswap.main( 2, x, -2, y, 1 );
-
-var z = y.get( 0 );
-// returns <Complex128>
-
-var re = real( z );
-// returns 5.0
-
-var im = imag( z );
-// returns 6.0
-
-z = x.get( 0 );
-// returns <Complex128>
-
-re = real( z );
-// returns 0.0
-
-im = imag( z );
-// returns 0.0
+// x => <Complex128Array>[ 0.0, 0.0, 3.0, 4.0, 0.0, 0.0, 7.0, 8.0 ]
+// y => <Complex128Array>[ 5.0, 6.0, 1.0, 2.0, 0.0, 0.0, 0.0, 0.0 ]
 ```
 
 Note that indexing is relative to the first index. To introduce an offset, use [`typed array`][mdn-typed-array] views.
@@ -108,8 +72,6 @@ Note that indexing is relative to the first index. To introduce an offset, use [
 
 ```javascript
 var Complex128Array = require( '@stdlib/array/complex128' );
-var real = require( '@stdlib/complex/float64/real' );
-var imag = require( '@stdlib/complex/float64/imag' );
 
 // Initial arrays...
 var x0 = new Complex128Array( [ 1.0, 2.0, 3.0, 4.0, 5.0, 6.0, 7.0, 8.0 ] );
@@ -121,24 +83,8 @@ var y1 = new Complex128Array( y0.buffer, y0.BYTES_PER_ELEMENT*2 ); // start at 3
 
 // Interchange every other value from `x1` into `y1` in reverse order...
 zswap.main( 2, x1, -2, y1, 1 );
-
-var z = y0.get( 2 );
-// returns <Complex128>
-
-var re = real( z );
-// returns 7.0
-
-var im = imag( z );
-// returns 8.0
-
-z = x0.get( 1 );
-// returns <Complex128>
-
-re = real( z );
-// returns 0.0
-
-im = imag( z );
-// returns 0.0
+// x0 => <Complex128Array>[ 1.0, 2.0, 0.0, 0.0, 5.0, 6.0, 0.0, 0.0 ]
+// y0 => <Complex128Array>[ 0.0, 0.0, 0.0, 0.0, 7.0, 8.0, 3.0, 4.0 ]
 ```
 
 #### zswap.ndarray( N, x, strideX, offsetX, y, strideY, offsetY )
@@ -147,31 +93,13 @@ Interchanges two complex double-precision floating-point vectors using alternati
 
 ```javascript
 var Complex128Array = require( '@stdlib/array/complex128' );
-var real = require( '@stdlib/complex/float64/real' );
-var imag = require( '@stdlib/complex/float64/imag' );
 
 var x = new Complex128Array( [ 1.0, 2.0, 3.0, 4.0, 5.0, 6.0 ] );
 var y = new Complex128Array( [ 0.0, 0.0, 0.0, 0.0, 0.0, 0.0 ] );
 
 zswap.ndarray( x.length, x, 1, 0, y, 1, 0 );
-
-var z = y.get( 0 );
-// returns <Complex128>
-
-var re = real( z );
-// returns 1.0
-
-var im = imag( z );
-// returns 2.0
-
-z = x.get( 0 );
-// returns <Complex128>
-
-re = real( z );
-// returns 0.0
-
-im = imag( z );
-// returns 0.0
+// x => <Complex128Array>[ 0.0, 0.0, 0.0, 0.0, 0.0, 0.0 ]
+// y => <Complex128Array>[ 1.0, 2.0, 3.0, 4.0, 5.0, 6.0 ]
 ```
 
 The function has the following additional parameters:
@@ -183,31 +111,13 @@ While [`typed array`][mdn-typed-array] views mandate a view offset based on the
 
 ```javascript
 var Complex128Array = require( '@stdlib/array/complex128' );
-var real = require( '@stdlib/complex/float64/real' );
-var imag = require( '@stdlib/complex/float64/imag' );
 
 var x = new Complex128Array( [ 1.0, 2.0, 3.0, 4.0, 5.0, 6.0, 7.0, 8.0 ] );
 var y = new Complex128Array( [ 0.0, 0.0, 0.0, 0.0, 0.0, 0.0, 0.0, 0.0 ] );
 
 zswap.ndarray( 2, x, 2, 1, y, -1, y.length-1 );
-
-var z = y.get( y.length-1 );
-// returns <Complex128>
-
-var re = real( z );
-// returns 3.0
-
-var im = imag( z );
-// returns 4.0
-
-z = x.get( x.length-1 );
-// returns <Complex128>
-
-re = real( z );
-// returns 0.0
-
-im = imag( z );
-// returns 0.0
+// x => <Complex128Array>[ 1.0, 2.0, 0.0, 0.0, 5.0, 6.0, 0.0, 0.0 ]
+// y => <Complex128Array>[ 0.0, 0.0, 0.0, 0.0, 7.0, 8.0, 3.0, 4.0 ]
 ```
 
 * * *