RDLL.excelcannon.sdk 0.14.0

RDLL.excelcannon.sdk

ExcelCannon in process: extract an Excel workbook (.xlsx, .xlsm, .xlsb) into the canonical JSON model, render it as compact text for a prompt, diff two models, migrate a mapping across template generations, and lint a model, all without a child process.

This version runs a pure managed engine: no native library, every OS and architecture .NET 10 runs on, trimming and Native AOT compatible, and no package dependencies. The public surface is the same as the earlier native-engine SDK, type for type and member for member, so existing code compiles unchanged. The JSON it returns is byte-identical to excelcannon extract / diff --json / lint --json / migrate --json.

using RDLL.ExcelCannon.Sdk;

ModelResult model = ExcelCannon.Extract("quarterly.xlsx", ExtractMode.Data);
Console.WriteLine($"{model.Kind} v{model.SchemaVersion}: {string.Join(", ", model.SheetNames)}");
Console.WriteLine(ExcelCannon.Render(model.Json, ExtractMode.Data));

DiffResult diff = ExcelCannon.Diff(
    ExcelCannon.Extract("golden.xlsx", ExtractMode.Data).Json,
    ExcelCannon.Extract("filled.xlsx", ExtractMode.Data).Json);
Console.WriteLine($"{diff.OverallPct:F1}% match, {diff.FindingCount} differences");

What this version adds:

• ModelResult.Workbook: the typed model (RDLL.ExcelCannon.Model.Workbook), and Render/Diff/Migrate/Lint overloads that take it with no JSON round trip.
• Extract(Stream, fileName) and Extract(ReadOnlyMemory<byte>, fileName) (a byte[] converts).
• CancellationToken on the new overloads, observed between phases, before each sheet and during a URL download.
• Lazy JSON: Json is produced on first read; WriteJson(Stream) and WriteJsonTo(IBufferWriter<byte>) stream UTF-8 without building a string.
• ITypedExcelCannon, the injectable seam for all of the above.

Dependency injection: services.AddExcelCannon(options => ...) is compiled into your project automatically when it already references Microsoft.Extensions.DependencyInjection.Abstractions (every ASP.NET Core and worker host does). Otherwise, register it in one line: services.AddSingleton<IExcelCannon, ExcelCannonClient>().

Everything is thread-safe. The full guide, including the error table and a migration checklist, is docs/sdk.md in the repository.