Πώς μπορείτε να παράγουν ένα .d.ts «τυποποιήσεις» αρχείο ορισμού από μια υπάρχουσα βιβλιοθήκη JavaScript;

Μπορείτε να χρησιμοποιήσετε είτε tsc --declaration fileName.tsσαν Ryan περιγράφει, ή μπορείτε να καθορίσετε declaration: trueκάτω compilerOptionsσε σας tsconfig.jsonμε την προϋπόθεση να έχετε ήδη ένα tsconfig.jsonπλαίσιο του σχεδίου σας.

Ο καλύτερος τρόπος για να ασχοληθεί με αυτό (αν ένα αρχείο δήλωσης δεν είναι διαθέσιμη στις DefinitelyTyped ) είναι να γράψει δηλώσεις μόνο για τα πράγματα που χρησιμοποιείτε και όχι το σύνολο της βιβλιοθήκης. Αυτό μειώνει το έργο πολύ - και επιπλέον ο compiler είναι εκεί για να βοηθήσει με την διαμαρτύρεται για τις μεθόδους που λείπουν.

Όπως λέει ο Ryan, ο compiler TSC έχει ένα διακόπτη --declarationο οποίος δημιουργεί ένα .d.tsαρχείο από ένα .tsαρχείο. Επίσης, σημειώστε ότι (με εξαίρεση bugs) γραφομηχανή υποτίθεται ότι είναι σε θέση να συγκεντρώσει Javascript, ώστε να μπορείτε να περάσετε τις υπάρχουσες javascript κώδικα για να τον compiler TSC.

όπως περιγράφεται στο http://channel9.msdn.com/posts/Anders-Hejlsberg-Steve-Lucco-and-Luke-Hoban-Inside-TypeScript στις 00:33:52 είχαν κατασκευαστεί ένα εργαλείο για τη μετατροπή WebIDL και WinRT μεταδεδομένων σε d.ts γραφομηχανή

Εδώ είναι μερικές PowerShell που δημιουργεί ένα ενιαίο αρχείο ορισμού γραφομηχανή μια βιβλιοθήκη που περιλαμβάνει πολλαπλά *.jsαρχεία με τις σύγχρονες JavaScript.

Πρώτον, αλλάξτε όλες τις επεκτάσεις .ts.

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

Δεύτερον, χρησιμοποιήστε το μεταγλωττιστή γραφομηχανή για να δημιουργήσει αρχεία ορισμού. Θα υπάρξει ένα μάτσο λάθη μεταγλώττισης, αλλά μπορούμε να αγνοήσουμε εκείνους.

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

Τέλος, συνδυάζουν όλα τα *.d.tsαρχεία σε ένα index.d.ts, αφαιρώντας τις importδηλώσεις και την απομάκρυνση του defaultαπό την κάθε δήλωση κατά την εξαγωγή.

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

Αυτό τελειώνει με ένα και μόνο, μπορεί να χρησιμοποιηθεί index.d.tsτο αρχείο που περιλαμβάνει πολλά από τους ορισμούς.

Θα δούμε για μια υπάρχουσα χαρτογράφηση των 3rd party JS βιβλιοθήκες που υποστηρίζουν Σενάριο # ή SharpKit. Οι χρήστες αυτών των C # για να .js cross compilers θα έχετε αντιμετωπίσει το πρόβλημα που αντιμετωπίζουμε τώρα και θα μπορούσαν να έχουν δημοσιεύσει ένα ανοικτό πρόγραμμα πηγής για τη σάρωση 3rd party lib σας και να μετατρέψει σε σκελετό Γ τάξεων #. Αν ναι χαράξει το πρόγραμμα σαρωτή για τη δημιουργία γραφομηχανή στη θέση της C #.

Σε αντίθετη περίπτωση, μεταφράζοντας ένα C # δημόσια διεπαφή για 3rd party lib σας σε ορισμούς γραφομηχανή θα μπορούσε να είναι πιο απλό από ό, τι κάνει το ίδιο με την ανάγνωση του κώδικα JavaScript.

Ιδιαίτερο ενδιαφέρον μου είναι πλαίσιο ExtJS RIA Sencha και ξέρω ότι εκεί έχουν έργα που δημοσιεύθηκε για να δημιουργήσει ένα C # ερμηνεία για Σενάριο # ή SharpKit

Όταν δημιουργείτε τη δική σας βιβλιοθήκη, μπορείτε να μπορεί να δημιουργήσει *.d.tsαρχεία χρησιμοποιώντας την tscεντολή (γραφομηχανή Compiler) όπως έτσι: (υποθέτοντας ότι χτίζετε τη βιβλιοθήκη σας στο dist/libφάκελο)

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

• -d( --declaration): Δημιουργεί τα *.d.tsαρχεία
• --declarationDir dist/lib: Κατάλογος εξόδου για τα αρχεία που δημιουργούνται δήλωση.
• --declarationMap: Δημιουργεί ένα sourcemap για κάθε αντίστοιχο αρχείο».d.ts'.
• --emitDeclarationOnly: Μόνο εκπέμπουν τα αρχεία δήλωση».d.ts'. (Αριθ καταρτίζονται JS)

(δείτε τα έγγραφα για όλες τις επιλογές της γραμμής εντολών μεταγλώττισης)

Ή, για παράδειγμα, που σου package.json:

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

και στη συνέχεια, εκτελέστε: yarn build:types(ή npm run build:types)