SassyLists 2.2.1 → 2.2.2

data/stylesheets/SassyLists/_replace-nth.scss

@@ -1,19 +1,21 @@
-// Replaces value at `$index` from `$list` by `$value`.
-//
-// @ignore Documentation: http://sassylists.com/documentation.html#sl-replace-nth
-//
-// @requires sl-purge
-// @requires sl-is-true
-// @requires sl-to-list
-//
-// @param {List}   $list  - list to update
-// @param {Number} $index - index to update
-// @param {*}      $value - new value for index
-//
-// @throws Invalid index $index for `sl-replace-nth`.
-//
-// @return {List | Null}
-
+/**
+ * Replaces value at `$index` from `$list` by `$value`.
+ *
+ * @ignore Documentation: http://sassylists.com/documentation.html#sl-replace-nth
+ *
+ * @requires sl-purge
+ * @requires sl-is-true
+ * @requires sl-to-list
+ *
+ * @param {List}   $list  - list to update
+ * @param {Number} $index - index to update
+ * @param {*}      $value - new value for index
+ *
+ * @throws Invalid index $index for `sl-replace-nth`.
+ *
+ * @return {List | Null}
+ */
+ 
 @function sl-replace-nth($list, $index, $value) {
   @if sl-missing-dependencies(sl-purge, sl-is-true, sl-to-list) == true { @return null; }
 

data/stylesheets/SassyLists/_replace.scss

@@ -1,17 +1,19 @@
-// Replaces `$old` by `$new` in `$list`.
-//
-// @ignore Documentation: http://sassylists.com/documentation.html#replace
-//
-// @requires sl-is-true
-// @requires sl-purge
-// @requires sl-to-list
-//
-// @param {List}    $list  - list to update
-// @param {*}       $old   - value to replace
-// @param {*}       $value - new value for $old
-//
-// @return {List}
-
+/**
+ * Replaces `$old` by `$new` in `$list`.
+ *
+ * @ignore Documentation: http://sassylists.com/documentation.html#replace
+ *
+ * @requires sl-is-true
+ * @requires sl-purge
+ * @requires sl-to-list
+ *
+ * @param {List}    $list  - list to update
+ * @param {*}       $old   - value to replace
+ * @param {*}       $value - new value for $old
+ *
+ * @return {List}
+ */
+ 
 @function sl-replace($list, $old, $value) {
   @if sl-missing-dependencies(sl-is-true, sl-purge, sl-to-list) == true { @return null; }
 

data/stylesheets/SassyLists/_reverse.scss

@@ -1,12 +1,14 @@
-// Reverses the order of `$list`.
-//
-// @ignore Documentation: http://sassylists.com/documentation.html#sl-reverse
-//
-// @param {List} $list - list to reverse
-//
-// @requires sl-to-list
-//
-// @return {List}
+/**
+ * Reverses the order of `$list`.
+ *
+ * @ignore Documentation: http://sassylists.com/documentation.html#sl-reverse
+ *
+ * @param {List} $list - list to reverse
+ *
+ * @requires sl-to-list
+ *
+ * @return {List}
+ */
 
 @function sl-reverse($list) {
   @if sl-missing-dependencies(sl-to-list) == true { @return null; }
@@ -27,9 +29,11 @@
   @return sl-to-list($list);
 }
 
-// @requires sl-reverse
-// @alias sl-reverse
-
+/**
+ * @requires sl-reverse
+ * @alias sl-reverse
+ */
+ 
 @function sl-mirror($list) {
   @return sl-reverse($list);
 }

data/stylesheets/SassyLists/_shuffle.scss

@@ -1,12 +1,14 @@
-// Shuffle `$list` using Fisher-Yates method.
-//
-// @ignore Documentation: http://sassylists.com/documentation.html#sl-shuffle
-//
-// @param {List} $list - list to shuffle
-//
-// @requires sl-to-list
-// 
-// @return {List}
+/**
+ * Shuffle `$list` using Fisher-Yates method.
+ *
+ * @ignore Documentation: http://sassylists.com/documentation.html#sl-shuffle
+ *
+ * @param {List} $list - list to shuffle
+ *
+ * @requires sl-to-list
+ * 
+ * @return {List}
+ */
 
 @function sl-shuffle($list) {
   @if sl-missing-dependencies(sl-to-list) == true { @return null; }
@@ -27,9 +29,11 @@
   @return sl-to-list($list);
 }
 
-// @requires sl-shuffle
-// @alias sl-shuffle
-
+/**
+ * @requires sl-shuffle
+ * @alias sl-shuffle
+ */
+ 
 @function sl-randomize($list) {
   @return sl-shuffle($list);
 }

data/stylesheets/SassyLists/_slice.scss

@@ -1,19 +1,21 @@
-// Slices `$list` between `$start` and `$end`.
-//
-// @ignore Documentation: http://sassylists.com/documentation.html#sl-slice
-//
-// @param {List}   $list                  - list to slice
-// @param {Number} $start (1)             - start index
-// @param {Number} $end   (length($list)) - end index
-//
-// @throws List indexes $start and $end must be numbers for `sl-slice`.
-// @throws Start index has to be lesser than or equals to the end index for `sl-slice`.
-// @throws List indexes must be non-zero integers for `sl-slice`.
-// @throws Start index has to be lesser than or equal to list length for `sl-slice`.
-// @throws End index has to be lesser than or equal to list length for `sl-slice`.
-//
-// @return {List | Null}
-
+/**
+ * Slices `$list` between `$start` and `$end`.
+ *
+ * @ignore Documentation: http://sassylists.com/documentation.html#sl-slice
+ *
+ * @param {List}   $list                  - list to slice
+ * @param {Number} $start (1)             - start index
+ * @param {Number} $end   (length($list)) - end index
+ *
+ * @throws List indexes $start and $end must be numbers for `sl-slice`.
+ * @throws Start index has to be lesser than or equals to the end index for `sl-slice`.
+ * @throws List indexes must be non-zero integers for `sl-slice`.
+ * @throws Start index has to be lesser than or equal to list length for `sl-slice`.
+ * @throws End index has to be lesser than or equal to list length for `sl-slice`.
+ *
+ * @return {List | Null}
+ */
+ 
 @function sl-slice($list, $start: 1, $end: length($list)) {
   @if type-of($start) != "number" or type-of($end) != "number" {
     @warn "List indexes #{$start} and #{$end} must be numbers for `sl-slice`.";

data/stylesheets/SassyLists/_some.scss

@@ -1,10 +1,14 @@
-// Tests whether some items from `$list` pass the test implemented by `$function`.
-//
-// @param {List}    $list     - list to run test against
-// @param {String}  $function - function to run against every item from list
-// @param {ArgList} $args     - extra arguments to pass to the function
-//
-// @return {Bool}
+/**
+ * Tests whether some items from `$list` pass the test implemented by `$function`.
+ *
+ * @ignore Documentation: http://sassylists.com/documentation.html#sl-some
+ *
+ * @param {List}    $list     - list to run test against
+ * @param {String}  $function - function to run against every item from list
+ * @param {ArgList} $args     - extra arguments to pass to the function
+ *
+ * @return {Bool}
+ */
  
 @function sl-some($list, $function, $args...) {
   @each $item in $list {

data/stylesheets/SassyLists/_sort.scss

@@ -1,15 +1,17 @@
-// Sorts values of `$list` using quick-sort algorithm using `$order`.
-//
-// @ignore Documentation: http://sassylists.com/documentation.html#sl-sort
-//
-// @requires sl-str-compare
-// @requires sl-has-multiple-values
-// @requires sl-to-list
-//
-// @param {List} $list  - list to sort
-// @param {List} $order - order to respect
-//
-// @return {List}
+/**
+ * Sorts values of `$list` using quick-sort algorithm using `$order`.
+ *
+ * @ignore Documentation: http://sassylists.com/documentation.html#sl-sort
+ *
+ * @requires sl-str-compare
+ * @requires sl-has-multiple-values
+ * @requires sl-to-list
+ *
+ * @param {List} $list  - list to sort
+ * @param {List} $order - order to respect
+ *
+ * @return {List}
+ */
 
 @function sl-sort($list, $order: "!" "#" "$" "%" "&" "'" "(" ")" "*" "+" "," "-" "." "/" "[" "\\" "]" "^" "_" "{" "|" "}" "~" "0" "1" "2" "3" "4" "5" "6" "7" "8" "9" "a" "b" "c" "d" "e" "f" "g" "h" "i" "j" "k" "l" "m" "n" "o" "p" "q" "r" "s" "t" "u" "v" "w" "x" "y" "z") {
   @if sl-missing-dependencies(sl-str-compare, sl-has-multiple-values, sl-to-list) == true { @return null; }
@@ -41,9 +43,11 @@
   @return sl-to-list($list);
 }
 
-// @requires sl-sort
-// @alias sl-sort
-
+/**
+ * @requires sl-sort
+ * @alias sl-sort
+ */
+ 
 @function sl-order($list) {
   @return sl-sort($list);
 }

data/stylesheets/SassyLists/_sum.scss

@@ -1,17 +1,19 @@
-// Sums up all numeric values in `$list`, stripping unit if `$force` set to `true`.
-//
-// @ignore Documentation: http://sassylists.com/documentation.html#sl-sum
-//
-// @param {List} $list          - list
-// @param {Bool} $force (false) - enable/disable parseInt
-//
-// @requires sl-every
-// @requires sl-is-number
-//
-// @throws All items from list are not numbers for `sl-sum`.
-// 
-// @return {Number}
-
+/**
+ * Sums up all numeric values in `$list`, stripping unit if `$force` set to `true`.
+ *
+ * @ignore Documentation: http://sassylists.com/documentation.html#sl-sum
+ *
+ * @param {List} $list          - list
+ * @param {Bool} $force (false) - enable/disable parseInt
+ *
+ * @requires sl-every
+ * @requires sl-is-number
+ *
+ * @throws All items from list are not numbers for `sl-sum`.
+ * 
+ * @return {Number}
+ */
+ 
 @function sl-sum($list, $force: false) {
   $result: 0;
 

data/stylesheets/SassyLists/_tail.scss

@@ -1,21 +1,25 @@
-// Returns the tail of `$list`: all items except the first (head).
-//
-// @ignore Documentation: http://sassylists.com/documentation.html#sl-tail
-//
-// @requires sl-slice
-//
-// @param {List} $list - list to retrieve tail from
-//
-// @return {List | Null}
-
+/**
+ * Returns the tail of `$list`: all items except the first (head).
+ *
+ * @ignore Documentation: http://sassylists.com/documentation.html#sl-tail
+ *
+ * @requires sl-slice
+ *
+ * @param {List} $list - list to retrieve tail from
+ *
+ * @return {List | Null}
+ */
+ 
 @function sl-tail($list) {
   @if sl-missing-dependencies(sl-slice) == true { @return null; }
 
   @return sl-slice($list, 2);
 }
 
-// @requires sl-tail
-// @alias sl-tail
+/**
+ * @requires sl-tail
+ * @alias sl-tail
+ */
 
 @function sl-rest($list) {
   @return sl-tail($list);

data/stylesheets/SassyLists/_to-list.scss

@@ -1,22 +1,22 @@
-// Casts `$value` into a list.
-//
-// @ignore Documentation: http://sassylists.com/documentation.html#sl-to-list
-//
-// @param {*} $value - value to cast to list
-// @param {String} $separator (space) - separator to use
-//
-// @return {List}
+/**
+ * Casts `$value` into a list.
+ *
+ * @ignore Documentation: http://sassylists.com/documentation.html#sl-to-list
+ *
+ * @param {*} $value - value to cast to list
+ * @param {String} $separator (space) - separator to use
+ *
+ * @return {List}
+ */
 
 @function sl-to-list($value, $separator: list-separator($value)) {
-  @if type-of($value) != "list" or list-separator($value) != $separator {
-    @return join((), $value, $separator);
-  }
-
-  @return $value;
+  @return join((), $value, $separator);
 }
 
-// @requires sl-to-list
-// @alias sl-to-list
+/**
+ * @requires sl-to-list
+ * @alias sl-to-list
+ */
 
 @function sl-listify($value) {
   @return sl-to-list($value);

data/stylesheets/SassyLists/_to-map.scss

@@ -1,19 +1,22 @@
-// Casts `$list` into a map, using indexes as keys (starting with `$start`).
-// Useful for iterating through a list with an index variable.
-// e.g. `@each $index, $value in to-map($list)`
-//
-// @author Andrey "Lolmaus" Mikhaylov and Chris Eppstein
-// 
-// @ignore Documentation: http://sassylists.com/documentation.html#sl-to-map
-// 
-// @param {List} $list - list to turn into map
-//
-// @requires sl-range
-// @requires sl-is-empty
-// 
-// @throws List cannot be empty for `sl-to-map`.
-// 
-// @return {Map | Null}
+/**
+ * Casts `$list` into a map, using indexes as keys (starting with `$start`).
+ * Useful for iterating through a list with an index variable.
+ * e.g. `@each $index, $value in to-map($list)`
+ *
+ * @author Andrey "Lolmaus" Mikhaylov
+ * @author Chris Eppstein
+ * 
+ * @ignore Documentation: http://sassylists.com/documentation.html#sl-to-map
+ * 
+ * @param {List} $list - list to turn into map
+ *
+ * @requires sl-range
+ * @requires sl-is-empty
+ * 
+ * @throws List cannot be empty for `sl-to-map`.
+ * 
+ * @return {Map | Null}
+ */
 
 @function sl-to-map($list) {
   @if sl-missing-dependencies(sl-range, sl-is-empty) == true { @return null; }
@@ -26,16 +29,20 @@
   @return zip(sl-range(length($list)), $list);
 }
 
-// @requires sl-to-map
-// @alias sl-to-map
+/**
+ * @requires sl-to-map
+ * @alias sl-to-map
+ */
 
-@function sl-enumerate($list, $start: 1) {
-  @return sl-to-map($list, $start);
+@function sl-enumerate($list) {
+  @return sl-to-map($list);
 }
 
-// @requires sl-to-map
-// @alias sl-to-map
+/**
+ * @requires sl-to-map
+ * @alias sl-to-map
+ */
 
-@function sl-mapify($list, $start: 1) {
-  @return sl-to-map($list, $start);
+@function sl-mapify($list) {
+  @return sl-to-map($list);
 }

data/stylesheets/SassyLists/_to-string.scss

@@ -1,14 +1,16 @@
-// Joins all elements of `$list` with `$glue`.
-//
-// @ignore Documentation: http://sassylists.com/documentation.html#sl-to-string
-//
-// @param {List}   $list      - list to cast
-// @param {String} $glue ('') - value to use as a join string
-//
-// @requires sl-has-multiple-values
-// @requires sl-last
-// 
-// @return {String}
+/**
+ * Joins all elements of `$list` with `$glue`.
+ *
+ * @ignore Documentation: http://sassylists.com/documentation.html#sl-to-string
+ *
+ * @param {List}   $list      - list to cast
+ * @param {String} $glue ('') - value to use as a join string
+ *
+ * @requires sl-has-multiple-values
+ * @requires sl-last
+ * 
+ * @return {String}
+ */
 
 @function sl-to-string($list, $glue: '') {
   @if sl-missing-dependencies(sl-has-multiple-values) == true { @return null; }
@@ -26,9 +28,11 @@
   @return quote($result);
 }
 
-// @requires sl-to-string
-// @alias sl-to-string
-
+/**
+ * @requires sl-to-string
+ * @alias sl-to-string
+ */
+ 
 @function sl-stringify($list, $glue: '') {
   @return sl-to-string($list, $glue);
 }