From dd525752930171cbf17640235133ec7df981371c Mon Sep 17 00:00:00 2001
From: ShreelaxmiHegde <shreelaxmihegde9@gmail.com>
Date: Sat, 10 Jan 2026 05:26:18 +0000
Subject: [PATCH] docs: improve doctests for ndarray instances in
 ndarray/flatten

---
 .../@stdlib/ndarray/flatten/README.md         | 24 +-----
 .../@stdlib/ndarray/flatten/docs/repl.txt     |  5 +-
 .../ndarray/flatten/docs/types/index.d.ts     | 12 +--
 .../@stdlib/ndarray/flatten/lib/index.js      |  6 +-
 .../@stdlib/ndarray/flatten/lib/main.js       | 78 ++++---------------
 5 files changed, 22 insertions(+), 103 deletions(-)

diff --git a/lib/node_modules/@stdlib/ndarray/flatten/README.md b/lib/node_modules/@stdlib/ndarray/flatten/README.md
index 67fe4b5609fe..6fa882bcf408 100644
--- a/lib/node_modules/@stdlib/ndarray/flatten/README.md
+++ b/lib/node_modules/@stdlib/ndarray/flatten/README.md
@@ -42,16 +42,12 @@ Returns a flattened copy of an input [ndarray][@stdlib/ndarray/ctor].
 
 ```javascript
 var array = require( '@stdlib/ndarray/array' );
-var ndarray2array = require( '@stdlib/ndarray/to-array' );
 
 var x = array( [ [ [ 1.0, 2.0 ] ], [ [ 3.0, 4.0 ] ], [ [ 5.0, 6.0 ] ] ] );
 // returns <ndarray>
 
 var y = flatten( x );
-// returns <ndarray>
-
-var arr = ndarray2array( y );
-// returns [ 1.0, 2.0, 3.0, 4.0, 5.0, 6.0 ]
+// returns <ndarray>[ 1.0, 2.0, 3.0, 4.0, 5.0, 6.0 ]
 ```
 
 The function accepts the following arguments:
@@ -78,7 +74,6 @@ By default, the function flattens all dimensions of the input [ndarray][@stdlib/
 
 ```javascript
 var array = require( '@stdlib/ndarray/array' );
-var ndarray2array = require( '@stdlib/ndarray/to-array' );
 
 var x = array( [ [ [ 1.0, 2.0 ] ], [ [ 3.0, 4.0 ] ], [ [ 5.0, 6.0 ] ] ] );
 // returns <ndarray>
@@ -86,17 +81,13 @@ var x = array( [ [ [ 1.0, 2.0 ] ], [ [ 3.0, 4.0 ] ], [ [ 5.0, 6.0 ] ] ] );
 var y = flatten( x, {
     'depth': 1
 });
-// returns <ndarray>
-
-var arr = ndarray2array( y );
-// returns [ [ 1.0, 2.0 ], [ 3.0, 4.0 ], [ 5.0, 6.0 ] ]
+// returns <ndarray>[ [ 1.0, 2.0 ], [ 3.0, 4.0 ], [ 5.0, 6.0 ] ]
 ```
 
 By default, the input [ndarray][@stdlib/ndarray/ctor] is flattened in lexicographic order. To flatten elements in a different order, specify the `order` option.
 
 ```javascript
 var array = require( '@stdlib/ndarray/array' );
-var ndarray2array = require( '@stdlib/ndarray/to-array' );
 
 var x = array( [ [ [ 1.0, 2.0 ] ], [ [ 3.0, 4.0 ] ], [ [ 5.0, 6.0 ] ] ] );
 // returns <ndarray>
@@ -104,10 +95,7 @@ var x = array( [ [ [ 1.0, 2.0 ] ], [ [ 3.0, 4.0 ] ], [ [ 5.0, 6.0 ] ] ] );
 var y = flatten( x, {
     'order': 'column-major'
 });
-// returns <ndarray>
-
-var arr = ndarray2array( y );
-// returns [ 1.0, 3.0, 5.0, 2.0, 4.0, 6.0 ]
+// returns <ndarray>[ 1.0, 3.0, 5.0, 2.0, 4.0, 6.0 ]
 ```
 
 By default, the output ndarray [data type][@stdlib/ndarray/dtypes] is inferred from the input [ndarray][@stdlib/ndarray/ctor]. To return an ndarray with a different [data type][@stdlib/ndarray/dtypes], specify the `dtype` option.
@@ -115,7 +103,6 @@ By default, the output ndarray [data type][@stdlib/ndarray/dtypes] is inferred f
 ```javascript
 var array = require( '@stdlib/ndarray/array' );
 var dtype = require( '@stdlib/ndarray/dtype' );
-var ndarray2array = require( '@stdlib/ndarray/to-array' );
 
 var x = array( [ [ [ 1.0, 2.0 ] ], [ [ 3.0, 4.0 ] ], [ [ 5.0, 6.0 ] ] ] );
 // returns <ndarray>
@@ -123,13 +110,10 @@ var x = array( [ [ [ 1.0, 2.0 ] ], [ [ 3.0, 4.0 ] ], [ [ 5.0, 6.0 ] ] ] );
 var y = flatten( x, {
     'dtype': 'float32'
 });
-// returns <ndarray>
+// returns <ndarray>[ 1.0, 2.0, 3.0, 4.0, 5.0, 6.0 ]
 
 var dt = String( dtype( y ) );
 // returns 'float32'
-
-var arr = ndarray2array( y );
-// returns [ 1.0, 2.0, 3.0, 4.0, 5.0, 6.0 ]
 ```
 
 </section>
diff --git a/lib/node_modules/@stdlib/ndarray/flatten/docs/repl.txt b/lib/node_modules/@stdlib/ndarray/flatten/docs/repl.txt
index c9647f66f732..c6cf13d0d49f 100644
--- a/lib/node_modules/@stdlib/ndarray/flatten/docs/repl.txt
+++ b/lib/node_modules/@stdlib/ndarray/flatten/docs/repl.txt
@@ -41,9 +41,8 @@
     Examples
     --------
     > var x = {{alias:@stdlib/ndarray/array}}( [ [ 1.0, 2.0 ], [ 3.0, 4.0 ] ] );
-    > var y = {{alias}}( x );
-    > var arr = {{alias:@stdlib/ndarray/to-array}}( y )
-    [ 1.0, 2.0, 3.0, 4.0 ]
+    > var y = {{alias}}( x )
+    <ndarray>[ 1.0, 2.0, 3.0, 4.0 ]
 
     See Also
     --------
diff --git a/lib/node_modules/@stdlib/ndarray/flatten/docs/types/index.d.ts b/lib/node_modules/@stdlib/ndarray/flatten/docs/types/index.d.ts
index 1eca565aaec7..a0c67c0c8a72 100644
--- a/lib/node_modules/@stdlib/ndarray/flatten/docs/types/index.d.ts
+++ b/lib/node_modules/@stdlib/ndarray/flatten/docs/types/index.d.ts
@@ -79,16 +79,12 @@ type Options<U> = BaseOptions & {
 *
 * @example
 * var array = require( '@stdlib/ndarray/array' );
-* var ndarray2array = require( '@stdlib/ndarray/to-array' );
 *
 * var x = array( [ [ [ 1.0, 2.0 ] ], [ [ 3.0, 4.0 ] ], [ [ 5.0, 6.0 ] ] ] );
 * // returns <ndarray>
 *
 * var y = flatten( x );
-* // returns <ndarray>
-*
-* var arr = ndarray2array( y );
-* // returns [ 1.0, 2.0, 3.0, 4.0, 5.0, 6.0 ]
+* // returns <ndarray>[ 1.0, 2.0, 3.0, 4.0, 5.0, 6.0 ]
 */
 declare function flatten<T extends ndarray>( x: T, options?: BaseOptions ): T;
 
@@ -108,16 +104,12 @@ declare function flatten<T extends ndarray>( x: T, options?: BaseOptions ): T;
 *
 * @example
 * var array = require( '@stdlib/ndarray/array' );
-* var ndarray2array = require( '@stdlib/ndarray/to-array' );
 *
 * var x = array( [ [ [ 1.0, 2.0 ] ], [ [ 3.0, 4.0 ] ], [ [ 5.0, 6.0 ] ] ] );
 * // returns <ndarray>
 *
 * var y = flatten( x );
-* // returns <ndarray>
-*
-* var arr = ndarray2array( y );
-* // returns [ 1.0, 2.0, 3.0, 4.0, 5.0, 6.0 ]
+* // returns <ndarray>[ 1.0, 2.0, 3.0, 4.0, 5.0, 6.0 ]
 */
 declare function flatten<T = unknown, U extends keyof DataTypeMap<T> = 'generic'>( x: typedndarray<T>, options: Options<U> ): DataTypeMap<T>[U];
 
diff --git a/lib/node_modules/@stdlib/ndarray/flatten/lib/index.js b/lib/node_modules/@stdlib/ndarray/flatten/lib/index.js
index e82c0c28e2c1..510bb7d48103 100644
--- a/lib/node_modules/@stdlib/ndarray/flatten/lib/index.js
+++ b/lib/node_modules/@stdlib/ndarray/flatten/lib/index.js
@@ -25,7 +25,6 @@
 *
 * @example
 * var array = require( '@stdlib/ndarray/array' );
-* var ndarray2array = require( '@stdlib/ndarray/to-array' );
 * var flatten = require( '@stdlib/ndarray/flatten' );
 *
 * // Create an input ndarray:
@@ -34,10 +33,7 @@
 *
 * // Flatten the input ndarray:
 * var y = flatten( x );
-* // returns <ndarray>
-*
-* var arr = ndarray2array( y );
-* // returns [ 1.0, 2.0, 3.0, 4.0, 5.0, 6.0 ]
+* // returns <ndarray>[ 1.0, 2.0, 3.0, 4.0, 5.0, 6.0 ]
 */
 
 // MODULES //
diff --git a/lib/node_modules/@stdlib/ndarray/flatten/lib/main.js b/lib/node_modules/@stdlib/ndarray/flatten/lib/main.js
index 2b619a67a22b..eddc4a458f09 100644
--- a/lib/node_modules/@stdlib/ndarray/flatten/lib/main.js
+++ b/lib/node_modules/@stdlib/ndarray/flatten/lib/main.js
@@ -63,20 +63,15 @@ var COL_MAJOR = 'column-major';
 *
 * @example
 * var array = require( '@stdlib/ndarray/array' );
-* var ndarray2array = require( '@stdlib/ndarray/to-array' );
 *
 * var x = array( [ [ [ 1.0, 2.0 ] ], [ [ 3.0, 4.0 ] ], [ [ 5.0, 6.0 ] ] ] );
 * // returns <ndarray>
 *
 * var y = flatten( x );
-* // returns <ndarray>
-*
-* var arr = ndarray2array( y );
-* // returns [ 1.0, 2.0, 3.0, 4.0, 5.0, 6.0 ]
+* // returns <ndarray>[ 1.0, 2.0, 3.0, 4.0, 5.0, 6.0 ]
 *
 * @example
 * var array = require( '@stdlib/ndarray/array' );
-* var ndarray2array = require( '@stdlib/ndarray/to-array' );
 *
 * var x = array( [ 1.0, 2.0, 3.0, 4.0, 5.0, 6.0 ], {
 *     'shape': [ 2, 3 ],
@@ -85,14 +80,10 @@ var COL_MAJOR = 'column-major';
 * // returns <ndarray>
 *
 * var y = flatten( x );
-* // returns <ndarray>
-*
-* var arr = ndarray2array( y );
-* // returns [ 1.0, 3.0, 5.0, 2.0, 4.0, 6.0 ]
+* // returns <ndarray>[ 1.0, 3.0, 5.0, 2.0, 4.0, 6.0 ]
 *
 * @example
 * var array = require( '@stdlib/ndarray/array' );
-* var ndarray2array = require( '@stdlib/ndarray/to-array' );
 *
 * var x = array( [ 1.0, 2.0, 3.0, 4.0, 5.0, 6.0 ], {
 *     'shape': [ 2, 3 ],
@@ -103,14 +94,10 @@ var COL_MAJOR = 'column-major';
 * var y = flatten( x, {
 *     'order': 'column-major'
 * });
-* // returns <ndarray>
-*
-* var arr = ndarray2array( y );
-* // returns [ 1.0, 4.0, 2.0, 5.0, 3.0, 6.0 ]
+* // returns <ndarray>[ 1.0, 4.0, 2.0, 5.0, 3.0, 6.0 ]
 *
 * @example
 * var array = require( '@stdlib/ndarray/array' );
-* var ndarray2array = require( '@stdlib/ndarray/to-array' );
 *
 * var x = array( [ 1.0, 2.0, 3.0, 4.0, 5.0, 6.0 ], {
 *     'shape': [ 2, 3 ],
@@ -121,14 +108,10 @@ var COL_MAJOR = 'column-major';
 * var y = flatten( x, {
 *     'order': 'row-major'
 * });
-* // returns <ndarray>
-*
-* var arr = ndarray2array( y );
-* // returns [ 1.0, 3.0, 5.0, 2.0, 4.0, 6.0 ]
+* // returns <ndarray>[ 1.0, 3.0, 5.0, 2.0, 4.0, 6.0 ]
 *
 * @example
 * var array = require( '@stdlib/ndarray/array' );
-* var ndarray2array = require( '@stdlib/ndarray/to-array' );
 *
 * var x = array( [ 1.0, 2.0, 3.0, 4.0, 5.0, 6.0 ], {
 *     'shape': [ 2, 3 ],
@@ -139,14 +122,10 @@ var COL_MAJOR = 'column-major';
 * var y = flatten( x, {
 *     'order': 'same'
 * });
-* // returns <ndarray>
-*
-* var arr = ndarray2array( y );
-* // returns [ 1.0, 2.0, 3.0, 4.0, 5.0, 6.0 ]
+* // returns <ndarray>[ 1.0, 2.0, 3.0, 4.0, 5.0, 6.0 ]
 *
 * @example
 * var array = require( '@stdlib/ndarray/array' );
-* var ndarray2array = require( '@stdlib/ndarray/to-array' );
 *
 * var x = array( [ 1.0, 2.0, 3.0, 4.0, 5.0, 6.0 ], {
 *     'shape': [ 2, 3 ],
@@ -157,14 +136,10 @@ var COL_MAJOR = 'column-major';
 * var y = flatten( x, {
 *     'order': 'same'
 * });
-* // returns <ndarray>
-*
-* var arr = ndarray2array( y );
-* // returns [ 1.0, 2.0, 3.0, 4.0, 5.0, 6.0 ]
+* // returns <ndarray>[ 1.0, 2.0, 3.0, 4.0, 5.0, 6.0 ]
 *
 * @example
 * var ndarray = require( '@stdlib/ndarray/ctor' );
-* var ndarray2array = require( '@stdlib/ndarray/to-array' );
 *
 * var xbuf = [ 1.0, null, 2.0, null, 3.0, null, 4.0, null, 5.0, null, 6.0, null ];
 *
@@ -172,14 +147,10 @@ var COL_MAJOR = 'column-major';
 * // returns <ndarray>
 *
 * var y = flatten( x );
-* // returns <ndarray>
-*
-* var arr = ndarray2array( y );
-* // returns [ 6.0, 5.0, 4.0, 3.0, 2.0, 1.0 ]
+* // returns <ndarray>[ 6.0, 5.0, 4.0, 3.0, 2.0, 1.0 ]
 *
 * @example
 * var ndarray = require( '@stdlib/ndarray/ctor' );
-* var ndarray2array = require( '@stdlib/ndarray/to-array' );
 *
 * var xbuf = [ 1.0, null, 2.0, null, 3.0, null, 4.0, null, 5.0, null, 6.0, null ];
 *
@@ -188,14 +159,10 @@ var COL_MAJOR = 'column-major';
 * // returns <ndarray>
 *
 * var y = flatten( x );
-* // returns <ndarray>
-*
-* var arr = ndarray2array( y );
-* // returns [ 6.0, 5.0, 4.0, 3.0, 2.0, 1.0 ]
+* // returns <ndarray>[ 6.0, 5.0, 4.0, 3.0, 2.0, 1.0 ]
 *
 * @example
 * var ndarray = require( '@stdlib/ndarray/ctor' );
-* var ndarray2array = require( '@stdlib/ndarray/to-array' );
 *
 * var xbuf = [ 1.0, null, 2.0, null, 3.0, null, 4.0, null, 5.0, null, 6.0, null ];
 *
@@ -206,14 +173,10 @@ var COL_MAJOR = 'column-major';
 * var y = flatten( x, {
 *     'order': 'same'
 * });
-* // returns <ndarray>
-*
-* var arr = ndarray2array( y );
-* // returns [ 6.0, 3.0, 5.0, 2.0, 4.0, 1.0 ]
+* // returns <ndarray>[ 6.0, 3.0, 5.0, 2.0, 4.0, 1.0 ]
 *
 * @example
 * var ndarray = require( '@stdlib/ndarray/ctor' );
-* var ndarray2array = require( '@stdlib/ndarray/to-array' );
 *
 * var xbuf = [ 1.0, null, 2.0, null, 3.0, null, 4.0, null, 5.0, null, 6.0, null ];
 *
@@ -224,14 +187,10 @@ var COL_MAJOR = 'column-major';
 * var y = flatten( x, {
 *     'order': 'any'
 * });
-* // returns <ndarray>
-*
-* var arr = ndarray2array( y );
-* // returns [ 6.0, 5.0, 4.0, 3.0, 2.0, 1.0 ]
+* // returns <ndarray>[ 6.0, 5.0, 4.0, 3.0, 2.0, 1.0 ]
 *
 * @example
 * var ndarray = require( '@stdlib/ndarray/ctor' );
-* var ndarray2array = require( '@stdlib/ndarray/to-array' );
 *
 * var xbuf = [ 1.0, null, 2.0, null, 3.0, null, 4.0, null, 5.0, null, 6.0, null ];
 *
@@ -240,14 +199,10 @@ var COL_MAJOR = 'column-major';
 * // returns <ndarray>
 *
 * var y = flatten( x );
-* // returns <ndarray>
-*
-* var arr = ndarray2array( y );
-* // returns [ 6.0, 4.0, 2.0, 5.0, 3.0, 1.0 ]
+* // returns <ndarray>[ 6.0, 4.0, 2.0, 5.0, 3.0, 1.0 ]
 *
 * @example
 * var ndarray = require( '@stdlib/ndarray/ctor' );
-* var ndarray2array = require( '@stdlib/ndarray/to-array' );
 *
 * var xbuf = [ 1.0, null, 2.0, null, 3.0, null, 4.0, null, 5.0, null, 6.0, null ];
 *
@@ -258,14 +213,10 @@ var COL_MAJOR = 'column-major';
 * var y = flatten( x, {
 *     'order': 'same'
 * });
-* // returns <ndarray>
-*
-* var arr = ndarray2array( y );
-* // returns [ 6.0, 4.0, 2.0, 5.0, 3.0, 1.0 ]
+* // returns <ndarray>[ 6.0, 4.0, 2.0, 5.0, 3.0, 1.0 ]
 *
 * @example
 * var ndarray = require( '@stdlib/ndarray/ctor' );
-* var ndarray2array = require( '@stdlib/ndarray/to-array' );
 *
 * var xbuf = [ 1.0, null, 2.0, null, 3.0, null, 4.0, null, 5.0, null, 6.0, null ];
 *
@@ -276,10 +227,7 @@ var COL_MAJOR = 'column-major';
 * var y = flatten( x, {
 *     'order': 'any'
 * });
-* // returns <ndarray>
-*
-* var arr = ndarray2array( y );
-* // returns [ 6.0, 5.0, 4.0, 3.0, 2.0, 1.0 ]
+* // returns <ndarray>[ 6.0, 5.0, 4.0, 3.0, 2.0, 1.0 ]
 */
 function flatten( x, options ) {
 	var view;