npm - @stdlib/math-tools-unary - Versions diffs - 0.0.6 → 0.1.0 - Mend

@stdlib/math-tools-unary 0.0.6 → 0.1.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (19) hide show

package/CITATION.cff +30 -0
package/LICENSE +0 -304
package/NOTICE +1 -1
package/README.md +22 -10
package/dist/index.d.ts +3 -0
package/dist/index.js +15 -0
package/dist/index.js.map +7 -0
package/docs/types/index.d.ts +1 -1
package/lib/defaults.json +1 -1
package/lib/main.js +8 -10
package/lib/ndarray.js +1 -22
package/lib/policies.json +3 -1
package/lib/resolve_output_dtype.js +29 -2
package/lib/validate.js +4 -3
package/lib/validate_options.js +3 -2
package/lib/validate_table.js +3 -2
package/package.json +39 -39
package/docs/repl.txt +0 -119
package/docs/types/test.ts +0 -288

package/CITATION.cff ADDED Viewed

@@ -0,0 +1,30 @@
+cff-version: 1.2.0
+title: stdlib
+message: >-
+  If you use this software, please cite it using the
+  metadata from this file.
+type: software
+authors:
+  - name: The Stdlib Authors
+    url: https://github.com/stdlib-js/stdlib/graphs/contributors
+repository-code: https://github.com/stdlib-js/stdlib
+url: https://stdlib.io
+abstract: |
+  Standard library for JavaScript and Node.js.
+keywords:
+  - JavaScript
+  - Node.js
+  - TypeScript
+  - standard library
+  - scientific computing
+  - numerical computing
+  - statistical computing
+license: Apache-2.0 AND BSL-1.0
+date-released: 2016

package/LICENSE CHANGED Viewed

@@ -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 CHANGED Viewed

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

package/README.md CHANGED Viewed

@@ -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>
 # Unary
 [![NPM version][npm-image]][npm-url] [![Build Status][test-image]][test-url] [![Coverage Status][coverage-image]][coverage-url] <!-- [![dependencies][dependencies-image]][dependencies-url] -->
@@ -358,7 +369,7 @@ See [LICENSE][stdlib-license].
 ## Copyright
-Copyright &copy; 2016-2022. The Stdlib [Authors][stdlib-authors].
+Copyright &copy; 2016-2023. The Stdlib [Authors][stdlib-authors].
 </section>
@@ -371,8 +382,8 @@ Copyright &copy; 2016-2022. The Stdlib [Authors][stdlib-authors].
 [npm-image]: http://img.shields.io/npm/v/@stdlib/math-tools-unary.svg
 [npm-url]: https://npmjs.org/package/@stdlib/math-tools-unary
-[test-image]: https://github.com/stdlib-js/math-tools-unary/actions/workflows/test.yml/badge.svg
-[test-url]: https://github.com/stdlib-js/math-tools-unary/actions/workflows/test.yml
+[test-image]: https://github.com/stdlib-js/math-tools-unary/actions/workflows/test.yml/badge.svg?branch=v0.1.0
+[test-url]: https://github.com/stdlib-js/math-tools-unary/actions/workflows/test.yml?query=branch:v0.1.0
 [coverage-image]: https://img.shields.io/codecov/c/github/stdlib-js/math-tools-unary/main.svg
 [coverage-url]: https://codecov.io/github/stdlib-js/math-tools-unary?branch=main
@@ -384,19 +395,20 @@ 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/math-tools-unary/tree/deno
 [umd-url]: https://github.com/stdlib-js/math-tools-unary/tree/umd
 [esm-url]: https://github.com/stdlib-js/math-tools-unary/tree/esm
-[chat-image]: https://img.shields.io/gitter/room/stdlib-js/stdlib.svg
-[chat-url]: https://gitter.im/stdlib-js/stdlib/
-[stdlib]: https://github.com/stdlib-js/stdlib
-[stdlib-authors]: https://github.com/stdlib-js/stdlib/graphs/contributors
+[branches-url]: https://github.com/stdlib-js/math-tools-unary/blob/main/branches.md
 [stdlib-license]: https://raw.githubusercontent.com/stdlib-js/math-tools-unary/main/LICENSE

package/dist/index.d.ts ADDED Viewed

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

package/dist/index.js ADDED Viewed

@@ -0,0 +1,15 @@
+"use strict";var v=function(r,e){return function(){return e||r((e={exports:{}}).exports,e),e.exports}};var b=v(function(Pr,w){
+var h=require('@stdlib/ndarray-ctor/dist'),q=require('@stdlib/ndarray-base-buffer/dist'),B=require('@stdlib/ndarray-base-shape2strides/dist'),G=require('@stdlib/ndarray-base-numel/dist'),H=require('@stdlib/array-base-copy-indexed/dist');function J(r,e,u,n){var t,i,d;return t=H(e.shape),t.length===0?(i=q(u,1),d=h(u,i,[],[0],0,n)):(i=q(u,e.length||G(t)),d=h(u,i,t,B(t,n),0,n)),r(e,d),d}w.exports=J
+});var T=v(function(jr,E){
+var Q=require('@stdlib/error-tools-fmtprodmsg/dist');function W(r,e){switch(e){case"same":return r;case"floating-point":return r==="float64"||r==="float32"||r==="generic"||r==="complex128"||r==="complex64"?r:"float64";case"real floating-point":return r==="float64"||r==="float32"||r==="generic"?r:"float64";case"complex floating-point":return r==="complex128"||r==="complex64"?r:"complex128";default:throw new Error(Q('0gz4W',e))}}E.exports=W
+});var O=v(function(_r,X){X.exports={output_dtype_policy:"floating-point"}});var _=v(function(kr,j){
+var Z=require('@stdlib/assert-is-plain-object/dist'),$=require('@stdlib/assert-has-own-property/dist'),x=require('@stdlib/assert-is-function/dist'),rr=require('@stdlib/assert-is-null/dist'),er=require('@stdlib/utils-keys/dist'),P=require('@stdlib/error-tools-fmtprodmsg/dist');function ar(r,e){var u,n,t,i;if(!Z(e))return new TypeError(P('0gz4Z',e));for(u=er(r),i=0;i<u.length;i++)if(t=u[i],$(e,t)){if(n=e[t],!x(n)&&!rr(n))return new TypeError(P('0gz4a',t,n));r[t]=n}return null}j.exports=ar
+});var k=v(function(Rr,ir){ir.exports=["same","floating-point","real floating-point","complex floating-point"]});var z=v(function(Vr,V){
+var nr=require('@stdlib/assert-is-plain-object/dist'),tr=require('@stdlib/assert-has-own-property/dist'),ur=require('@stdlib/assert-contains/dist'),R=require('@stdlib/error-tools-fmtprodmsg/dist'),or=k();function lr(r,e){return nr(e)?tr(e,"output_dtype_policy")&&(r.policy=e.output_dtype_policy,!ur(or,r.policy))?new TypeError(R('0gz4Y',"output_dtype_policy",r.policy)):null:new TypeError(R('0gz2V',e));}V.exports=lr
+});var L=v(function(zr,S){
+var sr=require('@stdlib/assert-is-plain-object/dist'),C=require('@stdlib/assert-has-own-property/dist'),I=require('@stdlib/assert-contains/dist'),pr=require('@stdlib/ndarray-orders/dist'),vr=require('@stdlib/ndarray-dtypes/dist'),c=require('@stdlib/error-tools-fmtprodmsg/dist'),dr=pr(),fr=vr();function cr(r,e){return sr(e)?C(e,"dtype")&&(r.dtype=e.dtype,!I(fr,r.dtype))?new TypeError(c('0gz4X',"dtype",r.dtype)):C(e,"order")&&(r.order=e.order,!I(dr,r.order))?new TypeError(c('0gz4X',"order",r.order)):null:new TypeError(c('0gz2V',e));}S.exports=cr
+});var Y=v(function(Cr,U){
+var mr=require('@stdlib/utils-define-nonenumerable-read-only-property/dist'),D=require('@stdlib/assert-is-number/dist').isPrimitive,M=require('@stdlib/assert-is-complex-like/dist'),m=require('@stdlib/assert-is-ndarray-like/dist'),g=require('@stdlib/assert-is-collection/dist'),y=require('@stdlib/ndarray-base-buffer-dtype/dist'),gr=require('@stdlib/ndarray-base-buffer/dist'),N=require('@stdlib/ndarray-base-broadcast-array/dist'),F=require('@stdlib/error-tools-fmtprodmsg/dist'),yr=b(),K=T(),hr=O(),qr=_(),wr=z(),br=L();function Er(r,e){var u,n,t,i;if(i={number:null,complex:null,array:null,ndarray:null},n=qr(i,r),n||(u={policy:hr.output_dtype_policy},arguments.length>1&&(n=wr(u,e),n)))throw n;return t=d,mr(t,"assign",A),t;function d(a){var o,s,l,p,f;if(D(a)){if(i.number)return i.number(a);throw new TypeError(format('0gz0O'))}if(M(a)){if(i.complex)return i.complex(a);throw new TypeError(format('0gz0P'))}if(l={},arguments.length>1&&(p=br(l,arguments[1]),p))throw p;if(m(a)){if(i.ndarray===null)throw new TypeError(format('0gz0Q'));return s=l.dtype||K(a.dtype,u.policy),yr(i.ndarray,a,s,l.order||a.order)}if(g(a)){if(i.array===null)throw new TypeError(format('0gz0R'));return o=y(a)||"generic",s=l.dtype||K(o,u.policy),f=gr(s,a.length),i.array(a.length,o,a,1,s,f,1),f}throw new TypeError(F('0gz4V',a))}function A(a,o){var s,l,p;if(m(a)){if(m(o)){if(s=a.shape,l=o.shape,s.length===l.length){for(p=0;p<s.length;p++)if(s[p]!==l[p]){a=N(a,l);break}}else a=N(a,l);return i.ndarray(a,o),o}throw new TypeError(format('0gz0S'))}if(g(a)){if(g(o)){if(o.length!==a.length)throw new RangeError(format('0gz0T'));return i.array(a.length,y(a)||"generic",a,1,y(o)||"generic",o,1),o}throw new TypeError(format('0gz0U'))}throw D(a)?new TypeError(format('0gz0V')):M(a)?new TypeError(format('0gz0W')):new TypeError(F('0gz4V',a))}}U.exports=Er
+});var Tr=Y();module.exports=Tr;
+/** @license Apache-2.0 */
+//# sourceMappingURL=index.js.map

package/dist/index.js.map ADDED Viewed

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../lib/ndarray.js", "../lib/resolve_output_dtype.js", "../lib/defaults.json", "../lib/validate_table.js", "../lib/policies.json", "../lib/validate_options.js", "../lib/validate.js", "../lib/main.js", "../lib/index.js"],
+  "sourcesContent": ["/**\n* @license Apache-2.0\n*\n* Copyright (c) 2021 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 ndarray = require( '@stdlib/ndarray-ctor' );\nvar buffer = require( '@stdlib/ndarray-base-buffer' );\nvar shape2strides = require( '@stdlib/ndarray-base-shape2strides' );\nvar numel = require( '@stdlib/ndarray-base-numel' );\nvar copy = require( '@stdlib/array-base-copy-indexed' );\n\n\n// MAIN //\n\n/**\n* Applies a function to an ndarray.\n*\n* @private\n* @param {Function} fcn - function to apply\n* @param {ndarray} x - input array\n* @param {string} ydtype - output array data type\n* @param {string} yorder - output array order\n* @returns {ndarray} output array\n*/\nfunction ndarrayfcn( fcn, x, ydtype, yorder ) {\n\tvar shape;\n\tvar buf;\n\tvar y;\n\n\t// Check if we were provided a zero-dimensional array...\n\tshape = copy( x.shape ); // Note: we need to copy the shape to avoid a shared shape object between `x` and `y` which could lead to unintended mutations (e.g., if either `x` or `y` is reshaped)\n\tif ( shape.length === 0 ) {\n\t\tbuf = buffer( ydtype, 1 );\n\t\ty = ndarray( ydtype, buf, [], [ 0 ], 0, yorder );\n\t} else {\n\t\tbuf = buffer( ydtype, x.length || numel( shape ) ); // WARNING: `x.length` is a property found on ndarray instances, but not strictly necessary to describe an ndarray; accordingly, used here to avoid unnecessary computation, but a potential source of bugs if provided an ndarray-like object having a `length` property which is not equal to the product of the dimensions.\n\t\ty = ndarray( ydtype, buf, shape, shape2strides( shape, yorder ), 0, yorder ); // eslint-disable-line max-len\n\t}\n\tfcn( x, y );\n\treturn y;\n}\n\n\n// EXPORTS //\n\nmodule.exports = ndarrayfcn;\n", "/**\n* @license Apache-2.0\n*\n* Copyright (c) 2021 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 format = require( '@stdlib/string-format' );\n\n\n// MAIN //\n\n/**\n* Resolves an output array data type.\n*\n* @private\n* @param {string} xdtype - input array data type\n* @param {string} policy - policy determining an output array data type\n* @throws {Error} unsupported policy\n* @returns {string} output array data type\n*/\nfunction resolve( xdtype, policy ) {\n\tswitch ( policy ) {\n\tcase 'same':\n\t\treturn xdtype;\n\tcase 'floating-point':\n\t\t// TODO: we may want to delegate checking for a floating-point dtype to a utility function/package (e.g., isFloatDtype), in order to centralize logic for testing whether a dtype is \"floating-point\". Otherwise, this will be yet another place to update logic should we ever add, e.g., a `float128` or `float16` dtype.\n\t\tif (\n\t\t\txdtype === 'float64' ||\n\t\t\txdtype === 'float32' ||\n\t\t\txdtype === 'generic' ||\n\t\t\txdtype === 'complex128' ||\n\t\t\txdtype === 'complex64'\n\t\t) {\n\t\t\treturn xdtype;\n\t\t}\n\t\treturn 'float64'; // TODO: constants/math/default-real-floating-point-dtype?\n\tcase 'real floating-point':\n\t\tif (\n\t\t\txdtype === 'float64' ||\n\t\t\txdtype === 'float32' ||\n\t\t\txdtype === 'generic'\n\t\t) {\n\t\t\treturn xdtype;\n\t\t}\n\t\treturn 'float64';\n\tcase 'complex floating-point':\n\t\tif (\n\t\t\txdtype === 'complex128' ||\n\t\t\txdtype === 'complex64'\n\t\t) {\n\t\t\treturn xdtype;\n\t\t}\n\t\treturn 'complex128'; // TODO: constants/math/default-complex-floating-point-dtype?\n\tdefault:\n\t\tthrow new Error( format( 'invalid option. Unsupported policy for determining an output array data type. Option: `%s`.', policy ) );\n\t}\n}\n\n\n// EXPORTS //\n\nmodule.exports = resolve;\n", "{\n\t\"output_dtype_policy\": \"floating-point\"\n}\n", "/**\n* @license Apache-2.0\n*\n* Copyright (c) 2021 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 isPlainObject = require( '@stdlib/assert-is-plain-object' );\nvar hasOwnProp = require( '@stdlib/assert-has-own-property' );\nvar isFunction = require( '@stdlib/assert-is-function' );\nvar isNull = require( '@stdlib/assert-is-null' );\nvar objectKeys = require( '@stdlib/utils-keys' );\nvar format = require( '@stdlib/string-format' );\n\n\n// MAIN //\n\n/**\n* Validates a resolution table object.\n*\n* @private\n* @param {Object} out - destination object\n* @param {Object} table - resolution table object\n* @param {(Function|null)} [table.number] - function to invoke upon receiving a number\n* @param {(Function|null)} [table.complex] - function to invoke upon receiving a complex number\n* @param {(Function|null)} [table.array] - function to invoke upon receiving an array-like object\n* @param {(Function|null)} [table.ndarray] - function to invoke upon receiving an ndarray-like object\n* @returns {(Error|null)} null or an error object\n*\n* @example\n* var out = {};\n* var table = {\n*     'number': null,\n*     'complex': null,\n*     'array': null,\n*     'ndarray': null\n* };\n* var err = validate( out, table );\n* if ( err ) {\n*     throw err;\n* }\n*/\nfunction validate( out, table ) {\n\tvar fields;\n\tvar tmp;\n\tvar key;\n\tvar i;\n\n\tif ( !isPlainObject( table ) ) {\n\t\treturn new TypeError( format( 'invalid argument. Resolution table must be an object. Value: `%s`.', table ) );\n\t}\n\tfields = objectKeys( out );\n\tfor ( i = 0; i < fields.length; i++ ) {\n\t\tkey = fields[ i ];\n\t\tif ( hasOwnProp( table, key ) ) {\n\t\t\ttmp = table[ key ];\n\t\t\tif ( !isFunction( tmp ) && !isNull( tmp ) ) {\n\t\t\t\treturn new TypeError( format( 'invalid argument. Resolution table `%s` field value must be either a function or null. Value: `%s`.', key, tmp ) );\n\t\t\t}\n\t\t\tout[ key ] = tmp;\n\t\t}\n\t}\n\treturn null;\n}\n\n\n// EXPORTS //\n\nmodule.exports = validate;\n", "[\n\t\"same\",\n\t\"floating-point\",\n  \"real floating-point\",\n  \"complex floating-point\"\n]\n", "/**\n* @license Apache-2.0\n*\n* Copyright (c) 2021 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 isPlainObject = require( '@stdlib/assert-is-plain-object' );\nvar hasOwnProp = require( '@stdlib/assert-has-own-property' );\nvar contains = require( '@stdlib/assert-contains' );\nvar format = require( '@stdlib/string-format' );\nvar POLICIES = require( './policies.json' );\n\n\n// MAIN //\n\n/**\n* Validates function options.\n*\n* @private\n* @param {Object} opts - destination object\n* @param {Object} options - options\n* @param {string} [options.output_dtype_policy] - policy for determining the output array data type\n* @returns {(Error|null)} null or an error object\n*\n* @example\n* var opts = {};\n* var options = {\n*     'output_dtype_policy': 'float'\n* };\n* var err = validate( opts, options );\n* if ( err ) {\n*     throw err;\n* }\n*/\nfunction validate( opts, options ) {\n\tif ( !isPlainObject( options ) ) {\n\t\treturn new TypeError( format( 'invalid argument. Options argument must be an object. Value: `%s`.', options ) );\n\t}\n\tif ( hasOwnProp( options, 'output_dtype_policy' ) ) {\n\t\topts.policy = options.output_dtype_policy;\n\t\tif ( !contains( POLICIES, opts.policy ) ) {\n\t\t\treturn new TypeError( format( 'invalid option. `%s` option must be a recognized/supported output array data type policy. Option: `%s`.', 'output_dtype_policy', opts.policy ) );\n\t\t}\n\t}\n\treturn null;\n}\n\n\n// EXPORTS //\n\nmodule.exports = validate;\n", "/**\n* @license Apache-2.0\n*\n* Copyright (c) 2021 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 isPlainObject = require( '@stdlib/assert-is-plain-object' );\nvar hasOwnProp = require( '@stdlib/assert-has-own-property' );\nvar contains = require( '@stdlib/assert-contains' );\nvar orders = require( '@stdlib/ndarray-orders' );\nvar dtypes = require( '@stdlib/ndarray-dtypes' );\nvar format = require( '@stdlib/string-format' );\n\n\n// VARIABLES //\n\nvar ORDERS = orders();\nvar DTYPES = dtypes();\n\n\n// MAIN //\n\n/**\n* Validates function options.\n*\n* @private\n* @param {Object} opts - destination object\n* @param {Object} options - options\n* @param {string} [options.dtype] - output array data type\n* @param {string} [options.order] - output array order\n* @returns {(Error|null)} null or an error object\n*\n* @example\n* var opts = {};\n* var options = {\n*     'order': 'row-major'\n* };\n* var err = validate( opts, options );\n* if ( err ) {\n*     throw err;\n* }\n*/\nfunction validate( opts, options ) {\n\tif ( !isPlainObject( options ) ) {\n\t\treturn new TypeError( format( 'invalid argument. Options argument must be an object. Value: `%s`.', options ) );\n\t}\n\tif ( hasOwnProp( options, 'dtype' ) ) {\n\t\topts.dtype = options.dtype;\n\t\tif ( !contains( DTYPES, opts.dtype ) ) {\n\t\t\treturn new TypeError( format( 'invalid option. `%s` option must be a recognized/supported data type. Option: `%s`.', 'dtype', opts.dtype ) );\n\t\t}\n\t}\n\tif ( hasOwnProp( options, 'order' ) ) {\n\t\topts.order = options.order;\n\t\tif ( !contains( ORDERS, opts.order ) ) {\n\t\t\treturn new TypeError( format( 'invalid option. `%s` option must be a recognized/supported data type. Option: `%s`.', 'order', opts.order ) );\n\t\t}\n\t}\n\treturn null;\n}\n\n\n// EXPORTS //\n\nmodule.exports = validate;\n", "/**\n* @license Apache-2.0\n*\n* Copyright (c) 2021 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 setReadOnly = require( '@stdlib/utils-define-nonenumerable-read-only-property' );\nvar isNumber = require( '@stdlib/assert-is-number' ).isPrimitive;\nvar isComplexLike = require( '@stdlib/assert-is-complex-like' );\nvar isndarrayLike = require( '@stdlib/assert-is-ndarray-like' );\nvar isCollection = require( '@stdlib/assert-is-collection' );\nvar dtype = require( '@stdlib/ndarray-base-buffer-dtype' );\nvar buffer = require( '@stdlib/ndarray-base-buffer' );\nvar broadcast = require( '@stdlib/ndarray-base-broadcast-array' );\nvar format = require( '@stdlib/string-format' );\nvar ndarrayfcn = require( './ndarray.js' );\nvar odtype = require( './resolve_output_dtype.js' );\nvar defaults = require( './defaults.json' );\nvar validateTable = require( './validate_table.js' );\nvar validateOptions = require( './validate_options.js' );\nvar validate = require( './validate.js' );\n\n\n// MAIN //\n\n/**\n* Returns a function which dispatches to specified functions based on input argument types.\n*\n* @param {Object} table - resolution table object\n* @param {(Function|null)} [table.number] - function to invoke upon receiving a number\n* @param {(Function|null)} [table.complex] - function to invoke upon receiving a complex number\n* @param {(Function|null)} [table.array] - function to invoke upon receiving an array-like object\n* @param {(Function|null)} [table.ndarray] - function to invoke upon receiving an ndarray-like object\n* @param {Options} [options] - options\n* @param {string} [options.output_dtype_policy='floating-point'] - policy for determining the output array data type\n* @throws {TypeError} first argument must be an object\n* @throws {TypeError} first argument must have valid table fields\n* @throws {Error} each table field value must be either a function or `null`\n* @throws {TypeError} options argument must be an object\n* @throws {TypeError} must provide valid options\n* @returns {Function} dispatch function\n*\n* @example\n* var base = require( '@stdlib/math-base-special-abs' );\n* var strided = require( '@stdlib/math-strided-special-abs' );\n* var dispatcher = require( '@stdlib/ndarray-dispatch' );\n* var unary = require( '@stdlib/ndarray-base-unary' );\n* var Float64Array = require( '@stdlib/array-float64' );\n*\n* var types = [\n*     'float64', 'float64',\n*     'float32', 'float32',\n*     'generic', 'generic'\n* ];\n* var data = [\n*     base,\n*     base,\n*     base\n* ];\n* var nd = dispatcher( unary, types, data, 2, 1, 1 );\n*\n* var table = {\n*     'number': base,\n*     'complex': null,\n*     'array': strided,\n*     'ndarray': nd\n* };\n*\n* var abs = dispatch( table, {\n*     'output_dtype_policy': 'same'\n* });\n*\n* var x = new Float64Array( [ -1.0, -2.0, -3.0 ] );\n*\n* var y = abs( x );\n* // returns <Float64Array>[ 1.0, 2.0, 3.0 ]\n*/\nfunction dispatch( table, options ) {\n\tvar OPTS;\n\tvar err;\n\tvar fcn;\n\tvar t;\n\n\tt = {\n\t\t'number': null,\n\t\t'complex': null,\n\t\t'array': null,\n\t\t'ndarray': null\n\t};\n\terr = validateTable( t, table );\n\tif ( err ) {\n\t\tthrow err;\n\t}\n\tOPTS = {\n\t\t'policy': defaults.output_dtype_policy\n\t};\n\tif ( arguments.length > 1 ) {\n\t\terr = validateOptions( OPTS, options );\n\t\tif ( err ) {\n\t\t\tthrow err;\n\t\t}\n\t}\n\tfcn = dispatcher;\n\tsetReadOnly( fcn, 'assign', assign );\n\treturn fcn;\n\n\t/**\n\t* Function interface which performs dispatch.\n\t*\n\t* @private\n\t* @param {(ndarray|Collection|number|Complex)} x - input value\n\t* @param {Options} [options] - options\n\t* @param {string} [options.dtype] - output array data type\n\t* @param {string} [options.order] - output array order (row-major or column-major)\n\t* @throws {TypeError} first argument must be a supported data type\n\t* @throws {TypeError} options argument must be an object\n\t* @throws {TypeError} must provide valid options\n\t* @returns {(ndarray|Collection|number|Complex)} results\n\t*/\n\tfunction dispatcher( x ) {\n\t\tvar xdtype;\n\t\tvar ydtype;\n\t\tvar opts;\n\t\tvar err;\n\t\tvar y;\n\t\tif ( isNumber( x ) ) {\n\t\t\tif ( t.number ) {\n\t\t\t\treturn t.number( x );\n\t\t\t}\n\t\t\tthrow new TypeError( 'invalid argument. Providing a number is not supported.' );\n\t\t}\n\t\tif ( isComplexLike( x ) ) {\n\t\t\tif ( t.complex ) {\n\t\t\t\treturn t.complex( x );\n\t\t\t}\n\t\t\tthrow new TypeError( 'invalid argument. Providing a complex number is not supported.' );\n\t\t}\n\t\topts = {};\n\t\tif ( arguments.length > 1 ) {\n\t\t\terr = validate( opts, arguments[ 1 ] );\n\t\t\tif ( err ) {\n\t\t\t\tthrow err;\n\t\t\t}\n\t\t}\n\t\tif ( isndarrayLike( x ) ) {\n\t\t\tif ( t.ndarray === null ) {\n\t\t\t\tthrow new TypeError( 'invalid argument. Providing an ndarray is not supported.' );\n\t\t\t}\n\t\t\tydtype = opts.dtype || odtype( x.dtype, OPTS.policy );\n\t\t\treturn ndarrayfcn( t.ndarray, x, ydtype, opts.order || x.order );\n\t\t}\n\t\tif ( isCollection( x ) ) {\n\t\t\tif ( t.array === null ) {\n\t\t\t\tthrow new TypeError( 'invalid argument. Providing an array-like object is not supported.' );\n\t\t\t}\n\t\t\txdtype = dtype( x ) || 'generic';\n\t\t\tydtype = opts.dtype || odtype( xdtype, OPTS.policy );\n\t\t\ty = buffer( ydtype, x.length );\n\t\t\tt.array( x.length, xdtype, x, 1, ydtype, y, 1 );\n\t\t\treturn y;\n\t\t}\n\t\tthrow new TypeError( format( 'invalid argument. Must provide an argument having a supported data type. Value: `%s`.', x ) );\n\t}\n\n\t/**\n\t* Function interface which performs dispatch and assigns results to a provided output array.\n\t*\n\t* @private\n\t* @param {(ndarray|Collection)} x - input array\n\t* @param {(ndarray|Collection)} y - output array\n\t* @throws {TypeError} first argument must be a supported data type\n\t* @throws {TypeError} second argument must be a supported data type\n\t* @throws {TypeError} first and second argument must be the same \"kind\" (i.e., either both ndarrays or both collections)\n\t* @throws {RangeError} output array must have sufficient elements\n\t* @throws {Error} unable to broadcast the input array against the output array\n\t* @returns {(ndarray|Collection)} output array\n\t*/\n\tfunction assign( x, y ) {\n\t\tvar xsh;\n\t\tvar ysh;\n\t\tvar i;\n\t\tif ( isndarrayLike( x ) ) {\n\t\t\tif ( isndarrayLike( y ) ) {\n\t\t\t\txsh = x.shape;\n\t\t\t\tysh = y.shape;\n\n\t\t\t\t// Check whether we need to broadcast `x`...\n\t\t\t\tif ( xsh.length === ysh.length ) {\n\t\t\t\t\tfor ( i = 0; i < xsh.length; i++ ) {\n\t\t\t\t\t\t// Check whether dimensions match...\n\t\t\t\t\t\tif ( xsh[ i ] !== ysh[ i ] ) {\n\t\t\t\t\t\t\t// We found a mismatched dimension; delegate to `broadcast` to ensure that `x` is broadcast compatible with the output array shape...\n\t\t\t\t\t\t\tx = broadcast( x, ysh );\n\t\t\t\t\t\t\tbreak;\n\t\t\t\t\t\t}\n\t\t\t\t\t}\n\t\t\t\t} else {\n\t\t\t\t\t// If we are provided arrays with different ranks (i.e., number of dimensions), assume we need to broadcast, delegating to `broadcast` to ensure that `x` is broadcast compatible with the output array shape...\n\t\t\t\t\tx = broadcast( x, ysh );\n\t\t\t\t}\n\t\t\t\tt.ndarray( x, y );\n\t\t\t\treturn y;\n\t\t\t}\n\t\t\tthrow new TypeError( 'invalid argument. If the first argument is an ndarray, the second argument must be an ndarray.' );\n\t\t}\n\t\tif ( isCollection( x ) ) {\n\t\t\tif ( isCollection( y ) ) {\n\t\t\t\tif ( y.length !== x.length ) {\n\t\t\t\t\tthrow new RangeError( 'invalid argument. Output array must have the same number of elements (i.e., length) as the input array.' );\n\t\t\t\t}\n\t\t\t\tt.array( x.length, dtype( x ) || 'generic', x, 1, dtype( y ) || 'generic', y, 1 );\n\t\t\t\treturn y;\n\t\t\t}\n\t\t\tthrow new TypeError( 'invalid argument. If the first argument is an array-like object, the second argument must be an array-like object.' );\n\t\t}\n\t\tif ( isNumber( x ) ) {\n\t\t\tthrow new TypeError( 'invalid argument. Providing a number is not supported. Consider providing a zero-dimensional ndarray containing the numeric value.' );\n\t\t}\n\t\tif ( isComplexLike( x ) ) {\n\t\t\tthrow new TypeError( 'invalid argument. Providing a complex number is not supported. Consider providing a zero-dimensional ndarray containing the complex number value.' );\n\t\t}\n\t\tthrow new TypeError( format( 'invalid argument. Must provide an argument having a supported data type. Value: `%s`.', x ) );\n\t}\n}\n\n\n// EXPORTS //\n\nmodule.exports = dispatch;\n", "/**\n* @license Apache-2.0\n*\n* Copyright (c) 2021 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* Return a function which dispatches to specified functions based on input argument types.\n*\n* @module @stdlib/math-tools-unary\n*\n* @example\n* var base = require( '@stdlib/math-base-special-abs' );\n* var strided = require( '@stdlib/math-strided-special-abs' );\n* var dispatcher = require( '@stdlib/ndarray-dispatch' );\n* var unary = require( '@stdlib/ndarray-base-unary' );\n* var Float64Array = require( '@stdlib/array-float64' );\n* var dispatch = require( '@stdlib/math-tools-unary' );\n*\n* var types = [\n*     'float64', 'float64',\n*     'float32', 'float32',\n*     'generic', 'generic'\n* ];\n* var data = [\n*     base,\n*     base,\n*     base\n* ];\n* var nd = dispatcher( unary, types, data, 2, 1, 1 );\n*\n* var table = {\n*     'number': base,\n*     'complex': null,\n*     'array': strided,\n*     'ndarray': nd\n* };\n*\n* var abs = dispatch( table );\n*\n* var x = new Float64Array( [ -1.0, -2.0, -3.0 ] );\n* var y = abs( x );\n* // returns <Float64Array>[ 1.0, 2.0, 3.0 ]\n*/\n\n// MAIN //\n\nvar main = require( './main.js' );\n\n\n// EXPORTS //\n\nmodule.exports = main;\n"],
+  "mappings": "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",
+  "names": ["require_ndarray", "__commonJSMin", "exports", "module", "ndarray", "buffer", "shape2strides", "numel", "copy", "ndarrayfcn", "fcn", "x", "ydtype", "yorder", "shape", "buf", "y", "require_resolve_output_dtype", "__commonJSMin", "exports", "module", "format", "resolve", "xdtype", "policy", "require_defaults", "__commonJSMin", "exports", "module", "require_validate_table", "__commonJSMin", "exports", "module", "isPlainObject", "hasOwnProp", "isFunction", "isNull", "objectKeys", "format", "validate", "out", "table", "fields", "tmp", "key", "require_policies", "__commonJSMin", "exports", "module", "require_validate_options", "__commonJSMin", "exports", "module", "isPlainObject", "hasOwnProp", "contains", "format", "POLICIES", "validate", "opts", "options", "require_validate", "__commonJSMin", "exports", "module", "isPlainObject", "hasOwnProp", "contains", "orders", "dtypes", "format", "ORDERS", "DTYPES", "validate", "opts", "options", "require_main", "__commonJSMin", "exports", "module", "setReadOnly", "isNumber", "isComplexLike", "isndarrayLike", "isCollection", "dtype", "buffer", "broadcast", "format", "ndarrayfcn", "odtype", "defaults", "validateTable", "validateOptions", "validate", "dispatch", "table", "options", "OPTS", "err", "fcn", "t", "dispatcher", "assign", "x", "xdtype", "ydtype", "opts", "y", "xsh", "ysh", "i", "main"]
+}

package/docs/types/index.d.ts CHANGED Viewed

@@ -16,7 +16,7 @@
 * limitations under the License.
 */
-// TypeScript Version: 2.0
+// TypeScript Version: 4.1
 /// <reference types="@stdlib/types"/>

package/lib/defaults.json CHANGED Viewed

@@ -1,3 +1,3 @@
 {
-	"output_dtype_policy": "float"
+	"output_dtype_policy": "floating-point"
 }

package/lib/main.js CHANGED Viewed

@@ -28,6 +28,7 @@ var isCollection = require( '@stdlib/assert-is-collection' );
 var dtype = require( '@stdlib/ndarray-base-buffer-dtype' );
 var buffer = require( '@stdlib/ndarray-base-buffer' );
 var broadcast = require( '@stdlib/ndarray-base-broadcast-array' );
+var format = require( '@stdlib/string-format' );
 var ndarrayfcn = require( './ndarray.js' );
 var odtype = require( './resolve_output_dtype.js' );
 var defaults = require( './defaults.json' );
@@ -47,7 +48,7 @@ var validate = require( './validate.js' );
 * @param {(Function|null)} [table.array] - function to invoke upon receiving an array-like object
 * @param {(Function|null)} [table.ndarray] - function to invoke upon receiving an ndarray-like object
 * @param {Options} [options] - options
-* @param {string} [options.output_dtype_policy='float'] - policy for determining the output array data type
+* @param {string} [options.output_dtype_policy='floating-point'] - policy for determining the output array data type
 * @throws {TypeError} first argument must be an object
 * @throws {TypeError} first argument must have valid table fields
 * @throws {Error} each table field value must be either a function or `null`
@@ -132,7 +133,7 @@ function dispatch( table, options ) {
 	* @throws {TypeError} must provide valid options
 	* @returns {(ndarray|Collection|number|Complex)} results
 	*/
-	function dispatcher( x, options ) {
+	function dispatcher( x ) {
 		var xdtype;
 		var ydtype;
 		var opts;
@@ -152,7 +153,7 @@ function dispatch( table, options ) {
 		}
 		opts = {};
 		if ( arguments.length > 1 ) {
-			err = validate( opts, options );
+			err = validate( opts, arguments[ 1 ] );
 			if ( err ) {
 				throw err;
 			}
@@ -171,12 +172,10 @@ function dispatch( table, options ) {
 			xdtype = dtype( x ) || 'generic';
 			ydtype = opts.dtype || odtype( xdtype, OPTS.policy );
 			y = buffer( ydtype, x.length );
-			// FIXME: need to supply dtype enum argument for each array argument...
-			t.array( x.length, x, 1, y, 1 );
+			t.array( x.length, xdtype, x, 1, ydtype, y, 1 );
 			return y;
 		}
-		throw new TypeError( 'invalid argument. Must provide an argument having a supported data type. Value: `' + x + '`.' );
+		throw new TypeError( format( 'invalid argument. Must provide an argument having a supported data type. Value: `%s`.', x ) );
 	}
 	/**
@@ -225,8 +224,7 @@ function dispatch( table, options ) {
 				if ( y.length !== x.length ) {
 					throw new RangeError( 'invalid argument. Output array must have the same number of elements (i.e., length) as the input array.' );
 				}
-				// FIXME: need to supply dtype enum argument for each array argument...
-				t.array( x.length, x, 1, y, 1 );
+				t.array( x.length, dtype( x ) || 'generic', x, 1, dtype( y ) || 'generic', y, 1 );
 				return y;
 			}
 			throw new TypeError( 'invalid argument. If the first argument is an array-like object, the second argument must be an array-like object.' );
@@ -237,7 +235,7 @@ function dispatch( table, options ) {
 		if ( isComplexLike( x ) ) {
 			throw new TypeError( 'invalid argument. Providing a complex number is not supported. Consider providing a zero-dimensional ndarray containing the complex number value.' );
 		}
-		throw new TypeError( 'invalid argument. Must provide an argument having a supported data type. Value: `' + x + '`.' );
+		throw new TypeError( format( 'invalid argument. Must provide an argument having a supported data type. Value: `%s`.', x ) );
 	}
 }

package/lib/ndarray.js CHANGED Viewed

@@ -24,27 +24,7 @@ var ndarray = require( '@stdlib/ndarray-ctor' );
 var buffer = require( '@stdlib/ndarray-base-buffer' );
 var shape2strides = require( '@stdlib/ndarray-base-shape2strides' );
 var numel = require( '@stdlib/ndarray-base-numel' );
-// FUNCTIONS //
-/**
-* Copies an array-like object to a generic array.
-*
-* @private
-* @param {ArrayLikeObject} x - input array
-* @returns {Array} output array
-*/
-function copy( x ) {
-	var out;
-	var i;
-	out = [];
-	for ( i = 0; i < x.length; i++ ) {
-		out.push( x[ i ] );
-	}
-	return out;
-}
+var copy = require( '@stdlib/array-base-copy-indexed' );
 // MAIN //
@@ -57,7 +37,6 @@ function copy( x ) {
 * @param {ndarray} x - input array
 * @param {string} ydtype - output array data type
 * @param {string} yorder - output array order
-* @throws {TypeError} must provide an input array argument with a supported data type
 * @returns {ndarray} output array
 */
 function ndarrayfcn( fcn, x, ydtype, yorder ) {

package/lib/policies.json CHANGED Viewed

@@ -1,4 +1,6 @@
 [
 	"same",
-	"float"
+	"floating-point",
+  "real floating-point",
+  "complex floating-point"
 ]

package/lib/resolve_output_dtype.js CHANGED Viewed

@@ -18,6 +18,13 @@
 'use strict';
+// MODULES //
+var format = require( '@stdlib/string-format' );
+// MAIN //
 /**
 * Resolves an output array data type.
 *
@@ -31,7 +38,19 @@ function resolve( xdtype, policy ) {
 	switch ( policy ) {
 	case 'same':
 		return xdtype;
-	case 'float':
+	case 'floating-point':
+		// TODO: we may want to delegate checking for a floating-point dtype to a utility function/package (e.g., isFloatDtype), in order to centralize logic for testing whether a dtype is "floating-point". Otherwise, this will be yet another place to update logic should we ever add, e.g., a `float128` or `float16` dtype.
+		if (
+			xdtype === 'float64' ||
+			xdtype === 'float32' ||
+			xdtype === 'generic' ||
+			xdtype === 'complex128' ||
+			xdtype === 'complex64'
+		) {
+			return xdtype;
+		}
+		return 'float64'; // TODO: constants/math/default-real-floating-point-dtype?
+	case 'real floating-point':
 		if (
 			xdtype === 'float64' ||
 			xdtype === 'float32' ||
@@ -40,8 +59,16 @@ function resolve( xdtype, policy ) {
 			return xdtype;
 		}
 		return 'float64';
+	case 'complex floating-point':
+		if (
+			xdtype === 'complex128' ||
+			xdtype === 'complex64'
+		) {
+			return xdtype;
+		}
+		return 'complex128'; // TODO: constants/math/default-complex-floating-point-dtype?
 	default:
-		throw new Error( 'invalid option. Unsupported policy for determining an output array data type. Option: `' + policy + '`.' );
+		throw new Error( format( 'invalid option. Unsupported policy for determining an output array data type. Option: `%s`.', policy ) );
 	}
 }

package/lib/validate.js CHANGED Viewed

@@ -25,6 +25,7 @@ var hasOwnProp = require( '@stdlib/assert-has-own-property' );
 var contains = require( '@stdlib/assert-contains' );
 var orders = require( '@stdlib/ndarray-orders' );
 var dtypes = require( '@stdlib/ndarray-dtypes' );
+var format = require( '@stdlib/string-format' );
 // VARIABLES //
@@ -57,18 +58,18 @@ var DTYPES = dtypes();
 */
 function validate( opts, options ) {
 	if ( !isPlainObject( options ) ) {
-		return new TypeError( 'invalid argument. Options argument must be a plain object. Value: `' + options + '`.' );
+		return new TypeError( format( 'invalid argument. Options argument must be an object. Value: `%s`.', options ) );
 	}
 	if ( hasOwnProp( options, 'dtype' ) ) {
 		opts.dtype = options.dtype;
 		if ( !contains( DTYPES, opts.dtype ) ) {
-			return new TypeError( 'invalid option. `dtype` option must be a recognized/supported data type. Option: `' + opts.dtype + '`.' );
+			return new TypeError( format( 'invalid option. `%s` option must be a recognized/supported data type. Option: `%s`.', 'dtype', opts.dtype ) );
 		}
 	}
 	if ( hasOwnProp( options, 'order' ) ) {
 		opts.order = options.order;
 		if ( !contains( ORDERS, opts.order ) ) {
-			return new TypeError( 'invalid option. `order` option must be a recognized/supported data type. Option: `' + opts.order + '`.' );
+			return new TypeError( format( 'invalid option. `%s` option must be a recognized/supported data type. Option: `%s`.', 'order', opts.order ) );
 		}
 	}
 	return null;

package/lib/validate_options.js CHANGED Viewed

@@ -23,6 +23,7 @@
 var isPlainObject = require( '@stdlib/assert-is-plain-object' );
 var hasOwnProp = require( '@stdlib/assert-has-own-property' );
 var contains = require( '@stdlib/assert-contains' );
+var format = require( '@stdlib/string-format' );
 var POLICIES = require( './policies.json' );
@@ -49,12 +50,12 @@ var POLICIES = require( './policies.json' );
 */
 function validate( opts, options ) {
 	if ( !isPlainObject( options ) ) {
-		return new TypeError( 'invalid argument. Options argument must be a plain object. Value: `' + options + '`.' );
+		return new TypeError( format( 'invalid argument. Options argument must be an object. Value: `%s`.', options ) );
 	}
 	if ( hasOwnProp( options, 'output_dtype_policy' ) ) {
 		opts.policy = options.output_dtype_policy;
 		if ( !contains( POLICIES, opts.policy ) ) {
-			return new TypeError( 'invalid option. `output_dtype_policy` option must be a recognized/supported output array data type policy. Option: `' + opts.policy + '`.' );
+			return new TypeError( format( 'invalid option. `%s` option must be a recognized/supported output array data type policy. Option: `%s`.', 'output_dtype_policy', opts.policy ) );
 		}
 	}
 	return null;

package/lib/validate_table.js CHANGED Viewed

@@ -25,6 +25,7 @@ var hasOwnProp = require( '@stdlib/assert-has-own-property' );
 var isFunction = require( '@stdlib/assert-is-function' );
 var isNull = require( '@stdlib/assert-is-null' );
 var objectKeys = require( '@stdlib/utils-keys' );
+var format = require( '@stdlib/string-format' );
 // MAIN //
@@ -61,7 +62,7 @@ function validate( out, table ) {
 	var i;
 	if ( !isPlainObject( table ) ) {
-		return new TypeError( 'invalid argument. Resolution table must be a plain object. Value: `' + table + '`.' );
+		return new TypeError( format( 'invalid argument. Resolution table must be an object. Value: `%s`.', table ) );
 	}
 	fields = objectKeys( out );
 	for ( i = 0; i < fields.length; i++ ) {
@@ -69,7 +70,7 @@ function validate( out, table ) {
 		if ( hasOwnProp( table, key ) ) {
 			tmp = table[ key ];
 			if ( !isFunction( tmp ) && !isNull( tmp ) ) {
-				return new TypeError( 'invalid argument. Resolution table `' + key + '` field value must be either a function or `null`. Value: `' + tmp + '`.' );
+				return new TypeError( format( 'invalid argument. Resolution table `%s` field value must be either a function or null. Value: `%s`.', key, tmp ) );
 			}
 			out[ key ] = tmp;
 		}

package/package.json CHANGED Viewed

@@ -1,6 +1,6 @@
 {
   "name": "@stdlib/math-tools-unary",
-  "version": "0.0.6",
+  "version": "0.1.0",
   "description": "Multiple dispatch for unary mathematical functions.",
   "license": "Apache-2.0",
   "author": {
@@ -37,46 +37,46 @@
     "url": "https://github.com/stdlib-js/stdlib/issues"
   },
   "dependencies": {
-    "@stdlib/assert-contains": "^0.0.x",
-    "@stdlib/assert-has-own-property": "^0.0.x",
-    "@stdlib/assert-is-collection": "^0.0.x",
-    "@stdlib/assert-is-complex-like": "^0.0.x",
-    "@stdlib/assert-is-function": "^0.0.x",
-    "@stdlib/assert-is-ndarray-like": "^0.0.x",
-    "@stdlib/assert-is-null": "^0.0.x",
-    "@stdlib/assert-is-number": "^0.0.x",
-    "@stdlib/assert-is-plain-object": "^0.0.x",
-    "@stdlib/ndarray-base-broadcast-array": "^0.0.x",
-    "@stdlib/ndarray-base-buffer": "^0.0.x",
-    "@stdlib/ndarray-base-buffer-dtype": "^0.0.x",
-    "@stdlib/ndarray-base-numel": "^0.0.x",
-    "@stdlib/ndarray-base-shape2strides": "^0.0.x",
-    "@stdlib/ndarray-ctor": "^0.0.x",
-    "@stdlib/ndarray-dtypes": "^0.0.x",
-    "@stdlib/ndarray-orders": "^0.0.x",
-    "@stdlib/types": "^0.0.x",
-    "@stdlib/utils-define-nonenumerable-read-only-property": "^0.0.x",
-    "@stdlib/utils-keys": "^0.0.x"
+    "@stdlib/array-base-copy-indexed": "^0.1.0",
+    "@stdlib/assert-contains": "^0.1.0",
+    "@stdlib/assert-has-own-property": "^0.1.0",
+    "@stdlib/assert-is-collection": "^0.1.0",
+    "@stdlib/assert-is-complex-like": "^0.1.0",
+    "@stdlib/assert-is-function": "^0.1.0",
+    "@stdlib/assert-is-ndarray-like": "^0.1.0",
+    "@stdlib/assert-is-null": "^0.1.0",
+    "@stdlib/assert-is-number": "^0.1.0",
+    "@stdlib/assert-is-plain-object": "^0.1.0",
+    "@stdlib/ndarray-base-broadcast-array": "^0.1.0",
+    "@stdlib/ndarray-base-buffer": "^0.1.0",
+    "@stdlib/ndarray-base-buffer-dtype": "^0.1.0",
+    "@stdlib/ndarray-base-numel": "^0.1.0",
+    "@stdlib/ndarray-base-shape2strides": "^0.1.0",
+    "@stdlib/ndarray-ctor": "^0.1.0",
+    "@stdlib/ndarray-dtypes": "^0.1.0",
+    "@stdlib/ndarray-orders": "^0.1.0",
+    "@stdlib/string-format": "^0.1.0",
+    "@stdlib/types": "^0.1.0",
+    "@stdlib/utils-define-nonenumerable-read-only-property": "^0.1.0",
+    "@stdlib/utils-keys": "^0.1.0",
+    "@stdlib/error-tools-fmtprodmsg": "^0.1.0"
   },
   "devDependencies": {
-    "@stdlib/array-float32": "^0.0.x",
-    "@stdlib/array-float64": "^0.0.x",
-    "@stdlib/array-int32": "^0.0.x",
-    "@stdlib/bench": "^0.0.x",
-    "@stdlib/math-base-assert-is-nan": "^0.0.x",
-    "@stdlib/math-base-special-abs": "^0.0.x",
-    "@stdlib/math-base-special-pow": "^0.0.x",
-    "@stdlib/math-strided-special-abs": "^0.0.x",
-    "@stdlib/math-strided-special-dabs": "^0.0.x",
-    "@stdlib/math-strided-special-sabs": "^0.0.x",
-    "@stdlib/ndarray-array": "^0.0.x",
-    "@stdlib/ndarray-base-unary": "^0.0.x",
-    "@stdlib/ndarray-dispatch": "^0.0.x",
-    "@stdlib/ndarray-ind2sub": "^0.0.x",
-    "@stdlib/random-base-uniform": "^0.0.x",
+    "@stdlib/array-float32": "^0.1.0",
+    "@stdlib/array-float64": "^0.1.0",
+    "@stdlib/bench": "^0.1.0",
+    "@stdlib/math-base-assert-is-nan": "^0.1.0",
+    "@stdlib/math-base-special-abs": "^0.1.0",
+    "@stdlib/math-base-special-pow": "^0.1.0",
+    "@stdlib/math-strided-special-abs": "^0.1.0",
+    "@stdlib/ndarray-array": "^0.0.9",
+    "@stdlib/ndarray-base-unary": "^0.1.0",
+    "@stdlib/ndarray-dispatch": "^0.1.0",
+    "@stdlib/ndarray-ind2sub": "^0.1.0",
+    "@stdlib/random-base-uniform": "^0.0.6",
     "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"
   },
   "engines": {
     "node": ">=0.10.0",
@@ -108,7 +108,7 @@
   ],
   "__stdlib__": {},
   "funding": {
-    "type": "patreon",
-    "url": "https://www.patreon.com/athan"
+    "type": "opencollective",
+    "url": "https://opencollective.com/stdlib"
   }
 }

package/docs/repl.txt DELETED Viewed

@@ -1,119 +0,0 @@
-{{alias}}( table )
-    Returns a function which dispatches to specified functions based on input
-    argument types.
-    A `table` resolution object may contain one or more of the following fields:
-    - scalar: strided look-up table for scalar arguments.
-    - array: strided look-up table for array-like object arguments.
-    - ndarray: strided look-up table for ndarray arguments.
-    Each strided look-up table should be comprised as follows:
-      [ <dtype>, <fcn>, <dtype>, <fcn>, ... ]
-    If an argument's data type is *not* found in the argument's corresponding
-    look-up table and if a 'generic' data type is present in that same table,
-    the returned dispatch function will resolve the "generic" implementation. In
-    other words, an implementation associated with a 'generic' data type will be
-    treated as the default implementation.
-    If unable to resolve an implementation for a provided argument data type,
-    the returned function throws an error.
-    If provided a number, the returned function returns a number.
-    If provided an ndarray or array-like object, the returned function performs
-    element-wise computation.
-    If provided an array-like object, the returned function returns an array-
-    like object having the same length and data type as the provided input
-    argument.
-    If provided an ndarray, the returned function returns an ndarray having the
-    same shape and data type as the provided input argument.
-    Parameters
-    ----------
-    table: Object
-        Table resolution object.
-    table.scalar: ArrayLikeObject (optional)
-        Strided look-up table for scalar arguments. Supported data types:
-        'number' and 'complex'.
-    table.array: ArrayLikeObject (optional)
-        Strided look-up table for array-like object arguments. Implementation
-        functions must follow strided array interface argument conventions:
-          fcn( N, x, strideX, y, strideY )
-        where
-        - N: number of indexed elements.
-        - x: input strided array.
-        - strideX: index increment for `x`.
-        - y: destination strided array.
-        - strideY: index increment for `y`.
-        Supported array data types consist of all supported ndarray data types.
-    table.ndarray: ArrayLikeObject (optional)
-        Strided look-up table for ndarray arguments. Implementation functions
-        must follow strided array ndarray interface argument conventions:
-        fcn( N, x, strideX, offsetX, y, strideY, offsetY )
-        where
-        - N: number of indexed elements.
-        - x: input strided array (i.e., underlying input ndarray buffer).
-        - strideX: index increment for `x`.
-        - offsetX: starting index for `x`.
-        - y: destination strided array (i.e., underlying output ndarray buffer).
-        - strideY: index increment for `y`.
-        - offsetY: starting index for `y`.
-        Supported data types consist of all supported ndarray data types.
-    Returns
-    -------
-    fcn: Function
-        Dispatch function.
-    Examples
-    --------
-    > var t = {};
-    > t.scalar = [ 'number', {{alias:@stdlib/math/base/special/abs}} ];
-    > t.array = [
-    ...    'float64', {{alias:@stdlib/math/strided/special/dabs}},
-    ...    'float32', {{alias:@stdlib/math/strided/special/sabs}},
-    ...    'generic', {{alias:@stdlib/math/strided/special/abs}}
-    ... ];
-    > t.ndarray = [
-    ...    'float64', {{alias:@stdlib/math/strided/special/dabs}}.ndarray,
-    ...    'float32', {{alias:@stdlib/math/strided/special/sabs}}.ndarray,
-    ...    'generic', {{alias:@stdlib/math/strided/special/abs}}.ndarray
-    ... ];
-    > var fcn = {{alias}}( t );
-    // Provide a number:
-    > var y = fcn( -1.0 )
-    1.0
-    // Provide an array-like object:
-    > var x = new {{alias:@stdlib/array/float64}}( [ -1.0, -2.0 ] );
-    > y = fcn( x )
-    <Float64Array>[ 1.0, 2.0 ]
-    // Provide an ndarray:
-    > x = {{alias:@stdlib/ndarray/array}}( [ [ -1.0, -2.0 ], [ -3.0, -4.0 ] ] );
-    > y = fcn( x )
-    <ndarray>
-    > y.get( 0, 1 )
-    2.0
-    See Also
-    --------

package/docs/types/test.ts DELETED Viewed

@@ -1,288 +0,0 @@
-/*
-* @license Apache-2.0
-*
-* Copyright (c) 2021 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.
-*/
-/// <reference types="@stdlib/types"/>
-import { ndarray } from '@stdlib/types/ndarray';
-import dispatch = require( './index' );
-/**
-* Identity function.
-*
-* @param x - input value
-* @returns return value
-*/
-function identity( x: number ): number {
-	return x;
-}
-/**
-* Function which operates on a strided array.
-*
-* @param N - number of indexed elements
-* @param x - input array
-* @param strideX - `x` stride length
-* @param y - destination array
-* @param strideY - `y` stride length
-* @returns `y`
-*/
-function stridedArrayFunction( N: number, x: ArrayLike<number>, strideX: number, y: ArrayLike<number>, strideY: number ): ArrayLike<number> { // tslint:disable-line:max-line-length
-	let ix;
-	let iy;
-	if ( N <= 0 ) {
-		return y;
-	}
-	if ( strideX < 0 ) {
-		ix = ( 1 - N ) * strideX;
-	} else {
-		ix = 0;
-	}
-	if ( strideY < 0 ) {
-		iy = ( 1 - N ) * strideY;
-	} else {
-		iy = 0;
-	}
-	if ( x[ ix ] !== x[ ix ] ) {
-		return y;
-	}
-	if ( y[ iy ] !== y[ iy ] ) {
-		return y;
-	}
-	return y;
-}
-/**
-* Function which operates on a strided array using alternative indexing semantics.
-*
-* @param N - number of indexed elements
-* @param x - input array
-* @param strideX - `x` stride length
-* @param offsetX - starting index for `x`
-* @param y - destination array
-* @param strideY - `y` stride length
-* @param offsetY - starting index for `y`
-* @returns `y`
-*/
-function stridedArrayFunctionWithOffsets( N: number, x: ArrayLike<number>, strideX: number, offsetX: number, y: ArrayLike<number>, strideY: number, offsetY: number ): ArrayLike<number> { // tslint:disable-line:max-line-length
-	let ix;
-	let iy;
-	if ( N <= 0 ) {
-		return y;
-	}
-	ix = offsetX;
-	iy = offsetY;
-	if ( x[ ix + strideX ] !== x[ ix + strideX ] ) {
-		return y;
-	}
-	if ( y[ iy + strideY ] !== y[ iy + strideY ] ) {
-		return y;
-	}
-	return y;
-}
-// TESTS //
-// The function returns a dispatch function...
-{
-	const t1 = {};
-	dispatch( t1 ); // $ExpectType DispatchFunction
-	const t2 = {
-		'scalar': [ 'number', identity ]
-	};
-	dispatch( t2 ); // $ExpectType DispatchFunction
-	const t3 = {
-		'array': [ 'generic', stridedArrayFunction ]
-	};
-	dispatch( t3 ); // $ExpectType DispatchFunction
-	const t4 = {
-		'ndarray': [ 'generic', stridedArrayFunctionWithOffsets ]
-	};
-	dispatch( t4 ); // $ExpectType DispatchFunction
-	const t5 = {
-		'scalar': [ 'number', identity ],
-		'array': [ 'generic', stridedArrayFunction ]
-	};
-	dispatch( t5 ); // $ExpectType DispatchFunction
-	const t6 = {
-		'scalar': [ 'number', identity ],
-		'ndarray': [ 'generic', stridedArrayFunctionWithOffsets ]
-	};
-	dispatch( t6 ); // $ExpectType DispatchFunction
-	const t7 = {
-		'array': [ 'generic', stridedArrayFunction ],
-		'ndarray': [ 'generic', stridedArrayFunctionWithOffsets ]
-	};
-	dispatch( t7 ); // $ExpectType DispatchFunction
-	const t8 = {
-		'scalar': [ 'number', identity ],
-		'array': [ 'generic', stridedArrayFunction ],
-		'ndarray': [ 'generic', stridedArrayFunctionWithOffsets ]
-	};
-	dispatch( t8 ); // $ExpectType DispatchFunction
-}
-// The function does not compile if not provided a table resolution object...
-{
-	dispatch( '5' ); // $ExpectError
-	dispatch( 5 ); // $ExpectError
-	dispatch( true ); // $ExpectError
-	dispatch( false ); // $ExpectError
-	dispatch( null ); // $ExpectError
-	dispatch( undefined ); // $ExpectError
-	dispatch( [ '5' ] ); // $ExpectError
-	dispatch( ( x: number ): number => x ); // $ExpectError
-}
-// The function does not compile if provided a table resolution object having an invalid `scalar` field...
-{
-	dispatch( { 'scalar': 5 } ); // $ExpectError
-	dispatch( { 'scalar': true } ); // $ExpectError
-	dispatch( { 'scalar': false } ); // $ExpectError
-	dispatch( { 'scalar': null } ); // $ExpectError
-	dispatch( { 'scalar': [ 5 ] } ); // $ExpectError
-	dispatch( { 'scalar': [ '5', 5 ] } ); // $ExpectError
-	dispatch( { 'scalar': ( x: number ): number => x } ); // $ExpectError
-	dispatch( { 'scalar': [ '5', ( x: string ): string => x ] } ); // $ExpectError
-}
-// The function does not compile if provided a table resolution object having an invalid `array` field...
-{
-	dispatch( { 'array': 5 } ); // $ExpectError
-	dispatch( { 'array': true } ); // $ExpectError
-	dispatch( { 'array': false } ); // $ExpectError
-	dispatch( { 'array': null } ); // $ExpectError
-	dispatch( { 'array': [ 5 ] } ); // $ExpectError
-	dispatch( { 'array': [ '5', 5 ] } ); // $ExpectError
-	dispatch( { 'array': ( x: number ): number => x } ); // $ExpectError
-	dispatch( { 'array': [ '5', ( x: string ): string => x ] } ); // $ExpectError
-}
-// The function does not compile if provided a table resolution object having an invalid `ndarray` field...
-{
-	dispatch( { 'ndarray': 5 } ); // $ExpectError
-	dispatch( { 'ndarray': true } ); // $ExpectError
-	dispatch( { 'ndarray': false } ); // $ExpectError
-	dispatch( { 'ndarray': null } ); // $ExpectError
-	dispatch( { 'ndarray': [ 5 ] } ); // $ExpectError
-	dispatch( { 'ndarray': [ '5', 5 ] } ); // $ExpectError
-	dispatch( { 'ndarray': ( x: number ): number => x } ); // $ExpectError
-	dispatch( { 'ndarray': [ '5', ( x: string ): string => x ] } ); // $ExpectError
-}
-// The function returns a function which returns a number if provided a number...
-{
-	const t = {
-		'scalar': [ 'number', identity ],
-		'array': [ 'generic', stridedArrayFunction ],
-		'ndarray': [ 'generic', stridedArrayFunctionWithOffsets ]
-	};
-	const abs = dispatch( t ); // $ExpectType DispatchFunction
-	abs( 8 ); // $ExpectType number
-}
-// The function returns a function which returns an array-like object if provided an array-like object...
-{
-	const t = {
-		'scalar': [ 'number', identity ],
-		'array': [ 'generic', stridedArrayFunction ],
-		'ndarray': [ 'generic', stridedArrayFunctionWithOffsets ]
-	};
-	const abs = dispatch( t ); // $ExpectType DispatchFunction
-	const x = new Float64Array( 10 );
-	abs( x ); // $ExpectType ArrayLike<number>
-}
-// The function returns a function which returns an ndarray if provided an ndarray...
-{
-	const t = {
-		'scalar': [ 'number', identity ],
-		'array': [ 'generic', stridedArrayFunction ],
-		'ndarray': [ 'generic', stridedArrayFunctionWithOffsets ]
-	};
-	const abs = dispatch( t ); // $ExpectType DispatchFunction
-	const buf = [ 1, 2, 3, 4 ];
-	const x: ndarray = {
-		'byteLength': null,
-		'BYTES_PER_ELEMENT': null,
-		'data': buf,
-		'dtype': 'generic',
-		'flags': {
-			'ROW_MAJOR_CONTIGUOUS': true,
-			'COLUMN_MAJOR_CONTIGUOUS': false
-		},
-		'length': 4,
-		'ndims': 1,
-		'offset': 0,
-		'order': 'row-major',
-		'shape': [ 4 ],
-		'strides': [ 1 ],
-		'get': ( i: number ): number => {
-			return buf[ i ];
-		},
-		'set': ( i: number, v: number ): ndarray => {
-			buf[ i ] = v;
-			return x;
-		}
-	};
-	abs( x ); // $ExpectType ndarray
-}
-// The function returns a function which does not compile if provided a value other than an ndarray, array-like object, or number...
-{
-	const t = {
-		'scalar': [ 'number', identity ],
-		'array': [ 'generic', stridedArrayFunction ],
-		'ndarray': [ 'generic', stridedArrayFunctionWithOffsets ]
-	};
-	const abs = dispatch( t ); // $ExpectType DispatchFunction
-	abs( '5' ); // $ExpectError
-	abs( true ); // $ExpectError
-	abs( false ); // $ExpectError
-	abs( null ); // $ExpectError
-	abs( undefined ); // $ExpectError
-	abs( {} ); // $ExpectError
-	abs( [ '5' ] ); // $ExpectError
-	abs( ( x: number ): number => x ); // $ExpectError
-}
-// The function returns a function which does not compile if provided insufficient arguments...
-{
-	const t = {
-		'scalar': [ 'number', identity ],
-		'array': [ 'generic', stridedArrayFunction ],
-		'ndarray': [ 'generic', stridedArrayFunctionWithOffsets ]
-	};
-	const abs = dispatch( t ); // $ExpectType DispatchFunction
-	abs(); // $ExpectError
-}