エディタ対応

Kagari はエディタ向けに 3 つの部品を提供します。

いずれも kagari 実行ファイルが必要です。インストールを参照してください。

言語サーバー

kagari lsp は、stdin と stdout で Language Server Protocol を話す言語サーバーを実行します。.kis と .kix で終わるファイルに対して、コマンド kagari を引数 lsp で起動するようエディタを設定してください。

機能

その他のリクエストには対応していません。サーバーはドキュメント全体を同期するので、保存していないテキストも反映されます。

言語サーバーにおけるプロジェクト

サーバーは、ルートに kagari.toml があるワークスペースフォルダごとにプロジェクトを読み込みます。また開いたファイルごとに、そのディレクトリから親ディレクトリへ kagari.toml を探して見つかったプロジェクトを読み込みます。ファイルは、それを含むプロジェクトのうちルートが最も深いものの一部として検査されます。kagari check と同様に、マニフェストのコンパイラオプションが適用されます。

どのプロジェクトにも属さないファイルには構文の診断だけが出ます。kagari.toml が不正な場合や別のツールチェインのバージョンを要求する場合、サーバーはそのエラーをエディタにメッセージとして表示します。

エディタがファイル監視に対応していれば、サーバーは .kis/.kix ファイル、kagari.toml ファイル、アセットディレクトリ内のファイルの作成と削除を監視します。そのため、アセットファイルを追加・削除すると診断が更新されます。kagari.toml が変更されるとプロジェクトを読み込み直します。

std のソースはコンパイラに内蔵されています。定義へ移動でそれを開けるように、サーバーはシステムの一時ディレクトリの kagari-std-<version> にコピーを書き出します。このコピーを編集しても効果はありません。

フォーマッタ

kagari fmt と言語サーバーの整形は同じフォーマッタを使います。rustfmt に似たスタイルで、設定項目はありません。

• 行はできる限り 100 桁に収まるように折り返されます。幅は表示幅で数えるため、全角文字は 2 桁です。
• インデントは 1 段につき 4 スペースです。
• グループ（引数リスト、フォーム、メソッドチェーン、ブロック）は、1 行に収まればそのまま 1 行にし、収まらなければ要素ごとに改行します。それに合わせてリストのカンマを追加・削除します。
• コメントはすべて保持され、属するコードに付いたままになります。コードと同じ行の後ろにあるコメントはその行末に残り、それ以外のコメントは次のトークンの前に残ります。
• 連続する空行は 1 行にまとめられます。行末に空白は残りません。ファイルはちょうど 1 つの改行で終わります（空のファイルは空のままです）。
• フォーム（s!、choice!、t![…]、UI フォーム）も整形されます。

構文エラーのあるファイルは決して整形されません。フォーマッタは整形後に出力を再パースし、入力と同じトークンとコメントを持つことを確かめます。一致しなければ（フォーマッタのバグです）エラーとして整形を拒否し、ファイルは変更されません。

コマンドラインのフラグは kagari fmt を参照してください。

Zed

tooling/zed-kagari の Zed 拡張機能は、.kis と .kix ファイル向けの Kagari 言語を提供します。tree-sitter 文法によるハイライト、アウトライン、インデント、括弧の規則と、言語サーバーです。

インストール手順:

1. kagari をインストールし、PATH に置きます（cargo install --path tooling/kagari-cli）。
2. Zed でコマンド zed: install dev extension を実行し、Kagari リポジトリの tooling/zed-kagari ディレクトリを選びます。

拡張機能は kagari lsp を起動します。別の実行ファイルや引数を使うには、Zed の settings.json で設定します。

{
  "lsp": {
    "kagari": {
      "binary": {
        "path": "/path/to/kagari",
        "arguments": ["lsp"]
      }
    }
  }
}

kagari が設定されておらず PATH にもない場合、Zed は `kagari` was not found on PATH と報告します。

その他のエディタ

LSP クライアントを持つエディタなら言語サーバーを使えます。ファイル拡張子 kis と kix に対してコマンド kagari lsp を登録してください。

構文ハイライトには tooling/tree-sitter-kagari の tree-sitter 文法（grammar.js と、src/ の生成済みパーサー）を使います。スコープは source.kagari で、.kis と .kix の両方を扱います。この文法向けのハイライト・アウトライン・インデント・括弧のクエリは tooling/zed-kagari/languages/kagari/（highlights.scm、outline.scm、indents.scm、brackets.scm）にあります。Neovim や Helix などのエディタでも、キャプチャ名をそのエディタの慣習に合わせて調整すれば再利用できます。