Add tap gesture APIs and examples

[Kyle-Ye]

Summary

• Add TapGesture support, including the public gesture API, tap-count handling, gesture phase mapping, and View.onTapGesture(count:perform:).
• Add SpatialTapGesture support with coordinate-space location reporting and matching View.onTapGesture(count:coordinateSpace:perform:) overloads.
• Add shared examples for TapGesture and SpatialTapGesture.
• Add DocC documentation for the new gesture APIs and align availability annotations with OpenSwiftUI availability macros.

Related

• Related to Add Gesture support #772.
• Builds on Complete gesture view modifier support #905.

[augmentcode]

🤖 Augment PR Summary

Summary: This PR introduces tap gesture support to OpenSwiftUI, including both basic tap detection and spatial tap location reporting.

Changes:

• Added a new public TapGesture primitive gesture in OpenSwiftUICore, plus View.onTapGesture(count:perform:) convenience.
• Added a new public SpatialTapGesture primitive gesture in OpenSwiftUI, including tap-count handling and coordinate-space location reporting.
• Implemented shared internals for tap recognition via SingleTapGesture, using duration/movement thresholds, event filtering, repeat counting, and required tap-count preferences.
• Added example views demonstrating TapGesture and SpatialTapGesture usage.
• Hardened RepeatGesture by preconditioning that the repeat count is positive.
• Updated DocC/availability annotations, including aligning Image.DynamicRange environment APIs with OpenSwiftUI availability macros.

Technical Notes: Spatial tap values map gesture phases from TappableSpatialEvent into a public value type containing the interaction location in the requested coordinate space.

_{🤖 Was this summary useful? React with 👍 or 👎}

[augmentcode]

Review completed. 2 suggestions posted.

Comment augment review to trigger a new review at any time.