feat: add strided API

---
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: na
  - 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: na
  - task: lint_c_examples
    status: na
  - task: lint_c_benchmarks
    status: na
  - 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: kgryte

lib/node_modules/@stdlib/complex/float64/base/mul/README.md

@@ -58,6 +58,11 @@ var im = imag( v );
 // returns -1.0
 ```
 
+The function supports the following parameters:
+
+-   **z1**: first [complex number][@stdlib/complex/float64/ctor].
+-   **z2**: second [complex number][@stdlib/complex/float64/ctor].
+
 #### mul.assign( re1, im1, re2, im2, out, strideOut, offsetOut )
 
 Multiplies two double-precision complex floating-point numbers and assigns results to a provided output array.
@@ -73,6 +78,46 @@ var bool = ( out === v );
 // returns true
 ```
 
+The function supports the following parameters:
+
+-   **re1**: real component of the first complex number.
+-   **im1**: imaginary component of the first complex number.
+-   **re2**: real component of the second complex number.
+-   **im2**: imaginary component of the second complex number.
+-   **out**: output array.
+-   **strideOut**: stride length for `out`.
+-   **offsetOut**: starting index for `out`.
+
+#### mul.strided( z1, sz1, oz1, z2, sz2, oz2, out, so, oo )
+
+Multiplies two double-precision complex floating-point numbers stored in real-valued strided array views and assigns results to a provided strided output array.
+
+```javascript
+var Float64Array = require( '@stdlib/array/float64' );
+
+var z1 = new Float64Array( [ 5.0, 3.0 ] );
+var z2 = new Float64Array( [ -2.0, 1.0 ] );
+var out = new Float64Array( 2 );
+
+var v = mul.strided( z1, 1, 0, z2, 1, 0, out, 1, 0 );
+// returns <Float64Array>[ -13.0, -1.0 ]
+
+var bool = ( out === v );
+// returns true
+```
+
+The function supports the following parameters:
+
+-   **z1**: first complex number strided array view.
+-   **sz1**: stride length for `z1`.
+-   **oz1**: starting index for `z1`.
+-   **z2**: second complex number strided array view.
+-   **sz2**: stride length for `z2`.
+-   **oz2**: starting index for `z2`.
+-   **out**: output array.
+-   **so**: stride length for `out`.
+-   **oo**: starting index for `out`.
+
 </section>
 
 <!-- /.usage -->
@@ -239,6 +284,8 @@ int main( void ) {
 
 <section class="links">
 
+[@stdlib/complex/float64/ctor]: https://github.com/stdlib-js/stdlib/tree/develop/lib/node_modules/%40stdlib/complex/float64/ctor
+
 <!-- <related-links> -->
 
 [@stdlib/complex/float64/base/add]: https://github.com/stdlib-js/stdlib/tree/develop/lib/node_modules/%40stdlib/complex/float64/base/add

lib/node_modules/@stdlib/complex/float64/base/mul/benchmark/benchmark.assign.js

@@ -28,6 +28,13 @@ var pkg = require( './../package.json' ).name;
 var mul = require( './../lib' );
 
 
+// VARIABLES //
+
+var options = {
+	'dtype': 'float64'
+};
+
+
 // MAIN //
 
 bench( pkg+':assign', function benchmark( b ) {
@@ -40,8 +47,8 @@ bench( pkg+':assign', function benchmark( b ) {
 	var k;
 
 	N = 100;
-	re = uniform( N, -500.0, 500.0 );
-	im = uniform( N, -500.0, 500.0 );
+	re = uniform( N, -500.0, 500.0, options );
+	im = uniform( N, -500.0, 500.0, options );
 
 	out = new Float64Array( 2 );
 

lib/node_modules/@stdlib/complex/float64/base/mul/benchmark/benchmark.strided.js

@@ -0,0 +1,68 @@
+/**
+* @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.
+*/
+
+'use strict';
+
+// MODULES //
+
+var bench = require( '@stdlib/bench' );
+var uniform = require( '@stdlib/random/array/uniform' );
+var isnan = require( '@stdlib/math/base/assert/is-nan' );
+var Float64Array = require( '@stdlib/array/float64' );
+var pkg = require( './../package.json' ).name;
+var mul = require( './../lib' );
+
+
+// VARIABLES //
+
+var options = {
+	'dtype': 'float64'
+};
+
+
+// MAIN //
+
+bench( pkg+':strided', function benchmark( b ) {
+	var out;
+	var z1;
+	var z2;
+	var N;
+	var i;
+	var j;
+
+	N = 50;
+	z1 = uniform( N*2, -500.0, 500.0, options );
+	z2 = uniform( N*2, -500.0, 500.0, options );
+
+	out = new Float64Array( 2 );
+
+	b.tic();
+	for ( i = 0; i < b.iterations; i++ ) {
+		j = ( i % N ) * 2;
+		out = mul.strided( z1, 1, j, z2, 1, j, out, 1, 0 );
+		if ( typeof out !== 'object' ) {
+			b.fail( 'should return an object' );
+		}
+	}
+	b.toc();
+	if ( isnan( out[ 0 ] ) || isnan( out[ 1 ] ) ) {
+		b.fail( 'should not return NaN' );
+	}
+	b.pass( 'benchmark finished' );
+	b.end();
+});

lib/node_modules/@stdlib/complex/float64/base/mul/docs/repl.txt

@@ -67,6 +67,54 @@
     > {{alias}}.assign( 5.0, 3.0, -2.0, 1.0, out, 1, 0 )
     <Float64Array>[ -13.0, -1.0 ]
 
+
+{{alias}}.strided( z1, sz1, oz1, z2, sz2, oz2, out, so, oo )
+    Multiplies two double-precision complex floating-point numbers stored in
+    real-valued strided array views and assigns results to a provided strided
+    output array.
+
+    Parameters
+    ----------
+    z1: ArrayLikeObject
+        First complex number view.
+
+    sz1: integer
+        Stride length for `z1`.
+
+    oz1: integer
+        Starting index for `z1`.
+
+    z2: ArrayLikeObject
+        Second complex number view.
+
+    sz2: integer
+        Stride length for `z2`.
+
+    oz2: integer
+        Starting index for `z2`.
+
+    out: ArrayLikeObject
+        Output array.
+
+    so: integer
+        Stride length for `out`.
+
+    oo: integer
+        Starting index for `out`.
+
+    Returns
+    -------
+    out: ArrayLikeObject
+        Output array.
+
+    Examples
+    --------
+    > var z1 = new {{alias:@stdlib/array/float64}}( [ 5.0, 3.0 ] );
+    > var z2 = new {{alias:@stdlib/array/float64}}( [ -2.0, 1.0 ] );
+    > var out = new {{alias:@stdlib/array/float64}}( 2 );
+    > {{alias}}.strided( z1, 1, 0, z2, 1, 0, out, 1, 0 )
+    <Float64Array>[ -13.0, -1.0 ]
+
     See Also
     --------
 

lib/node_modules/@stdlib/complex/float64/base/mul/docs/types/index.d.ts

@@ -79,6 +79,31 @@ interface Mul {
 	* // returns true
 	*/
 	assign<T extends NumericArray | Collection<number>>( re1: number, im1: number, re2: number, im2: number, out: T, strideOut: number, offsetOut: number ): T;
+
+	/**
+	* Multiplies two double-precision complex floating-point numbers stored in real-valued strided array views and assigns results to a provided strided output array.
+	*
+	* @param z1 - first complex number view
+	* @param strideZ1 - stride length for `z1`
+	* @param offsetZ1 - starting index for `z1`
+	* @param z2 - second complex number view
+	* @param strideZ2 - stride length for `z2`
+	* @param offsetZ2 - starting index for `z2`
+	* @param out - output array
+	* @param strideOut - stride length for `out`
+	* @param offsetOut - starting index for `out`
+	* @returns output array
+	*
+	* @example
+	* var Float64Array = require( '@stdlib/array/float64' );
+	*
+	* var z1 = new Float64Array( [ 5.0, 3.0 ] );
+	* var z2 = new Float64Array( [ -2.0, 1.0 ] );
+	*
+	* var out = mul.strided( z1, 1, 0, z2, 1, 0, new Float64Array( 2 ), 1, 0 );
+	* // returns <Float64Array>[ -13.0, -1.0 ]
+	*/
+	strided<T extends NumericArray | Collection<number>, U extends NumericArray | Collection<number>, V extends NumericArray | Collection<number>>( z1: T, strideZ1: number, offsetZ1: number, z2: U, strideZ2: number, offsetZ2: number, out: V, strideOut: number, offsetOut: number ): V;
 }
 
 /**
@@ -117,6 +142,15 @@ interface Mul {
 *
 * var bool = ( out === v );
 * // returns true
+*
+* @example
+* var Float64Array = require( '@stdlib/array/float64' );
+*
+* var z1 = new Float64Array( [ 5.0, 3.0 ] );
+* var z2 = new Float64Array( [ -2.0, 1.0 ] );
+*
+* var out = mul.strided( z1, 1, 0, z2, 1, 0, new Float64Array( 2 ), 1, 0 );
+* // returns <Float64Array>[ -13.0, -1.0 ]
 */
 declare var mul: Mul;