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

package/dist/Option.d.ts

@@ -100,7 +100,7 @@ declare 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>;
@@ -119,7 +119,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 {
@@ -161,7 +161,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 {
@@ -184,7 +184,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 {
@@ -224,7 +224,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 {
@@ -266,7 +266,7 @@ export interface OptionTypeLambda extends TypeLambda {
  *
  * @see {@link some} for the opposite operation.
  *
- * @category Constructors
+ * @category constructors
  * @since 2.0.0
  */
 export declare const none: <A = never>() => Option<A>;
@@ -298,7 +298,7 @@ export declare const none: <A = never>() => Option<A>;
  *
  * @see {@link none} for the opposite operation.
  *
- * @category Constructors
+ * @category constructors
  * @since 2.0.0
  */
 export declare const some: <A>(value: A) => Option<A>;
@@ -333,7 +333,7 @@ export declare const some: <A>(value: A) => Option<A>;
  * @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 declare const isOption: (input: unknown) => input is Option<unknown>;
@@ -362,7 +362,7 @@ export declare const isOption: (input: unknown) => input is Option<unknown>;
  *
  * @see {@link isSome} for the opposite check.
  *
- * @category Guards
+ * @category guards
  * @since 2.0.0
  */
 export declare const isNone: <A>(self: Option<A>) => self is None<A>;
@@ -391,7 +391,7 @@ export declare const isNone: <A>(self: Option<A>) => self is None<A>;
  *
  * @see {@link isNone} for the opposite check.
  *
- * @category Guards
+ * @category guards
  * @since 2.0.0
  */
 export declare const isSome: <A>(self: Option<A>) => self is Some<A>;
@@ -541,7 +541,7 @@ export declare const match: {
  *
  * @see {@link liftPredicate} for the reverse direction
  *
- * @category Conversions
+ * @category converting
  * @since 2.0.0
  */
 export declare const toRefinement: <A, B extends A>(f: (a: A) => Option<B>) => (a: A) => a is B;
@@ -573,7 +573,7 @@ export declare const toRefinement: <A, B extends A>(f: (a: A) => Option<B>) => (
  *
  * @see {@link toArray} for the inverse direction
  *
- * @category Constructors
+ * @category constructors
  * @since 2.0.0
  */
 export declare const fromIterable: <A>(collection: Iterable<A>) => Option<A>;
@@ -603,8 +603,8 @@ export declare 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 declare const getSuccess: <A, E>(self: Result<A, E>) => Option<A>;
 /**
@@ -633,8 +633,8 @@ export declare const getSuccess: <A, E>(self: Result<A, E>) => Option<A>;
  *
  * @see {@link getSuccess} for the opposite operation.
  *
- * @category Conversions
- * @since 2.0.0
+ * @category converting
+ * @since 4.0.0
  */
 export declare const getFailure: <A, E>(self: Result<A, E>) => Option<E>;
 /**
@@ -667,7 +667,7 @@ export declare const getFailure: <A, E>(self: Result<A, E>) => Option<E>;
  * @see {@link getOrUndefined} to fall back to `undefined`
  * @see {@link getOrThrow} to throw on `None`
  *
- * @category Getters
+ * @category getters
  * @since 2.0.0
  */
 export declare const getOrElse: {
@@ -701,7 +701,7 @@ export declare 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;
@@ -735,7 +735,7 @@ export declare 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;
@@ -769,7 +769,7 @@ export declare 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 declare const orElse: {
@@ -802,7 +802,7 @@ export declare 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>;
@@ -835,7 +835,7 @@ export declare 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>;
@@ -867,7 +867,7 @@ export declare const orElse: {
  *
  * @see {@link orElse} when the fallback is itself an `Option`
  *
- * @category Error handling
+ * @category error handling
  * @since 2.0.0
  */
 export declare const orElseSome: {
@@ -898,7 +898,7 @@ export declare 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>;
@@ -929,7 +929,7 @@ export declare 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>;
@@ -962,8 +962,8 @@ export declare 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 declare const orElseResult: {
     /**
@@ -994,8 +994,8 @@ export declare 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>>;
     /**
@@ -1026,8 +1026,8 @@ export declare 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>>;
 };
@@ -1059,7 +1059,7 @@ export declare const orElseResult: {
  *
  * @see {@link orElse} for a two-option fallback
  *
- * @category Error handling
+ * @category error handling
  * @since 2.0.0
  */
 export declare const firstSomeOf: <T, C extends Iterable<Option<T>> = Iterable<Option<T>>>(collection: C) => [C] extends [Iterable<Option<infer A>>] ? Option<A> : never;
@@ -1095,8 +1095,8 @@ export declare const firstSomeOf: <T, C extends Iterable<Option<T>> = Iterable<O
  * @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 declare const fromNullishOr: <A>(a: A) => Option<NonNullable<A>>;
 /**
@@ -1130,7 +1130,7 @@ export declare const fromNullishOr: <A>(a: A) => Option<NonNullable<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 declare const fromUndefinedOr: <A>(a: A) => Option<Exclude<A, undefined>>;
@@ -1165,7 +1165,7 @@ export declare const fromUndefinedOr: <A>(a: A) => Option<Exclude<A, undefined>>
  * @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 declare const fromNullOr: <A>(a: A) => Option<Exclude<A, null>>;
@@ -1204,8 +1204,8 @@ export declare const fromNullOr: <A>(a: A) => Option<Exclude<A, null>>;
  * @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 declare const liftNullishOr: <A extends ReadonlyArray<unknown>, B>(f: (...a: A) => B) => (...a: A) => Option<NonNullable<B>>;
 /**
@@ -1235,7 +1235,7 @@ export declare const liftNullishOr: <A extends ReadonlyArray<unknown>, B>(f: (..
  * @see {@link getOrUndefined} to return `undefined` instead
  * @see {@link getOrElse} for a custom fallback
  *
- * @category Getters
+ * @category getters
  * @since 2.0.0
  */
 export declare const getOrNull: <A>(self: Option<A>) => A | null;
@@ -1266,7 +1266,7 @@ export declare const getOrNull: <A>(self: Option<A>) => A | null;
  * @see {@link getOrNull} to return `null` instead
  * @see {@link getOrElse} for a custom fallback
  *
- * @category Getters
+ * @category getters
  * @since 2.0.0
  */
 export declare const getOrUndefined: <A>(self: Option<A>) => A | undefined;
@@ -1298,7 +1298,7 @@ export declare const getOrUndefined: <A>(self: Option<A>) => A | undefined;
  *
  * @see {@link liftNullishOr} for nullable-returning functions
  *
- * @category Conversions
+ * @category converting
  * @since 2.0.0
  */
 export declare const liftThrowable: <A extends ReadonlyArray<unknown>, B>(f: (...a: A) => B) => (...a: A) => Option<B>;
@@ -1330,7 +1330,7 @@ export declare const liftThrowable: <A extends ReadonlyArray<unknown>, B>(f: (..
  * @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 declare const getOrThrowWith: {
@@ -1362,7 +1362,7 @@ export declare 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;
@@ -1394,7 +1394,7 @@ export declare 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;
@@ -1426,7 +1426,7 @@ export declare 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 declare const getOrThrow: <A>(self: Option<A>) => A;
@@ -1460,7 +1460,7 @@ export declare const getOrThrow: <A>(self: Option<A>) => A;
  * @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 declare const map: {
@@ -1494,7 +1494,7 @@ export declare 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>;
@@ -1528,7 +1528,7 @@ export declare 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>;
@@ -1560,7 +1560,7 @@ export declare 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 declare const as: {
@@ -1591,7 +1591,7 @@ export declare 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>;
@@ -1622,7 +1622,7 @@ export declare 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>;
@@ -1654,7 +1654,7 @@ export declare const as: {
  *
  * @see {@link as} to replace with a specific constant
  *
- * @category Mapping
+ * @category mapping
  * @since 2.0.0
  */
 export declare const asVoid: <_>(self: Option<_>) => Option<void>;
@@ -1678,7 +1678,7 @@ export {
  *
  * @see {@link asVoid} to convert an existing `Option` to `Option<void>`
  *
- * @category Constructors
+ * @category constructors
  * @since 2.0.0
  */
 void_ as void };
@@ -1724,7 +1724,7 @@ void_ as void };
  * @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 declare const flatMap: {
@@ -1770,7 +1770,7 @@ export declare 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>;
@@ -1816,7 +1816,7 @@ export declare 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>;
@@ -1858,7 +1858,7 @@ export declare 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 declare const andThen: {
@@ -1899,7 +1899,7 @@ export declare 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>;
@@ -1940,7 +1940,7 @@ export declare 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>;
@@ -1981,7 +1981,7 @@ export declare 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>;
@@ -2022,7 +2022,7 @@ export declare 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>;
@@ -2063,7 +2063,7 @@ export declare 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>;
@@ -2104,7 +2104,7 @@ export declare 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>;
@@ -2145,7 +2145,7 @@ export declare 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>;
@@ -2186,7 +2186,7 @@ export declare 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>;
@@ -2229,8 +2229,8 @@ export declare 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 declare const flatMapNullishOr: {
     /**
@@ -2271,8 +2271,8 @@ export declare 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>>;
     /**
@@ -2313,8 +2313,8 @@ export declare 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>>;
 };
@@ -2345,7 +2345,7 @@ export declare const flatMapNullishOr: {
  *
  * @see {@link flatMap} which is `map` + `flatten`
  *
- * @category Sequencing
+ * @category sequencing
  * @since 2.0.0
  */
 export declare const flatten: <A>(self: Option<Option<A>>) => Option<A>;
@@ -2376,7 +2376,7 @@ export declare const flatten: <A>(self: Option<Option<A>>) => Option<A>;
  * @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 declare const zipRight: {
@@ -2407,7 +2407,7 @@ export declare 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>;
@@ -2438,7 +2438,7 @@ export declare 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>;
@@ -2470,7 +2470,7 @@ export declare 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 declare const zipLeft: {
@@ -2501,7 +2501,7 @@ export declare 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>;
@@ -2532,7 +2532,7 @@ export declare 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>;
@@ -2572,7 +2572,7 @@ export declare const zipLeft: {
  *
  * @see {@link flatMap} for single-step chaining
  *
- * @category Sequencing
+ * @category sequencing
  * @since 2.0.0
  */
 export declare const composeK: {
@@ -2611,7 +2611,7 @@ export declare 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>;
@@ -2650,7 +2650,7 @@ export declare 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>;
@@ -2688,7 +2688,7 @@ export declare 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 declare const tap: {
@@ -2725,7 +2725,7 @@ export declare 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>;
@@ -2762,7 +2762,7 @@ export declare 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>;
@@ -2915,7 +2915,7 @@ export declare const all: <const I extends Iterable<Option<any>> | Record<string
  * @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 declare const zipWith: {
@@ -2950,7 +2950,7 @@ export declare 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>;
@@ -2985,7 +2985,7 @@ export declare 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>;
@@ -3102,7 +3102,7 @@ export declare const reduceCompact: {
  *
  * @see {@link fromIterable} for the inverse direction
  *
- * @category Conversions
+ * @category converting
  * @since 2.0.0
  */
 export declare const toArray: <A>(self: Option<A>) => Array<A>;
@@ -3141,7 +3141,7 @@ export declare const toArray: <A>(self: Option<A>) => Array<A>;
  *
  * @see {@link filter} for simple predicate-based filtering
  *
- * @category Filtering
+ * @category filtering
  * @since 2.0.0
  */
 export declare const partitionMap: {
@@ -3180,7 +3180,7 @@ export declare 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>];
@@ -3219,7 +3219,7 @@ export declare 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>];
@@ -3233,8 +3233,7 @@ export declare 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),
@@ -3245,7 +3244,7 @@ export declare const partitionMap: {
  *
  * @see {@link filter} for predicate-based filtering
  *
- * @category Filtering
+ * @category filtering
  * @since 2.0.0
  */
 export declare const filterMap: {
@@ -3258,8 +3257,7 @@ export declare 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),
@@ -3270,7 +3268,7 @@ export declare 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>;
@@ -3283,8 +3281,7 @@ export declare 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),
@@ -3295,7 +3292,7 @@ export declare 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>;
@@ -3337,7 +3334,7 @@ export declare 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 declare const filter: {
@@ -3378,7 +3375,7 @@ export declare 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>;
@@ -3419,7 +3416,7 @@ export declare 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>;
@@ -3460,7 +3457,7 @@ export declare 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>;
@@ -3501,7 +3498,7 @@ export declare 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>;
@@ -3537,7 +3534,7 @@ export declare const filter: {
  * ```
  *
  * @category Equivalence
- * @since 2.0.0
+ * @since 4.0.0
  */
 export declare const makeEquivalence: <A>(isEquivalent: Equivalence.Equivalence<A>) => Equivalence.Equivalence<Option<A>>;
 /**
@@ -3556,8 +3553,7 @@ export declare const makeEquivalence: <A>(isEquivalent: Equivalence.Equivalence<
  * **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)
  *
@@ -3572,7 +3568,7 @@ export declare const makeEquivalence: <A>(isEquivalent: Equivalence.Equivalence<
  * ```
  *
  * @category Sorting
- * @since 2.0.0
+ * @since 4.0.0
  */
 export declare const makeOrder: <A>(O: Order<A>) => Order<Option<A>>;
 /**