doggystyle 0.1.0

data/core/helpers/checks/_is-position.scss

@@ -0,0 +1,16 @@
+/// Checks to see if value is a direction position
+/// 
+/// @author Hugo Giraudel
+///
+/// @link https://css-tricks.com/snippets/sass/advanced-type-checking/
+///
+/// @access public
+///
+/// @require {function} is-length
+/// @require {function} is-percentage
+///
+/// @return {bool}
+
+@function is-position($value) {
+  @return is-length($value) or is-percentage($value) or index('top' 'right' 'bottom' 'left' 'center', $value) != null;
+}

data/core/helpers/checks/_is-pseudo.scss

@@ -0,0 +1,24 @@
+/// Check to see is a 'before' of 'after' pseudo has been passed
+/// 
+/// @author Mark Notton
+///
+/// @access public
+///
+/// @return {bool}
+
+@function is-pseudo($pseudo) {
+  @return index(before after, $pseudo);
+}
+
+
+/// @alias is-pseudo
+///
+/// @access public
+/// 
+/// @require {function} is-pseudo
+///
+/// @return {bool}
+
+@function is-sudo($pseudo) {
+  @return is-pseudo($pseudo)
+}

data/core/helpers/checks/_is-relative-length.scss

@@ -0,0 +1,25 @@
+/// List of all relative length unit types
+/// 
+/// @link http://www.w3schools.com/cssref/css_units.asp
+///
+/// @type list
+
+$relative-lengths : em ex ch rem vw vh vmin vmax;
+
+
+/// Checks to see if value is a type of unit that can be manipulated relative to parent elements
+/// 
+/// @author Hugo Giraudel
+///
+/// @link https://css-tricks.com/snippets/sass/advanced-type-checking/
+///
+/// @access public
+///
+/// @require {function} is-number
+/// @require {variable} relative-lengths
+///
+/// @return {bool}
+
+@function is-relative-length($value) {
+  @return is-number($value) and index($relative-lengths, unit($value)) != null;
+}

data/core/helpers/checks/_is-resolution.scss

@@ -0,0 +1,15 @@
+/// Checks to see if value ends with a type of resolution
+/// 
+/// @author Hugo Giraudel
+///
+/// @link https://css-tricks.com/snippets/sass/advanced-type-checking/
+///
+/// @access public
+///
+/// @require {function} is-number
+///
+/// @return {bool}
+
+@function is-resolution($value) {
+  @return is-number($value) and index('dpi' 'dpcm' 'dppx', unit($value)) != null;
+}

data/core/helpers/checks/_is-selector.scss

@@ -0,0 +1,3 @@
+@function is-selector($value) {
+  @return #{&} == #{html};
+}

data/core/helpers/checks/_is-string.scss

@@ -0,0 +1,11 @@
+/// Checks to see if value is a string
+/// 
+/// @author Mark Notton
+///
+/// @access public
+///
+/// @return {bool}
+
+@function is-string($value) {
+  @return type-of($value) == 'string';
+}

data/core/helpers/checks/_is-time.scss

@@ -0,0 +1,15 @@
+/// Checks to see if value ends with 's' or 'ms'
+/// 
+/// @author Hugo Giraudel
+///
+/// @link https://css-tricks.com/snippets/sass/advanced-type-checking/
+///
+/// @access public
+///
+/// @require {function} is-number
+///
+/// @return {bool}
+
+@function is-time($value) {
+  @return is-number($value) and index('ms' 's', unit($value)) != null;
+}

data/core/helpers/checks/_is-unit.scss

@@ -0,0 +1,16 @@
+/// Checks to see if value ends with any type of unit
+/// 
+/// @author Hugo Giraudel
+///
+/// @link https://css-tricks.com/snippets/sass/advanced-type-checking/
+///
+/// @access public
+///
+/// @require {function} is-relative-length
+/// @require {function} is-absolute-length
+///
+/// @return {bool}
+
+@function is-unit($value) {
+  @return unit($value) != '';
+}

data/core/helpers/private/_arglist-to-list.scss

@@ -0,0 +1,36 @@
+/// Casts a list of arguments into a single list of lists. 
+///
+/// @author Mark Notton
+///
+/// @access private
+///
+/// @argument {arglist} $values 
+///
+/// @example scss - Usage
+///   _arglist-to-list((foo bar), lorem ipsum, 1 2 3, red);
+///
+/// @example scss - Output
+///   ((foo bar) (lorem ipsum) (1 2 3) (red));
+///
+/// @return {list}
+
+@function _arglist-to-list($args...) {
+
+  $args: if(length($args) > 0, $args, null);
+
+  $lists : ();
+
+  @for $i from 1 through length($args) {
+
+    $setting : nth($args, $i);
+    @if is-arglist($setting) {
+      @each $set in $setting {
+        $lists : append($lists, $set);
+      }
+    } @else {
+      $lists : append($lists, $setting);
+    }
+  }
+
+  @return $lists;
+}

data/core/helpers/private/_brightness.scss

@@ -0,0 +1,13 @@
+/// Calculates a colours brightness
+///
+/// @author David Halford
+///
+/// @access private
+///
+/// @link http://codepen.io/davidhalford/pen/wlDxL?editors=1100
+///
+/// @return {number}
+
+@function _brightness($colour) {
+  @return abs(round((red($colour) * 299) + (green($colour) * 587) + (blue($colour) * 114) / 1000));
+}

data/core/helpers/private/_find-digits.scss

@@ -0,0 +1,41 @@
+/// Finding the digits part of a stringified number
+///
+/// @author Hugo Giraudel
+///
+/// @link https://github.com/HugoGiraudel/SassyCast
+///
+/// @access private
+///
+/// @param {string} $source - string source
+///
+/// @param {number} $pointer - current pointer
+///
+/// @return {list} - new pointer, parsed number
+
+@function helper-find-digits($source, $pointer) {
+  $source: to-lower-case($source);
+  $length: str-length($source);
+  $numbers: "0" "1" "2" "3" "4" "5" "6" "7" "8" "9";
+  $result: 0;
+  $runs: 1;
+
+  @while $pointer <= $length {
+    $token: str-slice($source, $pointer, $pointer);
+    $index: index($numbers, $token);
+
+    @if $token == "." {
+      // @continue;
+    }
+    @else if $index and $index > 0 {
+      $runs: $runs * 10;
+      $result: $result * 10 + ($index - 1);
+    }
+    @else {
+      @return $pointer, $result / $runs;
+    }
+
+    $pointer: $pointer + 1;
+  }
+
+  @return $pointer, $result / $runs;
+}

data/core/helpers/private/_find-integer.scss

@@ -0,0 +1,40 @@
+/// Finding the digits part of a stringified number
+///
+/// @author Hugo Giraudel
+///
+/// @link https://github.com/HugoGiraudel/SassyCast
+///
+/// @access private
+///
+/// @param {string} $source  - string source
+///
+/// @param {number} $pointer - current pointer
+///
+/// @return {list} new pointer, parsed number
+
+@function helper-find-integer($source, $pointer) {
+  $source: to-lower-case($source);
+  $length: str-length($source);
+  $numbers: "0" "1" "2" "3" "4" "5" "6" "7" "8" "9";
+  $result: 0;
+
+  @while $pointer <= $length {
+    $token: str-slice($source, $pointer, $pointer);
+    $index: index($numbers, $token);
+
+    @if $token == "-" {
+      // @continue;
+    }
+    @else if $index {
+      $result: $result * 10 + ($index - 1);
+    }
+    @else {
+      @return $pointer, $result;
+    }
+
+    $pointer: $pointer + 1;
+  }
+
+  @return $pointer, $result;
+}
+

data/core/helpers/private/_from-hex.scss

@@ -0,0 +1,48 @@
+/// Cast a string into a hexadecimal color
+///
+/// @author Hugo Giraudel
+///
+/// @link https://github.com/HugoGiraudel/SassyCast
+///
+/// @access private
+///
+/// @param {string} $string - string
+///
+/// @return {color | String} - string or hex color depending on the match
+///
+/// @require {function} _hex-to-dec
+
+@function helper-from-hex($string) {
+  $string-lower: to-lower-case($string);
+  $r: "";  $g: ""; $b: "";
+  $hex: "0" "1" "2" "3" "4" "5" "6" "7" "8" "9" "a" "b" "c" "d" "e" "f";
+  $length: str-length($string);
+  $max: if($length == 4, 1, 2);
+
+  // Check for length accuracy
+  @if $length != 4 and $length != 7 {
+    @return $string;
+  }
+
+  // Loop from the second character (omitting #)
+  @for $i from 2 through $length {
+    $c: str-slice($string-lower, $i, $i);
+
+    // If wrong character, return
+    @if not index($hex, $c) {
+      @return $string;
+    }
+
+    @if      str-length($r) < $max { $r: $r + $c }
+    @else if str-length($g) < $max { $g: $g + $c }
+    @else if str-length($b) < $max { $b: $b + $c }
+  }
+
+  @if $length == 4 {
+    $r: $r + $r;
+    $g: $g + $g;
+    $b: $b + $b;
+  }
+
+  @return rgb(_hex-to-dec($r), _hex-to-dec($g), _hex-to-dec($b));
+}

data/core/helpers/private/_from-hsl.scss

@@ -0,0 +1,55 @@
+/// Cast a string into a hsl color
+///
+/// @author Hugo Giraudel
+///
+/// @link https://github.com/HugoGiraudel/SassyCast
+///
+/// @access private
+///
+/// @param {string} $string - string
+///
+/// @return {color | String} - string or hsl color depending on the match
+///
+/// @require {function} _get-color-value
+
+@function helper-from-hsl($string) {
+  $frags: ();
+  $string-lower: to-lower-case($string);
+  $is-alpha: str-slice($string-lower, 4, 4) == 'a';
+  $length: str-length($string);
+  $start: str-index($string, "(");
+
+  @for $i from $start through $length {
+    $token: str-slice($string-lower, $i, $i);
+    @if $token == ' ' {
+      // @continue;
+    }
+    @else if $token == '(' or $token == ',' {
+      $frags: append($frags, "");
+    }
+    @else if $token == ')' {
+      @if length($frags) != if($is-alpha, 4, 3) { @return $string; } // Parsing error
+      $hue: _get-color-value(nth($frags, 1));
+      $saturation: _get-color-value(nth($frags, 2));
+      $lightness: _get-color-value(nth($frags, 3));
+
+      @if not $hue or not $saturation or not $lightness {
+        @return $string;
+      }
+
+      @if $is-alpha {
+        @if length($frags) != 4 { @return $string; } // No alpha channel found
+        $alpha: _get-color-value(nth($frags, 4));
+        @if not $alpha { @return $string; } // Error parsing alpha channel
+        @return hsla($hue, $saturation, $lightness, $alpha);
+      }
+
+      @return hsl($hue, $saturation, $lightness);
+    }
+    @else {
+      $frags: set-nth($frags, length($frags), nth($frags, length($frags)) + $token);
+    }
+  }
+
+  @return $string;
+}

data/core/helpers/private/_from-rgb.scss

@@ -0,0 +1,55 @@
+/// Cast a string into a rgb color
+///
+/// @author Hugo Giraudel
+///
+/// @link https://github.com/HugoGiraudel/SassyCast
+///
+/// @access private
+///
+/// @param {string} $string - string
+///
+/// @return {color | string} - string or rgb color depending on the match
+///
+/// @require {function} _get-color-value
+
+@function helper-from-rgb($string) {
+  $string-lower: to-lower-case($string);
+  $frags: ();
+  $is-alpha: str-slice($string-lower, 4, 4) == 'a';
+  $start: str-index($string, "(");
+  $length: str-length($string);
+
+  @for $i from $start through $length {
+    $token: str-slice($string-lower, $i, $i);
+    @if $token == ' ' {
+      // @continue;
+    }
+    @else if $token == '(' or $token == ',' {
+      $frags: append($frags, "");
+    }
+    @else if $token == ')' {
+      @if length($frags) != if($is-alpha, 4, 3) { @return $string; } // Parsing error
+      $red: _get-color-value(nth($frags, 1));
+      $green: _get-color-value(nth($frags, 2));
+      $blue: _get-color-value(nth($frags, 3));
+
+      @if not $red or not $green or not $blue {
+        @return $string;
+      }
+
+      @if $is-alpha {
+        @if length($frags) != 4 { @return $string; } // No alpha channel found
+        $alpha: _get-color-value(nth($frags, 4));
+        @if not $alpha { @return $string; } // Error parsing alpha channel
+        @return rgba($red, $green, $blue, $alpha);
+      }
+
+      @return rgb($red, $green, $blue);
+    }
+    @else {
+      $frags: set-nth($frags, length($frags), nth($frags, length($frags)) + $token);
+    }
+  }
+
+  @return $string;
+}

data/core/helpers/private/_get-color-value.scss

@@ -0,0 +1,26 @@
+/// Cast a stringified number / stringified percentage into number type
+///
+/// @author Hugo Giraudel
+///
+/// @link https://github.com/HugoGiraudel/SassyCast
+///
+/// @access private
+///
+/// @param {string} $string - string
+///
+/// @return {number} - unitless number or percentage
+///
+/// @require {function} to-number
+
+@function helper-get-color-value($string) {
+  $first: str-slice($string, 1, 1);
+
+  // Pad <1 values with a leading 0
+  @if $first == '.' {
+    $string: '0' + $string;
+  }
+
+  $last: str-slice($string, -1, -1);
+
+  @return if($last == '%', to-number(str-slice($string, 1, -2), 2) * 1%, to-number($string));
+}