refactor: support data type instances

---
type: pre_commit_static_analysis_report
description: Results of running static analysis checks when committing changes.
report:
  - task: lint_filenames
    status: passed
  - task: lint_editorconfig
    status: passed
  - task: lint_markdown
    status: na
  - task: lint_package_json
    status: na
  - task: lint_repl_help
    status: passed
  - task: lint_javascript_src
    status: passed
  - task: lint_javascript_cli
    status: na
  - task: lint_javascript_examples
    status: na
  - task: lint_javascript_tests
    status: passed
  - task: lint_javascript_benchmarks
    status: na
  - task: lint_python
    status: na
  - task: lint_r
    status: na
  - task: lint_c_src
    status: na
  - task: lint_c_examples
    status: na
  - task: lint_c_benchmarks
    status: na
  - task: lint_c_tests_fixtures
    status: na
  - task: lint_shell
    status: na
  - task: lint_typescript_declarations
    status: passed
  - task: lint_typescript_tests
    status: na
  - task: lint_license_headers
    status: passed
---

Author: kgryte

lib/node_modules/@stdlib/random/tools/unary/docs/repl.txt

@@ -8,10 +8,10 @@
     prng: Function
         Unary pseudorandom value generator.
 
-    idtypes: Array<string>
+    idtypes: Array<string|DataType>
         List of supported input data types.
 
-    odtypes: Array<string>
+    odtypes: Array<string|DataType>
         List of supported output data types.
 
     policies: Object
@@ -53,7 +53,7 @@
     options: Object (optional)
         Function options.
 
-    options.dtype: string (optional)
+    options.dtype: string|DataType (optional)
         Output data type. Setting this option overrides the output data type
         policy.
 

lib/node_modules/@stdlib/random/tools/unary/lib/main.js

@@ -33,6 +33,7 @@ var isPlainObject = require( '@stdlib/assert/is-plain-object' );
 var isObject = require( '@stdlib/assert/is-object' );
 var isCollection = require( '@stdlib/assert/is-collection' );
 var isDataType = require( '@stdlib/ndarray/base/assert/is-data-type' );
+var isEqualDataType = require( '@stdlib/ndarray/base/assert/is-equal-data-type' );
 var isOutputDataTypePolicy = require( '@stdlib/ndarray/base/assert/is-output-data-type-policy' );
 var isReadOnly = require( '@stdlib/ndarray/base/assert/is-read-only' );
 var isOrder = require( '@stdlib/ndarray/base/assert/is-order' );
@@ -46,6 +47,8 @@ var unary = require( '@stdlib/ndarray/base/unary' );
 var broadcast = require( '@stdlib/ndarray/base/maybe-broadcast-array' );
 var broadcastScalar = require( '@stdlib/ndarray/base/broadcast-scalar' );
 var shape2strides = require( '@stdlib/ndarray/base/shape2strides' );
+var dtypes2strings = require( '@stdlib/ndarray/base/dtypes2strings' );
+var resolveStr = require( '@stdlib/ndarray/base/dtype-resolve-str' );
 var unaryOutputDataType = require( '@stdlib/ndarray/base/unary-output-dtype' );
 var numel = require( '@stdlib/ndarray/base/numel' );
 var buffer = require( '@stdlib/ndarray/base/buffer' );
@@ -68,8 +71,8 @@ var validate = require( './validate.js' );
 *
 * @constructor
 * @param {Function} prng - unary pseudorandom value generator
-* @param {StringArray} idtypes - list of supported input data types
-* @param {StringArray} odtypes - list of supported output data types
+* @param {ArrayLikeObject} idtypes - list of supported input data types
+* @param {ArrayLikeObject} odtypes - list of supported output data types
 * @param {Object} policies - policies
 * @param {string} policies.output - output data type policy
 * @param {Object} [options] - function options
@@ -143,13 +146,17 @@ function Random( prng, idtypes, odtypes, policies, options ) {
 	) {
 		throw new TypeError( format( 'invalid argument. Second argument must be an array of data types. Value: `%s`.', idtypes ) );
 	}
+	idtypes = dtypes2strings( idtypes );
+
 	if (
 		!isCollection( odtypes ) ||
 		odtypes.length < 1 ||
 		!everyBy( odtypes, isDataType )
 	) {
 		throw new TypeError( format( 'invalid argument. Third argument must be an array of data types. Value: `%s`.', odtypes ) );
 	}
+	odtypes = dtypes2strings( odtypes );
+
 	if ( !isObject( policies ) ) {
 		throw new TypeError( format( 'invalid argument. Fourth argument must be an object. Value: `%s`.', policies ) );
 	}
@@ -189,10 +196,10 @@ function Random( prng, idtypes, odtypes, policies, options ) {
 * @param {NonNegativeIntegerArray} shape - output shape
 * @param {(ndarrayLike|*)} param1 - PRNG parameter
 * @param {Options} [options] - function options
-* @param {string} [options.dtype] - output ndarray data type
+* @param {*} [options.dtype] - output ndarray data type
 * @param {string} [options.order] - memory layout (either row-major or column-major)
 * @param {string} [options.mode] - specifies how to handle indices which exceed ndarray dimensions
-* @param {StringArray} [options.submode] - specifies how to handle subscripts which exceed ndarray dimensions on a per dimension basis
+* @param {ArrayLikeObject<string>} [options.submode] - specifies how to handle subscripts which exceed ndarray dimensions on a per dimension basis
 * @param {boolean} [options.readonly] - boolean indicating whether an ndarray should be read-only
 * @throws {TypeError} first argument must be a valid shape
 * @throws {TypeError} must provide valid PRNG parameters
@@ -276,7 +283,7 @@ setReadOnly( Random.prototype, 'generate', function generate( shape, param1, opt
 		dt = 'generic';
 		FLG = true;
 	}
-	if ( !contains( this._idtypes, dt ) ) {
+	if ( !contains( this._idtypes, resolveStr( dt ) ) ) {
 		throw new TypeError( format( 'invalid argument. Second argument must have one of the following data types: "%s". Data type: `%s`.', join( this._idtypes, '", "' ), dt ) );
 	}
 	prng = this._prng;
@@ -311,7 +318,7 @@ setReadOnly( Random.prototype, 'generate', function generate( shape, param1, opt
 	}
 	// If provided a scalar PRNG parameter, we can simply fill a linear buffer with pseudorandom values (as all pseudorandom values are drawn from the same PRNG) and then wrap as an ndarray...
 	if ( FLG ) {
-		if ( dt === 'generic' ) {
+		if ( isEqualDataType( dt, 'generic' ) ) {
 			buf = filledBy( len, wrapper );
 		} else {
 			buf = buffer( dt, len );
@@ -415,11 +422,11 @@ setReadOnly( Random.prototype, 'assign', function assign( param1, out ) {
 		pdt = 'generic';
 		p1 = broadcastScalar( param1, pdt, getShape( out ), getOrder( out ) );
 	}
-	if ( !contains( this._idtypes, pdt ) ) {
+	if ( !contains( this._idtypes, resolveStr( pdt ) ) ) {
 		throw new TypeError( format( 'invalid argument. First argument must have one of the following data types: "%s". Data type: `%s`.', join( this._idtypes, '", "' ), pdt ) );
 	}
 	odt = getDType( out );
-	if ( !contains( this._odtypes, odt ) ) {
+	if ( !contains( this._odtypes, resolveStr( odt ) ) ) {
 		throw new TypeError( format( 'invalid argument. Second argument must have one of the following data types: "%s". Data type: `%s`.', join( this._odtypes, '", "' ), odt ) );
 	}
 	// Fill the output array with pseudorandom values:

lib/node_modules/@stdlib/random/tools/unary/lib/validate.js

@@ -24,6 +24,7 @@ var isObject = require( '@stdlib/assert/is-plain-object' );
 var hasOwnProp = require( '@stdlib/assert/has-own-property' );
 var contains = require( '@stdlib/array/base/assert/contains' );
 var join = require( '@stdlib/array/base/join' );
+var resolveStr = require( '@stdlib/ndarray/base/dtype-resolve-str' );
 var format = require( '@stdlib/string/format' );
 
 
@@ -34,12 +35,12 @@ var format = require( '@stdlib/string/format' );
 *
 * @private
 * @param {Object} opts - destination object
-* @param {StringArray} dtypes - list of supported output data types
+* @param {Array<string>} dtypes - list of supported output data types
 * @param {Options} options - function options
-* @param {string} [options.dtype] - array data type
+* @param {*} [options.dtype] - array data type
 * @param {string} [options.order] - memory layout (either row-major or column-major)
 * @param {string} [options.mode] - specifies how to handle indices which exceed array dimensions
-* @param {StringArray} [options.submode] - specifies how to handle subscripts which exceed array dimensions on a per dimension basis
+* @param {ArrayLikeObject<string>} [options.submode] - specifies how to handle subscripts which exceed array dimensions on a per dimension basis
 * @param {boolean} [options.readonly] - boolean indicating whether an array should be read-only
 * @returns {(Error|null)} null or an error object
 *
@@ -60,9 +61,9 @@ function validate( opts, dtypes, options ) {
 		return new TypeError( format( 'invalid argument. Options argument must be an object. Value: `%s`.', options ) );
 	}
 	if ( hasOwnProp( options, 'dtype' ) ) {
-		opts.dtype = 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, '", "' ), opts.dtype ) );
+			return new TypeError( format( 'invalid option. `%s` option must be one of the following: "%s". Option: `%s`.', 'dtype', join( dtypes, '", "' ), options.dtype ) );
 		}
 	}
 	// Pass-through options...

lib/node_modules/@stdlib/random/tools/unary/test/test.validate.js

@@ -72,7 +72,7 @@ tape( 'the function returns an error if provided a `dtype` option which is not a
 
 	values = [
 		'5',
-		-5,
+		'foo',
 		NaN,
 		true,
 		false,