feat: add GamepadVisualizer and compatibility APIs

[ReenigneArcher]

Description

Introduces GamepadVisualizer for rendering Xbox, PlayStation, and Nintendo Switch controller artwork with live button/trigger/stick state updates. Adds getControllerImagePath() and getControllerVisualConfig() helpers, plus getCompatibilityIssues() for surfacing known browser/controller issues (e.g. Firefox + Switch mapping bug). All new APIs are covered by tests.

Screenshot

Issues Fixed or Closed

Roadmap Issues

Type of Change

• feat: New feature (non-breaking change which adds functionality)
• fix: Bug fix (non-breaking change which fixes an issue)
• docs: Documentation only changes
• style: Changes that do not affect the meaning of the code (white-space, formatting, missing semicolons, etc.)
• refactor: Code change that neither fixes a bug nor adds a feature
• perf: Code change that improves performance
• test: Adding missing tests or correcting existing tests
• build: Changes that affect the build system or external dependencies
• ci: Changes to CI configuration files and scripts
• chore: Other changes that don't modify src or test files
• revert: Reverts a previous commit
• BREAKING CHANGE: Introduces a breaking change (can be combined with any type above)

Checklist

• Code follows the style guidelines of this project
• Code has been self-reviewed
• Code has been commented, particularly in hard-to-understand areas
• Code docstring/documentation-blocks for new or existing methods/components have been added or updated
• Unit tests have been added or updated for any new or modified functionality

AI Usage

See our AI usage policy.

• None: No AI tools were used in creating this PR
• Light: AI provided minor assistance (formatting, simple suggestions)
• Moderate: AI helped with code generation or debugging specific parts
• Heavy: AI generated most or all of the code changes

[codecov]

Bundle Report

Changes will increase total bundle size by 12.82kB (86.59%) ⬆️⚠️, exceeding the configured threshold of 5%.

Bundle name	Size	Change
gamepad-helper-array-push	20.58kB	12.82kB (165.33%) ⬆️⚠️

Affected Assets, Files, and Routes:

view changes for bundle: gamepad-helper-array-push

Assets Changed:

Asset Name	Size Change	Total Size	Change (%)
gamepad-helper.js	12.82kB	20.58kB	165.33% ⚠️

Files in gamepad-helper.js:

• ./src/js/gamepad-visualizer.js → Total Size: 21.25kB

• ./src/js/gamepad-helper.js → Total Size: 21.75kB

[codecov]

Codecov Report

✅ All modified and coverable lines are covered by tests.
✅ Project coverage is 100.00%. Comparing base (2fa427a) to head (f402d4b).
✅ All tests successful. No failed tests found.

Additional details and impacted files

@@            Coverage Diff             @@
##            master      #186    +/-   ##
==========================================
  Coverage   100.00%   100.00%            
==========================================
  Files            1         2     +1     
  Lines           96       292   +196     
  Branches        30        66    +36     
==========================================
+ Hits            96       292   +196     

Files with missing lines	Coverage Δ
src/js/gamepad-helper.js	100.00% <100.00%> (ø)
src/js/gamepad-visualizer.js	100.00% <100.00%> (ø)

---

Continue to review full report in Codecov by Harness.

Legend - Click here to learn more
Δ = absolute <relative> (impact), ø = not affected, ? = missing data
Powered by Codecov. Last update 2fa427a...f402d4b. Read the comment docs.

[sonarqubecloud]

Quality Gate passed

Issues
0 New issues
0 Accepted issues

Measures
0 Security Hotspots
0.0% Coverage on New Code
0.0% Duplication on New Code

See analysis details on SonarQube Cloud