♻️ Share matcher internals

development/library.md

@@ -93,6 +93,27 @@ Each factory is two overloads whose order is load-bearing:
   not a sound "rejected" oracle for a factory. Factory-negative tests use
   `@ts-expect-error` call sites (the test file only — the general ban stands).
 
+## Shared internals
+
+#### Decision (2026-09)
+
+`src/matcher-shared.ts` holds the four universe-agnostic pieces both matchers
+use: `UnaryFn`, `PatternReturns`, `RedundantFallback`, `HandlerMap`.
+
+#### Why
+
+- `RedundantFallback`'s property name is the diagnostic, so one definition
+  keeps the two matchers' message from drifting; the other three appear verbatim
+  in both public signatures.
+
+#### Rejected
+
+- **A generic `Matcher<Universe>` over the interface pair, `Handlers`,
+  `Fallback` and `MustBePartial`.** Each is built from its own universe
+  (`PatternKey`/`PatternParam` vs `Tags`/`MapTaggedUnion`); abstracting over the
+  F-bounded `Handled` constraint that makes the remainder work risks the
+  contextual typing it exists to preserve.
+
 ## Tagged-union matcher
 
 #### Decision (2026-09)