effect 4.0.1 → 4.0.3

package/src/Duration.ts

@@ -7,6 +7,7 @@
  * from common input shapes, unit conversions, comparisons, arithmetic,
  * formatting, and reusable reducer or combiner helpers.
  *
+ * @stability stable
  * @since 2.0.0
  */
 import * as Combiner from "./Combiner.ts"
@@ -35,11 +36,12 @@ const bigint1e3 = BigInt(1_000)
 const bigint1e6 = BigInt(1_000_000)
 const bigint1e9 = BigInt(1_000_000_000)
 
-const roundTiesAwayFromZero = (input: number): bigint =>
-  BigInt(input < 0 ? Math.ceil(input - 0.5) : Math.floor(input + 0.5))
+const roundTiesAwayFromZero = (input: number): bigint => BigInt(Math.sign(input) * Math.round(Math.abs(input)))
 
 const roundMillisToNanos = (millis: number): bigint => roundTiesAwayFromZero(millis * 1_000_000)
 
+const fromNanosNumber = (nanos: number): Duration => make(Number.isFinite(nanos) ? roundTiesAwayFromZero(nanos) : nanos)
+
 const parseNanos = (input: string, scale: bigint): bigint => {
   const decimalIndex = input.indexOf(".")
   if (decimalIndex === -1) return BigInt(input) * scale
@@ -50,9 +52,13 @@ const parseNanos = (input: string, scale: bigint): bigint => {
   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
+  return divideTiesAwayFromZero(isNegative ? -scaled : scaled, fractionalScale)
+}
+
+const divideTiesAwayFromZero = (numerator: bigint, denominator: bigint): bigint => {
+  const absolute = numerator < bigint0 ? -numerator : numerator
+  const rounded = absolute / denominator + (absolute % denominator * bigint2 >= denominator ? bigint1 : bigint0)
+  return numerator < bigint0 ? -rounded : rounded
 }
 
 const nanosToHrTime = (nanos: bigint): [seconds: number, nanos: number] => {
@@ -78,6 +84,7 @@ const nanosToHrTime = (nanos: bigint): [seconds: number, nanos: number] => {
  * @see {@link DurationValue} for the tagged representation exposed by the
  * `value` field
  *
+ * @stability stable
  * @category models
  * @since 2.0.0
  */
@@ -104,6 +111,7 @@ export interface Duration extends Equal.Equal, Pipeable, Inspectable.Inspectable
  * representation
  * @see {@link match} for pattern matching without reading `value` directly
  *
+ * @stability stable
  * @category models
  * @since 2.0.0
  */
@@ -123,6 +131,7 @@ export type DurationValue =
  *
  * @see {@link Input} for the full duration input union
  *
+ * @stability stable
  * @category models
  * @since 2.0.0
  */
@@ -166,6 +175,7 @@ export type Unit =
  * @see {@link DurationObject} for object-shaped duration input
  * @see {@link Unit} for supported string units
  *
+ * @stability stable
  * @category models
  * @since 4.0.0
  */
@@ -197,6 +207,7 @@ export type Input =
  * Duration.fromInputUnsafe({ seconds: 1, nanoseconds: 500 }) // => Duration.nanos(1_000_000_500n)
  * ```
  *
+ * @stability stable
  * @category models
  * @since 4.0.0
  */
@@ -236,6 +247,7 @@ const DURATION_REGEXP = /^(-?\d+(?:\.\d+)?)\s+(nanos?|micros?|millis?|seconds?|m
  * Duration.fromInputUnsafe([2, 500_000_000]) // => Duration.nanos(2_500_000_000n)
  * ```
  *
+ * @stability stable
  * @category constructors
  * @since 4.0.0
  */
@@ -300,7 +312,7 @@ export const fromInputUnsafe = (input: Input): Duration => {
         if (input[0] === Infinity || input[1] === Infinity) {
           return infinity
         }
-        return make(roundTiesAwayFromZero(input[0] * 1_000_000_000 + input[1]))
+        return fromNanosNumber(input[0] * 1_000_000_000 + input[1])
       }
       const obj = input as DurationObject
       let millis = 0
@@ -312,9 +324,7 @@ export const fromInputUnsafe = (input: Input): Duration => {
       if (obj.seconds) millis += obj.seconds * 1_000
       if (obj.milliseconds) millis += obj.milliseconds
       if (!obj.microseconds && !obj.nanoseconds) return make(millis)
-      return make(roundTiesAwayFromZero(
-        millis * 1_000_000 + (obj.microseconds ?? 0) * 1_000 + (obj.nanoseconds ?? 0)
-      ))
+      return fromNanosNumber(millis * 1_000_000 + (obj.microseconds ?? 0) * 1_000 + (obj.nanoseconds ?? 0))
     }
   }
   return invalid(input)
@@ -337,6 +347,7 @@ const invalid = (input: unknown): never => {
  * Duration.fromInput("invalid" as any) // => Option.none()
  * ```
  *
+ * @stability stable
  * @category constructors
  * @since 4.0.0
  */
@@ -431,6 +442,7 @@ const make = (input: number | bigint): Duration => {
  * Duration.isDuration(1000) // => false
  * ```
  *
+ * @stability stable
  * @category guards
  * @since 2.0.0
  */
@@ -448,6 +460,7 @@ export const isDuration = (u: unknown): u is Duration => hasProperty(u, TypeId)
  * Duration.isFinite(Duration.infinity) // => false
  * ```
  *
+ * @stability stable
  * @category predicates
  * @since 2.0.0
  */
@@ -466,6 +479,7 @@ export const isFinite = (self: Duration): boolean =>
  * Duration.isZero(Duration.seconds(1)) // => false
  * ```
  *
+ * @stability stable
  * @category predicates
  * @since 3.5.0
  */
@@ -494,6 +508,7 @@ export const isZero = (self: Duration): boolean => {
  * Duration.isNegative(Duration.negativeInfinity) // => true
  * ```
  *
+ * @stability stable
  * @category predicates
  * @since 4.0.0
  */
@@ -523,6 +538,7 @@ export const isNegative = (self: Duration): boolean => {
  * Duration.isPositive(Duration.infinity) // => true
  * ```
  *
+ * @stability stable
  * @category predicates
  * @since 4.0.0
  */
@@ -551,6 +567,7 @@ export const isPositive = (self: Duration): boolean => {
  * Duration.abs(Duration.negativeInfinity) // => Duration.infinity
  * ```
  *
+ * @stability stable
  * @category math
  * @since 4.0.0
  */
@@ -578,6 +595,7 @@ export const abs = (self: Duration): Duration => {
  * Duration.negate(Duration.infinity) // => Duration.negativeInfinity
  * ```
  *
+ * @stability stable
  * @category math
  * @since 4.0.0
  */
@@ -605,6 +623,7 @@ export const negate = (self: Duration): Duration => {
  * Duration.toMillis(Duration.zero) // => 0
  * ```
  *
+ * @stability stable
  * @category constructors
  * @since 2.0.0
  */
@@ -621,6 +640,7 @@ export const zero: Duration = make(0)
  * Duration.toMillis(Duration.infinity) // => Infinity
  * ```
  *
+ * @stability stable
  * @category constructors
  * @since 2.0.0
  */
@@ -637,6 +657,7 @@ export const infinity: Duration = make(Infinity)
  * Duration.toMillis(Duration.negativeInfinity) // => -Infinity
  * ```
  *
+ * @stability stable
  * @category constructors
  * @since 4.0.0
  */
@@ -653,6 +674,7 @@ export const negativeInfinity: Duration = make(-Infinity)
  * Duration.nanos(500_000_000n) // => Duration.nanos(500_000_000n)
  * ```
  *
+ * @stability stable
  * @category constructors
  * @since 2.0.0
  */
@@ -669,6 +691,7 @@ export const nanos = (nanos: bigint): Duration => make(nanos)
  * Duration.micros(500_000n) // => Duration.nanos(500_000_000n)
  * ```
  *
+ * @stability stable
  * @category constructors
  * @since 2.0.0
  */
@@ -685,6 +708,7 @@ export const micros = (micros: bigint): Duration => make(micros * bigint1e3)
  * Duration.toMillis(Duration.millis(1000)) // => 1000
  * ```
  *
+ * @stability stable
  * @category constructors
  * @since 2.0.0
  */
@@ -701,6 +725,7 @@ export const millis = (millis: number): Duration => make(millis)
  * Duration.toMillis(Duration.seconds(30)) // => 30_000
  * ```
  *
+ * @stability stable
  * @category constructors
  * @since 2.0.0
  */
@@ -717,6 +742,7 @@ export const seconds = (seconds: number): Duration => make(seconds * 1000)
  * Duration.toMillis(Duration.minutes(5)) // => 300_000
  * ```
  *
+ * @stability stable
  * @category constructors
  * @since 2.0.0
  */
@@ -733,6 +759,7 @@ export const minutes = (minutes: number): Duration => make(minutes * 60_000)
  * Duration.toMillis(Duration.hours(2)) // => 7_200_000
  * ```
  *
+ * @stability stable
  * @category constructors
  * @since 2.0.0
  */
@@ -749,6 +776,7 @@ export const hours = (hours: number): Duration => make(hours * 3_600_000)
  * Duration.toMillis(Duration.days(1)) // => 86_400_000
  * ```
  *
+ * @stability stable
  * @category constructors
  * @since 2.0.0
  */
@@ -765,6 +793,7 @@ export const days = (days: number): Duration => make(days * 86_400_000)
  * Duration.toMillis(Duration.weeks(1)) // => 604_800_000
  * ```
  *
+ * @stability stable
  * @category constructors
  * @since 2.0.0
  */
@@ -782,6 +811,7 @@ export const weeks = (weeks: number): Duration => make(weeks * 604_800_000)
  * Duration.toMillis(Duration.minutes(2)) // => 120_000
  * ```
  *
+ * @stability stable
  * @category getters
  * @since 2.0.0
  */
@@ -805,6 +835,7 @@ export const toMillis = (self: Input): number =>
  * Duration.toSeconds(Duration.minutes(2)) // => 120
  * ```
  *
+ * @stability stable
  * @category getters
  * @since 2.0.0
  */
@@ -828,6 +859,7 @@ export const toSeconds = (self: Input): number =>
  * Duration.toMinutes(Duration.hours(1)) // => 60
  * ```
  *
+ * @stability stable
  * @category getters
  * @since 3.8.0
  */
@@ -851,6 +883,7 @@ export const toMinutes = (self: Input): number =>
  * Duration.toHours(Duration.days(1)) // => 24
  * ```
  *
+ * @stability stable
  * @category getters
  * @since 3.8.0
  */
@@ -874,6 +907,7 @@ export const toHours = (self: Input): number =>
  * Duration.toDays(Duration.weeks(1)) // => 7
  * ```
  *
+ * @stability stable
  * @category getters
  * @since 3.8.0
  */
@@ -897,6 +931,7 @@ export const toDays = (self: Input): number =>
  * Duration.toWeeks(Duration.days(7)) // => 1
  * ```
  *
+ * @stability stable
  * @category getters
  * @since 3.8.0
  */
@@ -936,6 +971,7 @@ export const toWeeks = (self: Input): number =>
  * // throws Error: "Cannot convert infinite duration to nanos"
  * ```
  *
+ * @stability stable
  * @category getters
  * @since 4.0.0
  */
@@ -968,6 +1004,7 @@ export const toNanosUnsafe = (input: Input): bigint => {
  * Duration.toNanos(Duration.infinity) // => Option.none()
  * ```
  *
+ * @stability stable
  * @category getters
  * @since 2.0.0
  */
@@ -984,6 +1021,7 @@ export const toNanos: (self: Input) => Option.Option<bigint> = Option.liftThrowa
  * Duration.toHrTime(Duration.millis(1500)) // => [1, 500_000_000]
  * ```
  *
+ * @stability stable
  * @category getters
  * @since 2.0.0
  */
@@ -1022,6 +1060,7 @@ export const toHrTime = (input: Input): [seconds: number, nanos: number] => {
  * }) // => "5000 milliseconds"
  * ```
  *
+ * @stability stable
  * @category pattern matching
  * @since 2.0.0
  */
@@ -1047,6 +1086,7 @@ export const match: {
    * }) // => "5000 milliseconds"
    * ```
    *
+   * @stability stable
    * @category pattern matching
    * @since 2.0.0
    */
@@ -1079,6 +1119,7 @@ export const match: {
    * }) // => "5000 milliseconds"
    * ```
    *
+   * @stability stable
    * @category pattern matching
    * @since 2.0.0
    */
@@ -1127,6 +1168,7 @@ export const match: {
  * }) // => 5000
  * ```
  *
+ * @stability stable
  * @category pattern matching
  * @since 4.0.0
  */
@@ -1146,6 +1188,7 @@ export const matchPair: {
    * }) // => 5000
    * ```
    *
+   * @stability stable
    * @category pattern matching
    * @since 4.0.0
    */
@@ -1172,6 +1215,7 @@ export const matchPair: {
    * }) // => 5000
    * ```
    *
+   * @stability stable
    * @category pattern matching
    * @since 4.0.0
    */
@@ -1226,6 +1270,7 @@ export const matchPair: {
  * durations.sort((a, b) => Duration.Order(a, b)).map(Duration.toSeconds) // => [1, 2, 3]
  * ```
  *
+ * @stability stable
  * @category instances
  * @since 2.0.0
  */
@@ -1277,6 +1322,7 @@ export const Order: order.Order<Duration> = order.make((self, that) =>
  * @see {@link isGreaterThanOrEqualTo} for checking only the lower bound
  * @see {@link isLessThanOrEqualTo} for checking only the upper bound
  *
+ * @stability stable
  * @category predicates
  * @since 2.0.0
  */
@@ -1313,6 +1359,7 @@ export const between: {
    * @see {@link isGreaterThanOrEqualTo} for checking only the lower bound
    * @see {@link isLessThanOrEqualTo} for checking only the upper bound
    *
+   * @stability stable
    * @category predicates
    * @since 2.0.0
    */
@@ -1349,6 +1396,7 @@ export const between: {
    * @see {@link isGreaterThanOrEqualTo} for checking only the lower bound
    * @see {@link isLessThanOrEqualTo} for checking only the upper bound
    *
+   * @stability stable
    * @category predicates
    * @since 2.0.0
    */
@@ -1366,6 +1414,7 @@ export const between: {
  * Duration.Equivalence(Duration.seconds(5), Duration.millis(5000)) // => true
  * ```
  *
+ * @stability stable
  * @category instances
  * @since 2.0.0
  */
@@ -1387,6 +1436,7 @@ export const Equivalence: Equ.Equivalence<Duration> = (self, that) =>
  * Duration.min(Duration.seconds(5), Duration.seconds(3)) // => Duration.seconds(3)
  * ```
  *
+ * @stability stable
  * @category ordering
  * @since 2.0.0
  */
@@ -1402,6 +1452,7 @@ export const min: {
    * Duration.min(Duration.seconds(5), Duration.seconds(3)) // => Duration.seconds(3)
    * ```
    *
+   * @stability stable
    * @category ordering
    * @since 2.0.0
    */
@@ -1417,6 +1468,7 @@ export const min: {
    * Duration.min(Duration.seconds(5), Duration.seconds(3)) // => Duration.seconds(3)
    * ```
    *
+   * @stability stable
    * @category ordering
    * @since 2.0.0
    */
@@ -1434,6 +1486,7 @@ export const min: {
  * Duration.max(Duration.seconds(5), Duration.seconds(3)) // => Duration.seconds(5)
  * ```
  *
+ * @stability stable
  * @category ordering
  * @since 2.0.0
  */
@@ -1449,6 +1502,7 @@ export const max: {
    * Duration.max(Duration.seconds(5), Duration.seconds(3)) // => Duration.seconds(5)
    * ```
    *
+   * @stability stable
    * @category ordering
    * @since 2.0.0
    */
@@ -1464,6 +1518,7 @@ export const max: {
    * Duration.max(Duration.seconds(5), Duration.seconds(3)) // => Duration.seconds(5)
    * ```
    *
+   * @stability stable
    * @category ordering
    * @since 2.0.0
    */
@@ -1484,6 +1539,7 @@ export const max: {
  * }) // => Duration.seconds(5)
  * ```
  *
+ * @stability stable
  * @category ordering
  * @since 2.0.0
  */
@@ -1502,6 +1558,7 @@ export const clamp: {
    * }) // => Duration.seconds(5)
    * ```
    *
+   * @stability stable
    * @category ordering
    * @since 2.0.0
    */
@@ -1520,6 +1577,7 @@ export const clamp: {
    * }) // => Duration.seconds(5)
    * ```
    *
+   * @stability stable
    * @category ordering
    * @since 2.0.0
    */
@@ -1544,6 +1602,7 @@ export const clamp: {
  * Duration.divide(Duration.seconds(10), 0) // => Option.none()
  * ```
  *
+ * @stability stable
  * @category math
  * @since 2.4.19
  */
@@ -1566,6 +1625,7 @@ export const divide: {
    * Duration.divide(Duration.seconds(10), 0) // => Option.none()
    * ```
    *
+   * @stability stable
    * @category math
    * @since 2.4.19
    */
@@ -1588,6 +1648,7 @@ export const divide: {
    * Duration.divide(Duration.seconds(10), 0) // => Option.none()
    * ```
    *
+   * @stability stable
    * @category math
    * @since 2.4.19
    */
@@ -1638,6 +1699,7 @@ export const divide: {
  * Duration.divideUnsafe(Duration.seconds(10), 0) // => Duration.infinity
  * ```
  *
+ * @stability stable
  * @category math
  * @since 4.0.0
  */
@@ -1668,6 +1730,7 @@ export const divideUnsafe: {
    * Duration.divideUnsafe(Duration.seconds(10), 0) // => Duration.infinity
    * ```
    *
+   * @stability stable
    * @category math
    * @since 4.0.0
    */
@@ -1698,6 +1761,7 @@ export const divideUnsafe: {
    * Duration.divideUnsafe(Duration.seconds(10), 0) // => Duration.infinity
    * ```
    *
+   * @stability stable
    * @category math
    * @since 4.0.0
    */
@@ -1733,8 +1797,8 @@ export const divideUnsafe: {
  *
  * **Details**
  *
- * For nanosecond-backed durations, the multiplier must be convertible to a
- * `bigint`; fractional or non-finite multipliers can throw. Infinite
+ * Fractional multipliers on nanosecond-backed durations round the result to
+ * the nearest nanosecond, with ties rounding away from zero. Infinite
  * durations return positive infinity, negative infinity, or zero depending on
  * the multiplier sign.
  *
@@ -1746,6 +1810,7 @@ export const divideUnsafe: {
  * Duration.times(Duration.seconds(5), 2) // => Duration.seconds(10)
  * ```
  *
+ * @stability stable
  * @category math
  * @since 2.0.0
  */
@@ -1755,8 +1820,8 @@ export const times: {
    *
    * **Details**
    *
-   * For nanosecond-backed durations, the multiplier must be convertible to a
-   * `bigint`; fractional or non-finite multipliers can throw. Infinite
+   * Fractional multipliers on nanosecond-backed durations round the result to
+   * the nearest nanosecond, with ties rounding away from zero. Infinite
    * durations return positive infinity, negative infinity, or zero depending on
    * the multiplier sign.
    *
@@ -1768,6 +1833,7 @@ export const times: {
    * Duration.times(Duration.seconds(5), 2) // => Duration.seconds(10)
    * ```
    *
+   * @stability stable
    * @category math
    * @since 2.0.0
    */
@@ -1777,8 +1843,8 @@ export const times: {
    *
    * **Details**
    *
-   * For nanosecond-backed durations, the multiplier must be convertible to a
-   * `bigint`; fractional or non-finite multipliers can throw. Infinite
+   * Fractional multipliers on nanosecond-backed durations round the result to
+   * the nearest nanosecond, with ties rounding away from zero. Infinite
    * durations return positive infinity, negative infinity, or zero depending on
    * the multiplier sign.
    *
@@ -1790,6 +1856,7 @@ export const times: {
    * Duration.times(Duration.seconds(5), 2) // => Duration.seconds(10)
    * ```
    *
+   * @stability stable
    * @category math
    * @since 2.0.0
    */
@@ -1799,7 +1866,24 @@ export const times: {
   (self: Duration, times: number): Duration =>
     match(self, {
       onMillis: (millis) => make(millis * times),
-      onNanos: (nanos) => make(nanos * BigInt(times)),
+      onNanos: (nanos) => {
+        if (Number.isInteger(times)) return make(nanos * BigInt(times))
+        const nanosNumber = Number(nanos)
+        const scaled = nanosNumber * times
+        if (
+          !Number.isFinite(times) ||
+          (Number.isSafeInteger(nanosNumber) && Math.abs(scaled) <= Number.MAX_SAFE_INTEGER)
+        ) {
+          return fromNanosNumber(scaled)
+        }
+        let numerator = times
+        let denominator = bigint1
+        while (!Number.isInteger(numerator)) {
+          numerator *= 2
+          denominator *= bigint2
+        }
+        return make(divideTiesAwayFromZero(nanos * BigInt(numerator), denominator))
+      },
       onInfinity: () => times > 0 ? infinity : times < 0 ? negativeInfinity : zero,
       onNegativeInfinity: () => times > 0 ? negativeInfinity : times < 0 ? infinity : zero
     })
@@ -1825,6 +1909,7 @@ export const times: {
  * Duration.subtract(Duration.seconds(10), Duration.seconds(3)) // => Duration.seconds(7)
  * ```
  *
+ * @stability stable
  * @category math
  * @since 2.0.0
  */
@@ -1849,6 +1934,7 @@ export const subtract: {
    * Duration.subtract(Duration.seconds(10), Duration.seconds(3)) // => Duration.seconds(7)
    * ```
    *
+   * @stability stable
    * @category math
    * @since 2.0.0
    */
@@ -1873,6 +1959,7 @@ export const subtract: {
    * Duration.subtract(Duration.seconds(10), Duration.seconds(3)) // => Duration.seconds(7)
    * ```
    *
+   * @stability stable
    * @category math
    * @since 2.0.0
    */
@@ -1914,6 +2001,7 @@ export const subtract: {
  * Duration.sum(Duration.seconds(5), Duration.seconds(3)) // => Duration.seconds(8)
  * ```
  *
+ * @stability stable
  * @category math
  * @since 2.0.0
  */
@@ -1939,6 +2027,7 @@ export const sum: {
    * Duration.sum(Duration.seconds(5), Duration.seconds(3)) // => Duration.seconds(8)
    * ```
    *
+   * @stability stable
    * @category math
    * @since 2.0.0
    */
@@ -1964,6 +2053,7 @@ export const sum: {
    * Duration.sum(Duration.seconds(5), Duration.seconds(3)) // => Duration.seconds(8)
    * ```
    *
+   * @stability stable
    * @category math
    * @since 2.0.0
    */
@@ -1998,6 +2088,7 @@ export const sum: {
  * Duration.isLessThan(Duration.seconds(3), Duration.seconds(5)) // => true
  * ```
  *
+ * @stability stable
  * @category predicates
  * @since 4.0.0
  */
@@ -2013,6 +2104,7 @@ export const isLessThan: {
    * Duration.isLessThan(Duration.seconds(3), Duration.seconds(5)) // => true
    * ```
    *
+   * @stability stable
    * @category predicates
    * @since 4.0.0
    */
@@ -2028,6 +2120,7 @@ export const isLessThan: {
    * Duration.isLessThan(Duration.seconds(3), Duration.seconds(5)) // => true
    * ```
    *
+   * @stability stable
    * @category predicates
    * @since 4.0.0
    */
@@ -2048,6 +2141,7 @@ export const isLessThan: {
  * ) // => true
  * ```
  *
+ * @stability stable
  * @category predicates
  * @since 4.0.0
  */
@@ -2066,6 +2160,7 @@ export const isLessThanOrEqualTo: {
    * ) // => true
    * ```
    *
+   * @stability stable
    * @category predicates
    * @since 4.0.0
    */
@@ -2084,6 +2179,7 @@ export const isLessThanOrEqualTo: {
    * ) // => true
    * ```
    *
+   * @stability stable
    * @category predicates
    * @since 4.0.0
    */
@@ -2101,6 +2197,7 @@ export const isLessThanOrEqualTo: {
  * Duration.isGreaterThan(Duration.seconds(5), Duration.seconds(3)) // => true
  * ```
  *
+ * @stability stable
  * @category predicates
  * @since 4.0.0
  */
@@ -2116,6 +2213,7 @@ export const isGreaterThan: {
    * Duration.isGreaterThan(Duration.seconds(5), Duration.seconds(3)) // => true
    * ```
    *
+   * @stability stable
    * @category predicates
    * @since 4.0.0
    */
@@ -2131,6 +2229,7 @@ export const isGreaterThan: {
    * Duration.isGreaterThan(Duration.seconds(5), Duration.seconds(3)) // => true
    * ```
    *
+   * @stability stable
    * @category predicates
    * @since 4.0.0
    */
@@ -2151,6 +2250,7 @@ export const isGreaterThan: {
  * ) // => true
  * ```
  *
+ * @stability stable
  * @category predicates
  * @since 4.0.0
  */
@@ -2169,6 +2269,7 @@ export const isGreaterThanOrEqualTo: {
    * ) // => true
    * ```
    *
+   * @stability stable
    * @category predicates
    * @since 4.0.0
    */
@@ -2187,6 +2288,7 @@ export const isGreaterThanOrEqualTo: {
    * ) // => true
    * ```
    *
+   * @stability stable
    * @category predicates
    * @since 4.0.0
    */
@@ -2204,6 +2306,7 @@ export const isGreaterThanOrEqualTo: {
  * Duration.equals(Duration.seconds(5), Duration.millis(5000)) // => true
  * ```
  *
+ * @stability stable
  * @category predicates
  * @since 2.0.0
  */
@@ -2219,6 +2322,7 @@ export const equals: {
    * Duration.equals(Duration.seconds(5), Duration.millis(5000)) // => true
    * ```
    *
+   * @stability stable
    * @category predicates
    * @since 2.0.0
    */
@@ -2234,6 +2338,7 @@ export const equals: {
    * Duration.equals(Duration.seconds(5), Duration.millis(5000)) // => true
    * ```
    *
+   * @stability stable
    * @category predicates
    * @since 2.0.0
    */
@@ -2268,6 +2373,7 @@ export const equals: {
  * Duration.parts(complex) // => ({ days: 1, hours: 2, minutes: 30, seconds: 0, millis: 0, nanos: 0 })
  * ```
  *
+ * @stability stable
  * @category converting
  * @since 3.8.0
  */
@@ -2332,6 +2438,7 @@ export const parts = (self: Duration): {
  * Duration.format(Duration.millis(1001)) // => "1s 1ms"
  * ```
  *
+ * @stability stable
  * @category converting
  * @since 2.0.0
  */
@@ -2394,6 +2501,7 @@ export const format = (self: Duration): string => {
  * @see {@link CombinerMax} for keeping the longest duration instead of summing
  * @see {@link CombinerMin} for keeping the shortest duration instead of summing
  *
+ * @stability stable
  * @category math
  * @since 4.0.0
  */
@@ -2409,6 +2517,7 @@ export const ReducerSum: Reducer.Reducer<Duration> = Reducer.make(sum, zero)
  * @see {@link CombinerMin} for keeping the shortest `Duration`
  * @see {@link max} for comparing two `Duration` values directly
  *
+ * @stability stable
  * @category math
  * @since 4.0.0
  */
@@ -2424,6 +2533,7 @@ export const CombinerMax: Combiner.Combiner<Duration> = Combiner.max(Order)
  * @see {@link CombinerMax} for keeping the longest `Duration`
  * @see {@link min} for comparing two `Duration` values directly
  *
+ * @stability stable
  * @category math
  * @since 4.0.0
  */