Auto-generated commit

Author: stdlib-bot

CHANGELOG.md

@@ -4,12 +4,13 @@
 
 <section class="release" id="unreleased">
 
-## Unreleased (2025-05-15)
+## Unreleased (2025-05-16)
 
 <section class="features">
 
 ### Features
 
+-   [`848f226`](https://github.com/stdlib-js/stdlib/commit/848f226d45aad2d627453c8306ae192c75338ac3) - add `factory` method
 -   [`916b907`](https://github.com/stdlib-js/stdlib/commit/916b9073d6cf82262233e835f9bbbaca26d685f0) - add `ndarray/vector/ctor`
 -   [`9b0d852`](https://github.com/stdlib-js/stdlib/commit/9b0d8520418c2788d20d446b6a39471b6393a787) - add `loopOrder` to namespace
 -   [`bdc9110`](https://github.com/stdlib-js/stdlib/commit/bdc91105259200e3ebb60aea16e918718301ce4b) - add `ndarray/base/loop-interchange-order`
@@ -389,6 +390,7 @@ A total of 15 issues were closed in this release:
 
 <details>
 
+-   [`848f226`](https://github.com/stdlib-js/stdlib/commit/848f226d45aad2d627453c8306ae192c75338ac3) - **feat:** add `factory` method _(by Athan Reines)_
 -   [`d30fed0`](https://github.com/stdlib-js/stdlib/commit/d30fed0b3516e362f957aa15d1521b3b3fe6cefd) - **docs:** update examples _(by Athan Reines)_
 -   [`916b907`](https://github.com/stdlib-js/stdlib/commit/916b9073d6cf82262233e835f9bbbaca26d685f0) - **feat:** add `ndarray/vector/ctor` _(by Athan Reines)_
 -   [`9b8f3a8`](https://github.com/stdlib-js/stdlib/commit/9b8f3a8e51b449803b683c7bf394d498de479a5f) - **docs:** update namespace table of contents [(#6996)](https://github.com/stdlib-js/stdlib/pull/6996) _(by stdlib-bot)_

vector/ctor/README.md

@@ -186,6 +186,41 @@ var dt6 = getDType( arr6 );
 // returns 'int16'
 ```
 
+#### vector.factory( dtype\[, options] )
+
+Returns a function for creating a one-dimensional [ndarray][@stdlib/ndarray/ctor].
+
+```javascript
+var getDType = require( '@stdlib/ndarray/dtype' );
+var numel = require( '@stdlib/ndarray/numel' );
+
+var Float32Vector = vector.factory( 'float32' );
+
+var arr = new Float32Vector( [ 1, 2, 3 ] );
+// returns <ndarray>
+
+var dt = getDType( arr );
+// returns 'float32'
+
+var len = numel( arr );
+// returns 3
+```
+
+The function supports the following parameters:
+
+-   **dtype**: [data type][@stdlib/ndarray/dtypes].
+-   **options**: function options (_optional_).
+
+The function accepts the following options:
+
+-   **order**: specifies whether the default memory layout for a returned [ndarray][@stdlib/ndarray/ctor] should be `'row-major'` (C-style) or `'column-major'` (Fortran-style). Default: `'row-major'`.
+-   **mode**: specifies the default behavior when handling indices which exceed array dimensions (see [`ndarray`][@stdlib/ndarray/ctor]). Default: `'throw'`.
+-   **readonly**: boolean indicating whether to return a **read-only** [ndarray][@stdlib/ndarray/ctor] by default. Default: `false`.
+
+The function returned by the `factory` method supports the same arguments and options as `vector` above, except for the `dtype` argument, as the returned function always returns a one-dimensional [ndarray][@stdlib/ndarray/ctor] having the same [data type][@stdlib/ndarray/dtypes].
+
+When providing options to the returned function, the provided option values override the defaults established during function creation.
+
 </section>
 
 <!-- /.usage -->
@@ -211,7 +246,7 @@ var discreteUniform = require( '@stdlib/random/array/discrete-uniform' );
 var cartesianProduct = require( '@stdlib/array/cartesian-product' );
 var unzip = require( '@stdlib/utils/unzip' );
 var dtypes = require( '@stdlib/ndarray/dtypes' );
-var getShape = require( '@stdlib/ndarray/shape' );
+var sum = require( '@stdlib/blas/ext/sum' );
 var logEachMap = require( '@stdlib/console/log-each-map' );
 var vector = require( '@stdlib/ndarray/vector/ctor' );
 
@@ -220,23 +255,23 @@ var lens = discreteUniform( 10, 5, 15, {
     'dtype': 'int32'
 });
 
-// Resolve a list of supported ndarray date types:
-var dts = dtypes();
+// Resolve a list of supported ndarray real-valued data types:
+var dts = dtypes( 'real_and_generic' );
 
 // Create length-dtype pairs:
 var pairs = cartesianProduct( lens, dts );
 
 // Split the pairs into individual arguments:
 var args = unzip( pairs );
 
-// Define a callback to create a vector and return the vector shape:
+// Define a callback to create a random vector and return the sum of all vector elements:
 function clbk( len, dtype ) {
-    var x = vector( len, dtype );
-    return getShape( x );
+    var x = vector( discreteUniform( len, 0, 100 ), dtype );
+    return sum( x ).get();
 }
 
 // Apply the callback and print the results:
-logEachMap( 'len: %2d. dtype: %10s. shape: [%d].', args[ 0 ], args[ 1 ], clbk );
+logEachMap( 'len: %2d. dtype: %7s. sum: %d.', args[ 0 ], args[ 1 ], clbk );
 ```
 
 </section>