piotrwitek/utility-types
Utility Types
This is a TypeScript utility type library providing advanced type aliases and mapped types for complex object and union transformations. It implements specialized tools for creating branded nominal types, extracting type metadata, and performing set operations on union types.
The project distinguishes itself through a toolkit for recursive object transformations, allowing for the application of property constraints like read-only or optional status across deeply nested structures. It also provides a system for computing intersections, differences, and complements between union types to simulate mathematical set logic.
The library covers a broad range of type system capabilities, including object property filtering, shape comparison, and the extraction of class constructors and promise resolution types. It additionally includes utilities for value validation, such as detecting falsy or nullish values and identifying primitive types.
Features
- Recursive Mapped Types - Provides a toolkit for recursively applying property constraints across deeply nested object structures.
- Recursive Property Transformations - Enables recursive modification of properties in deep object structures to change mutability or requirement status.
- Object Type Transformations - Recursively applies property constraints like read-only or required status to nested object structures.
- Recursive Object Type Transformers - Provides a toolkit for applying property constraints like read-only or optional status to deeply nested object structures.
- Conditional Types - Provides type-level decision systems to select types based on evaluated conditions.
- Static Type Metadata Extractors - Retrieves constructor, return, and promise resolution types from classes and functions.
- Union Type Transformations - Provides utilities for manipulating, filtering, and aggregating properties across union types.
- Union Member Filtering - Includes utilities for filtering and transforming individual members of union types.
- Union Set Operations - Computes mathematical set-like operations such as differences and intersections between union types.
- TypeScript Advanced Type Features - Implements advanced TypeScript features including generics, conditional types, and mapped types for strong type safety.
- Mapped Type Transformations - Implements mapped type transformations for iterating over keys to reconstruct type structures.
- Type Intersection and Merging - Provides capabilities for combining multiple type definitions into a single composite structure.
- Branded Types - Implements branded types to distinguish between identical object structures using unique labels.
- Type-Level - Changes properties or nested structures to be either read-only or mutable via utility types.
- Asynchronous Type Extraction - Extracts the resolution type of a Promise at the type level.
- Constructor Extraction - Retrieves the constructor type of a class by analyzing the type of its instances.
- Object Key Extractors - Retrieves a union of object keys based on criteria like value type or mutability.
- Object Property Transformers - Provides utilities for filtering specific properties from objects at the type level.
- Shape Comparisons - Computes intersections and differences between two object types to identify shared or unique properties.
- Template Literal Types - Uses template literal types to generate and transform property keys at the type level.
- Union to Intersection Converters - Transforms a union type into an intersection type composed of all its constituent members.
- Element Type Extraction - Derives a union of all value types contained within an object, tuple, or array.
- Type Utilities - Collection of utility types for common development patterns.
Star history
How this analysis was created: This summary and feature list are AI-generated from collected project material and can contain mistakes. Stars, license and language are imported from GitHub. Inclusion does not mean that we have tested or audited this project. Check the source documentation for any feature you depend on. Learn more on our About page.
