doggystyle 0.1.0

data/core/helpers/_warnings.scss

@@ -0,0 +1,3 @@
+@mixin warning($warning) {
+  @if $warnings { @warn "#{$warning}"; }
+}

data/core/helpers/checks/_check.scss

@@ -0,0 +1,69 @@
+/// If a value does not exist or is invalid, revert to a fallback value
+///
+/// @author Mark Notton
+///
+/// @access public
+///
+/// @param {*} $unit - The unit you want to check exists and is valid. Normally an nth list item or variable.
+///
+/// @param {*} $fallback - If the first parameter doesn't exist or isn't valid, revert back to this fallback
+///
+/// @param {string} $check - Check for a certain type of condition. Default is number.
+///   Accepted check types : angel, duration, false, frequency, integer, length, number, percentage, position, pseudo, sudo, resolution, time
+///
+/// @require {function} is-absolute-length
+/// @require {function} is-angel
+/// @require {function} is-bool
+/// @require {function} is-colour
+/// @require {function} is-duration
+/// @require {function} is-false
+/// @require {function} is-frequency
+/// @require {function} is-integer
+/// @require {function} is-length
+/// @require {function} is-list
+/// @require {function} is-map
+/// @require {function} is-null
+/// @require {function} is-number
+/// @require {function} is-percentage
+/// @require {function} is-position
+/// @require {function} is-pseudo
+/// @require {function} is-relative-length
+/// @require {function} is-resolution
+/// @require {function} is-string
+/// @require {function} is-time
+/// @require {variable} warnings
+///
+/// @return {*}
+
+@function check($value, $fallback, $check:number) {
+  @if index(angel duration false frequency integer length number percentage position pseudo sudo resolution time string bool boolean colour color list map null, $check) {
+    @if $check == angel     and is-angel($value)
+    or $check == duration   and is-duration($value)
+    or $check == false      and is-false($value)
+    or $check == frequency  and is-frequency($value)
+    or $check == integer    and is-integer($value)
+    or $check == length     and is-length($value)
+    or $check == number     and is-number($value)
+    or $check == percentage and is-percentage($value)
+    or $check == position   and is-position($value)
+    or $check == pseudo     and is-pseudo($value)
+    or $check == sudo       and is-sudo($value)
+    or $check == resolution and is-resolution($value)
+    or $check == string     and is-string($value)
+    or $check == bool       and is-bool($value) 
+    or $check == boolean    and is-boolean($value) 
+    or $check == color      and is-color($value) 
+    or $check == colour     and is-colour($value) 
+    or $check == list       and is-list($value) 
+    or $check == map        and is-map($value) 
+    or $check == null       and is-null($value) {
+      @return $value;
+    } @else {
+      @return $fallback;
+    }
+  } @else {
+    @if $warnings { @warn "#{$check} is not a valid type check. Returning the initial value: #{$value}"; }
+    @return $value;
+  }
+}
+

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

@@ -0,0 +1,25 @@
+/// List of all absolute length unit types
+/// 
+/// @link http://www.w3schools.com/cssref/css_units.asp
+///
+/// @type list
+
+$absolute-lengths : cm mm in px pt pc;
+
+
+/// Checks to see if value is a type of unit that can't 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} $abolute-lengths
+///
+/// @return {bool}
+
+@function is-absolute-length($value) {
+  @return is-number($value) and index($absolute-lengths, unit($value)) != null;
+}

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

@@ -0,0 +1,25 @@
+/// List of all angel unit types
+/// 
+/// @link http://www.w3schools.com/cssref/css_units.asp
+///
+/// @type list
+
+$angel-types : deg rad grad turn;
+
+
+/// Checks to see if value ends with an angle
+/// 
+/// @author Hugo Giraudel
+///
+/// @link https://css-tricks.com/snippets/sass/advanced-type-checking/
+///
+/// @access public
+///
+/// @require {function} is-number
+/// @require {variable} angel-types
+///
+/// @return {bool}
+
+@function is-angle($value) {
+  @return is-number($value) and index($angel-types, unit($value)) != null;
+}

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

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

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

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

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

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

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

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

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

@@ -0,0 +1,14 @@
+/// Checks to see if a colour is dark 
+/// 
+/// @author Mark Notton
+///
+/// @access public
+///
+/// @require {function} _brightness
+/// @require {function} _lightness
+///
+/// @return {bool}
+
+@function is-dark($colour) {
+  @return _brightness($colour) < _lightness();
+}

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

@@ -0,0 +1,15 @@
+/// Checks to see if value is a number
+/// 
+/// @author Hugo Giraudel
+///
+/// @link https://css-tricks.com/snippets/sass/advanced-type-checking/
+///
+/// @access public
+///
+/// @require {function} is-time
+///
+/// @return {bool}
+
+@function is-duration($value) {
+  @return is-time($value);
+}

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

@@ -0,0 +1,13 @@
+/// Checks to see if value is any type of false
+/// 
+/// @author Probably Hugo Giraudel
+///
+/// @todo Find and reference original author
+///
+/// @access public
+///
+/// @return {bool}
+
+@function is-false($value) {
+  @return not not index(false null 0 off def, $value);
+}

data/core/helpers/checks/_is-first-character.scss

@@ -0,0 +1,11 @@
+/// Compare the first character of a string
+/// 
+/// @author Mark Notton
+///
+/// @access public
+///
+/// @return {bool}
+
+@function is-first-character($string, $character) {
+  @return str-slice(#{$string}, 1, 1) == #{$character};
+}

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

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

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

@@ -0,0 +1,44 @@
+/// Designed to check for special function types. For example, filters or transforms: rotate(45deg)
+/// 
+/// @author Mark Notton
+///
+/// @access public
+///
+/// @require {function} to-number
+/// @require {function} is-string
+/// @require {function} string-explode
+///
+/// @example scss - Usage
+///   @debug is-function(rotate(45deg));
+///   @debug is-function(transform);
+///
+/// @example scss - Output
+///   (rotate, 45deg)
+///   false
+///
+/// @return {bool | list} If value is not a string or does not fit the 'function' syntax, return false. 
+/// Otherwise, return a list with the 'function' name and the 'value' that was passed.
+
+@function is-function($value) {
+  
+  $values : ();
+
+  @if is-string($value) {
+    $first-brace : str-index($value, '(');
+    $last-brace : str-index($value, ')');
+    @if $first-brace and $last-brace {
+      $function : str-slice($value, 1, $first-brace - 1);;
+      $value : str-slice($value, $first-brace + 1, $last-brace - 1);
+      // If a number was passed, it would be returned back as a string. This converts it to a number, unless it's not really a number.
+      $value : _string-explode($value);
+      @each $val in $value {
+        $values : append($values, if(to-number($val) != 0, to-number($val), $val), comma);
+      }
+      @return ($function $values);
+    } @else {      
+      @return false;
+    }
+  } @else {
+    @return false;
+  } 
+}

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

@@ -0,0 +1,15 @@
+/// Checks to see if value is a rounded number 
+/// 
+/// @author Hugo Giraudel
+///
+/// @link https://css-tricks.com/snippets/sass/advanced-type-checking/
+///
+/// @access public
+///
+/// @require {function} is-number
+///
+/// @return {bool}
+
+@function is-integer($value) {
+  @return is-number($value) and round($value) == $value;
+}

data/core/helpers/checks/_is-length.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-length($value) {
+  @return is-relative-length($value) or is-absolute-length($value);
+}

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

@@ -0,0 +1,14 @@
+/// Checks to see if a colour is light 
+/// 
+/// @author Mark Notton
+///
+/// @access public
+///
+/// @require {function} _brightness
+/// @require {function} _lightness
+///
+/// @return {bool}
+
+@function is-light($colour) {
+  @return _brightness($colour) > _lightness();
+}

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

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

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

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

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

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

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

@@ -0,0 +1,19 @@
+/// Checks to see if value is a number. This includes units (except for calc)
+/// 
+/// @author Hugo Giraudel
+///
+/// @link https://css-tricks.com/snippets/sass/advanced-type-checking/
+///
+/// @access public
+///
+/// @return {bool}
+
+@function is-number($value) {
+  @return type-of($value) == 'number';
+  // @each $number in $value {
+  //   @if type-of($number) != 'number' {
+  //     @return false;
+  //   }
+  // } 
+  // @return true;
+}

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

@@ -0,0 +1,13 @@
+/// Checks to see if value is a percentage
+/// 
+/// @author Hugo Giraudel
+///
+/// @link https://css-tricks.com/snippets/sass/advanced-type-checking/
+///
+/// @access public
+///
+/// @return {bool}
+
+@function is-percentage($value) {
+  @return is-number($value) and unit($value) == '%';
+}