Los archivos .d.ts describen las formas de los tipos de bibliotecas JavaScript a TypeScript. Son la interfaz entre el ecosistema JS y el sistema de tipos de TS.

Anatomía de un .d.ts

Declaran tipos, interfaces, funciones y clases sin implementación. declare function, declare class, declare module. No generan código en el output.

Declaraciones de módulos

Para bibliotecas sin tipos nativos: declare module 'library-name' { ... }. TypeScript fusiona estas declaraciones con los imports.

Exportación de tipos

Usar export interface, export type, export default dentro de declaraciones de módulo. Archivos .d.ts de bibliotecas publicadas via DefinitelyTyped o incluidas.

Generación automática

tsc --declaration genera .d.ts desde código TS. declarationMap para navegación a fuente. Publicar tipos correctamente en package.json con types o typings.