docs: fix TSDoc return annotation values and example code

---
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: na
  - task: lint_javascript_src
    status: na
  - task: lint_javascript_cli
    status: na
  - task: lint_javascript_examples
    status: na
  - task: lint_javascript_tests
    status: na
  - 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: Planeshifter

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

@@ -54,7 +54,7 @@ import { ndarray } from '@stdlib/types/ndarray';
 * // returns [ 3, 2, 2 ]
 *
 * var out = broadcastArrays( [ x1, y1 ] );
-* // returns <ndarray>
+* // returns [ <ndarray>, <ndarray> ]
 *
 * var x2 = out[ 0 ];
 * // returns <ndarray>

lib/node_modules/@stdlib/ndarray/base/transpose/docs/types/index.d.ts

@@ -32,7 +32,8 @@ import { ndarray, float64ndarray, float32ndarray, int32ndarray, int16ndarray, in
 * var array = require( '@stdlib/ndarray/array' );
 *
 * var x = array( [ [ 1, 2, 3 ], [ 4, 5, 6 ] ], {
-*     'dtype': 'float64'
+*     'dtype': 'float64',
+*     'casting': 'unsafe'
 * });
 * // returns <ndarray>
 *
@@ -63,7 +64,8 @@ declare function transpose( x: float64ndarray ): float64ndarray;
 * var array = require( '@stdlib/ndarray/array' );
 *
 * var x = array( [ [ 1, 2, 3 ], [ 4, 5, 6 ] ], {
-*     'dtype': 'float32'
+*     'dtype': 'float32',
+*     'casting': 'unsafe'
 * });
 * // returns <ndarray>
 *
@@ -150,7 +152,8 @@ declare function transpose( x: complex64ndarray ): complex64ndarray;
 * var array = require( '@stdlib/ndarray/array' );
 *
 * var x = array( [ [ 1, 2, 3 ], [ 4, 5, 6 ] ], {
-*     'dtype': 'int32'
+*     'dtype': 'int32',
+*     'casting': 'unsafe'
 * });
 * // returns <ndarray>
 *
@@ -181,8 +184,9 @@ declare function transpose( x: int32ndarray ): int32ndarray;
 * var array = require( '@stdlib/ndarray/array' );
 *
 * var x = array( [ [ 1, 2, 3 ], [ 4, 5, 6 ] ], {
-*     'dtype': 'int16'
-* });
+*     'dtype': 'int16',
+*     'casting': 'unsafe'
+*  });
 * // returns <ndarray>
 *
 * var sh = x.shape;
@@ -212,7 +216,8 @@ declare function transpose( x: int16ndarray ): int16ndarray;
 * var array = require( '@stdlib/ndarray/array' );
 *
 * var x = array( [ [ 1, 2, 3 ], [ 4, 5, 6 ] ], {
-*     'dtype': 'int8'
+*     'dtype': 'int8',
+*     'casting': 'unsafe'
 * });
 * // returns <ndarray>
 *
@@ -243,7 +248,8 @@ declare function transpose( x: int8ndarray ): int8ndarray;
 * var array = require( '@stdlib/ndarray/array' );
 *
 * var x = array( [ [ 1, 2, 3 ], [ 4, 5, 6 ] ], {
-*     'dtype': 'uint32'
+*     'dtype': 'uint32',
+*     'casting': 'unsafe'
 * });
 * // returns <ndarray>
 *
@@ -274,7 +280,8 @@ declare function transpose( x: uint32ndarray ): uint32ndarray;
 * var array = require( '@stdlib/ndarray/array' );
 *
 * var x = array( [ [ 1, 2, 3 ], [ 4, 5, 6 ] ], {
-*     'dtype': 'uint16'
+*     'dtype': 'uint16',
+*     'casting': 'unsafe'
 * });
 * // returns <ndarray>
 *
@@ -305,7 +312,8 @@ declare function transpose( x: uint16ndarray ): uint16ndarray;
 * var array = require( '@stdlib/ndarray/array' );
 *
 * var x = array( [ [ 1, 2, 3 ], [ 4, 5, 6 ] ], {
-*     'dtype': 'uint8'
+*     'dtype': 'uint8',
+*     'casting': 'unsafe'
 * });
 * // returns <ndarray>
 *
@@ -336,7 +344,8 @@ declare function transpose( x: uint8ndarray ): uint8ndarray;
 * var array = require( '@stdlib/ndarray/array' );
 *
 * var x = array( [ [ 1, 2, 3 ], [ 4, 5, 6 ] ], {
-*     'dtype': 'uint8c'
+*     'dtype': 'uint8c',
+*     'casting': 'unsafe'
 * });
 * // returns <ndarray>
 *

lib/node_modules/@stdlib/ndarray/from-scalar/docs/types/index.d.ts

@@ -330,7 +330,7 @@ declare function scalar2ndarray( value: boolean, options: BoolOptions ): boolnda
 * @example
 * var x = scalar2ndarray( 1, {
 *     'dtype': 'int32'
-* };
+* });
 * // returns <ndarray>
 *
 * var sh = x.shape;
@@ -353,8 +353,8 @@ declare function scalar2ndarray( value: number, options: Int32Options ): int32nd
 *
 * @example
 * var x = scalar2ndarray( 1, {
-*     'dtype': int16'
-* };
+*     'dtype': 'int16'
+* });
 * // returns <ndarray>
 *
 * var sh = x.shape;
@@ -450,7 +450,7 @@ declare function scalar2ndarray( value: number, options: Uint16Options ): uint16
 * @example
 * var x = scalar2ndarray( 1, {
 *     'dtype': 'uint8'
-* };
+* });
 * // returns <ndarray>
 *
 * var sh = x.shape;
@@ -473,7 +473,7 @@ declare function scalar2ndarray( value: number, options: Uint8Options ): uint8nd
 *
 * @example
 * var x = scalar2ndarray( 1, {
-*     'dtype': uint8c'
+*     'dtype': 'uint8c'
 * });
 * // returns <ndarray>
 *

lib/node_modules/@stdlib/ndarray/slice-assign/docs/types/index.d.ts

@@ -328,7 +328,6 @@ declare function sliceAssign<T = unknown, U = unknown>( x: typedndarray<T>, y: g
 * var s0 = null;
 * var s1 = new Slice( null, null, -1 );
 * var s2 = new Slice( null, null, -1 );
-* // returns <MultiSlice>
 *
 * // Perform assignment:
 * var out = sliceAssign( x, y, [ s0, s1, s2 ] );
@@ -386,7 +385,6 @@ declare function sliceAssign<T = unknown, U = unknown>( x: typedndarray<T>, y: g
 * var s0 = null;
 * var s1 = new Slice( null, null, -1 );
 * var s2 = new Slice( null, null, -1 );
-* // returns <MultiSlice>
 *
 * // Perform assignment:
 * var out = sliceAssign( x, y, s0, s1, s2 );

lib/node_modules/@stdlib/ndarray/slice-assign/docs/types/test.ts

@@ -115,7 +115,7 @@ import sliceAssign = require( './index' );
 	sliceAssign( null, y, s ); // $ExpectError
 	sliceAssign( [], y, s ); // $ExpectError
 	sliceAssign( {}, y, s ); // $ExpectError
-	sliceAssign( ( x: number ): number => y, y, s ); // $ExpectError
+	sliceAssign( (): number => y, y, s ); // $ExpectError
 
 	sliceAssign( '10', y, s, {} ); // $ExpectError
 	sliceAssign( 10, y, s, {} ); // $ExpectError

lib/node_modules/@stdlib/ndarray/vector/ctor/docs/types/index.d.ts

@@ -578,7 +578,7 @@ interface Vector {
 	* // returns <ndarray>
 	*
 	* var len = numel( arr );
-	* // returns 2
+	* // returns 1
 	*
 	* var dt = getDType( arr );
 	* // returns 'float64'