tagged-unions

What problem does it solve?

Many codebases accumulate invalid state representations when using plain interfaces with optional properties. Tagging unions provides explicit relationships and safer narrowing to prevent runtime errors.

Core Features & Use Cases

• Explicit state variants with a literal tag to enable exhaustive checks.
• Safe narrowing through discriminated unions to guarantee correct data per state.
• Real-world example: modeling view states, API responses, or UI modes with distinct data for each variant.

Quick Start

Create a union type with a literal 'type' field for each variant and switch on 'type' to handle every case.