feat(stats): add C implementation for stats/base/dists/hypergeometric/kurtosis

[whizzel]

Resolves #3660 .

Description

What is the purpose of this pull request?

This pull request:

• Adds a C implementation of the excess kurtosis of a hypergeometric distribution.
• Includes benchmarks for the C implementation.
• Provides examples demonstrating the usage of the excess kurtosis of a hypergeometric distribution in C.

Related Issues

Does this pull request have any related issues?

This pull request has the following related issues:

• [RFC]: Add C implementation for @stdlib/stats/base/dists/hypergeometric/kurtosis #3660

Questions

Any questions for reviewers of this pull request?

No.

Other

Any other information relevant to this pull request? This may include screenshots, references, and/or implementation notes.

No.

Checklist

Please ensure the following tasks are completed before submitting this pull request.

• Read, understood, and followed the contributing guidelines.

AI Assistance

When authoring the changes proposed in this PR, did you use any kind of AI assistance?

• Yes
• No

If you answered "yes" above, how did you use AI assistance?

• Code generation (e.g., when writing an implementation or fixing a bug)
• Test/benchmark generation
• Documentation (including examples)
• Research and understanding

Disclosure

If you answered "yes" to using AI assistance, please provide a short disclosure indicating how you used AI assistance. This helps reviewers determine how much scrutiny to apply when reviewing your contribution. Example disclosures: "This PR was written primarily by Claude Code." or "I consulted ChatGPT to understand the codebase, but the proposed changes were fully authored manually by myself.".

{{TODO: add disclosure if applicable}}

---

@stdlib-js/reviewers

[stdlib-bot]

Coverage Report

Package	Statements	Branches	Functions	Lines
stats/base/dists/hypergeometric/kurtosis	$\\color{green}207/207$ $\\color{green}+0.00\\%$	$\\color{green}13/13$ $\\color{green}+0.00\\%$	$\\color{green}2/2$ $\\color{green}+0.00\\%$	$\\color{green}207/207$ $\\color{green}+0.00\\%$

The above coverage report was generated for the changes in this PR.

[Planeshifter]

Thanks for this PR!

[rautelaKamal]

Hey @ivishal-g, great job adding the C implementation! I took a look at the logic and the edge cases.

Since the variance of the hypergeometric distribution goes to zero when K = 0, K = N, n = 0, or n = N (meaning the kurtosis is undefined / NaN), your checks for K <= 0.0, n <= 0.0, K >= N, and n >= N in main.c perfectly handle those boundary conditions returning NaN.

I noticed @Planeshifter asked for a few cleanup items in his review (like changing t.ok to t.strictEqual( isnan(y), true, ... ) in the tests, fixing the copy-pasted K test block, and removing the unused pinf / floor dependencies from manifest.json).

If you need any help fixing those tests or modifying the manifest.json, feel free to ping me here! Happy to help you get this merged. 🚀

[whizzel]

thank you @rautelaKamal,

I’ve addressed the cleanup points you mentioned — updated the tests to use t.strictEqual( isnan(y), true ), fixed the copy-pasted K test block, and removed the unused pinf / floor dependencies from manifest.json.

Feel free to take another look at the latest commit to see how I handled those changes. Let me know if anything else needs improvement.

[Copilot]

Copilot wasn't able to review any files in this pull request.

---

💡 Add Copilot custom instructions for smarter, more guided reviews. Learn how to get started.

[Planeshifter]

Let's get it in!

[stdlib-bot]

PR Commit Message

feat: add C implementation for `stats/base/dists/hypergeometric/kurtosis`

PR-URL: https://github.com/stdlib-js/stdlib/pull/10360
Closes: https://github.com/stdlib-js/stdlib/issues/3660

Co-authored-by: Neeraj Pathak <neerajrpathak710@gmail.com>
Co-authored-by: Philipp Burckhardt <pburckhardt@outlook.com>
Reviewed-by: Philipp Burckhardt <pburckhardt@outlook.com>

Please review the above commit message and make any necessary adjustments.