aboutsummaryrefslogtreecommitdiff
path: root/vendor/libghostty-vt/src/terminal/kitty/clipboard.zig
diff options
context:
space:
mode:
authorCan Celik <ogulcancelik@gmail.com>2026-09-10 21:51:57 +0300
committerGitHub <noreply@github.com>2026-09-10 21:51:57 +0300
commit425c86179791cd32e2d4ce0ae7f269940b4b0663 (patch)
treee52c4383a6d69216cbe2a32638bf90841d7e2189 /vendor/libghostty-vt/src/terminal/kitty/clipboard.zig
parent90e947a6e26e02f10ec7f1694c4eb5b78a86406b (diff)
chore: upgrade libghostty and preserve terminal behavior (#3906)
Diffstat (limited to 'vendor/libghostty-vt/src/terminal/kitty/clipboard.zig')
-rw-r--r--vendor/libghostty-vt/src/terminal/kitty/clipboard.zig82
1 files changed, 82 insertions, 0 deletions
diff --git a/vendor/libghostty-vt/src/terminal/kitty/clipboard.zig b/vendor/libghostty-vt/src/terminal/kitty/clipboard.zig
new file mode 100644
index 00000000..32cf8b90
--- /dev/null
+++ b/vendor/libghostty-vt/src/terminal/kitty/clipboard.zig
@@ -0,0 +1,82 @@
+//! Kitty clipboard protocol (OSC 5522).
+//!
+//! This implements the protocol semantics on top of the raw OSC capture:
+//! src/terminal/osc/parsers/kitty_clipboard_protocol.zig:
+//!
+//! The behavior here is modeled on the kitty reference implementation
+//! (kitty/clipboard.py) rather than only the prose spec, since the two
+//! disagree in places. Notable reference behaviors we reproduce:
+//!
+//! * Malformed metadata (any record without '=', including an empty
+//! metadata section) and an unknown or missing `type` silently drop
+//! the request with no response.
+//! * All base64 (payloads and the `mime`, `name`, and `pw` metadata
+//! values) is strict RFC 4648 per the spec's "Encoding of payloads"
+//! section: characters outside the standard alphabet (including
+//! whitespace) and incorrect padding are rejected, never silently
+//! skipped. An invalid value on `wdata` or `walias` aborts an
+//! in-flight write with EINVAL; an invalid `read` is dropped with
+//! no response since reads have no error status.
+//! * Decoded metadata and MIME-list payloads must be valid UTF-8. An
+//! invalid value on `wdata` or `walias`, or a `walias` without a
+//! target MIME type, aborts an in-flight write with EINVAL.
+//! * The `wdata` payloads for one MIME type form a single base64
+//! stream split at arbitrary packet boundaries; only the
+//! concatenation must be correctly padded. Like kitty (which
+//! resets its streaming decoder on EOF), a packet ending exactly
+//! at terminal padding restarts the stream, so independently
+//! encoded chunks also work.
+//! * `mime`, `name`, and `pw` metadata values are base64-encoded UTF-8;
+//! everything else is verbatim. Unknown keys are ignored.
+//! * `id` is sanitized by stripping characters outside [a-zA-Z0-9-_+.]
+//! and truncating to 512 bytes, then echoed verbatim in every
+//! response packet (omitted when empty).
+//! * A `type=write` silently replaces any in-flight transaction. A
+//! commit (`type=wdata` without a MIME type) with no in-flight
+//! transaction is silently ignored.
+//! * Responses never send a payload section for an empty payload,
+//! except the targets ('.') listing DATA packet which is always sent.
+//!
+//! Specification: https://sw.kovidgoyal.net/kitty/clipboard/
+
+const oscpkg = @import("../osc.zig");
+const protocol = @import("../osc/parsers/kitty_clipboard_protocol.zig");
+const command = @import("clipboard_command.zig");
+const write = @import("clipboard_write.zig");
+const response = @import("clipboard_response.zig");
+const grants = @import("clipboard_grants.zig");
+
+pub const OSC = protocol.OSC;
+pub const Operation = protocol.Operation;
+pub const Status = protocol.Status;
+pub const Terminator = oscpkg.Terminator;
+
+pub const Metadata = command.Metadata;
+pub const Payload = command.Payload;
+pub const readPromptExempt = command.readPromptExempt;
+pub const max_id_len = command.max_id_len;
+pub const max_pw_len = command.max_pw_len;
+pub const max_mime_len = command.max_mime_len;
+pub const max_name_len = command.max_name_len;
+
+pub const Content = write.Content;
+pub const WriteState = write.WriteState;
+pub const max_write_size = write.max_write_size;
+pub const max_write_mimes = write.max_write_mimes;
+pub const max_write_aliases = write.max_write_aliases;
+
+pub const Response = response.Response;
+pub const ReadSuccess = response.ReadSuccess;
+pub const PasteEvent = response.PasteEvent;
+pub const read_chunk_size = response.read_chunk_size;
+pub const max_read_mimes = response.max_read_mimes;
+pub const max_listing_mimes = response.max_listing_mimes;
+pub const targets_mime = response.targets_mime;
+
+pub const Grants = grants.Grants;
+pub const otp_len = grants.otp_len;
+pub const generateOtp = grants.generateOtp;
+
+test {
+ @import("std").testing.refAllDecls(@This());
+}