doggystyle 0.1.0

data/core/functions/lists/_last.scss

@@ -0,0 +1,11 @@
+/// Simple function for targeting the last list item
+///
+/// @author Hugo Giraudel
+///
+/// @link http://hugogiraudel.com/2013/08/08/advanced-sass-list-functions/#selecting-values-from-list
+///
+/// @access public
+
+@function last($list) {
+  @return nth($list, length($list));
+}

data/core/functions/lists/_merge.scss

@@ -0,0 +1,30 @@
+/// Merge any number of lists together
+///
+/// @author Mark Notton
+///
+/// @access public
+///
+/// @param (arglist) $lists - Add as many lists that you are want to merge. Separate lists should be comma-delimited.
+///
+/// @example scss - Usage
+///   $list1 : a b c;
+///   $list2 : 1 2 3;
+///   $new-list : merge($list1, $list2);
+///
+/// @example scss - Usage
+///   $new-list : (a b c 1 2 3);
+/// 
+/// @return {list}
+
+@function merge($lists...) {
+
+  $new-list : ();
+  
+  @each $lists in _arglist-to-list($lists...) {
+    @each $list in $lists {
+      $new-list : join($new-list, $list);
+    }
+  }
+
+  @return $new-list;
+}

data/core/functions/lists/_prepend.scss

@@ -0,0 +1,11 @@
+/// Add an item to the begining of a list 
+///
+/// @author Hugo Giraudel
+///
+/// @link http://hugogiraudel.com/2013/08/08/advanced-sass-list-functions/#adding-values-to-a-list
+///
+/// @access public
+
+@function prepend($list, $value) {
+  @return join($value, $list);
+}

data/core/functions/lists/_remove-nth.scss

@@ -0,0 +1,53 @@
+/// Remove nth item from a list
+///
+/// @author Hugo Giraudel
+///
+/// @link http://hugogiraudel.com/2013/08/08/advanced-sass-list-functions/#removing-values-from-list
+///
+/// @access public
+///
+/// @example scss - Usage
+///   $list: a, b, z, c, d, e, f;
+///   $new-list: remove-nth($list,   3);
+///   $new-list: remove-nth($list,   0);
+///   $new-list: remove-nth($list,  -2);
+///   $new-list: remove-nth($list, -10);
+///   $new-list: remove-nth($list, 100);
+///   $new-list: remove-nth($list, zog);
+///   
+/// @example scss - Output
+///   $new-list: a, b, c, d, e, f
+///   $new-list: error
+///   $new-list: a, b, z, c, d, f
+///   $new-list: error
+///   $new-list: error
+///   $new-list: error
+
+@function remove-nth($list, $index) {
+  $result: null;
+        
+  @if type-of($index) != number {
+    @warn "$index: #{quote($index)} is not a number for `remove-nth`.";
+  }
+
+  @else if $index == 0 {
+    @warn "List index 0 must be a non-zero integer for `remove-nth`.";
+  }
+
+  @else if abs($index) > length($list) {
+    @warn "List index is #{$index} but list is only #{length($list)} item long for `remove-nth`.";
+  }
+
+  @else {
+    $result: ();
+    $index: if($index < 0, length($list) + $index + 1, $index);  
+
+    @for $i from 1 through length($list) {
+      @if $i != $index {
+        $result: append($result, nth($list, $i));
+      }
+    }
+  }
+        
+  @return $result;
+}

data/core/functions/lists/_remove.scss

@@ -0,0 +1,30 @@
+/// Remove an item from a list
+///
+/// @author Hugo Giraudel
+///
+/// @link http://hugogiraudel.com/2013/08/08/advanced-sass-list-functions/#removing-values-from-list
+///
+/// @example scss - Usage
+///   $list: a, b z, c, z, d, z, e, f;
+///   $new-list: remove($list, z);
+///   $new-list: remove($list, z, true);
+///   
+/// @example scss - Output
+///   $new-list: a, b z, c, d, e, f;
+///   $new-list: a, b, c, d, e, f
+
+@function remove($list, $value, $recursive: false) {
+  $result: ();
+
+  @for $i from 1 through length($list) {
+    @if type-of(nth($list, $i)) == list and $recursive {
+      $result: append($result, remove(nth($list, $i), $value, $recursive));
+    }
+
+    @else if nth($list, $i) != $value {
+      $result: append($result, nth($list, $i));
+    }
+  }
+
+  @return $result;
+}

data/core/functions/lists/_replace-nth.scss

@@ -0,0 +1,55 @@
+/// Replace a value at nth index in a list
+///
+/// @author Hugo Giraudel
+///
+/// @link http://hugogiraudel.com/2013/08/08/advanced-sass-list-functions/#replacing-values-from-list
+///
+/// @example scss - Usage
+///   $list: a, b, z, d, e, f;
+///   $new-list: replace-nth($list,   3, c);
+///   $new-list: replace-nth($list,   0, c);
+///   $new-list: replace-nth($list,  -2, c);
+///   $new-list: replace-nth($list, -10, c);
+///   $new-list: replace-nth($list, 100, c);
+///   $new-list: replace-nth($list, zog, c);
+///
+/// @example scss - Output
+///   $new-list: a, b, c, d, e, f
+///   $new-list: error
+///   $new-list: a, b, c, d, z, f
+///   $new-list: error
+///   $new-list: error
+///   $new-list: error
+
+@function replace-nth($list, $index, $value) {
+  $result: null;
+      
+  @if type-of($index) != number {
+    @warn "$index: #{quote($index)} is not a number for `replace-nth`.";
+  }
+
+  @else if $index == 0 {
+    @warn "List index 0 must be a non-zero integer for `replace-nth`.";
+  }
+      
+  @else if abs($index) > length($list) {
+    @warn "List index is #{$index} but list is only #{length($list)} item long for `replace-nth`.";
+  }
+
+  @else {
+    $result: ();
+    $index: if($index < 0, length($list) + $index + 1, $index);  
+
+    @for $i from 1 through length($list) {
+      @if $i == $index {
+        $result: append($result, $value);
+      }
+    
+      @else {
+        $result: append($result, nth($list, $i));
+      }
+    }
+  }
+ 
+  @return $result;
+}

data/core/functions/lists/_replace.scss

@@ -0,0 +1,36 @@
+/// Replacing values in a list
+///
+/// @author Hugo Giraudel
+///
+/// @link http://hugogiraudel.com/2013/08/08/advanced-sass-list-functions/#replacing-values-from-list
+///
+/// @example scss - Usage
+///   $list: a, b, r, a, c a, d a, b, r, a;
+///   $new-list1: replace($list, a, u);
+///   $new-list2: replace($list, a, u, true); 
+///
+/// @example scss - Output
+///   $new-list1: u, b, r, u, c a, d a, b, r, u;
+///   $new-list2: u, b, r, u, c u, d u, b, r, u;
+
+@function replace($list, $old-value, $new-value, $recursive: false) {
+  $result: ();
+
+  @for $i from 1 through length($list) {
+    @if type-of(nth($list, $i)) == list and $recursive {
+      $result: append($result, replace(nth($list, $i), $old-value, $new-value, $recursive));
+    }
+
+    @else {
+      @if nth($list, $i) == $old-value {
+        $result: append($result, $new-value);
+      }
+
+      @else {
+        $result: append($result, nth($list, $i));
+      }
+    }
+  }
+
+  @return $result;
+}

data/core/functions/lists/_reverse.scss

@@ -0,0 +1,31 @@
+/// Reverse a lsit
+///
+/// @author Hugo Giraudel
+///
+/// @link http://hugogiraudel.com/2013/08/08/advanced-sass-list-functions/#miscellaneous
+///
+/// @example scss - Usage
+///   $list: a, b, c d e, f, g, h;
+///   $new-list: reverse($list);
+///   $new-list: reverse($list, true);
+///
+/// @example scss - Output
+///   $list: a, b, c d e, f, g, h;
+///   $new-list: h, g, f, c d e, b, a
+///   $new-list: h, g, f, e d c, b, a
+
+@function reverse($list, $recursive: false) {
+   $result: ();
+
+   @for $i from length($list)*-1 through -1 {
+      @if type-of(nth($list, abs($i))) == list and $recursive {
+        $result: append($result, reverse(nth($list, abs($i)), $recursive));      
+      }
+
+      @else {
+        $result: append($result, nth($list, abs($i)));
+      }
+   }
+
+   @return $result;
+}

data/core/functions/lists/_second.scss

@@ -0,0 +1,19 @@
+/// Simple function for targeting the second list item
+///
+/// @author Hugo Giraudel
+///
+/// @link http://hugogiraudel.com/2013/08/08/advanced-sass-list-functions/#selecting-values-from-list
+///
+/// @access public
+/// 
+/// @param {list}
+///
+/// @return {list}
+
+@function second($list) {
+  @if length($list) >= 2 {
+    @return nth($list, 2);
+  } @else {
+    @return null;
+  }
+}

data/core/functions/lists/_shift.scss

@@ -0,0 +1,24 @@
+/// Shift the index of a list
+///
+/// @author Ana Tudor
+///
+/// @link http://hugogiraudel.com/2013/08/08/advanced-sass-list-functions/#miscellaneous
+///
+/// @example scss - Usage
+///   $list: a, b, c, d, e, f;
+///   $new-list: loop($list, 1);
+///   $new-list: loop($list, -3);
+///
+/// @example scss - Output
+///   $new-list: f, a, b, c, d, e
+///   $new-list: d, e, f, a, b, c
+
+@function loop($list, $value: 1) {
+  $result: ();
+    
+  @for $i from 0 to length($list) {
+    $result: append($result, nth($list, ($i - $value) % length($list) + 1));
+  }
+  
+  @return $result;
+}

data/core/functions/lists/_slice.scss

@@ -0,0 +1,52 @@
+/// Slice a list
+///
+/// @author Hugo Giraudel
+///
+/// @link http://hugogiraudel.com/2013/08/08/advanced-sass-list-functions/#miscellaneous
+///
+/// @example scss - Usage
+///   $list: a, b, c, d, e, f;
+///   $new-list: slice($list, 3, 5);
+///   $new-list: slice($list, 4, 4);
+///   $new-list: slice($list, 5, 3);
+///   $new-list: slice($list, -1, 10);
+///
+/// @example scss - Output
+///   $new-list: c, d, e
+///   $new-list: d
+///   $new-list: error
+///   $new-list: error
+
+@function slice($list, $start: 1, $end: length($list)) {
+  $result: null;
+              
+  @if type-of($start) != number or type-of($end) != number {
+    @warn "Either $start or $end are not a number for `slice`.";
+  }
+             
+  @else if $start > $end {
+    @warn "The start index has to be lesser than or equals to the end index for `slice`.";
+  }
+
+  @else if $start < 1 or $end < 1 {
+    @warn "List indexes must be non-zero integers for `slice`.";
+  }
+
+  @else if $start > length($list) {
+    @warn "List index is #{$start} but list is only #{length($list)} item long for `slice`.";
+  }
+             
+  @else if $end > length($list) {
+    @warn "List index is #{$end} but list is only #{length($list)} item long for `slice`.";
+  }
+  
+  @else {
+    $result: ();
+                
+    @for $i from $start through $end {
+      $result: append($result, nth($list, $i));
+    }
+  }
+
+  @return $result;
+}

data/core/functions/lists/_sort.scss

@@ -0,0 +1,51 @@
+/// Default order used to determine which string comes first
+///
+/// @author Hugo Giraudel
+///
+/// @link https://css-tricks.com/snippets/sass/sorting-function/
+///
+/// @type list
+
+$default-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" !default;
+
+
+/// Sort list in a particular order.
+/// 
+/// @author Hugo Giraudel
+///
+/// @link https://css-tricks.com/snippets/sass/sorting-function/
+///
+/// @access public
+///
+/// @param {list} $list - list to sort
+///
+/// @param {list} $order - Order to use for sorting - Default is $default-order;
+///
+/// @require {function} _string-compare
+/// @require {variable} default-order
+///
+/// @return {list}
+
+@function sort($list, $order: $default-order) {
+  $less:  ();
+  $equal: ();
+  $large: ();
+
+  @if length($list) > 1 {
+    $seed: nth($list, ceil(length($list) / 2));
+
+    @each $item in $list {
+      @if $item == $seed {
+        $equal: append($equal, $item, list-separator($list));
+      } @else if _string-compare($item, $seed, $order) {
+        $less: append($less, $item, list-separator($list));
+      } @else if not _string-compare($item, $seed, $order) {
+        $large: append($large, $item, list-separator($list));
+      }
+    }
+
+    @return join(join(sort($less, $order), $equal), sort($large, $order));
+  }
+
+  @return $list;
+}

data/core/functions/maps/_map-deep-get.scss

@@ -0,0 +1,51 @@
+/// Fetch nested keys in a map
+///
+/// @author Hugo Giraudel
+///
+/// @link http://www.sitepoint.com/extra-map-functions-sass
+///
+/// @access public
+///
+/// @param (map) $map - Usually a variable name
+///
+/// @param (arglist) $keys - With comma delimination write the path to the disired map element
+///
+/// @return {*}
+///
+/// @example scss - Usage
+/// $foo: (
+///   bar: (
+///     lorem : (
+///       test1: #dcfac0,
+///       test2: #00968b,
+///     ),
+///     ipsom: (
+///       test1: #f4fac7,
+///       test2: #c2454e,
+///     )
+///   )
+/// );
+/// color: map-fetch($foo, bar, lorem, test1);
+///
+/// @example css - Output
+/// color:#dcfac0;
+
+@function map-deep-get($map, $keys...) {
+  @each $key in $keys {
+    $map: map-get($map, $key);
+  }
+  @return $map;
+}
+
+
+/// @alias map-deep-get
+///
+/// @access public
+/// 
+/// @require {function} map-deep-get
+///
+/// @return {*}
+
+@function map-fetch($map, $keys...) {
+  @return map-deep-get($map, $keys...);
+}