aboutsummaryrefslogtreecommitdiff
path: root/node_modules/@babel/helper-plugin-utils/src
diff options
context:
space:
mode:
Diffstat (limited to 'node_modules/@babel/helper-plugin-utils/src')
-rw-r--r--node_modules/@babel/helper-plugin-utils/src/README.md41
-rw-r--r--node_modules/@babel/helper-plugin-utils/src/index.js95
2 files changed, 136 insertions, 0 deletions
diff --git a/node_modules/@babel/helper-plugin-utils/src/README.md b/node_modules/@babel/helper-plugin-utils/src/README.md
new file mode 100644
index 00000000..4079c2d4
--- /dev/null
+++ b/node_modules/@babel/helper-plugin-utils/src/README.md
@@ -0,0 +1,41 @@
+# @babel/helper-plugin-utils
+
+The intention of this module is to provide a place for us to expose a
+standardized API layer over top of what Babel's core API provides on its own.
+
+This is not aiming to implement APIs that are missing on a given Babel version,
+but it is means to provide clear error messages if a plugin is run on a version
+of Babel that doesn't have the APIs that the plugin is trying to use.
+
+Every one of Babel's core plugins and presets will use this module, and ideally
+because of that its size should be kept to a miminum because this may or may
+not be deduplicated when installed.
+
+
+## Usage
+
+```js
+import { declare } from "@babel/helper-plugin-utils";
+
+export default declare((api, options, dirname) => {
+ return {};
+});
+```
+
+
+## What this does
+
+Currently, this plugin provides a few services to ensure that plugins function
+well-enough to throw useful errors.
+
+### `options` is always passed
+
+Babel 6 does not pass a second parameter. This frequently means that plugins
+written for Babel 7 that use `options` will attempt to destructure options
+out of an `undefined` value. By supplying the default, we avoid that risk.
+
+### `api.assertVersion` always exists
+
+Babel 6 and early betas of Babel 7 do not have `assertVersion`, so this
+wrapper ensures that it exists and throws a useful error message when not
+supplied by Babel itself.
diff --git a/node_modules/@babel/helper-plugin-utils/src/index.js b/node_modules/@babel/helper-plugin-utils/src/index.js
new file mode 100644
index 00000000..f0ecb83a
--- /dev/null
+++ b/node_modules/@babel/helper-plugin-utils/src/index.js
@@ -0,0 +1,95 @@
+export function declare(builder) {
+ return (api, options, dirname) => {
+ if (!api.assertVersion) {
+ // Inject a custom version of 'assertVersion' for Babel 6 and early
+ // versions of Babel 7's beta that didn't have it.
+ api = Object.assign(copyApiObject(api), {
+ assertVersion(range) {
+ throwVersionError(range, api.version);
+ },
+ });
+ }
+
+ return builder(api, options || {}, dirname);
+ };
+}
+
+function copyApiObject(api) {
+ // Babel >= 7 <= beta.41 passed the API as a new object that had
+ // babel/core as the prototype. While slightly faster, it also
+ // means that the Object.assign copy below fails. Rather than
+ // keep complexity, the Babel 6 behavior has been reverted and this
+ // normalizes all that for Babel 7.
+ let proto = null;
+ if (typeof api.version === "string" && /^7\./.test(api.version)) {
+ proto = Object.getPrototypeOf(api);
+ if (
+ proto &&
+ (!has(proto, "version") ||
+ !has(proto, "transform") ||
+ !has(proto, "template") ||
+ !has(proto, "types"))
+ ) {
+ proto = null;
+ }
+ }
+
+ return {
+ ...proto,
+ ...api,
+ };
+}
+
+function has(obj, key) {
+ return Object.prototype.hasOwnProperty.call(obj, key);
+}
+
+function throwVersionError(range, version) {
+ if (typeof range === "number") {
+ if (!Number.isInteger(range)) {
+ throw new Error("Expected string or integer value.");
+ }
+ range = `^${range}.0.0-0`;
+ }
+ if (typeof range !== "string") {
+ throw new Error("Expected string or integer value.");
+ }
+
+ const limit = Error.stackTraceLimit;
+
+ if (typeof limit === "number" && limit < 25) {
+ // Bump up the limit if needed so that users are more likely
+ // to be able to see what is calling Babel.
+ Error.stackTraceLimit = 25;
+ }
+
+ let err;
+ if (version.slice(0, 2) === "7.") {
+ err = new Error(
+ `Requires Babel "^7.0.0-beta.41", but was loaded with "${version}". ` +
+ `You'll need to update your @babel/core version.`,
+ );
+ } else {
+ err = new Error(
+ `Requires Babel "${range}", but was loaded with "${version}". ` +
+ `If you are sure you have a compatible version of @babel/core, ` +
+ `it is likely that something in your build process is loading the ` +
+ `wrong version. Inspect the stack trace of this error to look for ` +
+ `the first entry that doesn't mention "@babel/core" or "babel-core" ` +
+ `to see what is calling Babel.`,
+ );
+ }
+
+ if (typeof limit === "number") {
+ Error.stackTraceLimit = limit;
+ }
+
+ throw Object.assign(
+ err,
+ ({
+ code: "BABEL_VERSION_UNSUPPORTED",
+ version,
+ range,
+ }: any),
+ );
+}