unthrown 5.0.0-beta.0 → 5.0.0-beta.10

package/README.md

@@ -10,6 +10,9 @@
 pnpm add unthrown
 ```
 
+No peer dependencies — the exhaustive error matcher is built-in and exported as
+`match` / `P`.
+
 ```ts
 import { fromPromise, P, TaggedError } from "unthrown";
 
@@ -22,23 +25,29 @@ const user = fromPromise(fetchUser(id), (cause, defect) =>
 
 const status = await user.match({
   ok: () => 200,
-  err: (matcher) => matcher.with(P._, () => 404), // `err` takes the exhaustive matcher
+  // `errCases` takes the exhaustive matcher — every case of E named:
+  errCases: (matcher) => matcher.with(P.tag("NotFound"), () => 404),
   defect: () => 500,
 });
 ```
 
 - **Errors as values** via `Result<T, E>` / `AsyncResult<T, E>`.
 - **A separate defect channel** for the unexpected — invisible to the type,
-  observable only via `match` / `recoverDefect`.
+  observable only via `match` / `recoverDefect` and the `tapDefect` /
+  `tapFailure` observers.
 - **Qualification at every boundary** — `fromPromise` / `fromThrowable` force you
   to triage each failure into a modeled error or a defect.
-- **Tagged errors** — `TaggedError(tag)` + `tag(t)`, folded exhaustively through
-  `match`'s ts-pattern error matcher.
-- One tiny runtime dependency (`ts-pattern`), ESM-first, dual CJS/ESM.
+- **Tagged errors** — `TaggedError(tag)` + `P.tag(t)`, folded exhaustively through
+  `match`'s built-in error matcher.
+- **Zero runtime dependencies** (the matcher is built-in), ESM-first, dual
+  CJS/ESM.
 
 See the [full documentation](https://btravstack.github.io/unthrown/) for the guide
 and complete API.
 
+**Upgrading from 4.x?** See
+[Upgrade from 4.x to 5.0](https://btravstack.github.io/unthrown/how-to/upgrade-to-v5).
+
 ## License
 
 [MIT](https://github.com/btravstack/unthrown/blob/main/LICENSE) © Benoit TRAVERS