Add Typescript definition

Author: Planeshifter

lib/node_modules/@stdlib/random/base/poisson/docs/types/index.d.ts

@@ -0,0 +1,231 @@
+/*
+* @license Apache-2.0
+*
+* Copyright (c) 2019 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.
+*/
+
+// TypeScript Version: 2.0
+
+/// <reference types="@stdlib/types"/>
+
+import * as random from '@stdlib/types/random';
+
+/**
+* Interface defining `factory` options.
+*/
+interface Options {
+	/**
+	* Pseudorandom number generator which generates uniformly distributed pseudorandom numbers.
+	*/
+	prng?: random.PRNG;
+
+	/**
+	* Pseudorandom number generator seed.
+	*/
+	seed?: random.PRNGSeedMT19937;
+
+	/**
+	* Pseudorandom number generator state.
+	*/
+	state?: random.PRNGStateMT19937;
+
+	/**
+	* Specifies whether to copy a provided pseudorandom number generator state.
+	*/
+	copy?: boolean;
+}
+
+/**
+* Interface for PRNG properties and methods.
+*/
+interface PRNG {
+	/**
+	* Generator name.
+	*/
+	readonly NAME: string;
+
+	/**
+	* Underlying pseudorandom number generator.
+	*/
+	readonly PRNG: random.PRNG;
+
+	/**
+	* PRNG seed.
+	*/
+	readonly seed: random.PRNGSeedMT19937;
+
+	/**
+	* PRNG seed length.
+	*/
+	readonly seedLength: number;
+
+	/**
+	* PRNG state.
+	*/
+	state: random.PRNGStateMT19937;
+
+	/**
+	* PRNG state length.
+	*/
+	readonly stateLength: number;
+
+	/**
+	* PRNG state size (in bytes).
+	*/
+	readonly byteLength: number;
+
+	/**
+	* Serializes the pseudorandom number generator as a JSON object.
+	*
+	* @returns out - JSON representation
+	*/
+	toJSON(): string;
+}
+
+/**
+* Interface for generating Poisson distributed pseudorandom numbers with pre-specified parameter values.
+*/
+interface NullaryFunction extends PRNG {
+	/**
+	* Returns a Poisson distributed pseudorandom number.
+	*
+	* @returns pseudorandom number
+	*/
+	(): number;
+}
+
+/**
+* Interface for generating Poisson distributed pseudorandom numbers without pre-specified parameter values.
+*/
+interface BinaryFunction extends PRNG {
+	/**
+	* Returns a Poisson distributed pseudorandom number.
+	*
+	* @param lambda - mean
+	* @returns pseudorandom number
+	*/
+	( lambda: number ): number;
+}
+
+/**
+* Interface for generating pseudorandom numbers drawn from a Poisson distribution.
+*/
+interface Random extends PRNG {
+	/**
+	* Returns a Poisson distributed pseudorandom number.
+	*
+	* ## Notes
+	*
+	* -   If `lambda <= 0`, the function returns `NaN`.
+	* -   If `lambda` is `NaN`, the function returns `NaN`.
+	*
+	* @param lambda - mean
+	* @returns pseudorandom number
+	*
+	* @example
+	* var v = poisson( 1.5 );
+	* // returns <number>
+	*/
+	( lambda: number ): number;
+
+	/**
+	* Returns a pseudorandom number generator for generating Poisson distributed random numbers.
+	*
+	* ## Notes
+	*
+	* -   When provided `lambda`, the returned PRNG returns random variates drawn from the specified distribution.
+	*
+	* @param lambda - mean
+	* @param options - function options
+	* @param options.prng - pseudorandom number generator which generates uniformly distributed pseudorandom numbers
+	* @param options.seed - pseudorandom number generator seed
+	* @param options.state - pseudorandom number generator state
+	* @param options.copy - boolean indicating whether to copy a provided pseudorandom number generator state (default: true)
+	* @throws must provide a valid state
+	* @returns pseudorandom number generator
+	*
+	* @example
+	* var mypoisson = poisson.factory( 1.5 );
+	*
+	* var v = mypoisson();
+	* // returns <number>
+	*
+	* @example
+	* var mypoisson = poisson.factory( 2.3, {
+	*     'seed': 297
+	* });
+	* var v = mypoisson();
+	* // returns <number>
+	*/
+	factory( lambda: number, options?: Options ): NullaryFunction;
+
+	/**
+	* Returns a pseudorandom number generator for generating Poisson distributed random numbers.
+	*
+	* ## Notes
+	*
+	* -   When not provided `lambda`, the returned PRNG requires that `lambda` be provided at each invocation.
+	*
+	* @param options - function options
+	* @param options.prng - pseudorandom number generator which generates uniformly distributed pseudorandom numbers
+	* @param options.seed - pseudorandom number generator seed
+	* @param options.state - pseudorandom number generator state
+	* @param options.copy - boolean indicating whether to copy a provided pseudorandom number generator state (default: true)
+	* @throws must provide a valid state
+	* @returns pseudorandom number generator
+	*
+	* @example
+	* var mypoisson = poisson.factory();
+	*
+	* var v = mypoisson( 1.5 );
+	* // returns <number>
+	*
+	* @example
+	* var mypoisson = poisson.factory({
+	*     'seed': 297
+	* });
+	* var v = mypoisson( 2.3 );
+	* // returns <number>
+	*/
+	factory( options?: Options ): BinaryFunction;
+}
+
+/**
+* Returns a Poisson distributed pseudorandom number.
+*
+* ## Notes
+*
+* -   If `lambda <= 0`, the function returns `NaN`.
+* -   If `lambda` is `NaN`, the function returns `NaN`.
+*
+* @param lambda - mean
+* @returns pseudorandom number
+*
+* @example
+* var v = poisson( 1.5 );
+* // returns <number>
+*
+* @example
+* var mypoisson = poisson.factory( 1.5 );
+*
+* var v = mypoisson();
+* // returns <number>
+*/
+declare var poisson: Random;
+
+
+// EXPORTS //
+
+export = poisson;