ListFunctions 0.1 → 0.2

data/stylesheets/ListFunctions/_reverse.scss

@@ -1,30 +1,30 @@
-/**
- * Reverses the order of $list
- * -------------------------------------------------------------------------------
- * @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
- * @example reverse( a )                 => 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));
-
-    @if length($item) > 1 and $recursive {
-      $result: append($result, reverse($item, $recursive));      
-    }
-
-    @else {
-      $result: append($result, $item);
-    }
-  }
-
-  @return $result;
+/**
+ * Reverses the order of $list
+ * -------------------------------------------------------------------------------
+ * @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
+ * @example reverse( a )                 => 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));
+
+    @if length($item) > 1 and $recursive {
+      $result: append($result, reverse($item, $recursive));      
+    }
+
+    @else {
+      $result: append($result, $item);
+    }
+  }
+
+  @return $result;
 }

data/stylesheets/ListFunctions/_slice.scss

@@ -1,60 +1,60 @@
-/**
- * Slices $list between $start and $end
- * -------------------------------------------------------------------------------
- * @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
- * -------------------------------------------------------------------------------
- * @raise [Error] if $start or $end aren't integers
- * @raise [Error] if $start is greater than $end
- * @raise [Error] if $start or $end is strictly lesser than 1
- * @raise [Error] if $start is strictly greater than length of $list
- * @raise [Error] if $end is strictly greater than length of $list
- * -------------------------------------------------------------------------------
- * @return [List] | false
- */ 
-@function slice($list, $start: 1, $end: length($list)) {
-  $result: false;
-              
-  @if type-of($start) != number or type-of($end) != number {
-    @warn "Either $start or $end are not a number for `slice`.";
-    @return $result;
-  }
-             
-  @else if $start > $end {
-    @warn "The start index has to be lesser than or equals to the end index for `slice`.";
-    @return $result;
-  }
-
-  @else if $start < 1 or $end < 1 {
-    @warn "List indexes must be non-zero integers for `slice`.";
-    @return $result;
-  }
-
-  @else if $start > length($list) {
-    @warn "List index is #{$start} but list is only #{length($list)} item long for `slice`.";
-    @return $result;
-  }
-             
-  @else if $end > length($list) {
-    @warn "List index is #{$end} but list is only #{length($list)} item long for `slice`.";
-    @return $result;
-  }
-  
-  @else {
-    $result: ();
-                
-    @for $i from $start through $end {
-      $result: append($result, nth($list, $i));
-    }
-  }
-
-  @return $result;
+/**
+ * Slices $list between $start and $end
+ * -------------------------------------------------------------------------------
+ * @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
+ * -------------------------------------------------------------------------------
+ * @raise [Error] if $start or $end aren't integers
+ * @raise [Error] if $start is greater than $end
+ * @raise [Error] if $start or $end is strictly lesser than 1
+ * @raise [Error] if $start is strictly greater than length of $list
+ * @raise [Error] if $end is strictly greater than length of $list
+ * -------------------------------------------------------------------------------
+ * @return [List] | false
+ */ 
+@function slice($list, $start: 1, $end: length($list)) {
+  $result: false;
+              
+  @if type-of($start) != number or type-of($end) != number {
+    @warn "Either $start or $end are not a number for `slice`.";
+    @return $result;
+  }
+             
+  @else if $start > $end {
+    @warn "The start index has to be lesser than or equals to the end index for `slice`.";
+    @return $result;
+  }
+
+  @else if $start < 1 or $end < 1 {
+    @warn "List indexes must be non-zero integers for `slice`.";
+    @return $result;
+  }
+
+  @else if $start > length($list) {
+    @warn "List index is #{$start} but list is only #{length($list)} item long for `slice`.";
+    @return $result;
+  }
+             
+  @else if $end > length($list) {
+    @warn "List index is #{$end} but list is only #{length($list)} item long for `slice`.";
+    @return $result;
+  }
+  
+  @else {
+    $result: ();
+                
+    @for $i from $start through $end {
+      $result: append($result, nth($list, $i));
+    }
+  }
+
+  @return $result;
 }

data/stylesheets/ListFunctions/_sort.scss

@@ -0,0 +1,42 @@
+/** 
+ * Sort numeric values of $list
+ * -------------------------------------------------------------------------------
+ * @dependence `last()`
+ * @dependence `insert-nth()`
+ * -------------------------------------------------------------------------------
+ * @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
+ * @example sort( 1 )                                 => 1
+ * -------------------------------------------------------------------------------
+ * @param $list [List] : list
+ * -------------------------------------------------------------------------------
+ * @return [List]
+ */
+@function sort($list) {
+  $result : nth($list, 1);
+  
+  @if length($list) > 1 {
+    @for $i from 2 through length($list) {
+      $item: nth($list, $i);
+      @if type-of($item) == number and unitless($item) { 
+        @if $item > last($result) {
+          $result: append($result, $item);
+        }
+        @else {
+          $index: 0;
+          @for $i from 1 through length($result) {
+            @if $item <= nth($result, $i) {
+              $index: $i;
+            }
+          }
+          $result: insert-nth($result, $index, $item); 
+        }
+      }
+      @else {
+        @warn "Not unitless number found. Omitted.";
+      }
+    }
+  }
+  
+  @return $result;
+}

data/stylesheets/ListFunctions/_sum.scss

@@ -1,32 +1,32 @@
-/**
- * Sum up all unitless values in $list
- * -------------------------------------------------------------------------------
- * @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;
-  
-  @each $item in $list {
-    @if type-of($item) == number {
-
-      @if $force and unit($item) {
-        $item: $item / ($item * 0 + 1);
-      }
-
-      @if unitless($item) {
-        $result: $result + $item;
-      }
-      
-    }
-  }
-  
-  @return $result;
-}
+/**
+ * Sum up all unitless values in $list
+ * -------------------------------------------------------------------------------
+ * @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;
+  
+  @each $item in $list {
+    @if type-of($item) == number {
+
+      @if $force and unit($item) {
+        $item: $item / ($item * 0 + 1);
+      }
+
+      @if unitless($item) {
+        $result: $result + $item;
+      }
+      
+    }
+  }
+  
+  @return $result;
+}

data/stylesheets/ListFunctions/_to-string.scss

@@ -1,29 +1,29 @@
-/**
- * Joins all elements of $list with $glue
- * -------------------------------------------------------------------------------
- * @example to-string( (a, b, c) )      => abc
- * @example to-string( (a, b, c), '-' ) => a-b-c
- * @example to-string( (a, b c, d) )    => abcd
- * -------------------------------------------------------------------------------
- * @param $list [List] : list
- * @param $glue [String] : value to use as a join string
- * @param $is-nested [Boolean] : strictly internal boolean for recursivity
- * -------------------------------------------------------------------------------
- * @return [String]
- */
-@function to-string($list, $glue: '', $is-nested: false) {
-  $result: null;
-
-  @each $item in $list {
-    @if length($item) > 1 {
-      $result: $result#{to-string($item, $glue, true)};
-    }
-
-    @else {
-      $condition: index($list, item) != length($list) or $is-nested;
-      $result: if($condition, $result#{$item}#{$glue}, $result#{$item});
-    }
-  }
-
-  @return $result;
+/**
+ * Joins all elements of $list with $glue
+ * -------------------------------------------------------------------------------
+ * @example to-string( (a, b, c) )      => abc
+ * @example to-string( (a, b, c), '-' ) => a-b-c
+ * @example to-string( (a, b c, d) )    => abcd
+ * -------------------------------------------------------------------------------
+ * @param $list [List] : list
+ * @param $glue [String] : value to use as a join string
+ * @param $is-nested [Boolean] : strictly internal boolean for recursivity
+ * -------------------------------------------------------------------------------
+ * @return [String]
+ */
+@function to-string($list, $glue: '', $is-nested: false) {
+  $result: null;
+
+  @each $item in $list {
+    @if length($item) > 1 {
+      $result: $result#{to-string($item, $glue, true)};
+    }
+
+    @else {
+      $condition: index($list, item) != length($list) or $is-nested;
+      $result: if($condition, $result#{$item}#{$glue}, $result#{$item});
+    }
+  }
+
+  @return $result;
 }

data/stylesheets/_ListFunctions.scss

@@ -1,90 +1,94 @@
-/* ------------------------------------------------------------------------------- *
- * A couple of advanced Sass list functions
- * ------------------------------------------------------------------------------- *
- *
- * chunk($list, $size)
- * Chunk $list into $size large lists
- *
- * count-values($list)
- * Count the number of occurrences of each value of $list
- *
- * debug($list)
- * Returns $list as a string
- *
- * first($list)
- * Return first element of $list
- *
- * insert-nth($list, $index, $value)
- * Add $value at $index in $list
- *
- * is-symmetrical($list)
- * Check if $list is symmetrical
- * 
- * last($list)
- * Return last element of $list
- *
- * last-index($list, $value)
- * Return last index of $value in $list
- *
- * loop($list, $value: 1)
- * Shift indexes from $list of $value
- *
- * prepend($list, $value)
- * Add $value as first index of $list
- *
- * purge($list)
- * Remove all false and null values from $list
- *
- * remove($list, $value, $recursive: false)
- * Remove value(s) $value from $list
- *
- * remove-duplicates($list, $recursive: false)
- * Remove duplicate values from $list
- *
- * remove-nth($list, $index)
- * Remove value from $list at index $index
- *
- * replace($list, $old-value, $new-value, $recursive: false)
- * Replace $old-value by $new-value in $list
- *
- * replace-nth($list, $index, $value)
- * Replace value at $index from $list by $value
- *
- * reverse($list, $recursive: false)
- * Reverse the order of $list
- *
- * slice($list, $start: 1, $end: length($list))
- * Slice $list between $start and $end
- *
- * sum($list, $force: false)
- * Sum up all unitless values in $list
- *
- * to-string($list, $glue: '', $is-nested: false)
- * Join all elements of $list with $glue
- *
- * ------------------------------------------------------------------------------- *
- * CodePen (SCSS): http://codepen.io/HugoGiraudel/pen/loAgq
- * CodePen (Sass): http://codepen.io/HugoGiraudel/pen/BskrE
- * Repository: https://github.com/Team-Sass/Sass-ListFunctions/
- * ------------------------------------------------------------------------------- */
-
-@import "ListFunctions/chunk";
-@import "ListFunctions/count-values";
-@import "ListFunctions/debug";
-@import "ListFunctions/first";
-@import "ListFunctions/insert-nth";
-@import "ListFunctions/is-symmetrical";
-@import "ListFunctions/last";
-@import "ListFunctions/last-index";
-@import "ListFunctions/loop";
-@import "ListFunctions/prepend";
-@import "ListFunctions/purge";
-@import "ListFunctions/remove";
-@import "ListFunctions/remove-duplicates";
-@import "ListFunctions/remove-nth";
-@import "ListFunctions/replace";
-@import "ListFunctions/replace-nth";
-@import "ListFunctions/reverse";
-@import "ListFunctions/slice";
-@import "ListFunctions/sum";
-@import "ListFunctions/to-string";
+/* ------------------------------------------------------------------------------- *
+ * A couple of advanced Sass list functions
+ * ------------------------------------------------------------------------------- *
+ *
+ * chunk($list, $size)
+ * Chunk $list into $size large lists
+ *
+ * count-values($list)
+ * Count the number of occurrences of each value of $list
+ *
+ * debug($list)
+ * Returns $list as a string
+ *
+ * first($list)
+ * Return first element of $list
+ *
+ * insert-nth($list, $index, $value)
+ * Add $value at $index in $list
+ *
+ * is-symmetrical($list)
+ * Check if $list is symmetrical
+ * 
+ * last($list)
+ * Return last element of $list
+ *
+ * last-index($list, $value)
+ * Return last index of $value in $list
+ *
+ * loop($list, $value: 1)
+ * Shift indexes from $list of $value
+ *
+ * prepend($list, $value)
+ * Add $value as first index of $list
+ *
+ * purge($list)
+ * Remove all false and null values from $list
+ *
+ * remove($list, $value, $recursive: false)
+ * Remove value(s) $value from $list
+ *
+ * remove-duplicates($list, $recursive: false)
+ * Remove duplicate values from $list
+ *
+ * remove-nth($list, $index)
+ * Remove value from $list at index $index
+ *
+ * replace($list, $old-value, $new-value, $recursive: false)
+ * Replace $old-value by $new-value in $list
+ *
+ * replace-nth($list, $index, $value)
+ * Replace value at $index from $list by $value
+ *
+ * reverse($list, $recursive: false)
+ * Reverse the order of $list
+ *
+ * slice($list, $start: 1, $end: length($list))
+ * Slice $list between $start and $end
+ *
+ * sort($list)
+ * Sort all numeric values in $list
+ *
+ * sum($list, $force: false)
+ * Sum up all unitless values in $list
+ *
+ * to-string($list, $glue: '', $is-nested: false)
+ * Join all elements of $list with $glue
+ *
+ * ------------------------------------------------------------------------------- *
+ * CodePen (SCSS): http://codepen.io/HugoGiraudel/pen/loAgq
+ * CodePen (Sass): http://codepen.io/HugoGiraudel/pen/BskrE
+ * Repository: https://github.com/Team-Sass/Sass-ListFunctions/
+ * ------------------------------------------------------------------------------- */
+
+@import "ListFunctions/chunk";
+@import "ListFunctions/count-values";
+@import "ListFunctions/debug";
+@import "ListFunctions/first";
+@import "ListFunctions/insert-nth";
+@import "ListFunctions/is-symmetrical";
+@import "ListFunctions/last";
+@import "ListFunctions/last-index";
+@import "ListFunctions/loop";
+@import "ListFunctions/prepend";
+@import "ListFunctions/purge";
+@import "ListFunctions/remove";
+@import "ListFunctions/remove-duplicates";
+@import "ListFunctions/remove-nth";
+@import "ListFunctions/replace";
+@import "ListFunctions/replace-nth";
+@import "ListFunctions/reverse";
+@import "ListFunctions/slice";
+@import "ListFunctions/sort";
+@import "ListFunctions/sum";
+@import "ListFunctions/to-string";