[harsh-thakkar7]

Resolves #1335

Description

What is the purpose of this pull request?

This pull request adds @stdlib/iter/cartesian-product, an iterator which lazily iterates over the Cartesian product of two array-like objects.

The implementation follows the ordering and empty-input semantics of @stdlib/array/cartesian-product and supports generic, typed, and accessor arrays. Elements are read lazily, so large Cartesian products are not materialized up front. The package includes unit tests, documentation, REPL examples, TypeScript declarations, examples, and benchmarks.

Related Issues

Does this pull request have any related issues?

• resolves [RFC]: add @stdlib/iter/cartesian-product #1335

Questions

Any questions for reviewers of this pull request?

No.

Other

Any other information relevant to this pull request? This may include screenshots, references, and/or implementation notes.

Equivalence with @stdlib/array/cartesian-product was checked exhaustively for small inputs. All package tests pass locally.

Checklist

Please ensure that the following tasks are completed before submitting this pull request.

• Read, understood, and followed the contributing guidelines.

---

@stdlib-js/reviewers

[stdlib-bot]

Coverage Report

Package	Statements	Branches	Functions	Lines
iter/cartesian-product	$\\color{green}206/206$ $\\color{green}+100.00\\%$	$\\color{green}18/18$ $\\color{green}+100.00\\%$	$\\color{green}4/4$ $\\color{green}+100.00\\%$	$\\color{green}206/206$ $\\color{green}+100.00\\%$

The above coverage report was generated for the changes in this PR.