mattpocock/ts-reset
Ts Reset
ts-reset is a TypeScript type enhancement library that overrides and augments the built-in type definitions for standard JavaScript APIs. Its core purpose is to replace unsafe any return types with stricter alternatives like unknown, forcing developers to explicitly validate data before using it. The library achieves this through global type augmentation and declaration merging, applying changes across the entire project without requiring per-file imports.
The library differentiates itself by targeting specific pain points in everyday TypeScript usage. It relaxes type constraints on array methods like includes and indexOf for readonly arrays, allowing membership checks and index lookups with values that don't match the array's element type. Similarly, it widens Map.has and Set.has to accept broader value types during existence checks. For array filtering, it injects Boolean as a type predicate, narrowing filtered results to exclude falsy values. On the safety side, it hardens browser storage API return types and changes JSON.parse and Response.json to return unknown instead of any, preventing unsafe access patterns.
The broader capability surface includes conditional type narrowing for standard APIs, type predicate injection into filter callbacks, and stricter type guarding for Array.isArray checks. These changes collectively enforce a more rigorous type safety posture for common JavaScript operations without requiring manual type annotations or wrapper functions. The library is distributed as a single package that can be added to any TypeScript project, applying its type improvements globally through declaration merging.
