Hyperターミナルのプラグインを作ってみよう！

# Hyperとは
[Hyper](https://hyper.is)(旧HyperTerm)とは、[ZEIT](https://zeit.co)が開発しているHTML+JavaScript(Electron)で作られたクールなターミナルソフトだよ。最近、[v2にバージョンアップ](https://applech2.com/archives/20180423-terminal-hyper-v2-release.html)して、描画速度や日本語対応が進み、普段使いもできそうな感じになってきてるんだ。
なんといってもHyperの魅力は、Web系の知識(React & Redux)が少々あれば、かなり自由にプラグインを作れることだね:yum:
tmuxやらvimやらpowerlineを頑張ってカスタマイズしてCUI環境をつくるのには疲れたよーという人は試してみると幸せになれるかも。

# Pluginをつくってみよう
日本語の記事では[ピカチュー化](https://qiita.com/chanuu/items/b5c3d11e089ad0c7356d)とか[触ってみた](https://qiita.com/yuricode_/items/0ad209a213eae2cff689)とか[コンフィグ説明](https://liginc.co.jp/378082)はあるけど、プラグインの作り方は見つけられなかったので、簡単なプラグインを作ってわかったプラグイン作成の手順を紹介するよ。
簡単なサンプルとして、ターミナルの右下にキャラクター([アグレッシブ烈子](https://www.sanrio.co.jp/character/aggressiveretsuko/))を表示し、コマンド入力結果に応じてキャラクターの表示内容を変化(デスボイスモード)させるというプラグインをつくってみたよ。頑張って作り込めば[デスクトップマスコット伺か](https://matome.naver.jp/odai/2134175112391384201)的なやつのターミナル版が作れるかも:wink:
![HyperDemo3.gif](https://qiita-image-store.s3.amazonaws.com/0/160451/c6483c6c-7f38-5bdc-3674-c5d24e642bcd.gif)

以下の手順は素人による「やってみた」系なので、正しい仕様は[本家のドキュメント](https://hyper.is)を参考にしてください :bow:
また、以下のコード例は雰囲気を伝えるのが目的なので、色々省略しています。実際のサンプルコードは[こちら](https://gist.github.com/vimyum/d575935a53edc13925058495281b14fc)をみてね。

# 手順１：自作プラグイン読み込み
Hyperを起動すると、ホームディレクトリ以下に`~/.hyper_plugins/local`というディレクトリが作られるよ。その下に作りたいプラグイン名でディレクトリを作ろう。今回はプラグイン名を「mascot」にするよ。その下に、index.jsを作成し、ここにプラグインの中身を書こう。

```bash
mkdir ~/.hyper_plugins/local/mascot
vim ~/.hyper_plugins/local/mascot/index.js
```

index.jsでは、HyperのAPIにしたがって何かexportする必要があるようだ。とりあえず、コンフィグをPluginから設定する`decorateConfig`をエクスポートして、カーソルの色を黄色にしてみよう。

```js
// index.js
exports.decorateConfig = (config) => {
  return Object.assign({}, config, { //元のconfigを保持するため
    cursorColor: 'yellow',
  });
}
```

あとはこのプラグインを有効にするために`~/.hyper.js`の設定で`localPlugins`に追加しよう。

```js
// ~/hyper.js
  localPlugins: ["mascot"],
```

これでHyperのカーソル色が黄色になっていればOKだ。

# 手順2：キャラクターを表示する

HyperはReactコンポーネントの集合からできていて、各コンポーネント名の前に`decorate`をつけた関数で、そのコンポーネントのHOC(Higher Order Component：コンポーネントを引数に受け取り、修飾したコンポーネントを返す関数)を定義できるんだ。Hyperのプラグインは基本的にHOCを定義して既存のコンポーネントを修飾するようだね。
コンポーネントにはTabやHeader、Notificationsなどがあるけど、今回はターミナルのメイン部分にキャラクター要素を追加したいので、Term要素のHOCを定義するよ。

```jsx
// ~/hyper_plugins/local/mascot/index.js
exports.decorateTerm = (Term, { React, notify }) => {
    return class extends React.Component { // HOCを返す
        render () {
            const children = [
                 React.createElement("img", {src: "/path/img.png"}), //★画像要素を追加！
                 React.createElement(Term, this.props}), //もとの要素
            ];
            return React.createElement("div", null, children);
        }
    }
}
```

上の例ではTermコンポーネントのHOCを定義して、もとのTermに加えて`<img src="/path/img.png" />`を表示するように修飾しているよ。
babelとかで勝手に変換してくれないので、jsxとかを使うときは要注意だね。

# 手順3：ターミナルの入力を検知する 
PluginではReduxのmiddlewareを定義でき、そこでユーザ入力などのイベント(Action)などを取得することができるんだ。ただ、ユーザの入力は１文字づつなので、これを取得してもあまり意味がない:cry: 入力の結果として画面に表示される文字列を検知して処理を開始することが一般的なようだ。画面に表示される文字列はActionType`SESSION_ADD_DATA`で呼ばれるよ。

```js
// ~/hyper_plugins/local/mascot/index.js
exports.middleware = store => next => (action) => {
    if (action.type === 'SESSION_ADD_DATA') {
        if (/.*: .* No such file or directory/.test(action.data)) { // 検知
            store.dispatch({
                type: 'CHANGE_MASCOT_FEEL',
                skin: 'angry',
                speech: 'んなぁファイルねぇぇぇぇぇ”ぇ”!',
            });
        }
    }
    next(action);
}
```

上の例では、指定したファイルが存在しない時にzshで表示されるエラーメッセージを正規表現で検知して、新しいAction(CHANGE_MASCOT_FEEL)を発行しているよ。汎用的に作るにはbashやfishなんかのエラーメッセージにも対応する必要があるね。
`next(action)`は他のミドルウェアに処理を継続させるのに必要だけど、これを省略することで、例えばエラーメッセージの表示を抑止することもできるんだ。例えば、独自コマンドを作る場合は`/zsh: command not found: .*/`で検知した上でエラーメッセージを抑止することで独自コマンドを実現できるよ。

# 手順3：キャラクターを動かす

先の手順で発行したAction(CHANGE_MASCOT_FEEL)をReducerで受け取り、StateをPropsとしてコンポーネントに流し込むことで、HOC内でstateに応じた処理を行うよ。
Reducerの定義は`reduceUI`に記述するよ。stateは`mapTermsState`によりTermsコンポーネントに流し込まれるため、それを孫であるTermコンポーネントに渡すには`getTermProps`が必要になるね。

```js
// ~/hyper_plugins/local/mascot/index.js
exports.reduceUI = (state, action) => {
  switch (action.type) {
    case 'CHANGE_MASCOT_FEEL':
      const {skin, speech} = action;
      return state.set('mascotState', { skin, speech});
    default:
      return state;
  }
};

// stateをTermsコンポーネントのpropsにマップ
exports.mapTermsState = (state, map) => Object.assign(map, {
  mascotState: state.ui.mascotState,
});

// 親コンポーネントから子(TermGroup)、孫(Term)へとpropsを渡す
const passProps = (uid, parentProps, props) => Object.assign(props, {
  mascotState: parentProps.mascotState,
});
exports.getTermGroupProps = passProps;
exports.getTermProps = passProps;
```

これで、HOCの中からmascotStateを参照できるようになったね。例えば下のように利用するよ。

```jsx
// ~/hyper_plugins/local/mascot/index.js
exports.decorateTerm = (Term, { React, notify }) => {
    return class extends React.Component {
        render () {
            const skin = this.props.mascotState.skin == 'angry' ?
                 "/path/angry.png" : "/path/normal.png"; //★stateにより画像を決定
            const children = [
                 React.createElement("img", {src: skin}), 
                 React.createElement(Term, this.props}), 
            ];
            return React.createElement("div", null, children);
        }
    }
}
```

# 完成！
以上、こんな感じの手順でプラグインを作っていくことができるよ。すべてHTML + JavaScriptなので、例えばキャラクターをクリックしてイベントを発生させたり(onClick)とか、WebAudioでキャラクターに音声を喋らせたりすることも簡単にできそうだね。
今回つくったサンプルは[こちらのGist](https://gist.github.com/vimyum/d575935a53edc13925058495281b14fc)にあげました。上記の説明ではCSSとか一切触れていないので、こちらをみてください。
ぜひみんなもいろんなプラグインをつくってHyperを盛り上げよう:rocket: