Add iterator implementation to Collections

[codingjoe]

ES6 iterators support the new for..of syntax. Since a Collection wraps an Array, we can lean on ECMAScript's new iterator delegation.

Resolve #679

I am working on esupgrade a tool to upgrade JS/TS code to widely available ECMAScript features. It's built on this wonderful tool. I'd really love to keep esupgrade's code base up to date too, and using for..of loops and generators would help tremendously.

Thanks for your consideration and for publishing this under a free license <3

[changeset-bot]

🦋 Changeset detected

Latest commit: eca1a75

The changes in this PR will be included in the next version bump.

This PR includes changesets to release 1 package

Name	Type
jscodeshift	Minor

Not sure what this means? Click here to learn what changesets are.

Click here if you're a maintainer who wants to add another changeset to this PR

[vercel]

@codingjoe is attempting to deploy a commit to the Meta Open Source Team on Vercel.

A member of the Team first needs to authorize it.

[Copilot]

Pull request overview

This pull request adds ES6 iterator support to the Collection class, enabling the use of for-of loops when working with Collections. The implementation uses a generator function that delegates to the underlying __paths array.

Key changes:

• Implements Symbol.iterator as a generator method in the Collection class
• Adds test coverage for the new iterator functionality

Reviewed changes

Copilot reviewed 2 out of 2 changed files in this pull request and generated 2 comments.

File	Description
src/Collection.js	Adds iterator implementation using generator delegation and JSDoc annotations
src/tests/Collection-test.js	Adds test case verifying iterator works correctly with for-of loops

---

💡 Add Copilot custom instructions for smarter, more guided reviews. Learn how to get started.

[Daniel15]

Looks pretty good to me! Just left a small comment inline.

[codingjoe]

/ping @Daniel15 :)

[codingjoe]

<3 thx