TypeScript を使っていると、結構必要になる型定義ファイル。 型定義が存在しなかったり、古かったりするライブラリを使って、苦労した経験があるひとは多いのではないでしょうか。
今回は、DefinitelyTyped にコントリビュートする機会が最近増えたので、個人的な手順をまとめておきます。
はじめに
まず、今回は新しい型定義ファイルを作成するケースを想定しています。
コントリビュートの仕方については、まず公式ドキュメントをさらりと眺めておいてください。 ただ、結構わかりにくいと思うので、これから順を追って説明していきます。
それから型定義が存在しない事を確認しましょう。
事前準備
型定義の Generator があるのでインストールしておく。 基本なくても大丈夫だと思いますが、フォルダやファイルヘッダーなど自動生成してくれて便利なので、インストールしておきましょう。
npm install -g dts-gen
DefinitelyTyped のリポジトリを clone して、トップのフォルダでdts-genコマンドを実行する。
dts-gen --dt --name my-package-name --template module
--templateの部分はいくつか指定があるのですが、あまり詳しく知らないです。 （この辺り、どの template 使ったらいいか、わかりやすいドキュメントがあるといいんだけどなー。）
(2017.11.23 追記)テンプレートっぽいの見つけたので貼っておきます。
generate した結果はこんな感じで、typesの下にディレクトリが作成されています。
DefinitelyTyped
types
my-package-name
index.d.ts
my-package-name-test.ts
tsconfig.json
tslint.json
index.d.ts を書く
さぁ、ここからは実際に型定義を作成していきます。型定義はindex.d.tsに定義します。
型定義の書き方についてはここでは紹介しませんが、内部構造が似ているライブラリを参考にすることが多いです。
index.d.ts をデバックする
型定義ファイルが出来上がったら、実際にプロジェクトに投入して正しく機能するかデバックします。実は、npmからインストールされた型定義ファイルは、node_modules/@typesの中に格納されています。
そのため、@typesの下にライブラリ名と同じフォルダを作成して、その中に作成したindex.d.tsを配置すると、あたかもnpmインストールしたような振る舞いをします。
test を書く
デバックも完了したら、PR を作成する準備に入ります。
コントリビュートするためには、型定義のテストを書く必要があります。テストは上のmy-package-name-test.tsに書きます。
テストというよりは、実際にライブラリを利用するようなコードを書きます。ライブラリの利用例をバリエーション豊かに書くといった感じです。
型定義で定義した内容を（なるべく）網羅したテストを書きます。
手前味噌ですが、自分が書いたテストを張っておきます。これも他のライブラリを見ながら書いていきます。
import * as React from "react";
import Alert from "react-s-alert";
const config = {
position: "top",
offset: 100,
stack: {
limit: 3,
spacing: 50,
},
effect: "genie",
beep: {
info: "beep.mp3",
error: "beep.mp3",
warning: "beep.mp3",
success: "beep.mp3",
},
timeout: 1000,
html: true,
onClose: () => {},
onShow: () => {},
customFields: {},
};
class Test extends React.Component {
render() {
return (
<div>
<Alert />
<Alert
{...config}
/>
</div>
);
}
}
Alert.info("I am a info message.", config);
Alert.error("I am an error message.", config);
Alert.warning("I am a warning message.", config);
Alert.success("I am a success message", config);
const index = Alert.info("Hello");
Alert.close(index);
Alert.closeAll();
(2017/11/15 現在のコードなので古くなっているかもしれません。最新はこちらから見れます)
Lint チェックをする
テストを書いたら Lint ツールを実行して最終確認をします。
npm run lint my-package-name
PR を作る
最後に DefinitelyTyped に対して PR を作成したら完了です。レビューなどで指摘がなければ、DefinitelyTyped にマージされて使えるようになると思います。
まとめ
型定義を作って DefinitelyTyped にコントリビュートする手順でした。
初めての時にプロセスを理解するまでに結構時間がかかったのでまとめてみました。 個人的には型定義のデバック方法を知れたのが一番の収穫でした。
いつもお世話になっている型定義なので、気軽に貢献できると嬉しいですね。