docs/vt: add OSC 52

Author: pluiedev

docs/nav.json

@@ -500,6 +500,11 @@
               "path": "/22",
               "title": "Change Pointer Shape (OSC 22)"
             },
+            {
+              "type": "link",
+              "path": "/52",
+              "title": "Query or Change Clipboard Data (OSC 52)"
+            },
             {
               "type": "link",
               "path": "/104",

docs/vt/osc/52.mdx

@@ -0,0 +1,41 @@
+---
+title: Query or Change Clipboard Data (OSC 52)
+description: Query or change data on clipboards.
+---
+
+<VTSequence sequence={["OSC", "52", ";", "Pt", ";", "Pd", "ST"]} />
+
+Query or change data on clipboards specified by `t` based on the
+value of `d`.
+
+`t` is a list of **zero or more** characters that each correspond to
+a different type of clipboard on the system. The meaning of each character
+in `t` as defined by xterm is as follows:
+
+| `t`     | Type                |
+|---------|---------------------|
+| `c`     | Standard clipboard  |
+| `p`     | Primary clipboard   |
+| `q`     | Secondary clipboard |
+| `s`     | Selection clipboard |
+| `0`–`7` | Cut-buffer `0`–`7`  |
+
+> [!NOTE]
+> Ghostty only recognizes `c`, `p`, and `s` as valid values in `t`.
+> Other types are treated as aliases for `c`. When `t` is omitted,
+> Ghostty defaults to querying or modifying the primary clipboard
+> (equivalent to `c`).
+
+> [!WARNING]
+> Ghostty currently only allows specifying one clipboard per sequence.
+> This is a limitation on our end and may be fixed in the future.
+
+When `d` is the single character `?`, the terminal will reply with
+another OSC 52 sequence with the data found from the first clipboard
+listed in `t` that contains the requested data.
+
+Otherwise, `d` is expected to be a Base64-encoded string that contains
+the new data for all clipboards listed in `t`.
+
+If `d` is neither a valid Base64-encoded string or the character `?`,
+all clipboards listed in `t` are cleared.

docs/vt/reference.mdx

@@ -79,6 +79,7 @@ introduce better organization and search capabilities.
 | [OSC 19][OSC 1x] | `OSC 19 ; Pc ST` | Query or change the highlight foreground color |
 | [OSC 21] | `OSC 21 ; Pk = Pv ; ... ST ` | Query or change any color using the Kitty Color Protocol |
 | [OSC 22] | `OSC 22 ; Pt ST ` | Change the pointer shape |
+| [OSC 52] | `OSC 52 ; Pc ; Pd ST ` | Query or change clipboard data |
 | [OSC 104] | `OSC 104 ; Pn ST` | Reset palette colors |
 | [OSC 105] | `OSC 105 ; Pn ST` | Reset special colors |
 | [OSC 110][OSC 11x] | `OSC 110 ST` | Reset the foreground color |
@@ -104,6 +105,7 @@ introduce better organization and search capabilities.
 [OSC 1x]: /docs/vt/osc/1x
 [OSC 21]: https://sw.kovidgoyal.net/kitty/color-stack/
 [OSC 22]: /docs/vt/osc/22
+[OSC 52]: /docs/vt/osc/52
 [OSC 104]: /docs/vt/osc/104
 [OSC 105]: /docs/vt/osc/105
 [OSC 11x]: /docs/vt/osc/11x