feat: add array/base/nested2objects

---
type: pre_commit_static_analysis_report
description: Results of running static analysis checks when committing changes.
report:
  - task: lint_filenames
    status: passed
  - task: lint_editorconfig
    status: passed
  - task: lint_markdown
    status: passed
  - task: lint_package_json
    status: passed
  - task: lint_repl_help
    status: passed
  - task: lint_javascript_src
    status: passed
  - task: lint_javascript_cli
    status: na
  - task: lint_javascript_examples
    status: passed
  - task: lint_javascript_tests
    status: passed
  - task: lint_javascript_benchmarks
    status: passed
  - task: lint_python
    status: na
  - task: lint_r
    status: na
  - task: lint_c_src
    status: na
  - task: lint_c_examples
    status: na
  - task: lint_c_benchmarks
    status: na
  - task: lint_c_tests_fixtures
    status: na
  - task: lint_shell
    status: na
  - task: lint_typescript_declarations
    status: passed
  - task: lint_typescript_tests
    status: passed
  - task: lint_license_headers
    status: passed
---

Author: kgryte

lib/node_modules/@stdlib/array/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 -->

lib/node_modules/@stdlib/array/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( '@stdlib/array/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, [ 10, 10 ] );
+
+	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();
+});

lib/node_modules/@stdlib/array/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
+    --------
+

lib/node_modules/@stdlib/array/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;

lib/node_modules/@stdlib/array/base/nested2objects/docs/types/test.ts

@@ -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.
+*/
+
+import nested2objects = require( './index' );
+
+
+// TESTS //
+
+// The function returns an array of objects...
+{
+	nested2objects( [ [ 1, 2 ] ], [ 'x', 'y' ] ); // $ExpectType Record<"x" | "y", number>[]
+}
+
+// The compiler throws an error if the function is provided a first argument which is not an array-like object...
+{
+	nested2objects( 1, [ 'x', 'y' ] ); // $ExpectError
+	nested2objects( true, [ 'x', 'y' ] ); // $ExpectError
+	nested2objects( false, [ 'x', 'y' ] ); // $ExpectError
+	nested2objects( null, [ 'x', 'y' ] ); // $ExpectError
+	nested2objects( void 0, [ 'x', 'y' ] ); // $ExpectError
+	nested2objects( {}, [ 'x', 'y' ] ); // $ExpectError
+}
+
+// The compiler throws an error if the function is provided a second argument which is not an array-like object...
+{
+	nested2objects( [], 1 ); // $ExpectError
+	nested2objects( [], true ); // $ExpectError
+	nested2objects( [], false ); // $ExpectError
+	nested2objects( [], null ); // $ExpectError
+	nested2objects( [], void 0 ); // $ExpectError
+	nested2objects( [], {} ); // $ExpectError
+}
+
+// The compiler throws an error if the function is provided an unsupported number of arguments...
+{
+	nested2objects(); // $ExpectError
+	nested2objects( [] ); // $ExpectError
+	nested2objects( [], [], [] ); // $ExpectError
+}

lib/node_modules/@stdlib/array/base/nested2objects/examples/index.js

@@ -0,0 +1,30 @@
+/**
+* @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';
+
+var discreteUniform = require( '@stdlib/random/base/discrete-uniform' ).factory;
+var filled2dBy = require( '@stdlib/array/base/filled2d-by' );
+var nested2objects = require( './../lib' );
+
+var x = filled2dBy( [ 10, 2 ], discreteUniform( -100, 100 ) );
+var fields = [ 'x', 'y' ];
+
+var out = nested2objects( x, fields );
+console.log( out );
+// => [...]

lib/node_modules/@stdlib/array/base/nested2objects/lib/index.js

@@ -0,0 +1,43 @@
+/**
+* @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';
+
+/**
+* Convert nested arrays to objects.
+*
+* @module @stdlib/array/base/nested2objects
+*
+* @example
+* var nested2objects = require( '@stdlib/array/base/nested2objects' );
+*
+* var x = [ [ 1, 2 ], [ 3, 4 ] ];
+* var fields = [ 'x', 'y' ];
+*
+* var out = nested2objects( x, fields );
+* // returns [ { 'x': 1, 'y': 2 }, { 'x': 3, 'y': 4 } ]
+*/
+
+// MODULES //
+
+var main = require( './main.js' );
+
+
+// EXPORTS //
+
+module.exports = main;