test: use accessors for retrieving ndarray meta data

---
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: passed
  - 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: passed
  - 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: passed
  - task: lint_license_headers
    status: passed
---

Author: kgryte

lib/node_modules/@stdlib/ndarray/base/maybe-broadcast-array/README.md

@@ -47,13 +47,13 @@ Broadcasts an [ndarray][@stdlib/ndarray/base/ctor] to a specified `shape` if and
 ```javascript
 var array = require( '@stdlib/ndarray/array' );
 
-// Create a 2x2 ndarray:
-var x = array( [ [ 1, 2 ], [ 3, 4 ] ] );
-// returns <ndarray>
+// Create a 1x2 ndarray:
+var x = array( [ [ 1, 2 ] ] );
+// returns <ndarray>[ [ 1, 2 ] ]
 
 // Broadcast to a 2x2x2 ndarray:
 var y = maybeBroadcastArray( x, [ 2, 2, 2 ] );
-// returns <ndarray>
+// returns <ndarray>[ [ [ 1, 2 ], [ 1, 2 ] ], [ [ 1, 2 ], [ 1, 2 ] ] ]
 ```
 
 </section>
@@ -85,30 +85,16 @@ var y = maybeBroadcastArray( x, [ 2, 2, 2 ] );
 
 ```javascript
 var array = require( '@stdlib/ndarray/array' );
-var numel = require( '@stdlib/ndarray/base/numel' );
-var ind2sub = require( '@stdlib/ndarray/ind2sub' );
+var ndarray2array = require( '@stdlib/ndarray/to-array' );
 var maybeBroadcastArray = require( '@stdlib/ndarray/base/maybe-broadcast-array' );
 
 // Create a 2x2 array:
 var x = array( [ [ 1, 2 ], [ 3, 4 ] ] );
-// returns <ndarray>
+// returns <ndarray>[ [ 1, 2 ], [ 3, 4 ] ]
 
 // Broadcast the array to 3x2x2:
 var y = maybeBroadcastArray( x, [ 3, 2, 2 ] );
-// returns <ndarray>
-
-// Retrieve the shape:
-var sh = y.shape;
-// returns [ 3, 2, 2 ]
-
-// Retrieve the number of elements:
-var N = numel( sh );
-
-// Loop through the array elements...
-var i;
-for ( i = 0; i < N; i++ ) {
-    console.log( 'Y[%s] = %d', ind2sub( sh, i ).join( ', ' ), y.iget( i ) );
-}
+// returns <ndarray>[ [ [ 1, 2 ], [ 3, 4 ] ], [ [ 1, 2 ], [ 3, 4 ] ], [ [ 1, 2 ], [ 3, 4 ] ] ]
 ```
 
 </section>

lib/node_modules/@stdlib/ndarray/base/maybe-broadcast-array/docs/repl.txt

@@ -39,29 +39,9 @@
     Examples
     --------
     > var x = {{alias:@stdlib/ndarray/array}}( [ [ 1, 2 ], [ 3, 4 ] ] )
-    <ndarray>
-    > var sh = x.shape
-    [ 2, 2 ]
+    <ndarray>[ [1,2], [3,4] ]
     > var y = {{alias}}( x, [ 3, 2, 2 ] )
-    <ndarray>
-    > sh = y.shape
-    [ 3, 2, 2 ]
-    > var v = y.get( 0, 0, 0 )
-    1
-    > v = y.get( 0, 0, 1 )
-    2
-    > v = y.get( 0, 1, 0 )
-    3
-    > v = y.get( 0, 1, 1 )
-    4
-    > v = y.get( 1, 0, 0 )
-    1
-    > v = y.get( 1, 1, 0 )
-    3
-    > v = y.get( 2, 0, 0 )
-    1
-    > v = y.get( 2, 1, 1 )
-    4
+    <ndarray>[ [ [1,2], [3,4] ], [ [1,2], [3,4] ], [ [1,2], [3,4] ] ]
 
     See Also
     --------

lib/node_modules/@stdlib/ndarray/base/maybe-broadcast-array/docs/types/index.d.ts

@@ -41,39 +41,22 @@ import { ndarray } from '@stdlib/types/ndarray';
 * @returns broadcasted array
 *
 * @example
+* var getShape = require( '@stdlib/ndarray/shape' );
 * var array = require( '@stdlib/ndarray/array' );
 *
 * var x = array( [ [ 1, 2 ], [ 3, 4 ] ] );
-* // returns <ndarray>
+* // returns <ndarray>[ [ 1, 2 ], [ 3, 4 ] ]
 *
-* var shx = x.shape;
+* var shx = getShape( x );
 * // returns [ 2, 2 ]
 *
 * var y = maybeBroadcastArray( x, [ 3, 2, 2 ] );
-* // returns <ndarray>
+* // returns <ndarray>[ [ [ 1, 2 ], [ 3, 4 ] ], [ [ 1, 2 ], [ 3, 4 ] ], [ [ 1, 2 ], [ 3, 4 ] ] ]
 *
-* var shy = y.shape;
+* var shy = getShape( y );
 * // returns [ 3, 2, 2 ]
-*
-* var v = y.get( 0, 0, 0 );
-* // returns 1
-*
-* v = y.get( 0, 0, 1 );
-* // returns 2
-*
-* v = y.get( 1, 0, 0 );
-* // returns 1
-*
-* v = y.get( 1, 1, 0 );
-* // returns 3
-*
-* v = y.get( 2, 0, 0 );
-* // returns 1
-*
-* v = y.get( 2, 1, 1 );
-* // returns 4
 */
-declare function maybeBroadcastArray( arr: ndarray, shape: ArrayLike<number> ): ndarray;
+declare function maybeBroadcastArray<T extends ndarray>( arr: T, shape: ArrayLike<number> ): T;
 
 
 // EXPORTS //

lib/node_modules/@stdlib/ndarray/base/maybe-broadcast-array/docs/types/test.ts

@@ -16,46 +16,23 @@
 * limitations under the License.
 */
 
+/* eslint-disable space-in-parens */
+
 /// <reference types="@stdlib/types"/>
 
-import { ndarray } from '@stdlib/types/ndarray';
+import zeros = require( '@stdlib/ndarray/zeros' );
 import maybeBroadcastArray = require( './index' );
 
-/**
-* Mock function to create an ndarray-like object.
-*
-* @returns ndarray-like object
-*/
-function array(): ndarray {
-	const obj: ndarray = {
-		'byteLength': 80,
-		'BYTES_PER_ELEMENT': 8,
-		'data': new Float64Array( 10 ),
-		'dtype': 'float64',
-		'flags': {
-			'ROW_MAJOR_CONTIGUOUS': true,
-			'COLUMN_MAJOR_CONTIGUOUS': false
-		},
-		'length': 10,
-		'ndims': 1,
-		'offset': 0,
-		'order': 'row-major',
-		'shape': [ 10 ],
-		'strides': [ 1 ],
-		'get': (): number => 0,
-		'set': (): ndarray => obj
-	};
-	return obj;
-}
-
 
 // TESTS //
 
 // The function returns an ndarray...
 {
-	const x = array();
+	const x = zeros( [ 2, 2 ], {
+		'dtype': 'float64'
+	});
 
-	maybeBroadcastArray( x, [ 2, 2, 2 ] ); // $ExpectType ndarray
+	maybeBroadcastArray( x, [ 2, 2, 2 ] ); // $ExpectType float64ndarray
 }
 
 // The compiler throws an error if the function is not provided a first argument which is an ndarray...
@@ -72,7 +49,9 @@ function array(): ndarray {
 
 // The compiler throws an error if the function is not provided a second argument which is an array-like object containing numbers...
 {
-	const x = array();
+	const x = zeros( [ 2, 2 ], {
+		'dtype': 'float64'
+	});
 
 	maybeBroadcastArray( x, '5' ); // $ExpectError
 	maybeBroadcastArray( x, 5 ); // $ExpectError
@@ -86,7 +65,9 @@ function array(): ndarray {
 
 // The compiler throws an error if the function is provided an unsupported number of arguments...
 {
-	const x = array();
+	const x = zeros( [ 2, 2 ], {
+		'dtype': 'float64'
+	});
 
 	maybeBroadcastArray(); // $ExpectError
 	maybeBroadcastArray( x ); // $ExpectError

lib/node_modules/@stdlib/ndarray/base/maybe-broadcast-array/examples/index.js

@@ -19,27 +19,13 @@
 'use strict';
 
 var array = require( '@stdlib/ndarray/array' );
-var numel = require( '@stdlib/ndarray/base/numel' );
-var ind2sub = require( '@stdlib/ndarray/ind2sub' );
+var ndarray2array = require( '@stdlib/ndarray/to-array' );
 var maybeBroadcastArray = require( './../lib' );
 
 // Create a 2x2 array:
 var x = array( [ [ 1, 2 ], [ 3, 4 ] ] );
-// returns <ndarray>
+console.log( ndarray2array( x ) );
 
 // Broadcast the array to 3x2x2:
 var y = maybeBroadcastArray( x, [ 3, 2, 2 ] );
-// returns <ndarray>
-
-// Retrieve the shape:
-var sh = y.shape;
-// returns [ 3, 2, 2 ]
-
-// Retrieve the number of elements:
-var N = numel( sh );
-
-// Loop through the array elements...
-var i;
-for ( i = 0; i < N; i++ ) {
-	console.log( 'Y[%s] = %d', ind2sub( sh, i ).join( ', ' ), y.iget( i ) );
-}
+console.log( ndarray2array( y ) );

lib/node_modules/@stdlib/ndarray/base/maybe-broadcast-array/lib/index.js

@@ -24,38 +24,21 @@
 * @module @stdlib/ndarray/base/maybe-broadcast-array
 *
 * @example
+* var getShape = require( '@stdlib/ndarray/shape' );
 * var array = require( '@stdlib/ndarray/array' );
 * var maybeBroadcastArray = require( '@stdlib/ndarray/base/maybe-broadcast-array' );
 *
 * var x = array( [ [ 1, 2 ], [ 3, 4 ] ] );
-* // returns <ndarray>
+* // returns <ndarray>[ [ 1, 2 ], [ 3, 4 ] ]
 *
-* var shx = x.shape;
+* var shx = getShape( x );
 * // returns [ 2, 2 ]
 *
 * var y = maybeBroadcastArray( x, [ 3, 2, 2 ] );
-* // returns <ndarray>
+* // returns <ndarray>[ [ [ 1, 2 ], [ 3, 4 ] ], [ [ 1, 2 ], [ 3, 4 ] ], [ [ 1, 2 ], [ 3, 4 ] ] ]
 *
-* var shy = y.shape;
+* var shy = getShape( y );
 * // returns [ 3, 2, 2 ]
-*
-* var v = y.get( 0, 0, 0 );
-* // returns 1
-*
-* v = y.get( 0, 0, 1 );
-* // returns 2
-*
-* v = y.get( 1, 0, 0 );
-* // returns 1
-*
-* v = y.get( 1, 1, 0 );
-* // returns 3
-*
-* v = y.get( 2, 0, 0 );
-* // returns 1
-*
-* v = y.get( 2, 1, 1 );
-* // returns 4
 */
 
 // MODULES //

lib/node_modules/@stdlib/ndarray/base/maybe-broadcast-array/lib/main.js

@@ -42,38 +42,22 @@ var getShape = require( '@stdlib/ndarray/base/shape' );
 * @returns {ndarray} broadcasted array
 *
 * @example
+* var getShape = require( '@stdlib/ndarray/shape' );
 * var array = require( '@stdlib/ndarray/array' );
+* var maybeBroadcastArray = require( '@stdlib/ndarray/base/maybe-broadcast-array' );
 *
 * var x = array( [ [ 1, 2 ], [ 3, 4 ] ] );
-* // returns <ndarray>
+* // returns <ndarray>[ [ 1, 2 ], [ 3, 4 ] ]
 *
-* var shx = x.shape;
+* var shx = getShape( x );
 * // returns [ 2, 2 ]
 *
 * var y = maybeBroadcastArray( x, [ 3, 2, 2 ] );
-* // returns <ndarray>
+* // returns <ndarray>[ [ [ 1, 2 ], [ 3, 4 ] ], [ [ 1, 2 ], [ 3, 4 ] ], [ [ 1, 2 ], [ 3, 4 ] ] ]
 *
-* var shy = y.shape;
+* var shy = getShape( y );
 * // returns [ 3, 2, 2 ]
 *
-* var v = y.get( 0, 0, 0 );
-* // returns 1
-*
-* v = y.get( 0, 0, 1 );
-* // returns 2
-*
-* v = y.get( 1, 0, 0 );
-* // returns 1
-*
-* v = y.get( 1, 1, 0 );
-* // returns 3
-*
-* v = y.get( 2, 0, 0 );
-* // returns 1
-*
-* v = y.get( 2, 1, 1 );
-* // returns 4
-*
 * @example
 * var array = require( '@stdlib/ndarray/array' );
 *