mirrors/ghostty
1
0
Fork 0
mirror of https://github.com/ghostty-org/ghostty.git synced 2026-08-24 16:11:43 +00:00
Code Issues Packages Projects Releases Wiki Activity

terminal/kitty: dnd docs

Browse Source
This commit is contained in:
Mitchell Hashimoto
2026-08-22 09:35:06 -07:00
parent af8d28a940
commit db2f8be590
1 changed files with 0 additions and 23 deletions
Download Patch File Download Diff File Expand all files Collapse all files

23
src/terminal/kitty/dnd.zig
View File

@@ -1,8 +1,6 @@
//! Kitty drag and drop protocol (OSC 72).
//!
//! Specification: https://sw.kovidgoyal.net/kitty/dnd-protocol/
//! Reference implementation: kitty/dnd.c and kitty/screen.c in
//! https://github.com/kovidgoyal/kitty (introduced in kitty 0.47).
//!
//! The protocol lets a program running in the terminal participate in
//! native OS drag and drop. A client registers to accept drops (t=a);
@@ -10,27 +8,6 @@
//! (t=M) to it and serves the dropped data on request (t=r), instead
//! of the traditional behavior of pasting dropped paths or text.
//!
//! The implementation is split into:
//!
//! * dnd_command.zig: metadata grammar and typed command decoding,
//! including chunk reassembly. The grammar mirrors kitty's
//! generated parser exactly.
//! * dnd_response.zig: wire encoding for everything the terminal
//! sends, mirroring kitty's send_payload_to_child chunking.
//! * dnd_drop.zig: the per-terminal protocol state machine, driven
//! by client OSCs on one side and native drag events from the
//! embedder on the other. It is allocated when a client registers
//! to accept drops and freed when it unregisters, so terminals
//! that never see the protocol pay nothing for it.
//!
//! The wire behavior was validated against kitty's implementation
//! (kitty_tests/dnd.py is the oracle), including its deviations from
//! the published spec: the MIME list payload is sent on every move
//! event with a trailing space after each entry, a missing `t` key
//! ignores the command rather than defaulting to `a`, empty payloads
//! omit the `;` and `m=` entirely, and registration survives a
//! terminal reset (RIS clears only the chunk-reassembly flag).
//!
//! ## Divergences
//!
//! These will be fixed in the future: