Skip to main content
TermRock
GitHub
ComponentsData

Component · Data

Hex Viewer

Offset + hex + ASCII with cursor brackets.

Kind
widget
Input
interactive
Canvas
120×40

Live preview

Loading terminal preview.

Static terminal poster. Choose Run live to start the Rust demo.

Ghosttyhex-viewer/basic
Loading terminal poster…
○ loading posterNo input — rendered state only
Hex Viewer · exact mounted Rust story
01 · Purpose
What it is for
Offset + hex + ASCII with cursor brackets.
Best fit: Data · data · widget
02 · Behavior
What the mounted story proves
  1. 01
    HexViewer
    Representative 120×40 terminal state.
  2. 02
    Passive paint
    No keyboard or pointer action is claimed by this representative story.
  3. 03
    Evidence stays explicit
    1 covered · 9 partial · 5 missing axes.
03 · Implement
Install, then start from exact code
Install
cargo add termrock --git https://github.com/tailrocks/termrock.git --rev 5283c2acf9154d0cfcd37b1ffe821c00faf90ea2
Add TermRock once. Keep domain effects in the host application.
Minimal implementation
Exact Rust setup used by hex-viewer/basic.
Open to load code.
04 · Adapt
Variants and composition
Variants
Use the preview Variant menu when alternate registered stories exist. Each selection mounts a fresh configuration.
Composition
Data · data · widget
05 · Reference
API, tokens, accessibility
API
HexViewerOpen source ↗
Tokens
DesignSystemInspect exact story code for roles and capability projection.
Accessibility
Input contract mountedNo input claim in the representative story.
Contract
Evidence in progress1/23 axes covered
06 · Go deeper
Advanced guidance
Authored implementation guidance
Binary inspector over a host-projected page (HexWindow). TermRock owns
row virtualization metrics from total_len, cursor/selection in absolute
offsets, and chrome — never file I/O.


When to use / when not


Use HexViewerPrefer
Binary / blob inspection—
Text source filesCodeBlock
Structured logsLogStream


Paging contract


Host projects: base_offset + data[] + total_len
Scroll/cursor use absolute offsets
PageNeeded { offset } → host re-reads page containing offset


Non-color selection


    

  • Cursor: › / > gutter + ⟨XX⟩ / [XX] around active byte
    • 

  • Selection: {XX} braces
    • 

  • Bookmarks: ★ / *
    • 



Inspector


Endian-aware u8/u16/u32/u64 at cursor (e toggles LE/BE).


Keys


KeyAction
hjkl / arrowsNavigate
/ n NSearch
b e a wBookmark · endian · ascii mode · bpr
c x yCopy hex · ASCII · export
Ownership boundary
TermRock owns reusable terminal rendering and interaction state. The host owns domain data, policy, persistence, authorization, and side effects.
Evidence status
1 covered, 9 partial, and 5 missing contract axes. Missing evidence is not a behavior claim.
File Tree
FileTree is the exact public paint owner for data terminal UI.
Key Value List
Metadata list — aligned keys, stacked narrow, secrets, status, links.