Refactoring

.github/release.md

@@ -29,10 +29,10 @@ shasum -a 256 -c checksums.txt
 
 | Build | Size | Syntax highlighting |
 |-------|------|---------------------|
-| **full** (`exex-…-<os>-<arch>.tar.gz`) | larger | Chroma — full multi-language source + asm highlighting |
+| **full** (`exex-…-<os>-<arch>.tar.gz`) | larger | Chroma — curated native/common source lexers + asm highlighting |
 | **lite** (`exex-…-<os>-<arch>-lite.tar.gz`) | smaller | built-in minimal highlighter |
 
-Everything else is identical, and both honour the same themes/colours. Exact archive sizes vary by platform and Go/dependency versions. Pick **lite** for the smaller binary, **full** for the richest colouring.
+Everything else is identical, and both honour the same themes/colours. Source languages outside the curated Chroma set fall back to the built-in highlighter. Exact archive sizes vary by platform and Go/dependency versions. Pick **lite** for the smaller binary, **full** for the richest colouring.
 
 ### Usage
 

.gitignore

@@ -1,4 +1,9 @@
 exex
 .vscode
 dist
-*.test
+*.test
+perfreport
+
+# Regenerated by the golden-frame tests from internal/testbin; the snapshots in
+# internal/ui/testdata/golden* are committed, this input is not.
+internal/ui/testdata/tiny.elf

README.md

@@ -1,5 +1,9 @@
 # exex
 
+A fast terminal UI for exploring **ELF, Mach-O and PE** binaries. exex shows the
+file header, sections, segments, symbols, disassembly, hex/raw bytes, printable
+strings, dynamic libraries, relocations, syscall sites and DWARF-driven source
+mapping in one keyboard- and mouse-driven interface.
 A fast terminal UI for exploring **ELF, Mach-O and PE** binaries. exex shows the
 file header, sections, segments, symbols, disassembly, hex/raw bytes, printable
 strings, dynamic libraries, relocations, syscall sites and DWARF-driven source
@@ -9,6 +13,9 @@ Its standout feature: when a binary has debug info (DWARF, or a Mach-O `.dSYM`),
 exex shows the **original source side by side with the exact disassembly it maps
 to**. It is interactive, navigable both ways, and entirely **static**: no
 debugger, no running process, no decompiler.
+exex shows the **original source side by side with the exact disassembly it maps
+to**. It is interactive, navigable both ways, and entirely **static**: no
+debugger, no running process, no decompiler.
 
 ```
 exex [-debug PATH] [-s STRING] [-o [VIEW]] <binary> [goto]
@@ -17,6 +24,21 @@ exex [-debug PATH] [-s STRING] [-o [VIEW]] <binary> [goto]
 
 ## Highlights
 
+- **One explorer for three formats:** ELF, Mach-O, PE and universal/fat Mach-O
+  slices.
+- **Source ↔ disassembly:** original source beside machine code when DWARF or a
+  `.dSYM` is available.
+- **Fast first look:** read-only, no project database, no debugger session.
+- **Useful binary views:** symbols, sections, segments, strings, relocations,
+  libraries, syscall sites, CPU features, hex/raw bytes and disassembly.
+- **Scriptable output:** `-o` emits plain text views for pipes and automation.
+- **Text script mode:** readable shell/Python/etc. scripts open in a linked text
+  viewer instead of failing as “not a binary”.
+
+See [How exex compares to other tools](#how-exex-compares-to-other-tools) for the
+tradeoffs against binutils, debuggers and RE platforms.
+## Highlights
+
 - **One explorer for three formats:** ELF, Mach-O, PE and universal/fat Mach-O
   slices.
 - **Source ↔ disassembly:** original source beside machine code when DWARF or a
@@ -44,6 +66,8 @@ brew install shellcell/tap/exex
 Download the asset for your OS/arch from the
 [Releases](../../releases) page. Add `-lite` to the filename for the smaller
 build.
+[Releases](../../releases) page. Add `-lite` to the filename for the smaller
+build.
 
 ```sh
 # macOS / Linux
@@ -55,10 +79,12 @@ sudo mv exex /usr/local/bin/
 shasum -a 256 -c checksums.txt
 ```
 
+### Go install
 ### Go install
 
 ```sh
 go install github.com/rabarbra/exex@latest              # full build
+go install github.com/rabarbra/exex@latest              # full build
 go install -tags lite github.com/rabarbra/exex@latest   # lite build
 ```
 
@@ -75,6 +101,30 @@ make test-cross  # cross-compile and parse/disassemble readable targets; needs G
 
 There are two builds. They are identical except for syntax highlighting:
 
+| Build | Size | Syntax highlighting |
+|-------|------|---------------------|
+| **full** | larger | [Chroma](https://github.com/alecthomas/chroma) — curated native/common source lexers and assembly highlighting |
+| **lite** | smaller | a small built-in highlighter (categorized source keywords/function names; categorized asm mnemonics plus registers / immediates / links) |
+
+The full build bundles a curated Chroma lexer/style set; source languages outside
+that set fall back to the built-in highlighter. The lite build drops Chroma
+entirely. Exact binary and archive sizes vary by platform and Go/dependency
+versions, but lite is the smaller download. Both builds honour the same themes
+and `colors:` config; the built-in highlighter follows your theme too.
+
+Pick **lite** if you want the smaller binary, **full** for the richest colouring.
+
+## Man Page and Shell Completions
+make build       # full  -> ./exex
+make lite        # lite  -> ./exex
+make test        # go test + lite vet
+make test-cross  # cross-compile and parse/disassemble readable targets; needs Go + Zig
+```
+
+## Full vs Lite Build
+
+There are two builds. They are identical except for syntax highlighting:
+
 | Build | Size | Syntax highlighting |
 |-------|------|---------------------|
 | **full** | larger | [Chroma](https://github.com/alecthomas/chroma) — full multi-language source highlighting and assembly highlighting |
@@ -231,6 +281,9 @@ scripts via `-o`.
 | `addr2line` | address → source `file:line` via DWARF | live in the source pane and Sources view — address ↔ source, both directions |
 | `size` | section/segment sizes | Info, Sections and Segments views |
 | `otool` (macOS) / `dumpbin` (Windows) | the Mach-O / PE counterparts of the above | a single tool across ELF, Mach-O and PE |
+| `dyld_info` (macOS) | inspect a Mach-O's dyld metadata: bind/rebase & chained fixups, dependent dylibs, exports | Relocs view decodes both dyld bind/rebase opcodes and chained fixups into a neutral table (`-o relocs`); Libs view lists dependent dylibs, including the re-export/weak/upward variants |
+| `dyld_shared_cache_util` (macOS) | list / extract dylibs from the dyld shared cache | opens a cache-resident system dylib straight from the Libs view (`o`), un-sharing it into a standalone, browsable Mach-O — no separate extraction step |
+| `dyld_usage` (macOS) | live-trace a process's dyld / shared-cache activity | exex resolves the shared cache *statically*: it follows a macOS binary's imports through the cache (e.g. libSystem → libsystem_kernel) to surface the transitive syscall surface — `-o syscalls-full` — without running the program |
 
 In one line: those tools each answer one question, print, and exit; exex answers
 all of them in one place, lets you **navigate** between them (follow a call into
@@ -277,6 +330,30 @@ it's the fast first look: open any ELF/Mach-O/PE, read its layout and code, foll
 references and source mappings interactively, and drop to plain text when you need
 to script.
 
+## Architecture
+
+For contributors: [`docs/architecture.md`](docs/architecture.md) describes the
+package layering (core `binfile`/`disasm`, domain services, the two frontends),
+the TUI's view contract (`view.Context` / `view.Host`) and the rendering &
+performance conventions, with diagrams.
+
+## Acknowledgements
+
+exex builds on the work of the Go toolchain and standard library authors, plus
+the authors and maintainers of these projects:
+
+- [Bubble Tea](https://github.com/charmbracelet/bubbletea), [Bubbles](https://github.com/charmbracelet/bubbles) and [Lip Gloss](https://github.com/charmbracelet/lipgloss) for the terminal UI foundation.
+- [Chroma](https://github.com/alecthomas/chroma) for full-build syntax highlighting.
+- [`golang.org/x/arch`](https://pkg.go.dev/golang.org/x/arch) and [`golang.org/x/sys`](https://pkg.go.dev/golang.org/x/sys) for architecture decoders and system interfaces.
+- [`github.com/ianlancetaylor/demangle`](https://pkg.go.dev/github.com/ianlancetaylor/demangle) for C++/Rust symbol demangling.
+- [`github.com/atotto/clipboard`](https://github.com/atotto/clipboard) for clipboard integration.
+- [`gopkg.in/yaml.v3`](https://pkg.go.dev/gopkg.in/yaml.v3) for configuration parsing.
+
+See [`go.mod`](go.mod) for the full dependency list, including transitive
+packages.
+
+ChatGPT was used as a development and documentation assistant.
+
 ## Acknowledgements
 
 exex builds on the work of the Go toolchain and standard library authors, plus