SassyCast 1.0.0 → 1.1.0

data/stylesheets/{types → private}/color/helpers/_from-hex.scss

@@ -1,40 +1,42 @@
-// Cast a string into a hexadecimal color
-// --------------------------------------------------------------------------------
-// @param [string] $string: string
-// --------------------------------------------------------------------------------
-// @return [color|string] string or hex color depending on the match
-
-@function _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));
+/**
+ * Cast a string into a hexadecimal color
+ * ---
+ * @param {string} $string - string
+ * ---
+ * @return {color|string} - string or hex color depending on the match
+ */
+
+@function _sc-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/stylesheets/{types → private}/color/helpers/_from-hsl.scss

@@ -1,47 +1,49 @@
-// Cast a string into a hsl color
-// --------------------------------------------------------------------------------
-// @param [string] $string: string
-// --------------------------------------------------------------------------------
-// @return [color|string] string or hsl color depending on the match
-
-@function _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;
+/**
+ * Cast a string into a hsl color
+ * ---
+ * @param {string} $string - string
+ * ---
+ * @return {color|string} - string or hsl color depending on the match
+ */
+
+@function _sc-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/stylesheets/{types → private}/color/helpers/_from-rgb.scss

@@ -1,47 +1,49 @@
-// Cast a string into a rgb color
-// --------------------------------------------------------------------------------
-// @param [string] $string: string
-// --------------------------------------------------------------------------------
-// @return [color|string] string or rgb color depending on the match
-
-@function _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;
-}
+/**
+ * Cast a string into a rgb color
+ * ---
+ * @param {string} $string - string
+ * ---
+ * @return {color|string} - string or rgb color depending on the match
+ */
+
+@function _sc-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/stylesheets/private/color/helpers/_get-color-value.scss

@@ -0,0 +1,20 @@
+/**
+ * Cast a stringified number / stringified percentage into number type
+ * ---
+ * @param {string} $string: string
+ * ---
+ * @return {number} - unitless number or percentage
+ */
+
+@function _sc-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));
+}

data/stylesheets/private/color/helpers/_hex-to-dec.scss

@@ -0,0 +1,22 @@
+/**
+ * Convert an hexadecimal number to a decimal number
+ * ---
+ * @param {string} $string - hexadecimal value
+ * ---
+ * @return {number} - decimal number
+ */
+
+@function _sc-hex-to-dec($string){
+  $hex: "0" "1" "2" "3" "4" "5" "6" "7" "8" "9" "a" "b" "c" "d" "e" "f";
+  $string: to-lower-case($string);
+  $length: str-length($string);
+  
+  $dec: 0;
+  @for $i from 1 through $length {
+    $factor: 1 + ( 15 * ( $length - $i ));
+    $index: index($hex, str-slice($string, $i, $i));
+    $dec: $dec + $factor * ($index - 1);
+  }
+  
+  @return $dec;
+} 

data/stylesheets/{types → private}/list/_list.scss

@@ -1,30 +1,34 @@
-// Convert to list
-// --------------------------------------------------------------------------------
-// @param $value: value to cast
-// --------------------------------------------------------------------------------
-// @return [list]
-
-@function to-list($value, $keep: 'both') {
-  $keep: if(index('keys' 'values' 'both', $keep), $keep, 'both');
-  
-  @if type-of($value) == map {
-    $keys: ();
-    $values: ();
-    @each $key, $val in $value {
-      $keys: append($keys, $key);
-      $values: append($values, $val);
-    }
-
-    @if $keep == 'keys' {
-      @return $keys;
-    }
-    @else if $keep == 'values' {
-      @return $values;
-    }
-    @else {
-      @return zip($keys, $values);
-    }
-  }
-
-  @return if(type-of($value) != list, ($value,), $value);
+/**
+ * Convert to list
+ * ---
+ * @access private
+ * ---
+ * @param {*} $value - value to cast
+ * ---
+ * @return {list}
+ */
+
+@function _sc-to-list($value, $keep: 'both') {
+  $keep: if(index('keys' 'values' 'both', $keep), $keep, 'both');
+  
+  @if type-of($value) == map {
+    $keys: ();
+    $values: ();
+    @each $key, $val in $value {
+      $keys: append($keys, $key);
+      $values: append($values, $val);
+    }
+
+    @if $keep == 'keys' {
+      @return $keys;
+    }
+    @else if $keep == 'values' {
+      @return $values;
+    }
+    @else {
+      @return zip($keys, $values);
+    }
+  }
+
+  @return if(type-of($value) != list, ($value,), $value);
 }

data/stylesheets/private/map/_map.scss

@@ -0,0 +1,23 @@
+/**
+ * Convert to map
+ * ---
+ * @access private
+ * ---
+ * @param {*} $value - value to cast
+ * ---
+ * @return {map}
+ */
+
+@function _sc-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/stylesheets/private/null/_null.scss

@@ -0,0 +1,13 @@
+/**
+ * Convert to null
+ * ---
+ * @access private
+ * ---
+ * @param {*} $value - value to cast
+ * ---
+ * @return null
+ */
+
+@function _sc-to-null($value) {
+  @return null;
+}

data/stylesheets/{types → private}/number/_number.scss

@@ -1,67 +1,64 @@
-// Helpers
-
-@import "helpers/find-integer";
-@import "helpers/find-digits";
-@import "helpers/pow";
-@import "helpers/length";
-
-// Cast a value to a number if possible or return 0
-// --------------------------------------------------------------------------------
-// @param [string] $value: complete source
-// --------------------------------------------------------------------------------
-// @return [number] number (0 if cast failed)
-
-@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: _find-integer($value, $pointer);
-  $pointer: nth($find-integer, 1);
-  $result:  nth($find-integer, 2);
-
-  // Find digits
-  @if str-slice($value, $pointer, $pointer) == '.' {
-    $find-digits: _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: _length($result, str-slice($value, $pointer));
-  }
-
-  @return $result;
+/*
+ * Cast a value to a number if possible or return 0
+ * ---
+ * @access private
+ * ---
+ * @param {string} $value - complete source
+ * ---
+ * @return {number}
+ */
+
+@function _sc-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: _sc-find-integer($value, $pointer);
+  $pointer: nth($find-integer, 1);
+  $result:  nth($find-integer, 2);
+
+  // Find digits
+  @if str-slice($value, $pointer, $pointer) == '.' {
+    $find-digits: _sc-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: _sc-length($result, str-slice($value, $pointer));
+  }
+
+  @return $result;
 }