{
  "name": "browserslist",
  "version": "1.7.7",
  "description": "Share browsers list between different front-end tools, like Autoprefixer, Stylelint and babel-env-preset",
  "keywords": [
    "caniuse",
    "browsers"
  ],
  "author": {
    "name": "Andrey Sitnik",
    "email": "andrey@sitnik.ru"
  },
  "license": "MIT",
  "repository": {
    "type": "git",
    "url": "git://github.com/ai/browserslist"
  },
  "dependencies": {
    "caniuse-db": "^1.0.30000639",
    "electron-to-chromium": "^1.2.7"
  },
  "bin": {
    "browserslist": "./cli.js"
  },
  "devDependencies": {
    "eslint": "^3.18.0",
    "eslint-config-postcss": "^2.0.2",
    "jest": "^19.0.2",
    "lint-staged": "^3.4.0",
    "pre-commit": "^1.1.3",
    "yaspeller-ci": "^0.3.0"
  },
  "eslintConfig": {
    "extends": "eslint-config-postcss/es5",
    "env": {
      "jest": true
    },
    "rules": {
      "consistent-return": "off",
      "no-process-exit": "off",
      "valid-jsdoc": "error"
    }
  },
  "jest": {
    "coverageThreshold": {
      "global": {
        "statements": 100
      }
    }
  },
  "scripts": {
    "lint-staged": "lint-staged",
    "test": "jest --coverage && eslint *.js test/*.js && yaspeller-ci *.md"
  },
  "lint-staged": {
    "*.md": "yaspeller-ci",
    "*.js": "eslint"
  },
  "pre-commit": [
    "lint-staged"
  ],
  "readme": "# Browserslist\n\nLibrary to share supported browsers list between different front-end tools.\nIt is used in [Autoprefixer], [Stylelint], [eslint-plugin-compat]\nand [babel-env-preset].\n\nAll tools that rely on Browserslist will find its config automatically,\nwhen you add the following to `package.json`:\n\n```json\n{\n  \"browserslist\": [\n    \"> 1%\",\n    \"last 2 versions\"\n  ]\n}\n```\n\nOr in `browserslist` config:\n\n```yaml\n# Browsers that we support\n\n> 1%\nLast 2 versions\nIE 10 # sorry\n```\n\nDevelopers set browsers list in queries like `last 2 version`\nto be free from updating browser versions manually.\nBrowserslist will use [Can i Use] data for this queries.\n\nBrowserslist will take browsers queries from tool option,\n`browserslist` config, `browserslist` section in `package.json`\nor environment variables.\n\nYou can test Browserslist queries in [online demo].\n\n<a href=\"https://evilmartians.com/?utm_source=browserslist\">\n  <img src=\"https://evilmartians.com/badges/sponsored-by-evil-martians.svg\"\n    alt=\"Sponsored by Evil Martians\"\n    width=\"236\"\n    height=\"54\"\n  \\>\n</a>\n\n[eslint-plugin-compat]: https://github.com/amilajack/eslint-plugin-compat\n[babel-env-preset]:     https://github.com/babel/babel-preset-env\n[Autoprefixer]:         https://github.com/postcss/autoprefixer\n[online demo]:          http://browserl.ist/\n[Stylelint]:            http://stylelint.io/\n[Can I Use]:            http://caniuse.com/\n\n## Queries\n\nBrowserslist will use browsers query from one of this sources:\n\n1. Tool options. For example `browsers` option in Autoprefixer.\n2. `BROWSERSLIST` environment variable.\n3. `browserslist` config file in current or parent directories.\n4. `browserslist` key in `package.json` file in current or parent directories.\n5. If the above methods did not produce a valid result\n   Browserslist will use defaults: `> 1%, last 2 versions, Firefox ESR`.\n\nWe recommend to write queries in `browserslist` config or `package.json`.\n\nYou can specify the versions by queries (case insensitive):\n\n* `last 2 versions`: the last 2 versions for each major browser.\n* `last 2 Chrome versions`: the last 2 versions of Chrome browser.\n* `> 5%`: versions selected by global usage statistics.\n* `> 5% in US`: uses USA usage statistics. It accepts [two-letter country code].\n* `> 5% in my stats`: uses [custom usage data].\n* `ie 6-8`: selects an inclusive range of versions.\n* `Firefox > 20`: versions of Firefox newer than 20.\n* `Firefox >= 20`: versions of Firefox newer than or equal to 20.\n* `Firefox < 20`: versions of Firefox less than 20.\n* `Firefox <= 20`: versions of Firefox less than or equal to 20.\n* `Firefox ESR`: the latest [Firefox ESR] version.\n* `iOS 7`: the iOS browser version 7 directly.\n* `not ie <= 8`: exclude browsers selected before by previous queries.\n  You can add `not ` to any query.\n\nBrowserslist works with separated versions of browsers.\nYou should avoid queries like `Firefox > 0`.\n\nMultiple criteria are combined as a boolean `OR`. A browser version must match\nat least one of the criteria to be selected.\n\nAll queries are based on the [Can I Use] support table,\ne.g. `last 3 iOS versions` might select `8.4, 9.2, 9.3` (mixed major and minor),\nwhereas `last 3 Chrome versions` might select `50, 49, 48` (major only).\n\n[two-letter country code]: http://en.wikipedia.org/wiki/ISO_3166-1_alpha-2#Officially_assigned_code_elements\n[custom usage data]:        #custom-usage-data\n[Can I Use]:                http://caniuse.com/\n\n## Browsers\n\nNames are case insensitive:\n\n### Major Browsers\n\n* `Chrome` for Google Chrome.\n* `Firefox` or `ff` for Mozilla Firefox.\n* `Explorer` or `ie` for Internet Explorer.\n* `Edge` for Microsoft Edge.\n* `iOS` or `ios_saf` for iOS Safari.\n* `Opera` for Opera.\n* `Safari` for desktop Safari.\n* `ExplorerMobile` or `ie_mob` for Internet Explorer Mobile.\n\n### Others\n\n* `Android` for Android WebView.\n* `BlackBerry` or `bb` for Blackberry browser.\n* `ChromeAndroid` or `and_chr` for Chrome for Android\n  (in Other section, because mostly same as common `Chrome`).\n* `FirefoxAndroid` or `and_ff` for Firefox for Android.\n* `OperaMobile` or `op_mob` for Opera Mobile.\n* `OperaMini` or `op_mini` for Opera Mini.\n* `Samsung` for Samsung Internet.\n* `UCAndroid` or `and_uc` for UC Browser for Android.\n* `Electron` for Electron framework. It will be converted to Chrome version.\n\n### Electron\n\n[`electron-to-chromium`](https://www.npmjs.com/package/electron-to-chromium)\ncould return a compatible Browserslist query\nfor your (major) Electron version:\n\n```js\nconst e2c = require('electron-to-chromium')\nautoprefixer({\n    browsers: e2c.electronToBrowserList('1.4') //=> \"Chrome >= 53\"\n})\n```\n\n## Config File\n\nBrowserslist config should be named `browserslist` and have browsers queries\nsplit by a new line. Comments starts with `#` symbol:\n\n```yaml\n# Browsers that we support\n\n> 1%\nLast 2 versions\nIE 8 # sorry\n```\n\nBrowserslist will check config in every directory in `path`.\nSo, if tool process `app/styles/main.css`, you can put config to root,\n`app/` or `app/styles`.\n\nYou can specify direct path in `BROWSERSLIST_CONFIG` environment variables.\n\n## `package.json`\n\nIf you want to reduce config files in project root, you can specify\nbrowsers in `package.json` with `browserslist` key:\n\n```js\n{\n  \"private\": true,\n  \"dependencies\": {\n    \"autoprefixer\": \"^6.5.4\"\n  },\n  \"browserslist\": [\n    \"> 1%\",\n    \"last 2 versions\"\n  ]\n}\n```\n\n## Environments\n\nYou can also specify different browser queries for various environments.\nBrowserslist will choose query according to `BROWSERSLIST_ENV` or `NODE_ENV`\nvariables. If none of them is declared, Browserslist will firstly look\nfor `development` queries and then use defaults.\n\nIn `package.json`:\n\n```js\n{\n  …\n  \"browserslist\": {\n    \"production\": [\n      \"last 2 version\",\n      \"ie 9\"\n    ],\n    \"development\": [\n      \"last 1 version\"\n    ]\n  }\n}\n```\n\nIn `browserslist` config:\n\n```ini\n[production]\nlast 2 version\nie 9\n\n[development]\nlast 1 version\n```\n\n## Environment Variables\n\nIf some tool use Browserslist inside, you can change browsers settings\nby [environment variables]:\n\n* `BROWSERSLIST` with browsers queries.\n\n   ```sh\n  BROWSERSLIST=\"> 5%\" gulp css\n   ```\n\n* `BROWSERSLIST_CONFIG` with path to config file.\n\n   ```sh\n  BROWSERSLIST_CONFIG=./config/browserslist gulp css\n   ```\n\n* `BROWSERSLIST_ENV` with environments string.\n\n   ```sh\n  BROWSERSLIST_ENV=\"development\" gulp css\n   ```\n\n* `BROWSERSLIST_STATS` with path to the custom usage data\n  for `> 1% in my stats` query.\n\n   ```sh\n  BROWSERSLIST_STATS=./config/usage_data.json gulp css\n   ```\n\n[environment variables]: https://en.wikipedia.org/wiki/Environment_variable\n\n## Custom Usage Data\n\nIf you have a website, you can query against the usage statistics of your site:\n\n1. Import your Google Analytics data into [Can I Use].\n   Press `Import…` button in Settings page.\n2. Open browser DevTools on [Can I Use] and paste this snippet\n   into the browser console:\n\n    ```js\n   var e=document.createElement('a');e.setAttribute('href', 'data:text/plain;charset=utf-8,'+encodeURIComponent(JSON.stringify(JSON.parse(localStorage['usage-data-by-id'])[localStorage['config-primary_usage']])));e.setAttribute('download','stats.json');document.body.appendChild(e);e.click();document.body.removeChild(e);\n    ```\n3. Save the data to a `browserslist-stats.json` file in your project.\n\nOf course, you can generate usage statistics file by any other method.\nFile format should be like:\n\n```js\n{\n  \"ie\": {\n    \"6\": 0.01,\n    \"7\": 0.4,\n    \"8\": 1.5\n  },\n  \"chrome\": {\n    …\n  },\n  …\n}\n```\n\nNote that you can query against your custom usage data\nwhile also querying against global or regional data.\nFor example, the query `> 1% in my stats, > 5% in US, 10%` is permitted.\n\n[Can I Use]: http://caniuse.com/\n\n## JS API\n\n```js\nvar browserslist = require('browserslist');\n\n// Your CSS/JS build tool code\nvar process = function (source, opts) {\n    var browsers = browserslist(opts.browsers, {\n        stats: opts.stats,\n        path:  opts.file,\n        env:   opts.env\n    });\n    // Your code to add features for selected browsers\n}\n```\n\nQueries can be a string `\"> 5%, last 1 version\"`\nor an array `['> 5%', 'last 1 version']`.\n\nIf a query is missing, Browserslist will look for a config file.\nYou can provide a `path` option (that can be a file) to find the config file\nrelatively to it.\n\nFor non-JS environment and debug purpose you can use CLI tool:\n\n```sh\nbrowserslist \"> 1%, last 2 versions\"\n```\n\n## Coverage\n\nYou can get total users coverage for selected browsers by JS API:\n\n```js\nbrowserslist.coverage(browserslist('> 1%')) //=> 81.4\n```\n\n```js\nbrowserslist.coverage(browserslist('> 1% in US'), 'US') //=> 83.1\n```\n\nOr by CLI:\n\n```sh\n$ browserslist --coverage \"> 1%\"\nThese browsers account for 81.4% of all users globally\n```\n\n```sh\n$ browserslist --coverage=US \"> 1% in US\"\nThese browsers account for 83.1% of all users in the US\n```\n",
  "readmeFilename": "README.md",
  "bugs": {
    "url": "https://github.com/ai/browserslist/issues"
  },
  "_id": "browserslist@1.7.7",
  "dist": {
    "shasum": "dea2941e07ebfb1940938820b1457aace34a593a"
  },
  "_from": "browserslist@^1.7.6",
  "_resolved": "http://registry.npmjs.org/browserslist/-/browserslist-1.7.7.tgz"
}