feat: implement touch event deduplication to prevent double-triggers (#330)

[daddygokings-art]

Closes #330

---

Description

Implements touch event deduplication to prevent accidental double-submissions and unintended actions caused by multiple touch events firing for a single tap.

Problem Statement

• Single tap sometimes triggers multiple events
• Users unintentionally trigger double-submissions on forms
• Accidental duplicate API calls consume bandwidth and resources

Solution

Provides two complementary APIs for touch event deduplication:

1. useTouchDeduplication hook - For use within React components
2. withTouchDeduplication wrapper - For use outside React hooks

Both track last tap time and coordinates, ignoring subsequent taps within a configured threshold at the same location.

Changes

• ✅ Add useTouchDeduplication hook for React components with configurable threshold (default 300ms) and coordinate tolerance (default 10px)
• ✅ Add withTouchDeduplication wrapper for use outside React hooks
• ✅ Add comprehensive test suite covering duplicate prevention, async handlers, and form submissions
• ✅ Add detailed specification and implementation guide documentation

Features

• Tracks last tap time and coordinates to identify duplicates
• Ignores duplicate taps within 300ms at same location
• Prevents concurrent execution of async handlers
• Optional onDuplicate callback for telemetry or analytics
• Minimal memory and CPU overhead
• Handles both synchronous and asynchronous handlers

Testing

• All 14 tests pass

Acceptance Criteria

• Implement touch event deduplication
• Track last tap time and coordinates
• Ignore duplicate taps within 300ms at same location
• Test form submissions don't double-submit
• Document touch event specification

Files Changed

• src/hooks/useTouchDeduplication.ts - Core implementation
• src/hooks/index.ts - Export hook
• tests/hooks/useTouchDeduplication.test.ts - Comprehensive test suite
• docs/TOUCH_EVENT_DEDUPLICATION.md - Detailed specification and usage guide

[drips-wave]

@daddygokings-art Great news! 🎉 Based on an automated assessment of this PR, the linked Wave issue(s) no longer count against your application limits.

You can now already apply to more issues while waiting for a review of this PR. Keep up the great work! 🚀

Learn more about application limits

[RUKAYAT-CODER]

Kindly resolve conflict and fix workflow.