v2.5.0: feat: add professional README and comprehensive examples

- Create community-ready README.md with badges, features, and complete API reference
- Add example/main.go with 5 demonstration sections covering all features
- Include Go 1.23 features showcase and advanced usage examples
- Prepare library for community release