@stdlib/ndarray-zeros-like 0.0.1 → 0.1.0

package/CITATION.cff

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

@@ -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-2023 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>
+
 # zerosLike
 
 [![NPM version][npm-image]][npm-url] [![Build Status][test-image]][test-url] [![Coverage Status][coverage-image]][coverage-url] <!-- [![dependencies][dependencies-image]][dependencies-url] -->
@@ -77,6 +88,9 @@ The function supports the following `options`:
 -   **dtype**: output [ndarray][@stdlib/ndarray/ctor] [data type][@stdlib/ndarray/dtypes]. Overrides the input ndarray's inferred [data type][@stdlib/ndarray/dtypes].
 -   **shape**: output [ndarray][@stdlib/ndarray/ctor] shape. Overrides the input ndarray's inferred shape.
 -   **order**: specifies whether the output [ndarray][@stdlib/ndarray/ctor] should be `'row-major'` (C-style) or `'column-major'` (Fortran-style). Overrides the input ndarray's inferred order.
+-   **mode**: specifies how to handle indices which exceed array dimensions (see [`ndarray`][@stdlib/ndarray/ctor]). Default: `'throw'`.
+-   **submode**: a mode array which specifies for each dimension how to handle subscripts which exceed array dimensions  (see [`ndarray`][@stdlib/ndarray/ctor]). If provided fewer modes than dimensions, the constructor recycles modes using modulo arithmetic. Default: `[ options.mode ]`.
+-   **readonly**: `boolean` indicating whether an array should be **read-only**. Default: `false`.
 
 To override either the `dtype`, `shape`, or `order`, specify the corresponding option. For example, to override the inferred [data type][@stdlib/ndarray/dtypes], 
 
@@ -188,7 +202,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>
 
@@ -201,8 +215,8 @@ Copyright &copy; 2016-2022. The Stdlib [Authors][stdlib-authors].
 [npm-image]: http://img.shields.io/npm/v/@stdlib/ndarray-zeros-like.svg
 [npm-url]: https://npmjs.org/package/@stdlib/ndarray-zeros-like
 
-[test-image]: https://github.com/stdlib-js/ndarray-zeros-like/actions/workflows/test.yml/badge.svg
-[test-url]: https://github.com/stdlib-js/ndarray-zeros-like/actions/workflows/test.yml
+[test-image]: https://github.com/stdlib-js/ndarray-zeros-like/actions/workflows/test.yml/badge.svg?branch=v0.1.0
+[test-url]: https://github.com/stdlib-js/ndarray-zeros-like/actions/workflows/test.yml?query=branch:v0.1.0
 
 [coverage-image]: https://img.shields.io/codecov/c/github/stdlib-js/ndarray-zeros-like/main.svg
 [coverage-url]: https://codecov.io/github/stdlib-js/ndarray-zeros-like?branch=main
@@ -214,19 +228,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/ndarray-zeros-like/tree/deno
 [umd-url]: https://github.com/stdlib-js/ndarray-zeros-like/tree/umd
 [esm-url]: https://github.com/stdlib-js/ndarray-zeros-like/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/ndarray-zeros-like/blob/main/branches.md
 
 [stdlib-license]: https://raw.githubusercontent.com/stdlib-js/ndarray-zeros-like/main/LICENSE
 

package/dist/index.d.ts

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

package/dist/index.js

@@ -0,0 +1,5 @@
+"use strict";var l=function(a,e){return function(){return e||a((e={exports:{}}).exports,e),e.exports}};var f=l(function(k,m){
+var y=require('@stdlib/assert-is-ndarray-like/dist'),g=require('@stdlib/assert-is-plain-object/dist'),h=require('@stdlib/assert-is-nonnegative-integer-array/dist').primitives,t=require('@stdlib/assert-has-own-property/dist'),b=require('@stdlib/ndarray-base-shape2strides/dist'),q=require('@stdlib/ndarray-base-strides2offset/dist'),w=require('@stdlib/ndarray-base-buffer/dist'),c=require('@stdlib/ndarray-base-numel/dist'),E=require('@stdlib/ndarray-ctor/dist'),d=require('@stdlib/error-tools-fmtprodmsg/dist');function O(a){var e,i,n,p,s,v,o,u,r;if(!y(a))throw new TypeError(d('0kH5t',a));if(s={},arguments.length>1){if(e=arguments[1],!g(e))throw new TypeError(d('0kH2V',e));if(t(e,"dtype")?i=e.dtype:i=a.dtype,t(e,"shape")){if(r=e.shape,typeof r=="number"&&(r=[r]),!h(r))throw new TypeError(d('0kHDs',"shape",r))}else r=a.shape;t(e,"order")?n=e.order:n=a.order,t(e,"mode")&&(s.mode=e.mode),t(e,"submode")&&(s.submode=e.submode),t(e,"readonly")&&(s.readonly=e.readonly)}else i=a.dtype,r=a.shape,n=a.order;if(p=r.length,p>0?(o=c(r),o<0&&(o=0),u=b(r,n)):(o=1,u=[0]),v=w(i,o),v===null)throw new TypeError(d('0kH5L',i));return new E(i,v,r,u,q(r,u),n,s)}m.exports=O
+});var T=f();module.exports=T;
+/** @license Apache-2.0 */
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../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 isndarrayLike = require( '@stdlib/assert-is-ndarray-like' );\nvar isPlainObject = require( '@stdlib/assert-is-plain-object' );\nvar isNonNegativeIntegerArray = require( '@stdlib/assert-is-nonnegative-integer-array' ).primitives;\nvar hasOwnProp = require( '@stdlib/assert-has-own-property' );\nvar shape2strides = require( '@stdlib/ndarray-base-shape2strides' );\nvar strides2offset = require( '@stdlib/ndarray-base-strides2offset' );\nvar buffer = require( '@stdlib/ndarray-base-buffer' );\nvar numel = require( '@stdlib/ndarray-base-numel' );\nvar ndarray = require( '@stdlib/ndarray-ctor' );\nvar format = require( '@stdlib/string-format' );\n\n\n// MAIN //\n\n/**\n* Creates a zero-filled ndarray having the same shape and data type as a provided ndarray.\n*\n* @param {ndarray} x - input array\n* @param {Options} [options] - function options\n* @param {string} [options.dtype] - output array data type (overrides the input array's inferred data type)\n* @param {string} [options.order] - specifies whether the output array should be 'row-major' (C-style) or 'column-major' (Fortran-style) (overrides the input array's inferred order)\n* @param {(NonNegativeIntegerArray|NonNegativeInteger)} [options.shape] - output array shape (overrides the input array's inferred shape)\n* @param {string} [options.mode=\"throw\"] - specifies how to handle indices which exceed array dimensions\n* @param {StringArray} [options.submode=[\"throw\"]] - specifies how to handle subscripts which exceed array dimensions on a per dimension basis\n* @param {boolean} [options.readonly=false] - boolean indicating whether an array should be read-only\n* @throws {TypeError} first argument must have a recognized data type\n* @throws {TypeError} options argument must be an object\n* @throws {TypeError} `dtype` option must be a supported ndarray data type\n* @throws {TypeError} `order` option must be a supported order\n* @throws {TypeError} `shape` option must be either a nonnegative integer or an array of nonnegative integers\n* @throws {TypeError} must provide valid options\n* @returns {ndarray} ndarray\n*\n* @example\n* var zeros = require( '@stdlib/ndarray-zeros' );\n*\n* var x = zeros( [ 2, 2 ] );\n* // returns <ndarray>\n*\n* var y = zerosLike( x );\n* // returns <ndarray>\n*\n* var sh = y.shape;\n* // returns [ 2, 2 ]\n*\n* var dt = y.dtype;\n* // returns 'float64'\n*/\nfunction zerosLike( x ) {\n\tvar options;\n\tvar dtype;\n\tvar order;\n\tvar ndims;\n\tvar opts;\n\tvar buf;\n\tvar len;\n\tvar st;\n\tvar sh;\n\n\tif ( !isndarrayLike( x ) ) {\n\t\tthrow new TypeError( format( 'invalid argument. First argument must be an ndarray-like object. Value: `%s`.', x ) );\n\t}\n\topts = {};\n\tif ( arguments.length > 1 ) {\n\t\toptions = arguments[ 1 ];\n\t\tif ( !isPlainObject( options ) ) {\n\t\t\tthrow new TypeError( format( 'invalid argument. Options argument must be an object. Value: `%s`.', options ) );\n\t\t}\n\t\tif ( hasOwnProp( options, 'dtype' ) ) {\n\t\t\tdtype = options.dtype;\n\t\t} else {\n\t\t\tdtype = x.dtype;\n\t\t}\n\t\tif ( hasOwnProp( options, 'shape' ) ) {\n\t\t\tsh = options.shape;\n\t\t\tif ( typeof sh === 'number' ) {\n\t\t\t\tsh = [ sh ];\n\t\t\t}\n\t\t\tif ( !isNonNegativeIntegerArray( sh ) ) {\n\t\t\t\tthrow new TypeError( format( 'invalid option. `%s` option must be a nonnegative integer or an array of nonnegative integers. Option: `%s`.', 'shape', sh ) );\n\t\t\t}\n\t\t} else {\n\t\t\tsh = x.shape;\n\t\t}\n\t\tif ( hasOwnProp( options, 'order' ) ) {\n\t\t\torder = options.order;\n\t\t} else {\n\t\t\torder = x.order;\n\t\t}\n\t\tif ( hasOwnProp( options, 'mode' ) ) {\n\t\t\topts.mode = options.mode;\n\t\t}\n\t\tif ( hasOwnProp( options, 'submode' ) ) {\n\t\t\topts.submode = options.submode;\n\t\t}\n\t\tif ( hasOwnProp( options, 'readonly' ) ) {\n\t\t\topts.readonly = options.readonly;\n\t\t}\n\t} else {\n\t\tdtype = x.dtype;\n\t\tsh = x.shape;\n\t\torder = x.order;\n\t}\n\tndims = sh.length;\n\tif ( ndims > 0 ) {\n\t\tlen = numel( sh );\n\t\tif ( len < 0 ) {\n\t\t\tlen = 0; // note: we should only get here if an inferred shape is invalid (i.e., contains negative dimension sizes)\n\t\t}\n\t\tst = shape2strides( sh, order );\n\t} else {\n\t\t// For 0-dimensional arrays, the buffer should contain a single element...\n\t\tlen = 1;\n\t\tst = [ 0 ];\n\t}\n\tbuf = buffer( dtype, len );\n\tif ( buf === null ) {\n\t\tthrow new TypeError( format( 'invalid argument. First argument must have a recognized data type. Value: `%s`.', dtype ) );\n\t}\n\treturn new ndarray( dtype, buf, sh, st, strides2offset( sh, st ), order, opts ); // eslint-disable-line max-len\n}\n\n\n// EXPORTS //\n\nmodule.exports = zerosLike;\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* Create a zero-filled ndarray having the same shape and data type as a provided ndarray.\n*\n* @module @stdlib/ndarray-zeros-like\n*\n* @example\n* var zeros = require( '@stdlib/ndarray-zeros' );\n* var zerosLike = require( '@stdlib/ndarray-zeros-like' );\n*\n* var x = zeros( [ 2, 2 ] );\n* // returns <ndarray>\n*\n* var y = zerosLike( x );\n* // returns <ndarray>\n*\n* var sh = y.shape;\n* // returns [ 2, 2 ]\n*\n* var dt = y.dtype;\n* // returns 'float64'\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,EAAgB,QAAS,gCAAiC,EAC1DC,EAAgB,QAAS,gCAAiC,EAC1DC,EAA4B,QAAS,6CAA8C,EAAE,WACrFC,EAAa,QAAS,iCAAkC,EACxDC,EAAgB,QAAS,oCAAqC,EAC9DC,EAAiB,QAAS,qCAAsC,EAChEC,EAAS,QAAS,6BAA8B,EAChDC,EAAQ,QAAS,4BAA6B,EAC9CC,EAAU,QAAS,sBAAuB,EAC1CC,EAAS,QAAS,uBAAwB,EAuC9C,SAASC,EAAWC,EAAI,CACvB,IAAIC,EACAC,EACAC,EACAC,EACAC,EACAC,EACAC,EACAC,EACAC,EAEJ,GAAK,CAACpB,EAAeW,CAAE,EACtB,MAAM,IAAI,UAAWF,EAAQ,gFAAiFE,CAAE,CAAE,EAGnH,GADAK,EAAO,CAAC,EACH,UAAU,OAAS,EAAI,CAE3B,GADAJ,EAAU,UAAW,CAAE,EAClB,CAACX,EAAeW,CAAQ,EAC5B,MAAM,IAAI,UAAWH,EAAQ,qEAAsEG,CAAQ,CAAE,EAO9G,GALKT,EAAYS,EAAS,OAAQ,EACjCC,EAAQD,EAAQ,MAEhBC,EAAQF,EAAE,MAENR,EAAYS,EAAS,OAAQ,GAKjC,GAJAQ,EAAKR,EAAQ,MACR,OAAOQ,GAAO,WAClBA,EAAK,CAAEA,CAAG,GAEN,CAAClB,EAA2BkB,CAAG,EACnC,MAAM,IAAI,UAAWX,EAAQ,+GAAgH,QAASW,CAAG,CAAE,OAG5JA,EAAKT,EAAE,MAEHR,EAAYS,EAAS,OAAQ,EACjCE,EAAQF,EAAQ,MAEhBE,EAAQH,EAAE,MAENR,EAAYS,EAAS,MAAO,IAChCI,EAAK,KAAOJ,EAAQ,MAEhBT,EAAYS,EAAS,SAAU,IACnCI,EAAK,QAAUJ,EAAQ,SAEnBT,EAAYS,EAAS,UAAW,IACpCI,EAAK,SAAWJ,EAAQ,SAE1B,MACCC,EAAQF,EAAE,MACVS,EAAKT,EAAE,MACPG,EAAQH,EAAE,MAeX,GAbAI,EAAQK,EAAG,OACNL,EAAQ,GACZG,EAAMX,EAAOa,CAAG,EACXF,EAAM,IACVA,EAAM,GAEPC,EAAKf,EAAegB,EAAIN,CAAM,IAG9BI,EAAM,EACNC,EAAK,CAAE,CAAE,GAEVF,EAAMX,EAAQO,EAAOK,CAAI,EACpBD,IAAQ,KACZ,MAAM,IAAI,UAAWR,EAAQ,kFAAmFI,CAAM,CAAE,EAEzH,OAAO,IAAIL,EAASK,EAAOI,EAAKG,EAAID,EAAId,EAAgBe,EAAID,CAAG,EAAGL,EAAOE,CAAK,CAC/E,CAKAjB,EAAO,QAAUW,ICvGjB,IAAIW,EAAO,IAKX,OAAO,QAAUA",
+  "names": ["require_main", "__commonJSMin", "exports", "module", "isndarrayLike", "isPlainObject", "isNonNegativeIntegerArray", "hasOwnProp", "shape2strides", "strides2offset", "buffer", "numel", "ndarray", "format", "zerosLike", "x", "options", "dtype", "order", "ndims", "opts", "buf", "len", "st", "sh", "main"]
+}

package/docs/types/index.d.ts

@@ -18,33 +18,48 @@
 * limitations under the License.
 */
 
-// TypeScript Version: 2.0
+// TypeScript Version: 4.1
 
 /// <reference types="@stdlib/types"/>
 
-import { Shape, Order, ndarray, typedndarray, float64ndarray, float32ndarray, int32ndarray, int16ndarray, int8ndarray, uint32ndarray, uint16ndarray, uint8ndarray, uint8cndarray, complex128ndarray, complex64ndarray, DataType } from '@stdlib/types/ndarray';
+import { Shape, Order, ndarray, typedndarray, float64ndarray, float32ndarray, int32ndarray, int16ndarray, int8ndarray, uint32ndarray, uint16ndarray, uint8ndarray, uint8cndarray, complex128ndarray, complex64ndarray, DataType, Mode } from '@stdlib/types/ndarray';
 
 /**
 * Interface describing function options.
 */
 interface Options {
 	/**
-	* Array order (either 'row-major' (C-style) or 'column-major' (Fortran-style)).
+	* Array shape.
 	*
 	* ## Notes
 	*
-	* -   If provided, this option overrides the input array's inferred order.
+	* -   If provided, this option overrides the input array's inferred shape.
 	*/
-	order?: Order;
+	shape?: Shape | number;
 
 	/**
-	* Array shape.
+	* Array order (either 'row-major' (C-style) or 'column-major' (Fortran-style)).
 	*
 	* ## Notes
 	*
-	* -   If provided, this option overrides the input array's inferred shape.
+	* -   If provided, this option overrides the input array's inferred order.
 	*/
-	shape?: Shape | number;
+	order?: Order;
+
+	/**
+	* Specifies how to handle a linear index which exceeds array dimensions (default: 'throw').
+	*/
+	mode?: Mode;
+
+	/**
+	* Specifies how to handle subscripts which exceed array dimensions on a per dimension basis (default: ['throw']).
+	*/
+	submode?: Array<Mode>;
+
+	/**
+	* Boolean indicating whether an array should be read-only (default: false).
+	*/
+	readonly?: boolean;
 }
 
 /**
@@ -222,6 +237,9 @@ interface OptionsWithDType extends Options {
 * @param options - options
 * @param options.order - specifies whether the output array is 'row-major' (C-style) or 'column-major' (Fortran-style)
 * @param options.shape - output array shape
+* @param options.mode - specifies how to handle a linear index which exceeds array dimensions
+* @param options.submode - specifies how to handle subscripts which exceed array dimensions on a per dimension basis
+* @param options.readonly - boolean indicating whether an array should be read-only
 * @returns zero-filled array
 *
 * @example
@@ -256,6 +274,9 @@ declare function zerosLike( x: float64ndarray, options?: Options ): float64ndarr
 * @param options - options
 * @param options.order - specifies whether the output array is 'row-major' (C-style) or 'column-major' (Fortran-style)
 * @param options.shape - output array shape
+* @param options.mode - specifies how to handle a linear index which exceeds array dimensions
+* @param options.submode - specifies how to handle subscripts which exceed array dimensions on a per dimension basis
+* @param options.readonly - boolean indicating whether an array should be read-only
 * @returns zero-filled array
 *
 * @example
@@ -290,6 +311,9 @@ declare function zerosLike( x: float32ndarray, options?: Options ): float32ndarr
 * @param options - options
 * @param options.order - specifies whether the output array is 'row-major' (C-style) or 'column-major' (Fortran-style)
 * @param options.shape - output array shape
+* @param options.mode - specifies how to handle a linear index which exceeds array dimensions
+* @param options.submode - specifies how to handle subscripts which exceed array dimensions on a per dimension basis
+* @param options.readonly - boolean indicating whether an array should be read-only
 * @returns zero-filled array
 *
 * @example
@@ -324,6 +348,9 @@ declare function zerosLike( x: complex128ndarray, options?: Options ): complex12
 * @param options - options
 * @param options.order - specifies whether the output array is 'row-major' (C-style) or 'column-major' (Fortran-style)
 * @param options.shape - output array shape
+* @param options.mode - specifies how to handle a linear index which exceeds array dimensions
+* @param options.submode - specifies how to handle subscripts which exceed array dimensions on a per dimension basis
+* @param options.readonly - boolean indicating whether an array should be read-only
 * @returns zero-filled array
 *
 * @example
@@ -358,6 +385,9 @@ declare function zerosLike( x: complex64ndarray, options?: Options ): complex64n
 * @param options - options
 * @param options.order - specifies whether the output array is 'row-major' (C-style) or 'column-major' (Fortran-style)
 * @param options.shape - output array shape
+* @param options.mode - specifies how to handle a linear index which exceeds array dimensions
+* @param options.submode - specifies how to handle subscripts which exceed array dimensions on a per dimension basis
+* @param options.readonly - boolean indicating whether an array should be read-only
 * @returns zero-filled array
 *
 * @example
@@ -392,6 +422,9 @@ declare function zerosLike( x: int32ndarray, options?: Options ): int32ndarray;
 * @param options - options
 * @param options.order - specifies whether the output array is 'row-major' (C-style) or 'column-major' (Fortran-style)
 * @param options.shape - output array shape
+* @param options.mode - specifies how to handle a linear index which exceeds array dimensions
+* @param options.submode - specifies how to handle subscripts which exceed array dimensions on a per dimension basis
+* @param options.readonly - boolean indicating whether an array should be read-only
 * @returns zero-filled array
 *
 * @example
@@ -426,6 +459,9 @@ declare function zerosLike( x: int16ndarray, options?: Options ): int16ndarray;
 * @param options - options
 * @param options.order - specifies whether the output array is 'row-major' (C-style) or 'column-major' (Fortran-style)
 * @param options.shape - output array shape
+* @param options.mode - specifies how to handle a linear index which exceeds array dimensions
+* @param options.submode - specifies how to handle subscripts which exceed array dimensions on a per dimension basis
+* @param options.readonly - boolean indicating whether an array should be read-only
 * @returns zero-filled array
 *
 * @example
@@ -460,6 +496,9 @@ declare function zerosLike( x: int8ndarray, options?: Options ): int8ndarray;
 * @param options - options
 * @param options.order - specifies whether the output array is 'row-major' (C-style) or 'column-major' (Fortran-style)
 * @param options.shape - output array shape
+* @param options.mode - specifies how to handle a linear index which exceeds array dimensions
+* @param options.submode - specifies how to handle subscripts which exceed array dimensions on a per dimension basis
+* @param options.readonly - boolean indicating whether an array should be read-only
 * @returns zero-filled array
 *
 * @example
@@ -494,6 +533,9 @@ declare function zerosLike( x: uint32ndarray, options?: Options ): uint32ndarray
 * @param options - options
 * @param options.order - specifies whether the output array is 'row-major' (C-style) or 'column-major' (Fortran-style)
 * @param options.shape - output array shape
+* @param options.mode - specifies how to handle a linear index which exceeds array dimensions
+* @param options.submode - specifies how to handle subscripts which exceed array dimensions on a per dimension basis
+* @param options.readonly - boolean indicating whether an array should be read-only
 * @returns zero-filled array
 *
 * @example
@@ -528,6 +570,9 @@ declare function zerosLike( x: uint16ndarray, options?: Options ): uint16ndarray
 * @param options - options
 * @param options.order - specifies whether the output array is 'row-major' (C-style) or 'column-major' (Fortran-style)
 * @param options.shape - output array shape
+* @param options.mode - specifies how to handle a linear index which exceeds array dimensions
+* @param options.submode - specifies how to handle subscripts which exceed array dimensions on a per dimension basis
+* @param options.readonly - boolean indicating whether an array should be read-only
 * @returns zero-filled array
 *
 * @example
@@ -562,6 +607,9 @@ declare function zerosLike( x: uint8ndarray, options?: Options ): uint8ndarray;
 * @param options - options
 * @param options.order - specifies whether the output array is 'row-major' (C-style) or 'column-major' (Fortran-style)
 * @param options.shape - output array shape
+* @param options.mode - specifies how to handle a linear index which exceeds array dimensions
+* @param options.submode - specifies how to handle subscripts which exceed array dimensions on a per dimension basis
+* @param options.readonly - boolean indicating whether an array should be read-only
 * @returns zero-filled array
 *
 * @example
@@ -597,6 +645,9 @@ declare function zerosLike( x: uint8cndarray, options?: Options ): uint8cndarray
 * @param options.dtype - output array data type
 * @param options.order - specifies whether the output array is 'row-major' (C-style) or 'column-major' (Fortran-style)
 * @param options.shape - output array shape
+* @param options.mode - specifies how to handle a linear index which exceeds array dimensions
+* @param options.submode - specifies how to handle subscripts which exceed array dimensions on a per dimension basis
+* @param options.readonly - boolean indicating whether an array should be read-only
 * @returns zero-filled array
 *
 * @example
@@ -634,6 +685,9 @@ declare function zerosLike( x: ndarray, options: Float64Options ): float64ndarra
 * @param options.dtype - output array data type
 * @param options.order - specifies whether the output array is 'row-major' (C-style) or 'column-major' (Fortran-style)
 * @param options.shape - output array shape
+* @param options.mode - specifies how to handle a linear index which exceeds array dimensions
+* @param options.submode - specifies how to handle subscripts which exceed array dimensions on a per dimension basis
+* @param options.readonly - boolean indicating whether an array should be read-only
 * @returns zero-filled array
 *
 * @example
@@ -671,6 +725,9 @@ declare function zerosLike( x: ndarray, options: Float32Options ): float32ndarra
 * @param options.dtype - output array data type
 * @param options.order - specifies whether the output array is 'row-major' (C-style) or 'column-major' (Fortran-style)
 * @param options.shape - output array shape
+* @param options.mode - specifies how to handle a linear index which exceeds array dimensions
+* @param options.submode - specifies how to handle subscripts which exceed array dimensions on a per dimension basis
+* @param options.readonly - boolean indicating whether an array should be read-only
 * @returns zero-filled array
 *
 * @example
@@ -708,6 +765,9 @@ declare function zerosLike( x: ndarray, options: Complex128Options ): complex128
 * @param options.dtype - output array data type
 * @param options.order - specifies whether the output array is 'row-major' (C-style) or 'column-major' (Fortran-style)
 * @param options.shape - output array shape
+* @param options.mode - specifies how to handle a linear index which exceeds array dimensions
+* @param options.submode - specifies how to handle subscripts which exceed array dimensions on a per dimension basis
+* @param options.readonly - boolean indicating whether an array should be read-only
 * @returns zero-filled array
 *
 * @example
@@ -745,6 +805,9 @@ declare function zerosLike( x: ndarray, options: Complex64Options ): complex64nd
 * @param options.dtype - output array data type
 * @param options.order - specifies whether the output array is 'row-major' (C-style) or 'column-major' (Fortran-style)
 * @param options.shape - output array shape
+* @param options.mode - specifies how to handle a linear index which exceeds array dimensions
+* @param options.submode - specifies how to handle subscripts which exceed array dimensions on a per dimension basis
+* @param options.readonly - boolean indicating whether an array should be read-only
 * @returns zero-filled array
 *
 * @example
@@ -782,6 +845,9 @@ declare function zerosLike( x: ndarray, options: Int32Options ): int32ndarray;
 * @param options.dtype - output array data type
 * @param options.order - specifies whether the output array is 'row-major' (C-style) or 'column-major' (Fortran-style)
 * @param options.shape - output array shape
+* @param options.mode - specifies how to handle a linear index which exceeds array dimensions
+* @param options.submode - specifies how to handle subscripts which exceed array dimensions on a per dimension basis
+* @param options.readonly - boolean indicating whether an array should be read-only
 * @returns zero-filled array
 *
 * @example
@@ -819,6 +885,9 @@ declare function zerosLike( x: ndarray, options: Int16Options ): int16ndarray;
 * @param options.dtype - output array data type
 * @param options.order - specifies whether the output array is 'row-major' (C-style) or 'column-major' (Fortran-style)
 * @param options.shape - output array shape
+* @param options.mode - specifies how to handle a linear index which exceeds array dimensions
+* @param options.submode - specifies how to handle subscripts which exceed array dimensions on a per dimension basis
+* @param options.readonly - boolean indicating whether an array should be read-only
 * @returns zero-filled array
 *
 * @example
@@ -856,6 +925,9 @@ declare function zerosLike( x: ndarray, options: Int8Options ): int8ndarray;
 * @param options.dtype - output array data type
 * @param options.order - specifies whether the output array is 'row-major' (C-style) or 'column-major' (Fortran-style)
 * @param options.shape - output array shape
+* @param options.mode - specifies how to handle a linear index which exceeds array dimensions
+* @param options.submode - specifies how to handle subscripts which exceed array dimensions on a per dimension basis
+* @param options.readonly - boolean indicating whether an array should be read-only
 * @returns zero-filled array
 *
 * @example
@@ -893,6 +965,9 @@ declare function zerosLike( x: ndarray, options: Uint32Options ): uint32ndarray;
 * @param options.dtype - output array data type
 * @param options.order - specifies whether the output array is 'row-major' (C-style) or 'column-major' (Fortran-style)
 * @param options.shape - output array shape
+* @param options.mode - specifies how to handle a linear index which exceeds array dimensions
+* @param options.submode - specifies how to handle subscripts which exceed array dimensions on a per dimension basis
+* @param options.readonly - boolean indicating whether an array should be read-only
 * @returns zero-filled array
 *
 * @example
@@ -930,6 +1005,9 @@ declare function zerosLike( x: ndarray, options: Uint16Options ): uint16ndarray;
 * @param options.dtype - output array data type
 * @param options.order - specifies whether the output array is 'row-major' (C-style) or 'column-major' (Fortran-style)
 * @param options.shape - output array shape
+* @param options.mode - specifies how to handle a linear index which exceeds array dimensions
+* @param options.submode - specifies how to handle subscripts which exceed array dimensions on a per dimension basis
+* @param options.readonly - boolean indicating whether an array should be read-only
 * @returns zero-filled array
 *
 * @example
@@ -967,6 +1045,9 @@ declare function zerosLike( x: ndarray, options: Uint8Options ): uint8ndarray;
 * @param options.dtype - output array data type
 * @param options.order - specifies whether the output array is 'row-major' (C-style) or 'column-major' (Fortran-style)
 * @param options.shape - output array shape
+* @param options.mode - specifies how to handle a linear index which exceeds array dimensions
+* @param options.submode - specifies how to handle subscripts which exceed array dimensions on a per dimension basis
+* @param options.readonly - boolean indicating whether an array should be read-only
 * @returns zero-filled array
 *
 * @example
@@ -1004,6 +1085,9 @@ declare function zerosLike( x: ndarray, options: Uint8COptions ): uint8cndarray;
 * @param options.dtype - output array data type
 * @param options.order - specifies whether the output array is 'row-major' (C-style) or 'column-major' (Fortran-style)
 * @param options.shape - output array shape
+* @param options.mode - specifies how to handle a linear index which exceeds array dimensions
+* @param options.submode - specifies how to handle subscripts which exceed array dimensions on a per dimension basis
+* @param options.readonly - boolean indicating whether an array should be read-only
 * @returns zero-filled array
 *
 * @example

package/lib/main.js

@@ -29,6 +29,7 @@ var strides2offset = require( '@stdlib/ndarray-base-strides2offset' );
 var buffer = require( '@stdlib/ndarray-base-buffer' );
 var numel = require( '@stdlib/ndarray-base-numel' );
 var ndarray = require( '@stdlib/ndarray-ctor' );
+var format = require( '@stdlib/string-format' );
 
 
 // MAIN //
@@ -41,11 +42,15 @@ var ndarray = require( '@stdlib/ndarray-ctor' );
 * @param {string} [options.dtype] - output array data type (overrides the input array's inferred data type)
 * @param {string} [options.order] - specifies whether the output array should be 'row-major' (C-style) or 'column-major' (Fortran-style) (overrides the input array's inferred order)
 * @param {(NonNegativeIntegerArray|NonNegativeInteger)} [options.shape] - output array shape (overrides the input array's inferred shape)
+* @param {string} [options.mode="throw"] - specifies how to handle indices which exceed array dimensions
+* @param {StringArray} [options.submode=["throw"]] - specifies how to handle subscripts which exceed array dimensions on a per dimension basis
+* @param {boolean} [options.readonly=false] - boolean indicating whether an array should be read-only
 * @throws {TypeError} first argument must have a recognized data type
 * @throws {TypeError} options argument must be an object
 * @throws {TypeError} `dtype` option must be a supported ndarray data type
 * @throws {TypeError} `order` option must be a supported order
 * @throws {TypeError} `shape` option must be either a nonnegative integer or an array of nonnegative integers
+* @throws {TypeError} must provide valid options
 * @returns {ndarray} ndarray
 *
 * @example
@@ -65,64 +70,76 @@ var ndarray = require( '@stdlib/ndarray-ctor' );
 */
 function zerosLike( x ) {
 	var options;
+	var dtype;
+	var order;
 	var ndims;
 	var opts;
 	var buf;
 	var len;
 	var st;
+	var sh;
 
 	if ( !isndarrayLike( x ) ) {
-		throw new TypeError( 'invalid argument. First argument must be an ndarray-like object. Value: `' + x + '`.' );
+		throw new TypeError( format( 'invalid argument. First argument must be an ndarray-like object. Value: `%s`.', x ) );
 	}
 	opts = {};
 	if ( arguments.length > 1 ) {
 		options = arguments[ 1 ];
 		if ( !isPlainObject( options ) ) {
-			throw new TypeError( 'invalid argument. Options argument must be an object. Value: `' + options + '`.' );
+			throw new TypeError( format( 'invalid argument. Options argument must be an object. Value: `%s`.', options ) );
 		}
 		if ( hasOwnProp( options, 'dtype' ) ) {
-			opts.dtype = options.dtype;
+			dtype = options.dtype;
 		} else {
-			opts.dtype = x.dtype;
+			dtype = x.dtype;
 		}
 		if ( hasOwnProp( options, 'shape' ) ) {
-			opts.shape = options.shape;
-			if ( typeof opts.shape === 'number' ) {
-				opts.shape = [ opts.shape ];
+			sh = options.shape;
+			if ( typeof sh === 'number' ) {
+				sh = [ sh ];
 			}
-			if ( !isNonNegativeIntegerArray( opts.shape ) ) {
-				throw new TypeError( 'invalid option. `shape` option must either be a nonnegative integer or an array of nonnegative integers. Option: `' + opts.shape + '`.' );
+			if ( !isNonNegativeIntegerArray( sh ) ) {
+				throw new TypeError( format( 'invalid option. `%s` option must be a nonnegative integer or an array of nonnegative integers. Option: `%s`.', 'shape', sh ) );
 			}
 		} else {
-			opts.shape = x.shape;
+			sh = x.shape;
 		}
 		if ( hasOwnProp( options, 'order' ) ) {
-			opts.order = options.order;
+			order = options.order;
 		} else {
-			opts.order = x.order;
+			order = x.order;
+		}
+		if ( hasOwnProp( options, 'mode' ) ) {
+			opts.mode = options.mode;
+		}
+		if ( hasOwnProp( options, 'submode' ) ) {
+			opts.submode = options.submode;
+		}
+		if ( hasOwnProp( options, 'readonly' ) ) {
+			opts.readonly = options.readonly;
 		}
 	} else {
-		opts.dtype = x.dtype;
-		opts.shape = x.shape;
-		opts.order = x.order;
+		dtype = x.dtype;
+		sh = x.shape;
+		order = x.order;
 	}
-	ndims = opts.shape.length;
+	ndims = sh.length;
 	if ( ndims > 0 ) {
-		len = numel( opts.shape );
+		len = numel( sh );
 		if ( len < 0 ) {
 			len = 0; // note: we should only get here if an inferred shape is invalid (i.e., contains negative dimension sizes)
 		}
-		st = shape2strides( opts.shape, opts.order );
+		st = shape2strides( sh, order );
 	} else {
 		// For 0-dimensional arrays, the buffer should contain a single element...
 		len = 1;
 		st = [ 0 ];
 	}
-	buf = buffer( opts.dtype, len );
+	buf = buffer( dtype, len );
 	if ( buf === null ) {
-		throw new TypeError( 'invalid argument. First argument must have a recognized data type. Value: `' + opts.dtype + '`.' );
+		throw new TypeError( format( 'invalid argument. First argument must have a recognized data type. Value: `%s`.', dtype ) );
 	}
-	return new ndarray( opts.dtype, buf, opts.shape, st, strides2offset( opts.shape, st ), opts.order ); // eslint-disable-line max-len
+	return new ndarray( dtype, buf, sh, st, strides2offset( sh, st ), order, opts ); // eslint-disable-line max-len
 }
 
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@stdlib/ndarray-zeros-like",
-  "version": "0.0.1",
+  "version": "0.1.0",
   "description": "Create a zero-filled ndarray having the same shape and data type as a provided ndarray.",
   "license": "Apache-2.0",
   "author": {
@@ -37,40 +37,42 @@
     "url": "https://github.com/stdlib-js/stdlib/issues"
   },
   "dependencies": {
-    "@stdlib/assert-has-own-property": "^0.0.x",
-    "@stdlib/assert-is-ndarray-like": "^0.0.x",
-    "@stdlib/assert-is-nonnegative-integer-array": "^0.0.x",
-    "@stdlib/assert-is-plain-object": "^0.0.x",
-    "@stdlib/ndarray-base-buffer": "^0.0.x",
-    "@stdlib/ndarray-base-numel": "^0.0.x",
-    "@stdlib/ndarray-base-shape2strides": "^0.0.x",
-    "@stdlib/ndarray-base-strides2offset": "^0.0.x",
-    "@stdlib/ndarray-ctor": "^0.0.x",
-    "@stdlib/types": "^0.0.x"
+    "@stdlib/assert-has-own-property": "^0.1.0",
+    "@stdlib/assert-is-ndarray-like": "^0.1.0",
+    "@stdlib/assert-is-nonnegative-integer-array": "^0.1.0",
+    "@stdlib/assert-is-plain-object": "^0.1.0",
+    "@stdlib/ndarray-base-buffer": "^0.1.0",
+    "@stdlib/ndarray-base-numel": "^0.1.0",
+    "@stdlib/ndarray-base-shape2strides": "^0.1.0",
+    "@stdlib/ndarray-base-strides2offset": "^0.1.0",
+    "@stdlib/ndarray-ctor": "^0.1.0",
+    "@stdlib/string-format": "^0.1.0",
+    "@stdlib/types": "^0.1.0",
+    "@stdlib/error-tools-fmtprodmsg": "^0.1.0"
   },
   "devDependencies": {
-    "@stdlib/array-complex128": "^0.0.x",
-    "@stdlib/array-complex64": "^0.0.x",
-    "@stdlib/array-float32": "^0.0.x",
-    "@stdlib/array-float64": "^0.0.x",
-    "@stdlib/array-int16": "^0.0.x",
-    "@stdlib/array-int32": "^0.0.x",
-    "@stdlib/array-int8": "^0.0.x",
-    "@stdlib/array-uint16": "^0.0.x",
-    "@stdlib/array-uint32": "^0.0.x",
-    "@stdlib/array-uint8": "^0.0.x",
-    "@stdlib/array-uint8c": "^0.0.x",
-    "@stdlib/assert-instance-of": "^0.0.x",
-    "@stdlib/bench": "^0.0.x",
-    "@stdlib/math-base-special-pow": "^0.0.x",
-    "@stdlib/ndarray-base-zeros": "^0.0.x",
-    "@stdlib/ndarray-dtypes": "^0.0.x",
-    "@stdlib/ndarray-zeros": "^0.0.x",
-    "@stdlib/strided-base-reinterpret-complex128": "^0.0.x",
-    "@stdlib/strided-base-reinterpret-complex64": "^0.0.x",
+    "@stdlib/array-complex128": "^0.1.0",
+    "@stdlib/array-complex64": "^0.1.0",
+    "@stdlib/array-float32": "^0.1.0",
+    "@stdlib/array-float64": "^0.1.0",
+    "@stdlib/array-int16": "^0.1.0",
+    "@stdlib/array-int32": "^0.1.0",
+    "@stdlib/array-int8": "^0.1.0",
+    "@stdlib/array-uint16": "^0.1.0",
+    "@stdlib/array-uint32": "^0.1.0",
+    "@stdlib/array-uint8": "^0.1.0",
+    "@stdlib/array-uint8c": "^0.1.0",
+    "@stdlib/assert-instance-of": "^0.1.0",
+    "@stdlib/bench": "^0.1.0",
+    "@stdlib/math-base-special-pow": "^0.1.0",
+    "@stdlib/ndarray-base-zeros": "^0.1.0",
+    "@stdlib/ndarray-dtypes": "^0.1.0",
+    "@stdlib/ndarray-zeros": "^0.1.0",
+    "@stdlib/strided-base-reinterpret-complex128": "^0.1.0",
+    "@stdlib/strided-base-reinterpret-complex64": "^0.1.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"
   },
   "engines": {
     "node": ">=0.10.0",
@@ -101,7 +103,7 @@
     "zeros"
   ],
   "funding": {
-    "type": "patreon",
-    "url": "https://www.patreon.com/athan"
+    "type": "opencollective",
+    "url": "https://opencollective.com/stdlib"
   }
 }

package/docs/repl.txt

@@ -1,53 +0,0 @@
-
-{{alias}}( x[, options] )
-    Returns a zero-filled ndarray having the same shape and data type as a
-    provided input ndarray.
-
-    The function infers the following attributes from the input array:
-
-    - shape: array shape.
-    - dtype: underlying array data type.
-    - order: whether the array order is row-major (C-style) or column-major
-      (Fortran-style).
-
-    Parameters
-    ----------
-    x: ndarray
-        Input array.
-
-    options: Object (optional)
-        Options.
-
-    options.shape: ArrayLikeObject<integer>|integer (optional)
-        Array shape. Overrides the input array's inferred shape.
-
-    options.dtype: string (optional)
-        Array data type. Overrides the input array's inferred data type.
-
-    options.order: string (optional)
-        Array order (either 'row-major' (C-style) or 'column-major' (Fortran-
-        style)). Overrides the input array's inferred order.
-
-    Returns
-    -------
-    out: ndarray
-        Output array.
-
-    Examples
-    --------
-    > var x = {{alias:@stdlib/ndarray/base/zeros}}( 'float64', [ 2, 2 ], 'row-major' )
-    <ndarray>
-    > var sh = x.shape
-    [ 2, 2 ]
-    > var dt = x.dtype
-    'float64'
-    > var y = {{alias}}( x )
-    <ndarray>
-    > sh = y.shape
-    [ 2, 2 ]
-    > dt = y.dtype
-    'float64'
-
-    See Also
-    --------
-

package/docs/types/test.ts

@@ -1,167 +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 zeros = require( '@stdlib/ndarray-base-zeros' );
-import zerosLike = require( './index' );
-
-
-// TESTS //
-
-// The function returns an ndarray...
-{
-	const sh = [ 2, 2 ];
-	const ord = 'row-major';
-
-	zerosLike( zeros( 'float64', sh, ord ) ); // $ExpectType float64ndarray
-	zerosLike( zeros( 'float32', sh, ord ) ); // $ExpectType float32ndarray
-	zerosLike( zeros( 'complex128', sh, ord ) ); // $ExpectType complex128ndarray
-	zerosLike( zeros( 'complex64', sh, ord ) ); // $ExpectType complex64ndarray
-	zerosLike( zeros( 'int32', sh, ord ) ); // $ExpectType int32ndarray
-	zerosLike( zeros( 'int16', sh, ord ) ); // $ExpectType int16ndarray
-	zerosLike( zeros( 'int8', sh, ord ) ); // $ExpectType int8ndarray
-	zerosLike( zeros( 'uint32', sh, ord ) ); // $ExpectType uint32ndarray
-	zerosLike( zeros( 'uint16', sh, ord ) ); // $ExpectType uint16ndarray
-	zerosLike( zeros( 'uint8', sh, ord ) ); // $ExpectType uint8ndarray
-	zerosLike( zeros( 'uint8c', sh, ord ) ); // $ExpectType uint8cndarray
-	zerosLike( zeros( 'generic', sh, ord ) ); // $ExpectType typedndarray<number>
-
-
-	zerosLike( zeros( 'float64', sh, ord ), {} ); // $ExpectType float64ndarray
-	zerosLike( zeros( 'float32', sh, ord ), {} ); // $ExpectType float32ndarray
-	zerosLike( zeros( 'complex128', sh, ord ), {} ); // $ExpectType complex128ndarray
-	zerosLike( zeros( 'complex64', sh, ord ), {} ); // $ExpectType complex64ndarray
-	zerosLike( zeros( 'int32', sh, ord ), {} ); // $ExpectType int32ndarray
-	zerosLike( zeros( 'int16', sh, ord ), {} ); // $ExpectType int16ndarray
-	zerosLike( zeros( 'int8', sh, ord ), {} ); // $ExpectType int8ndarray
-	zerosLike( zeros( 'uint32', sh, ord ), {} ); // $ExpectType uint32ndarray
-	zerosLike( zeros( 'uint16', sh, ord ), {} ); // $ExpectType uint16ndarray
-	zerosLike( zeros( 'uint8', sh, ord ), {} ); // $ExpectType uint8ndarray
-	zerosLike( zeros( 'uint8c', sh, ord ), {} ); // $ExpectType uint8cndarray
-	zerosLike( zeros( 'generic', sh, ord ), {} ); // $ExpectType typedndarray<number>
-
-
-	zerosLike( zeros( 'float64', sh, ord ), { 'shape': [ 2, 2, 2 ] } ); // $ExpectType float64ndarray
-	zerosLike( zeros( 'float32', sh, ord ), { 'shape': [ 2, 2, 2 ] } ); // $ExpectType float32ndarray
-	zerosLike( zeros( 'complex128', sh, ord ), { 'shape': [ 2, 2, 2 ] } ); // $ExpectType complex128ndarray
-	zerosLike( zeros( 'complex64', sh, ord ), { 'shape': [ 2, 2, 2 ] } ); // $ExpectType complex64ndarray
-	zerosLike( zeros( 'int32', sh, ord ), { 'shape': [ 2, 2, 2 ] } ); // $ExpectType int32ndarray
-	zerosLike( zeros( 'int16', sh, ord ), { 'shape': [ 2, 2, 2 ] } ); // $ExpectType int16ndarray
-	zerosLike( zeros( 'int8', sh, ord ), { 'shape': [ 2, 2, 2 ] } ); // $ExpectType int8ndarray
-	zerosLike( zeros( 'uint32', sh, ord ), { 'shape': [ 2, 2, 2 ] } ); // $ExpectType uint32ndarray
-	zerosLike( zeros( 'uint16', sh, ord ), { 'shape': [ 2, 2, 2 ] } ); // $ExpectType uint16ndarray
-	zerosLike( zeros( 'uint8', sh, ord ), { 'shape': [ 2, 2, 2 ] } ); // $ExpectType uint8ndarray
-	zerosLike( zeros( 'uint8c', sh, ord ), { 'shape': [ 2, 2, 2 ] } ); // $ExpectType uint8cndarray
-	zerosLike( zeros( 'generic', sh, ord ), { 'shape': [ 2, 2, 2 ] } ); // $ExpectType typedndarray<number>
-
-
-	zerosLike( zeros( 'float64', sh, ord ), { 'order': 'column-major' } ); // $ExpectType float64ndarray
-	zerosLike( zeros( 'float32', sh, ord ), { 'order': 'column-major' } ); // $ExpectType float32ndarray
-	zerosLike( zeros( 'complex128', sh, ord ), { 'order': 'column-major' } ); // $ExpectType complex128ndarray
-	zerosLike( zeros( 'complex64', sh, ord ), { 'order': 'column-major' } ); // $ExpectType complex64ndarray
-	zerosLike( zeros( 'int32', sh, ord ), { 'order': 'column-major' } ); // $ExpectType int32ndarray
-	zerosLike( zeros( 'int16', sh, ord ), { 'order': 'column-major' } ); // $ExpectType int16ndarray
-	zerosLike( zeros( 'int8', sh, ord ), { 'order': 'column-major' } ); // $ExpectType int8ndarray
-	zerosLike( zeros( 'uint32', sh, ord ), { 'order': 'column-major' } ); // $ExpectType uint32ndarray
-	zerosLike( zeros( 'uint16', sh, ord ), { 'order': 'column-major' } ); // $ExpectType uint16ndarray
-	zerosLike( zeros( 'uint8', sh, ord ), { 'order': 'column-major' } ); // $ExpectType uint8ndarray
-	zerosLike( zeros( 'uint8c', sh, ord ), { 'order': 'column-major' } ); // $ExpectType uint8cndarray
-	zerosLike( zeros( 'generic', sh, ord ), { 'order': 'column-major' } ); // $ExpectType typedndarray<number>
-
-
-	zerosLike( zeros( 'generic', sh, ord ), { 'dtype': 'float64' } ); // $ExpectType float64ndarray
-	zerosLike( zeros( 'generic', sh, ord ), { 'dtype': 'float32' } ); // $ExpectType float32ndarray
-	zerosLike( zeros( 'generic', sh, ord ), { 'dtype': 'complex128' } ); // $ExpectType complex128ndarray
-	zerosLike( zeros( 'generic', sh, ord ), { 'dtype': 'complex64' } ); // $ExpectType complex64ndarray
-	zerosLike( zeros( 'generic', sh, ord ), { 'dtype': 'int32' } ); // $ExpectType int32ndarray
-	zerosLike( zeros( 'generic', sh, ord ), { 'dtype': 'int16' } ); // $ExpectType int16ndarray
-	zerosLike( zeros( 'generic', sh, ord ), { 'dtype': 'int8' } ); // $ExpectType int8ndarray
-	zerosLike( zeros( 'generic', sh, ord ), { 'dtype': 'uint32' } ); // $ExpectType uint32ndarray
-	zerosLike( zeros( 'generic', sh, ord ), { 'dtype': 'uint16' } ); // $ExpectType uint16ndarray
-	zerosLike( zeros( 'generic', sh, ord ), { 'dtype': 'uint8' } ); // $ExpectType uint8ndarray
-	zerosLike( zeros( 'generic', sh, ord ), { 'dtype': 'uint8c' } ); // $ExpectType uint8cndarray
-	zerosLike( zeros( 'generic', sh, ord ), { 'dtype': 'generic' } ); // $ExpectType typedndarray<number>
-}
-
-// The compiler throws an error if the function is provided a first argument is not an ndarray which has a recognized/supported data type...
-{
-	zerosLike( '10' ); // $ExpectError
-	zerosLike( 10 ); // $ExpectError
-	zerosLike( false ); // $ExpectError
-	zerosLike( true ); // $ExpectError
-	zerosLike( null ); // $ExpectError
-	zerosLike( [] ); // $ExpectError
-	zerosLike( {} ); // $ExpectError
-	zerosLike( ( x: number ): number => x ); // $ExpectError
-}
-
-// The compiler throws an error if the function is provided a second argument is not an options object...
-{
-	const x = zeros( 'generic', [ 2, 2 ], 'row-major' );
-
-	zerosLike( x, '10' ); // $ExpectError
-	zerosLike( x, 10 ); // $ExpectError
-	zerosLike( x, false ); // $ExpectError
-	zerosLike( x, true ); // $ExpectError
-	zerosLike( x, [] ); // $ExpectError
-	zerosLike( x, ( x: number ): number => x ); // $ExpectError
-}
-
-// The compiler throws an error if the function is provided a `dtype` option which is not a valid data type...
-{
-	const x = zeros( 'generic', [ 2, 2 ], 'row-major' );
-
-	zerosLike( x, { 'dtype': '10' } ); // $ExpectError
-	zerosLike( x, { 'dtype': 10 } ); // $ExpectError
-	zerosLike( x, { 'dtype': null } ); // $ExpectError
-	zerosLike( x, { 'dtype': false } ); // $ExpectError
-	zerosLike( x, { 'dtype': true } ); // $ExpectError
-	zerosLike( x, { 'dtype': [] } ); // $ExpectError
-	zerosLike( x, { 'dtype': {} } ); // $ExpectError
-	zerosLike( x, { 'dtype': ( x: number ): number => x } ); // $ExpectError
-}
-
-// The compiler throws an error if the function is provided an `order` option which is not a valid order...
-{
-	const x = zeros( 'generic', [ 2, 2 ], 'row-major' );
-
-	zerosLike( x, { 'order': '10' } ); // $ExpectError
-	zerosLike( x, { 'order': 10 } ); // $ExpectError
-	zerosLike( x, { 'order': false } ); // $ExpectError
-	zerosLike( x, { 'order': true } ); // $ExpectError
-	zerosLike( x, { 'order': [] } ); // $ExpectError
-	zerosLike( x, { 'order': {} } ); // $ExpectError
-	zerosLike( x, { 'order': ( x: number ): number => x } ); // $ExpectError
-}
-
-// The compiler throws an error if the function is provided a `shape` option which is not a valid shape...
-{
-	const x = zeros( 'generic', [ 2, 2 ], 'row-major' );
-
-	zerosLike( x, { 'shape': '10' } ); // $ExpectError
-	zerosLike( x, { 'shape': false } ); // $ExpectError
-	zerosLike( x, { 'shape': true } ); // $ExpectError
-	zerosLike( x, { 'shape': [ '5' ] } ); // $ExpectError
-	zerosLike( x, { 'shape': {} } ); // $ExpectError
-	zerosLike( x, { 'shape': ( x: number ): number => x } ); // $ExpectError
-}
-
-// The compiler throws an error if the function is provided an unsupported number of arguments...
-{
-	zerosLike(); // $ExpectError
-	zerosLike( zeros( 'float64', [ 2, 2 ], 'row-major' ), {}, 1 ); // $ExpectError
-}