WpfHexEditor.Core.ByteProvider 1.0.0

WpfHexEditor.Core.ByteProvider

Cross-platform byte provider for gigabyte-scale binary files — zero WPF dependency.

Features

Quick Start

Open a file and read bytes

using WpfHexEditor.Core.Bytes;

var provider = new ByteProvider();
provider.Open("firmware.bin");

// Read 16 bytes at offset 0x100
byte[] data = provider.ReadBytes(0x100, 16);

Console.WriteLine($"File size: {provider.VirtualLength} bytes");

Modify bytes with undo/redo

// Modify a byte
provider.ModifyByte(0x200, 0xFF);

// Insert bytes
provider.InsertBytes(0x300, new byte[] { 0x00, 0x01, 0x02 });

// Delete bytes
provider.DeleteBytes(0x400, count: 4);

// Undo / Redo
provider.Undo();
provider.Redo();

Console.WriteLine($"Can undo: {provider.CanUndo}");
Console.WriteLine($"Can redo: {provider.CanRedo}");

Search

using WpfHexEditor.Core.Search.Models;

var options = new SearchOptions
{
    Pattern = new byte[] { 0x4D, 0x5A }, // MZ header
    StartPosition = 0
};

SearchResult result = provider.Search(options);

foreach (var match in result.Matches)
    Console.WriteLine($"Found at 0x{match.Position:X8}");

Changeset snapshot

// Capture all pending edits (O(e) — does not read the file)
ChangesetSnapshot snapshot = provider.GetChangesetSnapshot();

Console.WriteLine($"Modified ranges : {snapshot.Modified.Count}");
Console.WriteLine($"Inserted blocks : {snapshot.Inserted.Count}");
Console.WriteLine($"Deleted ranges  : {snapshot.Deleted.Count}");
Console.WriteLine($"Has edits       : {snapshot.HasEdits}");

Project Structure

WpfHexEditor.Core.ByteProvider/
├── Bytes/
│   ├── ByteProvider.cs              ← Main entry point
│   ├── ByteProvider.Search.cs       ← Search integration
│   ├── ByteProvider.Changeset.cs    ← Changeset snapshot
│   ├── EditsManager.cs              ← Edit tracking
│   ├── UndoRedoManager.cs           ← Undo/redo stacks
│   ├── FileProvider.cs              ← Stream abstraction
│   ├── PositionMapper.cs            ← Virtual/physical mapping
│   └── ByteReader.cs                ← Cached reads
├── Search/
│   ├── Services/SearchEngine.cs     ← Boyer-Moore-Horspool
│   └── Models/                      ← SearchOptions, SearchResult, SearchMode
├── Services/
│   └── UndoRedoService.cs
└── Changesets/
    └── ChangesetSnapshot.cs         ← ModifiedRange, InsertedBlock, DeletedRange

Dependencies

None. Zero external NuGet dependencies. Pure .NET 8.0.

License

GNU Affero General Public License v3.0 — Copyright 2026 Derek Tremblay. See LICENSE.