ShojiWMのアーキテクチャ

一言でいうと、ShojiWM は「速さが必要な部分を Rust で、見た目や挙動を TypeScript/TSX で書ける」Wayland コンポジターです。

このページでは、ShojiWM に興味を持った方に向けて、内部がどう動いているかを順を追って解説します。専門用語はそのつど補足するので、Wayland やコンポジターを初めて聞く方でも読み進められます。

そもそも「コンポジター」とは？

GUI のデスクトップでは、たくさんのアプリ（ブラウザ、ターミナル、ゲームなど）がそれぞれ自分の絵（ウィンドウ）を描きます。これらをひとつの画面に 重ね合わせて（composite して） 最終的な映像を作り、ディスプレイに表示する役割を持つソフトウェアが コンポジター です。

Wayland の世界では、このコンポジターが同時に「ウィンドウマネージャ（どのウィンドウをどこに、どんな大きさで置くか）」の役割も兼ねます。 ShojiWM はこの両方を担当します。

ヒント

Wayland 自体については Waylandとはを先に読むと理解がスムーズです。

ShojiWM は大きく4つの登場人物で成り立っています。

アプリ は標準の Wayland プロトコルを通じて ShojiWM と会話します。アプリ側は「相手が ShojiWM である」ことを意識する必要はありません。
Rust コア は、入力・ウィンドウ・描画といった「速くて壊れてはいけない」部分を担当します。
設定ランタイム（TypeScript） は、ウィンドウの見た目や挙動を決めます。 あなたが書くのはこの部分です。
最終的な映像は GPU で合成され、ディスプレイに出力されます。

ShojiWM の最大の特徴は、役割を 2つの層 にきれいに分けていることです。

層	言語	担当すること
コア	Rust + Smithay	Wayland プロトコル、入力処理、レイアウト計算、GPU 描画
設定	TypeScript/TSX	ウィンドウの装飾、配置ルール、エフェクト、キーバインド

なぜ分けるのでしょうか？

コア（Rust） は毎フレーム動く心臓部です。1秒間に何十回も実行されるため、速度とメモリ安全性が重要です。そこで Rust と、Wayland コンポジター用ライブラリ Smithay を使っています。
設定（TypeScript） は「見た目や好み」を表現する部分です。ここは書きやすさと柔軟さが大切なので、Web 開発でおなじみの TypeScript/TSX で書けるようにしています。React に似た書き心地で、ウィンドウの枠やボタンを組み立てられます。

この2つは 別々のプロセスとして動き、Unix ソケットという仕組みで会話します。

注記

プロセスを分けることで、設定（TypeScript）を書き換えて再読み込み（ホットリロード） してもコアは動き続けられます。セッションを落とさずに見た目を反復開発できる、というわけです。

ウィンドウの「枠・タイトルバー・影」などの装飾を 誰が描くか には2つの流儀があります。

ShojiWM は SSD を採用し、しかもその「どう描くか」を あなたの TypeScript コードに任せます。流れを時系列で見てみましょう。

アプリのウィンドウに変化が起きます（例：タイトルが変わった、フォーカスされた）。
コアがそのウィンドウのスナップショット（現在の状態の写し）を TS ランタイムへ送ります。
TS ランタイムが、あなたの書いた 合成関数 composition(window) を実行し、「このウィンドウをどう飾るか」を TSX で組み立てます。
結果を JSON（装飾ツリー） にしてコアへ返します。
コアがそれを受け取り、レイアウトを計算して GPU で描画します。

つまり、あなたが TSX で <WindowBorder> や <Button> を書くと、それが JSON に変換されてコアに渡り、実際の画面の枠やボタンになる、という仕組みです。

「タイトルが変わったら枠の表示も自動で変わってほしい」――こうした自動更新を支えているのが シグナル (signal) という仕組みです。

ポイントは「変化に関係する部分だけを再計算する」ことです。画面全体を毎回作り直すのではなく、必要な部分だけを更新するので効率的です。React の状態管理を触ったことがある方なら、感覚は近いはずです。

次に進むなら、設定の概要で実際のコードの書き方を見てみてください。