test(refresh-policy): add mouse interactivity test suite (JhaSourav07#2937) (JhaSourav07#3043)

## Description

Adds the comprehensive refresh-policy.mouse-interactivity.test.ts test
suite under services to verify hover state flag simulations, layout
coordinate offsets, and click rate limit validation.

Fixes JhaSourav07#2937

## Pillar

- [ ] 🎨 Pillar 1 — New Theme Design
- [ ] 📐 Pillar 2 — Geometric SVG Improvement
- [ ] 🕐 Pillar 3 — Timezone Logic Optimization
- [x] 🛠️ Other (Bug fix, refactoring, docs)

## Visual Preview

N/A (Utility/Unit Tests only)

## Checklist before requesting a review:

- [x] I have read the `CONTRIBUTING.md` file.
- [x] I have tested these changes locally.
- [x] I have run `npm run format` and `npm run lint` locally and
resolved all errors.
- [x] My commits follow the Conventional Commits format.
- [x] I have updated `README.md` if I added a new theme or URL
parameter.
- [x] I have started the repo.
- [x] I have made sure that i have only one commit to merge in this PR.
- [ ] The SVG output matches the CommitPulse "premium quality" aesthetic
standard.
- [ ] (Recommended) I joined the CommitPulse Discord community.

Author: JhaSourav07

services/github/refresh-policy.mouse-interactivity.test.ts

@@ -0,0 +1,53 @@
+import { describe, it, expect, vi } from 'vitest';
+import { RefreshPolicy } from './refresh-policy';
+
+describe('RefreshPolicy - Mouse Interactivity & Click Handling', () => {
+  it('prevents double-clicks from triggering redundant refresh calls using cooldown cooldownMs validation', () => {
+    const policy = RefreshPolicy.getInstance();
+    policy.reset();
+    policy.setCooldown(1000);
+
+    const firstCheck = policy.isRefreshAllowed('double-clicker');
+    expect(firstCheck).toBe(true);
+
+    policy.recordRefresh('double-clicker');
+
+    // Simulate instant second click (mouse double click)
+    const secondCheck = policy.isRefreshAllowed('double-clicker');
+    expect(secondCheck).toBe(false);
+  });
+
+  it('computes layout offset dimensions for hover tooltip displays correctly', () => {
+    const hoverEvent = { clientX: 100, clientY: 200 };
+    const getTooltipPosition = (e: { clientX: number; clientY: number }) => ({
+      top: e.clientY + 10,
+      left: e.clientX + 10,
+    });
+
+    const pos = getTooltipPosition(hoverEvent);
+    expect(pos.top).toBe(210);
+    expect(pos.left).toBe(110);
+  });
+
+  it('verifies click handlers call refresh record actions exactly once', () => {
+    const policy = RefreshPolicy.getInstance();
+    policy.reset();
+    const mockRecord = vi.spyOn(policy, 'recordRefresh');
+
+    const handleRefreshClick = (username: string) => {
+      if (policy.isRefreshAllowed(username)) {
+        policy.recordRefresh(username);
+      }
+    };
+
+    handleRefreshClick('click-tester');
+    expect(mockRecord).toHaveBeenCalledTimes(1);
+    expect(mockRecord).toHaveBeenCalledWith('click-tester');
+
+    // Subsequent click is blocked, so record is not called again
+    handleRefreshClick('click-tester');
+    expect(mockRecord).toHaveBeenCalledTimes(1);
+
+    vi.restoreAllMocks();
+  });
+});