TypeScriptでの `isolatedModules` エラーの解決方法

TypeScriptで開発を進める際には、isolatedModules フラグに関連するエラーに遭遇する可能性があります。
この記事では、型の再エクスポートにおいてこのフラグが有効の場合に生じる一般的なエラーとその解決方法について解説します。

エラーの詳細

以下のようなエラーメッセージが表示されることがあります

error TS1205: Re-exporting a type when 'isolatedModules' is enabled requires using 'export type'

このエラーは、isolatedModules フラグが有効な状態で型を再エクスポートしようとしたときに発生します。

isolatedModules フラグが有効の場合、TypeScriptは各ファイルを独立したモジュールとして扱い、型情報はコンパイル時に削除されます。
したがって、型の再エクスポートには特別な構文が求められます。

次のコードは、型を通常の方法で再エクスポートしようとしています

export { MyType } from './types';

この場合、MyType が型であれば、上記のエラーが生じます。

この問題を解決するためには、export type 構文を使用して型を再エクスポートする必要があります。
上記のコードを修正すると以下のようになります

export type { MyType } from './types';

この変更により、isolatedModules フラグが有効でも、TypeScript コンパイラが MyType を型として認識し、エラーが解消されます。

isolatedModules フラグが有効なTypeScript環境では、型の再エクスポートには export type 構文の使用が必要です。
これにより、型と値の区別が明確になり、コンパイルエラーを防ぐことができます。