refactor: apply suggestions from code review

---
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: na
  - task: lint_javascript_cli
    status: na
  - task: lint_javascript_examples
    status: na
  - task: lint_javascript_tests
    status: passed
  - task: lint_javascript_benchmarks
    status: passed
  - 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: headlessNode

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

@@ -42,7 +42,7 @@ limitations under the License.
 var broadcastArrayExceptDimensions = require( '@stdlib/ndarray/base/broadcast-array-except-dimensions' );
 ```
 
-#### broadcastArrayExceptDimensions( arr, shape\[, dims] )
+#### broadcastArrayExceptDimensions( arr, shape, dims )
 
 Broadcast an input [ndarray][@stdlib/ndarray/base/ctor] to a target shape keeping the specified dimensions unchanged.
 
@@ -54,7 +54,7 @@ var x = array( [ [ 1, 2 ], [ 3, 4 ] ] );
 // returns <ndarray>
 
 // Perform broadcasting:
-var y = broadcastArrayExceptDimensions( x, [ 3, 2, 2 ] );
+var y = broadcastArrayExceptDimensions( x, [ 3, 2, 2 ], [ -1 ] );
 // returns <ndarray>
 
 var ysh = y.shape;
@@ -65,24 +65,7 @@ The function accepts the following arguments:
 
 -   **arr**: input ndarray.
 -   **shape**: target shape.
--   **dims**: list of dimensions which are exculded from broadcasting. Default: `[ -1 ]` (_optional_).
-
-To exclude specific dimensions from broadcasting, provide a `dims` parameter.
-
-```javascript
-var array = require( '@stdlib/ndarray/array' );
-
-// Create a 2x2 ndarray:
-var x = array( [ [ 1, 2 ], [ 3, 4 ] ] );
-// returns <ndarray>
-
-// Perform broadcasting:
-var y = broadcastArrayExceptDimensions( x, [ 3, 2, 2 ], [ -2 ] );
-// returns <ndarray>
-
-var ysh = y.shape;
-// returns [ 3, 2, 2 ]
-```
+-   **dims**: list of dimensions which are exculded from broadcasting.
 
 </section>
 

lib/node_modules/@stdlib/ndarray/base/broadcast-array-except-dimensions/benchmark/benchmark.js

@@ -59,7 +59,7 @@ bench( pkg+'::base_ndarray,2d', function benchmark( b ) {
 
 	b.tic();
 	for ( i = 0; i < b.iterations; i++ ) {
-		out = broadcastArrayExceptDimensions( values[ i%values.length ], [ 2, 2, 2 ] );
+		out = broadcastArrayExceptDimensions( values[ i%values.length ], [ 2, 2, 2 ], [ -1 ] );
 		if ( typeof out !== 'object' ) {
 			b.fail( 'should return an object' );
 		}
@@ -100,7 +100,7 @@ bench( pkg+'::ndarray,2d', function benchmark( b ) {
 
 	b.tic();
 	for ( i = 0; i < b.iterations; i++ ) {
-		out = broadcastArrayExceptDimensions( values[ i%values.length ], [ 2, 2, 2 ] );
+		out = broadcastArrayExceptDimensions( values[ i%values.length ], [ 2, 2, 2 ], [ -1 ] );
 		if ( typeof out !== 'object' ) {
 			b.fail( 'should return an object' );
 		}
@@ -147,7 +147,7 @@ bench( pkg+'::ndarray_like,2d', function benchmark( b ) {
 
 	b.tic();
 	for ( i = 0; i < b.iterations; i++ ) {
-		out = broadcastArrayExceptDimensions( values[ i%values.length ], [ 2, 2, 2 ] );
+		out = broadcastArrayExceptDimensions( values[ i%values.length ], [ 2, 2, 2 ], [ -2 ] );
 		if ( typeof out !== 'object' ) {
 			b.fail( 'should return an object' );
 		}

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

@@ -1,5 +1,5 @@
 
-{{alias}}( arr, shape[, dims] )
+{{alias}}( arr, shape, dims )
     Broadcasts an input ndarray to a target shape keeping the specified
     dimensions unchanged.
 
@@ -23,7 +23,7 @@
     shape: ArrayLikeObject
         Desired shape.
 
-    dims: Array<integer> (optional)
+    dims: Array<integer>
         List of dimensions to exclude from broadcasting.
 
     Returns

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

@@ -75,7 +75,7 @@ import { ndarray } from '@stdlib/types/ndarray';
 * v = y.get( 1, 0, 2 );
 * // returns 3
 */
-declare function broadcastArrayExceptDimensions( arr: ndarray, shape: ArrayLike<number>, dims?: ArrayLike<number> ): ndarray;
+declare function broadcastArrayExceptDimensions( arr: ndarray, shape: ArrayLike<number>, dims: ArrayLike<number> ): ndarray;
 
 
 // EXPORTS //

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

@@ -55,21 +55,11 @@ function array(): ndarray {
 {
 	const x = array();
 
-	broadcastArrayExceptDimensions( x, [ 2, 2, 2 ] ); // $ExpectType ndarray
 	broadcastArrayExceptDimensions( x, [ 2, 2, 2 ], [ -2 ] ); // $ExpectType ndarray
 }
 
 // The compiler throws an error if the function is not provided a first argument which is an ndarray...
 {
-	broadcastArrayExceptDimensions( '5', [ 2, 2, 2 ] ); // $ExpectError
-	broadcastArrayExceptDimensions( 5, [ 2, 2, 2 ] ); // $ExpectError
-	broadcastArrayExceptDimensions( true, [ 2, 2, 2 ] ); // $ExpectError
-	broadcastArrayExceptDimensions( false, [ 2, 2, 2 ] ); // $ExpectError
-	broadcastArrayExceptDimensions( null, [ 2, 2, 2 ] ); // $ExpectError
-	broadcastArrayExceptDimensions( {}, [ 2, 2, 2 ] ); // $ExpectError
-	broadcastArrayExceptDimensions( [ '5' ], [ 2, 2, 2 ] ); // $ExpectError
-	broadcastArrayExceptDimensions( ( x: number ): number => x, [ 2, 2, 2 ] ); // $ExpectError
-
 	broadcastArrayExceptDimensions( '5', [ 2, 2, 2 ], [ -2 ] ); // $ExpectError
 	broadcastArrayExceptDimensions( 5, [ 2, 2, 2 ], [ -2 ] ); // $ExpectError
 	broadcastArrayExceptDimensions( true, [ 2, 2, 2 ], [ -2 ] ); // $ExpectError
@@ -84,15 +74,6 @@ function array(): ndarray {
 {
 	const x = array();
 
-	broadcastArrayExceptDimensions( x, '5' ); // $ExpectError
-	broadcastArrayExceptDimensions( x, 5 ); // $ExpectError
-	broadcastArrayExceptDimensions( x, true ); // $ExpectError
-	broadcastArrayExceptDimensions( x, false ); // $ExpectError
-	broadcastArrayExceptDimensions( x, null ); // $ExpectError
-	broadcastArrayExceptDimensions( x, {} ); // $ExpectError
-	broadcastArrayExceptDimensions( x, [ '5' ] ); // $ExpectError
-	broadcastArrayExceptDimensions( x, ( x: number ): number => x ); // $ExpectError
-
 	broadcastArrayExceptDimensions( x, '5', [ -2 ] ); // $ExpectError
 	broadcastArrayExceptDimensions( x, 5, [ -2 ] ); // $ExpectError
 	broadcastArrayExceptDimensions( x, true, [ -2 ] ); // $ExpectError