feat: Add globalLimit prop to control maximum visible toasts per provider

[dana-y]

Summary

This PR adds a globalLimit prop to the <Toasts /> component, allowing developers to control the maximum number of toasts displayed per provider instance.

Motivation

First of all, I want to say that I've been using this library extensively and it's been fantastic! 🎉

Currently, the toast limit is hardcoded at 20 toasts in the store. While this works well for most cases, there are scenarios where different providers might need different limits:

• A modal might need to show only 1-3 toasts at a time
• The main screen might want to display more toasts
• Different UX requirements across the app

Changes

Core Changes

• types.ts: Added limit?: number to DefaultToastOptions type
• store.ts: Modified useStore to respect the limit option when filtering toasts
  • Moved limit logic from reducer to the view layer (filter + slice)
  • Each provider can now have an independent limit
  • Default remains 20 toasts if not specified
• Toasts.tsx: Added globalLimit?: number prop that gets passed to useToaster

Example Updates

• Updated example app to demonstrate usage:
  • Root level: globalLimit={5}
  • Modal level: globalLimit={3}

API

<Toasts 
  globalLimit={5}  // Optional, defaults to 20
  // ... other props
/>

This follows the existing pattern of globalAnimationType and globalAnimationConfig props.

---

I'm happy to make any changes or adjustments you'd like to see. Thank you for maintaining such a great library! 🙏

[nickdebaise]

Thank you for your PR! I will be reviewing this alongside other global props that I would like to add as well (a global position prop and a global duration prop)

[nickdebaise]

Thanks for the PR! @dana-y. I've just released 0.15.0. I would like to release this change in 0.15.1. I've merged 0.15.0 into your branch. Before I merge, can you please add a test in __tests__/src/components/Toasts.test.tsx and add a brief example in our example app please? For the example app, please add a way to change the global limit in a text input and then use that globalLimit in the root component. Once you do this, I'll give it the green light and merge it in!

[dana-y]

@nickdebaise Thank you for your kind reply! 🤗
I've added the unit test you requested to the file located at __tests__/src/components/Toasts.test.tsx. Could you please take a look at it?

aba907f