fixing JSDOCS for Sorts Folder the folder that been modified are AlphaNumerical,BeadSort,BogoSort,BubbleSort,CocktailShakerSort,CountinfSort,FindSecondsLargestElementSort,FisherYatesShuffle

Author: mohmmadAyesh

Diff for: Sorts/AlphaNumericalSort.js

@@ -17,9 +17,14 @@
   2. z11
 
   P.S. use this function, as there are a lot of implementations on the stackoverflow and other forums, but many of them don't work correctly (can't pass all my tests)
-
+  
 */
-
+/**
+ * @param {string} a The first string to compare.
+ * @param {string} b The second string to compare.
+ * @returns {number} Returns a number indicating whether the first string comes before, after, or is the same as the second string in sort order.
+ *                   -1 if a comes before b, 1 if a comes after b, and 0 if they are the same.
+ */
 const alphaNumericalSort = (a, b) => {
   /*
     https://developer.mozilla.org/ru/docs/Web/JavaScript/Reference/Global_Objects/String/localeCompare

Diff for: Sorts/BeadSort.js

@@ -7,6 +7,9 @@
  * NOTE: It only works for arrays of positive integers.
  *
  * Wikipedia: https://en.wikipedia.org/wiki/Bead_sort
+ * @param {number[]} sequence An array of positive integers to be sorted using Bead Sort.
+ * @returns {number[]} Returns a sorted array of positive integers using Bead Sort.
+ * @throws {RangeError} Throws a RangeError if the input sequence contains any negative integers.
  */
 export function beadSort(sequence) {
   /* Let's ensure our sequence has only Positive Integers */

Diff for: Sorts/BogoSort.js

@@ -1,5 +1,7 @@
 /**
  * Checks whether the given array is sorted in ascending order.
+ * @param {number[]} array The array to be checked for sorted order.
+ * @returns {boolean} Returns true if the array is sorted in ascending order, false otherwise.
  */
 export function isSorted(array) {
   const length = array.length
@@ -13,6 +15,7 @@ export function isSorted(array) {
 
 /**
  * Shuffles the given array randomly in place.
+ * @param {any[]} array The array to be shuffled.
  */
 function shuffle(array) {
   for (let i = array.length - 1; i; i--) {

Diff for: Sorts/BubbleSort.js

@@ -15,6 +15,8 @@
 
 /**
  * Using 2 for loops.
+ * @param {number[]} items The array to be sorted.
+ * @returns {number[]} The sorted array.
  */
 export function bubbleSort(items) {
   const length = items.length
@@ -42,6 +44,8 @@ export function bubbleSort(items) {
 
 /**
  * Using a while loop and a for loop.
+ * @param {number[]} arr The array to be sorted.
+ * @returns {number[]} The sorted array.
  */
 export function alternativeBubbleSort(arr) {
   let swapped = true

Diff for: Sorts/CocktailShakerSort.js

@@ -7,6 +7,9 @@
  *
  * Wikipedia (Cocktail Shaker Sort): https://en.wikipedia.org/wiki/Cocktail_shaker_sort
  * Wikipedia (Bubble Sort): https://en.wikipedia.org/wiki/Bubble_sort
+ *
+ * @param {number[]} items The array of numbers to be sorted.
+ * @returns {number[]} The sorted array.
  */
 export function cocktailShakerSort(items) {
   for (let i = items.length - 1; i > 0; i--) {

Diff for: Sorts/CountingSort.js

@@ -6,6 +6,11 @@
  *
  * Wikipedia: https://en.wikipedia.org/wiki/Counting_sort
  * Animated Visual: https://www.cs.usfca.edu/~galles/visualization/CountingSort.html
+ *
+ * @param {number[]} arr The array to be sorted.
+ * @param {number} min The minimum value in the array.
+ * @param {number} max The maximum value in the array.
+ * @returns {number[]} The sorted array.
  */
 
 export const countingSort = (arr, min, max) => {

Diff for: Sorts/FindSecondLargestElement.js

@@ -8,7 +8,11 @@
  * Resources:
  * https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Set
  */
-
+/**
+ * Finds the second largest element in an array of numbers while filtering out duplicate values.
+ * @param {number[]} array The array of numbers.
+ * @returns {number} The second largest element in the array.
+ */
 const secondLargestElement = (array) => {
   const largestElement = Math.max(...array)
   let element = -Number.MAX_VALUE

Diff for: Sorts/FisherYatesShuffle.js

@@ -1,3 +1,8 @@
+/**
+ * Shuffles the elements of the given array randomly in place.
+ * @param {Array} array The array to be shuffled.
+ * @returns {Array} The shuffled array.
+ */
 export const shuffle = (array) => {
   let maxLength = array.length
   let temp