feat: add stats/base/ndarray/meankbn

[Bureir]

Resolves #8095

Description

What is the purpose of this pull request?

This pull request:

• adds @stdlib/stats/base/ndarray/meankbn, an ndarray wrapper around @stdlib/stats/strided/meankbn implementing the improved Kahan–Babuška compensation algorithm;
• mirrors the API and behavior of @stdlib/stats/base/ndarray/mean (supports empty and singleton inputs, non-unit and negative strides, and non-zero offsets);
• includes comprehensive unit tests adapted from ndarray/mean, plus a numerics test demonstrating improved conditioning on [1e16, 1, -1e16];
• adds an example and a benchmark;
• adds README and docs (types, REPL transcript, and equation SVG).

Related Issues

Does this pull request have any related issues?

This pull request:

• resolves [RFC]: add stats/base/ndarray/meankbn #8095

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.

---

@stdlib-js/reviewers

[stdlib-bot]

👋 Hi there! 👋

And thank you for opening your first pull request! We will review it shortly. 🏃 💨

Getting Started

• Please read our contributing guidelines if you haven't already.
• For development guidance, refer to the development guide.

Next Steps

1. A project maintainer will approve GitHub Actions workflows for your PR.
2. All CI checks must pass before your submission can be fully reviewed.
3. You'll need to address any failures in linting or unit tests.

Running Tests Locally

You can use make to run any of the CI commands locally from the root directory of the stdlib repository:

# Run tests for all packages in the math namespace:
make test TESTS_FILTER=".*/@stdlib/math/.*"

# Run benchmarks for a specific package:
make benchmark BENCHMARKS_FILTER=".*/@stdlib/math/base/special/sin/.*"

If you haven't heard back from us within two weeks, please ping us by tagging the "reviewers" team in a comment on this PR.

If you have any further questions while waiting for a response, please join our Gitter channel to chat with project maintainers and other community members.

We appreciate your contribution!

Documentation Links

• Contributing Guidelines
• Development Guide
• Gitter channel
• make rules for running examples
• make rules for running unit tests
• make rules for running benchmarks

[stdlib-bot]

Coverage Report

Package	Statements	Branches	Functions	Lines
stats/base/ndarray/meankbn	$\color{green}99/99$ $\color{green}+100.00\%$	$\color{green}3/3$ $\color{green}+100.00\%$	$\color{green}1/1$ $\color{green}+100.00\%$	$\color{green}99/99$ $\color{green}+100.00\%$

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

[Bureir]

Addressed review feedback: updated README, aligned index.js and example with project conventions, and normalized package.json. Tests and example pass locally. PTAL. @kgryte

[Bureir]

Thanks for the quick review! I’ve aligned the new package with project conventions by:

• Rewriting the README to match the structure of sibling packages (Usage / Notes / Examples / See Also), fixed code fences and wording, and clarified the ndarray call shape.

• Updating index.js and lib/index.js to include license headers, module JSDoc, and proper re-export of ./lib.

• Making the example build a typed ndarray and print the result (mirrors ndarray/mean style).

• Normalizing package.json fields (name, description, license, main, keywords).

• Verifying tests/examples/benchmarks pass locally for this package.

If there are any remaining convention nits (section order, phrasing, example format, or types), I’m happy to adjust. PTAL, thanks! @kgryte

[Bureir]

@kgryte

[headlessNode]

@Bureir The README.md file needs to updated. For reference see

[Bureir]

@headlessNode @kgryte Resolved README.md not following project conventions :) PTAL

[Bureir]

Reviewing, one moment

[Bureir]

@headlessNode Fully reviewed and fixed, there was a local version issue and this should almost perfectly meet project conventions unless I misunderstood something. Please see my commit title, I went through each file. I could have missed something but can fix things quickly.

[headlessNode]

LGTM. @kgryte will do the final check & merge.

[Bureir]

@kgryte @headlessNode Fixed spacing

[kgryte]

LGTM after clean-up.

[kgryte]

Thank you for your contribution and congratulations on your first PR!