ddidderr
75252a7651
Ports ZIG/src/lib_vt.zig and terminal/c/* as crates/ghostty-vt-capi (cdylib + staticlib + rlib, soname libghostty-vt.so) implementing the unchanged include/ghostty/vt.h + vt/*.h ABI: OSC parser, SGR parser, key events and key encoding, paste safety, colors, result codes - all 38 native symbols, plus the ghostty_wasm_* helpers on wasm32. Verification: - tests/abi.rs generates a C probe from the headers, compiled with cc, that checks sizeof/alignof/offsetof of every struct/union, every enumerator and #define against Rust, and links every declared symbol; nm -D exports equal the declared functions. - Ghostty's example/c-vt* programs compile unchanged against the Rust library (shared and static) and produce the expected output. - The wasm32 build runs Ghostty's wasm-key-encode/wasm-sgr example scripts unmodified under node (upstream's wasm-sgr tag table is stale vs sgr.h; a regenerated copy checks full output). Test Plan: - cargo test -p ghostty-vt-capi (22 unit + 2 ABI + 5 C + 3 wasm tests)
76 lines
1.6 KiB
C
76 lines
1.6 KiB
C
/**
|
|
* @file paste.h
|
|
*
|
|
* Paste utilities - validate and encode paste data for terminal input.
|
|
*/
|
|
|
|
#ifndef GHOSTTY_VT_PASTE_H
|
|
#define GHOSTTY_VT_PASTE_H
|
|
|
|
/** @defgroup paste Paste Utilities
|
|
*
|
|
* Utilities for validating paste data safety.
|
|
*
|
|
* ## Basic Usage
|
|
*
|
|
* Use ghostty_paste_is_safe() to check if paste data contains potentially
|
|
* dangerous sequences before sending it to the terminal.
|
|
*
|
|
* ## Example
|
|
*
|
|
* @code{.c}
|
|
* #include <stdio.h>
|
|
* #include <string.h>
|
|
* #include <ghostty/vt.h>
|
|
*
|
|
* int main() {
|
|
* const char* safe_data = "hello world";
|
|
* const char* unsafe_data = "rm -rf /\n";
|
|
*
|
|
* if (ghostty_paste_is_safe(safe_data, strlen(safe_data))) {
|
|
* printf("Safe to paste\n");
|
|
* }
|
|
*
|
|
* if (!ghostty_paste_is_safe(unsafe_data, strlen(unsafe_data))) {
|
|
* printf("Unsafe! Contains newline\n");
|
|
* }
|
|
*
|
|
* return 0;
|
|
* }
|
|
* @endcode
|
|
*
|
|
* @{
|
|
*/
|
|
|
|
#include <stdbool.h>
|
|
#include <stddef.h>
|
|
|
|
#ifdef __cplusplus
|
|
extern "C" {
|
|
#endif
|
|
|
|
/**
|
|
* Check if paste data is safe to paste into the terminal.
|
|
*
|
|
* Data is considered unsafe if it contains:
|
|
* - Newlines (`\n`) which can inject commands
|
|
* - The bracketed paste end sequence (`\x1b[201~`) which can be used
|
|
* to exit bracketed paste mode and inject commands
|
|
*
|
|
* This check is conservative and considers data unsafe regardless of
|
|
* current terminal state.
|
|
*
|
|
* @param data The paste data to check (must not be NULL)
|
|
* @param len The length of the data in bytes
|
|
* @return true if the data is safe to paste, false otherwise
|
|
*/
|
|
bool ghostty_paste_is_safe(const char* data, size_t len);
|
|
|
|
#ifdef __cplusplus
|
|
}
|
|
#endif
|
|
|
|
/** @} */
|
|
|
|
#endif /* GHOSTTY_VT_PASTE_H */
|