これは TypeScript Advent Calendar 2020 の 20 日目の記事です。

こんにちわ、Matts966です。今回は型レベル計算でFluent APIを自動生成するtypelevelLRというプロジェクトに今年の初めあたりに出したプルリクエストがマージされないため、供養を行う記事です。

TL; DR

• Fluent APIとは、メソッドチェーンでいい感じのコードを書くためのDSLのような何か
• typelevelLRは、BNFっぽい記法でAPIの仕様を定義すると、構文安全なFluent APIを自動生成してくれるHaskell製ツール
• 今回はtypelevelLRのゲスト言語（生成される言語）として、TypeScriptを追加した話

目次

1. Fluent APIとは何か
2. typelevelLRとは何か
3. typelevelLRのゲスト言語にTypeScriptを追加した手順
4. コード生成にかかる時間の評価

Fluent APIとは何か

Fluent APIまたはFluent Interfaceとは、2005年にDDDで有名なEricEvansと『リファクタリング』などで知られるMartinFowlerによって提唱された（とWikipediaに書かれていた）概念で、メソッドチェーンによって簡単に記述できるDSLのようなAPIのことです。

特徴として、メソッドのレシーバがステートフルであることが挙げられます。例えば以下のJavaのコードのようにメソッド呼び出しによってバイト列を記述するコードが一例です。

java.nio.ByteBuffer
				.allocate(10)
				.put((byte)0)

Fluent APIを用いることで

• 可読性の向上
• コード補完によるユーザビリティの向上

といったメリットが得られます。