Course contentsShow
← TypeScript
Lesson 82 of 1,7962. Setup and ToolingFree lesson

The --declaration Flag: Generating .d.ts Files

Learn how to emit type declaration files for libraries so consumers can use your code with full types.

The --declaration Flag: Generating .d.ts Files

You'll learn how to create type definition files so others can use your TypeScript library with full type safety.

What This Flag Does

When you write a TypeScript library that others will install via npm, they need to know what types your functions accept and return. The --declaration flag tells the TypeScript compiler to generate .d.ts files alongside your compiled JavaScript. These declaration files are like instruction manuals that describe the shape of your code without including the actual implementation.

Think of it this way: when you buy furniture from IKEA, you get the assembled pieces (your .js files) and an instruction diagram showing what each piece is and how they fit together (your .d.ts files). The diagram doesn't build the furniture, but it tells you exactly what you're working with.

How to Enable It

You can enable declaration file generation in two ways:

Via command line:

tsc --declaration

Via tsconfig.json:

{
  "compilerOptions": {
    "declaration": true
  }
}

When enabled, for every .ts file you compile, TypeScript creates a corresponding .d.ts file containing only the type information—no implementation code.

Why Library Authors Need This

If you publish a package without .d.ts files, consumers using TypeScript won't get autocomplete, type checking, or any IntelliSense benefits when using your library. They'll effectively be working blind, as if your library were plain JavaScript.

Key Takeaway: The --declaration flag generates .d.ts type definition files that allow TypeScript users to consume your library with full type safety and editor support—essential for any published package.