Al usar el sistema de módulos internos de TypeScript, puede evitar tener cualquier etiqueta <reference> en el código. Personalmente, hago esto porque no quiero codificar rutas (reales o absolutas) dentro del código mientras muevo cosas constantemente.

Una forma de hacerlo es asegurarse de que todos los archivos de declaración necesarios y los archivos fuente de TypeScript se pasen al compilador como argumentos durante el tiempo de compilación.

Usar gulp junto con gulp-typescript simplifica esta tarea. Puede establecer noExternalResolve en gulp-typescript en verdadero y crear tareas de gulp que tomen todos sus archivos .d.ts junto con sus fuentes y los canalicen al compilador. Cuando introduce tsd en su pila, solo necesita pasar el archivo tsd.d.ts que contiene referencias a todos los demás archivos de definición instalados a través tsd .

ACTUALIZACIÓN para TypeScript> = v1.5 : puede usar un archivo tsconfig.json , y el compilador obtendrá el orden correcto de las clases. Esto elimina la necesidad de usar gulp-typescript completo. Puede optar por tener todos los archivos enumerados explícitamente en el archivo tsconfig.json o dejar completamente de lado la propiedad de files para incluir todos los archivos *.ts/*.tsx dentro del directorio donde reside tsconfig.json (incluidas todas las subcarpetas).

Un ejemplo tsconfig.json puede tener este aspecto:

 { "compilerOptions": { "target": "ES5", "module": "commonjs", "lib": [ "es5", "es2015.promise", "dom" ] }, "include": [ "src/**/*.ts" ] }

Lo que he aprendido hasta ahora es que /// <referencia>-ing un módulo con comentarios de referencia no es un buen método.

Por ejemplo: en caso de que tenga un archivo Foo y un archivo Bar . Ambos archivos usan jquery, pero solo el archivo Foo tiene un comentario de referencia a jquery. Si el archivo Foo se elimina por alguna razón, su barra de archivos está rota porque falta la referencia.

Si está utilizando TypeScript> = 2.0, es mejor definir los archivos de definición de TypeScript (.d.ts) en su tsconfig.json en la sección "archivos" .

Esto podría verse así:

 { "compileOnSave": true, "compilerOptions": { "noImplicitAny": true, "noEmitOnError": true, "removeComments": false, "sourceMap": true, "target": "es5", "outDir": "./Scripts/" }, "files": [ "./src/foo.ts", "./src/bar.ts", "./Scripts/typings/jquery/jquery.d.ts", "./Scripts/typings/jqueryui/jqueryui.d.ts", "./Scripts/MicrosoftMaps/Microsoft.Maps.d.ts" ] }

El uso de la directiva /// (comentarios de referencia) se usa a menudo en ejemplos para que pueda comenzar rápidamente, pero no es una buena práctica. También muchos ejemplos provienen de una versión < TypeScript 2.0.

Algunos IDE detectan automáticamente todos los archivos de un proyecto (Visual Studio).

Para todo lo demás, puede crear un archivo _references.ts y poner todos sus comentarios de referencia allí; luego solo necesita agregar:

 /// <reference path="_references.ts" />

... a cada archivo (en lugar de posiblemente muchos).

Su IDE también puede admitir archivos tsconfig .