@shirudo/result 1.0.1 → 1.1.0

package/dist/index.d.cts

@@ -1,7 +1,7 @@
-import { A as recover, B as combine, C as flatMapAsync, D as tryMap, E as collectFirstOk, F as flatMap, H as isResult, I as bimap, L as mapBoth, M as match, N as filter, O as tryCatch, P as tap, R as mapErr, S as tapAsync, T as mapAsync, U as matchTag, V as zip, W as Awaitable, _ as tryFn, a as Ok, b as matchAsync, c as ResultType, d as fromPromise, f as fromThrowable, g as tryAsync, h as okIfLazy, i as Err, j as recoverWith, k as swap, l as err, m as okIf, n as sequence, o as OperatorFunction, p as ok, r as AsyncOperatorFunction, s as Result, t as all, u as fromNullable, v as tryMapAsync, w as mapErrAsync, x as filterAsync, y as tryCatchAsync, z as map } from "./sequence-Br6tAIIu.cjs";
-import { a as collectFirstOkAsync, i as collectFirstOkParallelAsync, n as partition, o as sequenceRecord, r as collectAllErrors, t as flatten } from "./flatten-DK7eJKPx.cjs";
-import { _ as ResultTypeError, a as ERR_MATCH_ERR_HANDLER_NOT_RESULT, b as UnwrapOnErrError, c as ERR_UNWRAP_ERR_ON_OK, d as ExpectOkError, f as InvalidResultStateError, g as ResultErrorCode, h as ResultError, i as ERR_INVALID_STATE, l as ERR_UNWRAP_ON_ERR, m as MatchOnOkError, n as ERR_EXPECT_OK, o as ERR_MATCH_ON_OK, p as MatchErrHandlerNotResultError, r as ERR_INVALID_RESULT_STATE, s as ERR_TASK_YIELD_NOT_RESULT, t as ERR_EXPECT_ERR, u as ExpectErrError, v as TaskYieldNotResultError, y as UnwrapErrOnOkError } from "./errors-BFjY06EV.cjs";
-import { a as and, i as or, n as mapOr, o as foldAsync, r as orElse, s as fold, t as mapOrElse } from "./mapOrElse-DIe7LkYV.cjs";
+import { S as Awaitable, _ as tryFn, a as Ok, b as isResult, c as ResultType, d as fromPromise, f as fromThrowable, g as tryAsync, h as okIfLazy, i as Err, l as err, m as okIf, n as sequence, o as OperatorFunction, p as ok, r as AsyncOperatorFunction, s as Result, t as all, u as fromNullable, v as combine, x as matchTag, y as zip } from "./sequence-DDwePRLd.cjs";
+import { a as collectFirstOkAsync, i as collectFirstOkParallelAsync, n as partition, o as collectFirstOk, r as collectAllErrors, s as sequenceRecord, t as flatten } from "./flatten-D0K8UcQH.cjs";
+import { ERR_EXPECT_ERR, ERR_EXPECT_OK, ERR_INVALID_RESULT_STATE, ERR_INVALID_STATE, ERR_MATCH_ERR_HANDLER_NOT_RESULT, ERR_MATCH_ON_OK, ERR_MATCH_TAG_MISSING_HANDLER, ERR_TASK_YIELD_NOT_RESULT, ERR_UNWRAP_ERR_ON_OK, ERR_UNWRAP_ON_ERR, ExpectErrError, ExpectOkError, InvalidResultStateError, MatchErrHandlerNotResultError, MatchOnOkError, MatchTagMissingHandlerError, ResultError, ResultErrorCode, ResultTypeError, TaskYieldNotResultError, UnwrapErrOnOkError, UnwrapOnErrError } from "./errors.cjs";
+import { C as tap, D as mapErr, E as mapBoth, O as map, S as filter, T as bimap, _ as recoverWith, a as or, b as match, c as tryCatchAsync, d as filterAsync, f as tapAsync, g as recover, h as mapAsync, i as orElse, l as matchAsync, m as mapErrAsync, n as mapOrElse, o as and, p as flatMapAsync, r as mapOr, s as tryMapAsync, t as swap, u as foldAsync, v as tryMap, w as flatMap, x as fold, y as tryCatch } from "./swap-CrHQZIax.cjs";
 
 //#region src/gen.d.ts
 type AnyGenerator<Y = unknown, R = unknown, N = unknown> = Generator<Y, R, N> | AsyncGenerator<Y, R, N>;
@@ -11,118 +11,138 @@ type AwaitedReturn<R> = Awaited<R>;
 type OkOfReturn<R> = AwaitedReturn<R> extends Result<infer T, any> ? T : AwaitedReturn<R>;
 type ErrOfReturn<R> = AwaitedReturn<R> extends Result<any, infer E> ? E : never;
 /**
- * Generator-based do-notation for `Result`.
- *
- * Usage:
- * ```ts
- * const out = await task(async function* () {
- *   const user = yield* await fromPromise(findUser(1));
- *   const email = yield* validate(user.email);
- *   return email;
- * });
- * ```
- */
+* Generator-based do-notation for `Result`.
+*
+* Usage:
+* ```ts
+* const out = await task(async function* () {
+*   const user = yield* await fromPromise(findUser(1));
+*   const email = yield* validate(user.email);
+*   return email;
+* });
+* ```
+*/
 declare function task<const Y, const R>(makeGenerator: () => AnyGenerator<Y, R, unknown>): Promise<Result<OkOfReturn<R>, ErrorOfYield<Y> | ErrOfReturn<R>>>;
 declare function task<const Y, const R, EThrown>(makeGenerator: () => AnyGenerator<Y, R, unknown>, onThrow: OnThrow<EThrown>): Promise<Result<OkOfReturn<R>, ErrorOfYield<Y> | ErrOfReturn<R> | EThrown>>;
 declare const gen: typeof task;
 //#endregion
 //#region src/core/unwrap.d.ts
 /**
- * Returns the value or throws an Error.
- * Corresponds to Rust `unwrap`.
- */
+* Returns the value or throws an Error.
+* Corresponds to Rust `unwrap`.
+*/
 declare function unwrap<T, E>(result: Result<T, E>): T;
 //#endregion
 //#region src/core/unwrapOr.d.ts
 /**
- * Returns the value or a default value.
- * Pure function alternative to the instance method.
- */
+* Returns the value or a default value.
+* Pure function alternative to the instance method.
+*/
 declare function unwrapOr<T, E>(result: Result<T, E>, defaultValue: T): T;
 //#endregion
 //#region src/core/unwrapOrElse.d.ts
 /**
- * Returns the value or calculates a default value using a function.
- * Corresponds to Rust `unwrap_or_else`.
- */
+* Returns the value or calculates a default value using a function.
+* Corresponds to Rust `unwrap_or_else`.
+*/
 declare function unwrapOrElse<T, E>(result: Result<T, E>, fn: (error: E) => T): T;
 //#endregion
 //#region src/core/unwrapOrDefault.d.ts
 /**
- * Alias for `unwrapOr`.
- * Corresponds to Rust `unwrap_or_default` (with explicit default value).
- */
+* Alias for `unwrapOr`.
+*
+* @deprecated Use {@link unwrapOr} instead. The name is misleading: Rust's
+* `unwrap_or_default` takes no argument (it uses the type's `Default`),
+* whereas this function requires an explicit default value — which is exactly
+* what `unwrapOr` does.
+*/
 declare function unwrapOrDefault<T, E>(result: Result<T, E>, defaultValue: T): T;
 //#endregion
 //#region src/core/unwrapOrThrow.d.ts
 /**
- * Returns the value or throws the original Err value (not wrapped).
- * Useful to preserve `Error` instances including stack traces.
- */
+* Returns the value or throws the original Err value (not wrapped).
+* Useful to preserve `Error` instances including stack traces.
+*/
 declare function unwrapOrThrow<T, E>(result: Result<T, E>): T;
 //#endregion
 //#region src/core/unwrapErr.d.ts
 /**
- * Returns the error or throws an Error.
- * Corresponds to Rust `unwrap_err`.
- */
+* Returns the error or throws an Error.
+* Corresponds to Rust `unwrap_err`.
+*/
 declare function unwrapErr<T, E>(result: Result<T, E>): E;
 //#endregion
 //#region src/core/expectResult.d.ts
 /**
- * Returns the value or throws an Error with a custom message.
- * Corresponds to Rust `expect`.
- */
+* Returns the value or throws an Error with a custom message.
+* Corresponds to Rust `expect`.
+*/
 declare function expectResult<T, E>(result: Result<T, E>, message: string): T;
 //#endregion
 //#region src/core/expectErr.d.ts
 /**
- * Returns the error or throws an Error with a custom message.
- * Corresponds to Rust `expect_err`.
- */
+* Returns the error or throws an Error with a custom message.
+* Corresponds to Rust `expect_err`.
+*/
 declare function expectErr<T, E>(result: Result<T, E>, message: string): E;
 //#endregion
+//#region src/core/fromSerialized.d.ts
+/**
+* Rebuilds a `Result` from its serialized discriminated form
+* (`{ _tag: 'Ok', value }` / `{ _tag: 'Err', error }`), the shape produced
+* by `Result.toSerialized()` and by `JSON.stringify` on a Result.
+*
+* Throws `InvalidResultStateError` for data that is not in that shape.
+*/
+declare function fromSerialized<T, E>(data: ResultType<T, E>): Result<T, E>;
+//#endregion
 //#region src/core/toPromise.d.ts
 /**
- * Converts a Result to a Promise.
- * Ok → resolve(value), Err → reject(error)
- */
+* Converts a Result to a Promise.
+* Ok → resolve(value), Err → reject(error)
+*/
 declare function toPromise<T, E>(result: Result<T, E>): Promise<T>;
 //#endregion
 //#region src/core/toNullable.d.ts
 /**
- * Converts a Result to `T | null`.
- * Ok → value, Err → null
- */
+* Converts a Result to `T | null`.
+* Ok → value, Err → null
+*/
 declare function toNullable<T, E>(result: Result<T, E>): T | null;
 //#endregion
 //#region src/core/isOk.d.ts
 /**
- * Checks if a Result is Ok.
- * Pure function alternative to the instance method.
- */
+* Checks if a Result is Ok.
+* Pure function alternative to the instance method.
+*/
 declare function isOk<T, E>(result: Result<T, E>): result is Ok<T, E>;
 //#endregion
 //#region src/core/isErr.d.ts
 /**
- * Checks if a Result is Err.
- * Pure function alternative to the instance method.
- */
+* Checks if a Result is Err.
+* Pure function alternative to the instance method.
+*/
 declare function isErr<T, E>(result: Result<T, E>): result is Err<T, E>;
 //#endregion
 //#region src/core/contains.d.ts
 /**
- * Checks if the Result contains a specific value.
- * Corresponds to Rust `contains`.
- */
+* Checks if the Result contains a specific value.
+* Corresponds to Rust `contains`.
+*
+* Comparison uses `Object.is` (SameValue): `NaN` matches `NaN`, `+0` and
+* `-0` are distinct, and objects are compared by reference.
+*/
 declare function contains<T, E>(result: Result<T, E>, value: T): boolean;
 //#endregion
 //#region src/core/containsErr.d.ts
 /**
- * Checks if the Result contains a specific error.
- * Analogous to `contains` for the Err case.
- */
+* Checks if the Result contains a specific error.
+* Analogous to `contains` for the Err case.
+*
+* Comparison uses `Object.is` (SameValue): `NaN` matches `NaN`, `+0` and
+* `-0` are distinct, and objects are compared by reference.
+*/
 declare function containsErr<T, E>(result: Result<T, E>, error: E): boolean;
 //#endregion
-export { AsyncOperatorFunction, Awaitable, ERR_EXPECT_ERR, ERR_EXPECT_OK, ERR_INVALID_RESULT_STATE, ERR_INVALID_STATE, ERR_MATCH_ERR_HANDLER_NOT_RESULT, ERR_MATCH_ON_OK, ERR_TASK_YIELD_NOT_RESULT, ERR_UNWRAP_ERR_ON_OK, ERR_UNWRAP_ON_ERR, Err, ExpectErrError, ExpectOkError, InvalidResultStateError, MatchErrHandlerNotResultError, MatchOnOkError, Ok, OperatorFunction, Result, ResultError, ResultErrorCode, ResultType, ResultTypeError, TaskYieldNotResultError, UnwrapErrOnOkError, UnwrapOnErrError, all, and, bimap, collectAllErrors, collectFirstOk, collectFirstOkAsync, collectFirstOkParallelAsync, combine, contains, containsErr, err, expectErr, expectResult, filter, filterAsync, flatMap, flatMapAsync, flatten, fold, foldAsync, fromNullable, fromPromise, fromThrowable, gen, isErr, isOk, isResult, map, mapAsync, mapBoth, mapErr, mapErrAsync, mapOr, mapOrElse, match, matchAsync, matchTag, ok, okIf, okIfLazy, or, orElse, partition, recover, recoverWith, sequence, sequenceRecord, swap, tap, tapAsync, task, toNullable, toPromise, tryAsync, tryCatch, tryCatchAsync, tryFn, tryMap, tryMapAsync, unwrap, unwrapErr, unwrapOr, unwrapOrDefault, unwrapOrElse, unwrapOrThrow, zip };
+export { AsyncOperatorFunction, type Awaitable, ERR_EXPECT_ERR, ERR_EXPECT_OK, ERR_INVALID_RESULT_STATE, ERR_INVALID_STATE, ERR_MATCH_ERR_HANDLER_NOT_RESULT, ERR_MATCH_ON_OK, ERR_MATCH_TAG_MISSING_HANDLER, ERR_TASK_YIELD_NOT_RESULT, ERR_UNWRAP_ERR_ON_OK, ERR_UNWRAP_ON_ERR, Err, ExpectErrError, ExpectOkError, InvalidResultStateError, MatchErrHandlerNotResultError, MatchOnOkError, MatchTagMissingHandlerError, Ok, OperatorFunction, Result, ResultError, ResultErrorCode, ResultType, ResultTypeError, TaskYieldNotResultError, UnwrapErrOnOkError, UnwrapOnErrError, all, and, bimap, collectAllErrors, collectFirstOk, collectFirstOkAsync, collectFirstOkParallelAsync, combine, contains, containsErr, err, expectErr, expectResult, filter, filterAsync, flatMap, flatMapAsync, flatten, fold, foldAsync, fromNullable, fromPromise, fromSerialized, fromThrowable, gen, isErr, isOk, isResult, map, mapAsync, mapBoth, mapErr, mapErrAsync, mapOr, mapOrElse, match, matchAsync, matchTag, ok, okIf, okIfLazy, or, orElse, partition, recover, recoverWith, sequence, sequenceRecord, swap, tap, tapAsync, task, toNullable, toPromise, tryAsync, tryCatch, tryCatchAsync, tryFn, tryMap, tryMapAsync, unwrap, unwrapErr, unwrapOr, unwrapOrDefault, unwrapOrElse, unwrapOrThrow, zip };
 //# sourceMappingURL=index.d.cts.map

package/dist/index.d.cts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.cts","names":[],"sources":["../src/gen.ts","../src/core/unwrap.ts","../src/core/unwrapOr.ts","../src/core/unwrapOrElse.ts","../src/core/unwrapOrDefault.ts","../src/core/unwrapOrThrow.ts","../src/core/unwrapErr.ts","../src/core/expectResult.ts","../src/core/expectErr.ts","../src/core/toPromise.ts","../src/core/toNullable.ts","../src/core/isOk.ts","../src/core/isErr.ts","../src/core/contains.ts","../src/core/containsErr.ts"],"sourcesContent":[],"mappings":";;;;;;KAKK,sDAAsD,UAAU,GAAG,GAAG,KAAK,eAAe,GAAG,GAAG;KAEhG,kBAAkB,UAAU;KAE5B,iCAAiC;KAEjC,mBAAmB,QAAQ;KAC3B,gBAAgB,cAAc,WAAW,2BAA2B,cAAc;AAZ3C,KAavC,WARA,CAAA,CAAA,CAAY,GAQK,aARL,CAQmB,CARnB,CAAA,SAQ8B,MAR9B,CAAA,GAAA,EAAA,KAAA,EAAA,CAAA,GAAA,CAAA,GAAA,KAAA;;;;;;;;;;AAA6E;AAEvD;AAEA;AAGlC,iBAeiB,IAfP,CAAA,OAAA,EAAA,OAAA,CAAA,CAAA,aAAA,EAAA,GAAA,GAgBU,YAhBV,CAgBuB,CAhBvB,EAgB0B,CAhB1B,EAAA,OAAA,CAAA,CAAA,EAiBZ,OAjBY,CAiBJ,MAjBI,CAiBG,UAjBH,CAiBc,CAjBd,CAAA,EAiBkB,YAjBlB,CAiB+B,CAjB/B,CAAA,GAiBoC,WAjBpC,CAiBgD,CAjBhD,CAAA,CAAA,CAAA;AAAoB,iBAkBb,IAlBa,CAAA,OAAA,EAAA,OAAA,EAAA,OAAA,CAAA,CAAA,aAAA,EAAA,GAAA,GAmBV,YAnBU,CAmBG,CAnBH,EAmBM,CAnBN,EAAA,OAAA,CAAA,EAAA,OAAA,EAoBtB,OApBsB,CAoBd,OApBc,CAAA,CAAA,EAqBhC,OArBgC,CAqBxB,MArBwB,CAqBjB,UArBiB,CAqBN,CArBM,CAAA,EAqBF,YArBE,CAqBW,CArBX,CAAA,GAqBgB,WArBhB,CAqB4B,CArB5B,CAAA,GAqBiC,OArBjC,CAAA,CAAA;AAAd,cA8ER,GA9EQ,EAAA,OA8EL,IA9EK;;;;;;;iBCLL,qBAAqB,OAAO,GAAG,KAAK;;;;;;;iBCApC,uBAAuB,OAAO,GAAG,kBAAkB,IAAI;;;;;;;iBCAvD,2BAA2B,OAAO,GAAG,gBAAgB,MAAM,IAAI;;;;;;;iBCA/D,8BAA8B,OAAO,GAAG,kBAAkB,IAAI;;;;;;;iBCA9D,4BAA4B,OAAO,GAAG,KAAK;;;;;;;iBCA3C,wBAAwB,OAAO,GAAG,KAAK;;;;;;;iBCAvC,2BAA2B,OAAO,GAAG,sBAAsB;;;;;;;iBCA3D,wBAAwB,OAAO,GAAG,sBAAsB;;;;;;;iBCAxD,wBAAwB,OAAO,GAAG,KAAK,QAAQ;;;;;;;iBCA/C,yBAAyB,OAAO,GAAG,KAAK;;;;;;;iBCAxC,mBAAmB,OAAO,GAAG,eAAe,GAAG,GAAG;;;;;;;iBCAlD,oBAAoB,OAAO,GAAG,eAAe,IAAI,GAAG;;;;;;;iBCApD,uBAAuB,OAAO,GAAG,WAAW;;;;;;;iBCA5C,0BAA0B,OAAO,GAAG,WAAW"}
+{"version":3,"file":"index.d.cts","names":[],"sources":["../src/gen.ts","../src/core/unwrap.ts","../src/core/unwrapOr.ts","../src/core/unwrapOrElse.ts","../src/core/unwrapOrDefault.ts","../src/core/unwrapOrThrow.ts","../src/core/unwrapErr.ts","../src/core/expectResult.ts","../src/core/expectErr.ts","../src/core/fromSerialized.ts","../src/core/toPromise.ts","../src/core/toNullable.ts","../src/core/isOk.ts","../src/core/isErr.ts","../src/core/contains.ts","../src/core/containsErr.ts"],"mappings":";;;;;;KAKK,YAAA,0CAAsD,SAAA,CAAU,CAAA,EAAG,CAAA,EAAG,CAAA,IAAK,cAAA,CAAe,CAAA,EAAG,CAAA,EAAG,CAAA;AAAA,KAEhG,YAAA,MAAkB,CAAA,SAAU,MAAA,iBAAuB,CAAA;AAAA,KAEnD,OAAA,OAAc,KAAA,cAAmB,CAAA;AAAA,KAEjC,aAAA,MAAmB,OAAA,CAAQ,CAAA;AAAA,KAC3B,UAAA,MAAgB,aAAA,CAAc,CAAA,UAAW,MAAA,iBAAuB,CAAA,GAAI,aAAA,CAAc,CAAA;AAAA,KAClF,WAAA,MAAiB,aAAA,CAAc,CAAA,UAAW,MAAA,iBAAuB,CAAA;;;;;;;;;;;;;iBAchD,IAAA,mBAClB,aAAA,QAAqB,YAAA,CAAa,CAAA,EAAG,CAAA,aACtC,OAAA,CAAQ,MAAA,CAAO,UAAA,CAAW,CAAA,GAAI,YAAA,CAAa,CAAA,IAAK,WAAA,CAAY,CAAA;AAAA,iBACzC,IAAA,4BAClB,aAAA,QAAqB,YAAA,CAAa,CAAA,EAAG,CAAA,YACrC,OAAA,EAAS,OAAA,CAAQ,OAAA,IAClB,OAAA,CAAQ,MAAA,CAAO,UAAA,CAAW,CAAA,GAAI,YAAA,CAAa,CAAA,IAAK,WAAA,CAAY,CAAA,IAAK,OAAA;AAAA,cAkFvD,GAAA,SAAY,IAAA;;;;;;;iBC5GT,MAAA,OAAa,MAAA,EAAQ,MAAA,CAAO,CAAA,EAAG,CAAA,IAAK,CAAA;;;;;;;iBCApC,QAAA,OAAe,MAAA,EAAQ,MAAA,CAAO,CAAA,EAAG,CAAA,GAAI,YAAA,EAAc,CAAA,GAAI,CAAA;;;;;;;iBCAvD,YAAA,OAAmB,MAAA,EAAQ,MAAA,CAAO,CAAA,EAAG,CAAA,GAAI,EAAA,GAAK,KAAA,EAAO,CAAA,KAAM,CAAA,GAAI,CAAA;;;;;;;;AHPnD;;;iBIWZ,eAAA,OAAsB,MAAA,EAAQ,MAAA,CAAO,CAAA,EAAG,CAAA,GAAI,YAAA,EAAc,CAAA,GAAI,CAAA;;;;;;;iBCJ9D,aAAA,OAAoB,MAAA,EAAQ,MAAA,CAAO,CAAA,EAAG,CAAA,IAAK,CAAA;;;;;;;iBCA3C,SAAA,OAAgB,MAAA,EAAQ,MAAA,CAAO,CAAA,EAAG,CAAA,IAAK,CAAA;;;;;;;iBCAvC,YAAA,OAAmB,MAAA,EAAQ,MAAA,CAAO,CAAA,EAAG,CAAA,GAAI,OAAA,WAAkB,CAAA;;;;;;;iBCA3D,SAAA,OAAgB,MAAA,EAAQ,MAAA,CAAO,CAAA,EAAG,CAAA,GAAI,OAAA,WAAkB,CAAA;;;;;;;;ARP5C;;iBSWZ,cAAA,OAAqB,IAAA,EAAM,UAAA,CAAW,CAAA,EAAG,CAAA,IAAK,MAAA,CAAO,CAAA,EAAG,CAAA;;;;;;;iBCJxD,SAAA,OAAgB,MAAA,EAAQ,MAAA,CAAO,CAAA,EAAG,CAAA,IAAK,OAAA,CAAQ,CAAA;;;;;;;iBCA/C,UAAA,OAAiB,MAAA,EAAQ,MAAA,CAAO,CAAA,EAAG,CAAA,IAAK,CAAA;;;;;;;iBCAxC,IAAA,OAAW,MAAA,EAAQ,MAAA,CAAO,CAAA,EAAG,CAAA,IAAK,MAAA,IAAU,EAAA,CAAG,CAAA,EAAG,CAAA;;;;;;;iBCAlD,KAAA,OAAY,MAAA,EAAQ,MAAA,CAAO,CAAA,EAAG,CAAA,IAAK,MAAA,IAAU,GAAA,CAAI,CAAA,EAAG,CAAA;;;;;;;;AbPxC;;iBcUZ,QAAA,OAAe,MAAA,EAAQ,MAAA,CAAO,CAAA,EAAG,CAAA,GAAI,KAAA,EAAO,CAAA;;;;;;;;AdVhC;;iBeUZ,WAAA,OAAkB,MAAA,EAAQ,MAAA,CAAO,CAAA,EAAG,CAAA,GAAI,KAAA,EAAO,CAAA"}

package/dist/index.d.mts

@@ -1,7 +1,7 @@
-import { A as recover, B as combine, C as flatMapAsync, D as tryMap, E as collectFirstOk, F as flatMap, H as isResult, I as bimap, L as mapBoth, M as match, N as filter, O as tryCatch, P as tap, R as mapErr, S as tapAsync, T as mapAsync, U as matchTag, V as zip, W as Awaitable, _ as tryFn, a as Ok, b as matchAsync, c as ResultType, d as fromPromise, f as fromThrowable, g as tryAsync, h as okIfLazy, i as Err, j as recoverWith, k as swap, l as err, m as okIf, n as sequence, o as OperatorFunction, p as ok, r as AsyncOperatorFunction, s as Result, t as all, u as fromNullable, v as tryMapAsync, w as mapErrAsync, x as filterAsync, y as tryCatchAsync, z as map } from "./sequence-C0jlR3AY.mjs";
-import { a as collectFirstOkAsync, i as collectFirstOkParallelAsync, n as partition, o as sequenceRecord, r as collectAllErrors, t as flatten } from "./flatten-B8bN6fiI.mjs";
-import { _ as ResultTypeError, a as ERR_MATCH_ERR_HANDLER_NOT_RESULT, b as UnwrapOnErrError, c as ERR_UNWRAP_ERR_ON_OK, d as ExpectOkError, f as InvalidResultStateError, g as ResultErrorCode, h as ResultError, i as ERR_INVALID_STATE, l as ERR_UNWRAP_ON_ERR, m as MatchOnOkError, n as ERR_EXPECT_OK, o as ERR_MATCH_ON_OK, p as MatchErrHandlerNotResultError, r as ERR_INVALID_RESULT_STATE, s as ERR_TASK_YIELD_NOT_RESULT, t as ERR_EXPECT_ERR, u as ExpectErrError, v as TaskYieldNotResultError, y as UnwrapErrOnOkError } from "./errors-C5qGMRiU.mjs";
-import { a as and, i as or, n as mapOr, o as foldAsync, r as orElse, s as fold, t as mapOrElse } from "./mapOrElse-B5gx9x2E.mjs";
+import { S as Awaitable, _ as tryFn, a as Ok, b as isResult, c as ResultType, d as fromPromise, f as fromThrowable, g as tryAsync, h as okIfLazy, i as Err, l as err, m as okIf, n as sequence, o as OperatorFunction, p as ok, r as AsyncOperatorFunction, s as Result, t as all, u as fromNullable, v as combine, x as matchTag, y as zip } from "./sequence-DDwePRLd.mjs";
+import { a as collectFirstOkAsync, i as collectFirstOkParallelAsync, n as partition, o as collectFirstOk, r as collectAllErrors, s as sequenceRecord, t as flatten } from "./flatten-C7D6Kttf.mjs";
+import { ERR_EXPECT_ERR, ERR_EXPECT_OK, ERR_INVALID_RESULT_STATE, ERR_INVALID_STATE, ERR_MATCH_ERR_HANDLER_NOT_RESULT, ERR_MATCH_ON_OK, ERR_MATCH_TAG_MISSING_HANDLER, ERR_TASK_YIELD_NOT_RESULT, ERR_UNWRAP_ERR_ON_OK, ERR_UNWRAP_ON_ERR, ExpectErrError, ExpectOkError, InvalidResultStateError, MatchErrHandlerNotResultError, MatchOnOkError, MatchTagMissingHandlerError, ResultError, ResultErrorCode, ResultTypeError, TaskYieldNotResultError, UnwrapErrOnOkError, UnwrapOnErrError } from "./errors.mjs";
+import { C as tap, D as mapErr, E as mapBoth, O as map, S as filter, T as bimap, _ as recoverWith, a as or, b as match, c as tryCatchAsync, d as filterAsync, f as tapAsync, g as recover, h as mapAsync, i as orElse, l as matchAsync, m as mapErrAsync, n as mapOrElse, o as and, p as flatMapAsync, r as mapOr, s as tryMapAsync, t as swap, u as foldAsync, v as tryMap, w as flatMap, x as fold, y as tryCatch } from "./swap-DT4LdRFV.mjs";
 
 //#region src/gen.d.ts
 type AnyGenerator<Y = unknown, R = unknown, N = unknown> = Generator<Y, R, N> | AsyncGenerator<Y, R, N>;
@@ -11,118 +11,138 @@ type AwaitedReturn<R> = Awaited<R>;
 type OkOfReturn<R> = AwaitedReturn<R> extends Result<infer T, any> ? T : AwaitedReturn<R>;
 type ErrOfReturn<R> = AwaitedReturn<R> extends Result<any, infer E> ? E : never;
 /**
- * Generator-based do-notation for `Result`.
- *
- * Usage:
- * ```ts
- * const out = await task(async function* () {
- *   const user = yield* await fromPromise(findUser(1));
- *   const email = yield* validate(user.email);
- *   return email;
- * });
- * ```
- */
+* Generator-based do-notation for `Result`.
+*
+* Usage:
+* ```ts
+* const out = await task(async function* () {
+*   const user = yield* await fromPromise(findUser(1));
+*   const email = yield* validate(user.email);
+*   return email;
+* });
+* ```
+*/
 declare function task<const Y, const R>(makeGenerator: () => AnyGenerator<Y, R, unknown>): Promise<Result<OkOfReturn<R>, ErrorOfYield<Y> | ErrOfReturn<R>>>;
 declare function task<const Y, const R, EThrown>(makeGenerator: () => AnyGenerator<Y, R, unknown>, onThrow: OnThrow<EThrown>): Promise<Result<OkOfReturn<R>, ErrorOfYield<Y> | ErrOfReturn<R> | EThrown>>;
 declare const gen: typeof task;
 //#endregion
 //#region src/core/unwrap.d.ts
 /**
- * Returns the value or throws an Error.
- * Corresponds to Rust `unwrap`.
- */
+* Returns the value or throws an Error.
+* Corresponds to Rust `unwrap`.
+*/
 declare function unwrap<T, E>(result: Result<T, E>): T;
 //#endregion
 //#region src/core/unwrapOr.d.ts
 /**
- * Returns the value or a default value.
- * Pure function alternative to the instance method.
- */
+* Returns the value or a default value.
+* Pure function alternative to the instance method.
+*/
 declare function unwrapOr<T, E>(result: Result<T, E>, defaultValue: T): T;
 //#endregion
 //#region src/core/unwrapOrElse.d.ts
 /**
- * Returns the value or calculates a default value using a function.
- * Corresponds to Rust `unwrap_or_else`.
- */
+* Returns the value or calculates a default value using a function.
+* Corresponds to Rust `unwrap_or_else`.
+*/
 declare function unwrapOrElse<T, E>(result: Result<T, E>, fn: (error: E) => T): T;
 //#endregion
 //#region src/core/unwrapOrDefault.d.ts
 /**
- * Alias for `unwrapOr`.
- * Corresponds to Rust `unwrap_or_default` (with explicit default value).
- */
+* Alias for `unwrapOr`.
+*
+* @deprecated Use {@link unwrapOr} instead. The name is misleading: Rust's
+* `unwrap_or_default` takes no argument (it uses the type's `Default`),
+* whereas this function requires an explicit default value — which is exactly
+* what `unwrapOr` does.
+*/
 declare function unwrapOrDefault<T, E>(result: Result<T, E>, defaultValue: T): T;
 //#endregion
 //#region src/core/unwrapOrThrow.d.ts
 /**
- * Returns the value or throws the original Err value (not wrapped).
- * Useful to preserve `Error` instances including stack traces.
- */
+* Returns the value or throws the original Err value (not wrapped).
+* Useful to preserve `Error` instances including stack traces.
+*/
 declare function unwrapOrThrow<T, E>(result: Result<T, E>): T;
 //#endregion
 //#region src/core/unwrapErr.d.ts
 /**
- * Returns the error or throws an Error.
- * Corresponds to Rust `unwrap_err`.
- */
+* Returns the error or throws an Error.
+* Corresponds to Rust `unwrap_err`.
+*/
 declare function unwrapErr<T, E>(result: Result<T, E>): E;
 //#endregion
 //#region src/core/expectResult.d.ts
 /**
- * Returns the value or throws an Error with a custom message.
- * Corresponds to Rust `expect`.
- */
+* Returns the value or throws an Error with a custom message.
+* Corresponds to Rust `expect`.
+*/
 declare function expectResult<T, E>(result: Result<T, E>, message: string): T;
 //#endregion
 //#region src/core/expectErr.d.ts
 /**
- * Returns the error or throws an Error with a custom message.
- * Corresponds to Rust `expect_err`.
- */
+* Returns the error or throws an Error with a custom message.
+* Corresponds to Rust `expect_err`.
+*/
 declare function expectErr<T, E>(result: Result<T, E>, message: string): E;
 //#endregion
+//#region src/core/fromSerialized.d.ts
+/**
+* Rebuilds a `Result` from its serialized discriminated form
+* (`{ _tag: 'Ok', value }` / `{ _tag: 'Err', error }`), the shape produced
+* by `Result.toSerialized()` and by `JSON.stringify` on a Result.
+*
+* Throws `InvalidResultStateError` for data that is not in that shape.
+*/
+declare function fromSerialized<T, E>(data: ResultType<T, E>): Result<T, E>;
+//#endregion
 //#region src/core/toPromise.d.ts
 /**
- * Converts a Result to a Promise.
- * Ok → resolve(value), Err → reject(error)
- */
+* Converts a Result to a Promise.
+* Ok → resolve(value), Err → reject(error)
+*/
 declare function toPromise<T, E>(result: Result<T, E>): Promise<T>;
 //#endregion
 //#region src/core/toNullable.d.ts
 /**
- * Converts a Result to `T | null`.
- * Ok → value, Err → null
- */
+* Converts a Result to `T | null`.
+* Ok → value, Err → null
+*/
 declare function toNullable<T, E>(result: Result<T, E>): T | null;
 //#endregion
 //#region src/core/isOk.d.ts
 /**
- * Checks if a Result is Ok.
- * Pure function alternative to the instance method.
- */
+* Checks if a Result is Ok.
+* Pure function alternative to the instance method.
+*/
 declare function isOk<T, E>(result: Result<T, E>): result is Ok<T, E>;
 //#endregion
 //#region src/core/isErr.d.ts
 /**
- * Checks if a Result is Err.
- * Pure function alternative to the instance method.
- */
+* Checks if a Result is Err.
+* Pure function alternative to the instance method.
+*/
 declare function isErr<T, E>(result: Result<T, E>): result is Err<T, E>;
 //#endregion
 //#region src/core/contains.d.ts
 /**
- * Checks if the Result contains a specific value.
- * Corresponds to Rust `contains`.
- */
+* Checks if the Result contains a specific value.
+* Corresponds to Rust `contains`.
+*
+* Comparison uses `Object.is` (SameValue): `NaN` matches `NaN`, `+0` and
+* `-0` are distinct, and objects are compared by reference.
+*/
 declare function contains<T, E>(result: Result<T, E>, value: T): boolean;
 //#endregion
 //#region src/core/containsErr.d.ts
 /**
- * Checks if the Result contains a specific error.
- * Analogous to `contains` for the Err case.
- */
+* Checks if the Result contains a specific error.
+* Analogous to `contains` for the Err case.
+*
+* Comparison uses `Object.is` (SameValue): `NaN` matches `NaN`, `+0` and
+* `-0` are distinct, and objects are compared by reference.
+*/
 declare function containsErr<T, E>(result: Result<T, E>, error: E): boolean;
 //#endregion
-export { AsyncOperatorFunction, Awaitable, ERR_EXPECT_ERR, ERR_EXPECT_OK, ERR_INVALID_RESULT_STATE, ERR_INVALID_STATE, ERR_MATCH_ERR_HANDLER_NOT_RESULT, ERR_MATCH_ON_OK, ERR_TASK_YIELD_NOT_RESULT, ERR_UNWRAP_ERR_ON_OK, ERR_UNWRAP_ON_ERR, Err, ExpectErrError, ExpectOkError, InvalidResultStateError, MatchErrHandlerNotResultError, MatchOnOkError, Ok, OperatorFunction, Result, ResultError, ResultErrorCode, ResultType, ResultTypeError, TaskYieldNotResultError, UnwrapErrOnOkError, UnwrapOnErrError, all, and, bimap, collectAllErrors, collectFirstOk, collectFirstOkAsync, collectFirstOkParallelAsync, combine, contains, containsErr, err, expectErr, expectResult, filter, filterAsync, flatMap, flatMapAsync, flatten, fold, foldAsync, fromNullable, fromPromise, fromThrowable, gen, isErr, isOk, isResult, map, mapAsync, mapBoth, mapErr, mapErrAsync, mapOr, mapOrElse, match, matchAsync, matchTag, ok, okIf, okIfLazy, or, orElse, partition, recover, recoverWith, sequence, sequenceRecord, swap, tap, tapAsync, task, toNullable, toPromise, tryAsync, tryCatch, tryCatchAsync, tryFn, tryMap, tryMapAsync, unwrap, unwrapErr, unwrapOr, unwrapOrDefault, unwrapOrElse, unwrapOrThrow, zip };
+export { AsyncOperatorFunction, type Awaitable, ERR_EXPECT_ERR, ERR_EXPECT_OK, ERR_INVALID_RESULT_STATE, ERR_INVALID_STATE, ERR_MATCH_ERR_HANDLER_NOT_RESULT, ERR_MATCH_ON_OK, ERR_MATCH_TAG_MISSING_HANDLER, ERR_TASK_YIELD_NOT_RESULT, ERR_UNWRAP_ERR_ON_OK, ERR_UNWRAP_ON_ERR, Err, ExpectErrError, ExpectOkError, InvalidResultStateError, MatchErrHandlerNotResultError, MatchOnOkError, MatchTagMissingHandlerError, Ok, OperatorFunction, Result, ResultError, ResultErrorCode, ResultType, ResultTypeError, TaskYieldNotResultError, UnwrapErrOnOkError, UnwrapOnErrError, all, and, bimap, collectAllErrors, collectFirstOk, collectFirstOkAsync, collectFirstOkParallelAsync, combine, contains, containsErr, err, expectErr, expectResult, filter, filterAsync, flatMap, flatMapAsync, flatten, fold, foldAsync, fromNullable, fromPromise, fromSerialized, fromThrowable, gen, isErr, isOk, isResult, map, mapAsync, mapBoth, mapErr, mapErrAsync, mapOr, mapOrElse, match, matchAsync, matchTag, ok, okIf, okIfLazy, or, orElse, partition, recover, recoverWith, sequence, sequenceRecord, swap, tap, tapAsync, task, toNullable, toPromise, tryAsync, tryCatch, tryCatchAsync, tryFn, tryMap, tryMapAsync, unwrap, unwrapErr, unwrapOr, unwrapOrDefault, unwrapOrElse, unwrapOrThrow, zip };
 //# sourceMappingURL=index.d.mts.map

package/dist/index.d.mts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.mts","names":[],"sources":["../src/gen.ts","../src/core/unwrap.ts","../src/core/unwrapOr.ts","../src/core/unwrapOrElse.ts","../src/core/unwrapOrDefault.ts","../src/core/unwrapOrThrow.ts","../src/core/unwrapErr.ts","../src/core/expectResult.ts","../src/core/expectErr.ts","../src/core/toPromise.ts","../src/core/toNullable.ts","../src/core/isOk.ts","../src/core/isErr.ts","../src/core/contains.ts","../src/core/containsErr.ts"],"sourcesContent":[],"mappings":";;;;;;KAKK,sDAAsD,UAAU,GAAG,GAAG,KAAK,eAAe,GAAG,GAAG;KAEhG,kBAAkB,UAAU;KAE5B,iCAAiC;KAEjC,mBAAmB,QAAQ;KAC3B,gBAAgB,cAAc,WAAW,2BAA2B,cAAc;AAZ3C,KAavC,WARA,CAAA,CAAA,CAAY,GAQK,aARL,CAQmB,CARnB,CAAA,SAQ8B,MAR9B,CAAA,GAAA,EAAA,KAAA,EAAA,CAAA,GAAA,CAAA,GAAA,KAAA;;;;;;;;;;AAA6E;AAEvD;AAEA;AAGlC,iBAeiB,IAfP,CAAA,OAAA,EAAA,OAAA,CAAA,CAAA,aAAA,EAAA,GAAA,GAgBU,YAhBV,CAgBuB,CAhBvB,EAgB0B,CAhB1B,EAAA,OAAA,CAAA,CAAA,EAiBZ,OAjBY,CAiBJ,MAjBI,CAiBG,UAjBH,CAiBc,CAjBd,CAAA,EAiBkB,YAjBlB,CAiB+B,CAjB/B,CAAA,GAiBoC,WAjBpC,CAiBgD,CAjBhD,CAAA,CAAA,CAAA;AAAoB,iBAkBb,IAlBa,CAAA,OAAA,EAAA,OAAA,EAAA,OAAA,CAAA,CAAA,aAAA,EAAA,GAAA,GAmBV,YAnBU,CAmBG,CAnBH,EAmBM,CAnBN,EAAA,OAAA,CAAA,EAAA,OAAA,EAoBtB,OApBsB,CAoBd,OApBc,CAAA,CAAA,EAqBhC,OArBgC,CAqBxB,MArBwB,CAqBjB,UArBiB,CAqBN,CArBM,CAAA,EAqBF,YArBE,CAqBW,CArBX,CAAA,GAqBgB,WArBhB,CAqB4B,CArB5B,CAAA,GAqBiC,OArBjC,CAAA,CAAA;AAAd,cA8ER,GA9EQ,EAAA,OA8EL,IA9EK;;;;;;;iBCLL,qBAAqB,OAAO,GAAG,KAAK;;;;;;;iBCApC,uBAAuB,OAAO,GAAG,kBAAkB,IAAI;;;;;;;iBCAvD,2BAA2B,OAAO,GAAG,gBAAgB,MAAM,IAAI;;;;;;;iBCA/D,8BAA8B,OAAO,GAAG,kBAAkB,IAAI;;;;;;;iBCA9D,4BAA4B,OAAO,GAAG,KAAK;;;;;;;iBCA3C,wBAAwB,OAAO,GAAG,KAAK;;;;;;;iBCAvC,2BAA2B,OAAO,GAAG,sBAAsB;;;;;;;iBCA3D,wBAAwB,OAAO,GAAG,sBAAsB;;;;;;;iBCAxD,wBAAwB,OAAO,GAAG,KAAK,QAAQ;;;;;;;iBCA/C,yBAAyB,OAAO,GAAG,KAAK;;;;;;;iBCAxC,mBAAmB,OAAO,GAAG,eAAe,GAAG,GAAG;;;;;;;iBCAlD,oBAAoB,OAAO,GAAG,eAAe,IAAI,GAAG;;;;;;;iBCApD,uBAAuB,OAAO,GAAG,WAAW;;;;;;;iBCA5C,0BAA0B,OAAO,GAAG,WAAW"}
+{"version":3,"file":"index.d.mts","names":[],"sources":["../src/gen.ts","../src/core/unwrap.ts","../src/core/unwrapOr.ts","../src/core/unwrapOrElse.ts","../src/core/unwrapOrDefault.ts","../src/core/unwrapOrThrow.ts","../src/core/unwrapErr.ts","../src/core/expectResult.ts","../src/core/expectErr.ts","../src/core/fromSerialized.ts","../src/core/toPromise.ts","../src/core/toNullable.ts","../src/core/isOk.ts","../src/core/isErr.ts","../src/core/contains.ts","../src/core/containsErr.ts"],"mappings":";;;;;;KAKK,YAAA,0CAAsD,SAAA,CAAU,CAAA,EAAG,CAAA,EAAG,CAAA,IAAK,cAAA,CAAe,CAAA,EAAG,CAAA,EAAG,CAAA;AAAA,KAEhG,YAAA,MAAkB,CAAA,SAAU,MAAA,iBAAuB,CAAA;AAAA,KAEnD,OAAA,OAAc,KAAA,cAAmB,CAAA;AAAA,KAEjC,aAAA,MAAmB,OAAA,CAAQ,CAAA;AAAA,KAC3B,UAAA,MAAgB,aAAA,CAAc,CAAA,UAAW,MAAA,iBAAuB,CAAA,GAAI,aAAA,CAAc,CAAA;AAAA,KAClF,WAAA,MAAiB,aAAA,CAAc,CAAA,UAAW,MAAA,iBAAuB,CAAA;;;;;;;;;;;;;iBAchD,IAAA,mBAClB,aAAA,QAAqB,YAAA,CAAa,CAAA,EAAG,CAAA,aACtC,OAAA,CAAQ,MAAA,CAAO,UAAA,CAAW,CAAA,GAAI,YAAA,CAAa,CAAA,IAAK,WAAA,CAAY,CAAA;AAAA,iBACzC,IAAA,4BAClB,aAAA,QAAqB,YAAA,CAAa,CAAA,EAAG,CAAA,YACrC,OAAA,EAAS,OAAA,CAAQ,OAAA,IAClB,OAAA,CAAQ,MAAA,CAAO,UAAA,CAAW,CAAA,GAAI,YAAA,CAAa,CAAA,IAAK,WAAA,CAAY,CAAA,IAAK,OAAA;AAAA,cAkFvD,GAAA,SAAY,IAAA;;;;;;;iBC5GT,MAAA,OAAa,MAAA,EAAQ,MAAA,CAAO,CAAA,EAAG,CAAA,IAAK,CAAA;;;;;;;iBCApC,QAAA,OAAe,MAAA,EAAQ,MAAA,CAAO,CAAA,EAAG,CAAA,GAAI,YAAA,EAAc,CAAA,GAAI,CAAA;;;;;;;iBCAvD,YAAA,OAAmB,MAAA,EAAQ,MAAA,CAAO,CAAA,EAAG,CAAA,GAAI,EAAA,GAAK,KAAA,EAAO,CAAA,KAAM,CAAA,GAAI,CAAA;;;;;;;;AHPnD;;;iBIWZ,eAAA,OAAsB,MAAA,EAAQ,MAAA,CAAO,CAAA,EAAG,CAAA,GAAI,YAAA,EAAc,CAAA,GAAI,CAAA;;;;;;;iBCJ9D,aAAA,OAAoB,MAAA,EAAQ,MAAA,CAAO,CAAA,EAAG,CAAA,IAAK,CAAA;;;;;;;iBCA3C,SAAA,OAAgB,MAAA,EAAQ,MAAA,CAAO,CAAA,EAAG,CAAA,IAAK,CAAA;;;;;;;iBCAvC,YAAA,OAAmB,MAAA,EAAQ,MAAA,CAAO,CAAA,EAAG,CAAA,GAAI,OAAA,WAAkB,CAAA;;;;;;;iBCA3D,SAAA,OAAgB,MAAA,EAAQ,MAAA,CAAO,CAAA,EAAG,CAAA,GAAI,OAAA,WAAkB,CAAA;;;;;;;;ARP5C;;iBSWZ,cAAA,OAAqB,IAAA,EAAM,UAAA,CAAW,CAAA,EAAG,CAAA,IAAK,MAAA,CAAO,CAAA,EAAG,CAAA;;;;;;;iBCJxD,SAAA,OAAgB,MAAA,EAAQ,MAAA,CAAO,CAAA,EAAG,CAAA,IAAK,OAAA,CAAQ,CAAA;;;;;;;iBCA/C,UAAA,OAAiB,MAAA,EAAQ,MAAA,CAAO,CAAA,EAAG,CAAA,IAAK,CAAA;;;;;;;iBCAxC,IAAA,OAAW,MAAA,EAAQ,MAAA,CAAO,CAAA,EAAG,CAAA,IAAK,MAAA,IAAU,EAAA,CAAG,CAAA,EAAG,CAAA;;;;;;;iBCAlD,KAAA,OAAY,MAAA,EAAQ,MAAA,CAAO,CAAA,EAAG,CAAA,IAAK,MAAA,IAAU,GAAA,CAAI,CAAA,EAAG,CAAA;;;;;;;;AbPxC;;iBcUZ,QAAA,OAAe,MAAA,EAAQ,MAAA,CAAO,CAAA,EAAG,CAAA,GAAI,KAAA,EAAO,CAAA;;;;;;;;AdVhC;;iBeUZ,WAAA,OAAkB,MAAA,EAAQ,MAAA,CAAO,CAAA,EAAG,CAAA,GAAI,KAAA,EAAO,CAAA"}

package/dist/index.mjs

@@ -1,12 +1,17 @@
-import { A as flatMap, B as isResult, C as tryCatch, D as match, E as recoverWith, F as combine, I as zip, L as all, M as mapBoth, N as mapErr, O as filter, P as map, R as sequence, S as tryMap, T as recover, _ as tapAsync, a as fromNullable, b as mapAsync, c as ok, d as tryAsync, f as tryFn, g as filterAsync, h as matchAsync, i as err, j as bimap, k as tap, l as okIf, m as tryCatchAsync, n as Ok, o as fromPromise, p as tryMapAsync, r as Result, s as fromThrowable, t as Err, u as okIfLazy, v as flatMapAsync, w as swap, x as collectFirstOk, y as mapErrAsync, z as matchTag } from "./result-DKKaNdOx.mjs";
-import { _ as TaskYieldNotResultError, a as ERR_MATCH_ERR_HANDLER_NOT_RESULT, c as ERR_UNWRAP_ERR_ON_OK, d as ExpectOkError, f as InvalidResultStateError, g as ResultTypeError, h as ResultError, i as ERR_INVALID_STATE, l as ERR_UNWRAP_ON_ERR, m as MatchOnOkError, n as ERR_EXPECT_OK, o as ERR_MATCH_ON_OK, p as MatchErrHandlerNotResultError, r as ERR_INVALID_RESULT_STATE, s as ERR_TASK_YIELD_NOT_RESULT, t as ERR_EXPECT_ERR, u as ExpectErrError, v as UnwrapErrOnOkError, y as UnwrapOnErrError } from "./errors-2WOswg7r.mjs";
-import { a as and, i as or, n as mapOr, o as foldAsync, r as orElse, s as fold, t as mapOrElse } from "./mapOrElse-B0_4r6Jn.mjs";
-import { a as collectFirstOkAsync, i as collectFirstOkParallelAsync, n as partition, o as sequenceRecord, r as collectAllErrors, t as flatten } from "./flatten-C6Y9hx79.mjs";
+import { _ as matchTag, a as fromNullable, c as ok, d as tryAsync, f as tryFn, g as sequence, h as all, i as err, l as okIf, m as zip, n as Ok, o as fromPromise, p as combine, r as Result, s as fromThrowable, t as Err, u as okIfLazy, v as isResult } from "./result-q9Na2bGa.mjs";
+import { ERR_EXPECT_ERR, ERR_EXPECT_OK, ERR_INVALID_RESULT_STATE, ERR_INVALID_STATE, ERR_MATCH_ERR_HANDLER_NOT_RESULT, ERR_MATCH_ON_OK, ERR_MATCH_TAG_MISSING_HANDLER, ERR_TASK_YIELD_NOT_RESULT, ERR_UNWRAP_ERR_ON_OK, ERR_UNWRAP_ON_ERR, ExpectErrError, ExpectOkError, InvalidResultStateError, MatchErrHandlerNotResultError, MatchOnOkError, MatchTagMissingHandlerError, ResultError, ResultTypeError, TaskYieldNotResultError, UnwrapErrOnOkError, UnwrapOnErrError } from "./errors.mjs";
+import { C as tap, D as mapErr, E as mapBoth, O as map, S as filter, T as bimap, _ as recoverWith, a as or, b as match, c as tryCatchAsync, d as filterAsync, f as tapAsync, g as recover, h as mapAsync, i as orElse, l as matchAsync, m as mapErrAsync, n as mapOrElse, o as and, p as flatMapAsync, r as mapOr, s as tryMapAsync, t as swap, u as foldAsync, v as tryMap, w as flatMap, x as fold, y as tryCatch } from "./swap-CFD2g1cB.mjs";
+import { a as collectFirstOkAsync, i as collectFirstOkParallelAsync, n as partition, o as collectFirstOk, r as collectAllErrors, s as sequenceRecord, t as flatten } from "./flatten-ChTL5BfA.mjs";
 
 //#region src/gen.ts
 async function task(makeGenerator, onThrow) {
 	const iterator = makeGenerator();
 	let input = void 0;
+	const runGeneratorReturn = async () => {
+		if (typeof iterator.return !== "function") return;
+		let step = await iterator.return(void 0);
+		while (!step.done) step = await iterator.next(void 0);
+	};
 	while (true) {
 		let step;
 		try {
@@ -24,20 +29,34 @@ async function task(makeGenerator, onThrow) {
 			return err(onThrow(caught));
 		}
 		const yielded = step.value;
-		if (!isResult(yielded)) throw new TaskYieldNotResultError(yielded);
+		if (!isResult(yielded)) {
+			try {
+				await runGeneratorReturn();
+			} catch (caught) {
+				if (!onThrow) throw caught;
+				return err(onThrow(caught));
+			}
+			throw new TaskYieldNotResultError(yielded);
+		}
 		if (yielded.isOk()) {
 			input = yielded.value;
 			continue;
 		}
 		if (yielded.isErr()) {
 			try {
-				if (typeof iterator.return === "function") await iterator.return(void 0);
+				await runGeneratorReturn();
 			} catch (caught) {
 				if (!onThrow) throw caught;
 				return err(onThrow(caught));
 			}
 			return yielded;
 		}
+		try {
+			await runGeneratorReturn();
+		} catch (caught) {
+			if (!onThrow) throw caught;
+			return err(onThrow(caught));
+		}
 		throw new InvalidResultStateError("task");
 	}
 }
@@ -83,7 +102,11 @@ function unwrapOrElse(result, fn) {
 //#region src/core/unwrapOrDefault.ts
 /**
 * Alias for `unwrapOr`.
-* Corresponds to Rust `unwrap_or_default` (with explicit default value).
+*
+* @deprecated Use {@link unwrapOr} instead. The name is misleading: Rust's
+* `unwrap_or_default` takes no argument (it uses the type's `Default`),
+* whereas this function requires an explicit default value — which is exactly
+* what `unwrapOr` does.
 */
 function unwrapOrDefault(result, defaultValue) {
 	return unwrapOr(result, defaultValue);
@@ -121,7 +144,7 @@ function unwrapErr(result) {
 */
 function expectResult(result, message) {
 	if (result.isOk()) return result.value;
-	if (result.isErr()) throw new ExpectOkError(message);
+	if (result.isErr()) throw new ExpectOkError(message, result.error);
 	throw new InvalidResultStateError("expectResult");
 }
 
@@ -133,10 +156,27 @@ function expectResult(result, message) {
 */
 function expectErr(result, message) {
 	if (result.isErr()) return result.error;
-	if (result.isOk()) throw new ExpectErrError(message);
+	if (result.isOk()) throw new ExpectErrError(message, result.value);
 	throw new InvalidResultStateError("expectErr");
 }
 
+//#endregion
+//#region src/core/fromSerialized.ts
+/**
+* Rebuilds a `Result` from its serialized discriminated form
+* (`{ _tag: 'Ok', value }` / `{ _tag: 'Err', error }`), the shape produced
+* by `Result.toSerialized()` and by `JSON.stringify` on a Result.
+*
+* Throws `InvalidResultStateError` for data that is not in that shape.
+*/
+function fromSerialized(data) {
+	if (data !== null && typeof data === "object") {
+		if (data._tag === "Ok" && "value" in data) return ok(data.value);
+		if (data._tag === "Err" && "error" in data) return err(data.error);
+	}
+	throw new InvalidResultStateError("fromSerialized");
+}
+
 //#endregion
 //#region src/core/toPromise.ts
 /**
@@ -190,9 +230,12 @@ function isErr(result) {
 /**
 * Checks if the Result contains a specific value.
 * Corresponds to Rust `contains`.
+*
+* Comparison uses `Object.is` (SameValue): `NaN` matches `NaN`, `+0` and
+* `-0` are distinct, and objects are compared by reference.
 */
 function contains(result, value) {
-	if (result.isOk()) return result.value === value;
+	if (result.isOk()) return Object.is(result.value, value);
 	if (result.isErr()) return false;
 	throw new InvalidResultStateError("contains");
 }
@@ -202,13 +245,16 @@ function contains(result, value) {
 /**
 * Checks if the Result contains a specific error.
 * Analogous to `contains` for the Err case.
+*
+* Comparison uses `Object.is` (SameValue): `NaN` matches `NaN`, `+0` and
+* `-0` are distinct, and objects are compared by reference.
 */
 function containsErr(result, error) {
-	if (result.isErr()) return result.error === error;
+	if (result.isErr()) return Object.is(result.error, error);
 	if (result.isOk()) return false;
 	throw new InvalidResultStateError("containsErr");
 }
 
 //#endregion
-export { ERR_EXPECT_ERR, ERR_EXPECT_OK, ERR_INVALID_RESULT_STATE, ERR_INVALID_STATE, ERR_MATCH_ERR_HANDLER_NOT_RESULT, ERR_MATCH_ON_OK, ERR_TASK_YIELD_NOT_RESULT, ERR_UNWRAP_ERR_ON_OK, ERR_UNWRAP_ON_ERR, Err, ExpectErrError, ExpectOkError, InvalidResultStateError, MatchErrHandlerNotResultError, MatchOnOkError, Ok, Result, ResultError, ResultTypeError, TaskYieldNotResultError, UnwrapErrOnOkError, UnwrapOnErrError, all, and, bimap, collectAllErrors, collectFirstOk, collectFirstOkAsync, collectFirstOkParallelAsync, combine, contains, containsErr, err, expectErr, expectResult, filter, filterAsync, flatMap, flatMapAsync, flatten, fold, foldAsync, fromNullable, fromPromise, fromThrowable, gen, isErr, isOk, isResult, map, mapAsync, mapBoth, mapErr, mapErrAsync, mapOr, mapOrElse, match, matchAsync, matchTag, ok, okIf, okIfLazy, or, orElse, partition, recover, recoverWith, sequence, sequenceRecord, swap, tap, tapAsync, task, toNullable, toPromise, tryAsync, tryCatch, tryCatchAsync, tryFn, tryMap, tryMapAsync, unwrap, unwrapErr, unwrapOr, unwrapOrDefault, unwrapOrElse, unwrapOrThrow, zip };
+export { ERR_EXPECT_ERR, ERR_EXPECT_OK, ERR_INVALID_RESULT_STATE, ERR_INVALID_STATE, ERR_MATCH_ERR_HANDLER_NOT_RESULT, ERR_MATCH_ON_OK, ERR_MATCH_TAG_MISSING_HANDLER, ERR_TASK_YIELD_NOT_RESULT, ERR_UNWRAP_ERR_ON_OK, ERR_UNWRAP_ON_ERR, Err, ExpectErrError, ExpectOkError, InvalidResultStateError, MatchErrHandlerNotResultError, MatchOnOkError, MatchTagMissingHandlerError, Ok, Result, ResultError, ResultTypeError, TaskYieldNotResultError, UnwrapErrOnOkError, UnwrapOnErrError, all, and, bimap, collectAllErrors, collectFirstOk, collectFirstOkAsync, collectFirstOkParallelAsync, combine, contains, containsErr, err, expectErr, expectResult, filter, filterAsync, flatMap, flatMapAsync, flatten, fold, foldAsync, fromNullable, fromPromise, fromSerialized, fromThrowable, gen, isErr, isOk, isResult, map, mapAsync, mapBoth, mapErr, mapErrAsync, mapOr, mapOrElse, match, matchAsync, matchTag, ok, okIf, okIfLazy, or, orElse, partition, recover, recoverWith, sequence, sequenceRecord, swap, tap, tapAsync, task, toNullable, toPromise, tryAsync, tryCatch, tryCatchAsync, tryFn, tryMap, tryMapAsync, unwrap, unwrapErr, unwrapOr, unwrapOrDefault, unwrapOrElse, unwrapOrThrow, zip };
 //# sourceMappingURL=index.mjs.map