sugarcss 1.0.0

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

@@ -0,0 +1,111 @@
+@import 'add';
+@import 'after';
+@import 'ary';
+@import 'assign';
+@import 'at';
+@import 'before';
+@import 'bind';
+@import 'callback';
+@import 'case';
+@import 'chunk';
+@import 'compact';
+@import 'compare';
+@import 'concat';
+@import 'constant';
+@import 'context';
+@import 'count-by';
+@import 'create';
+@import 'debug';
+@import 'declare';
+@import 'defaults';
+@import 'difference';
+@import 'drop';
+@import 'either';
+@import 'encode';
+@import 'ends-with';
+@import 'escape';
+@import 'every';
+@import 'exec';
+@import 'extrema';
+@import 'fill';
+@import 'filter';
+@import 'find';
+@import 'first';
+@import 'flatten';
+@import 'flow';
+@import 'for';
+@import 'functions';
+@import 'group-by';
+@import 'has';
+@import 'identity';
+@import 'includes';
+@import 'index-by';
+@import 'index-of';
+@import 'initial';
+@import 'intersection';
+@import 'invert';
+@import 'invoke';
+@import 'is-empty';
+@import 'is-equal';
+@import 'is-match';
+@import 'is-type';
+@import 'join';
+@import 'keys';
+@import 'last';
+@import 'map';
+@import 'matches';
+@import 'memoize';
+@import 'merge';
+@import 'modify';
+@import 'negate';
+@import 'noop';
+@import 'omit';
+@import 'once';
+@import 'pad';
+@import 'pairs';
+@import 'parse-int';
+@import 'partial';
+@import 'partition';
+@import 'pick';
+@import 'pluck';
+@import 'property';
+@import 'pull';
+@import 'push';
+@import 'rand';
+@import 'range';
+@import 'reject';
+@import 'reduce';
+@import 'repeat';
+@import 'replace';
+@import 'result';
+@import 'rest';
+@import 'reverse';
+@import 'rules';
+@import 'sample';
+@import 'shuffle';
+@import 'size';
+@import 'slice';
+@import 'some';
+@import 'sort';
+@import 'sorted-index'; // not unit tested
+@import 'splice';
+@import 'split';
+@import 'starts-with';
+@import 'sum';
+@import 'take';
+@import 'times';
+@import 'to-list';
+@import 'to-string';
+@import 'trim';
+@import 'trunc';
+@import 'unescape';
+@import 'union';
+@import 'uniq';
+@import 'unique-id';
+@import 'unzip';
+@import 'values';
+@import 'where';
+@import 'without';
+@import 'words';
+@import 'xor';
+@import 'zip';

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

@@ -0,0 +1,42 @@
+@function __negate-function($arguments...) {
+    $predicate: __this('predicate');
+
+    @return not __call($predicate, __this(), $arguments...);
+}
+
+
+@function __negate($predicate) {
+    @if not (__function-exists($predicate)) {
+        @error 'FUNC_ERROR_TEXT';
+    }
+
+    $_: __scope((
+        'predicate': $predicate
+    ));
+    $negate-function: __bind('__negate-function');
+    $_: __scope(false);
+
+    @return $negate-function;
+}
+
+
+/// Creates a function that negates the result of the predicate `$function`. The
+/// `$function` predicate is invoked with the `_this` binding and arguments of the
+/// created function.
+///
+///
+/// @access public
+/// @group Function
+/// @param {Function} $predicate The predicate to negate.
+/// @returns {Function} Returns the new function.
+/// @example scss
+///     @function is-even($n, $args...) {
+///         @return $n % 2 == 0;
+///     }
+///     
+///     $foo: _filter((1, 2, 3, 4, 5, 6), _negate(is-even));
+///     // => (1, 3, 5)
+
+@function _negate($args...) {
+    @return call('__negate', $args...);
+}

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

@@ -0,0 +1,19 @@
+@function __noop($args...) {
+    @return null;
+}
+
+
+/// A no-operation function which returns `null` regardless of the
+/// arguments it receives.
+///
+///
+/// @access public
+/// @group Utility
+/// @example scss
+/// $map: ( 'user': 'fred' );
+/// $foo: _noop($map) == null;
+/// // => true
+
+@function _noop($args...) {
+    @return call('__noop', $args...);
+}

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

@@ -0,0 +1,52 @@
+@function __omit($map, $predicate, $this-arg: null, $args...) {
+    @if $map == null {
+        @return ();
+    }
+
+    $map: __to-map($map);
+    
+    @if not __function-exists($predicate) {
+        $omitted-keys: __base-flatten(($predicate, $this-arg, $args));
+
+        @each $key in $omitted-keys {
+            $map: map-remove($map, $key);
+        }
+
+        @return $map;
+    }
+
+    $predicate: __bind-callback($predicate, $this-arg, 3);
+    $result: __pick-by-callback($map, __negate($predicate));
+
+    @return $result;
+}
+
+
+/// The opposite of `_pick`; this method creates a map composed of the
+/// own and inherited enumerable properties of `$map` that are not omitted.
+/// 
+/// 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` omitting 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} $predicate The function invoked per
+///  iteration or property names to omit, 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: _omit($map, 'age');
+/// // => ( 'user': 'fred' )
+/// $foo: _omit($map, _is-number);
+/// // => ( 'user': 'fred' )
+
+@function _omit($args...) {
+    @return call('__omit', $args...);
+}

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

@@ -0,0 +1,27 @@
+@function __once($function) {
+    @return __before($function, 2);
+}
+
+
+/// Creates a function that is restricted to invoking `$function` once. Repeat calls
+/// to the function return the value of the first call. The `$function` is invoked
+/// with the `_this` binding of the created function.
+///
+///
+/// @access public
+/// @group Function
+/// @param {Function} $func The function to restrict.
+/// @returns {Function} Returns the new restricted function.
+/// @example scss
+/// $lighten-once: _once(lighten);
+/// $color: _exec($lighten-once, green, 10%);
+/// 
+/// color: $color; // lightened green
+/// 
+/// $color: _exec($lighten-once, blue, 20%);
+/// 
+/// color: $color; // null
+
+@function _once($args...) {
+    @return call('__once', $args...);
+}

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

@@ -0,0 +1,121 @@
+@function __create-pad($string, $length, $chars: ' ') {
+    $str-length: str-length($string);
+
+    @if $str-length >= $length {
+        @return '';
+    }
+
+    $pad-length: $length - $str-length;
+    $chars: __to-string($chars);
+    $chars-length: length($chars);
+    $repeat-chars: if($chars-length > 0, ceil($pad-length / $chars-length), 0);
+
+    @return str-slice(__repeat($chars, $repeat-chars), 1, $pad-length);
+}
+
+
+@function __pad($string, $length: 0, $chars: ' ') {
+    $string: __base-to-string($string);
+    $str-length: str-length($string);
+
+    @if $str-length >= $length {
+        @return $string;
+    }
+
+    $mid: ($length - $str-length) / 2;
+    $left-length: floor($mid);
+    $right-length: ceil($mid);
+    $chars: __create-pad('', $right-length, $chars);
+
+    @return str-slice($chars, 0, $left-length) + $string + $chars;
+}
+
+
+@function __pad-left($string, $length: 0, $chars: ' ') {
+    $string: __base-to-string($string);
+
+    @return if($string != '',
+        __create-pad($string, $length, $chars) + $string,
+        $string);
+}
+
+
+@function __pad-right($string, $length: 0, $chars: ' ') {
+    $string: __base-to-string($string);
+
+    @return if($string != '',
+        $string + __create-pad($string, $length, $chars),
+        $string);
+}
+
+
+/// Pads `$string` on the left and right sides if it is shorter then the given
+/// padding length. The `$chars` string may be truncated if the number of padding
+/// characters can't be evenly divided by the padding length.
+///
+///
+/// @access public
+/// @group String
+/// @param {string} $string [''] - The string to pad.
+/// @param {number} $length [0] - The padding length.
+/// @param {string} $chars [' '] - The string used as padding.
+/// @returns {string} Returns the padded string.
+/// @example scss
+/// $foo: _pad('abc', 8);
+/// // => '  abc   '
+/// $foo: _pad('abc', 8, '_-');
+/// // => '_-abc_-_'
+/// $foo: _pad('abc', 3);
+/// // => 'abc'
+
+@function _pad($args...) {
+    @return call('__pad', $args...);
+}
+
+
+/// Pads `$string` on the left side if it is shorter then the given padding
+/// length. The `$chars` string may be truncated if the number of padding
+/// characters exceeds the padding length.
+///
+///
+/// @access public
+/// @group String
+/// @param {string} $string [''] - The string to pad.
+/// @param {number} $length [0] - The padding length.
+/// @param {string} $chars [' '] - The string used as padding.
+/// @returns {string} Returns the padded string.
+/// @example scss
+/// $foo: _pad-left('abc', 6);
+/// // => '   abc'
+/// $foo: _pad-left('abc', 6, '_-');
+/// // => '_-_abc'
+/// $foo: _pad-left('abc', 3);
+/// // => 'abc'
+
+@function _pad-left($args...) {
+    @return call('__pad-left', $args...);
+}
+
+
+/// Pads `$string` on the right side if it is shorter then the given padding
+/// length. The `$chars` string may be truncated if the number of padding
+/// characters exceeds the padding length.
+///
+///
+/// @access public
+/// @group String
+/// @param {string} $string [''] - The string to pad.
+/// @param {number} $length [0] - The padding length.
+/// @param {string} $chars [' '] - The string used as padding.
+/// @returns {string} Returns the padded string.
+/// @example scss
+/// $foo: _pad-right('abc', 6);
+/// // => 'abc   '
+/// $foo: _pad-right('abc', 6, '_-');
+/// // => 'abc_-_'
+/// $foo: _pad-right('abc', 3);
+/// // => 'abc'
+
+@function _pad-right($args...) {
+    @return call('__pad-right', $args...);
+}

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

@@ -0,0 +1,26 @@
+@function __pairs($map, $args...) {
+    $result: ();
+
+    @each $key, $value in $map {
+        $result: append($result, ($key, $value));
+    }
+
+    @return $result;
+}
+
+
+/// Creates a two dimensional list of the key-value pairs for `$map`,
+/// e.g. `(($key1, $value1), ($key2, $value2))`.
+///
+///
+/// @access public
+/// @group Map
+/// @param {Map} $map The map to inspect.
+/// @returns {List} Returns the new list of key-value pairs.
+/// @example scss
+/// $foo: _pairs(( 'barney': 36, 'fred': 40 ));
+/// // => (('barney', 36), ('fred', 40))
+
+@function _pairs($args...) {
+    @return call('__pairs', $args...);
+}

data/stylesheets/sugar/vendors/sassdash/api/_parse-int.scss

@@ -0,0 +1,69 @@
+@function __parse-int($string, $radix: null, $guard: null) {
+    @if ($guard and __is-iteratee-call($string, $radix, $guard)) {
+        $radix: 10;
+    }
+
+    @if __is-falsey($string) {
+        @return 0;
+    }
+
+    $string: to-upper-case(__trim($string));
+
+    @if __is-falsey($radix) {
+        $radix: if(__starts-with($string, ('0X', '#')), 16, 10);
+    }
+
+    $result: 0;
+    $multiplier: if(__starts-with($string, '-'), -1, 1);
+    $prefix: if(__starts-with($string, ('-', '+', '#')), 1, if(__starts-with($string, ('0X')), 2, 0));
+    $char-min: __get-char-code(0);
+    $char-max: $char-min + 9;
+    $char-alpha-min: __get-char-code('A'); // 10
+    $char-alpha-max: __get-char-code('Z');
+    $char-codes: __map($string, '__get-char-code');
+    $index: $prefix + 1;
+    $break: false;
+
+    @while $index <= length($char-codes) and not $break {
+        $char-code: nth($char-codes, $index);
+
+        @if $char-code >= $char-min and $char-code <= $char-max {
+            $result: ($radix * $result) + ($char-code - $char-min);
+        } @else if $char-code >= $char-alpha-min and $char-code < $char-alpha-max {
+            $result: ($radix * $result) + ($char-code - $char-alpha-min + 10);
+        } @else {
+            $break: true;
+        }
+
+        $index: $index + 1;
+    }
+
+    @return $multiplier * $result;
+}
+
+/// Parses a string argument and returns an integer of the specified radix
+/// (the base in mathematical numerical systems).
+/// 
+/// Similar to native JavaScript [parseInt() function](https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/parseInt).
+/// 
+/// @access public
+/// @group Number
+/// @param {String} $string The value to parse. If string is not a string,
+///  then it is converted to one. Leading whitespace in the string is ignored.
+/// @param {Number} $radix An integer between 2 and 36 that represents the radix
+///  (the base in mathematical numeral systems) of the above mentioned string. 
+/// @returns {Number} Returns the string converted to an integer, or `null`.
+/// @example scss
+/// 
+/// $foo: _parse-int('10');
+/// // => 10
+/// 
+/// $foo: _parse-int('#000020');
+/// // => 32
+/// 
+/// $foo: _parse-int('    123');
+/// // => 123
+
+@function _parse-int($args...) {
+    @return call('__parse-int', $args...);
+}

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

@@ -0,0 +1,91 @@
+@function __partial-wrapper($arguments...) {
+    $partials: __this('partials');
+    $func: __this('func');
+    $arguments: join($partials, $arguments);
+
+    @return __exec($func, $arguments...);
+}
+
+
+@function __partial($func, $arguments...) {
+    $partials: $arguments;
+    $_: __scope((
+        'partials': $partials,
+        'func': $func
+    ));
+    $partial-wrapper: __bind('__partial-wrapper');
+    $_: __scope(false);
+
+    @return $partial-wrapper;
+}
+
+
+@function __partial-right-wrapper($arguments...) {
+    $partials: __this('partials');
+    $func: __this('func');
+    $arguments: join($arguments, $partials);
+
+    @return __exec($func, $arguments...);
+}
+
+
+@function __partial-right($func, $arguments...) {
+    $partials: $arguments;
+    $_: __scope((
+        'partials': $partials,
+        'func': $func
+    ));
+    $partial-wrapper: __bind('__partial-right-wrapper');
+    $_: __scope(false);
+
+    @return $partial-wrapper;
+}
+
+
+/// Creates a function that invokes `$function` with `partial` arguments prepended
+/// to those provided to the new function. This method is like `_bind` except
+/// it does **not** alter the `_this` binding.
+///
+///
+/// @access public
+/// @group Function
+/// @param {Function} $func The function to partially apply arguments to.
+/// @param {Any...} $args... The arguments to be partially applied.
+/// @returns {Function} Returns the new partially applied function.
+/// @example scss
+///     @function greet($greeting, $name) {
+///         @return $greeting + ' ' + $name;
+///     }
+///     
+///     $say-hello-to: _partial(greet, 'hello');
+///     
+///     $foo: _exec($say-hello-to, 'fred');
+///     // => 'hello fred'
+
+@function _partial($args...) {
+    @return call('__partial', $args...);
+}
+
+
+/// This method is like `_partial` except that partially applied arguments
+/// are appended to those provided to the new function.
+///
+///
+/// @access public
+/// @group Function
+/// @param {Function} $func The function to partially apply arguments to.
+/// @param {Any...} $args... The arguments to be partially applied.
+/// @returns {Function} Returns the new partially applied function.
+/// @example scss
+///     @function greet($greeting, $name) {
+///         @return $greeting + ' ' + $name;
+///     }
+///     
+///     $greet-with: _partial-right(greet, 'fred');
+///     
+///     $foo: _exec($greet-with, 'hi');
+///     // => 'hi fred'
+
+@function _partial-right($args...) {
+    @return call('__partial-right', $args...);
+}

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

@@ -0,0 +1,53 @@
+@function __partition-initializer() {
+    @return ((), ());
+}
+
+
+@function __partition-aggregator($result, $value, $key, $args...) {
+    $result-index: if(__is-truthy($key), 1, 2);
+    $result-value: nth($result, $result-index);
+    $result-value: if($result-value, $result-value, ());
+
+    @return set-nth($result, $result-index, append($result-value, $value));
+}
+
+
+@function __partition($arguments...) {
+    $function: __create-aggregator('__partition-aggregator', '__partition-initializer');
+
+    @return __exec($function, $arguments...);
+}
+
+
+/// Creates a list of elements split into two groups, the first of which
+/// contains elements `$predicate` returns truthy for, while the second of which
+/// contains elements `$predicate` returns falsey for.
+/// 
+/// 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 {List} Returns the list of grouped elements.
+/// @example scss
+/// $foo: _partition(1.3 1.4 2.1 2.2, floor);
+/// // => ((1.3 1.4), (2.1 2.2))
+
+@function _partition($args...) {
+    @return call('__partition', $args...);
+}