SassyLists 0.4.9 → 1.0.0

data/stylesheets/SassyLists/_loop.scss

@@ -4,27 +4,34 @@
 // -------------------------------------------------------------------------------
 // @alias `shift-indexes()`
 // -------------------------------------------------------------------------------
-// @example loop(a b c d e)     => e, a, b, c, d
-// @example loop(a b c d e,  2) => d, e, a, b, c
-// @example loop(a b c d e, -2) => c, d, e, a, b
-// -------------------------------------------------------------------------------
 // @param $list [List] : list
 // @param $value [Number] : number of position between old and new indexes
 // -------------------------------------------------------------------------------
-// @return [List]
+// @raise [Error] if $value isn't an integer
+// -------------------------------------------------------------------------------
+// @return [List] | false
 
 @function loop($list, $value: 1) {
-    $result: ();
-    $length: length($list);
+  @if type-of($value) != "number" {
+    @warn "#{$value} is not a number for `loop`.";
+    @return false;
+  }
+
+  @if length($list) < 2 {
+    @return $list;
+  }
+
+  $result: ();
+  $length: length($list);
 
-    @for $i from 0 to $length {
-        $result: append($result, nth($list, ($i - $value) % $length + 1));
-    }
+  @for $i from 0 to $length {
+    $result: append($result, nth($list, ($i - $value) % $length + 1), list-separator($list));
+  }
 
-    @return $result;
+  @return $result;
 }
 
 // Alias
 @function shift-indexes($list, $value: 1) {
-    @return loop($list, $value);
+  @return loop($list, $value);
 }

data/stylesheets/SassyLists/_prepend.scss

@@ -2,8 +2,7 @@
 // -------------------------------------------------------------------------------
 // @documentation http://sassylists.com/documentation/#prepend
 // -------------------------------------------------------------------------------
-// @example prepend(a b c, z)   => z, a, b, c
-// @example prepend(a b c, y z) => y z, a, b, c
+// @dependence `is-true()`
 // -------------------------------------------------------------------------------
 // @param $list [List] : list
 // @param $value [Literal] : value to prepend to the list
@@ -11,11 +10,11 @@
 // @return [List]
 
 @function prepend($list, $value) {
-    @if $value and $value != "" and $value != () {
-        @return join($value, $list);
-    }
+  @if is-true($value) {
+    @return join($value, $list, list-separator($list));
+  }
 
-    @else {
-        @return $list;
-    }
+  @else {
+    @return $list;
+  }
 }

data/stylesheets/SassyLists/_purge.scss

@@ -4,26 +4,25 @@
 // -------------------------------------------------------------------------------
 // @alias `clean()`
 // -------------------------------------------------------------------------------
-// @example purge(a null b false c) => a, b, c
-// @example purge(a b c '')         => a, b, c
+// @dependence `is-true()`
 // -------------------------------------------------------------------------------
 // @param $list [List] : list
 // -------------------------------------------------------------------------------
 // @return [List]
 
 @function purge($list) {
-    $result: ();
+  $result: ();
 
-    @each $item in $list {
-        @if $item and $item != "" and $item != () {
-            $result: append($result, $item);
-        }
+  @each $item in $list {
+    @if is-true($item) {
+      $result: append($result, $item, list-separator($list));
     }
+  }
 
-    @return $result;
+  @return $result;
 }
 
 // Alias
 @function clean($list) {
-    @return purge($list);
+  @return purge($list);
 }

data/stylesheets/SassyLists/_random-value.scss

@@ -5,23 +5,28 @@
 // @alias `roll()`
 // @alias `luck()`
 // -------------------------------------------------------------------------------
-// @dependence `rand()` (Ruby)
-// -------------------------------------------------------------------------------
-// @example random-value(a b c d e) => c
+// @dependence `random()` (Ruby)
 // -------------------------------------------------------------------------------
 // @param $list [List] : List
 // -------------------------------------------------------------------------------
-// @return [Literal]
+// @raise [Error] if $list is empty
+// -------------------------------------------------------------------------------
+// @return [Literal] | false
 
 @function random-value($list) {
-    @return nth($list, random(length($list)) + 1);
+  @if length($list) == 0 {
+    @warn "Cannot find a random value in an empty list.";
+    @return false;
+  }
+
+  @return nth($list, random(length($list)) + 1);
 }
 
 // Aliases
 @function roll($list) {
-    @return random-value($list);
+  @return random-value($list);
 }
 
 @function luck($list) {
-    @return random-value($list);
+  @return random-value($list);
 }

data/stylesheets/SassyLists/_remove-duplicates.scss

@@ -4,33 +4,24 @@
 // -------------------------------------------------------------------------------
 // @alias `unique()`
 // -------------------------------------------------------------------------------
-// @example remove-duplicates(a b a c b d c e)   => a, b, c, d, e
-// @example remove-duplicates(a b (c c c), true) => a, b, c
-// -------------------------------------------------------------------------------
 // @param $list [List] : list
 // @param $recursive [Boolean] : enable / disable recursivity
 // -------------------------------------------------------------------------------
 // @return [List]
 
-@function remove-duplicates($list, $recursive: false) {
-    $result: ();
-
-    @each $item in $list {
-        @if not index($result, $item) {
-            @if length($item) > 1 and $recursive {
-                $result: append($result, remove-duplicates($item, $recursive));
-            }
+@function remove-duplicates($list) {
+  $result: ();
 
-            @else {
-                $result: append($result, $item);
-            }
-        }
+  @each $item in $list {
+    @if not index($result, $item) {
+      $result: append($result, $item, list-separator($list));
     }
+  }
 
-    @return $result;
+  @return $result;
 }
 
 // Alias
 @function unique($list, $recursive: false) {
-    @return remove-duplicates($list, $recursive);
+  @return remove-duplicates($list, $recursive);
 }

data/stylesheets/SassyLists/_remove-nth.scss

@@ -6,26 +6,16 @@
 // -------------------------------------------------------------------------------
 // @dependence `replace-nth()`
 // -------------------------------------------------------------------------------
-// @example remove-nth(a b c,   2) => a, c
-// @example remove-nth(a b c,   0) => error
-// @example remove-nth(a b c,  -1) => a, b
-// @example remove-nth(a b c,  10) => error
-// @example remove-nth(a b c, -10) => error
-// -------------------------------------------------------------------------------
 // @param $list [List] : list
 // @param $index [Number] : index to remove
 // -------------------------------------------------------------------------------
-// @raise [Error] if $index isn't an integer
-// @raise [Error] if $index is 0
-// @raise [Error] if abs value of $index is strictly greater then length of $list
-// -------------------------------------------------------------------------------
 // @return [List] | false
 
 @function remove-nth($list, $index) {
-    @return replace-nth($list, $index, "");
+  @return replace-nth($list, $index, "");
 }
 
 // Alias
 @function without-nth($list, $index) {
-    @return remove-nth($list, $index);
+  @return remove-nth($list, $index);
 }

data/stylesheets/SassyLists/_remove.scss

@@ -6,22 +6,17 @@
 // -------------------------------------------------------------------------------
 // @dependence `replace()`
 // -------------------------------------------------------------------------------
-// @example remove(a b c,   b)       => a, c
-// @example remove(a b c,   z)       => a, b, c
-// @example remove(a b c b, b)       => a, c b
-// @example remove(a b c b, b, true) => a, c
-// -------------------------------------------------------------------------------
 // @param $list [List] : list
 // @param $value [Literal] : value to remove
 // @param $recursive [Boolean] : enable / disable recursivity
 // -------------------------------------------------------------------------------
 // @return [List]
 
-@function remove($list, $value, $recursive: false) {
-    @return replace($list, $value, null, $recursive);
+@function remove($list, $value) {
+  @return replace($list, $value, null);
 }
 
 // Alias
-@function without($list, $value, $recursive: false) {
-    @return remove($list, $value, $recursive);
+@function without($list, $value) {
+  @return remove($list, $value);
 }

data/stylesheets/SassyLists/_replace-nth.scss

@@ -2,11 +2,7 @@
 // -------------------------------------------------------------------------------
 // @documentation http://sassylists.com/documentation/#replace-nth
 // -------------------------------------------------------------------------------
-// @example replace-nth(a b c,   2, z) => a, z, c
-// @example replace-nth(a b c,   0, z) => error
-// @example replace-nth(a b c,  10, z) => error
-// @example replace-nth(a b c,  -1, z) => a, b, z
-// @example replace-nth(a b c, -10, z) => error
+// @dependence `purge()`
 // -------------------------------------------------------------------------------
 // @param $list [List] : list
 // @param $index [Number] : index to update
@@ -19,29 +15,11 @@
 // @return [List] | false
 
 @function replace-nth($list, $index, $value) {
-    @if type-of($index) != number {
-        @warn "List index #{$index} is not a number for `replace-nth`/`remove-nth`.";
-        @return false;
-    }
+  @if type-of($index) != "number" or $index == 0 or abs($index) > length($list) {
+    @warn "Invalid index (#{$index}) for `replace-nth`.";
+    @return false;
+  }
 
-    @if $index == 0 {
-        @warn "List index 0 must be a non-zero integer for `replace-nth`/`remove-nth`.";
-        @return false;
-    }
-
-    @if abs($index) > length($list) {
-        @warn "List index is #{$index} but list is only #{length($list)} item long for `replace-nth`/`remove-nth`.";
-        @return false;
-    }
-
-    $result: ();
-    $index: if($index < 0, length($list) + $index + 1, $index);  
-
-    @for $i from 1 through length($list) {
-        @if $value and $value != "" and $value != () {
-            $result: append($result, if($i == $index, $value, nth($list, $i)));
-        }
-    }
-
-    @return $result;
+  $list: set-nth($list, $index, $value);
+  @return if(not is-true($value), purge($list), $list);
 }

data/stylesheets/SassyLists/_replace.scss

@@ -1,37 +1,28 @@
-// Replaces $old-value by $new-value in $list
+// Replaces $old by $new in $list
 // -------------------------------------------------------------------------------
 // @documentation http://sassylists.com/documentation.html#replace
 // -------------------------------------------------------------------------------
-// @example replace( (a, b, c), b, z )         => a, z, c
-// @example replace( (a, b, c), y, z )         => a, b, c
-// @example replace( (a, b, c a), a, z )       => z, b, c z
-// @example replace( (a, b, c a), a, z, true ) => z, b, c z
-// -------------------------------------------------------------------------------
 // @param $list [List] : list
 // @param $old [Literal] : value to replace
-// @param $value [Literal] : new value for $old-value
-// @param $recursive [Boolean] : enable / disable recursivity
+// @param $value [Literal] : new value for $old
 // -------------------------------------------------------------------------------
 // @return [List]
 
-@function replace($list, $old, $value, $recursive: false) {
-    $result: ();
+@function replace($list, $old, $value) {
+  $running: true;
 
-    @each $item in $list {
-        @if $item == $old {
-            @if $value and $value != '' and $value != () {
-                $result: append($result, $value);
-            }
-        }
+  @while $running {
+    $index: index($list, $old);
 
-        @else if length($item) > 1 and $recursive {
-            $result: append($result, replace($item, $old, $value, $recursive));
-        }
+    @if not $index {
+      $running: false;
+    }
 
-        @else {
-            $result: append($result, $item);
-        }
+    @else {
+      $list: set-nth($list, $index, $value);
     }
 
-    @return $result;
+  }
+
+  @return if(not is-true($value), purge($list), $list);
 }

data/stylesheets/SassyLists/_reverse.scss

@@ -4,34 +4,28 @@
 // -------------------------------------------------------------------------------
 // @alias `mirror()`
 // -------------------------------------------------------------------------------
-// @example reverse(a b c)           => c, b, a
-// @example reverse(a b (c a))       => c a, b, a
-// @example reverse(a b (c a), true) => a c, b, a
-// -------------------------------------------------------------------------------
 // @param $list [List] : list
-// @param $recursive [Boolean] : enable / disable recursivity
 // -------------------------------------------------------------------------------
 // @return [List]
 
-@function reverse($list, $recursive: false) {
-    $result: ();
-
-    @for $i from length($list) * -1 through -1 {
-        $item: nth($list, abs($i));
+@function reverse($list) {
+  $length: length($list);
+  $end: floor($length/2);
 
-        @if length($item) > 1 and $recursive {
-            $result: append($result, reverse($item, $recursive));      
-        }
+  @if $length < 2 {
+    @return $list;
+  }
 
-        @else {
-            $result: append($result, $item);
-        }
-    }
+  @for $i from 1 through $end {
+    $tmp: nth($list, $i);
+    $list: set-nth($list, $i, nth($list, -$i));
+    $list: set-nth($list, -$i, $tmp);
+  }
 
-    @return $result;
+  @return $list;
 }
 
 // Alias
-@function mirror($list, $recursive: false) {
-    @return reverse($list, $recursive);
+@function mirror($list) {
+  @return reverse($list);
 }

data/stylesheets/SassyLists/_shuffle.scss

@@ -4,24 +4,28 @@
 // -------------------------------------------------------------------------------
 // @alias `randomize()`
 // -------------------------------------------------------------------------------
-// @example shuffle(a b c d e) => b d c e a
-// -------------------------------------------------------------------------------
 // @param $list [List] : list
 // -------------------------------------------------------------------------------
 // @return [List]
 
 @function shuffle($list) {
-    @for $i from -1 * length($list) through -1 {
-        $i: abs($i);
-        $j: random(length($list) - 1) + 1;
-        $tmp: nth($list, $i);
-        $list: set-nth($list, $i, nth($list, $j));
-        $list: set-nth($list, $j, $tmp);
-    }
+  $length: length($list);
+
+  @if $length < 2 {
     @return $list;
+  }
+
+  @for $i from -1 * $length through -1 {
+    $i: abs($i);
+    $j: random($length - 1) + 1;
+    $tmp: nth($list, $i);
+    $list: set-nth($list, $i, nth($list, $j));
+    $list: set-nth($list, $j, $tmp);
+  }
+  @return $list;
 }
 
 // Alias
 @function randomize($list) {
-    @return shuffle($list);
+  @return shuffle($list);
 }

data/stylesheets/SassyLists/_slice.scss

@@ -2,13 +2,6 @@
 // -------------------------------------------------------------------------------
 // @documentation http://sassylists.com/documentation/#slice
 // -------------------------------------------------------------------------------
-// @example slice(a b c d,  2, 3) => b, c
-// @example slice(a b c d,  3, 2) => error
-// @example slice(a b c d,  3, 5) => error
-// @example slice(a b c d, -1, 3) => error
-// @example slice(a b c d,  0, 3) => error
-// @example slice(a b c d,  3, 3) => c
-// -------------------------------------------------------------------------------
 // @param $list [List] : list
 // @param $start [Number] : start index
 // @param $end [Number] : end index
@@ -22,36 +15,35 @@
 // @return [List] | false
 
 @function 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;
-    }
+  @if type-of($start) != "number" or type-of($end) != "number" {
+    @warn "List indexes #{$start} and #{$end} must be numbers for `slice`.";
+    @return false;
+  }
 
-    @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;
-    }
+  @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;
+  }
 
-    @if $start < 1 or $end < 1 {
-        @warn "List indexes must be non-zero integers for `slice`.";
-        @return false;
-    }
+  @if $start < 1 or $end < 1 {
+    @warn "List indexes must be non-zero integers for `slice`.";
+    @return false;
+  }
 
-    @if $start > length($list) {
-        @warn "Start index is #{$start} but list is only #{length($list)} items long for `slice`.";
-        @return false;
-    }
+  @if $start > length($list) {
+    @warn "Start index is #{$start} but list is only #{length($list)} items long for `slice`.";
+    @return false;
+  }
 
-    @if $end > length($list) {
-        @warn "End index is #{$end} but list is only #{length($list)} items long for `slice`.";
-        @return false;
-    }
+  @if $end > length($list) {
+    @warn "End index is #{$end} but list is only #{length($list)} items long for `slice`.";
+    @return false;
+  }
 
-    $result: ();
-        
-    @for $i from $start through $end {
-        $result: append($result, nth($list, $i));
-    }
+  $result: ();
+  @for $i from $start through $end {
+    $result: append($result, nth($list, $i), list-separator($list));
+  }
 
-    @return $result;
+  @return $result;
 }

data/stylesheets/SassyLists/_sort.scss

@@ -1,55 +1,41 @@
-// Sorts numeric values of $list
+// Sorts values of $list using quick-sort algorithm
 // -------------------------------------------------------------------------------
 // @documentation http://sassylists.com/documentation/#sort
 // -------------------------------------------------------------------------------
 // @alias `order()`
 // -------------------------------------------------------------------------------
-// @example sort(5 12 4.7 6 69 6)          => 4.7, 5, 6, 6, 12, 69
-// @example sort(5 12 4.7 "8" 6 14px 69 6) => 4.7, 5, 6, 6, 12, 69
+// @dependence `str-compare()`
 // -------------------------------------------------------------------------------
 // @param $list [List] : list
-// @param $ascending [Boolean] : ascending or descending
-// -------------------------------------------------------------------------------
-// @raise [Warning] if not-number found
+// @param $order [List] : order
 // -------------------------------------------------------------------------------
 // @return [List]
 
-@function sort($list) {
-    $less:  ();
-    $equal: ();
-    $large: ();
-    $seed: ceil(length($list) / 2);
-
-    @if length($list) > 1 {
-        $seed: nth($list, $seed);
-
-        @each $item in $list {
-            @if comparable($seed, $item) {
-                @if $item < $seed {
-                    $less: append($less, $item);
-                }
-
-                @else if $item == $seed {
-                    $equal: append($equal, $item);
-                }
-
-                @else {
-                    $large: append($large, $item);
-                }
-            }
-
-            @else {
-                @warn "Not integer value found. Omitted.";
-            }
-        }
-
-        @return join(join(sort($less), $equal), sort($large));
+@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") {
+  $less:  ();
+  $equal: ();
+  $large: ();
+  $length: length($list);
+
+  @if $length > 1 {
+    $seed: nth($list, ceil($length / 2));
+    @each $item in $list {
+      @if $item == $seed {
+        $equal: append($equal, $item, list-separator($list));
+      }
+      @else if str-compare($item, $seed, $order) {
+        $less: append($less, $item, list-separator($list));
+      }
+      @else if not str-compare($item, $seed, $order) {
+        $large: append($large, $item, list-separator($list));
+      }
     }
-
-    @return $list;
+    @return join(join(sort($less, $order), $equal), sort($large, $order));
+  }
+  @return $list;
 }
 
 // Alias
 @function order($list) {
-    @return sort($list);
+  @return sort($list);
 }

data/stylesheets/SassyLists/_sum.scss

@@ -1,33 +1,28 @@
-// Sums up all unitless values in $list
+// Sums up all numeric values in $list
 // -------------------------------------------------------------------------------
 // @documentation http://sassylists.com/documentation/#sum
 // -------------------------------------------------------------------------------
-// @example sum(1 2 3 4 5)         => 15
-// @example sum(1 a 2 b 3)         => 6
-// @example sum(10px 3em 5%)       => 0
-// @example sum(10px 3em 5%, true) => 18
-// -------------------------------------------------------------------------------
 // @param $list [List] : list
 // @param $force [Boolean] : enable / disable parseInt
 // -------------------------------------------------------------------------------
 // @return [Number]
 
 @function sum($list, $force: false) {
-    $result: 0;
+  $result: 0;
 
-    @each $item in $list {
-        @if type-of($item) == number {
+  @each $item in $list {
+    @if type-of($item) == number {
 
-            @if $force and not unitless($item) {
-                $item: $item / ($item * 0 + 1);
-            }
+      @if $force and not unitless($item) {
+        $item: $item / ($item * 0 + 1);
+      }
 
-            @if unitless($item) {
-                $result: $result + $item;
-            }
+      @if unitless($item) {
+        $result: $result + $item;
+      }
 
-        }
     }
+  }
 
-    @return $result;
+  @return $result;
 }