feat: add support for complex number arrays

---
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: na
  - task: lint_package_json
    status: na
  - task: lint_repl_help
    status: na
  - 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: na
  - 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: na
  - task: lint_typescript_tests
    status: na
  - task: lint_license_headers
    status: passed
---

Author: kgryte

lib/node_modules/@stdlib/_tools/doctest/compare-values/lib/main.js

@@ -45,6 +45,7 @@ var isPrimitive = require( '@stdlib/assert/is-primitive' );
 var isObjectLike = require( '@stdlib/assert/is-object-like' );
 var isFunction = require( '@stdlib/assert/is-function' );
 var isTypedArray = require( '@stdlib/assert/is-typed-array' );
+var isComplexTypedArray = require( '@stdlib/assert/is-complex-typed-array' );
 var isError = require( '@stdlib/assert/is-error' );
 var isTypeError = require( '@stdlib/assert/is-type-error' );
 var isSyntaxError = require( '@stdlib/assert/is-syntax-error' );
@@ -61,6 +62,7 @@ var replace = require( '@stdlib/string/replace' );
 var trim = require( '@stdlib/string/trim' );
 var PINF = require( '@stdlib/constants/float64/pinf' );
 var NINF = require( '@stdlib/constants/float64/ninf' );
+var reinterpretComplex = require( '@stdlib/strided/base/reinterpret-complex' );
 var createAnnotationValue = require( '@stdlib/_tools/doctest/create-annotation-value' );
 var parse = require( './parse.js' );
 
@@ -251,6 +253,9 @@ function checkTypedArrays( actual, expected ) {
 			return 'Expected instance type <'+actual.constructor.name+'>, but observed <'+type+'>';
 		}
 		if ( entries ) {
+			if ( isComplexTypedArray( actual ) ) {
+				actual = reinterpretComplex( actual, 0 );
+			}
 			return compareEntries( actual, parse( entries ) );
 		}
 		return null;
@@ -404,7 +409,7 @@ function compareValues( actual, expected ) {
 		}
 		return null;
 	}
-	if ( isTypedArray( actual ) ) {
+	if ( isTypedArray( actual ) || isComplexTypedArray( actual ) ) {
 		return checkTypedArrays( actual, expected );
 	}
 	if ( isArray( actual ) ) {

lib/node_modules/@stdlib/_tools/doctest/compare-values/test/test.js

@@ -42,6 +42,7 @@ function createErrorMessage( actual, expected ) {
 // TESTS //
 
 tape( 'main export is a function', function test( t ) {
+	t.ok( true, __filename );
 	t.strictEqual( typeof compareValues, 'function', 'main export is a function' );
 	t.end();
 });
@@ -300,14 +301,20 @@ tape( 'the function compares a typed array and a corresponding return annotation
 
 	buf = new Float32Array( [ 1.0, -1.0, 2.0, -2.0 ] );
 	actual = new Complex64Array( buf );
-	expected = '<Complex64Array>';
+	expected = '<Complex64Array>[ 1.0, -1.0, 2.0, -2.0 ]';
 	t.strictEqual( compareValues( actual, expected ), null, 'returns null' );
 
 	buf = new Float64Array( [ 1.0, -1.0, 2.0, -2.0 ] );
 	actual = new Complex128Array( buf );
-	expected = '<Complex128Array>';
+	expected = '<Complex128Array>[ 1.0, -1.0, 2.0, -2.0 ]';
 	t.strictEqual( compareValues( actual, expected ), null, 'returns null' );
 
+	buf = new Float64Array( [ 1.0, -1.0, 2.0, -2.0 ] );
+	actual = new Complex128Array( buf );
+	expected = '<Complex128Array>[ 1.0, 1.0, 2.0, 2.0 ]';
+	msg = 'Expected array entries [1,1,2,2], but observed [1,-1,2,-2]';
+	t.strictEqual( compareValues( actual, expected ), msg, 'returns expected message' );
+
 	t.end();
 });
 
@@ -369,7 +376,7 @@ tape( 'the function differentiates between boxed and primitive values', function
 	msg = 'Expected a <Number>, but received an unboxed primitive: `2.3`';
 	t.strictEqual( compareValues( actual, expected ), msg, 'returns expected message' );
 
-	actual = new Number( 2.3 ); // eslint-disable-line no-new-wrappers
+	actual = new Number( 2.3 );
 	expected = '<number>';
 	msg = 'Expected a <number>, but received a boxed primitive: `2.3`';
 	t.strictEqual( compareValues( actual, expected ), msg, 'returns expected message' );
@@ -393,7 +400,7 @@ tape( 'the function differentiates between boxed and primitive values', function
 	msg = 'Expected a <Boolean>, but received an unboxed primitive: `false`';
 	t.strictEqual( compareValues( actual, expected ), msg, 'returns expected message' );
 
-	actual = new Boolean( false ); // eslint-disable-line no-new-wrappers
+	actual = new Boolean( false );
 	expected = '<boolean>';
 	msg = 'Expected a <boolean>, but received a boxed primitive: `false`';
 	t.strictEqual( compareValues( actual, expected ), msg, 'returns expected message' );