Programando o TypeScript

Apêndice E. Diretivas de tripla barra

As diretivas de barra tripla são apenas comentários JavaScript normais que o TypeScript procura para fazer coisas como ajustar as definições do compilador para um ficheiro específico ou indicar que o teu ficheiro depende de outro ficheiro. Coloca as tuas diretivas no topo do teu ficheiro, antes de qualquer código. As diretivas de barra tripla têm o seguinte aspeto (cada diretiva é uma barra tripla, ///, seguida de uma etiqueta XML):

/// <directive attr="value" />

O Typescript suporta um punhado de diretivas de barra tripla. A Tabela E-1 lista as mais prováveis de serem usadas:

amd-module

Vai a "A diretiva amd-module" para saberes mais.

lib

A diretiva lib é uma forma de indicar ao TypeScript de qual dos libs do TypeScript o teu módulo depende, o que poderás querer fazer se o teu projeto não tiver um tsconfig.json. Declarar os libs dos quais dependes no teu tsconfig.json é quase sempre uma melhor opção.

path

Ao usar a opção outFile do TSC, use a diretiva path para declarar uma dependência de outro arquivo, de modo que o outro arquivo apareça mais cedo na saída compilada do que o arquivo dependente. Se o teu projeto utiliza imports e exports, provavelmente nunca utilizarás esta diretiva.

type

Vai a "The types Directive" para saberes mais sobre a diretiva type.

Tabela E-1. Diretivas de barra tripla

Diretiva	Sintaxe	Utiliza-o para...
amd-module	<amd-module name="MyComponent" />	Declara nomes de exportação ao compilar para módulos ...