feat: add blas/base/srot

[aman-095]

Resolves #277.

Description

This RFC proposes to add a routine to apply a plane rotation as defined in BLAS Level 1 routines. Specifically adding @stdlib/blas/base/srot is proposed.

Related Issues

Does this pull request have any related issues?

This pull request:

• resolves RFC: add BLAS Level 1 srot routine #277

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

[aman-095]

CC @kgryte @Pranavchiku

[kgryte]

As this PR likely requires all of the same changes as requested in #1823, I'll mark this PR accordingly.

[kgryte]

LGTM. Thanks, @aman-095!

One comment: test tolerances should be consistent across comparable API tests. E.g., if we use 5.0 * EPS for srot.js, we should use 5.0 * EPS for an equivalent test in ndarray.js. Similarly, if a native binding requires 5.0 * EPS to pass (e.g., due to Fortran divergence from C), that same tolerance should be used for the JavaScript implementation. Tolerances serve two purposes:

1. To sanity check that we have reasonable results relative to a reference implementation/expected value. If we observe significant divergence (e.g., 100.0 * EPS) that is a code smell that something is going wrong.
2. To project against future regressions.

In this case, our tests act as our stated contract with end users. If we can only "guarantee" 5.0 * EPS agreement with a reference implementation due to Fortran shenanigans, that should be the case across all implementations.