Wie produzieren Sie eine .d.ts „Typisierungen“ Definitionsdatei aus einer vorhandenen JavaScript-Bibliothek?

Sie können entweder tsc --declaration fileName.tswie Ryan beschreibt, oder Sie können festlegen , declaration: trueunter compilerOptionsin Ihrem tsconfig.jsonvorausgesetzt , Sie haben bereits ein tsconfig.jsonunter Ihrem Projekt.

Der beste Weg , damit umzugehen (wenn eine Deklarationsdatei auf nicht verfügbar ist DefinitelyTyped ) ist Erklärungen zu schreiben , nur für die Dinge , die Sie verwenden , anstatt die gesamte Bibliothek. Dadurch verringert sich die Arbeit viel - und zusätzlich der Compiler ist es durch beschweren sich über fehlende Methoden , um zu helfen.

Als Ryan sagt, hat die tsc Compiler einen Schalter , --declarationder eine erzeugt .d.tsDatei aus einer .tsDatei. Beachten Sie auch , dass (abgesehen von Bugs) Typoskript soll der Lage sein , Javascript zu erstellen, so dass Sie Javascript - Code vorhandene an den tsc Compiler passieren kann.

wie beschrieben in http://channel9.msdn.com/posts/Anders-Hejlsberg-Steve-Lucco-and-Luke-Hoban-Inside-TypeScript bei 00.33.52 hatten sie ein Tool zum Konvertieren WebIDL und WinRT gebaut Metadaten in Typoskript d.ts

Hier einige Powershell , die eine einzelne Typoskript Definitionsdatei eine Bibliothek erstellt , die mehrere enthält *.jsDateien mit modernen JavaScript.

Erstens ändern sich alle Erweiterungen .ts.

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

Zweitens verwenden, die Mitschrift Compiler-Definitionsdateien zu erzeugen. Es wird eine Reihe von Compiler-Fehler sein, aber wir können diejenigen ignorieren.

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

Schließlich vereint alle *.d.tsDateien in eine index.d.ts, die Entfernung von importAnweisungen und das Entfernen defaultvon jeder Export - Anweisung.

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 $_ }

Dieser endet mit einer einzigen nutzbaren index.d.tsDatei , die viele der Definitionen enthält.

Ich würde nach einer vorhandenen Abbildung Ihrer 3rd-Party-JS-Bibliotheken, das Script # oder SharpKit unterstützen. Ausführliche Informationen über diese C # Cross-Compiler .js das Problem, das Sie jetzt stehen haben konfrontiert und haben möglicherweise eine Open-Source-Programm zu scannen Ihre 3rd-Party-lib und konvertieren in Skelett C # -Klassen veröffentlicht. Wenn ja das Scanner-Programm hacken, um Typoskript anstelle von C # zu erzeugen.

dass Andernfalls könnte eine C # öffentliche Schnittstelle für 3rd-Party-lib in Typoskript Definitionen übersetzen einfacher sein als das gleiche zu tun, indem Sie die Quelle JavaScript zu lesen.

Mein besonderes Interesse ist ExtJS RIA Rahmen des Sencha und ich weiß, es wurden Projekte veröffentlicht eine C # Interpretation für Script # oder SharpKit zu erzeugen

Wenn Sie Ihre eigene Bibliothek erstellen, können Sie erstellen können *.d.tsDateien durch die Verwendung von tsc(Typoskript Compiler) Befehl wie folgt: (vorausgesetzt , Sie bauen Ihre Bibliothek in den dist/libOrdner)

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

• -d( --declaration): Erzeugt die *.d.tsDateien
• --declarationDir dist/lib: Ausgabeverzeichnis für generierte Meldungsdateien.
• --declarationMapErzeugt eine sourcemap für jede entsprechende‘.d.ts' file:.
• --emitDeclarationOnly: Nur ‚.d.ts' Deklarationsdateien emittieren. (Kein kompilierten JS)

(siehe die Dokumente für alle Kommandozeilen - Compiler - Optionen)

Oder zum Beispiel in der package.json:

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

und dann ausgeführt wird : yarn build:types(oder npm run build:types)