gpui_hexeditor 0.1.0

A reusable hex editor widget for GPUI applications
Documentation 
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74

# gpui_hexeditor

A reusable hex editor widget built with `gpui` and `gpui_component`.

## Features

- Hex grid with optional ASCII pane
- Selection, drag selection, row selection
- Hex editing and ASCII editing
- Undo / redo
- Dirty byte tracking
- Internal scrolling with virtual rows
- Theme-aware styling via `gpui_component`
- Can either use fixed visible rows or fill the parent container height

## Installation

```toml
[dependencies]
gpui_hexeditor = "0.1.0"
```

## Quick Start

```rust
use gpui::Context;
use gpui_hexeditor::{HexEditor, HexEditorConfig};

fn build_editor(cx: &mut Context<MyView>) {
    let _editor = cx.new(|cx| {
        let mut config = HexEditorConfig::default().with_bytes_per_row(16);
        config.show_ascii = false;
        HexEditor::new(vec![0x48, 0x65, 0x78, 0x21], config, cx)
            .with_title("Hex Editor")
    });
}
```

## Configuration

`HexEditorConfig` supports:

- `bytes_per_row`
- `show_ascii`
- `show_toolbar`
- `show_status_bar`
- `read_only`
- `visible_rows`
- `fill_container`

Use `fill_container = true` when embedding the editor inside a panel that already controls height.

## Examples

```bash
cargo run --example basic
cargo run --example file_editor -- ./sample.bin
cargo run --example showcase
```

## Keyboard Shortcuts

- `Ctrl/Cmd + C`: copy selected bytes as hex text
- `Ctrl/Cmd + X`: cut selected bytes as hex text
- `Ctrl/Cmd + V`: paste hex text
- `Ctrl/Cmd + A`: select all
- `Ctrl/Cmd + Z`: undo
- `Ctrl/Cmd + Shift + Z`: redo
- `Home` / `End` / `PageUp` / `PageDown`: navigation
- `Backspace` / `Delete`: clear current byte

## License

MIT