docs: add explanation for supportsStaticESM transform option (#12028)

Author: ahnpnl

docs/CodeTransformation.md

@@ -36,6 +36,14 @@ You can write your own transformer. The API of a transformer is as follows:
 interface TransformOptions<TransformerConfig = unknown> {
   supportsDynamicImport: boolean;
   supportsExportNamespaceFrom: boolean;
+  /**
+   * The value is:
+   * - `false` if Jest runs without Node ESM flag `--experimental-vm-modules`
+   * - `true` if the file extension is defined in [extensionsToTreatAsEsm](Configuration.md#extensionstotreatasesm-arraystring)
+   * and Jest runs with Node ESM flag `--experimental-vm-modules`
+   *
+   * See more at https://jestjs.io/docs/next/ecmascript-modules
+   */
   supportsStaticESM: boolean;
   supportsTopLevelAwait: boolean;
   instrument: boolean;

website/versioned_docs/version-27.x/CodeTransformation.md

@@ -110,6 +110,14 @@ interface TransformOptions<OptionType> {
   // names are copied from babel: https://babeljs.io/docs/en/options#caller
   supportsDynamicImport: boolean;
   supportsExportNamespaceFrom: boolean;
+  /**
+   * The value is:
+   * - `false` if Jest runs without Node ESM flag `--experimental-vm-modules`
+   * - `true` if the file extension is defined in [extensionsToTreatAsEsm](Configuration.md#extensionstotreatasesm-arraystring)
+   * and Jest runs with Node ESM flag `--experimental-vm-modules`
+   *
+   * See more at https://jestjs.io/docs/27.x/ecmascript-modules
+   */
   supportsStaticESM: boolean;
   supportsTopLevelAwait: boolean;
   /** the options passed through Jest's config by the user */

website/versioned_docs/version-28.x/CodeTransformation.md

@@ -36,6 +36,14 @@ You can write your own transformer. The API of a transformer is as follows:
 interface TransformOptions<TransformerConfig = unknown> {
   supportsDynamicImport: boolean;
   supportsExportNamespaceFrom: boolean;
+  /**
+   * The value is:
+   * - `false` if Jest runs without Node ESM flag `--experimental-vm-modules`
+   * - `true` if the file extension is defined in [extensionsToTreatAsEsm](Configuration.md#extensionstotreatasesm-arraystring)
+   * and Jest runs with Node ESM flag `--experimental-vm-modules`
+   *
+   * See more at https://jestjs.io/docs/28x/ecmascript-modules
+   */
   supportsStaticESM: boolean;
   supportsTopLevelAwait: boolean;
   instrument: boolean;

website/versioned_docs/version-29.0/CodeTransformation.md

@@ -36,6 +36,14 @@ You can write your own transformer. The API of a transformer is as follows:
 interface TransformOptions<TransformerConfig = unknown> {
   supportsDynamicImport: boolean;
   supportsExportNamespaceFrom: boolean;
+  /**
+   * The value is:
+   * - `false` if Jest runs without Node ESM flag `--experimental-vm-modules`
+   * - `true` if the file extension is defined in [extensionsToTreatAsEsm](Configuration.md#extensionstotreatasesm-arraystring)
+   * and Jest runs with Node ESM flag `--experimental-vm-modules`
+   *
+   * See more at https://jestjs.io/docs/29.0/ecmascript-modules
+   */
   supportsStaticESM: boolean;
   supportsTopLevelAwait: boolean;
   instrument: boolean;

website/versioned_docs/version-29.1/CodeTransformation.md

@@ -36,6 +36,14 @@ You can write your own transformer. The API of a transformer is as follows:
 interface TransformOptions<TransformerConfig = unknown> {
   supportsDynamicImport: boolean;
   supportsExportNamespaceFrom: boolean;
+  /**
+   * The value is:
+   * - `false` if Jest runs without Node ESM flag `--experimental-vm-modules`
+   * - `true` if the file extension is defined in [extensionsToTreatAsEsm](Configuration.md#extensionstotreatasesm-arraystring)
+   * and Jest runs with Node ESM flag `--experimental-vm-modules`
+   *
+   * See more at https://jestjs.io/docs/29.1/ecmascript-modules
+   */
   supportsStaticESM: boolean;
   supportsTopLevelAwait: boolean;
   instrument: boolean;

website/versioned_docs/version-29.2/CodeTransformation.md

@@ -36,6 +36,14 @@ You can write your own transformer. The API of a transformer is as follows:
 interface TransformOptions<TransformerConfig = unknown> {
   supportsDynamicImport: boolean;
   supportsExportNamespaceFrom: boolean;
+  /**
+   * The value is:
+   * - `false` if Jest runs without Node ESM flag `--experimental-vm-modules`
+   * - `true` if the file extension is defined in [extensionsToTreatAsEsm](Configuration.md#extensionstotreatasesm-arraystring)
+   * and Jest runs with Node ESM flag `--experimental-vm-modules`
+   *
+   * See more at https://jestjs.io/docs/ecmascript-modules
+   */
   supportsStaticESM: boolean;
   supportsTopLevelAwait: boolean;
   instrument: boolean;