npm - Bir TypeScript projesinde derleyici seçeneği "declaration"i true olarak ayarlamak için iyi bir sebep var mı?

Bir TypeScript projem var ve gelecekte bunu bir NPM paketi olarak yayınlamak isteyebilirim.

Şu anda tsconfig.json dosyamda "declaration": true olarak ayarlamış durumdayım. Ancak bu bana bazı sorunlar çıkarıyor (ki bunlar bu soru için gerçekten önemli değil).

Bunu false olarak ayarlarsam her şey istediğim gibi çalışıyor.

declaration bayrağı true olarak ayarlandığında, d.ts dosyaları oluşturur. Ancak benim anlayışıma göre, TypeScript'teki "*.d.ts" hakkındaki yazıya göre, bu yalnızca zaten TypeScript ile programlama yapmıyorsanız (yani projeniz JavaScript ise) önemlidir, böylece bu JavaScript kütüphanesini daha sonra bir TypeScript projesinde kolayca kullanabilirsiniz, çünkü artık tipleriniz vardır.

Peki proje "saf" TypeScript olduğunda, hiç kimse neden bu ayarı true olarak ayarlasın? Bunu false olarak güvenle ayarlayabilir miyim?

Cevap #1

Bir TypeScript projesinde derleyici seçeneği 'declaration'ı true olarak ayarlamak için iyi bir neden var mı?

Evet.

Özellikle NPM paketi olarak yayınlayacaksanız!

Gerekçe

NPM paketinizi oluşturduğunuzda, .js ve .d.ts dosyalarını dahil etmeli - ve .ts dosyalarını dahil etmemelisiniz. Bu, paketinizin gerçekten taşınabilir olmasını sağlar ve hem TypeScript projeleri hem de saf JavaScript projeleri tarafından kullanılabilmesini garanti eder.

Bu, TypeScript için NPM üzerinde önerilen paketleme mekanizmasıdır ve yayınlama ile ilgili daha fazla bilgi el kitabında bulunabilir.