Understand the Three Versions Involved in Type Declarations

Overview

When working with TypeScript types, three versions must align: the version of the package you're using, the version of its type declarations (@types), and the version of TypeScript itself. Misalignment between these versions can cause confusing type errors even when the code works at runtime.

Understanding these three versions helps diagnose and prevent type compatibility issues.

The Three Versions

1. Package version - The runtime library (e.g., lodash@4.17.21)
2. @types version - Type declarations (e.g., @types/lodash@4.14.191)
3. TypeScript version - Your TypeScript compiler (e.g., typescript@5.2.2)

When to Use This Skill