feat: add math/base/special/versinf

---
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: passed
  - 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: passed
  - task: lint_python
    status: na
  - task: lint_r
    status: na
  - task: lint_c_src
    status: passed
  - task: lint_c_examples
    status: passed
  - task: lint_c_benchmarks
    status: passed
  - 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: anandkaranubc

lib/node_modules/@stdlib/math/base/special/versinf/README.md

@@ -2,7 +2,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.
@@ -20,7 +20,7 @@ limitations under the License.
 
 # Versine
 
-> Compute the [versed sine][versed-sine].
+> Compute the [versed sine][versed-sine] of a single-precision floating-point number (in radians).
 
 <section class="intro">
 
@@ -32,11 +32,6 @@ The [versed sine][versed-sine] is defined as
 \mathop{\mathrm{versin}}(\theta) = 1 - \cos \theta
 ```
 
-<!-- <div class="equation" align="center" data-raw-text="\operatorname{versin}(\theta) = 1 - \cos \theta" data-equation="eq:versine">
-    <img src="https://cdn.jsdelivr.net/gh/stdlib-js/stdlib@bb29798906e119fcb2af99e94b60407a270c9b32/lib/node_modules/@stdlib/math/base/special/versin/docs/img/equation_versine.svg" alt="Versed sine.">
-    <br>
-</div> -->
-
 <!-- </equation> -->
 
 </section>
@@ -48,21 +43,21 @@ The [versed sine][versed-sine] is defined as
 ## Usage
 
 ```javascript
-var versin = require( '@stdlib/math/base/special/versin' );
+var versinf = require( '@stdlib/math/base/special/versinf' );
 ```
 
-#### versin( x )
+#### versinf( x )
 
-Computes the [versed sine][versed-sine] of a `number` (in radians).
+Computes the [versed sine][versed-sine] of a single-precision floating-point number (in radians).
 
 ```javascript
-var v = versin( 0.0 );
+var v = versinf( 0.0 );
 // returns 0.0
 
-v = versin( 3.141592653589793/2.0 );
+v = versinf( 3.141592653589793/2.0 );
 // returns ~1.0
 
-v = versin( -3.141592653589793/6.0 );
+v = versinf( -3.141592653589793/6.0 );
 // returns ~0.13397
 ```
 
@@ -79,15 +74,15 @@ v = versin( -3.141592653589793/6.0 );
 ```javascript
 var uniform = require( '@stdlib/random/array/uniform' );
 var logEachMap = require( '@stdlib/console/log-each-map' );
-var TWO_PI = require( '@stdlib/constants/float64/two-pi' );
-var versin = require( '@stdlib/math/base/special/versin' );
+var TWO_PI = require( '@stdlib/constants/float32/two-pi' );
+var versinf = require( '@stdlib/math/base/special/versinf' );
 
 var opts = {
-    'dtype': 'float64'
+    'dtype': 'float32'
 };
 var x = uniform( 100, 0.0, TWO_PI, opts );
 
-logEachMap( 'versin(%0.4f) = %0.4f', x, versin );
+logEachMap( 'versinf(%0.4f) = %0.4f', x, versinf );
 ```
 
 </section>
@@ -117,27 +112,27 @@ logEachMap( 'versin(%0.4f) = %0.4f', x, versin );
 ### Usage
 
 ```c
-#include "stdlib/math/base/special/versin.h"
+#include "stdlib/math/base/special/versinf.h"
 ```
 
-#### stdlib_base_versin( x )
+#### stdlib_base_versinf( x )
 
-Computes the [versed sine][versed-sine] of a `number` (in radians).
+Computes the [versed sine][versed-sine] of a single-precision floating-point number (in radians).
 
 ```c
-double out = stdlib_base_versin( 0.0 );
-// returns 0.0
+float out = stdlib_base_versinf( 0.0f );
+// returns 0.0f
 
-out = stdlib_base_versin( 3.141592653589793 / 2.0 );
-// returns ~1.0
+out = stdlib_base_versinf( 3.141592653589793f / 2.0f );
+// returns ~1.0f
 ```
 
 The function accepts the following arguments:
 
--   **x**: `[in] double` input value.
+-   **x**: `[in] float` input value.
 
 ```c
-double stdlib_base_versin( const double x );
+float stdlib_base_versinf( const float x );
 ```
 
 </section>
@@ -159,17 +154,17 @@ double stdlib_base_versin( const double x );
 ### Examples
 
 ```c
-#include "stdlib/math/base/special/versin.h"
+#include "stdlib/math/base/special/versinf.h"
 #include <stdio.h>
 
 int main( void ) {
-    const double x[] = { 0.0, 0.523, 0.785, 1.047, 3.14 };
+    const float x[] = { 0.0f, 0.523f, 0.785f, 1.047f, 3.14f };
 
-    double y;
+    float y;
     int i;
     for ( i = 0; i < 5; i++ ) {
-        y = stdlib_base_versin( x[ i ] );
-        printf( "versin(%lf) = %lf\n", x[ i ], y );
+        y = stdlib_base_versinf( x[ i ] );
+        printf( "versinf(%f) = %f\n", x[ i ], y );
     }
 }
 ```
@@ -186,14 +181,6 @@ int main( void ) {
 
 <section class="related">
 
-* * *
-
-## See Also
-
--   <span class="package-name">[`@stdlib/math/base/special/cos`][@stdlib/math/base/special/cos]</span><span class="delimiter">: </span><span class="description">compute the cosine of a number.</span>
--   <span class="package-name">[`@stdlib/math/base/special/sin`][@stdlib/math/base/special/sin]</span><span class="delimiter">: </span><span class="description">compute the sine of a number.</span>
--   <span class="package-name">[`@stdlib/math/base/special/vercos`][@stdlib/math/base/special/vercos]</span><span class="delimiter">: </span><span class="description">compute the versed cosine.</span>
-
 </section>
 
 <!-- /.related -->
@@ -206,12 +193,6 @@ int main( void ) {
 
 <!-- <related-links> -->
 
-[@stdlib/math/base/special/cos]: https://github.com/stdlib-js/stdlib/tree/develop/lib/node_modules/%40stdlib/math/base/special/cos
-
-[@stdlib/math/base/special/sin]: https://github.com/stdlib-js/stdlib/tree/develop/lib/node_modules/%40stdlib/math/base/special/sin
-
-[@stdlib/math/base/special/vercos]: https://github.com/stdlib-js/stdlib/tree/develop/lib/node_modules/%40stdlib/math/base/special/vercos
-
 <!-- </related-links> -->
 
 </section>

lib/node_modules/@stdlib/math/base/special/versinf/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.
@@ -22,9 +22,9 @@
 
 var bench = require( '@stdlib/bench' );
 var uniform = require( '@stdlib/random/array/uniform' );
-var isnan = require( '@stdlib/math/base/assert/is-nan' );
+var isnanf = require( '@stdlib/math/base/assert/is-nanf' );
 var pkg = require( './../package.json' ).name;
-var versin = require( './../lib' );
+var versinf = require( './../lib' );
 
 
 // MAIN //
@@ -34,17 +34,19 @@ bench( pkg, function benchmark( b ) {
 	var y;
 	var i;
 
-	x = uniform( 100, -10.0, 10.0 );
+	x = uniform( 100, -10.0, 10.0, {
+		'dtype': 'float32'
+	});
 
 	b.tic();
 	for ( i = 0; i < b.iterations; i++ ) {
-		y = versin( x[ i % x.length ] );
-		if ( isnan( y ) ) {
+		y = versinf( x[ i%x.length ] );
+		if ( isnanf( y ) ) {
 			b.fail( 'should not return NaN' );
 		}
 	}
 	b.toc();
-	if ( isnan( y ) ) {
+	if ( isnanf( y ) ) {
 		b.fail( 'should not return NaN' );
 	}
 	b.pass( 'benchmark finished' );

lib/node_modules/@stdlib/math/base/special/versinf/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.
@@ -23,16 +23,16 @@
 var resolve = require( 'path' ).resolve;
 var bench = require( '@stdlib/bench' );
 var uniform = require( '@stdlib/random/array/uniform' );
-var isnan = require( '@stdlib/math/base/assert/is-nan' );
+var isnanf = require( '@stdlib/math/base/assert/is-nanf' );
 var tryRequire = require( '@stdlib/utils/try-require' );
 var pkg = require( './../package.json' ).name;
 
 
 // VARIABLES //
 
-var versin = tryRequire( resolve( __dirname, './../lib/native.js' ) );
+var versinf = tryRequire( resolve( __dirname, './../lib/native.js' ) );
 var opts = {
-	'skip': ( versin instanceof Error )
+	'skip': ( versinf instanceof Error )
 };
 
 
@@ -43,17 +43,19 @@ bench( pkg+'::native', opts, function benchmark( b ) {
 	var y;
 	var i;
 
-	x = uniform( 100, -10.0, 10.0 );
+	x = uniform( 100, -10.0, 10.0, {
+		'dtype': 'float32'
+	});
 
 	b.tic();
 	for ( i = 0; i < b.iterations; i++ ) {
-		y = versin( x[ i % x.length ] );
-		if ( isnan( y ) ) {
+		y = versinf( x[ i%x.length ] );
+		if ( isnanf( y ) ) {
 			b.fail( 'should not return NaN' );
 		}
 	}
 	b.toc();
-	if ( isnan( y ) ) {
+	if ( isnanf( y ) ) {
 		b.fail( 'should not return NaN' );
 	}
 	b.pass( 'benchmark finished' );

lib/node_modules/@stdlib/math/base/special/versinf/benchmark/c/Makefile

@@ -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.

lib/node_modules/@stdlib/math/base/special/versinf/benchmark/c/benchmark.c

@@ -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.
@@ -22,7 +22,7 @@
 #include <time.h>
 #include <sys/time.h>
 
-#define NAME "versin"
+#define NAME "versinf"
 #define ITERATIONS 1000000
 #define REPEATS 3
 
@@ -74,13 +74,15 @@ static double tic( void ) {
 }
 
 /**
-* Generates a random number on the interval [0,1).
+* Generates a random number on the interval [min,max).
 *
-* @return random number
+* @param min    minimum value (inclusive)
+* @param max    maximum value (exclusive)
+* @return       random number
 */
-static double rand_double( void ) {
-	int r = rand();
-	return (double)r / ( (double)RAND_MAX + 1.0 );
+static float random_uniform( const float min, const float max ) {
+	float v = (float)rand() / ( (float)RAND_MAX + 1.0f );
+	return min + ( v*(max-min) );
 }
 
 /**
@@ -89,19 +91,19 @@ static double rand_double( void ) {
 * @return elapsed time in seconds
 */
 static double benchmark( void ) {
-	double x[ 100 ];
+	float x[ 100 ];
 	double elapsed;
-	double y;
 	double t;
+	float y;
 	int i;
 
 	for ( i = 0; i < 100; i++ ) {
-		x[ i ] = ( 20.0*rand_double() ) - 10.0;
+		x[ i ] = random_uniform( -10.0f, 10.0f );
 	}
 
 	t = tic();
 	for ( i = 0; i < ITERATIONS; i++ ) {
-		y = 1.0 - cos( x[ i%100 ] );
+		y = 1.0f - cosf( x[ i%100 ] );
 		if ( y != y ) {
 			printf( "should not return NaN\n" );
 			break;

lib/node_modules/@stdlib/math/base/special/versinf/benchmark/c/native/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.