Merge branch 'develop' of https://github.com/stdlib-js/stdlib into develop

kgryte · kgryte · commit 9249b9aa4664 · 2025-05-07T02:55:15.000-07:00
diff --git a/lib/node_modules/@stdlib/math/base/special/acos/package.json b/lib/node_modules/@stdlib/math/base/special/acos/package.json
@@ -122,7 +122,7 @@
           ]
         }
       ],
-      "output_policy": "same",
+      "output_policy": "real_floating_point_and_generic",
       "returns": {
         "desc": "arccosine (in radians)",
         "type": {
diff --git a/lib/node_modules/@stdlib/math/base/special/acosd/package.json b/lib/node_modules/@stdlib/math/base/special/acosd/package.json
@@ -119,7 +119,7 @@
           ]
         }
       ],
-      "output_policy": "same",
+      "output_policy": "real_floating_point_and_generic",
       "returns": {
         "desc": "arccosine (in degrees)",
         "type": {
diff --git a/lib/node_modules/@stdlib/math/base/special/acosdf/package.json b/lib/node_modules/@stdlib/math/base/special/acosdf/package.json
@@ -119,7 +119,7 @@
           ]
         }
       ],
-      "output_policy": "same",
+      "output_policy": "real_floating_point_and_generic",
       "returns": {
         "desc": "arccosine (in degrees)",
         "type": {
diff --git a/lib/node_modules/@stdlib/math/base/special/acosf/package.json b/lib/node_modules/@stdlib/math/base/special/acosf/package.json
@@ -122,7 +122,7 @@
           ]
         }
       ],
-      "output_policy": "same",
+      "output_policy": "real_floating_point_and_generic",
       "returns": {
         "desc": "arccosine (in radians)",
         "type": {
diff --git a/lib/node_modules/@stdlib/math/base/special/acosh/package.json b/lib/node_modules/@stdlib/math/base/special/acosh/package.json
@@ -126,7 +126,7 @@
           ]
         }
       ],
-      "output_policy": "same",
+      "output_policy": "real_floating_point_and_generic",
       "returns": {
         "desc": "hyperbolic arccosine",
         "type": {
diff --git a/lib/node_modules/@stdlib/math/base/special/acot/package.json b/lib/node_modules/@stdlib/math/base/special/acot/package.json
@@ -123,7 +123,7 @@
           ]
         }
       ],
-      "output_policy": "same",
+      "output_policy": "real_floating_point_and_generic",
       "returns": {
         "desc": "inverse cotangent (in radians)",
         "type": {
diff --git a/lib/node_modules/@stdlib/math/base/special/acotd/package.json b/lib/node_modules/@stdlib/math/base/special/acotd/package.json
@@ -121,7 +121,7 @@
           ]
         }
       ],
-      "output_policy": "same",
+      "output_policy": "real_floating_point_and_generic",
       "returns": {
         "desc": "inverse cotangent (in degrees)",
         "type": {
diff --git a/lib/node_modules/@stdlib/math/base/special/acotdf/package.json b/lib/node_modules/@stdlib/math/base/special/acotdf/package.json
@@ -121,7 +121,7 @@
           ]
         }
       ],
-      "output_policy": "same",
+      "output_policy": "real_floating_point_and_generic",
       "returns": {
         "desc": "inverse cotangent (in degrees)",
         "type": {
diff --git a/lib/node_modules/@stdlib/math/base/special/acotf/package.json b/lib/node_modules/@stdlib/math/base/special/acotf/package.json
@@ -120,7 +120,7 @@
           ]
         }
       ],
-      "output_policy": "same",
+      "output_policy": "real_floating_point_and_generic",
       "returns": {
         "desc": "inverse cotangent (in radians)",
         "type": {
diff --git a/lib/node_modules/@stdlib/math/base/special/acovercos/README.md b/lib/node_modules/@stdlib/math/base/special/acovercos/README.md
@@ -131,8 +131,8 @@ logEachMap( 'acovercos(%0.4f) = %0.4f', x, acovercos );
 Computes the [inverse coversed cosine][inverse-coversed-cosine] of a double-precision floating-point number.
 
 ```c
-double out = stdlib_base_acovercos( -3.141592653589793/2.0 );
-// returns ~-0.6075
+double out = stdlib_base_acovercos( 3.141592653589793/2.0 );
+// returns ~0.6075
 ```
 
 The function accepts the following arguments:
diff --git a/lib/node_modules/@stdlib/math/iter/special/acovercos/README.md b/lib/node_modules/@stdlib/math/iter/special/acovercos/README.md
@@ -47,18 +47,18 @@ Returns an [iterator][mdn-iterator-protocol] which iteratively computes the [inv
 ```javascript
 var array2iterator = require( '@stdlib/array/to-iterator' );
 
-var x = [ 0.0, -3.141592653589793/2.0, -3.141592653589793/6.0 ];
+var x = [ 0.0, 3.141592653589793/2.0, 3.141592653589793/6.0 ];
 var it = iterAcovercos( array2iterator( x ) );
 // returns <Object>
 
 var r = it.next().value;
-// returns ~1.5708
+// returns ~-1.5708
 
 r = it.next().value;
-// returns ~-0.6075
+// returns ~0.6075
 
 r = it.next().value;
-// returns ~0.4966
+// returns ~-0.4966
 
 // ...
 ```
@@ -78,7 +78,7 @@ The returned [iterator][mdn-iterator-protocol] protocol-compliant object has the
 
 ## Notes
 
--   The domain of inverse coversed cosine is restricted to `[-2,0]`. If an iterated value is outside of the domain, the returned [iterator][mdn-iterator-protocol] returns `NaN`.
+-   The domain of inverse coversed cosine is restricted to `[0,2]`. If an iterated value is outside of the domain, the returned [iterator][mdn-iterator-protocol] returns `NaN`.
 -   If an iterated value is non-numeric (including `NaN`), the returned [iterator][mdn-iterator-protocol] returns `NaN`. If non-numeric iterated values are possible, you are advised to provide an [`iterator`][mdn-iterator-protocol] which type checks and handles non-numeric values accordingly.
 -   If an environment supports `Symbol.iterator` **and** a provided [iterator][mdn-iterator-protocol] is iterable, the returned [iterator][mdn-iterator-protocol] is iterable.
 
@@ -99,7 +99,7 @@ var uniform = require( '@stdlib/random/iter/uniform' );
 var iterAcovercos = require( '@stdlib/math/iter/special/acovercos' );
 
 // Create a seeded iterator for generating pseudorandom numbers:
-var rand = uniform( -2.0, 0.0, {
+var rand = uniform( 0.0, 2.0, {
     'seed': 1234,
     'iter': 10
 });
diff --git a/lib/node_modules/@stdlib/math/iter/special/acovercos/benchmark/benchmark.js b/lib/node_modules/@stdlib/math/iter/special/acovercos/benchmark/benchmark.js
@@ -35,7 +35,7 @@ bench( pkg, function benchmark( b ) {
 	var iter;
 	var i;
 
-	rand = uniform( -2.0, 0.0 );
+	rand = uniform( 0.0, 2.0 );
 
 	b.tic();
 	for ( i = 0; i < b.iterations; i++ ) {
@@ -58,7 +58,7 @@ bench( pkg+'::iteration', function benchmark( b ) {
 	var z;
 	var i;
 
-	rand = uniform( -2.0, 0.0 );
+	rand = uniform( 0.0, 2.0 );
 	iter = iterAcovercos( rand );
 
 	b.tic();
diff --git a/lib/node_modules/@stdlib/math/iter/special/acovercos/docs/repl.txt b/lib/node_modules/@stdlib/math/iter/special/acovercos/docs/repl.txt
@@ -2,7 +2,7 @@
 {{alias}}( iterator )
     Returns an iterator which iteratively computes the inverse coversed cosine.
 
-    The domain of inverse coversed cosine is restricted to [-2,0]. If an
+    The domain of inverse coversed cosine is restricted to [0,2]. If an
     iterated value is outside of the domain, the returned iterator returns
     `NaN`.
 
@@ -29,7 +29,7 @@
 
     Examples
     --------
-    > var it = {{alias}}( {{alias:@stdlib/random/iter/uniform}}( -2.0, 0.0 ) );
+    > var it = {{alias}}( {{alias:@stdlib/random/iter/uniform}}( 0.0, 2.0 ) );
     > var r = it.next().value
     <number>
     > r = it.next().value
diff --git a/lib/node_modules/@stdlib/math/iter/special/acovercos/docs/types/index.d.ts b/lib/node_modules/@stdlib/math/iter/special/acovercos/docs/types/index.d.ts
@@ -30,7 +30,7 @@ type Iterator = Iter | IterableIterator;
 *
 * ## Notes
 *
-* -   The domain of inverse coversed cosine is restricted to `[-2,0]`. If an iterated value is outside of the domain, the returned iterator returns `NaN`.
+* -   The domain of inverse coversed cosine is restricted to `[0,2]`. If an iterated value is outside of the domain, the returned iterator returns `NaN`.
 * -   If an environment supports `Symbol.iterator` **and** a provided iterator is iterable, the returned iterator is iterable.
 *
 * @param iterator - input iterator
@@ -39,7 +39,7 @@ type Iterator = Iter | IterableIterator;
 * @example
 * var uniform = require( '@stdlib/random/iter/uniform' );
 *
-* var iter = iterAcovercos( uniform( -2.0, 0.0 ) );
+* var iter = iterAcovercos( uniform( 0.0, 2.0 ) );
 *
 * var r = iter.next().value;
 * // returns <number>
diff --git a/lib/node_modules/@stdlib/math/iter/special/acovercos/examples/index.js b/lib/node_modules/@stdlib/math/iter/special/acovercos/examples/index.js
@@ -22,7 +22,7 @@ var uniform = require( '@stdlib/random/iter/uniform' );
 var iterAcovercos = require( './../lib' );
 
 // Create a seeded iterator for generating pseudorandom numbers:
-var rand = uniform( -2.0, 0.0, {
+var rand = uniform( 0.0, 2.0, {
 	'seed': 1234,
 	'iter': 10
 });
diff --git a/lib/node_modules/@stdlib/math/iter/special/acovercos/lib/index.js b/lib/node_modules/@stdlib/math/iter/special/acovercos/lib/index.js
@@ -27,7 +27,7 @@
 * var uniform = require( '@stdlib/random/iter/uniform' );
 * var iterAcovercos = require( '@stdlib/math/iter/special/acovercos' );
 *
-* var iter = iterAcovercos( uniform( -2.0, 0.0 ) );
+* var iter = iterAcovercos( uniform( 0.0, 2.0 ) );
 *
 * var r = iter.next().value;
 * // returns <number>
diff --git a/lib/node_modules/@stdlib/math/iter/special/acovercos/lib/main.js b/lib/node_modules/@stdlib/math/iter/special/acovercos/lib/main.js
@@ -31,7 +31,7 @@ var acovercos = require( '@stdlib/math/base/special/acovercos' );
 *
 * ## Notes
 *
-* -   The domain of inverse coversed cosine is restricted to `[-2,0]`. If an iterated value is outside of the domain, the returned iterator returns `NaN`.
+* -   The domain of inverse coversed cosine is restricted to `[0,2]`. If an iterated value is outside of the domain, the returned iterator returns `NaN`.
 * -   If an environment supports `Symbol.iterator` **and** a provided iterator is iterable, the returned iterator is iterable.
 *
 * @param {Iterator} iterator - input iterator
@@ -41,7 +41,7 @@ var acovercos = require( '@stdlib/math/base/special/acovercos' );
 * @example
 * var uniform = require( '@stdlib/random/iter/uniform' );
 *
-* var iter = iterAcovercos( uniform( -2.0, 0.0 ) );
+* var iter = iterAcovercos( uniform( 0.0, 2.0 ) );
 *
 * var r = iter.next().value;
 * // returns <number>
diff --git a/lib/node_modules/@stdlib/math/strided/special/acovercos-by/README.md b/lib/node_modules/@stdlib/math/strided/special/acovercos-by/README.md
@@ -47,11 +47,11 @@ function accessor( v ) {
     return v;
 }
 
-var x = [ 0.0, -1.57, -0.5, -1.0, -1.25 ];
+var x = [ 0.0, 1.57, 0.5, 1.0, 1.25 ];
 var y = [ 0.0, 0.0, 0.0, 0.0, 0.0 ];
 
 acovercosBy( x.length, x, 1, y, 1, accessor );
-// y => [ ~1.571, ~-0.607, ~0.524, 0.0, ~-0.253 ]
+// y => [ ~-1.571, ~0.607, ~-0.524, 0.0, ~0.253 ]
 ```
 
 The function accepts the following arguments:
@@ -85,11 +85,11 @@ var context = {
     'count': 0
 };
 
-var x = [ 0.0, -1.57, -0.5, -1.0, -1.25 ];
+var x = [ 0.0, 1.57, 0.5, 1.0, 1.25 ];
 var y = [ 0.0, 0.0, 0.0, 0.0, 0.0 ];
 
 acovercosBy( x.length, x, 1, y, 1, accessor, context );
-// y => [ ~1.571, ~-0.607, ~0.524, 0.0, ~-0.253 ]
+// y => [ ~-1.571, ~0.607, ~-0.524, 0.0, ~0.253 ]
 
 var cnt = context.count;
 // returns 5
@@ -102,11 +102,11 @@ function accessor( v ) {
     return v;
 }
 
-var x = [ 0.0, -1.57, -0.5, -1.0, -1.25, -0.67 ];
+var x = [ 0.0, 1.57, 0.5, 1.0, 1.25, 0.67 ];
 var y = [ 0.0, 0.0, 0.0, 0.0, 0.0, 0.0 ];
 
 acovercosBy( 3, x, 2, y, -1, accessor );
-// y => [ ~-0.253, ~0.524, ~1.571, 0.0, 0.0, 0.0 ]
+// y => [ ~0.253, ~-0.524, ~-1.571, 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.
@@ -119,15 +119,15 @@ function accessor( v ) {
 }
 
 // Initial arrays...
-var x0 = new Float64Array( [ 0.0, -1.57, -0.5, -1.0, -1.25, -0.67 ] );
+var x0 = new Float64Array( [ 0.0, 1.57, 0.5, 1.0, 1.25, 0.67 ] );
 var y0 = new Float64Array( [ 0.0, 0.0, 0.0, 0.0, 0.0, 0.0 ] );
 
 // Create offset views...
 var x1 = new Float64Array( x0.buffer, x0.BYTES_PER_ELEMENT*1 ); // start at 2nd element
 var y1 = new Float64Array( y0.buffer, y0.BYTES_PER_ELEMENT*3 ); // start at 4th element
 
 acovercosBy( 3, x1, -2, y1, 1, accessor );
-// y0 => <Float64Array>[ 0.0, 0.0, 0.0, ~0.336, 0.0, ~-0.607 ]
+// y0 => <Float64Array>[ 0.0, 0.0, 0.0, ~-0.336, 0.0, ~0.607 ]
 ```
 
 #### acovercosBy.ndarray( N, x, strideX, offsetX, y, strideY, offsetY, clbk\[, thisArg] )
@@ -139,11 +139,11 @@ function accessor( v ) {
     return v;
 }
 
-var x = [ 0.0, -1.57, -0.5, -1.0, -1.25 ];
+var x = [ 0.0, 1.57, 0.5, 1.0, 1.25 ];
 var y = [ 0.0, 0.0, 0.0, 0.0, 0.0 ];
 
 acovercosBy.ndarray( x.length, x, 1, 0, y, 1, 0, accessor );
-// y => [ ~1.571, ~-0.607, ~0.524, 0.0, ~-0.253 ]
+// y => [ ~-1.571, ~0.607, ~-0.524, 0.0, ~0.253 ]
 ```
 
 The function accepts the following additional arguments:
@@ -158,11 +158,11 @@ function accessor( v ) {
     return v;
 }
 
-var x = [ 0.0, -1.57, -0.5, -1.0, -1.25, -0.67 ];
+var x = [ 0.0, 1.57, 0.5, 1.0, 1.25, 0.67 ];
 var y = [ 0.0, 0.0, 0.0, 0.0, 0.0, 0.0 ];
 
 acovercosBy.ndarray( 3, x, 2, 1, y, -1, y.length-1, accessor );
-// y => [ 0.0, 0.0, 0.0, ~0.336, 0.0, ~-0.607 ]
+// y => [ 0.0, 0.0, 0.0, ~-0.336, 0.0, ~0.607 ]
 ```
 
 </section>
@@ -180,7 +180,7 @@ acovercosBy.ndarray( 3, x, 2, 1, y, -1, y.length-1, accessor );
         // No-op...
     }
 
-    var x = [ 0.0, -1.57, -0.5, -1.0, -1.25 ];
+    var x = [ 0.0, 1.57, 0.5, 1.0, 1.25 ];
     var y = [ 0.0, 0.0, 0.0, 0.0, 0.0 ];
 
     acovercosBy( x.length, x, 1, y, 1, accessor );
@@ -211,7 +211,7 @@ function accessor( v, i ) {
     return v;
 }
 
-var x = filledarrayBy( 10, 'generic', uniform( -2.0, 0.0 ) );
+var x = filledarrayBy( 10, 'generic', uniform( 0.0, 2.0 ) );
 console.log( x );
 
 var y = filledarray( null, 10, 'generic' );
diff --git a/lib/node_modules/@stdlib/math/strided/special/acovercos-by/benchmark/benchmark.js b/lib/node_modules/@stdlib/math/strided/special/acovercos-by/benchmark/benchmark.js
@@ -32,7 +32,7 @@ var acovercosBy = require( './../lib/main.js' );
 
 // VARIABLES //
 
-var rand = uniform( -2.0, 0.0 );
+var rand = uniform( 0.0, 2.0 );
 
 
 // FUNCTIONS //
diff --git a/lib/node_modules/@stdlib/math/strided/special/acovercos-by/benchmark/benchmark.ndarray.js b/lib/node_modules/@stdlib/math/strided/special/acovercos-by/benchmark/benchmark.ndarray.js
@@ -32,7 +32,7 @@ var acovercosBy = require( './../lib/ndarray.js' );
 
 // VARIABLES //
 
-var rand = uniform( -2.0, 0.0 );
+var rand = uniform( 0.0, 2.0 );
 
 
 // FUNCTIONS //
diff --git a/lib/node_modules/@stdlib/math/strided/special/acovercos-by/docs/repl.txt b/lib/node_modules/@stdlib/math/strided/special/acovercos-by/docs/repl.txt
diff --git a/lib/node_modules/@stdlib/math/strided/special/acovercos-by/docs/types/index.d.ts b/lib/node_modules/@stdlib/math/strided/special/acovercos-by/docs/types/index.d.ts
diff --git a/lib/node_modules/@stdlib/math/strided/special/acovercos-by/examples/index.js b/lib/node_modules/@stdlib/math/strided/special/acovercos-by/examples/index.js
diff --git a/lib/node_modules/@stdlib/math/strided/special/acovercos-by/lib/index.js b/lib/node_modules/@stdlib/math/strided/special/acovercos-by/lib/index.js
diff --git a/lib/node_modules/@stdlib/math/strided/special/acovercos-by/lib/main.js b/lib/node_modules/@stdlib/math/strided/special/acovercos-by/lib/main.js
diff --git a/lib/node_modules/@stdlib/math/strided/special/acovercos-by/lib/ndarray.js b/lib/node_modules/@stdlib/math/strided/special/acovercos-by/lib/ndarray.js
diff --git a/lib/node_modules/@stdlib/math/strided/special/acovercos-by/test/test.main.js b/lib/node_modules/@stdlib/math/strided/special/acovercos-by/test/test.main.js
diff --git a/lib/node_modules/@stdlib/math/strided/special/acovercos-by/test/test.ndarray.js b/lib/node_modules/@stdlib/math/strided/special/acovercos-by/test/test.ndarray.js

Original file line number	Diff line number	Diff line change
`@@ -122,7 +122,7 @@`
`122`	`122`	`]`
`123`	`123`	`}`
`124`	`124`	`],`
`125`		`- "output_policy": "same",`
	`125`	`+ "output_policy": "real_floating_point_and_generic",`
`126`	`126`	`"returns": {`
`127`	`127`	`"desc": "arccosine (in radians)",`
`128`	`128`	`"type": {`
Original file line number	Diff line number	Diff line change
`@@ -119,7 +119,7 @@`
`119`	`119`	`]`
`120`	`120`	`}`
`121`	`121`	`],`
`122`		`- "output_policy": "same",`
	`122`	`+ "output_policy": "real_floating_point_and_generic",`
`123`	`123`	`"returns": {`
`124`	`124`	`"desc": "arccosine (in degrees)",`
`125`	`125`	`"type": {`
Original file line number	Diff line number	Diff line change
`@@ -126,7 +126,7 @@`
`126`	`126`	`]`
`127`	`127`	`}`
`128`	`128`	`],`
`129`		`- "output_policy": "same",`
	`129`	`+ "output_policy": "real_floating_point_and_generic",`
`130`	`130`	`"returns": {`
`131`	`131`	`"desc": "hyperbolic arccosine",`
`132`	`132`	`"type": {`
Original file line number	Diff line number	Diff line change
`@@ -123,7 +123,7 @@`
`123`	`123`	`]`
`124`	`124`	`}`
`125`	`125`	`],`
`126`		`- "output_policy": "same",`
	`126`	`+ "output_policy": "real_floating_point_and_generic",`
`127`	`127`	`"returns": {`
`128`	`128`	`"desc": "inverse cotangent (in radians)",`
`129`	`129`	`"type": {`
Original file line number	Diff line number	Diff line change
`@@ -121,7 +121,7 @@`
`121`	`121`	`]`
`122`	`122`	`}`
`123`	`123`	`],`
`124`		`- "output_policy": "same",`
	`124`	`+ "output_policy": "real_floating_point_and_generic",`
`125`	`125`	`"returns": {`
`126`	`126`	`"desc": "inverse cotangent (in degrees)",`
`127`	`127`	`"type": {`
Original file line number	Diff line number	Diff line change
`@@ -120,7 +120,7 @@`
`120`	`120`	`]`
`121`	`121`	`}`
`122`	`122`	`],`
`123`		`- "output_policy": "same",`
	`123`	`+ "output_policy": "real_floating_point_and_generic",`
`124`	`124`	`"returns": {`
`125`	`125`	`"desc": "inverse cotangent (in radians)",`
`126`	`126`	`"type": {`