whfmt.Formats 1.5.0

whfmt.Formats

856+ binary format definitions (.whfmt, schema v3.1) shipped as AdditionalFiles — ready to pair with whfmt.SourceGenerator for zero-CLI, compile-time C# parsers.

What's New

v1.5.0 — Schema v3.1 + PHP/Markdown embedded language zones

• Updated: All .whfmt files are now schema v3.1 — syntaxDefinition.embeddedLanguages[] is supported.
• Updated: PHP.whfmt declares <?php … ?> zones; Markdown.whfmt declares fenced code block zones (```lang).
• Fix: CSS.whfmt broken Type pattern corrected.
• Version mirrors whfmt.FileFormatCatalog — same definitions, same version number, always in sync.

v1.0.1 — Initial content release

• 856 .whfmt binary format definitions shipped as AdditionalFiles.
• MSBuild .props wires WhfmtNamespace per-category for tidy generated namespaces.

Quick start

1. Install both packages

<PackageReference Include="whfmt.Formats"         Version="1.5.0" />
<PackageReference Include="whfmt.SourceGenerator" Version="1.0.2" />

That's it. At compile time, every format in this package is passed to whfmt.SourceGenerator as an AdditionalFile and a strongly-typed C# parser class is emitted automatically.

2. Use a generated parser

// WhfmtFormats.Images namespace — from Formats/Images/PNG.whfmt
var png = PngParser.ParseFile("photo.png");
Console.WriteLine(png.Width);
Console.WriteLine(png.Height);

// WhfmtFormats.Audio namespace — from Formats/Audio/MP3.whfmt
var mp3 = Mp3Parser.ParseFile("track.mp3");
Console.WriteLine(mp3.SyncWord);

Included categories

Use only specific formats

Don't need all 856 parsers? Exclude categories or individual files:

<AdditionalFiles Remove="$(NuGetPackageRoot)whfmt.formats\1.0.0\contentFiles\any\any\Formats\Game\**" />


<AdditionalFiles Include="path\to\PNG.whfmt">
  <WhfmtNamespace>MyApp.Parsers</WhfmtNamespace>
  <WhfmtClass>PngParser</WhfmtClass>
</AdditionalFiles>

Override namespace or class name

<AdditionalFiles Update="$(NuGetPackageRoot)whfmt.formats\1.0.0\contentFiles\any\any\Formats\Images\PNG.whfmt">
  <WhfmtNamespace>MyApp.ImageParsers</WhfmtNamespace>
  <WhfmtClass>PngReader</WhfmtClass>
</AdditionalFiles>

Relationship to other whfmt packages

Requirements

• .NET SDK 6.0 or later
• whfmt.SourceGenerator — required to actually generate parsers from these definitions