sugarcss 1.0.0

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

@@ -0,0 +1,80 @@
+@function __pick-by-callback-iteratee($value, $key, $map) {
+    $result: __this('result');
+    $predicate: __this('predicate');
+
+    @if __exec($predicate, $value, $key, $map) {
+        $_: __this('result', __set($result, $key, $value));
+    }
+
+    @return true;
+}
+
+
+@function __pick-by-callback($map, $predicate) {
+    $result: ();
+    $_: __scope((
+        'map': $map,
+        'predicate': $predicate,
+        'result': $result
+    ));
+    $pick-by-callback-iteratee: __bind('__pick-by-callback-iteratee');
+    $_: __base-for-in($map, $pick-by-callback-iteratee);
+    $result: __this('result');
+    $_: __scope(false);
+
+    @return $result;
+}
+
+@function __pick-by-list($map, $props) {
+    $type: type-of($map);
+    $map: __to-map($map);
+    $result: ();
+
+    @each $key in $props {
+        @if (map-has-key($map, $key)) {
+            $result: __set($result, $key, __get($map, $key));
+        }
+    }
+
+    @return if($type == 'list', __to-list($result), $result);
+}
+
+
+@function __pick($map, $predicate: '__identity', $this-arg: null) {
+    @if $map == null {
+        @return ();
+    }
+
+    $map: __to-map($map);
+
+    @return if(__function-exists($predicate),
+        __pick-by-callback($map, __bind-callback($predicate, $this-arg, 3)),
+        __pick-by-list($map, __base-flatten(($map, $predicate, $this-arg), false, false, 1)));
+}
+
+
+/// Creates a map composed of the picked `$map` properties. Property
+/// names may be specified as individual arguments or as lists of property
+/// names. If `$predicate` is provided it is invoked for each property of `$map`
+/// picking the properties `$predicate` returns truthy for. The predicate is
+/// bound to `$this-arg` and invoked with three arguments; (value, key, map).
+///
+///
+/// @access public
+/// @group Map
+/// @param {Map} $map The source map.
+/// @param {Function|String|List(String)} $predicate [_identity] The function invoked per
+///  iteration or property names to pick, specified as individual property
+///  names or lists of property names.
+/// @param {*} $this-arg [null] - The `_this` binding of `$predicate`.
+/// @returns {Map} Returns the new map.
+/// @example scss
+/// $map: ( 'user': 'fred', 'age': 40 );
+/// $foo: _pick($map, 'user');
+/// // => ( 'user': 'fred' )
+/// $foo: _pick($map, _is-string);
+/// // => ( 'user': 'fred' )
+
+@function _pick($args...) {
+    @return call('__pick', $args...);
+}

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

@@ -0,0 +1,27 @@
+@function __pluck($collection, $key) {
+    @return __map($collection, __property($key));
+}
+
+
+/// Gets the value of `$key` from all elements in `$collection`.
+///
+///
+/// @access public
+/// @group Collection
+/// @param {List|Map|string} $collection The collection to iterate over.
+/// @param {string} $key The key of the property to pluck.
+/// @returns {List} Returns the property values.
+/// @example scss
+/// $users: (
+///   ( 'user': 'barney', 'age': 36 ),
+///   ( 'user': 'fred',   'age': 40 )
+/// );
+/// $foo: _pluck($users, 'user');
+/// // => ('barney', 'fred')
+/// $user-index: _index-by($users, 'user');
+/// $foo: _pluck($user-index, 'age');
+/// // => (36, 40)
+
+@function _pluck($args...) {
+    @return call('__pluck', $args...);
+}

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

@@ -0,0 +1,91 @@
+@function __base-property-function($map: null, $args...) {
+    $key: __this('key');
+
+    @if __is-falsey($map) {
+        @return null;
+    }
+
+    $map: __to-map($map);
+
+    @return if($map == null, null, __get($map, $key));
+}
+
+
+@function __base-property($key) {
+    $_: __scope((
+        'key': $key
+    ));
+    $base-property-function: __bind('__base-property-function');
+    $_: __scope(false);
+
+    @return $base-property-function;
+}
+
+
+@function __property($key, $args...) {
+    @return __base-property($key);
+}
+
+
+@function __property-of-function($key, $args...) {
+    $map: __this('map');
+
+    @return if($map == null, null, __get($map, $key));
+}
+
+
+@function __property-of($map, $args...) {
+    $_: __scope((
+        'map', $map
+    ));
+    $property-of-function: __bind('__property-of-function');
+    $_: __scope(false);
+
+    @return $property-of-function;
+}
+
+
+/// Creates a function which returns the property value of `$key` on a given map.
+///
+///
+/// @access public
+/// @group Utility
+/// @param {string} $key The key of the property to get.
+/// @returns {Function} Returns the new function.
+/// @example scss
+/// $users: (
+///   ( 'user': 'fred' ),
+///   ( 'user': 'barney' )
+/// );
+/// 
+/// $get-name: _property('user');
+///
+/// $foo: _map($users, $get-name);
+/// // => ('fred', barney')
+///
+/// $foo: _pluck(_sort-by($users, $get-name), 'user');
+/// // => ('barney', 'fred')
+
+@function _property($args...) {
+    @return call('__property', $args...);
+}
+
+
+/// The inverse of `_property`; this method creates a function which returns
+/// the property value of a given key on `$map`.
+///
+///
+/// @access public
+/// @group Utility
+/// @param {Map} $map The map to inspect.
+/// @returns {Function} Returns the new function.
+/// @example scss
+/// $map: ( 'a': 3, 'b': 1, 'c': 2 );
+/// $foo: _map(('a', 'c'), _property-of($map));
+/// // => (3, 2)
+/// $foo: _sort-by(('a', 'b', 'c'), _property-of($map));
+/// // => ('b', 'c', 'a')
+
+@function _property-of($args...) {
+    @return call('__property-of', $args...);
+}

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

@@ -0,0 +1,43 @@
+@function __pull($arguments...) {
+    $list: nth($arguments, 1);
+
+    @if not ($list and length($list)) {
+        @return $list;
+    }
+
+    $index: 1;
+    $length: length($arguments);
+
+    @while ($index <= $length) {
+        $from-index: 1;
+        $value: nth($arguments, $index);
+
+        @while (__index-of($list, $value, $from-index) > -1) {
+            $from-index: __index-of($list, $value, $from-index);
+            $list: __splice($list, $from-index, 1);
+        }
+
+        $index: $index + 1;
+    }
+
+    @return $list;
+}
+
+
+/// Removes all provided values from `$list`, and returns a new list
+/// without the provided values. Does not mutate original list.
+///
+///
+/// @access public
+/// @group List
+/// @param {List} $list The source list.
+/// @param {Any...} $values... The values to remove.
+/// @returns {List} Returns new `$list` with removed values.
+/// @example scss
+/// $list: (1, 2, 3, 1, 2, 3);
+/// $foo: _pull(list, 2, 3);
+/// // => (1, 1)
+
+@function _pull($args...) {
+    @return call('__pull', $args...);
+}

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

@@ -0,0 +1,27 @@
+@function __push($list, $items...) {
+    @each $item in $items {
+      $list: append($list, $item);
+    }
+
+    @return $list;
+
+    // @return join($list, $items, $separator: auto);
+}
+
+/// Adds one or more elements to the end of a `$list` and
+/// returns a new list with appended items.
+/// 
+/// Similar to native Sass `join()`, with the exception that no
+/// `$separator` is specified and arguments after the first one are
+/// treated as elements to be appended to `$list`.
+/// 
+/// @access public
+/// @group List
+/// @param {List} $list The target list.
+/// @param {Any...} $items... The items to append to `$list`.
+/// @returns {List} Returns list with appended items.
+/// @example scss
+/// // todo
+@function _push($args...) {
+    @return call('__push', $args...);
+}

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

@@ -0,0 +1,79 @@
+@function __base-rand($min, $max) {
+    @return $min + floor(random() * ($max - $min + 1));
+}
+
+
+@function __rand($min: null, $max: null, $floating: null) {
+    $min: __parse-float($min);
+    $max: __parse-float($max);
+
+    @if ($floating and __is-iteratee-call($min, $max, $floating)) {
+        $max: null;
+        $floating: null;
+    }
+
+    $no-min: ($min == null);
+    $no-max: ($max == null);
+
+    @if ($floating == null) {
+        @if $no-max and __is-boolean($min) {
+            $floating: $min;
+            $min: 1;
+        } @else if __is-boolean($max) {
+            $floating: $max;
+            $no-max: true;
+        }
+    }
+
+    @if $no-min and $no-max {
+        $max: 1;
+        $no-max: false;
+    }
+
+    $min: if($min == true, 1, if(__is-falsey($min), 0, $min));
+
+    @if ($no-max) {
+        $max: $min;
+        $min: 0;
+    } @else {
+        $max: if($max == true, 1, if($max == false, 0, $max));
+    }
+
+    @if ($floating or ($min % 1 > 0) or ($max % 1 > 0)) {
+        $rand: random();
+
+        @return min($min + ($rand * ($max - $min + 1 / (10 * (str-length('#{$rand}') - 1)))), $max);
+    }
+
+    @return __base-rand($min, $max);
+}
+
+
+/// Produces a random number between `$min` and `$max` (inclusive). If only one
+/// argument is provided a number between `0` and the given number is returned.
+/// 
+/// If `floating` is `true`, or either `$min` or `$max` are floats, a floating-point
+/// number is returned instead of an integer.
+/// 
+/// NOTE: This is not equivalent to the native Sass `random()` function.
+///
+///
+/// @access public
+/// @group Number
+/// @param {number} $min [0] - The minimum possible value.
+/// @param {number} $max [1] - The maximum possible value.
+/// @param {boolean} $floating [false] - Specify returning a floating-point number.
+/// @returns {number} Returns the random number.
+/// @example scss
+/// $foo: _random(0, 5);
+/// // => an integer between 0 and 5
+/// $foo: _random(5);
+/// // => also an integer between 0 and 5
+/// $foo: _random(5, true);
+/// // => a floating-point number between 0 and 5
+/// $foo: _random(1.2, 5.2);
+/// // => a floating-point number between 1.2 and 5.2
+
+@function _rand($args...) {
+    @return call('__rand', $args...);
+}

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

@@ -0,0 +1,59 @@
+@function __range($start, $end: null, $step: null) {
+    @if ($step and $step != 0 and __is-iteratee-call($start, $end, $step)) {
+        $end: null;
+        $step: null;
+    }
+
+    $start: if(__is-integer($start), $start, if(__is-truthy($start), 1, 0));
+    $step: if($step == null, 1, if(__is-integer($step), $step, if($step, 1, 0)));
+
+    @if ($end == null) {
+        $end: $start;
+        $start: 0;
+    } @else {
+        $end: if(__is-integer($end), $end, if($end, 1, 0));
+    }
+
+    $index: 1;
+    $length: max(ceil(($end - $start) / (if($step == 0, 1, $step))), 0);
+    $result: ();
+
+    @while ($index <= $length) {
+        $result: append($result, $start);
+        $start: $start + $step;
+        $index: $index + 1;
+    }
+
+    @return $result;
+}
+
+
+/// Creates a list of numbers (positive and/or negative) progressing from
+/// `$start` up to, but not including, `$end`. If `$end` is not specified it
+/// defaults to `$start` with `$start` becoming `0`. If `$start` is less than
+/// `$end` a zero-length range is created unless a negative `$step` is specified.
+///
+///
+/// @access public
+/// @group Utility
+/// @param {number} $start [0] - The start of the range.
+/// @param {number} $end - The end of the range.
+/// @param {number} $step [1] - The value to increment or decrement by.
+/// @returns {List} Returns the new list of numbers.
+/// @example scss
+/// $foo: _range(4);
+/// // => (0, 1, 2, 3)
+/// $foo: _range(1, 5);
+/// // => (1, 2, 3, 4)
+/// $foo: _range(0, 20, 5);
+/// // => (0, 5, 10, 15)
+/// $foo: _range(0, -4, -1);
+/// // => (0, -1, -2, -3)
+/// $foo: _range(1, 4, 0);
+/// // => (1, 1, 1)
+/// $foo: _range(0);
+/// // => ()
+
+@function _range($args...) {
+    @return call('__range', $args...);
+}

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

@@ -0,0 +1,146 @@
+@function __reduce($collection, $iteratee: '__identity', $accumulator: null, $this-arg: null) {
+
+    $function: if(__is-list($collection) or __is-string($collection),
+        '__list-reduce',
+        '__base-reduce');
+
+    @return __exec($function,
+        $collection,
+        __get-callback($iteratee, $this-arg, 4),
+        $accumulator,
+        ($accumulator == null and $this-arg == null),
+        __base-each);
+}
+
+@function __reduce-right($collection, $iteratee: '__identity', $accumulator: null, $this-arg: null) {
+    $function: if(__is-list($collection) or __is-string($collection),
+        '__list-reduce-right',
+        '__base-reduce');
+
+    @return __exec($function, $collection, __get-callback($iteratee, $this-arg, 4), $accumulator, ($accumulator == null and $this-arg == null), '__base-each-right');
+}
+
+
+@function __list-reduce($list, $iteratee, $accumulator: null, $init-from-list: true, $args...) {
+    $list: __to-list($list);
+    $index: 1;
+    $length: length($list);
+
+    @if ($init-from-list and ($length > 0)) {
+        $accumulator: nth($list, $index);
+        $index: $index + 1;
+    }
+
+    @while ($index <= $length) {
+        $value: nth($list, $index);
+        $accumulator: __exec($iteratee, $accumulator, $value, $index, $list);
+
+        $index: $index + 1;
+    }
+
+    @return $accumulator;
+}
+
+
+@function __list-reduce-right($list, $iteratee, $accumulator: null, $init-from-list: true, $args...) {
+    $list: __to-list($list);
+    $list: __list-reverse($list);
+
+    @return __list-reduce($list, $iteratee, $accumulator, $init-from-list);
+}
+
+
+@function __base-reduce-iteratee($value, $index, $collection: null) {
+    $iteratee: __this('iteratee');
+    $accumulator: __this('accumulator');
+    $init-from-collection: __this('init-from-collection');
+
+    @if ($init-from-collection) {
+        $_: __this('init-from-collection', false);
+        $accumulator: $value;
+    } @else {
+        $accumulator: __exec($iteratee, $accumulator, $value, $index, $collection);
+    }
+
+    $_: __this('accumulator', $accumulator);
+
+    @return true;
+}
+
+
+@function __base-reduce($collection, $iteratee, $accumulator, $init-from-collection: false, $each-function: null) {
+
+    $_: __scope((
+        'iteratee': $iteratee,
+        'accumulator': $accumulator,
+        'init-from-collection': $init-from-collection
+    ));
+    $iteratee: __bind('__base-reduce-iteratee');
+    $_: __exec($each-function, $collection, $iteratee);
+    $accumulator: __this('accumulator');
+    $_: __scope(false);
+
+    @return $accumulator;
+}
+
+
+/// Reduces `$collection` to a value which is the accumulated result of running
+/// each element in `$collection` through `$iteratee`, where each successive
+/// invocation is supplied the return value of the previous. If `$accumulator`
+/// is not provided the first element of `$collection` is used as the initial
+/// value. The `$iteratee` is bound to `$this-arg`and invoked with four arguments;
+/// (accumulator, value, index|key, collection).
+///
+/// @access public
+/// @group Collection
+/// @param {List|Map|string} $collection The collection to iterate over.
+/// @param {Function} $iteratee [_identity] - The function invoked per iteration.
+/// @param {*} $accumulator [null] The initial value.
+/// @param {*} $this-arg [null] - The `_this` binding of `$iteratee`.
+/// @returns {*} Returns the accumulated value.
+/// @example scss
+/// // todo
+
+@function _reduce($args...) {
+    @return call('__reduce', $args...);
+}
+
+
+/// @alias _reduce
+
+@function _foldl($args...) {
+    @return call('__reduce', $args...);
+}
+
+
+/// @alias _reduce
+
+@function _inject($args...) {
+    @return call('__reduce', $args...);
+}
+
+
+/// This method is like `_reduce` except that it iterates over elements of
+/// `$collection` from right to left.
+///
+///
+/// @access public
+/// @group Collection
+/// @param {List|Map|string} $collection The collection to iterate over.
+/// @param {Function} $iteratee [_identity] - The function invoked per iteration.
+/// @param {*} $accumulator [null] - The initial value.
+/// @param {*} $this-arg [null] - The `_this` binding of `$iteratee`.
+/// @returns {*} Returns the accumulated value.
+/// @example scss
+/// // todo
+
+@function _reduce-right($args...) {
+    @return call('__reduce-right', $args...);
+}
+
+
+/// @alias _reduce-right
+
+@function _foldr($args...) {
+    @return call('__reduce-right', $args...);
+}

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

@@ -0,0 +1,68 @@
+@function __reject-iteratee($value, $index, $collection) {
+    $predicate: __this('predicate');
+    $test: __exec($predicate, $value, $index, $collection);
+    $result: __is-falsey(__exec($predicate, $value, $index, $collection));
+
+    @return $result;
+}
+
+
+@function __reject($collection, $predicate: '__identity', $this-arg: null) {
+    $function: if(__is-list($collection), '__list-filter', '__base-filter');
+    $predicate: __get-callback($predicate, $this-arg, 3);
+    $_: __scope((
+        'predicate': $predicate
+    ));
+    $reject-iteratee: __bind('__reject-iteratee');
+    $result: __exec($function, $collection, $reject-iteratee);
+    $_: __scope(false);
+
+    @return $result;
+}
+
+///
+/// The opposite of `_filter`; this method returns the elements of `$collection`
+/// that `$predicate` does **not** return truthy for.
+/// 
+/// 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 {List} Returns the new filtered list.
+/// @example scss
+/// $foo: _reject((1, 2, 3, 4), is-even);
+/// // => (1, 3)
+/// 
+/// $users: (
+///   ( 'user': 'barney', 'age': 36, 'active': false ),
+///   ( 'user': 'fred',   'age': 40, 'active': true )
+/// );
+/// // using the `_matches` callback shorthand
+/// $foo: _pluck(_reject($users, ( 'age': 40, 'active': true )), 'user');
+/// // => ('barney')
+/// 
+/// // using the `_matches-property` callback shorthand
+/// $foo: _pluck(_reject($users, 'active', false), 'user');
+/// // => ('fred')
+/// 
+/// // using the `_property` callback shorthand
+/// $foo: _pluck(_reject($users, 'active'), 'user');
+/// // => ('barney')
+
+@function _reject($args...) {
+    @return call('__reject', $args...);
+}

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

@@ -0,0 +1,33 @@
+@function __repeat($string, $value: 0) {
+    $value: __parse-int($value);
+    $result: '';
+
+    @if $value >= 1 {
+        @for $iteration from 1 through $value {
+            $result: $result + $string;
+        }
+    }
+
+    @return $result;
+}
+
+
+/// Repeats the given string `$n` times.
+/// ///
+///
+/// @access public
+/// @group String
+/// @param {string} $string [''] - The string to repeat.
+/// @param {number} $n [0] - The number of times to repeat the string.
+/// @returns {string} Returns the repeated string.
+/// @example scss
+/// /// _repeat('*', 3);
+/// // => '***'
+/// /// _repeat('abc', 2);
+/// // => 'abcabc'
+/// /// _repeat('abc', 0);
+/// // => ''
+
+@function _repeat($args...) {
+    @return call('__repeat', $args...);
+}