susy 1.0.9 → 2.2.14

data/sass/susy/output/support/_prefix.scss

@@ -0,0 +1,19 @@
+// Susy Prefix
+// ===========
+
+// Prefix
+// ------
+// Output simple prefixed properties.
+// - $prop      : <css property>
+// - $val       : <css value>
+// - [$prefix]  : <browser prefix list>
+@mixin susy-prefix(
+  $prop,
+  $val,
+  $prefix: official
+) {
+  @each $fix in $prefix {
+    $fix: if($fix == official or not($fix), $prop, '-#{$fix}-#{$prop}');
+    @include susy-rem($fix, $val);
+  }
+}

data/sass/susy/output/support/_rem.scss

@@ -0,0 +1,22 @@
+// rem Support
+// ===========
+
+// rem
+// ---
+// Check for an existing support mixin, or output directly.
+// - $prop  : <css property>
+// - $val   : <css value>
+@mixin susy-rem(
+  $prop,
+  $val
+) {
+  $_reqs: (
+    variable: rhythm-unit rem-with-px-fallback,
+    mixin: rem,
+  );
+  @if susy-support(rem, $_reqs, $warn: false) and $rhythm-unit == rem {
+    @include rem($prop, $val);
+  } @else {
+    #{$prop}: $val;
+  }
+}

data/sass/susy/output/support/_support.scss

@@ -0,0 +1,95 @@
+// Browser Support
+// ===============
+
+// Susy Support Defaults
+// ---------------------
+@include susy-defaults((
+  use-custom: (
+    clearfix: false,
+    background-image: true,
+    background-options: false,
+    breakpoint: true,
+    box-sizing: true,
+    rem: true,
+  ),
+));
+
+
+// Susy Support [mixin]
+// --------------------
+// Send property-value pairs to the proper support modules.
+// - $prop  : <css property>
+// - $val   : <css value>
+@mixin susy-support(
+  $prop,
+  $val
+) {
+  // Background Support
+  @if $prop == background-image {
+    @include susy-background-image($val);
+  } @else if $prop == background-size {
+    @include susy-background-size($val);
+  } @else if $prop == background-origin {
+    @include susy-background-origin($val);
+  } @else if $prop == background-clip {
+    @include susy-background-clip($val);
+  }
+
+  // Box-Sizing Support
+  @else if $prop == box-sizing {
+    @include susy-box-sizing($val);
+  }
+
+  // Rem Support
+  @else {
+    @include susy-rem($prop, $val);
+  }
+}
+
+
+// Susy Support [function]
+// -----------------------
+// Check for support of a feature.
+// - $feature       : <string>
+//                    - e.g "rem" or "box-sizing"
+// - $requirements  : <map>
+//                    - e.g (variable: rem-with-px-fallback, mixin: rem)
+// - $warn          : <bool>
+@function susy-support(
+  $feature,
+  $requirements: (),
+  $warn: true
+) {
+  $_support: susy-get(use-custom $feature);
+
+  @if $_support {
+    $_fail: false;
+
+    @each $_type, $_req in $requirements {
+      @each $_i in $_req {
+
+        $_pass : null;
+
+        // sass 3.5 or greater
+        @if function-exists('get-function') {
+          $_pass: call(get-function(unquote("#{$_type}-exists")), $_i);
+        }
+        // sass 3.4 or less
+        @else {
+          $_pass: call(unquote("#{$_type}-exists"), $_i);
+        }
+
+        @if not($_pass) {
+          $_fail: true;
+          @if $warn {
+            @warn "You requested custom support of #{$feature}, but the #{$_i} #{$_type} is not available.";
+          }
+        }
+      }
+    }
+
+    $_support: if($_fail, false, $_support);
+  }
+
+  @return $_support;
+}

data/sass/susy/su/_grid.scss

@@ -0,0 +1,103 @@
+// Column math
+// ===========
+
+
+// Is Symmetrical
+// --------------
+// Returns true if a grid is symmetrical.
+// - [$columns]   : <number> | <list>
+@function is-symmetrical(
+  $columns: susy-get(columns)
+) {
+  $columns: valid-columns($columns);
+  @return if(type-of($columns) == number, $columns, null);
+}
+
+
+// Susy Count
+// ----------
+// Find the number of columns in a given layout
+// - [$columns]   : <number> | <list>
+@function susy-count(
+  $columns: susy-get(columns)
+) {
+  $columns: valid-columns($columns);
+  @return is-symmetrical($columns) or length($columns);
+}
+
+
+// Susy Sum
+// --------
+// Find the total sum of column-units in a layout
+// - [$columns]   : <number> | <list>
+// - [$gutters]   : <ratio>
+// - [$spread]    : false/narrow | wide | wider
+@function susy-sum(
+  $columns  : susy-get(columns),
+  $gutters  : susy-get(gutters),
+  $spread   : false
+) {
+  $columns: valid-columns($columns);
+  $gutters: valid-gutters($gutters);
+
+  $spread: if($spread == wide, 0, if($spread == wider, 1, -1));
+  $gutter-sum: (susy-count($columns) + $spread) * $gutters;
+  $column-sum: is-symmetrical($columns);
+
+  @if not($column-sum) {
+    @each $column in $columns {
+      $column-sum: ($column-sum or 0) + $column;
+    }
+  }
+
+  @return $column-sum + $gutter-sum;
+}
+
+
+// Susy Slice
+// ----------
+// Return a subset of columns at a given location.
+// - $span        : <number>
+// - $location    : <number>
+// - [$columns]   : <number> | <list>
+@function susy-slice(
+  $span,
+  $location,
+  $columns: susy-get(columns)
+) {
+  $columns: valid-columns($columns);
+  $sub-columns: $span;
+
+  @if not(is-symmetrical($columns)) {
+    $location: $location or 1;
+    $sub-columns: ();
+    @for $i from $location to ($location + $span) {
+      $sub-columns: append($sub-columns, nth($columns, $i));
+    }
+  }
+
+  @return $sub-columns;
+}
+
+
+// Susy
+// ----
+// Find the sum of a column-span.
+// - $span        : <number>
+// - $location    : <number>
+// - [$columns]   : <number> | <list>
+// - [$gutters]   : <ratio>
+// - [$spread]    : false/narrow | wide | wider
+@function susy(
+  $span,
+  $location     : false,
+  $columns      : susy-get(columns),
+  $gutters      : susy-get(gutters),
+  $spread       : false
+) {
+  $columns: valid-columns($columns);
+  $gutters: valid-gutters($gutters);
+  $span: susy-slice($span, $location, $columns);
+
+  @return susy-sum($span, $gutters, $spread);
+}

data/sass/susy/su/_settings.scss

@@ -0,0 +1,73 @@
+// Settings
+// ========
+
+// Version
+// -------
+$su-version: 1.1;
+
+
+// Default Settings
+// ----------------
+// PRIVATE: The basic settings
+$susy-defaults: (
+  columns: 4,
+  gutters: .25,
+);
+
+
+// User Settings
+// -------------
+// - Define the $susy variable with a map of your own settings.
+// - Set EITHER $column-width OR $container
+// - Use $column-width for static layouts
+$susy: () !default;
+
+
+// Susy Defaults
+// -------------
+// PRIVATE: Add defaults to Susy
+@mixin susy-defaults(
+  $defaults
+) {
+  $susy-defaults: map-merge($susy-defaults, $defaults) !global;
+}
+
+
+// Susy Set
+// --------
+// Change one setting
+// - $key   : setting name
+// - $value : setting value
+@mixin susy-set(
+  $key-value...
+) {
+  $susy: _susy-deep-set($susy, $key-value...) !global;
+}
+
+
+// Susy Get
+// --------
+// Return one setting from a grid
+// - $key     : <keyword>
+// - $layout  : <settings>
+@function susy-get(
+  $key,
+  $layout: map-merge($susy-defaults, $susy)
+) {
+  $layout: parse-grid($layout);
+  $_options: $layout $susy $susy-defaults;
+  $_break: false;
+  $_return: null;
+
+  @each $opt in $_options {
+    @if type-of($opt) == map and not($_break) {
+      $_keyset: _susy-deep-has-key($opt, $key...);
+      @if $_keyset {
+        $_return: _susy-deep-get($opt, $key...);
+        $_break: true;
+      }
+    }
+  }
+
+  @return $_return;
+}

data/sass/susy/su/_utilities.scss

@@ -0,0 +1,111 @@
+// Map Functions
+// =============
+
+
+// Truncate List
+// -------------
+// - Return a list, truncated to a given length
+@function _susy-truncate-list(
+  $list,
+  $length
+) {
+  $_return: ();
+
+  @for $i from 1 through length($list) {
+    $_return: if($i <= $length, append($_return, nth($list, $i)), $_return);
+  }
+
+  @return $_return;
+}
+
+
+// Deep Get
+// --------
+// - Return a value deep in nested maps
+@function _susy-deep-get(
+  $map,
+  $keys...
+) {
+  $_return: $map;
+
+  @each $key in $keys {
+    @if type-of($_return) == map {
+      $_return: map-get($_return, $key);
+    }
+  }
+
+  @return $_return;
+}
+
+
+// Deep Set
+// --------
+// - Set a value deep in nested maps
+@function _susy-deep-set(
+  $map,
+  $keys-value...
+) {
+  $_value: nth($keys-value, -1);
+  $_keys: _susy-truncate-list($keys-value, length($keys-value) - 1);
+  $_length: length($_keys);
+  $_return: ();
+
+  @for $i from 1 through $_length {
+    $_n: 0 - $i;
+    $_level: _susy-truncate-list($_keys, $_length + $_n);
+    $_level: _susy-deep-get($map, $_level...);
+    $_merge: nth($_keys, $_n);
+    $_merge: ($_merge: $_value);
+    $_return: if($_level, map-merge($_level, $_merge), $_merge);
+    $_value: $_return;
+  }
+
+  @return $_return;
+}
+
+
+// Deep Merge
+// ----------
+// Return 2 objects of any depth, merged
+@function _susy-deep-merge(
+  $map1,
+  $map2
+) {
+
+  @if type-of($map1) != map or type-of($map2) != map {
+    $map1: $map2;
+  } @else {
+    @each $key, $value in $map2 {
+      $_new: ($key: _susy_deep-merge(map-get($map1, $key), $value));
+      $map1: map-merge($map1, $_new);
+    }
+  }
+
+  @return $map1;
+}
+
+
+// Deep Has-Key
+// ------------
+// - Return true if a deep key exists
+@function _susy-deep-has-key(
+  $map,
+  $keys...
+) {
+  $_return: null;
+  $_stop: false;
+
+  @each $key in $keys {
+    @if not($_stop) {
+      $_return: map-has-key($map, $key);
+    }
+
+    @if $_return {
+      $map: map-get($map, $key);
+    } @else {
+      $_stop: true;
+    }
+  }
+
+  @return $_return;
+}

data/sass/susy/su/_validation.scss

@@ -0,0 +1,57 @@
+// Math Validation
+// ===============
+
+
+// Valid Columns
+// -------------
+// Check that a column setting is valid.
+@function valid-columns(
+  $columns,
+  $silent: false
+) {
+  $type: type-of($columns);
+  $return: null;
+
+  @if $type == number and unitless($columns) {
+    $return: $columns;
+  } @else if $type == list {
+    $fail: null;
+    @each $col in $columns {
+      @if type-of($col) == number {
+        $fail: $fail or if(unitless($col), null, true);
+      } @else {
+        $fail: true;
+      }
+    }
+    $return: if($fail, $return, $columns);
+  }
+
+  @if $return != $columns and not($silent) {
+    $return: null;
+    $warn: '$columns must be a unitless number or list of unitless numbers.';
+    @warn $warn + ' Current value [#{$type}]: #{$columns}';
+  }
+
+  @return $return;
+}
+
+
+// Valid Gutters
+// -------------
+// Check that a gutter setting is valid.
+@function valid-gutters(
+  $gutters,
+  $silent: false
+) {
+  $type: type-of($gutters);
+  $return: null;
+
+  @if $type == number and unitless($gutters) {
+    $return: $gutters;
+  } @else if not($silent) {
+    $warn: '$gutters must be a unitless number.';
+    @warn $warn + ' Current value [#{$type}]: #{$gutters}';
+  }
+
+  @return $return;
+}