doggystyle 0.1.0

data/core/functions/casts/_to-map.scss

@@ -0,0 +1,27 @@
+/// Convert to Map
+///
+/// @author Hugo Giraudel
+///
+/// @link https://github.com/HugoGiraudel/SassyCast
+///
+/// @access public
+///
+/// @param {*} $value - Value to cast
+///
+/// @return {map}
+
+@function to-map($value) {
+  @if type-of($value) == "list" {
+    $map: ();
+
+    @if length($value) > 1 {
+      @for $i from 1 through length($value) {
+        $map: map-merge($map, ($i: nth($value, $i)));
+      }
+    }
+
+    @return $map;
+  }
+
+  @return if(type-of($value) != map, (1: $value), $value);
+}

data/core/functions/casts/_to-null.scss

@@ -0,0 +1,15 @@
+/// Convert to Null
+///
+/// @author Hugo Giraudel
+///
+/// @link https://github.com/HugoGiraudel/SassyCast
+///
+/// @access public
+///
+/// @param {*} $value - Value to cast
+///
+/// @return {null}
+
+@function to-null($value) {
+  @return null;
+}

data/core/functions/casts/_to-number.scss

@@ -0,0 +1,66 @@
+/// Cast a value to a number if possible or return 0
+///
+/// @author Hugo Giraudel
+///
+/// @link https://github.com/HugoGiraudel/SassyCast
+///
+/// @access public
+///
+/// @param {string} $value
+///
+/// @return {number}
+
+@function to-number($value) {
+  // In case everything's good
+  @if type-of($value) == "number" {
+    @return $value;
+  }
+
+  // Boolean to number
+  @if $value == true  {
+    @return 1;
+  }
+
+  // Fail
+  @if type-of($value) != "string" {
+    @return 0;
+  }
+
+  // Trying to cast
+  $pointer: 1;
+  $result: 0;
+  $allowed: "-" "0" "1" "2" "3" "4" "5" "6" "7" "8" "9"; // Allowed characted to start with
+  $first: str-slice($value, $pointer, $pointer); // First character of the number
+  $minus: $first == "-"; // Is it negative?
+
+  // Early check for errors
+  @if not index($allowed, $first) {
+    // @warn "Could not cast `#{inspect($value)} into number.";
+    @return 0;
+  }
+
+  // Find the integer part
+  $find-integer: helper-find-integer($value, $pointer);
+  $pointer: nth($find-integer, 1);
+  $result:  nth($find-integer, 2);
+
+  // Find digits
+  @if str-slice($value, $pointer, $pointer) == "." {
+    $find-digits: helper-find-digits($value, $pointer);
+    $pointer: nth($find-digits, 1);
+    $digits:  nth($find-digits, 2);
+    $result: $result + $digits;
+  }
+
+  // In case of negative
+  @if $minus {
+    $result: $result * -1;
+  }
+
+  // In case of possible CSS unit
+  @if $pointer < str-length($value) {
+    $result: helper-length($result, str-slice($value, $pointer));
+  }
+
+  @return $result;
+}

data/core/functions/casts/_to-string.scss

@@ -0,0 +1,15 @@
+/// Convert to string
+///
+/// @author Hugo Giraudel
+///
+/// @link https://github.com/HugoGiraudel/SassyCast
+///
+/// @access public
+///
+/// @param {*} $value - value to cast
+///
+/// @return {string}
+
+@function to-string($value) {
+  @return if(type-of($value) != string, inspect($value), $value);
+}

data/core/functions/colours/_colour-contrast.scss

@@ -0,0 +1,61 @@
+/// Compares contrast of a given colour and returns the most appropriate given colour that contrasts it.
+///
+/// @author David Halford
+///
+/// @access public
+///
+/// @link http://codepen.io/davidhalford/pen/wlDxL?editors=1100
+///
+/// @param {color} $colour - Define a colour that you want to check is dark or light
+///
+/// @param {list | colour} - Define up to two seperate colours. Each one will be checked for their lightness or darkness
+///    If one of the colours is not dark enough it will revert to black;
+///    If the other colour is not light enough it will revert to white;
+///
+/// @require {function} is-colour
+/// @require {function} is-dark
+/// @require {function} is-light
+/// @require {function} _brightness
+/// @require {function} _lightness
+///
+/// @return {number}
+///
+/// @example {scss} - Usage
+///   color : colour-contrast(red, purple yellow);
+///
+/// @example {scss} - Output
+///   color : yellow;
+
+@function colour-contrast($colour, $text-colours:null) {
+
+  $dark-text : black;
+  $light-text : white;
+
+  @each $setting in $text-colours {
+    @if is-colour($setting) {
+      @if $dark-text == black {
+        $dark-text: $setting;
+      }
+      @elseif $light-text == white {
+        $light-text: $setting;
+      }
+    }
+  }
+
+  $dark-text : if(is-dark($dark-text), $dark-text, black);
+  $light-text : if(is-light($light-text), $light-text, white);
+  
+  @return if(_brightness($colour) <  _lightness(), $light-text, $dark-text);
+}
+
+/// @alias contrasting-colour
+///
+/// @access public
+/// 
+/// @require {function} contrasting-colour
+///
+/// @return {color}
+
+@function color-contrast($colour, $light:white, $dark:dark) {
+  @return colour-contrast($colour, $light, $dark);
+}

data/core/functions/colours/_colour.scss

@@ -0,0 +1,69 @@
+/// An alternative to the native rgba function. With a few extra checks.
+///
+/// @author Mark Notton
+///
+/// @access public
+///
+/// @param {list} $settings
+///   In any order and without comma delimination, add any of the follwing settings
+///   {color} - The first instance of a colour will be used
+///   {opacity} - The first instance of a number will be used as the opacity
+/// 
+/// @param {opacity} $opacity
+///   Perhaps a little over engineered, but if you mistype the function and set the opacity as a seperate 
+///   parameter rather than part of the settings list. This function will still work. 
+///
+/// @return {color}
+
+@function colour($settings:null, $opacity:null) { 
+
+  // Deafult settings
+  $colour  : random-colour();
+  $new-opacity : if($opacity == null, 1, $opacity);
+  
+  // Check Settings
+  @each $setting in $settings {
+    @if is-colour($setting) {
+      $colour : $setting;
+    }
+    @elseif is-number($setting) {
+      @if $opacity == null {
+        $new-opacity : strip($setting);
+      } @else {
+        $new-opacity : $opacity;
+      }
+    }
+  }
+
+  @if str-index(#{$colour}, 'rgba') {
+    @return $colour;
+  }
+  @else {
+    @return rgba($colour, $new-opacity);
+  }
+}
+
+/// @alias colour
+///
+/// @access public
+/// 
+/// @require {function} colour
+///
+/// @return {bool}
+
+@function color($settings:null, $opacity:null) {
+  @return colour($settings, $opacity);
+}
+
+
+/// @alias colour
+///
+/// @access public
+/// 
+/// @require {function} colour
+///
+/// @return {bool}
+
+@function col($settings:null, $opacity:null) {
+  @return colour($settings, $opacity);
+}

data/core/functions/colours/_random-colour.scss

@@ -0,0 +1,78 @@
+/// Random colour.
+///
+/// @author Pankaj Parashar
+///
+/// @access public
+///
+/// @author https://pankajparashar.com/posts/random-colors-sass/
+///
+/// @param {number} $opacity - Amend the opacity of the colour that is returned. Default is 1
+///
+/// @example scss - Usage
+///   random-colour(0.5);
+///
+/// @example css - Output
+///   rgba(38, 153, 180, 0.5);
+///
+/// @return {color}
+
+@function random-colour($opacity:1) {
+  @return rgba(random(256) - 1, random(256) - 1, random(256) - 1, $opacity);
+}
+
+
+/// @alias random-colour
+///
+/// @access public
+/// 
+/// @require {function} random-colour
+///
+/// @return {color}
+
+@function random-color($opacity:0.3) {
+  @return random-colour($opacity);
+}
+
+
+/// @alias random-colour
+///
+/// @access public
+/// 
+/// @require {function} random-colour
+///
+/// @return {color}
+
+@function rc($opacity:0.3) {
+  @return random-colour($opacity);
+}
+
+
+/// Random colours on a range of elements. Ideal for developers wanting to visually see elements quickly
+///
+/// @author Mark Notton
+///
+/// @access public
+///
+/// @param {number} $amount - How many items are there. Default is 10
+///
+/// @param {string} $target - Add any children elements you want to target
+///
+/// @param {number} $opacity - The opacity strength. Default is 0.5
+///
+/// @example scss - Usage
+///   li { random-colours(5, '.link'); }
+///
+/// @example css - Output
+///   li:nth-of-type(1) .link { background-color: rgba(166, 213, 186, 0.5); }
+///   li:nth-of-type(2) .link { background-color: rgba(118, 134, 177, 0.5); }
+///   li:nth-of-type(3) .link { background-color: rgba(223, 47, 35, 0.5); }
+///   li:nth-of-type(4) .link { background-color: rgba(175, 255, 1, 0.5); }
+///   li:nth-of-type(5) .link { background-color: rgba(100, 108, 80, 0.5); }
+///
+/// @return {*}
+
+@mixin random-colours($amount:10, $target:null, $opacity:0.5) {
+  @for $i from 1 through $amount {
+    &:nth-of-type(#{$i}) #{$target} { background-color:random-colour($opacity); }
+  }
+}

data/core/functions/lists/_contains.scss

@@ -0,0 +1,62 @@
+/// Checks to see if a given value exists within a list
+/// 
+/// @author Mark Notton
+///
+/// @access public
+/// 
+/// @param {list} $list - List to be crossed referenced to
+///
+/// @param {string | number | list} $values - These are the values that will be checked within the list from the first param.
+///   All list and value items will be cast to strings. Specificially useful is a list of numbers are compared
+///   to a list of stringed numbers for example.
+/// 
+/// @param {bool} $recursive - If a list is being cross referenced to another list, this function will
+///   return true if just one of the items are found. If $recursive is true, then this function will
+///   only return true if ALL the list values are found within the other list. 
+///
+/// @example scss - Usage
+///   $list1 : contains(a b c d, a);
+///   $list2 : contains(a b c d, a b);
+///   $list3 : contains(a b c d, a b f);
+///   $list4 : contains(a b c d, a b f, true);
+///
+/// @example scss - Output
+///   $list1 : true;
+///   $list2 : true;
+///   $list3 : true;
+///   $list4 : false;
+///
+/// @return {bool}
+@function contains($list, $values, $recursive:false) {
+
+  @if is-string($values) or is-number($values) or is-list($values) or $recursive {
+    // Convert all list and values items to strings.
+    $temp-list : _list-items-to-strings($list);
+    $temp-values : _list-items-to-strings($values);
+
+    @if $recursive {
+      
+      @if length($values) == length($list) {
+      
+        @each $value in $temp-values {
+          @if not index($temp-list, $value) {
+            @return false;
+          }         
+        }
+        @return true;
+      } @else {
+        @return false;
+      }
+
+    } @else {
+
+      @each $value in $temp-list {
+        @if index($temp-values, $value) {
+          @return true;
+        }
+      }
+
+      @return false;
+    }
+  }
+}

data/core/functions/lists/_first.scss

@@ -0,0 +1,19 @@
+/// Simple function for targeting the first 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 first($list) {
+  @if length($list) >= 1 {
+    @return nth($list, 1);
+  } @else {
+    @return null;
+  }
+}

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

@@ -0,0 +1,37 @@
+/// Insert a value at nth index in a list
+///
+/// @author Hugo Giraudel
+///
+/// @link http://hugogiraudel.com/2013/08/08/advanced-sass-list-functions/#adding-values-to-a-list
+///
+/// @access public
+
+@function insert-nth($list, $index, $value) {
+  $result: null;
+      
+  @if type-of($index) != number {
+    @warn "$index: #{quote($index)} is not a number for `insert-nth`.";
+  }
+
+  @else if $index < 1 {
+    @warn "List index 0 must be a non-zero integer for `insert-nth`";
+  }
+
+  @else if $index > length($list) {
+    @warn "List index is #{$index} but list is only #{length($list)} item long for `insert-nth'.";
+  }
+
+  @else { 
+    $result: ();
+        
+    @for $i from 1 through length($list) {
+      @if $i == $index {
+        $result: append($result, $value);
+      }
+
+      $result: append($result, nth($list, $i));
+    }
+  }
+
+  @return $result;
+}