Move top-level await out of experimental (#3089)

* move top-level await out of experimental

* Remove last traces of the `experimentalTopLevelAwait` option from docs and tests

Co-authored-by: Lukas Taegert-Atkinson <lukastaegert@users.noreply.github.com>

docs/01-command-line-reference.md

@@ -56,7 +56,6 @@ export default { // can be an array (for multiple inputs)
   chunkGroupingSize,
   experimentalCacheExpiry,
   experimentalOptimizeChunks,
-  experimentalTopLevelAwait,
   perf,
 
   output: { // required (can be an array, for multiple outputs)

docs/02-javascript-api.md

@@ -99,7 +99,6 @@ const inputOptions = {
   chunkGroupingSize,
   experimentalCacheExpiry,
   experimentalOptimizeChunks,
-  experimentalTopLevelAwait,
   perf
 };
 ```

docs/999-big-list-of-options.md

@@ -1067,13 +1067,6 @@ Default: `false`
 
 Experimental feature to optimize chunk groupings. When a large number of chunks are generated, this allows smaller chunks to group together as long as they are within the `chunkGroupingSize` limit. It results in unnecessary code being loaded in some cases in order to have a smaller number of chunks overall. Disabled by default as it may cause unwanted side effects when loading unexpected code.
 
-#### experimentalTopLevelAwait
-Type: `boolean`<br>
-CLI: `--experimentalTopLevelAwait`/`--no-experimentalTopLevelAwait`<br>
-Default: `false`
-
-Whether to support top-level await statements. The generated code will follow [Variant A of the specification](https://github.com/tc39/proposal-top-level-await#variant-a-top-level-await-blocks-tree-execution).
-
 #### perf
 Type: `boolean`<br>
 CLI: `--perf`/`--no-perf`<br>

src/Graph.ts

@@ -176,9 +176,7 @@ export default class Graph {
 
 		acornPluginsToInject.push(injectImportMeta, injectExportNsFrom);
 
-		if (options.experimentalTopLevelAwait) {
-			this.acornOptions.allowAwaitOutsideFunction = true;
-		}
+		(this.acornOptions as any).allowAwaitOutsideFunction = true;
 
 		const acornInjectPlugins = options.acornInjectPlugins;
 		acornPluginsToInject.push(

src/rollup/types.d.ts

@@ -430,7 +430,6 @@ export interface InputOptions {
 	context?: string;
 	experimentalCacheExpiry?: number;
 	experimentalOptimizeChunks?: boolean;
-	experimentalTopLevelAwait?: boolean;
 	external?: ExternalOption;
 	inlineDynamicImports?: boolean;
 	input?: InputOption;

src/utils/mergeOptions.ts

@@ -227,7 +227,6 @@ function getInputOptions(
 		context: getOption('context'),
 		experimentalCacheExpiry: getOption('experimentalCacheExpiry', 10),
 		experimentalOptimizeChunks: getOption('experimentalOptimizeChunks'),
-		experimentalTopLevelAwait: getOption('experimentalTopLevelAwait'),
 		external: getExternal(config, command) as any,
 		inlineDynamicImports: getOption('inlineDynamicImports', false),
 		input: getOption('input', []),

test/form/samples/top-level-await/_config.js

@@ -1,7 +1,4 @@
 module.exports = {
 	description: 'top-level await support',
-	formats: ['system', 'es'],
-	options: {
-		experimentalTopLevelAwait: true
-	}
+	formats: ['system', 'es']
 };

test/function/samples/invalid-top-level-await/_config.js

@@ -1,8 +1,5 @@
 module.exports = {
 	description: 'throws for invalid top-level-await format',
-	options: {
-		experimentalTopLevelAwait: true
-	},
 	generateError: {
 		code: 'INVALID_TLA_FORMAT',
 		message:

test/misc/misc.js

@@ -18,7 +18,6 @@ describe('misc', () => {
 				]),
 				acornInjectPlugins: freeze([]),
 				acorn: freeze({}),
-				experimentalTopLevelAwait: true,
 				treeshake: freeze({})
 			})
 		);