support-for 1.0.0.beta.1 → 1.0.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA1:
-  metadata.gz: 29d7c18877ad7d383895ae9a8d25014bbff2e67e
-  data.tar.gz: 36871ff68f8f2003467b7a6d06ff58f97d400f33
+  metadata.gz: a237da8b1487ba22400a55f5bf22ca8c70768b32
+  data.tar.gz: d4973a6ed4d70c5ad4d02be8d0003b10e472d02b
 SHA512:
-  metadata.gz: 59bb4c779a38921ce12b7fa55a2d0963f8ea4c12d5ec6de1af181502a207f076bd9fdd8798874eab292b95fba818b04757b1955af91eb30facd35b99d37cd660
-  data.tar.gz: f07b8cf5ff5316579b7be63ce34e8efc092049b584fc49d20ae162b69abc76b28fb702eb2477c99cc86c5dfecc699f81f30c3758ceb2d2806947bad13565bfd1
+  metadata.gz: 4da375a0b0a70a7b6331e67df9dd14cc78a49b23f8d28c7c641cef217b04e4f2195b21cdee5e548f750c3e5cf483e3e4c0f84faa2b06bbc8e5f42d8359777751
+  data.tar.gz: 7fee9548810ebbdba18cb127f37cd2b3d5c7dbe5172aeb0180f71aa065c0c9e66c82d190b4ab6bffbe03e6ff3ddc1ad27646bd71abc759a1a7c2e3c725fe0c8a

data/README.md

@@ -1,8 +1,77 @@
 # support-for
 
-The `support-for` module is designed to be used by developers to ease conditional browser support while authoring their Sass module.
+The `support-for` module is designed to be used by Sass authors to ease conditional browser support while creating their Sass module or Sass partial.
 
-## Adding a support-for dependency to your module
+Authors of Sass code that uses support-for can specify which browser versions they want to support by setting a simple Sass variable, `$support-for`.
+
+Here are some example usages:
+
+1. The Sass author only wants to support Safari 8 and later (and no other browsers) because he is an asshole.
+
+```scss
+$support-for: (
+  safari: 8,
+  '*':    null, // null means "no support" and is the
+                // default value for any browser not
+                // specified in $support-for
+);
+
+// Normalize-scss uses support-for.
+@import "normalize";
+```
+
+2. The Sass author wants to support the 4 most recent versions of all browsers which she can do by setting the wildcard browser, `'*'`. She also has to support IE 6 and later because the client hates her.
+
+```scss
+$support-for: (
+  '*': -4,
+  ie:  6,
+);
+
+@import "normalize";
+```
+
+3. The Sass author is working for a government client and every browser version has a specific version specified in the contract.
+
+```scss
+$support-for: (
+  chrome:  29,
+  edge:    20,
+  firefox: 26,
+  ie:      8,
+  opera:   14,
+  safari:  5,
+);
+
+@import "normalize";
+```
+
+### Update your Sass partials to use `support-for()`
+
+If a Sass module tells you that it uses `support-for`, you just need to override the default value of the `$support-for` variable before you import that module. See the examples above about some of your options.
+
+If, however, you want to conditionally include Sass in your CSS output, you can update your Sass code to wrap those lines of CSS with an `@if` block that uses the `support-for()` function.
+
+```
+@mixin my-sweet-sweet-mixin($cocoa: lots) {
+  border-radius: 100%;
+
+  // Only include this property if we support IE 10.
+  @if support-for(ie, 10) {
+    // Remove border when applied to an `img` inside an `a` element in IE 8/9/10.
+    border: 0;
+  }
+}
+```
+
+If you later drop support for IE 10 (someday!), you just need to update the
+`$support-for` variable and your code will stop outputting the IE-10-specific
+CSS.
+
+## Updating your module to use `support-for`
+
+If you are a Sass module author wanting to use `support-for` in your module, it's
+quite easy to add it.
 
 ### Ruby Sass
 
@@ -30,3 +99,5 @@ Add your dependency with the following command:
 ```
 bower install --save support-for
 ```
+
+[![Build Status](https://travis-ci.org/JohnAlbin/support-for.png?branch=master)](https://travis-ci.org/JohnAlbin/support-for)

data/sass/_support-for.scss

@@ -1,14 +1,15 @@
 // Support the last 4 versions of all browsers except IE.
 $support-for: (
-  chrome:  43,
-  edge:    22,
-  firefox: 39,
+  chrome:  -4,
+  edge:    -4,
+  firefox: -4,
   ie:      9,
-  opera:   30,
-  safari:  6,
+  opera:   -4,
+  safari:  -4,
+  '*':     -4,
 ) !default;
 
-// Set the current version number for all browsers. As of: 2015-11-16
+// Set the current version number for all browsers. As of: 2015-11-17
 $support-for-current-browser-version: (
   chrome:  46,
   edge:    25,
@@ -31,12 +32,17 @@ $support-for-current-browser-version: (
 @function support-for($browser, $version) {
   // Ensure $version is an integer (or null).
   @if not (type-of($version) == "null" or type-of($version) == "number" and round($version) == $version) {
-    @error "The $version parameter of support-for() must be an integer; #{inspect($version)} given.";
+    @error "The $version parameter of support-for() must be an integer; #{type-of($version)} given.";
   }
 
   // Check against declared minimums.
-  $min-version: if(map-has-key($support-for, $browser), map-get($support-for, $browser), null);
-  // @TODO: Add '*' browser to provide default minimum version.
+  $min-version: null;
+  @if map-has-key($support-for, $browser) {
+    $min-version: map-get($support-for, $browser);
+  }
+  @else if map-has-key($support-for, '*') {
+    $min-version: map-get($support-for, '*');
+  }
 
   // Ensure $min-version is an integer (or null).
   @if type-of($min-version) != "null" and type-of($min-version) != "number" {
@@ -49,10 +55,10 @@ $support-for-current-browser-version: (
   // Negative $min-version means "X most recent versions".
   @if type-of($min-version) == "number" and $min-version < 0 {
     @if not map-has-key($support-for-current-browser-version, $browser) {
-      @error "$support-for-current-browser-version: (#{$browser}: null) must be set to an integer.";
+      @error "#{$browser} not found in $support-for-current-browser-version map; it must be set to an integer.";
     }
     $min-version: map-get($support-for-current-browser-version, $browser) + $min-version + 1;
   }
 
-  @return ($min-version and ($version >= $min-version));
+  @return if(($min-version and ($version >= $min-version)), true, false);
 }

data/support-for.gemspec

@@ -9,8 +9,8 @@ Gem::Specification.new do |spec|
   spec.homepage    = 'https://github.com/JohnAlbin/support-for'
   spec.rubyforge_project =
 
-  spec.version     = '1.0.0.beta.1'
-  spec.date        = '2015-11-16'
+  spec.version     = '1.0.0'
+  spec.date        = '2015-11-17'
   spec.licenses    = ['GPL-2']
 
   spec.authors     = ['John Albin Wilkins']

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: support-for
 version: !ruby/object:Gem::Version
-  version: 1.0.0.beta.1
+  version: 1.0.0
 platform: ruby
 authors:
 - John Albin Wilkins
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2015-11-16 00:00:00.000000000 Z
+date: 2015-11-17 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: sass
@@ -50,11 +50,11 @@ 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: 1.0.0.beta.1
+rubyforge_project: 1.0.0
 rubygems_version: 2.4.8
 signing_key: 
 specification_version: 4