Auto-generated commit

Author: stdlib-bot

CHANGELOG.md

@@ -4,7 +4,7 @@
 
 <section class="release" id="unreleased">
 
-## Unreleased (2026-04-07)
+## Unreleased (2026-04-08)
 
 <section class="features">
 
@@ -820,7 +820,16 @@ A total of 45 issues were closed in this release:
 
 <details>
 
+-   [`c8df03c`](https://github.com/stdlib-js/stdlib/commit/c8df03cfe4cb5362cfff5f981aff4c0abc6d0e5a) - **refactor:** add support for ancilliary ndarrays which decompose into subarrays _(by Athan Reines)_
+-   [`da18a82`](https://github.com/stdlib-js/stdlib/commit/da18a821cb5b0e559658144a92a9fc1876d7345e) - **style:** reorder declarations _(by Athan Reines)_
 -   [`bb0baff`](https://github.com/stdlib-js/stdlib/commit/bb0baff5acc1fbfa5f34b31045dde2ebd123c140) - **docs:** update namespace table of contents [(#11322)](https://github.com/stdlib-js/stdlib/pull/11322) _(by stdlib-bot)_
+-   [`cdb2bb5`](https://github.com/stdlib-js/stdlib/commit/cdb2bb52a947ce276bc00e331f003dfeb14ec204) - **refactor:** normalize dtypes to enums to reduce memory consumption and speed-up comparisons _(by Athan Reines)_
+-   [`8aae193`](https://github.com/stdlib-js/stdlib/commit/8aae19336b0cba0e5f7c35fd1fe792bc1264f907) - **docs:** update example and documented parameter types _(by Athan Reines)_
+-   [`660d15d`](https://github.com/stdlib-js/stdlib/commit/660d15d41bad15389df2e9a1e591592ce54932b9) - **docs:** update example and documented parameter types _(by Athan Reines)_
+-   [`26f1d6e`](https://github.com/stdlib-js/stdlib/commit/26f1d6e9227859c18102b50a0021ccf6d1963a1f) - **docs:** update example _(by Athan Reines)_
+-   [`4d67d66`](https://github.com/stdlib-js/stdlib/commit/4d67d66c98fe74d756b277266e5f4fdabaae3039) - **docs:** update example _(by Athan Reines)_
+-   [`edc94eb`](https://github.com/stdlib-js/stdlib/commit/edc94ebd0008c174362864f2fea40cefac495635) - **refactor:** add support for dtype instances and reduce memory requirements _(by Athan Reines)_
+-   [`408c8be`](https://github.com/stdlib-js/stdlib/commit/408c8be00cf7c2139a5ff2dbab966db756d95944) - **refactor:** add support for dtype instances and reduce memory requirements _(by Athan Reines)_
 -   [`aac0a2b`](https://github.com/stdlib-js/stdlib/commit/aac0a2be45cc8c0d70542b91d4ac3a958ea4881d) - **feat:** add `ndarray2string` to namespace _(by Athan Reines)_
 -   [`47e4985`](https://github.com/stdlib-js/stdlib/commit/47e4985d18efb25b0fc00c6818fccdf547c9113e) - **feat:** add `ndarray/to-string` [(#10899)](https://github.com/stdlib-js/stdlib/pull/10899) _(by Muhammad Haris, Athan Reines, stdlib-bot)_
 -   [`a467bf0`](https://github.com/stdlib-js/stdlib/commit/a467bf0083da8f346611e53a684a78212f76d426) - **chore:** fix typos and incorrect test values [(#11270)](https://github.com/stdlib-js/stdlib/pull/11270) _(by Philipp Burckhardt)_

base/binary-reduce-strided1d-dispatch/lib/main.js

@@ -33,14 +33,13 @@ var isFunctionArray = require( '@stdlib/assert/is-function-array' );
 var isDataType = require( './../../../base/assert/is-data-type' );
 var isOutputDataTypePolicy = require( './../../../base/assert/is-output-data-type-policy' );
 var isInputCastingPolicy = require( './../../../base/assert/is-input-casting-policy' );
-var isEqualDataType = require( './../../../base/assert/is-equal-data-type' );
 var contains = require( '@stdlib/array/base/assert/contains' );
 var binaryReduceStrided1d = require( './../../../base/binary-reduce-strided1d' );
 var binaryOutputDataType = require( './../../../base/binary-output-dtype' );
 var binaryInputCastingDataType = require( './../../../base/binary-input-casting-dtype' );
+var resolveEnum = require( './../../../base/dtype-resolve-enum' );
 var dtypes2enums = require( './../../../base/dtypes2enums' );
 var dtypes2strings = require( './../../../base/dtypes2strings' );
-var resolveStr = require( './../../../base/dtype-resolve-str' );
 var spreadDimensions = require( './../../../base/spread-dimensions' );
 var getShape = require( './../../../shape' ); // note: non-base accessor is intentional due to input ndarrays originating in userland
 var ndims = require( './../../../ndims' );
@@ -118,6 +117,8 @@ var DEFAULT_ORDER = defaults.get( 'order' );
 * // returns <ndarray>[ -5.0 ]
 */
 function BinaryStrided1dDispatch( table, idtypes, odtypes, policies ) {
+	var idt;
+	var odt;
 	var dt;
 	var i;
 	if ( !( this instanceof BinaryStrided1dDispatch ) ) {
@@ -138,7 +139,7 @@ function BinaryStrided1dDispatch( table, idtypes, odtypes, policies ) {
 	if ( !isCollection( idtypes ) ) {
 		throw new TypeError( format( 'invalid argument. Second argument must be an array-like object. Value: `%s`.', idtypes ) );
 	}
-	idtypes = copy( idtypes );
+	idt = [];
 	for ( i = 0; i < idtypes.length; i++ ) {
 		dt = idtypes[ i ];
 		if (
@@ -148,7 +149,7 @@ function BinaryStrided1dDispatch( table, idtypes, odtypes, policies ) {
 		) {
 			throw new TypeError( format( 'invalid argument. Second argument must contain arrays of data types. Value: `%s`.', idtypes ) );
 		}
-		idtypes[ i ] = dtypes2strings( dt );
+		idt.push( dtypes2enums( dt ) ); // note: convert to enums (i.e., integers) to ensure faster comparisons and reduced storage requirements
 	}
 	if (
 		!isCollection( odtypes ) ||
@@ -157,7 +158,7 @@ function BinaryStrided1dDispatch( table, idtypes, odtypes, policies ) {
 	) {
 		throw new TypeError( format( 'invalid argument. Third argument must be an array of data types. Value: `%s`.', odtypes ) );
 	}
-	odtypes = dtypes2strings( odtypes );
+	odt = dtypes2enums( odtypes ); // note: convert to enums (i.e., integers) to ensure faster comparisons and reduced storage requirements
 
 	if ( !isObject( policies ) ) {
 		throw new TypeError( format( 'invalid argument. Fourth argument must be an object. Value: `%s`.', table ) );
@@ -170,14 +171,14 @@ function BinaryStrided1dDispatch( table, idtypes, odtypes, policies ) {
 	}
 	this._table = {
 		'default': table.default,
-		'types': ( table.types ) ? dtypes2enums( table.types ) : [], // note: convert to enums (i.e., integers) to ensure faster comparisons
+		'types': ( table.types ) ? dtypes2enums( table.types ) : [], // note: convert to enums (i.e., integers) to ensure faster comparisons and reduced storage requirements
 		'fcns': ( table.fcns ) ? copy( table.fcns ) : []
 	};
 	if ( this._table.types.length !== 2 * this._table.fcns.length ) {
 		throw new Error( 'invalid argument. First argument specifies an unexpected number of types. Two input ndarray data types must be specified for each provided strided function.' );
 	}
-	this._idtypes = idtypes;
-	this._odtypes = odtypes;
+	this._idtypes = idt;
+	this._odtypes = odt;
 	this._policies = {
 		'output': policies.output,
 		'casting': policies.casting
@@ -240,6 +241,8 @@ setReadOnly( BinaryStrided1dDispatch.prototype, 'apply', function apply( x, y )
 	var ordx;
 	var ordy;
 	var ordz;
+	var xdte;
+	var ydte;
 	var err;
 	var idx;
 	var shx;
@@ -265,12 +268,14 @@ setReadOnly( BinaryStrided1dDispatch.prototype, 'apply', function apply( x, y )
 		throw new TypeError( format( 'invalid argument. Second argument must be an ndarray-like object. Value: `%s`.', y ) );
 	}
 	xdt = getDType( x );
-	if ( !contains( this._idtypes[ 0 ], resolveStr( xdt ) ) ) {
-		throw new TypeError( format( 'invalid argument. First argument must have one of the following data types: "%s". Data type: `%s`.', join( this._idtypes[ 0 ], '", "' ), xdt ) );
+	xdte = resolveEnum( xdt );
+	if ( !contains( this._idtypes[ 0 ], xdte ) ) {
+		throw new TypeError( format( 'invalid argument. First argument must have one of the following data types: "%s". Data type: `%s`.', join( dtypes2strings( this._idtypes[ 0 ] ), '", "' ), xdt ) );
 	}
 	ydt = getDType( y );
-	if ( !contains( this._idtypes[ 1 ], resolveStr( ydt ) ) ) {
-		throw new TypeError( format( 'invalid argument. Second argument must have one of the following data types: "%s". Data type: `%s`.', join( this._idtypes[ 1 ], '", "' ), ydt ) );
+	ydte = resolveEnum( ydt );
+	if ( !contains( this._idtypes[ 1 ], ydte ) ) {
+		throw new TypeError( format( 'invalid argument. Second argument must have one of the following data types: "%s". Data type: `%s`.', join( dtypes2strings( this._idtypes[ 1 ] ), '", "' ), ydt ) );
 	}
 	args = [ x, y ];
 	for ( i = 2; i < nargs; i++ ) {
@@ -279,10 +284,10 @@ setReadOnly( BinaryStrided1dDispatch.prototype, 'apply', function apply( x, y )
 			break;
 		}
 		dt = getDType( arr );
-		if ( !contains( this._idtypes[ i ], resolveStr( dt ) ) ) {
-			throw new TypeError( format( 'invalid argument. Argument %d must have one of the following data types: "%s". Data type: `%s`.', i, join( this._idtypes[ i ], '", "' ), dt ) );
+		if ( !contains( this._idtypes[ i ], resolveEnum( dt ) ) ) {
+			throw new TypeError( format( 'invalid argument. Argument %d must have one of the following data types: "%s". Data type: `%s`.', i, join( dtypes2strings( this._idtypes[ i ] ), '", "' ), dt ) );
 		}
-		// Note: we don't type promote additional ndarray arguments, as they are passed as scalars to the underlying strided reduction function...
+		// Note: we don't type promote additional ndarray arguments...
 		args.push( arr );
 	}
 	// If we didn't make it up until the last argument, this means that we found a non-options argument which was not an ndarray...
@@ -338,23 +343,23 @@ setReadOnly( BinaryStrided1dDispatch.prototype, 'apply', function apply( x, y )
 
 	// Determine whether we need to cast the input ndarrays...
 	dt = binaryInputCastingDataType( xdt, ydt, zdt, this._policies.casting );
-	if ( !isEqualDataType( xdt, dt ) ) {
-		// TODO: replace the following logic with a call to `ndarray/base/(?maybe-)(cast|convert|copy)` or similar utility
+	if ( xdte !== resolveEnum( dt ) ) {
+		// TODO: consider replacing the following logic with a call to `ndarray/base/(?maybe-)(cast|convert)` or similar utility
 		tmp = baseEmpty( dt, shx, ordx );
 		assign( [ x, tmp ] );
 		args[ 0 ] = tmp;
 		xdt = dt;
 	}
 	dt = binaryInputCastingDataType( ydt, xdt, zdt, this._policies.casting );
-	if ( !isEqualDataType( ydt, dt ) ) {
-		// TODO: replace the following logic with a call to `ndarray/base/(?maybe-)(cast|convert|copy)` or similar utility
+	if ( ydte !== resolveEnum( dt ) ) {
+		// TODO: consider replacing the following logic with a call to `ndarray/base/(?maybe-)(cast|convert)` or similar utility
 		tmp = baseEmpty( dt, shy, ordy );
 		assign( [ y, tmp ] );
 		args[ 1 ] = tmp;
 		ydt = dt;
 	}
 	// Resolve the lower-level strided function satisfying the input ndarray data types:
-	i = gindexOfRow( this._table.fcns.length, 2, this._table.types, 2, 1, 0, dtypes2enums( [ xdt, ydt ] ), 1, 0 ); // eslint-disable-line max-len
+	i = gindexOfRow( this._table.fcns.length, 2, this._table.types, 2, 1, 0, [ xdte, ydte ], 1, 0 ); // eslint-disable-line max-len
 	if ( i >= 0 ) {
 		f = this._table.fcns[ i ];
 	} else {
@@ -430,6 +435,8 @@ setReadOnly( BinaryStrided1dDispatch.prototype, 'assign', function assign( x, y
 	var nargs;
 	var opts;
 	var args;
+	var xdte;
+	var ydte;
 	var arr;
 	var err;
 	var flg;
@@ -455,12 +462,14 @@ setReadOnly( BinaryStrided1dDispatch.prototype, 'assign', function assign( x, y
 	}
 	// Validate the input ndarray data types in order to maintain similar behavior to `apply` above...
 	xdt = getDType( x );
-	if ( !contains( this._idtypes[ 0 ], resolveStr( xdt ) ) ) {
-		throw new TypeError( format( 'invalid argument. First argument must have one of the following data types: "%s". Data type: `%s`.', join( this._idtypes[ 0 ], '", "' ), xdt ) );
+	xdte = resolveEnum( xdt );
+	if ( !contains( this._idtypes[ 0 ], xdte ) ) {
+		throw new TypeError( format( 'invalid argument. First argument must have one of the following data types: "%s". Data type: `%s`.', join( dtypes2strings( this._idtypes[ 0 ] ), '", "' ), xdt ) );
 	}
 	ydt = getDType( y );
-	if ( !contains( this._idtypes[ 1 ], resolveStr( ydt ) ) ) {
-		throw new TypeError( format( 'invalid argument. Second argument must have one of the following data types: "%s". Data type: `%s`.', join( this._idtypes[ 1 ], '", "' ), ydt ) );
+	ydte = resolveEnum( ydt );
+	if ( !contains( this._idtypes[ 1 ], ydte ) ) {
+		throw new TypeError( format( 'invalid argument. Second argument must have one of the following data types: "%s". Data type: `%s`.', join( dtypes2strings( this._idtypes[ 1 ] ), '", "' ), ydt ) );
 	}
 	// Verify that both input arrays have the same shape:
 	shx = getShape( x );
@@ -500,11 +509,11 @@ setReadOnly( BinaryStrided1dDispatch.prototype, 'assign', function assign( x, y
 	// Cache a reference to the output ndarray:
 	z = args.pop();
 
-	// Verify that additional ndarray arguments have expected dtypes (note: we intentionally don't validate the output ndarray dtype in order to provide an escape hatch for a user wanting to have an output ndarray having a specific dtype that `apply` does not support; note: we don't type promote additional ndarray arguments, as they are passed as scalars to the underlying strided reduction function)...
+	// Verify that additional ndarray arguments have expected dtypes (note: we intentionally don't validate the output ndarray dtype in order to provide an escape hatch for a user wanting to have an output ndarray having a specific dtype that `apply` does not support; note: we don't type promote additional ndarray arguments)...
 	for ( i = 2; i < args.length; i++ ) {
 		dt = getDType( args[ i ] );
-		if ( !contains( this._idtypes[ i ], resolveStr( dt ) ) ) {
-			throw new TypeError( format( 'invalid argument. Argument %d must have one of the following data types: "%s". Data type: `%s`.', i, join( this._idtypes[ i ], '", "' ), dt ) );
+		if ( !contains( this._idtypes[ i ], resolveEnum( dt ) ) ) {
+			throw new TypeError( format( 'invalid argument. Argument %d must have one of the following data types: "%s". Data type: `%s`.', i, join( dtypes2strings( this._idtypes[ i ] ), '", "' ), dt ) );
 		}
 	}
 	// Validate any provided options...
@@ -523,23 +532,23 @@ setReadOnly( BinaryStrided1dDispatch.prototype, 'assign', function assign( x, y
 	// Determine whether we need to cast the input ndarrays...
 	zdt = getDType( z );
 	dt = binaryInputCastingDataType( xdt, ydt, zdt, this._policies.casting );
-	if ( !isEqualDataType( xdt, dt ) ) {
-		// TODO: replace the following logic with a call to `ndarray/base/(?maybe-)(cast|convert|copy)` or similar utility
+	if ( xdte !== resolveEnum( dt ) ) {
+		// TODO: consider replacing the following logic with a call to `ndarray/base/(?maybe-)(cast|convert)` or similar utility
 		tmp = baseEmpty( dt, shx, getOrder( x ) );
 		assign( [ x, tmp ] );
 		args[ 0 ] = tmp;
 		xdt = dt;
 	}
 	dt = binaryInputCastingDataType( ydt, xdt, zdt, this._policies.casting );
-	if ( !isEqualDataType( ydt, dt ) ) {
-		// TODO: replace the following logic with a call to `ndarray/base/(?maybe-)(cast|convert|copy)` or similar utility
+	if ( ydte !== resolveEnum( dt ) ) {
+		// TODO: consider replacing the following logic with a call to `ndarray/base/(?maybe-)(cast|convert)` or similar utility
 		tmp = baseEmpty( dt, shy, getOrder( y ) );
 		assign( [ y, tmp ] );
 		args[ 1 ] = tmp;
 		ydt = dt;
 	}
 	// Resolve the lower-level strided function satisfying the input ndarray data type:
-	i = gindexOfRow( this._table.fcns.length, 2, this._table.types, 2, 1, 0, dtypes2enums( [ xdt, ydt ] ), 1, 0 ); // eslint-disable-line max-len
+	i = gindexOfRow( this._table.fcns.length, 2, this._table.types, 2, 1, 0, [ xdte, ydte ], 1, 0 ); // eslint-disable-line max-len
 	if ( i >= 0 ) {
 		f = this._table.fcns[ i ];
 	} else {

base/binary-reduce-strided1d-dispatch/lib/validate.js

@@ -26,7 +26,8 @@ var isBoolean = require( '@stdlib/assert/is-boolean' ).isPrimitive;
 var isIntegerArray = require( '@stdlib/assert/is-integer-array' ).primitives;
 var isEmptyCollection = require( '@stdlib/assert/is-empty-collection' );
 var normalizeIndices = require( './../../../base/to-unique-normalized-indices' );
-var resolveStr = require( './../../../base/dtype-resolve-str' );
+var resolveEnum = require( './../../../base/dtype-resolve-enum' );
+var dtypes2strings = require( './../../../base/dtypes2strings' );
 var join = require( '@stdlib/array/base/join' );
 var contains = require( '@stdlib/array/base/assert/contains' );
 var format = require( '@stdlib/string/format' );
@@ -85,9 +86,9 @@ function validate( opts, ndims, dtypes, options ) {
 		opts.dims = tmp;
 	}
 	if ( hasOwnProp( options, 'dtype' ) ) {
-		opts.dtype = resolveStr( options.dtype );
-		if ( !contains( dtypes, opts.dtype ) ) {
-			return new TypeError( format( 'invalid option. `%s` option must be one of the following: "%s". Option: `%s`.', 'dtype', join( dtypes, '", "' ), options.dtype ) );
+		opts.dtype = options.dtype;
+		if ( !contains( dtypes, resolveEnum( opts.dtype ) ) ) {
+			return new TypeError( format( 'invalid option. `%s` option must be one of the following: "%s". Option: `%s`.', 'dtype', join( dtypes2strings( dtypes ), '", "' ), options.dtype ) );
 		}
 	}
 	return null;

base/broadcast-shapes/src/main.c

@@ -56,8 +56,8 @@
 * int8_t status = stdlib_ndarray_broadcast_shapes( 2, shapes, ndims, out );
 */
 int8_t stdlib_ndarray_broadcast_shapes( const int64_t M, const int64_t *shapes[], const int64_t ndims[], int64_t *out ) {
-	int64_t dim;
 	const int64_t *sh;
+	int64_t dim;
 	int64_t n1;
 	int64_t n2;
 	int64_t d;

base/unary-reduce-strided1d-dispatch-by-factory/README.md

@@ -158,7 +158,7 @@ var opts = {
 var y = unary( x, opts, clbk );
 // returns <ndarray>
 
-var dt = getDType( y );
+var dt = String( getDType( y ) );
 // returns 'float64'
 ```
 

base/unary-reduce-strided1d-dispatch-by-factory/docs/repl.txt

@@ -31,11 +31,11 @@
         - clbk: callback function to apply to each element of an input ndarray.
         - thisArg: callback function execution context.
 
-    idtypes: Array<Array<string>>
+    idtypes: Array<Array<string|DataType>>
         List containing lists of supported input array data types for each input
         ndarray argument.
 
-    odtypes: Array<string>
+    odtypes: Array<string|DataType>
         List of supported output array data types.
 
     policies: Object
@@ -72,7 +72,7 @@ fcn( x[, ...args][, options], clbk[, thisArg] )
     options: Object (optional)
         Function options.
 
-    options.dtype: string (optional)
+    options.dtype: string|DataType (optional)
         Output array data type. Setting this option overrides the output data
         type policy.
 

base/unary-reduce-strided1d-dispatch-by-factory/lib/main.js

@@ -31,10 +31,10 @@ var UnaryStrided1dDispatchBy = require( './../../../base/unary-reduce-strided1d-
 *
 * @param {Object} table - dispatch table
 * @param {Function} table.default - default strided reduction function
-* @param {StringArray} [table.types] - one-dimensional list of ndarray data types describing specialized input ndarray argument signatures
+* @param {ArrayLikeObject} [table.types] - one-dimensional list of ndarray data types describing specialized input ndarray argument signatures
 * @param {ArrayLikeObject<Function>} [table.fcns] - list of strided reduction functions which are specific to specialized input ndarray argument signatures
-* @param {ArrayLikeObject<StringArray>} idtypes - list containing lists of supported input data types for each ndarray argument
-* @param {StringArray} odtypes - list of supported output data types
+* @param {ArrayLikeObject<ArrayLikeObject>} idtypes - list containing lists of supported input data types for each ndarray argument
+* @param {ArrayLikeObject} odtypes - list of supported output data types
 * @param {Object} policies - policies
 * @param {string} policies.output - output data type policy
 * @param {string} policies.casting - input ndarray casting policy
@@ -125,7 +125,7 @@ function factory( table, idtypes, odtypes, policies ) {
 	* @param {Options} [options] - function options
 	* @param {IntegerArray} [options.dims] - list of dimensions over which to perform a reduction
 	* @param {boolean} [options.keepdims=false] - boolean indicating whether the reduced dimensions should be included in the returned ndarray as singleton dimensions
-	* @param {string} [options.dtype] - output ndarray data type
+	* @param {*} [options.dtype] - output ndarray data type
 	* @param {Function} clbk - callback function
 	* @param {*} [thisArg] - callback function execution context
 	* @throws {TypeError} first argument must be an ndarray

base/unary-reduce-strided1d-dispatch-by/README.md

@@ -152,7 +152,7 @@ var opts = {
 var y = unary.apply( x, opts, clbk );
 // returns <ndarray>
 
-var dt = getDType( y );
+var dt = String( getDType( y ) );
 // returns 'float64'
 ```