Docs
/
TypeScript
Chapter 17

17 — Declaration Files & Ambient Types

Core Concepts

  • .d.ts files — type declarations without implementation
  • declare keyword — tells TS something exists without providing the code
  • @types packages — community-maintained type definitions (DefinitelyTyped)
  • Global declarations — make types available everywhere
  • Module declarations — provide types for untyped packages
  • Triple-slash directives — reference other declaration files

When You Need .d.ts Files

ScenarioSolution
Untyped npm packageInstall @types/package or write your own .d.ts
Global variables (window, env)declare global { ... }
CSS modules, imagesModule declaration: declare module "*.css"
Your own libraryGenerate with tsc --declaration