susy 1.0.9 → 2.2.14

data/sass/susy/language/susy/_context.scss

@@ -0,0 +1,36 @@
+// Context Syntax
+// ==============
+
+// Nested [function]
+// -----------------
+// Return a subset grid for nested context.
+// - $context   : <span>
+@function nested(
+  $context
+) {
+  $context    : parse-span($context);
+  $span       : susy-get(span, $context);
+  $location   : get-location($context);
+  $columns    : susy-get(columns, $context);
+
+  @return susy-slice($span, $location, $columns);
+}
+
+// Nested [mixin]
+// --------------
+// Use a subset grid for a nested context
+// - $context   : <span>
+// - @content   : <content>
+@mixin nested(
+  $context
+) {
+  $inspect  : $context;
+  $context  : parse-span($context);
+  $old      : susy-get(columns);
+  $susy     : map-merge($susy, (columns: nested($context))) !global;
+
+  @include susy-inspect(nested, $inspect);
+  @content;
+
+  $susy     : map-merge($susy, (columns: $old)) !global;
+}

data/sass/susy/language/susy/_gallery.scss

@@ -0,0 +1,94 @@
+// Gallery Syntax
+// ==============
+
+// Gallery
+// -------
+// Create an isolated gallery
+// - $span        : <span>
+// - [$selector]  : child | of-type
+@mixin gallery(
+  $span,
+  $selector: child
+) {
+  $inspect    : $span;
+  $span       : parse-span($span);
+  $span       : map-merge($span, (location: 1));
+
+  $n            : susy-get(span, $span);
+  $columns      : susy-get(columns, $span);
+  $context      : susy-count($columns);
+  $flow         : susy-get(flow, $span);
+
+  $inside       : is-inside($span);
+  $from         : from($flow);
+  $line         : floor($context / $n);
+  $symmetrical  : is-symmetrical($columns);
+
+  $output: (
+    width             : null,
+    float             : from,
+    margin-before     : null,
+    margin-after      : null,
+    padding-before    : null,
+    padding-after     : null,
+    flow              : $flow,
+  );
+
+  @if $inside {
+    $gutters: get-gutters($span);
+    $output: map-merge($output, (
+      padding-before: map-get($gutters, before),
+      padding-after: map-get($gutters, after),
+    ));
+  }
+
+  @if $symmetrical {
+    $output: map-merge($output, (width: get-span-width($span)));
+  }
+
+  $box          : susy-get(box-sizing, $span);
+  $global-box   : if(susy-get(global-box-sizing) == 'border-box', true, false);
+
+  @include susy-inspect(gallery, $inspect);
+
+  // Collective Output
+  @if $box == border-box or ($inside and not($box) and not($global-box)) {
+    @include output((box-sizing: border-box));
+  } @else if $box == content-box {
+    @include output((box-sizing: content-box));
+  }
+
+  @include float-span-output($output...);
+
+  // Individual Loop
+  @for $item from 1 through $line {
+    $nth: '#{$line}n + #{$item}';
+    &:nth-#{$selector}(#{$nth}) {
+      // Individual Prep
+      $output: (
+        width             : if($symmetrical, null, get-span-width($span)),
+        float             : null,
+        margin-before     : get-isolation($span),
+        margin-after      : -100%,
+        padding-before    : null,
+        padding-after     : null,
+        flow              : $flow,
+      );
+
+      // Individual Output
+      @include float-span-output($output...);
+
+      @if get-edge($span) == first {
+        @include break;
+        @include first($span);
+      } @else {
+        @include nobreak;
+      }
+
+      // Individual Location Increment
+      $location: get-location($span) + $n;
+      $location: if($location > $context, 1, $location);
+      $span: map-merge($span, (location: $location));
+    }
+  }
+}

data/sass/susy/language/susy/_grids.scss

@@ -0,0 +1,64 @@
+// Grid Syntax
+// ===========
+
+
+// Layout
+// ------
+// Set a new layout using a shorthand
+// - $layout: <settings>
+// - $clean: boolean
+@mixin layout(
+  $layout,
+  $clean: false
+) {
+  $inspect  : $layout;
+  $susy     : _get-layout($layout, $clean) !global;
+
+  @include susy-inspect(layout, $inspect);
+}
+
+
+// Use Grid
+// --------
+// Use an arbitrary layout for a section of code
+// - $layout: <settings>
+// - $clean: boolean
+@mixin with-layout(
+  $layout,
+  $clean: false
+) {
+  $inspect  : $layout;
+  $old      : $susy;
+  $susy     : _get-layout($layout, $clean) !global;
+
+  @include susy-inspect(with-layout, $inspect);
+
+  @content;
+
+  $susy: $old !global;
+}
+
+
+// Layout
+// ------
+// Return a parsed layout map based on shorthand syntax
+// - $layout: <settings>
+@function layout(
+  $layout: $susy
+) {
+  @return parse-grid($layout);
+}
+
+
+// Get Layout
+// ----------
+// Return a new layout based on current and given settings
+// - $layout: <settings>
+// - $clean: boolean
+@function _get-layout(
+  $layout,
+  $clean: false
+) {
+  $layout: layout($layout);
+  @return if($clean, $layout, _susy-deep-merge($susy, $layout));
+}

data/sass/susy/language/susy/_gutters.scss

@@ -0,0 +1,154 @@
+// Gutter Syntax
+// =============
+
+
+// Gutters
+// -------
+// Set gutters on an element.
+// - [$span]   : <settings>
+@mixin gutters(
+  $span: $susy
+) {
+  $inspect  : $span;
+  $span     : parse-gutters($span);
+  $_gutters : get-gutters($span);
+
+  $_output: (
+    before: map-get($_gutters, before),
+    after: map-get($_gutters, after),
+    flow: susy-get(flow, $span),
+  );
+
+  @include susy-inspect(gutters, $inspect);
+
+  @if is-inside($span) {
+    @include padding-output($_output...);
+  } @else {
+    @include margin-output($_output...);
+  }
+}
+
+@mixin gutter(
+  $span: $susy
+) {
+  @include gutters($span);
+}
+
+
+// Gutter
+// ------
+// Return the width of a gutter.
+// - [$span]   : <settings>
+@function gutter(
+  $span: $susy
+) {
+  $span: parse-gutters($span);
+
+  $_gutters: get-gutters($span);
+  $_gutters: map-get($_gutters, before) or map-get($_gutters, after);
+
+  @return $_gutters;
+}
+
+@function gutters(
+  $span: $susy
+) {
+  @return gutter($span);
+}
+
+
+// Get Gutter Width
+// ----------------
+// Return gutter width.
+// - [$context]: <context>
+@function get-gutter-width(
+  $context: $susy
+) {
+  $context  : parse-gutters($context);
+
+  $_gutters : susy-get(gutters, $context);
+  $_gutter  : susy-get(gutter-override, $context);
+
+  @if $_gutters and ($_gutters > 0) and not($_gutter) {
+    $_column-width: susy-get(column-width, $context);
+    $_math: gutter-math($context);
+    @if $_math == static {
+      $_gutter: $_gutters * valid-column-math($_math, $_column-width);
+    } @else {
+      $_columns : susy-get(columns, $context);
+      $_spread  : if(is-split($context), wide, susy-get(spread, $context));
+      $_gutter  : percentage($_gutters / susy-sum($_columns, $_gutters, $_spread));
+    }
+  }
+
+  $_gutter: if($_gutter == 'no-gutters' or $_gutter == 'no-gutter', null, $_gutter);
+
+  @return $_gutter;
+}
+
+
+// Get Gutters
+// -----------
+// Return before and after gutter values.
+// - [$context]: <context>
+@function get-gutters(
+  $context: $susy
+) {
+  $context            : parse-gutters($context);
+
+  $_gutter-position   : susy-get(gutter-position, $context);
+  $_gutter            : get-gutter-width($context);
+
+  $_return            : (before: null, after: null);
+
+  @if is-split($context) and $_gutter {
+    $_gutter: $_gutter / 2;
+    $_return: map-merge($_return, (before: $_gutter, after: $_gutter));
+  } @else {
+    $_return: map-merge($_return, ($_gutter-position: $_gutter));
+  }
+
+  @return $_return;
+}
+
+
+// Is Inside
+// ---------
+// Returns true if gutters are inside.
+// $context: <context>
+@function is-inside(
+  $context
+) {
+  $_inside: inside inside-static;
+  $_gutter-position: susy-get(gutter-position, $context);
+
+  @return if(index($_inside, $_gutter-position), true, false);
+}
+
+
+// Is Split
+// --------
+// Returns true if gutters are split.
+// $context: <context>
+@function is-split(
+  $context
+) {
+  $_split: split inside inside-static;
+  $_gutter-position: susy-get(gutter-position, $context);
+
+  @return if(index($_split, $_gutter-position), true, false);
+}
+
+
+// Gutter Math
+// -----------
+// Return the math to use for gutter calculations
+// $context: <context>
+@function gutter-math(
+  $context: $susy
+) {
+  $_return  : susy-get(math, $context);
+  $_return  : if(susy-get(gutter-position, $context) == inside-static, static, $_return);
+
+  @return $_return;
+}

data/sass/susy/language/susy/_isolate.scss

@@ -0,0 +1,77 @@
+// Isolation Syntax
+// ================
+
+
+// Isolate [Mixin]
+// ---------------
+// Set isolation as an override.
+// - $location: <span>
+@mixin isolate(
+  $isolate: 1
+) {
+  $inspect: $isolate;
+
+  $output: (
+    push: isolate($isolate),
+    flow: susy-get(flow, $isolate),
+  );
+
+  @include susy-inspect(isolate, $inspect);
+  @include isolate-output($output...);
+}
+
+
+// Isolate [function]
+// ------------------
+// Return an isolation offset width.
+// - $location: <span>
+@function isolate(
+  $isolate: 1
+) {
+  $isolate: parse-span($isolate);
+  $isolation: susy-get(span, $isolate);
+
+  @if $isolation and not(get-location($isolate)) {
+    $new: (
+      span: null,
+      location: $isolation,
+    );
+    $isolate: map-merge($isolate, $new);
+  }
+
+  @return get-isolation($isolate);
+}
+
+
+// Get Isolation
+// -------------
+// Return the isolation offset width
+// - $input: <map>
+@function get-isolation(
+  $input
+) {
+  $location   : get-location($input);
+  $columns    : susy-get(columns, $input);
+  $width      : null;
+
+  @if type-of($location) == number and not(unitless($location)) {
+    $width: $location;
+  } @else if $location {
+    $push: $location - 1;
+    @if $push > 0 {
+      $push: map-merge($input, (
+        span: $push,
+        location: 1,
+        spread: wide,
+      ));
+      $width: get-span-width($push);
+    }
+  }
+
+  @if susy-get(gutter-position, $input) == split
+      and susy-get(gutters, $input) > 0 {
+    $width: if($width == null, gutters($input), $width + gutters($input));
+  }
+
+  @return $width or 0;
+}

data/sass/susy/language/susy/_margins.scss

@@ -0,0 +1,94 @@
+// Margin Syntax
+// =============
+
+// Pre
+// ---
+// Add spanning-margins before an element.
+// - $span  : <span>
+@mixin pre(
+  $span
+) {
+  $inspect: $span;
+  $span   : map-merge((spread: wide), parse-span($span));
+  $flow   : susy-get(flow, $span);
+  $split  : if(susy-get(gutter-position, $span) == split, true, false);
+  $gutter : gutter($span);
+  $span   : span($span);
+  $width  : if($split and $gutter, $span + $gutter, $span);
+
+  @include susy-inspect(pre, $inspect);
+  @include margin-output($width, null, $flow);
+}
+
+// Post
+// ----
+// Add spanning-margins after an element.
+// - $span  : <span>
+@mixin post(
+  $span
+) {
+  $inspect  : $span;
+  $span     : map-merge((spread: wide), parse-span($span));
+  $flow     : susy-get(flow, $span);
+  $split    : if(susy-get(gutter-position, $span) == split, true, false);
+  $width    : if($split, span($span) + gutter($span), span($span));
+
+  @include susy-inspect(post, $inspect);
+  @include margin-output(null, $width, $flow);
+}
+
+// Push
+// ----
+// Simple synonymn for pre.
+// - $span  : <span>
+@mixin push(
+  $span
+) {
+  @include pre($span);
+}
+
+// Pull
+// ----
+// Add negative spanning-margins before an element.
+// - $span  : <span>
+@mixin pull(
+  $span
+) {
+  $inspect  : $span;
+  $span     : map-merge((spread: wide), parse-span($span));
+  $flow     : susy-get(flow, $span);
+  $split    : if(susy-get(gutter-position, $span) == split, true, false);
+  $width    : if($split, 0 - span($span) + gutter($span), 0 - span($span));
+
+  @include susy-inspect(pull, $inspect);
+  @include margin-output($width, null, $flow);
+}
+
+// Squish
+// ------
+// Add spanning-margins before and after an element.
+// - $pre     : <span>
+// - [$post]  : <span>
+@mixin squish(
+  $pre,
+  $post: false
+) {
+  $inspect      : ($pre, $post);
+  $pre          : map-merge((spread: wide), parse-span($pre));
+
+  @if $post {
+    $post: map-merge((spread: wide), parse-span($post));
+  } @else {
+    $span: susy-get(span, $pre);
+    @if length($span) > 1 {
+      $pre: map-merge($pre, (span: nth($span, 1)));
+      $post: map-merge($pre, (span: nth($span, 2)));
+    } @else {
+      $post: $pre;
+    }
+  }
+
+  @include susy-inspect(squish, $inspect);
+  @include pre($pre);
+  @include post($post);
+}