feat: add breakFunc argument to use break in the “map” function

[moowoonsunghoon]

Tip

The owner of this PR can publish a preview release by commenting /publish in this PR. Afterwards, anyone can try it out by running pnpm add radashi@pr<PR_NUMBER>.

Summary

This PR adds the breakFunc argument to use break in the “map” function.

Related issue, if any:

For any code change,

• Related documentation has been updated, if needed
• Related tests have been added or updated, if needed
• Related benchmarks have been added or updated, if needed
• Release notes in next-minor.md or next-major.md have been added, if needed

Does this PR introduce a breaking change?

No

Bundle impact

Status	File	Size 1	Difference
M	src/async/map.ts	149	+25 (+20%)

Footnotes

1. Function size includes the import dependencies of the function. ↩

[aleclarson]

Hey @moowoonsunghoon, thanks for the PR! I appreciate you taking the time to contribute.

I think this could be a useful addition, but the use case may not be super common. That said, we can keep the PR open to gauge interest from the community. In the meantime, you can achieve a similar result using a for loop:

const prices: number[] = []
for (const symbol of stockSymbols) {
  const price = await calculateStockPrice(symbol)
  prices.push(price)
  if (sum(prices) > 100) {
    break
  }
}

Personally, I find the for..of version more readable, but I'm curious to hear your thoughts on the matter. Let me know what you think!

Thanks again for the contribution. I look forward to seeing more from you in the future!