sugarcss 1.0.0

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

@@ -0,0 +1,265 @@
+@function __base-map-iteratee($value, $key, $collection) {
+    $result: __this('result');
+    $iteratee: __this('iteratee');
+
+    $result: append($result, __exec($iteratee, $value, $key, $collection));
+    $_: __this('result', $result);
+
+    @return $result;
+}
+
+
+@function __base-map($collection, $iteratee) {
+    $_: __scope((
+        'result': (),
+        'iteratee': $iteratee
+    ));
+    $_: __base-each($collection, '__base-map-iteratee');
+    $result: __this('result');
+    $_: __scope(false);
+
+    @return $result;
+}
+
+
+@function __list-map($list, $iteratee) {
+    $index: 1;
+    $length: length($list);
+    $result-list: ();
+
+    @while ($index <= $length) {
+        $value: nth($list, $index);
+        $result-list: append($result-list, __exec($iteratee, $value, $index, $list));
+        $index: $index + 1;
+    }
+
+    @return $result-list;
+}
+
+
+@function __map($collection, $iteratee: '__identity', $this-arg: null) {
+    @if not __is-iterable($collection) {
+        $collection: ();
+    }
+
+    $collection: if(__is-string($collection), __to-list($collection), $collection);
+    $function: if(__is-list($collection), '__list-map', '__base-map');
+    $iteratee: __get-callback($iteratee, $this-arg, 3);
+
+    @return __exec($function, $collection, $iteratee);
+}
+
+
+@function __map-values-iteratee($value, $key, $map) {
+    $result: __this('result');
+    $iteratee: __this('iteratee');
+    $result: __set($result, $key, __exec($iteratee, $value, $key, $map));
+    $_: __this('result', $result);
+
+    @return true;
+}
+
+
+@function __map-values($map, $iteratee: __identity, $this-arg: null) {
+    $result: ();
+    $iteratee: __get-callback($iteratee, $this-arg, 3);
+    $_: __scope((
+        'result': $result,
+        'iteratee': $iteratee
+    ));
+    $map-values-iteratee: __bind('__map-values-iteratee');
+    $_: __base-for-own($map, $map-values-iteratee);
+    $result: __this('result');
+    $_: __scope(false);
+
+    @return $result;
+}
+
+
+@function __map-keys-iteratee($value, $key, $map) {
+    $result: __this('result');
+    $iteratee: __this('iteratee');
+    $iteratee-value: if(__this('with-keys'),
+        $key,
+        $value);
+
+    $result: __set($result,
+        __exec($iteratee, $iteratee-value, $key, $map),
+        $value);
+    $_: __this('result', $result);
+
+    @return $result;
+}
+
+
+@function __map-keys($map, $iteratee: __identity, $this-arg: null, $with-keys: false) {
+    $result: ();
+    $iteratee: __get-callback($iteratee, $this-arg, 3);
+    $_: __scope((
+        'result': $result,
+        'iteratee': $iteratee,
+        'with-keys': $with-keys
+    ));
+    $map-keys-iteratee: __bind('__map-keys-iteratee');
+
+    $_: __base-for-own($map, $map-keys-iteratee);
+    $result: __this('result');
+    $_: __scope(false);
+
+    @return $result;
+}
+
+
+/// Creates a list of values by running each element in `$collection` through
+/// `$iteratee`. The `$iteratee` 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`.
+/// 
+/// Many lodash methods are guarded to work as interatees for methods like
+/// `_every`, `_filter`, `_map`, `_map-values`, `_reject`, and `_some`.
+///
+/// @access public
+/// @group Collection
+/// @param {List|Map|string} $collection The collection to iterate over.
+/// @param {Function|Map|string} $iteratee [_identity] - The function invoked
+///  per iteration.
+///  create a `_property` or `_matches` style callback respectively.
+/// @param {*} $this-arg [null] - The `_this` binding of `$iteratee`.
+/// @returns {List} Returns the new mapped list.
+/// @example scss
+///     @function times-three($n, $args...) {
+///       @return $n * 3;
+///     }
+///     
+///     $foo: _map((1, 2), times-three);
+///     // => (3, 6)
+///     
+///     $foo: _map(( 'a': 1, 'b': 2 ), times-three);
+///     // => (3, 6)
+///     
+///     $users: (
+///       ( 'user': 'barney' ),
+///       ( 'user': 'fred' )
+///     );
+///     // using the `_property` callback shorthand
+///     $foo: _map($users, 'user');
+///     // => ('barney', 'fred')
+
+@function _map($args...) {
+    @return call('__map', $args...);
+}
+
+
+/// @alias _map
+
+@function _collect($args...) {
+    @return call('__map', $args...);
+}
+
+
+/// Creates a map with the same keys as `$map` and values generated by
+/// running each own enumerable property of `$map` through `$iteratee`. The
+/// iteratee function is bound to `$this-arg` and invoked with three arguments;
+/// (value, key, map).
+/// 
+/// If a property name is provided for `$iteratee` 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 `$iteratee` the created `_matches` style
+/// callback returns `true` for elements that have the properties of the given
+/// map, else `false`.
+///
+///
+/// @access public
+/// @group Map
+/// @param {Map} $map The map to iterate over.
+/// @param {Function|Map|string} $iteratee [_identity] - The function invoked
+///  per iteration.
+/// @param {*} $this-arg [null] - The `_this` binding of `$iteratee`.
+/// @returns {Map} Returns the new mapped map.
+/// @example scss
+///     @function times-three($n, $args...) {
+///         @return $n * 3;
+///     }
+///     
+///     $foo: _map-values(( 'a': 1, 'b': 2 ), times-three);
+///     // => ( 'a': 3, 'b': 6 )
+///     
+///     $users: (
+///       'fred':    ( 'user': 'fred',    'age': 40 ),
+///       'pebbles': ( 'user': 'pebbles', 'age': 1 )
+///     );
+///     // using the `_property` callback shorthand
+///     $foo: _map-values($users, 'age');
+///     // => ( 'fred': 40, 'pebbles': 1 )
+
+@function _map-values($args...) {
+    @return call('__map-values', $args...);
+}
+
+
+/// The opposite of `_map-values`; this method creates a map with the same 
+/// values as `$map` and keys generated by running each own enumerable 
+/// property of `$map` through `$iteratee`.
+/// 
+/// If a property name is provided for `$iteratee` 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 `$iteratee` the created `_matches` style
+/// callback returns `true` for elements that have the properties of the given
+/// map, else `false`.
+/// 
+/// **Also** - if `$with-keys` is specified as `true`, the iteratee
+/// will only use each `key` of the `$map` as its value.
+/// 
+/// @access public
+/// @group Map
+/// @param {Map} $map The map to iterate over.
+/// @param {Function|Map|string} $iteratee [_identity] - The function invoked
+/// per iteration.
+/// @param {*} $this-arg [null] - The `_this` binding of `$iteratee`.
+/// @returns {Map} Returns the new mapped map.
+/// @example scss
+///     @function to-css-prop($val, $key, $args...) {
+///         @return _kebab-case($key);
+///     }
+///     
+///     $foo: (
+///         'backgroundColor': white,
+///         'marginTop': 1rem
+///     );
+///     
+///     $foo: _map-keys($foo, to-css-prop);
+///     // => (
+///     //  'background-color': white,
+///     //  'margin-top': 1rem
+///     // )
+///     
+///     // Using $with-keys
+///     $foo: _map-keys($foo, _kebab-case, null, $with-key: true);
+///     // => (
+///     //  'background-color': white,
+///     //  'margin-top': 1rem
+///     // )
+
+@function _map-keys($args...) {
+    @return call('__map-keys', $args...);
+}

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

@@ -0,0 +1,85 @@
+@function __base-matches-function-1($map, $args...) {
+    $value: __this('value');
+    $key: __this('key');
+
+    @return __is-truthy($map)
+    and map-has-key($map, $key)
+    and $value == __get($map, $key);
+}
+
+
+@function __base-matches-function-2($map, $args...) {
+    @return __base-is-match(
+        $map,
+        __this('props'),
+        __this('values'),
+        __this('strict-compare-flags'));
+}
+
+
+@function __base-matches($source, $is-cloned: false) {
+    $props: map-keys($source);
+    $length: length($props);
+    $_: __scope();
+
+    @if ($length == 1) {
+        $key: nth($props, 1);
+        $value: __get($source, $key);
+        $_: __this('key', $key);
+        $_: __this('value', $value);
+
+        @if (__is-strict-comparable($value)) {
+            $result: __bind('__base-matches-function-1');
+            $_: __scope(false);
+
+            @return $result;
+        }
+    }
+
+    $values: (); // list
+    $strict-compare-flags: (); // list
+
+    @while ($length > 0) {
+        $value: __get($source, nth($props, $length));
+        $values: __set($values, $length, $value);
+        $strict-compare-flags: __set($strict-compare-flags, $length, __is-strict-comparable($value));
+        $length: $length - 1;
+    }
+
+    $values: __to-list($values);
+    $strict-compare-flags: __to-list($strict-compare-flags);
+    $_: __this('props', $props);
+    $_: __this('values', $values);
+    $_: __this('strict-compare-flags', $strict-compare-flags);
+    $result: __bind('__base-matches-function-2');
+    $_: __scope(false);
+
+    @return $result;
+}
+
+
+@function __matches($source) {
+    @return __base-matches($source, true);
+}
+
+
+/// Creates a function which performs a deep comparison between a given map
+/// and `source`, returning `true` if the given map has equivalent property
+/// values, else `false`.
+///
+///
+/// @access public
+/// @group Utility
+/// @param {Map} $source The map of property values to match.
+/// @returns {Function} Returns the new function.
+/// @example scss
+/// $users: (
+///   ( 'user': 'barney', 'age': 36, 'active': true ),
+///   ( 'user': 'fred',   'age': 40, 'active': false )
+/// );
+/// $foo: _filter($users, _matches(( 'age': 40, 'active': false )));
+/// // => (( 'user': 'fred', 'age': 40, 'active': false ),)
+
+@function _matches($args...) {
+    @return call('__matches', $args...);
+}

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

@@ -0,0 +1,105 @@
+$__memoized__: () !global;
+
+@function __memoize-memoized($arguments...) {
+    $func: __this('func');
+    $resolver: __this('resolver');
+    $key: __exec($resolver, $arguments...);
+    $cached-value: __get($__memoized__, $func $key);
+
+    @if $cached-value == null {
+        $cached-value: __exec($func, $arguments...);
+        $__memoized__: __set($__memoized__, $func $key, $cached-value) !global;
+    }
+
+    @return $cached-value;
+}
+
+@function __memoize($func, $resolver: __identity) {
+    $_: __scope(('func': $func, 'resolver': $resolver));
+    $memoized: __bind('__memoize-memoized');
+    $_: __scope(false);
+
+    @return $memoized;
+}
+
+@function __memo($context, $key: $__undefined__, $value: $__undefined__) {
+    // Get the memos from context
+    @if __is-undefined($key) and __is-undefined($value) {
+        @return __get($__memoized__, $context);
+    }
+
+    // Get the memo
+    @if __is-undefined($value) {
+        @return __get($__memoized__, $context $key);
+    }
+
+    // Set the memo
+    $__memoized__: __set($__memoized__, $context $key, $value) !global;
+
+    @return true;
+}
+
+///
+/// Creates a function that memoizes the result of `$func`. If `$resolver` is
+/// provided, it determines the cache key for storing the result based on the
+/// arguments provided to the memoized function. By default, the first argument
+/// provided to the memoized function is coerced to a string and used as the
+/// cache key. The `$func` is invoked with the `_this` binding of the memoized
+/// function.
+///
+///
+/// @access public
+/// @group Function
+/// @param {Function} $func The function to have its output memoized.
+/// @param {Function} $resolver [_identity] The function to resolve the cache key.
+/// @returns {Function} Returns the new memoizing function.
+/// @example scss
+///
+/// $uppercase: _memoize(to-upper-case);
+///
+/// $foo: _exec($uppercase, 'fred');
+/// // => 'FRED'
+///
+/// // modifying the result cache
+/// $mod: _memo(to-upper-case, 'fred', 'BARNEY');
+/// $foo: _exec($uppercase, 'fred');
+/// // => 'BARNEY'
+///
+/// // using a `$resolver`
+///   @function greet($name) {
+///     @return 'Hello, ' + $name;
+///   }
+///   
+///   $greet-memoized: _memoize(greet, to-upper-case);
+///   
+///   $foo: _exec($greet-memoized, 'Fred');
+///   // => 'Hello, Fred'
+///   
+///   $foo: _exec($greet-memoized, 'FRED');
+///   // => 'Hello, Fred' (since 'Fred' and 'FRED' resolve to 'FRED');
+
+@function _memoize($args...) {
+    @return call('__memoize', $args...);
+}
+
+
+///
+/// Gets or sets a memo in the Sassdash memo cache, based on the `$context` where
+/// the memo is being queried from (usually a function).
+/// 
+/// 
+/// @access public
+/// @group Function
+/// @param {String|Function} $context - The memo context.
+/// @param {*} $key [undefined] - The memo key to get or set.
+/// @param {*} $value [undefined] - The value to set the key in the memo
+/// context to, if provided.
+/// @returns {*} Returns memo map if only context is provided, memo value
+/// if context and key are provided, and sets the memo and returns true
+/// if context, key, and value are provided.
+/// @example scss
+/// // todo
+
+@function _memo($args...) {
+    @return call('__memo', $args...);
+}

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

@@ -0,0 +1,148 @@
+@function __base-merge-deep($map, $source, $key, $merge-function, $customizer, $stack-a: (), $stack-b: ()) {
+    $length: length($stack-a);
+    $src-value: __get($source, $key);
+
+    @while $length > 0 {
+        @if __is-equal(nth($stack-a, $length), $src-value) {
+            $map: __set($map, $key, nth($stack-b, $length));
+
+            @return $map;
+        }
+
+        $length: $length - 1;
+    }
+
+    $value: __get($map, $key);
+    $result: if($customizer,
+        __exec($customizer, $value, $src-value, $key, $map, $source),
+        $__undefined__);
+    $is-common: __is-undefined($result);
+
+    @if $is-common {
+        $result: $src-value;
+
+        @if __is-list($src-value) {
+            $result: if(__is-list($value),
+                $value,
+                __either($value, ()));
+        } @else if __is-plain-map($src-value) or __is-arglist($src-value) {
+            $result: if(__is-arglist($value),
+                __to-map($value),
+                if(__is-plain-map($value), $value, ()));
+        } @else {
+            $is-common: false;
+        }
+    }
+
+    $stack-a: append($stack-a, $src-value);
+    $stack-b: append($stack-b, $result);
+
+    @if $is-common {
+        $_: __this('map', __set($map, $key, __exec($merge-function, $result, $src-value, $customizer, $stack-a, $stack-b)));
+    } @else if not __is-equal($result, $value) {
+        $_: __this('map', __set($map, $key, $result));
+    }
+
+    @return __this('map');
+}
+
+
+@function __base-merge-function($src-value, $key, $source) {
+    $map: __this('map');
+    $customizer: __this('customizer');
+    $stack-a: __this('stack-a');
+    $stack-b: __this('stack-b');
+    $is-source-list: __this('is-source-list');
+
+    @if __is-map-like($src-value) {
+        $base-merge-deep: __bind('__base-merge-deep');
+
+        @return __exec($base-merge-deep, $map, $source, $key, __base-merge, $customizer, $stack-a, $stack-b);
+    }
+
+    $value: __get($map, $key);
+    $result: if($customizer,
+        __exec($customizer, $value, $src-value, $key, $map, $source),
+        $__undefined__);
+    $is-common: __is-undefined($result);
+
+    @if $is-common {
+        $result: $src-value;
+    }
+
+    @if ($is-source-list or not __is-undefined($result))
+    and ($is-common or not __is-equal($result, $value)) {
+        $map: __this('map', __set($map, $key, $result));
+    }
+
+    @return true;
+}
+
+
+@function __base-merge($map, $source, $customizer: null, $stack-a: (), $stack-b: ()) {
+    @if not __is-map-like($map) {
+        @return $map;
+    }
+
+    $is-source-list: __is-list($source);
+    $func: if($is-source-list, '__list-each', '__base-for-own');
+    $_: __scope((
+        'map': $map,
+        'customizer': $customizer,
+        'stack-a': $stack-a,
+        'stack-b': $stack-b,
+        'is-source-list': $is-source-list
+    ));
+    $base-merge-function: __bind('__base-merge-function');
+    $_: __exec($func, $source, $base-merge-function);
+    $map: __this('map');
+    $_: __scope(false);
+
+    @return $map;
+}
+
+
+@function __list-merge($list, $source, $customizer: null) {
+    // todo
+}
+
+
+@function __merge($arguments...) {
+    $assigner: __create-assigner('__base-merge');
+
+    @return __exec($assigner, $arguments...);
+}
+
+
+/// Recursively merges own enumerable properties of the source map(s), that
+/// don't resolve to `undefined` into the destination map. Subsequent sources
+/// overwrite property assignments of previous sources. If `$customizer` is
+/// provided, it is invoked to produce the merged values of the destination and
+/// source properties. If `$customizer` returns `undefined` merging is handled
+/// by the method instead. The `$customizer` is bound to `$this-arg` and invoked
+/// with five arguments; (source-value, other-value, key, map, source).
+///
+///
+/// @access public
+/// @group Map
+/// @param {Map} $map The destination map.
+/// @param {Map...} $source... The source maps.
+/// @param {Function} $customizer [null] The function to customize merging properties.
+/// @param {*} $this-arg [null] - The `_this` binding of `$customizer`.
+/// @returns {Map} Returns `map`.
+/// @example scss
+/// $users: (
+///   'data': (( 'user': 'barney' ), ( 'user': 'fred' ))
+/// );
+/// $ages: (
+///   'data': (( 'age': 36 ), ( 'age': 40 ))
+/// );
+/// $foo: _merge($users, ages);
+/// // => ( 'data': (( 'user': 'barney', 'age': 36 ), ( 'user': 'fred', 'age': 40 )) )
+/// 
+/// // using a customizer callback
+/// // todo
+
+@function _merge($args...) {
+    @return call('__merge', $args...);
+}

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

@@ -0,0 +1,17 @@
+
+
+@function __modify($map, $properties, $function: '__identity', $this-arg: null) {
+  $value: __get($map, $properties);
+
+  $function: __get-callback($function, $this-arg, 3);
+
+  $result: __exec($function, $value, $properties, $map);
+
+  $map: __set($map, $properties, $result);
+
+  @return $map;
+}
+
+@function _modify($args...) {
+  @return call('__modify', $args...);
+}