neat 1.7.0.rc → 1.7.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA1:
-  metadata.gz: b996a39a49ee89437c9c66930f7fd860660e166e
-  data.tar.gz: 0e1980f94876d7b98af734c6fb440e15a276a402
+  metadata.gz: db2a532bbbdb4620bed5cec00f5cd12415dba74c
+  data.tar.gz: ef585a637c353915fc522398898eb8405972c650
 SHA512:
-  metadata.gz: 0a3492e5b9833cd55345dfd0637328b8321ee1990940f78a3467f149c06de28504f25240ffc94d4486cfe7386d8f7540dd59f0b8fa18b1d33dab056da627a38d
-  data.tar.gz: 4c2cda58fd79e13d074f61133304433bbc61ca19234d9193b400027dc6e822a18656c7130417f85cd7b1d661568c48291185e9feb80321980b1d1abd5fd3b2e2
+  metadata.gz: fed84c2941a6d114a2c9465fcdfb154a48ba720ff1730d8f26a6965b423e60bdfd67c7f29f02d1aabedda9faa1d5db855715a7b4cc0cdfed957831b9b8c1b010
+  data.tar.gz: 8312d8b07774daad044001744440db8136c8f567cb272535ea1402107bbb4b7797d64867952199ed15d1036f5e6b9c146d937ce4ca754150b1a97ee50c64ce24

data/.travis.yml

@@ -1,2 +1,5 @@
 language: ruby
 rvm: 2.0.0
+notifications:
+  slack:
+    secure: ROE+Zo+A6JmTjxCRGG539YaoEcLrsInEIrTDQMgtn5ucLaiPiau96VO+GJ4MyxZm2M5qlSRMFCxb3jFexCRVZctuUF2hFcXVi6a/+JGhMmYLd6XMNezhlxWwOoSx6ufSAlrlXEalsdnkzqVHuH2Y50ao/3slNo58DdLoaRJiGAc=

data/README.md

@@ -1,4 +1,4 @@
-[![Neat](http://neat.bourbon.io/images/logotype.svg)](http://neat.bourbon.io)
+<img src="http://neat.bourbon.io/images/logotype.svg" width="250" />
 
 [![Gem Version](http://img.shields.io/gem/v/neat.svg?style=flat)](https://rubygems.org/gems/neat) [![Travis](http://img.shields.io/travis/thoughtbot/neat.svg?style=flat)](https://travis-ci.org/thoughtbot/neat)
 [![Code Climate](http://img.shields.io/codeclimate/github/thoughtbot/neat.svg?style=flat)](https://codeclimate.com/github/thoughtbot/neat)
@@ -17,9 +17,9 @@ Neat is a fluid grid framework built on [Bourbon](http://bourbon.io) with the ai
 
 ## Requirements
 
-- [Sass](https://github.com/sass/sass) 3.3+
+- [Sass](https://github.com/sass/sass) 3.3+ ([Use Neat
+1.5.1](#installing-older-versions-of-neat) if you are still tied to Sass 3.2)
 - [Bourbon](https://github.com/thoughtbot/bourbon) 3.1+
-- :warning: If you are using Neat with **LibSass**, **sass-rails**, **Compass**, **Foundation** or need **Sass 3.2 support**, you should [use Neat 1.5.1](#installing-older-versions-of-neat).
 
 ## Installation
 
@@ -96,7 +96,7 @@ Neat uses the [RubyGems](https://rubygems.org) package manager to easily generat
 2. Reinstall the Neat gem, using the `-v` flag to specify the version you need:
 
   ```bash
-  gem install neat -v 1.5.1
+  gem install neat -v 1.7.0
   ```
 
 3. Follow the [instructions above](#installation) to install Neat into your project.
@@ -244,9 +244,13 @@ At this point, writing an internal rounding mechanism is not high priority.
 
 Unless you [open a pull request](https://github.com/thoughtbot/neat/compare/), the answer is most likely going to be no. Neat is lightweight and simple compared to other grid frameworks, and strives to remain so. We have plans for adding new features in future versions of the framework, but these will be most likely to support new ways of working with layouts on the Web, not patches to existing ones.
 
+## Documentation
+
+- [Full documentation](http://thoughtbot.github.io/neat-docs/latest/) (latest)
+- Neat documentation is now available by default in [Dash](http://kapeli.com/dash)
+
 ## Links
 
-- Add the docset to [Dash](http://kapeli.com/dash) 1.8+ (Preferences **>** Downloads **>** + *Add Docset Feed* **>** `http://neat.bourbon.io/docset/Neat.xml`)
 - Ask questions on [Stack Overflow](http://stackoverflow.com/questions/tagged/neat). Don’t forget to tag them `bourbon` and `neat`.
 - Suggest features or file bugs in [Issues](https://github.com/thoughtbot/neat/issues).
 - Join `#bourbon-neat` on `irc.freenode.net`.

data/app/assets/stylesheets/_neat.scss

@@ -1,4 +1,4 @@
-/* Neat 1.7.0.pre
+/* Neat 1.7.0
  * http://neat.bourbon.io
  * Copyright 2012-2014 thoughtbot, inc.
  * MIT License */

data/app/assets/stylesheets/functions/_new-breakpoint.scss

@@ -1,34 +1,37 @@
-/**
- * Returns a media context (media query / grid context) that can be stored in a variable and passed to `media()` as a single-keyword argument. Media contexts defined using `new-breakpoint` are used by the visual grid, as long as they are defined before importing Neat.
- *
- * @param {List} $query
- *   - A list of media query features and values. Each `$feature` should have a corresponding `$value`. If there is only a single `$value` in `$query`, `$default-feature` is going to be used. The number of total columns in the grid can be set by passing `$columns` at the end of the list (overrides `$total-columns`). For a list of valid values for `$feature`, click [here](http://www.w3.org/TR/css3-mediaqueries/#media1).
- *
- * @param {Number (unitless)} $total-columns ($grid-columns)
- *   - Number of columns to use in the new grid context. Can be set as a shorthand in the first parameter.
- *
- * @example scss - Usage
- *   $mobile: new-breakpoint(max-width 480px 4);
- *
- *   .element {
- *     @include media($mobile) {
- *       @include span-columns(4);
- *     }
- *   }
- *
- * @example css - CSS Output
- *   @media screen and (max-width: 480px) {
- *     .element {
- *       display: block;
- *       float: left;
- *       margin-right: 7.42297%;
- *       width: 100%;
- *     }
- *     .element:last-child {
- *       margin-right: 0;
- *     }
- *   }
- */
+/// Returns a media context (media query / grid context) that can be stored in a variable and passed to `media()` as a single-keyword argument. Media contexts defined using `new-breakpoint` are used by the visual grid, as long as they are defined before importing Neat.
+///
+/// @param {List} $query
+///   A list of media query features and values. Each `$feature` should have a corresponding `$value`.
+///
+///   If there is only a single `$value` in `$query`, `$default-feature` is going to be used.
+///
+///   The number of total columns in the grid can be set by passing `$columns` at the end of the list (overrides `$total-columns`). For a list of valid values for `$feature`, click [here](http://www.w3.org/TR/css3-mediaqueries/#media1).
+///
+/// @param {Number (unitless)} $total-columns ($grid-columns)
+///   - Number of columns to use in the new grid context. Can be set as a shorthand in the first parameter.
+///
+/// @example scss - Usage
+///   $mobile: new-breakpoint(max-width 480px 4);
+///
+///   .element {
+///     @include media($mobile) {
+///       @include span-columns(4);
+///     }
+///   }
+///
+/// @example css - CSS Output
+///   @media screen and (max-width: 480px) {
+///     .element {
+///       display: block;
+///       float: left;
+///       margin-right: 7.42297%;
+///       width: 100%;
+///     }
+///     .element:last-child {
+///       margin-right: 0;
+///     }
+///   }
+
 @function new-breakpoint($query: $feature $value $columns, $total-columns: $grid-columns) {
   @if length($query) == 1 {
     $query: $default-feature nth($query, 1) $total-columns;

data/app/assets/stylesheets/functions/_private.scss

@@ -34,7 +34,7 @@
 }
 
 @function container-shift($shift: $shift) {
-  $parent-columns: $grid-columns !global !default;
+  $parent-columns: $grid-columns !default !global;
 
   @if length($shift) == 3 {
     $container-columns: nth($shift, 3);

data/app/assets/stylesheets/grid/_direction-context.scss

@@ -1,22 +1,21 @@
-/**
- * Changes the direction property used by other mixins called in the code block argument.
- *
- * @param {String} $direction (left-to-right)
- *   Layout direction to be used within the block. Can be `left-to-right` or `right-to-left`.
- *
- * @example scss - Usage
- *   @include direction(right-to-left) {
- *    .right-to-left-block {
- *      @include span-columns(6);
- *     }
- *   }
- *
- * @example css - CSS Output
- *   .right-to-left-block {
- *     float: right;
- *      ...
- *   }
- */
+/// Changes the direction property used by other mixins called in the code block argument.
+///
+/// @param {String} $direction (left-to-right)
+///   Layout direction to be used within the block. Can be `left-to-right` or `right-to-left`.
+///
+/// @example scss - Usage
+///   @include direction(right-to-left) {
+///    .right-to-left-block {
+///      @include span-columns(6);
+///     }
+///   }
+///
+/// @example css - CSS Output
+///   .right-to-left-block {
+///     float: right;
+///      ...
+///   }
+
 @mixin direction-context($direction: left-to-right) {
   $scope-direction: $layout-direction;
 

data/app/assets/stylesheets/grid/_display-context.scss

@@ -1,22 +1,21 @@
-/**
- * Changes the display property used by other mixins called in the code block argument.
- *
- * @param {String} $display (block)
- *   Display value to be used within the block. Can be `table` or `block`.
- *
- * @example scss
- *   @include display(table) {
- *    .display-table {
- *      @include span-columns(6);
- *     }
- *   }
- *
- * @example css
- *   .display-table {
- *      display: table-cell;
- *      ...
- *   }
- */
+/// Changes the display property used by other mixins called in the code block argument.
+///
+/// @param {String} $display (block)
+///   Display value to be used within the block. Can be `table` or `block`.
+///
+/// @example scss
+///   @include display(table) {
+///    .display-table {
+///      @include span-columns(6);
+///     }
+///   }
+///
+/// @example css
+///   .display-table {
+///      display: table-cell;
+///      ...
+///   }
+
 @mixin display-context($display: block) {
   $scope-display: $container-display-table;
   $container-display-table: $display == table !global;

data/app/assets/stylesheets/grid/_fill-parent.scss

@@ -1,19 +1,18 @@
-/**
- * Forces the element to fill its parent container.
- *
- * @example scss - Usage
- *   .element {
- *     @include fill-parent;
- *   }
- *
- * @example css - CSS Output
- *   .element {
- *     width: 100%;
- *     -webkit-box-sizing: border-box;
- *     -moz-box-sizing: border-box;
- *     box-sizing: border-box;
- *   }
- */
+/// Forces the element to fill its parent container.
+///
+/// @example scss - Usage
+///   .element {
+///     @include fill-parent;
+///   }
+///
+/// @example css - CSS Output
+///   .element {
+///     width: 100%;
+///     -webkit-box-sizing: border-box;
+///     -moz-box-sizing: border-box;
+///     box-sizing: border-box;
+///   }
+
 @mixin fill-parent() {
   width: 100%;
 

data/app/assets/stylesheets/grid/_media.scss

@@ -1,58 +1,57 @@
-/**
- * Outputs a media-query block with an optional grid context (the total number of columns used in the grid).
- *
- * @param {List} $query
- *   A list of media query features and values, where each `$feature` should have a corresponding `$value`.
- *   For a list of valid values for `$feature`, click [here](http://www.w3.org/TR/css3-mediaqueries/#media1).
- *
- *   If there is only a single `$value` in `$query`, `$default-feature` is going to be used.
- *
- *   The number of total columns in the grid can be set by passing `$columns` at the end of the list (overrides `$total-columns`).
- *
- *
- * @param {Number (unitless)} $total-columns ($grid-columns)
- *   - Number of columns to use in the new grid context. Can be set as a shorthand in the first parameter.
- *
- * @example scss - Usage
- *   .responsive-element {
- *      @include media(769px) {
- *        @include span-columns(6);
- *      }
- *   }
- *
- *  .new-context-element {
- *    @include media(min-width 320px max-width 480px, 6) {
- *      @include span-columns(6);
- *    }
- *  }
- *
- * @example css - CSS Output
- *  @media screen and (min-width: 769px) {
- *    .responsive-element {
- *      display: block;
- *      float: left;
- *      margin-right: 2.35765%;
- *      width: 48.82117%;
- *    }
- *
- *    .responsive-element:last-child {
- *      margin-right: 0;
- *    }
- *  }
- *
- *  @media screen and (min-width: 320px) and (max-width: 480px) {
- *    .new-context-element {
- *      display: block;
- *      float: left;
- *      margin-right: 4.82916%;
- *      width: 100%;
- *    }
- *
- *    .new-context-element:last-child {
- *      margin-right: 0;
- *    }
- *  }
- */
+/// Outputs a media-query block with an optional grid context (the total number of columns used in the grid).
+///
+/// @param {List} $query
+///   A list of media query features and values, where each `$feature` should have a corresponding `$value`.
+///   For a list of valid values for `$feature`, click [here](http://www.w3.org/TR/css3-mediaqueries/#media1).
+///
+///   If there is only a single `$value` in `$query`, `$default-feature` is going to be used.
+///
+///   The number of total columns in the grid can be set by passing `$columns` at the end of the list (overrides `$total-columns`).
+///
+///
+/// @param {Number (unitless)} $total-columns ($grid-columns)
+///   - Number of columns to use in the new grid context. Can be set as a shorthand in the first parameter.
+///
+/// @example scss - Usage
+///   .responsive-element {
+///      @include media(769px) {
+///        @include span-columns(6);
+///      }
+///   }
+///
+///  .new-context-element {
+///    @include media(min-width 320px max-width 480px, 6) {
+///      @include span-columns(6);
+///    }
+///  }
+///
+/// @example css - CSS Output
+///  @media screen and (min-width: 769px) {
+///    .responsive-element {
+///      display: block;
+///      float: left;
+///      margin-right: 2.35765%;
+///      width: 48.82117%;
+///    }
+///
+///    .responsive-element:last-child {
+///      margin-right: 0;
+///    }
+///  }
+///
+///  @media screen and (min-width: 320px) and (max-width: 480px) {
+///    .new-context-element {
+///      display: block;
+///      float: left;
+///      margin-right: 4.82916%;
+///      width: 100%;
+///    }
+///
+///    .new-context-element:last-child {
+///      margin-right: 0;
+///    }
+///  }
+
 @mixin media($query: $feature $value $columns, $total-columns: $grid-columns) {
   @if length($query) == 1 {
     @media screen and ($default-feature: nth($query, 1)) {

data/app/assets/stylesheets/grid/_omega.scss

@@ -1,35 +1,34 @@
-/**
- * Removes the element's gutter margin, regardless of its position in the grid hierarchy or display property. It can target a specific element, or every `nth-child` occurrence. Works only with `block` layouts.
- *
- * @param {List} $query (block)
- *   List of arguments. Supported arguments are `nth-child` selectors (targets a specific pseudo element) and `auto` (targets `last-child`).
- *
- *   When passed an `nth-child` argument of type `*n` with `block` display, the omega mixin automatically adds a clear to the `*n+1` th element. Note that composite arguments such as `2n+1` do not support this feature.
- *
- *   **Deprecation warning**: The omega mixin will no longer take a `$direction` argument. To change the layout direction, use `row($direction)` or set `$default-layout-direction` instead.
- *
- * @example scss - Usage
- *   .element {
- *     @include omega;
- *   }
- *
- *   .nth-element {
- *     @include omega(4n);
- *   }
- *
- * @example css - CSS Output
- *   .element {
- *     margin-right: 0;
- *   }
- *
- *   .nth-element:nth-child(4n) {
- *     margin-right: 0;
- *   }
- *
- *   .nth-element:nth-child(4n+1) {
- *     clear: left;
- *   }
- */
+/// Removes the element's gutter margin, regardless of its position in the grid hierarchy or display property. It can target a specific element, or every `nth-child` occurrence. Works only with `block` layouts.
+///
+/// @param {List} $query (block)
+///   List of arguments. Supported arguments are `nth-child` selectors (targets a specific pseudo element) and `auto` (targets `last-child`).
+///
+///   When passed an `nth-child` argument of type `*n` with `block` display, the omega mixin automatically adds a clear to the `*n+1` th element. Note that composite arguments such as `2n+1` do not support this feature.
+///
+///   **Deprecation warning**: The omega mixin will no longer take a `$direction` argument. To change the layout direction, use `row($direction)` or set `$default-layout-direction` instead.
+///
+/// @example scss - Usage
+///   .element {
+///     @include omega;
+///   }
+///
+///   .nth-element {
+///     @include omega(4n);
+///   }
+///
+/// @example css - CSS Output
+///   .element {
+///     margin-right: 0;
+///   }
+///
+///   .nth-element:nth-child(4n) {
+///     margin-right: 0;
+///   }
+///
+///   .nth-element:nth-child(4n+1) {
+///     clear: left;
+///   }
+
 @mixin omega($query: block, $direction: default) {
   $table: belongs-to(table, $query);
   $auto: belongs-to(auto, $query);

data/app/assets/stylesheets/grid/_outer-container.scss

@@ -1,32 +1,31 @@
-/**
- * Makes an element a outer container by centring it in the viewport, clearing its floats, and setting its `max-width`.
- * Although optional, using `outer-container` is recommended. The mixin can be called on more than one element per page, as long as they are not nested.
- *
- * @param {Number (unit)} $local-max-width ($max-width)
- *   Max width to be applied to the element. Can be a percentage or a measure.
- *
- * @example scss - Usage
- *   .element {
- *     @include outer-container(100%);
- *   }
- *
- * @example css - CSS Output
- *   .element {
- *     *zoom: 1;
- *     max-width: 100%;
- *     margin-left: auto;
- *     margin-right: auto;
- *   }
- *
- *   .element:before, .element:after {
- *     content: " ";
- *     display: table;
- *   }
- *
- *   .element:after {
- *     clear: both;
- *   }
- */
+/// Makes an element a outer container by centring it in the viewport, clearing its floats, and setting its `max-width`.
+/// Although optional, using `outer-container` is recommended. The mixin can be called on more than one element per page, as long as they are not nested.
+///
+/// @param {Number (unit)} $local-max-width ($max-width)
+///   Max width to be applied to the element. Can be a percentage or a measure.
+///
+/// @example scss - Usage
+///   .element {
+///     @include outer-container(100%);
+///   }
+///
+/// @example css - CSS Output
+///   .element {
+///     *zoom: 1;
+///     max-width: 100%;
+///     margin-left: auto;
+///     margin-right: auto;
+///   }
+///
+///   .element:before, .element:after {
+///     content: " ";
+///     display: table;
+///   }
+///
+///   .element:after {
+///     clear: both;
+///   }
+
 @mixin outer-container($local-max-width: $max-width) {
   @include clearfix;
   max-width: $local-max-width;

data/app/assets/stylesheets/grid/_pad.scss

@@ -1,19 +1,18 @@
-/**
- * Adds padding to the element.
- *
- * @param {List} $padding (flex-gutter())
- *   A list of padding value(s) to use. Passing `default` in the list will result in using the gutter width as a padding value.
- *
- * @example scss - Usage
- *   .element {
- *     @include pad(30px -20px 10px default);
- *   }
- *
- * @example css - CSS Output
- *   .element {
- *     padding: 30px -20px 10px 2.35765%;
- *   }
- */
+/// Adds padding to the element.
+///
+/// @param {List} $padding (flex-gutter())
+///   A list of padding value(s) to use. Passing `default` in the list will result in using the gutter width as a padding value.
+///
+/// @example scss - Usage
+///   .element {
+///     @include pad(30px -20px 10px default);
+///   }
+///
+/// @example css - CSS Output
+///   .element {
+///     padding: 30px -20px 10px 2.35765%;
+///   }
+
 @mixin pad($padding: flex-gutter()) {
   $padding-list: null;
   @each $value in $padding {

data/app/assets/stylesheets/grid/_row.scss

@@ -1,32 +1,31 @@
-/**
- * Designates the element as a row of columns in the grid layout. It clears the floats on the element and sets its display property. Rows can't be nested, but there can be more than one row element—with different display properties—per layout.
- *
- * @param {String} $display (default)
- *   Sets the display property of the element and the display context that will be used by its children. Can be `block` or `table`.
- *
- * @param {String} $direction ($default-layout-direction)
- *   Sets the layout direction. Can be `LTR` (left-to-right) or `RTL` (right-to-left).
- *
- * @example scss - Usage
- *   .element {
- *     @include row();
- *   }
- *
- * @example css - CSS Output
- *   .element {
- *     *zoom: 1;
- *     display: block;
- *   }
- *
- *  .element:before, .element:after {
- *    content: " ";
- *    display: table;
- *  }
- *
- *  .element:after {
- *    clear: both;
- *  }
- */
+/// Designates the element as a row of columns in the grid layout. It clears the floats on the element and sets its display property. Rows can't be nested, but there can be more than one row element—with different display properties—per layout.
+///
+/// @param {String} $display (default)
+///  Sets the display property of the element and the display context that will be used by its children. Can be `block` or `table`.
+///
+/// @param {String} $direction ($default-layout-direction)
+///  Sets the layout direction. Can be `LTR` (left-to-right) or `RTL` (right-to-left).
+///
+/// @example scss - Usage
+///  .element {
+///    @include row();
+///  }
+///
+/// @example css - CSS Output
+///  .element {
+///    *zoom: 1;
+///    display: block;
+///  }
+///
+/// .element:before, .element:after {
+///   content: " ";
+///   display: table;
+/// }
+///
+/// .element:after {
+///   clear: both;
+/// }
+
 @mixin row($display: default, $direction: $default-layout-direction) {
   @if $direction != $default-layout-direction {
     @include -neat-warn("The $direction argument will be deprecated in future versions in favor of the direction(){...} mixin.");

data/app/assets/stylesheets/grid/_shift.scss

@@ -1,41 +1,39 @@
-/**
- * Translates an element horizontally by a number of columns. Positive arguments shift the element to the active layout direction, while negative ones shift it to the opposite direction.
- *
- * @param {Number (unitless)} $n-columns (1)
- *   Number of columns by which the element shifts.
- *
- * @example scss - Usage
- *   .element {
- *     @include shift(-3);
- *   }
- *
- * @example css - CSS output
- *   .element {
- *     margin-left: -25.58941%;
- *   }
- */
+/// Translates an element horizontally by a number of columns. Positive arguments shift the element to the active layout direction, while negative ones shift it to the opposite direction.
+///
+/// @param {Number (unitless)} $n-columns (1)
+///   Number of columns by which the element shifts.
+///
+/// @example scss - Usage
+///   .element {
+///     @include shift(-3);
+///   }
+///
+/// @example css - CSS output
+///   .element {
+///     margin-left: -25.58941%;
+///   }
+
 @mixin shift($n-columns: 1) {
   @include shift-in-context($n-columns);
 }
 
-/**
- * Translates an element horizontally by a number of columns, in a specific nesting context.
- *
- * @param {List} $shift
- *   A list containing the number of columns to shift (`$columns`) and the number of columns of the parent element (`$container-columns`).
- *
- *   The two values can be separated with any string such as `of`, `/`, etc.
- *
- * @example scss - Usage
- *   .element {
- *     @include shift(-3 of 6);
- *   }
- *
- * @example css - CSS output
- *   .element {
- *     margin-left: -52.41458%;
- *   }
- */
+/// Translates an element horizontally by a number of columns, in a specific nesting context.
+///
+/// @param {List} $shift
+///   A list containing the number of columns to shift (`$columns`) and the number of columns of the parent element (`$container-columns`).
+///
+///   The two values can be separated with any string such as `of`, `/`, etc.
+///
+/// @example scss - Usage
+///   .element {
+///     @include shift(-3 of 6);
+///   }
+///
+/// @example css - CSS output
+///   .element {
+///     margin-left: -52.41458%;
+///   }
+
 @mixin shift-in-context($shift: $columns of $container-columns) {
   $n-columns: nth($shift, 1);
   $parent-columns: container-shift($shift) !global;

data/app/assets/stylesheets/grid/_span-columns.scss

@@ -1,52 +1,51 @@
-/**
- * Specifies the number of columns an element should span. If the selector is nested the number of columns of its parent element should be passed as an argument as well.
- *
- * @param {List} $span
- *   A list containing `$columns`, the unitless number of columns the element spans (required), and `$container-columns`, the number of columns the parent element spans (optional).
- *
- *   If only one value is passed, it is assumed that it's `$columns` and that that `$container-columns` is equal to `$grid-columns`, the total number of columns in the grid.
- *
- *   The values can be separated with any string such as `of`, `/`, etc.
- *
- * @param {String} $display (block)
- *   Sets the display property of the element. By default it sets the display propert of the element to `block`.
- *
- *   If passed `block-collapse`, it also removes the margin gutter by adding it to the element width.
- *
- *   If passed `table`, it sets the display property to `table-cell` and calculates the width of the element without taking gutters into consideration. The result does not align with the block-based grid.
- *
- * @example scss - Usage
- *   .element {
- *     @include span-columns(6);
+/// Specifies the number of columns an element should span. If the selector is nested the number of columns of its parent element should be passed as an argument as well.
+///
+/// @param {List} $span
+///   A list containing `$columns`, the unitless number of columns the element spans (required), and `$container-columns`, the number of columns the parent element spans (optional).
+///
+///   If only one value is passed, it is assumed that it's `$columns` and that that `$container-columns` is equal to `$grid-columns`, the total number of columns in the grid.
+///
+///   The values can be separated with any string such as `of`, `/`, etc.
+///
+/// @param {String} $display (block)
+///   Sets the display property of the element. By default it sets the display propert of the element to `block`.
+///
+///   If passed `block-collapse`, it also removes the margin gutter by adding it to the element width.
+///
+///   If passed `table`, it sets the display property to `table-cell` and calculates the width of the element without taking gutters into consideration. The result does not align with the block-based grid.
+///
+/// @example scss - Usage
+///   .element {
+///     @include span-columns(6);
+///
+///    .nested-element {
+///      @include span-columns(2 of 6);
+///    }
+///  }
+///
+/// @example css - CSS Output
+///   .element {
+///     display: block;
+///     float: left;
+///     margin-right: 2.35765%;
+///     width: 48.82117%;
+///   }
+///
+///   .element:last-child {
+///     margin-right: 0;
+///   }
+///
+///   .element .nested-element {
+///     display: block;
+///     float: left;
+///     margin-right: 4.82916%;
+///     width: 30.11389%;
+///   }
+///
+///   .element .nested-element:last-child {
+///     margin-right: 0;
+///   }
 
- *    .nested-element {
- *      @include span-columns(2 of 6);
- *    }
- *  }
- *
- * @example css - CSS Output
- *   .element {
- *     display: block;
- *     float: left;
- *     margin-right: 2.35765%;
- *     width: 48.82117%;
- *   }
- *
- *   .element:last-child {
- *     margin-right: 0;
- *   }
- *
- *   .element .nested-element {
- *     display: block;
- *     float: left;
- *     margin-right: 4.82916%;
- *     width: 30.11389%;
- *   }
- *
- *   .element .nested-element:last-child {
- *     margin-right: 0;
- *   }
- */
 @mixin span-columns($span: $columns of $container-columns, $display: block) {
   $columns: nth($span, 1);
   $container-columns: container-span($span);

data/app/assets/stylesheets/grid/_to-deprecate.scss

@@ -56,52 +56,49 @@
   @include omega($nth $display, $direction);
 }
 
-/**
- * Resets the active display property to `block`. Particularly useful when changing the display property in a single row.
- *
- * @example scss - Usage
- *   .element {
- *     @include row(table);
- *     // Context changed to table display
- *   }
- *
- *   @include reset-display;
- *   // Context is reset to block display
- */
+/// Resets the active display property to `block`. Particularly useful when changing the display property in a single row.
+///
+/// @example scss - Usage
+///   .element {
+///     @include row(table);
+///     // Context changed to table display
+///   }
+///
+///   @include reset-display;
+///   // Context is reset to block display
+
 @mixin reset-display {
   $container-display-table: false !global;
   @include -neat-warn("Resetting $display will be deprecated in future versions in favor of the display(){...} mixin.");
 }
 
-/**
- * Resets the active layout direction to the default value set in `$default-layout-direction`. Particularly useful when changing the layout direction in a single row.
- *
- * @example scss - Usage
- *   .element {
- *     @include row($direction: RTL);
- *     // Context changed to right-to-left
- *   }
- *
- *   @include reset-layout-direction;
- *   // Context is reset to left-to-right
- */
+/// Resets the active layout direction to the default value set in `$default-layout-direction`. Particularly useful when changing the layout direction in a single row.
+///
+/// @example scss - Usage
+///   .element {
+///     @include row($direction: RTL);
+///     // Context changed to right-to-left
+///   }
+///
+///   @include reset-layout-direction;
+///   // Context is reset to left-to-right
+
 @mixin reset-layout-direction {
   $layout-direction: $default-layout-direction !global;
   @include -neat-warn("Resetting $direction will be deprecated in future versions in favor of the direction(){...} mixin.");
 }
 
-/**
- * Resets both the active layout direction and the active display property.
- *
- * @example scss - Usage
- *   .element {
- *     @include row(table, RTL);
- *     // Context changed to table table and right-to-left
- *   }
- *
- *   @include reset-all;
- *   // Context is reset to block display and left-to-right
- */
+/// Resets both the active layout direction and the active display property.
+///
+/// @example scss - Usage
+///   .element {
+///     @include row(table, RTL);
+///     // Context changed to table table and right-to-left
+///   }
+///
+///   @include reset-all;
+///   // Context is reset to block display and left-to-right
+
 @mixin reset-all {
   @include reset-display;
   @include reset-layout-direction;

data/app/assets/stylesheets/settings/_disable-warnings.scss

@@ -1,8 +1,7 @@
-/**
- * Disable all deprecation warnings. Defaults to `false`. Set with a `!global` flag.
- *
- * @type Bool
- */
+/// Disable all deprecation warnings. Defaults to `false`. Set with a `!global` flag.
+///
+/// @type Bool
+
 $disable-warnings: false !default;
 
 @mixin -neat-warn($message) {

data/app/assets/stylesheets/settings/_grid.scss

@@ -1,55 +1,53 @@
-/**
- * Sets the relative width of a single grid column. The unit used should be the same one used to define `$gutter`. To learn more about golden-ratio() see [Bourbon docs](http://bourbon.io/docs/#golden-ratio). Set with a `!global` flag.
- *
- * @type Number (Unit)
- */
+/// Sets the relative width of a single grid column. The unit used should be the same one used to define `$gutter`. To learn more about golden-ratio() see [Bourbon docs](http://bourbon.io/docs/#golden-ratio). Set with a `!global` flag.
+///
+/// @type Number (Unit)
+
 $column: golden-ratio(1em, 3) !default;
 
-/**
- * Sets the relative width of a single grid gutter. The unit used should be the same one used to define `$column`. To learn more about golden-ratio() see [Bourbon docs](http://bourbon.io/docs/#golden-ratio). Set with the `!global` flag.
- *
- * @type Number (Unit)
- */
+/// Sets the relative width of a single grid gutter. The unit used should be the same one used to define `$column`. To learn more about golden-ratio() see [Bourbon docs](http://bourbon.io/docs/#golden-ratio). Set with the `!global` flag.
+///
+/// @type Number (Unit)
+
 $gutter: golden-ratio(1em, 1) !default;
 
-/**
- * Sets the total number of columns in the grid. Its value can be overridden inside a media query using the `media()` mixin. Set with the `!global` flag.
- *
- * @type Number (Unitless)
- */
+/// Sets the total number of columns in the grid. Its value can be overridden inside a media query using the `media()` mixin. Set with the `!global` flag.
+///
+/// @type Number (Unitless)
+
 $grid-columns: 12 !default;
 
-/**
- * Sets the max-width property of the element that includes `outer-container()`. To learn more about `em()` see [Bourbon docs](http://bourbon.io/docs/#px-to-em). Set with the `!global` flag.
- *
- * @type Number (Unit)
- */
+/// Sets the max-width property of the element that includes `outer-container()`. To learn more about `em()` see [Bourbon docs](http://bourbon.io/docs/#px-to-em). Set with the `!global` flag.
+///
+/// @type Number (Unit)
+///
 $max-width: em(1088) !default;
 
-/**
- * When set to true, it sets the box-sizing property of all elements to `border-box`. Set with a `!global` flag.
- *
- * @type Bool
- *
- * @example css - CSS Output
- *   * {
- *     -webkit-box-sizing: border-box;
- *     -moz-box-sizing: border-box;
- *     box-sizing: border-box;
- *   }
- */
+/// When set to true, it sets the box-sizing property of all elements to `border-box`. Set with a `!global` flag.
+///
+/// @type Bool
+///
+/// @example css - CSS Output
+///   html {
+///     -webkit-box-sizing: border-box;
+///     -moz-box-sizing: border-box;
+///     box-sizing: border-box; }
+///
+///   *, *:before, *:after {
+///     -webkit-box-sizing: inherit;
+///     -moz-box-sizing: inherit;
+///     box-sizing: inherit;
+///   }
+
 $border-box-sizing: true !default;
 
-/**
- * Sets the default [media feature](http://www.w3.org/TR/css3-mediaqueries/#media) that `media()` and `new-breakpoint()` revert to when only a breakpoint value is passed. Set with a `!global` flag.
- *
- * @type String
- */
+/// Sets the default [media feature](http://www.w3.org/TR/css3-mediaqueries/#media) that `media()` and `new-breakpoint()` revert to when only a breakpoint value is passed. Set with a `!global` flag.
+///
+/// @type String
+
 $default-feature: min-width; // Default @media feature for the breakpoint() mixin
 
-/**
- * Sets the default layout direction of the grid. Can be `LTR` or `RTL`. Set with a `!global` flag.
- *
- * @type String
- */
+///Sets the default layout direction of the grid. Can be `LTR` or `RTL`. Set with a `!global` flag.
+///
+///@type String
+
 $default-layout-direction: LTR !default;

data/app/assets/stylesheets/settings/_visual-grid.scss

@@ -1,29 +1,25 @@
-/**
- * Displays the visual grid when set to true. The overlaid grid may be few pixels off depending on the browser's rendering engine and pixel rounding algorithm. Set with the `!global` flag.
- *
- * @type Bool
- */
+/// Displays the visual grid when set to true. The overlaid grid may be few pixels off depending on the browser's rendering engine and pixel rounding algorithm. Set with the `!global` flag.
+///
+/// @type Bool
+
 $visual-grid: false !default;
 
-/**
- * Sets the visual grid color. Set with `!global` flag.
- *
- * @type Color
- */
+/// Sets the visual grid color. Set with `!global` flag.
+///
+/// @type Color
+
 $visual-grid-color: #EEE !default;
 
-/**
- * Sets the `z-index` property of the visual grid. Can be `back` (behind content) or `front` (in front of content). Set with `!global` flag.
- *
- * @type String
- */
+/// Sets the `z-index` property of the visual grid. Can be `back` (behind content) or `front` (in front of content). Set with `!global` flag.
+///
+/// @type String
+
 $visual-grid-index: back !default;
 
-/**
- * Sets the opacity property of the visual grid. Set with `!global` flag.
- *
- * @type Number (unitless)
- */
+/// Sets the opacity property of the visual grid. Set with `!global` flag.
+///
+/// @type Number (unitless)
+
 $visual-grid-opacity: 0.4 !default;
 
 $visual-grid-breakpoints: () !default;

data/bower.json

@@ -1,6 +1,6 @@
 {
   "name": "neat",
-  "version": "1.7.0.pre",
+  "version": "1.7.0",
   "homepage": "http://neat.bourbon.io/",
   "main": "app/assets/stylesheets/_neat.scss",
   "ignore": [

data/lib/neat/version.rb

@@ -1,3 +1,3 @@
 module Neat
-  VERSION = '1.7.0.rc'
+  VERSION = '1.7.0'
 end

data/test/_setup.scss

@@ -1,3 +1,3 @@
 @import 'bourbon/bourbon';
-@import 'app/assets/stylesheets/neat';
+@import '../app/assets/stylesheets/neat';
 $disable-warnings: true !global;

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: neat
 version: !ruby/object:Gem::Version
-  version: 1.7.0.rc
+  version: 1.7.0
 platform: ruby
 authors:
 - Kyle Fiedler
@@ -10,7 +10,7 @@ authors:
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2014-10-03 00:00:00.000000000 Z
+date: 2014-10-17 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: sass
@@ -231,9 +231,9 @@ required_ruby_version: !ruby/object:Gem::Requirement
       version: '0'
 required_rubygems_version: !ruby/object:Gem::Requirement
   requirements:
-  - - ">"
+  - - ">="
     - !ruby/object:Gem::Version
-      version: 1.3.1
+      version: '0'
 requirements: []
 rubyforge_project: neat
 rubygems_version: 2.2.2