bourbon 5.0.0.beta.5 → 5.0.0.beta.6

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA1:
-  metadata.gz: bbcabb0de4099a8e82cae3ba0717c5067ef6d5bc
-  data.tar.gz: 23332a525fafb6e5b2febf8272829d6dbbc95a13
+  metadata.gz: 66a37a1717f902865940e47fb7f18d3dace53752
+  data.tar.gz: 9f9328eecf80cd88f1f43c2ccacb417521e98e06
 SHA512:
-  metadata.gz: f5ef886f1e4b3b503550a20ceeb3e2183c9c38c6351c32c304298e75d260de4dddfa3ec4b91ec02ec3f63cd984033982080bc063dbafcfaad29da5dfe4f0f751
-  data.tar.gz: cf1b84c963502b0c8f5909890a3cd72facc7f82f3100666fa80fd23d9901e26932a6793d3127e203b0ac7f21a34e68adfc51ebf1b85ee7c3412da88eecec5787
+  metadata.gz: dbfef29091ce21e562eb7c1d5835ffe076169f06e5c05448fa8526503859c52147cf0e46cccb9a6e464b589dd112b1530387f5161384c2468bfc5fbb72b3a53e
+  data.tar.gz: 102cdd8732e2e3ede64014ce3dd6ae098d42e352d23d6e778489aae4dfe06a7a4434a1df9405d283a959f582b3bad14894f892f5097cb7677d10a593657f4233

data/.ruby-version

@@ -0,0 +1 @@
+2.3.0

data/CHANGELOG.md

@@ -5,7 +5,15 @@ project adheres to [Semantic Versioning](http://semver.org).
 
 ## [Unreleased]
 
-[Unreleased]: https://github.com/thoughtbot/bourbon/compare/v5.0.0.beta.5...HEAD
+[Unreleased]: https://github.com/thoughtbot/bourbon/compare/v5.0.0.beta.6...HEAD
+
+## [5.0.0-beta.6] - 2016-06-06
+
+### Added
+
+- Added a `value-prefixer` mixin for generating vendor prefixes on values.
+
+[5.0.0-beta.6]: https://github.com/thoughtbot/bourbon/compare/v5.0.0.beta.5...v5.0.0.beta.6
 
 ## [5.0.0-beta.5] - 2016-03-23
 

data/CONTRIBUTING.md

@@ -49,6 +49,7 @@ We use [SassDoc] to document Bourbon. [Annotations] should be ordered:
 - `@see`
 - `@type`
 - `@argument`
+- `@content`
 - `@property`
 - `@return`
 - `@example`

data/RELEASING.md

@@ -17,14 +17,17 @@
 1. Run `npm publish`, which pushes the new version to npm’s registry (if
    releasing a pre-release, run `npm publish --tag beta`).
 
-1. Add a [new GitHub release][github-release].
+1. Draft a [new GitHub release][github-release]. Upon publishing, a tweet will
+   _automatically be sent_ on the [@bourbonsass] Twitter account via [Zapier].
+   It will look like this:
+
+   > We’ve released {release_title}: {release_link}
 
 1. Re-generate and publish the [documentation website], using the available
    Rake tasks.
 
-1. Announce the new release, making sure to say “thank you” to the contributors
-   who helped shape this version!
-
 [Keep a CHANGELOG]: http://keepachangelog.com
 [github-release]: https://github.com/thoughtbot/bourbon/releases/new
 [documentation website]: https://github.com/thoughtbot/bourbon.io
+[@bourbonsass]: https://twitter.com/bourbonsass
+[Zapier]: https://zapier.com

data/bourbon.gemspec

@@ -3,12 +3,12 @@ require "bourbon/version"
 
 Gem::Specification.new do |s|
   s.add_development_dependency "aruba", "~> 0.6.2"
-  s.add_development_dependency "css_parser", "~> 1.3"
-  s.add_development_dependency "rake", "~> 10.4"
-  s.add_development_dependency "rspec", "~> 3.3"
-  s.add_development_dependency "scss_lint", "0.47"
-  s.add_runtime_dependency "sass", "~> 3.4"
-  s.add_runtime_dependency "thor", "~> 0.19"
+  s.add_development_dependency "css_parser", "~> 1.4.1"
+  s.add_development_dependency "rake", "~> 11.1.2"
+  s.add_development_dependency "rspec", "~> 3.4.0"
+  s.add_development_dependency "scss_lint", "0.48.0"
+  s.add_runtime_dependency "sass", "~> 3.4.22"
+  s.add_runtime_dependency "thor", "~> 0.19.1"
   s.authors = [
     "Christian Reuter",
     "Damian Galarza",

data/bower.json

@@ -34,5 +34,5 @@
     "type": "git",
     "url": "https://github.com/thoughtbot/bourbon.git"
   },
-  "version": "5.0.0-beta.5"
+  "version": "5.0.0-beta.6"
 }

data/circle.yml

@@ -1,3 +1,7 @@
+dependencies:
+  override:
+    - bundle install
+    - npm install -g sassdoc
 general:
   branches:
     ignore:
@@ -5,3 +9,5 @@ general:
 test:
   override:
     - bundle exec rake
+  post:
+    - sassdoc core/ --parse --verbose --strict

data/core/_bourbon.scss

@@ -1,25 +1,27 @@
-// Bourbon 5.0.0-beta.5
+// Bourbon 5.0.0-beta.6
 // http://bourbon.io
 // Copyright 2011 thoughtbot, inc.
 // MIT License
 
+@import "bourbon/helpers/buttons-list";
 @import "bourbon/helpers/scales";
-@import "bourbon/helpers/timing-functions";
+@import "bourbon/helpers/text-inputs-list";
 
 @import "bourbon/settings/settings";
 
 @import "bourbon/validators/contains";
 @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/bourbon-get-setting";
 @import "bourbon/utilities/collapse-directionals";
 @import "bourbon/utilities/directional-values";
 @import "bourbon/utilities/font-source-declaration";
+@import "bourbon/utilities/retrieve-bourbon-setting";
 @import "bourbon/utilities/unpack";
 
 @import "bourbon/library/border-color";
@@ -43,6 +45,8 @@
 @import "bourbon/library/size";
 @import "bourbon/library/strip-unit";
 @import "bourbon/library/text-inputs";
+@import "bourbon/library/timing-functions";
 @import "bourbon/library/tint";
 @import "bourbon/library/triangle";
+@import "bourbon/library/value-prefixer";
 @import "bourbon/library/word-wrap";

data/core/bourbon/helpers/_buttons-list.scss

@@ -0,0 +1,14 @@
+@charset "UTF-8";
+
+/// A list of all HTML button elements.
+///
+/// @type list
+///
+/// @access private
+
+$_buttons-list: (
+  "button",
+  "[type='button']",
+  "[type='reset']",
+  "[type='submit']",
+);

data/core/bourbon/helpers/_text-inputs-list.scss

@@ -0,0 +1,26 @@
+@charset "UTF-8";
+
+/// A list of all _text-based_ HTML inputs.
+///
+/// @type list
+///
+/// @access private
+
+$_text-inputs-list: (
+  "[type='color']",
+  "[type='date']",
+  "[type='datetime']",
+  "[type='datetime-local']",
+  "[type='email']",
+  "[type='month']",
+  "[type='number']",
+  "[type='password']",
+  "[type='search']",
+  "[type='tel']",
+  "[type='text']",
+  "[type='time']",
+  "[type='url']",
+  "[type='week']",
+  "input:not([type])",
+  "textarea",
+);

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

@@ -1,47 +1,84 @@
 @charset "UTF-8";
 
-/// Provides a quick method for targeting `border-radius` on both corners on the
-/// side of a box.
+/// Provides a shorthand syntax to add `border-radius` to both the top-left and
+/// top-right of an element.
 ///
-/// @argument {number} $radii
+/// @argument {number (with unit)} $radii
 ///
 /// @example scss
-///   .element-one {
-///     @include border-top-radius(5px);
+///   .element {
+///     @include border-top-radius(4px);
 ///   }
 ///
 /// @example css
-///   .element-one {
-///     border-top-left-radius: 5px;
-///     border-top-right-radius: 5px;
+///   .element {
+///     border-top-left-radius: 4px;
+///     border-top-right-radius: 4px;
 ///   }
+
+@mixin border-top-radius($radii) {
+  border-top-left-radius: $radii;
+  border-top-right-radius: $radii;
+}
+
+/// Provides a shorthand syntax to add `border-radius` to both the top-right and
+/// bottom-right of an element.
+///
+/// @argument {number (with unit)} $radii
 ///
 /// @example scss
-///   .element-two {
-///     @include border-left-radius(3px);
+///   .element {
+///     @include border-right-radius(3px);
 ///   }
 ///
 /// @example css
-///   .element-two {
-///     border-bottom-left-radius: 3px;
-///     border-top-left-radius: 3px;
+///   .element {
+///     border-bottom-right-radius: 3px;
+///     border-top-right-radius: 3px;
 ///   }
 
-@mixin border-top-radius($radii) {
-  border-top-left-radius: $radii;
-  border-top-right-radius: $radii;
-}
-
 @mixin border-right-radius($radii) {
   border-bottom-right-radius: $radii;
   border-top-right-radius: $radii;
 }
 
+/// Provides a shorthand syntax to add `border-radius` to both the bottom-left
+/// and bottom-right of an element.
+///
+/// @argument {number (with unit)} $radii
+///
+/// @example scss
+///   .element {
+///     @include border-bottom-radius(2px);
+///   }
+///
+/// @example css
+///   .element {
+///     border-bottom-left-radius: 2px;
+///     border-bottom-right-radius: 2px;
+///   }
+
 @mixin border-bottom-radius($radii) {
   border-bottom-left-radius: $radii;
   border-bottom-right-radius: $radii;
 }
 
+/// Provides a shorthand syntax to add `border-radius` to both the top-left
+/// and bottom-left of an element.
+///
+/// @argument {number (with unit)} $radii
+///
+/// @example scss
+///   .element {
+///     @include border-left-radius(1px);
+///   }
+///
+/// @example css
+///   .element {
+///     border-bottom-left-radius: 1px;
+///     border-top-left-radius: 1px;
+///   }
+
 @mixin border-left-radius($radii) {
   border-bottom-left-radius: $radii;
   border-top-left-radius: $radii;

data/core/bourbon/library/_buttons.scss

@@ -1,60 +1,84 @@
 @charset "UTF-8";
 
-/// Generates variables for all buttons. Please note that you must use
-/// interpolation on the variable: `#{$all-buttons}`.
-///
+////
 /// @type list
 ///
+/// @require {function} _assign-inputs
+///
+/// @require {variable} $_buttons-list
+////
+
+/// A list of all HTML button elements. Please note that you must interpolate
+/// the variable (`#{}`) to use it as a selector.
+///
 /// @example scss
 ///   #{$all-buttons} {
 ///     background-color: #f00;
 ///   }
 ///
-///   #{$all-buttons-focus},
-///   #{$all-buttons-hover} {
-///     background-color: #0f0;
+/// @example css
+///   button,
+///   [type='button'],
+///   [type='reset'],
+///   [type='submit'] {
+///     background-color: #f00;
 ///   }
+
+$all-buttons: _assign-inputs($_buttons-list);
+
+/// A list of all HTML button elements with the `:active` pseudo-class applied.
+/// Please note that you must interpolate the variable (`#{}`) to use it as a
+/// selector.
 ///
+/// @example scss
 ///   #{$all-buttons-active} {
 ///     background-color: #00f;
 ///   }
 ///
 /// @example css
-///   button,
-///   [type='button'],
-///   [type='reset'],
-///   [type='submit'] {
-///     background-color: #f00;
+///   button:active,
+///   [type='button']:active,
+///   [type='reset']:active,
+///   [type='submit']:active {
+///     background-color: #00f;
 ///   }
+
+$all-buttons-active: _assign-inputs($_buttons-list, active);
+
+/// A list of all HTML button elements with the `:focus` pseudo-class applied.
+/// Please note that you must interpolate the variable (`#{}`) to use it as a
+/// selector.
 ///
+/// @example scss
+///   #{$all-buttons-focus} {
+///     background-color: #0f0;
+///   }
+///
+/// @example css
 ///   button:focus,
 ///   [type='button']:focus,
 ///   [type='reset']:focus,
-///   [type='submit']:focus,
+///   [type='submit']:focus {
+///     background-color: #0f0;
+///   }
+
+$all-buttons-focus: _assign-inputs($_buttons-list, focus);
+
+/// A list of all HTML button elements with the `:hover` pseudo-class applied.
+/// Please note that you must interpolate the variable (`#{}`) to use it as a
+/// selector.
+///
+/// @example scss
+///   #{$all-buttons-hover} {
+///     background-color: #0f0;
+///   }
+///
+/// @example css
 ///   button:hover,
 ///   [type='button']:hover,
 ///   [type='reset']:hover,
 ///   [type='submit']:hover {
 ///     background-color: #0f0;
 ///   }
-///
-///   button:active,
-///   [type='button']:active,
-///   [type='reset']:active,
-///   [type='submit']:active {
-///     background-color: #00f;
-///   }
-///
-/// @require {function} _assign-inputs
 
-$buttons-list: (
-  "button",
-  "[type='button']",
-  "[type='reset']",
-  "[type='submit']",
-);
-
-$all-buttons:        _assign-inputs($buttons-list);
-$all-buttons-active: _assign-inputs($buttons-list, active);
-$all-buttons-focus:  _assign-inputs($buttons-list, focus);
-$all-buttons-hover:  _assign-inputs($buttons-list, hover);
+$all-buttons-hover: _assign-inputs($_buttons-list, hover);

data/core/bourbon/library/_contrast-switch.scss

@@ -41,9 +41,20 @@
 
 @function contrast-switch(
     $base-color,
-    $dark-color: _bourbon-get-setting("contrast-switch-dark-color"),
-    $light-color: _bourbon-get-setting("contrast-switch-light-color")
+    $dark-color: _retrieve-bourbon-setting("contrast-switch-dark-color"),
+    $light-color: _retrieve-bourbon-setting("contrast-switch-light-color")
   ) {
 
-  @return if(_is-light($base-color), $dark-color, $light-color);
+  @if not _is-color($base-color) {
+    @error "`#{$base-color}` is not a valid color for the `$base-color` " +
+           "argument in the `contrast-switch` function.";
+  } @else if not _is-color($dark-color) {
+    @error "`#{$dark-color}` is not a valid color for the `$dark-color` " +
+           "argument in the `contrast-switch` function.";
+  } @else if not _is-color($light-color) {
+    @error "`#{$light-color}` is not a valid color for the `$light-color` " +
+           "argument in the `contrast-switch` function.";
+  } @else {
+    @return if(_is-light($base-color), $dark-color, $light-color);
+  }
 }

data/core/bourbon/library/_font-face.scss

@@ -4,9 +4,6 @@
 /// formats you need to output; the mixin supports `eot`, `ttf`, `svg`, `woff2`
 /// and `woff`. The mixin also supports usage with the Rails Asset Pipeline,
 /// which you can enable per use, or globally in the `$bourbon()` settings.
-/// Finally, any additional CSS properties that are included in the `@include`
-/// directive will be output within the `@font-face` declaration, e.g. you can
-/// pass in `font-weight`, `font-style` and/or `unicode-range`.
 ///
 /// @argument {string} $font-family
 ///
@@ -16,35 +13,43 @@
 ///   Set to `true` if you’re using the Rails Asset Pipeline (place the fonts
 ///   in `app/assets/fonts/`).
 ///
-/// @argument {list} $file-formats [("ttf", "woff2", "woff")]
+/// @argument {string | list} $file-formats [("ttf", "woff2", "woff")]
 ///   Pass a list of file formats to support,
-///   for example ("eot", "ttf", "svg", "woff2", woff").
+///   for example ("eot", "ttf", "svg", "woff2", "woff").
+///
+/// @content
+///   Any additional CSS properties that are included in the `@include`
+///   directive will be output within the `@font-face` declaration, e.g. you can
+///   pass in `font-weight`, `font-style` and/or `unicode-range`.
 ///
 /// @example scss
 ///   @include font-face(
-///     "source-sans-pro",
-///     "fonts/source-sans-pro-regular",
-///     $file-formats: ("eot", "ttf")
-///   );
+///       "source-sans-pro",
+///       "fonts/source-sans-pro-regular",
+///       ("woff2", "woff")
+///     ) {
+///     font-style: normal;
+///     font-weight: 400;
+///   }
 ///
 /// @example css
 ///   @font-face {
 ///     font-family: "source-sans-pro";
-///     src: url("fonts/source-sans-pro-regular.eot?#iefix")
-///          format("embedded-opentype"),
-///          url("fonts/source-sans-pro-regular.ttf")
-///          format("truetype");
+///     src: url("fonts/source-sans-pro-regular.woff2") format("woff2"),
+///          url("fonts/source-sans-pro-regular.woff") format("woff");
+///     font-style: normal;
+///     font-weight: 400;
 ///   }
 ///
 /// @require {function} _font-source-declaration
 ///
-/// @require {function} _bourbon-get-setting
+/// @require {function} _retrieve-bourbon-setting
 
 @mixin font-face(
     $font-family,
     $file-path,
-    $file-formats: _bourbon-get-setting("global-font-file-formats"),
-    $asset-pipeline: _bourbon-get-setting("rails-asset-pipeline")
+    $file-formats: _retrieve-bourbon-setting("global-font-file-formats"),
+    $asset-pipeline: _retrieve-bourbon-setting("rails-asset-pipeline")
   ) {
 
   @font-face {