btravstack · btravers · Jul 7, 2026
diff --git a/.changeset/api-types-facade-docs.md b/.changeset/api-types-facade-docs.md
diff --git a/.changeset/docs-beginner-friendly.md b/.changeset/docs-beginner-friendly.md
diff --git a/.changeset/document-combinator-surface.md b/.changeset/document-combinator-surface.md
diff --git a/packages/boxed/CHANGELOG.md b/packages/boxed/CHANGELOG.md
@@ -1,5 +1,14 @@
 # @unthrown/boxed
 
+## 3.0.2
+
+### Patch Changes
+
+- Updated dependencies [199c543]
+- Updated dependencies [4b6754a]
+- Updated dependencies [3fb471b]
+  - unthrown@3.0.2
+
 ## 3.0.1
 
 ### Patch Changes

diff --git a/packages/boxed/package.json b/packages/boxed/package.json
@@ -1,6 +1,6 @@
 {
   "name": "@unthrown/boxed",
-  "version": "3.0.1",
+  "version": "3.0.2",
   "description": "Boxed interop for unthrown",
   "keywords": [
     "boxed",

diff --git a/packages/core/CHANGELOG.md b/packages/core/CHANGELOG.md
@@ -1,5 +1,30 @@
 # unthrown
 
+## 3.0.2
+
+### Patch Changes
+
+- 199c543: Polish the generated API reference (comment-only): give the `Types`-section
+  aliases practical framing and examples (`OkView`/`ErrView`/`DefectView` note what
+  each guard narrows to; `OkOf`/`ErrOf`/`AsyncOkOf`/`AsyncErrOf` show a type-extraction
+  example), and group the `Result`/`AsyncResult` **type** aliases under the `Facade`
+  category alongside their companion objects, cross-linked so the value+type pairing
+  is clear.
+- 4b6754a: Improve the generated API reference: add `@category` grouping (Constructors,
+  Guards, Interop, Aggregate, Tagged errors, Facade, Types, …) to every exported
+  symbol, and give the standalone functions richer, convention-following `@example`
+  blocks (both Ok and Err branches, `// =>` output comments). Comment-only — no
+  runtime or type changes.
+- 3fb471b: Document the fluent combinators on the generated API reference. The method
+  surface every `Result` / `AsyncResult` carries is now exported as two
+  **documentation-only** types — `ResultMethods` (sync) and `AsyncResultMethods`
+  (async, with the `AsyncResult`/`Promise`-returning signatures) — categorized
+  under `Methods`, so the reference lists every combinator's signature and prose.
+  The `Result` / `AsyncResult` aliases and the `OkView`/`ErrView`/`DefectView`
+  variants link to them, and the async method docs link to their sync counterparts.
+  The "Choosing a combinator" guide stays the "which one do I reach for?"
+  cheat-sheet and links to these API sections.
+
 ## 3.0.1
 
 ### Patch Changes

diff --git a/packages/core/package.json b/packages/core/package.json
@@ -1,6 +1,6 @@
 {
   "name": "unthrown",
-  "version": "3.0.1",
+  "version": "3.0.2",
   "description": "Explicit errors as values, with a separate defect (panic) channel",
   "keywords": [
     "defect",

diff --git a/packages/effect/CHANGELOG.md b/packages/effect/CHANGELOG.md
@@ -1,5 +1,14 @@
 # @unthrown/effect
 
+## 3.0.2
+
+### Patch Changes
+
+- Updated dependencies [199c543]
+- Updated dependencies [4b6754a]
+- Updated dependencies [3fb471b]
+  - unthrown@3.0.2
+
 ## 3.0.1
 
 ### Patch Changes

diff --git a/packages/effect/package.json b/packages/effect/package.json
@@ -1,6 +1,6 @@
 {
   "name": "@unthrown/effect",
-  "version": "3.0.1",
+  "version": "3.0.2",
   "description": "Effect interop for unthrown",
   "keywords": [
     "effect",

diff --git a/packages/neverthrow/CHANGELOG.md b/packages/neverthrow/CHANGELOG.md
@@ -1,5 +1,14 @@
 # @unthrown/neverthrow
 
+## 3.0.2
+
+### Patch Changes
+
+- Updated dependencies [199c543]
+- Updated dependencies [4b6754a]
+- Updated dependencies [3fb471b]
+  - unthrown@3.0.2
+
 ## 3.0.1
 
 ### Patch Changes

diff --git a/packages/neverthrow/package.json b/packages/neverthrow/package.json
@@ -1,6 +1,6 @@
 {
   "name": "@unthrown/neverthrow",
-  "version": "3.0.1",
+  "version": "3.0.2",
   "description": "neverthrow interop for unthrown",
   "keywords": [
     "errors-as-values",

diff --git a/packages/oxlint/CHANGELOG.md b/packages/oxlint/CHANGELOG.md
@@ -1,5 +1,7 @@
 # @unthrown/oxlint
 
+## 3.0.2
+
 ## 3.0.1
 
 ## 3.0.0

diff --git a/packages/oxlint/package.json b/packages/oxlint/package.json
@@ -1,6 +1,6 @@
 {
   "name": "@unthrown/oxlint",
-  "version": "3.0.1",
+  "version": "3.0.2",
   "description": "oxlint plugin enforcing unthrown's conventions",
   "keywords": [
     "errors-as-values",

diff --git a/packages/pattern/CHANGELOG.md b/packages/pattern/CHANGELOG.md
@@ -1,5 +1,14 @@
 # @unthrown/pattern
 
+## 3.0.2
+
+### Patch Changes
+
+- Updated dependencies [199c543]
+- Updated dependencies [4b6754a]
+- Updated dependencies [3fb471b]
+  - unthrown@3.0.2
+
 ## 3.0.1
 
 ### Patch Changes

diff --git a/packages/pattern/package.json b/packages/pattern/package.json
@@ -1,6 +1,6 @@
 {
   "name": "@unthrown/pattern",
-  "version": "3.0.1",
+  "version": "3.0.2",
   "description": "ts-pattern integration for unthrown",
   "keywords": [
     "errors-as-values",

diff --git a/packages/standard-schema/CHANGELOG.md b/packages/standard-schema/CHANGELOG.md
@@ -1,5 +1,14 @@
 # @unthrown/standard-schema
 
+## 3.0.2
+
+### Patch Changes
+
+- Updated dependencies [199c543]
+- Updated dependencies [4b6754a]
+- Updated dependencies [3fb471b]
+  - unthrown@3.0.2
+
 ## 3.0.1
 
 ### Patch Changes

diff --git a/packages/standard-schema/package.json b/packages/standard-schema/package.json
@@ -1,6 +1,6 @@
 {
   "name": "@unthrown/standard-schema",
-  "version": "3.0.1",
+  "version": "3.0.2",
   "description": "Standard Schema (Zod, Valibot, ArkType, …) interop for unthrown",
   "keywords": [
     "arktype",

diff --git a/packages/vitest/CHANGELOG.md b/packages/vitest/CHANGELOG.md
@@ -1,5 +1,14 @@
 # @unthrown/vitest
 
+## 3.0.2
+
+### Patch Changes
+
+- Updated dependencies [199c543]
+- Updated dependencies [4b6754a]
+- Updated dependencies [3fb471b]
+  - unthrown@3.0.2
+
 ## 3.0.1
 
 ### Patch Changes

diff --git a/packages/vitest/package.json b/packages/vitest/package.json
@@ -1,6 +1,6 @@
 {
   "name": "@unthrown/vitest",
-  "version": "3.0.1",
+  "version": "3.0.2",
   "description": "Vitest matchers for unthrown",
   "keywords": [
     "errors-as-values",