diff --git a/docs/assumptions.md b/docs/assumptions.mdx similarity index 100% rename from docs/assumptions.md rename to docs/assumptions.mdx diff --git a/docs/babelconfigjs.md b/docs/babelconfigjs.mdx similarity index 68% rename from docs/babelconfigjs.md rename to docs/babelconfigjs.mdx index 09082d3e0b..00947e3478 100644 --- a/docs/babelconfigjs.md +++ b/docs/babelconfigjs.mdx @@ -3,4 +3,4 @@ title: babel.config.js id: babelconfigjs --- -This documentation has been moved to [project-wide configuration docs](config-files.md#project-wide-configuration). +This documentation has been moved to [project-wide configuration docs](config-files.mdx#project-wide-configuration). diff --git a/docs/babelrc.md b/docs/babelrc.mdx similarity index 64% rename from docs/babelrc.md rename to docs/babelrc.mdx index 5e7529bf69..812c6bc4ad 100644 --- a/docs/babelrc.md +++ b/docs/babelrc.mdx @@ -3,4 +3,4 @@ title: .babelrc id: babelrc --- -This documentation has been moved to [file-relative configuration docs](config-files.md#file-relative-configuration). +This documentation has been moved to [file-relative configuration docs](config-files.mdx#file-relative-configuration). diff --git a/docs/build-external-helpers.md b/docs/build-external-helpers.mdx similarity index 100% rename from docs/build-external-helpers.md rename to docs/build-external-helpers.mdx diff --git a/docs/caveats.md b/docs/caveats.mdx similarity index 93% rename from docs/caveats.md rename to docs/caveats.mdx index f27ee67a8c..849274b512 100644 --- a/docs/caveats.md +++ b/docs/caveats.mdx @@ -10,7 +10,7 @@ Babel feature requirements by using a complete polyfill such as [`core-js/actual You may alternatively/selectively include what you need: - +{/* TODO: This is out of date */} | Feature | Requirements | | --------------------------- | -------------------------------------- | @@ -26,14 +26,14 @@ Babel assumes that built-ins (e.g. `Array`, `WeakMap` and others), if polyfilled ## Classes Built-in classes such as `Date`, `Array`, `DOM` etc cannot be properly subclassed -due to limitations in ES5 (for the [transform-classes](plugin-transform-classes.md) plugin). +due to limitations in ES5 (for the [transform-classes](plugin-transform-classes.mdx) plugin). You can try to use [babel-plugin-transform-builtin-extend](https://github.com/loganfsmyth/babel-plugin-transform-builtin-extend) based on `Object.setPrototypeOf` and `Reflect.construct`, but it also has some limitations. ## ES5 Since Babel assumes that your code will run in an ES5 environment it uses ES5 functions. So if you're using an environment that has limited or no support for -ES5 such as lower versions of IE then using [@babel/polyfill](polyfill.md) will add support for these methods. +ES5 such as lower versions of IE then using [@babel/polyfill](polyfill.mdx) will add support for these methods. ## Internet Explorer @@ -45,11 +45,11 @@ this is widely supported but you may run into problems with much older browsers. **NOTE:** `__proto__` is not supported on IE ≤ 10 so static properties **will not** be inherited. See the -[protoToAssign](plugin-transform-proto-to-assign.md) for a possible work +[protoToAssign](plugin-transform-proto-to-assign.mdx) for a possible work around. For classes that have `super`s, the super class won't resolve correctly. You can -get around this by enabling the `loose` option in the [transform-classes](plugin-transform-classes.md) plugin. +get around this by enabling the `loose` option in the [transform-classes](plugin-transform-classes.mdx) plugin. ### Getters/setters (8 and below) diff --git a/docs/cli.md b/docs/cli.mdx similarity index 95% rename from docs/cli.md rename to docs/cli.mdx index 135f5324f8..741663c04e 100644 --- a/docs/cli.md +++ b/docs/cli.mdx @@ -80,7 +80,7 @@ npx babel script.js --watch --out-file script-compiled.js ### Compile with Source Maps :::note -Since v7.19.3, if this parameter is not specified, `@babel/cli` will follow the [configuration files](./config-files.md). +Since v7.19.3, if this parameter is not specified, `@babel/cli` will follow the [configuration files](./config-files.mdx). ::: If you would then like to add a **source map file** you can use @@ -112,7 +112,7 @@ npx babel src --out-file script-compiled.js #### Directories with TypeScript Files -Use the `--extensions` option to specify what file extensions Babel should handle when compiling the entire `src` directory. The default `--extensions` can be accessed from [`Babel.DEFAULT_EXTENSIONS`](./core.md#default_extensions). +Use the `--extensions` option to specify what file extensions Babel should handle when compiling the entire `src` directory. The default `--extensions` can be accessed from [`Babel.DEFAULT_EXTENSIONS`](./core.mdx#default_extensions). ```sh title="Shell" npx babel src --out-dir lib \ @@ -192,7 +192,7 @@ npx babel --no-babelrc script.js --out-file script-compiled.js --presets=@babel/ npx babel --config-file /path/to/my/babel.config.json --out-dir dist ./src ``` -See [here](./config-files.md) for more information about config files. +See [here](./config-files.mdx) for more information about config files. ### Set File Extensions @@ -235,4 +235,4 @@ npx babel script.js --out-file script-compiled.js --silent ### Advanced Usage -There are many more options available, see [options](options.md), `babel --help` and other sections for more information. +There are many more options available, see [options](options.mdx), `babel --help` and other sections for more information. diff --git a/docs/code-frame.md b/docs/code-frame.mdx similarity index 100% rename from docs/code-frame.md rename to docs/code-frame.mdx diff --git a/docs/compat-data.md b/docs/compat-data.mdx similarity index 84% rename from docs/compat-data.md rename to docs/compat-data.mdx index a586404add..e981fb46b9 100644 --- a/docs/compat-data.md +++ b/docs/compat-data.mdx @@ -3,7 +3,7 @@ id: babel-compat-data title: "@babel/compat-data" --- -This package provides compatibility data for various JavaScript features across different browser and runtime environments. It is used by [`@babel/preset-env`](./preset-env.md) internally to determine the required Babel plugins for a given set of [compilation targets](./options.md#targets). The compat data is extracted from the [compat-table project](https://github.com/compat-table/compat-table). +This package provides compatibility data for various JavaScript features across different browser and runtime environments. It is used by [`@babel/preset-env`](./preset-env.mdx) internally to determine the required Babel plugins for a given set of [compilation targets](./options.mdx#targets). The compat data is extracted from the [compat-table project](https://github.com/compat-table/compat-table). ## Install @@ -51,7 +51,7 @@ For example, `pluginsCompatData["transform-object-rest-spread"]` will return an ``` Here, the minimum Chrome version with object-rest-spread support is `60`. Therefore, `@babel/preset-env` will enable the object-rest-spread transform only if users are compiling to Chrome versions older than `60`, and likewise for other browsers. Check the [source](https://github.com/babel/babel/blob/main/packages/babel-compat-data/data/plugins.json) for supported Babel plugin short names. -If you would like to know whether object-rest-spread is supported for any given `targets`, you don't have to manually compare it against the compat-data entry. Instead, you can use the [`isRequired`](./helper-compilation-targets.md#isrequired) utility from `@babel/helper-compilation-targets`: +If you would like to know whether object-rest-spread is supported for any given `targets`, you don't have to manually compare it against the compat-data entry. Instead, you can use the [`isRequired`](./helper-compilation-targets.mdx#isrequired) utility from `@babel/helper-compilation-targets`: ```javascript title="my-babel-plugin.js" import { isRequired } from "@babel/helper-compilation-targets"; diff --git a/docs/config-files.md b/docs/config-files.mdx similarity index 90% rename from docs/config-files.md rename to docs/config-files.mdx index 838b55cec9..e84954ef24 100644 --- a/docs/config-files.md +++ b/docs/config-files.mdx @@ -26,11 +26,11 @@ Babel has two parallel config file formats, which can be used together, or indep ## Project-wide configuration -New in Babel 7.x, Babel has a concept of a ["root"](options.md#root) directory, which defaults +New in Babel 7.x, Babel has a concept of a ["root"](options.mdx#root) directory, which defaults to the current working directory. For project-wide configuration, Babel will automatically search for a `babel.config.json` file, or an equivalent one using the [supported extensions](#supported-file-extensions), in this root directory. Alternatively, users can use an explicit -["configFile"](options.md#configfile) value to override the default config file search behavior. +["configFile"](options.mdx#configfile) value to override the default config file search behavior. Because project-wide config files are separated from the physical location of the config file, they can be ideal for configuration that must apply broadly, even allowing @@ -41,32 +41,32 @@ The primary downside of this project-wide config is that, because it relies on t directory, it can be more painful to use in monorepos if the working directory is not the monorepo root. See the [monorepo](#monorepos) documentation for examples of how to use config files in that context. -Project-wide configs can also be disabled by setting ["configFile"](options.md#configfile) to `false`. +Project-wide configs can also be disabled by setting ["configFile"](options.mdx#configfile) to `false`. ## File-relative configuration Babel loads `.babelrc.json` files, or an equivalent one using the [supported extensions](#supported-file-extensions), by searching up the -directory structure starting from the ["filename"](options.md#filename) being compiled (limited by the caveats below). +directory structure starting from the ["filename"](options.mdx#filename) being compiled (limited by the caveats below). This can be powerful because it allows you to create independent configurations for subsections of -a package. File-relative configurations are also [merged](options.md#merging) over top of +a package. File-relative configurations are also [merged](options.mdx#merging) over top of project-wide config values, making them potentially useful for specific overrides, though that can -also be accomplished through ["overrides"](options.md#overrides). +also be accomplished through ["overrides"](options.mdx#overrides). There are a few edge cases to consider when using a file-relative config: - Searching will stop once a directory containing a `package.json` is found, so a relative config only applies within a single package. -- The ["filename"](options.md#filename) being compiled must be inside of - ["babelrcRoots"](options.md#babelrcroots) packages, or else searching will be skipped entirely. +- The ["filename"](options.mdx#filename) being compiled must be inside of + ["babelrcRoots"](options.mdx#babelrcroots) packages, or else searching will be skipped entirely. These caveats mean that: - `.babelrc.json` files _only_ apply to files within their own package - `.babelrc.json` files in packages that aren't Babel's 'root' are ignored unless you opt in - with ["babelrcRoots"](options.md#babelrcroots). + with ["babelrcRoots"](options.mdx#babelrcroots). See the [monorepo](#monorepos) documentation for more discussion on how to configure monorepos that have many packages. -File-relative configs can also be disabled by setting ["babelrc"](options.md#babelrc) to `false`. +File-relative configs can also be disabled by setting ["babelrc"](options.mdx#babelrc) to `false`. ### 6.x vs 7.x `.babelrc` loading @@ -95,18 +95,18 @@ packages/ the config will now be entirely ignored, because it is across a package boundary. -One alternative would be to create a `.babelrc` in each sub-package that uses ["extends"](options.md#extends) as +One alternative would be to create a `.babelrc` in each sub-package that uses ["extends"](options.mdx#extends) as ```json title=".babelrc.json" { "extends": "../../.babelrc" } ``` Unfortunately, this approach can be a bit repetitive, and depending on how Babel is being used, -could require setting ["babelrcRoots"](options.md#babelrcroots). +could require setting ["babelrcRoots"](options.mdx#babelrcroots). Given that, it may be more desirable to rename the `.babelrc` to be a [project-wide "babel.config.json"](#project-wide-configuration). As mentioned in the project-wide -section above, this may then require explicitly setting ["configFile"](options.md#configfile) +section above, this may then require explicitly setting ["configFile"](options.mdx#configfile) since Babel will not find the config file if the working directory isn't correct. ## Supported file extensions @@ -114,7 +114,7 @@ since Babel will not find the config file if the working directory isn't correct Babel can be configured using any file extension natively supported by Node.js, as mentioned in [Configuration File Types](#configuration-file-types) section: - `babel.config.json` and `.babelrc.json` are parsed as JSON5 and should contain an object matching - the [options](options.md) format that Babel accepts. They have been supported since `v7.7.0`. + the [options](options.mdx) format that Babel accepts. They have been supported since `v7.7.0`. We recommend using this file type wherever possible: JS config files are handy if you have complex configuration that is conditional or otherwise computed at build time. @@ -159,7 +159,7 @@ and config file loading in general. This section is aimed at helping users under to approach monorepo configuration. With monorepo setups, the core thing to understand is that Babel treats your working directory -as its logical ["root"](options.md#root), which causes problems if you want to run Babel +as its logical ["root"](options.mdx#root), which causes problems if you want to run Babel tools within a specific sub-package without having Babel apply to the repo as a whole. Separately, it is also important to decide if you want to use [`.babelrc.json`](#file-relative-configuration) @@ -175,12 +175,12 @@ Even if you want to use [`.babelrc.json`](#file-relative-configuration) files to it is important to have as a place for repo-level options. You can often place all of your repo configuration in the root [`babel.config.json`](#project-wide-configuration). -With ["overrides"](options.md#overrides), you can easily +With ["overrides"](options.mdx#overrides), you can easily specify configuration that only applies to certain subfolders of your repository, which can often be easier to follow than creating many `.babelrc.json` files across the repo. The first issue you'll likely run into is that by default, Babel expects to load [`babel.config.json`](#project-wide-configuration) -files from the directory set as its ["root"](options.md#root), which means that if you create +files from the directory set as its ["root"](options.mdx#root), which means that if you create a [`babel.config.json`](#project-wide-configuration), but run Babel inside an individual package, e.g. @@ -189,15 +189,15 @@ cd packages/some-package; babel src -d dist ``` -the ["root"](options.md#root) Babel is using in that context is _not_ your monorepo root, +the ["root"](options.mdx#root) Babel is using in that context is _not_ your monorepo root, and it won't be able to find the [`babel.config.json`](#project-wide-configuration) file. If all of your build scripts run relative to your repository root, things should already work, but if you are running your Babel compilation process from within a subpackage, you need to tell Babel where to look for the config. There are a few ways to do that, but the recommended way is -the ["rootMode"](options.md#rootmode) option with `"upward"`, which will make Babel search from +the ["rootMode"](options.mdx#rootmode) option with `"upward"`, which will make Babel search from the working directory upward looking for your [`babel.config.json`](#project-wide-configuration) file, -and will use its location as the ["root"](options.md#root) value. +and will use its location as the ["root"](options.mdx#root) value. One helpful way to test if your config is being detected is to place a `console.log()` call inside of it if it is a [`babel.config.json`](#project-wide-configuration) JavaScript file: the log will execute @@ -270,7 +270,7 @@ if the working directory is not already the monorepo root. ### Subpackage `.babelrc.json` files -Similar to the way [`babel.config.json`](#project-wide-configuration) files are required to be in the ["root"](options.md#root), +Similar to the way [`babel.config.json`](#project-wide-configuration) files are required to be in the ["root"](options.mdx#root), [`.babelrc.json`](#file-relative-configuration) files must be in the root _package_, by default. This means that, the same way the working directory affects [`babel.config.json`](#project-wide-configuration) loading, it also affects [`.babelrc.json`](#file-relative-configuration) loading. @@ -291,7 +291,7 @@ packages/ compiling the `packages/mod/index.js` file will not load `packages/mod/.babelrc.json` because this [`.babelrc.json`](#file-relative-configuration) is within a sub-package, not the root package. -To enable processing of that [`.babelrc.json`](#file-relative-configuration), you will want to use the ["babelrcRoots"](options.md#babelrcroots) +To enable processing of that [`.babelrc.json`](#file-relative-configuration), you will want to use the ["babelrcRoots"](options.mdx#babelrcroots) option from inside your [`babel.config.json`](#project-wide-configuration) file to do ```js title="JavaScript" @@ -375,7 +375,7 @@ that: Since `NODE_ENV` is a fairly common way to toggle behavior, Babel also includes an API function meant specifically for that. This API is used as a quick way to check the -["envName"](options.md#envname) that Babel was loaded with, which takes `NODE_ENV` into account +["envName"](options.mdx#envname) that Babel was loaded with, which takes `NODE_ENV` into account if no other overriding environment is set. It has a few different forms: @@ -429,12 +429,12 @@ module.exports = function(api) { }; ``` -### `api.addExternalDependency(name: string)` {#api_addExternalDependency} +### `api.addExternalDependency(name: string)` {/* #api_addExternalDependency */} Added in: `v7.17.0` This API allows the plugin or preset to indicate an external dependency. `@babel/core` does not resolve external dependencies, instead it is up to the caller -to handle any dependencies made available in the `.externalDependencies` property returned from the [`babel.transformSync`](./core.md#transformsync) method. +to handle any dependencies made available in the `.externalDependencies` property returned from the [`babel.transformSync`](./core.mdx#transformsync) method. ```js title="my-babel-preset.js" module.exports = function(api) { diff --git a/docs/configuration.md b/docs/configuration.mdx similarity index 85% rename from docs/configuration.md rename to docs/configuration.mdx index e1a83dea0e..cbe7431332 100644 --- a/docs/configuration.md +++ b/docs/configuration.mdx @@ -5,7 +5,7 @@ title: Configure Babel Babel can be configured! Many other tools have similar configs: ESLint (`.eslintrc`), Prettier (`.prettierrc`). -All Babel API [options](options.md) are allowed. However, if the option requires JavaScript, you may want to use a JavaScript [configuration file](config-files.md). +All Babel API [options](options.mdx) are allowed. However, if the option requires JavaScript, you may want to use a JavaScript [configuration file](config-files.mdx). ## What's your use case? @@ -20,7 +20,7 @@ All Babel API [options](options.md) are allowed. However, if the option requires - Guy Fieri is your hero? -> We recommend using the [`babel.config.json`](config-files.md#project-wide-configuration) format. +> We recommend using the [`babel.config.json`](config-files.mdx#project-wide-configuration) format. ### `babel.config.json` @@ -33,7 +33,7 @@ Create a file called `babel.config.json` with the following content at the root } ``` -Check out the [`babel.config.json` documentation](config-files.md#project-wide-configuration) to see more configuration options. +Check out the [`babel.config.json` documentation](config-files.mdx#project-wide-configuration) to see more configuration options. ### `.babelrc.json` @@ -46,7 +46,7 @@ Create a file called `.babelrc.json` with the following content in your project. } ``` -Check out the [.babelrc documentation](config-files.md#file-relative-configuration) to see more configuration options. +Check out the [.babelrc documentation](config-files.mdx#file-relative-configuration) to see more configuration options. ### `package.json` @@ -101,7 +101,7 @@ module.exports = function (api) { } ``` -You can read more about JavaScript configuration files in the [dedicated documentation](config-files.md) +You can read more about JavaScript configuration files in the [dedicated documentation](config-files.mdx) ## Using the CLI (`@babel/cli`) @@ -109,7 +109,7 @@ You can read more about JavaScript configuration files in the [dedicated documen babel --plugins @babel/plugin-transform-arrow-functions script.js ``` -Check out the [babel-cli documentation](cli.md) to see more configuration options. +Check out the [babel-cli documentation](cli.mdx) to see more configuration options. ## Using the API (`@babel/core`) @@ -119,7 +119,7 @@ require("@babel/core").transformSync("code", { }); ``` -Check out the [babel-core documentation](core.md) to see more configuration options. +Check out the [babel-core documentation](core.mdx) to see more configuration options. ## Print effective configs @@ -146,7 +146,7 @@ $env:BABEL_SHOW_CONFIG_FOR = ".\src\myComponent.jsx"; npm start -`BABEL_SHOW_CONFIG_FOR` accepts both absolute and relative _file_ paths. If it is a relative path, it will be resolved from [`cwd`](options.md#cwd). +`BABEL_SHOW_CONFIG_FOR` accepts both absolute and relative _file_ paths. If it is a relative path, it will be resolved from [`cwd`](options.mdx#cwd). Once Babel processes the input file specified by `BABEL_SHOW_CONFIG_FOR`, Babel will print effective configs to the console. Here is an example output: @@ -204,7 +204,7 @@ babel.config.json < .babelrc < programmatic options from @babel/cli In other words, `babel.config.json` is overwritten by `.babelrc`, and `.babelrc` is overwritten by programmatic options. -For each config source, Babel prints applicable config items (e.g. [`overrides`](options.md#overrides) and [`env`](options.md#env)) in the order of ascending priority. Generally each config sources has at least one config item -- the root content of configs. If you have configured `overrides` or `env`, Babel will not print them in the root, but will instead output a separate config item titled as `.overrides[index]`, where `index` is the position of the item. This helps determine whether the item is effective on the input and which configs it will override. +For each config source, Babel prints applicable config items (e.g. [`overrides`](options.mdx#overrides) and [`env`](options.mdx#env)) in the order of ascending priority. Generally each config sources has at least one config item -- the root content of configs. If you have configured `overrides` or `env`, Babel will not print them in the root, but will instead output a separate config item titled as `.overrides[index]`, where `index` is the position of the item. This helps determine whether the item is effective on the input and which configs it will override. If your input is ignored by `ignore` or `only`, Babel will print that this file is ignored. diff --git a/docs/core-packages.md b/docs/core-packages.md deleted file mode 100644 index d342025bae..0000000000 --- a/docs/core-packages.md +++ /dev/null @@ -1,15 +0,0 @@ ---- -title: Babel's core packages -id: core-packages ---- - -## Other packages - -* [babel-parser](parser.md): babel-parser (Babylon) is a JavaScript parser used in Babel -* [babel-core](core.md): The core module that wraps everything in our transform api (used for integrations) -* [babel-generator](generator.md): Prints a string from an AST -* [babel-types](types.md): Babel Types is a Lodash-esque utility library for AST nodes -* [babel-register](register.md): The require hook will bind itself to node's require and automatically compile files on the fly. -* [babel-template](template.md): Generate an AST from a string template -* [babel-helpers](helpers.md): Collection of helper functions used by Babel transforms -* [babel-code-frame](code-frame.md): Generate errors that contain a code frame that point to source locations diff --git a/docs/core-packages.mdx b/docs/core-packages.mdx new file mode 100644 index 0000000000..0c166e81d6 --- /dev/null +++ b/docs/core-packages.mdx @@ -0,0 +1,15 @@ +--- +title: Babel's core packages +id: core-packages +--- + +## Other packages + +* [babel-parser](parser.mdx): babel-parser (Babylon) is a JavaScript parser used in Babel +* [babel-core](core.mdx): The core module that wraps everything in our transform api (used for integrations) +* [babel-generator](generator.mdx): Prints a string from an AST +* [babel-types](types.mdx): Babel Types is a Lodash-esque utility library for AST nodes +* [babel-register](register.mdx): The require hook will bind itself to node's require and automatically compile files on the fly. +* [babel-template](template.mdx): Generate an AST from a string template +* [babel-helpers](helpers.mdx): Collection of helper functions used by Babel transforms +* [babel-code-frame](code-frame.mdx): Generate errors that contain a code frame that point to source locations diff --git a/docs/core.md b/docs/core.mdx similarity index 89% rename from docs/core.md rename to docs/core.mdx index c795c4f963..438b373b58 100644 --- a/docs/core.md +++ b/docs/core.mdx @@ -9,11 +9,11 @@ import { transform } from "@babel/core"; import * as babel from "@babel/core"; ``` -All transformations will use your local [configuration files](config-files.md). +All transformations will use your local [configuration files](config-files.mdx). ## transform -> babel.transform(code: string, [options?](options.md): Object, callback: Function) +> babel.transform(code: string, [options?](options.mdx): Object, callback: Function) Transforms the passed in `code`. Calling a callback with an object with the generated code, source map, and AST. @@ -40,7 +40,7 @@ In Babel 6, this method was synchronous and `transformSync` did not exist. For b ## transformSync -> babel.transformSync(code: string, [options?](options.md): Object) +> babel.transformSync(code: string, [options?](options.mdx): Object) Transforms the passed in `code`. Returning an object with the generated code, source map, and AST. @@ -60,7 +60,7 @@ result.ast; ## transformAsync -> babel.transformAsync(code: string, [options?](options.md): Object) +> babel.transformAsync(code: string, [options?](options.mdx): Object) Transforms the passed in `code`. Returning an promise for an object with the generated code, source map, and AST. @@ -81,7 +81,7 @@ babel.transformAsync("code();", options).then(result => { ## transformFile -> babel.transformFile(filename: string, [options?](options.md): Object, callback: Function) +> babel.transformFile(filename: string, [options?](options.mdx): Object, callback: Function) Asynchronously transforms the entire contents of a file. @@ -99,7 +99,7 @@ babel.transformFile("filename.js", options, function(err, result) { ## transformFileSync -> babel.transformFileSync(filename: string, [options?](options.md): Object) +> babel.transformFileSync(filename: string, [options?](options.mdx): Object) Synchronous version of `babel.transformFile`. Returns the transformed contents of the `filename`. @@ -116,7 +116,7 @@ babel.transformFileSync("filename.js", options).code; ## transformFileAsync -> babel.transformFileAsync(filename: string, [options?](options.md): Object) +> babel.transformFileAsync(filename: string, [options?](options.mdx): Object) Promise version of `babel.transformFile`. Returns a promise for the transformed contents of the `filename`. @@ -135,7 +135,7 @@ babel.transformFileAsync("filename.js", options).then(result => { ## transformFromAst -> babel.transformFromAst(ast: Object, code?: string, [options?](options.md): Object, callback: Function): FileNode | null +> babel.transformFromAst(ast: Object, code?: string, [options?](options.mdx): Object, callback: Function): FileNode | null Given an [AST](https://astexplorer.net/), transform it. @@ -155,7 +155,7 @@ In Babel 6, this method was synchronous and `transformFromAstSync` did not exist ## transformFromAstSync -> babel.transformFromAstSync(ast: Object, code?: string, [options?](options.md): Object) +> babel.transformFromAstSync(ast: Object, code?: string, [options?](options.mdx): Object) Given an [AST](https://astexplorer.net/), transform it. @@ -173,7 +173,7 @@ const { code, map, ast } = babel.transformFromAstSync( ## transformFromAstAsync -> babel.transformFromAstAsync(ast: Object, code?: string, [options?](options.md): Object) +> babel.transformFromAstAsync(ast: Object, code?: string, [options?](options.mdx): Object) Given an [AST](https://astexplorer.net/), transform it. @@ -191,7 +191,7 @@ babel ## parse -> babel.parse(code: string, [options?](options.md): Object, callback: Function) +> babel.parse(code: string, [options?](options.mdx): Object, callback: Function) Given some code, parse it using Babel's standard behavior. Referenced presets and plugins will be loaded such that optional syntax plugins are automatically @@ -207,7 +207,7 @@ will be dropped in Babel 8. ## parseSync -> babel.parseSync(code: string, [options?](options.md): Object) +> babel.parseSync(code: string, [options?](options.mdx): Object) Returns an AST. @@ -217,7 +217,7 @@ enabled. ## parseAsync -> babel.parseAsync(code: string, [options?](options.md): Object) +> babel.parseAsync(code: string, [options?](options.mdx): Object) Returns a promise for an AST. @@ -233,13 +233,13 @@ that aid in loading the configuration part-way without transforming. ### loadOptions -> babel.loadOptions([options?](options.md): Object) +> babel.loadOptions([options?](options.mdx): Object) Resolve Babel's options fully, resulting in an options object where: - `opts.plugins` is a full list of `Plugin` instances. - `opts.presets` is empty and all presets are flattened into `opts`. -- It can be safely passed back to Babel. Fields like [`"babelrc"`](options.md#babelrc) have been set to +- It can be safely passed back to Babel. Fields like [`"babelrc"`](options.mdx#babelrc) have been set to `false` so that later calls to Babel will not make a second attempt to load config files. @@ -250,25 +250,25 @@ invalidate properly, but it is the best we have at the moment. ### loadPartialConfig -> babel.loadPartialConfig([options?](options.md): Object): PartialConfig +> babel.loadPartialConfig([options?](options.mdx): Object): PartialConfig To allow systems to easily manipulate and validate a user's config, this function resolves the plugins and presets and proceeds no further. The expectation is that callers will take the config's `.options`, manipulate it as they see fit and pass it back to Babel again. -This function accepts one additional option as part of the options object in addition to the standard [options](options.md): `showIgnoredFiles`. +This function accepts one additional option as part of the options object in addition to the standard [options](options.mdx): `showIgnoredFiles`. When set to true, `loadPartialConfig` always returns a result when a file is ignored, rather than `null`. This is useful in order to allow the caller to access the list of files that influenced this outcome, e.g. for watch mode. The caller can determine whether a file was ignored based on the returned `fileHandling` property. -- `babelrc: string | void` - The path of the [file-relative configuration](config-files.md#file-relative-configuration) file, if there was one. +- `babelrc: string | void` - The path of the [file-relative configuration](config-files.mdx#file-relative-configuration) file, if there was one. - `babelignore: string | void` - The path of the `.babelignore` file, if there was one. -- `config: string | void` - The path of the [project-wide config file](config-files.md#project-wide-configuration) file, if there was one. +- `config: string | void` - The path of the [project-wide config file](config-files.mdx#project-wide-configuration) file, if there was one. - `options: ValidatedOptions` - The partially resolved options, which can be manipulated and passed back to Babel again. - `plugins: Array` - See below. - `presets: Array` - See below. - - It can be safely passed back to Babel. Options like [`"babelrc"`](options.md#babelrc) have been set + - It can be safely passed back to Babel. Options like [`"babelrc"`](options.mdx#babelrc) have been set to false so that later calls to Babel will not make a second attempt to load config files. - `hasFilesystemConfig(): boolean` - Check if the resolved config loaded any settings from the filesystem. @@ -313,4 +313,4 @@ Extending this list isn't possible, however @babel/cli does provide ways to supp ## Options -See [the full option list here](options.md). +See [the full option list here](options.mdx). diff --git a/docs/editors.md b/docs/editors.mdx similarity index 100% rename from docs/editors.md rename to docs/editors.mdx diff --git a/docs/env.md b/docs/env.mdx similarity index 86% rename from docs/env.md rename to docs/env.mdx index 41aa558290..c8d42053a8 100644 --- a/docs/env.md +++ b/docs/env.mdx @@ -4,7 +4,7 @@ id: env --- > We're super ๐Ÿ˜ธ excited that you're trying to use ES2015 syntax, but instead of continuing yearly presets, the team recommends using babel-preset-env. By default, it has the same behavior as previous presets to compile ES2015+ to ES5. -> Please check out the [v1.x readme for more info](https://github.com/babel/babel-preset-env/tree/1.x). (For Babel 7, we have moved the preset into the [main babel repo](preset-env.md). +> Please check out the [v1.x readme for more info](https://github.com/babel/babel-preset-env/tree/1.x). (For Babel 7, we have moved the preset into the [main babel repo](preset-env.mdx). ### Babel 7 @@ -14,7 +14,7 @@ If you are using Babel version 7 you will need to run `npm install @babel/preset You might end up on this page because you saw a message in the terminal like this: -> ๐Ÿ™Œ Thanks for using Babel: we recommend using babel-preset-env now: please read [babeljs.io/env](./env.md) to update! +> ๐Ÿ™Œ Thanks for using Babel: we recommend using babel-preset-env now: please read [babeljs.io/env](./env.mdx) to update! Before you proceed further, ask yourself: are you _using_ Babel? Check your `package.json` and look for `babel-preset-es2015` or a similar preset there. If you see a preset like this in your `package.json`, read on! @@ -28,7 +28,7 @@ If you don't use Babel or don't use deprecated yearly presets, you probably saw npm install babel-preset-env --save-dev ``` -#### Basic [options](options.md) change +#### Basic [options](options.mdx) change ```diff { @@ -37,7 +37,7 @@ npm install babel-preset-env --save-dev } ``` -#### [options](options.md) change with preset options +#### [options](options.mdx) change with preset options ```diff { @@ -59,7 +59,7 @@ npm install babel-preset-env --save-dev ## By targeting specific browsers, Babel can do less work so you can ship native ES2015+ ๐Ÿ˜Ž! -#### [options](options.md) against a specific chrome version +#### [options](options.mdx) against a specific chrome version ```json title="babel.config.json" { @@ -76,7 +76,7 @@ npm install babel-preset-env --save-dev } ``` -#### [options](options.md) against current node version +#### [options](options.mdx) against current node version ```json title="babel.config.json" { @@ -99,4 +99,4 @@ npm install babel-preset-env --save-dev - [https://gist.github.com/addyosmani/bb6e2939f943226e68e87396c4931040](https://gist.github.com/addyosmani/bb6e2939f943226e68e87396c4931040) - [Original PR](https://github.com/babel/babel/pull/3476) -Can check the [preset-env docs](preset-env.md) for more information and further docs. +Can check the [preset-env docs](preset-env.mdx) for more information and further docs. diff --git a/docs/eslint-parser.md b/docs/eslint-parser.mdx similarity index 97% rename from docs/eslint-parser.md rename to docs/eslint-parser.mdx index e731fb8f2a..3f1d2ffa7f 100644 --- a/docs/eslint-parser.md +++ b/docs/eslint-parser.mdx @@ -17,11 +17,11 @@ ESLint's default parser and core rules [only support the latest final ECMAScript ## How does it work? -ESLint allows for the use of [custom parsers](https://eslint.org/docs/developer-guide/working-with-custom-parsers). When using this plugin, your code is parsed by Babel's parser (using the configuration specified in your [Babel configuration file](./configuration.md)) and the resulting AST is +ESLint allows for the use of [custom parsers](https://eslint.org/docs/developer-guide/working-with-custom-parsers). When using this plugin, your code is parsed by Babel's parser (using the configuration specified in your [Babel configuration file](./configuration.mdx)) and the resulting AST is transformed into an [ESTree](https://github.com/estree/estree)-compliant structure that ESLint can understand. All location info such as line numbers, columns is also retained so you can track down errors with ease. -**Note:** ESLint's core rules do not support experimental syntax and may therefore not work as expected when using `@babel/eslint-parser`. Please use the companion [`@babel/eslint-plugin`](./eslint-plugin.md) plugin for core rules that you have issues with. +**Note:** ESLint's core rules do not support experimental syntax and may therefore not work as expected when using `@babel/eslint-parser`. Please use the companion [`@babel/eslint-plugin`](./eslint-plugin.mdx) plugin for core rules that you have issues with. ## Usage @@ -31,7 +31,7 @@ columns is also retained so you can track down errors with ease. npm install eslint @babel/core @babel/eslint-parser --save-dev ``` -**Note:** @babel/eslint-parser requires `@babel/core@>=7.2.0` and a valid Babel configuration file to run. If you do not have this already set up, please see the [Babel Usage Guide](./usage.md). +**Note:** @babel/eslint-parser requires `@babel/core@>=7.2.0` and a valid Babel configuration file to run. If you do not have this already set up, please see the [Babel Usage Guide](./usage.mdx). ### Setup @@ -127,7 +127,7 @@ Additional configuration options can be set in your ESLint configuration under t - `sourceType` can be set to `"module"`(default), `"script"` or `"commonjs"`. - `ecmaFeatures.globalReturn` (default `false`) allow return statements in the global scope when used with `sourceType: "script"`. This option will be deprecated, please use `sourceType: "commonjs"` instead. -- `babelOptions` is an object containing Babel configuration [options](./options.md) that are passed to Babel's parser at runtime. For cases where users might not want to use a Babel configuration file or are running Babel through another tool (such as Webpack with `babel-loader`). +- `babelOptions` is an object containing Babel configuration [options](./options.mdx) that are passed to Babel's parser at runtime. For cases where users might not want to use a Babel configuration file or are running Babel through another tool (such as Webpack with `babel-loader`). :::babel7 diff --git a/docs/eslint-plugin.md b/docs/eslint-plugin.mdx similarity index 96% rename from docs/eslint-plugin.md rename to docs/eslint-plugin.mdx index 037032d25b..5768a6b0e1 100644 --- a/docs/eslint-plugin.md +++ b/docs/eslint-plugin.mdx @@ -6,7 +6,7 @@ title: "@babel/eslint-plugin" import Tabs from '@theme/Tabs'; import TabItem from '@theme/TabItem'; -Companion rules for [`@babel/eslint-parser`](./eslint-parser.md). `@babel/eslint-parser` does a great job at adapting `eslint` +Companion rules for [`@babel/eslint-parser`](./eslint-parser.mdx). `@babel/eslint-parser` does a great job at adapting `eslint` for use with Babel, but it can't change the built-in rules to support experimental features. `@babel/eslint-plugin` re-implements problematic rules so they do not give false positives or negatives. diff --git a/docs/faq.md b/docs/faq.mdx similarity index 92% rename from docs/faq.md rename to docs/faq.mdx index 905babe94b..cf87d21493 100644 --- a/docs/faq.md +++ b/docs/faq.mdx @@ -6,7 +6,7 @@ id: faq ## Why is the output of `for...of` so verbose and ugly? In order to comply with the specification, the iterator's return method must be -called on errors. An alternative is to use [assumptions](assumptions.md) introduced in Babel 7.13, such as [`ArrayLikeIsIterable`](assumptions.md#arraylikeisiterable) and [`IterableIsArray`](assumptions.md#iterableisarray), +called on errors. An alternative is to use [assumptions](assumptions.mdx) introduced in Babel 7.13, such as [`ArrayLikeIsIterable`](assumptions.mdx#arraylikeisiterable) and [`IterableIsArray`](assumptions.mdx#iterableisarray), but please note that there are **many** caveats to be aware of if you use assumptions and that you're willingly choosing not to comply with the spec. Please see [babel/rfcs#5](https://github.com/babel/rfcs/pull/5), [google/traceur-compiler#1773](https://github.com/google/traceur-compiler/issues/1773) and @@ -41,7 +41,7 @@ more information. Babel assumes that all input code is an ES2015 module. ES2015 modules are implicitly strict mode so this means that top-level `this` is not `window` in the browser nor is it `exports` in node. -If you don't want this behaviour then you have the option of disabling `strict` in the [plugin-transform-modules-commonjs](plugin-transform-modules-commonjs.md#usage). +If you don't want this behaviour then you have the option of disabling `strict` in the [plugin-transform-modules-commonjs](plugin-transform-modules-commonjs.mdx#usage). **PLEASE NOTE:** If you do this you're willingly deviating from the spec and this may cause future interop issues. @@ -50,12 +50,12 @@ interop issues. We hear you! Babel 6 requires a tiny bit of configuration in order to get going. [We think this is for the best](/blog/2015/10/29/6.0.0) and have added -[presets](plugins.md#presets) to ease this transition. +[presets](plugins.mdx#presets) to ease this transition. ## Upgrading from Babel 5.x to Babel 6 -At the heart of Babel 6 are [plugins](plugins.md). What plugins you need completely -depends on your specific configuration but just add the following [config file](config-files.md) to +At the heart of Babel 6 are [plugins](plugins.mdx). What plugins you need completely +depends on your specific configuration but just add the following [config file](config-files.mdx) to get all the same transforms that were in Babel 5: ```json title="babel.config.json" diff --git a/docs/features-timeline.md b/docs/features-timeline.mdx similarity index 92% rename from docs/features-timeline.md rename to docs/features-timeline.mdx index 55bf60c45f..3ff9a595d4 100644 --- a/docs/features-timeline.md +++ b/docs/features-timeline.mdx @@ -242,7 +242,7 @@ Additionally, use this timeline to track some other important efforts, such as t - Enable the [Class Fields](https://github.com/tc39/proposal-class-fields), [Private Methods](https://github.com/tc39/proposal-private-methods) and [Static Class Features](https://github.com/tc39/proposal-static-class-features) Stage 4 proposals by default -- Add the [Private Brand Checks](https://github.com/tc39/proposal-private-fields-in-in) and [Static Class Blocks](https://github.com/tc39/proposal-class-static-block) proposals to `@babel/preset-env`'s [`shippedProposals`](./preset-env.md#shippedproposals) +- Add the [Private Brand Checks](https://github.com/tc39/proposal-private-fields-in-in) and [Static Class Blocks](https://github.com/tc39/proposal-class-static-block) proposals to `@babel/preset-env`'s [`shippedProposals`](./preset-env.mdx#shippedproposals) ```js title="JavaScript" class A { static { initialize(A); } // static block @@ -258,7 +258,7 @@ Additionally, use this timeline to track some other important efforts, such as t 2 + await computeIt(); }; ``` -- Support for the [`importInterop: "node"`](./plugin-transform-modules-commonjs.md#importinterop) option in `@babel/plugin-transform-modules-commonjs`, to aligh Babel with the Node.js behavior +- Support for the [`importInterop: "node"`](./plugin-transform-modules-commonjs.mdx#importinterop) option in `@babel/plugin-transform-modules-commonjs`, to aligh Babel with the Node.js behavior - [TypeScript 4.3](https://devblogs.microsoft.com/typescript/announcing-typescript-4-3/) support @@ -268,8 +268,8 @@ Additionally, use this timeline to track some other important efforts, such as t [blog post](https://babeljs.io/blog/2021/02/22/7.13.0) -- Top-level [`targets`](./options.md#output-targets) option ([RFC](https://github.com/babel/rfcs/pull/2)) -- Granular compiler assumptions ([docs](./assumptions.md), [RFC](https://github.com/babel/rfcs/pull/5)) +- Top-level [`targets`](./options.mdx#output-targets) option ([RFC](https://github.com/babel/rfcs/pull/2)) +- Granular compiler assumptions ([docs](./assumptions.mdx), [RFC](https://github.com/babel/rfcs/pull/5)) - Support for the [Records and Tuples](https://github.com/tc39/proposal-record-tuple) proposals ```js title="JavaScript" let rec = #{ x: 1 }; @@ -355,7 +355,7 @@ Additionally, use this timeline to track some other important efforts, such as t [blog post](https://babeljs.io/blog/2020/03/16/7.9.0) -- [`bugfixes`](./preset-env.md#bugfixes) option in `@babel/preset-env`, to workaround browsers bugs rather than compiling whole Features +- [`bugfixes`](./preset-env.mdx#bugfixes) option in `@babel/preset-env`, to workaround browsers bugs rather than compiling whole Features - [TypeScript 3.8](https://devblogs.microsoft.com/typescript/announcing-typescript-3-8/) support - Support for Flow `declare` class fields - Support for the [automatic](https://reactjs.org/blog/2020/09/22/introducing-the-new-jsx-transform.html) JSX runtime @@ -509,26 +509,26 @@ This has a lot more changes since it was 2 years of pre-releases. - Drop support for un-maintained Node versions: 0.10, 0.12, 4, 5 - Switch to scoped packages ([`babel-core`](https://www.npmjs.com/package/babel-core) to [`@babel/core`](https://www.npmjs.com/package/@babel/core)) - Remove yearly presets (`@babel/preset-es2015`) and Stage presets (`@babel/preset-stage-0`) ([blog post](https://babeljs.io/blog/2018/07/27/removing-babels-stage-presets)). -- Added "pure" (`/*#__PURE__*/` ) annotation support in certain cases. (Implemented later as [@babel/helper-annotate-as-pure](helper-annotate-as-pure.md) -- Add project-wide `babel.config.js` config file ([docs](config-files.md)) and [`overrides`](options.md#overrides) config option. -- Added `"useBuiltIns: "usage"` to [`@babel/preset-env`](preset-env.md#usebuiltins) +- Added "pure" (`/*#__PURE__*/` ) annotation support in certain cases. (Implemented later as [@babel/helper-annotate-as-pure](helper-annotate-as-pure.mdx) +- Add project-wide `babel.config.js` config file ([docs](config-files.mdx)) and [`overrides`](options.mdx#overrides) config option. +- Added `"useBuiltIns: "usage"` to [`@babel/preset-env`](preset-env.mdx#usebuiltins) - Support TypeScript via `@babel/preset-typescript` - Support JSX Fragments `<>` - Support a ton of TC39 proposals: - - [Unicode Property Regex](plugin-transform-unicode-property-regex.md) - - [JSON Superset](plugin-transform-json-strings.md) - - [`new.target`](plugin-transform-new-target.md) - - [Class Private Instance Fields](plugin-transform-class-properties.md) (`class A { #b = 2 }`) - - [Optional Catch Binding](plugin-transform-optional-catch-binding.md) `try { throw 0 } catch { do() }` - - [BigInt](plugin-syntax-bigint.md) (syntax only) - - [`import.meta`](plugin-syntax-import-meta.md) (syntax only) (`import.meta.url`) - - [Numeric Separators](plugin-transform-numeric-separator.md) (`1_000`) - - [`function.sent`](plugin-proposal-function-sent.md) - - [Optional Chaining](plugin-transform-optional-chaining.md) (`a?.b`) - - [Logical Assignment Operators](plugin-transform-logical-assignment-operators.md) (`a &&= b; a ||= b`) - - [Nullish Coalescing Operator](plugin-transform-nullish-coalescing-operator.md) (`a ?? b`) - - [Pipeline Operator](plugin-proposal-pipeline-operator.md) (`a |> b`) - - [Throw Expressions](plugin-proposal-throw-expressions.md) (`() => throw new Error("a")`) + - [Unicode Property Regex](plugin-transform-unicode-property-regex.mdx) + - [JSON Superset](plugin-transform-json-strings.mdx) + - [`new.target`](plugin-transform-new-target.mdx) + - [Class Private Instance Fields](plugin-transform-class-properties.mdx) (`class A { #b = 2 }`) + - [Optional Catch Binding](plugin-transform-optional-catch-binding.mdx) `try { throw 0 } catch { do() }` + - [BigInt](plugin-syntax-bigint.mdx) (syntax only) + - [`import.meta`](plugin-syntax-import-meta.mdx) (syntax only) (`import.meta.url`) + - [Numeric Separators](plugin-transform-numeric-separator.mdx) (`1_000`) + - [`function.sent`](plugin-proposal-function-sent.mdx) + - [Optional Chaining](plugin-transform-optional-chaining.mdx) (`a?.b`) + - [Logical Assignment Operators](plugin-transform-logical-assignment-operators.mdx) (`a &&= b; a ||= b`) + - [Nullish Coalescing Operator](plugin-transform-nullish-coalescing-operator.mdx) (`a ?? b`) + - [Pipeline Operator](plugin-proposal-pipeline-operator.mdx) (`a |> b`) + - [Throw Expressions](plugin-proposal-throw-expressions.mdx) (`() => throw new Error("a")`) diff --git a/docs/generator.md b/docs/generator.mdx similarity index 98% rename from docs/generator.md rename to docs/generator.mdx index a4463b1813..a584a95e3c 100644 --- a/docs/generator.md +++ b/docs/generator.mdx @@ -34,7 +34,7 @@ The symbols like white spaces or new line characters are not preserved in the AS ::: ### Parser plugins support -Babel generator supports all the listed [Babel parser plugins](./parser.md#plugins) except `estree`. Note that parser plugins do not transform the code. For example, +Babel generator supports all the listed [Babel parser plugins](./parser.mdx#plugins) except `estree`. Note that parser plugins do not transform the code. For example, if you pass JSX `
` to babel generator, the result will still contain the `div` JSX element. ```js title="JavaScript" @@ -94,7 +94,7 @@ Options for formatting output: | retainLines | boolean | `false` | Attempt to use the same line numbers in the output code as in the source code (helps preserve stack traces) | | shouldPrintComment | function | `opts.comments` | Function that takes a comment (as a string) and returns `true` if the comment should be included in the output. By default, comments are included if `opts.comments` is `true` or if `opts.minified` is `false` and the comment contains `@preserve` or `@license` | | recordAndTupleSyntaxType | `'hash'` or `'bar'` | `'hash'` | For use with the recordAndTuple token. -| topicToken | `'%'` or `'#'` | | The token to use with [Hack-pipe topic references](plugin-proposal-pipeline-operator.md). This is required when there are any `TopicReference` nodes. +| topicToken | `'%'` or `'#'` | | The token to use with [Hack-pipe topic references](plugin-proposal-pipeline-operator.mdx). This is required when there are any `TopicReference` nodes. Options for source maps: diff --git a/docs/gulp-babel-minify.md b/docs/gulp-babel-minify.mdx similarity index 93% rename from docs/gulp-babel-minify.md rename to docs/gulp-babel-minify.mdx index 5eb5498da5..03c0fee99a 100644 --- a/docs/gulp-babel-minify.md +++ b/docs/gulp-babel-minify.mdx @@ -33,7 +33,7 @@ gulpBabelMinify(minifyOptions, overrides); ### minifyOptions -These are passed on to the minify preset. Refer to the [preset-minify options](preset-minify.md#options). Default `{}` +These are passed on to the minify preset. Refer to the [preset-minify options](preset-minify.mdx#options). Default `{}` ### Overrides diff --git a/docs/helper-annotate-as-pure.md b/docs/helper-annotate-as-pure.mdx similarity index 100% rename from docs/helper-annotate-as-pure.md rename to docs/helper-annotate-as-pure.mdx diff --git a/docs/helper-bindify-decorators.md b/docs/helper-bindify-decorators.mdx similarity index 100% rename from docs/helper-bindify-decorators.md rename to docs/helper-bindify-decorators.mdx diff --git a/docs/helper-builder-binary-assignment-operator-visitor.md b/docs/helper-builder-binary-assignment-operator-visitor.mdx similarity index 100% rename from docs/helper-builder-binary-assignment-operator-visitor.md rename to docs/helper-builder-binary-assignment-operator-visitor.mdx diff --git a/docs/helper-builder-react-jsx.md b/docs/helper-builder-react-jsx.mdx similarity index 100% rename from docs/helper-builder-react-jsx.md rename to docs/helper-builder-react-jsx.mdx diff --git a/docs/helper-call-delegate.md b/docs/helper-call-delegate.mdx similarity index 100% rename from docs/helper-call-delegate.md rename to docs/helper-call-delegate.mdx diff --git a/docs/helper-check-duplicate-nodes.md b/docs/helper-check-duplicate-nodes.mdx similarity index 100% rename from docs/helper-check-duplicate-nodes.md rename to docs/helper-check-duplicate-nodes.mdx diff --git a/docs/helper-compilation-targets.md b/docs/helper-compilation-targets.mdx similarity index 94% rename from docs/helper-compilation-targets.md rename to docs/helper-compilation-targets.mdx index 43392d836c..c1071fd6e3 100644 --- a/docs/helper-compilation-targets.md +++ b/docs/helper-compilation-targets.mdx @@ -4,7 +4,7 @@ title: "@babel/helper-compilation-targets" sidebar_label: helper-compilation-targets --- -`@babel/helper-compilation-targets` is a helper package that works with compilation targets (browsers or other environments like node) and compat tables (knowing what version supports a specific syntax). It is used by `@babel/preset-env` to determine which plugin should be enabled based on the [`targets`](options.md#targets) option. +`@babel/helper-compilation-targets` is a helper package that works with compilation targets (browsers or other environments like node) and compat tables (knowing what version supports a specific syntax). It is used by `@babel/preset-env` to determine which plugin should be enabled based on the [`targets`](options.mdx#targets) option. ```js title="JavaScript" import { @@ -38,7 +38,7 @@ function filterItems( ): Set; // A set of enabled plugins ``` -Given a compat data table `list` (i.e. `@babel/compat-data`) and [browser targets](preset-env.md#targets) `targets`, return a set of required plugins. +Given a compat data table `list` (i.e. `@babel/compat-data`) and [browser targets](preset-env.mdx#targets) `targets`, return a set of required plugins. **Example** @@ -151,7 +151,7 @@ Normalize user specified `targets` to a list of supported targets. See also (`@b getTargets(); ``` -An empty compilation target is equivalent to [force all transforms](preset-env.md#forceAllTransforms). The default compilation targets will be changed to browserlists query [`defaults, not IE 11`](https://runkit.com/jlhwung/605cd58b2c44c6001a463717) in Babel 8. +An empty compilation target is equivalent to [force all transforms](preset-env.mdx#forceAllTransforms). The default compilation targets will be changed to browserlists query [`defaults, not IE 11`](https://runkit.com/jlhwung/605cd58b2c44c6001a463717) in Babel 8. One can also query the compilation targets with ES Module support, like [`@vue/babel-preset-app`](https://github.com/vuejs/vue-cli/tree/dev/packages/%40vue/babel-preset-app) did in order to provide a set of modern targets. diff --git a/docs/helper-create-class-features-plugin.md b/docs/helper-create-class-features-plugin.mdx similarity index 100% rename from docs/helper-create-class-features-plugin.md rename to docs/helper-create-class-features-plugin.mdx diff --git a/docs/helper-create-regexp-features-plugin.md b/docs/helper-create-regexp-features-plugin.mdx similarity index 100% rename from docs/helper-create-regexp-features-plugin.md rename to docs/helper-create-regexp-features-plugin.mdx diff --git a/docs/helper-define-map.md b/docs/helper-define-map.mdx similarity index 100% rename from docs/helper-define-map.md rename to docs/helper-define-map.mdx diff --git a/docs/helper-environment-visitor.md b/docs/helper-environment-visitor.mdx similarity index 98% rename from docs/helper-environment-visitor.md rename to docs/helper-environment-visitor.mdx index 2ec23ecc46..1bdd872b37 100644 --- a/docs/helper-environment-visitor.md +++ b/docs/helper-environment-visitor.mdx @@ -138,7 +138,7 @@ module.exports = (api) => { ``` `"FunctionDeclaration|..."` is a really long string and can be difficult to maintain. We can -shorten it by using the [FunctionParent](types.md#functionparent) alias: +shorten it by using the [FunctionParent](types.mdx#functionparent) alias: ```js title="Revision 3: replace-top-level-this-plugin.js" module.exports = (api) => { @@ -255,7 +255,7 @@ module.exports = (api) => { You can try out the final revision on the [AST Explorer](https://astexplorer.net/#/gist/4d1bfca2b315f687da44f3436b2f4d76/58c9b92d4f77586f23f56393252104a274ccb157). -As its name implies, `requeueComputedKeyAndDecorators` supports [ES decorators](./plugin-proposal-decorators.md) as well: +As its name implies, `requeueComputedKeyAndDecorators` supports [ES decorators](./plugin-proposal-decorators.mdx) as well: ```js title="input.js" class Foo { diff --git a/docs/helper-evaluate-path.md b/docs/helper-evaluate-path.mdx similarity index 100% rename from docs/helper-evaluate-path.md rename to docs/helper-evaluate-path.mdx diff --git a/docs/helper-explode-assignable-expression.md b/docs/helper-explode-assignable-expression.mdx similarity index 100% rename from docs/helper-explode-assignable-expression.md rename to docs/helper-explode-assignable-expression.mdx diff --git a/docs/helper-explode-class.md b/docs/helper-explode-class.mdx similarity index 100% rename from docs/helper-explode-class.md rename to docs/helper-explode-class.mdx diff --git a/docs/helper-fixtures.md b/docs/helper-fixtures.mdx similarity index 100% rename from docs/helper-fixtures.md rename to docs/helper-fixtures.mdx diff --git a/docs/helper-flip-expressions.md b/docs/helper-flip-expressions.mdx similarity index 100% rename from docs/helper-flip-expressions.md rename to docs/helper-flip-expressions.mdx diff --git a/docs/helper-function-name.md b/docs/helper-function-name.mdx similarity index 100% rename from docs/helper-function-name.md rename to docs/helper-function-name.mdx diff --git a/docs/helper-get-function-arity.md b/docs/helper-get-function-arity.mdx similarity index 100% rename from docs/helper-get-function-arity.md rename to docs/helper-get-function-arity.mdx diff --git a/docs/helper-globals.md b/docs/helper-globals.mdx similarity index 100% rename from docs/helper-globals.md rename to docs/helper-globals.mdx diff --git a/docs/helper-hoist-variables.md b/docs/helper-hoist-variables.mdx similarity index 100% rename from docs/helper-hoist-variables.md rename to docs/helper-hoist-variables.mdx diff --git a/docs/helper-is-void-0.md b/docs/helper-is-void-0.mdx similarity index 100% rename from docs/helper-is-void-0.md rename to docs/helper-is-void-0.mdx diff --git a/docs/helper-mark-eval-scopes.md b/docs/helper-mark-eval-scopes.mdx similarity index 100% rename from docs/helper-mark-eval-scopes.md rename to docs/helper-mark-eval-scopes.mdx diff --git a/docs/helper-member-expression-to-functions.md b/docs/helper-member-expression-to-functions.mdx similarity index 100% rename from docs/helper-member-expression-to-functions.md rename to docs/helper-member-expression-to-functions.mdx diff --git a/docs/helper-module-imports.md b/docs/helper-module-imports.mdx similarity index 100% rename from docs/helper-module-imports.md rename to docs/helper-module-imports.mdx diff --git a/docs/helper-module-transforms.md b/docs/helper-module-transforms.mdx similarity index 100% rename from docs/helper-module-transforms.md rename to docs/helper-module-transforms.mdx diff --git a/docs/helper-optimise-call-expression.md b/docs/helper-optimise-call-expression.mdx similarity index 100% rename from docs/helper-optimise-call-expression.md rename to docs/helper-optimise-call-expression.mdx diff --git a/docs/helper-plugin-test-runner.md b/docs/helper-plugin-test-runner.mdx similarity index 100% rename from docs/helper-plugin-test-runner.md rename to docs/helper-plugin-test-runner.mdx diff --git a/docs/helper-plugin-utils.md b/docs/helper-plugin-utils.mdx similarity index 100% rename from docs/helper-plugin-utils.md rename to docs/helper-plugin-utils.mdx diff --git a/docs/helper-regex.md b/docs/helper-regex.mdx similarity index 100% rename from docs/helper-regex.md rename to docs/helper-regex.mdx diff --git a/docs/helper-remap-async-to-generator.md b/docs/helper-remap-async-to-generator.mdx similarity index 100% rename from docs/helper-remap-async-to-generator.md rename to docs/helper-remap-async-to-generator.mdx diff --git a/docs/helper-remove-or-void.md b/docs/helper-remove-or-void.mdx similarity index 100% rename from docs/helper-remove-or-void.md rename to docs/helper-remove-or-void.mdx diff --git a/docs/helper-replace-supers.md b/docs/helper-replace-supers.mdx similarity index 100% rename from docs/helper-replace-supers.md rename to docs/helper-replace-supers.mdx diff --git a/docs/helper-simple-access.md b/docs/helper-simple-access.mdx similarity index 100% rename from docs/helper-simple-access.md rename to docs/helper-simple-access.mdx diff --git a/docs/helper-skip-transparent-expression-wrappers.md b/docs/helper-skip-transparent-expression-wrappers.mdx similarity index 100% rename from docs/helper-skip-transparent-expression-wrappers.md rename to docs/helper-skip-transparent-expression-wrappers.mdx diff --git a/docs/helper-split-export-declaration.md b/docs/helper-split-export-declaration.mdx similarity index 100% rename from docs/helper-split-export-declaration.md rename to docs/helper-split-export-declaration.mdx diff --git a/docs/helper-string-parser.md b/docs/helper-string-parser.mdx similarity index 100% rename from docs/helper-string-parser.md rename to docs/helper-string-parser.mdx diff --git a/docs/helper-to-multiple-sequence-expressions.md b/docs/helper-to-multiple-sequence-expressions.mdx similarity index 100% rename from docs/helper-to-multiple-sequence-expressions.md rename to docs/helper-to-multiple-sequence-expressions.mdx diff --git a/docs/helper-transform-fixture-test-runner.md b/docs/helper-transform-fixture-test-runner.mdx similarity index 100% rename from docs/helper-transform-fixture-test-runner.md rename to docs/helper-transform-fixture-test-runner.mdx diff --git a/docs/helper-validator-identifier.md b/docs/helper-validator-identifier.mdx similarity index 100% rename from docs/helper-validator-identifier.md rename to docs/helper-validator-identifier.mdx diff --git a/docs/helper-validator-option.md b/docs/helper-validator-option.mdx similarity index 100% rename from docs/helper-validator-option.md rename to docs/helper-validator-option.mdx diff --git a/docs/helper-wrap-function.md b/docs/helper-wrap-function.mdx similarity index 100% rename from docs/helper-wrap-function.md rename to docs/helper-wrap-function.mdx diff --git a/docs/helpers.md b/docs/helpers.mdx similarity index 100% rename from docs/helpers.md rename to docs/helpers.mdx diff --git a/docs/index.md b/docs/index.mdx similarity index 82% rename from docs/index.md rename to docs/index.mdx index 3685e14ec6..6164c6a192 100644 --- a/docs/index.md +++ b/docs/index.mdx @@ -30,11 +30,11 @@ For an awesome tutorial on compilers, check out [the-super-tiny-compiler](https: Babel has support for the latest version of JavaScript through syntax transformers. -These [plugins](plugins-list.md) allow you to use new syntax, **right now** without waiting for browser support. Check out our [usage guide](usage.md) to get started. +These [plugins](plugins-list.mdx) allow you to use new syntax, **right now** without waiting for browser support. Check out our [usage guide](usage.mdx) to get started. ## JSX and React -Babel can convert JSX syntax! Check out our [React preset](preset-react.md) to get started. Use it together with the [babel-sublime](https://github.com/babel/babel-sublime) package to bring syntax highlighting to a whole new level. +Babel can convert JSX syntax! Check out our [React preset](preset-react.mdx) to get started. Use it together with the [babel-sublime](https://github.com/babel/babel-sublime) package to bring syntax highlighting to a whole new level. You can install this preset with @@ -72,7 +72,7 @@ Learn more about [JSX](https://facebook.github.io/jsx/) ## Type Annotations (Flow and TypeScript) -Babel can strip out type annotations! Check out either our [Flow preset](preset-flow.md) or [TypeScript preset](preset-typescript.md) to get started. Keep in mind that **Babel doesn't do type checking**; you'll still have to install and use Flow or TypeScript to check types. +Babel can strip out type annotations! Check out either our [Flow preset](preset-flow.mdx) or [TypeScript preset](preset-typescript.mdx) to get started. Keep in mind that **Babel doesn't do type checking**; you'll still have to install and use Flow or TypeScript to check types. You can install the flow preset with @@ -105,7 +105,7 @@ Learn more about [Flow](https://flow.org/) and [TypeScript](https://www.typescri ## Pluggable -Babel is built out of plugins. Compose your own transformation pipeline using existing plugins or write your own. Easily use a set of plugins by using or creating a [preset](plugins.md#presets). [Learn more โ†’](plugins.md) +Babel is built out of plugins. Compose your own transformation pipeline using existing plugins or write your own. Easily use a set of plugins by using or creating a [preset](plugins.mdx#presets). [Learn more โ†’](plugins.mdx) Create a plugin on the fly with [astexplorer.net](https://astexplorer.net/#/KJ8AjD6maa) or use [generator-babel-plugin](https://github.com/babel/generator-babel-plugin) to generate a plugin template. @@ -137,4 +137,4 @@ Babel tries to stay true to the ECMAScript standard, as much as reasonably possi Babel tries using the least amount of code possible with no dependence on a bulky runtime. -This may be difficult to do in cases, and there are ["assumptions"](assumptions.md) options that tradeoff spec compliancy for readability, file size, and speed. +This may be difficult to do in cases, and there are ["assumptions"](assumptions.mdx) options that tradeoff spec compliancy for readability, file size, and speed. diff --git a/docs/learn.md b/docs/learn.mdx similarity index 99% rename from docs/learn.md rename to docs/learn.mdx index 5654f75131..55e6f760e9 100644 --- a/docs/learn.md +++ b/docs/learn.mdx @@ -23,7 +23,7 @@ for full specification of the ECMAScript 2015 language. ## ECMAScript 2015 Features - +{/* To not break some existing links to here, just in case. */} ### Arrows and Lexical This diff --git a/docs/minify.md b/docs/minify.mdx similarity index 96% rename from docs/minify.md rename to docs/minify.mdx index 3a9bf5be83..68c284e249 100644 --- a/docs/minify.md +++ b/docs/minify.mdx @@ -44,7 +44,7 @@ minify(input, minifyOptions, overrides); ### minifyOptions -Refer [babel-preset-minify options](preset-minify.md#options) +Refer [babel-preset-minify options](preset-minify.mdx#options) ### overrides diff --git a/docs/node.md b/docs/node.mdx similarity index 93% rename from docs/node.md rename to docs/node.mdx index 04e1708402..7710555afa 100644 --- a/docs/node.md +++ b/docs/node.mdx @@ -104,7 +104,7 @@ npx babel-node --arg-for-babel script.js --arg-for-script.js | `-i, --ignore [regex]` | `node_modules` | Ignore all files that match this regex when using the require hook. If both `-i` and `-o` are omitted, files outside the current working directory are also ignored. | | `-o, --only [regex]` | current working directory | Only include (and exclude all other) files that match this regex when using the require hook. If both `-i` and `-o` are omitted, files outside the current working directory are also ignored. | | `-x, --extensions` | `".js",".jsx",".es6",".es","cjs"` | List of extensions to hook into | -| `--presets` | `[]` | Comma-separated list of [presets](presets.md) (a set of plugins) to load and use. | -| `--plugins` | `[]` | Comma-separated list of [plugins](plugins.md) to load and use. | +| `--presets` | `[]` | Comma-separated list of [presets](presets.mdx) (a set of plugins) to load and use. | +| `--plugins` | `[]` | Comma-separated list of [plugins](plugins.mdx) to load and use. | | `--config-file [path]` | `[]` | Path to the babel config file to use. Defaults to working directory `babel.config.json` or `babel.config.js`. The following options in config files are not supported: `ignore`, `only`. | | `--env-name [name]` | `[]` | The name of the 'env' to use when loading configs and plugins. Defaults to the value of BABEL_ENV, or else NODE_ENV, or else 'development'. | diff --git a/docs/options.md b/docs/options.mdx similarity index 96% rename from docs/options.md rename to docs/options.mdx index 6262a05a78..360bfde134 100644 --- a/docs/options.md +++ b/docs/options.mdx @@ -16,7 +16,7 @@ sidebar_label: Config Options Options can be passed to Babel in a variety of ways. When passed directly to Babel, you can just pass the options object. When Babel is used via a wrapper, it may also be -necessary, or at least more useful, to pass the options via [configuration files](config-files.md). +necessary, or at least more useful, to pass the options via [configuration files](config-files.mdx). If passing options via `@babel/cli` you'll need to `kebab-case` the names. i.e. @@ -29,7 +29,7 @@ npx babel --root-mode upward file.js # equivalent of passing the rootMode config These options are only allowed as part of Babel's programmatic options, so they are primarily for use by tools that wrap around Babel, or people calling `babel.transform` directly. Users of Babel's integrations, like `babel-loader` -or [`@babel/register`](core.md#options) are unlikely to use these. +or [`@babel/register`](core.mdx#options) are unlikely to use these. ### `cwd` @@ -188,12 +188,12 @@ Note: `babel.config.json` is supported from Babel 7.8.0. In older Babel 7 versio - `"root"` - Passes the [`"root"`](#root) value through as unchanged. - `"upward"` - Walks upward from the [`"root"`](#root) directory, looking - for a directory containing a [`babel.config.json`](config-files.md#project-wide-configuration) - file, and throws an error if a [`babel.config.json`](config-files.md#project-wide-configuration) + for a directory containing a [`babel.config.json`](config-files.mdx#project-wide-configuration) + file, and throws an error if a [`babel.config.json`](config-files.mdx#project-wide-configuration) is not found. - `"upward-optional"` - Walk upward from the [`"root"`](#root) directory, - looking for a directory containing a [`babel.config.json`](config-files.md#project-wide-configuration) - file, and falls back to [`"root"`](#root) if a [`babel.config.json`](config-files.md#project-wide-configuration) + looking for a directory containing a [`babel.config.json`](config-files.mdx#project-wide-configuration) + file, and falls back to [`"root"`](#root) if a [`babel.config.json`](config-files.mdx#project-wide-configuration) is not found. `"root"` is the default mode because it avoids the risk that Babel will @@ -204,9 +204,9 @@ possible that someone will have a forgotten `babel.config.json` in their home directory, which could cause unexpected errors in your builds. Users with monorepo project structures that run builds/tests on a per-package basis -may well want to use `"upward"` since monorepos often have a [`babel.config.json`](config-files.md#project-wide-configuration) +may well want to use `"upward"` since monorepos often have a [`babel.config.json`](config-files.mdx#project-wide-configuration) in the project root. Running Babel in a monorepo subdirectory without `"upward"`, -will cause Babel to skip loading any [`babel.config.json`](config-files.md#project-wide-configuration) +will cause Babel to skip loading any [`babel.config.json`](config-files.mdx#project-wide-configuration) files in the project root, which can lead to unexpected errors and compilation failure. ### `envName` @@ -218,7 +218,7 @@ Placement: Only allowed in Babel's programmatic options
The current active environment used during configuration loading. This value is used as the key when resolving [`"env"`](#env) configs, and is also available inside configuration functions, plugins, and presets, via the -[`api.env()`](config-files.md#apienv) function. +[`api.env()`](config-files.mdx#apienv) function. ### `configFile` @@ -229,9 +229,9 @@ Placement: Only allowed in Babel's programmatic options
Defaults to searching for a default `babel.config.json` file, but can be passed the path of any JS or JSON5 config file. -NOTE: This option does _not_ affect loading of [`.babelrc.json`](config-files.md#file-relative-configuration) files, so while +NOTE: This option does _not_ affect loading of [`.babelrc.json`](config-files.mdx#file-relative-configuration) files, so while it may be tempting to do `configFile: "./foo/.babelrc.json"`, it is not recommended. -If the given [`.babelrc.json`](config-files.md#file-relative-configuration) is loaded via the standard +If the given [`.babelrc.json`](config-files.mdx#file-relative-configuration) is loaded via the standard file-relative logic, you'll end up loading the same config file twice, merging it with itself. If you are linking a specific config file, it is recommended to stick with a naming scheme that is independent of the "babelrc" name. @@ -242,7 +242,7 @@ Type: `boolean`
Default: `true` as long as the `filename` option has been specified
Placement: Allowed in Babel's programmatic options, or inside of the loaded [`"configFile"`](#configfile). A programmatic option will override a config file one.
-`true` will enable searching for [configuration files](config-files.md#file-relative-configuration) +`true` will enable searching for [configuration files](config-files.mdx#file-relative-configuration) and the legacy `.babelignore` file relative to the [`"filename"`](#filename) provided to Babel. A `babelrc` value passed in the programmatic options will override one set @@ -291,7 +291,7 @@ individual entries interact, especially when used across multiple nested [`"env" Note: The option also allows `Plugin` instances from Babel itself, but using these directly is not recommended. If you need to create a persistent -representation of a plugin or preset, you should use [`babel.createConfigItem()`](core.md#createconfigitem). +representation of a plugin or preset, you should use [`babel.createConfigItem()`](core.mdx#createconfigitem). ### `presets` @@ -340,7 +340,7 @@ Added in: `v7.13.0`
Describes the environments you support/target for your project. -This can either be a [browserslist-compatible](https://github.com/ai/browserslist) query (with [caveats](preset-env.md#ineffective-browserslist-queries)): +This can either be a [browserslist-compatible](https://github.com/ai/browserslist) query (with [caveats](preset-env.mdx#ineffective-browserslist-queries)): ```json title="babel.config.json" { @@ -667,7 +667,7 @@ Default: "module"
- `"script"` - Parse the file using the ECMAScript Script grammar. No `import`/`export` statements allowed, and files are not in strict mode. - `"module"` - Parse the file using the ECMAScript Module grammar. Files are automatically strict, and `import`/`export` statements are allowed. -- `"commonjs"` - Parse the file as it will be run in a CommonJS environment. This option is recommended when transforming `.cjs` sources. See [Parser docs](./parser.md#options) for syntax +- `"commonjs"` - Parse the file as it will be run in a CommonJS environment. This option is recommended when transforming `.cjs` sources. See [Parser docs](./parser.mdx#options) for syntax differences between `"script"` and `"commonjs"`. - `"unambiguous"` - Consider the file a "module" if `import`/`export` statements are present, or else consider it a "script". @@ -679,11 +679,11 @@ This option is important because the type of the current file affects both parsing of input files, and certain transforms that may wish to add `import`/`require` usage to the current file. -For instance, [`@babel/plugin-transform-runtime`](plugin-transform-runtime.md) +For instance, [`@babel/plugin-transform-runtime`](plugin-transform-runtime.mdx) relies on the type of the current document to decide whether to insert an `import` declaration, or a `require()` call. -[`@babel/preset-env`](preset-env.md) also does the same for its -[`"useBuiltIns"`](preset-env.md#usebuiltins) option. Since Babel defaults to treating files +[`@babel/preset-env`](preset-env.mdx) also does the same for its +[`"useBuiltIns"`](preset-env.mdx#usebuiltins) option. Since Babel defaults to treating files are ES modules, generally these plugins/presets will insert `import` statements. Setting the correct `sourceType` can be important because having the wrong type can lead to cases where Babel would insert `import` statements into files that are meant to be CommonJS @@ -713,7 +713,7 @@ Set assumptions that Babel can make in order to produce smaller output: } ``` -For more informations, check the [assumptions](assumptions.md) documentation page. +For more informations, check the [assumptions](assumptions.mdx) documentation page. ### `highlightCode` @@ -742,7 +742,7 @@ Type: `{}`
An opaque object containing options to pass through to the parser being used. -For available parser options, see [Parser Options](parser.md#options). +For available parser options, see [Parser Options](parser.mdx#options). ### `generatorOpts` @@ -821,7 +821,7 @@ output code from Babel. ### Advanced Usage -For more code generator options, see [Generator Options](generator.md#options). +For more code generator options, see [Generator Options](generator.mdx#options). ## AMD / UMD / SystemJS module options @@ -898,7 +898,7 @@ Here are examples, where `*` does *not* have a wildcard function: ### Merging -Please refer to [How Babel merges config items](configuration.md#how-babel-merges-config-items). +Please refer to [How Babel merges config items](configuration.mdx#how-babel-merges-config-items). ### Plugin/Preset entries diff --git a/docs/parser.md b/docs/parser.mdx similarity index 99% rename from docs/parser.md rename to docs/parser.mdx index a6e4c701e9..b58ecb245a 100644 --- a/docs/parser.md +++ b/docs/parser.mdx @@ -345,7 +345,7 @@ You should enable these features only if you are using an older version. - +{/* TODO: Is this note still true? Don't we raise an exception? */} :::note When a plugin is specified multiple times, only the first options are considered. @@ -388,7 +388,7 @@ When a plugin is specified multiple times, only the first options are considered - `proposal` (required, accepted values: `fsharp`, `hack`, ~~`minimal`~~, ~~`smart`~~ (deprecated)) There are several different proposals for the pipeline operator. This option chooses which proposal to use. - See [plugin-proposal-pipeline-operator](plugin-proposal-pipeline-operator.md) + See [plugin-proposal-pipeline-operator](plugin-proposal-pipeline-operator.mdx) for more information, including a table comparing their behavior. ::: @@ -396,7 +396,7 @@ When a plugin is specified multiple times, only the first options are considered - `proposal` (required, accepted values: `fsharp`, `hack`) There are several different proposals for the pipeline operator. This option chooses which proposal to use. - See [plugin-proposal-pipeline-operator](plugin-proposal-pipeline-operator.md) + See [plugin-proposal-pipeline-operator](plugin-proposal-pipeline-operator.mdx) for more information, including a table comparing their behavior. ::: @@ -488,7 +488,7 @@ We currently aren't willing to commit to supporting the API for plugins or the r Our current recommendation for those that want to create their own custom syntax is for users to fork the parser. -To consume your custom parser, you can add a plugin to your [options](options.md#plugins) to call the parser via its npm package name or require it if using JavaScript, +To consume your custom parser, you can add a plugin to your [options](options.mdx#plugins) to call the parser via its npm package name or require it if using JavaScript, ```js title="JavaScript" const parse = require("custom-fork-of-babel-parser-on-npm-here"); diff --git a/docs/plugin-bugfix-firefox-class-in-computed-class-key.md b/docs/plugin-bugfix-firefox-class-in-computed-class-key.mdx similarity index 100% rename from docs/plugin-bugfix-firefox-class-in-computed-class-key.md rename to docs/plugin-bugfix-firefox-class-in-computed-class-key.mdx diff --git a/docs/plugin-bugfix-safari-class-field-initializer-scope.md b/docs/plugin-bugfix-safari-class-field-initializer-scope.mdx similarity index 100% rename from docs/plugin-bugfix-safari-class-field-initializer-scope.md rename to docs/plugin-bugfix-safari-class-field-initializer-scope.mdx diff --git a/docs/plugin-bugfix-safari-id-destructuring-collision-in-function-expression.md b/docs/plugin-bugfix-safari-id-destructuring-collision-in-function-expression.mdx similarity index 88% rename from docs/plugin-bugfix-safari-id-destructuring-collision-in-function-expression.md rename to docs/plugin-bugfix-safari-id-destructuring-collision-in-function-expression.mdx index 78c1612957..1f9680956e 100644 --- a/docs/plugin-bugfix-safari-id-destructuring-collision-in-function-expression.md +++ b/docs/plugin-bugfix-safari-id-destructuring-collision-in-function-expression.mdx @@ -7,7 +7,7 @@ sidebar_label: safari-id-destructuring-collision-in-function-expression This bugfix plugin renames destructuring parameters to workaround a [Safari bug](https://bugs.webkit.org/show_bug.cgi?id=220517) affecting versions 10 to 16.2. :::tip -This plugin is included in `@babel/preset-env`. Set the [`bugfixes` option](./preset-env.md#bugfixes) to `true` so Babel will automatically enable this plugin for you when your `targets` are affected by the browser bug. +This plugin is included in `@babel/preset-env`. Set the [`bugfixes` option](./preset-env.mdx#bugfixes) to `true` so Babel will automatically enable this plugin for you when your `targets` are affected by the browser bug. ::: ## Installation diff --git a/docs/plugin-bugfix-v8-spread-parameters-in-optional-chaining.md b/docs/plugin-bugfix-v8-spread-parameters-in-optional-chaining.mdx similarity index 86% rename from docs/plugin-bugfix-v8-spread-parameters-in-optional-chaining.md rename to docs/plugin-bugfix-v8-spread-parameters-in-optional-chaining.mdx index ab70119dde..70e4f7e733 100644 --- a/docs/plugin-bugfix-v8-spread-parameters-in-optional-chaining.md +++ b/docs/plugin-bugfix-v8-spread-parameters-in-optional-chaining.mdx @@ -7,7 +7,7 @@ sidebar_label: v8-spread-parameters-in-optional-chaining This bugfix plugin transforms optional chaining operators to workaround a [V8 bug](https://crbug.com/v8/11558) affecting versions 8.0 to 9.0. :::tip -This plugin is included in `@babel/preset-env`. Set the [`bugfixes` option](./preset-env.md#bugfixes) to `true` so Babel will automatically enable this plugin for you when your `targets` are affected by the browser bug. +This plugin is included in `@babel/preset-env`. Set the [`bugfixes` option](./preset-env.mdx#bugfixes) to `true` so Babel will automatically enable this plugin for you when your `targets` are affected by the browser bug. ::: ## Installation diff --git a/docs/plugin-external-helpers.md b/docs/plugin-external-helpers.mdx similarity index 100% rename from docs/plugin-external-helpers.md rename to docs/plugin-external-helpers.mdx diff --git a/docs/plugin-minify-builtins.md b/docs/plugin-minify-builtins.mdx similarity index 97% rename from docs/plugin-minify-builtins.md rename to docs/plugin-minify-builtins.mdx index f2628ed689..06f253b807 100644 --- a/docs/plugin-minify-builtins.md +++ b/docs/plugin-minify-builtins.mdx @@ -56,5 +56,5 @@ require("@babel/core").transformSync("code", { + `tdz` - Account for TDZ (Temporal Dead Zone) :::tip -You can read more about configuring plugin options [here](./plugins.md#plugin-options) +You can read more about configuring plugin options [here](./plugins.mdx#plugin-options) ::: diff --git a/docs/plugin-minify-constant-folding.md b/docs/plugin-minify-constant-folding.mdx similarity index 98% rename from docs/plugin-minify-constant-folding.md rename to docs/plugin-minify-constant-folding.mdx index de9958aa16..cb15947b74 100644 --- a/docs/plugin-minify-constant-folding.md +++ b/docs/plugin-minify-constant-folding.mdx @@ -90,5 +90,5 @@ require("@babel/core").transformSync("code", { + `tdz` - Account for TDZ (Temporal Dead Zone) :::tip -You can read more about configuring plugin options [here](./plugins.md#plugin-options) +You can read more about configuring plugin options [here](./plugins.mdx#plugin-options) ::: diff --git a/docs/plugin-minify-dead-code-elimination.md b/docs/plugin-minify-dead-code-elimination.mdx similarity index 98% rename from docs/plugin-minify-dead-code-elimination.md rename to docs/plugin-minify-dead-code-elimination.mdx index 53a63f801b..14e0572998 100644 --- a/docs/plugin-minify-dead-code-elimination.md +++ b/docs/plugin-minify-dead-code-elimination.mdx @@ -74,5 +74,5 @@ require("@babel/core").transformSync("code", { + `tdz` - Account for TDZ (Temporal Dead Zone) :::tip -You can read more about configuring plugin options [here](./plugins.md#plugin-options) +You can read more about configuring plugin options [here](./plugins.mdx#plugin-options) ::: diff --git a/docs/plugin-minify-flip-comparisons.md b/docs/plugin-minify-flip-comparisons.mdx similarity index 100% rename from docs/plugin-minify-flip-comparisons.md rename to docs/plugin-minify-flip-comparisons.mdx diff --git a/docs/plugin-minify-guarded-expressions.md b/docs/plugin-minify-guarded-expressions.mdx similarity index 100% rename from docs/plugin-minify-guarded-expressions.md rename to docs/plugin-minify-guarded-expressions.mdx diff --git a/docs/plugin-minify-infinity.md b/docs/plugin-minify-infinity.mdx similarity index 100% rename from docs/plugin-minify-infinity.md rename to docs/plugin-minify-infinity.mdx diff --git a/docs/plugin-minify-mangle-names.md b/docs/plugin-minify-mangle-names.mdx similarity index 98% rename from docs/plugin-minify-mangle-names.md rename to docs/plugin-minify-mangle-names.mdx index 194024b13e..a37e9ed8cb 100644 --- a/docs/plugin-minify-mangle-names.md +++ b/docs/plugin-minify-mangle-names.mdx @@ -79,5 +79,5 @@ require("@babel/core").transformSync("code", { + `keepClassName` - prevent mangler from altering class names (default: `false`). :::tip -You can read more about configuring plugin options [here](./plugins.md#plugin-options) +You can read more about configuring plugin options [here](./plugins.mdx#plugin-options) ::: diff --git a/docs/plugin-minify-numeric-literals.md b/docs/plugin-minify-numeric-literals.mdx similarity index 100% rename from docs/plugin-minify-numeric-literals.md rename to docs/plugin-minify-numeric-literals.mdx diff --git a/docs/plugin-minify-replace.md b/docs/plugin-minify-replace.mdx similarity index 100% rename from docs/plugin-minify-replace.md rename to docs/plugin-minify-replace.mdx diff --git a/docs/plugin-minify-simplify.md b/docs/plugin-minify-simplify.mdx similarity index 100% rename from docs/plugin-minify-simplify.md rename to docs/plugin-minify-simplify.mdx diff --git a/docs/plugin-minify-type-constructors.md b/docs/plugin-minify-type-constructors.mdx similarity index 97% rename from docs/plugin-minify-type-constructors.md rename to docs/plugin-minify-type-constructors.mdx index df35393856..63927a5802 100644 --- a/docs/plugin-minify-type-constructors.md +++ b/docs/plugin-minify-type-constructors.mdx @@ -67,5 +67,5 @@ require("@babel/core").transformSync("code", { + `string` โ€” prevent plugin from minifying strings :::tip -You can read more about configuring plugin options [here](./plugins.md#plugin-options) +You can read more about configuring plugin options [here](./plugins.mdx#plugin-options) ::: diff --git a/docs/plugin-proposal-async-do-expressions.md b/docs/plugin-proposal-async-do-expressions.mdx similarity index 97% rename from docs/plugin-proposal-async-do-expressions.md rename to docs/plugin-proposal-async-do-expressions.mdx index 97cb930e1c..fd59bc354f 100644 --- a/docs/plugin-proposal-async-do-expressions.md +++ b/docs/plugin-proposal-async-do-expressions.mdx @@ -60,7 +60,7 @@ npm install --save-dev @babel/plugin-proposal-async-do-expressions } ``` -Note: This plugin transpiles `async do {}` to ES2017 Async arrow function `async () => {}`. If you target to an older engine, i.e. Node.js 6 or IE 11, please also add [`@babel/plugin-transform-async-to-generator`](plugin-transform-async-to-generator.md): +Note: This plugin transpiles `async do {}` to ES2017 Async arrow function `async () => {}`. If you target to an older engine, i.e. Node.js 6 or IE 11, please also add [`@babel/plugin-transform-async-to-generator`](plugin-transform-async-to-generator.mdx): ```json title="babel.config.json" { diff --git a/docs/plugin-proposal-decorators.md b/docs/plugin-proposal-decorators.mdx similarity index 99% rename from docs/plugin-proposal-decorators.md rename to docs/plugin-proposal-decorators.mdx index e2bbba95d8..ca48ffdbd0 100644 --- a/docs/plugin-proposal-decorators.md +++ b/docs/plugin-proposal-decorators.mdx @@ -30,7 +30,7 @@ function isTestable(value) { } ``` -### Class method decorator {#class-function-decorator} +### Class method decorator {/* #class-function-decorator */} ```js title="JavaScript" class C { @@ -212,7 +212,7 @@ If you are using `@babel/preset-env` and legacy decorators, you must ensure the The `include` option will enable the transforms included in `@babel/preset-env` so you can safely remove them from your `package.json`. :::tip -You can read more about configuring plugin options [here](./plugins.md#plugin-options) +You can read more about configuring plugin options [here](./plugins.mdx#plugin-options) ::: :::: diff --git a/docs/plugin-proposal-destructuring-private.md b/docs/plugin-proposal-destructuring-private.mdx similarity index 86% rename from docs/plugin-proposal-destructuring-private.md rename to docs/plugin-proposal-destructuring-private.mdx index 4ead7fecd1..74ce61fa81 100644 --- a/docs/plugin-proposal-destructuring-private.md +++ b/docs/plugin-proposal-destructuring-private.mdx @@ -31,8 +31,8 @@ class Foo { ``` The plugin respects these compiler assumptions: -- [`ignoreFunctionLength`](assumptions.md#ignorefunctionlength) -- [`objectRestNoSymbols`](assumptions.md#objectrestnosymbols) +- [`ignoreFunctionLength`](assumptions.mdx#ignorefunctionlength) +- [`objectRestNoSymbols`](assumptions.mdx#objectrestnosymbols) ## Installation @@ -50,7 +50,7 @@ npm install --save-dev @babel/plugin-proposal-destructuring-private } ``` -Because the output code includes private fields, if you are already using other class feature plugins (e.g. [`@babel/plugin-transform-class-properties](plugin-transform-class-properties.md)), be sure to place it _before_ the others. +Because the output code includes private fields, if you are already using other class feature plugins (e.g. [`@babel/plugin-transform-class-properties](plugin-transform-class-properties.mdx)), be sure to place it _before_ the others. ```json title="babel.config.json" { diff --git a/docs/plugin-proposal-discard-binding.md b/docs/plugin-proposal-discard-binding.mdx similarity index 94% rename from docs/plugin-proposal-discard-binding.md rename to docs/plugin-proposal-discard-binding.mdx index a1fbb3a53b..7126a87114 100644 --- a/docs/plugin-proposal-discard-binding.md +++ b/docs/plugin-proposal-discard-binding.mdx @@ -22,7 +22,7 @@ using _ = getResource(); The plugin respects these compiler assumptions: -- [`ignoreFunctionLength`](assumptions.md#ignorefunctionlength) +- [`ignoreFunctionLength`](assumptions.mdx#ignorefunctionlength) ## Installation diff --git a/docs/plugin-proposal-do-expressions.md b/docs/plugin-proposal-do-expressions.mdx similarity index 100% rename from docs/plugin-proposal-do-expressions.md rename to docs/plugin-proposal-do-expressions.mdx diff --git a/docs/plugin-proposal-export-default-from.md b/docs/plugin-proposal-export-default-from.mdx similarity index 100% rename from docs/plugin-proposal-export-default-from.md rename to docs/plugin-proposal-export-default-from.mdx diff --git a/docs/plugin-proposal-function-bind.md b/docs/plugin-proposal-function-bind.mdx similarity index 100% rename from docs/plugin-proposal-function-bind.md rename to docs/plugin-proposal-function-bind.mdx diff --git a/docs/plugin-proposal-function-sent.md b/docs/plugin-proposal-function-sent.mdx similarity index 100% rename from docs/plugin-proposal-function-sent.md rename to docs/plugin-proposal-function-sent.mdx diff --git a/docs/plugin-proposal-import-attributes-to-assertions.md b/docs/plugin-proposal-import-attributes-to-assertions.mdx similarity index 100% rename from docs/plugin-proposal-import-attributes-to-assertions.md rename to docs/plugin-proposal-import-attributes-to-assertions.mdx diff --git a/docs/plugin-proposal-import-defer.md b/docs/plugin-proposal-import-defer.mdx similarity index 100% rename from docs/plugin-proposal-import-defer.md rename to docs/plugin-proposal-import-defer.mdx diff --git a/docs/plugin-proposal-import-wasm-source.md b/docs/plugin-proposal-import-wasm-source.mdx similarity index 88% rename from docs/plugin-proposal-import-wasm-source.md rename to docs/plugin-proposal-import-wasm-source.mdx index d917e8818a..5522f8c54f 100644 --- a/docs/plugin-proposal-import-wasm-source.md +++ b/docs/plugin-proposal-import-wasm-source.mdx @@ -9,7 +9,7 @@ import TabItem from '@theme/TabItem'; Transforms `import source` declarations to `WebAssembly.Module` objects, assuming that `import source` is being used to import the source of a WebAssembly Module. -The transformation applied by this plugin depends on your top-level [`targets`](./options.md#targets) to detect whether the generated code should be compatible with Node.js, browsers, or both. When targeting Node.js, the generated code will also change depending on whether you are compiling modules to CommonJS or not. +The transformation applied by this plugin depends on your top-level [`targets`](./options.mdx#targets) to detect whether the generated code should be compatible with Node.js, browsers, or both. When targeting Node.js, the generated code will also change depending on whether you are compiling modules to CommonJS or not. :::caution This plugin cannot be used when compiling modules to AMD, SystemJS, or UMD. diff --git a/docs/plugin-proposal-optional-chaining-assign.md b/docs/plugin-proposal-optional-chaining-assign.mdx similarity index 98% rename from docs/plugin-proposal-optional-chaining-assign.md rename to docs/plugin-proposal-optional-chaining-assign.mdx index 452e9a8ac2..dc64a2b5c7 100644 --- a/docs/plugin-proposal-optional-chaining-assign.md +++ b/docs/plugin-proposal-optional-chaining-assign.mdx @@ -58,7 +58,7 @@ require("@babel/core").transformSync("code", { ### Assumptions -This plugin is affected by the [`noDocumentAll`](./assumptions.md#nodocumentall) assumption. +This plugin is affected by the [`noDocumentAll`](./assumptions.mdx#nodocumentall) assumption. ### `version` diff --git a/docs/plugin-proposal-partial-application.md b/docs/plugin-proposal-partial-application.mdx similarity index 100% rename from docs/plugin-proposal-partial-application.md rename to docs/plugin-proposal-partial-application.mdx diff --git a/docs/plugin-proposal-pipeline-operator.md b/docs/plugin-proposal-pipeline-operator.mdx similarity index 97% rename from docs/plugin-proposal-pipeline-operator.md rename to docs/plugin-proposal-pipeline-operator.mdx index 707df3e552..0979cfbd06 100644 --- a/docs/plugin-proposal-pipeline-operator.md +++ b/docs/plugin-proposal-pipeline-operator.mdx @@ -112,7 +112,7 @@ With `@@` topic token: ### Via CLI -Because this plugin requires a configuration option, it [cannot be directly configured from the CLI](https://github.com/babel/babel/issues/4161). Use a [config file](config-files.md) instead with the CLI, to add and configure this plugin. +Because this plugin requires a configuration option, it [cannot be directly configured from the CLI](https://github.com/babel/babel/issues/4161). Use a [config file](config-files.mdx) instead with the CLI, to add and configure this plugin. ### Via Node API diff --git a/docs/plugin-proposal-record-and-tuple.md b/docs/plugin-proposal-record-and-tuple.mdx similarity index 100% rename from docs/plugin-proposal-record-and-tuple.md rename to docs/plugin-proposal-record-and-tuple.mdx diff --git a/docs/plugin-proposal-throw-expressions.md b/docs/plugin-proposal-throw-expressions.mdx similarity index 100% rename from docs/plugin-proposal-throw-expressions.md rename to docs/plugin-proposal-throw-expressions.mdx diff --git a/docs/plugin-syntax-async-do-expressions.md b/docs/plugin-syntax-async-do-expressions.mdx similarity index 88% rename from docs/plugin-syntax-async-do-expressions.md rename to docs/plugin-syntax-async-do-expressions.mdx index d114766385..42d3e43aee 100644 --- a/docs/plugin-syntax-async-do-expressions.md +++ b/docs/plugin-syntax-async-do-expressions.mdx @@ -7,7 +7,7 @@ sidebar_label: syntax-async-do-expressions :::note #### Syntax only -It's unlikely you want to use this plugin directly as it only enables Babel to parse this syntax. Instead, use [plugin-proposal-async-do-expressions](plugin-proposal-async-do-expressions.md) to _both_ parse and transform this syntax. +It's unlikely you want to use this plugin directly as it only enables Babel to parse this syntax. Instead, use [plugin-proposal-async-do-expressions](plugin-proposal-async-do-expressions.mdx) to _both_ parse and transform this syntax. ::: ## Installation diff --git a/docs/plugin-syntax-async-generators.md b/docs/plugin-syntax-async-generators.mdx similarity index 91% rename from docs/plugin-syntax-async-generators.md rename to docs/plugin-syntax-async-generators.mdx index 93fcd28696..9827a5f4b4 100644 --- a/docs/plugin-syntax-async-generators.md +++ b/docs/plugin-syntax-async-generators.mdx @@ -7,7 +7,7 @@ sidebar_label: syntax-async-generators :::note #### Syntax only -It's unlikely you want to use this plugin directly as it only enables Babel to parse this syntax. Instead, use [plugin-proposal-async-generators](plugin-transform-async-generator-functions.md) to _both_ parse and transform this syntax. +It's unlikely you want to use this plugin directly as it only enables Babel to parse this syntax. Instead, use [plugin-proposal-async-generators](plugin-transform-async-generator-functions.mdx) to _both_ parse and transform this syntax. ::: ## Example diff --git a/docs/plugin-syntax-bigint.md b/docs/plugin-syntax-bigint.mdx similarity index 100% rename from docs/plugin-syntax-bigint.md rename to docs/plugin-syntax-bigint.mdx diff --git a/docs/plugin-syntax-class-properties.md b/docs/plugin-syntax-class-properties.mdx similarity index 88% rename from docs/plugin-syntax-class-properties.md rename to docs/plugin-syntax-class-properties.mdx index 324517547b..45d146c67a 100644 --- a/docs/plugin-syntax-class-properties.md +++ b/docs/plugin-syntax-class-properties.mdx @@ -7,7 +7,7 @@ sidebar_label: syntax-class-properties :::note #### Syntax only -It's unlikely you want to use this plugin directly as it only enables Babel to parse this syntax. Instead, use [plugin-transform-class-properties](plugin-transform-class-properties.md) to _both_ parse and transform this syntax. +It's unlikely you want to use this plugin directly as it only enables Babel to parse this syntax. Instead, use [plugin-transform-class-properties](plugin-transform-class-properties.mdx) to _both_ parse and transform this syntax. ::: ## Installation diff --git a/docs/plugin-syntax-class-static-block.md b/docs/plugin-syntax-class-static-block.mdx similarity index 88% rename from docs/plugin-syntax-class-static-block.md rename to docs/plugin-syntax-class-static-block.mdx index b8ddc4c0af..4f0d2dd2a4 100644 --- a/docs/plugin-syntax-class-static-block.md +++ b/docs/plugin-syntax-class-static-block.mdx @@ -7,7 +7,7 @@ sidebar_label: syntax-class-static-block :::note #### Syntax only -It's unlikely you want to use this plugin directly as it only enables Babel to parse this syntax. Instead, use [plugin-transform-class-static-block](plugin-transform-class-static-block.md) to _both_ parse and transform this syntax. +It's unlikely you want to use this plugin directly as it only enables Babel to parse this syntax. Instead, use [plugin-transform-class-static-block](plugin-transform-class-static-block.mdx) to _both_ parse and transform this syntax. ::: ## Installation diff --git a/docs/plugin-syntax-decorators.md b/docs/plugin-syntax-decorators.mdx similarity index 85% rename from docs/plugin-syntax-decorators.md rename to docs/plugin-syntax-decorators.mdx index 90f8d56a24..cec65826c0 100644 --- a/docs/plugin-syntax-decorators.md +++ b/docs/plugin-syntax-decorators.mdx @@ -7,7 +7,7 @@ sidebar_label: syntax-decorators :::note #### Syntax only -It's unlikely you want to use this plugin directly as it only enables Babel to parse this syntax. Instead, use [plugin-proposal-decorators](plugin-proposal-decorators.md) to _both_ parse and transform this syntax. +It's unlikely you want to use this plugin directly as it only enables Babel to parse this syntax. Instead, use [plugin-proposal-decorators](plugin-proposal-decorators.mdx) to _both_ parse and transform this syntax. ::: ## Installation @@ -42,8 +42,8 @@ require("@babel/core").transformSync("code", { ## Options -This plugin accepts the same options as [`@babel/plugin-proposal-decorators`](plugin-proposal-decorators.md). +This plugin accepts the same options as [`@babel/plugin-proposal-decorators`](plugin-proposal-decorators.mdx). :::tip -You can read more about configuring plugin options [here](./plugins.md#plugin-options) +You can read more about configuring plugin options [here](./plugins.mdx#plugin-options) ::: diff --git a/docs/plugin-syntax-destructuring-private.md b/docs/plugin-syntax-destructuring-private.mdx similarity index 89% rename from docs/plugin-syntax-destructuring-private.md rename to docs/plugin-syntax-destructuring-private.mdx index 7893bb75f1..1e18d11ddd 100644 --- a/docs/plugin-syntax-destructuring-private.md +++ b/docs/plugin-syntax-destructuring-private.mdx @@ -9,7 +9,7 @@ sidebar_label: syntax-destructuring-private :::note #### Syntax only -It's unlikely you want to use this plugin directly as it only enables Babel to parse this syntax. Instead, use [plugin-proposal-destructuring-private](plugin-proposal-destructuring-private.md) to _both_ parse and transform this syntax. +It's unlikely you want to use this plugin directly as it only enables Babel to parse this syntax. Instead, use [plugin-proposal-destructuring-private](plugin-proposal-destructuring-private.mdx) to _both_ parse and transform this syntax. ::: ## Installation diff --git a/docs/plugin-syntax-do-expressions.md b/docs/plugin-syntax-do-expressions.mdx similarity index 89% rename from docs/plugin-syntax-do-expressions.md rename to docs/plugin-syntax-do-expressions.mdx index 054d85e33b..da286b516e 100644 --- a/docs/plugin-syntax-do-expressions.md +++ b/docs/plugin-syntax-do-expressions.mdx @@ -7,7 +7,7 @@ sidebar_label: syntax-do-expressions :::note #### Syntax only -It's unlikely you want to use this plugin directly as it only enables Babel to parse this syntax. Instead, use [plugin-proposal-do-expressions](plugin-proposal-do-expressions.md) to _both_ parse and transform this syntax. +It's unlikely you want to use this plugin directly as it only enables Babel to parse this syntax. Instead, use [plugin-proposal-do-expressions](plugin-proposal-do-expressions.mdx) to _both_ parse and transform this syntax. ::: ## Installation diff --git a/docs/plugin-syntax-dynamic-import.md b/docs/plugin-syntax-dynamic-import.mdx similarity index 100% rename from docs/plugin-syntax-dynamic-import.md rename to docs/plugin-syntax-dynamic-import.mdx diff --git a/docs/plugin-syntax-explicit-resource-management.md b/docs/plugin-syntax-explicit-resource-management.mdx similarity index 95% rename from docs/plugin-syntax-explicit-resource-management.md rename to docs/plugin-syntax-explicit-resource-management.mdx index 5c00f6f511..829ccf0882 100644 --- a/docs/plugin-syntax-explicit-resource-management.md +++ b/docs/plugin-syntax-explicit-resource-management.mdx @@ -7,7 +7,7 @@ sidebar_label: syntax-explicit-resource-management :::note #### Syntax only -It's unlikely you want to use this plugin directly as it only enables Babel to parse this syntax. Instead, use [plugin-transform-explicit-resource-management](plugin-transform-explicit-resource-management.md) to _both_ parse and transform this syntax. +It's unlikely you want to use this plugin directly as it only enables Babel to parse this syntax. Instead, use [plugin-transform-explicit-resource-management](plugin-transform-explicit-resource-management.mdx) to _both_ parse and transform this syntax. :::
diff --git a/docs/plugin-syntax-export-default-from.md b/docs/plugin-syntax-export-default-from.mdx similarity index 88% rename from docs/plugin-syntax-export-default-from.md rename to docs/plugin-syntax-export-default-from.mdx index cdc5bb747b..526e9964f2 100644 --- a/docs/plugin-syntax-export-default-from.md +++ b/docs/plugin-syntax-export-default-from.mdx @@ -7,7 +7,7 @@ sidebar_label: syntax-export-default-from :::note #### Syntax only -It's unlikely you want to use this plugin directly as it only enables Babel to parse this syntax. Instead, use [plugin-proposal-export-default-from](plugin-proposal-export-default-from.md) to _both_ parse and transform this syntax. +It's unlikely you want to use this plugin directly as it only enables Babel to parse this syntax. Instead, use [plugin-proposal-export-default-from](plugin-proposal-export-default-from.mdx) to _both_ parse and transform this syntax. ::: ## Installation diff --git a/docs/plugin-syntax-export-namespace-from.md b/docs/plugin-syntax-export-namespace-from.mdx similarity index 95% rename from docs/plugin-syntax-export-namespace-from.md rename to docs/plugin-syntax-export-namespace-from.mdx index 8adf0e2c51..45f72ea6c2 100644 --- a/docs/plugin-syntax-export-namespace-from.md +++ b/docs/plugin-syntax-export-namespace-from.mdx @@ -7,7 +7,7 @@ sidebar_label: syntax-export-namespace-from :::note #### Syntax only -It's unlikely you want to use this plugin directly as it only enables Babel to parse this syntax. Instead, use [plugin-transform-export-namespace-from](plugin-transform-export-namespace-from.md) to _both_ parse and transform this syntax. +It's unlikely you want to use this plugin directly as it only enables Babel to parse this syntax. Instead, use [plugin-transform-export-namespace-from](plugin-transform-export-namespace-from.mdx) to _both_ parse and transform this syntax. ::: ## Installation diff --git a/docs/plugin-syntax-flow.md b/docs/plugin-syntax-flow.mdx similarity index 84% rename from docs/plugin-syntax-flow.md rename to docs/plugin-syntax-flow.mdx index 933a679798..4f10cc2803 100644 --- a/docs/plugin-syntax-flow.md +++ b/docs/plugin-syntax-flow.mdx @@ -7,7 +7,7 @@ sidebar_label: syntax-flow :::note #### Syntax only -Using this plugin directly only enables Babel to parse this syntax. If you want to remove Flow syntax then use the [flow-strip-types](plugin-transform-flow-strip-types.md) plugin or [flow](preset-flow.md) preset to _both_ parse and transform this syntax. +Using this plugin directly only enables Babel to parse this syntax. If you want to remove Flow syntax then use the [flow-strip-types](plugin-transform-flow-strip-types.mdx) plugin or [flow](preset-flow.mdx) preset to _both_ parse and transform this syntax. ::: ## Installation diff --git a/docs/plugin-syntax-function-bind.md b/docs/plugin-syntax-function-bind.mdx similarity index 89% rename from docs/plugin-syntax-function-bind.md rename to docs/plugin-syntax-function-bind.mdx index 09298b7745..c04fa90215 100644 --- a/docs/plugin-syntax-function-bind.md +++ b/docs/plugin-syntax-function-bind.mdx @@ -7,7 +7,7 @@ sidebar_label: syntax-function-bind :::note #### Syntax only -It's unlikely you want to use this plugin directly as it only enables Babel to parse this syntax. Instead, use [plugin-proposal-function-bind](plugin-proposal-function-bind.md) to _both_ parse and transform this syntax. +It's unlikely you want to use this plugin directly as it only enables Babel to parse this syntax. Instead, use [plugin-proposal-function-bind](plugin-proposal-function-bind.mdx) to _both_ parse and transform this syntax. ::: ## Installation diff --git a/docs/plugin-syntax-function-sent.md b/docs/plugin-syntax-function-sent.mdx similarity index 89% rename from docs/plugin-syntax-function-sent.md rename to docs/plugin-syntax-function-sent.mdx index 0a6550cce5..7011d4c691 100644 --- a/docs/plugin-syntax-function-sent.md +++ b/docs/plugin-syntax-function-sent.mdx @@ -7,7 +7,7 @@ sidebar_label: syntax-function-sent :::note #### Syntax only -It's unlikely you want to use this plugin directly as it only enables Babel to parse this syntax. Instead, use [plugin-proposal-function-sent](plugin-proposal-function-sent.md) to _both_ parse and transform this syntax. +It's unlikely you want to use this plugin directly as it only enables Babel to parse this syntax. Instead, use [plugin-proposal-function-sent](plugin-proposal-function-sent.mdx) to _both_ parse and transform this syntax. ::: ## Installation diff --git a/docs/plugin-syntax-import-attributes.md b/docs/plugin-syntax-import-attributes.mdx similarity index 98% rename from docs/plugin-syntax-import-attributes.md rename to docs/plugin-syntax-import-attributes.mdx index 5068f5b5b4..4936d007fe 100644 --- a/docs/plugin-syntax-import-attributes.md +++ b/docs/plugin-syntax-import-attributes.mdx @@ -15,7 +15,7 @@ This plugin only enables Babel to parse and generate this syntax. Babel does not ::::babel7 -While Babel supports parsing import attributes by default since v7.25.0, this plugin is still needed to let Babel choose the correct syntax when emitting code. As an alternative to this plugin, you can use `@babel/generator`'s [`importAttributesKeyword`](./generator.md#options) option: +While Babel supports parsing import attributes by default since v7.25.0, this plugin is still needed to let Babel choose the correct syntax when emitting code. As an alternative to this plugin, you can use `@babel/generator`'s [`importAttributesKeyword`](./generator.mdx#options) option: ```json { "generatorOpts": { diff --git a/docs/plugin-syntax-import-defer.md b/docs/plugin-syntax-import-defer.mdx similarity index 90% rename from docs/plugin-syntax-import-defer.md rename to docs/plugin-syntax-import-defer.mdx index a21aca8ee7..53b6a02db1 100644 --- a/docs/plugin-syntax-import-defer.md +++ b/docs/plugin-syntax-import-defer.mdx @@ -7,7 +7,7 @@ sidebar_label: syntax-import-defer :::note #### Syntax only -It's unlikely you want to use this plugin directly as it only enables Babel to parse this syntax. Instead, use [plugin-proposal-import-defer](plugin-proposal-import-defer.md) to _both_ parse and transform this syntax. +It's unlikely you want to use this plugin directly as it only enables Babel to parse this syntax. Instead, use [plugin-proposal-import-defer](plugin-proposal-import-defer.mdx) to _both_ parse and transform this syntax. ::: This plugin enables parsing for `import defer` declarations. diff --git a/docs/plugin-syntax-import-meta.md b/docs/plugin-syntax-import-meta.mdx similarity index 100% rename from docs/plugin-syntax-import-meta.md rename to docs/plugin-syntax-import-meta.mdx diff --git a/docs/plugin-syntax-import-reflection.md b/docs/plugin-syntax-import-reflection.mdx similarity index 100% rename from docs/plugin-syntax-import-reflection.md rename to docs/plugin-syntax-import-reflection.mdx diff --git a/docs/plugin-syntax-import-source.md b/docs/plugin-syntax-import-source.mdx similarity index 89% rename from docs/plugin-syntax-import-source.md rename to docs/plugin-syntax-import-source.mdx index db6d362664..88bc254d84 100644 --- a/docs/plugin-syntax-import-source.md +++ b/docs/plugin-syntax-import-source.mdx @@ -7,7 +7,7 @@ sidebar_label: syntax-import-source :::note #### Syntax only -It's unlikely you want to use this plugin directly as it only enables Babel to parse this syntax. Instead, use [plugin-proposal-import-wasm-source](plugin-proposal-import-wasm-source.md) to _both_ parse and transform this syntax. +It's unlikely you want to use this plugin directly as it only enables Babel to parse this syntax. Instead, use [plugin-proposal-import-wasm-source](plugin-proposal-import-wasm-source.mdx) to _both_ parse and transform this syntax. ::: This plugin enables parsing for `import source` declarations. diff --git a/docs/plugin-syntax-json-strings.md b/docs/plugin-syntax-json-strings.mdx similarity index 89% rename from docs/plugin-syntax-json-strings.md rename to docs/plugin-syntax-json-strings.mdx index 623204902d..ff8c3b8024 100644 --- a/docs/plugin-syntax-json-strings.md +++ b/docs/plugin-syntax-json-strings.mdx @@ -7,7 +7,7 @@ sidebar_label: syntax-json-strings :::note #### Syntax only -It's unlikely you want to use this plugin directly as it only enables Babel to parse this syntax. Instead, use [plugin-transform-json-strings](plugin-transform-json-strings.md) to _both_ parse and transform this syntax. +It's unlikely you want to use this plugin directly as it only enables Babel to parse this syntax. Instead, use [plugin-transform-json-strings](plugin-transform-json-strings.mdx) to _both_ parse and transform this syntax. ::: ## Installation diff --git a/docs/plugin-syntax-jsx.md b/docs/plugin-syntax-jsx.mdx similarity index 84% rename from docs/plugin-syntax-jsx.md rename to docs/plugin-syntax-jsx.mdx index 0ab71685c3..17470602c0 100644 --- a/docs/plugin-syntax-jsx.md +++ b/docs/plugin-syntax-jsx.mdx @@ -7,7 +7,7 @@ sidebar_label: syntax-jsx :::note #### Syntax only -Using this plugin directly only enables Babel to parse this syntax. If you want to transform JSX syntax then use the [transform-react-jsx](plugin-transform-react-jsx.md) plugin or [react](preset-react.md) preset to _both_ parse and transform this syntax. +Using this plugin directly only enables Babel to parse this syntax. If you want to transform JSX syntax then use the [transform-react-jsx](plugin-transform-react-jsx.mdx) plugin or [react](preset-react.mdx) preset to _both_ parse and transform this syntax. ::: ## Installation diff --git a/docs/plugin-syntax-logical-assignment-operators.md b/docs/plugin-syntax-logical-assignment-operators.mdx similarity index 93% rename from docs/plugin-syntax-logical-assignment-operators.md rename to docs/plugin-syntax-logical-assignment-operators.mdx index a4bb332e55..73f5f52863 100644 --- a/docs/plugin-syntax-logical-assignment-operators.md +++ b/docs/plugin-syntax-logical-assignment-operators.mdx @@ -7,7 +7,7 @@ sidebar_label: syntax-logical-assignment-operators :::note #### Syntax only -It's unlikely you want to use this plugin directly as it only enables Babel to parse this syntax. Instead, use [plugin-transform-logical-assignment-operators](plugin-transform-logical-assignment-operators.md) to _both_ parse and transform this syntax. +It's unlikely you want to use this plugin directly as it only enables Babel to parse this syntax. Instead, use [plugin-transform-logical-assignment-operators](plugin-transform-logical-assignment-operators.mdx) to _both_ parse and transform this syntax. ::: ## Installation diff --git a/docs/plugin-syntax-module-blocks.md b/docs/plugin-syntax-module-blocks.mdx similarity index 100% rename from docs/plugin-syntax-module-blocks.md rename to docs/plugin-syntax-module-blocks.mdx diff --git a/docs/plugin-syntax-module-string-names.md b/docs/plugin-syntax-module-string-names.mdx similarity index 100% rename from docs/plugin-syntax-module-string-names.md rename to docs/plugin-syntax-module-string-names.mdx diff --git a/docs/plugin-syntax-nullish-coalescing-operator.md b/docs/plugin-syntax-nullish-coalescing-operator.mdx similarity index 94% rename from docs/plugin-syntax-nullish-coalescing-operator.md rename to docs/plugin-syntax-nullish-coalescing-operator.mdx index 5d738a59ff..fabdc80dbc 100644 --- a/docs/plugin-syntax-nullish-coalescing-operator.md +++ b/docs/plugin-syntax-nullish-coalescing-operator.mdx @@ -7,7 +7,7 @@ sidebar_label: syntax-nullish-coalescing-operator :::note #### Syntax only -It's unlikely you want to use this plugin directly as it only enables Babel to parse this syntax. Instead, use [plugin-transform-nullish-coalescing-operator](plugin-transform-nullish-coalescing-operator.md) to _both_ parse and transform this syntax. +It's unlikely you want to use this plugin directly as it only enables Babel to parse this syntax. Instead, use [plugin-transform-nullish-coalescing-operator](plugin-transform-nullish-coalescing-operator.mdx) to _both_ parse and transform this syntax. ::: ## Installation diff --git a/docs/plugin-syntax-numeric-separator.md b/docs/plugin-syntax-numeric-separator.mdx similarity index 88% rename from docs/plugin-syntax-numeric-separator.md rename to docs/plugin-syntax-numeric-separator.mdx index b62ba6d537..4203069133 100644 --- a/docs/plugin-syntax-numeric-separator.md +++ b/docs/plugin-syntax-numeric-separator.mdx @@ -7,7 +7,7 @@ sidebar_label: syntax-numeric-separator :::note #### Syntax only -It's unlikely you want to use this plugin directly as it only enables Babel to parse this syntax. Instead, use [plugin-transform-numeric-separator](plugin-transform-numeric-separator.md) to _both_ parse and transform this syntax. +It's unlikely you want to use this plugin directly as it only enables Babel to parse this syntax. Instead, use [plugin-transform-numeric-separator](plugin-transform-numeric-separator.mdx) to _both_ parse and transform this syntax. ::: ## Installation diff --git a/docs/plugin-syntax-object-rest-spread.md b/docs/plugin-syntax-object-rest-spread.mdx similarity index 88% rename from docs/plugin-syntax-object-rest-spread.md rename to docs/plugin-syntax-object-rest-spread.mdx index 43f3ead790..2e74febcfc 100644 --- a/docs/plugin-syntax-object-rest-spread.md +++ b/docs/plugin-syntax-object-rest-spread.mdx @@ -7,7 +7,7 @@ sidebar_label: syntax-object-rest-spread :::note #### Syntax only -It's unlikely you want to use this plugin directly as it only enables Babel to parse this syntax. Instead, use [plugin-transform-object-rest-spread](plugin-transform-object-rest-spread.md) to _both_ parse and transform this syntax. +It's unlikely you want to use this plugin directly as it only enables Babel to parse this syntax. Instead, use [plugin-transform-object-rest-spread](plugin-transform-object-rest-spread.mdx) to _both_ parse and transform this syntax. ::: ## Installation diff --git a/docs/plugin-syntax-optional-catch-binding.md b/docs/plugin-syntax-optional-catch-binding.mdx similarity index 96% rename from docs/plugin-syntax-optional-catch-binding.md rename to docs/plugin-syntax-optional-catch-binding.mdx index b3ae8a168f..1dd9a8b9d9 100644 --- a/docs/plugin-syntax-optional-catch-binding.md +++ b/docs/plugin-syntax-optional-catch-binding.mdx @@ -7,7 +7,7 @@ sidebar_label: syntax-optional-catch-binding :::note #### Syntax only -It's unlikely you want to use this plugin directly as it only enables Babel to parse this syntax. Instead, use [plugin-transform-optional-catch-binding](plugin-transform-optional-catch-binding.md) to _both_ parse and transform this syntax. +It's unlikely you want to use this plugin directly as it only enables Babel to parse this syntax. Instead, use [plugin-transform-optional-catch-binding](plugin-transform-optional-catch-binding.mdx) to _both_ parse and transform this syntax. ::: ## Example diff --git a/docs/plugin-syntax-optional-chaining-assign.md b/docs/plugin-syntax-optional-chaining-assign.mdx similarity index 95% rename from docs/plugin-syntax-optional-chaining-assign.md rename to docs/plugin-syntax-optional-chaining-assign.mdx index 2eda49826d..fea8617f6b 100644 --- a/docs/plugin-syntax-optional-chaining-assign.md +++ b/docs/plugin-syntax-optional-chaining-assign.mdx @@ -7,7 +7,7 @@ sidebar_label: syntax-optional-chaining-assign :::note #### Syntax only -It's unlikely you want to use this plugin directly as it only enables Babel to parse this syntax. Instead, use [plugin-proposal-optional-chaining-assign](plugin-proposal-optional-chaining-assign.md) to _both_ parse and transform this syntax. +It's unlikely you want to use this plugin directly as it only enables Babel to parse this syntax. Instead, use [plugin-proposal-optional-chaining-assign](plugin-proposal-optional-chaining-assign.mdx) to _both_ parse and transform this syntax. ::: This plugin enables parsing for `obj?.prop = val;` assignments. diff --git a/docs/plugin-syntax-optional-chaining.md b/docs/plugin-syntax-optional-chaining.mdx similarity index 88% rename from docs/plugin-syntax-optional-chaining.md rename to docs/plugin-syntax-optional-chaining.mdx index d9931af734..a4b86cd196 100644 --- a/docs/plugin-syntax-optional-chaining.md +++ b/docs/plugin-syntax-optional-chaining.mdx @@ -7,7 +7,7 @@ sidebar_label: syntax-optional-chaining :::note #### Syntax only -It's unlikely you want to use this plugin directly as it only enables Babel to parse this syntax. Instead, use [plugin-transform-optional-chaining](plugin-transform-optional-chaining.md) to _both_ parse and transform this syntax. +It's unlikely you want to use this plugin directly as it only enables Babel to parse this syntax. Instead, use [plugin-transform-optional-chaining](plugin-transform-optional-chaining.mdx) to _both_ parse and transform this syntax. ::: ## Installation diff --git a/docs/plugin-syntax-partial-application.md b/docs/plugin-syntax-partial-application.mdx similarity index 91% rename from docs/plugin-syntax-partial-application.md rename to docs/plugin-syntax-partial-application.mdx index 2bd57fd5c6..eba0da855b 100644 --- a/docs/plugin-syntax-partial-application.md +++ b/docs/plugin-syntax-partial-application.mdx @@ -7,7 +7,7 @@ sidebar_label: syntax-partial-application :::note #### Syntax only -It's unlikely you want to use this plugin directly as it only enables Babel to parse this syntax. Instead, use [plugin-proposal-partial-application](plugin-proposal-partial-application.md) to _both_ parse and transform this syntax. +It's unlikely you want to use this plugin directly as it only enables Babel to parse this syntax. Instead, use [plugin-proposal-partial-application](plugin-proposal-partial-application.mdx) to _both_ parse and transform this syntax. ::: ## Installation diff --git a/docs/plugin-syntax-pipeline-operator.md b/docs/plugin-syntax-pipeline-operator.mdx similarity index 86% rename from docs/plugin-syntax-pipeline-operator.md rename to docs/plugin-syntax-pipeline-operator.mdx index 7cb037c757..f78247a104 100644 --- a/docs/plugin-syntax-pipeline-operator.md +++ b/docs/plugin-syntax-pipeline-operator.mdx @@ -7,7 +7,7 @@ sidebar_label: syntax-pipeline-operator :::note #### Syntax only -It's unlikely you want to use this plugin directly as it only enables Babel to parse this syntax. Instead, use [plugin-proposal-pipeline-operator](plugin-proposal-pipeline-operator.md) to _both_ parse and transform this syntax. +It's unlikely you want to use this plugin directly as it only enables Babel to parse this syntax. Instead, use [plugin-proposal-pipeline-operator](plugin-proposal-pipeline-operator.mdx) to _both_ parse and transform this syntax. ::: ## Installation @@ -42,7 +42,7 @@ With `@@` topic token: ### Via CLI -Because this plugin requires a configuration option, it [cannot be directly configured from the CLI](https://github.com/babel/babel/issues/4161). Use a [config file](config-files.md) instead with the CLI, to add and configure this plugin. +Because this plugin requires a configuration option, it [cannot be directly configured from the CLI](https://github.com/babel/babel/issues/4161). Use a [config file](config-files.mdx) instead with the CLI, to add and configure this plugin. ### Via Node API diff --git a/docs/plugin-syntax-throw-expressions.md b/docs/plugin-syntax-throw-expressions.mdx similarity index 90% rename from docs/plugin-syntax-throw-expressions.md rename to docs/plugin-syntax-throw-expressions.mdx index 7486da0f6c..5a6cca43e4 100644 --- a/docs/plugin-syntax-throw-expressions.md +++ b/docs/plugin-syntax-throw-expressions.mdx @@ -7,7 +7,7 @@ sidebar_label: syntax-throw-expressions :::note #### Syntax only -It's unlikely you want to use this plugin directly as it only enables Babel to parse this syntax. Instead, use [plugin-proposal-throw-expressions](plugin-proposal-throw-expressions.md) to _both_ parse and transform this syntax. +It's unlikely you want to use this plugin directly as it only enables Babel to parse this syntax. Instead, use [plugin-proposal-throw-expressions](plugin-proposal-throw-expressions.mdx) to _both_ parse and transform this syntax. ::: ```js title="JavaScript" diff --git a/docs/plugin-syntax-top-level-await.md b/docs/plugin-syntax-top-level-await.mdx similarity index 100% rename from docs/plugin-syntax-top-level-await.md rename to docs/plugin-syntax-top-level-await.mdx diff --git a/docs/plugin-syntax-typescript.md b/docs/plugin-syntax-typescript.mdx similarity index 91% rename from docs/plugin-syntax-typescript.md rename to docs/plugin-syntax-typescript.mdx index 77dcef7ae2..59f40c99d3 100644 --- a/docs/plugin-syntax-typescript.md +++ b/docs/plugin-syntax-typescript.mdx @@ -7,7 +7,7 @@ sidebar_label: syntax-typescript :::note #### Syntax only -Using this plugin directly only enables Babel to parse this syntax. If you want to remove TypeScript syntax then use the [typescript](plugin-transform-typescript.md) plugin or [typescript](preset-typescript.md) preset to _both_ parse and transform this syntax. +Using this plugin directly only enables Babel to parse this syntax. If you want to remove TypeScript syntax then use the [typescript](plugin-transform-typescript.mdx) plugin or [typescript](preset-typescript.mdx) preset to _both_ parse and transform this syntax. ::: ```shell npm2yarn @@ -63,5 +63,5 @@ This option will enable parsing within a TypeScript ambient context, where certa Forcibly enables `jsx` parsing. Otherwise angle brackets will be treated as typescript's legacy type assertion `var foo = bar;` :::tip -You can read more about configuring plugin options [here](./plugins.md#plugin-options) +You can read more about configuring plugin options [here](./plugins.mdx#plugin-options) ::: diff --git a/docs/plugin-syntax-unicode-sets-regex.md b/docs/plugin-syntax-unicode-sets-regex.mdx similarity index 91% rename from docs/plugin-syntax-unicode-sets-regex.md rename to docs/plugin-syntax-unicode-sets-regex.mdx index 7e9a41f598..ccb722e76a 100644 --- a/docs/plugin-syntax-unicode-sets-regex.md +++ b/docs/plugin-syntax-unicode-sets-regex.mdx @@ -7,7 +7,7 @@ sidebar_label: syntax-unicode-sets-regex :::note #### Syntax only -It's unlikely you want to use this plugin directly as it only enables Babel to parse this syntax. Instead, use [plugin-transform-unicode-sets-regex](plugin-transform-unicode-sets-regex.md) to _both_ parse and transform this syntax. +It's unlikely you want to use this plugin directly as it only enables Babel to parse this syntax. Instead, use [plugin-transform-unicode-sets-regex](plugin-transform-unicode-sets-regex.mdx) to _both_ parse and transform this syntax. ::: This plugin enables parsing regular expressions using the `v` flag, introduced by the [RegExp set notation + properties of strings](https://github.com/tc39/proposal-regexp-set-notation) proposal, to regular expressions that use the `u` flag. diff --git a/docs/plugin-transform-arrow-functions.md b/docs/plugin-transform-arrow-functions.mdx similarity index 99% rename from docs/plugin-transform-arrow-functions.md rename to docs/plugin-transform-arrow-functions.mdx index 0054754e4e..d4bcbd75e9 100644 --- a/docs/plugin-transform-arrow-functions.md +++ b/docs/plugin-transform-arrow-functions.mdx @@ -155,5 +155,5 @@ This option enables the following: - Add names to arrow functions. :::tip -You can read more about configuring plugin options [here](./plugins.md#plugin-options) +You can read more about configuring plugin options [here](./plugins.mdx#plugin-options) ::: diff --git a/docs/plugin-transform-async-generator-functions.md b/docs/plugin-transform-async-generator-functions.mdx similarity index 100% rename from docs/plugin-transform-async-generator-functions.md rename to docs/plugin-transform-async-generator-functions.mdx diff --git a/docs/plugin-transform-async-to-generator.md b/docs/plugin-transform-async-to-generator.mdx similarity index 100% rename from docs/plugin-transform-async-to-generator.md rename to docs/plugin-transform-async-to-generator.mdx diff --git a/docs/plugin-transform-block-scoped-functions.md b/docs/plugin-transform-block-scoped-functions.mdx similarity index 100% rename from docs/plugin-transform-block-scoped-functions.md rename to docs/plugin-transform-block-scoped-functions.mdx diff --git a/docs/plugin-transform-block-scoping.md b/docs/plugin-transform-block-scoping.mdx similarity index 98% rename from docs/plugin-transform-block-scoping.md rename to docs/plugin-transform-block-scoping.mdx index e772c707d4..538c43f88b 100644 --- a/docs/plugin-transform-block-scoping.md +++ b/docs/plugin-transform-block-scoping.mdx @@ -112,5 +112,5 @@ let i; If you need these errors you can tell Babel to try and find them by setting `"tdz": true` for this plugin. However, the current implementation might not get all edge cases right and its best to just avoid code like this in the first place. :::tip -You can read more about configuring plugin options [here](./plugins.md#plugin-options) +You can read more about configuring plugin options [here](./plugins.mdx#plugin-options) ::: diff --git a/docs/plugin-transform-class-properties.md b/docs/plugin-transform-class-properties.mdx similarity index 98% rename from docs/plugin-transform-class-properties.md rename to docs/plugin-transform-class-properties.mdx index fba842ef7d..d0fae6550c 100644 --- a/docs/plugin-transform-class-properties.md +++ b/docs/plugin-transform-class-properties.mdx @@ -88,7 +88,7 @@ require("@babel/core").transformSync("code", { When `true`, class properties are compiled to use an assignment expression instead of `Object.defineProperty`. :::caution -Consider migrating to the top level [`setPublicClassFields`](assumptions.md#setpublicclassfields) assumption +Consider migrating to the top level [`setPublicClassFields`](assumptions.mdx#setpublicclassfields) assumption ::: ```json title="babel.config.json" @@ -160,7 +160,7 @@ Bork.b = void 0; ``` :::tip -You can read more about configuring plugin options [here](./plugins.md#plugin-options) +You can read more about configuring plugin options [here](./plugins.mdx#plugin-options) ::: ## References diff --git a/docs/plugin-transform-class-static-block.md b/docs/plugin-transform-class-static-block.mdx similarity index 97% rename from docs/plugin-transform-class-static-block.md rename to docs/plugin-transform-class-static-block.mdx index 1ef482b819..7ae298dccc 100644 --- a/docs/plugin-transform-class-static-block.md +++ b/docs/plugin-transform-class-static-block.mdx @@ -42,7 +42,7 @@ class C { } ``` -Because the output code includes private class properties, if you are already using other class feature plugins (e.g. [`@babel/plugin-transform-class-properties`](plugin-transform-class-properties.md)), be sure to place it _before_ the others. +Because the output code includes private class properties, if you are already using other class feature plugins (e.g. [`@babel/plugin-transform-class-properties`](plugin-transform-class-properties.mdx)), be sure to place it _before_ the others. ```json title="babel.config.json" { diff --git a/docs/plugin-transform-classes.md b/docs/plugin-transform-classes.mdx similarity index 96% rename from docs/plugin-transform-classes.md rename to docs/plugin-transform-classes.mdx index 709c5614d3..0844b1ec97 100644 --- a/docs/plugin-transform-classes.md +++ b/docs/plugin-transform-classes.mdx @@ -128,7 +128,7 @@ require("@babel/core").transformSync("code", { `boolean`, defaults to `false`. :::caution -Consider migrating to the top level [`assumptions`](assumptions.md) which offers granular control over various `loose` mode deductions Babel has applied. +Consider migrating to the top level [`assumptions`](assumptions.mdx) which offers granular control over various `loose` mode deductions Babel has applied. ::: ```json title="babel.config.json" @@ -171,5 +171,5 @@ case that is very unlikely to appear in production code however it's something to keep in mind. :::tip -You can read more about configuring plugin options [here](./plugins.md#plugin-options) +You can read more about configuring plugin options [here](./plugins.mdx#plugin-options) ::: diff --git a/docs/plugin-transform-computed-properties.md b/docs/plugin-transform-computed-properties.mdx similarity index 97% rename from docs/plugin-transform-computed-properties.md rename to docs/plugin-transform-computed-properties.mdx index d7e5df2a3d..5d947d8696 100644 --- a/docs/plugin-transform-computed-properties.md +++ b/docs/plugin-transform-computed-properties.mdx @@ -107,7 +107,7 @@ use simple assignments instead of being defined. This is unlikely to be an issue in production code. :::caution -Consider migrating to the top level [`setComputedProperties`](assumptions.md#setcomputedproperties) assumption. +Consider migrating to the top level [`setComputedProperties`](assumptions.mdx#setcomputedproperties) assumption. ::: ```json title="babel.config.json" @@ -162,5 +162,5 @@ _obj); ``` :::tip -You can read more about configuring plugin options [here](./plugins.md#plugin-options) +You can read more about configuring plugin options [here](./plugins.mdx#plugin-options) ::: diff --git a/docs/plugin-transform-destructuring.md b/docs/plugin-transform-destructuring.mdx similarity index 96% rename from docs/plugin-transform-destructuring.md rename to docs/plugin-transform-destructuring.mdx index 59b8910afe..b3085ebf81 100644 --- a/docs/plugin-transform-destructuring.md +++ b/docs/plugin-transform-destructuring.mdx @@ -73,7 +73,7 @@ require("@babel/core").transformSync("code", { Enabling this option will assume that what you want to destructure is an array and won't use `Array.from` on other iterables. :::caution -Consider migrating to the top level [`iterableIsArray`](assumptions.md#iterableisarray) assumption. +Consider migrating to the top level [`iterableIsArray`](assumptions.mdx#iterableisarray) assumption. ::: ```json title="babel.config.json" @@ -116,7 +116,7 @@ var _z = z, ``` :::tip -You can read more about configuring plugin options [here](./plugins.md#plugin-options) +You can read more about configuring plugin options [here](./plugins.mdx#plugin-options) ::: ### `allowArrayLike` @@ -134,7 +134,7 @@ While it is _not_ spec-compliant to destructure array-like objects as if they we Please note that Babel allows destructuring `arguments` in old engines even if this option is disabled, because it's defined as _iterable_ in the ECMAScript specification. :::caution -Consider migrating to the top level [`arrayLikeIsIterable`](assumptions.md#arraylikeisiterable) assumption. +Consider migrating to the top level [`arrayLikeIsIterable`](assumptions.mdx#arraylikeisiterable) assumption. ::: ```json title="babel.config.json" diff --git a/docs/plugin-transform-dotall-regex.md b/docs/plugin-transform-dotall-regex.mdx similarity index 100% rename from docs/plugin-transform-dotall-regex.md rename to docs/plugin-transform-dotall-regex.mdx diff --git a/docs/plugin-transform-duplicate-keys.md b/docs/plugin-transform-duplicate-keys.mdx similarity index 92% rename from docs/plugin-transform-duplicate-keys.md rename to docs/plugin-transform-duplicate-keys.mdx index 53d2da6370..0ac1f7ca26 100644 --- a/docs/plugin-transform-duplicate-keys.md +++ b/docs/plugin-transform-duplicate-keys.mdx @@ -8,7 +8,7 @@ sidebar_label: duplicate-keys This plugin is included in `@babel/preset-env` ::: -This plugin actually converts duplicate keys in objects to be computed properties, which then must be handled by the [@babel/plugin-transform-computed-properties](plugin-transform-computed-properties.md) plugin. The final result won't contain any object literals with duplicate keys. +This plugin actually converts duplicate keys in objects to be computed properties, which then must be handled by the [@babel/plugin-transform-computed-properties](plugin-transform-computed-properties.mdx) plugin. The final result won't contain any object literals with duplicate keys. ## Example diff --git a/docs/plugin-transform-duplicate-named-capturing-groups-regex.md b/docs/plugin-transform-duplicate-named-capturing-groups-regex.mdx similarity index 98% rename from docs/plugin-transform-duplicate-named-capturing-groups-regex.md rename to docs/plugin-transform-duplicate-named-capturing-groups-regex.mdx index 8e05ce6116..dde6200e3c 100644 --- a/docs/plugin-transform-duplicate-named-capturing-groups-regex.md +++ b/docs/plugin-transform-duplicate-named-capturing-groups-regex.mdx @@ -78,7 +78,7 @@ stringRe.exec("'foo'").groups.quote; // undefined ``` :::tip -You can read more about configuring plugin options [here](./plugins.md#plugin-options) +You can read more about configuring plugin options [here](./plugins.mdx#plugin-options) ::: ## References diff --git a/docs/plugin-transform-dynamic-import.md b/docs/plugin-transform-dynamic-import.mdx similarity index 97% rename from docs/plugin-transform-dynamic-import.md rename to docs/plugin-transform-dynamic-import.mdx index 89c0c478b3..a0bb85c2ce 100644 --- a/docs/plugin-transform-dynamic-import.md +++ b/docs/plugin-transform-dynamic-import.mdx @@ -18,9 +18,9 @@ Transforms `import()` expressions to non-ESM module formats. If you are using a bundler, such as Webpack, Rollup or Parcel, you should **not** use this plugin and let your bundler handle `import()` expressions. You should use this plugin if: -- You are authoring a Node.js library in ESM but want to distribute it in CommonJS(CJS): Install this plugin and [`@babel/plugin-transform-modules-commonjs`](./plugin-transform-modules-commonjs.md) -- You use [RequireJS](https://requirejs.org) to load modules in the browser: Install this plugin and [`@babel/plugin-transform-modules-amd`](./plugin-transform-modules-amd.md) -- You use [SystemJS](https://github.com/systemjs/systemjs) to load modules in the browser: Install this plugin and [`@babel/plugin-transform-modules-systemjs`](./plugin-transform-modules-systemjs.md) +- You are authoring a Node.js library in ESM but want to distribute it in CommonJS(CJS): Install this plugin and [`@babel/plugin-transform-modules-commonjs`](./plugin-transform-modules-commonjs.mdx) +- You use [RequireJS](https://requirejs.org) to load modules in the browser: Install this plugin and [`@babel/plugin-transform-modules-amd`](./plugin-transform-modules-amd.mdx) +- You use [SystemJS](https://github.com/systemjs/systemjs) to load modules in the browser: Install this plugin and [`@babel/plugin-transform-modules-systemjs`](./plugin-transform-modules-systemjs.mdx) This plugin must be used with one of the module transform plugins mentioned above. diff --git a/docs/plugin-transform-explicit-resource-management.md b/docs/plugin-transform-explicit-resource-management.mdx similarity index 100% rename from docs/plugin-transform-explicit-resource-management.md rename to docs/plugin-transform-explicit-resource-management.mdx diff --git a/docs/plugin-transform-exponentiation-operator.md b/docs/plugin-transform-exponentiation-operator.mdx similarity index 100% rename from docs/plugin-transform-exponentiation-operator.md rename to docs/plugin-transform-exponentiation-operator.mdx diff --git a/docs/plugin-transform-export-namespace-from.md b/docs/plugin-transform-export-namespace-from.mdx similarity index 100% rename from docs/plugin-transform-export-namespace-from.md rename to docs/plugin-transform-export-namespace-from.mdx diff --git a/docs/plugin-transform-flow-comments.md b/docs/plugin-transform-flow-comments.mdx similarity index 100% rename from docs/plugin-transform-flow-comments.md rename to docs/plugin-transform-flow-comments.mdx diff --git a/docs/plugin-transform-flow-strip-types.md b/docs/plugin-transform-flow-strip-types.mdx similarity index 98% rename from docs/plugin-transform-flow-strip-types.md rename to docs/plugin-transform-flow-strip-types.mdx index 4af08d2dbf..f1bfeb4301 100644 --- a/docs/plugin-transform-flow-strip-types.md +++ b/docs/plugin-transform-flow-strip-types.mdx @@ -103,5 +103,5 @@ class A { ``` :::tip -You can read more about configuring plugin options [here](./plugins.md#plugin-options) +You can read more about configuring plugin options [here](./plugins.mdx#plugin-options) ::: diff --git a/docs/plugin-transform-for-of.md b/docs/plugin-transform-for-of.mdx similarity index 98% rename from docs/plugin-transform-for-of.md rename to docs/plugin-transform-for-of.mdx index 6ecbee9a8f..d57744d44a 100644 --- a/docs/plugin-transform-for-of.md +++ b/docs/plugin-transform-for-of.mdx @@ -102,7 +102,7 @@ require("@babel/core").transformSync("code", { In loose mode, arrays are put in a fast path, thus heavily increasing performance. :::caution -Consider migrating to the top level [`skipForOfIteratorClosing`](assumptions.md#skipforofiteratorclosing) assumption. +Consider migrating to the top level [`skipForOfIteratorClosing`](assumptions.mdx#skipforofiteratorclosing) assumption. ::: ```json title="babel.config.json" @@ -200,5 +200,5 @@ for (var _i = 0; _i < _arr.length; _i++) { ``` :::tip -You can read more about configuring plugin options [here](./plugins.md#plugin-options) +You can read more about configuring plugin options [here](./plugins.mdx#plugin-options) ::: diff --git a/docs/plugin-transform-function-name.md b/docs/plugin-transform-function-name.mdx similarity index 100% rename from docs/plugin-transform-function-name.md rename to docs/plugin-transform-function-name.mdx diff --git a/docs/plugin-transform-inline-consecutive-adds.md b/docs/plugin-transform-inline-consecutive-adds.mdx similarity index 100% rename from docs/plugin-transform-inline-consecutive-adds.md rename to docs/plugin-transform-inline-consecutive-adds.mdx diff --git a/docs/plugin-transform-inline-environment-variables.md b/docs/plugin-transform-inline-environment-variables.mdx similarity index 98% rename from docs/plugin-transform-inline-environment-variables.md rename to docs/plugin-transform-inline-environment-variables.mdx index abd1538df6..6e20b3094e 100644 --- a/docs/plugin-transform-inline-environment-variables.md +++ b/docs/plugin-transform-inline-environment-variables.mdx @@ -67,5 +67,5 @@ require("@babel/core").transformSync("code", { - `exclude` - array of environment variables to exclude :::tip -You can read more about configuring plugin options [here](./plugins.md#plugin-options) +You can read more about configuring plugin options [here](./plugins.mdx#plugin-options) ::: diff --git a/docs/plugin-transform-instanceof.md b/docs/plugin-transform-instanceof.mdx similarity index 100% rename from docs/plugin-transform-instanceof.md rename to docs/plugin-transform-instanceof.mdx diff --git a/docs/plugin-transform-jscript.md b/docs/plugin-transform-jscript.mdx similarity index 100% rename from docs/plugin-transform-jscript.md rename to docs/plugin-transform-jscript.mdx diff --git a/docs/plugin-transform-json-modules.md b/docs/plugin-transform-json-modules.mdx similarity index 92% rename from docs/plugin-transform-json-modules.md rename to docs/plugin-transform-json-modules.mdx index 9bc8a43098..91d8fdb27b 100644 --- a/docs/plugin-transform-json-modules.md +++ b/docs/plugin-transform-json-modules.mdx @@ -9,7 +9,7 @@ import TabItem from '@theme/TabItem'; Transforms `import ... with { type: "json" }` declarations to platform-specific API to read and then `JSON.parse` the imported file. -The transformation applied by this plugin depends on your top-level [`targets`](./options.md#targets) to detect whether the generated code should be compatible with Node.js, browsers, or both. When targeting Node.js, the generated code will also change depending on whether you are compiling modules to CommonJS or not. +The transformation applied by this plugin depends on your top-level [`targets`](./options.mdx#targets) to detect whether the generated code should be compatible with Node.js, browsers, or both. When targeting Node.js, the generated code will also change depending on whether you are compiling modules to CommonJS or not. :::caution This plugin cannot be used when compiling modules to AMD, SystemJS, or UMD. diff --git a/docs/plugin-transform-json-strings.md b/docs/plugin-transform-json-strings.mdx similarity index 100% rename from docs/plugin-transform-json-strings.md rename to docs/plugin-transform-json-strings.mdx diff --git a/docs/plugin-transform-literals.md b/docs/plugin-transform-literals.mdx similarity index 100% rename from docs/plugin-transform-literals.md rename to docs/plugin-transform-literals.mdx diff --git a/docs/plugin-transform-logical-assignment-operators.md b/docs/plugin-transform-logical-assignment-operators.mdx similarity index 100% rename from docs/plugin-transform-logical-assignment-operators.md rename to docs/plugin-transform-logical-assignment-operators.mdx diff --git a/docs/plugin-transform-member-expression-literals.md b/docs/plugin-transform-member-expression-literals.mdx similarity index 100% rename from docs/plugin-transform-member-expression-literals.md rename to docs/plugin-transform-member-expression-literals.mdx diff --git a/docs/plugin-transform-merge-sibling-variables.md b/docs/plugin-transform-merge-sibling-variables.mdx similarity index 100% rename from docs/plugin-transform-merge-sibling-variables.md rename to docs/plugin-transform-merge-sibling-variables.mdx diff --git a/docs/plugin-transform-minify-booleans.md b/docs/plugin-transform-minify-booleans.mdx similarity index 100% rename from docs/plugin-transform-minify-booleans.md rename to docs/plugin-transform-minify-booleans.mdx diff --git a/docs/plugin-transform-modules-amd.md b/docs/plugin-transform-modules-amd.mdx similarity index 96% rename from docs/plugin-transform-modules-amd.md rename to docs/plugin-transform-modules-amd.mdx index d65242ea35..3b9d9424f0 100644 --- a/docs/plugin-transform-modules-amd.md +++ b/docs/plugin-transform-modules-amd.mdx @@ -111,4 +111,4 @@ Added in: `v7.9.0` A root path to include on generated module names. -For options not listed here, see options for [`@babel/plugin-transform-modules-commonjs`](plugin-transform-modules-commonjs.md#options). +For options not listed here, see options for [`@babel/plugin-transform-modules-commonjs`](plugin-transform-modules-commonjs.mdx#options). diff --git a/docs/plugin-transform-modules-commonjs.md b/docs/plugin-transform-modules-commonjs.mdx similarity index 96% rename from docs/plugin-transform-modules-commonjs.md rename to docs/plugin-transform-modules-commonjs.mdx index 5aa190b3b3..206e145ccf 100644 --- a/docs/plugin-transform-modules-commonjs.md +++ b/docs/plugin-transform-modules-commonjs.mdx @@ -182,7 +182,7 @@ Object.defineProperty(exports, "__esModule", { ``` :::caution -Consider migrating to the top level [`enumerableModuleMeta`](assumptions.md#enumerablemodulemeta) assumption. +Consider migrating to the top level [`enumerableModuleMeta`](assumptions.mdx#enumerablemodulemeta) assumption. ::: ```json title="babel.config.json" @@ -254,7 +254,7 @@ The two cases where imports can never be lazy are: way to know what names need to be exported. :::tip -You can read more about configuring plugin options [here](./plugins.md#plugin-options) +You can read more about configuring plugin options [here](./plugins.mdx#plugin-options) ::: ### `noInterop` @@ -267,7 +267,7 @@ You can read more about configuring plugin options [here](./plugins.md#plugin-op When set to `true`, this option has the same behavior as setting `importInterop: "none"`. -## Relevant [`assumptions`](./assumptions.md) +## Relevant [`assumptions`](./assumptions.mdx) -- [`enumerableModuleMeta`](./assumptions.md#enumerablemodulemeta) -- [`noIncompleteNsImportDetection`](./assumptions.md#noincompletensimportdetection) +- [`enumerableModuleMeta`](./assumptions.mdx#enumerablemodulemeta) +- [`noIncompleteNsImportDetection`](./assumptions.mdx#noincompletensimportdetection) diff --git a/docs/plugin-transform-modules-systemjs.md b/docs/plugin-transform-modules-systemjs.mdx similarity index 98% rename from docs/plugin-transform-modules-systemjs.md rename to docs/plugin-transform-modules-systemjs.mdx index 4409f7e65a..3f35b45680 100644 --- a/docs/plugin-transform-modules-systemjs.md +++ b/docs/plugin-transform-modules-systemjs.mdx @@ -31,7 +31,7 @@ System.register([], function(_export, _context) { }); ``` -For dynamic import support (`import('./lazy.js').then(m => ...)`), enable the [@babel/plugin-syntax-dynamic-import](plugin-syntax-dynamic-import.md) plugin before this one. +For dynamic import support (`import('./lazy.js').then(m => ...)`), enable the [@babel/plugin-syntax-dynamic-import](plugin-syntax-dynamic-import.mdx) plugin before this one. ## Installation diff --git a/docs/plugin-transform-modules-umd.md b/docs/plugin-transform-modules-umd.mdx similarity index 98% rename from docs/plugin-transform-modules-umd.md rename to docs/plugin-transform-modules-umd.mdx index 96e431ebe9..97092c2a33 100644 --- a/docs/plugin-transform-modules-umd.md +++ b/docs/plugin-transform-modules-umd.mdx @@ -276,4 +276,4 @@ Added in: `v7.9.0` A root path to include on generated module names. -For options not listed here, see options for [`@babel/plugin-transform-modules-commonjs`](plugin-transform-modules-commonjs.md#options). +For options not listed here, see options for [`@babel/plugin-transform-modules-commonjs`](plugin-transform-modules-commonjs.mdx#options). diff --git a/docs/plugin-transform-named-capturing-groups-regex.md b/docs/plugin-transform-named-capturing-groups-regex.mdx similarity index 98% rename from docs/plugin-transform-named-capturing-groups-regex.md rename to docs/plugin-transform-named-capturing-groups-regex.mdx index 5c6146adff..deb136df8b 100644 --- a/docs/plugin-transform-named-capturing-groups-regex.md +++ b/docs/plugin-transform-named-capturing-groups-regex.mdx @@ -78,5 +78,5 @@ stringRe.exec("'foo'").groups.quote; // Error ``` :::tip -You can read more about configuring plugin options [here](./plugins.md#plugin-options) +You can read more about configuring plugin options [here](./plugins.mdx#plugin-options) ::: diff --git a/docs/plugin-transform-new-target.md b/docs/plugin-transform-new-target.mdx similarity index 100% rename from docs/plugin-transform-new-target.md rename to docs/plugin-transform-new-target.mdx diff --git a/docs/plugin-transform-node-env-inline.md b/docs/plugin-transform-node-env-inline.mdx similarity index 100% rename from docs/plugin-transform-node-env-inline.md rename to docs/plugin-transform-node-env-inline.mdx diff --git a/docs/plugin-transform-nullish-coalescing-operator.md b/docs/plugin-transform-nullish-coalescing-operator.mdx similarity index 97% rename from docs/plugin-transform-nullish-coalescing-operator.md rename to docs/plugin-transform-nullish-coalescing-operator.mdx index 41ae013a35..ecc53e4b9c 100644 --- a/docs/plugin-transform-nullish-coalescing-operator.md +++ b/docs/plugin-transform-nullish-coalescing-operator.mdx @@ -73,7 +73,7 @@ and perform loose equality checks with `null` instead of strict equality checks against both `null` and `undefined`. :::caution -Consider migrating to the top level [`noDocumentAll`](assumptions.md#nodocumentall) assumption. +Consider migrating to the top level [`noDocumentAll`](assumptions.mdx#nodocumentall) assumption. ::: ```json title="babel.config.json" @@ -101,7 +101,7 @@ var foo = (_object$foo = object.foo) != null ? _object$foo : "default"; ``` :::tip -You can read more about configuring plugin options [here](./plugins.md#plugin-options) +You can read more about configuring plugin options [here](./plugins.mdx#plugin-options) ::: ## References diff --git a/docs/plugin-transform-numeric-separator.md b/docs/plugin-transform-numeric-separator.mdx similarity index 97% rename from docs/plugin-transform-numeric-separator.md rename to docs/plugin-transform-numeric-separator.mdx index 70e6bf6b1a..b7b89f277e 100644 --- a/docs/plugin-transform-numeric-separator.md +++ b/docs/plugin-transform-numeric-separator.mdx @@ -95,10 +95,10 @@ require("@babel/core").transformSync("code", { ## Additional Information -If you need to further compile ES2015 Decimal, Binary, Hex and Octal number representations to their pre-ES2015 numeric literal form, add the [`"@babel/plugin-transform-literals"`](plugin-transform-literals.md) plugin: +If you need to further compile ES2015 Decimal, Binary, Hex and Octal number representations to their pre-ES2015 numeric literal form, add the [`"@babel/plugin-transform-literals"`](plugin-transform-literals.mdx) plugin: :::info -`@babel/plugin-transform-literals` is already included in [@babel/preset-env](preset-env.md). +`@babel/plugin-transform-literals` is already included in [@babel/preset-env](preset-env.mdx). ::: ### With a configuration file (Recommended) diff --git a/docs/plugin-transform-object-assign.md b/docs/plugin-transform-object-assign.mdx similarity index 100% rename from docs/plugin-transform-object-assign.md rename to docs/plugin-transform-object-assign.mdx diff --git a/docs/plugin-transform-object-rest-spread.md b/docs/plugin-transform-object-rest-spread.mdx similarity index 97% rename from docs/plugin-transform-object-rest-spread.md rename to docs/plugin-transform-object-rest-spread.mdx index a06c67cf90..565af36195 100644 --- a/docs/plugin-transform-object-rest-spread.md +++ b/docs/plugin-transform-object-rest-spread.mdx @@ -67,7 +67,7 @@ By default, this plugin will produce spec compliant code by using Babel's `objec Enabling this option will use Babel's `extends` helper, which is basically the same as `Object.assign` (see `useBuiltIns` below to use it directly). :::caution -Consider migrating to the top level [`setSpreadProperties`](assumptions.md#setspreadproperties) assumption. +Consider migrating to the top level [`setSpreadProperties`](assumptions.mdx#setspreadproperties) assumption. ::: ```json title="babel.config.json" @@ -116,7 +116,7 @@ z = Object.assign({ x }, y); ``` :::tip -You can read more about configuring plugin options [here](./plugins.md#plugin-options) +You can read more about configuring plugin options [here](./plugins.mdx#plugin-options) ::: ## References diff --git a/docs/plugin-transform-object-set-prototype-of-to-assign.md b/docs/plugin-transform-object-set-prototype-of-to-assign.mdx similarity index 95% rename from docs/plugin-transform-object-set-prototype-of-to-assign.md rename to docs/plugin-transform-object-set-prototype-of-to-assign.mdx index 18a3b26e18..12fd8f50e1 100644 --- a/docs/plugin-transform-object-set-prototype-of-to-assign.md +++ b/docs/plugin-transform-object-set-prototype-of-to-assign.mdx @@ -4,7 +4,7 @@ title: "@babel/plugin-transform-object-set-prototype-of-to-assign" sidebar_label: object-set-prototype-of-to-assign --- -**NOTE:** There are some caveats when using this plugin, see the [`@babel/plugin-transform-proto-to-assign`](plugin-transform-proto-to-assign.md) docs for more information. +**NOTE:** There are some caveats when using this plugin, see the [`@babel/plugin-transform-proto-to-assign`](plugin-transform-proto-to-assign.mdx) docs for more information. ## Example diff --git a/docs/plugin-transform-object-super.md b/docs/plugin-transform-object-super.mdx similarity index 100% rename from docs/plugin-transform-object-super.md rename to docs/plugin-transform-object-super.mdx diff --git a/docs/plugin-transform-optional-catch-binding.md b/docs/plugin-transform-optional-catch-binding.mdx similarity index 100% rename from docs/plugin-transform-optional-catch-binding.md rename to docs/plugin-transform-optional-catch-binding.mdx diff --git a/docs/plugin-transform-optional-chaining.md b/docs/plugin-transform-optional-chaining.mdx similarity index 98% rename from docs/plugin-transform-optional-chaining.md rename to docs/plugin-transform-optional-chaining.mdx index dc699c4582..1eb000574c 100644 --- a/docs/plugin-transform-optional-chaining.md +++ b/docs/plugin-transform-optional-chaining.mdx @@ -144,7 +144,7 @@ and perform loose equality checks with `null` instead of strict equality checks against both `null` and `undefined`. :::caution -Consider migrating to the top level [`noDocumentAll`](assumptions.md#nodocumentall) assumption. +Consider migrating to the top level [`noDocumentAll`](assumptions.mdx#nodocumentall) assumption. ::: ```json title="babel.config.json" @@ -176,7 +176,7 @@ foo === null || foo === void 0 ? void 0 : foo.bar; ``` :::tip -You can read more about configuring plugin options [here](./plugins.md#plugin-options) +You can read more about configuring plugin options [here](./plugins.mdx#plugin-options) ::: ## References diff --git a/docs/plugin-transform-parameters.md b/docs/plugin-transform-parameters.mdx similarity index 96% rename from docs/plugin-transform-parameters.md rename to docs/plugin-transform-parameters.mdx index c2e9a811bb..73e52a5e57 100644 --- a/docs/plugin-transform-parameters.md +++ b/docs/plugin-transform-parameters.mdx @@ -58,7 +58,7 @@ npm install --save-dev @babel/plugin-transform-parameters Default parameters desugar into `let` declarations to retain proper semantics. If this is not supported in your environment then you'll need the -[@babel/plugin-transform-block-scoping](plugin-transform-block-scoping.md) plugin. +[@babel/plugin-transform-block-scoping](plugin-transform-block-scoping.mdx) plugin. ## Usage @@ -93,7 +93,7 @@ require("@babel/core").transformSync("code", { In loose mode, parameters with default values will be counted into the arity of the function. This is not spec behavior where these parameters do not add to function arity. :::caution -Consider migrating to the top level [`ignoreFunctionLength`](assumptions.md#ignorefunctionlength) assumption. +Consider migrating to the top level [`ignoreFunctionLength`](assumptions.mdx#ignorefunctionlength) assumption. ::: ```json title="babel.config.json" @@ -117,5 +117,5 @@ bar1.length; // 1 ``` :::tip -You can read more about configuring plugin options [here](./plugins.md#plugin-options) +You can read more about configuring plugin options [here](./plugins.mdx#plugin-options) ::: diff --git a/docs/plugin-transform-private-methods.md b/docs/plugin-transform-private-methods.mdx similarity index 97% rename from docs/plugin-transform-private-methods.md rename to docs/plugin-transform-private-methods.mdx index 84eb5633b0..67e243297a 100644 --- a/docs/plugin-transform-private-methods.md +++ b/docs/plugin-transform-private-methods.mdx @@ -84,7 +84,7 @@ require("@babel/core").transformSync("code", { `boolean`, defaults to `false`. :::note -The `loose` mode configuration setting _must_ be the same as [`@babel/plugin-transform-class-properties`](plugin-transform-class-properties.md). +The `loose` mode configuration setting _must_ be the same as [`@babel/plugin-transform-class-properties`](plugin-transform-class-properties.mdx). ::: When true, private methods will be assigned directly on its parent @@ -93,7 +93,7 @@ performance and debugging (normal property access vs `.get()`) at the expense of potentially leaking "privates" via things like `Object.getOwnPropertyNames`. :::caution -Consider migrating to the top level [`privateFieldsAsProperties`](assumptions.md#privatefieldsasproperties) assumption. +Consider migrating to the top level [`privateFieldsAsProperties`](assumptions.mdx#privatefieldsasproperties) assumption. ::: ```json title="babel.config.json" @@ -166,7 +166,7 @@ var _privateMethod2 = function _privateMethod2() { ``` :::tip -You can read more about configuring plugin options [here](./plugins.md#plugin-options) +You can read more about configuring plugin options [here](./plugins.mdx#plugin-options) ::: ## References diff --git a/docs/plugin-transform-private-property-in-object.md b/docs/plugin-transform-private-property-in-object.mdx similarity index 96% rename from docs/plugin-transform-private-property-in-object.md rename to docs/plugin-transform-private-property-in-object.mdx index 46bf26ea84..f8097ce1dd 100644 --- a/docs/plugin-transform-private-property-in-object.md +++ b/docs/plugin-transform-private-property-in-object.mdx @@ -78,7 +78,7 @@ require("@babel/core").transformSync("code", { `boolean`, defaults to `false`. :::note -The `loose` mode configuration setting _must_ be the same as [`@babel/transform-class-properties`](plugin-transform-class-properties.md). +The `loose` mode configuration setting _must_ be the same as [`@babel/transform-class-properties`](plugin-transform-class-properties.mdx). ::: When true, private property `in` expressions will check own properties (as opposed to inherited ones) on the object, instead of checking for presence inside a `WeakSet`. This results in improved @@ -86,7 +86,7 @@ performance and debugging (normal property access vs `.get()`) at the expense of potentially leaking "privates" via things like `Object.getOwnPropertyNames`. :::caution -Consider migrating to the top level [`privateFieldsAsProperties`](assumptions.md#privatefieldsasproperties) assumption. +Consider migrating to the top level [`privateFieldsAsProperties`](assumptions.mdx#privatefieldsasproperties) assumption. ::: ```json title="babel.config.json" @@ -134,7 +134,7 @@ var _bar = babelHelpers.classPrivateFieldLooseKey("bar"); ``` :::tip -You can read more about configuring plugin options [here](./plugins.md#plugin-options) +You can read more about configuring plugin options [here](./plugins.mdx#plugin-options) ::: ## References diff --git a/docs/plugin-transform-property-literals.md b/docs/plugin-transform-property-literals.mdx similarity index 100% rename from docs/plugin-transform-property-literals.md rename to docs/plugin-transform-property-literals.mdx diff --git a/docs/plugin-transform-property-mutators.md b/docs/plugin-transform-property-mutators.mdx similarity index 100% rename from docs/plugin-transform-property-mutators.md rename to docs/plugin-transform-property-mutators.mdx diff --git a/docs/plugin-transform-proto-to-assign.md b/docs/plugin-transform-proto-to-assign.mdx similarity index 100% rename from docs/plugin-transform-proto-to-assign.md rename to docs/plugin-transform-proto-to-assign.mdx diff --git a/docs/plugin-transform-react-constant-elements.md b/docs/plugin-transform-react-constant-elements.mdx similarity index 99% rename from docs/plugin-transform-react-constant-elements.md rename to docs/plugin-transform-react-constant-elements.mdx index ccb9561f10..af9b79c3f2 100644 --- a/docs/plugin-transform-react-constant-elements.md +++ b/docs/plugin-transform-react-constant-elements.mdx @@ -103,7 +103,7 @@ This will skip the `Mutable Properties` deopt. ``` :::tip -You can read more about configuring plugin options [here](./plugins.md#plugin-options) +You can read more about configuring plugin options [here](./plugins.mdx#plugin-options) ::: ### Via CLI diff --git a/docs/plugin-transform-react-display-name.md b/docs/plugin-transform-react-display-name.mdx similarity index 100% rename from docs/plugin-transform-react-display-name.md rename to docs/plugin-transform-react-display-name.mdx diff --git a/docs/plugin-transform-react-inline-elements.md b/docs/plugin-transform-react-inline-elements.mdx similarity index 100% rename from docs/plugin-transform-react-inline-elements.md rename to docs/plugin-transform-react-inline-elements.mdx diff --git a/docs/plugin-transform-react-jsx-compat.md b/docs/plugin-transform-react-jsx-compat.mdx similarity index 100% rename from docs/plugin-transform-react-jsx-compat.md rename to docs/plugin-transform-react-jsx-compat.mdx diff --git a/docs/plugin-transform-react-jsx-development.md b/docs/plugin-transform-react-jsx-development.mdx similarity index 83% rename from docs/plugin-transform-react-jsx-development.md rename to docs/plugin-transform-react-jsx-development.mdx index 5991ec9dbc..fd7c1a8a2b 100644 --- a/docs/plugin-transform-react-jsx-development.md +++ b/docs/plugin-transform-react-jsx-development.mdx @@ -8,9 +8,9 @@ sidebar_label: transform-react-jsx-development This plugin is included in `@babel/preset-react` ::: -This plugin is a developer version of [`@babel/plugin-transform-react-jsx`](./plugin-transform-react-jsx.md). It is designed to provide enhanced validation error messages and precise code location information for debugging React apps. Note that this plugin is intended to be used in a development environment, as it generates significantly more outputs than the production build. +This plugin is a developer version of [`@babel/plugin-transform-react-jsx`](./plugin-transform-react-jsx.mdx). It is designed to provide enhanced validation error messages and precise code location information for debugging React apps. Note that this plugin is intended to be used in a development environment, as it generates significantly more outputs than the production build. -If you are using [`@babel/preset-react`](./preset-react.md), it will be automatically enabled by the [`development`](./preset-react.md#development) option so you don't have to install it. +If you are using [`@babel/preset-react`](./preset-react.mdx), it will be automatically enabled by the [`development`](./preset-react.mdx#development) option so you don't have to install it. ## Example @@ -131,4 +131,4 @@ Set this to `true` if you are using a React version older than 19.2 or a custom ::: -It accepts the same options as [`@babel/plugin-transform-react-jsx`](./plugin-transform-react-jsx.md#options). +It accepts the same options as [`@babel/plugin-transform-react-jsx`](./plugin-transform-react-jsx.mdx#options). diff --git a/docs/plugin-transform-react-jsx-self.md b/docs/plugin-transform-react-jsx-self.mdx similarity index 100% rename from docs/plugin-transform-react-jsx-self.md rename to docs/plugin-transform-react-jsx-self.mdx diff --git a/docs/plugin-transform-react-jsx-source.md b/docs/plugin-transform-react-jsx-source.mdx similarity index 100% rename from docs/plugin-transform-react-jsx-source.md rename to docs/plugin-transform-react-jsx-source.mdx diff --git a/docs/plugin-transform-react-jsx.md b/docs/plugin-transform-react-jsx.mdx similarity index 98% rename from docs/plugin-transform-react-jsx.md rename to docs/plugin-transform-react-jsx.mdx index e4cd72cf55..27e9d9574f 100644 --- a/docs/plugin-transform-react-jsx.md +++ b/docs/plugin-transform-react-jsx.mdx @@ -8,7 +8,7 @@ sidebar_label: transform-react-jsx This plugin is included in `@babel/preset-react` ::: -This plugin generates production-ready JS code. If you are developing a React app in a development environment, please use [`@babel/plugin-transform-react-jsx-development`](./plugin-transform-react-jsx-development.md) for a better debugging experience. +This plugin generates production-ready JS code. If you are developing a React app in a development environment, please use [`@babel/plugin-transform-react-jsx-development`](./plugin-transform-react-jsx-development.mdx) for a better debugging experience. ## Example @@ -351,7 +351,7 @@ Toggles whether or not to throw an error if an XML namespaced tag name is used. Though the JSX spec allows this, it is disabled by default since React's JSX does not currently have support for it. :::tip -You can read more about configuring plugin options [here](./plugins.md#plugin-options) +You can read more about configuring plugin options [here](./plugins.mdx#plugin-options) ::: #### `runtime` diff --git a/docs/plugin-transform-regenerator.md b/docs/plugin-transform-regenerator.mdx similarity index 100% rename from docs/plugin-transform-regenerator.md rename to docs/plugin-transform-regenerator.mdx diff --git a/docs/plugin-transform-regexp-constructors.md b/docs/plugin-transform-regexp-constructors.mdx similarity index 100% rename from docs/plugin-transform-regexp-constructors.md rename to docs/plugin-transform-regexp-constructors.mdx diff --git a/docs/plugin-transform-regexp-modifiers.md b/docs/plugin-transform-regexp-modifiers.mdx similarity index 100% rename from docs/plugin-transform-regexp-modifiers.md rename to docs/plugin-transform-regexp-modifiers.mdx diff --git a/docs/plugin-transform-remove-console.md b/docs/plugin-transform-remove-console.mdx similarity index 97% rename from docs/plugin-transform-remove-console.md rename to docs/plugin-transform-remove-console.mdx index 846da1edf4..fd30f1af88 100644 --- a/docs/plugin-transform-remove-console.md +++ b/docs/plugin-transform-remove-console.mdx @@ -61,5 +61,5 @@ require("@babel/core").transformSync("code", { - `exclude` - An array of console methods to exclude from removal. :::tip -You can read more about configuring plugin options [here](./plugins.md#plugin-options) +You can read more about configuring plugin options [here](./plugins.mdx#plugin-options) ::: diff --git a/docs/plugin-transform-remove-debugger.md b/docs/plugin-transform-remove-debugger.mdx similarity index 100% rename from docs/plugin-transform-remove-debugger.md rename to docs/plugin-transform-remove-debugger.mdx diff --git a/docs/plugin-transform-remove-undefined.md b/docs/plugin-transform-remove-undefined.mdx similarity index 97% rename from docs/plugin-transform-remove-undefined.md rename to docs/plugin-transform-remove-undefined.mdx index da104a5b09..6bf09a6fb6 100644 --- a/docs/plugin-transform-remove-undefined.md +++ b/docs/plugin-transform-remove-undefined.mdx @@ -63,5 +63,5 @@ require("@babel/core").transformSync("code", { - `tdz` - Detect usages before declaration/initialization in let/const(throws) and var(void 0) :::tip -You can read more about configuring plugin options [here](./plugins.md#plugin-options) +You can read more about configuring plugin options [here](./plugins.mdx#plugin-options) ::: diff --git a/docs/plugin-transform-reserved-words.md b/docs/plugin-transform-reserved-words.mdx similarity index 100% rename from docs/plugin-transform-reserved-words.md rename to docs/plugin-transform-reserved-words.mdx diff --git a/docs/plugin-transform-runtime.md b/docs/plugin-transform-runtime.mdx similarity index 96% rename from docs/plugin-transform-runtime.md rename to docs/plugin-transform-runtime.mdx index 0c69771511..5a966ec0fa 100644 --- a/docs/plugin-transform-runtime.md +++ b/docs/plugin-transform-runtime.mdx @@ -21,7 +21,7 @@ Install it as development dependency. npm install --save-dev @babel/plugin-transform-runtime ``` -and [`@babel/runtime`](runtime.md) as a production dependency (since it's for the "runtime"). +and [`@babel/runtime`](runtime.mdx) as a production dependency (since it's for the "runtime"). ```shell npm2yarn npm install --save @babel/runtime @@ -41,7 +41,7 @@ This is where the `@babel/plugin-transform-runtime` plugin comes in: all of the ::::babel7 -Another purpose of this transformer is to create a sandboxed environment for your code. If you directly import [core-js](https://github.com/zloirock/core-js) or [@babel/polyfill](polyfill.md) and the built-ins it provides such as `Promise`, `Set` and `Map`, those will pollute the global scope. While this might be ok for an app or a command line tool, it becomes a problem if your code is a library which you intend to publish for others to use or if you can't exactly control the environment in which your code will run. +Another purpose of this transformer is to create a sandboxed environment for your code. If you directly import [core-js](https://github.com/zloirock/core-js) or [@babel/polyfill](polyfill.mdx) and the built-ins it provides such as `Promise`, `Set` and `Map`, those will pollute the global scope. While this might be ok for an app or a command line tool, it becomes a problem if your code is a library which you intend to publish for others to use or if you can't exactly control the environment in which your code will run. The transformer will alias these built-ins to `core-js` so you can use them seamlessly without having to require the polyfill. @@ -108,7 +108,7 @@ This allows users to run `transform-runtime` broadly across a whole project. By Using absolute paths is not desirable if files are compiled for use at a later time, but in contexts where a file is compiled and then immediately consumed, they can be quite helpful. :::tip -You can read more about configuring plugin options [here](./plugins.md#plugin-options) +You can read more about configuring plugin options [here](./plugins.mdx#plugin-options) ::: ::::babel7 diff --git a/docs/plugin-transform-shorthand-properties.md b/docs/plugin-transform-shorthand-properties.mdx similarity index 100% rename from docs/plugin-transform-shorthand-properties.md rename to docs/plugin-transform-shorthand-properties.mdx diff --git a/docs/plugin-transform-simplify-comparison-operators.md b/docs/plugin-transform-simplify-comparison-operators.mdx similarity index 100% rename from docs/plugin-transform-simplify-comparison-operators.md rename to docs/plugin-transform-simplify-comparison-operators.mdx diff --git a/docs/plugin-transform-spread.md b/docs/plugin-transform-spread.mdx similarity index 96% rename from docs/plugin-transform-spread.md rename to docs/plugin-transform-spread.mdx index adb4a4931a..34ee3cc127 100644 --- a/docs/plugin-transform-spread.md +++ b/docs/plugin-transform-spread.mdx @@ -86,7 +86,7 @@ require("@babel/core").transformSync("code", { In loose mode, **all** iterables are assumed to be arrays. :::caution -Consider migrating to the top level [`iterableIsArray`](assumptions.md#iterableisarray) assumption. +Consider migrating to the top level [`iterableIsArray`](assumptions.mdx#iterableisarray) assumption. ::: ```json title="babel.config.json" @@ -100,7 +100,7 @@ Consider migrating to the top level [`iterableIsArray`](assumptions.md#iterablei Under the `iterableIsArray` assumption, Babel preserves "holes" when spreading an array (for example, `[ ...Array(2) ]` produces `[ (hole), (hole) ]`). Set `iterableIsArray` to `false` to avoid this behaviour. :::tip -You can read more about configuring plugin options [here](./plugins.md#plugin-options) +You can read more about configuring plugin options [here](./plugins.mdx#plugin-options) ::: ### `allowArrayLike` @@ -112,7 +112,7 @@ Added in: `v7.10.0` This option allows spreading array-like objects as if they were arrays. :::caution -Consider migrating to the top level [`arrayLikeIsIterable`](assumptions.md#arraylikeisiterable) assumption. +Consider migrating to the top level [`arrayLikeIsIterable`](assumptions.mdx#arraylikeisiterable) assumption. ::: ```json title="babel.config.json" diff --git a/docs/plugin-transform-sticky-regex.md b/docs/plugin-transform-sticky-regex.mdx similarity index 100% rename from docs/plugin-transform-sticky-regex.md rename to docs/plugin-transform-sticky-regex.mdx diff --git a/docs/plugin-transform-strict-mode.md b/docs/plugin-transform-strict-mode.mdx similarity index 100% rename from docs/plugin-transform-strict-mode.md rename to docs/plugin-transform-strict-mode.mdx diff --git a/docs/plugin-transform-template-literals.md b/docs/plugin-transform-template-literals.mdx similarity index 96% rename from docs/plugin-transform-template-literals.md rename to docs/plugin-transform-template-literals.mdx index a5a4e1d6f0..c9c377c3c1 100644 --- a/docs/plugin-transform-template-literals.md +++ b/docs/plugin-transform-template-literals.mdx @@ -76,7 +76,7 @@ require("@babel/core").transformSync("code", { `boolean`, defaults to `false`. :::caution -Consider migrating to the top level [`mutableTemplateObject`](assumptions.md#mutabletemplateobject) assumption. +Consider migrating to the top level [`mutableTemplateObject`](assumptions.mdx#mutabletemplateobject) assumption. ::: ```json title="babel.config.json" @@ -104,5 +104,5 @@ When `false` or not set, all template literal expressions and quasis are combine ``` :::tip -You can read more about configuring plugin options [here](./plugins.md#plugin-options) +You can read more about configuring plugin options [here](./plugins.mdx#plugin-options) ::: diff --git a/docs/plugin-transform-typeof-symbol.md b/docs/plugin-transform-typeof-symbol.mdx similarity index 100% rename from docs/plugin-transform-typeof-symbol.md rename to docs/plugin-transform-typeof-symbol.mdx diff --git a/docs/plugin-transform-typescript.md b/docs/plugin-transform-typescript.mdx similarity index 94% rename from docs/plugin-transform-typescript.md rename to docs/plugin-transform-typescript.mdx index 042d75f7ad..e7242f7c5d 100644 --- a/docs/plugin-transform-typescript.md +++ b/docs/plugin-transform-typescript.mdx @@ -194,7 +194,7 @@ compiles and type checks. While many don't apply, some behaviors might be useful equivalents in Babel can be enabled by some configuration options or plugins. - `--alwaysStrict` - You can use the `strictMode` [parser option](./parser.md#options): + You can use the `strictMode` [parser option](./parser.mdx#options): ```js title="JavaScript" module.exports = { parserOpts: { strictMode: true }, @@ -219,17 +219,17 @@ equivalents in Babel can be enabled by some configuration options or plugins. - `---importsNotUsedAsValues` You can use the `onlyRemoveTypeImports` option to replicate this behavior. `onlyRemoveTypeImports: true` is equivalent to `importsNotUsedAsValues: preserve`, while `onlyRemoveTypeImports: false` is equivalent to `importsNotUsedAsValues: remove`. There is no equivalent for `importsNotUsedAsValues: error`. - `--inlineSourceMap` - You can set the [`sourceMaps: "inline"`](./options.md#sourcemaps) option in your `babel.config.json` file. + You can set the [`sourceMaps: "inline"`](./options.mdx#sourcemaps) option in your `babel.config.json` file. - `--isolatedModules` This is the default Babel behavior, and it can't be turned off because Babel doesn't support cross-file analysis. - `--jsx` JSX support is provided using another plugin. If you want your output to contains JSX code (i.e. `--jsx preserve`), you need the `@babel/plugin-syntax-jsx` plugin; if you want to transpile it to standard JavaScript (i.e. `--jsx react` or `--jsx react-native`), you should use the `@babel/plugin-transform-react-jsx` plugin. - `--jsxFactory` - It can be customized using the [`pragma` option](plugin-transform-react-jsx.md#pragma) of the `@babel/plugin-transform-react-jsx` package. You also need to set the `jsxPragma` option of this plugin. + It can be customized using the [`pragma` option](plugin-transform-react-jsx.mdx#pragma) of the `@babel/plugin-transform-react-jsx` package. You also need to set the `jsxPragma` option of this plugin. - `--module`, `-m` If you are using a bundler (Webpack or Rollup), this option is set automatically. - If you are using `@babel/preset-env`, you can use the [`modules` option](./preset-env.md#modules); otherwise you can load the specific plugin. + If you are using `@babel/preset-env`, you can use the [`modules` option](./preset-env.mdx#modules); otherwise you can load the specific plugin. | **`--module` value** | **`@babel/preset-env`'s `modules`** | **Single plugin** | | :------------------: | :---------------------------------: | :----------------------------------------: | @@ -241,19 +241,19 @@ equivalents in Babel can be enabled by some configuration options or plugins. | `ES6` or `ES2015` | `false` | / | - `--outDir` - When using `@babel/cli`, you can set the [`--out-dir` option](./cli.md#compile-directories). + When using `@babel/cli`, you can set the [`--out-dir` option](./cli.mdx#compile-directories). - `--outFile` Babel doesn't support concatenating output files: you should use a bundler (like Webpack, Rollup or Parcel) for that. - When using `@babel/cli`, you can compile a single file using the [`--out-file` option](./cli.md#compile-files). + When using `@babel/cli`, you can compile a single file using the [`--out-file` option](./cli.mdx#compile-files). - `--sourceMap` - You can use the top-level [`sourceMaps: true` option](./options.md#sourcemaps). + You can use the top-level [`sourceMaps: true` option](./options.mdx#sourcemaps). - `--target` - Babel doesn't support targeting a specific version of the language, but you can choose which engines you want to target using [`@babel/preset-env`](./preset-env.md). - If you prefer, you can enable [individual plugins](./plugins-list.md) for every ECMAScript feature. + Babel doesn't support targeting a specific version of the language, but you can choose which engines you want to target using [`@babel/preset-env`](./preset-env.mdx). + If you prefer, you can enable [individual plugins](./plugins-list.mdx) for every ECMAScript feature. - `--useDefineForClassFields` - You can use the [`setPublicClassFields`](./assumptions.md#setpublicclassfields) assumption to replicate this behavior. + You can use the [`setPublicClassFields`](./assumptions.mdx#setpublicclassfields) assumption to replicate this behavior. - `--watch`, `-w` - When using `@babel/cli`, you can specify the [`--watch` option](./cli.md#compile-files). + When using `@babel/cli`, you can specify the [`--watch` option](./cli.mdx#compile-files). ## Caveats diff --git a/docs/plugin-transform-undefined-to-void.md b/docs/plugin-transform-undefined-to-void.mdx similarity index 100% rename from docs/plugin-transform-undefined-to-void.md rename to docs/plugin-transform-undefined-to-void.mdx diff --git a/docs/plugin-transform-unicode-escapes.md b/docs/plugin-transform-unicode-escapes.mdx similarity index 100% rename from docs/plugin-transform-unicode-escapes.md rename to docs/plugin-transform-unicode-escapes.mdx diff --git a/docs/plugin-transform-unicode-property-regex.md b/docs/plugin-transform-unicode-property-regex.mdx similarity index 98% rename from docs/plugin-transform-unicode-property-regex.md rename to docs/plugin-transform-unicode-property-regex.mdx index 12ec689df5..b6df2934bd 100644 --- a/docs/plugin-transform-unicode-property-regex.md +++ b/docs/plugin-transform-unicode-property-regex.mdx @@ -63,7 +63,7 @@ When disabled with `false`, the transform converts Unicode regexes to non-Unicode regexes for wider support, removing the `u` flag. See https://github.com/mathiasbynens/regexpu-core#useunicodeflag-default-false for more information. :::tip -You can read more about configuring plugin options [here](./plugins.md#plugin-options) +You can read more about configuring plugin options [here](./plugins.mdx#plugin-options) ::: ## Author diff --git a/docs/plugin-transform-unicode-regex.md b/docs/plugin-transform-unicode-regex.mdx similarity index 100% rename from docs/plugin-transform-unicode-regex.md rename to docs/plugin-transform-unicode-regex.mdx diff --git a/docs/plugin-transform-unicode-sets-regex.md b/docs/plugin-transform-unicode-sets-regex.mdx similarity index 100% rename from docs/plugin-transform-unicode-sets-regex.md rename to docs/plugin-transform-unicode-sets-regex.mdx diff --git a/docs/plugins-list.md b/docs/plugins-list.md deleted file mode 100644 index 89d1dda935..0000000000 --- a/docs/plugins-list.md +++ /dev/null @@ -1,159 +0,0 @@ ---- -title: Plugins List -id: plugins-list -sidebar_label: Plugins List ---- - -## JavaScript - -### TC39 Proposals - -#### Stage 3 - -- [decorators](plugin-proposal-decorators.md) -- [import-wasm-source](plugin-proposal-import-wasm-source.md) - -#### Early stages - -- [do-expressions](plugin-proposal-do-expressions.md) -- [export-default-from](plugin-proposal-export-default-from.md) -- [function-bind](plugin-proposal-function-bind.md) -- [function-sent](plugin-proposal-function-sent.md) -- [partial-application](plugin-proposal-partial-application.md) -- [pipeline-operator](plugin-proposal-pipeline-operator.md) -- [throw-expressions](plugin-proposal-throw-expressions.md) -- [record-and-tuple](plugin-proposal-record-and-tuple.md) - -### ES2026 - -- [explicit-resource-management](./plugin-transform-explicit-resource-management.md) - -### ES2025 - -- [duplicate-named-capturing-groups-regex](plugin-transform-duplicate-named-capturing-groups-regex.md) -- [json-modules](plugin-transform-json-modules.md) -- [regexp-modifiers](plugin-transform-regexp-modifiers.md) - -### ES2024 - -- [unicode-sets-regex](plugin-transform-unicode-sets-regex.md) - -### ES2022 - -- [class-properties](plugin-transform-class-properties.md) -- [class-static-block](plugin-transform-class-static-block.md) -- [private-property-in-object](plugin-transform-private-property-in-object.md) -- [private-methods](plugin-transform-private-methods.md) - -### ES2021 - -- [logical-assignment-operators](plugin-transform-logical-assignment-operators.md) -- [numeric-separator](plugin-transform-numeric-separator.md) - -### ES2020 - -- [dynamic-import](plugin-transform-dynamic-import.md) -- [export-namespace-from](plugin-transform-export-namespace-from.md) -- [nullish-coalescing-operator](plugin-transform-nullish-coalescing-operator.md) -- [optional-chaining](plugin-transform-optional-chaining.md) - -### ES2019 - -- [optional-catch-binding](plugin-transform-optional-catch-binding.md) -- [json-strings](plugin-transform-json-strings.md) - -### ES2018 - -- [async-generator-functions](plugin-transform-async-generator-functions.md) -- [dotall-regex](plugin-transform-dotall-regex.md) -- [named-capturing-groups-regex](plugin-transform-named-capturing-groups-regex.md) -- [object-rest-spread](plugin-transform-object-rest-spread.md) -- [unicode-property-regex](plugin-transform-unicode-property-regex.md) - -### ES2017 - -- [async-to-generator](plugin-transform-async-to-generator.md) - -### ES2016 - -- [exponentiation-operator](plugin-transform-exponentiation-operator.md) - -### ES2015 - -- [arrow-functions](plugin-transform-arrow-functions.md) -- [block-scoped-functions](plugin-transform-block-scoped-functions.md) -- [block-scoping](plugin-transform-block-scoping.md) -- [classes](plugin-transform-classes.md) -- [computed-properties](plugin-transform-computed-properties.md) -- [destructuring](plugin-transform-destructuring.md) -- [duplicate-keys](plugin-transform-duplicate-keys.md) -- [for-of](plugin-transform-for-of.md) -- [function-name](plugin-transform-function-name.md) -- [instanceof](plugin-transform-instanceof.md) -- [literals](plugin-transform-literals.md) -- [new-target](plugin-transform-new-target.md) -- [object-super](plugin-transform-object-super.md) -- [parameters](plugin-transform-parameters.md) -- [shorthand-properties](plugin-transform-shorthand-properties.md) -- [spread](plugin-transform-spread.md) -- [sticky-regex](plugin-transform-sticky-regex.md) -- [template-literals](plugin-transform-template-literals.md) -- [typeof-symbol](plugin-transform-typeof-symbol.md) -- [unicode-escapes](plugin-transform-unicode-escapes.md) -- [unicode-regex](plugin-transform-unicode-regex.md) - -### ES5 - -- [property-mutators](plugin-transform-property-mutators.md) - -### ES3 - -- [member-expression-literals](plugin-transform-member-expression-literals.md) -- [property-literals](plugin-transform-property-literals.md) -- [reserved-words](plugin-transform-reserved-words.md) - -### Module Formats - -- [modules-amd](plugin-transform-modules-amd.md) -- [modules-commonjs](plugin-transform-modules-commonjs.md) -- [modules-systemjs](plugin-transform-modules-systemjs.md) -- [modules-umd](plugin-transform-modules-umd.md) - -### React - -- [react-constant-elements](plugin-transform-react-constant-elements.md) -- [react-inline-elements](plugin-transform-react-inline-elements.md) - -#### React Preset - -- [react-display-name](plugin-transform-react-display-name.md) -- [react-jsx](plugin-transform-react-jsx.md) -- [react-jsx-compat](plugin-transform-react-jsx-compat.md) -- [react-jsx-self](plugin-transform-react-jsx-self.md) -- [react-jsx-source](plugin-transform-react-jsx-source.md) - -### Flow - -- [flow-strip-types](plugin-transform-flow-strip-types.md) - -### TypeScript - -- [typescript](plugin-transform-typescript.md) - -### Misc - -- [external-helpers](plugin-external-helpers.md) -- [jscript](plugin-transform-jscript.md) -- [object-assign](plugin-transform-object-assign.md) -- [object-set-prototype-of-to-assign](plugin-transform-object-set-prototype-of-to-assign.md) -- [proto-to-assign](plugin-transform-proto-to-assign.md) -- [regenerator](plugin-transform-regenerator.md) -- [runtime](plugin-transform-runtime.md) -- [strict-mode](plugin-transform-strict-mode.md) - -#### Syntax Only - -- [syntax-bigint](plugin-syntax-bigint.md) (ES2020) -- [syntax-dynamic-import](plugin-syntax-dynamic-import.md) (ES2020) -- [syntax-import-meta](plugin-syntax-import-meta.md) (ES2020) -- [syntax-top-level-await](plugin-syntax-top-level-await.md) (ES2022) diff --git a/docs/plugins-list.mdx b/docs/plugins-list.mdx new file mode 100644 index 0000000000..77b293c872 --- /dev/null +++ b/docs/plugins-list.mdx @@ -0,0 +1,159 @@ +--- +title: Plugins List +id: plugins-list +sidebar_label: Plugins List +--- + +## JavaScript + +### TC39 Proposals + +#### Stage 3 + +- [decorators](plugin-proposal-decorators.mdx) +- [import-wasm-source](plugin-proposal-import-wasm-source.mdx) + +#### Early stages + +- [do-expressions](plugin-proposal-do-expressions.mdx) +- [export-default-from](plugin-proposal-export-default-from.mdx) +- [function-bind](plugin-proposal-function-bind.mdx) +- [function-sent](plugin-proposal-function-sent.mdx) +- [partial-application](plugin-proposal-partial-application.mdx) +- [pipeline-operator](plugin-proposal-pipeline-operator.mdx) +- [throw-expressions](plugin-proposal-throw-expressions.mdx) +- [record-and-tuple](plugin-proposal-record-and-tuple.mdx) + +### ES2026 + +- [explicit-resource-management](./plugin-transform-explicit-resource-management.mdx) + +### ES2025 + +- [duplicate-named-capturing-groups-regex](plugin-transform-duplicate-named-capturing-groups-regex.mdx) +- [json-modules](plugin-transform-json-modules.mdx) +- [regexp-modifiers](plugin-transform-regexp-modifiers.mdx) + +### ES2024 + +- [unicode-sets-regex](plugin-transform-unicode-sets-regex.mdx) + +### ES2022 + +- [class-properties](plugin-transform-class-properties.mdx) +- [class-static-block](plugin-transform-class-static-block.mdx) +- [private-property-in-object](plugin-transform-private-property-in-object.mdx) +- [private-methods](plugin-transform-private-methods.mdx) + +### ES2021 + +- [logical-assignment-operators](plugin-transform-logical-assignment-operators.mdx) +- [numeric-separator](plugin-transform-numeric-separator.mdx) + +### ES2020 + +- [dynamic-import](plugin-transform-dynamic-import.mdx) +- [export-namespace-from](plugin-transform-export-namespace-from.mdx) +- [nullish-coalescing-operator](plugin-transform-nullish-coalescing-operator.mdx) +- [optional-chaining](plugin-transform-optional-chaining.mdx) + +### ES2019 + +- [optional-catch-binding](plugin-transform-optional-catch-binding.mdx) +- [json-strings](plugin-transform-json-strings.mdx) + +### ES2018 + +- [async-generator-functions](plugin-transform-async-generator-functions.mdx) +- [dotall-regex](plugin-transform-dotall-regex.mdx) +- [named-capturing-groups-regex](plugin-transform-named-capturing-groups-regex.mdx) +- [object-rest-spread](plugin-transform-object-rest-spread.mdx) +- [unicode-property-regex](plugin-transform-unicode-property-regex.mdx) + +### ES2017 + +- [async-to-generator](plugin-transform-async-to-generator.mdx) + +### ES2016 + +- [exponentiation-operator](plugin-transform-exponentiation-operator.mdx) + +### ES2015 + +- [arrow-functions](plugin-transform-arrow-functions.mdx) +- [block-scoped-functions](plugin-transform-block-scoped-functions.mdx) +- [block-scoping](plugin-transform-block-scoping.mdx) +- [classes](plugin-transform-classes.mdx) +- [computed-properties](plugin-transform-computed-properties.mdx) +- [destructuring](plugin-transform-destructuring.mdx) +- [duplicate-keys](plugin-transform-duplicate-keys.mdx) +- [for-of](plugin-transform-for-of.mdx) +- [function-name](plugin-transform-function-name.mdx) +- [instanceof](plugin-transform-instanceof.mdx) +- [literals](plugin-transform-literals.mdx) +- [new-target](plugin-transform-new-target.mdx) +- [object-super](plugin-transform-object-super.mdx) +- [parameters](plugin-transform-parameters.mdx) +- [shorthand-properties](plugin-transform-shorthand-properties.mdx) +- [spread](plugin-transform-spread.mdx) +- [sticky-regex](plugin-transform-sticky-regex.mdx) +- [template-literals](plugin-transform-template-literals.mdx) +- [typeof-symbol](plugin-transform-typeof-symbol.mdx) +- [unicode-escapes](plugin-transform-unicode-escapes.mdx) +- [unicode-regex](plugin-transform-unicode-regex.mdx) + +### ES5 + +- [property-mutators](plugin-transform-property-mutators.mdx) + +### ES3 + +- [member-expression-literals](plugin-transform-member-expression-literals.mdx) +- [property-literals](plugin-transform-property-literals.mdx) +- [reserved-words](plugin-transform-reserved-words.mdx) + +### Module Formats + +- [modules-amd](plugin-transform-modules-amd.mdx) +- [modules-commonjs](plugin-transform-modules-commonjs.mdx) +- [modules-systemjs](plugin-transform-modules-systemjs.mdx) +- [modules-umd](plugin-transform-modules-umd.mdx) + +### React + +- [react-constant-elements](plugin-transform-react-constant-elements.mdx) +- [react-inline-elements](plugin-transform-react-inline-elements.mdx) + +#### React Preset + +- [react-display-name](plugin-transform-react-display-name.mdx) +- [react-jsx](plugin-transform-react-jsx.mdx) +- [react-jsx-compat](plugin-transform-react-jsx-compat.mdx) +- [react-jsx-self](plugin-transform-react-jsx-self.mdx) +- [react-jsx-source](plugin-transform-react-jsx-source.mdx) + +### Flow + +- [flow-strip-types](plugin-transform-flow-strip-types.mdx) + +### TypeScript + +- [typescript](plugin-transform-typescript.mdx) + +### Misc + +- [external-helpers](plugin-external-helpers.mdx) +- [jscript](plugin-transform-jscript.mdx) +- [object-assign](plugin-transform-object-assign.mdx) +- [object-set-prototype-of-to-assign](plugin-transform-object-set-prototype-of-to-assign.mdx) +- [proto-to-assign](plugin-transform-proto-to-assign.mdx) +- [regenerator](plugin-transform-regenerator.mdx) +- [runtime](plugin-transform-runtime.mdx) +- [strict-mode](plugin-transform-strict-mode.mdx) + +#### Syntax Only + +- [syntax-bigint](plugin-syntax-bigint.mdx) (ES2020) +- [syntax-dynamic-import](plugin-syntax-dynamic-import.mdx) (ES2020) +- [syntax-import-meta](plugin-syntax-import-meta.mdx) (ES2020) +- [syntax-top-level-await](plugin-syntax-top-level-await.mdx) (ES2022) diff --git a/docs/plugins.md b/docs/plugins.mdx similarity index 92% rename from docs/plugins.md rename to docs/plugins.mdx index 185270e049..62a569580b 100644 --- a/docs/plugins.md +++ b/docs/plugins.mdx @@ -3,13 +3,13 @@ id: plugins title: Plugins --- -Babel's code transformations are enabled by applying plugins (or [presets](presets.md)) to your [configuration file](config-files.md). +Babel's code transformations are enabled by applying plugins (or [presets](presets.mdx)) to your [configuration file](config-files.mdx).
## Using a Plugin -If the plugin is on [npm](https://www.npmjs.com/search?q=babel-plugin), you can pass in the name of the plugin and Babel will check that it's installed in `node_modules`. This is added to the [plugins](options.md#presets) config option, which takes an array. +If the plugin is on [npm](https://www.npmjs.com/search?q=babel-plugin), you can pass in the name of the plugin and Babel will check that it's installed in `node_modules`. This is added to the [plugins](options.mdx#presets) config option, which takes an array. ```json title="babel.config.json" { @@ -25,7 +25,7 @@ You can also specify a relative/absolute path to your plugin. } ``` -See [name normalization](options.md#name-normalization) for more specifics on configuring the path of a plugin or preset. +See [name normalization](options.mdx#name-normalization) for more specifics on configuring the path of a plugin or preset. ## Transform Plugins @@ -43,7 +43,7 @@ Most syntax is transformable by Babel. In rarer cases (if the transform isn't im You don't need to specify the syntax plugin if the corresponding transform plugin is used already, since it enables it automatically. ::: -Alternatively, you can also provide any [`plugins` option](parser.md#plugins) from the Babel parser: +Alternatively, you can also provide any [`plugins` option](parser.mdx#plugins) from the Babel parser: Your `.babelrc`: diff --git a/docs/polyfill.md b/docs/polyfill.mdx similarity index 84% rename from docs/polyfill.md rename to docs/polyfill.mdx index 349bea4ce5..1dbc9aea7a 100644 --- a/docs/polyfill.md +++ b/docs/polyfill.mdx @@ -18,7 +18,7 @@ Babel includes a [polyfill](0.25% market share (ignoring browsers without security updates like IE 10 and BlackBerry): @@ -72,13 +72,13 @@ For example, if you want to create a snapshot of a query run `npx browserslist - ## Options -For more information on setting options for a preset, refer to the [preset options](presets.md#preset-options) documentation. +For more information on setting options for a preset, refer to the [preset options](presets.mdx#preset-options) documentation. ### `targets` `string | Array | { [string]: string }`, defaults to the top-level `targets` option if no browserslist-related option is specified in `@babel/preset-env`'s docs, otherwise to `{}`. -For usage, refer to the [`targets` option](options.md#targets) documentation. +For usage, refer to the [`targets` option](options.mdx#targets) documentation. ### `bugfixes` @@ -109,7 +109,7 @@ This option has been removed in Babel 8. `@babel/preset-env` will always compile ### `loose`, `spec` :::danger -These options have been removed in Babel 8. Consider migrating to the top level [`assumptions`](assumptions.md), available since Babel 7.13. See ["Migrating from `@babel/preset-env`'s `"loose"` and `"spec"` modes"](assumptions.md#migrating-from-babelpreset-envs-loose-and-spec-modes) for the equivalent assumptions-based configuration, ready to be copied and pasted as a starting point. +These options have been removed in Babel 8. Consider migrating to the top level [`assumptions`](assumptions.mdx), available since Babel 7.13. See ["Migrating from `@babel/preset-env`'s `"loose"` and `"spec"` modes"](assumptions.mdx#migrating-from-babelpreset-envs-loose-and-spec-modes) for the equivalent assumptions-based configuration, ready to be copied and pasted as a starting point. ::: :::: @@ -123,7 +123,7 @@ These options have been removed in Babel 8. Consider migrating to the top level Enable more spec compliant, but potentially slower, transformations for any plugins in this preset that support them. :::caution -This option has been deprecated and will be removed in Babel 8. Consider migrating to the top level [`assumptions`](assumptions.md) available since Babel 7.13. See ["Migrating from `@babel/preset-env`'s `"loose"` and `"spec"` modes"](assumptions.md#migrating-from-babelpreset-envs-loose-and-spec-modes) for the equivalent assumptions-based configuration, ready to be copied and pasted as a starting point. +This option has been deprecated and will be removed in Babel 8. Consider migrating to the top level [`assumptions`](assumptions.mdx) available since Babel 7.13. See ["Migrating from `@babel/preset-env`'s `"loose"` and `"spec"` modes"](assumptions.mdx#migrating-from-babelpreset-envs-loose-and-spec-modes) for the equivalent assumptions-based configuration, ready to be copied and pasted as a starting point. ::: ### `loose` @@ -133,7 +133,7 @@ This option has been deprecated and will be removed in Babel 8. Consider migrati Enable ["loose" transformations](http://2ality.com/2015/12/babel6-loose-mode.html) for any plugins in this preset that allow them. :::caution -This option has been deprecated and will be removed in Babel 8. Consider migrating to the top level [`assumptions`](assumptions.md) available since Babel 7.13. See ["Migrating from `@babel/preset-env`'s `"loose"` and `"spec"` modes"](assumptions.md#migrating-from-babelpreset-envs-loose-and-spec-modes) for the equivalent assumptions-based configuration, ready to be copied and pasted as a starting point. +This option has been deprecated and will be removed in Babel 8. Consider migrating to the top level [`assumptions`](assumptions.mdx) available since Babel 7.13. See ["Migrating from `@babel/preset-env`'s `"loose"` and `"spec"` modes"](assumptions.mdx#migrating-from-babelpreset-envs-loose-and-spec-modes) for the equivalent assumptions-based configuration, ready to be copied and pasted as a starting point. ::: :::: @@ -148,7 +148,7 @@ Setting this to `false` will preserve ES modules. Use this only if you intend to #### `modules: "auto"` -By default `@babel/preset-env` uses [`caller`](options.md#caller) data to determine whether ES modules and module features (e.g. `import()`) should be transformed. Generally `caller` data will be specified in the bundler plugins (e.g. `babel-loader`, `@rollup/plugin-babel`) and thus it is not recommended to pass `caller` data yourself -- The passed `caller` may overwrite the one from bundler plugins and in the future you may get suboptimal results if bundlers supports new module features. +By default `@babel/preset-env` uses [`caller`](options.mdx#caller) data to determine whether ES modules and module features (e.g. `import()`) should be transformed. Generally `caller` data will be specified in the bundler plugins (e.g. `babel-loader`, `@rollup/plugin-babel`) and thus it is not recommended to pass `caller` data yourself -- The passed `caller` may overwrite the one from bundler plugins and in the future you may get suboptimal results if bundlers supports new module features. ### `debug` @@ -208,7 +208,7 @@ This option is useful if there is a bug in a native implementation, or a combina For example, Node 4 supports native classes but not spread. If `super` is used with a spread argument, then the `@babel/plugin-transform-classes` transform needs to be `include`d, as it is not possible to transpile a spread with `super` otherwise. :::note -The `include` and `exclude` options _only_ work with the [plugins included with this preset](https://github.com/babel/babel/blob/main/packages/babel-preset-env/src/available-plugins.ts); so, for example, including `@babel/plugin-proposal-do-expressions` or excluding `@babel/plugin-proposal-function-bind` will throw errors. To use a plugin _not_ included with this preset, add them to your ["plugins"](options.md#plugins) directly. +The `include` and `exclude` options _only_ work with the [plugins included with this preset](https://github.com/babel/babel/blob/main/packages/babel-preset-env/src/available-plugins.ts); so, for example, including `@babel/plugin-proposal-do-expressions` or excluding `@babel/plugin-proposal-function-bind` will throw errors. To use a plugin _not_ included with this preset, add them to your ["plugins"](options.mdx#plugins) directly. ::: ### `exclude` @@ -219,7 +219,7 @@ An array of plugins to always exclude/remove. The possible options are the same as the `include` option. -This option is useful for excluding a transform like `@babel/plugin-transform-regenerator`, for example if you are using another plugin like [fast-async](https://github.com/MatAtBread/fast-async) instead of [Babel's async-to-gen](plugin-transform-async-generator-functions.md). +This option is useful for excluding a transform like `@babel/plugin-transform-regenerator`, for example if you are using another plugin like [fast-async](https://github.com/MatAtBread/fast-async) instead of [Babel's async-to-gen](plugin-transform-async-generator-functions.mdx). ### `useBuiltIns` @@ -472,7 +472,7 @@ The [Browserslist environment](https://github.com/browserslist/browserslist#conf | `v7.9.0` | Include numeric separator |
-Toggles enabling support for builtin/feature proposals that have shipped in browsers. If your target environments have native support for a feature proposal, its matching parser syntax plugin is enabled instead of performing any transform. Note that this _does not_ enable the same transformations as [`@babel/preset-stage-3`](preset-stage-3.md), since proposals can continue to change before landing in browsers. +Toggles enabling support for builtin/feature proposals that have shipped in browsers. If your target environments have native support for a feature proposal, its matching parser syntax plugin is enabled instead of performing any transform. Note that this _does not_ enable the same transformations as [`@babel/preset-stage-3`](preset-stage-3.mdx), since proposals can continue to change before landing in browsers. The following are currently supported: @@ -494,7 +494,7 @@ These features were behind `shippedProposals` flag in older Babel versions. They - [Private field brand checks](https://github.com/tc39/proposal-private-fields-in-in) - [private methods](https://github.com/tc39/proposal-private-methods) -> You can read more about configuring preset options [here](./presets.md#preset-options) +> You can read more about configuring preset options [here](./presets.mdx#preset-options) ## Caveats diff --git a/docs/preset-es2015.md b/docs/preset-es2015.mdx similarity index 92% rename from docs/preset-es2015.md rename to docs/preset-es2015.mdx index 0a0ee8e9e1..31eb48860c 100644 --- a/docs/preset-es2015.md +++ b/docs/preset-es2015.mdx @@ -6,7 +6,7 @@ sidebar_label: es2015 :::danger As of Babel v6, all the yearly presets have been deprecated. -We recommend using [`@babel/preset-env`](preset-env.md) instead. +We recommend using [`@babel/preset-env`](preset-env.mdx) instead. ::: ## Install @@ -61,4 +61,4 @@ Setting this to `false` will not transform modules. Enable "spec" transformations for any plugins in this preset that allow them. -> You can read more about configuring preset options [here](./presets.md#preset-options) +> You can read more about configuring preset options [here](./presets.mdx#preset-options) diff --git a/docs/preset-es2016.md b/docs/preset-es2016.mdx similarity index 90% rename from docs/preset-es2016.md rename to docs/preset-es2016.mdx index f5006fa0bf..3b71813fdb 100644 --- a/docs/preset-es2016.md +++ b/docs/preset-es2016.mdx @@ -6,7 +6,7 @@ sidebar_label: es2016 :::danger As of Babel v6, all the yearly presets have been deprecated. -We recommend using [`@babel/preset-env`](preset-env.md) instead. +We recommend using [`@babel/preset-env`](preset-env.mdx) instead. ::: ## Install diff --git a/docs/preset-es2017.md b/docs/preset-es2017.mdx similarity index 90% rename from docs/preset-es2017.md rename to docs/preset-es2017.mdx index ada98c8072..5824fbec3d 100644 --- a/docs/preset-es2017.md +++ b/docs/preset-es2017.mdx @@ -6,7 +6,7 @@ sidebar_label: es2017 :::danger As of Babel v6, all the yearly presets have been deprecated. -We recommend using [`@babel/preset-env`](preset-env.md) instead. +We recommend using [`@babel/preset-env`](preset-env.mdx) instead. ::: ## Install diff --git a/docs/preset-flow.md b/docs/preset-flow.mdx similarity index 98% rename from docs/preset-flow.md rename to docs/preset-flow.mdx index 81667f122e..1e6f1def00 100644 --- a/docs/preset-flow.md +++ b/docs/preset-flow.mdx @@ -5,7 +5,7 @@ title: "@babel/preset-flow" This preset is recommended if you use [Flow](https://flow.org/en/docs/getting-started/), a static type checker for JavaScript code. It includes the following plugins: -- [@babel/plugin-transform-flow-strip-types](plugin-transform-flow-strip-types.md) +- [@babel/plugin-transform-flow-strip-types](plugin-transform-flow-strip-types.mdx) ## Example @@ -132,4 +132,4 @@ The [Hermes](https://hermesengine.dev/) team is maintaining an alternative Flow The Hermes parser does not currently attach comments to the AST. This can cause problems with transforms that depend on the presence of specific comments. ::: -> You can read more about configuring preset options [here](./presets.md#preset-options) +> You can read more about configuring preset options [here](./presets.mdx#preset-options) diff --git a/docs/preset-minify.md b/docs/preset-minify.mdx similarity index 99% rename from docs/preset-minify.md rename to docs/preset-minify.mdx index 18e97e238b..746530c752 100644 --- a/docs/preset-minify.md +++ b/docs/preset-minify.mdx @@ -165,4 +165,4 @@ tdz | Passed to [builtIns][builtIns], [evaluate][evaluate], [dea [typeConstructors]: babel-plugin-minify-type-constructors [undefinedToVoid]: babel-plugin-transform-undefined-to-void -> You can read more about configuring preset options [here](./presets.md#preset-options) +> You can read more about configuring preset options [here](./presets.mdx#preset-options) diff --git a/docs/preset-react.md b/docs/preset-react.mdx similarity index 91% rename from docs/preset-react.md rename to docs/preset-react.mdx index 81b6a87c9e..5ddd02df73 100644 --- a/docs/preset-react.md +++ b/docs/preset-react.mdx @@ -5,13 +5,13 @@ title: "@babel/preset-react" This preset includes the following plugins: -- [@babel/plugin-syntax-jsx](plugin-syntax-jsx.md) -- [@babel/plugin-transform-react-jsx](plugin-transform-react-jsx.md) -- [@babel/plugin-transform-react-display-name](plugin-transform-react-display-name.md) +- [@babel/plugin-syntax-jsx](plugin-syntax-jsx.mdx) +- [@babel/plugin-transform-react-jsx](plugin-transform-react-jsx.mdx) +- [@babel/plugin-transform-react-display-name](plugin-transform-react-display-name.mdx) -Automatic runtime (since `v7.9.0`) adds the functionality for these plugins automatically when the `development` option is enabled. If you have automatic runtime enabled, adding [@babel/plugin-transform-react-jsx-self](plugin-transform-react-jsx-self.md) or [@babel/plugin-transform-react-jsx-source](plugin-transform-react-jsx-source.md) will error. +Automatic runtime (since `v7.9.0`) adds the functionality for these plugins automatically when the `development` option is enabled. If you have automatic runtime enabled, adding [@babel/plugin-transform-react-jsx-self](plugin-transform-react-jsx-self.mdx) or [@babel/plugin-transform-react-jsx-source](plugin-transform-react-jsx-source.mdx) will error. -> Note: Flow syntax support is no longer enabled in v7. For that, you will need to add the [Flow preset](preset-flow.md). +> Note: Flow syntax support is no longer enabled in v7. For that, you will need to add the [Flow preset](preset-flow.mdx). ## Installation @@ -131,13 +131,13 @@ Decides which runtime to use. :::babel8 -`boolean`, defaults to `true` if Babel's [`envName`](./options.md#envname) id `"development"`, and `false` otherwise. +`boolean`, defaults to `true` if Babel's [`envName`](./options.mdx#envname) id `"development"`, and `false` otherwise. ::: This toggles behavior specific to development, such as adding `__source` and `__self`. -This is useful when combined with the [env option](options.md#env) configuration or [js config files](config-files.md#javascript). +This is useful when combined with the [env option](options.mdx#env) configuration or [js config files](config-files.mdx#javascript). :::babel8 @@ -247,4 +247,4 @@ module.exports = { } ``` -> You can read more about configuring preset options [here](./presets.md#preset-options) +> You can read more about configuring preset options [here](./presets.mdx#preset-options) diff --git a/docs/preset-stage-0.md b/docs/preset-stage-0.mdx similarity index 98% rename from docs/preset-stage-0.md rename to docs/preset-stage-0.mdx index 28e4d47e98..097459c796 100644 --- a/docs/preset-stage-0.md +++ b/docs/preset-stage-0.mdx @@ -61,4 +61,4 @@ Will use the native built-in instead of trying to polyfill behavior for any plug Use the legacy (stage 1) decorators syntax and behavior. -> You can read more about configuring preset options [here](./presets.md#preset-options) +> You can read more about configuring preset options [here](./presets.mdx#preset-options) diff --git a/docs/preset-stage-1.md b/docs/preset-stage-1.mdx similarity index 100% rename from docs/preset-stage-1.md rename to docs/preset-stage-1.mdx diff --git a/docs/preset-stage-2.md b/docs/preset-stage-2.mdx similarity index 98% rename from docs/preset-stage-2.md rename to docs/preset-stage-2.mdx index b008a144b8..aaca30591a 100644 --- a/docs/preset-stage-2.md +++ b/docs/preset-stage-2.mdx @@ -71,7 +71,7 @@ Will use the native built-in instead of trying to polyfill behavior for any plug Use the legacy (stage 1) decorators syntax and behavior. -> You can read more about configuring preset options [here](./presets.md#preset-options) +> You can read more about configuring preset options [here](./presets.mdx#preset-options) ## References diff --git a/docs/preset-stage-3.md b/docs/preset-stage-3.mdx similarity index 98% rename from docs/preset-stage-3.md rename to docs/preset-stage-3.mdx index e94dd59cdf..0f6da4cfce 100644 --- a/docs/preset-stage-3.md +++ b/docs/preset-stage-3.mdx @@ -65,7 +65,7 @@ Enable "loose" transformations for any plugins in this preset that allow them. Will use the native built-in instead of trying to polyfill behavior for any plugins that require one. -> You can read more about configuring preset options [here](./presets.md#preset-options) +> You can read more about configuring preset options [here](./presets.mdx#preset-options) ## References diff --git a/docs/preset-typescript.md b/docs/preset-typescript.mdx similarity index 98% rename from docs/preset-typescript.md rename to docs/preset-typescript.mdx index 0d101420d9..158d6a6112 100644 --- a/docs/preset-typescript.md +++ b/docs/preset-typescript.mdx @@ -5,7 +5,7 @@ title: "@babel/preset-typescript" This preset is recommended if you use [TypeScript](https://www.typescriptlang.org/docs/handbook/typescript-in-5-minutes.html), a typed superset of JavaScript. It includes the following plugins: -- [@babel/plugin-transform-typescript](plugin-transform-typescript.md) +- [@babel/plugin-transform-typescript](plugin-transform-typescript.mdx) > You will need to specify `--extensions ".ts"` for `@babel/cli` & `@babel/node` cli's to handle `.ts` files. @@ -90,7 +90,7 @@ Indicates that every file should be parsed as TS, TSX, or as TS without JSX ambi ### `allowNamespaces` -`boolean`, uses the default set by [`@babel/plugin-transform-typescript`](./plugin-transform-typescript.md#allownamespaces). +`boolean`, uses the default set by [`@babel/plugin-transform-typescript`](./plugin-transform-typescript.mdx#allownamespaces). Added in: `v7.6.0` @@ -195,7 +195,7 @@ export var Animals = { }; ``` -> You can read more about configuring preset options [here](./presets.md#preset-options). +> You can read more about configuring preset options [here](./presets.mdx#preset-options). ### `rewriteImportExtensions` diff --git a/docs/presets.md b/docs/presets.mdx similarity index 83% rename from docs/presets.md rename to docs/presets.mdx index 4d764ba3b1..42af92b7e3 100644 --- a/docs/presets.md +++ b/docs/presets.mdx @@ -3,16 +3,16 @@ id: presets title: Presets --- -Babel presets can act as sharable set of Babel plugins and/or config [`options`](options.md). +Babel presets can act as sharable set of Babel plugins and/or config [`options`](options.mdx). ## Official Presets We've assembled a few presets for common environments: -- [@babel/preset-env](preset-env.md) for compiling ES2015+ syntax -- [@babel/preset-typescript](preset-typescript.md) for [TypeScript](https://www.typescriptlang.org) -- [@babel/preset-react](preset-react.md) for [React](https://reactjs.org/) -- [@babel/preset-flow](preset-flow.md) for [Flow](https://flow.org/) +- [@babel/preset-env](preset-env.mdx) for compiling ES2015+ syntax +- [@babel/preset-typescript](preset-typescript.mdx) for [TypeScript](https://www.typescriptlang.org) +- [@babel/preset-react](preset-react.mdx) for [React](https://reactjs.org/) +- [@babel/preset-flow](preset-flow.mdx) for [Flow](https://flow.org/) ## Other Integrations @@ -24,7 +24,7 @@ If you aren't using Babel directly, the framework you are using may have its own ## Using a Preset -Within a Babel config, if the preset is on [npm](https://www.npmjs.com/search?q=babel-preset), you can pass in the name of the preset and Babel will check that it's installed in `node_modules` already. This is added to the [presets](options.md#presets) config option, which takes an array. +Within a Babel config, if the preset is on [npm](https://www.npmjs.com/search?q=babel-preset), you can pass in the name of the preset and Babel will check that it's installed in `node_modules` already. This is added to the [presets](options.mdx#presets) config option, which takes an array. ```json title="babel.config.json" { @@ -40,7 +40,7 @@ Otherwise, you can also specify a relative or absolute path to your presets. } ``` -See [name normalization](options.md#name-normalization) for more specifics on configuring the path of a plugin or preset. +See [name normalization](options.mdx#name-normalization) for more specifics on configuring the path of a plugin or preset. ## Stage-X (Experimental Presets) @@ -52,10 +52,10 @@ Any transforms in stage-x presets are changes to the language that haven't been The [TC39](https://github.com/tc39) categorizes proposals into the following stages: -- [Stage 0](preset-stage-0.md) - Strawman: just an idea, possible Babel plugin. -- [Stage 1](preset-stage-1.md) - Proposal: this is worth working on. -- [Stage 2](preset-stage-2.md) - Draft: initial spec. -- [Stage 3](preset-stage-3.md) - Candidate: complete spec and initial browser implementations. +- [Stage 0](preset-stage-0.mdx) - Strawman: just an idea, possible Babel plugin. +- [Stage 1](preset-stage-1.mdx) - Proposal: this is worth working on. +- [Stage 2](preset-stage-2.mdx) - Draft: initial spec. +- [Stage 3](preset-stage-3.mdx) - Candidate: complete spec and initial browser implementations. - Stage 4 - Finished: will be added to the next yearly release. For more information, be sure to check out the [current TC39 proposals](https://github.com/tc39/proposals) and its [process document](https://tc39.github.io/process-document). diff --git a/docs/register.md b/docs/register.mdx similarity index 93% rename from docs/register.md rename to docs/register.mdx index 7352380bd3..cda21f27b3 100644 --- a/docs/register.md +++ b/docs/register.mdx @@ -24,7 +24,7 @@ All subsequent files required by node with the extensions `.es6`, `.es`, `.jsx`, `.mjs`, and `.js` will be transformed by Babel. :::info Polyfill not included -You must include the [polyfill](./polyfill.md) separately +You must include the [polyfill](./polyfill.mdx) separately when using features that require it, like generators. ::: @@ -79,8 +79,8 @@ require("@babel/register")({ }); ``` -You can pass in all other [options](options.md) as well, including `plugins` and `presets`. -Note that [config files](config-files.md) will also be loaded and the programmatic +You can pass in all other [options](options.mdx) as well, including `plugins` and `presets`. +Note that [config files](config-files.mdx) will also be loaded and the programmatic config will be merged over top of the file config options. `@babel/register` does not support `ignore` and `only` in config files. @@ -147,7 +147,7 @@ You can also test the new experimental implementation that will be enabled by de require("@babel/register/experimental-worker"); ``` -It internally runs Babel asynchronously, so it's compatible with [`.mjs` configuration files](config-files.md#configuration-file-types). You can already use it as a replacement of `@babel/register` with a few caveats: +It internally runs Babel asynchronously, so it's compatible with [`.mjs` configuration files](config-files.mdx#configuration-file-types). You can already use it as a replacement of `@babel/register` with a few caveats: - If you programmatically specify `@babel/register` options (using `require("@babel/register")({ /* ... options */ })`), you must make sure that they are serializable. This means that you cannot pass plugin functions defined inline, but you must move them to a separate `./my-plugin.js` file or to a `babel.config.js` file. - The new implementation is still experimental: it _should_ have the same features as the existing one, but there may be some new bugs and regressions. diff --git a/docs/roadmap.md b/docs/roadmap.mdx similarity index 98% rename from docs/roadmap.md rename to docs/roadmap.mdx index b01caabb0d..aa354b6e64 100644 --- a/docs/roadmap.md +++ b/docs/roadmap.mdx @@ -103,7 +103,7 @@ This goal can be split into two big tasks that can be done in parallel: ### Investigate new compiler `assumptions` -In Babel 7.13.0 we introduced a new top-level [`assumptions`](./options.md#assumptions) option, to formalize what the `loose` mode option does and offer more granular control to our users (since often they can only enable _some_ assumptions and not all of them). +In Babel 7.13.0 we introduced a new top-level [`assumptions`](./options.mdx#assumptions) option, to formalize what the `loose` mode option does and offer more granular control to our users (since often they can only enable _some_ assumptions and not all of them). However, we only included options for assumptions we _already_ made when compiling in `loose` mode. We can now investigate what new assumptions our users might need. @@ -146,7 +146,7 @@ Some things already in progress Henry has been working on and off on: For an interactive example of what we are thinking about: https://babel-explorer.netlify.app/ (click and hold the mouse in the bottom sector!) - +*/} diff --git a/docs/runtime-corejs2.md b/docs/runtime-corejs2.mdx similarity index 93% rename from docs/runtime-corejs2.md rename to docs/runtime-corejs2.mdx index 0e97f7e48f..19eb71b477 100644 --- a/docs/runtime-corejs2.md +++ b/docs/runtime-corejs2.mdx @@ -12,11 +12,11 @@ sidebar_label: runtime-corejs2 npm install --save @babel/runtime-corejs2 ``` -> See also: [`@babel/runtime`](runtime.md). +> See also: [`@babel/runtime`](runtime.mdx). ## Usage -This is meant to be used as a runtime `dependency` along with the Babel plugin [`@babel/plugin-transform-runtime`](plugin-transform-runtime.md). Please check out the documentation in that package for usage. +This is meant to be used as a runtime `dependency` along with the Babel plugin [`@babel/plugin-transform-runtime`](plugin-transform-runtime.mdx). Please check out the documentation in that package for usage. ## Why diff --git a/docs/runtime.md b/docs/runtime.mdx similarity index 89% rename from docs/runtime.md rename to docs/runtime.mdx index c0eb6bf79c..c44088d0fe 100644 --- a/docs/runtime.md +++ b/docs/runtime.mdx @@ -11,11 +11,11 @@ title: "@babel/runtime" npm install --save @babel/runtime ``` -> See also: [`@babel/runtime-corejs2`](runtime-corejs2.md). +> See also: [`@babel/runtime-corejs2`](runtime-corejs2.mdx). ## Usage -This is meant to be used as a runtime `dependency` along with the Babel plugin [`@babel/plugin-transform-runtime`](plugin-transform-runtime.md). Please check out the documentation in that package for usage. +This is meant to be used as a runtime `dependency` along with the Babel plugin [`@babel/plugin-transform-runtime`](plugin-transform-runtime.mdx). Please check out the documentation in that package for usage. ## Why diff --git a/docs/standalone.md b/docs/standalone.mdx similarity index 92% rename from docs/standalone.md rename to docs/standalone.mdx index 8383394c80..3f371870d1 100644 --- a/docs/standalone.md +++ b/docs/standalone.mdx @@ -64,7 +64,7 @@ Use the `data-presets` attributes to enable builtin Babel presets. Multiple valu ```html diff --git a/website/blog/2015-10-31-setting-up-babel-6.md b/website/blog/2015-10-31-setting-up-babel-6.mdx similarity index 99% rename from website/blog/2015-10-31-setting-up-babel-6.md rename to website/blog/2015-10-31-setting-up-babel-6.mdx index e4e64d5120..31e9a85540 100644 --- a/website/blog/2015-10-31-setting-up-babel-6.md +++ b/website/blog/2015-10-31-setting-up-babel-6.mdx @@ -11,7 +11,7 @@ Babel 6 is fresh off the press and weโ€™re still getting a lot sorted out. In th However, the documentation is still lacking at this point, Iโ€™m currently going through and creating an entirely new โ€œGetting Startedโ€ section of the site. - +{/* truncate */} This blog post will cover most of the basics until thatโ€™s completed. diff --git a/website/blog/2015-11-03-babel-doctor.md b/website/blog/2015-11-03-babel-doctor.mdx similarity index 98% rename from website/blog/2015-11-03-babel-doctor.md rename to website/blog/2015-11-03-babel-doctor.mdx index 3922a2bcc4..993c279a05 100644 --- a/website/blog/2015-11-03-babel-doctor.md +++ b/website/blog/2015-11-03-babel-doctor.mdx @@ -15,7 +15,7 @@ share_text: "Babel Doctor" > babel-doctor has been removed as of v6.18.0 of `babel-cli`. If anyone needs it we will bring it back as a standalone npm module called `babel-doctor`. - +{/* truncate */} We launched [Babel 6](https://babeljs.io/blog/2015/10/29/6.0.0/) last week. This was a pretty big change from the previous batteries included Babel and with it came a host of diff --git a/website/blog/2016-08-24-6.14.0.md b/website/blog/2016-08-24-6.14.0.mdx similarity index 99% rename from website/blog/2016-08-24-6.14.0.md rename to website/blog/2016-08-24-6.14.0.mdx index 072418dd2d..86798be581 100644 --- a/website/blog/2016-08-24-6.14.0.md +++ b/website/blog/2016-08-24-6.14.0.mdx @@ -9,7 +9,7 @@ share_text: "6.14.0" A new `es2017`, `latest` preset, and lots of fixes in this release. - +{/* truncate */} It's been a while since the last post! If you haven't seen it, we started posting some notes at [babel/notes](https://github.com/babel/notes). diff --git a/website/blog/2016-08-26-babili.md b/website/blog/2016-08-26-babili.mdx similarity index 99% rename from website/blog/2016-08-26-babili.md rename to website/blog/2016-08-26-babili.mdx index 2b017732cf..915088a3c1 100644 --- a/website/blog/2016-08-26-babili.md +++ b/website/blog/2016-08-26-babili.mdx @@ -11,7 +11,7 @@ We released [Babili](https://github.com/babel/babili) as beta (0.0.1) a few days > Try it out in the Babel [REPL](http://babeljs.io/repl/#?babili=true&evaluate=false) and report any bugs or potential optimizations we can make! There's also a [#minify](https://babeljs.slack.com/messages/minify/) slack room! - +{/* truncate */} There are a lot of (valid) questions about why a new minifier is a good idea, so this post should help with that. diff --git a/website/blog/2016-09-28-6.16.0.md b/website/blog/2016-09-28-6.16.0.mdx similarity index 99% rename from website/blog/2016-09-28-6.16.0.md rename to website/blog/2016-09-28-6.16.0.mdx index da95e6a0bc..5e661a5a57 100644 --- a/website/blog/2016-09-28-6.16.0.md +++ b/website/blog/2016-09-28-6.16.0.mdx @@ -11,7 +11,7 @@ share_text: "6.16.0" Happy Birthday Babel ๐ŸŽ‚ !

- +{/* truncate */} diff --git a/website/blog/2016-10-24-6.18.0.md b/website/blog/2016-10-24-6.18.0.mdx similarity index 99% rename from website/blog/2016-10-24-6.18.0.md rename to website/blog/2016-10-24-6.18.0.mdx index af6cd0e458..1fd312d340 100644 --- a/website/blog/2016-10-24-6.18.0.md +++ b/website/blog/2016-10-24-6.18.0.mdx @@ -9,7 +9,7 @@ share_text: "6.18.0" More flow updates, and lots of fixes! - +{/* truncate */} We've added 4 new collaborators to Babel since the last release! diff --git a/website/blog/2016-11-16-6.19.0.md b/website/blog/2016-11-16-6.19.0.mdx similarity index 99% rename from website/blog/2016-11-16-6.19.0.md rename to website/blog/2016-11-16-6.19.0.mdx index 9ad47c312a..5b79907356 100644 --- a/website/blog/2016-11-16-6.19.0.md +++ b/website/blog/2016-11-16-6.19.0.mdx @@ -9,7 +9,7 @@ share_text: "6.19.0" `object-rest-spread` works standalone and a few new plugin options APIs were added! - +{/* truncate */} ## v6.19.0 Summary (2016-11-16) diff --git a/website/blog/2016-12-07-the-state-of-babel.md b/website/blog/2016-12-07-the-state-of-babel.mdx similarity index 99% rename from website/blog/2016-12-07-the-state-of-babel.md rename to website/blog/2016-12-07-the-state-of-babel.mdx index 17787dff65..6790305c0f 100644 --- a/website/blog/2016-12-07-the-state-of-babel.md +++ b/website/blog/2016-12-07-the-state-of-babel.mdx @@ -16,7 +16,7 @@ custom_js_with_timestamps: - [The Future](https://babeljs.io/blog/2016/12/07/the-state-of-babel#the-future) - [Community](https://babeljs.io/blog/2016/12/07/the-state-of-babel#community) - +{/* truncate */} > Previous issues: [Babel Roadmap #4130](https://github.com/babel/babel/issues/4130), [6.0 #2168](https://github.com/babel/babel/issues/2168) diff --git a/website/blog/2017-02-13-6.23.0.md b/website/blog/2017-02-13-6.23.0.mdx similarity index 99% rename from website/blog/2017-02-13-6.23.0.md rename to website/blog/2017-02-13-6.23.0.mdx index 1a1c88efd9..0c7d3c0f96 100644 --- a/website/blog/2017-02-13-6.23.0.md +++ b/website/blog/2017-02-13-6.23.0.mdx @@ -9,7 +9,7 @@ share_text: "6.23.0" In this release: multiple improvements to the `react-constant-elements` plugin by [@STRML](https://github.com/STRML), some codegen optimizations, and lots of bug fixes! Thanks to [@loganfsmyth](https://github.com/loganfsmyth) for the release + reviews! - +{/* truncate */} > Shoutouts to [@xtina-starr](https://github.com/xtina-starr), [@finkef](https://github.com/finkef), [@chitchu](https://github.com/chitchu), [@yongxu](https://github.com/yongxu), [@jwbay](https://github.com/jwbay), [@hex13](https://github.com/hex13) for their first PRs! ๐ŸŽ‰ diff --git a/website/blog/2017-03-01-upgrade-to-babel-7-for-tool-authors.md b/website/blog/2017-03-01-upgrade-to-babel-7-for-tool-authors.mdx similarity index 96% rename from website/blog/2017-03-01-upgrade-to-babel-7-for-tool-authors.md rename to website/blog/2017-03-01-upgrade-to-babel-7-for-tool-authors.mdx index 7829722b59..8e01a58580 100644 --- a/website/blog/2017-03-01-upgrade-to-babel-7-for-tool-authors.md +++ b/website/blog/2017-03-01-upgrade-to-babel-7-for-tool-authors.mdx @@ -16,6 +16,6 @@ We are moving the migration guide to a docs page instead of a blog post! ## Check out [v7-migration-api](https://babeljs.io/docs/en/next/v7-migration-api)! - +{/* truncate */} Refer users to this document for those that create tools that depend on Babel (such as Babel plugins). diff --git a/website/blog/2017-03-01-upgrade-to-babel-7.md b/website/blog/2017-03-01-upgrade-to-babel-7.mdx similarity index 96% rename from website/blog/2017-03-01-upgrade-to-babel-7.md rename to website/blog/2017-03-01-upgrade-to-babel-7.mdx index 5342693d30..f4f6d710a1 100644 --- a/website/blog/2017-03-01-upgrade-to-babel-7.md +++ b/website/blog/2017-03-01-upgrade-to-babel-7.mdx @@ -15,4 +15,4 @@ We are moving the migration guide to a docs page instead of a blog post! ## Check out [v7-migration](https://babeljs.io/docs/en/next/v7-migration)! - \ No newline at end of file +{/* truncate */} diff --git a/website/blog/2017-08-09-babel-and-summer-of-code.md b/website/blog/2017-08-09-babel-and-summer-of-code.mdx similarity index 99% rename from website/blog/2017-08-09-babel-and-summer-of-code.md rename to website/blog/2017-08-09-babel-and-summer-of-code.mdx index d55c66a6ce..4f0575b0c0 100644 --- a/website/blog/2017-08-09-babel-and-summer-of-code.md +++ b/website/blog/2017-08-09-babel-and-summer-of-code.mdx @@ -14,7 +14,7 @@ custom_js_with_timestamps: For the first time, Babel is participating in *Summer of Code*! Although we forgot to make an announcement post earlier, here's our progress update ๐Ÿ˜Š - +{/* truncate */} ## What is it? diff --git a/website/blog/2017-08-11-gsoc-peey-1.md b/website/blog/2017-08-11-gsoc-peey-1.mdx similarity index 99% rename from website/blog/2017-08-11-gsoc-peey-1.md rename to website/blog/2017-08-11-gsoc-peey-1.mdx index 70c29a2e6a..1b2c11fbdb 100644 --- a/website/blog/2017-08-11-gsoc-peey-1.md +++ b/website/blog/2017-08-11-gsoc-peey-1.mdx @@ -14,7 +14,7 @@ week at Babylon โ€” the parser for Babel. If you donโ€™t know what a decorator i the gist of it is that a decorator gives some concise syntax to affect the definition of a class or a class method which you decorate. - +{/* truncate */} ```js title="JavaScript" @frozen class Foo { diff --git a/website/blog/2017-08-16-gsoc-karl-1.md b/website/blog/2017-08-16-gsoc-karl-1.mdx similarity index 99% rename from website/blog/2017-08-16-gsoc-karl-1.md rename to website/blog/2017-08-16-gsoc-karl-1.mdx index 41632727d0..ec5eac1b54 100644 --- a/website/blog/2017-08-16-gsoc-karl-1.md +++ b/website/blog/2017-08-16-gsoc-karl-1.mdx @@ -14,7 +14,7 @@ Iโ€™ve been working with Babel as part of the Google Summer of Code 2017 program Hereโ€™s a few things Iโ€™ve learnt from my adventures so far. - +{/* truncate */} ## 1. Yes, communication is important diff --git a/website/blog/2017-09-11-zero-config-with-babel-macros.md b/website/blog/2017-09-11-zero-config-with-babel-macros.mdx similarity index 99% rename from website/blog/2017-09-11-zero-config-with-babel-macros.md rename to website/blog/2017-09-11-zero-config-with-babel-macros.mdx index d7897c08f9..1b7d603957 100644 --- a/website/blog/2017-09-11-zero-config-with-babel-macros.md +++ b/website/blog/2017-09-11-zero-config-with-babel-macros.mdx @@ -18,7 +18,7 @@ guest_description: | Babel started out as a transpiler to let you write the latest version of the ECMAScript specification but ship to environments that don't implement those features yet. But it has become much more than that. ["Compilers are the New Frameworks"](https://tomdale.net/2017/09/compilers-are-the-new-frameworks/) says [Tom Dale](https://twitter.com/tomdale) and I could not agree more. We're seeing more and more compile-time optimizations for libraries and frameworks. I'm not talking about syntax extensions to the language, but simple code transformations that enable patterns that would be difficult to accomplish otherwise. - +{/* truncate */} One of my favorite things about compiler plugins is that you can use them to optimize the user experience and developer experience at the same time. (Read more about ["How writing custom Babel & ESLint plugins can increase productivity & improve user experience"](https://kentcdodds.com/blog/how-writing-custom-babel-and-eslint-plugins-can-increase-productivity-and-improve-user-experience)). diff --git a/website/blog/2017-09-12-planning-for-7.0.md b/website/blog/2017-09-12-planning-for-7.0.mdx similarity index 99% rename from website/blog/2017-09-12-planning-for-7.0.md rename to website/blog/2017-09-12-planning-for-7.0.mdx index 810236a74f..f17ce695ee 100644 --- a/website/blog/2017-09-12-planning-for-7.0.md +++ b/website/blog/2017-09-12-planning-for-7.0.mdx @@ -9,7 +9,7 @@ share_text: "Planning for 7.0" If you didn't know already, we're planning on releasing a 7.0 version soon ๐Ÿ™Œ ! Work on it actually started back in February, when I just wanted to make a release to drop Node 0.10/0.12 support and remove babel-runtime and various other code. And since then, we've done releases up to `alpha.20`. - +{/* truncate */} > We're going to update this post throughout the beta releases diff --git a/website/blog/2017-10-05-babel-turns-three.md b/website/blog/2017-10-05-babel-turns-three.mdx similarity index 99% rename from website/blog/2017-10-05-babel-turns-three.md rename to website/blog/2017-10-05-babel-turns-three.mdx index c79edbf5f9..d87ff264be 100644 --- a/website/blog/2017-10-05-babel-turns-three.md +++ b/website/blog/2017-10-05-babel-turns-three.mdx @@ -11,7 +11,7 @@ share_text: "Babel Turns Three" Babel has really come a long way since [Sebastian](https://github.com/kittens) started the project only 3 years ago! A while back it was renamed from [6to5 to Babel](https://babeljs.io/blog/2015/02/15/not-born-to-die); for good reason as it has significantly contributed to the use of ES2015+ by [many companies](https://babeljs.io/users), libraries, and developers alike. - +{/* truncate */} And now it's even helping move the language forward by supporting the proposals coming from TC39. We're looking forward to being able to participate more in [TC39 meetings](https://twitter.com/loganfsmyth/status/844252727186149377). diff --git a/website/blog/2017-12-27-nearing-the-7.0-release.md b/website/blog/2017-12-27-nearing-the-7.0-release.mdx similarity index 99% rename from website/blog/2017-12-27-nearing-the-7.0-release.md rename to website/blog/2017-12-27-nearing-the-7.0-release.mdx index 1fbf3ab968..0075ca1a9b 100644 --- a/website/blog/2017-12-27-nearing-the-7.0-release.md +++ b/website/blog/2017-12-27-nearing-the-7.0-release.mdx @@ -9,7 +9,7 @@ share_text: "Nearing the 7.0 Release" > Check out [Planning for 7.0](https://babeljs.io/blog/2017/09/12/planning-for-7.0) for the last updates throughout the 7.0 pre-releases. If something isn't clear in this post let me know! - +{/* truncate */} ## Project Updates diff --git a/website/blog/2018-06-26-on-consuming-and-publishing-es2015+-packages.md b/website/blog/2018-06-26-on-consuming-and-publishing-es2015+-packages.mdx similarity index 99% rename from website/blog/2018-06-26-on-consuming-and-publishing-es2015+-packages.md rename to website/blog/2018-06-26-on-consuming-and-publishing-es2015+-packages.mdx index dbd9c63c91..81272b2ca8 100644 --- a/website/blog/2018-06-26-on-consuming-and-publishing-es2015+-packages.md +++ b/website/blog/2018-06-26-on-consuming-and-publishing-es2015+-packages.mdx @@ -11,7 +11,7 @@ For those of us that need to support older browsers, we run a compiler like Babe Can we make compiling our dependencies not just possible, but normal? - +{/* truncate */} The ability to compile dependencies is an enabling feature request for the whole ecosystem. Starting with some of the changes we made in Babel v7 to make selective dependency compilation possible, we hope to see it standardized moving forward. diff --git a/website/blog/2018-07-16-announcing-babels-new-partnership-with-trivago.md b/website/blog/2018-07-16-announcing-babels-new-partnership-with-trivago.mdx similarity index 99% rename from website/blog/2018-07-16-announcing-babels-new-partnership-with-trivago.md rename to website/blog/2018-07-16-announcing-babels-new-partnership-with-trivago.mdx index fe02e4c142..861f1c260a 100644 --- a/website/blog/2018-07-16-announcing-babels-new-partnership-with-trivago.md +++ b/website/blog/2018-07-16-announcing-babels-new-partnership-with-trivago.mdx @@ -9,7 +9,7 @@ share_text: "Announcing Babel's New Partnership with trivago!" We are happy to announce a new partnership with [trivago](https://www.trivago.com/), the hotel search website. - +{/* truncate */} They've committed to fund our community with $2,000 per month, for a total of $24,000 per year! diff --git a/website/blog/2018-07-19-whats-happening-with-the-pipeline-proposal.md b/website/blog/2018-07-19-whats-happening-with-the-pipeline-proposal.mdx similarity index 99% rename from website/blog/2018-07-19-whats-happening-with-the-pipeline-proposal.md rename to website/blog/2018-07-19-whats-happening-with-the-pipeline-proposal.mdx index b44cd0e157..2034d9b265 100644 --- a/website/blog/2018-07-19-whats-happening-with-the-pipeline-proposal.md +++ b/website/blog/2018-07-19-whats-happening-with-the-pipeline-proposal.mdx @@ -9,7 +9,7 @@ share_text: "What's Happening With the Pipeline (|>) Proposal?" With the release of [babel@7.0.0-beta52](https://github.com/babel/babel/releases/tag/v7.0.0-beta.52), we introduced a new required configuration flag to `@babel/plugin-proposal-pipeline-operator`, a breaking change for the pipeline operator. To clear up any confusion, let's take a look at the pipeline proposal and why we needed to introduce this configuration option. - +{/* truncate */} ## Current Status diff --git a/website/blog/2018-07-27-removing-babels-stage-presets.md b/website/blog/2018-07-27-removing-babels-stage-presets.mdx similarity index 99% rename from website/blog/2018-07-27-removing-babels-stage-presets.md rename to website/blog/2018-07-27-removing-babels-stage-presets.mdx index 93dbb868b1..80e3588245 100644 --- a/website/blog/2018-07-27-removing-babels-stage-presets.md +++ b/website/blog/2018-07-27-removing-babels-stage-presets.mdx @@ -11,7 +11,7 @@ Moving forward with v7, we've decided it's best to stop publishing the Stage pre We didn't make this decision lightly and wanted to show the context behind the interplay between TC39, Babel, and the community. - +{/* truncate */} ## Some History diff --git a/website/blog/2018-08-27-7.0.0.md b/website/blog/2018-08-27-7.0.0.mdx similarity index 99% rename from website/blog/2018-08-27-7.0.0.md rename to website/blog/2018-08-27-7.0.0.mdx index d2fdd53e65..d60f3fd23e 100644 --- a/website/blog/2018-08-27-7.0.0.md +++ b/website/blog/2018-08-27-7.0.0.mdx @@ -9,7 +9,7 @@ share_text: "Babel 7 Released" After almost 2 years, 4k commits, over 50 pre-releases, and a lot of help we are excited to announce the release of Babel 7. It's been almost [3 years](https://babeljs.io/blog/2015/10/29/6.0.0) since the release of Babel 6! There's a lot of moving parts so please bear with us in the first weeks of release. Babel 7 is a huge release: we've made it faster, created an upgrade tool, JS configs, config "overrides", more options for size/minification, JSX Fragments, TypeScript, new proposals, and more! - +{/* truncate */} > If you appreciate the work we're doing on Babel, you can sponsor Babel on [Open Collective](https://opencollective.com/babel), support me on [Patreon](https://www.patreon.com/henryzhu), or get you or your company involved with Babel as part of work. We'd appreciate the collective ownership of this vital project in the JavaScript community! diff --git a/website/blog/2018-09-17-7.1.0.md b/website/blog/2018-09-17-7.1.0.mdx similarity index 98% rename from website/blog/2018-09-17-7.1.0.md rename to website/blog/2018-09-17-7.1.0.mdx index 3b92d9837f..be18074b76 100644 --- a/website/blog/2018-09-17-7.1.0.md +++ b/website/blog/2018-09-17-7.1.0.mdx @@ -9,11 +9,11 @@ share_text: "Babel 7.1.0 Released" There's already another release! 7.1.0 includes support for Stage 2 Decorators and adds support for Stage 3 Private Static Fields as well as some various bug fixes. - +{/* truncate */} > If you didn't see earlier, we released [7.0](https://babeljs.io/blog/2018/08/27/7.0.0)! - +{/* link to github release/changelog */} ## Decorators (Stage 2) diff --git a/website/blog/2018-09-17-decorators.md b/website/blog/2018-09-17-decorators.mdx similarity index 99% rename from website/blog/2018-09-17-decorators.md rename to website/blog/2018-09-17-decorators.mdx index 4145a60577..cb0a28a298 100644 --- a/website/blog/2018-09-17-decorators.md +++ b/website/blog/2018-09-17-decorators.mdx @@ -9,7 +9,7 @@ share_text: "TC39 Standards Track Decorators in Babel" Babel 7.1.0 finally supports the new decorators proposal: you can try it out by using the [`@babel/plugin-proposal-decorators`](https://babeljs.io/docs/en/babel-plugin-proposal-decorators) plugin ๐ŸŽ‰. - +{/* truncate */} ## A Bit of History diff --git a/website/blog/2018-12-03-7.2.0.md b/website/blog/2018-12-03-7.2.0.mdx similarity index 99% rename from website/blog/2018-12-03-7.2.0.md rename to website/blog/2018-12-03-7.2.0.mdx index 1a582cba74..14bb71e72b 100644 --- a/website/blog/2018-12-03-7.2.0.md +++ b/website/blog/2018-12-03-7.2.0.mdx @@ -11,7 +11,7 @@ We just released a new minor version of Babel! This release includes support for private instance methods and a bunch of bug fixes regarding Flow and TypeScript types. You can read the whole changelog [on GitHub](https://github.com/babel/babel/releases/tag/v7.2.0). - +{/* truncate */} A lot of new contributors fixed bugs or implemented new features in this release: thanks to [Gcaufy](https://github.com/Gcaufy), [Grigory Moroz](https://github.com/morozRed), [Paul Happ](https://github.com/phapp88), [Tim McClure](https://github.com/tim-mc) and [Veaceslav Cotruta](https://github.com/katrotz)! diff --git a/website/blog/2019-01-21-7.3.0.md b/website/blog/2019-01-21-7.3.0.mdx similarity index 99% rename from website/blog/2019-01-21-7.3.0.md rename to website/blog/2019-01-21-7.3.0.mdx index 5978e7cb0d..5fddb8c572 100644 --- a/website/blog/2019-01-21-7.3.0.md +++ b/website/blog/2019-01-21-7.3.0.mdx @@ -11,7 +11,7 @@ After over 80 commits, the latest Babel minor release is here! This release includes support for named capturing groups in regular expressions, private instance accessors, the smart pipeline operator and a bunch of improvements to TypeScript parsing. You can read the whole changelog [on GitHub](https://github.com/babel/babel/releases/tag/v7.3.0). - +{/* truncate */} Thanks to [@jamesgeorge007](https://github.com/jamesgeorge007) and [@armano2](https://github.com/armano2) for their first PR! diff --git a/website/blog/2019-03-19-7.4.0.md b/website/blog/2019-03-19-7.4.0.mdx similarity index 99% rename from website/blog/2019-03-19-7.4.0.md rename to website/blog/2019-03-19-7.4.0.mdx index 29ff76e8c5..4db16fb2fe 100644 --- a/website/blog/2019-03-19-7.4.0.md +++ b/website/blog/2019-03-19-7.4.0.mdx @@ -17,7 +17,7 @@ Last but not least, both `@babel/preset-env` and `@babel/transform-runtime` now You can read the whole changelog [on GitHub](https://github.com/babel/babel/releases/tag/v7.4.0). - +{/* truncate */} --- diff --git a/website/blog/2019-07-02-the-babel-podcast.md b/website/blog/2019-07-02-the-babel-podcast.mdx similarity index 99% rename from website/blog/2019-07-02-the-babel-podcast.md rename to website/blog/2019-07-02-the-babel-podcast.mdx index 388d025cbb..28310bbfb9 100644 --- a/website/blog/2019-07-02-the-babel-podcast.md +++ b/website/blog/2019-07-02-the-babel-podcast.mdx @@ -13,7 +13,7 @@ Today we're announcing the [The Babel Podcast](https://podcast.babeljs.io)! ### Subscribe with: [Apple]( https://podcasts.apple.com/us/podcast/the-babel-podcast/id1470143101) | [Google](https://www.google.com/podcasts?feed=aHR0cHM6Ly9mZWVkcy50cmFuc2lzdG9yLmZtL3RoZS1iYWJlbC1wb2RjYXN0) | [Spotify](https://open.spotify.com/show/3TK8x8AGckeEQEtnJVZYAz) | [RSS](https://feeds.transistor.fm/the-babel-podcast) - +{/* truncate */} To start out, our first [episode](https://podcast.babeljs.io/rome) is with our good friend [Sebastian McKenzie](https://twitter.com/sebmck), the creator of Babel ([transcript](https://podcast.babeljs.io/rome/#transcript))! diff --git a/website/blog/2019-07-03-7.5.0.md b/website/blog/2019-07-03-7.5.0.mdx similarity index 98% rename from website/blog/2019-07-03-7.5.0.md rename to website/blog/2019-07-03-7.5.0.mdx index d2fcd8fe8c..7c8cd3e0ef 100644 --- a/website/blog/2019-07-03-7.5.0.md +++ b/website/blog/2019-07-03-7.5.0.mdx @@ -14,7 +14,7 @@ It also has support for TypeScript `namespace`s (experimental) and for Browsersl You can read the whole changelog [on GitHub](https://github.com/babel/babel/releases/tag/v7.5.0). - +{/* truncate */} Thanks to [Wesley Wolfe](https://github.com/Wolvereness), [Martin Zlรกmal](https://github.com/mrtnzlml), [Blaine Bublitz](https://github.com/phated), [Letladi Sebesho](https://github.com/Letladi), [Paul Comanici](https://github.com/darkyndy), [Lidor Avitan](https://github.com/lidoravitan), [Artem Butusov](https://github.com/sormy), [Sebastian Johansson](https://github.com/ChlorideCull), and [Min ho Kim](https://github.com/minho42) for their first PRs! @@ -56,7 +56,7 @@ How is the F# variant different from the Smart one? Instead of having the concep - +{/* DO NOT indent this table, or the code won't be highlighted */} ```js title="JavaScript" @@ -116,7 +116,7 @@ The F# pipeline operator is also different regarding how `await` is handled: - +{/* DO NOT indent this table, or the code won't be highlighted */} ```js title="JavaScript" diff --git a/website/blog/2019-09-05-7.6.0.md b/website/blog/2019-09-05-7.6.0.mdx similarity index 99% rename from website/blog/2019-09-05-7.6.0.md rename to website/blog/2019-09-05-7.6.0.mdx index 5a416cd660..55c9fecaca 100644 --- a/website/blog/2019-09-05-7.6.0.md +++ b/website/blog/2019-09-05-7.6.0.mdx @@ -11,7 +11,7 @@ We just released a new minor Babel version! It includes support for static private accessors in classes, and parser support for the V8 intrinsics syntax. We also fixed a bunch of long-standing issues related to TDZ handling, and improved support for do-expressions. You can read the whole changelog [on GitHub](https://github.com/babel/babel/releases/tag/v7.6.0). - +{/* truncate */} Thanks to [Serhii Muryhin](https://github.com/skyiea), [Ashwin Ramaswami](https://github.com/epicfaace), [Sungmin Lee](https://github.com/ifsnow), [Serge Havas](https://github.com/Sinewyk), [Ziad El Khoury Hanna](https://github.com/zaygraveyard), [Even Alander](https://github.com/deificx), [Shrey Banga](https://github.com/banga), [Dylan Kirkby](https://github.com/dsgkirkby), [Ajay Sagar](https://github.com/ajaysagar), [Adam Ramberg](https://github.com/AdamRamberg), and [Bin Xin](https://github.com/rhyzx) for their first PRs! (And also thanks to [Codetriage README Bot](https://github.com/codetriage-readme-bot) and [dependabot](https://help.github.com/en/articles/configuring-automated-security-fixes) ๐Ÿค–) diff --git a/website/blog/2019-11-05-7.7.0.md b/website/blog/2019-11-05-7.7.0.mdx similarity index 99% rename from website/blog/2019-11-05-7.7.0.md rename to website/blog/2019-11-05-7.7.0.mdx index 57ba79a50a..562e51502a 100644 --- a/website/blog/2019-11-05-7.7.0.md +++ b/website/blog/2019-11-05-7.7.0.mdx @@ -19,7 +19,7 @@ Lastly, Babel 7.7.0 uses 20% less memory than 7.6.0. You can read the whole changelog [on GitHub](https://github.com/babel/babel/releases/tag/v7.7.0). - +{/* truncate */} --- diff --git a/website/blog/2019-11-08-babels-funding-plans.md b/website/blog/2019-11-08-babels-funding-plans.mdx similarity index 99% rename from website/blog/2019-11-08-babels-funding-plans.md rename to website/blog/2019-11-08-babels-funding-plans.mdx index bf2863bfae..38fa9e58ca 100644 --- a/website/blog/2019-11-08-babels-funding-plans.md +++ b/website/blog/2019-11-08-babels-funding-plans.mdx @@ -15,7 +15,7 @@ In March 2018, Henry [left his job](https://www.henryzoo.com/leaving-behance/) t This has been a big win for the team, but we're finding that it is not enough. - +{/* truncate */} ## New Challenges diff --git a/website/blog/2020-01-11-7.8.0.md b/website/blog/2020-01-11-7.8.0.mdx similarity index 99% rename from website/blog/2020-01-11-7.8.0.md rename to website/blog/2020-01-11-7.8.0.mdx index acbb438ae3..9a6818dc42 100644 --- a/website/blog/2020-01-11-7.8.0.md +++ b/website/blog/2020-01-11-7.8.0.mdx @@ -17,7 +17,7 @@ Lastly, Babel's CLI now supports two new options: `--out-file-extension` and `-- You can read the whole changelog [on GitHub](https://github.com/babel/babel/releases/tag/v7.8.0). - +{/* truncate */} --- diff --git a/website/blog/2020-03-16-7.9.0.md b/website/blog/2020-03-16-7.9.0.mdx similarity index 99% rename from website/blog/2020-03-16-7.9.0.md rename to website/blog/2020-03-16-7.9.0.mdx index 37e05117ab..0f5ec9fc39 100644 --- a/website/blog/2020-03-16-7.9.0.md +++ b/website/blog/2020-03-16-7.9.0.mdx @@ -21,7 +21,7 @@ Lastly, `@babel/parser` now supports an additional ECMAScript proposal: [Record You can read the whole changelog [on GitHub](https://github.com/babel/babel/releases/tag/v7.9.0). - +{/* truncate */} --- diff --git a/website/blog/2020-05-25-7.10.0.md b/website/blog/2020-05-25-7.10.0.mdx similarity index 99% rename from website/blog/2020-05-25-7.10.0.md rename to website/blog/2020-05-25-7.10.0.mdx index 9ba4cf3991..3a429e4995 100644 --- a/website/blog/2020-05-25-7.10.0.md +++ b/website/blog/2020-05-25-7.10.0.mdx @@ -19,7 +19,7 @@ This 7.10 release includes: You can read the whole changelog [on GitHub](https://github.com/babel/babel/releases/tag/v7.10.0). - +{/* truncate */} Alongside this Babel release, we are releasing the first experimental version of our new [polyfills compatibility architecture](https://github.com/babel/babel-polyfills) (see below for more details), thanks to [Nicolรฒ](https://twitter.com/NicoloRibaudo) and some awesome folks in the community! We began discussions about this over a year ago in a [RFC issue](https://github.com/babel/babel/issues/10008) within the Babel repository. diff --git a/website/blog/2020-07-13-the-state-of-babel-eslint.md b/website/blog/2020-07-13-the-state-of-babel-eslint.mdx similarity index 99% rename from website/blog/2020-07-13-the-state-of-babel-eslint.md rename to website/blog/2020-07-13-the-state-of-babel-eslint.mdx index 8e6d297d4f..b25a705f5e 100644 --- a/website/blog/2020-07-13-the-state-of-babel-eslint.md +++ b/website/blog/2020-07-13-the-state-of-babel-eslint.mdx @@ -9,7 +9,7 @@ share_text: "The State of babel-eslint" `babel-eslint` is moved to `@babel/eslint-parser`! - +{/* truncate */} ## The Past diff --git a/website/blog/2020-07-30-7.11.0.md b/website/blog/2020-07-30-7.11.0.mdx similarity index 99% rename from website/blog/2020-07-30-7.11.0.md rename to website/blog/2020-07-30-7.11.0.mdx index ebeeee4dcd..f9fcac9c3c 100644 --- a/website/blog/2020-07-30-7.11.0.md +++ b/website/blog/2020-07-30-7.11.0.mdx @@ -20,7 +20,7 @@ In addition to this, we are now releasing the successor of `babel-eslint`: `@bab You can read the whole changelog [on GitHub](https://github.com/babel/babel/releases/tag/v7.11.0). - +{/* truncate */} Also if you have any questions or something you want to discuss, we've enabled [GitHub Discussions](https://github.com/babel/babel/discussions) on our repository! diff --git a/website/blog/2020-10-15-7.12.0.md b/website/blog/2020-10-15-7.12.0.mdx similarity index 99% rename from website/blog/2020-10-15-7.12.0.md rename to website/blog/2020-10-15-7.12.0.mdx index 2a850eb150..79b7509723 100644 --- a/website/blog/2020-10-15-7.12.0.md +++ b/website/blog/2020-10-15-7.12.0.mdx @@ -17,7 +17,7 @@ Lastly, we renamed `@babel/plugin-syntax-module-attributes` (and the correspondi You can read the whole changelog [on GitHub](https://github.com/babel/babel/releases/tag/v7.12.0). - +{/* truncate */} If you or your company want to support Babel and the evolution of JavaScript, but aren't sure how, you can donate to us on our [Open Collective](https://opencollective.com/babel) and, better yet, work with us on the implementation of [new ECMAScript proposals](https://github.com/babel/proposals) directly! As a volunteer-driven project, we rely on the community's support to fund our efforts in supporting the wide range of JavaScript users. Reach out at [team@babeljs.io](mailto:team@babeljs.io) if you'd like to discuss more! diff --git a/website/blog/2021-02-22-7.13.0.md b/website/blog/2021-02-22-7.13.0.mdx similarity index 99% rename from website/blog/2021-02-22-7.13.0.md rename to website/blog/2021-02-22-7.13.0.mdx index e6f307db3c..ffcf48c57b 100644 --- a/website/blog/2021-02-22-7.13.0.md +++ b/website/blog/2021-02-22-7.13.0.mdx @@ -17,7 +17,7 @@ Additionally, we added support for some new Flow and TypeScript features. You can read the full changelog on [GitHub](https://github.com/babel/babel/releases/tag/v7.13.0). - +{/* truncate */} ### Funding Update diff --git a/website/blog/2021-04-29-7.14.0.md b/website/blog/2021-04-29-7.14.0.mdx similarity index 98% rename from website/blog/2021-04-29-7.14.0.md rename to website/blog/2021-04-29-7.14.0.mdx index d6f014ba40..649c99b1b4 100644 --- a/website/blog/2021-04-29-7.14.0.md +++ b/website/blog/2021-04-29-7.14.0.mdx @@ -19,7 +19,7 @@ Finally, we introduced a new `importInterop: node` option to make it easier to p You can read the whole changelog [on GitHub](https://github.com/babel/babel/releases/tag/v7.14.0). - +{/* truncate */} If you or your company want to support Babel and the evolution of JavaScript, but aren't sure how, you can donate to us on our [Open Collective](https://opencollective.com/babel) and, better yet, work with us on the implementation of [new ECMAScript proposals](https://github.com/babel/proposals) directly! As a volunteer-driven project, we rely on the community's support to fund our efforts in supporting the wide range of JavaScript users. Reach out at [team@babeljs.io](mailto:team@babeljs.io) if you'd like to discuss more! @@ -58,7 +58,7 @@ const acorn = require(require.resolve("acorn", { acorn.Parser = acorn.Parser.extend(require("acorn-stage3")); ``` If this doesn't work for you, or if you use a different tool that doesn't support class fields, you still need to use the Babel plugins to transform them. - +{/* Tested at https://github.com/nicolo-ribaudo/romajs-todo-app/blob/d5e38f2189d0ed7a7cf87cd2c35de5b4af7d2f6a/webpack.config.js#L6 */} ::: If you are using `@babel/preset-env`'s [`shippedProposals`](https://babeljs.io/docs/en/babel-preset-env#shippedproposals) option, it now also includes the `@babel/plugin-proposal-private-property-in-object` (introduced in [7.10](https://babel.dev/blog/2020/05/25/7.10.0#private-fields-in-in-11372httpsgithubcombabelbabelpull11372)) and `@babel/plugin-proposal-class-static-block` (introduced in [7.12](https://babel.dev/blog/2020/10/15/7.12.0#class-static-blocks-12079httpsgithubcombabelbabelpull12079-12143httpsgithubcombabelbabelpull12143)) plugins: you can safely remove them from your configuration. diff --git a/website/blog/2021-05-10-funding-update.md b/website/blog/2021-05-10-funding-update.mdx similarity index 98% rename from website/blog/2021-05-10-funding-update.md rename to website/blog/2021-05-10-funding-update.mdx index 458f596e8a..700c7624d3 100644 --- a/website/blog/2021-05-10-funding-update.md +++ b/website/blog/2021-05-10-funding-update.mdx @@ -14,7 +14,7 @@ share_text: "Babel is used by millions, so why are we running out of money?" Since 2018, Babel has been doing a [funding experiment](https://babeljs.io/blog/2019/11/08/babels-funding-plans): can full time work on Babel be sustained? We've learned the answer might be no. - +{/* truncate */} In November 2019, after successfully paying [Henry](https://twitter.com/left_pad) a salary for over a year, we [expanded our goal](https://babeljs.io/blog/2019/11/08/babels-funding-plans) to also support three additional maintainers: [Jรนnliร ng](https://twitter.com/JLHwung), [Kai](https://twitter.com/kai_cataldo), and [Nicolรฒ](https://twitter.com/NicoloRibaudo). @@ -48,7 +48,7 @@ From the beginning, we knew we wouldn't have enough to pay anyone a full time sa We were hoping to see a continued increase in donations to be able to increase what Jรนnliร ng and Nicolรฒ where taking, but it didn't happen. - +{/* Image source: https://observablehq.com/@nicolo-ribaudo/babel-opencollective-donations as of Apr 20, accounting -18k to spend this month (3*6k) */} ![Chart showing our OpenCollective balance decreasing since mid 2020](https://i.imgur.com/bsSHoRF.png) diff --git a/website/blog/2021-07-26-7.15.0.md b/website/blog/2021-07-26-7.15.0.mdx similarity index 99% rename from website/blog/2021-07-26-7.15.0.md rename to website/blog/2021-07-26-7.15.0.mdx index 398ffaa46d..cda898d753 100644 --- a/website/blog/2021-07-26-7.15.0.md +++ b/website/blog/2021-07-26-7.15.0.mdx @@ -15,7 +15,7 @@ Additionally, you can now specify [Rhino](https://mozilla.github.io/rhino/) as a You can read the whole changelog [on GitHub](https://github.com/babel/babel/releases/tag/v7.15.0). - +{/* truncate */} We're really grateful for all the support the community has shown over the last months, since our [funding post](https://babeljs.io/blog/2021/05/10/funding-update) update in May. Reach out at [team@babeljs.io](mailto:team@babeljs.io) if you'd like to discuss about sponsorships! diff --git a/website/blog/2021-10-29-7.16.0.md b/website/blog/2021-10-29-7.16.0.mdx similarity index 99% rename from website/blog/2021-10-29-7.16.0.md rename to website/blog/2021-10-29-7.16.0.mdx index f0b1ba6e02..a3b670f4ec 100644 --- a/website/blog/2021-10-29-7.16.0.md +++ b/website/blog/2021-10-29-7.16.0.mdx @@ -15,7 +15,7 @@ Furthermore, `@babel/eslint-parser` now supports ESLint 8. You can read the whole changelog [on GitHub](https://github.com/babel/babel/releases/tag/v7.16.0). - +{/* truncate */} If you or your company want to support Babel and the evolution of JavaScript, but aren't sure how, you can donate to us on our [Open Collective](https://github.com/babel/babel?sponsor=1) and, better yet, work with us on the implementation of [new ECMAScript proposals](https://github.com/babel/proposals) directly! As a volunteer-driven project, we rely on the community's support to fund our efforts in supporting the wide range of JavaScript users. Reach out at [team@babeljs.io](mailto:team@babeljs.io) if you'd like to discuss more! diff --git a/website/blog/2022-02-02-7.17.0.md b/website/blog/2022-02-02-7.17.0.mdx similarity index 99% rename from website/blog/2022-02-02-7.17.0.md rename to website/blog/2022-02-02-7.17.0.mdx index 1ce112b42e..d7a566d394 100644 --- a/website/blog/2022-02-02-7.17.0.md +++ b/website/blog/2022-02-02-7.17.0.mdx @@ -15,7 +15,7 @@ We also implemented the [RegExp `v` flag proposal](https://github.com/tc39/propo You can read the whole changelog [on GitHub](https://github.com/babel/babel/releases/tag/v7.17.0). - +{/* truncate */} If you or your company want to support Babel and the evolution of JavaScript, but aren't sure how, you can donate to us on our [Open Collective](https://opencollective.com/babel#category-CONTRIBUTE) or [GitHub Sponsors](https://github.com/babel/babel?sponsor=1) and, better yet, work with us on the implementation of [new ECMAScript proposals](https://github.com/babel/proposals) directly! As a volunteer-driven project, we rely on the community's support to fund our efforts in supporting the wide range of JavaScript users. Reach out at [team@babeljs.io](mailto:team@babeljs.io) if you'd like to discuss more! diff --git a/website/blog/2022-05-19-7.18.0.md b/website/blog/2022-05-19-7.18.0.mdx similarity index 99% rename from website/blog/2022-05-19-7.18.0.md rename to website/blog/2022-05-19-7.18.0.mdx index e9167938a0..a277cf7a78 100644 --- a/website/blog/2022-05-19-7.18.0.md +++ b/website/blog/2022-05-19-7.18.0.mdx @@ -13,7 +13,7 @@ This release includes support for the [private destructuring](https://github.com You can read the whole changelog [on GitHub](https://github.com/babel/babel/releases/tag/v7.18.0). - +{/* truncate */} If you or your company want to support Babel and the evolution of JavaScript, but aren't sure how, you can donate to us on our [Open Collective](https://github.com/babel/babel?sponsor=1) and, better yet, work with us on the implementation of [new ECMAScript proposals](https://github.com/babel/proposals) directly! As a volunteer-driven project, we rely on the community's support to fund our efforts in supporting the wide range of JavaScript users. Reach out at [team@babeljs.io](mailto:team@babeljs.io) if you'd like to discuss more! diff --git a/website/blog/2022-09-05-7.19.0.md b/website/blog/2022-09-05-7.19.0.mdx similarity index 99% rename from website/blog/2022-09-05-7.19.0.md rename to website/blog/2022-09-05-7.19.0.mdx index a7c7448790..5dd429f63a 100644 --- a/website/blog/2022-09-05-7.19.0.md +++ b/website/blog/2022-09-05-7.19.0.mdx @@ -13,7 +13,7 @@ This release updates our implementation of the [decorators proposal](https://git You can read the whole changelog [on GitHub](https://github.com/babel/babel/releases/tag/v7.19.0). - +{/* truncate */} If you or your company want to support Babel and the evolution of JavaScript, but aren't sure how, you can donate to us on our [Open Collective](https://github.com/babel/babel?sponsor=1) and, better yet, work with us on the implementation of [new ECMAScript proposals](https://github.com/babel/proposals) directly! As a volunteer-driven project, we rely on the community's support to fund our efforts in supporting the wide range of JavaScript users. Reach out at [team@babeljs.io](mailto:team@babeljs.io) if you'd like to discuss more! diff --git a/website/blog/2022-10-27-7.20.0.md b/website/blog/2022-10-27-7.20.0.mdx similarity index 99% rename from website/blog/2022-10-27-7.20.0.md rename to website/blog/2022-10-27-7.20.0.mdx index 914549b6f9..611832d6d9 100644 --- a/website/blog/2022-10-27-7.20.0.md +++ b/website/blog/2022-10-27-7.20.0.mdx @@ -17,7 +17,7 @@ We are also releasing version 9.0.0 of [`babel-loader`](https://github.com/babel You can read the whole changelog [on GitHub](https://github.com/babel/babel/releases/tag/v7.20.0). - +{/* truncate */} If you or your company want to support Babel and the evolution of JavaScript, but aren't sure how, you can donate to us on our [Open Collective](https://github.com/babel/babel?sponsor=1) and, better yet, work with us on the implementation of [new ECMAScript proposals](https://github.com/babel/proposals) directly! As a volunteer-driven project, we rely on the community's support to fund our efforts in supporting the wide range of JavaScript users. Reach out at [team@babeljs.io](mailto:team@babeljs.io) if you'd like to discuss more! diff --git a/website/blog/2023-02-20-7.21.0.md b/website/blog/2023-02-20-7.21.0.mdx similarity index 99% rename from website/blog/2023-02-20-7.21.0.md rename to website/blog/2023-02-20-7.21.0.mdx index bbb252624e..6e357e67a4 100644 --- a/website/blog/2023-02-20-7.21.0.md +++ b/website/blog/2023-02-20-7.21.0.mdx @@ -13,7 +13,7 @@ Babel now supports the [Inline RegExp modifiers](https://github.com/tc39/proposa You can read the whole changelog [on GitHub](https://github.com/babel/babel/releases/tag/v7.21.0). - +{/* truncate */} If you or your company want to support Babel and the evolution of JavaScript, but aren't sure how, you can donate to us on our [Open Collective](https://github.com/babel/babel?sponsor=1) and, better yet, work with us on the implementation of [new ECMAScript proposals](https://github.com/babel/proposals) directly! As a volunteer-driven project, we rely on the community's support to fund our efforts in supporting the wide range of JavaScript users. Reach out at [team@babeljs.io](mailto:team@babeljs.io) if you'd like to discuss more! diff --git a/website/blog/2023-05-26-7.22.0.md b/website/blog/2023-05-26-7.22.0.mdx similarity index 99% rename from website/blog/2023-05-26-7.22.0.md rename to website/blog/2023-05-26-7.22.0.mdx index ce34e68878..47d95434db 100644 --- a/website/blog/2023-05-26-7.22.0.md +++ b/website/blog/2023-05-26-7.22.0.mdx @@ -15,7 +15,7 @@ We also updated our implementation of [decorators](https://github.com/tc39/propo You can read the whole changelog [on GitHub](https://github.com/babel/babel/releases/tag/v7.22.0). - +{/* truncate */} If you or your company want to support Babel and the evolution of JavaScript, but aren't sure how, you can donate to us on our [Open Collective](https://github.com/babel/babel?sponsor=1) and, better yet, work with us on the implementation of [new ECMAScript proposals](https://github.com/babel/proposals) directly! As a volunteer-driven project, we rely on the community's support to fund our efforts in supporting the wide range of JavaScript users. Reach out at [team@babeljs.io](mailto:team@babeljs.io) if you'd like to discuss more! diff --git a/website/blog/2023-09-25-7.23.0.md b/website/blog/2023-09-25-7.23.0.mdx similarity index 99% rename from website/blog/2023-09-25-7.23.0.md rename to website/blog/2023-09-25-7.23.0.mdx index 5614983a82..f14d1fa5f6 100644 --- a/website/blog/2023-09-25-7.23.0.md +++ b/website/blog/2023-09-25-7.23.0.mdx @@ -15,7 +15,7 @@ In addition to releasing version 7.23.0, we also recently published the first Ba You can read the whole changelog [on GitHub](https://github.com/babel/babel/releases/tag/v7.23.0). - +{/* truncate */} If you or your company want to support Babel and the evolution of JavaScript, but aren't sure how, you can donate to us on our [Open Collective](https://github.com/babel/babel?sponsor=1) and, better yet, work with us on the implementation of [new ECMAScript proposals](https://github.com/babel/proposals) directly! As a volunteer-driven project, we rely on the community's support to fund our efforts in supporting the wide range of JavaScript users. Reach out at [team@babeljs.io](mailto:team@babeljs.io) if you'd like to discuss more! diff --git a/website/blog/2023-10-16-cve-2023-45133.md b/website/blog/2023-10-16-cve-2023-45133.mdx similarity index 99% rename from website/blog/2023-10-16-cve-2023-45133.md rename to website/blog/2023-10-16-cve-2023-45133.mdx index 4088ac08af..d8f6f61e3c 100644 --- a/website/blog/2023-10-16-cve-2023-45133.md +++ b/website/blog/2023-10-16-cve-2023-45133.mdx @@ -12,7 +12,7 @@ share_text: "CVE-2023-45133: Finding an Arbitrary Code Execution Vulnerability I On October 10th, 2023, I stumbled upon an arbitrary code execution vulnerability in [Babel](https://github.com/babel/babel/), which was subsequently assigned the identifier CVE-2023-45133. In this post, Iโ€™ll walk you through the journey of discovering and exploiting this intriguing flaw. - +{/* truncate */} :::tip This article was originally published on [William Khem Marquez's blog](https://steakenthusiast.github.io/). He also published a series on using Babel to deobfuscate JavaScript code: check it out! diff --git a/website/blog/2024-02-28-7.24.0.md b/website/blog/2024-02-28-7.24.0.mdx similarity index 99% rename from website/blog/2024-02-28-7.24.0.md rename to website/blog/2024-02-28-7.24.0.mdx index 7109991fb7..514b5eeb83 100644 --- a/website/blog/2024-02-28-7.24.0.md +++ b/website/blog/2024-02-28-7.24.0.mdx @@ -13,7 +13,7 @@ We updated our [Decorators](https://github.com/tc39/proposal-decorators/) implem You can read the whole changelog [on GitHub](https://github.com/babel/babel/releases/tag/v7.24.0). - +{/* truncate */} If you or your company want to support Babel and the evolution of JavaScript, but aren't sure how, you can donate to us on our [Open Collective](https://github.com/babel/babel?sponsor=1) and, better yet, work with us on the implementation of [new ECMAScript proposals](https://github.com/babel/proposals) directly! As a volunteer-driven project, we rely on the community's support to fund our efforts in supporting the wide range of JavaScript users. Reach out at [team@babeljs.io](mailto:team@babeljs.io) if you'd like to discuss more! diff --git a/website/blog/2024-07-26-7.25.0.md b/website/blog/2024-07-26-7.25.0.mdx similarity index 99% rename from website/blog/2024-07-26-7.25.0.md rename to website/blog/2024-07-26-7.25.0.mdx index 6159353fbf..170768c424 100644 --- a/website/blog/2024-07-26-7.25.0.md +++ b/website/blog/2024-07-26-7.25.0.mdx @@ -13,7 +13,7 @@ Babel 7.25.0 is out! You can read the whole changelog [on GitHub](https://github.com/babel/babel/releases/tag/v7.25.0). - +{/* truncate */} > If you or your company want to support Babel and the evolution of JavaScript, but aren't sure how, you can donate to us on our [Open Collective](https://github.com/babel/babel?sponsor=1) and, better yet, work with us on the implementation of [new ECMAScript proposals](https://github.com/babel/proposals) directly! As a volunteer-driven project, we rely on the community's support to fund our efforts in supporting the wide range of JavaScript users. Reach out at [team@babeljs.io](mailto:team@babeljs.io) if you'd like to discuss more! diff --git a/website/blog/2024-10-25-7.26.0.md b/website/blog/2024-10-25-7.26.0.mdx similarity index 99% rename from website/blog/2024-10-25-7.26.0.md rename to website/blog/2024-10-25-7.26.0.mdx index 0fc287f6a9..86e6fed263 100644 --- a/website/blog/2024-10-25-7.26.0.md +++ b/website/blog/2024-10-25-7.26.0.mdx @@ -15,7 +15,7 @@ Babel now also allows plugins to provide asynchronous `pre`/`post` hooks, and ha You can read the whole changelog [on GitHub](https://github.com/babel/babel/releases/tag/v7.26.0). - +{/* truncate */} If you or your company want to support Babel and the evolution of JavaScript, but aren't sure how, you can donate to us on our [Open Collective](https://github.com/babel/babel?sponsor=1) and, better yet, work with us on the implementation of [new ECMAScript proposals](https://github.com/babel/proposals) directly! As a volunteer-driven project, we rely on the community's support to fund our efforts in supporting the wide range of JavaScript users. Reach out at [team@babeljs.io](mailto:team@babeljs.io) if you'd like to discuss more! diff --git a/website/blog/2025-03-24-7.27.0.md b/website/blog/2025-03-24-7.27.0.mdx similarity index 99% rename from website/blog/2025-03-24-7.27.0.md rename to website/blog/2025-03-24-7.27.0.mdx index b8ce4c736c..8d1463d862 100644 --- a/website/blog/2025-03-24-7.27.0.md +++ b/website/blog/2025-03-24-7.27.0.mdx @@ -19,7 +19,7 @@ Lastly, we updated our `estree` compatibility plugin in `@babel/parser` to gener There are multiple changes that may benefit plugin authors: you can read the whole changelog [on GitHub](https://github.com/babel/babel/releases/tag/v7.27.0). - +{/* truncate */} If you or your company want to support Babel and the evolution of JavaScript, but aren't sure how, you can donate to us on our [Open Collective](https://github.com/babel/babel?sponsor=1) and, better yet, work with us on the implementation of [new ECMAScript proposals](https://github.com/babel/proposals) directly! As a volunteer-driven project, we rely on the community's support to fund our efforts in supporting the wide range of JavaScript users. Reach out at [team@babeljs.io](mailto:team@babeljs.io) if you'd like to discuss more! diff --git a/website/blog/2025-05-30-babel-8-beta.md b/website/blog/2025-05-30-babel-8-beta.mdx similarity index 95% rename from website/blog/2025-05-30-babel-8-beta.md rename to website/blog/2025-05-30-babel-8-beta.mdx index e290276000..2a2738ef16 100644 --- a/website/blog/2025-05-30-babel-8-beta.md +++ b/website/blog/2025-05-30-babel-8-beta.mdx @@ -13,11 +13,11 @@ All the breaking changes we were planning to include in Babel 8 are done, and we We now need to test it in real projects to make sure we got everything right. We have been transpiling our own code using Babel 8 since early alpha versions, but one prerelease user is not enough. ๐Ÿ˜‰ - +{/* truncate */} ## Babel 8 Beta: highlights -So, what are the main changes that are coming in Babel 8? We have a truly marvelous list of them, which unfortunately this blog's margin is too narrow to contain. +So, what are the main changes that are coming in Babel 8? We have a truly marvelous list of them, which unfortunately this blog's margin is too narrow to contain. {/* https://en.wikipedia.org/wiki/Fermat%27s_Last_Theorem#Fermat's_conjecture */} A guiding principle for the breaking changes we've introduced is that updating to Babel 8 should be easy: most of them have been already introduced in Babel 7 behind an option, so that you can start adapting your code before actually performing the update. diff --git a/website/blog/2025-06-30-7.28.0.md b/website/blog/2025-06-30-7.28.0.mdx similarity index 99% rename from website/blog/2025-06-30-7.28.0.md rename to website/blog/2025-06-30-7.28.0.mdx index 9e2db07425..95aca1fbd3 100644 --- a/website/blog/2025-06-30-7.28.0.md +++ b/website/blog/2025-06-30-7.28.0.mdx @@ -13,7 +13,7 @@ This release includes support for `babel.config.ts` and `babel.config.mts`, the You can read the whole changelog [on GitHub](https://github.com/babel/babel/releases/tag/v7.28.0). If you are already using [Babel 8 beta](https://babeljs.io/blog/2025/05/30/babel-8-beta), all the new 7.28.0 features are included in [v8.0.0-beta.1](https://github.com/babel/babel/releases/tag/v8.0.0-beta.1). - +{/* truncate */} If you or your company want to support Babel and the evolution of JavaScript but aren't sure how, you can donate to us on our [Open Collective](https://github.com/babel/babel?sponsor=1) and, better yet, work with us on the implementation of [new ECMAScript proposals](https://github.com/babel/proposals) directly! As a volunteer-driven project, we rely on the community's support to fund our efforts in supporting the wide range of JavaScript users. Reach out at [team@babeljs.io](mailto:team@babeljs.io) if you'd like to discuss more! diff --git a/website/blog/2026-01-31-7.29.0.md b/website/blog/2026-01-31-7.29.0.mdx similarity index 99% rename from website/blog/2026-01-31-7.29.0.md rename to website/blog/2026-01-31-7.29.0.mdx index 5bde862166..0d088595e1 100644 --- a/website/blog/2026-01-31-7.29.0.md +++ b/website/blog/2026-01-31-7.29.0.mdx @@ -17,7 +17,7 @@ Both of these changes are meant to ease the migration from Babel 7 to Babel 8. You can read the whole changelog [on GitHub](https://github.com/babel/babel/releases/tag/v7.29.0). If you are already using [Babel 8 beta](https://babeljs.io/blog/2025/05/30/babel-8-beta), all the new 7.28.0 features are included in [v8.0.0-rc.1](https://github.com/babel/babel/releases/tag/v8.0.0-rc.1). - +{/* truncate */} If you or your company want to support Babel and the evolution of JavaScript but aren't sure how, you can donate to us on our [Open Collective](https://github.com/babel/babel?sponsor=1) and, better yet, work with us on the implementation of [new ECMAScript proposals](https://github.com/babel/proposals) directly! As a volunteer-driven project, we rely on the community's support to fund our efforts in supporting the wide range of JavaScript users. Reach out at [team@babeljs.io](mailto:team@babeljs.io) if you'd like to discuss more! diff --git a/website/docusaurus.config.ts b/website/docusaurus.config.ts index e242fb8f4e..430e0706d6 100644 --- a/website/docusaurus.config.ts +++ b/website/docusaurus.config.ts @@ -141,12 +141,12 @@ function docusaurusReplRoutePlugin() { } const siteConfig: Config = { + storage: { + type: "localStorage", + namespace: "babel", + }, future: { - // See https://docusaurus.io/blog/releases/3.6 - experimental_faster: true, - v4: { - removeLegacyPostBuildHeadAttribute: true, - }, + v4: true, }, titleDelimiter: "ยท", baseUrl: "/", @@ -166,7 +166,7 @@ const siteConfig: Config = { markdown: { hooks: { onBrokenMarkdownLinks: "throw", - } + }, }, plugins: [docusaurusReplRoutePlugin, require("./webpack.plugin.js")], presets: [ diff --git a/website/src/components/repl/lib/utils.ts b/website/src/components/repl/lib/utils.ts index abf3cc96bd..53616d87ce 100644 --- a/website/src/components/repl/lib/utils.ts +++ b/website/src/components/repl/lib/utils.ts @@ -37,7 +37,7 @@ export function preferDarkColorScheme(): boolean { if (!ExecutionEnvironment.canUseDOM) { return false; } - const theme = localStorage.getItem("theme"); + const theme = document.documentElement.getAttribute("data-theme"); if (theme) { return theme === "dark"; } diff --git a/yarn.lock b/yarn.lock index 41901583e2..17c50325a9 100644 --- a/yarn.lock +++ b/yarn.lock @@ -12,59 +12,6 @@ __metadata: languageName: node linkType: hard -"@ai-sdk/gateway@npm:2.0.24": - version: 2.0.24 - resolution: "@ai-sdk/gateway@npm:2.0.24" - dependencies: - "@ai-sdk/provider": "npm:2.0.1" - "@ai-sdk/provider-utils": "npm:3.0.20" - "@vercel/oidc": "npm:3.0.5" - peerDependencies: - zod: ^3.25.76 || ^4.1.8 - checksum: 10/8ab1518123bbee08d294002d686dc730e7ed5016de1bcd4fa27dbe5fe6ac3db6aaeb0bb6e2ba77a8464284054e30c96f3e7eb6c48cd443d24cb0f7079ecb68e4 - languageName: node - linkType: hard - -"@ai-sdk/provider-utils@npm:3.0.20": - version: 3.0.20 - resolution: "@ai-sdk/provider-utils@npm:3.0.20" - dependencies: - "@ai-sdk/provider": "npm:2.0.1" - "@standard-schema/spec": "npm:^1.0.0" - eventsource-parser: "npm:^3.0.6" - peerDependencies: - zod: ^3.25.76 || ^4.1.8 - checksum: 10/741faf25164ee61bd23982c051d9c81a70eb8c5b897ddb51c224aead6fcdee485b600dced40bc523d5af23fe19367f0a3a7e2920d110dfa3f60c211752cd2443 - languageName: node - linkType: hard - -"@ai-sdk/provider@npm:2.0.1": - version: 2.0.1 - resolution: "@ai-sdk/provider@npm:2.0.1" - dependencies: - json-schema: "npm:^0.4.0" - checksum: 10/b828707f5731b705154174950f3b407b63b5d7e79d641c794fa87e45a2a07534d8a6739f7ec4b4ead8c5edbe19c6e34ceecf67fabbe300413208734486c63fdb - languageName: node - linkType: hard - -"@ai-sdk/react@npm:^2.0.30": - version: 2.0.119 - resolution: "@ai-sdk/react@npm:2.0.119" - dependencies: - "@ai-sdk/provider-utils": "npm:3.0.20" - ai: "npm:5.0.117" - swr: "npm:^2.2.5" - throttleit: "npm:2.1.0" - peerDependencies: - react: ^18 || ~19.0.1 || ~19.1.2 || ^19.2.1 - zod: ^3.25.76 || ^4.1.8 - peerDependenciesMeta: - zod: - optional: true - checksum: 10/ce9bf4339c46e3ec17ecb9b8fb6a196b04cf24c007bdc900b692b3f9af78b49eabfd457c09a6d55fb30a9ec162797a226ee3eaa4742fbd26859e8d46c6ff5299 - languageName: node - linkType: hard - "@algolia/abtesting@npm:1.15.0": version: 1.15.0 resolution: "@algolia/abtesting@npm:1.15.0" @@ -87,6 +34,16 @@ __metadata: languageName: node linkType: hard +"@algolia/autocomplete-core@npm:^1.19.2": + version: 1.19.8 + resolution: "@algolia/autocomplete-core@npm:1.19.8" + dependencies: + "@algolia/autocomplete-plugin-algolia-insights": "npm:1.19.8" + "@algolia/autocomplete-shared": "npm:1.19.8" + checksum: 10/adb5f90a03269b0eb2d17ee745fcd808f36561d9921b5a6aee723ef1d45d2b52c2758b1a2c7bac97a3a949268906e006fbc9b84e4584abe8e578b3b0d42bad9a + languageName: node + linkType: hard + "@algolia/autocomplete-plugin-algolia-insights@npm:1.19.2": version: 1.19.2 resolution: "@algolia/autocomplete-plugin-algolia-insights@npm:1.19.2" @@ -98,6 +55,17 @@ __metadata: languageName: node linkType: hard +"@algolia/autocomplete-plugin-algolia-insights@npm:1.19.8": + version: 1.19.8 + resolution: "@algolia/autocomplete-plugin-algolia-insights@npm:1.19.8" + dependencies: + "@algolia/autocomplete-shared": "npm:1.19.8" + peerDependencies: + search-insights: ">= 1 < 3" + checksum: 10/dd8b8c483472fe58ea1d0fd7c9acd52f9dfa794eaaab2782c696b3855de56dfe00a5226f073eab5e3b3d445cd17cf062b0c8463ee05ae90a26cc086e73d330f4 + languageName: node + linkType: hard + "@algolia/autocomplete-shared@npm:1.19.2": version: 1.19.2 resolution: "@algolia/autocomplete-shared@npm:1.19.2" @@ -108,6 +76,16 @@ __metadata: languageName: node linkType: hard +"@algolia/autocomplete-shared@npm:1.19.8": + version: 1.19.8 + resolution: "@algolia/autocomplete-shared@npm:1.19.8" + peerDependencies: + "@algolia/client-search": ">= 4.9.1 < 6" + algoliasearch: ">= 4.9.1 < 6" + checksum: 10/45f7bcd8b75258462698914f0995b60df91ea217c731a964bebcea050e83fb898110ae7f227b55886012d7fb6678304f36831649abb363e6ebac86f030be0baf + languageName: node + linkType: hard + "@algolia/client-abtesting@npm:5.49.0": version: 5.49.0 resolution: "@algolia/client-abtesting@npm:5.49.0" @@ -1492,16 +1470,6 @@ __metadata: languageName: node linkType: hard -"@babel/runtime-corejs3@npm:^7.25.9": - version: 7.25.9 - resolution: "@babel/runtime-corejs3@npm:7.25.9" - dependencies: - core-js-pure: "npm:^3.30.2" - regenerator-runtime: "npm:^0.14.0" - checksum: 10/37e36daed06b5983c2ce2056afd1a91e5d7da04efa33c94a7168be13f29a5d642111eedc1d053ca246a1581799726b470037442a18d8217006bc18819bb1e2ea - languageName: node - linkType: hard - "@babel/runtime@npm:^7.1.2, @babel/runtime@npm:^7.10.3, @babel/runtime@npm:^7.12.13, @babel/runtime@npm:^7.12.5, @babel/runtime@npm:^7.18.3, @babel/runtime@npm:^7.25.9, @babel/runtime@npm:^7.27.6, @babel/runtime@npm:^7.8.4": version: 7.28.3 resolution: "@babel/runtime@npm:7.28.3" @@ -2064,9 +2032,9 @@ __metadata: languageName: node linkType: hard -"@docsearch/core@npm:4.4.0": - version: 4.4.0 - resolution: "@docsearch/core@npm:4.4.0" +"@docsearch/core@npm:4.6.2": + version: 4.6.2 + resolution: "@docsearch/core@npm:4.6.2" peerDependencies: "@types/react": ">= 16.8.0 < 20.0.0" react: ">= 16.8.0 < 20.0.0" @@ -2078,29 +2046,24 @@ __metadata: optional: true react-dom: optional: true - checksum: 10/9d927d50eb22f7b3ea3616d846a46b6f63a0b7424f60fe7482d295e83d5a4c50dfb7e953097fcd110e1d8d67c86706f9b0539d66a55562318505afcf4e24260e + checksum: 10/0a130c1830f142e3e2058b0252bfe6ea3c3b7cb1225c7f593b7ad4236d218b4a04622ac4e34181dec6efe6119d5d2c0f7e4dc32f47974d48ea16848ee11e4e0b languageName: node linkType: hard -"@docsearch/css@npm:4.4.0": - version: 4.4.0 - resolution: "@docsearch/css@npm:4.4.0" - checksum: 10/a8ad479480c8a9a1602f2d4ff8162682ceed28e634854d1b5806b8cde167bb287d7be2f4d41cf552966cf35d3737c46ff964b45a31807f851037b7b74e3e624b +"@docsearch/css@npm:4.6.2": + version: 4.6.2 + resolution: "@docsearch/css@npm:4.6.2" + checksum: 10/d73ef1c79accf90082e0e3aca8ba5732a3f81ce40bacb6802e74d316e3f022badf1d34962f4e82fc17e5a537169ec48348e3f78bad74b49bc952375aa89b486d languageName: node linkType: hard -"@docsearch/react@npm:^3.9.0 || ^4.1.0": - version: 4.4.0 - resolution: "@docsearch/react@npm:4.4.0" +"@docsearch/react@npm:^3.9.0 || ^4.3.2": + version: 4.6.2 + resolution: "@docsearch/react@npm:4.6.2" dependencies: - "@ai-sdk/react": "npm:^2.0.30" "@algolia/autocomplete-core": "npm:1.19.2" - "@docsearch/core": "npm:4.4.0" - "@docsearch/css": "npm:4.4.0" - ai: "npm:^5.0.30" - algoliasearch: "npm:^5.28.0" - marked: "npm:^16.3.0" - zod: "npm:^4.1.8" + "@docsearch/core": "npm:4.6.2" + "@docsearch/css": "npm:4.6.2" peerDependencies: "@types/react": ">= 16.8.0 < 20.0.0" react: ">= 16.8.0 < 20.0.0" @@ -2115,13 +2078,13 @@ __metadata: optional: true search-insights: optional: true - checksum: 10/9abd98ec1e49b53ff73afbd48612dea8a4dafd4014c1300ebdf43c325f3e872c22106bfe1951bd273c044c561dde948ec2def688d7dc9510e3c21824f6331373 + checksum: 10/dc8afc9b52ee4571d9ac4138d324a69842797104f77579c431fedbdf68610a05a5e88e88c5196310f32a74fddfde394d1ff85654515fe1a06b08470a4a67b5b6 languageName: node linkType: hard -"@docusaurus/babel@npm:3.9.2": - version: 3.9.2 - resolution: "@docusaurus/babel@npm:3.9.2" +"@docusaurus/babel@npm:3.10.0": + version: 3.10.0 + resolution: "@docusaurus/babel@npm:3.10.0" dependencies: "@babel/core": "npm:^7.25.9" "@babel/generator": "npm:^7.25.9" @@ -2131,27 +2094,26 @@ __metadata: "@babel/preset-react": "npm:^7.25.9" "@babel/preset-typescript": "npm:^7.25.9" "@babel/runtime": "npm:^7.25.9" - "@babel/runtime-corejs3": "npm:^7.25.9" "@babel/traverse": "npm:^7.25.9" - "@docusaurus/logger": "npm:3.9.2" - "@docusaurus/utils": "npm:3.9.2" + "@docusaurus/logger": "npm:3.10.0" + "@docusaurus/utils": "npm:3.10.0" babel-plugin-dynamic-import-node: "npm:^2.3.3" fs-extra: "npm:^11.1.1" tslib: "npm:^2.6.0" - checksum: 10/ff1806ee5899e61c37930046faf4e485368ebb5412a42b65666c0a9dd15f330acf3136cbccb8d8ff98f9d1403b407b698fbffab4b23c08815607152c1dda1c2a + checksum: 10/f7595a33e7492ddf959560d58bd0750137ce85689c2a194fce8036032305c4f96ce9df942f6b25f672ec6ffa2ddd75b243363150632e679760db620ad1e5d916 languageName: node linkType: hard -"@docusaurus/bundler@npm:3.9.2": - version: 3.9.2 - resolution: "@docusaurus/bundler@npm:3.9.2" +"@docusaurus/bundler@npm:3.10.0": + version: 3.10.0 + resolution: "@docusaurus/bundler@npm:3.10.0" dependencies: "@babel/core": "npm:^7.25.9" - "@docusaurus/babel": "npm:3.9.2" - "@docusaurus/cssnano-preset": "npm:3.9.2" - "@docusaurus/logger": "npm:3.9.2" - "@docusaurus/types": "npm:3.9.2" - "@docusaurus/utils": "npm:3.9.2" + "@docusaurus/babel": "npm:3.10.0" + "@docusaurus/cssnano-preset": "npm:3.10.0" + "@docusaurus/logger": "npm:3.10.0" + "@docusaurus/types": "npm:3.10.0" + "@docusaurus/utils": "npm:3.10.0" babel-loader: "npm:^9.2.1" clean-css: "npm:^5.3.3" copy-webpack-plugin: "npm:^11.0.0" @@ -2175,21 +2137,21 @@ __metadata: peerDependenciesMeta: "@docusaurus/faster": optional: true - checksum: 10/767c3554305b7e7ab6d5b4bf36ab00bad3d257a9936f7b3698fe9d8275e10a16098ad84d4492a469ddde4dcf098e75df8cca82443fbeb634719fdf6d7fe2c4be + checksum: 10/5f8ec2f9618d6f54c01317138f399fec07c652e8aa5c93e2bca4b77e4b180bfc4b52d9009b0986c45bc4a418b1a646ad479eaaf8db582c0216706c3975dd0e41 languageName: node linkType: hard -"@docusaurus/core@npm:3.9.2, @docusaurus/core@npm:^3.9.2": - version: 3.9.2 - resolution: "@docusaurus/core@npm:3.9.2" - dependencies: - "@docusaurus/babel": "npm:3.9.2" - "@docusaurus/bundler": "npm:3.9.2" - "@docusaurus/logger": "npm:3.9.2" - "@docusaurus/mdx-loader": "npm:3.9.2" - "@docusaurus/utils": "npm:3.9.2" - "@docusaurus/utils-common": "npm:3.9.2" - "@docusaurus/utils-validation": "npm:3.9.2" +"@docusaurus/core@npm:3.10.0, @docusaurus/core@npm:^3.10.0": + version: 3.10.0 + resolution: "@docusaurus/core@npm:3.10.0" + dependencies: + "@docusaurus/babel": "npm:3.10.0" + "@docusaurus/bundler": "npm:3.10.0" + "@docusaurus/logger": "npm:3.10.0" + "@docusaurus/mdx-loader": "npm:3.10.0" + "@docusaurus/utils": "npm:3.10.0" + "@docusaurus/utils-common": "npm:3.10.0" + "@docusaurus/utils-validation": "npm:3.10.0" boxen: "npm:^6.2.1" chalk: "npm:^4.1.2" chokidar: "npm:^3.5.3" @@ -2201,7 +2163,7 @@ __metadata: escape-html: "npm:^1.0.3" eta: "npm:^2.2.0" eval: "npm:^0.1.8" - execa: "npm:5.1.1" + execa: "npm:^5.1.1" fs-extra: "npm:^11.1.1" html-tags: "npm:^3.3.1" html-webpack-plugin: "npm:^5.6.0" @@ -2212,12 +2174,12 @@ __metadata: prompts: "npm:^2.4.2" react-helmet-async: "npm:@slorber/react-helmet-async@1.3.0" react-loadable: "npm:@docusaurus/react-loadable@6.0.0" - react-loadable-ssr-addon-v5-slorber: "npm:^1.0.1" + react-loadable-ssr-addon-v5-slorber: "npm:^1.0.3" react-router: "npm:^5.3.4" react-router-config: "npm:^5.1.1" react-router-dom: "npm:^5.3.4" semver: "npm:^7.5.4" - serve-handler: "npm:^6.1.6" + serve-handler: "npm:^6.1.7" tinypool: "npm:^1.0.2" tslib: "npm:^2.6.0" update-notifier: "npm:^6.0.2" @@ -2226,63 +2188,68 @@ __metadata: webpack-dev-server: "npm:^5.2.2" webpack-merge: "npm:^6.0.1" peerDependencies: + "@docusaurus/faster": "*" "@mdx-js/react": ^3.0.0 react: ^18.0.0 || ^19.0.0 react-dom: ^18.0.0 || ^19.0.0 + peerDependenciesMeta: + "@docusaurus/faster": + optional: true bin: docusaurus: bin/docusaurus.mjs - checksum: 10/3d6e1219648fdf8f32c3a53c06c79df512715edb054a524f1874d81f7a95f9bd599ca803ae9decbec3917ec648aa10606643f2b9c36b12ef349b4cbe3a4abf23 + checksum: 10/b381a15e6f0863bccf70ff509b1df57b0877effe9330aaa5840750ea61b04fc6e3f2ddc92ec86993397d709866cb3f7b5b7cb936432eddbecbfd81d2a4257ec3 languageName: node linkType: hard -"@docusaurus/cssnano-preset@npm:3.9.2": - version: 3.9.2 - resolution: "@docusaurus/cssnano-preset@npm:3.9.2" +"@docusaurus/cssnano-preset@npm:3.10.0": + version: 3.10.0 + resolution: "@docusaurus/cssnano-preset@npm:3.10.0" dependencies: cssnano-preset-advanced: "npm:^6.1.2" postcss: "npm:^8.5.4" postcss-sort-media-queries: "npm:^5.2.0" tslib: "npm:^2.6.0" - checksum: 10/21b9b787042ab00db945969c45fdd6fb489cd0811ad256e482b44db3d6846b4f9c54a5b360e76f7160736e2866602d690bbe29d3cb9b08577d7087b38720566f + checksum: 10/33f135f1514f8ccf6fc3aab90e43e980aa69c51f344418e8156dbc19913cb79a6c013e6512b074e277a7f1e2b716efad185f064abb3b864d78dcfda08404e833 languageName: node linkType: hard -"@docusaurus/faster@npm:^3.9.2": - version: 3.9.2 - resolution: "@docusaurus/faster@npm:3.9.2" +"@docusaurus/faster@npm:^3.10.0": + version: 3.10.0 + resolution: "@docusaurus/faster@npm:3.10.0" dependencies: - "@docusaurus/types": "npm:3.9.2" - "@rspack/core": "npm:^1.5.0" + "@docusaurus/types": "npm:3.10.0" + "@rspack/core": "npm:^1.7.10" "@swc/core": "npm:^1.7.39" "@swc/html": "npm:^1.13.5" browserslist: "npm:^4.24.2" lightningcss: "npm:^1.27.0" + semver: "npm:^7.5.4" swc-loader: "npm:^0.2.6" tslib: "npm:^2.6.0" webpack: "npm:^5.95.0" peerDependencies: "@docusaurus/types": "*" - checksum: 10/116c4df683a59199c2522407015ca066917accf2ab148fb93c36274c6db669feb23198a6dc15201205670e10fd7ce33a143c14827188f37084ad8ca0aac42824 + checksum: 10/4c3049456db7aeb9d606f8859d0535735f1291fc0730a6398c38a7be70a545cb4dba5c5a0baf890e1cfa1eb8ff7acf2869989876b2732f4dc0f1d7cf4e30edfa languageName: node linkType: hard -"@docusaurus/logger@npm:3.9.2": - version: 3.9.2 - resolution: "@docusaurus/logger@npm:3.9.2" +"@docusaurus/logger@npm:3.10.0": + version: 3.10.0 + resolution: "@docusaurus/logger@npm:3.10.0" dependencies: chalk: "npm:^4.1.2" tslib: "npm:^2.6.0" - checksum: 10/4d7b1bccc90fa108d7c8ffd1cd071ce2e179e0af9989f4c76acfe021789b186a15e4e56db55360df15de3e41f1d69c4e851a73cdf594fa02bb6fb219eaf48e57 + checksum: 10/9a591b9329efa0a7ea4d0d9cbc8c4f073a6ce4eec9ff77282061de0807130a03cbed962741323405df7eab94c47f28411d428999f5bd8de671f738d14a9f8a56 languageName: node linkType: hard -"@docusaurus/mdx-loader@npm:3.9.2": - version: 3.9.2 - resolution: "@docusaurus/mdx-loader@npm:3.9.2" +"@docusaurus/mdx-loader@npm:3.10.0": + version: 3.10.0 + resolution: "@docusaurus/mdx-loader@npm:3.10.0" dependencies: - "@docusaurus/logger": "npm:3.9.2" - "@docusaurus/utils": "npm:3.9.2" - "@docusaurus/utils-validation": "npm:3.9.2" + "@docusaurus/logger": "npm:3.10.0" + "@docusaurus/utils": "npm:3.10.0" + "@docusaurus/utils-validation": "npm:3.10.0" "@mdx-js/mdx": "npm:^3.0.0" "@slorber/remark-comment": "npm:^1.0.0" escape-html: "npm:^1.0.3" @@ -2307,15 +2274,15 @@ __metadata: peerDependencies: react: ^18.0.0 || ^19.0.0 react-dom: ^18.0.0 || ^19.0.0 - checksum: 10/00777730141774c9f465ee9b35a61c414e694f43995377c0f1a6a3fa07cca177eea45614be72a8ed40b094cdcc5fd2ba3762b68a4ad410071d2ea018a502d76e + checksum: 10/a5583b7221d25856750eafbd1134e09ec1e22d1260a9809c910e230cf8f1b60e6e9090af4f227c60d9e0221f6886a13badfc84829682a7027d6edef076ba9221 languageName: node linkType: hard -"@docusaurus/module-type-aliases@npm:3.9.2, @docusaurus/module-type-aliases@npm:^3.9.2": - version: 3.9.2 - resolution: "@docusaurus/module-type-aliases@npm:3.9.2" +"@docusaurus/module-type-aliases@npm:3.10.0, @docusaurus/module-type-aliases@npm:^3.10.0": + version: 3.10.0 + resolution: "@docusaurus/module-type-aliases@npm:3.10.0" dependencies: - "@docusaurus/types": "npm:3.9.2" + "@docusaurus/types": "npm:3.10.0" "@types/history": "npm:^4.7.11" "@types/react": "npm:*" "@types/react-router-config": "npm:*" @@ -2325,23 +2292,24 @@ __metadata: peerDependencies: react: "*" react-dom: "*" - checksum: 10/6b47ea9f31871e7200ca8c76016496a524fa0b0458ab9bdd582afbd79a9c1756c1ad8414c1cf8ff942b94b2505d1a50492963d8d59294cafc5f7b894e82f3d5f + checksum: 10/0c5355fa87e76b5f633a59b7b11b465f131cd1dadc3bf0f6a677cab9d05459dae559dcd21bf9c90751f540bf7707967a23b1e163a24b2bdd127f6126b546a878 languageName: node linkType: hard -"@docusaurus/plugin-content-blog@npm:3.9.2": - version: 3.9.2 - resolution: "@docusaurus/plugin-content-blog@npm:3.9.2" - dependencies: - "@docusaurus/core": "npm:3.9.2" - "@docusaurus/logger": "npm:3.9.2" - "@docusaurus/mdx-loader": "npm:3.9.2" - "@docusaurus/theme-common": "npm:3.9.2" - "@docusaurus/types": "npm:3.9.2" - "@docusaurus/utils": "npm:3.9.2" - "@docusaurus/utils-common": "npm:3.9.2" - "@docusaurus/utils-validation": "npm:3.9.2" +"@docusaurus/plugin-content-blog@npm:3.10.0": + version: 3.10.0 + resolution: "@docusaurus/plugin-content-blog@npm:3.10.0" + dependencies: + "@docusaurus/core": "npm:3.10.0" + "@docusaurus/logger": "npm:3.10.0" + "@docusaurus/mdx-loader": "npm:3.10.0" + "@docusaurus/theme-common": "npm:3.10.0" + "@docusaurus/types": "npm:3.10.0" + "@docusaurus/utils": "npm:3.10.0" + "@docusaurus/utils-common": "npm:3.10.0" + "@docusaurus/utils-validation": "npm:3.10.0" cheerio: "npm:1.0.0-rc.12" + combine-promises: "npm:^1.1.0" feed: "npm:^4.2.2" fs-extra: "npm:^11.1.1" lodash: "npm:^4.17.21" @@ -2355,23 +2323,23 @@ __metadata: "@docusaurus/plugin-content-docs": "*" react: ^18.0.0 || ^19.0.0 react-dom: ^18.0.0 || ^19.0.0 - checksum: 10/86680042f4b36acf22a7f83cd432eebca31d2770027595e48151b21e081bc50bf18f4e090549a69dd2d4da49cec83953bfb40c71c1a3a91d36ddd0f84351a659 + checksum: 10/ecd2ff3c1206b4ffc3171c78c9d60555de9f08fc9cd9105bc9336b5a1dab005f9aa9639f38b62e481f11c1cc9b48616b72f252ea9b6d4cb1f1ca113c10b4a3b9 languageName: node linkType: hard -"@docusaurus/plugin-content-docs@npm:3.9.2": - version: 3.9.2 - resolution: "@docusaurus/plugin-content-docs@npm:3.9.2" - dependencies: - "@docusaurus/core": "npm:3.9.2" - "@docusaurus/logger": "npm:3.9.2" - "@docusaurus/mdx-loader": "npm:3.9.2" - "@docusaurus/module-type-aliases": "npm:3.9.2" - "@docusaurus/theme-common": "npm:3.9.2" - "@docusaurus/types": "npm:3.9.2" - "@docusaurus/utils": "npm:3.9.2" - "@docusaurus/utils-common": "npm:3.9.2" - "@docusaurus/utils-validation": "npm:3.9.2" +"@docusaurus/plugin-content-docs@npm:3.10.0": + version: 3.10.0 + resolution: "@docusaurus/plugin-content-docs@npm:3.10.0" + dependencies: + "@docusaurus/core": "npm:3.10.0" + "@docusaurus/logger": "npm:3.10.0" + "@docusaurus/mdx-loader": "npm:3.10.0" + "@docusaurus/module-type-aliases": "npm:3.10.0" + "@docusaurus/theme-common": "npm:3.10.0" + "@docusaurus/types": "npm:3.10.0" + "@docusaurus/utils": "npm:3.10.0" + "@docusaurus/utils-common": "npm:3.10.0" + "@docusaurus/utils-validation": "npm:3.10.0" "@types/react-router-config": "npm:^5.0.7" combine-promises: "npm:^1.1.0" fs-extra: "npm:^11.1.1" @@ -2384,133 +2352,133 @@ __metadata: peerDependencies: react: ^18.0.0 || ^19.0.0 react-dom: ^18.0.0 || ^19.0.0 - checksum: 10/5a3fb39a1add1f5db8aabd03b56f65e988a776d5983def89b6b4f17ab0c78dd4de255aab080a082aa8e7e7915da1705277148789fada56d9c6d9ad8f468e784e + checksum: 10/83a45c0df18023cfd1eb60b32d7d2bfc8a3824a0c0c6aeed13a09989da56ecded944f99c981656065c462a152e5dff2321dafae55e5a10aba8503131a846b1fc languageName: node linkType: hard -"@docusaurus/plugin-content-pages@npm:3.9.2": - version: 3.9.2 - resolution: "@docusaurus/plugin-content-pages@npm:3.9.2" +"@docusaurus/plugin-content-pages@npm:3.10.0": + version: 3.10.0 + resolution: "@docusaurus/plugin-content-pages@npm:3.10.0" dependencies: - "@docusaurus/core": "npm:3.9.2" - "@docusaurus/mdx-loader": "npm:3.9.2" - "@docusaurus/types": "npm:3.9.2" - "@docusaurus/utils": "npm:3.9.2" - "@docusaurus/utils-validation": "npm:3.9.2" + "@docusaurus/core": "npm:3.10.0" + "@docusaurus/mdx-loader": "npm:3.10.0" + "@docusaurus/types": "npm:3.10.0" + "@docusaurus/utils": "npm:3.10.0" + "@docusaurus/utils-validation": "npm:3.10.0" fs-extra: "npm:^11.1.1" tslib: "npm:^2.6.0" webpack: "npm:^5.88.1" peerDependencies: react: ^18.0.0 || ^19.0.0 react-dom: ^18.0.0 || ^19.0.0 - checksum: 10/341b5ac4d4e55fcb8f72cad3977f548e19061d4bb19392f5dea194cdb7f7d260640ed656a793145809fc8c0ca5fb15cac6e9b6c73545a83dfcd0463cad3f60a2 + checksum: 10/0f2f80a6686b8d76cdffa6182be2bcc60130d616bbab99af2353bf7824bcd89a0ec67b2ef5923ad83b5d385a2096def016ffc55542d682154a68d232ec8dea31 languageName: node linkType: hard -"@docusaurus/plugin-css-cascade-layers@npm:3.9.2": - version: 3.9.2 - resolution: "@docusaurus/plugin-css-cascade-layers@npm:3.9.2" +"@docusaurus/plugin-css-cascade-layers@npm:3.10.0": + version: 3.10.0 + resolution: "@docusaurus/plugin-css-cascade-layers@npm:3.10.0" dependencies: - "@docusaurus/core": "npm:3.9.2" - "@docusaurus/types": "npm:3.9.2" - "@docusaurus/utils": "npm:3.9.2" - "@docusaurus/utils-validation": "npm:3.9.2" + "@docusaurus/core": "npm:3.10.0" + "@docusaurus/types": "npm:3.10.0" + "@docusaurus/utils": "npm:3.10.0" + "@docusaurus/utils-validation": "npm:3.10.0" tslib: "npm:^2.6.0" - checksum: 10/039debb4e3764b9ecb6aafa2b7ca1d59f2cf52bb4f4e71390394d554149b0bc9a7aa355f2ea72a92c2e2fbdd5b7ed7843cd8100d1b8d0f62187588253ff8d6d5 + checksum: 10/a896b09efbe2909a6fca3440bb3d7943760bbade8a8b79ede0b755bdaae09bf7557825ed9d9b6434b9d1c5e9133cf5042cf25dd9f631dde256864a1cad29bd57 languageName: node linkType: hard -"@docusaurus/plugin-debug@npm:3.9.2": - version: 3.9.2 - resolution: "@docusaurus/plugin-debug@npm:3.9.2" +"@docusaurus/plugin-debug@npm:3.10.0": + version: 3.10.0 + resolution: "@docusaurus/plugin-debug@npm:3.10.0" dependencies: - "@docusaurus/core": "npm:3.9.2" - "@docusaurus/types": "npm:3.9.2" - "@docusaurus/utils": "npm:3.9.2" + "@docusaurus/core": "npm:3.10.0" + "@docusaurus/types": "npm:3.10.0" + "@docusaurus/utils": "npm:3.10.0" fs-extra: "npm:^11.1.1" react-json-view-lite: "npm:^2.3.0" tslib: "npm:^2.6.0" peerDependencies: react: ^18.0.0 || ^19.0.0 react-dom: ^18.0.0 || ^19.0.0 - checksum: 10/8974d17143f3b379c977441011f6c9daa8d38eb484c33726b9e9a63012553e66847a1a18e7e86ed52bc5321d2833ee8e934a1619afcdd669b255089ffd23a506 + checksum: 10/3102312bea7aaafd88de52f7850bd4a1b6045e20b712f8cf1bff26a7200df8473576c166637857680509dedacfadf9c22f40ee913c62e0a0e9bdc11c848b620a languageName: node linkType: hard -"@docusaurus/plugin-google-analytics@npm:3.9.2": - version: 3.9.2 - resolution: "@docusaurus/plugin-google-analytics@npm:3.9.2" +"@docusaurus/plugin-google-analytics@npm:3.10.0": + version: 3.10.0 + resolution: "@docusaurus/plugin-google-analytics@npm:3.10.0" dependencies: - "@docusaurus/core": "npm:3.9.2" - "@docusaurus/types": "npm:3.9.2" - "@docusaurus/utils-validation": "npm:3.9.2" + "@docusaurus/core": "npm:3.10.0" + "@docusaurus/types": "npm:3.10.0" + "@docusaurus/utils-validation": "npm:3.10.0" tslib: "npm:^2.6.0" peerDependencies: react: ^18.0.0 || ^19.0.0 react-dom: ^18.0.0 || ^19.0.0 - checksum: 10/026ffe26b4e47adf509f3de79a9a4b095e0374e4db0ce73041f9d28933df1e7697069bce7a0be1744eeca2b2d5ed057f023f4f2e98aff838b33cc2c2d1eed882 + checksum: 10/f924e1a43cc6033d538b820ac184c8c9b886fbe88883c1c11cc8da318cc34b8b600c6cb7775b35588362adc90bce99a6c71470e4ce4fc7993c3c7162d846428b languageName: node linkType: hard -"@docusaurus/plugin-google-gtag@npm:3.9.2": - version: 3.9.2 - resolution: "@docusaurus/plugin-google-gtag@npm:3.9.2" +"@docusaurus/plugin-google-gtag@npm:3.10.0": + version: 3.10.0 + resolution: "@docusaurus/plugin-google-gtag@npm:3.10.0" dependencies: - "@docusaurus/core": "npm:3.9.2" - "@docusaurus/types": "npm:3.9.2" - "@docusaurus/utils-validation": "npm:3.9.2" - "@types/gtag.js": "npm:^0.0.12" + "@docusaurus/core": "npm:3.10.0" + "@docusaurus/types": "npm:3.10.0" + "@docusaurus/utils-validation": "npm:3.10.0" + "@types/gtag.js": "npm:^0.0.20" tslib: "npm:^2.6.0" peerDependencies: react: ^18.0.0 || ^19.0.0 react-dom: ^18.0.0 || ^19.0.0 - checksum: 10/ee596c5a1d1a71d947c390274326b46a9aeb56c3d0c0c0b672629e890e783f6f6947505dc66ee0abe4d70fe61f743ff9df0a4b4cdc4fe3994eefbb1a4386769b + checksum: 10/9ccf7eedae66daf43c07a3bd1f2033f42c2baa148d134182c00b13f643713dd7199c43fcb3812b2ec0845aa82ece5309f80f4ddd78d8f2066001a00e0b8ec276 languageName: node linkType: hard -"@docusaurus/plugin-google-tag-manager@npm:3.9.2": - version: 3.9.2 - resolution: "@docusaurus/plugin-google-tag-manager@npm:3.9.2" +"@docusaurus/plugin-google-tag-manager@npm:3.10.0": + version: 3.10.0 + resolution: "@docusaurus/plugin-google-tag-manager@npm:3.10.0" dependencies: - "@docusaurus/core": "npm:3.9.2" - "@docusaurus/types": "npm:3.9.2" - "@docusaurus/utils-validation": "npm:3.9.2" + "@docusaurus/core": "npm:3.10.0" + "@docusaurus/types": "npm:3.10.0" + "@docusaurus/utils-validation": "npm:3.10.0" tslib: "npm:^2.6.0" peerDependencies: react: ^18.0.0 || ^19.0.0 react-dom: ^18.0.0 || ^19.0.0 - checksum: 10/0c4ee07b5ee2cdf252b53aa52b54f42ae591441df5e289e2a1614bcabe1852f973ec65a1086c7682f7e5a5e65a50c0597ed9c393505c2902f1a52569798ef6c0 + checksum: 10/14fa4a697605ea8099705fe28bf5fbee56377d95dd7a8b04ba94dd70fa7a502b4ce2fc05d02bf3f93ce10d3d5ecd4510e96f0c8d7ae715a854c9be103c3f27b7 languageName: node linkType: hard -"@docusaurus/plugin-sitemap@npm:3.9.2": - version: 3.9.2 - resolution: "@docusaurus/plugin-sitemap@npm:3.9.2" - dependencies: - "@docusaurus/core": "npm:3.9.2" - "@docusaurus/logger": "npm:3.9.2" - "@docusaurus/types": "npm:3.9.2" - "@docusaurus/utils": "npm:3.9.2" - "@docusaurus/utils-common": "npm:3.9.2" - "@docusaurus/utils-validation": "npm:3.9.2" +"@docusaurus/plugin-sitemap@npm:3.10.0": + version: 3.10.0 + resolution: "@docusaurus/plugin-sitemap@npm:3.10.0" + dependencies: + "@docusaurus/core": "npm:3.10.0" + "@docusaurus/logger": "npm:3.10.0" + "@docusaurus/types": "npm:3.10.0" + "@docusaurus/utils": "npm:3.10.0" + "@docusaurus/utils-common": "npm:3.10.0" + "@docusaurus/utils-validation": "npm:3.10.0" fs-extra: "npm:^11.1.1" sitemap: "npm:^7.1.1" tslib: "npm:^2.6.0" peerDependencies: react: ^18.0.0 || ^19.0.0 react-dom: ^18.0.0 || ^19.0.0 - checksum: 10/adba37c28fadf7901b6d12253093b92c90856a00f98f9830b039fdcb92c2472cdb43a0f939a9d3012db0e003571fd77e6cb58972c375b70b7bae748be2a6f263 + checksum: 10/5aed6baec8eb693da69225bd890afcd2a5c602cc6509ea36943aa3e387bd7fc229537d4127e5b57da41da4bfdfd78e5ec1ed16ff4a38397e7b85315352d8d1a4 languageName: node linkType: hard -"@docusaurus/plugin-svgr@npm:3.9.2": - version: 3.9.2 - resolution: "@docusaurus/plugin-svgr@npm:3.9.2" +"@docusaurus/plugin-svgr@npm:3.10.0": + version: 3.10.0 + resolution: "@docusaurus/plugin-svgr@npm:3.10.0" dependencies: - "@docusaurus/core": "npm:3.9.2" - "@docusaurus/types": "npm:3.9.2" - "@docusaurus/utils": "npm:3.9.2" - "@docusaurus/utils-validation": "npm:3.9.2" + "@docusaurus/core": "npm:3.10.0" + "@docusaurus/types": "npm:3.10.0" + "@docusaurus/utils": "npm:3.10.0" + "@docusaurus/utils-validation": "npm:3.10.0" "@svgr/core": "npm:8.1.0" "@svgr/webpack": "npm:^8.1.0" tslib: "npm:^2.6.0" @@ -2518,68 +2486,69 @@ __metadata: peerDependencies: react: ^18.0.0 || ^19.0.0 react-dom: ^18.0.0 || ^19.0.0 - checksum: 10/5e5b7789a34c1d013d248e41ea8704dc22174aaff4fdd77336886021f5ae38e435bb8109b97f122ba2ecbcba87a8d0cd0705987e2fc014162d567ea38cc1ee04 - languageName: node - linkType: hard - -"@docusaurus/preset-classic@npm:^3.9.2": - version: 3.9.2 - resolution: "@docusaurus/preset-classic@npm:3.9.2" - dependencies: - "@docusaurus/core": "npm:3.9.2" - "@docusaurus/plugin-content-blog": "npm:3.9.2" - "@docusaurus/plugin-content-docs": "npm:3.9.2" - "@docusaurus/plugin-content-pages": "npm:3.9.2" - "@docusaurus/plugin-css-cascade-layers": "npm:3.9.2" - "@docusaurus/plugin-debug": "npm:3.9.2" - "@docusaurus/plugin-google-analytics": "npm:3.9.2" - "@docusaurus/plugin-google-gtag": "npm:3.9.2" - "@docusaurus/plugin-google-tag-manager": "npm:3.9.2" - "@docusaurus/plugin-sitemap": "npm:3.9.2" - "@docusaurus/plugin-svgr": "npm:3.9.2" - "@docusaurus/theme-classic": "npm:3.9.2" - "@docusaurus/theme-common": "npm:3.9.2" - "@docusaurus/theme-search-algolia": "npm:3.9.2" - "@docusaurus/types": "npm:3.9.2" + checksum: 10/87aa7b2b618023b5eb16512a4dac712e91b0afb250b11fb935eefaf58d3a974ca09563e940b3295de272b90af9cb7e3b04d5ac4d3f2e5e629a99624e6919c740 + languageName: node + linkType: hard + +"@docusaurus/preset-classic@npm:^3.10.0": + version: 3.10.0 + resolution: "@docusaurus/preset-classic@npm:3.10.0" + dependencies: + "@docusaurus/core": "npm:3.10.0" + "@docusaurus/plugin-content-blog": "npm:3.10.0" + "@docusaurus/plugin-content-docs": "npm:3.10.0" + "@docusaurus/plugin-content-pages": "npm:3.10.0" + "@docusaurus/plugin-css-cascade-layers": "npm:3.10.0" + "@docusaurus/plugin-debug": "npm:3.10.0" + "@docusaurus/plugin-google-analytics": "npm:3.10.0" + "@docusaurus/plugin-google-gtag": "npm:3.10.0" + "@docusaurus/plugin-google-tag-manager": "npm:3.10.0" + "@docusaurus/plugin-sitemap": "npm:3.10.0" + "@docusaurus/plugin-svgr": "npm:3.10.0" + "@docusaurus/theme-classic": "npm:3.10.0" + "@docusaurus/theme-common": "npm:3.10.0" + "@docusaurus/theme-search-algolia": "npm:3.10.0" + "@docusaurus/types": "npm:3.10.0" peerDependencies: react: ^18.0.0 || ^19.0.0 react-dom: ^18.0.0 || ^19.0.0 - checksum: 10/ae8328253111429e9ca219273d5ae8c39f26a98c2422b25a8d233e3a0f2737e453dd1dbcc29e4c9a601b936d0217b3e91dce218d12f9f33793ae3120ed629c1c + checksum: 10/86460f00296a5b99dbb970ba922e9695f0ab7450e17ac7b76b3d029408f4456d2b9ac4554cf75671b6f677cef9ad3d95da7705458147297ecb3d54796c16d308 languageName: node linkType: hard -"@docusaurus/remark-plugin-npm2yarn@npm:^3.9.2": - version: 3.9.2 - resolution: "@docusaurus/remark-plugin-npm2yarn@npm:3.9.2" +"@docusaurus/remark-plugin-npm2yarn@npm:^3.10.0": + version: 3.10.0 + resolution: "@docusaurus/remark-plugin-npm2yarn@npm:3.10.0" dependencies: mdast-util-mdx: "npm:^3.0.0" npm-to-yarn: "npm:^3.0.0" tslib: "npm:^2.6.0" unified: "npm:^11.0.3" unist-util-visit: "npm:^5.0.0" - checksum: 10/29d19917564b13d1fa8133385ea6a3e88bac5056af312c8390ae15ce4ced3d026dbda7881f8a167536938f33d16d1cc353409b60bc14aa3ed2f1fb24c7bef230 - languageName: node - linkType: hard - -"@docusaurus/theme-classic@npm:3.9.2": - version: 3.9.2 - resolution: "@docusaurus/theme-classic@npm:3.9.2" - dependencies: - "@docusaurus/core": "npm:3.9.2" - "@docusaurus/logger": "npm:3.9.2" - "@docusaurus/mdx-loader": "npm:3.9.2" - "@docusaurus/module-type-aliases": "npm:3.9.2" - "@docusaurus/plugin-content-blog": "npm:3.9.2" - "@docusaurus/plugin-content-docs": "npm:3.9.2" - "@docusaurus/plugin-content-pages": "npm:3.9.2" - "@docusaurus/theme-common": "npm:3.9.2" - "@docusaurus/theme-translations": "npm:3.9.2" - "@docusaurus/types": "npm:3.9.2" - "@docusaurus/utils": "npm:3.9.2" - "@docusaurus/utils-common": "npm:3.9.2" - "@docusaurus/utils-validation": "npm:3.9.2" + checksum: 10/6b1b9d752cce1abf89bca591486f14d08871925879f05b83f4062c7198ff473abfa8461f4e795d83c6f889f51fdde4ef4f5bd5bfdef7a81496f2c1d87ea5f4b3 + languageName: node + linkType: hard + +"@docusaurus/theme-classic@npm:3.10.0": + version: 3.10.0 + resolution: "@docusaurus/theme-classic@npm:3.10.0" + dependencies: + "@docusaurus/core": "npm:3.10.0" + "@docusaurus/logger": "npm:3.10.0" + "@docusaurus/mdx-loader": "npm:3.10.0" + "@docusaurus/module-type-aliases": "npm:3.10.0" + "@docusaurus/plugin-content-blog": "npm:3.10.0" + "@docusaurus/plugin-content-docs": "npm:3.10.0" + "@docusaurus/plugin-content-pages": "npm:3.10.0" + "@docusaurus/theme-common": "npm:3.10.0" + "@docusaurus/theme-translations": "npm:3.10.0" + "@docusaurus/types": "npm:3.10.0" + "@docusaurus/utils": "npm:3.10.0" + "@docusaurus/utils-common": "npm:3.10.0" + "@docusaurus/utils-validation": "npm:3.10.0" "@mdx-js/react": "npm:^3.0.0" clsx: "npm:^2.0.0" + copy-text-to-clipboard: "npm:^3.2.0" infima: "npm:0.2.0-alpha.45" lodash: "npm:^4.17.21" nprogress: "npm:^0.2.0" @@ -2593,18 +2562,18 @@ __metadata: peerDependencies: react: ^18.0.0 || ^19.0.0 react-dom: ^18.0.0 || ^19.0.0 - checksum: 10/aeb889cf6d0d4b8836d4684d775b70098f675f3d53cf24cca773784d7ed9ffa33c6240ea87bcd33b9abb6a66ba6a4c3c1d16c004da1e6ad4167af5600f3131d6 + checksum: 10/d9f11b0d1e0ff4c333ec04879aae71548056a7ef1d49528533cfbbe463c15ab5f65f00c8bc44bb7a5766bdb06d16fb94528446e922ff6b11625c6e93a555e798 languageName: node linkType: hard -"@docusaurus/theme-common@npm:3.9.2": - version: 3.9.2 - resolution: "@docusaurus/theme-common@npm:3.9.2" +"@docusaurus/theme-common@npm:3.10.0": + version: 3.10.0 + resolution: "@docusaurus/theme-common@npm:3.10.0" dependencies: - "@docusaurus/mdx-loader": "npm:3.9.2" - "@docusaurus/module-type-aliases": "npm:3.9.2" - "@docusaurus/utils": "npm:3.9.2" - "@docusaurus/utils-common": "npm:3.9.2" + "@docusaurus/mdx-loader": "npm:3.10.0" + "@docusaurus/module-type-aliases": "npm:3.10.0" + "@docusaurus/utils": "npm:3.10.0" + "@docusaurus/utils-common": "npm:3.10.0" "@types/history": "npm:^4.7.11" "@types/react": "npm:*" "@types/react-router-config": "npm:*" @@ -2617,22 +2586,23 @@ __metadata: "@docusaurus/plugin-content-docs": "*" react: ^18.0.0 || ^19.0.0 react-dom: ^18.0.0 || ^19.0.0 - checksum: 10/697a23f4bcad3ec49af6386e939f5d10c04c7160daaee11e78c021b385a18d6d040f6c7a86f8f8d0e076fc2d2abd4eea71d51849bebc8c409af5d73a7b2c6738 + checksum: 10/d658beec02be44c7572de7670c7b9bf80430124a1e2b44456dd86fb769e7c2544f845a7ca3d1b82ceb04d734472a227add1dedbe31d9f12051fab343f6aece25 languageName: node linkType: hard -"@docusaurus/theme-search-algolia@npm:3.9.2": - version: 3.9.2 - resolution: "@docusaurus/theme-search-algolia@npm:3.9.2" - dependencies: - "@docsearch/react": "npm:^3.9.0 || ^4.1.0" - "@docusaurus/core": "npm:3.9.2" - "@docusaurus/logger": "npm:3.9.2" - "@docusaurus/plugin-content-docs": "npm:3.9.2" - "@docusaurus/theme-common": "npm:3.9.2" - "@docusaurus/theme-translations": "npm:3.9.2" - "@docusaurus/utils": "npm:3.9.2" - "@docusaurus/utils-validation": "npm:3.9.2" +"@docusaurus/theme-search-algolia@npm:3.10.0": + version: 3.10.0 + resolution: "@docusaurus/theme-search-algolia@npm:3.10.0" + dependencies: + "@algolia/autocomplete-core": "npm:^1.19.2" + "@docsearch/react": "npm:^3.9.0 || ^4.3.2" + "@docusaurus/core": "npm:3.10.0" + "@docusaurus/logger": "npm:3.10.0" + "@docusaurus/plugin-content-docs": "npm:3.10.0" + "@docusaurus/theme-common": "npm:3.10.0" + "@docusaurus/theme-translations": "npm:3.10.0" + "@docusaurus/utils": "npm:3.10.0" + "@docusaurus/utils-validation": "npm:3.10.0" algoliasearch: "npm:^5.37.0" algoliasearch-helper: "npm:^3.26.0" clsx: "npm:^2.0.0" @@ -2644,23 +2614,23 @@ __metadata: peerDependencies: react: ^18.0.0 || ^19.0.0 react-dom: ^18.0.0 || ^19.0.0 - checksum: 10/e2623c11c69a40eaec8cbf76e4b19444c0929ee47a899882dc0b5e314153e64aa1ed64b7a0ea0b182bdf418e616191a147e5ff5ff9679efec761e0757d7a0825 + checksum: 10/d7e1afb3459d14c16fc3c66f4bc617fa7c9dc0e4ca5ada269c153cf08c91a66526c23b7e5ea607fc44f9f5f31549e109bd8f74b197020cf9ce5a5bc58e6c7773 languageName: node linkType: hard -"@docusaurus/theme-translations@npm:3.9.2": - version: 3.9.2 - resolution: "@docusaurus/theme-translations@npm:3.9.2" +"@docusaurus/theme-translations@npm:3.10.0": + version: 3.10.0 + resolution: "@docusaurus/theme-translations@npm:3.10.0" dependencies: fs-extra: "npm:^11.1.1" tslib: "npm:^2.6.0" - checksum: 10/a98b5a7b1d7f123b5609caadea4000b4ee956426396d4a62ce675bd1e0fe7fd65be3bba2ef97b2ec3f84bafd65fd53d1d55d3a35c585ddc7288ebca199c5a865 + checksum: 10/3181469e799574995d90343b4c29549d6050b06ae7b8d7246da07d4eecd0edac22526883e333298b323b046c87606e7ff696acd9a696e755d77a5789b6ca71d6 languageName: node linkType: hard -"@docusaurus/types@npm:3.9.2": - version: 3.9.2 - resolution: "@docusaurus/types@npm:3.9.2" +"@docusaurus/types@npm:3.10.0": + version: 3.10.0 + resolution: "@docusaurus/types@npm:3.10.0" dependencies: "@mdx-js/mdx": "npm:^3.0.0" "@types/history": "npm:^4.7.11" @@ -2675,45 +2645,45 @@ __metadata: peerDependencies: react: ^18.0.0 || ^19.0.0 react-dom: ^18.0.0 || ^19.0.0 - checksum: 10/bc91d05a206de008bfb301873877dd531b361d64a40d1301106a6952901bb3662d349e0e0c9af9e40ff1b6c7764741cc86e15e4d116c1b7d7f065dde0e8e38e1 + checksum: 10/93bca66d61e53b61aefd096e0cc3bb473469b65fe0d7cda7a0a0478bf08f4fd690c2b5c840cd21ac73864b7fec54a012d8d4ab5243543c56d8aedd346d462396 languageName: node linkType: hard -"@docusaurus/utils-common@npm:3.9.2": - version: 3.9.2 - resolution: "@docusaurus/utils-common@npm:3.9.2" +"@docusaurus/utils-common@npm:3.10.0": + version: 3.10.0 + resolution: "@docusaurus/utils-common@npm:3.10.0" dependencies: - "@docusaurus/types": "npm:3.9.2" + "@docusaurus/types": "npm:3.10.0" tslib: "npm:^2.6.0" - checksum: 10/77e01da05ebbf202343b3131ffaba7132c764ccc0ab48dd4421535c75a59e2d4a1dcaf8471cde257b5394528ada52f79da6398f6f2eb9fde79904be736f19275 + checksum: 10/9ac7f6eff02b38d8eedafc9c5ec94ac6e449aa6a39649ad85b573a442d64c54bb88b7a204c05858fffc6ad51ebc6899c56584f4b2a9030e0470c00e6da90a10f languageName: node linkType: hard -"@docusaurus/utils-validation@npm:3.9.2": - version: 3.9.2 - resolution: "@docusaurus/utils-validation@npm:3.9.2" +"@docusaurus/utils-validation@npm:3.10.0": + version: 3.10.0 + resolution: "@docusaurus/utils-validation@npm:3.10.0" dependencies: - "@docusaurus/logger": "npm:3.9.2" - "@docusaurus/utils": "npm:3.9.2" - "@docusaurus/utils-common": "npm:3.9.2" + "@docusaurus/logger": "npm:3.10.0" + "@docusaurus/utils": "npm:3.10.0" + "@docusaurus/utils-common": "npm:3.10.0" fs-extra: "npm:^11.2.0" joi: "npm:^17.9.2" js-yaml: "npm:^4.1.0" lodash: "npm:^4.17.21" tslib: "npm:^2.6.0" - checksum: 10/d8a853d7e79efd986be4dd3eb575ac287b58aa2363086742856671bace480f3ee35920634057d661fba2bda5992c7d45ac5dc021d77e5882e356d735e428e60f + checksum: 10/0b51f881fbacd56982945f1209caafbc827e0da096f2fcc1afd67dd81baf81b4f337a3cad2fcc6c80525e057fcb75e27e87e92fdedc96b008f39b7ae81d458d7 languageName: node linkType: hard -"@docusaurus/utils@npm:3.9.2": - version: 3.9.2 - resolution: "@docusaurus/utils@npm:3.9.2" +"@docusaurus/utils@npm:3.10.0": + version: 3.10.0 + resolution: "@docusaurus/utils@npm:3.10.0" dependencies: - "@docusaurus/logger": "npm:3.9.2" - "@docusaurus/types": "npm:3.9.2" - "@docusaurus/utils-common": "npm:3.9.2" + "@docusaurus/logger": "npm:3.10.0" + "@docusaurus/types": "npm:3.10.0" + "@docusaurus/utils-common": "npm:3.10.0" escape-string-regexp: "npm:^4.0.0" - execa: "npm:5.1.1" + execa: "npm:^5.1.1" file-loader: "npm:^6.2.0" fs-extra: "npm:^11.1.1" github-slugger: "npm:^1.5.0" @@ -2730,7 +2700,7 @@ __metadata: url-loader: "npm:^4.1.1" utility-types: "npm:^3.10.0" webpack: "npm:^5.88.1" - checksum: 10/bb4f24acd4fb2d998186d4bd315c5bb481e6afa3a1dfaa549bb52e2b0d4cb94bc9f635bd897690838cc812a0cff3a30cf3ab713b2d74221902b58c2214ce5268 + checksum: 10/04f0dbbf7b1239e4a47fc16a668395941b5744adc4728959c9cdddef5b6134e02502957e9f443933329e3fd9b5abcf8aff0c2599522048aff6b9be4dd18d6057 languageName: node linkType: hard @@ -3360,13 +3330,6 @@ __metadata: languageName: node linkType: hard -"@opentelemetry/api@npm:1.9.0": - version: 1.9.0 - resolution: "@opentelemetry/api@npm:1.9.0" - checksum: 10/a607f0eef971893c4f2ee2a4c2069aade6ec3e84e2a1f5c2aac19f65c5d9eeea41aa72db917c1029faafdd71789a1a040bdc18f40d63690e22ccae5d7070f194 - languageName: node - linkType: hard - "@pnpm/config.env-replace@npm:^1.1.0": version: 1.1.0 resolution: "@pnpm/config.env-replace@npm:1.1.0" @@ -3401,92 +3364,92 @@ __metadata: languageName: node linkType: hard -"@rspack/binding-darwin-arm64@npm:1.7.0": - version: 1.7.0 - resolution: "@rspack/binding-darwin-arm64@npm:1.7.0" +"@rspack/binding-darwin-arm64@npm:1.7.11": + version: 1.7.11 + resolution: "@rspack/binding-darwin-arm64@npm:1.7.11" conditions: os=darwin & cpu=arm64 languageName: node linkType: hard -"@rspack/binding-darwin-x64@npm:1.7.0": - version: 1.7.0 - resolution: "@rspack/binding-darwin-x64@npm:1.7.0" +"@rspack/binding-darwin-x64@npm:1.7.11": + version: 1.7.11 + resolution: "@rspack/binding-darwin-x64@npm:1.7.11" conditions: os=darwin & cpu=x64 languageName: node linkType: hard -"@rspack/binding-linux-arm64-gnu@npm:1.7.0": - version: 1.7.0 - resolution: "@rspack/binding-linux-arm64-gnu@npm:1.7.0" +"@rspack/binding-linux-arm64-gnu@npm:1.7.11": + version: 1.7.11 + resolution: "@rspack/binding-linux-arm64-gnu@npm:1.7.11" conditions: os=linux & cpu=arm64 & libc=glibc languageName: node linkType: hard -"@rspack/binding-linux-arm64-musl@npm:1.7.0": - version: 1.7.0 - resolution: "@rspack/binding-linux-arm64-musl@npm:1.7.0" +"@rspack/binding-linux-arm64-musl@npm:1.7.11": + version: 1.7.11 + resolution: "@rspack/binding-linux-arm64-musl@npm:1.7.11" conditions: os=linux & cpu=arm64 & libc=musl languageName: node linkType: hard -"@rspack/binding-linux-x64-gnu@npm:1.7.0": - version: 1.7.0 - resolution: "@rspack/binding-linux-x64-gnu@npm:1.7.0" +"@rspack/binding-linux-x64-gnu@npm:1.7.11": + version: 1.7.11 + resolution: "@rspack/binding-linux-x64-gnu@npm:1.7.11" conditions: os=linux & cpu=x64 & libc=glibc languageName: node linkType: hard -"@rspack/binding-linux-x64-musl@npm:1.7.0": - version: 1.7.0 - resolution: "@rspack/binding-linux-x64-musl@npm:1.7.0" +"@rspack/binding-linux-x64-musl@npm:1.7.11": + version: 1.7.11 + resolution: "@rspack/binding-linux-x64-musl@npm:1.7.11" conditions: os=linux & cpu=x64 & libc=musl languageName: node linkType: hard -"@rspack/binding-wasm32-wasi@npm:1.7.0": - version: 1.7.0 - resolution: "@rspack/binding-wasm32-wasi@npm:1.7.0" +"@rspack/binding-wasm32-wasi@npm:1.7.11": + version: 1.7.11 + resolution: "@rspack/binding-wasm32-wasi@npm:1.7.11" dependencies: "@napi-rs/wasm-runtime": "npm:1.0.7" conditions: cpu=wasm32 languageName: node linkType: hard -"@rspack/binding-win32-arm64-msvc@npm:1.7.0": - version: 1.7.0 - resolution: "@rspack/binding-win32-arm64-msvc@npm:1.7.0" +"@rspack/binding-win32-arm64-msvc@npm:1.7.11": + version: 1.7.11 + resolution: "@rspack/binding-win32-arm64-msvc@npm:1.7.11" conditions: os=win32 & cpu=arm64 languageName: node linkType: hard -"@rspack/binding-win32-ia32-msvc@npm:1.7.0": - version: 1.7.0 - resolution: "@rspack/binding-win32-ia32-msvc@npm:1.7.0" +"@rspack/binding-win32-ia32-msvc@npm:1.7.11": + version: 1.7.11 + resolution: "@rspack/binding-win32-ia32-msvc@npm:1.7.11" conditions: os=win32 & cpu=ia32 languageName: node linkType: hard -"@rspack/binding-win32-x64-msvc@npm:1.7.0": - version: 1.7.0 - resolution: "@rspack/binding-win32-x64-msvc@npm:1.7.0" +"@rspack/binding-win32-x64-msvc@npm:1.7.11": + version: 1.7.11 + resolution: "@rspack/binding-win32-x64-msvc@npm:1.7.11" conditions: os=win32 & cpu=x64 languageName: node linkType: hard -"@rspack/binding@npm:1.7.0": - version: 1.7.0 - resolution: "@rspack/binding@npm:1.7.0" +"@rspack/binding@npm:1.7.11": + version: 1.7.11 + resolution: "@rspack/binding@npm:1.7.11" dependencies: - "@rspack/binding-darwin-arm64": "npm:1.7.0" - "@rspack/binding-darwin-x64": "npm:1.7.0" - "@rspack/binding-linux-arm64-gnu": "npm:1.7.0" - "@rspack/binding-linux-arm64-musl": "npm:1.7.0" - "@rspack/binding-linux-x64-gnu": "npm:1.7.0" - "@rspack/binding-linux-x64-musl": "npm:1.7.0" - "@rspack/binding-wasm32-wasi": "npm:1.7.0" - "@rspack/binding-win32-arm64-msvc": "npm:1.7.0" - "@rspack/binding-win32-ia32-msvc": "npm:1.7.0" - "@rspack/binding-win32-x64-msvc": "npm:1.7.0" + "@rspack/binding-darwin-arm64": "npm:1.7.11" + "@rspack/binding-darwin-x64": "npm:1.7.11" + "@rspack/binding-linux-arm64-gnu": "npm:1.7.11" + "@rspack/binding-linux-arm64-musl": "npm:1.7.11" + "@rspack/binding-linux-x64-gnu": "npm:1.7.11" + "@rspack/binding-linux-x64-musl": "npm:1.7.11" + "@rspack/binding-wasm32-wasi": "npm:1.7.11" + "@rspack/binding-win32-arm64-msvc": "npm:1.7.11" + "@rspack/binding-win32-ia32-msvc": "npm:1.7.11" + "@rspack/binding-win32-x64-msvc": "npm:1.7.11" dependenciesMeta: "@rspack/binding-darwin-arm64": optional: true @@ -3508,23 +3471,23 @@ __metadata: optional: true "@rspack/binding-win32-x64-msvc": optional: true - checksum: 10/152155585fe2b31c68efc1ddaa3272bcff04f483220d6b5c1ac4e35d69622261233657d66e3e0d73f28c08ccfe31742e4c284a9e35da82ee2cf32f896a6bd87b + checksum: 10/750e779db78376a29275e22a20eb0342feb487ece923f433432c6c0f5348bb6a3ed015c32a8150cd61ad48e3a63ec664fe0bde376d40bfefc00eb17c969fea2d languageName: node linkType: hard -"@rspack/core@npm:^1.5.0": - version: 1.7.0 - resolution: "@rspack/core@npm:1.7.0" +"@rspack/core@npm:^1.7.10": + version: 1.7.11 + resolution: "@rspack/core@npm:1.7.11" dependencies: "@module-federation/runtime-tools": "npm:0.22.0" - "@rspack/binding": "npm:1.7.0" + "@rspack/binding": "npm:1.7.11" "@rspack/lite-tapable": "npm:1.1.0" peerDependencies: "@swc/helpers": ">=0.5.1" peerDependenciesMeta: "@swc/helpers": optional: true - checksum: 10/79786219475e74ef2e8bb418b33e6fa39eb152639e64a83ee3887427c536d3eac4a09fda1b589f5806d62fda96b4b0350ae1bc8b26e93049be97eaae21dd6a02 + checksum: 10/52a999c6bebe511495b05dbee4bd4400fe5575ed3d417f81b86109d385babebe0f4d80a8498c8ffe4d545dbe7afd2fa92066e1ef38ea75871d5550dbfbf66b73 languageName: node linkType: hard @@ -3669,13 +3632,6 @@ __metadata: languageName: node linkType: hard -"@standard-schema/spec@npm:^1.0.0": - version: 1.1.0 - resolution: "@standard-schema/spec@npm:1.1.0" - checksum: 10/a209615c9e8b2ea535d7db0a5f6aa0f962fd4ab73ee86a46c100fb78116964af1f55a27c1794d4801e534a196794223daa25ff5135021e03c7828aa3d95e1763 - languageName: node - linkType: hard - "@svgr/babel-plugin-add-jsx-attribute@npm:8.0.0": version: 8.0.0 resolution: "@svgr/babel-plugin-add-jsx-attribute@npm:8.0.0" @@ -4225,10 +4181,10 @@ __metadata: languageName: node linkType: hard -"@types/gtag.js@npm:^0.0.12": - version: 0.0.12 - resolution: "@types/gtag.js@npm:0.0.12" - checksum: 10/f78217dd0485aa6c34f1e74e21a8fed1f58e1dcaeed7841df12ab2df2438d6015910424307945a886f101176bc95078da859b101666bfbd9437e75b63883fd36 +"@types/gtag.js@npm:^0.0.20": + version: 0.0.20 + resolution: "@types/gtag.js@npm:0.0.20" + checksum: 10/5582c540adaec49e0fdf308e0d9921397257c34371b2d0d5acb00e3775aa1aa44e2b19b2ede4cd8ca1eba1df2e3f54aee56eb82ab147846036d6460e4993c8db languageName: node linkType: hard @@ -4732,13 +4688,6 @@ __metadata: languageName: node linkType: hard -"@vercel/oidc@npm:3.0.5": - version: 3.0.5 - resolution: "@vercel/oidc@npm:3.0.5" - checksum: 10/a602190fff2e55ff480bdd17ac2c0ae8000bef12d58b179291b6da639a674835c4fd53536c449bef782ae6d24da7bed549551ffc056172215060658f83b74b98 - languageName: node - linkType: hard - "@webassemblyjs/ast@npm:1.12.1, @webassemblyjs/ast@npm:^1.12.1": version: 1.12.1 resolution: "@webassemblyjs/ast@npm:1.12.1" @@ -4999,20 +4948,6 @@ __metadata: languageName: node linkType: hard -"ai@npm:5.0.117, ai@npm:^5.0.30": - version: 5.0.117 - resolution: "ai@npm:5.0.117" - dependencies: - "@ai-sdk/gateway": "npm:2.0.24" - "@ai-sdk/provider": "npm:2.0.1" - "@ai-sdk/provider-utils": "npm:3.0.20" - "@opentelemetry/api": "npm:1.9.0" - peerDependencies: - zod: ^3.25.76 || ^4.1.8 - checksum: 10/71c998ff944d22a12799aad8e3b088fcc6a73c2e2a468a003587272d2163bf58173d20da82215c8ee8caa66a3736816e3577e7a7e7502651291959467bb49289 - languageName: node - linkType: hard - "ajv-formats@npm:^2.1.1": version: 2.1.1 resolution: "ajv-formats@npm:2.1.1" @@ -5082,7 +5017,7 @@ __metadata: languageName: node linkType: hard -"algoliasearch@npm:^5.28.0, algoliasearch@npm:^5.37.0, algoliasearch@npm:^5.49.0": +"algoliasearch@npm:^5.37.0, algoliasearch@npm:^5.49.0": version: 5.49.0 resolution: "algoliasearch@npm:5.49.0" dependencies: @@ -5435,11 +5370,11 @@ __metadata: version: 0.0.0-use.local resolution: "babel.github.io@workspace:." dependencies: - "@docusaurus/core": "npm:^3.9.2" - "@docusaurus/faster": "npm:^3.9.2" - "@docusaurus/module-type-aliases": "npm:^3.9.2" - "@docusaurus/preset-classic": "npm:^3.9.2" - "@docusaurus/remark-plugin-npm2yarn": "npm:^3.9.2" + "@docusaurus/core": "npm:^3.10.0" + "@docusaurus/faster": "npm:^3.10.0" + "@docusaurus/module-type-aliases": "npm:^3.10.0" + "@docusaurus/preset-classic": "npm:^3.10.0" + "@docusaurus/remark-plugin-npm2yarn": "npm:^3.10.0" "@emotion/css": "npm:^11.10.6" "@eslint/js": "npm:^9.35.0" "@mdx-js/react": "npm:^3.1.1" @@ -5799,9 +5734,9 @@ __metadata: linkType: hard "caniuse-lite@npm:^1.0.0, caniuse-lite@npm:^1.0.30001702, caniuse-lite@npm:^1.0.30001726": - version: 1.0.30001762 - resolution: "caniuse-lite@npm:1.0.30001762" - checksum: 10/d60a589180198ac759fa1775e521862f03503286cc9354144adcd88e76d275f03b2b6e9cab1c606790eee9d6af5cedbedb048ec652f5ff77a2b229992b7c4845 + version: 1.0.30001791 + resolution: "caniuse-lite@npm:1.0.30001791" + checksum: 10/0ec6ef60ca9f5da3da37a57c8b7b645878b6aca406eb5b569dda0bdfa518fe83320e3e2e9e25450a40a8f34854c1537c287f8bd107830aa6f39c3018f98fe408 languageName: node linkType: hard @@ -6290,6 +6225,13 @@ __metadata: languageName: node linkType: hard +"copy-text-to-clipboard@npm:^3.2.0": + version: 3.2.2 + resolution: "copy-text-to-clipboard@npm:3.2.2" + checksum: 10/ae512de746632eb0cc3fe78ba16022b46134f835aa411d372798ee76c93baae8faa6b2cf5052ebd132ec6a2016124dc19786b231e5c0d333999c5d448e7a2e42 + languageName: node + linkType: hard + "copy-webpack-plugin@npm:^11.0.0": version: 11.0.0 resolution: "copy-webpack-plugin@npm:11.0.0" @@ -6315,13 +6257,6 @@ __metadata: languageName: node linkType: hard -"core-js-pure@npm:^3.30.2": - version: 3.33.2 - resolution: "core-js-pure@npm:3.33.2" - checksum: 10/9a65d051912bac477aa005e776a625e5675ff42b62ca7a01acb1665e9a813709684bb5a35f575e65fa27b382c6ed311e9b2ebeb37bddfc87d5f9ee5fd86b9742 - languageName: node - linkType: hard - "core-js@npm:^3.31.1, core-js@npm:^3.43.0": version: 3.43.0 resolution: "core-js@npm:3.43.0" @@ -6825,7 +6760,7 @@ __metadata: languageName: node linkType: hard -"dequal@npm:^2.0.0, dequal@npm:^2.0.3": +"dequal@npm:^2.0.0": version: 2.0.3 resolution: "dequal@npm:2.0.3" checksum: 10/6ff05a7561f33603df87c45e389c9ac0a95e3c056be3da1a0c4702149e3a7f6fe5ffbb294478687ba51a9e95f3a60e8b6b9005993acd79c292c7d15f71964b6b @@ -7627,14 +7562,7 @@ __metadata: languageName: node linkType: hard -"eventsource-parser@npm:^3.0.6": - version: 3.0.6 - resolution: "eventsource-parser@npm:3.0.6" - checksum: 10/febf7058b9c2168ecbb33e92711a1646e06bd1568f60b6eb6a01a8bf9f8fcd29cc8320d57247059cacf657a296280159f21306d2e3ff33309a9552b2ef889387 - languageName: node - linkType: hard - -"execa@npm:5.1.1": +"execa@npm:^5.1.1": version: 5.1.1 resolution: "execa@npm:5.1.1" dependencies: @@ -9770,13 +9698,6 @@ __metadata: languageName: node linkType: hard -"json-schema@npm:^0.4.0": - version: 0.4.0 - resolution: "json-schema@npm:0.4.0" - checksum: 10/8b3b64eff4a807dc2a3045b104ed1b9335cd8d57aa74c58718f07f0f48b8baa3293b00af4dcfbdc9144c3aafea1e97982cc27cc8e150fc5d93c540649507a458 - languageName: node - linkType: hard - "json-stable-stringify-without-jsonify@npm:^1.0.1": version: 1.0.1 resolution: "json-stable-stringify-without-jsonify@npm:1.0.1" @@ -10275,15 +10196,6 @@ __metadata: languageName: node linkType: hard -"marked@npm:^16.3.0": - version: 16.4.2 - resolution: "marked@npm:16.4.2" - bin: - marked: bin/marked.js - checksum: 10/6e40e40661dce97e271198daa2054fc31e6445892a735e416c248fba046bdfa4573cafa08dc254529f105e7178a34485eb7f82573979cfb377a4530f66e79187 - languageName: node - linkType: hard - "math-intrinsics@npm:^1.1.0": version: 1.1.0 resolution: "math-intrinsics@npm:1.1.0" @@ -11505,12 +11417,12 @@ __metadata: languageName: node linkType: hard -"minimatch@npm:3.1.2, minimatch@npm:^3.1.1, minimatch@npm:^3.1.2": - version: 3.1.2 - resolution: "minimatch@npm:3.1.2" +"minimatch@npm:3.1.5, minimatch@npm:^3.1.1, minimatch@npm:^3.1.2": + version: 3.1.5 + resolution: "minimatch@npm:3.1.5" dependencies: brace-expansion: "npm:^1.1.7" - checksum: 10/e0b25b04cd4ec6732830344e5739b13f8690f8a012d73445a4a19fbc623f5dd481ef7a5827fde25954cd6026fede7574cc54dc4643c99d6c6b653d6203f94634 + checksum: 10/b11a7ee5773cd34c1a0c8436cdbe910901018fb4b6cb47aa508a18d567f6efd2148507959e35fba798389b161b8604a2d704ccef751ea36bd4582f9852b7d63f languageName: node linkType: hard @@ -13585,15 +13497,15 @@ __metadata: languageName: node linkType: hard -"react-loadable-ssr-addon-v5-slorber@npm:^1.0.1": - version: 1.0.1 - resolution: "react-loadable-ssr-addon-v5-slorber@npm:1.0.1" +"react-loadable-ssr-addon-v5-slorber@npm:^1.0.3": + version: 1.0.3 + resolution: "react-loadable-ssr-addon-v5-slorber@npm:1.0.3" dependencies: "@babel/runtime": "npm:^7.10.3" peerDependencies: react-loadable: "*" webpack: ">=4.41.1 || 5.x" - checksum: 10/d419ff4085ed38e6433e86a2a4c2b58c3b8df6b5d890f5fd5d768fdd3729bd50af31a47e39a40a55c6f508f71c273deb2d964e3ee1362f981cfae9a72ad188cc + checksum: 10/9730c08c87e028819dfa20b5118b68c75bcfd5573b0d36e703edc4a0d4b2674eff6595c17538656e07b70ec612982be50316f49879dd3d226ef558d10a44a5c9 languageName: node linkType: hard @@ -14713,18 +14625,18 @@ __metadata: languageName: node linkType: hard -"serve-handler@npm:^6.1.6": - version: 6.1.6 - resolution: "serve-handler@npm:6.1.6" +"serve-handler@npm:^6.1.7": + version: 6.1.7 + resolution: "serve-handler@npm:6.1.7" dependencies: bytes: "npm:3.0.0" content-disposition: "npm:0.5.2" mime-types: "npm:2.1.18" - minimatch: "npm:3.1.2" + minimatch: "npm:3.1.5" path-is-inside: "npm:1.0.2" path-to-regexp: "npm:3.3.0" range-parser: "npm:1.2.0" - checksum: 10/7e7d93eb7e69fcd9f9c5afc2ef2b46cb0072b4af13cbabef9bca725afb350ddae6857d8c8be2c256f7ce1f7677c20347801399c11caa5805c0090339f894e8f2 + checksum: 10/2366e53cc8e8376d58abb289293b930111fa5da6d14bb31eafac5b1162f332c45c6f394c7d78fdcf6b5736e12caf9370b02d05c7e8a75291d2fc6a55b52b14ea languageName: node linkType: hard @@ -15484,18 +15396,6 @@ __metadata: languageName: node linkType: hard -"swr@npm:^2.2.5": - version: 2.3.8 - resolution: "swr@npm:2.3.8" - dependencies: - dequal: "npm:^2.0.3" - use-sync-external-store: "npm:^1.6.0" - peerDependencies: - react: ^16.11.0 || ^17.0.0 || ^18.0.0 || ^19.0.0 - checksum: 10/fc4c992902da13bc2c82f066131cdf0b73147d6a590984c0b746704ad7ac8e40ac72afab679c47ad3abc7c09789a31964ffbb963904ec6c29e650790991b0eac - languageName: node - linkType: hard - "tapable@npm:^2.0.0, tapable@npm:^2.1.1, tapable@npm:^2.2.0, tapable@npm:^2.2.1": version: 2.2.1 resolution: "tapable@npm:2.2.1" @@ -15569,13 +15469,6 @@ __metadata: languageName: node linkType: hard -"throttleit@npm:2.1.0": - version: 2.1.0 - resolution: "throttleit@npm:2.1.0" - checksum: 10/a2003947aafc721c4a17e6f07db72dc88a64fa9bba0f9c659f7997d30f9590b3af22dadd6a41851e0e8497d539c33b2935c2c7919cf4255922509af6913c619b - languageName: node - linkType: hard - "through@npm:^2.3.8": version: 2.3.8 resolution: "through@npm:2.3.8" @@ -16250,7 +16143,7 @@ __metadata: languageName: node linkType: hard -"use-sync-external-store@npm:^1.0.0, use-sync-external-store@npm:^1.6.0": +"use-sync-external-store@npm:^1.0.0": version: 1.6.0 resolution: "use-sync-external-store@npm:1.6.0" peerDependencies: @@ -16902,7 +16795,7 @@ __metadata: languageName: node linkType: hard -"zod@npm:^3.25.76 || ^4, zod@npm:^4.1.8": +"zod@npm:^3.25.76 || ^4": version: 4.3.6 resolution: "zod@npm:4.3.6" checksum: 10/25fc0f62e01b557b4644bf0b393bbaf47542ab30877c37837ea8caf314a8713d220c7d7fe51f68ffa72f0e1018ddfa34d96f1973d23033f5a2a5a9b6b9d9da01