はじめに

Angularを使い始めて、「TypeScript簡単じゃん。他でも使うべ」と始めたら

Cannot find name 'hogehoge'.

とか

Namespace 'hoge' has no exported member 'fuga'.

とエラーが出てつまづきました。
さらに他のプロジェクトを覗いてみたら、import無しのtsファイルだったりしてわけわからない。

特にモジュールの参照や参照解決辺りで発生するエラーは、基本をしっかり理解できてないとトラブルシューティングするときかなりストレス感じます。
TypeScriptのモジュール解決のデモ

と、まさにストレスを感じているわけでして、そんな人（自分）のためにまとめ直してみる次第です。

混乱を招く2種類のモジュール

TypeScriptで「モジュール」と言った時、意味としては2種類あります。

数多ある解説記事やQ&Aがどちらを話題にしているのか気をつけないと、混乱に拍車がかかります。

以下のような記述が見えたら、内部モジュールを話題にしていると思ってよいです。

逆に上記がないときは、だいたい外部モジュールを話題にしていると思ってよいです。

内部モジュールと外部モジュールを組み合わせて使う方法です。

残念ながらできません。

module X {
  import { Foo } from 'foo'; 
}

こんなプログラムを書くと、コンパイルエラーになります。

TS1147: Import declarations in a namespace cannot reference a module.

ファイルの先頭にトリプルスラッシュ///コメントを入れます。
pathに内部モジュールを定義したファイル名を記述します。

foo.ts

module foo {
  export const X: number = 1234;
}

main.ts

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

export class Baz {
  public output() {
    console.log(foo.X);
  }
}

///はファイルの先頭にないと、ただのコメントになってしまいます。