From 5605a70e09419122893a9a0db865bb5e36ab7e44 Mon Sep 17 00:00:00 2001
From: ShreelaxmiHegde <shreelaxmihegde9@gmail.com>
Date: Sat, 10 Jan 2026 07:21:51 +0000
Subject: [PATCH] docs: improve doctests for ndarray instances in
 ndarray/flatten-from

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

diff --git a/lib/node_modules/@stdlib/ndarray/flatten-from/README.md b/lib/node_modules/@stdlib/ndarray/flatten-from/README.md
index 172efb3300d1..7e288bd03bbd 100644
--- a/lib/node_modules/@stdlib/ndarray/flatten-from/README.md
+++ b/lib/node_modules/@stdlib/ndarray/flatten-from/README.md
@@ -42,16 +42,12 @@ Returns a copy of an input [ndarray][@stdlib/ndarray/ctor] where all dimensions
 
 ```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 = flattenFrom( x, 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 ] ]
 ```
 
 The function accepts the following arguments:
@@ -77,7 +73,6 @@ By default, the input [ndarray][@stdlib/ndarray/ctor] is flattened in lexicograp
 
 ```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>
@@ -85,10 +80,7 @@ var x = array( [ [ [ 1.0, 2.0 ] ], [ [ 3.0, 4.0 ] ], [ [ 5.0, 6.0 ] ] ] );
 var y = flattenFrom( x, 0, {
     '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.
@@ -96,7 +88,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>
@@ -104,13 +95,10 @@ var x = array( [ [ [ 1.0, 2.0 ] ], [ [ 3.0, 4.0 ] ], [ [ 5.0, 6.0 ] ] ] );
 var y = flattenFrom( x, 0, {
     '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-from/docs/repl.txt b/lib/node_modules/@stdlib/ndarray/flatten-from/docs/repl.txt
index bfe2f6ea9597..087eb1476335 100644
--- a/lib/node_modules/@stdlib/ndarray/flatten-from/docs/repl.txt
+++ b/lib/node_modules/@stdlib/ndarray/flatten-from/docs/repl.txt
@@ -43,9 +43,8 @@
     Examples
     --------
     > var x = {{alias:@stdlib/ndarray/array}}( [ [ 1.0, 2.0 ], [ 3.0, 4.0 ] ] );
-    > var y = {{alias}}( x, 0 );
-    > var arr = {{alias:@stdlib/ndarray/to-array}}( y )
-    [ 1.0, 2.0, 3.0, 4.0 ]
+    > var y = {{alias}}( x, 0 )
+    <ndarray>[ 1.0, 2.0, 3.0, 4.0 ]
 
     See Also
     --------
diff --git a/lib/node_modules/@stdlib/ndarray/flatten-from/docs/types/index.d.ts b/lib/node_modules/@stdlib/ndarray/flatten-from/docs/types/index.d.ts
index e917c415ba16..e16c47dc228a 100644
--- a/lib/node_modules/@stdlib/ndarray/flatten-from/docs/types/index.d.ts
+++ b/lib/node_modules/@stdlib/ndarray/flatten-from/docs/types/index.d.ts
@@ -71,7 +71,6 @@ type Options<U> = BaseOptions & {
 * @example
 * var array = require( '@stdlib/ndarray/array' );
 * var shape = require( '@stdlib/ndarray/shape' );
-* var ndarray2array = require( '@stdlib/ndarray/to-array' );
 *
 * var x = array( [ [ [ 1.0, 2.0 ] ], [ [ 3.0, 4.0 ] ], [ [ 5.0, 6.0 ] ] ] );
 * // returns <ndarray>
@@ -80,13 +79,10 @@ type Options<U> = BaseOptions & {
 * // returns [ 3, 1, 2 ]
 *
 * var y = flattenFrom( x, 1 );
-* // returns <ndarray>
+* // returns <ndarray>[ [ 1.0, 2.0 ], [ 3.0, 4.0 ], [ 5.0, 6.0 ] ]
 *
 * var shy = shape( y );
 * // returns [ 3, 2 ]
-*
-* var arr = ndarray2array( y );
-* // returns [ [ 1.0, 2.0 ], [ 3.0, 4.0 ], [ 5.0, 6.0 ] ]
 */
 declare function flattenFrom<T extends ndarray>( x: T, dim: number, options?: BaseOptions ): T;
 
@@ -107,7 +103,6 @@ declare function flattenFrom<T extends ndarray>( x: T, dim: number, options?: Ba
 * @example
 * var array = require( '@stdlib/ndarray/array' );
 * var shape = require( '@stdlib/ndarray/shape' );
-* var ndarray2array = require( '@stdlib/ndarray/to-array' );
 *
 * var x = array( [ [ [ 1.0, 2.0 ] ], [ [ 3.0, 4.0 ] ], [ [ 5.0, 6.0 ] ] ] );
 * // returns <ndarray>
@@ -116,13 +111,10 @@ declare function flattenFrom<T extends ndarray>( x: T, dim: number, options?: Ba
 * // returns [ 3, 1, 2 ]
 *
 * var y = flattenFrom( x, 1 );
-* // returns <ndarray>
+* // returns <ndarray>[ [ 1.0, 2.0 ], [ 3.0, 4.0 ], [ 5.0, 6.0 ] ]
 *
 * var shy = shape( y );
 * // returns [ 3, 2 ]
-*
-* var arr = ndarray2array( y );
-* // returns [ [ 1.0, 2.0 ], [ 3.0, 4.0 ], [ 5.0, 6.0 ] ]
 */
 declare function flattenFrom<T = unknown, U extends keyof DataTypeMap<T> = 'generic'>( x: typedndarray<T>, dim: number, options: Options<U> ): DataTypeMap<T>[U];
 
diff --git a/lib/node_modules/@stdlib/ndarray/flatten-from/lib/index.js b/lib/node_modules/@stdlib/ndarray/flatten-from/lib/index.js
index b2ad4f7665b2..b0c59101be90 100644
--- a/lib/node_modules/@stdlib/ndarray/flatten-from/lib/index.js
+++ b/lib/node_modules/@stdlib/ndarray/flatten-from/lib/index.js
@@ -25,7 +25,6 @@
 *
 * @example
 * var array = require( '@stdlib/ndarray/array' );
-* var ndarray2array = require( '@stdlib/ndarray/to-array' );
 * var flattenFrom = require( '@stdlib/ndarray/flatten-from' );
 *
 * // Create an input ndarray:
@@ -34,10 +33,7 @@
 *
 * // Flatten the input ndarray:
 * var y = flattenFrom( x, 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 ] ]
 */
 
 // MODULES //
diff --git a/lib/node_modules/@stdlib/ndarray/flatten-from/lib/main.js b/lib/node_modules/@stdlib/ndarray/flatten-from/lib/main.js
index b91f5f520fe8..499dc1ab1c1a 100644
--- a/lib/node_modules/@stdlib/ndarray/flatten-from/lib/main.js
+++ b/lib/node_modules/@stdlib/ndarray/flatten-from/lib/main.js
@@ -64,20 +64,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 = flattenFrom( x, 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 ] ]
 *
 * @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 ],
@@ -86,14 +81,10 @@ var COL_MAJOR = 'column-major';
 * // returns <ndarray>
 *
 * var y = flattenFrom( x, 0 );
-* // 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 ],
@@ -104,14 +95,10 @@ var COL_MAJOR = 'column-major';
 * var y = flattenFrom( x, 0, {
 *     '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 ],
@@ -122,14 +109,10 @@ var COL_MAJOR = 'column-major';
 * var y = flattenFrom( x, 0, {
 *     '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 ],
@@ -140,14 +123,10 @@ var COL_MAJOR = 'column-major';
 * var y = flattenFrom( x, 0, {
 *     '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 ],
@@ -158,14 +137,10 @@ var COL_MAJOR = 'column-major';
 * var y = flattenFrom( x, 0, {
 *     '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 ];
 *
@@ -173,14 +148,10 @@ var COL_MAJOR = 'column-major';
 * // returns <ndarray>
 *
 * var y = flattenFrom( x, 0 );
-* // 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 ];
 *
@@ -189,14 +160,10 @@ var COL_MAJOR = 'column-major';
 * // returns <ndarray>
 *
 * var y = flattenFrom( x, 0 );
-* // 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 ];
 *
@@ -207,14 +174,10 @@ var COL_MAJOR = 'column-major';
 * var y = flattenFrom( x, 0, {
 *     '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 ];
 *
@@ -225,14 +188,10 @@ var COL_MAJOR = 'column-major';
 * var y = flattenFrom( x, 0, {
 *     '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 ];
 *
@@ -241,14 +200,10 @@ var COL_MAJOR = 'column-major';
 * // returns <ndarray>
 *
 * var y = flattenFrom( x, 0 );
-* // 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 ];
 *
@@ -259,14 +214,10 @@ var COL_MAJOR = 'column-major';
 * var y = flattenFrom( x, 0, {
 *     '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 ];
 *
@@ -277,10 +228,7 @@ var COL_MAJOR = 'column-major';
 * var y = flattenFrom( x, 0, {
 *     '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 flattenFrom( x, dim, options ) {
 	var view;