[Feat]: Add 'snap on settle' behavior option for dragFree

[ehellman]

• Closes: [Feat]: Request for a Free-Snap mode that has the momentum physics of drag-free, but still always snaps to slide once it decays. #1282.

This pull request introduces a new 'snap' mode for the dragFree option, allowing a "hybrid"-mode of default snapping and free-dragging. It acts just like dragFree: true, but the final settle destination is always at a snapping point.

The documentation for dragFree has been updated accordingly, as well as the documentation for skipSnaps which previously mentioned dragFree: true but now also includes dragFree: 'snap'.

Since the values for dragFree has been changed from just true/false, I refactored the documentation components a bit to radio buttons as well as adding a title.

Video

slidesToScroll: 1

screenrecord.mp4

slidesToScroll: 2

screenrecord.mp4

[davidjerleke]

Hi @ehellman,

Welcome, and glad to have you here ⭐!

Unfortunately, I didn’t get a chance to give you a heads-up that the generator has been deprecated and the documentation structure has changed quite a bit:

• [Docs]: Migrate Docs from GatsbyJS --> NextJs #1303

Before I can test this PR, a couple of updates are needed:

1. We can discard any changes made to the generator files since they’re no longer used.
2. The documentation site now lives under the website/ folder. The changes should be added to the v9 options.mdx file instead.

Sorry about the inconvenience, and thanks again for taking the time to work on this. Looking forward to testing the feature once it’s updated!