Files
asciidisco.com/build/node_modules/browserslist/index.js
2023-08-01 13:49:46 +02:00

870 lines
23 KiB
JavaScript

var process = require('process')
var path = require('path')
var e2c = require('electron-to-chromium/versions')
var fs = require('fs')
var agents = require('caniuse-lite/dist/unpacker/agents').agents
var region = require('caniuse-lite/dist/unpacker/region').default
function normalize (versions) {
return versions.filter(function (version) {
return typeof version === 'string'
})
}
function nameMapper (name) {
return function mapName (version) {
return name + ' ' + version
}
}
function getMajor (version) {
return parseInt(version.split('.')[0])
}
function getMajorVersions (released, number) {
if (released.length === 0) return []
var minimum = getMajor(released[released.length - 1]) - parseInt(number) + 1
var selected = []
for (var i = released.length - 1; i >= 0; i--) {
if (minimum > getMajor(released[i])) break
selected.unshift(released[i])
}
return selected
}
var env = process && process.env ? process.env : { }
var FLOAT_RANGE = /^\d+(\.\d+)?(-\d+(\.\d+)?)*$/
var IS_SECTION = /^\s*\[(.+)\]\s*$/
function uniq (array) {
var filtered = []
for (var i = 0; i < array.length; i++) {
if (filtered.indexOf(array[i]) === -1) filtered.push(array[i])
}
return filtered
}
function BrowserslistError (message) {
this.name = 'BrowserslistError'
this.message = message || ''
this.browserslist = true
if (Error.captureStackTrace) {
Error.captureStackTrace(this, BrowserslistError)
}
}
BrowserslistError.prototype = Error.prototype
// Helpers
function fillUsage (result, name, data) {
for (var i in data) {
result[name + ' ' + i] = data[i]
}
}
var filenessCache = {}
var configCache = {}
function isFile (file) {
if (file in filenessCache) {
return filenessCache[file]
}
var result = fs.existsSync(file) && fs.statSync(file).isFile()
if (!env.BROWSERSLIST_DISABLE_CACHE) {
filenessCache[file] = result
}
return result
}
function eachParent (file, callback) {
var loc = path.resolve(file)
do {
var result = callback(loc)
if (typeof result !== 'undefined') return result
} while (loc !== (loc = path.dirname(loc)))
return undefined
}
function getStat (opts) {
if (opts.stats) {
return opts.stats
} else if (env.BROWSERSLIST_STATS) {
return env.BROWSERSLIST_STATS
} else if (opts.path && path.resolve) {
return eachParent(opts.path, function (dir) {
var file = path.join(dir, 'browserslist-stats.json')
return isFile(file) ? file : undefined
})
}
return undefined
}
function parsePackage (file) {
var config = JSON.parse(fs.readFileSync(file))
if (config.browserlist && !config.browserslist) {
throw new BrowserslistError(
'`browserlist` key instead of `browserslist` in ' + file)
}
var list = config.browserslist
if (typeof list === 'object' && list.length) {
list = { defaults: list }
}
return list
}
function pickEnv (config, opts) {
if (typeof config !== 'object') return config
var name
if (typeof opts.env === 'string') {
name = opts.env
} else if (env.BROWSERSLIST_ENV) {
name = env.BROWSERSLIST_ENV
} else if (env.NODE_ENV) {
name = env.NODE_ENV
} else {
name = 'development'
}
return config[name] || config.defaults
}
function generateFilter (sign, version) {
version = parseFloat(version)
if (sign === '>') {
return function (v) {
return parseFloat(v) > version
}
} else if (sign === '>=') {
return function (v) {
return parseFloat(v) >= version
}
} else if (sign === '<') {
return function (v) {
return parseFloat(v) < version
}
} else {
return function (v) {
return parseFloat(v) <= version
}
}
}
function compareStrings (a, b) {
if (a < b) return -1
if (a > b) return +1
return 0
}
function resolve (queries, context) {
return queries.reduce(function (result, selection, index) {
selection = selection.trim()
if (selection === '') return result
var isExclude = selection.indexOf('not ') === 0
if (isExclude) {
if (index === 0) {
throw new BrowserslistError(
'Write any browsers query (for instance, `defaults`) ' +
'before `' + selection + '`')
}
selection = selection.slice(4)
}
for (var i = 0; i < QUERIES.length; i++) {
var type = QUERIES[i]
var match = selection.match(type.regexp)
if (match) {
var args = [context].concat(match.slice(1))
var array = type.select.apply(browserslist, args)
if (isExclude) {
array = array.concat(array.map(function (j) {
return j.replace(/\s\d+/, ' 0')
}))
return result.filter(function (j) {
return array.indexOf(j) === -1
})
}
return result.concat(array)
}
}
throw new BrowserslistError('Unknown browser query `' + selection + '`')
}, [])
}
/**
* Return array of browsers by selection queries.
*
* @param {(string|string[])} [queries=browserslist.defaults] Browser queries.
* @param {object} opts Options.
* @param {string} [opts.path="."] Path to processed file.
* It will be used to find config files.
* @param {string} [opts.env="development"] Processing environment.
* It will be used to take right
* queries from config file.
* @param {string} [opts.config] Path to config file with queries.
* @param {object} [opts.stats] Custom browser usage statistics
* for "> 1% in my stats" query.
* @return {string[]} Array with browser names in Can I Use.
*
* @example
* browserslist('IE >= 10, IE 8') //=> ['ie 11', 'ie 10', 'ie 8']
*/
function browserslist (queries, opts) {
if (typeof opts === 'undefined') opts = { }
if (!opts.hasOwnProperty('path')) {
opts.path = path.resolve ? path.resolve('.') : '.'
}
if (typeof queries === 'undefined' || queries === null) {
if (env.BROWSERSLIST) {
queries = env.BROWSERSLIST
} else if (opts.config || env.BROWSERSLIST_CONFIG) {
var file = opts.config || env.BROWSERSLIST_CONFIG
if (path.basename(file) === 'package.json') {
queries = pickEnv(parsePackage(file), opts)
} else {
queries = pickEnv(browserslist.readConfig(file), opts)
}
} else if (opts.path) {
queries = pickEnv(browserslist.findConfig(opts.path), opts)
}
}
if (typeof queries === 'undefined' || queries === null) {
queries = browserslist.defaults
}
if (typeof queries === 'string') {
queries = queries.split(/,\s*/)
}
if (!Array.isArray(queries)) {
throw new BrowserslistError(
'Browser queries must be an array. Got ' + typeof queries + '.')
}
var context = { dangerousExtend: opts.dangerousExtend }
var stats = getStat(opts)
if (stats) {
if (typeof stats === 'string') {
try {
stats = JSON.parse(fs.readFileSync(stats))
} catch (e) {
throw new BrowserslistError('Can\'t read ' + stats)
}
}
if ('dataByBrowser' in stats) {
stats = stats.dataByBrowser
}
context.customUsage = { }
for (var browser in stats) {
fillUsage(context.customUsage, browser, stats[browser])
}
}
var result = resolve(queries, context).map(function (i) {
var parts = i.split(' ')
var name = parts[0]
var version = parts[1]
if (version === '0') {
return name + ' ' + byName(name).versions[0]
} else {
return i
}
}).sort(function (name1, name2) {
name1 = name1.split(' ')
name2 = name2.split(' ')
if (name1[0] === name2[0]) {
if (FLOAT_RANGE.test(name1[1]) && FLOAT_RANGE.test(name2[1])) {
return parseFloat(name2[1]) - parseFloat(name1[1])
} else {
return compareStrings(name2[1], name1[1])
}
} else {
return compareStrings(name1[0], name2[0])
}
})
return uniq(result)
}
function normalizeVersion (data, version) {
if (data.versions.indexOf(version) !== -1) {
return version
} else if (browserslist.versionAliases[data.name][version]) {
return browserslist.versionAliases[data.name][version]
} else if (data.versions.length === 1) {
return data.versions[0]
} else {
return false
}
}
function loadCountryStatistics (country) {
country = country.replace(/[^\w-]/g, '')
if (!browserslist.usage[country]) {
var usage = { }
// eslint-disable-next-line security/detect-non-literal-require
var compressed = require('caniuse-lite/data/regions/' + country + '.js')
var data = region(compressed)
for (var i in data) {
fillUsage(usage, i, data[i])
}
browserslist.usage[country] = usage
}
}
// Will be filled by Can I Use data below
browserslist.data = { }
browserslist.usage = {
global: { },
custom: null
}
// Default browsers query
browserslist.defaults = [
'> 1%',
'last 2 versions',
'Firefox ESR'
]
// Browser names aliases
browserslist.aliases = {
fx: 'firefox',
ff: 'firefox',
ios: 'ios_saf',
explorer: 'ie',
blackberry: 'bb',
explorermobile: 'ie_mob',
operamini: 'op_mini',
operamobile: 'op_mob',
chromeandroid: 'and_chr',
firefoxandroid: 'and_ff',
ucandroid: 'and_uc',
qqandroid: 'and_qq'
}
// Aliases to work with joined versions like `ios_saf 7.0-7.1`
browserslist.versionAliases = { }
// Get browser data by alias or case insensitive name
function byName (name) {
name = name.toLowerCase()
name = browserslist.aliases[name] || name
return browserslist.data[name]
}
// Get browser data by alias or case insensitive name and throw error
// on unknown browser
function checkName (name) {
var data = byName(name)
if (!data) throw new BrowserslistError('Unknown browser ' + name)
return data
}
// Read and parse config
browserslist.readConfig = function (file) {
if (!isFile(file)) {
throw new BrowserslistError('Can\'t read ' + file + ' config')
}
return browserslist.parseConfig(fs.readFileSync(file))
}
// Find config, read file and parse it
browserslist.findConfig = function (from) {
if (!path.resolve) return undefined
from = path.resolve(from)
var cacheKey = isFile(from) ? path.dirname(from) : from
if (cacheKey in configCache) {
return configCache[cacheKey]
}
var resolved = eachParent(from, function (dir) {
var config = path.join(dir, 'browserslist')
var pkg = path.join(dir, 'package.json')
var rc = path.join(dir, '.browserslistrc')
var pkgBrowserslist
if (isFile(pkg)) {
try {
pkgBrowserslist = parsePackage(pkg)
} catch (e) {
if (e.name === 'BrowserslistError') throw e
console.warn('[Browserslist] Could not parse ' + pkg + '. Ignoring it.')
}
}
if (isFile(config) && pkgBrowserslist) {
throw new BrowserslistError(
dir + ' contains both browserslist and package.json with browsers')
} else if (isFile(rc) && pkgBrowserslist) {
throw new BrowserslistError(
dir + ' contains both .browserslistrc and package.json with browsers')
} else if (isFile(config) && isFile(rc)) {
throw new BrowserslistError(
dir + ' contains both .browserslistrc and browserslist')
} else if (isFile(config)) {
return browserslist.readConfig(config)
} else if (isFile(rc)) {
return browserslist.readConfig(rc)
} else {
return pkgBrowserslist
}
})
if (!env.BROWSERSLIST_DISABLE_CACHE) {
configCache[cacheKey] = resolved
}
return resolved
}
/**
* Return browsers market coverage.
*
* @param {string[]} browsers Browsers names in Can I Use.
* @param {string} [country="global"] Which country statistics should be used.
*
* @return {number} Total market coverage for all selected browsers.
*
* @example
* browserslist.coverage(browserslist('> 1% in US'), 'US') //=> 83.1
*/
browserslist.coverage = function (browsers, country) {
if (country && country !== 'global') {
if (country.length > 2) {
country = country.toLowerCase()
} else {
country = country.toUpperCase()
}
loadCountryStatistics(country)
} else {
country = 'global'
}
return browsers.reduce(function (all, i) {
var usage = browserslist.usage[country][i]
if (usage === undefined) {
usage = browserslist.usage[country][i.replace(/ [\d.]+$/, ' 0')]
}
return all + (usage || 0)
}, 0)
}
// Return array of queries from config content
browserslist.parseConfig = function (string) {
var result = { defaults: [] }
var section = 'defaults'
string.toString()
.replace(/#[^\n]*/g, '')
.split(/\n/)
.map(function (line) {
return line.trim()
})
.filter(function (line) {
return line !== ''
})
.forEach(function (line) {
if (IS_SECTION.test(line)) {
section = line.match(IS_SECTION)[1].trim()
result[section] = result[section] || []
} else {
result[section].push(line)
}
})
return result
}
// Clear internal caches
browserslist.clearCaches = function () {
filenessCache = {}
configCache = {}
}
var QUERIES = [
{
regexp: /^last\s+(\d+)\s+major versions?$/i,
select: function (context, versions) {
return Object.keys(agents).reduce(function (selected, name) {
var data = byName(name)
if (!data) return selected
var array = getMajorVersions(data.released, versions)
array = array.map(nameMapper(data.name))
return selected.concat(array)
}, [])
}
},
{
regexp: /^last\s+(\d+)\s+versions?$/i,
select: function (context, versions) {
return Object.keys(agents).reduce(function (selected, name) {
var data = byName(name)
if (!data) return selected
var array = data.released.slice(-versions)
array = array.map(nameMapper(data.name))
return selected.concat(array)
}, [])
}
},
{
regexp: /^last\s+(\d+)\s+electron\s+major versions?$/i,
select: function (context, versions) {
var validVersions = getMajorVersions(Object.keys(e2c).reverse(), versions)
return validVersions.map(function (i) {
return 'chrome ' + e2c[i]
})
}
},
{
regexp: /^last\s+(\d+)\s+(\w+)\s+major versions?$/i,
select: function (context, versions, name) {
var data = checkName(name)
var validVersions = getMajorVersions(data.released, versions)
return validVersions.map(nameMapper(data.name))
}
},
{
regexp: /^last\s+(\d+)\s+electron\s+versions?$/i,
select: function (context, versions) {
return Object.keys(e2c).reverse().slice(-versions).map(function (i) {
return 'chrome ' + e2c[i]
})
}
},
{
regexp: /^last\s+(\d+)\s+(\w+)\s+versions?$/i,
select: function (context, versions, name) {
var data = checkName(name)
return data.released.slice(-versions).map(nameMapper(data.name))
}
},
{
regexp: /^unreleased\s+versions$/i,
select: function () {
return Object.keys(agents).reduce(function (selected, name) {
var data = byName(name)
if (!data) return selected
var array = data.versions.filter(function (v) {
return data.released.indexOf(v) === -1
})
array = array.map(nameMapper(data.name))
return selected.concat(array)
}, [])
}
},
{
regexp: /^unreleased\s+electron\s+versions?$/i,
select: function () {
return []
}
},
{
regexp: /^unreleased\s+(\w+)\s+versions?$/i,
select: function (context, name) {
var data = checkName(name)
return data.versions.filter(function (v) {
return data.released.indexOf(v) === -1
}).map(nameMapper(data.name))
}
},
{
regexp: /^since (\d+)(?:-(\d+))?(?:-(\d+))?$/i,
select: function (context, year, month, date) {
year = parseInt(year)
month = parseInt(month || '01') - 1
date = parseInt(date || '01')
var since = Date.UTC(year, month, date, 0, 0, 0) / 1000
return Object.keys(agents).reduce(function (selected, name) {
var data = byName(name)
if (!data) return selected
var versions = Object.keys(data.releaseDate).filter(function (v) {
return data.releaseDate[v] >= since
})
return selected.concat(versions.map(nameMapper(data.name)))
}, [])
}
},
{
regexp: /^(>=?|<=?)\s*(\d*\.?\d+)%$/,
select: function (context, sign, popularity) {
popularity = parseFloat(popularity)
var usage = browserslist.usage.global
return Object.keys(usage).reduce(function (result, version) {
if (sign === '>') {
if (usage[version] > popularity) {
result.push(version)
}
} else if (sign === '<') {
if (usage[version] < popularity) {
result.push(version)
}
} else if (sign === '<=') {
if (usage[version] <= popularity) {
result.push(version)
}
} else if (usage[version] >= popularity) {
result.push(version)
}
return result
}, [])
}
},
{
regexp: /^(>=?|<=?)\s*(\d*\.?\d+)%\s+in\s+my\s+stats$/,
select: function (context, sign, popularity) {
popularity = parseFloat(popularity)
if (!context.customUsage) {
throw new BrowserslistError('Custom usage statistics was not provided')
}
var usage = context.customUsage
return Object.keys(usage).reduce(function (result, version) {
if (sign === '>') {
if (usage[version] > popularity) {
result.push(version)
}
} else if (sign === '<') {
if (usage[version] < popularity) {
result.push(version)
}
} else if (sign === '<=') {
if (usage[version] <= popularity) {
result.push(version)
}
} else if (usage[version] >= popularity) {
result.push(version)
}
return result
}, [])
}
},
{
regexp: /^(>=?|<=?)\s*(\d*\.?\d+)%\s+in\s+((alt-)?\w\w)$/,
select: function (context, sign, popularity, place) {
popularity = parseFloat(popularity)
if (place.length === 2) {
place = place.toUpperCase()
} else {
place = place.toLowerCase()
}
loadCountryStatistics(place)
var usage = browserslist.usage[place]
return Object.keys(usage).reduce(function (result, version) {
if (sign === '>') {
if (usage[version] > popularity) {
result.push(version)
}
} else if (sign === '<') {
if (usage[version] < popularity) {
result.push(version)
}
} else if (sign === '<=') {
if (usage[version] <= popularity) {
result.push(version)
}
} else if (usage[version] >= popularity) {
result.push(version)
}
return result
}, [])
}
},
{
regexp: /^electron\s+([\d.]+)\s*-\s*([\d.]+)$/i,
select: function (context, from, to) {
if (!e2c[from]) {
throw new BrowserslistError('Unknown version ' + from + ' of electron')
}
if (!e2c[to]) {
throw new BrowserslistError('Unknown version ' + to + ' of electron')
}
from = parseFloat(from)
to = parseFloat(to)
return Object.keys(e2c).filter(function (i) {
var parsed = parseFloat(i)
return parsed >= from && parsed <= to
}).map(function (i) {
return 'chrome ' + e2c[i]
})
}
},
{
regexp: /^(\w+)\s+([\d.]+)\s*-\s*([\d.]+)$/i,
select: function (context, name, from, to) {
var data = checkName(name)
from = parseFloat(normalizeVersion(data, from) || from)
to = parseFloat(normalizeVersion(data, to) || to)
function filter (v) {
var parsed = parseFloat(v)
return parsed >= from && parsed <= to
}
return data.released.filter(filter).map(nameMapper(data.name))
}
},
{
regexp: /^electron\s*(>=?|<=?)\s*([\d.]+)$/i,
select: function (context, sign, version) {
return Object.keys(e2c)
.filter(generateFilter(sign, version))
.map(function (i) {
return 'chrome ' + e2c[i]
})
}
},
{
regexp: /^(\w+)\s*(>=?|<=?)\s*([\d.]+)$/,
select: function (context, name, sign, version) {
var data = checkName(name)
var alias = browserslist.versionAliases[data.name][version]
if (alias) {
version = alias
}
return data.released
.filter(generateFilter(sign, version))
.map(function (v) {
return data.name + ' ' + v
})
}
},
{
regexp: /^(firefox|ff|fx)\s+esr$/i,
select: function () {
return ['firefox 52']
}
},
{
regexp: /(operamini|op_mini)\s+all/i,
select: function () {
return ['op_mini all']
}
},
{
regexp: /^electron\s+([\d.]+)$/i,
select: function (context, version) {
var chrome = e2c[version]
if (!chrome) {
throw new BrowserslistError(
'Unknown version ' + version + ' of electron')
}
return ['chrome ' + chrome]
}
},
{
regexp: /^(\w+)\s+(tp|[\d.]+)$/i,
select: function (context, name, version) {
if (/^tp$/i.test(version)) version = 'TP'
var data = checkName(name)
var alias = normalizeVersion(data, version)
if (alias) {
version = alias
} else {
if (version.indexOf('.') === -1) {
alias = version + '.0'
} else if (/\.0$/.test(version)) {
alias = version.replace(/\.0$/, '')
}
alias = normalizeVersion(data, alias)
if (alias) {
version = alias
} else {
throw new BrowserslistError(
'Unknown version ' + version + ' of ' + name)
}
}
return [data.name + ' ' + version]
}
},
{
regexp: /^extends (.+)$/i,
select: function (context, name) {
if (!context.dangerousExtend) checkExtend(name)
// eslint-disable-next-line security/detect-non-literal-require
var queries = require(name)
if (!Array.isArray(queries)) {
throw new BrowserslistError(
'`' + name + '` config exports not an array of queries')
}
return resolve(queries, context)
}
},
{
regexp: /^defaults$/i,
select: function () {
return browserslist(browserslist.defaults)
}
}
]
var CONFIG_PATTERN = /^browserslist-config-/
var SCOPED_CONFIG__PATTERN = /@[^./]+\/browserslist-config(-|$)/
function checkExtend (name) {
var use = ' Use `dangerousExtend` option to disable.'
if (!CONFIG_PATTERN.test(name) && !SCOPED_CONFIG__PATTERN.test(name)) {
throw new BrowserslistError(
'Browserslist config needs `browserslist-config-` prefix. ' + use)
}
if (name.indexOf('.') !== -1) {
throw new BrowserslistError(
'`.` not allowed in Browserslist config name. ' + use)
}
if (name.indexOf('node_modules') !== -1) {
throw new BrowserslistError(
'`node_modules` not allowed in Browserslist config.' + use)
}
}
// Get and convert Can I Use data
(function () {
for (var name in agents) {
var browser = agents[name]
browserslist.data[name] = {
name: name,
versions: normalize(agents[name].versions),
released: normalize(agents[name].versions.slice(0, -3)),
releaseDate: agents[name].release_date
}
fillUsage(browserslist.usage.global, name, browser.usage_global)
browserslist.versionAliases[name] = { }
for (var i = 0; i < browser.versions.length; i++) {
var full = browser.versions[i]
if (!full) continue
if (full.indexOf('-') !== -1) {
var interval = full.split('-')
for (var j = 0; j < interval.length; j++) {
browserslist.versionAliases[name][interval[j]] = full
}
}
}
}
}())
module.exports = browserslist