feat: useInterpolations

[astandrik]

Description

Closes#49

Type of change

• Bug fix (non-breaking change which fixes an issue)
• New feature (non-breaking change which adds functionality)
• Breaking change(fix or feature that would cause existing functionality to not work as before)

Checklist

• Read the Contributing Guide
• Perform a code self-review
• Comment the code, particularly in hard-to-understand areas
• Add documentation
• Add hook's story at Storybook
• Cover changes with tests
• Ensure the test suite passes (yarn test)
• Provide 100% tests coverage
• Make sure code lints (yarn lint). Fix it with yarn lint:fix in case of failure.
• Make sure types are fine (yarn lint:types).

[Copilot]

Pull request overview

This PR introduces a new useInterpolations hook that interpolates multiple numeric values simultaneously over time using the existing useTween hook. It enables animations of multiple properties (like position, opacity, etc.) with a single hook call.

Key Changes:

• New animation hook that maps multiple [start, end] tuples to interpolated values
• Comprehensive validation with helpful error messages in development mode
• Complete test coverage including edge cases and error scenarios

Reviewed changes

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

Show a summary per file

File	Description
src/useInterpolations.ts	Core implementation with input validation and linear interpolation logic
tests/useInterpolations.test.ts	Comprehensive test suite covering interpolation, edge cases, and error handling
stories/useInterpolations.story.tsx	Interactive demo showing animated element with multiple interpolated properties
docs/useInterpolations.md	Documentation with usage examples and API reference
src/index.ts	Export added for new hook (placement needs correction)
README.md	Hook added to Animations section of main documentation

---

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

[Copilot]

Pull request overview

Copilot reviewed 6 out of 6 changed files in this pull request and generated no new comments.

---

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