👷 Move build chain to ESM (#5670)

**Description**

<!-- Please provide a short description and potentially linked issues
justifying the need for this PR -->

The build chain of fast-check has been CommonJS-based since day 1. With
ESM moving forward in the ecosystem, it's time to move ourselves to the
new standard and adapt our build chains to ESM.

Unfortunately it may have some subtle impacts on our users as our
package will not be a CJS one offering a ESM fallback anymore. I will
rather be the opposite: an ESM package with a fallback to CJS. It
implies that we moved ESM related files closer to the root of the
package (we could have kept them in esm/) and moved the CJS ones further
in the file structure (we had to move them).

Another subtle impact is that it would impose our users to run at least
Node ≥12.17.0.

As such we consider it as a breaking change. On its own it should not be
a huge problem for most of the users but given it changes our minimal
requirement let's put it into the next major release.

Superseed #4592

<!-- * Your PR is fixing a bug or regression? Check for existing issues
related to this bug and link them -->
<!-- * Your PR is adding a new feature? Make sure there is a related
issue or discussion attached to it -->

<!-- You can provide any additional context to help into understanding
what's this PR is attempting to solve: reproduction of a bug, code
snippets... -->

**Checklist** — _Don't delete this checklist and make sure you do the
following before opening the PR_

- [x] The name of my PR follows [gitmoji](https://gitmoji.dev/)
specification
- [x] My PR references one of several related issues (if any)
- [x] New features or breaking changes must come with an associated
Issue or Discussion
- [x] My PR does not add any new dependency without an associated Issue
or Discussion
- [x] My PR includes bumps details, please run `yarn bump` and flag the
impacts properly
- [x] My PR adds relevant tests and they would have failed without my PR
(when applicable)

<!-- More about contributing at
https://github.com/dubzzz/fast-check/blob/main/CONTRIBUTING.md -->

**Advanced**

<!-- How to fill the advanced section is detailed below! -->

- [x] Category: 👷 Configuration of the package
- [x] Impacts: Requires users to rely on more recent versions of Node,
at least 12.17

<!-- [Category] Please use one of the categories below, it will help us
into better understanding the urgency of the PR -->
<!-- * ✨ Introduce new features -->
<!-- * 📝 Add or update documentation -->
<!-- * ✅ Add or update tests -->
<!-- * 🐛 Fix a bug -->
<!-- * 🏷️ Add or update types -->
<!-- * ⚡️ Improve performance -->
<!-- * _Other(s):_ ... -->

<!-- [Impacts] Please provide a comma separated list of the potential
impacts that might be introduced by this change -->
<!-- * Generated values: Can your change impact any of the existing
generators in terms of generated values, if so which ones? when? -->
<!-- * Shrink values: Can your change impact any of the existing
generators in terms of shrink values, if so which ones? when? -->
<!-- * Performance: Can it require some typings changes on user side?
Please give more details -->
<!-- * Typings: Is there a potential performance impact? In which cases?
-->

Author: dubzzz

.changeset/blue-donkeys-compare.md

@@ -0,0 +1,5 @@
+---
+"fast-check": major
+---
+
+👷 Move build chain to ESM

packages/fast-check/README.md

@@ -118,7 +118,7 @@ Here are the minimal requirements to use fast-check properly without any polyfil
 
 | fast-check | node                | ECMAScript version | _TypeScript (optional)_ |
 | ---------- | ------------------- | ------------------ | ----------------------- |
-| **4.x**    | ≥10.5.0             | ES2020             | ≥5.0                    |
+| **4.x**    | ≥12.17.0            | ES2020             | ≥5.0                    |
 | **3.x**    | ≥8<sup>(1)</sup>    | ES2017             | ≥4.1<sup>(2)</sup>      |
 | **2.x**    | ≥8<sup>(1)</sup>    | ES2017             | ≥3.2<sup>(3)</sup>      |
 | **1.x**    | ≥0.12<sup>(1)</sup> | ES3                | ≥3.0<sup>(3)</sup>      |

packages/fast-check/package.cjs-template.json

@@ -0,0 +1,3 @@
+{
+  "type": "commonjs"
+}

packages/fast-check/package.esm-template.json

@@ -2,22 +2,22 @@
   "name": "fast-check",
   "version": "3.23.2",
   "description": "Property based testing framework for JavaScript (like QuickCheck)",
-  "type": "commonjs",
+  "type": "module",
   "main": "lib/fast-check.js",
   "exports": {
     "./package.json": "./package.json",
     ".": {
       "require": {
-        "types": "./lib/types/fast-check.d.ts",
-        "default": "./lib/fast-check.js"
+        "types": "./lib/cjs/types/fast-check.d.ts",
+        "default": "./lib/cjs/fast-check.js"
       },
       "import": {
-        "types": "./lib/esm/types/fast-check.d.ts",
-        "default": "./lib/esm/fast-check.js"
+        "types": "./lib/types/fast-check.d.ts",
+        "default": "./lib/fast-check.js"
       }
     }
   },
-  "module": "lib/esm/fast-check.js",
+  "module": "lib/fast-check.js",
   "types": "lib/types/fast-check.d.ts",
   "files": [
     "lib",
@@ -28,15 +28,15 @@
   "scripts": {
     "build": "yarn build:publish-cjs && yarn build:publish-esm && yarn build:publish-types && node postbuild/main.mjs",
     "build-ci": "cross-env EXPECT_GITHUB_SHA=true yarn build",
-    "build:publish-types": "tsc -p tsconfig.publish.types.json && tsc -p tsconfig.publish.types.json --outDir lib/esm/types",
-    "build:publish-cjs": "tsc -p tsconfig.publish.json",
-    "build:publish-esm": "tsc -p tsconfig.publish.json --module es2015 --moduleResolution node --outDir lib/esm && cp package.esm-template.json lib/esm/package.json",
+    "build:publish-types": "tsc -p tsconfig.publish.types.json && tsc -p tsconfig.publish.types.json --outDir lib/cjs/types",
+    "build:publish-cjs": "tsc -p tsconfig.publish.json --outDir lib/cjs && cp package.cjs-template.json lib/cjs/package.json",
+    "build:publish-esm": "tsc -p tsconfig.publish.json --module es2015 --moduleResolution node",
     "typecheck": "tsc --noEmit",
     "test": "vitest --config vitest.unit.config.mjs",
     "e2e": "vitest --config vitest.e2e.config.mjs",
     "update:documentation": "cross-env UPDATE_CODE_SNIPPETS=true vitest --config vitest.documentation.config.mjs",
     "test-bundle": "node test-bundle/run.cjs && node test-bundle/run.mjs && node test-bundle/run-advanced.cjs",
-    "test-legacy-bundle": "nvs add 10.5 && $(nvs which 10.5) test-bundle/run.cjs && $(nvs which 10.5) test-bundle/run-advanced.cjs",
+    "test-legacy-bundle": "nvs add 12.17 && $(nvs which 12.17) test-bundle/run.cjs && $(nvs which 12.17) test-bundle/run-advanced.cjs",
     "docs": "api-extractor run --local && rm docs/fast-check.api.json && typedoc --out docs src/fast-check-default.ts && node postbuild/main.mjs",
     "docs-ci": "cross-env EXPECT_GITHUB_SHA=true yarn docs",
     "docs:serve": "yarn dlx serve docs/"

packages/fast-check/package.json

@@ -36,7 +36,7 @@ fs.readFile(path.join(__dirname, '../package.json'), (err, data) => {
   const packageVersion = JSON.parse(data.toString()).version;
 
   const commonJsReplacement = replaceInFileSync({
-    files: 'lib/fast-check-default.js',
+    files: 'lib/cjs/fast-check-default.js',
     from: [/__PACKAGE_TYPE__/g, /__PACKAGE_VERSION__/g, /__COMMIT_HASH__/g],
     to: ['commonjs', packageVersion, commitHash],
   });
@@ -45,7 +45,7 @@ fs.readFile(path.join(__dirname, '../package.json'), (err, data) => {
   }
 
   const moduleReplacement = replaceInFileSync({
-    files: 'lib/esm/fast-check-default.js',
+    files: 'lib/fast-check-default.js',
     from: [/__PACKAGE_TYPE__/g, /__PACKAGE_VERSION__/g, /__COMMIT_HASH__/g],
     to: ['module', packageVersion, commitHash],
   });
@@ -54,7 +54,7 @@ fs.readFile(path.join(__dirname, '../package.json'), (err, data) => {
   }
 
   const dTsReplacement = replaceInFileSync({
-    files: 'lib/types/fast-check-default.d.ts',
+    files: 'lib/cjs/types/fast-check-default.d.ts',
     from: [/__PACKAGE_VERSION__/g, /__COMMIT_HASH__/g],
     to: [packageVersion, commitHash],
   });
@@ -63,7 +63,7 @@ fs.readFile(path.join(__dirname, '../package.json'), (err, data) => {
   }
 
   const dTsReplacement2 = replaceInFileSync({
-    files: 'lib/esm/types/fast-check-default.d.ts',
+    files: 'lib/types/fast-check-default.d.ts',
     from: [/__PACKAGE_VERSION__/g, /__COMMIT_HASH__/g],
     to: [packageVersion, commitHash],
   });

packages/fast-check/postbuild/main.mjs

@@ -11,11 +11,11 @@ Simple migration guide to fast-check v4 starting from fast-check v3
 
 | Name                     | New requirement | Previous requirement |
 | ------------------------ | --------------- | -------------------- |
-| Node                     | ≥10.5.0         | ≥8                   |
+| Node                     | ≥12.17.0        | ≥8                   |
 | ECMAScript specification | ES2020          | ES2017               |
 | TypeScript _(optional)_  | ≥5.0            | ≥4.1                 |
 
-Related pull requests: [#5577](https://github.com/dubzzz/fast-check/pull/5577), [#5605](https://github.com/dubzzz/fast-check/pull/5605), [#5617](https://github.com/dubzzz/fast-check/pull/5617), [#5634](https://github.com/dubzzz/fast-check/pull/5634), [#5635](https://github.com/dubzzz/fast-check/pull/5635)
+Related pull requests: [#5577](https://github.com/dubzzz/fast-check/pull/5577), [#5605](https://github.com/dubzzz/fast-check/pull/5605), [#5617](https://github.com/dubzzz/fast-check/pull/5617), [#5634](https://github.com/dubzzz/fast-check/pull/5634), [#5635](https://github.com/dubzzz/fast-check/pull/5635), [#5670](https://github.com/dubzzz/fast-check/pull/5670)
 
 ## Update to latest v3.x