browserslist 3.2.6 → 4.0.1

package/CHANGELOG.md

@@ -1,6 +1,23 @@
 # Change Log
 This project adheres to [Semantic Versioning](http://semver.org/).
 
+## 4.0.1
+* Reduce npm package size.
+* Fix docs.
+
+## 4.0.0 “Erinaceus amurensis”
+* Add `node X` and `maintained node versions` queries (by Pavel Vostrikov).
+* Remove Node.js 4 support.
+* Show warning if `caniuse-lite` is old (by Anton Tuzhik).
+* Add comma support in config file.
+
+## 3.2.8
+* Add IE 9-5.5 to dead browsers.
+* Remove development configs from npm package.
+
+## 3.2.7
+* Add Firefox 60 as Firefox ESR.
+
 ## 3.2.6
 * Add Opera Mini 12 to dead browsers.
 * Update docs (by Jamie Kyle).
@@ -38,7 +55,7 @@ This project adheres to [Semantic Versioning](http://semver.org/).
 * Add `ignoreUnknownVersions` option.
 * Fix docs (by Pascal Duez).
 
-## 3.0
+## 3.0 “Atelerix sclateri”
 * Remove country statistics from client-side build of Browserslist.
 * Change `> 1%` to `> 0.5%` in default query.
 * Add `not dead` to default query.
@@ -139,7 +156,7 @@ This project adheres to [Semantic Versioning](http://semver.org/).
 ## 2.1
 * Add `>= 5%`, `>= 5% in US` and `>= 5% in my stats` queries.
 
-## 2.0
+## 2.0 “Atelerix frontalis”
 * `last n versions` returns versions for all browsers, not only main browsers.
 * Cache file system operations (by Aarni Koskela).
 * Use `caniuse-lite` 1 MB instead of `caniuse-db` 7 MB (by Ben Briggs).
@@ -238,7 +255,7 @@ This project adheres to [Semantic Versioning](http://semver.org/).
 ## 1.0.1
 * Update Firefox ESR (by Rouven Weßling).
 
-## 1.0
+## 1.0 “Atelerix algirus”
 * Remove Opera 12.1 from default query.
 * Add `not` keyword and exclude browsers by query.
 * Add Microsoft Edge support (by Andrey Polischuk).
@@ -277,5 +294,5 @@ This project adheres to [Semantic Versioning](http://semver.org/).
 ## 0.1.1
 * Sort browsers by name and version.
 
-## 0.1
+## 0.1 “Atelerix albiventris”
 * Initial release.

package/README.md

@@ -1,13 +1,13 @@
 # Browserslist [![Cult Of Martians][cult-img]][cult]
 
-<img align="right" width="120" height="120"
-     src="./logo.svg" alt="Browserslist logo by Anton Lovchikov">
+<img width="120" height="120" alt="Browserslist logo by Anton Lovchikov"
+     src="http://browserslist.github.io/browserslist/logo.svg" align="right">
 
-Library to share target browsers between different front-end tools.
-It is used in:
+The config to share target browsers and Node.js versions between different
+front-end tools. It is used in:
 
 * [Autoprefixer]
-* [babel-preset-env]
+* [Babel]
   (external config in `package.json` or `browserslist` will be supported in 7.0)
 * [postcss-preset-env]
 * [eslint-plugin-compat]
@@ -21,8 +21,10 @@ when you add the following to `package.json`:
 ```json
 {
   "browserslist": [
+    "last 1 version",
     "> 1%",
-    "IE 10"
+    "maintained node versions",
+    "not dead"
   ]
 }
 ```
@@ -32,15 +34,17 @@ Or in `.browserslistrc` config:
 ```yaml
 # Browsers that we support
 
+last 1 version
 > 1%
-IE 10 # sorry
+maintained node versions
+not dead
 ```
 
-Developers set browsers list in queries like `last 2 version`
-to be free from updating browser versions manually.
+Developers set versions list in queries like `last 2 version`
+to be free from updating versions manually.
 Browserslist will use [Can I Use] data for this queries.
 
-Browserslist will take browsers queries from tool option,
+Browserslist will take queries from tool option,
 `browserslist` config, `.browserslistrc` config,
 `browserslist` section in `package.json` or environment variables.
 
@@ -58,11 +62,11 @@ You can test Browserslist queries in [online demo].
 [eslint-plugin-compat]:                      https://github.com/amilajack/eslint-plugin-compat
 [Browserslist Example]:                       https://github.com/browserslist/browserslist-example
 [postcss-preset-env]:                        https://github.com/jonathantneal/postcss-preset-env
-[babel-preset-env]:                          https://github.com/babel/babel/tree/master/packages/babel-preset-env
 [postcss-normalize]:                         https://github.com/jonathantneal/postcss-normalize
 [Autoprefixer]:                              https://github.com/postcss/autoprefixer
 [online demo]:                               http://browserl.ist/
 [Can I Use]:                                 http://caniuse.com/
+[Babel]:                          https://github.com/babel/babel/tree/master/packages/babel-preset-env
 
 ## Tools
 
@@ -70,19 +74,23 @@ You can test Browserslist queries in [online demo].
   to use it in `> 0.5% in my stats` query.
 * [`browserslist-useragent`] checks browser by user agent string
   to match Browserslist target browsers query.
+* [`browserslist-useragent-ruby`] is a Ruby library to checks browser
+  by user agent string to match Browserslist.
 * [`caniuse-api`] returns browsers which support some specific feature.
 * Run `npx browserslist` in your project directory to see project’s
   target browsers. This CLI tool is built-in and available in any project
   with Autoprefixer.
 
-[`browserslist-useragent`]: https://github.com/pastelsky/browserslist-useragent
-[`browserslist-ga`]:        https://github.com/browserslist/browserslist-ga
-[`caniuse-api`]:            https://github.com/Nyalab/caniuse-api
+[`browserslist-useragent-ruby`]: https://github.com/browserslist/browserslist-useragent-ruby
+[`browserslist-useragent`]:      https://github.com/pastelsky/browserslist-useragent
+[`browserslist-ga`]:             https://github.com/browserslist/browserslist-ga
+[`caniuse-api`]:                 https://github.com/Nyalab/caniuse-api
 
 
 ## Queries
 
-Browserslist will use browsers query from one of this sources:
+Browserslist will use browsers and Node.js versions query
+from one of this sources:
 
 1. Tool options. For example `browsers` option in Autoprefixer.
 2. `BROWSERSLIST` environment variable.
@@ -97,25 +105,26 @@ Browserslist will use browsers query from one of this sources:
 
 ### 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`.
+* If you want to change the default set of browsers we recommend to combine
+  `last 1 version`, `not dead` with `> 0.2%` (or `> 1% in US`,
+  `> 1% in my stats`). Just `last n versions` adds too many dead browsers
+  and does not add popular old versions. Just `> 0.2%` make popular browsers
+  even more popular, so we will have a monopoly and stagnation, as we had
+  with Internet Explorer 6.
+* Don’t remove browsers just because you don’t know them. Opera Mini has
+  100 million users in Africa and it is more popular in global market,
+  than Microsoft Edge. Chinese QQ Browsers has more market share than Firefox
+  and desktop Safari altogether.
 
 
 ### Full List
 
-You can specify the versions by queries (case insensitive):
+You can specify the browser and Node.js versions by queries (case insensitive):
 
-* `> 5%`: versions selected by global usage statistics.
+* `> 5%`: browsers versions selected by global usage statistics.
   `>=`, `<` and `<=` work too.
 * `> 5% in US`: uses USA usage statistics. It accepts [two-letter country code].
 * `> 5% in alt-AS`: uses Asia region usage statistics. List of all region codes
@@ -124,6 +133,10 @@ You can specify the versions by queries (case insensitive):
 * `cover 99.5%`: most popular browsers that provide coverage.
 * `cover 99.5% in US`: same as above, with [two-letter country code].
 * `cover 99.5% in my stats`: uses [custom usage data].
+* `maintained node versions`: all Node.js versions, which are [still maintained]
+  by Node.js Foundation.
+* `node 10` and `node 10.4`: selects latest Node.js `10.x.x`
+  or `10.4.x` release.
 * `extends browserslist-config-mycompany`: take queries from
   `browserslist-config-mycompany` npm package.
 * `ie 6-8`: selects an inclusive range of versions.
@@ -189,6 +202,7 @@ whereas `last 3 Chrome versions` might select `50, 49, 48` (major only).
 [`caniuse-lite/data/regions`]: https://github.com/ben-eb/caniuse-lite/tree/master/data/regions
 [two-letter country code]:     http://en.wikipedia.org/wiki/ISO_3166-1_alpha-2#Officially_assigned_code_elements
 [custom usage data]:           #custom-usage-data
+[still maintained]:            https://github.com/nodejs/Release
 [Can I Use]:                   http://caniuse.com/
 
 
@@ -208,6 +222,7 @@ Names are case insensitive:
 * `Firefox` or `ff` for Mozilla Firefox.
 * `FirefoxAndroid` or `and_ff` for Firefox for Android.
 * `iOS` or `ios_saf` for iOS Safari.
+* `Node` for Node.js.
 * `Opera` for Opera.
 * `OperaMini` or `op_mini` for Opera Mini.
 * `OperaMobile` or `op_mob` for Opera Mobile.
@@ -229,6 +244,7 @@ browsers in `package.json` with `browserslist` key:
     "autoprefixer": "^6.5.4"
   },
   "browserslist": [
+    "last 1 version",
     "> 1%",
     "IE 10"
   ]
@@ -244,6 +260,7 @@ and have browsers queries split by a new line. Comments starts with `#` symb
 ```yaml
 # Browsers that we support
 
+last 1 version
 > 1%
 IE 10 # sorry
 ```
@@ -293,6 +310,7 @@ When writing a shared Browserslist package, just export an array.
 
 ```js
 module.exports = [
+  'last 1 version',
   '> 1%',
   'ie 10'
 ]

package/browser.js

@@ -31,5 +31,7 @@ module.exports = {
 
   findConfig: noop,
 
-  clearCaches: noop
+  clearCaches: noop,
+
+  oldDataWarning: noop
 }

package/cli.js

@@ -38,7 +38,7 @@ if (isArg('--help') || isArg('-h')) {
 
   for (var i = 0; i < args.length; i++) {
     if (args[i][0] !== '-') {
-      queries = args[i].replace(/^['"]|['"]$/g, '')
+      queries = args[i].replace(/^["']|["']$/g, '')
       continue
     }
 
@@ -46,7 +46,7 @@ if (isArg('--help') || isArg('-h')) {
     var name = arg[0]
     var value = arg[1]
 
-    if (value) value = value.replace(/^['"]|['"]$/g, '')
+    if (value) value = value.replace(/^["']|["']$/g, '')
 
     if (name === '--config' || name === '-b') {
       opts.config = value

package/index.js

@@ -1,8 +1,9 @@
+var jsReleases = require('node-releases/data/processed/envs.json')
+var agents = require('caniuse-lite/dist/unpacker/agents').agents
+var jsEOL = require('node-releases/data/release-schedule/release-schedule.json')
 var path = require('path')
 var e2c = require('electron-to-chromium/versions')
 
-var agents = require('caniuse-lite/dist/unpacker/agents').agents
-
 var BrowserslistError = require('./error')
 var env = require('./node') // Will load browser.js in webpack
 
@@ -140,7 +141,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[^\s]+/, ' 0')
+            return j.replace(/\s\S+/, ' 0')
           }))
           return result.filter(function (j) {
             return array.indexOf(j) === -1
@@ -206,6 +207,7 @@ function browserslist (queries, opts) {
     dangerousExtend: opts.dangerousExtend
   }
 
+  env.oldDataWarning(browserslist.data)
   var stats = env.getStat(opts)
   if (stats) {
     context.customUsage = { }
@@ -332,7 +334,7 @@ browserslist.coverage = function (browsers, stats) {
   return browsers.reduce(function (all, i) {
     var usage = data[i]
     if (usage === undefined) {
-      usage = data[i.replace(/ [^\s]+$/, ' 0')]
+      usage = data[i.replace(/ \S+$/, ' 0')]
     }
     return all + (usage || 0)
   }, 0)
@@ -648,7 +650,7 @@ var QUERIES = [
   {
     regexp: /^(firefox|ff|fx)\s+esr$/i,
     select: function () {
-      return ['firefox 52']
+      return ['firefox 52', 'firefox 60']
     }
   },
   {
@@ -668,6 +670,38 @@ var QUERIES = [
       return ['chrome ' + chrome]
     }
   },
+  {
+    regexp: /^node\s+(\d+(\.\d+)?(\.\d+)?)$/i,
+    select: function (context, version) {
+      var nodeReleases = jsReleases.filter(function (i) {
+        return i.name === 'nodejs'
+      })
+      var matched = nodeReleases.filter(function (i) {
+        return (i.version + '.').indexOf(version + '.') === 0
+      })
+      if (matched.length === 0) {
+        if (context.ignoreUnknownVersions) {
+          return []
+        } else {
+          throw new BrowserslistError(
+            'Unknown version ' + version + ' of Node.js')
+        }
+      }
+      return ['node ' + matched[matched.length - 1].version]
+    }
+  },
+  {
+    regexp: /^maintained\s+node\s+versions$/i,
+    select: function (context) {
+      var now = Date.now()
+      var queries = Object.keys(jsEOL).filter(function (key) {
+        return now < Date.parse(jsEOL[key].end)
+      }).map(function (key) {
+        return 'node ' + key.slice(1)
+      })
+      return resolve(queries, context)
+    }
+  },
   {
     regexp: /^(\w+)\s+(tp|[\d.]+)$/i,
     select: function (context, name, version) {
@@ -709,8 +743,9 @@ var QUERIES = [
   },
   {
     regexp: /^dead$/i,
-    select: function () {
-      return ['ie 10', 'ie_mob 10', 'bb 10', 'bb 7', 'op_mob 12.1']
+    select: function (context) {
+      var dead = ['ie <= 10', 'ie_mob <= 10', 'bb <= 10', 'op_mob <= 12.1']
+      return resolve(dead, context)
     }
   },
   {

package/node.js

@@ -7,9 +7,11 @@ var BrowserslistError = require('./error')
 var IS_SECTION = /^\s*\[(.+)\]\s*$/
 var CONFIG_PATTERN = /^browserslist-config-/
 var SCOPED_CONFIG__PATTERN = /@[^./]+\/browserslist-config(-|$)/
+var TIME_TO_UPDATE_CANIUSE = 6 * 30 * 24 * 60 * 60 * 1000
 var FORMAT = 'Browserslist config should be a string or an array ' +
              'of strings with browser queries'
 
+var dataTimeChecked = false
 var filenessCache = { }
 var configCache = { }
 
@@ -96,6 +98,19 @@ function parsePackage (file) {
   return list
 }
 
+function latestReleaseTime (agents) {
+  var latest = 0
+  for (var name in agents) {
+    var dates = agents[name].releaseDate || { }
+    for (var key in dates) {
+      if (latest < dates[key]) {
+        latest = dates[key]
+      }
+    }
+  }
+  return latest * 1000
+}
+
 module.exports = {
   loadQueries: function loadQueries (context, name) {
     if (!context.dangerousExtend) checkExtend(name)
@@ -174,7 +189,7 @@ module.exports = {
 
     string.toString()
       .replace(/#[^\n]*/g, '')
-      .split(/\n/)
+      .split(/\n|,/)
       .map(function (line) {
         return line.trim()
       })
@@ -256,7 +271,30 @@ module.exports = {
   },
 
   clearCaches: function clearCaches () {
+    dataTimeChecked = false
     filenessCache = { }
     configCache = { }
+  },
+
+  oldDataWarning: function oldDataWarning (agentsObj) {
+    if (dataTimeChecked) return
+    dataTimeChecked = true
+
+    var latest = latestReleaseTime(agentsObj)
+    var halfYearAgo = Date.now() - TIME_TO_UPDATE_CANIUSE
+
+    if (latest !== 0 && latest < halfYearAgo) {
+      var command = 'npm update'
+      eachParent(__filename, function (dir) {
+        var pckg = path.join(dir, 'package.json')
+        var yarnLock = path.join(dir, 'yarn.lock')
+        if (isFile(pckg) && isFile(yarnLock)) {
+          command = 'yarn upgrade'
+        }
+      })
+      console.warn(
+        'Browserslist: caniuse-lite is outdated. ' +
+        'Please run next command `' + command + ' caniuse-lite browserslist`')
+    }
   }
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "browserslist",
-  "version": "3.2.6",
+  "version": "4.0.1",
   "description": "Share target browsers between different front-end tools, like Autoprefixer, Stylelint and babel-env-preset",
   "keywords": [
     "caniuse",
@@ -11,77 +11,14 @@
   "license": "MIT",
   "repository": "browserslist/browserslist",
   "dependencies": {
-    "caniuse-lite": "^1.0.30000830",
-    "electron-to-chromium": "^1.3.42"
+    "caniuse-lite": "^1.0.30000865",
+    "electron-to-chromium": "^1.3.52",
+    "node-releases": "^1.0.0-alpha.10"
   },
   "bin": "./cli.js",
-  "devDependencies": {
-    "cross-spawn": "^6.0.5",
-    "eslint": "^4.19.1",
-    "eslint-ci": "^0.1.1",
-    "eslint-config-logux": "^21.0.0",
-    "eslint-config-standard": "^11.0.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.1.0",
-    "fs-extra": "^5.0.0",
-    "jest": "^22.4.3",
-    "lint-staged": "^7.0.4",
-    "pre-commit": "^1.1.3",
-    "size-limit": "^0.17.0",
-    "yaspeller-ci": "^1.0.0"
-  },
-  "eslintConfig": {
-    "extends": "eslint-config-logux/browser",
-    "rules": {
-      "security/detect-unsafe-regex": "off",
-      "global-require": "off"
-    },
-    "overrides": {
-      "files": [
-        "*.test.js"
-      ],
-      "rules": {
-        "es5/no-arrow-functions": "off"
-      }
-    }
-  },
-  "jest": {
-    "testEnvironment": "node",
-    "coverageThreshold": {
-      "global": {
-        "statements": 100
-      }
-    },
-    "modulePathIgnorePatterns": [
-      "<rootDir>/test/fixtures"
-    ]
-  },
-  "size-limit": [
-    {
-      "path": "index.js",
-      "limit": "7.2 KB"
-    }
-  ],
-  "scripts": {
-    "lint-staged": "lint-staged",
-    "spellcheck": "yaspeller-ci README.md CHANGELOG.md",
-    "lint": "eslint-ci *.js test/*.js benchmark/*.js",
-    "test": "jest --coverage && yarn lint && yarn spellcheck && size-limit"
-  },
-  "lint-staged": {
-    "*.md": "yaspeller-ci",
-    "*.js": "eslint"
-  },
+  "scripts": {},
   "browser": {
     "./node.js": "./browser.js",
     "path": false
-  },
-  "pre-commit": [
-    "lint-staged"
-  ]
+  }
 }