term244 — ネイティブ Windows 移植ロードマップ

term244(Ghostty フォーク)をネイティブ Windows で動かすための実装計画。 macOS 版(リブランド + HTML/Markdown ビューアタブ/ペイン)は完成済み。 Windows 版はここから着手する。

このドキュメントは Windows マシン側で作業を再開するための土台。 macOS のチャットセッションでは Windows のビルド・検証ができないため、実装そのものは Windows 環境で進めること。

現状サマリ

コア(プラットフォーム非依存): src/terminal/(VT パース・画面バッファ)、 src/Surface.zig、src/App.zig。Windows でもそのまま動く。
apprt(アプリ層): src/apprt/ に gtk(Linux)・embedded(macOS の Swift アプリが利用)・none のみ。Windows 用 apprt は存在しない ← 最大の不足。
レンダラ: src/renderer/ に Metal(macOS)と OpenGL(Linux/GTK)。

下回りはかなり揃っている。足りないのは「ガワ(GUI)」だけ。

要素	状態	場所
PTY (ConPTY)	✅ 実装済み	`src/pty.zig` の `WindowsPty`(`CreatePseudoConsole` 等)
プロセス起動	✅ 実装済み	`src/Command.zig` の `startWindows()`(`CreateProcessW` + ConPTY）
Win32 API シム	✅ あり	`src/os/windows.zig`
MSVC ABI	✅ ビルド設定済み	`src/build/Config.zig`(Windows で `abi = .msvc` 強制)
ターミナルコア	✅ 非依存	`src/terminal/`、`src/Surface.zig`、`src/App.zig`
Windows リソース雛形	✅ あり	`dist/windows/ghostty.rc`

Windows apprt — ウィンドウ生成・メッセージループ・入力・DPI・クリップボード・IPC。src/apprt/gtk/ が参照実装(Surface だけで ~1500 行）。
OpenGL の WGL コンテキスト経路 — src/renderer/OpenGL.zig の surfaceInit/threadEnter/threadExit/displayRealized が現状 GTK/embedded 専用 switch。Windows(WGL)ケースを追加。
apprt 選択の配線 — src/apprt.zig / src/apprt/runtime.zig / build.zig に .windows を追加。
フォント探索 — fontconfig は Linux 専用。Windows は DirectWrite でフォント列挙(src/font/)。ラスタライズは FreeType を流用可。
単一インスタンス IPC — D-Bus の代わりに名前付きパイプ or Mutex。

新規: src/apprt/windows.zig、src/apprt/windows/App.zig、 src/apprt/windows/Surface.zig。
App: Win32 メッセージループ(GetMessage/DispatchMessage)、ウィンドウクラス登録。
Surface: CreateWindowExW でウィンドウ生成、WndProc で入力 (WM_KEYDOWN/WM_CHAR/WM_MOUSE*)・リサイズ(WM_SIZE)・描画(WM_PAINT)・DPI(WM_DPICHANGED)を処理しコアへ転送。
参照: src/apprt/gtk/App.zig / src/apprt/gtk/Surface.zig と src/apprt/embedded.zig(コアが apprt に求めるメソッド一覧の把握に最適）。
apprt が実装すべき最小メソッド: deinit、core()、getTitle()、 getContentScale()、getSize()、getCursorPos()、supportsClipboard()、 clipboardRequest()、setClipboard()、defaultTermioEnv() ほかコールバック群。

src/renderer/OpenGL.zig の apprt 別 switch に .windows ケースを追加。
Surface の HWND → HDC 取得 → wglCreateContext(または WGL_ARB_create_context で 3.3+ コア)→ レンダラスレッドで wglMakeCurrent。
displayRealized 相当を Windows apprt 側から呼んで GL ロード (gl.glad.load、proc は wglGetProcAddress)。
D3D 新規バックエンドは不要。OpenGL で足りる。

src/font/backend.zig に Windows 用ディスカバリを追加。IDWriteFactory でシステムフォント列挙。ラスタライズは既存 FreeType を流用可。

クリップボード: OpenClipboard/GetClipboardData/SetClipboardData (CF_UNICODETEXT)。
単一インスタンス: 名前付き Mutex + 名前付きパイプで2個目の起動を転送。
dist/windows/ghostty.rc を term244 用に調整。アイコン。パッケージング。

W1(配線・骨格)→ W2(空ウィンドウが出る所まで)→ W3(GL でターミナル描画) → ここで「文字が出るターミナル」= 最初のマイルストーン → W4/W5 で実用度向上。

Zig 0.15.2(build.zig.zon の minimum_zig_version)。
W1 で windows apprt を追加後: zig build -Dtarget=x86_64-windows-msvc -Dapp-runtime=windows
当面は zig build で .exe を生成 → 直接実行。

ConPTY の使い方: Microsoft Windows Terminal リポジトリ(C++)。 CreatePseudoConsole とパイプ管理の正典。term244 側は実装済みなので主に「考え方」の参照。
apprt が実装すべき契約: src/apprt/embedded.zig(C-ABI 版・境界が明快)、 src/apprt/gtk/(フル apprt の実例)。
OpenGL on Windows: WGL_ARB_create_context、glad のロード。