// @flow import corejs3Polyfills from "core-js-compat/data.json"; import { coerce, SemVer } from "semver"; import corejs2Polyfills from "@babel/compat-data/corejs2-built-ins"; import { plugins as pluginsList } from "./plugins-compat-data"; import moduleTransformations from "./module-transformations"; import { TopLevelOptions, ModulesOption, UseBuiltInsOption } from "./options"; import { OptionValidator } from "@babel/helper-validator-option"; const corejs2DefaultWebIncludes = [ "web.timers", "web.immediate", "web.dom.iterable", ]; import type { BuiltInsOption, CorejsOption, ModuleOption, Options, PluginListItem, PluginListOption, } from "./types"; const v = new OptionValidator(PACKAGE_JSON.name); const allPluginsList = Object.keys(pluginsList); // NOTE: Since module plugins are handled separately compared to other plugins (via the "modules" option) it // should only be possible to exclude and not include module plugins, otherwise it's possible that preset-env // will add a module plugin twice. const modulePlugins = [ "proposal-dynamic-import", ...Object.keys(moduleTransformations).map(m => moduleTransformations[m]), ]; const getValidIncludesAndExcludes = ( type: "include" | "exclude", corejs: number | false, ) => new Set([ ...allPluginsList, ...(type === "exclude" ? modulePlugins : []), ...(corejs ? corejs == 2 ? [...Object.keys(corejs2Polyfills), ...corejs2DefaultWebIncludes] : Object.keys(corejs3Polyfills) : []), ]); const pluginToRegExp = (plugin: PluginListItem) => { if (plugin instanceof RegExp) return plugin; try { return new RegExp(`^${normalizePluginName(plugin)}$`); } catch (e) { return null; } }; const selectPlugins = ( regexp: RegExp | null, type: "include" | "exclude", corejs: number | false, ) => Array.from(getValidIncludesAndExcludes(type, corejs)).filter( item => regexp instanceof RegExp && regexp.test(item), ); const flatten = (array: Array>): Array => [].concat(...array); const expandIncludesAndExcludes = ( plugins: PluginListOption = [], type: "include" | "exclude", corejs: number | false, ) => { if (plugins.length === 0) return []; const selectedPlugins = plugins.map(plugin => selectPlugins(pluginToRegExp(plugin), type, corejs), ); const invalidRegExpList = plugins.filter( (p, i) => selectedPlugins[i].length === 0, ); v.invariant( invalidRegExpList.length === 0, `The plugins/built-ins '${invalidRegExpList.join( ", ", )}' passed to the '${type}' option are not valid. Please check data/[plugin-features|built-in-features].js in babel-preset-env`, ); return flatten(selectedPlugins); }; export const normalizePluginName = (plugin: string) => plugin.replace(/^(@babel\/|babel-)(plugin-)?/, ""); export const checkDuplicateIncludeExcludes = ( include: Array = [], exclude: Array = [], ) => { const duplicates = include.filter(opt => exclude.indexOf(opt) >= 0); v.invariant( duplicates.length === 0, `The plugins/built-ins '${duplicates.join( ", ", )}' were found in both the "include" and "exclude" options.`, ); }; const normalizeTargets = targets => { // TODO: Allow to use only query or strings as a targets from next breaking change. if (typeof targets === "string" || Array.isArray(targets)) { return { browsers: targets }; } return { ...targets }; }; export const validateModulesOption = ( modulesOpt: ModuleOption = ModulesOption.auto, ) => { v.invariant( ModulesOption[modulesOpt.toString()] || modulesOpt === ModulesOption.false, `The 'modules' option must be one of \n` + ` - 'false' to indicate no module processing\n` + ` - a specific module type: 'commonjs', 'amd', 'umd', 'systemjs'` + ` - 'auto' (default) which will automatically select 'false' if the current\n` + ` process is known to support ES module syntax, or "commonjs" otherwise\n`, ); return modulesOpt; }; export const validateUseBuiltInsOption = ( builtInsOpt: BuiltInsOption = false, ) => { v.invariant( UseBuiltInsOption[builtInsOpt.toString()] || builtInsOpt === UseBuiltInsOption.false, `The 'useBuiltIns' option must be either 'false' (default) to indicate no polyfill, '"entry"' to indicate replacing the entry polyfill, or '"usage"' to import only used polyfills per file`, ); return builtInsOpt; }; export type NormalizedCorejsOption = { proposals: boolean, version: typeof SemVer | null | false, }; export function normalizeCoreJSOption( corejs?: CorejsOption, useBuiltIns: BuiltInsOption, ): NormalizedCorejsOption { let proposals = false; let rawVersion; if (useBuiltIns && corejs === undefined) { rawVersion = 2; console.warn( "\nWARNING (@babel/preset-env): We noticed you're using the `useBuiltIns` option without declaring a " + "core-js version. Currently, we assume version 2.x when no version " + "is passed. Since this default version will likely change in future " + "versions of Babel, we recommend explicitly setting the core-js version " + "you are using via the `corejs` option.\n" + "\nYou should also be sure that the version you pass to the `corejs` " + "option matches the version specified in your `package.json`'s " + "`dependencies` section. If it doesn't, you need to run one of the " + "following commands:\n\n" + " npm install --save core-js@2 npm install --save core-js@3\n" + " yarn add core-js@2 yarn add core-js@3\n\n" + "More info about useBuiltIns: https://babeljs.io/docs/en/babel-preset-env#usebuiltins\n" + "More info about core-js: https://babeljs.io/docs/en/babel-preset-env#corejs", ); } else if (typeof corejs === "object" && corejs !== null) { rawVersion = corejs.version; proposals = Boolean(corejs.proposals); } else { rawVersion = corejs; } const version = rawVersion ? coerce(String(rawVersion)) : false; if (!useBuiltIns && version) { console.warn( "\nWARNING (@babel/preset-env): The `corejs` option only has an effect when the `useBuiltIns` option is not `false`\n", ); } if (useBuiltIns && (!version || version.major < 2 || version.major > 3)) { throw new RangeError( "Invalid Option: The version passed to `corejs` is invalid. Currently, " + "only core-js@2 and core-js@3 are supported.", ); } return { version, proposals }; } export default function normalizeOptions(opts: Options) { v.validateTopLevelOptions(opts, TopLevelOptions); const useBuiltIns = validateUseBuiltInsOption(opts.useBuiltIns); const corejs = normalizeCoreJSOption(opts.corejs, useBuiltIns); const include = expandIncludesAndExcludes( opts.include, TopLevelOptions.include, !!corejs.version && corejs.version.major, ); const exclude = expandIncludesAndExcludes( opts.exclude, TopLevelOptions.exclude, !!corejs.version && corejs.version.major, ); checkDuplicateIncludeExcludes(include, exclude); return { bugfixes: v.validateBooleanOption( TopLevelOptions.bugfixes, opts.bugfixes, false, ), configPath: v.validateStringOption( TopLevelOptions.configPath, opts.configPath, process.cwd(), ), corejs, debug: v.validateBooleanOption(TopLevelOptions.debug, opts.debug, false), include, exclude, forceAllTransforms: v.validateBooleanOption( TopLevelOptions.forceAllTransforms, opts.forceAllTransforms, false, ), ignoreBrowserslistConfig: v.validateBooleanOption( TopLevelOptions.ignoreBrowserslistConfig, opts.ignoreBrowserslistConfig, false, ), loose: v.validateBooleanOption(TopLevelOptions.loose, opts.loose), modules: validateModulesOption(opts.modules), shippedProposals: v.validateBooleanOption( TopLevelOptions.shippedProposals, opts.shippedProposals, false, ), spec: v.validateBooleanOption(TopLevelOptions.spec, opts.spec, false), targets: normalizeTargets(opts.targets), useBuiltIns: useBuiltIns, browserslistEnv: v.validateStringOption( TopLevelOptions.browserslistEnv, opts.browserslistEnv, ), }; }