Auto-generated commit

Author: stdlib-bot

CHANGELOG.md

@@ -4,7 +4,7 @@
 
 <section class="release" id="unreleased">
 
-## Unreleased (2025-04-17)
+## Unreleased (2025-04-18)
 
 <section class="packages">
 
@@ -136,6 +136,16 @@
 
 <!-- /.features -->
 
+<section class="bug-fixes">
+
+##### Bug Fixes
+
+-   [`6c571bf`](https://github.com/stdlib-js/stdlib/commit/6c571bf330e3fc293f6ef7c40fcc6bfefcd7f61d) - preserve output array type specificity
+
+</section>
+
+<!-- /.bug-fixes -->
+
 </details>
 
 </section>
@@ -194,6 +204,16 @@
 
 <!-- /.features -->
 
+<section class="bug-fixes">
+
+##### Bug Fixes
+
+-   [`e051a2f`](https://github.com/stdlib-js/stdlib/commit/e051a2fbf9cb31b562972c20c361a71b6ad837f6) - improve type specificity
+
+</section>
+
+<!-- /.bug-fixes -->
+
 </details>
 
 </section>
@@ -9807,6 +9827,10 @@ A total of 30 people contributed to this release. Thank you to the following con
 <details>
 
 -   [`3656652`](https://github.com/stdlib-js/stdlib/commit/36566524e333dabea3b4b47c00b154accc1c2c23) - **feat:** add `math/base/special/lucasf` [(#6223)](https://github.com/stdlib-js/stdlib/pull/6223) _(by Harsh, stdlib-bot, Karan Anand)_
+-   [`dd317a4`](https://github.com/stdlib-js/stdlib/commit/dd317a4963fb9c35e1967a4b96556c3b060675c5) - **docs:** fix copy _(by Athan Reines)_
+-   [`e051a2f`](https://github.com/stdlib-js/stdlib/commit/e051a2fbf9cb31b562972c20c361a71b6ad837f6) - **fix:** improve type specificity _(by Athan Reines)_
+-   [`f81d254`](https://github.com/stdlib-js/stdlib/commit/f81d254ca5fc52dede022955c37aa0c90893969a) - **docs:** fix example _(by Athan Reines)_
+-   [`6c571bf`](https://github.com/stdlib-js/stdlib/commit/6c571bf330e3fc293f6ef7c40fcc6bfefcd7f61d) - **fix:** preserve output array type specificity _(by Athan Reines)_
 -   [`da4436d`](https://github.com/stdlib-js/stdlib/commit/da4436d4372c05e78d6936e1738be14e640ef099) - **docs:** replace manual `for` loop in examples [(#6689)](https://github.com/stdlib-js/stdlib/pull/6689) _(by Harsh)_
 -   [`2aadeb5`](https://github.com/stdlib-js/stdlib/commit/2aadeb5422491aeab1afd3424f54048911b9cb31) - **bench:** update random value generation [(#6686)](https://github.com/stdlib-js/stdlib/pull/6686) _(by Harsh)_
 -   [`f7b18f2`](https://github.com/stdlib-js/stdlib/commit/f7b18f2f07eea6ac092fee7bc7c459fe96b4dd2c) - **bench:** update random value generation [(#6687)](https://github.com/stdlib-js/stdlib/pull/6687) _(by Harsh)_

array/special/abs/docs/types/index.d.ts

@@ -57,7 +57,7 @@ interface Unary {
 	* var out = abs( [ -1.0, -2.0, -3.0 ] );
 	* // returns [ 1.0, 2.0, 3.0 ]
 	*/
-	( x: InputArray<number>, options?: Options ): OutputArray<number>;
+	<T extends InputArray<number>>( x: T, options?: Options ): T;
 
 	/**
 	* Computes the absolute value for each element in an input array and assigns results to a provided output array.
@@ -75,7 +75,7 @@ interface Unary {
 	* var bool = ( out === y );
 	* // returns true
 	*/
-	assign<V extends OutputArray<number>>( x: InputArray<number>, out: V ): V;
+	assign<U extends OutputArray<number>>( x: InputArray<number>, out: U ): U;
 }
 
 /**

array/special/abs/docs/types/test.ts

@@ -28,8 +28,8 @@ import abs = require( './index' );
 
 // The function returns an array...
 {
-	abs( [ 1.0, 2.0, 3.0, 4.0 ] ); // $ExpectType OutputArray<number>
-	abs( [ 1.0, 2.0, 3.0, 4.0 ], {} ); // $ExpectType OutputArray<number>
+	abs( [ 1.0, 2.0, 3.0, 4.0 ] ); // $ExpectType number[]
+	abs( [ 1.0, 2.0, 3.0, 4.0 ], {} ); // $ExpectType number[]
 }
 
 // The compiler throws an error if the function is provided a first argument which is not an array...

array/special/abs/lib/index.js

@@ -38,6 +38,7 @@
 * // returns [ 1.0, 2.0, 3.0 ]
 *
 * var bool = ( out === y );
+* // returns true
 */
 
 // MODULES //

array/tools/unary-factory/README.md

@@ -43,7 +43,7 @@ var policy = 'same';
 var unary = factory( abs, dtypes, dtypes, policy );
 ```
 
-The constructor has the following parameters:
+The function has the following parameters:
 
 -   **fcn**: unary function to apply.
 -   **idtypes**: list of supported input data types.

array/tools/unary-factory/docs/types/index.d.ts

@@ -74,7 +74,7 @@ interface UnaryFunction<T, U> {
 	*
 	* var x = [ -1.0, -2.0, -3.0 ];
 	*
-	* var y = abs.apply( x );
+	* var y = abs( x );
 	* // returns [ 1.0, 2.0, 3.0 ]
 	*/
 	( x: InputArray<T>, options?: Options ): OutputArray<U>; // NOTE: we lose type specificity here, but retaining specificity would likely be difficult and/or tedious to completely enumerate, as the output array data type is dependent on how `x` interacts with output data type policy and whether that policy has been overridden by `options.dtype`. In principle, as well, based on the policy, it is possible to know more exactly which `InputArray` types are actually allowed.

array/tools/unary/docs/types/index.d.ts

@@ -103,7 +103,7 @@ declare class UnaryFunction<T, U> {
 	* var y = abs.apply( x );
 	* // returns [ 1.0, 2.0, 3.0 ]
 	*/
-	apply( x: InputArray<T>, options?: Options ): OutputArray<U>;
+	apply( x: InputArray<T>, options?: Options ): OutputArray<U>; // NOTE: we lose type specificity here, but retaining specificity would likely be difficult and/or tedious to completely enumerate, as the output array data type is dependent on how `x` interacts with output data type policy and whether that policy has been overridden by `options.dtype`. In principle, as well, based on the policy, it is possible to know more exactly which `InputArray` types are actually allowed.
 
 	/**
 	* Applies a unary function to each element in a provided input array and assigns results to a provided output array.
@@ -131,7 +131,7 @@ declare class UnaryFunction<T, U> {
 	* var bool = ( out === y );
 	* // returns true
 	*/
-	assign( x: InputArray<T>, out: OutputArray<U> ): OutputArray<U>;
+	assign<V extends OutputArray<U> = OutputArray<U>>( x: InputArray<T>, out: V ): V;
 }
 
 /**

array/tools/unary/docs/types/test.ts

@@ -239,11 +239,11 @@ import Unary = require( './index' );
 	const x = zeros( 10, 'float64' );
 
 	const f1 = new Unary<number, number>( abs, dtypes, dtypes, 'same' );
-	f1.assign( x, x ); // $ExpectType OutputArray<number>
+	f1.assign( x, x ); // $ExpectType Float64Array
 
 	const unary = Unary;
 	const f2 = unary<number, number>( abs, dtypes, dtypes, 'same' );
-	f2.assign( x, x ); // $ExpectType OutputArray<number>
+	f2.assign( x, x ); // $ExpectType Float64Array
 }
 
 // The compiler throws an error if the `assign` method is provided a first argument which is not an array-like object...