aboutsummaryrefslogtreecommitdiff
path: root/node_modules/@babel/helper-plugin-utils
diff options
context:
space:
mode:
authorruki <waruqi@gmail.com>2018-11-08 00:38:48 +0800
committerruki <waruqi@gmail.com>2018-11-07 21:53:09 +0800
commit26105034da4fcce7ac883c899d781f016559310d (patch)
treec459a5dc4e3aa0972d9919033ece511ce76dd129 /node_modules/@babel/helper-plugin-utils
parent2c77f00f1a7ecb6c8192f9c16d3b2001b254a107 (diff)
downloadxmake-docs-26105034da4fcce7ac883c899d781f016559310d.tar.gz
xmake-docs-26105034da4fcce7ac883c899d781f016559310d.zip
switch to vuepress
Diffstat (limited to 'node_modules/@babel/helper-plugin-utils')
-rw-r--r--node_modules/@babel/helper-plugin-utils/lib/index.js77
-rw-r--r--node_modules/@babel/helper-plugin-utils/package.json10
-rw-r--r--node_modules/@babel/helper-plugin-utils/src/README.md41
-rw-r--r--node_modules/@babel/helper-plugin-utils/src/index.js95
4 files changed, 223 insertions, 0 deletions
diff --git a/node_modules/@babel/helper-plugin-utils/lib/index.js b/node_modules/@babel/helper-plugin-utils/lib/index.js
new file mode 100644
index 00000000..adb0656f
--- /dev/null
+++ b/node_modules/@babel/helper-plugin-utils/lib/index.js
@@ -0,0 +1,77 @@
+"use strict";
+
+Object.defineProperty(exports, "__esModule", {
+ value: true
+});
+exports.declare = declare;
+
+function declare(builder) {
+ return (api, options, dirname) => {
+ if (!api.assertVersion) {
+ api = Object.assign(copyApiObject(api), {
+ assertVersion(range) {
+ throwVersionError(range, api.version);
+ }
+
+ });
+ }
+
+ return builder(api, options || {}, dirname);
+ };
+}
+
+function copyApiObject(api) {
+ 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 Object.assign({}, 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) {
+ 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
+ });
+} \ No newline at end of file
diff --git a/node_modules/@babel/helper-plugin-utils/package.json b/node_modules/@babel/helper-plugin-utils/package.json
new file mode 100644
index 00000000..c1042d45
--- /dev/null
+++ b/node_modules/@babel/helper-plugin-utils/package.json
@@ -0,0 +1,10 @@
+{
+ "name": "@babel/helper-plugin-utils",
+ "version": "7.0.0-beta.47",
+ "description": "General utilities for plugins to use",
+ "author": "Logan Smyth <loganfsmyth@gmail.com>",
+ "homepage": "https://babeljs.io/",
+ "license": "MIT",
+ "repository": "https://github.com/babel/babel/tree/master/packages/babel-helper-plugin-utils",
+ "main": "lib/index.js"
+}
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),
+ );
+}