allowAwaitOutsideFunction does not default to true when ecmaVersion >= 2022

[willdady]

The README says allowAwaitOutsideFunction defaults to true for ecmaVersion >= 2022:

allowAwaitOutsideFunction: If false, await expressions can only appear inside async functions. Defaults to true for ecmaVersion 2022 and later, false for lower versions. Setting this option to true allows to have top-level await expressions. They are still not allowed in non-async functions, though.

However the following code fails with SyntaxError: Unexpected token (2:16)?

import * as acorn from 'acorn';

const code = `
const x = await foo();
`;

try {
  acorn.parse(code, {
    ecmaVersion: 2022,
    // allowAwaitOutsideFunction: true
  });
} catch (error) {
  console.error(error);
}

Uncommenting allowAwaitOutsideFunction: true resolves the issue though this seems to conflict with what the aforementioned docs are saying.

[marijnh]

It is only implicitly enabled for sourceType: "module". See #1048

[willdady]

Good to know. Perhaps the documentation mentioned above could make that more obvious.