diff --git a/lib/node_modules/@stdlib/blas/base/diagonal-type-enum2str/README.md b/lib/node_modules/@stdlib/blas/base/diagonal-type-enum2str/README.md
new file mode 100644
index 000000000000..9afb7880d263
--- /dev/null
+++ b/lib/node_modules/@stdlib/blas/base/diagonal-type-enum2str/README.md
@@ -0,0 +1,121 @@
+
+
+# enum2str
+
+> Return the BLAS diagonal type string associated with a BLAS diagonal type enumeration constant.
+
+
+
+
+
+
+
+
+
+
+
+## Usage
+
+```javascript
+var enum2str = require( '@stdlib/blas/base/diagonal-type-enum2str' );
+```
+
+#### enum2str( value )
+
+Returns the BLAS diagonal type string associated with a BLAS diagonal type enumeration constant.
+
+```javascript
+var str2enum = require( '@stdlib/blas/base/diagonal-type-str2enum' );
+
+var v = str2enum( 'unit' );
+// returns
+
+var s = enum2str( v );
+// returns 'unit'
+```
+
+If unable to resolve a diagonal type string, the function returns `null`.
+
+```javascript
+var v = enum2str( -999999999 );
+// returns null
+```
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+## Examples
+
+
+
+```javascript
+var str2enum = require( '@stdlib/blas/base/diagonal-type-str2enum' );
+var enum2str = require( '@stdlib/blas/base/diagonal-type-enum2str' );
+
+var str = enum2str( str2enum( 'unit' ) );
+// returns 'unit'
+
+str = enum2str( str2enum( 'non-unit' ) );
+// returns 'non-unit'
+```
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
diff --git a/lib/node_modules/@stdlib/blas/base/diagonal-type-enum2str/benchmark/benchmark.js b/lib/node_modules/@stdlib/blas/base/diagonal-type-enum2str/benchmark/benchmark.js
new file mode 100644
index 000000000000..ac0a6c9f367b
--- /dev/null
+++ b/lib/node_modules/@stdlib/blas/base/diagonal-type-enum2str/benchmark/benchmark.js
@@ -0,0 +1,55 @@
+/**
+* @license Apache-2.0
+*
+* Copyright (c) 2024 The Stdlib Authors.
+*
+* Licensed under the Apache License, Version 2.0 (the "License");
+* you may not use this file except in compliance with the License.
+* You may obtain a copy of the License at
+*
+* http://www.apache.org/licenses/LICENSE-2.0
+*
+* Unless required by applicable law or agreed to in writing, software
+* distributed under the License is distributed on an "AS IS" BASIS,
+* WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+* See the License for the specific language governing permissions and
+* limitations under the License.
+*/
+
+'use strict';
+
+// MODULES //
+
+var bench = require( '@stdlib/bench' );
+var isString = require( '@stdlib/assert/is-string' ).isPrimitive;
+var str2enum = require( '@stdlib/blas/base/diagonal-type-str2enum' );
+var pkg = require( './../package.json' ).name;
+var enum2str = require( './../lib' );
+
+
+// MAIN //
+
+bench( pkg, function benchmark( b ) {
+ var values;
+ var out;
+ var i;
+
+ values = [
+ str2enum( 'unit' ),
+ str2enum( 'non-unit' )
+ ];
+
+ b.tic();
+ for ( i = 0; i < b.iterations; i++ ) {
+ out = enum2str( values[ i%values.length ] );
+ if ( typeof out !== 'string' ) {
+ b.fail( 'should return a string' );
+ }
+ }
+ b.toc();
+ if ( !isString( out ) ) {
+ b.fail( 'should return a string' );
+ }
+ b.pass( 'benchmark finished' );
+ b.end();
+});
diff --git a/lib/node_modules/@stdlib/blas/base/diagonal-type-enum2str/docs/repl.txt b/lib/node_modules/@stdlib/blas/base/diagonal-type-enum2str/docs/repl.txt
new file mode 100644
index 000000000000..3cc380c40ce5
--- /dev/null
+++ b/lib/node_modules/@stdlib/blas/base/diagonal-type-enum2str/docs/repl.txt
@@ -0,0 +1,23 @@
+
+{{alias}}( value )
+ Returns the BLAS diagonal type string associated with a BLAS diagonal type
+ enumeration constant.
+
+ Parameters
+ ----------
+ value: integer
+ Diagonal type enumeration constant.
+
+ Returns
+ -------
+ out: string|null
+ Diagonal type string.
+
+ Examples
+ --------
+ > var out = {{alias}}( {{alias:@stdlib/blas/base/diagonal-type-str2enum}}( 'unit' ) )
+ 'unit'
+
+ See Also
+ --------
+
diff --git a/lib/node_modules/@stdlib/blas/base/diagonal-type-enum2str/docs/types/index.d.ts b/lib/node_modules/@stdlib/blas/base/diagonal-type-enum2str/docs/types/index.d.ts
new file mode 100644
index 000000000000..19e95fb05b8e
--- /dev/null
+++ b/lib/node_modules/@stdlib/blas/base/diagonal-type-enum2str/docs/types/index.d.ts
@@ -0,0 +1,41 @@
+/*
+* @license Apache-2.0
+*
+* Copyright (c) 2024 The Stdlib Authors.
+*
+* Licensed under the Apache License, Version 2.0 (the "License");
+* you may not use this file except in compliance with the License.
+* You may obtain a copy of the License at
+*
+* http://www.apache.org/licenses/LICENSE-2.0
+*
+* Unless required by applicable law or agreed to in writing, software
+* distributed under the License is distributed on an "AS IS" BASIS,
+* WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+* See the License for the specific language governing permissions and
+* limitations under the License.
+*/
+
+// TypeScript Version: 4.1
+
+/**
+* Returns the BLAS diagonal type string associated with a BLAS diagonal type enumeration constant.
+*
+* @param value - enumeration constant
+* @returns diagonal type string
+*
+* @example
+* var str2enum = require( '@stdlib/blas/base/diagonal-type-str2enum' );
+*
+* var v = str2enum( 'unit' );
+* // returns
+*
+* var s = enum2str( v );
+* // returns 'unit'
+*/
+declare function enum2str( value: number ): string | null;
+
+
+// EXPORTS //
+
+export = enum2str;
diff --git a/lib/node_modules/@stdlib/blas/base/diagonal-type-enum2str/docs/types/test.ts b/lib/node_modules/@stdlib/blas/base/diagonal-type-enum2str/docs/types/test.ts
new file mode 100644
index 000000000000..65833e5930c3
--- /dev/null
+++ b/lib/node_modules/@stdlib/blas/base/diagonal-type-enum2str/docs/types/test.ts
@@ -0,0 +1,39 @@
+/*
+* @license Apache-2.0
+*
+* Copyright (c) 2024 The Stdlib Authors.
+*
+* Licensed under the Apache License, Version 2.0 (the "License");
+* you may not use this file except in compliance with the License.
+* You may obtain a copy of the License at
+*
+* http://www.apache.org/licenses/LICENSE-2.0
+*
+* Unless required by applicable law or agreed to in writing, software
+* distributed under the License is distributed on an "AS IS" BASIS,
+* WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+* See the License for the specific language governing permissions and
+* limitations under the License.
+*/
+
+import enum2str = require( './index' );
+
+
+// TESTS //
+
+// The function returns a string or null...
+{
+ enum2str( 0 ); // $ExpectType string | null
+}
+
+// The compiler throws an error if not provided a number...
+{
+ enum2str( '10' ); // $ExpectError
+ enum2str( true ); // $ExpectError
+ enum2str( false ); // $ExpectError
+ enum2str( null ); // $ExpectError
+ enum2str( undefined ); // $ExpectError
+ enum2str( [] ); // $ExpectError
+ enum2str( {} ); // $ExpectError
+ enum2str( ( x: number ): number => x ); // $ExpectError
+}
diff --git a/lib/node_modules/@stdlib/blas/base/diagonal-type-enum2str/examples/index.js b/lib/node_modules/@stdlib/blas/base/diagonal-type-enum2str/examples/index.js
new file mode 100644
index 000000000000..aa1ed7a18eb7
--- /dev/null
+++ b/lib/node_modules/@stdlib/blas/base/diagonal-type-enum2str/examples/index.js
@@ -0,0 +1,30 @@
+/**
+* @license Apache-2.0
+*
+* Copyright (c) 2024 The Stdlib Authors.
+*
+* Licensed under the Apache License, Version 2.0 (the "License");
+* you may not use this file except in compliance with the License.
+* You may obtain a copy of the License at
+*
+* http://www.apache.org/licenses/LICENSE-2.0
+*
+* Unless required by applicable law or agreed to in writing, software
+* distributed under the License is distributed on an "AS IS" BASIS,
+* WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+* See the License for the specific language governing permissions and
+* limitations under the License.
+*/
+
+'use strict';
+
+var str2enum = require( '@stdlib/blas/base/diagonal-type-str2enum' );
+var enum2str = require( './../lib' );
+
+var str = enum2str( str2enum( 'unit' ) );
+console.log( str );
+// => 'unit'
+
+str = enum2str( str2enum( 'non-unit' ) );
+console.log( str );
+// => 'non-unit'
diff --git a/lib/node_modules/@stdlib/blas/base/diagonal-type-enum2str/lib/index.js b/lib/node_modules/@stdlib/blas/base/diagonal-type-enum2str/lib/index.js
new file mode 100644
index 000000000000..2b1774931155
--- /dev/null
+++ b/lib/node_modules/@stdlib/blas/base/diagonal-type-enum2str/lib/index.js
@@ -0,0 +1,44 @@
+/**
+* @license Apache-2.0
+*
+* Copyright (c) 2024 The Stdlib Authors.
+*
+* Licensed under the Apache License, Version 2.0 (the "License");
+* you may not use this file except in compliance with the License.
+* You may obtain a copy of the License at
+*
+* http://www.apache.org/licenses/LICENSE-2.0
+*
+* Unless required by applicable law or agreed to in writing, software
+* distributed under the License is distributed on an "AS IS" BASIS,
+* WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+* See the License for the specific language governing permissions and
+* limitations under the License.
+*/
+
+'use strict';
+
+/**
+* Return the BLAS diagonal type string associated with a BLAS diagonal type enumeration constant.
+*
+* @module @stdlib/blas/base/diagonal-type-enum2str
+*
+* @example
+* var str2enum = require( '@stdlib/blas/base/diagonal-type-str2enum' );
+* var enum2str = require( '@stdlib/blas/base/diagonal-type-enum2str' );
+*
+* var v = str2enum( 'unit' );
+* // returns
+*
+* var s = enum2str( v );
+* // returns 'unit'
+*/
+
+// MODULES //
+
+var main = require( './main.js' );
+
+
+// EXPORTS //
+
+module.exports = main;
diff --git a/lib/node_modules/@stdlib/blas/base/diagonal-type-enum2str/lib/main.js b/lib/node_modules/@stdlib/blas/base/diagonal-type-enum2str/lib/main.js
new file mode 100644
index 000000000000..c09fb4c59433
--- /dev/null
+++ b/lib/node_modules/@stdlib/blas/base/diagonal-type-enum2str/lib/main.js
@@ -0,0 +1,59 @@
+/**
+* @license Apache-2.0
+*
+* Copyright (c) 2024 The Stdlib Authors.
+*
+* Licensed under the Apache License, Version 2.0 (the "License");
+* you may not use this file except in compliance with the License.
+* You may obtain a copy of the License at
+*
+* http://www.apache.org/licenses/LICENSE-2.0
+*
+* Unless required by applicable law or agreed to in writing, software
+* distributed under the License is distributed on an "AS IS" BASIS,
+* WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+* See the License for the specific language governing permissions and
+* limitations under the License.
+*/
+
+'use strict';
+
+// MODULES //
+
+var objectInverse = require( '@stdlib/utils/object-inverse' );
+var enumeration = require( '@stdlib/blas/base/diagonal-types' ).enum;
+
+
+// VARIABLES //
+
+var hash = objectInverse( enumeration(), {
+ 'duplicates': false
+});
+
+
+// MAIN //
+
+/**
+* Returns the BLAS diagonal type string associated with a BLAS diagonal type enumeration constant.
+*
+* @param {integer} value - diagonal type enumeration constant
+* @returns {(string|null)} diagonal type string or null
+*
+* @example
+* var str2enum = require( '@stdlib/blas/base/diagonal-type-str2enum' );
+*
+* var v = str2enum( 'unit' );
+* // returns
+*
+* var s = enum2str( v );
+* // returns 'unit'
+*/
+function enum2str( value ) {
+ var v = hash[ value ];
+ return ( typeof v === 'string' ) ? v : null; // note: we include this guard to prevent walking the prototype chain
+}
+
+
+// EXPORTS //
+
+module.exports = enum2str;
diff --git a/lib/node_modules/@stdlib/blas/base/diagonal-type-enum2str/package.json b/lib/node_modules/@stdlib/blas/base/diagonal-type-enum2str/package.json
new file mode 100644
index 000000000000..95e6d5ef9731
--- /dev/null
+++ b/lib/node_modules/@stdlib/blas/base/diagonal-type-enum2str/package.json
@@ -0,0 +1,67 @@
+{
+ "name": "@stdlib/blas/base/diagonal-type-enum2str",
+ "version": "0.0.0",
+ "description": "Return the BLAS diagonal type string associated with a BLAS diagonal type enumeration constant.",
+ "license": "Apache-2.0",
+ "author": {
+ "name": "The Stdlib Authors",
+ "url": "https://github.com/stdlib-js/stdlib/graphs/contributors"
+ },
+ "contributors": [
+ {
+ "name": "The Stdlib Authors",
+ "url": "https://github.com/stdlib-js/stdlib/graphs/contributors"
+ }
+ ],
+ "main": "./lib",
+ "directories": {
+ "benchmark": "./benchmark",
+ "doc": "./docs",
+ "example": "./examples",
+ "lib": "./lib",
+ "test": "./test"
+ },
+ "types": "./docs/types",
+ "scripts": {},
+ "homepage": "https://github.com/stdlib-js/stdlib",
+ "repository": {
+ "type": "git",
+ "url": "git://github.com/stdlib-js/stdlib.git"
+ },
+ "bugs": {
+ "url": "https://github.com/stdlib-js/stdlib/issues"
+ },
+ "dependencies": {},
+ "devDependencies": {},
+ "engines": {
+ "node": ">=0.10.0",
+ "npm": ">2.7.0"
+ },
+ "os": [
+ "aix",
+ "darwin",
+ "freebsd",
+ "linux",
+ "macos",
+ "openbsd",
+ "sunos",
+ "win32",
+ "windows"
+ ],
+ "keywords": [
+ "stdlib",
+ "blas",
+ "ndarray",
+ "matrix",
+ "diagonal",
+ "type",
+ "multidimensional",
+ "array",
+ "utilities",
+ "utility",
+ "utils",
+ "util",
+ "enum"
+ ],
+ "__stdlib__": {}
+}
diff --git a/lib/node_modules/@stdlib/blas/base/diagonal-type-enum2str/test/test.js b/lib/node_modules/@stdlib/blas/base/diagonal-type-enum2str/test/test.js
new file mode 100644
index 000000000000..43e4e363a3a6
--- /dev/null
+++ b/lib/node_modules/@stdlib/blas/base/diagonal-type-enum2str/test/test.js
@@ -0,0 +1,65 @@
+/**
+* @license Apache-2.0
+*
+* Copyright (c) 2024 The Stdlib Authors.
+*
+* Licensed under the Apache License, Version 2.0 (the "License");
+* you may not use this file except in compliance with the License.
+* You may obtain a copy of the License at
+*
+* http://www.apache.org/licenses/LICENSE-2.0
+*
+* Unless required by applicable law or agreed to in writing, software
+* distributed under the License is distributed on an "AS IS" BASIS,
+* WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+* See the License for the specific language governing permissions and
+* limitations under the License.
+*/
+
+'use strict';
+
+// MODULES //
+
+var tape = require( 'tape' );
+var str2enum = require( '@stdlib/blas/base/diagonal-type-str2enum' );
+var enum2str = require( './../lib' );
+
+
+// VARIABLES //
+
+var VALUES = [
+ 'non-unit',
+ 'unit'
+];
+
+
+// TESTS //
+
+tape( 'main export is a function', function test( t ) {
+ t.ok( true, __filename );
+ t.strictEqual( typeof enum2str, 'function', 'main export is a function' );
+ t.end();
+});
+
+tape( 'the function returns the diagonal type string associated with a BLAS diagonal type enumeration constant', function test( t ) {
+ var i;
+ for ( i = 0; i < VALUES.length; i++ ) {
+ t.strictEqual( enum2str( str2enum( VALUES[ i ] ) ), VALUES[ i ], 'returns expected value' );
+ }
+ t.end();
+});
+
+tape( 'the function returns `null` if unable to resolve a diagonal type string', function test( t ) {
+ var values;
+ var i;
+
+ values = [
+ -9999999,
+ -999999999,
+ -99999999999
+ ];
+ for ( i = 0; i < values.length; i++ ) {
+ t.strictEqual( enum2str( values[ i ] ), null, 'returns expected value' );
+ }
+ t.end();
+});
diff --git a/lib/node_modules/@stdlib/blas/base/diagonal-type-resolve-enum/README.md b/lib/node_modules/@stdlib/blas/base/diagonal-type-resolve-enum/README.md
new file mode 100644
index 000000000000..f7d1fec57d62
--- /dev/null
+++ b/lib/node_modules/@stdlib/blas/base/diagonal-type-resolve-enum/README.md
@@ -0,0 +1,124 @@
+
+
+# resolve
+
+> Return the enumeration constant associated with a supported BLAS diagonal type value.
+
+
+
+
+
+
+
+
+
+
+
+## Usage
+
+```javascript
+var resolve = require( '@stdlib/blas/base/diagonal-type-resolve-enum' );
+```
+
+#### resolve( value )
+
+Returns the enumeration constant associated with a BLAS diagonal type value.
+
+```javascript
+var str2enum = require( '@stdlib/blas/base/diagonal-type-str2enum' );
+
+var v = resolve( 'non-unit' );
+// returns
+
+v = resolve( str2enum( 'non-unit' ) );
+// returns
+```
+
+If unable to resolve an enumeration constant, the function returns `null`.
+
+```javascript
+var v = resolve( 'beep' );
+// returns null
+```
+
+
+
+
+
+
+
+
+
+## Notes
+
+- Downstream consumers of this function should **not** rely on specific integer values (e.g., `UNIT == 0`). Instead, the function should be used in an opaque manner.
+
+
+
+
+
+
+
+
+
+## Examples
+
+
+
+```javascript
+var resolve = require( '@stdlib/blas/base/diagonal-type-resolve-enum' );
+
+var v = resolve( 'non-unit' );
+// returns
+
+v = resolve( 'unit' );
+// returns
+```
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
diff --git a/lib/node_modules/@stdlib/blas/base/diagonal-type-resolve-enum/benchmark/benchmark.js b/lib/node_modules/@stdlib/blas/base/diagonal-type-resolve-enum/benchmark/benchmark.js
new file mode 100644
index 000000000000..e0aff4b8bd3e
--- /dev/null
+++ b/lib/node_modules/@stdlib/blas/base/diagonal-type-resolve-enum/benchmark/benchmark.js
@@ -0,0 +1,80 @@
+/**
+* @license Apache-2.0
+*
+* Copyright (c) 2024 The Stdlib Authors.
+*
+* Licensed under the Apache License, Version 2.0 (the "License");
+* you may not use this file except in compliance with the License.
+* You may obtain a copy of the License at
+*
+* http://www.apache.org/licenses/LICENSE-2.0
+*
+* Unless required by applicable law or agreed to in writing, software
+* distributed under the License is distributed on an "AS IS" BASIS,
+* WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+* See the License for the specific language governing permissions and
+* limitations under the License.
+*/
+
+'use strict';
+
+// MODULES //
+
+var bench = require( '@stdlib/bench' );
+var isInteger = require( '@stdlib/assert/is-integer' ).isPrimitive;
+var str2enum = require( '@stdlib/blas/base/diagonal-type-str2enum' );
+var pkg = require( './../package.json' ).name;
+var resolve = require( './../lib' );
+
+
+// MAIN //
+
+bench( pkg+'::string', function benchmark( b ) {
+ var values;
+ var out;
+ var i;
+
+ values = [
+ 'non-unit',
+ 'unit'
+ ];
+
+ b.tic();
+ for ( i = 0; i < b.iterations; i++ ) {
+ out = resolve( values[ i%values.length ] );
+ if ( typeof out !== 'number' ) {
+ b.fail( 'should return a number' );
+ }
+ }
+ b.toc();
+ if ( !isInteger( out ) ) {
+ b.fail( 'should return an integer' );
+ }
+ b.pass( 'benchmark finished' );
+ b.end();
+});
+
+bench( pkg+'::integer', function benchmark( b ) {
+ var values;
+ var out;
+ var i;
+
+ values = [
+ str2enum( 'non-unit' ),
+ str2enum( 'unit' )
+ ];
+
+ b.tic();
+ for ( i = 0; i < b.iterations; i++ ) {
+ out = resolve( values[ i%values.length ] );
+ if ( typeof out !== 'number' ) {
+ b.fail( 'should return a number' );
+ }
+ }
+ b.toc();
+ if ( !isInteger( out ) ) {
+ b.fail( 'should return an integer' );
+ }
+ b.pass( 'benchmark finished' );
+ b.end();
+});
diff --git a/lib/node_modules/@stdlib/blas/base/diagonal-type-resolve-enum/docs/repl.txt b/lib/node_modules/@stdlib/blas/base/diagonal-type-resolve-enum/docs/repl.txt
new file mode 100644
index 000000000000..869711e41274
--- /dev/null
+++ b/lib/node_modules/@stdlib/blas/base/diagonal-type-resolve-enum/docs/repl.txt
@@ -0,0 +1,29 @@
+
+{{alias}}( value )
+ Returns the enumeration constant associated with a supported BLAS diagonal
+ type value.
+
+ Downstream consumers of this function should *not* rely on specific integer
+ values (e.g., `UNIT == 0`). Instead, the function should be used in an
+ opaque manner.
+
+ Parameters
+ ----------
+ value: any
+ Diagonal type value.
+
+ Returns
+ -------
+ out: integer|null
+ Enumeration constant.
+
+ Examples
+ --------
+ > var out = {{alias}}( 'non-unit' )
+
+ > out = {{alias}}( {{alias:@stdlib/blas/base/diagonal-type-str2enum}}( 'non-unit' ) )
+
+
+ See Also
+ --------
+
diff --git a/lib/node_modules/@stdlib/blas/base/diagonal-type-resolve-enum/docs/types/index.d.ts b/lib/node_modules/@stdlib/blas/base/diagonal-type-resolve-enum/docs/types/index.d.ts
new file mode 100644
index 000000000000..772bc86ea3f3
--- /dev/null
+++ b/lib/node_modules/@stdlib/blas/base/diagonal-type-resolve-enum/docs/types/index.d.ts
@@ -0,0 +1,40 @@
+/*
+* @license Apache-2.0
+*
+* Copyright (c) 2024 The Stdlib Authors.
+*
+* Licensed under the Apache License, Version 2.0 (the "License");
+* you may not use this file except in compliance with the License.
+* You may obtain a copy of the License at
+*
+* http://www.apache.org/licenses/LICENSE-2.0
+*
+* Unless required by applicable law or agreed to in writing, software
+* distributed under the License is distributed on an "AS IS" BASIS,
+* WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+* See the License for the specific language governing permissions and
+* limitations under the License.
+*/
+
+// TypeScript Version: 4.1
+
+/**
+* Returns the enumeration constant associated with a BLAS diagonal type value.
+*
+* ## Notes
+*
+* - Downstream consumers of this function should **not** rely on specific integer values (e.g., `UNIT == 0`). Instead, the function should be used in an opaque manner.
+*
+* @param value - diagonal type value
+* @returns enumeration constant
+*
+* @example
+* var v = resolve( 'non-unit' );
+* // returns
+*/
+declare function resolve( value: any ): number | null;
+
+
+// EXPORTS //
+
+export = resolve;
diff --git a/lib/node_modules/@stdlib/blas/base/diagonal-type-resolve-enum/docs/types/test.ts b/lib/node_modules/@stdlib/blas/base/diagonal-type-resolve-enum/docs/types/test.ts
new file mode 100644
index 000000000000..f21cfd3a7aa5
--- /dev/null
+++ b/lib/node_modules/@stdlib/blas/base/diagonal-type-resolve-enum/docs/types/test.ts
@@ -0,0 +1,28 @@
+/*
+* @license Apache-2.0
+*
+* Copyright (c) 2024 The Stdlib Authors.
+*
+* Licensed under the Apache License, Version 2.0 (the "License");
+* you may not use this file except in compliance with the License.
+* You may obtain a copy of the License at
+*
+* http://www.apache.org/licenses/LICENSE-2.0
+*
+* Unless required by applicable law or agreed to in writing, software
+* distributed under the License is distributed on an "AS IS" BASIS,
+* WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+* See the License for the specific language governing permissions and
+* limitations under the License.
+*/
+
+import resolve = require( './index' );
+
+
+// TESTS //
+
+// The function returns a number or null...
+{
+ resolve( 0 ); // $ExpectType number | null
+ resolve( 'non-unit' ); // $ExpectType number | null
+}
diff --git a/lib/node_modules/@stdlib/blas/base/diagonal-type-resolve-enum/examples/index.js b/lib/node_modules/@stdlib/blas/base/diagonal-type-resolve-enum/examples/index.js
new file mode 100644
index 000000000000..37d6c43369db
--- /dev/null
+++ b/lib/node_modules/@stdlib/blas/base/diagonal-type-resolve-enum/examples/index.js
@@ -0,0 +1,29 @@
+/**
+* @license Apache-2.0
+*
+* Copyright (c) 2024 The Stdlib Authors.
+*
+* Licensed under the Apache License, Version 2.0 (the "License");
+* you may not use this file except in compliance with the License.
+* You may obtain a copy of the License at
+*
+* http://www.apache.org/licenses/LICENSE-2.0
+*
+* Unless required by applicable law or agreed to in writing, software
+* distributed under the License is distributed on an "AS IS" BASIS,
+* WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+* See the License for the specific language governing permissions and
+* limitations under the License.
+*/
+
+'use strict';
+
+var resolve = require( './../lib' );
+
+var v = resolve( 'non-unit' );
+console.log( v );
+// =>
+
+v = resolve( 'unit' );
+console.log( v );
+// =>
diff --git a/lib/node_modules/@stdlib/blas/base/diagonal-type-resolve-enum/lib/index.js b/lib/node_modules/@stdlib/blas/base/diagonal-type-resolve-enum/lib/index.js
new file mode 100644
index 000000000000..50f83068aa8f
--- /dev/null
+++ b/lib/node_modules/@stdlib/blas/base/diagonal-type-resolve-enum/lib/index.js
@@ -0,0 +1,40 @@
+/**
+* @license Apache-2.0
+*
+* Copyright (c) 2024 The Stdlib Authors.
+*
+* Licensed under the Apache License, Version 2.0 (the "License");
+* you may not use this file except in compliance with the License.
+* You may obtain a copy of the License at
+*
+* http://www.apache.org/licenses/LICENSE-2.0
+*
+* Unless required by applicable law or agreed to in writing, software
+* distributed under the License is distributed on an "AS IS" BASIS,
+* WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+* See the License for the specific language governing permissions and
+* limitations under the License.
+*/
+
+'use strict';
+
+/**
+* Return the enumeration constant associated with a supported BLAS diagonal type value.
+*
+* @module @stdlib/blas/base/diagonal-type-resolve-enum
+*
+* @example
+* var resolve = require( '@stdlib/blas/base/diagonal-type-resolve-enum' );
+*
+* var v = resolve( 'non-unit' );
+* // returns
+*/
+
+// MODULES //
+
+var main = require( './main.js' );
+
+
+// EXPORTS //
+
+module.exports = main;
diff --git a/lib/node_modules/@stdlib/blas/base/diagonal-type-resolve-enum/lib/main.js b/lib/node_modules/@stdlib/blas/base/diagonal-type-resolve-enum/lib/main.js
new file mode 100644
index 000000000000..43343ed4087f
--- /dev/null
+++ b/lib/node_modules/@stdlib/blas/base/diagonal-type-resolve-enum/lib/main.js
@@ -0,0 +1,57 @@
+/**
+* @license Apache-2.0
+*
+* Copyright (c) 2024 The Stdlib Authors.
+*
+* Licensed under the Apache License, Version 2.0 (the "License");
+* you may not use this file except in compliance with the License.
+* You may obtain a copy of the License at
+*
+* http://www.apache.org/licenses/LICENSE-2.0
+*
+* Unless required by applicable law or agreed to in writing, software
+* distributed under the License is distributed on an "AS IS" BASIS,
+* WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+* See the License for the specific language governing permissions and
+* limitations under the License.
+*/
+
+'use strict';
+
+// MODULES //
+
+var enum2str = require( '@stdlib/blas/base/diagonal-type-enum2str' );
+var str2enum = require( '@stdlib/blas/base/diagonal-type-str2enum' );
+
+
+// MAIN //
+
+/**
+* Returns the enumeration constant associated with a supported BLAS diagonal type value.
+*
+* ## Notes
+*
+* - Downstream consumers of this function should **not** rely on specific integer values (e.g., `UNIT == 0`). Instead, the function should be used in an opaque manner.
+*
+* @param {*} value - diagonal type value
+* @returns {(integer|null)} enumeration constant or null
+*
+* @example
+* var v = resolve( 'non-unit' );
+* // returns
+*/
+function resolve( value ) {
+ var t = ( typeof value );
+ if ( t === 'number' ) {
+ return ( enum2str( value ) ) ? value : null;
+ }
+ if ( t === 'string' ) {
+ return str2enum( value );
+ }
+ return null;
+}
+
+
+// EXPORTS //
+
+module.exports = resolve;
diff --git a/lib/node_modules/@stdlib/blas/base/diagonal-type-resolve-enum/package.json b/lib/node_modules/@stdlib/blas/base/diagonal-type-resolve-enum/package.json
new file mode 100644
index 000000000000..6439ebfa6210
--- /dev/null
+++ b/lib/node_modules/@stdlib/blas/base/diagonal-type-resolve-enum/package.json
@@ -0,0 +1,67 @@
+{
+ "name": "@stdlib/blas/base/diagonal-type-resolve-enum",
+ "version": "0.0.0",
+ "description": "Return the enumeration constant associated with a supported BLAS diagonal type value.",
+ "license": "Apache-2.0",
+ "author": {
+ "name": "The Stdlib Authors",
+ "url": "https://github.com/stdlib-js/stdlib/graphs/contributors"
+ },
+ "contributors": [
+ {
+ "name": "The Stdlib Authors",
+ "url": "https://github.com/stdlib-js/stdlib/graphs/contributors"
+ }
+ ],
+ "main": "./lib",
+ "directories": {
+ "benchmark": "./benchmark",
+ "doc": "./docs",
+ "example": "./examples",
+ "lib": "./lib",
+ "test": "./test"
+ },
+ "types": "./docs/types",
+ "scripts": {},
+ "homepage": "https://github.com/stdlib-js/stdlib",
+ "repository": {
+ "type": "git",
+ "url": "git://github.com/stdlib-js/stdlib.git"
+ },
+ "bugs": {
+ "url": "https://github.com/stdlib-js/stdlib/issues"
+ },
+ "dependencies": {},
+ "devDependencies": {},
+ "engines": {
+ "node": ">=0.10.0",
+ "npm": ">2.7.0"
+ },
+ "os": [
+ "aix",
+ "darwin",
+ "freebsd",
+ "linux",
+ "macos",
+ "openbsd",
+ "sunos",
+ "win32",
+ "windows"
+ ],
+ "keywords": [
+ "stdlib",
+ "blas",
+ "ndarray",
+ "matrix",
+ "diagonal",
+ "type",
+ "multidimensional",
+ "array",
+ "utilities",
+ "utility",
+ "utils",
+ "util",
+ "enum"
+ ],
+ "__stdlib__": {}
+}
diff --git a/lib/node_modules/@stdlib/blas/base/diagonal-type-resolve-enum/test/test.js b/lib/node_modules/@stdlib/blas/base/diagonal-type-resolve-enum/test/test.js
new file mode 100644
index 000000000000..0a519faa4744
--- /dev/null
+++ b/lib/node_modules/@stdlib/blas/base/diagonal-type-resolve-enum/test/test.js
@@ -0,0 +1,74 @@
+/**
+* @license Apache-2.0
+*
+* Copyright (c) 2024 The Stdlib Authors.
+*
+* Licensed under the Apache License, Version 2.0 (the "License");
+* you may not use this file except in compliance with the License.
+* You may obtain a copy of the License at
+*
+* http://www.apache.org/licenses/LICENSE-2.0
+*
+* Unless required by applicable law or agreed to in writing, software
+* distributed under the License is distributed on an "AS IS" BASIS,
+* WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+* See the License for the specific language governing permissions and
+* limitations under the License.
+*/
+
+'use strict';
+
+// MODULES //
+
+var tape = require( 'tape' );
+var str2enum = require( '@stdlib/blas/base/diagonal-type-str2enum' );
+var resolve = require( './../lib' );
+
+
+// VARIABLES //
+
+var VALUES = [
+ 'unit',
+ 'non-unit'
+];
+
+
+// TESTS //
+
+tape( 'main export is a function', function test( t ) {
+ t.ok( true, __filename );
+ t.strictEqual( typeof resolve, 'function', 'main export is a function' );
+ t.end();
+});
+
+tape( 'the function returns the enumeration constant associated with a BLAS diagonal type value', function test( t ) {
+ var v;
+ var i;
+ for ( i = 0; i < VALUES.length; i++ ) {
+ v = str2enum( VALUES[ i ] );
+ t.strictEqual( resolve( VALUES[ i ] ), v, 'returns expected value' );
+ t.strictEqual( resolve( v ), v, 'returns expected value' );
+ }
+ t.end();
+});
+
+tape( 'the function returns `null` if unable to resolve an enumeration constant', function test( t ) {
+ var values;
+ var i;
+
+ values = [
+ 'beep',
+ 'boop',
+ 'foo',
+ 'bar',
+ -99999999,
+ -9999999999,
+ -9999999999999,
+ true,
+ false
+ ];
+ for ( i = 0; i < values.length; i++ ) {
+ t.strictEqual( resolve( values[ i ] ), null, 'returns expected value' );
+ }
+ t.end();
+});
diff --git a/lib/node_modules/@stdlib/blas/base/diagonal-type-resolve-str/README.md b/lib/node_modules/@stdlib/blas/base/diagonal-type-resolve-str/README.md
new file mode 100644
index 000000000000..8d1f0fdfc3c4
--- /dev/null
+++ b/lib/node_modules/@stdlib/blas/base/diagonal-type-resolve-str/README.md
@@ -0,0 +1,121 @@
+
+
+# resolve
+
+> Return the diagonal type string associated with a supported BLAS diagonal type value.
+
+
+
+
+
+
+
+
+
+
+
+## Usage
+
+```javascript
+var resolve = require( '@stdlib/blas/base/diagonal-type-resolve-str' );
+```
+
+#### resolve( value )
+
+Returns the diagonal type string associated with a BLAS diagonal type value.
+
+```javascript
+var str2enum = require( '@stdlib/blas/base/diagonal-type-str2enum' );
+
+var v = resolve( 'unit' );
+// returns 'unit'
+
+v = resolve( str2enum( 'unit' ) );
+// returns 'unit'
+```
+
+If unable to resolve a diagonal type string, the function returns `null`.
+
+```javascript
+var v = resolve( 'beep' );
+// returns null
+```
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+## Examples
+
+
+
+```javascript
+var str2enum = require( '@stdlib/blas/base/diagonal-type-str2enum' );
+var resolve = require( '@stdlib/blas/base/diagonal-type-resolve-str' );
+
+var v = resolve( str2enum( 'unit' ) );
+// returns 'unit'
+
+v = resolve( str2enum( 'non-unit' ) );
+// returns 'non-unit'
+```
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
diff --git a/lib/node_modules/@stdlib/blas/base/diagonal-type-resolve-str/benchmark/benchmark.js b/lib/node_modules/@stdlib/blas/base/diagonal-type-resolve-str/benchmark/benchmark.js
new file mode 100644
index 000000000000..c6b8be8d66fe
--- /dev/null
+++ b/lib/node_modules/@stdlib/blas/base/diagonal-type-resolve-str/benchmark/benchmark.js
@@ -0,0 +1,80 @@
+/**
+* @license Apache-2.0
+*
+* Copyright (c) 2024 The Stdlib Authors.
+*
+* Licensed under the Apache License, Version 2.0 (the "License");
+* you may not use this file except in compliance with the License.
+* You may obtain a copy of the License at
+*
+* http://www.apache.org/licenses/LICENSE-2.0
+*
+* Unless required by applicable law or agreed to in writing, software
+* distributed under the License is distributed on an "AS IS" BASIS,
+* WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+* See the License for the specific language governing permissions and
+* limitations under the License.
+*/
+
+'use strict';
+
+// MODULES //
+
+var bench = require( '@stdlib/bench' );
+var isString = require( '@stdlib/assert/is-string' ).isPrimitive;
+var str2enum = require( '@stdlib/blas/base/diagonal-type-str2enum' );
+var pkg = require( './../package.json' ).name;
+var resolve = require( './../lib' );
+
+
+// MAIN //
+
+bench( pkg+'::string', function benchmark( b ) {
+ var values;
+ var out;
+ var i;
+
+ values = [
+ 'unit',
+ 'non-unit'
+ ];
+
+ b.tic();
+ for ( i = 0; i < b.iterations; i++ ) {
+ out = resolve( values[ i%values.length ] );
+ if ( typeof out !== 'string' ) {
+ b.fail( 'should return a string' );
+ }
+ }
+ b.toc();
+ if ( !isString( out ) ) {
+ b.fail( 'should return a string' );
+ }
+ b.pass( 'benchmark finished' );
+ b.end();
+});
+
+bench( pkg+'::integer', function benchmark( b ) {
+ var values;
+ var out;
+ var i;
+
+ values = [
+ str2enum( 'unit' ),
+ str2enum( 'non-unit' )
+ ];
+
+ b.tic();
+ for ( i = 0; i < b.iterations; i++ ) {
+ out = resolve( values[ i%values.length ] );
+ if ( typeof out !== 'string' ) {
+ b.fail( 'should return a string' );
+ }
+ }
+ b.toc();
+ if ( !isString( out ) ) {
+ b.fail( 'should return a string' );
+ }
+ b.pass( 'benchmark finished' );
+ b.end();
+});
diff --git a/lib/node_modules/@stdlib/blas/base/diagonal-type-resolve-str/docs/repl.txt b/lib/node_modules/@stdlib/blas/base/diagonal-type-resolve-str/docs/repl.txt
new file mode 100644
index 000000000000..1a69978271d1
--- /dev/null
+++ b/lib/node_modules/@stdlib/blas/base/diagonal-type-resolve-str/docs/repl.txt
@@ -0,0 +1,25 @@
+
+{{alias}}( value )
+ Returns the diagonal type string associated with a supported BLAS diagonal
+ type value.
+
+ Parameters
+ ----------
+ value: any
+ Diagonal type value.
+
+ Returns
+ -------
+ out: string|null
+ Diagonal type string.
+
+ Examples
+ --------
+ > var out = {{alias}}( 'unit' )
+ 'unit'
+ > out = {{alias}}( {{alias:@stdlib/blas/base/diagonal-type-str2enum}}( 'unit' ) )
+ 'unit'
+
+ See Also
+ --------
+
diff --git a/lib/node_modules/@stdlib/blas/base/diagonal-type-resolve-str/docs/types/index.d.ts b/lib/node_modules/@stdlib/blas/base/diagonal-type-resolve-str/docs/types/index.d.ts
new file mode 100644
index 000000000000..0ec594d62ae0
--- /dev/null
+++ b/lib/node_modules/@stdlib/blas/base/diagonal-type-resolve-str/docs/types/index.d.ts
@@ -0,0 +1,38 @@
+/*
+* @license Apache-2.0
+*
+* Copyright (c) 2024 The Stdlib Authors.
+*
+* Licensed under the Apache License, Version 2.0 (the "License");
+* you may not use this file except in compliance with the License.
+* You may obtain a copy of the License at
+*
+* http://www.apache.org/licenses/LICENSE-2.0
+*
+* Unless required by applicable law or agreed to in writing, software
+* distributed under the License is distributed on an "AS IS" BASIS,
+* WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+* See the License for the specific language governing permissions and
+* limitations under the License.
+*/
+
+// TypeScript Version: 4.1
+
+/**
+* Returns the diagonal type string associated with a BLAS diagonal type value.
+*
+* @param value - diagonal type value
+* @returns diagonal type string
+*
+* @example
+* var str2enum = require( '@stdlib/blas/base/diagonal-type-str2enum' );
+*
+* var v = resolve( str2enum( 'unit' ) );
+* // returns 'unit'
+*/
+declare function resolve( value: any ): string | null;
+
+
+// EXPORTS //
+
+export = resolve;
diff --git a/lib/node_modules/@stdlib/blas/base/diagonal-type-resolve-str/docs/types/test.ts b/lib/node_modules/@stdlib/blas/base/diagonal-type-resolve-str/docs/types/test.ts
new file mode 100644
index 000000000000..6aecf1e0ce7a
--- /dev/null
+++ b/lib/node_modules/@stdlib/blas/base/diagonal-type-resolve-str/docs/types/test.ts
@@ -0,0 +1,28 @@
+/*
+* @license Apache-2.0
+*
+* Copyright (c) 2024 The Stdlib Authors.
+*
+* Licensed under the Apache License, Version 2.0 (the "License");
+* you may not use this file except in compliance with the License.
+* You may obtain a copy of the License at
+*
+* http://www.apache.org/licenses/LICENSE-2.0
+*
+* Unless required by applicable law or agreed to in writing, software
+* distributed under the License is distributed on an "AS IS" BASIS,
+* WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+* See the License for the specific language governing permissions and
+* limitations under the License.
+*/
+
+import resolve = require( './index' );
+
+
+// TESTS //
+
+// The function returns a string or null...
+{
+ resolve( 0 ); // $ExpectType string | null
+ resolve( 'unit' ); // $ExpectType string | null
+}
diff --git a/lib/node_modules/@stdlib/blas/base/diagonal-type-resolve-str/examples/index.js b/lib/node_modules/@stdlib/blas/base/diagonal-type-resolve-str/examples/index.js
new file mode 100644
index 000000000000..1335af238562
--- /dev/null
+++ b/lib/node_modules/@stdlib/blas/base/diagonal-type-resolve-str/examples/index.js
@@ -0,0 +1,30 @@
+/**
+* @license Apache-2.0
+*
+* Copyright (c) 2024 The Stdlib Authors.
+*
+* Licensed under the Apache License, Version 2.0 (the "License");
+* you may not use this file except in compliance with the License.
+* You may obtain a copy of the License at
+*
+* http://www.apache.org/licenses/LICENSE-2.0
+*
+* Unless required by applicable law or agreed to in writing, software
+* distributed under the License is distributed on an "AS IS" BASIS,
+* WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+* See the License for the specific language governing permissions and
+* limitations under the License.
+*/
+
+'use strict';
+
+var str2enum = require( '@stdlib/blas/base/diagonal-type-str2enum' );
+var resolve = require( './../lib' );
+
+var v = resolve( str2enum( 'unit' ) );
+console.log( v );
+// => 'unit'
+
+v = resolve( str2enum( 'non-unit' ) );
+console.log( v );
+// => 'non-unit'
diff --git a/lib/node_modules/@stdlib/blas/base/diagonal-type-resolve-str/lib/index.js b/lib/node_modules/@stdlib/blas/base/diagonal-type-resolve-str/lib/index.js
new file mode 100644
index 000000000000..2e2c7bf6687c
--- /dev/null
+++ b/lib/node_modules/@stdlib/blas/base/diagonal-type-resolve-str/lib/index.js
@@ -0,0 +1,41 @@
+/**
+* @license Apache-2.0
+*
+* Copyright (c) 2024 The Stdlib Authors.
+*
+* Licensed under the Apache License, Version 2.0 (the "License");
+* you may not use this file except in compliance with the License.
+* You may obtain a copy of the License at
+*
+* http://www.apache.org/licenses/LICENSE-2.0
+*
+* Unless required by applicable law or agreed to in writing, software
+* distributed under the License is distributed on an "AS IS" BASIS,
+* WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+* See the License for the specific language governing permissions and
+* limitations under the License.
+*/
+
+'use strict';
+
+/**
+* Return the diagonal type string associated with a supported BLAS diagonal type value.
+*
+* @module @stdlib/blas/base/diagonal-type-resolve-str
+*
+* @example
+* var str2enum = require( '@stdlib/blas/base/diagonal-type-str2enum' );
+* var resolve = require( '@stdlib/blas/base/diagonal-type-resolve-str' );
+*
+* var v = resolve( str2enum( 'unit' ) );
+* // returns 'unit'
+*/
+
+// MODULES //
+
+var main = require( './main.js' );
+
+
+// EXPORTS //
+
+module.exports = main;
diff --git a/lib/node_modules/@stdlib/blas/base/diagonal-type-resolve-str/lib/main.js b/lib/node_modules/@stdlib/blas/base/diagonal-type-resolve-str/lib/main.js
new file mode 100644
index 000000000000..ac58402873a3
--- /dev/null
+++ b/lib/node_modules/@stdlib/blas/base/diagonal-type-resolve-str/lib/main.js
@@ -0,0 +1,55 @@
+/**
+* @license Apache-2.0
+*
+* Copyright (c) 2024 The Stdlib Authors.
+*
+* Licensed under the Apache License, Version 2.0 (the "License");
+* you may not use this file except in compliance with the License.
+* You may obtain a copy of the License at
+*
+* http://www.apache.org/licenses/LICENSE-2.0
+*
+* Unless required by applicable law or agreed to in writing, software
+* distributed under the License is distributed on an "AS IS" BASIS,
+* WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+* See the License for the specific language governing permissions and
+* limitations under the License.
+*/
+
+'use strict';
+
+// MODULES //
+
+var enum2str = require( '@stdlib/blas/base/diagonal-type-enum2str' );
+var str2enum = require( '@stdlib/blas/base/diagonal-type-str2enum' );
+
+
+// MAIN //
+
+/**
+* Returns the diagonal type string associated with a supported BLAS diagonal type value.
+*
+* @param {*} value - diagonal type value
+* @returns {(string|null)} diagonal type string or null
+*
+* @example
+* var str2enum = require( '@stdlib/blas/base/diagonal-type-str2enum' );
+*
+* var v = resolve( str2enum( 'unit' ) );
+* // returns 'unit'
+*/
+function resolve( value ) {
+ var t = ( typeof value );
+ if ( t === 'string' ) {
+ return ( str2enum( value ) === null ) ? null : value;
+ }
+ if ( t === 'number' ) {
+ return enum2str( value );
+ }
+ return null;
+}
+
+
+// EXPORTS //
+
+module.exports = resolve;
diff --git a/lib/node_modules/@stdlib/blas/base/diagonal-type-resolve-str/package.json b/lib/node_modules/@stdlib/blas/base/diagonal-type-resolve-str/package.json
new file mode 100644
index 000000000000..1a28bd32ce89
--- /dev/null
+++ b/lib/node_modules/@stdlib/blas/base/diagonal-type-resolve-str/package.json
@@ -0,0 +1,67 @@
+{
+ "name": "@stdlib/blas/base/diagonal-type-resolve-str",
+ "version": "0.0.0",
+ "description": "Return the diagonal type string associated with a supported BLAS diagonal type value.",
+ "license": "Apache-2.0",
+ "author": {
+ "name": "The Stdlib Authors",
+ "url": "https://github.com/stdlib-js/stdlib/graphs/contributors"
+ },
+ "contributors": [
+ {
+ "name": "The Stdlib Authors",
+ "url": "https://github.com/stdlib-js/stdlib/graphs/contributors"
+ }
+ ],
+ "main": "./lib",
+ "directories": {
+ "benchmark": "./benchmark",
+ "doc": "./docs",
+ "example": "./examples",
+ "lib": "./lib",
+ "test": "./test"
+ },
+ "types": "./docs/types",
+ "scripts": {},
+ "homepage": "https://github.com/stdlib-js/stdlib",
+ "repository": {
+ "type": "git",
+ "url": "git://github.com/stdlib-js/stdlib.git"
+ },
+ "bugs": {
+ "url": "https://github.com/stdlib-js/stdlib/issues"
+ },
+ "dependencies": {},
+ "devDependencies": {},
+ "engines": {
+ "node": ">=0.10.0",
+ "npm": ">2.7.0"
+ },
+ "os": [
+ "aix",
+ "darwin",
+ "freebsd",
+ "linux",
+ "macos",
+ "openbsd",
+ "sunos",
+ "win32",
+ "windows"
+ ],
+ "keywords": [
+ "stdlib",
+ "blas",
+ "ndarray",
+ "matrix",
+ "diagonal",
+ "type",
+ "multidimensional",
+ "array",
+ "utilities",
+ "utility",
+ "utils",
+ "util",
+ "enum"
+ ],
+ "__stdlib__": {}
+}
diff --git a/lib/node_modules/@stdlib/blas/base/diagonal-type-resolve-str/test/test.js b/lib/node_modules/@stdlib/blas/base/diagonal-type-resolve-str/test/test.js
new file mode 100644
index 000000000000..0612aa7c2b48
--- /dev/null
+++ b/lib/node_modules/@stdlib/blas/base/diagonal-type-resolve-str/test/test.js
@@ -0,0 +1,74 @@
+/**
+* @license Apache-2.0
+*
+* Copyright (c) 2024 The Stdlib Authors.
+*
+* Licensed under the Apache License, Version 2.0 (the "License");
+* you may not use this file except in compliance with the License.
+* You may obtain a copy of the License at
+*
+* http://www.apache.org/licenses/LICENSE-2.0
+*
+* Unless required by applicable law or agreed to in writing, software
+* distributed under the License is distributed on an "AS IS" BASIS,
+* WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+* See the License for the specific language governing permissions and
+* limitations under the License.
+*/
+
+'use strict';
+
+// MODULES //
+
+var tape = require( 'tape' );
+var str2enum = require( '@stdlib/blas/base/diagonal-type-str2enum' );
+var resolve = require( './../lib' );
+
+
+// VARIABLES //
+
+var VALUES = [
+ 'non-unit',
+ 'unit'
+];
+
+
+// TESTS //
+
+tape( 'main export is a function', function test( t ) {
+ t.ok( true, __filename );
+ t.strictEqual( typeof resolve, 'function', 'main export is a function' );
+ t.end();
+});
+
+tape( 'the function returns the diagonal type string associated with a BLAS diagonal type value', function test( t ) {
+ var v;
+ var i;
+ for ( i = 0; i < VALUES.length; i++ ) {
+ v = str2enum( VALUES[ i ] );
+ t.strictEqual( resolve( VALUES[ i ] ), VALUES[ i ], 'returns expected value' );
+ t.strictEqual( resolve( v ), VALUES[ i ], 'returns expected value' );
+ }
+ t.end();
+});
+
+tape( 'the function returns `null` if unable to resolve a diagonal type string', function test( t ) {
+ var values;
+ var i;
+
+ values = [
+ 'beep',
+ 'boop',
+ 'foo',
+ 'bar',
+ -99999999,
+ -9999999999,
+ -9999999999999,
+ true,
+ false
+ ];
+ for ( i = 0; i < values.length; i++ ) {
+ t.strictEqual( resolve( values[ i ] ), null, 'returns expected value' );
+ }
+ t.end();
+});
diff --git a/lib/node_modules/@stdlib/blas/base/diagonal-type-str2enum/README.md b/lib/node_modules/@stdlib/blas/base/diagonal-type-str2enum/README.md
new file mode 100644
index 000000000000..d571bd76d43c
--- /dev/null
+++ b/lib/node_modules/@stdlib/blas/base/diagonal-type-str2enum/README.md
@@ -0,0 +1,119 @@
+
+
+# str2enum
+
+> Return the enumeration constant associated with a BLAS diagonal type.
+
+
+
+
+
+
+
+
+
+
+
+## Usage
+
+```javascript
+var str2enum = require( '@stdlib/blas/base/diagonal-type-str2enum' );
+```
+
+#### str2enum( diagonal )
+
+Return the enumeration constant associated with a BLAS diagonal-type.
+
+```javascript
+var v = str2enum( 'unit' );
+// returns
+```
+
+If unable to resolve an enumeration constant, the function returns `null`.
+
+```javascript
+var v = str2enum( 'beep' );
+// returns null
+```
+
+
+
+
+
+
+
+
+
+## Notes
+
+- Downstream consumers of this function should **not** rely on specific integer values (e.g., `UNIT == 0`). Instead, the function should be used in an opaque manner.
+
+
+
+
+
+
+
+
+
+## Examples
+
+
+
+```javascript
+var str2enum = require( '@stdlib/blas/base/diagonal-type-str2enum' );
+
+var v = str2enum( 'unit' );
+// returns
+
+v = str2enum( 'non-unit' );
+// returns
+```
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
diff --git a/lib/node_modules/@stdlib/blas/base/diagonal-type-str2enum/benchmark/benchmark.js b/lib/node_modules/@stdlib/blas/base/diagonal-type-str2enum/benchmark/benchmark.js
new file mode 100644
index 000000000000..a5f36f392a5c
--- /dev/null
+++ b/lib/node_modules/@stdlib/blas/base/diagonal-type-str2enum/benchmark/benchmark.js
@@ -0,0 +1,54 @@
+/**
+* @license Apache-2.0
+*
+* Copyright (c) 2024 The Stdlib Authors.
+*
+* Licensed under the Apache License, Version 2.0 (the "License");
+* you may not use this file except in compliance with the License.
+* You may obtain a copy of the License at
+*
+* http://www.apache.org/licenses/LICENSE-2.0
+*
+* Unless required by applicable law or agreed to in writing, software
+* distributed under the License is distributed on an "AS IS" BASIS,
+* WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+* See the License for the specific language governing permissions and
+* limitations under the License.
+*/
+
+'use strict';
+
+// MODULES //
+
+var bench = require( '@stdlib/bench' );
+var isInteger = require( '@stdlib/assert/is-integer' ).isPrimitive;
+var pkg = require( './../package.json' ).name;
+var str2enum = require( './../lib' );
+
+
+// MAIN //
+
+bench( pkg, function benchmark( b ) {
+ var values;
+ var out;
+ var i;
+
+ values = [
+ 'unit',
+ 'non-unit'
+ ];
+
+ b.tic();
+ for ( i = 0; i < b.iterations; i++ ) {
+ out = str2enum( values[ i%values.length ] );
+ if ( typeof out !== 'number' ) {
+ b.fail( 'should return a number' );
+ }
+ }
+ b.toc();
+ if ( !isInteger( out ) ) {
+ b.fail( 'should return an integer' );
+ }
+ b.pass( 'benchmark finished' );
+ b.end();
+});
diff --git a/lib/node_modules/@stdlib/blas/base/diagonal-type-str2enum/docs/repl.txt b/lib/node_modules/@stdlib/blas/base/diagonal-type-str2enum/docs/repl.txt
new file mode 100644
index 000000000000..50ca896470c3
--- /dev/null
+++ b/lib/node_modules/@stdlib/blas/base/diagonal-type-str2enum/docs/repl.txt
@@ -0,0 +1,26 @@
+
+{{alias}}( diagonal )
+ Returns the enumeration constant associated with a BLAS diagonal type.
+
+ Downstream consumers of this function should *not* rely on specific integer
+ values (e.g., `UNIT == 0`). Instead, the function should be used in an
+ opaque manner.
+
+ Parameters
+ ----------
+ diagonal: string
+ Diagonal type.
+
+ Returns
+ -------
+ out: integer|null
+ Enumeration constant.
+
+ Examples
+ --------
+ > var out = {{alias}}( 'unit' )
+
+
+ See Also
+ --------
+
diff --git a/lib/node_modules/@stdlib/blas/base/diagonal-type-str2enum/docs/types/index.d.ts b/lib/node_modules/@stdlib/blas/base/diagonal-type-str2enum/docs/types/index.d.ts
new file mode 100644
index 000000000000..09f0bf7e8fb7
--- /dev/null
+++ b/lib/node_modules/@stdlib/blas/base/diagonal-type-str2enum/docs/types/index.d.ts
@@ -0,0 +1,40 @@
+/*
+* @license Apache-2.0
+*
+* Copyright (c) 2024 The Stdlib Authors.
+*
+* Licensed under the Apache License, Version 2.0 (the "License");
+* you may not use this file except in compliance with the License.
+* You may obtain a copy of the License at
+*
+* http://www.apache.org/licenses/LICENSE-2.0
+*
+* Unless required by applicable law or agreed to in writing, software
+* distributed under the License is distributed on an "AS IS" BASIS,
+* WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+* See the License for the specific language governing permissions and
+* limitations under the License.
+*/
+
+// TypeScript Version: 4.1
+
+/**
+* Returns the enumeration constant associated with a BLAS diagonal type.
+*
+* ## Notes
+*
+* - Downstream consumers of this function should **not** rely on specific integer values (e.g., `UNIT == 0`). Instead, the function should be used in an opaque manner.
+*
+* @param diagonal - diagonal type
+* @returns enumeration constant
+*
+* @example
+* var v = str2enum( 'unit' );
+* // returns
+*/
+declare function str2enum( diagonal: string ): number | null;
+
+
+// EXPORTS //
+
+export = str2enum;
diff --git a/lib/node_modules/@stdlib/blas/base/diagonal-type-str2enum/docs/types/test.ts b/lib/node_modules/@stdlib/blas/base/diagonal-type-str2enum/docs/types/test.ts
new file mode 100644
index 000000000000..08a2f61aa48e
--- /dev/null
+++ b/lib/node_modules/@stdlib/blas/base/diagonal-type-str2enum/docs/types/test.ts
@@ -0,0 +1,39 @@
+/*
+* @license Apache-2.0
+*
+* Copyright (c) 2024 The Stdlib Authors.
+*
+* Licensed under the Apache License, Version 2.0 (the "License");
+* you may not use this file except in compliance with the License.
+* You may obtain a copy of the License at
+*
+* http://www.apache.org/licenses/LICENSE-2.0
+*
+* Unless required by applicable law or agreed to in writing, software
+* distributed under the License is distributed on an "AS IS" BASIS,
+* WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+* See the License for the specific language governing permissions and
+* limitations under the License.
+*/
+
+import str2enum = require( './index' );
+
+
+// TESTS //
+
+// The function returns a number or null...
+{
+ str2enum( 'unit' ); // $ExpectType number | null
+}
+
+// The compiler throws an error if not provided a string...
+{
+ str2enum( 10 ); // $ExpectError
+ str2enum( true ); // $ExpectError
+ str2enum( false ); // $ExpectError
+ str2enum( null ); // $ExpectError
+ str2enum( undefined ); // $ExpectError
+ str2enum( [] ); // $ExpectError
+ str2enum( {} ); // $ExpectError
+ str2enum( ( x: number ): number => x ); // $ExpectError
+}
diff --git a/lib/node_modules/@stdlib/blas/base/diagonal-type-str2enum/examples/index.js b/lib/node_modules/@stdlib/blas/base/diagonal-type-str2enum/examples/index.js
new file mode 100644
index 000000000000..3107263c8a86
--- /dev/null
+++ b/lib/node_modules/@stdlib/blas/base/diagonal-type-str2enum/examples/index.js
@@ -0,0 +1,29 @@
+/**
+* @license Apache-2.0
+*
+* Copyright (c) 2024 The Stdlib Authors.
+*
+* Licensed under the Apache License, Version 2.0 (the "License");
+* you may not use this file except in compliance with the License.
+* You may obtain a copy of the License at
+*
+* http://www.apache.org/licenses/LICENSE-2.0
+*
+* Unless required by applicable law or agreed to in writing, software
+* distributed under the License is distributed on an "AS IS" BASIS,
+* WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+* See the License for the specific language governing permissions and
+* limitations under the License.
+*/
+
+'use strict';
+
+var str2enum = require( './../lib' );
+
+var v = str2enum( 'unit' );
+console.log( v );
+// =>
+
+v = str2enum( 'non-unit' );
+console.log( v );
+// =>
diff --git a/lib/node_modules/@stdlib/blas/base/diagonal-type-str2enum/lib/index.js b/lib/node_modules/@stdlib/blas/base/diagonal-type-str2enum/lib/index.js
new file mode 100644
index 000000000000..8c8be1876e4c
--- /dev/null
+++ b/lib/node_modules/@stdlib/blas/base/diagonal-type-str2enum/lib/index.js
@@ -0,0 +1,40 @@
+/**
+* @license Apache-2.0
+*
+* Copyright (c) 2024 The Stdlib Authors.
+*
+* Licensed under the Apache License, Version 2.0 (the "License");
+* you may not use this file except in compliance with the License.
+* You may obtain a copy of the License at
+*
+* http://www.apache.org/licenses/LICENSE-2.0
+*
+* Unless required by applicable law or agreed to in writing, software
+* distributed under the License is distributed on an "AS IS" BASIS,
+* WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+* See the License for the specific language governing permissions and
+* limitations under the License.
+*/
+
+'use strict';
+
+/**
+* Return the enumeration constant associated with a BLAS diagonal type.
+*
+* @module @stdlib/blas/base/diagonal-type-str2enum
+*
+* @example
+* var str2enum = require( '@stdlib/blas/base/diagonal-type-str2enum' );
+*
+* var v = str2enum( 'unit' );
+* // returns
+*/
+
+// MODULES //
+
+var main = require( './main.js' );
+
+
+// EXPORTS //
+
+module.exports = main;
diff --git a/lib/node_modules/@stdlib/blas/base/diagonal-type-str2enum/lib/main.js b/lib/node_modules/@stdlib/blas/base/diagonal-type-str2enum/lib/main.js
new file mode 100644
index 000000000000..14a0a3878f6b
--- /dev/null
+++ b/lib/node_modules/@stdlib/blas/base/diagonal-type-str2enum/lib/main.js
@@ -0,0 +1,55 @@
+/**
+* @license Apache-2.0
+*
+* Copyright (c) 2024 The Stdlib Authors.
+*
+* Licensed under the Apache License, Version 2.0 (the "License");
+* you may not use this file except in compliance with the License.
+* You may obtain a copy of the License at
+*
+* http://www.apache.org/licenses/LICENSE-2.0
+*
+* Unless required by applicable law or agreed to in writing, software
+* distributed under the License is distributed on an "AS IS" BASIS,
+* WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+* See the License for the specific language governing permissions and
+* limitations under the License.
+*/
+
+'use strict';
+
+// MODULES //
+
+var enumeration = require( '@stdlib/blas/base/diagonal-types' ).enum;
+
+
+// VARIABLES //
+
+var ENUM = enumeration();
+
+
+// MAIN //
+
+/**
+* Returns the enumeration constant associated with a BLAS diagonal type.
+*
+* ## Notes
+*
+* - Downstream consumers of this function should **not** rely on specific integer values (e.g., `UNIT == 0`). Instead, the function should be used in an opaque manner.
+*
+* @param {string} diagonal - diagonal type
+* @returns {(integer|null)} integer value or null
+*
+* @example
+* var v = str2enum( 'unit' );
+* // returns
+*/
+function str2enum( diagonal ) {
+ var v = ENUM[ diagonal ];
+ return ( typeof v === 'number' ) ? v : null; // note: we include this guard to prevent walking the prototype chain
+}
+
+
+// EXPORTS //
+
+module.exports = str2enum;
diff --git a/lib/node_modules/@stdlib/blas/base/diagonal-type-str2enum/package.json b/lib/node_modules/@stdlib/blas/base/diagonal-type-str2enum/package.json
new file mode 100644
index 000000000000..9e4208e776f8
--- /dev/null
+++ b/lib/node_modules/@stdlib/blas/base/diagonal-type-str2enum/package.json
@@ -0,0 +1,67 @@
+{
+ "name": "@stdlib/blas/base/diagonal-type-str2enum",
+ "version": "0.0.0",
+ "description": "Return the enumeration constant associated with a BLAS diagonal type.",
+ "license": "Apache-2.0",
+ "author": {
+ "name": "The Stdlib Authors",
+ "url": "https://github.com/stdlib-js/stdlib/graphs/contributors"
+ },
+ "contributors": [
+ {
+ "name": "The Stdlib Authors",
+ "url": "https://github.com/stdlib-js/stdlib/graphs/contributors"
+ }
+ ],
+ "main": "./lib",
+ "directories": {
+ "benchmark": "./benchmark",
+ "doc": "./docs",
+ "example": "./examples",
+ "lib": "./lib",
+ "test": "./test"
+ },
+ "types": "./docs/types",
+ "scripts": {},
+ "homepage": "https://github.com/stdlib-js/stdlib",
+ "repository": {
+ "type": "git",
+ "url": "git://github.com/stdlib-js/stdlib.git"
+ },
+ "bugs": {
+ "url": "https://github.com/stdlib-js/stdlib/issues"
+ },
+ "dependencies": {},
+ "devDependencies": {},
+ "engines": {
+ "node": ">=0.10.0",
+ "npm": ">2.7.0"
+ },
+ "os": [
+ "aix",
+ "darwin",
+ "freebsd",
+ "linux",
+ "macos",
+ "openbsd",
+ "sunos",
+ "win32",
+ "windows"
+ ],
+ "keywords": [
+ "stdlib",
+ "blas",
+ "ndarray",
+ "matrix",
+ "diagonal",
+ "type",
+ "multidimensional",
+ "array",
+ "utilities",
+ "utility",
+ "utils",
+ "util",
+ "enum"
+ ],
+ "__stdlib__": {}
+}
diff --git a/lib/node_modules/@stdlib/blas/base/diagonal-type-str2enum/test/test.js b/lib/node_modules/@stdlib/blas/base/diagonal-type-str2enum/test/test.js
new file mode 100644
index 000000000000..84f480b381f9
--- /dev/null
+++ b/lib/node_modules/@stdlib/blas/base/diagonal-type-str2enum/test/test.js
@@ -0,0 +1,66 @@
+/**
+* @license Apache-2.0
+*
+* Copyright (c) 2024 The Stdlib Authors.
+*
+* Licensed under the Apache License, Version 2.0 (the "License");
+* you may not use this file except in compliance with the License.
+* You may obtain a copy of the License at
+*
+* http://www.apache.org/licenses/LICENSE-2.0
+*
+* Unless required by applicable law or agreed to in writing, software
+* distributed under the License is distributed on an "AS IS" BASIS,
+* WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+* See the License for the specific language governing permissions and
+* limitations under the License.
+*/
+
+'use strict';
+
+// MODULES //
+
+var tape = require( 'tape' );
+var enum2str = require( '@stdlib/blas/base/diagonal-type-enum2str' );
+var str2enum = require( './../lib' );
+
+
+// VARIABLES //
+
+var VALUES = [
+ 'unit',
+ 'non-unit'
+];
+
+
+// TESTS //
+
+tape( 'main export is a function', function test( t ) {
+ t.ok( true, __filename );
+ t.strictEqual( typeof str2enum, 'function', 'main export is a function' );
+ t.end();
+});
+
+tape( 'the function returns the enumeration constant associated with a string', function test( t ) {
+ var i;
+ for ( i = 0; i < VALUES.length; i++ ) {
+ t.strictEqual( enum2str( str2enum( VALUES[ i ] ) ), VALUES[ i ], 'returns expected value' );
+ }
+ t.end();
+});
+
+tape( 'the function returns `null` if unable to resolve an enumeration constant', function test( t ) {
+ var values;
+ var i;
+
+ values = [
+ 'beep',
+ 'boop',
+ 'foo',
+ 'bar'
+ ];
+ for ( i = 0; i < values.length; i++ ) {
+ t.strictEqual( str2enum( values[ i ] ), null, 'returns expected value' );
+ }
+ t.end();
+});