Auto-generated commit

Author: stdlib-bot

CHANGELOG.md

@@ -10,6 +10,7 @@
 
 ### Features
 
+-   [`b77641d`](https://github.com/stdlib-js/stdlib/commit/b77641d288f89a5333abf07b421cf54e575c5d03) - update `ndarray/base` TypeScript declarations [(#10558)](https://github.com/stdlib-js/stdlib/pull/10558)
 -   [`2db642e`](https://github.com/stdlib-js/stdlib/commit/2db642edf40e64407f05bcffcb3f0cdae718f8aa) - update `ndarray` TypeScript declarations [(#10560)](https://github.com/stdlib-js/stdlib/pull/10560)
 -   [`f91aca6`](https://github.com/stdlib-js/stdlib/commit/f91aca6650536cb46c7b4c41bd05a2a37e0fe475) - add `maybeBroadcastArrayExceptDimensions` to namespace
 -   [`5324e96`](https://github.com/stdlib-js/stdlib/commit/5324e9618a4b8688b4792ccceb146b348d9a9f2f) - add `ndarray/base/maybe-broadcast-array-except-dimensions` [(#10413)](https://github.com/stdlib-js/stdlib/pull/10413)
@@ -688,6 +689,11 @@
 
 ### BREAKING CHANGES
 
+-   [`b77641d`](https://github.com/stdlib-js/stdlib/commit/b77641d288f89a5333abf07b421cf54e575c5d03): add writable parameter to and always return a new ndarray in `removeSingletonDimensions`
+
+    -   To migrate, in order to preserve prior writable behavior, users should set the final parameter equal to a boolean indicating whether the input ndarray is writable. If not, pass `false`; if yes, pass `true`.
+        To preserve prior behavior in which the input ndarray is returned if it does not have singleton dimensions, use `maybeRemoveSingletonDimensions`.
+
 -   [`9df924b`](https://github.com/stdlib-js/stdlib/commit/9df924b5f0b773c8b06d06b40e54dee75059ce08): add writable parameter
 
     -   To migrate and preserve prior behavior, users should always pass `true` for the second parameter.
@@ -775,6 +781,7 @@ A total of 44 issues were closed in this release:
 
 <details>
 
+-   [`b77641d`](https://github.com/stdlib-js/stdlib/commit/b77641d288f89a5333abf07b421cf54e575c5d03) - **feat:** update `ndarray/base` TypeScript declarations [(#10558)](https://github.com/stdlib-js/stdlib/pull/10558) _(by stdlib-bot)_
 -   [`2db642e`](https://github.com/stdlib-js/stdlib/commit/2db642edf40e64407f05bcffcb3f0cdae718f8aa) - **feat:** update `ndarray` TypeScript declarations [(#10560)](https://github.com/stdlib-js/stdlib/pull/10560) _(by stdlib-bot)_
 -   [`2cc758b`](https://github.com/stdlib-js/stdlib/commit/2cc758b7e8b6e3a713cadbabd6d13ad635cb2fcd) - **docs:** update namespace table of contents [(#10561)](https://github.com/stdlib-js/stdlib/pull/10561) _(by stdlib-bot)_
 -   [`f7bad8d`](https://github.com/stdlib-js/stdlib/commit/f7bad8d512bc207e4e25ed18a15b43a6e98540aa) - **test:** update test _(by Athan Reines)_

base/docs/types/index.d.ts

@@ -24,6 +24,7 @@ import any = require( './../../../base/any' );
 import anyBy = require( './../../../base/any-by' );
 import assert = require( './../../../base/assert' );
 import assign = require( './../../../base/assign' );
+import atleastnd = require( './../../../base/atleastnd' );
 import binary = require( './../../../base/binary' );
 import binaryInputCastingDataType = require( './../../../base/binary-input-casting-dtype' );
 import binaryLoopOrder = require( './../../../base/binary-loop-interchange-order' );
@@ -163,6 +164,7 @@ import toFlippedud = require( './../../../base/to-flippedud' );
 import toNormalizedIndices = require( './../../../base/to-normalized-indices' );
 import toReversed = require( './../../../base/to-reversed' );
 import toReversedDimension = require( './../../../base/to-reversed-dimension' );
+import toTransposed = require( './../../../base/to-transposed' );
 import toUniqueNormalizedIndices = require( './../../../base/to-unique-normalized-indices' );
 import transpose = require( './../../../base/transpose' );
 import unary = require( './../../../base/unary' );
@@ -180,6 +182,7 @@ import unaryReduceSubarrayBy = require( './../../../base/unary-reduce-subarray-b
 import unaryStrided1dDispatch = require( './../../../base/unary-strided1d-dispatch' );
 import unaryStrided1dDispatchFactory = require( './../../../base/unary-strided1d-dispatch-factory' );
 import unaryBlockSize = require( './../../../base/unary-tiling-block-size' );
+import unflattenShape = require( './../../../base/unflatten-shape' );
 import vind2bind = require( './../../../base/vind2bind' );
 import wrapIndex = require( './../../../base/wrap-index' );
 import zeros = require( './../../../base/zeros' );
@@ -301,6 +304,27 @@ interface Namespace {
 	*/
 	assign: typeof assign;
 
+	/**
+	* Converts a list of values (scalars and/or ndarrays) to ndarrays having at least a specified number of dimensions.
+	*
+	* @param ndims - minimum number of dimensions
+	* @param arrays - array-like object containing a list of scalars and/or ndarrays
+	* @returns an array of ndarrays
+	*
+	* @example
+	* var array = require( './../../../array' );
+	*
+	* var x = array( [ [ [ 1.0, 2.0 ] ], [ [ 3.0, 4.0 ] ] ] );
+	* // returns <ndarray>[ [ [ 1.0, 2.0 ] ], [ [ 3.0, 4.0 ] ] ]
+	*
+	* var y = array( [ [ 5.0, 6.0 ], [ 7.0, 8.0 ] ] );
+	* // returns <ndarray>[ [ 5.0, 6.0 ], [ 7.0, 8.0 ] ]
+	*
+	* var out = ns.atleastnd( 3, [ x, y ] );
+	* // returns [ <ndarray>, <ndarray> ]
+	*/
+	atleastnd: typeof atleastnd;
+
 	/**
 	* Applies a binary callback to elements in input ndarrays and assigns results to elements in an output ndarray.
 	*
@@ -3378,14 +3402,14 @@ interface Namespace {
 	quinaryBlockSize: typeof quinaryBlockSize;
 
 	/**
-	* Returns an array without singleton dimensions.
+	* Returns an ndarray without singleton dimensions.
 	*
 	* ## Notes
 	*
-	* -   If a provided ndarray does not have any singleton dimensions, the function returns the provided ndarray unchanged.
-	* -   If a provided ndarray does have singleton dimensions, the function returns a new ndarray view.
+	* -   The function always returns a new ndarray instance even if the input ndarray does not contain any singleton dimensions.
 	*
 	* @param x - input array
+	* @param writable - boolean indicating whether a returned array should be writable
 	* @returns squeezed array
 	*
 	* @example
@@ -3394,28 +3418,10 @@ interface Namespace {
 	* var x = array( [ [ 1, 2 ], [ 3, 4 ] ], {
 	*     'ndmin': 5
 	* });
-	* // returns <ndarray>
-	*
-	* var shx = x.shape;
-	* // returns [ 1, 1, 1, 2, 2 ]
-	*
-	* var y = ns.removeSingletonDimensions( x );
-	* // returns <ndarray>
-	*
-	* var shy = y.shape;
-	* // returns [ 2, 2 ]
-	*
-	* var v = y.get( 0, 0 );
-	* // returns 1
-	*
-	* v = y.get( 0, 1 );
-	* // returns 2
-	*
-	* v = y.get( 1, 0 );
-	* // returns 3
+	* // returns <ndarray>[ [ [ [ [ 1, 2 ], [ 3, 4 ] ] ] ] ]
 	*
-	* v = y.get( 1, 1 );
-	* // returns 4
+	* var y = ns.removeSingletonDimensions( x, false );
+	* // returns <ndarray>[ [ 1, 2 ], [ 3, 4 ] ]
 	*/
 	removeSingletonDimensions: typeof removeSingletonDimensions;
 
@@ -4598,6 +4604,23 @@ interface Namespace {
 	*/
 	toReversedDimension: typeof toReversedDimension;
 
+	/**
+	* Returns a new ndarray containing the elements of an input ndarray but whose last two dimensions are transposed.
+	*
+	* @param x - input array
+	* @returns output ndarray
+	*
+	* @example
+	* var array = require( './../../../array' );
+	*
+	* var x = array( [ [ 1, 2, 3 ], [ 4, 5, 6 ] ] );
+	* // returns <ndarray>[ [ 1, 2, 3 ], [ 4, 5, 6 ] ]
+	*
+	* var out = ns.toTransposed( x );
+	* // returns <ndarray>[ [ 1, 4 ], [ 2, 5 ], [ 3, 6 ] ]
+	*/
+	toTransposed: typeof toTransposed;
+
 	/**
 	* Returns a list of unique indices after normalizing to the interval `[0,max]`.
 	*
@@ -5198,6 +5221,29 @@ interface Namespace {
 	*/
 	unaryBlockSize: typeof unaryBlockSize;
 
+	/**
+	* Expands a dimension over multiple dimensions.
+	*
+	* @param shape - array shape
+	* @param dim - dimension to be unflattened
+	* @param sizes - new shape of the unflattened dimension
+	* @returns unflattened shape
+	*
+	* @example
+	* var sh = ns.unflattenShape( [ 6, 2, 1 ], 0, [ 3, 2 ] );
+	* // returns [ 3, 2, 2, 1 ]
+	*
+	* @example
+	* var o = [ 0, 0, 0, 0 ];
+	*
+	* var out = ns.unflattenShape.assign( [ 6, 2, 1 ], 0, [ 3, 2 ], o );
+	* // returns [ 3, 2, 2, 1 ]
+	*
+	* var bool = ( out === o );
+	* // returns true
+	*/
+	unflattenShape: typeof unflattenShape;
+
 	/**
 	* Converts a linear index in an array view to a linear index in an underlying data buffer.
 	*