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: passed
  - task: lint_javascript_cli
    status: na
  - task: lint_javascript_examples
    status: na
  - 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: missing_dependencies
  - 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/blas/ext/base/dvander/README.md

@@ -22,6 +22,12 @@ limitations under the License.
 
 > Generate a double-precision floating-point Vandermonde matrix.
 
+<section class="intro">
+
+</section>
+
+<!-- /.intro -->
+
 <section class="usage">
 
 ## Usage
@@ -30,7 +36,7 @@ limitations under the License.
 var dvander = require( '@stdlib/blas/ext/base/dvander' );
 ```
 
-#### dvander( order, mode, M, N, x, strideX, out, LDO )
+#### dvander( order, mode, M, N, x, strideX, out, ldo )
 
 Generates a double-precision floating-point Vandermonde matrix.
 
@@ -46,45 +52,14 @@ dvander( 'row-major', -1, 3, 3, x, 1, out, 3 );
 
 The function has the following parameters:
 
--   **order**: storage layout.
--   **mode**: specifies whether columns should contain powers that are increasing (`1`) or decreasing (`-1`).
--   **M**: number of rows in `out`.
+-   **order**: row-major (C-style) or column-major (Fortran-style) order.
+-   **mode**: mode. If `mode < 0`, the function generates decreasing powers. If `mode > 0`, the function generates increasing powers.
+-   **M**: number of rows in `out` and number of indexed elements in `x`.
 -   **N**: number of columns in `out`.
 -   **x**: input [`Float64Array`][@stdlib/array/float64].
 -   **strideX**: stride length for `x`.
--   **out**: output [`Float64Array`][@stdlib/array/float64].
--   **LDO**: stride length for the leading dimension of `out`.
-
-The stride parameter determines which elements in the input array are accessed at runtime. For example, to use every other element in `x`,
-
-```javascript
-var Float64Array = require( '@stdlib/array/float64' );
-
-var x = new Float64Array( [ 1.0, 0.0, 2.0, 0.0, 3.0, 0.0 ] );
-var out = new Float64Array( 9 );
-
-dvander( 'row-major', -1, 3, 3, x, 2, out, 3 );
-// out => <Float64Array>[ 1.0, 1.0, 1.0, 4.0, 2.0, 1.0, 9.0, 3.0, 1.0 ]
-```
-
-Note that indexing is relative to the first index. To introduce an offset, use [`typed array`][mdn-typed-array] views.
-
-<!-- eslint-disable stdlib/capitalized-comments -->
-
-```javascript
-var Float64Array = require( '@stdlib/array/float64' );
-
-// Initial array...
-var x0 = new Float64Array( [ 0.0, 1.0, 2.0, 3.0 ] );
-
-// Create an offset view...
-var x1 = new Float64Array( x0.buffer, x0.BYTES_PER_ELEMENT*1 ); // start at 2nd element
-
-var out = new Float64Array( 9 );
-
-dvander( 'row-major', -1, 3, 3, x1, 1, out, 3 );
-// out => <Float64Array>[ 1.0, 1.0, 1.0, 4.0, 2.0, 1.0, 9.0, 3.0, 1.0 ]
-```
+-   **out**: output matrix stored in linear memory as a [`Float64Array`][@stdlib/array/float64].
+-   **ldo**: stride of the first dimension of `out` (a.k.a., leading dimension of the matrix `out`).
 
 <!-- lint disable maximum-heading-length -->
 
@@ -107,22 +82,10 @@ dvander.ndarray( -1, 3, 3, x, 1, 0, out, 3, 1, 0 );
 The function has the following additional parameters:
 
 -   **offsetX**: starting index for `x`.
--   **strideOut1**: stride of the first dimension of `out`.
--   **strideOut2**: stride of the second dimension of `out`.
+-   **strideOut1**: stride length for the first dimension of `out`.
+-   **strideOut2**: stride length for the second dimension of `out`.
 -   **offsetOut**: starting index for `out`.
 
-While [`typed array`][mdn-typed-array] views mandate a view offset based on the underlying buffer, the offset parameters support indexing semantics based on starting indices. For example,
-
-```javascript
-var Float64Array = require( '@stdlib/array/float64' );
-
-var x = new Float64Array( [ 0.0, 1.0, 2.0, 3.0 ] );
-var out = new Float64Array( 9 );
-
-dvander.ndarray( -1, 3, 3, x, 1, 1, out, 3, 1, 0 );
-// out => <Float64Array>[ 1.0, 1.0, 1.0, 4.0, 2.0, 1.0, 9.0, 3.0, 1.0 ]
-```
-
 </section>
 
 <!-- /.usage -->
@@ -131,7 +94,7 @@ dvander.ndarray( -1, 3, 3, x, 1, 1, out, 3, 1, 0 );
 
 ## Notes
 
--   If `M` or `N` is equal to `0`, both functions return `out` unchanged.
+-   If `M <= 0` or `N <= 0`, both functions return the output matrix unchanged.
 
 </section>
 
@@ -206,13 +169,13 @@ stdlib_strided_dvander( CblasRowMajor, -1.0, 3, 3, x, 1, Out, 3 );
 The function accepts the following arguments:
 
 -   **order**: `[in] CBLAS_LAYOUT` storage layout.
--   **mode**: `[in] double` specifies whether powers are increasing (`1`) or decreasing (`-1`).
--   **M**: `[in] CBLAS_INT` number of rows in `Out`.
+-   **mode**: `[in] double` mode. If `mode < 0`, the function generates decreasing powers. If `mode > 0`, the function generates increasing powers.
+-   **M**: `[in] CBLAS_INT` number of rows in `Out` and number of indexed elements in `X`.
 -   **N**: `[in] CBLAS_INT` number of columns in `Out`.
 -   **X**: `[in] double*` input array.
 -   **strideX**: `[in] CBLAS_INT` stride length for `X`.
--   **Out**: `[out] double*` output array.
--   **LDO**: `[in] CBLAS_INT` stride length for the leading dimension of `out`.
+-   **Out**: `[out] double*` output matrix.
+-   **LDO**: `[in] CBLAS_INT` stride of the first dimension of `Out` (a.k.a., leading dimension of the matrix `Out`).
 
 ```c
 void API_SUFFIX(stdlib_strided_dvander)( const CBLAS_LAYOUT order, const double mode, const CBLAS_INT M, const CBLAS_INT N, const double *X, const CBLAS_INT strideX, double *Out, const CBLAS_INT LDO );
@@ -237,15 +200,15 @@ stdlib_strided_dvander_ndarray( -1.0, 3, 3, x, 1, 0, Out, 3, 1, 0 );
 
 The function accepts the following arguments:
 
--   **mode**: `[in] double` specifies whether powers are increasing (`1`) or decreasing (`-1`).
--   **M**: `[in] CBLAS_INT` number of rows in `Out`.
+-   **mode**: `[in] double` mode. If `mode < 0`, the function generates decreasing powers. If `mode > 0`, the function generates increasing powers.
+-   **M**: `[in] CBLAS_INT` number of rows in `Out` and number of indexed elements in `X`.
 -   **N**: `[in] CBLAS_INT` number of columns in `Out`.
 -   **X**: `[in] double*` input array.
 -   **strideX**: `[in] CBLAS_INT` stride length for `X`.
 -   **offsetX**: `[in] CBLAS_INT` starting index for `X`.
--   **Out**: `[out] double*` output array.
--   **strideOut1**: `[in] CBLAS_INT` stride of the first dimension of `Out`.
--   **strideOut2**: `[in] CBLAS_INT` stride of the second dimension of `Out`.
+-   **Out**: `[out] double*` output matrix.
+-   **strideOut1**: `[in] CBLAS_INT` stride length for the first dimension of `Out`.
+-   **strideOut2**: `[in] CBLAS_INT` stride length for the second dimension of `Out`.
 -   **offsetOut**: `[in] CBLAS_INT` starting index for `Out`.
 
 ```c
@@ -306,6 +269,12 @@ int main( void ) {
 
 <!-- /.c -->
 
+<section class="references">
+
+</section>
+
+<!-- /.references -->
+
 <!-- Section for related `stdlib` packages. Do not manually edit this section, as it is automatically populated. -->
 
 <section class="related">
@@ -320,8 +289,6 @@ int main( void ) {
 
 [@stdlib/array/float64]: https://github.com/stdlib-js/stdlib/tree/develop/lib/node_modules/%40stdlib/array/float64
 
-[mdn-typed-array]: https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/TypedArray
-
 </section>
 
 <!-- /.links -->

lib/node_modules/@stdlib/blas/ext/base/dvander/docs/repl.txt

@@ -1,23 +1,41 @@
 
-{{alias}}( order, mode, M, N, x, strideX, out, LDO )
+{{alias}}( order, mode, M, N, x, strideX, out, ldo )
     Generates a double-precision floating-point Vandermonde matrix.
 
-    Indexing is relative to the first index. To introduce an offset, use typed
-    array views.
+    When the mode is positive, the matrix is generated such that
 
-    If `M` or `N` is equal to `0`, the function returns `out` unchanged.
+        [
+            1   x_0^1   x_0^2   ...   x_0^N
+            1   x_1^1   x_1^2   ...   x_1^N
+            ...
+        ]
+
+    with increasing powers along the rows.
+
+    When the mode is negative, the matrix is generated such that
+
+        [
+            x_0^N   ...   x_0^2   x_0^1   1
+            x_1^N   ...   x_1^2   x_1^1   1
+            ...
+        ]
+
+    with decreasing powers along the rows.
+
+    If `M <= 0` or `N <= 0`, the function returns the output matrix
+    unchanged.
 
     Parameters
     ----------
     order: string
         Row-major (C-style) or column-major (Fortran-style) order.
 
     mode: number
-        Specifies whether columns should contain powers that are increasing
-        (`1`) or decreasing (`-1`).
+        Mode. If `mode < 0`, the function generates decreasing powers. If
+        `mode > 0`, the function generates increasing powers.
 
     M: integer
-        Number of rows in `out`.
+        Number of rows in `out` and number of indexed elements in `x`.
 
     N: integer
         Number of columns in `out`.
@@ -29,15 +47,16 @@
         Stride length for `x`.
 
     out: Float64Array
-        Output array.
+        Output matrix.
 
-    LDO: integer
-        Stride length for the leading dimension of `out`.
+    ldo: integer
+        Stride of the first dimension of `out` (a.k.a., leading dimension
+        of the matrix `out`).
 
     Returns
     -------
     out: Float64Array
-        Output array.
+        Output matrix.
 
     Examples
     --------
@@ -52,18 +71,14 @@
     Generates a double-precision floating-point Vandermonde matrix using
     alternative indexing semantics.
 
-    While typed array views mandate a view offset based on the underlying
-    buffer, the offset parameters support indexing semantics based on starting
-    indices.
-
     Parameters
     ----------
     mode: number
-        Specifies whether columns should contain powers that are increasing
-        (`1`) or decreasing (`-1`).
+        Mode. If `mode < 0`, the function generates decreasing powers. If
+        `mode > 0`, the function generates increasing powers.
 
     M: integer
-        Number of rows in `out`.
+        Number of rows in `out` and number of indexed elements in `x`.
 
     N: integer
         Number of columns in `out`.
@@ -78,21 +93,21 @@
         Starting index for `x`.
 
     out: Float64Array
-        Output array.
+        Output matrix.
 
     so1: integer
-        Stride of the first dimension of `out`.
+        Stride length for the first dimension of `out`.
 
     so2: integer
-        Stride of the second dimension of `out`.
+        Stride length for the second dimension of `out`.
 
     oo: integer
         Starting index for `out`.
 
     Returns
     -------
     out: Float64Array
-        Output array.
+        Output matrix.
 
     Examples
     --------

lib/node_modules/@stdlib/blas/ext/base/dvander/docs/types/index.d.ts

@@ -30,14 +30,14 @@ interface Routine {
 	* Generates a double-precision floating-point Vandermonde matrix.
 	*
 	* @param order - storage layout
-	* @param mode - specifies whether columns should contain powers that are increasing or decreasing
-	* @param M - number of rows in `out`
+	* @param mode - mode indicating whether to generate increasing or decreasing powers
+	* @param M - number of rows in `out` and number of indexed elements in `x`
 	* @param N - number of columns in `out`
 	* @param x - input array
 	* @param strideX - stride length for `x`
-	* @param out - output array
-	* @param LDO - stride length for the leading dimension of `Out`
-	* @returns output array
+	* @param out - output matrix
+	* @param ldo - stride of the first dimension of `out` (a.k.a., leading dimension of the matrix `out`)
+	* @returns output matrix
 	*
 	* @example
 	* var Float64Array = require( '@stdlib/array/float64' );
@@ -48,22 +48,22 @@ interface Routine {
 	* dvander( 'row-major', -1, 3, 3, x, 1, out, 3 );
 	* // out => <Float64Array>[ 1.0, 1.0, 1.0, 4.0, 2.0, 1.0, 9.0, 3.0, 1.0 ]
 	*/
-	( order: Layout, mode: number, M: number, N: number, x: Float64Array, strideX: number, out: Float64Array, LDO: number ): Float64Array;
+	( order: Layout, mode: number, M: number, N: number, x: Float64Array, strideX: number, out: Float64Array, ldo: number ): Float64Array;
 
 	/**
 	* Generates a double-precision floating-point Vandermonde matrix using alternative indexing semantics.
 	*
-	* @param mode - specifies whether columns should contain powers that are increasing or decreasing
-	* @param M - number of rows in `out`
+	* @param mode - mode indicating whether to generate increasing or decreasing powers
+	* @param M - number of rows in `out` and number of indexed elements in `x`
 	* @param N - number of columns in `out`
 	* @param x - input array
 	* @param strideX - stride length for `x`
 	* @param offsetX - starting index for `x`
-	* @param out - output array
-	* @param strideOut1 - stride of the first dimension of `Out`
-	* @param strideOut2 - stride of the second dimension of `Out`
-	* @param offsetOut - starting index for `Out`
-	* @returns output array
+	* @param out - output matrix
+	* @param strideOut1 - stride length for the first dimension of `out`
+	* @param strideOut2 - stride length for the second dimension of `out`
+	* @param offsetOut - starting index for `out`
+	* @returns output matrix
 	*
 	* @example
 	* var Float64Array = require( '@stdlib/array/float64' );
@@ -81,14 +81,14 @@ interface Routine {
 * Generates a double-precision floating-point Vandermonde matrix.
 *
 * @param order - storage layout
-* @param mode - specifies whether columns should contain powers that are increasing or decreasing
-* @param M - number of rows in `out`
+* @param mode - mode indicating whether to generate increasing or decreasing powers
+* @param M - number of rows in `out` and number of indexed elements in `x`
 * @param N - number of columns in `out`
 * @param x - input array
 * @param strideX - stride length for `x`
-* @param out - output array
-* @param LDO - stride length for the leading dimension of `Out`
-* @returns output array
+* @param out - output matrix
+* @param ldo - stride of the first dimension of `out` (a.k.a., leading dimension of the matrix `out`)
+* @returns output matrix
 *
 * @example
 * var Float64Array = require( '@stdlib/array/float64' );