effect 4.0.0-beta.102 → 4.0.0-beta.103

package/dist/Number.d.ts

@@ -29,14 +29,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
@@ -52,12 +49,11 @@ export declare const Number: NumberConstructor;
  *
  * **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
@@ -73,11 +69,10 @@ export declare const isNumber: (input: unknown) => input is number;
  *
  * **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
@@ -95,11 +90,10 @@ export declare 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
@@ -117,11 +111,10 @@ export declare 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
@@ -140,11 +133,10 @@ export declare 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
@@ -162,11 +154,10 @@ export declare 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
@@ -184,11 +175,10 @@ export declare 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
@@ -207,11 +197,10 @@ export declare 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
@@ -227,11 +216,10 @@ export declare 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
@@ -247,11 +235,10 @@ export declare 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
@@ -268,11 +255,11 @@ export declare 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
@@ -291,11 +278,11 @@ export declare 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
@@ -314,11 +301,11 @@ export declare 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
@@ -343,12 +330,16 @@ export declare 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
@@ -371,12 +362,16 @@ export declare 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
@@ -399,12 +394,16 @@ export declare 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
@@ -423,11 +422,10 @@ export declare 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
@@ -443,11 +441,10 @@ export declare const increment: (n: number) => number;
  *
  * **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
@@ -464,12 +461,12 @@ export declare const decrement: (n: number) => number;
  *
  * **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
@@ -486,12 +483,12 @@ export declare const Order: order.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
@@ -507,13 +504,12 @@ export declare const Equivalence: Equ.Equivalence<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
@@ -529,13 +525,12 @@ export declare 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
@@ -551,13 +546,12 @@ export declare 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
@@ -574,13 +568,12 @@ export declare 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
@@ -596,13 +589,12 @@ export declare 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
@@ -618,13 +610,12 @@ export declare 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
@@ -641,13 +632,12 @@ export declare 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
@@ -663,13 +653,12 @@ export declare 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
@@ -685,13 +674,12 @@ export declare 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 +696,12 @@ export declare 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
@@ -730,13 +717,12 @@ export declare 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
@@ -752,13 +738,12 @@ export declare 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
@@ -775,15 +760,14 @@ export declare 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
@@ -801,15 +785,14 @@ export declare 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
@@ -830,15 +813,14 @@ export declare 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
@@ -866,15 +848,14 @@ export declare 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
@@ -898,15 +879,14 @@ export declare 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
@@ -933,15 +913,14 @@ export declare 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
@@ -963,11 +942,10 @@ export declare 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
@@ -985,11 +963,10 @@ export declare 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
@@ -1007,11 +984,10 @@ export declare 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
@@ -1030,11 +1006,10 @@ export declare 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
@@ -1052,11 +1027,10 @@ export declare 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
@@ -1074,11 +1048,10 @@ export declare 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
@@ -1097,13 +1070,12 @@ export declare 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
@@ -1119,11 +1091,10 @@ export declare const sign: (n: number) => Ordering;
  *
  * **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
@@ -1142,11 +1113,10 @@ export declare 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
@@ -1166,13 +1136,12 @@ export declare 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`
@@ -1191,13 +1160,12 @@ export declare 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`
@@ -1216,13 +1184,12 @@ export declare 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`
@@ -1241,12 +1208,11 @@ export declare const remainder: {
  *
  * **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
@@ -1263,15 +1229,15 @@ export declare 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
@@ -1289,12 +1255,11 @@ export declare 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
@@ -1310,12 +1275,11 @@ export declare 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
@@ -1331,12 +1295,11 @@ export declare 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