feat: Add support for new <Drawer.SnapPoint />

[s-fletcher]

Problem

Hard coded snapPoint values are not ideal for responsive drawers. In the video bellow, notice how the snap point is not consistently under the "Buy" button when the screen is smaller.

CleanShot.2025-02-12.at.01.19.06.mp4

Solution

Introduce a new Drawer.SnapPoint component to determine where the snaps occur based on their position in the DOM. This solution was inspired by this issue #330

Caution

Although functional, this PR is still a WIP as I find time to contribute.

Todo

• Define <Drawer.SnapPoint />
• Support offset prop in <Drawer.SnapPoint />
• Add example inside test app
• Add tests around new feature
• Investigate how feature behaves with nested drawers
• Add comprehensive demo to PR

Wishlist

• Support name prop in <Drawer.SnapPoint />
  • The idea here is to allow the consumer to reference that snap point by name now that the point is dynamic.
• Support a callback inside snapPoints prop to combine both hard coded and embedded snap points