@stdlib/random-array 0.2.1 → 0.3.0

package/NOTICE

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

package/README.md

@@ -102,6 +102,7 @@ The namespace contains the following:
 -   <span class="signature">[`randu( len[, options] )`][@stdlib/random/array/randu]</span><span class="delimiter">: </span><span class="description">create an array containing uniformly distributed pseudorandom numbers between `0` and `1`.</span>
 -   <span class="signature">[`rayleigh( len, sigma[, options] )`][@stdlib/random/array/rayleigh]</span><span class="delimiter">: </span><span class="description">create an array containing pseudorandom numbers drawn from a Rayleigh distribution.</span>
 -   <span class="signature">[`t( len, v[, options] )`][@stdlib/random/array/t]</span><span class="delimiter">: </span><span class="description">create an array containing pseudorandom numbers drawn from a Student's t-distribution.</span>
+-   <span class="signature">[`tools`][@stdlib/random/array/tools]</span><span class="delimiter">: </span><span class="description">pseudorandom number generator (PRNG) array creation function tools.</span>
 -   <span class="signature">[`triangular( len, a, b, c[, options] )`][@stdlib/random/array/triangular]</span><span class="delimiter">: </span><span class="description">create an array containing pseudorandom numbers drawn from a triangular distribution.</span>
 -   <span class="signature">[`uniform( len, a, b[, options] )`][@stdlib/random/array/uniform]</span><span class="delimiter">: </span><span class="description">create an array containing pseudorandom numbers drawn from a continuous uniform distribution.</span>
 -   <span class="signature">[`weibull( len, k, lambda[, options] )`][@stdlib/random/array/weibull]</span><span class="delimiter">: </span><span class="description">create an array containing pseudorandom numbers drawn from a Weibull distribution.</span>
@@ -118,15 +119,46 @@ The namespace contains the following:
 
 ## Examples
 
-<!-- TODO: better examples -->
-
 <!-- eslint no-undef: "error" -->
 
 ```javascript
-var objectKeys = require( '@stdlib/utils-keys' );
 var ns = require( '@stdlib/random-array' );
 
-console.log( objectKeys( ns ) );
+// Generate arrays with ten random numbers drawn from the respective distributions:
+var out = ns.arcsine( 10, 2.0, 5.0 );
+// returns <Float64Array>
+
+out = ns.weibull( 10, 2.0, 5.0 );
+// returns <Float64Array>
+
+out = ns.laplace( 10, 2.0, 5.0 );
+// returns <Float64Array>
+
+// Factory methods:
+
+// 1. Basic factory usage (no parameters):
+var random = ns.arcsine.factory();
+out = random( 10, 2.0, 5.0 );
+// returns <Float64Array>
+
+// 2. Factory with options (e.g., seed):
+random = ns.arcsine.factory({
+    'seed': 1234
+});
+out = random( 10, 2.0, 5.0 );
+// returns <Float64Array>
+
+// 3. Factory with distribution parameters:
+random = ns.arcsine.factory( 2.0, 5.0 );
+out = random( 10 );
+// returns <Float64Array>
+
+// 4. Factory with both distribution parameters and options:
+random = ns.arcsine.factory( 2.0, 5.0, {
+    'dtype': 'float32'
+});
+out = random( 10 );
+// returns <Float32Array>
 ```
 
 </section>
@@ -167,7 +199,7 @@ See [LICENSE][stdlib-license].
 
 ## Copyright
 
-Copyright &copy; 2016-2024. The Stdlib [Authors][stdlib-authors].
+Copyright &copy; 2016-2026. The Stdlib [Authors][stdlib-authors].
 
 </section>
 
@@ -180,8 +212,8 @@ Copyright &copy; 2016-2024. The Stdlib [Authors][stdlib-authors].
 [npm-image]: http://img.shields.io/npm/v/@stdlib/random-array.svg
 [npm-url]: https://npmjs.org/package/@stdlib/random-array
 
-[test-image]: https://github.com/stdlib-js/random-array/actions/workflows/test.yml/badge.svg?branch=v0.2.1
-[test-url]: https://github.com/stdlib-js/random-array/actions/workflows/test.yml?query=branch:v0.2.1
+[test-image]: https://github.com/stdlib-js/random-array/actions/workflows/test.yml/badge.svg?branch=v0.3.0
+[test-url]: https://github.com/stdlib-js/random-array/actions/workflows/test.yml?query=branch:v0.3.0
 
 [coverage-image]: https://img.shields.io/codecov/c/github/stdlib-js/random-array/main.svg
 [coverage-url]: https://codecov.io/github/stdlib-js/random-array?branch=main
@@ -193,8 +225,8 @@ Copyright &copy; 2016-2024. 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
+[chat-image]: https://img.shields.io/badge/zulip-join_chat-brightgreen.svg
+[chat-url]: https://stdlib.zulipchat.com
 
 [stdlib]: https://github.com/stdlib-js/stdlib
 
@@ -283,6 +315,8 @@ Copyright &copy; 2016-2024. The Stdlib [Authors][stdlib-authors].
 
 [@stdlib/random/array/t]: https://www.npmjs.com/package/@stdlib/random-array-t
 
+[@stdlib/random/array/tools]: https://www.npmjs.com/package/@stdlib/random-array-tools
+
 [@stdlib/random/array/triangular]: https://www.npmjs.com/package/@stdlib/random-array-triangular
 
 [@stdlib/random/array/uniform]: https://www.npmjs.com/package/@stdlib/random-array-uniform

package/dist/index.js

@@ -1,3 +1,3 @@
-"use strict";var r=require('@stdlib/utils-define-read-only-property/dist'),e={};r(e,"arcsine",require('@stdlib/random-array-arcsine/dist'));r(e,"bernoulli",require('@stdlib/random-array-bernoulli/dist'));r(e,"beta",require('@stdlib/random-array-beta/dist'));r(e,"betaprime",require('@stdlib/random-array-betaprime/dist'));r(e,"binomial",require('@stdlib/random-array-binomial/dist'));r(e,"cauchy",require('@stdlib/random-array-cauchy/dist'));r(e,"chi",require('@stdlib/random-array-chi/dist'));r(e,"chisquare",require('@stdlib/random-array-chisquare/dist'));r(e,"cosine",require('@stdlib/random-array-cosine/dist'));r(e,"discreteUniform",require('@stdlib/random-array-discrete-uniform/dist'));r(e,"erlang",require('@stdlib/random-array-erlang/dist'));r(e,"exponential",require('@stdlib/random-array-exponential/dist'));r(e,"f",require('@stdlib/random-array-f/dist'));r(e,"frechet",require('@stdlib/random-array-frechet/dist'));r(e,"gamma",require('@stdlib/random-array-gamma/dist'));r(e,"geometric",require('@stdlib/random-array-geometric/dist'));r(e,"gumbel",require('@stdlib/random-array-gumbel/dist'));r(e,"hypergeometric",require('@stdlib/random-array-hypergeometric/dist'));r(e,"invgamma",require('@stdlib/random-array-invgamma/dist'));r(e,"kumaraswamy",require('@stdlib/random-array-kumaraswamy/dist'));r(e,"laplace",require('@stdlib/random-array-laplace/dist'));r(e,"levy",require('@stdlib/random-array-levy/dist'));r(e,"logistic",require('@stdlib/random-array-logistic/dist'));r(e,"lognormal",require('@stdlib/random-array-lognormal/dist'));r(e,"minstd",require('@stdlib/random-array-minstd/dist'));r(e,"minstdShuffle",require('@stdlib/random-array-minstd-shuffle/dist'));r(e,"mt19937",require('@stdlib/random-array-mt19937/dist'));r(e,"negativeBinomial",require('@stdlib/random-array-negative-binomial/dist'));r(e,"normal",require('@stdlib/random-array-normal/dist'));r(e,"pareto1",require('@stdlib/random-array-pareto-type1/dist'));r(e,"poisson",require('@stdlib/random-array-poisson/dist'));r(e,"randu",require('@stdlib/random-array-randu/dist'));r(e,"rayleigh",require('@stdlib/random-array-rayleigh/dist'));r(e,"t",require('@stdlib/random-array-t/dist'));r(e,"triangular",require('@stdlib/random-array-triangular/dist'));r(e,"uniform",require('@stdlib/random-array-uniform/dist'));r(e,"weibull",require('@stdlib/random-array-weibull/dist'));module.exports=e;
+"use strict";var r=require('@stdlib/utils-define-read-only-property/dist'),e={};r(e,"arcsine",require('@stdlib/random-array-arcsine/dist'));r(e,"bernoulli",require('@stdlib/random-array-bernoulli/dist'));r(e,"beta",require('@stdlib/random-array-beta/dist'));r(e,"betaprime",require('@stdlib/random-array-betaprime/dist'));r(e,"binomial",require('@stdlib/random-array-binomial/dist'));r(e,"cauchy",require('@stdlib/random-array-cauchy/dist'));r(e,"chi",require('@stdlib/random-array-chi/dist'));r(e,"chisquare",require('@stdlib/random-array-chisquare/dist'));r(e,"cosine",require('@stdlib/random-array-cosine/dist'));r(e,"discreteUniform",require('@stdlib/random-array-discrete-uniform/dist'));r(e,"erlang",require('@stdlib/random-array-erlang/dist'));r(e,"exponential",require('@stdlib/random-array-exponential/dist'));r(e,"f",require('@stdlib/random-array-f/dist'));r(e,"frechet",require('@stdlib/random-array-frechet/dist'));r(e,"gamma",require('@stdlib/random-array-gamma/dist'));r(e,"geometric",require('@stdlib/random-array-geometric/dist'));r(e,"gumbel",require('@stdlib/random-array-gumbel/dist'));r(e,"hypergeometric",require('@stdlib/random-array-hypergeometric/dist'));r(e,"invgamma",require('@stdlib/random-array-invgamma/dist'));r(e,"kumaraswamy",require('@stdlib/random-array-kumaraswamy/dist'));r(e,"laplace",require('@stdlib/random-array-laplace/dist'));r(e,"levy",require('@stdlib/random-array-levy/dist'));r(e,"logistic",require('@stdlib/random-array-logistic/dist'));r(e,"lognormal",require('@stdlib/random-array-lognormal/dist'));r(e,"minstd",require('@stdlib/random-array-minstd/dist'));r(e,"minstdShuffle",require('@stdlib/random-array-minstd-shuffle/dist'));r(e,"mt19937",require('@stdlib/random-array-mt19937/dist'));r(e,"negativeBinomial",require('@stdlib/random-array-negative-binomial/dist'));r(e,"normal",require('@stdlib/random-array-normal/dist'));r(e,"pareto1",require('@stdlib/random-array-pareto-type1/dist'));r(e,"poisson",require('@stdlib/random-array-poisson/dist'));r(e,"randu",require('@stdlib/random-array-randu/dist'));r(e,"rayleigh",require('@stdlib/random-array-rayleigh/dist'));r(e,"t",require('@stdlib/random-array-t/dist'));r(e,"tools",require('@stdlib/random-array-tools/dist'));r(e,"triangular",require('@stdlib/random-array-triangular/dist'));r(e,"uniform",require('@stdlib/random-array-uniform/dist'));r(e,"weibull",require('@stdlib/random-array-weibull/dist'));module.exports=e;
 /** @license Apache-2.0 */
 //# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -1,7 +1,7 @@
 {
   "version": 3,
   "sources": ["../lib/index.js"],
-  "sourcesContent": ["/**\n* @license Apache-2.0\n*\n* Copyright (c) 2023 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* When adding modules to the namespace, ensure that they are added in alphabetical order according to module name.\n*/\n\n// MODULES //\n\nvar setReadOnly = require( '@stdlib/utils-define-read-only-property' );\n\n\n// MAIN //\n\n/**\n* Top-level namespace.\n*\n* @namespace ns\n*/\nvar ns = {};\n\n/**\n* @name arcsine\n* @memberof ns\n* @readonly\n* @type {Function}\n* @see {@link module:@stdlib/random/array/arcsine}\n*/\nsetReadOnly( ns, 'arcsine', require( '@stdlib/random-array-arcsine' ) );\n\n/**\n* @name bernoulli\n* @memberof ns\n* @readonly\n* @type {Function}\n* @see {@link module:@stdlib/random/array/bernoulli}\n*/\nsetReadOnly( ns, 'bernoulli', require( '@stdlib/random-array-bernoulli' ) );\n\n/**\n* @name beta\n* @memberof ns\n* @readonly\n* @type {Function}\n* @see {@link module:@stdlib/random/array/beta}\n*/\nsetReadOnly( ns, 'beta', require( '@stdlib/random-array-beta' ) );\n\n/**\n* @name betaprime\n* @memberof ns\n* @readonly\n* @type {Function}\n* @see {@link module:@stdlib/random/array/betaprime}\n*/\nsetReadOnly( ns, 'betaprime', require( '@stdlib/random-array-betaprime' ) );\n\n/**\n* @name binomial\n* @memberof ns\n* @readonly\n* @type {Function}\n* @see {@link module:@stdlib/random/array/binomial}\n*/\nsetReadOnly( ns, 'binomial', require( '@stdlib/random-array-binomial' ) );\n\n/**\n* @name cauchy\n* @memberof ns\n* @readonly\n* @type {Function}\n* @see {@link module:@stdlib/random/array/cauchy}\n*/\nsetReadOnly( ns, 'cauchy', require( '@stdlib/random-array-cauchy' ) );\n\n/**\n* @name chi\n* @memberof ns\n* @readonly\n* @type {Function}\n* @see {@link module:@stdlib/random/array/chi}\n*/\nsetReadOnly( ns, 'chi', require( '@stdlib/random-array-chi' ) );\n\n/**\n* @name chisquare\n* @memberof ns\n* @readonly\n* @type {Function}\n* @see {@link module:@stdlib/random/array/chisquare}\n*/\nsetReadOnly( ns, 'chisquare', require( '@stdlib/random-array-chisquare' ) );\n\n/**\n* @name cosine\n* @memberof ns\n* @readonly\n* @type {Function}\n* @see {@link module:@stdlib/random/array/cosine}\n*/\nsetReadOnly( ns, 'cosine', require( '@stdlib/random-array-cosine' ) );\n\n/**\n* @name discreteUniform\n* @memberof ns\n* @readonly\n* @type {Function}\n* @see {@link module:@stdlib/random/array/discrete-uniform}\n*/\nsetReadOnly( ns, 'discreteUniform', require( '@stdlib/random-array-discrete-uniform' ) );\n\n/**\n* @name erlang\n* @memberof ns\n* @readonly\n* @type {Function}\n* @see {@link module:@stdlib/random/array/erlang}\n*/\nsetReadOnly( ns, 'erlang', require( '@stdlib/random-array-erlang' ) );\n\n/**\n* @name exponential\n* @memberof ns\n* @readonly\n* @type {Function}\n* @see {@link module:@stdlib/random/array/exponential}\n*/\nsetReadOnly( ns, 'exponential', require( '@stdlib/random-array-exponential' ) );\n\n/**\n* @name f\n* @memberof ns\n* @readonly\n* @type {Function}\n* @see {@link module:@stdlib/random/array/f}\n*/\nsetReadOnly( ns, 'f', require( '@stdlib/random-array-f' ) );\n\n/**\n* @name frechet\n* @memberof ns\n* @readonly\n* @type {Function}\n* @see {@link module:@stdlib/random/array/frechet}\n*/\nsetReadOnly( ns, 'frechet', require( '@stdlib/random-array-frechet' ) );\n\n/**\n* @name gamma\n* @memberof ns\n* @readonly\n* @type {Function}\n* @see {@link module:@stdlib/random/array/gamma}\n*/\nsetReadOnly( ns, 'gamma', require( '@stdlib/random-array-gamma' ) );\n\n/**\n* @name geometric\n* @memberof ns\n* @readonly\n* @type {Function}\n* @see {@link module:@stdlib/random/array/geometric}\n*/\nsetReadOnly( ns, 'geometric', require( '@stdlib/random-array-geometric' ) );\n\n/**\n* @name gumbel\n* @memberof ns\n* @readonly\n* @type {Function}\n* @see {@link module:@stdlib/random/array/gumbel}\n*/\nsetReadOnly( ns, 'gumbel', require( '@stdlib/random-array-gumbel' ) );\n\n/**\n* @name hypergeometric\n* @memberof ns\n* @readonly\n* @type {Function}\n* @see {@link module:@stdlib/random/array/hypergeometric}\n*/\nsetReadOnly( ns, 'hypergeometric', require( '@stdlib/random-array-hypergeometric' ) );\n\n/**\n* @name invgamma\n* @memberof ns\n* @readonly\n* @type {Function}\n* @see {@link module:@stdlib/random/array/invgamma}\n*/\nsetReadOnly( ns, 'invgamma', require( '@stdlib/random-array-invgamma' ) );\n\n/**\n* @name kumaraswamy\n* @memberof ns\n* @readonly\n* @type {Function}\n* @see {@link module:@stdlib/random/array/kumaraswamy}\n*/\nsetReadOnly( ns, 'kumaraswamy', require( '@stdlib/random-array-kumaraswamy' ) );\n\n/**\n* @name laplace\n* @memberof ns\n* @readonly\n* @type {Function}\n* @see {@link module:@stdlib/random/array/laplace}\n*/\nsetReadOnly( ns, 'laplace', require( '@stdlib/random-array-laplace' ) );\n\n/**\n* @name levy\n* @memberof ns\n* @readonly\n* @type {Function}\n* @see {@link module:@stdlib/random/array/levy}\n*/\nsetReadOnly( ns, 'levy', require( '@stdlib/random-array-levy' ) );\n\n/**\n* @name logistic\n* @memberof ns\n* @readonly\n* @type {Function}\n* @see {@link module:@stdlib/random/array/logistic}\n*/\nsetReadOnly( ns, 'logistic', require( '@stdlib/random-array-logistic' ) );\n\n/**\n* @name lognormal\n* @memberof ns\n* @readonly\n* @type {Function}\n* @see {@link module:@stdlib/random/array/lognormal}\n*/\nsetReadOnly( ns, 'lognormal', require( '@stdlib/random-array-lognormal' ) );\n\n/**\n* @name minstd\n* @memberof ns\n* @readonly\n* @type {Function}\n* @see {@link module:@stdlib/random/array/minstd}\n*/\nsetReadOnly( ns, 'minstd', require( '@stdlib/random-array-minstd' ) );\n\n/**\n* @name minstdShuffle\n* @memberof ns\n* @readonly\n* @type {Function}\n* @see {@link module:@stdlib/random/array/minstd-shuffle}\n*/\nsetReadOnly( ns, 'minstdShuffle', require( '@stdlib/random-array-minstd-shuffle' ) );\n\n/**\n* @name mt19937\n* @memberof ns\n* @readonly\n* @type {Function}\n* @see {@link module:@stdlib/random/array/mt19937}\n*/\nsetReadOnly( ns, 'mt19937', require( '@stdlib/random-array-mt19937' ) );\n\n/**\n* @name negativeBinomial\n* @memberof ns\n* @readonly\n* @type {Function}\n* @see {@link module:@stdlib/random/array/negative-binomial}\n*/\nsetReadOnly( ns, 'negativeBinomial', require( '@stdlib/random-array-negative-binomial' ) );\n\n/**\n* @name normal\n* @memberof ns\n* @readonly\n* @type {Function}\n* @see {@link module:@stdlib/random/array/normal}\n*/\nsetReadOnly( ns, 'normal', require( '@stdlib/random-array-normal' ) );\n\n/**\n* @name pareto1\n* @memberof ns\n* @readonly\n* @type {Function}\n* @see {@link module:@stdlib/random/array/pareto-type1}\n*/\nsetReadOnly( ns, 'pareto1', require( '@stdlib/random-array-pareto-type1' ) );\n\n/**\n* @name poisson\n* @memberof ns\n* @readonly\n* @type {Function}\n* @see {@link module:@stdlib/random/array/poisson}\n*/\nsetReadOnly( ns, 'poisson', require( '@stdlib/random-array-poisson' ) );\n\n/**\n* @name randu\n* @memberof ns\n* @readonly\n* @type {Function}\n* @see {@link module:@stdlib/random/array/randu}\n*/\nsetReadOnly( ns, 'randu', require( '@stdlib/random-array-randu' ) );\n\n/**\n* @name rayleigh\n* @memberof ns\n* @readonly\n* @type {Function}\n* @see {@link module:@stdlib/random/array/rayleigh}\n*/\nsetReadOnly( ns, 'rayleigh', require( '@stdlib/random-array-rayleigh' ) );\n\n/**\n* @name t\n* @memberof ns\n* @readonly\n* @type {Function}\n* @see {@link module:@stdlib/random/array/t}\n*/\nsetReadOnly( ns, 't', require( '@stdlib/random-array-t' ) );\n\n/**\n* @name triangular\n* @memberof ns\n* @readonly\n* @type {Function}\n* @see {@link module:@stdlib/random/array/triangular}\n*/\nsetReadOnly( ns, 'triangular', require( '@stdlib/random-array-triangular' ) );\n\n/**\n* @name uniform\n* @memberof ns\n* @readonly\n* @type {Function}\n* @see {@link module:@stdlib/random/array/uniform}\n*/\nsetReadOnly( ns, 'uniform', require( '@stdlib/random-array-uniform' ) );\n\n/**\n* @name weibull\n* @memberof ns\n* @readonly\n* @type {Function}\n* @see {@link module:@stdlib/random/array/weibull}\n*/\nsetReadOnly( ns, 'weibull', require( '@stdlib/random-array-weibull' ) );\n\n\n// EXPORTS //\n\nmodule.exports = ns;\n"],
-  "mappings": "aA0BA,IAAIA,EAAc,QAAS,yCAA0C,EAUjEC,EAAK,CAAC,EASVD,EAAaC,EAAI,UAAW,QAAS,8BAA+B,CAAE,EAStED,EAAaC,EAAI,YAAa,QAAS,gCAAiC,CAAE,EAS1ED,EAAaC,EAAI,OAAQ,QAAS,2BAA4B,CAAE,EAShED,EAAaC,EAAI,YAAa,QAAS,gCAAiC,CAAE,EAS1ED,EAAaC,EAAI,WAAY,QAAS,+BAAgC,CAAE,EASxED,EAAaC,EAAI,SAAU,QAAS,6BAA8B,CAAE,EASpED,EAAaC,EAAI,MAAO,QAAS,0BAA2B,CAAE,EAS9DD,EAAaC,EAAI,YAAa,QAAS,gCAAiC,CAAE,EAS1ED,EAAaC,EAAI,SAAU,QAAS,6BAA8B,CAAE,EASpED,EAAaC,EAAI,kBAAmB,QAAS,uCAAwC,CAAE,EASvFD,EAAaC,EAAI,SAAU,QAAS,6BAA8B,CAAE,EASpED,EAAaC,EAAI,cAAe,QAAS,kCAAmC,CAAE,EAS9ED,EAAaC,EAAI,IAAK,QAAS,wBAAyB,CAAE,EAS1DD,EAAaC,EAAI,UAAW,QAAS,8BAA+B,CAAE,EAStED,EAAaC,EAAI,QAAS,QAAS,4BAA6B,CAAE,EASlED,EAAaC,EAAI,YAAa,QAAS,gCAAiC,CAAE,EAS1ED,EAAaC,EAAI,SAAU,QAAS,6BAA8B,CAAE,EASpED,EAAaC,EAAI,iBAAkB,QAAS,qCAAsC,CAAE,EASpFD,EAAaC,EAAI,WAAY,QAAS,+BAAgC,CAAE,EASxED,EAAaC,EAAI,cAAe,QAAS,kCAAmC,CAAE,EAS9ED,EAAaC,EAAI,UAAW,QAAS,8BAA+B,CAAE,EAStED,EAAaC,EAAI,OAAQ,QAAS,2BAA4B,CAAE,EAShED,EAAaC,EAAI,WAAY,QAAS,+BAAgC,CAAE,EASxED,EAAaC,EAAI,YAAa,QAAS,gCAAiC,CAAE,EAS1ED,EAAaC,EAAI,SAAU,QAAS,6BAA8B,CAAE,EASpED,EAAaC,EAAI,gBAAiB,QAAS,qCAAsC,CAAE,EASnFD,EAAaC,EAAI,UAAW,QAAS,8BAA+B,CAAE,EAStED,EAAaC,EAAI,mBAAoB,QAAS,wCAAyC,CAAE,EASzFD,EAAaC,EAAI,SAAU,QAAS,6BAA8B,CAAE,EASpED,EAAaC,EAAI,UAAW,QAAS,mCAAoC,CAAE,EAS3ED,EAAaC,EAAI,UAAW,QAAS,8BAA+B,CAAE,EAStED,EAAaC,EAAI,QAAS,QAAS,4BAA6B,CAAE,EASlED,EAAaC,EAAI,WAAY,QAAS,+BAAgC,CAAE,EASxED,EAAaC,EAAI,IAAK,QAAS,wBAAyB,CAAE,EAS1DD,EAAaC,EAAI,aAAc,QAAS,iCAAkC,CAAE,EAS5ED,EAAaC,EAAI,UAAW,QAAS,8BAA+B,CAAE,EAStED,EAAaC,EAAI,UAAW,QAAS,8BAA+B,CAAE,EAKtE,OAAO,QAAUA",
+  "sourcesContent": ["/**\n* @license Apache-2.0\n*\n* Copyright (c) 2023 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* When adding modules to the namespace, ensure that they are added in alphabetical order according to module name.\n*/\n\n// MODULES //\n\nvar setReadOnly = require( '@stdlib/utils-define-read-only-property' );\n\n\n// MAIN //\n\n/**\n* Top-level namespace.\n*\n* @namespace ns\n*/\nvar ns = {};\n\n/**\n* @name arcsine\n* @memberof ns\n* @readonly\n* @type {Function}\n* @see {@link module:@stdlib/random/array/arcsine}\n*/\nsetReadOnly( ns, 'arcsine', require( '@stdlib/random-array-arcsine' ) );\n\n/**\n* @name bernoulli\n* @memberof ns\n* @readonly\n* @type {Function}\n* @see {@link module:@stdlib/random/array/bernoulli}\n*/\nsetReadOnly( ns, 'bernoulli', require( '@stdlib/random-array-bernoulli' ) );\n\n/**\n* @name beta\n* @memberof ns\n* @readonly\n* @type {Function}\n* @see {@link module:@stdlib/random/array/beta}\n*/\nsetReadOnly( ns, 'beta', require( '@stdlib/random-array-beta' ) );\n\n/**\n* @name betaprime\n* @memberof ns\n* @readonly\n* @type {Function}\n* @see {@link module:@stdlib/random/array/betaprime}\n*/\nsetReadOnly( ns, 'betaprime', require( '@stdlib/random-array-betaprime' ) );\n\n/**\n* @name binomial\n* @memberof ns\n* @readonly\n* @type {Function}\n* @see {@link module:@stdlib/random/array/binomial}\n*/\nsetReadOnly( ns, 'binomial', require( '@stdlib/random-array-binomial' ) );\n\n/**\n* @name cauchy\n* @memberof ns\n* @readonly\n* @type {Function}\n* @see {@link module:@stdlib/random/array/cauchy}\n*/\nsetReadOnly( ns, 'cauchy', require( '@stdlib/random-array-cauchy' ) );\n\n/**\n* @name chi\n* @memberof ns\n* @readonly\n* @type {Function}\n* @see {@link module:@stdlib/random/array/chi}\n*/\nsetReadOnly( ns, 'chi', require( '@stdlib/random-array-chi' ) );\n\n/**\n* @name chisquare\n* @memberof ns\n* @readonly\n* @type {Function}\n* @see {@link module:@stdlib/random/array/chisquare}\n*/\nsetReadOnly( ns, 'chisquare', require( '@stdlib/random-array-chisquare' ) );\n\n/**\n* @name cosine\n* @memberof ns\n* @readonly\n* @type {Function}\n* @see {@link module:@stdlib/random/array/cosine}\n*/\nsetReadOnly( ns, 'cosine', require( '@stdlib/random-array-cosine' ) );\n\n/**\n* @name discreteUniform\n* @memberof ns\n* @readonly\n* @type {Function}\n* @see {@link module:@stdlib/random/array/discrete-uniform}\n*/\nsetReadOnly( ns, 'discreteUniform', require( '@stdlib/random-array-discrete-uniform' ) );\n\n/**\n* @name erlang\n* @memberof ns\n* @readonly\n* @type {Function}\n* @see {@link module:@stdlib/random/array/erlang}\n*/\nsetReadOnly( ns, 'erlang', require( '@stdlib/random-array-erlang' ) );\n\n/**\n* @name exponential\n* @memberof ns\n* @readonly\n* @type {Function}\n* @see {@link module:@stdlib/random/array/exponential}\n*/\nsetReadOnly( ns, 'exponential', require( '@stdlib/random-array-exponential' ) );\n\n/**\n* @name f\n* @memberof ns\n* @readonly\n* @type {Function}\n* @see {@link module:@stdlib/random/array/f}\n*/\nsetReadOnly( ns, 'f', require( '@stdlib/random-array-f' ) );\n\n/**\n* @name frechet\n* @memberof ns\n* @readonly\n* @type {Function}\n* @see {@link module:@stdlib/random/array/frechet}\n*/\nsetReadOnly( ns, 'frechet', require( '@stdlib/random-array-frechet' ) );\n\n/**\n* @name gamma\n* @memberof ns\n* @readonly\n* @type {Function}\n* @see {@link module:@stdlib/random/array/gamma}\n*/\nsetReadOnly( ns, 'gamma', require( '@stdlib/random-array-gamma' ) );\n\n/**\n* @name geometric\n* @memberof ns\n* @readonly\n* @type {Function}\n* @see {@link module:@stdlib/random/array/geometric}\n*/\nsetReadOnly( ns, 'geometric', require( '@stdlib/random-array-geometric' ) );\n\n/**\n* @name gumbel\n* @memberof ns\n* @readonly\n* @type {Function}\n* @see {@link module:@stdlib/random/array/gumbel}\n*/\nsetReadOnly( ns, 'gumbel', require( '@stdlib/random-array-gumbel' ) );\n\n/**\n* @name hypergeometric\n* @memberof ns\n* @readonly\n* @type {Function}\n* @see {@link module:@stdlib/random/array/hypergeometric}\n*/\nsetReadOnly( ns, 'hypergeometric', require( '@stdlib/random-array-hypergeometric' ) );\n\n/**\n* @name invgamma\n* @memberof ns\n* @readonly\n* @type {Function}\n* @see {@link module:@stdlib/random/array/invgamma}\n*/\nsetReadOnly( ns, 'invgamma', require( '@stdlib/random-array-invgamma' ) );\n\n/**\n* @name kumaraswamy\n* @memberof ns\n* @readonly\n* @type {Function}\n* @see {@link module:@stdlib/random/array/kumaraswamy}\n*/\nsetReadOnly( ns, 'kumaraswamy', require( '@stdlib/random-array-kumaraswamy' ) );\n\n/**\n* @name laplace\n* @memberof ns\n* @readonly\n* @type {Function}\n* @see {@link module:@stdlib/random/array/laplace}\n*/\nsetReadOnly( ns, 'laplace', require( '@stdlib/random-array-laplace' ) );\n\n/**\n* @name levy\n* @memberof ns\n* @readonly\n* @type {Function}\n* @see {@link module:@stdlib/random/array/levy}\n*/\nsetReadOnly( ns, 'levy', require( '@stdlib/random-array-levy' ) );\n\n/**\n* @name logistic\n* @memberof ns\n* @readonly\n* @type {Function}\n* @see {@link module:@stdlib/random/array/logistic}\n*/\nsetReadOnly( ns, 'logistic', require( '@stdlib/random-array-logistic' ) );\n\n/**\n* @name lognormal\n* @memberof ns\n* @readonly\n* @type {Function}\n* @see {@link module:@stdlib/random/array/lognormal}\n*/\nsetReadOnly( ns, 'lognormal', require( '@stdlib/random-array-lognormal' ) );\n\n/**\n* @name minstd\n* @memberof ns\n* @readonly\n* @type {Function}\n* @see {@link module:@stdlib/random/array/minstd}\n*/\nsetReadOnly( ns, 'minstd', require( '@stdlib/random-array-minstd' ) );\n\n/**\n* @name minstdShuffle\n* @memberof ns\n* @readonly\n* @type {Function}\n* @see {@link module:@stdlib/random/array/minstd-shuffle}\n*/\nsetReadOnly( ns, 'minstdShuffle', require( '@stdlib/random-array-minstd-shuffle' ) );\n\n/**\n* @name mt19937\n* @memberof ns\n* @readonly\n* @type {Function}\n* @see {@link module:@stdlib/random/array/mt19937}\n*/\nsetReadOnly( ns, 'mt19937', require( '@stdlib/random-array-mt19937' ) );\n\n/**\n* @name negativeBinomial\n* @memberof ns\n* @readonly\n* @type {Function}\n* @see {@link module:@stdlib/random/array/negative-binomial}\n*/\nsetReadOnly( ns, 'negativeBinomial', require( '@stdlib/random-array-negative-binomial' ) );\n\n/**\n* @name normal\n* @memberof ns\n* @readonly\n* @type {Function}\n* @see {@link module:@stdlib/random/array/normal}\n*/\nsetReadOnly( ns, 'normal', require( '@stdlib/random-array-normal' ) );\n\n/**\n* @name pareto1\n* @memberof ns\n* @readonly\n* @type {Function}\n* @see {@link module:@stdlib/random/array/pareto-type1}\n*/\nsetReadOnly( ns, 'pareto1', require( '@stdlib/random-array-pareto-type1' ) );\n\n/**\n* @name poisson\n* @memberof ns\n* @readonly\n* @type {Function}\n* @see {@link module:@stdlib/random/array/poisson}\n*/\nsetReadOnly( ns, 'poisson', require( '@stdlib/random-array-poisson' ) );\n\n/**\n* @name randu\n* @memberof ns\n* @readonly\n* @type {Function}\n* @see {@link module:@stdlib/random/array/randu}\n*/\nsetReadOnly( ns, 'randu', require( '@stdlib/random-array-randu' ) );\n\n/**\n* @name rayleigh\n* @memberof ns\n* @readonly\n* @type {Function}\n* @see {@link module:@stdlib/random/array/rayleigh}\n*/\nsetReadOnly( ns, 'rayleigh', require( '@stdlib/random-array-rayleigh' ) );\n\n/**\n* @name t\n* @memberof ns\n* @readonly\n* @type {Function}\n* @see {@link module:@stdlib/random/array/t}\n*/\nsetReadOnly( ns, 't', require( '@stdlib/random-array-t' ) );\n\n/**\n* @name tools\n* @memberof ns\n* @readonly\n* @type {Namespace}\n* @see {@link module:@stdlib/random/array/tools}\n*/\nsetReadOnly( ns, 'tools', require( '@stdlib/random-array-tools' ) );\n\n/**\n* @name triangular\n* @memberof ns\n* @readonly\n* @type {Function}\n* @see {@link module:@stdlib/random/array/triangular}\n*/\nsetReadOnly( ns, 'triangular', require( '@stdlib/random-array-triangular' ) );\n\n/**\n* @name uniform\n* @memberof ns\n* @readonly\n* @type {Function}\n* @see {@link module:@stdlib/random/array/uniform}\n*/\nsetReadOnly( ns, 'uniform', require( '@stdlib/random-array-uniform' ) );\n\n/**\n* @name weibull\n* @memberof ns\n* @readonly\n* @type {Function}\n* @see {@link module:@stdlib/random/array/weibull}\n*/\nsetReadOnly( ns, 'weibull', require( '@stdlib/random-array-weibull' ) );\n\n\n// EXPORTS //\n\nmodule.exports = ns;\n"],
+  "mappings": "aA0BA,IAAIA,EAAc,QAAS,yCAA0C,EAUjEC,EAAK,CAAC,EASVD,EAAaC,EAAI,UAAW,QAAS,8BAA+B,CAAE,EAStED,EAAaC,EAAI,YAAa,QAAS,gCAAiC,CAAE,EAS1ED,EAAaC,EAAI,OAAQ,QAAS,2BAA4B,CAAE,EAShED,EAAaC,EAAI,YAAa,QAAS,gCAAiC,CAAE,EAS1ED,EAAaC,EAAI,WAAY,QAAS,+BAAgC,CAAE,EASxED,EAAaC,EAAI,SAAU,QAAS,6BAA8B,CAAE,EASpED,EAAaC,EAAI,MAAO,QAAS,0BAA2B,CAAE,EAS9DD,EAAaC,EAAI,YAAa,QAAS,gCAAiC,CAAE,EAS1ED,EAAaC,EAAI,SAAU,QAAS,6BAA8B,CAAE,EASpED,EAAaC,EAAI,kBAAmB,QAAS,uCAAwC,CAAE,EASvFD,EAAaC,EAAI,SAAU,QAAS,6BAA8B,CAAE,EASpED,EAAaC,EAAI,cAAe,QAAS,kCAAmC,CAAE,EAS9ED,EAAaC,EAAI,IAAK,QAAS,wBAAyB,CAAE,EAS1DD,EAAaC,EAAI,UAAW,QAAS,8BAA+B,CAAE,EAStED,EAAaC,EAAI,QAAS,QAAS,4BAA6B,CAAE,EASlED,EAAaC,EAAI,YAAa,QAAS,gCAAiC,CAAE,EAS1ED,EAAaC,EAAI,SAAU,QAAS,6BAA8B,CAAE,EASpED,EAAaC,EAAI,iBAAkB,QAAS,qCAAsC,CAAE,EASpFD,EAAaC,EAAI,WAAY,QAAS,+BAAgC,CAAE,EASxED,EAAaC,EAAI,cAAe,QAAS,kCAAmC,CAAE,EAS9ED,EAAaC,EAAI,UAAW,QAAS,8BAA+B,CAAE,EAStED,EAAaC,EAAI,OAAQ,QAAS,2BAA4B,CAAE,EAShED,EAAaC,EAAI,WAAY,QAAS,+BAAgC,CAAE,EASxED,EAAaC,EAAI,YAAa,QAAS,gCAAiC,CAAE,EAS1ED,EAAaC,EAAI,SAAU,QAAS,6BAA8B,CAAE,EASpED,EAAaC,EAAI,gBAAiB,QAAS,qCAAsC,CAAE,EASnFD,EAAaC,EAAI,UAAW,QAAS,8BAA+B,CAAE,EAStED,EAAaC,EAAI,mBAAoB,QAAS,wCAAyC,CAAE,EASzFD,EAAaC,EAAI,SAAU,QAAS,6BAA8B,CAAE,EASpED,EAAaC,EAAI,UAAW,QAAS,mCAAoC,CAAE,EAS3ED,EAAaC,EAAI,UAAW,QAAS,8BAA+B,CAAE,EAStED,EAAaC,EAAI,QAAS,QAAS,4BAA6B,CAAE,EASlED,EAAaC,EAAI,WAAY,QAAS,+BAAgC,CAAE,EASxED,EAAaC,EAAI,IAAK,QAAS,wBAAyB,CAAE,EAS1DD,EAAaC,EAAI,QAAS,QAAS,4BAA6B,CAAE,EASlED,EAAaC,EAAI,aAAc,QAAS,iCAAkC,CAAE,EAS5ED,EAAaC,EAAI,UAAW,QAAS,8BAA+B,CAAE,EAStED,EAAaC,EAAI,UAAW,QAAS,8BAA+B,CAAE,EAKtE,OAAO,QAAUA",
   "names": ["setReadOnly", "ns"]
 }

package/docs/types/index.d.ts

@@ -54,6 +54,7 @@ import poisson = require( '@stdlib/random-array-poisson' );
 import randu = require( '@stdlib/random-array-randu' );
 import rayleigh = require( '@stdlib/random-array-rayleigh' );
 import t = require( '@stdlib/random-array-t' );
+import tools = require( '@stdlib/random-array-tools' );
 import triangular = require( '@stdlib/random-array-triangular' );
 import uniform = require( '@stdlib/random-array-uniform' );
 import weibull = require( '@stdlib/random-array-weibull' );
@@ -324,7 +325,7 @@ interface Namespace {
 	* // returns <Float64Array>
 	*
 	* @example
-	* var random = ns.f.ns.factory( 2.0, 5.0 );
+	* var random = ns.f.factory( 2.0, 5.0 );
 	*
 	* var out = random( 10 );
 	* // returns <Float64Array>
@@ -774,6 +775,11 @@ interface Namespace {
 	*/
 	t: typeof t;
 
+	/**
+	* Pseudorandom number generator array creation function tools.
+	*/
+	tools: typeof tools;
+
 	/**
 	* Returns an array containing pseudorandom numbers drawn from a triangular distribution.
 	*
@@ -821,8 +827,8 @@ interface Namespace {
 	* Returns an array containing pseudorandom numbers drawn from a Weibull distribution.
 	*
 	* @param len - array length
-	* @param k - scale parameter
-	* @param lambda - shape parameter
+	* @param k - shape parameter
+	* @param lambda - scale parameter
 	* @param options - function options
 	* @returns output array
 	*

package/lib/index.js

@@ -342,6 +342,15 @@ setReadOnly( ns, 'rayleigh', require( '@stdlib/random-array-rayleigh' ) );
 */
 setReadOnly( ns, 't', require( '@stdlib/random-array-t' ) );
 
+/**
+* @name tools
+* @memberof ns
+* @readonly
+* @type {Namespace}
+* @see {@link module:@stdlib/random/array/tools}
+*/
+setReadOnly( ns, 'tools', require( '@stdlib/random-array-tools' ) );
+
 /**
 * @name triangular
 * @memberof ns

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@stdlib/random-array",
-  "version": "0.2.1",
+  "version": "0.3.0",
   "description": "Pseudorandom number generator array creation functions.",
   "license": "Apache-2.0",
   "author": {
@@ -17,6 +17,7 @@
   "directories": {
     "doc": "./docs",
     "lib": "./lib",
+    "scripts": "./scripts",
     "dist": "./dist"
   },
   "types": "./docs/types",
@@ -64,10 +65,11 @@
     "@stdlib/random-array-randu": "^0.2.1",
     "@stdlib/random-array-rayleigh": "^0.2.1",
     "@stdlib/random-array-t": "^0.2.1",
+    "@stdlib/random-array-tools": "^0.3.0",
     "@stdlib/random-array-triangular": "^0.2.1",
     "@stdlib/random-array-uniform": "^0.2.1",
     "@stdlib/random-array-weibull": "^0.2.1",
-    "@stdlib/utils-define-read-only-property": "^0.2.1"
+    "@stdlib/utils-define-read-only-property": "^0.2.2"
   },
   "devDependencies": {},
   "engines": {