TypeScript: varios proyectos en la solución

Question

He terminado de portar una biblioteca de JavaScript a TypeScript en Visual Studio 2012. En total, se trata de 60 clases, con cada clase definida en su propio archivo .ts.

Todas las clases se definen en el mismo módulo. Uso comentarios de referencia para reder a clases definidas en otros archivos. El diseño de cada archivo es el siguiente:

///<reference path='./../myotherclass.ts' /> 

module MyModule { 

    export class MyClass { 
     ... 
    } 

} 

Ahora he creado un segundo proyecto en la misma solución que va a ser la aplicación real usando mi biblioteca recién portado. Tengo que incluir mi biblioteca de alguna manera y supongo que para eso es el sistema de módulos. Sin embargo, no estoy seguro de qué archivo (s) importar como MyModule está distribuido en docenas de archivos. ¿Es esto para lo que puedo usar el archivo .d.ts?

Además, para poder importar un módulo, tiene que ser declarado con la palabra clave 'export', pero si lo hago, ya no se encuentra por los comentarios de referencia.

Además de todo eso, ambos proyectos deben compilarse para que la salida del compilador pueda usarse fácilmente con un cargador de módulos como requireJS.

¿Cuál es el mejor enfoque para lograr todo esto?

¡Gracias!

Answer 1

Ok, entonces permítanme comenzar diciendo que "Módulo" puede significar cosas diferentes. Por ejemplo, existe el "patrón de módulo" que es lo que crea su "MyModule". Por lo que yo sé, TypeScript se refiere a estos como "Módulos Internos" en la especificación del idioma, y ​​estos difieren de los "Módulos Externos" que usted estaría cargando con algo como RequireJS. La principal diferencia es que los módulos externos esperan tener su propio entorno aislado con un objeto predefinido de "exportación" que puedan usar para exportar su funcionalidad.

Echa un vistazo a la salida de su módulo:

var MyModule; 
(function (MyModule) { 
    var MyClass = (function() { 
     function MyClass() { } 
     return MyClass; 
    })(); 
    MyModule.MyClass = MyClass;  
})(MyModule || (MyModule = {})); 

Ves que está exportando las cosas en "MyModule", que se hizo disponible a nivel mundial a otro script archivos que cargue con, por ejemplo, una bloque html "script". Siendo que usted mencionó que tiene 60 de estos, probablemente también podría configurar el compilador para generar un único archivo que podría incluir en el marcado, en lugar de cargar cada archivo uno por uno.

Cambiando de tema, echar un vistazo a lo que ocurre a la salida si cambia su declaración módulo de "MyModule módulo {...}" a "MyModule módulo de exportación {...}":

(function (MyModule) { 
    var MyClass = (function() { 
     function MyClass() { } 
     return MyClass; 
    })(); 
    MyModule.MyClass = MyClass;  
})(exports.MyModule || (exports.MyModule = {})); 

Como ve, su módulo sigue usando el "patrón de módulo" pero se le asigna como miembro de "exportaciones", lo que significa que debe cargarse, por ejemplo, con la función "requerir" del nodo.

En este caso, usted quiere utilizar realmente su módulo con este código:

import wrapper = module("./MyModule"); 
var instance = new wrapper.MyModule.MyClass(); 

Anote el nombre "./MyModule" en realidad se refiere a la nombre (menos la extensión .js) del El módulo está definido en (es por eso que VS decía que no podía encontrar esos módulos para usted).El código debe compilar a algo como:

var wrapper = require("./MyModule"); 
var instance = new wrapper.MyModule.MyClass(); 

Para añadir a esto, ya no es siquiera realmente necesita hacer nada con la palabra clave "módulo" de tener un módulo. Simplemente podría exportar una función:

// foo.ts 
export function foo() { 
    ... 
}; 

// some other file in the same dir 
import wrapper = module("./foo"); 
var result = wrapper.foo(); 

Esto funciona porque la función de 'foo' será asignado directamente a las "exportaciones", que será alias de "contenedor" en el otro archivo.

Para agregar más a este confuso desorden de cosas relacionadas con los módulos, también debo mencionar que los módulos AMD son diferentes porque se cargan de forma asíncrona, a diferencia del nodo "requiere". Para hacer que TypeScript genere esos, tendrá que pasar un parámetro "--module AMD" al compilador.

De todos modos, espero haber explicado la situación lo suficientemente bien como para poder averiguar qué es exactamente lo que necesita/desea. El tipo de módulos que termines usando realmente dependerá de cómo los uses ... es decir, nodo, web o alguna combinación de ambos.