🗑️ Deprecate bigInt's alternatives (#5238)

**Description**

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

Starting at 3.22.0 the usage of `bigIntN`, `bigUintN` and `bigUint` will
be discouraged. We instead recommend calling `bigInt` with appropriate
`min` and `max` values when relevant.

<!-- * 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: 🗑️ Depreciate features
- [x] Impacts: Less built-in in future majors

<!-- [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?
-->

.yarn/versions/0a0bca50.yml

@@ -0,0 +1,8 @@
+releases:
+  fast-check: minor
+
+declined:
+  - "@fast-check/ava"
+  - "@fast-check/jest"
+  - "@fast-check/vitest"
+  - "@fast-check/worker"

packages/fast-check/src/arbitrary/bigIntN.ts

@@ -9,6 +9,7 @@ import { BigIntArbitrary } from './_internals/BigIntArbitrary';
  *
  * @param n - Maximal number of bits of the generated bigint
  *
+ * @deprecated Please use ${@link bigInt} with `fc.bigInt({ min: -2n**(n-1n), max: 2n**(n-1n)-1n })` instead
  * @remarks Since 1.9.0
  * @public
  */

packages/fast-check/src/arbitrary/bigUint.ts

@@ -22,6 +22,7 @@ function computeDefaultMax(): bigint {
 
 /**
  * For positive bigint
+ * @deprecated Please use ${@link bigInt} with `fc.bigInt({ min: 0n })` instead
  * @remarks Since 1.9.0
  * @public
  */
@@ -30,7 +31,7 @@ function bigUint(): Arbitrary<bigint>;
  * For positive bigint between 0 (included) and max (included)
  *
  * @param max - Upper bound for the generated bigint
- *
+ * @deprecated Please use ${@link bigInt} with `fc.bigInt({ min: 0n, max })` instead
  * @remarks Since 1.9.0
  * @public
  */
@@ -40,6 +41,7 @@ function bigUint(max: bigint): Arbitrary<bigint>;
  *
  * @param constraints - Constraints to apply when building instances
  *
+ * @deprecated Please use ${@link bigInt} with `fc.bigInt({ min: 0n, max })` instead
  * @remarks Since 2.6.0
  * @public
  */

packages/fast-check/src/arbitrary/bigUintN.ts

@@ -9,6 +9,7 @@ import { BigIntArbitrary } from './_internals/BigIntArbitrary';
  *
  * @param n - Maximal number of bits of the generated bigint
  *
+ * @deprecated Please use ${@link bigInt} with `fc.bigInt({ min: 0n, max: 2n**n-1n })` instead
  * @remarks Since 1.9.0
  * @public
  */

website/docs/core-blocks/arbitraries/primitives/bigint.md

@@ -18,7 +18,7 @@ Generate any possible `bigint` between <code>-2<sup>n-1</sup></code>(included) a
 
 **Signatures:**
 
-- `fc.bigIntN(n)`
+- `fc.bigIntN(n)` — _deprecated since v3.22.0, prefer [bigInt](https://fast-check.dev/docs/core-blocks/arbitraries/primitives/bigint/#bigint-1) (more details at [#5238](https://github.com/dubzzz/fast-check/pull/5238))_
 
 **with:**
 
@@ -105,7 +105,7 @@ Generate any possible positive `bigint` between <code>0</code>(included) and <co
 
 **Signatures:**
 
-- `fc.bigUintN(n)`
+- `fc.bigUintN(n)` — _deprecated since v3.22.0, prefer [bigInt](https://fast-check.dev/docs/core-blocks/arbitraries/primitives/bigint/#bigint-1) (more details at [#5238](https://github.com/dubzzz/fast-check/pull/5238))_
 
 **with:**
 
@@ -140,9 +140,9 @@ Generate any positive bigint value taken up to upper bound included.
 
 **Signatures:**
 
-- `fc.bigUint()`
-- `fc.bigUint({max?})`
-- `fc.bigUint(max)`
+- `fc.bigUint()` — _deprecated since v3.22.0, prefer [bigInt](https://fast-check.dev/docs/core-blocks/arbitraries/primitives/bigint/#bigint-1) (more details at [#5238](https://github.com/dubzzz/fast-check/pull/5238))_
+- `fc.bigUint({max?})` — _deprecated since v3.22.0, prefer [bigInt](https://fast-check.dev/docs/core-blocks/arbitraries/primitives/bigint/#bigint-1) (more details at [#5238](https://github.com/dubzzz/fast-check/pull/5238))_
+- `fc.bigUint(max)` — _deprecated since v3.22.0, prefer [bigInt](https://fast-check.dev/docs/core-blocks/arbitraries/primitives/bigint/#bigint-1) (more details at [#5238](https://github.com/dubzzz/fast-check/pull/5238))_
 
 **with:**