¿Hay alguna ventaja de usar archivos de declaración sobre fuentes en TypeScript?

Al crear y publicar una biblioteca usando TypeScript hay 2 opciones:

1. Genera archivos de declaración d.ts junto con el archivo de javascript empaquetado y luego en package.json apunta a él con:

   "types": "./dist/mylib.d.ts"

2. No generes los archivos de declaración y apunta directamente al código fuente en package.json con:

   "types": "./src/index.ts"

¿Cuál es la ventaja de cada uno?

Respuesta #1

Sugiero la siguiente estrategia:

Paquete de biblioteca

En el paquete de la biblioteca, distribuya solo el JavaScript compilado con los archivos de declaraciones. Esto tiene la ventaja de reducir el tamaño del paquete mientras le da a los desarrolladores la opción de usar su biblioteca con JavaScript o TypeScript.

Repositorio de código

En el repositorio de código de la biblioteca, solo comitea los archivos fuente, no los archivos JavaScript compilados ni los archivos de declaraciones. Coloca instrucciones sobre cómo compilar la biblioteca en tu README, y quizás también un script que realice la compilación. Esto permitirá a otros desarrolladores modificar y usar tu biblioteca después de cualquier modificación que realicen.