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

package/dist/Duration.js

@@ -22,6 +22,8 @@ import * as Reducer from "./Reducer.js";
 const TypeId = "~effect/time/Duration";
 const bigint0 = /*#__PURE__*/BigInt(0);
 const bigint1 = /*#__PURE__*/BigInt(1);
+const bigint2 = /*#__PURE__*/BigInt(2);
+const bigint10 = /*#__PURE__*/BigInt(10);
 const bigint24 = /*#__PURE__*/BigInt(24);
 const bigint60 = /*#__PURE__*/BigInt(60);
 const bigint1e3 = /*#__PURE__*/BigInt(1_000);
@@ -29,7 +31,16 @@ const bigint1e6 = /*#__PURE__*/BigInt(1_000_000);
 const bigint1e9 = /*#__PURE__*/BigInt(1_000_000_000);
 const roundTiesAwayFromZero = input => BigInt(input < 0 ? Math.ceil(input - 0.5) : Math.floor(input + 0.5));
 const roundMillisToNanos = millis => roundTiesAwayFromZero(millis * 1_000_000);
-const parseNanos = (input, scale) => input.includes(".") ? roundTiesAwayFromZero(Number(input) * Number(scale)) : BigInt(input) * scale;
+const parseNanos = (input, scale) => {
+  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 => {
   const sign = nanos < bigint0 ? -bigint1 : bigint1;
   const absolute = nanos < bigint0 ? -nanos : nanos;
@@ -50,13 +61,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
@@ -151,12 +162,11 @@ const invalid = input => {
  *
  * **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
@@ -176,7 +186,19 @@ const negativeInfinityDurationValue = {
 const DurationProto = {
   [TypeId]: TypeId,
   [Hash.symbol]() {
-    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](that) {
     return isDuration(that) && equals(this, that);
@@ -259,11 +281,11 @@ const make = input => {
  *
  * **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
@@ -275,14 +297,14 @@ export const isDuration = u => 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 => self.value._tag !== "Infinity" && self.value._tag !== "NegativeInfinity";
@@ -291,14 +313,14 @@ export const isFinite = self => self.value._tag !== "Infinity" && self.value._ta
  *
  * **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 => {
@@ -317,15 +339,15 @@ export const isZero = self => {
  *
  * **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 => {
@@ -345,15 +367,15 @@ export const isNegative = self => {
  *
  * **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 => {
@@ -373,11 +395,11 @@ export const isPositive = self => {
  *
  * **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
@@ -399,11 +421,11 @@ export const abs = self => {
  *
  * **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
@@ -426,10 +448,10 @@ export const negate = self => {
  *
  * **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
@@ -441,10 +463,10 @@ export const zero = /*#__PURE__*/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
@@ -456,10 +478,10 @@ export const infinity = /*#__PURE__*/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
@@ -471,11 +493,10 @@ export const negativeInfinity = /*#__PURE__*/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
@@ -487,11 +508,10 @@ export const nanos = nanos => 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
@@ -503,11 +523,10 @@ export const micros = micros => 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
@@ -519,11 +538,10 @@ export const millis = millis => 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
@@ -535,11 +553,10 @@ export const seconds = seconds => 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
@@ -551,11 +568,10 @@ export const minutes = minutes => 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
@@ -567,11 +583,10 @@ export const hours = hours => 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
@@ -583,11 +598,10 @@ export const days = days => 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
@@ -599,11 +613,11 @@ export const weeks = weeks => 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
@@ -620,11 +634,11 @@ export const toMillis = self => match(fromInputUnsafe(self), {
  *
  * **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
@@ -641,11 +655,11 @@ export const toSeconds = self => match(fromInputUnsafe(self), {
  *
  * **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
@@ -662,11 +676,11 @@ export const toMinutes = self => match(fromInputUnsafe(self), {
  *
  * **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
@@ -683,11 +697,11 @@ export const toHours = self => match(fromInputUnsafe(self), {
  *
  * **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
@@ -704,11 +718,11 @@ export const toDays = self => match(fromInputUnsafe(self), {
  *
  * **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
@@ -739,12 +753,10 @@ export const toWeeks = self => match(fromInputUnsafe(self), {
  *
  * **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"
@@ -774,13 +786,11 @@ export const toNanosUnsafe = input => {
  *
  * **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
@@ -792,12 +802,10 @@ export const toNanos = /*#__PURE__*/Option.liftThrowable(toNanosUnsafe);
  *
  * **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
@@ -827,15 +835,14 @@ export const toHrTime = input => {
  *
  * **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
@@ -858,15 +865,14 @@ export const match = /*#__PURE__*/dual(2, (self, options) => {
  *
  * **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
@@ -889,7 +895,7 @@ export const matchPair = /*#__PURE__*/dual(3, (self, that, options) => {
  *
  * **Example** (Sorting durations)
  *
- * ```ts
+ * ```ts import.meta.vitest
  * import { Duration } from "effect"
  *
  * const durations = [
@@ -897,8 +903,7 @@ export const matchPair = /*#__PURE__*/dual(3, (self, that, options) => {
  *   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
@@ -936,14 +941,13 @@ export const Order = /*#__PURE__*/order.make((self, that) => matchPair(self, tha
  *
  * **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
@@ -959,11 +963,10 @@ export const between = /*#__PURE__*/order.isBetween(Order);
  *
  * **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
@@ -979,11 +982,10 @@ export const Equivalence = (self, that) => matchPair(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
@@ -995,11 +997,10 @@ export const min = /*#__PURE__*/order.min(Order);
  *
  * **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
@@ -1011,14 +1012,13 @@ export const max = /*#__PURE__*/order.max(Order);
  *
  * **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
@@ -1036,13 +1036,11 @@ export const clamp = /*#__PURE__*/order.clamp(Order);
  *
  * **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
@@ -1083,14 +1081,11 @@ export const divide = /*#__PURE__*/dual(2, (self, by) => {
  *
  * **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
@@ -1130,11 +1125,10 @@ export const divideUnsafe = /*#__PURE__*/dual(2, (self, by) => {
  *
  * **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
@@ -1160,11 +1154,10 @@ export const times = /*#__PURE__*/dual(2, (self, times) => match(self, {
  *
  * **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
@@ -1196,11 +1189,10 @@ export const subtract = /*#__PURE__*/dual(2, (self, that) => matchPair(self, tha
  *
  * **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
@@ -1225,11 +1217,10 @@ export const sum = /*#__PURE__*/dual(2, (self, that) => matchPair(self, that, {
  *
  * **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
@@ -1241,14 +1232,13 @@ export const isLessThan = /*#__PURE__*/order.isLessThan(Order);
  *
  * **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
@@ -1260,11 +1250,10 @@ export const isLessThanOrEqualTo = /*#__PURE__*/order.isLessThanOrEqualTo(Order)
  *
  * **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
@@ -1276,14 +1265,13 @@ export const isGreaterThan = /*#__PURE__*/order.isGreaterThan(Order);
  *
  * **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
@@ -1295,11 +1283,10 @@ export const isGreaterThanOrEqualTo = /*#__PURE__*/order.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
@@ -1317,7 +1304,7 @@ export const equals = /*#__PURE__*/dual(2, (self, that) => Equivalence(self, tha
  *
  * **Example** (Decomposing durations into parts)
  *
- * ```ts
+ * ```ts import.meta.vitest
  * import { Duration } from "effect"
  *
  * // Create a complex duration by adding multiple parts
@@ -1328,28 +1315,10 @@ export const equals = /*#__PURE__*/dual(2, (self, that) => Equivalence(self, tha
  *   ),
  *   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
@@ -1399,11 +1368,11 @@ export const parts = self => {
  *
  * **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