feat: add TypeScript declarations

---
type: pre_commit_static_analysis_report
description: Results of running static analysis checks when committing changes.
report:
  - task: lint_filenames
    status: passed
  - task: lint_editorconfig
    status: passed
  - task: lint_markdown
    status: passed
  - task: lint_package_json
    status: na
  - task: lint_repl_help
    status: na
  - task: lint_javascript_src
    status: passed
  - task: lint_javascript_cli
    status: na
  - task: lint_javascript_examples
    status: na
  - task: lint_javascript_tests
    status: na
  - task: lint_javascript_benchmarks
    status: na
  - task: lint_python
    status: na
  - task: lint_r
    status: na
  - task: lint_c_src
    status: na
  - task: lint_c_examples
    status: na
  - task: lint_c_benchmarks
    status: na
  - task: lint_c_tests_fixtures
    status: na
  - task: lint_shell
    status: na
  - task: lint_typescript_declarations
    status: passed
  - task: lint_typescript_tests
    status: passed
  - task: lint_license_headers
    status: passed
---

Author: kgryte

lib/node_modules/@stdlib/random/tools/unary-factory/README.md

@@ -148,7 +148,7 @@ The function has the following parameters:
 The function accepts the following options:
 
 -   **dtype**: output ndarray data type. Setting this option overrides the output data type policy.
--   **order**: memory layout. Setting this option overrides the default memory layout order.
+-   **order**: memory layout. Setting this option overrides the default memory layout.
 -   **mode**: specifies how to handle indices which exceed ndarray dimensions.
 -   **submode**: specifies how to handle subscripts which exceed ndarray dimensions on a per dimension basis.
 -   **readonly**: boolean indicating whether an ndarray should be read-only.

lib/node_modules/@stdlib/random/tools/unary-factory/docs/types/index.d.ts

@@ -0,0 +1,297 @@
+/*
+* @license Apache-2.0
+*
+* Copyright (c) 2025 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: 4.1
+
+/// <reference types="@stdlib/types"/>
+
+import { DataType, Order, Mode, Shape, OutputPolicy, typedndarray } from '@stdlib/types/ndarray';
+import { ArrayLike } from '@stdlib/types/array';
+import * as random from '@stdlib/types/random';
+
+/**
+* Interface defining factory options.
+*/
+interface FactoryOptions {
+	/**
+	* Default memory layout.
+	*/
+	order?: Order;
+}
+
+/**
+* Interface defining PRNG options.
+*/
+interface PRNGOptions {
+	/**
+	* 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. Default: true.
+	*/
+	copy?: boolean;
+}
+
+/**
+* Interface defining options when generating pseudorandom values.
+*/
+interface Options {
+	/**
+	* Output ndarray data type.
+	*
+	* ## Notes
+	*
+	* -   Setting this option overrides the output data type policy.
+	*/
+	dtype?: DataType;
+
+	/**
+	* Memory layout.
+	*
+	* ## Notes
+	*
+	* -   Setting this option overrides the default memory layout.
+	*/
+	order?: Order;
+
+	/**
+	* Specifies how to handle indices which exceed ndarray dimensions.
+	*/
+	mode?: Mode;
+
+	/**
+	* Specifies how to handle subscripts which exceed ndarray dimensions on a per dimension basis.
+	*/
+	submode?: ArrayLike<Mode>;
+
+	/**
+	* Boolean indicating whether an ndarray should be read-only.
+	*/
+	readonly?: boolean;
+}
+
+/**
+* Interface defining class policies.
+*/
+interface Policies {
+	/**
+	* Output data type policy.
+	*/
+	output: OutputPolicy;
+}
+
+/**
+* Interface for PRNG properties and methods.
+*/
+interface PRNG {
+	/**
+	* Underlying pseudorandom number generator.
+	*/
+	readonly PRNG: random.PRNG;
+
+	/**
+	* PRNG seed.
+	*/
+	readonly seed: random.PRNGSeedMT19937 | null;
+
+	/**
+	* PRNG seed length.
+	*/
+	readonly seedLength: number | null;
+
+	/**
+	* PRNG state.
+	*/
+	state: random.PRNGStateMT19937 | null;
+
+	/**
+	* PRNG state length.
+	*/
+	readonly stateLength: number | null;
+
+	/**
+	* PRNG state size (in bytes).
+	*/
+	readonly byteLength: number | null;
+}
+
+/**
+* Interface for generating pseudorandom values drawn from a unary PRNG.
+*/
+interface UnaryPRNG<T, U> extends random.PRNG {
+	/**
+	* Returns a pseudorandom value.
+	*
+	* @param param1 - PRNG parameter
+	* @returns pseudorandom value
+	*/
+	( param1: T ): U;
+}
+
+/**
+* Interface for creating ndarrays filled with pseudorandom values drawn from a unary PRNG.
+*/
+interface Random<T, U> extends PRNG {
+	/**
+	* Returns an ndarray filled with pseudorandom values drawn from a unary PRNG.
+	*
+	* @param shape - output shape
+	* @param param1 - PRNG parameter
+	* @param options - function options
+	* @returns output ndarray
+	*
+	* @example
+	* var dtypes = require( '@stdlib/ndarray/dtypes' );
+	* var exponential = require( '@stdlib/random/base/exponential' );
+	*
+	* var idt = dtypes( 'real_and_generic' );
+	* var odt = dtypes( 'real_floating_point_and_generic' );
+	*
+	* var policies = {
+	*     'output': 'real_floating_point_and_generic'
+	* };
+	* var options = {
+	*     'order': 'row-major'
+	* };
+	*
+	* var rand = new Random( exponential, idt, odt, policies, options );
+	*
+	* var v = rand( [ 2, 2 ], 2.0 );
+	* // returns <ndarray>
+	*/
+	( shape: Shape, param1: T | typedndarray<T>, options?: Options ): typedndarray<U>;
+
+	/**
+	* Fills an ndarray with pseudorandom values drawn from a unary PRNG.
+	*
+	* @param param1 - PRNG parameter
+	* @param out - output ndarray
+	* @returns output ndarray
+	*
+	* @example
+	* var dtypes = require( '@stdlib/ndarray/dtypes' );
+	* var ndzeros = require( '@stdlib/ndarray/zeros' );
+	* var exponential = require( '@stdlib/random/base/exponential' );
+	*
+	* var idt = dtypes( 'real_and_generic' );
+	* var odt = dtypes( 'real_floating_point_and_generic' );
+	*
+	* var policies = {
+	*     'output': 'real_floating_point_and_generic'
+	* };
+	* var options = {
+	*     'order': 'row-major'
+	* };
+	*
+	* var rand = new Random( exponential, idt, odt, policies, options );
+	*
+	* var out = ndzeros( [ 2, 2 ] );
+	* var v = rand.assign( 2.0, out );
+	* // returns <ndarray>
+	*
+	* var bool = ( v === out );
+	* // returns true
+	*/
+	assign( param1: T | typedndarray<T>, out: typedndarray<U> ): typedndarray<U>;
+}
+
+/**
+* Returns a function for generating pseudorandom values drawn from a unary PRNG.
+*
+* @param options - function options
+* @returns function for creating ndarrays
+*/
+type Factory<T, U> = ( options?: PRNGOptions ) => Random<T, U>;
+
+/**
+* Returns a function for generating pseudorandom values drawn from a unary PRNG.
+*
+* @param prng - unary pseudorandom value generator
+* @param idtypes - list of supported input data types
+* @param odtypes - list of supported output data types
+* @param policies - dispatch policies
+* @param options - function options
+* @returns instance
+*
+* @example
+* var dtypes = require( '@stdlib/ndarray/dtypes' );
+* var exponential = require( '@stdlib/random/base/exponential' );
+*
+* var idt = dtypes( 'real_and_generic' );
+* var odt = dtypes( 'real_floating_point_and_generic' );
+*
+* var policies = {
+*     'output': 'real_floating_point_and_generic'
+* };
+* var options = {
+*     'order': 'row-major'
+* };
+*
+* var factory = createFactory( exponential, idt, odt, policies, options );
+*
+* var rand = factory();
+* // returns <Function>
+*
+* var v = rand( [ 2, 2 ], 2.0 );
+* // returns <ndarray>
+*
+* @example
+* var dtypes = require( '@stdlib/ndarray/dtypes' );
+* var ndzeros = require( '@stdlib/ndarray/zeros' );
+* var exponential = require( '@stdlib/random/base/exponential' );
+*
+* var idt = dtypes( 'real_and_generic' );
+* var odt = dtypes( 'real_floating_point_and_generic' );
+*
+* var policies = {
+*     'output': 'real_floating_point_and_generic'
+* };
+* var options = {
+*     'order': 'row-major'
+* };
+*
+* var factory = createFactory( exponential, idt, odt, policies, options );
+*
+* var rand = factory();
+* // returns <Function>
+*
+* var out = ndzeros( [ 2, 2 ] );
+* var v = rand.assign( 2.0, out );
+* // returns <ndarray>
+*
+* var bool = ( v === out );
+* // returns true
+*/
+declare function createFactory<T = unknown, U = unknown>( prng: UnaryPRNG<T, U>, idtypes: ArrayLike<DataType>, odtypes: ArrayLike<DataType>, policies: Policies, options?: FactoryOptions ): Factory<T, U>;
+
+
+// EXPORTS //
+
+export = createFactory;