release: [email protected] [skip ci]

## 💥 BREAKING CHANGES 💥

- Minimum supported Node.js version is now 20.18.0

- Default exports are no longer available. See usage instructions for details on proper import syntax.

- `ResultFormatter` is no longer synchronous and can now return a `Promise`.

- Adoption of prettier\@3 requires some versions of Node to be executed with the `--experimental-vm-modules` option. E.g. `NODE_OPTIONS="--no-warnings --experimental-vm-modules" npx jest`.

- Attempting to install babel-plugin-tester alongside jest@<30 will cause NPM to fail with `ERESOLVE`. This is because only jest@>=30 (jest-snapshot) supports the prettier\@3 asynchronous interface.

## ✨ Features

- Allow testing entire babel transform result via `outputRaw` ([e9d5aa1][2]) <sup>see [#186][3]</sup>
- Support collapsing/overwriting technically-illegal duplicate plugin/preset `PluginItem`s ([bf0a088][4])
- Upgrade to prettier\@3 ([3334248][5])

## 🪄 Fixes

- **readme:** use proper codecov coverage badge ([1047e5c][6])

## ⚙️ Build System

- Adopt @-xun/symbiote ([89ec951][7])
- **deps:** bump core-js from 3.40.0 to 3.42.0 ([879dd6b][8])
- **deps:** bump core-js from 3.42.0 to 3.43.0 ([7590b87][9])
- **deps:** bump debug from 4.4.0 to 4.4.1 ([3c2538c][10])
- **deps:** bump prettier from 3.4.2 to 3.5.3 ([e0a29da][11])
- **deps:** bump pretty-format from 29.7.0 to 30.0.0 ([7ea13c3][12])
- **deps:** bump rejoinder from 1.2.5 to 2.0.1 ([76dcccd][13])
- **deps:** bump type-fest from 4.32.0 to 4.41.0 ([bcbb568][14])
- **package:** be more selective about which files are included during docs generation ([cbb4215][15])
- **package:** bump minimum supported node versions to maintained ([ee6f7da][16])
- **release:** add "master" branch to release branches ([03734ea][17])
- Upgrade typescript-babel toolchain to nodenext ([d0b722f][19])

## 🧙🏿 Refactored

- **src:** deprecated default exports are no longer available ([b02d4f0][20])

[1]: https://github.com/babel-utils/babel-plugin-tester/compare/[email protected]@12.0.0
[2]: e9d5aa1
[3]: #186
[4]: bf0a088
[5]: 3334248
[6]: 1047e5c
[7]: 89ec951
[8]: 879dd6b
[9]: 7590b87
[10]: 3c2538c
[11]: e0a29da
[12]: 7ea13c3
[13]: 76dcccd
[14]: bcbb568
[15]: cbb4215
[16]: ee6f7da
[17]: 03734ea
[18]: 170248d
[19]: d0b722f
[20]: b02d4f0

Author: Xunnamius

CHANGELOG.md

@@ -7,11 +7,10 @@
 ## Modules
 
 - [src](src/README.md)
+- [src/constant](src/constant/README.md)
 - [src/errors](src/errors/README.md)
 - [src/formatters/prettier](src/formatters/prettier/README.md)
 - [src/plugin-tester](src/plugin-tester/README.md)
 - [src/serializers/unstring-snapshot](src/serializers/unstring-snapshot/README.md)
-- [src/symbols](src/symbols/README.md)
-- [test/setup](test/setup/README.md)
-- [types/global](types/global/README.md)
-- [types/unique-filename](types/unique-filename/README.md)
+- [src/types](src/types/README.md)
+- [test/util](test/util/README.md)

docs/README.md

@@ -18,43 +18,43 @@
 
 ### BabelType
 
-Re-exports [BabelType](../types/global/type-aliases/BabelType.md)
+Re-exports [BabelType](types/type-aliases/BabelType.md)
 
 ***
 
 ### ErrorExpectation
 
-Re-exports [ErrorExpectation](../types/global/type-aliases/ErrorExpectation.md)
+Re-exports [ErrorExpectation](types/type-aliases/ErrorExpectation.md)
 
 ***
 
 ### FixtureOptions
 
-Re-exports [FixtureOptions](../types/global/interfaces/FixtureOptions.md)
+Re-exports [FixtureOptions](types/interfaces/FixtureOptions.md)
 
 ***
 
 ### OutputTesterFunction
 
-Re-exports [OutputTesterFunction](../types/global/type-aliases/OutputTesterFunction.md)
+Re-exports [OutputTesterFunction](types/type-aliases/OutputTesterFunction.md)
 
 ***
 
 ### PluginTesterOptions
 
-Re-exports [PluginTesterOptions](../types/global/interfaces/PluginTesterOptions.md)
+Re-exports [PluginTesterOptions](types/interfaces/PluginTesterOptions.md)
 
 ***
 
 ### prettierFormatter
 
-Re-exports [prettierFormatter](formatters/prettier/functions/prettierFormatter.md)
+Re-exports [prettierFormatter](formatters/prettier/variables/prettierFormatter.md)
 
 ***
 
 ### ResultFormatter
 
-Re-exports [ResultFormatter](../types/global/type-aliases/ResultFormatter.md)
+Re-exports [ResultFormatter](types/type-aliases/ResultFormatter.md)
 
 ***
 
@@ -72,19 +72,19 @@ Re-exports [runPresetUnderTestHere](plugin-tester/variables/runPresetUnderTestHe
 
 ### SetupFunction
 
-Re-exports [SetupFunction](../types/global/type-aliases/SetupFunction.md)
+Re-exports [SetupFunction](types/type-aliases/SetupFunction.md)
 
 ***
 
 ### TeardownFunction
 
-Re-exports [TeardownFunction](../types/global/type-aliases/TeardownFunction.md)
+Re-exports [TeardownFunction](types/type-aliases/TeardownFunction.md)
 
 ***
 
 ### TestObject
 
-Re-exports [TestObject](../types/global/interfaces/TestObject.md)
+Re-exports [TestObject](types/interfaces/TestObject.md)
 
 ***
 

docs/src/README.md

@@ -0,0 +1,12 @@
+[**babel-plugin-tester**](../../README.md)
+
+***
+
+[babel-plugin-tester](../../README.md) / src/constant
+
+# src/constant
+
+## Variables
+
+- [globalDebugger](variables/globalDebugger.md)
+- [globalDebuggerNamespace](variables/globalDebuggerNamespace.md)

docs/src/constant/README.md

@@ -0,0 +1,11 @@
+[**babel-plugin-tester**](../../../README.md)
+
+***
+
+[babel-plugin-tester](../../../README.md) / [src/constant](../README.md) / globalDebugger
+
+# Variable: globalDebugger
+
+> `const` **globalDebugger**: `ExtendedDebugger`
+
+Defined in: [src/constant.ts:16](https://github.com/babel-utils/babel-plugin-tester/blob/4d4ff268cbd4a3f5ae326c51e5487f07121f5c9d/src/constant.ts#L16)

docs/src/constant/variables/globalDebugger.md

@@ -0,0 +1,14 @@
+[**babel-plugin-tester**](../../../README.md)
+
+***
+
+[babel-plugin-tester](../../../README.md) / [src/constant](../README.md) / globalDebuggerNamespace
+
+# Variable: globalDebuggerNamespace
+
+> `const` **globalDebuggerNamespace**: `"bpt"` = `'bpt'`
+
+Defined in: [src/constant.ts:14](https://github.com/babel-utils/babel-plugin-tester/blob/4d4ff268cbd4a3f5ae326c51e5487f07121f5c9d/src/constant.ts#L14)
+
+The project-wide namespace that appears in debugger output. Only used in
+tests.

docs/src/constant/variables/globalDebuggerNamespace.md

@@ -8,7 +8,7 @@
 
 > `const` **ErrorMessage**: `object`
 
-Defined in: [src/errors.ts:17](https://github.com/babel-utils/babel-plugin-tester/blob/03734eaa985470bea60d71fab1aa0d0dbdddae3c/src/errors.ts#L17)
+Defined in: [src/errors.ts:17](https://github.com/babel-utils/babel-plugin-tester/blob/4d4ff268cbd4a3f5ae326c51e5487f07121f5c9d/src/errors.ts#L17)
 
 A collection of possible errors and warnings.
 
@@ -128,7 +128,7 @@ A collection of possible errors and warnings.
 
 ### BadEnvironmentVariableRange()
 
-> **BadEnvironmentVariableRange**: (`name`, `rangeStr`, `range`?) => `string`
+> **BadEnvironmentVariableRange**: (`name`, `rangeStr`, `range?`) => `string`
 
 #### Parameters
 
@@ -164,7 +164,7 @@ A collection of possible errors and warnings.
 
 ##### expectedError
 
-`Function` | \{ `name`: `string`; \}
+`Function` | \{ `name?`: `string`; \}
 
 #### Returns
 
@@ -420,7 +420,7 @@ A collection of possible errors and warnings.
 
 ### TeardownFunctionFailed()
 
-> **TeardownFunctionFailed**: (`functionError`, `frameworkError`?) => `string`
+> **TeardownFunctionFailed**: (`functionError`, `frameworkError?`) => `string`
 
 #### Parameters
 

docs/src/errors/variables/ErrorMessage.md

@@ -10,12 +10,12 @@
 
 - [PrettierOptions](interfaces/PrettierOptions.md)
 
-## Functions
+## Variables
 
-- [prettierFormatter](functions/prettierFormatter.md)
+- [prettierFormatter](variables/prettierFormatter.md)
 
 ## References
 
 ### default
 
-Renames and re-exports [prettierFormatter](functions/prettierFormatter.md)
+Renames and re-exports [prettierFormatter](variables/prettierFormatter.md)