Auto-generated commit

.editorconfig

@@ -179,3 +179,8 @@ indent_size = 2
 [*.gypi]
 indent_style = space
 indent_size = 2
+
+# Set properties for citation files:
+[*.{cff,cff.txt}]
+indent_style = space
+indent_size = 2

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

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>
+
 # REPL
 
 [![NPM version][npm-image]][npm-url] [![Build Status][test-image]][test-url] [![Coverage Status][coverage-image]][coverage-url] <!-- [![dependencies][dependencies-image]][dependencies-url] -->

code-blocks/docs/types/index.d.ts

@@ -16,7 +16,7 @@
 * limitations under the License.
 */
 
-// TypeScript Version: 2.0
+// TypeScript Version: 4.1
 
 /**
 * Returns an example associated with a specified alias.

help/docs/types/index.d.ts

@@ -16,7 +16,7 @@
 * limitations under the License.
 */
 
-// TypeScript Version: 2.0
+// TypeScript Version: 4.1
 
 /**
 * Returns help text associated with a specified alias.

info/docs/types/index.d.ts

@@ -16,7 +16,7 @@
 * limitations under the License.
 */
 
-// TypeScript Version: 2.0
+// TypeScript Version: 4.1
 
 /**
 * Returns abbreviated help text associated with a specified alias.

server/docs/types/index.d.ts

@@ -16,7 +16,7 @@
 * limitations under the License.
 */
 
-// TypeScript Version: 2.0
+// TypeScript Version: 4.1
 
 /**
 * Callback invoked after creating a REPL environment.

signature/data/data.csv

@@ -110,7 +110,7 @@ base.cbrt,"base.cbrt( x )"
 base.cbrtf,"base.cbrtf( x )"
 base.cceil,"base.cceil( z )"
 base.cceilf,"base.cceilf( z )"
-base.cceiln,"base.cceiln( [out,] re, im, n )"
+base.cceiln,"base.cceiln( z, n )"
 base.ccis,"base.ccis( z )"
 base.cdiv,"base.cdiv( z1, z2 )"
 base.ceil,"base.ceil( x )"
@@ -124,7 +124,7 @@ base.cexp,"base.cexp( z )"
 base.cflipsign,"base.cflipsign( z, y )"
 base.cflipsignf,"base.cflipsignf( z, y )"
 base.cfloor,"base.cfloor( z )"
-base.cfloorn,"base.cfloorn( [out,] re, im, n )"
+base.cfloorn,"base.cfloorn( z, n )"
 base.cidentity,"base.cidentity( z )"
 base.cidentityf,"base.cidentityf( z )"
 base.cinv,"base.cinv( z )"
@@ -145,9 +145,10 @@ base.coth,"base.coth( x )"
 base.covercos,"base.covercos( x )"
 base.coversin,"base.coversin( x )"
 base.cphase,"base.cphase( z )"
-base.cpolar,"base.cpolar( [out,] re, im )"
+base.cpolar,"base.cpolar( z )"
+base.cpolar.assign,"base.cpolar.assign( z, out, stride, offset )"
 base.cround,"base.cround( z )"
-base.croundn,"base.croundn( [out,] re, im, n )"
+base.croundn,"base.croundn( z, n )"
 base.csch,"base.csch( x )"
 base.csignum,"base.csignum( z )"
 base.csub,"base.csub( z1, z2 )"
@@ -934,6 +935,7 @@ base.log,"base.log( x, b )"
 base.log1mexp,"base.log1mexp( x )"
 base.log1p,"base.log1p( x )"
 base.log1pexp,"base.log1pexp( x )"
+base.log1pmx,"base.log1pmx( x )"
 base.log2,"base.log2( x )"
 base.log10,"base.log10( x )"
 base.logaddexp,"base.logaddexp( x, y )"
@@ -2492,6 +2494,24 @@ exists.sync,"exists.sync( path )"
 expandAcronyms,"expandAcronyms( str )"
 expandContractions,"expandContractions( str )"
 extname,"extname( filename )"
+FancyArray,"FancyArray( dtype, buffer, shape, strides, offset, order[, options] )"
+FancyArray.prototype.byteLength,"FancyArray.prototype.byteLength"
+FancyArray.prototype.BYTES_PER_ELEMENT,"FancyArray.prototype.BYTES_PER_ELEMENT"
+FancyArray.prototype.data,"FancyArray.prototype.data"
+FancyArray.prototype.dtype,"FancyArray.prototype.dtype"
+FancyArray.prototype.flags,"FancyArray.prototype.flags"
+FancyArray.prototype.length,"FancyArray.prototype.length"
+FancyArray.prototype.ndims,"FancyArray.prototype.ndims"
+FancyArray.prototype.offset,"FancyArray.prototype.offset"
+FancyArray.prototype.order,"FancyArray.prototype.order"
+FancyArray.prototype.shape,"FancyArray.prototype.shape"
+FancyArray.prototype.strides,"FancyArray.prototype.strides"
+FancyArray.prototype.get,"FancyArray.prototype.get( ...idx )"
+FancyArray.prototype.iget,"FancyArray.prototype.iget( idx )"
+FancyArray.prototype.set,"FancyArray.prototype.set( ...idx, v )"
+FancyArray.prototype.iset,"FancyArray.prototype.iset( idx, v )"
+FancyArray.prototype.toString,"FancyArray.prototype.toString()"
+FancyArray.prototype.toJSON,"FancyArray.prototype.toJSON()"
 fastmath.abs,"fastmath.abs( x )"
 fastmath.acosh,"fastmath.acosh( x )"
 fastmath.ampbm,"fastmath.ampbm( x, y )"
@@ -3147,6 +3167,7 @@ isLowercase,"isLowercase( value )"
 isMatrixLike,"isMatrixLike( value )"
 isMethod,"isMethod( value, property )"
 isMethodIn,"isMethodIn( value, property )"
+isMultiSlice,"isMultiSlice( value )"
 isNamedTypedTupleLike,"isNamedTypedTupleLike( value )"
 isnan,"isnan( value )"
 isnan.isPrimitive,"isnan.isPrimitive( value )"
@@ -3282,6 +3303,7 @@ isSharedArrayBuffer,"isSharedArrayBuffer( value )"
 isSkewCentrosymmetricMatrix,"isSkewCentrosymmetricMatrix( value )"
 isSkewPersymmetricMatrix,"isSkewPersymmetricMatrix( value )"
 isSkewSymmetricMatrix,"isSkewSymmetricMatrix( value )"
+isSlice,"isSlice( value )"
 isSquareMatrix,"isSquareMatrix( value )"
 isSquareNumber,"isSquareNumber( value )"
 isSquareNumber.isPrimitive,"isSquareNumber.isPrimitive( value )"
@@ -3653,6 +3675,11 @@ MOBY_DICK,"MOBY_DICK()"
 MONTH_NAMES_EN,"MONTH_NAMES_EN()"
 MONTHS_IN_YEAR,"MONTHS_IN_YEAR"
 moveProperty,"moveProperty( source, prop, target )"
+MultiSlice,"MultiSlice( ...slice )"
+MultiSlice.prototype.ndims,"MultiSlice.prototype.ndims"
+MultiSlice.prototype.data,"MultiSlice.prototype.data"
+MultiSlice.prototype.toString,"MultiSlice.prototype.toString()"
+MultiSlice.prototype.toJSON,"MultiSlice.prototype.toJSON()"
 namedtypedtuple,"namedtypedtuple( fields[, options] )"
 naryFunction,"naryFunction( fcn, arity[, thisArg] )"
 nativeClass,"nativeClass( value )"
@@ -4210,7 +4237,7 @@ reim,"reim( z )"
 reimf,"reimf( z )"
 rejectArguments,"rejectArguments( fcn, predicate[, thisArg] )"
 removeFirst,"removeFirst( str[, n][, options] )"
-removeLast,"removeLast( str[, n] )"
+removeLast,"removeLast( str[, n][, options] )"
 removePunctuation,"removePunctuation( str )"
 removeUTF8BOM,"removeUTF8BOM( str )"
 removeWords,"removeWords( str, words[, ignoreCase] )"
@@ -4270,6 +4297,7 @@ SECONDS_IN_MINUTE,"SECONDS_IN_MINUTE"
 SECONDS_IN_WEEK,"SECONDS_IN_WEEK"
 secondsInMonth,"secondsInMonth( [month[, year]] )"
 secondsInYear,"secondsInYear( [value] )"
+seq2slice,"seq2slice( str, len, strict )"
 setConfigurableReadOnly,"setConfigurableReadOnly( obj, prop, value )"
 setConfigurableReadOnlyAccessor,"setConfigurableReadOnlyAccessor( obj, prop, getter )"
 setConfigurableReadWriteAccessor,"setConfigurableReadWriteAccessor( obj, prop, getter, setter )"
@@ -4293,6 +4321,13 @@ shift,"shift( collection )"
 shuffle,"shuffle( arr[, options] )"
 shuffle.factory,"shuffle.factory( [options] )"
 sizeOf,"sizeOf( dtype )"
+Slice,"Slice( [stop] )"
+Slice,"Slice( start, stop[, step] )"
+Slice.prototype.start,"Slice.prototype.start"
+Slice.prototype.stop,"Slice.prototype.stop"
+Slice.prototype.step,"Slice.prototype.step"
+Slice.prototype.toString,"Slice.prototype.toString()"
+Slice.prototype.toJSON,"Slice.prototype.toJSON()"
 snakecase,"snakecase( str )"
 some,"some( collection, n )"
 someBy,"someBy( collection, n, predicate[, thisArg ] )"

signature/docs/types/index.d.ts

@@ -16,7 +16,7 @@
 * limitations under the License.
 */
 
-// TypeScript Version: 2.0
+// TypeScript Version: 4.1
 
 /**
 * Returns the signature(s) associated with a specified alias.

typed-signature/data/data.csv

@@ -110,7 +110,7 @@ base.cbrt,"base.cbrt( x:number )"
 base.cbrtf,"base.cbrtf( x:number )"
 base.cceil,"base.cceil( z:Complex128 )"
 base.cceilf,"base.cceilf( z:Complex64 )"
-base.cceiln,"base.cceiln( [out:Array|TypedArray|Object,] re:number, im:number, n:integer )"
+base.cceiln,"base.cceiln( z:Complex128, n:integer )"
 base.ccis,"base.ccis( z:Complex128 )"
 base.cdiv,"base.cdiv( z1:Complex128, z2:Complex128 )"
 base.ceil,"base.ceil( x:number )"
@@ -124,7 +124,7 @@ base.cexp,"base.cexp( z:Complex128 )"
 base.cflipsign,"base.cflipsign( z:Complex128, y:number )"
 base.cflipsignf,"base.cflipsignf( z:Complex64, y:number )"
 base.cfloor,"base.cfloor( z:Complex128 )"
-base.cfloorn,"base.cfloorn( [out:Array|TypedArray|Object,] re:number, im:number, n:integer )"
+base.cfloorn,"base.cfloorn( z:Complex128, n:integer )"
 base.cidentity,"base.cidentity( z:Complex128 )"
 base.cidentityf,"base.cidentityf( z:Complex64 )"
 base.cinv,"base.cinv( z:Complex128 )"
@@ -145,9 +145,10 @@ base.coth,"base.coth( x:number )"
 base.covercos,"base.covercos( x:number )"
 base.coversin,"base.coversin( x:number )"
 base.cphase,"base.cphase( z:Complex128 )"
-base.cpolar,"base.cpolar( [out:Array|TypedArray|Object,] re:number, im:number )"
+base.cpolar,"base.cpolar( z:Complex128 )"
+base.cpolar.assign,"base.cpolar.assign( z:Complex128, out:Array|TypedArray|Object, stride:integer, offset:integer )"
 base.cround,"base.cround( z:Complex128 )"
-base.croundn,"base.croundn( [out:Array|TypedArray|Object,] re:number, im:number, n:integer )"
+base.croundn,"base.croundn( z:Complex128, n:integer )"
 base.csch,"base.csch( x:number )"
 base.csignum,"base.csignum( z:Complex128 )"
 base.csub,"base.csub( z1:Complex128, z2:Complex128 )"
@@ -934,6 +935,7 @@ base.log,"base.log( x:number, b:number )"
 base.log1mexp,"base.log1mexp( x:number )"
 base.log1p,"base.log1p( x:number )"
 base.log1pexp,"base.log1pexp( x:number )"
+base.log1pmx,"base.log1pmx( x:number )"
 base.log2,"base.log2( x:number )"
 base.log10,"base.log10( x:number )"
 base.logaddexp,"base.logaddexp( x:number, y:number )"
@@ -2492,6 +2494,24 @@ exists.sync,"exists.sync( path:string|Buffer )"
 expandAcronyms,"expandAcronyms( str:string )"
 expandContractions,"expandContractions( str:string )"
 extname,"extname( filename:string )"
+FancyArray,"FancyArray( dtype:string, buffer:ArrayLikeObject|TypedArray|Buffer, shape:ArrayLikeObject<integer>, strides:ArrayLikeObject<integer>, offset:integer, order:string[, options:Object] )"
+FancyArray.prototype.byteLength,"FancyArray.prototype.byteLength"
+FancyArray.prototype.BYTES_PER_ELEMENT,"FancyArray.prototype.BYTES_PER_ELEMENT"
+FancyArray.prototype.data,"FancyArray.prototype.data"
+FancyArray.prototype.dtype,"FancyArray.prototype.dtype"
+FancyArray.prototype.flags,"FancyArray.prototype.flags"
+FancyArray.prototype.length,"FancyArray.prototype.length"
+FancyArray.prototype.ndims,"FancyArray.prototype.ndims"
+FancyArray.prototype.offset,"FancyArray.prototype.offset"
+FancyArray.prototype.order,"FancyArray.prototype.order"
+FancyArray.prototype.shape,"FancyArray.prototype.shape"
+FancyArray.prototype.strides,"FancyArray.prototype.strides"
+FancyArray.prototype.get,"FancyArray.prototype.get( ...idx:integer )"
+FancyArray.prototype.iget,"FancyArray.prototype.iget( idx:integer )"
+FancyArray.prototype.set,"FancyArray.prototype.set( ...idx:integer, v:any )"
+FancyArray.prototype.iset,"FancyArray.prototype.iset( idx:integer, v:any )"
+FancyArray.prototype.toString,"FancyArray.prototype.toString()"
+FancyArray.prototype.toJSON,"FancyArray.prototype.toJSON()"
 fastmath.abs,"fastmath.abs( x:number )"
 fastmath.acosh,"fastmath.acosh( x:number )"
 fastmath.ampbm,"fastmath.ampbm( x:number, y:number )"
@@ -3147,6 +3167,7 @@ isLowercase,"isLowercase( value:any )"
 isMatrixLike,"isMatrixLike( value:any )"
 isMethod,"isMethod( value:any, property:any )"
 isMethodIn,"isMethodIn( value:any, property:any )"
+isMultiSlice,"isMultiSlice( value:any )"
 isNamedTypedTupleLike,"isNamedTypedTupleLike( value:any )"
 isnan,"isnan( value:any )"
 isnan.isPrimitive,"isnan.isPrimitive( value:any )"
@@ -3282,6 +3303,7 @@ isSharedArrayBuffer,"isSharedArrayBuffer( value:any )"
 isSkewCentrosymmetricMatrix,"isSkewCentrosymmetricMatrix( value:any )"
 isSkewPersymmetricMatrix,"isSkewPersymmetricMatrix( value:any )"
 isSkewSymmetricMatrix,"isSkewSymmetricMatrix( value:any )"
+isSlice,"isSlice( value:any )"
 isSquareMatrix,"isSquareMatrix( value:any )"
 isSquareNumber,"isSquareNumber( value:any )"
 isSquareNumber.isPrimitive,"isSquareNumber.isPrimitive( value:any )"
@@ -3653,6 +3675,11 @@ MOBY_DICK,"MOBY_DICK()"
 MONTH_NAMES_EN,"MONTH_NAMES_EN()"
 MONTHS_IN_YEAR,"MONTHS_IN_YEAR"
 moveProperty,"moveProperty( source:Object, prop:string, target:Object )"
+MultiSlice,"MultiSlice( ...slice )"
+MultiSlice.prototype.ndims,"MultiSlice.prototype.ndims"
+MultiSlice.prototype.data,"MultiSlice.prototype.data"
+MultiSlice.prototype.toString,"MultiSlice.prototype.toString()"
+MultiSlice.prototype.toJSON,"MultiSlice.prototype.toJSON()"
 namedtypedtuple,"namedtypedtuple( fields:Array<string>[, options:Object] )"
 naryFunction,"naryFunction( fcn:Function, arity:integer[, thisArg:any] )"
 nativeClass,"nativeClass( value:any )"
@@ -4210,7 +4237,7 @@ reim,"reim( z:Complex128 )"
 reimf,"reimf( z:Complex64 )"
 rejectArguments,"rejectArguments( fcn:Function, predicate:Function[, thisArg:any] )"
 removeFirst,"removeFirst( str:string[, n:integer][, options:Object] )"
-removeLast,"removeLast( str:string[, n:integer] )"
+removeLast,"removeLast( str:string[, n:integer][, options:Object] )"
 removePunctuation,"removePunctuation( str:string )"
 removeUTF8BOM,"removeUTF8BOM( str:string )"
 removeWords,"removeWords( str:string, words:Array<string>[, ignoreCase:boolean] )"
@@ -4270,6 +4297,7 @@ SECONDS_IN_MINUTE,"SECONDS_IN_MINUTE"
 SECONDS_IN_WEEK,"SECONDS_IN_WEEK"
 secondsInMonth,"secondsInMonth( [month:string|Date|integer[, year:integer]] )"
 secondsInYear,"secondsInYear( [value:integer|Date] )"
+seq2slice,"seq2slice( str:string, len:integer, strict:boolean )"
 setConfigurableReadOnly,"setConfigurableReadOnly( obj:Object, prop:string|symbol, value:any )"
 setConfigurableReadOnlyAccessor,"setConfigurableReadOnlyAccessor( obj:Object, prop:string|symbol, getter:Function )"
 setConfigurableReadWriteAccessor,"setConfigurableReadWriteAccessor( obj:Object, prop:string|symbol, getter:Function, setter:Function )"
@@ -4293,6 +4321,13 @@ shift,"shift( collection:Array|TypedArray|Object )"
 shuffle,"shuffle( arr:ArrayLike[, options:Object] )"
 shuffle.factory,"shuffle.factory( [options:Object] )"
 sizeOf,"sizeOf( dtype:string )"
+Slice,"Slice( [stop:integer|null|undefined] )"
+Slice,"Slice( start:integer|null|undefined, stop:integer|null|undefined[, step:integer|null|undefined] )"
+Slice.prototype.start,"Slice.prototype.start"
+Slice.prototype.stop,"Slice.prototype.stop"
+Slice.prototype.step,"Slice.prototype.step"
+Slice.prototype.toString,"Slice.prototype.toString()"
+Slice.prototype.toJSON,"Slice.prototype.toJSON()"
 snakecase,"snakecase( str:string )"
 some,"some( collection:Array|TypedArray|Object, n:number )"
 someBy,"someBy( collection:Array|TypedArray|Object, n:number, predicate:Function[, thisArg:any ] )"

typed-signature/docs/types/index.d.ts

@@ -16,7 +16,7 @@
 * limitations under the License.
 */
 
-// TypeScript Version: 2.0
+// TypeScript Version: 4.1
 
 /**
 * Returns the typed signature(s) associated with a specified alias.