feat: added new implementation and other minor updates

Author: 0PrashantYadav0

lib/node_modules/@stdlib/stats/base/dists/binomial/mode/README.md

@@ -169,20 +169,20 @@ for ( i = 0; i < 10; i++ ) {
 
 #### stdlib_base_dists_binomial_mode( n, p )
 
-Returns the [mode][mode] of a [binomial][binomial-distribution] distribution with parameters `n` (number of trials) and `p` (success probability).
+Returns the [mode][mode] of a [binomial][binomial-distribution] distribution with number of trials `n` and success probability `p`.
 
 ```c
-double out = stdlib_base_dists_binomial_mode( 10, 0.5 );
-// returns 5
+double out = stdlib_base_dists_binomial_mode( 100, 0.1 );
+// returns 10
 ```
 
 The function accepts the following arguments:
 
--   **n**: `[in] int` number of trials.
+-   **n**: `[in] int32_t` number of trials.
 -   **p**: `[in] double` success probability.
 
 ```c
-double stdlib_base_dists_binomial_mode( const int n, const double p );
+double stdlib_base_dists_binomial_mode( const int32_t n, const double p );
 ```
 
 </section>
@@ -205,25 +205,30 @@ double stdlib_base_dists_binomial_mode( const int n, const double p );
 
 ```c
 #include "stdlib/stats/base/dists/binomial/mode.h"
+#include "stdlib/math/base/special/ceil.h"
 #include <stdlib.h>
+#include <stdint.h>
 #include <stdio.h>
 
 static double random_uniform( const double min, const double max ) {
     double v = (double)rand() / ( (double)RAND_MAX + 1.0 );
-    return min + ( v*(max-min) );
+    return min + ( v * (max - min) );
 }
 
 int main( void ) {
-    int n;
+    int32_t n;
     double p;
     double y;
     int i;
+
     for ( i = 0; i < 25; i++ ) {
-        n = (int)( random_uniform( 1.0, 20.0 ) );
+        n = stdlib_base_ceil( random_uniform( 0.0, 100.0 ) );
         p = random_uniform( 0.0, 1.0 );
         y = stdlib_base_dists_binomial_mode( n, p );
         printf( "n: %d, p: %lf, mode(X;n,p): %lf\n", n, p, y );
     }
+
+    return 0;
 }
 ```
 

lib/node_modules/@stdlib/stats/base/dists/binomial/mode/benchmark/benchmark.js

@@ -1,7 +1,7 @@
 /**
 * @license Apache-2.0
 *
-* Copyright (c) 2024 The Stdlib Authors.
+* 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.
@@ -21,9 +21,10 @@
 // MODULES //
 
 var bench = require( '@stdlib/bench' );
-var randu = require( '@stdlib/random/base/randu' );
+var ceil = require( '@stdlib/math/base/special/ceil' );
+var Int32Array = require( '@stdlib/array/int32' );
 var Float64Array = require( '@stdlib/array/float64' );
-var floor = require( '@stdlib/math/base/special/floor' );
+var randu = require( '@stdlib/random/base/randu' );
 var isnan = require( '@stdlib/math/base/assert/is-nan' );
 var pkg = require( './../package.json' ).name;
 var mode = require( './../lib' );
@@ -39,10 +40,10 @@ bench( pkg, function benchmark( b ) {
 	var i;
 
 	len = 100;
-	n = new Float64Array( len );
+	n = new Int32Array( len );
 	p = new Float64Array( len );
 	for ( i = 0; i < len; i++ ) {
-		n[ i ] = floor( ( randu()*100.0 ) + 1.0 );
+		n[ i ] = ceil( randu() * 100.0 );
 		p[ i ] = randu();
 	}
 

lib/node_modules/@stdlib/stats/base/dists/binomial/mode/benchmark/benchmark.native.js

@@ -1,7 +1,7 @@
 /**
 * @license Apache-2.0
 *
-* Copyright (c) 2024 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.
@@ -22,11 +22,12 @@
 
 var resolve = require( 'path' ).resolve;
 var bench = require( '@stdlib/bench' );
+var Int32Array = require( '@stdlib/array/int32' );
 var Float64Array = require( '@stdlib/array/float64' );
-var floor = require( '@stdlib/math/base/special/floor' );
+var tryRequire = require( '@stdlib/utils/try-require' );
+var ceil = require( '@stdlib/math/base/special/ceil' );
 var randu = require( '@stdlib/random/base/randu' );
 var isnan = require( '@stdlib/math/base/assert/is-nan' );
-var tryRequire = require( '@stdlib/utils/try-require' );
 var pkg = require( './../package.json' ).name;
 
 
@@ -48,11 +49,11 @@ bench( pkg+'::native', opts, function benchmark( b ) {
 	var i;
 
 	len = 100;
-	n = new Float64Array( len );
+	n = new Int32Array( len );
 	p = new Float64Array( len );
 	for ( i = 0; i < len; i++ ) {
-		n[ i ] = floor( ( randu()*100.0 ) + 1.0 ); // Ensure n >= 1
-		p[ i ] = randu(); // Ensure p in [0, 1]
+		n[ i ] = ceil( randu() * 100.0 );
+		p[ i ] = randu();
 	}
 
 	b.tic();

lib/node_modules/@stdlib/stats/base/dists/binomial/mode/benchmark/c/Makefile

@@ -1,7 +1,7 @@
 #/
 # @license Apache-2.0
 #
-# Copyright (c) 2024 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.
@@ -143,4 +143,4 @@ run: $(c_targets)
 clean:
 	$(QUIET) -rm -f *.o *.out
 
-.PHONY: clean
+.PHONY: clean

lib/node_modules/@stdlib/stats/base/dists/binomial/mode/benchmark/c/benchmark.c

@@ -1,7 +1,7 @@
 /**
 * @license Apache-2.0
 *
-* Copyright (c) 2024 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.
@@ -17,7 +17,9 @@
 */
 
 #include "stdlib/stats/base/dists/binomial/mode.h"
+#include "stdlib/math/base/special/ceil.h"
 #include <stdlib.h>
+#include <stdint.h>
 #include <stdio.h>
 #include <math.h>
 #include <time.h>
@@ -37,8 +39,8 @@ static void print_version( void ) {
 /**
 * Prints the TAP summary.
 *
-* @param total     total number of tests
-* @param passing   total number of passing tests
+* @param total    total number of tests
+* @param passing  total number of passing tests
 */
 static void print_summary( int total, int passing ) {
 	printf( "#\n" );
@@ -52,7 +54,7 @@ static void print_summary( int total, int passing ) {
 /**
 * Prints benchmarks results.
 *
-* @param elapsed   elapsed time in seconds
+* @param elapsed    elapsed time in seconds
 */
 static void print_results( double elapsed ) {
 	double rate = (double)ITERATIONS / elapsed;
@@ -93,20 +95,20 @@ static double random_uniform( const double min, const double max ) {
 */
 static double benchmark( void ) {
 	double elapsed;
-	double n[ 100 ];
+	int32_t n[ 100 ];
 	double p[ 100 ];
 	double y;
 	double t;
 	int i;
 
 	for ( i = 0; i < 100; i++ ) {
-		n[ i ] = random_uniform( 1.0, 100.0 ); // Ensure n >= 1
-		p[ i ] = random_uniform( 0.0, 1.0 );  // Ensure p in [0, 1]
+		n[ i ] = stdlib_base_ceil( random_uniform( 0.0, 100.0 ) );
+		p[ i ] = random_uniform( 0.0, 1.0 );
 	}
 
 	t = tic();
 	for ( i = 0; i < ITERATIONS; i++ ) {
-		y = stdlib_base_dists_binomial_mode( n[ i%100 ], p[ i%100 ] );
+		y = stdlib_base_dists_binomial_mode( n[ i % 100 ], p[ i % 100 ] );
 		if ( y != y ) {
 			printf( "should not return NaN\n" );
 			break;

lib/node_modules/@stdlib/stats/base/dists/binomial/mode/binding.gyp

@@ -1,6 +1,6 @@
 # @license Apache-2.0
 #
-# Copyright (c) 2024 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.
@@ -167,4 +167,4 @@
       ], # end actions
     }, # end target copy_addon
   ], # end targets
-}
+}

lib/node_modules/@stdlib/stats/base/dists/binomial/mode/examples/c/Makefile

@@ -1,7 +1,7 @@
 #/
 # @license Apache-2.0
 #
-# Copyright (c) 2024 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.
@@ -143,4 +143,4 @@ run: $(c_targets)
 clean:
 	$(QUIET) -rm -f *.o *.out
 
-.PHONY: clean
+.PHONY: clean

lib/node_modules/@stdlib/stats/base/dists/binomial/mode/examples/c/example.c

@@ -1,7 +1,7 @@
 /**
 * @license Apache-2.0
 *
-* Copyright (c) 2024 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.
@@ -17,25 +17,28 @@
 */
 
 #include "stdlib/stats/base/dists/binomial/mode.h"
+#include "stdlib/math/base/special/ceil.h"
 #include <stdlib.h>
+#include <stdint.h>
 #include <stdio.h>
-#include <math.h>
 
 static double random_uniform( const double min, const double max ) {
 	double v = (double)rand() / ( (double)RAND_MAX + 1.0 );
-	return min + ( v*(max-min) );
+	return min + ( v * (max - min) );
 }
 
 int main( void ) {
+	int32_t n;
 	double p;
-	double n;
 	double y;
 	int i;
 
 	for ( i = 0; i < 25; i++ ) {
-		n = (double)floor(random_uniform( 1.0, 101.0 ));
+		n = stdlib_base_ceil( random_uniform( 0.0, 100.0 ) );
 		p = random_uniform( 0.0, 1.0 );
 		y = stdlib_base_dists_binomial_mode( n, p );
-		printf( "n: %lf, p: %lf, mode(X;n,p): %lf\n", n, p, y );
+		printf( "n: %d, p: %lf, mode(X;n,p): %lf\n", n, p, y );
 	}
+
+	return 0;
 }

lib/node_modules/@stdlib/stats/base/dists/binomial/mode/include.gypi

@@ -1,6 +1,6 @@
 # @license Apache-2.0
 #
-# Copyright (c) 2024 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.
@@ -50,4 +50,4 @@
       '<!@(node -e "var arr = require(\'@stdlib/utils/library-manifest\')(\'./manifest.json\',{},{\'basedir\':process.cwd(),\'paths\':\'posix\'}).libpath; for ( var i = 0; i < arr.length; i++ ) { console.log( arr[ i ] ); }")',
     ],
   }, # end variables
-}
+}

lib/node_modules/@stdlib/stats/base/dists/binomial/mode/include/stdlib/stats/base/dists/binomial/mode.h

@@ -1,7 +1,7 @@
 /**
 * @license Apache-2.0
 *
-* Copyright (c) 2024 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.
@@ -19,6 +19,8 @@
 #ifndef STDLIB_STATS_BASE_DISTS_BINOMIAL_MODE_H
 #define STDLIB_STATS_BASE_DISTS_BINOMIAL_MODE_H
 
+#include <stdint.h>
+
 /*
 * If C++, prevent name mangling so that the compiler emits a binary file having undecorated names, thus mirroring the behavior of a C compiler.
 */
@@ -27,13 +29,9 @@ extern "C" {
 #endif
 
 /**
-* Returns the mode of a binomial distribution.
-*
-* @param n     number of trials (non-negative integer)
-* @param p     success probability (0 <= p <= 1)
-* @return      mode of the binomial distribution
+* Returns the mode of a binomial distribution with number of trials `n` and success probability `p`.
 */
-double stdlib_base_dists_binomial_mode( const double n, const double p );
+double stdlib_base_dists_binomial_mode( const int32_t n, const double p );
 
 #ifdef __cplusplus
 }