effect 4.0.0-beta.73 → 4.0.0-beta.75

package/dist/Schedule.d.ts

@@ -474,7 +474,7 @@ export declare const toStepWithSleep: <Output, Input, Error, Env>(schedule: Sche
  * })
  * ```
  *
- * @category utils
+ * @category delays & timeouts
  * @since 2.0.0
  */
 export declare const addDelay: {
@@ -574,7 +574,7 @@ export declare const addDelay: {
      * })
      * ```
      *
-     * @category utils
+     * @category delays & timeouts
      * @since 2.0.0
      */
     <Output, Error2 = never, Env2 = never>(f: (output: Output) => Effect<Duration.Input, Error2, Env2>): <Input, Error, Env>(self: Schedule<Output, Input, Error, Env>) => Schedule<Output, Input, Error | Error2, Env | Env2>;
@@ -674,7 +674,7 @@ export declare const addDelay: {
      * })
      * ```
      *
-     * @category utils
+     * @category delays & timeouts
      * @since 2.0.0
      */
     <Output, Input, Error, Env, Error2 = never, Env2 = never>(self: Schedule<Output, Input, Error, Env>, f: (output: Output) => Effect<Duration.Input, Error2, Env2>): Schedule<Output, Input, Error | Error2, Env | Env2>;
@@ -940,9 +940,7 @@ export declare const andThenResult: {
  *
  * **When to use**
  *
- * Use when the combined schedule should continue only while both
- * schedules still recur. Use `either` when either schedule should be enough to
- * continue.
+ * Use when the combined schedule should continue only while both schedules still recur.
  *
  * **Example** (Combining time and attempt limits)
  *
@@ -1008,7 +1006,7 @@ export declare const andThenResult: {
  *
  * @see {@link either} for continuing while either schedule still recurs
  *
- * @category utils
+ * @category combining
  * @since 2.0.0
  */
 export declare const both: {
@@ -1019,9 +1017,7 @@ export declare const both: {
      *
      * **When to use**
      *
-     * Use when the combined schedule should continue only while both
-     * schedules still recur. Use `either` when either schedule should be enough to
-     * continue.
+     * Use when the combined schedule should continue only while both schedules still recur.
      *
      * **Example** (Combining time and attempt limits)
      *
@@ -1087,7 +1083,7 @@ export declare const both: {
      *
      * @see {@link either} for continuing while either schedule still recurs
      *
-     * @category utils
+     * @category combining
      * @since 2.0.0
      */
     <Output2, Input2, Error2, Env2, Output>(other: Schedule<Output2, Input2, Error2, Env2>): <Input, Error, Env>(self: Schedule<Output, Input, Error, Env>) => Schedule<[Output, Output2], Input & Input2, Error | Error2, Env | Env2>;
@@ -1098,9 +1094,7 @@ export declare const both: {
      *
      * **When to use**
      *
-     * Use when the combined schedule should continue only while both
-     * schedules still recur. Use `either` when either schedule should be enough to
-     * continue.
+     * Use when the combined schedule should continue only while both schedules still recur.
      *
      * **Example** (Combining time and attempt limits)
      *
@@ -1166,7 +1160,7 @@ export declare const both: {
      *
      * @see {@link either} for continuing while either schedule still recurs
      *
-     * @category utils
+     * @category combining
      * @since 2.0.0
      */
     <Output, Input, Error, Env, Output2, Input2, Error2, Env2>(self: Schedule<Output, Input, Error, Env>, other: Schedule<Output2, Input2, Error2, Env2>): Schedule<[Output, Output2], Input & Input2, Error | Error2, Env | Env2>;
@@ -1176,6 +1170,11 @@ export declare const both: {
  * to recur, using the maximum of the two durations between recurrences and
  * outputting the result of the left schedule (i.e. `self`).
  *
+ * **When to use**
+ *
+ * Use when two schedules must both allow recurrence and only the left schedule's
+ * output is needed.
+ *
  * **Example** (Combining schedules and keeping the left output)
  *
  * ```ts
@@ -1200,7 +1199,7 @@ export declare const both: {
  * })
  * ```
  *
- * @category utils
+ * @category combining
  * @since 2.0.0
  */
 export declare const bothLeft: {
@@ -1209,6 +1208,11 @@ export declare const bothLeft: {
      * to recur, using the maximum of the two durations between recurrences and
      * outputting the result of the left schedule (i.e. `self`).
      *
+     * **When to use**
+     *
+     * Use when two schedules must both allow recurrence and only the left schedule's
+     * output is needed.
+     *
      * **Example** (Combining schedules and keeping the left output)
      *
      * ```ts
@@ -1233,7 +1237,7 @@ export declare const bothLeft: {
      * })
      * ```
      *
-     * @category utils
+     * @category combining
      * @since 2.0.0
      */
     <Output2, Input2, Error2, Env2>(other: Schedule<Output2, Input2, Error2, Env2>): <Output, Input, Error, Env>(self: Schedule<Output, Input, Error, Env>) => Schedule<Output, Input & Input2, Error | Error2, Env | Env2>;
@@ -1242,6 +1246,11 @@ export declare const bothLeft: {
      * to recur, using the maximum of the two durations between recurrences and
      * outputting the result of the left schedule (i.e. `self`).
      *
+     * **When to use**
+     *
+     * Use when two schedules must both allow recurrence and only the left schedule's
+     * output is needed.
+     *
      * **Example** (Combining schedules and keeping the left output)
      *
      * ```ts
@@ -1266,7 +1275,7 @@ export declare const bothLeft: {
      * })
      * ```
      *
-     * @category utils
+     * @category combining
      * @since 2.0.0
      */
     <Output, Input, Error, Env, Output2, Input2, Error2, Env2>(self: Schedule<Output, Input, Error, Env>, other: Schedule<Output2, Input2, Error2, Env2>): Schedule<Output, Input & Input2, Error | Error2, Env | Env2>;
@@ -1276,6 +1285,11 @@ export declare const bothLeft: {
  * to recur, using the maximum of the two durations between recurrences and
  * outputting the result of the right schedule (i.e. `other`).
  *
+ * **When to use**
+ *
+ * Use when two schedules must both allow recurrence and only the right
+ * schedule's output is needed.
+ *
  * **Example** (Combining schedules and keeping the right output)
  *
  * ```ts
@@ -1302,7 +1316,7 @@ export declare const bothLeft: {
  * })
  * ```
  *
- * @category utils
+ * @category combining
  * @since 2.0.0
  */
 export declare const bothRight: {
@@ -1311,6 +1325,11 @@ export declare const bothRight: {
      * to recur, using the maximum of the two durations between recurrences and
      * outputting the result of the right schedule (i.e. `other`).
      *
+     * **When to use**
+     *
+     * Use when two schedules must both allow recurrence and only the right
+     * schedule's output is needed.
+     *
      * **Example** (Combining schedules and keeping the right output)
      *
      * ```ts
@@ -1337,7 +1356,7 @@ export declare const bothRight: {
      * })
      * ```
      *
-     * @category utils
+     * @category combining
      * @since 2.0.0
      */
     <Output2, Input2, Error2, Env2>(other: Schedule<Output2, Input2, Error2, Env2>): <Output, Input, Error, Env>(self: Schedule<Output, Input, Error, Env>) => Schedule<Output, Input & Input2, Error | Error2, Env | Env2>;
@@ -1346,6 +1365,11 @@ export declare const bothRight: {
      * to recur, using the maximum of the two durations between recurrences and
      * outputting the result of the right schedule (i.e. `other`).
      *
+     * **When to use**
+     *
+     * Use when two schedules must both allow recurrence and only the right
+     * schedule's output is needed.
+     *
      * **Example** (Combining schedules and keeping the right output)
      *
      * ```ts
@@ -1372,7 +1396,7 @@ export declare const bothRight: {
      * })
      * ```
      *
-     * @category utils
+     * @category combining
      * @since 2.0.0
      */
     <Output, Input, Error, Env, Output2, Input2, Error2, Env2>(self: Schedule<Output, Input, Error, Env>, other: Schedule<Output2, Input2, Error2, Env2>): Schedule<Output, Input & Input2, Error | Error2, Env | Env2>;
@@ -1383,6 +1407,11 @@ export declare const bothRight: {
  * outputting the result of the combination of both schedule outputs using the
  * specified `combine` function.
  *
+ * **When to use**
+ *
+ * Use when two schedules must both allow recurrence and their outputs should be
+ * combined into a custom value.
+ *
  * **Example** (Combining schedule outputs)
  *
  * ```ts
@@ -1413,7 +1442,7 @@ export declare const bothRight: {
  * })
  * ```
  *
- * @category utils
+ * @category combining
  * @since 2.0.0
  */
 export declare const bothWith: {
@@ -1423,6 +1452,11 @@ export declare const bothWith: {
      * outputting the result of the combination of both schedule outputs using the
      * specified `combine` function.
      *
+     * **When to use**
+     *
+     * Use when two schedules must both allow recurrence and their outputs should be
+     * combined into a custom value.
+     *
      * **Example** (Combining schedule outputs)
      *
      * ```ts
@@ -1453,7 +1487,7 @@ export declare const bothWith: {
      * })
      * ```
      *
-     * @category utils
+     * @category combining
      * @since 2.0.0
      */
     <Output2, Input2, Error2, Env2, Output, Output3>(other: Schedule<Output2, Input2, Error2, Env2>, combine: (selfOutput: Output, otherOutput: Output2) => Output3): <Output, Input, Error, Env>(self: Schedule<Output, Input, Error, Env>) => Schedule<Output3, Input & Input2, Error | Error2, Env | Env2>;
@@ -1463,6 +1497,11 @@ export declare const bothWith: {
      * outputting the result of the combination of both schedule outputs using the
      * specified `combine` function.
      *
+     * **When to use**
+     *
+     * Use when two schedules must both allow recurrence and their outputs should be
+     * combined into a custom value.
+     *
      * **Example** (Combining schedule outputs)
      *
      * ```ts
@@ -1493,7 +1532,7 @@ export declare const bothWith: {
      * })
      * ```
      *
-     * @category utils
+     * @category combining
      * @since 2.0.0
      */
     <Output, Input, Error, Env, Output2, Input2, Error2, Env2, Output3>(self: Schedule<Output, Input, Error, Env>, other: Schedule<Output2, Input2, Error2, Env2>, combine: (selfOutput: Output, otherOutput: Output2) => Output3): Schedule<Output3, Input & Input2, Error | Error2, Env | Env2>;
@@ -1530,7 +1569,7 @@ export declare const bothWith: {
  * })
  * ```
  *
- * @category utils
+ * @category collecting
  * @since 4.0.0
  */
 export declare const collectInputs: <Output, Input, Error, Env>(self: Schedule<Output, Input, Error, Env>) => Schedule<Array<Input>, Input, Error, Env>;
@@ -1564,7 +1603,7 @@ export declare const collectInputs: <Output, Input, Error, Env>(self: Schedule<O
  * })
  * ```
  *
- * @category utils
+ * @category collecting
  * @since 4.0.0
  */
 export declare const collectOutputs: <Output, Input, Error, Env>(self: Schedule<Output, Input, Error, Env>) => Schedule<Array<Output>, Input, Error, Env>;
@@ -1648,7 +1687,7 @@ export declare const collectOutputs: <Output, Input, Error, Env>(self: Schedule<
  * })
  * ```
  *
- * @category utils
+ * @category collecting
  * @since 2.0.0
  */
 export declare const collectWhile: {
@@ -1732,7 +1771,7 @@ export declare const collectWhile: {
      * })
      * ```
      *
-     * @category utils
+     * @category collecting
      * @since 2.0.0
      */
     <Input, Output, Error2 = never, Env2 = never>(predicate: (metadata: Metadata<Output, Input>) => boolean | Effect<boolean, Error2, Env2>): <Error, Env>(self: Schedule<Output, Input, Error, Env>) => Schedule<Array<Output>, Input, Error | Error2, Env | Env2>;
@@ -1816,7 +1855,7 @@ export declare const collectWhile: {
      * })
      * ```
      *
-     * @category utils
+     * @category collecting
      * @since 2.0.0
      */
     <Output, Input, Error, Env, Error2 = never, Env2 = never>(self: Schedule<Output, Input, Error, Env>, predicate: (metadata: Metadata<Output, Input>) => boolean | Effect<boolean, Error2, Env2>): Schedule<Array<Output>, Input, Error | Error2, Env | Env2>;
@@ -2308,8 +2347,7 @@ export declare const delays: <Out, In, E, R>(self: Schedule<Out, In, E, R>) => S
  *
  * **When to use**
  *
- * Use when you need one delayed recurrence. Use `during` to keep
- * recurring until a duration has elapsed.
+ * Use when you need a schedule that recurs once after a fixed delay.
  *
  * **Details**
  *
@@ -2339,8 +2377,7 @@ export declare const duration: (durationInput: Duration.Input) => Schedule<Durat
  *
  * **When to use**
  *
- * Use to bound a repeating or retrying schedule by elapsed time. Use
- * `duration` when you need one delayed recurrence.
+ * Use to bound a repeating or retrying schedule by elapsed time.
  *
  * **Example** (Repeating work during a duration)
  *
@@ -2433,8 +2470,7 @@ export declare const during: (duration: Duration.Input) => Schedule<Duration.Dur
  *
  * **When to use**
  *
- * Use when the combined schedule should continue while at least one
- * schedule still recurs. Use `both` when both schedules must continue.
+ * Use when the combined schedule should continue while at least one schedule still recurs.
  *
  * **Example** (Combining schedules with either semantics)
  *
@@ -2502,7 +2538,7 @@ export declare const during: (duration: Duration.Input) => Schedule<Duration.Dur
  *
  * @see {@link both} for continuing only while both schedules still recur
  *
- * @category utils
+ * @category combining
  * @since 2.0.0
  */
 export declare const either: {
@@ -2513,8 +2549,7 @@ export declare const either: {
      *
      * **When to use**
      *
-     * Use when the combined schedule should continue while at least one
-     * schedule still recurs. Use `both` when both schedules must continue.
+     * Use when the combined schedule should continue while at least one schedule still recurs.
      *
      * **Example** (Combining schedules with either semantics)
      *
@@ -2582,7 +2617,7 @@ export declare const either: {
      *
      * @see {@link both} for continuing only while both schedules still recur
      *
-     * @category utils
+     * @category combining
      * @since 2.0.0
      */
     <Output2, Input2, Error2, Env2>(other: Schedule<Output2, Input2, Error2, Env2>): <Output, Input, Error, Env>(self: Schedule<Output, Input, Error, Env>) => Schedule<[Output, Output2], Input & Input2, Error | Error2, Env | Env2>;
@@ -2593,8 +2628,7 @@ export declare const either: {
      *
      * **When to use**
      *
-     * Use when the combined schedule should continue while at least one
-     * schedule still recurs. Use `both` when both schedules must continue.
+     * Use when the combined schedule should continue while at least one schedule still recurs.
      *
      * **Example** (Combining schedules with either semantics)
      *
@@ -2662,7 +2696,7 @@ export declare const either: {
      *
      * @see {@link both} for continuing only while both schedules still recur
      *
-     * @category utils
+     * @category combining
      * @since 2.0.0
      */
     <Output, Input, Error, Env, Output2, Input2, Error2, Env2>(self: Schedule<Output, Input, Error, Env>, other: Schedule<Output2, Input2, Error2, Env2>): Schedule<[Output, Output2], Input & Input2, Error | Error2, Env | Env2>;
@@ -2672,6 +2706,11 @@ export declare const either: {
  * to recur, using the minimum of the two durations between recurrences and
  * outputting the result of the left schedule (i.e. `self`).
  *
+ * **When to use**
+ *
+ * Use when either schedule may keep recurrence going and only the left
+ * schedule's output is needed.
+ *
  * **Example** (Combining either schedules and keeping the left output)
  *
  * ```ts
@@ -2699,7 +2738,7 @@ export declare const either: {
  * })
  * ```
  *
- * @category utils
+ * @category combining
  * @since 4.0.0
  */
 export declare const eitherLeft: {
@@ -2708,6 +2747,11 @@ export declare const eitherLeft: {
      * to recur, using the minimum of the two durations between recurrences and
      * outputting the result of the left schedule (i.e. `self`).
      *
+     * **When to use**
+     *
+     * Use when either schedule may keep recurrence going and only the left
+     * schedule's output is needed.
+     *
      * **Example** (Combining either schedules and keeping the left output)
      *
      * ```ts
@@ -2735,7 +2779,7 @@ export declare const eitherLeft: {
      * })
      * ```
      *
-     * @category utils
+     * @category combining
      * @since 4.0.0
      */
     <Output2, Input2, Error2, Env2>(other: Schedule<Output2, Input2, Error2, Env2>): <Output, Input, Error, Env>(self: Schedule<Output, Input, Error, Env>) => Schedule<Output, Input & Input2, Error | Error2, Env | Env2>;
@@ -2744,6 +2788,11 @@ export declare const eitherLeft: {
      * to recur, using the minimum of the two durations between recurrences and
      * outputting the result of the left schedule (i.e. `self`).
      *
+     * **When to use**
+     *
+     * Use when either schedule may keep recurrence going and only the left
+     * schedule's output is needed.
+     *
      * **Example** (Combining either schedules and keeping the left output)
      *
      * ```ts
@@ -2771,7 +2820,7 @@ export declare const eitherLeft: {
      * })
      * ```
      *
-     * @category utils
+     * @category combining
      * @since 4.0.0
      */
     <Output, Input, Error, Env, Output2, Input2, Error2, Env2>(self: Schedule<Output, Input, Error, Env>, other: Schedule<Output2, Input2, Error2, Env2>): Schedule<Output, Input & Input2, Error | Error2, Env | Env2>;
@@ -2781,6 +2830,11 @@ export declare const eitherLeft: {
  * to recur, using the minimum of the two durations between recurrences and
  * outputting the result of the right schedule (i.e. `other`).
  *
+ * **When to use**
+ *
+ * Use when either schedule may keep recurrence going and only the right
+ * schedule's output is needed.
+ *
  * **Example** (Combining either schedules and keeping the right output)
  *
  * ```ts
@@ -2808,7 +2862,7 @@ export declare const eitherLeft: {
  * })
  * ```
  *
- * @category utils
+ * @category combining
  * @since 4.0.0
  */
 export declare const eitherRight: {
@@ -2817,6 +2871,11 @@ export declare const eitherRight: {
      * to recur, using the minimum of the two durations between recurrences and
      * outputting the result of the right schedule (i.e. `other`).
      *
+     * **When to use**
+     *
+     * Use when either schedule may keep recurrence going and only the right
+     * schedule's output is needed.
+     *
      * **Example** (Combining either schedules and keeping the right output)
      *
      * ```ts
@@ -2844,7 +2903,7 @@ export declare const eitherRight: {
      * })
      * ```
      *
-     * @category utils
+     * @category combining
      * @since 4.0.0
      */
     <Output2, Input2, Error2, Env2>(other: Schedule<Output2, Input2, Error2, Env2>): <Output, Input, Error, Env>(self: Schedule<Output, Input, Error, Env>) => Schedule<Output2, Input & Input2, Error | Error2, Env | Env2>;
@@ -2853,6 +2912,11 @@ export declare const eitherRight: {
      * to recur, using the minimum of the two durations between recurrences and
      * outputting the result of the right schedule (i.e. `other`).
      *
+     * **When to use**
+     *
+     * Use when either schedule may keep recurrence going and only the right
+     * schedule's output is needed.
+     *
      * **Example** (Combining either schedules and keeping the right output)
      *
      * ```ts
@@ -2880,7 +2944,7 @@ export declare const eitherRight: {
      * })
      * ```
      *
-     * @category utils
+     * @category combining
      * @since 4.0.0
      */
     <Output, Input, Error, Env, Output2, Input2, Error2, Env2>(self: Schedule<Output, Input, Error, Env>, other: Schedule<Output2, Input2, Error2, Env2>): Schedule<Output2, Input & Input2, Error | Error2, Env | Env2>;
@@ -2891,6 +2955,11 @@ export declare const eitherRight: {
  * outputting the result of the combination of both schedule outputs using the
  * specified `combine` function.
  *
+ * **When to use**
+ *
+ * Use when either schedule may keep recurrence going and their outputs should be
+ * combined into a custom value.
+ *
  * **Example** (Combining either schedule outputs)
  *
  * ```ts
@@ -2922,7 +2991,7 @@ export declare const eitherRight: {
  * })
  * ```
  *
- * @category utils
+ * @category combining
  * @since 2.0.0
  */
 export declare const eitherWith: {
@@ -2932,6 +3001,11 @@ export declare const eitherWith: {
      * outputting the result of the combination of both schedule outputs using the
      * specified `combine` function.
      *
+     * **When to use**
+     *
+     * Use when either schedule may keep recurrence going and their outputs should be
+     * combined into a custom value.
+     *
      * **Example** (Combining either schedule outputs)
      *
      * ```ts
@@ -2963,7 +3037,7 @@ export declare const eitherWith: {
      * })
      * ```
      *
-     * @category utils
+     * @category combining
      * @since 2.0.0
      */
     <Output2, Input2, Error2, Env2, Output, Output3>(other: Schedule<Output2, Input2, Error2, Env2>, combine: (selfOutput: Output, otherOutput: Output2) => Output3): <Input, Error, Env>(self: Schedule<Output, Input, Error, Env>) => Schedule<Output3, Input & Input2, Error | Error2, Env | Env2>;
@@ -2973,6 +3047,11 @@ export declare const eitherWith: {
      * outputting the result of the combination of both schedule outputs using the
      * specified `combine` function.
      *
+     * **When to use**
+     *
+     * Use when either schedule may keep recurrence going and their outputs should be
+     * combined into a custom value.
+     *
      * **Example** (Combining either schedule outputs)
      *
      * ```ts
@@ -3004,7 +3083,7 @@ export declare const eitherWith: {
      * })
      * ```
      *
-     * @category utils
+     * @category combining
      * @since 2.0.0
      */
     <Output, Input, Error, Env, Output2, Input2, Error2, Env2, Output3>(self: Schedule<Output, Input, Error, Env>, other: Schedule<Output2, Input2, Error2, Env2>, combine: (selfOutput: Output, otherOutput: Output2) => Output3): Schedule<Output3, Input & Input2, Error | Error2, Env | Env2>;
@@ -3165,8 +3244,7 @@ export declare const fibonacci: (one: Duration.Input) => Schedule<Duration.Durat
  *
  * **When to use**
  *
- * Use when recurrences should stay aligned to a regular cadence. Use
- * `spaced` when each delay should start after the previous action completes.
+ * Use when recurrences should stay aligned to a regular cadence.
  *
  * **Gotchas**
  *
@@ -3452,7 +3530,7 @@ export declare const map: {
  * })
  * ```
  *
- * @category utils
+ * @category delays & timeouts
  * @since 2.0.0
  */
 export declare const modifyDelay: {
@@ -3486,7 +3564,7 @@ export declare const modifyDelay: {
      * })
      * ```
      *
-     * @category utils
+     * @category delays & timeouts
      * @since 2.0.0
      */
     <Output, Error2 = never, Env2 = never>(f: (output: Output, delay: Duration.Duration) => Effect<Duration.Input, Error2, Env2>): <Input, Error, Env>(self: Schedule<Output, Input, Error, Env>) => Schedule<Output, Input, Error | Error2, Env | Env2>;
@@ -3520,7 +3598,7 @@ export declare const modifyDelay: {
      * })
      * ```
      *
-     * @category utils
+     * @category delays & timeouts
      * @since 2.0.0
      */
     <Output, Input, Error, Env, Error2 = never, Env2 = never>(self: Schedule<Output, Input, Error, Env>, f: (output: Output, delay: Duration.Input) => Effect<Duration.Input, Error2, Env2>): Schedule<Output, Input, Error | Error2, Env | Env2>;
@@ -3539,7 +3617,7 @@ export declare const modifyDelay: {
  *
  * @see {@link modifyDelay} for replacing recurrence delays with a custom effectful transformation
  *
- * @category utils
+ * @category delays & timeouts
  * @since 2.0.0
  */
 export declare const jittered: <Output, Input, Error, Env>(self: Schedule<Output, Input, Error, Env>) => Schedule<Output, Input, Error, Env>;
@@ -3569,7 +3647,7 @@ export declare const jittered: <Output, Input, Error, Env>(self: Schedule<Output
  * })
  * ```
  *
- * @category utils
+ * @category mapping
  * @since 2.0.0
  */
 export declare const passthrough: <Output, Input, Error, Env>(self: Schedule<Output, Input, Error, Env>) => Schedule<Input, Input, Error, Env>;
@@ -3579,9 +3657,7 @@ export declare const passthrough: <Output, Input, Error, Env>(self: Schedule<Out
  *
  * **When to use**
  *
- * Use when you need a counter schedule with no additional delay. Use `take`
- * to limit an existing schedule while preserving its output and delay
- * behavior.
+ * Use when you need a counter schedule with no additional delay.
  *
  * **Gotchas**
  *
@@ -3754,7 +3830,7 @@ export declare const recurs: (times: number) => Schedule<number>;
  * })
  * ```
  *
- * @category utils
+ * @category folding
  * @since 2.0.0
  */
 export declare const reduce: {
@@ -3867,7 +3943,7 @@ export declare const reduce: {
      * })
      * ```
      *
-     * @category utils
+     * @category folding
      * @since 2.0.0
      */
     <State, Output, Error2 = never, Env2 = never>(initial: LazyArg<State>, combine: (state: State, output: Output) => State | Effect<State, Error2, Env2>): <Input, Error, Env>(self: Schedule<Output, Input, Error, Env>) => Schedule<State, Input, Error | Error2, Env | Env2>;
@@ -3980,7 +4056,7 @@ export declare const reduce: {
      * })
      * ```
      *
-     * @category utils
+     * @category folding
      * @since 2.0.0
      */
     <Output, Input, Error, Env, State, Error2 = never, Env2 = never>(self: Schedule<Output, Input, Error, Env>, initial: LazyArg<State>, combine: (state: State, output: Output) => State | Effect<State, Error2, Env2>): Schedule<State, Input, Error | Error2, Env | Env2>;
@@ -3991,9 +4067,7 @@ export declare const reduce: {
  *
  * **When to use**
  *
- * Use when each delay should start after the previous action
- * completes. Use `fixed` when recurrences should stay aligned to a regular
- * cadence.
+ * Use when each delay should start after the previous action completes.
  *
  * **Example** (Repeating with fixed spacing)
  *
@@ -4801,9 +4875,7 @@ export declare const tapOutput: {
  *
  * **When to use**
  *
- * Use to limit an existing schedule while preserving its output and
- * delay behavior. Use `recurs` when you only need an immediate counter
- * schedule.
+ * Use to limit an existing schedule while preserving its output and delay behavior.
  *
  * **Gotchas**
  *
@@ -4886,7 +4958,7 @@ export declare const tapOutput: {
  *
  * @see {@link recurs} for creating a count-limited schedule
  *
- * @category utils
+ * @category taking
  * @since 4.0.0
  */
 export declare const take: {
@@ -4897,9 +4969,7 @@ export declare const take: {
      *
      * **When to use**
      *
-     * Use to limit an existing schedule while preserving its output and
-     * delay behavior. Use `recurs` when you only need an immediate counter
-     * schedule.
+     * Use to limit an existing schedule while preserving its output and delay behavior.
      *
      * **Gotchas**
      *
@@ -4982,7 +5052,7 @@ export declare const take: {
      *
      * @see {@link recurs} for creating a count-limited schedule
      *
-     * @category utils
+     * @category taking
      * @since 4.0.0
      */
     (n: number): <Output, Input, Error, Env>(self: Schedule<Output, Input, Error, Env>) => Schedule<Output, Input, Error, Env>;
@@ -4993,9 +5063,7 @@ export declare const take: {
      *
      * **When to use**
      *
-     * Use to limit an existing schedule while preserving its output and
-     * delay behavior. Use `recurs` when you only need an immediate counter
-     * schedule.
+     * Use to limit an existing schedule while preserving its output and delay behavior.
      *
      * **Gotchas**
      *
@@ -5078,7 +5146,7 @@ export declare const take: {
      *
      * @see {@link recurs} for creating a count-limited schedule
      *
-     * @category utils
+     * @category taking
      * @since 4.0.0
      */
     <Output, Input, Error, Env>(self: Schedule<Output, Input, Error, Env>, n: number): Schedule<Output, Input, Error, Env>;
@@ -5202,7 +5270,7 @@ export {
  * @see {@link collectWhile} for collecting outputs while using the same predicate
  * @see {@link take} for stopping after a fixed number of schedule outputs
  *
- * @category utils
+ * @category filtering
  * @since 4.0.0
  */
 while_ as while };
@@ -5301,13 +5369,8 @@ identity_ as identity };
  *
  * **When to use**
  *
- * Use to check an existing schedule input type. Use
- * `setInputType` to adapt a schedule that does not depend on its input values.
- *
- * **Details**
- *
- * This helper is checked at compile time and does not change the schedule's
- * runtime behavior.
+ * Use when you need a generic helper to prove that an existing schedule can
+ * consume a required input type without changing runtime behavior.
  *
  * **Example** (Constraining schedule input types)
  *
@@ -5337,8 +5400,7 @@ export declare const satisfiesInputType: <T>() => <Input extends T, Output = nev
  *
  * **When to use**
  *
- * Use to adapt a schedule that does not depend on its input
- * values. Use `satisfiesInputType` to check an existing schedule input type.
+ * Use to adapt a schedule that does not depend on its input values.
  *
  * **Details**
  *