bourbon 4.2.4 → 6.0.0

data/LICENSE.md

@@ -1,6 +1,6 @@
 The MIT License (MIT)
 
-Copyright © 2011–2015 [thoughtbot, inc.](http://thoughtbot.com)
+Copyright © 2011-2019 [thoughtbot, inc.](http://thoughtbot.com)
 
 Permission is hereby granted, free of charge, to any person obtaining a copy
 of this software and associated documentation files (the “Software”), to deal

data/README.md

@@ -1,140 +1,218 @@
-[![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]
 
-[![Gem Version](http://img.shields.io/gem/v/bourbon.svg?style=flat)](https://rubygems.org/gems/bourbon)
-[![Code Climate](http://img.shields.io/codeclimate/github/thoughtbot/bourbon.svg?style=flat)](https://codeclimate.com/github/thoughtbot/bourbon)
-[![Gitter chat](https://img.shields.io/badge/gitter-thoughtbot/bourbon-ae3dd2.svg?style=flat)](https://gitter.im/thoughtbot/bourbon)
-[![Stack Overflow](http://img.shields.io/badge/stack%20overflow-bourbon-ae3dd2.svg?style=flat)](http://stackoverflow.com/questions/tagged/bourbon)
+[![Reviewed by Hound](https://img.shields.io/badge/Reviewed_by-Hound-8E64B0.svg)](https://houndci.com)
 
-## A simple and lightweight mixin library for Sass.
+## A Lightweight Sass Tool Set
 
-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 [Sass] mixins and functions that are designed to make
+you a more efficient style sheet author.
 
-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.
+It is…
 
-- **[Documentation](http://bourbon.io/docs)**
-- **[Changelog](https://github.com/thoughtbot/bourbon/releases)**
-- **[Issues & Bugs](https://github.com/thoughtbot/bourbon/issues)**
+- Dependency-free: Bourbon is pure Sass.
+- Human-readable: We aim for clarity over brevity.
+- Lightweight: Zero output post-install and has no visual opinion.
 
-Follow the [@bourbonsass](https://twitter.com/bourbonsass) Twitter account
-for updates.
+  [Bourbon]: https://www.bourbon.io/
+  [Sass]: http://sass-lang.com
+
+### Helpful Links
+
+- [Documentation](https://www.bourbon.io/docs/latest/)
+- [Change log](CHANGELOG.md)
+- [Twitter](https://twitter.com/bourbonsass)
+- [Stack Overflow](https://stackoverflow.com/questions/tagged/bourbon)
+
+## 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.1+
+- [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
-  ```
+    ```bash
+    gem install bourbon
+    ```
 
-  Alternatively, you can install Bourbon with [Bower](http://bower.io).
+1. Install the Bourbon library into the current directory:
 
-2. Install the Bourbon library into the current directory:
+    ```bash
+    bourbon install
+    ```
 
-  ```bash
-  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/
+    ```
 
-  ```bash
-  bourbon install --path my/custom/path/
-  ```
+1. Import Bourbon at the beginning of your stylesheet:
 
-3. Import Bourbon at the beginning of your stylesheet:
+    ```scss
+    @import "bourbon/bourbon";
+    ```
 
-  ```scss
-  @import "bourbon/bourbon";
-  ```
+    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.
 
-  It’s not recommended to add or modify the Bourbon files so that you can update them easily.
+  [RubyGems]: https://rubygems.org
 
-## Installation for Ruby on Rails 3.1+
+### Installation for Ruby on Rails 4.2+
 
 1. Add Bourbon to your Gemfile:
 
-  ```ruby
-  gem 'bourbon'
-  ```
+    ```ruby
+    gem "bourbon"
+    ```
+
+1. Then run:
+
+    ```bash
+    bundle install
+    ```
+
+1. Restart your server and rename `application.css` to `application.scss`:
+
+    ```bash
+    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?][sass-import]).
+
+1. Import Bourbon at the beginning of `application.scss`. Any project styles
+   that utilize Bourbon’s features must be imported after Bourbon.
 
-2. Then run:
+    ```scss
+    @import "bourbon";
+    @import "home";
+    @import "users";
+    ```
 
-  ```bash
-  bundle install
-  ```
+  [sass-import]: https://content.pivotal.io/blog/structure-your-sass-files-with-import
 
-3. Restart your server and rename `application.css` to `application.scss`:
+### Installing with npm and using a Node-based asset pipeline
 
-  ```bash
-  mv app/assets/stylesheets/application.css app/assets/stylesheets/application.scss
-  ```
+1. Add Bourbon as a dependency:
 
-4. 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))
+    ```bash
+    npm install --save bourbon
+    ```
 
-5. Import Bourbon at the beginning of `application.scss`. All additional stylesheets should be imported below Bourbon:
+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.
 
-  ```scss
-  @import "bourbon";
-  @import "home";
-  @import "users";
-  ```
+1. Import Bourbon into your Sass files:
 
-  [Help! I’m getting an undefined mixin error.](https://github.com/thoughtbot/bourbon/wiki/Rails-Help-%5C-Undefined-mixin)
+    ```scss
+    @import "bourbon";
+    ```
 
-## Installing older versions of Bourbon
+  [eyeglass]: https://github.com/sass-eyeglass/eyeglass
+
+### Installing older versions of Bourbon
 
 1. Uninstall any Bourbon gem versions you already have:
 
-  ```bash
-  gem uninstall bourbon
-  ```
+    ```bash
+    gem uninstall bourbon
+    ```
+
+1. Reinstall the Bourbon gem, using the `-v` flag to specify the version
+   you need:
+
+    ```bash
+    gem install bourbon -v 4.2.7
+    ```
+
+1. Follow the [instructions above](#installation) to install Bourbon into
+   your project.
+
+## Command Line Interface
+
+```bash
+bourbon [options]
+```
 
-2. Reinstall the Bourbon gem, using the `-v` flag to specify the version you need:
+### Options
 
-  ```bash
-  gem install bourbon -v 3.2.4
-  ```
+| Option            | Description               |
+| :---------------- | :------------------------ |
+| `-h`, `--help`    | Show help                 |
+| `-v`, `--version` | Show the version number   |
+| `--path`          | Specify a custom path     |
+| `--force`         | Force install (overwrite) |
 
-3. Follow the [instructions above](#installation) to install Bourbon into your project.
+### Commands
 
-## Browser support
+| Command           | Description                                           |
+| :---------------- | :---------------------------------------------------- |
+| `bourbon install` | Install Bourbon into the current directory            |
+| `bourbon update`  | Overwrite and update Bourbon in the current directory |
+| `bourbon help`    | Show help                                             |
 
-- Chrome 26+
-- Firefox 29+
-- Internet Explorer 9+
-- Opera 15+
-- Safari 6.1+
+## Browser Support
 
-## The Bourbon family
+Bourbon supports Internet Explorer 11+ and the latest versions of Chrome,
+Firefox, Safari, and Edge.
 
-- [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
+## The Bourbon Family
 
-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.
+Bourbon is part of a larger, modular family of Sass utilities:
+
+- [Neat]: A lightweight and flexible Sass grid
+- [Bitters]: Scaffold styles, variables and structure for Bourbon projects
+
+  [Neat]: https://github.com/thoughtbot/neat
+  [Bitters]: https://github.com/thoughtbot/bitters
+
+## Contributing
+
+See the [contributing] document. Thank you, [contributors]!
+
+  [contributing]: CONTRIBUTING.md
+  [contributors]: https://github.com/thoughtbot/bourbon/graphs/contributors
 
 ## License
 
-Copyright © 2011–2015 [thoughtbot, inc](http://thoughtbot.com).
-Bourbon is free software,
-and may be redistributed under the terms specified in the [license](LICENSE.md).
+Bourbon is copyright © 2011-2019 [thoughtbot, inc.][thoughtbot] It is free
+software, and may be redistributed under the terms specified in the [license].
+
+  [license]: LICENSE.md
 
-## About thoughtbot
+## About
 
-[<img src="http://thoughtbot.github.io/images/signature.svg" width="250" alt="thoughtbot logo">][hire]
+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 and funded by thoughtbot, inc.
-The names and logos for thoughtbot are trademarks of thoughtbot, inc.
+[![thoughtbot][thoughtbot-logo]][thoughtbot]
 
-We love open source software!
-See [our other projects][community] or
+We love open-source software! See [our other projects][community] or
 [hire us][hire] to design, develop, and grow your product.
 
-[community]: https://thoughtbot.com/community?utm_source=github
-[hire]: https://thoughtbot.com/hire-us?utm_source=github
+  [thoughtbot]: https://thoughtbot.com?utm_source=github
+  [thoughtbot-logo]: http://presskit.thoughtbot.com/images/thoughtbot-logo-for-readmes.svg
+  [community]: https://thoughtbot.com/community?utm_source=github
+  [hire]: https://thoughtbot.com/hire-us?utm_source=github

data/RELEASING.md

@@ -0,0 +1,33 @@
+# Releasing
+
+1. Update the version number in these places:
+
+    - `lib/bourbon/version.rb`
+    - `core/_bourbon.scss`
+    - `package.json`
+
+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 `npm publish`, which pushes the new version to npm’s registry (if
+   releasing a pre-release, run `npm publish --tag beta`).
+
+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 Bourbon {release_title}: {release_link}
+
+1. Re-generate and publish the [documentation website], using the available
+   Rake tasks.
+
+[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/Rakefile

@@ -1,5 +1,3 @@
-# encoding: utf-8
-require "rubygems"
 require "bundler"
 require "cucumber/rake/task"
 require "rspec/core/rake_task"

data/bin/bourbon

@@ -1,6 +1,5 @@
 #!/usr/bin/env ruby
 
-# CodeKit needs relative paths
-require File.dirname(__FILE__) + '/../lib/bourbon.rb'
+require File.dirname(__FILE__) + "/../lib/bourbon.rb"
 
 Bourbon::Generator.start

data/bourbon.gemspec

@@ -2,31 +2,37 @@ $:.push File.expand_path("../lib", __FILE__)
 require "bourbon/version"
 
 Gem::Specification.new do |s|
-  s.name        = "bourbon"
-  s.version     = Bourbon::VERSION
-  s.platform    = Gem::Platform::RUBY
-  s.authors     = ["Andres Mejia", "Chad Mazzola", "Chris Lloyd", "Gabe Berke-Williams", "J. Edward Dewyea", "Jeremy Raines", "Kyle Fiedler", "Matt Jankowski", "Mike Burns", "Nick Quaranto", "Phil LaPier", "Reda Lemeden", "Travis Haynes", "Tyson Gach", "Will McMahan"]
-  s.email       = "design+bourbon@thoughtbot.com"
-  s.license     = "MIT"
-  s.homepage    = "http://bourbon.io"
-  s.summary     = "A simple and lightweight mixin library for Sass"
+  s.add_development_dependency "aruba", "~> 0.14"
+  s.add_development_dependency "css_parser", "~> 1.4"
+  s.add_development_dependency "cucumber", "~> 2.0"
+  s.add_development_dependency "rake", "~> 11.1"
+  s.add_development_dependency "rspec", "~> 3.4"
+  s.add_runtime_dependency "thor", "~> 0.19"
+  s.authors = [
+    "Christian Reuter",
+    "Damian Galarza",
+    "Gabe Berke-Williams",
+    "Hugo Giraudel",
+    "Joshua Ogle",
+    "Kyle Fiedler",
+    "Phil LaPier",
+    "Reda Lemeden",
+    "Tyson Gach",
+    "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.files         = `git ls-files`.split("\n")
-  s.test_files    = `git ls-files -- {test,spec,features}/*`.split("\n")
-  s.executables   = `git ls-files -- bin/*`.split("\n").map{ |f| File.basename(f) }
+  s.email = "design+bourbon@thoughtbot.com"
+  s.executables = `git ls-files -- bin/*`.split("\n").map{ |f| File.basename(f) }
+  s.files = `git ls-files`.split("\n")
+  s.homepage = "https://www.bourbon.io/"
+  s.license = "MIT"
+  s.name = "bourbon"
+  s.platform = Gem::Platform::RUBY
   s.require_paths = ["lib"]
-
-  s.add_runtime_dependency("sass", "~> 3.4")
-  s.add_runtime_dependency("thor", "~> 0.19")
-
-  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.40")
+  s.summary = "A lightweight Sass tool set."
+  s.test_files = `git ls-files -- {test,spec,features}/*`.split("\n")
+  s.version = Bourbon::VERSION
 end

data/core/_bourbon.scss

@@ -0,0 +1,54 @@
+// Bourbon 6.0.0
+// https://www.bourbon.io/
+// Copyright 2011-2019 thoughtbot, inc.
+// MIT License
+
+@import "bourbon/helpers/buttons-list";
+@import "bourbon/helpers/scales";
+@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-number";
+@import "bourbon/validators/is-size";
+
+@import "bourbon/utilities/assign-inputs";
+@import "bourbon/utilities/compact-shorthand";
+@import "bourbon/utilities/directional-property";
+@import "bourbon/utilities/fetch-bourbon-setting";
+@import "bourbon/utilities/font-source-declaration";
+@import "bourbon/utilities/gamma";
+@import "bourbon/utilities/lightness";
+@import "bourbon/utilities/contrast-ratio";
+@import "bourbon/utilities/unpack-shorthand";
+
+@import "bourbon/library/border-color";
+@import "bourbon/library/border-radius";
+@import "bourbon/library/border-style";
+@import "bourbon/library/border-width";
+@import "bourbon/library/buttons";
+@import "bourbon/library/clearfix";
+@import "bourbon/library/contrast-switch";
+@import "bourbon/library/ellipsis";
+@import "bourbon/library/font-face";
+@import "bourbon/library/font-stacks";
+@import "bourbon/library/hide-text";
+@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";
+@import "bourbon/library/shade";
+@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";

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/_scales.scss

@@ -0,0 +1,27 @@
+@charset "UTF-8";
+
+////
+/// Pre-defined scales for use with the `modular-scale` function.
+///
+/// @type number (unitless)
+///
+/// @see {function} modular-scale
+////
+
+$minor-second: 1.067;
+$major-second: 1.125;
+$minor-third: 1.2;
+$major-third: 1.25;
+$perfect-fourth: 1.333;
+$augmented-fourth: 1.414;
+$perfect-fifth: 1.5;
+$minor-sixth: 1.6;
+$golden: 1.618;
+$major-sixth: 1.667;
+$minor-seventh: 1.778;
+$major-seventh: 1.875;
+$octave: 2;
+$major-tenth: 2.5;
+$major-eleventh: 2.667;
+$major-twelfth: 3;
+$double-octave: 4;

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-color.scss

@@ -0,0 +1,26 @@
+@charset "UTF-8";
+
+/// 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 {list} $values
+///   List of colors; accepts CSS shorthand.
+///
+/// @example scss
+///   .element {
+///     @include border-color(#a60b55 #76cd9c null #e8ae1a);
+///   }
+///
+///   // CSS Output
+///   .element {
+///     border-left-color: #e8ae1a;
+///     border-right-color: #76cd9c;
+///     border-top-color: #a60b55;
+///   }
+///
+/// @require {mixin} _directional-property
+
+@mixin border-color($values) {
+  @include _directional-property(border, color, $values);
+}

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

@@ -0,0 +1,85 @@
+@charset "UTF-8";
+
+/// Provides a concise, one-line method for setting `border-radius` on both the
+/// top-left and top-right of a box.
+///
+/// @argument {number (with unit)} $radii
+///
+/// @example scss
+///   .element {
+///     @include border-top-radius(4px);
+///   }
+///
+///   // CSS Output
+///   .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 concise, one-line method for setting `border-radius` on both the
+/// top-right and bottom-right of a box.
+///
+/// @argument {number (with unit)} $radii
+///
+/// @example scss
+///   .element {
+///     @include border-right-radius(3px);
+///   }
+///
+///   // CSS Output
+///   .element {
+///     border-bottom-right-radius: 3px;
+///     border-top-right-radius: 3px;
+///   }
+
+@mixin border-right-radius($radii) {
+  border-bottom-right-radius: $radii;
+  border-top-right-radius: $radii;
+}
+
+/// Provides a concise, one-line method for setting `border-radius` on both the
+/// bottom-left and bottom-right of a box.
+///
+/// @argument {number (with unit)} $radii
+///
+/// @example scss
+///   .element {
+///     @include border-bottom-radius(2px);
+///   }
+///
+///   // CSS Output
+///   .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 concise, one-line method for setting `border-radius` on both the
+/// top-left and bottom-left of a box.
+///
+/// @argument {number (with unit)} $radii
+///
+/// @example scss
+///   .element {
+///     @include border-left-radius(1px);
+///   }
+///
+///   // CSS Output
+///   .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;
+}