Merge branch 'develop' into ieee/acos

Signed-off-by: Karan Anand <[email protected]>

Author: anandkaranubc

CONTRIBUTORS

@@ -95,6 +95,7 @@ Mohammad Bin Aftab <[email protected]>
 Mohammad Kaif <[email protected]>
 Momtchil Momtchev <[email protected]>
 Muhammad Haris <[email protected]>
+Muhammad Taaha Tariq <[email protected]>
 Muhmmad Saad <[email protected]>
 Naresh Jagadeesan <[email protected]>
 Naveen Kumar <[email protected]>

lib/node_modules/@stdlib/blas/base/ssyr2/lib/ndarray.js

@@ -70,7 +70,7 @@ function ssyr2( uplo, N, alpha, x, strideX, offsetX, y, strideY, offsetY, A, str
 		throw new RangeError( format( 'invalid argument. Fifth argument must be non-zero. Value: `%d`.', strideX ) );
 	}
 	if ( strideY === 0 ) {
-		throw new RangeError( format( 'invalid argument. Eighth argument must be non-zero. Value: `%d`.', strideX ) );
+		throw new RangeError( format( 'invalid argument. Eighth argument must be non-zero. Value: `%d`.', strideY ) );
 	}
 	if ( N === 0 || alpha === 0.0 ) {
 		return A;

lib/node_modules/@stdlib/blas/base/ssyr2/lib/ssyr2.js

@@ -79,7 +79,7 @@ function ssyr2( order, uplo, N, alpha, x, strideX, y, strideY, A, LDA ) {
 		throw new RangeError( format( 'invalid argument. Sixth argument must be non-zero. Value: `%d`.', strideX ) );
 	}
 	if ( strideY === 0 ) {
-		throw new RangeError( format( 'invalid argument. Eighth argument must be non-zero. Value: `%d`.', strideX ) );
+		throw new RangeError( format( 'invalid argument. Eighth argument must be non-zero. Value: `%d`.', strideY ) );
 	}
 	if ( LDA < max( 1, N ) ) {
 		throw new RangeError( format( 'invalid argument. Tenth argument must be greater than or equal to max(1,%d). Value: `%d`.', N, LDA ) );

lib/node_modules/@stdlib/blas/base/ssyr2/test/fixtures/column_major_x0.json

@@ -0,0 +1,18 @@
+{
+  "order": "column-major",
+  "uplo": "lower",
+  "N": 3,
+  "alpha": 2.0,
+  "x": [ 0.0, 0.0, 0.0 ],
+  "strideX": 1,
+  "offsetX": 0,
+  "y": [ 1.0, 2.0, 3.0 ],
+  "strideY": 1,
+  "offsetY": 0,
+  "A": [ 1.0, 1.0, 1.0, 0.0, 2.0, 2.0, 0.0, 0.0, 3.0 ],
+  "lda": 3,
+  "strideA1": 1,
+  "strideA2": 3,
+  "offsetA": 0,
+  "A_out": [ 1.0, 1.0, 1.0, 0.0, 2.0, 2.0, 0.0, 0.0, 3.0 ]
+  }

lib/node_modules/@stdlib/blas/base/ssyr2/test/fixtures/row_major_x0.json

@@ -0,0 +1,18 @@
+{
+  "order": "row-major",
+  "uplo": "lower",
+  "N": 3,
+  "alpha": 2.0,
+  "x": [ 0.0, 0.0, 0.0 ],
+  "strideX": 1,
+  "offsetX": 0,
+  "y": [ 1.0, 2.0, 3.0 ],
+  "strideY": 1,
+  "offsetY": 0,
+  "A": [ 1.0, 0.0, 0.0, 1.0, 2.0, 0.0, 1.0, 2.0, 3.0 ],
+  "lda": 3,
+  "strideA1": 3,
+  "strideA2": 1,
+  "offsetA": 0,
+  "A_out": [ 1.0, 0.0, 0.0, 1.0, 2.0, 0.0, 1.0, 2.0, 3.0 ]
+}

lib/node_modules/@stdlib/blas/base/ssyr2/test/test.ndarray.js

@@ -31,6 +31,7 @@ var ssyr2 = require( './../lib/ndarray.js' );
 
 var ru = require( './fixtures/row_major_u.json' );
 var rl = require( './fixtures/row_major_l.json' );
+var rx0 = require( './fixtures/row_major_x0.json' );
 var rxpyp = require( './fixtures/row_major_xpyp.json' );
 var rxnyp = require( './fixtures/row_major_xnyp.json' );
 var rxpyn = require( './fixtures/row_major_xpyn.json' );
@@ -44,6 +45,7 @@ var rcap = require( './fixtures/row_major_complex_access_pattern.json' );
 
 var cu = require( './fixtures/column_major_u.json' );
 var cl = require( './fixtures/column_major_l.json' );
+var cx0 = require( './fixtures/column_major_x0.json' );
 var cxpyp = require( './fixtures/column_major_xpyp.json' );
 var cxnyp = require( './fixtures/column_major_xnyp.json' );
 var cxpyn = require( './fixtures/column_major_xpyn.json' );
@@ -161,7 +163,7 @@ tape( 'the function throws an error if provided an invalid eighth argument', fun
 
 	function badValue( value ) {
 		return function badValue() {
-			ssyr2( data.uplo, data.N, data.alpha, new Float32Array( data.x ), value, data.offsetX, new Float32Array( data.y ), data.strideY, data.offsetY, new Float32Array( data.A ), data.strideA1, data.strideA2, data.offsetA );
+			ssyr2( data.uplo, data.N, data.alpha, new Float32Array( data.x ), data.strideX, data.offsetX, new Float32Array( data.y ), value, data.offsetY, new Float32Array( data.A ), data.strideA1, data.strideA2, data.offsetA );
 		};
 	}
 });
@@ -258,6 +260,52 @@ tape( 'the function performs the symmetric rank 2 operation `A = α*x*y^T + α*y
 	t.end();
 });
 
+tape( 'the function performs the symmetric rank 2 operation `A = α*x*y^T + α*y*x^T + A` (row-major, zero-vector)', function test( t ) {
+	var expected;
+	var data;
+	var out;
+	var a;
+	var x;
+	var y;
+
+	data = rx0;
+
+	a = new Float32Array( data.A );
+	x = new Float32Array( data.x );
+	y = new Float32Array( data.y );
+
+	expected = new Float32Array( data.A_out );
+
+	out = ssyr2( data.uplo, data.N, data.alpha, x, data.strideX, data.offsetX, y, data.strideY, data.offsetY, a, data.strideA1, data.strideA2, data.offsetA );
+	t.strictEqual( out, a, 'returns expected value' );
+	t.deepEqual( out, expected, 'returns expected value' );
+
+	t.end();
+});
+
+tape( 'the function performs the symmetric rank 2 operation `A = α*x*y^T + α*y*x^T + A` (column-major, zero-vector)', function test( t ) {
+	var expected;
+	var data;
+	var out;
+	var a;
+	var x;
+	var y;
+
+	data = cx0;
+
+	a = new Float32Array( data.A );
+	x = new Float32Array( data.x );
+	y = new Float32Array( data.y );
+
+	expected = new Float32Array( data.A_out );
+
+	out = ssyr2( data.uplo, data.N, data.alpha, x, data.strideX, data.offsetX, y, data.strideY, data.offsetY, a, data.strideA1, data.strideA2, data.offsetA );
+	t.strictEqual( out, a, 'returns expected value' );
+	t.deepEqual( out, expected, 'returns expected value' );
+
+	t.end();
+});
+
 tape( 'the function returns a reference to the input matrix `A`', function test( t ) {
 	var data;
 	var out;

lib/node_modules/@stdlib/blas/base/ssyr2/test/test.ssyr2.js

@@ -31,13 +31,15 @@ var ssyr2 = require( './../lib/ssyr2.js' );
 
 var ru = require( './fixtures/row_major_u.json' );
 var rl = require( './fixtures/row_major_l.json' );
+var rx0 = require( './fixtures/row_major_x0.json' );
 var rxpyp = require( './fixtures/row_major_xpyp.json' );
 var rxnyp = require( './fixtures/row_major_xnyp.json' );
 var rxpyn = require( './fixtures/row_major_xpyn.json' );
 var rxnyn = require( './fixtures/row_major_xnyn.json' );
 
 var cu = require( './fixtures/column_major_u.json' );
 var cl = require( './fixtures/column_major_l.json' );
+var cx0 = require( './fixtures/column_major_x0.json' );
 var cxpyp = require( './fixtures/column_major_xpyp.json' );
 var cxnyp = require( './fixtures/column_major_xnyp.json' );
 var cxpyn = require( './fixtures/column_major_xpyn.json' );
@@ -300,6 +302,52 @@ tape( 'the function performs the symmetric rank 2 operation `A = α*x*y^T + α*y
 	t.end();
 });
 
+tape( 'the function performs the symmetric rank 2 operation `A = α*x*y^T + α*y*x^T + A` (row-major, zero-vector)', function test( t ) {
+	var expected;
+	var data;
+	var out;
+	var a;
+	var x;
+	var y;
+
+	data = rx0;
+
+	a = new Float32Array( data.A );
+	x = new Float32Array( data.x );
+	y = new Float32Array( data.y );
+
+	expected = new Float32Array( data.A_out );
+
+	out = ssyr2( data.order, data.uplo, data.N, data.alpha, x, data.strideX, y, data.strideY, a, data.lda );
+	t.strictEqual( out, a, 'returns expected value' );
+	t.deepEqual( out, expected, 'returns expected value' );
+
+	t.end();
+});
+
+tape( 'the function performs the symmetric rank 2 operation `A = α*x*y^T + α*y*x^T + A` (column-major, zero-vector)', function test( t ) {
+	var expected;
+	var data;
+	var out;
+	var a;
+	var x;
+	var y;
+
+	data = cx0;
+
+	a = new Float32Array( data.A );
+	x = new Float32Array( data.x );
+	y = new Float32Array( data.y );
+
+	expected = new Float32Array( data.A_out );
+
+	out = ssyr2( data.order, data.uplo, data.N, data.alpha, x, data.strideX, y, data.strideY, a, data.lda );
+	t.strictEqual( out, a, 'returns expected value' );
+	t.deepEqual( out, expected, 'returns expected value' );
+
+	t.end();
+});
+
 tape( 'the function returns a reference to the input matrix `A`', function test( t ) {
 	var data;
 	var out;

lib/node_modules/@stdlib/math/base/napi/ternary/README.md

@@ -512,6 +512,69 @@ The function accepts the following arguments:
 void stdlib_math_base_napi_fif_f( napi_env env, napi_callback_info info, float (*fcn)( float, int32_t, float ) );
 ```
 
+#### STDLIB_MATH_BASE_NAPI_MODULE_FII_F( fcn )
+
+Macro for registering a Node-API module exporting an interface for invoking a ternary function accepting a single-precision floating-point number and two signed 32-bit integers and returning a single-precision floating-point number.
+
+```c
+#include <stdint.h>
+
+static float fcn( const float x, const int32_t y, const int32_t z ) {
+    // ...
+}
+
+// ...
+
+// Register a Node-API module:
+STDLIB_MATH_BASE_NAPI_MODULE_FII_F( fcn );
+```
+
+The macro expects the following arguments:
+
+-   **fcn**: `float (*fcn)( float, int32_t, int32_t )` ternary function.
+
+When used, this macro should be used **instead of** `NAPI_MODULE`. The macro includes `NAPI_MODULE`, thus ensuring Node-API module registration.
+
+#### stdlib_math_base_napi_fii_f( env, info, fcn )
+
+Invokes a ternary function accepting a single-precision floating-point number and two signed 32-bit integers and returning a single-precision floating-point number.
+
+```c
+#include <node_api.h>
+#include <stdint.h>
+
+// ...
+
+static float fcn( const float x, const int32_t y, const int32_t z ) {
+    // ...
+}
+
+// ...
+
+/**
+* Receives JavaScript callback invocation data.
+*
+* @param env    environment under which the function is invoked
+* @param info   callback data
+* @return       Node-API value
+*/
+napi_value addon( napi_env env, napi_callback_info info ) {
+    return stdlib_math_base_napi_fii_f( env, info, fcn );
+}
+
+// ...
+```
+
+The function accepts the following arguments:
+
+-   **env**: `[in] napi_env` environment under which the function is invoked.
+-   **info**: `[in] napi_callback_info` callback data.
+-   **fcn**: `[in] float (*fcn)( float, int32_t, int32_t )` ternary function.
+
+```c
+void stdlib_math_base_napi_fii_f( napi_env env, napi_callback_info info, float (*fcn)( float, int32_t, int32_t ) );
+```
+
 #### STDLIB_MATH_BASE_NAPI_MODULE_IID_D( fcn )
 
 Macro for registering a Node-API module exporting an interface for invoking a ternary function accepting two signed 32-bit integers and a double-precision floating-point number and returning a double-precision floating-point number.

lib/node_modules/@stdlib/math/base/napi/ternary/include/stdlib/math/base/napi/ternary.h

@@ -26,6 +26,7 @@
 #include "stdlib/math/base/napi/ternary/dii_d.h"
 #include "stdlib/math/base/napi/ternary/fff_f.h"
 #include "stdlib/math/base/napi/ternary/fif_f.h"
+#include "stdlib/math/base/napi/ternary/fii_f.h"
 #include "stdlib/math/base/napi/ternary/iid_d.h"
 #include "stdlib/math/base/napi/ternary/iii_d.h"
 #include "stdlib/math/base/napi/ternary/zzz_z.h"

lib/node_modules/@stdlib/math/base/napi/ternary/include/stdlib/math/base/napi/ternary/fii_f.h

@@ -0,0 +1,84 @@
+/**
+* @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.
+*/
+
+#ifndef STDLIB_MATH_BASE_NAPI_TERNARY_FII_F_H
+#define STDLIB_MATH_BASE_NAPI_TERNARY_FII_F_H
+
+#include <node_api.h>
+#include <assert.h>
+#include <stdint.h>
+
+/**
+* Macro for registering a Node-API module exporting an interface invoking a ternary function accepting a single-precision floating-point number and two signed 32-bit integers and returning a single-precision floating-point number.
+*
+* @param fcn   ternary function
+*
+* @example
+* #include <stdint.h>
+*
+* static float fcn( const float x, const int32_t y, const int32_t z ) {
+*     // ...
+* }
+*
+* // ...
+*
+* // Register a Node-API module:
+* STDLIB_MATH_BASE_NAPI_MODULE_FII_F( fcn );
+*/
+#define STDLIB_MATH_BASE_NAPI_MODULE_FII_F( fcn )                              \
+	static napi_value stdlib_math_base_napi_fii_f_wrapper(                     \
+		napi_env env,                                                          \
+		napi_callback_info info                                                \
+	) {                                                                        \
+		return stdlib_math_base_napi_fii_f( env, info, fcn );                  \
+	};                                                                         \
+	static napi_value stdlib_math_base_napi_fii_f_init(                        \
+		napi_env env,                                                          \
+		napi_value exports                                                     \
+	) {                                                                        \
+		napi_value f;                                                          \
+		napi_status status = napi_create_function(                             \
+			env,                                                               \
+			"exports",                                                         \
+			NAPI_AUTO_LENGTH,                                                  \
+			stdlib_math_base_napi_fii_f_wrapper,                               \
+			NULL,                                                              \
+			&f                                                                 \
+		);                                                                     \
+		assert( status == napi_ok );                                           \
+		return f;                                                              \
+	};                                                                         \
+	NAPI_MODULE( NODE_GYP_MODULE_NAME, stdlib_math_base_napi_fii_f_init )
+
+/*
+* If C++, prevent name mangling so that the compiler emits a ternary file having undecorated names, thus mirroring the behavior of a C compiler.
+*/
+#ifdef __cplusplus
+extern "C" {
+#endif
+
+/**
+* Invokes a ternary function accepting a single-precision floating-point number and two signed 32-bit integers and returning a single-precision floating-point number.
+*/
+napi_value stdlib_math_base_napi_fii_f( napi_env env, napi_callback_info info, float (*fcn)( float, int32_t, int32_t ) );
+
+#ifdef __cplusplus
+}
+#endif
+
+#endif // !STDLIB_MATH_BASE_NAPI_TERNARY_FII_F_H