feat(make-cancelable): add support for cancelling promises using AbortController

[JoaoTMDias]

Summary

Because:

• The makeCancelable function needed improvements in type safety, error handling, and memory management
• The documentation was outdated and missing important usage examples
• The tests needed better coverage and reliability

This Commit:

• Adds proper TypeScript type safety with AbortPromiseError class
• Adds isCancelled method to check cancellation state
• Improves memory management with proper event listener cleanup
• Makes cancel method safe to call multiple times
• Improves error handling with proper error types and messages
• Updates documentation with comprehensive API docs and examples
• Adds React-specific example showing cleanup in useEffect
• Improves test coverage and reliability

Is this a Breaking Change?

• No

[github-actions]

size-limit report 📦

Path	Size
dist/index.cjs	7.48 KB (+1.81% 🔺)
dist/index.mjs	4.82 KB (+2.3% 🔺)
dist/hooks.cjs	4.28 KB (0%)
dist/hooks.mjs	3.22 KB (0%)

[github-actions]

🎉 This PR is included in version 2.2.0 🎉

The release is available on:

• npm package (@latest dist-tag)
• GitHub release

Your semantic-release bot 📦🚀