effect 4.0.0-beta.67 → 4.0.0-beta.69

package/src/Option.ts

@@ -109,7 +109,7 @@ const TypeId = "~effect/data/Option"
  * @see {@link none} for creating a `None`
  * @see {@link match} for pattern matching
  *
- * @category Models
+ * @category models
  * @since 2.0.0
  */
 export type Option<A> = None<A> | Some<A>
@@ -129,7 +129,7 @@ export type Option<A> = None<A> | Some<A>
  * @see {@link isNone} to check if an `Option` is `None`
  * @see {@link none} to construct a `None`
  *
- * @category Models
+ * @category models
  * @since 2.0.0
  */
 export interface None<out A> extends Pipeable, Inspectable {
@@ -175,7 +175,7 @@ export interface OptionIterator<T extends Option<any>> {
  * @see {@link isSome} to check if an `Option` is `Some`
  * @see {@link some} to construct a `Some`
  *
- * @category Models
+ * @category models
  * @since 2.0.0
  */
 export interface Some<out A> extends Pipeable, Inspectable {
@@ -199,7 +199,7 @@ export interface Some<out A> extends Pipeable, Inspectable {
  * type when generic code returns or combines `Option` values. Users normally
  * do not need to reference this interface directly.
  *
- * @category Models
+ * @category models
  * @since 2.0.0
  */
 export interface OptionUnify<A extends { [Unify.typeSymbol]?: any }> {
@@ -239,7 +239,7 @@ export declare namespace Option {
  * This supports type-level unification behavior for `Option`. Users normally
  * do not need to reference this interface directly.
  *
- * @category Models
+ * @category models
  * @since 2.0.0
  */
 export interface OptionUnifyIgnore {}
@@ -282,7 +282,7 @@ export interface OptionTypeLambda extends TypeLambda {
  *
  * @see {@link some} for the opposite operation.
  *
- * @category Constructors
+ * @category constructors
  * @since 2.0.0
  */
 export const none = <A = never>(): Option<A> => option.none
@@ -315,7 +315,7 @@ export const none = <A = never>(): Option<A> => option.none
  *
  * @see {@link none} for the opposite operation.
  *
- * @category Constructors
+ * @category constructors
  * @since 2.0.0
  */
 export const some: <A>(value: A) => Option<A> = option.some
@@ -351,7 +351,7 @@ export const some: <A>(value: A) => Option<A> = option.some
  * @see {@link isNone} to check for `None` specifically
  * @see {@link isSome} to check for `Some` specifically
  *
- * @category Guards
+ * @category guards
  * @since 2.0.0
  */
 export const isOption: (input: unknown) => input is Option<unknown> = option.isOption
@@ -381,7 +381,7 @@ export const isOption: (input: unknown) => input is Option<unknown> = option.isO
  *
  * @see {@link isSome} for the opposite check.
  *
- * @category Guards
+ * @category guards
  * @since 2.0.0
  */
 export const isNone: <A>(self: Option<A>) => self is None<A> = option.isNone
@@ -411,7 +411,7 @@ export const isNone: <A>(self: Option<A>) => self is None<A> = option.isNone
  *
  * @see {@link isNone} for the opposite check.
  *
- * @category Guards
+ * @category guards
  * @since 2.0.0
  */
 export const isSome: <A>(self: Option<A>) => self is Some<A> = option.isSome
@@ -574,7 +574,7 @@ export const match: {
  *
  * @see {@link liftPredicate} for the reverse direction
  *
- * @category Conversions
+ * @category converting
  * @since 2.0.0
  */
 export const toRefinement = <A, B extends A>(f: (a: A) => Option<B>): (a: A) => a is B => (a: A): a is B => isSome(f(a))
@@ -607,7 +607,7 @@ export const toRefinement = <A, B extends A>(f: (a: A) => Option<B>): (a: A) =>
  *
  * @see {@link toArray} for the inverse direction
  *
- * @category Constructors
+ * @category constructors
  * @since 2.0.0
  */
 export const fromIterable = <A>(collection: Iterable<A>): Option<A> => {
@@ -643,8 +643,8 @@ export const fromIterable = <A>(collection: Iterable<A>): Option<A> => {
  *
  * @see {@link getFailure} for the opposite operation.
  *
- * @category Conversions
- * @since 2.0.0
+ * @category converting
+ * @since 4.0.0
  */
 export const getSuccess: <A, E>(self: Result<A, E>) => Option<A> = result.getSuccess
 
@@ -674,8 +674,8 @@ export const getSuccess: <A, E>(self: Result<A, E>) => Option<A> = result.getSuc
  *
  * @see {@link getSuccess} for the opposite operation.
  *
- * @category Conversions
- * @since 2.0.0
+ * @category converting
+ * @since 4.0.0
  */
 export const getFailure: <A, E>(self: Result<A, E>) => Option<E> = result.getFailure
 
@@ -709,7 +709,7 @@ export const getFailure: <A, E>(self: Result<A, E>) => Option<E> = result.getFai
  * @see {@link getOrUndefined} to fall back to `undefined`
  * @see {@link getOrThrow} to throw on `None`
  *
- * @category Getters
+ * @category getters
  * @since 2.0.0
  */
 export const getOrElse: {
@@ -743,7 +743,7 @@ export const getOrElse: {
    * @see {@link getOrUndefined} to fall back to `undefined`
    * @see {@link getOrThrow} to throw on `None`
    *
-   * @category Getters
+   * @category getters
    * @since 2.0.0
    */
   <B>(onNone: LazyArg<B>): <A>(self: Option<A>) => B | A
@@ -777,7 +777,7 @@ export const getOrElse: {
    * @see {@link getOrUndefined} to fall back to `undefined`
    * @see {@link getOrThrow} to throw on `None`
    *
-   * @category Getters
+   * @category getters
    * @since 2.0.0
    */
   <A, B>(self: Option<A>, onNone: LazyArg<B>): A | B
@@ -815,7 +815,7 @@ export const getOrElse: {
  * @see {@link orElseSome} to wrap the fallback value in `Some` automatically
  * @see {@link firstSomeOf} to pick the first `Some` from a collection
  *
- * @category Error handling
+ * @category error handling
  * @since 2.0.0
  */
 export const orElse: {
@@ -848,7 +848,7 @@ export const orElse: {
    * @see {@link orElseSome} to wrap the fallback value in `Some` automatically
    * @see {@link firstSomeOf} to pick the first `Some` from a collection
    *
-   * @category Error handling
+   * @category error handling
    * @since 2.0.0
    */
   <B>(that: LazyArg<Option<B>>): <A>(self: Option<A>) => Option<B | A>
@@ -881,7 +881,7 @@ export const orElse: {
    * @see {@link orElseSome} to wrap the fallback value in `Some` automatically
    * @see {@link firstSomeOf} to pick the first `Some` from a collection
    *
-   * @category Error handling
+   * @category error handling
    * @since 2.0.0
    */
   <A, B>(self: Option<A>, that: LazyArg<Option<B>>): Option<A | B>
@@ -917,7 +917,7 @@ export const orElse: {
  *
  * @see {@link orElse} when the fallback is itself an `Option`
  *
- * @category Error handling
+ * @category error handling
  * @since 2.0.0
  */
 export const orElseSome: {
@@ -948,7 +948,7 @@ export const orElseSome: {
    *
    * @see {@link orElse} when the fallback is itself an `Option`
    *
-   * @category Error handling
+   * @category error handling
    * @since 2.0.0
    */
   <B>(onNone: LazyArg<B>): <A>(self: Option<A>) => Option<B | A>
@@ -979,7 +979,7 @@ export const orElseSome: {
    *
    * @see {@link orElse} when the fallback is itself an `Option`
    *
-   * @category Error handling
+   * @category error handling
    * @since 2.0.0
    */
   <A, B>(self: Option<A>, onNone: LazyArg<B>): Option<A | B>
@@ -1016,8 +1016,8 @@ export const orElseSome: {
  *
  * @see {@link orElse} for the simpler variant without source tracking
  *
- * @category Error handling
- * @since 2.0.0
+ * @category error handling
+ * @since 4.0.0
  */
 export const orElseResult: {
   /**
@@ -1048,8 +1048,8 @@ export const orElseResult: {
    *
    * @see {@link orElse} for the simpler variant without source tracking
    *
-   * @category Error handling
-   * @since 2.0.0
+   * @category error handling
+   * @since 4.0.0
    */
   <B>(that: LazyArg<Option<B>>): <A>(self: Option<A>) => Option<Result<B, A>>
   /**
@@ -1080,8 +1080,8 @@ export const orElseResult: {
    *
    * @see {@link orElse} for the simpler variant without source tracking
    *
-   * @category Error handling
-   * @since 2.0.0
+   * @category error handling
+   * @since 4.0.0
    */
   <A, B>(self: Option<A>, that: LazyArg<Option<B>>): Option<Result<B, A>>
 } = dual(
@@ -1118,7 +1118,7 @@ export const orElseResult: {
  *
  * @see {@link orElse} for a two-option fallback
  *
- * @category Error handling
+ * @category error handling
  * @since 2.0.0
  */
 export const firstSomeOf = <T, C extends Iterable<Option<T>> = Iterable<Option<T>>>(
@@ -1165,8 +1165,8 @@ export const firstSomeOf = <T, C extends Iterable<Option<T>> = Iterable<Option<T
  * @see {@link fromUndefinedOr} to only treat `undefined` as absent
  * @see {@link liftNullishOr} to lift a nullable-returning function
  *
- * @category Conversions
- * @since 2.0.0
+ * @category converting
+ * @since 4.0.0
  */
 export const fromNullishOr = <A>(
   a: A
@@ -1203,7 +1203,7 @@ export const fromNullishOr = <A>(
  * @see {@link fromNullishOr} to treat both `null` and `undefined` as absent
  * @see {@link fromNullOr} to only treat `null` as absent
  *
- * @category Conversions
+ * @category converting
  * @since 4.0.0
  */
 export const fromUndefinedOr = <A>(
@@ -1241,7 +1241,7 @@ export const fromUndefinedOr = <A>(
  * @see {@link fromNullishOr} to treat both `null` and `undefined` as absent
  * @see {@link fromUndefinedOr} to only treat `undefined` as absent
  *
- * @category Conversions
+ * @category converting
  * @since 4.0.0
  */
 export const fromNullOr = <A>(
@@ -1283,8 +1283,8 @@ export const fromNullOr = <A>(
  * @see {@link fromNullishOr} for converting a single value
  * @see {@link liftThrowable} for functions that throw instead
  *
- * @category Conversions
- * @since 2.0.0
+ * @category converting
+ * @since 4.0.0
  */
 export const liftNullishOr = <A extends ReadonlyArray<unknown>, B>(
   f: (...a: A) => B
@@ -1318,7 +1318,7 @@ export const liftNullishOr = <A extends ReadonlyArray<unknown>, B>(
  * @see {@link getOrUndefined} to return `undefined` instead
  * @see {@link getOrElse} for a custom fallback
  *
- * @category Getters
+ * @category getters
  * @since 2.0.0
  */
 export const getOrNull: <A>(self: Option<A>) => A | null = getOrElse(constNull)
@@ -1350,7 +1350,7 @@ export const getOrNull: <A>(self: Option<A>) => A | null = getOrElse(constNull)
  * @see {@link getOrNull} to return `null` instead
  * @see {@link getOrElse} for a custom fallback
  *
- * @category Getters
+ * @category getters
  * @since 2.0.0
  */
 export const getOrUndefined: <A>(self: Option<A>) => A | undefined = getOrElse(constUndefined)
@@ -1383,7 +1383,7 @@ export const getOrUndefined: <A>(self: Option<A>) => A | undefined = getOrElse(c
  *
  * @see {@link liftNullishOr} for nullable-returning functions
  *
- * @category Conversions
+ * @category converting
  * @since 2.0.0
  */
 export const liftThrowable = <A extends ReadonlyArray<unknown>, B>(
@@ -1425,7 +1425,7 @@ export const liftThrowable = <A extends ReadonlyArray<unknown>, B>(
  * @see {@link getOrThrow} for a version with a default error
  * @see {@link getOrElse} for a non-throwing alternative
  *
- * @category Conversions
+ * @category converting
  * @since 2.0.0
  */
 export const getOrThrowWith: {
@@ -1457,7 +1457,7 @@ export const getOrThrowWith: {
    * @see {@link getOrThrow} for a version with a default error
    * @see {@link getOrElse} for a non-throwing alternative
    *
-   * @category Conversions
+   * @category converting
    * @since 2.0.0
    */
   (onNone: () => unknown): <A>(self: Option<A>) => A
@@ -1489,7 +1489,7 @@ export const getOrThrowWith: {
    * @see {@link getOrThrow} for a version with a default error
    * @see {@link getOrElse} for a non-throwing alternative
    *
-   * @category Conversions
+   * @category converting
    * @since 2.0.0
    */
   <A>(self: Option<A>, onNone: () => unknown): A
@@ -1527,7 +1527,7 @@ export const getOrThrowWith: {
  * @see {@link getOrThrowWith} for a custom error
  * @see {@link getOrElse} for a non-throwing alternative
  *
- * @category Conversions
+ * @category converting
  * @since 2.0.0
  */
 export const getOrThrow: <A>(self: Option<A>) => A = getOrThrowWith(() => new Error("getOrThrow called on a None"))
@@ -1562,7 +1562,7 @@ export const getOrThrow: <A>(self: Option<A>) => A = getOrThrowWith(() => new Er
  * @see {@link flatMap} when `f` returns an `Option`
  * @see {@link as} to replace the value with a constant
  *
- * @category Mapping
+ * @category mapping
  * @since 2.0.0
  */
 export const map: {
@@ -1596,7 +1596,7 @@ export const map: {
    * @see {@link flatMap} when `f` returns an `Option`
    * @see {@link as} to replace the value with a constant
    *
-   * @category Mapping
+   * @category mapping
    * @since 2.0.0
    */
   <A, B>(f: (a: A) => B): (self: Option<A>) => Option<B>
@@ -1630,7 +1630,7 @@ export const map: {
    * @see {@link flatMap} when `f` returns an `Option`
    * @see {@link as} to replace the value with a constant
    *
-   * @category Mapping
+   * @category mapping
    * @since 2.0.0
    */
   <A, B>(self: Option<A>, f: (a: A) => B): Option<B>
@@ -1666,7 +1666,7 @@ export const map: {
  * @see {@link asVoid} to replace with `undefined`
  * @see {@link map} for a general transformation
  *
- * @category Mapping
+ * @category mapping
  * @since 2.0.0
  */
 export const as: {
@@ -1697,7 +1697,7 @@ export const as: {
    * @see {@link asVoid} to replace with `undefined`
    * @see {@link map} for a general transformation
    *
-   * @category Mapping
+   * @category mapping
    * @since 2.0.0
    */
   <B>(b: B): <X>(self: Option<X>) => Option<B>
@@ -1728,7 +1728,7 @@ export const as: {
    * @see {@link asVoid} to replace with `undefined`
    * @see {@link map} for a general transformation
    *
-   * @category Mapping
+   * @category mapping
    * @since 2.0.0
    */
   <X, B>(self: Option<X>, b: B): Option<B>
@@ -1761,7 +1761,7 @@ export const as: {
  *
  * @see {@link as} to replace with a specific constant
  *
- * @category Mapping
+ * @category mapping
  * @since 2.0.0
  */
 export const asVoid: <_>(self: Option<_>) => Option<void> = as(undefined)
@@ -1786,7 +1786,7 @@ export {
    *
    * @see {@link asVoid} to convert an existing `Option` to `Option<void>`
    *
-   * @category Constructors
+   * @category constructors
    * @since 2.0.0
    */
   void_ as void
@@ -1834,7 +1834,7 @@ export {
  * @see {@link andThen} for a more flexible variant
  * @see {@link flatten} to unwrap a nested `Option<Option<A>>`
  *
- * @category Sequencing
+ * @category sequencing
  * @since 2.0.0
  */
 export const flatMap: {
@@ -1880,7 +1880,7 @@ export const flatMap: {
    * @see {@link andThen} for a more flexible variant
    * @see {@link flatten} to unwrap a nested `Option<Option<A>>`
    *
-   * @category Sequencing
+   * @category sequencing
    * @since 2.0.0
    */
   <A, B>(f: (a: A) => Option<B>): (self: Option<A>) => Option<B>
@@ -1926,7 +1926,7 @@ export const flatMap: {
    * @see {@link andThen} for a more flexible variant
    * @see {@link flatten} to unwrap a nested `Option<Option<A>>`
    *
-   * @category Sequencing
+   * @category sequencing
    * @since 2.0.0
    */
   <A, B>(self: Option<A>, f: (a: A) => Option<B>): Option<B>
@@ -1972,7 +1972,7 @@ export const flatMap: {
  * @see {@link flatMap} for the standard monadic bind
  * @see {@link map} when you always return a plain value
  *
- * @category Sequencing
+ * @category sequencing
  * @since 2.0.0
  */
 export const andThen: {
@@ -2013,7 +2013,7 @@ export const andThen: {
    * @see {@link flatMap} for the standard monadic bind
    * @see {@link map} when you always return a plain value
    *
-   * @category Sequencing
+   * @category sequencing
    * @since 2.0.0
    */
   <A, B>(f: (a: A) => Option<B>): (self: Option<A>) => Option<B>
@@ -2054,7 +2054,7 @@ export const andThen: {
    * @see {@link flatMap} for the standard monadic bind
    * @see {@link map} when you always return a plain value
    *
-   * @category Sequencing
+   * @category sequencing
    * @since 2.0.0
    */
   <B>(f: Option<B>): <A>(self: Option<A>) => Option<B>
@@ -2095,7 +2095,7 @@ export const andThen: {
    * @see {@link flatMap} for the standard monadic bind
    * @see {@link map} when you always return a plain value
    *
-   * @category Sequencing
+   * @category sequencing
    * @since 2.0.0
    */
   <A, B>(f: (a: A) => B): (self: Option<A>) => Option<B>
@@ -2136,7 +2136,7 @@ export const andThen: {
    * @see {@link flatMap} for the standard monadic bind
    * @see {@link map} when you always return a plain value
    *
-   * @category Sequencing
+   * @category sequencing
    * @since 2.0.0
    */
   <B>(f: NotFunction<B>): <A>(self: Option<A>) => Option<B>
@@ -2177,7 +2177,7 @@ export const andThen: {
    * @see {@link flatMap} for the standard monadic bind
    * @see {@link map} when you always return a plain value
    *
-   * @category Sequencing
+   * @category sequencing
    * @since 2.0.0
    */
   <A, B>(self: Option<A>, f: (a: A) => Option<B>): Option<B>
@@ -2218,7 +2218,7 @@ export const andThen: {
    * @see {@link flatMap} for the standard monadic bind
    * @see {@link map} when you always return a plain value
    *
-   * @category Sequencing
+   * @category sequencing
    * @since 2.0.0
    */
   <A, B>(self: Option<A>, f: Option<B>): Option<B>
@@ -2259,7 +2259,7 @@ export const andThen: {
    * @see {@link flatMap} for the standard monadic bind
    * @see {@link map} when you always return a plain value
    *
-   * @category Sequencing
+   * @category sequencing
    * @since 2.0.0
    */
   <A, B>(self: Option<A>, f: (a: A) => B): Option<B>
@@ -2300,7 +2300,7 @@ export const andThen: {
    * @see {@link flatMap} for the standard monadic bind
    * @see {@link map} when you always return a plain value
    *
-   * @category Sequencing
+   * @category sequencing
    * @since 2.0.0
    */
   <A, B>(self: Option<A>, f: NotFunction<B>): Option<B>
@@ -2351,8 +2351,8 @@ export const andThen: {
  * @see {@link flatMap} when the function already returns `Option`
  * @see {@link fromNullishOr} for single-value conversion
  *
- * @category Sequencing
- * @since 2.0.0
+ * @category sequencing
+ * @since 4.0.0
  */
 export const flatMapNullishOr: {
   /**
@@ -2393,8 +2393,8 @@ export const flatMapNullishOr: {
    * @see {@link flatMap} when the function already returns `Option`
    * @see {@link fromNullishOr} for single-value conversion
    *
-   * @category Sequencing
-   * @since 2.0.0
+   * @category sequencing
+   * @since 4.0.0
    */
   <A, B>(f: (a: A) => B): (self: Option<A>) => Option<NonNullable<B>>
   /**
@@ -2435,8 +2435,8 @@ export const flatMapNullishOr: {
    * @see {@link flatMap} when the function already returns `Option`
    * @see {@link fromNullishOr} for single-value conversion
    *
-   * @category Sequencing
-   * @since 2.0.0
+   * @category sequencing
+   * @since 4.0.0
    */
   <A, B>(self: Option<A>, f: (a: A) => B): Option<NonNullable<B>>
 } = dual(
@@ -2472,7 +2472,7 @@ export const flatMapNullishOr: {
  *
  * @see {@link flatMap} which is `map` + `flatten`
  *
- * @category Sequencing
+ * @category sequencing
  * @since 2.0.0
  */
 export const flatten: <A>(self: Option<Option<A>>) => Option<A> = flatMap(identity)
@@ -2504,7 +2504,7 @@ export const flatten: <A>(self: Option<Option<A>>) => Option<A> = flatMap(identi
  * @see {@link zipLeft} to keep the first value instead
  * @see {@link zipWith} to combine both values
  *
- * @category Zipping
+ * @category zipping
  * @since 2.0.0
  */
 export const zipRight: {
@@ -2535,7 +2535,7 @@ export const zipRight: {
    * @see {@link zipLeft} to keep the first value instead
    * @see {@link zipWith} to combine both values
    *
-   * @category Zipping
+   * @category zipping
    * @since 2.0.0
    */
   <B>(that: Option<B>): <_>(self: Option<_>) => Option<B>
@@ -2566,7 +2566,7 @@ export const zipRight: {
    * @see {@link zipLeft} to keep the first value instead
    * @see {@link zipWith} to combine both values
    *
-   * @category Zipping
+   * @category zipping
    * @since 2.0.0
    */
   <X, B>(self: Option<X>, that: Option<B>): Option<B>
@@ -2599,7 +2599,7 @@ export const zipRight: {
  * @see {@link zipRight} to keep the second value instead
  * @see {@link zipWith} to combine both values
  *
- * @category Zipping
+ * @category zipping
  * @since 2.0.0
  */
 export const zipLeft: {
@@ -2630,7 +2630,7 @@ export const zipLeft: {
    * @see {@link zipRight} to keep the second value instead
    * @see {@link zipWith} to combine both values
    *
-   * @category Zipping
+   * @category zipping
    * @since 2.0.0
    */
   <_>(that: Option<_>): <A>(self: Option<A>) => Option<A>
@@ -2661,7 +2661,7 @@ export const zipLeft: {
    * @see {@link zipRight} to keep the second value instead
    * @see {@link zipWith} to combine both values
    *
-   * @category Zipping
+   * @category zipping
    * @since 2.0.0
    */
   <A, X>(self: Option<A>, that: Option<X>): Option<A>
@@ -2702,7 +2702,7 @@ export const zipLeft: {
  *
  * @see {@link flatMap} for single-step chaining
  *
- * @category Sequencing
+ * @category sequencing
  * @since 2.0.0
  */
 export const composeK: {
@@ -2741,7 +2741,7 @@ export const composeK: {
    *
    * @see {@link flatMap} for single-step chaining
    *
-   * @category Sequencing
+   * @category sequencing
    * @since 2.0.0
    */
   <B, C>(bfc: (b: B) => Option<C>): <A>(afb: (a: A) => Option<B>) => (a: A) => Option<C>
@@ -2780,7 +2780,7 @@ export const composeK: {
    *
    * @see {@link flatMap} for single-step chaining
    *
-   * @category Sequencing
+   * @category sequencing
    * @since 2.0.0
    */
   <A, B, C>(afb: (a: A) => Option<B>, bfc: (b: B) => Option<C>): (a: A) => Option<C>
@@ -2819,7 +2819,7 @@ export const composeK: {
  * @see {@link flatMap} when you want to transform the value
  * @see {@link filter} for predicate-based filtering
  *
- * @category Sequencing
+ * @category sequencing
  * @since 2.0.0
  */
 export const tap: {
@@ -2856,7 +2856,7 @@ export const tap: {
    * @see {@link flatMap} when you want to transform the value
    * @see {@link filter} for predicate-based filtering
    *
-   * @category Sequencing
+   * @category sequencing
    * @since 2.0.0
    */
   <A, X>(f: (a: A) => Option<X>): (self: Option<A>) => Option<A>
@@ -2893,7 +2893,7 @@ export const tap: {
    * @see {@link flatMap} when you want to transform the value
    * @see {@link filter} for predicate-based filtering
    *
-   * @category Sequencing
+   * @category sequencing
    * @since 2.0.0
    */
   <A, X>(self: Option<A>, f: (a: A) => Option<X>): Option<A>
@@ -3092,7 +3092,7 @@ export const all: <const I extends Iterable<Option<any>> | Record<string, Option
  * @see {@link product} to combine into a tuple instead
  * @see {@link lift2} to lift a binary function
  *
- * @category Zipping
+ * @category zipping
  * @since 2.0.0
  */
 export const zipWith: {
@@ -3127,7 +3127,7 @@ export const zipWith: {
    * @see {@link product} to combine into a tuple instead
    * @see {@link lift2} to lift a binary function
    *
-   * @category Zipping
+   * @category zipping
    * @since 2.0.0
    */
   <B, A, C>(that: Option<B>, f: (a: A, b: B) => C): (self: Option<A>) => Option<C>
@@ -3162,7 +3162,7 @@ export const zipWith: {
    * @see {@link product} to combine into a tuple instead
    * @see {@link lift2} to lift a binary function
    *
-   * @category Zipping
+   * @category zipping
    * @since 2.0.0
    */
   <A, B, C>(self: Option<A>, that: Option<B>, f: (a: A, b: B) => C): Option<C>
@@ -3296,7 +3296,7 @@ export const reduceCompact: {
  *
  * @see {@link fromIterable} for the inverse direction
  *
- * @category Conversions
+ * @category converting
  * @since 2.0.0
  */
 export const toArray = <A>(self: Option<A>): Array<A> => isNone(self) ? [] : [self.value]
@@ -3336,7 +3336,7 @@ export const toArray = <A>(self: Option<A>): Array<A> => isNone(self) ? [] : [se
  *
  * @see {@link filter} for simple predicate-based filtering
  *
- * @category Filtering
+ * @category filtering
  * @since 2.0.0
  */
 export const partitionMap: {
@@ -3375,7 +3375,7 @@ export const partitionMap: {
    *
    * @see {@link filter} for simple predicate-based filtering
    *
-   * @category Filtering
+   * @category filtering
    * @since 2.0.0
    */
   <A, B, C>(f: (a: A) => Result<C, B>): (self: Option<A>) => [left: Option<B>, right: Option<C>]
@@ -3414,7 +3414,7 @@ export const partitionMap: {
    *
    * @see {@link filter} for simple predicate-based filtering
    *
-   * @category Filtering
+   * @category filtering
    * @since 2.0.0
    */
   <A, B, C>(self: Option<A>, f: (a: A) => Result<C, B>): [left: Option<B>, right: Option<C>]
@@ -3438,8 +3438,7 @@ export const partitionMap: {
  * **Example** (Filtering and transforming)
  *
  * ```ts
- * import { Option } from "effect"
- * import * as Result from "effect/Result"
+ * import { Option, Result } from "effect"
  *
  * console.log(Option.filterMap(
  *   Option.some(2),
@@ -3450,7 +3449,7 @@ export const partitionMap: {
  *
  * @see {@link filter} for predicate-based filtering
  *
- * @category Filtering
+ * @category filtering
  * @since 2.0.0
  */
 export const filterMap: {
@@ -3463,8 +3462,7 @@ export const filterMap: {
    * **Example** (Filtering and transforming)
    *
    * ```ts
-   * import { Option } from "effect"
-   * import * as Result from "effect/Result"
+   * import { Option, Result } from "effect"
    *
    * console.log(Option.filterMap(
    *   Option.some(2),
@@ -3475,7 +3473,7 @@ export const filterMap: {
    *
    * @see {@link filter} for predicate-based filtering
    *
-   * @category Filtering
+   * @category filtering
    * @since 2.0.0
    */
   <A, B, X>(f: Filter.Filter<A, B, X>): (self: Option<A>) => Option<B>
@@ -3488,8 +3486,7 @@ export const filterMap: {
    * **Example** (Filtering and transforming)
    *
    * ```ts
-   * import { Option } from "effect"
-   * import * as Result from "effect/Result"
+   * import { Option, Result } from "effect"
    *
    * console.log(Option.filterMap(
    *   Option.some(2),
@@ -3500,7 +3497,7 @@ export const filterMap: {
    *
    * @see {@link filter} for predicate-based filtering
    *
-   * @category Filtering
+   * @category filtering
    * @since 2.0.0
    */
   <A, B, X>(self: Option<A>, f: Filter.Filter<A, B, X>): Option<B>
@@ -3549,7 +3546,7 @@ export const filterMap: {
  * @see {@link filterMap} to transform and filter simultaneously
  * @see {@link exists} to test without filtering
  *
- * @category Filtering
+ * @category filtering
  * @since 2.0.0
  */
 export const filter: {
@@ -3590,7 +3587,7 @@ export const filter: {
    * @see {@link filterMap} to transform and filter simultaneously
    * @see {@link exists} to test without filtering
    *
-   * @category Filtering
+   * @category filtering
    * @since 2.0.0
    */
   <A, B extends A>(refinement: Refinement<A, B>): (self: Option<A>) => Option<B>
@@ -3631,7 +3628,7 @@ export const filter: {
    * @see {@link filterMap} to transform and filter simultaneously
    * @see {@link exists} to test without filtering
    *
-   * @category Filtering
+   * @category filtering
    * @since 2.0.0
    */
   <A>(predicate: Predicate<A>): <B extends A>(self: Option<B>) => Option<B>
@@ -3672,7 +3669,7 @@ export const filter: {
    * @see {@link filterMap} to transform and filter simultaneously
    * @see {@link exists} to test without filtering
    *
-   * @category Filtering
+   * @category filtering
    * @since 2.0.0
    */
   <A, B extends A>(self: Option<A>, refinement: Refinement<A, B>): Option<B>
@@ -3713,7 +3710,7 @@ export const filter: {
    * @see {@link filterMap} to transform and filter simultaneously
    * @see {@link exists} to test without filtering
    *
-   * @category Filtering
+   * @category filtering
    * @since 2.0.0
    */
   <A>(self: Option<A>, predicate: Predicate<A>): Option<A>
@@ -3754,7 +3751,7 @@ export const filter: {
  * ```
  *
  * @category Equivalence
- * @since 2.0.0
+ * @since 4.0.0
  */
 export const makeEquivalence = <A>(isEquivalent: Equivalence.Equivalence<A>): Equivalence.Equivalence<Option<A>> =>
   Equivalence.make((x, y) => isNone(x) ? isNone(y) : isNone(y) ? false : isEquivalent(x.value, y.value))
@@ -3775,8 +3772,7 @@ export const makeEquivalence = <A>(isEquivalent: Equivalence.Equivalence<A>): Eq
  * **Example** (Ordering Options)
  *
  * ```ts
- * import { Option } from "effect"
- * import * as N from "effect/Number"
+ * import { Number as N, Option } from "effect"
  *
  * const ord = Option.makeOrder(N.Order)
  *
@@ -3791,7 +3787,7 @@ export const makeEquivalence = <A>(isEquivalent: Equivalence.Equivalence<A>): Eq
  * ```
  *
  * @category Sorting
- * @since 2.0.0
+ * @since 4.0.0
  */
 export const makeOrder = <A>(O: Order<A>): Order<Option<A>> =>
   order.make((self, that) => isSome(self) ? (isSome(that) ? O(self.value, that.value) : 1) : -1)