bourbon 4.1.1 → 4.2.0.beta

data/app/assets/stylesheets/functions/_contains-falsy.scss

@@ -0,0 +1,20 @@
+@charset "UTF-8";
+
+/// Checks if a list does not contains a value.
+///
+/// @access private
+///
+/// @param {List} $list
+///   The list to check against.
+///
+/// @return {Bool}
+
+@function contains-falsy($list) {
+  @each $item in $list {
+    @if not $item {
+      @return true;
+    }
+  }
+
+  @return false;
+}

data/app/assets/stylesheets/functions/_contains.scss

@@ -1,5 +1,19 @@
-// Test a Sass list to see if it contains a defined value
-// Allows for checking if a list contains several values at once
+@charset "UTF-8";
+
+/// Checks if a list contains a value(s).
+///
+/// @access private
+///
+/// @param {List} $list
+///   The list to check against.
+///
+/// @param {List} $values
+///   A single value or list of values to check for.
+///
+/// @example scss - Usage
+///   contains($list, $value)
+///
+/// @return {Bool}
 
 @function contains($list, $values...) {
   @each $value in $values {

data/app/assets/stylesheets/functions/_is-length.scss

@@ -1,4 +1,8 @@
-// Check for a valid length
+@charset "UTF-8";
+
+/// Checks for a valid CSS length.
+///
+/// @param {String} $value
 
 @function is-length($value) {
   @return type-of($value) != "null" and (str-slice($value + "", 1, 4) == 'calc'

data/app/assets/stylesheets/functions/_is-light.scss

@@ -0,0 +1,21 @@
+@charset "UTF-8";
+
+/// Programatically determines whether a color is light or dark.
+///
+/// @link http://robots.thoughtbot.com/closer-look-color-lightness
+///
+/// @param {Color (Hex)} $color
+///
+/// @example scss - Usage
+///   is-light($color)
+///
+/// @return {Bool}
+
+@function is-light($hex-color) {
+  $-local-red: red(rgba($hex-color, 1));
+  $-local-green: green(rgba($hex-color, 1));
+  $-local-blue: blue(rgba($hex-color, 1));
+  $-local-lightness: ($-local-red * 0.2126 + $-local-green * 0.7152 + $-local-blue * 0.0722) / 255;
+
+  @return $-local-lightness > 0.6;
+}

data/app/assets/stylesheets/functions/_is-number.scss

@@ -0,0 +1,11 @@
+@charset "UTF-8";
+
+/// Checks for a valid number.
+///
+/// @param {Number} $value
+///
+/// @require {function} contains
+
+@function is-number($value) {
+  @return contains("0" "1" "2" "3" "4" "5" "6" "7" "8" "9" 0 1 2 3 4 5 6 7 8 9, $value);
+}

data/app/assets/stylesheets/functions/_is-size.scss

@@ -1,4 +1,11 @@
-// Check for a valid size
+@charset "UTF-8";
+
+/// Checks for a valid CSS size.
+///
+/// @param {String} $value
+///
+/// @require {function} contains
+/// @require {function} is-length
 
 @function is-size($value) {
   @return is-length($value)

data/app/assets/stylesheets/functions/_px-to-em.scss

@@ -4,10 +4,10 @@
 
 @function em($pxval, $base: $em-base) {
   @if not unitless($pxval) {
-      $pxval: strip-units($pxval);
+    $pxval: strip-units($pxval);
   }
   @if not unitless($base) {
-      $base: strip-units($base);
+    $base: strip-units($base);
   }
   @return ($pxval / $base) * 1em;
 }

data/app/assets/stylesheets/functions/_px-to-rem.scss

@@ -4,12 +4,12 @@
 
 @function rem($pxval) {
   @if not unitless($pxval) {
-      $pxval: strip-units($pxval);
+    $pxval: strip-units($pxval);
   }
 
   $base: $em-base;
   @if not unitless($base) {
-      $base: strip-units($base);
+    $base: strip-units($base);
   }
   @return ($pxval / $base) * 1rem;
 }

data/app/assets/stylesheets/functions/_shade.scss

@@ -0,0 +1,24 @@
+@charset "UTF-8";
+
+/// Mixes a color with black.
+///
+/// @param {Color} $color
+///
+/// @param {Number (Percentage)} $percent
+///   The amount of black to be mixed in.
+///
+/// @example scss - Usage
+///   .element {
+///     background-color: shade(#ffbb52, 60%);
+///   }
+///
+/// @example css - CSS Output
+///   .element {
+///     background-color: #664a20;
+///   }
+///
+/// @return {Color}
+
+@function shade($color, $percent) {
+  @return mix(#000, $color, $percent);
+}

data/app/assets/stylesheets/functions/_strip-units.scss

@@ -1,5 +1,17 @@
-// Srtips the units from a value. e.g. 12px -> 12
+@charset "UTF-8";
 
-@function strip-units($val) {
-  @return ($val / ($val * 0 + 1));
+/// Strips the unit from a number.
+///
+/// @param {Number (With Unit)} $value
+///
+/// @example scss - Usage
+///   $dimension: strip-units(10em);
+///
+/// @example css - CSS Output
+///   $dimension: 10;
+///
+/// @return {Number (Unitless)}
+
+@function strip-units($value) {
+  @return ($value / ($value * 0 + 1));
 }

data/app/assets/stylesheets/functions/_tint.scss

@@ -0,0 +1,24 @@
+@charset "UTF-8";
+
+/// Mixes a color with white.
+///
+/// @param {Color} $color
+///
+/// @param {Number (Percentage)} $percent
+///   The amount of white to be mixed in.
+///
+/// @example scss - Usage
+///   .element {
+///     background-color: tint(#6ecaa6, 40%);
+///   }
+///
+/// @example css - CSS Output
+///   .element {
+///     background-color: #a8dfc9;
+///   }
+///
+/// @return {Color}
+
+@function tint($color, $percent) {
+  @return mix(#fff, $color, $percent);
+}

data/app/assets/stylesheets/functions/_transition-property-name.scss

@@ -2,21 +2,21 @@
 // Example: transition-property-names((transform, color, background), moz) -> -moz-transform, color, background
 //************************************************************************//
 @function transition-property-names($props, $vendor: false) {
-	$new-props: ();
-	
-	@each $prop in $props {
-		$new-props: append($new-props, transition-property-name($prop, $vendor), comma);
-	}
+  $new-props: ();
 
-	@return $new-props;
+  @each $prop in $props {
+    $new-props: append($new-props, transition-property-name($prop, $vendor), comma);
+  }
+
+  @return $new-props;
 }
 
 @function transition-property-name($prop, $vendor: false) {
-	// put other properties that need to be prefixed here aswell
-	@if $vendor and $prop == transform {
-		@return unquote('-'+$vendor+'-'+$prop);
-	}
-	@else {
-		@return $prop;
-	}
-}
+  // put other properties that need to be prefixed here aswell
+  @if $vendor and $prop == transform {
+    @return unquote('-'+$vendor+'-'+$prop);
+  }
+  @else {
+    @return $prop;
+  }
+}

data/app/assets/stylesheets/functions/_unpack.scss

@@ -1,17 +1,27 @@
-// Convert shorthand to the 4-value syntax
+@charset "UTF-8";
+
+/// Converts shorthand to the 4-value syntax.
+///
+/// @param {List} $shorthand
+///
+/// @example scss - Usage
+///   .element {
+///     margin: unpack(1em 2em);
+///   }
+///
+/// @example css - CSS Output
+///   .element {
+///     margin: 1em 2em 1em 2em;
+///   }
 
 @function unpack($shorthand) {
   @if length($shorthand) == 1 {
     @return nth($shorthand, 1) nth($shorthand, 1) nth($shorthand, 1) nth($shorthand, 1);
-  }
-  @else if length($shorthand) == 2 {
+  } @else if length($shorthand) == 2 {
     @return nth($shorthand, 1) nth($shorthand, 2) nth($shorthand, 1) nth($shorthand, 2);
-  }
-  @else if length($shorthand) == 3 {
+  } @else if length($shorthand) == 3 {
     @return nth($shorthand, 1) nth($shorthand, 2) nth($shorthand, 3) nth($shorthand, 2);
-  }
-  @else {
+  } @else {
     @return $shorthand;
   }
 }
-

data/app/assets/stylesheets/helpers/_convert-units.scss

@@ -3,8 +3,8 @@
 // Source: http://sassmeister.com/gist/9647408
 //************************************************************************//
 @function _convert-units($number, $unit) {
-  $strings: 'px' 'cm' 'mm' '%' 'ch' 'pica' 'in' 'em' 'rem' 'pt' 'pc' 'ex' 'vw' 'vh' 'vmin' 'vmax', 'deg', 'rad', 'grad', 'turn';
-  $units:   1px  1cm  1mm  1%  1ch  1pica  1in  1em  1rem  1pt  1pc  1ex  1vw  1vh  1vmin  1vmax,  1deg,  1rad,  1grad, 1turn;
+  $strings: "px" "cm" "mm" "%" "ch" "pica" "in" "em" "rem" "pt" "pc" "ex" "vw" "vh" "vmin" "vmax", "deg", "rad", "grad", "turn";
+  $units:   1px  1cm  1mm  1%  1ch  1pica  1in  1em  1rem  1pt  1pc  1ex  1vw  1vh  1vmin  1vmax, 1deg, 1rad, 1grad, 1turn;
   $index: index($strings, $unit);
 
   @if not $index {

data/app/assets/stylesheets/helpers/_directional-values.scss

@@ -0,0 +1,96 @@
+@charset "UTF-8";
+
+/// Directional-property mixins are shorthands for writing properties like the following
+///
+/// @ignore You can also use `false` instead of `null`.
+///
+/// @param {List} $vals
+///   List of directional values
+///
+/// @example scss - Usage
+///   .element {
+///     @include border-style(dotted null);
+///     @include margin(null 0 10px);
+///   }
+///
+/// @example css - CSS Output
+///   .element {
+///     border-bottom-style: dotted;
+///     border-top-style: dotted;
+///     margin-bottom: 10px;
+///     margin-left: 0;
+///     margin-right: 0;
+///   }
+///
+/// @require {function} contains-falsy
+///
+/// @return {List}
+
+@function collapse-directionals($vals) {
+  $output: null;
+
+  $a: nth($vals, 1);
+  $b: if(length($vals) < 2, $a, nth($vals, 2));
+  $c: if(length($vals) < 3, $a, nth($vals, 3));
+  $d: if(length($vals) < 2, $a, nth($vals, if(length($vals) < 4, 2, 4)));
+
+  @if $a == 0 { $a: 0; }
+  @if $b == 0 { $b: 0; }
+  @if $c == 0 { $c: 0; }
+  @if $d == 0 { $d: 0; }
+
+  @if $a == $b and $a == $c and $a == $d { $output: $a;          }
+  @else if $a == $c and $b == $d         { $output: $a $b;       }
+  @else if $b == $d                      { $output: $a $b $c;    }
+  @else                                  { $output: $a $b $c $d; }
+
+  @return $output;
+}
+
+/// Output directional properties, for instance `margin`.
+///
+/// @access private
+///
+/// @param {String} $pre
+///   Prefix to use
+/// @param {String} $suf
+///   Suffix to use
+/// @param {List} $vals
+///   List of values
+///
+/// @require {function} collapse-directionals
+/// @require {function} contains-falsy
+
+@mixin directional-property($pre, $suf, $vals) {
+  // Property Names
+  $top:    $pre + "-top"    + if($suf, "-#{$suf}", "");
+  $bottom: $pre + "-bottom" + if($suf, "-#{$suf}", "");
+  $left:   $pre + "-left"   + if($suf, "-#{$suf}", "");
+  $right:  $pre + "-right"  + if($suf, "-#{$suf}", "");
+  $all:    $pre +             if($suf, "-#{$suf}", "");
+
+  $vals: collapse-directionals($vals);
+
+  @if contains-falsy($vals) {
+    @if nth($vals, 1) { #{$top}: nth($vals, 1); }
+
+    @if length($vals) == 1 {
+      @if nth($vals, 1) { #{$right}: nth($vals, 1); }
+    } @else {
+      @if nth($vals, 2) { #{$right}: nth($vals, 2); }
+    }
+
+    @if length($vals) == 2 {
+      @if nth($vals, 1) { #{$bottom}: nth($vals, 1); }
+      @if nth($vals, 2) { #{$left}:   nth($vals, 2); }
+    } @else if length($vals) == 3 {
+      @if nth($vals, 3) { #{$bottom}: nth($vals, 3); }
+      @if nth($vals, 2) { #{$left}:   nth($vals, 2); }
+    } @else if length($vals) == 4 {
+      @if nth($vals, 3) { #{$bottom}: nth($vals, 3); }
+      @if nth($vals, 4) { #{$left}:   nth($vals, 4); }
+    }
+  } @else {
+    #{$all}: $vals;
+  }
+}

data/app/assets/stylesheets/helpers/_font-source-declaration.scss

@@ -4,7 +4,8 @@
 @function font-url-prefixer($asset-pipeline) {
   @if $asset-pipeline == true {
     @return font-url;
-  } @else {
+  }
+  @else {
     @return url;
   }
 }

data/app/assets/stylesheets/helpers/_linear-gradient-parser.scss

@@ -10,7 +10,7 @@
 
   $has-multiple-vals: str-index($first-val, " ");
   $has-single-position: unquote(_position-flipper($first-val) + "");
-  $has-angle: _is-num(str-slice($first-val, 0, 0));
+  $has-angle: is-number(str-slice($first-val, 0, 0));
 
   @if $has-multiple-vals {
     $gradients: _linear-side-corner-parser($image, $first-val, $prefix, $suffix, $has-multiple-vals);

data/app/assets/stylesheets/helpers/_linear-positions-parser.scss

@@ -54,7 +54,7 @@
 }
 
 @function _position-flipper($pos) {
- @return if($pos == left, right, null)
+  @return if($pos == left, right, null)
          if($pos == right, left, null)
          if($pos == top, bottom, null)
          if($pos == bottom, top, null);

data/app/assets/stylesheets/helpers/_radial-arg-parser.scss

@@ -1,5 +1,5 @@
-@function _radial-arg-parser($G1, $G2, $pos, $shape-size) {
-  @each $value in $G1, $G2 {
+@function _radial-arg-parser($g1, $g2, $pos, $shape-size) {
+  @each $value in $g1, $g2 {
     $first-val: nth($value, 1);
     $pos-type:  type-of($first-val);
     $spec-at-index: null;
@@ -22,7 +22,7 @@
           $pos: $pos nth($value, $i);
         }
       }
-      $G1: null;
+      $g1: null;
     }
 
     // If not spec calculate correct values
@@ -37,8 +37,8 @@
 
           $pos: $value;
 
-          @if $pos == $G1 {
-            $G1: null;
+          @if $pos == $g1 {
+            $g1: null;
           }
         }
 
@@ -54,16 +54,16 @@
 
           $shape-size: $value;
 
-          @if $value == $G1 {
-            $G1: null;
+          @if $value == $g1 {
+            $g1: null;
           }
 
-          @else if $value == $G2 {
-            $G2: null;
+          @else if $value == $g2 {
+            $g2: null;
           }
         }
       }
     }
   }
-  @return $G1, $G2, $pos, $shape-size;
+  @return $g1, $g2, $pos, $shape-size;
 }