effect 4.0.0-beta.98 → 4.0.0-rc.108

package/src/Duration.ts

@@ -27,6 +27,8 @@ const TypeId = "~effect/time/Duration"
 
 const bigint0 = BigInt(0)
 const bigint1 = BigInt(1)
+const bigint2 = BigInt(2)
+const bigint10 = BigInt(10)
 const bigint24 = BigInt(24)
 const bigint60 = BigInt(60)
 const bigint1e3 = BigInt(1_000)
@@ -38,8 +40,20 @@ const roundTiesAwayFromZero = (input: number): bigint =>
 
 const roundMillisToNanos = (millis: number): bigint => roundTiesAwayFromZero(millis * 1_000_000)
 
-const parseNanos = (input: string, scale: bigint): bigint =>
-  input.includes(".") ? roundTiesAwayFromZero(Number(input) * Number(scale)) : BigInt(input) * scale
+const parseNanos = (input: string, scale: bigint): bigint => {
+  const decimalIndex = input.indexOf(".")
+  if (decimalIndex === -1) return BigInt(input) * scale
+
+  const isNegative = input[0] === "-"
+  const fractional = input.slice(decimalIndex + 1)
+  const fractionalScale = bigint10 ** BigInt(fractional.length)
+  const scaled = (
+    BigInt(input.slice(isNegative ? 1 : 0, decimalIndex)) * fractionalScale + BigInt(fractional)
+  ) * scale
+  const rounded = scaled / fractionalScale +
+    (scaled % fractionalScale * bigint2 >= fractionalScale ? bigint1 : bigint0)
+  return isNegative ? -rounded : rounded
+}
 
 const nanosToHrTime = (nanos: bigint): [seconds: number, nanos: number] => {
   const sign = nanos < bigint0 ? -bigint1 : bigint1
@@ -175,12 +189,12 @@ export type Input =
  *
  * **Example** (Combining duration object fields)
  *
- * ```ts
+ * ```ts import.meta.vitest
  * import { Duration } from "effect"
  *
- * Duration.fromInputUnsafe({ seconds: 30 })
- * Duration.fromInputUnsafe({ days: 1 })
- * Duration.fromInputUnsafe({ seconds: 1, nanoseconds: 500 })
+ * Duration.fromInputUnsafe({ seconds: 30 }) // => Duration.seconds(30)
+ * Duration.fromInputUnsafe({ days: 1 }) // => Duration.days(1)
+ * Duration.fromInputUnsafe({ seconds: 1, nanoseconds: 500 }) // => Duration.nanos(1_000_000_500n)
  * ```
  *
  * @category models
@@ -213,13 +227,13 @@ const DURATION_REGEXP = /^(-?\d+(?:\.\d+)?)\s+(nanos?|micros?|millis?|seconds?|m
  *
  * **Example** (Decoding duration inputs)
  *
- * ```ts
+ * ```ts import.meta.vitest
  * import { Duration } from "effect"
  *
- * const duration1 = Duration.fromInputUnsafe(1000) // 1000 milliseconds
- * const duration2 = Duration.fromInputUnsafe("5 seconds")
- * const duration3 = Duration.fromInputUnsafe("Infinity")
- * const duration4 = Duration.fromInputUnsafe([2, 500_000_000]) // 2 seconds and 500ms
+ * Duration.fromInputUnsafe(1000) // => Duration.millis(1000)
+ * Duration.fromInputUnsafe("5 seconds") // => Duration.seconds(5)
+ * Duration.fromInputUnsafe("Infinity") // => Duration.infinity
+ * Duration.fromInputUnsafe([2, 500_000_000]) // => Duration.nanos(2_500_000_000n)
  * ```
  *
  * @category constructors
@@ -316,12 +330,11 @@ const invalid = (input: unknown): never => {
  *
  * **Example** (Safely decoding duration inputs)
  *
- * ```ts
+ * ```ts import.meta.vitest
  * import { Duration, Option } from "effect"
  *
- * Duration.fromInput(1000).pipe(Option.map(Duration.toSeconds)) // Some(1)
- *
- * Duration.fromInput("invalid" as any) // None
+ * Duration.fromInput(1000) // => Option.some(Duration.seconds(1))
+ * Duration.fromInput("invalid" as any) // => Option.none()
  * ```
  *
  * @category constructors
@@ -338,7 +351,18 @@ const negativeInfinityDurationValue: DurationValue = { _tag: "NegativeInfinity"
 const DurationProto: Omit<Duration, "value"> = {
   [TypeId]: TypeId,
   [Hash.symbol](this: Duration) {
-    return Hash.structure(this.value)
+    // Hash equal finite durations using the same canonical nanoseconds
+    // representation used by `equals`.
+    switch (this.value._tag) {
+      case "Millis": {
+        const nanos = this.value.millis * 1_000_000
+        return Number.isFinite(nanos) ? Hash.hash(roundTiesAwayFromZero(nanos)) : Hash.number(this.value.millis)
+      }
+      case "Nanos":
+        return Hash.hash(this.value.nanos)
+      default:
+        return Hash.structure(this.value)
+    }
   },
   [Equal.symbol](this: Duration, that: unknown): boolean {
     return isDuration(that) && equals(this, that)
@@ -400,11 +424,11 @@ const make = (input: number | bigint): Duration => {
  *
  * **Example** (Checking for durations)
  *
- * ```ts
+ * ```ts import.meta.vitest
  * import { Duration } from "effect"
  *
- * console.log(Duration.isDuration(Duration.seconds(1))) // true
- * console.log(Duration.isDuration(1000)) // false
+ * Duration.isDuration(Duration.seconds(1)) // => true
+ * Duration.isDuration(1000) // => false
  * ```
  *
  * @category guards
@@ -417,14 +441,14 @@ export const isDuration = (u: unknown): u is Duration => hasProperty(u, TypeId)
  *
  * **Example** (Checking finite durations)
  *
- * ```ts
+ * ```ts import.meta.vitest
  * import { Duration } from "effect"
  *
- * console.log(Duration.isFinite(Duration.seconds(5))) // true
- * console.log(Duration.isFinite(Duration.infinity)) // false
+ * Duration.isFinite(Duration.seconds(5)) // => true
+ * Duration.isFinite(Duration.infinity) // => false
  * ```
  *
- * @category guards
+ * @category predicates
  * @since 2.0.0
  */
 export const isFinite = (self: Duration): boolean =>
@@ -435,14 +459,14 @@ export const isFinite = (self: Duration): boolean =>
  *
  * **Example** (Checking for zero durations)
  *
- * ```ts
+ * ```ts import.meta.vitest
  * import { Duration } from "effect"
  *
- * console.log(Duration.isZero(Duration.zero)) // true
- * console.log(Duration.isZero(Duration.seconds(1))) // false
+ * Duration.isZero(Duration.zero) // => true
+ * Duration.isZero(Duration.seconds(1)) // => false
  * ```
  *
- * @category guards
+ * @category predicates
  * @since 3.5.0
  */
 export const isZero = (self: Duration): boolean => {
@@ -462,15 +486,15 @@ export const isZero = (self: Duration): boolean => {
  *
  * **Example** (Checking for negative durations)
  *
- * ```ts
+ * ```ts import.meta.vitest
  * import { Duration } from "effect"
  *
- * console.log(Duration.isNegative(Duration.seconds(-5))) // true
- * console.log(Duration.isNegative(Duration.zero)) // false
- * console.log(Duration.isNegative(Duration.negativeInfinity)) // true
+ * Duration.isNegative(Duration.seconds(-5)) // => true
+ * Duration.isNegative(Duration.zero) // => false
+ * Duration.isNegative(Duration.negativeInfinity) // => true
  * ```
  *
- * @category guards
+ * @category predicates
  * @since 4.0.0
  */
 export const isNegative = (self: Duration): boolean => {
@@ -491,15 +515,15 @@ export const isNegative = (self: Duration): boolean => {
  *
  * **Example** (Checking for positive durations)
  *
- * ```ts
+ * ```ts import.meta.vitest
  * import { Duration } from "effect"
  *
- * console.log(Duration.isPositive(Duration.seconds(5))) // true
- * console.log(Duration.isPositive(Duration.zero)) // false
- * console.log(Duration.isPositive(Duration.infinity)) // true
+ * Duration.isPositive(Duration.seconds(5)) // => true
+ * Duration.isPositive(Duration.zero) // => false
+ * Duration.isPositive(Duration.infinity) // => true
  * ```
  *
- * @category guards
+ * @category predicates
  * @since 4.0.0
  */
 export const isPositive = (self: Duration): boolean => {
@@ -520,11 +544,11 @@ export const isPositive = (self: Duration): boolean => {
  *
  * **Example** (Taking absolute duration values)
  *
- * ```ts
+ * ```ts import.meta.vitest
  * import { Duration } from "effect"
  *
- * Duration.toMillis(Duration.abs(Duration.seconds(-5))) // 5000
- * Duration.abs(Duration.negativeInfinity) === Duration.infinity // true
+ * Duration.abs(Duration.seconds(-5)) // => Duration.seconds(5)
+ * Duration.abs(Duration.negativeInfinity) // => Duration.infinity
  * ```
  *
  * @category math
@@ -547,11 +571,11 @@ export const abs = (self: Duration): Duration => {
  *
  * **Example** (Negating durations)
  *
- * ```ts
+ * ```ts import.meta.vitest
  * import { Duration } from "effect"
  *
- * Duration.toMillis(Duration.negate(Duration.seconds(5))) // -5000
- * Duration.negate(Duration.infinity) === Duration.negativeInfinity // true
+ * Duration.negate(Duration.seconds(5)) // => Duration.seconds(-5)
+ * Duration.negate(Duration.infinity) // => Duration.negativeInfinity
  * ```
  *
  * @category math
@@ -575,10 +599,10 @@ export const negate = (self: Duration): Duration => {
  *
  * **Example** (Referencing the zero duration)
  *
- * ```ts
+ * ```ts import.meta.vitest
  * import { Duration } from "effect"
  *
- * console.log(Duration.toMillis(Duration.zero)) // 0
+ * Duration.toMillis(Duration.zero) // => 0
  * ```
  *
  * @category constructors
@@ -591,10 +615,10 @@ export const zero: Duration = make(0)
  *
  * **Example** (Referencing infinite duration)
  *
- * ```ts
+ * ```ts import.meta.vitest
  * import { Duration } from "effect"
  *
- * console.log(Duration.toMillis(Duration.infinity)) // Infinity
+ * Duration.toMillis(Duration.infinity) // => Infinity
  * ```
  *
  * @category constructors
@@ -607,10 +631,10 @@ export const infinity: Duration = make(Infinity)
  *
  * **Example** (Referencing negative infinite duration)
  *
- * ```ts
+ * ```ts import.meta.vitest
  * import { Duration } from "effect"
  *
- * console.log(Duration.toMillis(Duration.negativeInfinity)) // -Infinity
+ * Duration.toMillis(Duration.negativeInfinity) // => -Infinity
  * ```
  *
  * @category constructors
@@ -623,11 +647,10 @@ export const negativeInfinity: Duration = make(-Infinity)
  *
  * **Example** (Creating durations from nanoseconds)
  *
- * ```ts
+ * ```ts import.meta.vitest
  * import { Duration } from "effect"
  *
- * const duration = Duration.nanos(BigInt(500_000_000))
- * console.log(Duration.toMillis(duration)) // 500
+ * Duration.nanos(500_000_000n) // => Duration.nanos(500_000_000n)
  * ```
  *
  * @category constructors
@@ -640,11 +663,10 @@ export const nanos = (nanos: bigint): Duration => make(nanos)
  *
  * **Example** (Creating durations from microseconds)
  *
- * ```ts
+ * ```ts import.meta.vitest
  * import { Duration } from "effect"
  *
- * const duration = Duration.micros(BigInt(500_000))
- * console.log(Duration.toMillis(duration)) // 500
+ * Duration.micros(500_000n) // => Duration.nanos(500_000_000n)
  * ```
  *
  * @category constructors
@@ -657,11 +679,10 @@ export const micros = (micros: bigint): Duration => make(micros * bigint1e3)
  *
  * **Example** (Creating durations from milliseconds)
  *
- * ```ts
+ * ```ts import.meta.vitest
  * import { Duration } from "effect"
  *
- * const duration = Duration.millis(1000)
- * console.log(Duration.toMillis(duration)) // 1000
+ * Duration.toMillis(Duration.millis(1000)) // => 1000
  * ```
  *
  * @category constructors
@@ -674,11 +695,10 @@ export const millis = (millis: number): Duration => make(millis)
  *
  * **Example** (Creating durations from seconds)
  *
- * ```ts
+ * ```ts import.meta.vitest
  * import { Duration } from "effect"
  *
- * const duration = Duration.seconds(30)
- * console.log(Duration.toMillis(duration)) // 30000
+ * Duration.toMillis(Duration.seconds(30)) // => 30_000
  * ```
  *
  * @category constructors
@@ -691,11 +711,10 @@ export const seconds = (seconds: number): Duration => make(seconds * 1000)
  *
  * **Example** (Creating durations from minutes)
  *
- * ```ts
+ * ```ts import.meta.vitest
  * import { Duration } from "effect"
  *
- * const duration = Duration.minutes(5)
- * console.log(Duration.toMillis(duration)) // 300000
+ * Duration.toMillis(Duration.minutes(5)) // => 300_000
  * ```
  *
  * @category constructors
@@ -708,11 +727,10 @@ export const minutes = (minutes: number): Duration => make(minutes * 60_000)
  *
  * **Example** (Creating durations from hours)
  *
- * ```ts
+ * ```ts import.meta.vitest
  * import { Duration } from "effect"
  *
- * const duration = Duration.hours(2)
- * console.log(Duration.toMillis(duration)) // 7200000
+ * Duration.toMillis(Duration.hours(2)) // => 7_200_000
  * ```
  *
  * @category constructors
@@ -725,11 +743,10 @@ export const hours = (hours: number): Duration => make(hours * 3_600_000)
  *
  * **Example** (Creating durations from days)
  *
- * ```ts
+ * ```ts import.meta.vitest
  * import { Duration } from "effect"
  *
- * const duration = Duration.days(1)
- * console.log(Duration.toMillis(duration)) // 86400000
+ * Duration.toMillis(Duration.days(1)) // => 86_400_000
  * ```
  *
  * @category constructors
@@ -742,11 +759,10 @@ export const days = (days: number): Duration => make(days * 86_400_000)
  *
  * **Example** (Creating durations from weeks)
  *
- * ```ts
+ * ```ts import.meta.vitest
  * import { Duration } from "effect"
  *
- * const duration = Duration.weeks(1)
- * console.log(Duration.toMillis(duration)) // 604800000
+ * Duration.toMillis(Duration.weeks(1)) // => 604_800_000
  * ```
  *
  * @category constructors
@@ -759,11 +775,11 @@ export const weeks = (weeks: number): Duration => make(weeks * 604_800_000)
  *
  * **Example** (Converting durations to milliseconds)
  *
- * ```ts
+ * ```ts import.meta.vitest
  * import { Duration } from "effect"
  *
- * console.log(Duration.toMillis(Duration.seconds(5))) // 5000
- * console.log(Duration.toMillis(Duration.minutes(2))) // 120000
+ * Duration.toMillis(Duration.seconds(5)) // => 5000
+ * Duration.toMillis(Duration.minutes(2)) // => 120_000
  * ```
  *
  * @category getters
@@ -782,11 +798,11 @@ export const toMillis = (self: Input): number =>
  *
  * **Example** (Converting durations to seconds)
  *
- * ```ts
+ * ```ts import.meta.vitest
  * import { Duration } from "effect"
  *
- * console.log(Duration.toSeconds(Duration.millis(5000))) // 5
- * console.log(Duration.toSeconds(Duration.minutes(2))) // 120
+ * Duration.toSeconds(Duration.millis(5000)) // => 5
+ * Duration.toSeconds(Duration.minutes(2)) // => 120
  * ```
  *
  * @category getters
@@ -805,11 +821,11 @@ export const toSeconds = (self: Input): number =>
  *
  * **Example** (Converting durations to minutes)
  *
- * ```ts
+ * ```ts import.meta.vitest
  * import { Duration } from "effect"
  *
- * console.log(Duration.toMinutes(Duration.seconds(120))) // 2
- * console.log(Duration.toMinutes(Duration.hours(1))) // 60
+ * Duration.toMinutes(Duration.seconds(120)) // => 2
+ * Duration.toMinutes(Duration.hours(1)) // => 60
  * ```
  *
  * @category getters
@@ -828,11 +844,11 @@ export const toMinutes = (self: Input): number =>
  *
  * **Example** (Converting durations to hours)
  *
- * ```ts
+ * ```ts import.meta.vitest
  * import { Duration } from "effect"
  *
- * console.log(Duration.toHours(Duration.minutes(120))) // 2
- * console.log(Duration.toHours(Duration.days(1))) // 24
+ * Duration.toHours(Duration.minutes(120)) // => 2
+ * Duration.toHours(Duration.days(1)) // => 24
  * ```
  *
  * @category getters
@@ -851,11 +867,11 @@ export const toHours = (self: Input): number =>
  *
  * **Example** (Converting durations to days)
  *
- * ```ts
+ * ```ts import.meta.vitest
  * import { Duration } from "effect"
  *
- * console.log(Duration.toDays(Duration.hours(48))) // 2
- * console.log(Duration.toDays(Duration.weeks(1))) // 7
+ * Duration.toDays(Duration.hours(48)) // => 2
+ * Duration.toDays(Duration.weeks(1)) // => 7
  * ```
  *
  * @category getters
@@ -874,11 +890,11 @@ export const toDays = (self: Input): number =>
  *
  * **Example** (Converting durations to weeks)
  *
- * ```ts
+ * ```ts import.meta.vitest
  * import { Duration } from "effect"
  *
- * console.log(Duration.toWeeks(Duration.days(14))) // 2
- * console.log(Duration.toWeeks(Duration.days(7))) // 1
+ * Duration.toWeeks(Duration.days(14)) // => 2
+ * Duration.toWeeks(Duration.days(7)) // => 1
  * ```
  *
  * @category getters
@@ -911,12 +927,10 @@ export const toWeeks = (self: Input): number =>
  *
  * **Example** (Reading nanoseconds unsafely)
  *
- * ```ts
+ * ```ts import.meta.vitest
  * import { Duration } from "effect"
  *
- * const duration = Duration.seconds(2)
- * const nanos = Duration.toNanosUnsafe(duration)
- * console.log(nanos) // 2000000000n
+ * Duration.toNanosUnsafe(Duration.seconds(2)) // => 2_000_000_000n
  *
  * // Duration.toNanosUnsafe(Duration.infinity)
  * // throws Error: "Cannot convert infinite duration to nanos"
@@ -947,13 +961,11 @@ export const toNanosUnsafe = (input: Input): bigint => {
  *
  * **Example** (Safely reading nanoseconds)
  *
- * ```ts
+ * ```ts import.meta.vitest
  * import { Duration, Option } from "effect"
  *
- * Duration.toNanos(Duration.seconds(1)) // Some(1000000000n)
- *
- * Duration.toNanos(Duration.infinity) // None
- * Option.getOrUndefined(Duration.toNanos(Duration.infinity)) // undefined
+ * Duration.toNanos(Duration.seconds(1)) // => Option.some(1_000_000_000n)
+ * Duration.toNanos(Duration.infinity) // => Option.none()
  * ```
  *
  * @category getters
@@ -966,12 +978,10 @@ export const toNanos: (self: Input) => Option.Option<bigint> = Option.liftThrowa
  *
  * **Example** (Converting durations to high-resolution time)
  *
- * ```ts
+ * ```ts import.meta.vitest
  * import { Duration } from "effect"
  *
- * const duration = Duration.millis(1500)
- * const hrtime = Duration.toHrTime(duration)
- * console.log(hrtime) // [1, 500000000]
+ * Duration.toHrTime(Duration.millis(1500)) // => [1, 500_000_000]
  * ```
  *
  * @category getters
@@ -1002,15 +1012,14 @@ export const toHrTime = (input: Input): [seconds: number, nanos: number] => {
  *
  * **Example** (Pattern matching on duration representations)
  *
- * ```ts
+ * ```ts import.meta.vitest
  * import { Duration } from "effect"
  *
- * const result = Duration.match(Duration.seconds(5), {
+ * Duration.match(Duration.seconds(5), {
  *   onMillis: (millis) => `${millis} milliseconds`,
  *   onNanos: (nanos) => `${nanos} nanoseconds`,
  *   onInfinity: () => "infinite"
- * })
- * console.log(result) // "5000 milliseconds"
+ * }) // => "5000 milliseconds"
  * ```
  *
  * @category pattern matching
@@ -1028,15 +1037,14 @@ export const match: {
    *
    * **Example** (Pattern matching on duration representations)
    *
-   * ```ts
+   * ```ts import.meta.vitest
    * import { Duration } from "effect"
    *
-   * const result = Duration.match(Duration.seconds(5), {
+   * Duration.match(Duration.seconds(5), {
    *   onMillis: (millis) => `${millis} milliseconds`,
    *   onNanos: (nanos) => `${nanos} nanoseconds`,
    *   onInfinity: () => "infinite"
-   * })
-   * console.log(result) // "5000 milliseconds"
+   * }) // => "5000 milliseconds"
    * ```
    *
    * @category pattern matching
@@ -1061,15 +1069,14 @@ export const match: {
    *
    * **Example** (Pattern matching on duration representations)
    *
-   * ```ts
+   * ```ts import.meta.vitest
    * import { Duration } from "effect"
    *
-   * const result = Duration.match(Duration.seconds(5), {
+   * Duration.match(Duration.seconds(5), {
    *   onMillis: (millis) => `${millis} milliseconds`,
    *   onNanos: (nanos) => `${nanos} nanoseconds`,
    *   onInfinity: () => "infinite"
-   * })
-   * console.log(result) // "5000 milliseconds"
+   * }) // => "5000 milliseconds"
    * ```
    *
    * @category pattern matching
@@ -1110,15 +1117,14 @@ export const match: {
  *
  * **Example** (Pattern matching on duration pairs)
  *
- * ```ts
+ * ```ts import.meta.vitest
  * import { Duration } from "effect"
  *
- * const sum = Duration.matchPair(Duration.seconds(3), Duration.seconds(2), {
+ * Duration.matchPair(Duration.seconds(3), Duration.seconds(2), {
  *   onMillis: (a, b) => a + b,
  *   onNanos: (a, b) => Number(a + b),
  *   onInfinity: () => Infinity
- * })
- * console.log(sum) // 5000
+ * }) // => 5000
  * ```
  *
  * @category pattern matching
@@ -1130,15 +1136,14 @@ export const matchPair: {
    *
    * **Example** (Pattern matching on duration pairs)
    *
-   * ```ts
+   * ```ts import.meta.vitest
    * import { Duration } from "effect"
    *
-   * const sum = Duration.matchPair(Duration.seconds(3), Duration.seconds(2), {
+   * Duration.matchPair(Duration.seconds(3), Duration.seconds(2), {
    *   onMillis: (a, b) => a + b,
    *   onNanos: (a, b) => Number(a + b),
    *   onInfinity: () => Infinity
-   * })
-   * console.log(sum) // 5000
+   * }) // => 5000
    * ```
    *
    * @category pattern matching
@@ -1157,15 +1162,14 @@ export const matchPair: {
    *
    * **Example** (Pattern matching on duration pairs)
    *
-   * ```ts
+   * ```ts import.meta.vitest
    * import { Duration } from "effect"
    *
-   * const sum = Duration.matchPair(Duration.seconds(3), Duration.seconds(2), {
+   * Duration.matchPair(Duration.seconds(3), Duration.seconds(2), {
    *   onMillis: (a, b) => a + b,
    *   onNanos: (a, b) => Number(a + b),
    *   onInfinity: () => Infinity
-   * })
-   * console.log(sum) // 5000
+   * }) // => 5000
    * ```
    *
    * @category pattern matching
@@ -1211,7 +1215,7 @@ export const matchPair: {
  *
  * **Example** (Sorting durations)
  *
- * ```ts
+ * ```ts import.meta.vitest
  * import { Duration } from "effect"
  *
  * const durations = [
@@ -1219,8 +1223,7 @@ export const matchPair: {
  *   Duration.seconds(1),
  *   Duration.seconds(2)
  * ]
- * const sorted = durations.sort((a, b) => Duration.Order(a, b))
- * console.log(sorted.map(Duration.toSeconds)) // [1, 2, 3]
+ * durations.sort((a, b) => Duration.Order(a, b)).map(Duration.toSeconds) // => [1, 2, 3]
  * ```
  *
  * @category instances
@@ -1261,14 +1264,13 @@ export const Order: order.Order<Duration> = order.make((self, that) =>
  *
  * **Example** (Checking duration ranges)
  *
- * ```ts
+ * ```ts import.meta.vitest
  * import { Duration } from "effect"
  *
- * const isInRange = Duration.between(Duration.seconds(3), {
+ * Duration.between(Duration.seconds(3), {
  *   minimum: Duration.seconds(2),
  *   maximum: Duration.seconds(5)
- * })
- * console.log(isInRange) // true
+ * }) // => true
  * ```
  *
  * @see {@link clamp} for constraining a duration to a range
@@ -1298,14 +1300,13 @@ export const between: {
    *
    * **Example** (Checking duration ranges)
    *
-   * ```ts
+   * ```ts import.meta.vitest
    * import { Duration } from "effect"
    *
-   * const isInRange = Duration.between(Duration.seconds(3), {
+   * Duration.between(Duration.seconds(3), {
    *   minimum: Duration.seconds(2),
    *   maximum: Duration.seconds(5)
-   * })
-   * console.log(isInRange) // true
+   * }) // => true
    * ```
    *
    * @see {@link clamp} for constraining a duration to a range
@@ -1335,14 +1336,13 @@ export const between: {
    *
    * **Example** (Checking duration ranges)
    *
-   * ```ts
+   * ```ts import.meta.vitest
    * import { Duration } from "effect"
    *
-   * const isInRange = Duration.between(Duration.seconds(3), {
+   * Duration.between(Duration.seconds(3), {
    *   minimum: Duration.seconds(2),
    *   maximum: Duration.seconds(5)
-   * })
-   * console.log(isInRange) // true
+   * }) // => true
    * ```
    *
    * @see {@link clamp} for constraining a duration to a range
@@ -1360,11 +1360,10 @@ export const between: {
  *
  * **Example** (Comparing durations for equivalence)
  *
- * ```ts
+ * ```ts import.meta.vitest
  * import { Duration } from "effect"
  *
- * const isEqual = Duration.Equivalence(Duration.seconds(5), Duration.millis(5000))
- * console.log(isEqual) // true
+ * Duration.Equivalence(Duration.seconds(5), Duration.millis(5000)) // => true
  * ```
  *
  * @category instances
@@ -1382,11 +1381,10 @@ export const Equivalence: Equ.Equivalence<Duration> = (self, that) =>
  *
  * **Example** (Selecting the shorter duration)
  *
- * ```ts
+ * ```ts import.meta.vitest
  * import { Duration } from "effect"
  *
- * const shorter = Duration.min(Duration.seconds(5), Duration.seconds(3))
- * console.log(Duration.toSeconds(shorter)) // 3
+ * Duration.min(Duration.seconds(5), Duration.seconds(3)) // => Duration.seconds(3)
  * ```
  *
  * @category ordering
@@ -1398,11 +1396,10 @@ export const min: {
    *
    * **Example** (Selecting the shorter duration)
    *
-   * ```ts
+   * ```ts import.meta.vitest
    * import { Duration } from "effect"
    *
-   * const shorter = Duration.min(Duration.seconds(5), Duration.seconds(3))
-   * console.log(Duration.toSeconds(shorter)) // 3
+   * Duration.min(Duration.seconds(5), Duration.seconds(3)) // => Duration.seconds(3)
    * ```
    *
    * @category ordering
@@ -1414,11 +1411,10 @@ export const min: {
    *
    * **Example** (Selecting the shorter duration)
    *
-   * ```ts
+   * ```ts import.meta.vitest
    * import { Duration } from "effect"
    *
-   * const shorter = Duration.min(Duration.seconds(5), Duration.seconds(3))
-   * console.log(Duration.toSeconds(shorter)) // 3
+   * Duration.min(Duration.seconds(5), Duration.seconds(3)) // => Duration.seconds(3)
    * ```
    *
    * @category ordering
@@ -1432,11 +1428,10 @@ export const min: {
  *
  * **Example** (Selecting the longer duration)
  *
- * ```ts
+ * ```ts import.meta.vitest
  * import { Duration } from "effect"
  *
- * const longer = Duration.max(Duration.seconds(5), Duration.seconds(3))
- * console.log(Duration.toSeconds(longer)) // 5
+ * Duration.max(Duration.seconds(5), Duration.seconds(3)) // => Duration.seconds(5)
  * ```
  *
  * @category ordering
@@ -1448,11 +1443,10 @@ export const max: {
    *
    * **Example** (Selecting the longer duration)
    *
-   * ```ts
+   * ```ts import.meta.vitest
    * import { Duration } from "effect"
    *
-   * const longer = Duration.max(Duration.seconds(5), Duration.seconds(3))
-   * console.log(Duration.toSeconds(longer)) // 5
+   * Duration.max(Duration.seconds(5), Duration.seconds(3)) // => Duration.seconds(5)
    * ```
    *
    * @category ordering
@@ -1464,11 +1458,10 @@ export const max: {
    *
    * **Example** (Selecting the longer duration)
    *
-   * ```ts
+   * ```ts import.meta.vitest
    * import { Duration } from "effect"
    *
-   * const longer = Duration.max(Duration.seconds(5), Duration.seconds(3))
-   * console.log(Duration.toSeconds(longer)) // 5
+   * Duration.max(Duration.seconds(5), Duration.seconds(3)) // => Duration.seconds(5)
    * ```
    *
    * @category ordering
@@ -1482,14 +1475,13 @@ export const max: {
  *
  * **Example** (Clamping durations to a range)
  *
- * ```ts
+ * ```ts import.meta.vitest
  * import { Duration } from "effect"
  *
- * const clamped = Duration.clamp(Duration.seconds(10), {
+ * Duration.clamp(Duration.seconds(10), {
  *   minimum: Duration.seconds(2),
  *   maximum: Duration.seconds(5)
- * })
- * console.log(Duration.toSeconds(clamped)) // 5
+ * }) // => Duration.seconds(5)
  * ```
  *
  * @category ordering
@@ -1501,14 +1493,13 @@ export const clamp: {
    *
    * **Example** (Clamping durations to a range)
    *
-   * ```ts
+   * ```ts import.meta.vitest
    * import { Duration } from "effect"
    *
-   * const clamped = Duration.clamp(Duration.seconds(10), {
+   * Duration.clamp(Duration.seconds(10), {
    *   minimum: Duration.seconds(2),
    *   maximum: Duration.seconds(5)
-   * })
-   * console.log(Duration.toSeconds(clamped)) // 5
+   * }) // => Duration.seconds(5)
    * ```
    *
    * @category ordering
@@ -1520,14 +1511,13 @@ export const clamp: {
    *
    * **Example** (Clamping durations to a range)
    *
-   * ```ts
+   * ```ts import.meta.vitest
    * import { Duration } from "effect"
    *
-   * const clamped = Duration.clamp(Duration.seconds(10), {
+   * Duration.clamp(Duration.seconds(10), {
    *   minimum: Duration.seconds(2),
    *   maximum: Duration.seconds(5)
-   * })
-   * console.log(Duration.toSeconds(clamped)) // 5
+   * }) // => Duration.seconds(5)
    * ```
    *
    * @category ordering
@@ -1547,13 +1537,11 @@ export const clamp: {
  *
  * **Example** (Safely dividing durations)
  *
- * ```ts
+ * ```ts import.meta.vitest
  * import { Duration, Option } from "effect"
  *
- * const d = Duration.divide(Duration.seconds(10), 2)
- * console.log(Option.map(d, Duration.toSeconds)) // Some(5)
- *
- * Duration.divide(Duration.seconds(10), 0) // None
+ * Duration.divide(Duration.seconds(10), 2) // => Option.some(Duration.seconds(5))
+ * Duration.divide(Duration.seconds(10), 0) // => Option.none()
  * ```
  *
  * @category math
@@ -1571,13 +1559,11 @@ export const divide: {
    *
    * **Example** (Safely dividing durations)
    *
-   * ```ts
+   * ```ts import.meta.vitest
    * import { Duration, Option } from "effect"
    *
-   * const d = Duration.divide(Duration.seconds(10), 2)
-   * console.log(Option.map(d, Duration.toSeconds)) // Some(5)
-   *
-   * Duration.divide(Duration.seconds(10), 0) // None
+   * Duration.divide(Duration.seconds(10), 2) // => Option.some(Duration.seconds(5))
+   * Duration.divide(Duration.seconds(10), 0) // => Option.none()
    * ```
    *
    * @category math
@@ -1595,13 +1581,11 @@ export const divide: {
    *
    * **Example** (Safely dividing durations)
    *
-   * ```ts
+   * ```ts import.meta.vitest
    * import { Duration, Option } from "effect"
    *
-   * const d = Duration.divide(Duration.seconds(10), 2)
-   * console.log(Option.map(d, Duration.toSeconds)) // Some(5)
-   *
-   * Duration.divide(Duration.seconds(10), 0) // None
+   * Duration.divide(Duration.seconds(10), 2) // => Option.some(Duration.seconds(5))
+   * Duration.divide(Duration.seconds(10), 0) // => Option.none()
    * ```
    *
    * @category math
@@ -1647,14 +1631,11 @@ export const divide: {
  *
  * **Example** (Dividing durations unsafely)
  *
- * ```ts
+ * ```ts import.meta.vitest
  * import { Duration } from "effect"
  *
- * const half = Duration.divideUnsafe(Duration.seconds(10), 2)
- * console.log(Duration.toSeconds(half)) // 5
- *
- * const infinite = Duration.divideUnsafe(Duration.seconds(10), 0)
- * console.log(Duration.toMillis(infinite)) // Infinity
+ * Duration.divideUnsafe(Duration.seconds(10), 2) // => Duration.seconds(5)
+ * Duration.divideUnsafe(Duration.seconds(10), 0) // => Duration.infinity
  * ```
  *
  * @category math
@@ -1680,14 +1661,11 @@ export const divideUnsafe: {
    *
    * **Example** (Dividing durations unsafely)
    *
-   * ```ts
+   * ```ts import.meta.vitest
    * import { Duration } from "effect"
    *
-   * const half = Duration.divideUnsafe(Duration.seconds(10), 2)
-   * console.log(Duration.toSeconds(half)) // 5
-   *
-   * const infinite = Duration.divideUnsafe(Duration.seconds(10), 0)
-   * console.log(Duration.toMillis(infinite)) // Infinity
+   * Duration.divideUnsafe(Duration.seconds(10), 2) // => Duration.seconds(5)
+   * Duration.divideUnsafe(Duration.seconds(10), 0) // => Duration.infinity
    * ```
    *
    * @category math
@@ -1713,14 +1691,11 @@ export const divideUnsafe: {
    *
    * **Example** (Dividing durations unsafely)
    *
-   * ```ts
+   * ```ts import.meta.vitest
    * import { Duration } from "effect"
    *
-   * const half = Duration.divideUnsafe(Duration.seconds(10), 2)
-   * console.log(Duration.toSeconds(half)) // 5
-   *
-   * const infinite = Duration.divideUnsafe(Duration.seconds(10), 0)
-   * console.log(Duration.toMillis(infinite)) // Infinity
+   * Duration.divideUnsafe(Duration.seconds(10), 2) // => Duration.seconds(5)
+   * Duration.divideUnsafe(Duration.seconds(10), 0) // => Duration.infinity
    * ```
    *
    * @category math
@@ -1765,11 +1740,10 @@ export const divideUnsafe: {
  *
  * **Example** (Multiplying durations)
  *
- * ```ts
+ * ```ts import.meta.vitest
  * import { Duration } from "effect"
  *
- * const doubled = Duration.times(Duration.seconds(5), 2)
- * console.log(Duration.toSeconds(doubled)) // 10
+ * Duration.times(Duration.seconds(5), 2) // => Duration.seconds(10)
  * ```
  *
  * @category math
@@ -1788,11 +1762,10 @@ export const times: {
    *
    * **Example** (Multiplying durations)
    *
-   * ```ts
+   * ```ts import.meta.vitest
    * import { Duration } from "effect"
    *
-   * const doubled = Duration.times(Duration.seconds(5), 2)
-   * console.log(Duration.toSeconds(doubled)) // 10
+   * Duration.times(Duration.seconds(5), 2) // => Duration.seconds(10)
    * ```
    *
    * @category math
@@ -1811,11 +1784,10 @@ export const times: {
    *
    * **Example** (Multiplying durations)
    *
-   * ```ts
+   * ```ts import.meta.vitest
    * import { Duration } from "effect"
    *
-   * const doubled = Duration.times(Duration.seconds(5), 2)
-   * console.log(Duration.toSeconds(doubled)) // 10
+   * Duration.times(Duration.seconds(5), 2) // => Duration.seconds(10)
    * ```
    *
    * @category math
@@ -1847,11 +1819,10 @@ export const times: {
  *
  * **Example** (Subtracting durations)
  *
- * ```ts
+ * ```ts import.meta.vitest
  * import { Duration } from "effect"
  *
- * const result = Duration.subtract(Duration.seconds(10), Duration.seconds(3))
- * console.log(Duration.toSeconds(result)) // 7
+ * Duration.subtract(Duration.seconds(10), Duration.seconds(3)) // => Duration.seconds(7)
  * ```
  *
  * @category math
@@ -1872,11 +1843,10 @@ export const subtract: {
    *
    * **Example** (Subtracting durations)
    *
-   * ```ts
+   * ```ts import.meta.vitest
    * import { Duration } from "effect"
    *
-   * const result = Duration.subtract(Duration.seconds(10), Duration.seconds(3))
-   * console.log(Duration.toSeconds(result)) // 7
+   * Duration.subtract(Duration.seconds(10), Duration.seconds(3)) // => Duration.seconds(7)
    * ```
    *
    * @category math
@@ -1897,11 +1867,10 @@ export const subtract: {
    *
    * **Example** (Subtracting durations)
    *
-   * ```ts
+   * ```ts import.meta.vitest
    * import { Duration } from "effect"
    *
-   * const result = Duration.subtract(Duration.seconds(10), Duration.seconds(3))
-   * console.log(Duration.toSeconds(result)) // 7
+   * Duration.subtract(Duration.seconds(10), Duration.seconds(3)) // => Duration.seconds(7)
    * ```
    *
    * @category math
@@ -1939,11 +1908,10 @@ export const subtract: {
  *
  * **Example** (Adding durations)
  *
- * ```ts
+ * ```ts import.meta.vitest
  * import { Duration } from "effect"
  *
- * const total = Duration.sum(Duration.seconds(5), Duration.seconds(3))
- * console.log(Duration.toSeconds(total)) // 8
+ * Duration.sum(Duration.seconds(5), Duration.seconds(3)) // => Duration.seconds(8)
  * ```
  *
  * @category math
@@ -1965,11 +1933,10 @@ export const sum: {
    *
    * **Example** (Adding durations)
    *
-   * ```ts
+   * ```ts import.meta.vitest
    * import { Duration } from "effect"
    *
-   * const total = Duration.sum(Duration.seconds(5), Duration.seconds(3))
-   * console.log(Duration.toSeconds(total)) // 8
+   * Duration.sum(Duration.seconds(5), Duration.seconds(3)) // => Duration.seconds(8)
    * ```
    *
    * @category math
@@ -1991,11 +1958,10 @@ export const sum: {
    *
    * **Example** (Adding durations)
    *
-   * ```ts
+   * ```ts import.meta.vitest
    * import { Duration } from "effect"
    *
-   * const total = Duration.sum(Duration.seconds(5), Duration.seconds(3))
-   * console.log(Duration.toSeconds(total)) // 8
+   * Duration.sum(Duration.seconds(5), Duration.seconds(3)) // => Duration.seconds(8)
    * ```
    *
    * @category math
@@ -2026,11 +1992,10 @@ export const sum: {
  *
  * **Example** (Comparing durations with less than)
  *
- * ```ts
+ * ```ts import.meta.vitest
  * import { Duration } from "effect"
  *
- * const isLess = Duration.isLessThan(Duration.seconds(3), Duration.seconds(5))
- * console.log(isLess) // true
+ * Duration.isLessThan(Duration.seconds(3), Duration.seconds(5)) // => true
  * ```
  *
  * @category predicates
@@ -2042,11 +2007,10 @@ export const isLessThan: {
    *
    * **Example** (Comparing durations with less than)
    *
-   * ```ts
+   * ```ts import.meta.vitest
    * import { Duration } from "effect"
    *
-   * const isLess = Duration.isLessThan(Duration.seconds(3), Duration.seconds(5))
-   * console.log(isLess) // true
+   * Duration.isLessThan(Duration.seconds(3), Duration.seconds(5)) // => true
    * ```
    *
    * @category predicates
@@ -2058,11 +2022,10 @@ export const isLessThan: {
    *
    * **Example** (Comparing durations with less than)
    *
-   * ```ts
+   * ```ts import.meta.vitest
    * import { Duration } from "effect"
    *
-   * const isLess = Duration.isLessThan(Duration.seconds(3), Duration.seconds(5))
-   * console.log(isLess) // true
+   * Duration.isLessThan(Duration.seconds(3), Duration.seconds(5)) // => true
    * ```
    *
    * @category predicates
@@ -2076,14 +2039,13 @@ export const isLessThan: {
  *
  * **Example** (Comparing durations with less than or equal)
  *
- * ```ts
+ * ```ts import.meta.vitest
  * import { Duration } from "effect"
  *
- * const isLessOrEqual = Duration.isLessThanOrEqualTo(
+ * Duration.isLessThanOrEqualTo(
  *   Duration.seconds(5),
  *   Duration.seconds(5)
- * )
- * console.log(isLessOrEqual) // true
+ * ) // => true
  * ```
  *
  * @category predicates
@@ -2095,14 +2057,13 @@ export const isLessThanOrEqualTo: {
    *
    * **Example** (Comparing durations with less than or equal)
    *
-   * ```ts
+   * ```ts import.meta.vitest
    * import { Duration } from "effect"
    *
-   * const isLessOrEqual = Duration.isLessThanOrEqualTo(
+   * Duration.isLessThanOrEqualTo(
    *   Duration.seconds(5),
    *   Duration.seconds(5)
-   * )
-   * console.log(isLessOrEqual) // true
+   * ) // => true
    * ```
    *
    * @category predicates
@@ -2114,14 +2075,13 @@ export const isLessThanOrEqualTo: {
    *
    * **Example** (Comparing durations with less than or equal)
    *
-   * ```ts
+   * ```ts import.meta.vitest
    * import { Duration } from "effect"
    *
-   * const isLessOrEqual = Duration.isLessThanOrEqualTo(
+   * Duration.isLessThanOrEqualTo(
    *   Duration.seconds(5),
    *   Duration.seconds(5)
-   * )
-   * console.log(isLessOrEqual) // true
+   * ) // => true
    * ```
    *
    * @category predicates
@@ -2135,11 +2095,10 @@ export const isLessThanOrEqualTo: {
  *
  * **Example** (Comparing durations with greater than)
  *
- * ```ts
+ * ```ts import.meta.vitest
  * import { Duration } from "effect"
  *
- * const isGreater = Duration.isGreaterThan(Duration.seconds(5), Duration.seconds(3))
- * console.log(isGreater) // true
+ * Duration.isGreaterThan(Duration.seconds(5), Duration.seconds(3)) // => true
  * ```
  *
  * @category predicates
@@ -2151,11 +2110,10 @@ export const isGreaterThan: {
    *
    * **Example** (Comparing durations with greater than)
    *
-   * ```ts
+   * ```ts import.meta.vitest
    * import { Duration } from "effect"
    *
-   * const isGreater = Duration.isGreaterThan(Duration.seconds(5), Duration.seconds(3))
-   * console.log(isGreater) // true
+   * Duration.isGreaterThan(Duration.seconds(5), Duration.seconds(3)) // => true
    * ```
    *
    * @category predicates
@@ -2167,11 +2125,10 @@ export const isGreaterThan: {
    *
    * **Example** (Comparing durations with greater than)
    *
-   * ```ts
+   * ```ts import.meta.vitest
    * import { Duration } from "effect"
    *
-   * const isGreater = Duration.isGreaterThan(Duration.seconds(5), Duration.seconds(3))
-   * console.log(isGreater) // true
+   * Duration.isGreaterThan(Duration.seconds(5), Duration.seconds(3)) // => true
    * ```
    *
    * @category predicates
@@ -2185,14 +2142,13 @@ export const isGreaterThan: {
  *
  * **Example** (Comparing durations with greater than or equal)
  *
- * ```ts
+ * ```ts import.meta.vitest
  * import { Duration } from "effect"
  *
- * const isGreaterOrEqual = Duration.isGreaterThanOrEqualTo(
+ * Duration.isGreaterThanOrEqualTo(
  *   Duration.seconds(5),
  *   Duration.seconds(5)
- * )
- * console.log(isGreaterOrEqual) // true
+ * ) // => true
  * ```
  *
  * @category predicates
@@ -2204,14 +2160,13 @@ export const isGreaterThanOrEqualTo: {
    *
    * **Example** (Comparing durations with greater than or equal)
    *
-   * ```ts
+   * ```ts import.meta.vitest
    * import { Duration } from "effect"
    *
-   * const isGreaterOrEqual = Duration.isGreaterThanOrEqualTo(
+   * Duration.isGreaterThanOrEqualTo(
    *   Duration.seconds(5),
    *   Duration.seconds(5)
-   * )
-   * console.log(isGreaterOrEqual) // true
+   * ) // => true
    * ```
    *
    * @category predicates
@@ -2223,14 +2178,13 @@ export const isGreaterThanOrEqualTo: {
    *
    * **Example** (Comparing durations with greater than or equal)
    *
-   * ```ts
+   * ```ts import.meta.vitest
    * import { Duration } from "effect"
    *
-   * const isGreaterOrEqual = Duration.isGreaterThanOrEqualTo(
+   * Duration.isGreaterThanOrEqualTo(
    *   Duration.seconds(5),
    *   Duration.seconds(5)
-   * )
-   * console.log(isGreaterOrEqual) // true
+   * ) // => true
    * ```
    *
    * @category predicates
@@ -2244,11 +2198,10 @@ export const isGreaterThanOrEqualTo: {
  *
  * **Example** (Checking duration equality)
  *
- * ```ts
+ * ```ts import.meta.vitest
  * import { Duration } from "effect"
  *
- * const isEqual = Duration.equals(Duration.seconds(5), Duration.millis(5000))
- * console.log(isEqual) // true
+ * Duration.equals(Duration.seconds(5), Duration.millis(5000)) // => true
  * ```
  *
  * @category predicates
@@ -2260,11 +2213,10 @@ export const equals: {
    *
    * **Example** (Checking duration equality)
    *
-   * ```ts
+   * ```ts import.meta.vitest
    * import { Duration } from "effect"
    *
-   * const isEqual = Duration.equals(Duration.seconds(5), Duration.millis(5000))
-   * console.log(isEqual) // true
+   * Duration.equals(Duration.seconds(5), Duration.millis(5000)) // => true
    * ```
    *
    * @category predicates
@@ -2276,11 +2228,10 @@ export const equals: {
    *
    * **Example** (Checking duration equality)
    *
-   * ```ts
+   * ```ts import.meta.vitest
    * import { Duration } from "effect"
    *
-   * const isEqual = Duration.equals(Duration.seconds(5), Duration.millis(5000))
-   * console.log(isEqual) // true
+   * Duration.equals(Duration.seconds(5), Duration.millis(5000)) // => true
    * ```
    *
    * @category predicates
@@ -2300,7 +2251,7 @@ export const equals: {
  *
  * **Example** (Decomposing durations into parts)
  *
- * ```ts
+ * ```ts import.meta.vitest
  * import { Duration } from "effect"
  *
  * // Create a complex duration by adding multiple parts
@@ -2311,28 +2262,10 @@ export const equals: {
  *   ),
  *   Duration.millis(123)
  * )
- * const components = Duration.parts(duration)
- * console.log(components)
- * // {
- * //   days: 1,
- * //   hours: 2,
- * //   minutes: 30,
- * //   seconds: 45,
- * //   millis: 123,
- * //   nanos: 0
- * // }
+ * Duration.parts(duration) // => ({ days: 1, hours: 2, minutes: 30, seconds: 45, millis: 123, nanos: 0 })
  *
  * const complex = Duration.sum(Duration.hours(25), Duration.minutes(90))
- * const complexParts = Duration.parts(complex)
- * console.log(complexParts)
- * // {
- * //   days: 1,
- * //   hours: 2,
- * //   minutes: 30,
- * //   seconds: 0,
- * //   millis: 0,
- * //   nanos: 0
- * // }
+ * Duration.parts(complex) // => ({ days: 1, hours: 2, minutes: 30, seconds: 0, millis: 0, nanos: 0 })
  * ```
  *
  * @category converting
@@ -2392,11 +2325,11 @@ export const parts = (self: Duration): {
  *
  * **Example** (Formatting durations)
  *
- * ```ts
+ * ```ts import.meta.vitest
  * import { Duration } from "effect"
  *
- * Duration.format(Duration.millis(1000)) // "1s"
- * Duration.format(Duration.millis(1001)) // "1s 1ms"
+ * Duration.format(Duration.millis(1000)) // => "1s"
+ * Duration.format(Duration.millis(1001)) // => "1s 1ms"
  * ```
  *
  * @category converting