sugarcss 1.0.0

data/stylesheets/sugar/vendors/sassdash/api/_difference.scss

@@ -0,0 +1,50 @@
+@function __base-difference($list, $values) {
+    $result: ();
+
+    @each $item in $list {
+        @if not index($values, $item) {
+            $result: append($result, $item);
+        }
+    }
+
+    @return $result;
+}
+
+
+@function __difference($arguments...) {
+    $index: 1;
+    $length: length($arguments);
+    $value: null;
+
+    $break: false;
+    @while ($index <= $length and not $break) {
+        $value: nth($arguments, $index);
+
+        @if __is-list-like($value) {
+            $break: true;
+        } @else {
+            $index: $index + 1;
+        }
+    }
+
+    $values: __base-flatten($arguments, false, true, $index + 1);
+
+    @return __base-difference($value, $values);
+}
+
+
+/// Creates a list excluding all values of the provided lists.
+///
+///
+/// @access public
+/// @group List
+/// @param {List} $list The list to inspect.
+/// @param {List...} $values... The lists of values to exclude.
+/// @returns {List} Returns the new list of filtered values.
+/// @example scss
+/// $foo: _difference((1, 2, 3), (4, 2));
+/// // => (1, 3)
+
+@function _difference($args...) {
+    @return call('__difference', $args...);
+}

data/stylesheets/sugar/vendors/sassdash/api/_drop.scss

@@ -0,0 +1,226 @@
+@function __drop($list, $n: null, $guard: false) {
+    $length: if($list, length($list), 0);
+
+    @if ($length == 0) {
+        @return ();
+    }
+
+    @if (if($guard, __is-iteratee-call($list, $n, $guard), ($n == null))) {
+        $n: 1;
+    }
+
+    $n: if(__is-falsey($n), 0, if($n < 0, 0, min($n, length($list))));
+
+    @return __base-slice($list, $n);
+}
+
+
+@function __drop-right($list, $n: null, $guard: false) {
+    $length: if($list, length($list), 0);
+
+    @if ($length == 0) {
+        @return ();
+    }
+
+    @if (if($guard, __is-iteratee-call($list, $n, $guard), ($n == null))) {
+        $n: 1;
+    }
+
+    $n: $length - if(__is-number($n), $n, if(__is-falsey($n), 0, 1));
+
+    @return __base-slice($list, 0, if($n < 0, 0, $n));
+}
+
+
+@function __drop-right-while($list, $predicate: '__identity', $this-arg: null) {
+    $length: if($list, length($list), 0);
+
+    @if ($length == 0) {
+        @return ();
+    }
+
+    $predicate: __get-callback($predicate, $this-arg, 3);
+
+    @while ($length > 0
+    and __is-truthy(__exec($predicate, nth($list, $length), $length, $list))) {
+        $length: $length - 1;
+    }
+
+    @return __base-slice($list, 0, $length);
+}
+
+
+@function __drop-while($list, $predicate: '__identity', $this-arg: null) {
+    $length: if($list, length($list), 0);
+
+    @if ($length == 0) {
+        @return ();
+    }
+
+    $index: 1;
+
+    $predicate: __get-callback($predicate, $this-arg, 3);
+
+    @while ($index <= $length
+    and __is-truthy(__exec($predicate, nth($list, $index), $index, $list))) {
+        $index: $index + 1;
+    }
+
+    @return __base-slice($list, $index - 1);
+}
+
+
+/// Creates a slice of `$list` with `$n` elements dropped from the beginning.
+///
+///
+/// @access public
+/// @group List
+/// @param {List} $list The list to query.
+/// @param {number} $n [1] - The number of elements to drop.
+/// @returns {List} Returns the slice of `$list`.
+/// @example scss
+/// $foo: _drop((1, 2, 3));
+/// // => (2, 3)
+/// 
+/// $foo: _drop((1, 2, 3), 2);
+/// // => (3,)
+/// 
+/// $foo: _drop((1, 2, 3), 5);
+/// // => ()
+/// 
+/// $foo: _drop((1, 2, 3), 0);
+/// // => (1, 2, 3)
+
+@function _drop($args...) {
+    @return call('__drop', $args...);
+}
+
+
+/// Creates a slice of `$list` with `$n` elements dropped from the end.
+///
+///
+/// @access public
+/// @group List
+/// @param {List} $list The list to query.
+/// @param {number} $n [1] - The number of elements to drop.
+/// @returns {List} Returns the slice of `$list`.
+/// @example scss
+/// $foo: _drop-right((1, 2, 3));
+/// // => (1, 2)
+/// 
+/// $foo: _drop-right((1, 2, 3), 2);
+/// // => (1,)
+/// 
+/// $foo: _drop-right((1, 2, 3), 5);
+/// // => ()
+/// 
+/// $foo: _drop-right((1, 2, 3), 0);
+/// // => (1, 2, 3)
+
+@function _drop-right($args...) {
+    @return call('__drop-right', $args...);
+}
+
+
+/// Creates a slice of `$list` excluding elements dropped from the end.
+/// Elements are dropped until `$predicate` returns falsey. The predicate is
+/// bound to `$this-arg` and invoked with three arguments; (value, index, list).
+/// 
+/// If a property name is provided for `$predicate` the created `_property`
+/// style callback returns the property value of the given element.
+/// If a value is also provided for `$this-arg` the created `_matches-property`
+/// style callback returns `true` for elements that have a matching property
+/// value, else `false`.
+/// 
+/// If a map is provided for `$predicate` the created `_matches` style
+/// callback returns `true` for elements that match the properties of the given
+/// object, else `false`.
+///
+///
+/// @access public
+/// @group List
+/// @param {List} $list - The list to query.
+/// @param {Function|Map|String} $predicate [_identity] - The function invoked
+///  per iteration.
+/// @param {*} $this-arg [null] - The `_this` binding of `$predicate`.
+/// @returns {List} Returns the slice of `$list`.
+/// @example scss
+///     @function greater-than-two($value, $args...) {
+///         @return $value > 2;
+///     }
+///     
+///     $foo: _drop-right-while((1, 2, 3, 4), greater-than-two);
+///     // => (1, 2)
+///     
+///     $users: (
+///       ( 'user': 'barney',  'active': true ),
+///       ( 'user': 'fred',    'active': false ),
+///       ( 'user': 'pebbles', 'active': false )
+///     );
+///     
+///     // using the `_matches` callback shorthand
+///     $foo: _pluck(_drop-right-while($users, ( 'user': 'pebbles', 'active': false )), 'user');
+///     // => ('barney', 'fred')
+///     
+///     // using the `_matches-property` callback shorthand
+///     $foo: _pluck(_drop-right-while($users, 'active', false), 'user');
+///     // => ('barney')
+///     
+///     // using the `_property` callback shorthand
+///     $foo: _pluck(_drop-right-while($users, 'active'), 'user');
+///     // => ('barney', 'fred', 'pebbles')
+
+@function _drop-right-while($args...) {
+    @return call('__drop-right-while', $args...);
+}
+
+
+/// Creates a slice of `$list` excluding elements dropped from the beginning.
+/// Elements are dropped until `$predicate` returns falsey. The predicate is
+/// bound to `$this-arg` and invoked with three arguments; (value, index, list).
+/// If a property name is provided for `$predicate` the created `_property`
+/// style callback returns the property value of the given element.
+/// If a value is also provided for `$this-arg` the created `_matches-property`
+/// style callback returns `true` for elements that have a matching property
+/// value, else `false`.
+/// If a map is provided for `$predicate` the created `_matches` style
+/// callback returns `true` for elements that have the properties of the given
+/// object, else `false`.
+///
+///
+/// @access public
+/// @group List
+/// @param {List} $list - The list to query.
+/// @param {Function|Map|String} $predicate [_identity] - The function invoked
+///  per iteration.
+/// @param {*} $this-arg [null] - The `_this` binding of `$predicate`.
+/// @returns {List} Returns the slice of `$list`.
+/// @example scss
+///     @function less-than-three($value, $args...) {
+///         @return $value < 3;
+///     }
+///     
+///     $foo: _drop-while((1, 2, 3, 4), less-than-three);
+///     // => (3, 4)
+///     
+///     $users: (
+///       ( 'user': 'barney',  'active': false ),
+///       ( 'user': 'fred',    'active': false ),
+///       ( 'user': 'pebbles', 'active': true )
+///     );
+///     
+///     // using the `_matches` callback shorthand
+///     $foo: _pluck(_drop-while($users, ( 'user': 'barney', 'active': false )), 'user');
+///     // => ('fred', 'pebbles')
+///     
+///     // using the `_matches-property` callback shorthand
+///     $foo: _pluck(_drop-while($users, 'active', false), 'user');
+///     // => ('pebbles')
+///     
+///     // using the `_property` callback shorthand
+///     $foo: _pluck(_drop-while($users, 'active'), 'user');
+///     // => ('barney', 'fred', 'pebbles')
+
+@function _drop-while($args...) {
+    @return call('__drop-while', $args...);
+}

data/stylesheets/sugar/vendors/sassdash/api/_either.scss

@@ -0,0 +1,42 @@
+@function __either($this, $that: null, $predicate: '__is-truthy') {
+    $this-bool: __exec(__base-callback($predicate), $this);
+
+    @return if($this-bool, $this, $that);
+}
+
+/// Returns initial `$this` value unless the `$predicate` applied to 
+/// `$this` is falsey; in which case, `$that` is returned.
+/// 
+/// The `$predicate` argument can be any type of supported Sassdash
+/// callback.
+/// 
+/// @access public
+/// @group Utility
+/// @param {*} $this - The target preferred value
+/// @param {*} $that [null] - The fallback value, in case `$this` is falsey.
+/// @param {Function} $predicate ['is-truthy'] - The predicate to 
+/// check `$this` against 
+/// @returns {*} `$this` or `$that`
+/// @example scss
+/// $button-bg-color: false;
+/// 
+/// $foo: _either($button-bg-color, #C0FFEE);
+/// // => #C0FFEE
+/// 
+/// $foo: _either($button-bg-color, #C0FFEE, _is-color);
+/// // => #C0FFEE
+/// 
+/// $button-bg-color: green;
+/// 
+/// $foo: _either($button-bg-color, #C0FFEE);
+/// // => green
+/// 
+/// // Usage with "shifted argument" callback
+/// $foo: _either('abcde', 'xyz', str-index 'abc');
+/// // => 'abcde'
+/// 
+/// $foo: _either('hijkl', 'xyz', str-index 'abc');
+/// // => 'xyz'
+@function _either($args...) {
+    @return call('__either', $args...);
+}

data/stylesheets/sugar/vendors/sassdash/api/_encode.scss

@@ -0,0 +1,42 @@
+
+
+@function __encode-uri-char($char, $args...) {
+  $char-code: _char-code($char);
+
+  @if not $char-code {
+    @return $char;
+  }
+
+  @if (($char-code >= 48 and $char-code <= 57)
+    or ($char-code >= 65 and $char-code <= 90)
+    or ($char-code >= 97 and $char-code <= 122)) {
+    @return $char;
+  }
+
+  @return unquote("%#{str-slice(ie-hex-str(rgb($char-code,0,0)),4,5)}");
+}
+
+
+@function __encode($string, $args...) {
+  @return _($string,
+    _map __encode-uri-char,
+    _join);
+}
+
+
+/// Converts a `$string` to a URL encoding representation by converting
+/// certain characters to their 2-digit hexadecimal equivalent,
+/// preceded by a "%" sign.
+/// 
+/// @access public
+/// @group String
+/// @param {String} $string The string to encode.
+/// @returns {String} Returns the encoded string.
+/// 
+/// @example scss
+/// $foo: _encode('Hello world');
+/// // => 'Hello%20world'
+
+@function _encode($args...) {
+  @return call('__encode', $args...);
+}

data/stylesheets/sugar/vendors/sassdash/api/_ends-with.scss

@@ -0,0 +1,76 @@
+@function __ends-with($string, $target: $__undefined__, $position: str-length($string)) {
+    @if __is-undefined($target) {
+        @return false;
+    }
+
+    $string: __base-to-string($string);
+    $target: __base-to-string($target);
+    $length: str-length($string);
+    $position: if(__is-falsey($position), 0, $position);
+    $position: min(if($position < 0, 0, $position), $length) + 1 - str-length($target);
+
+    @return if($position >= 1,
+        __string-index-of($string, $target, $position) == $position,
+        false);
+}
+
+@function __ends-with-any($string, $targets: (), $position: str-length($string)) {
+    $result: false;
+    $index: 1;
+
+    @while $index <= length($targets) and not $result {
+        $target-string: nth($targets, $index);
+        $result: __ends-with($string, $target-string, $position);
+
+        $index: $index + 1;
+    }
+
+    @return $result;
+}
+
+
+/// Checks if `$string` ends with the given target string.
+///
+///
+/// @access public
+/// @group String
+/// @param {string} $string [''] - The string to search.
+/// @param {string} $target - The string to search for.
+/// @param {number} $position [str-length($string)] - The position to search from.
+/// @returns {boolean} Returns `true` if `$string` ends with `$target`, else `false`.
+/// @example scss
+/// $foo: _ends-with('abc', 'c');
+/// // => true
+/// 
+/// $foo: _ends-with('abc', 'b');
+/// // => false
+/// 
+/// $foo: _ends-with('abc', 'b', 2);
+/// // => true
+
+@function _ends-with($args...) {
+    @return call('__ends-with', $args...);
+}
+
+/// Checks if `$string` ends with any of the strings in `$targets` list.
+///
+///
+/// @access public
+/// @group String
+/// @param {string} $string [''] - The string to search.
+/// @param {string} $targets [()] - The list of strings to search for.
+/// @param {number} $position [str-length($string)] - The position to search from.
+/// @returns {boolean} Returns `true` if `$string` ends with any of the strings in `$targets`, else `false`.
+/// @example scss
+/// $foo: _ends-with-any('abc', 'a' 'c');
+/// // => true
+/// 
+/// $foo: _ends-with-any('abc', 'a' 'b');
+/// // => false
+/// 
+/// $foo: _ends-with-any('abc', 'a' 'b', 2);
+/// // => true
+
+@function _ends-with-any($args...) {
+    @return call('__ends-with-any', $args...);
+}

data/stylesheets/sugar/vendors/sassdash/api/_escape.scss

@@ -0,0 +1,39 @@
+@function __escape-string-char($char) {
+    @return '\\#{__const('string-escapes' $char)}';
+}
+
+
+@function __escape-html-char($char) {
+    $escaped-char: __const('html-escapes' $char);
+
+    @return if($escaped-char, $escaped-char, $char);
+}
+
+
+@function __escape($string) {
+    $string: __base-to-string($string);
+
+    @each $unescaped, $escaped in __const('html-escapes') {
+        $string: __string-replace($string, $unescaped, $escaped);
+    }
+
+    @return $string;
+}
+
+
+/// Converts the characters "&", "<", ">", '"', "'", and '`', in `$string` to
+/// their corresponding HTML entities.
+/// **Note:** No other characters are escaped.
+///
+///
+/// @access public
+/// @group String
+/// @param {string} $string [''] - The string to escape.
+/// @returns {string} Returns the escaped string.
+/// @example scss
+/// $foo: _escape('fred, barney, & pebbles');
+/// // => 'fred, barney, &amp; pebbles'
+
+@function _escape($args...) {
+    @return call('__escape', $args...);
+}

data/stylesheets/sugar/vendors/sassdash/api/_every.scss

@@ -0,0 +1,106 @@
+@function __base-every-iteratee($value, $index, $collection) {
+    $predicate: __this('predicate');
+    $result: if(__is-truthy(__exec($predicate, $value, $index, $collection)), true, false);
+    $_: __this('result', $result);
+
+    @return null;
+}
+
+
+@function __base-every($collection, $predicate) {
+    $_: __scope((
+        'result': true,
+        'predicate': $predicate
+    ));
+    $_: __base-each($collection, '__base-every-iteratee');
+    $result: __this('result');
+    $_: __scope(false);
+
+    @return if($result, true, false);
+}
+
+
+@function __list-every($list, $predicate) {
+    $index: 1;
+    $length: length($list);
+
+    @while ($index <= $length) {
+        $iteration: __exec($predicate, nth($list, $index), $index, $list);
+
+        @if (not __is-truthy($iteration)) {
+            @return false;
+        }
+
+        $index: $index + 1;
+    }
+
+    @return true;
+}
+
+
+@function __every($collection, $predicate: '__identity', $this-arg: $__undefined__) {
+    $function: if(__is-list($collection), '__list-every', '__base-every');
+
+    @if not __function-exists($predicate)
+        or not __is-undefined($this-arg) {
+        $predicate: __get-callback($predicate, $this-arg, 3);
+    }
+
+    @return __exec($function, $collection, $predicate);
+}
+
+
+/// Checks if `$predicate` returns truthy for **all** elements of `$collection`.
+/// The predicate is bound to `$this-arg` and invoked with three arguments:
+/// (value, index|key, collection).
+/// 
+/// If a property name is provided for `$predicate` the created `_property`
+/// style callback returns the property value of the given element.
+/// 
+/// If a value is also provided for `$this-arg` the created `_matches-property`
+/// style callback returns `true` for elements that have a matching property
+/// value, else `false`.
+/// 
+/// If a map is provided for `$predicate` the created `_matches` style
+/// callback returns `true` for elements that have the properties of the given
+/// object, else `false`.
+///
+///
+/// @access public
+/// @group Collection
+/// @param {List|Map|string} $collection The collection to iterate over.
+/// @param {Function|Map|string} $predicate [_identity] - The function invoked
+///  per iteration.
+/// @param {*} $this-arg [null] - The `_this` binding of `$predicate`.
+/// @returns {boolean} Returns `true` if all elements pass the predicate check,
+///  else `false`.
+/// @example scss
+/// $foo: _every((true, 1, null, 'yes'), _is-boolean);
+/// // => false
+/// 
+/// $users: (
+///   ( 'user': 'barney', 'active': false ),
+///   ( 'user': 'fred',   'active': false )
+/// );
+/// 
+/// // using the `_matches` callback shorthand
+/// $foo: _every($users, ( 'user': 'barney', 'active': false ));
+/// // => false
+/// 
+/// // using the `_matches-property` callback shorthand
+/// $foo: _every($users, 'active', false);
+/// // => true
+/// 
+/// // using the `_property` callback shorthand
+/// $foo: _every($users, 'active');
+/// // => false
+
+@function _every($args...) {
+    @return call('__every', $args...);
+}
+
+/// @alias _every
+
+@function _all($args...) {
+    @return call('__every', $args...);
+}

data/stylesheets/sugar/vendors/sassdash/api/_exec.scss

@@ -0,0 +1,31 @@
+@function __exec($function, $args...) {
+  @if function-exists($function) {
+    @return call($function, $args...);
+  }
+  
+  @return __call($function, null, $args...);
+}
+
+/// Dynamically calls a standard Sass function, similar to 
+/// `call($function, $args...)`, with the ability to call scoped 
+/// functions, such as those returned from Sassdash functions like
+/// `_bind()`, `_callback()`, etc., that otherwise can't be called via `call()`.
+/// 
+/// @access public
+/// @group Function
+/// @param {Function} $function - The function/Sassdash callback to call.
+/// @param {Any...} $args... - The arguments to apply to the function.
+/// @returns {*} Returns the result of calling `$function` with the given `$args...`.
+/// @example scss
+/// $is-primary: _callback(('color': $color-primary));
+/// 
+/// $theme: (
+///     'name': 'sassdash-theme',
+///     'color': $color-primary
+/// );
+/// 
+/// $foo: _exec($is-primary, $theme);
+/// // => true
+@function _exec($args...) {
+    @return call('__exec', $args...);
+}