Add Fisher-Yates shuffle algorithm

[MXASoundNDEv]

Motivation

• Provide a standard, efficient array shuffling utility (Fisher–Yates) for consumers of the library.
• Keep the API consistent with existing utilities and support deterministic shuffles via an injectable RNG.
• Expose the function in the main exports and TypeScript definitions so it can be used across the codebase.

Description

• Added algorithms/fisherYatesShuffle.js implementing Fisher–Yates with an optional random function parameter.
• Exported the function from index.js as fisherYatesShuffle and added a signature to index.d.ts.
• Added tests in test/fisherYatesShuffle.test.js and updated test/compareAll.test.js to assert the function is exported.
• Documented usage in README.md and updated the documented test count.

Testing

• Ran the full test suite with npm test; new Fisher–Yates tests passed and overall run produced 150 passing with 2 failing.
• The two failing tests are unrelated to this change and originate from soundex multilingual/custom mapping assertions.
• Verified the new fisherYatesShuffle unit tests cover: immutability, element preservation, deterministic output with custom RNG, and empty-array handling.

---

Codex Task

[Copilot]

Pull request overview

This PR adds a Fisher-Yates shuffle algorithm implementation to the library, providing users with a standard, efficient array shuffling utility that supports deterministic shuffles via an injectable random number generator.

• Implements the Fisher-Yates shuffle algorithm with optional custom RNG support
• Exports the new function through the main module and TypeScript definitions
• Adds comprehensive test coverage and documentation

Reviewed changes

Copilot reviewed 5 out of 6 changed files in this pull request and generated 2 comments.

Show a summary per file

File	Description
algorithms/fisherYatesShuffle.js	Implements the Fisher-Yates shuffle algorithm with an optional random function parameter
index.js	Exports the new fisherYatesShuffle function from the main module
index.d.ts	Adds TypeScript type definitions for the fisherYatesShuffle function
test/fisherYatesShuffle.test.js	Adds 4 test cases covering immutability, element preservation, deterministic output, and edge cases
test/compareAll.test.js	Adds assertion to verify fisherYatesShuffle is exported
README.md	Updates documentation with usage examples and test count badge

---

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

[Copilot]

The test count in the badge is incorrect. The PR description states that the baseline was 114 tests and this PR adds 4 new test cases (visible in the new fisherYatesShuffle.test.js file). The badge should show 118 passing tests, not 115. Additionally, the PR description mentions "150 passing" which is inconsistent with both this badge and the stated baseline.

Suggested change

	[](./test/)
	[](./test/)

[Copilot]

The test count in this documentation section is incorrect. The PR description states the baseline was 114 tests and this PR adds 4 new test cases, so the total should be 118 tests, not 115. This should match the test count in the badge on line 5.