LSPづくりのためのメモ

LSPをどう実装したらいいのか1㍉もわからないので、関連しそうなことを片っ端から突っ込むスレ

参考にしたリンク

• Tree-sitter
  • 本家
  • https://tree-sitter.github.io/tree-sitter/
• tree-sitter-sql
  • PostgreSQLレベルの構文規則
  • https://github.com/m-novikov/tree-sitter-sql/blob/587f30d184b058450be2a2330878210c5f33b3f9/grammar.js
• lezer-parser/import-tree-sitter-scanner
  • tree-sitterからleser構文へ変換するツール
    • codemirrorのsyntax highlight用
  • https://github.com/lezer-parser/import-tree-sitter
  • なんかフォーク
    • https://github.com/milahu/lezer-parser-import-tree-sitter-scanner
• rain言語のcodemirror用LSP
  • https://github.com/rainlanguage/rainlang-codemirror
  • LSPはRust実装でwasm出力
    • https://github.com/rainlanguage/dotrain
• wasm-lspのチュートリアル (VS Code)
  • Using WebAssembly for Extension Development
    • https://code.visualstudio.com/blogs/2024/05/08/wasm
  • Using WebAssembly for Extension Development - Part Two
    • https://code.visualstudio.com/blogs/2024/06/07/wasm-part2
    • Rustのクレートlsp_typesを使った解説
    • lsp_types
      • https://docs.rs/lsp-types/latest/lsp_types/
  • サンプル
    • https://github.com/microsoft/vscode-extension-samples/tree/main/wasm-language-server
• duckdb本家のwasm-shellはwasmでduckdb-wasmと連携している
  • https://github.com/duckdb/duckdb-wasm/tree/main/packages/duckdb-wasm-shell
• The wasm-bindgen Guide
  • https://rustwasm.github.io/wasm-bindgen/introduction.html
• supabase-community/postgres_lsp
  • https://github.com/supabase-community/postgres_lsp
  • PostgreSQL特化LSP
  • Rust実装
    • wasm-bindgenつかってるから多分wasm
  • コード補完のための構文解析はtree-sitter-sqlを使用
  • Feature (サブクレートとして実装されている)
    • DB接続
    • コマンド実行 (command)
    • コード補完 (completion)
    • 診断表示 (diagnostics)
    • hover表示
    • inlay hint表示
    • lint
    • (などなど)
• sqls-server/sqls
  • https://github.com/sqls-server/sqls
  • 汎用DatabaseLSP
  • Go実装
  • Featur
    • https://github.com/sqls-server/sqls/blob/master/internal/lsp/lsp.go
    • hover表示
    • コード補完 (completion)
    • 定義へのリンク
    • コードアクション
    • コードレンズ
    • フォーマッター
    • コマンド実行 (command)
• Language Server Protocol の仕様 及び実装方法
  • https://zenn.dev/mtshiba/books/language_server_protocol
• 新しいマークダウンパーサーが必要な理由
  • Markdown LSPの話
  • https://meetup-jp.nhncloud.com/3341

tree-sitter

コード補完のための構文木構築にはtree-sitterが多く用いられている印象

• tree-sitterのパーザを作るためには専用のルール定義を用意する必要がある
  • ルールはEBNFライク
• duckdbはyaccでパーザを作っているため、変換が必要
  • 幸いにしてduckdb/third_party/libpg_query/grammar/grammar_out.outputを出力してくれている
  • Grammerセクションを入力にできる。
  • 必要に応じて、Terminals, with rules where they appearから終端記号を抽出
    • 大抵はGrammerセクションから抽出できる
• Grammerセクションの内容を扱いやすくするため、Jsonなどの汎用フォーマットで抜き出す。
• Grammer ASTをEBNFに変換する
• EBNFにtree-sitterの記述を付け足す。

これでなんかいけそうな雰囲気

組み込むと便利そうなやつ

• SQL formatter
  • sqruff
    • リンターもついてる
    • https://github.com/quarylabs/sqruff

wasm 関連

• wasm-bindgen で「この型が欲しいときはこう書く」集
  • https://blog.mudatobunka.org/entry/2024/12/08/200000
• WebAssembly JavaScript Interfaceについて - W3C WD要約と所感
  • https://zenn.dev/denham/articles/8ffc1b4db44a99
• Rustで学ぶWebAssembly Interface Type入門
  • https://zenn.dev/chikoski/articles/webassembly-interface-type-101
• The WebAssembly Component Modelの仕様
  • https://component-model.bytecodealliance.org/introduction.html

VSCode Extension関連

• duckdb-wasm を使った VSCode 拡張機能の作り方
  • https://zenn.dev/yuta_ura/articles/duckdb-wasm-in-vscode-extension
• Using Vite for bundling your Visual Studio Code extension
  • https://www.eliostruyf.com/vite-bundling-visual-studio-code-extension/
• Bundling Extensions
  • https://code.visualstudio.com/api/working-with-extensions/bundling-extension
• Modern VS Code extension development: The basics
  • https://snyk.io/jp/blog/modern-vs-code-extension-development-basics/
• VSCode for webのextension
  • https://code.visualstudio.com/api/extension-guides/web-extensions
• VSCode for desktopのextension
  • https://code.visualstudio.com/api/language-extensions/language-server-extension-guide

wasmのデバッグ

https://zenn.dev/kamenoko_dev/articles/e17e79f94603ae

wasm-packでビルド後、vite devで起動したサーバでもデバッグできる

vecode for webのextension

https://code.visualstudio.com/api/extension-guides/web-extensions