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

---
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: 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-cosf/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.
@@ -60,15 +60,13 @@ v = kernelCosf( NaN );
 
 ```javascript
 var linspace = require( '@stdlib/array/base/linspace' );
+var logEachMap = require( '@stdlib/console/log-each-map' );
 var PI = require( '@stdlib/constants/float64/pi' );
 var kernelCosf = require( '@stdlib/math/base/special/kernel-cosf' );
 
 var x = linspace( -PI/4.0, PI/4.0, 100 );
 
-var i;
-for ( i = 0; i < x.length; i++ ) {
-    console.log( 'kernelCosf(%d) = %d', x[ i ], kernelCosf( x[ i ] ) );
-}
+logEachMap( 'kernelCosf(%0.4f) = %0.4f', x, kernelCosf );
 ```
 
 </section>
@@ -106,19 +104,19 @@ for ( i = 0; i < x.length; i++ ) {
 Computes the [cosine][cosine] of a single-precision floating-point number on `[-π/4, π/4]`.
 
 ```c
-float v = stdlib_base_kernel_cosf( 0.0f );
+float v = stdlib_base_kernel_cosf( 0.0 );
 // returns ~0.0f
 
-v = stdlib_base_kernel_cosf( 3.141592653589793/6.0f );
+v = stdlib_base_kernel_cosf( 3.141592653589793/6.0 );
 // returns ~0.866f
 ```
 
 The function accepts the following arguments:
 
--   **x**: `[in] float` input value (in radians, assumed to be bounded by `~pi/4` in magnitude).
+-   **x**: `[in] double` input value (in radians, assumed to be bounded by `~pi/4` in magnitude).
 
 ```c
-float stdlib_base_kernel_cosf( const float x );
+float stdlib_base_kernel_cosf( const double x );
 ```
 
 </section>
@@ -144,13 +142,13 @@ float stdlib_base_kernel_cosf( const float x );
 #include <stdio.h>
 
 int main( void ) {
-    const float x[] = { -0.7853981633974483f, -0.6108652381980153f, -0.4363323129985824f, -0.26179938779914946f, -0.08726646259971649f, 0.08726646259971649f, 0.26179938779914935f, 0.43633231299858233f, 0.6108652381980153f, 0.7853981633974483f };
+    const double x[] = { -0.7853981633974483, -0.6108652381980153, -0.4363323129985824, -0.26179938779914946, -0.08726646259971649, 0.08726646259971649, 0.26179938779914935, 0.43633231299858233, 0.6108652381980153, 0.7853981633974483 };
 
-    float v;
+    float out;
     int i;
     for ( i = 0; i < 10; i++ ) {
-        v = stdlib_base_kernel_cosf( x[ i ] );
-        printf( "kernelCosf(%f) = %f\n", x[ i ], v );
+        out = stdlib_base_kernel_cosf( x[ i ] );
+        printf ( "x[ i ]: %lf, out: %f\n", x[ i ], out );
     }
 }
 ```

lib/node_modules/@stdlib/math/base/special/kernel-cosf/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,7 +22,7 @@
 
 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 PI = require( '@stdlib/constants/float64/pi' );
 var pkg = require( './../package.json' ).name;
 var kernelCosf = require( './../lib' );
@@ -35,19 +35,17 @@ bench( pkg, function benchmark( b ) {
 	var y;
 	var i;
 
-	x = uniform( 100, -PI/4.0, PI/4.0, {
-		'dtype': 'float32'
-	});
+	x = uniform( 100, -PI/4.0, PI/4.0 );
 
 	b.tic();
 	for ( i = 0; i < b.iterations; i++ ) {
-		y = kernelCosf( x[ i % x.length ] );
-		if ( isnan( y ) ) {
+		y = kernelCosf( 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/kernel-cosf/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,7 +23,7 @@
 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 PI = require( '@stdlib/constants/float64/pi' );
 var tryRequire = require( '@stdlib/utils/try-require' );
 var pkg = require( './../package.json' ).name;
@@ -44,19 +44,17 @@ bench( pkg+'::native', opts, function benchmark( b ) {
 	var y;
 	var i;
 
-	x = uniform( 100, -PI/4.0, PI/4.0, {
-		'dtype': 'float32'
-	});
+	x = uniform( 100, -PI/4.0, PI/4.0 );
 
 	b.tic();
 	for ( i = 0; i < b.iterations; i++ ) {
-		y = kernelCosf( x[ i % x.length ] );
-		if ( isnan( y ) ) {
+		y = kernelCosf( 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/kernel-cosf/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.
@@ -88,15 +88,15 @@ c_targets := benchmark.out
 # RULES #
 
 #/
-# Compiles source files.
+# Compiles C source files.
 #
-# @param {string} [C_COMPILER] - C compiler (e.g., `gcc`)
-# @param {string} [CFLAGS] - C compiler options
-# @param {(string|void)} [fPIC] - compiler flag determining whether to generate position independent code (e.g., `-fPIC`)
-# @param {string} [INCLUDE] - list of includes (e.g., `-I /foo/bar -I /beep/boop/include`)
-# @param {string} [SOURCE_FILES] - list of source files
+# @param {string} SOURCE_FILES - list of C source files
+# @param {string} [INCLUDE] - list of includes (e.g., `-I /foo/bar -I /beep/boop`)
+# @param {string} [LIBRARIES] - list of libraries (e.g., `-lpthread -lblas`)
 # @param {string} [LIBPATH] - list of library paths (e.g., `-L /foo/bar -L /beep/boop`)
-# @param {string} [LIBRARIES] - list of libraries (e.g., `-lopenblas -lpthread`)
+# @param {string} [C_COMPILER] - C compiler
+# @param {string} [CFLAGS] - C compiler flags
+# @param {(string|void)} [fPIC] - compiler flag indicating whether to generate position independent code
 #
 # @example
 # make
@@ -112,13 +112,13 @@ all: $(c_targets)
 # Compiles C source files.
 #
 # @private
-# @param {string} CC - C compiler (e.g., `gcc`)
-# @param {string} CFLAGS - C compiler options
-# @param {(string|void)} fPIC - compiler flag determining whether to generate position independent code (e.g., `-fPIC`)
-# @param {string} INCLUDE - list of includes (e.g., `-I /foo/bar`)
-# @param {string} SOURCE_FILES - list of source files
-# @param {string} LIBPATH - list of library paths (e.g., `-L /foo/bar`)
-# @param {string} LIBRARIES - list of libraries (e.g., `-lopenblas`)
+# @param {string} SOURCE_FILES - list of C source files
+# @param {(string|void)} INCLUDE - list of includes (e.g., `-I /foo/bar -I /beep/boop`)
+# @param {(string|void)} LIBRARIES - list of libraries (e.g., `-lpthread -lblas`)
+# @param {(string|void)} LIBPATH - list of library paths (e.g., `-L /foo/bar -L /beep/boop`)
+# @param {string} CC - C compiler
+# @param {string} CFLAGS - C compiler flags
+# @param {(string|void)} fPIC - compiler flag indicating whether to generate position independent code
 #/
 $(c_targets): %.out: %.c
 	$(QUIET) $(CC) $(CFLAGS) $(fPIC) $(INCLUDE) -o $@ $(SOURCE_FILES) $< $(LIBPATH) -lm $(LIBRARIES)
@@ -144,4 +144,3 @@ clean:
 	$(QUIET) -rm -f *.o *.out
 
 .PHONY: clean
-

lib/node_modules/@stdlib/math/base/special/kernel-cosf/benchmark/c/native/benchmark.c

@@ -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.
@@ -79,9 +79,9 @@ static double tic( void ) {
 *
 * @return random number
 */
-static float rand_float( void ) {
+static double rand_double( void ) {
 	int r = rand();
-	return (float)r / ( (float)RAND_MAX + 1.0f );
+	return (double)r / ( (double)RAND_MAX + 1.0 );
 }
 
 /**
@@ -90,14 +90,14 @@ static float rand_float( void ) {
 * @return elapsed time in seconds
 */
 static double benchmark( void ) {
-	float x[ 100 ];
 	double elapsed;
-	double z;
+	double x[ 100 ];
 	double t;
+	float z;
 	int i;
 
 	for ( i = 0; i < 100; i++ ) {
-		x[ i ] = ( ( rand_float()*2.0f ) - 1.0f ) * 0.7853981633974483f;
+		x[ i ] = ( ( rand_double()*2.0 ) - 1.0 ) * 0.7853981633974483;
 	}
 
 	t = tic();

lib/node_modules/@stdlib/math/base/special/kernel-cosf/binding.gyp

@@ -1,6 +1,6 @@
 # @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.

lib/node_modules/@stdlib/math/base/special/kernel-cosf/docs/repl.txt

@@ -1,36 +1,27 @@
 
-{{alias}}( x, y )
-    Computes the cosine of a double-precision floating-point number on the
+{{alias}}( x )
+    Computes the cosine of a single-precision floating-point number on the
     interval [-π/4, π/4].
 
-    For increased accuracy, the number for which the cosine should be evaluated
-    can be supplied as a double-double number (i.e., a non-evaluated sum of two
-    double-precision floating-point numbers `x` and `y`).
-
-    The two numbers must satisfy `|y| < 0.5 * ulp( x )`.
-
-    If either argument is `NaN`, the function returns `NaN`.
+    If provided `NaN`, the function returns `NaN`.
 
     Parameters
     ----------
     x: number
         Input value (in radians).
 
-    y: number
-        Tail of `x`.
-
     Returns
     -------
     out: number
         Cosine.
 
     Examples
     --------
-    > var out = {{alias}}( 0.0, 0.0 )
+    > var out = {{alias}}( 0.0 )
     ~1.0
-    > out = {{alias}}( {{alias:@stdlib/constants/float64/pi}}/6.0, 0.0 )
+    > out = {{alias}}( {{alias:@stdlib/constants/float64/pi}}/6.0 )
     ~0.866
-    > out = {{alias}}( 0.785, -1.144e-17 )
+    > out = {{alias}}( 0.785 )
     ~0.707
     > out = {{alias}}( NaN )
     NaN

lib/node_modules/@stdlib/math/base/special/kernel-cosf/docs/types/index.d.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.
@@ -19,36 +19,34 @@
 // TypeScript Version: 4.1
 
 /**
-* Computes the cosine of a double-precision floating-point number on `[-π/4, π/4]`.
+* Computes the cosine of a single-precision floating-point number on \\( \[-\pi/4, \pi/4] \\), where \\( \pi/4 \approx 0.785398164 \\).
 *
 * ## Notes
 *
-* -   For increased accuracy, the number for which the cosine should be evaluated can be supplied as a double-double number (i.e., a non-evaluated sum of two double-precision floating-point numbers `x` and `y`).
-* -   The two numbers must satisfy `|y| < 0.5 * ulp( x )`.
+* -   \\( | \cos(x) - c(x) | < 2^{-34.1} \\), where \\( 2^{-34.1} \approx \[ -5.37 \times 10^{-11}, 5.295 \times 10^{-11} \] \\).
 *
 * @param x - input value (in radians, assumed to be bounded by ~pi/4 in magnitude)
-* @param y - tail of `x`
 * @returns cosine
 *
 * @example
-* var v = kernelCos( 0.0, 0.0 );
+* var v = kernelCosf( 0.0 );
 * // returns ~1.0
 *
 * @example
-* var v = kernelCos( 3.141592653589793/6.0, 0.0 );
+* var v = kernelCosf( 3.141592653589793/6.0 );
 * // returns ~0.866
 *
 * @example
-* var v = kernelCos( 0.785, -1.144e-17 );
+* var v = kernelCosf( 0.785 );
 * // returns ~0.707
 *
 * @example
-* var v = kernelCos( NaN, 0.0 );
+* var v = kernelCosf( NaN );
 * // returns NaN
 */
-declare function kernelCos( x: number, y: number ): number;
+declare function kernelCosf( x: number ): number;
 
 
 // EXPORTS //
 
-export = kernelCos;
+export = kernelCosf;