[WIP] - replace preventDefaultTouchmoveEvent with touchEventOptions

[hartzis]

Attempt to remove preventDefaultTouchmoveEvent which has always been a very complicated and hard to describe prop and replace it with touchEventOptions.

Mimicking our good friends over at https://use-gesture.netlify.app/docs/options/#eventoptions

touchEventOptions: AddEventListenerOptions

• defaults to { passive: true }
• gives react-swipeable users more control over the events and when and if they want to call things like event.preventDefault

Possible solution for both #224 and #231.

TODOs:

• [ ] update/fix/add tests
• [ ] update documentation
• [ ] add migration from preventDefaultTouchmoveEvent and examples on how to prevent scrolling via calling event.preventDefault in user land manually
• [ ] add FAQ example for onTap solution when trackTouch and trackMouse are true

[hartzis]

Closing in favor of #240 and maintaining the ease provided by a prop to prevent scrolling.

After having a great discussion with @stefvhuynh about usability and interfaces we decided to move forward with a more user friendly prop that is explicit with it's intent, preventScrollOnSwipe.

We may also add these event options additionally to provide users with more power, but we can continue to investigate the need for that.