SassyLists 2.1.1 → 2.2.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA1:
-  metadata.gz: 5eaa4083a1a28198d2f0c464963ee950330bcf2a
-  data.tar.gz: 49dabd33892af67244430c144a7b025313f61381
+  metadata.gz: 3bc911e8854740e20b09b1b091700972ff4f048d
+  data.tar.gz: 051110d6e5cce8ce43953e29f12e1c5922e3a949
 SHA512:
-  metadata.gz: 92100eddaf4fbabfc5688ddff79c89100d9cfdf799bbd2bc1a24114729abacbddd1b6778588f28e08e9ca0d4b23d1a2adf8d3ec4860f4e1b335d86c7825c5d57
-  data.tar.gz: 4b218a6e01215c618f35fa460e9a1cb07659364cb552b7c176c3c9e801b42817ac906bd3df06fdeed231367444aabf889e8e180110af6f328c1fac9b7bd316f3
+  metadata.gz: b2baf6768c31fa2a54b5d339ccd43e9a1d0907277dc03a4a1ba265abf8d6623298699b7ab964ef1236f76a59085807613fa34871ab802202e505fef782b387cb
+  data.tar.gz: e3ad19705d8548916c12456c1312e93496d7a1963d265fa1cf54efb7b41799aa0abc016ea9d3c5d6494d4a7d2ef561822162acc29a8f07650e03d2e391b382d1

data/CHANGELOG.md

@@ -1,5 +1,10 @@
 # Changelog
 
+* `2.2.0`: 
+    * adding `sl-range()`, `sl-is-single()`, `sl-has-values()`, `sl-has-multiple-values()`
+    * updating `sl-sum()` and `sl-to-map()`
+    * making the whole library depending on most of the previously created helpers
+    * making most functions returning `list` type, even when returning a single value
 * `2.1.1`: fixing a tiny issue with dependency checker in `preprend()`
 * `2.1.0`: adding `sl-is-empty()`, `sl-to-list()` and `sl-comma-list()`
 * `2.0.0`: 

data/README.md

@@ -21,18 +21,22 @@ Here is a powerful toolbox providing you all the functions you need to manipulat
 * `sl-debug()`: returns list as a string
 * `sl-every()`: returns whether all items from list pass test from given function
 * `sl-explode()`: explodes a string into a list using a string as a delimiter
-* `sl-first()`: returns first item in list
+* `sl-first()`: returns first value in list
 * `sl-flatten()`: turns multidimensional list into a one-level list
+* `sl-has-values()`: checks if list is not empty
+* `sl-has-multiple-values()`: checks if list has more than one value
 * `sl-insert-nth()`: inserts value at index
 * `sl-intersection()`: returns a list of shared values across all given lists
 * `sl-is-empty()`: checks if list is empty
+* `sl-is-single()`: checks if list has a single value
 * `sl-is-symmetrical()`: checks if list is symmetrical
-* `sl-last()`: returns last item in list
+* `sl-last()`: returns last value in list
 * `sl-last-index()`: returns last index of value in list
 * `sl-loop()`: shifts indexes in list
 * `sl-prepend()`: prepends value to list
 * `sl-purge()`: removes all `false` and `null` values from list
 * `sl-random-value()`: returns random value from list
+* `sl-range()`: returns a list of values between 1 and given value
 * `sl-remove()`: removes value in list
 * `sl-remove-duplicates()`: removes duplicate values from list
 * `sl-remove-nth()`: removes value at index
@@ -42,14 +46,14 @@ Here is a powerful toolbox providing you all the functions you need to manipulat
 * `sl-shuffle()`: shuffles list
 * `sl-slice()`: slices list
 * `sl-sort()`: sorts list
-* `sl-some()`: returns whether some items from list pass test from given function
+* `sl-some()`: returns whether some values from list pass test from given function
 * `sl-sum()`: sums all unitless values in list
 * `sl-tail()`: returns anything but the first element in list
 * `sl-to-list()`: casts value as list
 * `sl-to-map()`: casts list as map using indexes as keys
 * `sl-to-string()`: casts list as string (JS `.join()`)
 * `sl-union()`: returns a list of values from given lists minus duplicates
-* `sl-walk()`: applies a function to every item of list
+* `sl-walk()`: applies a function to every value of list
 
 If you feel like an explorer, you can have a look at the code [here](https://github.com/Team-Sass/SassyLists/tree/master/stylesheets).
 

data/lib/SassyLists.rb

@@ -15,7 +15,7 @@ end
 #  Version is a number. If a version contains alphas, it will be created as a prerelease version
 #  Date is in the form of YYYY-MM-DD
 module SassyLists
-  VERSION = "2.1.1"
-  DATE = "2014-07-02"
+  VERSION = "2.2.0"
+  DATE = "2014-07-03"
 end
 

data/stylesheets/SassyLists/_chunk.scss

@@ -7,16 +7,20 @@
 //
 // @throws $size is not a number for `sl-chunk`.
 //
+// @requires sl-to-list
+//
 // @return {List | Null}
 
 @function sl-chunk($list, $size) {
+  @if sl-missing-dependencies(sl-to-list) == true { @return null; }
+
   @if type-of($size) != "number" {
-    @warn "#{$size} is not a number for `sl-chunk`.";
+    @warn "#{inspect($size)} is not a number for `sl-chunk`.";
     @return null;
   }
 
   @if $size >= length($list) {
-    @return $list;
+    @return sl-to-list($list);
   }
 
   $index: 1;
@@ -30,8 +34,16 @@
     @for $j from 1 through $size {
       @if $index <= $length {
         $is-orphan: $length % $size == 1 and $j == 1;
-        $tmp: if($is-orphan, nth($list, $index), append($tmp, nth($list, $index)));
+        
+        @if $is-orphan {
+          $tmp: nth($list, $index);
+        }
+
+        @else {
+          $tmp: append($tmp, nth($list, $index), list-separator($list));
+        }
       }
+
       $index: $index + 1;
     }
 

data/stylesheets/SassyLists/_contain.scss

@@ -11,6 +11,7 @@
   @return not not index($list, $value);
 }
 
+// @requires sl-contain
 // @alias sl-contain
 
 @function sl-include($list, $value) {

data/stylesheets/SassyLists/_debug.scss

@@ -6,14 +6,20 @@
 // @param {Bool}   $pre   (false) - enable/disable variables type and proper indentation
 // @param {Number} $level (1)     - internal variable for recursion
 //
+// @requires sl-is-empty
+// @requires sl-is-single
+// @requires sl-has-multiple-values
+// 
 // @return {String}
 
 @function sl-debug($list, $pre: false, $level: 1) {
-  @if length($list) == 0 {
+  @if sl-missing-dependencies(sl-is-empty, sl-is-single, sl-has-multiple-values) == true { @return null; }
+
+  @if sl-is-empty($list) {
     @return "( )";
   }
 
-  @if length($list) == 1 {
+  @if sl-is-single($list) {
     @return if($pre,  "(" + type-of($list) + ") ", "") + $list;
   }
 
@@ -32,7 +38,7 @@
     $item: nth($list, $i);
     $result: $result + if($pre, $indent + $tab, " ");
 
-    @if length($item) > 1 {
+    @if sl-has-multiple-values($item) {
       $result: $result
         + if($pre, "(list: " + length($item) + ") ", "")
         + sl-debug($item, $pre, $level + 1);
@@ -43,7 +49,7 @@
         $result: $result + "(" + type-of($item) + ") ";
       }
 
-      @if length($item) == 0 {
+      @if sl-is-empty($item) {
         $result: $result + "( )";
       }
 

data/stylesheets/SassyLists/_explode.scss

@@ -2,15 +2,16 @@
 //
 // @ignore Documentation: http://sassylists.com/documentation.html#sl-explode
 //
-// @param {String} $string         - string to explode
-// @param {String} $separator ('') - string to use as a delimiter
+// @param {String} $string              - string to explode
+// @param {String} $delimiter ('')      - string to use as a delimiter
+// @param {String} $separator ('space') - list separator
 //
 // @throws $string is not a string for `sl-explode`.
 // @throws $delimiter is not a string for `sl-explode`.
 //
 // @return {List | Null}
 
-@function sl-explode($string, $delimiter: '') {
+@function sl-explode($string, $delimiter: '', $separator: "space") {
   @if type-of($string) != "string" {
     @warn "`sl-explode` function expecting a string; #{type-of($string)} given.";
     @return null;
@@ -23,6 +24,10 @@
 
   $result: ();
   $length: str-length($string);
+  
+  @if not index("space" "comma", $separator) {
+    $separator: "space";
+  }
 
   @if str-length($delimiter) == 0 {
     @for $i from 1 through $length {
@@ -38,16 +43,16 @@
   @while $running {
     $index: str-index($remaining, $delimiter);
     
-    @if not $index or $index == 0 {
+    @if not $index {
       $running: false;
     }
 
     @else {
       $slice: str-slice($remaining, 1, $index - 1);
-      $result: append($result, $slice);
+      $result: append($result, $slice, $separator);
       $remaining: str-slice($remaining, $index + str-length($delimiter));
     }
   }
 
-  @return append($result, $remaining);
+  @return append($result, $remaining, $separator);
 }

data/stylesheets/SassyLists/_first.scss

@@ -6,10 +6,14 @@
 //
 // @throws Cannot find first item of empty list.
 //
+// @requires sl-is-empty
+// 
 // @return {*}
 
 @function sl-first($list) {
-  @if length($list) == 0 {
+  @if sl-missing-dependencies(sl-is-empty) == true { @return null; }
+
+  @if sl-is-empty($list) {
     @warn "Cannot find first item of empty list.";
     @return null;
   }
@@ -17,6 +21,7 @@
   @return nth($list, 1);
 }
 
+// @requires sl-first
 // @alias sl-first
 
 @function sl-head($list) {

data/stylesheets/SassyLists/_flatten.scss

@@ -3,19 +3,20 @@
 // @ignore Documentation: http://sassylists.com/documentation.html#flatten
 //
 // @param {List} $list - list to flatten
-//
+// 
+// @requires sl-has-multiple-values
+// 
 // @return {List}
 
 @function sl-flatten($list) {
-  $result: ();
+  @if sl-missing-dependencies(sl-has-multiple-values) == true { @return null; }
 
-  @if length($list) == 1 {
-    @return $list;
-  }
+  $result: ();
 
   @each $item in $list {
-    @if length($item) > 1 {
+    @if sl-has-multiple-values($item) {
       $flatten: sl-flatten($item);
+      
       @each $i in $flatten {
         $result: append($result, $i, list-separator($list));
       }
@@ -29,6 +30,7 @@
   @return $result;
 }
 
+// @requires sl-flatten
 // @alias sl-flatten
 
 @function sl-unfold($list) {

data/stylesheets/SassyLists/_has-multiple-values.scss

@@ -0,0 +1,11 @@
+// Tests whether `$list` has at least 2 values.
+//
+// @ignore Documentation: http://sassylists.com/documentation.html#sl-has-multiple-values
+//
+// @param {List} $list - list to run test against
+//
+// @return {Bool}
+
+@function sl-has-multiple-values($list) {
+  @return length($list) > 1;
+}

data/stylesheets/SassyLists/_has-values.scss

@@ -0,0 +1,11 @@
+// Tests whether `$list` is not empty.
+//
+// @ignore Documentation: http://sassylists.com/documentation.html#sl-has-values
+//
+// @param {List} $list - list to run test against
+//
+// @return {Bool}
+
+@function sl-has-values($list) {
+  @return length($list) > 0;
+}

data/stylesheets/SassyLists/_insert-nth.scss

@@ -18,8 +18,8 @@
 
   $length: length($list);
 
-  @if type-of($index) != number {
-    @warn "List index #{$index} is not a number for `sl-insert-nth`.";
+  @if type-of($index) != "number" {
+    @warn "List index #{inspect($index)} is not a number for `sl-insert-nth`.";
     @return null;
   }
 

data/stylesheets/SassyLists/_intersection.scss

@@ -3,6 +3,7 @@
 // @ignore Documentation: http://sassylists.com/documentation.html#sl-intersection
 //
 // @requires sl-remove-duplicates
+// @requires sl-to-list
 //
 // @param {List}    $list  - first list
 // @param {ArgList} $lists - other lists
@@ -26,6 +27,5 @@
     $result: $temp;
   }
 
-  $result: sl-remove-duplicates($result);
-  @return if(length($result) == 1, nth($result, 1), $result);
-}
+  @return sl-remove-duplicates($result);
+}

data/stylesheets/SassyLists/_is-empty.scss

@@ -15,4 +15,4 @@
 
 @function sl-empty($list) {
   @return sl-is-empty($list);
-}
+}

data/stylesheets/SassyLists/_is-single.scss

@@ -0,0 +1,11 @@
+// Tests whether `$list` has a single item.
+//
+// @ignore Documentation: http://sassylists.com/documentation.html#sl-is-single
+//
+// @param {List} $list - list to run test against
+//
+// @return {Bool}
+
+@function sl-is-single($list) {
+  @return length($list) == 1;
+}

data/stylesheets/SassyLists/_is-symmetrical.scss

@@ -14,6 +14,7 @@
   @return $list == sl-reverse($list);
 }
 
+// @requires sl-is-symmetrical
 // @alias sl-is-symmetrical
 
 @function sl-is-mirror($list) {

data/stylesheets/SassyLists/_last-index.scss

@@ -8,9 +8,7 @@
 // @return {Number | Null}
 
 @function sl-last-index($list, $value) {
-  $length: length($list);
-
-  @for $i from $length through 1 {
+  @for $i from length($list) through 1 {
     @if nth($list, $i) == $value {
       @return $i;
     }

data/stylesheets/SassyLists/_last.scss

@@ -6,10 +6,14 @@
 //
 // @throws Cannot find last item of empty list.
 //
+// @requires sl-is-empty
+// 
 // @return {*}
 
 @function sl-last($list) {
-  @if length($list) == 0 {
+  @if sl-missing-dependencies(sl-is-empty) == true { @return null; }
+
+  @if sl-is-empty($list) {
     @warn "Cannot find last item of empty list.";
     @return null;
   }

data/stylesheets/SassyLists/_loop.scss

@@ -9,15 +9,19 @@
 //
 // @throws $value is not a number for `loop`.
 //
+// @requires sl-has-multiple-values
+// 
 // @return {List | Null}
 
 @function sl-loop($list, $value: 1) {
+  @if sl-missing-dependencies(sl-has-multiple-values) == true { @return null; }
+
   @if type-of($value) != "number" {
-    @warn "#{$value} is not a number for `sl-loop`.";
+    @warn "#{inspect($value)} is not a number for `sl-loop`.";
     @return null;
   }
 
-  @if length($list) < 2 {
+  @if not sl-has-multiple-values($list) {
     @return $list;
   }
 
@@ -31,6 +35,7 @@
   @return $result;
 }
 
+// @requires sl-loop
 // @alias sl-loop
 
 @function sl-shift-indexes($list, $value: 1) {

data/stylesheets/SassyLists/_prepend.scss

@@ -3,6 +3,7 @@
 // @ignore Documentation: http://sassylists.com/documentation.html#sl-prepend
 //
 // @requires sl-is-true
+// @requires sl-to-list
 //
 // @param {List} $list  - list to preprend value to
 // @param {*}    $value - value to prepend to the list
@@ -10,13 +11,11 @@
 // @return {List}
 
 @function sl-prepend($list, $value) {
-  @if sl-missing-dependencies(sl-is-true) == true { @return null; }
+  @if sl-missing-dependencies(sl-is-true, sl-to-list) == true { @return null; }
   
   @if sl-is-true($value) {
-    @return join($value, $list, list-separator($list));
+  	$list: join($value, $list, list-separator($list));
   }
 
-  @else {
-    @return $list;
-  }
+  @return sl-to-list($list);
 }

data/stylesheets/SassyLists/_purge.scss

@@ -3,13 +3,14 @@
 // @ignore Documentation: http://sassylists.com/documentation.html#purge
 //
 // @requires sl-is-true
+// @requires sl-to-list
 //
 // @param {List} $list - list to purge
 //
 // @return {List}
 
 @function sl-purge($list) {
-  @if sl-missing-dependencies(sl-is-true) == true { @return null; }
+  @if sl-missing-dependencies(sl-is-true, sl-to-list) == true { @return null; }
   
   $result: ();
 
@@ -19,9 +20,10 @@
     }
   }
 
-  @return $result;
+  @return sl-to-list($result);
 }
 
+// @requires sl-purge
 // @alias sl-purge
 
 @function sl-clean($list) {

data/stylesheets/SassyLists/_random-value.scss

@@ -6,23 +6,29 @@
 //
 // @throws Cannot find a random value in an empty list.
 //
+// @requires sl-is-empty
+// 
 // @return {*}
 
 @function sl-random-value($list) {
-  @if length($list) == 0 {
+  @if sl-missing-dependencies(sl-is-empty) == true { @return null; }
+
+  @if sl-is-empty($list) {
     @warn "Cannot find a random value in an empty list.";
     @return null;
   }
 
-  @return nth($list, random(length($list)));
+  @return nth($list, random(length($list) - 1) + 1);
 }
 
+// @requires sl-random-value
 // @alias sl-random-value
 
 @function sl-roll($list) {
   @return sl-random-value($list);
 }
 
+// @requires sl-random-value
 // @alias sl-random-value
 
 @function sl-luck($list) {

data/stylesheets/SassyLists/_range.scss

@@ -0,0 +1,40 @@
+// Build a list of values from 1 through `$n`.
+//
+// @ignore Documentation: http://sassylists.com/documentation.html#sl-range
+//
+// @param {Number} $n - maximum value
+//
+// @throws `$n` is not a number for `sl-range`.
+// @throws `$n` is not unitless for `sl-range`.
+// @throws `$n` is not greater than 0 for `sl-range`.
+//
+// @return {List | Number | Null}
+
+@function sl-range($n) {
+  @if type-of($n) != "number" {
+    @warn "`#{inspect($n)}` is not a number for `sl-range`.";
+    @return null;
+  }
+
+  @if not unitless($n) {
+    @warn "`#{$n}` is not unitless for `sl-range`.";
+    @return null;
+  }
+
+  @if $n < 1 {
+    @warn "`#{$n}` is not greater than 0 for `sl-range`.";
+    @return null;
+  }
+
+  @if $n == 1 { 
+    @return $n;
+  }
+
+  $range: ();
+
+  @for $i from 1 through $n {
+    $range: append($range, $i);
+  }
+
+  @return $range;
+}

data/stylesheets/SassyLists/_remove-duplicates.scss

@@ -4,9 +4,13 @@
 //
 // @param {List} $list - list to remove duplicates from
 //
+// @requires sl-to-list
+//
 // @return {List}
 
 @function sl-remove-duplicates($list) {
+  @if sl-missing-dependencies(sl-to-list) == true { @return null; }
+
   $result: ();
 
   @each $item in $list {
@@ -15,11 +19,12 @@
     }
   }
 
-  @return $result;
+  @return sl-to-list($result);
 }
 
+// @requires sl-remove-duplicates
 // @alias sl-remove-duplicates
 
-@function sl-unique($list, $recursive: false) {
-  @return sl-remove-duplicates($list, $recursive);
+@function sl-unique($list) {
+  @return sl-remove-duplicates($list);
 }

data/stylesheets/SassyLists/_remove-nth.scss

@@ -15,6 +15,7 @@
   @return sl-replace-nth($list, $index, "");
 }
 
+// @requires sl-remove-nth
 // @alias sl-remove-nth
 
 @function sl-without-nth($list, $index) {

data/stylesheets/SassyLists/_remove.scss

@@ -16,6 +16,7 @@
   @return sl-replace($list, $value, null);
 }
 
+// @requires sl-remove
 // @alias sl-remove
 
 @function sl-without($list, $value) {

data/stylesheets/SassyLists/_replace-nth.scss

@@ -4,6 +4,7 @@
 //
 // @requires sl-purge
 // @requires sl-is-true
+// @requires sl-to-list
 //
 // @param {List}   $list  - list to update
 // @param {Number} $index - index to update
@@ -14,13 +15,15 @@
 // @return {List | Null}
 
 @function sl-replace-nth($list, $index, $value) {
-  @if sl-missing-dependencies(sl-purge, sl-is-true) == true { @return null; }
+  @if sl-missing-dependencies(sl-purge, sl-is-true, sl-to-list) == true { @return null; }
 
   @if type-of($index) != "number" or $index == 0 or abs($index) > length($list) {
-    @warn "Invalid index (#{$index}) for `sl-replace-nth`.";
+    @warn "Invalid index (#{inspect($index)}) for `sl-replace-nth`.";
     @return null;
   }
 
   $list: set-nth($list, $index, $value);
-  @return if(not sl-is-true($value), sl-purge($list), $list);
+  $list: if(sl-is-true($value), $list, sl-purge($list));
+  
+  @return sl-to-list($list);
 }

data/stylesheets/SassyLists/_replace.scss

@@ -4,6 +4,7 @@
 //
 // @requires sl-is-true
 // @requires sl-purge
+// @requires sl-to-list
 //
 // @param {List}    $list  - list to update
 // @param {*}       $old   - value to replace
@@ -12,7 +13,7 @@
 // @return {List}
 
 @function sl-replace($list, $old, $value) {
-  @if sl-missing-dependencies(sl-is-true, sl-purge) == true { @return null; }
+  @if sl-missing-dependencies(sl-is-true, sl-purge, sl-to-list) == true { @return null; }
 
   $running: true;
 
@@ -29,5 +30,7 @@
 
   }
 
-  @return if(not sl-is-true($value), sl-purge($list), $list);
+  $list: if(sl-is-true($value), $list, sl-purge($list));
+  
+  @return sl-to-list($list);
 }

data/stylesheets/SassyLists/_reverse.scss

@@ -4,11 +4,15 @@
 //
 // @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; }
+
   $length: length($list);
-  $end: floor($length/2);
+  $end: floor($length / 2);
 
   @if $length < 2 {
     @return $list;
@@ -20,9 +24,10 @@
     $list: set-nth($list, -$i, $tmp);
   }
 
-  @return $list;
+  @return sl-to-list($list);
 }
 
+// @requires sl-reverse
 // @alias sl-reverse
 
 @function sl-mirror($list) {

data/stylesheets/SassyLists/_shuffle.scss

@@ -4,9 +4,13 @@
 //
 // @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; }
+
   $length: length($list);
 
   @if $length < 2 {
@@ -20,9 +24,10 @@
     $list: set-nth($list, $j, $tmp);
   }
   
-  @return $list;
+  @return sl-to-list($list);
 }
 
+// @requires sl-shuffle
 // @alias sl-shuffle
 
 @function sl-randomize($list) {

data/stylesheets/SassyLists/_slice.scss

@@ -40,10 +40,6 @@
     @return null;
   }
 
-  @if $start == $end {
-    @return nth($list, $start);
-  }
-
   $result: ();
   
   @for $i from $start through $end {

data/stylesheets/SassyLists/_sort.scss

@@ -3,6 +3,8 @@
 // @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
@@ -10,31 +12,36 @@
 // @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) == true { @return null; }
+  @if sl-missing-dependencies(sl-str-compare, sl-has-multiple-values, sl-to-list) == true { @return null; }
 
   $less:  ();
   $equal: ();
   $large: ();
-  $length: length($list);
 
-  @if $length > 1 {
-    $seed: nth($list, ceil($length / 2));
+  @if sl-has-multiple-values($list) {
+    $seed: nth($list, ceil(length($list) / 2));
+    
     @each $item in $list {
       @if $item == $seed {
         $equal: append($equal, $item, list-separator($list));
       }
+
       @else if sl-str-compare($item, $seed, $order) {
         $less: append($less, $item, list-separator($list));
       }
+      
       @else if not sl-str-compare($item, $seed, $order) {
         $large: append($large, $item, list-separator($list));
       }
     }
+
     @return join(join(sl-sort($less, $order), $equal), sl-sort($large, $order));
   }
-  @return $list;
+
+  @return sl-to-list($list);
 }
 
+// @requires sl-sort
 // @alias sl-sort
 
 @function sl-order($list) {

data/stylesheets/SassyLists/_sum.scss

@@ -2,27 +2,33 @@
 //
 // @ignore Documentation: http://sassylists.com/documentation.html#sl-sum
 //
-// @param {List}    $list          - list
+// @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;
 
-  @each $item in $list {
-    @if type-of($item) == number {
-
-      @if $force and not unitless($item) {
-        $item: $item / ($item * 0 + 1);
-      }
+  @if not sl-every($list, sl-is-number) {
+    @warn "All items from list are not numbers for `sl-sum`.";
+    @return null;
+  }
 
-      @if unitless($item) {
-        $result: $result + $item;
-      }
+  @each $item in $list {
+    @if not unitless($item) and $force {
+      $item: $item / ($item * 0 + 1);
+    }
 
+    @if unitless($item) {
+      $result: $result + $item;
     }
   }
 
   @return $result;
-}
+}

data/stylesheets/SassyLists/_tail.scss

@@ -14,6 +14,7 @@
   @return sl-slice($list, 2);
 }
 
+// @requires sl-tail
 // @alias sl-tail
 
 @function sl-rest($list) {

data/stylesheets/SassyLists/_to-list.scss

@@ -3,11 +3,22 @@
 // @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) {
-  @return if(type-of($value) == "list", $value, ($value,));
+@function sl-to-list($value, $separator: list-separator($value)) {
+  @if type-of($value) != "list" or list-separator($value) != $separator {
+    $new-list: if($separator == "comma", sl-comma-list(), ());
+
+    @each $item in $value {
+      $new-list: append($new-list, $item, $separator);
+    }
+
+    @return $new-list;
+  }
+
+  @return $value;
 }
 
 // @requires sl-to-list

data/stylesheets/SassyLists/_to-map.scss

@@ -1,39 +1,29 @@
 // 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 $i, $value in to-map($list)`
+// e.g. `@each $index, $value in to-map($list)`
 //
-// @author Andrey "Lolmaus" Mikhaylov
+// @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
-// @param {Number} $start (1) - index to start with
+// @param {List} $list - list to turn into map
+//
+// @requires sl-range
+// @requires sl-is-empty
 // 
 // @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;
-  }
+@function sl-to-map($list) {
+  @if sl-missing-dependencies(sl-range, sl-is-empty) == true { @return null; }
 
-  @if type-of($start) != "number" {
-    @warn "$start provided to `sl-to-map` was #{type-of($start)}, but it should be a number.";
+  @if sl-is-empty($list) {
+    @warn "List cannot be empty for `sl-to-map`.";
     @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;
+  @return zip(sl-range(length($list)), $list);
 }
 
 // @requires sl-to-map

data/stylesheets/SassyLists/_to-string.scss

@@ -5,20 +5,28 @@
 // @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; }
+
   $result: '';
-  $length: length($list);
 
-  @for $i from 1 through $length {
-    $item: nth($list, $i);
-    $result: $result + if(length($item) > 1, sl-to-string($item, $glue), $item + $glue);
+  @each $item in $list {
+    $result: $result + if(sl-has-multiple-values($item), sl-to-string($item, $glue), $item);
+
+    @if $item != sl-last($list) {
+      $result: $result + $glue;
+    }
   }
 
-  @return quote(str-slice($result, 1, str-length($glue) * -1 - 1));
+  @return quote($result);
 }
 
+// @requires sl-to-string
 // @alias sl-to-string
 
 @function sl-stringify($list, $glue: '') {

data/stylesheets/SassyLists/_union.scss

@@ -14,7 +14,7 @@
 
   $result: sl-remove-duplicates(sl-flatten($lists));
   
-  @return if(length($result) == 1, nth($result, 1), $result);
+  @return $result;
 }
 
 // @alias sl-union

data/stylesheets/SassyLists/_walk.scss

@@ -6,19 +6,24 @@
 // @param {String}  $function - function to call on each value
 // @param {ArgList} $args     - optional function arguments
 //
-// @throws There is no $function function.
+// @throws There is no `$function` function for `sl-walk`.
+//
+// @requires sl-to-map
+// @requires sl-to-list
 //
 // @return {List | Null}
 
 @function sl-walk($list, $function, $args...) {
+  @if sl-missing-dependencies(sl-to-map, sl-to-list) == true { @return null; }
+  
   @if not function-exists($function) {
-    @warn "There is no `#{$function}` function.";
+    @warn "There is no `#{$function}` function for `sl-walk`.";
     @return null;
   }
 
-  @for $i from 1 through length($list) {
-    $list: set-nth($list, $i, call($function, nth($list, $i), $args...));
+  @each $index, $value in sl-to-map($list) {
+  	$list: set-nth($list, $index, call($function, $value, $args...));
   }
   
-  @return $list;
+  @return sl-to-list($list);
 }

data/stylesheets/SassyLists/helpers/_is-number.scss

@@ -0,0 +1,11 @@
+// Check whether value is a number
+//
+// @access private
+//
+// @param {*} $value - value to run test against
+//
+// @return {Bool}
+
+@function sl-is-number($value) {
+  @return type-of($value) == "number";
+}

data/stylesheets/_SassyLists.scss

@@ -7,6 +7,7 @@
 @import "SassyLists/helpers/missing-dependencies";
 @import "SassyLists/helpers/str-compare";
 @import "SassyLists/helpers/true";
+@import "SassyLists/helpers/is-number";
 @import "SassyLists/chunk";
 @import "SassyLists/comma-list";
 @import "SassyLists/contain";
@@ -16,9 +17,12 @@
 @import "SassyLists/explode";
 @import "SassyLists/first";
 @import "SassyLists/flatten";
+@import "SassyLists/has-values";
+@import "SassyLists/has-multiple-values";
 @import "SassyLists/insert-nth";
 @import "SassyLists/intersection";
 @import "SassyLists/is-empty";
+@import "SassyLists/is-single";
 @import "SassyLists/is-symmetrical";
 @import "SassyLists/last";
 @import "SassyLists/last-index";
@@ -26,6 +30,7 @@
 @import "SassyLists/prepend";
 @import "SassyLists/purge";
 @import "SassyLists/random-value";
+@import "SassyLists/range";
 @import "SassyLists/remove";
 @import "SassyLists/remove-duplicates";
 @import "SassyLists/remove-nth";

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: SassyLists
 version: !ruby/object:Gem::Version
-  version: 2.1.1
+  version: 2.2.0
 platform: ruby
 authors:
 - Hugo Giraudel
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2014-07-02 00:00:00.000000000 Z
+date: 2014-07-03 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: sass
@@ -44,9 +44,12 @@ files:
 - stylesheets/SassyLists/_explode.scss
 - stylesheets/SassyLists/_first.scss
 - stylesheets/SassyLists/_flatten.scss
+- stylesheets/SassyLists/_has-multiple-values.scss
+- stylesheets/SassyLists/_has-values.scss
 - stylesheets/SassyLists/_insert-nth.scss
 - stylesheets/SassyLists/_intersection.scss
 - stylesheets/SassyLists/_is-empty.scss
+- stylesheets/SassyLists/_is-single.scss
 - stylesheets/SassyLists/_is-symmetrical.scss
 - stylesheets/SassyLists/_last-index.scss
 - stylesheets/SassyLists/_last.scss
@@ -54,6 +57,7 @@ files:
 - stylesheets/SassyLists/_prepend.scss
 - stylesheets/SassyLists/_purge.scss
 - stylesheets/SassyLists/_random-value.scss
+- stylesheets/SassyLists/_range.scss
 - stylesheets/SassyLists/_remove-duplicates.scss
 - stylesheets/SassyLists/_remove-nth.scss
 - stylesheets/SassyLists/_remove.scss
@@ -71,6 +75,7 @@ files:
 - stylesheets/SassyLists/_to-string.scss
 - stylesheets/SassyLists/_union.scss
 - stylesheets/SassyLists/_walk.scss
+- stylesheets/SassyLists/helpers/_is-number.scss
 - stylesheets/SassyLists/helpers/_missing-dependencies.scss
 - stylesheets/SassyLists/helpers/_str-compare.scss
 - stylesheets/SassyLists/helpers/_true.scss