Programando o TypeScript

Apêndice D. Receitas para escrever arquivos de declaração para módulos JavaScript de terceiros

Este apêndice cobre alguns blocos de construção chave e padrões que aparecem repetidamente ao digitar módulos de terceiros. Para uma discussão mais profunda sobre a digitação de código de terceiros, vai a "JavaScript That Doesn't Have Type Declarations on DefinitelyTyped".

Uma vez que os ficheiros de declaração de módulo têm de viver em ficheiros .d.ts e por isso não podem conter valores, quando declara tipos de módulo precisa de utilizar a palavra-chave declare para afirmar que os valores do tipo dado são realmente exportados pelo seu módulo. A Tabela D-1 fornece um breve resumo das declarações regulares e seus equivalentes de declaração de tipo.

Tabela D-1. Typescript e seus equivalentes somente de tipo

.ts	.d.ts
var a = 1	declare var a: number
let a = 1	declare let a: number
const a = 1	declare const a: 1
function a(b) { return b.toFixed() }	declare function a(b: number): string
class A { b() { return 3 } }	declare class A { b(): number }
namespace A {}	declare namespace A {}
type A = number	type A = number
interface A { b?: string }	interface A { b?: string }

Tipos de exportação

O facto de o teu módulo utilizar exportações globais, ES2015 ou CommonJS afectará a forma como escreves os teus ficheiros de declaração.

Globais

Se o teu módulo apenas atribui valores ao espaço de nomes global e não exporta nada, podes simplesmente criar um ficheiro em modo script ...