From 62faf2b34bdb50a0acf95fe6397cf7e669f72aec Mon Sep 17 00:00:00 2001
From: abhishekblue <jainabhishekjain007@gmail.com>
Date: Sun, 9 Mar 2025 12:44:10 +0530
Subject: [PATCH 1/4] feat(stats/incr): add anmin package to handle NaN values

---
 .../@stdlib/stats/incr/nanmin/README.md       | 142 ++++++++++++++++++
 .../stats/incr/nanmin/benchmark/benchmark.js  |  69 +++++++++
 .../@stdlib/stats/incr/nanmin/docs/repl.txt   |  37 +++++
 .../stats/incr/nanmin/docs/types/index.d.ts   |  64 ++++++++
 .../stats/incr/nanmin/docs/types/test.ts      |  61 ++++++++
 .../stats/incr/nanmin/examples/index.js       |  43 ++++++
 .../@stdlib/stats/incr/nanmin/lib/index.js    |  57 +++++++
 .../@stdlib/stats/incr/nanmin/lib/main.js     |  77 ++++++++++
 .../@stdlib/stats/incr/nanmin/package.json    |  67 +++++++++
 .../@stdlib/stats/incr/nanmin/test/test.js    | 126 ++++++++++++++++
 10 files changed, 743 insertions(+)
 create mode 100644 lib/node_modules/@stdlib/stats/incr/nanmin/README.md
 create mode 100644 lib/node_modules/@stdlib/stats/incr/nanmin/benchmark/benchmark.js
 create mode 100644 lib/node_modules/@stdlib/stats/incr/nanmin/docs/repl.txt
 create mode 100644 lib/node_modules/@stdlib/stats/incr/nanmin/docs/types/index.d.ts
 create mode 100644 lib/node_modules/@stdlib/stats/incr/nanmin/docs/types/test.ts
 create mode 100644 lib/node_modules/@stdlib/stats/incr/nanmin/examples/index.js
 create mode 100644 lib/node_modules/@stdlib/stats/incr/nanmin/lib/index.js
 create mode 100644 lib/node_modules/@stdlib/stats/incr/nanmin/lib/main.js
 create mode 100644 lib/node_modules/@stdlib/stats/incr/nanmin/package.json
 create mode 100644 lib/node_modules/@stdlib/stats/incr/nanmin/test/test.js

diff --git a/lib/node_modules/@stdlib/stats/incr/nanmin/README.md b/lib/node_modules/@stdlib/stats/incr/nanmin/README.md
new file mode 100644
index 000000000000..94ba5a86c4a6
--- /dev/null
+++ b/lib/node_modules/@stdlib/stats/incr/nanmin/README.md
@@ -0,0 +1,142 @@
+<!--
+
+@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.
+
+-->
+
+# incrnanmin
+
+> Compute a minimum value incrementally, ignoring `NaN` values.
+
+<section class="usage">
+
+## Usage
+
+```javascript
+var incrnanmin = require( '@stdlib/stats/incr/nanmin' );
+```
+
+#### incrnanmin()
+
+Returns an accumulator `function` which incrementally computes a minimum value, ignoring `NaN` values.
+
+```javascript
+var accumulator = incrnanmin();
+```
+
+#### accumulator( \[x] )
+
+If provided an input value `x`, the accumulator function returns an updated minimum value. If not provided an input value `x`, the accumulator function returns the current minimum value.
+
+```javascript
+var accumulator = incrnanmin();
+
+var min = accumulator( 2.0 );
+// returns 2.0
+
+min = accumulator( 1.0 );
+// returns 1.0
+
+min = accumulator( NaN );
+// returns 1.0
+
+min = accumulator( 3.0 );
+// returns 1.0
+
+min = accumulator();
+// returns 1.0
+```
+
+</section>
+
+<!-- /.usage -->
+
+<section class="notes">
+
+## Notes
+
+-   Input values are **not** type checked. If non-numeric inputs are possible, you are advised to type check and handle accordingly **before** passing the value to the accumulator function.
+-   If all values provided are `NaN`, the accumulator returns `NaN`.
+
+</section>
+
+<!-- /.notes -->
+
+<section class="examples">
+
+## Examples
+
+```javascript
+var randu = require( '@stdlib/random/base/randu' );
+var incrnanmin = require( '@stdlib/stats/incr/nanmin' );
+
+var accumulator;
+var v;
+var i;
+
+// Initialize an accumulator:
+accumulator = incrnanmin();
+
+// For each simulated datum, update the min...
+for ( i = 0; i < 100; i++ ) {
+    if ( randu() < 0.2 ) {
+        v = NaN;
+    } else {
+        v = randu() * 100.0;
+    }
+    accumulator( v );
+}
+console.log( accumulator() );
+```
+
+</section>
+
+<!-- /.examples -->
+
+<!-- Section for related `stdlib` packages. Do not manually edit this section, as it is automatically populated. -->
+
+<section class="related">
+
+* * *
+
+## See Also
+
+-   <span class="package-name">[`@stdlib/stats/incr/min`][@stdlib/stats/incr/min]</span><span class="delimiter">: </span><span class="description">compute a minimum value incrementally.</span>
+-   <span class="package-name">[`@stdlib/stats/incr/mmin`][@stdlib/stats/incr/mmin]</span><span class="delimiter">: </span><span class="description">compute a moving minimum incrementally.</span>
+-   <span class="package-name">[`@stdlib/stats/incr/nanmax`][@stdlib/stats/incr/nanmax]</span><span class="delimiter">: </span><span class="description">compute a maximum value incrementally, ignoring NaN values.</span>
+
+</section>
+
+<!-- /.related -->
+
+<!-- Section for all links. Make sure to keep an empty line after the `section` element and another before the `/section` close. -->
+
+<section class="links">
+
+<!-- <related-links> -->
+
+[@stdlib/stats/incr/min]: https://github.com/stdlib-js/stdlib/tree/develop/lib/node_modules/%40stdlib/stats/incr/min
+
+[@stdlib/stats/incr/mmin]: https://github.com/stdlib-js/stdlib/tree/develop/lib/node_modules/%40stdlib/stats/incr/mmin
+
+[@stdlib/stats/incr/nanmax]: https://github.com/stdlib-js/stdlib/tree/develop/lib/node_modules/%40stdlib/stats/incr/nanmax
+
+<!-- </related-links> -->
+
+</section>
+
+<!-- /.links -->
diff --git a/lib/node_modules/@stdlib/stats/incr/nanmin/benchmark/benchmark.js b/lib/node_modules/@stdlib/stats/incr/nanmin/benchmark/benchmark.js
new file mode 100644
index 000000000000..ca7d79695018
--- /dev/null
+++ b/lib/node_modules/@stdlib/stats/incr/nanmin/benchmark/benchmark.js
@@ -0,0 +1,69 @@
+/**
+* @license Apache-2.0
+*
+* Copyright (c) 2018 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.
+*/
+
+'use strict';
+
+// MODULES //
+
+var bench = require( '@stdlib/bench' );
+var randu = require( '@stdlib/random/base/randu' );
+var pkg = require( './../package.json' ).name;
+var incrnanmin = require( './../lib' );
+
+
+// MAIN //
+
+bench( pkg, function benchmark( b ) {
+	var f;
+	var i;
+	b.tic();
+	for ( i = 0; i < b.iterations; i++ ) {
+		f = incrnanmin();
+		if ( typeof f !== 'function' ) {
+			b.fail( 'should return a function' );
+		}
+	}
+	b.toc();
+	if ( typeof f !== 'function' ) {
+		b.fail( 'should return a function' );
+	}
+	b.pass( 'benchmark finished' );
+	b.end();
+});
+
+bench( pkg+'::accumulator', function benchmark( b ) {
+	var acc;
+	var v;
+	var i;
+
+	acc = incrnanmin();
+
+	b.tic();
+	for ( i = 0; i < b.iterations; i++ ) {
+		v = acc( randu() );
+		if ( v !== v ) {
+			b.fail( 'should not return NaN' );
+		}
+	}
+	b.toc();
+	if ( v !== v ) {
+		b.fail( 'should not return NaN' );
+	}
+	b.pass( 'benchmark finished' );
+	b.end();
+});
diff --git a/lib/node_modules/@stdlib/stats/incr/nanmin/docs/repl.txt b/lib/node_modules/@stdlib/stats/incr/nanmin/docs/repl.txt
new file mode 100644
index 000000000000..4a0564d110f1
--- /dev/null
+++ b/lib/node_modules/@stdlib/stats/incr/nanmin/docs/repl.txt
@@ -0,0 +1,37 @@
+{{alias}}()
+    Returns an accumulator function which incrementally computes a minimum
+    value, ignoring NaN values.
+
+    If provided a value, the accumulator function returns an updated minimum
+    value. If not provided a value, the accumulator function returns the current
+    minimum value.
+
+    If no valid numbers have been provided (only NaN values), the accumulator
+    function returns null. Unlike incrmin, NaN values are ignored and do not
+    set the minimum to NaN.
+
+    Returns
+    -------
+    acc: Function
+        Accumulator function.
+
+    Examples
+    --------
+    > var accumulator = {{alias}}();
+    > var m = accumulator()
+    null
+    > m = accumulator( 3.14 )
+    3.14
+    > m = accumulator( NaN )
+    3.14
+    > m = accumulator( -5.0 )
+    -5.0
+    > m = accumulator( 10.1 )
+    -5.0
+    > m = accumulator( NaN )
+    -5.0
+    > m = accumulator()
+    -5.0
+
+    See Also
+    --------
diff --git a/lib/node_modules/@stdlib/stats/incr/nanmin/docs/types/index.d.ts b/lib/node_modules/@stdlib/stats/incr/nanmin/docs/types/index.d.ts
new file mode 100644
index 000000000000..e9423683f39c
--- /dev/null
+++ b/lib/node_modules/@stdlib/stats/incr/nanmin/docs/types/index.d.ts
@@ -0,0 +1,64 @@
+/*
+* @license Apache-2.0
+*
+* Copyright (c) 2020 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"/>
+
+/**
+* Returns an accumulator function which incrementally computes a minimum value, ignoring `NaN` values
+* @param x - value
+* @returns minimum value
+*/
+type accumulator = ( x?: number ) => number | null;
+
+/**
+* Returns an accumulator function which incrementally computes a minimum value, ignoring `NaN` values.
+*
+* @returns accumulator function
+*
+* @example
+* var accumulator = incrnanmin();
+*
+* var m = accumulator();
+* // returns null
+*
+* m = accumulator(3.14);
+* // returns 3.14
+*
+* m = accumulator(NaN);
+* // returns 3.14
+*
+* m = accumulator(-5.0);
+* // returns -5.0
+*
+* m = accumulator(10.1);
+* // returns -5.0
+*
+* m = accumulator(NaN);
+* // returns -5.0
+*
+* m = accumulator();
+* // returns -5.0
+*/
+declare function incrnanmin(): accumulator;
+
+
+// EXPORTS //
+
+export = incrnanmin;
diff --git a/lib/node_modules/@stdlib/stats/incr/nanmin/docs/types/test.ts b/lib/node_modules/@stdlib/stats/incr/nanmin/docs/types/test.ts
new file mode 100644
index 000000000000..85a557750510
--- /dev/null
+++ b/lib/node_modules/@stdlib/stats/incr/nanmin/docs/types/test.ts
@@ -0,0 +1,61 @@
+/*
+* @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.
+*/
+
+import incrnanmin = require('./index')
+
+
+// TESTS //
+
+// The function returns an accumulator function...
+{
+	incrnanmin(); // $ExpectType accumulator
+}
+
+// The compiler throws an error if the function is provided arguments...
+{
+	incrnanmin( '5' ); // $ExpectError
+	incrnanmin( 5 ); // $ExpectError
+	incrnanmin( true ); // $ExpectError
+	incrnanmin( false ); // $ExpectError
+	incrnanmin( null ); // $ExpectError
+	incrnanmin( undefined ); // $ExpectError
+	incrnanmin( [] ); // $ExpectError
+	incrnanmin( {} ); // $ExpectError
+	incrnanmin( ( x: number ): number => x ); // $ExpectError
+}
+
+// The function returns an accumulator function which returns an accumulated result...
+{
+	const acc = incrnanmin();
+
+	acc(); // $ExpectType number | null
+	acc( 3.14 ); // $ExpectType number | null
+}
+
+// The compiler throws an error if the returned accumulator function is provided invalid arguments...
+{
+	const acc = incrnanmin();
+
+	acc( '5' ); // $ExpectError
+	acc( true ); // $ExpectError
+	acc( false ); // $ExpectError
+	acc( null ); // $ExpectError
+	acc( [] ); // $ExpectError
+	acc( {} ); // $ExpectError
+	acc( ( x: number ): number => x ); // $ExpectError
+}
diff --git a/lib/node_modules/@stdlib/stats/incr/nanmin/examples/index.js b/lib/node_modules/@stdlib/stats/incr/nanmin/examples/index.js
new file mode 100644
index 000000000000..4b93977952d3
--- /dev/null
+++ b/lib/node_modules/@stdlib/stats/incr/nanmin/examples/index.js
@@ -0,0 +1,43 @@
+/**
+* @license Apache-2.0
+*
+* Copyright (c) 2018 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.
+*/
+
+'use strict';
+
+var randu = require( '@stdlib/random/base/randu' );
+var incrnanmin = require( './../lib' );
+
+var accumulator;
+var min;
+var v;
+var i;
+
+// Initialize an accumulator:
+accumulator = incrnanmin();
+
+// For each simulated datum, update the min...
+console.log( '\nValue\tMin\n' );
+for ( i = 0; i < 100; i++ ) {
+	if ( randu() < 0.2 ) {
+		v = NaN;
+	} else {
+		v = randu() * 100.0;
+	}
+	min = accumulator( v );
+	console.log( '%d\t%d', v.toFixed( 4 ), ( min === null ) ? NaN : min.toFixed( 4 ) );
+}
+console.log( '\nFinal min: %d\n', accumulator() );
diff --git a/lib/node_modules/@stdlib/stats/incr/nanmin/lib/index.js b/lib/node_modules/@stdlib/stats/incr/nanmin/lib/index.js
new file mode 100644
index 000000000000..e833c6150b5d
--- /dev/null
+++ b/lib/node_modules/@stdlib/stats/incr/nanmin/lib/index.js
@@ -0,0 +1,57 @@
+/**
+* @license Apache-2.0
+*
+* Copyright (c) 2020 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.
+*/
+
+'use strict';
+
+/**
+* Compute a minimum value incrementally, ignoring `NaN` values.
+*
+* @module @stdlib/stats/incr/nanmin
+*
+* @example
+* var incrnanmin = require( '@stdlib/stats/incr/nanmin' )
+*
+* var accumulator = incrnanmin();
+*
+* var min = accumulator();
+* // returns null
+*
+* min = accumulator(3.14);
+* // returns 3.14
+*
+* min = accumulator(-5.0);
+* // returns -5.0
+*
+* min = accumulator(NaN);
+* // returns -5.0
+*
+* min = accumulator( 10.1 );
+* returns -5.0
+*
+* min = accumulator();
+* // returns -5.0
+*/
+
+// MODULES //
+
+var main = require( './main.js' );
+
+
+// EXPORTS //
+
+module.exports = main;
diff --git a/lib/node_modules/@stdlib/stats/incr/nanmin/lib/main.js b/lib/node_modules/@stdlib/stats/incr/nanmin/lib/main.js
new file mode 100644
index 000000000000..918ba2fd3329
--- /dev/null
+++ b/lib/node_modules/@stdlib/stats/incr/nanmin/lib/main.js
@@ -0,0 +1,77 @@
+/**
+* @license Apache-2.0
+*
+* Copyright (c) 2018 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.
+*/
+
+'use strict';
+
+// MODULES //
+
+var isnan = require( '@stdlib/math/base/assert/is-nan' );
+var incrmin = require( '@stdlib/stats/incr/min' );
+
+
+// MAIN //
+
+/**
+* Returns an accumulator function which incrementally computes a minimum value, ignoring `NaN` values.
+*
+* @returns {Function} accumulator function
+*
+* @example
+* var accumulator = incrnanmin();
+*
+* var min = accumulator();
+* // returns null
+*
+* min = accumulator(3.14);
+* // returns 3.14
+*
+* min = accumulator(-5.0);
+* // returns -5.0
+*
+* min = accumulator(NaN);
+* // returns -5.0
+*
+* min = accumulator( 10.1 );
+* returns -5.0
+*
+* min = accumulator();
+* // returns -5.0
+*/
+function incrnanmin() {
+	var min = incrmin();
+	return accumulator;
+
+	/**
+	* If provided a value, the accumulator function returns an updated minimum value. If not provided a value, the accumulator function returns the current min.
+	*
+	* @private
+	* @param {number} [x] - new value
+	* @returns {(number|null)} min value or null
+	*/
+	function accumulator( x ) {
+		if ( arguments.length === 0 || isnan( x ) ) {
+			return min();
+		}
+		return min( x );
+	}
+}
+
+
+// EXPORTS //
+
+module.exports = incrnanmin;
diff --git a/lib/node_modules/@stdlib/stats/incr/nanmin/package.json b/lib/node_modules/@stdlib/stats/incr/nanmin/package.json
new file mode 100644
index 000000000000..ee7b4519dbfe
--- /dev/null
+++ b/lib/node_modules/@stdlib/stats/incr/nanmin/package.json
@@ -0,0 +1,67 @@
+{
+  "name": "@stdlib/stats/incr/nanmin",
+  "version": "0.0.0",
+  "description": "Compute a minimum value incrementally, ignoring NaN values.",
+  "license": "Apache-2.0",
+  "author": {
+    "name": "The Stdlib Authors",
+    "url": "https://github.com/stdlib-js/stdlib/graphs/contributors"
+  },
+  "contributors": [
+    {
+      "name": "The Stdlib Authors",
+      "url": "https://github.com/stdlib-js/stdlib/graphs/contributors"
+    }
+  ],
+  "main": "./lib",
+  "directories": {
+    "benchmark": "./benchmark",
+    "doc": "./docs",
+    "example": "./examples",
+    "lib": "./lib",
+    "test": "./test"
+  },
+  "types": "./docs/types",
+  "scripts": {},
+  "homepage": "https://github.com/stdlib-js/stdlib",
+  "repository": {
+    "type": "git",
+    "url": "git://github.com/stdlib-js/stdlib.git"
+  },
+  "bugs": {
+    "url": "https://github.com/stdlib-js/stdlib/issues"
+  },
+  "dependencies": {},
+  "devDependencies": {},
+  "engines": {
+    "node": ">=0.10.0",
+    "npm": ">2.7.0"
+  },
+  "os": [
+    "aix",
+    "darwin",
+    "freebsd",
+    "linux",
+    "macos",
+    "openbsd",
+    "sunos",
+    "win32",
+    "windows"
+  ],
+  "keywords": [
+    "stdlib",
+    "stdmath",
+    "statistics",
+    "stats",
+    "mathematics",
+    "math",
+    "minimum",
+    "min",
+    "range",
+    "extremes",
+    "domain",
+    "extent",
+    "incremental",
+    "accumulator"
+  ]
+}
diff --git a/lib/node_modules/@stdlib/stats/incr/nanmin/test/test.js b/lib/node_modules/@stdlib/stats/incr/nanmin/test/test.js
new file mode 100644
index 000000000000..927034182034
--- /dev/null
+++ b/lib/node_modules/@stdlib/stats/incr/nanmin/test/test.js
@@ -0,0 +1,126 @@
+/**
+* @license Apache-2.0
+*
+* Copyright (c) 2018 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.
+*/
+
+'use strict';
+
+// MODULES //
+
+var tape = require( 'tape' );
+var isNegativeZero = require( '@stdlib/math/base/assert/is-negative-zero' );
+var isPositiveZero = require( '@stdlib/math/base/assert/is-positive-zero' );
+var isnan = require( '@stdlib/math/base/assert/is-nan' );
+var incrnanmin = require( './../lib' );
+
+
+// TESTS //
+
+tape( 'main export is a function', function test( t ) {
+	t.ok( true, __filename );
+	t.strictEqual( typeof incrnanmin, 'function', 'main export is a function' );
+	t.end();
+});
+
+tape( 'the function returns an accumulator function', function test( t ) {
+	t.equal( typeof incrnanmin(), 'function', 'returns a function' );
+	t.end();
+});
+
+tape( 'if not provided any values, the initial returned minimum value is `null`', function test( t ) {
+	var acc = incrnanmin();
+	t.equal( acc(), null, 'returns null' );
+	t.end();
+});
+
+tape( 'the accumulator function incrementally computes a minimum value', function test( t ) {
+	var expected;
+	var actual;
+	var data;
+	var acc;
+	var min;
+	var N;
+	var d;
+	var i;
+
+	data = [2.0, 3.0, NaN, 1.0, 4.0, NaN, 3.0, 4.0 ];
+	N = data.length;
+
+	expected = [];
+	actual = [];
+
+	acc = incrnanmin();
+
+	min = data[ 0 ];
+	for ( i = 0; i < N; i++ ) {
+		d = data[ i ];
+		if ( isnan( d ) === false ) {
+			if ( min === null || d < min ) {
+				min = d;
+			}
+		}
+		expected.push( min );
+		actual.push( acc( d ) );
+	}
+	t.deepEqual( actual, expected, 'returns expected incremental results' );
+	t.end();
+});
+
+tape( 'if not provided an input value, the accumulator function returns the current minimum value', function test( t ) {
+	var data;
+	var acc;
+	var i;
+
+	data = [ 2.0, NaN, 1.0, NaN, 3.0 ];
+	acc = incrnanmin();
+	for ( i = 0; i < data.length; i++ ) {
+		acc( data[ i ] );
+	}
+	t.equal( acc(), 1.0, 'returns the current accumulated minimum value' );
+	t.end();
+});
+
+tape( 'the accumulator function correctly handles signed zeros', function test( t ) {
+	var acc;
+	var v;
+
+	acc = incrnanmin();
+
+	v = acc( 0.0 );
+	t.equal( isPositiveZero( v ), true, 'returns expected value' );
+
+	v = acc( -0.0 );
+	t.equal( isNegativeZero( v ), true, 'returns expected value' );
+
+	v = acc( 0.0 );
+	t.equal( isNegativeZero( v ), true, 'returns expected value' );
+
+	t.end();
+});
+
+tape( 'if provided a `NaN`, the accumulator function ignores it and maintains the current minimum', function test( t ) {
+	var data;
+	var acc;
+	var i;
+
+	data = [ 2.0, NaN, 1.0, 2.0, 3.0, NaN, 5.0, 6.0, 7.0 ];
+	acc = incrnanmin();
+	for ( i = 0; i < data.length; i++ ) {
+		acc( data[ i ] );
+	}
+	t.equal( isnan( acc() ), false, 'returns expected value' );
+	t.end();
+});

From 55a6c203425d7485ddc0c1657bed3c7b5d453981 Mon Sep 17 00:00:00 2001
From: abhishekblue <jainabhishekjain007@gmail.com>
Date: Sun, 9 Mar 2025 13:35:07 +0530
Subject: [PATCH 2/4] fix lint copyright years

---
 .../@stdlib/stats/incr/nanmin/benchmark/benchmark.js            | 2 +-
 .../@stdlib/stats/incr/nanmin/docs/types/index.d.ts             | 2 +-
 lib/node_modules/@stdlib/stats/incr/nanmin/docs/types/test.ts   | 2 +-
 lib/node_modules/@stdlib/stats/incr/nanmin/examples/index.js    | 2 +-
 lib/node_modules/@stdlib/stats/incr/nanmin/lib/index.js         | 2 +-
 lib/node_modules/@stdlib/stats/incr/nanmin/lib/main.js          | 2 +-
 lib/node_modules/@stdlib/stats/incr/nanmin/test/test.js         | 2 +-
 7 files changed, 7 insertions(+), 7 deletions(-)

diff --git a/lib/node_modules/@stdlib/stats/incr/nanmin/benchmark/benchmark.js b/lib/node_modules/@stdlib/stats/incr/nanmin/benchmark/benchmark.js
index ca7d79695018..1f67602e89d4 100644
--- a/lib/node_modules/@stdlib/stats/incr/nanmin/benchmark/benchmark.js
+++ b/lib/node_modules/@stdlib/stats/incr/nanmin/benchmark/benchmark.js
@@ -1,7 +1,7 @@
 /**
 * @license Apache-2.0
 *
-* Copyright (c) 2018 The Stdlib Authors.
+* 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.
diff --git a/lib/node_modules/@stdlib/stats/incr/nanmin/docs/types/index.d.ts b/lib/node_modules/@stdlib/stats/incr/nanmin/docs/types/index.d.ts
index e9423683f39c..bfccd445263d 100644
--- a/lib/node_modules/@stdlib/stats/incr/nanmin/docs/types/index.d.ts
+++ b/lib/node_modules/@stdlib/stats/incr/nanmin/docs/types/index.d.ts
@@ -1,7 +1,7 @@
 /*
 * @license Apache-2.0
 *
-* Copyright (c) 2020 The Stdlib Authors.
+* 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.
diff --git a/lib/node_modules/@stdlib/stats/incr/nanmin/docs/types/test.ts b/lib/node_modules/@stdlib/stats/incr/nanmin/docs/types/test.ts
index 85a557750510..004af50a8865 100644
--- a/lib/node_modules/@stdlib/stats/incr/nanmin/docs/types/test.ts
+++ b/lib/node_modules/@stdlib/stats/incr/nanmin/docs/types/test.ts
@@ -1,7 +1,7 @@
 /*
 * @license Apache-2.0
 *
-* Copyright (c) 2019 The Stdlib Authors.
+* 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.
diff --git a/lib/node_modules/@stdlib/stats/incr/nanmin/examples/index.js b/lib/node_modules/@stdlib/stats/incr/nanmin/examples/index.js
index 4b93977952d3..05ae5857e607 100644
--- a/lib/node_modules/@stdlib/stats/incr/nanmin/examples/index.js
+++ b/lib/node_modules/@stdlib/stats/incr/nanmin/examples/index.js
@@ -1,7 +1,7 @@
 /**
 * @license Apache-2.0
 *
-* Copyright (c) 2018 The Stdlib Authors.
+* 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.
diff --git a/lib/node_modules/@stdlib/stats/incr/nanmin/lib/index.js b/lib/node_modules/@stdlib/stats/incr/nanmin/lib/index.js
index e833c6150b5d..189402040b0c 100644
--- a/lib/node_modules/@stdlib/stats/incr/nanmin/lib/index.js
+++ b/lib/node_modules/@stdlib/stats/incr/nanmin/lib/index.js
@@ -1,7 +1,7 @@
 /**
 * @license Apache-2.0
 *
-* Copyright (c) 2020 The Stdlib Authors.
+* 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.
diff --git a/lib/node_modules/@stdlib/stats/incr/nanmin/lib/main.js b/lib/node_modules/@stdlib/stats/incr/nanmin/lib/main.js
index 918ba2fd3329..6d88be14cdc3 100644
--- a/lib/node_modules/@stdlib/stats/incr/nanmin/lib/main.js
+++ b/lib/node_modules/@stdlib/stats/incr/nanmin/lib/main.js
@@ -1,7 +1,7 @@
 /**
 * @license Apache-2.0
 *
-* Copyright (c) 2018 The Stdlib Authors.
+* 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.
diff --git a/lib/node_modules/@stdlib/stats/incr/nanmin/test/test.js b/lib/node_modules/@stdlib/stats/incr/nanmin/test/test.js
index 927034182034..d11633262024 100644
--- a/lib/node_modules/@stdlib/stats/incr/nanmin/test/test.js
+++ b/lib/node_modules/@stdlib/stats/incr/nanmin/test/test.js
@@ -1,7 +1,7 @@
 /**
 * @license Apache-2.0
 *
-* Copyright (c) 2018 The Stdlib Authors.
+* 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.

From 26c2afa4dcd8a5a39ab723b078367ec29ca59eae Mon Sep 17 00:00:00 2001
From: Abhishek Jain <jainabhishekjain007@gmail.com>
Date: Thu, 13 Mar 2025 21:10:35 +0530
Subject: [PATCH 3/4] update main.js

---
 lib/node_modules/@stdlib/stats/incr/nanmin/lib/main.js | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/lib/node_modules/@stdlib/stats/incr/nanmin/lib/main.js b/lib/node_modules/@stdlib/stats/incr/nanmin/lib/main.js
index 6d88be14cdc3..f0a747c223e9 100644
--- a/lib/node_modules/@stdlib/stats/incr/nanmin/lib/main.js
+++ b/lib/node_modules/@stdlib/stats/incr/nanmin/lib/main.js
@@ -47,7 +47,7 @@ var incrmin = require( '@stdlib/stats/incr/min' );
 * // returns -5.0
 *
 * min = accumulator( 10.1 );
-* returns -5.0
+* // returns -5.0
 *
 * min = accumulator();
 * // returns -5.0

From 6eec4698ca30024aec79a743be4a7858f29bcaaa Mon Sep 17 00:00:00 2001
From: Philipp Burckhardt <pburckhardt@outlook.com>
Date: Sat, 27 Sep 2025 14:43:58 -0500
Subject: [PATCH 4/4] chore: minor clean-up

---
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: passed
  - task: lint_repl_help
    status: na
  - task: lint_javascript_src
    status: passed
  - task: lint_javascript_cli
    status: na
  - task: lint_javascript_examples
    status: passed
  - task: lint_javascript_tests
    status: passed
  - 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: na
  - task: lint_license_headers
    status: passed
---
---
 .../@stdlib/stats/incr/nanmin/README.md       | 23 ++++---------------
 .../stats/incr/nanmin/docs/types/index.d.ts   | 13 ++++++-----
 .../stats/incr/nanmin/examples/index.js       | 21 +++++++----------
 .../@stdlib/stats/incr/nanmin/lib/index.js    | 10 ++++----
 .../@stdlib/stats/incr/nanmin/lib/main.js     |  8 +++----
 .../@stdlib/stats/incr/nanmin/package.json    |  4 +++-
 .../@stdlib/stats/incr/nanmin/test/test.js    |  2 +-
 7 files changed, 33 insertions(+), 48 deletions(-)

diff --git a/lib/node_modules/@stdlib/stats/incr/nanmin/README.md b/lib/node_modules/@stdlib/stats/incr/nanmin/README.md
index 94ba5a86c4a6..c3cf6eee6bfa 100644
--- a/lib/node_modules/@stdlib/stats/incr/nanmin/README.md
+++ b/lib/node_modules/@stdlib/stats/incr/nanmin/README.md
@@ -70,7 +70,7 @@ min = accumulator();
 ## Notes
 
 -   Input values are **not** type checked. If non-numeric inputs are possible, you are advised to type check and handle accordingly **before** passing the value to the accumulator function.
--   If all values provided are `NaN`, the accumulator returns `NaN`.
+-   If all provided values are `NaN`, the accumulator returns `null`.
 
 </section>
 
@@ -81,7 +81,8 @@ min = accumulator();
 ## Examples
 
 ```javascript
-var randu = require( '@stdlib/random/base/randu' );
+var bernoulli = require( '@stdlib/random/base/bernoulli' );
+var uniform = require( '@stdlib/random/base/uniform' );
 var incrnanmin = require( '@stdlib/stats/incr/nanmin' );
 
 var accumulator;
@@ -93,10 +94,10 @@ accumulator = incrnanmin();
 
 // For each simulated datum, update the min...
 for ( i = 0; i < 100; i++ ) {
-    if ( randu() < 0.2 ) {
+    if ( bernoulli( 0.2 ) ) {
         v = NaN;
     } else {
-        v = randu() * 100.0;
+        v = uniform( 0.0, 100.0 );
     }
     accumulator( v );
 }
@@ -111,14 +112,6 @@ console.log( accumulator() );
 
 <section class="related">
 
-* * *
-
-## See Also
-
--   <span class="package-name">[`@stdlib/stats/incr/min`][@stdlib/stats/incr/min]</span><span class="delimiter">: </span><span class="description">compute a minimum value incrementally.</span>
--   <span class="package-name">[`@stdlib/stats/incr/mmin`][@stdlib/stats/incr/mmin]</span><span class="delimiter">: </span><span class="description">compute a moving minimum incrementally.</span>
--   <span class="package-name">[`@stdlib/stats/incr/nanmax`][@stdlib/stats/incr/nanmax]</span><span class="delimiter">: </span><span class="description">compute a maximum value incrementally, ignoring NaN values.</span>
-
 </section>
 
 <!-- /.related -->
@@ -129,12 +122,6 @@ console.log( accumulator() );
 
 <!-- <related-links> -->
 
-[@stdlib/stats/incr/min]: https://github.com/stdlib-js/stdlib/tree/develop/lib/node_modules/%40stdlib/stats/incr/min
-
-[@stdlib/stats/incr/mmin]: https://github.com/stdlib-js/stdlib/tree/develop/lib/node_modules/%40stdlib/stats/incr/mmin
-
-[@stdlib/stats/incr/nanmax]: https://github.com/stdlib-js/stdlib/tree/develop/lib/node_modules/%40stdlib/stats/incr/nanmax
-
 <!-- </related-links> -->
 
 </section>
diff --git a/lib/node_modules/@stdlib/stats/incr/nanmin/docs/types/index.d.ts b/lib/node_modules/@stdlib/stats/incr/nanmin/docs/types/index.d.ts
index bfccd445263d..49acc87a00e9 100644
--- a/lib/node_modules/@stdlib/stats/incr/nanmin/docs/types/index.d.ts
+++ b/lib/node_modules/@stdlib/stats/incr/nanmin/docs/types/index.d.ts
@@ -21,7 +21,8 @@
 /// <reference types="@stdlib/types"/>
 
 /**
-* Returns an accumulator function which incrementally computes a minimum value, ignoring `NaN` values
+* If provided a value, returns an updated minimum value; otherwise, returns the current minimum value.
+*
 * @param x - value
 * @returns minimum value
 */
@@ -38,19 +39,19 @@ type accumulator = ( x?: number ) => number | null;
 * var m = accumulator();
 * // returns null
 *
-* m = accumulator(3.14);
+* m = accumulator( 3.14 );
 * // returns 3.14
 *
-* m = accumulator(NaN);
+* m = accumulator( NaN );
 * // returns 3.14
 *
-* m = accumulator(-5.0);
+* m = accumulator( -5.0 );
 * // returns -5.0
 *
-* m = accumulator(10.1);
+* m = accumulator( 10.1 );
 * // returns -5.0
 *
-* m = accumulator(NaN);
+* m = accumulator( NaN );
 * // returns -5.0
 *
 * m = accumulator();
diff --git a/lib/node_modules/@stdlib/stats/incr/nanmin/examples/index.js b/lib/node_modules/@stdlib/stats/incr/nanmin/examples/index.js
index 05ae5857e607..a632ea95ccf7 100644
--- a/lib/node_modules/@stdlib/stats/incr/nanmin/examples/index.js
+++ b/lib/node_modules/@stdlib/stats/incr/nanmin/examples/index.js
@@ -18,26 +18,21 @@
 
 'use strict';
 
-var randu = require( '@stdlib/random/base/randu' );
+var bernoulli = require( '@stdlib/random/base/bernoulli' );
+var uniform = require( '@stdlib/random/base/uniform' );
 var incrnanmin = require( './../lib' );
 
-var accumulator;
-var min;
-var v;
-var i;
-
 // Initialize an accumulator:
-accumulator = incrnanmin();
+var accumulator = incrnanmin();
 
 // For each simulated datum, update the min...
 console.log( '\nValue\tMin\n' );
+var min;
+var v;
+var i;
 for ( i = 0; i < 100; i++ ) {
-	if ( randu() < 0.2 ) {
-		v = NaN;
-	} else {
-		v = randu() * 100.0;
-	}
+	v = ( bernoulli( 0.2 ) ) ? NaN : uniform( 0.0, 100.0 );
 	min = accumulator( v );
-	console.log( '%d\t%d', v.toFixed( 4 ), ( min === null ) ? NaN : min.toFixed( 4 ) );
+	console.log( '%s\t%s', ( v === v ) ? v.toFixed( 4 ) : 'NaN', ( min === null ) ? 'null' : min.toFixed( 4 ) );
 }
 console.log( '\nFinal min: %d\n', accumulator() );
diff --git a/lib/node_modules/@stdlib/stats/incr/nanmin/lib/index.js b/lib/node_modules/@stdlib/stats/incr/nanmin/lib/index.js
index 189402040b0c..896f9b9917dc 100644
--- a/lib/node_modules/@stdlib/stats/incr/nanmin/lib/index.js
+++ b/lib/node_modules/@stdlib/stats/incr/nanmin/lib/index.js
@@ -24,24 +24,24 @@
 * @module @stdlib/stats/incr/nanmin
 *
 * @example
-* var incrnanmin = require( '@stdlib/stats/incr/nanmin' )
+* var incrnanmin = require( '@stdlib/stats/incr/nanmin' );
 *
 * var accumulator = incrnanmin();
 *
 * var min = accumulator();
 * // returns null
 *
-* min = accumulator(3.14);
+* min = accumulator( 3.14 );
 * // returns 3.14
 *
-* min = accumulator(-5.0);
+* min = accumulator( -5.0 );
 * // returns -5.0
 *
-* min = accumulator(NaN);
+* min = accumulator( NaN );
 * // returns -5.0
 *
 * min = accumulator( 10.1 );
-* returns -5.0
+* // returns -5.0
 *
 * min = accumulator();
 * // returns -5.0
diff --git a/lib/node_modules/@stdlib/stats/incr/nanmin/lib/main.js b/lib/node_modules/@stdlib/stats/incr/nanmin/lib/main.js
index f0a747c223e9..b0a2aa6f44d1 100644
--- a/lib/node_modules/@stdlib/stats/incr/nanmin/lib/main.js
+++ b/lib/node_modules/@stdlib/stats/incr/nanmin/lib/main.js
@@ -37,13 +37,13 @@ var incrmin = require( '@stdlib/stats/incr/min' );
 * var min = accumulator();
 * // returns null
 *
-* min = accumulator(3.14);
+* min = accumulator( 3.14 );
 * // returns 3.14
 *
-* min = accumulator(-5.0);
+* min = accumulator( -5.0 );
 * // returns -5.0
 *
-* min = accumulator(NaN);
+* min = accumulator( NaN );
 * // returns -5.0
 *
 * min = accumulator( 10.1 );
@@ -57,7 +57,7 @@ function incrnanmin() {
 	return accumulator;
 
 	/**
-	* If provided a value, the accumulator function returns an updated minimum value. If not provided a value, the accumulator function returns the current min.
+	* If provided a value, the accumulator function returns an updated minimum value. If not provided a value, the accumulator function returns the current minimum value.
 	*
 	* @private
 	* @param {number} [x] - new value
diff --git a/lib/node_modules/@stdlib/stats/incr/nanmin/package.json b/lib/node_modules/@stdlib/stats/incr/nanmin/package.json
index ee7b4519dbfe..b68751e3f7b1 100644
--- a/lib/node_modules/@stdlib/stats/incr/nanmin/package.json
+++ b/lib/node_modules/@stdlib/stats/incr/nanmin/package.json
@@ -62,6 +62,8 @@
     "domain",
     "extent",
     "incremental",
-    "accumulator"
+    "accumulator",
+    "nan",
+    "ignore"
   ]
 }
diff --git a/lib/node_modules/@stdlib/stats/incr/nanmin/test/test.js b/lib/node_modules/@stdlib/stats/incr/nanmin/test/test.js
index d11633262024..1afc4102fb11 100644
--- a/lib/node_modules/@stdlib/stats/incr/nanmin/test/test.js
+++ b/lib/node_modules/@stdlib/stats/incr/nanmin/test/test.js
@@ -56,7 +56,7 @@ tape( 'the accumulator function incrementally computes a minimum value', functio
 	var d;
 	var i;
 
-	data = [2.0, 3.0, NaN, 1.0, 4.0, NaN, 3.0, 4.0 ];
+	data = [ 2.0, 3.0, NaN, 1.0, 4.0, NaN, 3.0, 4.0 ];
 	N = data.length;
 
 	expected = [];