bourbon 5.0.0.beta.6 → 5.0.0.beta.7

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA1:
-  metadata.gz: 66a37a1717f902865940e47fb7f18d3dace53752
-  data.tar.gz: 9f9328eecf80cd88f1f43c2ccacb417521e98e06
+  metadata.gz: d61bf764752cdfdf2794302391819b90097fb223
+  data.tar.gz: 34fc66629ac42632c0e340ea778f8d7050afadfc
 SHA512:
-  metadata.gz: dbfef29091ce21e562eb7c1d5835ffe076169f06e5c05448fa8526503859c52147cf0e46cccb9a6e464b589dd112b1530387f5161384c2468bfc5fbb72b3a53e
-  data.tar.gz: 102cdd8732e2e3ede64014ce3dd6ae098d42e352d23d6e778489aae4dfe06a7a4434a1df9405d283a959f582b3bad14894f892f5097cb7677d10a593657f4233
+  metadata.gz: 53123da272eb3e079700ae75d87b91d793112bacc1ce0df2488fe837ae80be6ccf67d4aed72fabe8b675e4820ee75d4e5efc7fb4d7fcd2d21a114caf2ce20463
+  data.tar.gz: 2bb1fde59bfaba9b66f05ff2ff8e7938022c4f99f8e411c7ac6e03cb90dd0361d0eb738f60c0858b74e6e2f30953b648743109e4cfc189bb635c2adb221cebbd

data/.github/ISSUE_TEMPLATE.md

@@ -0,0 +1,11 @@
+### Expected behavior
+
+### Actual behavior
+
+### Steps to reproduce behavior
+
+### Bourbon version
+
+### Environment info
+
+### Screenshots (if relevant)

data/.github/PULL_REQUEST_TEMPLATE.md

@@ -0,0 +1,5 @@
+### What does this PR do?
+
+### If this is related to an existing issue, include a link to it as well.
+
+### Screenshots (if relevant)

data/CHANGELOG.md

@@ -5,7 +5,38 @@ project adheres to [Semantic Versioning](http://semver.org).
 
 ## [Unreleased]
 
-[Unreleased]: https://github.com/thoughtbot/bourbon/compare/v5.0.0.beta.6...HEAD
+Nothing at the moment.
+
+[Unreleased]: https://github.com/thoughtbot/bourbon/compare/v5.0.0.beta.7...HEAD
+
+## [5.0.0-beta.7] - 2016-11-03
+
+### Added
+
+- Added `white-space: nowrap;` to the `hide-visually` mixin so that content
+  renders on one line and is correctly pronounced by screen readers.
+
+### Changed
+
+- Removed the default values from the `$position` and `$coordinates` arguments
+  for the `position` mixin.
+- Updated `contrast-switch` to calculate contrast based on the WCAG 2.0
+  specification. Please note that it is an approximation and we cannot guarantee
+  full compliance, though all of our manual testing passed.
+- Renamed the `$coordinates` argument in the `position` mixin
+  to `$box-edge-values`.
+- Updated `$font-stack-system` to include Avenir Next, Avenir, Lucida
+  Grande, Helvetica, Noto, Franklin Gothic Medium, Century Gothic, and
+  Liberation Sans. This follows [system-fonts] by Adam Morse.
+- The `word-break` property was removed from the `word-wrap` mixin and
+  is no longer output.
+- Renamed the `word-wrap` mixin to `overflow-wrap` to align with the
+  name change in the [CSS spec].
+
+[system-fonts]: https://github.com/mrmrs/css-system-fonts
+[CSS spec]: https://drafts.csswg.org/css-text-3/#propdef-overflow-wrap
+
+[5.0.0-beta.7]: https://github.com/thoughtbot/bourbon/compare/v5.0.0.beta.6...v5.0.0.beta.7
 
 ## [5.0.0-beta.6] - 2016-06-06
 

data/README.md

@@ -1,36 +1,55 @@
-[![Bourbon](http://images.thoughtbot.com/bourbon/bourbon-logo.svg)](http://bourbon.io)
+[<img src="https://images.thoughtbot.com/bourbon/bourbon-logo.svg" width="200" alt="Bourbon logo">][Bourbon]
 
-[![GitHub release](https://img.shields.io/github/release/thoughtbot/bourbon.svg)](https://github.com/thoughtbot/bourbon/releases)
-[![CircleCI branch](https://img.shields.io/circleci/project/thoughtbot/bourbon/master.svg)](https://circleci.com/gh/thoughtbot/bourbon/tree/master)
+## A Lightweight Sass Tool Set
 
-## A simple and lightweight mixin library for Sass.
+[Bourbon] is a library of [Sass] mixins and functions that are designed to make
+you a more efficient style sheet author.
 
-Bourbon is a library of pure Sass mixins that are designed to be simple and easy to use. No configuration required. The mixins aim to be as vanilla as possible, meaning they should be as close to the original CSS syntax as possible.
+It is…
 
-The mixins contain vendor specific prefixes for all CSS3 properties for support amongst modern browsers. The prefixes also ensure graceful degradation for older browsers that support only CSS3 prefixed properties. Bourbon uses SCSS syntax.
+- Dependency-free: Bourbon is pure Sass.
+- Human-readable: We aim for clarity over brevity.
+- Lightweight: Zero output post-install and has no visual opinion.
 
-- **[Documentation](http://bourbon.io/docs)**
-- **[Changelog](https://github.com/thoughtbot/bourbon/releases)**
-- **[Issues & Bugs](https://github.com/thoughtbot/bourbon/issues)**
+The current version is **4.2.7**. The `master` branch on GitHub is version
+5.0.0-beta.7.
 
-Follow the [@bourbonsass](https://twitter.com/bourbonsass) Twitter account
-for updates.
+  [Bourbon]: http://bourbon.io
+  [Sass]: http://sass-lang.com
+
+### Helpful Links
+
+- [Documentation](http://bourbon.io/docs/latest/)
+- [Change log](CHANGELOG.md)
+- [Twitter](https://twitter.com/bourbonsass)
+
+## Table of Contents
+
+- [Requirements](#requirements)
+- [Installation](#installation)
+- [Command Line Interface](#command-line-interface)
+- [Browser Support](#browser-support)
+- [The Bourbon Family](#the-bourbon-family)
+- [Contributing](#contributing)
+- [License](#license)
+- [About](#about)
 
 ## Requirements
 
-- [Sass](https://github.com/sass/sass) 3.4+ or [LibSass](https://github.com/sass/libsass) 3.3+
+- [Sass] 3.4+ or [LibSass] 3.3+
 
-## Installation
+  [Sass]: https://github.com/sass/sass
+  [LibSass]: https://github.com/sass/libsass
 
-For command line help, visit our wiki page on Bourbon’s [command line interface](https://github.com/thoughtbot/bourbon/wiki/Command-Line-Interface).
+## Installation
 
-1. Install the Bourbon gem using the [RubyGems](https://rubygems.org) package manager:
+1. Install the Bourbon gem using the [RubyGems] package manager:
 
   ```bash
   gem install bourbon
   ```
 
-  Alternatively, you can install Bourbon with [Bower](http://bower.io).
+  Alternatively, you can install Bourbon with [Bower].
 
 1. Install the Bourbon library into the current directory:
 
@@ -38,7 +57,8 @@ For command line help, visit our wiki page on Bourbon’s [command line interfac
   bourbon install
   ```
 
-  **Pro Tip:** You can target installation into a specific directory using the `path` flag:
+  **Pro Tip:** You can target installation into a specific directory using the
+  `path` flag:
 
   ```bash
   bourbon install --path my/custom/path/
@@ -50,14 +70,19 @@ For command line help, visit our wiki page on Bourbon’s [command line interfac
   @import "bourbon/bourbon";
   ```
 
-  It’s not recommended to add or modify the Bourbon files so that you can update them easily.
+  It’s not recommended that you modify Bourbon’s files directly as it will make
+  updating to future versions difficult, by overwriting your custom changes or
+  causing merge conflicts.
 
-## Installation for Ruby on Rails 4.2+
+  [RubyGems]: https://rubygems.org
+  [Bower]: http://bower.io
+
+### Installation for Ruby on Rails 4.2+
 
 1. Add Bourbon to your Gemfile:
 
   ```ruby
-  gem 'bourbon'
+  gem "bourbon"
   ```
 
 1. Then run:
@@ -72,9 +97,12 @@ For command line help, visit our wiki page on Bourbon’s [command line interfac
   mv app/assets/stylesheets/application.css app/assets/stylesheets/application.scss
   ```
 
-1. Delete _all_ Sprockets directives in `application.scss` (`require`, `require_tree` and `require_self`) and use Sass’s native `@import` instead. ([why?](http://pivotallabs.com/structure-your-sass-files-with-import))
+1. Delete _all_ Sprockets directives in `application.scss` (`require`,
+   `require_tree` and `require_self`) and use Sass’s native `@import` instead
+   ([why?][sass-import]).
 
-1. Import Bourbon at the beginning of `application.scss`. All additional stylesheets should be imported below Bourbon:
+1. Import Bourbon at the beginning of `application.scss`. Any project styles
+   that utilize Bourbon’s features must be imported after Bourbon.
 
   ```scss
   @import "bourbon";
@@ -82,9 +110,9 @@ For command line help, visit our wiki page on Bourbon’s [command line interfac
   @import "users";
   ```
 
-  [Help! I’m getting an undefined mixin error.](https://github.com/thoughtbot/bourbon/wiki/Rails-Help-%5C-Undefined-mixin)
+  [sass-import]: http://pivotallabs.com/structure-your-sass-files-with-import
 
-## Installing with npm and using a Node-based asset pipeline
+### Installing with npm and using a Node-based asset pipeline
 
 1. Add Bourbon as a dependency:
 
@@ -92,7 +120,11 @@ For command line help, visit our wiki page on Bourbon’s [command line interfac
   npm install --save bourbon
   ```
 
-1. If you’re using [Eyeglass](http://eyeglass.rocks), skip to Step 3. Otherwise, you’ll need to add Bourbon to your node-sass `includePaths` option. `require("bourbon").includePaths` is an array of directories that you should pass to node-sass. How you do this depends on how node-sass is integrated into your project.
+1. If you’re using [eyeglass], skip to Step 3. Otherwise,
+you’ll need to add Bourbon to your node-sass `includePaths` option.
+`require("bourbon").includePaths` is an array of directories that you should
+pass to node-sass. How you do this depends on how node-sass is integrated into
+your project.
 
 1. Import Bourbon into your Sass files:
 
@@ -100,7 +132,9 @@ For command line help, visit our wiki page on Bourbon’s [command line interfac
   @import "bourbon";
   ```
 
-## Installing older versions of Bourbon
+  [eyeglass]: http://eyeglass.rocks
+
+### Installing older versions of Bourbon
 
 1. Uninstall any Bourbon gem versions you already have:
 
@@ -108,30 +142,59 @@ For command line help, visit our wiki page on Bourbon’s [command line interfac
   gem uninstall bourbon
   ```
 
-1. Reinstall the Bourbon gem, using the `-v` flag to specify the version you need:
+1. Reinstall the Bourbon gem, using the `-v` flag to specify the version
+   you need:
 
   ```bash
   gem install bourbon -v 3.2.4
   ```
 
-1. Follow the [instructions above](#installation) to install Bourbon into your project.
+1. Follow the [instructions above](#installation) to install Bourbon into
+   your project.
+
+## Command Line Interface
+
+```bash
+bourbon [options]
+```
+
+### Options
+
+| Option            | Description               |
+| :---------------- | :------------------------ |
+| `-h`, `--help`    | Show help                 |
+| `-v`, `--version` | Show the version number   |
+| `--path`          | Specify a custom path     |
+| `--force`         | Force install (overwrite) |
+
+### Commands
+
+| Command           | Description                                           |
+| :---------------- | :---------------------------------------------------- |
+| `bourbon install` | Install Bourbon into the current directory            |
+| `bourbon update`  | Overwrite and update Bourbon in the current directory |
+| `bourbon help`    | Show help                                             |
+
+## Browser Support
 
-## Browser support
+Bourbon supports Internet Explorer 11+ and the latest versions of Chrome,
+Firefox, Safari, and Edge.
 
-- Chrome 26+
-- Firefox 29+
-- Internet Explorer 9+
-- Opera 15+
-- Safari 6.1+
+## The Bourbon Family
 
-## The Bourbon family
+Bourbon is part of a larger, modular family of Sass utilities:
 
-- [Bourbon](https://github.com/thoughtbot/bourbon): A simple and lightweight mixin library for Sass
-- [Neat](https://github.com/thoughtbot/neat): A lightweight semantic grid framework for Sass and Bourbon
-- [Bitters](https://github.com/thoughtbot/bitters): Scaffold styles, variables and structure for Bourbon projects
-- [Refills](https://github.com/thoughtbot/refills): Prepackaged patterns and components built with Bourbon, Neat and Bitters
+- [Bourbon](https://github.com/thoughtbot/bourbon): A lightweight Sass tool set
+- [Neat](https://github.com/thoughtbot/neat): A lightweight semantic grid
+  framework for Sass and Bourbon
+- [Bitters](https://github.com/thoughtbot/bitters): Scaffold styles, variables
+  and structure for Bourbon projects
+- [Refills](https://github.com/thoughtbot/refills): Prepackaged patterns and
+  components built with Bourbon, Neat and Bitters
 
-Also check out [Proteus](https://github.com/thoughtbot/proteus), a collection of useful starter kits to help you prototype faster. Each kit comes with Bourbon, Neat and Bitters out-of-the-box.
+Be sure to also check out [Proteus](https://github.com/thoughtbot/proteus), a
+collection of useful starter kits to help you prototype faster. Each kit comes
+with Bourbon, Neat and Bitters out-of-the-box.
 
 ## Contributing
 
@@ -142,17 +205,21 @@ See the [contributing] document. Thank you, [contributors]!
 
 ## License
 
-Bourbon is copyright © 2011 [thoughtbot, inc.][thoughtbot] It is free software, and may be redistributed under the terms specified in the [license].
+Bourbon is copyright © 2011 [thoughtbot, inc.][thoughtbot] It is free software,
+and may be redistributed under the terms specified in the [license].
 
   [license]: LICENSE.md
 
 ## About
 
-Bourbon is maintained by Tyson Gach and the thoughtbot design team. It is funded by [thoughtbot, inc.][thoughtbot] and the names and logos for thoughtbot are trademarks of thoughtbot, inc.
+Bourbon is maintained by Tyson Gach and the thoughtbot design team. It is funded
+by [thoughtbot, inc.][thoughtbot] and the names and logos for thoughtbot are
+trademarks of thoughtbot, inc.
 
-[<img src="http://thoughtbot.github.io/images/signature.svg" width="250" alt="thoughtbot logo">][thoughtbot]
+[<img src="http://presskit.thoughtbot.com/images/signature.svg" width="250" alt="thoughtbot logo">][thoughtbot]
 
-We love open-source software! See [our other projects][community] or [hire us][hire] to design, develop, and grow your product.
+We love open-source software! See [our other projects][community] or
+[hire us][hire] to design, develop, and grow your product.
 
   [thoughtbot]: https://thoughtbot.com?utm_source=github
   [community]: https://thoughtbot.com/community?utm_source=github

data/RELEASING.md

@@ -5,14 +5,15 @@
   - `core/_bourbon.scss`
   - `package.json`
   - `bower.json`
+  - `README.md`
 
 1. Update `CHANGELOG.md`. We follow the guidelines from [Keep a CHANGELOG].
 
 1. Commit changes. Use the convention “Bourbon vX.X.X” in your commit message.
    There shouldn’t be code changes, and thus CI doesn’t need to run.
 
-1. Run `bundle exec rake release`, which tags the release, pushes the tag to GitHub, and
-   pushes the gem to RubyGems.org.
+1. Run `bundle exec rake release`, which tags the release, pushes the tag to
+   GitHub, and pushes the gem to RubyGems.org.
 
 1. Run `npm publish`, which pushes the new version to npm’s registry (if
    releasing a pre-release, run `npm publish --tag beta`).

data/bourbon.gemspec

@@ -22,10 +22,8 @@ Gem::Specification.new do |s|
     "Will McMahan"
   ]
   s.description = <<-DESC
-    Bourbon is a library of pure Sass mixins that are designed to be simple
-    and easy to use. No configuration required. The mixins aim to be as
-    vanilla as possible, meaning they should be as close to the original
-    CSS syntax as possible.
+    Bourbon is a library of pure Sass mixins and functions that are designed to
+    make you a more efficient developer.
   DESC
   s.email = "design+bourbon@thoughtbot.com"
   s.executables = `git ls-files -- bin/*`.split("\n").map{ |f| File.basename(f) }
@@ -35,7 +33,7 @@ Gem::Specification.new do |s|
   s.name = "bourbon"
   s.platform = Gem::Platform::RUBY
   s.require_paths = ["lib"]
-  s.summary = "A simple and lightweight mixin library for Sass"
+  s.summary = "A lightweight Sass tool set."
   s.test_files = `git ls-files -- {test,spec,features}/*`.split("\n")
   s.version = Bourbon::VERSION
 end

data/bower.json

@@ -2,7 +2,7 @@
   "authors": [
     "thoughtbot (http://thoughtbot.com)"
   ],
-  "description": "A simple and lightweight mixin library for Sass.",
+  "description": "A lightweight Sass tool set.",
   "homepage": "http://bourbon.io",
   "ignore": [
     "**/.*",
@@ -34,5 +34,5 @@
     "type": "git",
     "url": "https://github.com/thoughtbot/bourbon.git"
   },
-  "version": "5.0.0-beta.6"
+  "version": "5.0.0-beta.7"
 }

data/core/_bourbon.scss

@@ -1,4 +1,4 @@
-// Bourbon 5.0.0-beta.6
+// Bourbon 5.0.0-beta.7
 // http://bourbon.io
 // Copyright 2011 thoughtbot, inc.
 // MIT License
@@ -13,16 +13,18 @@
 @import "bourbon/validators/contains-falsy";
 @import "bourbon/validators/is-color";
 @import "bourbon/validators/is-length";
-@import "bourbon/validators/is-light";
 @import "bourbon/validators/is-number";
 @import "bourbon/validators/is-size";
 
 @import "bourbon/utilities/assign-inputs";
-@import "bourbon/utilities/collapse-directionals";
-@import "bourbon/utilities/directional-values";
+@import "bourbon/utilities/compact-shorthand";
+@import "bourbon/utilities/directional-property";
 @import "bourbon/utilities/font-source-declaration";
+@import "bourbon/utilities/gamma";
+@import "bourbon/utilities/lightness";
+@import "bourbon/utilities/contrast-ratio";
 @import "bourbon/utilities/retrieve-bourbon-setting";
-@import "bourbon/utilities/unpack";
+@import "bourbon/utilities/unpack-shorthand";
 
 @import "bourbon/library/border-color";
 @import "bourbon/library/border-radius";
@@ -38,6 +40,7 @@
 @import "bourbon/library/hide-visually";
 @import "bourbon/library/margin";
 @import "bourbon/library/modular-scale";
+@import "bourbon/library/overflow-wrap";
 @import "bourbon/library/padding";
 @import "bourbon/library/position";
 @import "bourbon/library/prefixer";
@@ -49,4 +52,3 @@
 @import "bourbon/library/tint";
 @import "bourbon/library/triangle";
 @import "bourbon/library/value-prefixer";
-@import "bourbon/library/word-wrap";

data/core/bourbon/library/_border-color.scss

@@ -1,17 +1,18 @@
 @charset "UTF-8";
 
-/// Provides a quick method for targeting `border-color` on specific sides of a
-/// box. Use a `null` value to “skip” a side.
+/// Provides a concise, one-line method for setting `border-color` on specific
+/// edges of a box. Use a `null` value to “skip” edges of the box with standard
+/// CSS shorthand.
 ///
-/// @argument {arglist} $values
-///   List of colors, defined as CSS shorthand.
+/// @argument {list} $values
+///   List of colors; accepts CSS shorthand.
 ///
 /// @example scss
 ///   .element {
 ///     @include border-color(#a60b55 #76cd9c null #e8ae1a);
 ///   }
 ///
-/// @example css
+///   // CSS Output
 ///   .element {
 ///     border-left-color: #e8ae1a;
 ///     border-right-color: #76cd9c;
@@ -20,6 +21,6 @@
 ///
 /// @require {mixin} _directional-property
 
-@mixin border-color($values...) {
-  @include _directional-property(border, color, $values...);
+@mixin border-color($values) {
+  @include _directional-property(border, color, $values);
 }