chore: modernize examples and benchmarks

---
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: na
  - 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: kgryte

lib/node_modules/@stdlib/blas/base/ndarray/zcopy/README.md

@@ -41,14 +41,10 @@ var zcopy = require( '@stdlib/blas/base/ndarray/zcopy' );
 Copies values from a one-dimensional double-precision complex floating-point ndarray `x` into a one-dimensional double-precision complex floating-point ndarray `y`.
 
 ```javascript
-var Complex128Array = require( '@stdlib/array/complex128' );
-var ndarray = require( '@stdlib/ndarray/base/ctor' );
+var Complex128Vector = require( '@stdlib/ndarray/vector/complex128' );
 
-var xbuf = new Complex128Array( [ 1.0, 2.0, 3.0, 4.0, 5.0, 6.0 ] );
-var x = new ndarray( 'complex128', xbuf, [ 3 ], [ 1 ], 0, 'row-major' );
-
-var ybuf = new Complex128Array( [ 0.0, 0.0, 0.0, 0.0, 0.0, 0.0 ] );
-var y = new ndarray( 'complex128', ybuf, [ 3 ], [ 1 ], 0, 'row-major' );
+var x = new Complex128Vector( [ 1.0, 2.0, 3.0, 4.0, 5.0, 6.0 ] );
+var y = new Complex128Vector( [ 0.0, 0.0, 0.0, 0.0, 0.0, 0.0 ] );
 
 var z = zcopy( [ x, y ] );
 // returns <ndarray>[ <Complex128>[ 1.0, 2.0 ], <Complex128>[ 3.0, 4.0 ], <Complex128>[ 5.0, 6.0 ] ]
@@ -59,7 +55,10 @@ var bool = ( y === z );
 
 The function has the following parameters:
 
--   **arrays**: array-like object containing an input ndarray and an output ndarray.
+-   **arrays**: array-like object containing the following ndarrays in order:
+
+    -   input ndarray
+    -   output ndarray
 
 </section>
 
@@ -79,21 +78,18 @@ The function has the following parameters:
 
 ```javascript
 var discreteUniform = require( '@stdlib/random/array/discrete-uniform' );
-var Complex128Array = require( '@stdlib/array/complex128' );
-var ndarray = require( '@stdlib/ndarray/base/ctor' );
+var Complex128Vector = require( '@stdlib/ndarray/vector/complex128' );
 var ndarray2array = require( '@stdlib/ndarray/to-array' );
 var zcopy = require( '@stdlib/blas/base/ndarray/zcopy' );
 
 var opts = {
     'dtype': 'float64'
 };
 
-var xbuf = new Complex128Array( discreteUniform( 10, 0, 100, opts ) );
-var x = new ndarray( 'complex128', xbuf, [ xbuf.length ], [ 1 ], 0, 'row-major' );
+var x = new Complex128Vector( discreteUniform( 10, 0, 100, opts ) );
 console.log( ndarray2array( x ) );
 
-var ybuf = new Complex128Array( discreteUniform( xbuf.length*2, 0, 10, opts ) );
-var y = new ndarray( 'complex128', ybuf, [ ybuf.length ], [ 1 ], 0, 'row-major' );
+var y = new Complex128Vector( discreteUniform( 10, 0, 10, opts ) );
 console.log( ndarray2array( y ) );
 
 var out = zcopy( [ x, y ] );

lib/node_modules/@stdlib/blas/base/ndarray/zcopy/benchmark/benchmark.js

@@ -25,20 +25,12 @@ var uniform = require( '@stdlib/random/array/uniform' );
 var isnan = require( '@stdlib/math/base/assert/is-nan' );
 var real = require( '@stdlib/complex/float64/real' );
 var pow = require( '@stdlib/math/base/special/pow' );
-var ndarray = require( '@stdlib/ndarray/base/ctor' );
-var Complex128Array = require( '@stdlib/array/complex128' );
+var Complex128Vector = require( '@stdlib/ndarray/vector/complex128' );
 var format = require( '@stdlib/string/format' );
 var pkg = require( './../package.json' ).name;
 var zcopy = require( './../lib' );
 
 
-// VARIABLES //
-
-var options = {
-	'dtype': 'complex128'
-};
-
-
 // FUNCTIONS //
 
 /**
@@ -57,12 +49,12 @@ function createBenchmark( len ) {
 	xbuf = uniform( len*2, -100.0, 100.0, {
 		'dtype': 'float64'
 	});
-	x = new ndarray( options.dtype, new Complex128Array( xbuf ), [ len ], [ 1 ], 0, 'row-major' );
+	x = new Complex128Vector( xbuf.buffer );
 
 	ybuf = uniform( len*2, -100.0, 100.0, {
 		'dtype': 'float64'
 	});
-	y = new ndarray( options.dtype, new Complex128Array( ybuf ), [ len ], [ 1 ], 0, 'row-major' );
+	y = new Complex128Vector( ybuf.buffer );
 
 	return benchmark;
 

lib/node_modules/@stdlib/blas/base/ndarray/zcopy/docs/repl.txt

@@ -19,15 +19,8 @@
 
     Examples
     --------
-    > var xbuf = new {{alias:@stdlib/array/complex128}}( [ 1.0, 2.0, 3.0, 4.0 ] );
-    > var ybuf = new {{alias:@stdlib/array/complex128}}( [ 0.0, 0.0, 0.0, 0.0 ] );
-    > var dt = 'complex128';
-    > var sh = [ xbuf.length ];
-    > var st = [ 1 ];
-    > var oo = 0;
-    > var ord = 'row-major';
-    > var x = new {{alias:@stdlib/ndarray/ctor}}( dt, xbuf, sh, st, oo, ord );
-    > var y = new {{alias:@stdlib/ndarray/ctor}}( dt, ybuf, sh, st, oo, ord );
+    > var x = new {{alias:@stdlib/ndarray/vector/complex128}}( [ 1.0, 2.0, 3.0, 4.0 ] );
+    > var y = new {{alias:@stdlib/ndarray/vector/complex128}}( [ 0.0, 0.0, 0.0, 0.0 ] );
 
     > {{alias}}( [ x, y ] );
     > y

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

@@ -29,14 +29,10 @@ import { complex128ndarray } from '@stdlib/types/ndarray';
 * @returns output ndarray
 *
 * @example
-* var Complex128Array = require( '@stdlib/array/complex128' );
-* var ndarray = require( '@stdlib/ndarray/base/ctor' );
+* var Complex128Vector = require( '@stdlib/ndarray/vector/complex128' );
 *
-* var xbuf = new Complex128Array( [ 1.0, 2.0, 3.0, 4.0, 5.0, 6.0 ] );
-* var x = new ndarray( 'complex128', xbuf, [ 3 ], [ 1 ], 0, 'row-major' );
-*
-* var ybuf = new Complex128Array( [ 0.0, 0.0, 0.0, 0.0, 0.0, 0.0 ] );
-* var y = new ndarray( 'complex128', ybuf, [ 3 ], [ 1 ], 0, 'row-major' );
+* var x = new Complex128Vector( [ 1.0, 2.0, 3.0, 4.0, 5.0, 6.0 ] );
+* var y = new Complex128Vector( [ 0.0, 0.0, 0.0, 0.0, 0.0, 0.0 ] );
 *
 * var z = zcopy( [ x, y ] );
 * // returns <ndarray>[ <Complex128>[ 1.0, 2.0 ], <Complex128>[ 3.0, 4.0 ], <Complex128>[ 5.0, 6.0 ] ]

lib/node_modules/@stdlib/blas/base/ndarray/zcopy/examples/index.js

@@ -19,21 +19,18 @@
 'use strict';
 
 var discreteUniform = require( '@stdlib/random/array/discrete-uniform' );
-var Complex128Array = require( '@stdlib/array/complex128' );
-var ndarray = require( '@stdlib/ndarray/base/ctor' );
+var Complex128Vector = require( '@stdlib/ndarray/vector/complex128' );
 var ndarray2array = require( '@stdlib/ndarray/to-array' );
 var zcopy = require( './../lib' );
 
 var opts = {
 	'dtype': 'float64'
 };
 
-var xbuf = new Complex128Array( discreteUniform( 10, 0, 100, opts ) );
-var x = new ndarray( 'complex128', xbuf, [ xbuf.length ], [ 1 ], 0, 'row-major' );
+var x = new Complex128Vector( discreteUniform( 10, 0, 100, opts ) );
 console.log( ndarray2array( x ) );
 
-var ybuf = new Complex128Array( discreteUniform( xbuf.length*2, 0, 10, opts ) );
-var y = new ndarray( 'complex128', ybuf, [ ybuf.length ], [ 1 ], 0, 'row-major' );
+var y = new Complex128Vector( discreteUniform( 10, 0, 10, opts ) );
 console.log( ndarray2array( y ) );
 
 var out = zcopy( [ x, y ] );

lib/node_modules/@stdlib/blas/base/ndarray/zcopy/lib/index.js

@@ -24,15 +24,11 @@
 * @module @stdlib/blas/base/ndarray/zcopy
 *
 * @example
-* var Complex128Array = require( '@stdlib/array/complex128' );
-* var ndarray = require( '@stdlib/ndarray/base/ctor' );
+* var Complex128Vector = require( '@stdlib/ndarray/vector/complex128' );
 * var zcopy = require( '@stdlib/blas/base/ndarray/zcopy' );
 *
-* var xbuf = new Complex128Array( [ 1.0, 2.0, 3.0, 4.0, 5.0, 6.0 ] );
-* var x = new ndarray( 'complex128', xbuf, [ 3 ], [ 1 ], 0, 'row-major' );
-*
-* var ybuf = new Complex128Array( [ 0.0, 0.0, 0.0, 0.0, 0.0, 0.0 ] );
-* var y = new ndarray( 'complex128', ybuf, [ 3 ], [ 1 ], 0, 'row-major' );
+* var x = new Complex128Vector( [ 1.0, 2.0, 3.0, 4.0, 5.0, 6.0 ] );
+* var y = new Complex128Vector( [ 0.0, 0.0, 0.0, 0.0, 0.0, 0.0 ] );
 *
 * var z = zcopy( [ x, y ] );
 * // returns <ndarray>[ <Complex128>[ 1.0, 2.0 ], <Complex128>[ 3.0, 4.0 ], <Complex128>[ 5.0, 6.0 ] ]

lib/node_modules/@stdlib/blas/base/ndarray/zcopy/lib/main.js

@@ -36,14 +36,10 @@ var strided = require( '@stdlib/blas/base/zcopy' ).ndarray;
 * @returns {Object} output ndarray
 *
 * @example
-* var Complex128Array = require( '@stdlib/array/complex128' );
-* var ndarray = require( '@stdlib/ndarray/base/ctor' );
+* var Complex128Vector = require( '@stdlib/ndarray/vector/complex128' );
 *
-* var xbuf = new Complex128Array( [ 1.0, 2.0, 3.0, 4.0, 5.0, 6.0 ] );
-* var x = new ndarray( 'complex128', xbuf, [ 3 ], [ 1 ], 0, 'row-major' );
-*
-* var ybuf = new Complex128Array( [ 0.0, 0.0, 0.0, 0.0, 0.0, 0.0 ] );
-* var y = new ndarray( 'complex128', ybuf, [ 3 ], [ 1 ], 0, 'row-major' );
+* var x = new Complex128Vector( [ 1.0, 2.0, 3.0, 4.0, 5.0, 6.0 ] );
+* var y = new Complex128Vector( [ 0.0, 0.0, 0.0, 0.0, 0.0, 0.0 ] );
 *
 * var z = zcopy( [ x, y ] );
 * // returns <ndarray>[ <Complex128>[ 1.0, 2.0 ], <Complex128>[ 3.0, 4.0 ], <Complex128>[ 5.0, 6.0 ] ]