Respuesta.

Namespace (espacio de nombres) es un mecanismo de organización del código que apareció en la época del código pre-ES6 para agrupar entidades lógicamente relacionadas. Ayuda a estructurar grandes proyectos, agrupando clases, funciones, interfaces y tipos dentro de un único espacio de nombres, para evitar conflictos de nombres y hacer el código más legible.

Historia del tema: antes de la llegada de los estándares de JavaScript ES6, los desarrolladores utilizaban IIFE, objetos y espacios de nombres para simular la modularidad. TypeScript introdujo la palabra clave namespace (anteriormente internal module) para agrupar código.

Problema: los módulos modernos (ES6 Module) se han convertido en el estándar, y ambos enfoques (namespace y módulo) existen en paralelo, lo que causa confusión al diseñar la arquitectura: ¿cuándo es mejor usar namespace y cuándo módulo?

Solución: Los namespaces siguen siendo útiles para agrupar funciones y tipos auxiliares en proyectos puramente de TypeScript (por ejemplo, al generar archivos JS únicos mediante la salida outFile). Para dividir el código entre archivos, especialmente al trabajar con npm y los empaquetadores modernos, es más correcto utilizar módulos. Los namespaces se aplican a menudo en bibliotecas internas, declaraciones de tipos y situaciones en las que se necesita estructuración dentro de un solo archivo o en código antiguo.

Ejemplo de código:

namespace MyMath {
  export function add(a: number, b: number) {
    return a + b;
  }
}

console.log(MyMath.add(2, 3)); // 5

Características clave:

Permite agrupar código lógicamente relacionado
Puede contener clases, tipos, funciones, constantes
Se utiliza con la opción outFile, rara vez en proyectos modernos con módulos

Preguntas con trampa.

Si se combinan namespaces de diferentes archivos, ¿habrá un solo namespace o varios?

TypeScript realiza declaración de fusión — cuando el nombre coincide, diferentes partes del espacio de nombres se combinan en uno solo, si están correctamente conectadas y se encuentran en el mismo ámbito.

// mathA.ts
namespace MathUtil {
  export function sum(a: number, b: number) {
    return a + b;
  }
}

// mathB.ts
namespace MathUtil {
  export function mul(a: number, b: number) {
    return a * b;
  }
}
// Después de compilar, MathUtil contiene ambos métodos

¿Se puede usar import/require para namespace como para un módulo?

No, los namespaces no tienen exportación por defecto/exportación nombrada, no se pueden importar con la sintaxis estándar de ES6. Namespace es un concepto puramente de TypeScript que no se traduce en módulos de JavaScript.

¿Se pueden importar valores de namespace en otro archivo a través de import?

No, para acceder a un namespace desde otros archivos se requiere el uso de referencia (/// <reference path="..." />) o la compilación con outFile, la importación a través de import es imposible.

Errores comunes y anti-patrones

Mezclar namespaces y módulos en un mismo proyecto
Intentar importar namespaces como módulos
Usar namespaces para cada pequeña parte del código (fragmentación)

Ejemplo de la vida real

Caso negativo

En un proyecto antiguo, la lógica se dividió en decenas de namespaces, los mismos nombres aparecieron en varios archivos, lo que a veces causó una fusión inesperada o conflictos. Al pasar a una arquitectura modular, la migración del código se volvió muy laboriosa.

Ventajas:

Agrupamiento rápido de funciones
Sencillez para pequeños scripts

Desventajas:

Se confunde con módulos reales
Difícil de escalar
Complejidad en la gestión de dependencias entre archivos

Caso positivo

En una gran biblioteca, se declaró la API a través de declaraciones de namespace en un solo archivo index.d.ts, unificando todos los tipos e interfaces sin código de implementación. Esto permitió tipar rápidamente a los consumidores de la biblioteca y actualizar fácilmente el contrato entre equipos.