feat(iter/cartesian-square): add test/test.js

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

Author: fikri-ajiwijaya

lib/node_modules/@stdlib/iter/cartesian-square/test/test.js

@@ -0,0 +1,225 @@
+/**
+* @license Apache-2.0
+*
+* Copyright (c) 2026 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 tape = require( 'tape' );
+var proxyquire = require( 'proxyquire' );
+var linspace = require( '@stdlib/array/linspace' );
+var iteratorSymbol = require( '@stdlib/symbol/iterator' );
+var iterCartesianSquare = require( './../lib' );
+
+
+// TESTS //
+
+tape( 'main export is a function', function test( t ) {
+	t.ok( true, __filename );
+	t.strictEqual( typeof iterCartesianSquare, 'function', 'main export is a function' );
+	t.end();
+});
+
+tape( 'the function throws an error if provided an argument which is not a collection', function test( t ) {
+	var values;
+	var i;
+
+	values = [
+		'5',
+		5,
+		NaN,
+		true,
+		false,
+		null,
+		void 0,
+		{}
+	];
+
+	for ( i = 0; i < values.length; i++ ) {
+		t.throws( badValue( values[i] ), TypeError, 'throws an error when provided '+values[i] );
+	}
+	t.end();
+
+	function badValue( value ) {
+		return function badValue() {
+			iterCartesianSquare( value );
+		};
+	}
+});
+
+tape( 'the function returns an iterator protocol-compliant object (cartesian-square)', function test( t ) {
+	var expected;
+	var values;
+	var actual;
+	var it;
+	var v;
+
+	values = [ 1, 2 ];
+	expected = [
+		{
+			'value': [ 1, 1 ],
+			'done': false
+		},
+		{
+			'value': [ 1, 2 ],
+			'done': false
+		},
+		{
+			'value': [ 2, 1 ],
+			'done': false
+		},
+		{
+			'value': [ 2, 2 ],
+			'done': false
+		},
+		{
+			'done': true
+		}
+	];
+
+	it = iterCartesianSquare( values );
+	t.strictEqual( it.next.length, 0, 'has zero arity' );
+
+	actual = [];
+	while ( true ) {
+		v = it.next();
+		if ( v.done ) {
+			break;
+		}
+		actual.push( v );
+	}
+	actual.push( it.next() );
+
+	t.deepEqual( actual, expected, 'returns expected values' );
+	t.end();
+});
+
+tape( 'the returned iterator has a `return` method for closing an iterator (no argument)', function test( t ) {
+	var it;
+	var r;
+
+	it = iterCartesianSquare( linspace( 0, 5, 6 ) );
+
+	r = it.next();
+	t.strictEqual( typeof r.value, 'object', 'returns expected value' );
+	t.strictEqual( r.done, false, 'returns expected value' );
+
+	r = it.next();
+	t.strictEqual( typeof r.value, 'object', 'returns expected value' );
+	t.strictEqual( r.done, false, 'returns expected value' );
+
+	r = it.return();
+	t.strictEqual( r.value, void 0, 'returns expected value' );
+	t.strictEqual( r.done, true, 'returns expected value' );
+
+	r = it.next();
+	t.strictEqual( r.value, void 0, 'returns expected value' );
+	t.strictEqual( r.done, true, 'returns expected value' );
+
+	t.end();
+});
+
+tape( 'the returned iterator has a `return` method for closing an iterator (argument)', function test( t ) {
+	var it;
+	var r;
+
+	it = iterCartesianSquare( linspace( 0, 5, 6 ) );
+
+	r = it.next();
+	t.strictEqual( typeof r.value, 'object', 'returns expected value' );
+	t.strictEqual( r.done, false, 'returns expected value' );
+
+	r = it.next();
+	t.strictEqual( typeof r.value, 'object', 'returns expected value' );
+	t.strictEqual( r.done, false, 'returns expected value' );
+
+	r = it.return( 'finished' );
+	t.strictEqual( r.value, 'finished', 'returns expected value' );
+	t.strictEqual( r.done, true, 'returns expected value' );
+
+	r = it.next();
+	t.strictEqual( r.value, void 0, 'returns expected value' );
+	t.strictEqual( r.done, true, 'returns expected value' );
+
+	t.end();
+});
+
+tape( 'if an environment supports `Symbol.iterator` and the provided iterator is iterable, the returned iterator is iterable', function test( t ) {
+	var iterCartesianSquare;
+	var it1;
+	var it2;
+	var x;
+	var i;
+
+	iterCartesianSquare = proxyquire( './../lib/main.js', {
+		'@stdlib/symbol/iterator': '__ITERATOR_SYMBOL__'
+	});
+
+	x = linspace( 0, 5, 6 );
+	x[ '__ITERATOR_SYMBOL__' ] = factory;
+
+	it1 = iterCartesianSquare( x );
+	t.strictEqual( typeof it1[ '__ITERATOR_SYMBOL__' ], 'function', 'has method' );
+	t.strictEqual( it1[ '__ITERATOR_SYMBOL__' ].length, 0, 'has zero arity' );
+
+	it2 = it1[ '__ITERATOR_SYMBOL__' ]();
+	t.strictEqual( typeof it2, 'object', 'returns expected value' );
+	t.strictEqual( typeof it2.next, 'function', 'has method' );
+	t.strictEqual( typeof it2.return, 'function', 'has method' );
+
+	for ( i = 0; i < 100; i++ ) {
+		t.deepEqual( it2.next().value, it1.next().value, 'returns expected value' );
+	}
+	t.end();
+
+	function factory() {
+		return linspace( 0, 5, 6 );
+	}
+});
+
+tape( 'if an environment does not support `Symbol.iterator`, the returned iterator is not "iterable"', function test( t ) {
+	var iterCartesianSquare;
+	var it;
+
+	iterCartesianSquare = proxyquire( './../lib/main.js', {
+		'@stdlib/symbol/iterator': false
+	});
+
+	it = iterCartesianSquare( linspace( 0, 5, 6 ) );
+	t.strictEqual( it[ iteratorSymbol ], void 0, 'does not have property' );
+
+	t.end();
+});
+
+tape( 'if a provided iterator is not iterable, the returned iterator is not iterable', function test( t ) {
+	var iterCartesianSquare;
+	var it;
+	var x;
+
+	iterCartesianSquare = proxyquire( './../lib/main.js', {
+		'@stdlib/symbol/iterator': '__ITERATOR_SYMBOL__'
+	});
+
+	x = linspace( 0, 5, 6 );
+	x[ '__ITERATOR_SYMBOL__' ] = null;
+
+	it = iterCartesianSquare( x );
+	t.strictEqual( it[ iteratorSymbol ], void 0, 'does not have property' );
+
+	t.end();
+});