@function __shuffle($collection) {
  $collection: __to-iterable($collection);
  $index: 1;
  $length: length($collection);
  $result: ();

  @while ($index <= $length) {
    $rand: __base-rand(1, $index);

    @if ($index != $rand) {
      $result: __set($result, $index, __get($result, $rand));
    }

    $result: __set($result, $rand, __get($collection, $index));
    $index: $index + 1;
  }

  @return __to-list($result);
}

/// Creates a list of shuffled values, using a version of the Fisher-Yates
/// shuffle. See [Wikipedia](https://en.wikipedia.org/wiki/Fisher-Yates_shuffle)
/// for more details.
///
///
/// @access public
/// @group Collection
/// @param {List|Map|string} $collection The collection to shuffle.
/// @returns {List} Returns the new shuffled list.
/// @example scss
/// $foo: _shuffle((1, 2, 3, 4));
/// // => (4, 1, 3, 2)

@function _shuffle($args...) {
  @return call(get-function("__shuffle"), $args...);
}