@stdlib/utils-map-reduce 0.0.1 → 0.2.0

package/LICENSE

@@ -175,307 +175,3 @@
       of your accepting any such warranty or additional liability.
 
    END OF TERMS AND CONDITIONS
-
-
-
-Boost Software License - Version 1.0 - August 17th, 2003
-
-Permission is hereby granted, free of charge, to any person or organization
-obtaining a copy of the software and accompanying documentation covered by this
-license (the "Software") to use, reproduce, display, distribute, execute, and
-transmit the Software, and to prepare derivative works of the Software, and to
-permit third-parties to whom the Software is furnished to do so, all subject to
-the following:
-
-The copyright notices in the Software and this entire statement, including the
-above license grant, this restriction and the following disclaimer, must be
-included in all copies of the Software, in whole or in part, and all derivative
-works of the Software, unless such copies or derivative works are solely in the
-form of machine-executable object code generated by a source language processor.
-
-THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
-IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS
-FOR A PARTICULAR PURPOSE, TITLE AND NON-INFRINGEMENT. IN NO EVENT SHALL THE
-COPYRIGHT HOLDERS OR ANYONE DISTRIBUTING THE SOFTWARE BE LIABLE FOR ANY DAMAGES
-OR OTHER LIABILITY, WHETHER IN CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF
-OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.
-
-
-
-
-DEPENDENCIES
-
-The library links against the following external libraries, which have their own
-licenses:
-
-* OpenBLAS <https://raw.githubusercontent.com/xianyi/OpenBLAS/
-def146efed8d5908ea04e22668feeab7099599a0/LICENSE>
-
-Copyright (c) 2011-2014, The OpenBLAS Project
-All rights reserved.
-
-Redistribution and use in source and binary forms, with or without
-modification, are permitted provided that the following conditions are
-met:
-
-   1. Redistributions of source code must retain the above copyright
-      notice, this list of conditions and the following disclaimer.
-
-   2. Redistributions in binary form must reproduce the above copyright
-      notice, this list of conditions and the following disclaimer in
-      the documentation and/or other materials provided with the
-      distribution.
-
-   3. Neither the name of the OpenBLAS project nor the names of
-      its contributors may be used to endorse or promote products
-      derived from this software without specific prior written
-      permission.
-
-THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS"
-AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
-IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
-ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT OWNER OR CONTRIBUTORS BE
-LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR
-CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE
-GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
-HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT
-LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF
-THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
-
-
-* Electron <https://raw.githubusercontent.com/electron/electron/
-c4cfb3e7110266b9d7ad80e1ae097c4db564501c/LICENSE>
-
-Copyright (c) 2013-2017 GitHub Inc.
-
-Permission is hereby granted, free of charge, to any person obtaining
-a copy of this software and associated documentation files (the
-"Software"), to deal in the Software without restriction, including
-without limitation the rights to use, copy, modify, merge, publish,
-distribute, sublicense, and/or sell copies of the Software, and to
-permit persons to whom the Software is furnished to do so, subject to
-the following conditions:
-
-The above copyright notice and this permission notice shall be
-included in all copies or substantial portions of the Software.
-
-THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND,
-EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF
-MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND
-NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE
-LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION
-OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION
-WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.
-
-
-* Boost <http://www.boost.org/LICENSE_1_0.txt>
-
-Boost Software License - Version 1.0 - August 17th, 2003
-
-Permission is hereby granted, free of charge, to any person or organization
-obtaining a copy of the software and accompanying documentation covered by
-this license (the "Software") to use, reproduce, display, distribute,
-execute, and transmit the Software, and to prepare derivative works of the
-Software, and to permit third-parties to whom the Software is furnished to
-do so, all subject to the following:
-
-The copyright notices in the Software and this entire statement, including
-the above license grant, this restriction and the following disclaimer,
-must be included in all copies of the Software, in whole or in part, and
-all derivative works of the Software, unless such copies or derivative
-works are solely in the form of machine-executable object code generated by
-a source language processor.
-
-THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
-IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
-FITNESS FOR A PARTICULAR PURPOSE, TITLE AND NON-INFRINGEMENT. IN NO EVENT
-SHALL THE COPYRIGHT HOLDERS OR ANYONE DISTRIBUTING THE SOFTWARE BE LIABLE
-FOR ANY DAMAGES OR OTHER LIABILITY, WHETHER IN CONTRACT, TORT OR OTHERWISE,
-ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER
-DEALINGS IN THE SOFTWARE.
-
-
-* Cephes <http://www.netlib.org/cephes/readme>
-
-Copyright (c) 1984-2000 Stephen L. Moshier
-
-Some software in this archive may be from the book _Methods and Programs for
-Mathematical Functions_ (Prentice-Hall or Simon & Schuster International, 1989)
-or from the Cephes Mathematical Library, a commercial product. In either event,
-it is copyrighted by the author. What you see here may be used freely but it
-comes with no support or guarantee.
-
-Stephen L. Moshier
-moshier@na-net.ornl.gov
-
-
-
-ATTRIBUTION
-
-The library contains implementations from the following external libraries,
-which have their own licenses:
-
-* FreeBSD <https://svnweb.freebsd.org/>
-
-Copyright (C) 1993-2004 by Sun Microsystems, Inc. All rights reserved.
-
-Developed at SunPro, a Sun Microsystems, Inc. business.
-Permission to use, copy, modify, and distribute this
-software is freely granted, provided that this notice
-is preserved.
-
-
-* FDLIBM <http://www.netlib.org/fdlibm/>
-
-Copyright (C) 2004 by Sun Microsystems, Inc. All rights reserved.
-
-Developed at SunPro, a Sun Microsystems, Inc. business.
-Permission to use, copy, modify, and distribute this
-software is freely granted, provided that this notice
-is preserved.
-
-
-* Go <https://raw.githubusercontent.com/golang/go/master/LICENSE>
-
-Copyright (c) 2009 The Go Authors. All rights reserved.
-
-Redistribution and use in source and binary forms, with or without
-modification, are permitted provided that the following conditions are
-met:
-
-   * Redistributions of source code must retain the above copyright
-notice, this list of conditions and the following disclaimer.
-   * Redistributions in binary form must reproduce the above
-copyright notice, this list of conditions and the following disclaimer
-in the documentation and/or other materials provided with the
-distribution.
-   * Neither the name of Google Inc. nor the names of its
-contributors may be used to endorse or promote products derived from
-this software without specific prior written permission.
-
-THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS
-"AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT
-LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR
-A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT
-OWNER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL,
-SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT
-LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE,
-DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY
-THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT
-(INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE
-OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
-
-
-* SLATEC Common Mathematical Library <http://www.netlib.no/netlib/slatec/>
-
-Public domain.
-
-
-* ESLint <https://raw.githubusercontent.com/eslint/eslint/master/LICENSE>
-
-Copyright JS Foundation and other contributors, https://js.foundation
-
-Permission is hereby granted, free of charge, to any person obtaining a copy
-of this software and associated documentation files (the "Software"), to deal
-in the Software without restriction, including without limitation the rights
-to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
-copies of the Software, and to permit persons to whom the Software is
-furnished to do so, subject to the following conditions:
-
-The above copyright notice and this permission notice shall be included in
-all copies or substantial portions of the Software.
-
-THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
-IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
-FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
-AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
-LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
-OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
-THE SOFTWARE.
-
-
-* StatsFuns.jl <https://raw.githubusercontent.com/JuliaStats/StatsFuns.jl/
-e66dd973650c375bc1739c820e5b96bb5bd000a8/LICENSE.md>
-
-Copyright (c) 2015: Dahua Lin.
-
-Permission is hereby granted, free of charge, to any person obtaining
-a copy of this software and associated documentation files (the
-"Software"), to deal in the Software without restriction, including
-without limitation the rights to use, copy, modify, merge, publish,
-distribute, sublicense, and/or sell copies of the Software, and to
-permit persons to whom the Software is furnished to do so, subject to
-the following conditions:
-
-The above copyright notice and this permission notice shall be
-included in all copies or substantial portions of the Software.
-
-THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND,
-EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF
-MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT.
-IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY
-CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT,
-TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE
-SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.
-
-
-* SpecialFunctions.jl <https://raw.githubusercontent.com/JuliaMath/
-SpecialFunctions.jl/02a173fbe24a61c4b392aec17a9764ac5727feb1/LICENSE>
-
-The MIT License (MIT)
-
-Copyright (c) 2017 Jeff Bezanson, Stefan Karpinski, Viral B. Shah, and others:
-
-https://github.com/JuliaMath/SpecialFunctions.jl/graphs/contributors
-
-Permission is hereby granted, free of charge, to any person obtaining a copy
-of this software and associated documentation files (the "Software"), to deal
-in the Software without restriction, including without limitation the rights
-to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
-copies of the Software, and to permit persons to whom the Software is
-furnished to do so, subject to the following conditions:
-
-The above copyright notice and this permission notice shall be included in all
-copies or substantial portions of the Software.
-
-THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
-IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
-FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
-AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
-LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
-OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
-SOFTWARE.
-
-
-* MT19937 <http://www.math.sci.hiroshima-u.ac.jp/~m-mat/MT/MT2002/CODES/
-mt19937ar.c>
-
-Copyright (C) 1997 - 2002, Makoto Matsumoto and Takuji Nishimura,
-All rights reserved.
-
-Redistribution and use in source and binary forms, with or without
-modification, are permitted provided that the following conditions
-are met:
-
- 1. Redistributions of source code must retain the above copyright
-    notice, this list of conditions and the following disclaimer.
-
- 2. Redistributions in binary form must reproduce the above copyright
-    notice, this list of conditions and the following disclaimer in the
-    documentation and/or other materials provided with the distribution.
-
- 3. The names of its contributors may not be used to endorse or promote
-    products derived from this software without specific prior written
-    permission.
-
-THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS
-"AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT
-LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR
-A PARTICULAR PURPOSE ARE DISCLAIMED.  IN NO EVENT SHALL THE COPYRIGHT
-OWNER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL,
-SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT
-LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE,
-DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY
-THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT
-(INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE
-OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.

package/NOTICE

@@ -1 +1 @@
-Copyright (c) 2016-2022 The Stdlib Authors.
+Copyright (c) 2016-2024 The Stdlib Authors.

package/README.md

@@ -18,6 +18,17 @@ limitations under the License.
 
 -->
 
+
+<details>
+  <summary>
+    About stdlib...
+  </summary>
+  <p>We believe in a future in which the web is a preferred environment for numerical computation. To help realize this future, we've built stdlib. stdlib is a standard library, with an emphasis on numerical and scientific computation, written in JavaScript (and C) for execution in browsers and in Node.js.</p>
+  <p>The library is fully decomposable, being architected in such a way that you can swap out and mix and match APIs and functionality to cater to your exact preferences and use cases.</p>
+  <p>When you use stdlib, you can be absolutely certain that you are using the most thorough, rigorous, well-written, studied, documented, tested, measured, and high-quality code out there.</p>
+  <p>To join us in bringing numerical computing to the web, get started by checking us out on <a href="https://github.com/stdlib-js/stdlib">GitHub</a>, and please consider <a href="https://opencollective.com/stdlib">financially supporting stdlib</a>. We greatly appreciate your continued support!</p>
+</details>
+
 # mapReduce
 
 [![NPM version][npm-image]][npm-url] [![Build Status][test-image]][test-url] [![Coverage Status][coverage-image]][coverage-url] <!-- [![dependencies][dependencies-image]][dependencies-url] -->
@@ -239,6 +250,14 @@ console.log( 'sum: %d', out );
 
 <section class="related">
 
+* * *
+
+## See Also
+
+-   <span class="package-name">[`@stdlib/utils-map`][@stdlib/utils/map]</span><span class="delimiter">: </span><span class="description">apply a function to each element in an array and assign the result to an element in an output array.</span>
+-   <span class="package-name">[`@stdlib/utils-map-reduce-right`][@stdlib/utils/map-reduce-right]</span><span class="delimiter">: </span><span class="description">perform a single-pass map-reduce operation against each element in an array while iterating from right to left and return the accumulated result.</span>
+-   <span class="package-name">[`@stdlib/utils-reduce`][@stdlib/utils/reduce]</span><span class="delimiter">: </span><span class="description">apply a function against an accumulator and each element in an array and return the accumulated result.</span>
+
 </section>
 
 <!-- /.related -->
@@ -269,7 +288,7 @@ See [LICENSE][stdlib-license].
 
 ## Copyright
 
-Copyright &copy; 2016-2022. The Stdlib [Authors][stdlib-authors].
+Copyright &copy; 2016-2024. The Stdlib [Authors][stdlib-authors].
 
 </section>
 
@@ -282,8 +301,8 @@ Copyright &copy; 2016-2022. The Stdlib [Authors][stdlib-authors].
 [npm-image]: http://img.shields.io/npm/v/@stdlib/utils-map-reduce.svg
 [npm-url]: https://npmjs.org/package/@stdlib/utils-map-reduce
 
-[test-image]: https://github.com/stdlib-js/utils-map-reduce/actions/workflows/test.yml/badge.svg
-[test-url]: https://github.com/stdlib-js/utils-map-reduce/actions/workflows/test.yml
+[test-image]: https://github.com/stdlib-js/utils-map-reduce/actions/workflows/test.yml/badge.svg?branch=v0.2.0
+[test-url]: https://github.com/stdlib-js/utils-map-reduce/actions/workflows/test.yml?query=branch:v0.2.0
 
 [coverage-image]: https://img.shields.io/codecov/c/github/stdlib-js/utils-map-reduce/main.svg
 [coverage-url]: https://codecov.io/github/stdlib-js/utils-map-reduce?branch=main
@@ -295,27 +314,41 @@ Copyright &copy; 2016-2022. The Stdlib [Authors][stdlib-authors].
 
 -->
 
+[chat-image]: https://img.shields.io/gitter/room/stdlib-js/stdlib.svg
+[chat-url]: https://app.gitter.im/#/room/#stdlib-js_stdlib:gitter.im
+
+[stdlib]: https://github.com/stdlib-js/stdlib
+
+[stdlib-authors]: https://github.com/stdlib-js/stdlib/graphs/contributors
+
 [umd]: https://github.com/umdjs/umd
 [es-module]: https://developer.mozilla.org/en-US/docs/Web/JavaScript/Guide/Modules
 
 [deno-url]: https://github.com/stdlib-js/utils-map-reduce/tree/deno
+[deno-readme]: https://github.com/stdlib-js/utils-map-reduce/blob/deno/README.md
 [umd-url]: https://github.com/stdlib-js/utils-map-reduce/tree/umd
+[umd-readme]: https://github.com/stdlib-js/utils-map-reduce/blob/umd/README.md
 [esm-url]: https://github.com/stdlib-js/utils-map-reduce/tree/esm
+[esm-readme]: https://github.com/stdlib-js/utils-map-reduce/blob/esm/README.md
+[branches-url]: https://github.com/stdlib-js/utils-map-reduce/blob/main/branches.md
 
-[chat-image]: https://img.shields.io/gitter/room/stdlib-js/stdlib.svg
-[chat-url]: https://gitter.im/stdlib-js/stdlib/
+[stdlib-license]: https://raw.githubusercontent.com/stdlib-js/utils-map-reduce/main/LICENSE
 
-[stdlib]: https://github.com/stdlib-js/stdlib
+[@stdlib/ndarray/ctor]: https://www.npmjs.com/package/@stdlib/ndarray-ctor
 
-[stdlib-authors]: https://github.com/stdlib-js/stdlib/graphs/contributors
+[@stdlib/array/complex64]: https://www.npmjs.com/package/@stdlib/array-complex64
 
-[stdlib-license]: https://raw.githubusercontent.com/stdlib-js/utils-map-reduce/main/LICENSE
+[@stdlib/array/complex128]: https://www.npmjs.com/package/@stdlib/array-complex128
+
+<!-- <related-links> -->
+
+[@stdlib/utils/map]: https://www.npmjs.com/package/@stdlib/utils-map
 
-[@stdlib/ndarray/ctor]: https://www.npmjs.com/package/@stdlib/stdlib
+[@stdlib/utils/map-reduce-right]: https://www.npmjs.com/package/@stdlib/utils-map-reduce-right
 
-[@stdlib/array/complex64]: https://www.npmjs.com/package/@stdlib/stdlib
+[@stdlib/utils/reduce]: https://www.npmjs.com/package/@stdlib/utils-reduce
 
-[@stdlib/array/complex128]: https://www.npmjs.com/package/@stdlib/stdlib
+<!-- </related-links> -->
 
 </section>
 

package/SECURITY.md

@@ -0,0 +1,5 @@
+# Security
+
+> Policy for reporting security vulnerabilities.
+
+See the security policy [in the main project repository](https://github.com/stdlib-js/stdlib/security).

package/dist/index.d.ts

@@ -0,0 +1,3 @@
+/// <reference path="../docs/types/index.d.ts" />
+import mapReduce from '../docs/types/index';
+export = mapReduce;

package/dist/index.js

@@ -0,0 +1,9 @@
+"use strict";var y=function(r,e){return function(){return e||r((e={exports:{}}).exports,e),e.exports}};var h=y(function(H,g){
+var T=require('@stdlib/ndarray-base-vind2bind/dist'),p="throw";function x(r,e,a,t,s){var n,v,i,u,f,c,l,m,d,q,o;if(u=r.length,l=r.shape,n=r.data,m=r.strides,d=r.offset,v=r.order,f=r.accessors[0],c=r.ref,l.length===0)return t.call(s,e,a(f(n,d),0,c),0,c);for(i=e,o=0;o<u;o++)q=T(l,m,d,v,o,p),i=t.call(s,i,a(f(n,q),o,c),o,c);return i}g.exports=x
+});var k=y(function(I,w){
+function R(r,e,a,t,s){var n,v,i,u;for(n=r.data,v=r.accessors[0],i=e,u=0;u<n.length;u++)i=t.call(s,i,a(v(n,u),u,n),u,n);return i}w.exports=R
+});var E=y(function(J,j){
+var V=require('@stdlib/assert-is-array-like-object/dist'),L=require('@stdlib/assert-is-ndarray-like/dist'),F=require('@stdlib/assert-is-function/dist'),O=require('@stdlib/ndarray-base-ndarraylike2object/dist'),D=require('@stdlib/array-base-arraylike2object/dist'),b=require('@stdlib/error-tools-fmtprodmsg/dist'),M=h(),z=k();function B(r,e,a,t,s){if(!F(a))throw new TypeError(b('1VN3N',a));if(!F(t))throw new TypeError(b('1VN32',t));if(L(r))return M(O(r),e,a,t,s);if(V(r))return z(D(r),e,a,t,s);throw new TypeError(b('1VNBH',r))}j.exports=B
+});var C=E();module.exports=C;
+/** @license Apache-2.0 */
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../lib/ndarray.js", "../lib/array.js", "../lib/main.js", "../lib/index.js"],
+  "sourcesContent": ["/**\n* @license Apache-2.0\n*\n* Copyright (c) 2022 The Stdlib Authors.\n*\n* Licensed under the Apache License, Version 2.0 (the \"License\");\n* you may not use this file except in compliance with the License.\n* You may obtain a copy of the License at\n*\n*    http://www.apache.org/licenses/LICENSE-2.0\n*\n* Unless required by applicable law or agreed to in writing, software\n* distributed under the License is distributed on an \"AS IS\" BASIS,\n* WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.\n* See the License for the specific language governing permissions and\n* limitations under the License.\n*/\n\n'use strict';\n\n// MODULES //\n\nvar vind2bind = require( '@stdlib/ndarray-base-vind2bind' );\n\n\n// VARIABLES //\n\nvar MODE = 'throw';\n\n\n// MAIN //\n\n/**\n* Performs a map-reduce operation against each element in an array and returns the accumulated result.\n*\n* @private\n* @param {Object} x - object containing input ndarray meta data\n* @param {string} x.ref - reference to original input ndarray-like object\n* @param {string} x.dtype - data type\n* @param {Collection} x.data - data buffer\n* @param {NonNegativeInteger} x.length - number of elements\n* @param {NonNegativeIntegerArray} x.shape - dimensions\n* @param {IntegerArray} x.strides - stride lengths\n* @param {NonNegativeInteger} x.offset - index offset\n* @param {string} x.order - specifies whether `x` is row-major (C-style) or column-major (Fortran-style)\n* @param {Array<Function>} x.accessors - accessors for accessing data buffer elements\n* @param {*} initial - initial value\n* @param {Function} mapper - mapping function\n* @param {Function} reducer - reducing function\n* @param {*} thisArg - reducing function execution context\n* @returns {*} accumulated result\n*\n* @example\n* var Complex64Array = require( '@stdlib/array-complex64' );\n* var Complex64 = require( '@stdlib/complex-float32' );\n* var realf = require( '@stdlib/complex-realf' );\n* var imagf = require( '@stdlib/complex-imagf' );\n* var cceil = require( '@stdlib/math-base-special-cceil' );\n* var cadd = require( '@stdlib/math-base-ops-cadd' );\n* var naryFunction = require( '@stdlib/utils-nary-function' );\n*\n* // Create a data buffer:\n* var xbuf = new Complex64Array( [ 1.5, 2.5, 3.5, 4.5, 5.5, 6.5, 7.5, 8.5 ] );\n*\n* // Define the shape of the input array:\n* var shape = [ 2, 2 ];\n*\n* // Define the array strides:\n* var sx = [ 2, 1 ];\n*\n* // Define the index offset:\n* var ox = 0;\n*\n* // Define a getter:\n* function getter( buf, idx ) {\n*     return buf.get( idx );\n* }\n*\n* // Create the input ndarray-like object:\n* var x = {\n*     'ref': null,\n*     'dtype': 'complex64',\n*     'data': xbuf,\n*     'length': 4,\n*     'shape': shape,\n*     'strides': sx,\n*     'offset': ox,\n*     'order': 'row-major',\n*     'accessors': [ getter ]\n* };\n* x.ref = x;\n*\n* // Compute the sum:\n* var v = mapReduce( x, new Complex64( 0.0, 0.0 ), naryFunction( cceil, 1 ), naryFunction( cadd, 2 ) );\n*\n* var re = realf( v );\n* // returns 20.0\n*\n* var im = imagf( v );\n* // returns 24.0\n*/\nfunction mapReduce( x, initial, mapper, reducer, thisArg ) {\n\tvar xbuf;\n\tvar ordx;\n\tvar acc;\n\tvar len;\n\tvar get;\n\tvar ref;\n\tvar shx;\n\tvar sx;\n\tvar ox;\n\tvar ix;\n\tvar i;\n\n\t// Cache the total number of elements over which to iterate:\n\tlen = x.length;\n\n\t// Cache the input array shape:\n\tshx = x.shape;\n\n\t// Cache reference to the input ndarray data buffer:\n\txbuf = x.data;\n\n\t// Cache reference to the stride array:\n\tsx = x.strides;\n\n\t// Cache the index of the first indexed element:\n\tox = x.offset;\n\n\t// Cache the array order:\n\tordx = x.order;\n\n\t// Cache the element accessor:\n\tget = x.accessors[ 0 ];\n\n\t// Cache the reference to the original input array:\n\tref = x.ref;\n\n\t// Check for a zero-dimensional array...\n\tif ( shx.length === 0 ) {\n\t\treturn reducer.call( thisArg, initial, mapper( get( xbuf, ox ), 0, ref ), 0, ref ); // eslint-disable-line max-len\n\t}\n\t// Iterate over each element based on the linear **view** index, regardless as to how the data is stored in memory (note: this has negative performance implications for non-contiguous ndarrays due to a lack of data locality)...\n\tacc = initial;\n\tfor ( i = 0; i < len; i++ ) {\n\t\tix = vind2bind( shx, sx, ox, ordx, i, MODE );\n\t\tacc = reducer.call( thisArg, acc, mapper( get( xbuf, ix ), i, ref ), i, ref ); // eslint-disable-line max-len\n\t}\n\treturn acc;\n}\n\n\n// EXPORTS //\n\nmodule.exports = mapReduce;\n", "/**\n* @license Apache-2.0\n*\n* Copyright (c) 2022 The Stdlib Authors.\n*\n* Licensed under the Apache License, Version 2.0 (the \"License\");\n* you may not use this file except in compliance with the License.\n* You may obtain a copy of the License at\n*\n*    http://www.apache.org/licenses/LICENSE-2.0\n*\n* Unless required by applicable law or agreed to in writing, software\n* distributed under the License is distributed on an \"AS IS\" BASIS,\n* WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.\n* See the License for the specific language governing permissions and\n* limitations under the License.\n*/\n\n'use strict';\n\n// MAIN //\n\n/**\n* Performs a map-reduce operation against each element in an array and returns the accumulated result.\n*\n* @private\n* @param {Object} x - object containing input array data\n* @param {ArrayLikeObject} x.data - input array data\n* @param {Array<Function>} x.accessors - input array accessors\n* @param {*} initial - initial value\n* @param {Function} mapper - mapping function\n* @param {Function} reducer - reducing function\n* @param {*} thisArg - reducing function execution context\n* @returns {*} accumulated result\n*\n* @example\n* function square( value ) {\n*     return value * value;\n* }\n*\n* function sum( acc, value ) {\n*     return acc + value;\n* }\n*\n* // Define a getter:\n* function getter( buf, idx ) {\n*     return buf[ idx ];\n* }\n*\n* // Create the input array object:\n* var x = {\n*     'data': [ 1, 2, 3, 4 ],\n*     'accessors': [ getter ]\n* };\n*\n* // Compute the sum of squared values:\n* var out = mapReduce( x, 0, square, sum );\n* // returns 30\n*/\nfunction mapReduce( x, initial, mapper, reducer, thisArg ) {\n\tvar xbuf;\n\tvar get;\n\tvar acc;\n\tvar i;\n\n\t// Cache reference to the input data:\n\txbuf = x.data;\n\n\t// Cache the element accessor:\n\tget = x.accessors[ 0 ];\n\n\t// Iterate over each element...\n\tacc = initial;\n\tfor ( i = 0; i < xbuf.length; i++ ) {\n\t\tacc = reducer.call( thisArg, acc, mapper( get( xbuf, i ), i, xbuf ), i, xbuf ); // eslint-disable-line max-len\n\t}\n\treturn acc;\n}\n\n\n// EXPORTS //\n\nmodule.exports = mapReduce;\n", "/**\n* @license Apache-2.0\n*\n* Copyright (c) 2022 The Stdlib Authors.\n*\n* Licensed under the Apache License, Version 2.0 (the \"License\");\n* you may not use this file except in compliance with the License.\n* You may obtain a copy of the License at\n*\n*    http://www.apache.org/licenses/LICENSE-2.0\n*\n* Unless required by applicable law or agreed to in writing, software\n* distributed under the License is distributed on an \"AS IS\" BASIS,\n* WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.\n* See the License for the specific language governing permissions and\n* limitations under the License.\n*/\n\n'use strict';\n\n// MODULES //\n\nvar isArrayLikeObject = require( '@stdlib/assert-is-array-like-object' );\nvar isndarrayLike = require( '@stdlib/assert-is-ndarray-like' );\nvar isFunction = require( '@stdlib/assert-is-function' );\nvar ndarraylike2object = require( '@stdlib/ndarray-base-ndarraylike2object' );\nvar arraylike2object = require( '@stdlib/array-base-arraylike2object' );\nvar format = require( '@stdlib/string-format' );\nvar ndarrayFcn = require( './ndarray.js' );\nvar arrayFcn = require( './array.js' );\n\n\n// MAIN //\n\n/**\n* Performs a map-reduce operation against each element in an array and returns the accumulated result.\n*\n* ## Notes\n*\n* -   The mapping function is provided the following arguments:\n*\n*     -   **value**: array element.\n*     -   **index**: element index.\n*     -   **arr**: input array.\n*\n* -   The reducing function is provided the following arguments:\n*\n*     -   **accumulator**: accumulated value.\n*     -   **value**: result of applying the mapping function against the current array element.\n*     -   **index**: element index.\n*     -   **arr**: input array.\n*\n* @param {(ArrayLikeObject|ndarray)} arr - input array\n* @param {*} initial - initial value\n* @param {Function} mapper - mapping function\n* @param {Function} reducer - reducing function\n* @param {*} [thisArg] - reduction function execution context\n* @throws {TypeError} first argument must be an array-like object or an ndarray\n* @throws {TypeError} third argument must be a function\n* @throws {TypeError} fourth argument must be a function\n* @returns {*} accumulated result\n*\n* @example\n* function square( value ) {\n*     return value * value;\n* }\n*\n* function sum( acc, value ) {\n*     return acc + value;\n* }\n*\n* var arr = [ 1, 2, 3, 4 ];\n*\n* var out = mapReduce( arr, 0, square, sum );\n* // returns 30\n*\n* @example\n* var naryFunction = require( '@stdlib/utils-nary-function' );\n* var add = require( '@stdlib/math-base-ops-add' );\n* var abs = require( '@stdlib/math-base-special-abs' );\n* var array = require( '@stdlib/ndarray-array' );\n*\n* var opts = {\n*     'dtype': 'generic'\n* };\n* var arr = array( [ [ -1, -2, -3 ], [ -4, -5, -6 ] ], opts );\n*\n* var out = mapReduce( arr, 0, naryFunction( abs, 1 ), naryFunction( add, 2 ) );\n* // returns 21\n*/\nfunction mapReduce( arr, initial, mapper, reducer, thisArg ) {\n\tif ( !isFunction( mapper ) ) {\n\t\tthrow new TypeError( format( 'invalid argument. Third argument must be a function. Value: `%s`.', mapper ) );\n\t}\n\tif ( !isFunction( reducer ) ) {\n\t\tthrow new TypeError( format( 'invalid argument. Fourth argument must be a function. Value: `%s`.', reducer ) );\n\t}\n\tif ( isndarrayLike( arr ) ) { // note: assertion order matters here, as an ndarray-like object is also array-like\n\t\treturn ndarrayFcn( ndarraylike2object( arr ), initial, mapper, reducer, thisArg ); // eslint-disable-line max-len\n\t}\n\tif ( isArrayLikeObject( arr ) ) {\n\t\treturn arrayFcn( arraylike2object( arr ), initial, mapper, reducer, thisArg ); // eslint-disable-line max-len\n\t}\n\tthrow new TypeError( format( 'invalid argument. First argument must be an array-like object or an ndarray. Value: `%s`.', arr ) );\n}\n\n\n// EXPORTS //\n\nmodule.exports = mapReduce;\n", "/**\n* @license Apache-2.0\n*\n* Copyright (c) 2022 The Stdlib Authors.\n*\n* Licensed under the Apache License, Version 2.0 (the \"License\");\n* you may not use this file except in compliance with the License.\n* You may obtain a copy of the License at\n*\n*    http://www.apache.org/licenses/LICENSE-2.0\n*\n* Unless required by applicable law or agreed to in writing, software\n* distributed under the License is distributed on an \"AS IS\" BASIS,\n* WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.\n* See the License for the specific language governing permissions and\n* limitations under the License.\n*/\n\n'use strict';\n\n/**\n* Perform a map-reduce operation against each element in an array and return the accumulated result.\n*\n* @module @stdlib/utils-map-reduce\n*\n* @example\n* var mapReduce = require( '@stdlib/utils-map-reduce' );\n*\n* function square( value ) {\n*     return value * value;\n* }\n*\n* function sum( acc, value ) {\n*     return acc + value;\n* }\n*\n* var arr = [ 1, 2, 3, 4 ];\n*\n* var out = mapReduce( arr, 0, sum );\n* // returns 30\n*\n* @example\n* var naryFunction = require( '@stdlib/utils-nary-function' );\n* var add = require( '@stdlib/math-base-ops-add' );\n* var abs = require( '@stdlib/math-base-special-abs' );\n* var array = require( '@stdlib/ndarray-array' );\n* var mapReduce = require( '@stdlib/utils-map-reduce' );\n*\n* var opts = {\n*     'dtype': 'generic'\n* };\n* var arr = array( [ [ -1, -2, -3 ], [ -4, -5, -6 ] ], opts );\n*\n* var out = mapReduce( arr, 0, naryFunction( abs, 1 ), naryFunction( add, 2 ) );\n* // returns 21\n*/\n\n// MODULES //\n\nvar main = require( './main.js' );\n\n\n// EXPORTS //\n\nmodule.exports = main;\n"],
+  "mappings": "uGAAA,IAAAA,EAAAC,EAAA,SAAAC,EAAAC,EAAA,cAsBA,IAAIC,EAAY,QAAS,gCAAiC,EAKtDC,EAAO,QA0EX,SAASC,EAAWC,EAAGC,EAASC,EAAQC,EAASC,EAAU,CAC1D,IAAIC,EACAC,EACAC,EACAC,EACAC,EACAC,EACAC,EACAC,EACAC,EACAC,EACAC,EA2BJ,GAxBAP,EAAMR,EAAE,OAGRW,EAAMX,EAAE,MAGRK,EAAOL,EAAE,KAGTY,EAAKZ,EAAE,QAGPa,EAAKb,EAAE,OAGPM,EAAON,EAAE,MAGTS,EAAMT,EAAE,UAAW,CAAE,EAGrBU,EAAMV,EAAE,IAGHW,EAAI,SAAW,EACnB,OAAOR,EAAQ,KAAMC,EAASH,EAASC,EAAQO,EAAKJ,EAAMQ,CAAG,EAAG,EAAGH,CAAI,EAAG,EAAGA,CAAI,EAIlF,IADAH,EAAMN,EACAc,EAAI,EAAGA,EAAIP,EAAKO,IACrBD,EAAKjB,EAAWc,EAAKC,EAAIC,EAAIP,EAAMS,EAAGjB,CAAK,EAC3CS,EAAMJ,EAAQ,KAAMC,EAASG,EAAKL,EAAQO,EAAKJ,EAAMS,CAAG,EAAGC,EAAGL,CAAI,EAAGK,EAAGL,CAAI,EAE7E,OAAOH,CACR,CAKAX,EAAO,QAAUG,IC1JjB,IAAAiB,EAAAC,EAAA,SAAAC,EAAAC,EAAA,cA2DA,SAASC,EAAWC,EAAGC,EAASC,EAAQC,EAASC,EAAU,CAC1D,IAAIC,EACAC,EACAC,EACAC,EAUJ,IAPAH,EAAOL,EAAE,KAGTM,EAAMN,EAAE,UAAW,CAAE,EAGrBO,EAAMN,EACAO,EAAI,EAAGA,EAAIH,EAAK,OAAQG,IAC7BD,EAAMJ,EAAQ,KAAMC,EAASG,EAAKL,EAAQI,EAAKD,EAAMG,CAAE,EAAGA,EAAGH,CAAK,EAAGG,EAAGH,CAAK,EAE9E,OAAOE,CACR,CAKAT,EAAO,QAAUC,IClFjB,IAAAU,EAAAC,EAAA,SAAAC,EAAAC,EAAA,cAsBA,IAAIC,EAAoB,QAAS,qCAAsC,EACnEC,EAAgB,QAAS,gCAAiC,EAC1DC,EAAa,QAAS,4BAA6B,EACnDC,EAAqB,QAAS,yCAA0C,EACxEC,EAAmB,QAAS,qCAAsC,EAClEC,EAAS,QAAS,uBAAwB,EAC1CC,EAAa,IACbC,EAAW,IA6Df,SAASC,EAAWC,EAAKC,EAASC,EAAQC,EAASC,EAAU,CAC5D,GAAK,CAACX,EAAYS,CAAO,EACxB,MAAM,IAAI,UAAWN,EAAQ,oEAAqEM,CAAO,CAAE,EAE5G,GAAK,CAACT,EAAYU,CAAQ,EACzB,MAAM,IAAI,UAAWP,EAAQ,qEAAsEO,CAAQ,CAAE,EAE9G,GAAKX,EAAeQ,CAAI,EACvB,OAAOH,EAAYH,EAAoBM,CAAI,EAAGC,EAASC,EAAQC,EAASC,CAAQ,EAEjF,GAAKb,EAAmBS,CAAI,EAC3B,OAAOF,EAAUH,EAAkBK,CAAI,EAAGC,EAASC,EAAQC,EAASC,CAAQ,EAE7E,MAAM,IAAI,UAAWR,EAAQ,4FAA6FI,CAAI,CAAE,CACjI,CAKAV,EAAO,QAAUS,IClDjB,IAAIM,EAAO,IAKX,OAAO,QAAUA",
+  "names": ["require_ndarray", "__commonJSMin", "exports", "module", "vind2bind", "MODE", "mapReduce", "x", "initial", "mapper", "reducer", "thisArg", "xbuf", "ordx", "acc", "len", "get", "ref", "shx", "sx", "ox", "ix", "i", "require_array", "__commonJSMin", "exports", "module", "mapReduce", "x", "initial", "mapper", "reducer", "thisArg", "xbuf", "get", "acc", "i", "require_main", "__commonJSMin", "exports", "module", "isArrayLikeObject", "isndarrayLike", "isFunction", "ndarraylike2object", "arraylike2object", "format", "ndarrayFcn", "arrayFcn", "mapReduce", "arr", "initial", "mapper", "reducer", "thisArg", "main"]
+}

package/docs/types/index.d.ts

@@ -16,19 +16,19 @@
 * limitations under the License.
 */
 
-// TypeScript Version: 2.0
+// TypeScript Version: 4.1
 
 /// <reference types="@stdlib/types"/>
 
-import { Collection } from '@stdlib/types/object';
-import { ndarray } from '@stdlib/types/ndarray';
+import { Collection } from '@stdlib/types/array';
+import { typedndarray } from '@stdlib/types/ndarray';
 
 /**
 * Callback invoked for each array element.
 *
 * @returns result
 */
-type Nullary = () => any;
+type Nullary<U> = () => U;
 
 /**
 * Callback invoked for each array element.
@@ -36,7 +36,7 @@ type Nullary = () => any;
 * @param value - array element
 * @returns result
 */
-type Unary = ( value: any ) => any;
+type Unary<T, U> = ( value: T ) => U;
 
 /**
 * Callback invoked for each array element.
@@ -45,7 +45,7 @@ type Unary = ( value: any ) => any;
 * @param index - element index
 * @returns result
 */
-type Binary = ( value: any, index: number ) => any;
+type Binary<T, U> = ( value: T, index: number ) => U;
 
 /**
 * Callback invoked for each array element.
@@ -55,7 +55,7 @@ type Binary = ( value: any, index: number ) => any;
 * @param arr - array
 * @returns result
 */
-type Ternary = ( value: any, index: number, arr: ndarray ) => any;
+type Ternary<T, U> = ( value: T, index: number, arr: typedndarray<T> ) => U;
 
 /**
 * Callback invoked for each array element.
@@ -65,7 +65,7 @@ type Ternary = ( value: any, index: number, arr: ndarray ) => any;
 * @param arr - array
 * @returns result
 */
-type ArrayTernary = ( value: any, index: number, arr: Collection ) => any;
+type ArrayTernary<T, U> = ( value: T, index: number, arr: Collection<T> ) => U;
 
 /**
 * Callback invoked for each array element.
@@ -75,7 +75,7 @@ type ArrayTernary = ( value: any, index: number, arr: Collection ) => any;
 * @param arr - array
 * @returns result
 */
-type Mapper = Nullary | Unary | Binary | Ternary;
+type Mapper<T, U> = Nullary<U> | Unary<T, U> | Binary<T, U> | Ternary<T, U>;
 
 /**
 * Callback invoked for each array element.
@@ -85,14 +85,14 @@ type Mapper = Nullary | Unary | Binary | Ternary;
 * @param arr - array
 * @returns result
 */
-type ArrayMapper = Nullary | Unary | Binary | ArrayTernary;
+type ArrayMapper<T, U> = Nullary<U> | Unary<T, U> | Binary<T, U> | ArrayTernary<T, U>;
 
 /**
 * Function applied against an accumulator.
 *
 * @returns accumulator value
 */
-type NullaryReducer = () => void;
+type NullaryReducer<V, W> = ( this: W ) => V;
 
 /**
 * Function applied against an accumulator.
@@ -100,7 +100,7 @@ type NullaryReducer = () => void;
 * @param accumulator - accumulated value
 * @returns accumulator value
 */
-type UnaryReducer = ( accumulator: any ) => any;
+type UnaryReducer<V, W> = ( this: W, accumulator: V ) => V;
 
 /**
 * Function applied against an accumulator.
@@ -109,7 +109,7 @@ type UnaryReducer = ( accumulator: any ) => any;
 * @param value - array element
 * @returns accumulator value
 */
-type BinaryReducer = ( accumulator: any, value: any ) => any;
+type BinaryReducer<U, V, W> = ( this: W, accumulator: V, value: U ) => V;
 
 /**
 * Function applied against an accumulator.
@@ -119,7 +119,7 @@ type BinaryReducer = ( accumulator: any, value: any ) => any;
 * @param index - element index
 * @returns accumulator value
 */
-type TernaryReducer = ( accumulator: any, value: any, index: number ) => any;
+type TernaryReducer<U, V, W> = ( this: W, accumulator: V, value: U, index: number ) => V;
 
 /**
 * Function applied against an accumulator.
@@ -130,7 +130,7 @@ type TernaryReducer = ( accumulator: any, value: any, index: number ) => any;
 * @param arr - array
 * @returns accumulator value
 */
-type QuaternaryReducer = ( accumulator: any, value: any, index: number, arr: ndarray ) => any; // tslint:disable-line:max-line-length
+type QuaternaryReducer<U, V, T, W> = ( this: W, accumulator: V, value: U, index: number, arr: typedndarray<T> ) => V;
 
 /**
 * Function applied against an accumulator.
@@ -141,7 +141,7 @@ type QuaternaryReducer = ( accumulator: any, value: any, index: number, arr: nda
 * @param arr - array
 * @returns accumulator value
 */
-type ArrayQuaternaryReducer = ( accumulator: any, value: any, index: number, arr: Collection ) => any; // tslint:disable-line:max-line-length
+type ArrayQuaternaryReducer<U, V, T, W> = ( this: W, accumulator: V, value: U, index: number, arr: Collection<T> ) => V;
 
 /**
 * Function applied against an accumulator.
@@ -152,7 +152,7 @@ type ArrayQuaternaryReducer = ( accumulator: any, value: any, index: number, arr
 * @param arr - array
 * @returns accumulator value
 */
-type Reducer = NullaryReducer | UnaryReducer | BinaryReducer | TernaryReducer | QuaternaryReducer; // tslint:disable-line:max-line-length
+type Reducer<U, V, T, W> = NullaryReducer<V, W> | UnaryReducer<V, W> | BinaryReducer<U, V, W> | TernaryReducer<U, V, W> | QuaternaryReducer<U, V, T, W>;
 
 /**
 * Function applied against an accumulator.
@@ -163,7 +163,7 @@ type Reducer = NullaryReducer | UnaryReducer | BinaryReducer | TernaryReducer |
 * @param arr - array
 * @returns accumulator value
 */
-type ArrayReducer = NullaryReducer | UnaryReducer | BinaryReducer | TernaryReducer | ArrayQuaternaryReducer; // tslint:disable-line:max-line-length
+type ArrayReducer<U, V, T, W> = NullaryReducer<V, W> | UnaryReducer<V, W> | BinaryReducer<U, V, W> | TernaryReducer<U, V, W> | ArrayQuaternaryReducer<U, V, T, W>;
 
 /**
 * Performs a map-reduce operation for each element in an array and returns the accumulated result.
@@ -193,10 +193,10 @@ type ArrayReducer = NullaryReducer | UnaryReducer | BinaryReducer | TernaryReduc
 * @returns accumulated result
 *
 * @example
-* var naryFunction = require( `@stdlib/utils/nary-function` );
-* var abs = require( `@stdlib/math/base/special/abs` );
-* var add = require( `@stdlib/math/base/ops/add` );
-* var array = require( `@stdlib/ndarray/array` );
+* var naryFunction = require( '@stdlib/utils-nary-function' );
+* var abs = require( '@stdlib/math-base-special-abs' );
+* var add = require( '@stdlib/math-base-ops-add' );
+* var array = require( '@stdlib/ndarray-array' );
 *
 * var opts = {
 *     'dtype': 'generic'
@@ -206,7 +206,7 @@ type ArrayReducer = NullaryReducer | UnaryReducer | BinaryReducer | TernaryReduc
 * var out = mapReduce( arr, 0, naryFunction( abs, 2 ), naryFunction( add, 2 ) );
 * // returns 21
 */
-declare function mapReduce( arr: ndarray, initial: any, mapper: Mapper, reducer: Reducer, thisArg?: any ): any; // tslint:disable-line:max-line-length
+declare function mapReduce<T = unknown, U = unknown, V = unknown, W = unknown>( arr: typedndarray<T>, initial: V, mapper: Mapper<T, U>, reducer: Reducer<U, V, T, W>, thisArg?: ThisParameterType<Reducer<U, V, T, W>> ): V;
 
 /**
 * Performs a map-reduce operation for each element in an array and returns the accumulated result.
@@ -249,7 +249,7 @@ declare function mapReduce( arr: ndarray, initial: any, mapper: Mapper, reducer:
 * var out = mapReduce( arr, 0, square, sum );
 * // returns 30
 */
-declare function mapReduce( arr: Collection, initial: any, mapper: ArrayMapper, reducer: ArrayReducer, thisArg?: any ): any; // tslint:disable-line:max-line-length
+declare function mapReduce<T = unknown, U = unknown, V = unknown, W = unknown>( arr: Collection<T>, initial: V, mapper: ArrayMapper<T, U>, reducer: ArrayReducer<U, V, T, W>, thisArg?: ThisParameterType<ArrayReducer<U, V, T, W>> ): V;
 
 
 // EXPORTS //

package/lib/array.js

@@ -26,7 +26,7 @@
 * @private
 * @param {Object} x - object containing input array data
 * @param {ArrayLikeObject} x.data - input array data
-* @param {Function} x.getter - callback for accessing input array data elements
+* @param {Array<Function>} x.accessors - input array accessors
 * @param {*} initial - initial value
 * @param {Function} mapper - mapping function
 * @param {Function} reducer - reducing function
@@ -50,7 +50,7 @@
 * // Create the input array object:
 * var x = {
 *     'data': [ 1, 2, 3, 4 ],
-*     'getter': getter
+*     'accessors': [ getter ]
 * };
 *
 * // Compute the sum of squared values:
@@ -67,7 +67,7 @@ function mapReduce( x, initial, mapper, reducer, thisArg ) {
 	xbuf = x.data;
 
 	// Cache the element accessor:
-	get = x.getter;
+	get = x.accessors[ 0 ];
 
 	// Iterate over each element...
 	acc = initial;

package/lib/main.js

@@ -25,6 +25,7 @@ var isndarrayLike = require( '@stdlib/assert-is-ndarray-like' );
 var isFunction = require( '@stdlib/assert-is-function' );
 var ndarraylike2object = require( '@stdlib/ndarray-base-ndarraylike2object' );
 var arraylike2object = require( '@stdlib/array-base-arraylike2object' );
+var format = require( '@stdlib/string-format' );
 var ndarrayFcn = require( './ndarray.js' );
 var arrayFcn = require( './array.js' );
 
@@ -89,10 +90,10 @@ var arrayFcn = require( './array.js' );
 */
 function mapReduce( arr, initial, mapper, reducer, thisArg ) {
 	if ( !isFunction( mapper ) ) {
-		throw new TypeError( 'invalid argument. Third argument must be a function. Value:`' + mapper + '`.' );
+		throw new TypeError( format( 'invalid argument. Third argument must be a function. Value: `%s`.', mapper ) );
 	}
 	if ( !isFunction( reducer ) ) {
-		throw new TypeError( 'invalid argument. Fourth argument must be a function. Value:`' + reducer + '`.' );
+		throw new TypeError( format( 'invalid argument. Fourth argument must be a function. Value: `%s`.', reducer ) );
 	}
 	if ( isndarrayLike( arr ) ) { // note: assertion order matters here, as an ndarray-like object is also array-like
 		return ndarrayFcn( ndarraylike2object( arr ), initial, mapper, reducer, thisArg ); // eslint-disable-line max-len
@@ -100,7 +101,7 @@ function mapReduce( arr, initial, mapper, reducer, thisArg ) {
 	if ( isArrayLikeObject( arr ) ) {
 		return arrayFcn( arraylike2object( arr ), initial, mapper, reducer, thisArg ); // eslint-disable-line max-len
 	}
-	throw new TypeError( 'invalid argument. First argument must be an array-like object or an ndarray. Value: `' + arr + '`.' );
+	throw new TypeError( format( 'invalid argument. First argument must be an array-like object or an ndarray. Value: `%s`.', arr ) );
 }
 
 

package/lib/ndarray.js

@@ -43,7 +43,7 @@ var MODE = 'throw';
 * @param {IntegerArray} x.strides - stride lengths
 * @param {NonNegativeInteger} x.offset - index offset
 * @param {string} x.order - specifies whether `x` is row-major (C-style) or column-major (Fortran-style)
-* @param {Function} x.getter - callback for accessing `x` data buffer elements
+* @param {Array<Function>} x.accessors - accessors for accessing data buffer elements
 * @param {*} initial - initial value
 * @param {Function} mapper - mapping function
 * @param {Function} reducer - reducing function
@@ -86,7 +86,7 @@ var MODE = 'throw';
 *     'strides': sx,
 *     'offset': ox,
 *     'order': 'row-major',
-*     'getter': getter
+*     'accessors': [ getter ]
 * };
 * x.ref = x;
 *
@@ -131,7 +131,7 @@ function mapReduce( x, initial, mapper, reducer, thisArg ) {
 	ordx = x.order;
 
 	// Cache the element accessor:
-	get = x.getter;
+	get = x.accessors[ 0 ];
 
 	// Cache the reference to the original input array:
 	ref = x.ref;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@stdlib/utils-map-reduce",
-  "version": "0.0.1",
+  "version": "0.2.0",
   "description": "Perform a single-pass map-reduce operation against each element in an array and return the accumulated result.",
   "license": "Apache-2.0",
   "author": {
@@ -37,37 +37,40 @@
     "url": "https://github.com/stdlib-js/stdlib/issues"
   },
   "dependencies": {
-    "@stdlib/array-base-arraylike2object": "^0.0.x",
-    "@stdlib/assert-is-array-like-object": "^0.0.x",
-    "@stdlib/assert-is-function": "^0.0.x",
-    "@stdlib/assert-is-ndarray-like": "^0.0.x",
-    "@stdlib/ndarray-base-ndarraylike2object": "^0.0.x",
-    "@stdlib/ndarray-base-vind2bind": "^0.0.x",
-    "@stdlib/types": "^0.0.x"
+    "@stdlib/array-base-arraylike2object": "^0.2.0",
+    "@stdlib/assert-is-array-like-object": "^0.2.0",
+    "@stdlib/assert-is-function": "^0.2.0",
+    "@stdlib/assert-is-ndarray-like": "^0.2.0",
+    "@stdlib/ndarray-base-ndarraylike2object": "^0.2.0",
+    "@stdlib/ndarray-base-vind2bind": "^0.2.0",
+    "@stdlib/string-format": "^0.2.0",
+    "@stdlib/types": "^0.3.1",
+    "@stdlib/error-tools-fmtprodmsg": "^0.2.0"
   },
   "devDependencies": {
-    "@stdlib/array-base-filled": "^0.0.x",
-    "@stdlib/array-complex64": "^0.0.x",
-    "@stdlib/array-filled-by": "^0.0.x",
-    "@stdlib/array-float64": "^0.0.x",
-    "@stdlib/bench": "^0.0.x",
-    "@stdlib/complex-float32": "^0.0.x",
-    "@stdlib/complex-imagf": "^0.0.x",
-    "@stdlib/complex-realf": "^0.0.x",
-    "@stdlib/math-base-assert-is-nan": "^0.0.x",
-    "@stdlib/math-base-ops-add": "^0.0.x",
-    "@stdlib/math-base-ops-cadd": "^0.0.x",
-    "@stdlib/math-base-special-abs": "^0.0.x",
-    "@stdlib/math-base-special-cceil": "^0.0.x",
-    "@stdlib/math-base-special-pow": "^0.0.x",
-    "@stdlib/ndarray-array": "^0.0.x",
-    "@stdlib/ndarray-ctor": "^0.0.x",
-    "@stdlib/random-base-discrete-uniform": "^0.0.x",
-    "@stdlib/utils-nary-function": "^0.0.x",
-    "@stdlib/utils-noop": "^0.0.x",
+    "@stdlib/array-base-filled": "^0.2.0",
+    "@stdlib/array-complex64": "^0.1.0",
+    "@stdlib/array-filled-by": "^0.1.0",
+    "@stdlib/array-float64": "^0.2.0",
+    "@stdlib/complex-float32": "^0.2.0",
+    "@stdlib/complex-imagf": "^0.2.0",
+    "@stdlib/complex-realf": "^0.2.0",
+    "@stdlib/math-base-assert-is-nan": "^0.2.0",
+    "@stdlib/math-base-ops-add": "^0.2.0",
+    "@stdlib/math-base-ops-cadd": "^0.2.0",
+    "@stdlib/math-base-special-abs": "^0.2.0",
+    "@stdlib/math-base-special-cceil": "^0.2.0",
+    "@stdlib/math-base-special-pow": "^0.2.0",
+    "@stdlib/ndarray-array": "^0.1.0",
+    "@stdlib/ndarray-ctor": "^0.1.0",
+    "@stdlib/random-base-discrete-uniform": "^0.1.0",
+    "@stdlib/utils-nary-function": "^0.2.0",
+    "@stdlib/utils-noop": "^0.2.0",
     "tape": "git+https://github.com/kgryte/tape.git#fix/globby",
     "istanbul": "^0.4.1",
-    "tap-spec": "5.x.x"
+    "tap-min": "git+https://github.com/Planeshifter/tap-min.git",
+    "@stdlib/bench-harness": "^0.2.0",
+    "@stdlib/bench": "^0.3.1"
   },
   "engines": {
     "node": ">=0.10.0",
@@ -117,7 +120,7 @@
     "vector"
   ],
   "funding": {
-    "type": "patreon",
-    "url": "https://www.patreon.com/athan"
+    "type": "opencollective",
+    "url": "https://opencollective.com/stdlib"
   }
 }

package/docs/repl.txt

@@ -1,65 +0,0 @@
-
-{{alias}}( arr, initial, mapper, reducer[, thisArg] )
-    Performs a map-reduce operation for each element in an array and returns the
-    accumulated result.
-
-    When invoked, the mapping function is provided three arguments:
-
-    - value: array element.
-    - index: element index.
-    - arr: input array.
-
-    When invoked, the reducing function is provided four arguments:
-
-    - accumulator: accumulated value.
-    - value: result after applying the mapping function to the current array
-      element.
-    - index: element index.
-    - arr: input array.
-
-    If provided an empty array, the function returns the initial value.
-
-    When provided an ndarray, the function performs a single-pass map-reduce
-    operation over the entire input ndarray (i.e., higher-order ndarray
-    dimensions are flattened to a single-dimension).
-
-    Parameters
-    ----------
-    arr: ArrayLikeObject|ndarray
-        Input array.
-
-    initial: any
-        Accumulator value used in the first invocation of the reduction
-        function.
-
-    mapper: Function
-        Mapping function.
-
-    reducer: Function
-        Reducing function.
-
-    thisArg: any (optional)
-        Execution context for the reducing function.
-
-    Returns
-    -------
-    out: any
-        Accumulated result.
-
-    Examples
-    --------
-    // array-like object:
-    > var f1 = {{alias:@stdlib/utils/nary-function}}( {{alias:@stdlib/math/base/special/abs}}, 1 );
-    > var f2 = {{alias:@stdlib/utils/nary-function}}( {{alias:@stdlib/math/base/ops/add}}, 2 );
-    > var arr = [ -1.0, -2.0, -3.0, -4.0, -5.0, -6.0 ];
-    > var out = {{alias}}( arr, 0.0, f1, f2 )
-    21.0
-
-    // ndarray:
-    > arr = {{alias:@stdlib/ndarray/array}}( arr, { 'shape': [ 2, 3 ] } );
-    > out = {{alias}}( arr, 0.0, f1, f2 )
-    21.0
-
-    See Also
-    --------
-

package/docs/types/test.ts

@@ -1,184 +0,0 @@
-/*
-* @license Apache-2.0
-*
-* Copyright (c) 2022 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 array = require( '@stdlib/ndarray-array' );
-import mapReduce = require( './index' );
-
-/**
-* Mapping function.
-*
-* @param value - array element
-* @returns result
-*/
-function mapper( value: number ): number {
-	return value;
-}
-
-/**
-* Reducing function.
-*
-* @param acc - accumulated value
-* @param v - array element
-* @returns result
-*/
-function reducer( acc: number, value: number ): number {
-	return acc + value;
-}
-
-
-// TESTS //
-
-// The function returns the accumulated value when provided a collection...
-{
-	mapReduce( [ 0, 1, 1, NaN, 2 ], 0, mapper, reducer ); // $ExpectType any
-	mapReduce( [ -1, 1, 2 ], 100, mapper, reducer ); // $ExpectType any
-	mapReduce( [ -1, 1, 2 ], 0, mapper, reducer, {} ); // $ExpectType any
-}
-
-// The function returns the accumulated value when provided an ndarray...
-{
-	const arr = array( [ 1, 2, 3, 4, 5, 6 ] );
-
-	mapReduce( arr, 0, mapper, reducer ); // $ExpectType any
-	mapReduce( arr, 100, mapper, reducer ); // $ExpectType any
-	mapReduce( arr, 0, mapper, reducer, {} ); // $ExpectType any
-}
-
-// The compiler throws an error if the function is provided a first argument which is not a collection or ndarray...
-{
-	mapReduce( 2, 0, mapper, reducer ); // $ExpectError
-	mapReduce( false, 0, mapper, reducer ); // $ExpectError
-	mapReduce( true, 0, mapper, reducer ); // $ExpectError
-	mapReduce( null, 0, mapper, reducer ); // $ExpectError
-	mapReduce( {}, 0, mapper, reducer ); // $ExpectError
-
-	mapReduce( 2, 0, mapper, reducer, {} ); // $ExpectError
-	mapReduce( false, 0, mapper, reducer, {} ); // $ExpectError
-	mapReduce( true, 0, mapper, reducer, {} ); // $ExpectError
-	mapReduce( null, 0, mapper, reducer, {} ); // $ExpectError
-	mapReduce( {}, 0, mapper, reducer, {} ); // $ExpectError
-}
-
-// The compiler throws an error if the function is provided a third argument which is not a function with a supported signature...
-{
-	const arr1 = [ 0, 1, 1, NaN, 2 ];
-
-	mapReduce( arr1, 0, 'abc', reducer ); // $ExpectError
-	mapReduce( arr1, 0, 2, reducer ); // $ExpectError
-	mapReduce( arr1, 0, false, reducer ); // $ExpectError
-	mapReduce( arr1, 0, true, reducer ); // $ExpectError
-	mapReduce( arr1, 0, null, reducer ); // $ExpectError
-	mapReduce( arr1, 0, {}, reducer ); // $ExpectError
-	mapReduce( arr1, 0, [], reducer ); // $ExpectError
-
-	mapReduce( arr1, 0, 'abc', reducer, {} ); // $ExpectError
-	mapReduce( arr1, 0, 2, reducer, {} ); // $ExpectError
-	mapReduce( arr1, 0, false, reducer, {} ); // $ExpectError
-	mapReduce( arr1, 0, true, reducer, {} ); // $ExpectError
-	mapReduce( arr1, 0, null, reducer, {} ); // $ExpectError
-	mapReduce( arr1, 0, {}, reducer, {} ); // $ExpectError
-	mapReduce( arr1, 0, [], reducer, {} ); // $ExpectError
-
-	mapReduce( arr1, 0, ( x: number, y: number, z: number, w: number ): number => x + y + z + w, reducer ); // $ExpectError
-	mapReduce( arr1, 0, ( x: number, y: number, z: number, w: number ): number => x + y + z + w, reducer, {} ); // $ExpectError
-
-	const arr2 = array( [ 0, 1, 1, NaN, 2 ] );
-
-	mapReduce( arr2, 0, 'abc', reducer ); // $ExpectError
-	mapReduce( arr2, 0, 2, reducer ); // $ExpectError
-	mapReduce( arr2, 0, false, reducer ); // $ExpectError
-	mapReduce( arr2, 0, true, reducer ); // $ExpectError
-	mapReduce( arr2, 0, null, reducer ); // $ExpectError
-	mapReduce( arr2, 0, {}, reducer ); // $ExpectError
-	mapReduce( arr2, 0, [], reducer ); // $ExpectError
-
-	mapReduce( arr2, 0, 'abc', reducer, {} ); // $ExpectError
-	mapReduce( arr2, 0, 2, reducer, {} ); // $ExpectError
-	mapReduce( arr2, 0, false, reducer, {} ); // $ExpectError
-	mapReduce( arr2, 0, true, reducer, {} ); // $ExpectError
-	mapReduce( arr2, 0, null, reducer, {} ); // $ExpectError
-	mapReduce( arr2, 0, {}, reducer, {} ); // $ExpectError
-	mapReduce( arr2, 0, [], reducer, {} ); // $ExpectError
-
-	mapReduce( arr2, 0, ( x: number, y: number, z: number, w: number ): number => x + y + z + w, reducer ); // $ExpectError
-	mapReduce( arr2, 0, ( x: number, y: number, z: number, w: number ): number => x + y + z + w, reducer, {} ); // $ExpectError
-}
-
-// The compiler throws an error if the function is provided a fourth argument which is not a function with a supported signature...
-{
-	const arr1 = [ 0, 1, 1, NaN, 2 ];
-
-	mapReduce( arr1, 0, mapper, 'abc' ); // $ExpectError
-	mapReduce( arr1, 0, mapper, 2 ); // $ExpectError
-	mapReduce( arr1, 0, mapper, false ); // $ExpectError
-	mapReduce( arr1, 0, mapper, true ); // $ExpectError
-	mapReduce( arr1, 0, mapper, null ); // $ExpectError
-	mapReduce( arr1, 0, mapper, {} ); // $ExpectError
-	mapReduce( arr1, 0, mapper, [] ); // $ExpectError
-
-	mapReduce( arr1, 0, mapper, 'abc', {} ); // $ExpectError
-	mapReduce( arr1, 0, mapper, 2, {} ); // $ExpectError
-	mapReduce( arr1, 0, mapper, false, {} ); // $ExpectError
-	mapReduce( arr1, 0, mapper, true, {} ); // $ExpectError
-	mapReduce( arr1, 0, mapper, null, {} ); // $ExpectError
-	mapReduce( arr1, 0, mapper, {}, {} ); // $ExpectError
-	mapReduce( arr1, 0, mapper, [], {} ); // $ExpectError
-
-	mapReduce( arr1, 0, mapper, ( x: number, y: number, z: number, w: number ): number => x + y + z + w ); // $ExpectError
-	mapReduce( arr1, 0, mapper, ( x: number, y: number, z: number, w: number ): number => x + y + z + w, {} ); // $ExpectError
-
-	const arr2 = array( [ 0, 1, 1, NaN, 2 ] );
-
-	mapReduce( arr2, 0, mapper, 'abc' ); // $ExpectError
-	mapReduce( arr2, 0, mapper, 2 ); // $ExpectError
-	mapReduce( arr2, 0, mapper, false ); // $ExpectError
-	mapReduce( arr2, 0, mapper, true ); // $ExpectError
-	mapReduce( arr2, 0, mapper, null ); // $ExpectError
-	mapReduce( arr2, 0, mapper, {} ); // $ExpectError
-	mapReduce( arr2, 0, mapper, [] ); // $ExpectError
-
-	mapReduce( arr2, 0, mapper, 'abc', {} ); // $ExpectError
-	mapReduce( arr2, 0, mapper, 2, {} ); // $ExpectError
-	mapReduce( arr2, 0, mapper, false, {} ); // $ExpectError
-	mapReduce( arr2, 0, mapper, true, {} ); // $ExpectError
-	mapReduce( arr2, 0, mapper, null, {} ); // $ExpectError
-	mapReduce( arr2, 0, mapper, {}, {} ); // $ExpectError
-	mapReduce( arr2, 0, mapper, [], {} ); // $ExpectError
-
-	mapReduce( arr2, 0, mapper, ( x: number, y: number, z: number, w: number ): number => x + y + z + w ); // $ExpectError
-	mapReduce( arr2, 0, mapper, ( x: number, y: number, z: number, w: number ): number => x + y + z + w, {} ); // $ExpectError
-}
-
-// The compiler throws an error if the function is provided an unsupported number of arguments...
-{
-	const arr1 = [ 1, 2, 3 ];
-
-	mapReduce(); // $ExpectError
-	mapReduce( arr1 ); // $ExpectError
-	mapReduce( arr1, 0 ); // $ExpectError
-	mapReduce( arr1, 0, mapper, ); // $ExpectError
-	mapReduce( arr1, 0, mapper, reducer, {}, 3 ); // $ExpectError
-
-	const arr2 = array( [ 1, 2, 3 ] );
-
-	mapReduce(); // $ExpectError
-	mapReduce( arr2 ); // $ExpectError
-	mapReduce( arr2, 0 ); // $ExpectError
-	mapReduce( arr2, 0, mapper ); // $ExpectError
-	mapReduce( arr2, 0, mapper, reducer, {}, 3 ); // $ExpectError
-}