feat: add potential WPM calculation ignoring adjacent swap errors (@BhavishyaMaheshwari)

[BhavishyaMaheshwari]

Description

Added a "Potential WPM" feature that calculates an alternate typing speed ignoring minor adjacent character swap errors (transpositions). This provides users insight into what their speed would be if they hadn't made simple typos like typing "teh" instead of "the" or "form" instead of "from".

Key Features:

• Detects adjacent character swaps only (e.g., "teh" → "the", "from" → "form")
• Calculates potential WPM treating swaps as correct
• Displays a small button next to the WPM during typing and on results screen
• Button only appears when swap errors are detected
• Hover shows potential WPM in a compact tooltip (0.75rem, positioned below button)
• Click shows detailed popup with swap count and comparison

Implementation Details:

• Added isMinorSwap() utility function to detect adjacent character transpositions
• Modified stats tracking to count minor swap errors separately from real errors
• Updated accuracy calculation to treat swaps as correct
• Added UI components in live-speed and result screens
• Custom styling with balloon.css for consistent tooltip appearance
• Total changes: ~948 lines added across 15 files

Files Modified:

• frontend/src/ts/typing.ts - Added swap detection
• frontend/src/ts/stats.ts - NEW: Helper functions and state management
• frontend/src/ts/utils/swap-detection.ts - NEW: Swap detection utility
• frontend/src/ts/test/test-stats.ts - Updated WPM calculation
• frontend/src/ts/controllers/input-controller.ts - Accuracy treats swaps as correct
• frontend/src/ts/test/live-speed.ts - Live WPM display with potential button
• frontend/src/ts/test/result.ts - Results screen integration
• frontend/src/ts/test/test-logic.ts - Reset counters on test start
• frontend/src/ts/test/test-input.ts - Input processing
• frontend/src/ts/test/test-timer.ts - Timer integration
• frontend/src/styles/test.scss - Button styling, popup, tooltips
• frontend/src/svelte/Results.svelte - Svelte component updates
• frontend/src/ts/utils/misc.ts - Utility export
• frontend/src/ts/EXAMPLE_USAGE.ts - NEW: Documentation

Checks

• Check if any open issues are related to this PR
• Make sure the PR title follows the Conventional Commits standard
• Make sure to include your GitHub username prefixed with @ inside parentheses at the end of the PR title

Screenshots

1. The example swap
   
2. The small button next to WPM during typing
   
3. The hover tooltip showing "Potential: XX.XX"
   
4. Raw vs potential speed (basically showing that they are different)
   

Future (potential) changes

• Add more factors to potential wpm calculation such as, accidental spacebars, double key presses etc.

[socket-security]

Review the following changes in direct dependencies. Learn more about Socket for GitHub.

Diff	Package	Supply Chain Security	Vulnerability	Quality	Maintenance	License
	express@​5.1.0
	express-rate-limit@​7.5.1
	disposable-email-domains-js@​1.16.0 ⏵ 1.18.0	+3		+7

View full report

[github-actions]

Continuous integration check(s) failed. Please review the failing check's logs and make the necessary changes.

[Miodec]

AI generated (why would you add a svelte file???) PR for an undiscussed, unwanted feature. Sorry, closing this one.