effect 4.0.0-beta.102 → 4.0.0-beta.104

package/src/Number.ts

@@ -32,14 +32,11 @@ import * as Reducer from "./Reducer.ts"
  *
  * **Example** (Coercing values to numbers)
  *
- * ```ts
+ * ```ts import.meta.vitest
  * import { Number as N } from "effect"
  *
- * const num = N.Number("42")
- * console.log(num) // 42
- *
- * const float = N.Number("3.14")
- * console.log(float) // 3.14
+ * N.Number("42") // => 42
+ * N.Number("3.14") // => 3.14
  * ```
  *
  * @category constructors
@@ -56,12 +53,11 @@ export const Number = globalThis.Number
  *
  * **Example** (Checking for numbers)
  *
- * ```ts
+ * ```ts import.meta.vitest
  * import { Number } from "effect"
- * import * as assert from "node:assert"
  *
- * assert.deepStrictEqual(Number.isNumber(2), true)
- * assert.deepStrictEqual(Number.isNumber("2"), false)
+ * Number.isNumber(2) // => true
+ * Number.isNumber("2") // => false
  * ```
  *
  * @category guards
@@ -78,11 +74,10 @@ export const isNumber: (input: unknown) => input is number = predicate.isNumber
  *
  * **Example** (Adding numbers)
  *
- * ```ts
+ * ```ts import.meta.vitest
  * import { Number } from "effect"
- * import * as assert from "node:assert"
  *
- * assert.deepStrictEqual(Number.sum(2, 3), 5)
+ * Number.sum(2, 3) // => 5
  * ```
  *
  * @see {@link sumAll} for summing an iterable of numbers
@@ -100,11 +95,10 @@ export const sum: {
    *
    * **Example** (Adding numbers)
    *
-   * ```ts
+   * ```ts import.meta.vitest
    * import { Number } from "effect"
-   * import * as assert from "node:assert"
    *
-   * assert.deepStrictEqual(Number.sum(2, 3), 5)
+   * Number.sum(2, 3) // => 5
    * ```
    *
    * @see {@link sumAll} for summing an iterable of numbers
@@ -122,11 +116,10 @@ export const sum: {
    *
    * **Example** (Adding numbers)
    *
-   * ```ts
+   * ```ts import.meta.vitest
    * import { Number } from "effect"
-   * import * as assert from "node:assert"
    *
-   * assert.deepStrictEqual(Number.sum(2, 3), 5)
+   * Number.sum(2, 3) // => 5
    * ```
    *
    * @see {@link sumAll} for summing an iterable of numbers
@@ -146,11 +139,10 @@ export const sum: {
  *
  * **Example** (Multiplying numbers)
  *
- * ```ts
+ * ```ts import.meta.vitest
  * import { Number } from "effect"
- * import * as assert from "node:assert"
  *
- * assert.deepStrictEqual(Number.multiply(2, 3), 6)
+ * Number.multiply(2, 3) // => 6
  * ```
  *
  * @see {@link multiplyAll} for multiplying an iterable of numbers
@@ -168,11 +160,10 @@ export const multiply: {
    *
    * **Example** (Multiplying numbers)
    *
-   * ```ts
+   * ```ts import.meta.vitest
    * import { Number } from "effect"
-   * import * as assert from "node:assert"
    *
-   * assert.deepStrictEqual(Number.multiply(2, 3), 6)
+   * Number.multiply(2, 3) // => 6
    * ```
    *
    * @see {@link multiplyAll} for multiplying an iterable of numbers
@@ -190,11 +181,10 @@ export const multiply: {
    *
    * **Example** (Multiplying numbers)
    *
-   * ```ts
+   * ```ts import.meta.vitest
    * import { Number } from "effect"
-   * import * as assert from "node:assert"
    *
-   * assert.deepStrictEqual(Number.multiply(2, 3), 6)
+   * Number.multiply(2, 3) // => 6
    * ```
    *
    * @see {@link multiplyAll} for multiplying an iterable of numbers
@@ -214,11 +204,10 @@ export const multiply: {
  *
  * **Example** (Subtracting numbers)
  *
- * ```ts
+ * ```ts import.meta.vitest
  * import { Number } from "effect"
- * import * as assert from "node:assert"
  *
- * assert.deepStrictEqual(Number.subtract(2, 3), -1)
+ * Number.subtract(2, 3) // => -1
  * ```
  *
  * @category math
@@ -234,11 +223,10 @@ export const subtract: {
    *
    * **Example** (Subtracting numbers)
    *
-   * ```ts
+   * ```ts import.meta.vitest
    * import { Number } from "effect"
-   * import * as assert from "node:assert"
    *
-   * assert.deepStrictEqual(Number.subtract(2, 3), -1)
+   * Number.subtract(2, 3) // => -1
    * ```
    *
    * @category math
@@ -254,11 +242,10 @@ export const subtract: {
    *
    * **Example** (Subtracting numbers)
    *
-   * ```ts
+   * ```ts import.meta.vitest
    * import { Number } from "effect"
-   * import * as assert from "node:assert"
    *
-   * assert.deepStrictEqual(Number.subtract(2, 3), -1)
+   * Number.subtract(2, 3) // => -1
    * ```
    *
    * @category math
@@ -276,11 +263,11 @@ export const subtract: {
  *
  * **Example** (Dividing numbers safely)
  *
- * ```ts
- * import { Number } from "effect"
+ * ```ts import.meta.vitest
+ * import { Number, Option } from "effect"
  *
- * Number.divide(6, 3) // Option.some(2)
- * Number.divide(6, 0) // Option.none()
+ * Number.divide(6, 3) // => Option.some(2)
+ * Number.divide(6, 0) // => Option.none()
  * ```
  *
  * @see {@link divideUnsafe} for division that throws when the divisor is zero
@@ -299,11 +286,11 @@ export const divide: {
    *
    * **Example** (Dividing numbers safely)
    *
-   * ```ts
-   * import { Number } from "effect"
+   * ```ts import.meta.vitest
+   * import { Number, Option } from "effect"
    *
-   * Number.divide(6, 3) // Option.some(2)
-   * Number.divide(6, 0) // Option.none()
+   * Number.divide(6, 3) // => Option.some(2)
+   * Number.divide(6, 0) // => Option.none()
    * ```
    *
    * @see {@link divideUnsafe} for division that throws when the divisor is zero
@@ -322,11 +309,11 @@ export const divide: {
    *
    * **Example** (Dividing numbers safely)
    *
-   * ```ts
-   * import { Number } from "effect"
+   * ```ts import.meta.vitest
+   * import { Number, Option } from "effect"
    *
-   * Number.divide(6, 3) // Option.some(2)
-   * Number.divide(6, 0) // Option.none()
+   * Number.divide(6, 3) // => Option.some(2)
+   * Number.divide(6, 0) // => Option.none()
    * ```
    *
    * @see {@link divideUnsafe} for division that throws when the divisor is zero
@@ -355,12 +342,16 @@ export const divide: {
  *
  * **Example** (Dividing numbers unsafely)
  *
- * ```ts
- * import { Number } from "effect"
+ * ```ts import.meta.vitest
+ * import { Number, Result } from "effect"
  *
- * console.log(Number.divideUnsafe(6, 3)) // 2
+ * Number.divideUnsafe(6, 3) // => 2
  *
- * // Passing 0 as the divisor throws a RangeError("Division by zero").
+ * const failure = Result.try({
+ *   try: () => Number.divideUnsafe(6, 0),
+ *   catch: (error) => (error as Error).message
+ * })
+ * Result.merge(failure) // => "Division by zero"
  * ```
  *
  * @see {@link divide} for division that returns `Option.none` when the divisor is zero
@@ -383,12 +374,16 @@ export const divideUnsafe: {
    *
    * **Example** (Dividing numbers unsafely)
    *
-   * ```ts
-   * import { Number } from "effect"
+   * ```ts import.meta.vitest
+   * import { Number, Result } from "effect"
    *
-   * console.log(Number.divideUnsafe(6, 3)) // 2
+   * Number.divideUnsafe(6, 3) // => 2
    *
-   * // Passing 0 as the divisor throws a RangeError("Division by zero").
+   * const failure = Result.try({
+   *   try: () => Number.divideUnsafe(6, 0),
+   *   catch: (error) => (error as Error).message
+   * })
+   * Result.merge(failure) // => "Division by zero"
    * ```
    *
    * @see {@link divide} for division that returns `Option.none` when the divisor is zero
@@ -411,12 +406,16 @@ export const divideUnsafe: {
    *
    * **Example** (Dividing numbers unsafely)
    *
-   * ```ts
-   * import { Number } from "effect"
+   * ```ts import.meta.vitest
+   * import { Number, Result } from "effect"
    *
-   * console.log(Number.divideUnsafe(6, 3)) // 2
+   * Number.divideUnsafe(6, 3) // => 2
    *
-   * // Passing 0 as the divisor throws a RangeError("Division by zero").
+   * const failure = Result.try({
+   *   try: () => Number.divideUnsafe(6, 0),
+   *   catch: (error) => (error as Error).message
+   * })
+   * Result.merge(failure) // => "Division by zero"
    * ```
    *
    * @see {@link divide} for division that returns `Option.none` when the divisor is zero
@@ -440,11 +439,10 @@ export const divideUnsafe: {
  *
  * **Example** (Incrementing a number)
  *
- * ```ts
+ * ```ts import.meta.vitest
  * import { Number } from "effect"
- * import * as assert from "node:assert"
  *
- * assert.deepStrictEqual(Number.increment(2), 3)
+ * Number.increment(2) // => 3
  * ```
  *
  * @category math
@@ -461,11 +459,10 @@ export const increment = (n: number): number => n + 1
  *
  * **Example** (Decrementing a number)
  *
- * ```ts
+ * ```ts import.meta.vitest
  * import { Number } from "effect"
- * import * as assert from "node:assert"
  *
- * assert.deepStrictEqual(Number.decrement(3), 2)
+ * Number.decrement(3) // => 2
  * ```
  *
  * @category math
@@ -483,12 +480,12 @@ export const decrement = (n: number): number => n - 1
  *
  * **Example** (Comparing numbers)
  *
- * ```ts
+ * ```ts import.meta.vitest
  * import { Number } from "effect"
  *
- * console.log(Number.Order(1, 2)) // -1
- * console.log(Number.Order(2, 1)) // 1
- * console.log(Number.Order(1, 1)) // 0
+ * Number.Order(1, 2) // => -1
+ * Number.Order(2, 1) // => 1
+ * Number.Order(1, 1) // => 0
  * ```
  *
  * @category instances
@@ -506,12 +503,12 @@ export const Order: order.Order<number> = order.Number
  *
  * **Example** (Comparing numbers for equivalence)
  *
- * ```ts
+ * ```ts import.meta.vitest
  * import { Number } from "effect"
  *
- * console.log(Number.Equivalence(1, 1)) // true
- * console.log(Number.Equivalence(1, 2)) // false
- * console.log(Number.Equivalence(NaN, NaN)) // true
+ * Number.Equivalence(1, 1) // => true
+ * Number.Equivalence(1, 2) // => false
+ * Number.Equivalence(NaN, NaN) // => true
  * ```
  *
  * @category instances
@@ -528,13 +525,12 @@ export const Equivalence: Equ.Equivalence<number> = Equ.Number
  *
  * **Example** (Checking less-than comparisons)
  *
- * ```ts
+ * ```ts import.meta.vitest
  * import { Number } from "effect"
- * import * as assert from "node:assert"
  *
- * assert.deepStrictEqual(Number.isLessThan(2, 3), true)
- * assert.deepStrictEqual(Number.isLessThan(3, 3), false)
- * assert.deepStrictEqual(Number.isLessThan(4, 3), false)
+ * Number.isLessThan(2, 3) // => true
+ * Number.isLessThan(3, 3) // => false
+ * Number.isLessThan(4, 3) // => false
  * ```
  *
  * @category predicates
@@ -550,13 +546,12 @@ export const isLessThan: {
    *
    * **Example** (Checking less-than comparisons)
    *
-   * ```ts
+   * ```ts import.meta.vitest
    * import { Number } from "effect"
-   * import * as assert from "node:assert"
    *
-   * assert.deepStrictEqual(Number.isLessThan(2, 3), true)
-   * assert.deepStrictEqual(Number.isLessThan(3, 3), false)
-   * assert.deepStrictEqual(Number.isLessThan(4, 3), false)
+   * Number.isLessThan(2, 3) // => true
+   * Number.isLessThan(3, 3) // => false
+   * Number.isLessThan(4, 3) // => false
    * ```
    *
    * @category predicates
@@ -572,13 +567,12 @@ export const isLessThan: {
    *
    * **Example** (Checking less-than comparisons)
    *
-   * ```ts
+   * ```ts import.meta.vitest
    * import { Number } from "effect"
-   * import * as assert from "node:assert"
    *
-   * assert.deepStrictEqual(Number.isLessThan(2, 3), true)
-   * assert.deepStrictEqual(Number.isLessThan(3, 3), false)
-   * assert.deepStrictEqual(Number.isLessThan(4, 3), false)
+   * Number.isLessThan(2, 3) // => true
+   * Number.isLessThan(3, 3) // => false
+   * Number.isLessThan(4, 3) // => false
    * ```
    *
    * @category predicates
@@ -596,13 +590,12 @@ export const isLessThan: {
  *
  * **Example** (Checking less-than-or-equal comparisons)
  *
- * ```ts
+ * ```ts import.meta.vitest
  * import { Number } from "effect"
- * import * as assert from "node:assert"
  *
- * assert.deepStrictEqual(Number.isLessThanOrEqualTo(2, 3), true)
- * assert.deepStrictEqual(Number.isLessThanOrEqualTo(3, 3), true)
- * assert.deepStrictEqual(Number.isLessThanOrEqualTo(4, 3), false)
+ * Number.isLessThanOrEqualTo(2, 3) // => true
+ * Number.isLessThanOrEqualTo(3, 3) // => true
+ * Number.isLessThanOrEqualTo(4, 3) // => false
  * ```
  *
  * @category predicates
@@ -618,13 +611,12 @@ export const isLessThanOrEqualTo: {
    *
    * **Example** (Checking less-than-or-equal comparisons)
    *
-   * ```ts
+   * ```ts import.meta.vitest
    * import { Number } from "effect"
-   * import * as assert from "node:assert"
    *
-   * assert.deepStrictEqual(Number.isLessThanOrEqualTo(2, 3), true)
-   * assert.deepStrictEqual(Number.isLessThanOrEqualTo(3, 3), true)
-   * assert.deepStrictEqual(Number.isLessThanOrEqualTo(4, 3), false)
+   * Number.isLessThanOrEqualTo(2, 3) // => true
+   * Number.isLessThanOrEqualTo(3, 3) // => true
+   * Number.isLessThanOrEqualTo(4, 3) // => false
    * ```
    *
    * @category predicates
@@ -640,13 +632,12 @@ export const isLessThanOrEqualTo: {
    *
    * **Example** (Checking less-than-or-equal comparisons)
    *
-   * ```ts
+   * ```ts import.meta.vitest
    * import { Number } from "effect"
-   * import * as assert from "node:assert"
    *
-   * assert.deepStrictEqual(Number.isLessThanOrEqualTo(2, 3), true)
-   * assert.deepStrictEqual(Number.isLessThanOrEqualTo(3, 3), true)
-   * assert.deepStrictEqual(Number.isLessThanOrEqualTo(4, 3), false)
+   * Number.isLessThanOrEqualTo(2, 3) // => true
+   * Number.isLessThanOrEqualTo(3, 3) // => true
+   * Number.isLessThanOrEqualTo(4, 3) // => false
    * ```
    *
    * @category predicates
@@ -664,13 +655,12 @@ export const isLessThanOrEqualTo: {
  *
  * **Example** (Checking greater-than comparisons)
  *
- * ```ts
+ * ```ts import.meta.vitest
  * import { Number } from "effect"
- * import * as assert from "node:assert"
  *
- * assert.deepStrictEqual(Number.isGreaterThan(2, 3), false)
- * assert.deepStrictEqual(Number.isGreaterThan(3, 3), false)
- * assert.deepStrictEqual(Number.isGreaterThan(4, 3), true)
+ * Number.isGreaterThan(2, 3) // => false
+ * Number.isGreaterThan(3, 3) // => false
+ * Number.isGreaterThan(4, 3) // => true
  * ```
  *
  * @category predicates
@@ -686,13 +676,12 @@ export const isGreaterThan: {
    *
    * **Example** (Checking greater-than comparisons)
    *
-   * ```ts
+   * ```ts import.meta.vitest
    * import { Number } from "effect"
-   * import * as assert from "node:assert"
    *
-   * assert.deepStrictEqual(Number.isGreaterThan(2, 3), false)
-   * assert.deepStrictEqual(Number.isGreaterThan(3, 3), false)
-   * assert.deepStrictEqual(Number.isGreaterThan(4, 3), true)
+   * Number.isGreaterThan(2, 3) // => false
+   * Number.isGreaterThan(3, 3) // => false
+   * Number.isGreaterThan(4, 3) // => true
    * ```
    *
    * @category predicates
@@ -708,13 +697,12 @@ export const isGreaterThan: {
    *
    * **Example** (Checking greater-than comparisons)
    *
-   * ```ts
+   * ```ts import.meta.vitest
    * import { Number } from "effect"
-   * import * as assert from "node:assert"
    *
-   * assert.deepStrictEqual(Number.isGreaterThan(2, 3), false)
-   * assert.deepStrictEqual(Number.isGreaterThan(3, 3), false)
-   * assert.deepStrictEqual(Number.isGreaterThan(4, 3), true)
+   * Number.isGreaterThan(2, 3) // => false
+   * Number.isGreaterThan(3, 3) // => false
+   * Number.isGreaterThan(4, 3) // => true
    * ```
    *
    * @category predicates
@@ -732,13 +720,12 @@ export const isGreaterThan: {
  *
  * **Example** (Checking greater-than-or-equal comparisons)
  *
- * ```ts
+ * ```ts import.meta.vitest
  * import { Number } from "effect"
- * import * as assert from "node:assert"
  *
- * assert.deepStrictEqual(Number.isGreaterThanOrEqualTo(2, 3), false)
- * assert.deepStrictEqual(Number.isGreaterThanOrEqualTo(3, 3), true)
- * assert.deepStrictEqual(Number.isGreaterThanOrEqualTo(4, 3), true)
+ * Number.isGreaterThanOrEqualTo(2, 3) // => false
+ * Number.isGreaterThanOrEqualTo(3, 3) // => true
+ * Number.isGreaterThanOrEqualTo(4, 3) // => true
  * ```
  *
  * @category predicates
@@ -754,13 +741,12 @@ export const isGreaterThanOrEqualTo: {
    *
    * **Example** (Checking greater-than-or-equal comparisons)
    *
-   * ```ts
+   * ```ts import.meta.vitest
    * import { Number } from "effect"
-   * import * as assert from "node:assert"
    *
-   * assert.deepStrictEqual(Number.isGreaterThanOrEqualTo(2, 3), false)
-   * assert.deepStrictEqual(Number.isGreaterThanOrEqualTo(3, 3), true)
-   * assert.deepStrictEqual(Number.isGreaterThanOrEqualTo(4, 3), true)
+   * Number.isGreaterThanOrEqualTo(2, 3) // => false
+   * Number.isGreaterThanOrEqualTo(3, 3) // => true
+   * Number.isGreaterThanOrEqualTo(4, 3) // => true
    * ```
    *
    * @category predicates
@@ -776,13 +762,12 @@ export const isGreaterThanOrEqualTo: {
    *
    * **Example** (Checking greater-than-or-equal comparisons)
    *
-   * ```ts
+   * ```ts import.meta.vitest
    * import { Number } from "effect"
-   * import * as assert from "node:assert"
    *
-   * assert.deepStrictEqual(Number.isGreaterThanOrEqualTo(2, 3), false)
-   * assert.deepStrictEqual(Number.isGreaterThanOrEqualTo(3, 3), true)
-   * assert.deepStrictEqual(Number.isGreaterThanOrEqualTo(4, 3), true)
+   * Number.isGreaterThanOrEqualTo(2, 3) // => false
+   * Number.isGreaterThanOrEqualTo(3, 3) // => true
+   * Number.isGreaterThanOrEqualTo(4, 3) // => true
    * ```
    *
    * @category predicates
@@ -800,15 +785,14 @@ export const isGreaterThanOrEqualTo: {
  *
  * **Example** (Checking inclusive ranges)
  *
- * ```ts
+ * ```ts import.meta.vitest
  * import { Number } from "effect"
- * import * as assert from "node:assert"
  *
  * const between = Number.between({ minimum: 0, maximum: 5 })
  *
- * assert.deepStrictEqual(between(3), true)
- * assert.deepStrictEqual(between(-1), false)
- * assert.deepStrictEqual(between(6), false)
+ * between(3) // => true
+ * between(-1) // => false
+ * between(6) // => false
  * ```
  *
  * @see {@link clamp} for forcing a number into an inclusive range
@@ -826,15 +810,14 @@ export const between: {
    *
    * **Example** (Checking inclusive ranges)
    *
-   * ```ts
+   * ```ts import.meta.vitest
    * import { Number } from "effect"
-   * import * as assert from "node:assert"
    *
    * const between = Number.between({ minimum: 0, maximum: 5 })
    *
-   * assert.deepStrictEqual(between(3), true)
-   * assert.deepStrictEqual(between(-1), false)
-   * assert.deepStrictEqual(between(6), false)
+   * between(3) // => true
+   * between(-1) // => false
+   * between(6) // => false
    * ```
    *
    * @see {@link clamp} for forcing a number into an inclusive range
@@ -857,15 +840,14 @@ export const between: {
    *
    * **Example** (Checking inclusive ranges)
    *
-   * ```ts
+   * ```ts import.meta.vitest
    * import { Number } from "effect"
-   * import * as assert from "node:assert"
    *
    * const between = Number.between({ minimum: 0, maximum: 5 })
    *
-   * assert.deepStrictEqual(between(3), true)
-   * assert.deepStrictEqual(between(-1), false)
-   * assert.deepStrictEqual(between(6), false)
+   * between(3) // => true
+   * between(-1) // => false
+   * between(6) // => false
    * ```
    *
    * @see {@link clamp} for forcing a number into an inclusive range
@@ -897,15 +879,14 @@ export const between: {
  *
  * **Example** (Clamping to a range)
  *
- * ```ts
+ * ```ts import.meta.vitest
  * import { Number } from "effect"
- * import * as assert from "node:assert"
  *
  * const clamp = Number.clamp({ minimum: 1, maximum: 5 })
  *
- * assert.equal(clamp(3), 3)
- * assert.equal(clamp(0), 1)
- * assert.equal(clamp(6), 5)
+ * clamp(3) // => 3
+ * clamp(0) // => 1
+ * clamp(6) // => 5
  * ```
  *
  * @see {@link between} for checking whether a number is already inside a range
@@ -929,15 +910,14 @@ export const clamp: {
    *
    * **Example** (Clamping to a range)
    *
-   * ```ts
+   * ```ts import.meta.vitest
    * import { Number } from "effect"
-   * import * as assert from "node:assert"
    *
    * const clamp = Number.clamp({ minimum: 1, maximum: 5 })
    *
-   * assert.equal(clamp(3), 3)
-   * assert.equal(clamp(0), 1)
-   * assert.equal(clamp(6), 5)
+   * clamp(3) // => 3
+   * clamp(0) // => 1
+   * clamp(6) // => 5
    * ```
    *
    * @see {@link between} for checking whether a number is already inside a range
@@ -966,15 +946,14 @@ export const clamp: {
    *
    * **Example** (Clamping to a range)
    *
-   * ```ts
+   * ```ts import.meta.vitest
    * import { Number } from "effect"
-   * import * as assert from "node:assert"
    *
    * const clamp = Number.clamp({ minimum: 1, maximum: 5 })
    *
-   * assert.equal(clamp(3), 3)
-   * assert.equal(clamp(0), 1)
-   * assert.equal(clamp(6), 5)
+   * clamp(3) // => 3
+   * clamp(0) // => 1
+   * clamp(6) // => 5
    * ```
    *
    * @see {@link between} for checking whether a number is already inside a range
@@ -1000,11 +979,10 @@ export const clamp: {
  *
  * **Example** (Finding the minimum)
  *
- * ```ts
+ * ```ts import.meta.vitest
  * import { Number } from "effect"
- * import * as assert from "node:assert"
  *
- * assert.deepStrictEqual(Number.min(2, 3), 2)
+ * Number.min(2, 3) // => 2
  * ```
  *
  * @see {@link max} for selecting the larger value
@@ -1022,11 +1000,10 @@ export const min: {
    *
    * **Example** (Finding the minimum)
    *
-   * ```ts
+   * ```ts import.meta.vitest
    * import { Number } from "effect"
-   * import * as assert from "node:assert"
    *
-   * assert.deepStrictEqual(Number.min(2, 3), 2)
+   * Number.min(2, 3) // => 2
    * ```
    *
    * @see {@link max} for selecting the larger value
@@ -1044,11 +1021,10 @@ export const min: {
    *
    * **Example** (Finding the minimum)
    *
-   * ```ts
+   * ```ts import.meta.vitest
    * import { Number } from "effect"
-   * import * as assert from "node:assert"
    *
-   * assert.deepStrictEqual(Number.min(2, 3), 2)
+   * Number.min(2, 3) // => 2
    * ```
    *
    * @see {@link max} for selecting the larger value
@@ -1068,11 +1044,10 @@ export const min: {
  *
  * **Example** (Finding the maximum)
  *
- * ```ts
+ * ```ts import.meta.vitest
  * import { Number } from "effect"
- * import * as assert from "node:assert"
  *
- * assert.deepStrictEqual(Number.max(2, 3), 3)
+ * Number.max(2, 3) // => 3
  * ```
  *
  * @see {@link min} for selecting the smaller value
@@ -1090,11 +1065,10 @@ export const max: {
    *
    * **Example** (Finding the maximum)
    *
-   * ```ts
+   * ```ts import.meta.vitest
    * import { Number } from "effect"
-   * import * as assert from "node:assert"
    *
-   * assert.deepStrictEqual(Number.max(2, 3), 3)
+   * Number.max(2, 3) // => 3
    * ```
    *
    * @see {@link min} for selecting the smaller value
@@ -1112,11 +1086,10 @@ export const max: {
    *
    * **Example** (Finding the maximum)
    *
-   * ```ts
+   * ```ts import.meta.vitest
    * import { Number } from "effect"
-   * import * as assert from "node:assert"
    *
-   * assert.deepStrictEqual(Number.max(2, 3), 3)
+   * Number.max(2, 3) // => 3
    * ```
    *
    * @see {@link min} for selecting the smaller value
@@ -1136,13 +1109,12 @@ export const max: {
  *
  * **Example** (Determining the sign)
  *
- * ```ts
+ * ```ts import.meta.vitest
  * import { Number } from "effect"
- * import * as assert from "node:assert"
  *
- * assert.deepStrictEqual(Number.sign(-5), -1)
- * assert.deepStrictEqual(Number.sign(0), 0)
- * assert.deepStrictEqual(Number.sign(5), 1)
+ * Number.sign(-5) // => -1
+ * Number.sign(0) // => 0
+ * Number.sign(5) // => 1
  * ```
  *
  * @category math
@@ -1159,11 +1131,10 @@ export const sign = (n: number): Ordering => Order(n, 0)
  *
  * **Example** (Summing an iterable)
  *
- * ```ts
+ * ```ts import.meta.vitest
  * import { Number } from "effect"
- * import * as assert from "node:assert"
  *
- * assert.deepStrictEqual(Number.sumAll([2, 3, 4]), 9)
+ * Number.sumAll([2, 3, 4]) // => 9
  * ```
  *
  * @see {@link sum} for adding two numbers
@@ -1189,11 +1160,10 @@ export const sumAll = (collection: Iterable<number>): number => {
  *
  * **Example** (Multiplying an iterable)
  *
- * ```ts
+ * ```ts import.meta.vitest
  * import { Number } from "effect"
- * import * as assert from "node:assert"
  *
- * assert.deepStrictEqual(Number.multiplyAll([2, 3, 4]), 24)
+ * Number.multiplyAll([2, 3, 4]) // => 24
  * ```
  *
  * @see {@link multiply} for multiplying two numbers
@@ -1223,13 +1193,12 @@ export const multiplyAll = (collection: Iterable<number>): number => {
  *
  * **Example** (Calculating remainders)
  *
- * ```ts
+ * ```ts import.meta.vitest
  * import { Number } from "effect"
- * import * as assert from "node:assert"
  *
- * assert.deepStrictEqual(Number.remainder(2, 2), 0)
- * assert.deepStrictEqual(Number.remainder(3, 2), 1)
- * assert.deepStrictEqual(Number.remainder(-4, 2), -0)
+ * Number.remainder(2, 2) // => 0
+ * Number.remainder(3, 2) // => 1
+ * Number.remainder(-4, 2) // => -0
  * ```
  *
  * @see {@link divide} for quotient calculation with division-by-zero represented as `Option.none`
@@ -1248,13 +1217,12 @@ export const remainder: {
    *
    * **Example** (Calculating remainders)
    *
-   * ```ts
+   * ```ts import.meta.vitest
    * import { Number } from "effect"
-   * import * as assert from "node:assert"
    *
-   * assert.deepStrictEqual(Number.remainder(2, 2), 0)
-   * assert.deepStrictEqual(Number.remainder(3, 2), 1)
-   * assert.deepStrictEqual(Number.remainder(-4, 2), -0)
+   * Number.remainder(2, 2) // => 0
+   * Number.remainder(3, 2) // => 1
+   * Number.remainder(-4, 2) // => -0
    * ```
    *
    * @see {@link divide} for quotient calculation with division-by-zero represented as `Option.none`
@@ -1273,13 +1241,12 @@ export const remainder: {
    *
    * **Example** (Calculating remainders)
    *
-   * ```ts
+   * ```ts import.meta.vitest
    * import { Number } from "effect"
-   * import * as assert from "node:assert"
    *
-   * assert.deepStrictEqual(Number.remainder(2, 2), 0)
-   * assert.deepStrictEqual(Number.remainder(3, 2), 1)
-   * assert.deepStrictEqual(Number.remainder(-4, 2), -0)
+   * Number.remainder(2, 2) // => 0
+   * Number.remainder(3, 2) // => 1
+   * Number.remainder(-4, 2) // => -0
    * ```
    *
    * @see {@link divide} for quotient calculation with division-by-zero represented as `Option.none`
@@ -1336,12 +1303,11 @@ function toScientificInteger(n: number): readonly [coefficient: bigint, exponent
  *
  * **Example** (Finding the next power of two)
  *
- * ```ts
+ * ```ts import.meta.vitest
  * import { Number } from "effect"
- * import * as assert from "node:assert"
  *
- * assert.deepStrictEqual(Number.nextPow2(5), 8)
- * assert.deepStrictEqual(Number.nextPow2(17), 32)
+ * Number.nextPow2(5) // => 8
+ * Number.nextPow2(17) // => 32
  * ```
  *
  * @category math
@@ -1362,15 +1328,15 @@ export const nextPow2 = (n: number): number => {
  *
  * **Example** (Parsing numbers from strings)
  *
- * ```ts
- * import { Number } from "effect"
+ * ```ts import.meta.vitest
+ * import { Number, Option } from "effect"
  *
- * Number.parse("42") // Option.some(42)
- * Number.parse("3.14") // Option.some(3.14)
- * Number.parse("NaN") // Option.some(NaN)
- * Number.parse("Infinity") // Option.some(Infinity)
- * Number.parse("-Infinity") // Option.some(-Infinity)
- * Number.parse("not a number") // Option.none()
+ * Number.parse("42") // => Option.some(42)
+ * Number.parse("3.14") // => Option.some(3.14)
+ * Number.parse("NaN") // => Option.some(NaN)
+ * Number.parse("Infinity") // => Option.some(Infinity)
+ * Number.parse("-Infinity") // => Option.some(-Infinity)
+ * Number.parse("not a number") // => Option.none()
  * ```
  *
  * @see {@link Number} for native constructor coercion
@@ -1404,12 +1370,11 @@ export const parse = (s: string): Option.Option<number> => {
  *
  * **Example** (Rounding with precision)
  *
- * ```ts
+ * ```ts import.meta.vitest
  * import { Number } from "effect"
- * import * as assert from "node:assert"
  *
- * assert.deepStrictEqual(Number.round(1.1234, 2), 1.12)
- * assert.deepStrictEqual(Number.round(1.567, 2), 1.57)
+ * Number.round(1.1234, 2) // => 1.12
+ * Number.round(1.567, 2) // => 1.57
  * ```
  *
  * @category math
@@ -1425,12 +1390,11 @@ export const round: {
    *
    * **Example** (Rounding with precision)
    *
-   * ```ts
+   * ```ts import.meta.vitest
    * import { Number } from "effect"
-   * import * as assert from "node:assert"
    *
-   * assert.deepStrictEqual(Number.round(1.1234, 2), 1.12)
-   * assert.deepStrictEqual(Number.round(1.567, 2), 1.57)
+   * Number.round(1.1234, 2) // => 1.12
+   * Number.round(1.567, 2) // => 1.57
    * ```
    *
    * @category math
@@ -1446,12 +1410,11 @@ export const round: {
    *
    * **Example** (Rounding with precision)
    *
-   * ```ts
+   * ```ts import.meta.vitest
    * import { Number } from "effect"
-   * import * as assert from "node:assert"
    *
-   * assert.deepStrictEqual(Number.round(1.1234, 2), 1.12)
-   * assert.deepStrictEqual(Number.round(1.567, 2), 1.57)
+   * Number.round(1.1234, 2) // => 1.12
+   * Number.round(1.567, 2) // => 1.57
    * ```
    *
    * @category math