Auto-generated commit

Author: stdlib-bot

CHANGELOG.md

@@ -10,6 +10,10 @@
 
 ### Features
 
+-   [`1535192`](https://github.com/stdlib-js/stdlib/commit/1535192162a5b372854dd62cb028c2c5e32d7c0a) - add `nested2views` to namespace
+-   [`e484f42`](https://github.com/stdlib-js/stdlib/commit/e484f42a6bd37fcafb4309bcecad5c4270c132cc) - add `array/base/nested2views`
+-   [`e83fc9a`](https://github.com/stdlib-js/stdlib/commit/e83fc9abdd3c0bbd6d7ba91794ced8774757aeae) - add `nested2objects` to namespace
+-   [`0c087b7`](https://github.com/stdlib-js/stdlib/commit/0c087b783f86d415abe0a0698b54b6755f72cbaa) - add `array/base/nested2objects`
 -   [`0482e74`](https://github.com/stdlib-js/stdlib/commit/0482e7449c3d3d59fd0f89f1352cb90e59127756) - add `entries2views` to namespace
 -   [`7e5f17b`](https://github.com/stdlib-js/stdlib/commit/7e5f17bf1d04ec84b0c137454a467ebee1370cf0) - add `array/base/entries2views`
 -   [`62be202`](https://github.com/stdlib-js/stdlib/commit/62be202d080ca6b785ae018c95570242cbbf5873) - add `entries2objects` to namespace
@@ -142,6 +146,8 @@
 
 ### Bug Fixes
 
+-   [`f53879d`](https://github.com/stdlib-js/stdlib/commit/f53879de98a2f80792d3d97c7748fd7425800aac) - ensure support for outer accessor arrays
+-   [`5741019`](https://github.com/stdlib-js/stdlib/commit/57410198f53879784c97784af6bbe0b482b235ae) - ensure accessor support for provided fields
 -   [`2a0ea7f`](https://github.com/stdlib-js/stdlib/commit/2a0ea7feb22806685fef9eac8a32d7012dab7adc) - use correct package names in package.json
 -   [`d3426a4`](https://github.com/stdlib-js/stdlib/commit/d3426a41ee92d8024bf7fc03d200aa98fb62a6f0) - use correct dimensions for array
 -   [`aa59ef8`](https://github.com/stdlib-js/stdlib/commit/aa59ef8461be08dc612cf4826bb020915d362239) - pass in correct number of arguments
@@ -231,6 +237,16 @@ A total of 32 issues were closed in this release:
 
 <details>
 
+-   [`d25ee66`](https://github.com/stdlib-js/stdlib/commit/d25ee665c0ae01b053bb4aeae117db1a27a282fd) - **bench:** fix sample array _(by Athan Reines)_
+-   [`4fd7c3c`](https://github.com/stdlib-js/stdlib/commit/4fd7c3c4193f809283db6672754b35bbe00fd79f) - **bench:** fix sample array _(by Athan Reines)_
+-   [`1535192`](https://github.com/stdlib-js/stdlib/commit/1535192162a5b372854dd62cb028c2c5e32d7c0a) - **feat:** add `nested2views` to namespace _(by Athan Reines)_
+-   [`e484f42`](https://github.com/stdlib-js/stdlib/commit/e484f42a6bd37fcafb4309bcecad5c4270c132cc) - **feat:** add `array/base/nested2views` _(by Athan Reines)_
+-   [`f389a19`](https://github.com/stdlib-js/stdlib/commit/f389a19fcb158cc48a624577d2dea87391a0be13) - **refactor:** remove unnecessary variable _(by Athan Reines)_
+-   [`e83fc9a`](https://github.com/stdlib-js/stdlib/commit/e83fc9abdd3c0bbd6d7ba91794ced8774757aeae) - **feat:** add `nested2objects` to namespace _(by Athan Reines)_
+-   [`f53879d`](https://github.com/stdlib-js/stdlib/commit/f53879de98a2f80792d3d97c7748fd7425800aac) - **fix:** ensure support for outer accessor arrays _(by Athan Reines)_
+-   [`0c087b7`](https://github.com/stdlib-js/stdlib/commit/0c087b783f86d415abe0a0698b54b6755f72cbaa) - **feat:** add `array/base/nested2objects` _(by Athan Reines)_
+-   [`5741019`](https://github.com/stdlib-js/stdlib/commit/57410198f53879784c97784af6bbe0b482b235ae) - **fix:** ensure accessor support for provided fields _(by Athan Reines)_
+-   [`7f0568c`](https://github.com/stdlib-js/stdlib/commit/7f0568c02fad49db0292ed2c15eed93e281b3d3f) - **bench:** fix descriptions _(by Athan Reines)_
 -   [`0482e74`](https://github.com/stdlib-js/stdlib/commit/0482e7449c3d3d59fd0f89f1352cb90e59127756) - **feat:** add `entries2views` to namespace _(by Athan Reines)_
 -   [`7e5f17b`](https://github.com/stdlib-js/stdlib/commit/7e5f17bf1d04ec84b0c137454a467ebee1370cf0) - **feat:** add `array/base/entries2views` _(by Athan Reines)_
 -   [`62be202`](https://github.com/stdlib-js/stdlib/commit/62be202d080ca6b785ae018c95570242cbbf5873) - **feat:** add `entries2objects` to namespace _(by Athan Reines)_

base/entries2objects/benchmark/benchmark.js

@@ -29,7 +29,7 @@ var entries2objects = require( './../lib' );
 
 // MAIN //
 
-bench( pkg+':len=100', function benchmark( b ) {
+bench( pkg+':len=10', function benchmark( b ) {
 	var labels;
 	var x;
 	var i;

base/entries2objects/lib/main.js

@@ -56,8 +56,9 @@ function entries2objects( arr, fields ) {
 	if ( N < 1 ) {
 		return [];
 	}
-	k = fields[ 0 ];
-	v = fields[ 1 ];
+	get = resolveGetter( fields );
+	k = get( fields, 0 );
+	v = get( fields, 1 );
 
 	get = resolveGetter( arr );
 	out = [];

base/entries2objects/test/test.js

@@ -83,7 +83,7 @@ tape( 'the function converts array entries to an array of objects (accessors)',
 
 	x = toAccessorArray( [ 1, 2 ] );
 
-	actual = entries2objects( x, fields );
+	actual = entries2objects( x, toAccessorArray( fields ) );
 	expected = [
 		{
 			'x': 0,

base/entries2views/benchmark/benchmark.js

@@ -29,7 +29,7 @@ var entries2views = require( './../lib' );
 
 // MAIN //
 
-bench( pkg+':len=100', function benchmark( b ) {
+bench( pkg+':len=10', function benchmark( b ) {
 	var fields;
 	var x;
 	var i;

base/lib/index.js

@@ -1350,6 +1350,24 @@ setReadOnly( ns, 'mskunary5d', require( './../../base/mskunary5d' ) );
 */
 setReadOnly( ns, 'nCartesianProduct', require( './../../base/n-cartesian-product' ) );
 
+/**
+* @name nested2objects
+* @memberof ns
+* @readonly
+* @type {Function}
+* @see {@link module:@stdlib/array/base/nested2objects}
+*/
+setReadOnly( ns, 'nested2objects', require( './../../base/nested2objects' ) );
+
+/**
+* @name nested2views
+* @memberof ns
+* @readonly
+* @type {Function}
+* @see {@link module:@stdlib/array/base/nested2views}
+*/
+setReadOnly( ns, 'nested2views', require( './../../base/nested2views' ) );
+
 /**
 * @name none
 * @memberof ns

base/nested2objects/README.md

@@ -0,0 +1,100 @@
+<!--
+
+@license Apache-2.0
+
+Copyright (c) 2025 The Stdlib Authors.
+
+Licensed under the Apache License, Version 2.0 (the "License");
+you may not use this file except in compliance with the License.
+You may obtain a copy of the License at
+
+   http://www.apache.org/licenses/LICENSE-2.0
+
+Unless required by applicable law or agreed to in writing, software
+distributed under the License is distributed on an "AS IS" BASIS,
+WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+See the License for the specific language governing permissions and
+limitations under the License.
+
+-->
+
+# nested2objects
+
+> Convert nested arrays to objects.
+
+<section class="usage">
+
+## Usage
+
+```javascript
+var nested2objects = require( '@stdlib/array/base/nested2objects' );
+```
+
+#### nested2objects( arr, fields )
+
+Converts each nested array to an object.
+
+```javascript
+var x = [ [ 1, 2 ], [ 3, 4 ] ];
+
+var fields = [ 'x', 'y' ];
+
+var out = nested2objects( x, fields );
+// returns [ { 'x': 1, 'y': 2 }, { 'x': 3, 'y': 4 } ]
+```
+
+The function supports the following parameters:
+
+-   **arr**: input array containing nested arrays.
+-   **fields**: list of field names.
+
+</section>
+
+<!-- /.usage -->
+
+<section class="notes">
+
+-   The function assumes that all nested arrays have the same length.
+-   The number of provided array labels should equal the length of each nested array.
+
+</section>
+
+<!-- /.notes -->
+
+<section class="examples">
+
+## Examples
+
+<!-- eslint no-undef: "error" -->
+
+```javascript
+var discreteUniform = require( '@stdlib/random/base/discrete-uniform' ).factory;
+var filled2dBy = require( '@stdlib/array/base/filled2d-by' );
+var nested2objects = require( '@stdlib/array/base/nested2objects' );
+
+var x = filled2dBy( [ 10, 2 ], discreteUniform( -100, 100 ) );
+var fields = [ 'x', 'y' ];
+
+var out = nested2objects( x, fields );
+// returns [...]
+```
+
+</section>
+
+<!-- /.examples -->
+
+<!-- Section for related `stdlib` packages. Do not manually edit this section, as it is automatically populated. -->
+
+<section class="related">
+
+</section>
+
+<!-- /.related -->
+
+<!-- Section for all links. Make sure to keep an empty line after the `section` element and another before the `/section` close. -->
+
+<section class="links">
+
+</section>
+
+<!-- /.links -->

base/nested2objects/benchmark/benchmark.js

@@ -0,0 +1,54 @@
+/**
+* @license Apache-2.0
+*
+* Copyright (c) 2025 The Stdlib Authors.
+*
+* Licensed under the Apache License, Version 2.0 (the "License");
+* you may not use this file except in compliance with the License.
+* You may obtain a copy of the License at
+*
+*    http://www.apache.org/licenses/LICENSE-2.0
+*
+* Unless required by applicable law or agreed to in writing, software
+* distributed under the License is distributed on an "AS IS" BASIS,
+* WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+* See the License for the specific language governing permissions and
+* limitations under the License.
+*/
+
+'use strict';
+
+// MODULES //
+
+var bench = require( '@stdlib/bench' );
+var isArray = require( '@stdlib/assert/is-array' );
+var filled2d = require( './../../../base/filled2d' );
+var pkg = require( './../package.json' ).name;
+var nested2objects = require( './../lib' );
+
+
+// MAIN //
+
+bench( pkg+':size=100', function benchmark( b ) {
+	var fields;
+	var x;
+	var i;
+	var v;
+
+	fields = [ 'x', 'y' ];
+	x = filled2d( 10, [ 50, 2 ] );
+
+	b.tic();
+	for ( i = 0; i < b.iterations; i++ ) {
+		v = nested2objects( x, fields );
+		if ( typeof v !== 'object' ) {
+			b.fail( 'should return an array' );
+		}
+	}
+	b.toc();
+	if ( !isArray( v ) ) {
+		b.fail( 'should return an array' );
+	}
+	b.pass( 'benchmark finished' );
+	b.end();
+});

base/nested2objects/docs/repl.txt

@@ -0,0 +1,32 @@
+
+{{alias}}( arr, fields )
+    Converts each nested array to an object.
+
+    The function assumes that all nested arrays have the same length.
+
+    The number of provided array labels should equal the length of each nested
+    array.
+
+    Parameters
+    ----------
+    arr: ArrayLikeObject<ArrayLikeObject>
+        Input array containing nested arrays.
+
+    fields: ArrayLikeObject
+        List of field names.
+
+    Returns
+    -------
+    out: Array<Object>
+        Output array.
+
+    Examples
+    --------
+    > var x = [ [ 1, 2 ], [ 3, 4 ] ];
+    > var f = [ 'x', 'y' ];
+    > var out = {{alias}}( x, f )
+    [ { 'x': 1, 'y': 2 }, { 'x': 3, 'y': 4 } ]
+
+    See Also
+    --------
+

base/nested2objects/docs/types/index.d.ts

@@ -0,0 +1,55 @@
+/*
+* @license Apache-2.0
+*
+* Copyright (c) 2025 The Stdlib Authors.
+*
+* Licensed under the Apache License, Version 2.0 (the "License");
+* you may not use this file except in compliance with the License.
+* You may obtain a copy of the License at
+*
+*    http://www.apache.org/licenses/LICENSE-2.0
+*
+* Unless required by applicable law or agreed to in writing, software
+* distributed under the License is distributed on an "AS IS" BASIS,
+* WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+* See the License for the specific language governing permissions and
+* limitations under the License.
+*/
+
+// TypeScript Version: 4.1
+
+/// <reference types="@stdlib/types"/>
+
+import { Collection, AccessorArrayLike, ArrayLike } from '@stdlib/types/array';
+
+/**
+* Property key.
+*/
+type PropertyKey = string | number | symbol;
+
+/**
+* Converts each nested array to an object.
+*
+*
+* ## Notes
+*
+* -   The function assumes that all nested arrays have the same length.
+* -   The number of provided array labels should equal the length of each nested array.
+*
+* @param arr - input array
+* @param fields - list of field names
+* @returns output array
+*
+* @example
+* var x = [ [ 1, 2 ], [ 3, 4 ] ];
+* var fields = [ 'x', 'y' ];
+*
+* var out = nested2objects( x, fields );
+* // returns [ { 'x': 1, 'y': 2 }, { 'x': 3, 'y': 4 } ]
+*/
+declare function nested2objects<T = unknown, U extends PropertyKey = PropertyKey>( arr: ArrayLike<Collection<T> | AccessorArrayLike<T>>, fields: Collection<U> | AccessorArrayLike<U> ): Array<Record<U, T>>;
+
+
+// EXPORTS //
+
+export = nested2objects;