bourbon 4.3.4 → 5.0.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA1:
-  metadata.gz: 4ef6ee45b54f96a49f9efeff2b37dc73297b1c28
-  data.tar.gz: 1755915841bdfb3100093e7ef80d4c8fb8d8a45e
+  metadata.gz: 1584e80e0ac32e8bd3cb84b83ba12c55a6be1923
+  data.tar.gz: f64c1bc64288b6618eaaf0b0e8cd126a57590f27
 SHA512:
-  metadata.gz: 5b8f67656224a3c4ecf787c127987d72a8833edf30a57843448334a68b50646366c529a861e530fa49f2e440a4193932a49a76cb6cf6957a3eab79df6a912743
-  data.tar.gz: bfaea42d9444d693e4ef97c2d8886d1ceaa29b62a1d997cab3d139e4d639dfd11cfbd8e259bf5d35ad98debba656295106a6b61a60929c657fcd2911198bfff2
+  metadata.gz: f2f53764c13fe7d31a92e66a4a3df6ded7896c89b73072cd6a2ce854a65f7ad65766a34ac418330c4cdf1411291d0269c30d8e515da0353b08cadd3ee899e44b
+  data.tar.gz: 87707bce377b4fa6acb24d09abe4b43cd24e37844c7d739b6c51de80d567bf2c09739e808132a1cb6fe589d78351296659ea81e9067cbdcee3603d851bd9bd5c

data/.github/ISSUE_TEMPLATE.md

@@ -0,0 +1,22 @@
+<!-- Feel free to remove any part of this issue template that is not relevant -->
+<!-- Providing context helps us come up with a useful solution -->
+
+## Description
+
+<!-- What did you expect to happen? What happened instead? Was a specific error thrown? -->
+
+## Steps to Reproduce
+
+<!-- If you can reproduce the bug in a CodePen, link to it here -->
+
+1. Step 1…
+2.
+3.
+
+## Development Environment
+
+<!--- Include as many relevant details about the environment you experienced the bug in -->
+
+- Bourbon version:
+- Platform:
+- Link to the code repository:

data/.github/PULL_REQUEST_TEMPLATE.md

@@ -0,0 +1,10 @@
+<!-- Feel free to remove any part of this pull request template that is not relevant -->
+
+## Description
+
+<!-- What do your changes do or fix? -->
+
+## Additional Information
+
+<!-- Links to demos, e.g. CodePen, can be helpful, as are research and support documents -->
+<!-- If this fixes or is related to an existing issue, link to it here (and in the commit message) -->

data/.npmignore

@@ -1,16 +1,21 @@
+.github/
 .gitignore
 .hound.yml
+.ruby-version
 .sass-cache
 .scss-lint.yml
 _site
 bin/
 bourbon.gemspec
 bower.json
+circle.yml
+CODE_OF_CONDUCT.md
+CONTRIBUTING.md
 features/
 Gemfile
 Gemfile.lock
 lib/
 pkg/
 Rakefile
-sache.json
+RELEASING.md
 spec/

data/.ruby-version

@@ -0,0 +1 @@
+2.3.1

data/.scss-lint.yml

@@ -1,155 +1,247 @@
-scss_files: "app/assets/stylesheets/**/*.scss"
+scss_files: "**/*.scss"
+
+severity: warning
+
 linters:
   BangFormat:
     enabled: true
     space_before_bang: true
     space_after_bang: false
+
   BemDepth:
     enabled: false
+
   BorderZero:
     enabled: true
     convention: zero
+
+  ChainedClasses:
+    enabled: false
+
   ColorKeyword:
     enabled: true
+
   ColorVariable:
     enabled: false
+
   Comment:
     enabled: true
+    style: silent
+
   DebugStatement:
     enabled: true
+
   DeclarationOrder:
     enabled: true
+
   DisableLinterReason:
     enabled: false
+
   DuplicateProperty:
     enabled: true
+
   ElsePlacement:
     enabled: true
     style: same_line
+
   EmptyLineBetweenBlocks:
     enabled: true
     ignore_single_line_blocks: true
+
   EmptyRule:
     enabled: true
+
   ExtendDirective:
     enabled: false
+
   FinalNewline:
     enabled: true
     present: true
+
   HexLength:
     enabled: true
     style: short
+
   HexNotation:
     enabled: true
     style: lowercase
+
   HexValidation:
     enabled: true
+
   IdSelector:
     enabled: true
+
   ImportantRule:
     enabled: true
+
   ImportPath:
     enabled: true
     leading_underscore: false
     filename_extension: false
+
   Indentation:
     enabled: true
     allow_non_nested_indentation: false
     character: space
     width: 2
+
   LeadingZero:
     enabled: true
     style: include_zero
+
   MergeableSelector:
     enabled: true
     force_nesting: true
+
   NameFormat:
     enabled: true
     allow_leading_underscore: true
     convention: hyphenated_lowercase
+
   NestingDepth:
     enabled: true
     max_depth: 3
     ignore_parent_selectors: false
+
   PlaceholderInExtend:
     enabled: true
+
+  PrivateNamingConvention:
+    enabled: false
+    prefix: _
+
   PropertyCount:
     enabled: false
+
   PropertySortOrder:
     enabled: true
     ignore_unspecified: false
+    min_properties: 2
     separate_groups: false
+
   PropertySpelling:
     enabled: true
+    extra_properties: []
+    disabled_properties: []
+
   PropertyUnits:
     enabled: true
+    global: [
+      'ch', 'em', 'ex', 'rem',
+      'cm', 'in', 'mm', 'pc', 'pt', 'px', 'q',
+      'vh', 'vw', 'vmin', 'vmax',
+      'deg', 'grad', 'rad', 'turn',
+      'ms', 's',
+      'Hz', 'kHz',
+      'dpi', 'dpcm', 'dppx',
+      '%']
     properties:
       line-height: []
+
+  PseudoElement:
+    enabled: true
+
   QualifyingElement:
     enabled: true
     allow_element_with_attribute: false
     allow_element_with_class: false
     allow_element_with_id: false
+
   SelectorDepth:
     enabled: true
     max_depth: 2
-    severity: warning
+
   SelectorFormat:
-    enabled: false
+    enabled: true
+    convention: hyphenated_BEM
+
   Shorthand:
     enabled: true
     allowed_shorthands: [1, 2, 3]
+
   SingleLinePerProperty:
     enabled: true
     allow_single_line_rule_sets: true
+
   SingleLinePerSelector:
     enabled: true
+
   SpaceAfterComma:
     enabled: true
     style: one_space
+
+  SpaceAfterComment:
+    enabled: false
+    allow_empty_comments: true
+
   SpaceAfterPropertyColon:
     enabled: true
     style: one_space
+
   SpaceAfterPropertyName:
     enabled: true
+
+  SpaceAfterVariableColon:
+    enabled: true
+    style: at_least_one_space
+
   SpaceAfterVariableName:
     enabled: true
+
   SpaceAroundOperator:
-    enabled: false
+    enabled: true
+    style: one_space
+
   SpaceBeforeBrace:
     enabled: true
     style: space
-    allow_single_line_padding: false
+    allow_single_line_padding: true
+
   SpaceBetweenParens:
     enabled: true
     spaces: 0
+
   StringQuotes:
     enabled: true
     style: double_quotes
+
   TrailingSemicolon:
     enabled: true
+
   TrailingWhitespace:
     enabled: true
+
   TrailingZero:
-    enabled: false
+    enabled: true
+
   TransitionAll:
     enabled: true
-    severity: warning
+
   UnnecessaryMantissa:
     enabled: true
+
   UnnecessaryParentReference:
     enabled: true
+
   UrlFormat:
     enabled: true
-    severity: warning
+
   UrlQuotes:
     enabled: true
+
   VariableForProperty:
     enabled: false
+    properties: []
+
   VendorPrefix:
     enabled: true
     identifier_list: base
+    additional_identifiers: []
+    excluded_identifiers: []
+
   ZeroUnit:
     enabled: true
+
   Compass::*:
     enabled: false

data/CHANGELOG.md

@@ -3,39 +3,311 @@
 All notable changes to this project will be documented in this file. This
 project adheres to [Semantic Versioning](http://semver.org).
 
-## 4.3.4 - 2017-04-01
+## [Unreleased (`master`)][unreleased]
+
+Nothing at the moment.
+
+[unreleased]: https://github.com/thoughtbot/bourbon/compare/v5.0.0...HEAD
+
+## [5.0.0] - 2018-01-05
+
+Bourbon 5.0.0 is a major release with lots of changes and removals, which are
+documented below in each of the alpha and beta releases. There are no changes
+between v5.0.0-beta.8 and v5.0.0. For information on how to upgrade from v4 to
+v5, read our [migrating guide][migrating-guide].
+
+[5.0.0]: https://github.com/thoughtbot/bourbon/compare/v5.0.0.beta.8...v5.0.0
+[migrating-guide]: http://www.bourbon.io/docs/migrating-from-v4-to-v5/
+
+## [5.0.0-beta.8] - 2017-06-26
+
+### Added
+
+- A `style` property has been added to our `package.json`, which makes for easy
+  importing when using npm-sass, sass-module-importer and others.
+
+### Changed
+
+- The `triangle` mixin no longer has default argument values. The order of the
+  arguments also changed: `$width` and `$height` now come before `$color`.
+
+### Fixed
+
+- The `bourbon update` CLI command now works when Bourbon is installed using a
+  custom path.
+- Fixed an issue that would cause Bourbon to not be found within Rails apps.
+
+[5.0.0-beta.8]: https://github.com/thoughtbot/bourbon/compare/v5.0.0.beta.7...v5.0.0.beta.8
+
+## [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. You can
+  read more about this in Jesse Beach’s article “[Beware smushed off-screen
+    accessible text][smushed-text-article].”
+
+### 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].
+
+[smushed-text-article]: https://medium.com/@jessebeach/beware-smushed-off-screen-accessible-text-5952a4c2cbfe#.l4hkljiza
+[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
+
+### 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
+
+### Fixed
+
+- Fixed a Sass load path issue that would intermittently break the importing of
+  Bourbon in Rails apps.
+
+### Changed
+
+- Swapped the order of the `$file-formats` and `$asset-pipeline` arguments in
+  the `font-face` mixin, so that `$asset-pipeline` is last (because it has a
+  default and is likely used the least).
+
+[5.0.0-beta.5]: https://github.com/thoughtbot/bourbon/compare/v5.0.0.beta.4...v5.0.0.beta.5
+
+## [5.0.0-beta.4] - 2016-03-11
+
+### Fixed
+
+- We accidentally published `5.0.0.beta.3` as a stable release on npm, rather
+  than a prerelease. We’ve unpublished that to go back to `4.2.6` on the stable
+  channel.
+
+[5.0.0-beta.4]: https://github.com/thoughtbot/bourbon/compare/v5.0.0.beta.3...v5.0.0.beta.4
+
+## [5.0.0-beta.3] - 2016-03-04
+
+### Fixed
+
+- Added `pathname` requirement to fix install issues.
+
+[5.0.0-beta.3]: https://github.com/thoughtbot/bourbon/compare/v5.0.0.beta.2...v5.0.0.beta.3
+
+## [5.0.0-beta.2] - 2016-03-03
+
+### Added
+
+- Added global settings for the `contrast-switch` mixin:
+  `contrast-switch-dark-color` & `contrast-switch-light-color`.
+- Added the `triangle` mixin back, but note that it’s been refactored and the
+  arguments have changed. See [43e5a90].
+
+### Changed
+
+- Switched argument names in `contrast-switch`; `$dark-color` is now
+  `$light-color` and `$light-color` is now `$dark-color`.
+- The `is-light` function is now private.
+
+### Removed
+
+- Dropped support for Ruby on Rails versions older than 4.2.
+- Dropped support for LibSass versions older than 3.3.
+
+[5.0.0-beta.2]: https://github.com/thoughtbot/bourbon/compare/v5.0.0.beta.1...v5.0.0.beta.2
+[43e5a90]: https://github.com/thoughtbot/bourbon/commit/43e5a90e7e624d2977731030ccdb36b3c2e460d9
+
+## [5.0.0-beta.1] - 2016-02-09
+
+### Added
+
+- Added a `contrast-switch` function that switches between two colors based on the
+  lightness of a another color. Great for building button styles.
+- Added an `$all-text-inputs-invalid` variable to target the `:invalid`
+  pseudo-class on all text-based inputs.
+- The `ellipsis` mixin now takes a `$display` argument.
+- Added a font stack for system fonts: `$font-stack-system`.
+- Added a `hide-visually` mixin that hides an element visually while still
+  allowing the content to be accessible to assistive technology,
+  e.g. screen readers.
+- The `font-face` mixin now allows additional CSS properties to be included in
+  its block, which will output as part of the `@font-face` declaration.
+  See [2356719].
+
+### Changed
+
+- The global default for the `modular-scale` ratio is now set to
+  `$major-third` (`1.25`), instead of `$perfect-fourth` (`1.333`).
+- All font stack variables are now prefixed with `$font-stack-`,
+  e.g. `$font-stack-helvetica`.
+- Global settings are now set via a `$bourbon` map, instead of variables.
+  See [4e43c2d].
+- The `clearfix` mixin now uses `block` display, instead of `table`.
+
+### Removed
+
+- The `$weight` and `$style` arguments in the `font-face` mixin have been
+  removed. Instead, you can now include these—along with other CSS
+  properties—within the mixin block and they’ll be output as part of the
+  `@font-face` declaration.
+
+[5.0.0-beta.1]: https://github.com/thoughtbot/bourbon/compare/da4451e...v5.0.0.beta.1
+[2356719]: https://github.com/thoughtbot/bourbon/commit/235671948ef3a9c343c4391d250082a0373c8d83
+[4e43c2d]: https://github.com/thoughtbot/bourbon/commit/4e43c2d7507999b539771bdc1b3733b18b3c1883
+
+## [5.0.0.alpha.0] - 2015-08-21
+
+### Added
+
+- Added a `$global-font-file-formats` setting to globally set the file formats
+  for the `font-face` mixin. The default is `("ttf", "woff2", "woff")`.
+- Add `$consolas`, `$courier-new` and `$monaco` variables (these replace the
+  removed `$monospace` variable).
+
+### Changed
+
+- Removed the type selectors in `$all-text-inputs` and `$all-buttons` to
+  reduce specificity.
+- Font stacks have been modernized. See [3cf106a].
+- The `strip-units` function is now `strip-unit`.
+- The `size` mixin now requires a comma-separated argument list,
+  e.g. `@include size(1em, 2em);`.
+
+### Removed
+
+- All vendor prefixing mixins have been removed. These include:
+  - `align-items`
+  - `animation-delay`
+  - `animation-direction`
+  - `animation-duration`
+  - `animation-fill-mode`
+  - `animation-iteration-count`
+  - `animation-name`
+  - `animation-play-state`
+  - `animation-timing-function`
+  - `animation`
+  - `appearance`
+  - `backface-visibility`
+  - `background-image`
+  - `background`
+  - `border-image`
+  - `calc`
+  - `column-count`
+  - `column-fill`
+  - `column-gap`
+  - `column-rule-color`
+  - `column-rule-style`
+  - `column-rule-width`
+  - `column-rule`
+  - `column-span`
+  - `column-width`
+  - `columns`
+  - `display`
+  - `filter`
+  - `flex-direction`
+  - `flex`
+  - `font-feature-settings`
+  - `hidpi`
+  - `hyphens`
+  - `image-rendering`
+  - `justify-content`
+  - `keyframes`
+  - `linear-gradient`
+  - `perspective`
+  - `placeholder`
+  - `radial-gradient`
+  - `selection`
+  - `text-decoration-color`
+  - `text-decoration-line`
+  - `text-decoration-style`
+  - `text-decoration`
+  - `transform-origin`
+  - `transform-style`
+  - `transform`
+  - `transition-delay`
+  - `transition-duration`
+  - `transition-property`
+  - `transition-timing-function`
+  - `transition`
+  - `user-select`
+  - For prefixing, we recommend using a more robust and maintainable solution
+    like [Autoprefixer].
+- The `$global-prefixes` setting has been removed and the `prefixer` mixin
+  has been refactored and no longer uses it.
+- The `$monospace` variable has been removed.
+- The `box-sizing` mixin has been removed.
+- The `button` mixin has been removed.
+- The `em` and `rem` functions have been removed.
+  - [See the discussion on why these were removed][em-rem-issue].
+- The `flex-grid` function has been removed.
+- The `flex-gutter` function has been removed.
+- The `golden-ratio` function has been removed.
+- The `grid-width` function has been removed.
+- The `inline-block` mixin has been removed.
+- The `retina-image` mixin has been removed.
+- The `triangle` mixin has been removed.
+
+[5.0.0.alpha.0]: https://github.com/thoughtbot/bourbon/compare/v4.3.4...v5.0.0.alpha.0
+[3cf106a]: https://github.com/thoughtbot/bourbon/commit/3cf106a210c1bae7765e6193f62310f95fdee0b7
+[Autoprefixer]: https://github.com/postcss/autoprefixer
+[em-rem-issue]: https://github.com/thoughtbot/bourbon/issues/691
+
+## [4.3.4] - 2017-04-01
 
 ### Changed
 
 - Updated deprecation warning message for `strip-units`. ([#1016])
 
+[4.3.4]: https://github.com/thoughtbot/bourbon/compare/v4.3.3...v4.3.4
 [#1016]: https://github.com/thoughtbot/bourbon/pull/1016
 
-## 4.3.3 - 2017-02-23
+## [4.3.3] - 2017-02-23
 
 ### Fixed
 
 - Internal Bourbon deprecation warnings for `is-size` and `is-length` will no
   longer be thrown when using the `size` mixin.
 
-## 4.3.2 - 2017-02-10
+[4.3.3]: https://github.com/thoughtbot/bourbon/compare/v4.3.2...v4.3.3
+
+## [4.3.2] - 2017-02-10
 
 ### Fixed
 
 - Internal Bourbon deprecation warnings for `unpack` and `is-length` will no
   longer be thrown when using the `position` mixin. ([#1004])
 
+[4.3.2]: https://github.com/thoughtbot/bourbon/compare/v4.3.1...v4.3.2
 [#1004]: https://github.com/thoughtbot/bourbon/pull/1004
 
-## 4.3.1 - 2017-02-07
+## [4.3.1] - 2017-02-07
 
 ### Fixed
 
 - Internal Bourbon deprecation warnings will no longer be thrown. ([#1002])
 
+[4.3.1]: https://github.com/thoughtbot/bourbon/compare/v4.3.0...v4.3.1
 [#1002]: https://github.com/thoughtbot/bourbon/pull/1002
 
-## 4.3.0 - 2017-02-03
+## [4.3.0] - 2017-02-03
 
 ### Added
 
@@ -43,5 +315,72 @@ project adheres to [Semantic Versioning](http://semver.org).
   reference our [change log], which includes a list of these changes and
   removals. ([#891])
 
+[4.3.0]: https://github.com/thoughtbot/bourbon/compare/v4.2.7...v4.3.0
 [change log]: https://github.com/thoughtbot/bourbon/blob/master/CHANGELOG.md
 [#891]: https://github.com/thoughtbot/bourbon/pull/891
+
+## [4.2.7] - 2016-04-15
+
+### Fixed
+
+- Fixed a Sass deprecation warning when using the `background` and
+  `background-image` mixins.
+
+[4.2.7]: https://github.com/thoughtbot/bourbon/compare/v4.2.6...v4.2.7
+
+## [4.2.6] - 2015-10-17
+
+### Fixed
+
+- Fixed a bug with eyeglass support.
+
+[4.2.6]: https://github.com/thoughtbot/bourbon/compare/v4.2.5...v4.2.6
+
+## [4.2.5] - 2015-09-17
+
+## Added
+
+- Support for [eyeglass].
+
+[4.2.5]: https://github.com/thoughtbot/bourbon/compare/v4.2.4...v4.2.5
+[eyeglass]: http://eyeglass.rocks/
+
+## [4.2.4] - 2015-08-21
+
+## Changed
+
+- [`$all-text-inputs`] now accounts for `input`’s that don’t have a `type`
+  attribute specified, as they default to `type="text"`.
+  (https://github.com/thoughtbot/bourbon/commit/8e7e36e01c47194d83951fb6315c5b26a008f2b7)
+- The [`bourbon` npm package] now has a proper load path.
+  (https://github.com/thoughtbot/bourbon/commit/36c2d5576f1fe9dbdfd9543e15064c5a4a16343e)
+
+[4.2.4]: https://github.com/thoughtbot/bourbon/compare/v4.2.3...v4.2.4
+[`$all-text-inputs`]: http://bourbon.io/docs/#text-inputs
+[`bourbon` npm package]: https://npmjs.com/package/bourbon
+
+## [4.2.3] - 2015-05-18
+
+## Fixed
+
+- Fixed an issue with the `font-face` mixin outputting an extraneous commas when
+  using LibSass set to compressed output.
+
+[4.2.3]: https://github.com/thoughtbot/bourbon/compare/v4.2.2...v4.2.3
+
+## [4.2.2] - 2015-04-01
+
+## Fixed
+
+- The `flex-direction` mixin now properly outputs box-direction (old syntax) if
+  set to normal.
+
+[4.2.2]: https://github.com/thoughtbot/bourbon/compare/v4.2.1...v4.2.2
+
+## [4.2.1] - 2015-02-23
+
+## Fixed
+
+- Restored the `app/` directory for npm.
+
+[4.2.1]: https://github.com/thoughtbot/bourbon/compare/v4.2.0...v4.2.1