Come si fa a produrre un .d.ts "tipizzazioni" file di definizione di una libreria JavaScript esistente?

È possibile utilizzare tsc --declaration fileName.tscome Ryan descrive, oppure è possibile specificare declaration: truesotto compilerOptionsnel vostro tsconfig.jsonsupponendo che hai già avuto un tsconfig.jsonsotto il vostro progetto.

Il modo migliore per affrontare questo (se un file dichiarazione non è accessibile DefinitelyTyped ) è quello di scrivere le dichiarazioni solo per le cose che si utilizza, piuttosto che l'intera libreria. Questo riduce il lavoro molto - e inoltre il compilatore è lì per dare una mano da lamentarsi metodi mancanti.

Come dice Ryan, il compilatore TSC ha un interruttore --declarationche genera un .d.tsfile da un .tsfile. Si noti inoltre che (i bug di blocco) dattiloscritto si suppone che sia in grado di compilare Javascript, in modo da poter passare codice javascript al compilatore TSC esistente.

come descritto nella http://channel9.msdn.com/posts/Anders-Hejlsberg-Steve-Lucco-and-Luke-Hoban-Inside-TypeScript a 00:33:52 avevano costruito uno strumento per convertire WebIDL e metadati in WinRT d.tS dattiloscritto

Ecco alcuni PowerShell che crea un unico file di definizione typescript una libreria che include più *.jsfile con JavaScript moderno.

In primo luogo, modificare tutte le estensioni .ts.

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

In secondo luogo, utilizzare il compilatore dattiloscritto per generare file di definizione. Ci sarà un sacco di errori di compilazione, ma possiamo ignorare quelli.

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

Infine, combinare tutti i *.d.tsfile in un unico index.d.ts, rimuovendo le importdichiarazioni e rimuovendo la defaultdi ogni istruzione di esportazione.

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

Questo finisce con un unico, utilizzabile index.d.tsfile che include molte delle definizioni.

Vorrei cercare un mapping esistente delle librerie JS 3 parti che supportano Script # o SharpKit. Gli utenti di questi C # per .js compilatori cross avranno affrontato il problema che ora faccia e potrebbero hanno pubblicato un programma open source per la scansione del 3 ° lib partito e convertire in scheletro classi C #. Se è così incidere il programma dello scanner per generare dattiloscritto al posto di C #.

In mancanza di ciò, traducendo un'interfaccia pubblica C # per il 3 ° lib parti in definizioni dattiloscritto potrebbe essere più semplice di fare lo stesso con la lettura della sorgente JavaScript.

Il mio particolare interesse è quadro ExtJS RIA di Sencha e so che ci sono stati progetti pubblicati per generare un C # interpretazione per Script # o SharpKit

Quando si crea una propria libreria, è possibile creare *.d.tsfile utilizzando il tsccomando di (dattiloscritto Compiler) in questo modo: (supponendo che si sta costruendo la tua libreria alla dist/libcartella)

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

• -d( --declaration): Genera i *.d.tsfile
• --declarationDir dist/lib: Directory di output per i file di dichiarazione generati.
• --declarationMap: Genera un Sourcemap per ogni file corrispondente' .d.ts'.
• --emitDeclarationOnly: Solo emettere file di dichiarazione' .d.ts'. (Senza JS compilato)

(vedere i documenti per tutte le opzioni della riga di comando del compilatore)

O per esempio nella vostra package.json:

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

e quindi eseguire: yarn build:types(o npm run build:types)