SassyLists 1.1.1 → 2.0.0

data/stylesheets/SassyLists/_remove-duplicates.scss

@@ -1,4 +1,4 @@
-// Removes duplicate values from $list
+// Removes duplicate values from `$list`.
 //
 // @ignore Documentation: http://sassylists.com/documentation/#remove-duplicates
 //
@@ -6,7 +6,7 @@
 //
 // @return {List}
 
-@function remove-duplicates($list) {
+@function sl-remove-duplicates($list) {
   $result: ();
 
   @each $item in $list {
@@ -18,8 +18,8 @@
   @return $result;
 }
 
-// @alias remove-duplicates
+// @alias sl-remove-duplicates
 
-@function unique($list) {
-  @return remove-duplicates($list);
+@function sl-unique($list, $recursive: false) {
+  @return sl-remove-duplicates($list, $recursive);
 }

data/stylesheets/SassyLists/_remove-nth.scss

@@ -1,20 +1,22 @@
-// Removes value from $list at index $index
+// Removes value from `$list` at index `$index`.
 //
 // @ignore Documentation: http://sassylists.com/documentation/#remove-nth
 //
-// @requires replace-nth
+// @requires sl-replace-nth
 //
 // @param {List}   $list  - list to remove value from
 // @param {Number} $index - index to remove
 //
-// @return {List | Bool}
+// @return {List | Null}
 
-@function remove-nth($list, $index) {
-  @return replace-nth($list, $index, "");
+@function sl-remove-nth($list, $index) {
+  @if sl-missing-dependencies(sl-replace-nth) == true { @return null; }
+
+  @return sl-replace-nth($list, $index, "");
 }
 
-// @alias remove-nth
+// @alias sl-remove-nth
 
-@function without-nth($list, $index) {
-  @return remove-nth($list, $index);
+@function sl-without-nth($list, $index) {
+  @return sl-remove-nth($list, $index);
 }

data/stylesheets/SassyLists/_remove.scss

@@ -1,8 +1,8 @@
-// Removes value(s) $value from $list
+// Removes value(s) `$value` from `$list`.
 //
 // @ignore Documentation: http://sassylists.com/documentation/#remove
 //
-// @requires replace
+// @requires sl-replace
 //
 // @param {List}    $list      - list to update
 // @param {*}       $value     - value to remove
@@ -10,12 +10,14 @@
 //
 // @return {List}
 
-@function remove($list, $value) {
-  @return replace($list, $value, null);
+@function sl-remove($list, $value) {
+  @if sl-missing-dependencies(sl-replace) == true { @return null; }
+
+  @return sl-replace($list, $value, null);
 }
 
-// @alias remove
+// @alias sl-remove
 
-@function without($list, $value) {
-  @return remove($list, $value);
+@function sl-without($list, $value) {
+  @return sl-remove($list, $value);
 }

data/stylesheets/SassyLists/_replace-nth.scss

@@ -1,24 +1,26 @@
-// Replaces value at $index from $list by $value
+// Replaces value at `$index` from `$list` by `$value`.
 //
 // @ignore Documentation: http://sassylists.com/documentation/#replace-nth
 //
-// @requires purge
-// @requires is-true
+// @requires sl-purge
+// @requires sl-is-true
 //
 // @param {List}   $list  - list to update
 // @param {Number} $index - index to update
 // @param {*}      $value - new value for index
 //
-// @throws Invalid index $index for `replace-nth`.
+// @throws Invalid index $index for `sl-replace-nth`.
 //
-// @return {List | Bool}
+// @return {List | Null}
+
+@function sl-replace-nth($list, $index, $value) {
+  @if sl-missing-dependencies(sl-purge, sl-is-true) == true { @return null; }
 
-@function replace-nth($list, $index, $value) {
   @if type-of($index) != "number" or $index == 0 or abs($index) > length($list) {
-    @warn "Invalid index (#{$index}) for `replace-nth`.";
-    @return false;
+    @warn "Invalid index (#{$index}) for `sl-replace-nth`.";
+    @return null;
   }
 
   $list: set-nth($list, $index, $value);
-  @return if(not is-true($value), purge($list), $list);
+  @return if(not sl-is-true($value), sl-purge($list), $list);
 }

data/stylesheets/SassyLists/_replace.scss

@@ -1,8 +1,9 @@
-// Replaces $old by $new in $list
+// Replaces `$old` by `$new` in `$list`.
 //
 // @ignore Documentation: http://sassylists.com/documentation.html#replace
 //
-// @requires is-true
+// @requires sl-is-true
+// @requires sl-purge
 //
 // @param {List}    $list  - list to update
 // @param {*}       $old   - value to replace
@@ -10,7 +11,9 @@
 //
 // @return {List}
 
-@function replace($list, $old, $value) {
+@function sl-replace($list, $old, $value) {
+  @if sl-missing-dependencies(sl-is-true, sl-purge) == true { @return null; }
+
   $running: true;
 
   @while $running {
@@ -26,5 +29,5 @@
 
   }
 
-  @return if(not is-true($value), purge($list), $list);
+  @return if(not sl-is-true($value), sl-purge($list), $list);
 }

data/stylesheets/SassyLists/_reverse.scss

@@ -1,12 +1,12 @@
-// Reverses the order of $list
+// Reverses the order of `$list`.
 //
 // @ignore Documentation: http://sassylists.com/documentation/#reverse
 //
-// @param {List} $list - list to revers
+// @param {List} $list - list to reverse
 //
 // @return {List}
 
-@function reverse($list) {
+@function sl-reverse($list) {
   $length: length($list);
   $end: floor($length/2);
 
@@ -23,8 +23,8 @@
   @return $list;
 }
 
-// @alias reverse
+// @alias sl-reverse
 
-@function mirror($list) {
-  @return reverse($list);
+@function sl-mirror($list) {
+  @return sl-reverse($list);
 }

data/stylesheets/SassyLists/_shuffle.scss

@@ -1,4 +1,4 @@
-// Shuffle function using Fisher-Yates method
+// Shuffle `$list` using Fisher-Yates method.
 //
 // @ignore Documentation: http://sassylists.com/documentation/#shuffle
 //
@@ -6,7 +6,7 @@
 //
 // @return {List}
 
-@function shuffle($list) {
+@function sl-shuffle($list) {
   $length: length($list);
 
   @if $length < 2 {
@@ -19,11 +19,12 @@
     $list: set-nth($list, $i, nth($list, $j));
     $list: set-nth($list, $j, $tmp);
   }
+  
   @return $list;
 }
 
-// @alias shuffle
+// @alias sl-shuffle
 
-@function randomize($list) {
-  @return shuffle($list);
+@function sl-randomize($list) {
+  @return sl-shuffle($list);
 }

data/stylesheets/SassyLists/_slice.scss

@@ -1,4 +1,4 @@
-// Slices $list between $start and $end
+// Slices `$list` between `$start` and `$end`.
 //
 // @ignore Documentation: http://sassylists.com/documentation/#slice
 //
@@ -6,41 +6,46 @@
 // @param {Number} $start (1)             - start index
 // @param {Number} $end   (length($list)) - end index
 //
-// @throws List indexes $start and $end must be numbers for `slice`.
-// @throws Start index has to be lesser than or equals to the end index for `slice`.
-// @throws List indexes must be non-zero integers for `slice`.
-// @throws Start index has to be lesser than or equal to list length for `slice`.
-// @throws End index has to be lesser than or equal to list length for `slice`.
+// @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 | Bool}
+// @return {List | Null}
 
-@function slice($list, $start: 1, $end: length($list)) {
+@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 `slice`.";
-    @return false;
+    @warn "List indexes #{$start} and #{$end} must be numbers for `sl-slice`.";
+    @return null;
   }
 
   @if $start > $end {
-    @warn "Start index is #{$start} but has to be lesser than or equals to the end index (#{$end}) for `slice`.";
-    @return false;
+    @warn "Start index is #{$start} but has to be lesser than or equals to the end index (#{$end}) for `sl-slice`.";
+    @return null;
   }
 
   @if $start < 1 or $end < 1 {
-    @warn "List indexes must be non-zero integers for `slice`.";
-    @return false;
+    @warn "List indexes must be non-zero integers for `sl-slice`.";
+    @return null;
   }
 
   @if $start > length($list) {
-    @warn "Start index is #{$start} but list is only #{length($list)} items long for `slice`.";
-    @return false;
+    @warn "Start index is #{$start} but list is only #{length($list)} items long for `sl-slice`.";
+    @return null;
   }
 
   @if $end > length($list) {
-    @warn "End index is #{$end} but list is only #{length($list)} items long for `slice`.";
-    @return false;
+    @warn "End index is #{$end} but list is only #{length($list)} items long for `sl-slice`.";
+    @return null;
+  }
+
+  @if $start == $end {
+    @return nth($list, $start);
   }
 
   $result: ();
+  
   @for $i from $start through $end {
     $result: append($result, nth($list, $i), list-separator($list));
   }

data/stylesheets/SassyLists/_some.scss

@@ -0,0 +1,17 @@
+// 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}
+ 
+@function sl-some($list, $function, $args...) {
+  @each $item in $list {
+    @if call($function, $item, $args...) {
+      @return true;
+    } 
+  }
+  
+  @return false;
+}

data/stylesheets/SassyLists/_sort.scss

@@ -1,15 +1,17 @@
-// Sorts values of $list using quick-sort algorithm
+// Sorts values of `$list` using quick-sort algorithm using `$order`.
 //
 // @ignore Documentation: http://sassylists.com/documentation/#sort
 //
-// @requires str-compare
+// @requires sl-str-compare
 //
 // @param {List} $list  - list to sort
 // @param {List} $order - order to respect
 //
 // @return {List}
 
-@function 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") {
+@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) == true { @return null; }
+
   $less:  ();
   $equal: ();
   $large: ();
@@ -21,20 +23,20 @@
       @if $item == $seed {
         $equal: append($equal, $item, list-separator($list));
       }
-      @else if str-compare($item, $seed, $order) {
+      @else if sl-str-compare($item, $seed, $order) {
         $less: append($less, $item, list-separator($list));
       }
-      @else if not str-compare($item, $seed, $order) {
+      @else if not sl-str-compare($item, $seed, $order) {
         $large: append($large, $item, list-separator($list));
       }
     }
-    @return join(join(sort($less, $order), $equal), sort($large, $order));
+    @return join(join(sl-sort($less, $order), $equal), sl-sort($large, $order));
   }
   @return $list;
 }
 
-// @alias sort
+// @alias sl-sort
 
-@function order($list) {
-  @return sort($list);
+@function sl-order($list) {
+  @return sl-sort($list);
 }

data/stylesheets/SassyLists/_sum.scss

@@ -1,4 +1,4 @@
-// Sums up all numeric values in $list
+// Sums up all numeric values in `$list`, stripping unit if `$force` set to `true`.
 //
 // @ignore Documentation: http://sassylists.com/documentation/#sum
 //
@@ -7,7 +7,7 @@
 //
 // @return {Number}
 
-@function sum($list, $force: false) {
+@function sl-sum($list, $force: false) {
   $result: 0;
 
   @each $item in $list {

data/stylesheets/SassyLists/_tail.scss

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

data/stylesheets/SassyLists/_to-map.scss

@@ -0,0 +1,51 @@
+// Cast a `$list` into a map, using indexes as keys (starting with `$start`).
+// Useful for iterating through a list with an index variable.
+// e.g. `@each $i, $value in to-map($list)`
+//
+// @author Andrey "Lolmaus" Mikhaylov
+// 
+// @ignore Documentation: http://sassylists.com/documentation/#to-map
+// 
+// @param {List}   $list      - list to turn into map
+// @param {Number} $start (1) - index to start with
+// 
+// @throws List cannot be empty for `sl-to-map`.
+// @throws $start is not a number for `sl-to-map`.
+// 
+// @return {Map | Null}
+
+@function sl-to-map($list, $start: 1) {
+  @if length($list) == 0 {
+    @warn "List cannot be empty for `sl-to-map`.";
+    @return null;
+  }
+
+  @if type-of($start) != "number" {
+    @warn "$start provided to `sl-to-map` was #{type-of($start)}, but it should be a number.";
+    @return null;
+  }
+
+  $map: ();
+
+  @for $index from 1 through length($list) {
+    $key: $index + $start - 1;
+    $value: nth($list, $index);
+    $map: map-merge($map, ($key: $value));
+  }
+
+  @return $map;
+}
+
+// @requires sl-to-map
+// @alias sl-to-map
+
+@function sl-enumerate($list, $start: 1) {
+  @return sl-to-map($list, $start);
+}
+
+// @requires sl-to-map
+// @alias sl-to-map
+
+@function sl-mapify($list, $start: 1) {
+  @return sl-to-map($list, $start);
+}

data/stylesheets/SassyLists/_to-string.scss

@@ -1,4 +1,4 @@
-// Joins all elements of $list with $glue
+// Joins all elements of `$list` with `$glue`.
 //
 // @ignore Documentation: http://sassylists.com/documentation/#to-string
 //
@@ -7,20 +7,20 @@
 //
 // @return {String}
 
-@function to-string($list, $glue: '') {
+@function sl-to-string($list, $glue: '') {
   $result: '';
   $length: length($list);
 
   @for $i from 1 through $length {
     $item: nth($list, $i);
-    $result: $result + if(length($item) > 1, to-string($item, $glue), $item + $glue);
+    $result: $result + if(length($item) > 1, sl-to-string($item, $glue), $item + $glue);
   }
 
   @return quote(str-slice($result, 1, str-length($glue) * -1 - 1));
 }
 
-// @alias to-string
+// @alias sl-to-string
 
-@function stringify($list, $glue: '') {
-  @return to-string($list, $glue);
+@function sl-stringify($list, $glue: '') {
+  @return sl-to-string($list, $glue);
 }

data/stylesheets/SassyLists/_union.scss

@@ -1,21 +1,24 @@
-// Returns a list of values from $lists minus duplicates
+// Returns a list of values from `$lists` minus duplicates.
 //
 // @ignore Documentation: http://sassylists.com/documentation/#union
 //
-// @requires flatten
-// @requires remove-duplicates
+// @requires sl-flatten
+// @requires sl-remove-duplicates
 //
 // @param {ArgList} $lists - lists to unify
 //
 // @return {List}
 
-@function union($lists...) {
-  $result: remove-duplicates(flatten($lists));
+@function sl-union($lists...) {
+  @if sl-missing-dependencies(sl-flatten, sl-remove-duplicates) == true { @return null; }
+
+  $result: sl-remove-duplicates(sl-flatten($lists));
+  
   @return if(length($result) == 1, nth($result, 1), $result);
 }
 
-// @alias union
+// @alias sl-union
 
-@function merge($lists...) {
-  @return union($lists...);
+@function sl-merge($lists...) {
+  @return sl-union($lists...);
 }

data/stylesheets/SassyLists/_walk.scss

@@ -1,4 +1,4 @@
-// Apply $function to every item from $list passing $args as parameters
+// Apply `$function` to every item from `$list` passing $args as parameters.
 //
 // @ignore Documentation: http://sassylists.com/documentation/#walk
 //
@@ -8,12 +8,12 @@
 //
 // @throws There is no $function function.
 //
-// @return {List | Bool}
+// @return {List | Null}
 
-@function walk($list, $function, $args...) {
+@function sl-walk($list, $function, $args...) {
   @if not function-exists($function) {
     @warn "There is no `#{$function}` function.";
-    @return false;
+    @return null;
   }
 
   @for $i from 1 through length($list) {

data/stylesheets/SassyLists/helpers/_missing-dependencies.scss

@@ -0,0 +1,23 @@
+// Checks whether `$functions` exist in global scope.
+//
+// @access private
+//
+// @param {ArgList} $functions - list of functions to check for
+//
+// @return {Bool} Whether or not there are missing dependencies
+
+@function sl-missing-dependencies($functions...) {
+  $missing-dependencies: ();
+  
+  @each $function in $functions {
+    @if not function-exists($function) {
+      $missing-dependencies: append($missing-dependencies, $function, comma);
+    }
+  }
+  
+  @if length($missing-dependencies) > 0 {
+    @warn "Unmet dependencies! The following functions are required: #{$missing-dependencies}.";
+  }
+  
+  @return length($missing-dependencies) != 0;
+}

data/stylesheets/SassyLists/helpers/_str-compare.scss

@@ -1,4 +1,4 @@
-// Compares two values based on alphabetical order
+// Compares `$a` and `$b` based on `$order`.
 //
 // @access private
 //
@@ -8,12 +8,14 @@
 //
 // @return {Bool}
 
-@function str-compare($a, $b, $order) {
+@function sl-str-compare($a, $b, $order) {
   @if type-of($a) == "number" and type-of($b) == "number" {
     @return $a < $b;
   }
+
   $a: to-lower-case($a + unquote(""));
   $b: to-lower-case($b + unquote(""));
+  
   @for $i from 1 through min(str-length($a), str-length($b)) {
     $char-a: str-slice($a, $i, $i);
     $char-b: str-slice($b, $i, $i);
@@ -21,5 +23,6 @@
       @return index($order, $char-a) < index($order, $char-b);
     }
   }
+  
   @return str-length($a) < str-length($b);
 }

data/stylesheets/SassyLists/helpers/_true.scss

@@ -1,4 +1,4 @@
-// Returns truthiness of a value
+// Returns truthiness of `$value`.
 //
 // @access private
 //
@@ -6,6 +6,6 @@
 //
 // @return {Bool}
 
-@function is-true($value) {
+@function sl-is-true($value) {
   @return if($value == null, false, $value and $value != null and $value != "" and $value != ());
 }

data/stylesheets/_SassyLists.scss

@@ -4,12 +4,14 @@
 // CodePen: http://codepen.io/HugoGiraudel/pen/loAgq
 // Repository: https://github.com/Team-Sass/SassyLists/
 
-@import "SassyLists/helpers/true";
+@import "SassyLists/helpers/missing-dependencies";
 @import "SassyLists/helpers/str-compare";
+@import "SassyLists/helpers/true";
 @import "SassyLists/chunk";
 @import "SassyLists/contain";
 @import "SassyLists/count-values";
 @import "SassyLists/debug";
+@import "SassyLists/every";
 @import "SassyLists/explode";
 @import "SassyLists/first";
 @import "SassyLists/flatten";
@@ -31,8 +33,10 @@
 @import "SassyLists/shuffle";
 @import "SassyLists/slice";
 @import "SassyLists/sort";
+@import "SassyLists/some";
 @import "SassyLists/sum";
 @import "SassyLists/tail";
+@import "SassyLists/to-map";
 @import "SassyLists/to-string";
 @import "SassyLists/union";
 @import "SassyLists/walk";