@stdlib/stats-binomial-test 0.0.7 → 0.2.0

package/LICENSE

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

package/NOTICE

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

package/README.md

@@ -18,6 +18,17 @@ limitations under the License.
 
 -->
 
+
+<details>
+  <summary>
+    About stdlib...
+  </summary>
+  <p>We believe in a future in which the web is a preferred environment for numerical computation. To help realize this future, we've built stdlib. stdlib is a standard library, with an emphasis on numerical and scientific computation, written in JavaScript (and C) for execution in browsers and in Node.js.</p>
+  <p>The library is fully decomposable, being architected in such a way that you can swap out and mix and match APIs and functionality to cater to your exact preferences and use cases.</p>
+  <p>When you use stdlib, you can be absolutely certain that you are using the most thorough, rigorous, well-written, studied, documented, tested, measured, and high-quality code out there.</p>
+  <p>To join us in bringing numerical computing to the web, get started by checking us out on <a href="https://github.com/stdlib-js/stdlib">GitHub</a>, and please consider <a href="https://opencollective.com/stdlib">financially supporting stdlib</a>. We greatly appreciate your continued support!</p>
+</details>
+
 # Binomial Test
 
 [![NPM version][npm-image]][npm-url] [![Build Status][test-image]][test-url] [![Coverage Status][coverage-image]][coverage-url] <!-- [![dependencies][dependencies-image]][dependencies-url] -->
@@ -280,7 +291,7 @@ See [LICENSE][stdlib-license].
 
 ## Copyright
 
-Copyright &copy; 2016-2022. The Stdlib [Authors][stdlib-authors].
+Copyright &copy; 2016-2024. The Stdlib [Authors][stdlib-authors].
 
 </section>
 
@@ -293,8 +304,8 @@ Copyright &copy; 2016-2022. The Stdlib [Authors][stdlib-authors].
 [npm-image]: http://img.shields.io/npm/v/@stdlib/stats-binomial-test.svg
 [npm-url]: https://npmjs.org/package/@stdlib/stats-binomial-test
 
-[test-image]: https://github.com/stdlib-js/stats-binomial-test/actions/workflows/test.yml/badge.svg
-[test-url]: https://github.com/stdlib-js/stats-binomial-test/actions/workflows/test.yml
+[test-image]: https://github.com/stdlib-js/stats-binomial-test/actions/workflows/test.yml/badge.svg?branch=v0.2.0
+[test-url]: https://github.com/stdlib-js/stats-binomial-test/actions/workflows/test.yml?query=branch:v0.2.0
 
 [coverage-image]: https://img.shields.io/codecov/c/github/stdlib-js/stats-binomial-test/main.svg
 [coverage-url]: https://codecov.io/github/stdlib-js/stats-binomial-test?branch=main
@@ -306,19 +317,23 @@ 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/stats-binomial-test/tree/deno
+[deno-readme]: https://github.com/stdlib-js/stats-binomial-test/blob/deno/README.md
 [umd-url]: https://github.com/stdlib-js/stats-binomial-test/tree/umd
+[umd-readme]: https://github.com/stdlib-js/stats-binomial-test/blob/umd/README.md
 [esm-url]: https://github.com/stdlib-js/stats-binomial-test/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
+[esm-readme]: https://github.com/stdlib-js/stats-binomial-test/blob/esm/README.md
+[branches-url]: https://github.com/stdlib-js/stats-binomial-test/blob/main/branches.md
 
 [stdlib-license]: https://raw.githubusercontent.com/stdlib-js/stats-binomial-test/main/LICENSE
 

package/SECURITY.md

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

package/dist/index.d.ts

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

package/dist/index.js

@@ -0,0 +1,9 @@
+"use strict";var w=function(e,r){return function(){return r||e((r={exports:{}}).exports,r),r.exports}};var R=w(function($,j){
+var T=require('@stdlib/assert-is-number/dist').isPrimitive,L=require('@stdlib/assert-is-plain-object/dist'),Q=require('@stdlib/assert-is-string/dist').isPrimitive,V=require('@stdlib/assert-is-nan/dist'),q=require('@stdlib/assert-has-own-property/dist'),d=require('@stdlib/error-tools-fmtprodmsg/dist');function S(e,r){return L(r)?q(r,"alpha")&&(e.alpha=r.alpha,!T(e.alpha)||V(e.alpha))?new TypeError(d('1Gx8P',"alpha",e.alpha)):q(r,"alternative")&&(e.alternative=r.alternative,!Q(e.alternative))?new TypeError(d('1Gx2W',"alternative",e.alternative)):q(r,"p")&&(e.p=r.p,!T(e.p)||V(e.p))?new TypeError(d('1Gx8P',"p",e.p)):null:new TypeError(d('1Gx2V',r));}j.exports=S
+});var N=w(function(ee,k){
+var _=require('@stdlib/assert-is-positive-integer/dist'),z=require('@stdlib/assert-is-plain-object/dist'),G=require('@stdlib/assert-is-boolean/dist').isPrimitive,P=require('@stdlib/assert-has-own-property/dist'),g=require('@stdlib/math-base-special-roundn/dist'),E=require('@stdlib/error-tools-fmtprodmsg/dist');function H(e){var r,s,i;if(s=4,r=!0,arguments.length>0){if(!z(e))throw new TypeError(E('1Gx3L',e));if(P(e,"digits")){if(!_(e.digits))throw new TypeError(E('1Gx3P',"digits",e.digits));s=e.digits}if(P(e,"decision")){if(!G(e.decision))throw new TypeError(E('1Gx2o',"decision",e.decision));r=e.decision}}switch(i="",i+=this.method,i+="\n\n",i+="Alternative hypothesis: ",i+="True correlation coefficient is ",this.alternative){case"less":i+="less than ";break;case"greater":i+="greater than ";break;case"two-sided":default:i+="not equal to ";break}return i+=this.nullValue,i+="\n\n",i+="    pValue: "+g(this.pValue,-s)+"\n",i+="    statistic: "+g(this.statistic,-s)+"\n",i+="    "+(1-this.alpha)*100+"% confidence interval: ["+g(this.ci[0],-s)+","+g(this.ci[1],-s)+"]",i+="\n\n",r&&(i+="Test Decision: ",this.rejected?i+="Reject null in favor of alternative at "+this.alpha*100+"% significance level":i+="Fail to reject null in favor of alternative at "+this.alpha*100+"% significance level",i+="\n"),i}k.exports=H
+});var C=w(function(re,B){
+var l=require('@stdlib/utils-define-read-only-property/dist'),J=require('@stdlib/assert-is-number-array/dist'),A=require('@stdlib/assert-is-nonnegative-integer/dist'),D=require('@stdlib/stats-base-dists-beta-quantile/dist'),K=require('@stdlib/math-base-special-floor/dist'),U=require('@stdlib/math-base-special-ceil/dist'),p=require('@stdlib/stats-base-dists-binomial-cdf/dist'),y=require('@stdlib/stats-base-dists-binomial-pmf/dist'),v=require('@stdlib/error-tools-fmtprodmsg/dist'),F=R(),W=N(),x=1+1e-7;function I(e,r,s){return e===0?0:D(s,e,r-e+1)}function M(e,r,s){return e===r?1:D(1-s,e+1,r-e)}function X(){var e,r,s,i,O,h,m,o,b,c,t,n,a,f,u;if(r={},J(arguments[0])){if(a=arguments[0],a.length!==2)throw new Error(v('1Gx9G',a));t=a[1]+a[0],a=a[0],arguments[1]&&(m=F(r,arguments[1]))}else{if(a=arguments[0],t=arguments[1],!A(a))throw new TypeError(v('1Gx9H',a));if(!A(t))throw new TypeError(v('1Gx2K',t));if(a>t)throw new TypeError(v('1Gx9I'));arguments[2]&&(m=F(r,arguments[2]))}if(m)throw m;if(r.alpha===void 0?e=.05:e=r.alpha,e<0||e>1)throw new RangeError(v('1Gx8V',"alpha",e));if(r.p===void 0?n=.5:n=r.p,n<0||n>1)throw new RangeError(v('1Gx9J',"p",n));switch(h=r.alternative||"two-sided",O=a/t,h){case"less":i=p(a,t,n),s=[0,M(a,t,e)];break;case"greater":i=1-p(a-1,t,n),s=[I(a,t,e),1];break;case"two-sided":if(b=y(a,t,n),c=t*n,a===c)i=1;else if(a<c){for(f=0,u=U(c);u<=t;u++)y(u,t,n)<=b*x&&(f+=1);i=p(a,t,n)+(1-p(t-f,t,n))}else{for(f=0,u=0;u<=K(c);u++)y(u,t,n)<=b*x&&(f+=1);i=p(f-1,t,n)+(1-p(a-1,t,n))}s=[I(a,t,e/2),M(a,t,e/2)];break;default:throw new Error(v('1Gx4S',"alternative",["two-sided","less","greater"].join('", "'),h))}return o={},l(o,"rejected",i<=e),l(o,"alpha",e),l(o,"pValue",i),l(o,"statistic",O),l(o,"ci",s),l(o,"nullValue",n),l(o,"alternative",h),l(o,"method","Exact binomial test"),l(o,"print",W),o}B.exports=X
+});var Y=C();module.exports=Y;
+/** @license Apache-2.0 */
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../lib/validate.js", "../lib/print.js", "../lib/main.js", "../lib/index.js"],
+  "sourcesContent": ["/**\n* @license Apache-2.0\n*\n* Copyright (c) 2018 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 isNumber = require( '@stdlib/assert-is-number' ).isPrimitive;\nvar isObject = require( '@stdlib/assert-is-plain-object' );\nvar isString = require( '@stdlib/assert-is-string' ).isPrimitive;\nvar isnan = require( '@stdlib/assert-is-nan' );\nvar hasOwnProp = require( '@stdlib/assert-has-own-property' );\nvar format = require( '@stdlib/string-format' );\n\n\n// MAIN //\n\n/**\n* Validates function options.\n*\n* @private\n* @param {Object} opts - destination for validated options\n* @param {Options} options - function options\n* @param {number} [options.alpha] - significance level\n* @param {string} [options.alternative] - alternative hypothesis (`two-sided`, `less` or `greater`)\n* @param {number} [options.p] - probability under H0\n* @returns {(null|Error)} null or an error\n*/\nfunction validate( opts, options ) {\n\tif ( !isObject( options ) ) {\n\t\treturn new TypeError( format( 'invalid argument. Options argument must be an object. Value: `%s`.', options ) );\n\t}\n\tif ( hasOwnProp( options, 'alpha' ) ) {\n\t\topts.alpha = options.alpha;\n\t\tif ( !isNumber( opts.alpha ) || isnan( opts.alpha ) ) {\n\t\t\treturn new TypeError( format( 'invalid option. `%s` option must be a number. Option: `%s`.', 'alpha', opts.alpha ) );\n\t\t}\n\t}\n\tif ( hasOwnProp( options, 'alternative' ) ) {\n\t\topts.alternative = options.alternative;\n\t\tif ( !isString( opts.alternative ) ) {\n\t\t\treturn new TypeError( format( 'invalid option. `%s` option must be a string. Option: `%s`.', 'alternative', opts.alternative ) );\n\t\t}\n\t}\n\tif ( hasOwnProp( options, 'p' ) ) {\n\t\topts.p = options.p;\n\t\tif ( !isNumber( opts.p ) || isnan( opts.p ) ) {\n\t\t\treturn new TypeError( format( 'invalid option. `%s` option must be a number. Option: `%s`.', 'p', opts.p ) );\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) 2018 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 isPositiveInteger = require( '@stdlib/assert-is-positive-integer' );\nvar isObject = require( '@stdlib/assert-is-plain-object' );\nvar isBoolean = require( '@stdlib/assert-is-boolean' ).isPrimitive;\nvar hasOwnProp = require( '@stdlib/assert-has-own-property' );\nvar roundn = require( '@stdlib/math-base-special-roundn' );\nvar format = require( '@stdlib/string-format' );\n\n\n// MAIN //\n\n/**\n* Pretty-print output of test.\n*\n* @param {Object} [opts] - options object\n* @param {PositiveInteger} [opts.digits=4] - number of digits after the decimal point\n* @param {boolean} [opts.decision=true] - boolean indicating whether to print the test decision\n* @throws {TypeError} options argument must be an object\n* @throws {TypeError} must provide valid options\n* @returns {string} formatted output\n*/\nfunction print( opts ) { // eslint-disable-line stdlib/no-redeclare\n\t/* eslint-disable no-invalid-this */\n\tvar decision;\n\tvar dgts;\n\tvar str;\n\n\tdgts = 4;\n\tdecision = true;\n\tif ( arguments.length > 0 ) {\n\t\tif ( !isObject( opts ) ) {\n\t\t\tthrow new TypeError( format( 'invalid argument. First argument must be an object. Value: `%s`.', opts ) );\n\t\t}\n\t\tif ( hasOwnProp( opts, 'digits' ) ) {\n\t\t\tif ( !isPositiveInteger( opts.digits ) ) {\n\t\t\t\tthrow new TypeError( format( 'invalid option. `%s` option must be a positive integer. Option: `%s`.', 'digits', opts.digits ) );\n\t\t\t}\n\t\t\tdgts = opts.digits;\n\t\t}\n\t\tif ( hasOwnProp( opts, 'decision' ) ) {\n\t\t\tif ( !isBoolean( opts.decision ) ) {\n\t\t\t\tthrow new TypeError( format( 'invalid option. `%s` option must be a boolean. Option: `%s`.', 'decision', opts.decision ) );\n\t\t\t}\n\t\t\tdecision = opts.decision;\n\t\t}\n\t}\n\tstr = '';\n\tstr += this.method;\n\tstr += '\\n\\n';\n\tstr += 'Alternative hypothesis: ';\n\tstr += 'True correlation coefficient is ';\n\tswitch ( this.alternative ) {\n\tcase 'less':\n\t\tstr += 'less than ';\n\t\tbreak;\n\tcase 'greater':\n\t\tstr += 'greater than ';\n\t\tbreak;\n\tcase 'two-sided':\n\tdefault:\n\t\tstr += 'not equal to ';\n\t\tbreak;\n\t}\n\tstr += this.nullValue;\n\tstr += '\\n\\n';\n\tstr += '    pValue: ' + roundn( this.pValue, -dgts ) + '\\n';\n\tstr += '    statistic: ' + roundn( this.statistic, -dgts ) + '\\n';\n\tstr += '    ' + ((1.0-this.alpha)*100) + '% confidence interval: [' +\n\t\troundn( this.ci[0], -dgts ) +\n\t\t',' +\n\t\troundn( this.ci[1], -dgts ) +\n\t']';\n\tstr += '\\n\\n';\n\tif ( decision ) {\n\t\tstr += 'Test Decision: ';\n\t\tif ( this.rejected ) {\n\t\t\tstr += 'Reject null in favor of alternative at ' + (this.alpha*100) + '% significance level';\n\t\t} else {\n\t\t\tstr += 'Fail to reject null in favor of alternative at ' + (this.alpha*100) + '% significance level';\n\t\t}\n\t\tstr += '\\n';\n\t}\n\treturn str;\n}\n\n\n// EXPORTS //\n\nmodule.exports = print;\n", "/**\n* @license Apache-2.0\n*\n* Copyright (c) 2018 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-read-only-property' );\nvar isNumberArray = require( '@stdlib/assert-is-number-array' );\nvar isNonNegativeInteger = require( '@stdlib/assert-is-nonnegative-integer' );\nvar betaQuantile = require( '@stdlib/stats-base-dists-beta-quantile' );\nvar floor = require( '@stdlib/math-base-special-floor' );\nvar ceil = require( '@stdlib/math-base-special-ceil' );\nvar binomialCDF = require( '@stdlib/stats-base-dists-binomial-cdf' );\nvar binomialPMF = require( '@stdlib/stats-base-dists-binomial-pmf' );\nvar format = require( '@stdlib/string-format' );\nvar validate = require( './validate.js' );\nvar print = require( './print.js' ); // eslint-disable-line stdlib/no-redeclare\n\n\n// VARIABLES //\n\nvar RELATIVE_ERROR = 1+1e-07;\n\n\n// FUNCTIONS //\n\n/**\n* Calculates the lower endpoint of a confidence interval.\n*\n* @private\n* @param {NonNegativeInteger} x - number of successes\n* @param {NonNegativeInteger} n - total number of observations\n* @param {number} alpha - significance level\n* @returns {number} lower endpoint\n*/\nfunction lower( x, n, alpha ) {\n\treturn ( x === 0 ) ? 0 : betaQuantile( alpha, x, n - x + 1 );\n}\n\n/**\n* Calculates the upper endpoint of a confidence interval.\n*\n* @private\n* @param {NonNegativeInteger} x - number of successes\n* @param {NonNegativeInteger} n - total number of observations\n* @param {number} alpha - significance level\n* @returns {number} upper endpoint\n*/\nfunction upper( x, n, alpha ) {\n\treturn ( x === n ) ? 1 : betaQuantile( 1 - alpha, x + 1, n - x );\n}\n\n\n// MAIN //\n\n/**\n* Computes an exact test for the success probability in a Bernoulli experiment.\n*\n* @param {(NonNegativeInteger|Array)} x - number of successes or two-element array with successes and failures\n* @param {NonNegativeInteger} [n] - total number of observations\n* @param {Options} [options] - function options\n* @param {number} [options.alpha=0.05] - significance level\n* @param {string} [options.alternative='two-sided'] - alternative hypothesis (`two-sided`, `less` or `greater`)\n* @param {Probability} [options.p=0.5] - success probability under H0\n* @throws {TypeError} options must be an object\n* @throws {TypeError} must provide valid options\n* @throws {RangeError} alpha option has to be a number in the interval `[0,1]`\n* @throws {TypeError} alternative option has to be a string\n* @throws {Error} alternative option must be `two-sided`, `less` or `greater`\n* @returns {Object} test results\n*/\nfunction binomialTest() {\n\tvar alpha;\n\tvar opts;\n\tvar cint;\n\tvar pval;\n\tvar stat;\n\tvar alt;\n\tvar err;\n\tvar out;\n\tvar d;\n\tvar m;\n\tvar n;\n\tvar p;\n\tvar x;\n\tvar y;\n\tvar i;\n\n\topts = {};\n\tif ( isNumberArray( arguments[ 0 ] ) ) {\n\t\tx = arguments[ 0 ];\n\t\tif ( x.length !== 2 ) {\n\t\t\tthrow new Error( format( 'invalid argument. An array argument must contain two elements. Value: `%s`.', x ) );\n\t\t}\n\t\tn = x[ 1 ] + x[ 0 ];\n\t\tx = x[ 0 ];\n\t\tif ( arguments[ 1 ] ) {\n\t\t\terr = validate( opts, arguments[ 1 ] );\n\t\t}\n\t} else {\n\t\tx = arguments[ 0 ];\n\t\tn = arguments[ 1 ];\n\t\tif ( !isNonNegativeInteger( x ) ) {\n\t\t\tthrow new TypeError( format( 'invalid argument. Must provide a nonnegative integer or a two-element array. Value: `%s`.', x ) );\n\t\t}\n\t\tif ( !isNonNegativeInteger( n ) ) {\n\t\t\tthrow new TypeError( format( 'invalid argument. Must provide a nonnegative integer. Value: `%s`.', n ) );\n\t\t}\n\t\tif ( x > n ) {\n\t\t\tthrow new TypeError( format( 'invalid arguments. Number of successes cannot be larger than the total number of observations. x: `%u`. n: `%u`.' ) );\n\t\t}\n\t\tif ( arguments[ 2 ] ) {\n\t\t\terr = validate( opts, arguments[ 2 ] );\n\t\t}\n\t}\n\tif ( err ) {\n\t\tthrow err;\n\t}\n\n\tif ( opts.alpha === void 0 ) {\n\t\talpha = 0.05;\n\t} else {\n\t\talpha = opts.alpha;\n\t}\n\tif ( alpha < 0.0 || alpha > 1.0 ) {\n\t\tthrow new RangeError( format( 'invalid option. `%s` option must be a number on the interval: [0, 1]. Option: `%f`.', 'alpha', alpha ) );\n\t}\n\tif ( opts.p === void 0 ) {\n\t\tp = 0.5;\n\t} else {\n\t\tp = opts.p;\n\t}\n\tif ( p < 0.0 || p > 1.0 ) {\n\t\tthrow new RangeError( format( 'invalid option. `%s` option must be a probability. Option: `%f`.', 'p', p ) );\n\t}\n\n\talt = opts.alternative || 'two-sided';\n\tstat = x / n;\n\tswitch ( alt ) {\n\tcase 'less':\n\t\tpval = binomialCDF( x, n, p );\n\t\tcint = [ 0.0, upper( x, n, alpha ) ];\n\t\tbreak;\n\tcase 'greater':\n\t\tpval = 1.0 - binomialCDF( x - 1, n, p );\n\t\tcint = [ lower( x, n, alpha ), 1.0 ];\n\t\tbreak;\n\tcase 'two-sided':\n\t\td = binomialPMF( x, n, p );\n\t\tm = n * p;\n\t\tif ( x === m ) {\n\t\t\tpval = 1;\n\t\t} else if ( x < m ) {\n\t\t\ty = 0;\n\t\t\tfor ( i = ceil( m ); i <= n; i++ ) {\n\t\t\t\tif ( binomialPMF( i, n, p ) <= d * RELATIVE_ERROR ) {\n\t\t\t\t\ty += 1;\n\t\t\t\t}\n\t\t\t}\n\t\t\tpval = binomialCDF(x, n, p) + ( 1 - binomialCDF(n - y, n, p ) );\n\t\t} else {\n\t\t\ty = 0;\n\t\t\tfor ( i = 0; i <= floor( m ); i++ ) {\n\t\t\t\tif ( binomialPMF( i, n, p ) <= d * RELATIVE_ERROR ) {\n\t\t\t\t\ty += 1;\n\t\t\t\t}\n\t\t\t}\n\t\t\tpval = binomialCDF( y-1, n, p ) + ( 1 - binomialCDF( x-1, n, p ) );\n\t\t}\n\t\tcint = [ lower( x, n, alpha/2.0 ), upper( x, n, alpha/2.0 ) ];\n\t\tbreak;\n\tdefault:\n\t\tthrow new Error( format( 'invalid option. `%s` option must be one of the following: \"%s\". Option: `%s`.', 'alternative', [ 'two-sided', 'less', 'greater' ].join( '\", \"' ), alt ) );\n\t}\n\n\tout = {};\n\tsetReadOnly( out, 'rejected', pval <= alpha );\n\tsetReadOnly( out, 'alpha', alpha );\n\tsetReadOnly( out, 'pValue', pval );\n\tsetReadOnly( out, 'statistic', stat );\n\tsetReadOnly( out, 'ci', cint );\n\tsetReadOnly( out, 'nullValue', p );\n\tsetReadOnly( out, 'alternative', alt );\n\tsetReadOnly( out, 'method', 'Exact binomial test' );\n\tsetReadOnly( out, 'print', print );\n\treturn out;\n}\n\n\n// EXPORTS //\n\nmodule.exports = binomialTest;\n", "/**\n* @license Apache-2.0\n*\n* Copyright (c) 2018 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* Compute an exact test for the success probability in a Bernoulli experiment.\n*\n* @module @stdlib/stats-binomial-test\n*\n* @example\n* var binomialTest = require( '@stdlib/stats-binomial-test' );\n*\n* var out = binomialTest( 682, 925 );\n* // returns {...}\n*\n* out = binomialTest( 682, 925, {\n*     'p': 0.75,\n*     'alpha': 0.05\n* });\n* // returns {...}\n*/\n\n// MODULES //\n\nvar main = require( './main.js' );\n\n\n// EXPORTS //\n\nmodule.exports = main;\n"],
+  "mappings": "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",
+  "names": ["require_validate", "__commonJSMin", "exports", "module", "isNumber", "isObject", "isString", "isnan", "hasOwnProp", "format", "validate", "opts", "options", "require_print", "__commonJSMin", "exports", "module", "isPositiveInteger", "isObject", "isBoolean", "hasOwnProp", "roundn", "format", "print", "opts", "decision", "dgts", "str", "require_main", "__commonJSMin", "exports", "module", "setReadOnly", "isNumberArray", "isNonNegativeInteger", "betaQuantile", "floor", "ceil", "binomialCDF", "binomialPMF", "format", "validate", "print", "RELATIVE_ERROR", "lower", "x", "n", "alpha", "upper", "binomialTest", "opts", "cint", "pval", "stat", "alt", "err", "out", "d", "m", "p", "y", "i", "main"]
+}

package/docs/types/index.d.ts

@@ -16,7 +16,7 @@
 * limitations under the License.
 */
 
-// TypeScript Version: 2.0
+// TypeScript Version: 4.1
 
 /**
 * A [successes, failures] tuple.

package/lib/index.js

@@ -38,9 +38,9 @@
 
 // MODULES //
 
-var binomialTest = require( './main.js' );
+var main = require( './main.js' );
 
 
 // EXPORTS //
 
-module.exports = binomialTest;
+module.exports = main;

package/lib/main.js

@@ -28,6 +28,7 @@ var floor = require( '@stdlib/math-base-special-floor' );
 var ceil = require( '@stdlib/math-base-special-ceil' );
 var binomialCDF = require( '@stdlib/stats-base-dists-binomial-cdf' );
 var binomialPMF = require( '@stdlib/stats-base-dists-binomial-pmf' );
+var format = require( '@stdlib/string-format' );
 var validate = require( './validate.js' );
 var print = require( './print.js' ); // eslint-disable-line stdlib/no-redeclare
 
@@ -77,10 +78,10 @@ function upper( x, n, alpha ) {
 * @param {number} [options.alpha=0.05] - significance level
 * @param {string} [options.alternative='two-sided'] - alternative hypothesis (`two-sided`, `less` or `greater`)
 * @param {Probability} [options.p=0.5] - success probability under H0
-* @throws {TypeError} options has to be simple object
+* @throws {TypeError} options must be an object
 * @throws {TypeError} must provide valid options
 * @throws {RangeError} alpha option has to be a number in the interval `[0,1]`
-* @throws {TypeError} alternative option has to be a string primitive
+* @throws {TypeError} alternative option has to be a string
 * @throws {Error} alternative option must be `two-sided`, `less` or `greater`
 * @returns {Object} test results
 */
@@ -105,7 +106,7 @@ function binomialTest() {
 	if ( isNumberArray( arguments[ 0 ] ) ) {
 		x = arguments[ 0 ];
 		if ( x.length !== 2 ) {
-			throw new Error( 'invalid argument. If provided an array, it must have two elements. Value: `' + x + '`.' );
+			throw new Error( format( 'invalid argument. An array argument must contain two elements. Value: `%s`.', x ) );
 		}
 		n = x[ 1 ] + x[ 0 ];
 		x = x[ 0 ];
@@ -116,13 +117,13 @@ function binomialTest() {
 		x = arguments[ 0 ];
 		n = arguments[ 1 ];
 		if ( !isNonNegativeInteger( x ) ) {
-			throw new TypeError( 'invalid argument. Must provide a nonnegative integer or a two-element array. Value: `' + x + '`.' );
+			throw new TypeError( format( 'invalid argument. Must provide a nonnegative integer or a two-element array. Value: `%s`.', x ) );
 		}
 		if ( !isNonNegativeInteger( n ) ) {
-			throw new TypeError( 'invalid argument. Must provide a nonnegative integer. Value: `' + n + '`.' );
+			throw new TypeError( format( 'invalid argument. Must provide a nonnegative integer. Value: `%s`.', n ) );
 		}
 		if ( x > n ) {
-			throw new TypeError( 'invalid arguments. `x` cannot be larger than `n`. `x:' + x + ', n:' + n + '`.' );
+			throw new TypeError( format( 'invalid arguments. Number of successes cannot be larger than the total number of observations. x: `%u`. n: `%u`.' ) );
 		}
 		if ( arguments[ 2 ] ) {
 			err = validate( opts, arguments[ 2 ] );
@@ -138,7 +139,7 @@ function binomialTest() {
 		alpha = opts.alpha;
 	}
 	if ( alpha < 0.0 || alpha > 1.0 ) {
-		throw new RangeError( 'invalid argument. Option `alpha` must be a number in the range 0 to 1. Value: `' + alpha + '`.' );
+		throw new RangeError( format( 'invalid option. `%s` option must be a number on the interval: [0, 1]. Option: `%f`.', 'alpha', alpha ) );
 	}
 	if ( opts.p === void 0 ) {
 		p = 0.5;
@@ -146,7 +147,7 @@ function binomialTest() {
 		p = opts.p;
 	}
 	if ( p < 0.0 || p > 1.0 ) {
-		throw new RangeError( 'invalid argument. Option `p` must be a probability. Value: `' + p + '`.' );
+		throw new RangeError( format( 'invalid option. `%s` option must be a probability. Option: `%f`.', 'p', p ) );
 	}
 
 	alt = opts.alternative || 'two-sided';
@@ -185,7 +186,7 @@ function binomialTest() {
 		cint = [ lower( x, n, alpha/2.0 ), upper( x, n, alpha/2.0 ) ];
 		break;
 	default:
-		throw new Error( 'Invalid option. `alternative` must be either `two-sided`, `less` or `greater`. Value: `' + alt + '`' );
+		throw new Error( format( 'invalid option. `%s` option must be one of the following: "%s". Option: `%s`.', 'alternative', [ 'two-sided', 'less', 'greater' ].join( '", "' ), alt ) );
 	}
 
 	out = {};

package/lib/print.js

@@ -25,6 +25,7 @@ var isObject = require( '@stdlib/assert-is-plain-object' );
 var isBoolean = require( '@stdlib/assert-is-boolean' ).isPrimitive;
 var hasOwnProp = require( '@stdlib/assert-has-own-property' );
 var roundn = require( '@stdlib/math-base-special-roundn' );
+var format = require( '@stdlib/string-format' );
 
 
 // MAIN //
@@ -49,17 +50,17 @@ function print( opts ) { // eslint-disable-line stdlib/no-redeclare
 	decision = true;
 	if ( arguments.length > 0 ) {
 		if ( !isObject( opts ) ) {
-			throw new TypeError( 'invalid argument. First argument must be an options object. Value: `' + opts + '`.' );
+			throw new TypeError( format( 'invalid argument. First argument must be an object. Value: `%s`.', opts ) );
 		}
 		if ( hasOwnProp( opts, 'digits' ) ) {
 			if ( !isPositiveInteger( opts.digits ) ) {
-				throw new TypeError( 'invalid option. `digits` option must be a positive integer. Option: `' + opts.digits + '`.' );
+				throw new TypeError( format( 'invalid option. `%s` option must be a positive integer. Option: `%s`.', 'digits', opts.digits ) );
 			}
 			dgts = opts.digits;
 		}
 		if ( hasOwnProp( opts, 'decision' ) ) {
 			if ( !isBoolean( opts.decision ) ) {
-				throw new TypeError( 'invalid option. `decision` option must be a boolean primitive. Option: `' + opts.decision + '`.' );
+				throw new TypeError( format( 'invalid option. `%s` option must be a boolean. Option: `%s`.', 'decision', opts.decision ) );
 			}
 			decision = opts.decision;
 		}

package/lib/validate.js

@@ -25,6 +25,7 @@ var isObject = require( '@stdlib/assert-is-plain-object' );
 var isString = require( '@stdlib/assert-is-string' ).isPrimitive;
 var isnan = require( '@stdlib/assert-is-nan' );
 var hasOwnProp = require( '@stdlib/assert-has-own-property' );
+var format = require( '@stdlib/string-format' );
 
 
 // MAIN //
@@ -42,24 +43,24 @@ var hasOwnProp = require( '@stdlib/assert-has-own-property' );
 */
 function validate( opts, options ) {
 	if ( !isObject( options ) ) {
-		return new TypeError( 'invalid argument. Options argument must be an object. Value: `' + options + '`.' );
+		return new TypeError( format( 'invalid argument. Options argument must be an object. Value: `%s`.', options ) );
 	}
 	if ( hasOwnProp( options, 'alpha' ) ) {
 		opts.alpha = options.alpha;
 		if ( !isNumber( opts.alpha ) || isnan( opts.alpha ) ) {
-			return new TypeError( 'invalid option. `alpha` option must be a number primitive. Option: `' + opts.alpha + '`.' );
+			return new TypeError( format( 'invalid option. `%s` option must be a number. Option: `%s`.', 'alpha', opts.alpha ) );
 		}
 	}
 	if ( hasOwnProp( options, 'alternative' ) ) {
 		opts.alternative = options.alternative;
 		if ( !isString( opts.alternative ) ) {
-			return new TypeError( 'invalid option. `alternative` option must be a string primitive. Option: `' + opts.alternative + '`.' );
+			return new TypeError( format( 'invalid option. `%s` option must be a string. Option: `%s`.', 'alternative', opts.alternative ) );
 		}
 	}
 	if ( hasOwnProp( options, 'p' ) ) {
 		opts.p = options.p;
 		if ( !isNumber( opts.p ) || isnan( opts.p ) ) {
-			return new TypeError( 'invalid option. `p` option must be a number primitive. Option: `' + opts.p + '`.' );
+			return new TypeError( format( 'invalid option. `%s` option must be a number. Option: `%s`.', 'p', opts.p ) );
 		}
 	}
 	return null;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@stdlib/stats-binomial-test",
-  "version": "0.0.7",
+  "version": "0.2.0",
   "description": "Exact test for the success probability in a Bernoulli experiment.",
   "license": "Apache-2.0",
   "author": {
@@ -37,33 +37,36 @@
     "url": "https://github.com/stdlib-js/stdlib/issues"
   },
   "dependencies": {
-    "@stdlib/assert-has-own-property": "^0.0.x",
-    "@stdlib/assert-is-boolean": "^0.0.x",
-    "@stdlib/assert-is-nan": "^0.0.x",
-    "@stdlib/assert-is-nonnegative-integer": "^0.0.x",
-    "@stdlib/assert-is-number": "^0.0.x",
-    "@stdlib/assert-is-number-array": "^0.0.x",
-    "@stdlib/assert-is-plain-object": "^0.0.x",
-    "@stdlib/assert-is-positive-integer": "^0.0.x",
-    "@stdlib/assert-is-string": "^0.0.x",
-    "@stdlib/math-base-special-ceil": "^0.0.x",
-    "@stdlib/math-base-special-floor": "^0.0.x",
-    "@stdlib/math-base-special-roundn": "^0.0.x",
-    "@stdlib/stats-base-dists-beta-quantile": "^0.0.x",
-    "@stdlib/stats-base-dists-binomial-cdf": "^0.0.x",
-    "@stdlib/stats-base-dists-binomial-pmf": "^0.0.x",
-    "@stdlib/utils-define-read-only-property": "^0.0.x"
+    "@stdlib/assert-has-own-property": "^0.2.0",
+    "@stdlib/assert-is-boolean": "^0.2.0",
+    "@stdlib/assert-is-nan": "^0.2.0",
+    "@stdlib/assert-is-nonnegative-integer": "^0.2.0",
+    "@stdlib/assert-is-number": "^0.2.0",
+    "@stdlib/assert-is-number-array": "^0.2.0",
+    "@stdlib/assert-is-plain-object": "^0.2.0",
+    "@stdlib/assert-is-positive-integer": "^0.2.0",
+    "@stdlib/assert-is-string": "^0.2.0",
+    "@stdlib/math-base-special-ceil": "^0.2.0",
+    "@stdlib/math-base-special-floor": "^0.2.0",
+    "@stdlib/math-base-special-roundn": "^0.2.0",
+    "@stdlib/stats-base-dists-beta-quantile": "^0.2.0",
+    "@stdlib/stats-base-dists-binomial-cdf": "^0.2.0",
+    "@stdlib/stats-base-dists-binomial-pmf": "^0.2.0",
+    "@stdlib/string-format": "^0.2.0",
+    "@stdlib/utils-define-read-only-property": "^0.2.0",
+    "@stdlib/error-tools-fmtprodmsg": "^0.2.0"
   },
   "devDependencies": {
-    "@stdlib/assert-contains": "^0.0.x",
-    "@stdlib/assert-is-object": "^0.0.x",
-    "@stdlib/bench": "^0.0.x",
-    "@stdlib/constants-float64-eps": "^0.0.x",
-    "@stdlib/math-base-special-abs": "^0.0.x",
-    "@stdlib/random-base-discrete-uniform": "^0.0.x",
+    "@stdlib/assert-contains": "^0.2.0",
+    "@stdlib/assert-is-object": "^0.2.0",
+    "@stdlib/constants-float64-eps": "^0.2.0",
+    "@stdlib/math-base-special-abs": "^0.2.0",
+    "@stdlib/random-base-discrete-uniform": "^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",
+    "@stdlib/bench-harness": "^0.2.0",
+    "@stdlib/bench": "^0.3.1"
   },
   "engines": {
     "node": ">=0.10.0",
@@ -96,7 +99,7 @@
     "probability"
   ],
   "funding": {
-    "type": "patreon",
-    "url": "https://www.patreon.com/athan"
+    "type": "opencollective",
+    "url": "https://opencollective.com/stdlib"
   }
 }

package/docs/repl.txt

@@ -1,92 +0,0 @@
-
-{{alias}}( x[, n][, options] )
-    Computes an exact test for the success probability in a Bernoulli
-    experiment.
-
-    The returned object comes with a `.print()` method which when invoked will
-    print a formatted output of the results of the hypothesis test.
-
-    Parameters
-    ----------
-    x: (number|Array<number>)
-        Number of successes or two-element array with successes and failures.
-
-    n: Array<number> (optional)
-        Total number of observations.
-
-    options: Object (optional)
-        Options.
-
-    options.alpha: number (optional)
-        Number in the interval `[0,1]` giving the significance level of the
-        hypothesis test. Default: `0.05`.
-
-    options.alternative: string (optional)
-        Indicates whether the alternative hypothesis is that the mean of `x` is
-        larger than `mu` (`greater`), smaller than `mu` (`less`) or equal to
-        `mu` (`two-sided`). Default: `'two-sided'`.
-
-    options.p: number (optional)
-        Hypothesized probability under the null hypothesis. Default: `0.5`.
-
-    Returns
-    -------
-    out: Object
-        Test result object.
-
-    out.alpha: number
-        Used significance level.
-
-    out.rejected: boolean
-        Test decision.
-
-    out.pValue: number
-        p-value of the test.
-
-    out.statistic: number
-        Sample proportion.
-
-    out.ci: Array<number>
-        1-alpha confidence interval for the success probability.
-
-    out.nullValue: number
-        Assumed success probability under H0.
-
-    out.alternative: string
-        Alternative hypothesis (`two-sided`, `less` or `greater`).
-
-    out.method: string
-        Name of test.
-
-    out.print: Function
-        Function to print formatted output.
-
-    Examples
-    --------
-    > var out = {{alias}}( 682, 925 )
-    {
-        'pValue': ~3.544e-49,
-        'statistic': ~0.737
-        // ...
-    }
-
-    > out = {{alias}}( [ 682, 925 - 682 ] )
-    {
-        'pValue': ~3.544e-49,
-        'statistic': ~0.737
-        // ...
-    }
-
-    > out = {{alias}}( 21, 40, {
-    ...     'p': 0.4,
-    ...     'alternative': 'greater'
-    ... })
-    {
-        'pValue': ~0.074,
-        'statistic': 0.525
-        // ...
-    }
-
-    See Also
-    --------
-

package/docs/types/test.ts

@@ -1,116 +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.
-*/
-
-import binomialTest = require( './index' );
-
-
-// TESTS //
-
-// The function returns a test result object...
-{
-	binomialTest( 682, 925 ); // $ExpectType Results
-	binomialTest( [ 682, 243 ] ); // $ExpectType Results
-	binomialTest( 682, 925, { 'alpha': 0.1 } ); // $ExpectType Results
-	binomialTest( [ 682, 243 ], { 'p': 0.75 } ); // $ExpectType Results
-}
-
-// The function does not compile if provided a first argument that is neither a number nor a two-element number array...
-{
-	binomialTest( 'abc' ); // $ExpectError
-	binomialTest( true ); // $ExpectError
-	binomialTest( false ); // $ExpectError
-	binomialTest( null ); // $ExpectError
-	binomialTest( undefined ); // $ExpectError
-	binomialTest( {} ); // $ExpectError
-	binomialTest( [] ); // $ExpectError
-	binomialTest( [ 100, 150, 100 ] ); // $ExpectError
-	binomialTest( ( x: number ): number => x ); // $ExpectError
-}
-
-// The function does not compile if provided a first argument that is a number and a second argument that is not a number...
-{
-	binomialTest( 682, 'abc' ); // $ExpectError
-	binomialTest( 682, true ); // $ExpectError
-	binomialTest( 682, false ); // $ExpectError
-	binomialTest( 682, null ); // $ExpectError
-	binomialTest( 682, undefined ); // $ExpectError
-	binomialTest( 682, [] ); // $ExpectError
-	binomialTest( 682, {} ); // $ExpectError
-	binomialTest( 682, ( x: number ): number => x ); // $ExpectError
-}
-
-// The compiler throws an error if the function is provided a last argument which is not an options object...
-{
-	binomialTest( 682, 925, true ); // $ExpectError
-	binomialTest( 682, 925, false ); // $ExpectError
-	binomialTest( 682, 925, null ); // $ExpectError
-	binomialTest( 682, 925, 5 ); // $ExpectError
-	binomialTest( 682, 925, 'abc' ); // $ExpectError
-	binomialTest( 682, 925, [] ); // $ExpectError
-	binomialTest( 682, 925, ( x: number ): number => x ); // $ExpectError
-
-	binomialTest( [ 682, 243 ], true ); // $ExpectError
-	binomialTest( [ 682, 243 ], false ); // $ExpectError
-	binomialTest( [ 682, 243 ], null ); // $ExpectError
-	binomialTest( [ 682, 243 ], 5 ); // $ExpectError
-	binomialTest( [ 682, 243 ], 'abc' ); // $ExpectError
-	binomialTest( [ 682, 243 ], [] ); // $ExpectError
-	binomialTest( [ 682, 243 ], ( x: number ): number => x ); // $ExpectError
-}
-
-// The compiler throws an error if the function is provided a `alpha` option which is not a number...
-{
-	binomialTest( 682, 925, { 'alpha': 'abc' } ); // $ExpectError
-	binomialTest( 682, 925, { 'alpha': '123' } ); // $ExpectError
-	binomialTest( 682, 925, { 'alpha': true } ); // $ExpectError
-	binomialTest( 682, 925, { 'alpha': false } ); // $ExpectError
-	binomialTest( 682, 925, { 'alpha': null } ); // $ExpectError
-	binomialTest( 682, 925, { 'alpha': [] } ); // $ExpectError
-	binomialTest( 682, 925, { 'alpha': {} } ); // $ExpectError
-	binomialTest( 682, 925, { 'alpha': ( x: number ): number => x } ); // $ExpectError
-}
-
-// The compiler throws an error if the function is provided an `alternative` option which is not a recognized alternative...
-{
-	binomialTest( 682, 925, { 'alternative': 'abc' } ); // $ExpectError
-	binomialTest( 682, 925, { 'alternative': 123 } ); // $ExpectError
-	binomialTest( 682, 925, { 'alternative': true } ); // $ExpectError
-	binomialTest( 682, 925, { 'alternative': false } ); // $ExpectError
-	binomialTest( 682, 925, { 'alternative': null } ); // $ExpectError
-	binomialTest( 682, 925, { 'alternative': [] } ); // $ExpectError
-	binomialTest( 682, 925, { 'alternative': {} } ); // $ExpectError
-	binomialTest( 682, 925, { 'alternative': ( x: number ): number => x } ); // $ExpectError
-}
-
-// The compiler throws an error if the function is provided a `p` option which is not a number...
-{
-	binomialTest( 682, 925, { 'p': 'abc' } ); // $ExpectError
-	binomialTest( 682, 925, { 'p': '123' } ); // $ExpectError
-	binomialTest( 682, 925, { 'p': true } ); // $ExpectError
-	binomialTest( 682, 925, { 'p': false } ); // $ExpectError
-	binomialTest( 682, 925, { 'p': null } ); // $ExpectError
-	binomialTest( 682, 925, { 'p': [] } ); // $ExpectError
-	binomialTest( 682, 925, { 'p': {} } ); // $ExpectError
-	binomialTest( 682, 925, { 'p': ( x: number ): number => x } ); // $ExpectError
-}
-
-// The function does not compile if provided an invalid number of arguments...
-{
-	binomialTest(); // $ExpectError
-	binomialTest( 682, 925, {}, {} ); // $ExpectError
-}