browserslist 3.2.2 → 3.2.6

package/CHANGELOG.md

@@ -1,6 +1,20 @@
 # Change Log
 This project adheres to [Semantic Versioning](http://semver.org/).
 
+## 3.2.6
+* Add Opera Mini 12 to dead browsers.
+* Update docs (by Jamie Kyle).
+
+## 3.2.5
+* Fix excluding Opera Mini and other browsers with `all` version.
+
+## 3.2.4
+* Resolve shareable config from current working directory.
+
+## 3.2.3
+* Fix `package.json` config validation for single string case.
+* Fix CLI error reporting.
+
 ## 3.2.2
 * Add `package.json` config validation.
 * Move project to `browserlist` GitHub organization.

package/README.md

@@ -22,7 +22,7 @@ when you add the following to `package.json`:
 {
   "browserslist": [
     "> 1%",
-    "last 2 versions"
+    "IE 10"
   ]
 }
 ```
@@ -33,7 +33,6 @@ Or in `.browserslistrc` config:
 # Browsers that we support
 
 > 1%
-Last 2 versions
 IE 10 # sorry
 ```
 
@@ -77,7 +76,7 @@ You can test Browserslist queries in [online demo].
   with Autoprefixer.
 
 [`browserslist-useragent`]: https://github.com/pastelsky/browserslist-useragent
-[`browserslist-ga`]:        https://github.com/dmfrancisco/browserslist-ga
+[`browserslist-ga`]:        https://github.com/browserslist/browserslist-ga
 [`caniuse-api`]:            https://github.com/Nyalab/caniuse-api
 
 
@@ -95,10 +94,27 @@ Browserslist will use browsers query from one of this sources:
    Browserslist will use defaults:
    `> 0.5%, last 2 versions, Firefox ESR, not dead`.
 
+
+### Best Practices
+
+* We do not recommend to changing the default set of browsers unless you
+  know what are you doing. Browserslist’s default browsers selection is a
+  result of many long discussions. It is easy to make mistake selecting own
+  browsers without understanding what are you doing (like accidentally making
+  your website inaccessible for Chinese users).
+* Select browsers directly (`last 2 Chrome versions`) only if you are making
+  web app for kiosk with one browser. There are a lot browsers on the market.
+  If you are making general web app you should respect browsers diversity.
+* If you want to change the default set of browsers we recommend `> 0.2%`,
+  `> 1% in US` or `> 1% in my stats`. `last 2 versions` will add too many
+  dead browsers and will not add many popular versions. If you require last
+  2 versions support, set `last 2 versions, > 1% in my stats, not dead`.
+
+
+### Full List
+
 You can specify the versions by queries (case insensitive):
 
-* `last 2 versions`: the last 2 versions for each browser.
-* `last 2 Chrome versions`: the last 2 versions of Chrome browser.
 * `> 5%`: versions selected by global usage statistics.
   `>=`, `<` and `<=` work too.
 * `> 5% in US`: uses USA usage statistics. It accepts [two-letter country code].
@@ -124,7 +140,9 @@ You can specify the versions by queries (case insensitive):
 * `dead`: browsers from `last 2 version` query, but with less than 0.5%
   in global usage statistics and without official support or updates
   for 24 months. Right now it is `IE 10`, `IE_Mob 10`, `BlackBerry 10`,
-  and `BlackBerry 7`.
+  `BlackBerry 7`, and `OperaMobile 12.1`.
+* `last 2 versions`: the last 2 versions for *each* browser.
+* `last 2 Chrome versions`: the last 2 versions of Chrome browser.
 * `defaults`: Browserslist’s default browsers
   (`> 0.5%, last 2 versions, Firefox ESR, not dead`).
 * `not ie <= 8`: exclude browsers selected by previous queries.
@@ -212,7 +230,7 @@ browsers in `package.json` with `browserslist` key:
   },
   "browserslist": [
     "> 1%",
-    "last 2 versions"
+    "IE 10"
   ]
 }
 ```
@@ -227,8 +245,7 @@ and have browsers queries split by a new line. Comments starts with `#` symb
 # Browsers that we support
 
 > 1%
-Last 2 versions
-IE 8 # sorry
+IE 10 # sorry
 ```
 
 Browserslist will check config in every directory in `path`.
@@ -276,8 +293,8 @@ When writing a shared Browserslist package, just export an array.
 
 ```js
 module.exports = [
-  'last 2 versions',
-  'ie 9'
+  '> 1%',
+  'ie 10'
 ]
 ```
 
@@ -333,11 +350,12 @@ In `package.json`:
 ```js
   "browserslist": {
     "production": [
-      "last 2 version",
-      "ie 9"
+      "> 1%",
+      "ie 10"
     ],
     "development": [
-      "last 1 version"
+      "last 1 chrome version",
+      "last 1 firefox version"
     ]
   }
 ```
@@ -346,11 +364,12 @@ In `.browserslistrc` config:
 
 ```ini
 [production staging]
-last 2 version
-ie 9
+> 1%
+ie 10
 
 [development]
-last 1 version
+last 1 chrome version
+last 1 firefox version
 ```
 
 
@@ -385,7 +404,7 @@ Note that you can query against your custom usage data
 while also querying against global or regional data.
 For example, the query `> 1% in my stats, > 5% in US, 10%` is permitted.
 
-[`browserslist-ga`]: https://github.com/dmfrancisco/browserslist-ga
+[`browserslist-ga`]: https://github.com/browserslist/browserslist-ga
 [Can I Use]:         http://caniuse.com/
 
 
@@ -405,8 +424,8 @@ var process = function (source, opts) {
 }
 ```
 
-Queries can be a string `"> 5%, last 1 version"`
-or an array `['> 5%', 'last 1 version']`.
+Queries can be a string `"> 1%, IE 10"`
+or an array `['> 1%', 'IE 10']`.
 
 If a query is missing, Browserslist will look for a config file.
 You can provide a `path` option (that can be a file) to find the config file
@@ -426,7 +445,7 @@ Options:
 For non-JS environment and debug purpose you can use CLI tool:
 
 ```sh
-browserslist "> 1%, last 2 versions"
+browserslist "> 1%, IE 10"
 ```
 
 

package/cli.js

@@ -62,20 +62,19 @@ if (isArg('--help') || isArg('-h')) {
     }
   }
 
-  if (!queries && !opts.config) {
-    if (browserslist.findConfig(process.cwd())) {
-      opts.path = process.cwd()
-    } else {
-      error(
-        'Browserslist config was not found. ' +
-        'Define queries or config path.' +
-        '\n\n' + USAGE
-      )
-    }
-  }
-
   var browsers
   try {
+    if (!queries && !opts.config) {
+      if (browserslist.findConfig(process.cwd())) {
+        opts.path = process.cwd()
+      } else {
+        error(
+          'Browserslist config was not found. ' +
+          'Define queries or config path.' +
+          '\n\n' + USAGE
+        )
+      }
+    }
     browsers = browserslist(queries, opts)
   } catch (e) {
     if (e.name === 'BrowserslistError') {

package/index.js

@@ -140,7 +140,7 @@ function resolve (queries, context) {
         var array = type.select.apply(browserslist, args)
         if (isExclude) {
           array = array.concat(array.map(function (j) {
-            return j.replace(/\s\d+/, ' 0')
+            return j.replace(/\s[^\s]+/, ' 0')
           }))
           return result.filter(function (j) {
             return array.indexOf(j) === -1
@@ -332,7 +332,7 @@ browserslist.coverage = function (browsers, stats) {
   return browsers.reduce(function (all, i) {
     var usage = data[i]
     if (usage === undefined) {
-      usage = data[i.replace(/ [\d.]+$/, ' 0')]
+      usage = data[i.replace(/ [^\s]+$/, ' 0')]
     }
     return all + (usage || 0)
   }, 0)
@@ -710,7 +710,7 @@ var QUERIES = [
   {
     regexp: /^dead$/i,
     select: function () {
-      return ['ie 10', 'ie_mob 10', 'bb 10', 'bb 7']
+      return ['ie 10', 'ie_mob 10', 'bb 10', 'bb 7', 'op_mob 12.1']
     }
   },
   {

package/node.js

@@ -7,8 +7,8 @@ var BrowserslistError = require('./error')
 var IS_SECTION = /^\s*\[(.+)\]\s*$/
 var CONFIG_PATTERN = /^browserslist-config-/
 var SCOPED_CONFIG__PATTERN = /@[^./]+\/browserslist-config(-|$)/
-var FORMAT = 'Browserslist config should contain ' +
-             'array of strings with browser queries'
+var FORMAT = 'Browserslist config should be a string or an array ' +
+             'of strings with browser queries'
 
 var filenessCache = { }
 var configCache = { }
@@ -50,13 +50,14 @@ function eachParent (file, callback) {
 }
 
 function check (section) {
-  if (!Array.isArray(section)) {
-    throw new BrowserslistError(FORMAT)
-  }
-  for (var i = 0; i < section.length; i++) {
-    if (typeof section[i] !== 'string') {
-      throw new BrowserslistError(FORMAT)
+  if (Array.isArray(section)) {
+    for (var i = 0; i < section.length; i++) {
+      if (typeof section[i] !== 'string') {
+        throw new BrowserslistError(FORMAT)
+      }
     }
+  } else if (typeof section !== 'string') {
+    throw new BrowserslistError(FORMAT)
   }
 }
 
@@ -99,7 +100,7 @@ module.exports = {
   loadQueries: function loadQueries (context, name) {
     if (!context.dangerousExtend) checkExtend(name)
     // eslint-disable-next-line security/detect-non-literal-require
-    var queries = require(name)
+    var queries = require(require.resolve(name, { paths: ['.'] }))
     if (!Array.isArray(queries)) {
       throw new BrowserslistError(
         '`' + name + '` config exports not an array of queries')

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "browserslist",
-  "version": "3.2.2",
+  "version": "3.2.6",
   "description": "Share target browsers between different front-end tools, like Autoprefixer, Stylelint and babel-env-preset",
   "keywords": [
     "caniuse",
@@ -11,8 +11,8 @@
   "license": "MIT",
   "repository": "browserslist/browserslist",
   "dependencies": {
-    "caniuse-lite": "^1.0.30000819",
-    "electron-to-chromium": "^1.3.40"
+    "caniuse-lite": "^1.0.30000830",
+    "electron-to-chromium": "^1.3.42"
   },
   "bin": "./cli.js",
   "devDependencies": {
@@ -21,15 +21,16 @@
     "eslint-ci": "^0.1.1",
     "eslint-config-logux": "^21.0.0",
     "eslint-config-standard": "^11.0.0",
-    "eslint-plugin-es5": "^1.2.0",
-    "eslint-plugin-import": "^2.9.0",
-    "eslint-plugin-jest": "^21.15.0",
+    "eslint-plugin-es5": "^1.3.1",
+    "eslint-plugin-import": "^2.11.0",
+    "eslint-plugin-jest": "^21.15.1",
     "eslint-plugin-node": "^6.0.1",
     "eslint-plugin-promise": "^3.7.0",
     "eslint-plugin-security": "^1.4.0",
-    "eslint-plugin-standard": "^3.0.1",
+    "eslint-plugin-standard": "^3.1.0",
+    "fs-extra": "^5.0.0",
     "jest": "^22.4.3",
-    "lint-staged": "^7.0.0",
+    "lint-staged": "^7.0.4",
     "pre-commit": "^1.1.3",
     "size-limit": "^0.17.0",
     "yaspeller-ci": "^1.0.0"