sugarcss 1.0.0

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

@@ -0,0 +1,211 @@
+@function __take($list, $n: 1, $guard: null) {
+    $length: if($list, length($list), 0);
+
+    @if __is-falsey($length) {
+        @return ();
+    }
+
+    @if if($guard, __is-iteratee-call($list, $n, $guard), $n == null) {
+        $n: 1;
+    }
+
+    $n: if(__is-number($n), $n, if(__is-truthy($n), 1, 0));
+
+    @return __base-slice($list, 0, if($n < 0, 0, $n));
+}
+
+
+@function __take-right($list, $n: 1, $guard: null) {
+    $length: if($list, length($list), 0);
+
+    @if __is-falsey($length) {
+        @return ();
+    }
+
+    @if if($guard, __is-iteratee-call($list, $n, $guard), $n == null) {
+        $n: 1;
+    }
+
+    $n: $length - if(__is-number($n), $n, if(__is-truthy($n), 1, 0));
+
+    @return __base-slice($list, if($n < 0, 0, $n));
+}
+
+
+@function __take-right-while($list, $predicate: '__identity', $this-arg: null) {
+    $length: if($list, length($list), 0);
+
+    @if __is-falsey($length) {
+        @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, $length);
+}
+
+
+@function __take-while($list, $predicate: '__identity', $this-arg: null) {
+    $length: if($list, length($list), 0);
+
+    @if __is-falsey($length) {
+        @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, 0, $index - 1);
+}
+
+
+/// Creates a slice of `$list` with `$n` elements taken from the beginning.
+///
+///
+/// @access public
+/// @group List
+/// @param {List} $list The list to query.
+/// @param {number} $n [1] - The number of elements to take.
+/// @returns {List} Returns the slice of `$list`.
+/// @example scss
+/// $foo: _take((1, 2, 3));
+/// // => (1,)
+/// $foo: _take((1, 2, 3), 2);
+/// // => (1, 2)
+/// $foo: _take((1, 2, 3), 5);
+/// // => (1, 2, 3)
+/// $foo: _take((1, 2, 3), 0);
+/// // => ()
+
+@function _take($args...) {
+    @return call('__take', $args...);
+}
+
+
+/// Creates a slice of `$list` with `$n` elements taken from the end.
+///
+///
+/// @access public
+/// @group List
+/// @param {List} $list The list to query.
+/// @param {number} $n [1] - The number of elements to take.
+/// @returns {List} Returns the slice of `$list`.
+/// @example scss
+/// $foo: _take-right((1, 2, 3));
+/// // => (3,)
+/// $foo: _take-right((1, 2, 3), 2);
+/// // => (2, 3)
+/// $foo: _take-right((1, 2, 3), 5);
+/// // => (1, 2, 3)
+/// $foo: _take-right((1, 2, 3), 0);
+/// // => ()
+
+@function _take-right($args...) {
+    @return call('__take-right', $args...);
+}
+
+
+/// Creates a slice of `$list` with elements taken from the end. Elements are
+/// taken 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
+/// $users: (
+///   ( 'user': 'barney',  'active': true ),
+///   ( 'user': 'fred',    'active': false ),
+///   ( 'user': 'pebbles', 'active': false )
+/// );
+/// 
+/// // using the `_matches` callback shorthand
+/// $foo: _pluck(_take-right-while($users, ( 'user': 'pebbles', 'active': false )), 'user');
+/// // => ('pebbles',)
+/// 
+/// // using the `_matches-property` callback shorthand
+/// $foo: _pluck(_take-right-while($users, 'active', false), 'user');
+/// // => ('fred', 'pebbles')
+/// 
+/// // using the `_property` callback shorthand
+/// $foo: _pluck(_take-right-while($users, 'active'), 'user');
+/// // => ()
+
+@function _take-right-while($args...) {
+    @return call('__take-right-while', $args...);
+}
+
+
+/// Creates a slice of `$list` with elements taken from the beginning. Elements
+/// are taken 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
+/// $users: (
+///   ( 'user': 'barney',  'active': false ),
+///   ( 'user': 'fred',    'active': false ),
+///   ( 'user': 'pebbles', 'active': true )
+/// );
+/// // using the `_matches` callback shorthand
+/// $foo: _pluck(_take-while($users, ( 'user': 'barney', 'active': false )), 'user');
+/// // => ('barney',)
+/// 
+/// // using the `_matches-property` callback shorthand
+/// $foo: _pluck(_take-while($users, 'active', false), 'user');
+/// // => ('barney', 'fred')
+/// 
+/// // using the `_property` callback shorthand
+/// $foo: _pluck(_take-while($users, 'active'), 'user');
+/// // => ()
+
+@function _take-while($args...) {
+    @return call('__take-while', $args...);
+}

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

@@ -0,0 +1,33 @@
+@function __times($n: null, $iteratee: '__identity', $this-arg: null) {
+    $n: if(__is-falsey($n), 0, $n);
+    $index: 1;
+    $result: ();
+    $iteratee: __bind-callback($iteratee, $this-arg, 1);
+
+    @while $index <= $n {
+        $result: append($result, __exec($iteratee, $index));
+        $index: $index + 1;
+    }
+
+    @return $result;
+}
+
+
+/// Invokes the iteratee function `$n` times, returning a list of the results
+/// of each invocation. The `$iteratee` is bound to `$this-arg` and invoked with
+/// one argument; (index).
+///
+///
+/// @access public
+/// @group Utility
+/// @param {number} $n [0] - The number of times to invoke `$iteratee`.
+/// @param {Function} $iteratee [_identity] - The function invoked per iteration.
+/// @param {*} $this-arg [null] - The `_this` binding of `$iteratee`.
+/// @returns {List} Returns the list of results.
+/// @example scss
+/// $dice-rolls: _times(3, _partial(_random, 1, 6, false));
+/// // => (3, 6, 4)
+
+@function _times($args...) {
+    @return call('__times', $args...);
+}

data/stylesheets/sugar/vendors/sassdash/api/_to-list.scss

@@ -0,0 +1,52 @@
+@function __to-list($value) {
+    $result: ();
+
+    @if __is-map($value) {
+        @if __list-some(map-keys($value), __is-string) {
+            @return map-values($value);
+        }
+
+        @for $index from 1 through max(map-keys($value)...) {
+            $map-value: __get($value, $index);
+            $result: append($result, $map-value);
+        }
+
+        @return $result;
+    }
+
+    @if __is-string($value) {
+        @if str-length($value) >= 1 {
+            @for $index from 1 through str-length($value) {
+                $result: append($result, unquote(str-slice($value, $index, $index)));
+            }
+        }
+
+        @return $result;
+    }
+
+    @if __is-list-like($value) {
+        @each $item in $value {
+            $result: append($result, $item);
+        }
+    }
+
+    @return $result;
+}
+
+
+/// Converts `$value` to a list.
+///
+///
+/// @access public
+/// @group Lang
+/// @param {*} $value The value to convert.
+/// @returns {List} Returns the converted list.
+/// @example scss
+/// $map: ('a': 1, 'b': 2, 'c': 3);
+/// 
+/// $foo: _to-list($map);
+/// // => 1, 2, 3
+
+@function _to-list($args...) {
+    @return call('__to-list', $args...);
+}

data/stylesheets/sugar/vendors/sassdash/api/_to-string.scss

@@ -0,0 +1,35 @@
+@function __base-to-string($value) {
+    @if __is-string($value) {
+        @return $value;
+    }
+
+    @return if($value == null, '', $value + '');
+}
+
+
+@function __to-string($value, $args...) {
+    @if __is-string($value) {
+        @return $value;
+    }
+
+    @if $value == null {
+        @return '';
+    }
+
+    @return inspect($value);
+}
+
+
+/// Converts `$value` to a string.
+/// 
+/// @access public
+/// @group Lang
+/// @param {*} $value The value to convert.
+/// @returns {String} Returns the converted string.
+/// @example scss
+/// $foo: _to-string(123);
+/// // => '123'
+
+@function _to-string($args...) {
+    @return call('__to-string', $args...);
+}

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

@@ -0,0 +1,138 @@
+@function __trimmed-left-index($string) {
+    $index: 1;
+    $length: str-length($string);
+
+    @while ($index <= $length) and (__is-space(__char-at($string, $index))) {
+        $index: $index + 1;
+    }
+
+    @return $index;
+}
+
+
+@function __trimmed-right-index($string) {
+    $index: str-length($string);
+
+    @while ($index > 0) and (__is-space(__char-at($string, $index))) {
+        $index: $index - 1;
+    }
+
+    @return $index;
+}
+
+
+@function __trim($string, $chars: null, $guard: null) {
+    $value: $string;
+    $string: __base-to-string($string);
+
+    @if not ($string) or ($string == '') or ($chars == '') {
+        @return $string;
+    }
+
+    @if (if($guard, __is-iteratee-call($value, $chars, $guard), ($chars == null))) {
+        @return str-slice($string, __trimmed-left-index($string), __trimmed-right-index($string));
+    }
+
+    $chars: __base-to-string($chars);
+
+    @return str-slice($string,
+        __chars-left-index($string, $chars),
+        __chars-right-index($string, $chars));
+}
+
+
+@function __trim-left($string, $chars: null, $guard: null) {
+    $value: $string;
+    $string: __base-to-string($string);
+
+    @if not ($string) or ($string == '') or ($chars == '') {
+        @return $string;
+    }
+
+    @if (if($guard, __is-iteratee-call($value, $chars, $guard), ($chars == null))) {
+        @return str-slice($string, __trimmed-left-index($string));
+    }
+
+    $chars: __base-to-string($chars);
+
+    @return str-slice($string,
+        __chars-left-index($string, $chars));
+}
+
+
+@function __trim-right($string, $chars: null, $guard: null) {
+    $value: $string;
+    $string: __base-to-string($string);
+
+    @if not ($string) or ($string == '') or ($chars == '') {
+        @return $string;
+    }
+
+    @if (if($guard, __is-iteratee-call($value, $chars, $guard), ($chars == null))) {
+        @return str-slice($string, 0, __trimmed-right-index($string));
+    }
+
+    $chars: __base-to-string($chars);
+
+    @return str-slice($string, 0,
+        __chars-right-index($string, $chars));
+}
+
+
+/// Removes leading and trailing whitespace or specified characters from `$string`.
+///
+///
+/// @access public
+/// @group String
+/// @param {string} $string [''] - The string to trim.
+/// @param {string} $chars [' '] - The characters to trim.
+/// @returns {string} Returns the trimmed string.
+/// @example scss
+/// $foo: _trim('  abc  ');
+/// // => 'abc'
+/// $foo: _trim('-_-abc-_-', '_-');
+/// // => 'abc'
+/// $foo: _map(('  foo  ', '  bar  '), _trim);
+/// // => ('foo', 'bar')
+
+@function _trim($args...) {
+    @return call('__trim', $args...);
+}
+
+
+/// Removes leading whitespace or specified characters from `$string`.
+///
+///
+/// @access public
+/// @group String
+/// @param {string} $string [''] - The string to trim.
+/// @param {string} $chars [whitespace] - The characters to trim.
+/// @returns {string} Returns the trimmed string.
+/// @example scss
+/// /// _trim-left('  abc  ');
+/// // => 'abc  '
+/// /// _trim-left('-_-abc-_-', '_-');
+/// // => 'abc-_-'
+
+@function _trim-left($args...) {
+    @return call('__trim-left', $args...);
+}
+
+
+/// Removes trailing whitespace or specified characters from `$string`.
+///
+///
+/// @access public
+/// @group String
+/// @param {string} $string [''] - The string to trim.
+/// @param {string} $chars [' '] - The characters to trim.
+/// @returns {string} Returns the trimmed string.
+/// @example scss
+/// $foo: _trim-right('  abc  ');
+/// // => '  abc'
+/// $foo: _trim-right('-_-abc-_-', '_-');
+/// // => '-_-abc'
+
+@function _trim-right($args...) {
+    @return call('__trim-right', $args...);
+}

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

@@ -0,0 +1,92 @@
+@function __trunc($string, $options: null, $guard: null, $omission: null, $length: null, $separator: null) {
+    @if ($guard and __is-iteratee-call($string, $options, $guard)) {
+        $options: null;
+    }
+
+    $length: __either($length, __const('DEFAULT_TRUNC_LENGTH'));
+    $omission: __either($omission, __const('DEFAULT_TRUNC_OMISSION'));
+    $separator: __either($separator, null);
+
+    @if $options != null {
+        @if (__is-map($options)) {
+            $separator: if(
+                map-has-key($options, 'separator'),
+                __get($options, 'separator'),
+                $separator);
+            $length: if(
+                map-has-key($options, 'length'),
+                __get($options, 'length'),
+                $length);
+            $omission: if(
+                map-has-key($options, 'omission'),
+                __base-to-string(__get($options, 'omission')),
+                $omission);
+        } @else {
+            $length: __parse-int($options);
+        }
+    }
+
+    $string: __base-to-string($string);
+
+    @if ($length >= str-length($string)) {
+        @return $string;
+    }
+
+    $end: $length - str-length($omission);
+
+    @if ($end < 1) {
+        @return $omission;
+    }
+
+    $result: str-slice($string, 0, $end);
+
+    @if ($separator == null) {
+        @return $result + $omission;
+    }
+
+    @if (__string-index-of($string, $separator, $end) != $end) {
+        $index: __string-last-index-of($result, $separator);
+
+        @if ($index > -1) {
+            $result: str-slice($result, 0, $index - 1);
+        }
+    }
+
+    @return $result + $omission;
+}
+
+
+/// Truncates `$string` if it is longer than the given maximum string length.
+/// The last characters of the truncated string are replaced with the omission
+/// string which defaults to "...".
+///
+///
+/// @access public
+/// @group String
+/// @param {string} $string [''] - The string to truncate.
+/// @param {Map|number} $options [null] - The options object or maximum string length.
+/// @param {number} $length [30] - The maximum string length.
+/// @param {string} $omission ['...'] - The string to indicate text is omitted.
+/// @param {string} $separator [null] - The separator pattern to truncate to.
+/// @returns {string} Returns the truncated string.
+/// @example scss
+/// $foo: _trunc('hi-diddly-ho there, neighborino');
+/// // => 'hi-diddly-ho there, neighbo...'
+/// 
+/// $foo: _trunc('hi-diddly-ho there, neighborino', 24);
+/// // => 'hi-diddly-ho there, n...'
+/// 
+/// $foo: _trunc('hi-diddly-ho there, neighborino',
+///   $length: 24,
+///   $separator: ' '
+/// );
+/// // => 'hi-diddly-ho there,...'
+///
+/// $foo: _trunc('hi-diddly-ho there, neighborino', 
+///   $omission: ' (...)'
+/// );
+/// // => 'hi-diddly-ho there, neig (...)'
+
+@function _trunc($string, $options: null, $guard: null, $omission: null, $length: null, $separator: null) {
+    @return call('__trunc', $string, $options, $guard, $omission, $length, $separator);
+}

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

@@ -0,0 +1,48 @@
+@function __unescape-html-char($char) {
+    @return __const('html-unescapes' $char);
+}
+
+@function __unescape($string) {
+    $string: __base-to-string($string);
+    $escapes: ();
+
+    @each $escaped, $unescaped in __const('html-unescapes') {
+        $escaped-index: str-index($string, $escaped);
+
+        @if $escaped-index {
+            $escapes: append($escapes, (
+                'escaped': $escaped,
+                'unescaped': $unescaped,
+                'index': $escaped-index
+            ));
+        }
+    }
+
+    $escapes: __sort-by($escapes, __property('index'));
+
+    @each $escaped-map in $escapes {
+        $escaped: __get($escaped-map, 'escaped');
+        $unescaped: __get($escaped-map, 'unescaped');
+        $string: __string-replace($string, $escaped, $unescaped);
+    }
+
+    @return $string;
+}
+
+
+/// The inverse of `_escape`; this method converts the HTML entities
+/// `&`, `<`, `>`, `"`, `'`, and ``` in `string` to their
+/// corresponding characters.
+/// **Note:** No other HTML entities are unescaped.
+///
+/// @access public
+/// @group String
+/// @param {string} $string [''] - The string to unescape.
+/// @returns {string} Returns the unescaped string.
+/// @example scss
+/// $foo: _unescape('fred, barney, & pebbles');
+/// // => 'fred, barney, & pebbles'
+
+@function _unescape($args...) {
+    @return call('__unescape', $args...);
+}

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

@@ -0,0 +1,19 @@
+@function __union($arguments...) {
+    @return __base-uniq(__base-flatten($arguments, false, true));
+}
+
+
+/// Creates a list of unique values, in order.
+///
+///
+/// @access public
+/// @group List
+/// @param {List...} $lists... The lists to inspect.
+/// @returns {List} Returns the new list of combined values.
+/// @example scss
+/// $foo: _union((1, 2), (4, 2), (2, 1));
+/// // => (1, 2, 4)
+
+@function _union($args...) {
+    @return call('__union', $args...);
+}