Comment produire vous un .d.ts « typages » fichier de définition à partir d'une bibliothèque JavaScript existante?

Vous pouvez utiliser tsc --declaration fileName.tscomme Ryan décrit, ou vous pouvez spécifier declaration: truedans compilerOptionsvotre tsconfig.jsonsupposant que vous avez déjà eu un tsconfig.jsonsous votre projet.

La meilleure façon de traiter cette (si un fichier de déclaration n'est pas disponible sur DefinitelyTyped ) est d'écrire des déclarations que pour les choses que vous utilisez plutôt que l'ensemble de la bibliothèque. Cela réduit le travail beaucoup - et en plus le compilateur est là pour aider en se plaignant de méthodes manquantes.

Comme le dit Ryan, le compilateur tsc dispose d' un commutateur --declarationqui génère un .d.tsfichier à partir d' un .tsfichier. Notez également que (bugs barrant) tapuscrit est censé être en mesure de compiler Javascript, vous pouvez passer le code existant javascript au compilateur tsc.

comme décrit dans http://channel9.msdn.com/posts/Anders-Hejlsberg-Steve-Lucco-and-Luke-Hoban-Inside-TypeScript à 00:33:52 , ils avaient construit un outil pour convertir les métadonnées WebIDL et WinRT en tapuscrit d.ts

Voici quelques PowerShell qui crée un seul fichier de définition dactylographiée une bibliothèque qui comprend plusieurs *.jsfichiers avec JavaScript moderne.

Tout d' abord, changer toutes les extensions .ts.

Get-ChildItem | foreach { Rename-Item $_ $_.Name.Replace(".js", ".ts") }

En second lieu, utiliser le compilateur dactylographiée pour générer des fichiers de définition. Il y aura un tas d'erreurs du compilateur, mais nous pouvons ignorer ceux-ci.

Get-ChildItem | foreach { tsc $_.Name  }

Enfin, combiner tous les *.d.tsfichiers en un seul index.d.ts, en supprimant les importdéclarations et la suppression defaultde chaque déclaration d'exportation.

Remove-Item index.d.ts; 

Get-ChildItem -Path *.d.ts -Exclude "Index.d.ts" | `
  foreach { Get-Content $_ } | `
  where { !$_.ToString().StartsWith("import") } | `
  foreach { $_.Replace("export default", "export") } | `
  foreach { Add-Content index.d.ts $_ }

Cela se termine par un seul, utilisable index.d.tsfichier qui comprend un grand nombre de définitions.

Je chercherais une cartographie existante de votre 3ème partie JS bibliothèques qui prennent en charge Script # ou SharpKit. Les utilisateurs de ces C # pour .js compilateurs croisés face auront le problème que vous faites face maintenant et pourraient avoir publié un programme open source pour scanner votre lib 3ème partie et convertir en squelette C # classes. Si oui pirater le programme scanner pour générer tapuscrit en place de C #.

A défaut, la traduction d'un C # public interface pour votre 3ème partie lib dans les définitions de tapuscrit peut-être plus simple que de faire la même chose en lisant la source JavaScript.

Mon intérêt particulier est le cadre ExtJS RIA de Sencha et je sais qu'il ya eu des projets publiés pour générer une interprétation C # pour Script # ou SharpKit

Lorsque vous créez votre propre bibliothèque, vous pouvez créer des *.d.tsfichiers en utilisant la tsccommande (tapuscrit compilateur) comme ceci: ( en supposant que vous construisez votre bibliothèque au dist/libdossier)

tsc -d --declarationDir dist/lib --declarationMap --emitDeclarationOnly

• -d( --declaration): Génère les *.d.tsfichiers
• --declarationDir dist/lib: Répertoire de sortie pour les fichiers de déclaration générés.
• --declarationMap: Génère un Sourcemap pour chaque fichier « .d.ts' correspondant.
• --emitDeclarationOnly: Émettre uniquement les fichiers de déclaration » .d.ts de. (Pas compilé JS)

(voir les documents pour toutes les options du compilateur de ligne de commande)

Ou par exemple dans votre package.json:

"scripts": {
    "build:types": "tsc -d --declarationDir dist/lib --declarationMap --emitDeclarationOnly",
}

puis exécuter: yarn build:types(ou npm run build:types)