feat: add math/base/special/kernel-tanf

---
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/kernel-tanf/README.md

@@ -2,7 +2,7 @@
 
 @license Apache-2.0
 
-Copyright (c) 2022 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.
@@ -18,80 +18,54 @@ limitations under the License.
 
 -->
 
-# kernelTan
+# kernelTanf
 
-> Compute the [tangent][tangent] of a double-precision floating-point number on `[-π/4, π/4]`.
+> Compute the [tangent][tangent] of a number on `[-π/4, π/4]` in single-precision floating-point format.
 
 <section class="usage">
 
 ## Usage
 
 ```javascript
-var kernelTan = require( '@stdlib/math/base/special/kernel-tan' );
+var kernelTanf = require( '@stdlib/math/base/special/kernel-tanf' );
 ```
 
-#### kernelTan( x, y, k )
+#### kernelTanf( x, iy )
 
-Computes the [tangent][tangent] of a double-precision floating-point number on `[-π/4, π/4]`.
+Computes the [tangent][tangent] of a number on `[-π/4, π/4]` in single-precision floating-point format.
 
 ```javascript
-var out = kernelTan( 3.141592653589793/4.0, 0.0, 1 );
+var out = kernelTanf( 3.141592653589793/4.0, 1 );
 // returns ~1.0
 
-out = kernelTan( 3.141592653589793/6.0, 0.0, 1 );
+out = kernelTanf( 3.141592653589793/6.0, 1 );
 // returns ~0.577
 
-out = kernelTan( 0.664, 5.288e-17, 1 );
+out = kernelTanf( 0.664, 1 );
 // returns ~0.783
 ```
 
-If `k = 1`, the function returns `tan(x+y)`. To return the negative inverse `-1/tan(x+y)`, set `k = -1`.
+If `k = 1`, the function returns `tan(x)`. To return the negative inverse `-1/tan(x)`, set `k = -1`.
 
 ```javascript
-var out = kernelTan( 3.141592653589793/4.0, 0.0, -1 );
+var out = kernelTanf( 3.141592653589793/4.0, -1 );
 // returns ~-1.0
 ```
 
-If either `x` or `y` is `NaN`, the function returns `NaN`.
+If provided `NaN` for `x`, the function returns `NaN`.
 
 ```javascript
-var out = kernelTan( NaN, 0.0, 1 );
+var out = kernelTanf( NaN, 1 );
 // returns NaN
 
-out = kernelTan( 3.0, NaN, 1 );
-// returns NaN
-
-out = kernelTan( NaN, NaN, 1 );
+out = kernelTanf( NaN, -1 );
 // returns NaN
 ```
 
 </section>
 
 <!-- /.usage -->
 
-<section class="notes">
-
-## Notes
-
--   For increased accuracy, the number for which the [tangent][tangent] should be evaluated can be supplied as a [double-double number][double-double-arithmetic] (i.e., a non-evaluated sum of two [double-precision floating-point numbers][ieee754] `x` and `y`).
-
--   As components of a [double-double number][double-double-arithmetic], the two [double-precision floating-point numbers][ieee754] `x` and `y` must satisfy
-
-    <!-- <equation class="equation" label="eq:double_double_inequality" align="center" raw="|y| \leq \frac{1}{2} \operatorname{ulp}(x)" alt="Inequality for the two components of a double-double number."> -->
-
-    <div class="equation" align="center" data-raw-text="|y| \leq \frac{1}{2} \operatorname{ulp}(x)" data-equation="eq:double_double_inequality">
-        <img src="https://cdn.jsdelivr.net/gh/stdlib-js/stdlib@bb29798906e119fcb2af99e94b60407a270c9b32/lib/node_modules/@stdlib/math/base/special/kernel-tan/docs/img/equation_double_double_inequality.svg" alt="Inequality for the two components of a double-double number.">
-        <br>
-    </div>
-
-    <!-- </equation> -->
-
-    where `ulp` stands for [units in the last place][ulp].
-
-</section>
-
-<!-- /.notes -->
-
 <section class="examples">
 
 ## Examples
@@ -100,22 +74,13 @@ out = kernelTan( NaN, NaN, 1 );
 
 ```javascript
 var linspace = require( '@stdlib/array/base/linspace' );
-var binomial = require( '@stdlib/random/base/binomial' ).factory;
-var PI = require( '@stdlib/constants/float64/pi' );
-var kernelTan = require( '@stdlib/math/base/special/kernel-tan' );
+var PI = require( '@stdlib/constants/float32/pi' );
+var logEachMap = require( '@stdlib/console/log-each-map' );
+var kernelTanf = require( '@stdlib/math/base/special/kernel-tanf' );
 
 var x = linspace( -PI/4.0, PI/4.0, 100 );
-var rbinom = binomial( 1, 0.5 );
-
-var descr;
-var i;
-var k;
 
-for ( i = 0; i < x.length; i++ ) {
-    k = rbinom();
-    descr = ( k === 1 ) ? 'tan(%d) = %d' : '-1/tan(%d) = %d';
-    console.log( descr, x[ i ], kernelTan( x[ i ], 0.0, k ) );
-}
+logEachMap( 'kernelTanf(%0.4f, %d) = %0.4f', x, 1, kernelTanf );
 ```
 
 </section>
@@ -145,29 +110,28 @@ for ( i = 0; i < x.length; i++ ) {
 ### Usage
 
 ```c
-#include "stdlib/math/base/special/kernel_tan.h"
+#include "stdlib/math/base/special/kernel_tanf.h"
 ```
 
-#### stdlib_base_kernel_tan( x, y, k)
+#### stdlib_base_kernel_tanf( x, iy )
 
-Computes the [tangent][tangent] of a double-precision floating-point number on `[-π/4, π/4]`.
+Computes the [tangent][tangent] of a number on `[-π/4, π/4]` in single-precision floating-point format.
 
 ```c
-double out = stdlib_base_kernel_tan( 3.141592653589793/4.0, 0.0, 1 );
-// returns ~1.0
+float out = stdlib_base_kernel_tanf( 3.141592653589793/4.0, 1 );
+// returns ~1.0f
 
-out = stdlib_base_kernel_tan( 3.141592653589793/6.0, 0.0, 1 );
-// returns ~0.577
+out = stdlib_base_kernel_tanf( 3.141592653589793/6.0, 1 );
+// returns ~0.577f
 ```
 
 The function accepts the following arguments:
 
 -   **x**: `[in] double` input value (in radians, assumed to be bounded by `~pi/4` in magnitude).
--   **y**: `[in] double` tail of `x`.
--   **k**: `[in] int32_t` indicates whether `tan(x+y)` (if `k = 1`) or `-1/tan(x+y)` (if `k = -1`) is returned.
+-   **iy**: `[in] int32_t` indicates whether `tan(x)` (if `iy = 1`) or `-1/tan(x)` (if `iy = -1`) is returned.
 
 ```c
-double stdlib_base_kernel_tan( const double x, const double y, const int32_t k );
+float stdlib_base_kernel_tanf( const double x, const int32_t iy );
 ```
 
 </section>
@@ -178,10 +142,6 @@ double stdlib_base_kernel_tan( const double x, const double y, const int32_t k )
 
 <section class="notes">
 
-### Notes
-
--   For increased accuracy, the number for which the [tangent][tangent] should be evaluated can be supplied as a [double-double number][double-double-arithmetic] (i.e., a non-evaluated sum of two [double-precision floating-point numbers][ieee754] `x` and `y`).
-
 </section>
 
 <!-- /.notes -->
@@ -193,17 +153,17 @@ double stdlib_base_kernel_tan( const double x, const double y, const int32_t k )
 ### Examples
 
 ```c
-#include "stdlib/math/base/special/kernel_tan.h"
+#include "stdlib/math/base/special/kernel_tanf.h"
 #include <stdio.h>
 
 int main( void ) {
     const double x[] = { -0.7853981633974483, -0.6108652381980153, -0.4363323129985824, -0.26179938779914946, -0.08726646259971649, 0.08726646259971649, 0.26179938779914935, 0.43633231299858233, 0.6108652381980153, 0.7853981633974483 };
 
-    double out;
+    float out;
     int i;
     for ( i = 0; i < 10; i++ ) {
-        out = stdlib_base_kernel_tan( x[ i ], 0.0, 1 );
-        printf( "tan(%lf) = %lf\n", x[ i ], out );
+        out = stdlib_base_kernel_tanf( x[ i ], 1 );
+        printf( "kernelTanf(%lf, %d) = %f\n", x[ i ], 1, out );
     }
 }
 ```
@@ -220,14 +180,6 @@ int main( void ) {
 
 <section class="related">
 
-* * *
-
-## See Also
-
--   <span class="package-name">[`@stdlib/math/base/special/kernel-cos`][@stdlib/math/base/special/kernel-cos]</span><span class="delimiter">: </span><span class="description">compute the cosine of a double-precision floating-point number on \[-π/4, π/4].</span>
--   <span class="package-name">[`@stdlib/math/base/special/kernel-sin`][@stdlib/math/base/special/kernel-sin]</span><span class="delimiter">: </span><span class="description">compute the sine of a double-precision floating-point number on \[-π/4, π/4].</span>
--   <span class="package-name">[`@stdlib/math/base/special/tan`][@stdlib/math/base/special/tan]</span><span class="delimiter">: </span><span class="description">evaluate the tangent of a number.</span>
-
 </section>
 
 <!-- /.related -->
@@ -238,20 +190,8 @@ int main( void ) {
 
 [tangent]: https://en.wikipedia.org/wiki/Tangent
 
-[double-double-arithmetic]: https://en.wikipedia.org/wiki/Quadruple-precision_floating-point_format#Double-double_arithmetic
-
-[ieee754]: https://en.wikipedia.org/wiki/IEEE_floating_point
-
-[ulp]: https://en.wikipedia.org/wiki/Unit_in_the_last_place
-
 <!-- <related-links> -->
 
-[@stdlib/math/base/special/kernel-cos]: https://github.com/stdlib-js/stdlib/tree/develop/lib/node_modules/%40stdlib/math/base/special/kernel-cos
-
-[@stdlib/math/base/special/kernel-sin]: https://github.com/stdlib-js/stdlib/tree/develop/lib/node_modules/%40stdlib/math/base/special/kernel-sin
-
-[@stdlib/math/base/special/tan]: https://github.com/stdlib-js/stdlib/tree/develop/lib/node_modules/%40stdlib/math/base/special/tan
-
 <!-- </related-links> -->
 
 </section>

lib/node_modules/@stdlib/math/base/special/kernel-tanf/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,10 +22,10 @@
 
 var bench = require( '@stdlib/bench' );
 var linspace = require( '@stdlib/array/base/linspace' );
-var isnan = require( '@stdlib/math/base/assert/is-nan' );
-var PI = require( '@stdlib/constants/float64/pi' );
+var isnanf = require( '@stdlib/math/base/assert/is-nanf' );
+var PI = require( '@stdlib/constants/float32/pi' );
 var pkg = require( './../package.json' ).name;
-var kernelTan = require( './../lib' );
+var kernelTanf = require( './../lib' );
 
 
 // MAIN //
@@ -41,13 +41,13 @@ bench( pkg+':k=1', function benchmark( b ) {
 
 	b.tic();
 	for ( i = 0; i < b.iterations; i++ ) {
-		y = kernelTan( x[ i % len ], 0.0, 1 );
-		if ( isnan( y ) ) {
+		y = kernelTanf( x[ i%len ], 1 );
+		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' );
@@ -65,13 +65,13 @@ bench( pkg+':k=-1', function benchmark( b ) {
 
 	b.tic();
 	for ( i = 0; i < b.iterations; i++ ) {
-		y = kernelTan( x[ i % len ], 0.0, -1 );
-		if ( isnan( y ) ) {
+		y = kernelTanf( x[ i%len ], -1 );
+		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/kernel-tanf/benchmark/benchmark.native.js

@@ -1,7 +1,7 @@
 /**
 * @license Apache-2.0
 *
-* Copyright (c) 2022 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,17 +23,17 @@
 var resolve = require( 'path' ).resolve;
 var bench = require( '@stdlib/bench' );
 var linspace = require( '@stdlib/array/base/linspace' );
-var isnan = require( '@stdlib/math/base/assert/is-nan' );
-var PI = require( '@stdlib/constants/float64/pi' );
+var isnanf = require( '@stdlib/math/base/assert/is-nanf' );
+var PI = require( '@stdlib/constants/float32/pi' );
 var tryRequire = require( '@stdlib/utils/try-require' );
 var pkg = require( './../package.json' ).name;
 
 
 // VARIABLES //
 
-var kernelTan = tryRequire( resolve( __dirname, './../lib/native.js' ) );
+var kernelTanf = tryRequire( resolve( __dirname, './../lib/native.js' ) );
 var opts = {
-	'skip': ( kernelTan instanceof Error )
+	'skip': ( kernelTanf instanceof Error )
 };
 
 
@@ -50,13 +50,13 @@ bench( pkg+'::native:k=1', opts, function benchmark( b ) {
 
 	b.tic();
 	for ( i = 0; i < b.iterations; i++ ) {
-		y = kernelTan( x[ i % len ], 0.0, 1 );
-		if ( isnan( y ) ) {
+		y = kernelTanf( x[ i%len ], 1 );
+		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' );
@@ -74,13 +74,13 @@ bench( pkg+'::native:k=-1', opts, function benchmark( b ) {
 
 	b.tic();
 	for ( i = 0; i < b.iterations; i++ ) {
-		y = kernelTan( x[ i % len ], 0.0, -1 );
-		if ( isnan( y ) ) {
+		y = kernelTanf( x[ i%len ], -1 );
+		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/kernel-tanf/benchmark/c/native/Makefile

@@ -1,7 +1,7 @@
 #/
 # @license Apache-2.0
 #
-# Copyright (c) 2022 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.