test(heatmapUtils-type-compiler): implement static typescript validation and schema constraints #7109

[swarupio]

Description

This PR introduces a new test suite (heatmapUtils.type-compiler.test.ts) to verify TypeScript compiler validation and schema constraints for the heatmap utilities.

Key implementations include:

• Utilizing expectTypeOf to strictly enforce field property configurations for the heatmap schema.
• Asserting that invalid prop parameters are correctly blocked during static type checking using @ts-expect-error.
• Verifying that custom types accept optional values (level) without compilation errors.
• Ensuring strict schema validation constraints correctly narrow types (e.g., from unknown to ExpectedHeatmapSchema) and return accurate validation reports without triggering TypeScript inference issues.

Fixes #7109

Pillar

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

Test Cases

Checklist before requesting a review:

• I have read the CONTRIBUTING.md file.
• I have tested these changes locally (localhost:3000/api/streak?user=YOUR_USERNAME).
• I have run npm run format and npm run lint locally and resolved all errors (CI will fail otherwise).
• My commits follow the Conventional Commits format (e.g., feat(themes): ..., fix(calculate): ...).
• I have updated README.md if I added a new theme or URL parameter.
• I have started the repo.
• 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 (no raw elements, smooth animations, correct fonts).
• (Recommended) I joined the CommitPulse Discord community for contributor discussions, mentorship, and faster PR support.

[github-actions]

📦 Next.js Bundle Size Report (Gzipped Sizes)

✨ No significant bundle size changes detected.

📊 Summary of Totals

Category	PR Size	Base Size	Difference
Total JS	3883.44 KB	3883.44 KB	0 B
Total CSS	323.09 KB	323.09 KB	0 B

[swarupio]

@JhaSourav07 please review and merge it!

[swarupio]

@Aamod007 hey , please approve the PR!

[Aamod007]

Hey! Thanks for adding the TypeScript compiler validation tests for the heatmap utilities. Validating the return structures explicitly prevents downstream components from breaking if internal util signatures change.

I'm assigning level:beginner, type:testing, and quality:clean.

Solid, approving!

[github-actions]

🎉 Congratulations @swarupio! Your PR has been successfully merged. 🚀

Thank you for contributing to CommitPulse. Your work helps us build a better tool for the community.

⚠️ Important for GSSoC Contributors:
You are strictly advised to join our Discord Server as it is mandatory for all GSSoC participants. All important announcements, point claims, and community discussions happen there.

Keep building! 💻✨